@real-music-packages/web-core 0.9.7 → 0.10.0

package/dist/audio.d.ts

@@ -145,11 +145,18 @@ interface SalamanderSamplerOpts {
     baseUrl: string;
     release: number;
     volumeDb?: number;
+    attack?: number;
     onload?: () => void;
     onerror?: (e: unknown) => void;
+    /** Route the sampler straight to the speakers. Default true (preserves the
+     *  inline behavior both engines had). Pass false to build a custom signal
+     *  chain off the sampler instead (e.g. the promo mastering bus). */
+    connectToDestination?: boolean;
 }
-/** Create a Salamander Tone.Sampler routed to destination. Mirrors the exact
- *  `new Tone.Sampler({...}).toDestination()` both engines did inline. */
+/** Create a Salamander Tone.Sampler. By default routed to destination, mirroring
+ *  the exact `new Tone.Sampler({...}).toDestination()` both engines did inline.
+ *  With `connectToDestination:false` it returns an unrouted sampler so the caller
+ *  can insert a mastering chain. */
 declare function createSalamanderSampler(Tone: ToneModule, opts: SalamanderSamplerOpts): any;
 /** Generate a Tone.Reverb, racing reverb.generate() against a timeout so it can
  *  never hang init on iOS. Returns the reverb if generated, else null. Caller

package/dist/audio.js

@@ -9,7 +9,7 @@ import {
   SALAMANDER_URLS_FULL,
   createSalamanderSampler,
   generateReverb
-} from "./chunk-BPL5LLQH.js";
+} from "./chunk-JVGAABTK.js";
 
 // src/engine.ts
 var browser = typeof window !== "undefined";

package/dist/{chunk-BPL5LLQH.js → chunk-JVGAABTK.js}

@@ -49,9 +49,11 @@ function createSalamanderSampler(Tone, opts) {
     urls: opts.urls,
     baseUrl: opts.baseUrl,
     release: opts.release,
+    attack: opts.attack,
     onload: opts.onload,
     onerror: opts.onerror
-  }).toDestination();
+  });
+  if (opts.connectToDestination !== false) sampler.toDestination();
   if (opts.volumeDb !== void 0) sampler.volume.value = opts.volumeDb;
   return sampler;
 }
@@ -71,4 +73,4 @@ export {
   createSalamanderSampler,
   generateReverb
 };
-//# sourceMappingURL=chunk-BPL5LLQH.js.map
+//# sourceMappingURL=chunk-JVGAABTK.js.map

package/dist/chunk-JVGAABTK.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  attack?: number;\n  onload?: () => void;\n  onerror?: (e: unknown) => void;\n  /** Route the sampler straight to the speakers. Default true (preserves the\n   *  inline behavior both engines had). Pass false to build a custom signal\n   *  chain off the sampler instead (e.g. the promo mastering bus). */\n  connectToDestination?: boolean;\n}\n\n/** Create a Salamander Tone.Sampler. By default routed to destination, mirroring\n *  the exact `new Tone.Sampler({...}).toDestination()` both engines did inline.\n *  With `connectToDestination:false` it returns an unrouted sampler so the caller\n *  can insert a mastering chain. */\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    attack: opts.attack,\n    onload: opts.onload,\n    onerror: opts.onerror,\n  });\n  if (opts.connectToDestination !== false) sampler.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;;;ACGO,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,QAAQ,KAAK;AAAA,IACb,SAAS,KAAK;AAAA,EAChB,CAAC;AACD,MAAI,KAAK,yBAAyB,MAAO,SAAQ,cAAc;AAC/D,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

@@ -61,20 +61,35 @@ interface PromoSampler {
     Tone: any;
     sampler: unknown;
     getStream(): MediaStream;
+    /** Master-bus analyser (post-chain, sink-only) for reactive visualizers, or
+     *  null if `analyser` wasn't requested. whozart's "listen" spectrum reads it. */
+    getAnalyser(): AnalyserNode | null;
     /** Current audio-clock time in seconds (Tone.now()). */
     audioNow(): number;
     /** releaseAll on the sampler; safe no-op on failure. */
     stop(): void;
 }
+/** Per-app tone shaping for the shared promo mastering bus. Ported from
+ *  whozart's audio-impl chain (the richest of the fleet); `reading` is a drier,
+ *  closer voicing so sight-reading notation stays legible note-to-note. Apps
+ *  pick one via `createPromoSampler({ voicing })`. */
+type PromoVoicing = 'concertHall' | 'reading' | 'dry';
 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. */
+    /** Override the voicing's sampler release time (seconds). */
     release?: number;
     /** Sampler volume in dB. Default -2. */
     volumeDb?: number;
+    /** Per-app tone shaping (see PromoVoicing). Default 'concertHall'. */
+    voicing?: PromoVoicing;
+    /** Use the full A0..C8 Salamander anchor set instead of the 8-anchor set —
+     *  fuller tone, more samples to fetch. Default false (8-anchor). */
+    fullSamples?: boolean;
+    /** Expose a master-bus analyser (for reactive visualizers). Default false. */
+    analyser?: boolean;
 }): Promise<PromoSampler>;
 
-export { type Box, type MeasureColumnBox, type MidiNote, type ParsedMidi, type PromoSampler, type RenderNotationOpts, type RenderedNotation, type StaffMeasureBox, createPromoSampler, midiDurationMs, parseMidi, renderNotation };
+export { type Box, type MeasureColumnBox, type MidiNote, type ParsedMidi, type PromoSampler, type PromoVoicing, type RenderNotationOpts, type RenderedNotation, type StaffMeasureBox, createPromoSampler, midiDurationMs, parseMidi, renderNotation };

package/dist/promo.js

@@ -1,8 +1,10 @@
 import {
   SALAMANDER_CDN_BASE,
   SALAMANDER_URLS_8,
-  createSalamanderSampler
-} from "./chunk-BPL5LLQH.js";
+  SALAMANDER_URLS_FULL,
+  createSalamanderSampler,
+  generateReverb
+} from "./chunk-JVGAABTK.js";
 
 // src/promo.ts
 function parseMidi(buf) {
@@ -318,21 +320,76 @@ async function renderNotation(xml, opts) {
     throw e;
   }
 }
+var PROMO_VOICINGS = {
+  // whozart's hall sound: long ringing release, lifted lows/air, gentle glue
+  // compression, wide stereo, a real-hall reverb tail.
+  concertHall: {
+    release: 1.8,
+    attack: 5e-3,
+    eq: { low: 1.5, mid: -1, high: 1.5, lowFrequency: 280, highFrequency: 4500 },
+    comp: { threshold: -18, ratio: 1.6, attack: 0.012, release: 0.3, knee: 18 },
+    widen: 0.3,
+    reverb: { decay: 3.5, preDelay: 0.04, wet: 0.22 }
+  },
+  // Sight-reading: shorter release + much drier/shorter reverb so consecutive
+  // notes don't smear into each other while the eye tracks the staff. Small
+  // presence bump in the mids for note-attack clarity, narrower stereo.
+  reading: {
+    release: 1.1,
+    attack: 4e-3,
+    eq: { low: 0.5, mid: 1, high: 1, lowFrequency: 280, highFrequency: 5e3 },
+    comp: { threshold: -16, ratio: 2, attack: 8e-3, release: 0.25, knee: 12 },
+    widen: 0.18,
+    reverb: { decay: 1.4, preDelay: 0.02, wet: 0.1 }
+  },
+  // Bone-dry — no reverb at all (e.g. a debugging/reference voicing).
+  dry: {
+    release: 1,
+    attack: 4e-3,
+    eq: { low: 0, mid: 0, high: 0, lowFrequency: 280, highFrequency: 4500 },
+    comp: { threshold: -14, ratio: 2, attack: 8e-3, release: 0.25, knee: 10 },
+    widen: 0,
+    reverb: { decay: 1, preDelay: 0, wet: 0 }
+  }
+};
 async function createPromoSampler(opts) {
-  const release = opts?.release ?? 1.4;
+  const voicing = PROMO_VOICINGS[opts?.voicing ?? "concertHall"];
+  const release = opts?.release ?? voicing.release;
   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,
+    urls: opts?.fullSamples ? SALAMANDER_URLS_FULL : SALAMANDER_URLS_8,
     baseUrl: SALAMANDER_CDN_BASE,
     release,
-    volumeDb
+    attack: voicing.attack,
+    volumeDb,
+    connectToDestination: false
   });
+  const eq = new Tone.EQ3(voicing.eq);
+  const compressor = new Tone.Compressor(voicing.comp);
+  const widener = new Tone.StereoWidener(voicing.widen);
+  const limiter = new Tone.Limiter(-1.5);
+  const reverb = voicing.reverb.wet > 0 ? await generateReverb(
+    Tone,
+    { decay: voicing.reverb.decay, wet: voicing.reverb.wet },
+    4e3
+  ) : null;
+  if (reverb) reverb.preDelay = voicing.reverb.preDelay;
+  const chainNodes = reverb ? [eq, compressor, widener, reverb, limiter] : [eq, compressor, widener, limiter];
+  sampler.chain(...chainNodes);
   const ctx = Tone.getContext().rawContext;
   const mediaDest = ctx.createMediaStreamDestination();
