@tscaps/engine 0.1.1

package/dist/modules/video/RenderJob.d.ts

@@ -0,0 +1,95 @@
+import type { Document } from '../document/Document';
+import type { SubtitleStyle } from '../rendering/SubtitleFrameRenderer';
+export type OutputFormat = 'mp4' | 'webm';
+export type RenderQuality = 'low' | 'medium' | 'high' | 'very-high';
+/**
+ * One write emitted into a `RenderJob.outputStream`: a byte slice and the
+ * absolute file offset where it lands. `position` is not monotonic — the
+ * muxer may seek back to patch earlier header regions once total sizes
+ * are known.
+ */
+export interface RenderOutputChunk {
+    type: 'write';
+    data: Uint8Array;
+    position: number;
+}
+/**
+ * Reasons the input's audio may end up missing from the output, surfaced
+ * only when the input actually had an audio track.
+ */
+export type AudioDiscardReason = 
+/** The input had an audio track but its codec could not be identified. */
+'unknown-source-codec'
+/** No codec is encodable by the host that the output container can hold. */
+ | 'no-encodable-target-codec';
+/**
+ * Information surfaced when the renderer cannot decode the input through
+ * the fast (WebCodecs) path and would have to fall back to a slower
+ * decoder. Lets the caller warn the user before the slow path runs.
+ */
+export interface FallbackDecoderInfo {
+    /** Codec of the input video track that triggered the fallback. */
+    inputCodec: string;
+}
+export interface RenderJob {
+    video: File;
+    document: Document;
+    /**
+     * Available styles keyed by `Section.kind`. The renderer dispatches
+     * per-frame to the entry matching the active Section's `kind`.
+     */
+    styles: Readonly<Record<string, SubtitleStyle>>;
+    /**
+     * Frame-invariant HTML composited above subtitles inside the same
+     * SVG `foreignObject`. Self-contained: any styling must be inline.
+     */
+    overlayHtml?: string;
+    outputFormat?: OutputFormat;
+    quality?: RenderQuality;
+    /**
+     * Target output dimensions. When omitted, the renderer keeps the
+     * input track's intrinsic display dimensions. When set, the source
+     * frames are scaled to these dimensions before composition; the
+     * subtitle layer is rendered directly at this size so text stays
+     * crisp instead of being scaled along with the video.
+     *
+     * Callers are responsible for keeping the aspect ratio consistent
+     * with the source — the renderer does not letterbox or crop.
+     */
+    outputResolution?: {
+        width: number;
+        height: number;
+    };
+    /**
+     * Sink for the encoded bytes. When set, the renderer writes chunks to
+     * it as the encoder produces them and `RenderResult.blob` is `null`.
+     * When unset, the encoded file accumulates in memory and is returned
+     * via `RenderResult.blob`.
+     */
+    outputStream?: WritableStream<RenderOutputChunk>;
+    /**
+     * Called when the input had an audio track but the renderer has to
+     * drop it. Not invoked when the input has no audio at all.
+     */
+    onAudioDiscarded?: (reason: AudioDiscardReason) => void;
+    /**
+     * Called when the renderer cannot decode the input through the fast
+     * (WebCodecs) path and would have to fall back to a slower decoder.
+     * Resolve with `true` to continue with the fallback, `false` to abort
+     * the render. When not provided, the renderer uses the fallback
+     * silently. The render rejects with a `DOMException` of name
+     * `'AbortError'` when the caller resolves with `false`.
+     */
+    confirmFallbackDecoder?: (info: FallbackDecoderInfo) => Promise<boolean>;
+}
+export interface RenderResult {
+    /** Encoded file in memory, or `null` when the job supplied `outputStream`. */
+    blob: Blob | null;
+    mimeType: string;
+}
+export interface RenderProgress {
+    percent: number;
+    currentFrame: number;
+    totalFrames: number;
+}
+//# sourceMappingURL=RenderJob.d.ts.map

package/dist/modules/video/RenderJob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderJob.d.ts","sourceRoot":"","sources":["../../../src/modules/video/RenderJob.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AAE9E,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,CAAC;AAE1C,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,kBAAkB;AAC5B,0EAA0E;AACxE,sBAAsB;AACxB,4EAA4E;GAC1E,2BAA2B,CAAC;AAEhC;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,EAAE,QAAQ,CAAC;IACnB;;;OAGG;IACH,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAChD;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD;;;;;OAKG;IACH,YAAY,CAAC,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACjD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACxD;;;;;;;OAOG;IACH,sBAAsB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/modules/video/RenderJob.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RenderJob.js.map

package/dist/modules/video/RenderJob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderJob.js","sourceRoot":"","sources":["../../../src/modules/video/RenderJob.ts"],"names":[],"mappings":""}

