@layerzerolabs/common-encoding-utils 0.2.64 → 0.2.66

package/.turbo/turbo-build.log

@@ -3,7 +3,7 @@
 > @layerzerolabs/common-encoding-utils@0.0.0 build /home/runner/work/monorepo-internal/monorepo-internal/packages/common/common-encoding-utils
 > tsup
 
-CLI Building entry: src/index.ts
+CLI Building entry: src/byte-codec.ts, src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.5.1
 CLI Using tsup config: /home/runner/work/monorepo-internal/monorepo-internal/packages/common/common-encoding-utils/tsup.config.ts
@@ -11,9 +11,17 @@
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
-CJS dist/index.cjs     5.03 KB
-CJS dist/index.cjs.map 11.80 KB
-CJS ⚡️ Build success in 123ms
-ESM dist/index.js     4.64 KB
-ESM dist/index.js.map 11.79 KB
-ESM ⚡️ Build success in 123ms
+CJS dist/byte-codec.cjs     267.00 B
+CJS dist/index.cjs          5.61 KB
+CJS dist/DF2CBFKF.cjs       7.67 KB
+CJS dist/byte-codec.cjs.map 75.00 B
+CJS dist/index.cjs.map      12.44 KB
+CJS dist/DF2CBFKF.cjs.map   19.07 KB
+CJS ⚡️ Build success in 326ms
+ESM dist/byte-codec.js     120.00 B
+ESM dist/index.js          4.85 KB
+ESM dist/2BTCXNB3.js       7.63 KB
+ESM dist/byte-codec.js.map 74.00 B
+ESM dist/index.js.map      12.42 KB
+ESM dist/2BTCXNB3.js.map   19.06 KB
+ESM ⚡️ Build success in 326ms

package/.turbo/turbo-lint.log

@@ -2,7 +2,7 @@
 > @layerzerolabs/common-encoding-utils@0.0.0 lint /home/runner/work/monorepo-internal/monorepo-internal/packages/common/common-encoding-utils
 > eslint . --max-warnings 0 || (eslint . --fix --max-warnings 0 && false)
 
-(node:58063) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/runner/work/monorepo-internal/monorepo-internal/eslint.config.js?mtime=1775024037920 is not specified and it doesn't parse as CommonJS.
+(node:65664) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/runner/work/monorepo-internal/monorepo-internal/eslint.config.js?mtime=1775694520701 is not specified and it doesn't parse as CommonJS.
 Reparsing as ES module because module syntax was detected. This incurs a performance overhead.
 To eliminate this warning, add "type": "module" to /home/runner/work/monorepo-internal/monorepo-internal/package.json.
 (Use `node --trace-warnings ...` to show where the warning was created)

package/dist/2BTCXNB3.js

