plonkjs 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,86 @@
-# Temporary Holding Version
+# plonk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Game music made in code.** A song is a few hundred bytes of data, instruments and patterns of notes, synthesized
+live with Web Audio. There are no audio files to download, the engine is about 2 kB brotli, and it works with any
+engine (or none).
+
+```ts
+import { Player, type Song } from "plonkjs";
+
+const theme: Song = {
+  bpm: 112,
+  swing: 0.15,
+  instruments: {
+    lead: { wave: "square", decay: 0.15, sustain: 0.3, volume: 0.25, echo: 0.3 },
+    bass: { wave: "triangle", octave: -1, volume: 0.4 },
+    kick: { wave: "sine", drop: 24, decay: 0.12, sustain: 0, volume: 0.6 },
+    hat: { wave: "noise", decay: 0.03, sustain: 0, volume: 0.12, filter: { cutoff: 9000 } },
+  },
+  sections: {
+    a: {
+      lead: "C5 . E5 G5 | . E5 C5 . | D5 . F5 A5 | G5 - - .",
+      bass: "C3 . . . | C3 . G2 . | D3 . . . | G2 . . .",
+      kick: "x . . . x . . .",
+      hat: ". . x . . . x .",
+    },
+  },
+  order: ["a", "a"],
+};
+
+const player = new Player();
+player.play(theme, { fade: 1 });
+player.tempo(1.2); // hurry up: moves are running out
+player.layer("hat", 0); // drop the hats
+player.stop(1); // fade out over a second
+```
+
+## Patterns
+
+Each step is a sixteenth note. Steps are separated by spaces:
+
+| Step | Means |
+| --- | --- |
+| `C4`, `Eb5`, `F#3` | a note (A4 = 440 Hz) |
+| `C4+E4+G4` | a chord |
+| `x`, `X` | a hit (for drums); `X` is accented |
+| `.` | silence |
+| `-` | hold the step before |
+| `\|` | ignored: mark bars however you like |
+
+A shorter pattern repeats to fill its section, so `"x . . ."` is a four-on-the-floor kick under a 16-step melody.
+
+## Instruments
+
+All fields are optional: `wave` (`sine`, `square`, `sawtooth`, `triangle` or `noise`), envelope (`attack`, `decay`,
+`sustain`, `release`), `volume`, `octave`, `detune` (a second oscillator, in cents, for a fatter sound), `filter`
+(`{ cutoff, q, sweep }`, a low-pass with an optional sweep at each note: squelchy basses), `drop` (pitch falls from
+this many semitones above: kicks and bloops), `vibrato` (cents) and `echo` (0-1, a tempo-synced echo).
+
+## With a game engine
+
+Pass the engine's audio context and a bus, so the music shares its volume and mute. With debuff:
+
+```ts
+const player = new Player({ context: audio.ctx, destination: audio.bus("music") });
+```
+
+## Sounding good
+
+- **Keys and degrees:** give a song a `key` ("A minor") and write `^1 ^3 ^5`; named chords (`Am7@3`) work too.
+- **Variation:** `!` accents, `_` ghost notes, `?` / `?30` chances (seeded), and tracks that take turns between
+  patterns, for fills.
+- **Space:** `reverb`, `echo` and `pan` per instrument; a master compressor and limiter so the mix never clips.
+- **Sound effects that belong to the music:** `player.sfx(instrument, { degree, quantize: "beat" })` plays in the
+  song's key, on its beat if you like.
+
+## Checking a mix without speakers
+
+`await mix(song)` (in a browser) renders the song offline and reports its loudness in LUFS (ITU-R BS.1770), peaks and
+clipping, spectrum balance, each track's level under the mix, and warnings in plain words ("hat: buried"). Aim for
+about -16 LUFS with no warnings, then let a person listen.
+
+## Seeing music without hearing it
+
+`notes(song, fromStep, toStep)` returns every note in a window as data (time, instrument, frequency, duration,
+velocity), and `player.played` lists the notes it has scheduled. Tests and agents can check a song, or that the right
+music is playing, without speakers.

package/dist/analyse.d.ts

@@ -0,0 +1,42 @@
+import type { Song } from "./song.js";
+/** Sample rate for rendering. BS.1770's K-weighting coefficients below are defined at 48 kHz. */
+export declare const RENDER_RATE = 48000;
+export interface Analysis {
+    /** Highest sample, in dBFS (0 = full scale). */
+    peakDb: number;
+    /** Samples at or beyond full scale. Anything above 0 means audible distortion. */
+    clipped: number;
+    /** Integrated loudness in LUFS (gated, K-weighted). Web games sit comfortably around -16. */
+    lufs: number;
+    /** Share of energy below 250 Hz, 250 Hz-4 kHz, and above 4 kHz (0-1 each, summing to 1). */
+    bands: {
+        low: number;
+        mid: number;
+        high: number;
+    };
+    /** Share of the time that's silence (below -60 dBFS). */
+    silence: number;
+}
+/** Integrated loudness (LUFS) of channels at `rate`: 400 ms blocks every 100 ms, absolute gate -70, relative -10. */
+export declare function loudness(channels: Float32Array[], rate?: number): number;
+/** Measure rendered audio: peak, clipping, loudness, spectrum balance and silence. */
+export declare function analyse(channels: Float32Array[], rate?: number): Analysis;
+/** Render `seconds` of a song offline (fast, silent) and return its channels. Only these instruments, if given. */
+export declare function render(song: Song, seconds: number, only?: string[]): Promise<Float32Array[]>;
+export interface MixReport {
+    /** The whole song. */
+    song: Analysis;
+    /** Each instrument on its own: its loudness, and how far it sits below the whole mix (LU). */
+    tracks: Record<string, {
+        lufs: number;
+        belowMix: number;
+    }>;
+    /** Plain-words problems worth fixing, empty if none. */
+    warnings: string[];
+}
+/**
+ * Render a song and each of its instruments, and say what's wrong with the mix, if anything: clipping, too loud or
+ * too quiet, a track buried under the rest, a muddy low end or harsh highs. For agents and tests that can't listen.
+ */
+export declare function mix(song: Song, seconds?: number): Promise<MixReport>;
+//# sourceMappingURL=analyse.d.ts.map

package/dist/analyse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyse.d.ts","sourceRoot":"","sources":["../src/analyse.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,iGAAiG;AACjG,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC,MAAM,WAAW,QAAQ;IACvB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAChB,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;CACjB;AA+CD,qHAAqH;AACrH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,IAAI,SAAc,GAAG,MAAM,CAoB7E;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,IAAI,SAAc,GAAG,QAAQ,CA+B9E;AAED,mHAAmH;AACnH,wBAAsB,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAiBlG;AAED,MAAM,WAAW,SAAS;IACxB,sBAAsB;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,SAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAkBtE"}

