@blockcast/mmt-container 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @mmt/container - MMTP/LOC Container Parsing
+ *
+ * Shared container parsing library for MMT over MoQ and SSM.
+ *
+ * @packageDocumentation
+ */
+export { type MMTPHeader, type MPUHeader, type MMTPPacket, MMTP_HEADER_SIZE, MPU_HEADER_SIZE, MFU_DU_HEADER_SIZE, parseMMTPHeader, unwrapMMTP, parseMPUHeader, extractNALUnit, extractTimestamp, isFecRepairPacket, hasFecPayloadId, } from './mmtp.js';
+export { type MFUFragment, type ReassembledMFU, type ReassemblerStats, type MFUReassemblerOptions, MFUReassembler, createFragment, processMMTPWithReassembly, } from './mfu-reassembler.js';
+export { LOCHeaderExtensionId, FEC_PAYLOAD_ID_MAX, fecPack, fecUnpack, FecPayloadId, } from './loc.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAChB,MAAM,WAAW,CAAA;AAGlB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,cAAc,EACd,cAAc,EACd,yBAAyB,GAC1B,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,OAAO,EACP,SAAS,EACT,YAAY,GACb,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @mmt/container - MMTP/LOC Container Parsing
+ *
+ * Shared container parsing library for MMT over MoQ and SSM.
+ *
+ * @packageDocumentation
+ */
+// MMTP Parser
+export { MMTP_HEADER_SIZE, MPU_HEADER_SIZE, MFU_DU_HEADER_SIZE, parseMMTPHeader, unwrapMMTP, parseMPUHeader, extractNALUnit, extractTimestamp, isFecRepairPacket, hasFecPayloadId, } from './mmtp.js';
+// MFU Reassembler
+export { MFUReassembler, createFragment, processMMTPWithReassembly, } from './mfu-reassembler.js';
+// LOC FEC Extensions
+export { LOCHeaderExtensionId, FEC_PAYLOAD_ID_MAX, fecPack, fecUnpack, FecPayloadId, } from './loc.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc;AACd,OAAO,EAIL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAChB,MAAM,WAAW,CAAA;AAElB,kBAAkB;AAClB,OAAO,EAKL,cAAc,EACd,cAAc,EACd,yBAAyB,GAC1B,MAAM,sBAAsB,CAAA;AAE7B,qBAAqB;AACrB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,OAAO,EACP,SAAS,EACT,YAAY,GACb,MAAM,UAAU,CAAA"}

