webcodecs-node 0.3.0 → 0.5.0

package/dist/codec-utils/formats.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Codec format mappings
+ *
+ * Converts between WebCodecs formats and libav formats used by node-av.
+ */
+/**
+ * Map WebCodecs pixel format to libav pixel format
+ */
+export declare function pixelFormatToFFmpeg(format: string): string;
+/**
+ * Map libav pixel format to WebCodecs pixel format
+ */
+export declare function ffmpegToPixelFormat(format: string): string;
+/**
+ * Map WebCodecs codec string to libav encoder codec
+ */
+export declare function webCodecToFFmpegCodec(webCodec: string): string;
+/**
+ * Map WebCodecs codec to container format
+ */
+export declare function webCodecToContainerFormat(webCodec: string): string;
+/**
+ * Calculate frame size in bytes for a given pixel format and dimensions
+ */
+export declare function calculateFrameSize(format: string, width: number, height: number): number;
+/**
+ * MIME type to format mapping for ImageDecoder
+ */
+export declare const IMAGE_MIME_TO_FFMPEG: Record<string, {
+    format: string;
+    decoder?: string;
+    autoDetect?: boolean;
+}>;
+/**
+ * Audio codec mappings
+ */
+export declare const AUDIO_CODEC_MAP: Record<string, string>;
+/**
+ * Get libav audio codec from WebCodecs codec string
+ */
+export declare function webCodecToFFmpegAudioCodec(codec: string): string;
+//# sourceMappingURL=formats.d.ts.map

package/dist/codec-utils/formats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/codec-utils/formats.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAa1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAa1D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgB9D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgBlE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAkCxF;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,CAU3G,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CASlD,CAAC;AAEF;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhE"}

package/dist/codec-utils/formats.js

@@ -0,0 +1,147 @@
+/**
+ * Codec format mappings
+ *
+ * Converts between WebCodecs formats and libav formats used by node-av.
+ */
+/**
+ * Map WebCodecs pixel format to libav pixel format
+ */
+export function pixelFormatToFFmpeg(format) {
+    const formatMap = {
+        'I420': 'yuv420p',
+        'I420A': 'yuva420p',
+        'I422': 'yuv422p',
+        'I444': 'yuv444p',
+        'NV12': 'nv12',
+        'RGBA': 'rgba',
+        'RGBX': 'rgb0',
+        'BGRA': 'bgra',
+        'BGRX': 'bgr0',
+    };
+    return formatMap[format] || format.toLowerCase();
+}
+/**
+ * Map libav pixel format to WebCodecs pixel format
+ */
+export function ffmpegToPixelFormat(format) {
+    const formatMap = {
+        'yuv420p': 'I420',
+        'yuva420p': 'I420A',
+        'yuv422p': 'I422',
+        'yuv444p': 'I444',
+        'nv12': 'NV12',
+        'rgba': 'RGBA',
+        'rgb0': 'RGBX',
+        'bgra': 'BGRA',
+        'bgr0': 'BGRX',
+    };
+    return formatMap[format] || format.toUpperCase();
+}
+/**
+ * Map WebCodecs codec string to libav encoder codec
+ */
+export function webCodecToFFmpegCodec(webCodec) {
+    const codecBase = webCodec.split('.')[0].toLowerCase();
+    const codecMap = {
+        'avc1': 'libx264',
+        'avc3': 'libx264',
+        'hev1': 'libx265',
+        'hvc1': 'libx265',
+        'vp8': 'libvpx',
+        'vp09': 'libvpx-vp9',
+        'vp9': 'libvpx-vp9',
+        'av01': 'libaom-av1',
+        'av1': 'libaom-av1',
+    };
+    return codecMap[codecBase] || codecBase;
+}
+/**
+ * Map WebCodecs codec to container format
+ */
+export function webCodecToContainerFormat(webCodec) {
+    const codecBase = webCodec.split('.')[0].toLowerCase();
+    const formatMap = {
+        'avc1': 'h264',
+        'avc3': 'h264',
+        'hev1': 'hevc',
+        'hvc1': 'hevc',
+        'vp8': 'ivf',
+        'vp09': 'ivf',
+        'vp9': 'ivf',
+        'av01': 'ivf',
+        'av1': 'ivf',
+    };
+    return formatMap[codecBase] || 'rawvideo';
+}
+/**
+ * Calculate frame size in bytes for a given pixel format and dimensions
+ */
+export function calculateFrameSize(format, width, height) {
+    const chromaW = Math.ceil(width / 2);
+    const chromaH = Math.ceil(height / 2);
+    switch (format.toUpperCase()) {
+        case 'I420':
+        case 'YUV420P':
+            // Y: width * height, U: chromaW * chromaH, V: chromaW * chromaH
+            return width * height + 2 * chromaW * chromaH;
+        case 'I420A':
+        case 'YUVA420P':
+            // I420 + Alpha plane
+            return width * height * 2 + 2 * chromaW * chromaH;
+        case 'I422':
+        case 'YUV422P':
+            // Y: width * height, U: chromaW * height, V: chromaW * height
+            return width * height + 2 * chromaW * height;
+        case 'I444':
+        case 'YUV444P':
+            // Y, U, V all full size
+            return width * height * 3;
+        case 'NV12':
+            // Y: width * height, UV interleaved: width * chromaH
+            return width * height + width * chromaH;
+        case 'RGBA':
+        case 'RGBX':
+        case 'BGRA':
+        case 'BGRX':
+        case 'RGB0':
+        case 'BGR0':
+            return width * height * 4;
+        default:
+            return width * height * 4; // Assume RGBA as fallback
+    }
+}
+/**
+ * MIME type to format mapping for ImageDecoder
+ */
+export const IMAGE_MIME_TO_FFMPEG = {
+    'image/png': { format: 'png_pipe' },
+    'image/apng': { format: 'apng' },
+    'image/jpeg': { format: 'jpeg_pipe' },
+    'image/jpg': { format: 'jpeg_pipe' },
+    'image/webp': { format: 'webp_pipe', autoDetect: true },
+    'image/gif': { format: 'gif' },
+    'image/bmp': { format: 'bmp_pipe' },
+    'image/avif': { format: 'avif', autoDetect: true },
+    'image/tiff': { format: 'tiff_pipe' },
+};
+/**
+ * Audio codec mappings
+ */
+export const AUDIO_CODEC_MAP = {
+    'opus': 'libopus',
+    'aac': 'aac',
+    'mp3': 'libmp3lame',
+    'flac': 'flac',
+    'vorbis': 'libvorbis',
+    'pcm-s16': 'pcm_s16le',
+    'pcm-s32': 'pcm_s32le',
+    'pcm-f32': 'pcm_f32le',
+};
+/**
+ * Get libav audio codec from WebCodecs codec string
+ */
+export function webCodecToFFmpegAudioCodec(codec) {
+    const codecLower = codec.toLowerCase();
+    return AUDIO_CODEC_MAP[codecLower] || codecLower;
+}
+//# sourceMappingURL=formats.js.map

