@hyperframes/core 0.9.15 → 0.9.17

package/dist/index.d.ts

@@ -35,7 +35,7 @@ export { HF_COLOR_GRADING_ATTR, HF_COLOR_GRADING_ADJUST_KEYS, HF_COLOR_GRADING_A
 export { colorGroupOf, effectiveColorGrading, ensureColorGroupInertStyle, HF_COLOR_GROUP_ATTR, HF_COLOR_GROUP_TAG, resolveColorGroupElement, } from "./colorGroups.js";
 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 { firstFrameColourArgs, hdrToSdrToneMapFilter, keyframeTransferArgs, parseKeyframeTransfers, readsKeyframeTransfers, toneMapReferenceNits, parseFirstFrameColour, type ToneMapFrameColour, 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_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";
@@ -57,7 +57,7 @@ export { SCENE_CALLBACK_ERROR_PREFIX } from "./runtime/diagnostics.js";
 export { parseStartExpression, parseNumeric, type ReferenceExpression, } from "./runtime/startExpression.js";
 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 { hasClipStarted, isClipOnScreenAt, 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";

package/dist/index.js

@@ -31,7 +31,7 @@ export { HF_COLOR_GRADING_ATTR, HF_COLOR_GRADING_ADJUST_KEYS, HF_COLOR_GRADING_A
 export { colorGroupOf, effectiveColorGrading, ensureColorGroupInertStyle, HF_COLOR_GROUP_ATTR, HF_COLOR_GROUP_TAG, resolveColorGroupElement, } from "./colorGroups.js";
 export { parseCubeLut, CubeLutParseError, } from "./colorLuts.js";
 export { bakeHfColorGradingCube } from "./colorGradingBake.js";
-export { firstFrameColourArgs, hdrToSdrToneMapFilter, parseFirstFrameColour, } from "./hdrToneMap.js";
+export { firstFrameColourArgs, hdrToSdrToneMapFilter, keyframeTransferArgs, parseKeyframeTransfers, readsKeyframeTransfers, toneMapReferenceNits, 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_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";
@@ -59,7 +59,7 @@ export { COMPOSITION_CONTRACT_VERSION, COMPOSITION_ATTRIBUTES, CANONICAL_AUTHORE
 // (verify:packed-manifests catches exactly that).
 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 { hasClipStarted, isClipOnScreenAt, 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";

package/dist/runtime/clipWindow.d.ts

@@ -6,3 +6,5 @@ export declare const isInClipWindow: (time: number, start: number, end: number)
  * the terminal instant, so a finished film rests on its last frame instead of going blank.
  */
 export declare const isClipVisibleAt: (time: number, start: number, end: number, compositionDuration: number) => boolean;
+/** The one on-screen rule render, snapshot and preview share: edges a hair off a frame count as on it. */
+export declare const isClipOnScreenAt: (time: number, start: number, end: number, fps: number, compositionDuration: number) => boolean;

package/dist/runtime/clipWindow.js

@@ -1,4 +1,5 @@
 import { sameInstant } from "../clipFacts.js";
+import { exportClipWindow } from "../inline-scripts/parityContract.js";
 export const hasClipStarted = (time, start) => time >= start || sameInstant(time, start);
 /** Half-open: two back-to-back clips never both hold the shared boundary instant, float sums included. */
 export const isInClipWindow = (time, start, end) => hasClipStarted(time, start) && time < end && !sameInstant(time, end);
@@ -11,3 +12,8 @@ export const isClipVisibleAt = (time, start, end, compositionDuration) => isInCl
     (hasClipStarted(time, start) &&
         compositionDuration > 0 &&
         end >= compositionDuration - TERMINAL_EPSILON_SECONDS);
+/** The one on-screen rule render, snapshot and preview share: edges a hair off a frame count as on it. */
+export const isClipOnScreenAt = (time, start, end, fps, compositionDuration) => {
+    const snapped = exportClipWindow(start, end, fps);
+    return isClipVisibleAt(time, snapped.start, snapped.end, compositionDuration);
+};

package/dist/runtime/diagnostics.d.ts

@@ -2,4 +2,10 @@
 export declare function recordStartupError(error: unknown): void;
 /** Starts the warning for a scene callback that threw; the render log shows it once per render. */
 export declare const SCENE_CALLBACK_ERROR_PREFIX = "[hyperframes] scene timeline callback threw:";
+/**
+ * A rejected `window.__hf.buildReady[key]` is the composition saying its own setup failed, so
+ * readiness waits (render, snapshot, check) fail with the key and reason instead of capturing an
+ * unbuilt scene. Returns the recorded message so a teardown can clear exactly this error.
+ */
+export declare function recordBuildReadyRejection(key: string, error: unknown): string;
 export declare function swallow(label: string, error?: unknown): void;

package/dist/runtime/diagnostics.js

@@ -50,6 +50,25 @@ export function recordStartupError(error) {
 }
 /** Starts the warning for a scene callback that threw; the render log shows it once per render. */
 export const SCENE_CALLBACK_ERROR_PREFIX = "[hyperframes] scene timeline callback threw:";
+/**
+ * A rejected `window.__hf.buildReady[key]` is the composition saying its own setup failed, so
+ * readiness waits (render, snapshot, check) fail with the key and reason instead of capturing an
+ * unbuilt scene. Returns the recorded message so a teardown can clear exactly this error.
+ */
+export function recordBuildReadyRejection(key, error) {
+    let detail = "unknown error";
+    try {
+        detail = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
+    }
+    catch (err) {
+        swallow("runtime.buildReadyRejection", err);
+    }
+    const message = `window.__hf.buildReady[${JSON.stringify(key)}] rejected: ${detail}. ` +
+        `The composition reported that its own setup failed, so it cannot be rendered. Fix that ` +
+        `setup, or resolve the promise only once the scene is drawable.`;
+    window.__hfStartupError = message;
+    return message;
+}
 export function swallow(label, error) {
     if (typeof window === "undefined")
         return;

package/dist/runtime/timeline.d.ts

@@ -11,7 +11,6 @@ export declare function isRuntimeElementVisibleAt(rawNode: Element, options: {
     currentTime: number;
     compositionDuration: number;
     canonicalFps: number;
-    exportRenderSeek: boolean;
     timelineRegistry: Record<string, RuntimeTimelineLike | undefined>;
     resolver: ReturnType<typeof createRuntimeStartTimeResolver>;
 }): boolean;

package/dist/runtime/timeline.js

@@ -7,8 +7,7 @@ import { readElementPlaybackRate, readMediaStart } from "./playbackRate.js";
 import { parseStrictFiniteTimingNumber, resolveMediaElementDurationSeconds, resolveNaturalMediaTimelineDuration, resolveTimedImageDurationSeconds, } from "./playbackRate.js";
 import { resolveCssStackingContextId } from "./stackingContext.js";
 import { createRuntimeStartTimeResolver } from "./startResolver.js";
-import { isClipVisibleAt } from "./clipWindow.js";
-import { exportClipWindow } from "../inline-scripts/parityContract.js";
+import { isClipOnScreenAt } from "./clipWindow.js";
 import { isSceneLikeCompositionId } from "../slideshow/index.js";
 import { COMPOSITION_CONTRACT_VERSION } from "../compositionContract.js";
 import { runtimeProtocolMetadata } from "./protocol.js";
@@ -50,11 +49,7 @@ export function isRuntimeElementVisibleAt(rawNode, options) {
     const span = runtimeElementWindow(rawNode, options);
     if (!span)
         return false;
-    // Export seeks snap to frame boundaries; interactive visibility uses authored seconds.
-    const clipWindow = options.exportRenderSeek
-        ? exportClipWindow(span.start, span.end, options.canonicalFps)
-        : span;
-    return isClipVisibleAt(options.currentTime, clipWindow.start, clipWindow.end, options.compositionDuration);
+    return isClipOnScreenAt(options.currentTime, span.start, span.end, options.canonicalFps, options.compositionDuration);
 }
 function parseNum(value) {
     return parseStrictFiniteTimingNumber(value);

package/package.json

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