sonics 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Philip Poloczek
+
+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,131 @@
+# sonics
+
+**Tiny, dependency-free UI sounds you can feel.** Synthesised in the browser with the Web Audio API — no audio files, no network payload, ~3 KB.
+
+`sonics` is the audio sibling of a haptics library: a small kit for adding _tasteful_ microinteraction sounds (clicks, taps, toggles, confirmations) to a web UI. Every sound is a plain, serialisable object, so you can design one in the [playground](https://github.com/OWNER/sonics), copy the spec, and replay it anywhere.
+
+```js
+import sonics from "sonics";
+
+sonics("click"); // that's it
+```
+
+## Install
+
+```sh
+npm install sonics
+```
+
+## Quick start
+
+```js
+import sonics, { play, armAutoUnlock } from "sonics";
+
+// Browsers block audio until the first user gesture. Call once on load:
+armAutoUnlock();
+
+play("click"); // a built-in preset
+
+const tap = sonics.sound("tap"); // bind a reusable trigger
+button.addEventListener("click", tap);
+
+play("click", { volume: 0.6, rate: 1.2, humanize: 0.5 }); // tweak per play
+```
+
+**Presets:** `click` · `tap` · `tick` · `pop` · `toggleOn` · `toggleOff` · `success` · `error`
+
+## Roll your own
+
+A sound is a spec — nothing more:
+
+```js
+const doorbell = {
+  volume: 0.9,
+  ticks: [
+    { at: 0, gain: 0.5, freq: 2637, q: 8, decay: 0.006, tail: 0.9 }, // E7
+    { at: 0.09, gain: 0.55, freq: 3520, q: 8, decay: 0.008, tail: 0.9 }, // A7
+  ],
+};
+play(doorbell);
+```
+
+| Tick field | meaning                                  | default  |
+| ---------- | ---------------------------------------- | -------- |
+| `at`       | start time (s), relative to sound start  | `0`      |
+| `gain`     | loudness of this tick (0..1)             | `0.5`    |
+| `freq`     | resonant frequency (Hz)                  | `3120`   |
+| `q`        | band-pass Q — higher = more tonal/ringy  | `7`      |
+| `decay`    | amplitude decay time constant (s)        | `0.0032` |
+| `noise`    | noise-burst "breath" mix (0..1)          | `1`      |
+| `tail`     | pure resonant sine tail level (0..1)     | `0.6`    |
+| `bright`   | high attack "tick" transient (0..1)      | `0.55`   |
+| `partial`  | high-partial multiplier (`freq*partial`) | `3.3`    |
+
+## Design & export
+
+```js
+import { encode, decode, toWav } from "sonics";
+
+const str = encode(mySpec); // URL-safe, shareable string
+play(decode(str)); // replay anywhere
+
+const blob = await toWav("click"); // bake to a 16-bit WAV Blob if you prefer a file
+```
+
+## React
+
+Zero extra dependencies — React is a peer.
+
+```jsx
+import { SonicsProvider, useSound, SonicsButton, useSonics } from "sonics/react";
+
+function App() {
+  return (
+    <SonicsProvider>
+      <Toolbar />
+    </SonicsProvider>
+  );
+}
+
+function Toolbar() {
+  const save = useSound("click");
+  const { enabled, toggle } = useSonics();
+  return (
+    <>
+      <button
+        onClick={() => {
+          doSave();
+          save();
+        }}
+      >
+        Save
+      </button>
+      <SonicsButton sound="toggleOn" onClick={next}>
+        Next
+      </SonicsButton>
+      <label>
+        <input type="checkbox" checked={enabled} onChange={toggle} /> Sound
+      </label>
+    </>
+  );
+}
+```
+
+- `<SonicsProvider>` — shared enabled/volume state, persisted, defaults off under `prefers-reduced-motion`, arms auto-unlock.
+- `useSound(sound, opts)` — a stable trigger callback.
+- `useSonics()` — `{ enabled, setEnabled, toggle, volume, setVolume, play }`; safe without a provider.
+- `<SonicsButton>` — a button (or any `as=` element) that plays on `click` / `pointerdown` / `hover`.
+
+## Good-citizen defaults
+
+- Won't play in a background tab (`document.hidden`).
+- One shared `AudioContext`, resumed on first gesture via `armAutoUnlock()`.
+- Global `setMuted()` / `setVolume()`; the React provider wires these to a persisted toggle and respects `prefers-reduced-motion`.
+
+## Credit
+
+`sonics` occupies a specific empty cell: **synth-based** (not file playback), **tasteful UI** (not retro game SFX), tiny/zero-dep, with a designer. It stands on the shoulders of [ZzFX](https://github.com/KilledByAPixel/ZzFX) (Frank Force), [web-haptics](https://github.com/lochie/web-haptics) (Lochie Axon — the sibling-modality design→export loop this mirrors), [sfxr](https://www.drpetter.se/project_sfxr.html) (DrPetter) and its web ports [jsfxr](https://github.com/chr15m/jsfxr) / [jfxr](https://jfxr.frozenfractal.com/), [snd-lib](https://snd.dev/), and [use-sound](https://github.com/joshwcomeau/use-sound) (Josh W. Comeau). The default `click` preset was reverse-engineered from the ElevenLabs onboarding sound. See the root README for the full story.
+
+## License
+
+MIT © Philip Poloczek

package/dist/index.d.mts

@@ -0,0 +1,213 @@
+/*!
+ * sonics — tiny, dependency-free UI sounds you can feel.
+ *
+ * Synthesises pleasant microinteraction sounds at runtime with the Web Audio
+ * API. No audio files, no dependencies. Every sound is a plain, serialisable
+ * spec object, so you can design one, encode it to a string, share it, and
+ * replay it anywhere.
+ *
+ * The physical model (per "tick"): a short burst of noise strikes a resonant
+ * body (a band-pass filter), which rings at `freq` and decays in `decay`
+ * seconds. Stack two ticks a few ms apart and you get the "press + release"
+ * of a mechanical switch — the thing that makes a click feel tactile.
+ *
+ * Reverse-engineered from the ElevenLabs onboarding click. See README.
+ * License: MIT.
+ */
+/** A single impulse. All fields optional; sensible defaults are filled in. */
+interface Tick {
+    /** Start time in seconds, relative to the sound's start. Default 0. */
+    at?: number;
+    /** Loudness of this tick, 0..1. Default 0.5. */
+    gain?: number;
+    /** Resonant frequency in Hz. Default 3120. */
+    freq?: number;
+    /** Band-pass Q — higher is more tonal/ringing. Default 7. */
+    q?: number;
+    /** Amplitude decay time constant in seconds. Default 0.0032. */
+    decay?: number;
+    /** Amount of noise-burst "breath", 0..1. Default 1. */
+    noise?: number;
+    /** Level of the pure resonant sine tail, 0..1. Default 0.6. */
+    tail?: number;
+    /** Level of the high attack transient / "tick", 0..1. Default 0.55. */
+    bright?: number;
+    /** High-partial frequency multiplier (freq * partial). Default 3.3. */
+    partial?: number;
+}
+/** A complete sound: master volume plus one or more ticks. */
+interface Sound {
+    /** Master gain for the whole sound. Default 0.9. */
+    volume?: number;
+    ticks: Tick[];
+    /** Optional label, purely for humans. */
+    name?: string;
+}
+interface PlayOptions {
+    /** Per-play volume multiplier. Default 1. */
+    volume?: number;
+    /** Pitch/speed: scales every freq and 1/time. Default 1. */
+    rate?: number;
+    /** 0..1 — random pitch/gain jitter so repeats aren't identical. Default 0. */
+    humanize?: number;
+    /** Delay before playing, in seconds. Default 0. */
+    when?: number;
+}
+interface RenderOptions {
+    sampleRate?: number;
+    /** Extra silence appended after the sound, in seconds. Default 0.02. */
+    tail?: number;
+}
+type SoundInput = Sound | PresetName | (string & {});
+declare const DEFAULT_TICK: Required<Tick>;
+/** Is the Web Audio API available in this environment? */
+declare function isSupported(): boolean;
+/** Get (or lazily create) the shared AudioContext + master gain node. */
+declare function context(): AudioContext;
+/**
+ * Browsers suspend audio until a user gesture. Call this from a click/keydown,
+ * or call `armAutoUnlock()` once and forget about it. Safe to call often.
+ */
+declare function unlock(): Promise<void>;
+/** Resume audio automatically on the first pointer/key/touch gesture. */
+declare function armAutoUnlock(): void;
+declare function setMuted(m: boolean): void;
+declare function isMuted(): boolean;
+/** Master volume, 0..1 (or higher). Applied to every sound. */
+declare function setVolume(v: number): void;
+declare function getVolume(): number;
+/** Play a sound now. `sound` is a spec, a preset name, or an encoded string. */
+declare function play(sound: SoundInput, opts?: PlayOptions): void;
+/** Returns a bound trigger function for a sound. */
+declare function sound(soundOrName: SoundInput, opts?: PlayOptions): () => void;
+/** Render a spec to a mono AudioBuffer without playing it. */
+declare function render(sound: SoundInput, opts?: RenderOptions): Promise<AudioBuffer>;
+/** Render a spec and return a 16-bit PCM WAV Blob you can download. */
+declare function toWav(sound: SoundInput, opts?: RenderOptions): Promise<Blob>;
+/** Encode a spec to a URL-safe string you can save, share, or put in a link. */
+declare function encode(spec: Sound): string;
+/** Decode a string produced by `encode` back into a spec. */
+declare function decode(str: string): Sound;
+declare const presets: {
+    /** The ElevenLabs-style double click: two ticks, the release slightly louder. */
+    click: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+        }[];
+    };
+    /** A single soft tap — lighter than a full click. */
+    tap: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+            bright: number;
+        }[];
+    };
+    /** Tiny, dry — good for list/keyboard ticks. */
+    tick: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+            tail: number;
+            bright: number;
+        }[];
+    };
+    /** Rounder, lower — a "pop". */
+    pop: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+            bright: number;
+            tail: number;
+        }[];
+    };
+    /** Two ticks rising in pitch = "on". */
+    toggleOn: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+        }[];
+    };
+    /** Two ticks falling in pitch = "off". */
+    toggleOff: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+        }[];
+    };
+    /** Gentle two-note rise for confirmations. */
+    success: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+            tail: number;
+            noise: number;
+        }[];
+    };
+    /** Two low, close ticks for errors — dull, not harsh. */
+    error: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+            tail: number;
+            noise: number;
+            bright: number;
+        }[];
+    };
+};
+type PresetName = keyof typeof presets;
+interface Sonics {
+    (sound: SoundInput, opts?: PlayOptions): void;
+    play: typeof play;
+    sound: typeof sound;
+    presets: typeof presets;
+    render: typeof render;
+    toWav: typeof toWav;
+    encode: typeof encode;
+    decode: typeof decode;
+    context: typeof context;
+    unlock: typeof unlock;
+    armAutoUnlock: typeof armAutoUnlock;
+    isSupported: typeof isSupported;
+    setMuted: typeof setMuted;
+    isMuted: typeof isMuted;
+    setVolume: typeof setVolume;
+    getVolume: typeof getVolume;
+    DEFAULT_TICK: typeof DEFAULT_TICK;
+}
+declare const sonics: Sonics;
+
+export { DEFAULT_TICK, type PlayOptions, type PresetName, type RenderOptions, type Sonics, type Sound, type SoundInput, type Tick, armAutoUnlock, context, decode, sonics as default, encode, getVolume, isMuted, isSupported, play, presets, render, setMuted, setVolume, sound, toWav, unlock };

