@hyperframes/core 0.8.212 → 0.8.213

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.213",
   "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.213",
+    "@hyperframes/parsers": "0.8.213",
+    "@hyperframes/studio-server": "0.8.213"
   },
   "devDependencies": {
     "@fontsource/archivo-black": "^5.2.8",