webaudio-kit
Release notes

Release history.

Every public package release is tracked from the root changelog, with direct links to GitHub Releases and npm package pages.

Current stable release

Latest package set: 1.10.0

The current release publishes through npm Trusted Publishing, creates GitHub Release notes from this changelog, and includes package tarballs on the release page.

Read docsGitHub release v1.10.0
May 31, 2026

1.10.0

GitHub release v1.10.0

Added

  • Add the `SpectrumCanvas` `scale` prop with `"log"` and `"linear"` modes so frequency bars can spread across the audible range by default or read consecutive FFT bins when needed.
  • Add `latencyHint` and `sampleRate` props to `AudioProvider` for apps that need more control over browser `AudioContext` creation.
  • Add `FrequencySweepOptions.safety` with sustained-gain and duration caps for runtime sweep loudness guardrails.
  • Expose math helpers from `@webaudio-kit/react/server` so React Server Components can use frequency and gain helpers without crossing the client boundary.
  • Add docs search, sitemap, expanded `llms.txt`, a library comparison page, and runnable CodeSandbox/Replit links alongside the existing StackBlitz examples.
  • Add release quality gates for coverage thresholds and bundle-size budgets.

Fixed

  • Rebuild the provider runtime when a cached `AudioContext` has already closed.
  • Scale analyser canvas backing buffers to `devicePixelRatio`, pause animation loops while the page is hidden, and respect `prefers-reduced-motion`.
  • Cache generated noise buffers per `AudioContext` instead of rebuilding the same noise buffer on every matching play call.
  • Restore persisted `useVolumeControl()` gain before first paint, surface storage write failures, and cancel pending `useAudioTestMode()` waits when stopped.
  • Catch `audioContext.close()` cleanup rejections during provider unmount.
  • Keep the public API docs, docs search index, and site API reference aligned for the new `SpectrumCanvasProps.scale` option.
@webaudio-kit/core 1.10.0@webaudio-kit/react 1.10.0@webaudio-kit/cli 1.10.0
May 26, 2026

1.9.9

GitHub release v1.9.9

Added

  • Add `useAudioEngine()` for provider-scoped `playTone`, `playNoise`, `playFrequencySweep`, and `withAudioRuntime` helpers in advanced React playback flows.
  • Register engine-created handles with provider `stopAll()` and clean up timed handles after their scheduled playback duration.
  • Document provider-scoped playback in the root README, React README, API reference, and Hooks vs Core guide.
@webaudio-kit/core 1.9.9@webaudio-kit/react 1.9.9@webaudio-kit/cli 1.9.9
May 26, 2026

1.9.5

GitHub release v1.9.5

Changed

  • Lower the documented Node support floor from `>=22.13` to `>=20.19` and add CI coverage for the Node 20 floor across quality, build, audit, and benchmark workflows.
  • Pin the workspace package manager to `pnpm@10.33.4`, the latest pnpm line that supports Node 20 without engine warnings.
  • Move `@webaudio-kit/core` to an explicit peer dependency of `@webaudio-kit/react`, while keeping it as a workspace dev dependency for package builds.
  • Document why React apps should install both packages together to avoid duplicate-core version confusion.
@webaudio-kit/core 1.9.5@webaudio-kit/react 1.9.5@webaudio-kit/cli 1.9.5
May 26, 2026

1.9.3

GitHub release v1.9.3

Added

  • Add a complete Monitoring Alert Cues recipe with severity profiles, transition triggered playback, repeat patterns, mute behavior, and `stopAll()` acknowledgement controls.
  • Add a matching live recipe demo so warning and critical profiles can be tried from the public recipes page.

Changed

  • Clarify that monitoring cue recipes are product UI feedback, not certified alarms, life-safety systems, medical software, or audiology workflows.
@webaudio-kit/core 1.9.3@webaudio-kit/react 1.9.3@webaudio-kit/cli 1.9.3
May 26, 2026

1.9.0

GitHub release v1.9.0

Added

  • Add `stopAll()` to `useAudioContext()` for provider-level panic controls that stop every active or scheduled React hook playback handle.
  • Track playback created by `useTone`, `useFrequencySweep`, `useNoise`, and `useAudioTestMode` so global cancellation clears hook state and timers.

Changed

  • Document the difference between lowering master gain with `useVolume()` and cancelling already scheduled playback with `stopAll()`.
@webaudio-kit/core 1.9.0@webaudio-kit/react 1.9.0@webaudio-kit/cli 1.9.0
May 26, 2026

1.8.0

GitHub release v1.8.0

Added

  • Add oscillator `detuneCents` and bounded `voices` support for richer tone and sweep cues.
  • Add optional `filter` routing for tones, sweeps, and noise bursts with lowpass defaults, frequency clamping, and Q control.
  • Add React type re-exports for `PlaybackFilter` and `PlaybackVoices`.

Changed

  • Share requested gain across multi-voice playback so layered tones do not get louder by default.
  • Document warning/error/success cue shaping with filters, detune, voices, and envelopes.
