@real-music-packages/web-core 0.36.2 → 0.38.0

package/dist/notationPlayerSvg.d.ts

@@ -0,0 +1,140 @@
+import { N as NotationLayout } from './notationGeometry-54fFq5yU.js';
+import './promo.js';
+
+interface CreateSvgNotationPlayerOpts {
+    /** Element the player's content is mounted into. Takes NATURAL content
+     *  height (the whole score, page-flow layout) — the host must not clip a
+     *  fixed height; the PAGE scrolls the score, there is no internal camera. */
+    host: HTMLElement;
+    /** MusicXML to engrave. Ignored when `rendered` (the test seam) is set. */
+    musicXml: string;
+    /** Distinct note onsets (ms) the playhead locks to — same contract as
+     *  `CreateNotationPlayerOpts.onsetsMs` in notationPlayer.ts. */
+    onsetsMs: number[];
+    /** Per-onset engraved column positions, 1:1 with the DEDUPED/sorted
+     *  `onsetsMs` — same semantics as the canvas player's `noteCols`. */
+    noteCols?: number[];
+    /** Playhead line color. Default `'#2f6f4f'`. */
+    playheadColor?: string;
+    /** Initial OSMD zoom (a pure post-layout visual scale — see
+     *  `svgNotationLayout`'s doc). Default 1 (OSMD's own default — the
+     *  engraving fits the host's own width at normal note size). */
+    zoom?: number;
+    /**
+     * Advanced / test seam: a pre-built `NotationLayout`, bypassing the real
+     * OSMD SVG engrave (`musicXml` is still required by the type but is
+     * ignored when this is set). Mirrors `CreateNotationPlayerOpts.rendered` in
+     * notationPlayer.ts for the identical reason: real OSMD *rendering* needs
+     * actual browser canvas glyph metrics (for its line-breaking pass) even
+     * when the SVG backend is selected — headless/jsdom can't fully provide
+     * that — so this is how this module stays unit-testable in Node. Not
+     * needed in a real browser host. When set, `setZoom`/`resize` update the
+     * tracked zoom/width but perform no real re-engrave (there is nothing to
+     * re-engrave).
+     */
+    rendered?: NotationLayout;
+}
+interface SvgNotationPlayer {
+    /** Resolves once the engraving is in the DOM and ready to draw. `setTime`/
+     *  click hit-testing are safe to call before this resolves (no-op until
+     *  ready, same contract as the canvas player). */
+    readonly ready: Promise<void>;
+    /** Drive the playhead for absolute playback time `tMs`. Caller owns the
+     *  audio clock + rAF loop. */
+    setTime(tMs: number): void;
+    /** Re-engrave at a new OSMD zoom (systems reflow). The scroll position is
+     *  restored afterward so the content that was centered in the viewport
+     *  before the reflow is still centered after it. */
+    setZoom(z: number): Promise<void>;
+    /** Re-measure the host and reflow to match its current width, with the
+     *  same scroll-position preservation as `setZoom`. Call on host resize /
+     *  orientation change. */
+    resize(): Promise<void>;
+    /** Register a measure-click handler (measure index, matching
+     *  `ScoreNote.measure`/the engraved index). Returns an unsubscribe fn. */
+    onMeasureClick(cb: (measureIndex: number) => void): () => void;
+    /** Tear down: removes the mounted DOM (engraving + playhead overlay) from
+     *  `host`, and drops every listener this instance added (click, window
+     *  scroll) and pending async work (a token guard drops any in-flight
+     *  reflow's effects). Idempotent. */
+    destroy(): void;
+}
+interface SvgNotationLayoutOpts {
+    /** CSS px per OSMD unit at zoom 1 — OSMD's own exported `unitInPixels`
+     *  constant (see the derivation above). REQUIRED, no default: the point is
+     *  to FORCE the real call site to source this from the live
+     *  `opensheetmusicdisplay` import
+     *  (`const { unitInPixels } = await import('opensheetmusicdisplay')`)
+     *  rather than this module assuming a value that could drift across OSMD
+     *  versions. Tests pin it explicitly. */
+    unitInPixels: number;
+}
+/**
+ * Pure SVG-backend geometry extractor — builds the SAME `NotationLayout`
+ * shape the canvas path's `notationLayout()` does (measure column boxes +
+ * system rows + a `rect` vertical band), but read directly from OSMD's
+ * `GraphicalMusicSheet` in SVG/CSS px space (see the unit-conversion doc
+ * above) instead of a rasterized bitmap. Rebuild on every render (zoom /
+ * resize / new score) — cheap, pure array/object mapping, no DOM reads.
+ *
+ * `osmd` is duck-typed `any` — same contract as promo.ts's
+ * `extractGeometry(osmd: any, ...)` — so tests can pass a plain fixture
+ * object shaped like the minimal slice of a real `OpenSheetMusicDisplay`
+ * instance this function reads (`{ Zoom, GraphicSheet: { MusicPages,
+ * MeasureList } }`) without needing a real browser OSMD render (see
+ * `CreateSvgNotationPlayerOpts.rendered`'s doc for why headless can't do a
+ * real one).
+ *
+ * `rect` spans the FULL engraved page (top-aligned, `dy = 0`) — there is no
+ * follow-camera crop in this component (the whole score is always in the
+ * DOM; the PAGE scrolls it) — matching the canvas scroll-mode's `flowLayout`
+ * in spirit. `vstackAudioPlayheadLine` only reads `rect.dy`/`rect.dh` to
+ * clamp the playhead into the drawn band, so this is a correct, minimal
+ * `rect` for that consumer.
+ */
+declare function svgNotationLayout(osmd: any, opts: SvgNotationLayoutOpts): NotationLayout;
+/**
+ * Pure reflow position-preservation math: given the OLD layout (before a
+ * `setZoom`/`resize` re-engrave), the NEW layout (after it), and an anchor
+ * point `(anchorX, anchorY)` in the OLD layout's coordinate space (typically
+ * "whatever content sat at the vertical center of the viewport" — see the
+ * call site), return the vertical delta (new px minus old px) to add to the
+ * window's scroll position so that SAME content stays in the SAME on-screen
+ * position across the reflow.
+ *
+ * Deliberately NOT playhead interpolation: it's a one-shot "where did this
+ * content move to" lookup built from two existing, reused primitives —
+ * `hitTestMeasureAt` (which measure box contains/is nearest the anchor) and
+ * `measureColumnsFromLayout` (that same measure's box in each layout) — plus
+ * a linear fraction-within-the-box preservation so an anchor near the bottom
+ * of a tall measure box stays near the bottom after reflow, not snapped to
+ * the box's top edge. Returns 0 when the anchor measure can't be resolved in
+ * either layout (e.g. an empty layout) — a safe no-op scroll.
+ */
+declare function computeReflowScrollDelta(oldLayout: NotationLayout, newLayout: NotationLayout, anchorX: number, anchorY: number): number;
+/** Tolerance, px, for "close enough" to count as the same position (float/
+ *  sub-pixel scroll settling noise). */
+declare const PROGRAMMATIC_SCROLL_EPSILON_PX = 2;
+/**
+ * True while `y` lies within `[min(start,target), max(start,target)]`
+ * (± `epsilon`) — i.e. anywhere along the straight-line path of a
+ * `window.scrollTo({top: target, behavior:'smooth'})` call issued from
+ * `start`. A scroll event reporting a position outside this span cannot be a
+ * frame of that animation.
+ */
+declare function isWithinProgrammaticScroll(y: number, start: number, target: number, epsilon?: number): boolean;
+/** True once `y` has settled at (within `epsilon` of) the programmatic
+ *  scroll's target — the animation is complete, so tracking can be cleared. */
+declare function hasReachedProgrammaticTarget(y: number, target: number, epsilon?: number): boolean;
+/** Engrave-width ceiling, CSS px (design doc §"Render": "cap ~1200px, the
+ *  0.36.2 rule" — the same reasoning as notationPlayer.ts's
+ *  `MAX_ENGRAVE_WIDTH`, restated here rather than imported since the two
+ *  players' constants are independently tunable, and this one is spec'd to a
+ *  slightly different value). */
+declare const MAX_ENGRAVE_WIDTH_SVG = 1200;
+/** Build a live, interactive SVG (vector) notation player. See the module doc
+ *  + `docs/superpowers/specs/2026-08-11-svg-notation-player-design.md` (in
+ *  stave-web-sightread) for the full design. */
+declare function createSvgNotationPlayer(opts: CreateSvgNotationPlayerOpts): SvgNotationPlayer;
+
+export { type CreateSvgNotationPlayerOpts, MAX_ENGRAVE_WIDTH_SVG, PROGRAMMATIC_SCROLL_EPSILON_PX, type SvgNotationLayoutOpts, type SvgNotationPlayer, computeReflowScrollDelta, createSvgNotationPlayer, hasReachedProgrammaticTarget, isWithinProgrammaticScroll, svgNotationLayout };