package/dist/modules/video/VideoRenderer.d.ts

@@ -0,0 +1,5 @@
+import type { RenderJob, RenderResult, RenderProgress } from '../video/RenderJob';
+export interface VideoRenderer {
+    render(job: RenderJob, onProgress?: (progress: RenderProgress) => void): Promise<RenderResult>;
+}
+//# sourceMappingURL=VideoRenderer.d.ts.map

package/dist/modules/video/VideoRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoRenderer.d.ts","sourceRoot":"","sources":["../../../src/modules/video/VideoRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAExF,MAAM,WAAW,aAAa;IAC5B,MAAM,CACJ,GAAG,EAAE,SAAS,EACd,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,GAC9C,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1B"}

package/dist/modules/video/VideoRenderer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=VideoRenderer.js.map

package/dist/modules/video/VideoRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoRenderer.js","sourceRoot":"","sources":["../../../src/modules/video/VideoRenderer.ts"],"names":[],"mappings":""}

package/dist/modules/video/index.d.ts

@@ -0,0 +1,33 @@
+export type { VideoRenderer } from '../video/VideoRenderer';
+export type { RenderJob, RenderResult, RenderProgress, RenderOutputChunk, OutputFormat, RenderQuality, AudioDiscardReason, FallbackDecoderInfo, } from '../video/RenderJob';
+export { MediaBunnyVideoRenderer } from '../video/mediabunny/MediaBunnyVideoRenderer';
+export type { MediaBunnyVideoRendererConfig } from '../video/mediabunny/MediaBunnyVideoRenderer';
+export type { CodecPolicy, VideoCodecResolution, VideoCodecResolutionRequest, } from '../video/mediabunny/codec/CodecPolicy';
+export { DefaultCodecPolicy } from '../video/mediabunny/codec/DefaultCodecPolicy';
+export type { VideoFrameDecoder, DecodedVideoFrame, } from '../video/mediabunny/frame/VideoFrameDecoder';
+export type { VideoFrameDecoderFactory, VideoFrameDecoderRequest, } from '../video/mediabunny/frame/VideoFrameDecoderFactory';
+export { DefaultVideoFrameDecoderFactory } from '../video/mediabunny/frame/DefaultVideoFrameDecoderFactory';
+export { WebCodecsVideoFrameDecoder } from '../video/mediabunny/frame/WebCodecsVideoFrameDecoder';
+export { HtmlVideoElementVideoFrameDecoder } from '../video/mediabunny/frame/HtmlVideoElementVideoFrameDecoder';
+export type { VideoTrackEncoder } from '../video/mediabunny/encoder/VideoTrackEncoder';
+export type { VideoTrackEncoderFactory, VideoTrackEncoderFactoryRequest, } from '../video/mediabunny/encoder/VideoTrackEncoderFactory';
+export { MediaBunnyCanvasVideoTrackEncoder, } from '../video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder';
+export type { MediaBunnyCanvasVideoTrackEncoderConfig, } from '../video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder';
+export { MediaBunnyCanvasVideoTrackEncoderFactory, } from '../video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoderFactory';
+export type { FrameCompositor } from '../video/mediabunny/frame/FrameCompositor';
+export { LayeredFrameCompositor } from '../video/mediabunny/frame/LayeredFrameCompositor';
+export type { SubtitleLayerSource } from '../video/mediabunny/caption/SubtitleLayerSource';
+export { BatchedSubtitleLayerSource } from '../video/mediabunny/caption/BatchedSubtitleLayerSource';
+export { VideoBoundSubtitleLayerSource } from '../video/mediabunny/caption/VideoBoundSubtitleLayerSource';
+export { ComposedSubtitleLayerSource } from '../video/mediabunny/caption/ComposedSubtitleLayerSource';
+export type { AudioTrackBridge } from '../video/mediabunny/audio/AudioTrackBridge';
+export type { AudioTrackBridgeFactory, AudioTrackBridgeRequest, } from '../video/mediabunny/audio/AudioTrackBridgeFactory';
+export { DefaultAudioTrackBridgeFactory } from '../video/mediabunny/audio/DefaultAudioTrackBridgeFactory';
+export { PassthroughAudioTrackBridge } from '../video/mediabunny/audio/PassthroughAudioTrackBridge';
+export type { PassthroughAudioTrackBridgeConfig, } from '../video/mediabunny/audio/PassthroughAudioTrackBridge';
+export { TranscodeAudioTrackBridge } from '../video/mediabunny/audio/TranscodeAudioTrackBridge';
+export type { TranscodeAudioTrackBridgeConfig, } from '../video/mediabunny/audio/TranscodeAudioTrackBridge';
+export { DiscardAudioTrackBridge } from '../video/mediabunny/audio/DiscardAudioTrackBridge';
+export type { OutputTargetBuilder, OutputTargetBuildRequest, OutputTargetBuildResult, } from '../video/mediabunny/output/OutputTargetBuilder';
+export { MediaBunnyOutputTargetBuilder } from '../video/mediabunny/output/MediaBunnyOutputTargetBuilder';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/video/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/video/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAC5F,YAAY,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAC;AAEvG,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAExF,YAAY,EACV,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,mDAAmD,CAAC;AAC3D,YAAY,EACV,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,0DAA0D,CAAC;AAClE,OAAO,EAAE,+BAA+B,EAAE,MAAM,iEAAiE,CAAC;AAClH,OAAO,EAAE,0BAA0B,EAAE,MAAM,4DAA4D,CAAC;AACxG,OAAO,EAAE,iCAAiC,EAAE,MAAM,mEAAmE,CAAC;AAEtH,YAAY,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AAC7F,YAAY,EACV,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,4DAA4D,CAAC;AACpE,OAAO,EACL,iCAAiC,GAClC,MAAM,qEAAqE,CAAC;AAC7E,YAAY,EACV,uCAAuC,GACxC,MAAM,qEAAqE,CAAC;AAC7E,OAAO,EACL,wCAAwC,GACzC,MAAM,4EAA4E,CAAC;AAEpF,YAAY,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAEhG,YAAY,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,8DAA8D,CAAC;AAC1G,OAAO,EAAE,6BAA6B,EAAE,MAAM,iEAAiE,CAAC;AAChH,OAAO,EAAE,2BAA2B,EAAE,MAAM,+DAA+D,CAAC;AAE5G,YAAY,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AACzF,YAAY,EACV,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,yDAAyD,CAAC;AACjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,gEAAgE,CAAC;AAChH,OAAO,EAAE,2BAA2B,EAAE,MAAM,6DAA6D,CAAC;AAC1G,YAAY,EACV,iCAAiC,GAClC,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AACtG,YAAY,EACV,+BAA+B,GAChC,MAAM,2DAA2D,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAElG,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gEAAgE,CAAC"}