@webaudio-kit/core 1.8.0@webaudio-kit/react 1.8.0@webaudio-kit/cli 1.8.0
May 26, 2026

1.7.0

GitHub release v1.7.0

Added

  • Add `envelope: { attackMs, decayMs, sustain, releaseMs }` support for tones, frequency sweeps, and noise bursts.
  • Add gain envelope scheduling for finite playback and release fades for manual stops.
  • Add React type exports for `PlaybackEnvelope` so hook options can be shared across app code.

Changed

  • Document envelope usage in the root README, package READMEs, API reference, recipes, and public website docs.
@webaudio-kit/core 1.7.0@webaudio-kit/react 1.7.0@webaudio-kit/cli 1.7.0
May 26, 2026

1.6.0

GitHub release v1.6.0

Added

  • Add repeat pattern playback to tones, frequency sweeps, and noise bursts with `pattern: { repeat, gapMs }`.
  • Add composite playback handles that stop the full scheduled pattern, including future voices.
  • Allow `useTone()`, `useFrequencySweep()`, and `useNoise()` to be created without construction-time defaults when each `play()` call supplies options.

Changed

  • Keep React `isPlaying` active for the full repeated cue duration.
  • Document alert-cue pattern usage across README, package READMEs, Markdown docs, and the website API reference.
@webaudio-kit/core 1.6.0@webaudio-kit/react 1.6.0@webaudio-kit/cli 1.6.0
May 26, 2026

1.5.10

GitHub release v1.5.10

Added

  • Add one-click StackBlitz links for runnable Vite React, Next App Router, audio test mode, and incident alert console examples.
  • Add a `/new` starter route that redirects to the recommended Vite React browser playground.
  • Add `examples/incident-alert-console`, a product-style monitoring dashboard that uses tone, sweep, noise, volume, audio state, waveform, and spectrum surfaces together.

Changed

  • Expand example docs and README coverage so users can launch browser examples before installing or cloning the repository.
  • Extend example and site QA coverage for runnable browser example links.
@webaudio-kit/core 1.5.10@webaudio-kit/react 1.5.10@webaudio-kit/cli 1.5.10
May 26, 2026

1.5.9

GitHub release v1.5.9

Added

  • Add public telemetry-free benchmark documentation for `pnpm bench`, benchmark coverage, local result interpretation, and browser/device limits.
  • Add a public `/docs/benchmarks` page linked from the docs guide and README.
  • Add tests that keep benchmark docs linked and explicit about no telemetry, analytics, or tracking.

Changed

  • Extend site browser QA coverage to include the benchmark docs route and metadata.
@webaudio-kit/core 1.5.9@webaudio-kit/react 1.5.9@webaudio-kit/cli 1.5.9
May 26, 2026

1.5.8

GitHub release v1.5.8

Added

  • Add centralized route metadata with canonical URLs, Open Graph fields, and Twitter summary-card fields across the site.
  • Add generated social preview image endpoints for shared links.
  • Add metadata tests covering key route titles, descriptions, social fields, and non-medical wording.

Changed

  • Extend site browser QA to verify built page title, description, Open Graph, Twitter card, and social image tags.
@webaudio-kit/core 1.5.8@webaudio-kit/react 1.5.8@webaudio-kit/cli 1.5.8
May 26, 2026

1.5.6

GitHub release v1.5.6

Added

  • Add npm-facing framework install snippets for Vite React, Next App Router, and plain React in `@webaudio-kit/react`.
  • Add a browser gesture setup example to `@webaudio-kit/core` that covers tone, sweep, and pitch helper usage.
  • Add package-manager invocation snippets for the agent brief CLI.

Changed

  • Expand package README coverage so npm pages stay concise but copy-paste ready.
@webaudio-kit/core 1.5.6@webaudio-kit/react 1.5.6@webaudio-kit/cli 1.5.6
May 26, 2026

1.5.5

GitHub release v1.5.5

Added

  • Add focused live demo pages for visualizer-only usage, bounded master volume, stereo pan checks, pitch helper playback, and combined tone/noise workflows.
  • Add site QA coverage for representative focused demo routes.

Changed

  • Link focused demo pages from the docs and API reference where the related React hooks, canvases, and core helpers are documented.
@webaudio-kit/core 1.5.5@webaudio-kit/react 1.5.5@webaudio-kit/cli 1.5.5
May 26, 2026

1.5.3

GitHub release v1.5.3

Added

  • Add standalone example apps for Vite React, Next App Router, plain React, and audio test mode, with package-tarball checks before release.
  • Add public example and recipe documentation for tone buttons, sweeps, master volume, visualizers, audio test mode, and safe browser autoplay behavior.

Changed

  • Link examples and recipes from the public docs, API reference, and focused demo pages, with desktop and mobile site QA coverage for the new routes.
  • Point every package README at the public API reference, recipes, examples, demos, changelog, GitHub Releases, and npm package pages.
  • Expand generated GitHub Release notes with direct API, recipe, example, and demo links.
@webaudio-kit/core 1.5.3@webaudio-kit/react 1.5.3@webaudio-kit/cli 1.5.3
May 25, 2026

1.5.2

