webcodecs-node 0.2.2

package/dist/utils/aac.js

@@ -0,0 +1,129 @@
+/**
+ * AAC (AudioSpecificConfig) parsing and ADTS framing utilities.
+ */
+export const SAMPLING_RATES = [
+    96000, 88200, 64000, 48000, 44100, 32000,
+    24000, 22050, 16000, 12000, 11025, 8000,
+    7350,
+];
+/**
+ * Parse the AudioSpecificConfig (ISO/IEC 14496-3) blob passed via
+ * AudioDecoderConfig.description for codecs like mp4a.40.*.
+ */
+export function parseAudioSpecificConfig(data) {
+    if (data.length < 2) {
+        throw new Error('Invalid AudioSpecificConfig: too short');
+    }
+    let bitOffset = 0;
+    const readBits = (numBits) => {
+        let value = 0;
+        for (let i = 0; i < numBits; i++) {
+            const byteOffset = (bitOffset + i) >> 3;
+            const bitInByte = 7 - ((bitOffset + i) & 7);
+            if (byteOffset >= data.length) {
+                throw new Error('Invalid AudioSpecificConfig: read past end');
+            }
+            value = (value << 1) | ((data[byteOffset] >> bitInByte) & 1);
+        }
+        bitOffset += numBits;
+        return value;
+    };
+    let audioObjectType = readBits(5);
+    if (audioObjectType === 31) {
+        audioObjectType = 32 + readBits(6);
+    }
+    let samplingFrequencyIndex = readBits(4);
+    let samplingRate;
+    if (samplingFrequencyIndex === 0xf) {
+        samplingRate = readBits(24);
+    }
+    else {
+        samplingRate = SAMPLING_RATES[samplingFrequencyIndex] ?? 0;
+    }
+    const channelConfiguration = readBits(4);
+    return {
+        audioObjectType,
+        samplingFrequencyIndex,
+        samplingRate,
+        channelConfiguration,
+    };
+}
+/**
+ * Wrap a raw AAC frame with an ADTS header using the parsed config.
+ */
+export function wrapAacFrameWithAdts(data, config) {
+    const adtsHeader = Buffer.alloc(7);
+    const frameLength = data.length + adtsHeader.length;
+    const profile = (config.audioObjectType === 0 ? 1 : config.audioObjectType) - 1;
+    const freqIdx = config.samplingFrequencyIndex & 0xf;
+    const chanCfg = config.channelConfiguration & 0x7;
+    adtsHeader[0] = 0xff;
+    adtsHeader[1] = 0xf1; // Sync word, MPEG-4, layer 0, protection absent
+    adtsHeader[2] = ((profile & 0x3) << 6) | ((freqIdx & 0xf) << 2) | ((chanCfg >> 2) & 0x1);
+    adtsHeader[3] = ((chanCfg & 0x3) << 6) | ((frameLength >> 11) & 0x3);
+    adtsHeader[4] = (frameLength >> 3) & 0xff;
+    adtsHeader[5] = ((frameLength & 0x7) << 5) | 0x1f;
+    adtsHeader[6] = 0xfc;
+    return Buffer.concat([adtsHeader, Buffer.from(data)]);
+}
+export function buildAudioSpecificConfig(params) {
+    const writer = new BitWriter();
+    const audioObjectType = params.audioObjectType ?? 2;
+    if (audioObjectType >= 32) {
+        writer.write(31, 5);
+        writer.write(audioObjectType - 32, 6);
+    }
+    else {
+        writer.write(audioObjectType, 5);
+    }
+    let samplingFrequencyIndex = SAMPLING_RATES.indexOf(params.samplingRate);
+    if (samplingFrequencyIndex < 0) {
+        samplingFrequencyIndex = 0xf;
+    }
+    writer.write(samplingFrequencyIndex, 4);
+    if (samplingFrequencyIndex === 0xf) {
+        writer.write(params.samplingRate, 24);
+    }
+    writer.write(params.channelConfiguration & 0x0f, 4);
+    // frameLengthFlag, dependsOnCoreCoder, extensionFlag
+    writer.write(0, 3);
+    return writer.toUint8Array();
+}
+class BitWriter {
+    buffer = 0;
+    bits = 0;
+    out = [];
+    write(value, numBits) {
+        for (let i = numBits - 1; i >= 0; i--) {
+            const bit = (value >> i) & 1;
+            this.buffer = (this.buffer << 1) | bit;
+            this.bits++;
+            if (this.bits === 8) {
+                this.out.push(this.buffer & 0xff);
+                this.buffer = 0;
+                this.bits = 0;
+            }
+        }
+    }
+    toUint8Array() {
+        if (this.bits > 0) {
+            this.buffer <<= (8 - this.bits);
+            this.out.push(this.buffer & 0xff);
+            this.buffer = 0;
+            this.bits = 0;
+        }
+        return new Uint8Array(this.out);
+    }
+}
+export function stripAdtsHeader(frame) {
+    if (frame.length < 7) {
+        return frame;
+    }
+    const protectionAbsent = frame[1] & 0x01;
+    const headerLength = protectionAbsent ? 7 : 9;
+    if (frame.length <= headerLength) {
+        return new Uint8Array(0);
+    }
+    return frame.subarray(headerLength);
+}
+//# sourceMappingURL=aac.js.map