package/dist/index.d.ts

@@ -0,0 +1,213 @@
+/*!
+ * sonics — tiny, dependency-free UI sounds you can feel.
+ *
+ * Synthesises pleasant microinteraction sounds at runtime with the Web Audio
+ * API. No audio files, no dependencies. Every sound is a plain, serialisable
+ * spec object, so you can design one, encode it to a string, share it, and
+ * replay it anywhere.
+ *
+ * The physical model (per "tick"): a short burst of noise strikes a resonant
+ * body (a band-pass filter), which rings at `freq` and decays in `decay`
+ * seconds. Stack two ticks a few ms apart and you get the "press + release"
+ * of a mechanical switch — the thing that makes a click feel tactile.
+ *
+ * Reverse-engineered from the ElevenLabs onboarding click. See README.
+ * License: MIT.
+ */
+/** A single impulse. All fields optional; sensible defaults are filled in. */
+interface Tick {
+    /** Start time in seconds, relative to the sound's start. Default 0. */
+    at?: number;
+    /** Loudness of this tick, 0..1. Default 0.5. */
+    gain?: number;
+    /** Resonant frequency in Hz. Default 3120. */
+    freq?: number;
+    /** Band-pass Q — higher is more tonal/ringing. Default 7. */
+    q?: number;
+    /** Amplitude decay time constant in seconds. Default 0.0032. */
+    decay?: number;
+    /** Amount of noise-burst "breath", 0..1. Default 1. */
+    noise?: number;
+    /** Level of the pure resonant sine tail, 0..1. Default 0.6. */
+    tail?: number;
+    /** Level of the high attack transient / "tick", 0..1. Default 0.55. */
+    bright?: number;
+    /** High-partial frequency multiplier (freq * partial). Default 3.3. */
+    partial?: number;
+}
+/** A complete sound: master volume plus one or more ticks. */
+interface Sound {
+    /** Master gain for the whole sound. Default 0.9. */
+    volume?: number;
+    ticks: Tick[];
+    /** Optional label, purely for humans. */
+    name?: string;
+}
+interface PlayOptions {
+    /** Per-play volume multiplier. Default 1. */
+    volume?: number;
+    /** Pitch/speed: scales every freq and 1/time. Default 1. */
+    rate?: number;
+    /** 0..1 — random pitch/gain jitter so repeats aren't identical. Default 0. */
+    humanize?: number;
+    /** Delay before playing, in seconds. Default 0. */
+    when?: number;
+}
+interface RenderOptions {
+    sampleRate?: number;
+    /** Extra silence appended after the sound, in seconds. Default 0.02. */
+    tail?: number;
+}
+type SoundInput = Sound | PresetName | (string & {});
+declare const DEFAULT_TICK: Required<Tick>;
+/** Is the Web Audio API available in this environment? */
+declare function isSupported(): boolean;
+/** Get (or lazily create) the shared AudioContext + master gain node. */
+declare function context(): AudioContext;
+/**
+ * Browsers suspend audio until a user gesture. Call this from a click/keydown,
+ * or call `armAutoUnlock()` once and forget about it. Safe to call often.
+ */
+declare function unlock(): Promise<void>;
+/** Resume audio automatically on the first pointer/key/touch gesture. */
+declare function armAutoUnlock(): void;
+declare function setMuted(m: boolean): void;
+declare function isMuted(): boolean;
+/** Master volume, 0..1 (or higher). Applied to every sound. */
+declare function setVolume(v: number): void;
+declare function getVolume(): number;
+/** Play a sound now. `sound` is a spec, a preset name, or an encoded string. */
+declare function play(sound: SoundInput, opts?: PlayOptions): void;
+/** Returns a bound trigger function for a sound. */
+declare function sound(soundOrName: SoundInput, opts?: PlayOptions): () => void;
+/** Render a spec to a mono AudioBuffer without playing it. */
+declare function render(sound: SoundInput, opts?: RenderOptions): Promise<AudioBuffer>;
+/** Render a spec and return a 16-bit PCM WAV Blob you can download. */
+declare function toWav(sound: SoundInput, opts?: RenderOptions): Promise<Blob>;
+/** Encode a spec to a URL-safe string you can save, share, or put in a link. */
+declare function encode(spec: Sound): string;
+/** Decode a string produced by `encode` back into a spec. */
+declare function decode(str: string): Sound;
+declare const presets: {
+    /** The ElevenLabs-style double click: two ticks, the release slightly louder. */
+    click: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+        }[];
+    };
+    /** A single soft tap — lighter than a full click. */
+    tap: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+            bright: number;
+        }[];
+    };
+    /** Tiny, dry — good for list/keyboard ticks. */
+    tick: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+            tail: number;
+            bright: number;
+        }[];
+    };
+    /** Rounder, lower — a "pop". */
+    pop: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+            bright: number;
+            tail: number;
+        }[];
+    };
+    /** Two ticks rising in pitch = "on". */
+    toggleOn: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+        }[];
+    };
+    /** Two ticks falling in pitch = "off". */
+    toggleOff: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+        }[];
+    };
+    /** Gentle two-note rise for confirmations. */
+    success: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+            tail: number;
+            noise: number;
+        }[];
+    };
+    /** Two low, close ticks for errors — dull, not harsh. */
+    error: {
+        volume: number;
+        ticks: {
+            at: number;
+            gain: number;
+            freq: number;
+            q: number;
+            decay: number;
+            tail: number;
+            noise: number;
+            bright: number;
+        }[];
+    };
+};
+type PresetName = keyof typeof presets;
+interface Sonics {
+    (sound: SoundInput, opts?: PlayOptions): void;
+    play: typeof play;
+    sound: typeof sound;
+    presets: typeof presets;
+    render: typeof render;
+    toWav: typeof toWav;
+    encode: typeof encode;
+    decode: typeof decode;
+    context: typeof context;
+    unlock: typeof unlock;
+    armAutoUnlock: typeof armAutoUnlock;
+    isSupported: typeof isSupported;
+    setMuted: typeof setMuted;
+    isMuted: typeof isMuted;
+    setVolume: typeof setVolume;
+    getVolume: typeof getVolume;
+    DEFAULT_TICK: typeof DEFAULT_TICK;
+}
+declare const sonics: Sonics;
+
+export { DEFAULT_TICK, type PlayOptions, type PresetName, type RenderOptions, type Sonics, type Sound, type SoundInput, type Tick, armAutoUnlock, context, decode, sonics as default, encode, getVolume, isMuted, isSupported, play, presets, render, setMuted, setVolume, sound, toWav, unlock };

