@metaobjectsdev/metadata 0.5.0-rc.1

package/dist/meta/meta-source.d.ts

@@ -0,0 +1,18 @@
+import { MetaData } from "./meta-data.js";
+export declare class MetaSource extends MetaData {
+    /** The SQL table or view name (value of @name attr on the source child). */
+    get sourceName(): string | undefined;
+    /**
+     * True when this source is a `dbTable` (writable).
+     * Explicitly defined rather than derived from `isReadOnly()` so it remains
+     * correct if a third source subtype is added in the future.
+     */
+    isWritable(): boolean;
+    /**
+     * True when this source is a `dbView` (read-only projection).
+     * Explicitly defined rather than derived from `isWritable()` so it remains
+     * correct if a third source subtype is added in the future.
+     */
+    isReadOnly(): boolean;
+}
+//# sourceMappingURL=meta-source.d.ts.map

package/dist/meta/meta-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-source.d.ts","sourceRoot":"","sources":["../../src/meta/meta-source.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAO1C,qBAAa,UAAW,SAAQ,QAAQ;IACtC,4EAA4E;IAC5E,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAGnC;IAED;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;OAIG;IACH,UAAU,IAAI,OAAO;CAGtB"}

package/dist/meta/meta-source.js

@@ -0,0 +1,31 @@
+// MetaSource — concrete node class for type=source nodes.
+// Declares where an object's data lives (Project E).
+// dbTable / dbView source subtypes declare the SQL table or view name.
+//
+// Extends MetaData directly: no model wrapper, no metaOf() indirection.
+import { MetaData } from "./meta-data.js";
+import { SOURCE_ATTR_NAME, SOURCE_SUBTYPE_DB_TABLE, SOURCE_SUBTYPE_DB_VIEW, } from "../constants.js";
+export class MetaSource extends MetaData {
+    /** The SQL table or view name (value of @name attr on the source child). */
+    get sourceName() {
+        const v = this.ownAttr(SOURCE_ATTR_NAME);
+        return typeof v === "string" ? v : undefined;
+    }
+    /**
+     * True when this source is a `dbTable` (writable).
+     * Explicitly defined rather than derived from `isReadOnly()` so it remains
+     * correct if a third source subtype is added in the future.
+     */
+    isWritable() {
+        return this.subType === SOURCE_SUBTYPE_DB_TABLE;
+    }
+    /**
+     * True when this source is a `dbView` (read-only projection).
+     * Explicitly defined rather than derived from `isWritable()` so it remains
+     * correct if a third source subtype is added in the future.
+     */
+    isReadOnly() {
+        return this.subType === SOURCE_SUBTYPE_DB_VIEW;
+    }
+}
+//# sourceMappingURL=meta-source.js.map

package/dist/meta/meta-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-source.js","sourceRoot":"","sources":["../../src/meta/meta-source.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,qDAAqD;AACrD,uEAAuE;AACvE,EAAE;AACF,wEAAwE;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,OAAO,UAAW,SAAQ,QAAQ;IACtC,4EAA4E;IAC5E,IAAI,UAAU;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACzC,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,KAAK,uBAAuB,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,KAAK,sBAAsB,CAAC;IACjD,CAAC;CACF"}

package/dist/meta/meta-validator.d.ts

@@ -0,0 +1,29 @@
+import { MetaData } from "./meta-data.js";
+export declare class MetaValidator extends MetaData {
+    /**
+     * Numeric range — shared by length, numeric, and array validators.
+     * (Pattern moves to MetaRegexValidator; required validators have no extra attrs.)
+     */
+    get min(): number | undefined;
+    get max(): number | undefined;
+    isRequired(): boolean;
+    isLength(): boolean;
+    isRegex(): boolean;
+}
+/** Required validator (no extra attrs; subtype class exists for instanceof narrowing). */
+export declare class MetaRequiredValidator extends MetaValidator {
+}
+/** Length validator: min/max are string/array length bounds. */
+export declare class MetaLengthValidator extends MetaValidator {
+}
+/** Regex validator: carries the pattern. */
+export declare class MetaRegexValidator extends MetaValidator {
+    get pattern(): string | undefined;
+}
+/** Numeric validator: min/max are value bounds. */
+export declare class MetaNumericValidator extends MetaValidator {
+}
+/** Array validator: min/max are element-count bounds. */
+export declare class MetaArrayValidator extends MetaValidator {
+}
+//# sourceMappingURL=meta-validator.d.ts.map

