webcodecs-node 0.2.2

package/dist/__tests__/VideoFrame.test.js

@@ -0,0 +1,243 @@
+/**
+ * Tests for VideoFrame class
+ */
+import { VideoFrame, VideoColorSpace, DOMRectReadOnly } from '../VideoFrame.js';
+describe('VideoFrame', () => {
+    describe('constructor with BufferSource', () => {
+        it('should create a VideoFrame from Uint8Array', () => {
+            const width = 4;
+            const height = 4;
+            const data = new Uint8Array(width * height * 4); // RGBA
+            const frame = new VideoFrame(data, {
+                format: 'RGBA',
+                codedWidth: width,
+                codedHeight: height,
+                timestamp: 1000,
+            });
+            expect(frame.format).toBe('RGBA');
+            expect(frame.codedWidth).toBe(width);
+            expect(frame.codedHeight).toBe(height);
+            expect(frame.timestamp).toBe(1000);
+            expect(frame.displayWidth).toBe(width);
+            expect(frame.displayHeight).toBe(height);
+            frame.close();
+        });
+        it('should create a VideoFrame from ArrayBuffer', () => {
+            const width = 4;
+            const height = 4;
+            const buffer = new ArrayBuffer(width * height * 4);
+            const frame = new VideoFrame(buffer, {
+                format: 'RGBA',
+                codedWidth: width,
+                codedHeight: height,
+                timestamp: 0,
+            });
+            expect(frame.format).toBe('RGBA');
+            expect(frame.codedWidth).toBe(width);
+            expect(frame.codedHeight).toBe(height);
+            frame.close();
+        });
+        it('should set duration when provided', () => {
+            const data = new Uint8Array(16 * 4);
+            const frame = new VideoFrame(data, {
+                format: 'RGBA',
+                codedWidth: 4,
+                codedHeight: 4,
+                timestamp: 0,
+                duration: 33333,
+            });
+            expect(frame.duration).toBe(33333);
+            frame.close();
+        });
+        it('should set displayWidth and displayHeight when provided', () => {
+            const data = new Uint8Array(16 * 4);
+            const frame = new VideoFrame(data, {
+                format: 'RGBA',
+                codedWidth: 4,
+                codedHeight: 4,
+                timestamp: 0,
+                displayWidth: 8,
+                displayHeight: 8,
+            });
+            expect(frame.displayWidth).toBe(8);
+            expect(frame.displayHeight).toBe(8);
+            frame.close();
+        });
+    });
+    describe('constructor with CanvasImageSource', () => {
+        it('should create a VideoFrame from canvas-like object', () => {
+            // Mock canvas-like object
+            const mockCanvas = {
+                width: 4,
+                height: 4,
+                getContext: () => ({
+                    getImageData: () => ({
+                        data: new Uint8ClampedArray(4 * 4 * 4),
+                    }),
+                }),
+            };
+            const frame = new VideoFrame(mockCanvas, {
+                timestamp: 1000,
+            });
+            expect(frame.format).toBe('RGBA');
+            expect(frame.codedWidth).toBe(4);
+            expect(frame.codedHeight).toBe(4);
+            expect(frame.timestamp).toBe(1000);
+            frame.close();
+        });
+    });
+    describe('clone', () => {
+        it('should create an independent copy', () => {
+            const data = new Uint8Array([255, 0, 0, 255, 0, 255, 0, 255, 0, 0, 255, 255, 255, 255, 255, 255]);
+            const frame = new VideoFrame(data, {
+                format: 'RGBA',
+                codedWidth: 2,
+                codedHeight: 2,
+                timestamp: 1000,
+                duration: 100,
+            });
+            const clone = frame.clone();
+            expect(clone.format).toBe(frame.format);
+            expect(clone.codedWidth).toBe(frame.codedWidth);
+            expect(clone.codedHeight).toBe(frame.codedHeight);
+            expect(clone.timestamp).toBe(frame.timestamp);
+            expect(clone.duration).toBe(frame.duration);
+            // Close original, clone should still work
+            frame.close();
+            expect(clone.allocationSize()).toBeGreaterThan(0);
+            clone.close();
+        });
+    });
+    describe('copyTo', () => {
+        it('should copy frame data to destination buffer', async () => {
+            const sourceData = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]);
+            const frame = new VideoFrame(sourceData, {
+                format: 'RGBA',
+                codedWidth: 2,
+                codedHeight: 2,
+                timestamp: 0,
+            });
+            const dest = new Uint8Array(16);
+            await frame.copyTo(dest);
+            expect(Array.from(dest)).toEqual(Array.from(sourceData));
+            frame.close();
+        });
+    });
+    describe('allocationSize', () => {
+        it('should return the correct buffer size', () => {
+            const width = 8;
+            const height = 8;
+            const data = new Uint8Array(width * height * 4);
+            const frame = new VideoFrame(data, {
+                format: 'RGBA',
+                codedWidth: width,
+                codedHeight: height,
+                timestamp: 0,
+            });
+            expect(frame.allocationSize()).toBe(width * height * 4);
+            frame.close();
+        });
+    });
+    describe('close', () => {
+        it('should throw when accessing closed frame', () => {
+            const data = new Uint8Array(16);
+            const frame = new VideoFrame(data, {
+                format: 'RGBA',
+                codedWidth: 2,
+                codedHeight: 2,
+                timestamp: 0,
+            });
+            frame.close();
+            expect(() => frame.allocationSize()).toThrow('VideoFrame is closed');
+        });
+    });
+    describe('codedRect and visibleRect', () => {
+        it('should have correct rect values', () => {
+            const data = new Uint8Array(64 * 4);
+            const frame = new VideoFrame(data, {
+                format: 'RGBA',
+                codedWidth: 8,
+                codedHeight: 8,
+                timestamp: 0,
+            });
+            expect(frame.codedRect.x).toBe(0);
+            expect(frame.codedRect.y).toBe(0);
+            expect(frame.codedRect.width).toBe(8);
+            expect(frame.codedRect.height).toBe(8);
+            expect(frame.visibleRect.x).toBe(0);
+            expect(frame.visibleRect.y).toBe(0);
+            expect(frame.visibleRect.width).toBe(8);
+            expect(frame.visibleRect.height).toBe(8);
+            frame.close();
+        });
+        it('should support custom visibleRect', () => {
+            const data = new Uint8Array(64 * 4);
+            const frame = new VideoFrame(data, {
+                format: 'RGBA',
+                codedWidth: 8,
+                codedHeight: 8,
+                timestamp: 0,
+                visibleRect: { x: 1, y: 1, width: 6, height: 6 },
+            });
+            expect(frame.visibleRect.x).toBe(1);
+            expect(frame.visibleRect.y).toBe(1);
+            expect(frame.visibleRect.width).toBe(6);
+            expect(frame.visibleRect.height).toBe(6);
+            frame.close();
+        });
+    });
+});
+describe('VideoColorSpace', () => {
+    it('should create with default values', () => {
+        const colorSpace = new VideoColorSpace();
+        expect(colorSpace.primaries).toBeNull();
+        expect(colorSpace.transfer).toBeNull();
+        expect(colorSpace.matrix).toBeNull();
+        expect(colorSpace.fullRange).toBeNull();
+    });
+    it('should create with provided values', () => {
+        const colorSpace = new VideoColorSpace({
+            primaries: 'bt709',
+            transfer: 'bt709',
+            matrix: 'bt709',
+            fullRange: true,
+        });
+        expect(colorSpace.primaries).toBe('bt709');
+        expect(colorSpace.transfer).toBe('bt709');
+        expect(colorSpace.matrix).toBe('bt709');
+        expect(colorSpace.fullRange).toBe(true);
+    });
+    it('should serialize to JSON', () => {
+        const colorSpace = new VideoColorSpace({
+            primaries: 'bt709',
+            fullRange: false,
+        });
+        const json = colorSpace.toJSON();
+        expect(json.primaries).toBe('bt709');
+        expect(json.fullRange).toBe(false);
+    });
+});
+describe('DOMRectReadOnly', () => {
+    it('should create with default values', () => {
+        const rect = new DOMRectReadOnly();
+        expect(rect.x).toBe(0);
+        expect(rect.y).toBe(0);
+        expect(rect.width).toBe(0);
+        expect(rect.height).toBe(0);
+    });
+    it('should create with provided values', () => {
+        const rect = new DOMRectReadOnly(10, 20, 100, 200);
+        expect(rect.x).toBe(10);
+        expect(rect.y).toBe(20);
+        expect(rect.width).toBe(100);
+        expect(rect.height).toBe(200);
+    });
+    it('should compute derived properties', () => {
+        const rect = new DOMRectReadOnly(10, 20, 100, 200);
+        expect(rect.top).toBe(20);
+        expect(rect.left).toBe(10);
+        expect(rect.right).toBe(110);
+        expect(rect.bottom).toBe(220);
+    });
+});
+//# sourceMappingURL=VideoFrame.test.js.map

