@real-music-packages/web-core 0.8.2 → 0.9.0

package/README.md

@@ -5,6 +5,8 @@ Shared, framework-agnostic music-theory primitives for the music-suite web apps
 no DOM, Tone.js, Svelte, or OSMD. Published publicly on npmjs.com.
 
 ## Modules
+
+### Core (default import `/`)
 - **notes** — `NOTE_NAMES`, `NOTE_NAMES_FLAT`, `noteNameToIndex(name)`, `pitchClass(midi)`, `midiToNoteName(midi, useFlats?)`
 - **frequency** — `midiToFrequency(midi)` (equal temperament, A4=440)
 - **enharmonic** — `KEYS_PREFER_FLATS`, `useFlatsForKeyName(key)`, `useFlatsForKeyFifths(fifths)` (bridges RET's key-name model and Stave's keyFifths model)
@@ -12,6 +14,28 @@ no DOM, Tone.js, Svelte, or OSMD. Published publicly on npmjs.com.
 - **intervals** — `INTERVALS`, `intervalBySemitones(n)`
 - **chords** — `CHORD_TEMPLATES` (quality → interval set, richer qualities first)
 
+### `./streak`
+localStorage-backed practice streak tracker — SSR-safe (silently no-ops when
+`localStorage` is absent). `createStreak(key, storage?)` returns a `StreakStore`
+with `get()`, `record(today?)`, and `live(today?)`. Injected fake storage makes
+unit tests straightforward. `todayKey()` returns today as `YYYY-MM-DD` in local
+time. Storage shape: `{current, longest, last}` — identical to RSR's existing key
+so migration is free.
+
+### `./server`
+Cloudflare D1 signup handler shared by RSR and RET. `handleSignup(request, db, appTag)`
+handles POST `{email, source?}` → inserts into the shared `signups` D1 table with
+`source = ${appTag}:${source}`. Returns 405/400/500/200 with `cache-control: no-store`.
+The `D1Like` interface lets you pass any compatible D1 binding or a test fake.
+
+### `./promo`
+Browser-only promo utilities (require Tone.js + opensheetmusicdisplay as optional
+peers; OSMD is only loaded via a dynamic import). Pure helpers (`parseMidi`,
+`midiDurationMs`) work in Node and are covered by unit tests.
+- **`parseMidi(buf)`** — minimal SMF parser: extracts note events with sustain-pedal extension and total duration.
+- **`renderNotation(xml, opts?)`** — renders a MusicXML string via OSMD to a detached canvas; returns per-staff measure boxes (RSR geometry), per-measure column union boxes (RMT geometry), system rows, and content bounds. Parameterisable via `RenderNotationOpts` (paper, inkSumThreshold, hostWidth, bars).
+- **`createPromoSampler(opts?)`** — creates a Tone.js Salamander sampler wired to a `MediaStreamDestination`. `keepAlive` option feeds a silent ConstantSource so the recorder never drops silent intro scenes (default false; RMT passes true).
+
 ## ⚠️ Octave-base gotcha (`scales.getMidiNote` / `getScaleDegree`)
 These are ported verbatim from RealEarTrainer and use **RET's non-standard octave
 base**: `getMidiNote(1, 'C', 4) === 48`, i.e. one octave below the General-MIDI

package/dist/audio.js

@@ -3,72 +3,13 @@ import {
   getMidiNote,
   midiToNoteName
 } from "./chunk-LLMDQM4C.js";
-
-// src/salamander.ts
-var SALAMANDER_CDN_BASE = "https://tonejs.github.io/audio/salamander/";
-var SALAMANDER_URLS_8 = {
-  C2: "C2.mp3",
-  "F#2": "Fs2.mp3",
-  C3: "C3.mp3",
-  "F#3": "Fs3.mp3",
-  C4: "C4.mp3",
-  "F#4": "Fs4.mp3",
-  C5: "C5.mp3",
-  "F#5": "Fs5.mp3"
-};
-var SALAMANDER_URLS_FULL = {
-  A0: "A0.mp3",
-  C1: "C1.mp3",
-  "D#1": "Ds1.mp3",
-  "F#1": "Fs1.mp3",
-  A1: "A1.mp3",
-  C2: "C2.mp3",
-  "D#2": "Ds2.mp3",
-  "F#2": "Fs2.mp3",
-  A2: "A2.mp3",
-  C3: "C3.mp3",
-  "D#3": "Ds3.mp3",
-  "F#3": "Fs3.mp3",
-  A3: "A3.mp3",
-  C4: "C4.mp3",
-  "D#4": "Ds4.mp3",
-  "F#4": "Fs4.mp3",
-  A4: "A4.mp3",
-  C5: "C5.mp3",
-  "D#5": "Ds5.mp3",
-  "F#5": "Fs5.mp3",
-  A5: "A5.mp3",
-  C6: "C6.mp3",
-  "D#6": "Ds6.mp3",
-  "F#6": "Fs6.mp3",
-  A6: "A6.mp3",
-  C7: "C7.mp3",
-  "D#7": "Ds7.mp3",
-  "F#7": "Fs7.mp3",
-  A7: "A7.mp3",
-  C8: "C8.mp3"
-};
-
-// src/audioHelpers.ts
-function createSalamanderSampler(Tone, opts) {
-  const sampler = new Tone.Sampler({
-    urls: opts.urls,
-    baseUrl: opts.baseUrl,
-    release: opts.release,
-    onload: opts.onload,
-    onerror: opts.onerror
-  }).toDestination();
-  if (opts.volumeDb !== void 0) sampler.volume.value = opts.volumeDb;
-  return sampler;
-}
-async function generateReverb(Tone, opts, timeoutMs) {
-  const reverb = new Tone.Reverb(opts);
-  const ok = await Promise.race([
-    reverb.generate().then(() => true),
-    new Promise((r) => setTimeout(() => r(false), timeoutMs))
-  ]);
-  return ok ? reverb : null;
-}
+import {
+  SALAMANDER_CDN_BASE,
+  SALAMANDER_URLS_8,
+  SALAMANDER_URLS_FULL,
+  createSalamanderSampler,
+  generateReverb
+} from "./chunk-BPL5LLQH.js";
 
 // src/engine.ts
 var browser = typeof window !== "undefined";