package/dist/modules/video/index.js

@@ -0,0 +1,17 @@
+export { MediaBunnyVideoRenderer } from '../video/mediabunny/MediaBunnyVideoRenderer';
+export { DefaultCodecPolicy } from '../video/mediabunny/codec/DefaultCodecPolicy';
+export { DefaultVideoFrameDecoderFactory } from '../video/mediabunny/frame/DefaultVideoFrameDecoderFactory';
+export { WebCodecsVideoFrameDecoder } from '../video/mediabunny/frame/WebCodecsVideoFrameDecoder';
+export { HtmlVideoElementVideoFrameDecoder } from '../video/mediabunny/frame/HtmlVideoElementVideoFrameDecoder';
+export { MediaBunnyCanvasVideoTrackEncoder, } from '../video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoder';
+export { MediaBunnyCanvasVideoTrackEncoderFactory, } from '../video/mediabunny/encoder/MediaBunnyCanvasVideoTrackEncoderFactory';
+export { LayeredFrameCompositor } from '../video/mediabunny/frame/LayeredFrameCompositor';
+export { BatchedSubtitleLayerSource } from '../video/mediabunny/caption/BatchedSubtitleLayerSource';
+export { VideoBoundSubtitleLayerSource } from '../video/mediabunny/caption/VideoBoundSubtitleLayerSource';
+export { ComposedSubtitleLayerSource } from '../video/mediabunny/caption/ComposedSubtitleLayerSource';
+export { DefaultAudioTrackBridgeFactory } from '../video/mediabunny/audio/DefaultAudioTrackBridgeFactory';
+export { PassthroughAudioTrackBridge } from '../video/mediabunny/audio/PassthroughAudioTrackBridge';
+export { TranscodeAudioTrackBridge } from '../video/mediabunny/audio/TranscodeAudioTrackBridge';
+export { DiscardAudioTrackBridge } from '../video/mediabunny/audio/DiscardAudioTrackBridge';
+export { MediaBunnyOutputTargetBuilder } from '../video/mediabunny/output/MediaBunnyOutputTargetBuilder';
+//# sourceMappingURL=index.js.map