package/dist/codec-utils/formats.js.map

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

package/dist/codec-utils/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Codec utilities
+ *
+ * Provides codec and format mappings between WebCodecs and libav (node-av).
+ */
+export { type EncodedFrameData, type DecoderConfig, type EncoderConfig, type BitrateMode, type AlphaOption, DEFAULT_SHUTDOWN_TIMEOUT, DEFAULT_FLUSH_TIMEOUT, } from './types.js';
+export { pixelFormatToFFmpeg, ffmpegToPixelFormat, webCodecToFFmpegCodec, webCodecToContainerFormat, calculateFrameSize, webCodecToFFmpegAudioCodec, IMAGE_MIME_TO_FFMPEG, AUDIO_CODEC_MAP, } from './formats.js';
+export { AUDIO_ENCODER_CODEC_MAP, AUDIO_DECODER_CODEC_MAP, AUDIO_ENCODER_FORMAT_MAP, AUDIO_FRAME_SIZE_MAP, AUDIO_OUTPUT_FORMAT_MAP, getAudioEncoderCodec, getAudioDecoderInfo, getAudioEncoderFormat, getAudioFrameSize, getAudioOutputFormatSettings, type AudioFormatSettings, } from './audio-codecs.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/codec-utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codec-utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,EAC5B,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC"}

package/dist/codec-utils/index.js

@@ -0,0 +1,12 @@
+/**
+ * Codec utilities
+ *
+ * Provides codec and format mappings between WebCodecs and libav (node-av).
+ */
+// Types
+export { DEFAULT_SHUTDOWN_TIMEOUT, DEFAULT_FLUSH_TIMEOUT, } from './types.js';
+// Format mappings
+export { pixelFormatToFFmpeg, ffmpegToPixelFormat, webCodecToFFmpegCodec, webCodecToContainerFormat, calculateFrameSize, webCodecToFFmpegAudioCodec, IMAGE_MIME_TO_FFMPEG, AUDIO_CODEC_MAP, } from './formats.js';
+// Audio codec mappings
+export { AUDIO_ENCODER_CODEC_MAP, AUDIO_DECODER_CODEC_MAP, AUDIO_ENCODER_FORMAT_MAP, AUDIO_FRAME_SIZE_MAP, AUDIO_OUTPUT_FORMAT_MAP, getAudioEncoderCodec, getAudioDecoderInfo, getAudioEncoderFormat, getAudioFrameSize, getAudioOutputFormatSettings, } from './audio-codecs.js';
+//# sourceMappingURL=index.js.map

