@hyperframes/core 0.9.18 → 0.9.20

package/dist/index.d.ts

@@ -68,3 +68,4 @@ export { canaryBucket, evaluateCanary, parseCanaryOverride, type CanaryDecision,
 export { CANARIES, canaryEnvVar, findCanary, overdueCanaries, type CanaryDefinition, } from "./canaryRegistry.js";
 export { HF_VFX_ATTR, HF_VFX_CHAIN_VERSION, HF_VFX, chainCapture, getVfxDef, parseVfxChain, serializeVfxChain, normalizeVfxParams, type HfVfxCapture, type HfVfxChain, type HfVfxDef, type HfVfxNode, type HfVfxParam, type HfVfxParamValues, } from "./vfx.js";
 export { PAGE_DEVICE_SCALE_GLOBAL, PAGE_MOTION_BLUR_OFF_GLOBAL, acceleratedCanvasTrackerSource, } from "./pageMotionBlur.js";
+export { MOTION_BLUR_FINGERPRINT_FIELDS, type MotionBlurFingerprint, type MotionBlurFingerprintField, } from "./motionBlurFingerprint.js";

package/dist/index.js

@@ -71,3 +71,4 @@ export { CANARIES, canaryEnvVar, findCanary, overdueCanaries, } from "./canaryRe
 // VFX chain (data-vfx-chain) — defs, chain parse/serialize/normalize
 export { HF_VFX_ATTR, HF_VFX_CHAIN_VERSION, HF_VFX, chainCapture, getVfxDef, parseVfxChain, serializeVfxChain, normalizeVfxParams, } from "./vfx.js";
 export { PAGE_DEVICE_SCALE_GLOBAL, PAGE_MOTION_BLUR_OFF_GLOBAL, acceleratedCanvasTrackerSource, } from "./pageMotionBlur.js";
+export { MOTION_BLUR_FINGERPRINT_FIELDS, } from "./motionBlurFingerprint.js";

package/dist/inline-scripts/pickerApi.d.ts

@@ -6,6 +6,7 @@ export type HyperframePickerBoundingBox = {
 };
 export type HyperframePickerElementInfo = {
     id: string | null;
+    className?: string | null;
     tagName: string;
     selector: string;
     label: string;

package/dist/motionBlurFingerprint.d.ts

@@ -0,0 +1,4 @@
+export declare const MOTION_BLUR_FINGERPRINT_FIELDS: readonly ["canvas2d", "webgl", "video", "iframe", "customElement", "svgClip", "mask", "scrollContainer", "threeD", "overflowingMover", "frontOfMover", "blendMode", "fixedInMover", "pseudoOutside"];
+export type MotionBlurFingerprintField = (typeof MOTION_BLUR_FINGERPRINT_FIELDS)[number];
+export type MotionBlurFingerprint = Record<MotionBlurFingerprintField, number>;
+export declare function emptyMotionBlurFingerprint(): MotionBlurFingerprint;

package/dist/motionBlurFingerprint.js

@@ -0,0 +1,34 @@
+export const MOTION_BLUR_FINGERPRINT_FIELDS = [
+    "canvas2d",
+    "webgl",
+    "video",
+    "iframe",
+    "customElement",
+    "svgClip",
+    "mask",
+    "scrollContainer",
+    "threeD",
+    "overflowingMover",
+    "frontOfMover",
+    "blendMode",
+    "fixedInMover",
+    "pseudoOutside",
+];
+export function emptyMotionBlurFingerprint() {
+    return {
+        canvas2d: 0,
+        webgl: 0,
+        video: 0,
+        iframe: 0,
+        customElement: 0,
+        svgClip: 0,
+        mask: 0,
+        scrollContainer: 0,
+        threeD: 0,
+        overflowingMover: 0,
+        frontOfMover: 0,
+        blendMode: 0,
+        fixedInMover: 0,
+        pseudoOutside: 0,
+    };
+}

package/dist/runtime/mediaSteer.d.ts

@@ -3,7 +3,7 @@ export declare const MEDIA_SYNC_TOLERANCE_SECONDS = 0.04;
 export declare const MEDIA_HARD_SYNC_SECONDS = 0.5;
 export declare function markMediaRestarted(el: HTMLMediaElement): void;
 /** Rate or seek for media `offset` s behind (+) or ahead (-); a lag still growing (`settled` false) never seeks. */
-export declare function steerMedia(el: HTMLMediaElement, offset: number, baseRate: number, settled: boolean, audioOnly?: boolean): {
+export declare function steerMedia(el: HTMLMediaElement, offset: number, baseRate: number, settled: boolean, audioOnly?: boolean, hidden?: boolean): {
     rate: number;
     seek: boolean;
 };

package/dist/runtime/mediaSteer.js

@@ -13,6 +13,8 @@ const MEDIA_STEER_RELEASE_SECONDS = 0.01;
 const AUDIO_MAX_STEER = 0.1;
 const AUDIO_STEER_LIMIT_SECONDS = 0.1;
 const WEBKIT_AUDIO_START_LAG_SECONDS = 0.65;
+// A video nobody sees runs up to twice as fast (half as slow) to reach the playhead: the lag in seconds times this.
+const HIDDEN_GAIN = 5;
 /** Direction (+1 fast, -1 slow) an element is being steered in; absent when it plays at its authored rate. */
 const steering = new WeakMap();
 /** Started or seeked, not yet moving in tolerance: its lag is its own output latency, which a seek only renews. */
@@ -21,7 +23,7 @@ export function markMediaRestarted(el) {
     catchingUp.add(el);
 }
 /** Rate or seek for media `offset` s behind (+) or ahead (-); a lag still growing (`settled` false) never seeks. */
-export function steerMedia(el, offset, baseRate, settled, audioOnly = el.tagName === "AUDIO") {
+export function steerMedia(el, offset, baseRate, settled, audioOnly = el.tagName === "AUDIO", hidden = false) {
     const lag = Math.abs(offset);
     if (audioOnly && isWebKit()) {
         steering.delete(el);
@@ -36,6 +38,8 @@ export function steerMedia(el, offset, baseRate, settled, audioOnly = el.tagName
         return { rate: baseRate, seek: true };
     }
     const direction = Math.sign(offset);
+    if (hidden && lag > MEDIA_SYNC_TOLERANCE_SECONDS)
+        return steerHidden(el, direction, lag, baseRate);
     const current = steering.get(el);
     if (lag > MEDIA_SYNC_TOLERANCE_SECONDS)
         steering.set(el, direction);
@@ -47,6 +51,11 @@ export function steerMedia(el, offset, baseRate, settled, audioOnly = el.tagName
     const steer = audioOnly ? Math.min(step, AUDIO_MAX_STEER) : step;
     return { rate: baseRate * (1 + direction * steer), seek: false };
 }
+function steerHidden(el, direction, lag, baseRate) {
+    steering.set(el, direction);
+    const steer = Math.min(direction > 0 ? 1 : 0.5, lag * HIDDEN_GAIN);
+    return { rate: baseRate * (1 + direction * steer), seek: false };
+}
 /** Drop `el`'s steering: it was seeked, paused or replaced, so its old offset says nothing. */
 export function forgetSteering(el) {
     steering.delete(el);

package/package.json

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