Add vocalist preset selector

docs/ARCHITECTURE.md

@@ -26,6 +26,7 @@ macOS App
 │   ├── Prompt Compiler
 │   ├── Genre & Style Catalog
 │   ├── Instrument Catalog
+│   ├── Vocalist Catalog
 │   ├── Arabic Pronunciation Processor
 │   ├── Project Versioning
 │   └── Validation
@@ -118,3 +119,10 @@ SwiftUI views. The Presentation layer may search, filter and toggle
 selections, while the catalog service owns stable ids, categories,
 optional regional metadata and search aliases. Selections are stored as
 existing `GenreStyle` values on the SongProject.
+
+## Vocalist Selector Boundary
+
+Vocalist presets are local structured data, separate from SwiftUI views.
+The catalog service supplies stable ids and preset metadata, while the
+Presentation layer searches and toggles the corresponding `Vocalist`
+values on the SongProject.

docs/DATA_MODEL.md

@@ -49,6 +49,17 @@ GenreStyleCatalogItem
 - aliases[]
 - searchTerms[]
 
+VocalistPreset
+- id
+- label
+- familyCategory
+- regionOrigin (optional)
+- voiceType (optional)
+- genderSelection (optional)
+- performanceStyle (optional)
+- aliases[]
+- searchTerms[]
+
 SongSection
 - id
 - type (intro, verse, preChorus, chorus, bridge, outro, custom)

docs/PRODUCT.md

@@ -36,6 +36,8 @@ and writing engine, then prepares final lyrics and style instructions.
 -   Song structure supports Manual and Auto modes.
 -   BPM, key/scale and maqam support Manual and Auto modes.
 -   Multiple vocalists/voices can exist in one song.
+-   Vocalists can be selected from a local catalog of voice roles and
+    presets using checkbox multi-select.
 -   User controls vocal gender/type, rap/singing mode, delivery and
     section-specific performance.
 -   Multiple languages and dialects can be used in one song.
@@ -85,6 +87,13 @@ region/origin where useful, and select or deselect multiple entries with
 checkboxes. Catalog data is structured and separate from SwiftUI views;
 it does not require an external API.
 
+## Vocalist Selector
+
+The application provides a local catalog of vocalist roles and voice
+presets. Users can search, browse by category and select or deselect
+multiple vocalists with checkboxes. Each preset supplies a role label,
+voice type, gender selection and performance style for the Song Project.
+
 ## Project Management
 
 Every song is stored as a project. Important changes can create versions

docs/TASKS.md

@@ -132,3 +132,4 @@ lyrics and style prompt in the project.
 
 -   [x] Add confirmed project deletion from the project browser.
 -   [x] Add a worldwide genre and style selector with checkbox multi-select.
+-   [x] Add a vocalist preset selector with checkbox multi-select.