package/dist/loc.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @mmt/container - LOC FEC Extensions
+ *
+ * FEC Payload ID helpers for LOC (Low Overhead Container) format
+ * Per draft-ramadan-moq-mmt Section 7.3
+ *
+ * The FEC Payload ID encodes Source Block Number (SBN) and
+ * Encoding Symbol ID (ESI) as a 48-bit value: (SBN << 24) | ESI
+ *
+ * @packageDocumentation
+ */
+/**
+ * LOC Header Extension IDs
+ */
+export declare enum LOCHeaderExtensionId {
+    CaptureTimestamp = 2,
+    VideoFrameMarking = 4,
+    AudioLevel = 6,
+    VideoConfig = 13,
+    /** FEC Payload ID extension (draft-ramadan-moq-mmt Section 7.3) */
+    FecPayloadId = 16
+}
+/** Maximum value for SBN and ESI (24 bits each) */
+export declare const FEC_PAYLOAD_ID_MAX = 16777215;
+/**
+ * Pack Source Block Number (SBN) and Encoding Symbol ID (ESI) into a 48-bit value.
+ *
+ * Per draft-ramadan-moq-mmt Section 7.3, the FEC Payload ID is encoded as:
+ * `(SBN << 24) | ESI` where both SBN and ESI are 24 bits.
+ *
+ * @param sbn - Source Block Number (24 bits, 0-16777215)
+ * @param esi - Encoding Symbol ID (24 bits, 0-16777215)
+ * @returns Packed 48-bit value as bigint
+ *
+ * @example
+ * ```ts
+ * import { fecPack } from '@mmt/container/loc'
+ * const packed = fecPack(100, 5) // 419430405n
+ * ```
+ */
+export declare function fecPack(sbn: number, esi: number): bigint;
+/**
+ * Unpack a 48-bit FEC Payload ID into Source Block Number and Encoding Symbol ID.
+ *
+ * Per draft-ramadan-moq-mmt Section 7.3, extracts:
+ * - SBN from upper 24 bits
+ * - ESI from lower 24 bits
+ *
+ * @param packed - Packed 48-bit FEC Payload ID value
+ * @returns Tuple of [sbn, esi] both as numbers
+ *
+ * @example
+ * ```ts
+ * import { fecPack, fecUnpack } from '@mmt/container/loc'
+ * const packed = fecPack(100, 5)
+ * const [sbn, esi] = fecUnpack(packed) // [100, 5]
+ * ```
+ */
+export declare function fecUnpack(packed: bigint): [sbn: number, esi: number];
+/**
+ * FEC Payload ID for LOC extension headers
+ *
+ * Encodes Source Block Number (SBN) and Encoding Symbol ID (ESI)
+ * for FEC recovery with LOC container format.
+ *
+ * @example
+ * ```ts
+ * import { FecPayloadId } from '@mmt/container/loc'
+ *
+ * // Create from SBN/ESI
+ * const fecId = new FecPayloadId(100, 5)
+ *
+ * // Get packed value for extension header
+ * const packed = fecId.packed // 419430405n
+ *
+ * // Create from packed value
+ * const fecId2 = FecPayloadId.fromPacked(packed)
+ * ```
+ */
+export declare class FecPayloadId {
+    /** Source Block Number (24 bits, 0-16777215) */
+    readonly sbn: number;
+    /** Encoding Symbol ID (24 bits, 0-16777215) */
+    readonly esi: number;
+    static readonly TYPE = LOCHeaderExtensionId.FecPayloadId;
+    constructor(
+    /** Source Block Number (24 bits, 0-16777215) */
+    sbn: number, 
+    /** Encoding Symbol ID (24 bits, 0-16777215) */
+    esi: number);
+    /** Get packed 48-bit value */
+    get packed(): bigint;
+    /** Create from packed 48-bit value */
+    static fromPacked(packed: bigint): FecPayloadId;
+    /** Check if value is within valid 24-bit range */
+    static isValidSbn(sbn: number): boolean;
+    /** Check if value is within valid 24-bit range */
+    static isValidEsi(esi: number): boolean;
+}
+//# sourceMappingURL=loc.d.ts.map

package/dist/loc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loc.d.ts","sourceRoot":"","sources":["../src/loc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,gBAAgB,IAAI;IACpB,iBAAiB,IAAI;IACrB,UAAU,IAAI;IACd,WAAW,KAAK;IAChB,mEAAmE;IACnE,YAAY,KAAO;CACpB;AAED,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,WAAW,CAAA;AAE1C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAIpE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAY;IAIrB,gDAAgD;aAChC,GAAG,EAAE,MAAM;IAC3B,+CAA+C;aAC/B,GAAG,EAAE,MAAM;IAN7B,MAAM,CAAC,QAAQ,CAAC,IAAI,qCAAoC;;IAGtD,gDAAgD;IAChC,GAAG,EAAE,MAAM;IAC3B,+CAA+C;IAC/B,GAAG,EAAE,MAAM;IAU7B,8BAA8B;IAC9B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,sCAAsC;IACtC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAK/C,kDAAkD;IAClD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC,kDAAkD;IAClD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAGxC"}

package/dist/loc.js