package/dist/audio.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/salamander.ts","../src/audioHelpers.ts","../src/engine.ts"],"sourcesContent":["export const SALAMANDER_CDN_BASE = 'https://tonejs.github.io/audio/salamander/';\n\n/** 8-anchor sample set (Stave uses these from the CDN). */\nexport const SALAMANDER_URLS_8: Record<string, string> = {\n  C2: 'C2.mp3', 'F#2': 'Fs2.mp3', C3: 'C3.mp3', 'F#3': 'Fs3.mp3',\n  C4: 'C4.mp3', 'F#4': 'Fs4.mp3', C5: 'C5.mp3', 'F#5': 'Fs5.mp3',\n};\n\n/** Full chromatic-anchor set A0..C8 (RET ships these locally under /audio/salamander/). */\nexport const SALAMANDER_URLS_FULL: Record<string, string> = {\n  A0: 'A0.mp3', C1: 'C1.mp3', 'D#1': 'Ds1.mp3', 'F#1': 'Fs1.mp3', A1: 'A1.mp3',\n  C2: 'C2.mp3', 'D#2': 'Ds2.mp3', 'F#2': 'Fs2.mp3', A2: 'A2.mp3',\n  C3: 'C3.mp3', 'D#3': 'Ds3.mp3', 'F#3': 'Fs3.mp3', A3: 'A3.mp3',\n  C4: 'C4.mp3', 'D#4': 'Ds4.mp3', 'F#4': 'Fs4.mp3', A4: 'A4.mp3',\n  C5: 'C5.mp3', 'D#5': 'Ds5.mp3', 'F#5': 'Fs5.mp3', A5: 'A5.mp3',\n  C6: 'C6.mp3', 'D#6': 'Ds6.mp3', 'F#6': 'Fs6.mp3', A6: 'A6.mp3',\n  C7: 'C7.mp3', 'D#7': 'Ds7.mp3', 'F#7': 'Fs7.mp3', A7: 'A7.mp3',\n  C8: 'C8.mp3',\n};\n","// Tone is provided by the consumer (peer dep); type loosely to avoid coupling.\ntype ToneModule = any; // eslint-disable-line @typescript-eslint/no-explicit-any\n\nexport interface SalamanderSamplerOpts {\n  urls: Record<string, string>;\n  baseUrl: string;\n  release: number;\n  volumeDb?: number;\n  onload?: () => void;\n  onerror?: (e: unknown) => void;\n}\n\n/** Create a Salamander Tone.Sampler routed to destination. Mirrors the exact\n *  `new Tone.Sampler({...}).toDestination()` both engines did inline. */\nexport function createSalamanderSampler(Tone: ToneModule, opts: SalamanderSamplerOpts) {\n  const sampler = new Tone.Sampler({\n    urls: opts.urls,\n    baseUrl: opts.baseUrl,\n    release: opts.release,\n    onload: opts.onload,\n    onerror: opts.onerror,\n  }).toDestination();\n  if (opts.volumeDb !== undefined) sampler.volume.value = opts.volumeDb;\n  return sampler;\n}\n\n/** Generate a Tone.Reverb, racing reverb.generate() against a timeout so it can\n *  never hang init on iOS. Returns the reverb if generated, else null. Caller\n *  wires routing (toDestination / reroute). Mirrors RET's addReverbInBackground. */\nexport async function generateReverb(\n  Tone: ToneModule,\n  opts: { decay: number; wet: number },\n  timeoutMs: number,\n): Promise<any | null> { // eslint-disable-line @typescript-eslint/no-explicit-any\n  const reverb = new Tone.Reverb(opts);\n  const ok = await Promise.race([\n    reverb.generate().then(() => true),\n    new Promise<boolean>((r) => setTimeout(() => r(false), timeoutMs)),\n  ]);\n  return ok ? reverb : null;\n}\n","import { getMidiNote } from './scales';\nimport { midiToNoteName } from './notes';\nimport { KEYS_PREFER_FLATS } from './enharmonic';\nimport { SALAMANDER_URLS_FULL } from './salamander';\nimport { createSalamanderSampler, generateReverb } from './audioHelpers';\n\n// SSR-safe browser guard (equivalent to SvelteKit's `browser` at runtime).\nconst browser = typeof window !== 'undefined';\n\n// Tone.js types (loaded dynamically)\ntype ToneSampler = {\n\ttriggerAttackRelease: (note: string, duration: number | string, time?: number, velocity?: number) => void;\n\ttoDestination: () => ToneSampler;\n\tvolume?: { value: number };\n};\ntype TonePolySynth = {\n\ttriggerAttackRelease: (notes: string[], duration: number | string, time?: number, velocity?: number) => void;\n\ttriggerAttack: (notes: string[], time?: number, velocity?: number) => void;\n\ttriggerRelease: (notes: string[], time?: number) => void;\n\treleaseAll?: (time?: number) => void;\n\ttoDestination: () => TonePolySynth;\n\tconnect: (node: unknown) => TonePolySynth;\n\tvolume: { value: number };\n};\n// Minimal audio-node shape we need to reroute the pad through reverb later.\ntype ToneNode = {\n\tconnect: (node: unknown) => unknown;\n\tdisconnect: () => void;\n\ttoDestination: () => unknown;\n};\n\n// Pre-warm the Tone import so that init() can call Tone.start()\n// synchronously inside a user-gesture handler (required by iOS Safari).\nconst tonePreload: Promise<typeof import('tone')> | null = browser\n\t? import('tone')\n\t: null;\n\nexport class AudioEngine {\n\tprivate piano: ToneSampler | null = null;\n\tprivate synthPiano: ToneSampler | null = null;\n\tprivate strings: TonePolySynth | null = null;\n\tprivate dronePad: TonePolySynth | null = null;\n\tprivate droneNotes: string[] = [];\n\t/** Piano voice level in dB; applied to whichever voice is active. */\n\tprivate pianoVolumeDb = 0;\n\tprivate isInitialized = false;\n\tprivate isLoading = false;\n\tprivate samplerUpgradeStarted = false;\n\tprivate reverbStarted = false;\n\tprivate padFilter: ToneNode | null = null;\n\tprivate Tone: typeof import('tone') | null = null;\n\t/** Which piano voice is currently sounding — for diagnostics. */\n\tvoice: 'none' | 'synth' | 'sampler' = 'none';\n\t/** Last init milestone reached — surfaced on-device to pinpoint stalls. */\n\tlastStage = 'idle';\n\t/**\n\t * Raw AudioContext we create + resume SYNCHRONOUSLY inside the first user\n\t * gesture. iOS Safari only unlocks audio when resume() is called directly\n\t * in the gesture task; awaiting the Tone import first (as init() must) loses\n\t * that activation, so Tone.start()'s resume() hangs with the context stuck\n\t * 'suspended'. We resume this context in the gesture, then hand it to Tone.\n\t */\n\tprivate rawCtx: AudioContext | null = null;\n\tprivate captureDest: MediaStreamAudioDestinationNode | null = null;\n\n\t/**\n\t * Initialize the audio engine (must be called from a user gesture handler).\n\t *\n\t * Strategy: graceful degradation. We bring up a synthesized piano voice\n\t * FIRST — it needs no downloads and decodes nothing, so it is ready\n\t * instantly and works on every browser including iOS Safari. Audio is\n\t * considered ready at that point. We THEN try to load the richer\n\t * Salamander samples in the background and swap them in if they finish.\n\t *\n\t * Why: Tone.Sampler's MP3 decode path hangs on iOS Safari (await\n\t * Tone.loaded() never resolves), which previously stalled init forever.\n\t * Loading samples off the critical path means iOS always gets working\n\t * sound (synth) and merely misses the upgrade, instead of getting silence.\n\t *\n\t * On iOS Safari, Tone.start() must run during the synchronous portion of\n\t * the gesture handler, which is why we pre-import the Tone module above.\n\t */\n\tasync init(): Promise<void> {\n\t\tif (!browser) return;\n\t\tif (this.isInitialized || this.isLoading) return;\n\t\tthis.isLoading = true;\n\t\tthis.lastStage = 'init-start';\n\n\t\ttry {\n\t\t\t// Resolve the pre-warmed Tone import (typically already done).\n\t\t\tthis.Tone = await tonePreload!;\n\t\t\tthis.lastStage = 'tone-imported';\n\n\t\t\t// Use the context we already resumed synchronously in the gesture\n\t\t\t// (see unlock()). Handing it to Tone before any node is created means\n\t\t\t// Tone runs on an already-'running' context, so start() can't hang.\n\t\t\tif (this.rawCtx) {\n\t\t\t\ttry {\n\t\t\t\t\tthis.Tone.setContext(this.rawCtx);\n\t\t\t\t} catch (e) {\n\t\t\t\t\tconsole.warn('[audio] setContext failed', e);\n\t\t\t\t}\n\t\t\t}\n\t\t\tthis.lastStage = 'context-set:' + this.contextState;\n\n\t\t\t// start() resumes the context; on an already-running context it\n\t\t\t// resolves immediately. Race a short timeout as a backstop so a\n\t\t\t// hung resume() can never stall init — the context is running anyway.\n\t\t\tawait Promise.race([\n\t\t\t\tthis.Tone.start(),\n\t\t\t\tnew Promise<void>((r) => setTimeout(r, 1500)),\n\t\t\t]);\n\t\t\tthis.lastStage = 'context-started:' + this.contextState;\n\n\t\t\t// ── Reliable synth piano: instant, zero downloads, universal ──\n\t\t\tthis.synthPiano = new this.Tone.PolySynth(this.Tone.Synth, {\n\t\t\t\toscillator: { type: 'triangle' },\n\t\t\t\tenvelope: { attack: 0.005, decay: 0.5, sustain: 0.3, release: 1.2 },\n\t\t\t}).toDestination() as unknown as ToneSampler;\n\t\t\tthis.piano = this.synthPiano;\n\t\t\tthis.voice = 'synth';\n\t\t\tthis.applyPianoVolume();\n\t\t\tthis.lastStage = 'piano-synth-ready';\n\n\t\t\t// ── Pad synth for background chords ──\n\t\t\t// Pad → lowpass → destination, immediately and reliably (dry). Reverb\n\t\t\t// is added later in the background (see addReverbInBackground): its\n\t\t\t// generate() runs an OfflineAudioContext render that can hang on iOS,\n\t\t\t// so it must never sit on the init critical path.\n\t\t\tthis.padFilter = new this.Tone.Filter({\n\t\t\t\ttype: 'lowpass',\n\t\t\t\tfrequency: 2000,\n\t\t\t\trolloff: -12,\n\t\t\t}).toDestination() as unknown as ToneNode;\n\n\t\t\tthis.strings = new this.Tone.PolySynth(this.Tone.Synth, {\n\t\t\t\toscillator: { type: 'fatsawtooth', count: 3, spread: 30 },\n\t\t\t\tenvelope: { attack: 0.5, decay: 0.3, sustain: 0.6, release: 2 },\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t}).connect(this.padFilter as any) as TonePolySynth;\n\t\t\tthis.strings.volume.value = -10;\n\n\t\t\t// ── Drone pad: a sustained, NON-resolving key anchor ──\n\t\t\t// Open-fifth tonic drone (root + 5th, no third). Exploratory views use\n\t\t\t// it instead of a tonic triad so a held note keeps its real tension\n\t\t\t// (e.g. the leading tone 7 still strains toward 1) rather than being\n\t\t\t// harmonised into a consonant Imaj/Imaj7. Soft, low, routed through the\n\t\t\t// same filter/reverb as the pad. Sustains until stopDrone().\n\t\t\tthis.dronePad = new this.Tone.PolySynth(this.Tone.Synth, {\n\t\t\t\toscillator: { type: 'triangle' },\n\t\t\t\tenvelope: { attack: 0.6, decay: 0.2, sustain: 0.9, release: 1.5 },\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t}).connect(this.padFilter as any) as TonePolySynth;\n\t\t\tthis.dronePad.volume.value = -16;\n\n\t\t\t// Audio is usable now — do NOT block on sample loading or reverb.\n\t\t\tthis.isInitialized = true;\n\t\t\tthis.lastStage = 'ready';\n\n\t\t\t// Background upgrades — neither blocks readiness.\n\t\t\tthis.upgradeToSamplerInBackground();\n\t\t\tthis.addReverbInBackground();\n\t\t} catch (error) {\n\t\t\tthis.lastStage = 'error:' + (error instanceof Error ? error.message : String(error));\n\t\t\tconsole.error('Failed to initialize audio:', error);\n\t\t} finally {\n\t\t\tthis.isLoading = false;\n\t\t}\n\t}\n\n\t/**\n\t * Attempt to load the Salamander sampler in the background and swap it in\n\t * for the synth piano once (and only if) every sample has decoded. On iOS\n\t * Safari this typically never completes, so we simply stay on the synth —\n\t * no stall is ever surfaced because init already resolved.\n\t */\n\tprivate upgradeToSamplerInBackground(): void {\n\t\tif (!this.Tone || this.samplerUpgradeStarted) return;\n\t\tthis.samplerUpgradeStarted = true;\n\n\t\ttry {\n\t\t\tconst sampler = createSalamanderSampler(this.Tone, {\n\t\t\t\turls: SALAMANDER_URLS_FULL,\n\t\t\t\tbaseUrl: '/audio/salamander/',\n\t\t\t\trelease: 1,\n\t\t\t\tonload: () => {\n\t\t\t\t\t// Swap only after every sample decoded successfully.\n\t\t\t\t\tthis.piano = sampler as ToneSampler;\n\t\t\t\t\tthis.voice = 'sampler';\n\t\t\t\t\tthis.applyPianoVolume();\n\t\t\t\t\tconsole.info('[audio] upgraded piano voice to Salamander samples');\n\t\t\t\t},\n\t\t\t\tonerror: (e: unknown) => {\n\t\t\t\t\tconsole.warn('[audio] sample load failed, staying on synth voice', e);\n\t\t\t\t},\n\t\t\t});\n\t\t\tvoid sampler;\n\t\t} catch (e) {\n\t\t\tconsole.warn('[audio] sampler init threw, staying on synth voice', e);\n\t\t}\n\t}\n\n\t/**\n\t * Generate a reverb in the background and reroute the background pad through\n\t * it once ready: pad → filter → reverb → destination. Reverb.generate()\n\t * runs an OfflineAudioContext render that can hang on iOS Safari, so this is\n\t * deliberately off the init critical path — if it never resolves, the pad\n\t * simply stays dry. Raced against a timeout so we log and move on cleanly.\n\t */\n\tprivate async addReverbInBackground(): Promise<void> {\n\t\tif (!this.Tone || !this.padFilter || this.reverbStarted) return;\n\t\tthis.reverbStarted = true;\n\n\t\ttry {\n\t\t\tconst reverb = await generateReverb(this.Tone, { decay: 3, wet: 0.5 }, 4000);\n\t\t\tif (!reverb) {\n\t\t\t\tconsole.warn('[audio] reverb generate timed out, pad stays dry');\n\t\t\t\treturn;\n\t\t\t}\n\t\t\t(reverb as unknown as ToneNode).toDestination();\n\t\t\t// Reroute the pad: detach the filter from the raw destination and\n\t\t\t// send it through the reverb instead.\n\t\t\tthis.padFilter.disconnect();\n\t\t\tthis.padFilter.connect(reverb);\n\t\t\tconsole.info('[audio] reverb enabled');\n\t\t} catch (e) {\n\t\t\tconsole.warn('[audio] reverb generate failed, pad stays dry', e);\n\t\t}\n\t}\n\n\t/**\n\t * MUST be called SYNCHRONOUSLY from a user-gesture handler (touchstart /\n\t * click / keydown), before any await. Creates and resumes a raw\n\t * AudioContext in the gesture task so iOS Safari actually unlocks audio.\n\t * init() then adopts this context via Tone.setContext(). Idempotent.\n\t */\n\tunlock(): void {\n\t\tif (!browser) return;\n\t\ttry {\n\t\t\tif (!this.rawCtx) {\n\t\t\t\tconst AC = (window.AudioContext ||\n\t\t\t\t\t(window as unknown as { webkitAudioContext?: typeof AudioContext })\n\t\t\t\t\t\t.webkitAudioContext) as typeof AudioContext | undefined;\n\t\t\t\tif (!AC) return;\n\t\t\t\tthis.rawCtx = new AC();\n\t\t\t}\n\t\t\tif (this.rawCtx.state !== 'running') {\n\t\t\t\tthis.rawCtx.resume().catch(() => {});\n\t\t\t}\n\t\t} catch (e) {\n\t\t\tconsole.warn('[audio] unlock failed', e);\n\t\t}\n\t}\n\n\t/**\n\t * iOS Safari can silently leave the AudioContext in 'suspended' or\n\t * 'interrupted' state even after Tone.start() resolves, especially after\n\t * tab backgrounding or initial activation. Call this synchronously from\n\t * a user-gesture handler (or before playback) to wake it up. No-op when\n\t * the context is already running.\n\t */\n\tensureRunning(): void {\n\t\t// Resume the raw context we own (covers the pre-Tone window too).\n\t\tif (this.rawCtx && this.rawCtx.state !== 'running') {\n\t\t\tthis.rawCtx.resume().catch(() => {});\n\t\t}\n\t\tif (!this.Tone) return;\n\t\tconst ctx = this.Tone.getContext().rawContext as AudioContext | undefined;\n\t\tif (ctx && ctx.state !== 'running') {\n\t\t\t// Fire-and-forget resume — keeps the call synchronous so it stays\n\t\t\t// inside the current user-gesture stack.\n\t\t\tctx.resume().catch(() => {});\n\t\t}\n\t}\n\n\t/** Current AudioContext state, for diagnostics. */\n\tget contextState(): string {\n\t\tif (!this.Tone) return 'no-tone';\n\t\tconst ctx = this.Tone.getContext().rawContext as AudioContext | undefined;\n\t\treturn ctx?.state ?? 'no-context';\n\t}\n\n\t/**\n\t * Play a MIDI note\n\t */\n\tplayNote(midiNote: number, duration: number = 0.5, velocity: number = 0.8): void {\n\t\tif (!this.piano || !this.isInitialized) return;\n\t\tthis.ensureRunning();\n\t\tconst noteName = midiToNoteName(midiNote);\n\t\tthis.piano.triggerAttackRelease(noteName, duration, this.Tone!.now(), velocity);\n\t}\n\n\t/**\n\t * Play a scale degree in a given key\n\t */\n\tplayScaleDegree(degree: number, key: string, octave: number = 4, duration: number = 0.5): void {\n\t\tconst midiNote = getMidiNote(degree, key, octave);\n\t\tthis.playNote(midiNote, duration);\n\t}\n\n\t/**\n\t * Start a sustained background chord (tonic chord)\n\t */\n\tstartBackgroundChord(key: string, duration: number = 4): void {\n\t\tif (!this.strings || !this.isInitialized) return;\n\t\tthis.ensureRunning();\n\n\t\tconst useFlats = (KEYS_PREFER_FLATS as readonly string[]).includes(key);\n\n\t\t// Build tonic chord voicing\n\t\tconst root4 = getMidiNote(1, key, 4);\n\t\tconst fifth4 = getMidiNote(5, key, 4);\n\t\tconst root5 = getMidiNote(1, key, 5);\n\t\tconst third5 = getMidiNote(3, key, 5);\n\n\t\tconst notes = [root4, fifth4, root5, third5].map((m) => midiToNoteName(m, useFlats));\n\n\t\tthis.strings.triggerAttackRelease(notes, duration, this.Tone!.now(), 0.3);\n\t}\n\n\t/**\n\t * Start a sustained tonic DRONE as a key anchor — an open fifth (root + 5th,\n\t * no third) in a low octave. Unlike startBackgroundChord (a full tonic\n\t * triad), the missing third means individual scale degrees keep their\n\t * tension instead of being resolved into the tonic chord: a note held over\n\t * this drone sounds as tense/stable as it truly is. Intended for exploratory\n\t * note-by-note views. Sustains until stopDrone() is called; calling again\n\t * restarts cleanly in the new key. Idempotent-safe.\n\t */\n\tstartDrone(key: string): void {\n\t\tif (!this.dronePad || !this.isInitialized) return;\n\t\tthis.ensureRunning();\n\t\tthis.stopDrone();\n\n\t\tconst useFlats = (KEYS_PREFER_FLATS as readonly string[]).includes(key);\n\t\tconst root3 = getMidiNote(1, key, 3);\n\t\tconst fifth3 = getMidiNote(5, key, 3);\n\t\tconst root4 = getMidiNote(1, key, 4);\n\t\tthis.droneNotes = [root3, fifth3, root4].map((m) => midiToNoteName(m, useFlats));\n\n\t\tthis.dronePad.triggerAttack(this.droneNotes, this.Tone!.now());\n\t}\n\n\t/** Stop the sustained drone started by startDrone(). No-op if none playing. */\n\tstopDrone(): void {\n\t\tif (!this.dronePad) return;\n\t\ttry {\n\t\t\tif (this.droneNotes.length > 0) {\n\t\t\t\tthis.dronePad.triggerRelease(this.droneNotes, this.Tone!.now());\n\t\t\t} else {\n\t\t\t\tthis.dronePad.releaseAll?.(this.Tone!.now());\n\t\t\t}\n\t\t} catch (e) {\n\t\t\tconsole.warn('[audio] stopDrone failed', e);\n\t\t}\n\t\tthis.droneNotes = [];\n\t}\n\n\t/**\n\t * Set the piano voice level in dB (0 = unchanged default, negative = quieter).\n\t * Applies to the current voice and is re-applied when the sampler swaps in.\n\t */\n\tsetPianoVolume(db: number): void {\n\t\tthis.pianoVolumeDb = db;\n\t\tthis.applyPianoVolume();\n\t}\n\n\tprivate applyPianoVolume(): void {\n\t\tfor (const voice of [this.synthPiano, this.piano]) {\n\t\t\tconst vol = (voice as { volume?: { value: number } } | null)?.volume;\n\t\t\tif (vol) vol.value = this.pianoVolumeDb;\n\t\t}\n\t}\n\n\t/**\n\t * Play a chord (list of MIDI notes) on the piano sampler.\n\t */\n\tplayChord(midiNotes: number[], duration: number = 1.5, velocity: number = 0.7): void {\n\t\tif (!this.piano || !this.isInitialized) return;\n\t\tthis.ensureRunning();\n\t\tconst names = midiNotes.map((m) => midiToNoteName(m));\n\t\tfor (const n of names) {\n\t\t\tthis.piano.triggerAttackRelease(n, duration, this.Tone!.now(), velocity);\n\t\t}\n\t}\n\n\t/**\n\t * Play a melodic phrase: a sequence of scale degrees with configurable timing.\n\t * Each note plays for `noteDuration` seconds, with `gap` ms gap between notes.\n\t */\n\tasync playPhrase(\n\t\tdegrees: number[],\n\t\tkey: string,\n\t\toctave: number,\n\t\tnoteDuration: number = 0.4,\n\t\tgap: number = 100\n\t): Promise<void> {\n\t\tfor (let i = 0; i < degrees.length; i++) {\n\t\t\tthis.playScaleDegree(degrees[i], key, octave, noteDuration);\n\t\t\tawait this.wait(Math.round(noteDuration * 1000) + gap);\n\t\t}\n\t}\n\n\t/**\n\t * Play a sequence of scale degrees\n\t */\n\tasync playSequence(\n\t\tdegrees: number[],\n\t\tkey: string,\n\t\ttempo: number = 500,\n\t\toctave: number = 4,\n\t\tonNoteStart?: (index: number) => void,\n\t\tonNoteEnd?: (index: number) => void\n\t): Promise<void> {\n\t\tfor (let i = 0; i < degrees.length; i++) {\n\t\t\tonNoteStart?.(i);\n\t\t\tthis.playScaleDegree(degrees[i], key, octave, 0.45);\n\t\t\tawait this.wait(tempo);\n\t\t\tonNoteEnd?.(i);\n\t\t}\n\t}\n\n\t/**\n\t * Utility to wait for a given duration\n\t */\n\tprivate wait(ms: number): Promise<void> {\n\t\treturn new Promise((resolve) => setTimeout(resolve, ms));\n\t}\n\n\t/**\n\t * Check if audio is ready\n\t */\n\tget isReady(): boolean {\n\t\treturn this.isInitialized;\n\t}\n\n\t/** A MediaStream of the engine's full output, tapped additively (speakers keep\n\t *  playing). Returns null until init() has created the audio context. For the\n\t *  promo capture only — not part of normal playback. */\n\tgetCaptureStream(): MediaStream | null {\n\t\tif (!this.Tone || !this.rawCtx) return null;\n\t\tif (!this.captureDest) {\n\t\t\tthis.captureDest = this.rawCtx.createMediaStreamDestination();\n\t\t\t(this.Tone.getDestination() as unknown as { connect: (n: AudioNode) => void }).connect(this.captureDest);\n\t\t}\n\t\treturn this.captureDest.stream;\n\t}\n}\n\n// Singleton instance\nexport const audio = new AudioEngine();\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/engine.ts"],"sourcesContent":["import { getMidiNote } from './scales';\nimport { midiToNoteName } from './notes';\nimport { KEYS_PREFER_FLATS } from './enharmonic';\nimport { SALAMANDER_URLS_FULL } from './salamander';\nimport { createSalamanderSampler, generateReverb } from './audioHelpers';\n\n// SSR-safe browser guard (equivalent to SvelteKit's `browser` at runtime).\nconst browser = typeof window !== 'undefined';\n\n// Tone.js types (loaded dynamically)\ntype ToneSampler = {\n\ttriggerAttackRelease: (note: string, duration: number | string, time?: number, velocity?: number) => void;\n\ttoDestination: () => ToneSampler;\n\tvolume?: { value: number };\n};\ntype TonePolySynth = {\n\ttriggerAttackRelease: (notes: string[], duration: number | string, time?: number, velocity?: number) => void;\n\ttriggerAttack: (notes: string[], time?: number, velocity?: number) => void;\n\ttriggerRelease: (notes: string[], time?: number) => void;\n\treleaseAll?: (time?: number) => void;\n\ttoDestination: () => TonePolySynth;\n\tconnect: (node: unknown) => TonePolySynth;\n\tvolume: { value: number };\n};\n// Minimal audio-node shape we need to reroute the pad through reverb later.\ntype ToneNode = {\n\tconnect: (node: unknown) => unknown;\n\tdisconnect: () => void;\n\ttoDestination: () => unknown;\n};\n\n// Pre-warm the Tone import so that init() can call Tone.start()\n// synchronously inside a user-gesture handler (required by iOS Safari).\nconst tonePreload: Promise<typeof import('tone')> | null = browser\n\t? import('tone')\n\t: null;\n\nexport class AudioEngine {\n\tprivate piano: ToneSampler | null = null;\n\tprivate synthPiano: ToneSampler | null = null;\n\tprivate strings: TonePolySynth | null = null;\n\tprivate dronePad: TonePolySynth | null = null;\n\tprivate droneNotes: string[] = [];\n\t/** Piano voice level in dB; applied to whichever voice is active. */\n\tprivate pianoVolumeDb = 0;\n\tprivate isInitialized = false;\n\tprivate isLoading = false;\n\tprivate samplerUpgradeStarted = false;\n\tprivate reverbStarted = false;\n\tprivate padFilter: ToneNode | null = null;\n\tprivate Tone: typeof import('tone') | null = null;\n\t/** Which piano voice is currently sounding — for diagnostics. */\n\tvoice: 'none' | 'synth' | 'sampler' = 'none';\n\t/** Last init milestone reached — surfaced on-device to pinpoint stalls. */\n\tlastStage = 'idle';\n\t/**\n\t * Raw AudioContext we create + resume SYNCHRONOUSLY inside the first user\n\t * gesture. iOS Safari only unlocks audio when resume() is called directly\n\t * in the gesture task; awaiting the Tone import first (as init() must) loses\n\t * that activation, so Tone.start()'s resume() hangs with the context stuck\n\t * 'suspended'. We resume this context in the gesture, then hand it to Tone.\n\t */\n\tprivate rawCtx: AudioContext | null = null;\n\tprivate captureDest: MediaStreamAudioDestinationNode | null = null;\n\n\t/**\n\t * Initialize the audio engine (must be called from a user gesture handler).\n\t *\n\t * Strategy: graceful degradation. We bring up a synthesized piano voice\n\t * FIRST — it needs no downloads and decodes nothing, so it is ready\n\t * instantly and works on every browser including iOS Safari. Audio is\n\t * considered ready at that point. We THEN try to load the richer\n\t * Salamander samples in the background and swap them in if they finish.\n\t *\n\t * Why: Tone.Sampler's MP3 decode path hangs on iOS Safari (await\n\t * Tone.loaded() never resolves), which previously stalled init forever.\n\t * Loading samples off the critical path means iOS always gets working\n\t * sound (synth) and merely misses the upgrade, instead of getting silence.\n\t *\n\t * On iOS Safari, Tone.start() must run during the synchronous portion of\n\t * the gesture handler, which is why we pre-import the Tone module above.\n\t */\n\tasync init(): Promise<void> {\n\t\tif (!browser) return;\n\t\tif (this.isInitialized || this.isLoading) return;\n\t\tthis.isLoading = true;\n\t\tthis.lastStage = 'init-start';\n\n\t\ttry {\n\t\t\t// Resolve the pre-warmed Tone import (typically already done).\n\t\t\tthis.Tone = await tonePreload!;\n\t\t\tthis.lastStage = 'tone-imported';\n\n\t\t\t// Use the context we already resumed synchronously in the gesture\n\t\t\t// (see unlock()). Handing it to Tone before any node is created means\n\t\t\t// Tone runs on an already-'running' context, so start() can't hang.\n\t\t\tif (this.rawCtx) {\n\t\t\t\ttry {\n\t\t\t\t\tthis.Tone.setContext(this.rawCtx);\n\t\t\t\t} catch (e) {\n\t\t\t\t\tconsole.warn('[audio] setContext failed', e);\n\t\t\t\t}\n\t\t\t}\n\t\t\tthis.lastStage = 'context-set:' + this.contextState;\n\n\t\t\t// start() resumes the context; on an already-running context it\n\t\t\t// resolves immediately. Race a short timeout as a backstop so a\n\t\t\t// hung resume() can never stall init — the context is running anyway.\n\t\t\tawait Promise.race([\n\t\t\t\tthis.Tone.start(),\n\t\t\t\tnew Promise<void>((r) => setTimeout(r, 1500)),\n\t\t\t]);\n\t\t\tthis.lastStage = 'context-started:' + this.contextState;\n\n\t\t\t// ── Reliable synth piano: instant, zero downloads, universal ──\n\t\t\tthis.synthPiano = new this.Tone.PolySynth(this.Tone.Synth, {\n\t\t\t\toscillator: { type: 'triangle' },\n\t\t\t\tenvelope: { attack: 0.005, decay: 0.5, sustain: 0.3, release: 1.2 },\n\t\t\t}).toDestination() as unknown as ToneSampler;\n\t\t\tthis.piano = this.synthPiano;\n\t\t\tthis.voice = 'synth';\n\t\t\tthis.applyPianoVolume();\n\t\t\tthis.lastStage = 'piano-synth-ready';\n\n\t\t\t// ── Pad synth for background chords ──\n\t\t\t// Pad → lowpass → destination, immediately and reliably (dry). Reverb\n\t\t\t// is added later in the background (see addReverbInBackground): its\n\t\t\t// generate() runs an OfflineAudioContext render that can hang on iOS,\n\t\t\t// so it must never sit on the init critical path.\n\t\t\tthis.padFilter = new this.Tone.Filter({\n\t\t\t\ttype: 'lowpass',\n\t\t\t\tfrequency: 2000,\n\t\t\t\trolloff: -12,\n\t\t\t}).toDestination() as unknown as ToneNode;\n\n\t\t\tthis.strings = new this.Tone.PolySynth(this.Tone.Synth, {\n\t\t\t\toscillator: { type: 'fatsawtooth', count: 3, spread: 30 },\n\t\t\t\tenvelope: { attack: 0.5, decay: 0.3, sustain: 0.6, release: 2 },\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t}).connect(this.padFilter as any) as TonePolySynth;\n\t\t\tthis.strings.volume.value = -10;\n\n\t\t\t// ── Drone pad: a sustained, NON-resolving key anchor ──\n\t\t\t// Open-fifth tonic drone (root + 5th, no third). Exploratory views use\n\t\t\t// it instead of a tonic triad so a held note keeps its real tension\n\t\t\t// (e.g. the leading tone 7 still strains toward 1) rather than being\n\t\t\t// harmonised into a consonant Imaj/Imaj7. Soft, low, routed through the\n\t\t\t// same filter/reverb as the pad. Sustains until stopDrone().\n\t\t\tthis.dronePad = new this.Tone.PolySynth(this.Tone.Synth, {\n\t\t\t\toscillator: { type: 'triangle' },\n\t\t\t\tenvelope: { attack: 0.6, decay: 0.2, sustain: 0.9, release: 1.5 },\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t}).connect(this.padFilter as any) as TonePolySynth;\n\t\t\tthis.dronePad.volume.value = -16;\n\n\t\t\t// Audio is usable now — do NOT block on sample loading or reverb.\n\t\t\tthis.isInitialized = true;\n\t\t\tthis.lastStage = 'ready';\n\n\t\t\t// Background upgrades — neither blocks readiness.\n\t\t\tthis.upgradeToSamplerInBackground();\n\t\t\tthis.addReverbInBackground();\n\t\t} catch (error) {\n\t\t\tthis.lastStage = 'error:' + (error instanceof Error ? error.message : String(error));\n\t\t\tconsole.error('Failed to initialize audio:', error);\n\t\t} finally {\n\t\t\tthis.isLoading = false;\n\t\t}\n\t}\n\n\t/**\n\t * Attempt to load the Salamander sampler in the background and swap it in\n\t * for the synth piano once (and only if) every sample has decoded. On iOS\n\t * Safari this typically never completes, so we simply stay on the synth —\n\t * no stall is ever surfaced because init already resolved.\n\t */\n\tprivate upgradeToSamplerInBackground(): void {\n\t\tif (!this.Tone || this.samplerUpgradeStarted) return;\n\t\tthis.samplerUpgradeStarted = true;\n\n\t\ttry {\n\t\t\tconst sampler = createSalamanderSampler(this.Tone, {\n\t\t\t\turls: SALAMANDER_URLS_FULL,\n\t\t\t\tbaseUrl: '/audio/salamander/',\n\t\t\t\trelease: 1,\n\t\t\t\tonload: () => {\n\t\t\t\t\t// Swap only after every sample decoded successfully.\n\t\t\t\t\tthis.piano = sampler as ToneSampler;\n\t\t\t\t\tthis.voice = 'sampler';\n\t\t\t\t\tthis.applyPianoVolume();\n\t\t\t\t\tconsole.info('[audio] upgraded piano voice to Salamander samples');\n\t\t\t\t},\n\t\t\t\tonerror: (e: unknown) => {\n\t\t\t\t\tconsole.warn('[audio] sample load failed, staying on synth voice', e);\n\t\t\t\t},\n\t\t\t});\n\t\t\tvoid sampler;\n\t\t} catch (e) {\n\t\t\tconsole.warn('[audio] sampler init threw, staying on synth voice', e);\n\t\t}\n\t}\n\n\t/**\n\t * Generate a reverb in the background and reroute the background pad through\n\t * it once ready: pad → filter → reverb → destination. Reverb.generate()\n\t * runs an OfflineAudioContext render that can hang on iOS Safari, so this is\n\t * deliberately off the init critical path — if it never resolves, the pad\n\t * simply stays dry. Raced against a timeout so we log and move on cleanly.\n\t */\n\tprivate async addReverbInBackground(): Promise<void> {\n\t\tif (!this.Tone || !this.padFilter || this.reverbStarted) return;\n\t\tthis.reverbStarted = true;\n\n\t\ttry {\n\t\t\tconst reverb = await generateReverb(this.Tone, { decay: 3, wet: 0.5 }, 4000);\n\t\t\tif (!reverb) {\n\t\t\t\tconsole.warn('[audio] reverb generate timed out, pad stays dry');\n\t\t\t\treturn;\n\t\t\t}\n\t\t\t(reverb as unknown as ToneNode).toDestination();\n\t\t\t// Reroute the pad: detach the filter from the raw destination and\n\t\t\t// send it through the reverb instead.\n\t\t\tthis.padFilter.disconnect();\n\t\t\tthis.padFilter.connect(reverb);\n\t\t\tconsole.info('[audio] reverb enabled');\n\t\t} catch (e) {\n\t\t\tconsole.warn('[audio] reverb generate failed, pad stays dry', e);\n\t\t}\n\t}\n\n\t/**\n\t * MUST be called SYNCHRONOUSLY from a user-gesture handler (touchstart /\n\t * click / keydown), before any await. Creates and resumes a raw\n\t * AudioContext in the gesture task so iOS Safari actually unlocks audio.\n\t * init() then adopts this context via Tone.setContext(). Idempotent.\n\t */\n\tunlock(): void {\n\t\tif (!browser) return;\n\t\ttry {\n\t\t\tif (!this.rawCtx) {\n\t\t\t\tconst AC = (window.AudioContext ||\n\t\t\t\t\t(window as unknown as { webkitAudioContext?: typeof AudioContext })\n\t\t\t\t\t\t.webkitAudioContext) as typeof AudioContext | undefined;\n\t\t\t\tif (!AC) return;\n\t\t\t\tthis.rawCtx = new AC();\n\t\t\t}\n\t\t\tif (this.rawCtx.state !== 'running') {\n\t\t\t\tthis.rawCtx.resume().catch(() => {});\n\t\t\t}\n\t\t} catch (e) {\n\t\t\tconsole.warn('[audio] unlock failed', e);\n\t\t}\n\t}\n\n\t/**\n\t * iOS Safari can silently leave the AudioContext in 'suspended' or\n\t * 'interrupted' state even after Tone.start() resolves, especially after\n\t * tab backgrounding or initial activation. Call this synchronously from\n\t * a user-gesture handler (or before playback) to wake it up. No-op when\n\t * the context is already running.\n\t */\n\tensureRunning(): void {\n\t\t// Resume the raw context we own (covers the pre-Tone window too).\n\t\tif (this.rawCtx && this.rawCtx.state !== 'running') {\n\t\t\tthis.rawCtx.resume().catch(() => {});\n\t\t}\n\t\tif (!this.Tone) return;\n\t\tconst ctx = this.Tone.getContext().rawContext as AudioContext | undefined;\n\t\tif (ctx && ctx.state !== 'running') {\n\t\t\t// Fire-and-forget resume — keeps the call synchronous so it stays\n\t\t\t// inside the current user-gesture stack.\n\t\t\tctx.resume().catch(() => {});\n\t\t}\n\t}\n\n\t/** Current AudioContext state, for diagnostics. */\n\tget contextState(): string {\n\t\tif (!this.Tone) return 'no-tone';\n\t\tconst ctx = this.Tone.getContext().rawContext as AudioContext | undefined;\n\t\treturn ctx?.state ?? 'no-context';\n\t}\n\n\t/**\n\t * Play a MIDI note\n\t */\n\tplayNote(midiNote: number, duration: number = 0.5, velocity: number = 0.8): void {\n\t\tif (!this.piano || !this.isInitialized) return;\n\t\tthis.ensureRunning();\n\t\tconst noteName = midiToNoteName(midiNote);\n\t\tthis.piano.triggerAttackRelease(noteName, duration, this.Tone!.now(), velocity);\n\t}\n\n\t/**\n\t * Play a scale degree in a given key\n\t */\n\tplayScaleDegree(degree: number, key: string, octave: number = 4, duration: number = 0.5): void {\n\t\tconst midiNote = getMidiNote(degree, key, octave);\n\t\tthis.playNote(midiNote, duration);\n\t}\n\n\t/**\n\t * Start a sustained background chord (tonic chord)\n\t */\n\tstartBackgroundChord(key: string, duration: number = 4): void {\n\t\tif (!this.strings || !this.isInitialized) return;\n\t\tthis.ensureRunning();\n\n\t\tconst useFlats = (KEYS_PREFER_FLATS as readonly string[]).includes(key);\n\n\t\t// Build tonic chord voicing\n\t\tconst root4 = getMidiNote(1, key, 4);\n\t\tconst fifth4 = getMidiNote(5, key, 4);\n\t\tconst root5 = getMidiNote(1, key, 5);\n\t\tconst third5 = getMidiNote(3, key, 5);\n\n\t\tconst notes = [root4, fifth4, root5, third5].map((m) => midiToNoteName(m, useFlats));\n\n\t\tthis.strings.triggerAttackRelease(notes, duration, this.Tone!.now(), 0.3);\n\t}\n\n\t/**\n\t * Start a sustained tonic DRONE as a key anchor — an open fifth (root + 5th,\n\t * no third) in a low octave. Unlike startBackgroundChord (a full tonic\n\t * triad), the missing third means individual scale degrees keep their\n\t * tension instead of being resolved into the tonic chord: a note held over\n\t * this drone sounds as tense/stable as it truly is. Intended for exploratory\n\t * note-by-note views. Sustains until stopDrone() is called; calling again\n\t * restarts cleanly in the new key. Idempotent-safe.\n\t */\n\tstartDrone(key: string): void {\n\t\tif (!this.dronePad || !this.isInitialized) return;\n\t\tthis.ensureRunning();\n\t\tthis.stopDrone();\n\n\t\tconst useFlats = (KEYS_PREFER_FLATS as readonly string[]).includes(key);\n\t\tconst root3 = getMidiNote(1, key, 3);\n\t\tconst fifth3 = getMidiNote(5, key, 3);\n\t\tconst root4 = getMidiNote(1, key, 4);\n\t\tthis.droneNotes = [root3, fifth3, root4].map((m) => midiToNoteName(m, useFlats));\n\n\t\tthis.dronePad.triggerAttack(this.droneNotes, this.Tone!.now());\n\t}\n\n\t/** Stop the sustained drone started by startDrone(). No-op if none playing. */\n\tstopDrone(): void {\n\t\tif (!this.dronePad) return;\n\t\ttry {\n\t\t\tif (this.droneNotes.length > 0) {\n\t\t\t\tthis.dronePad.triggerRelease(this.droneNotes, this.Tone!.now());\n\t\t\t} else {\n\t\t\t\tthis.dronePad.releaseAll?.(this.Tone!.now());\n\t\t\t}\n\t\t} catch (e) {\n\t\t\tconsole.warn('[audio] stopDrone failed', e);\n\t\t}\n\t\tthis.droneNotes = [];\n\t}\n\n\t/**\n\t * Set the piano voice level in dB (0 = unchanged default, negative = quieter).\n\t * Applies to the current voice and is re-applied when the sampler swaps in.\n\t */\n\tsetPianoVolume(db: number): void {\n\t\tthis.pianoVolumeDb = db;\n\t\tthis.applyPianoVolume();\n\t}\n\n\tprivate applyPianoVolume(): void {\n\t\tfor (const voice of [this.synthPiano, this.piano]) {\n\t\t\tconst vol = (voice as { volume?: { value: number } } | null)?.volume;\n\t\t\tif (vol) vol.value = this.pianoVolumeDb;\n\t\t}\n\t}\n\n\t/**\n\t * Play a chord (list of MIDI notes) on the piano sampler.\n\t */\n\tplayChord(midiNotes: number[], duration: number = 1.5, velocity: number = 0.7): void {\n\t\tif (!this.piano || !this.isInitialized) return;\n\t\tthis.ensureRunning();\n\t\tconst names = midiNotes.map((m) => midiToNoteName(m));\n\t\tfor (const n of names) {\n\t\t\tthis.piano.triggerAttackRelease(n, duration, this.Tone!.now(), velocity);\n\t\t}\n\t}\n\n\t/**\n\t * Play a melodic phrase: a sequence of scale degrees with configurable timing.\n\t * Each note plays for `noteDuration` seconds, with `gap` ms gap between notes.\n\t */\n\tasync playPhrase(\n\t\tdegrees: number[],\n\t\tkey: string,\n\t\toctave: number,\n\t\tnoteDuration: number = 0.4,\n\t\tgap: number = 100\n\t): Promise<void> {\n\t\tfor (let i = 0; i < degrees.length; i++) {\n\t\t\tthis.playScaleDegree(degrees[i], key, octave, noteDuration);\n\t\t\tawait this.wait(Math.round(noteDuration * 1000) + gap);\n\t\t}\n\t}\n\n\t/**\n\t * Play a sequence of scale degrees\n\t */\n\tasync playSequence(\n\t\tdegrees: number[],\n\t\tkey: string,\n\t\ttempo: number = 500,\n\t\toctave: number = 4,\n\t\tonNoteStart?: (index: number) => void,\n\t\tonNoteEnd?: (index: number) => void\n\t): Promise<void> {\n\t\tfor (let i = 0; i < degrees.length; i++) {\n\t\t\tonNoteStart?.(i);\n\t\t\tthis.playScaleDegree(degrees[i], key, octave, 0.45);\n\t\t\tawait this.wait(tempo);\n\t\t\tonNoteEnd?.(i);\n\t\t}\n\t}\n\n\t/**\n\t * Utility to wait for a given duration\n\t */\n\tprivate wait(ms: number): Promise<void> {\n\t\treturn new Promise((resolve) => setTimeout(resolve, ms));\n\t}\n\n\t/**\n\t * Check if audio is ready\n\t */\n\tget isReady(): boolean {\n\t\treturn this.isInitialized;\n\t}\n\n\t/** A MediaStream of the engine's full output, tapped additively (speakers keep\n\t *  playing). Returns null until init() has created the audio context. For the\n\t *  promo capture only — not part of normal playback. */\n\tgetCaptureStream(): MediaStream | null {\n\t\tif (!this.Tone || !this.rawCtx) return null;\n\t\tif (!this.captureDest) {\n\t\t\tthis.captureDest = this.rawCtx.createMediaStreamDestination();\n\t\t\t(this.Tone.getDestination() as unknown as { connect: (n: AudioNode) => void }).connect(this.captureDest);\n\t\t}\n\t\treturn this.captureDest.stream;\n\t}\n}\n\n// Singleton instance\nexport const audio = new AudioEngine();\n"],"mappings":"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","names":[]}

