@hyperframes/core 0.8.120 → 0.8.122

package/dist/runtime/clock.d.ts

@@ -0,0 +1,64 @@
+import { type RateSpec } from "../speedRamp.js";
+export type TransportClockSnapshot = {
+    time: number;
+    playing: boolean;
+    rate: number;
+    duration: number;
+    source: "monotonic" | "audio";
+};
+export type AudioClockSource = {
+    el: HTMLMediaElement;
+    compositionStart: number;
+    mediaStart: number;
+    /** The clip's rate lane; a constant rate is read from `el.playbackRate`. */
+    rate?: RateSpec;
+} | {
+    currentTimeSeconds: number;
+};
+export declare class TransportClock {
+    private _baseTime;
+    private _playStartMs;
+    private _rate;
+    private _duration;
+    private _playStart;
+    private _playEnd;
+    private _playHold;
+    private _nowMs;
+    private _audioSource;
+    /** Wall-clock time of the last `now()` read while playing; null while paused. */
+    private _lastReadMs;
+    private _lastNow;
+    constructor(opts?: {
+        initialTime?: number;
+        rate?: number;
+        duration?: number;
+        nowMs?: () => number;
+    });
+    now(): number;
+    private _elementTimeNeverBehind;
+    private _heldTimeWhenBehind;
+    /** Folds a >500ms gap since the last read into `_playStartMs` so it's never reported as played time. */
+    private _applyStallCorrection;
+    play(): boolean;
+    pause(): boolean;
+    seek(timeSeconds: number): void;
+    isPlaying(): boolean;
+    setRate(rate: number): void;
+    getRate(): number;
+    setDuration(duration: number): void;
+    getDuration(): number;
+    setPlayRange(start: number, end: number | null, fps: number): void;
+    getPlayStart(): number;
+    getEnd(): number;
+    /** Where a stop parks: the film's end, or a range's last frame, since the moment is [start, end). */
+    getStopTime(): number;
+    attachAudioSource(source: AudioClockSource): void;
+    detachAudioSource(): void;
+    /** The element the playhead currently follows, if the source is one. */
+    audioElement(): HTMLMediaElement | null;
+    hasAudioSource(): boolean;
+    getSource(): "monotonic" | "audio";
+    snapshot(): TransportClockSnapshot;
+    reachedEnd(): boolean;
+}
+//# sourceMappingURL=clock.d.ts.map

package/dist/runtime/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../src/runtime/clock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIlE,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB;IACE,EAAE,EAAE,gBAAgB,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB,GACD;IACE,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAON,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAiC;IACrD,iFAAiF;IACjF,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,QAAQ,CAAK;gBAET,IAAI,CAAC,EAAE;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;KACtB;IAOD,GAAG,IAAI,MAAM;IAgCb,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,mBAAmB;IAM3B,wGAAwG;IACxG,OAAO,CAAC,qBAAqB;IAY7B,IAAI,IAAI,OAAO;IAaf,KAAK,IAAI,OAAO;IAOhB,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAc/B,SAAS,IAAI,OAAO;IAIpB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAU3B,OAAO,IAAI,MAAM;IAIjB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOnC,WAAW,IAAI,MAAM;IAIrB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAMlE,YAAY,IAAI,MAAM;IAItB,MAAM,IAAI,MAAM;IAIhB,qGAAqG;IACrG,WAAW,IAAI,MAAM;IAIrB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAIjD,iBAAiB,IAAI,IAAI;IAWzB,wEAAwE;IACxE,YAAY,IAAI,gBAAgB,GAAG,IAAI;IAIvC,cAAc,IAAI,OAAO;IAIzB,SAAS,IAAI,WAAW,GAAG,OAAO;IASlC,QAAQ,IAAI,sBAAsB;IAUlC,UAAU,IAAI,OAAO;CAItB"}

package/dist/runtime/clock.js