@@ -0,0 +1,198 @@
+/**
+ * @mmt/container - LOC FEC Extensions
+ *
+ * FEC Payload ID helpers for LOC (Low Overhead Container) format
+ * Per draft-ramadan-moq-mmt Section 7.3
+ *
+ * The FEC Payload ID encodes Source Block Number (SBN) and
+ * Encoding Symbol ID (ESI) as a 48-bit value: (SBN << 24) | ESI
+ *
+ * @packageDocumentation
+ */
+/**
+ * LOC Header Extension IDs
+ */
+export var LOCHeaderExtensionId;
+(function (LOCHeaderExtensionId) {
+    LOCHeaderExtensionId[LOCHeaderExtensionId["CaptureTimestamp"] = 2] = "CaptureTimestamp";
+    LOCHeaderExtensionId[LOCHeaderExtensionId["VideoFrameMarking"] = 4] = "VideoFrameMarking";
+    LOCHeaderExtensionId[LOCHeaderExtensionId["AudioLevel"] = 6] = "AudioLevel";
+    LOCHeaderExtensionId[LOCHeaderExtensionId["VideoConfig"] = 13] = "VideoConfig";
+    /** FEC Payload ID extension (draft-ramadan-moq-mmt Section 7.3) */
+    LOCHeaderExtensionId[LOCHeaderExtensionId["FecPayloadId"] = 16] = "FecPayloadId";
+})(LOCHeaderExtensionId || (LOCHeaderExtensionId = {}));
+/** Maximum value for SBN and ESI (24 bits each) */
+export const FEC_PAYLOAD_ID_MAX = 0xffffff;
+/**
+ * Pack Source Block Number (SBN) and Encoding Symbol ID (ESI) into a 48-bit value.
+ *
+ * Per draft-ramadan-moq-mmt Section 7.3, the FEC Payload ID is encoded as:
+ * `(SBN << 24) | ESI` where both SBN and ESI are 24 bits.
+ *
+ * @param sbn - Source Block Number (24 bits, 0-16777215)
+ * @param esi - Encoding Symbol ID (24 bits, 0-16777215)
+ * @returns Packed 48-bit value as bigint
+ *
+ * @example
+ * ```ts
+ * import { fecPack } from '@mmt/container/loc'
+ * const packed = fecPack(100, 5) // 419430405n
+ * ```
+ */
+export function fecPack(sbn, esi) {
+    return (BigInt(sbn & 0xffffff) << 24n) | BigInt(esi & 0xffffff);
+}
+/**
+ * Unpack a 48-bit FEC Payload ID into Source Block Number and Encoding Symbol ID.
+ *
+ * Per draft-ramadan-moq-mmt Section 7.3, extracts:
+ * - SBN from upper 24 bits
+ * - ESI from lower 24 bits
+ *
+ * @param packed - Packed 48-bit FEC Payload ID value
+ * @returns Tuple of [sbn, esi] both as numbers
+ *
+ * @example
+ * ```ts
+ * import { fecPack, fecUnpack } from '@mmt/container/loc'
+ * const packed = fecPack(100, 5)
+ * const [sbn, esi] = fecUnpack(packed) // [100, 5]
+ * ```
+ */
+export function fecUnpack(packed) {
+    const sbn = Number((packed >> 24n) & 0xffffffn);
+    const esi = Number(packed & 0xffffffn);
+    return [sbn, esi];
+}
+/**
+ * FEC Payload ID for LOC extension headers
+ *
+ * Encodes Source Block Number (SBN) and Encoding Symbol ID (ESI)
+ * for FEC recovery with LOC container format.
+ *
+ * @example
+ * ```ts
+ * import { FecPayloadId } from '@mmt/container/loc'
+ *
+ * // Create from SBN/ESI
+ * const fecId = new FecPayloadId(100, 5)
+ *
+ * // Get packed value for extension header
+ * const packed = fecId.packed // 419430405n
+ *
+ * // Create from packed value
+ * const fecId2 = FecPayloadId.fromPacked(packed)
+ * ```
+ */
+export class FecPayloadId {
+    constructor(
+    /** Source Block Number (24 bits, 0-16777215) */
+    sbn, 
+    /** Encoding Symbol ID (24 bits, 0-16777215) */
+    esi) {
+        this.sbn = sbn;
+        this.esi = esi;
+        if (sbn < 0 || sbn > 0xffffff) {
+            throw new Error('SBN must be 0-16777215 (24 bits)');
+        }
+        if (esi < 0 || esi > 0xffffff) {
+            throw new Error('ESI must be 0-16777215 (24 bits)');
+        }
+    }
+    /** Get packed 48-bit value */
+    get packed() {
+        return fecPack(this.sbn, this.esi);
+    }
+    /** Create from packed 48-bit value */
+    static fromPacked(packed) {
+        const [sbn, esi] = fecUnpack(packed);
+        return new FecPayloadId(sbn, esi);
+    }
+    /** Check if value is within valid 24-bit range */
+    static isValidSbn(sbn) {
+        return sbn >= 0 && sbn <= 0xffffff;
+    }
+    /** Check if value is within valid 24-bit range */
+    static isValidEsi(esi) {
+        return esi >= 0 && esi <= 0xffffff;
+    }
+}
+FecPayloadId.TYPE = LOCHeaderExtensionId.FecPayloadId;
+// =============================================================================
+// Inline Tests (vitest)
+// =============================================================================
+if (import.meta.vitest) {
+    const { describe, test, expect } = import.meta.vitest;
+    describe('FEC Helpers', () => {
+        test('fecPack/fecUnpack roundtrip', () => {
+            const sbn = 12345;
+            const esi = 67890;
+            const packed = fecPack(sbn, esi);
+            const [unpackedSbn, unpackedEsi] = fecUnpack(packed);
+            expect(unpackedSbn).toBe(sbn);
+            expect(unpackedEsi).toBe(esi);
+        });
+        test('fecPack/fecUnpack max values', () => {
+            const sbn = FEC_PAYLOAD_ID_MAX;
+            const esi = FEC_PAYLOAD_ID_MAX;
+            const packed = fecPack(sbn, esi);
+            const [unpackedSbn, unpackedEsi] = fecUnpack(packed);
+            expect(unpackedSbn).toBe(sbn);
+            expect(unpackedEsi).toBe(esi);
+        });
+        test('fecPack/fecUnpack zero', () => {
+            const packed = fecPack(0, 0);
+            expect(packed).toBe(0n);
+            const [sbn, esi] = fecUnpack(0n);
+            expect(sbn).toBe(0);
+            expect(esi).toBe(0);
+        });
+        test('fecPack truncates overflow', () => {
+            const sbn = 0x1ffffff; // 25 bits
+            const esi = 0x1ffffff; // 25 bits
+            const packed = fecPack(sbn, esi);
+            const [unpackedSbn, unpackedEsi] = fecUnpack(packed);
+            expect(unpackedSbn).toBe(FEC_PAYLOAD_ID_MAX);
+            expect(unpackedEsi).toBe(FEC_PAYLOAD_ID_MAX);
+        });
+    });
+    describe('FecPayloadId', () => {
+        test('should create and roundtrip', () => {
+            const sbn = 12345;
+            const esi = 67890;
+            const fecId = new FecPayloadId(sbn, esi);
+            expect(fecId.sbn).toBe(sbn);
+            expect(fecId.esi).toBe(esi);
+            const fecId2 = FecPayloadId.fromPacked(fecId.packed);
+            expect(fecId2.sbn).toBe(sbn);
+            expect(fecId2.esi).toBe(esi);
+        });
+        test('should handle max 24-bit values', () => {
+            const sbn = 0xffffff;
+            const esi = 0xffffff;
+            const fecId = new FecPayloadId(sbn, esi);
+            const fecId2 = FecPayloadId.fromPacked(fecId.packed);
+            expect(fecId2.sbn).toBe(sbn);
+            expect(fecId2.esi).toBe(esi);
+        });
+        test('should reject invalid SBN', () => {
+            expect(() => new FecPayloadId(-1, 0)).toThrow();
+            expect(() => new FecPayloadId(0x1000000, 0)).toThrow();
+        });
+        test('should reject invalid ESI', () => {
+            expect(() => new FecPayloadId(0, -1)).toThrow();
+            expect(() => new FecPayloadId(0, 0x1000000)).toThrow();
+        });
+        test('isValidSbn/isValidEsi', () => {
+            expect(FecPayloadId.isValidSbn(0)).toBe(true);
+            expect(FecPayloadId.isValidSbn(0xffffff)).toBe(true);
+            expect(FecPayloadId.isValidSbn(-1)).toBe(false);
+            expect(FecPayloadId.isValidSbn(0x1000000)).toBe(false);
+            expect(FecPayloadId.isValidEsi(0)).toBe(true);
+            expect(FecPayloadId.isValidEsi(0xffffff)).toBe(true);
+            expect(FecPayloadId.isValidEsi(-1)).toBe(false);
+            expect(FecPayloadId.isValidEsi(0x1000000)).toBe(false);
+        });
+    });
+}
+//# sourceMappingURL=loc.js.map