package/dist/chunk-BPL5LLQH.js

@@ -0,0 +1,74 @@
+// src/salamander.ts
+var SALAMANDER_CDN_BASE = "https://tonejs.github.io/audio/salamander/";
+var SALAMANDER_URLS_8 = {
+  C2: "C2.mp3",
+  "F#2": "Fs2.mp3",
+  C3: "C3.mp3",
+  "F#3": "Fs3.mp3",
+  C4: "C4.mp3",
+  "F#4": "Fs4.mp3",
+  C5: "C5.mp3",
+  "F#5": "Fs5.mp3"
+};
+var SALAMANDER_URLS_FULL = {
+  A0: "A0.mp3",
+  C1: "C1.mp3",
+  "D#1": "Ds1.mp3",
+  "F#1": "Fs1.mp3",
+  A1: "A1.mp3",
+  C2: "C2.mp3",
+  "D#2": "Ds2.mp3",
+  "F#2": "Fs2.mp3",
+  A2: "A2.mp3",
+  C3: "C3.mp3",
+  "D#3": "Ds3.mp3",
+  "F#3": "Fs3.mp3",
+  A3: "A3.mp3",
+  C4: "C4.mp3",
+  "D#4": "Ds4.mp3",
+  "F#4": "Fs4.mp3",
+  A4: "A4.mp3",
+  C5: "C5.mp3",
+  "D#5": "Ds5.mp3",
+  "F#5": "Fs5.mp3",
+  A5: "A5.mp3",
+  C6: "C6.mp3",
+  "D#6": "Ds6.mp3",
+  "F#6": "Fs6.mp3",
+  A6: "A6.mp3",
+  C7: "C7.mp3",
+  "D#7": "Ds7.mp3",
+  "F#7": "Fs7.mp3",
+  A7: "A7.mp3",
+  C8: "C8.mp3"
+};
+
+// src/audioHelpers.ts
+function createSalamanderSampler(Tone, opts) {
+  const sampler = new Tone.Sampler({
+    urls: opts.urls,
+    baseUrl: opts.baseUrl,
+    release: opts.release,
+    onload: opts.onload,
+    onerror: opts.onerror
+  }).toDestination();
+  if (opts.volumeDb !== void 0) sampler.volume.value = opts.volumeDb;
+  return sampler;
+}
+async function generateReverb(Tone, opts, timeoutMs) {
+  const reverb = new Tone.Reverb(opts);
+  const ok = await Promise.race([
+    reverb.generate().then(() => true),
+    new Promise((r) => setTimeout(() => r(false), timeoutMs))
+  ]);
+  return ok ? reverb : null;
+}
+
+export {
+  SALAMANDER_CDN_BASE,
+  SALAMANDER_URLS_8,
+  SALAMANDER_URLS_FULL,
+  createSalamanderSampler,
+  generateReverb
+};
+//# sourceMappingURL=chunk-BPL5LLQH.js.map