@@ -0,0 +1,221 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/byte-codec.ts
+function uMax(bits) {
+  if (!Number.isInteger(bits) || bits < 0) {
+    throw new RangeError(`ByteCodec: invalid bit width: ${bits}`);
+  }
+  return bits === 0 ? 0n : (1n << BigInt(bits)) - 1n;
+}
+__name(uMax, "uMax");
+var ByteCodec = class _ByteCodec {
+  static {
+    __name(this, "ByteCodec");
+  }
+  // Start with a small-ish initial capacity to avoid frequent reallocations for
+  // common short payloads (e.g. function selector + a few fixed-width fields),
+  // while still staying tiny in memory terms. Buffer grows by doubling as needed.
+  #buf = new ArrayBuffer(128);
+  #view = new DataView(this.#buf);
+  #cursor = 0;
+  static #ZERO = 0n;
+  static #U8_MAX = uMax(8);
+  static #U16_MAX = uMax(16);
+  static #U32_MAX = uMax(32);
+  static #U64_MAX = uMax(64);
+  static #U128_MAX = uMax(128);
+  static #U256_MAX = uMax(256);
+  static #outOfRange(targetLength, value) {
+    return new RangeError(`ByteCodec: value out of range for u${targetLength * 8}: ${value}`);
+  }
+  /**
+   * Read helpers (big-endian). These are intentionally small/low-level so other
+   * packages can share a single implementation for parsing encoded payloads.
+   */
+  static readU16be(buf, offset) {
+    const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    return view.getUint16(offset, false);
+  }
+  static readU8(buf, offset) {
+    const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    return view.getUint8(offset);
+  }
+  static readU32be(buf, offset) {
+    const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    return view.getUint32(offset, false);
+  }
+  static readU128be(buf, offset) {
+    return _ByteCodec.readUNbe(buf, offset, 16);
+  }
+  static readUNbe(buf, offset, length) {
+    const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    let out = 0n;
+    const end = offset + length;
+    let cursor = offset;
+    while (cursor + 8 <= end) {
+      out = out << 64n | view.getBigUint64(cursor, false);
+      cursor += 8;
+    }
+    while (cursor < end) {
+      out = out << 8n | BigInt(view.getUint8(cursor));
+      cursor += 1;
+    }
+    return out;
+  }
+  static readBytes32(buf, offset) {
+    if (offset + 32 > buf.length) throw new RangeError(`ByteCodec: out of bounds at ${offset}`);
+    return buf.slice(offset, offset + 32);
+  }
+  /**
+   * Left-pad `bytes` to `targetLength` using `padByte` (default 0x00).
+   *
+   * Commonly used to mimic Solidity's `bytes32(bytesN)`-style left zero padding.
+   */
+  static leftPad(bytes, targetLength, padByte = 0) {
+    if (!Number.isInteger(targetLength) || targetLength < 0) {
+      throw new RangeError(`ByteCodec: invalid length: target=${targetLength}`);
+    }
+    if (!Number.isInteger(padByte) || padByte < 0 || padByte > 255) {
+      throw new RangeError(`ByteCodec: invalid pad byte: ${padByte}`);
+    }
+    if (bytes.length > targetLength) {
+      throw new RangeError(`ByteCodec: bytes length ${bytes.length} exceeds target ${targetLength}`);
+    }
+    const out = new Uint8Array(targetLength);
+    if (padByte !== 0) out.fill(padByte);
+    out.set(bytes, targetLength - bytes.length);
+    return out;
+  }
+  /**
+   * Cast an unsigned big-endian integer in `bytes` into a fixed-width uint (by bytes),
+   * reverting on overflow.
+   *
+   * This mirrors Solidity-style safe casts like `SafeCast.toUint128(uint256)`:
+   * - if `bytes.length > targetLength`, the high (bytes.length - targetLength) bytes must be all zero
+   * - returns the low `targetLength` bytes as the result
+   *
+   * Examples:
+   * - cast bytes32 -> u128: castUNbe(bytes32, 16)
+   * - cast bytesN -> u64:   castUNbe(bytesN, 8)
+   */
+  static castUNbe(bytes, targetLength) {
+    if (!Number.isInteger(targetLength) || targetLength < 0) {
+      throw new RangeError(`ByteCodec: invalid length: target=${targetLength}`);
+    }
+    const len = bytes.length;
+    if (len <= targetLength) return _ByteCodec.readUNbe(bytes, 0, len);
+    const excess = len - targetLength;
+    for (let i = 0; i < excess; i++) {
+      if (bytes[i] !== 0) throw _ByteCodec.#outOfRange(targetLength, _ByteCodec.readUNbe(bytes, 0, len));
+    }
+    return _ByteCodec.readUNbe(bytes, excess, targetLength);
+  }
+  static castU8be(bytes) {
+    return _ByteCodec.castUNbe(bytes, 1);
+  }
+  static castU16be(bytes) {
+    return _ByteCodec.castUNbe(bytes, 2);
+  }
+  static castU32be(bytes) {
+    return _ByteCodec.castUNbe(bytes, 4);
+  }
+  static castU64be(bytes) {
+    return _ByteCodec.castUNbe(bytes, 8);
+  }
+  static castU128be(bytes) {
+    return _ByteCodec.castUNbe(bytes, 16);
+  }
+  ensureCapacity(additionalBytes) {
+    const needed = this.#cursor + additionalBytes;
+    if (needed <= this.#buf.byteLength) return;
+    let nextCap = this.#buf.byteLength;
+    while (nextCap < needed) nextCap *= 2;
+    const next = new ArrayBuffer(nextCap);
+    new Uint8Array(next).set(new Uint8Array(this.#buf, 0, this.#cursor));
+    this.#buf = next;
+    this.#view = new DataView(this.#buf);
+  }
+  bytes(b) {
+    this.ensureCapacity(b.length);
+    new Uint8Array(this.#buf, this.#cursor, b.length).set(b);
+    this.#cursor += b.length;
+    return this;
+  }
+  bytes32(b) {
+    return this.bytes(_ByteCodec.leftPad(b, 32));
+  }
+  bool(b) {
+    return this.u8(b ? 1n : _ByteCodec.#ZERO);
+  }
+  u8(v) {
+    if (v < _ByteCodec.#ZERO || v > _ByteCodec.#U8_MAX) throw new RangeError(`ByteCodec: value out of range for u8: ${v}`);
+    this.ensureCapacity(1);
+    this.#view.setUint8(this.#cursor, Number(v));
+    this.#cursor += 1;
+    return this;
+  }
+  u16be(v) {
+    if (v < _ByteCodec.#ZERO || v > _ByteCodec.#U16_MAX) throw new RangeError(`ByteCodec: value out of range for u16: ${v}`);
+    this.ensureCapacity(2);
+    this.#view.setUint16(this.#cursor, Number(v), false);
+    this.#cursor += 2;
+    return this;
+  }
+  u32be(v) {
+    if (v < _ByteCodec.#ZERO || v > _ByteCodec.#U32_MAX) {
+      throw new RangeError(`ByteCodec: value out of range for u32: ${v}`);
+    }
+    this.ensureCapacity(4);
+    this.#view.setUint32(this.#cursor, Number(v), false);
+    this.#cursor += 4;
+    return this;
+  }
+  u64be(v) {
+    if (v < _ByteCodec.#ZERO || v > _ByteCodec.#U64_MAX) {
+      throw new RangeError(`ByteCodec: value out of range for u64: ${v}`);
+    }
+    this.ensureCapacity(8);
+    this.#view.setBigUint64(this.#cursor, v, false);
+    this.#cursor += 8;
+    return this;
+  }
+  u128be(v) {
+    if (v < _ByteCodec.#ZERO || v > _ByteCodec.#U128_MAX) {
+      throw new RangeError(`ByteCodec: value out of range for u128: ${v}`);
+    }
+    this.ensureCapacity(16);
+    const hi = v >> 64n & _ByteCodec.#U64_MAX;
+    const lo = v & _ByteCodec.#U64_MAX;
+    this.#view.setBigUint64(this.#cursor, hi, false);
+    this.#view.setBigUint64(this.#cursor + 8, lo, false);
+    this.#cursor += 16;
+    return this;
+  }
+  u256be(v) {
+    if (v < _ByteCodec.#ZERO || v > _ByteCodec.#U256_MAX) {
+      throw new RangeError(`ByteCodec: value out of range for u256: ${v}`);
+    }
+    this.ensureCapacity(32);
+    const w0 = v >> 192n & _ByteCodec.#U64_MAX;
+    const w1 = v >> 128n & _ByteCodec.#U64_MAX;
+    const w2 = v >> 64n & _ByteCodec.#U64_MAX;
+    const w3 = v & _ByteCodec.#U64_MAX;
+    this.#view.setBigUint64(this.#cursor, w0, false);
+    this.#view.setBigUint64(this.#cursor + 8, w1, false);
+    this.#view.setBigUint64(this.#cursor + 16, w2, false);
+    this.#view.setBigUint64(this.#cursor + 24, w3, false);
+    this.#cursor += 32;
+    return this;
+  }
+  /**
+   * Returns a copy of the accumulated bytes (no shared backing buffer).
+   */
+  toBytes() {
+    return new Uint8Array(this.#buf, 0, this.#cursor).slice();
+  }
+};
+
+export { ByteCodec, __name };
+//# sourceMappingURL=2BTCXNB3.js.map
+//# sourceMappingURL=2BTCXNB3.js.map

package/dist/2BTCXNB3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/byte-codec.ts"],"names":["uMax","bits","Number","isInteger","RangeError","BigInt","ByteCodec","ArrayBuffer","DataView","targetLength","value","readU16be","buf","offset","view","buffer","byteOffset","byteLength","getUint16","readU8","getUint8","readU32be","getUint32","readU128be","readUNbe","length","out","end","cursor","getBigUint64","readBytes32","slice","leftPad","bytes","padByte","Uint8Array","fill","set","castUNbe","len","excess","i","castU8be","castU16be","castU32be","castU64be","castU128be","ensureCapacity","additionalBytes","needed","nextCap","next","b","bytes32","bool","u8","v","setUint8","u16be","setUint16","u32be","setUint32","u64be","setBigUint64","u128be","hi","lo","u256be","w0","w1","w2","w3","toBytes"],"mappings":"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","file":"2BTCXNB3.js","sourcesContent":["/**\n * Growable byte codec backed by `ArrayBuffer` + `DataView`.\n *\n * Low-level building block for constructing byte payloads deterministically.\n * Higher-level concerns (e.g. hashing, ABI encoding, function signatures) should\n * live in wrappers/subclasses.\n */\n\nfunction uMax(bits: number): bigint {\n    if (!Number.isInteger(bits) || bits < 0) {\n        throw new RangeError(`ByteCodec: invalid bit width: ${bits}`);\n    }\n    // (2^bits) - 1, as bigint\n    return bits === 0 ? 0n : (1n << BigInt(bits)) - 1n;\n}\n\n// TODO: add tests for this class — currently has zero test coverage\nexport class ByteCodec {\n    // Start with a small-ish initial capacity to avoid frequent reallocations for\n    // common short payloads (e.g. function selector + a few fixed-width fields),\n    // while still staying tiny in memory terms. Buffer grows by doubling as needed.\n    #buf = new ArrayBuffer(128);\n    #view = new DataView(this.#buf);\n    #cursor = 0;\n\n    static readonly #ZERO = 0n;\n    static readonly #U8_MAX = uMax(8);\n    static readonly #U16_MAX = uMax(16);\n    static readonly #U32_MAX = uMax(32);\n    static readonly #U64_MAX = uMax(64);\n    static readonly #U128_MAX = uMax(128);\n    static readonly #U256_MAX = uMax(256);\n\n    static #outOfRange(targetLength: number, value: bigint): RangeError {\n        return new RangeError(`ByteCodec: value out of range for u${targetLength * 8}: ${value}`);\n    }\n\n    /**\n     * Read helpers (big-endian). These are intentionally small/low-level so other\n     * packages can share a single implementation for parsing encoded payloads.\n     */\n    static readU16be(buf: Uint8Array, offset: number): number {\n        const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);\n        return view.getUint16(offset, false);\n    }\n\n    static readU8(buf: Uint8Array, offset: number): number {\n        const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);\n        return view.getUint8(offset);\n    }\n\n    static readU32be(buf: Uint8Array, offset: number): number {\n        const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);\n        return view.getUint32(offset, false);\n    }\n\n    static readU128be(buf: Uint8Array, offset: number): bigint {\n        return ByteCodec.readUNbe(buf, offset, 16);\n    }\n\n    static readUNbe(buf: Uint8Array, offset: number, length: number): bigint {\n        const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);\n\n        let out = 0n;\n        const end = offset + length;\n\n        // Fast path: read 8 bytes at a time\n        let cursor = offset;\n        while (cursor + 8 <= end) {\n            out = (out << 64n) | view.getBigUint64(cursor, false);\n            cursor += 8;\n        }\n\n        // Tail: 0..7 bytes\n        while (cursor < end) {\n            out = (out << 8n) | BigInt(view.getUint8(cursor));\n            cursor += 1;\n        }\n\n        return out;\n    }\n\n    static readBytes32(buf: Uint8Array, offset: number): Uint8Array {\n        if (offset + 32 > buf.length) throw new RangeError(`ByteCodec: out of bounds at ${offset}`);\n        return buf.slice(offset, offset + 32);\n    }\n\n    /**\n     * Left-pad `bytes` to `targetLength` using `padByte` (default 0x00).\n     *\n     * Commonly used to mimic Solidity's `bytes32(bytesN)`-style left zero padding.\n     */\n    static leftPad(bytes: Uint8Array, targetLength: number, padByte = 0): Uint8Array {\n        if (!Number.isInteger(targetLength) || targetLength < 0) {\n            throw new RangeError(`ByteCodec: invalid length: target=${targetLength}`);\n        }\n        if (!Number.isInteger(padByte) || padByte < 0 || padByte > 255) {\n            throw new RangeError(`ByteCodec: invalid pad byte: ${padByte}`);\n        }\n        if (bytes.length > targetLength) {\n            throw new RangeError(\n                `ByteCodec: bytes length ${bytes.length} exceeds target ${targetLength}`,\n            );\n        }\n\n        const out = new Uint8Array(targetLength);\n        if (padByte !== 0) out.fill(padByte);\n        out.set(bytes, targetLength - bytes.length);\n        return out;\n    }\n\n    /**\n     * Cast an unsigned big-endian integer in `bytes` into a fixed-width uint (by bytes),\n     * reverting on overflow.\n     *\n     * This mirrors Solidity-style safe casts like `SafeCast.toUint128(uint256)`:\n     * - if `bytes.length > targetLength`, the high (bytes.length - targetLength) bytes must be all zero\n     * - returns the low `targetLength` bytes as the result\n     *\n     * Examples:\n     * - cast bytes32 -> u128: castUNbe(bytes32, 16)\n     * - cast bytesN -> u64:   castUNbe(bytesN, 8)\n     */\n    static castUNbe(bytes: Uint8Array, targetLength: number): bigint {\n        if (!Number.isInteger(targetLength) || targetLength < 0) {\n            throw new RangeError(`ByteCodec: invalid length: target=${targetLength}`);\n        }\n\n        const len = bytes.length;\n        if (len <= targetLength) return ByteCodec.readUNbe(bytes, 0, len);\n\n        // Overflow check: any excess high bytes must be 0x00.\n        const excess = len - targetLength;\n        for (let i = 0; i < excess; i++) {\n            if (bytes[i] !== 0)\n                throw ByteCodec.#outOfRange(targetLength, ByteCodec.readUNbe(bytes, 0, len));\n        }\n\n        return ByteCodec.readUNbe(bytes, excess, targetLength);\n    }\n\n    static castU8be(bytes: Uint8Array): bigint {\n        return ByteCodec.castUNbe(bytes, 1);\n    }\n\n    static castU16be(bytes: Uint8Array): bigint {\n        return ByteCodec.castUNbe(bytes, 2);\n    }\n\n    static castU32be(bytes: Uint8Array): bigint {\n        return ByteCodec.castUNbe(bytes, 4);\n    }\n\n    static castU64be(bytes: Uint8Array): bigint {\n        return ByteCodec.castUNbe(bytes, 8);\n    }\n\n    static castU128be(bytes: Uint8Array): bigint {\n        return ByteCodec.castUNbe(bytes, 16);\n    }\n\n    protected ensureCapacity(additionalBytes: number): void {\n        const needed = this.#cursor + additionalBytes;\n        if (needed <= this.#buf.byteLength) return;\n\n        let nextCap = this.#buf.byteLength;\n        while (nextCap < needed) nextCap *= 2;\n\n        // Grow by allocating a new ArrayBuffer and copying the written prefix\n        // [0..cursor) into it. We then swap the backing buffer+view.\n        const next = new ArrayBuffer(nextCap);\n        new Uint8Array(next).set(new Uint8Array(this.#buf, 0, this.#cursor));\n        this.#buf = next;\n        this.#view = new DataView(this.#buf);\n    }\n\n    bytes(b: Uint8Array): this {\n        this.ensureCapacity(b.length);\n        new Uint8Array(this.#buf, this.#cursor, b.length).set(b);\n        this.#cursor += b.length;\n        return this;\n    }\n\n    bytes32(b: Uint8Array): this {\n        return this.bytes(ByteCodec.leftPad(b, 32));\n    }\n\n    bool(b: boolean): this {\n        return this.u8(b ? 1n : ByteCodec.#ZERO);\n    }\n\n    u8(v: bigint): this {\n        if (v < ByteCodec.#ZERO || v > ByteCodec.#U8_MAX)\n            throw new RangeError(`ByteCodec: value out of range for u8: ${v}`);\n        this.ensureCapacity(1);\n        this.#view.setUint8(this.#cursor, Number(v));\n        this.#cursor += 1;\n        return this;\n    }\n\n    u16be(v: bigint): this {\n        if (v < ByteCodec.#ZERO || v > ByteCodec.#U16_MAX)\n            throw new RangeError(`ByteCodec: value out of range for u16: ${v}`);\n        this.ensureCapacity(2);\n        this.#view.setUint16(this.#cursor, Number(v), false);\n        this.#cursor += 2;\n        return this;\n    }\n\n    u32be(v: bigint): this {\n        if (v < ByteCodec.#ZERO || v > ByteCodec.#U32_MAX) {\n            throw new RangeError(`ByteCodec: value out of range for u32: ${v}`);\n        }\n        this.ensureCapacity(4);\n        this.#view.setUint32(this.#cursor, Number(v), false);\n        this.#cursor += 4;\n        return this;\n    }\n\n    u64be(v: bigint): this {\n        if (v < ByteCodec.#ZERO || v > ByteCodec.#U64_MAX) {\n            throw new RangeError(`ByteCodec: value out of range for u64: ${v}`);\n        }\n        this.ensureCapacity(8);\n        this.#view.setBigUint64(this.#cursor, v, false);\n        this.#cursor += 8;\n        return this;\n    }\n\n    u128be(v: bigint): this {\n        if (v < ByteCodec.#ZERO || v > ByteCodec.#U128_MAX) {\n            throw new RangeError(`ByteCodec: value out of range for u128: ${v}`);\n        }\n        this.ensureCapacity(16);\n        const hi = (v >> 64n) & ByteCodec.#U64_MAX;\n        const lo = v & ByteCodec.#U64_MAX;\n        this.#view.setBigUint64(this.#cursor, hi, false);\n        this.#view.setBigUint64(this.#cursor + 8, lo, false);\n        this.#cursor += 16;\n        return this;\n    }\n\n    u256be(v: bigint): this {\n        if (v < ByteCodec.#ZERO || v > ByteCodec.#U256_MAX) {\n            throw new RangeError(`ByteCodec: value out of range for u256: ${v}`);\n        }\n        this.ensureCapacity(32);\n        const w0 = (v >> 192n) & ByteCodec.#U64_MAX;\n        const w1 = (v >> 128n) & ByteCodec.#U64_MAX;\n        const w2 = (v >> 64n) & ByteCodec.#U64_MAX;\n        const w3 = v & ByteCodec.#U64_MAX;\n        this.#view.setBigUint64(this.#cursor, w0, false);\n        this.#view.setBigUint64(this.#cursor + 8, w1, false);\n        this.#view.setBigUint64(this.#cursor + 16, w2, false);\n        this.#view.setBigUint64(this.#cursor + 24, w3, false);\n        this.#cursor += 32;\n        return this;\n    }\n    /**\n     * Returns a copy of the accumulated bytes (no shared backing buffer).\n     */\n    toBytes(): Uint8Array {\n        return new Uint8Array(this.#buf, 0, this.#cursor).slice();\n    }\n}\n"]}

package/dist/DF2CBFKF.cjs

@@ -0,0 +1,224 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/byte-codec.ts
+function uMax(bits) {
+  if (!Number.isInteger(bits) || bits < 0) {
+    throw new RangeError(`ByteCodec: invalid bit width: ${bits}`);
+  }
+  return bits === 0 ? 0n : (1n << BigInt(bits)) - 1n;
+}
+__name(uMax, "uMax");
+var ByteCodec = class _ByteCodec {
+  static {
+    __name(this, "ByteCodec");
+  }
+  // Start with a small-ish initial capacity to avoid frequent reallocations for
+  // common short payloads (e.g. function selector + a few fixed-width fields),
+  // while still staying tiny in memory terms. Buffer grows by doubling as needed.
+  #buf = new ArrayBuffer(128);
+  #view = new DataView(this.#buf);
+  #cursor = 0;
+  static #ZERO = 0n;
+  static #U8_MAX = uMax(8);
+  static #U16_MAX = uMax(16);
+  static #U32_MAX = uMax(32);
+  static #U64_MAX = uMax(64);
+  static #U128_MAX = uMax(128);
+  static #U256_MAX = uMax(256);
+  static #outOfRange(targetLength, value) {
+    return new RangeError(`ByteCodec: value out of range for u${targetLength * 8}: ${value}`);
+  }
+  /**
+   * Read helpers (big-endian). These are intentionally small/low-level so other
+   * packages can share a single implementation for parsing encoded payloads.
+   */
+  static readU16be(buf, offset) {
+    const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    return view.getUint16(offset, false);
+  }
+  static readU8(buf, offset) {
+    const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    return view.getUint8(offset);
+  }
+  static readU32be(buf, offset) {
+    const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    return view.getUint32(offset, false);
+  }
+  static readU128be(buf, offset) {
+    return _ByteCodec.readUNbe(buf, offset, 16);
+  }
+  static readUNbe(buf, offset, length) {
+    const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);
+    let out = 0n;
+    const end = offset + length;
+    let cursor = offset;
+    while (cursor + 8 <= end) {
+      out = out << 64n | view.getBigUint64(cursor, false);
+      cursor += 8;
+    }
+    while (cursor < end) {
+      out = out << 8n | BigInt(view.getUint8(cursor));
+      cursor += 1;
+    }
+    return out;
+  }
+  static readBytes32(buf, offset) {
+    if (offset + 32 > buf.length) throw new RangeError(`ByteCodec: out of bounds at ${offset}`);
+    return buf.slice(offset, offset + 32);
+  }
+  /**
+   * Left-pad `bytes` to `targetLength` using `padByte` (default 0x00).
+   *
+   * Commonly used to mimic Solidity's `bytes32(bytesN)`-style left zero padding.
+   */
+  static leftPad(bytes, targetLength, padByte = 0) {
+    if (!Number.isInteger(targetLength) || targetLength < 0) {
+      throw new RangeError(`ByteCodec: invalid length: target=${targetLength}`);
+    }
+    if (!Number.isInteger(padByte) || padByte < 0 || padByte > 255) {
+      throw new RangeError(`ByteCodec: invalid pad byte: ${padByte}`);
+    }
+    if (bytes.length > targetLength) {
+      throw new RangeError(`ByteCodec: bytes length ${bytes.length} exceeds target ${targetLength}`);
+    }
+    const out = new Uint8Array(targetLength);
+    if (padByte !== 0) out.fill(padByte);
+    out.set(bytes, targetLength - bytes.length);
+    return out;
+  }
+  /**
+   * Cast an unsigned big-endian integer in `bytes` into a fixed-width uint (by bytes),
+   * reverting on overflow.
+   *
+   * This mirrors Solidity-style safe casts like `SafeCast.toUint128(uint256)`:
+   * - if `bytes.length > targetLength`, the high (bytes.length - targetLength) bytes must be all zero
+   * - returns the low `targetLength` bytes as the result
+   *
+   * Examples:
+   * - cast bytes32 -> u128: castUNbe(bytes32, 16)
+   * - cast bytesN -> u64:   castUNbe(bytesN, 8)
+   */
+  static castUNbe(bytes, targetLength) {
+    if (!Number.isInteger(targetLength) || targetLength < 0) {
+      throw new RangeError(`ByteCodec: invalid length: target=${targetLength}`);
+    }
+    const len = bytes.length;
+    if (len <= targetLength) return _ByteCodec.readUNbe(bytes, 0, len);
+    const excess = len - targetLength;
+    for (let i = 0; i < excess; i++) {
+      if (bytes[i] !== 0) throw _ByteCodec.#outOfRange(targetLength, _ByteCodec.readUNbe(bytes, 0, len));
+    }
+    return _ByteCodec.readUNbe(bytes, excess, targetLength);
+  }
+  static castU8be(bytes) {
+    return _ByteCodec.castUNbe(bytes, 1);
+  }
+  static castU16be(bytes) {
+    return _ByteCodec.castUNbe(bytes, 2);
+  }
+  static castU32be(bytes) {
+    return _ByteCodec.castUNbe(bytes, 4);
+  }
+  static castU64be(bytes) {
+    return _ByteCodec.castUNbe(bytes, 8);
+  }
+  static castU128be(bytes) {
+    return _ByteCodec.castUNbe(bytes, 16);
+  }
+  ensureCapacity(additionalBytes) {
+    const needed = this.#cursor + additionalBytes;
+    if (needed <= this.#buf.byteLength) return;
+    let nextCap = this.#buf.byteLength;
+    while (nextCap < needed) nextCap *= 2;
+    const next = new ArrayBuffer(nextCap);
+    new Uint8Array(next).set(new Uint8Array(this.#buf, 0, this.#cursor));
+    this.#buf = next;
+    this.#view = new DataView(this.#buf);
+  }
+  bytes(b) {
+    this.ensureCapacity(b.length);
+    new Uint8Array(this.#buf, this.#cursor, b.length).set(b);
+    this.#cursor += b.length;
+    return this;
+  }
+  bytes32(b) {
+    return this.bytes(_ByteCodec.leftPad(b, 32));
+  }
+  bool(b) {
+    return this.u8(b ? 1n : _ByteCodec.#ZERO);
+  }
+  u8(v) {
+    if (v < _ByteCodec.#ZERO || v > _ByteCodec.#U8_MAX) throw new RangeError(`ByteCodec: value out of range for u8: ${v}`);
+    this.ensureCapacity(1);
+    this.#view.setUint8(this.#cursor, Number(v));
+    this.#cursor += 1;
+    return this;
+  }
+  u16be(v) {
+    if (v < _ByteCodec.#ZERO || v > _ByteCodec.#U16_MAX) throw new RangeError(`ByteCodec: value out of range for u16: ${v}`);
+    this.ensureCapacity(2);
+    this.#view.setUint16(this.#cursor, Number(v), false);
+    this.#cursor += 2;
+    return this;
+  }
+  u32be(v) {
+    if (v < _ByteCodec.#ZERO || v > _ByteCodec.#U32_MAX) {
+      throw new RangeError(`ByteCodec: value out of range for u32: ${v}`);
+    }
+    this.ensureCapacity(4);
+    this.#view.setUint32(this.#cursor, Number(v), false);
+    this.#cursor += 4;
+    return this;
+  }
+  u64be(v) {
+    if (v < _ByteCodec.#ZERO || v > _ByteCodec.#U64_MAX) {
+      throw new RangeError(`ByteCodec: value out of range for u64: ${v}`);
+    }
+    this.ensureCapacity(8);
+    this.#view.setBigUint64(this.#cursor, v, false);
+    this.#cursor += 8;
+    return this;
+  }
+  u128be(v) {
+    if (v < _ByteCodec.#ZERO || v > _ByteCodec.#U128_MAX) {
+      throw new RangeError(`ByteCodec: value out of range for u128: ${v}`);
+    }
+    this.ensureCapacity(16);
+    const hi = v >> 64n & _ByteCodec.#U64_MAX;
+    const lo = v & _ByteCodec.#U64_MAX;
+    this.#view.setBigUint64(this.#cursor, hi, false);
+    this.#view.setBigUint64(this.#cursor + 8, lo, false);
+    this.#cursor += 16;
+    return this;
+  }
+  u256be(v) {
+    if (v < _ByteCodec.#ZERO || v > _ByteCodec.#U256_MAX) {
+      throw new RangeError(`ByteCodec: value out of range for u256: ${v}`);
+    }
+    this.ensureCapacity(32);
+    const w0 = v >> 192n & _ByteCodec.#U64_MAX;
+    const w1 = v >> 128n & _ByteCodec.#U64_MAX;
+    const w2 = v >> 64n & _ByteCodec.#U64_MAX;
+    const w3 = v & _ByteCodec.#U64_MAX;
+    this.#view.setBigUint64(this.#cursor, w0, false);
+    this.#view.setBigUint64(this.#cursor + 8, w1, false);
+    this.#view.setBigUint64(this.#cursor + 16, w2, false);
+    this.#view.setBigUint64(this.#cursor + 24, w3, false);
+    this.#cursor += 32;
+    return this;
+  }
+  /**
+   * Returns a copy of the accumulated bytes (no shared backing buffer).
+   */
+  toBytes() {
+    return new Uint8Array(this.#buf, 0, this.#cursor).slice();
+  }
+};
+
+exports.ByteCodec = ByteCodec;
+exports.__name = __name;
+//# sourceMappingURL=DF2CBFKF.cjs.map
+//# sourceMappingURL=DF2CBFKF.cjs.map

package/dist/DF2CBFKF.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/byte-codec.ts"],"names":["uMax","bits","Number","isInteger","RangeError","BigInt","ByteCodec","ArrayBuffer","DataView","targetLength","value","readU16be","buf","offset","view","buffer","byteOffset","byteLength","getUint16","readU8","getUint8","readU32be","getUint32","readU128be","readUNbe","length","out","end","cursor","getBigUint64","readBytes32","slice","leftPad","bytes","padByte","Uint8Array","fill","set","castUNbe","len","excess","i","castU8be","castU16be","castU32be","castU64be","castU128be","ensureCapacity","additionalBytes","needed","nextCap","next","b","bytes32","bool","u8","v","setUint8","u16be","setUint16","u32be","setUint32","u64be","setBigUint64","u128be","hi","lo","u256be","w0","w1","w2","w3","toBytes"],"mappings":"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","file":"DF2CBFKF.cjs","sourcesContent":["/**\n * Growable byte codec backed by `ArrayBuffer` + `DataView`.\n *\n * Low-level building block for constructing byte payloads deterministically.\n * Higher-level concerns (e.g. hashing, ABI encoding, function signatures) should\n * live in wrappers/subclasses.\n */\n\nfunction uMax(bits: number): bigint {\n    if (!Number.isInteger(bits) || bits < 0) {\n        throw new RangeError(`ByteCodec: invalid bit width: ${bits}`);\n    }\n    // (2^bits) - 1, as bigint\n    return bits === 0 ? 0n : (1n << BigInt(bits)) - 1n;\n}\n\n// TODO: add tests for this class — currently has zero test coverage\nexport class ByteCodec {\n    // Start with a small-ish initial capacity to avoid frequent reallocations for\n    // common short payloads (e.g. function selector + a few fixed-width fields),\n    // while still staying tiny in memory terms. Buffer grows by doubling as needed.\n    #buf = new ArrayBuffer(128);\n    #view = new DataView(this.#buf);\n    #cursor = 0;\n\n    static readonly #ZERO = 0n;\n    static readonly #U8_MAX = uMax(8);\n    static readonly #U16_MAX = uMax(16);\n    static readonly #U32_MAX = uMax(32);\n    static readonly #U64_MAX = uMax(64);\n    static readonly #U128_MAX = uMax(128);\n    static readonly #U256_MAX = uMax(256);\n\n    static #outOfRange(targetLength: number, value: bigint): RangeError {\n        return new RangeError(`ByteCodec: value out of range for u${targetLength * 8}: ${value}`);\n    }\n\n    /**\n     * Read helpers (big-endian). These are intentionally small/low-level so other\n     * packages can share a single implementation for parsing encoded payloads.\n     */\n    static readU16be(buf: Uint8Array, offset: number): number {\n        const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);\n        return view.getUint16(offset, false);\n    }\n\n    static readU8(buf: Uint8Array, offset: number): number {\n        const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);\n        return view.getUint8(offset);\n    }\n\n    static readU32be(buf: Uint8Array, offset: number): number {\n        const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);\n        return view.getUint32(offset, false);\n    }\n\n    static readU128be(buf: Uint8Array, offset: number): bigint {\n        return ByteCodec.readUNbe(buf, offset, 16);\n    }\n\n    static readUNbe(buf: Uint8Array, offset: number, length: number): bigint {\n        const view = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);\n\n        let out = 0n;\n        const end = offset + length;\n\n        // Fast path: read 8 bytes at a time\n        let cursor = offset;\n        while (cursor + 8 <= end) {\n            out = (out << 64n) | view.getBigUint64(cursor, false);\n            cursor += 8;\n        }\n\n        // Tail: 0..7 bytes\n        while (cursor < end) {\n            out = (out << 8n) | BigInt(view.getUint8(cursor));\n            cursor += 1;\n        }\n\n        return out;\n    }\n\n    static readBytes32(buf: Uint8Array, offset: number): Uint8Array {\n        if (offset + 32 > buf.length) throw new RangeError(`ByteCodec: out of bounds at ${offset}`);\n        return buf.slice(offset, offset + 32);\n    }\n\n    /**\n     * Left-pad `bytes` to `targetLength` using `padByte` (default 0x00).\n     *\n     * Commonly used to mimic Solidity's `bytes32(bytesN)`-style left zero padding.\n     */\n    static leftPad(bytes: Uint8Array, targetLength: number, padByte = 0): Uint8Array {\n        if (!Number.isInteger(targetLength) || targetLength < 0) {\n            throw new RangeError(`ByteCodec: invalid length: target=${targetLength}`);\n        }\n        if (!Number.isInteger(padByte) || padByte < 0 || padByte > 255) {\n            throw new RangeError(`ByteCodec: invalid pad byte: ${padByte}`);\n        }\n        if (bytes.length > targetLength) {\n            throw new RangeError(\n                `ByteCodec: bytes length ${bytes.length} exceeds target ${targetLength}`,\n            );\n        }\n\n        const out = new Uint8Array(targetLength);\n        if (padByte !== 0) out.fill(padByte);\n        out.set(bytes, targetLength - bytes.length);\n        return out;\n    }\n\n    /**\n     * Cast an unsigned big-endian integer in `bytes` into a fixed-width uint (by bytes),\n     * reverting on overflow.\n     *\n     * This mirrors Solidity-style safe casts like `SafeCast.toUint128(uint256)`:\n     * - if `bytes.length > targetLength`, the high (bytes.length - targetLength) bytes must be all zero\n     * - returns the low `targetLength` bytes as the result\n     *\n     * Examples:\n     * - cast bytes32 -> u128: castUNbe(bytes32, 16)\n     * - cast bytesN -> u64:   castUNbe(bytesN, 8)\n     */\n    static castUNbe(bytes: Uint8Array, targetLength: number): bigint {\n        if (!Number.isInteger(targetLength) || targetLength < 0) {\n            throw new RangeError(`ByteCodec: invalid length: target=${targetLength}`);\n        }\n\n        const len = bytes.length;\n        if (len <= targetLength) return ByteCodec.readUNbe(bytes, 0, len);\n\n        // Overflow check: any excess high bytes must be 0x00.\n        const excess = len - targetLength;\n        for (let i = 0; i < excess; i++) {\n            if (bytes[i] !== 0)\n                throw ByteCodec.#outOfRange(targetLength, ByteCodec.readUNbe(bytes, 0, len));\n        }\n\n        return ByteCodec.readUNbe(bytes, excess, targetLength);\n    }\n\n    static castU8be(bytes: Uint8Array): bigint {\n        return ByteCodec.castUNbe(bytes, 1);\n    }\n\n    static castU16be(bytes: Uint8Array): bigint {\n        return ByteCodec.castUNbe(bytes, 2);\n    }\n\n    static castU32be(bytes: Uint8Array): bigint {\n        return ByteCodec.castUNbe(bytes, 4);\n    }\n\n    static castU64be(bytes: Uint8Array): bigint {\n        return ByteCodec.castUNbe(bytes, 8);\n    }\n\n    static castU128be(bytes: Uint8Array): bigint {\n        return ByteCodec.castUNbe(bytes, 16);\n    }\n\n    protected ensureCapacity(additionalBytes: number): void {\n        const needed = this.#cursor + additionalBytes;\n        if (needed <= this.#buf.byteLength) return;\n\n        let nextCap = this.#buf.byteLength;\n        while (nextCap < needed) nextCap *= 2;\n\n        // Grow by allocating a new ArrayBuffer and copying the written prefix\n        // [0..cursor) into it. We then swap the backing buffer+view.\n        const next = new ArrayBuffer(nextCap);\n        new Uint8Array(next).set(new Uint8Array(this.#buf, 0, this.#cursor));\n        this.#buf = next;\n        this.#view = new DataView(this.#buf);\n    }\n\n    bytes(b: Uint8Array): this {\n        this.ensureCapacity(b.length);\n        new Uint8Array(this.#buf, this.#cursor, b.length).set(b);\n        this.#cursor += b.length;\n        return this;\n    }\n\n    bytes32(b: Uint8Array): this {\n        return this.bytes(ByteCodec.leftPad(b, 32));\n    }\n\n    bool(b: boolean): this {\n        return this.u8(b ? 1n : ByteCodec.#ZERO);\n    }\n\n    u8(v: bigint): this {\n        if (v < ByteCodec.#ZERO || v > ByteCodec.#U8_MAX)\n            throw new RangeError(`ByteCodec: value out of range for u8: ${v}`);\n        this.ensureCapacity(1);\n        this.#view.setUint8(this.#cursor, Number(v));\n        this.#cursor += 1;\n        return this;\n    }\n\n    u16be(v: bigint): this {\n        if (v < ByteCodec.#ZERO || v > ByteCodec.#U16_MAX)\n            throw new RangeError(`ByteCodec: value out of range for u16: ${v}`);\n        this.ensureCapacity(2);\n        this.#view.setUint16(this.#cursor, Number(v), false);\n        this.#cursor += 2;\n        return this;\n    }\n\n    u32be(v: bigint): this {\n        if (v < ByteCodec.#ZERO || v > ByteCodec.#U32_MAX) {\n            throw new RangeError(`ByteCodec: value out of range for u32: ${v}`);\n        }\n        this.ensureCapacity(4);\n        this.#view.setUint32(this.#cursor, Number(v), false);\n        this.#cursor += 4;\n        return this;\n    }\n\n    u64be(v: bigint): this {\n        if (v < ByteCodec.#ZERO || v > ByteCodec.#U64_MAX) {\n            throw new RangeError(`ByteCodec: value out of range for u64: ${v}`);\n        }\n        this.ensureCapacity(8);\n        this.#view.setBigUint64(this.#cursor, v, false);\n        this.#cursor += 8;\n        return this;\n    }\n\n    u128be(v: bigint): this {\n        if (v < ByteCodec.#ZERO || v > ByteCodec.#U128_MAX) {\n            throw new RangeError(`ByteCodec: value out of range for u128: ${v}`);\n        }\n        this.ensureCapacity(16);\n        const hi = (v >> 64n) & ByteCodec.#U64_MAX;\n        const lo = v & ByteCodec.#U64_MAX;\n        this.#view.setBigUint64(this.#cursor, hi, false);\n        this.#view.setBigUint64(this.#cursor + 8, lo, false);\n        this.#cursor += 16;\n        return this;\n    }\n\n    u256be(v: bigint): this {\n        if (v < ByteCodec.#ZERO || v > ByteCodec.#U256_MAX) {\n            throw new RangeError(`ByteCodec: value out of range for u256: ${v}`);\n        }\n        this.ensureCapacity(32);\n        const w0 = (v >> 192n) & ByteCodec.#U64_MAX;\n        const w1 = (v >> 128n) & ByteCodec.#U64_MAX;\n        const w2 = (v >> 64n) & ByteCodec.#U64_MAX;\n        const w3 = v & ByteCodec.#U64_MAX;\n        this.#view.setBigUint64(this.#cursor, w0, false);\n        this.#view.setBigUint64(this.#cursor + 8, w1, false);\n        this.#view.setBigUint64(this.#cursor + 16, w2, false);\n        this.#view.setBigUint64(this.#cursor + 24, w3, false);\n        this.#cursor += 32;\n        return this;\n    }\n    /**\n     * Returns a copy of the accumulated bytes (no shared backing buffer).\n     */\n    toBytes(): Uint8Array {\n        return new Uint8Array(this.#buf, 0, this.#cursor).slice();\n    }\n}\n"]}

package/dist/byte-codec.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var DF2CBFKF_cjs = require('./DF2CBFKF.cjs');
+
+
+
+Object.defineProperty(exports, "ByteCodec", {
+  enumerable: true,
+  get: function () { return DF2CBFKF_cjs.ByteCodec; }
+});
+//# sourceMappingURL=byte-codec.cjs.map
+//# sourceMappingURL=byte-codec.cjs.map

package/dist/byte-codec.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"byte-codec.cjs"}

package/dist/byte-codec.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Growable byte codec backed by `ArrayBuffer` + `DataView`.
+ *
+ * Low-level building block for constructing byte payloads deterministically.
+ * Higher-level concerns (e.g. hashing, ABI encoding, function signatures) should
+ * live in wrappers/subclasses.
+ */
+export declare class ByteCodec {
+    #private;
+    /**
+     * Read helpers (big-endian). These are intentionally small/low-level so other
+     * packages can share a single implementation for parsing encoded payloads.
+     */
+    static readU16be(buf: Uint8Array, offset: number): number;
+    static readU8(buf: Uint8Array, offset: number): number;
+    static readU32be(buf: Uint8Array, offset: number): number;
+    static readU128be(buf: Uint8Array, offset: number): bigint;
+    static readUNbe(buf: Uint8Array, offset: number, length: number): bigint;
+    static readBytes32(buf: Uint8Array, offset: number): Uint8Array;
+    /**
+     * Left-pad `bytes` to `targetLength` using `padByte` (default 0x00).
+     *
+     * Commonly used to mimic Solidity's `bytes32(bytesN)`-style left zero padding.
+     */
+    static leftPad(bytes: Uint8Array, targetLength: number, padByte?: number): Uint8Array;
+    /**
+     * Cast an unsigned big-endian integer in `bytes` into a fixed-width uint (by bytes),
+     * reverting on overflow.
+     *
+     * This mirrors Solidity-style safe casts like `SafeCast.toUint128(uint256)`:
+     * - if `bytes.length > targetLength`, the high (bytes.length - targetLength) bytes must be all zero
+     * - returns the low `targetLength` bytes as the result
+     *
+     * Examples:
+     * - cast bytes32 -> u128: castUNbe(bytes32, 16)
+     * - cast bytesN -> u64:   castUNbe(bytesN, 8)
+     */
+    static castUNbe(bytes: Uint8Array, targetLength: number): bigint;
+    static castU8be(bytes: Uint8Array): bigint;
+    static castU16be(bytes: Uint8Array): bigint;
+    static castU32be(bytes: Uint8Array): bigint;
+    static castU64be(bytes: Uint8Array): bigint;
+    static castU128be(bytes: Uint8Array): bigint;
+    protected ensureCapacity(additionalBytes: number): void;
+    bytes(b: Uint8Array): this;
+    bytes32(b: Uint8Array): this;
+    bool(b: boolean): this;
+    u8(v: bigint): this;
+    u16be(v: bigint): this;
+    u32be(v: bigint): this;
+    u64be(v: bigint): this;
+    u128be(v: bigint): this;
+    u256be(v: bigint): this;
+    /**
+     * Returns a copy of the accumulated bytes (no shared backing buffer).
+     */
+    toBytes(): Uint8Array;
+}
+//# sourceMappingURL=byte-codec.d.ts.map

package/dist/byte-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-codec.d.ts","sourceRoot":"","sources":["../src/byte-codec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,qBAAa,SAAS;;IAoBlB;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAKzD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAKtD,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAKzD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAI1D,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAsBxE,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU;IAK/D;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,UAAU;IAmBhF;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAkBhE,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAI1C,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAI3C,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAI3C,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAI3C,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAI5C,SAAS,CAAC,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAevD,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI;IAO1B,OAAO,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI;IAI5B,IAAI,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI;IAItB,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IASnB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAStB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAUtB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAUtB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAavB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAgBvB;;OAEG;IACH,OAAO,IAAI,UAAU;CAGxB"}