@hyperframes/core 0.8.213 → 0.8.216

package/dist/index.d.ts

@@ -32,7 +32,9 @@ export { AUDIBLE_MEDIA_SELECTOR, audibleVideoNeedsWebAudio, isAudibleVideoElemen
 export { decodeUrlPathVariants } from "./utils/urlPath.js";
 export { clearGifFramesBeforeNext, gifClearsAfterLeavingFrameInPlace, parseAnimatedGifMetadata, type AnimatedGifMetadata, } from "./media/gif.js";
 export { HF_COLOR_GRADING_ATTR, HF_COLOR_GRADING_ADJUST_KEYS, HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS, HF_COLOR_GRADING_ANIMATABLE_PROPERTIES, HF_COLOR_GRADING_CANVAS_ID_PREFIX, HF_COLOR_GRADING_COLOR_SPACE, HF_COLOR_GRADING_CURVE_KEYS, HF_COLOR_GRADING_DETAIL_KEYS, HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS, HF_COLOR_GRADING_EFFECT_KEYS, HF_COLOR_GRADING_EFFECT_PRESETS, HF_COLOR_GRADING_GRADE_PRESETS, HF_COLOR_GRADING_HUE_CURVE_KEYS, HF_COLOR_GRADING_LUT_KEYS, HF_COLOR_GRADING_PALETTES, HF_COLOR_GRADING_PRESETS, HF_COLOR_GRADING_TOP_LEVEL_KEYS, HF_COLOR_GRADING_WHEEL_KEYS, getHfColorGradingCapabilities, hasHfColorGradingAuthoredValues, isHfColorGradingActive, normalizeHfColorGrading, normalizeHfColorGradingWithVariables, resolveHfColorGradingVariables, serializeHfColorGrading, type HfColorGrading, type HfColorGradingAdjust, type HfColorGradingAdjustKey, type HfColorGradingAnimatablePath, type HfColorGradingActiveEffectKey, type HfColorGradingDetailKey, type HfColorGradingDetails, type HfColorGradingEffectKey, type HfColorGradingEffects, type HfColorGradingLutRef, type HfColorGradingPreset, type HfColorGradingPresetId, type HfColorGradingTarget, type HfColorGradingVariableMap, type HfColorGradingCapabilities, type HfColorGradingCurveKey, type HfColorGradingCurves, type HfColorGradingHueCurveKey, type HfColorGradingHueCurves, type HfColorGradingHueRange, type HfColorGradingSecondary, type HfColorGradingSecondaryCorrection, type HfColorGradingSoftRange, type HfColorGradingTonalWheel, type HfColorGradingWheelKey, type HfColorGradingWheels, type HfColorCurvePoint, type HfHueCurvePoint, type NormalizedHfColorGrading, type NormalizedHfColorGradingCurves, type NormalizedHfColorGradingHueCurves, type NormalizedHfColorGradingSecondary, type NormalizedHfColorGradingWheels, type ResolvedHfColorGrading, } from "./colorGrading.js";
-export { parseCubeLut, CubeLutParseError, type ParseCubeLutOptions } from "./colorLuts.js";
+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 { 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 { HYPERFRAME_RUNTIME_ARTIFACTS, HYPERFRAME_RUNTIME_CONTRACT, loadHyperframeRuntimeSource, type HyperframeRuntimeContract, } from "./inline-scripts/hyperframe.js";

package/dist/index.js

@@ -28,7 +28,9 @@ export { AUDIBLE_MEDIA_SELECTOR, audibleVideoNeedsWebAudio, isAudibleVideoElemen
 export { decodeUrlPathVariants } from "./utils/urlPath.js";
 export { clearGifFramesBeforeNext, gifClearsAfterLeavingFrameInPlace, parseAnimatedGifMetadata, } from "./media/gif.js";
 export { HF_COLOR_GRADING_ATTR, HF_COLOR_GRADING_ADJUST_KEYS, HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS, HF_COLOR_GRADING_ANIMATABLE_PROPERTIES, HF_COLOR_GRADING_CANVAS_ID_PREFIX, HF_COLOR_GRADING_COLOR_SPACE, HF_COLOR_GRADING_CURVE_KEYS, HF_COLOR_GRADING_DETAIL_KEYS, HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS, HF_COLOR_GRADING_EFFECT_KEYS, HF_COLOR_GRADING_EFFECT_PRESETS, HF_COLOR_GRADING_GRADE_PRESETS, HF_COLOR_GRADING_HUE_CURVE_KEYS, HF_COLOR_GRADING_LUT_KEYS, HF_COLOR_GRADING_PALETTES, HF_COLOR_GRADING_PRESETS, HF_COLOR_GRADING_TOP_LEVEL_KEYS, HF_COLOR_GRADING_WHEEL_KEYS, getHfColorGradingCapabilities, hasHfColorGradingAuthoredValues, isHfColorGradingActive, normalizeHfColorGrading, normalizeHfColorGradingWithVariables, resolveHfColorGradingVariables, serializeHfColorGrading, } from "./colorGrading.js";
-export { parseCubeLut, CubeLutParseError } from "./colorLuts.js";
+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 { 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";
 // Inline scripts

package/dist/runtime/compositionLength.d.ts

@@ -11,11 +11,16 @@ export declare function readCompositionSize(root: Element): {
     width: number | null;
     height: number | null;
 };
-/** The latest end among the document's timed video and audio, at their absolute starts. */
-export declare function resolveMediaWindowDurationSeconds(doc: ParentNode, media: {
+type MediaTiming = {
     mediaStart: (el: HTMLMediaElement) => number;
     mediaDuration: (el: HTMLMediaElement) => number | null;
-}): number | null;
+};
+/** The timed `<video>`/`<audio>` whose window ends last, and where it ends. */
+export declare function longestMediaWindow(doc: ParentNode, media: MediaTiming): {
+    seconds: number;
+    element: HTMLMediaElement;
+} | null;
+export declare function resolveMediaWindowDurationSeconds(doc: ParentNode, media: MediaTiming): number | null;
 /** The latest of the root's declared length and its direct sub-compositions' ends. */
 export declare function resolveAuthoredCompositionFloorSeconds(root: Element, startResolver: StartResolver): number | null;
 /** The last-resort length: the latest end among the root's timed clips. Until every clip's length
@@ -31,9 +36,24 @@ export type CompositionLengthInputs = {
     fallback: number;
     derived: () => number;
 };
-/** A declared root length is the length; else the longest of timeline, floors and fallback (a
- *  loop-inflated timeline yields to a floor or fallback); else the length derived from the clips. */
+export type CompositionLengthFrom = "declared" | "timeline" | "floor" | "fallback" | "derived";
+export type CompositionLengthSource = {
+    from: CompositionLengthFrom;
+} | {
+    from: "media";
+    tag: string;
+    src: string;
+    trimmed: boolean;
+};
 export declare function resolveCompositionLengthSeconds(input: CompositionLengthInputs): number;
+/** A declared root length is the length; else the longest of timeline, floors and fallback (a
+ *  loop-inflated timeline yields to a floor or fallback); else the length derived from the clips.
+ *  `from` names the input that set it, and `floorIndex` which floor when a floor did. */
+export declare function resolveCompositionLength(input: CompositionLengthInputs): {
+    seconds: number;
+    from: CompositionLengthFrom;
+    floorIndex: number | null;
+};
 /** Size, frame rate and length of a composition nothing is running (a server-parsed or detached
  *  document): no timelines, no adapters, and media without a known source length is pending. */
 export declare function readStaticCompositionMeta(doc: Document): {

package/dist/runtime/compositionLength.js

@@ -16,9 +16,9 @@ export function readCompositionSize(root) {
         height: parseCompositionDimension(root.getAttribute("data-height")),
     };
 }
-/** The latest end among the document's timed video and audio, at their absolute starts. */
-export function resolveMediaWindowDurationSeconds(doc, media) {
-    const clipEnds = [];
+/** The timed `<video>`/`<audio>` whose window ends last, and where it ends. */
+export function longestMediaWindow(doc, media) {
+    let longest = null;
     for (const node of doc.querySelectorAll("video[data-start], audio[data-start]")) {
         const start = media.mediaStart(node);
         if (!Number.isFinite(start))
@@ -26,10 +26,14 @@ export function resolveMediaWindowDurationSeconds(doc, media) {
         const duration = media.mediaDuration(node);
         if (duration == null || duration <= MIN_VALID_TIMELINE_DURATION_SECONDS)
             continue;
-        clipEnds.push(Math.max(0, start) + duration);
+        const end = Math.max(0, start) + duration;
+        if (!longest || end > longest.seconds)
+            longest = { seconds: end, element: node };
     }
-    return aboveOneFrame(resolveCompositionDuration({ authoredDurationSeconds: null, clipEndsSeconds: clipEnds })
-        .seconds);
+    return longest && aboveOneFrame(longest.seconds) !== null ? longest : null;
+}
+export function resolveMediaWindowDurationSeconds(doc, media) {
+    return longestMediaWindow(doc, media)?.seconds ?? null;
 }
 /** The latest of the root's declared length and its direct sub-compositions' ends. */
 export function resolveAuthoredCompositionFloorSeconds(root, startResolver) {
@@ -75,14 +79,19 @@ export function resolveContentDerivedDuration(root, startResolver, { unregistere
         ? { ...result, seconds: null, source: "unresolved", reason: "a clip's length is pending" }
         : result;
 }
-/** A declared root length is the length; else the longest of timeline, floors and fallback (a
- *  loop-inflated timeline yields to a floor or fallback); else the length derived from the clips. */
 export function resolveCompositionLengthSeconds(input) {
+    return resolveCompositionLength(input).seconds;
+}
+/** A declared root length is the length; else the longest of timeline, floors and fallback (a
+ *  loop-inflated timeline yields to a floor or fallback); else the length derived from the clips.
+ *  `from` names the input that set it, and `floorIndex` which floor when a floor did. */
+export function resolveCompositionLength(input) {
     if (input.declared !== null && Number.isFinite(input.declared) && input.declared > 0) {
-        return input.declared;
+        return { seconds: input.declared, from: "declared", floorIndex: null };
     }
     const rawTimeline = aboveOneFrame(input.timeline());
-    const floor = Math.max(0, ...input.floors().map((seconds) => seconds ?? 0));
+    const floors = input.floors().map((seconds) => seconds ?? 0);
+    const floor = Math.max(0, ...floors);
     const fallback = Number.isFinite(input.fallback) && input.fallback > MIN_VALID_TIMELINE_DURATION_SECONDS
         ? input.fallback
         : 0;
@@ -91,16 +100,23 @@ export function resolveCompositionLengthSeconds(input) {
         rawTimeline >= LOOP_INFLATED_TIMELINE_SECONDS &&
         aboveOneFrame(floorOrFallback) !== null;
     const timeline = loopInflated ? null : rawTimeline;
-    let seconds;
-    if (timeline !== null)
-        seconds = Math.max(timeline, floorOrFallback);
-    else if (aboveOneFrame(floor) !== null)
-        seconds = floorOrFallback;
-    else if (fallback > 0)
-        seconds = fallback;
-    else
-        seconds = input.derived();
-    return seconds > 0 ? seconds : 0;
+    const floorWins = floor >= fallback;
+    const fromFloorOrFallback = (seconds) => ({
+        seconds,
+        from: floorWins ? "floor" : "fallback",
+        floorIndex: floorWins ? floors.indexOf(floor) : null,
+    });
+    if (timeline !== null) {
+        return timeline >= floorOrFallback
+            ? { seconds: timeline, from: "timeline", floorIndex: null }
+            : fromFloorOrFallback(floorOrFallback);
+    }
+    if (aboveOneFrame(floor) !== null)
+        return fromFloorOrFallback(floorOrFallback);
+    if (fallback > 0)
+        return { seconds: fallback, from: "fallback", floorIndex: null };
+    const derived = input.derived();
+    return { seconds: derived > 0 ? derived : 0, from: "derived", floorIndex: null };
 }
 /** Size, frame rate and length of a composition nothing is running (a server-parsed or detached
  *  document): no timelines, no adapters, and media without a known source length is pending. */

package/dist/runtime/mediaClock.d.ts

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

package/dist/runtime/mediaClock.js

@@ -2,3 +2,7 @@ export const MEDIA_ELEMENT_LEAD_SECONDS = 1e-5;
 export function mediaElementTime(sourceSeconds) {
     return sourceSeconds + MEDIA_ELEMENT_LEAD_SECONDS;
 }
+export function startsSoundOnlyInsideATap() {
+    const { userAgent, maxTouchPoints } = navigator;
+    return /iP(hone|ad|od)/.test(userAgent) || (/Macintosh/.test(userAgent) && maxTouchPoints > 1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.8.213",
+  "version": "0.8.216",
   "description": "",
   "repository": {
     "type": "git",
@@ -64,6 +64,10 @@
       "import": "./dist/removeTree.js",
       "types": "./dist/removeTree.d.ts"
     },
+    "./env-proxy": {
+      "import": "./dist/envProxy.js",
+      "types": "./dist/envProxy.d.ts"
+    },
     "./rename-retry": {
       "import": "./dist/renameWithRetry.js",
       "types": "./dist/renameWithRetry.d.ts"
@@ -425,9 +429,9 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "wawoff2": "^2.0.1",
-    "@hyperframes/lint": "0.8.213",
-    "@hyperframes/parsers": "0.8.213",
-    "@hyperframes/studio-server": "0.8.213"
+    "@hyperframes/lint": "0.8.216",
+    "@hyperframes/parsers": "0.8.216",
+    "@hyperframes/studio-server": "0.8.216"
   },
   "devDependencies": {
     "@fontsource/archivo-black": "^5.2.8",