package/dist/meta/meta-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-validator.d.ts","sourceRoot":"","sources":["../../src/meta/meta-validator.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAU1C,qBAAa,aAAc,SAAQ,QAAQ;IACzC;;;OAGG;IACH,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAG5B;IAED,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAG5B;IAED,UAAU,IAAI,OAAO;IAIrB,QAAQ,IAAI,OAAO;IAInB,OAAO,IAAI,OAAO;CAGnB;AAED,0FAA0F;AAC1F,qBAAa,qBAAsB,SAAQ,aAAa;CAAG;AAE3D,gEAAgE;AAChE,qBAAa,mBAAoB,SAAQ,aAAa;CAAG;AAEzD,4CAA4C;AAC5C,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAGhC;CACF;AAED,mDAAmD;AACnD,qBAAa,oBAAqB,SAAQ,aAAa;CAAG;AAE1D,yDAAyD;AACzD,qBAAa,kBAAmB,SAAQ,aAAa;CAAG"}

package/dist/meta/meta-validator.js

@@ -0,0 +1,49 @@
+// MetaValidator — concrete node class for type=validator nodes.
+// Subtype classes (Required, Length, Regex, Numeric, Array) are co-located.
+//
+// Extends MetaData directly: no model wrapper, no metaOf() indirection.
+import { MetaData } from "./meta-data.js";
+import { VALIDATOR_SUBTYPE_REQUIRED, VALIDATOR_SUBTYPE_LENGTH, VALIDATOR_SUBTYPE_REGEX, VALIDATOR_ATTR_PATTERN, VALIDATOR_ATTR_MIN, VALIDATOR_ATTR_MAX, } from "../constants.js";
+export class MetaValidator extends MetaData {
+    /**
+     * Numeric range — shared by length, numeric, and array validators.
+     * (Pattern moves to MetaRegexValidator; required validators have no extra attrs.)
+     */
+    get min() {
+        const v = this.ownAttr(VALIDATOR_ATTR_MIN);
+        return typeof v === "number" ? v : undefined;
+    }
+    get max() {
+        const v = this.ownAttr(VALIDATOR_ATTR_MAX);
+        return typeof v === "number" ? v : undefined;
+    }
+    isRequired() {
+        return this.subType === VALIDATOR_SUBTYPE_REQUIRED;
+    }
+    isLength() {
+        return this.subType === VALIDATOR_SUBTYPE_LENGTH;
+    }
+    isRegex() {
+        return this.subType === VALIDATOR_SUBTYPE_REGEX;
+    }
+}
+/** Required validator (no extra attrs; subtype class exists for instanceof narrowing). */
+export class MetaRequiredValidator extends MetaValidator {
+}
+/** Length validator: min/max are string/array length bounds. */
+export class MetaLengthValidator extends MetaValidator {
+}
+/** Regex validator: carries the pattern. */
+export class MetaRegexValidator extends MetaValidator {
+    get pattern() {
+        const v = this.ownAttr(VALIDATOR_ATTR_PATTERN);
+        return typeof v === "string" ? v : undefined;
+    }
+}
+/** Numeric validator: min/max are value bounds. */
+export class MetaNumericValidator extends MetaValidator {
+}
+/** Array validator: min/max are element-count bounds. */
+export class MetaArrayValidator extends MetaValidator {
+}
+//# sourceMappingURL=meta-validator.js.map