package/dist/index.js

@@ -0,0 +1,16 @@
+'use strict';Object.defineProperty(exports,'__esModule',{value:true});var l={at:0,gain:.5,freq:3120,q:7,decay:.0032,noise:1,tail:.6,bright:.55,partial:3.3},w=4e-4,v=1e-4,g=typeof window<"u"?(window.AudioContext||window.webkitAudioContext)??null:null,p=null,m=null,T=null,A=false,y=1,k=false;function B(){return !!g}function h(){if(!g)throw new Error("sonics: Web Audio API not available");return p||(p=new g,m=p.createGain(),m.gain.value=y,m.connect(p.destination),T=S(p,.03)),p}function C(){let e=h();return e.state==="suspended"?e.resume():Promise.resolve()}function P(){if(k||typeof window>"u")return;k=true;let e=["pointerdown","keydown","touchstart"],n=()=>{C(),e.forEach(a=>window.removeEventListener(a,n));};e.forEach(a=>window.addEventListener(a,n,{once:true,passive:true}));}function E(e){A=!!e;}function _(){return A}function N(e){y=Math.max(0,e),m&&(m.gain.value=y);}function D(){return y}function S(e,n){let a=e.createBuffer(1,Math.max(1,Math.floor(e.sampleRate*n)),e.sampleRate),u=a.getChannelData(0);for(let c=0;c<u.length;c++)u[c]=Math.random()*2-1;return a}function O(e,n,a,u,c){let t={...l,...u},o=a+t.at;if(t.noise>0){let i=e.createBufferSource();i.buffer=c;let r=e.createBiquadFilter();r.type="bandpass",r.frequency.value=t.freq,r.Q.value=t.q;let s=e.createGain();s.gain.setValueAtTime(0,o),s.gain.linearRampToValueAtTime(t.gain*t.noise,o+w),s.gain.exponentialRampToValueAtTime(v,o+t.decay),i.connect(r).connect(s).connect(n),i.start(o),i.stop(o+t.decay+.02);}if(t.tail>0){let i=e.createOscillator();i.type="sine",i.frequency.value=t.freq;let r=e.createGain();r.gain.setValueAtTime(0,o),r.gain.linearRampToValueAtTime(t.gain*t.tail,o+w),r.gain.exponentialRampToValueAtTime(v,o+t.decay*1.25),i.connect(r).connect(n),i.start(o),i.stop(o+t.decay*1.5+.02);}if(t.bright>0){let i=e.createOscillator();i.type="sine",i.frequency.value=t.freq*t.partial;let r=e.createGain();r.gain.setValueAtTime(0,o),r.gain.linearRampToValueAtTime(t.gain*.3*t.bright,o+w*.75),r.gain.exponentialRampToValueAtTime(v,o+.004),i.connect(r).connect(n),i.start(o),i.stop(o+.02);}}function R(e){let n=0;for(let a of e.ticks??[]){let u={...l,...a};n=Math.max(n,u.at+u.decay*1.5+.03);}return n||.05}function q(e,n={}){if(!g||A||typeof document<"u"&&document.hidden)return;let a=V(e);if(!a.ticks?.length)return;let u=h();u.state==="suspended"&&u.resume();let{volume:c=1,rate:t=1,humanize:o=0,when:i=0}=n,r=u.createGain();r.gain.value=(a.volume??.9)*c,r.connect(m);let s=u.currentTime+Math.max(0,i)+.005,d=b=>1+(Math.random()*2-1)*b;for(let b of a.ticks){let f={...b};t!==1&&(f.freq=(f.freq??l.freq)*t,f.at=(f.at??0)/t,f.decay=(f.decay??l.decay)/t),o>0&&(f.freq=(f.freq??l.freq)*d(.03*o),f.gain=(f.gain??l.gain)*d(.12*o)),O(u,r,s,f,T);}let I=R(a)/t;setTimeout(()=>{try{r.disconnect();}catch{}},(I+.1)*1e3);}function F(e,n){return ()=>q(e,n)}async function U(e,n={}){let{sampleRate:a=44100,tail:u=.02}=n,c=V(e),t=R(c)+u,o=typeof window<"u"?window.OfflineAudioContext||window.webkitOfflineAudioContext:null;if(!o)throw new Error("sonics: OfflineAudioContext not available");let i=new o(1,Math.ceil(a*t),a),r=S(i,.03),s=i.createGain();s.gain.value=c.volume??.9,s.connect(i.destination);for(let d of c.ticks)O(i,s,.001,d,r);return i.startRendering()}async function G(e,n){return W(await U(e,n))}function W(e){let n=e.getChannelData(0),a=e.sampleRate,u=n.length,c=new ArrayBuffer(44+u*2),t=new DataView(c),o=(r,s)=>{for(let d=0;d<s.length;d++)t.setUint8(r+d,s.charCodeAt(d));};o(0,"RIFF"),t.setUint32(4,36+u*2,true),o(8,"WAVE"),o(12,"fmt "),t.setUint32(16,16,true),t.setUint16(20,1,true),t.setUint16(22,1,true),t.setUint32(24,a,true),t.setUint32(28,a*2,true),t.setUint16(32,2,true),t.setUint16(34,16,true),o(36,"data"),t.setUint32(40,u*2,true);let i=44;for(let r=0;r<u;r++){let s=Math.max(-1,Math.min(1,n[r]));t.setInt16(i,s<0?s*32768:s*32767,true),i+=2;}return new Blob([c],{type:"audio/wav"})}function L(e){let n=JSON.stringify(e);return btoa(unescape(encodeURIComponent(n))).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,"")}function M(e){let n=e.replace(/-/g,"+").replace(/_/g,"/"),a=decodeURIComponent(escape(atob(n)));return JSON.parse(a)}var x={click:{volume:.9,ticks:[{at:0,gain:.5,freq:3120,q:7,decay:.0032},{at:.0276,gain:.66,freq:3120,q:7,decay:.0032}]},tap:{volume:.8,ticks:[{at:0,gain:.55,freq:2600,q:6,decay:.004,bright:.4}]},tick:{volume:.7,ticks:[{at:0,gain:.4,freq:4200,q:9,decay:.0018,tail:.3,bright:.7}]},pop:{volume:.9,ticks:[{at:0,gain:.6,freq:1400,q:5,decay:.006,bright:.25,tail:.8}]},toggleOn:{volume:.85,ticks:[{at:0,gain:.45,freq:2600,q:7,decay:.003},{at:.03,gain:.6,freq:3500,q:7,decay:.0035}]},toggleOff:{volume:.85,ticks:[{at:0,gain:.55,freq:3200,q:7,decay:.003},{at:.03,gain:.45,freq:2300,q:7,decay:.0035}]},success:{volume:.85,ticks:[{at:0,gain:.5,freq:2637,q:8,decay:.006,tail:.9,noise:.3},{at:.09,gain:.55,freq:3520,q:8,decay:.008,tail:.9,noise:.3}]},error:{volume:.85,ticks:[{at:0,gain:.55,freq:320,q:4,decay:.02,tail:.9,noise:.2,bright:.05},{at:.12,gain:.55,freq:300,q:4,decay:.02,tail:.9,noise:.2,bright:.05}]}};function V(e){if(typeof e=="string"){if(e in x)return x[e];try{return M(e)}catch{throw new Error(`sonics: unknown preset or bad encoded string "${e}"`)}}return e}var j=Object.assign((e,n)=>q(e,n),{play:q,sound:F,presets:x,render:U,toWav:G,encode:L,decode:M,context:h,unlock:C,armAutoUnlock:P,isSupported:B,setMuted:E,isMuted:_,setVolume:N,getVolume:D,DEFAULT_TICK:l}),K=j;/*!
+ * sonics — tiny, dependency-free UI sounds you can feel.
+ *
+ * Synthesises pleasant microinteraction sounds at runtime with the Web Audio
+ * API. No audio files, no dependencies. Every sound is a plain, serialisable
+ * spec object, so you can design one, encode it to a string, share it, and
+ * replay it anywhere.
+ *
+ * The physical model (per "tick"): a short burst of noise strikes a resonant
+ * body (a band-pass filter), which rings at `freq` and decays in `decay`
+ * seconds. Stack two ticks a few ms apart and you get the "press + release"
+ * of a mechanical switch — the thing that makes a click feel tactile.
+ *
+ * Reverse-engineered from the ElevenLabs onboarding click. See README.
+ * License: MIT.
+ */exports.DEFAULT_TICK=l;exports.armAutoUnlock=P;exports.context=h;exports.decode=M;exports.default=K;exports.encode=L;exports.getVolume=D;exports.isMuted=_;exports.isSupported=B;exports.play=q;exports.presets=x;exports.render=U;exports.setMuted=E;exports.setVolume=N;exports.sound=F;exports.toWav=G;exports.unlock=C;

