@hyperframes/inspector 0.8.185 → 0.8.188

package/dist/types/core/src/audibleVideo.d.ts

@@ -0,0 +1,14 @@
+export declare const AUDIBLE_VIDEO_QUALIFIER = ":not([muted]):is(:not([data-has-audio]),[data-has-audio=\"true\"])";
+export declare const AUDIBLE_MEDIA_SELECTOR = "audio[data-start], video[data-start]:not([muted]):is(:not([data-has-audio]),[data-has-audio=\"true\"])";
+export declare function isAudibleVideoElement(el: {
+    tagName: string;
+    hasAttribute(name: string): boolean;
+    getAttribute(name: string): string | null;
+}): boolean;
+export declare function audibleVideoNeedsWebAudio(fields: {
+    volume?: number | null;
+    fxChain?: string | null;
+    automation?: string | null;
+    audioGroup?: string | null;
+    masterChain?: string | null;
+}): boolean;

package/dist/types/core/src/audioAutomation.d.ts

@@ -120,6 +120,12 @@ export interface AutomationRange {
  * disables the fader while a lane owns it, so there was no way back.
  */
 export declare const VOLUME_RANGE: AutomationRange;
+/** Bounded sampling for volume curves drawn as straight pieces by the PCM baker. */
+export declare function volumeSegmentSampleCount(duration: number): number;
+/** Whether the segment leaving `point` bends: by `curve`, or through a `viaX`/`viaY` point. */
+export declare function isBentSegment(point: Pick<HfAutomationPoint, "curve" | "viaX" | "viaY">): boolean;
+export declare function gainedVolume(v: number, gain: number, gainAhead?: boolean): number;
+export declare function gainedVolumePoints(lane: HfAutomationLane, gain: number, gainAhead?: boolean): HfAutomationPoint[];
 export declare const RATE_RANGE: AutomationRange;
 /**
  * Resolve a lane's target against a chain. Returns null when the target names

package/dist/types/core/src/audioGain.d.ts

@@ -15,6 +15,10 @@ export declare const MAX_AUDIO_GAIN: number;
 export declare const AUDIO_GAIN_FADER_MIN = -100;
 export declare const AUDIO_GAIN_FADER_MAX = 100;
 export declare function clampAudioGain(value: number): number;
+/** `data-volume` is a gain on the volume lane, as clip gain offsets the keyframes in an NLE. */
+export declare function gainTimesLane(gain: number, lane: number): number;
+/** `data-volume` as clip gain, ahead of the FX chain; unity when a GSAP tween's absolute values own the level. */
+export declare function clipGain(volume: number, tweened: boolean): number;
 export declare function clampNativeMediaVolume(value: number): number;
 /**
  * Serialize an authored gain for `data-volume`.

package/dist/types/core/src/compiler/mediaRenderIds.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Document-unique identity for media elements in a compiled render document.
+ *
+ * Element `id`s are only unique within one composition FILE. The render
+ * document is the inlined union of every file, so ids collide there in two
+ * ways an author cannot avoid:
+ *
+ * 1. Two scenes each declare `<video id="clip">` — legal per file, duplicated
+ *    once inlined.
+ * 2. Two scenes each declare a bare `<video>` — the timing compiler numbers
+ *    auto-ids per file, so both become `hf-video-0`.
+ *
+ * The render pipeline keys media on that id (extract, inject, visibility,
+ * bounds), so a collision collapses N elements into one entry and every
+ * lookup resolves to whichever element happens to come first in the document.
+ * The surviving clip's frames land on the wrong element and the visible scene
+ * paints without footage.
+ *
+ * This module is the single owner of the fix: after inlining, every media
+ * element gets a document-unique `data-hf-render-id`. It equals the element's
+ * own id whenever that id is already unique, so uncolliding documents keep
+ * byte-identical pipeline keys and log output. Author-visible `id` attributes
+ * are never rewritten — 158 of the 161 registry blocks reference their own ids
+ * from `#id` CSS or `getElementById`, so renaming would break scene styling to
+ * fix scene footage.
+ */
+export declare const MEDIA_RENDER_ID_ATTR = "data-hf-render-id";
+/**
+ * The bus a member belongs to, as a DOCUMENT-unique key.
+ *
+ * `data-audio-group` names a bus by author id, unique only per composition FILE
+ * — so a sub-composition that declares a bus AND its members, used twice, put
+ * both instances' members under one key and let the second bus element
+ * overwrite the first. The mixer then sub-mixed two independent buses as one,
+ * applied instance B's fader, chain and label to instance A's audio, and — with
+ * only B muted — dropped BOTH instances from the export. This attribute is that
+ * collision resolved at the same boundary the media ids are.
+ */
+export declare const AUDIO_GROUP_RENDER_ID_ATTR = "data-hf-group-render-id";
+interface MediaElementLike {
+    readonly tagName?: string;
+    getAttribute(name: string): string | null;
+    setAttribute(name: string, value: string): void;
+}
+interface DocumentLike {
+    querySelectorAll(selector: string): Iterable<MediaElementLike>;
+}
+/**
+ * Stamp `data-hf-render-id` on every media element in a compiled document.
+ *
+ * Preserve unique existing stamps on recompilation. Repair stamps that collide
+ * after independently compiled scenes are merged.
+ */
+export declare function assignMediaRenderIds(document: DocumentLike): void;
+export {};

package/dist/types/core/src/htmlInCanvas.d.ts

@@ -0,0 +1,8 @@
+/** Chrome <=155 marks a capture canvas with `layoutsubtree`; 157+ with `content="drawable"` and `drawable` on each captured child. */
+export type HtmlInCanvasForm = "layoutsubtree" | "drawable";
+export declare const CAPTURE_CANVAS_SELECTOR = "canvas[layoutsubtree], canvas[content=\"drawable\"]";
+/** The form this browser's html-in-canvas takes, or null when it has no usable one. */
+export declare function htmlInCanvasForm(win?: Window): HtmlInCanvasForm | null;
+export declare function markCaptureCanvas(canvas: HTMLCanvasElement, form: HtmlInCanvasForm): void;
+export declare function markCaptured(el: Element, form: HtmlInCanvasForm): void;
+export declare function unmarkCaptured(el: Element, form: HtmlInCanvasForm): void;

package/dist/types/core/src/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/types/core/src/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/inspector",
-  "version": "0.8.185",
+  "version": "0.8.188",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -43,8 +43,8 @@
     "htmlparser2": "^10.1.0",
     "postcss": "^8.5.8",
     "puppeteer-core": "^25.8.0",
-    "@hyperframes/core": "0.8.185",
-    "@hyperframes/parsers": "0.8.185"
+    "@hyperframes/core": "0.8.188",
+    "@hyperframes/parsers": "0.8.188"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",