package/dist/analyse.js

@@ -0,0 +1,140 @@
+// Checking music without ears: render a song offline and measure it. Loudness follows ITU-R BS.1770 (LUFS, the
+// measure streaming services and broadcasters use), peaks and clipping are counted, and the spectrum is split into
+// lows, mids and highs. `analyse` is pure maths over samples, so it runs anywhere; `render` and `mix` need Web Audio's
+// OfflineAudioContext (a browser, or a Node implementation).
+import { Player } from "./player.js";
+/** Sample rate for rendering. BS.1770's K-weighting coefficients below are defined at 48 kHz. */
+export const RENDER_RATE = 48000;
+const db = (x) => (x > 0 ? 20 * Math.log10(x) : -Infinity);
+/** A biquad filter over a whole signal (direct form I). */
+function biquad(x, b0, b1, b2, a1, a2) {
+    const y = new Float32Array(x.length);
+    let x1 = 0, x2 = 0, y1 = 0, y2 = 0;
+    for (let i = 0; i < x.length; i++) {
+        const v = b0 * x[i] + b1 * x1 + b2 * x2 - a1 * y1 - a2 * y2;
+        x2 = x1;
+        x1 = x[i];
+        y2 = y1;
+        y1 = v;
+        y[i] = v;
+    }
+    return y;
+}
+/** BS.1770 K-weighting at 48 kHz: a high shelf (the head's effect), then a high-pass. */
+const kWeight = (x) => biquad(biquad(x, 1.53512485958697, -2.69169618940638, 1.19839281085285, -1.69065929318241, 0.73248077421585), 1, -2, 1, -1.99004745483398, 0.99007225036621);
+/** A Butterworth biquad (RBJ cookbook), low- or high-pass; applied twice it's a steep 4th-order split. */
+function butter(x, cutoff, rate, type) {
+    const w = (2 * Math.PI * cutoff) / rate, cos = Math.cos(w), alpha = Math.sin(w) / Math.SQRT2;
+    const a0 = 1 + alpha;
+    const b1 = (type === "low" ? 1 - cos : -(1 + cos)) / a0;
+    const b0 = (type === "low" ? (1 - cos) / 2 : (1 + cos) / 2) / a0;
+    const once = (v) => biquad(v, b0, b1, b0, (-2 * cos) / a0, (1 - alpha) / a0);
+    return once(once(x));
+}
+const energy = (x) => x.reduce((s, v) => s + v * v, 0);
+/** Integrated loudness (LUFS) of channels at `rate`: 400 ms blocks every 100 ms, absolute gate -70, relative -10. */
+export function loudness(channels, rate = RENDER_RATE) {
+    const weighted = channels.map(kWeight);
+    const block = Math.round(rate * 0.4), hop = Math.round(rate * 0.1);
+    const blocks = [];
+    for (let start = 0; start + block <= (weighted[0]?.length ?? 0); start += hop) {
+        let sum = 0;
+        for (const ch of weighted) {
+            let s = 0;
+            for (let i = start; i < start + block; i++)
+                s += ch[i] * ch[i];
+            sum += s / block;
+        }
+        blocks.push(sum);
+    }
+    const lufsOf = (ms) => -0.691 + 10 * Math.log10(ms);
+    const loud = blocks.filter((ms) => ms > 0 && lufsOf(ms) > -70);
+    if (!loud.length)
+        return -Infinity;
+    const relative = lufsOf(loud.reduce((a, b) => a + b, 0) / loud.length) - 10;
+    const gated = loud.filter((ms) => lufsOf(ms) > relative);
+    return lufsOf(gated.reduce((a, b) => a + b, 0) / gated.length);
+}
+/** Measure rendered audio: peak, clipping, loudness, spectrum balance and silence. */
+export function analyse(channels, rate = RENDER_RATE) {
+    let peak = 0, clipped = 0, quiet = 0;
+    const floor = 10 ** (-60 / 20);
+    const n = channels[0]?.length ?? 0;
+    for (let i = 0; i < n; i++) {
+        let loudest = 0;
+        for (const ch of channels) {
+            const v = Math.abs(ch[i]);
+            if (v >= 1)
+                clipped++;
+            loudest = Math.max(loudest, v);
+        }
+        peak = Math.max(peak, loudest);
+        if (loudest < floor)
+            quiet++;
+    }
+    // Mono sum for the spectrum split.
+    const mono = new Float32Array(n);
+    for (const ch of channels)
+        for (let i = 0; i < n; i++)
+            mono[i] += ch[i] / channels.length;
+    const total = energy(mono) || 1;
+    const low = energy(butter(mono, 250, rate, "low"));
+    const high = energy(butter(mono, 4000, rate, "high"));
+    const mid = Math.max(0, total - low - high);
+    const sum = low + mid + high || 1;
+    return {
+        peakDb: db(peak),
+        clipped,
+        lufs: loudness(channels, rate),
+        bands: { low: low / sum, mid: mid / sum, high: high / sum },
+        silence: n ? quiet / n : 1,
+    };
+}
+/** Render `seconds` of a song offline (fast, silent) and return its channels. Only these instruments, if given. */
+export async function render(song, seconds, only) {
+    const ctx = new OfflineAudioContext(2, Math.ceil(seconds * RENDER_RATE), RENDER_RATE);
+    const solo = only
+        ? {
+            ...song,
+            sections: Object.fromEntries(Object.entries(song.sections).map(([name, tracks]) => [
+                name,
+                Object.fromEntries(Object.entries(tracks).filter(([inst]) => only.includes(inst))),
+            ])),
+        }
+        : song;
+    const player = new Player({ context: ctx });
+    player.prerender(solo, seconds);
+    const buf = await ctx.startRendering();
+    return Array.from({ length: buf.numberOfChannels }, (_, c) => buf.getChannelData(c));
+}
+/**
+ * Render a song and each of its instruments, and say what's wrong with the mix, if anything: clipping, too loud or
+ * too quiet, a track buried under the rest, a muddy low end or harsh highs. For agents and tests that can't listen.
+ */
+export async function mix(song, seconds = 20) {
+    const whole = analyse(await render(song, seconds));
+    const tracks = {};
+    for (const inst of Object.keys(song.instruments)) {
+        const l = loudness(await render(song, seconds, [inst]));
+        tracks[inst] = { lufs: l, belowMix: whole.lufs - l };
+    }
+    const warnings = [];
+    if (whole.clipped > 0)
+        warnings.push(`clipping: ${whole.clipped} samples at full scale; lower the volumes`);
+    if (whole.lufs > -10)
+        warnings.push(`loud: ${whole.lufs.toFixed(1)} LUFS; aim for about -16 so sound effects sit on top`);
+    if (whole.lufs < -24)
+        warnings.push(`quiet: ${whole.lufs.toFixed(1)} LUFS; aim for about -16`);
+    for (const [inst, t] of Object.entries(tracks)) {
+        if (!Number.isFinite(t.lufs))
+            warnings.push(`${inst}: silent; does any section play it?`);
+        else if (t.belowMix > 20)
+            warnings.push(`${inst}: buried (${t.belowMix.toFixed(0)} LU under the mix); raise its volume`);
+    }
+    if (whole.bands.low > 0.7)
+        warnings.push(`muddy: ${Math.round(whole.bands.low * 100)}% of the energy is under 250 Hz`);
+    if (whole.bands.high > 0.25)
+        warnings.push(`harsh: ${Math.round(whole.bands.high * 100)}% of the energy is over 4 kHz`);
+    return { song: whole, tracks, warnings };
+}
+//# sourceMappingURL=analyse.js.map