package/dist/index.mjs

@@ -0,0 +1,16 @@
+var l={at:0,gain:.5,freq:3120,q:7,decay:.0032,noise:1,tail:.6,bright:.55,partial:3.3},w=4e-4,v=1e-4,g=typeof window<"u"?(window.AudioContext||window.webkitAudioContext)??null:null,p=null,m=null,T=null,A=false,y=1,k=false;function B(){return !!g}function h(){if(!g)throw new Error("sonics: Web Audio API not available");return p||(p=new g,m=p.createGain(),m.gain.value=y,m.connect(p.destination),T=S(p,.03)),p}function C(){let e=h();return e.state==="suspended"?e.resume():Promise.resolve()}function P(){if(k||typeof window>"u")return;k=true;let e=["pointerdown","keydown","touchstart"],n=()=>{C(),e.forEach(a=>window.removeEventListener(a,n));};e.forEach(a=>window.addEventListener(a,n,{once:true,passive:true}));}function E(e){A=!!e;}function _(){return A}function N(e){y=Math.max(0,e),m&&(m.gain.value=y);}function D(){return y}function S(e,n){let a=e.createBuffer(1,Math.max(1,Math.floor(e.sampleRate*n)),e.sampleRate),u=a.getChannelData(0);for(let c=0;c<u.length;c++)u[c]=Math.random()*2-1;return a}function O(e,n,a,u,c){let t={...l,...u},o=a+t.at;if(t.noise>0){let i=e.createBufferSource();i.buffer=c;let r=e.createBiquadFilter();r.type="bandpass",r.frequency.value=t.freq,r.Q.value=t.q;let s=e.createGain();s.gain.setValueAtTime(0,o),s.gain.linearRampToValueAtTime(t.gain*t.noise,o+w),s.gain.exponentialRampToValueAtTime(v,o+t.decay),i.connect(r).connect(s).connect(n),i.start(o),i.stop(o+t.decay+.02);}if(t.tail>0){let i=e.createOscillator();i.type="sine",i.frequency.value=t.freq;let r=e.createGain();r.gain.setValueAtTime(0,o),r.gain.linearRampToValueAtTime(t.gain*t.tail,o+w),r.gain.exponentialRampToValueAtTime(v,o+t.decay*1.25),i.connect(r).connect(n),i.start(o),i.stop(o+t.decay*1.5+.02);}if(t.bright>0){let i=e.createOscillator();i.type="sine",i.frequency.value=t.freq*t.partial;let r=e.createGain();r.gain.setValueAtTime(0,o),r.gain.linearRampToValueAtTime(t.gain*.3*t.bright,o+w*.75),r.gain.exponentialRampToValueAtTime(v,o+.004),i.connect(r).connect(n),i.start(o),i.stop(o+.02);}}function R(e){let n=0;for(let a of e.ticks??[]){let u={...l,...a};n=Math.max(n,u.at+u.decay*1.5+.03);}return n||.05}function q(e,n={}){if(!g||A||typeof document<"u"&&document.hidden)return;let a=V(e);if(!a.ticks?.length)return;let u=h();u.state==="suspended"&&u.resume();let{volume:c=1,rate:t=1,humanize:o=0,when:i=0}=n,r=u.createGain();r.gain.value=(a.volume??.9)*c,r.connect(m);let s=u.currentTime+Math.max(0,i)+.005,d=b=>1+(Math.random()*2-1)*b;for(let b of a.ticks){let f={...b};t!==1&&(f.freq=(f.freq??l.freq)*t,f.at=(f.at??0)/t,f.decay=(f.decay??l.decay)/t),o>0&&(f.freq=(f.freq??l.freq)*d(.03*o),f.gain=(f.gain??l.gain)*d(.12*o)),O(u,r,s,f,T);}let I=R(a)/t;setTimeout(()=>{try{r.disconnect();}catch{}},(I+.1)*1e3);}function F(e,n){return ()=>q(e,n)}async function U(e,n={}){let{sampleRate:a=44100,tail:u=.02}=n,c=V(e),t=R(c)+u,o=typeof window<"u"?window.OfflineAudioContext||window.webkitOfflineAudioContext:null;if(!o)throw new Error("sonics: OfflineAudioContext not available");let i=new o(1,Math.ceil(a*t),a),r=S(i,.03),s=i.createGain();s.gain.value=c.volume??.9,s.connect(i.destination);for(let d of c.ticks)O(i,s,.001,d,r);return i.startRendering()}async function G(e,n){return W(await U(e,n))}function W(e){let n=e.getChannelData(0),a=e.sampleRate,u=n.length,c=new ArrayBuffer(44+u*2),t=new DataView(c),o=(r,s)=>{for(let d=0;d<s.length;d++)t.setUint8(r+d,s.charCodeAt(d));};o(0,"RIFF"),t.setUint32(4,36+u*2,true),o(8,"WAVE"),o(12,"fmt "),t.setUint32(16,16,true),t.setUint16(20,1,true),t.setUint16(22,1,true),t.setUint32(24,a,true),t.setUint32(28,a*2,true),t.setUint16(32,2,true),t.setUint16(34,16,true),o(36,"data"),t.setUint32(40,u*2,true);let i=44;for(let r=0;r<u;r++){let s=Math.max(-1,Math.min(1,n[r]));t.setInt16(i,s<0?s*32768:s*32767,true),i+=2;}return new Blob([c],{type:"audio/wav"})}function L(e){let n=JSON.stringify(e);return btoa(unescape(encodeURIComponent(n))).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,"")}function M(e){let n=e.replace(/-/g,"+").replace(/_/g,"/"),a=decodeURIComponent(escape(atob(n)));return JSON.parse(a)}var x={click:{volume:.9,ticks:[{at:0,gain:.5,freq:3120,q:7,decay:.0032},{at:.0276,gain:.66,freq:3120,q:7,decay:.0032}]},tap:{volume:.8,ticks:[{at:0,gain:.55,freq:2600,q:6,decay:.004,bright:.4}]},tick:{volume:.7,ticks:[{at:0,gain:.4,freq:4200,q:9,decay:.0018,tail:.3,bright:.7}]},pop:{volume:.9,ticks:[{at:0,gain:.6,freq:1400,q:5,decay:.006,bright:.25,tail:.8}]},toggleOn:{volume:.85,ticks:[{at:0,gain:.45,freq:2600,q:7,decay:.003},{at:.03,gain:.6,freq:3500,q:7,decay:.0035}]},toggleOff:{volume:.85,ticks:[{at:0,gain:.55,freq:3200,q:7,decay:.003},{at:.03,gain:.45,freq:2300,q:7,decay:.0035}]},success:{volume:.85,ticks:[{at:0,gain:.5,freq:2637,q:8,decay:.006,tail:.9,noise:.3},{at:.09,gain:.55,freq:3520,q:8,decay:.008,tail:.9,noise:.3}]},error:{volume:.85,ticks:[{at:0,gain:.55,freq:320,q:4,decay:.02,tail:.9,noise:.2,bright:.05},{at:.12,gain:.55,freq:300,q:4,decay:.02,tail:.9,noise:.2,bright:.05}]}};function V(e){if(typeof e=="string"){if(e in x)return x[e];try{return M(e)}catch{throw new Error(`sonics: unknown preset or bad encoded string "${e}"`)}}return e}var j=Object.assign((e,n)=>q(e,n),{play:q,sound:F,presets:x,render:U,toWav:G,encode:L,decode:M,context:h,unlock:C,armAutoUnlock:P,isSupported:B,setMuted:E,isMuted:_,setVolume:N,getVolume:D,DEFAULT_TICK:l}),K=j;/*!
+ * sonics — tiny, dependency-free UI sounds you can feel.
+ *
+ * Synthesises pleasant microinteraction sounds at runtime with the Web Audio
+ * API. No audio files, no dependencies. Every sound is a plain, serialisable
+ * spec object, so you can design one, encode it to a string, share it, and
+ * replay it anywhere.
+ *
+ * The physical model (per "tick"): a short burst of noise strikes a resonant
+ * body (a band-pass filter), which rings at `freq` and decays in `decay`
+ * seconds. Stack two ticks a few ms apart and you get the "press + release"
+ * of a mechanical switch — the thing that makes a click feel tactile.
+ *
+ * Reverse-engineered from the ElevenLabs onboarding click. See README.
+ * License: MIT.
+ */export{l as DEFAULT_TICK,P as armAutoUnlock,h as context,M as decode,K as default,L as encode,D as getVolume,_ as isMuted,B as isSupported,q as play,x as presets,U as render,E as setMuted,N as setVolume,F as sound,G as toWav,C as unlock};