package/dist/notationPlayerSvg.js

@@ -0,0 +1,316 @@
+import {
+  distinctOnsets,
+  hitTestMeasureAt,
+  measureColumnsFromLayout,
+  vstackAudioPlayheadLine
+} from "./chunk-BHRDISMU.js";
+import "./chunk-HXTRNE74.js";
+
+// src/notationPlayerSvg.ts
+var EMPTY_LAYOUT = {
+  src: { x: 0, y: 0, w: 0, h: 0 },
+  rect: { dx: 0, dy: 0, dw: 0, dh: 0 },
+  systems: [],
+  measures: []
+};
+function svgNotationLayout(osmd, opts) {
+  try {
+    const zoom = typeof osmd?.Zoom === "number" && osmd.Zoom > 0 ? osmd.Zoom : typeof osmd?.zoom === "number" && osmd.zoom > 0 ? osmd.zoom : 1;
+    const f = opts.unitInPixels * zoom;
+    const graphic = osmd?.GraphicSheet;
+    const page = graphic?.MusicPages?.[0];
+    const pageSize = page?.PositionAndShape?.Size;
+    const musicSystems = page?.MusicSystems ?? [];
+    if (!(pageSize?.width > 0) || !(pageSize?.height > 0) || !musicSystems.length) return EMPTY_LAYOUT;
+    const toBox = (pas) => {
+      const p = pas?.AbsolutePosition;
+      const sz = pas?.Size;
+      if (!p || !sz) return null;
+      return { x: p.x * f, y: p.y * f, w: sz.width * f, h: sz.height * f };
+    };
+    const systems = musicSystems.map((s) => toBox(s?.PositionAndShape)).filter((b) => !!b && b.w > 1 && b.h > 1).sort((a, b) => a.y - b.y);
+    if (!systems.length) return EMPTY_LAYOUT;
+    const measureList = graphic?.MeasureList ?? [];
+    const measures = [];
+    measureList.forEach((staves, index) => {
+      (staves ?? []).forEach((m, staff) => {
+        const box = toBox(m?.PositionAndShape);
+        if (box && box.w > 1 && box.h > 1) {
+          const seX = (m?.staffEntries ?? [])[0]?.PositionAndShape?.AbsolutePosition?.x;
+          const noteStartX = typeof seX === "number" ? seX * f : box.x;
+          measures.push({ index, staff, box, noteStartX });
+        }
+      });
+    });
+    const dw = pageSize.width * f;
+    const dh = pageSize.height * f;
+    return {
+      src: { x: 0, y: 0, w: dw, h: dh },
+      rect: { dx: 0, dy: 0, dw, dh },
+      systems,
+      measures
+    };
+  } catch {
+    return EMPTY_LAYOUT;
+  }
+}
+function computeReflowScrollDelta(oldLayout, newLayout, anchorX, anchorY) {
+  const idx = hitTestMeasureAt(oldLayout, anchorX, anchorY);
+  if (idx == null) return 0;
+  const oldIndices = [...new Set(oldLayout.measures.map((m) => m.index))].sort((a, b) => a - b);
+  const newIndices = [...new Set(newLayout.measures.map((m) => m.index))].sort((a, b) => a - b);
+  const oi = oldIndices.indexOf(idx);
+  const ni = newIndices.indexOf(idx);
+  if (oi < 0 || ni < 0) return 0;
+  const oldCols = measureColumnsFromLayout(oldLayout.measures);
+  const newCols = measureColumnsFromLayout(newLayout.measures);
+  const oldBox = oldCols[oi];
+  const newBox = newCols[ni];
+  if (!oldBox || !newBox) return 0;
+  const fracY = oldBox.h > 0 ? (anchorY - oldBox.y) / oldBox.h : 0;
+  const newAnchorY = newBox.y + fracY * newBox.h;
+  return newAnchorY - anchorY;
+}
+var PROGRAMMATIC_SCROLL_EPSILON_PX = 2;
+function isWithinProgrammaticScroll(y, start, target, epsilon = PROGRAMMATIC_SCROLL_EPSILON_PX) {
+  const lo = Math.min(start, target) - epsilon;
+  const hi = Math.max(start, target) + epsilon;
+  return y >= lo && y <= hi;
+}
+function hasReachedProgrammaticTarget(y, target, epsilon = PROGRAMMATIC_SCROLL_EPSILON_PX) {
+  return Math.abs(y - target) <= epsilon;
+}
+var DEFAULT_PLAYHEAD_COLOR = "#2f6f4f";
+var MAX_ENGRAVE_WIDTH_SVG = 1200;
+var MIN_ENGRAVE_WIDTH_SVG = 280;
+var SEEK_DISCONTINUITY_MS = 400;
+function nowMs() {
+  return typeof performance !== "undefined" ? performance.now() : Date.now();
+}
+function createSvgNotationPlayer(opts) {
+  const { host, musicXml, onsetsMs, noteCols } = opts;
+  const playheadColor = opts.playheadColor ?? DEFAULT_PLAYHEAD_COLOR;
+  const onsets = distinctOnsets(onsetsMs.map((onsetMs) => ({ onsetMs })));
+  const root = document.createElement("div");
+  root.style.position = "relative";
+  root.style.width = "100%";
+  root.style.touchAction = "pan-y pinch-zoom";
+  host.appendChild(root);
+  const svgHost = document.createElement("div");
+  root.appendChild(svgHost);
+  const playheadEl = document.createElement("div");
+  playheadEl.style.position = "absolute";
+  playheadEl.style.left = "0px";
+  playheadEl.style.top = "0px";
+  playheadEl.style.width = "2px";
+  playheadEl.style.height = "0px";
+  playheadEl.style.background = playheadColor;
+  playheadEl.style.opacity = "0";
+  playheadEl.style.pointerEvents = "none";
+  root.appendChild(playheadEl);
+  let osmd = null;
+  let currentLayout = null;
+  let currentZoom = opts.zoom ?? 1;
+  let unitInPixelsConst = 10;
+  let lastEngravedWidthPx = 0;
+  let destroyed = false;
+  let lastTMs = 0;
+  let rebuildToken = 0;
+  function desiredEngraveWidthPx() {
+    const w = host.clientWidth || 0;
+    return Math.max(MIN_ENGRAVE_WIDTH_SVG, Math.min(w || MAX_ENGRAVE_WIDTH_SVG, MAX_ENGRAVE_WIDTH_SVG));
+  }
+  function renderPlayhead(tMs) {
+    lastTMs = tMs;
+    if (!currentLayout) return;
+    const nBars = currentLayout.measures.length ? Math.max(...currentLayout.measures.map((m) => m.index)) + 1 : 0;
+    const line = vstackAudioPlayheadLine(currentLayout, onsets, tMs, nBars, noteCols);
+    if (!line) {
+      playheadEl.style.opacity = "0";
+      return;
+    }
+    playheadEl.style.opacity = String(line.alpha);
+    playheadEl.style.left = `${line.x}px`;
+    playheadEl.style.top = `${line.y0}px`;
+    playheadEl.style.height = `${Math.max(0, line.y1 - line.y0)}px`;
+    maybeAutoFollow();
+  }
+  let autoFollowSuspended = false;
+  let programmaticStart = null;
+  let programmaticTarget = null;
+  let followRafPending = false;
+  let lastWallMs = null;
+  let lastMusicMs = 0;
+  function onWindowScroll() {
+    if (programmaticTarget != null && programmaticStart != null) {
+      const y = window.scrollY;
+      if (isWithinProgrammaticScroll(y, programmaticStart, programmaticTarget)) {
+        if (hasReachedProgrammaticTarget(y, programmaticTarget)) {
+          programmaticStart = null;
+          programmaticTarget = null;
+        }
+        return;
+      }
+    }
+    autoFollowSuspended = true;
+    programmaticStart = null;
+    programmaticTarget = null;
+  }
+  const hasWindow = typeof window !== "undefined" && typeof window.addEventListener === "function";
+  if (hasWindow) window.addEventListener("scroll", onWindowScroll, { passive: true });
+  function detectDiscontinuity(tMs) {
+    const now = nowMs();
+    if (lastWallMs != null) {
+      const dtMusic = tMs - lastMusicMs;
+      const dtWall = now - lastWallMs;
+      if (dtMusic < 0 || Math.abs(dtMusic - dtWall) > SEEK_DISCONTINUITY_MS) autoFollowSuspended = false;
+    } else {
+      autoFollowSuspended = false;
+    }
+    lastWallMs = now;
+    lastMusicMs = tMs;
+  }
+  function maybeAutoFollow() {
+    if (autoFollowSuspended || followRafPending) return;
+    if (typeof window === "undefined" || typeof window.requestAnimationFrame !== "function") return;
+    followRafPending = true;
+    window.requestAnimationFrame(() => {
+      followRafPending = false;
+      if (destroyed || autoFollowSuspended) return;
+      if (typeof playheadEl.getBoundingClientRect !== "function") return;
+      const rect = playheadEl.getBoundingClientRect();
+      const vh = window.innerHeight;
+      if (!(vh > 0)) return;
+      if (rect.top >= vh * 0.25 && rect.top <= vh * 0.75) return;
+      const start = window.scrollY;
+      const target = Math.max(0, start + rect.top - vh / 2);
+      programmaticStart = start;
+      programmaticTarget = target;
+      window.scrollTo({ top: target, left: window.scrollX, behavior: "smooth" });
+    });
+  }
+  function setTime(tMs) {
+    if (destroyed) return;
+    detectDiscontinuity(tMs);
+    renderPlayhead(tMs);
+  }
+  async function initialEngrave() {
+    if (opts.rendered) {
+      currentLayout = opts.rendered;
+      lastEngravedWidthPx = desiredEngraveWidthPx();
+      renderPlayhead(lastTMs);
+      return;
+    }
+    const { OpenSheetMusicDisplay, unitInPixels } = await import("opensheetmusicdisplay");
+    unitInPixelsConst = unitInPixels;
+    if (destroyed) return;
+    const widthPx = desiredEngraveWidthPx();
+    svgHost.style.width = `${widthPx}px`;
+    const inst = new OpenSheetMusicDisplay(svgHost, {
+      backend: "svg",
+      autoResize: false,
+      drawTitle: false,
+      drawSubtitle: false,
+      drawComposer: false,
+      drawLyricist: false,
+      drawPartNames: false
+    });
+    await inst.load(musicXml);
+    if (destroyed) return;
+    inst.Zoom = currentZoom;
+    inst.render();
+    if (destroyed) return;
+    osmd = inst;
+    lastEngravedWidthPx = widthPx;
+    currentLayout = svgNotationLayout(inst, { unitInPixels: unitInPixelsConst });
+    renderPlayhead(lastTMs);
+  }
+  const ready = initialEngrave();
+  async function reflow(newZoom) {
+    if (destroyed) return;
+    const widthPx = desiredEngraveWidthPx();
+    if (widthPx === lastEngravedWidthPx && newZoom === currentZoom) return;
+    if (opts.rendered || !osmd) {
+      currentZoom = newZoom;
+      return;
+    }
+    const myToken = ++rebuildToken;
+    const oldLayout = currentLayout;
+    const hasWin = typeof window !== "undefined";
+    let anchorY = null;
+    const anchorX = widthPx / 2;
+    if (hasWin && typeof root.getBoundingClientRect === "function") {
+      const r = root.getBoundingClientRect();
+      anchorY = window.innerHeight / 2 - r.top;
+    }
+    svgHost.style.width = `${widthPx}px`;
+    osmd.Zoom = newZoom;
+    osmd.updateGraphic();
+    osmd.render();
+    if (destroyed || myToken !== rebuildToken) return;
+    lastEngravedWidthPx = widthPx;
+    currentZoom = newZoom;
+    currentLayout = svgNotationLayout(osmd, { unitInPixels: unitInPixelsConst });
+    if (oldLayout && anchorY != null && hasWin) {
+      const delta = computeReflowScrollDelta(oldLayout, currentLayout, anchorX, anchorY);
+      if (Number.isFinite(delta) && Math.abs(delta) > 0.5) {
+        window.scrollTo({ top: Math.max(0, window.scrollY + delta), left: window.scrollX, behavior: "auto" });
+      }
+    }
+    if (!destroyed) renderPlayhead(lastTMs);
+  }
+  const clickListeners = [];
+  function onRootClick(e) {
+    if (!currentLayout) return;
+    const rect = root.getBoundingClientRect();
+    const mx = e.clientX - rect.left;
+    const my = e.clientY - rect.top;
+    const idx = hitTestMeasureAt(currentLayout, mx, my);
+    if (idx != null) for (const cb of clickListeners) cb(idx);
+  }
+  root.addEventListener("click", onRootClick);
+  return {
+    ready,
+    setTime,
+    async setZoom(z) {
+      await ready;
+      await reflow(z);
+    },
+    async resize() {
+      await ready;
+      await reflow(currentZoom);
+    },
+    onMeasureClick(cb) {
+      clickListeners.push(cb);
+      return () => {
+        const i = clickListeners.indexOf(cb);
+        if (i >= 0) clickListeners.splice(i, 1);
+      };
+    },
+    destroy() {
+      if (destroyed) return;
+      destroyed = true;
+      rebuildToken++;
+      root.removeEventListener("click", onRootClick);
+      if (hasWindow) window.removeEventListener("scroll", onWindowScroll);
+      clickListeners.length = 0;
+      try {
+        osmd?.clear?.();
+      } catch {
+      }
+      osmd = null;
+      currentLayout = null;
+      if (root.parentNode === host) host.removeChild(root);
+    }
+  };
+}
+export {
+  MAX_ENGRAVE_WIDTH_SVG,
+  PROGRAMMATIC_SCROLL_EPSILON_PX,
+  computeReflowScrollDelta,
+  createSvgNotationPlayer,
+  hasReachedProgrammaticTarget,
+  isWithinProgrammaticScroll,
+  svgNotationLayout
+};
+//# sourceMappingURL=notationPlayerSvg.js.map