GitHub release v1.5.2

Changed

  • Publish releases through npm Trusted Publishing and remove token publishing from the normal release path.
  • Generate GitHub Release notes from `CHANGELOG.md` during tag publishes and upload package tarballs to the release page.
  • Add release-history links to every package README so npm package pages point users to the full changelog and GitHub Releases.
  • Include synchronized `CHANGELOG.md` files in each package tarball.
@webaudio-kit/core 1.5.2@webaudio-kit/react 1.5.2@webaudio-kit/cli 1.5.2
May 25, 2026

1.5.0

GitHub release v1.5.0

Added

  • `useAudioTestMode()` and `createDefaultAudioTestModeSteps()` in `@webaudio-kit/react` for safe low-gain browser audio diagnostics.
  • Test mode panels in the Vite demo and public site demo.
  • Standalone `examples/audio-test-mode` Vite example.

Changed

  • Package smoke checks now verify the audio test mode React exports.
  • Standalone example checks now build the new audio test mode example from packed package tarballs.
@webaudio-kit/core 1.5.0@webaudio-kit/react 1.5.0@webaudio-kit/cli 1.5.0
May 25, 2026

1.4.0

GitHub release v1.4.0

Added

  • `@webaudio-kit/cli` with `webaudio-kit agent-brief` for generating an `AGENTS.md` style brief for Codex, Claude Code, Gemini CLI, OpenCode, Antigravity, and similar coding agents.
  • Agent brief documentation covering package links, docs links, safe browser audio guidance, framework notes, and generated prompt content.

Changed

  • Release tag verification, npm publish ordering, and package smoke checks now include the CLI package and validate the generated command output from a packed tarball.
  • Public docs and launch material now list the CLI alongside the core and React packages.
@webaudio-kit/core 1.4.0@webaudio-kit/react 1.4.0@webaudio-kit/cli 1.4.0
May 24, 2026

1.3.0

GitHub release v1.3.0

Added

  • `playNoise()` in `@webaudio-kit/core` for short white, pink, and brown noise buffers routed through gain, pan, and destination nodes.
  • `useNoise()` in `@webaudio-kit/react` with stable `play`, `stop`, and `isPlaying` controls.
  • Pitch helper utilities: `midiToFrequency()`, `frequencyToMidi()`, and `frequencyToNoteName()`.

Changed

  • Demo app, public site, docs, and standalone examples now include noise playback controls and note-name frequency readouts.
  • Package smoke checks now verify the new public exports.
@webaudio-kit/core 1.3.0@webaudio-kit/react 1.3.0@webaudio-kit/cli 1.3.0
May 24, 2026

1.2.0

GitHub release v1.2.0

Added

  • `SpectrumCanvas` in `@webaudio-kit/react` for reusable analyser frequency bar rendering with an idle state before playback starts.
  • Standalone Vite and Next example package checks that install generated tarballs before building.

Changed

  • Demo app, public site, docs, and examples now show both waveform and spectrum analyser views.
  • `@webaudio-kit/react` now preserves a package-level `"use client"` directive for Next.js App Router client boundaries.
  • React peer dependency now supports React 18.3 and newer.
  • CI and npm publish workflows now build standalone examples before accepting a package release.
@webaudio-kit/core 1.2.0@webaudio-kit/react 1.2.0@webaudio-kit/cli 1.2.0
May 24, 2026

1.1.0

GitHub release v1.1.0

Added

  • `WaveformCanvas` in `@webaudio-kit/react` for reusable analyser waveform rendering with an idle state before playback starts.
  • Package smoke coverage for the new `WaveformCanvas` public export.

Changed

  • Vite demo and public site now use the shared `WaveformCanvas` component instead of duplicating canvas drawing logic.
  • Public site navigation no longer includes a roadmap page.
@webaudio-kit/core 1.1.0@webaudio-kit/react 1.1.0@webaudio-kit/cli 1.1.0
May 24, 2026

1.0.0

GitHub release v1.0.0

Added

  • `@webaudio-kit/core` with tone playback, frequency sweep playback, and audio math helpers.
  • `@webaudio-kit/react` with `AudioProvider`, `useTone`, `useFrequencySweep`, `useVolume`, `useAnalyser`, and `useAudioContext`.
  • Vite demo with tone controls, sweep controls, analyser canvas, and safety disclaimer.
  • CI, package smoke checks, and browser demo QA scripts.
  • Broader unit coverage for core playback, React hooks, provider lifecycle, and the demo app.
  • Release, security, support, testing, conduct, issue template, and npm publish workflow documentation.
  • Full local release rehearsal command with browser demo QA.
  • Local npm publish dry-run command for generated tarballs.
  • `cms-lab`-style CI cache, Dependabot, CodeQL, PR template, strict tag verification, and ordered publish guardrails.
  • Latest dependency/tooling pins, including `pnpm@11.3.0`, `jsdom@29.1.1`, React `19.2.6`, and latest GitHub Action tag pins.
@webaudio-kit/core 1.0.0@webaudio-kit/react 1.0.0@webaudio-kit/cli 1.0.0