package/dist/modules/video/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/video/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAQ5F,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AAUxF,OAAO,EAAE,+BAA+B,EAAE,MAAM,iEAAiE,CAAC;AAClH,OAAO,EAAE,0BAA0B,EAAE,MAAM,4DAA4D,CAAC;AACxG,OAAO,EAAE,iCAAiC,EAAE,MAAM,mEAAmE,CAAC;AAOtH,OAAO,EACL,iCAAiC,GAClC,MAAM,qEAAqE,CAAC;AAI7E,OAAO,EACL,wCAAwC,GACzC,MAAM,4EAA4E,CAAC;AAGpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAGhG,OAAO,EAAE,0BAA0B,EAAE,MAAM,8DAA8D,CAAC;AAC1G,OAAO,EAAE,6BAA6B,EAAE,MAAM,iEAAiE,CAAC;AAChH,OAAO,EAAE,2BAA2B,EAAE,MAAM,+DAA+D,CAAC;AAO5G,OAAO,EAAE,8BAA8B,EAAE,MAAM,gEAAgE,CAAC;AAChH,OAAO,EAAE,2BAA2B,EAAE,MAAM,6DAA6D,CAAC;AAI1G,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAItG,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAOlG,OAAO,EAAE,6BAA6B,EAAE,MAAM,gEAAgE,CAAC"}

package/dist/modules/video/mediabunny/MediaBunnyVideoRenderer.d.ts

@@ -0,0 +1,69 @@
+import type { VideoRenderer } from '../../video/VideoRenderer';
+import type { RenderJob, RenderResult, RenderProgress } from '../../video/RenderJob';
+import type { OverlayFrameRenderer } from '../../rendering/OverlayFrameRenderer';
+import type { CodecPolicy } from '../../video/mediabunny/codec/CodecPolicy';
+import type { VideoFrameDecoderFactory } from '../../video/mediabunny/frame/VideoFrameDecoderFactory';
+import type { AudioTrackBridgeFactory } from '../../video/mediabunny/audio/AudioTrackBridgeFactory';
+import type { OutputTargetBuilder } from '../../video/mediabunny/output/OutputTargetBuilder';
+import type { VideoTrackEncoderFactory } from '../../video/mediabunny/encoder/VideoTrackEncoderFactory';
+import type { FrameCompositor } from '../../video/mediabunny/frame/FrameCompositor';
+import type { SubtitleLayerSource } from '../../video/mediabunny/caption/SubtitleLayerSource';
+export interface MediaBunnyVideoRendererConfig {
+    /**
+     * Produces the caption raster painted onto each output frame. The
+     * coordinator does not split styles, snap times to caption ticks,
+     * or composite layers — all caption-side strategy lives behind
+     * this single source.
+     */
+    subtitleLayer: SubtitleLayerSource;
+    overlayRenderer: OverlayFrameRenderer;
+    codecPolicy: CodecPolicy;
+    videoFrameDecoderFactory: VideoFrameDecoderFactory;
+    videoTrackEncoderFactory: VideoTrackEncoderFactory;
+    audioTrackBridgeFactory: AudioTrackBridgeFactory;
+    outputTargetBuilder: OutputTargetBuilder;
+    frameCompositor: FrameCompositor;
+}
+/**
+ * Renders a `RenderJob` into a mediabunny {@link Output} container.
+ *
+ * Coordinates the decoder, the subtitle layer source, the frame
+ * compositor, the encoder, and the audio bridge. Caption strategy
+ * (batching, video-frame sampling, mixed) lives entirely behind the
+ * configured {@link SubtitleLayerSource}.
+ *
+ * One job at a time per instance: concurrent {@link render} calls on
+ * the same instance are not supported.
+ *
+ * Caption ticks step at most at {@link CAPTION_FPS_CAP}; inputs
+ * below that cap step at the input's own framerate.
+ */
+export declare class MediaBunnyVideoRenderer implements VideoRenderer {
+    private readonly subtitleLayer;
+    private readonly overlayRenderer;
+    private readonly codecPolicy;
+    private readonly videoFrameDecoderFactory;
+    private readonly videoTrackEncoderFactory;
+    private readonly audioTrackBridgeFactory;
+    private readonly outputTargetBuilder;
+    private readonly frameCompositor;
+    constructor(config: MediaBunnyVideoRendererConfig);
+    render(job: RenderJob, onProgress?: (progress: RenderProgress) => void): Promise<RenderResult>;
+    private runEncodeLoop;
+    private toEncoderConfig;
+    private computeDuration;
+    /**
+     * Resolves the final pixel dimensions for the output. When the caller
+     * specifies `outputResolution`, those values win — but the renderer
+     * never upscales beyond the source and snaps to even numbers, which
+     * most hardware video encoders require.
+     */
+    private resolveOutputDimensions;
+    private toEven;
+    private readFrameRate;
+    private toProgress;
+    private safeCancel;
+    private assertWebCodecsAvailable;
+    private buildResult;
+}
+//# sourceMappingURL=MediaBunnyVideoRenderer.d.ts.map