package/dist/analyse.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { type Analysis, analyse, loudness, type MixReport, mix, RENDER_RATE, render } from "./analyse.js";
+export { Player, type PlayerOptions, type PlayOptions, type SfxOptions } from "./player.js";
+export { chord, degree, frequency, type Instrument, type NoteEvent, notes, parse, parseKey, SCALES, type Song, type Step, sectionSteps, songSteps, stepSeconds, type Track, } from "./song.js";
+//# 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":"AAOA,OAAO,EAAE,KAAK,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC1G,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,EACL,KAAK,EACL,MAAM,EACN,SAAS,EACT,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,EACL,KAAK,EACL,QAAQ,EACR,MAAM,EACN,KAAK,IAAI,EACT,KAAK,IAAI,EACT,YAAY,EACZ,SAAS,EACT,WAAW,EACX,KAAK,KAAK,GACX,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+// plonk: game music made in code. Songs are small pieces of data (instruments and patterns of notes), synthesized live
+// with Web Audio: no audio files to download, tiny, and easy to tweak or make react to the game.
+//
+//   import { Player, type Song } from "plonkjs";
+//   const player = new Player();
+//   player.play(theme);
+export { analyse, loudness, mix, RENDER_RATE, render } from "./analyse.js";
+export { Player } from "./player.js";
+export { chord, degree, frequency, notes, parse, parseKey, SCALES, sectionSteps, songSteps, stepSeconds, } from "./song.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uHAAuH;AACvH,iGAAiG;AACjG,EAAE;AACF,iDAAiD;AACjD,iCAAiC;AACjC,wBAAwB;AAExB,OAAO,EAAiB,OAAO,EAAE,QAAQ,EAAkB,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC1G,OAAO,EAAE,MAAM,EAAyD,MAAM,aAAa,CAAC;AAC5F,OAAO,EACL,KAAK,EACL,MAAM,EACN,SAAS,EAGT,KAAK,EACL,KAAK,EACL,QAAQ,EACR,MAAM,EAGN,YAAY,EACZ,SAAS,EACT,WAAW,GAEZ,MAAM,WAAW,CAAC"}

package/dist/player.d.ts

@@ -0,0 +1,89 @@
+import { type Instrument, type NoteEvent, type Song } from "./song.js";
+export interface PlayerOptions {
+    /** The audio context to use. Default: a new one. */
+    context?: AudioContext;
+    /** Where everything goes (a game's music bus, say). Default: the context's speakers. */
+    destination?: AudioNode;
+    /** Glue the mix with a compressor and stop it clipping with a limiter. Default true. */
+    master?: boolean;
+}
+export interface PlayOptions {
+    /** Fade in over this many seconds. */
+    fade?: number;
+    /** Start from this step (sixteenth notes) instead of the top. */
+    at?: number;
+}
+/** A one-shot sound effect from sfx(). */
+export interface SfxOptions {
+    /** Scale degree in the song's key (1 = the root, 8 = an octave up). The usual way to stay in tune with the music. */
+    degree?: number;
+    /** Octave for `degree` (default 4), or for nothing else. */
+    octave?: number;
+    /** Or a note name ("C5"), a chord name ("Am7@4"), or a frequency in Hz. */
+    note?: string;
+    freq?: number;
+    /** Wait for the next step, beat or bar of the music, so the sound lands in time. Default: play now. */
+    quantize?: "step" | "beat" | "bar";
+    /** Then wait this many steps more (sixteenth notes of the song, or of 120 bpm with none playing): for jingles. */
+    after?: number;
+    /** 0-1. Default 0.8. */
+    velocity?: number;
+    /** Seconds. Default: the instrument's attack plus decay. */
+    length?: number;
+}
+export declare class Player {
+    readonly context: AudioContext;
+    /** The music bus: play() fades it in, stop() fades it out. */
+    private readonly out;
+    private readonly master;
+    private readonly echoIn;
+    private readonly reverbIn;
+    private readonly delay;
+    private noiseBuffer;
+    private song;
+    /** Audio-clock time of step 0 of the current song, adjusted when the tempo changes. */
+    private origin;
+    /** Next step to schedule. */
+    private nextStep;
+    private timer;
+    private tempoScale;
+    private readonly layers;
+    /** Every note scheduled (music and sound effects), for tests and agents: the most recent 256. */
+    readonly played: NoteEvent[];
+    constructor(options?: PlayerOptions);
+    /** Is a song playing? */
+    get playing(): boolean;
+    /** Play a song from the top (or `at` a step), looping. Replaces whatever was playing. */
+    play(song: Song, options?: PlayOptions): void;
+    /**
+     * @internal For offline rendering (see `render`): schedule `seconds` of a song from time 0 in one go, since an
+     * offline context's clock doesn't run until it renders.
+     */
+    prerender(song: Song, seconds: number): void;
+    /** Stop, fading out over `fade` seconds (default: at once). */
+    stop(fade?: number): void;
+    /**
+     * Speed up or slow down (1 = the song's own bpm), without a jump: the next notes simply come sooner or later. For
+     * music that tightens as the moves run out, say.
+     */
+    tempo(scale: number): void;
+    /** Fade one instrument's track in or out (0-1) over `fade` seconds: layers that come and go with the game. */
+    layer(instrument: string, volume: number, fade?: number): void;
+    /**
+     * Play a one-shot sound effect with an instrument, in the music's key and, if asked, on its beat. A pop on scale
+     * degree 1, then 2, 3... for each step of a combo climbs the song's scale instead of clashing with it. Returns when
+     * (on the audio clock) it plays.
+     */
+    sfx(instrument: Instrument, options?: SfxOptions): number;
+    private layerGain;
+    private record;
+    /** Schedule every note due before the lookahead runs out. */
+    private schedule;
+    /** A seeded noise source, shared by every drum. */
+    private noise;
+    /** A reverb impulse: stereo noise fading out over `seconds`, seeded so the room sounds the same every time. */
+    private impulse;
+    /** Build and start one note, into `into`. */
+    private voice;
+}
+//# sourceMappingURL=player.d.ts.map

