zsk-use-sound 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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,215 @@
+# zsk-use-sound
+
+A TypeScript-first React hook for sound effects, inspired by the excellent `use-sound` package and extended with a browser-generated fallback mode.
+
+## Why this package
+
+This hook gives you one API for two sound strategies:
+
+- File mode: Use audio files (mp3, wav, etc.) powered by Howler.
+- Generated mode: If no file is provided, it generates a click-like sound in the browser using the Web Audio API.
+
+This is useful when you want sound feedback but do not always want to bundle and manage sound assets.
+
+## Installation
+
+```bash
+bun add zsk-use-sound
+```
+
+or
+
+```bash
+npm install zsk-use-sound
+```
+
+Peer dependency:
+
+- React 18+
+
+## Quick Start
+
+```tsx
+import { useSound } from 'zsk-use-sound'
+
+export function SaveButton() {
+  const [play] = useSound({
+    file: '/sounds/click.mp3',
+    volume: 0.5,
+  })
+
+  return <button onClick={() => play()}>Save</button>
+}
+```
+
+## API
+
+### useSound(options?)
+
+Returns a tuple:
+
+- play: function to trigger sound playback
+- exposedData: helper controls and runtime metadata
+
+```ts
+const [play, exposedData] = useSound(options)
+```
+
+### Options
+
+```ts
+type BuiltInSoundType = 'click' | 'soft-click' | 'tick'
+
+interface UseSoundOptions {
+  file?: string | string[]
+  type?: BuiltInSoundType
+  id?: string
+  volume?: number
+  playbackRate?: number
+  interrupt?: boolean
+  soundEnabled?: boolean
+  sprite?: Record<string, [number, number]>
+  onload?: (this: Howl) => void
+
+  // Plus delegated Howler options
+}
+```
+
+Behavior:
+
+- If file is passed: hook runs in file mode using Howler.
+- If file is omitted: hook runs in generated mode and uses built-in Web Audio click profiles.
+- Default type is click.
+
+### play(options?)
+
+```ts
+interface PlayOptions {
+  id?: string
+  forceSoundEnabled?: boolean
+  playbackRate?: number
+}
+```
+
+### Exposed data
+
+```ts
+interface ExposedData {
+  sound: Howl | null
+  stop: (id?: number) => void
+  pause: (id?: number) => void
+  duration: number | null
+  mode: 'file' | 'generated'
+}
+```
+
+## Usage Patterns
+
+### 1) File mode (use-sound style)
+
+```tsx
+import { useSound } from 'zsk-use-sound'
+
+export function NotificationButton() {
+  const [play, { stop, mode }] = useSound({
+    file: ['/sounds/ping.wav', '/sounds/ping.mp3'],
+    volume: 0.4,
+    interrupt: true,
+  })
+
+  return (
+    <>
+      <button onClick={() => play()}>Play</button>
+      <button onClick={() => stop()}>Stop</button>
+      <small>mode: {mode}</small>
+    </>
+  )
+}
+```
+
+### 2) Generated mode (no file)
+
+```tsx
+import { useSound } from 'zsk-use-sound'
+
+export function UIInteractions() {
+  const [play, { mode }] = useSound({
+    type: 'soft-click',
+    volume: 0.6,
+  })
+
+  return <button onClick={() => play()}>Click me ({mode})</button>
+}
+```
+
+### 3) Global sound toggle
+
+```tsx
+import { useSound } from 'zsk-use-sound'
+
+export function MutedAwareAction({ isEnabled }: { isEnabled: boolean }) {
+  const [play] = useSound({
+    file: '/sounds/action.mp3',
+    soundEnabled: isEnabled,
+  })
+
+  return <button onClick={() => play()}>Action</button>
+}
+```
+
+## Why Howler
+
+Howler is used for file playback mode because it offers:
+
+- Cross-browser audio consistency: normalizes browser differences.
+- Flexible source handling: supports source arrays and format fallback.
+- Sprite support: multiple sounds in one file with IDs.
+- Stable playback controls: volume, rate, stop, pause, and event hooks.
+- Mature ecosystem: widely used and battle-tested.
+
+In short, Howler handles the hard edges of browser audio so your hook API stays simple.
+
+## How this package is better for this use case
+
+Compared to a direct baseline implementation, this package adds:
+
+- Dual-mode behavior: file-based audio plus generated fallback in one hook.
+- No-any TypeScript API: explicit options and return types.
+- Better type surface for consumers: exported public types directly from the package.
+- Built-in sound presets: click, soft-click, tick.
+- Runtime mode visibility: exposedData.mode tells you how playback is happening.
+
+## Credit
+
+This package is inspired by:
+
+- Josh Comeau's original use-sound project: https://github.com/joshwcomeau/use-sound
+
+Many API ideas (tuple return shape, play options, exposed control object, and Howler-based file mode approach) are adapted from that excellent work.
+
+Thank you to Josh Comeau for creating and sharing the original library.
+
+## TypeScript Exports
+
+You can import runtime and type APIs directly:
+
+```ts
+import { useSound } from 'zsk-use-sound'
+import type {
+  BuiltInSoundType,
+  UseSoundOptions,
+  PlayOptions,
+  ExposedData,
+  ReturnedValue,
+} from 'zsk-use-sound'
+```
+
+## Notes
+
+- Generated mode relies on Web Audio API availability in the browser.
+- Browsers often require user interaction before sound can play.
+- For SSR environments, playback happens client-side only.
+
+## License
+
+ISC

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import type { Howl, HowlOptions } from 'howler';
+declare global {
+    interface Window {
+        webkitAudioContext?: typeof AudioContext;
+    }
+}
+export type BuiltInSoundType = 'click' | 'soft-click' | 'tick';
+export type SpriteMap = Record<string, [number, number]>;
+type DelegatedHowlOptions = Omit<HowlOptions, 'src' | 'volume' | 'rate' | 'onload' | 'sprite'>;
+export interface UseSoundOptions extends DelegatedHowlOptions {
+    file?: string | string[];
+    type?: BuiltInSoundType;
+    id?: string;
+    volume?: number;
+    playbackRate?: number;
+    interrupt?: boolean;
+    soundEnabled?: boolean;
+    sprite?: SpriteMap;
+    onload?: (this: Howl) => void;
+}
+export interface PlayOptions {
+    id?: string;
+    forceSoundEnabled?: boolean;
+    playbackRate?: number;
+}
+export type PlayFunction = (options?: PlayOptions) => void;
+export interface ExposedData {
+    sound: Howl | null;
+    stop: (id?: number) => void;
+    pause: (id?: number) => void;
+    duration: number | null;
+    mode: 'file' | 'generated';
+}
+export type ReturnedValue = [PlayFunction, ExposedData];
+export default function useSound({ file, type, id, volume, playbackRate, soundEnabled, interrupt, sprite, onload, ...delegated }?: UseSoundOptions): ReturnedValue;
+export { useSound };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AAG/C,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,kBAAkB,CAAC,EAAE,OAAO,YAAY,CAAA;KACzC;CACF;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,CAAA;AAE9D,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAExD,KAAK,oBAAoB,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAA;AAE9F,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IAC3D,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxB,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAA;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,EAAE,WAAW,KAAK,IAAI,CAAA;AAE1D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;CAC3B;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,YAAY,EAAE,WAAW,CAAC,CAAA;AAwCvD,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,EAC/B,IAAI,EACJ,IAAc,EACd,EAAE,EACF,MAAU,EACV,YAAgB,EAChB,YAAmB,EACnB,SAAiB,EACjB,MAAM,EACN,MAAM,EACN,GAAG,SAAS,EACb,GAAE,eAAoB,GAAG,aAAa,CA6NtC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA"}