@@ -0,0 +1,204 @@
+import { timeAtSourceTime } from "../speedRamp.js";
+import { MEDIA_HARD_SYNC_SECONDS } from "./media.js";
+import { playRangeHoldTime } from "./protocol.js";
+/** GSAP's own `lagSmoothing` default — see the PR body for why this clock needs its own copy. */
+const STALL_THRESHOLD_MS = 500;
+const STALL_ADJUSTED_LAG_MS = 33;
+const HAVE_FUTURE_DATA = 3;
+export class TransportClock {
+    _baseTime = 0;
+    _playStartMs = null;
+    _rate = 1;
+    _duration = Infinity;
+    _playStart = 0;
+    _playEnd = Infinity;
+    _playHold = Infinity;
+    _nowMs;
+    _audioSource = null;
+    /** Wall-clock time of the last `now()` read while playing; null while paused. */
+    _lastReadMs = null;
+    _lastNow = 0;
+    constructor(opts) {
+        this._baseTime = opts?.initialTime ?? 0;
+        this._rate = opts?.rate ?? 1;
+        this._duration = opts?.duration ?? Infinity;
+        this._nowMs = opts?.nowMs ?? (() => performance.now());
+    }
+    now() {
+        if (this._playStartMs === null)
+            return this._baseTime;
+        // Audio-master: drift is impossible because audio IS the clock. Clearing
+        // `_lastReadMs` (not stamping it) means the next monotonic read starts
+        // fresh from `_playStartMs` instead of a timestamp audio just made
+        // meaningless — see the PR body.
+        if (this._audioSource) {
+            let audioTime = null;
+            if ("currentTimeSeconds" in this._audioSource) {
+                audioTime = this._audioSource.currentTimeSeconds;
+            }
+            else {
+                audioTime = this._elementTimeNeverBehind(this._audioSource);
+            }
+            if (audioTime !== null) {
+                const t = Math.min(audioTime, this.getEnd());
+                this._baseTime = Math.max(0, t);
+                this._playStartMs = this._nowMs();
+                this._lastReadMs = null;
+                this._lastNow = this._baseTime;
+                return this._baseTime;
+            }
+        }
+        // Monotonic fallback
+        this._applyStallCorrection();
+        const elapsed = (this._nowMs() - this._playStartMs) / 1000;
+        const t = this._baseTime + elapsed * this._rate;
+        this._lastNow = Math.max(0, Math.min(t, this.getEnd()));
+        return this._lastNow;
+    }
+    _elementTimeNeverBehind(source) {
+        const { el, compositionStart, mediaStart, rate } = source;
+        if (el.paused || !Number.isFinite(el.currentTime))
+            return null;
+        if (el.seeking)
+            return this._lastNow;
+        const spec = rate ?? 1;
+        const time = timeAtSourceTime(spec, el.currentTime - mediaStart) + compositionStart;
+        return time >= this._lastNow ? time : this._heldTimeWhenBehind(el, this._lastNow - time, spec);
+    }
+    _heldTimeWhenBehind(el, behind, spec) {
+        if (el.loop && behind > timeAtSourceTime(spec, el.duration) / 2)
+            return null;
+        const buffering = el.readyState < HAVE_FUTURE_DATA;
+        return buffering || behind <= MEDIA_HARD_SYNC_SECONDS ? this._lastNow : null;
+    }
+    /** Folds a >500ms gap since the last read into `_playStartMs` so it's never reported as played time. */
+    _applyStallCorrection() {
+        if (this._playStartMs === null)
+            return;
+        const nowMs = this._nowMs();
+        if (this._lastReadMs !== null) {
+            const gapMs = nowMs - this._lastReadMs;
+            if (gapMs > STALL_THRESHOLD_MS) {
+                this._playStartMs += gapMs - STALL_ADJUSTED_LAG_MS;
+            }
+        }
+        this._lastReadMs = nowMs;
+    }
+    play() {
+        if (this._playStartMs !== null)
+            return false;
+        if (this._baseTime >= this.getEnd())
+            return false;
+        this._playStartMs = this._nowMs();
+        this._lastNow = this._baseTime;
+        // Not a stall: the gap since the clock was last read (possibly a long
+        // paused idle) says nothing about lost playback time, since none was
+        // playing. `_applyStallCorrection` treats null as "nothing to compare
+        // against yet" and starts the window fresh from the next read.
+        this._lastReadMs = null;
+        return true;
+    }
+    pause() {
+        if (this._playStartMs === null)
+            return false;
+        this._baseTime = this.now();
+        this._playStartMs = null;
+        return true;
+    }
+    seek(timeSeconds) {
+        const clamped = Number.isFinite(this._duration)
+            ? Math.max(0, Math.min(timeSeconds, this._duration))
+            : Math.max(0, timeSeconds);
+        this._baseTime = clamped;
+        this._lastNow = clamped;
+        if (this._playStartMs !== null) {
+            this._playStartMs = this._nowMs();
+            // Same reasoning as `play()`: the seek itself, not any elapsed gap
+            // since the last read, is why the reported time is moving now.
+            this._lastReadMs = null;
+        }
+    }
+    isPlaying() {
+        return this._playStartMs !== null;
+    }
+    setRate(rate) {
+        const safe = Number.isFinite(rate) && rate > 0 ? Math.max(0.1, Math.min(5, rate)) : 1;
+        if (this._playStartMs !== null) {
+            this._baseTime = this.now();
+            this._playStartMs = this._nowMs();
+            this._lastReadMs = null;
+        }
+        this._rate = safe;
+    }
+    getRate() {
+        return this._rate;
+    }
+    setDuration(duration) {
+        this._duration = Number.isFinite(duration) && duration > 0 ? duration : Infinity;
+        if (this._baseTime > this._duration) {
+            this._baseTime = this._duration;
+        }
+    }
+    getDuration() {
+        return this._duration;
+    }
+    setPlayRange(start, end, fps) {
+        this._playStart = Number.isFinite(start) && start > 0 ? start : 0;
+        this._playEnd = end !== null && Number.isFinite(end) && end > this._playStart ? end : Infinity;
+        this._playHold = playRangeHoldTime(this._playStart, this._playEnd, fps);
+    }
+    getPlayStart() {
+        return this._playStart;
+    }
+    getEnd() {
+        return Math.min(this._duration, this._playEnd);
+    }
+    /** Where a stop parks: the film's end, or a range's last frame, since the moment is [start, end). */
+    getStopTime() {
+        return this._playEnd < this._duration ? this._playHold : this.getEnd();
+    }
+    attachAudioSource(source) {
+        this._audioSource = source;
+    }
+    detachAudioSource() {
+        if (this._audioSource && this._playStartMs !== null) {
+            this._baseTime = this.now();
+            this._playStartMs = this._nowMs();
+            // Falling back to monotonic timing fresh, same reasoning as `play()`:
+            // any gap while audio was the time source is not a monotonic stall.
+            this._lastReadMs = null;
+        }
+        this._audioSource = null;
+    }
+    /** The element the playhead currently follows, if the source is one. */
+    audioElement() {
+        return this._audioSource && "el" in this._audioSource ? this._audioSource.el : null;
+    }
+    hasAudioSource() {
+        return this._audioSource !== null;
+    }
+    getSource() {
+        if (this._audioSource && this._playStartMs !== null) {
+            if ("currentTimeSeconds" in this._audioSource)
+                return "audio";
+            const { el } = this._audioSource;
+            if (!el.paused && Number.isFinite(el.currentTime))
+                return "audio";
+        }
+        return "monotonic";
+    }
+    snapshot() {
+        return {
+            time: this.now(),
+            playing: this.isPlaying(),
+            rate: this._rate,
+            duration: this._duration,
+            source: this.getSource(),
+        };
+    }
+    reachedEnd() {
+        const time = this.now();
+        return time >= this.getEnd() || (this._playStartMs === null && time >= this.getStopTime());
+    }
+}
+//# sourceMappingURL=clock.js.map