package/dist/react/index.d.mts

@@ -0,0 +1,53 @@
+import * as react from 'react';
+import { ElementType, ReactNode } from 'react';
+import { SoundInput, PlayOptions } from '../../index.js';
+export { default as sonics } from '../../index.js';
+
+interface SonicsControls {
+    enabled: boolean;
+    setEnabled: (v: boolean) => void;
+    toggle: () => void;
+    volume: number;
+    setVolume: (v: number) => void;
+    play: (sound: SoundInput, opts?: PlayOptions) => void;
+}
+interface SonicsProviderProps {
+    children?: ReactNode;
+    /** Initial enabled state. Defaults to true unless the OS prefers reduced motion. */
+    defaultEnabled?: boolean;
+    /** Initial volume, 0..1. Default 1. */
+    defaultVolume?: number;
+}
+/**
+ * Optional provider. Gives descendants a shared enabled/volume state that
+ * persists to localStorage, defaults to off when the OS prefers reduced
+ * motion, and arms audio auto-unlock on the first gesture.
+ */
+declare function SonicsProvider({ children, defaultEnabled, defaultVolume }: SonicsProviderProps): react.FunctionComponentElement<react.ProviderProps<SonicsControls | null>>;
+/** Access the provider's controls. Falls back to a provider-less shim that
+ *  always plays, so it's safe to call without a <SonicsProvider>. */
+declare function useSonics(): SonicsControls;
+/**
+ * The main hook. Returns a stable trigger you can drop onto any handler.
+ *
+ *   const click = useSound("click");
+ *   <button onClick={click}>Save</button>
+ */
+declare function useSound(sound: SoundInput, opts?: PlayOptions): (overrideOpts?: PlayOptions) => void;
+interface SonicsButtonProps {
+    sound?: SoundInput;
+    soundOpts?: PlayOptions;
+    /** Which event fires the sound. Default "click". */
+    on?: "click" | "pointerdown" | "hover";
+    /** Element or component to render. Default "button". */
+    as?: ElementType;
+    onClick?: (e: unknown) => void;
+    onPointerDown?: (e: unknown) => void;
+    onPointerEnter?: (e: unknown) => void;
+    children?: ReactNode;
+    [prop: string]: unknown;
+}
+/** Drop-in button that plays a sound on click / pointerdown / hover. */
+declare function SonicsButton({ sound, soundOpts, on, as, onClick, onPointerDown, onPointerEnter, children, ...rest }: SonicsButtonProps): react.ReactElement<any, string | react.JSXElementConstructor<any>>;
+
+export { SonicsButton, type SonicsButtonProps, type SonicsControls, SonicsProvider, type SonicsProviderProps, useSonics as default, useSonics, useSound };

