@hyperframes/core 0.8.193 → 0.8.194

package/dist/runtime/media.js

@@ -233,6 +233,11 @@ const MIN_NATIVE_PLAYBACK_RATE = 1 / 16;
 // A playing video is steered back by rate, not seeked (a seek resets its decoder).
 // Its rate is written only when steering starts or stops: every write costs a frame.
 const VIDEO_STEER = 0.03;
+// A video that starts a cut late closes its lag over one clip at 3%; a bigger lag steers harder, in steps so the rate is written rarely.
+const VIDEO_STEER_STEPS = [
+    [0.3, 0.25],
+    [0.1, 0.1],
+];
 const VIDEO_STEER_RELEASE_SECONDS = 0.01;
 /** Direction (+1 fast, -1 slow) a video is being steered in; absent when it plays at its authored rate. */
 const videoSteering = new WeakMap();
@@ -246,7 +251,9 @@ function steeredVideoRate(el, offset, baseRate) {
         videoSteering.delete(el);
         return baseRate;
     }
-    return baseRate * (1 + direction * VIDEO_STEER);
+    const lag = Math.abs(offset);
+    const steer = VIDEO_STEER_STEPS.find(([from]) => lag > from)?.[1] ?? VIDEO_STEER;
+    return baseRate * (1 + direction * steer);
 }
 // fallow-ignore-next-line complexity
 export function syncRuntimeMedia(params) {

package/dist/runtime/preloadMedia.d.ts

@@ -1,6 +1,7 @@
 type PreloadableMedia = Pick<HTMLMediaElement, "id" | "tagName" | "getAttribute" | "preload" | "readyState" | "networkState" | "load">;
 export declare function isRenderFrameVideo(media: Pick<Element, "getAttribute" | "id" | "tagName">): boolean;
 export declare function preloadMedia(media: PreloadableMedia): void;
+export declare function prepareUpcomingMedia(media: HTMLMediaElement, isUpcoming: () => boolean): void;
 /** Ends a fetch in flight for good, which preload none alone does not. */
 export declare function stopMediaDownload(media: HTMLMediaElement): void;
 export declare function releaseMedia(media: HTMLMediaElement): void;

package/dist/runtime/preloadMedia.js

@@ -1,7 +1,8 @@
-import { parseStrictFiniteTimingNumber } from "./playbackRate.js";
+import { parseStrictFiniteTimingNumber, readMediaStart } from "./playbackRate.js";
 import { createRuntimeStartTimeResolver } from "./startResolver.js";
 import { readMediaRenderId } from "./renderFrameSibling.js";
 import { defersMedia } from "./timedClipHide.js";
+import { swallow } from "./diagnostics.js";
 export function isRenderFrameVideo(media) {
     const ids = window
         .__HF_RENDER_FRAME_VIDEO_IDS;
@@ -17,8 +18,49 @@ export function preloadMedia(media) {
     if (media.readyState < 3 && !videoAlreadyLoading)
         media.load();
 }
+const pendingPlaybackStart = new WeakMap();
+function cancelPlaybackStart(media) {
+    pendingPlaybackStart.get(media)?.();
+}
+export function prepareUpcomingMedia(media, isUpcoming) {
+    cancelPlaybackStart(media);
+    if (media.tagName !== "VIDEO" || isRenderFrameVideo(media))
+        return;
+    const prepare = () => {
+        if (!media.isConnected || !media.paused || media.seeking || !isUpcoming())
+            return;
+        const start = readMediaStart(media);
+        if (Math.abs(media.currentTime - start) <= 0.02)
+            return;
+        try {
+            media.currentTime = start;
+        }
+        catch (error) {
+            swallow("runtime.preload.playbackStart", error);
+        }
+    };
+    if (media.readyState > 0) {
+        prepare();
+        return;
+    }
+    const cancel = () => {
+        media.removeEventListener("loadedmetadata", loaded);
+        media.removeEventListener("error", cancel);
+        media.removeEventListener("abort", cancel);
+        pendingPlaybackStart.delete(media);
+    };
+    const loaded = () => {
+        cancel();
+        prepare();
+    };
+    pendingPlaybackStart.set(media, cancel);
+    media.addEventListener("loadedmetadata", loaded);
+    media.addEventListener("error", cancel);
+    media.addEventListener("abort", cancel);
+}
 /** Ends a fetch in flight for good, which preload none alone does not. */
 export function stopMediaDownload(media) {
+    cancelPlaybackStart(media);
     for (const source of media.querySelectorAll("source"))
         source.remove();
     media.removeAttribute("src");

package/dist/runtime/startResolver.js

@@ -14,7 +14,15 @@ export function createRuntimeStartTimeResolver(params) {
     const startCache = new WeakMap();
     const durationCache = new WeakMap();
     const visiting = new Set();
-    const findReferenceTarget = (refId) => {
+    const compositionScopeOf = (element) => (element.hasAttribute("data-composition-id") ? element.parentElement : element)?.closest("[data-composition-id]") ?? null;
+    const findReferenceTarget = (refId, from) => {
+        const scope = compositionScopeOf(from);
+        if (scope) {
+            for (const candidate of scope.querySelectorAll(`[id="${refId}"]`)) {
+                if (compositionScopeOf(candidate) === scope)
+                    return candidate;
+            }
+        }
         const byId = doc.getElementById(refId);
         if (byId)
             return byId;
@@ -82,7 +90,7 @@ export function createRuntimeStartTimeResolver(params) {
             // Negative when a host's in-point is past its start; the host's slot cuts that part.
             return resolveHostOffsetForElement(element, fallback) + Math.max(0, expression.value);
         }
-        const target = findReferenceTarget(expression.refId);
+        const target = findReferenceTarget(expression.refId, element);
         if (!target)
             return fallback;
         const targetStart = resolveStartForElementInternal(target, 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.8.193",
+  "version": "0.8.194",
   "description": "",
   "repository": {
     "type": "git",
@@ -52,6 +52,10 @@
       "import": "./dist/safePath.js",
       "types": "./dist/safePath.d.ts"
     },
+    "./browser-marker": {
+      "import": "./dist/browserMarker.js",
+      "types": "./dist/browserMarker.d.ts"
+    },
     "./atomic-file": {
       "import": "./dist/atomicFile.js",
       "types": "./dist/atomicFile.d.ts"
@@ -389,9 +393,9 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "wawoff2": "^2.0.1",
-    "@hyperframes/lint": "0.8.193",
-    "@hyperframes/studio-server": "0.8.193",
-    "@hyperframes/parsers": "0.8.193"
+    "@hyperframes/lint": "0.8.194",
+    "@hyperframes/parsers": "0.8.194",
+    "@hyperframes/studio-server": "0.8.194"
   },
   "devDependencies": {
     "@fontsource/archivo-black": "^5.2.8",