@hyperframes/core 0.8.186 → 0.8.189

package/dist/index.d.ts

@@ -32,7 +32,7 @@ export { clearGifFramesBeforeNext, gifClearsAfterLeavingFrameInPlace, parseAnima
 export { HF_COLOR_GRADING_ATTR, HF_COLOR_GRADING_ADJUST_KEYS, HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS, HF_COLOR_GRADING_ANIMATABLE_PROPERTIES, HF_COLOR_GRADING_CANVAS_ID_PREFIX, HF_COLOR_GRADING_COLOR_SPACE, HF_COLOR_GRADING_CURVE_KEYS, HF_COLOR_GRADING_DETAIL_KEYS, HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS, HF_COLOR_GRADING_EFFECT_KEYS, HF_COLOR_GRADING_EFFECT_PRESETS, HF_COLOR_GRADING_GRADE_PRESETS, HF_COLOR_GRADING_HUE_CURVE_KEYS, HF_COLOR_GRADING_LUT_KEYS, HF_COLOR_GRADING_PALETTES, HF_COLOR_GRADING_PRESETS, HF_COLOR_GRADING_TOP_LEVEL_KEYS, HF_COLOR_GRADING_WHEEL_KEYS, getHfColorGradingCapabilities, hasHfColorGradingAuthoredValues, isHfColorGradingActive, normalizeHfColorGrading, normalizeHfColorGradingWithVariables, resolveHfColorGradingVariables, serializeHfColorGrading, type HfColorGrading, type HfColorGradingAdjust, type HfColorGradingAdjustKey, type HfColorGradingAnimatablePath, type HfColorGradingActiveEffectKey, type HfColorGradingDetailKey, type HfColorGradingDetails, type HfColorGradingEffectKey, type HfColorGradingEffects, type HfColorGradingLutRef, type HfColorGradingPreset, type HfColorGradingPresetId, type HfColorGradingTarget, type HfColorGradingVariableMap, type HfColorGradingCapabilities, type HfColorGradingCurveKey, type HfColorGradingCurves, type HfColorGradingHueCurveKey, type HfColorGradingHueCurves, type HfColorGradingHueRange, type HfColorGradingSecondary, type HfColorGradingSecondaryCorrection, type HfColorGradingSoftRange, type HfColorGradingTonalWheel, type HfColorGradingWheelKey, type HfColorGradingWheels, type HfColorCurvePoint, type HfHueCurvePoint, type NormalizedHfColorGrading, type NormalizedHfColorGradingCurves, type NormalizedHfColorGradingHueCurves, type NormalizedHfColorGradingSecondary, type NormalizedHfColorGradingWheels, type ResolvedHfColorGrading, } from "./colorGrading.js";
 export { parseCubeLut, CubeLutParseError, type ParseCubeLutOptions } from "./colorLuts.js";
 export { firstFrameColourArgs, hdrToSdrToneMapFilter, parseFirstFrameColour, type ToneMapSourceColour, } from "./hdrToneMap.js";
-export { PREVIEW_PROXY_BOX_PARAM, formatPreviewProxyBox, parsePreviewProxyBox, type PreviewProxyBox, } from "./previewProxyBox.js";
+export { PREVIEW_PROXY_BOX_PARAM, formatPreviewProxyBox, parsePreviewProxyBox, quantizePreviewProxyBox, type PreviewProxyBox, } from "./previewProxyBox.js";
 export { HYPERFRAME_RUNTIME_ARTIFACTS, HYPERFRAME_RUNTIME_CONTRACT, loadHyperframeRuntimeSource, type HyperframeRuntimeContract, } from "./inline-scripts/hyperframe.js";
 export { HYPERFRAME_RUNTIME_GLOBALS, HYPERFRAME_BRIDGE_SOURCES, HYPERFRAME_CONTROL_ACTIONS, type HyperframeControlAction, } from "./inline-scripts/runtimeContract.js";
 export { getHyperframeRuntimeScript } from "./generated/runtime-inline.js";

package/dist/index.js

@@ -28,7 +28,7 @@ export { clearGifFramesBeforeNext, gifClearsAfterLeavingFrameInPlace, parseAnima
 export { HF_COLOR_GRADING_ATTR, HF_COLOR_GRADING_ADJUST_KEYS, HF_COLOR_GRADING_ACTIVE_EFFECT_KEYS, HF_COLOR_GRADING_ANIMATABLE_PROPERTIES, HF_COLOR_GRADING_CANVAS_ID_PREFIX, HF_COLOR_GRADING_COLOR_SPACE, HF_COLOR_GRADING_CURVE_KEYS, HF_COLOR_GRADING_DETAIL_KEYS, HF_COLOR_GRADING_EFFECT_APPLY_DEFAULTS, HF_COLOR_GRADING_EFFECT_KEYS, HF_COLOR_GRADING_EFFECT_PRESETS, HF_COLOR_GRADING_GRADE_PRESETS, HF_COLOR_GRADING_HUE_CURVE_KEYS, HF_COLOR_GRADING_LUT_KEYS, HF_COLOR_GRADING_PALETTES, HF_COLOR_GRADING_PRESETS, HF_COLOR_GRADING_TOP_LEVEL_KEYS, HF_COLOR_GRADING_WHEEL_KEYS, getHfColorGradingCapabilities, hasHfColorGradingAuthoredValues, isHfColorGradingActive, normalizeHfColorGrading, normalizeHfColorGradingWithVariables, resolveHfColorGradingVariables, serializeHfColorGrading, } from "./colorGrading.js";
 export { parseCubeLut, CubeLutParseError } from "./colorLuts.js";
 export { firstFrameColourArgs, hdrToSdrToneMapFilter, parseFirstFrameColour, } from "./hdrToneMap.js";
-export { PREVIEW_PROXY_BOX_PARAM, formatPreviewProxyBox, parsePreviewProxyBox, } from "./previewProxyBox.js";
+export { PREVIEW_PROXY_BOX_PARAM, formatPreviewProxyBox, parsePreviewProxyBox, quantizePreviewProxyBox, } from "./previewProxyBox.js";
 // Inline scripts
 export { HYPERFRAME_RUNTIME_ARTIFACTS, HYPERFRAME_RUNTIME_CONTRACT, loadHyperframeRuntimeSource, } from "./inline-scripts/hyperframe.js";
 export { HYPERFRAME_RUNTIME_GLOBALS, HYPERFRAME_BRIDGE_SOURCES, HYPERFRAME_CONTROL_ACTIONS, } from "./inline-scripts/runtimeContract.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/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,9 +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) {
-                const transportOwnsLane = params.isWebAudioRouted?.(el);
-                authorVolume = transportOwnsLane ? 1 : 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.
@@ -339,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
@@ -388,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.186",
+  "version": "0.8.189",
   "description": "",
   "repository": {
     "type": "git",
@@ -385,9 +385,9 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "wawoff2": "^2.0.1",
-    "@hyperframes/lint": "0.8.186",
-    "@hyperframes/studio-server": "0.8.186",
-    "@hyperframes/parsers": "0.8.186"
+    "@hyperframes/lint": "0.8.189",
+    "@hyperframes/parsers": "0.8.189",
+    "@hyperframes/studio-server": "0.8.189"
   },
   "devDependencies": {
     "@fontsource/archivo-black": "^5.2.8",