@hyperframes/core 0.8.205 → 0.8.206

package/dist/index.d.ts

@@ -25,6 +25,7 @@ export { CSS_URL_RE, isNonRelativeUrl, isPathInside } from "./compiler/assetPath
 export { rewriteSrcsetUrls } from "./compiler/srcset.js";
 export { checkSubCompositionUsability, type ParsableDocumentLike, type SubCompositionValidity, type SubCompositionValidityReason, } from "./compiler/subCompositionValidity.js";
 export { RUNTIME_BOOTSTRAP_ATTR, stripEmbeddedRuntimeScripts } from "./compiler/htmlDocument.js";
+export { AUTHORED_SOURCE_BEGIN, AUTHORED_SOURCE_END } from "./compiler/compositionScoping.js";
 export { COMPOSITION_SOURCE_URL } from "./compiler/scriptRuns.js";
 export { queryByAttr } from "./utils/cssSelector.js";
 export { AUDIBLE_MEDIA_SELECTOR, audibleVideoNeedsWebAudio, isAudibleVideoElement, } from "./audibleVideo.js";
@@ -55,6 +56,7 @@ export { parseStartExpression, parseNumeric, type ReferenceExpression, } from ".
 export { COMPOSITION_CONTRACT_VERSION, COMPOSITION_ATTRIBUTES, CANONICAL_AUTHORED_TIMING_ATTRIBUTES, DERIVED_TIMING_ATTRIBUTES, LEGACY_TIMING_ATTRIBUTES, readClipTiming, writeClipTiming, ClipTimingWriteError, type ClipTiming, type ClipTimingDiagnostic, type ClipTimingDiagnosticCode, type ClipTimingUpdate, } from "./compositionContract.js";
 export { createRuntimeStartTimeResolver } from "./runtime/startResolver.js";
 export { hasClipStarted, isClipVisibleAt, isInClipWindow } from "./runtime/clipWindow.js";
+export { MEDIA_ELEMENT_LEAD_SECONDS, mediaElementTime } from "./runtime/mediaClock.js";
 export { normalizePlaybackRate, normalizeRateSpec, parseStrictFiniteTimingNumber, readElementPlaybackRate, readElementRateSpec, readMediaStart, resolveNaturalMediaTimelineDuration, resolveNaturalMediaTimelineDurationFromValues, } from "./runtime/playbackRate.js";
 export { shiftRateLane, sourceTimeAt, timeAtSourceTime, type RateSpec } from "./speedRamp.js";
 export { validateVariables, formatVariableValidationIssue, type VariableValidationIssue, } from "./runtime/validateVariables.js";

package/dist/index.js

@@ -21,6 +21,7 @@ export { CSS_URL_RE, isNonRelativeUrl, isPathInside } from "./compiler/assetPath
 export { rewriteSrcsetUrls } from "./compiler/srcset.js";
 export { checkSubCompositionUsability, } from "./compiler/subCompositionValidity.js";
 export { RUNTIME_BOOTSTRAP_ATTR, stripEmbeddedRuntimeScripts } from "./compiler/htmlDocument.js";
+export { AUTHORED_SOURCE_BEGIN, AUTHORED_SOURCE_END } from "./compiler/compositionScoping.js";
 export { COMPOSITION_SOURCE_URL } from "./compiler/scriptRuns.js";
 export { queryByAttr } from "./utils/cssSelector.js";
 export { AUDIBLE_MEDIA_SELECTOR, audibleVideoNeedsWebAudio, isAudibleVideoElement, } from "./audibleVideo.js";
