webcodecs-node 0.7.5 → 0.8.5

package/dist/backends/node-av/video/NodeAvVideoEncoder.js

@@ -0,0 +1,317 @@
+/**
+ * NodeAvVideoEncoder - Video encoder using node-av native bindings
+ *
+ * Implements the VideoEncoderBackend interface for encoding video frames
+ * using FFmpeg's libav* libraries via node-av.
+ */
+import { EventEmitter } from 'events';
+import { Encoder } from 'node-av/api';
+import { Frame, Rational } from 'node-av/lib';
+import { AV_PIX_FMT_YUV420P, AV_PICTURE_TYPE_I, } from 'node-av/constants';
+import { DEFAULT_FRAMERATE } from '../../types.js';
+import { parseCodecString } from '../../../hardware/index.js';
+import { createLogger } from '../../../utils/logger.js';
+import { releaseHardwareContext } from '../../../utils/hardware-pool.js';
+// Import from encoder submodule
+import { mapPixelFormat, buildEncoderOptions, microsecondsToPts, getCodecTimeBase, selectEncoderCodec, fallbackToSoftware, configureEncoderPixelFormat, createEncoderFilter, createCpuFallbackFilter, drainEncoderPackets, } from './encoder/index.js';
+const logger = createLogger('NodeAvVideoEncoder');
+/**
+ * NodeAV-backed video encoder implementing VideoEncoderBackend interface
+ */
+export class NodeAvVideoEncoder extends EventEmitter {
+    encoder = null;
+    hardware = null;
+    filter = null;
+    config = null;
+    frameIndex = 0;
+    queue = [];
+    processing = false;
+    processingPromise = null;
+    shuttingDown = false;
+    inputPixelFormat = AV_PIX_FMT_YUV420P;
+    encoderPixelFormat = AV_PIX_FMT_YUV420P;
+    timeBase = new Rational(1, DEFAULT_FRAMERATE);
+    codecDescription = null;
+    isHevcCodec = false;
+    isAvcCodec = false;
+    needsFormatConversion = false;
+    needsRescaling = false;
+    outputFormat = 'mp4';
+    targetFormatName = 'yuv420p';
+    get isHealthy() {
+        return !this.shuttingDown;
+    }
+    startEncoder(config) {
+        this.config = { ...config };
+        this.inputPixelFormat = mapPixelFormat(config.inputPixelFormat || 'yuv420p');
+        this.outputFormat = config.format ?? 'mp4';
+        // Log HDR metadata presence
+        if (config.colorSpace?.hdrMetadata) {
+            logger.info(`HDR metadata provided (primaries=${config.colorSpace.primaries}, transfer=${config.colorSpace.transfer})`);
+            logger.warn('HDR side data (mastering display, content light level) not yet wired to encoder context');
+        }
+    }
+    write(data, timestamp, keyFrame) {
+        if (!this.config || this.shuttingDown) {
+            return false;
+        }
+        const buffer = Buffer.isBuffer(data) ? data : Buffer.from(data);
+        this.queue.push({ buffer, owned: true, timestamp: timestamp ?? 0, keyFrame });
+        void this.processQueue();
+        return true;
+    }
+    writeFrame(frame, timestamp, keyFrame) {
+        if (!this.config || this.shuttingDown) {
+            return false;
+        }
+        this.queue.push({ frame, owned: false, timestamp: timestamp ?? 0, keyFrame });
+        void this.processQueue();
+        return true;
+    }
+    end() {
+        if (this.shuttingDown)
+            return;
+        this.shuttingDown = true;
+        void this.finish().catch((err) => this.emit('error', err));
+    }
+    kill() {
+        this.shuttingDown = true;
+        this.cleanup();
+        this.emit('close', null);
+    }
+    async shutdown() {
+        this.end();
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Private methods
+    // ─────────────────────────────────────────────────────────────────────────────
+    async processQueue() {
+        if (this.processingPromise) {
+            return this.processingPromise;
+        }
+        this.processingPromise = (async () => {
+            if (this.processing)
+                return;
+            this.processing = true;
+            try {
+                while (this.queue.length > 0) {
+                    const item = this.queue.shift();
+                    setImmediate(() => this.emit('frameAccepted'));
+                    if (item.frame) {
+                        await this.encodeFrame(item.frame, item.owned ?? true, item.timestamp, item.keyFrame);
+                    }
+                    else if (item.buffer) {
+                        await this.encodeBuffer(item.buffer, item.timestamp, item.keyFrame);
+                    }
+                }
+            }
+            catch (err) {
+                this.emit('error', err instanceof Error ? err : new Error(String(err)));
+            }
+            finally {
+                this.processing = false;
+                this.processingPromise = null;
+            }
+        })();
+        return this.processingPromise;
+    }
+    async ensureEncoder() {
+        if (this.encoder || !this.config) {
+            return;
+        }
+        const codecName = parseCodecString(this.config.codec) ?? 'h264';
+        this.isHevcCodec = codecName === 'hevc';
+        this.isAvcCodec = codecName === 'h264';
+        const framerate = this.config.framerate ?? DEFAULT_FRAMERATE;
+        // Get appropriate timebase for codec
+        this.timeBase = getCodecTimeBase(codecName, framerate, Rational);
+        // Select encoder codec (hardware or software)
+        const selection = await selectEncoderCodec(codecName, this.config.width, this.config.height, this.config.hardwareAcceleration);
+        this.hardware = selection.hardware;
+        // Configure pixel format based on input and codec capabilities
+        const inputHasAlpha = this.config.alpha === 'keep';
+        const pixelConfig = configureEncoderPixelFormat(this.inputPixelFormat, codecName, selection.isHardware, inputHasAlpha);
+        this.encoderPixelFormat = pixelConfig.encoderPixelFormat;
+        this.needsFormatConversion = pixelConfig.needsFormatConversion;
+        this.targetFormatName = pixelConfig.targetFormatName;
+        // Check if rescaling is needed
+        const inputWidth = this.config.inputWidth ?? this.config.width;
+        const inputHeight = this.config.inputHeight ?? this.config.height;
+        this.needsRescaling = inputWidth !== this.config.width || inputHeight !== this.config.height;
+        // Build encoder options
+        const options = buildEncoderOptions(this.config, codecName, this.inputPixelFormat, this.timeBase, this.hardware);
+        options.pixelFormat = this.encoderPixelFormat;
+        // Create filter chain if needed
+        if (this.needsFormatConversion || this.needsRescaling) {
+            const filterConfig = {
+                targetFormat: this.targetFormatName,
+                inputWidth,
+                inputHeight,
+                outputWidth: this.config.width,
+                outputHeight: this.config.height,
+                needsRescaling: this.needsRescaling,
+                needsFormatConversion: this.needsFormatConversion,
+            };
+            this.filter = createEncoderFilter(filterConfig, this.hardware);
+        }
+        logger.debug(`Encoder options: ${JSON.stringify(options.options)}, bitrate=${options.bitrate}`);
+        try {
+            this.encoder = await Encoder.create(selection.encoderCodec, options);
+            logger.info(`Created encoder: ${selection.encoderCodec}`);
+        }
+        catch (hwErr) {
+            if (selection.isHardware) {
+                logger.warn(`Hardware encoder failed, falling back to software: ${hwErr.message}`);
+                const fallback = fallbackToSoftware(codecName, this.hardware);
+                this.hardware = fallback.hardware;
+                this.encoderPixelFormat = AV_PIX_FMT_YUV420P;
+                options.pixelFormat = AV_PIX_FMT_YUV420P;
+                options.hardware = undefined;
+                this.encoder = await Encoder.create(fallback.encoderCodec, options);
+                logger.info(`Using software encoder: ${fallback.encoderCodec}`);
+            }
+            else {
+                throw hwErr;
+            }
+        }
+    }
+    async encodeBuffer(buffer, timestamp, keyFrame) {
+        await this.ensureEncoder();
+        if (!this.encoder || !this.config) {
+            throw new Error('Encoder not initialized');
+        }
+        const frame = await this.createFrame(buffer, true);
+        frame.pts = microsecondsToPts(timestamp, this.timeBase);
+        if (keyFrame) {
+            frame.pictType = AV_PICTURE_TYPE_I;
+        }
+        await this.encoder.encode(frame);
+        frame.unref();
+        await this.drainPackets();
+        this.frameIndex++;
+    }
+    async encodeFrame(inputFrame, owned, timestamp, keyFrame) {
+        await this.ensureEncoder();
+        if (!this.encoder || !this.config) {
+            throw new Error('Encoder not initialized');
+        }
+        const frame = await this.createFrame(inputFrame, owned);
+        frame.pts = microsecondsToPts(timestamp, this.timeBase);
+        if (keyFrame) {
+            frame.pictType = AV_PICTURE_TYPE_I;
+        }
+        await this.encoder.encode(frame);
+        if (owned || frame !== inputFrame) {
+            frame.unref();
+        }
+        await this.drainPackets();
+        this.frameIndex++;
+    }
+    async createFrame(source, ownInput) {
+        const inputWidth = this.config.inputWidth ?? this.config.width;
+        const inputHeight = this.config.inputHeight ?? this.config.height;
+        const inputFrame = source instanceof Frame
+            ? source
+            : Frame.fromVideoBuffer(source, {
+                width: inputWidth,
+                height: inputHeight,
+                format: this.inputPixelFormat,
+                timeBase: this.timeBase,
+            });
+        if ((!this.needsFormatConversion && !this.needsRescaling) || !this.filter) {
+            return inputFrame;
+        }
+        try {
+            await this.filter.process(inputFrame);
+            if (ownInput) {
+                inputFrame.unref();
+            }
+            const convertedFrame = await this.filter.receive();
+            if (!convertedFrame) {
+                throw new Error('Format conversion failed: no output from filter');
+            }
+            return convertedFrame;
+        }
+        catch (err) {
+            logger.warn(`Filter processing failed, falling back to CPU: ${err.message}`);
+            if (ownInput) {
+                inputFrame.unref();
+            }
+            // Create CPU fallback filter
+            this.filter.close();
+            const filterConfig = {
+                targetFormat: this.targetFormatName,
+                inputWidth,
+                inputHeight,
+                outputWidth: this.config.width,
+                outputHeight: this.config.height,
+                needsRescaling: this.needsRescaling,
+                needsFormatConversion: this.needsFormatConversion,
+            };
+            this.filter = createCpuFallbackFilter(filterConfig);
+            const retryFrame = source instanceof Frame
+                ? source
+                : Frame.fromVideoBuffer(source, {
+                    width: inputWidth,
+                    height: inputHeight,
+                    format: this.inputPixelFormat,
+                    timeBase: this.timeBase,
+                });
+            await this.filter.process(retryFrame);
+            if (ownInput || retryFrame !== source) {
+                retryFrame.unref();
+            }
+            const convertedFrame = await this.filter.receive();
+            if (!convertedFrame) {
+                throw new Error('CPU filter processing failed: no output from filter');
+            }
+            return convertedFrame;
+        }
+    }
+    async drainPackets() {
+        if (!this.encoder)
+            return;
+        const result = await drainEncoderPackets(this.encoder, {
+            codecDescription: this.codecDescription,
+            isAvcCodec: this.isAvcCodec,
+            isHevcCodec: this.isHevcCodec,
+            outputFormat: this.outputFormat,
+            frameIndex: this.frameIndex,
+        });
+        // Update codec description if extracted
+        if (result.codecDescription) {
+            this.codecDescription = result.codecDescription;
+        }
+        // Emit all encoded frames
+        for (const frame of result.frames) {
+            this.emit('encodedFrame', frame);
+        }
+    }
+    async finish() {
+        await this.processQueue();
+        if (this.processingPromise) {
+            await this.processingPromise;
+        }
+        if (this.encoder) {
+            try {
+                await this.encoder.flush();
+                await this.drainPackets();
+            }
+            catch (err) {
+                this.emit('error', err instanceof Error ? err : new Error(String(err)));
+            }
+        }
+        this.emit('close', 0);
+        this.cleanup();
+    }
+    cleanup() {
+        this.filter?.close();
+        this.filter = null;
+        this.encoder?.close();
+        this.encoder = null;
+        releaseHardwareContext(this.hardware);
+        this.hardware = null;
+        this.queue = [];
+    }
+}
+//# sourceMappingURL=NodeAvVideoEncoder.js.map

package/dist/backends/node-av/video/NodeAvVideoEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeAvVideoEncoder.js","sourceRoot":"","sources":["../../../../src/backends/node-av/video/NodeAvVideoEncoder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,OAAO,EAAmC,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAElB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,gCAAgC;AAChC,OAAO,EACL,cAAc,EAEd,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,GAEpB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAC1C,OAAO,GAAmB,IAAI,CAAC;IAC/B,QAAQ,GAA2B,IAAI,CAAC;IACxC,MAAM,GAAqB,IAAI,CAAC;IAChC,MAAM,GAAqC,IAAI,CAAC;IAChD,UAAU,GAAG,CAAC,CAAC;IACf,KAAK,GAAsG,EAAE,CAAC;IAC9G,UAAU,GAAG,KAAK,CAAC;IACnB,iBAAiB,GAAyB,IAAI,CAAC;IAC/C,YAAY,GAAG,KAAK,CAAC;IACrB,gBAAgB,GAAkB,kBAAkB,CAAC;IACrD,kBAAkB,GAAkB,kBAAkB,CAAC;IACvD,QAAQ,GAAa,IAAI,QAAQ,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACxD,gBAAgB,GAAkB,IAAI,CAAC;IACvC,WAAW,GAAG,KAAK,CAAC;IACpB,UAAU,GAAG,KAAK,CAAC;IACnB,qBAAqB,GAAG,KAAK,CAAC;IAC9B,cAAc,GAAG,KAAK,CAAC;IACvB,YAAY,GAAqB,KAAK,CAAC;IACvC,gBAAgB,GAAG,SAAS,CAAC;IAErC,IAAI,SAAS;QACX,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;IAC5B,CAAC;IAED,YAAY,CAAC,MAAiC;QAC5C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;QAC5B,IAAI,CAAC,gBAAgB,GAAG,cAAc,CAAC,MAAM,CAAC,gBAAgB,IAAI,SAAS,CAAC,CAAC;QAC7E,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC;QAE3C,4BAA4B;QAC5B,IAAI,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,oCAAoC,MAAM,CAAC,UAAU,CAAC,SAAS,cAAc,MAAM,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC,CAAC;YACxH,MAAM,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAC;QACzG,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAyB,EAAE,SAAkB,EAAE,QAAkB;QACrE,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9E,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU,CAAC,KAAY,EAAE,SAAkB,EAAE,QAAkB;QAC7D,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9E,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG;QACD,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI;QACF,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,GAAG,EAAE,CAAC;IACb,CAAC;IAED,gFAAgF;IAChF,kBAAkB;IAClB,gFAAgF;IAExE,KAAK,CAAC,YAAY;QACxB,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,iBAAiB,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,iBAAiB,GAAG,CAAC,KAAK,IAAI,EAAE;YACnC,IAAI,IAAI,CAAC,UAAU;gBAAE,OAAO;YAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YAEvB,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC;oBACjC,YAAY,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;oBAC/C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;wBACf,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACxF,CAAC;yBAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;wBACvB,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACtE,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC1E,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;gBACxB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC;QAChE,IAAI,CAAC,WAAW,GAAG,SAAS,KAAK,MAAM,CAAC;QACxC,IAAI,CAAC,UAAU,GAAG,SAAS,KAAK,MAAM,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,iBAAiB,CAAC;QAE7D,qCAAqC;QACrC,IAAI,CAAC,QAAQ,GAAG,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEjE,8CAA8C;QAC9C,MAAM,SAAS,GAAG,MAAM,kBAAkB,CACxC,SAAS,EACT,IAAI,CAAC,MAAM,CAAC,KAAK,EACjB,IAAI,CAAC,MAAM,CAAC,MAAM,EAClB,IAAI,CAAC,MAAM,CAAC,oBAAoB,CACjC,CAAC;QACF,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;QAEnC,+DAA+D;QAC/D,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC;QACnD,MAAM,WAAW,GAAG,2BAA2B,CAC7C,IAAI,CAAC,gBAAgB,EACrB,SAAS,EACT,SAAS,CAAC,UAAU,EACpB,aAAa,CACd,CAAC;QACF,IAAI,CAAC,kBAAkB,GAAG,WAAW,CAAC,kBAAkB,CAAC;QACzD,IAAI,CAAC,qBAAqB,GAAG,WAAW,CAAC,qBAAqB,CAAC;QAC/D,IAAI,CAAC,gBAAgB,GAAG,WAAW,CAAC,gBAAgB,CAAC;QAErD,+BAA+B;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAClE,IAAI,CAAC,cAAc,GAAG,UAAU,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,WAAW,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAE7F,wBAAwB;QACxB,MAAM,OAAO,GAAG,mBAAmB,CACjC,IAAI,CAAC,MAAM,EACX,SAAS,EACT,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,QAAQ,CACd,CAAC;QACF,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC;QAE9C,gCAAgC;QAChC,IAAI,IAAI,CAAC,qBAAqB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACtD,MAAM,YAAY,GAAiB;gBACjC,YAAY,EAAE,IAAI,CAAC,gBAAgB;gBACnC,UAAU;gBACV,WAAW;gBACX,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;gBAC9B,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBAChC,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;aAClD,CAAC;YACF,IAAI,CAAC,MAAM,GAAG,mBAAmB,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAEhG,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC,oBAAoB,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;gBACzB,MAAM,CAAC,IAAI,CAAC,sDAAuD,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC9F,MAAM,QAAQ,GAAG,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC9D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;gBAElC,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;gBAC7C,OAAO,CAAC,WAAW,GAAG,kBAAkB,CAAC;gBACzC,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;gBAC7B,IAAI,CAAC,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBACpE,MAAM,CAAC,IAAI,CAAC,2BAA2B,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;YAClE,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,SAAiB,EAAE,QAAkB;QAC9E,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACnD,KAAK,CAAC,GAAG,GAAG,iBAAiB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAExD,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,CAAC,QAAQ,GAAG,iBAAiB,CAAC;QACrC,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,KAAK,CAAC,KAAK,EAAE,CAAC;QAEd,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,UAAiB,EAAE,KAAc,EAAE,SAAiB,EAAE,QAAkB;QAChG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACxD,KAAK,CAAC,GAAG,GAAG,iBAAiB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAExD,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,CAAC,QAAQ,GAAG,iBAAiB,CAAC;QACrC,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,KAAK,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YAClC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;QAED,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,MAAsB,EAAE,QAAiB;QACjE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAO,CAAC,UAAU,IAAI,IAAI,CAAC,MAAO,CAAC,KAAK,CAAC;QACjE,MAAM,WAAW,GAAG,IAAI,CAAC,MAAO,CAAC,WAAW,IAAI,IAAI,CAAC,MAAO,CAAC,MAAM,CAAC;QAEpE,MAAM,UAAU,GAAG,MAAM,YAAY,KAAK;YACxC,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,EAAE;gBAC9B,KAAK,EAAE,UAAU;gBACjB,MAAM,EAAE,WAAW;gBACnB,MAAM,EAAE,IAAI,CAAC,gBAAgB;gBAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;QAEL,IAAI,CAAC,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1E,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACtC,IAAI,QAAQ,EAAE,CAAC;gBACb,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;YAED,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACnD,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACrE,CAAC;YAED,OAAO,cAAc,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,kDAAmD,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACxF,IAAI,QAAQ,EAAE,CAAC;gBACb,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;YAED,6BAA6B;YAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACpB,MAAM,YAAY,GAAiB;gBACjC,YAAY,EAAE,IAAI,CAAC,gBAAgB;gBACnC,UAAU;gBACV,WAAW;gBACX,WAAW,EAAE,IAAI,CAAC,MAAO,CAAC,KAAK;gBAC/B,YAAY,EAAE,IAAI,CAAC,MAAO,CAAC,MAAM;gBACjC,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;aAClD,CAAC;YACF,IAAI,CAAC,MAAM,GAAG,uBAAuB,CAAC,YAAY,CAAC,CAAC;YAEpD,MAAM,UAAU,GAAG,MAAM,YAAY,KAAK;gBACxC,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,EAAE;oBAC9B,KAAK,EAAE,UAAU;oBACjB,MAAM,EAAE,WAAW;oBACnB,MAAM,EAAE,IAAI,CAAC,gBAAgB;oBAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;iBACxB,CAAC,CAAC;YAEL,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACtC,IAAI,QAAQ,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;gBACtC,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;YAED,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACnD,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;YACzE,CAAC;YAED,OAAO,cAAc,CAAC;QACxB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE;YACrD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;QAEH,wCAAwC;QACxC,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5B,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,CAAC;QAClD,CAAC;QAED,0BAA0B;QAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,MAAM;QAClB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,iBAAiB,CAAC;QAC/B,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC3B,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YAC5B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/backends/node-av/video/decoder/codec-mapping.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Codec ID mapping utilities for video decoding
+ */
+import { type AVCodecID } from 'node-av/constants';
+/**
+ * Map codec string to FFmpeg AVCodecID
+ */
+export declare function mapCodecId(codec: string): AVCodecID | null;
+//# sourceMappingURL=codec-mapping.d.ts.map

package/dist/backends/node-av/video/decoder/codec-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-mapping.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/decoder/codec-mapping.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAML,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAgB1D"}

package/dist/backends/node-av/video/decoder/codec-mapping.js

@@ -0,0 +1,25 @@
+/**
+ * Codec ID mapping utilities for video decoding
+ */
+import { AV_CODEC_ID_H264, AV_CODEC_ID_HEVC, AV_CODEC_ID_VP8, AV_CODEC_ID_VP9, AV_CODEC_ID_AV1, } from 'node-av/constants';
+/**
+ * Map codec string to FFmpeg AVCodecID
+ */
+export function mapCodecId(codec) {
+    switch (codec.toLowerCase()) {
+        case 'h264':
+            return AV_CODEC_ID_H264;
+        case 'hevc':
+        case 'h265':
+            return AV_CODEC_ID_HEVC;
+        case 'vp8':
+            return AV_CODEC_ID_VP8;
+        case 'vp9':
+            return AV_CODEC_ID_VP9;
+        case 'av1':
+            return AV_CODEC_ID_AV1;
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=codec-mapping.js.map

package/dist/backends/node-av/video/decoder/codec-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-mapping.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/decoder/codec-mapping.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,GAEhB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,QAAQ,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5B,KAAK,MAAM;YACT,OAAO,gBAAgB,CAAC;QAC1B,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,gBAAgB,CAAC;QAC1B,KAAK,KAAK;YACR,OAAO,eAAe,CAAC;QACzB,KAAK,KAAK;YACR,OAAO,eAAe,CAAC;QACzB,KAAK,KAAK;YACR,OAAO,eAAe,CAAC;QACzB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/backends/node-av/video/decoder/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Video decoder constants
+ */
+/** Maximum filter chain fallback attempts */
+export declare const MAX_FILTER_CHAIN_ATTEMPTS = 10;
+/**
+ * Codecs to skip for hardware decoding.
+ * Empty by default - hardware decoding is attempted for all codecs when requested.
+ * Can be populated if specific codecs are known to fail on certain hardware.
+ * Previously VP9/AV1 were skipped, but modern VAAPI/QSV support these well.
+ */
+export declare const SKIP_HARDWARE_CODECS: string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/backends/node-av/video/decoder/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/decoder/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6CAA6C;AAC7C,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,EAAO,CAAC"}

package/dist/backends/node-av/video/decoder/constants.js

@@ -0,0 +1,13 @@
+/**
+ * Video decoder constants
+ */
+/** Maximum filter chain fallback attempts */
+export const MAX_FILTER_CHAIN_ATTEMPTS = 10;
+/**
+ * Codecs to skip for hardware decoding.
+ * Empty by default - hardware decoding is attempted for all codecs when requested.
+ * Can be populated if specific codecs are known to fail on certain hardware.
+ * Previously VP9/AV1 were skipped, but modern VAAPI/QSV support these well.
+ */
+export const SKIP_HARDWARE_CODECS = [];
+//# sourceMappingURL=constants.js.map

package/dist/backends/node-av/video/decoder/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/decoder/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6CAA6C;AAC7C,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAa,EAAE,CAAC"}

package/dist/backends/node-av/video/decoder/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Video decoder helper utilities
+ */
+export { MAX_FILTER_CHAIN_ATTEMPTS, SKIP_HARDWARE_CODECS } from './constants.js';
+export { mapCodecId } from './codec-mapping.js';
+export { mapPixelFormat, pixelFormatToFFmpegName } from './pixel-format.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backends/node-av/video/decoder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/decoder/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/backends/node-av/video/decoder/index.js

@@ -0,0 +1,7 @@
+/**
+ * Video decoder helper utilities
+ */
+export { MAX_FILTER_CHAIN_ATTEMPTS, SKIP_HARDWARE_CODECS } from './constants.js';
+export { mapCodecId } from './codec-mapping.js';
+export { mapPixelFormat, pixelFormatToFFmpegName } from './pixel-format.js';
+//# sourceMappingURL=index.js.map

package/dist/backends/node-av/video/decoder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/decoder/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/backends/node-av/video/decoder/pixel-format.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Pixel format mapping utilities for video decoding
+ */
+import { type AVPixelFormat } from 'node-av/constants';
+/**
+ * Map WebCodecs pixel format string to AVPixelFormat
+ */
+export declare function mapPixelFormat(format: string): AVPixelFormat;
+/**
+ * Map AVPixelFormat to FFmpeg format name string
+ */
+export declare function pixelFormatToFFmpegName(fmt: AVPixelFormat): string;
+//# sourceMappingURL=pixel-format.d.ts.map

package/dist/backends/node-av/video/decoder/pixel-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel-format.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/decoder/pixel-format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAcL,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CA4C5D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA+BlE"}

package/dist/backends/node-av/video/decoder/pixel-format.js

@@ -0,0 +1,88 @@
+/**
+ * Pixel format mapping utilities for video decoding
+ */
+import { AV_PIX_FMT_BGRA, AV_PIX_FMT_BGR0, AV_PIX_FMT_NV12, AV_PIX_FMT_RGBA, AV_PIX_FMT_RGB0, AV_PIX_FMT_YUV420P, AV_PIX_FMT_YUV422P, AV_PIX_FMT_YUV444P, AV_PIX_FMT_YUVA420P, AV_PIX_FMT_YUV420P10LE, AV_PIX_FMT_YUV422P10LE, AV_PIX_FMT_YUV444P10LE, AV_PIX_FMT_P010LE, } from 'node-av/constants';
+/**
+ * Map WebCodecs pixel format string to AVPixelFormat
+ */
+export function mapPixelFormat(format) {
+    const fmt = format.toUpperCase();
+    switch (fmt) {
+        case 'I420':
+        case 'YUV420P':
+            return AV_PIX_FMT_YUV420P;
+        case 'I420A':
+        case 'YUVA420P':
+            return AV_PIX_FMT_YUVA420P;
+        case 'I422':
+        case 'YUV422P':
+            return AV_PIX_FMT_YUV422P;
+        case 'I444':
+        case 'YUV444P':
+            return AV_PIX_FMT_YUV444P;
+        case 'NV12':
+            return AV_PIX_FMT_NV12;
+        case 'BGRA':
+            return AV_PIX_FMT_BGRA;
+        case 'BGRX':
+            return AV_PIX_FMT_BGR0;
+        case 'RGBA':
+            return AV_PIX_FMT_RGBA;
+        case 'RGBX':
+            return AV_PIX_FMT_RGB0;
+        // 10-bit formats
+        case 'I420P10':
+        case 'YUV420P10LE':
+        case 'YUV420P10':
+            return AV_PIX_FMT_YUV420P10LE;
+        case 'I422P10':
+        case 'YUV422P10LE':
+        case 'YUV422P10':
+            return AV_PIX_FMT_YUV422P10LE;
+        case 'I444P10':
+        case 'YUV444P10LE':
+        case 'YUV444P10':
+            return AV_PIX_FMT_YUV444P10LE;
+        case 'P010':
+        case 'P010LE':
+            return AV_PIX_FMT_P010LE;
+        default:
+            return AV_PIX_FMT_YUV420P;
+    }
+}
+/**
+ * Map AVPixelFormat to FFmpeg format name string
+ */
+export function pixelFormatToFFmpegName(fmt) {
+    switch (fmt) {
+        case AV_PIX_FMT_BGRA:
+            return 'bgra';
+        case AV_PIX_FMT_BGR0:
+            return 'bgr0';
+        case AV_PIX_FMT_RGBA:
+            return 'rgba';
+        case AV_PIX_FMT_RGB0:
+            return 'rgb0';
+        case AV_PIX_FMT_NV12:
+            return 'nv12';
+        case AV_PIX_FMT_YUV422P:
+            return 'yuv422p';
+        case AV_PIX_FMT_YUV444P:
+            return 'yuv444p';
+        case AV_PIX_FMT_YUVA420P:
+            return 'yuva420p';
+        // 10-bit formats
+        case AV_PIX_FMT_YUV420P10LE:
+            return 'yuv420p10le';
+        case AV_PIX_FMT_YUV422P10LE:
+            return 'yuv422p10le';
+        case AV_PIX_FMT_YUV444P10LE:
+            return 'yuv444p10le';
+        case AV_PIX_FMT_P010LE:
+            return 'p010le';
+        case AV_PIX_FMT_YUV420P:
+        default:
+            return 'yuv420p';
+    }
+}
+//# sourceMappingURL=pixel-format.js.map

package/dist/backends/node-av/video/decoder/pixel-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixel-format.js","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/decoder/pixel-format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,GAElB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACjC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS;YACZ,OAAO,kBAAkB,CAAC;QAC5B,KAAK,OAAO,CAAC;QACb,KAAK,UAAU;YACb,OAAO,mBAAmB,CAAC;QAC7B,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS;YACZ,OAAO,kBAAkB,CAAC;QAC5B,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS;YACZ,OAAO,kBAAkB,CAAC;QAC5B,KAAK,MAAM;YACT,OAAO,eAAe,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,eAAe,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,eAAe,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,eAAe,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,eAAe,CAAC;QACzB,iBAAiB;QACjB,KAAK,SAAS,CAAC;QACf,KAAK,aAAa,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,sBAAsB,CAAC;QAChC,KAAK,SAAS,CAAC;QACf,KAAK,aAAa,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,sBAAsB,CAAC;QAChC,KAAK,SAAS,CAAC;QACf,KAAK,aAAa,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,sBAAsB,CAAC;QAChC,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,iBAAiB,CAAC;QAC3B;YACE,OAAO,kBAAkB,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAkB;IACxD,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,eAAe;YAClB,OAAO,MAAM,CAAC;QAChB,KAAK,eAAe;YAClB,OAAO,MAAM,CAAC;QAChB,KAAK,eAAe;YAClB,OAAO,MAAM,CAAC;QAChB,KAAK,eAAe;YAClB,OAAO,MAAM,CAAC;QAChB,KAAK,eAAe;YAClB,OAAO,MAAM,CAAC;QAChB,KAAK,kBAAkB;YACrB,OAAO,SAAS,CAAC;QACnB,KAAK,kBAAkB;YACrB,OAAO,SAAS,CAAC;QACnB,KAAK,mBAAmB;YACtB,OAAO,UAAU,CAAC;QACpB,iBAAiB;QACjB,KAAK,sBAAsB;YACzB,OAAO,aAAa,CAAC;QACvB,KAAK,sBAAsB;YACzB,OAAO,aAAa,CAAC;QACvB,KAAK,sBAAsB;YACzB,OAAO,aAAa,CAAC;QACvB,KAAK,iBAAiB;YACpB,OAAO,QAAQ,CAAC;QAClB,KAAK,kBAAkB,CAAC;QACxB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/backends/node-av/video/encoder/codec-description.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Codec description utilities for H.264/HEVC
+ *
+ * Handles extraction of parameter sets (SPS/PPS/VPS) from encoded packets
+ * and builds decoder configuration records (AVCC/HVCC) for MP4 containers.
+ */
+export interface CodecDescriptionResult {
+    /** The codec description (AVCC for H.264, HVCC for HEVC) */
+    description: Buffer | null;
+    /** The frame data (possibly converted to length-prefixed format) */
+    frameData: Buffer;
+}
+/**
+ * Process H.264 packet: extract AVCC description and convert to length-prefixed format
+ */
+export declare function processAvcPacket(packetData: Buffer | Uint8Array, isKeyFrame: boolean, existingDescription: Buffer | null, outputFormat: 'annexb' | 'mp4'): CodecDescriptionResult;
+/**
+ * Process HEVC packet: extract HVCC description and convert to length-prefixed format
+ */
+export declare function processHevcPacket(packetData: Buffer | Uint8Array, isKeyFrame: boolean, existingDescription: Buffer | null, outputFormat: 'annexb' | 'mp4'): CodecDescriptionResult;
+/**
+ * Process an encoded packet, handling codec-specific description extraction
+ * and format conversion based on codec type
+ */
+export declare function processEncodedPacket(packetData: Buffer | Uint8Array, isKeyFrame: boolean, codecType: 'avc' | 'hevc' | 'other', existingDescription: Buffer | null, outputFormat: 'annexb' | 'mp4'): CodecDescriptionResult;
+//# sourceMappingURL=codec-description.d.ts.map

package/dist/backends/node-av/video/encoder/codec-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-description.d.ts","sourceRoot":"","sources":["../../../../../src/backends/node-av/video/encoder/codec-description.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,GAAG,UAAU,EAC/B,UAAU,EAAE,OAAO,EACnB,mBAAmB,EAAE,MAAM,GAAG,IAAI,EAClC,YAAY,EAAE,QAAQ,GAAG,KAAK,GAC7B,sBAAsB,CA0BxB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,GAAG,UAAU,EAC/B,UAAU,EAAE,OAAO,EACnB,mBAAmB,EAAE,MAAM,GAAG,IAAI,EAClC,YAAY,EAAE,QAAQ,GAAG,KAAK,GAC7B,sBAAsB,CA0BxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GAAG,UAAU,EAC/B,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,EACnC,mBAAmB,EAAE,MAAM,GAAG,IAAI,EAClC,YAAY,EAAE,QAAQ,GAAG,KAAK,GAC7B,sBAAsB,CAcxB"}