package/dist/__tests__/VideoFrame.test.js.map

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

package/dist/__tests__/aac-utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=aac-utils.test.d.ts.map

package/dist/__tests__/aac-utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aac-utils.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/aac-utils.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/aac-utils.test.js

@@ -0,0 +1,37 @@
+import { Buffer } from 'buffer';
+import { parseAudioSpecificConfig, wrapAacFrameWithAdts, buildAudioSpecificConfig, } from '../utils/aac.js';
+describe('AAC utilities', () => {
+    // Example AudioSpecificConfig: AAC LC, 44100 Hz, stereo (from mp4a.40.2)
+    const asc = new Uint8Array([0x12, 0x10]);
+    it('parses AudioSpecificConfig', () => {
+        const config = parseAudioSpecificConfig(asc);
+        expect(config.audioObjectType).toBe(2);
+        expect(config.samplingFrequencyIndex).toBe(4);
+        expect(config.samplingRate).toBe(44100);
+        expect(config.channelConfiguration).toBe(2);
+    });
+    it('wraps AAC frame in ADTS header', () => {
+        const config = parseAudioSpecificConfig(asc);
+        const payload = new Uint8Array([0x01, 0x02, 0x03, 0x04]);
+        const adtsFrame = wrapAacFrameWithAdts(payload, config);
+        expect(adtsFrame.length).toBe(11);
+        // Sync word 0xFFF
+        expect(adtsFrame[0]).toBe(0xff);
+        expect(adtsFrame[1] & 0xf0).toBe(0xf0);
+        // Frame length field should match header length + payload
+        const frameLength = ((adtsFrame[3] & 0x3) << 11) |
+            (adtsFrame[4] << 3) |
+            ((adtsFrame[5] >> 5) & 0x7);
+        expect(frameLength).toBe(11);
+        // Payload preserved at the end
+        expect(adtsFrame.subarray(7).equals(Buffer.from(payload))).toBe(true);
+    });
+    it('builds AudioSpecificConfig', () => {
+        const config = buildAudioSpecificConfig({
+            samplingRate: 44100,
+            channelConfiguration: 2,
+        });
+        expect(Array.from(config)).toEqual([0x12, 0x10]);
+    });
+});
+//# sourceMappingURL=aac-utils.test.js.map

