framefields 2.9.3 → 2.11.0

package/dist/{index-w28KUM9A.d.mts → index-D2i9J9Zq.d.mts}

@@ -1,5 +1,5 @@
-import { ur as VirtualMediaData } from "./index-9_4X2ro1.mjs";
-import { n as NodeRendererPlugin } from "./renderer-DoPEPlbG.mjs";
+import { ur as VirtualMediaData } from "./index-COYNQ_mf.mjs";
+import { n as NodeRendererPlugin } from "./renderer-BVKOQarx.mjs";
 
 //#region ../compositions/dist/index.d.mts
 
@@ -120,4 +120,4 @@ interface EncodeWavOptions {
 declare function encodeStereoWav(channels: [Float32Array, Float32Array], options?: EncodeWavOptions): Buffer;
 //#endregion
 export { SfxTrigger as a, softLimit as c, _default$2 as d, _default$3 as f, mixAudioTracks as g, _default$6 as h, SfxRenderContext as i, _default as l, _default$5 as m, encodeStereoWav as n, mixSfxInto as o, _default$4 as p, RenderedSfx as r, renderSfx as s, EncodeWavOptions as t, _default$1 as u };
-//# sourceMappingURL=index-w28KUM9A.d.mts.map
+//# sourceMappingURL=index-D2i9J9Zq.d.mts.map

package/dist/{index-w28KUM9A.d.mts.map → index-D2i9J9Zq.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"index-w28KUM9A.d.mts","names":["a","isStaticVisualMedia","c","RenderParams","i","calculateLayerTransform","l","computeRenderParams","n","framesToSeconds","o","resolveLayerDuration","r","secondsToFrames","s","CropRegion","t","formatTimecode","VirtualMediaData","GPUCommandEncoder","GPUTexture","GPUTextureView","NodeRenderProps","RenderContextValue","drawCompositionTree","Promise","CompositionStateStore","compositionStateStore","SceneProps","AudioClip","decodeAudioSource","Float32Array","AudioMixProgress","MixAudioOptions","mixAudioTracks","GPUDevice","preflightMediaTime","NormalizationContext","normalizeTimeline","_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default","_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default","_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default","_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default","_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default","_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default","_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default"],"sources":["../../compositions/dist/index.d.mts","../../../nodes/node-audio-compressor/dist/renderer.d.mts","../../../nodes/node-audio-delay/dist/renderer.d.mts","../../../nodes/node-audio-fade/dist/renderer.d.mts","../../../nodes/node-audio-noise-gate/dist/renderer.d.mts","../../../nodes/node-audio-parametric-eq/dist/renderer.d.mts","../../../nodes/node-audio-reverb/dist/renderer.d.mts","../../../nodes/node-stereo-panning/dist/renderer.d.mts","../src/audio/synth/sfx.ts","../src/audio/synth/wav-encoder.ts"],"sourcesContent":["import { a as isStaticVisualMedia, c as RenderParams, i as calculateLayerTransform, l as computeRenderParams, n as framesToSeconds, o as resolveLayerDuration, r as secondsToFrames, s as CropRegion, t as formatTimecode } from \"./timing-CluwdKGr.mjs\";\nimport { VirtualMediaData } from \"@framefields/core\";\nimport { GPUCommandEncoder, GPUTexture, GPUTextureView, NodeRenderProps } from \"@framefields/node-sdk\";\nimport { RenderContextValue } from \"@framefields/webgpu-renderers\";\n\n//#region src/compositions/canvas-composition.d.ts\ndeclare function drawCompositionTree(ctx: RenderContextValue, encoder: GPUCommandEncoder, targetView: GPUTextureView, targetTexture: GPUTexture, targetWidth: number, targetHeight: number, virtualMedia: VirtualMediaData, props: NodeRenderProps, inheritedSeekOffset?: number, inheritedClockOffset?: number): Promise<void>;\n//#endregion\n//#region src/compositions/composition-state.d.ts\ndeclare class CompositionStateStore {\n  private states;\n  private listeners;\n  setState(key: string, frame: number, fps: number, isPlaying?: boolean): void;\n  getState(key: string): {\n    frame: number;\n    fps: number;\n    isPlaying: boolean;\n  };\n  subscribe(key: string, listener: () => void): () => void;\n  clearKey(key: string): void;\n  private notify;\n}\ndeclare const compositionStateStore: CompositionStateStore;\ninterface SceneProps {\n  viewportWidth: number;\n  viewportHeight: number;\n  containerWidth?: number;\n  containerHeight?: number;\n  virtualMedia?: VirtualMediaData;\n  backgroundColor?: string;\n  type?: \"Video\" | \"Audio\" | \"Image\";\n  volume?: number;\n  renderId?: string;\n  frame?: number;\n  fps?: number;\n  [key: string]: unknown;\n}\n//#endregion\n//#region src/utils/audio-extractor.d.ts\ninterface AudioClip {\n  sourceUrl: string;\n  destStartFrame: number;\n  trimStartSec: number;\n  durationFrames: number;\n  speed: number;\n  volume: number;\n}\n/**\n * Decodes all audio samples from a given source URL into raw Float32 mono/stereo channel buffers.\n */\ndeclare function decodeAudioSource(url: string): Promise<{\n  channels: Float32Array[];\n  sampleRate: number;\n} | null>;\n/** Progress reported by `mixAudioTracks` as each audio or video clip is mixed. */\ninterface AudioMixProgress {\n  /** Clips mixed so far. */\n  done: number;\n  /** Audio and video clips in the tree; muted or empty ones may be skipped. */\n  total: number;\n  /** File name of the clip just mixed (no directory or query string). */\n  source?: string;\n}\ninterface MixAudioOptions {\n  onProgress?: (progress: AudioMixProgress) => void;\n}\n/**\n * Recursively parses the VirtualMediaData tree and mixes all active audio tracks\n * into a single unified stereo PCM stream (Float32Array channels).\n */\ndeclare function mixAudioTracks(virtualMedia: VirtualMediaData, fps: number, targetSampleRate?: number, device?: GPUDevice, renderId?: string, options?: MixAudioOptions): Promise<{\n  channels: Float32Array[];\n  sampleRate: number;\n}>;\n//#endregion\n//#region src/utils/media-time-preflight.d.ts\n/** Verify mapped source intervals before decoding or mixing. */\ndeclare function preflightMediaTime(root: VirtualMediaData, fps: number): Promise<void>;\n//#endregion\n//#region src/utils/normalization.d.ts\n/**\n * NormalizationContext carries the accumulated offsets and limits\n * as we traverse down the virtual media tree.\n */\ninterface NormalizationContext {\n  timeOffsetSec: number;\n  durationLimitMs?: number;\n}\n/**\n * normalizeTimeline recurses through the virtual media tree and \"absorbs\"\n * generic timeline-shifting operations into standard properties\n * of their children.\n */\ndeclare function normalizeTimeline(vv: VirtualMediaData, fps: number, context?: NormalizationContext): VirtualMediaData;\n//#endregion\nexport { AudioClip, AudioMixProgress, CropRegion, MixAudioOptions, RenderParams, SceneProps, calculateLayerTransform, compositionStateStore, computeRenderParams, decodeAudioSource, drawCompositionTree, formatTimecode, framesToSeconds, isStaticVisualMedia, mixAudioTracks, normalizeTimeline, preflightMediaTime, resolveLayerDuration, secondsToFrames };\n//# sourceMappingURL=index.d.mts.map","import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map","import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map","import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map","import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map","import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map","import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map","import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map"],"mappings":";;;;;AQ6PA;URtMUgC,gBAAAA;;;ESlDV;EAOA,KAAgB,EAAA,MAAA;EACJ;EAAc,MAAA,CAAA,EAAA,MAAA;;UTkDhBC,eAAAA,CShDP;EAAM,UAAA,CAAA,EAAA,CAAA,QAAA,ETiDiBD,gBSjDjB,EAAA,GAAA,IAAA;;;;;;iBTuDQE,cAAAA,eAA6BhB,mEAAmEiB,wCAAwCF,kBAAkBR;YAC/JM;;;;;;;;;cCpEES,YAAUE,SAASH;AD+CuB;;;;cE/C1CM,YAAUE,SAASH;AF+CuB;;;;cG/C1CM,YAAUE,SAASH;AH+CuB;;;;cI/C1CM,YAAUE,SAASH;AJ+CuB;;;;cK/C1CM,YAAUE,SAASH;AL+CuB;;;;cM/C1CM,YAAUE,SAASH;AN+CuB;;;;cO/C1CM,UAAUE,SAASH;AP+CuB;;;;;;;;AAAA;AAK9B;AASgB;;;AAM+GpC,UQ5DxI,UAAA,CR4DwIA;EAC7IF,IAAAA,EAAAA,QAAAA,GAAAA,OAAAA,GAAAA,QAAAA,GAAAA,aAAAA,GAAAA,QAAAA;EAD+JN;EAAO,KAAA,EAAA,MAAA;;;;ACnEpKe,KOeF,YAAA,GPfwE,COexD,YPfKD,EOeS,YPflBG,CAAAA;UOiBP,WAAA;;;ENjBHG,QAAAA,EMoBH,YNpByE;;UMuBnE,gBAAA;;ELvBHK,aAAsE,EAAA,MAAA;;;;ACHF;;;;ACAA;iBGyLlE,SAAA,UACN,iBACJ,mBACH;;iBAwCa,UAAA,SACP,gCACU;AFtO+D;;;;ACGpEoB,iBC0PE,SAAA,CD1PiBD,MAAAA,EC2PxB,YD3PeG,EAAAA,IAAQ,CAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;;;;;;;APoDtBxC,USlDO,gBAAA,CTkDS;EAQhBC,UAAAA,CAAAA,EAAAA,MAAe;AACiB;;;;AAO9BF,iBS3DI,eAAA,CT2DJA,QAAAA,EAAAA,CS1DA,YT0DAA,ES1Dc,YT0DdA,CAAAA,EAAAA,OAAAA,CAAAA,ESzDF,gBTyDEA,CAAAA,ESxDT,MTwDSA"}
+{"version":3,"file":"index-D2i9J9Zq.d.mts","names":["a","isStaticVisualMedia","c","RenderParams","i","calculateLayerTransform","l","computeRenderParams","n","framesToSeconds","o","resolveLayerDuration","r","secondsToFrames","s","CropRegion","t","formatTimecode","VirtualMediaData","GPUCommandEncoder","GPUTexture","GPUTextureView","NodeRenderProps","RenderContextValue","drawCompositionTree","Promise","CompositionStateStore","compositionStateStore","SceneProps","AudioClip","decodeAudioSource","Float32Array","AudioMixProgress","MixAudioOptions","mixAudioTracks","GPUDevice","preflightMediaTime","NormalizationContext","normalizeTimeline","_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default","_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default","_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default","_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default","_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default","_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default","_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default"],"sources":["../../compositions/dist/index.d.mts","../../../nodes/node-audio-compressor/dist/renderer.d.mts","../../../nodes/node-audio-delay/dist/renderer.d.mts","../../../nodes/node-audio-fade/dist/renderer.d.mts","../../../nodes/node-audio-noise-gate/dist/renderer.d.mts","../../../nodes/node-audio-parametric-eq/dist/renderer.d.mts","../../../nodes/node-audio-reverb/dist/renderer.d.mts","../../../nodes/node-stereo-panning/dist/renderer.d.mts","../src/audio/synth/sfx.ts","../src/audio/synth/wav-encoder.ts"],"sourcesContent":["import { a as isStaticVisualMedia, c as RenderParams, i as calculateLayerTransform, l as computeRenderParams, n as framesToSeconds, o as resolveLayerDuration, r as secondsToFrames, s as CropRegion, t as formatTimecode } from \"./timing-CluwdKGr.mjs\";\nimport { VirtualMediaData } from \"@framefields/core\";\nimport { GPUCommandEncoder, GPUTexture, GPUTextureView, NodeRenderProps } from \"@framefields/node-sdk\";\nimport { RenderContextValue } from \"@framefields/webgpu-renderers\";\n\n//#region src/compositions/canvas-composition.d.ts\ndeclare function drawCompositionTree(ctx: RenderContextValue, encoder: GPUCommandEncoder, targetView: GPUTextureView, targetTexture: GPUTexture, targetWidth: number, targetHeight: number, virtualMedia: VirtualMediaData, props: NodeRenderProps, inheritedSeekOffset?: number, inheritedClockOffset?: number): Promise<void>;\n//#endregion\n//#region src/compositions/composition-state.d.ts\ndeclare class CompositionStateStore {\n  private states;\n  private listeners;\n  setState(key: string, frame: number, fps: number, isPlaying?: boolean): void;\n  getState(key: string): {\n    frame: number;\n    fps: number;\n    isPlaying: boolean;\n  };\n  subscribe(key: string, listener: () => void): () => void;\n  clearKey(key: string): void;\n  private notify;\n}\ndeclare const compositionStateStore: CompositionStateStore;\ninterface SceneProps {\n  viewportWidth: number;\n  viewportHeight: number;\n  containerWidth?: number;\n  containerHeight?: number;\n  virtualMedia?: VirtualMediaData;\n  backgroundColor?: string;\n  type?: \"Video\" | \"Audio\" | \"Image\";\n  volume?: number;\n  renderId?: string;\n  frame?: number;\n  fps?: number;\n  [key: string]: unknown;\n}\n//#endregion\n//#region src/utils/audio-extractor.d.ts\ninterface AudioClip {\n  sourceUrl: string;\n  destStartFrame: number;\n  trimStartSec: number;\n  durationFrames: number;\n  speed: number;\n  volume: number;\n}\n/**\n * Decodes all audio samples from a given source URL into raw Float32 mono/stereo channel buffers.\n */\ndeclare function decodeAudioSource(url: string): Promise<{\n  channels: Float32Array[];\n  sampleRate: number;\n} | null>;\n/** Progress reported by `mixAudioTracks` as each audio or video clip is mixed. */\ninterface AudioMixProgress {\n  /** Clips mixed so far. */\n  done: number;\n  /** Audio and video clips in the tree; muted or empty ones may be skipped. */\n  total: number;\n  /** File name of the clip just mixed (no directory or query string). */\n  source?: string;\n}\ninterface MixAudioOptions {\n  onProgress?: (progress: AudioMixProgress) => void;\n}\n/**\n * Recursively parses the VirtualMediaData tree and mixes all active audio tracks\n * into a single unified stereo PCM stream (Float32Array channels).\n */\ndeclare function mixAudioTracks(virtualMedia: VirtualMediaData, fps: number, targetSampleRate?: number, device?: GPUDevice, renderId?: string, options?: MixAudioOptions): Promise<{\n  channels: Float32Array[];\n  sampleRate: number;\n}>;\n//#endregion\n//#region src/utils/media-time-preflight.d.ts\n/** Verify mapped source intervals before decoding or mixing. */\ndeclare function preflightMediaTime(root: VirtualMediaData, fps: number): Promise<void>;\n//#endregion\n//#region src/utils/normalization.d.ts\n/**\n * NormalizationContext carries the accumulated offsets and limits\n * as we traverse down the virtual media tree.\n */\ninterface NormalizationContext {\n  timeOffsetSec: number;\n  durationLimitMs?: number;\n}\n/**\n * normalizeTimeline recurses through the virtual media tree and \"absorbs\"\n * generic timeline-shifting operations into standard properties\n * of their children.\n */\ndeclare function normalizeTimeline(vv: VirtualMediaData, fps: number, context?: NormalizationContext): VirtualMediaData;\n//#endregion\nexport { AudioClip, AudioMixProgress, CropRegion, MixAudioOptions, RenderParams, SceneProps, calculateLayerTransform, compositionStateStore, computeRenderParams, decodeAudioSource, drawCompositionTree, formatTimecode, framesToSeconds, isStaticVisualMedia, mixAudioTracks, normalizeTimeline, preflightMediaTime, resolveLayerDuration, secondsToFrames };\n//# sourceMappingURL=index.d.mts.map","import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map","import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map","import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map","import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map","import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map","import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map","import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map"],"mappings":";;;;;AQ6PA;URtMUgC,gBAAAA;;;ESlDV;EAOA,KAAgB,EAAA,MAAA;EACJ;EAAc,MAAA,CAAA,EAAA,MAAA;;UTkDhBC,eAAAA,CShDP;EAAM,UAAA,CAAA,EAAA,CAAA,QAAA,ETiDiBD,gBSjDjB,EAAA,GAAA,IAAA;;;;;;iBTuDQE,cAAAA,eAA6BhB,mEAAmEiB,wCAAwCF,kBAAkBR;YAC/JM;;;;;;;;;cCpEES,YAAUE,SAASH;AD+CuB;;;;cE/C1CM,YAAUE,SAASH;AF+CuB;;;;cG/C1CM,YAAUE,SAASH;AH+CuB;;;;cI/C1CM,YAAUE,SAASH;AJ+CuB;;;;cK/C1CM,YAAUE,SAASH;AL+CuB;;;;cM/C1CM,YAAUE,SAASH;AN+CuB;;;;cO/C1CM,UAAUE,SAASH;AP+CuB;;;;;;;;AAAA;AAK9B;AASgB;;;AAM+GpC,UQ5DxI,UAAA,CR4DwIA;EAC7IF,IAAAA,EAAAA,QAAAA,GAAAA,OAAAA,GAAAA,QAAAA,GAAAA,aAAAA,GAAAA,QAAAA;EAD+JN;EAAO,KAAA,EAAA,MAAA;;;;ACnEpKe,KOeF,YAAA,GPfwE,COexD,YPfKD,EOeS,YPflBG,CAAAA;UOiBP,WAAA;;;ENjBHG,QAAAA,EMoBH,YNpByE;;UMuBnE,gBAAA;;ELvBHK,aAAsE,EAAA,MAAA;;;;ACHF;;;;ACAA;iBGyLlE,SAAA,UACN,iBACJ,mBACH;;iBAwCa,UAAA,SACP,gCACU;AFtO+D;;;;ACGpEoB,iBC0PE,SAAA,CD1PiBD,MAAAA,EC2PxB,YD3PeG,EAAAA,IAAQ,CAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,MAAA,CAAA,EAAA,IAAA;;;;;;;APoDtBxC,USlDO,gBAAA,CTkDS;EAQhBC,UAAAA,CAAAA,EAAAA,MAAe;AACiB;;;;AAO9BF,iBS3DI,eAAA,CT2DJA,QAAAA,EAAAA,CS1DA,YT0DAA,ES1Dc,YT0DdA,CAAAA,EAAAA,OAAAA,CAAAA,ESzDF,gBTyDEA,CAAAA,ESxDT,MTwDSA"}

package/dist/{index-V0ZQ4JN6.d.mts → index-gOVtTm-P.d.mts}

@@ -1,10 +1,69 @@
-import { ur as VirtualMediaData } from "./index-9_4X2ro1.mjs";
+import { ur as VirtualMediaData } from "./index-COYNQ_mf.mjs";
 import { VideoSampleSource } from "mediabunny";
 import pino from "pino";
 import { VideoFrame } from "@napi-rs/webcodecs";
 
 //#region ../renderer/dist/index.d.mts
 
+//#endregion
+//#region src/chunk-plan.d.ts
+/**
+ * Plans a render split across workers: how many chunks, and where each one
+ * starts and ends. Pure arithmetic over measured frame costs, so it runs
+ * anywhere (a worker's probe job, a coordinator, a local script).
+ *
+ * Every chunk pays a fixed cost before its first frame (worker start, fetch,
+ * install, composition build). `workers: "auto"` adds workers only while each
+ * chunk still spends at least `efficiency` of its time rendering, so a short
+ * film stays on one worker and a long one spreads out until `maxWorkers`.
+ * Chunks are cut at equal render cost, not equal frame counts, so a heavy
+ * stretch (3D, vision) gets shorter chunks.
+ */
+/** A measured render time for one frame. */
+interface FrameCostSample {
+  frame: number;
+  ms: number;
+}
+interface ChunkPlanOptions {
+  /** Frames in the composition. */
+  totalFrames: number;
+  /** Measured frame times; between samples the cost is interpolated linearly. */
+  samples: readonly FrameCostSample[];
+  /** A worker count, or `"auto"` to pick one from the cost. Default 1. */
+  workers?: number | "auto";
+  /** Upper bound for `"auto"` (and for a number). Default 10. */
+  maxWorkers?: number;
+  /** Fixed cost each chunk pays before rendering, in seconds. Default 90 (a cold start). */
+  overheadSec?: number;
+  /**
+   * `"auto"` only: the smallest share of a chunk's time spent rendering,
+   * between 0 and 1. Default 0.85: each chunk renders at least
+   * `overheadSec × 0.85 / 0.15` (about 5.7× the overhead).
+   */
+  efficiency?: number;
+  /** No chunk is shorter than this many frames. Default 60. */
+  minChunkFrames?: number;
+}
+interface PlannedChunk {
+  /** First frame (inclusive). */
+  start: number;
+  /** Last frame (exclusive). */
+  end: number;
+  /** Estimated render time of its frames, in seconds. */
+  workSec: number;
+}
+interface ChunkPlan {
+  workers: number;
+  /** Estimated render time of the whole composition on one worker, without overhead. */
+  workSec: number;
+  /** Estimated wall time with this plan: overhead plus the longest chunk. */
+  etaSec: number;
+  chunks: PlannedChunk[];
+}
+declare function planChunks(options: ChunkPlanOptions): ChunkPlan;
+//#endregion
+//#region src/dma-staging-ring.d.ts
+
 //#endregion
 //#region src/render-reporter.d.ts
 /**
@@ -124,6 +183,11 @@ declare class RenderSemaphore {
   };
 }
 declare const renderSemaphore: RenderSemaphore;
+/** Composition frames `start` (inclusive) to `end` (exclusive). */
+interface FrameRange {
+  start: number;
+  end: number;
+}
 declare class HeadlessWebGPURenderer {
   private static isInitialized;
   private static initPromise;
@@ -150,6 +214,26 @@ declare class HeadlessWebGPURenderer {
     /** "rgba" returns raw width*height*4 pixels instead of a PNG. */
     format?: "png" | "rgba";
   }): Promise<Buffer>;
+  /**
+   * Measures what frames cost to render across the timeline, for planning a
+   * split render (`planChunks`). At `samples` evenly spaced points (default
+   * 12) it renders three consecutive frames and times the last two, so
+   * effects that carry state (trails, particles) are caught up and their
+   * replay is not counted. Encoding is not included.
+   */
+  probeRender(source: VirtualMediaData | {
+    toVirtualMedia(): VirtualMediaData;
+  }, options?: {
+    samples?: number;
+    signal?: AbortSignal;
+    /** Called after each sample point with how many are done. */
+    onSample?: (done: number, total: number) => void;
+  }): Promise<{
+    totalFrames: number;
+    fps: number;
+    durationMs: number;
+    samples: FrameCostSample[];
+  }>;
   /**
    * Mixes the composition's full audio timeline (clips, effects, synthesized
    * tracks) to stereo PCM, exactly as `renderVideo` muxes it.
@@ -192,6 +276,19 @@ declare class HeadlessWebGPURenderer {
      * "mux", "convert" (GIF only) and "done".
      */
     onProgress?: (progress: RenderProgress) => void;
+    /**
+     * Renders only composition frames `start` (inclusive) to `end`
+     * (exclusive), as one chunk of a render split across workers. The
+     * chunk's timestamps start at 0 and its first frame is a keyframe,
+     * so `stitchChunks` joins chunks without re-encoding. Effects that
+     * carry state between frames rebuild it before `start`.
+     */
+    frames?: FrameRange;
+    /**
+     * `false` writes no audio track, as for chunks: the timeline's audio
+     * is exported once with `codec: "aac"` and added by `stitchChunks`.
+     */
+    audio?: boolean;
   }): Promise<{
     filePath: string;
     cleanup: () => Promise<void>;
@@ -216,6 +313,31 @@ declare function resetRenderCaches(): void;
  * people and agents reading a terminal). `FRAMEFIELDS_LOG_FORMAT` picks one;
  * otherwise production is JSON and everything else text.
  */