package/dist/player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../src/player.ts"],"names":[],"mappings":"AAOA,OAAO,EAA4B,KAAK,UAAU,EAAE,KAAK,SAAS,EAAS,KAAK,IAAI,EAAe,MAAM,WAAW,CAAC;AAErH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,wFAAwF;IACxF,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,wFAAwF;IACxF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,0CAA0C;AAC1C,MAAM,WAAW,UAAU;IACzB,qHAAqH;IACrH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uGAAuG;IACvG,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IACnC,kHAAkH;IAClH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD,qBAAa,MAAM;IACjB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAW;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,IAAI,CAAmB;IAC/B,uFAAuF;IACvF,OAAO,CAAC,MAAM,CAAK;IACnB,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,iGAAiG;IACjG,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAM;IAElC,YAAY,OAAO,GAAE,aAAkB,EAyCtC;IAED,yBAAyB;IACzB,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,yFAAyF;IACzF,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,WAAgB,GAAG,IAAI,CAgBhD;IAED;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAa3C;IAED,+DAA+D;IAC/D,IAAI,CAAC,IAAI,SAAI,GAAG,IAAI,CAWnB;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAQzB;IAED,8GAA8G;IAC9G,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,IAAI,CAM1D;IAED;;;;OAIG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,GAAE,UAAe,GAAG,MAAM,CAwB5D;IAED,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,MAAM;IAKd,6DAA6D;IAC7D,OAAO,CAAC,QAAQ;IAoBhB,mDAAmD;IACnD,OAAO,CAAC,KAAK;IASb,+GAA+G;IAC/G,OAAO,CAAC,OAAO;IAQf,6CAA6C;IAC7C,OAAO,CAAC,KAAK;CA+Ed"}

package/dist/player.js