package/dist/runtime/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/runtime/clock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAiB,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAsBlD,iGAAiG;AACjG,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACjC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B,MAAM,OAAO,cAAc;IACjB,SAAS,GAAG,CAAC,CAAC;IACd,YAAY,GAAkB,IAAI,CAAC;IACnC,KAAK,GAAG,CAAC,CAAC;IACV,SAAS,GAAG,QAAQ,CAAC;IACrB,UAAU,GAAG,CAAC,CAAC;IACf,QAAQ,GAAG,QAAQ,CAAC;IACpB,SAAS,GAAG,QAAQ,CAAC;IACrB,MAAM,CAAe;IACrB,YAAY,GAA4B,IAAI,CAAC;IACrD,iFAAiF;IACzE,WAAW,GAAkB,IAAI,CAAC;IAClC,QAAQ,GAAG,CAAC,CAAC;IAErB,YAAY,IAKX;QACC,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,WAAW,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,QAAQ,IAAI,QAAQ,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,GAAG;QACD,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QAEtD,yEAAyE;QACzE,uEAAuE;QACvE,mEAAmE;QACnE,iCAAiC;QACjC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,SAAS,GAAkB,IAAI,CAAC;YACpC,IAAI,oBAAoB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC9C,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,SAAS,GAAG,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC9D,CAAC;YACD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;gBAClC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;gBACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC/B,OAAO,IAAI,CAAC,SAAS,CAAC;YACxB,CAAC;QACH,CAAC;QAED,qBAAqB;QACrB,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;QAC3D,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,GAAG,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAEO,uBAAuB,CAC7B,MAA2D;QAE3D,MAAM,EAAE,EAAE,EAAE,gBAAgB,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAC1D,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/D,IAAI,EAAE,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,GAAG,UAAU,CAAC,GAAG,gBAAgB,CAAC;QACpF,OAAO,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;IACjG,CAAC;IAEO,mBAAmB,CAAC,EAAoB,EAAE,MAAc,EAAE,IAAc;QAC9E,IAAI,EAAE,CAAC,IAAI,IAAI,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7E,MAAM,SAAS,GAAG,EAAE,CAAC,UAAU,GAAG,gBAAgB,CAAC;QACnD,OAAO,SAAS,IAAI,MAAM,IAAI,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/E,CAAC;IAED,wGAAwG;IAChG,qBAAqB;QAC3B,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI;YAAE,OAAO;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;YACvC,IAAI,KAAK,GAAG,kBAAkB,EAAE,CAAC;gBAC/B,IAAI,CAAC,YAAY,IAAI,KAAK,GAAG,qBAAqB,CAAC;YACrD,CAAC;QACH,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC7C,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE;YAAE,OAAO,KAAK,CAAC;QAClD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAC/B,sEAAsE;QACtE,qEAAqE;QACrE,sEAAsE;QACtE,+DAA+D;QAC/D,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,WAAmB;QACtB,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;YAC7C,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACpD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC/B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAClC,mEAAmE;YACnE,+DAA+D;YAC/D,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC;IACpC,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtF,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC/B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAClC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;QACjF,IAAI,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAClC,CAAC;IACH,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,YAAY,CAAC,KAAa,EAAE,GAAkB,EAAE,GAAW;QACzD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,QAAQ,GAAG,GAAG,KAAK,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC/F,IAAI,CAAC,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC1E,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,qGAAqG;IACrG,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACzE,CAAC;IAED,iBAAiB,CAAC,MAAwB;QACxC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;IAC7B,CAAC;IAED,iBAAiB;QACf,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YACpD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAClC,sEAAsE;YACtE,oEAAoE;YACpE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,wEAAwE;IACxE,YAAY;QACV,OAAO,IAAI,CAAC,YAAY,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACtF,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC;IACpC,CAAC;IAED,SAAS;QACP,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YACpD,IAAI,oBAAoB,IAAI,IAAI,CAAC,YAAY;gBAAE,OAAO,OAAO,CAAC;YAC9D,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC;YACjC,IAAI,CAAC,EAAE,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,CAAC;gBAAE,OAAO,OAAO,CAAC;QACpE,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;YAChB,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE;YACzB,IAAI,EAAE,IAAI,CAAC,KAAK;YAChB,QAAQ,EAAE,IAAI,CAAC,SAAS;YACxB,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE;SACzB,CAAC;IACJ,CAAC;IAED,UAAU;QACR,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACxB,OAAO,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,KAAK,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7F,CAAC;CACF"}