package/dist/meta/meta-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-validator.js","sourceRoot":"","sources":["../../src/meta/meta-validator.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,4EAA4E;AAC5E,EAAE;AACF,wEAAwE;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC;;;OAGG;IACH,IAAI,GAAG;QACL,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC3C,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,IAAI,GAAG;QACL,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC3C,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,KAAK,0BAA0B,CAAC;IACrD,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,KAAK,wBAAwB,CAAC;IACnD,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,KAAK,uBAAuB,CAAC;IAClD,CAAC;CACF;AAED,0FAA0F;AAC1F,MAAM,OAAO,qBAAsB,SAAQ,aAAa;CAAG;AAE3D,gEAAgE;AAChE,MAAM,OAAO,mBAAoB,SAAQ,aAAa;CAAG;AAEzD,4CAA4C;AAC5C,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,IAAI,OAAO;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;QAC/C,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;CACF;AAED,mDAAmD;AACnD,MAAM,OAAO,oBAAqB,SAAQ,aAAa;CAAG;AAE1D,yDAAyD;AACzD,MAAM,OAAO,kBAAmB,SAAQ,aAAa;CAAG"}

package/dist/meta/meta-view.d.ts

@@ -0,0 +1,4 @@
+import { MetaData } from "./meta-data.js";
+export declare class MetaView extends MetaData {
+}
+//# sourceMappingURL=meta-view.d.ts.map

package/dist/meta/meta-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-view.d.ts","sourceRoot":"","sources":["../../src/meta/meta-view.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,qBAAa,QAAS,SAAQ,QAAQ;CAAG"}

package/dist/meta/meta-view.js

@@ -0,0 +1,8 @@
+// MetaView — concrete node class for type=view nodes.
+//
+// Extends MetaData directly: no model wrapper, no metaOf() indirection.
+// Currently minimal — placeholder for v0.3+ view-level accessors.
+import { MetaData } from "./meta-data.js";
+export class MetaView extends MetaData {
+}
+//# sourceMappingURL=meta-view.js.map

package/dist/meta/meta-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-view.js","sourceRoot":"","sources":["../../src/meta/meta-view.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,wEAAwE;AACxE,kEAAkE;AAElE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,OAAO,QAAS,SAAQ,QAAQ;CAAG"}

package/dist/naming.d.ts

@@ -0,0 +1,27 @@
+import type { MetaData } from "./shared/meta-data.js";
+/**
+ * Strip the package prefix from a metadata-qualified name
+ * (e.g. "pkg::Name" → "Name"). Returns the input unchanged if no
+ * package separator is present. Single canonical helper consumed by
+ * both find-reference (cross-entity lookup) and codegen-ts (FQN
+ * normalization in generated code).
+ */
+export declare function stripPackage(name: string | undefined): string;
+export declare function toSnakeCase(s: string): string;
+export declare function pluralize(s: string): string;
+export declare function resolveTableName(entity: MetaData): string;
+export declare function resolveColumnName(field: MetaData): string;
+/**
+ * Returns the DB schema declared on an entity's source[dbTable] or source[dbView] child,
+ * or undefined if no @schema attr is set or no source child exists. Callers decide what
+ * "undefined" means for their dialect — Postgres treats it as the default public schema,
+ * SQLite treats it as the only allowed value (no schema concept).
+ */
+export declare function resolveTableSchema(entity: MetaData): string | undefined;
+/** Per-entity {jsName ↔ dbColumn} map. Built once per entity to avoid re-walking children on every row. */
+export interface EntityNameMap {
+    jsToDb: Map<string, string>;
+    dbToJs: Map<string, string>;
+}
+export declare function buildNameMap(entity: MetaData): EntityNameMap;
+//# sourceMappingURL=naming.d.ts.map

package/dist/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAWtD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI7D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI3C;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAOzD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAIzD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CASvE;AAED,2GAA2G;AAC3G,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,aAAa,CAU5D"}

package/dist/naming.js