@@ -0,0 +1,325 @@
+// Plays songs through Web Audio. Notes are scheduled a little ahead on the audio clock (not on frames), so timing
+// stays tight even when the game drops a frame or the tab is busy.
+//
+// The signal path: every voice -> its track's layer gain -> the music bus (faded by play/stop) -> the master bus.
+// Sound effects from sfx() skip the music bus, so they play even when the music is faded out. The echo and reverb
+// are shared sends. The master bus glues everything with a gentle compressor, then a limiter so it never clips.
+import { chord, degree, frequency, notes, stepSeconds } from "./song.js";
+const LOOKAHEAD = 0.15; // seconds of notes scheduled ahead
+const TICK_MS = 40; // how often the scheduler wakes up
+export class Player {
+    context;
+    /** The music bus: play() fades it in, stop() fades it out. */
+    out;
+    master;
+    echoIn;
+    reverbIn;
+    delay;
+    noiseBuffer;
+    song;
+    /** Audio-clock time of step 0 of the current song, adjusted when the tempo changes. */
+    origin = 0;
+    /** Next step to schedule. */
+    nextStep = 0;
+    timer;
+    tempoScale = 1;
+    layers = new Map();
+    /** Every note scheduled (music and sound effects), for tests and agents: the most recent 256. */
+    played = [];
+    constructor(options = {}) {
+        this.context = options.context ?? new AudioContext();
+        const ctx = this.context;
+        const destination = options.destination ?? ctx.destination;
+        // Master: a gentle compressor to glue the mix, then a limiter so it can't clip.
+        if (options.master === false)
+            this.master = destination;
+        else {
+            const glue = ctx.createDynamicsCompressor();
+            glue.threshold.value = -18;
+            glue.knee.value = 12;
+            glue.ratio.value = 3;
+            glue.attack.value = 0.01;
+            glue.release.value = 0.25;
+            const limit = ctx.createDynamicsCompressor();
+            limit.threshold.value = -2;
+            limit.knee.value = 0;
+            limit.ratio.value = 20;
+            limit.attack.value = 0.002;
+            limit.release.value = 0.1;
+            glue.connect(limit).connect(destination);
+            this.master = glue;
+        }
+        this.out = ctx.createGain();
+        this.out.connect(this.master);
+        // A soft echo, shared by every instrument that asks for one.
+        this.echoIn = ctx.createGain();
+        this.delay = ctx.createDelay(1);
+        const feedback = ctx.createGain(), echoWet = ctx.createGain();
+        feedback.gain.value = 0.35;
+        echoWet.gain.value = 0.5;
+        this.echoIn.connect(this.delay);
+        this.delay.connect(feedback).connect(this.delay);
+        this.delay.connect(echoWet).connect(this.master);
+        // A small room: a seeded, decaying noise impulse.
+        this.reverbIn = ctx.createGain();
+        const room = ctx.createConvolver();
+        room.buffer = this.impulse(1.6);
+        const roomWet = ctx.createGain();
+        roomWet.gain.value = 0.6;
+        this.reverbIn.connect(room).connect(roomWet).connect(this.master);
+    }
+    /** Is a song playing? */
+    get playing() {
+        return this.timer !== undefined;
+    }
+    /** Play a song from the top (or `at` a step), looping. Replaces whatever was playing. */
+    play(song, options = {}) {
+        this.stop();
+        void this.context.resume();
+        this.song = song;
+        this.tempoScale = 1;
+        // Echo in time with the music: a dotted eighth.
+        this.delay.delayTime.value = Math.min(1, stepSeconds(song.bpm) * 3);
+        const now = this.context.currentTime + 0.05;
+        this.nextStep = options.at ?? 0;
+        this.origin = now - this.nextStep * stepSeconds(song.bpm);
+        const g = this.out.gain;
+        g.cancelScheduledValues(now);
+        g.setValueAtTime(options.fade ? 0.0001 : 1, now);
+        if (options.fade)
+            g.exponentialRampToValueAtTime(1, now + options.fade);
+        this.timer = setInterval(() => this.schedule(), TICK_MS);
+        this.schedule();
+    }
+    /**
+     * @internal For offline rendering (see `render`): schedule `seconds` of a song from time 0 in one go, since an
+     * offline context's clock doesn't run until it renders.
+     */
+    prerender(song, seconds) {
+        this.song = song;
+        this.tempoScale = 1;
+        this.delay.delayTime.value = Math.min(1, stepSeconds(song.bpm) * 3);
+        this.origin = 0.01;
+        this.out.gain.setValueAtTime(1, 0);
+        const last = Math.ceil(seconds / stepSeconds(song.bpm)) + 1;
+        for (const n of notes(song, 0, last)) {
+            const instrument = song.instruments[n.instrument];
+            if (!instrument || n.time >= seconds)
+                continue;
+            this.voice(instrument, this.layerGain(n.instrument), n.freq, this.origin + n.time, n.duration, n.velocity);
+            this.record(n);
+        }
+    }
+    /** Stop, fading out over `fade` seconds (default: at once). */
+    stop(fade = 0) {
+        if (this.timer !== undefined)
+            clearInterval(this.timer);
+        this.timer = undefined;
+        const now = this.context.currentTime, g = this.out.gain;
+        g.cancelScheduledValues(now);
+        g.setValueAtTime(g.value || 0.0001, now);
+        if (fade > 0)
+            g.exponentialRampToValueAtTime(0.0001, now + fade);
+        else
+            g.setValueAtTime(0.0001, now);
+        for (const layer of this.layers.values())
+            layer.disconnect();
+        this.layers.clear();
+    }
+    /**
+     * Speed up or slow down (1 = the song's own bpm), without a jump: the next notes simply come sooner or later. For
+     * music that tightens as the moves run out, say.
+     */
+    tempo(scale) {
+        if (!this.song || scale <= 0)
+            return;
+        const now = this.context.currentTime;
+        const oldStep = stepSeconds(this.song.bpm) / this.tempoScale, newStep = stepSeconds(this.song.bpm) / scale;
+        const at = (now - this.origin) / oldStep; // where we are, in steps
+        this.origin = now - at * newStep;
+        this.tempoScale = scale;
+    }
+    /** Fade one instrument's track in or out (0-1) over `fade` seconds: layers that come and go with the game. */
+    layer(instrument, volume, fade = 0.5) {
+        const g = this.layerGain(instrument).gain, now = this.context.currentTime;
+        g.cancelScheduledValues(now);
+        g.setValueAtTime(Math.max(0.0001, g.value), now);
+        g.exponentialRampToValueAtTime(Math.max(0.0001, volume), now + Math.max(0.01, fade));
+    }
+    /**
+     * Play a one-shot sound effect with an instrument, in the music's key and, if asked, on its beat. A pop on scale
+     * degree 1, then 2, 3... for each step of a combo climbs the song's scale instead of clashing with it. Returns when
+     * (on the audio clock) it plays.
+     */
+    sfx(instrument, options = {}) {
+        const ctx = this.context, now = ctx.currentTime;
+        let when = now;
+        if (options.quantize && this.song && this.playing) {
+            const step = stepSeconds(this.song.bpm) / this.tempoScale;
+            const every = options.quantize === "bar" ? 16 : options.quantize === "beat" ? 4 : 1;
+            const at = (now - this.origin) / step;
+            when = this.origin + Math.ceil(at / every - 1e-6) * every * step;
+        }
+        if (options.after)
+            when += options.after * (stepSeconds(this.song?.bpm ?? 120) / this.tempoScale);
+        const shift = 2 ** ((this.song?.transpose ?? 0) / 12);
+        const freqs = options.freq !== undefined
+            ? [options.freq]
+            : options.note
+                ? (chord(options.note) ?? [frequency(options.note) ?? 440])
+                : [degree(this.song?.key, options.degree ?? 1, options.octave ?? 4) * shift];
+        const length = options.length ?? (instrument.attack ?? 0.005) + (instrument.decay ?? 0.1);
+        for (const freq of freqs) {
+            this.voice(instrument, this.master, freq, when, length, options.velocity ?? 0.8);
+            this.record({ time: when, instrument: "sfx", freq, duration: length, velocity: options.velocity ?? 0.8 });
+        }
+        return when;
+    }
+    layerGain(instrument) {
+        let g = this.layers.get(instrument);
+        if (!g) {
+            g = this.context.createGain();
+            g.connect(this.out);
+            this.layers.set(instrument, g);
+        }
+        return g;
+    }
+    record(n) {
+        this.played.push(n);
+        if (this.played.length > 256)
+            this.played.shift();
+    }
+    /** Schedule every note due before the lookahead runs out. */
+    schedule() {
+        const song = this.song;
+        if (!song)
+            return;
+        const step = stepSeconds(song.bpm) / this.tempoScale;
+        const until = this.context.currentTime + LOOKAHEAD;
+        const last = Math.floor((until - this.origin) / step) + 1;
+        if (last <= this.nextStep)
+            return;
+        // notes() works in the song's own time; rescale to the current tempo.
+        const scale = stepSeconds(song.bpm) / step;
+        for (const n of notes(song, this.nextStep, last)) {
+            const instrument = song.instruments[n.instrument];
+            if (!instrument)
+                continue;
+            const when = this.origin + n.time / scale;
+            if (when < this.context.currentTime - 0.01)
+                continue;
+            this.voice(instrument, this.layerGain(n.instrument), n.freq, when, n.duration / scale, n.velocity);
+            this.record(n);
+        }
+        this.nextStep = last;
+    }
+    /** A seeded noise source, shared by every drum. */
+    noise() {
+        if (!this.noiseBuffer) {
+            const len = this.context.sampleRate;
+            this.noiseBuffer = this.context.createBuffer(1, len, this.context.sampleRate);
+            fillNoise(this.noiseBuffer.getChannelData(0), 0x2545f491, () => 1);
+        }
+        return this.noiseBuffer;
+    }
+    /** A reverb impulse: stereo noise fading out over `seconds`, seeded so the room sounds the same every time. */
+    impulse(seconds) {
+        const rate = this.context.sampleRate, len = Math.max(1, Math.floor(rate * seconds));
+        const buf = this.context.createBuffer(2, len, rate);
+        for (let c = 0; c < 2; c++)
+            fillNoise(buf.getChannelData(c), 0x51ed270b + c, (i) => (1 - i / len) ** 3);
+        return buf;
+    }
+    /** Build and start one note, into `into`. */
+    voice(inst, into, freq, when, length, velocity) {
+        const ctx = this.context;
+        const attack = inst.attack ?? 0.005, decay = inst.decay ?? 0.1, sustain = inst.sustain ?? 0.6, release = inst.release ?? 0.08;
+        const peak = (inst.volume ?? 0.3) * velocity;
+        const end = when + Math.max(length, attack + decay);
+        const env = ctx.createGain();
+        env.gain.setValueAtTime(0.0001, when);
+        env.gain.linearRampToValueAtTime(peak, when + attack);
+        env.gain.exponentialRampToValueAtTime(Math.max(0.0001, peak * sustain), when + attack + decay);
+        env.gain.setValueAtTime(Math.max(0.0001, peak * sustain), end);
+        env.gain.exponentialRampToValueAtTime(0.0001, end + release);
+        let head = env;
+        if (inst.filter) {
+            const f = ctx.createBiquadFilter();
+            f.type = "lowpass";
+            f.Q.value = inst.filter.q ?? 1;
+            const base = inst.filter.cutoff;
+            if (inst.filter.sweep) {
+                f.frequency.setValueAtTime(base + inst.filter.sweep, when);
+                f.frequency.exponentialRampToValueAtTime(base, when + attack + decay);
+            }
+            else
+                f.frequency.value = base;
+            f.connect(env);
+            head = f;
+        }
+        let tail = env;
+        if (inst.pan) {
+            const p = ctx.createStereoPanner();
+            p.pan.value = Math.max(-1, Math.min(1, inst.pan));
+            env.connect(p);
+            tail = p;
+        }
+        tail.connect(into);
+        if (inst.echo) {
+            const send = ctx.createGain();
+            send.gain.value = inst.echo;
+            tail.connect(send).connect(this.echoIn);
+        }
+        if (inst.reverb) {
+            const send = ctx.createGain();
+            send.gain.value = inst.reverb;
+            tail.connect(send).connect(this.reverbIn);
+        }
+        const stopAt = end + release + 0.05;
+        if ((inst.wave ?? "square") === "noise") {
+            const src = ctx.createBufferSource();
+            src.buffer = this.noise();
+            src.connect(head);
+            src.start(when);
+            src.stop(stopAt);
+            return;
+        }
+        const pitch = freq * 2 ** (inst.octave ?? 0);
+        const oscs = [0, ...(inst.detune ? [inst.detune] : [])].map((cents) => {
+            const o = ctx.createOscillator();
+            o.type = (inst.wave ?? "square");
+            o.detune.value = cents;
+            if (inst.drop) {
+                o.frequency.setValueAtTime(pitch * 2 ** (inst.drop / 12), when);
+                o.frequency.exponentialRampToValueAtTime(Math.max(1, pitch), when + Math.min(0.12, attack + decay));
+            }
+            else
+                o.frequency.setValueAtTime(pitch, when);
+            o.connect(head);
+            o.start(when);
+            o.stop(stopAt);
+            return o;
+        });
+        if (inst.vibrato) {
+            const lfo = ctx.createOscillator(), depth = ctx.createGain();
+            lfo.frequency.value = 5.5;
+            depth.gain.value = inst.vibrato;
+            lfo.connect(depth);
+            for (const o of oscs)
+                depth.connect(o.detune);
+            lfo.start(when);
+            lfo.stop(stopAt);
+        }
+    }
+}
+/** Fill with seeded white noise (xorshift), shaped by `envelope(i)`. */
+function fillNoise(data, seed, envelope) {
+    let s = seed | 0;
+    for (let i = 0; i < data.length; i++) {
+        s ^= s << 13;
+        s ^= s >>> 17;
+        s ^= s << 5;
+        data[i] = (((s >>> 0) / 4294967296) * 2 - 1) * envelope(i);
+    }
+}
+//# sourceMappingURL=player.js.map