package/dist/notationPlayerSvg.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/notationPlayerSvg.ts"],"sourcesContent":["// createSvgNotationPlayer — the SVG (vector) sibling of `createNotationPlayer`\n// (src/notationPlayer.ts). Same job (a live, caller-driven notation +\n// gliding-playhead widget), different medium: OSMD's native SVG backend\n// instead of a rasterized canvas. See\n// docs — stave-web-sightread's\n// docs/superpowers/specs/2026-08-11-svg-notation-player-design.md — for the\n// full design rationale (why: vectors don't blur on pinch/browser zoom, no\n// canvas-area cap, no raster tiling needed for full-score scroll).\n//\n// THE CANVAS MODULE IS NOT MODIFIED OR IMPORTED FOR ITS OSMD/RASTER PATH —\n// this is a parallel component. What IS reused, verbatim, no new math:\n//   - `vstackAudioPlayheadLine` (scene/notationGeometry.ts) — the exact same\n//     onset-anchored, carriage-return playhead interpolation the canvas path\n//     uses. It operates purely on a `NotationLayout` (measure column boxes +\n//     a vertical clamp band) — it does not care whether those boxes came from\n//     a canvas raster or live SVG DOM geometry, so THIS module's job is only\n//     to produce a `NotationLayout` in SVG/CSS px space (see\n//     `svgNotationLayout` below) and everything downstream is identical.\n//   - `hitTestMeasureAt` (scene/notationGeometry.ts, moved there in 0.38.0\n//     specifically so this module never has a build-time edge into\n//     notationPlayer.ts's canvas/raster implementation) — the exact same pure\n//     point-in-measure-box hit-test, reused for click-to-seek.\n//   - `distinctOnsets`, `measureColumnsFromLayout` — small pure helpers,\n//     reused as-is.\n//\n// WHAT'S NEW (not a re-derivation of any of the above):\n//   - `svgNotationLayout` — an SVG-backend geometry extractor, the SVG\n//     counterpart to promo.ts's canvas-only `extractGeometry`. See its own\n//     doc comment for the unit-conversion derivation.\n//   - `computeReflowScrollDelta` — zoom/resize position-preservation math\n//     (not playhead interpolation; a one-shot \"where did this same content\n//     move to\" lookup using the existing hit-test + column helpers).\n//   - `isWithinProgrammaticScroll` / `hasReachedProgrammaticTarget` — the\n//     improved auto-follow discriminator (design doc §4): unlike the canvas\n//     scroll-mode player's fixed 600ms \"programmatic scroll\" grace window,\n//     this compares the ACTUAL scroll position against the EXACT target this\n//     component itself requested, so classification is correct regardless of\n//     how long a smooth-scroll animation takes (no grace-window race).\n//\n// IMPORT PATH: subpath-only — `@real-music-packages/web-core/notationPlayerSvg`\n// — not re-exported from the root barrel (same reasoning as notationPlayer.ts:\n// the root barrel is theory-only/zero-dependency).\n\nimport {\n  vstackAudioPlayheadLine,\n  measureColumnsFromLayout,\n  distinctOnsets,\n  hitTestMeasureAt,\n  type NotationLayout,\n} from './scene/notationGeometry';\nimport type { Box, StaffMeasureBox } from './promo';\n\nexport interface CreateSvgNotationPlayerOpts {\n  /** Element the player's content is mounted into. Takes NATURAL content\n   *  height (the whole score, page-flow layout) — the host must not clip a\n   *  fixed height; the PAGE scrolls the score, there is no internal camera. */\n  host: HTMLElement;\n  /** MusicXML to engrave. Ignored when `rendered` (the test seam) is set. */\n  musicXml: string;\n  /** Distinct note onsets (ms) the playhead locks to — same contract as\n   *  `CreateNotationPlayerOpts.onsetsMs` in notationPlayer.ts. */\n  onsetsMs: number[];\n  /** Per-onset engraved column positions, 1:1 with the DEDUPED/sorted\n   *  `onsetsMs` — same semantics as the canvas player's `noteCols`. */\n  noteCols?: number[];\n  /** Playhead line color. Default `'#2f6f4f'`. */\n  playheadColor?: string;\n  /** Initial OSMD zoom (a pure post-layout visual scale — see\n   *  `svgNotationLayout`'s doc). Default 1 (OSMD's own default — the\n   *  engraving fits the host's own width at normal note size). */\n  zoom?: number;\n  /**\n   * Advanced / test seam: a pre-built `NotationLayout`, bypassing the real\n   * OSMD SVG engrave (`musicXml` is still required by the type but is\n   * ignored when this is set). Mirrors `CreateNotationPlayerOpts.rendered` in\n   * notationPlayer.ts for the identical reason: real OSMD *rendering* needs\n   * actual browser canvas glyph metrics (for its line-breaking pass) even\n   * when the SVG backend is selected — headless/jsdom can't fully provide\n   * that — so this is how this module stays unit-testable in Node. Not\n   * needed in a real browser host. When set, `setZoom`/`resize` update the\n   * tracked zoom/width but perform no real re-engrave (there is nothing to\n   * re-engrave).\n   */\n  rendered?: NotationLayout;\n}\n\nexport interface SvgNotationPlayer {\n  /** Resolves once the engraving is in the DOM and ready to draw. `setTime`/\n   *  click hit-testing are safe to call before this resolves (no-op until\n   *  ready, same contract as the canvas player). */\n  readonly ready: Promise<void>;\n  /** Drive the playhead for absolute playback time `tMs`. Caller owns the\n   *  audio clock + rAF loop. */\n  setTime(tMs: number): void;\n  /** Re-engrave at a new OSMD zoom (systems reflow). The scroll position is\n   *  restored afterward so the content that was centered in the viewport\n   *  before the reflow is still centered after it. */\n  setZoom(z: number): Promise<void>;\n  /** Re-measure the host and reflow to match its current width, with the\n   *  same scroll-position preservation as `setZoom`. Call on host resize /\n   *  orientation change. */\n  resize(): Promise<void>;\n  /** Register a measure-click handler (measure index, matching\n   *  `ScoreNote.measure`/the engraved index). Returns an unsubscribe fn. */\n  onMeasureClick(cb: (measureIndex: number) => void): () => void;\n  /** Tear down: removes the mounted DOM (engraving + playhead overlay) from\n   *  `host`, and drops every listener this instance added (click, window\n   *  scroll) and pending async work (a token guard drops any in-flight\n   *  reflow's effects). Idempotent. */\n  destroy(): void;\n}\n\n// ─── svgNotationLayout — the SVG-backend geometry extractor ───────────────\n//\n// UNIT CONVERSION — derived, not guessed (verified against the vendored\n// opensheetmusicdisplay + vexflow source, not just its .d.ts comments, which\n// are stale here — see below):\n//\n//   1. `GraphicalMusicSheet` (`osmd.GraphicSheet`) positions\n//      (`PositionAndShape.AbsolutePosition`/`.Size`) are in backend-agnostic\n//      \"OSMD units\" — the SAME object model promo.ts's canvas-only\n//      `extractGeometry` reads (`osmd.GraphicSheet.MusicPages[0].MusicSystems`,\n//      `.MeasureList`). Whichever backend (canvas/svg) was requested, this\n//      layer is identical.\n//   2. OSMD's Vexflow draw layer (`VexFlowMusicSheetDrawer`) converts an OSMD\n//      unit value to a \"raw\" Vexflow/SVG px value via an EXPORTED constant,\n//      `unitInPixels` (currently 10 — NOT `EngravingRules.unit`, which is a\n//      different, unrelated field that is NOT the px-per-unit factor despite\n//      what its .d.ts comment implies; confirmed by reading the actual\n//      compiled source, not trusting the stale doc comment). This raw value\n//      is written directly into each SVG element's own coordinate attributes\n//      — it does NOT yet include `zoom`.\n//   3. `osmd.Zoom` (current zoom) is applied SEPARATELY, at the SVG-backend\n//      level, via a `viewBox` trick (`vexflow/src/svgcontext.js`'s\n//      `scale(x,y)`): the `<svg>` element's `width`/`height` ATTRIBUTES are\n//      set to the FINAL (zoomed) CSS px size, while its `viewBox` spans\n//      `width/zoom .. height/zoom` — i.e. the RAW (unzoomed, step-2) content\n//      coordinates. The browser therefore maps that raw coordinate space onto\n//      the final CSS px box by exactly `zoom`.\n//   Net result: `cssPx = unitValue * unitInPixels * zoom`. Both factors are\n//   read from the live library/instance (never a hardcoded literal `10` or an\n//   assumed zoom) — see `SvgNotationLayoutOpts.unitInPixels`'s doc — so a\n//   future OSMD version changing either is picked up automatically, which is\n//   exactly the \"10 units/staff-space assumptions have version drift\" risk\n//   the design doc calls out.\n//\n// This mirrors, in spirit, promo.ts's canvas `extractGeometry` self-\n// calibration (`canvas.width / (contentRight+contentLeft)`, chosen there\n// specifically because a naive formula broke on overflowed layouts) — the SVG\n// backend doesn't have that raster-overflow failure mode (there is no\n// backing-store to overflow; the viewBox IS the content, always), so the\n// derived formula above is exact, not an approximation.\n\nexport interface SvgNotationLayoutOpts {\n  /** CSS px per OSMD unit at zoom 1 — OSMD's own exported `unitInPixels`\n   *  constant (see the derivation above). REQUIRED, no default: the point is\n   *  to FORCE the real call site to source this from the live\n   *  `opensheetmusicdisplay` import\n   *  (`const { unitInPixels } = await import('opensheetmusicdisplay')`)\n   *  rather than this module assuming a value that could drift across OSMD\n   *  versions. Tests pin it explicitly. */\n  unitInPixels: number;\n}\n\nconst EMPTY_LAYOUT: NotationLayout = {\n  src: { x: 0, y: 0, w: 0, h: 0 },\n  rect: { dx: 0, dy: 0, dw: 0, dh: 0 },\n  systems: [],\n  measures: [],\n};\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n/**\n * Pure SVG-backend geometry extractor — builds the SAME `NotationLayout`\n * shape the canvas path's `notationLayout()` does (measure column boxes +\n * system rows + a `rect` vertical band), but read directly from OSMD's\n * `GraphicalMusicSheet` in SVG/CSS px space (see the unit-conversion doc\n * above) instead of a rasterized bitmap. Rebuild on every render (zoom /\n * resize / new score) — cheap, pure array/object mapping, no DOM reads.\n *\n * `osmd` is duck-typed `any` — same contract as promo.ts's\n * `extractGeometry(osmd: any, ...)` — so tests can pass a plain fixture\n * object shaped like the minimal slice of a real `OpenSheetMusicDisplay`\n * instance this function reads (`{ Zoom, GraphicSheet: { MusicPages,\n * MeasureList } }`) without needing a real browser OSMD render (see\n * `CreateSvgNotationPlayerOpts.rendered`'s doc for why headless can't do a\n * real one).\n *\n * `rect` spans the FULL engraved page (top-aligned, `dy = 0`) — there is no\n * follow-camera crop in this component (the whole score is always in the\n * DOM; the PAGE scrolls it) — matching the canvas scroll-mode's `flowLayout`\n * in spirit. `vstackAudioPlayheadLine` only reads `rect.dy`/`rect.dh` to\n * clamp the playhead into the drawn band, so this is a correct, minimal\n * `rect` for that consumer.\n */\nexport function svgNotationLayout(osmd: any, opts: SvgNotationLayoutOpts): NotationLayout {\n  try {\n    const zoom =\n      typeof osmd?.Zoom === 'number' && osmd.Zoom > 0\n        ? osmd.Zoom\n        : typeof osmd?.zoom === 'number' && osmd.zoom > 0\n          ? osmd.zoom\n          : 1;\n    const f = opts.unitInPixels * zoom;\n\n    const graphic: any = osmd?.GraphicSheet;\n    const page: any = graphic?.MusicPages?.[0];\n    const pageSize = page?.PositionAndShape?.Size;\n    const musicSystems: any[] = page?.MusicSystems ?? [];\n    if (!(pageSize?.width > 0) || !(pageSize?.height > 0) || !musicSystems.length) return EMPTY_LAYOUT;\n\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 EMPTY_LAYOUT;\n\n    const measureList: any[][] = graphic?.MeasureList ?? [];\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    const dw = pageSize.width * f;\n    const dh = pageSize.height * f;\n    return {\n      src: { x: 0, y: 0, w: dw, h: dh },\n      rect: { dx: 0, dy: 0, dw, dh },\n      systems,\n      measures,\n    };\n  } catch {\n    return EMPTY_LAYOUT;\n  }\n}\n/* eslint-enable @typescript-eslint/no-explicit-any */\n\n// ─── Zoom/resize position preservation (pure, unit-tested) ────────────────\n\n/**\n * Pure reflow position-preservation math: given the OLD layout (before a\n * `setZoom`/`resize` re-engrave), the NEW layout (after it), and an anchor\n * point `(anchorX, anchorY)` in the OLD layout's coordinate space (typically\n * \"whatever content sat at the vertical center of the viewport\" — see the\n * call site), return the vertical delta (new px minus old px) to add to the\n * window's scroll position so that SAME content stays in the SAME on-screen\n * position across the reflow.\n *\n * Deliberately NOT playhead interpolation: it's a one-shot \"where did this\n * content move to\" lookup built from two existing, reused primitives —\n * `hitTestMeasureAt` (which measure box contains/is nearest the anchor) and\n * `measureColumnsFromLayout` (that same measure's box in each layout) — plus\n * a linear fraction-within-the-box preservation so an anchor near the bottom\n * of a tall measure box stays near the bottom after reflow, not snapped to\n * the box's top edge. Returns 0 when the anchor measure can't be resolved in\n * either layout (e.g. an empty layout) — a safe no-op scroll.\n */\nexport function computeReflowScrollDelta(\n  oldLayout: NotationLayout,\n  newLayout: NotationLayout,\n  anchorX: number,\n  anchorY: number,\n): number {\n  const idx = hitTestMeasureAt(oldLayout, anchorX, anchorY);\n  if (idx == null) return 0;\n\n  const oldIndices = [...new Set(oldLayout.measures.map((m) => m.index))].sort((a, b) => a - b);\n  const newIndices = [...new Set(newLayout.measures.map((m) => m.index))].sort((a, b) => a - b);\n  const oi = oldIndices.indexOf(idx);\n  const ni = newIndices.indexOf(idx);\n  if (oi < 0 || ni < 0) return 0;\n\n  const oldCols = measureColumnsFromLayout(oldLayout.measures);\n  const newCols = measureColumnsFromLayout(newLayout.measures);\n  const oldBox = oldCols[oi];\n  const newBox = newCols[ni];\n  if (!oldBox || !newBox) return 0;\n\n  const fracY = oldBox.h > 0 ? (anchorY - oldBox.y) / oldBox.h : 0;\n  const newAnchorY = newBox.y + fracY * newBox.h;\n  return newAnchorY - anchorY;\n}\n\n// ─── Auto-follow discriminator (design doc §4) ─────────────────────────────\n//\n// The canvas scroll-mode player (notationPlayer.ts's `createScrollPlayer`)\n// discriminates \"our own programmatic scroll\" from \"a manual user scroll\" via\n// a fixed 600ms grace window after every `scrollIntoView` call. That has a\n// real failure mode (flagged in the canvas module's own review): a\n// longer-than-600ms smooth-scroll animation's LATER frames land after the\n// window closes and get misread as manual, suspending auto-follow mid-\n// animation; conversely a genuinely fast manual scroll DURING the window can\n// slip through unsuspended.\n//\n// Fix: compare against the EXACT target position this component itself\n// requested, not elapsed time. We control the scroll call ourselves\n// (`window.scrollTo({top, behavior:'smooth'})`, not `element.scrollIntoView`,\n// specifically so we know the target precisely) — every intermediate frame of\n// OUR OWN smooth-scroll animation reports a `window.scrollY` somewhere on the\n// straight line between where we started and where we're headed; it can never\n// overshoot or reverse past that. A scroll event reporting a position OUTSIDE\n// that span can therefore only be a manual scroll, and is classified as such\n// immediately, independent of animation duration.\n\n/** Tolerance, px, for \"close enough\" to count as the same position (float/\n *  sub-pixel scroll settling noise). */\nexport const PROGRAMMATIC_SCROLL_EPSILON_PX = 2;\n\n/**\n * True while `y` lies within `[min(start,target), max(start,target)]`\n * (± `epsilon`) — i.e. anywhere along the straight-line path of a\n * `window.scrollTo({top: target, behavior:'smooth'})` call issued from\n * `start`. A scroll event reporting a position outside this span cannot be a\n * frame of that animation.\n */\nexport function isWithinProgrammaticScroll(\n  y: number,\n  start: number,\n  target: number,\n  epsilon: number = PROGRAMMATIC_SCROLL_EPSILON_PX,\n): boolean {\n  const lo = Math.min(start, target) - epsilon;\n  const hi = Math.max(start, target) + epsilon;\n  return y >= lo && y <= hi;\n}\n\n/** True once `y` has settled at (within `epsilon` of) the programmatic\n *  scroll's target — the animation is complete, so tracking can be cleared. */\nexport function hasReachedProgrammaticTarget(\n  y: number,\n  target: number,\n  epsilon: number = PROGRAMMATIC_SCROLL_EPSILON_PX,\n): boolean {\n  return Math.abs(y - target) <= epsilon;\n}\n\n// ─── createSvgNotationPlayer ────────────────────────────────────────────────\n\nconst DEFAULT_PLAYHEAD_COLOR = '#2f6f4f';\n/** Engrave-width ceiling, CSS px (design doc §\"Render\": \"cap ~1200px, the\n *  0.36.2 rule\" — the same reasoning as notationPlayer.ts's\n *  `MAX_ENGRAVE_WIDTH`, restated here rather than imported since the two\n *  players' constants are independently tunable, and this one is spec'd to a\n *  slightly different value). */\nexport const MAX_ENGRAVE_WIDTH_SVG = 1200;\n/** Floor so a not-yet-laid-out / zero-width host never engraves at 0px. */\nconst MIN_ENGRAVE_WIDTH_SVG = 280;\n/** Same re-arm rule as the canvas scroll player's discontinuity detector —\n *  control-flow bookkeeping (not playhead/geometry math), copied verbatim. */\nconst SEEK_DISCONTINUITY_MS = 400;\n\nfunction nowMs(): number {\n  return typeof performance !== 'undefined' ? performance.now() : Date.now();\n}\n\n/** Build a live, interactive SVG (vector) notation player. See the module doc\n *  + `docs/superpowers/specs/2026-08-11-svg-notation-player-design.md` (in\n *  stave-web-sightread) for the full design. */\nexport function createSvgNotationPlayer(opts: CreateSvgNotationPlayerOpts): SvgNotationPlayer {\n  const { host, musicXml, onsetsMs, noteCols } = opts;\n  const playheadColor = opts.playheadColor ?? DEFAULT_PLAYHEAD_COLOR;\n  const onsets = distinctOnsets(onsetsMs.map((onsetMs) => ({ onsetMs })));\n\n  const root = document.createElement('div');\n  root.style.position = 'relative';\n  root.style.width = '100%';\n  // Let the browser's native pinch-zoom AND vertical page-scroll gestures\n  // through — the \"optical zoom is free\" half of the design (§5): vectors\n  // stay crisp at any pinch/browser-zoom level, and this component adds\n  // nothing to make that work beyond not blocking the gesture.\n  root.style.touchAction = 'pan-y pinch-zoom';\n  host.appendChild(root);\n\n  const svgHost = document.createElement('div');\n  root.appendChild(svgHost);\n\n  const playheadEl = document.createElement('div');\n  playheadEl.style.position = 'absolute';\n  playheadEl.style.left = '0px';\n  playheadEl.style.top = '0px';\n  playheadEl.style.width = '2px';\n  playheadEl.style.height = '0px';\n  playheadEl.style.background = playheadColor;\n  playheadEl.style.opacity = '0';\n  playheadEl.style.pointerEvents = 'none';\n  root.appendChild(playheadEl);\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let osmd: any = null;\n  let currentLayout: NotationLayout | null = null;\n  let currentZoom = opts.zoom ?? 1;\n  let unitInPixelsConst = 10; // overwritten by the real import before first use (rendered-seam path never reads it)\n  let lastEngravedWidthPx = 0;\n  let destroyed = false;\n  let lastTMs = 0;\n  // Stale-table guard (design doc §\"Known risks\" — \"Overlay drift on\n  // reflow\"): each async re-engrave captures its own token; if a NEWER\n  // reflow starts before an older one's `await` resolves, the older one's\n  // completion is a no-op instead of clobbering the newer geometry.\n  let rebuildToken = 0;\n\n  function desiredEngraveWidthPx(): number {\n    const w = host.clientWidth || 0;\n    return Math.max(MIN_ENGRAVE_WIDTH_SVG, Math.min(w || MAX_ENGRAVE_WIDTH_SVG, MAX_ENGRAVE_WIDTH_SVG));\n  }\n\n  // ─── Playhead ──────────────────────────────────────────────────────────\n\n  function renderPlayhead(tMs: number): void {\n    lastTMs = tMs;\n    if (!currentLayout) return;\n    const nBars = currentLayout.measures.length\n      ? Math.max(...currentLayout.measures.map((m) => m.index)) + 1\n      : 0;\n    const line = vstackAudioPlayheadLine(currentLayout, onsets, tMs, nBars, noteCols);\n    if (!line) {\n      playheadEl.style.opacity = '0';\n      return;\n    }\n    playheadEl.style.opacity = String(line.alpha);\n    playheadEl.style.left = `${line.x}px`;\n    playheadEl.style.top = `${line.y0}px`;\n    playheadEl.style.height = `${Math.max(0, line.y1 - line.y0)}px`;\n    maybeAutoFollow();\n  }\n\n  // ─── Auto-follow (target-position discriminator — see the module doc) ────\n\n  let autoFollowSuspended = false;\n  let programmaticStart: number | null = null;\n  let programmaticTarget: number | null = null;\n  let followRafPending = false;\n  let lastWallMs: number | null = null;\n  let lastMusicMs = 0;\n\n  function onWindowScroll(): void {\n    if (programmaticTarget != null && programmaticStart != null) {\n      const y = window.scrollY;\n      if (isWithinProgrammaticScroll(y, programmaticStart, programmaticTarget)) {\n        if (hasReachedProgrammaticTarget(y, programmaticTarget)) {\n          programmaticStart = null;\n          programmaticTarget = null;\n        }\n        return; // still (or just finished) our own scroll — don't suspend\n      }\n    }\n    autoFollowSuspended = true;\n    programmaticStart = null;\n    programmaticTarget = null;\n  }\n  const hasWindow = typeof window !== 'undefined' && typeof window.addEventListener === 'function';\n  if (hasWindow) window.addEventListener('scroll', onWindowScroll, { passive: true });\n\n  function detectDiscontinuity(tMs: number): void {\n    const now = nowMs();\n    if (lastWallMs != null) {\n      const dtMusic = tMs - lastMusicMs;\n      const dtWall = now - lastWallMs;\n      if (dtMusic < 0 || Math.abs(dtMusic - dtWall) > SEEK_DISCONTINUITY_MS) autoFollowSuspended = false;\n    } else {\n      autoFollowSuspended = false;\n    }\n    lastWallMs = now;\n    lastMusicMs = tMs;\n  }\n\n  function maybeAutoFollow(): void {\n    if (autoFollowSuspended || followRafPending) return;\n    if (typeof window === 'undefined' || typeof window.requestAnimationFrame !== 'function') return;\n    followRafPending = true;\n    window.requestAnimationFrame(() => {\n      followRafPending = false;\n      if (destroyed || autoFollowSuspended) return;\n      if (typeof playheadEl.getBoundingClientRect !== 'function') return;\n      const rect = playheadEl.getBoundingClientRect();\n      const vh = window.innerHeight;\n      if (!(vh > 0)) return;\n      if (rect.top >= vh * 0.25 && rect.top <= vh * 0.75) return; // comfortably in view\n      const start = window.scrollY;\n      const target = Math.max(0, start + rect.top - vh / 2);\n      programmaticStart = start;\n      programmaticTarget = target;\n      window.scrollTo({ top: target, left: window.scrollX, behavior: 'smooth' });\n    });\n  }\n\n  // ─── setTime ───────────────────────────────────────────────────────────\n\n  function setTime(tMs: number): void {\n    if (destroyed) return;\n    detectDiscontinuity(tMs);\n    renderPlayhead(tMs);\n  }\n\n  // ─── Engrave / reflow ──────────────────────────────────────────────────\n\n  async function initialEngrave(): Promise<void> {\n    if (opts.rendered) {\n      currentLayout = opts.rendered;\n      lastEngravedWidthPx = desiredEngraveWidthPx();\n      renderPlayhead(lastTMs);\n      return;\n    }\n    // Literal dynamic import — consumers' bundlers must statically see the\n    // specifier (same reasoning as promo.ts/notationPlayer.ts); a caller\n    // that only ever uses the `rendered` test seam never pulls OSMD in.\n    const { OpenSheetMusicDisplay, unitInPixels } = await import('opensheetmusicdisplay');\n    unitInPixelsConst = unitInPixels;\n    if (destroyed) return;\n\n    const widthPx = desiredEngraveWidthPx();\n    svgHost.style.width = `${widthPx}px`;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const inst: any = new OpenSheetMusicDisplay(svgHost, {\n      backend: 'svg',\n      autoResize: false,\n      drawTitle: false,\n      drawSubtitle: false,\n      drawComposer: false,\n      drawLyricist: false,\n      drawPartNames: false,\n    });\n    await inst.load(musicXml);\n    if (destroyed) return;\n    inst.Zoom = currentZoom;\n    inst.render();\n    if (destroyed) return;\n\n    osmd = inst;\n    lastEngravedWidthPx = widthPx;\n    currentLayout = svgNotationLayout(inst, { unitInPixels: unitInPixelsConst });\n    renderPlayhead(lastTMs);\n  }\n\n  const ready = initialEngrave();\n\n  /** Re-engrave at `newZoom` and the host's CURRENT width, preserving the\n   *  scroll position of whatever content is centered in the viewport right\n   *  now. Shared by both `setZoom` and `resize` (resize just passes the\n   *  unchanged `currentZoom`). No-op when neither the width nor the zoom\n   *  actually changed, or when using the `rendered` test seam (nothing to\n   *  re-engrave). */\n  async function reflow(newZoom: number): Promise<void> {\n    if (destroyed) return;\n    const widthPx = desiredEngraveWidthPx();\n    if (widthPx === lastEngravedWidthPx && newZoom === currentZoom) return;\n    if (opts.rendered || !osmd) {\n      currentZoom = newZoom;\n      return;\n    }\n\n    const myToken = ++rebuildToken;\n    const oldLayout = currentLayout;\n    const hasWin = typeof window !== 'undefined';\n    let anchorY: number | null = null;\n    const anchorX = widthPx / 2;\n    if (hasWin && typeof root.getBoundingClientRect === 'function') {\n      const r = root.getBoundingClientRect();\n      anchorY = window.innerHeight / 2 - r.top;\n    }\n\n    svgHost.style.width = `${widthPx}px`;\n    osmd.Zoom = newZoom;\n    // Re-run layout (not just a redraw): a width change must re-flow which\n    // measures land on which system, and — since we can't be certain a pure\n    // zoom change never affects line-breaking on every OSMD version — this is\n    // called unconditionally rather than gated to the width-only case.\n    osmd.updateGraphic();\n    osmd.render();\n    if (destroyed || myToken !== rebuildToken) return;\n\n    lastEngravedWidthPx = widthPx;\n    currentZoom = newZoom;\n    currentLayout = svgNotationLayout(osmd, { unitInPixels: unitInPixelsConst });\n\n    if (oldLayout && anchorY != null && hasWin) {\n      const delta = computeReflowScrollDelta(oldLayout, currentLayout, anchorX, anchorY);\n      if (Number.isFinite(delta) && Math.abs(delta) > 0.5) {\n        window.scrollTo({ top: Math.max(0, window.scrollY + delta), left: window.scrollX, behavior: 'auto' });\n      }\n    }\n    if (!destroyed) renderPlayhead(lastTMs);\n  }\n\n  // ─── Click-to-seek ─────────────────────────────────────────────────────\n\n  const clickListeners: Array<(measureIndex: number) => void> = [];\n  function onRootClick(e: MouseEvent): void {\n    if (!currentLayout) return;\n    const rect = root.getBoundingClientRect();\n    const mx = e.clientX - rect.left;\n    const my = e.clientY - rect.top;\n    const idx = hitTestMeasureAt(currentLayout, mx, my);\n    if (idx != null) for (const cb of clickListeners) cb(idx);\n  }\n  root.addEventListener('click', onRootClick);\n\n  return {\n    ready,\n    setTime,\n    async setZoom(z: number): Promise<void> {\n      await ready;\n      await reflow(z);\n    },\n    async resize(): Promise<void> {\n      await ready;\n      await reflow(currentZoom);\n    },\n    onMeasureClick(cb: (measureIndex: number) => void): () => void {\n      clickListeners.push(cb);\n      return () => {\n        const i = clickListeners.indexOf(cb);\n        if (i >= 0) clickListeners.splice(i, 1);\n      };\n    },\n    destroy(): void {\n      if (destroyed) return;\n      destroyed = true;\n      rebuildToken++;\n      root.removeEventListener('click', onRootClick);\n      if (hasWindow) window.removeEventListener('scroll', onWindowScroll);\n      clickListeners.length = 0;\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      try { (osmd as any)?.clear?.(); } catch { /* best-effort */ }\n      osmd = null;\n      currentLayout = null;\n      if (root.parentNode === host) host.removeChild(root);\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/scene/index.d.ts

