earcons 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 smolgroot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,169 @@
+# earcon
+
+> Tiny vanilla TypeScript library for UI notification sounds — pure Web Audio API, no audio files, zero dependencies.
+
+[![npm](https://img.shields.io/npm/v/earcons)](https://www.npmjs.com/package/earcons)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/earcons)](https://bundlephobia.com/package/earcons)
+[![license](https://img.shields.io/npm/l/earcons)](LICENSE)
+
+## Why earcon?
+
+| | earcon | Howler.js | Tone.js | ZzFX |
+|---|:---:|:---:|:---:|:---:|
+| **No audio files** | ✅ | ❌ | ✅ | ✅ |
+| **Notification-specific API** | ✅ | ❌ | ❌ | ❌ |
+| **TypeScript native** | ✅ | via @types | ✅ | ❌ |
+| **Zero dependencies** | ✅ | ✅ | ❌ | ✅ |
+| **Bundle size** | ~3 KB | 318 KB | 5.4 MB | <1 KB |
+| **Semantic sound names** | ✅ | ❌ | ❌ | ❌ |
+| **Customizable** | ✅ | ✅ | ✅ | ✅ |
+
+An [earcon](https://en.wikipedia.org/wiki/Earcon) is an auditory icon — a short, meaningful sound signal used in user interfaces. This library provides a curated set of them, generated entirely in code.
+
+---
+
+## Install
+
+```bash
+npm install earcons
+```
+
+### CDN (no build step)
+
+```html
+<!-- jsDelivr -->
+<script src="https://cdn.jsdelivr.net/npm/earcons/dist/earcon.min.global.js"></script>
+
+<!-- unpkg -->
+<script src="https://unpkg.com/earcons/dist/earcon.min.global.js"></script>
+```
+
+All functions are available under the global `Earcon` object:
+
+```html
+<button onclick="Earcon.playSuccess()">✅</button>
+<button onclick="Earcon.playError()">❌</button>
+<script>
+  // or
+  Earcon.earcon("notification", { volume: 0.8 });
+</script>
+```
+
+---
+
+## Quick start
+
+```ts
+import { playSuccess, playError, playWarning } from "earcons";
+
+// Defaults — medium variant, volume 0.5
+await playSuccess();
+await playError();
+await playWarning();
+```
+
+---
+
+## API
+
+### Named play functions
+
+Each function accepts an optional [`SoundOptions`](#soundoptions) object.
+
+```ts
+import {
+  playSuccess,
+  playError,
+  playWarning,
+  playNotification,
+  playClick,
+  playInfo,
+} from "earcons";
+
+await playSuccess();
+await playError({ variant: "long", volume: 0.8 });
+await playWarning({ variant: "short" });
+await playNotification({ pitch: 7 }); // +7 semitones
+await playClick({ variant: "short" });
+await playInfo({ volume: 0.3 });
+```
+
+### Generic `earcon()` — play by name
+
+```ts
+import { earcon } from "earcons";
+
+await earcon("success");
+await earcon("error", { variant: "long" });
+```
+
+**Built-in sound names:** `success` · `error` · `warning` · `notification` · `click` · `info`
+
+### Register a custom sound
+
+```ts
+import { registerSound, earcon } from "earcons";
+import type { SoundPreset } from "earcons";
+
+const chirp: SoundPreset = (_variant, _pitch) => ({
+  name: "chirp",
+  duration: 0.15,
+  notes: [
+    { frequency: 1200, duration: 0.07, startAt: 0, waveShape: "sine" },
+    { frequency: 1600, duration: 0.08, startAt: 0.07, waveShape: "sine" },
+  ],
+});
+
+registerSound("chirp", chirp);
+await earcon("chirp");
+```
+
+### `SoundOptions`
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `volume` | `number` | `0.5` | Master volume, 0–1 |
+| `variant` | `"short" \| "medium" \| "long"` | `"medium"` | Duration variant |
+| `pitch` | `number` | `0` | Semitone offset (±) |
+| `audioContext` | `AudioContext` | shared singleton | Bring your own context |
+| `onEnded` | `() => void` | — | Called when the sound finishes |
+
+### AudioContext management
+
+```ts
+import { closeAudioContext, setAudioContext } from "earcons";
+
+// Provide your own AudioContext (useful in frameworks)
+const myCtx = new AudioContext();
+setAudioContext(myCtx);
+
+// Tear down (e.g. on unmount)
+await closeAudioContext();
+```
+
+---
+
+## Sound reference
+
+| Name | Waveform | Character |
+|---|---|---|
+| `success` | sine | Ascending major triad — bright, positive |
+| `error` | sawtooth | Descending tritone — harsh, attention-grabbing |
+| `warning` | triangle | Flat then descending minor second — cautious |
+| `notification` | sine | Soft descending two-tone ding — neutral |
+| `click` | sine | Very short transient — tactile UI feedback |
+| `info` | sine | Single soft tone — informational, non-intrusive |
+
+---
+
+## Browser support
+
+Any browser that supports the [Web Audio API](https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API) (all modern browsers since 2014).
+
+> **Autoplay policy:** earcon automatically calls `AudioContext.resume()` before playing. Make sure you call a play function in response to a user gesture on first load, or the browser may suppress audio.
+
+---
+
+## License
+
+MIT

package/dist/earcon.min.global.js

@@ -0,0 +1 @@
+"use strict";var Earcon=(()=>{var w=Object.defineProperty;var N=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var R=Object.prototype.hasOwnProperty;var O=(e,n)=>{for(var o in n)w(e,o,{get:n[o],enumerable:!0})},b=(e,n,o,c)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of C(n))!R.call(e,r)&&r!==o&&w(e,r,{get:()=>n[r],enumerable:!(c=N(n,r))||c.enumerable});return e};var j=e=>b(w({},"__esModule",{value:!0}),e);var Y={};O(Y,{closeAudioContext:()=>V,earcon:()=>Q,playClick:()=>H,playError:()=>F,playInfo:()=>J,playNotification:()=>z,playSuccess:()=>D,playWarning:()=>U,registerSound:()=>X,semitonesToMultiplier:()=>q,setAudioContext:()=>P});var u=null;async function E(){return u||(u=new AudioContext),u.state==="suspended"&&await u.resume(),u}async function V(){u&&(await u.close(),u=null)}function P(e){u=e}var G={attack:.01,decay:.05,sustain:.7,release:.08,hold:0};function q(e){return Math.pow(2,e/12)}function I(e,n,o,c,r){let t={...G,...n.envelope},i=r+n.startAt,s=n.gain??1,m=n.waveShape??"sine",d=n.frequency*c,a=e.createGain();a.connect(o),a.gain.setValueAtTime(0,i),a.gain.linearRampToValueAtTime(s,i+t.attack);let x=i+t.attack+(t.hold??0);a.gain.setValueAtTime(s,x),a.gain.linearRampToValueAtTime(s*t.sustain,x+t.decay);let l=i+n.duration;a.gain.setValueAtTime(s*t.sustain,l),a.gain.linearRampToValueAtTime(0,l+t.release);let f=e.createOscillator();return f.type=m,f.frequency.setValueAtTime(d,i),f.connect(a),f.start(i),f.stop(l+t.release+.01),l+t.release}function k(e,n,o,c,r){let t=e.createGain();t.gain.setValueAtTime(Math.max(0,Math.min(1,o)),e.currentTime),t.connect(e.destination);let i=q(c),s=e.currentTime,m=s;for(let d of n.notes){let a=I(e,d,t,i,s);a>m&&(m=a)}if(r){let d=e.createOscillator(),a=e.createGain();a.gain.setValueAtTime(0,s),d.connect(a),a.connect(e.destination),d.start(s),d.stop(m),d.onended=r}}var M={short:{name:"success",duration:.25,notes:[{frequency:523.25,duration:.1,startAt:0,waveShape:"sine",gain:.8},{frequency:783.99,duration:.15,startAt:.1,waveShape:"sine",gain:.9}]},medium:{name:"success",duration:.45,notes:[{frequency:523.25,duration:.12,startAt:0,waveShape:"sine",gain:.7},{frequency:659.25,duration:.12,startAt:.12,waveShape:"sine",gain:.8},{frequency:783.99,duration:.2,startAt:.24,waveShape:"sine",gain:.9}]},long:{name:"success",duration:.7,notes:[{frequency:392,duration:.1,startAt:0,waveShape:"sine",gain:.6},{frequency:523.25,duration:.12,startAt:.1,waveShape:"sine",gain:.7},{frequency:659.25,duration:.12,startAt:.22,waveShape:"sine",gain:.8},{frequency:783.99,duration:.25,startAt:.34,waveShape:"sine",gain:.9}]}};function S(e,n){return M[e]}var B={short:{name:"error",duration:.25,notes:[{frequency:440,duration:.1,startAt:0,waveShape:"square",gain:.5,envelope:{attack:.005,decay:.04,sustain:.6,release:.06}},{frequency:311,duration:.15,startAt:.1,waveShape:"square",gain:.6,envelope:{attack:.005,decay:.04,sustain:.6,release:.06}}]},medium:{name:"error",duration:.5,notes:[{frequency:440,duration:.12,startAt:0,waveShape:"sawtooth",gain:.4,envelope:{attack:.005,decay:.06,sustain:.5,release:.08}},{frequency:392,duration:.12,startAt:.13,waveShape:"sawtooth",gain:.45,envelope:{attack:.005,decay:.06,sustain:.5,release:.08}},{frequency:311,duration:.2,startAt:.26,waveShape:"sawtooth",gain:.55,envelope:{attack:.005,decay:.06,sustain:.5,release:.12}}]},long:{name:"error",duration:.75,notes:[{frequency:440,duration:.12,startAt:0,waveShape:"sawtooth",gain:.4,envelope:{attack:.005,decay:.07,sustain:.5,release:.1}},{frequency:415,duration:.1,startAt:.14,waveShape:"sawtooth",gain:.4,envelope:{attack:.005,decay:.07,sustain:.5,release:.1}},{frequency:370,duration:.12,startAt:.26,waveShape:"sawtooth",gain:.45,envelope:{attack:.005,decay:.07,sustain:.5,release:.1}},{frequency:311,duration:.25,startAt:.4,waveShape:"sawtooth",gain:.55,envelope:{attack:.005,decay:.08,sustain:.5,release:.15}}]}};function y(e,n){return B[e]}var K={short:{name:"warning",duration:.28,notes:[{frequency:587.33,duration:.1,startAt:0,waveShape:"triangle",gain:.7},{frequency:523.25,duration:.18,startAt:.1,waveShape:"triangle",gain:.75}]},medium:{name:"warning",duration:.5,notes:[{frequency:587.33,duration:.12,startAt:0,waveShape:"triangle",gain:.65},{frequency:587.33,duration:.12,startAt:.14,waveShape:"triangle",gain:.65},{frequency:493.88,duration:.2,startAt:.28,waveShape:"triangle",gain:.75}]},long:{name:"warning",duration:.8,notes:[{frequency:587.33,duration:.12,startAt:0,waveShape:"triangle",gain:.6},{frequency:587.33,duration:.12,startAt:.15,waveShape:"triangle",gain:.6},{frequency:554.37,duration:.12,startAt:.3,waveShape:"triangle",gain:.65},{frequency:493.88,duration:.25,startAt:.45,waveShape:"triangle",gain:.75}]}};function v(e,n){return K[e]}var L={short:{name:"notification",duration:.22,notes:[{frequency:880,duration:.08,startAt:0,waveShape:"sine",gain:.6},{frequency:660,duration:.14,startAt:.08,waveShape:"sine",gain:.65}]},medium:{name:"notification",duration:.38,notes:[{frequency:880,duration:.1,startAt:0,waveShape:"sine",gain:.55},{frequency:660,duration:.28,startAt:.1,waveShape:"sine",gain:.6}]},long:{name:"notification",duration:.55,notes:[{frequency:1046.5,duration:.08,startAt:0,waveShape:"sine",gain:.5},{frequency:880,duration:.1,startAt:.1,waveShape:"sine",gain:.55},{frequency:660,duration:.3,startAt:.22,waveShape:"sine",gain:.6}]}};function g(e,n){return L[e]}var W={short:{name:"click",duration:.04,notes:[{frequency:1200,duration:.03,startAt:0,waveShape:"sine",gain:.5,envelope:{attack:.002,decay:.015,sustain:0,release:.01}}]},medium:{name:"click",duration:.07,notes:[{frequency:900,duration:.05,startAt:0,waveShape:"sine",gain:.55,envelope:{attack:.002,decay:.03,sustain:0,release:.015}}]},long:{name:"click",duration:.12,notes:[{frequency:700,duration:.08,startAt:0,waveShape:"triangle",gain:.6,envelope:{attack:.002,decay:.05,sustain:0,release:.025}}]}};function A(e,n){return W[e]}var _={short:{name:"info",duration:.2,notes:[{frequency:698.46,duration:.18,startAt:0,waveShape:"sine",gain:.55,envelope:{attack:.015,decay:.04,sustain:.5,release:.1}}]},medium:{name:"info",duration:.35,notes:[{frequency:698.46,duration:.32,startAt:0,waveShape:"sine",gain:.55,envelope:{attack:.02,decay:.05,sustain:.5,release:.12}}]},long:{name:"info",duration:.55,notes:[{frequency:587.33,duration:.18,startAt:0,waveShape:"sine",gain:.5,envelope:{attack:.02,decay:.05,sustain:.4,release:.1}},{frequency:698.46,duration:.3,startAt:.2,waveShape:"sine",gain:.55,envelope:{attack:.02,decay:.06,sustain:.5,release:.12}}]}};function h(e,n){return _[e]}async function p(e,n={}){let{volume:o=.5,pitch:c=0,audioContext:r,onEnded:t}=n,i=r??await E();k(i,e,o,c,t)}async function D(e={}){return p(S(e.variant??"medium",e.pitch??0),e)}async function F(e={}){return p(y(e.variant??"medium",e.pitch??0),e)}async function U(e={}){return p(v(e.variant??"medium",e.pitch??0),e)}async function z(e={}){return p(g(e.variant??"medium",e.pitch??0),e)}async function H(e={}){return p(A(e.variant??"short",e.pitch??0),e)}async function J(e={}){return p(h(e.variant??"medium",e.pitch??0),e)}var T={success:S,error:y,warning:v,notification:g,click:A,info:h};async function Q(e,n={}){let o=T[e];return p(o(n.variant??"medium",n.pitch??0),n)}function X(e,n){T[e]=n}return j(Y);})();

package/dist/index.cjs

@@ -0,0 +1,449 @@
+'use strict';
+
+// 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;
+}
+
+exports.closeAudioContext = closeAudioContext;
+exports.earcon = earcon;
+exports.playClick = playClick;
+exports.playError = playError;
+exports.playInfo = playInfo;
+exports.playNotification = playNotification;
+exports.playSuccess = playSuccess;
+exports.playWarning = playWarning;
+exports.registerSound = registerSound;
+exports.semitonesToMultiplier = semitonesToMultiplier;
+exports.setAudioContext = setAudioContext;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map