@hyperframes/core 0.9.15 → 0.9.16

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.9.15",
+  "version": "0.9.16",
   "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.16",
+    "@hyperframes/parsers": "0.9.16",
+    "@hyperframes/studio-server": "0.9.16"
   },
   "devDependencies": {
     "@fontsource/archivo-black": "^5.2.8",