package/dist/__tests__/aac-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aac-utils.test.js","sourceRoot":"","sources":["../../src/__tests__/aac-utils.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAEzB,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,yEAAyE;IACzE,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAEzC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,MAAM,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACzD,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAExD,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,kBAAkB;QAClB,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,0DAA0D;QAC1D,MAAM,WAAW,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;YAC5B,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;QAChD,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7B,+BAA+B;QAC/B,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,MAAM,GAAG,wBAAwB,CAAC;YACtC,YAAY,EAAE,KAAK;YACnB,oBAAoB,EAAE,CAAC;SACxB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/avc-utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=avc-utils.test.d.ts.map

package/dist/__tests__/avc-utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avc-utils.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/avc-utils.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/avc-utils.test.js

@@ -0,0 +1,63 @@
+import { Buffer } from 'buffer';
+import { convertAvccToAnnexB, parseAvcDecoderConfig, extractAvcParameterSetsFromAnnexB, buildAvcDecoderConfig, convertAnnexBToAvcc, } from '../utils/avc.js';
+describe('AVC utilities', () => {
+    const avcConfigBytes = new Uint8Array([
+        0x01, // configurationVersion
+        0x64, 0x00, 0x1F, // profile/compatibility/level
+        0xFF, // reserved + lengthSizeMinusOne (3 => 4 bytes)
+        0xE1, // numOfSequenceParameterSets (1)
+        0x00, 0x04, // SPS length
+        0x67, 0x64, 0x00, 0x1F, // SPS data
+        0x01, // numOfPictureParameterSets (1)
+        0x00, 0x03, // PPS length
+        0x68, 0xEE, 0x3C, // PPS data
+    ]);
+    it('parses AVC decoder configuration record', () => {
+        const config = parseAvcDecoderConfig(avcConfigBytes);
+        expect(config.lengthSize).toBe(4);
+        expect(config.sps).toHaveLength(1);
+        expect(Array.from(config.sps[0])).toEqual([0x67, 0x64, 0x00, 0x1F]);
+        expect(config.pps).toHaveLength(1);
+        expect(Array.from(config.pps[0])).toEqual([0x68, 0xEE, 0x3C]);
+    });
+    it('converts avcC samples to Annex B with parameter sets', () => {
+        const config = parseAvcDecoderConfig(avcConfigBytes);
+        const chunk = new Uint8Array([
+            0x00, 0x00, 0x00, 0x02, 0x65, 0x88, // IDR NAL length 2 + payload
+            0x00, 0x00, 0x00, 0x01, 0x06, // SEI NAL length 1 + payload
+        ]);
+        const annexB = convertAvccToAnnexB(chunk, config, true);
+        const expected = Buffer.concat([
+            Buffer.from([0x00, 0x00, 0x00, 0x01, 0x67, 0x64, 0x00, 0x1F]),
+            Buffer.from([0x00, 0x00, 0x00, 0x01, 0x68, 0xEE, 0x3C]),
+            Buffer.from([0x00, 0x00, 0x00, 0x01, 0x65, 0x88]),
+            Buffer.from([0x00, 0x00, 0x00, 0x01, 0x06]),
+        ]);
+        expect(annexB.equals(expected)).toBe(true);
+    });
+    it('extracts parameter sets from Annex B frame and rebuilds config', () => {
+        const annexB = new Uint8Array([
+            0x00, 0x00, 0x00, 0x01, 0x67, 0x64, 0x00, 0x1F,
+            0x00, 0x00, 0x00, 0x01, 0x68, 0xEE, 0x3C,
+        ]);
+        const { sps, pps } = extractAvcParameterSetsFromAnnexB(annexB);
+        expect(sps).toHaveLength(1);
+        expect(pps).toHaveLength(1);
+        const config = buildAvcDecoderConfig(sps, pps);
+        const parsed = parseAvcDecoderConfig(config);
+        expect(parsed.sps).toHaveLength(1);
+        expect(parsed.pps).toHaveLength(1);
+    });
+    it('converts Annex B frames to AVCC', () => {
+        const annexB = new Uint8Array([
+            0x00, 0x00, 0x00, 0x01, 0x65, 0x88, 0x99,
+            0x00, 0x00, 0x01, 0x06, 0x11,
+        ]);
+        const avcc = convertAnnexBToAvcc(annexB, 4);
+        expect(avcc.equals(Buffer.from([
+            0x00, 0x00, 0x00, 0x03, 0x65, 0x88, 0x99,
+            0x00, 0x00, 0x00, 0x02, 0x06, 0x11,
+        ]))).toBe(true);
+    });
+});
+//# sourceMappingURL=avc-utils.test.js.map