package/dist/runtime/compositionDimension.d.ts

@@ -2,5 +2,5 @@
 export declare function parseLayoutDimension(value: string | null | undefined): number | null;
 /** The size the runtime reports to its host: whole px, read with `parseInt` as the renderer does. */
 export declare function parseCompositionDimension(value: string | null | undefined): number | null;
-export declare function findRootCompositionElement(): HTMLElement | null;
+export declare function findRootCompositionElement(doc?: ParentNode): HTMLElement | null;
 //# sourceMappingURL=compositionDimension.d.ts.map

package/dist/runtime/compositionDimension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compositionDimension.d.ts","sourceRoot":"","sources":["../../src/runtime/compositionDimension.ts"],"names":[],"mappings":"AAEA,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIpF;AAED,qGAAqG;AACrG,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIzF;AAED,wBAAgB,0BAA0B,IAAI,WAAW,GAAG,IAAI,CAK/D"}
+{"version":3,"file":"compositionDimension.d.ts","sourceRoot":"","sources":["../../src/runtime/compositionDimension.ts"],"names":[],"mappings":"AAEA,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIpF;AAED,qGAAqG;AACrG,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIzF;AAED,wBAAgB,0BAA0B,CAAC,GAAG,GAAE,UAAqB,GAAG,WAAW,GAAG,IAAI,CAKzF"}

package/dist/runtime/compositionDimension.js

@@ -13,11 +13,11 @@ export function parseCompositionDimension(value) {
     const parsed = Number.parseInt(value, 10);
     return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
 }