package/dist/modules/video/mediabunny/MediaBunnyVideoRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaBunnyVideoRenderer.d.ts","sourceRoot":"","sources":["../../../../src/modules/video/mediabunny/MediaBunnyVideoRenderer.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EAEf,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,oBAAoB,EAAgB,MAAM,yCAAyC,CAAC;AAClG,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,6CAA6C,CAAC;AACrG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0DAA0D,CAAC;AAEzG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAEvG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sDAAsD,CAAC;AAEhG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4DAA4D,CAAC;AAC3G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AAQjG,MAAM,WAAW,6BAA6B;IAC5C;;;;;OAKG;IACH,aAAa,EAAE,mBAAmB,CAAC;IACnC,eAAe,EAAE,oBAAoB,CAAC;IACtC,WAAW,EAAE,WAAW,CAAC;IACzB,wBAAwB,EAAE,wBAAwB,CAAC;IACnD,wBAAwB,EAAE,wBAAwB,CAAC;IACnD,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,eAAe,EAAE,eAAe,CAAC;CAClC;AAWD;;;;;;;;;;;;;GAaG;AACH,qBAAa,uBAAwB,YAAW,aAAa;IAE3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA2B;IACpE,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA2B;IACpE,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA0B;IAClE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAEtC,MAAM,EAAE,6BAA6B;IAW3C,MAAM,CACV,GAAG,EAAE,SAAS,EACd,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,GAC9C,OAAO,CAAC,YAAY,CAAC;YAyEV,aAAa;IA6B3B,OAAO,CAAC,eAAe;YAWT,eAAe;IAQ7B;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAW/B,OAAO,CAAC,MAAM;YAKA,aAAa;IAe3B,OAAO,CAAC,UAAU;YAKJ,UAAU;IASxB,OAAO,CAAC,wBAAwB;IAShC,OAAO,CAAC,WAAW;CAQpB"}

package/dist/modules/video/mediabunny/MediaBunnyVideoRenderer.js