package/dist/utils/aac.js.map

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

package/dist/utils/avc.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Utilities for handling AVC (H.264) configuration records and converting
+ * length-prefixed NAL units (avcC format) into Annex B byte streams.
+ */
+export interface AvcConfig {
+    lengthSize: number;
+    sps: Uint8Array[];
+    pps: Uint8Array[];
+}
+/**
+ * Parse an AVCDecoderConfigurationRecord (ISO/IEC 14496-15) into a structure
+ * containing SPS/PPS NAL units and the NAL length size.
+ */
+export declare function parseAvcDecoderConfig(data: Uint8Array): AvcConfig;
+/**
+ * Convert an avcC length-prefixed chunk into Annex B byte stream and optionally
+ * prepend SPS/PPS parameter sets (required for key frames).
+ */
+export declare function convertAvccToAnnexB(chunk: Uint8Array, config: AvcConfig, includeParameterSets: boolean): Buffer;
+/**
+ * Split an Annex B stream into individual NAL units (without start codes).
+ */
+export declare function splitAnnexBNals(data: Uint8Array): Uint8Array[];
+/**
+ * Extract SPS/PPS parameter sets from an Annex B bitstream.
+ */
+export declare function extractAvcParameterSetsFromAnnexB(data: Uint8Array): {
+    sps: Uint8Array[];
+    pps: Uint8Array[];
+};
+/**
+ * Build an AVCDecoderConfigurationRecord from SPS/PPS parameter sets.
+ */
+export declare function buildAvcDecoderConfig(spsList: Uint8Array[], ppsList: Uint8Array[], lengthSize?: number): Uint8Array;
+/**
+ * Convert Annex B frame into MP4 length-prefixed NAL units (avcC format).
+ */
+export declare function convertAnnexBToAvcc(data: Uint8Array, lengthSize?: number): Buffer;
+//# sourceMappingURL=avc.d.ts.map

package/dist/utils/avc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avc.d.ts","sourceRoot":"","sources":["../../src/utils/avc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,UAAU,EAAE,CAAC;IAClB,GAAG,EAAE,UAAU,EAAE,CAAC;CACnB;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAgDjE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,SAAS,EACjB,oBAAoB,EAAE,OAAO,GAC5B,MAAM,CAiCR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE,CA0B9D;AAmBD;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,GAAG,EAAE,UAAU,EAAE,CAAC;IAAC,GAAG,EAAE,UAAU,EAAE,CAAA;CAAE,CAqB5G;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,UAAU,EAAE,EACrB,UAAU,GAAE,MAAU,GACrB,UAAU,CA+CZ;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,GAAE,MAAU,GAAG,MAAM,CAsBpF"}

package/dist/utils/avc.js

