@geoprotocol/grc-20 0.1.0

package/dist/codec/primitives.js

@@ -0,0 +1,285 @@
+import { createId } from "../types/id.js";
+/**
+ * ZigZag encodes a signed integer to an unsigned integer.
+ */
+export function zigzagEncode(n) {
+    return (n << 1n) ^ (n >> 63n);
+}
+/**
+ * ZigZag decodes an unsigned integer to a signed integer.
+ */
+export function zigzagDecode(n) {
+    return (n >> 1n) ^ -(n & 1n);
+}
+/**
+ * Binary writer for encoding GRC-20 data.
+ */
+export class Writer {
+    buffer;
+    pos = 0;
+    constructor(initialCapacity = 1024) {
+        this.buffer = new Uint8Array(initialCapacity);
+    }
+    ensureCapacity(needed) {
+        const required = this.pos + needed;
+        if (required > this.buffer.length) {
+            let newCapacity = this.buffer.length * 2;
+            while (newCapacity < required) {
+                newCapacity *= 2;
+            }
+            const newBuffer = new Uint8Array(newCapacity);
+            newBuffer.set(this.buffer);
+            this.buffer = newBuffer;
+        }
+    }
+    /**
+     * Returns the written bytes.
+     */
+    finish() {
+        return this.buffer.subarray(0, this.pos);
+    }
+    /**
+     * Returns the current position (bytes written).
+     */
+    position() {
+        return this.pos;
+    }
+    /**
+     * Writes a single byte.
+     */
+    writeByte(value) {
+        this.ensureCapacity(1);
+        this.buffer[this.pos++] = value;
+    }
+    /**
+     * Writes raw bytes.
+     */
+    writeBytes(bytes) {
+        this.ensureCapacity(bytes.length);
+        this.buffer.set(bytes, this.pos);
+        this.pos += bytes.length;
+    }
+    /**
+     * Writes a 16-byte UUID (raw, no length prefix).
+     */
+    writeId(id) {
+        this.writeBytes(id);
+    }
+    /**
+     * Writes an unsigned varint (LEB128).
+     */
+    writeVarint(value) {
+        if (value < 0n) {
+            throw new Error("writeVarint requires non-negative value");
+        }
+        this.ensureCapacity(10);
+        let v = value;
+        do {
+            let byte = Number(v & 0x7fn);
+            v >>= 7n;
+            if (v !== 0n) {
+                byte |= 0x80;
+            }
+            this.buffer[this.pos++] = byte;
+        } while (v !== 0n);
+    }
+    /**
+     * Writes an unsigned varint from a number.
+     */
+    writeVarintNumber(value) {
+        this.writeVarint(BigInt(value));
+    }
+    /**
+     * Writes a signed varint (ZigZag encoded).
+     */
+    writeSignedVarint(value) {
+        this.writeVarint(zigzagEncode(value));
+    }
+    /**
+     * Writes a length-prefixed string (UTF-8).
+     */
+    writeString(s) {
+        const bytes = new TextEncoder().encode(s);
+        this.writeVarintNumber(bytes.length);
+        this.writeBytes(bytes);
+    }
+    /**
+     * Writes a length-prefixed byte array.
+     */
+    writeLengthPrefixedBytes(bytes) {
+        this.writeVarintNumber(bytes.length);
+        this.writeBytes(bytes);
+    }
+    /**
+     * Writes a 64-bit float (IEEE 754, little-endian).
+     */
+    writeFloat64(value) {
+        this.ensureCapacity(8);
+        const view = new DataView(this.buffer.buffer, this.buffer.byteOffset + this.pos, 8);
+        view.setFloat64(0, value, true);
+        this.pos += 8;
+    }
+    /**
+     * Writes a vector of IDs with length prefix.
+     */
+    writeIdVec(ids) {
+        this.writeVarintNumber(ids.length);
+        for (const id of ids) {
+            this.writeId(id);
+        }
+    }
+}
+/**
+ * Decode error with context.
+ */
+export class DecodeError extends Error {
+    code;
+    constructor(code, message) {
+        super(`[${code}] ${message}`);
+        this.code = code;
+        this.name = "DecodeError";
+    }
+}
+/**
+ * Binary reader for decoding GRC-20 data.
+ */
+export class Reader {
+    buffer;
+    pos = 0;
+    constructor(buffer) {
+        this.buffer = buffer;
+    }
+    /**
+     * Returns true if there are more bytes to read.
+     */
+    hasMore() {
+        return this.pos < this.buffer.length;
+    }
+    /**
+     * Returns the current position.
+     */
+    position() {
+        return this.pos;
+    }
+    /**
+     * Returns remaining bytes.
+     */
+    remaining() {
+        return this.buffer.length - this.pos;
+    }
+    /**
+     * Reads a single byte.
+     */
+    readByte() {
+        if (this.pos >= this.buffer.length) {
+            throw new DecodeError("E005", "unexpected end of input");
+        }
+        return this.buffer[this.pos++];
+    }
+    /**
+     * Peeks at the next byte without consuming it.
+     */
+    peekByte() {
+        if (this.pos >= this.buffer.length) {
+            throw new DecodeError("E005", "unexpected end of input");
+        }
+        return this.buffer[this.pos];
+    }
+    /**
+     * Reads raw bytes.
+     */
+    readBytes(n) {
+        if (this.pos + n > this.buffer.length) {
+            throw new DecodeError("E005", `unexpected end of input: need ${n} bytes, have ${this.buffer.length - this.pos}`);
+        }
+        const result = this.buffer.subarray(this.pos, this.pos + n);
+        this.pos += n;
+        return result;
+    }
+    /**
+     * Reads a 16-byte UUID.
+     */
+    readId() {
+        return createId(new Uint8Array(this.readBytes(16)));
+    }
+    /**
+     * Reads an unsigned varint (LEB128).
+     */
+    readVarint() {
+        let result = 0n;
+        let shift = 0n;
+        let byteCount = 0;
+        while (true) {
+            if (this.pos >= this.buffer.length) {
+                throw new DecodeError("E005", "unexpected end of input while reading varint");
+            }
+            const byte = this.buffer[this.pos++];
+            byteCount++;
+            if (byteCount > 10) {
+                throw new DecodeError("E005", "varint exceeds maximum length (10 bytes)");
+            }
+            result |= BigInt(byte & 0x7f) << shift;
+            shift += 7n;
+            if ((byte & 0x80) === 0) {
+                break;
+            }
+        }
+        return result;
+    }
+    /**
+     * Reads an unsigned varint as a number (throws if > MAX_SAFE_INTEGER).
+     */
+    readVarintNumber() {
+        const value = this.readVarint();
+        if (value > BigInt(Number.MAX_SAFE_INTEGER)) {
+            throw new DecodeError("E005", "varint value exceeds safe integer range");
+        }
+        return Number(value);
+    }
+    /**
+     * Reads a signed varint (ZigZag encoded).
+     */
+    readSignedVarint() {
+        return zigzagDecode(this.readVarint());
+    }
+    /**
+     * Reads a length-prefixed string (UTF-8).
+     */
+    readString() {
+        const len = this.readVarintNumber();
+        const bytes = this.readBytes(len);
+        try {
+            return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+        }
+        catch {
+            throw new DecodeError("E004", "invalid UTF-8 in string");
+        }
+    }
+    /**
+     * Reads a length-prefixed byte array.
+     */
+    readLengthPrefixedBytes() {
+        const len = this.readVarintNumber();
+        return new Uint8Array(this.readBytes(len));
+    }
+    /**
+     * Reads a 64-bit float (IEEE 754, little-endian).
+     */
+    readFloat64() {
+        const bytes = this.readBytes(8);
+        const view = new DataView(bytes.buffer, bytes.byteOffset, 8);
+        return view.getFloat64(0, true);
+    }
+    /**
+     * Reads a vector of IDs with length prefix.
+     */
+    readIdVec() {
+        const count = this.readVarintNumber();
+        const ids = [];
+        for (let i = 0; i < count; i++) {
+            ids.push(this.readId());
+        }
+        return ids;
+    }
+}
+//# sourceMappingURL=primitives.js.map