package/dist/codec-utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codec-utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,QAAQ;AACR,OAAO,EAML,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,kBAAkB;AAClB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,uBAAuB;AACvB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,4BAA4B,GAE7B,MAAM,mBAAmB,CAAC"}

package/dist/codec-utils/types.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Codec configuration types
+ *
+ * Configuration types for video and audio encoding/decoding.
+ */
+/**
+ * Codec configuration
+ */
+export interface CodecConfig {
+    input: CodecInputConfig;
+    output: CodecOutputConfig;
+}
+/**
+ * Input configuration
+ */
+export interface CodecInputConfig {
+    format: string;
+    codec?: string;
+    width?: number;
+    height?: number;
+    framerate?: number;
+    pixelFormat?: string;
+}
+/**
+ * Output configuration
+ */
+export interface CodecOutputConfig {
+    format: string;
+    codec?: string;
+    width?: number;
+    height?: number;
+    framerate?: number;
+    pixelFormat?: string;
+    bitrate?: number;
+}
+/**
+ * Encoded frame data emitted by parsers
+ */
+export interface EncodedFrameData {
+    data: Buffer;
+    timestamp: number;
+    keyFrame: boolean;
+}
+/**
+ * Decoder configuration
+ */
+export interface DecoderConfig {
+    codec: string;
+    width: number;
+    height: number;
+    outputPixelFormat?: string;
+    hardwareDecoderArgs?: string[];
+    hardwareDownloadFilter?: string;
+}
+/**
+ * Bitrate mode for encoding
+ * - 'constant': Constant bitrate (CBR) - predictable file size, may vary quality
+ * - 'variable': Variable bitrate (VBR) - better quality, less predictable size
+ * - 'quantizer': Fixed quality mode (CRF/CQ) - consistent quality, variable size
+ */
+export type BitrateMode = 'constant' | 'variable' | 'quantizer';
+/**
+ * Alpha channel handling mode
+ * - 'discard': Drop alpha channel (default, works with all codecs)
+ * - 'keep': Preserve alpha channel (only VP9 and AV1 support this)
+ */
+export type AlphaOption = 'discard' | 'keep';
+/**
+ * Encoder configuration
+ */
+export interface EncoderConfig {
+    codec: string;
+    width: number;
+    height: number;
+    inputPixelFormat?: string;
+    framerate?: number;
+    bitrate?: number;
+    bitrateMode?: BitrateMode;
+    latencyMode?: 'quality' | 'realtime';
+    alpha?: AlphaOption;
+    hardwareEncoderArgs?: string[];
+}
+/** Default timeout for graceful shutdown (ms) */
+export declare const DEFAULT_SHUTDOWN_TIMEOUT = 5000;
+/** Default timeout for flush operations (ms) */
+export declare const DEFAULT_FLUSH_TIMEOUT = 30000;
+//# sourceMappingURL=types.d.ts.map

package/dist/codec-utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/codec-utils/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,gBAAgB,CAAC;IACxB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IACrC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,iDAAiD;AACjD,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,gDAAgD;AAChD,eAAO,MAAM,qBAAqB,QAAQ,CAAC"}

package/dist/codec-utils/types.js

@@ -0,0 +1,10 @@
+/**
+ * Codec configuration types
+ *
+ * Configuration types for video and audio encoding/decoding.
+ */
+/** Default timeout for graceful shutdown (ms) */
+export const DEFAULT_SHUTDOWN_TIMEOUT = 5000;
+/** Default timeout for flush operations (ms) */
+export const DEFAULT_FLUSH_TIMEOUT = 30000;
+//# sourceMappingURL=types.js.map

package/dist/codec-utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/codec-utils/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuFH,iDAAiD;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,gDAAgD;AAChD,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC"}

