audiobits 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # audiobits
 
+## 0.1.2
+
+### Patch Changes
+
+- 7f792f9: Clarify npm installation and the minimal confirmation-sound quick start in the shipped README and Skill, with nearby browser gesture and lifecycle guidance.
+
 ## 0.1.1
 
 ### Patch Changes

package/README.md

@@ -7,14 +7,15 @@ Prerelease verification target: current Chromium. Other browsers and operating
 systems are unverified and deliberately deferred. Maintainer listening acceptance for the
 unchanged sound definitions is recorded separately.
 
-## Install
+## Quick start
 
 ```sh
 npm install audiobits
 ```
 
-Use a browser bundler and call `play()` directly from a gesture handler. Surface rejection
-with `void play().catch(showError)` and retry from a fresh gesture.
+Use a browser bundler. Create the engine and sound once; run the final two lines
+inside a user gesture handler, such as a button click. Call `audio.start()`
+directly in that handler and await it before playback.
 
 ```ts
 import { createAudio } from "audiobits";
@@ -22,19 +23,15 @@ import { confirmation } from "audiobits/recipes";
 
 const audio = createAudio();
 const sound = audio.sound(confirmation);
-export async function play() {
-  await audio.start();
-  sound.play();
-}
-export function stop() {
-  audio.stopAll({ tails: "cut" });
-}
-export async function dispose() {
-  await audio.dispose();
-}
+
+await audio.start();
+sound.play();
 ```
 
-Bind `play()` to a button click (`void play().catch(showError)`).
+Surface activation failures and retry from a fresh gesture. Use
+`audio.stopAll({ tails: "cut" })` to stop playback and `await audio.dispose()`
+when the host is removed. See the production lifecycle example below for
+hiding and navigation.
 
 ## Production lifecycle
 

package/dist/capabilities.json

@@ -1,5 +1,5 @@
 {
-  "packageVersion": "0.1.1",
+  "packageVersion": "0.1.2",
   "schemaVersion": 1,
   "status": "stable",
   "recipe": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "audiobits",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Procedural browser audio: versioned recipes, live controls, managed voices and buses.",
   "license": "MIT",
   "repository": {

package/skill/SKILL.md

@@ -11,7 +11,9 @@ package version and read `audiobits/capabilities.json` and
 shipped behavior, not registry availability. Prerelease verification target: current Chromium. Other browsers and operating
 systems are unverified and deliberately deferred.
 
-Use public imports from `audiobits` and `audiobits/recipes`. Create engines and
+Install with `npm install audiobits` and use a browser bundler. Follow the
+[package quick start](../README.md#quick-start) to play the bundled `confirmation`
+recipe with public imports from `audiobits` and `audiobits/recipes`. Create engines and
 sounds without browser activation, then invoke `start()` synchronously inside
 a user gesture and await it before `play()`. Surface failures and allow a fresh
 gesture retry. Never queue playback across Stop, hiding, or disposal.