@blockcast/mmt-container 0.1.0 → 0.3.0-main.d9354616fdf2

package/node_modules/@blockcast/mmt-base/dist/fec-block-profile.js

@@ -0,0 +1,128 @@
+/**
+ * FEC block profile (BLO-35597, ISO/IEC 23008-1 Annex C).
+ *
+ * Every catalog `fec` object that declares an FEC instance names exactly one
+ * block profile in `fec.blockProfile`. A receiver applies all of a profile's
+ * rules or none of them, so the token is the one explicit per-stream
+ * discriminator: it is never defaulted and never inferred from the wire.
+ *
+ * - `k-padded-v1` (legacy, Blockcast-private): a source symbol is the
+ *   protected MMTP packet zero-padded to T with no length field; every block
+ *   is a K-symbol RaptorQ block whose ESIs `SSB_length..K-1` are implicit
+ *   zero padding; `SS_ID = SBN*K + ESI`, so `SS_Start = SBN*K`; repair
+ *   ESI = K + RS_ID; the MoQ repair group id is the SBN.
+ * - `iso-ssbg1-v1`: ssbg_mode1 (C.3.3): a source symbol is
+ *   `u16 length || protected packet || zero padding` to T; a block is a
+ *   K' = SSB_length RaptorQ block (C.5.3) and repair ESI = SSB_length + RS_ID;
+ *   SS_ID increments by one per FEC source packet and wraps at 2^32 (C.5.2),
+ *   so a block is located by membership in `[SS_Start, SS_Start + SSB_length)`
+ *   under RFC 1982 serial arithmetic; the MoQ repair group id is the 62-bit
+ *   wrap-epoch-extended SS_Start. The AL-FEC coding byte for this profile is
+ *   0x14 (one-stage, ssbg_mode1, fec_payload_id_mode 0, Amd 1:2025 Table C.3).
+ */
+import { serial32Add, serial32Distance, serial32Precedes } from './serial-number.js';
+/** Every accepted `fec.blockProfile` token, legacy first. */
+export const FEC_BLOCK_PROFILES = Object.freeze([
+    'k-padded-v1',
+    'iso-ssbg1-v1',
+]);
+/** True for a known block-profile token. */
+export function isFecBlockProfile(value) {
+    return value === 'k-padded-v1' || value === 'iso-ssbg1-v1';
+}
+/**
+ * Read a required `fec.blockProfile`. Throws on an absent or unknown token:
+ * there is no default and nothing is inferred, because the two profiles carry
+ * identical wire tuples whose repair math differs.
+ *
+ * @param where the catalog path of the field, for the error message.
+ */
+export function parseFecBlockProfile(value, where) {
+    if (isFecBlockProfile(value))
+        return value;
+    if (value === undefined) {
+        throw new Error(`${where} is required: name the FEC block profile ("k-padded-v1" or "iso-ssbg1-v1")`);
+    }
+    throw new Error(`${where} must be "k-padded-v1" or "iso-ssbg1-v1" (got ${JSON.stringify(value)})`);
+}
+/** ISO/IEC 23008-1 C.3.3 ssbg_mode1: the two-octet packet length field. */
+export const SSBG1_LENGTH_FIELD_BYTES = 2;
+/** The largest protected packet an ssbg_mode1 symbol of size T can carry. */
+export function ssbg1MaxPacketLength(symbolSize) {
+    return symbolSize - SSBG1_LENGTH_FIELD_BYTES;
+}
+/** Whether a protected packet of `packetLength` bytes fits one T-byte ssbg_mode1 symbol. */
+export function ssbg1FitsSymbol(packetLength, symbolSize) {
+    return (Number.isSafeInteger(packetLength) &&
+        packetLength >= 0 &&
+        packetLength <= ssbg1MaxPacketLength(symbolSize) &&
+        packetLength <= 0xffff);
+}
+/**
+ * Build one ssbg_mode1 source symbol (C.3.3): the protected packet's length
+ * in two octets, network byte order, then the packet, then zero octets up to
+ * T. The protected packet is the MMTP packet before its Source FEC Payload ID
+ * is appended (C.4.2).
+ *
+ * @throws when `length + 2 > T`: the packet cannot be protected under this
+ * profile, and silently truncating it would corrupt every repair symbol.
+ */
+export function buildSsbg1SourceSymbol(packet, symbolSize) {
+    if (!Number.isSafeInteger(symbolSize) || symbolSize <= SSBG1_LENGTH_FIELD_BYTES) {
+        throw new Error(`ssbg_mode1 symbol size must exceed ${SSBG1_LENGTH_FIELD_BYTES} (got ${symbolSize})`);
+    }
+    if (!ssbg1FitsSymbol(packet.byteLength, symbolSize)) {
+        throw new Error(`ssbg_mode1 source symbol needs ${packet.byteLength} + ${SSBG1_LENGTH_FIELD_BYTES} bytes but T is ${symbolSize}`);
+    }
+    const symbol = new Uint8Array(symbolSize);
+    symbol[0] = (packet.byteLength >>> 8) & 0xff;
+    symbol[1] = packet.byteLength & 0xff;
+    symbol.set(packet, SSBG1_LENGTH_FIELD_BYTES);
+    return symbol;
+}
+/**
+ * Recover the protected packet from one ssbg_mode1 source symbol: the bytes
+ * the length field names. Returns null, never a guess, when the length field
+ * points past the symbol or any padding octet is non-zero (C.3.3 padding is
+ * all 00h), since either means the recovered symbol is not what was sent.
+ */
+export function trimSsbg1SourceSymbol(symbol) {
+    if (symbol.byteLength < SSBG1_LENGTH_FIELD_BYTES)
+        return null;
+    const length = (symbol[0] << 8) | symbol[1];
+    const end = SSBG1_LENGTH_FIELD_BYTES + length;
+    if (end > symbol.byteLength)
+        return null;
+    for (let i = end; i < symbol.byteLength; i++) {
+        if (symbol[i] !== 0)
+            return null;
+    }
+    return symbol.subarray(SSBG1_LENGTH_FIELD_BYTES, end);
+}
+/** The SS_ID after the last source symbol of `[ssStart, ssStart + ssbLength)`. */
+export function isoBlockEnd(ssStart, ssbLength) {
+    return serial32Add(ssStart, ssbLength);
+}
+/**
+ * Range membership (C.5.2, C.5.3): whether `ssId` is one of the
+ * `ssbLength` consecutive SS_IDs starting at `ssStart`, modulo 2^32.
+ */
+export function isoBlockContains(ssStart, ssbLength, ssId) {
+    return serial32Distance(ssStart, ssId) < ssbLength;
+}
+/**
+ * A lower bound on how many blocks the block starting at `a` lies behind the
+ * one starting at `b` (0 when `a` does not precede `b`). An iso-ssbg1-v1
+ * block holds at most `kMax` source symbols (the catalog `sourceSymbols`, the
+ * AL-FEC maximum_k_for_repair_flow), so `n * kMax` SS_IDs always span at least
+ * `n` blocks. Every interleave horizon in the receiver (decoder retention,
+ * worker retirement, ordered-relay settlement) uses this one bound, so the
+ * manager's horizon can never fall inside the decoder's.
+ */
+export function isoBlocksBehindLowerBound(a, b, kMax) {
+    if (!Number.isSafeInteger(kMax) || kMax <= 0) {
+        throw new Error(`iso-ssbg1-v1 block horizon needs a positive maximum K (got ${kMax})`);
+    }
+    return serial32Precedes(a, b) ? Math.floor(serial32Distance(a, b) / kMax) : 0;
+}
+//# sourceMappingURL=fec-block-profile.js.map