package/dist/chunk-BPL5LLQH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/salamander.ts","../src/audioHelpers.ts"],"sourcesContent":["export const SALAMANDER_CDN_BASE = 'https://tonejs.github.io/audio/salamander/';\n\n/** 8-anchor sample set (Stave uses these from the CDN). */\nexport const SALAMANDER_URLS_8: Record<string, string> = {\n  C2: 'C2.mp3', 'F#2': 'Fs2.mp3', C3: 'C3.mp3', 'F#3': 'Fs3.mp3',\n  C4: 'C4.mp3', 'F#4': 'Fs4.mp3', C5: 'C5.mp3', 'F#5': 'Fs5.mp3',\n};\n\n/** Full chromatic-anchor set A0..C8 (RET ships these locally under /audio/salamander/). */\nexport const SALAMANDER_URLS_FULL: Record<string, string> = {\n  A0: 'A0.mp3', C1: 'C1.mp3', 'D#1': 'Ds1.mp3', 'F#1': 'Fs1.mp3', A1: 'A1.mp3',\n  C2: 'C2.mp3', 'D#2': 'Ds2.mp3', 'F#2': 'Fs2.mp3', A2: 'A2.mp3',\n  C3: 'C3.mp3', 'D#3': 'Ds3.mp3', 'F#3': 'Fs3.mp3', A3: 'A3.mp3',\n  C4: 'C4.mp3', 'D#4': 'Ds4.mp3', 'F#4': 'Fs4.mp3', A4: 'A4.mp3',\n  C5: 'C5.mp3', 'D#5': 'Ds5.mp3', 'F#5': 'Fs5.mp3', A5: 'A5.mp3',\n  C6: 'C6.mp3', 'D#6': 'Ds6.mp3', 'F#6': 'Fs6.mp3', A6: 'A6.mp3',\n  C7: 'C7.mp3', 'D#7': 'Ds7.mp3', 'F#7': 'Fs7.mp3', A7: 'A7.mp3',\n  C8: 'C8.mp3',\n};\n","// Tone is provided by the consumer (peer dep); type loosely to avoid coupling.\ntype ToneModule = any; // eslint-disable-line @typescript-eslint/no-explicit-any\n\nexport interface SalamanderSamplerOpts {\n  urls: Record<string, string>;\n  baseUrl: string;\n  release: number;\n  volumeDb?: number;\n  onload?: () => void;\n  onerror?: (e: unknown) => void;\n}\n\n/** Create a Salamander Tone.Sampler routed to destination. Mirrors the exact\n *  `new Tone.Sampler({...}).toDestination()` both engines did inline. */\nexport function createSalamanderSampler(Tone: ToneModule, opts: SalamanderSamplerOpts) {\n  const sampler = new Tone.Sampler({\n    urls: opts.urls,\n    baseUrl: opts.baseUrl,\n    release: opts.release,\n    onload: opts.onload,\n    onerror: opts.onerror,\n  }).toDestination();\n  if (opts.volumeDb !== undefined) sampler.volume.value = opts.volumeDb;\n  return sampler;\n}\n\n/** Generate a Tone.Reverb, racing reverb.generate() against a timeout so it can\n *  never hang init on iOS. Returns the reverb if generated, else null. Caller\n *  wires routing (toDestination / reroute). Mirrors RET's addReverbInBackground. */\nexport async function generateReverb(\n  Tone: ToneModule,\n  opts: { decay: number; wet: number },\n  timeoutMs: number,\n): Promise<any | null> { // eslint-disable-line @typescript-eslint/no-explicit-any\n  const reverb = new Tone.Reverb(opts);\n  const ok = await Promise.race([\n    reverb.generate().then(() => true),\n    new Promise<boolean>((r) => setTimeout(() => r(false), timeoutMs)),\n  ]);\n  return ok ? reverb : null;\n}\n"],"mappings":";AAAO,IAAM,sBAAsB;AAG5B,IAAM,oBAA4C;AAAA,EACvD,IAAI;AAAA,EAAU,OAAO;AAAA,EAAW,IAAI;AAAA,EAAU,OAAO;AAAA,EACrD,IAAI;AAAA,EAAU,OAAO;AAAA,EAAW,IAAI;AAAA,EAAU,OAAO;AACvD;AAGO,IAAM,uBAA+C;AAAA,EAC1D,IAAI;AAAA,EAAU,IAAI;AAAA,EAAU,OAAO;AAAA,EAAW,OAAO;AAAA,EAAW,IAAI;AAAA,EACpE,IAAI;AAAA,EAAU,OAAO;AAAA,EAAW,OAAO;AAAA,EAAW,IAAI;AAAA,EACtD,IAAI;AAAA,EAAU,OAAO;AAAA,EAAW,OAAO;AAAA,EAAW,IAAI;AAAA,EACtD,IAAI;AAAA,EAAU,OAAO;AAAA,EAAW,OAAO;AAAA,EAAW,IAAI;AAAA,EACtD,IAAI;AAAA,EAAU,OAAO;AAAA,EAAW,OAAO;AAAA,EAAW,IAAI;AAAA,EACtD,IAAI;AAAA,EAAU,OAAO;AAAA,EAAW,OAAO;AAAA,EAAW,IAAI;AAAA,EACtD,IAAI;AAAA,EAAU,OAAO;AAAA,EAAW,OAAO;AAAA,EAAW,IAAI;AAAA,EACtD,IAAI;AACN;;;ACJO,SAAS,wBAAwB,MAAkB,MAA6B;AACrF,QAAM,UAAU,IAAI,KAAK,QAAQ;AAAA,IAC/B,MAAM,KAAK;AAAA,IACX,SAAS,KAAK;AAAA,IACd,SAAS,KAAK;AAAA,IACd,QAAQ,KAAK;AAAA,IACb,SAAS,KAAK;AAAA,EAChB,CAAC,EAAE,cAAc;AACjB,MAAI,KAAK,aAAa,OAAW,SAAQ,OAAO,QAAQ,KAAK;AAC7D,SAAO;AACT;AAKA,eAAsB,eACpB,MACA,MACA,WACqB;AACrB,QAAM,SAAS,IAAI,KAAK,OAAO,IAAI;AACnC,QAAM,KAAK,MAAM,QAAQ,KAAK;AAAA,IAC5B,OAAO,SAAS,EAAE,KAAK,MAAM,IAAI;AAAA,IACjC,IAAI,QAAiB,CAAC,MAAM,WAAW,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC;AAAA,EACnE,CAAC;AACD,SAAO,KAAK,SAAS;AACvB;","names":[]}