package/dist/codec/primitives.js.map

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

package/dist/codec/value.d.ts

@@ -0,0 +1,41 @@
+import type { Id } from "../types/id.js";
+import type { PropertyValue, Value } from "../types/value.js";
+import { DataType } from "../types/value.js";
+import { Reader, Writer } from "./primitives.js";
+/**
+ * Dictionary builder for tracking property/language/unit indices.
+ */
+export interface DictionaryIndices {
+    getPropertyIndex(id: Id): number;
+    getLanguageIndex(id: Id | undefined): number;
+    getUnitIndex(id: Id | undefined): number;
+    getDataType(propertyId: Id): DataType;
+}
+/**
+ * Dictionary lookups for decoding.
+ */
+export interface DictionaryLookups {
+    getProperty(index: number): {
+        id: Id;
+        dataType: DataType;
+    };
+    getLanguage(index: number): Id | undefined;
+    getUnit(index: number): Id | undefined;
+}
+/**
+ * Encodes a value payload (without property index).
+ */
+export declare function encodeValuePayload(writer: Writer, value: Value): void;
+/**
+ * Encodes a property value (with property index, language, unit).
+ */
+export declare function encodePropertyValue(writer: Writer, pv: PropertyValue, dicts: DictionaryIndices): void;
+/**
+ * Decodes a value payload based on data type.
+ */
+export declare function decodeValuePayload(reader: Reader, dataType: DataType): Value;
+/**
+ * Decodes a property value (with property index, language, unit).
+ */
+export declare function decodePropertyValue(reader: Reader, dicts: DictionaryLookups): PropertyValue;
+//# sourceMappingURL=value.d.ts.map

