## Voice Personality Library — 100+ AI Teacher Voices

- **Extensive catalogue:** `AdvancedAudioEngine.getVoicePersonalityLibrary()`
  exposes 108 personas generated from twelve archetype seeds across nine locale
  variants (English global/flow, Hindi, Spanish, Portuguese, French, German,
  Japanese, Chinese). Every persona carries energy signature, gender expression,
  timbre envelope, speaking rate/pitch defaults, supported use cases, and
  curated sample scripts for onboarding experiences.
- **Multidimensional indices:** Returned metadata includes
  locale/energy/archetype indices and a summary distribution so clients can
  build pickers or analytics dashboards without recomputing aggregates.
- **Persona lookup:** `AdvancedAudioEngine.getVoicePersonality(id)` clones
  immutable persona objects for detail views, ensuring consumers cannot mutate
  the shared cache.
- **Adaptive selection helper:**
  `AdvancedAudioEngine.selectVoicePersonality(request)` scores personas against
  preferred locales, desired energy, use case, optional style hints, and
  emphasis vectors (trust/compassion/vitality/mystery/presence). The helper
  returns the highest-scoring primary persona, alternates, and an audit block
  describing matched locale and fallback status.
- **Testing:** Vitest coverage in
  `web/src/lib/__tests__/advanced-audio-engine.test.ts` validates the catalogue
  size, metadata richness, persona retrieval, selection scoring, and fallback
  behaviour.