@@ -0,0 +1,225 @@
+/**
+ * Utilities for handling AVC (H.264) configuration records and converting
+ * length-prefixed NAL units (avcC format) into Annex B byte streams.
+ */
+const START_CODE = Buffer.from([0x00, 0x00, 0x00, 0x01]);
+/**
+ * Parse an AVCDecoderConfigurationRecord (ISO/IEC 14496-15) into a structure
+ * containing SPS/PPS NAL units and the NAL length size.
+ */
+export function parseAvcDecoderConfig(data) {
+    if (data.length < 7) {
+        throw new Error('Invalid AVCDecoderConfigurationRecord: too short');
+    }
+    const lengthSizeMinusOne = data[4] & 0x03;
+    const lengthSize = (lengthSizeMinusOne & 0x03) + 1;
+    let offset = 5;
+    const numOfSps = data[offset] & 0x1f;
+    offset += 1;
+    const sps = [];
+    for (let i = 0; i < numOfSps; i++) {
+        if (offset + 2 > data.length) {
+            throw new Error('Invalid AVCDecoderConfigurationRecord: truncated SPS length');
+        }
+        const length = (data[offset] << 8) | data[offset + 1];
+        offset += 2;
+        if (offset + length > data.length) {
+            throw new Error('Invalid AVCDecoderConfigurationRecord: truncated SPS data');
+        }
+        sps.push(data.subarray(offset, offset + length));
+        offset += length;
+    }
+    if (offset + 1 > data.length) {
+        throw new Error('Invalid AVCDecoderConfigurationRecord: missing PPS count');
+    }
+    const numOfPps = data[offset];
+    offset += 1;
+    const pps = [];
+    for (let i = 0; i < numOfPps; i++) {
+        if (offset + 2 > data.length) {
+            throw new Error('Invalid AVCDecoderConfigurationRecord: truncated PPS length');
+        }
+        const length = (data[offset] << 8) | data[offset + 1];
+        offset += 2;
+        if (offset + length > data.length) {
+            throw new Error('Invalid AVCDecoderConfigurationRecord: truncated PPS data');
+        }
+        pps.push(data.subarray(offset, offset + length));
+        offset += length;
+    }
+    return { lengthSize, sps, pps };
+}
+/**
+ * Convert an avcC length-prefixed chunk into Annex B byte stream and optionally
+ * prepend SPS/PPS parameter sets (required for key frames).
+ */
+export function convertAvccToAnnexB(chunk, config, includeParameterSets) {
+    const parts = [];
+    if (includeParameterSets) {
+        for (const nal of config.sps) {
+            parts.push(START_CODE, Buffer.from(nal));
+        }
+        for (const nal of config.pps) {
+            parts.push(START_CODE, Buffer.from(nal));
+        }
+    }
+    let offset = 0;
+    while (offset + config.lengthSize <= chunk.length) {
+        let nalSize = 0;
+        for (let i = 0; i < config.lengthSize; i++) {
+            nalSize = (nalSize << 8) | chunk[offset + i];
+        }
+        offset += config.lengthSize;
+        if (nalSize <= 0 || offset + nalSize > chunk.length) {
+            break; // malformed
+        }
+        const nal = chunk.subarray(offset, offset + nalSize);
+        parts.push(START_CODE, Buffer.from(nal));
+        offset += nalSize;
+    }
+    if (parts.length === 0) {
+        // Fallback to original chunk to avoid dropping data entirely.
+        return Buffer.from(chunk);
+    }
+    return Buffer.concat(parts);
+}
+/**
+ * Split an Annex B stream into individual NAL units (without start codes).
+ */
+export function splitAnnexBNals(data) {
+    const units = [];
+    let offset = 0;
+    let unitStart = -1;
+    while (offset < data.length) {
+        const startCodeLength = getStartCodeLength(data, offset);
+        if (startCodeLength > 0) {
+            if (unitStart >= 0 && unitStart < offset) {
+                const unit = data.subarray(unitStart, offset);
+                if (unit.length > 0) {
+                    units.push(unit);
+                }
+            }
+            offset += startCodeLength;
+            unitStart = offset;
+        }
+        else {
+            offset++;
+        }
+    }
+    if (unitStart >= 0 && unitStart < data.length) {
+        units.push(data.subarray(unitStart));
+    }
+    return units;
+}
+function getStartCodeLength(data, offset) {
+    if (offset + 3 > data.length) {
+        return 0;
+    }
+    if (data[offset] === 0 && data[offset + 1] === 0) {
+        if (data[offset + 2] === 1) {
+            return 3;
+        }
+        if (offset + 3 < data.length && data[offset + 2] === 0 && data[offset + 3] === 1) {
+            return 4;
+        }
+    }
+    return 0;
+}
+/**
+ * Extract SPS/PPS parameter sets from an Annex B bitstream.
+ */
+export function extractAvcParameterSetsFromAnnexB(data) {
+    const units = splitAnnexBNals(data);
+    const sps = [];
+    const pps = [];
+    const seen = new Set();
+    for (const unit of units) {
+        if (unit.length === 0)
+            continue;
+        const nalType = unit[0] & 0x1f;
+        const key = `${nalType}:${unit.toString()}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        if (nalType === 7) {
+            sps.push(unit);
+        }
+        else if (nalType === 8) {
+            pps.push(unit);
+        }
+    }
+    return { sps, pps };
+}
+/**
+ * Build an AVCDecoderConfigurationRecord from SPS/PPS parameter sets.
+ */
+export function buildAvcDecoderConfig(spsList, ppsList, lengthSize = 4) {
+    if (spsList.length === 0 || ppsList.length === 0) {
+        throw new Error('At least one SPS and PPS are required to build AVC config');
+    }
+    const sanitizedLength = Math.min(Math.max(lengthSize, 1), 4);
+    const spsCount = Math.min(spsList.length, 31);
+    const ppsCount = Math.min(ppsList.length, 255);
+    let size = 6; // version/profile/level/length size + numOfSPS byte
+    for (let i = 0; i < spsCount; i++) {
+        size += 2 + spsList[i].length;
+    }
+    size += 1; // numOfPPS byte
+    for (let i = 0; i < ppsCount; i++) {
+        size += 2 + ppsList[i].length;
+    }
+    const buffer = Buffer.alloc(size);
+    let offset = 0;
+    const firstSps = spsList[0];
+    buffer[offset++] = 1; // configurationVersion
+    buffer[offset++] = firstSps[1] ?? 0x64; // profile indication
+    buffer[offset++] = firstSps[2] ?? 0x00; // profile compatibility
+    buffer[offset++] = firstSps[3] ?? 0x1f; // level indication
+    buffer[offset++] = 0xfc | ((sanitizedLength - 1) & 0x03);
+    buffer[offset++] = 0xe0 | spsCount;
+    for (let i = 0; i < spsCount; i++) {
+        const sps = spsList[i];
+        buffer.writeUInt16BE(sps.length, offset);
+        offset += 2;
+        Buffer.from(sps).copy(buffer, offset);
+        offset += sps.length;
+    }
+    buffer[offset++] = ppsCount;
+    for (let i = 0; i < ppsCount; i++) {
+        const pps = ppsList[i];
+        buffer.writeUInt16BE(pps.length, offset);
+        offset += 2;
+        Buffer.from(pps).copy(buffer, offset);
+        offset += pps.length;
+    }
+    return new Uint8Array(buffer);
+}
+/**
+ * Convert Annex B frame into MP4 length-prefixed NAL units (avcC format).
+ */
+export function convertAnnexBToAvcc(data, lengthSize = 4) {
+    const units = splitAnnexBNals(data);
+    const sanitizedLength = Math.min(Math.max(lengthSize, 1), 4);
+    const parts = [];
+    for (const unit of units) {
+        if (unit.length === 0)
+            continue;
+        const lengthBuffer = Buffer.alloc(sanitizedLength);
+        if (sanitizedLength === 4) {
+            lengthBuffer.writeUInt32BE(unit.length, 0);
+        }
+        else if (sanitizedLength === 2) {
+            lengthBuffer.writeUInt16BE(unit.length, 0);
+        }
+        else if (sanitizedLength === 1) {
+            lengthBuffer.writeUInt8(unit.length, 0);
+        }
+        else {
+            // 3-byte length
+            lengthBuffer.writeUIntBE(unit.length, 0, 3);
+        }
+        parts.push(lengthBuffer, Buffer.from(unit));
+    }
+    return Buffer.concat(parts);
+}
+//# sourceMappingURL=avc.js.map

package/dist/utils/avc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avc.js","sourceRoot":"","sources":["../../src/utils/avc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAEzD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAgB;IACpD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1C,MAAM,UAAU,GAAG,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACrC,MAAM,IAAI,CAAC,CAAC;IAEZ,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,CAAC;QACZ,IAAI,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC/E,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;QACjD,MAAM,IAAI,MAAM,CAAC;IACnB,CAAC;IAED,IAAI,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,IAAI,CAAC,CAAC;IAEZ,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,CAAC;QACZ,IAAI,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC/E,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;QACjD,MAAM,IAAI,MAAM,CAAC;IACnB,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAiB,EACjB,MAAiB,EACjB,oBAA6B;IAE7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,oBAAoB,EAAE,CAAC;QACzB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,MAAM,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAClD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,OAAO,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC;QAC5B,IAAI,OAAO,IAAI,CAAC,IAAI,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACpD,MAAM,CAAC,YAAY;QACrB,CAAC;QACD,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,MAAM,IAAI,OAAO,CAAC;IACpB,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,8DAA8D;QAC9D,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;IAEnB,OAAO,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,eAAe,GAAG,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzD,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,GAAG,MAAM,EAAE,CAAC;gBACzC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC9C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC;YACD,MAAM,IAAI,eAAe,CAAC;YAC1B,SAAS,GAAG,MAAM,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC;IAED,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAgB,EAAE,MAAc;IAC1D,IAAI,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACjF,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iCAAiC,CAAC,IAAgB;IAChE,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QAC/B,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEd,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAqB,EACrB,OAAqB,EACrB,aAAqB,CAAC;IAEtB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/C,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,oDAAoD;IAClE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAChC,CAAC;IACD,IAAI,IAAI,CAAC,CAAC,CAAC,gBAAgB;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAChC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,uBAAuB;IAC7C,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,qBAAqB;IAC7D,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,wBAAwB;IAChE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,mBAAmB;IAC3D,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACzD,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC;IAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,IAAI,CAAC,CAAC;QACZ,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,QAAQ,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,IAAI,CAAC,CAAC;QACZ,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAgB,EAAE,aAAqB,CAAC;IAC1E,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAChC,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACnD,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;YAC1B,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;YACjC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;YACjC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,gBAAgB;YAChB,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/utils/buffer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Buffer and ArrayBuffer utilities
+ */
+import { BufferSource } from '../types/index.js';
+/**
+ * Convert any BufferSource to Uint8Array
+ */
+export declare function toUint8Array(source: BufferSource): Uint8Array;
+/**
+ * Copy BufferSource to a new Uint8Array
+ */
+export declare function copyToUint8Array(source: BufferSource): Uint8Array;
+/**
+ * Concatenate multiple Uint8Arrays into one
+ */
+export declare function concatUint8Arrays(arrays: Uint8Array[]): Uint8Array;
+/**
+ * Check if an object is a ReadableStream
+ */
+export declare function isReadableStream(obj: unknown): obj is ReadableStream;
+/**
+ * Read a ReadableStream completely into a Uint8Array
+ */
+export declare function readStreamToUint8Array(stream: ReadableStream<ArrayBufferView>): Promise<Uint8Array>;
+//# sourceMappingURL=buffer.d.ts.map

package/dist/utils/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../src/utils/buffer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAO7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CASjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CASlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAMpE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,cAAc,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAmBzG"}

package/dist/utils/buffer.js

@@ -0,0 +1,73 @@
+/**
+ * Buffer and ArrayBuffer utilities
+ */
+/**
+ * Convert any BufferSource to Uint8Array
+ */
+export function toUint8Array(source) {
+    if (source instanceof ArrayBuffer) {
+        return new Uint8Array(source);
+    }
+    else if (ArrayBuffer.isView(source)) {
+        return new Uint8Array(source.buffer, source.byteOffset, source.byteLength);
+    }
+    throw new TypeError('source must be an ArrayBuffer or ArrayBufferView');
+}
+/**
+ * Copy BufferSource to a new Uint8Array
+ */
+export function copyToUint8Array(source) {
+    if (source instanceof ArrayBuffer) {
+        return new Uint8Array(source.slice(0));
+    }
+    else if (ArrayBuffer.isView(source)) {
+        const copy = new Uint8Array(source.byteLength);
+        copy.set(new Uint8Array(source.buffer, source.byteOffset, source.byteLength));
+        return copy;
+    }
+    throw new TypeError('source must be an ArrayBuffer or ArrayBufferView');
+}
+/**
+ * Concatenate multiple Uint8Arrays into one
+ */
+export function concatUint8Arrays(arrays) {
+    const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const arr of arrays) {
+        result.set(arr, offset);
+        offset += arr.length;
+    }
+    return result;
+}
+/**
+ * Check if an object is a ReadableStream
+ */
+export function isReadableStream(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        typeof obj.getReader === 'function');
+}
+/**
+ * Read a ReadableStream completely into a Uint8Array
+ */
+export async function readStreamToUint8Array(stream) {
+    const reader = stream.getReader();
+    const chunks = [];
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (value) {
+                const chunk = new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+                chunks.push(chunk);
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    return concatUint8Arrays(chunks);
+}
+//# sourceMappingURL=buffer.js.map

package/dist/utils/buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.js","sourceRoot":"","sources":["../../src/utils/buffer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,IAAI,MAAM,YAAY,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;SAAM,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,IAAI,MAAM,YAAY,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;SAAM,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAoB;IACpD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,OAAQ,GAAsB,CAAC,SAAS,KAAK,UAAU,CACxD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAuC;IAClF,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;IAClC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAEhB,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC/E,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;IAED,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}

package/dist/utils/hevc.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Utilities for handling HEVC (H.265) configuration records (HVCC) and
+ * converting length-prefixed MP4 samples into Annex B byte streams.
+ */
+export interface HvccConfig {
+    lengthSize: number;
+    vps: Uint8Array[];
+    sps: Uint8Array[];
+    pps: Uint8Array[];
+}
+/**
+ * Parse an HEVCDecoderConfigurationRecord as defined in ISO/IEC 14496-15.
+ */
+export declare function parseHvccDecoderConfig(data: Uint8Array): HvccConfig;
+/**
+ * Convert HVCC (length-prefixed) samples to Annex B and optionally add VPS/SPS/PPS.
+ */
+export declare function convertHvccToAnnexB(chunk: Uint8Array, config: HvccConfig, includeParameterSets: boolean): Buffer;
+export declare function splitHevcAnnexBNals(data: Uint8Array): Uint8Array[];
+export declare function extractHevcParameterSetsFromAnnexB(data: Uint8Array): {
+    vps: Uint8Array[];
+    sps: Uint8Array[];
+    pps: Uint8Array[];
+};
+export declare function convertAnnexBToHvcc(data: Uint8Array, lengthSize?: number): Buffer;
+export declare function buildHvccDecoderConfig(vpsList: Uint8Array[], spsList: Uint8Array[], ppsList: Uint8Array[], lengthSize?: number): Uint8Array;
+//# sourceMappingURL=hevc.d.ts.map

package/dist/utils/hevc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hevc.d.ts","sourceRoot":"","sources":["../../src/utils/hevc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,UAAU,EAAE,CAAC;IAClB,GAAG,EAAE,UAAU,EAAE,CAAC;IAClB,GAAG,EAAE,UAAU,EAAE,CAAC;CACnB;AAID;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAsDnE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,UAAU,EAClB,oBAAoB,EAAE,OAAO,GAC5B,MAAM,CAqCR;AAmBD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,EAAE,CA0BlE;AAED,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,UAAU,GACf;IAAE,GAAG,EAAE,UAAU,EAAE,CAAC;IAAC,GAAG,EAAE,UAAU,EAAE,CAAC;IAAC,GAAG,EAAE,UAAU,EAAE,CAAA;CAAE,CAwB7D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,GAAE,MAAU,GAAG,MAAM,CAqBpF;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,UAAU,EAAE,EACrB,UAAU,GAAE,MAAU,GACrB,UAAU,CAqEZ"}