package/dist/player.js.map

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

package/dist/song.d.ts

@@ -0,0 +1,112 @@
+/** How an instrument sounds. Every field is optional; the defaults make a soft square lead. */
+export interface Instrument {
+    /** Oscillator shape, or "noise" for drums. */
+    wave?: "sine" | "square" | "sawtooth" | "triangle" | "noise";
+    /** Envelope, in seconds (sustain is a level, 0-1). */
+    attack?: number;
+    decay?: number;
+    sustain?: number;
+    release?: number;
+    /** Loudness, 0-1. */
+    volume?: number;
+    /** Shift every note by whole octaves. */
+    octave?: number;
+    /** A second oscillator this many cents apart, for a fatter, chorused sound. */
+    detune?: number;
+    /** A low-pass filter: cutoff in Hz, resonance (Q), and how far the cutoff sweeps up at each note's start. */
+    filter?: {
+        cutoff: number;
+        q?: number;
+        sweep?: number;
+    };
+    /** Pitch drops from this many semitones above to the note (kicks, "bloop"s). */
+    drop?: number;
+    /** Vibrato depth in cents, at 5.5 Hz. */
+    vibrato?: number;
+    /** How much goes to the echo, 0-1. */
+    echo?: number;
+    /** How much goes to the reverb, 0-1. */
+    reverb?: number;
+    /** Stereo position, -1 (left) to 1 (right). */
+    pan?: number;
+}
+/** A track in a section: one pattern, or several that take turns each time the section plays (for fills). */
+export type Track = string | string[];
+/** A song: instruments, and tracks of patterns in sections played in order. */
+export interface Song {
+    /** Beats per minute; each step in a pattern is a sixteenth note. */
+    bpm: number;
+    /** Delay every other step by this fraction of a step (0-0.5), for a bouncy, swung feel. */
+    swing?: number;
+    /** The key, for scale degrees (`^1`...) and in-key sound effects: "C major", "A minor", "D dorian"... */
+    key?: string;
+    /** Shift the whole song by this many semitones. */
+    transpose?: number;
+    instruments: Record<string, Instrument>;
+    /**
+     * Patterns per section, per instrument. A pattern is steps separated by spaces. See `parse` for what a step can be.
+     * A shorter pattern repeats to fill the section; a list of patterns takes turns, one per time the section plays.
+     */
+    sections: Record<string, Record<string, Track>>;
+    /** Section names in the order they play. The song loops back to the start. */
+    order: string[];
+}
+/** One note to play: when (seconds from the start), on what, how high (Hz, or 0 for a drum hit), for how long. */
+export interface NoteEvent {
+    time: number;
+    instrument: string;
+    freq: number;
+    duration: number;
+    /** 0-1: accents are louder, ghost notes quieter. */
+    velocity: number;
+}
+/** A note name ("A4", "C#5", "Eb3") as a frequency in Hz, or undefined if it isn't one. A4 is 440 Hz. */
+export declare function frequency(name: string): number | undefined;
+/** The scales `key` understands, as semitones above the root. */
+export declare const SCALES: Record<string, number[]>;
+/** A key ("C major", "F# minor pentatonic") as its root (semitones from A, in octave 4's C-to-B) and scale. */
+export declare function parseKey(key?: string): {
+    root: number;
+    scale: number[];
+};
+/**
+ * The frequency of scale degree `n` (1 = the root; 8 = the root an octave up; 0 and below go down) of `key`, in
+ * `octave` (4 by default, the octave of middle C). Sound effects use this to land in the song's key.
+ */
+export declare function degree(key: string | undefined, n: number, octave?: number): number;
+/** A chord name with an octave ("Am7@3", "Cmaj7@4", "G@3") as frequencies, or undefined. */
+export declare function chord(name: string): number[] | undefined;
+/** A step: what starts there (frequencies, or [0] for a hit), its velocity, chance to play, and length in steps. */
+export interface Step {
+    freqs: number[];
+    velocity: number;
+    /** 0-1: the step plays this often (seeded, so the same song always plays the same way). */
+    chance: number;
+    length: number;
+}
+/**
+ * Parse a pattern into steps; `null` where nothing starts (rests and held steps). Throws on anything unreadable.
+ *
+ * A step is one of:
+ * - a note: "C4", "Eb5", "F#3"
+ * - a chord: notes joined with "+" ("C4+E4+G4"), or a chord name with an octave ("Am7@3", "Cmaj7@4", "G@3")
+ * - a scale degree of the song's key: "^1" (the root), "^3", "^5@5" (in octave 5; octave 4 by default)
+ * - a hit, for drums: "x" ("X" is an accented hit)
+ * - "." silence, "-" hold the step before, "|" ignored (mark bars)
+ *
+ * Any note, chord or hit can end with "!" (accent), "_" (ghost: quiet), and "?" (plays half the time) or "?30" (30%).
+ */
+export declare function parse(pattern: string, key?: string): (Step | null)[];
+/** Seconds per step (a sixteenth note). */
+export declare const stepSeconds: (bpm: number) => number;
+/** How many steps a section lasts: its longest pattern. */
+export declare function sectionSteps(section: Record<string, Track>): number;
+/** Steps in one pass through the whole song. */
+export declare const songSteps: (song: Song) => number;
+/**
+ * Every note that starts in steps [from, to) of the song (counting from 0, looping through `order` forever), with
+ * times in seconds from step 0. The player calls this a little ahead of time; tests and agents can call it to see a
+ * song without hearing it.
+ */
+export declare function notes(song: Song, from: number, to: number): NoteEvent[];
+//# sourceMappingURL=song.d.ts.map