@@ -2,8 +2,8 @@ import { A as AudioClock, S as Score, a as LayerFactory, R as RenderCtx, b as Sc
 export { L as Layer, d as SpectrumInput, e as SpectrumProps, W as WaveformInput, f as WaveformProps, s as scoreFromMusicXML, g as spectrumFactory, w as waveformFactory } from '../waveform-DdSMAbYQ.js';
 import { PromoTheme, RecordOpts, Scene, SafeBox } from '../video.js';
 import { RenderedNotation, Box } from '../promo.js';
-import { N as NotationLayout } from '../notationGeometry-CyYXJrUH.js';
-export { F as FOLLOW_BARS, a as FOLLOW_PAD, b as NotationLayoutOpts, c as NotationRect, P as PlayheadLine, d as audioPlayheadLine, e as cropAroundBox, f as cubicEaseInOut, g as distinctMeasureIndices, h as distinctOnsets, i as firstMeasureBox, j as followBoxAt, k as followWindowStart, l as lerpBox, m as measureColumnsFromLayout, n as measureCount, o as measureSpanBox, p as measureSystemMap, q as notationLayout, r as playheadLine, s as systemBox, v as vstackAudioPlayheadLine, t as vstackFollowBox } from '../notationGeometry-CyYXJrUH.js';
+import { N as NotationLayout } from '../notationGeometry-54fFq5yU.js';
+export { F as FOLLOW_BARS, a as FOLLOW_PAD, b as NotationLayoutOpts, c as NotationRect, P as PlayheadLine, d as audioPlayheadLine, e as cropAroundBox, f as cubicEaseInOut, g as distinctMeasureIndices, h as distinctOnsets, i as firstMeasureBox, j as followBoxAt, k as followWindowStart, m as lerpBox, n as measureColumnsFromLayout, o as measureCount, p as measureSpanBox, q as measureSystemMap, r as notationLayout, s as playheadLine, t as systemBox, v as vstackAudioPlayheadLine, u as vstackFollowBox } from '../notationGeometry-54fFq5yU.js';
 
 /** One scheduled audio event, in seconds RELATIVE to the schedule start. */
 interface AudioEvent {

package/dist/scene/index.js

@@ -9,6 +9,13 @@ import {
   noteNameToIndex,
   pitchClass
 } from "../chunk-GORQ5YMR.js";
+import {
+  getNotationEngraving,
+  notationFactory,
+  scrollCursorFactory,
+  setFollowLayoutProvider,
+  setNotationEngraving
+} from "../chunk-QGKDKXX2.js";
 import {
   FOLLOW_BARS,
   FOLLOW_PAD,
@@ -20,22 +27,17 @@ import {
   firstMeasureBox,
   followBoxAt,
   followWindowStart,
-  getNotationEngraving,
   lerpBox,
   measureColumnsFromLayout,
   measureCount,
   measureSpanBox,
   measureSystemMap,
-  notationFactory,
   notationLayout,
   playheadLine,
-  scrollCursorFactory,
-  setFollowLayoutProvider,
-  setNotationEngraving,
   systemBox,
   vstackAudioPlayheadLine,
   vstackFollowBox
-} from "../chunk-4565POLG.js";
+} from "../chunk-BHRDISMU.js";
 import {
   ctaScene,
   drawSafeGuides,