@arkadia/ai-data-format 0.1.4

package/dist/core/Parser.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { EncoderConfig } from './config';
+import { DecodeResult } from './core/Decoder';
+import { Node } from './models/Node';
+import { Schema, SchemaKind } from './models/Schema';
+import { MetaInfo, Meta, MetaProps } from './models/Meta';
+export { Node, Schema, SchemaKind, DecodeResult, EncoderConfig, Meta, MetaInfo, MetaProps };
+/**
+ * Encode input data into valid **AI.Data** format.
+ */
+export declare function encode(data: any | Node, config?: Partial<EncoderConfig>): string;
+/**
+ * Decode AI.Data format text into a Node structure.
+ */
+export declare function decode(text: string, options?: {
+    removeAnsiColors?: boolean;
+    debug?: boolean;
+}, schema?: string): DecodeResult;
+/**
+ * Convert raw JavaScript object/value into a Node.
+ */
+export declare function parse(data: any): Node;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,UAAU,CAAC;AAEzD,OAAO,EAAW,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAC1D,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AAMhC;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAAG,MAAM,CAMpF;AAED;;GAEG;AACH,wBAAgB,MAAM,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,EAC7D,MAAM,GAAE,MAAW,GACpB,YAAY,CAId;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAErC"}

package/dist/index.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetaInfo = exports.Meta = exports.SchemaKind = exports.Schema = exports.Node = void 0;
+exports.encode = encode;
+exports.decode = decode;
+exports.parse = parse;
+const config_1 = require("./config");
+const Encoder_1 = require("./core/Encoder");
+const Decoder_1 = require("./core/Decoder");
+const Parser_1 = require("./core/Parser");
+const Node_1 = require("./models/Node");
+Object.defineProperty(exports, "Node", { enumerable: true, get: function () { return Node_1.Node; } });
+const Schema_1 = require("./models/Schema");
+Object.defineProperty(exports, "Schema", { enumerable: true, get: function () { return Schema_1.Schema; } });
+Object.defineProperty(exports, "SchemaKind", { enumerable: true, get: function () { return Schema_1.SchemaKind; } });
+const Meta_1 = require("./models/Meta");
+Object.defineProperty(exports, "MetaInfo", { enumerable: true, get: function () { return Meta_1.MetaInfo; } });
+Object.defineProperty(exports, "Meta", { enumerable: true, get: function () { return Meta_1.Meta; } });
+// =============================================================
+// PUBLIC API
+// =============================================================
+/**
+ * Encode input data into valid **AI.Data** format.
+ */
+function encode(data, config = {}) {
+    let node;
+    node = (0, Parser_1.parseDataToNode)(data);
+    const finalConfig = { ...config_1.DEFAULT_CONFIG, ...config };
+    const encoder = new Encoder_1.Encoder(finalConfig);
+    return encoder.encode(node);
+}
+/**
+ * Decode AI.Data format text into a Node structure.
+ */
+function decode(text, options = {}, schema = "") {
+    const { removeAnsiColors = false, debug = false } = options;
+    const decoder = new Decoder_1.Decoder(text, schema, removeAnsiColors, debug);
+    return decoder.decode();
+}
+/**
+ * Convert raw JavaScript object/value into a Node.
+ */
+function parse(data) {
+    return (0, Parser_1.parseDataToNode)(data);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAmBA,wBAMC;AAKD,wBAQC;AAKD,sBAEC;AA7CD,qCAAyD;AACzD,4CAAyC;AACzC,4CAAuD;AACvD,0CAAgD;AAChD,wCAAqC;AAK5B,qFALA,WAAI,OAKA;AAJb,4CAAqD;AAItC,uFAJN,eAAM,OAIM;AAAE,2FAJN,mBAAU,OAIM;AAHjC,wCAA0D;AAIhD,yFAJD,eAAQ,OAIC;AAAd,qFAJe,WAAI,OAIf;AAER,gEAAgE;AAChE,aAAa;AACb,gEAAgE;AAEhE;;GAEG;AACH,SAAgB,MAAM,CAAC,IAAgB,EAAE,SAAiC,EAAE;IACxE,IAAI,IAAU,CAAC;IACf,IAAI,GAAG,IAAA,wBAAe,EAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,WAAW,GAAkB,EAAE,GAAG,uBAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACpE,MAAM,OAAO,GAAG,IAAI,iBAAO,CAAC,WAAW,CAAC,CAAC;IACzC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAgB,MAAM,CAClB,IAAY,EACZ,UAA2D,EAAE,EAC7D,SAAiB,EAAE;IAEnB,MAAM,EAAE,gBAAgB,GAAG,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC5D,MAAM,OAAO,GAAG,IAAI,iBAAO,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;IACnE,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAC,IAAS;IAC3B,OAAO,IAAA,wBAAe,EAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/models/Meta.d.ts

@@ -0,0 +1,48 @@
+export interface MetaProps {
+    comments?: string[];
+    attr?: Record<string, any>;
+    tags?: string[];
+}
+/**
+ * Mixin/Base class that adds metadata storage capabilities to Node and Schema.
+ */
+export declare class Meta {
+    comments: string[];
+    attr: Record<string, any>;
+    tags: string[];
+    constructor({ comments, attr, tags }?: MetaProps);
+    /**
+     * Clears ALL metadata (comments, attributes, tags).
+     */
+    clearCommonMeta(): void;
+    /**
+     * Merges only the common fields (attributes, comments, tags)
+     * from a MetaInfo object. Safe for both Node and Schema.
+     */
+    applyCommonMeta(info: Meta): void;
+}
+/**
+ * A temporary container (DTO) holding parsed metadata from a / ... / block.
+ * It contains BOTH Schema constraints (!required) and Node attributes ($key=val).
+ */
+export declare class MetaInfo extends Meta {
+    required: boolean;
+    constructor(props?: MetaProps & {
+        required?: boolean;
+    });
+    /**
+     * Merges everything from another MetaInfo object, including 'required' flag.
+     */
+    applyMeta(info: MetaInfo): void;
+    /**
+     * Allows usage checks like 'if meta.isEmpty()' to see if any metadata was collected.
+     * Equivalent to Python's __bool__.
+     */
+    isEmpty(): boolean;
+    /**
+     * Debug representation mimicking the actual ADF format style.
+     * Example: <MetaInfo !required #tag $key=val >
+     */
+    toString(): string;
+}
+//# sourceMappingURL=Meta.d.ts.map

package/dist/models/Meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Meta.d.ts","sourceRoot":"","sources":["../../src/models/Meta.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,qBAAa,IAAI;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;gBAEH,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAE,SAAc;IAMpD;;OAEG;IACH,eAAe,IAAI,IAAI;IAMvB;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;CAgBpC;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,IAAI;IAC9B,QAAQ,EAAE,OAAO,CAAC;gBAEN,KAAK,GAAE,SAAS,GAAG;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO;IAK1D;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAU/B;;;OAGG;IACH,OAAO,IAAI,OAAO;IASlB;;;OAGG;IACH,QAAQ,IAAI,MAAM;CAwCrB"}

package/dist/models/Meta.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetaInfo = exports.Meta = void 0;
+/**
+ * Mixin/Base class that adds metadata storage capabilities to Node and Schema.
+ */
+class Meta {
+    constructor({ comments, attr, tags } = {}) {
+        this.comments = comments ? [...comments] : [];
+        this.attr = attr ? { ...attr } : {};
+        this.tags = tags ? [...tags] : [];
+    }
+    /**
+     * Clears ALL metadata (comments, attributes, tags).
+     */
+    clearCommonMeta() {
+        this.comments = [];
+        this.attr = {};
+        this.tags = [];
+    }
+    /**
+     * Merges only the common fields (attributes, comments, tags)
+     * from a MetaInfo object. Safe for both Node and Schema.
+     */
+    applyCommonMeta(info) {
+        // Append comments
+        if (info.comments.length > 0) {
+            this.comments.push(...info.comments);
+        }
+        // Merge attributes ($key=value)
+        if (Object.keys(info.attr).length > 0) {
+            Object.assign(this.attr, info.attr);
+        }
+        // Append tags
+        if (info.tags.length > 0) {
+            this.tags.push(...info.tags);
+        }
+    }
+}
+exports.Meta = Meta;
+/**
+ * A temporary container (DTO) holding parsed metadata from a / ... / block.
+ * It contains BOTH Schema constraints (!required) and Node attributes ($key=val).
+ */
+class MetaInfo extends Meta {
+    constructor(props = {}) {
+        super(props);
+        this.required = props.required || false;
+    }
+    /**
+     * Merges everything from another MetaInfo object, including 'required' flag.
+     */
+    applyMeta(info) {
+        // Apply common fields (comments, attr, tags)
+        this.applyCommonMeta(info);
+        // Override required meta (Schema Only)
+        if (info.required) {
+            this.required = true;
+        }
+    }
+    /**
+     * Allows usage checks like 'if meta.isEmpty()' to see if any metadata was collected.
+     * Equivalent to Python's __bool__.
+     */
+    isEmpty() {
+        return (this.comments.length === 0 &&
+            Object.keys(this.attr).length === 0 &&
+            this.tags.length === 0 &&
+            !this.required);
+    }
+    /**
+     * Debug representation mimicking the actual ADF format style.
+     * Example: <MetaInfo !required #tag $key=val >
+     */
+    toString() {
+        const parts = [];
+        // 1. Flags
+        if (this.required) {
+            parts.push("!required");
+        }
+        // 2. Tags
+        for (const t of this.tags) {
+            parts.push(`#${t}`);
+        }
+        // 3. Attributes
+        for (const [k, v] of Object.entries(this.attr)) {
+            // Simplistic value repr for debug
+            let valStr;
+            if (typeof v === 'string') {
+                valStr = `"${v}"`;
+            }
+            else {
+                valStr = String(v);
+            }
+            parts.push(`$${k}=${valStr}`);
+        }
+        // 4. Comments (Summary)
+        if (this.comments.length > 0) {
+            if (this.comments.length === 1) {
+                const c = this.comments[0];
+                const preview = c.length > 15 ? c.substring(0, 15) + '..' : c;
+                parts.push(`/* ${preview} */`);
+            }
+            else {
+                parts.push(`/* ${this.comments.length} comments */`);
+            }
+        }
+        const content = parts.join(" ");
+        return content ? `<MetaInfo ${content}>` : "<MetaInfo (empty)>";
+    }
+}
+exports.MetaInfo = MetaInfo;
+//# sourceMappingURL=Meta.js.map

package/dist/models/Meta.js.map

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

package/dist/models/Node.d.ts

@@ -0,0 +1,42 @@
+import { Meta, MetaInfo, MetaProps } from './Meta';
+import { Schema } from './Schema';
+export interface NodeProps extends MetaProps {
+    name?: string;
+    value?: any;
+    fields?: Record<string, Node>;
+    elements?: Node[];
+}
+/**
+ * Canonical runtime data object for AI.DATA.
+ * A Node always refers to a Schema which defines how data should be interpreted.
+ */
+export declare class Node extends Meta {
+    schema: Schema;
+    name: string;
+    value: any;
+    fields: Record<string, Node>;
+    elements: Node[];
+    constructor(schema: Schema, props?: NodeProps);
+    get isPrimitive(): boolean;
+    get isRecord(): boolean;
+    get isList(): boolean;
+    clearMeta(): void;
+    applyMeta(info: MetaInfo): void;
+    /**
+     * Recursively converts the Node into a standard JavaScript object/array/primitive.
+     * Equivalent to Python's .dict() method.
+     */
+    dict(): any;
+    /**
+     * Converts the Node to a JSON string.
+     * * @param indent Number of spaces for indentation.
+     * @param colorize If true, applies ANSI colors to keys, strings, numbers, etc.
+     */
+    JSON(indent?: number, colorize?: boolean): string;
+    /**
+     * Technical debug representation.
+     * Format: <Node(KIND:type) value/len=... details...>
+     */
+    toString(): string;
+}
+//# sourceMappingURL=Node.d.ts.map

package/dist/models/Node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../src/models/Node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,SAAU,SAAQ,SAAS;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,IAAK,SAAQ,IAAI;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,GAAG,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7B,QAAQ,EAAE,IAAI,EAAE,CAAC;gBAEL,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,SAAc;IAajD,IAAI,WAAW,IAAI,OAAO,CAAmD;IAC7E,IAAI,QAAQ,IAAI,OAAO,CAAgD;IACvE,IAAI,MAAM,IAAI,OAAO,CAA8C;IAMnE,SAAS,IAAI,IAAI;IAIjB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAW/B;;;OAGG;IACH,IAAI,IAAI,GAAG;IAoBX;;;;OAIG;IACH,IAAI,CAAC,MAAM,GAAE,MAAU,EAAE,QAAQ,GAAE,OAAe,GAAG,MAAM;IA6D3D;;;OAGG;IACH,QAAQ,IAAI,MAAM;CA4DrB"}

package/dist/models/Node.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Node = void 0;
+const Meta_1 = require("./Meta");
+/**
+ * Canonical runtime data object for AI.DATA.
+ * A Node always refers to a Schema which defines how data should be interpreted.
+ */
+class Node extends Meta_1.Meta {
+    constructor(schema, props = {}) {
+        super(props);
+        this.schema = schema;
+        this.name = props.name || "";
+        this.value = props.value ?? null;
+        this.fields = props.fields || {};
+        this.elements = props.elements ? [...props.elements] : [];
+    }
+    // -----------------------------------------------------------
+    // Introspection helpers
+    // -----------------------------------------------------------
+    get isPrimitive() { return this.schema && this.schema.isPrimitive; }
+    get isRecord() { return this.schema && this.schema.isRecord; }
+    get isList() { return this.schema && this.schema.isList; }
+    // -----------------------------------------------------------
+    // Meta
+    // -----------------------------------------------------------
+    clearMeta() {
+        this.clearCommonMeta();
+    }
+    applyMeta(info) {
+        // Applies ALL metadata (common stuff: meta dict, comments)
+        this.applyCommonMeta(info);
+    }
+    // -----------------------------------------------------------
+    // Conversion Methods (dict / json)
+    // -----------------------------------------------------------
+    /**
+     * Recursively converts the Node into a standard JavaScript object/array/primitive.
+     * Equivalent to Python's .dict() method.
+     */
+    dict() {
+        if (this.isPrimitive) {
+            return this.value;
+        }
+        if (this.isList) {
+            return this.elements.map(element => element.dict());
+        }
+        if (this.isRecord) {
+            const result = {};
+            for (const [key, fieldNode] of Object.entries(this.fields)) {
+                result[key] = fieldNode.dict();
+            }
+            return result;
+        }
+        return this.value;
+    }
+    /**
+     * Converts the Node to a JSON string.
+     * * @param indent Number of spaces for indentation.
+     * @param colorize If true, applies ANSI colors to keys, strings, numbers, etc.
+     */
+    JSON(indent = 2, colorize = false) {
+        // 1. Convert to standard JS object
+        const data = this.dict();
+        // 2. Dump to string
+        const jsonStr = JSON.stringify(data, null, indent);
+        if (!colorize) {
+            return jsonStr;
+        }
+        // 3. Apply Colors (Regex Tokenizer)
+        // ANSI codes matching the Encoder class
+        const C = {
+            RESET: "\x1b[0m",
+            STRING: "\x1b[92m", // Green
+            NUMBER: "\x1b[94m", // Blue
+            BOOL: "\x1b[95m", // Magenta
+            NULL: "\x1b[90m", // Gray
+            KEY: "\x1b[93m" // Yellow
+        };
+        // Regex to capture JSON tokens:
+        // Group 1: Keys ("key": )
+        // Group 2: String values ("value")
+        // Group 3: Booleans/Null
+        // Group 4: Numbers
+        const tokenPattern = /(".*?"\s*:)|(".*?")|\b(true|false|null)\b|(-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?)/g;
+        return jsonStr.replace(tokenPattern, (match) => {
+            // Check based on content patterns
+            // Key: Ends with ':' (ignoring whitespace) and starts with '"'
+            if (/^".*":\s*$/.test(match)) {
+                return `${C.KEY}${match}${C.RESET}`;
+            }
+            // String value: Starts with '"'
+            if (match.startsWith('"')) {
+                return `${C.STRING}${match}${C.RESET}`;
+            }
+            // Boolean
+            if (match === "true" || match === "false") {
+                return `${C.BOOL}${match}${C.RESET}`;
+            }
+            // Null
+            if (match === "null") {
+                return `${C.NULL}${match}${C.RESET}`;
+            }
+            // Number (Fallthrough)
+            return `${C.NUMBER}${match}${C.RESET}`;
+        });
+    }
+    // -----------------------------------------------------------
+    // Debug / Representation
+    // -----------------------------------------------------------
+    /**
+     * Technical debug representation.
+     * Format: <Node(KIND:type) value/len=... details...>
+     */
+    toString() {
+        // 1. Type Info
+        let typeLabel = "UNKNOWN";
+        if (this.schema) {
+            const kind = this.schema.kind;
+            const typeName = this.schema.typeName;
+            if (this.isList) {
+                const elType = this.schema.element ? (this.schema.element.typeName || "any") : "any";
+                typeLabel = `LIST[${elType}]`;
+            }
+            else if (this.isRecord && typeName !== "record" && typeName !== "any") {
+                typeLabel = `RECORD:${typeName}`;
+            }
+            else {
+                typeLabel = `${kind}:${typeName}`;
+            }
+        }
+        const header = `<Node(${typeLabel})`;
+        const content = [];
+        // 2. Content Info
+        if (this.isPrimitive) {
+            let v = String(this.value);
+            if (typeof this.value === 'string')
+                v = `"${v}"`;
+            if (v.length > 50)
+                v = v.substring(0, 47) + "...";
+            content.push(`val=${v}`);
+        }
+        else if (this.isList) {
+            content.push(`len=${this.elements.length}`);
+        }
+        else if (this.isRecord) {
+            const keys = Object.keys(this.fields);
+            let keysStr = "";
+            if (keys.length > 3) {
+                keysStr = keys.slice(0, 3).join(", ") + ", ...";
+            }
+            else {
+                keysStr = keys.join(", ");
+            }
+            content.push(`fields=[${keysStr}]`);
+        }
+        else {
+            // Fallback
+            let v = String(this.value);
+            if (v.length > 50)
+                v = v.substring(0, 47) + "...";
+            content.push(`val=${v}`);
+        }
+        // 3. Meta Indicators
+        if (this.comments.length > 0) {
+            content.push(`comments=${this.comments.length}`);
+        }
+        if (Object.keys(this.attr).length > 0) {
+            content.push(`attr=[${Object.keys(this.attr).join(', ')}]`);
+        }
+        if (this.tags.length > 0) {
+            content.push(`tags=[${this.tags.join(', ')}]`);
+        }
+        const detailsStr = content.length > 0 ? " " + content.join(" ") : "";
+        return `${header}${detailsStr}>`;
+    }
+}
+exports.Node = Node;
+//# sourceMappingURL=Node.js.map

package/dist/models/Node.js.map

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

package/dist/models/Schema.d.ts

@@ -0,0 +1,55 @@
+import { Meta, MetaInfo, MetaProps } from './Meta';
+export declare enum SchemaKind {
+    PRIMITIVE = "PRIMITIVE",// int, string, bool, null
+    RECORD = "RECORD",// User, Point, or anonymous <...>
+    LIST = "LIST",// Array/Sequence
+    DICT = "DICT",// Future-proofing: Key-Value pairs
+    ANY = "ANY"
+}
+export interface SchemaProps extends MetaProps {
+    typeName?: string;
+    name?: string;
+    fields?: Schema[];
+    element?: Schema;
+    key?: Schema;
+    value?: Schema;
+    required?: boolean;
+}
+export declare class Schema extends Meta {
+    kind: SchemaKind;
+    typeName: string;
+    name: string;
+    element: Schema | null;
+    key: Schema | null;
+    value: Schema | null;
+    required: boolean;
+    private _fieldsList;
+    private _fieldsMap;
+    constructor(kind: SchemaKind, props?: SchemaProps);
+    get isPrimitive(): boolean;
+    get isRecord(): boolean;
+    get isList(): boolean;
+    get isAny(): boolean;
+    get fields(): Schema[];
+    clearFields(): void;
+    addField(field: Schema): void;
+    /**
+     * Equivalent to Python's __getitem__.
+     * Allows access by numeric index or field name string.
+     */
+    getField(key: number | string): Schema | undefined;
+    /**
+     * Replaces an existing field with a new definition based on field.name.
+     * Preserves the original order in the fields list.
+     * If the field does not exist, it appends it (like addField).
+     */
+    replaceField(field: Schema): void;
+    clearMeta(): void;
+    applyMeta(info: MetaInfo | Schema | undefined): void;
+    /**
+     * Technical debug representation.
+     * Format: <Schema(KIND:type_name) name='...' details...>
+     */
+    toString(): string;
+}
+//# sourceMappingURL=Schema.d.ts.map

package/dist/models/Schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../../src/models/Schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEnD,oBAAY,UAAU;IAClB,SAAS,cAAc,CAAE,0BAA0B;IACnD,MAAM,WAAW,CAAQ,kCAAkC;IAC3D,IAAI,SAAS,CAAY,iBAAiB;IAC1C,IAAI,SAAS,CAAY,mCAAmC;IAC5D,GAAG,QAAQ;CACd;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,MAAO,SAAQ,IAAI;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IAGb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAGrB,QAAQ,EAAE,OAAO,CAAC;IAGlB,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,UAAU,CAAkC;gBAExC,IAAI,EAAE,UAAU,EAAE,KAAK,GAAE,WAAgB;IAqBrD,IAAI,WAAW,IAAI,OAAO,CAA+C;IACzE,IAAI,QAAQ,IAAI,OAAO,CAA4C;IACnE,IAAI,MAAM,IAAI,OAAO,CAA0C;IAE/D,IAAI,KAAK,IAAI,OAAO,CAMnB;IAED,IAAI,MAAM,IAAI,MAAM,EAAE,CAErB;IAMD,WAAW,IAAI,IAAI;IAKnB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAc7B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;IAUlD;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IA+BjC,SAAS,IAAI,IAAI;IAKjB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI;IAepD;;;OAGG;IACH,QAAQ,IAAI,MAAM;CAkDrB"}