@hyperframes/core 0.8.184 → 0.8.186

package/dist/index.d.ts

@@ -61,3 +61,4 @@ export { ITEM_TYPES, FILE_TYPES, ITEM_TYPE_DIRS, isExampleItem, isBlockItem, isC
 export { canaryBucket, evaluateCanary, parseCanaryOverride, type CanaryDecision, type CanaryInput, type CanaryReason, } from "./canary.js";
 export { CANARIES, canaryEnvVar, findCanary, overdueCanaries, type CanaryDefinition, } from "./canaryRegistry.js";
 export { HF_VFX_ATTR, HF_VFX_CHAIN_VERSION, HF_VFX, chainCapture, getVfxDef, parseVfxChain, serializeVfxChain, normalizeVfxParams, type HfVfxCapture, type HfVfxChain, type HfVfxDef, type HfVfxNode, type HfVfxParam, type HfVfxParamValues, } from "./vfx.js";
+export { PAGE_DEVICE_SCALE_GLOBAL, PAGE_MOTION_BLUR_OFF_GLOBAL, acceleratedCanvasTrackerSource, } from "./pageMotionBlur.js";

package/dist/index.js

@@ -64,3 +64,4 @@ export { canaryBucket, evaluateCanary, parseCanaryOverride, } from "./canary.js"
 export { CANARIES, canaryEnvVar, findCanary, overdueCanaries, } from "./canaryRegistry.js";
 // VFX chain (data-vfx-chain) — defs, chain parse/serialize/normalize
 export { HF_VFX_ATTR, HF_VFX_CHAIN_VERSION, HF_VFX, chainCapture, getVfxDef, parseVfxChain, serializeVfxChain, normalizeVfxParams, } from "./vfx.js";
+export { PAGE_DEVICE_SCALE_GLOBAL, PAGE_MOTION_BLUR_OFF_GLOBAL, acceleratedCanvasTrackerSource, } from "./pageMotionBlur.js";

package/dist/pageMotionBlur.d.ts

@@ -0,0 +1,11 @@
+export declare const PAGE_MOTION_BLUR_OFF_GLOBAL = "__HF_PAGE_MOTION_BLUR_OFF__";
+export declare const PAGE_DEVICE_SCALE_GLOBAL = "__HF_DEVICE_SCALE_FACTOR__";
+export declare function supportsCaptureMotionBlur(win?: Window): boolean;
+/**
+ * Remember canvases html-in-canvas cannot capture: WebGL, WebGPU, or handed to an OffscreenCanvas.
+ * Self-contained: the engine and the preview run its source ahead of every author script.
+ */
+export declare function installAcceleratedCanvasTracker(): void;
+export declare function isAcceleratedCanvas(canvas: HTMLCanvasElement): boolean;
+/** The tracker as a script body, for `evaluateOnNewDocument` and inline `<script>` injection. */
+export declare function acceleratedCanvasTrackerSource(): string;

package/dist/pageMotionBlur.js

@@ -0,0 +1,48 @@
+import { htmlInCanvasForm } from "./htmlInCanvas.js";
+// Engine-set: the off switch (its sub-frame blur runs, or the preview could not blur); the render scale (dpr falls back to 1).
+export const PAGE_MOTION_BLUR_OFF_GLOBAL = "__HF_PAGE_MOTION_BLUR_OFF__";
+export const PAGE_DEVICE_SCALE_GLOBAL = "__HF_DEVICE_SCALE_FACTOR__";
+export function supportsCaptureMotionBlur(win = window) {
+    return htmlInCanvasForm(win) !== null;
+}
+const ACCELERATED_CANVASES_GLOBAL = "__hfAcceleratedCanvases";
+/**
+ * Remember canvases html-in-canvas cannot capture: WebGL, WebGPU, or handed to an OffscreenCanvas.
+ * Self-contained: the engine and the preview run its source ahead of every author script.
+ */
+export function installAcceleratedCanvasTracker() {
+    const key = "__hfAcceleratedCanvases";
+    const known = Reflect.get(window, key);
+    const seen = known instanceof WeakSet ? known : new WeakSet();
+    if (seen !== known)
+        Object.defineProperty(window, key, { value: seen });
+    const accelerated = ["webgl", "webgl2", "experimental-webgl", "webgpu"];
+    const wrap = (name, onCall) => {
+        const proto = HTMLCanvasElement.prototype;
+        const original = Reflect.get(proto, name);
+        if (typeof original !== "function" || "__hfAccelTracked" in original)
+            return;
+        const tracked = function (...args) {
+            const result = Reflect.apply(original, this, args);
+            onCall(this, args, result);
+            return result;
+        };
+        Object.defineProperty(tracked, "__hfAccelTracked", { value: true });
+        Object.defineProperty(proto, name, { value: tracked, writable: true, configurable: true });
+    };
+    wrap("getContext", (canvas, args, ctx) => {
+        if (ctx && accelerated.includes(String(args[0])))
+            seen.add(canvas);
+    });
+    wrap("transferControlToOffscreen", (canvas) => {
+        seen.add(canvas);
+    });
+}
+export function isAcceleratedCanvas(canvas) {
+    const seen = Reflect.get(window, ACCELERATED_CANVASES_GLOBAL);
+    return seen instanceof WeakSet && seen.has(canvas);
+}
+/** The tracker as a script body, for `evaluateOnNewDocument` and inline `<script>` injection. */
+export function acceleratedCanvasTrackerSource() {
+    return `(${installAcceleratedCanvasTracker.toString()})();`;
+}

package/dist/runtime/audioAutomationVolume.d.ts

@@ -1,11 +1,9 @@
 /**
  * The volume lane's gain for an element at a moment in its clip.
  *
- * Volume is not scheduled onto the gain AudioParam the way FX parameters are.
- * The runtime rewrites that gain every tick from `data-volume` and the GSAP
- * seeked value, which would erase a scheduled envelope within a frame — so the
- * lane feeds the same per-tick path the probed `volumeKeyframes` already use,
- * and the render still bakes it into the samples.
+ * Read per tick for a clip that sounds through `el.volume`. A clip the Web Audio
+ * transport routes plays its lane scheduled on a gain of its own
+ * (`attachClipStages`), out of reach of the per-tick gain write.
  */
 import { type HfAutomationLane } from "../audioAutomation.js";
 /** The lane for `target` inside a `data-automation` value, or null when absent or unreadable. */

package/dist/runtime/audioAutomationVolume.js

@@ -1,11 +1,9 @@
 /**
  * The volume lane's gain for an element at a moment in its clip.
  *
- * Volume is not scheduled onto the gain AudioParam the way FX parameters are.
- * The runtime rewrites that gain every tick from `data-volume` and the GSAP
- * seeked value, which would erase a scheduled envelope within a frame — so the
- * lane feeds the same per-tick path the probed `volumeKeyframes` already use,
- * and the render still bakes it into the samples.
+ * Read per tick for a clip that sounds through `el.volume`. A clip the Web Audio
+ * transport routes plays its lane scheduled on a gain of its own
+ * (`attachClipStages`), out of reach of the per-tick gain write.
  */
 import { HF_AUDIO_AUTOMATION_ATTR, parseAutomation, sampleAutomationLane, VOLUME_TARGET, } from "../audioAutomation.js";
 /**

package/dist/runtime/media.js

@@ -325,7 +325,8 @@ export function syncRuntimeMedia(params) {
             // there is one time base, and this is it.
             const laneGain = elementVolumeLaneGain(el, params.timeSeconds - origin);
             if (laneGain !== null) {
-                authorVolume = clampAudioGain(laneGain);
+                const transportOwnsLane = params.isWebAudioRouted?.(el);
+                authorVolume = transportOwnsLane ? 1 : clampAudioGain(laneGain);
             }
             else if (clip.volumeKeyframes && clip.volumeKeyframes.length > 0) {
                 // Keyframes probed from the GSAP timeline — same source as the renderer.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.8.184",
+  "version": "0.8.186",
   "description": "",
   "repository": {
     "type": "git",
@@ -84,6 +84,10 @@
       "import": "./dist/keyframeDefaults.js",
       "types": "./dist/keyframeDefaults.d.ts"
     },
+    "./html-in-canvas": {
+      "import": "./dist/htmlInCanvas.js",
+      "types": "./dist/htmlInCanvas.d.ts"
+    },
     "./gsap-cdn": {
       "import": "./dist/gsapCdn.js",
       "types": "./dist/gsapCdn.d.ts"
@@ -381,9 +385,9 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "wawoff2": "^2.0.1",
-    "@hyperframes/lint": "0.8.184",
-    "@hyperframes/studio-server": "0.8.184",
-    "@hyperframes/parsers": "0.8.184"
+    "@hyperframes/lint": "0.8.186",
+    "@hyperframes/studio-server": "0.8.186",
+    "@hyperframes/parsers": "0.8.186"
   },
   "devDependencies": {
     "@fontsource/archivo-black": "^5.2.8",