framefields 2.13.0 → 2.14.0

package/dist/index-BFTtXosj.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index-BFTtXosj.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","AudioDecodeUnavailable","Error","AudioMixProgress","MixAudioOptions","AudioMix","applyMaster","masterGain","mixAudioTracks","GPUDevice","preflightMediaTime","NormalizationContext","normalizeTimeline"],"sources":["../../compositions/dist/index.d.mts"],"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/**\n * A source this runtime can't decode at all (a codec WebCodecs lacks, in a\n * worker without AudioContext). Thrown, not mixed as silence, so the caller\n * can mix where it can be decoded.\n */\ndeclare class AudioDecodeUnavailable extends Error {\n  name: string;\n}\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   * Mixes only [startSec, endSec) of the timeline, reading and processing\n   * only what plays there: the same samples as that stretch of a full mix\n   * (effects that carry state need lead-in before `startSec`; the caller\n   * mixes from earlier and drops it).\n   */\n  window?: {\n    startSec: number;\n    endSec: number;\n  };\n  /**\n   * Continue the effect state the last mix under this render id left,\n   * instead of starting from silence. A caller mixing back-to-back windows\n   * ([a, b) then [b, c)) gets exactly the samples of a full mix, effects\n   * with memory included. Default false.\n   */\n  continue?: boolean;\n  /**\n   * Apply the master stage (whole-mix auto gain, soft limiting). Default\n   * true. A windowed caller that masters once it knows the film's peak\n   * passes false and reads `peak`.\n   */\n  master?: boolean;\n}\ninterface AudioMix {\n  channels: Float32Array[];\n  sampleRate: number;\n  /** The loudest sample before the master stage. */\n  peak: number;\n}\n/**\n * The master stage, in place: `gain` (the automatic ceiling: a mix whose\n * summed tracks exceed -0.5 dB, 0.95, is scaled down smoothly), then soft\n * limiting and non-finite sanitation (transparent saturation instead of\n * harsh square-wave clipping).\n */\ndeclare function applyMaster(channels: Float32Array[], gain: number): void;\n/** The master stage's gain for a mix whose loudest sample is `peak`. */\ndeclare function masterGain(peak: number): number;\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<AudioMix>;\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, AudioDecodeUnavailable, AudioMix, AudioMixProgress, CropRegion, MixAudioOptions, RenderParams, SceneProps, applyMaster, calculateLayerTransform, compositionStateStore, computeRenderParams, decodeAudioSource, drawCompositionTree, formatTimecode, framesToSeconds, isStaticVisualMedia, masterGain, mixAudioTracks, normalizeTimeline, preflightMediaTime, resolveLayerDuration, secondsToFrames };\n//# sourceMappingURL=index.d.mts.map"],"mappings":";;;;;UA+DUkC,gBAAAA;;;;;;;;UAQAC,eAAAA;0BACgBD;;;;;;;;;;;;;;;;;;;;;;;;;UAyBhBE,QAAAA;YACEL;;;;;;;;;;;;;;;;iBAkBKQ,cAAAA,eAA6BrB,mEAAmEsB,wCAAwCL,kBAAkBV,QAAQW"}