@@ -0,0 +1,72 @@
+import { TYPE_FIELD, TYPE_SOURCE } from "./shared/base-types.js";
+import { PACKAGE_SEPARATOR } from "./shared/structural.js";
+import { FIELD_ATTR_DB_COLUMN } from "./persistence/db/db-constants.js";
+import { SOURCE_SUBTYPE_DB_TABLE, SOURCE_SUBTYPE_DB_VIEW, SOURCE_DB_TABLE_ATTR_NAME, SOURCE_ATTR_SCHEMA, } from "./persistence/source/source-constants.js";
+/**
+ * Strip the package prefix from a metadata-qualified name
+ * (e.g. "pkg::Name" → "Name"). Returns the input unchanged if no
+ * package separator is present. Single canonical helper consumed by
+ * both find-reference (cross-entity lookup) and codegen-ts (FQN
+ * normalization in generated code).
+ */
+export function stripPackage(name) {
+    if (!name)
+        return "";
+    const idx = name.lastIndexOf(PACKAGE_SEPARATOR);
+    return idx === -1 ? name : name.slice(idx + PACKAGE_SEPARATOR.length);
+}
+export function toSnakeCase(s) {
+    return s
+        .replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2")
+        .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+        .toLowerCase();
+}
+export function pluralize(s) {
+    if (/(s|x|z|ch|sh)$/i.test(s))
+        return s + "es";
+    if (/[^aeiou]y$/i.test(s))
+        return s.slice(0, -1) + "ies";
+    return s + "s";
+}
+export function resolveTableName(entity) {
+    const source = entity.ownChildren().find((c) => c.type === TYPE_SOURCE && c.subType === SOURCE_SUBTYPE_DB_TABLE);
+    const name = source?.ownAttr(SOURCE_DB_TABLE_ATTR_NAME);
+    if (typeof name === "string" && name !== "")
+        return name;
+    return pluralize(toSnakeCase(entity.name));
+}
+export function resolveColumnName(field) {
+    const attr = field.ownAttr(FIELD_ATTR_DB_COLUMN);
+    if (typeof attr === "string")
+        return attr;
+    return toSnakeCase(field.name);
+}
+/**
+ * Returns the DB schema declared on an entity's source[dbTable] or source[dbView] child,
+ * or undefined if no @schema attr is set or no source child exists. Callers decide what
+ * "undefined" means for their dialect — Postgres treats it as the default public schema,
+ * SQLite treats it as the only allowed value (no schema concept).
+ */
+export function resolveTableSchema(entity) {
+    const source = entity.ownChildren().find((c) => c.type === TYPE_SOURCE
+        && (c.subType === SOURCE_SUBTYPE_DB_TABLE || c.subType === SOURCE_SUBTYPE_DB_VIEW));
+    if (!source)
+        return undefined;
+    const schema = source.ownAttr(SOURCE_ATTR_SCHEMA);
+    if (typeof schema === "string" && schema !== "")
+        return schema;
+    return undefined;
+}
+export function buildNameMap(entity) {
+    const jsToDb = new Map();
+    const dbToJs = new Map();
+    for (const child of entity.ownChildren()) {
+        if (child.type !== TYPE_FIELD)
+            continue;
+        const dbCol = resolveColumnName(child);
+        jsToDb.set(child.name, dbCol);
+        dbToJs.set(dbCol, child.name);
+    }
+    return { jsToDb, dbToJs };
+}
+//# sourceMappingURL=naming.js.map

package/dist/naming.js.map

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

package/dist/object-serializer.d.ts