package/dist/react/index.d.ts

@@ -0,0 +1,53 @@
+import * as react from 'react';
+import { ElementType, ReactNode } from 'react';
+import { SoundInput, PlayOptions } from '../../index.js';
+export { default as sonics } from '../../index.js';
+
+interface SonicsControls {
+    enabled: boolean;
+    setEnabled: (v: boolean) => void;
+    toggle: () => void;
+    volume: number;
+    setVolume: (v: number) => void;
+    play: (sound: SoundInput, opts?: PlayOptions) => void;
+}
+interface SonicsProviderProps {
+    children?: ReactNode;
+    /** Initial enabled state. Defaults to true unless the OS prefers reduced motion. */
+    defaultEnabled?: boolean;
+    /** Initial volume, 0..1. Default 1. */
+    defaultVolume?: number;
+}
+/**
+ * Optional provider. Gives descendants a shared enabled/volume state that
+ * persists to localStorage, defaults to off when the OS prefers reduced
+ * motion, and arms audio auto-unlock on the first gesture.
+ */
+declare function SonicsProvider({ children, defaultEnabled, defaultVolume }: SonicsProviderProps): react.FunctionComponentElement<react.ProviderProps<SonicsControls | null>>;
+/** Access the provider's controls. Falls back to a provider-less shim that
+ *  always plays, so it's safe to call without a <SonicsProvider>. */
+declare function useSonics(): SonicsControls;
+/**
+ * The main hook. Returns a stable trigger you can drop onto any handler.
+ *
+ *   const click = useSound("click");
+ *   <button onClick={click}>Save</button>
+ */
+declare function useSound(sound: SoundInput, opts?: PlayOptions): (overrideOpts?: PlayOptions) => void;
+interface SonicsButtonProps {
+    sound?: SoundInput;
+    soundOpts?: PlayOptions;
+    /** Which event fires the sound. Default "click". */
+    on?: "click" | "pointerdown" | "hover";
+    /** Element or component to render. Default "button". */
+    as?: ElementType;
+    onClick?: (e: unknown) => void;
+    onPointerDown?: (e: unknown) => void;
+    onPointerEnter?: (e: unknown) => void;
+    children?: ReactNode;
+    [prop: string]: unknown;
+}
+/** Drop-in button that plays a sound on click / pointerdown / hover. */
+declare function SonicsButton({ sound, soundOpts, on, as, onClick, onPointerDown, onPointerEnter, children, ...rest }: SonicsButtonProps): react.ReactElement<any, string | react.JSXElementConstructor<any>>;
+
+export { SonicsButton, type SonicsButtonProps, type SonicsControls, SonicsProvider, type SonicsProviderProps, useSonics as default, useSonics, useSound };