package/node_modules/@blockcast/mmt-base/dist/fec-block-profile.js.map

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

package/node_modules/@blockcast/mmt-base/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './mmtp.js';
+export * from './net-constants.js';
+export * from './ntp-short.js';
+export * from './signalling.js';
+export * from './serial-number.js';
+export * from './fec-block-profile.js';
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@blockcast/mmt-base/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA"}

package/node_modules/@blockcast/mmt-base/dist/index.js

@@ -0,0 +1,7 @@
+export * from './mmtp.js';
+export * from './net-constants.js';
+export * from './ntp-short.js';
+export * from './signalling.js';
+export * from './serial-number.js';
+export * from './fec-block-profile.js';
+//# sourceMappingURL=index.js.map

package/node_modules/@blockcast/mmt-base/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA"}

package/node_modules/@blockcast/mmt-base/dist/mmtp.d.ts

@@ -0,0 +1,292 @@
+import { extractAltaTrailer as _leafExtractAltaTrailer, type AltaTrailer as _LeafAltaTrailer } from '@blockcast/mmt-alta-parse';
+/**
+ * @mmt/container - MMTP Parser
+ *
+ * MMTP (MMT Protocol) packet parser based on ISO/IEC 23008-1:2023 Section 9.2
+ *
+ * MMTP header format (12 bytes):
+ * - Byte 0: V(2) | C(1) | FEC_type(2) | r(1) | X(1) | R(1)
+ * - Byte 1: reserved(2) | packet_type(6)
+ * - Bytes 2-3: packet_id (big-endian)
+ * - Bytes 4-7: timestamp (big-endian, 32-bit)
+ * - Bytes 8-11: sequence_number (big-endian)
+ *
+ * FEC_type values:
+ * - 0: No FEC / source packet
+ * - 1: FEC mode 0 (source with FEC payload ID)
+ * - 2: FEC repair packet mode 0
+ * - 3: FEC repair packet mode 1
+ *
+ * @packageDocumentation
+ */
+export interface MMTPHeader {
+    version: number;
+    /** Packet type: 0x00=MPU, 0x02=Signaling, 0x03=Repair */
+    packetType: number;
+    packetId: number;
+    timestamp: bigint;
+    sequenceNumber: number;
+    payloadLength: number;
+    fecType: number;
+    /** C flag: header carries a 32-bit packet_counter. */
+    packetCounterFlag: boolean;
+    packetCounter?: number;
+    /** X flag: header carries an extension header and value. */
+    extensionFlag: boolean;
+    extension?: {
+        type: number;
+        data: Uint8Array;
+    };
+    /** Byte offset at which the MMTP payload begins. */
+    headerLength: number;
+    /** Random Access Point flag - indicates keyframe (ISO 23008-1, byte 0 bit 0) */
+    rapFlag: boolean;
+}
+export interface MPUHeader {
+    mpuSequenceNumber: number;
+    fragmentationIndicator: number;
+    /** 8-bit MPU fragment_counter from byte 3. */
+    fragmentCounter: number;
+    /** T flag: 1=timed media (14-byte MFU DU header), 0=non-timed (4-byte header) */
+    timedFlag: number;
+    /** A flag: aggregated MPU payload. This strict profile requires A=0. */
+    aggregationFlag: boolean;
+    /** MPU payload_length (bytes 0-1): bytes after the length field, including
+     *  the remaining six MPU-header bytes and all data-unit bytes. */
+    payloadLength: number;
+}
+export interface MFUDuHeader {
+    movieFragmentSequenceNumber: number;
+    sampleNumber: number;
+    offset: number;
+    priority: number;
+    dependencyCounter: number;
+}
+export interface MMTPPacket {
+    header: MMTPHeader;
+    payload: Uint8Array;
+}
+export declare const MMTP_HEADER_SIZE = 12;
+export declare const MPU_HEADER_SIZE = 8;
+export declare const MFU_DU_HEADER_SIZE_TIMED = 14;
+export declare const MFU_DU_HEADER_SIZE_NONTIMED = 4;
+export declare const PACKET_TYPE_MPU = 0;
+export declare const PACKET_TYPE_SIGNALING = 2;
+export declare const PACKET_TYPE_REPAIR = 3;
+export declare const ALFEC_MESSAGE_ID = 515;
+/**
+ * MMTP `packet_id` of the signaling flow, which carries PACKET_TYPE_SIGNALING
+ * packets such as the AL-FEC message (ALFEC_MESSAGE_ID). The FFmpeg `moq_mmt`
+ * muxer sends that message on this packet_id into the same multicast group as
+ * the media, and moqcast-draft (PR #44) makes advertising it for a track a
+ * MUST NOT. A track's packet_id is therefore 1..MMTP_PACKET_ID_MAX.
+ */
+export declare const MMTP_SIGNALING_PACKET_ID = 0;
+/** Largest value of the 16-bit MMTP `packet_id` header field. */
+export declare const MMTP_PACKET_ID_MAX = 65535;
+export declare const FEC_CODE_XOR = 1;
+export declare const FEC_CODE_RAPTORQ = 2;
+/**
+ * Parse MMTP header from buffer
+ */
+export declare function parseMMTPHeader(buffer: Uint8Array): MMTPHeader;
+/**
+ * The MMTP `packet_id` of `buffer`, or null exactly when parseMMTPHeader would
+ * throw for it (short buffer, V != 0, truncated packet_counter or header
+ * extension).
+ *
+ * This is the per-packet filter a receiver runs before any other work, so it
+ * builds no header object, DataView or BigInt timestamp (BLO-36599). Use
+ * parseMMTPHeader when any other header field is needed.
+ */
+export declare function readMMTPPacketId(buffer: Uint8Array): number | null;
+/**
+ * Unwrap MMTP packet to extract payload
+ */
+export declare function unwrapMMTP(buffer: Uint8Array): MMTPPacket;
+/**
+ * Parse MPU header from payload
+ * ISO/IEC 23008-1:2023 Section 9.2.3.3
+ *
+ * MPU Header format (8 bytes) as written by FFmpeg/libmmt:
+ * - Bytes 0-1: payload_length (16 bits, big-endian)
+ * - Byte 2: FT(4) | T(1) | FI(2) | A(1)
+ * - Byte 3: fragment_counter (8 bits)
+ * - Bytes 4-7: MPU_sequence_number (32 bits, big-endian)
+ */
+export declare function parseMPUHeader(payload: Uint8Array): MPUHeader;
+export declare function parseTimedMfuDuHeader(payload: Uint8Array, offset: number): MFUDuHeader | null;
+/**
+ * Why `extractMFUPayload` refused a packet.
+ *
+ * These identifiers are part of the public contract: callers surface them in
+ * diagnostics, so renaming one is a breaking change.
+ */
+export type MFURejectionGate = 'packet-shorter-than-mmtp-plus-mpu-header' | 'mmtp-header-unparseable' | 'not-an-mpu-packet' | 'payload-shorter-than-mpu-header' | 'aggregation-flag-set' | 'mpu-payload-length-below-header-remainder' | 'mpu-declared-end-exceeds-payload' | 'mfu-offset-at-or-past-declared-end' | 'source-fec-payload-id-width-mismatch' | 'declared-trailers-unresolved';
+export interface MFURejection {
+    gate: MFURejectionGate;
+    /** Human-readable detail, including the byte arithmetic that decided it. */
+    detail: string;
+}
+/**
+ * Extract NAL unit payload from MMTP packet
+ */
+export declare function extractNALUnit(mmtpPacket: Uint8Array): Uint8Array;
+/** Result of extracting MFU payload from an MMTP packet */
+export interface MFUExtraction {
+    /** MMTP header fields */
+    header: MMTPHeader;
+    /** MPU header fields */
+    mpu: MPUHeader;
+    /** Fragment type (FT field, 4 bits): 0=metadata, 2=MFU data */
+    fragmentType: number;
+    /** MFU payload data (video/audio bytes, headers stripped, FEC ID excluded) */
+    data: Uint8Array;
+    /** Parsed timed MFU DU header when present, otherwise null */
+    mfuDuHeader: MFUDuHeader | null;
+    /** Non-timed MFU Item_ID when the 4-byte DU header is present. */
+    itemId: number | null;
+    /** Source FEC Payload ID if present (`FEC_type == 1`), or null */
+    fecPayloadId: {
+        ssId: number;
+    } | null;
+}
+/**
+ * Report why `extractMFUPayload` would refuse this packet, or null if it would
+ * accept it.
+ *
+ * `extractMFUPayload` returns bare `null` on ten distinct conditions, which
+ * makes a producer/consumer framing disagreement indistinguishable from a
+ * publisher that never started — both render as silence. Use this wherever
+ * that distinction matters: diagnostics, contract tests, and operator-facing
+ * logs.
+ */
+export declare function explainMFURejection(mmtpPacket: Uint8Array, options?: {
+    skipFecId?: boolean;
+}): MFURejection | null;
+export declare function extractMFUPayload(mmtpPacket: Uint8Array, options?: {
+    skipFecId?: boolean;
+}): MFUExtraction | null;
+/**
+ * extractMFUPayload for a caller that already holds this packet's parsed MMTP
+ * header, so the header is not parsed a second time (BLO-36599).
+ *
+ * `header` must be `parseMMTPHeader(mmtpPacket)` of this same packet; the
+ * result is then identical to `extractMFUPayload(mmtpPacket, options)`.
+ */
+export declare function extractMFUPayloadWithHeader(mmtpPacket: Uint8Array, header: MMTPHeader, options?: {
+    skipFecId?: boolean;
+}): MFUExtraction | null;
+/**
+ * Extract timestamp from MMTP packet
+ */
+export declare function extractTimestamp(mmtpPacket: Uint8Array): bigint;
+/**
+ * Check if MMTP packet is an FEC repair packet
+ * FEC_type 2 and 3 are repair packets
+ */
+export declare function isFecRepairPacket(mmtpPacket: Uint8Array): boolean;
+/**
+ * Extract Source FEC Payload ID (SS_ID) from the last 4 bytes of an MMTP
+ * source packet per ISO/IEC 23008-1:2023 Section C.5.2 Figure C.10.
+ *
+ * SS_ID is a flat 32-bit monotonic counter (incremented by 1 per packet
+ * for ssbg_mode0 and ssbg_mode1). Block membership and ESI use the
+ * configured K; repair SS_Start identifies the first SS_ID of the block and
+ * SSB_length records the authored source-symbol count:
+ *   SBN = floor(SS_ID / K), ESI = SS_ID % K
+ *   SS_Start = SBN * K  (first SS_ID of the block)
+ *
+ * This matches FFmpeg moqenc_mmt.c, the drafts (draft-ramadan-moq-fec §6.2),
+ * and ATSC A/331 §8.1.2.5 which defers to ISO 23008-1 Annex C.
+ */
+export declare function extractFecPayloadId(mmtpPacket: Uint8Array): {
+    ssId: number;
+} | null;
+/**
+ * Return true when FEC_type=1 and the exact suffix after the ISO-declared MPU
+ * payload contains a four-byte Source FEC Payload ID.
+ */
+export declare function hasSourceFecPayloadId(mmtpPacket: Uint8Array): boolean;
+/**
+ * The Source FEC Payload ID of a packet whose MMTP header the caller already
+ * parsed, or null when the packet carries none: present only when FEC_type=1
+ * and the exact suffix after the ISO-declared MPU payload holds the four-byte
+ * ID (ISO/IEC 23008-1 §C.5.2). Same answer as extractFecPayloadId, without a
+ * second header parse (BLO-36599).
+ *
+ * `header` must be `parseMMTPHeader(mmtpPacket)` of this same packet.
+ */
+export declare function sourceFecPayloadIdOf(mmtpPacket: Uint8Array, header: MMTPHeader): {
+    ssId: number;
+} | null;
+/**
+ * MMTP header-extension ext_type assigned to the detached ALTA authenticator
+ * trailer (Path 2 / 08-07). Carried in an `[ext_type][ext_length][auth]`
+ * block appended after the MPU's declared payload bytes, before the 4-byte
+ * Source FEC Payload ID. MMTP X-bit stays 0 — non-ALTA MMTP receivers treat
+ * the trailer as bytes past `payload_length` and skip it (per ISO 23008-1
+ * §9.2.2 "may be discarded without impacting correct processing").
+ */
+export declare const MMTP_EXT_TYPE_ALTA_AUTH = 61601;
+export declare const MMTP_EXT_TRAILER_HEADER_SIZE = 4;
+export type AltaTrailer = _LeafAltaTrailer;
+export declare const extractAltaTrailer: typeof _leafExtractAltaTrailer;
+/** Size of Repair FEC Payload ID per ISO/IEC 23008-1 Section C.5.3 */
+export declare const REPAIR_FEC_PID_SIZE = 13;
+/**
+ * Extract Repair FEC Payload ID from a raw-multicast MMTP repair packet.
+ * Per ISO/IEC 23008-1:2023 Section C.5.3 (ssbg_mode0, one-stage, no FFSRP_TS):
+ *   [MMTP header][SS_Start:4][RSB_length:3][RS_ID:3][SSB_length:3][repair data]
+ * OTI is delivered via AL-FEC signaling message (Table C.3), not per-packet.
+ *
+ * Byte 1 is reserved(2)|packet_type(6) for V=0, so repair type 0x03 is 0x03.
+ * Pre-migration high-bits bytes (0x0c) are rejected — no compatibility decode.
+ */
+export declare function extractRepairFecPayloadId(mmtpPacket: Uint8Array): {
+    ssStart: number;
+    rsbLength: number;
+    rsId: number;
+    ssbLength: number;
+} | null;
+/** Parsed MoQ repair frame per ISO/IEC 23008-1 Section C.4.3 + C.5.3 */
+export interface MoqRepairFrame {
+    /** MMTP packetId (1=video, 2=audio) — for routing to correct FEC decoder */
+    packetId: number;
+    /** SS_Start (32 bits): SS_ID of first source symbol in block */
+    ssStart: number;
+    /** RSB_length (24 bits): number of repair symbols (P) */
+    rsbLength: number;
+    /** RS_ID (24 bits): repair symbol index (0-based) */
+    rsId: number;
+    /** SSB_length (24 bits): authored source-symbol count (1..=configured K) */
+    ssbLength: number;
+    /** Repair symbol data after the dynamic MMTP header and 13-byte FEC payload ID. */
+    symbolData: Uint8Array;
+}
+/**
+ * Parse a MoQ repair frame (ISO/IEC 23008-1 Annex C format).
+ *
+ * Wire format per ISO 23008-1 §C.4.3 + §C.5.3:
+ *   MMTP Header: fixed 12 bytes plus C/X optional fields
+ *   then SS_Start (4 bytes) → block identifier
+ *   then RSB_length (3 bytes) → P
+ *   then RS_ID (3 bytes) → ESI = K + RS_ID
+ *   then SSB_length (3 bytes) → authored source-symbol count (1..=K)
+ *   then Repair Symbol Data (T bytes)
+ *
+ * @param frame - Raw MoQ repair frame bytes
+ * @returns Parsed frame or null if invalid
+ */
+export declare function parseMoqRepairFrame(frame: Uint8Array): MoqRepairFrame | null;
+/**
+ * parseMoqRepairFrame for a caller that already holds this frame's parsed MMTP
+ * header, so the header is not parsed a second time (BLO-36599). The router's
+ * multicast repair branch uses it: one repair packet in every K + P otherwise
+ * paid two header parses.
+ *
+ * `header` must be `parseMMTPHeader(frame)` of this same frame; the result is
+ * then identical to `parseMoqRepairFrame(frame)`.
+ */
+export declare function parseMoqRepairFrameWithHeader(frame: Uint8Array, header: MMTPHeader): MoqRepairFrame | null;
+//# sourceMappingURL=mmtp.d.ts.map