package/dist/containers/Demuxer.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Container Demuxer - Extracts encoded chunks from container files (MP4, WebM, MKV)
+ *
+ * Wraps node-av's Demuxer to provide a WebCodecs-compatible interface that outputs
+ * EncodedVideoChunk and EncodedAudioChunk objects.
+ */
+import { Demuxer as NodeAvDemuxer } from 'node-av';
+import { EncodedVideoChunk } from '../core/EncodedVideoChunk.js';
+import { EncodedAudioChunk } from '../core/EncodedAudioChunk.js';
+/**
+ * Video stream configuration extracted from container
+ */
+export interface VideoStreamConfig {
+    codec: string;
+    codedWidth: number;
+    codedHeight: number;
+    description?: Uint8Array;
+}
+/**
+ * Audio stream configuration extracted from container
+ */
+export interface AudioStreamConfig {
+    codec: string;
+    sampleRate: number;
+    numberOfChannels: number;
+    description?: Uint8Array;
+}
+/**
+ * Demuxer configuration
+ */
+export interface DemuxerConfig {
+    /** Path to the input file */
+    path: string;
+}
+/**
+ * Callback types for demuxed chunks
+ */
+export type VideoChunkCallback = (chunk: EncodedVideoChunk, config: VideoStreamConfig) => void;
+export type AudioChunkCallback = (chunk: EncodedAudioChunk, config: AudioStreamConfig) => void;
+/**
+ * Container demuxer that outputs WebCodecs-compatible chunks
+ */
+export declare class Demuxer {
+    private demuxer;
+    private path;
+    private _videoConfig;
+    private _audioConfig;
+    private _videoStreamIndex;
+    private _audioStreamIndex;
+    private _videoTimeBase;
+    private _audioTimeBase;
+    constructor(config: DemuxerConfig);
+    /**
+     * Open the container file and parse stream information
+     */
+    open(timeout?: number): Promise<void>;
+    /**
+     * Get video stream configuration (null if no video stream)
+     */
+    get videoConfig(): VideoStreamConfig | null;
+    /**
+     * Get audio stream configuration (null if no audio stream)
+     */
+    get audioConfig(): AudioStreamConfig | null;
+    /**
+     * Get container format name (e.g., "mp4", "webm")
+     */
+    get format(): string | undefined;
+    /**
+     * Get duration in seconds
+     */
+    get duration(): number | undefined;
+    /**
+     * Convert timestamp from stream time base to microseconds
+     */
+    private toMicroseconds;
+    /**
+     * Iterate over video chunks
+     */
+    videoChunks(): AsyncGenerator<EncodedVideoChunk>;
+    /**
+     * Iterate over audio chunks
+     */
+    audioChunks(): AsyncGenerator<EncodedAudioChunk>;
+    /**
+     * Iterate over all chunks (video and audio interleaved)
+     * Returns both the chunk and its type/config for proper routing
+     */
+    chunks(): AsyncGenerator<{
+        type: 'video';
+        chunk: EncodedVideoChunk;
+        config: VideoStreamConfig;
+    } | {
+        type: 'audio';
+        chunk: EncodedAudioChunk;
+        config: AudioStreamConfig;
+    }>;
+    /**
+     * Demux all chunks with callbacks (alternative API)
+     */
+    demux(options: {
+        onVideoChunk?: VideoChunkCallback;
+        onAudioChunk?: AudioChunkCallback;
+    }): Promise<void>;
+    /**
+     * Close the demuxer and release resources
+     */
+    close(): Promise<void>;
+    /**
+     * Get the underlying node-av demuxer (for advanced use)
+     */
+    get native(): NodeAvDemuxer | null;
+}
+//# sourceMappingURL=Demuxer.d.ts.map

package/dist/containers/Demuxer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Demuxer.d.ts","sourceRoot":"","sources":["../../src/containers/Demuxer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAA8B,MAAM,8BAA8B,CAAC;AAC7F,OAAO,EAAE,iBAAiB,EAA8B,MAAM,8BAA8B,CAAC;AAG7F;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAC/F,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;AA+C/F;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,cAAc,CAA6C;gBAEvD,MAAM,EAAE,aAAa;IAIjC;;OAEG;IACG,IAAI,CAAC,OAAO,GAAE,MAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;IA4ClE;;OAEG;IACH,IAAI,WAAW,IAAI,iBAAiB,GAAG,IAAI,CAE1C;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,iBAAiB,GAAG,IAAI,CAE1C;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAE/B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACI,WAAW,IAAI,cAAc,CAAC,iBAAiB,CAAC;IAyBvD;;OAEG;IACI,WAAW,IAAI,cAAc,CAAC,iBAAiB,CAAC;IAyBvD;;;OAGG;IACI,MAAM,IAAI,cAAc,CAC3B;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,iBAAiB,CAAC;QAAC,MAAM,EAAE,iBAAiB,CAAA;KAAE,GACtE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,iBAAiB,CAAC;QAAC,MAAM,EAAE,iBAAiB,CAAA;KAAE,CACzE;IAuCD;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE;QACnB,YAAY,CAAC,EAAE,kBAAkB,CAAC;QAClC,YAAY,CAAC,EAAE,kBAAkB,CAAC;KACnC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;OAEG;IACH,IAAI,MAAM,IAAI,aAAa,GAAG,IAAI,CAEjC;CACF"}