@hyperframes/core 0.8.212 → 0.8.214

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/domRealm.d.ts

@@ -49,6 +49,8 @@ export declare function isHtmlElement(value: unknown): value is HTMLElement;
 export declare function isVideoElement(value: unknown): value is HTMLVideoElement;
 /** `<audio>`, from any realm. Mirrors `instanceof HTMLAudioElement`. */
 export declare function isAudioElement(value: unknown): value is HTMLAudioElement;
+/** `<source>`, from any realm. Mirrors `instanceof HTMLSourceElement`. */
+export declare function isSourceElement(value: unknown): value is HTMLSourceElement;
 /** `<video>` or `<audio>`, from any realm. Mirrors `instanceof HTMLMediaElement`. */
 export declare function isMediaElement(value: unknown): value is HTMLMediaElement;
 /** `<img>`, from any realm. Mirrors `instanceof HTMLImageElement`. */

package/dist/runtime/domRealm.js

@@ -63,6 +63,10 @@ export function isVideoElement(value) {
 export function isAudioElement(value) {
     return isHtmlTag(value, "audio");
 }
+/** `<source>`, from any realm. Mirrors `instanceof HTMLSourceElement`. */
+export function isSourceElement(value) {
+    return isHtmlTag(value, "source");
+}
 /** `<video>` or `<audio>`, from any realm. Mirrors `instanceof HTMLMediaElement`. */
 export function isMediaElement(value) {
     return isVideoElement(value) || isAudioElement(value);

package/dist/runtime/protocol.d.ts

@@ -1,5 +1,6 @@
 export declare const RUNTIME_PROTOCOL_VERSION: 1;
 export declare const RUNTIME_FILLER = "hf-runtime-filler";
+export declare const RUNTIME_MEDIA_LOAD_FAILED = "runtime_media_load_failed";
 export declare const RUNTIME_PROTOCOL_CAPABILITIES: readonly ["seconds-time", "rational-fps", "seek-keep-playing", "composition-manifest-v1", "runtime-data", "play-range"];
 export type RuntimeProtocolFps = {
     numerator: number;
@@ -28,3 +29,15 @@ export declare function runtimeProtocolFpsToNumber(value: unknown): number | nul
 export declare function runtimeProtocolMetadata(fps: number): RuntimeProtocolV1;
 export declare function frameDisplayScale(frame: HTMLElement): number | null;
 export declare function inspectRuntimeProtocol(value: unknown, legacyFps?: number): RuntimeProtocolInspection;
+declare const STAGES: readonly ["fetch", "decode", "element"];
+export type MediaLoadStage = (typeof STAGES)[number];
+export interface MediaLoadFailure {
+    elementId: string | null;
+    kind: string;
+    stage: MediaLoadStage;
+    code: number | null;
+    bytes: number | null;
+    extension: string | null;
+}
+export declare function parseMediaLoadFailure(value: unknown): MediaLoadFailure | null;
+export {};

package/dist/runtime/protocol.js

@@ -1,5 +1,6 @@
 export const RUNTIME_PROTOCOL_VERSION = 1;
 export const RUNTIME_FILLER = "hf-runtime-filler";
+export const RUNTIME_MEDIA_LOAD_FAILED = "runtime_media_load_failed";
 export const RUNTIME_PROTOCOL_CAPABILITIES = [
     "seconds-time",
     "rational-fps",
@@ -81,3 +82,22 @@ export function inspectRuntimeProtocol(value, legacyFps = 30) {
         metadata: message,
     };
 }
+const STAGES = ["fetch", "decode", "element"];
+const numberOrNull = (n) => (typeof n === "number" ? n : null);
+const stringOrNull = (s) => (typeof s === "string" ? s : null);
+export function parseMediaLoadFailure(value) {
+    if (typeof value !== "object" || value === null)
+        return null;
+    const { elementId, kind, stage, code, bytes, extension } = value;
+    const known = STAGES.find((s) => s === stage);
+    if (!known || typeof kind !== "string")
+        return null;
+    return {
+        elementId: stringOrNull(elementId),
+        kind,
+        stage: known,
+        code: numberOrNull(code),
+        bytes: numberOrNull(bytes),
+        extension: stringOrNull(extension),
+    };
+}

package/package.json

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