-export function findRootCompositionElement() {
-    const explicitRoot = document.querySelector('[data-composition-id][data-root="true"]');
+export function findRootCompositionElement(doc = document) {
+    const explicitRoot = doc.querySelector('[data-composition-id][data-root="true"]');
     if (isHtmlElement(explicitRoot))
         return explicitRoot;
     // The first composition in document order never sits inside another one.
-    return document.querySelector("[data-composition-id]");
+    return doc.querySelector("[data-composition-id]");
 }
 //# sourceMappingURL=compositionDimension.js.map

package/dist/runtime/compositionDimension.js.map

@@ -1 +1 @@
-{"version":3,"file":"compositionDimension.js","sourceRoot":"","sources":["../../src/runtime/compositionDimension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,8FAA8F;AAC9F,MAAM,UAAU,oBAAoB,CAAC,KAAgC;IACnE,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,yBAAyB,CAAC,KAAgC;IACxE,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,MAAM,YAAY,GAAG,QAAQ,CAAC,aAAa,CAAC,yCAAyC,CAAC,CAAC;IACvF,IAAI,aAAa,CAAC,YAAY,CAAC;QAAE,OAAO,YAAY,CAAC;IACrD,yEAAyE;IACzE,OAAO,QAAQ,CAAC,aAAa,CAAc,uBAAuB,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"compositionDimension.js","sourceRoot":"","sources":["../../src/runtime/compositionDimension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,8FAA8F;AAC9F,MAAM,UAAU,oBAAoB,CAAC,KAAgC;IACnE,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,yBAAyB,CAAC,KAAgC;IACxE,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAkB,QAAQ;IACnE,MAAM,YAAY,GAAG,GAAG,CAAC,aAAa,CAAC,yCAAyC,CAAC,CAAC;IAClF,IAAI,aAAa,CAAC,YAAY,CAAC;QAAE,OAAO,YAAY,CAAC;IACrD,yEAAyE;IACzE,OAAO,GAAG,CAAC,aAAa,CAAc,uBAAuB,CAAC,CAAC;AACjE,CAAC"}

package/dist/runtime/compositionLength.d.ts

@@ -0,0 +1,44 @@
+import { type CompositionDurationResult } from "@hyperframes/parsers/composition-duration";
+import { findRootCompositionElement } from "./compositionDimension";
+import { createRuntimeStartTimeResolver } from "./startResolver";
+export { findRootCompositionElement };
+/** One frame at 60 fps: a timeline, floor or fallback this short or shorter is no length at all. */
+export declare const MIN_VALID_TIMELINE_DURATION_SECONDS: number;
+type StartResolver = Pick<ReturnType<typeof createRuntimeStartTimeResolver>, "resolveStartForElement" | "resolveDurationForElement">;
+/** The size the runtime reports to its host. */
+export declare function readCompositionSize(root: Element): {
+    width: number | null;
+    height: number | null;
+};
+/** The latest end among the document's timed video and audio, at their absolute starts. */
+export declare function resolveMediaWindowDurationSeconds(doc: ParentNode, media: {
+    mediaStart: (el: HTMLMediaElement) => number;
+    mediaDuration: (el: HTMLMediaElement) => number | null;
+}): number | null;
+/** The latest of the root's declared length and its direct sub-compositions' ends. */
+export declare function resolveAuthoredCompositionFloorSeconds(root: Element, startResolver: StartResolver): number | null;
+/** The last-resort length: the latest end among the root's timed clips. Until every clip's length
+ *  is known it is unresolved, so a renderer that reads it once cannot lock in a short one.
+ *  `unregisteredLottie`: a Lottie library is loaded, so animations may still register. */
+export declare function resolveContentDerivedDuration(root: Element, startResolver: StartResolver, { unregisteredLottie }: {
+    unregisteredLottie: boolean;
+}): CompositionDurationResult;
+export type CompositionLengthInputs = {
+    declared: number | null;
+    timeline: () => number | null;
+    floors: () => ReadonlyArray<number | null>;
+    fallback: number;
+    derived: () => number;
+};
+/** A declared root length is the length (a longer timeline is cut off); else the timeline, the
+ *  floors and the fallback, whichever is longest; else the length derived from the clips. */
+export declare function resolveCompositionLengthSeconds(input: CompositionLengthInputs): number;
+/** Size, frame rate and length of a composition nothing is running (a server-parsed or detached
+ *  document): no timelines, no adapters, and media without a known source length is pending. */
+export declare function readStaticCompositionMeta(doc: Document): {
+    width: number | null;
+    height: number | null;
+    fps: number;
+    durationSeconds: number;
+} | null;
+//# sourceMappingURL=compositionLength.d.ts.map

package/dist/runtime/compositionLength.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compositionLength.d.ts","sourceRoot":"","sources":["../../src/runtime/compositionLength.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,0BAA0B,EAA6B,MAAM,wBAAwB,CAAC;AAG/F,OAAO,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AAGjE,OAAO,EAAE,0BAA0B,EAAE,CAAC;AAEtC,oGAAoG;AACpG,eAAO,MAAM,mCAAmC,QAAS,CAAC;AAE1D,KAAK,aAAa,GAAG,IAAI,CACvB,UAAU,CAAC,OAAO,8BAA8B,CAAC,EACjD,wBAAwB,GAAG,2BAA2B,CACvD,CAAC;AAKF,gDAAgD;AAChD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG;IAClD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAKA;AAED,2FAA2F;AAC3F,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,UAAU,EACf,KAAK,EAAE;IACL,UAAU,EAAE,CAAC,EAAE,EAAE,gBAAgB,KAAK,MAAM,CAAC;IAC7C,aAAa,EAAE,CAAC,EAAE,EAAE,gBAAgB,KAAK,MAAM,GAAG,IAAI,CAAC;CACxD,GACA,MAAM,GAAG,IAAI,CAef;AAED,sFAAsF;AACtF,wBAAgB,sCAAsC,CACpD,IAAI,EAAE,OAAO,EACb,aAAa,EAAE,aAAa,GAC3B,MAAM,GAAG,IAAI,CAgBf;AAKD;;0FAE0F;AAC1F,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,OAAO,EACb,aAAa,EAAE,aAAa,EAC5B,EAAE,kBAAkB,EAAE,EAAE;IAAE,kBAAkB,EAAE,OAAO,CAAA;CAAE,GACtD,yBAAyB,CAiB3B;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,QAAQ,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,aAAa,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,MAAM,CAAC;CACvB,CAAC;AAEF;6FAC6F;AAC7F,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAgBtF;AAED;gGACgG;AAChG,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,QAAQ,GACZ;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAuB9F"}

package/dist/runtime/compositionLength.js

@@ -0,0 +1,125 @@
+import { resolveCompositionDuration, } from "@hyperframes/parsers/composition-duration";
+import { findRootCompositionElement, parseCompositionDimension } from "./compositionDimension.js";
+import { isMediaElement } from "./domRealm.js";
+import { parseStrictFiniteTimingNumber, resolveMediaElementDurationSeconds } from "./playbackRate.js";
+import { createRuntimeStartTimeResolver } from "./startResolver.js";
+import { createRuntimeState } from "./state.js";
+export { findRootCompositionElement };
+/** One frame at 60 fps: a timeline, floor or fallback this short or shorter is no length at all. */
+export const MIN_VALID_TIMELINE_DURATION_SECONDS = 1 / 60;
+const aboveOneFrame = (seconds) => seconds !== null && seconds > MIN_VALID_TIMELINE_DURATION_SECONDS ? seconds : null;
+/** The size the runtime reports to its host. */
+export function readCompositionSize(root) {
+    return {
+        width: parseCompositionDimension(root.getAttribute("data-width")),
+        height: parseCompositionDimension(root.getAttribute("data-height")),
+    };
+}
+/** The latest end among the document's timed video and audio, at their absolute starts. */
+export function resolveMediaWindowDurationSeconds(doc, media) {
+    const clipEnds = [];
+    for (const node of doc.querySelectorAll("video[data-start], audio[data-start]")) {
+        const start = media.mediaStart(node);
+        if (!Number.isFinite(start))
+            continue;
+        const duration = media.mediaDuration(node);
+        if (duration == null || duration <= MIN_VALID_TIMELINE_DURATION_SECONDS)
+            continue;
+        clipEnds.push(Math.max(0, start) + duration);
+    }
+    return aboveOneFrame(resolveCompositionDuration({ authoredDurationSeconds: null, clipEndsSeconds: clipEnds })
+        .seconds);
+}
+/** The latest of the root's declared length and its direct sub-compositions' ends. */
+export function resolveAuthoredCompositionFloorSeconds(root, startResolver) {
+    const subCompositionEnds = [];
+    for (const node of root.querySelectorAll("[data-composition-id][data-start]")) {
+        if (node.parentElement?.closest("[data-composition-id]") !== root)
+            continue;
+        const start = startResolver.resolveStartForElement(node, 0);
+        const duration = startResolver.resolveDurationForElement(node);
+        if (!Number.isFinite(start) || duration == null || duration <= 0)
+            continue;
+        subCompositionEnds.push(Math.max(0, start) + duration);
+    }
+    const declared = parseStrictFiniteTimingNumber(root.getAttribute("data-duration"));
+    return aboveOneFrame(resolveCompositionDuration({
+        authoredDurationSeconds: null,
+        clipEndsSeconds: [declared, ...subCompositionEnds],
+    }).seconds);
+}
+const isCompositionHost = (node) => node.hasAttribute("data-composition-id") || node.hasAttribute("data-composition-src");
+/** The last-resort length: the latest end among the root's timed clips. Until every clip's length
+ *  is known it is unresolved, so a renderer that reads it once cannot lock in a short one.
+ *  `unregisteredLottie`: a Lottie library is loaded, so animations may still register. */
+export function resolveContentDerivedDuration(root, startResolver, { unregisteredLottie }) {
+    const clipEnds = [];
+    for (const node of root.querySelectorAll("[data-start]")) {
+        const start = startResolver.resolveStartForElement(node, 0);
+        if (!Number.isFinite(start))
+            continue;
+        const duration = startResolver.resolveDurationForElement(node);
+        if (duration != null)
+            clipEnds.push(Math.max(0, start) + duration);
+        else if (isMediaElement(node) || isCompositionHost(node))
+            clipEnds.push(null);
+    }
+    if (unregisteredLottie || root.querySelector("[data-lottie-src]"))
+        clipEnds.push(null);
+    const result = resolveCompositionDuration({
+        authoredDurationSeconds: null,
+        clipEndsSeconds: clipEnds,
+    });
+    return result.pendingClips > 0
+        ? { ...result, seconds: null, source: "unresolved", reason: "a clip's length is pending" }
+        : result;
+}
+/** A declared root length is the length (a longer timeline is cut off); else the timeline, the
+ *  floors and the fallback, whichever is longest; else the length derived from the clips. */
+export function resolveCompositionLengthSeconds(input) {
+    if (input.declared !== null && Number.isFinite(input.declared) && input.declared > 0) {
+        return input.declared;
+    }
+    const timeline = aboveOneFrame(input.timeline());
+    const floor = Math.max(0, ...input.floors().map((seconds) => seconds ?? 0));
+    const fallback = Number.isFinite(input.fallback) && input.fallback > MIN_VALID_TIMELINE_DURATION_SECONDS
+        ? input.fallback
+        : 0;
+    let seconds;
+    if (timeline !== null)
+        seconds = Math.max(timeline, floor, fallback);
+    else if (aboveOneFrame(floor) !== null)
+        seconds = Math.max(floor, fallback);
+    else if (fallback > 0)
+        seconds = fallback;
+    else
+        seconds = input.derived();
+    return seconds > 0 ? seconds : 0;
+}
+/** Size, frame rate and length of a composition nothing is running (a server-parsed or detached
+ *  document): no timelines, no adapters, and media without a known source length is pending. */
+export function readStaticCompositionMeta(doc) {
+    const root = findRootCompositionElement(doc);
+    if (!root)
+        return null;
+    const resolver = createRuntimeStartTimeResolver({
+        timelineRegistry: {},
+        includeAuthoredTimingAttrs: true,
+        documentRef: doc,
+    });
+    const durationSeconds = resolveCompositionLengthSeconds({
+        declared: parseStrictFiniteTimingNumber(root.getAttribute("data-duration")),
+        timeline: () => null,
+        floors: () => [
+            resolveMediaWindowDurationSeconds(doc, {
+                mediaStart: resolver.resolveMediaStartForElement,
+                mediaDuration: resolveMediaElementDurationSeconds,
+            }),
+            resolveAuthoredCompositionFloorSeconds(root, resolver),
+        ],
+        fallback: 0,
+        derived: () => resolveContentDerivedDuration(root, resolver, { unregisteredLottie: false }).seconds ?? 0,
+    });
+    return { ...readCompositionSize(root), fps: createRuntimeState().canonicalFps, durationSeconds };
+}
+//# sourceMappingURL=compositionLength.js.map

package/dist/runtime/compositionLength.js.map

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

package/dist/runtime/state.d.ts

@@ -0,0 +1,95 @@
+import type { RuntimeDeterministicAdapter, RuntimeTimelineLike } from "./types";
+import type { RuntimeMediaClip } from "./media";
+import type { TransportClock } from "./clock";
+export type RuntimeState = {
+    capturedTimeline: RuntimeTimelineLike | null;
+    isPlaying: boolean;
+    currentTime: number;
+    deterministicAdapters: RuntimeDeterministicAdapter[];
+    canonicalFps: number;
+    bridgeMuted: boolean;
+    bridgeVolume: number;
+    /**
+     * Internal mute of audible media output, owned by the audio-ownership
+     * protocol between the parent (`<hyperframes-player>`) and this runtime.
+     * Independent of `bridgeMuted` (the user's mute preference). When the
+     * parent takes over audible playback via parent-frame proxies, it sets
+     * this to `true` so the runtime keeps driving timed media for frame
+     * accuracy but produces no audio of its own.
+     */
+    mediaOutputMuted: boolean;
+    /**
+     * Disable runtime ownership of native media elements. Slideshow presenter
+     * mode keeps the slide timeline paused while users interact with embedded
+     * media, so the runtime must not auto-play, auto-pause, seek, or volume-sync
+     * those native elements on every transport tick.
+     */
+    nativeMediaSyncDisabled: boolean;
+    /**
+     * Disable the runtime's WebAudio replacement for native <audio> elements.
+     * Slideshow presenter/audience windows mirror native media element events
+     * across browsers, so muting those elements for WebAudio ownership breaks
+     * audible presenter playback and remote sync.
+     */
+    webAudioMediaDisabled: boolean;
+    /**
+     * Latch so the `media-autoplay-blocked` outbound message is posted at most
+     * once per runtime session. The parent only needs the first signal — it
+     * takes over playback and further rejections are the same problem.
+     */
+    mediaAutoplayBlockedPosted: boolean;
+    /**
+     * One-shot flag: force a hard media sync on the next tick. Set on
+     * play/pause/seek/rate transitions to immediately correct any
+     * accumulated sub-threshold drift from pause/play toggling.
+     * Consumed (reset to false) by `syncMediaForCurrentState`.
+     */
+    mediaForceSyncNextTick: boolean;
+    playbackRate: number;
+    bridgeLastPostedFrame: number;
+    bridgeLastPostedAt: number;
+    bridgeLastPostedPlaying: boolean;
+    bridgeLastPostedMuted: boolean;
+    /**
+     * Max interval (ms) between outbound timeline samples on the parent-frame
+     * control bridge. The bridge posts on every changed frame, but also at
+     * least once per this interval so a paused/idle timeline still confirms
+     * its position to any listener.
+     *
+     * **Cross-reference (do not change in isolation)**: the parent-frame
+     * audio-mirror loop in `<hyperframes-player>` waits for
+     * `MIRROR_REQUIRED_CONSECUTIVE_DRIFT_SAMPLES` consecutive over-threshold
+     * samples before issuing a `currentTime` correction. The product of
+     * those two constants is the worst-case A/V re-sync latency:
+     *
+     *   worst_case_correction_latency_ms
+     *     ≈ MIRROR_REQUIRED_CONSECUTIVE_DRIFT_SAMPLES × bridgeMaxPostIntervalMs
+     *
+     * Today: `2 × 80 ms = 160 ms`, which sits comfortably under the
+     * perceptual A/V re-sync tolerance. If you raise this interval, audit
+     * `MIRROR_REQUIRED_CONSECUTIVE_DRIFT_SAMPLES` in
+     * `packages/player/src/parent-media.ts` — leaving it at `2` will
+     * silently push correction latency past the tolerance budget.
+     */
+    bridgeMaxPostIntervalMs: number;
+    controlBridgeHandler: ((event: MessageEvent) => void) | null;
+    beforeUnloadHandler: (() => void) | null;
+    injectedCompStyles: HTMLStyleElement[];
+    injectedCompScripts: HTMLScriptElement[];
+    injectedCompLinks: HTMLLinkElement[];
+    cachedTimedMediaEls: Array<HTMLVideoElement | HTMLAudioElement>;
+    cachedMediaClips: RuntimeMediaClip[];
+    cachedVideoClips: RuntimeMediaClip[];
+    cachedMediaTimelineDurationSeconds: number;
+    tornDown: boolean;
+    /**
+     * Single-clock transport. The sole time authority — GSAP is always
+     * paused and seeked to `clock.now()` on each rAF tick. Eliminates
+     * the two-clock drift problem described in issue #668.
+     */
+    transportClock: TransportClock | null;
+    /** rAF ID for the single-clock tick loop. */
+    transportRafId: number | null;
+};
+export declare function createRuntimeState(): RuntimeState;
+//# sourceMappingURL=state.d.ts.map

package/dist/runtime/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/runtime/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG;IACzB,gBAAgB,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,2BAA2B,EAAE,CAAC;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;;;OAOG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,uBAAuB,EAAE,OAAO,CAAC;IACjC;;;;;OAKG;IACH,qBAAqB,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,0BAA0B,EAAE,OAAO,CAAC;IACpC;;;;;OAKG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,uBAAuB,EAAE,OAAO,CAAC;IACjC,qBAAqB,EAAE,OAAO,CAAC;IAC/B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,uBAAuB,EAAE,MAAM,CAAC;IAChC,oBAAoB,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7D,mBAAmB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IACzC,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;IACvC,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;IACzC,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,mBAAmB,EAAE,KAAK,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,CAAC;IAChE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IACrC,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IACrC,kCAAkC,EAAE,MAAM,CAAC;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,6CAA6C;IAC7C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,YAAY,CAiCjD"}

package/dist/runtime/state.js

@@ -0,0 +1,35 @@
+export function createRuntimeState() {
+    return {
+        capturedTimeline: null,
+        isPlaying: false,
+        currentTime: 0,
+        deterministicAdapters: [],
+        canonicalFps: 30,
+        bridgeMuted: false,
+        bridgeVolume: 1,
+        mediaOutputMuted: false,
+        nativeMediaSyncDisabled: false,
+        webAudioMediaDisabled: false,
+        mediaAutoplayBlockedPosted: false,
+        mediaForceSyncNextTick: false,
+        playbackRate: 1,
+        bridgeLastPostedFrame: -1,
+        bridgeLastPostedAt: 0,
+        bridgeLastPostedPlaying: false,
+        bridgeLastPostedMuted: false,
+        bridgeMaxPostIntervalMs: 80,
+        controlBridgeHandler: null,
+        beforeUnloadHandler: null,
+        injectedCompStyles: [],
+        injectedCompScripts: [],
+        injectedCompLinks: [],
+        cachedTimedMediaEls: [],
+        cachedMediaClips: [],
+        cachedVideoClips: [],
+        cachedMediaTimelineDurationSeconds: 0,
+        tornDown: false,
+        transportClock: null,
+        transportRafId: null,
+    };
+}
+//# sourceMappingURL=state.js.map