@real-music-packages/web-core 0.35.0 → 0.36.1

package/dist/scene/index.d.ts

@@ -1,7 +1,9 @@
 import { A as AudioClock, S as Score, a as LayerFactory, R as RenderCtx, b as ScoreFromMusicXMLOpts, T as TempoMap, c as ScoreNote } from '../waveform-DdSMAbYQ.js';
 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, StaffMeasureBox, MeasureColumnBox } from '../promo.js';
+import { RenderedNotation, Box } from '../promo.js';
+import { N as NotationLayout } from '../notationGeometry-CZJ0U6PQ.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-CZJ0U6PQ.js';
 
 /** One scheduled audio event, in seconds RELATIVE to the schedule start. */
 interface AudioEvent {
@@ -595,138 +597,6 @@ interface ScrollCursorProps {
 }
 declare const scrollCursorFactory: LayerFactory<ScrollCursorProps>;
 
-/** measures (= rows) visible at once in the follow window. */
-declare const FOLLOW_BARS = 2;
-/** breathing room around the follow window. */
-declare const FOLLOW_PAD = 1.06;
-/** Cubic ease-in-out, t in [0,1] (RSR port of stave-video core/camera.py). */
-declare function cubicEaseInOut(t: number): number;
-/** Linear interpolation of two boxes. (RSR lerpBox) */
-declare function lerpBox(a: Box, b: Box, e: number): Box;
-/** Smallest crop of `aspect` containing `box` padded by `pad`, clamped to the
- *  canvas. (RSR cropAroundBox) */
-declare function cropAroundBox(box: Box, aspect: number, pad: number, cw: number, ch: number): Box;
-/** Union (canvas coords) of all staff measure boxes with index in [lo,hi).
- *  (RSR measureSpanBox) */
-declare function measureSpanBox(rn: RenderedNotation, lo: number, hi: number): Box | null;
-/** Union of the index-0 measure boxes — the opening focal. (RSR firstMeasureBox) */
-declare function firstMeasureBox(rn: RenderedNotation): Box | null;
-/** Number of distinct measures in the notation. (RSR measureCount) */
-declare function measureCount(rn: RenderedNotation): number;
-/** The DISTINCT measure indices present in the engraving, ASCENDING. For excerpts
- *  these do NOT start at 0 (e.g. bars 5-8 → [4,5,6,7]) and may be non-contiguous,
- *  so the follow window must scroll across THESE indices, not a 0..measureCount
- *  range. (measureCount returns maxIndex+1 — a count valid only for 0-based scores.) */
-declare function distinctMeasureIndices(rn: RenderedNotation): number[];
-/** The follow window (canvas coords) for a continuous measure-start position,
- *  spanning FOLLOW_BARS and lerping between adjacent windows. (RSR followBoxAt) */
-declare function followBoxAt(rn: RenderedNotation, posMeasures: number): Box | null;
-/**
- * The continuous follow-window START measure (ABSOLUTE index) for an hstack
- * audio-clock progress 0..1.
- *
- * hstack (single horizontal staffline): pan CONTINUOUSLY so the playhead sits at a
- * stable fraction (`HSTACK_PLAYHEAD_LEAD`) from the LEFT of the window — the playing
- * bar is always on screen with look-ahead to its right, and the cursor never drifts
- * to the screen edge.
- *
- * BUG FIX (web-core 0.21.0) — playhead pinned at the right edge for EXCERPTS. This
- * used to take `nBars = measureCount(rn) = maxIndex+1` and pan progress across a
- * 0..nBars range. That is only correct when measure indices are 0-based: RSR's
- * excerpts engrave e.g. bars 5-8 → indices [4,5,6,7], so measureCount=8 but only 4
- * measures exist. The window then panned a phantom 0..8 axis while the playhead
- * (which steps over the 4 REAL columns) raced ahead — pinning the cursor at the far
- * right while the music barely scrolled. We now pan across the ACTUAL distinct
- * indices: progress 0..1 maps to absolute index `firstIndex .. firstIndex+nReal`,
- * and `followBoxAt` (which already indexes absolute measures via measureSpanBox)
- * frames the right bars. Clamped so the window never runs past the last measure.
- *
- * Pass the RenderedNotation so the real index range is known. (The legacy 0-based
- * `nBars`-only call still works via the `firstIndex=0, nReal=nBars` fallback.)
- */
-declare function followWindowStart(rn: RenderedNotation | number, camProgress01: number): number;
-/** For each measure index, the system (row) it lives on — ordered by index.
- *  Empty when geometry is missing. */
-declare function measureSystemMap(rn: RenderedNotation): number[];
-/** Union (canvas coords) of every measure box on system `sys`. Falls back to the
- *  system's own box when no measures map to it. */
-declare function systemBox(rn: RenderedNotation, sys: number, sysMap?: number[]): Box | null;
-/**
- * vstack follow window (canvas coords) for an audio-clock progress 0..1. Frames
- * the ACTIVE system (the row the playhead's current bar is on) and eases
- * VERTICALLY to the NEXT system over the tail of the active system's last bar, so
- * the next row slides up just as the playhead crosses into it. Within a system
- * the box is fixed (the playhead pans L→R inside it). No measure-window vertical
- * jumps: the focusBox always spans an integer-or-tween of FULL systems.
- *
- * The box keeps a constant size (the larger of the two framed systems' extents)
- * so the dest mapping doesn't breathe as it scrolls — the camera just translates.
- */
-declare function vstackFollowBox(rn: RenderedNotation, camProgress01: number): Box | null;
-/** The dest rect a notation frame is drawn into, on screen. */
-interface NotationRect {
-    dx: number;
-    dy: number;
-    dw: number;
-    dh: number;
-}
-/** Geometry result of laying out the notation for one frame: which canvas `src`
- *  rect is blitted to which screen `dest` rect, plus the mapped boxes. */
-interface NotationLayout {
-    /** Canvas-space crop blitted this frame. */
-    src: Box;
-    /** Screen-space dest rect. */
-    rect: NotationRect;
-    /** Per-row system boxes mapped into screen coords (for the playhead fallback). */
-    systems: Box[];
-    /** Per-(measure,staff) boxes mapped into screen coords (for highlights/cursor). */
-    measures: StaffMeasureBox[];
-}
-interface NotationLayoutOpts {
-    /** 0 = zoomed on bar 1, 1 = full excerpt (opening camera). Default 1. */
-    zoom01?: number;
-    /** Follow window (canvas coords); when set, overrides zoom and scrolls. */
-    focusBox?: Box | null;
-}
-/**
- * Compute the notation layout (src crop + dest rect + mapped boxes) for one
- * frame. This is RSR's `drawNotation` with the single `ctx.drawImage` call REMOVED
- * — pure geometry, so it is testable headless and shared by the notation +
- * scroll-cursor layers. The layer does the drawImage using `src` + `rect`.
- */
-declare function notationLayout(rn: RenderedNotation, W: number, H: number, boxTop: number, boxH: number, opts?: NotationLayoutOpts): NotationLayout;
-/** Per-measure grand-staff column boxes (both staves unioned) from a frame's
- *  mapped measures, in render order. (RSR measureColumns) */
-declare function measureColumnsFromLayout(measures: StaffMeasureBox[]): MeasureColumnBox[];
-/** The playhead line + alpha for progress `t01`. null when fully faded. (RSR
- *  drawPlayhead, with the actual stroke factored out into the layer.) */
-interface PlayheadLine {
-    x: number;
-    y0: number;
-    y1: number;
-    alpha: number;
-}
-declare function playheadLine(layout: NotationLayout, t01: number): PlayheadLine | null;
-/** Distinct, sorted note onsets from a Score's notes. */
-declare function distinctOnsets(notes: {
-    onsetMs: number;
-}[]): number[];
-/**
- * The FOOLPROOF audio-driven playhead line for absolute audio time `tMs`.
- *
- * `tMs` is the audio clock; `onsetsMs` are the score's distinct note onsets
- * (sorted). The cursor is the time-lerp of the two anchors bracketing `tMs`:
- * before the first onset it holds on anchor 0; after the last it holds on the
- * last; in a gap it eases between the bracketing onsets. Pure function of
- * (layout, onsetsMs, tMs). Returns null only when there is no geometry to anchor
- * to (falls back to the rect sweep in the layer, same as `playheadLine`).
- *
- * Fade in/out mirrors `playheadLine` but is keyed on position in the ONSET span
- * (first→last onset), not on musicMs — so the fade tracks the notes too.
- */
-declare function audioPlayheadLine(layout: NotationLayout, onsetsMs: number[], tMs: number, barDurMs?: number, noteCols?: number[]): PlayheadLine | null;
-declare function vstackAudioPlayheadLine(layout: NotationLayout, onsetsMs: number[], tMs: number, nBars: number, noteCols?: number[]): PlayheadLine | null;
-
 /** Map a canvas-space box through a base notation layout into world/screen coords. */
 declare function mapBoxThroughLayout(base: NotationLayout, b: Box): Box;
 /** RSR's per-frame `src` crop from a follow box (FOLLOW_PAD expand + clamp) —
@@ -1825,4 +1695,4 @@ interface ImageRevealProps {
 }
 declare const imageRevealFactory: LayerFactory<ImageRevealProps>;
 
-export { type Affine, AudioClock, type AudioEvent, type BackgroundProps, type BeatGridOpts, type BeatPulseProps, type BeatTick, type BrandingProps, type BufferFactory, type BuildSceneOpts, type BuiltScene, type CameraState, type CaptionCue, type CaptionProps, type CaptionScript, type CaptionStyle, type ChordRibbonProps, type ChordSpan, type CircleOfFifthsProps, type CirclePoint, type ClickTrackOpts, type ColorBy, type ContourPlot, type ContourPoint, type CountInOpts, type CountdownProps, type CountingTrackProps, type CtaProps, DEFAULT_FUNCTION_COLORS, type DegreeLabel, type DegreeLabelsProps, type DroneOpts, type DuckWindow, type Easing, type EndCardProps, type ExtendedDemoOpts, FIFTHS_MAJOR, FIFTHS_MINOR, FOLLOW_BARS, FOLLOW_PAD, type FallingKeyboardDemoOpts, type FallingNotesProps, type FretboardProps, type FunctionColors, type FunctionalHarmonyProps, type GateError, type GateInput, type HandColors, type HarmonicFunction, type HarmonyMode, type HighlightRegion, type HookProps, type ImageRevealMode, type ImageRevealProps, type IntervalArcsProps, type KaraokeCaptionProps, type KaraokeWord, type KeyRect, type KeyboardLayout, type KeyboardLayoutOpts, type KeyboardProps, type KineticMode, type KineticTextProps, type LabelMode, LayerFactory, type McqCardProps, type NotationEngraving, type NotationLayout, type NotationLayoutOpts, type NotationProps, type NotationRect, type OutputProbe, PIANO_HIGH, PIANO_LOW, type ParticleBurstProps, type PitchContourProps, type Placement, type PlayheadLine, type PortraitProps, type ProgressRingProps, type PromoCardsDemoOpts, type PulseStyle, type Quiz, type QuizOption, type QuizPhase, type RadialSpectrumProps, type RayEndpoints, type RecordSceneSpecOpts, type Rect, RenderCtx, type ResolvedSegment, type RevealEasing, type RevealProps, SCALE_INTERVALS, type SafeGuidesProps, type ScaleHighlightProps, type SceneSpec, type ScheduleTarget, Score, ScoreFromMusicXMLOpts, ScoreNote, type ScrollCursorProps, type Section, type SectionMinimapProps, type SegmentAudio, type SegmentAudioCtx, type SegmentTransition, type SpecLayer, type StaffKeyboardRayProps, type StatCounterProps, TempoMap, type TensionGraphProps, type TensionPoint, type TextureProps, type TimeAnchor, type TimelineSegment, activeChord, activeCue, activeSection, animatedSlot, applySchedule, applyToContext, assertGate, audioPlayheadLine, ballArc, ballX, beatGrid, beatPhase, beatPulseFactory, blackKeys, bpmOf, brandingFactory, buildScene, cameraForFollow, cameraTransform, chordRibbonFactory, circleOfFifthsDemoSpec, circleOfFifthsFactory, clamp, clickTrackSchedule, contourMinimapDemoSpec, contourPoints, contourPolyline, countInLeadSec, countInSchedule, countdownFactory, countdownRemaining, countdownSeconds, countingDegreeDemoSpec, countingTrackFactory, cropAroundBox, ctaFactory, cubicEaseInOut, cueOpacity, degreeLabel, degreeLabelsFactory, distinctMeasureIndices, distinctOnsets, dotAt, drawCaption, drawHighlight, droneSchedule, duckGainAt, easeIn, easeInOut, easeOut, endCardFactory, fallingKeyboardDemoScore, fallingKeyboardDemoSpec, fallingNotesFactory, firstMeasureBox, followBoxAt, followSrcBox, followWindowStart, fracSlotPoint, frameRect, fretboardFactory, functionColor, functionalHarmonyFactory, getKeyboardLayout, getLayerFactory, getNotationEngraving, harmonyDemoSpec, highlightIntensity, hookFactory, identityCamera, imageRevealFactory, inRange, intervalArcsFactory, invLerp, isBlackKey, karaokeCaptionFactory, kenBurns, keyCenterX, keyColumnWidth, keyRect, keySlot, keyboardFactory, keyboardLayout, kineticTextFactory, lerp, lerpBox, lerpCamera, linear, mapBoxThroughLayout, mcqCardFactory, mcqDemoSpec, measureColumnsFromLayout, measureCount, measureSpanBox, measureSpans, measureSystemMap, timeToX as minimapTimeToX, msPerBeat, notationFactory, notationLayout, noteColor, noteSetXRange, parseKey, parseTimeSig, particleBurstFactory, pcToSlot, pitchAt, pitchContourFactory, pitchRange, playheadLine, portraitFactory, progress01, progressRingFactory, projectPoint, promoCardsDemoSpec, pulseAt, quizPhase, radialSpectrumFactory, rayEndpoints, rayPointAt, recordSceneSpec, registerLayer, registeredKeys, resolveAnchor, resolveKeyboardLayout, resolveTimeline, revealFactory, revealProgress, runGate, safeGuidesFactory, scaleHighlightFactory, scorePitchSpan, scrollCursorFactory, sectionMinimapFactory, setFollowLayoutProvider, setKeyboardLayout, setNotationEngraving, slotAngle, slotPc, slotPoint, staffAnchor, staffKeyboardRayFactory, staffRayDemoSpec, statCounterFactory, systemBox, tensionGraphFactory, textureFactory, transitionProgress, validateChordTrack, validateQuiz, validateSections, visualTimelineMs, vstackAudioPlayheadLine, vstackFollowBox, whiteKeys, worldToViewport };
+export { type Affine, AudioClock, type AudioEvent, type BackgroundProps, type BeatGridOpts, type BeatPulseProps, type BeatTick, type BrandingProps, type BufferFactory, type BuildSceneOpts, type BuiltScene, type CameraState, type CaptionCue, type CaptionProps, type CaptionScript, type CaptionStyle, type ChordRibbonProps, type ChordSpan, type CircleOfFifthsProps, type CirclePoint, type ClickTrackOpts, type ColorBy, type ContourPlot, type ContourPoint, type CountInOpts, type CountdownProps, type CountingTrackProps, type CtaProps, DEFAULT_FUNCTION_COLORS, type DegreeLabel, type DegreeLabelsProps, type DroneOpts, type DuckWindow, type Easing, type EndCardProps, type ExtendedDemoOpts, FIFTHS_MAJOR, FIFTHS_MINOR, type FallingKeyboardDemoOpts, type FallingNotesProps, type FretboardProps, type FunctionColors, type FunctionalHarmonyProps, type GateError, type GateInput, type HandColors, type HarmonicFunction, type HarmonyMode, type HighlightRegion, type HookProps, type ImageRevealMode, type ImageRevealProps, type IntervalArcsProps, type KaraokeCaptionProps, type KaraokeWord, type KeyRect, type KeyboardLayout, type KeyboardLayoutOpts, type KeyboardProps, type KineticMode, type KineticTextProps, type LabelMode, LayerFactory, type McqCardProps, type NotationEngraving, NotationLayout, type NotationProps, type OutputProbe, PIANO_HIGH, PIANO_LOW, type ParticleBurstProps, type PitchContourProps, type Placement, type PortraitProps, type ProgressRingProps, type PromoCardsDemoOpts, type PulseStyle, type Quiz, type QuizOption, type QuizPhase, type RadialSpectrumProps, type RayEndpoints, type RecordSceneSpecOpts, type Rect, RenderCtx, type ResolvedSegment, type RevealEasing, type RevealProps, SCALE_INTERVALS, type SafeGuidesProps, type ScaleHighlightProps, type SceneSpec, type ScheduleTarget, Score, ScoreFromMusicXMLOpts, ScoreNote, type ScrollCursorProps, type Section, type SectionMinimapProps, type SegmentAudio, type SegmentAudioCtx, type SegmentTransition, type SpecLayer, type StaffKeyboardRayProps, type StatCounterProps, TempoMap, type TensionGraphProps, type TensionPoint, type TextureProps, type TimeAnchor, type TimelineSegment, activeChord, activeCue, activeSection, animatedSlot, applySchedule, applyToContext, assertGate, ballArc, ballX, beatGrid, beatPhase, beatPulseFactory, blackKeys, bpmOf, brandingFactory, buildScene, cameraForFollow, cameraTransform, chordRibbonFactory, circleOfFifthsDemoSpec, circleOfFifthsFactory, clamp, clickTrackSchedule, contourMinimapDemoSpec, contourPoints, contourPolyline, countInLeadSec, countInSchedule, countdownFactory, countdownRemaining, countdownSeconds, countingDegreeDemoSpec, countingTrackFactory, ctaFactory, cueOpacity, degreeLabel, degreeLabelsFactory, dotAt, drawCaption, drawHighlight, droneSchedule, duckGainAt, easeIn, easeInOut, easeOut, endCardFactory, fallingKeyboardDemoScore, fallingKeyboardDemoSpec, fallingNotesFactory, followSrcBox, fracSlotPoint, frameRect, fretboardFactory, functionColor, functionalHarmonyFactory, getKeyboardLayout, getLayerFactory, getNotationEngraving, harmonyDemoSpec, highlightIntensity, hookFactory, identityCamera, imageRevealFactory, inRange, intervalArcsFactory, invLerp, isBlackKey, karaokeCaptionFactory, kenBurns, keyCenterX, keyColumnWidth, keyRect, keySlot, keyboardFactory, keyboardLayout, kineticTextFactory, lerp, lerpCamera, linear, mapBoxThroughLayout, mcqCardFactory, mcqDemoSpec, measureSpans, timeToX as minimapTimeToX, msPerBeat, notationFactory, noteColor, noteSetXRange, parseKey, parseTimeSig, particleBurstFactory, pcToSlot, pitchAt, pitchContourFactory, pitchRange, portraitFactory, progress01, progressRingFactory, projectPoint, promoCardsDemoSpec, pulseAt, quizPhase, radialSpectrumFactory, rayEndpoints, rayPointAt, recordSceneSpec, registerLayer, registeredKeys, resolveAnchor, resolveKeyboardLayout, resolveTimeline, revealFactory, revealProgress, runGate, safeGuidesFactory, scaleHighlightFactory, scorePitchSpan, scrollCursorFactory, sectionMinimapFactory, setFollowLayoutProvider, setKeyboardLayout, setNotationEngraving, slotAngle, slotPc, slotPoint, staffAnchor, staffKeyboardRayFactory, staffRayDemoSpec, statCounterFactory, tensionGraphFactory, textureFactory, transitionProgress, validateChordTrack, validateQuiz, validateSections, visualTimelineMs, whiteKeys, worldToViewport };