+
+//#endregion
+//#region src/stitch.d.ts
+interface StitchOptions {
+  /** Chunk files in timeline order, each a `renderVideo({ frames, audio: false })` output. */
+  chunks: readonly string[];
+  /**
+   * An audio-only render of the whole timeline (`renderVideo({ codec: "aac" })`,
+   * or `"opus"` for WebM chunks), copied in as the audio track.
+   */
+  audio?: string;
+  outputPath: string;
+  /** Stops between packets; the promise rejects and no file is left behind. */
+  signal?: AbortSignal;
+}
+interface StitchResult {
+  filePath: string;
+  /** Video frames written, across all chunks. */
+  frames: number;
+  /** End of the video track, in seconds. */
+  durationSec: number;
+}
+declare function stitchChunks(options: StitchOptions): Promise<StitchResult>;
+//#endregion
+//#region src/zero-copy-webcodecs-pipeline.d.ts
 //#endregion
 //#region src/renderer/framegrid.d.ts
 interface FrameSamplePoint {
@@ -358,5 +480,5 @@ type FrameGridRenderable = {
  */
 declare function renderFrameGrid(target: FrameGridRenderable, options?: FrameGridOptions): Promise<Buffer>;
 //#endregion
-export { renderSemaphore as _, renderFrameGrid as a, HeadlessMediaRenderer as c, QaSegment as d, RenderProgress as f, formatQaReport as g, VideoQaStats as h, computeGridLayout as i, HeadlessWebGPURenderer as l, VideoQaReport as m, FrameGridRenderable as n, resolveSamplePoints as o, VideoQaOptions as p, FrameSamplePoint as r, AudioQaStats as s, FrameGridOptions as t, QaIssue as u, resetRenderCaches as v };
-//# sourceMappingURL=index-V0ZQ4JN6.d.mts.map
+export { formatQaReport as C, stitchChunks as D, resetRenderCaches as E, VideoQaStats as S, renderSemaphore as T, RenderProgress as _, renderFrameGrid as a, VideoQaOptions as b, ChunkPlan as c, FrameRange as d, HeadlessMediaRenderer as f, QaSegment as g, QaIssue as h, computeGridLayout as i, ChunkPlanOptions as l, PlannedChunk as m, FrameGridRenderable as n, resolveSamplePoints as o, HeadlessWebGPURenderer as p, FrameSamplePoint as r, AudioQaStats as s, FrameGridOptions as t, FrameCostSample as u, StitchOptions as v, planChunks as w, VideoQaReport as x, StitchResult as y };
+//# sourceMappingURL=index-gOVtTm-P.d.mts.map

package/dist/index-gOVtTm-P.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-gOVtTm-P.d.mts","names":["pino","DestinationStream","VideoColorPrimaries","VideoFrame","VideoMatrixCoefficients","VideoTransferCharacteristics","RenderDiagnostic","VirtualMediaData","VideoSampleSource","preloadFonts","GPUDevice","Promise","FrameCostSample","ChunkPlanOptions","PlannedChunk","ChunkPlan","planChunks","StagingSlotStatus","VideoColorSpaceConfig","DmaStagingRingOptions","GPUTextureFormat","StagingSlotInfo","DmaStagingRing","GPUCommandEncoder","GPUTexture","Uint8Array","findNodesDir","discoverAndRegisterNodeRenderers","RenderPhase","RenderProgress","VideoQaOptions","QaSegment","QaIssue","VideoQaStats","AudioQaStats","VideoQaReport","FrameInspector","analyzeAudio","Float32Array","integratedLoudness","buildQaReport","formatQaReport","RenderSemaphore","renderSemaphore","FrameRange","HeadlessWebGPURenderer","Buffer","AbortSignal","HeadlessMediaRenderer","resetRenderCaches","resolveLogFormat","Record","textLogStream","rendererLogger","Logger","NODE_KINDS","NodeKind","NodeRendererExports","NodeManifest","NodeManifestError","Error","parseNodeManifest","loadNodeManifests","StitchOptions","StitchResult","stitchChunks","ZeroCopyWebCodecsPipelineOptions","WebCodecsPipelineStats","ZeroCopyWebCodecsPipeline"],"sources":["../../renderer/dist/index.d.mts","../src/renderer/framegrid.ts"],"sourcesContent":["import pino, { DestinationStream } from \"pino\";\nimport { VideoColorPrimaries, VideoFrame, VideoMatrixCoefficients, VideoTransferCharacteristics } from \"@napi-rs/webcodecs\";\nimport { RenderDiagnostic, VirtualMediaData } from \"@framefields/core\";\nimport { VideoSampleSource } from \"mediabunny\";\n\n//#region src/asset-preloader.d.ts\n\n/**\n * Preloads only the fonts (and emoji) a VirtualMediaData tree's text uses, so\n * typography renders correctly on Node.js without loading its media. Shared\n * with the browser preview; emoji need a font set with\n * `FontManager.registerEmojiFont()`.\n */\ndeclare function preloadFonts(media: VirtualMediaData, device?: GPUDevice | null): Promise<void>;\n//#endregion\n//#region src/chunk-plan.d.ts\n/**\n * Plans a render split across workers: how many chunks, and where each one\n * starts and ends. Pure arithmetic over measured frame costs, so it runs\n * anywhere (a worker's probe job, a coordinator, a local script).\n *\n * Every chunk pays a fixed cost before its first frame (worker start, fetch,\n * install, composition build). `workers: \"auto\"` adds workers only while each\n * chunk still spends at least `efficiency` of its time rendering, so a short\n * film stays on one worker and a long one spreads out until `maxWorkers`.\n * Chunks are cut at equal render cost, not equal frame counts, so a heavy\n * stretch (3D, vision) gets shorter chunks.\n */\n/** A measured render time for one frame. */\ninterface FrameCostSample {\n  frame: number;\n  ms: number;\n}\ninterface ChunkPlanOptions {\n  /** Frames in the composition. */\n  totalFrames: number;\n  /** Measured frame times; between samples the cost is interpolated linearly. */\n  samples: readonly FrameCostSample[];\n  /** A worker count, or `\"auto\"` to pick one from the cost. Default 1. */\n  workers?: number | \"auto\";\n  /** Upper bound for `\"auto\"` (and for a number). Default 10. */\n  maxWorkers?: number;\n  /** Fixed cost each chunk pays before rendering, in seconds. Default 90 (a cold start). */\n  overheadSec?: number;\n  /**\n   * `\"auto\"` only: the smallest share of a chunk's time spent rendering,\n   * between 0 and 1. Default 0.85: each chunk renders at least\n   * `overheadSec × 0.85 / 0.15` (about 5.7× the overhead).\n   */\n  efficiency?: number;\n  /** No chunk is shorter than this many frames. Default 60. */\n  minChunkFrames?: number;\n}\ninterface PlannedChunk {\n  /** First frame (inclusive). */\n  start: number;\n  /** Last frame (exclusive). */\n  end: number;\n  /** Estimated render time of its frames, in seconds. */\n  workSec: number;\n}\ninterface ChunkPlan {\n  workers: number;\n  /** Estimated render time of the whole composition on one worker, without overhead. */\n  workSec: number;\n  /** Estimated wall time with this plan: overhead plus the longest chunk. */\n  etaSec: number;\n  chunks: PlannedChunk[];\n}\ndeclare function planChunks(options: ChunkPlanOptions): ChunkPlan;\n//#endregion\n//#region src/dma-staging-ring.d.ts\ntype StagingSlotStatus = \"idle\" | \"rendering\" | \"mapping\" | \"mapped\";\ninterface VideoColorSpaceConfig {\n  readonly primaries?: VideoColorPrimaries;\n  readonly transfer?: VideoTransferCharacteristics;\n  readonly matrix?: VideoMatrixCoefficients;\n  readonly fullRange?: boolean;\n}\ninterface DmaStagingRingOptions {\n  readonly width: number;\n  readonly height: number;\n  readonly capacity?: number;\n  readonly format?: GPUTextureFormat;\n}\ninterface StagingSlotInfo {\n  readonly index: number;\n  readonly status: StagingSlotStatus;\n  readonly inFlightFrame: number | null;\n}\n/**\n * Pipelined Asynchronous DMA Staging Ring for WebGPU.\n *\n * Implements double-buffered (or N-buffered) GPU staging buffers to overlap\n * GPU render passes with asynchronous DMA host transfers and WebCodecs hardware encoding.\n * Eliminates GPU stalls by allowing Frame i+1 to execute on the GPU while Frame i\n * is asynchronously mapped and consumed by the hardware video encoder.\n */\ndeclare class DmaStagingRing {\n  readonly width: number;\n  readonly height: number;\n  readonly capacity: number;\n  readonly bytesPerRow: number;\n  readonly unpaddedBytesPerRow: number;\n  readonly bufferSize: number;\n  readonly format: GPUTextureFormat;\n  readonly device: GPUDevice;\n  private readonly slots;\n  private isDestroyed;\n  constructor(device: GPUDevice, options: DmaStagingRingOptions);\n  /**\n   * Prepares the staging buffer slot for writing by ensuring any prior mapping\n   * from a previous cycle has been completed and unmapped.\n   */\n  prepareSlot(frameIndex: number): Promise<void>;\n  /**\n   * Records a GPU-to-buffer DMA copy command into the provided command encoder.\n   */\n  stageTexture(encoder: GPUCommandEncoder, texture: GPUTexture, frameIndex: number): void;\n  /**\n   * Initiates asynchronous DMA mapping on the slot for the specified frame.\n   * Must be called immediately after submitting the command encoder to the device queue.\n   */\n  scheduleMap(frameIndex: number): Promise<void>;\n  /**\n   * Awaits asynchronous mapping and extracts pixels into a tightly packed Uint8Array.\n   * The slot remains in the \"mapped\" state until releaseFrame() is called.\n   */\n  readFramePixels(frameIndex: number): Promise<Uint8Array>;\n  /**\n   * Awaits asynchronous mapping, extracts pixels, and immediately unmaps the staging buffer,\n   * returning the slot to \"idle\" state so it can be reused immediately.\n   */\n  readAndReleaseFrame(frameIndex: number): Promise<Uint8Array>;\n  /**\n   * Directly reads the mapped staging buffer into a WebCodecs VideoFrame,\n   * bypassing redundant intermediate JS allocations when row pitches align,\n   * and immediately unmaps the buffer.\n   */\n  readFrameToVideoFrame(frameIndex: number, timestampUs: number, colorSpace?: VideoColorSpaceConfig, /** Sees the tightly packed RGBA pixels while they are mapped; must not keep them. */\n  inspect?: (rgba: Uint8Array) => void): Promise<VideoFrame>;\n  /**\n   * Unmaps the staging buffer for the specified frame and marks the slot idle.\n   */\n  releaseFrame(frameIndex: number): void;\n  /**\n   * Returns current status info for each slot in the ring.\n   */\n  getSlotInfos(): readonly StagingSlotInfo[];\n  /**\n   * Destroys all staging buffers and releases resources.\n   */\n  destroy(): void;\n  private checkDestroyed;\n}\n//#endregion\n//#region src/dynamic-node-discovery.d.ts\n/** Locates the workspace `nodes/` directory by climbing up from this file. */\ndeclare function findNodesDir(startDir?: string): string | null;\n/**\n * Registers the built-in node renderers, then any extra nodes found in the\n * directory named by `FRAMEFIELDS_NODES_DIR` (local node development). A node in\n * that directory overrides the built-in renderer for the same op.\n */\ndeclare function discoverAndRegisterNodeRenderers(): Promise<void>;\n//#endregion\n//#region src/render-reporter.d.ts\n/**\n * Stages of `renderVideo`, in order. Audio-only renders skip \"render\";\n * \"convert\" runs only for GIF output.\n */\ntype RenderPhase = \"prepare\" | \"render\" | \"audio\" | \"audio-encode\" | \"mux\" | \"convert\" | \"done\";\n/** Progress reported by `renderVideo({ onProgress })`. */\ninterface RenderProgress {\n  /**\n   * \"prepare\" loads fonts and warms the pipeline, \"render\" draws and encodes\n   * frames, \"audio\" mixes the soundtrack, \"audio-encode\" encodes it, \"mux\"\n   * writes the container, \"convert\" makes the GIF, \"done\" is the last event.\n   */\n  phase: RenderPhase;\n  /** Frames finished so far (1-based); `totalFrames` once frames are done. */\n  frame: number;\n  totalFrames: number;\n  /** Time since the render started. */\n  elapsedMs: number;\n  /** Share of the current phase done (0–1), when it can be measured. */\n  phaseProgress?: number;\n  /** Frames per second so far (\"render\" only). */\n  fps?: number;\n  /** Estimated seconds until the frames are done (\"render\" only). */\n  etaSec?: number;\n  /** What the phase is working on, e.g. \"3/7 sources: music.mp3\". */\n  detail?: string;\n}\n//#endregion\n//#region src/video-qa.d.ts\n/**\n * Quality checks run on a video while it renders: frames are measured as\n * they are read back for the encoder and audio as it is mixed, so the report\n * describes exactly what was encoded without decoding the file again.\n */\ninterface VideoQaOptions {\n  /** Luma (0-1) at or below which a pixel counts as black. Default 0.1. */\n  readonly blackPixelThreshold?: number;\n  /** Share of black pixels that makes a frame black. Default 0.98. */\n  readonly blackFrameRatio?: number;\n  /** Shortest run of black frames reported. Default 0.5 s. */\n  readonly minBlackSec?: number;\n  /** Shortest run of unchanging frames reported. Default 2 s. */\n  readonly minFrozenSec?: number;\n  /** Level (dBFS, 100 ms windows) below which audio counts as silent. Default -60. */\n  readonly silenceDbfs?: number;\n  /** Shortest silent stretch reported. Default 2 s. */\n  readonly minSilenceSec?: number;\n  /** Integrated loudness to hit, e.g. -14 for most streaming platforms. Unchecked when unset. */\n  readonly targetLufs?: number;\n  /** Allowed distance from `targetLufs`, in LU. Default 1. */\n  readonly lufsTolerance?: number;\n}\ninterface QaSegment {\n  readonly startSec: number;\n  readonly endSec: number;\n}\ninterface QaIssue {\n  readonly severity: \"error\" | \"warning\" | \"info\";\n  /** Stable machine-readable kind, e.g. \"black_frames\", \"audio_clipping\" */\n  readonly code: string;\n  readonly message: string;\n  readonly startSec?: number;\n  readonly endSec?: number;\n  readonly layerId?: string;\n}\ninterface VideoQaStats {\n  readonly expectedFrames: number;\n  readonly encodedFrames: number;\n  readonly fps: number;\n  readonly width: number;\n  readonly height: number;\n  /** Average luma over the whole video, 0-1 */\n  readonly meanLuma: number;\n  readonly blackSegments: readonly QaSegment[];\n  readonly frozenSegments: readonly QaSegment[];\n}\ninterface AudioQaStats {\n  readonly sampleRate: number;\n  readonly channels: number;\n  readonly durationSec: number;\n  /** Highest sample, dBFS (sample peak, not true peak) */\n  readonly peakDbfs: number;\n  /** Mean level over the whole track, dBFS */\n  readonly rmsDbfs: number;\n  /** ITU-R BS.1770 integrated loudness; null when the track is silent */\n  readonly integratedLufs: number | null;\n  /** Samples at or beyond full scale */\n  readonly clippedSamples: number;\n  readonly silentSegments: readonly QaSegment[];\n}\ninterface VideoQaReport {\n  /** No errors or warnings (info issues do not fail a render) */\n  readonly passed: boolean;\n  readonly video?: VideoQaStats;\n  readonly audio?: AudioQaStats;\n  readonly issues: readonly QaIssue[];\n}\n/** Measures frames handed to it in order, as RGBA bytes. */\ndeclare class FrameInspector {\n  private readonly blackLuma;\n  private readonly blackRatio;\n  private readonly black;\n  private readonly sameAsPrevious;\n  private lumaSum;\n  private previous;\n  constructor(options?: VideoQaOptions);\n  get frameCount(): number;\n  inspect(rgba: Uint8Array, width: number, height: number): void;\n  stats(expectedFrames: number, encodedFrames: number, fps: number, width: number, height: number, options?: VideoQaOptions): VideoQaStats;\n}\n/** Measures a mixed audio track (one Float32Array per channel). */\ndeclare function analyzeAudio(channels: readonly Float32Array[], sampleRate: number, options?: VideoQaOptions): AudioQaStats;\n/**\n * ITU-R BS.1770-4 integrated loudness (LUFS): K-weighted mean square in\n * 400 ms blocks with 75% overlap, gated at -70 LUFS and then at 10 LU below\n * the mean of what passed. Channels weigh 1 (stereo and mono layouts).\n */\ndeclare function integratedLoudness(channels: readonly Float32Array[], sampleRate: number): number | null;\n/** Turn measurements and document diagnostics into a report with issues. */\ndeclare function buildQaReport(parts: {\n  video?: VideoQaStats;\n  audio?: AudioQaStats;\n  diagnostics?: readonly RenderDiagnostic[];\n  options?: VideoQaOptions;\n}): VideoQaReport;\n/** A short human- and agent-readable summary of a report. */\ndeclare function formatQaReport(report: VideoQaReport): string;\n//#endregion\n//#region src/headless-webgpu-renderer.d.ts\ndeclare class RenderSemaphore {\n  private _running;\n  private readonly _max;\n  private readonly _queue;\n  constructor(max: number);\n  acquire(timeoutMs?: number): Promise<void>;\n  release(): void;\n  get stats(): {\n    active: number;\n    queued: number;\n    max: number;\n  };\n}\ndeclare const renderSemaphore: RenderSemaphore;\n/** Composition frames `start` (inclusive) to `end` (exclusive). */\ninterface FrameRange {\n  start: number;\n  end: number;\n}\ndeclare class HeadlessWebGPURenderer {\n  private static isInitialized;\n  private static initPromise;\n  private static initFailureCount;\n  private static readonly MAX_INIT_FAILURES;\n  private static nextRetryAt;\n  static initialize(): Promise<void>;\n  renderImage(virtualMedia: VirtualMediaData, frame?: number, fps?: number, options?: {\n    renderId?: string;\n    /** \"rgba\" skips PNG encoding and returns width*height*4 raw pixels. */\n    format?: \"png\" | \"rgba\";\n  }): Promise<Buffer>;\n  /**\n   * Renders a single frame to a PNG buffer at a specified timestamp in milliseconds or frame index.\n   */\n  renderFrame(source: VirtualMediaData | {\n    toVirtualMedia(): VirtualMediaData;\n  }, options?: {\n    atMs?: number;\n    frame?: number;\n    fps?: number;\n    /** Reuse compiled state across calls; see `renderImage`. */\n    renderId?: string;\n    /** \"rgba\" returns raw width*height*4 pixels instead of a PNG. */\n    format?: \"png\" | \"rgba\";\n  }): Promise<Buffer>;\n  /**\n   * Measures what frames cost to render across the timeline, for planning a\n   * split render (`planChunks`). At `samples` evenly spaced points (default\n   * 12) it renders three consecutive frames and times the last two, so\n   * effects that carry state (trails, particles) are caught up and their\n   * replay is not counted. Encoding is not included.\n   */\n  probeRender(source: VirtualMediaData | {\n    toVirtualMedia(): VirtualMediaData;\n  }, options?: {\n    samples?: number;\n    signal?: AbortSignal;\n    /** Called after each sample point with how many are done. */\n    onSample?: (done: number, total: number) => void;\n  }): Promise<{\n    totalFrames: number;\n    fps: number;\n    durationMs: number;\n    samples: FrameCostSample[];\n  }>;\n  /**\n   * Mixes the composition's full audio timeline (clips, effects, synthesized\n   * tracks) to stereo PCM, exactly as `renderVideo` muxes it.\n   */\n  renderAudio(virtualMedia: VirtualMediaData, options?: {\n    fps?: number;\n    sampleRate?: number;\n  }): Promise<{\n    channels: Float32Array[];\n    sampleRate: number;\n  }>;\n  renderLut(virtualMedia: VirtualMediaData, frame?: number, fps?: number): Promise<Buffer>;\n  private resolveMediaDuration;\n  renderVideo(virtualMedia: VirtualMediaData, options?: {\n    codec?: string;\n    audioCodec?: string;\n    quality?: string;\n    concurrency?: number;\n    /**\n     * Depth of the DMA staging ring (default 2, clamped 2–8). A deeper\n     * ring overlaps more encoder latency at the cost of VRAM\n     * (~8.3MB/slot at 1080p RGBA). Also settable via\n     * `FRAMEFIELDS_RING_CAPACITY`.\n     */\n    ringCapacity?: number;\n    /**\n     * Measure the output while it renders (black and frozen frames,\n     * dropped frames, loudness, clipping, silence, document warnings)\n     * and return the findings as `qa`. `true` uses default thresholds.\n     */\n    qa?: boolean | VideoQaOptions;\n    /**\n     * Aborts the render between frames; the promise rejects with\n     * `signal.reason` and the partial output is deleted.\n     */\n    signal?: AbortSignal;\n    /**\n     * Called as the render moves through its phases: \"prepare\", each\n     * frame (\"render\"), \"audio\" (mixing, per clip), \"audio-encode\",\n     * \"mux\", \"convert\" (GIF only) and \"done\".\n     */\n    onProgress?: (progress: RenderProgress) => void;\n    /**\n     * Renders only composition frames `start` (inclusive) to `end`\n     * (exclusive), as one chunk of a render split across workers. The\n     * chunk's timestamps start at 0 and its first frame is a keyframe,\n     * so `stitchChunks` joins chunks without re-encoding. Effects that\n     * carry state between frames rebuild it before `start`.\n     */\n    frames?: FrameRange;\n    /**\n     * `false` writes no audio track, as for chunks: the timeline's audio\n     * is exported once with `codec: \"aac\"` and added by `stitchChunks`.\n     */\n    audio?: boolean;\n  }): Promise<{\n    filePath: string;\n    cleanup: () => Promise<void>;\n    qa?: VideoQaReport;\n  }>;\n}\ndeclare const HeadlessMediaRenderer: typeof HeadlessWebGPURenderer;\ntype HeadlessMediaRenderer = HeadlessWebGPURenderer;\n//#endregion\n//#region src/job-reset.d.ts\n/**\n * Drops every cache keyed by a file path or URL: media inputs and decoders,\n * textures, LUTs, fonts and downloaded font files. A long-lived worker calls this between jobs,\n * because the next checkout may hold different bytes at the same path. The\n * GPU device and compiled pipelines stay warm.\n */\ndeclare function resetRenderCaches(): void;\n//#endregion\n//#region src/logger.d.ts\n/**\n * \"json\" (pino lines, for log collectors) or \"text\" (one short line each, for\n * people and agents reading a terminal). `FRAMEFIELDS_LOG_FORMAT` picks one;\n * otherwise production is JSON and everything else text.\n */\ndeclare function resolveLogFormat(vars?: Record<string, string | undefined> | undefined): \"json\" | \"text\";\n/**\n * Turns pino's JSON lines into `[framefields] Rendered 40% (…)`: the message\n * without its `[Component]` prefix, the level only for warnings and errors,\n * and an error's message (its stack reaches the caller with the throw).\n */\ndeclare function textLogStream(write?: (line: string) => void): DestinationStream;\ndeclare const rendererLogger: pino.Logger<never, boolean>;\n//#endregion\n//#region src/node-manifest.d.ts\n/**\n * The `framefields` block of a node package's `package.json`.\n *\n * This is the single declaration of a node's op: renderer discovery, the\n * effects generator (`scripts/generate-effects.ts`) and the skill catalog all\n * read it from here. There is deliberately no fallback that derives an op from\n * the package name. See `spec/sync-node.md` §5.1.\n */\ndeclare const NODE_KINDS: readonly [\"effect\", \"audio\", \"source\", \"signal\", \"utility\"];\ntype NodeKind = (typeof NODE_KINDS)[number];\ninterface NodeRendererExports {\n  development?: string;\n  import?: string;\n  default?: string;\n}\ninterface NodeManifest {\n  /** Directory name under `nodes/`, e.g. `node-apply-lut`. */\n  dir: string;\n  /** Absolute path of the node package. */\n  path: string;\n  /** npm package name, e.g. `@framefields/node-lut`. */\n  packageName: string;\n  /** Canonical op literal used in the operation AST and the renderer registry. */\n  type: string;\n  kind: NodeKind;\n  /** Legacy ops that resolve to the same renderer. */\n  aliases: readonly string[];\n  /** Named zod schema export of `src/shared/config.ts`. */\n  schema?: string;\n  /** Authoring class name. Defaults to `type`. */\n  className?: string;\n  /** Key on `Effect.*`. Defaults to `className` with a lower-cased first letter. */\n  factory?: string;\n  /** A hand-written subclass exists under `effects/custom/`. */\n  custom: boolean;\n  /** `false` when the package opts out of discovery. */\n  enabled: boolean;\n  rendererExports?: NodeRendererExports;\n}\ndeclare class NodeManifestError extends Error {\n  readonly problems: readonly string[];\n  constructor(problems: readonly string[]);\n}\n/**\n * Validates one parsed `package.json`. Returns the manifest, or the list of\n * problems that make it unusable. Never throws.\n */\ndeclare function parseNodeManifest(pkg: unknown, dir: string, nodePath?: string): {\n  manifest?: NodeManifest;\n  problems: string[];\n};\n/**\n * Reads every `nodes/node-*` package and returns its manifest, sorted by\n * directory name. Throws a single {@link NodeManifestError} listing every\n * problem: a missing or malformed block, or an op/alias claimed twice.\n */\ndeclare function loadNodeManifests(nodesDir: string): NodeManifest[];\n//#endregion\n//#region src/stitch.d.ts\ninterface StitchOptions {\n  /** Chunk files in timeline order, each a `renderVideo({ frames, audio: false })` output. */\n  chunks: readonly string[];\n  /**\n   * An audio-only render of the whole timeline (`renderVideo({ codec: \"aac\" })`,\n   * or `\"opus\"` for WebM chunks), copied in as the audio track.\n   */\n  audio?: string;\n  outputPath: string;\n  /** Stops between packets; the promise rejects and no file is left behind. */\n  signal?: AbortSignal;\n}\ninterface StitchResult {\n  filePath: string;\n  /** Video frames written, across all chunks. */\n  frames: number;\n  /** End of the video track, in seconds. */\n  durationSec: number;\n}\ndeclare function stitchChunks(options: StitchOptions): Promise<StitchResult>;\n//#endregion\n//#region src/zero-copy-webcodecs-pipeline.d.ts\ninterface ZeroCopyWebCodecsPipelineOptions {\n  readonly width: number;\n  readonly height: number;\n  readonly fps: number;\n  readonly videoSource: VideoSampleSource;\n  readonly ringCapacity?: number;\n  readonly colorSpace?: VideoColorSpaceConfig;\n  readonly directCanvasSource?: unknown;\n  /**\n   * Called with each frame's RGBA pixels, in frame order, just before it is\n   * encoded (staging-ring path only). The buffer is reused: read, don't keep.\n   */\n  readonly onFrame?: (rgba: Uint8Array, frameIndex: number) => void;\n}\ninterface WebCodecsPipelineStats {\n  readonly totalFramesEnqueued: number;\n  readonly totalFramesEncoded: number;\n  readonly averageGpuSubmitTimeMs: number;\n  readonly averageEncodeTimeMs: number;\n  readonly averageCycleTimeMs: number;\n  readonly maxCycleTimeMs: number;\n  readonly minCycleTimeMs: number;\n  readonly throughputFps: number;\n  readonly ringCapacity: number;\n  readonly isDirectZeroCopy: boolean;\n}\n/**\n * High-performance hardware video encoding pipeline integrating WebGPU textures with WebCodecs.\n *\n * Provides:\n * 1. Direct hardware acceleration when running with WebCodecs / OffscreenCanvas.\n * 2. Pipelined asynchronous double-buffered DMA staging ring for headless Node.js (Dawn native),\n *    allowing GPU Frame i+1 rendering to overlap concurrently with Frame i hardware encoding.\n */\ndeclare class ZeroCopyWebCodecsPipeline {\n  readonly width: number;\n  readonly height: number;\n  readonly fps: number;\n  readonly ringCapacity: number;\n  private readonly device;\n  private readonly videoSource;\n  private readonly stagingRing;\n  private readonly colorSpace?;\n  private readonly directCanvasSource?;\n  private readonly onFrame?;\n  private readonly inFlightFrames;\n  private readonly cycleStartTimes;\n  private totalFramesEnqueued;\n  private totalFramesEncoded;\n  private totalGpuSubmitTimeMs;\n  private totalEncodeTimeMs;\n  private totalCycleTimeMs;\n  private maxCycleTimeMs;\n  private minCycleTimeMs;\n  private pipelineStartTime;\n  constructor(device: GPUDevice, options: ZeroCopyWebCodecsPipelineOptions);\n  /**\n   * Returns true if direct zero-copy from an OffscreenCanvas or texture is active.\n   */\n  canDirectZeroCopy(): boolean;\n  /**\n   * Enqueues a rendered GPU texture frame into the pipeline.\n   *\n   * Uses double-buffered DMA staging: if the staging ring has reached capacity,\n   * the oldest in-flight frame is asynchronously consumed and added to the video encoder\n   * before staging the new frame, guaranteeing constant bounded VRAM usage and zero GPU stalls.\n   */\n  enqueueFrame(frameIndex: number, targetTexture: GPUTexture, encoder: GPUCommandEncoder): Promise<void>;\n  /**\n   * Drains all remaining in-flight frames in the pipeline, ensuring every enqueued\n   * frame has been encoded and added to the video sample source.\n   */\n  drain(): Promise<void>;\n  /**\n   * Returns runtime throughput, latency, and pipeline statistics.\n   */\n  getStats(): WebCodecsPipelineStats;\n  /**\n   * Destroys the pipeline and releases all staging buffers.\n   */\n  destroy(): void;\n  private consumeAndEncode;\n}\n//#endregion\nexport { AudioQaStats, ChunkPlan, ChunkPlanOptions, DmaStagingRing, DmaStagingRingOptions, FrameCostSample, FrameInspector, FrameRange, HeadlessMediaRenderer, HeadlessWebGPURenderer, NODE_KINDS, NodeKind, NodeManifest, NodeManifestError, NodeRendererExports, PlannedChunk, QaIssue, QaSegment, type RenderPhase, type RenderProgress, StagingSlotInfo, StagingSlotStatus, StitchOptions, StitchResult, VideoColorSpaceConfig, VideoQaOptions, VideoQaReport, VideoQaStats, WebCodecsPipelineStats, ZeroCopyWebCodecsPipeline, ZeroCopyWebCodecsPipelineOptions, analyzeAudio, buildQaReport, discoverAndRegisterNodeRenderers, findNodesDir, formatQaReport, integratedLoudness, loadNodeManifests, parseNodeManifest, planChunks, preloadFonts, renderSemaphore, rendererLogger, resetRenderCaches, resolveLogFormat, stitchChunks, textLogStream };\n//# sourceMappingURL=index.d.mts.map"],"mappings":"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"}

