@hyperframes/core 0.9.14 → 0.9.16

package/dist/motionBlurSettings.d.ts

@@ -2,6 +2,7 @@
 export declare const MOTION_BLUR_ATTR: {
     readonly enable: "data-motion-blur";
     readonly shutter: "data-motion-blur-shutter";
+    readonly phase: "data-motion-blur-phase";
     readonly samples: "data-motion-blur-samples";
     readonly events: "data-motion-blur-events";
     readonly tier: "data-motion-blur-tier";
@@ -12,6 +13,10 @@ export declare const MOTION_BLUR_LIMITS: {
         readonly max: 720;
         readonly default: 240;
     };
+    readonly phaseDeg: {
+        readonly min: -360;
+        readonly max: 360;
+    };
     readonly samples: {
         readonly min: 2;
         readonly max: 64;
@@ -21,6 +26,7 @@ export type MotionBlurTier = "auto" | "capture" | "filter";
 export interface MotionBlurSettings {
     enabled: boolean;
     shutterDeg: number;
+    phaseDeg: number | null;
     /** A fixed count per frame; null sizes it to each smear, never under 32. */
     samples: number | null;
     events: boolean;

package/dist/motionBlurSettings.js

@@ -2,12 +2,14 @@
 export const MOTION_BLUR_ATTR = {
     enable: "data-motion-blur",
     shutter: "data-motion-blur-shutter",
+    phase: "data-motion-blur-phase",
     samples: "data-motion-blur-samples",
     events: "data-motion-blur-events",
     tier: "data-motion-blur-tier",
 };
 export const MOTION_BLUR_LIMITS = {
     shutterDeg: { min: 0, max: 720, default: 240 },
+    phaseDeg: { min: -360, max: 360 },
     samples: { min: 2, max: 64 },
 };
 const clamp = (x, lo, hi) => Math.min(hi, Math.max(lo, x));
@@ -19,12 +21,14 @@ function number(value) {
 }
 export function readMotionBlurSettings(attr) {
     const shutter = number(attr(MOTION_BLUR_ATTR.shutter));
+    const phase = number(attr(MOTION_BLUR_ATTR.phase));
     const samples = number(attr(MOTION_BLUR_ATTR.samples));
     const tier = attr(MOTION_BLUR_ATTR.tier);
-    const { shutterDeg, samples: bounds } = MOTION_BLUR_LIMITS;
+    const { shutterDeg, phaseDeg, samples: bounds } = MOTION_BLUR_LIMITS;
     return {
         enabled: attr(MOTION_BLUR_ATTR.enable) === "on",
         shutterDeg: clamp(shutter ?? shutterDeg.default, shutterDeg.min, shutterDeg.max),
+        phaseDeg: phase === null ? null : clamp(phase, phaseDeg.min, phaseDeg.max),
         samples: samples === null ? null : Math.round(clamp(samples, bounds.min, bounds.max)),
         events: attr(MOTION_BLUR_ATTR.events) === "on",
         tier: tier === "capture" || tier === "filter" ? tier : "auto",
@@ -39,6 +43,7 @@ export function motionBlurAttributeEdits(settings) {
     return {
         [MOTION_BLUR_ATTR.enable]: settings.enabled ? "on" : null,
         [MOTION_BLUR_ATTR.shutter]: settings.shutterDeg === shutterDeg.default ? null : String(settings.shutterDeg),
+        [MOTION_BLUR_ATTR.phase]: settings.phaseDeg === null ? null : String(settings.phaseDeg),
         [MOTION_BLUR_ATTR.samples]: settings.samples === null ? null : String(settings.samples),
         [MOTION_BLUR_ATTR.events]: settings.events ? "on" : null,
         [MOTION_BLUR_ATTR.tier]: settings.tier === "auto" ? null : settings.tier,

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