package/dist/index.js

@@ -0,0 +1,201 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+const GENERATED_PROFILES = {
+    click: {
+        filterHz: 5000,
+        decaySeconds: 0.015,
+        gain: 0.6,
+        noiseSeconds: 0.02,
+    },
+    'soft-click': {
+        filterHz: 3200,
+        decaySeconds: 0.02,
+        gain: 0.35,
+        noiseSeconds: 0.018,
+    },
+    tick: {
+        filterHz: 6400,
+        decaySeconds: 0.01,
+        gain: 0.48,
+        noiseSeconds: 0.012,
+    },
+};
+const defaultProfile = GENERATED_PROFILES.click;
+function isBrowser() {
+    return typeof window !== 'undefined';
+}
+function toArray(src) {
+    return Array.isArray(src) ? src : [src];
+}
+export default function useSound({ file, type = 'click', id, volume = 1, playbackRate = 1, soundEnabled = true, interrupt = false, sprite, onload, ...delegated } = {}) {
+    const [sound, setSound] = useState(null);
+    const [duration, setDuration] = useState(null);
+    const isMountedRef = useRef(false);
+    const audioCtxRef = useRef(null);
+    const mode = file ? 'file' : 'generated';
+    const generatedProfile = useMemo(() => GENERATED_PROFILES[type] ?? defaultProfile, [type]);
+    const closeAudioContext = useCallback(() => {
+        if (audioCtxRef.current && audioCtxRef.current.state !== 'closed') {
+            void audioCtxRef.current.close();
+        }
+        audioCtxRef.current = null;
+    }, []);
+    const playGenerated = useCallback(() => {
+        if (!isBrowser() || !soundEnabled) {
+            return;
+        }
+        const AudioContextClass = window.AudioContext ?? window.webkitAudioContext;
+        if (!AudioContextClass) {
+            return;
+        }
+        if (!audioCtxRef.current) {
+            audioCtxRef.current = new AudioContextClass();
+        }
+        const ctx = audioCtxRef.current;
+        if (ctx.state === 'suspended') {
+            void ctx.resume();
+        }
+        const bufferSize = Math.max(1, Math.floor(ctx.sampleRate * generatedProfile.noiseSeconds));
+        const buffer = ctx.createBuffer(1, bufferSize, ctx.sampleRate);
+        const data = buffer.getChannelData(0);
+        for (let i = 0; i < bufferSize; i += 1) {
+            data[i] = Math.random() * 2 - 1;
+        }
+        const now = ctx.currentTime;
+        const noise = ctx.createBufferSource();
+        const filter = ctx.createBiquadFilter();
+        const gainNode = ctx.createGain();
+        noise.buffer = buffer;
+        filter.type = 'bandpass';
+        filter.frequency.value = generatedProfile.filterHz;
+        gainNode.gain.setValueAtTime(generatedProfile.gain * volume, now);
+        gainNode.gain.exponentialRampToValueAtTime(0.01, now + generatedProfile.decaySeconds);
+        noise.connect(filter);
+        filter.connect(gainNode);
+        gainNode.connect(ctx.destination);
+        noise.start(now);
+    }, [generatedProfile, soundEnabled, volume]);
+    useEffect(() => {
+        if (!file || !isBrowser()) {
+            setSound(null);
+            setDuration(null);
+            return;
+        }
+        let cancelled = false;
+        isMountedRef.current = true;
+        const initialize = async () => {
+            const mod = await import('howler');
+            if (cancelled || !isMountedRef.current) {
+                return;
+            }
+            const nextSound = new mod.Howl({
+                src: toArray(file),
+                volume,
+                rate: playbackRate,
+                sprite,
+                onload: function onLoad() {
+                    if (typeof onload === 'function') {
+                        onload.call(this);
+                    }
+                    if (!cancelled && isMountedRef.current) {
+                        setDuration(this.duration() * 1000);
+                        setSound(this);
+                    }
+                },
+                ...delegated,
+            });
+            if (!cancelled && isMountedRef.current) {
+                setSound(nextSound);
+            }
+        };
+        void initialize();
+        return () => {
+            cancelled = true;
+            isMountedRef.current = false;
+            setDuration(null);
+            setSound((current) => {
+                current?.unload();
+                return null;
+            });
+        };
+    }, [file, onload, playbackRate, sprite, volume, delegated]);
+    useEffect(() => {
+        if (!file) {
+            return;
+        }
+        if (sound) {
+            sound.volume(volume);
+            if (!sprite) {
+                sound.rate(playbackRate);
+            }
+        }
+    }, [file, sound, volume, playbackRate, sprite]);
+    useEffect(() => {
+        if (file || !soundEnabled || !isBrowser()) {
+            return;
+        }
+        const onMouseDown = () => {
+            playGenerated();
+        };
+        document.addEventListener('mousedown', onMouseDown);
+        return () => {
+            document.removeEventListener('mousedown', onMouseDown);
+        };
+    }, [file, playGenerated, soundEnabled]);
+    useEffect(() => {
+        if (file) {
+            return;
+        }
+        return () => {
+            closeAudioContext();
+        };
+    }, [closeAudioContext, file]);
+    const play = useCallback((options) => {
+        const currentOptions = options ?? {};
+        if (mode === 'generated') {
+            if (!soundEnabled && !currentOptions.forceSoundEnabled) {
+                return;
+            }
+            playGenerated();
+            return;
+        }
+        if (!sound || (!soundEnabled && !currentOptions.forceSoundEnabled)) {
+            return;
+        }
+        if (interrupt) {
+            sound.stop();
+        }
+        if (typeof currentOptions.playbackRate === 'number') {
+            sound.rate(currentOptions.playbackRate);
+        }
+        sound.play(currentOptions.id ?? id);
+    }, [id, interrupt, mode, playGenerated, sound, soundEnabled]);
+    const stop = useCallback((playId) => {
+        if (mode === 'generated') {
+            closeAudioContext();
+            return;
+        }
+        if (sound) {
+            sound.stop(playId);
+        }
+    }, [closeAudioContext, mode, sound]);
+    const pause = useCallback((playId) => {
+        if (mode === 'generated') {
+            return;
+        }
+        if (sound) {
+            sound.pause(playId);
+        }
+    }, [mode, sound]);
+    return [
+        play,
+        {
+            sound,
+            stop,
+            pause,
+            duration,
+            mode,
+        },
+    ];
+}
+export { useSound };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "zsk-use-sound",
+  "version": "1.0.0",
+  "description": "",
+  "keywords": [
+    "npm-package",
+    "react",
+    "sounds",
+    "typescript"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sk-izsk/zsk-react-error.git"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "bunx tsc -p tsconfig.json",
+    "lint": "oxlint . --config .oxlintrc.json",
+    "lint:fix": "oxlint . --fix --config .oxlintrc.json",
+    "format": "oxfmt . --config .oxfmtrc.json --write",
+    "format:check": "oxfmt . --config .oxfmtrc.json --check",
+    "typecheck": "bunx tsc --noEmit",
+    "clean": "rm -rf dist",
+    "verify": "bun run format && bun run lint && bun run typecheck && bun run clean && bun run build && npm pack --dry-run",
+    "prepublishOnly": "bun run verify",
+    "publish:release": "bun publish",
+    "release": "bun run verify && bun publish"
+  },
+  "dependencies": {
+    "howler": "^2.2.4"
+  },
+  "devDependencies": {
+    "@types/howler": "^2.2.12",
+    "@types/node": "^25.6.0",
+    "@types/react": "^19.2.14",
+    "oxfmt": "^0.44.0",
+    "oxlint": "^1.59.0",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "typescript": "^6.0.2"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "packageManager": "bun@1.2.5"
+}