package/dist/song.d.ts.map

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

package/dist/song.js

@@ -0,0 +1,239 @@
+// Songs as data, and the pure part of playing them: parsing patterns and turning a song into timed note events. No
+// Web Audio here, so all of it runs (and is tested) anywhere.
+// ---- pitch ------------------------------------------------------------------------------------------------
+const NOTE = /^([A-Ga-g])(#|b)?(-?\d)$/;
+const SEMITONE = { c: -9, d: -7, e: -5, f: -4, g: -2, a: 0, b: 2 };
+const LETTER = /^([A-Ga-g])(#|b)?/;
+/** Semitones from A4 to a note name, or undefined. */
+function semitones(name) {
+    const m = NOTE.exec(name);
+    if (!m)
+        return undefined;
+    return SEMITONE[m[1].toLowerCase()] + (m[2] === "#" ? 1 : m[2] === "b" ? -1 : 0) + (Number(m[3]) - 4) * 12;
+}
+const hz = (fromA4) => 440 * 2 ** (fromA4 / 12);
+/** A note name ("A4", "C#5", "Eb3") as a frequency in Hz, or undefined if it isn't one. A4 is 440 Hz. */
+export function frequency(name) {
+    const s = semitones(name);
+    return s === undefined ? undefined : hz(s);
+}
+/** The scales `key` understands, as semitones above the root. */
+export const SCALES = {
+    major: [0, 2, 4, 5, 7, 9, 11],
+    minor: [0, 2, 3, 5, 7, 8, 10],
+    dorian: [0, 2, 3, 5, 7, 9, 10],
+    phrygian: [0, 1, 3, 5, 7, 8, 10],
+    lydian: [0, 2, 4, 6, 7, 9, 11],
+    mixolydian: [0, 2, 4, 5, 7, 9, 10],
+    pentatonic: [0, 2, 4, 7, 9],
+    "minor pentatonic": [0, 3, 5, 7, 10],
+    blues: [0, 3, 5, 6, 7, 10],
+};
+/** A key ("C major", "F# minor pentatonic") as its root (semitones from A, in octave 4's C-to-B) and scale. */
+export function parseKey(key = "C major") {
+    const [rootName = "C", ...rest] = key.trim().split(/\s+/);
+    const m = LETTER.exec(rootName);
+    const scale = SCALES[(rest.join(" ") || "major").toLowerCase()];
+    if (!m || !scale)
+        throw new Error(`plonk: "${key}" isn't a key (try "C major", "A minor" or "D dorian")`);
+    const root = SEMITONE[m[1].toLowerCase()] + (m[2] === "#" ? 1 : m[2] === "b" ? -1 : 0);
+    return { root, scale };
+}
+/**
+ * The frequency of scale degree `n` (1 = the root; 8 = the root an octave up; 0 and below go down) of `key`, in
+ * `octave` (4 by default, the octave of middle C). Sound effects use this to land in the song's key.
+ */
+export function degree(key, n, octave = 4) {
+    const { root, scale } = parseKey(key);
+    const i = n - 1;
+    const len = scale.length;
+    const oct = Math.floor(i / len);
+    const within = ((i % len) + len) % len;
+    return hz(root + scale[within] + (octave - 4 + oct) * 12);
+}
+const CHORDS = {
+    "": [0, 4, 7],
+    m: [0, 3, 7],
+    "7": [0, 4, 7, 10],
+    maj7: [0, 4, 7, 11],
+    m7: [0, 3, 7, 10],
+    dim: [0, 3, 6],
+    aug: [0, 4, 8],
+    sus2: [0, 2, 7],
+    sus4: [0, 5, 7],
+    "6": [0, 4, 7, 9],
+    m6: [0, 3, 7, 9],
+    add9: [0, 4, 7, 14],
+    "9": [0, 4, 7, 10, 14],
+};
+const CHORD = /^([A-G])(#|b)?(maj7|m7|m6|dim|aug|sus2|sus4|add9|m|7|6|9)?@(-?\d)$/;
+/** A chord name with an octave ("Am7@3", "Cmaj7@4", "G@3") as frequencies, or undefined. */
+export function chord(name) {
+    const m = CHORD.exec(name);
+    if (!m)
+        return undefined;
+    const root = SEMITONE[m[1].toLowerCase()] + (m[2] === "#" ? 1 : m[2] === "b" ? -1 : 0) + (Number(m[4]) - 4) * 12;
+    return CHORDS[m[3] ?? ""].map((s) => hz(root + s));
+}
+const MODS = /([!_]|\?\d*)+$/;
+/**
+ * Parse a pattern into steps; `null` where nothing starts (rests and held steps). Throws on anything unreadable.
+ *
+ * A step is one of:
+ * - a note: "C4", "Eb5", "F#3"
+ * - a chord: notes joined with "+" ("C4+E4+G4"), or a chord name with an octave ("Am7@3", "Cmaj7@4", "G@3")
+ * - a scale degree of the song's key: "^1" (the root), "^3", "^5@5" (in octave 5; octave 4 by default)
+ * - a hit, for drums: "x" ("X" is an accented hit)
+ * - "." silence, "-" hold the step before, "|" ignored (mark bars)
+ *
+ * Any note, chord or hit can end with "!" (accent), "_" (ghost: quiet), and "?" (plays half the time) or "?30" (30%).
+ */
+export function parse(pattern, key) {
+    const tokens = pattern.split(/\s+/).filter((t) => t && t !== "|");
+    const out = [];
+    let last;
+    for (const token of tokens) {
+        if (token === ".") {
+            out.push(null);
+            last = undefined;
+            continue;
+        }
+        if (token === "-") {
+            if (last)
+                last.length++;
+            out.push(null);
+            continue;
+        }
+        const mods = MODS.exec(token)?.[0] ?? "";
+        const body = mods ? token.slice(0, -mods.length) : token;
+        let velocity = 0.8;
+        let freqs;
+        if (body === "x" || body === "X") {
+            freqs = [0];
+            velocity = body === "X" ? 1 : 0.7;
+        }
+        else if (body.startsWith("^")) {
+            const [n, oct] = body.slice(1).split("@");
+            if (!n || Number.isNaN(Number(n)))
+                throw new Error(`plonk: "${token}" isn't a scale degree (try "^1", "^5" or "^3@5")`);
+            freqs = [degree(key, Number(n), oct === undefined ? 4 : Number(oct))];
+        }
+        else {
+            freqs =
+                chord(body) ??
+                    body.split("+").map((n) => {
+                        const f = frequency(n);
+                        if (f === undefined)
+                            throw new Error(`plonk: "${n}" isn't a note (try "C4", "Eb5", "F#3", "Am7@3" or "^3")`);
+                        return f;
+                    });
+        }
+        if (mods.includes("!"))
+            velocity = 1;
+        if (mods.includes("_"))
+            velocity = 0.4;
+        const q = /\?(\d*)/.exec(mods);
+        const chance = q ? (q[1] ? Number(q[1]) / 100 : 0.5) : 1;
+        last = { freqs, velocity, chance, length: 1 };
+        out.push(last);
+    }
+    return out;
+}
+// ---- timing -------------------------------------------------------------------------------------------------
+/** Seconds per step (a sixteenth note). */
+export const stepSeconds = (bpm) => 60 / bpm / 4;
+const variants = (track) => (Array.isArray(track) ? track : [track]);
+/** How many steps a section lasts: its longest pattern. */
+export function sectionSteps(section) {
+    let n = 0;
+    for (const t of Object.values(section))
+        for (const p of variants(t))
+            n = Math.max(n, parse(p).length);
+    return n;
+}
+/** Steps in one pass through the whole song. */
+export const songSteps = (song) => layout(song).total;
+/** A seeded number in [0, 1) for a step, so chances come out the same every time the song plays. */
+function seeded(...parts) {
+    let h = 0x9e3779b9;
+    for (const p of parts) {
+        h = Math.imul(h ^ (p | 0), 0x85ebca6b);
+        h ^= h >>> 13;
+    }
+    h = Math.imul(h ^ (h >>> 16), 0xc2b2ae35);
+    return ((h ^ (h >>> 16)) >>> 0) / 4294967296;
+}
+const hashName = (s) => [...s].reduce((h, c) => Math.imul(h ^ c.charCodeAt(0), 16777619), 2166136261);
+/**
+ * A song's parsed layout, worked out once per song object: the player asks for notes many times a second, and
+ * re-parsing every pattern each time adds up. (Songs are treated as unchanging once played; pass a new object to
+ * change one.)
+ */
+const layouts = new WeakMap();
+function layout(song) {
+    let l = layouts.get(song);
+    if (l)
+        return l;
+    const parsed = new Map();
+    const steps = (p) => {
+        let s = parsed.get(p);
+        if (!s) {
+            s = parse(p, song.key);
+            parsed.set(p, s);
+        }
+        return s;
+    };
+    const starts = [];
+    const perPass = new Map();
+    let at = 0;
+    for (const name of song.order) {
+        let len = 0;
+        for (const t of Object.values(song.sections[name] ?? {}))
+            for (const p of variants(t))
+                len = Math.max(len, steps(p).length);
+        const seen = perPass.get(name) ?? 0;
+        perPass.set(name, seen + 1);
+        starts.push({ name, at, len, seen });
+        at += len;
+    }
+    l = { total: at, starts, perPass, steps };
+    layouts.set(song, l);
+    return l;
+}
+/**
+ * Every note that starts in steps [from, to) of the song (counting from 0, looping through `order` forever), with
+ * times in seconds from step 0. The player calls this a little ahead of time; tests and agents can call it to see a
+ * song without hearing it.
+ */
+export function notes(song, from, to) {
+    const out = [];
+    const step = stepSeconds(song.bpm), swing = Math.max(0, Math.min(0.5, song.swing ?? 0)) * step;
+    const { total, starts, perPass, steps } = layout(song);
+    if (total === 0)
+        return out;
+    const shift = 2 ** ((song.transpose ?? 0) / 12);
+    for (let i = Math.max(0, Math.floor(from)); i < to; i++) {
+        const pass = Math.floor(i / total), within = i % total;
+        const sec = starts.find((s) => within >= s.at && within < s.at + s.len);
+        if (!sec)
+            continue;
+        // Which time this section is playing, counting from the very start: picks the variant.
+        const occurrence = pass * (perPass.get(sec.name) ?? 1) + sec.seen;
+        for (const [instrument, track] of Object.entries(song.sections[sec.name] ?? {})) {
+            const options = variants(track);
+            const ps = steps(options[occurrence % options.length]);
+            if (!ps.length)
+                continue;
+            const s = ps[(within - sec.at) % ps.length];
+            if (!s)
+                continue;
+            if (s.chance < 1 && seeded(pass, within, hashName(instrument)) >= s.chance)
+                continue;
+            const time = (pass * total + within) * step + (within % 2 === 1 ? swing : 0);
+            for (const freq of s.freqs)
+                out.push({ time, instrument, freq: freq * shift, duration: s.length * step, velocity: s.velocity });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=song.js.map

package/dist/song.js.map

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

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "plonkjs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Game music made in code: songs as tiny data, synthesized live with Web Audio. No audio files, a few kB, any engine",
+  "keywords": [
+    "game",
+    "gamedev",
+    "web-game",
+    "browser-game",
+    "html5-game",
+    "music",
+    "procedural-music",
+    "chiptune",
+    "synth",
+    "sequencer",
+    "web-audio",
+    "debuff"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/debuffjp/debuff/tree/main/packages/plonk#readme",
+  "bugs": "https://github.com/debuffjp/debuff/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/debuffjp/debuff.git",
+    "directory": "packages/plonk"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}