Custom Sounds

// sensory.config.js
module.exports = {
  overrides: {
    "interaction.tap": "/sounds/custom/my-click.mp3",
    "hero.complete": "/sounds/custom/fanfare.mp3",
  },
};

// sounds/core/instruments.ts
import type { InstrumentConfig } from "./instruments";

const MY_INSTRUMENT: InstrumentConfig = {
  filterFreq: 4000,
  q: 5,
  oscType: "triangle",
  decayMult: 1.0,
  gainMult: 0.85,
  pitchMult: 1.1,
  effects: [
    { type: "reverb", options: { duration: 1.0, decay: 2.0, mix: 0.2 } },
  ],
};

import { generateSoundPack } from "./core/factory";

export const myPack = generateSoundPack(MY_INSTRUMENT);
// myPack covers all 17 roles

import { INSTRUMENTS } from "./core/instruments";
import { generateSoundPack } from "./core/factory";

const myInstrument = {
  ...INSTRUMENTS.glass,
  gainMult: 0.6, // Quieter
  pitchMult: 2.0, // Higher pitched
  effects: [
    { type: "reverb", options: { duration: 2.0, mix: 0.4 } },
  ],
};

export const myPack = generateSoundPack(myInstrument);

interface InstrumentConfig {
  filterFreq: number; // Filter cutoff frequency (1500-6000 Hz)
  q: number; // Filter resonance (1-12)
  oscType: OscillatorType; // "sine" | "square" | "sawtooth" | "triangle"
  decayMult: number; // Decay time multiplier (0.5-1.5)
  gainMult: number; // Volume multiplier (0.4-1.0)
  pitchMult: number; // Pitch multiplier (0.7-1.8)
  effects?: EffectDefinition[]; // Optional effects chain
}