package/dist/__tests__/avc-utils.test.js.map

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

package/dist/__tests__/hevc-utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hevc-utils.test.d.ts.map

package/dist/__tests__/hevc-utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hevc-utils.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/hevc-utils.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/hevc-utils.test.js

@@ -0,0 +1,78 @@
+import { Buffer } from 'buffer';
+import { convertHvccToAnnexB, parseHvccDecoderConfig, extractHevcParameterSetsFromAnnexB, buildHvccDecoderConfig, convertAnnexBToHvcc, } from '../utils/hevc.js';
+describe('HEVC utilities', () => {
+    // Minimal HVCC record with single VPS/SPS/PPS
+    const hvcc = new Uint8Array([
+        0x01, 0x01, 0x60, 0x00, 0x00, 0x00, 0x00, 0x00,
+        0x90, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+        0x00, 0x00, 0x00, 0x00, 0xFC, 0xFD, // lengthSizeMinusOne in byte 21 (0xFD & 3 = 1 => size 2)
+        0x03, // numOfArrays
+        // VPS array
+        0x80 | 32, // completeness + nal type
+        0x00, 0x01, // numNalus
+        0x00, 0x04, // nal length
+        0x40, 0x01, 0x02, 0x03,
+        // SPS array
+        0x80 | 33,
+        0x00, 0x01,
+        0x00, 0x05,
+        0x42, 0x01, 0x02, 0x03, 0x04,
+        // PPS array
+        0x80 | 34,
+        0x00, 0x01,
+        0x00, 0x02,
+        0x44, 0x55,
+    ]);
+    it('parses HVCC record', () => {
+        const config = parseHvccDecoderConfig(hvcc);
+        expect(config.lengthSize).toBe(2);
+        expect(config.vps).toHaveLength(1);
+        expect(config.sps).toHaveLength(1);
+        expect(config.pps).toHaveLength(1);
+        expect(Array.from(config.vps[0])).toEqual([0x40, 0x01, 0x02, 0x03]);
+    });
+    it('converts HVCC samples to Annex B', () => {
+        const config = parseHvccDecoderConfig(hvcc);
+        const chunk = new Uint8Array([
+            0x00, 0x03, 0x26, 0x27, 0x28, // NAL length 3 + payload
+            0x00, 0x02, 0x01, 0x02, // NAL length 2 + payload
+        ]);
+        const annex = convertHvccToAnnexB(chunk, config, true);
+        const expected = Buffer.concat([
+            Buffer.from([0, 0, 0, 1, 0x40, 0x01, 0x02, 0x03]),
+            Buffer.from([0, 0, 0, 1, 0x42, 0x01, 0x02, 0x03, 0x04]),
+            Buffer.from([0, 0, 0, 1, 0x44, 0x55]),
+            Buffer.from([0, 0, 0, 1, 0x26, 0x27, 0x28]),
+            Buffer.from([0, 0, 0, 1, 0x01, 0x02]),
+        ]);
+        expect(annex.equals(expected)).toBe(true);
+    });
+    it('extracts HEVC parameter sets from Annex B', () => {
+        const annex = new Uint8Array([
+            0, 0, 0, 1, 0x40, 0x01, 0x02,
+            0, 0, 0, 1, 0x42, 0x01, 0x02, 0x03,
+            0, 0, 0, 1, 0x44, 0x55,
+        ]);
+        const sets = extractHevcParameterSetsFromAnnexB(annex);
+        expect(sets.vps).toHaveLength(1);
+        expect(sets.sps).toHaveLength(1);
+        expect(sets.pps).toHaveLength(1);
+        const hvcc = buildHvccDecoderConfig(sets.vps, sets.sps, sets.pps);
+        const parsed = parseHvccDecoderConfig(hvcc);
+        expect(parsed.vps).toHaveLength(1);
+        expect(parsed.sps).toHaveLength(1);
+        expect(parsed.pps).toHaveLength(1);
+    });
+    it('converts Annex B frames to HVCC length-prefixed payloads', () => {
+        const annex = new Uint8Array([
+            0, 0, 0, 1, 0x26, 0x27, 0x28,
+            0, 0, 1, 0x02, 0x03,
+        ]);
+        const result = convertAnnexBToHvcc(annex, 4);
+        expect(result.equals(Buffer.from([
+            0, 0, 0, 3, 0x26, 0x27, 0x28,
+            0, 0, 0, 2, 0x02, 0x03,
+        ]))).toBe(true);
+    });
+});
+//# sourceMappingURL=hevc-utils.test.js.map

