@hyperframes/core 0.9.6 → 0.9.8

package/dist/index.d.ts

@@ -36,7 +36,7 @@ export { colorGroupOf, effectiveColorGrading, ensureColorGroupInertStyle, HF_COL
 export { parseCubeLut, CubeLutParseError, type CubeLut3D, type ParseCubeLutOptions, } from "./colorLuts.js";
 export { bakeHfColorGradingCube, type BakeHfColorGradingCubeOptions } from "./colorGradingBake.js";
 export { firstFrameColourArgs, hdrToSdrToneMapFilter, parseFirstFrameColour, type ToneMapSourceColour, } from "./hdrToneMap.js";
-export { HEAVY_BITRATE, HEAVY_PIXEL_SHARE, PREVIEW_PROXY_BOX_PARAM, PREVIEW_PROXY_LIGHT_PARAM, PREVIEW_PROXY_PRIORITY_HEADER, PREVIEW_PROXY_PROGRESS_HEADER, PREVIEW_PROXY_RETRY_PARAM, PREVIEW_QUALITY_LEVELS, formatPreviewProxyBox, isHeavyForPreview, isPreviewQuality, parsePreviewProxyBox, quantizePreviewProxyBox, scalePreviewProxyBox, type PreviewProxyBox, type PreviewQuality, type PreviewSourceFacts, } from "./previewProxyBox.js";
+export { HEAVY_BITRATE, HEAVY_PIXEL_SHARE, PREVIEW_PROXY_BOX_PARAM, PREVIEW_PROXY_LIGHT_PARAM, PREVIEW_PROXY_PRIORITY_HEADER, PREVIEW_PROXY_PROGRESS_HEADER, PREVIEW_PROXY_RETRY_PARAM, PREVIEW_PROXY_STILL_PARAM, PREVIEW_QUALITY_LEVELS, formatPreviewProxyBox, isHeavyForPreview, isPreviewQuality, parsePreviewProxyBox, quantizePreviewProxyBox, scalePreviewProxyBox, type PreviewProxyBox, type PreviewQuality, type PreviewSourceFacts, } from "./previewProxyBox.js";
 export { HYPERFRAME_RUNTIME_ARTIFACTS, HYPERFRAME_RUNTIME_CONTRACT, loadHyperframeRuntimeSource, type HyperframeRuntimeContract, } from "./inline-scripts/hyperframe.js";
 export { HYPERFRAME_RUNTIME_GLOBALS, HYPERFRAME_BRIDGE_SOURCES, HYPERFRAME_CONTROL_ACTIONS, type HyperframeControlAction, } from "./inline-scripts/runtimeContract.js";
 export { getHyperframeRuntimeScript } from "./generated/runtime-inline.js";

package/dist/index.js

@@ -32,7 +32,7 @@ export { colorGroupOf, effectiveColorGrading, ensureColorGroupInertStyle, HF_COL
 export { parseCubeLut, CubeLutParseError, } from "./colorLuts.js";
 export { bakeHfColorGradingCube } from "./colorGradingBake.js";
 export { firstFrameColourArgs, hdrToSdrToneMapFilter, parseFirstFrameColour, } from "./hdrToneMap.js";
-export { HEAVY_BITRATE, HEAVY_PIXEL_SHARE, PREVIEW_PROXY_BOX_PARAM, PREVIEW_PROXY_LIGHT_PARAM, PREVIEW_PROXY_PRIORITY_HEADER, PREVIEW_PROXY_PROGRESS_HEADER, PREVIEW_PROXY_RETRY_PARAM, PREVIEW_QUALITY_LEVELS, formatPreviewProxyBox, isHeavyForPreview, isPreviewQuality, parsePreviewProxyBox, quantizePreviewProxyBox, scalePreviewProxyBox, } from "./previewProxyBox.js";
+export { HEAVY_BITRATE, HEAVY_PIXEL_SHARE, PREVIEW_PROXY_BOX_PARAM, PREVIEW_PROXY_LIGHT_PARAM, PREVIEW_PROXY_PRIORITY_HEADER, PREVIEW_PROXY_PROGRESS_HEADER, PREVIEW_PROXY_RETRY_PARAM, PREVIEW_PROXY_STILL_PARAM, PREVIEW_QUALITY_LEVELS, formatPreviewProxyBox, isHeavyForPreview, isPreviewQuality, parsePreviewProxyBox, quantizePreviewProxyBox, scalePreviewProxyBox, } from "./previewProxyBox.js";
 // Inline scripts
 export { HYPERFRAME_RUNTIME_ARTIFACTS, HYPERFRAME_RUNTIME_CONTRACT, loadHyperframeRuntimeSource, } from "./inline-scripts/hyperframe.js";
 export { HYPERFRAME_RUNTIME_GLOBALS, HYPERFRAME_BRIDGE_SOURCES, HYPERFRAME_CONTROL_ACTIONS, } from "./inline-scripts/runtimeContract.js";

package/dist/pageMotionBlur.js

@@ -30,12 +30,19 @@ export function installAcceleratedCanvasTracker() {
         Object.defineProperty(tracked, "__hfAccelTracked", { value: true });
         Object.defineProperty(proto, name, { value: tracked, writable: true, configurable: true });
     };
+    const ownWindowSet = (canvas) => {
+        const view = canvas.ownerDocument?.defaultView;
+        const own = view ? Reflect.get(view, key) : undefined;
+        return own && typeof own.add === "function"
+            ? own
+            : seen;
+    };
     wrap("getContext", (canvas, args, ctx) => {
         if (ctx && accelerated.includes(String(args[0])))
-            seen.add(canvas);
+            ownWindowSet(canvas).add(canvas);
     });
     wrap("transferControlToOffscreen", (canvas) => {
-        seen.add(canvas);
+        ownWindowSet(canvas).add(canvas);
     });
 }
 export function isAcceleratedCanvas(canvas) {

package/dist/previewProxyBox.d.ts

@@ -2,6 +2,7 @@
 export declare const PREVIEW_PROXY_BOX_PARAM = "hf-proxy-box";
 export declare const PREVIEW_PROXY_LIGHT_PARAM = "hf-proxy-light";
 export declare const PREVIEW_PROXY_RETRY_PARAM = "hf-proxy-retry";
+export declare const PREVIEW_PROXY_STILL_PARAM = "hf-proxy-still";
 export declare const PREVIEW_PROXY_PROGRESS_HEADER = "X-HF-Proxy-Progress";
 export declare const PREVIEW_PROXY_PRIORITY_HEADER = "X-HF-Proxy-Priority";
 export type PreviewProxyBox = {

package/dist/previewProxyBox.js

@@ -2,6 +2,7 @@
 export const PREVIEW_PROXY_BOX_PARAM = "hf-proxy-box";
 export const PREVIEW_PROXY_LIGHT_PARAM = "hf-proxy-light";
 export const PREVIEW_PROXY_RETRY_PARAM = "hf-proxy-retry";
+export const PREVIEW_PROXY_STILL_PARAM = "hf-proxy-still";
 export const PREVIEW_PROXY_PROGRESS_HEADER = "X-HF-Proxy-Progress";
 export const PREVIEW_PROXY_PRIORITY_HEADER = "X-HF-Proxy-Priority";
 // 256 * 2^(k/4), even: nearby boxes share one cached copy, and a rung overshoots by at most ~19%.

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.6",
+  "version": "0.9.8",
   "description": "",
   "repository": {
     "type": "git",
@@ -104,6 +104,10 @@
       "import": "./dist/studioPreviewMark.js",
       "types": "./dist/studioPreviewMark.d.ts"
     },
+    "./page-motion-blur": {
+      "import": "./dist/pageMotionBlur.js",
+      "types": "./dist/pageMotionBlur.d.ts"
+    },
     "./keyframe-defaults": {
       "import": "./dist/keyframeDefaults.js",
       "types": "./dist/keyframeDefaults.d.ts"
@@ -433,9 +437,9 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "wawoff2": "^2.0.1",
-    "@hyperframes/parsers": "0.9.6",
-    "@hyperframes/lint": "0.9.6",
-    "@hyperframes/studio-server": "0.9.6"
+    "@hyperframes/lint": "0.9.8",
+    "@hyperframes/studio-server": "0.9.8",
+    "@hyperframes/parsers": "0.9.8"
   },
   "devDependencies": {
     "@fontsource/archivo-black": "^5.2.8",