package/dist/loc.js.map

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

package/dist/mfu-reassembler.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @mmt/container - MFU Fragment Reassembler
+ *
+ * Handles out-of-order delivery of fragmented MFUs (Media Fragment Units)
+ * according to ISO/IEC 23008-1:2023 Section 9.2.3.3
+ *
+ * Fragmentation Indicator (FI) values:
+ * - 0: Complete MFU (single packet, no fragmentation)
+ * - 1: First fragment
+ * - 2: Middle fragment
+ * - 3: Last fragment
+ *
+ * @packageDocumentation
+ */
+/**
+ * MFU Fragment for reassembly
+ */
+export interface MFUFragment {
+    fragmentationIndicator: number;
+    mpuSequenceNumber: number;
+    fragmentCounter: number;
+    data: Uint8Array;
+    timestamp: bigint;
+    receivedAt: number;
+    /** Random Access Point flag from MMTP header - indicates keyframe */
+    rapFlag: boolean;
+}
+/**
+ * Reassembled MFU result
+ */
+export interface ReassembledMFU {
+    mpuSequenceNumber: number;
+    data: Uint8Array;
+    timestamp: bigint;
+    fragmentCount: number;
+    /** Random Access Point flag - indicates keyframe (from first fragment) */
+    rapFlag: boolean;
+}
+/**
+ * Reassembler statistics
+ */
+export interface ReassemblerStats {
+    totalFragments: number;
+    reassembledMFUs: number;
+    timedOutMFUs: number;
+    outOfOrderFragments: number;
+}
+export interface MFUReassemblerOptions {
+    /** Timeout in milliseconds for incomplete MFUs (default: 1000) */
+    timeoutMs?: number;
+    /** Maximum buffered MFUs before eviction (default: 100) */
+    maxBuffered?: number;
+}
+/**
+ * MFU Reassembler for out-of-order fragment delivery
+ * Based on ISO/IEC 23008-1:2023 Section 9.2.3.3
+ */
+export declare class MFUReassembler {
+    #private;
+    /** Statistics for debugging */
+    readonly stats: ReassemblerStats;
+    constructor(options?: MFUReassemblerOptions);
+    /**
+     * Add a fragment and return reassembled MFU if complete
+     */
+    addFragment(fragment: MFUFragment): ReassembledMFU | null;
+    /**
+     * Flush all buffered fragments
+     */
+    flush(): void;
+    /**
+     * Get number of pending MFUs
+     */
+    get pendingCount(): number;
+    /**
+     * Get current buffer status
+     */
+    getStatus(): {
+        bufferedMFUs: number;
+        pendingFragments: number;
+        stats: ReassemblerStats;
+    };
+}
+/**
+ * Create MFU fragment from MMTP packet for reassembly
+ */
+export declare function createFragment(mmtpPacket: Uint8Array): MFUFragment;
+/**
+ * Process MMTP packet with fragment reassembly
+ */
+export declare function processMMTPWithReassembly(mmtpPacket: Uint8Array, reassembler: MFUReassembler): ReassembledMFU | null;
+//# sourceMappingURL=mfu-reassembler.d.ts.map

package/dist/mfu-reassembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mfu-reassembler.d.ts","sourceRoot":"","sources":["../src/mfu-reassembler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,iBAAiB,EAAE,MAAM,CAAA;IACzB,eAAe,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iBAAiB,EAAE,MAAM,CAAA;IACzB,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,0EAA0E;IAC1E,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,qBAAa,cAAc;;IAMzB,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAK/B;gBAEW,OAAO,CAAC,EAAE,qBAAqB;IAK3C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,cAAc,GAAG,IAAI;IAqIzD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,SAAS,IAAI;QACX,YAAY,EAAE,MAAM,CAAA;QACpB,gBAAgB,EAAE,MAAM,CAAA;QACxB,KAAK,EAAE,gBAAgB,CAAA;KACxB;CAYF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAwBlE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,cAAc,GAC1B,cAAc,GAAG,IAAI,CAQvB"}