@@ -0,0 +1,10 @@
+import type { MetaObject } from "./core/object/meta-object.js";
+export interface ObjectSerializeOptions {
+    /** Emit the `@type` discriminator property. Default true. */
+    emitType?: boolean;
+}
+/** Serialize an application-object instance to wire JSON, driven by `mo`. */
+export declare function objectToJson(mo: MetaObject, instance: Record<string, unknown>, opts?: ObjectSerializeOptions): Record<string, unknown>;
+/** Parse wire JSON into an application-object instance, driven by `mo`. */
+export declare function jsonToObject(mo: MetaObject, json: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=object-serializer.d.ts.map

package/dist/object-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-serializer.d.ts","sourceRoot":"","sources":["../src/object-serializer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAe/D,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAC1B,EAAE,EAAE,UAAU,EACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,CAAC,EAAE,sBAAsB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAC1B,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB"}

package/dist/object-serializer.js

@@ -0,0 +1,128 @@
+// Metadata-driven object serializer.
+//
+// objectToJson / jsonToObject convert application-object instances <-> JSON
+// driven by a MetaObject's field metadata — no per-entity code. Dispatch is on
+// each field's DataType. Plain objects in, plain objects out (the caller does
+// JSON.parse / JSON.stringify). Best-effort and total: neither function throws
+// for malformed instance data, and there is no validation (settled in the
+// spec — Java's object reader does not validate either).
+import { DATA_TYPE_BOOLEAN, DATA_TYPE_INT, DATA_TYPE_LONG, DATA_TYPE_DOUBLE, DATA_TYPE_STRING, DATA_TYPE_DATE, DATA_TYPE_OBJECT, } from "./data-type.js";
+import { TYPE_OBJECT } from "./shared/base-types.js";
+const TYPE_DISCRIMINATOR = "@type";
+/** Serialize an application-object instance to wire JSON, driven by `mo`. */
+export function objectToJson(mo, instance, opts) {
+    const out = {};
+    if (opts?.emitType ?? true) {
+        out[TYPE_DISCRIMINATOR] = mo.name;
+    }
+    for (const field of mo.fields()) {
+        const raw = instance[field.name];
+        if (raw === undefined)
+            continue; // absent field → omit
+        out[field.name] = field.isArray
+            ? mapArray(raw, (el) => toJsonValue(field, el, mo))
+            : toJsonValue(field, raw, mo);
+    }
+    return out;
+}
+/** Parse wire JSON into an application-object instance, driven by `mo`. */
+export function jsonToObject(mo, json) {
+    const out = {};
+    for (const field of mo.fields()) {
+        const raw = json[field.name];
+        if (raw === undefined)
+            continue;
+        out[field.name] = field.isArray
+            ? mapArray(raw, (el) => fromJsonValue(field, el, mo))
+            : fromJsonValue(field, raw, mo);
+    }
+    return out;
+}
+// --- write-side conversion -------------------------------------------------
+function toJsonValue(field, raw, mo) {
+    switch (field.dataType) {
+        case DATA_TYPE_DATE:
+            return toIsoString(raw);
+        case DATA_TYPE_OBJECT: {
+            const target = resolveObjectRef(field, mo);
+            if (target === undefined || !isPlainObject(raw))
+                return raw;
+            // Nested objects always carry their own @type (a generic reader needs
+            // it); `emitType: false` suppresses only the top-level discriminator.
+            return objectToJson(target, raw);
+        }
+        case DATA_TYPE_BOOLEAN:
+        case DATA_TYPE_INT:
+        case DATA_TYPE_LONG:
+        case DATA_TYPE_DOUBLE:
+        case DATA_TYPE_STRING:
+        default:
+            return raw; // scalars: already JSON-native, pass through
+    }
+}
+// --- read-side conversion --------------------------------------------------
+function fromJsonValue(field, raw, mo) {
+    switch (field.dataType) {
+        case DATA_TYPE_BOOLEAN:
+            return coerceBoolean(raw);
+        case DATA_TYPE_INT:
+        case DATA_TYPE_LONG:
+        case DATA_TYPE_DOUBLE:
+            return coerceNumeric(raw);
+        case DATA_TYPE_OBJECT: {
+            const target = resolveObjectRef(field, mo);
+            if (target === undefined || !isPlainObject(raw))
+                return raw;
+            return jsonToObject(target, raw);
+        }
+        case DATA_TYPE_STRING:
+        case DATA_TYPE_DATE: // kept as the ISO string; the UI builds its own Date
+        default:
+            return raw;
+    }
+}
+// --- helpers ---------------------------------------------------------------
+function mapArray(raw, convert) {
+    return Array.isArray(raw) ? raw.map(convert) : raw;
+}
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function toIsoString(raw) {
+    if (raw instanceof Date)
+        return raw.toISOString();
+    if (typeof raw === "number")
+        return new Date(raw).toISOString();
+    return raw; // a string passes through; anything else best-effort
+}
+function coerceBoolean(raw) {
+    if (typeof raw === "boolean")
+        return raw;
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    return raw;
+}
+function coerceNumeric(raw) {
+    if (typeof raw === "number")
+        return raw;
+    if (typeof raw === "string" && raw.trim() !== "" && Number.isFinite(Number(raw))) {
+        return Number(raw);
+    }
+    return raw;
+}
+/** Resolve an object-typed field's `@objectRef` to its target MetaObject by
+ *  walking to the tree root and looking up the named object child. Returns
+ *  undefined when there is no ref or it does not resolve (caller passes the
+ *  raw value through — best-effort). */
+function resolveObjectRef(field, mo) {
+    const ref = field.objectRef;
+    if (ref === undefined)
+        return undefined;
+    const found = mo.root().ownChildByTypeAndName(TYPE_OBJECT, ref);
+    if (found === undefined)
+        return undefined;
+    return found;
+}
+//# sourceMappingURL=object-serializer.js.map

package/dist/object-serializer.js.map

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

package/dist/overlay.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=overlay.d.ts.map

package/dist/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../src/overlay.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC"}

package/dist/overlay.js

@@ -0,0 +1,6 @@
+// overlay.ts — empty module.
+//
+// Merging happens during parse via the parser's accumRoot + createOrFindMetaData
+// logic. See parser-json.ts and the per-node isMerge flag on MetaData.
+export {};
+//# sourceMappingURL=overlay.js.map

package/dist/overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","sourceRoot":"","sources":["../src/overlay.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,EAAE;AACF,iFAAiF;AACjF,uEAAuE;AACvE,OAAO,EAAE,CAAC"}

package/dist/parser-core.d.ts

@@ -0,0 +1,47 @@
+import { TypeRegistry } from "./registry.js";
+import { MetaRoot } from "./shared/meta-root.js";
+import { ParseError } from "./errors.js";
+export interface ParseOptions {
+    registry: TypeRegistry;
+    strict?: boolean;
+    sourceName?: string;
+    /**
+     * Loader's accumulating root. If provided, parse merges nodes into it.
+     * If undefined, creates a new root from the JSON's root node.
+     *
+     * When provided, the returned `root` is this same instance (possibly mutated).
+     * When undefined, a fresh root is created from the JSON.
+     */
+    intoRoot?: MetaRoot;
+    /**
+     * If true, super refs that don't resolve at parse time are NOT a parse error;
+     * the model retains its raw `superRef` and a second pass (via
+     * resolveDeferredSupers in super-resolve.ts) is expected after all input
+     * files are parsed. Used by Loader.load/loadJsonStrings to support cross-file
+     * super resolution where one file may declare a super target that lives in
+     * another file parsed later.
+     */
+    deferSuperResolution?: boolean;
+}
+export interface ParseResult {
+    root: MetaRoot;
+    warnings: string[];
+    errors: ParseError[];
+}
+export declare function errOpts(source: string | undefined, path?: string): {
+    source?: string;
+    path?: string;
+};
+/**
+ * buildTree — the shared registry-driven tree-builder.
+ *
+ * Turns an already-parsed *canonical-shaped* JS object (from JSON.parse, or
+ * from the YAML parser's desugar) into a typed MetaData tree. Both parseJson
+ * and parseYaml funnel through here, guaranteeing one structure / two
+ * renderings stay isomorphic.
+ *
+ * Throws ParseError for top-level structural problems (matching the historical
+ * parseJson behavior); collects content-level problems into the result.
+ */
+export declare function buildTree(parsed: unknown, opts: ParseOptions): ParseResult;
+//# sourceMappingURL=parser-core.d.ts.map

package/dist/parser-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-core.d.ts","sourceRoot":"","sources":["../src/parser-core.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAU,YAAY,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,OAAO,EAAE,UAAU,EAAkB,MAAM,aAAa,CAAC;AA+BzD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAOD,wBAAgB,OAAO,CACrB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,CAAC,EAAE,MAAM,GACZ;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAKpC;AAuFD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,WAAW,CA8F1E"}