package/dist/{index-C6GcuYVA.d.mts → index-jSDEM-uE.d.mts}

@@ -1,7 +1,7 @@
-import { I as Effect, R as EffectConfigValue } from "./index-9_4X2ro1.mjs";
-import { n as NodeRendererPlugin, r as WebGPUNodeRenderer } from "./renderer-DoPEPlbG.mjs";
-import { n as AudioSignalOptions, r as ExtractedAudioSignalsBundle } from "./audio-D6tBMbHh.mjs";
-import { h as ObjectTrackSignals } from "./index-svAgwTY_.mjs";
+import { I as Effect, R as EffectConfigValue } from "./index-COYNQ_mf.mjs";
+import { n as NodeRendererPlugin, r as WebGPUNodeRenderer } from "./renderer-BVKOQarx.mjs";
+import { a as ExtractedAudioSignalsBundle, i as AudioSignalOptions } from "./audio-CYZkDwae.mjs";
+import { h as ObjectTrackSignals } from "./index-CEU_Zsb9.mjs";
 
 //#region ../../nodes/node-blur/dist/renderer.d.mts
 //#region src/renderers/index.d.ts
@@ -4563,4 +4563,4 @@ interface EffectConfigMap extends GeneratedEffectConfigMap {
 type EffectPropsFor<O extends EffectOp> = O extends keyof EffectConfigMap ? EffectConfigMap[O] : Record<string, unknown>;
 //#endregion
 export { TileOffsetEdgeMode as $, ResizerScalerProps as $n, FlipProps as $t, HandWrittenVisualEffect as A, Paint as An, _default$18 as Ar, CameraParallax3DProps as At, PBRGlass as B, Pixelate as Bn, _default$27 as Br, ContourProps as Bt, GradientMapProps as C, MeshWarp as Cn, _default$11 as Cr, AudioParametricEq as Ct, HalftoneScreen as D, NoiseGeneratorProps as Dn, _default$15 as Dr, CRT as Dt, HalftoneMode as E, NoiseGenerator as En, _default$14 as Er, AudioReverbProps as Et, LevelsProps as F, Painterly as Fn, _default$23 as Fr, ColorBalance as Ft, SSAOProps as G, ProceduralVFXProps as Gn, DatamoshProps as Gt, Relight3D as H, Posterize as Hn, _default$29 as Hr, CornerPinPointsItem as Ht, Modulate as I, PainterlyProps as In, _default$24 as Ir, ColorBalanceProps as It, SelectiveColorProps as J, RefineEdge as Jn, Dither as Jt, SelectiveColor as K, RGBSplit as Kn, DisplacementMap as Kt, ModulateProps as L, PatchHeal as Ln, _default$25 as Lr, ColorKey as Lt, HighPassProps as M, PaintStrokesItemOption1 as Mn, _default$20 as Mr, ChannelMergerProps as Mt, LevelChannel as N, PaintStrokesItemOption2 as Nn, _default$21 as Nr, ChannelSplitter as Nt, HalftoneScreenProps as O, OpArt as On, _default$16 as Or, CRTProps as Ot, Levels as P, PaintStrokesItemOption3 as Pn, _default$22 as Pr, ChannelSplitterProps as Pt, TileOffset as Q, ResizerScaler as Qn, Flip as Qt, MotionBlur as R, PatchHealPatchesItem as Rn, rendererNode as Rr, ColorKeyProps as Rt, GradientMap as S, MaskMathProps as Sn, _default$10 as Sr, AudioNoiseGateProps as St, HalftoneDotShape as T, MeshWarpProps as Tn, _default$13 as Tr, AudioReverb as Tt, Relight3DProps as U, PosterizeProps as Un, _default$30 as Ur, CornerPinProps as Ut, PBRGlassProps as V, PixelateProps as Vn, _default$28 as Vr, CornerPin as Vt, SSAO as W, ProceduralVFX as Wn, Datamosh as Wt, ShadowsHighlightsProps as X, RefractionCaustics3D as Xn, ExtractLUT as Xt, ShadowsHighlights as Y, RefineEdgeProps as Yn, DitherProps as Yt, TemporalDeflicker as Z, RefractionCaustics3DProps as Zn, ExtractLUTProps as Zt, EffectConfigMap as _, LayerStyleStroke as _n, _default$5 as _r, AudioDelay as _t, ApplyLUTProps as a, KaleidoscopeProps as an, Toon as ar, AnyGeneratedAudioEffect as at, FilmGrain as b, LiquifyProps as bn, _default$8 as br, AudioFadeProps as bt, Crop as c, KenBurnsProps as cn, TrailsProps as cr, GeneratedEffectConfigMap as ct, CurvesChannelPoint as d, LayerStyleColorOverlay as dn, EffectProp as dr, Blur as dt, Gooey as en, Rotate as er, TileOffsetProps as et, CurvesProps as f, LayerStyleDropShadow as fn, _default as fr, BlurProps as ft, DepthOfFieldProps as g, LayerStyleProps as gn, _default$4 as gr, AudioCompressorProps as gt, DepthOfField as h, LayerStyleOuterGlow as hn, _default$3 as hr, AudioCompressor as ht, ApplyLUT as i, Kaleidoscope as in, TonalShift as ir, VisionProps as it, HighPass as j, PaintProps as jn, _default$19 as jr, ChannelMerger as jt, HandWrittenAudioEffect as k, OpArtProps as kn, _default$17 as kr, CameraParallax3D as kt, CropProps as l, LayerStyle as ln, Vignette as lr, effectFactories as lt, DeflickerProps as m, LayerStyleInnerShadow as mn, _default$2 as mr, AsciiProps as mt, AnyEffect as n, Iridescence as nn, StereoPanning as nr, UnsharpMaskProps as nt, AudioSignalExtractor as o, KenBurns as on, ToonProps as or, AnyGeneratedEffect as ot, CustomEffect as p, LayerStyleInnerGlow as pn, _default$1 as pr, Ascii as pt, SelectiveColorAdjustment as q, RGBSplitProps as qn, DisplacementMapProps as qt, AnyVisualEffect as r, IridescenceProps as rn, StereoPanningProps as rr, Vision as rt, AudioSignalExtractorProps as s, KenBurnsKeyframesItem as sn, Trails as sr, AnyGeneratedVisualEffect as st, AnyAudioEffect as t, GooeyProps as tn, RotateProps as tr, UnsharpMask as tt, Curves as u, LayerStyleBevelEmboss as un, VignetteProps as ur, effectMeta as ut, EffectOp as v, Liquify as vn, _default$6 as vr, AudioDelayProps as vt, GradientMapStop as w, MeshWarpPointsItem as wn, _default$12 as wr, AudioParametricEqProps as wt, FilmGrainProps as x, MaskMath as xn, _default$9 as xr, AudioNoiseGate as xt, EffectPropsFor as y, LiquifyOperationsItem as yn, _default$7 as yr, AudioFade as yt, MotionBlurProps as z, PatchHealProps as zn, _default$26 as zr, Contour as zt };
-//# sourceMappingURL=index-C6GcuYVA.d.mts.map
+//# sourceMappingURL=index-jSDEM-uE.d.mts.map