@hyperframes/core 0.9.7 → 0.9.8

package/dist/runtime/clock.d.ts

@@ -29,6 +29,7 @@ export declare class TransportClock {
     /** Wall-clock time of the last `now()` read while playing; null while paused. */
     private _lastReadMs;
     private _lastNow;
+    private _audioStart;
     constructor(opts?: {
         initialTime?: number;
         rate?: number;
@@ -37,6 +38,8 @@ export declare class TransportClock {
     });
     now(): number;
     private _elementTimeNeverBehind;
+    private _heldUntilAudioOutputStarts;
+    private _pendingAudioStart;
     /** Folds a >500ms gap since the last read into `_playStartMs` so it's never reported as played time. */
     private _applyStallCorrection;
     play(): boolean;

package/dist/runtime/clock.js

@@ -4,6 +4,8 @@ import { playRangeHoldTime } from "./protocol.js";
 const STALL_THRESHOLD_MS = 500;
 const STALL_ADJUSTED_LAG_MS = 33;
 const HAVE_FUTURE_DATA = 3;
+const AUDIO_START_WAIT_MS = 1500;
+const MEDIA_SYNC_STEER_TOLERANCE_SECONDS = 0.04;
 export class TransportClock {
     _baseTime = 0;
     _playStartMs = null;
@@ -17,6 +19,7 @@ export class TransportClock {
     /** Wall-clock time of the last `now()` read while playing; null while paused. */
     _lastReadMs = null;
     _lastNow = 0;
+    _audioStart = null;
     constructor(opts) {
         this._baseTime = opts?.initialTime ?? 0;
         this._rate = opts?.rate ?? 1;
@@ -57,15 +60,35 @@ export class TransportClock {
         const { el, compositionStart, mediaStart, rate } = source;
         if (el.paused || !Number.isFinite(el.currentTime))
             return null;
-        if (el.seeking)
-            return null;
         const spec = rate ?? 1;
         const time = timeAtSourceTime(spec, el.currentTime - mediaStart) + compositionStart;
+        const held = this._heldUntilAudioOutputStarts(el.seeking, time);
+        if (held !== undefined)
+            return held;
         if (time >= this._lastNow)
             return time;
         const wrapped = el.loop && this._lastNow - time > timeAtSourceTime(spec, el.duration) / 2;
         return !wrapped && el.readyState < HAVE_FUTURE_DATA ? this._lastNow : null;
     }
+    _heldUntilAudioOutputStarts(seeking, time) {
+        const pending = this._pendingAudioStart();
+        if (seeking)
+            return pending ? this._lastNow : null;
+        if (!pending)
+            return undefined;
+        pending.from ??= time;
+        const startsHere = Math.abs(pending.from - pending.at) <= MEDIA_SYNC_STEER_TOLERANCE_SECONDS;
+        if (startsHere && time === pending.from)
+            return time;
+        this._audioStart = null;
+        return undefined;
+    }
+    _pendingAudioStart() {
+        const pending = this._audioStart;
+        if (pending && this._nowMs() - pending.sinceMs > AUDIO_START_WAIT_MS)
+            this._audioStart = null;
+        return this._audioStart;
+    }
     /** Folds a >500ms gap since the last read into `_playStartMs` so it's never reported as played time. */
     _applyStallCorrection() {
         if (this._playStartMs === null)
@@ -85,6 +108,7 @@ export class TransportClock {
         if (this._baseTime >= this.getEnd())
             return false;
         this._playStartMs = this._nowMs();
+        this._audioStart = { sinceMs: this._playStartMs, at: this._baseTime, from: null };
         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
@@ -108,6 +132,7 @@ export class TransportClock {
         this._lastNow = clamped;
         if (this._playStartMs !== null) {
             this._playStartMs = this._nowMs();
+            this._audioStart = { sinceMs: this._playStartMs, at: clamped, from: null };
             // 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;
@@ -166,6 +191,7 @@ export class TransportClock {
         this._audioSource = null;
     }
     /** The element the playhead currently follows, if the source is one. */
+    // fallow-ignore-next-line unused-class-member
     audioElement() {
         return this._audioSource && "el" in this._audioSource ? this._audioSource.el : null;
     }

package/dist/studioPreviewMark.d.ts

@@ -6,6 +6,7 @@ export declare function defersMediaIn(doc: Document): boolean;
 export declare const STUDIO_PREVIEW_UPCOMING_ATTR = "data-hf-upcoming";
 export declare const STUDIO_PREVIEW_LAZY_ATTR = "data-hf-preview-lazy";
 export declare const STUDIO_PREVIEW_ERRORS = "__hfPreviewErrors";
+export declare const STUDIO_PREVIEW_ERROR_KINDS = "__hfPreviewErrorKinds";
 export declare const refusedPreviewMessage: (status: number) => string;
 export declare function refusedPreviewStatus(message: string): number | null;
 export declare const PREVIEW_RASTER_ATTR = "data-hf-preview-raster";

package/dist/studioPreviewMark.js

@@ -11,6 +11,7 @@ export function defersMediaIn(doc) {
 export const STUDIO_PREVIEW_UPCOMING_ATTR = "data-hf-upcoming";
 export const STUDIO_PREVIEW_LAZY_ATTR = "data-hf-preview-lazy";
 export const STUDIO_PREVIEW_ERRORS = "__hfPreviewErrors";
+export const STUDIO_PREVIEW_ERROR_KINDS = "__hfPreviewErrorKinds";
 export const refusedPreviewMessage = (status) => `The preview page could not be loaded (HTTP ${status}).`;
 export function refusedPreviewStatus(message) {
     const status = /^The preview page could not be loaded \(HTTP (\d{3})\)\.$/.exec(message)?.[1];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.9.7",
+  "version": "0.9.8",
   "description": "",
   "repository": {
     "type": "git",
@@ -437,9 +437,9 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "wawoff2": "^2.0.1",
-    "@hyperframes/lint": "0.9.7",
-    "@hyperframes/parsers": "0.9.7",
-    "@hyperframes/studio-server": "0.9.7"
+    "@hyperframes/lint": "0.9.8",
+    "@hyperframes/studio-server": "0.9.8",
+    "@hyperframes/parsers": "0.9.8"
   },
   "devDependencies": {
     "@fontsource/archivo-black": "^5.2.8",