package/dist/promo.d.ts

@@ -0,0 +1,80 @@
+interface MidiNote {
+    midi: number;
+    startMs: number;
+    /** Audible duration in ms — extended while the sustain pedal is held. */
+    durMs: number;
+    /** 0..1 */
+    velocity: number;
+}
+interface ParsedMidi {
+    /** When the last notated note is released (pre-pedal-tail), in ms — paces the playhead. */
+    durationMs: number;
+    notes: MidiNote[];
+}
+declare function parseMidi(buf: ArrayBuffer): ParsedMidi;
+/** Total playback duration in ms (0 if unparseable). */
+declare function midiDurationMs(buf: ArrayBuffer): number;
+interface Box {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** One staff's slice of a measure, in canvas px. */
+interface StaffMeasureBox {
+    index: number;
+    staff: number;
+    box: Box;
+    /** x of the measure's FIRST note (canvas px) — past any clef/key/time signature. */
+    noteStartX: number;
+}
+/** Per-measure column box: union across all staves for that measure, in canvas px. */
+interface MeasureColumnBox extends Box {
+    noteStartX: number;
+}
+interface RenderedNotation {
+    canvas: HTMLCanvasElement;
+    /** Per-row grand-staff system boxes in canvas px, top-to-bottom. */
+    systems: Box[];
+    /** Per-(measure, staff) boxes — RSR's geometry. */
+    measures: StaffMeasureBox[];
+    /** Per-measure column union across staves — RMT's geometry. */
+    measureColumns: MeasureColumnBox[];
+    /** Tight bounding box of all notation in canvas px (page whitespace cropped). */
+    content: Box;
+}
+interface RenderNotationOpts {
+    /** OSMD drawFrom/drawUpToMeasureNumber. Applied only when provided. */
+    bars?: [number, number];
+    /** Background fill colour. Default '#faf7f0' (RSR paper). */
+    paper?: string;
+    /** Pixel-sum threshold below which a pixel is counted as ink.
+     *  Default 690 (RSR: paper #faf7f0 sum ≈ 737). RMT uses 620. */
+    inkSumThreshold?: number;
+    /** Host div width in CSS px. Default 560 (RSR). RMT uses 620. */
+    hostWidth?: number;
+}
+/** Render a MusicXML string to a detached canvas + geometry.
+ *  Browser-only (requires document + opensheetmusicdisplay dynamic import). */
+declare function renderNotation(xml: string, opts?: RenderNotationOpts): Promise<RenderedNotation>;
+interface PromoSampler {
+    Tone: any;
+    sampler: unknown;
+    getStream(): MediaStream;
+    /** Current audio-clock time in seconds (Tone.now()). */
+    audioNow(): number;
+    /** releaseAll on the sampler; safe no-op on failure. */
+    stop(): void;
+}
+declare function createPromoSampler(opts?: {
+    /** Feed a 0-value ConstantSource into the capture stream so the recorder's
+     *  audio track is live from t=0 (silent intro scenes aren't dropped).
+     *  Default false (RSR behavior). RMT passes true. */
+    keepAlive?: boolean;
+    /** Sampler release time in seconds. Default 1.4. */
+    release?: number;
+    /** Sampler volume in dB. Default -2. */
+    volumeDb?: number;
+}): Promise<PromoSampler>;
+
+export { type Box, type MeasureColumnBox, type MidiNote, type ParsedMidi, type PromoSampler, type RenderNotationOpts, type RenderedNotation, type StaffMeasureBox, createPromoSampler, midiDurationMs, parseMidi, renderNotation };

package/dist/promo.js

@@ -0,0 +1,366 @@
+import {
+  SALAMANDER_CDN_BASE,
+  SALAMANDER_URLS_8,
+  createSalamanderSampler
+} from "./chunk-BPL5LLQH.js";
+
+// src/promo.ts
+function parseMidi(buf) {
+  try {
+    const dv = new DataView(buf);
+    let p = 0;
+    const u8 = () => dv.getUint8(p++);
+    const u16 = () => {
+      const v = dv.getUint16(p);
+      p += 2;
+      return v;
+    };
+    const u32 = () => {
+      const v = dv.getUint32(p);
+      p += 4;
+      return v;
+    };
+    if (u32() !== 1297377380) return { durationMs: 0, notes: [] };
+    const headerLen = u32();
+    u16();
+    const ntrk = u16();
+    const division = u16();
+    p = 8 + headerLen;
+    if (division & 32768) return { durationMs: 0, notes: [] };
+    const tpq = division || 480;
+    const events = [];
+    for (let t = 0; t < ntrk; t++) {
+      if (p + 8 > dv.byteLength || u32() !== 1297379947) break;
+      const len = u32();
+      const end = Math.min(p + len, dv.byteLength);
+      let tick = 0;
+      let running = 0;
+      while (p < end) {
+        let dt = 0, b;
+        do {
+          b = u8();
+          dt = dt << 7 | b & 127;
+        } while (b & 128 && p < end);
+        tick += dt;
+        let status = dv.getUint8(p);
+        if (status & 128) {
+          p++;
+          running = status;
+        } else {
+          status = running;
+        }
+        if (status === 255) {
+          const type = u8();
+          let l = 0, bb;
+          do {
+            bb = u8();
+            l = l << 7 | bb & 127;
+          } while (bb & 128 && p < end);
+          if (type === 81 && l === 3) {
+            events.push({
+              tick,
+              kind: "tempo",
+              us: dv.getUint8(p) << 16 | dv.getUint8(p + 1) << 8 | dv.getUint8(p + 2)
+            });
+          }
+          p += l;
+        } else if (status === 240 || status === 247) {
+          let l = 0, bb;
+          do {
+            bb = u8();
+            l = l << 7 | bb & 127;
+          } while (bb & 128 && p < end);
+          p += l;
+        } else {
+          const hi = status & 240;
+          if (hi === 144 || hi === 128) {
+            const midi = u8();
+            const vel = u8();
+            if (hi === 144 && vel > 0) events.push({ tick, kind: "on", midi, velocity: vel / 127 });
+            else events.push({ tick, kind: "off", midi });
+          } else if (hi === 176) {
+            const cc = u8();
+            const val = u8();
+            if (cc === 64) events.push({ tick, kind: "sustain", on: val >= 64 });
+          } else {
+            p += hi === 192 || hi === 208 ? 1 : 2;
+          }
+        }
+      }
+      p = end;
+    }
+    const tempos = events.filter((e) => e.kind === "tempo").sort((a, b) => a.tick - b.tick);
+    if (!tempos.length || tempos[0].tick > 0) tempos.unshift({ tick: 0, kind: "tempo", us: 5e5 });
+    const tickToMs = (tick) => {
+      let ms = 0;
+      for (let i = 0; i < tempos.length; i++) {
+        const segStart = tempos[i].tick;
+        if (segStart >= tick) break;
+        const segEnd = i + 1 < tempos.length ? Math.min(tempos[i + 1].tick, tick) : tick;
+        ms += (segEnd - segStart) / tpq * ((tempos[i].us ?? 5e5) / 1e3);
+      }
+      return ms;
+    };
+    const sustainEvents = events.filter((e) => e.kind === "sustain").sort((a, b) => a.tick - b.tick);
+    const pedalUpAfter = (tick) => {
+      for (const s of sustainEvents) if (!s.on && s.tick >= tick) return s.tick;
+      return null;
+    };
+    const pedalDownAt = (tick) => {
+      let down = false;
+      for (const s of sustainEvents) {
+        if (s.tick > tick) break;
+        down = !!s.on;
+      }
+      return down;
+    };
+    const ordered = events.filter((e) => e.kind === "on" || e.kind === "off").sort((a, b) => a.tick - b.tick);
+    const open = {};
+    const notes = [];
+    let lastOffTick = 0;
+    for (const e of ordered) {
+      const m = e.midi;
+      if (e.kind === "on") {
+        (open[m] ??= []).push({ tick: e.tick, vel: e.velocity ?? 0.7 });
+      } else {
+        const stack = open[m];
+        if (stack && stack.length) {
+          const start = stack.shift();
+          let endTick = e.tick;
+          lastOffTick = Math.max(lastOffTick, endTick);
+          if (pedalDownAt(endTick)) {
+            const up = pedalUpAfter(endTick);
+            if (up != null) endTick = up;
+          }
+          const startMs = tickToMs(start.tick);
+          notes.push({
+            midi: m,
+            startMs,
+            durMs: Math.max(60, tickToMs(endTick) - startMs),
+            velocity: start.vel
+          });
+        }
+      }
+    }
+    return { durationMs: tickToMs(lastOffTick), notes };
+  } catch {
+    return { durationMs: 0, notes: [] };
+  }
+}
+function midiDurationMs(buf) {
+  return parseMidi(buf).durationMs;
+}
+function unionBox(boxes, canvas, pad) {
+  if (!boxes.length) return { x: 0, y: 0, w: canvas.width, h: canvas.height };
+  const minX = Math.min(...boxes.map((b) => b.x));
+  const minY = Math.min(...boxes.map((b) => b.y));
+  const maxX = Math.max(...boxes.map((b) => b.x + b.w));
+  const maxY = Math.max(...boxes.map((b) => b.y + b.h));
+  const x = Math.max(0, minX - pad);
+  const y = Math.max(0, minY - pad);
+  return {
+    x,
+    y,
+    w: Math.min(canvas.width, maxX + pad) - x,
+    h: Math.min(canvas.height, maxY + pad) - y
+  };
+}
+function inkBoundingBox(canvas, inkSumThreshold) {
+  try {
+    const ctx = canvas.getContext("2d", { willReadFrequently: true });
+    if (!ctx) return null;
+    const { width: W, height: H } = canvas;
+    const data = ctx.getImageData(0, 0, W, H).data;
+    let minX = W, minY = H, maxX = -1, maxY = -1;
+    const step = 2;
+    for (let y2 = 0; y2 < H; y2 += step) {
+      for (let x2 = 0; x2 < W; x2 += step) {
+        const i = (y2 * W + x2) * 4;
+        if (data[i + 3] < 16) continue;
+        if (data[i] + data[i + 1] + data[i + 2] < inkSumThreshold) {
+          if (x2 < minX) minX = x2;
+          if (x2 > maxX) maxX = x2;
+          if (y2 < minY) minY = y2;
+          if (y2 > maxY) maxY = y2;
+        }
+      }
+    }
+    if (maxX < 0) return null;
+    const pad = 16;
+    const x = Math.max(0, minX - pad);
+    const y = Math.max(0, minY - pad);
+    return {
+      x,
+      y,
+      w: Math.min(W, maxX + pad) - x,
+      h: Math.min(H, maxY + pad) - y
+    };
+  } catch {
+    return null;
+  }
+}
+function extractGeometry(osmd, canvas, inkSumThreshold) {
+  const full = { x: 0, y: 0, w: canvas.width, h: canvas.height };
+  try {
+    const graphic = osmd.GraphicSheet;
+    const page = graphic?.MusicPages?.[0];
+    const pageW = page?.PositionAndShape?.Size?.width;
+    const musicSystems = page?.MusicSystems ?? [];
+    if (!pageW || !musicSystems.length) return { systems: [], measures: [], measureColumns: [], content: full };
+    const f = canvas.width / pageW;
+    const toBox = (pas) => {
+      const p = pas?.AbsolutePosition;
+      const sz = pas?.Size;
+      if (!p || !sz) return null;
+      return { x: p.x * f, y: p.y * f, w: sz.width * f, h: sz.height * f };
+    };
+    const systems = musicSystems.map((s) => toBox(s?.PositionAndShape)).filter((b) => !!b && b.w > 1 && b.h > 1).sort((a, b) => a.y - b.y);
+    if (!systems.length) return { systems: [], measures: [], measureColumns: [], content: full };
+    const measureList = graphic?.MeasureList ?? [];
+    const measures = [];
+    measureList.forEach((staves, index) => {
+      (staves ?? []).forEach((m, staff) => {
+        const box = toBox(m?.PositionAndShape);
+        if (box && box.w > 1 && box.h > 1) {
+          const seX = (m?.staffEntries ?? [])[0]?.PositionAndShape?.AbsolutePosition?.x;
+          const noteStartX = typeof seX === "number" ? seX * f : box.x;
+          measures.push({ index, staff, box, noteStartX });
+        }
+      });
+    });
+    const measureColumns = measureList.map((staves) => {
+      const arr = staves ?? [];
+      const boxes = arr.map((m) => toBox(m?.PositionAndShape)).filter((b) => !!b && b.w > 1 && b.h > 1);
+      if (!boxes.length) return null;
+      const x0 = Math.min(...boxes.map((b) => b.x));
+      const y0 = Math.min(...boxes.map((b) => b.y));
+      const x1 = Math.max(...boxes.map((b) => b.x + b.w));
+      const y1 = Math.max(...boxes.map((b) => b.y + b.h));
+      let nx = Infinity;
+      for (const m of arr) {
+        const seX = (m?.staffEntries ?? [])[0]?.PositionAndShape?.AbsolutePosition?.x;
+        if (typeof seX === "number") nx = Math.min(nx, seX * f);
+      }
+      const noteStartX = Number.isFinite(nx) ? Math.max(x0, Math.min(nx, x1)) : x0;
+      return { x: x0, y: y0, w: x1 - x0, h: y1 - y0, noteStartX };
+    }).filter((b) => !!b);
+    const content = inkBoundingBox(canvas, inkSumThreshold) ?? unionBox(systems, canvas, 14);
+    return { systems, measures, measureColumns, content };
+  } catch {
+    return { systems: [], measures: [], measureColumns: [], content: full };
+  }
+}
+async function renderNotation(xml, opts) {
+  const paper = opts?.paper ?? "#faf7f0";
+  const inkSumThreshold = opts?.inkSumThreshold ?? 690;
+  const hostWidth = opts?.hostWidth ?? 560;
+  const { OpenSheetMusicDisplay } = await import("opensheetmusicdisplay");
+  const host = document.createElement("div");
+  host.style.cssText = `position:fixed;left:-9999px;top:0;width:${hostWidth}px;background:${paper};`;
+  document.body.appendChild(host);
+  try {
+    const osmd = new OpenSheetMusicDisplay(host, {
+      backend: "canvas",
+      autoResize: false,
+      drawTitle: false,
+      drawSubtitle: false,
+      drawComposer: false,
+      drawLyricist: false,
+      drawPartNames: false
+    });
+    await osmd.load(xml);
+    if (opts?.bars) {
+      osmd.setOptions({
+        drawFromMeasureNumber: opts.bars[0],
+        drawUpToMeasureNumber: opts.bars[1]
+      });
+    }
+    osmd.render();
+    const canvas = host.querySelector("canvas");
+    if (canvas) {
+      const { systems, measures, measureColumns, content } = extractGeometry(osmd, canvas, inkSumThreshold);
+      document.body.removeChild(host);
+      return { canvas, systems, measures, measureColumns, content };
+    }
+    const svg = host.querySelector("svg");
+    if (svg) {
+      const w = svg.clientWidth || hostWidth;
+      const h = svg.clientHeight || 300;
+      const svgStr = new XMLSerializer().serializeToString(svg);
+      const dataUrl = "data:image/svg+xml;base64," + btoa(unescape(encodeURIComponent(svgStr)));
+      const img = new Image();
+      await new Promise((resolve, reject) => {
+        img.onload = () => resolve();
+        img.onerror = () => reject(new Error("svg rasterize failed"));
+        img.src = dataUrl;
+      });
+      const out = document.createElement("canvas");
+      out.width = w;
+      out.height = h;
+      const c2d = out.getContext("2d");
+      if (!c2d) throw new Error("2d context unavailable");
+      c2d.fillStyle = paper;
+      c2d.fillRect(0, 0, w, h);
+      c2d.drawImage(img, 0, 0, w, h);
+      document.body.removeChild(host);
+      return {
+        canvas: out,
+        systems: [],
+        measures: [],
+        measureColumns: [],
+        content: { x: 0, y: 0, w, h }
+      };
+    }
+    document.body.removeChild(host);
+    throw new Error("OSMD produced neither canvas nor SVG");
+  } catch (e) {
+    if (host.parentNode) document.body.removeChild(host);
+    throw e;
+  }
+}
+async function createPromoSampler(opts) {
+  const release = opts?.release ?? 1.4;
+  const volumeDb = opts?.volumeDb ?? -2;
+  const keepAlive = opts?.keepAlive ?? false;
+  const Tone = await import("tone");
+  await Tone.start();
+  const sampler = createSalamanderSampler(Tone, {
+    urls: SALAMANDER_URLS_8,
+    baseUrl: SALAMANDER_CDN_BASE,
+    release,
+    volumeDb
+  });
+  const ctx = Tone.getContext().rawContext;
+  const mediaDest = ctx.createMediaStreamDestination();
+  sampler.connect(mediaDest);
+  if (keepAlive) {
+    const source = ctx.createConstantSource();
+    source.offset.value = 0;
+    source.connect(mediaDest);
+    source.start();
+  }
+  await Tone.loaded();
+  return {
+    Tone,
+    sampler,
+    getStream() {
+      return mediaDest.stream;
+    },
+    audioNow() {
+      return Tone.now();
+    },
+    stop() {
+      try {
+        sampler.releaseAll?.();
+      } catch {
+      }
+    }
+  };
+}
+export {
+  createPromoSampler,
+  midiDurationMs,
+  parseMidi,
+  renderNotation
+};
+//# sourceMappingURL=promo.js.map

package/dist/promo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/promo.ts"],"sourcesContent":["// Promo utilities — browser-only except for parseMidi/midiDurationMs which are\n// pure (no DOM).\n//\n// Exports:\n//   parseMidi / midiDurationMs — pure MIDI parser (no DOM; testable in Node)\n//   renderNotation             — OSMD canvas renderer (browser/OSMD only)\n//   createPromoSampler         — Tone.js sampler factory (browser/Tone only)\n//\n// Unit tests cover parseMidi (tests/midi.test.ts).\n// renderNotation and createPromoSampler are browser-only — consumers' dom tests\n// cover them (OSMD and Tone.js require a browser context).\n\n// ─── MIDI parser ──────────────────────────────────────────────────────────────\n// Moved verbatim from realmusictheory/site/src/lib/promo/midiDuration.ts.\n\nexport interface MidiNote {\n  midi: number;\n  startMs: number;\n  /** Audible duration in ms — extended while the sustain pedal is held. */\n  durMs: number;\n  /** 0..1 */\n  velocity: number;\n}\n\nexport interface ParsedMidi {\n  /** When the last notated note is released (pre-pedal-tail), in ms — paces the playhead. */\n  durationMs: number;\n  notes: MidiNote[];\n}\n\ninterface RawEvent {\n  tick: number;\n  kind: 'on' | 'off' | 'sustain' | 'tempo';\n  midi?: number;\n  velocity?: number;\n  on?: boolean; // sustain down?\n  us?: number;  // tempo in µs/beat\n}\n\nexport function parseMidi(buf: ArrayBuffer): ParsedMidi {\n  try {\n    const dv = new DataView(buf);\n    let p = 0;\n    const u8 = () => dv.getUint8(p++);\n    const u16 = () => { const v = dv.getUint16(p); p += 2; return v; };\n    const u32 = () => { const v = dv.getUint32(p); p += 4; return v; };\n\n    if (u32() !== 0x4d546864) return { durationMs: 0, notes: [] }; // 'MThd'\n    const headerLen = u32();\n    u16(); // format\n    const ntrk = u16();\n    const division = u16();\n    p = 8 + headerLen;\n    if (division & 0x8000) return { durationMs: 0, notes: [] }; // SMPTE — not handled\n    const tpq = division || 480;\n\n    const events: RawEvent[] = [];\n    for (let t = 0; t < ntrk; t++) {\n      if (p + 8 > dv.byteLength || u32() !== 0x4d54726b) break; // 'MTrk'\n      const len = u32();\n      const end = Math.min(p + len, dv.byteLength);\n      let tick = 0;\n      let running = 0;\n      while (p < end) {\n        let dt = 0, b: number;\n        do { b = u8(); dt = (dt << 7) | (b & 0x7f); } while (b & 0x80 && p < end);\n        tick += dt;\n        let status = dv.getUint8(p);\n        if (status & 0x80) { p++; running = status; } else { status = running; }\n        if (status === 0xff) {\n          const type = u8();\n          let l = 0, bb: number;\n          do { bb = u8(); l = (l << 7) | (bb & 0x7f); } while (bb & 0x80 && p < end);\n          if (type === 0x51 && l === 3) {\n            events.push({\n              tick,\n              kind: 'tempo',\n              us: (dv.getUint8(p) << 16) | (dv.getUint8(p + 1) << 8) | dv.getUint8(p + 2),\n            });\n          }\n          p += l;\n        } else if (status === 0xf0 || status === 0xf7) {\n          let l = 0, bb: number;\n          do { bb = u8(); l = (l << 7) | (bb & 0x7f); } while (bb & 0x80 && p < end);\n          p += l;\n        } else {\n          const hi = status & 0xf0;\n          if (hi === 0x90 || hi === 0x80) {\n            const midi = u8();\n            const vel = u8();\n            if (hi === 0x90 && vel > 0) events.push({ tick, kind: 'on', midi, velocity: vel / 127 });\n            else events.push({ tick, kind: 'off', midi });\n          } else if (hi === 0xb0) {\n            const cc = u8();\n            const val = u8();\n            if (cc === 64) events.push({ tick, kind: 'sustain', on: val >= 64 });\n          } else {\n            p += hi === 0xc0 || hi === 0xd0 ? 1 : 2;\n          }\n        }\n      }\n      p = end;\n    }\n\n    // tick → ms via the tempo map\n    const tempos = events.filter((e) => e.kind === 'tempo').sort((a, b) => a.tick - b.tick);\n    if (!tempos.length || tempos[0].tick > 0) tempos.unshift({ tick: 0, kind: 'tempo', us: 500000 });\n    const tickToMs = (tick: number): number => {\n      let ms = 0;\n      for (let i = 0; i < tempos.length; i++) {\n        const segStart = tempos[i].tick;\n        if (segStart >= tick) break;\n        const segEnd = i + 1 < tempos.length ? Math.min(tempos[i + 1].tick, tick) : tick;\n        ms += ((segEnd - segStart) / tpq) * ((tempos[i].us ?? 500000) / 1000);\n      }\n      return ms;\n    };\n\n    // Sustain spans (tick ranges where the pedal is down)\n    const sustainEvents = events.filter((e) => e.kind === 'sustain').sort((a, b) => a.tick - b.tick);\n    const pedalUpAfter = (tick: number): number | null => {\n      for (const s of sustainEvents) if (!s.on && s.tick >= tick) return s.tick;\n      return null;\n    };\n    const pedalDownAt = (tick: number): boolean => {\n      let down = false;\n      for (const s of sustainEvents) { if (s.tick > tick) break; down = !!s.on; }\n      return down;\n    };\n\n    // Pair note-ons with the next matching note-off\n    const ordered = events.filter((e) => e.kind === 'on' || e.kind === 'off').sort((a, b) => a.tick - b.tick);\n    const open: Record<number, { tick: number; vel: number }[]> = {};\n    const notes: MidiNote[] = [];\n    let lastOffTick = 0;\n    for (const e of ordered) {\n      const m = e.midi!;\n      if (e.kind === 'on') {\n        (open[m] ??= []).push({ tick: e.tick, vel: e.velocity ?? 0.7 });\n      } else {\n        const stack = open[m];\n        if (stack && stack.length) {\n          const start = stack.shift()!;\n          let endTick = e.tick;\n          lastOffTick = Math.max(lastOffTick, endTick);\n          // Extend while pedal is held past the note-off.\n          if (pedalDownAt(endTick)) {\n            const up = pedalUpAfter(endTick);\n            if (up != null) endTick = up;\n          }\n          const startMs = tickToMs(start.tick);\n          notes.push({\n            midi: m,\n            startMs,\n            durMs: Math.max(60, tickToMs(endTick) - startMs),\n            velocity: start.vel,\n          });\n        }\n      }\n    }\n\n    return { durationMs: tickToMs(lastOffTick), notes };\n  } catch {\n    return { durationMs: 0, notes: [] };\n  }\n}\n\n/** Total playback duration in ms (0 if unparseable). */\nexport function midiDurationMs(buf: ArrayBuffer): number {\n  return parseMidi(buf).durationMs;\n}\n\n// ─── Notation renderer ────────────────────────────────────────────────────────\n// Superset of RSR (stave-web-sightread/src/lib/promo/notation.ts) and RMT\n// (realmusictheory/site/src/lib/promo/notation.ts). Both per-staff measure boxes\n// (RSR) and per-measure column union boxes (RMT) are computed every render.\n//\n// Browser-only: requires document + opensheetmusicdisplay. No unit tests here —\n// consumers' dom tests cover renderNotation.\n\nexport interface Box {\n  x: number;\n  y: number;\n  w: number;\n  h: number;\n}\n\n/** One staff's slice of a measure, in canvas px. */\nexport interface StaffMeasureBox {\n  index: number; // 0-based measure position within the rendered range\n  staff: number; // 0 = top staff (RH/treble), 1 = bottom staff (LH/bass)\n  box: Box;\n  /** x of the measure's FIRST note (canvas px) — past any clef/key/time signature. */\n  noteStartX: number;\n}\n\n/** Per-measure column box: union across all staves for that measure, in canvas px. */\nexport interface MeasureColumnBox extends Box {\n  noteStartX: number;\n}\n\nexport interface RenderedNotation {\n  canvas: HTMLCanvasElement;\n  /** Per-row grand-staff system boxes in canvas px, top-to-bottom. */\n  systems: Box[];\n  /** Per-(measure, staff) boxes — RSR's geometry. */\n  measures: StaffMeasureBox[];\n  /** Per-measure column union across staves — RMT's geometry. */\n  measureColumns: MeasureColumnBox[];\n  /** Tight bounding box of all notation in canvas px (page whitespace cropped). */\n  content: Box;\n}\n\nexport interface RenderNotationOpts {\n  /** OSMD drawFrom/drawUpToMeasureNumber. Applied only when provided. */\n  bars?: [number, number];\n  /** Background fill colour. Default '#faf7f0' (RSR paper). */\n  paper?: string;\n  /** Pixel-sum threshold below which a pixel is counted as ink.\n   *  Default 690 (RSR: paper #faf7f0 sum ≈ 737). RMT uses 620. */\n  inkSumThreshold?: number;\n  /** Host div width in CSS px. Default 560 (RSR). RMT uses 620. */\n  hostWidth?: number;\n}\n\n/** Padded union of boxes, clamped to the canvas. */\nfunction unionBox(boxes: Box[], canvas: HTMLCanvasElement, pad: number): Box {\n  if (!boxes.length) return { x: 0, y: 0, w: canvas.width, h: canvas.height };\n  const minX = Math.min(...boxes.map((b) => b.x));\n  const minY = Math.min(...boxes.map((b) => b.y));\n  const maxX = Math.max(...boxes.map((b) => b.x + b.w));\n  const maxY = Math.max(...boxes.map((b) => b.y + b.h));\n  const x = Math.max(0, minX - pad);\n  const y = Math.max(0, minY - pad);\n  return {\n    x,\n    y,\n    w: Math.min(canvas.width, maxX + pad) - x,\n    h: Math.min(canvas.height, maxY + pad) - y,\n  };\n}\n\n/** Tight box around all non-paper pixels (notes, ledger lines, stems), padded. */\nfunction inkBoundingBox(canvas: HTMLCanvasElement, inkSumThreshold: number): Box | null {\n  try {\n    const ctx = canvas.getContext('2d', { willReadFrequently: true });\n    if (!ctx) return null;\n    const { width: W, height: H } = canvas;\n    const data = ctx.getImageData(0, 0, W, H).data;\n    let minX = W, minY = H, maxX = -1, maxY = -1;\n    const step = 2;\n    for (let y = 0; y < H; y += step) {\n      for (let x = 0; x < W; x += step) {\n        const i = (y * W + x) * 4;\n        if (data[i + 3] < 16) continue;\n        if (data[i] + data[i + 1] + data[i + 2] < inkSumThreshold) {\n          if (x < minX) minX = x;\n          if (x > maxX) maxX = x;\n          if (y < minY) minY = y;\n          if (y > maxY) maxY = y;\n        }\n      }\n    }\n    if (maxX < 0) return null;\n    const pad = 16;\n    const x = Math.max(0, minX - pad);\n    const y = Math.max(0, minY - pad);\n    return {\n      x,\n      y,\n      w: Math.min(W, maxX + pad) - x,\n      h: Math.min(H, maxY + pad) - y,\n    };\n  } catch {\n    return null;\n  }\n}\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\nfunction extractGeometry(\n  osmd: any,\n  canvas: HTMLCanvasElement,\n  inkSumThreshold: number,\n): { systems: Box[]; measures: StaffMeasureBox[]; measureColumns: MeasureColumnBox[]; content: Box } {\n  const full: Box = { x: 0, y: 0, w: canvas.width, h: canvas.height };\n  try {\n    const graphic: any = osmd.GraphicSheet;\n    const page: any = graphic?.MusicPages?.[0];\n    const pageW: number = page?.PositionAndShape?.Size?.width;\n    const musicSystems: any[] = page?.MusicSystems ?? [];\n    if (!pageW || !musicSystems.length) return { systems: [], measures: [], measureColumns: [], content: full };\n\n    // OSMD units → canvas px\n    const f = canvas.width / pageW;\n    const toBox = (pas: any): Box | null => {\n      const p = pas?.AbsolutePosition;\n      const sz = pas?.Size;\n      if (!p || !sz) return null;\n      return { x: p.x * f, y: p.y * f, w: sz.width * f, h: sz.height * f };\n    };\n\n    const systems: Box[] = musicSystems\n      .map((s) => toBox(s?.PositionAndShape))\n      .filter((b): b is Box => !!b && b.w > 1 && b.h > 1)\n      .sort((a, b) => a.y - b.y);\n    if (!systems.length) return { systems: [], measures: [], measureColumns: [], content: full };\n\n    const measureList: any[][] = graphic?.MeasureList ?? [];\n\n    // RSR geometry: per-(measure, staff) individual boxes\n    const measures: StaffMeasureBox[] = [];\n    measureList.forEach((staves, index) => {\n      (staves ?? []).forEach((m: any, staff: number) => {\n        const box = toBox(m?.PositionAndShape);\n        if (box && box.w > 1 && box.h > 1) {\n          const seX = (m?.staffEntries ?? [])[0]?.PositionAndShape?.AbsolutePosition?.x;\n          const noteStartX = typeof seX === 'number' ? seX * f : box.x;\n          measures.push({ index, staff, box, noteStartX });\n        }\n      });\n    });\n\n    // RMT geometry: per-measure column boxes (union across staves)\n    const measureColumns: MeasureColumnBox[] = measureList\n      .map((staves) => {\n        const arr = staves ?? [];\n        const boxes = arr\n          .map((m: any) => toBox(m?.PositionAndShape))\n          .filter((b: Box | null): b is Box => !!b && b.w > 1 && b.h > 1);\n        if (!boxes.length) return null;\n        const x0 = Math.min(...boxes.map((b) => b.x));\n        const y0 = Math.min(...boxes.map((b) => b.y));\n        const x1 = Math.max(...boxes.map((b) => b.x + b.w));\n        const y1 = Math.max(...boxes.map((b) => b.y + b.h));\n        // First note x across all staves; clamped into the column box\n        let nx = Infinity;\n        for (const m of arr) {\n          const seX = (m?.staffEntries ?? [])[0]?.PositionAndShape?.AbsolutePosition?.x;\n          if (typeof seX === 'number') nx = Math.min(nx, seX * f);\n        }\n        const noteStartX = Number.isFinite(nx) ? Math.max(x0, Math.min(nx, x1)) : x0;\n        return { x: x0, y: y0, w: x1 - x0, h: y1 - y0, noteStartX };\n      })\n      .filter((b): b is MeasureColumnBox => !!b);\n\n    const content = inkBoundingBox(canvas, inkSumThreshold) ?? unionBox(systems, canvas, 14);\n    return { systems, measures, measureColumns, content };\n  } catch {\n    return { systems: [], measures: [], measureColumns: [], content: full };\n  }\n}\n/* eslint-enable @typescript-eslint/no-explicit-any */\n\n/** Render a MusicXML string to a detached canvas + geometry.\n *  Browser-only (requires document + opensheetmusicdisplay dynamic import). */\nexport async function renderNotation(\n  xml: string,\n  opts?: RenderNotationOpts,\n): Promise<RenderedNotation> {\n  const paper = opts?.paper ?? '#faf7f0';\n  const inkSumThreshold = opts?.inkSumThreshold ?? 690;\n  const hostWidth = opts?.hostWidth ?? 560;\n\n  // Literal dynamic import: consumers' bundlers (Vite/Rollup) must be able to\n  // statically see the specifier to resolve + code-split it — a variable\n  // specifier would reach the browser as a bare import and fail at runtime.\n  const { OpenSheetMusicDisplay } = await import('opensheetmusicdisplay');\n\n  const host = document.createElement('div');\n  host.style.cssText = `position:fixed;left:-9999px;top:0;width:${hostWidth}px;background:${paper};`;\n  document.body.appendChild(host);\n\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const osmd: any = new OpenSheetMusicDisplay(host, {\n      backend: 'canvas',\n      autoResize: false,\n      drawTitle: false,\n      drawSubtitle: false,\n      drawComposer: false,\n      drawLyricist: false,\n      drawPartNames: false,\n    });\n\n    await osmd.load(xml);\n\n    // Apply bar range only when provided (RSR's drawFrom/drawUpTo).\n    if (opts?.bars) {\n      osmd.setOptions({\n        drawFromMeasureNumber: opts.bars[0],\n        drawUpToMeasureNumber: opts.bars[1],\n      } as never);\n    }\n\n    osmd.render();\n\n    const canvas = host.querySelector('canvas');\n    if (canvas) {\n      const { systems, measures, measureColumns, content } = extractGeometry(osmd, canvas, inkSumThreshold);\n      document.body.removeChild(host);\n      return { canvas, systems, measures, measureColumns, content };\n    }\n\n    // SVG fallback: rasterize into a canvas so callers always get a canvas.\n    const svg = host.querySelector('svg');\n    if (svg) {\n      const w = svg.clientWidth || hostWidth;\n      const h = svg.clientHeight || 300;\n      const svgStr = new XMLSerializer().serializeToString(svg);\n      const dataUrl = 'data:image/svg+xml;base64,' + btoa(unescape(encodeURIComponent(svgStr)));\n      const img = new Image();\n      await new Promise<void>((resolve, reject) => {\n        img.onload = () => resolve();\n        img.onerror = () => reject(new Error('svg rasterize failed'));\n        img.src = dataUrl;\n      });\n      const out = document.createElement('canvas');\n      out.width = w;\n      out.height = h;\n      const c2d = out.getContext('2d');\n      if (!c2d) throw new Error('2d context unavailable');\n      c2d.fillStyle = paper;\n      c2d.fillRect(0, 0, w, h);\n      c2d.drawImage(img, 0, 0, w, h);\n      document.body.removeChild(host);\n      return {\n        canvas: out,\n        systems: [],\n        measures: [],\n        measureColumns: [],\n        content: { x: 0, y: 0, w, h },\n      };\n    }\n\n    document.body.removeChild(host);\n    throw new Error('OSMD produced neither canvas nor SVG');\n  } catch (e) {\n    if (host.parentNode) document.body.removeChild(host);\n    throw e;\n  }\n}\n\n// ─── Promo sampler ────────────────────────────────────────────────────────────\n// The shared Tone.js setup prefix under both apps' createPromoAudio.\n// Scheduling (playEvents / playMidi / playWindowSolo / playForeground) stays\n// in each app.\n//\n// Browser-only: requires Tone.js dynamic import. No unit tests here —\n// consumers' dom tests cover createPromoSampler.\n\nimport { createSalamanderSampler } from './audioHelpers';\nimport { SALAMANDER_CDN_BASE, SALAMANDER_URLS_8 } from './salamander';\n\nexport interface PromoSampler {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  Tone: any; // typeof Tone — typed loose like audioHelpers.ts does for Tone\n  sampler: unknown; // Tone.Sampler; typed loose like audioHelpers\n  getStream(): MediaStream;\n  /** Current audio-clock time in seconds (Tone.now()). */\n  audioNow(): number;\n  /** releaseAll on the sampler; safe no-op on failure. */\n  stop(): void;\n}\n\nexport async function createPromoSampler(opts?: {\n  /** Feed a 0-value ConstantSource into the capture stream so the recorder's\n   *  audio track is live from t=0 (silent intro scenes aren't dropped).\n   *  Default false (RSR behavior). RMT passes true. */\n  keepAlive?: boolean;\n  /** Sampler release time in seconds. Default 1.4. */\n  release?: number;\n  /** Sampler volume in dB. Default -2. */\n  volumeDb?: number;\n}): Promise<PromoSampler> {\n  const release = opts?.release ?? 1.4;\n  const volumeDb = opts?.volumeDb ?? -2;\n  const keepAlive = opts?.keepAlive ?? false;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const Tone = (await import('tone')) as any;\n  await Tone.start();\n\n  const sampler = createSalamanderSampler(Tone, {\n    urls: SALAMANDER_URLS_8,\n    baseUrl: SALAMANDER_CDN_BASE,\n    release,\n    volumeDb,\n  });\n\n  // Capture tap on the raw context\n  const ctx = Tone.getContext().rawContext as AudioContext;\n  const mediaDest = ctx.createMediaStreamDestination();\n  sampler.connect(mediaDest);\n\n  // Optional: keep the audio track alive from t=0 so the recorder doesn't drop\n  // silent intro scenes. RMT uses this; RSR does not.\n  if (keepAlive) {\n    const source = ctx.createConstantSource();\n    source.offset.value = 0;\n    source.connect(mediaDest);\n    source.start();\n  }\n\n  await Tone.loaded();\n\n  return {\n    Tone,\n    sampler,\n    getStream(): MediaStream {\n      return mediaDest.stream;\n    },\n    audioNow(): number {\n      return Tone.now();\n    },\n    stop(): void {\n      try {\n        (sampler as unknown as { releaseAll?: () => void }).releaseAll?.();\n      } catch {\n        /* no-op */\n      }\n    },\n  };\n}\n"],"mappings":"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","names":["y","x"]}

package/dist/server.d.ts

@@ -0,0 +1,16 @@
+interface D1Like {
+    prepare(sql: string): {
+        bind(...values: unknown[]): {
+            run(): Promise<unknown>;
+        };
+        run(): Promise<unknown>;
+    };
+}
+/** Handle a POST /api/signup request.
+ *  @param request - incoming Request
+ *  @param db      - D1 database binding (or any D1Like)
+ *  @param appTag  - short app identifier, e.g. 'rsr' | 'ret'; prepended to
+ *                   the source field as `${appTag}:${source}`. */
+declare function handleSignup(request: Request, db: D1Like, appTag: string): Promise<Response>;
+
+export { type D1Like, handleSignup };

package/dist/server.js

@@ -0,0 +1,52 @@
+// src/server.ts
+var EMAIL_RE = /^[^@\s]+@[^@\s]+\.[^@\s]+$/;
+var tableReady = false;
+async function ensureTable(db) {
+  if (tableReady) return;
+  await db.prepare(
+    `create table if not exists signups (
+         email text primary key,
+         created_at text not null default (datetime('now')),
+         source text,
+         user_agent text
+       )`
+  ).run();
+  tableReady = true;
+}
+function json(data, status = 200) {
+  return new Response(JSON.stringify(data), {
+    status,
+    headers: { "content-type": "application/json", "cache-control": "no-store" }
+  });
+}
+async function handleSignup(request, db, appTag) {
+  if (request.method !== "POST") return json({ error: "method not allowed" }, 405);
+  let body;
+  try {
+    body = await request.json();
+  } catch {
+    return json({ error: "bad json" }, 400);
+  }
+  const email = String(body?.email ?? "").trim().toLowerCase();
+  if (!email || email.length > 254 || !EMAIL_RE.test(email))
+    return json({ error: "invalid email" }, 400);
+  const sub = body?.source ? String(body.source).slice(0, 40) : "landing";
+  const ua = (request.headers.get("user-agent") || "").slice(0, 300);
+  try {
+    await ensureTable(db);
+    await db.prepare(
+      `insert into signups (email, source, user_agent) values (?, ?, ?)
+         on conflict(email) do nothing`
+    ).bind(email, `${appTag}:${sub}`, ua).run();
+    return json({ ok: true });
+  } catch (e) {
+    return json(
+      { error: "db error: " + (e instanceof Error ? e.message : String(e)) },
+      500
+    );
+  }
+}
+export {
+  handleSignup
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["// Cloudflare D1 signup handler — shared between RSR (worker.js) and RET\n// (api/signup/+server.ts). Both apps were identical apart from the appTag prefix.\n//\n// POST {email, source?} → inserts into shared `signups` table.\n// 405 on non-POST, 400 bad json/email, 500 db error, 200 {ok:true} on success\n// (idempotent: repeat signups are silently ignored via ON CONFLICT DO NOTHING).\n\nexport interface D1Like {\n  prepare(sql: string): {\n    bind(...values: unknown[]): { run(): Promise<unknown> };\n    run(): Promise<unknown>;\n  };\n}\n\nconst EMAIL_RE = /^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$/;\n\n// Module-level guard: create the table once per isolate (cheap idempotent DDL;\n// no migration step required). Resets to false only when a new isolate spins up.\nlet tableReady = false;\n\nasync function ensureTable(db: D1Like): Promise<void> {\n  if (tableReady) return;\n  await db\n    .prepare(\n      `create table if not exists signups (\n         email text primary key,\n         created_at text not null default (datetime('now')),\n         source text,\n         user_agent text\n       )`,\n    )\n    .run();\n  tableReady = true;\n}\n\nfunction json(data: unknown, status = 200): Response {\n  return new Response(JSON.stringify(data), {\n    status,\n    headers: { 'content-type': 'application/json', 'cache-control': 'no-store' },\n  });\n}\n\n/** Handle a POST /api/signup request.\n *  @param request - incoming Request\n *  @param db      - D1 database binding (or any D1Like)\n *  @param appTag  - short app identifier, e.g. 'rsr' | 'ret'; prepended to\n *                   the source field as `${appTag}:${source}`. */\nexport async function handleSignup(\n  request: Request,\n  db: D1Like,\n  appTag: string,\n): Promise<Response> {\n  if (request.method !== 'POST') return json({ error: 'method not allowed' }, 405);\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let body: any;\n  try {\n    body = await request.json();\n  } catch {\n    return json({ error: 'bad json' }, 400);\n  }\n\n  const email = String(body?.email ?? '').trim().toLowerCase();\n  if (!email || email.length > 254 || !EMAIL_RE.test(email))\n    return json({ error: 'invalid email' }, 400);\n\n  const sub = body?.source ? String(body.source).slice(0, 40) : 'landing';\n  const ua = (request.headers.get('user-agent') || '').slice(0, 300);\n\n  try {\n    await ensureTable(db);\n    // Idempotent: a repeat signup is a no-op, still reported as success.\n    await db\n      .prepare(\n        `insert into signups (email, source, user_agent) values (?, ?, ?)\n         on conflict(email) do nothing`,\n      )\n      .bind(email, `${appTag}:${sub}`, ua)\n      .run();\n    return json({ ok: true });\n  } catch (e) {\n    return json(\n      { error: 'db error: ' + (e instanceof Error ? e.message : String(e)) },\n      500,\n    );\n  }\n}\n"],"mappings":";AAcA,IAAM,WAAW;AAIjB,IAAI,aAAa;AAEjB,eAAe,YAAY,IAA2B;AACpD,MAAI,WAAY;AAChB,QAAM,GACH;AAAA,IACC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMF,EACC,IAAI;AACP,eAAa;AACf;AAEA,SAAS,KAAK,MAAe,SAAS,KAAe;AACnD,SAAO,IAAI,SAAS,KAAK,UAAU,IAAI,GAAG;AAAA,IACxC;AAAA,IACA,SAAS,EAAE,gBAAgB,oBAAoB,iBAAiB,WAAW;AAAA,EAC7E,CAAC;AACH;AAOA,eAAsB,aACpB,SACA,IACA,QACmB;AACnB,MAAI,QAAQ,WAAW,OAAQ,QAAO,KAAK,EAAE,OAAO,qBAAqB,GAAG,GAAG;AAG/E,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,QAAQ,KAAK;AAAA,EAC5B,QAAQ;AACN,WAAO,KAAK,EAAE,OAAO,WAAW,GAAG,GAAG;AAAA,EACxC;AAEA,QAAM,QAAQ,OAAO,MAAM,SAAS,EAAE,EAAE,KAAK,EAAE,YAAY;AAC3D,MAAI,CAAC,SAAS,MAAM,SAAS,OAAO,CAAC,SAAS,KAAK,KAAK;AACtD,WAAO,KAAK,EAAE,OAAO,gBAAgB,GAAG,GAAG;AAE7C,QAAM,MAAM,MAAM,SAAS,OAAO,KAAK,MAAM,EAAE,MAAM,GAAG,EAAE,IAAI;AAC9D,QAAM,MAAM,QAAQ,QAAQ,IAAI,YAAY,KAAK,IAAI,MAAM,GAAG,GAAG;AAEjE,MAAI;AACF,UAAM,YAAY,EAAE;AAEpB,UAAM,GACH;AAAA,MACC;AAAA;AAAA,IAEF,EACC,KAAK,OAAO,GAAG,MAAM,IAAI,GAAG,IAAI,EAAE,EAClC,IAAI;AACP,WAAO,KAAK,EAAE,IAAI,KAAK,CAAC;AAAA,EAC1B,SAAS,GAAG;AACV,WAAO;AAAA,MACL,EAAE,OAAO,gBAAgB,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,GAAG;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/streak.d.ts

@@ -0,0 +1,24 @@
+interface Streak {
+    current: number;
+    longest: number;
+    last: string | null;
+}
+interface StreakStore {
+    get(): Streak;
+    /** Record activity for `today` (YYYY-MM-DD, default todayKey()). Idempotent per day.
+     *  Returns the new streak and whether it extended (grew day-over-day). */
+    record(today?: string): {
+        streak: Streak;
+        extended: boolean;
+    };
+    /** Live streak: unchanged if last active today/yesterday, else 0 (broken). */
+    live(today?: string): number;
+}
+/** Today as YYYY-MM-DD in local time. */
+declare function todayKey(): string;
+/** Create a streak store backed by `storage` (default: globalThis.localStorage,
+ *  SSR-safe — reads/writes are wrapped in try/catch; if storage is absent all
+ *  operations silently no-op / return defaults). */
+declare function createStreak(key: string, storage?: Pick<Storage, 'getItem' | 'setItem'>): StreakStore;
+
+export { type Streak, type StreakStore, createStreak, todayKey };

package/dist/streak.js

@@ -0,0 +1,83 @@
+// src/streak.ts
+function todayKey() {
+  const d = /* @__PURE__ */ new Date();
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${d.getFullYear()}-${m}-${day}`;
+}
+function dayDelta(a, b) {
+  return Math.round(
+    (Date.parse(b + "T00:00:00Z") - Date.parse(a + "T00:00:00Z")) / 864e5
+  );
+}
+var EMPTY = { current: 0, longest: 0, last: null };
+function parse(raw) {
+  if (!raw) return { ...EMPTY };
+  try {
+    const s = JSON.parse(raw);
+    if (typeof s.current === "number" && typeof s.longest === "number") return s;
+  } catch {
+  }
+  return { ...EMPTY };
+}
+function createStreak(key, storage) {
+  function getStorage() {
+    if (storage) return storage;
+    try {
+      const ls = globalThis.localStorage;
+      return ls ?? null;
+    } catch {
+      return null;
+    }
+  }
+  function read() {
+    try {
+      const store = getStorage();
+      return parse(store?.getItem(key) ?? null);
+    } catch {
+      return { ...EMPTY };
+    }
+  }
+  function write(s) {
+    try {
+      getStorage()?.setItem(key, JSON.stringify(s));
+    } catch {
+    }
+  }
+  return {
+    get() {
+      return read();
+    },
+    record(today) {
+      const t = today ?? todayKey();
+      const prev = read();
+      if (prev.last === t) return { streak: prev, extended: false };
+      let current;
+      if (prev.last && dayDelta(prev.last, t) === 1) {
+        current = prev.current + 1;
+      } else {
+        current = 1;
+      }
+      const next = {
+        current,
+        longest: Math.max(prev.longest, current),
+        last: t
+      };
+      write(next);
+      const extended = next.current > prev.current;
+      return { streak: next, extended };
+    },
+    live(today) {
+      const t = today ?? todayKey();
+      const s = read();
+      if (!s.last) return 0;
+      const delta = dayDelta(s.last, t);
+      return delta <= 1 ? s.current : 0;
+    }
+  };
+}
+export {
+  createStreak,
+  todayKey
+};
+//# sourceMappingURL=streak.js.map

package/dist/streak.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/streak.ts"],"sourcesContent":["// Streak tracker — localStorage-backed, SSR-safe (no-op when storage is\n// unavailable). Storage shape: { current, longest, last } matches RSR's\n// existing stave.streak.v1 key so RSR migrates for free.\n\nexport interface Streak {\n  current: number;\n  longest: number;\n  last: string | null;\n}\n\nexport interface StreakStore {\n  get(): Streak;\n  /** Record activity for `today` (YYYY-MM-DD, default todayKey()). Idempotent per day.\n   *  Returns the new streak and whether it extended (grew day-over-day). */\n  record(today?: string): { streak: Streak; extended: boolean };\n  /** Live streak: unchanged if last active today/yesterday, else 0 (broken). */\n  live(today?: string): number;\n}\n\n/** Today as YYYY-MM-DD in local time. */\nexport function todayKey(): string {\n  const d = new Date();\n  const m = String(d.getMonth() + 1).padStart(2, '0');\n  const day = String(d.getDate()).padStart(2, '0');\n  return `${d.getFullYear()}-${m}-${day}`;\n}\n\n/** Days between two YYYY-MM-DD strings (b − a) via UTC midnight arithmetic.\n *  Uses UTC-midnight parse so there is no DST ambiguity. */\nfunction dayDelta(a: string, b: string): number {\n  return Math.round(\n    (Date.parse(b + 'T00:00:00Z') - Date.parse(a + 'T00:00:00Z')) / 86_400_000,\n  );\n}\n\nconst EMPTY: Streak = { current: 0, longest: 0, last: null };\n\nfunction parse(raw: string | null): Streak {\n  if (!raw) return { ...EMPTY };\n  try {\n    const s = JSON.parse(raw) as Streak;\n    if (typeof s.current === 'number' && typeof s.longest === 'number') return s;\n  } catch { /* ignore */ }\n  return { ...EMPTY };\n}\n\n/** Create a streak store backed by `storage` (default: globalThis.localStorage,\n *  SSR-safe — reads/writes are wrapped in try/catch; if storage is absent all\n *  operations silently no-op / return defaults). */\nexport function createStreak(\n  key: string,\n  storage?: Pick<Storage, 'getItem' | 'setItem'>,\n): StreakStore {\n  function getStorage(): Pick<Storage, 'getItem' | 'setItem'> | null {\n    if (storage) return storage;\n    // SSR-safe lazy access — globalThis.localStorage is undefined in Node.\n    try {\n      const ls = (globalThis as unknown as { localStorage?: Storage }).localStorage;\n      return ls ?? null;\n    } catch {\n      return null;\n    }\n  }\n\n  function read(): Streak {\n    try {\n      const store = getStorage();\n      return parse(store?.getItem(key) ?? null);\n    } catch {\n      return { ...EMPTY };\n    }\n  }\n\n  function write(s: Streak): void {\n    try {\n      getStorage()?.setItem(key, JSON.stringify(s));\n    } catch { /* no-op */ }\n  }\n\n  return {\n    get(): Streak {\n      return read();\n    },\n\n    record(today?: string): { streak: Streak; extended: boolean } {\n      const t = today ?? todayKey();\n      const prev = read();\n\n      // Idempotent: already recorded today.\n      if (prev.last === t) return { streak: prev, extended: false };\n\n      let current: number;\n      if (prev.last && dayDelta(prev.last, t) === 1) {\n        current = prev.current + 1;\n      } else {\n        current = 1;\n      }\n\n      const next: Streak = {\n        current,\n        longest: Math.max(prev.longest, current),\n        last: t,\n      };\n      write(next);\n\n      // extended = streak grew day-over-day: next > prev.current\n      // This matches RET's `next > prev.streakDays` analytics gate.\n      // A reset to 1 from 0 IS growth (1 > 0 = true); a reset from 2 is not (1 > 2 = false).\n      const extended = next.current > prev.current;\n\n      return { streak: next, extended };\n    },\n\n    live(today?: string): number {\n      const t = today ?? todayKey();\n      const s = read();\n      if (!s.last) return 0;\n      const delta = dayDelta(s.last, t);\n      // Still alive if active today (delta=0) or yesterday (delta=1).\n      return delta <= 1 ? s.current : 0;\n    },\n  };\n}\n"],"mappings":";AAoBO,SAAS,WAAmB;AACjC,QAAM,IAAI,oBAAI,KAAK;AACnB,QAAM,IAAI,OAAO,EAAE,SAAS,IAAI,CAAC,EAAE,SAAS,GAAG,GAAG;AAClD,QAAM,MAAM,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,GAAG,GAAG;AAC/C,SAAO,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,GAAG;AACvC;AAIA,SAAS,SAAS,GAAW,GAAmB;AAC9C,SAAO,KAAK;AAAA,KACT,KAAK,MAAM,IAAI,YAAY,IAAI,KAAK,MAAM,IAAI,YAAY,KAAK;AAAA,EAClE;AACF;AAEA,IAAM,QAAgB,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,KAAK;AAE3D,SAAS,MAAM,KAA4B;AACzC,MAAI,CAAC,IAAK,QAAO,EAAE,GAAG,MAAM;AAC5B,MAAI;AACF,UAAM,IAAI,KAAK,MAAM,GAAG;AACxB,QAAI,OAAO,EAAE,YAAY,YAAY,OAAO,EAAE,YAAY,SAAU,QAAO;AAAA,EAC7E,QAAQ;AAAA,EAAe;AACvB,SAAO,EAAE,GAAG,MAAM;AACpB;AAKO,SAAS,aACd,KACA,SACa;AACb,WAAS,aAA0D;AACjE,QAAI,QAAS,QAAO;AAEpB,QAAI;AACF,YAAM,KAAM,WAAqD;AACjE,aAAO,MAAM;AAAA,IACf,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAEA,WAAS,OAAe;AACtB,QAAI;AACF,YAAM,QAAQ,WAAW;AACzB,aAAO,MAAM,OAAO,QAAQ,GAAG,KAAK,IAAI;AAAA,IAC1C,QAAQ;AACN,aAAO,EAAE,GAAG,MAAM;AAAA,IACpB;AAAA,EACF;AAEA,WAAS,MAAM,GAAiB;AAC9B,QAAI;AACF,iBAAW,GAAG,QAAQ,KAAK,KAAK,UAAU,CAAC,CAAC;AAAA,IAC9C,QAAQ;AAAA,IAAc;AAAA,EACxB;AAEA,SAAO;AAAA,IACL,MAAc;AACZ,aAAO,KAAK;AAAA,IACd;AAAA,IAEA,OAAO,OAAuD;AAC5D,YAAM,IAAI,SAAS,SAAS;AAC5B,YAAM,OAAO,KAAK;AAGlB,UAAI,KAAK,SAAS,EAAG,QAAO,EAAE,QAAQ,MAAM,UAAU,MAAM;AAE5D,UAAI;AACJ,UAAI,KAAK,QAAQ,SAAS,KAAK,MAAM,CAAC,MAAM,GAAG;AAC7C,kBAAU,KAAK,UAAU;AAAA,MAC3B,OAAO;AACL,kBAAU;AAAA,MACZ;AAEA,YAAM,OAAe;AAAA,QACnB;AAAA,QACA,SAAS,KAAK,IAAI,KAAK,SAAS,OAAO;AAAA,QACvC,MAAM;AAAA,MACR;AACA,YAAM,IAAI;AAKV,YAAM,WAAW,KAAK,UAAU,KAAK;AAErC,aAAO,EAAE,QAAQ,MAAM,SAAS;AAAA,IAClC;AAAA,IAEA,KAAK,OAAwB;AAC3B,YAAM,IAAI,SAAS,SAAS;AAC5B,YAAM,IAAI,KAAK;AACf,UAAI,CAAC,EAAE,KAAM,QAAO;AACpB,YAAM,QAAQ,SAAS,EAAE,MAAM,CAAC;AAEhC,aAAO,SAAS,IAAI,EAAE,UAAU;AAAA,IAClC;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-music-packages/web-core",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "Shared music-theory + audio primitives for the music-suite web apps",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,6 +18,18 @@
     "./video": {
       "types": "./dist/video.d.ts",
       "import": "./dist/video.js"
+    },
+    "./promo": {
+      "types": "./dist/promo.d.ts",
+      "import": "./dist/promo.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./streak": {
+      "types": "./dist/streak.d.ts",
+      "import": "./dist/streak.js"
     }
   },
   "files": [
@@ -38,14 +50,19 @@
     "url": "git+https://github.com/e7mac/web-core.git"
   },
   "peerDependencies": {
+    "opensheetmusicdisplay": ">=1.8",
     "tone": ">=14"
   },
   "peerDependenciesMeta": {
     "tone": {
       "optional": true
+    },
+    "opensheetmusicdisplay": {
+      "optional": true
     }
   },
   "devDependencies": {
+    "opensheetmusicdisplay": "^1.9.9",
     "tone": "^15.1.22",
     "tsup": "^8.3.0",
     "typescript": "^5.6.0",