package/dist/__tests__/hevc-utils.test.js.map

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

package/dist/capabilities/MediaCapabilities.d.ts

@@ -0,0 +1,78 @@
+/**
+ * MediaCapabilities API implementation
+ * https://developer.mozilla.org/en-US/docs/Web/API/MediaCapabilities
+ *
+ * Provides methods to query decoding and encoding capabilities.
+ */
+import type { MediaDecodingConfiguration, MediaEncodingConfiguration, MediaCapabilitiesDecodingInfo, MediaCapabilitiesEncodingInfo, CapabilityProfile } from './types.js';
+/**
+ * MediaCapabilities API implementation
+ */
+export declare class MediaCapabilities {
+    private _profile;
+    constructor(profile?: CapabilityProfile | null);
+    /**
+     * Query decoding capabilities for a media configuration
+     *
+     * @param configuration - The media configuration to query
+     * @returns Promise resolving to capability information
+     *
+     * @example
+     * ```typescript
+     * const info = await mediaCapabilities.decodingInfo({
+     *   type: 'file',
+     *   video: {
+     *     contentType: 'video/mp4; codecs="avc1.42E01E"',
+     *     width: 1920,
+     *     height: 1080,
+     *     bitrate: 5000000,
+     *     framerate: 30,
+     *   },
+     * });
+     *
+     * if (info.supported && info.smooth) {
+     *   console.log('Can decode smoothly!');
+     * }
+     * ```
+     */
+    decodingInfo(configuration: MediaDecodingConfiguration): Promise<MediaCapabilitiesDecodingInfo>;
+    /**
+     * Query encoding capabilities for a media configuration
+     *
+     * @param configuration - The media configuration to query
+     * @returns Promise resolving to capability information
+     *
+     * @example
+     * ```typescript
+     * const info = await mediaCapabilities.encodingInfo({
+     *   type: 'record',
+     *   video: {
+     *     contentType: 'video/webm; codecs="vp9"',
+     *     width: 1280,
+     *     height: 720,
+     *     bitrate: 2000000,
+     *     framerate: 30,
+     *   },
+     * });
+     *
+     * if (info.supported && info.powerEfficient) {
+     *   console.log('Can encode with hardware acceleration!');
+     * }
+     * ```
+     */
+    encodingInfo(configuration: MediaEncodingConfiguration): Promise<MediaCapabilitiesEncodingInfo>;
+    private _isVideoConfigValid;
+    private _isAudioConfigValid;
+    private _isPositiveNumber;
+    private _isPositiveInteger;
+    private _evaluateVideoCapabilities;
+    private _evaluateWithProfile;
+}
+export declare function loadCapabilitiesProfile(filePath?: string): CapabilityProfile | null;
+export declare function setCapabilitiesProfilePath(filePath: string | null): void;
+export declare function loadCapabilitiesProfileFromEnv(): CapabilityProfile | null;
+/**
+ * Global MediaCapabilities instance (matches browser API pattern)
+ */
+export declare const mediaCapabilities: MediaCapabilities;
+//# sourceMappingURL=MediaCapabilities.d.ts.map

package/dist/capabilities/MediaCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaCapabilities.d.ts","sourceRoot":"","sources":["../../src/capabilities/MediaCapabilities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,0BAA0B,EAC1B,0BAA0B,EAC1B,6BAA6B,EAC7B,6BAA6B,EAC7B,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAapB;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAkC;gBAEtC,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAG9C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,YAAY,CAChB,aAAa,EAAE,0BAA0B,GACxC,OAAO,CAAC,6BAA6B,CAAC;IAkDzC;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,YAAY,CAChB,aAAa,EAAE,0BAA0B,GACxC,OAAO,CAAC,6BAA6B,CAAC;IAkDzC,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,iBAAiB;IAGzB,OAAO,CAAC,kBAAkB;YAIZ,0BAA0B;IAkBxC,OAAO,CAAC,oBAAoB;CAqB7B;AAKD,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAcnF;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAOxE;AAED,wBAAgB,8BAA8B,IAAI,iBAAiB,GAAG,IAAI,CASzE;AAsCD;;GAEG;AACH,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}