earcons 0.1.0

package/dist/index.js

@@ -0,0 +1,437 @@
+// src/context.ts
+var _ctx = null;
+async function getAudioContext() {
+  if (!_ctx) {
+    _ctx = new AudioContext();
+  }
+  if (_ctx.state === "suspended") {
+    await _ctx.resume();
+  }
+  return _ctx;
+}
+async function closeAudioContext() {
+  if (_ctx) {
+    await _ctx.close();
+    _ctx = null;
+  }
+}
+function setAudioContext(ctx) {
+  _ctx = ctx;
+}
+
+// src/synth.ts
+var DEFAULT_ENVELOPE = {
+  attack: 0.01,
+  decay: 0.05,
+  sustain: 0.7,
+  release: 0.08,
+  hold: 0
+};
+function semitonesToMultiplier(semitones) {
+  return Math.pow(2, semitones / 12);
+}
+function scheduleNote(ctx, note, masterGain, pitchMultiplier, timeOffset) {
+  const env = {
+    ...DEFAULT_ENVELOPE,
+    ...note.envelope
+  };
+  const t0 = timeOffset + note.startAt;
+  const noteGain = note.gain ?? 1;
+  const waveShape = note.waveShape ?? "sine";
+  const freq = note.frequency * pitchMultiplier;
+  const gainNode = ctx.createGain();
+  gainNode.connect(masterGain);
+  gainNode.gain.setValueAtTime(0, t0);
+  gainNode.gain.linearRampToValueAtTime(noteGain, t0 + env.attack);
+  const holdEnd = t0 + env.attack + (env.hold ?? 0);
+  gainNode.gain.setValueAtTime(noteGain, holdEnd);
+  gainNode.gain.linearRampToValueAtTime(
+    noteGain * env.sustain,
+    holdEnd + env.decay
+  );
+  const noteEnd = t0 + note.duration;
+  gainNode.gain.setValueAtTime(noteGain * env.sustain, noteEnd);
+  gainNode.gain.linearRampToValueAtTime(0, noteEnd + env.release);
+  const osc = ctx.createOscillator();
+  osc.type = waveShape;
+  osc.frequency.setValueAtTime(freq, t0);
+  osc.connect(gainNode);
+  osc.start(t0);
+  osc.stop(noteEnd + env.release + 0.01);
+  return noteEnd + env.release;
+}
+function playSound(ctx, sound, volume, pitchSemitones, onEnded) {
+  const masterGain = ctx.createGain();
+  masterGain.gain.setValueAtTime(Math.max(0, Math.min(1, volume)), ctx.currentTime);
+  masterGain.connect(ctx.destination);
+  const pitchMultiplier = semitonesToMultiplier(pitchSemitones);
+  const timeOffset = ctx.currentTime;
+  let latestEnd = timeOffset;
+  for (const note of sound.notes) {
+    const end = scheduleNote(ctx, note, masterGain, pitchMultiplier, timeOffset);
+    if (end > latestEnd) latestEnd = end;
+  }
+  if (onEnded) {
+    const sentinel = ctx.createOscillator();
+    const silentGain = ctx.createGain();
+    silentGain.gain.setValueAtTime(0, timeOffset);
+    sentinel.connect(silentGain);
+    silentGain.connect(ctx.destination);
+    sentinel.start(timeOffset);
+    sentinel.stop(latestEnd);
+    sentinel.onended = onEnded;
+  }
+}
+
+// src/sounds/success.ts
+var VARIANTS = {
+  short: {
+    name: "success",
+    duration: 0.25,
+    notes: [
+      { frequency: 523.25, duration: 0.1, startAt: 0, waveShape: "sine", gain: 0.8 },
+      { frequency: 783.99, duration: 0.15, startAt: 0.1, waveShape: "sine", gain: 0.9 }
+    ]
+  },
+  medium: {
+    name: "success",
+    duration: 0.45,
+    notes: [
+      { frequency: 523.25, duration: 0.12, startAt: 0, waveShape: "sine", gain: 0.7 },
+      { frequency: 659.25, duration: 0.12, startAt: 0.12, waveShape: "sine", gain: 0.8 },
+      { frequency: 783.99, duration: 0.2, startAt: 0.24, waveShape: "sine", gain: 0.9 }
+    ]
+  },
+  long: {
+    name: "success",
+    duration: 0.7,
+    notes: [
+      { frequency: 392, duration: 0.1, startAt: 0, waveShape: "sine", gain: 0.6 },
+      { frequency: 523.25, duration: 0.12, startAt: 0.1, waveShape: "sine", gain: 0.7 },
+      { frequency: 659.25, duration: 0.12, startAt: 0.22, waveShape: "sine", gain: 0.8 },
+      { frequency: 783.99, duration: 0.25, startAt: 0.34, waveShape: "sine", gain: 0.9 }
+    ]
+  }
+};
+function successPreset(variant, pitchSemitones) {
+  return VARIANTS[variant];
+}
+
+// src/sounds/error.ts
+var VARIANTS2 = {
+  short: {
+    name: "error",
+    duration: 0.25,
+    notes: [
+      {
+        frequency: 440,
+        duration: 0.1,
+        startAt: 0,
+        waveShape: "square",
+        gain: 0.5,
+        envelope: { attack: 5e-3, decay: 0.04, sustain: 0.6, release: 0.06 }
+      },
+      {
+        frequency: 311,
+        duration: 0.15,
+        startAt: 0.1,
+        waveShape: "square",
+        gain: 0.6,
+        envelope: { attack: 5e-3, decay: 0.04, sustain: 0.6, release: 0.06 }
+      }
+    ]
+  },
+  medium: {
+    name: "error",
+    duration: 0.5,
+    notes: [
+      {
+        frequency: 440,
+        duration: 0.12,
+        startAt: 0,
+        waveShape: "sawtooth",
+        gain: 0.4,
+        envelope: { attack: 5e-3, decay: 0.06, sustain: 0.5, release: 0.08 }
+      },
+      {
+        frequency: 392,
+        duration: 0.12,
+        startAt: 0.13,
+        waveShape: "sawtooth",
+        gain: 0.45,
+        envelope: { attack: 5e-3, decay: 0.06, sustain: 0.5, release: 0.08 }
+      },
+      {
+        frequency: 311,
+        duration: 0.2,
+        startAt: 0.26,
+        waveShape: "sawtooth",
+        gain: 0.55,
+        envelope: { attack: 5e-3, decay: 0.06, sustain: 0.5, release: 0.12 }
+      }
+    ]
+  },
+  long: {
+    name: "error",
+    duration: 0.75,
+    notes: [
+      {
+        frequency: 440,
+        duration: 0.12,
+        startAt: 0,
+        waveShape: "sawtooth",
+        gain: 0.4,
+        envelope: { attack: 5e-3, decay: 0.07, sustain: 0.5, release: 0.1 }
+      },
+      {
+        frequency: 415,
+        duration: 0.1,
+        startAt: 0.14,
+        waveShape: "sawtooth",
+        gain: 0.4,
+        envelope: { attack: 5e-3, decay: 0.07, sustain: 0.5, release: 0.1 }
+      },
+      {
+        frequency: 370,
+        duration: 0.12,
+        startAt: 0.26,
+        waveShape: "sawtooth",
+        gain: 0.45,
+        envelope: { attack: 5e-3, decay: 0.07, sustain: 0.5, release: 0.1 }
+      },
+      {
+        frequency: 311,
+        duration: 0.25,
+        startAt: 0.4,
+        waveShape: "sawtooth",
+        gain: 0.55,
+        envelope: { attack: 5e-3, decay: 0.08, sustain: 0.5, release: 0.15 }
+      }
+    ]
+  }
+};
+function errorPreset(variant, pitchSemitones) {
+  return VARIANTS2[variant];
+}
+
+// src/sounds/warning.ts
+var VARIANTS3 = {
+  short: {
+    name: "warning",
+    duration: 0.28,
+    notes: [
+      { frequency: 587.33, duration: 0.1, startAt: 0, waveShape: "triangle", gain: 0.7 },
+      { frequency: 523.25, duration: 0.18, startAt: 0.1, waveShape: "triangle", gain: 0.75 }
+    ]
+  },
+  medium: {
+    name: "warning",
+    duration: 0.5,
+    notes: [
+      { frequency: 587.33, duration: 0.12, startAt: 0, waveShape: "triangle", gain: 0.65 },
+      { frequency: 587.33, duration: 0.12, startAt: 0.14, waveShape: "triangle", gain: 0.65 },
+      { frequency: 493.88, duration: 0.2, startAt: 0.28, waveShape: "triangle", gain: 0.75 }
+    ]
+  },
+  long: {
+    name: "warning",
+    duration: 0.8,
+    notes: [
+      { frequency: 587.33, duration: 0.12, startAt: 0, waveShape: "triangle", gain: 0.6 },
+      { frequency: 587.33, duration: 0.12, startAt: 0.15, waveShape: "triangle", gain: 0.6 },
+      { frequency: 554.37, duration: 0.12, startAt: 0.3, waveShape: "triangle", gain: 0.65 },
+      { frequency: 493.88, duration: 0.25, startAt: 0.45, waveShape: "triangle", gain: 0.75 }
+    ]
+  }
+};
+function warningPreset(variant, pitchSemitones) {
+  return VARIANTS3[variant];
+}
+
+// src/sounds/notification.ts
+var VARIANTS4 = {
+  short: {
+    name: "notification",
+    duration: 0.22,
+    notes: [
+      { frequency: 880, duration: 0.08, startAt: 0, waveShape: "sine", gain: 0.6 },
+      { frequency: 660, duration: 0.14, startAt: 0.08, waveShape: "sine", gain: 0.65 }
+    ]
+  },
+  medium: {
+    name: "notification",
+    duration: 0.38,
+    notes: [
+      { frequency: 880, duration: 0.1, startAt: 0, waveShape: "sine", gain: 0.55 },
+      { frequency: 660, duration: 0.28, startAt: 0.1, waveShape: "sine", gain: 0.6 }
+    ]
+  },
+  long: {
+    name: "notification",
+    duration: 0.55,
+    notes: [
+      { frequency: 1046.5, duration: 0.08, startAt: 0, waveShape: "sine", gain: 0.5 },
+      { frequency: 880, duration: 0.1, startAt: 0.1, waveShape: "sine", gain: 0.55 },
+      { frequency: 660, duration: 0.3, startAt: 0.22, waveShape: "sine", gain: 0.6 }
+    ]
+  }
+};
+function notificationPreset(variant, pitchSemitones) {
+  return VARIANTS4[variant];
+}
+
+// src/sounds/click.ts
+var VARIANTS5 = {
+  short: {
+    name: "click",
+    duration: 0.04,
+    notes: [
+      {
+        frequency: 1200,
+        duration: 0.03,
+        startAt: 0,
+        waveShape: "sine",
+        gain: 0.5,
+        envelope: { attack: 2e-3, decay: 0.015, sustain: 0, release: 0.01 }
+      }
+    ]
+  },
+  medium: {
+    name: "click",
+    duration: 0.07,
+    notes: [
+      {
+        frequency: 900,
+        duration: 0.05,
+        startAt: 0,
+        waveShape: "sine",
+        gain: 0.55,
+        envelope: { attack: 2e-3, decay: 0.03, sustain: 0, release: 0.015 }
+      }
+    ]
+  },
+  long: {
+    name: "click",
+    duration: 0.12,
+    notes: [
+      {
+        frequency: 700,
+        duration: 0.08,
+        startAt: 0,
+        waveShape: "triangle",
+        gain: 0.6,
+        envelope: { attack: 2e-3, decay: 0.05, sustain: 0, release: 0.025 }
+      }
+    ]
+  }
+};
+function clickPreset(variant, pitchSemitones) {
+  return VARIANTS5[variant];
+}
+
+// src/sounds/info.ts
+var VARIANTS6 = {
+  short: {
+    name: "info",
+    duration: 0.2,
+    notes: [
+      {
+        frequency: 698.46,
+        // F5
+        duration: 0.18,
+        startAt: 0,
+        waveShape: "sine",
+        gain: 0.55,
+        envelope: { attack: 0.015, decay: 0.04, sustain: 0.5, release: 0.1 }
+      }
+    ]
+  },
+  medium: {
+    name: "info",
+    duration: 0.35,
+    notes: [
+      {
+        frequency: 698.46,
+        duration: 0.32,
+        startAt: 0,
+        waveShape: "sine",
+        gain: 0.55,
+        envelope: { attack: 0.02, decay: 0.05, sustain: 0.5, release: 0.12 }
+      }
+    ]
+  },
+  long: {
+    name: "info",
+    duration: 0.55,
+    notes: [
+      {
+        frequency: 587.33,
+        // D5
+        duration: 0.18,
+        startAt: 0,
+        waveShape: "sine",
+        gain: 0.5,
+        envelope: { attack: 0.02, decay: 0.05, sustain: 0.4, release: 0.1 }
+      },
+      {
+        frequency: 698.46,
+        // F5
+        duration: 0.3,
+        startAt: 0.2,
+        waveShape: "sine",
+        gain: 0.55,
+        envelope: { attack: 0.02, decay: 0.06, sustain: 0.5, release: 0.12 }
+      }
+    ]
+  }
+};
+function infoPreset(variant, pitchSemitones) {
+  return VARIANTS6[variant];
+}
+
+// src/index.ts
+async function play(preset, opts = {}) {
+  const { volume = 0.5, pitch = 0, audioContext, onEnded } = opts;
+  const ctx = audioContext ?? await getAudioContext();
+  playSound(ctx, preset, volume, pitch, onEnded);
+}
+async function playSuccess(opts = {}) {
+  return play(successPreset(opts.variant ?? "medium", opts.pitch ?? 0), opts);
+}
+async function playError(opts = {}) {
+  return play(errorPreset(opts.variant ?? "medium", opts.pitch ?? 0), opts);
+}
+async function playWarning(opts = {}) {
+  return play(warningPreset(opts.variant ?? "medium", opts.pitch ?? 0), opts);
+}
+async function playNotification(opts = {}) {
+  return play(
+    notificationPreset(opts.variant ?? "medium", opts.pitch ?? 0),
+    opts
+  );
+}
+async function playClick(opts = {}) {
+  return play(clickPreset(opts.variant ?? "short", opts.pitch ?? 0), opts);
+}
+async function playInfo(opts = {}) {
+  return play(infoPreset(opts.variant ?? "medium", opts.pitch ?? 0), opts);
+}
+var BANK = {
+  success: successPreset,
+  error: errorPreset,
+  warning: warningPreset,
+  notification: notificationPreset,
+  click: clickPreset,
+  info: infoPreset
+};
+async function earcon(name, opts = {}) {
+  const preset = BANK[name];
+  return play(preset(opts.variant ?? "medium", opts.pitch ?? 0), opts);
+}
+function registerSound(name, preset) {
+  BANK[name] = preset;
+}
+
+export { closeAudioContext, earcon, playClick, playError, playInfo, playNotification, playSuccess, playWarning, registerSound, semitonesToMultiplier, setAudioContext };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts","../src/synth.ts","../src/sounds/success.ts","../src/sounds/error.ts","../src/sounds/warning.ts","../src/sounds/notification.ts","../src/sounds/click.ts","../src/sounds/info.ts","../src/index.ts"],"names":["VARIANTS"],"mappings":"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","file":"index.js","sourcesContent":["// ---------------------------------------------------------------------------\n// earcon — AudioContext singleton with autoplay-policy handling\n// ---------------------------------------------------------------------------\n\nlet _ctx: AudioContext | null = null;\n\n/**\n * Returns the shared AudioContext, creating it on first call.\n * Automatically resumes a suspended context (needed after browser\n * autoplay-policy restrictions kick in before a user gesture).\n */\nexport async function getAudioContext(): Promise<AudioContext> {\n  if (!_ctx) {\n    _ctx = new AudioContext();\n  }\n\n  if (_ctx.state === \"suspended\") {\n    await _ctx.resume();\n  }\n\n  return _ctx;\n}\n\n/**\n * Returns the shared AudioContext synchronously.\n * The context may still be suspended — callers that need it resumed\n * should use {@link getAudioContext} instead.\n */\nexport function getAudioContextSync(): AudioContext {\n  if (!_ctx) {\n    _ctx = new AudioContext();\n  }\n  return _ctx;\n}\n\n/**\n * Closes and discards the shared AudioContext.\n * Useful in tests or when tearing down an SPA.\n */\nexport async function closeAudioContext(): Promise<void> {\n  if (_ctx) {\n    await _ctx.close();\n    _ctx = null;\n  }\n}\n\n/**\n * Replace the internal singleton — useful in tests to inject a mock.\n */\nexport function setAudioContext(ctx: AudioContext): void {\n  _ctx = ctx;\n}\n","// ---------------------------------------------------------------------------\n// earcon — synthesis engine\n// Schedules NoteEvents on a given AudioContext using oscillator nodes\n// and a GainNode-based ADSR envelope.\n// ---------------------------------------------------------------------------\n\nimport type { EarconSound, Envelope, NoteEvent } from \"./types.js\";\n\nconst DEFAULT_ENVELOPE: Envelope = {\n  attack: 0.01,\n  decay: 0.05,\n  sustain: 0.7,\n  release: 0.08,\n  hold: 0,\n};\n\n/**\n * Converts a semitone offset to a frequency multiplier.\n * e.g. +12 semitones → ×2 (one octave up)\n */\nexport function semitonesToMultiplier(semitones: number): number {\n  return Math.pow(2, semitones / 12);\n}\n\n/**\n * Schedules a single NoteEvent on the provided AudioContext.\n * Returns the scheduled end time (AudioContext.currentTime + startAt + duration + release).\n */\nfunction scheduleNote(\n  ctx: AudioContext,\n  note: NoteEvent,\n  masterGain: GainNode,\n  pitchMultiplier: number,\n  timeOffset: number\n): number {\n  const env: Envelope = {\n    ...DEFAULT_ENVELOPE,\n    ...note.envelope,\n  };\n\n  const t0 = timeOffset + note.startAt;\n  const noteGain = note.gain ?? 1;\n  const waveShape = note.waveShape ?? \"sine\";\n  const freq = note.frequency * pitchMultiplier;\n\n  // Per-note gain envelope node\n  const gainNode = ctx.createGain();\n  gainNode.connect(masterGain);\n  gainNode.gain.setValueAtTime(0, t0);\n\n  // Attack\n  gainNode.gain.linearRampToValueAtTime(noteGain, t0 + env.attack);\n\n  // Hold (optional flat segment)\n  const holdEnd = t0 + env.attack + (env.hold ?? 0);\n  gainNode.gain.setValueAtTime(noteGain, holdEnd);\n\n  // Decay → sustain level\n  gainNode.gain.linearRampToValueAtTime(\n    noteGain * env.sustain,\n    holdEnd + env.decay\n  );\n\n  // Sustain until note end\n  const noteEnd = t0 + note.duration;\n  gainNode.gain.setValueAtTime(noteGain * env.sustain, noteEnd);\n\n  // Release\n  gainNode.gain.linearRampToValueAtTime(0, noteEnd + env.release);\n\n  // Oscillator\n  const osc = ctx.createOscillator();\n  osc.type = waveShape;\n  osc.frequency.setValueAtTime(freq, t0);\n  osc.connect(gainNode);\n  osc.start(t0);\n  osc.stop(noteEnd + env.release + 0.01); // tiny buffer to avoid click\n\n  return noteEnd + env.release;\n}\n\n/**\n * Plays an {@link EarconSound} on the provided AudioContext.\n *\n * @param ctx        - AudioContext to schedule on\n * @param sound      - The sound descriptor to play\n * @param volume     - Master volume 0–1\n * @param pitchSemitones - Semitone offset applied to all frequencies\n * @param onEnded    - Optional callback when the sound finishes\n */\nexport function playSound(\n  ctx: AudioContext,\n  sound: EarconSound,\n  volume: number,\n  pitchSemitones: number,\n  onEnded?: () => void\n): void {\n  const masterGain = ctx.createGain();\n  masterGain.gain.setValueAtTime(Math.max(0, Math.min(1, volume)), ctx.currentTime);\n  masterGain.connect(ctx.destination);\n\n  const pitchMultiplier = semitonesToMultiplier(pitchSemitones);\n  const timeOffset = ctx.currentTime;\n\n  let latestEnd = timeOffset;\n\n  for (const note of sound.notes) {\n    const end = scheduleNote(ctx, note, masterGain, pitchMultiplier, timeOffset);\n    if (end > latestEnd) latestEnd = end;\n  }\n\n  // Schedule onEnded callback via a silent OscillatorNode that stops at latestEnd\n  if (onEnded) {\n    const sentinel = ctx.createOscillator();\n    const silentGain = ctx.createGain();\n    silentGain.gain.setValueAtTime(0, timeOffset);\n    sentinel.connect(silentGain);\n    silentGain.connect(ctx.destination);\n    sentinel.start(timeOffset);\n    sentinel.stop(latestEnd);\n    sentinel.onended = onEnded;\n  }\n}\n","// ---------------------------------------------------------------------------\n// earcon — \"success\" preset\n// A short ascending two-tone chime (major third → fifth), bright and clean.\n// ---------------------------------------------------------------------------\n\nimport type { EarconSound, SoundVariant } from \"../types.js\";\n\nconst VARIANTS: Record<SoundVariant, EarconSound> = {\n  short: {\n    name: \"success\",\n    duration: 0.25,\n    notes: [\n      { frequency: 523.25, duration: 0.1, startAt: 0,    waveShape: \"sine\", gain: 0.8 },\n      { frequency: 783.99, duration: 0.15, startAt: 0.1, waveShape: \"sine\", gain: 0.9 },\n    ],\n  },\n  medium: {\n    name: \"success\",\n    duration: 0.45,\n    notes: [\n      { frequency: 523.25, duration: 0.12, startAt: 0,    waveShape: \"sine\", gain: 0.7 },\n      { frequency: 659.25, duration: 0.12, startAt: 0.12, waveShape: \"sine\", gain: 0.8 },\n      { frequency: 783.99, duration: 0.2,  startAt: 0.24, waveShape: \"sine\", gain: 0.9 },\n    ],\n  },\n  long: {\n    name: \"success\",\n    duration: 0.7,\n    notes: [\n      { frequency: 392.00, duration: 0.1,  startAt: 0,    waveShape: \"sine\", gain: 0.6 },\n      { frequency: 523.25, duration: 0.12, startAt: 0.1,  waveShape: \"sine\", gain: 0.7 },\n      { frequency: 659.25, duration: 0.12, startAt: 0.22, waveShape: \"sine\", gain: 0.8 },\n      { frequency: 783.99, duration: 0.25, startAt: 0.34, waveShape: \"sine\", gain: 0.9 },\n    ],\n  },\n};\n\nexport function successPreset(\n  variant: SoundVariant,\n  pitchSemitones: number\n): EarconSound {\n  // pitchSemitones is applied by the synth engine — just return the descriptor\n  void pitchSemitones;\n  return VARIANTS[variant];\n}\n","// ---------------------------------------------------------------------------\n// earcon — \"error\" preset\n// Descending dissonant tones (tritone), harsh and attention-grabbing.\n// ---------------------------------------------------------------------------\n\nimport type { EarconSound, SoundVariant } from \"../types.js\";\n\nconst VARIANTS: Record<SoundVariant, EarconSound> = {\n  short: {\n    name: \"error\",\n    duration: 0.25,\n    notes: [\n      { frequency: 440, duration: 0.1,  startAt: 0,    waveShape: \"square\", gain: 0.5,\n        envelope: { attack: 0.005, decay: 0.04, sustain: 0.6, release: 0.06 } },\n      { frequency: 311, duration: 0.15, startAt: 0.1,  waveShape: \"square\", gain: 0.6,\n        envelope: { attack: 0.005, decay: 0.04, sustain: 0.6, release: 0.06 } },\n    ],\n  },\n  medium: {\n    name: \"error\",\n    duration: 0.5,\n    notes: [\n      { frequency: 440, duration: 0.12, startAt: 0,    waveShape: \"sawtooth\", gain: 0.4,\n        envelope: { attack: 0.005, decay: 0.06, sustain: 0.5, release: 0.08 } },\n      { frequency: 392, duration: 0.12, startAt: 0.13, waveShape: \"sawtooth\", gain: 0.45,\n        envelope: { attack: 0.005, decay: 0.06, sustain: 0.5, release: 0.08 } },\n      { frequency: 311, duration: 0.2,  startAt: 0.26, waveShape: \"sawtooth\", gain: 0.55,\n        envelope: { attack: 0.005, decay: 0.06, sustain: 0.5, release: 0.12 } },\n    ],\n  },\n  long: {\n    name: \"error\",\n    duration: 0.75,\n    notes: [\n      { frequency: 440, duration: 0.12, startAt: 0,    waveShape: \"sawtooth\", gain: 0.4,\n        envelope: { attack: 0.005, decay: 0.07, sustain: 0.5, release: 0.1 } },\n      { frequency: 415, duration: 0.1,  startAt: 0.14, waveShape: \"sawtooth\", gain: 0.4,\n        envelope: { attack: 0.005, decay: 0.07, sustain: 0.5, release: 0.1 } },\n      { frequency: 370, duration: 0.12, startAt: 0.26, waveShape: \"sawtooth\", gain: 0.45,\n        envelope: { attack: 0.005, decay: 0.07, sustain: 0.5, release: 0.1 } },\n      { frequency: 311, duration: 0.25, startAt: 0.4,  waveShape: \"sawtooth\", gain: 0.55,\n        envelope: { attack: 0.005, decay: 0.08, sustain: 0.5, release: 0.15 } },\n    ],\n  },\n};\n\nexport function errorPreset(\n  variant: SoundVariant,\n  pitchSemitones: number\n): EarconSound {\n  void pitchSemitones;\n  return VARIANTS[variant];\n}\n","// ---------------------------------------------------------------------------\n// earcon — \"warning\" preset\n// A flat-then-descending minor second — cautious, not alarming.\n// ---------------------------------------------------------------------------\n\nimport type { EarconSound, SoundVariant } from \"../types.js\";\n\nconst VARIANTS: Record<SoundVariant, EarconSound> = {\n  short: {\n    name: \"warning\",\n    duration: 0.28,\n    notes: [\n      { frequency: 587.33, duration: 0.1,  startAt: 0,    waveShape: \"triangle\", gain: 0.7 },\n      { frequency: 523.25, duration: 0.18, startAt: 0.1,  waveShape: \"triangle\", gain: 0.75 },\n    ],\n  },\n  medium: {\n    name: \"warning\",\n    duration: 0.5,\n    notes: [\n      { frequency: 587.33, duration: 0.12, startAt: 0,    waveShape: \"triangle\", gain: 0.65 },\n      { frequency: 587.33, duration: 0.12, startAt: 0.14, waveShape: \"triangle\", gain: 0.65 },\n      { frequency: 493.88, duration: 0.2,  startAt: 0.28, waveShape: \"triangle\", gain: 0.75 },\n    ],\n  },\n  long: {\n    name: \"warning\",\n    duration: 0.8,\n    notes: [\n      { frequency: 587.33, duration: 0.12, startAt: 0,    waveShape: \"triangle\", gain: 0.6 },\n      { frequency: 587.33, duration: 0.12, startAt: 0.15, waveShape: \"triangle\", gain: 0.6 },\n      { frequency: 554.37, duration: 0.12, startAt: 0.3,  waveShape: \"triangle\", gain: 0.65 },\n      { frequency: 493.88, duration: 0.25, startAt: 0.45, waveShape: \"triangle\", gain: 0.75 },\n    ],\n  },\n};\n\nexport function warningPreset(\n  variant: SoundVariant,\n  pitchSemitones: number\n): EarconSound {\n  void pitchSemitones;\n  return VARIANTS[variant];\n}\n","// ---------------------------------------------------------------------------\n// earcon — \"notification\" preset\n// Two clean sine tones — a gentle, neutral \"ding\" suitable for messages.\n// ---------------------------------------------------------------------------\n\nimport type { EarconSound, SoundVariant } from \"../types.js\";\n\nconst VARIANTS: Record<SoundVariant, EarconSound> = {\n  short: {\n    name: \"notification\",\n    duration: 0.22,\n    notes: [\n      { frequency: 880, duration: 0.08, startAt: 0,    waveShape: \"sine\", gain: 0.6 },\n      { frequency: 660, duration: 0.14, startAt: 0.08, waveShape: \"sine\", gain: 0.65 },\n    ],\n  },\n  medium: {\n    name: \"notification\",\n    duration: 0.38,\n    notes: [\n      { frequency: 880, duration: 0.1,  startAt: 0,    waveShape: \"sine\", gain: 0.55 },\n      { frequency: 660, duration: 0.28, startAt: 0.1,  waveShape: \"sine\", gain: 0.6 },\n    ],\n  },\n  long: {\n    name: \"notification\",\n    duration: 0.55,\n    notes: [\n      { frequency: 1046.5, duration: 0.08, startAt: 0,    waveShape: \"sine\", gain: 0.5 },\n      { frequency: 880,    duration: 0.1,  startAt: 0.1,  waveShape: \"sine\", gain: 0.55 },\n      { frequency: 660,    duration: 0.3,  startAt: 0.22, waveShape: \"sine\", gain: 0.6 },\n    ],\n  },\n};\n\nexport function notificationPreset(\n  variant: SoundVariant,\n  pitchSemitones: number\n): EarconSound {\n  void pitchSemitones;\n  return VARIANTS[variant];\n}\n","// ---------------------------------------------------------------------------\n// earcon — \"click\" preset\n// A very short transient — simulates a tactile UI button press/toggle.\n// ---------------------------------------------------------------------------\n\nimport type { EarconSound, SoundVariant } from \"../types.js\";\n\nconst VARIANTS: Record<SoundVariant, EarconSound> = {\n  short: {\n    name: \"click\",\n    duration: 0.04,\n    notes: [\n      {\n        frequency: 1200,\n        duration: 0.03,\n        startAt: 0,\n        waveShape: \"sine\",\n        gain: 0.5,\n        envelope: { attack: 0.002, decay: 0.015, sustain: 0, release: 0.01 },\n      },\n    ],\n  },\n  medium: {\n    name: \"click\",\n    duration: 0.07,\n    notes: [\n      {\n        frequency: 900,\n        duration: 0.05,\n        startAt: 0,\n        waveShape: \"sine\",\n        gain: 0.55,\n        envelope: { attack: 0.002, decay: 0.03, sustain: 0, release: 0.015 },\n      },\n    ],\n  },\n  long: {\n    name: \"click\",\n    duration: 0.12,\n    notes: [\n      {\n        frequency: 700,\n        duration: 0.08,\n        startAt: 0,\n        waveShape: \"triangle\",\n        gain: 0.6,\n        envelope: { attack: 0.002, decay: 0.05, sustain: 0, release: 0.025 },\n      },\n    ],\n  },\n};\n\nexport function clickPreset(\n  variant: SoundVariant,\n  pitchSemitones: number\n): EarconSound {\n  void pitchSemitones;\n  return VARIANTS[variant];\n}\n","// ---------------------------------------------------------------------------\n// earcon — \"info\" preset\n// A neutral single soft tone — informational, non-intrusive.\n// ---------------------------------------------------------------------------\n\nimport type { EarconSound, SoundVariant } from \"../types.js\";\n\nconst VARIANTS: Record<SoundVariant, EarconSound> = {\n  short: {\n    name: \"info\",\n    duration: 0.2,\n    notes: [\n      {\n        frequency: 698.46, // F5\n        duration: 0.18,\n        startAt: 0,\n        waveShape: \"sine\",\n        gain: 0.55,\n        envelope: { attack: 0.015, decay: 0.04, sustain: 0.5, release: 0.1 },\n      },\n    ],\n  },\n  medium: {\n    name: \"info\",\n    duration: 0.35,\n    notes: [\n      {\n        frequency: 698.46,\n        duration: 0.32,\n        startAt: 0,\n        waveShape: \"sine\",\n        gain: 0.55,\n        envelope: { attack: 0.02, decay: 0.05, sustain: 0.5, release: 0.12 },\n      },\n    ],\n  },\n  long: {\n    name: \"info\",\n    duration: 0.55,\n    notes: [\n      {\n        frequency: 587.33, // D5\n        duration: 0.18,\n        startAt: 0,\n        waveShape: \"sine\",\n        gain: 0.5,\n        envelope: { attack: 0.02, decay: 0.05, sustain: 0.4, release: 0.1 },\n      },\n      {\n        frequency: 698.46, // F5\n        duration: 0.3,\n        startAt: 0.2,\n        waveShape: \"sine\",\n        gain: 0.55,\n        envelope: { attack: 0.02, decay: 0.06, sustain: 0.5, release: 0.12 },\n      },\n    ],\n  },\n};\n\nexport function infoPreset(\n  variant: SoundVariant,\n  pitchSemitones: number\n): EarconSound {\n  void pitchSemitones;\n  return VARIANTS[variant];\n}\n","// ---------------------------------------------------------------------------\n// earcon — public API\n// ---------------------------------------------------------------------------\n\nexport type {\n  WaveShape,\n  SoundVariant,\n  SoundOptions,\n  Envelope,\n  NoteEvent,\n  EarconSound,\n  SoundPreset,\n} from \"./types.js\";\n\nexport { closeAudioContext, setAudioContext } from \"./context.js\";\nexport { semitonesToMultiplier } from \"./synth.js\";\n\nimport { getAudioContext } from \"./context.js\";\nimport { playSound } from \"./synth.js\";\nimport type { SoundOptions } from \"./types.js\";\n\nimport {\n  successPreset,\n  errorPreset,\n  warningPreset,\n  notificationPreset,\n  clickPreset,\n  infoPreset,\n} from \"./sounds/index.js\";\n\n// ---------------------------------------------------------------------------\n// Internal helper — resolves options and dispatches to the synth engine\n// ---------------------------------------------------------------------------\n\nasync function play(\n  preset: ReturnType<typeof successPreset>,\n  opts: SoundOptions = {}\n): Promise<void> {\n  const { volume = 0.5, pitch = 0, audioContext, onEnded } = opts;\n  const ctx = audioContext ?? (await getAudioContext());\n  playSound(ctx, preset, volume, pitch, onEnded);\n}\n\n// ---------------------------------------------------------------------------\n// Named play functions — tree-shakable, one per sound type\n// ---------------------------------------------------------------------------\n\n/** Play a success / confirmation sound */\nexport async function playSuccess(opts: SoundOptions = {}): Promise<void> {\n  return play(successPreset(opts.variant ?? \"medium\", opts.pitch ?? 0), opts);\n}\n\n/** Play an error sound */\nexport async function playError(opts: SoundOptions = {}): Promise<void> {\n  return play(errorPreset(opts.variant ?? \"medium\", opts.pitch ?? 0), opts);\n}\n\n/** Play a warning sound */\nexport async function playWarning(opts: SoundOptions = {}): Promise<void> {\n  return play(warningPreset(opts.variant ?? \"medium\", opts.pitch ?? 0), opts);\n}\n\n/** Play a notification / message sound */\nexport async function playNotification(opts: SoundOptions = {}): Promise<void> {\n  return play(\n    notificationPreset(opts.variant ?? \"medium\", opts.pitch ?? 0),\n    opts\n  );\n}\n\n/** Play a UI click / toggle transient */\nexport async function playClick(opts: SoundOptions = {}): Promise<void> {\n  return play(clickPreset(opts.variant ?? \"short\", opts.pitch ?? 0), opts);\n}\n\n/** Play an informational / neutral tone */\nexport async function playInfo(opts: SoundOptions = {}): Promise<void> {\n  return play(infoPreset(opts.variant ?? \"medium\", opts.pitch ?? 0), opts);\n}\n\n// ---------------------------------------------------------------------------\n// Sound bank — generic play-by-name API\n// ---------------------------------------------------------------------------\n\nconst BANK = {\n  success: successPreset,\n  error: errorPreset,\n  warning: warningPreset,\n  notification: notificationPreset,\n  click: clickPreset,\n  info: infoPreset,\n} as const;\n\nexport type SoundName = keyof typeof BANK;\n\n/**\n * Play any registered sound by name.\n *\n * @example\n * await earcon(\"success\");\n * await earcon(\"error\", { variant: \"long\", volume: 0.8 });\n */\nexport async function earcon(\n  name: SoundName,\n  opts: SoundOptions = {}\n): Promise<void> {\n  const preset = BANK[name];\n  return play(preset(opts.variant ?? \"medium\", opts.pitch ?? 0), opts);\n}\n\n/**\n * Register a custom sound under a new name so it can be played via {@link earcon}.\n *\n * @example\n * import type { SoundPreset } from \"earcons\";\n *\n * const mySound: SoundPreset = (variant, pitch) => ({\n *   name: \"mySound\",\n *   duration: 0.3,\n *   notes: [{ frequency: 440, duration: 0.3, startAt: 0 }],\n * });\n *\n * registerSound(\"mySound\", mySound);\n * await earcon(\"mySound\");\n */\nexport function registerSound(name: string, preset: SoundPreset): void {\n  (BANK as Record<string, SoundPreset>)[name] = preset;\n}\n\nimport type { SoundPreset } from \"./types.js\";\n"]}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "earcons",
+  "version": "0.1.0",
+  "description": "Tiny vanilla TypeScript library for playing UI notification sounds via the Web Audio API — no audio files, no dependencies.",
+  "keywords": [
+    "web-audio-api",
+    "notification",
+    "sound",
+    "ui",
+    "earcon",
+    "sfx",
+    "typescript",
+    "browser",
+    "audio",
+    "beep"
+  ],
+  "author": {
+    "name": "smolgroot",
+    "url": "https://github.com/smolgroot"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/smolgroot/earcons.git"
+  },
+  "homepage": "https://github.com/smolgroot/earcons#readme",
+  "bugs": {
+    "url": "https://github.com/smolgroot/earcons/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "browser": "./dist/earcon.min.global.js",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/jsdom": "^28.0.0",
+    "@vitest/coverage-v8": "^1.4.0",
+    "jsdom": "^29.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.4.0"
+  }
+}