@@ -57,6 +58,7 @@ export { COMPOSITION_CONTRACT_VERSION, COMPOSITION_ATTRIBUTES, CANONICAL_AUTHORE
 export { createRuntimeStartTimeResolver } from "./runtime/startResolver.js";
 // Also exposed via the ./runtime/clip-window subpath; re-exported here for the same dist-emit reason.
 export { hasClipStarted, isClipVisibleAt, isInClipWindow } from "./runtime/clipWindow.js";
+export { MEDIA_ELEMENT_LEAD_SECONDS, mediaElementTime } from "./runtime/mediaClock.js";
 export { normalizePlaybackRate, normalizeRateSpec, parseStrictFiniteTimingNumber, readElementPlaybackRate, readElementRateSpec, readMediaStart, resolveNaturalMediaTimelineDuration, resolveNaturalMediaTimelineDurationFromValues, } from "./runtime/playbackRate.js";
 export { shiftRateLane, sourceTimeAt, timeAtSourceTime } from "./speedRamp.js";
 // Variable validation (CLI / tooling-side)

package/dist/runtime/media.js

@@ -1,5 +1,6 @@
 import { swallow } from "./diagnostics.js";
 import { isClipVisibleAt, isInClipWindow } from "./clipWindow.js";
+import { mediaElementTime } from "./mediaClock.js";
 import { sameInstant } from "../clipFacts.js";
 import { interpolateVolumeGain } from "./mediaVolumeEnvelope.js";
 import { elementVolumeLaneGain } from "./audioAutomationVolume.js";
@@ -225,7 +226,7 @@ function prepareUpcomingVideo(clip, time, playing, rate) {
     try {
         // A trimmed video exposed during its in-point seek has no current frame at the cut.
         // Hidden preparation must not hold the visible-frame seek barrier.
-        el.currentTime = target;
+        el.currentTime = mediaElementTime(target);
     }
     catch (err) {
         swallow("runtime.media.preseek", err);
@@ -507,7 +508,7 @@ export function syncRuntimeMedia(params) {
                 const skipForInjectedVideo = el.tagName === "VIDEO" && !!findInjectedRenderFrame(el);
                 if (!skipForInjectedVideo) {
                     try {
-                        el.currentTime = relTime;
+                        el.currentTime = mediaElementTime(relTime);
                     }
                     catch (err) {
                         swallow("runtime.media.site2", err);
@@ -516,7 +517,7 @@ export function syncRuntimeMedia(params) {
                         seekLoadRetried.add(el);
                         el.load();
                         try {
-                            el.currentTime = relTime;
+                            el.currentTime = mediaElementTime(relTime);
                         }
                         catch (err) {
                             swallow("runtime.media.site3", err);

package/dist/runtime/mediaClock.d.ts

@@ -0,0 +1,2 @@
+export declare const MEDIA_ELEMENT_LEAD_SECONDS = 0.00001;
+export declare function mediaElementTime(sourceSeconds: number): number;

package/dist/runtime/mediaClock.js

@@ -0,0 +1,4 @@
+export const MEDIA_ELEMENT_LEAD_SECONDS = 1e-5;
+export function mediaElementTime(sourceSeconds) {
+    return sourceSeconds + MEDIA_ELEMENT_LEAD_SECONDS;
+}

package/dist/runtime/preloadMedia.js

@@ -3,6 +3,7 @@ import { createRuntimeStartTimeResolver } from "./startResolver.js";
 import { readMediaRenderId } from "./renderFrameSibling.js";
 import { defersMedia } from "./timedClipHide.js";
 import { swallow } from "./diagnostics.js";
+import { mediaElementTime } from "./mediaClock.js";
 export function isRenderFrameVideo(media) {
     const ids = window
         .__HF_RENDER_FRAME_VIDEO_IDS;
@@ -33,7 +34,7 @@ export function prepareUpcomingMedia(media, isUpcoming) {
         if (Math.abs(media.currentTime - start) <= 0.02)
             return;
         try {
-            media.currentTime = start;
+            media.currentTime = mediaElementTime(start);
         }
         catch (error) {
             swallow("runtime.preload.playbackStart", error);

package/dist/runtime/startResolver.js

@@ -60,18 +60,16 @@ export function createRuntimeStartTimeResolver(params) {
         durationCache.set(element, resolved);
         return resolved;
     };
-    const isCompositionHost = (element) => element.hasAttribute("data-composition-src") ||
-        element.hasAttribute("data-composition-id") ||
-        element.hasAttribute("data-composition-file");
-    // A mounted composition root without its own `data-start` takes its timing from the host it was
-    // loaded into: the host may use a different id than the file, or none (an anonymous host).
+    const COMPOSITION_HOST_SELECTOR = "[data-composition-src], [data-composition-id], [data-composition-file]";
+    const isCompositionHost = (element) => element.matches(COMPOSITION_HOST_SELECTOR);
+    // A mounted composition root without its own `data-start` takes its timing from the nearest host
+    // or timed wrapper above it, the clip that shows it; the host may use another id than the file.
     const inheritedTimingHost = (element) => {
-        const parent = element.parentElement;
-        if (!parent || !element.hasAttribute("data-composition-id"))
+        if (!element.hasAttribute("data-composition-id"))
             return null;
         if (parseStartExpression(element.getAttribute("data-start")))
             return null;
-        return isCompositionHost(parent) ? parent : null;
+        return element.parentElement?.closest(`[data-start], ${COMPOSITION_HOST_SELECTOR}`) ?? null;
     };
     const resolveCompositionOrigin = (compositionRoot, fallback) => compositionOriginSeconds(resolveStartForElementInternal(compositionRoot, fallback), inheritedTimingHost(compositionRoot) ?? compositionRoot);
     const resolveHostOffsetForElement = (element, fallback) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.8.205",
+  "version": "0.8.206",
   "description": "",
   "repository": {
     "type": "git",
@@ -269,6 +269,10 @@
       "import": "./dist/runtime/clipWindow.js",
       "types": "./dist/runtime/clipWindow.d.ts"
     },
+    "./runtime/media-clock": {
+      "import": "./dist/runtime/mediaClock.js",
+      "types": "./dist/runtime/mediaClock.d.ts"
+    },
     "./runtime/clip-reveal": {
       "import": "./dist/runtime/clipReveal.js",
       "types": "./dist/runtime/clipReveal.d.ts"
@@ -289,6 +293,10 @@
       "import": "./dist/compiler/htmlDocument.js",
       "types": "./dist/compiler/htmlDocument.d.ts"
     },
+    "./compiler/png-colour-tags": {
+      "import": "./dist/compiler/pngColourTags.js",
+      "types": "./dist/compiler/pngColourTags.d.ts"
+    },
     "./runtime/position-edits": {
       "import": "./dist/runtime/positionEdits.js",
       "types": "./dist/runtime/positionEdits.d.ts"
@@ -401,9 +409,9 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "wawoff2": "^2.0.1",
-    "@hyperframes/lint": "0.8.205",
-    "@hyperframes/studio-server": "0.8.205",
-    "@hyperframes/parsers": "0.8.205"
+    "@hyperframes/lint": "0.8.206",
+    "@hyperframes/studio-server": "0.8.206",
+    "@hyperframes/parsers": "0.8.206"
   },
   "devDependencies": {
     "@fontsource/archivo-black": "^5.2.8",