@hyperframes/core 0.8.185 → 0.8.188

package/dist/index.d.ts

@@ -61,4 +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 } from "./pageMotionBlur.js";
+export { PAGE_DEVICE_SCALE_GLOBAL, PAGE_MOTION_BLUR_OFF_GLOBAL, acceleratedCanvasTrackerSource, } from "./pageMotionBlur.js";

package/dist/index.js

@@ -64,4 +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 } from "./pageMotionBlur.js";
+export { PAGE_DEVICE_SCALE_GLOBAL, PAGE_MOTION_BLUR_OFF_GLOBAL, acceleratedCanvasTrackerSource, } from "./pageMotionBlur.js";

package/dist/inline-scripts/hyperframesRuntime.engine.d.ts

@@ -3,6 +3,9 @@ export type HyperframesRuntimeBuildOptions = {
     defaultParityMode?: boolean;
     minify?: boolean;
 };
+export declare const RUNTIME_ESBUILD_DEFINE: {
+    console: string;
+};
 /**
  * Build the runtime IIFE from source via esbuild.
  *

package/dist/inline-scripts/hyperframesRuntime.engine.js

@@ -2,6 +2,7 @@ import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+export const RUNTIME_ESBUILD_DEFINE = { console: "globalThis.console" };
 function applyDefaultParityMode(script, enabled) {
     const parityFlagPattern = /var\s+_parityModeEnabled\s*=\s*(?:true|false)\s*;/;
     if (!parityFlagPattern.test(script))
@@ -29,6 +30,7 @@ export function buildHyperframesRuntimeScript(options = {}) {
         target: ["es2020"],
         minify: options.minify ?? true,
         legalComments: "none",
+        define: RUNTIME_ESBUILD_DEFINE,
     });
     let script = result.outputFiles[0]?.text ?? "";
     if (typeof options.defaultParityMode === "boolean") {

package/dist/pageMotionBlur.d.ts

@@ -1,3 +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

@@ -1,9 +1,48 @@
-// Set by the engine: its own sub-frame blur runs, or the Studio preview could not blur.
+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) {
-    const w = win;
-    const ctx = w.CanvasRenderingContext2D?.prototype;
-    const canvas = w.HTMLCanvasElement?.prototype;
-    return !!ctx && !!canvas && "drawElementImage" in ctx && "requestPaint" in canvas;
+    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.d.ts

@@ -109,7 +109,8 @@ export declare function syncRuntimeMedia(params: {
      * outbound message; further invocations are suppressed by the caller.
      */
     onAutoplayBlocked?: () => void;
-    onElementVolume?: (el: HTMLMediaElement, effectiveVolume: number, authorVolume: number) => void;
+    /** `clipGain` is `data-volume` for a routed clip, played ahead of its FX; 1 otherwise. */
+    onElementVolume?: (el: HTMLMediaElement, effectiveVolume: number, authorVolume: number, clipGain: number) => void;
     /** Is THIS element owned by the Web Audio transport? Owned → mute it (transport
      *  plays it); not owned → leave audible (HTMLMedia fallback). Per-element, not a
      *  global flag, so a not-yet-claimed track isn't muted by other tracks. */

package/dist/runtime/media.js

@@ -6,7 +6,7 @@ import { elementVolumeLaneGain } from "./audioAutomationVolume.js";
 import { fadeGain, NO_FADES, readElementFades } from "../audioFade.js";
 import { readElementPlaybackRate, readElementRateSpec, readMediaStart } from "./playbackRate.js";
 import { rateAt, sourceTimeAt, timeAtSourceTime } from "../speedRamp.js";
-import { clampAudioGain } from "../audioGain.js";
+import { clampAudioGain, clipGain, gainTimesLane } from "../audioGain.js";
 import { isMemberGroupHidden } from "../audioGroups.js";
 import { findInjectedRenderFrame } from "./renderFrameSibling.js";
 import { registerSeekCompletion } from "./adapters/seek-dispatch.js";
@@ -312,7 +312,7 @@ export function syncRuntimeMedia(params) {
             const previousRuntimeVolume = lastRuntimeAppliedVolume.get(el);
             const currentElementVolume = clampVolume(el.volume);
             let authorVolume;
-            // An explicit volume lane owns the fader. It is checked before the probed
+            // An explicit volume lane, times `data-volume`, sets the level. Checked before the probed
             // keyframes because the two would otherwise fight, and it is the one the
             // author drew — `lint` warns when a track carries both.
             // Clip-local, NOT `relTime`. A lane's `t` is "seconds from the start of
@@ -324,8 +324,11 @@ export function syncRuntimeMedia(params) {
             // trimmed clip. The FX lanes on this same feature use clip-local elapsed;
             // there is one time base, and this is it.
             const laneGain = elementVolumeLaneGain(el, params.timeSeconds - origin);
+            const routed = params.isWebAudioRouted?.(el) === true;
+            const tweened = laneGain === null && (clip.volumeKeyframes?.length ?? 0) > 0;
+            const preFxGain = routed ? clipGain(fallbackAuthorVolume, tweened) : 1;
             if (laneGain !== null) {
-                authorVolume = clampAudioGain(laneGain);
+                authorVolume = routed ? 1 : gainTimesLane(fallbackAuthorVolume, laneGain);
             }
             else if (clip.volumeKeyframes && clip.volumeKeyframes.length > 0) {
                 // Keyframes probed from the GSAP timeline — same source as the renderer.
@@ -338,8 +341,8 @@ export function syncRuntimeMedia(params) {
                 const elapsedInClip = params.timeSeconds - origin;
                 authorVolume = clampAudioGain(interpolateVolumeGain(clip.volumeKeyframes, elapsedInClip));
             }
-            else if (params.isWebAudioRouted?.(el)) {
-                authorVolume = fallbackAuthorVolume;
+            else if (routed) {
+                authorVolume = 1;
             }
             else if (previousRuntimeVolume === undefined) {
                 // First tick this clip is active. The transport has already seeked GSAP
@@ -387,7 +390,7 @@ export function syncRuntimeMedia(params) {
             if (Math.abs(el.volume - effectiveVolume) > 1e-6)
                 el.volume = effectiveVolume;
             lastRuntimeAppliedVolume.set(el, effectiveVolume);
-            params.onElementVolume?.(el, effectiveVolume, authorVolume);
+            params.onElementVolume?.(el, effectiveVolume, authorVolume, preFxGain);
             // Mute only when force-muted or the transport owns this element; an unclaimed
             // track stays audible via the HTMLMedia fallback.
             if ((forceMuteAll || params.isWebAudioOwned?.(el)) && !el.muted)

package/dist/runtime/renderFrameSibling.d.ts

@@ -17,7 +17,7 @@
  */
 /**
  * The render id an element is addressed by: its stamped, document-unique id
- * when the producer compiled this document, else its author id. The two are
+ * when the compiler stamped this document, else its author id. The two are
  * the same string whenever no collision forced a suffix.
  */
 export declare function readMediaRenderId(media: Element): string | null;

package/dist/runtime/renderFrameSibling.js

@@ -19,7 +19,7 @@ import { MEDIA_RENDER_ID_ATTR } from "../compiler/mediaRenderIds.js";
 import { isImageElement } from "./domRealm.js";
 /**
  * The render id an element is addressed by: its stamped, document-unique id
- * when the producer compiled this document, else its author id. The two are
+ * when the compiler stamped this document, else its author id. The two are
  * the same string whenever no collision forced a suffix.
  */
 export function readMediaRenderId(media) {

package/package.json

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