Configuration

// sensory.config.js
module.exports = {
  // Global kill-switch.
  // Set to false to silence ALL sounds throughout the app without
  // removing any code. Useful for staging environments or QA reviews.
  enabled: true,

  // Master volume multiplier. Range: 0.0 – 1.0.
  // Applied to every sound before playback. Individual sounds can be
  // further controlled with the per-call volume option, but this is
  // the global ceiling.
  volume: 0.35,

  // Sound pack / theme name.
  // Switch between installed packs at runtime. Available packs:
  // "soft", "aero", "arcade", "organic", "glass", "industrial",
  // "minimal", "retro", "crisp"
  theme: "aero",

  // Per-category enable/disable toggles.
  // All unspecified categories default to true.
  // Setting a category to false silences every role in that category,
  // even if a component has the sound prop set.
  categories: {
    interaction: true,
    navigation: true,
    notification: true,
    overlay: true,
    hero: false, // Hero is disabled by default - must be explicitly enabled
  },

  // Role-level overrides.
  // Map any SoundRole to a custom audio source.
  // Values can be:
  //   - A URL path to a file in public/ (e.g. "/sounds/custom/my-click.mp3")
  //   - A base64 data URI (e.g. "data:audio/mp3;base64,//uQx...")
  // These take precedence over the built-in base64 modules in sounds/*.ts.
  overrides: {
    // Example overrides (all commented out by default):
    // "interaction.tap":  "/sounds/custom/my-click.mp3",
    // "navigation.forward":  "data:audio/mp3;base64,...",
    // "hero.complete":        "/sounds/custom/fanfare.ogg",
  },

  // Reduced-motion handling.
  // "inherit"   → respect the user's OS/browser prefers-reduced-motion setting
  // "force-off" → always suppress sounds, regardless of user preference
  // "force-on"  → always play sounds, ignore prefers-reduced-motion
  //
  // Default: "inherit"
  // Only change this if you have a specific UX reason to override
  // the user's accessibility preference.
  reducedMotion: "inherit",
};

categories: {
  overlay: false,
}

1. config.overrides["role.name"]        → string override (URL or base64), if defined
2. packRegistry[config.theme]["role"]   → SoundSynthesizer from the active pack
3. packRegistry.aero["role"]            → fallback to "aero" pack if theme is unknown
4. null                                 → category disabled or role not found → no-op

// sensory.config.js
module.exports = {
  enabled: process.env.NODE_ENV !== "test",
  volume: 0.35,
  // ...
};