package/dist/codec/value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../../src/codec/value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,EAAmB,aAAa,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAA2C,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAe,MAAM,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;IACjC,gBAAgB,CAAC,EAAE,EAAE,EAAE,GAAG,SAAS,GAAG,MAAM,CAAC;IAC7C,YAAY,CAAC,EAAE,EAAE,EAAE,GAAG,SAAS,GAAG,MAAM,CAAC;IACzC,WAAW,CAAC,UAAU,EAAE,EAAE,GAAG,QAAQ,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,EAAE,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAC3D,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE,GAAG,SAAS,CAAC;IAC3C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE,GAAG,SAAS,CAAC;CACxC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CA8DrE;AAiBD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,aAAa,EACjB,KAAK,EAAE,iBAAiB,GACvB,IAAI,CAmBN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAuF5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,iBAAiB,GACvB,aAAa,CA2Bf"}

package/dist/codec/value.js

@@ -0,0 +1,202 @@
+import { DataType, embeddingBytesForDims } from "../types/value.js";
+import { DecodeError } from "./primitives.js";
+/**
+ * Encodes a value payload (without property index).
+ */
+export function encodeValuePayload(writer, value) {
+    switch (value.type) {
+        case "bool":
+            writer.writeByte(value.value ? 0x01 : 0x00);
+            break;
+        case "int64":
+            writer.writeSignedVarint(value.value);
+            break;
+        case "float64":
+            if (Number.isNaN(value.value)) {
+                throw new Error("NaN is not allowed in Float64");
+            }
+            writer.writeFloat64(value.value);
+            break;
+        case "decimal":
+            encodeDecimal(writer, value.exponent, value.mantissa);
+            break;
+        case "text":
+            writer.writeString(value.value);
+            break;
+        case "bytes":
+            writer.writeLengthPrefixedBytes(value.value);
+            break;
+        case "timestamp":
+            writer.writeSignedVarint(value.value);
+            break;
+        case "date":
+            writer.writeString(value.value);
+            break;
+        case "point":
+            if (Number.isNaN(value.lat) || Number.isNaN(value.lon)) {
+                throw new Error("NaN is not allowed in Point coordinates");
+            }
+            if (value.lat < -90 || value.lat > 90) {
+                throw new Error("latitude out of range [-90, +90]");
+            }
+            if (value.lon < -180 || value.lon > 180) {
+                throw new Error("longitude out of range [-180, +180]");
+            }
+            writer.writeFloat64(value.lat);
+            writer.writeFloat64(value.lon);
+            break;
+        case "embedding": {
+            const expected = embeddingBytesForDims(value.subType, value.dims);
+            if (value.data.length !== expected) {
+                throw new Error(`embedding data length ${value.data.length} doesn't match expected ${expected}`);
+            }
+            writer.writeByte(value.subType);
+            writer.writeVarintNumber(value.dims);
+            writer.writeBytes(value.data);
+            break;
+        }
+    }
+}
+/**
+ * Encodes a decimal value.
+ */
+function encodeDecimal(writer, exponent, mantissa) {
+    writer.writeSignedVarint(BigInt(exponent));
+    if (mantissa.type === "i64") {
+        writer.writeByte(0x00); // mantissa_type = varint
+        writer.writeSignedVarint(mantissa.value);
+    }
+    else {
+        writer.writeByte(0x01); // mantissa_type = bytes
+        writer.writeLengthPrefixedBytes(mantissa.bytes);
+    }
+}
+/**
+ * Encodes a property value (with property index, language, unit).
+ */
+export function encodePropertyValue(writer, pv, dicts) {
+    // Write property index
+    const propIndex = dicts.getPropertyIndex(pv.property);
+    writer.writeVarintNumber(propIndex);
+    // Write payload
+    encodeValuePayload(writer, pv.value);
+    // Write language index for TEXT
+    if (pv.value.type === "text") {
+        const langIndex = dicts.getLanguageIndex(pv.value.language);
+        writer.writeVarintNumber(langIndex);
+    }
+    // Write unit index for numerical types
+    if (pv.value.type === "int64" || pv.value.type === "float64" || pv.value.type === "decimal") {
+        const unitIndex = dicts.getUnitIndex(pv.value.unit);
+        writer.writeVarintNumber(unitIndex);
+    }
+}
+/**
+ * Decodes a value payload based on data type.
+ */
+export function decodeValuePayload(reader, dataType) {
+    switch (dataType) {
+        case DataType.Bool: {
+            const byte = reader.readByte();
+            if (byte !== 0x00 && byte !== 0x01) {
+                throw new DecodeError("E005", `invalid bool value: ${byte}`);
+            }
+            return { type: "bool", value: byte === 0x01 };
+        }
+        case DataType.Int64: {
+            const value = reader.readSignedVarint();
+            return { type: "int64", value };
+        }
+        case DataType.Float64: {
+            const value = reader.readFloat64();
+            if (Number.isNaN(value)) {
+                throw new DecodeError("E005", "float value is NaN");
+            }
+            return { type: "float64", value };
+        }
+        case DataType.Decimal: {
+            const exponent = Number(reader.readSignedVarint());
+            const mantissaType = reader.readByte();
+            let mantissa;
+            if (mantissaType === 0x00) {
+                mantissa = { type: "i64", value: reader.readSignedVarint() };
+            }
+            else if (mantissaType === 0x01) {
+                mantissa = { type: "big", bytes: reader.readLengthPrefixedBytes() };
+            }
+            else {
+                throw new DecodeError("E005", `invalid decimal mantissa type: ${mantissaType}`);
+            }
+            return { type: "decimal", exponent, mantissa };
+        }
+        case DataType.Text: {
+            const value = reader.readString();
+            return { type: "text", value };
+        }
+        case DataType.Bytes: {
+            const value = reader.readLengthPrefixedBytes();
+            return { type: "bytes", value };
+        }
+        case DataType.Timestamp: {
+            const value = reader.readSignedVarint();
+            return { type: "timestamp", value };
+        }
+        case DataType.Date: {
+            const value = reader.readString();
+            return { type: "date", value };
+        }
+        case DataType.Point: {
+            const lat = reader.readFloat64();
+            const lon = reader.readFloat64();
+            if (Number.isNaN(lat) || Number.isNaN(lon)) {
+                throw new DecodeError("E005", "NaN is not allowed in Point coordinates");
+            }
+            if (lat < -90 || lat > 90) {
+                throw new DecodeError("E005", `POINT latitude ${lat} out of range [-90, +90]`);
+            }
+            if (lon < -180 || lon > 180) {
+                throw new DecodeError("E005", `POINT longitude ${lon} out of range [-180, +180]`);
+            }
+            return { type: "point", lat, lon };
+        }
+        case DataType.Embedding: {
+            const subTypeByte = reader.readByte();
+            if (subTypeByte > 2) {
+                throw new DecodeError("E005", `invalid embedding sub-type: ${subTypeByte}`);
+            }
+            const subType = subTypeByte;
+            const dims = reader.readVarintNumber();
+            const expectedBytes = embeddingBytesForDims(subType, dims);
+            const data = new Uint8Array(reader.readBytes(expectedBytes));
+            return { type: "embedding", subType, dims, data };
+        }
+        default:
+            throw new DecodeError("E005", `invalid data type: ${dataType}`);
+    }
+}
+/**
+ * Decodes a property value (with property index, language, unit).
+ */
+export function decodePropertyValue(reader, dicts) {
+    // Read property index
+    const propIndex = reader.readVarintNumber();
+    const prop = dicts.getProperty(propIndex);
+    // Read payload
+    let value = decodeValuePayload(reader, prop.dataType);
+    // Read language index for TEXT
+    if (prop.dataType === DataType.Text) {
+        const langIndex = reader.readVarintNumber();
+        const language = dicts.getLanguage(langIndex);
+        value = { ...value, language };
+    }
+    // Read unit index for numerical types
+    if (prop.dataType === DataType.Int64 ||
+        prop.dataType === DataType.Float64 ||
+        prop.dataType === DataType.Decimal) {
+        const unitIndex = reader.readVarintNumber();
+        const unit = dicts.getUnit(unitIndex);
+        value = { ...value, unit };
+    }
+    return { property: prop.id, value };
+}
+//# sourceMappingURL=value.js.map