package/dist/react/index.js

@@ -0,0 +1,4 @@
+'use strict';Object.defineProperty(exports,'__esModule',{value:true});var react=require('react'),index_js=require('../index.js');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var index_js__default=/*#__PURE__*/_interopDefault(index_js);var y=react.createContext(null),b="sonics:prefs";function h(){try{return JSON.parse(localStorage.getItem(b)||"{}")}catch{return {}}}function M({children:n,defaultEnabled:r,defaultVolume:e=1}){let s=react.useMemo(()=>typeof window<"u"?h():{},[]),l=typeof window<"u"&&window.matchMedia?window.matchMedia("(prefers-reduced-motion: reduce)").matches:false,[o,u]=react.useState(s.enabled??r??!l),[i,a]=react.useState(s.volume??e);react.useEffect(()=>{index_js.armAutoUnlock();},[]),react.useEffect(()=>{index_js.setMuted(!o),index_js.setVolume(i);try{localStorage.setItem(b,JSON.stringify({enabled:o,volume:i}));}catch{}},[o,i]);let c=react.useMemo(()=>({enabled:o,setEnabled:u,toggle:()=>u(t=>!t),volume:i,setVolume:a,play:(t,w)=>{o&&index_js.play(t,w);}}),[o,i]);return react.createElement(y.Provider,{value:c},n)}function v(){let n=react.useContext(y);return n||{enabled:true,setEnabled:()=>{},toggle:()=>{},volume:1,setVolume:()=>{},play:(r,e)=>index_js.play(r,e)}}function I(n,r){let{play:e}=v(),s=react.useRef({sound:n,opts:r});return s.current={sound:n,opts:r},react.useCallback(l=>{let{sound:o,opts:u}=s.current;e(o,l?{...u,...l}:u);},[e])}function B({sound:n="click",soundOpts:r,on:e="click",as:s="button",onClick:l,onPointerDown:o,onPointerEnter:u,children:i,...a}){let c=I(n,r);return react.createElement(s,{...a,onClick:t=>{e==="click"&&c(),l?.(t);},onPointerDown:t=>{e==="pointerdown"&&c(),o?.(t);},onPointerEnter:t=>{e==="hover"&&c(),u?.(t);}},i)}var T=v;/*!
+ * sonics/react — tiny React bindings for sonics. React is a peer dependency.
+ * License: MIT.
+ */Object.defineProperty(exports,"sonics",{enumerable:true,get:function(){return index_js__default.default}});exports.SonicsButton=B;exports.SonicsProvider=M;exports.default=T;exports.useSonics=v;exports.useSound=I;