@@ -0,0 +1,206 @@
+import { Input, BlobSource, ALL_FORMATS, } from 'mediabunny';
+// Captions step at the video's frame rate up to this cap. Past it,
+// per-letter or per-word animations gain nothing from extra renders
+// (the eye doesn't resolve sub-30fps differences in caption motion)
+// and the per-batch subtitle decode dominates the render budget.
+const CAPTION_FPS_CAP = 30;
+/**
+ * Renders a `RenderJob` into a mediabunny {@link Output} container.
+ *
+ * Coordinates the decoder, the subtitle layer source, the frame
+ * compositor, the encoder, and the audio bridge. Caption strategy
+ * (batching, video-frame sampling, mixed) lives entirely behind the
+ * configured {@link SubtitleLayerSource}.
+ *
+ * One job at a time per instance: concurrent {@link render} calls on
+ * the same instance are not supported.
+ *
+ * Caption ticks step at most at {@link CAPTION_FPS_CAP}; inputs
+ * below that cap step at the input's own framerate.
+ */
+export class MediaBunnyVideoRenderer {
+    subtitleLayer;
+    overlayRenderer;
+    codecPolicy;
+    videoFrameDecoderFactory;
+    videoTrackEncoderFactory;
+    audioTrackBridgeFactory;
+    outputTargetBuilder;
+    frameCompositor;
+    constructor(config) {
+        this.subtitleLayer = config.subtitleLayer;
+        this.overlayRenderer = config.overlayRenderer;
+        this.codecPolicy = config.codecPolicy;
+        this.videoFrameDecoderFactory = config.videoFrameDecoderFactory;
+        this.videoTrackEncoderFactory = config.videoTrackEncoderFactory;
+        this.audioTrackBridgeFactory = config.audioTrackBridgeFactory;
+        this.outputTargetBuilder = config.outputTargetBuilder;
+        this.frameCompositor = config.frameCompositor;
+    }
+    async render(job, onProgress) {
+        this.assertWebCodecsAvailable();
+        const input = new Input({ formats: ALL_FORMATS, source: new BlobSource(job.video) });
+        const videoTrack = await input.getPrimaryVideoTrack();
+        if (!videoTrack) {
+            throw new Error('No video track found in the input file');
+        }
+        const { width, height } = this.resolveOutputDimensions(videoTrack.displayWidth, videoTrack.displayHeight, job.outputResolution);
+        const fps = await this.readFrameRate(videoTrack);
+        const captionInterval = 1 / Math.min(fps, CAPTION_FPS_CAP);
+        await this.subtitleLayer.open(job.document, job.styles, width, height, captionInterval);
+        const { output, target, format } = this.outputTargetBuilder.build({
+            format: job.outputFormat,
+            stream: job.outputStream,
+        });
+        const codecResolution = await this.codecPolicy.resolveVideo({
+            supportedCodecs: format.getSupportedVideoCodecs(),
+            width,
+            height,
+            fps,
+            quality: job.quality,
+        });
+        const encoder = this.videoTrackEncoderFactory.create({
+            width,
+            height,
+            encoderConfig: this.toEncoderConfig(codecResolution),
+        });
+        encoder.attachTo(output);
+        const audioBridge = await this.audioTrackBridgeFactory.create({
+            input,
+            format,
+            ...(job.onAudioDiscarded ? { onAudioDiscarded: job.onAudioDiscarded } : {}),
+        });
+        await audioBridge.attachTo(output);
+        const decoder = await this.videoFrameDecoderFactory.create({
+            track: videoTrack,
+            source: job.video,
+            ...(job.confirmFallbackDecoder ? { confirmFallback: job.confirmFallbackDecoder } : {}),
+        });
+        const duration = await this.computeDuration(videoTrack);
+        const overlay = job.overlayHtml ? await this.overlayRenderer.render(job.overlayHtml, width, height) : null;
+        await output.start();
+        try {
+            await this.runEncodeLoop({ decoder, encoder, audioBridge, duration, overlay, onProgress });
+            await audioBridge.finish();
+            await output.finalize();
+        }
+        catch (err) {
+            await this.safeCancel(output);
+            throw err;
+        }
+        finally {
+            decoder.close();
+            this.subtitleLayer.close();
+        }
+        return this.buildResult(target, job.outputFormat);
+    }
+    // One decoded video frame is alive at any time: holding more would
+    // back-pressure the WebCodecs frame pool into a stall.
+    async runEncodeLoop(params) {
+        const width = params.encoder.width;
+        const height = params.encoder.height;
+        let frameCount = 0;
+        for await (const frame of params.decoder.samples()) {
+            try {
+                if (frame.timestamp < 0)
+                    continue;
+                const captionLayer = await this.subtitleLayer.frameAt(frame.timestamp, frame);
+                await params.encoder.encode(frame.timestamp, frame.duration, (ctx) => {
+                    this.frameCompositor.compose(ctx, {
+                        frame,
+                        captions: captionLayer,
+                        overlay: params.overlay,
+                        width,
+                        height,
+                    });
+                });
+                await params.audioBridge.pumpUntil(frame.timestamp);
+                frameCount++;
+                if (params.onProgress)
+                    params.onProgress(this.toProgress(frame.timestamp, params.duration, frameCount));
+            }
+            finally {
+                frame.close();
+            }
+        }
+    }
+    toEncoderConfig(resolution) {
+        const config = {
+            codec: resolution.codec,
+            bitrate: resolution.bitrate,
+            bitrateMode: resolution.bitrateMode,
+            latencyMode: resolution.latencyMode,
+        };
+        if (resolution.contentHint !== undefined)
+            config.contentHint = resolution.contentHint;
+        return config;
+    }
+    async computeDuration(videoTrack) {
+        try {
+            return await videoTrack.computeDuration();
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * Resolves the final pixel dimensions for the output. When the caller
+     * specifies `outputResolution`, those values win — but the renderer
+     * never upscales beyond the source and snaps to even numbers, which
+     * most hardware video encoders require.
+     */
+    resolveOutputDimensions(sourceWidth, sourceHeight, requested) {
+        if (!requested)
+            return { width: sourceWidth, height: sourceHeight };
+        const width = Math.min(requested.width, sourceWidth);
+        const height = Math.min(requested.height, sourceHeight);
+        return { width: this.toEven(width), height: this.toEven(height) };
+    }
+    toEven(value) {
+        const rounded = Math.round(value);
+        return rounded % 2 === 0 ? rounded : rounded - 1;
+    }
+    async readFrameRate(videoTrack) {
+        try {
+            const stats = await videoTrack.computePacketStats(120);
+            if (Number.isFinite(stats.averagePacketRate) && stats.averagePacketRate > 0) {
+                return stats.averagePacketRate;
+            }
+        }
+        catch {
+            // Falls through to the default.
+        }
+        console.warn('Could not determine input frame rate; defaulting to 30 fps');
+        return 30;
+    }
+    toProgress(timestamp, duration, frameCount) {
+        const percent = duration > 0 ? Math.min(100, Math.round((timestamp / duration) * 100)) : 0;
+        return { percent, currentFrame: frameCount, totalFrames: 0 };
+    }
+    async safeCancel(output) {
+        if (output.state === 'finalized' || output.state === 'canceled')
+            return;
+        try {
+            await output.cancel();
+        }
+        catch {
+            // Cancellation is best-effort; the original error has priority.
+        }
+    }
+    assertWebCodecsAvailable() {
+        if (typeof globalThis.VideoEncoder === 'undefined') {
+            throw new Error('This browser does not support video encoding (WebCodecs). ' +
+                'Use Chrome, Firefox, or Safari 17.4+ on a recent device.');
+        }
+    }
+    buildResult(target, format) {
+        const mimeType = format === 'webm' ? 'video/webm' : 'video/mp4';
+        if (!target)
+            return { blob: null, mimeType };
+        return {
+            blob: new Blob([target.buffer], { type: mimeType }),
+            mimeType,
+        };
+    }
+}
+//# sourceMappingURL=MediaBunnyVideoRenderer.js.map

package/dist/modules/video/mediabunny/MediaBunnyVideoRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaBunnyVideoRenderer.js","sourceRoot":"","sources":["../../../../src/modules/video/mediabunny/MediaBunnyVideoRenderer.ts"],"names":[],"mappings":"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"}

package/dist/modules/video/mediabunny/audio/AudioTrackBridge.d.ts

@@ -0,0 +1,24 @@
+import type { Output } from 'mediabunny';
+/**
+ * Bridges the input file's audio track to the output.
+ *
+ * Lifecycle: {@link attachTo} once before output start, {@link pumpUntil}
+ * once per encoded video frame to keep audio in lockstep, and
+ * {@link finish} once after the last video frame to drain any remaining
+ * data before the output is finalized.
+ */
+export interface AudioTrackBridge {
+    /**
+     * Wires the bridge into the output. Must be called once before the
+     * output is started.
+     */
+    attachTo(output: Output): Promise<void>;
+    /**
+     * Pushes any pending audio data whose timestamp is at or before
+     * `videoTimestamp` (in seconds) into the output.
+     */
+    pumpUntil(videoTimestamp: number): Promise<void>;
+    /** Drains all remaining audio data into the output. */
+    finish(): Promise<void>;
+}
+//# sourceMappingURL=AudioTrackBridge.d.ts.map

package/dist/modules/video/mediabunny/audio/AudioTrackBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioTrackBridge.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/AudioTrackBridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC;;;OAGG;IACH,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,uDAAuD;IACvD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB"}

package/dist/modules/video/mediabunny/audio/AudioTrackBridge.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AudioTrackBridge.js.map

package/dist/modules/video/mediabunny/audio/AudioTrackBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioTrackBridge.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/AudioTrackBridge.ts"],"names":[],"mappings":""}

package/dist/modules/video/mediabunny/audio/AudioTrackBridgeFactory.d.ts

@@ -0,0 +1,20 @@
+import type { Input, OutputFormat as MediaBunnyOutputFormat } from 'mediabunny';
+import type { AudioTrackBridge } from '../../../video/mediabunny/audio/AudioTrackBridge';
+import type { AudioDiscardReason } from '../../../video/RenderJob';
+export interface AudioTrackBridgeRequest {
+    input: Input;
+    format: MediaBunnyOutputFormat;
+    /**
+     * Called when the input had an audio track but the bridge has to drop
+     * it. Not invoked when the input has no audio at all.
+     */
+    onAudioDiscarded?: (reason: AudioDiscardReason) => void;
+}
+/**
+ * Picks an appropriate {@link AudioTrackBridge} given the input file and
+ * the chosen output container.
+ */
+export interface AudioTrackBridgeFactory {
+    create(request: AudioTrackBridgeRequest): Promise<AudioTrackBridge>;
+}
+//# sourceMappingURL=AudioTrackBridgeFactory.d.ts.map

package/dist/modules/video/mediabunny/audio/AudioTrackBridgeFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioTrackBridgeFactory.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/AudioTrackBridgeFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,IAAI,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AACzF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,sBAAsB,CAAC;IAC/B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACzD;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACrE"}

package/dist/modules/video/mediabunny/audio/AudioTrackBridgeFactory.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AudioTrackBridgeFactory.js.map

package/dist/modules/video/mediabunny/audio/AudioTrackBridgeFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioTrackBridgeFactory.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/AudioTrackBridgeFactory.ts"],"names":[],"mappings":""}

package/dist/modules/video/mediabunny/audio/DefaultAudioTrackBridgeFactory.d.ts

@@ -0,0 +1,11 @@
+import type { AudioTrackBridge } from '../../../video/mediabunny/audio/AudioTrackBridge';
+import type { AudioTrackBridgeFactory, AudioTrackBridgeRequest } from '../../../video/mediabunny/audio/AudioTrackBridgeFactory';
+/**
+ * Decides whether to copy the input audio packets verbatim, transcode
+ * them into a codec the output container accepts, or — only when neither
+ * path is possible — drop audio altogether.
+ */
+export declare class DefaultAudioTrackBridgeFactory implements AudioTrackBridgeFactory {
+    create(request: AudioTrackBridgeRequest): Promise<AudioTrackBridge>;
+}
+//# sourceMappingURL=DefaultAudioTrackBridgeFactory.d.ts.map

package/dist/modules/video/mediabunny/audio/DefaultAudioTrackBridgeFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultAudioTrackBridgeFactory.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/DefaultAudioTrackBridgeFactory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EACjB,MAAM,kDAAkD,CAAC;AAC1D,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,yDAAyD,CAAC;AAKjE;;;;GAIG;AACH,qBAAa,8BAA+B,YAAW,uBAAuB;IAEtE,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAmB1E"}

package/dist/modules/video/mediabunny/audio/DefaultAudioTrackBridgeFactory.js

@@ -0,0 +1,32 @@
+import { getFirstEncodableAudioCodec } from 'mediabunny';
+import { PassthroughAudioTrackBridge } from '../../../video/mediabunny/audio/PassthroughAudioTrackBridge';
+import { TranscodeAudioTrackBridge } from '../../../video/mediabunny/audio/TranscodeAudioTrackBridge';
+import { DiscardAudioTrackBridge } from '../../../video/mediabunny/audio/DiscardAudioTrackBridge';
+/**
+ * Decides whether to copy the input audio packets verbatim, transcode
+ * them into a codec the output container accepts, or — only when neither
+ * path is possible — drop audio altogether.
+ */
+export class DefaultAudioTrackBridgeFactory {
+    async create(request) {
+        const track = await request.input.getPrimaryAudioTrack();
+        if (!track)
+            return new DiscardAudioTrackBridge();
+        const codec = await track.getCodec();
+        if (!codec) {
+            request.onAudioDiscarded?.('unknown-source-codec');
+            return new DiscardAudioTrackBridge();
+        }
+        const supportedCodecs = request.format.getSupportedAudioCodecs();
+        if (supportedCodecs.includes(codec)) {
+            return new PassthroughAudioTrackBridge({ inputTrack: track, codec });
+        }
+        const transcodeTarget = await getFirstEncodableAudioCodec(supportedCodecs);
+        if (transcodeTarget) {
+            return new TranscodeAudioTrackBridge({ inputTrack: track, codec: transcodeTarget });
+        }
+        request.onAudioDiscarded?.('no-encodable-target-codec');
+        return new DiscardAudioTrackBridge();
+    }
+}
+//# sourceMappingURL=DefaultAudioTrackBridgeFactory.js.map

package/dist/modules/video/mediabunny/audio/DefaultAudioTrackBridgeFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultAudioTrackBridgeFactory.js","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/DefaultAudioTrackBridgeFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAQzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,6DAA6D,CAAC;AAC1G,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AACtG,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAElG;;;;GAIG;AACH,MAAM,OAAO,8BAA8B;IAEzC,KAAK,CAAC,MAAM,CAAC,OAAgC;QAC3C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;QACzD,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,uBAAuB,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,gBAAgB,EAAE,CAAC,sBAAsB,CAAC,CAAC;YACnD,OAAO,IAAI,uBAAuB,EAAE,CAAC;QACvC,CAAC;QACD,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC;QACjE,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,2BAA2B,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,eAAe,GAAG,MAAM,2BAA2B,CAAC,eAAe,CAAC,CAAC;QAC3E,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,IAAI,yBAAyB,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,CAAC,gBAAgB,EAAE,CAAC,2BAA2B,CAAC,CAAC;QACxD,OAAO,IAAI,uBAAuB,EAAE,CAAC;IACvC,CAAC;CACF"}

package/dist/modules/video/mediabunny/audio/DiscardAudioTrackBridge.d.ts

@@ -0,0 +1,12 @@
+import type { AudioTrackBridge } from '../../../video/mediabunny/audio/AudioTrackBridge';
+/**
+ * No-op bridge used when the input has no audio or when its audio codec
+ * cannot be put into the chosen output container without a transcode
+ * step the host can't perform. The output ends up with no audio track.
+ */
+export declare class DiscardAudioTrackBridge implements AudioTrackBridge {
+    attachTo(): Promise<void>;
+    pumpUntil(): Promise<void>;
+    finish(): Promise<void>;
+}
+//# sourceMappingURL=DiscardAudioTrackBridge.d.ts.map

package/dist/modules/video/mediabunny/audio/DiscardAudioTrackBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscardAudioTrackBridge.d.ts","sourceRoot":"","sources":["../../../../../src/modules/video/mediabunny/audio/DiscardAudioTrackBridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AAEzF;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAExD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAGzB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAG1B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAE9B"}