package/dist/codec/value.js.map

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

package/dist/genesis/index.d.ts

@@ -0,0 +1,109 @@
+import { type Id } from "../util/id.js";
+/**
+ * Derives a genesis ID from a name.
+ *
+ * ```
+ * id = derived_uuid("grc20:genesis:" + name)
+ * ```
+ */
+export declare function genesisId(name: string): Id;
+/**
+ * Derives a language ID from a BCP 47 language code.
+ *
+ * ```
+ * id = derived_uuid("grc20:genesis:language:" + code)
+ * ```
+ */
+export declare function languageId(code: string): Id;
+/**
+ * Well-known property IDs from the Genesis Space.
+ */
+export declare const properties: {
+    /** Name property - primary label (TEXT) */
+    readonly NAME: Id;
+    /** Description property - summary text (TEXT) */
+    readonly DESCRIPTION: Id;
+    /** Avatar property - image URL (TEXT) */
+    readonly AVATAR: Id;
+    /** URL property - external link (TEXT) */
+    readonly URL: Id;
+    /** Created property - creation time (TIMESTAMP) */
+    readonly CREATED: Id;
+    /** Modified property - last modification (TIMESTAMP) */
+    readonly MODIFIED: Id;
+    name: () => Id;
+    description: () => Id;
+    avatar: () => Id;
+    url: () => Id;
+    created: () => Id;
+    modified: () => Id;
+};
+/**
+ * Well-known type entity IDs from the Genesis Space.
+ */
+export declare const types: {
+    /** Person type - human individual */
+    readonly PERSON: Id;
+    /** Organization type - company, DAO, institution */
+    readonly ORGANIZATION: Id;
+    /** Place type - geographic location */
+    readonly PLACE: Id;
+    /** Topic type - subject or concept */
+    readonly TOPIC: Id;
+    person: () => Id;
+    organization: () => Id;
+    place: () => Id;
+    topic: () => Id;
+};
+/**
+ * Well-known relation type IDs from the Genesis Space.
+ */
+export declare const relationTypes: {
+    /** Types relation - type membership */
+    readonly TYPES: Id;
+    /** PartOf relation - composition/containment */
+    readonly PART_OF: Id;
+    /** RelatedTo relation - generic association */
+    readonly RELATED_TO: Id;
+    types: () => Id;
+    partOf: () => Id;
+    relatedTo: () => Id;
+};
+/**
+ * Well-known language IDs from the Genesis Space.
+ */
+export declare const languages: {
+    readonly ENGLISH: Id;
+    readonly SPANISH: Id;
+    readonly FRENCH: Id;
+    readonly GERMAN: Id;
+    readonly CHINESE: Id;
+    readonly CHINESE_HANS: Id;
+    readonly CHINESE_HANT: Id;
+    readonly JAPANESE: Id;
+    readonly KOREAN: Id;
+    readonly PORTUGUESE: Id;
+    readonly ITALIAN: Id;
+    readonly RUSSIAN: Id;
+    readonly ARABIC: Id;
+    readonly HINDI: Id;
+    english: () => Id;
+    spanish: () => Id;
+    french: () => Id;
+    german: () => Id;
+    chinese: () => Id;
+    chineseHans: () => Id;
+    chineseHant: () => Id;
+    japanese: () => Id;
+    korean: () => Id;
+    portuguese: () => Id;
+    italian: () => Id;
+    russian: () => Id;
+    arabic: () => Id;
+    hindi: () => Id;
+    /**
+     * Returns the language ID for the given BCP 47 code.
+     */
+    fromCode: (code: string) => Id;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/genesis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/genesis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,EAAE,EAAE,MAAM,eAAe,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,CAE1C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,CAE3C;AAMD;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB,2CAA2C;mBAC/B,EAAE;IAId,iDAAiD;0BAC9B,EAAE;IAIrB,yCAAyC;qBAC3B,EAAE;IAIhB,0CAA0C;kBAC/B,EAAE;IAIb,mDAAmD;sBACpC,EAAE;IAIjB,wDAAwD;uBACxC,EAAE;;;;;;;CAWnB,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,KAAK;IAChB,qCAAqC;qBACvB,EAAE;IAIhB,oDAAoD;2BAChC,EAAE;IAItB,uCAAuC;oBAC1B,EAAE;IAIf,sCAAsC;oBACzB,EAAE;;;;;CAShB,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,uCAAuC;oBAC1B,EAAE;IAIf,gDAAgD;sBACjC,EAAE;IAIjB,+CAA+C;yBAC7B,EAAE;;;;CAQrB,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,SAAS;sBACL,EAAE;sBAGF,EAAE;qBAGH,EAAE;qBAGF,EAAE;sBAGD,EAAE;2BAGG,EAAE;2BAGF,EAAE;uBAGN,EAAE;qBAGJ,EAAE;yBAGE,EAAE;sBAGL,EAAE;sBAGF,EAAE;qBAGH,EAAE;oBAGH,EAAE;;;;;;;;;;;;;;;IAoBf;;OAEG;qBACc,MAAM;CACxB,CAAC"}