package/dist/react/index.mjs

@@ -0,0 +1,4 @@
+import {createContext,useMemo,useState,useEffect,createElement,useContext,useRef,useCallback}from'react';import {armAutoUnlock,setMuted,setVolume,play}from'../index.js';export{default as sonics}from'../index.js';var y=createContext(null),b="sonics:prefs";function h(){try{return JSON.parse(localStorage.getItem(b)||"{}")}catch{return {}}}function M({children:n,defaultEnabled:r,defaultVolume:e=1}){let s=useMemo(()=>typeof window<"u"?h():{},[]),l=typeof window<"u"&&window.matchMedia?window.matchMedia("(prefers-reduced-motion: reduce)").matches:false,[o,u]=useState(s.enabled??r??!l),[i,a]=useState(s.volume??e);useEffect(()=>{armAutoUnlock();},[]),useEffect(()=>{setMuted(!o),setVolume(i);try{localStorage.setItem(b,JSON.stringify({enabled:o,volume:i}));}catch{}},[o,i]);let c=useMemo(()=>({enabled:o,setEnabled:u,toggle:()=>u(t=>!t),volume:i,setVolume:a,play:(t,w)=>{o&&play(t,w);}}),[o,i]);return createElement(y.Provider,{value:c},n)}function v(){let n=useContext(y);return n||{enabled:true,setEnabled:()=>{},toggle:()=>{},volume:1,setVolume:()=>{},play:(r,e)=>play(r,e)}}function I(n,r){let{play:e}=v(),s=useRef({sound:n,opts:r});return s.current={sound:n,opts:r},useCallback(l=>{let{sound:o,opts:u}=s.current;e(o,l?{...u,...l}:u);},[e])}function B({sound:n="click",soundOpts:r,on:e="click",as:s="button",onClick:l,onPointerDown:o,onPointerEnter:u,children:i,...a}){let c=I(n,r);return createElement(s,{...a,onClick:t=>{e==="click"&&c(),l?.(t);},onPointerDown:t=>{e==="pointerdown"&&c(),o?.(t);},onPointerEnter:t=>{e==="hover"&&c(),u?.(t);}},i)}var T=v;/*!
+ * sonics/react — tiny React bindings for sonics. React is a peer dependency.
+ * License: MIT.
+ */export{B as SonicsButton,M as SonicsProvider,T as default,v as useSonics,I as useSound};

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "sonics",
+  "version": "0.0.0",
+  "description": "Tiny, dependency-free UI sounds you can feel. Synthesised in the browser with the Web Audio API — no audio files.",
+  "author": "Philip Poloczek",
+  "license": "MIT",
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.mjs",
+      "require": "./dist/react/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "web-audio",
+    "sound",
+    "ui",
+    "microinteraction",
+    "click",
+    "sound-effects",
+    "synthesis",
+    "haptics",
+    "react",
+    "zero-dependency"
+  ],
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "react": "^18.3.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/peetzweg/sonics.git",
+    "directory": "packages/sonics"
+  },
+  "homepage": "https://peetzweg.github.io/sonics/",
+  "bugs": "https://github.com/peetzweg/sonics/issues",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}