-  sampler.connect(mediaDest);
+  limiter.connect(mediaDest);
+  limiter.connect(Tone.getDestination());
+  let analyserNode = null;
+  if (opts?.analyser) {
+    analyserNode = ctx.createAnalyser();
+    analyserNode.fftSize = 2048;
+    analyserNode.smoothingTimeConstant = 0.8;
+    limiter.connect(analyserNode);
+  }
   if (keepAlive) {
     const source = ctx.createConstantSource();
     source.offset.value = 0;
@@ -346,6 +403,9 @@ async function createPromoSampler(opts) {
     getStream() {
       return mediaDest.stream;
     },
+    getAnalyser() {
+      return analyserNode;
+    },
     audioNow() {
       return Tone.now();
     },

package/dist/promo.js.map

@@ -1 +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"]}
+{"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, generateReverb } from './audioHelpers';\nimport { SALAMANDER_CDN_BASE, SALAMANDER_URLS_8, SALAMANDER_URLS_FULL } 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  /** Master-bus analyser (post-chain, sink-only) for reactive visualizers, or\n   *  null if `analyser` wasn't requested. whozart's \"listen\" spectrum reads it. */\n  getAnalyser(): AnalyserNode | null;\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\n/** Per-app tone shaping for the shared promo mastering bus. Ported from\n *  whozart's audio-impl chain (the richest of the fleet); `reading` is a drier,\n *  closer voicing so sight-reading notation stays legible note-to-note. Apps\n *  pick one via `createPromoSampler({ voicing })`. */\nexport type PromoVoicing = 'concertHall' | 'reading' | 'dry';\n\ninterface VoicingPreset {\n  release: number;\n  attack: number;\n  eq: { low: number; mid: number; high: number; lowFrequency: number; highFrequency: number };\n  comp: { threshold: number; ratio: number; attack: number; release: number; knee: number };\n  widen: number;\n  reverb: { decay: number; preDelay: number; wet: number };\n}\n\nconst PROMO_VOICINGS: Record<PromoVoicing, VoicingPreset> = {\n  // whozart's hall sound: long ringing release, lifted lows/air, gentle glue\n  // compression, wide stereo, a real-hall reverb tail.\n  concertHall: {\n    release: 1.8, attack: 0.005,\n    eq: { low: 1.5, mid: -1, high: 1.5, lowFrequency: 280, highFrequency: 4500 },\n    comp: { threshold: -18, ratio: 1.6, attack: 0.012, release: 0.3, knee: 18 },\n    widen: 0.30,\n    reverb: { decay: 3.5, preDelay: 0.04, wet: 0.22 },\n  },\n  // Sight-reading: shorter release + much drier/shorter reverb so consecutive\n  // notes don't smear into each other while the eye tracks the staff. Small\n  // presence bump in the mids for note-attack clarity, narrower stereo.\n  reading: {\n    release: 1.1, attack: 0.004,\n    eq: { low: 0.5, mid: 1, high: 1, lowFrequency: 280, highFrequency: 5000 },\n    comp: { threshold: -16, ratio: 2.0, attack: 0.008, release: 0.25, knee: 12 },\n    widen: 0.18,\n    reverb: { decay: 1.4, preDelay: 0.02, wet: 0.10 },\n  },\n  // Bone-dry — no reverb at all (e.g. a debugging/reference voicing).\n  dry: {\n    release: 1.0, attack: 0.004,\n    eq: { low: 0, mid: 0, high: 0, lowFrequency: 280, highFrequency: 4500 },\n    comp: { threshold: -14, ratio: 2.0, attack: 0.008, release: 0.25, knee: 10 },\n    widen: 0,\n    reverb: { decay: 1.0, preDelay: 0, wet: 0 },\n  },\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  /** Override the voicing's sampler release time (seconds). */\n  release?: number;\n  /** Sampler volume in dB. Default -2. */\n  volumeDb?: number;\n  /** Per-app tone shaping (see PromoVoicing). Default 'concertHall'. */\n  voicing?: PromoVoicing;\n  /** Use the full A0..C8 Salamander anchor set instead of the 8-anchor set —\n   *  fuller tone, more samples to fetch. Default false (8-anchor). */\n  fullSamples?: boolean;\n  /** Expose a master-bus analyser (for reactive visualizers). Default false. */\n  analyser?: boolean;\n}): Promise<PromoSampler> {\n  const voicing = PROMO_VOICINGS[opts?.voicing ?? 'concertHall'];\n  const release = opts?.release ?? voicing.release;\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  // Unrouted sampler — we build the mastering bus off it (don't send the dry\n  // sampler to the speakers, which would bypass the chain).\n  const sampler = createSalamanderSampler(Tone, {\n    urls: opts?.fullSamples ? SALAMANDER_URLS_FULL : SALAMANDER_URLS_8,\n    baseUrl: SALAMANDER_CDN_BASE,\n    release,\n    attack: voicing.attack,\n    volumeDb,\n    connectToDestination: false,\n  });\n\n  // Mastering bus (ported from whozart): EQ tilt → glue compressor → stereo\n  // widener → reverb → brick-wall limiter. Reverb is generated with a timeout\n  // fallback so a slow/again-failing IR can never hang the render; on failure\n  // the chain simply omits reverb.\n  const eq = new Tone.EQ3(voicing.eq);\n  const compressor = new Tone.Compressor(voicing.comp);\n  const widener = new Tone.StereoWidener(voicing.widen);\n  const limiter = new Tone.Limiter(-1.5);\n\n  const reverb =\n    voicing.reverb.wet > 0\n      ? await generateReverb(\n          Tone,\n          { decay: voicing.reverb.decay, wet: voicing.reverb.wet },\n          4000,\n        )\n      : null;\n  if (reverb) reverb.preDelay = voicing.reverb.preDelay;\n\n  // chain() wires node→node in order; tail node feeds the taps below.\n  const chainNodes = reverb ? [eq, compressor, widener, reverb, limiter] : [eq, compressor, widener, limiter];\n  sampler.chain(...chainNodes);\n\n  const ctx = Tone.getContext().rawContext as AudioContext;\n  const mediaDest = ctx.createMediaStreamDestination();\n  limiter.connect(mediaDest);\n  // Also monitor through the speakers so a non-headless preview is audible.\n  limiter.connect(Tone.getDestination());\n\n  // Optional master-bus analyser (sink-only — no onward connection so it can't\n  // double the signal). Drives whozart's reactive \"listen\" visualizer.\n  let analyserNode: AnalyserNode | null = null;\n  if (opts?.analyser) {\n    analyserNode = ctx.createAnalyser();\n    analyserNode.fftSize = 2048;\n    analyserNode.smoothingTimeConstant = 0.8;\n    limiter.connect(analyserNode);\n  }\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    getAnalyser(): AnalyserNode | null {\n      return analyserNode;\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":";;;;;;;;;AAuCO,SAAS,UAAU,KAA8B;AACtD,MAAI;AACF,UAAM,KAAK,IAAI,SAAS,GAAG;AAC3B,QAAI,IAAI;AACR,UAAM,KAAK,MAAM,GAAG,SAAS,GAAG;AAChC,UAAM,MAAM,MAAM;AAAE,YAAM,IAAI,GAAG,UAAU,CAAC;AAAG,WAAK;AAAG,aAAO;AAAA,IAAG;AACjE,UAAM,MAAM,MAAM;AAAE,YAAM,IAAI,GAAG,UAAU,CAAC;AAAG,WAAK;AAAG,aAAO;AAAA,IAAG;AAEjE,QAAI,IAAI,MAAM,WAAY,QAAO,EAAE,YAAY,GAAG,OAAO,CAAC,EAAE;AAC5D,UAAM,YAAY,IAAI;AACtB,QAAI;AACJ,UAAM,OAAO,IAAI;AACjB,UAAM,WAAW,IAAI;AACrB,QAAI,IAAI;AACR,QAAI,WAAW,MAAQ,QAAO,EAAE,YAAY,GAAG,OAAO,CAAC,EAAE;AACzD,UAAM,MAAM,YAAY;AAExB,UAAM,SAAqB,CAAC;AAC5B,aAAS,IAAI,GAAG,IAAI,MAAM,KAAK;AAC7B,UAAI,IAAI,IAAI,GAAG,cAAc,IAAI,MAAM,WAAY;AACnD,YAAM,MAAM,IAAI;AAChB,YAAM,MAAM,KAAK,IAAI,IAAI,KAAK,GAAG,UAAU;AAC3C,UAAI,OAAO;AACX,UAAI,UAAU;AACd,aAAO,IAAI,KAAK;AACd,YAAI,KAAK,GAAG;AACZ,WAAG;AAAE,cAAI,GAAG;AAAG,eAAM,MAAM,IAAM,IAAI;AAAA,QAAO,SAAS,IAAI,OAAQ,IAAI;AACrE,gBAAQ;AACR,YAAI,SAAS,GAAG,SAAS,CAAC;AAC1B,YAAI,SAAS,KAAM;AAAE;AAAK,oBAAU;AAAA,QAAQ,OAAO;AAAE,mBAAS;AAAA,QAAS;AACvE,YAAI,WAAW,KAAM;AACnB,gBAAM,OAAO,GAAG;AAChB,cAAI,IAAI,GAAG;AACX,aAAG;AAAE,iBAAK,GAAG;AAAG,gBAAK,KAAK,IAAM,KAAK;AAAA,UAAO,SAAS,KAAK,OAAQ,IAAI;AACtE,cAAI,SAAS,MAAQ,MAAM,GAAG;AAC5B,mBAAO,KAAK;AAAA,cACV;AAAA,cACA,MAAM;AAAA,cACN,IAAK,GAAG,SAAS,CAAC,KAAK,KAAO,GAAG,SAAS,IAAI,CAAC,KAAK,IAAK,GAAG,SAAS,IAAI,CAAC;AAAA,YAC5E,CAAC;AAAA,UACH;AACA,eAAK;AAAA,QACP,WAAW,WAAW,OAAQ,WAAW,KAAM;AAC7C,cAAI,IAAI,GAAG;AACX,aAAG;AAAE,iBAAK,GAAG;AAAG,gBAAK,KAAK,IAAM,KAAK;AAAA,UAAO,SAAS,KAAK,OAAQ,IAAI;AACtE,eAAK;AAAA,QACP,OAAO;AACL,gBAAM,KAAK,SAAS;AACpB,cAAI,OAAO,OAAQ,OAAO,KAAM;AAC9B,kBAAM,OAAO,GAAG;AAChB,kBAAM,MAAM,GAAG;AACf,gBAAI,OAAO,OAAQ,MAAM,EAAG,QAAO,KAAK,EAAE,MAAM,MAAM,MAAM,MAAM,UAAU,MAAM,IAAI,CAAC;AAAA,gBAClF,QAAO,KAAK,EAAE,MAAM,MAAM,OAAO,KAAK,CAAC;AAAA,UAC9C,WAAW,OAAO,KAAM;AACtB,kBAAM,KAAK,GAAG;AACd,kBAAM,MAAM,GAAG;AACf,gBAAI,OAAO,GAAI,QAAO,KAAK,EAAE,MAAM,MAAM,WAAW,IAAI,OAAO,GAAG,CAAC;AAAA,UACrE,OAAO;AACL,iBAAK,OAAO,OAAQ,OAAO,MAAO,IAAI;AAAA,UACxC;AAAA,QACF;AAAA,MACF;AACA,UAAI;AAAA,IACN;AAGA,UAAM,SAAS,OAAO,OAAO,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI;AACtF,QAAI,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,OAAO,EAAG,QAAO,QAAQ,EAAE,MAAM,GAAG,MAAM,SAAS,IAAI,IAAO,CAAC;AAC/F,UAAM,WAAW,CAAC,SAAyB;AACzC,UAAI,KAAK;AACT,eAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,cAAM,WAAW,OAAO,CAAC,EAAE;AAC3B,YAAI,YAAY,KAAM;AACtB,cAAM,SAAS,IAAI,IAAI,OAAO,SAAS,KAAK,IAAI,OAAO,IAAI,CAAC,EAAE,MAAM,IAAI,IAAI;AAC5E,eAAQ,SAAS,YAAY,QAAS,OAAO,CAAC,EAAE,MAAM,OAAU;AAAA,MAClE;AACA,aAAO;AAAA,IACT;AAGA,UAAM,gBAAgB,OAAO,OAAO,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI;AAC/F,UAAM,eAAe,CAAC,SAAgC;AACpD,iBAAW,KAAK,cAAe,KAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,KAAM,QAAO,EAAE;AACrE,aAAO;AAAA,IACT;AACA,UAAM,cAAc,CAAC,SAA0B;AAC7C,UAAI,OAAO;AACX,iBAAW,KAAK,eAAe;AAAE,YAAI,EAAE,OAAO,KAAM;AAAO,eAAO,CAAC,CAAC,EAAE;AAAA,MAAI;AAC1E,aAAO;AAAA,IACT;AAGA,UAAM,UAAU,OAAO,OAAO,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,SAAS,KAAK,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI;AACxG,UAAM,OAAwD,CAAC;AAC/D,UAAM,QAAoB,CAAC;AAC3B,QAAI,cAAc;AAClB,eAAW,KAAK,SAAS;AACvB,YAAM,IAAI,EAAE;AACZ,UAAI,EAAE,SAAS,MAAM;AACnB,SAAC,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,EAAE,YAAY,IAAI,CAAC;AAAA,MAChE,OAAO;AACL,cAAM,QAAQ,KAAK,CAAC;AACpB,YAAI,SAAS,MAAM,QAAQ;AACzB,gBAAM,QAAQ,MAAM,MAAM;AAC1B,cAAI,UAAU,EAAE;AAChB,wBAAc,KAAK,IAAI,aAAa,OAAO;AAE3C,cAAI,YAAY,OAAO,GAAG;AACxB,kBAAM,KAAK,aAAa,OAAO;AAC/B,gBAAI,MAAM,KAAM,WAAU;AAAA,UAC5B;AACA,gBAAM,UAAU,SAAS,MAAM,IAAI;AACnC,gBAAM,KAAK;AAAA,YACT,MAAM;AAAA,YACN;AAAA,YACA,OAAO,KAAK,IAAI,IAAI,SAAS,OAAO,IAAI,OAAO;AAAA,YAC/C,UAAU,MAAM;AAAA,UAClB,CAAC;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAEA,WAAO,EAAE,YAAY,SAAS,WAAW,GAAG,MAAM;AAAA,EACpD,QAAQ;AACN,WAAO,EAAE,YAAY,GAAG,OAAO,CAAC,EAAE;AAAA,EACpC;AACF;AAGO,SAAS,eAAe,KAA0B;AACvD,SAAO,UAAU,GAAG,EAAE;AACxB;AAwDA,SAAS,SAAS,OAAc,QAA2B,KAAkB;AAC3E,MAAI,CAAC,MAAM,OAAQ,QAAO,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,OAAO,OAAO,GAAG,OAAO,OAAO;AAC1E,QAAM,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9C,QAAM,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9C,QAAM,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,QAAM,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,QAAM,IAAI,KAAK,IAAI,GAAG,OAAO,GAAG;AAChC,QAAM,IAAI,KAAK,IAAI,GAAG,OAAO,GAAG;AAChC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,GAAG,KAAK,IAAI,OAAO,OAAO,OAAO,GAAG,IAAI;AAAA,IACxC,GAAG,KAAK,IAAI,OAAO,QAAQ,OAAO,GAAG,IAAI;AAAA,EAC3C;AACF;AAGA,SAAS,eAAe,QAA2B,iBAAqC;AACtF,MAAI;AACF,UAAM,MAAM,OAAO,WAAW,MAAM,EAAE,oBAAoB,KAAK,CAAC;AAChE,QAAI,CAAC,IAAK,QAAO;AACjB,UAAM,EAAE,OAAO,GAAG,QAAQ,EAAE,IAAI;AAChC,UAAM,OAAO,IAAI,aAAa,GAAG,GAAG,GAAG,CAAC,EAAE;AAC1C,QAAI,OAAO,GAAG,OAAO,GAAG,OAAO,IAAI,OAAO;AAC1C,UAAM,OAAO;AACb,aAASA,KAAI,GAAGA,KAAI,GAAGA,MAAK,MAAM;AAChC,eAASC,KAAI,GAAGA,KAAI,GAAGA,MAAK,MAAM;AAChC,cAAM,KAAKD,KAAI,IAAIC,MAAK;AACxB,YAAI,KAAK,IAAI,CAAC,IAAI,GAAI;AACtB,YAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,iBAAiB;AACzD,cAAIA,KAAI,KAAM,QAAOA;AACrB,cAAIA,KAAI,KAAM,QAAOA;AACrB,cAAID,KAAI,KAAM,QAAOA;AACrB,cAAIA,KAAI,KAAM,QAAOA;AAAA,QACvB;AAAA,MACF;AAAA,IACF;AACA,QAAI,OAAO,EAAG,QAAO;AACrB,UAAM,MAAM;AACZ,UAAM,IAAI,KAAK,IAAI,GAAG,OAAO,GAAG;AAChC,UAAM,IAAI,KAAK,IAAI,GAAG,OAAO,GAAG;AAChC,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,GAAG,KAAK,IAAI,GAAG,OAAO,GAAG,IAAI;AAAA,MAC7B,GAAG,KAAK,IAAI,GAAG,OAAO,GAAG,IAAI;AAAA,IAC/B;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,SAAS,gBACP,MACA,QACA,iBACmG;AACnG,QAAM,OAAY,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,OAAO,OAAO,GAAG,OAAO,OAAO;AAClE,MAAI;AACF,UAAM,UAAe,KAAK;AAC1B,UAAM,OAAY,SAAS,aAAa,CAAC;AACzC,UAAM,QAAgB,MAAM,kBAAkB,MAAM;AACpD,UAAM,eAAsB,MAAM,gBAAgB,CAAC;AACnD,QAAI,CAAC,SAAS,CAAC,aAAa,OAAQ,QAAO,EAAE,SAAS,CAAC,GAAG,UAAU,CAAC,GAAG,gBAAgB,CAAC,GAAG,SAAS,KAAK;AAG1G,UAAM,IAAI,OAAO,QAAQ;AACzB,UAAM,QAAQ,CAAC,QAAyB;AACtC,YAAM,IAAI,KAAK;AACf,YAAM,KAAK,KAAK;AAChB,UAAI,CAAC,KAAK,CAAC,GAAI,QAAO;AACtB,aAAO,EAAE,GAAG,EAAE,IAAI,GAAG,GAAG,EAAE,IAAI,GAAG,GAAG,GAAG,QAAQ,GAAG,GAAG,GAAG,SAAS,EAAE;AAAA,IACrE;AAEA,UAAM,UAAiB,aACpB,IAAI,CAAC,MAAM,MAAM,GAAG,gBAAgB,CAAC,EACrC,OAAO,CAAC,MAAgB,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,EAAE,IAAI,CAAC,EACjD,KAAK,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;AAC3B,QAAI,CAAC,QAAQ,OAAQ,QAAO,EAAE,SAAS,CAAC,GAAG,UAAU,CAAC,GAAG,gBAAgB,CAAC,GAAG,SAAS,KAAK;AAE3F,UAAM,cAAuB,SAAS,eAAe,CAAC;AAGtD,UAAM,WAA8B,CAAC;AACrC,gBAAY,QAAQ,CAAC,QAAQ,UAAU;AACrC,OAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,GAAQ,UAAkB;AAChD,cAAM,MAAM,MAAM,GAAG,gBAAgB;AACrC,YAAI,OAAO,IAAI,IAAI,KAAK,IAAI,IAAI,GAAG;AACjC,gBAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,kBAAkB,kBAAkB;AAC5E,gBAAM,aAAa,OAAO,QAAQ,WAAW,MAAM,IAAI,IAAI;AAC3D,mBAAS,KAAK,EAAE,OAAO,OAAO,KAAK,WAAW,CAAC;AAAA,QACjD;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAGD,UAAM,iBAAqC,YACxC,IAAI,CAAC,WAAW;AACf,YAAM,MAAM,UAAU,CAAC;AACvB,YAAM,QAAQ,IACX,IAAI,CAAC,MAAW,MAAM,GAAG,gBAAgB,CAAC,EAC1C,OAAO,CAAC,MAA4B,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,EAAE,IAAI,CAAC;AAChE,UAAI,CAAC,MAAM,OAAQ,QAAO;AAC1B,YAAM,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC5C,YAAM,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;AAC5C,YAAM,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAClD,YAAM,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAElD,UAAI,KAAK;AACT,iBAAW,KAAK,KAAK;AACnB,cAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,kBAAkB,kBAAkB;AAC5E,YAAI,OAAO,QAAQ,SAAU,MAAK,KAAK,IAAI,IAAI,MAAM,CAAC;AAAA,MACxD;AACA,YAAM,aAAa,OAAO,SAAS,EAAE,IAAI,KAAK,IAAI,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC,IAAI;AAC1E,aAAO,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,IAAI,WAAW;AAAA,IAC5D,CAAC,EACA,OAAO,CAAC,MAA6B,CAAC,CAAC,CAAC;AAE3C,UAAM,UAAU,eAAe,QAAQ,eAAe,KAAK,SAAS,SAAS,QAAQ,EAAE;AACvF,WAAO,EAAE,SAAS,UAAU,gBAAgB,QAAQ;AAAA,EACtD,QAAQ;AACN,WAAO,EAAE,SAAS,CAAC,GAAG,UAAU,CAAC,GAAG,gBAAgB,CAAC,GAAG,SAAS,KAAK;AAAA,EACxE;AACF;AAKA,eAAsB,eACpB,KACA,MAC2B;AAC3B,QAAM,QAAQ,MAAM,SAAS;AAC7B,QAAM,kBAAkB,MAAM,mBAAmB;AACjD,QAAM,YAAY,MAAM,aAAa;AAKrC,QAAM,EAAE,sBAAsB,IAAI,MAAM,OAAO,uBAAuB;AAEtE,QAAM,OAAO,SAAS,cAAc,KAAK;AACzC,OAAK,MAAM,UAAU,2CAA2C,SAAS,iBAAiB,KAAK;AAC/F,WAAS,KAAK,YAAY,IAAI;AAE9B,MAAI;AAEF,UAAM,OAAY,IAAI,sBAAsB,MAAM;AAAA,MAChD,SAAS;AAAA,MACT,YAAY;AAAA,MACZ,WAAW;AAAA,MACX,cAAc;AAAA,MACd,cAAc;AAAA,MACd,cAAc;AAAA,MACd,eAAe;AAAA,IACjB,CAAC;AAED,UAAM,KAAK,KAAK,GAAG;AAGnB,QAAI,MAAM,MAAM;AACd,WAAK,WAAW;AAAA,QACd,uBAAuB,KAAK,KAAK,CAAC;AAAA,QAClC,uBAAuB,KAAK,KAAK,CAAC;AAAA,MACpC,CAAU;AAAA,IACZ;AAEA,SAAK,OAAO;AAEZ,UAAM,SAAS,KAAK,cAAc,QAAQ;AAC1C,QAAI,QAAQ;AACV,YAAM,EAAE,SAAS,UAAU,gBAAgB,QAAQ,IAAI,gBAAgB,MAAM,QAAQ,eAAe;AACpG,eAAS,KAAK,YAAY,IAAI;AAC9B,aAAO,EAAE,QAAQ,SAAS,UAAU,gBAAgB,QAAQ;AAAA,IAC9D;AAGA,UAAM,MAAM,KAAK,cAAc,KAAK;AACpC,QAAI,KAAK;AACP,YAAM,IAAI,IAAI,eAAe;AAC7B,YAAM,IAAI,IAAI,gBAAgB;AAC9B,YAAM,SAAS,IAAI,cAAc,EAAE,kBAAkB,GAAG;AACxD,YAAM,UAAU,+BAA+B,KAAK,SAAS,mBAAmB,MAAM,CAAC,CAAC;AACxF,YAAM,MAAM,IAAI,MAAM;AACtB,YAAM,IAAI,QAAc,CAAC,SAAS,WAAW;AAC3C,YAAI,SAAS,MAAM,QAAQ;AAC3B,YAAI,UAAU,MAAM,OAAO,IAAI,MAAM,sBAAsB,CAAC;AAC5D,YAAI,MAAM;AAAA,MACZ,CAAC;AACD,YAAM,MAAM,SAAS,cAAc,QAAQ;AAC3C,UAAI,QAAQ;AACZ,UAAI,SAAS;AACb,YAAM,MAAM,IAAI,WAAW,IAAI;AAC/B,UAAI,CAAC,IAAK,OAAM,IAAI,MAAM,wBAAwB;AAClD,UAAI,YAAY;AAChB,UAAI,SAAS,GAAG,GAAG,GAAG,CAAC;AACvB,UAAI,UAAU,KAAK,GAAG,GAAG,GAAG,CAAC;AAC7B,eAAS,KAAK,YAAY,IAAI;AAC9B,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,SAAS,CAAC;AAAA,QACV,UAAU,CAAC;AAAA,QACX,gBAAgB,CAAC;AAAA,QACjB,SAAS,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE;AAAA,MAC9B;AAAA,IACF;AAEA,aAAS,KAAK,YAAY,IAAI;AAC9B,UAAM,IAAI,MAAM,sCAAsC;AAAA,EACxD,SAAS,GAAG;AACV,QAAI,KAAK,WAAY,UAAS,KAAK,YAAY,IAAI;AACnD,UAAM;AAAA,EACR;AACF;AA0CA,IAAM,iBAAsD;AAAA;AAAA;AAAA,EAG1D,aAAa;AAAA,IACX,SAAS;AAAA,IAAK,QAAQ;AAAA,IACtB,IAAI,EAAE,KAAK,KAAK,KAAK,IAAI,MAAM,KAAK,cAAc,KAAK,eAAe,KAAK;AAAA,IAC3E,MAAM,EAAE,WAAW,KAAK,OAAO,KAAK,QAAQ,OAAO,SAAS,KAAK,MAAM,GAAG;AAAA,IAC1E,OAAO;AAAA,IACP,QAAQ,EAAE,OAAO,KAAK,UAAU,MAAM,KAAK,KAAK;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA,EAIA,SAAS;AAAA,IACP,SAAS;AAAA,IAAK,QAAQ;AAAA,IACtB,IAAI,EAAE,KAAK,KAAK,KAAK,GAAG,MAAM,GAAG,cAAc,KAAK,eAAe,IAAK;AAAA,IACxE,MAAM,EAAE,WAAW,KAAK,OAAO,GAAK,QAAQ,MAAO,SAAS,MAAM,MAAM,GAAG;AAAA,IAC3E,OAAO;AAAA,IACP,QAAQ,EAAE,OAAO,KAAK,UAAU,MAAM,KAAK,IAAK;AAAA,EAClD;AAAA;AAAA,EAEA,KAAK;AAAA,IACH,SAAS;AAAA,IAAK,QAAQ;AAAA,IACtB,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,cAAc,KAAK,eAAe,KAAK;AAAA,IACtE,MAAM,EAAE,WAAW,KAAK,OAAO,GAAK,QAAQ,MAAO,SAAS,MAAM,MAAM,GAAG;AAAA,IAC3E,OAAO;AAAA,IACP,QAAQ,EAAE,OAAO,GAAK,UAAU,GAAG,KAAK,EAAE;AAAA,EAC5C;AACF;AAEA,eAAsB,mBAAmB,MAgBf;AACxB,QAAM,UAAU,eAAe,MAAM,WAAW,aAAa;AAC7D,QAAM,UAAU,MAAM,WAAW,QAAQ;AACzC,QAAM,WAAW,MAAM,YAAY;AACnC,QAAM,YAAY,MAAM,aAAa;AAGrC,QAAM,OAAQ,MAAM,OAAO,MAAM;AACjC,QAAM,KAAK,MAAM;AAIjB,QAAM,UAAU,wBAAwB,MAAM;AAAA,IAC5C,MAAM,MAAM,cAAc,uBAAuB;AAAA,IACjD,SAAS;AAAA,IACT;AAAA,IACA,QAAQ,QAAQ;AAAA,IAChB;AAAA,IACA,sBAAsB;AAAA,EACxB,CAAC;AAMD,QAAM,KAAK,IAAI,KAAK,IAAI,QAAQ,EAAE;AAClC,QAAM,aAAa,IAAI,KAAK,WAAW,QAAQ,IAAI;AACnD,QAAM,UAAU,IAAI,KAAK,cAAc,QAAQ,KAAK;AACpD,QAAM,UAAU,IAAI,KAAK,QAAQ,IAAI;AAErC,QAAM,SACJ,QAAQ,OAAO,MAAM,IACjB,MAAM;AAAA,IACJ;AAAA,IACA,EAAE,OAAO,QAAQ,OAAO,OAAO,KAAK,QAAQ,OAAO,IAAI;AAAA,IACvD;AAAA,EACF,IACA;AACN,MAAI,OAAQ,QAAO,WAAW,QAAQ,OAAO;AAG7C,QAAM,aAAa,SAAS,CAAC,IAAI,YAAY,SAAS,QAAQ,OAAO,IAAI,CAAC,IAAI,YAAY,SAAS,OAAO;AAC1G,UAAQ,MAAM,GAAG,UAAU;AAE3B,QAAM,MAAM,KAAK,WAAW,EAAE;AAC9B,QAAM,YAAY,IAAI,6BAA6B;AACnD,UAAQ,QAAQ,SAAS;AAEzB,UAAQ,QAAQ,KAAK,eAAe,CAAC;AAIrC,MAAI,eAAoC;AACxC,MAAI,MAAM,UAAU;AAClB,mBAAe,IAAI,eAAe;AAClC,iBAAa,UAAU;AACvB,iBAAa,wBAAwB;AACrC,YAAQ,QAAQ,YAAY;AAAA,EAC9B;AAIA,MAAI,WAAW;AACb,UAAM,SAAS,IAAI,qBAAqB;AACxC,WAAO,OAAO,QAAQ;AACtB,WAAO,QAAQ,SAAS;AACxB,WAAO,MAAM;AAAA,EACf;AAEA,QAAM,KAAK,OAAO;AAElB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,YAAyB;AACvB,aAAO,UAAU;AAAA,IACnB;AAAA,IACA,cAAmC;AACjC,aAAO;AAAA,IACT;AAAA,IACA,WAAmB;AACjB,aAAO,KAAK,IAAI;AAAA,IAClB;AAAA,IACA,OAAa;AACX,UAAI;AACF,QAAC,QAAmD,aAAa;AAAA,MACnE,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;","names":["y","x"]}

package/dist/video.d.ts

@@ -117,7 +117,15 @@ interface RevealSceneOpts {
     title: string;
     subtitle: string;
     initials?: string;
+    /** Composer portrait (already decoded) drawn clipped into the medallion. If
+     *  omitted/null, falls back to the initials badge. Load it with `loadPortrait`
+     *  so a cross-origin image (e.g. Wikimedia) doesn't taint the capture canvas. */
+    portrait?: HTMLImageElement | null;
+    /** Optional one-line fun fact wrapped below the subtitle (e.g. corpus
+     *  `fun_fact`). Trimmed to two lines. */
+    funFact?: string;
 }
+declare function loadPortrait(url?: string | null): Promise<HTMLImageElement | null>;
 declare function revealScene(theme: PromoTheme, opts: RevealSceneOpts): Scene;
 interface CtaSceneOpts {
     lines: string[];
@@ -125,4 +133,4 @@ interface CtaSceneOpts {
 declare function ctaScene(theme: PromoTheme, opts: CtaSceneOpts): Scene;
 declare function runPromoCapture(opts: PromoCaptureOpts, record?: (scenes: Scene[], o: RecordOpts) => Promise<Blob>): Promise<void>;
 
-export { type CtaSceneOpts, type HookSceneOpts, type PromoCaptureOpts, type PromoMeta, type PromoTheme, type RecordOpts, type RevealSceneOpts, SAFE_ZONE, type SafeBox, type Scene, ctaScene, drawBottomGradient, drawSafeGuides, hookScene, initials, pickMimeType, recordScenes, revealScene, runPromoCapture, safeBox, safeTitleBaseline, truncate };
+export { type CtaSceneOpts, type HookSceneOpts, type PromoCaptureOpts, type PromoMeta, type PromoTheme, type RecordOpts, type RevealSceneOpts, SAFE_ZONE, type SafeBox, type Scene, ctaScene, drawBottomGradient, drawSafeGuides, hookScene, initials, loadPortrait, pickMimeType, recordScenes, revealScene, runPromoCapture, safeBox, safeTitleBaseline, truncate };

package/dist/video.js

@@ -154,6 +154,46 @@ function hookScene(theme, opts) {
     }
   };
 }
+var _portraitCache = /* @__PURE__ */ new Map();
+function loadPortrait(url) {
+  if (!url) return Promise.resolve(null);
+  const cached = _portraitCache.get(url);
+  if (cached) return cached;
+  const p = new Promise((resolve) => {
+    if (typeof Image === "undefined") {
+      resolve(null);
+      return;
+    }
+    const img = new Image();
+    img.crossOrigin = "anonymous";
+    img.onload = () => resolve(img);
+    img.onerror = () => resolve(null);
+    img.src = url;
+  });
+  _portraitCache.set(url, p);
+  return p;
+}
+function wrapLines(ctx, text, maxW, maxLines) {
+  const words = text.split(/\s+/).filter(Boolean);
+  const lines = [];
+  let cur = "";
+  for (const w of words) {
+    const next = cur ? `${cur} ${w}` : w;
+    if (ctx.measureText(next).width > maxW && cur) {
+      lines.push(cur);
+      cur = w;
+      if (lines.length === maxLines - 1) break;
+    } else {
+      cur = next;
+    }
+  }
+  if (cur && lines.length < maxLines) lines.push(cur);
+  const used = lines.join(" ");
+  if (used.length < text.length && lines.length) {
+    lines[lines.length - 1] = truncate(lines[lines.length - 1] + "\u2026", 999);
+  }
+  return lines;
+}
 function revealScene(theme, opts) {
   return {
     durationMs: 2200,
@@ -171,13 +211,28 @@ function revealScene(theme, opts) {
       ctx.arc(cx, cy, r, 0, Math.PI * 2);
       ctx.fillStyle = theme.paper;
       ctx.fill();
+      if (opts.portrait) {
+        ctx.save();
+        ctx.beginPath();
+        ctx.arc(cx, cy, r - 3, 0, Math.PI * 2);
+        ctx.clip();
+        const img = opts.portrait;
+        const iw = img.naturalWidth || img.width || 1;
+        const ih = img.naturalHeight || img.height || 1;
+        const scale = Math.max(2 * (r - 3) / iw, 2 * (r - 3) / ih);
+        const dw = iw * scale;
+        const dh = ih * scale;
+        ctx.drawImage(img, cx - dw / 2, cy - dh / 2, dw, dh);
+        ctx.restore();
+      } else {
+        ctx.fillStyle = theme.ink;
+        ctx.font = `bold 76px ${theme.fontDisplay}`;
+        const badge = opts.initials ?? initials(opts.title);
+        ctx.fillText(badge, cx, cy + 27);
+      }
       ctx.lineWidth = 5;
       ctx.strokeStyle = theme.gold;
       ctx.stroke();
-      ctx.fillStyle = theme.ink;
-      ctx.font = `bold 76px ${theme.fontDisplay}`;
-      const badge = opts.initials ?? initials(opts.title);
-      ctx.fillText(badge, cx, cy + 27);
       const truncated = truncate(opts.title, 24);
       let fontSize = 80;
       ctx.font = `bold ${fontSize}px ${theme.fontDisplay}`;
@@ -190,6 +245,14 @@ function revealScene(theme, opts) {
       ctx.font = `italic 50px ${theme.fontBody}`;
       ctx.fillStyle = theme.sepia;
       ctx.fillText(opts.subtitle, cx, cy + r + 176);
+      if (opts.funFact) {
+        ctx.font = `34px ${theme.fontBody}`;
+        ctx.fillStyle = theme.sepia;
+        const lines = wrapLines(ctx, opts.funFact, b.w * 0.92, 2);
+        lines.forEach((line, i) => {
+          ctx.fillText(line, cx, cy + r + 246 + i * 44);
+        });
+      }
       ctx.globalAlpha = 1;
     }
   };
@@ -249,6 +312,7 @@ export {
   drawSafeGuides,
   hookScene,
   initials,
+  loadPortrait,
   pickMimeType,
   recordScenes,
   revealScene,

package/dist/video.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/video.ts"],"sourcesContent":["/**\n * Framework-agnostic promo video module.\n *\n * Provides:\n *  - PromoTheme — colour/font/brand tokens\n *  - Scene — {durationMs, draw, onEnter?}\n *  - recordScenes — rAF-based canvas capture → Blob (browser only)\n *  - hookScene / revealScene / ctaScene — scene builders (pure, unit-testable)\n *  - runPromoCapture — orchestrator with dependency-injected recorder\n *\n * Visual style ported from whozart/src/lib/promo.ts + video.ts.\n */\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface PromoTheme {\n  paper: string;\n  ink: string;\n  accent: string;\n  sepia: string;\n  gold: string;\n  fontDisplay: string;\n  fontBody: string;\n  brand: string;\n}\n\nexport interface Scene {\n  durationMs: number;\n  draw: (ctx: CanvasRenderingContext2D, t01: number) => void;\n  onEnter?: () => void;\n}\n\nexport interface RecordOpts {\n  audioStream: MediaStream;\n  width: number;\n  height: number;\n  fps?: number;\n  background?: string;\n  onProgress?: (p: { phase: string; progress01: number }) => void;\n}\n\nexport interface PromoMeta {\n  id?: string;\n  title?: string;\n  composer?: string;\n  [k: string]: unknown;\n}\n\nexport interface PromoCaptureOpts {\n  buildScenes: () => Scene[];\n  audioStream: MediaStream;\n  meta: PromoMeta;\n  width?: number;\n  height?: number;\n  fps?: number;\n  background?: string;\n  download?: boolean;\n}\n\n// ─── Safe zone (phone short-form UI) ─────────────────────────────────────────\n\n/**\n * Insets (fractions of frame) kept clear of TikTok/Reels/Shorts UI overlays.\n * `bottom: 0.28` puts the safe-box bottom at 0.72·H — TikTok's caption + right\n * action rail reach ~25–28% up, tighter than the old 0.20, and a posted RET clip\n * had its keyboard clipped at 0.20. `top: 0.15` clears TikTok's top tabs/search\n * row — measured from a real screenshot, the \"Find related content\" search bar\n * bottom sits at ~0.114·H, so 0.10 clashed and 0.13 cleared by only ~31px; 0.15\n * gives a comfortable ~73px. This is the SINGLE source of truth for both safe lines:\n * consumers anchor bottom content to `safeBox().bottom` and top titles to\n * `safeTitleBaseline()` instead of hardcoding. Verify any layout with `?safe=1`.\n */\nexport const SAFE_ZONE = { top: 0.15, bottom: 0.28, left: 0.06, right: 0.12 } as const;\n\nexport interface SafeBox {\n  left: number; right: number; top: number; bottom: number;\n  w: number; h: number; cx: number; cy: number;\n  /** Widest block centered at frame W/2 that still fits inside the box. */\n  centeredW: number;\n}\n\n/** The usable content rectangle for a W×H frame, in pixels. */\nexport function safeBox(W: number, H: number): SafeBox {\n  const left = W * SAFE_ZONE.left;\n  const right = W * (1 - SAFE_ZONE.right);\n  const top = H * SAFE_ZONE.top;\n  const bottom = H * (1 - SAFE_ZONE.bottom);\n  return {\n    left, right, top, bottom,\n    w: right - left, h: bottom - top,\n    cx: (left + right) / 2, cy: (top + bottom) / 2,\n    centeredW: 2 * Math.min(W / 2 - left, right - W / 2),\n  };\n}\n\n/**\n * Lowest first-line baseline (for an ALPHABETIC-baseline title of `size` px) that\n * keeps the title's cap-top inside the safe box top. Phone top chrome (TikTok/Reels\n * \"For You\" tabs + search) sits above `safeBox().top`, and an alphabetic baseline\n * draws glyphs ~0.8*size ABOVE the baseline — so a small `topY` silently breaches\n * the top. Apps clamp their top titles: `y = Math.max(topY, safeTitleBaseline(size, H))`.\n * Single source of truth for the top-safe line, mirroring `safeBox().bottom`.\n */\nexport function safeTitleBaseline(size: number, H: number): number {\n  return H * SAFE_ZONE.top + size * 0.8 + 4;\n}\n\n/** Debug overlay: dim the four unsafe margins + outline the safe box. */\nexport function drawSafeGuides(ctx: CanvasRenderingContext2D): void {\n  const W = ctx.canvas.width, H = ctx.canvas.height;\n  const b = safeBox(W, H);\n  ctx.save();\n  ctx.globalAlpha = 1;\n  ctx.fillStyle = 'rgba(220,40,40,0.35)';\n  ctx.fillRect(0, 0, W, b.top);                  // top\n  ctx.fillRect(0, b.bottom, W, H - b.bottom);    // bottom\n  ctx.fillRect(0, b.top, b.left, b.h);           // left\n  ctx.fillRect(b.right, b.top, W - b.right, b.h); // right (action rail)\n  ctx.strokeStyle = 'rgba(40,200,90,1)';\n  ctx.lineWidth = 6;\n  ctx.strokeRect(b.left, b.top, b.w, b.h);\n  ctx.restore();\n}\n\n// ─── MIME type picker ─────────────────────────────────────────────────────────\n\nexport function pickMimeType(): string {\n  const candidates = [\n    'video/webm;codecs=vp9,opus',\n    'video/webm;codecs=vp8,opus',\n    'video/webm',\n  ];\n  for (const t of candidates) {\n    if (typeof MediaRecorder !== 'undefined' && MediaRecorder.isTypeSupported(t)) return t;\n  }\n  return 'video/webm';\n}\n\n// ─── recordScenes ─────────────────────────────────────────────────────────────\n\nexport async function recordScenes(scenes: Scene[], opts: RecordOpts): Promise<Blob> {\n  const { audioStream, width, height, fps = 30, background = '#000000', onProgress } = opts;\n\n  const canvas = document.createElement('canvas');\n  canvas.width = width;\n  canvas.height = height;\n\n  const maybeCtx = canvas.getContext('2d');\n  if (!maybeCtx) throw new Error('Failed to get 2D context');\n  const ctx: CanvasRenderingContext2D = maybeCtx;\n\n  const videoStream = canvas.captureStream(fps);\n  const combined = new MediaStream([\n    ...videoStream.getVideoTracks(),\n    ...audioStream.getAudioTracks(),\n  ]);\n\n  const mimeType = pickMimeType();\n  const recorder = new MediaRecorder(combined, {\n    mimeType,\n    videoBitsPerSecond: 4_000_000,\n    audioBitsPerSecond: 128_000,\n  });\n\n  const chunks: Blob[] = [];\n  recorder.ondataavailable = (e) => {\n    if (e.data.size > 0) chunks.push(e.data);\n  };\n  const stopped = new Promise<void>((res) => {\n    recorder.onstop = () => res();\n  });\n\n  recorder.start();\n\n  const totalMs = scenes.reduce((s, sc) => s + sc.durationMs, 0);\n  const t0 = performance.now();\n\n  onProgress?.({ phase: 'capturing', progress01: 0 });\n\n  let sceneStart = 0;\n  let sceneIdx = 0;\n  let enteredScene = -1;\n\n  // Draw first frame immediately\n  ctx.fillStyle = background;\n  ctx.fillRect(0, 0, width, height);\n  scenes[0].draw(ctx, 0);\n\n  await new Promise<void>((resolve) => {\n    function tick() {\n      const now = performance.now() - t0;\n      if (now >= totalMs) {\n        setTimeout(resolve, 100);\n        return;\n      }\n\n      // Advance scene index\n      while (\n        sceneIdx < scenes.length - 1 &&\n        now - sceneStart >= scenes[sceneIdx].durationMs\n      ) {\n        sceneStart += scenes[sceneIdx].durationMs;\n        sceneIdx += 1;\n      }\n\n      const scene = scenes[sceneIdx];\n\n      // Fire onEnter once per scene\n      if (enteredScene !== sceneIdx) {\n        enteredScene = sceneIdx;\n        scene.onEnter?.();\n      }\n\n      const tInScene = (now - sceneStart) / scene.durationMs;\n\n      // Clear to background\n      ctx.fillStyle = background;\n      ctx.fillRect(0, 0, width, height);\n\n      scene.draw(ctx, Math.min(1, Math.max(0, tInScene)));\n\n      onProgress?.({\n        phase: 'capturing',\n        progress01: Math.min(0.95, now / totalMs),\n      });\n\n      requestAnimationFrame(tick);\n    }\n\n    requestAnimationFrame(tick);\n  });\n\n  onProgress?.({ phase: 'finalizing', progress01: 0.96 });\n  recorder.stop();\n  await stopped;\n\n  return new Blob(chunks, { type: mimeType });\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\nexport function truncate(s: string, max: number): string {\n  return s.length > max ? s.slice(0, max - 1).trimEnd() + '…' : s;\n}\n\nexport function initials(name: string): string {\n  return name\n    .split(/\\s+/)\n    .filter(Boolean)\n    .slice(0, 3)\n    .map((w) => w[0])\n    .join('')\n    .toUpperCase();\n}\n\n// ─── Scene builders ───────────────────────────────────────────────────────────\n\n/**\n * Dark gradient rising from the frame bottom (opaque-ish at the very bottom,\n * fading out by `heightFrac` up). TikTok overlays the view count bottom-left of\n * every profile-grid thumbnail in WHITE — on our light start screens it was\n * unreadable. Draw this after the background, before content.\n */\nexport function drawBottomGradient(\n  ctx: CanvasRenderingContext2D,\n  opts: { heightFrac?: number; maxAlpha?: number } = {},\n): void {\n  const W = ctx.canvas.width, H = ctx.canvas.height;\n  const heightFrac = opts.heightFrac ?? 0.30;\n  const maxAlpha = opts.maxAlpha ?? 0.45;\n  const top = H * (1 - heightFrac);\n  const g = ctx.createLinearGradient(0, top, 0, H);\n  g.addColorStop(0, \"rgba(0,0,0,0)\");\n  g.addColorStop(1, `rgba(0,0,0,${maxAlpha})`);\n  ctx.save();\n  ctx.fillStyle = g;\n  ctx.fillRect(0, top, W, H - top);\n  ctx.restore();\n}\n\nexport interface HookSceneOpts {\n  lines: string[];\n  brand?: string;\n}\n\nexport function hookScene(theme: PromoTheme, opts: HookSceneOpts): Scene {\n  return {\n    durationMs: 2000,\n    draw(ctx, _t01) {\n      const W = ctx.canvas.width;\n      const H = ctx.canvas.height;\n      // The hook is the profile-grid thumbnail; the bottom gradient keeps\n      // TikTok's white view-count overlay readable on light backdrops.\n      drawBottomGradient(ctx);\n      ctx.textAlign = 'center';\n      ctx.fillStyle = theme.ink;\n      ctx.font = `bold 88px ${theme.fontDisplay}`;\n      opts.lines.forEach((line, i) => {\n        ctx.fillText(line, W / 2, H * 0.42 + i * 104);\n      });\n      const brand = opts.brand ?? theme.brand;\n      ctx.font = `italic 38px ${theme.fontBody}`;\n      ctx.fillStyle = theme.sepia;\n      ctx.fillText(brand, W / 2, H * 0.42 + opts.lines.length * 104 + 12);\n    },\n  };\n}\n\nexport interface RevealSceneOpts {\n  title: string;\n  subtitle: string;\n  initials?: string;\n}\n\nexport function revealScene(theme: PromoTheme, opts: RevealSceneOpts): Scene {\n  return {\n    durationMs: 2200,\n    draw(ctx, t01) {\n      const W = ctx.canvas.width;\n      const H = ctx.canvas.height;\n      const b = safeBox(W, H);\n      const cx = W / 2;\n      // Anchor through the safe box; ~0.4286 of box height ≈ original H*0.40 (no visible shift at 1080×1920).\n      const cy = b.top + b.h * 0.4286;\n      const r = 92;\n      const k = Math.min(1, t01 * 1.4);\n      ctx.globalAlpha = k;\n      ctx.textAlign = 'center';\n\n      // Medallion circle (faint surface)\n      ctx.beginPath();\n      ctx.arc(cx, cy, r, 0, Math.PI * 2);\n      ctx.fillStyle = theme.paper;\n      ctx.fill();\n      ctx.lineWidth = 5;\n      ctx.strokeStyle = theme.gold;\n      ctx.stroke();\n\n      // Initials inside medallion\n      ctx.fillStyle = theme.ink;\n      ctx.font = `bold 76px ${theme.fontDisplay}`;\n      const badge = opts.initials ?? initials(opts.title);\n      ctx.fillText(badge, cx, cy + 27);\n\n      // Title (with font-size fallback if too wide)\n      const truncated = truncate(opts.title, 24);\n      let fontSize = 80;\n      ctx.font = `bold ${fontSize}px ${theme.fontDisplay}`;\n      if (ctx.measureText(truncated).width > W * 0.86) {\n        fontSize = 68;\n        ctx.font = `bold ${fontSize}px ${theme.fontDisplay}`;\n      }\n      ctx.fillStyle = theme.ink;\n      ctx.fillText(truncated, cx, cy + r + 110);\n\n      // Subtitle\n      ctx.font = `italic 50px ${theme.fontBody}`;\n      ctx.fillStyle = theme.sepia;\n      ctx.fillText(opts.subtitle, cx, cy + r + 176);\n\n      ctx.globalAlpha = 1;\n    },\n  };\n}\n\nexport interface CtaSceneOpts {\n  lines: string[];\n}\n\nexport function ctaScene(theme: PromoTheme, opts: CtaSceneOpts): Scene {\n  return {\n    durationMs: 2500,\n    draw(ctx, _t01) {\n      const W = ctx.canvas.width;\n      const H = ctx.canvas.height;\n      const b = safeBox(W, H);\n      // Safe-box-relative base ≈ original H*0.42 (no visible shift at 1080×1920).\n      const baseY = b.cy - 40;\n      ctx.textAlign = 'center';\n      if (opts.lines.length > 0) {\n        ctx.fillStyle = theme.ink;\n        ctx.font = `bold 66px ${theme.fontDisplay}`;\n        ctx.fillText(opts.lines[0], W / 2, baseY);\n      }\n      opts.lines.slice(1).forEach((line, i) => {\n        ctx.fillStyle = theme.accent;\n        ctx.font = `bold 72px ${theme.fontDisplay}`;\n        ctx.fillText(line, W / 2, baseY + 100 * (i + 1));\n      });\n    },\n  };\n}\n\n// ─── runPromoCapture ──────────────────────────────────────────────────────────\n\nexport async function runPromoCapture(\n  opts: PromoCaptureOpts,\n  record: (scenes: Scene[], o: RecordOpts) => Promise<Blob> = recordScenes,\n): Promise<void> {\n  const w = window as unknown as Record<string, unknown>;\n  w.__promoMeta = opts.meta;\n  try {\n    const blob = await record(opts.buildScenes(), {\n      audioStream: opts.audioStream,\n      width: opts.width ?? 1080,\n      height: opts.height ?? 1920,\n      fps: opts.fps,\n      background: opts.background,\n    });\n    const url = URL.createObjectURL(blob);\n    w.__promoBlobUrl = url;\n    if (opts.download !== false) {\n      const a = document.createElement('a');\n      a.href = url;\n      a.download = `promo-${opts.meta.id ?? 'clip'}.webm`;\n      document.body.appendChild(a);\n      a.click();\n    }\n    w.__promoReady = true;\n  } catch (e) {\n    w.__promoError = String(e);\n    throw e;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/video.ts"],"sourcesContent":["/**\n * Framework-agnostic promo video module.\n *\n * Provides:\n *  - PromoTheme — colour/font/brand tokens\n *  - Scene — {durationMs, draw, onEnter?}\n *  - recordScenes — rAF-based canvas capture → Blob (browser only)\n *  - hookScene / revealScene / ctaScene — scene builders (pure, unit-testable)\n *  - runPromoCapture — orchestrator with dependency-injected recorder\n *\n * Visual style ported from whozart/src/lib/promo.ts + video.ts.\n */\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface PromoTheme {\n  paper: string;\n  ink: string;\n  accent: string;\n  sepia: string;\n  gold: string;\n  fontDisplay: string;\n  fontBody: string;\n  brand: string;\n}\n\nexport interface Scene {\n  durationMs: number;\n  draw: (ctx: CanvasRenderingContext2D, t01: number) => void;\n  onEnter?: () => void;\n}\n\nexport interface RecordOpts {\n  audioStream: MediaStream;\n  width: number;\n  height: number;\n  fps?: number;\n  background?: string;\n  onProgress?: (p: { phase: string; progress01: number }) => void;\n}\n\nexport interface PromoMeta {\n  id?: string;\n  title?: string;\n  composer?: string;\n  [k: string]: unknown;\n}\n\nexport interface PromoCaptureOpts {\n  buildScenes: () => Scene[];\n  audioStream: MediaStream;\n  meta: PromoMeta;\n  width?: number;\n  height?: number;\n  fps?: number;\n  background?: string;\n  download?: boolean;\n}\n\n// ─── Safe zone (phone short-form UI) ─────────────────────────────────────────\n\n/**\n * Insets (fractions of frame) kept clear of TikTok/Reels/Shorts UI overlays.\n * `bottom: 0.28` puts the safe-box bottom at 0.72·H — TikTok's caption + right\n * action rail reach ~25–28% up, tighter than the old 0.20, and a posted RET clip\n * had its keyboard clipped at 0.20. `top: 0.15` clears TikTok's top tabs/search\n * row — measured from a real screenshot, the \"Find related content\" search bar\n * bottom sits at ~0.114·H, so 0.10 clashed and 0.13 cleared by only ~31px; 0.15\n * gives a comfortable ~73px. This is the SINGLE source of truth for both safe lines:\n * consumers anchor bottom content to `safeBox().bottom` and top titles to\n * `safeTitleBaseline()` instead of hardcoding. Verify any layout with `?safe=1`.\n */\nexport const SAFE_ZONE = { top: 0.15, bottom: 0.28, left: 0.06, right: 0.12 } as const;\n\nexport interface SafeBox {\n  left: number; right: number; top: number; bottom: number;\n  w: number; h: number; cx: number; cy: number;\n  /** Widest block centered at frame W/2 that still fits inside the box. */\n  centeredW: number;\n}\n\n/** The usable content rectangle for a W×H frame, in pixels. */\nexport function safeBox(W: number, H: number): SafeBox {\n  const left = W * SAFE_ZONE.left;\n  const right = W * (1 - SAFE_ZONE.right);\n  const top = H * SAFE_ZONE.top;\n  const bottom = H * (1 - SAFE_ZONE.bottom);\n  return {\n    left, right, top, bottom,\n    w: right - left, h: bottom - top,\n    cx: (left + right) / 2, cy: (top + bottom) / 2,\n    centeredW: 2 * Math.min(W / 2 - left, right - W / 2),\n  };\n}\n\n/**\n * Lowest first-line baseline (for an ALPHABETIC-baseline title of `size` px) that\n * keeps the title's cap-top inside the safe box top. Phone top chrome (TikTok/Reels\n * \"For You\" tabs + search) sits above `safeBox().top`, and an alphabetic baseline\n * draws glyphs ~0.8*size ABOVE the baseline — so a small `topY` silently breaches\n * the top. Apps clamp their top titles: `y = Math.max(topY, safeTitleBaseline(size, H))`.\n * Single source of truth for the top-safe line, mirroring `safeBox().bottom`.\n */\nexport function safeTitleBaseline(size: number, H: number): number {\n  return H * SAFE_ZONE.top + size * 0.8 + 4;\n}\n\n/** Debug overlay: dim the four unsafe margins + outline the safe box. */\nexport function drawSafeGuides(ctx: CanvasRenderingContext2D): void {\n  const W = ctx.canvas.width, H = ctx.canvas.height;\n  const b = safeBox(W, H);\n  ctx.save();\n  ctx.globalAlpha = 1;\n  ctx.fillStyle = 'rgba(220,40,40,0.35)';\n  ctx.fillRect(0, 0, W, b.top);                  // top\n  ctx.fillRect(0, b.bottom, W, H - b.bottom);    // bottom\n  ctx.fillRect(0, b.top, b.left, b.h);           // left\n  ctx.fillRect(b.right, b.top, W - b.right, b.h); // right (action rail)\n  ctx.strokeStyle = 'rgba(40,200,90,1)';\n  ctx.lineWidth = 6;\n  ctx.strokeRect(b.left, b.top, b.w, b.h);\n  ctx.restore();\n}\n\n// ─── MIME type picker ─────────────────────────────────────────────────────────\n\nexport function pickMimeType(): string {\n  const candidates = [\n    'video/webm;codecs=vp9,opus',\n    'video/webm;codecs=vp8,opus',\n    'video/webm',\n  ];\n  for (const t of candidates) {\n    if (typeof MediaRecorder !== 'undefined' && MediaRecorder.isTypeSupported(t)) return t;\n  }\n  return 'video/webm';\n}\n\n// ─── recordScenes ─────────────────────────────────────────────────────────────\n\nexport async function recordScenes(scenes: Scene[], opts: RecordOpts): Promise<Blob> {\n  const { audioStream, width, height, fps = 30, background = '#000000', onProgress } = opts;\n\n  const canvas = document.createElement('canvas');\n  canvas.width = width;\n  canvas.height = height;\n\n  const maybeCtx = canvas.getContext('2d');\n  if (!maybeCtx) throw new Error('Failed to get 2D context');\n  const ctx: CanvasRenderingContext2D = maybeCtx;\n\n  const videoStream = canvas.captureStream(fps);\n  const combined = new MediaStream([\n    ...videoStream.getVideoTracks(),\n    ...audioStream.getAudioTracks(),\n  ]);\n\n  const mimeType = pickMimeType();\n  const recorder = new MediaRecorder(combined, {\n    mimeType,\n    videoBitsPerSecond: 4_000_000,\n    audioBitsPerSecond: 128_000,\n  });\n\n  const chunks: Blob[] = [];\n  recorder.ondataavailable = (e) => {\n    if (e.data.size > 0) chunks.push(e.data);\n  };\n  const stopped = new Promise<void>((res) => {\n    recorder.onstop = () => res();\n  });\n\n  recorder.start();\n\n  const totalMs = scenes.reduce((s, sc) => s + sc.durationMs, 0);\n  const t0 = performance.now();\n\n  onProgress?.({ phase: 'capturing', progress01: 0 });\n\n  let sceneStart = 0;\n  let sceneIdx = 0;\n  let enteredScene = -1;\n\n  // Draw first frame immediately\n  ctx.fillStyle = background;\n  ctx.fillRect(0, 0, width, height);\n  scenes[0].draw(ctx, 0);\n\n  await new Promise<void>((resolve) => {\n    function tick() {\n      const now = performance.now() - t0;\n      if (now >= totalMs) {\n        setTimeout(resolve, 100);\n        return;\n      }\n\n      // Advance scene index\n      while (\n        sceneIdx < scenes.length - 1 &&\n        now - sceneStart >= scenes[sceneIdx].durationMs\n      ) {\n        sceneStart += scenes[sceneIdx].durationMs;\n        sceneIdx += 1;\n      }\n\n      const scene = scenes[sceneIdx];\n\n      // Fire onEnter once per scene\n      if (enteredScene !== sceneIdx) {\n        enteredScene = sceneIdx;\n        scene.onEnter?.();\n      }\n\n      const tInScene = (now - sceneStart) / scene.durationMs;\n\n      // Clear to background\n      ctx.fillStyle = background;\n      ctx.fillRect(0, 0, width, height);\n\n      scene.draw(ctx, Math.min(1, Math.max(0, tInScene)));\n\n      onProgress?.({\n        phase: 'capturing',\n        progress01: Math.min(0.95, now / totalMs),\n      });\n\n      requestAnimationFrame(tick);\n    }\n\n    requestAnimationFrame(tick);\n  });\n\n  onProgress?.({ phase: 'finalizing', progress01: 0.96 });\n  recorder.stop();\n  await stopped;\n\n  return new Blob(chunks, { type: mimeType });\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\nexport function truncate(s: string, max: number): string {\n  return s.length > max ? s.slice(0, max - 1).trimEnd() + '…' : s;\n}\n\nexport function initials(name: string): string {\n  return name\n    .split(/\\s+/)\n    .filter(Boolean)\n    .slice(0, 3)\n    .map((w) => w[0])\n    .join('')\n    .toUpperCase();\n}\n\n// ─── Scene builders ───────────────────────────────────────────────────────────\n\n/**\n * Dark gradient rising from the frame bottom (opaque-ish at the very bottom,\n * fading out by `heightFrac` up). TikTok overlays the view count bottom-left of\n * every profile-grid thumbnail in WHITE — on our light start screens it was\n * unreadable. Draw this after the background, before content.\n */\nexport function drawBottomGradient(\n  ctx: CanvasRenderingContext2D,\n  opts: { heightFrac?: number; maxAlpha?: number } = {},\n): void {\n  const W = ctx.canvas.width, H = ctx.canvas.height;\n  const heightFrac = opts.heightFrac ?? 0.30;\n  const maxAlpha = opts.maxAlpha ?? 0.45;\n  const top = H * (1 - heightFrac);\n  const g = ctx.createLinearGradient(0, top, 0, H);\n  g.addColorStop(0, \"rgba(0,0,0,0)\");\n  g.addColorStop(1, `rgba(0,0,0,${maxAlpha})`);\n  ctx.save();\n  ctx.fillStyle = g;\n  ctx.fillRect(0, top, W, H - top);\n  ctx.restore();\n}\n\nexport interface HookSceneOpts {\n  lines: string[];\n  brand?: string;\n}\n\nexport function hookScene(theme: PromoTheme, opts: HookSceneOpts): Scene {\n  return {\n    durationMs: 2000,\n    draw(ctx, _t01) {\n      const W = ctx.canvas.width;\n      const H = ctx.canvas.height;\n      // The hook is the profile-grid thumbnail; the bottom gradient keeps\n      // TikTok's white view-count overlay readable on light backdrops.\n      drawBottomGradient(ctx);\n      ctx.textAlign = 'center';\n      ctx.fillStyle = theme.ink;\n      ctx.font = `bold 88px ${theme.fontDisplay}`;\n      opts.lines.forEach((line, i) => {\n        ctx.fillText(line, W / 2, H * 0.42 + i * 104);\n      });\n      const brand = opts.brand ?? theme.brand;\n      ctx.font = `italic 38px ${theme.fontBody}`;\n      ctx.fillStyle = theme.sepia;\n      ctx.fillText(brand, W / 2, H * 0.42 + opts.lines.length * 104 + 12);\n    },\n  };\n}\n\nexport interface RevealSceneOpts {\n  title: string;\n  subtitle: string;\n  initials?: string;\n  /** Composer portrait (already decoded) drawn clipped into the medallion. If\n   *  omitted/null, falls back to the initials badge. Load it with `loadPortrait`\n   *  so a cross-origin image (e.g. Wikimedia) doesn't taint the capture canvas. */\n  portrait?: HTMLImageElement | null;\n  /** Optional one-line fun fact wrapped below the subtitle (e.g. corpus\n   *  `fun_fact`). Trimmed to two lines. */\n  funFact?: string;\n}\n\n/** Load an image for canvas capture: `crossOrigin='anonymous'` so a CORS-enabled\n *  cross-origin source (Wikimedia portraits send `Access-Control-Allow-Origin: *`)\n *  can be drawn onto a captured canvas WITHOUT tainting it. Fail-soft: resolves\n *  null on error/missing url (callers fall back to initials). Cached per-url. */\nconst _portraitCache = new Map<string, Promise<HTMLImageElement | null>>();\nexport function loadPortrait(url?: string | null): Promise<HTMLImageElement | null> {\n  if (!url) return Promise.resolve(null);\n  const cached = _portraitCache.get(url);\n  if (cached) return cached;\n  const p = new Promise<HTMLImageElement | null>((resolve) => {\n    if (typeof Image === 'undefined') { resolve(null); return; }\n    const img = new Image();\n    img.crossOrigin = 'anonymous';\n    img.onload = () => resolve(img);\n    img.onerror = () => resolve(null);\n    img.src = url;\n  });\n  _portraitCache.set(url, p);\n  return p;\n}\n\n/** Greedy word-wrap for the current ctx.font into at most `maxLines` lines. */\nfunction wrapLines(ctx: CanvasRenderingContext2D, text: string, maxW: number, maxLines: number): string[] {\n  const words = text.split(/\\s+/).filter(Boolean);\n  const lines: string[] = [];\n  let cur = '';\n  for (const w of words) {\n    const next = cur ? `${cur} ${w}` : w;\n    if (ctx.measureText(next).width > maxW && cur) {\n      lines.push(cur);\n      cur = w;\n      if (lines.length === maxLines - 1) break;\n    } else {\n      cur = next;\n    }\n  }\n  if (cur && lines.length < maxLines) lines.push(cur);\n  // If we ran out of line budget mid-text, ellipsize the last line.\n  const used = lines.join(' ');\n  if (used.length < text.length && lines.length) {\n    lines[lines.length - 1] = truncate(lines[lines.length - 1] + '…', 999);\n  }\n  return lines;\n}\n\nexport function revealScene(theme: PromoTheme, opts: RevealSceneOpts): Scene {\n  return {\n    durationMs: 2200,\n    draw(ctx, t01) {\n      const W = ctx.canvas.width;\n      const H = ctx.canvas.height;\n      const b = safeBox(W, H);\n      const cx = W / 2;\n      // Anchor through the safe box; ~0.4286 of box height ≈ original H*0.40 (no visible shift at 1080×1920).\n      const cy = b.top + b.h * 0.4286;\n      const r = 92;\n      const k = Math.min(1, t01 * 1.4);\n      ctx.globalAlpha = k;\n      ctx.textAlign = 'center';\n\n      // Medallion circle (faint surface) + gold ring.\n      ctx.beginPath();\n      ctx.arc(cx, cy, r, 0, Math.PI * 2);\n      ctx.fillStyle = theme.paper;\n      ctx.fill();\n\n      if (opts.portrait) {\n        // Portrait clipped into the medallion, cover-fit (centred crop).\n        ctx.save();\n        ctx.beginPath();\n        ctx.arc(cx, cy, r - 3, 0, Math.PI * 2);\n        ctx.clip();\n        const img = opts.portrait;\n        const iw = img.naturalWidth || img.width || 1;\n        const ih = img.naturalHeight || img.height || 1;\n        const scale = Math.max((2 * (r - 3)) / iw, (2 * (r - 3)) / ih);\n        const dw = iw * scale;\n        const dh = ih * scale;\n        ctx.drawImage(img, cx - dw / 2, cy - dh / 2, dw, dh);\n        ctx.restore();\n      } else {\n        // Initials inside medallion (fallback).\n        ctx.fillStyle = theme.ink;\n        ctx.font = `bold 76px ${theme.fontDisplay}`;\n        const badge = opts.initials ?? initials(opts.title);\n        ctx.fillText(badge, cx, cy + 27);\n      }\n\n      ctx.lineWidth = 5;\n      ctx.strokeStyle = theme.gold;\n      ctx.stroke();\n\n      // Title (with font-size fallback if too wide)\n      const truncated = truncate(opts.title, 24);\n      let fontSize = 80;\n      ctx.font = `bold ${fontSize}px ${theme.fontDisplay}`;\n      if (ctx.measureText(truncated).width > W * 0.86) {\n        fontSize = 68;\n        ctx.font = `bold ${fontSize}px ${theme.fontDisplay}`;\n      }\n      ctx.fillStyle = theme.ink;\n      ctx.fillText(truncated, cx, cy + r + 110);\n\n      // Subtitle\n      ctx.font = `italic 50px ${theme.fontBody}`;\n      ctx.fillStyle = theme.sepia;\n      ctx.fillText(opts.subtitle, cx, cy + r + 176);\n\n      // Optional fun fact, wrapped to two lines below the subtitle.\n      if (opts.funFact) {\n        ctx.font = `34px ${theme.fontBody}`;\n        ctx.fillStyle = theme.sepia;\n        const lines = wrapLines(ctx, opts.funFact, b.w * 0.92, 2);\n        lines.forEach((line, i) => {\n          ctx.fillText(line, cx, cy + r + 246 + i * 44);\n        });\n      }\n\n      ctx.globalAlpha = 1;\n    },\n  };\n}\n\nexport interface CtaSceneOpts {\n  lines: string[];\n}\n\nexport function ctaScene(theme: PromoTheme, opts: CtaSceneOpts): Scene {\n  return {\n    durationMs: 2500,\n    draw(ctx, _t01) {\n      const W = ctx.canvas.width;\n      const H = ctx.canvas.height;\n      const b = safeBox(W, H);\n      // Safe-box-relative base ≈ original H*0.42 (no visible shift at 1080×1920).\n      const baseY = b.cy - 40;\n      ctx.textAlign = 'center';\n      if (opts.lines.length > 0) {\n        ctx.fillStyle = theme.ink;\n        ctx.font = `bold 66px ${theme.fontDisplay}`;\n        ctx.fillText(opts.lines[0], W / 2, baseY);\n      }\n      opts.lines.slice(1).forEach((line, i) => {\n        ctx.fillStyle = theme.accent;\n        ctx.font = `bold 72px ${theme.fontDisplay}`;\n        ctx.fillText(line, W / 2, baseY + 100 * (i + 1));\n      });\n    },\n  };\n}\n\n// ─── runPromoCapture ──────────────────────────────────────────────────────────\n\nexport async function runPromoCapture(\n  opts: PromoCaptureOpts,\n  record: (scenes: Scene[], o: RecordOpts) => Promise<Blob> = recordScenes,\n): Promise<void> {\n  const w = window as unknown as Record<string, unknown>;\n  w.__promoMeta = opts.meta;\n  try {\n    const blob = await record(opts.buildScenes(), {\n      audioStream: opts.audioStream,\n      width: opts.width ?? 1080,\n      height: opts.height ?? 1920,\n      fps: opts.fps,\n      background: opts.background,\n    });\n    const url = URL.createObjectURL(blob);\n    w.__promoBlobUrl = url;\n    if (opts.download !== false) {\n      const a = document.createElement('a');\n      a.href = url;\n      a.download = `promo-${opts.meta.id ?? 'clip'}.webm`;\n      document.body.appendChild(a);\n      a.click();\n    }\n    w.__promoReady = true;\n  } catch (e) {\n    w.__promoError = String(e);\n    throw e;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-music-packages/web-core",
-  "version": "0.9.7",
+  "version": "0.10.0",
   "description": "Shared music-theory + audio primitives for the music-suite web apps",
   "type": "module",
   "main": "./dist/index.js",

package/dist/chunk-BPL5LLQH.js.map

@@ -1 +0,0 @@
-{"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":[]}