package/node_modules/@blockcast/mmt-base/dist/mmtp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mmtp.d.ts","sourceRoot":"","sources":["../src/mmtp.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,kBAAkB,IAAI,uBAAuB,EAC7C,KAAK,WAAW,IAAI,gBAAgB,EACrC,MAAM,2BAA2B,CAAA;AAElC;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,iBAAiB,EAAE,OAAO,CAAA;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4DAA4D;IAC5D,aAAa,EAAE,OAAO,CAAA;IACtB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,CAAA;IAC9C,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAA;IACvB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAA;IACjB,wEAAwE;IACxE,eAAe,EAAE,OAAO,CAAA;IACxB;sEACkE;IAClE,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,2BAA2B,EAAE,MAAM,CAAA;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,EAAE,UAAU,CAAA;CACpB;AAED,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAClC,eAAO,MAAM,eAAe,IAAI,CAAA;AAChC,eAAO,MAAM,wBAAwB,KAAK,CAAA;AAC1C,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAO5C,eAAO,MAAM,eAAe,IAAO,CAAA;AACnC,eAAO,MAAM,qBAAqB,IAAO,CAAA;AACzC,eAAO,MAAM,kBAAkB,IAAO,CAAA;AAGtC,eAAO,MAAM,gBAAgB,MAAS,CAAA;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAA;AAEzC,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,QAAS,CAAA;AAGxC,eAAO,MAAM,YAAY,IAAI,CAAA;AAC7B,eAAO,MAAM,gBAAgB,IAAI,CAAA;AAEjC;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAuE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAelE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,CAKzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CA+B7D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAU7F;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,0CAA0C,GAC1C,yBAAyB,GACzB,mBAAmB,GACnB,iCAAiC,GACjC,sBAAsB,GACtB,2CAA2C,GAC3C,kCAAkC,GAClC,oCAAoC,GACpC,sCAAsC,GACtC,8BAA8B,CAAA;AAElC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAA;IACtB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAA;CACf;AA4GD;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAIjE;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,MAAM,EAAE,UAAU,CAAA;IAClB,wBAAwB;IACxB,GAAG,EAAE,SAAS,CAAA;IACd,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAA;IACpB,8EAA8E;IAC9E,IAAI,EAAE,UAAU,CAAA;IAChB,8DAA8D;IAC9D,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAC/B,kEAAkE;IAClE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,kEAAkE;IAClE,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACtC;AA0ID;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,YAAY,GAAG,IAAI,CAGrB;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,aAAa,GAAG,IAAI,CAEtB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,aAAa,GAAG,IAAI,CAEtB;AAqCD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAG/D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAIjE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGnF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAGrE;AAWD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,UAAU,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqBzB;AAED;;;;;;;GAOG;AAIH,eAAO,MAAM,uBAAuB,QAAgC,CAAA;AACpE,eAAO,MAAM,4BAA4B,IAAqC,CAAA;AAC9E,MAAM,MAAM,WAAW,GAAG,gBAAgB,CAAA;AAC1C,eAAO,MAAM,kBAAkB,gCAA0B,CAAA;AAEzD,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,KAAK,CAAA;AA2CrC;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,UAAU,GAAG;IACjE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CACpE,GAAG,IAAI,CASP;AAED,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAA;IACf,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAA;IACjB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAA;IACjB,mFAAmF;IACnF,UAAU,EAAE,UAAU,CAAA;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,GAAG,IAAI,CAE5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,UAAU,GACjB,cAAc,GAAG,IAAI,CAEvB"}