@metaobjectsdev/metadata 0.5.0-rc.1

package/dist/data-converter.js

@@ -0,0 +1,117 @@
+// Data converter — convert a raw parsed value to a *known* DataType.
+//
+// The TypeScript counterpart of Java's DataConverter.toTypeSafe: directional
+// (toward a type already known from the registered schema), never inferential.
+// Replaces the deleted value-coerce.ts. See
+// docs/superpowers/specs/2026-05-17-data-converter-design.md.
+import { DATA_TYPE_BOOLEAN, DATA_TYPE_INT, DATA_TYPE_LONG, DATA_TYPE_DOUBLE, DATA_TYPE_OBJECT, } from "./data-type.js";
+/**
+ * Convert a raw parsed value to a valid AttrValue for a *known* DataType.
+ * Throws for input that cannot be a valid attr value (null / undefined /
+ * nested array). A plain object reaching a scalar branch is stringified by
+ * `String()` — callers that must reject objects use `toAttrValue`.
+ */
+export function convertToDataType(dataType, raw) {
+    rejectNullish(raw, "convertToDataType");
+    // An array value → string[] regardless of the scalar DataType — the only
+    // array shape AttrValue admits (e.g. a stringArray attr).
+    if (Array.isArray(raw))
+        return toStringArray(raw);
+    switch (dataType) {
+        case DATA_TYPE_BOOLEAN:
+            return toBoolean(raw);
+        case DATA_TYPE_INT:
+        case DATA_TYPE_LONG:
+            return toInteger(raw);
+        case DATA_TYPE_DOUBLE:
+            return toDouble(raw);
+        case DATA_TYPE_OBJECT:
+            // Object-typed attrs (filter / properties) store the object verbatim.
+            // A non-object (e.g. a legacy JSON string) is returned as-is so the
+            // attr-schema pass can reject it with ERR_BAD_ATTR_VALUE.
+            return (typeof raw === "object" && raw !== null)
+                ? raw
+                : String(raw);
+        // string, date (unreachable for attrs) — string form
+        default:
+            return String(raw);
+    }
+}
+/**
+ * Make a raw value a valid AttrValue with NO known type — for an undeclared
+ * `@`-attr. No type-directed conversion and no inference: scalars are stored
+ * as-is (a numeric-looking string stays a string), arrays become string[],
+ * objects/null/undefined are rejected.
+ */
+export function toAttrValue(raw) {
+    rejectNullish(raw, "toAttrValue");
+    if (Array.isArray(raw))
+        return toStringArray(raw);
+    if (typeof raw === "string" || typeof raw === "number" || typeof raw === "boolean") {
+        return raw;
+    }
+    throw new Error(`toAttrValue: ${typeof raw} is not a valid attr value`);
+}
+// --- helpers ---------------------------------------------------------------
+function rejectNullish(raw, fn) {
+    if (raw === null)
+        throw new Error(`${fn}: null is not a valid attr value`);
+    if (raw === undefined)
+        throw new Error(`${fn}: undefined is not a valid attr value`);
+}
+function toBoolean(raw) {
+    if (typeof raw === "boolean")
+        return raw;
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    // Not boolean-shaped — best-effort: leave it for attr-schema validation.
+    return raw;
+}
+function toInteger(raw) {
+    if (typeof raw === "number") {
+        if (Number.isInteger(raw) && !Number.isSafeInteger(raw))
+            return String(raw);
+        return raw;
+    }
+    if (typeof raw === "string") {
+        // Strict integer string (e.g. "42", "-7").
+        if (/^-?\d+$/.test(raw)) {
+            const parsed = Number(raw);
+            // Beyond MAX_SAFE_INTEGER → keep verbatim to preserve precision.
+            return Number.isSafeInteger(parsed) ? parsed : raw;
+        }
+        // Float-format strings that represent a whole number (e.g. "3.0", "12.0").
+        // Metadata files sometimes store int attr values in float notation; convert
+        // to the integer value to preserve byte-identical behavior with the old
+        // coerceAttrValue, which parsed these via the double pattern.
+        const parsed = Number(raw);
+        if (Number.isFinite(parsed) && Number.isInteger(parsed) && Number.isSafeInteger(parsed)) {
+            return parsed;
+        }
+    }
+    return raw;
+}
+function toDouble(raw) {
+    if (typeof raw === "number")
+        return raw;
+    if (typeof raw === "string") {
+        const parsed = Number(raw);
+        if (raw.trim() !== "" && Number.isFinite(parsed))
+            return parsed;
+    }
+    return raw;
+}
+function toStringArray(arr) {
+    return arr.map((el, i) => {
+        if (Array.isArray(el)) {
+            throw new Error(`array element at index ${i} is a nested array — not supported`);
+        }
+        if (el === null || el === undefined) {
+            throw new Error(`array element at index ${i} is null/undefined`);
+        }
+        return String(el);
+    });
+}
+//# sourceMappingURL=data-converter.js.map

package/dist/data-converter.js.map

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

package/dist/data-type.d.ts

@@ -0,0 +1,15 @@
+export declare const DATA_TYPE_BOOLEAN = "boolean";
+export declare const DATA_TYPE_INT = "int";
+export declare const DATA_TYPE_LONG = "long";
+export declare const DATA_TYPE_DOUBLE = "double";
+export declare const DATA_TYPE_STRING = "string";
+export declare const DATA_TYPE_DATE = "date";
+export declare const DATA_TYPE_OBJECT = "object";
+/** The closed set of coarse value types. */
+export declare const DATA_TYPES: readonly ["boolean", "int", "long", "double", "string", "date", "object"];
+export type DataType = (typeof DATA_TYPES)[number];
+/** Implemented by nodes that carry a typed value — MetaField and MetaAttr. */
+export interface DataTypeAware {
+    readonly dataType: DataType;
+}
+//# sourceMappingURL=data-type.d.ts.map

package/dist/data-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-type.d.ts","sourceRoot":"","sources":["../src/data-type.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,eAAO,MAAM,aAAa,QAAQ,CAAC;AACnC,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,gBAAgB,WAAW,CAAC;AACzC,eAAO,MAAM,gBAAgB,WAAW,CAAC;AACzC,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAEzC,4CAA4C;AAC5C,eAAO,MAAM,UAAU,2EAQb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B"}

package/dist/data-type.js

@@ -0,0 +1,25 @@
+// DataType — a coarse, cross-cutting value-type classification.
+//
+// Java-`DataTypes` parity: a small closed set that both fields and attributes
+// classify into (a `MetaField`/`MetaAttr` subtype maps to exactly one DataType).
+// Registry-driven — a (type, subType)'s DataType is declared on its
+// TypeDefinition, never in a central switch here. This module stays small and
+// stable: just the union, its constants, and the DataTypeAware interface.
+export const DATA_TYPE_BOOLEAN = "boolean";
+export const DATA_TYPE_INT = "int";
+export const DATA_TYPE_LONG = "long";
+export const DATA_TYPE_DOUBLE = "double";
+export const DATA_TYPE_STRING = "string";
+export const DATA_TYPE_DATE = "date";
+export const DATA_TYPE_OBJECT = "object";
+/** The closed set of coarse value types. */
+export const DATA_TYPES = [
+    DATA_TYPE_BOOLEAN,
+    DATA_TYPE_INT,
+    DATA_TYPE_LONG,
+    DATA_TYPE_DOUBLE,
+    DATA_TYPE_STRING,
+    DATA_TYPE_DATE,
+    DATA_TYPE_OBJECT,
+];
+//# sourceMappingURL=data-type.js.map

package/dist/data-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-type.js","sourceRoot":"","sources":["../src/data-type.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,8EAA8E;AAC9E,iFAAiF;AACjF,oEAAoE;AACpE,8EAA8E;AAC9E,0EAA0E;AAE1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAC3C,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AACzC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAEzC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,iBAAiB;IACjB,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,cAAc;IACd,gBAAgB;CACR,CAAC"}

package/dist/db/db-attr-schemas.d.ts

@@ -0,0 +1,8 @@
+import type { AttrSchema } from "../registry.js";
+/** `@dbColumn` — column-name override; on every field subtype. */
+export declare const dbColumnSchema: AttrSchema;
+/** `@db.indexed` — suppress the @filterable-without-index warning; on every field subtype. */
+export declare const dbIndexedSchema: AttrSchema;
+/** `@name` — the SQL table/view identifier; on source.dbTable and source.dbView. */
+export declare const sourceNameSchema: AttrSchema;
+//# sourceMappingURL=db-attr-schemas.d.ts.map

package/dist/db/db-attr-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-attr-schemas.d.ts","sourceRoot":"","sources":["../../src/db/db-attr-schemas.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AASjD,kEAAkE;AAClE,eAAO,MAAM,cAAc,EAAE,UAM5B,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,eAAe,EAAE,UAM7B,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,EAAE,UAM9B,CAAC"}

package/dist/db/db-attr-schemas.js

@@ -0,0 +1,26 @@
+// DB-domain attribute schemas. Relocated from core-attr-schemas.ts — these
+// attributes are registered by dbProvider (db-provider.ts), not the core
+// metamodel. See docs/superpowers/specs/2026-05-18-phase4b-db-provider-design.md.
+import { ATTR_SUBTYPE_STRING, ATTR_SUBTYPE_BOOLEAN, FIELD_ATTR_DB_COLUMN, FIELD_ATTR_DB_INDEXED, SOURCE_ATTR_NAME, } from "../constants.js";
+/** `@dbColumn` — column-name override; on every field subtype. */
+export const dbColumnSchema = {
+    name: FIELD_ATTR_DB_COLUMN,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    description: "Override the generated SQL column name for this field. Defaults to the field name run through the project's columnNamingStrategy.",
+};
+/** `@db.indexed` — suppress the @filterable-without-index warning; on every field subtype. */
+export const dbIndexedSchema = {
+    name: FIELD_ATTR_DB_INDEXED,
+    valueType: ATTR_SUBTYPE_BOOLEAN,
+    required: false,
+    description: "When true, suppress the @filterable-without-index Loader warning (the field is indexed by other means).",
+};
+/** `@name` — the SQL table/view identifier; on source.dbTable and source.dbView. */
+export const sourceNameSchema = {
+    name: SOURCE_ATTR_NAME,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    description: "The SQL table or view name for this source. Defaults to the object name run through the columnNamingStrategy when omitted.",
+};
+//# sourceMappingURL=db-attr-schemas.js.map

package/dist/db/db-attr-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-attr-schemas.js","sourceRoot":"","sources":["../../src/db/db-attr-schemas.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yEAAyE;AACzE,kFAAkF;AAGlF,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAEzB,kEAAkE;AAClE,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,IAAI,EAAE,oBAAoB;IAC1B,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,mIAAmI;CACtI,CAAC;AAEF,8FAA8F;AAC9F,MAAM,CAAC,MAAM,eAAe,GAAe;IACzC,IAAI,EAAE,qBAAqB;IAC3B,SAAS,EAAE,oBAAoB;IAC/B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,yGAAyG;CAC5G,CAAC;AAEF,oFAAoF;AACpF,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,gBAAgB;IACtB,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,4HAA4H;CAC/H,CAAC"}

package/dist/db/db-provider.d.ts

@@ -0,0 +1,3 @@
+import type { MetaDataTypeProvider } from "../provider.js";
+export declare const dbProvider: MetaDataTypeProvider;
+//# sourceMappingURL=db-provider.d.ts.map

package/dist/db/db-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-provider.d.ts","sourceRoot":"","sources":["../../src/db/db-provider.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAW3D,eAAO,MAAM,UAAU,EAAE,oBAoBxB,CAAC"}

package/dist/db/db-provider.js

@@ -0,0 +1,28 @@
+// dbProvider — the DB-domain MetaDataTypeProvider. Registers the DB-domain
+// attributes (@dbColumn, @db.indexed on fields; @name on source.dbTable /
+// source.dbView) by extending the core-registered types. Mirrors Java's
+// CoreDBMetaDataProvider (com.metaobjects.database).
+// See docs/superpowers/specs/2026-05-18-phase4b-db-provider-design.md.
+import { TYPE_FIELD, TYPE_SOURCE, FIELD_SUBTYPES, SOURCE_SUBTYPE_DB_TABLE, SOURCE_SUBTYPE_DB_VIEW, } from "../constants.js";
+import { dbColumnSchema, dbIndexedSchema, sourceNameSchema } from "./db-attr-schemas.js";
+export const dbProvider = {
+    id: "metaobjects-db",
+    dependencies: ["metaobjects-core-types"],
+    description: "DB-domain attributes — @dbColumn / @db.indexed on fields, @name on source.dbTable / source.dbView.",
+    registerTypes(registry) {
+        for (const subType of FIELD_SUBTYPES) {
+            registry.extend(TYPE_FIELD, subType, {
+                attributes: [dbColumnSchema, dbIndexedSchema],
+            });
+        }
+        // Two explicit calls (not a loop) — dbTable and dbView are the only DB
+        // source subtypes, and there is no DB_SOURCE_SUBTYPES constant to loop.
+        registry.extend(TYPE_SOURCE, SOURCE_SUBTYPE_DB_TABLE, {
+            attributes: [sourceNameSchema],
+        });
+        registry.extend(TYPE_SOURCE, SOURCE_SUBTYPE_DB_VIEW, {
+            attributes: [sourceNameSchema],
+        });
+    },
+};
+//# sourceMappingURL=db-provider.js.map

package/dist/db/db-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-provider.js","sourceRoot":"","sources":["../../src/db/db-provider.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,0EAA0E;AAC1E,wEAAwE;AACxE,qDAAqD;AACrD,uEAAuE;AAIvE,OAAO,EACL,UAAU,EACV,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEzF,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC9C,EAAE,EAAE,gBAAgB;IACpB,YAAY,EAAE,CAAC,wBAAwB,CAAC;IACxC,WAAW,EACT,oGAAoG;IACtG,aAAa,CAAC,QAAsB;QAClC,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;YACrC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE;gBACnC,UAAU,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;aAC9C,CAAC,CAAC;QACL,CAAC;QACD,uEAAuE;QACvE,wEAAwE;QACxE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,uBAAuB,EAAE;YACpD,UAAU,EAAE,CAAC,gBAAgB,CAAC;SAC/B,CAAC,CAAC;QACH,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,sBAAsB,EAAE;YACnD,UAAU,EAAE,CAAC,gBAAgB,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,26 @@
+/** Stable, language-neutral error codes — mirrors fixtures/conformance/ERROR-CODES.json. */
+export declare const ERROR_CODES: readonly ["ERR_TOP_LEVEL_NOT_OBJECT", "ERR_UNKNOWN_TYPE", "ERR_UNKNOWN_SUBTYPE", "ERR_MISSING_SUBTYPE", "ERR_DUPLICATE_NAME", "ERR_UNRESOLVED_SUPER", "ERR_INVALID_SUBTYPE_CHILD", "ERR_UNKNOWN_ATTR", "ERR_BAD_ATTR_VALUE", "ERR_BAD_DEFAULT_SORT_FIELD", "ERR_PROVIDER_DEPENDENCY_CYCLE", "ERR_PROVIDER_DUPLICATE_ID", "ERR_PROVIDER_MISSING_DEPENDENCY", "ERR_PROVIDER_ATTR_CONFLICT", "ERR_MALFORMED_JSON", "ERR_MISSING_REQUIRED_ATTR", "ERR_SUBTYPE_RULE_VIOLATION", "ERR_OVERLAY_NO_TARGET", "ERR_MALFORMED_YAML", "ERR_INVALID_ORIGIN", "ERR_BAD_ATTR_FILTER", "ERR_UNKNOWN"];
+export type ErrorCode = (typeof ERROR_CODES)[number];
+export declare class ParseError extends Error {
+    readonly source: string | undefined;
+    readonly path: string | undefined;
+    readonly code: ErrorCode | undefined;
+    constructor(message: string, opts?: {
+        source?: string;
+        path?: string;
+        code?: ErrorCode;
+    });
+}
+/**
+ * Error class for metamodel-level errors that are not parse errors — e.g.
+ * provider composition failures (dependency cycles, missing dependencies,
+ * attribute conflicts). Carries the same stable `.code` field as ParseError
+ * for cross-language conformance.
+ */
+export declare class MetaModelError extends Error {
+    readonly code: ErrorCode | undefined;
+    constructor(message: string, opts?: {
+        code?: ErrorCode;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,4FAA4F;AAO5F,eAAO,MAAM,WAAW,ujBAuBd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;gBAGnC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE;CAQ9D;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;gBAEzB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE;CAKzD"}

package/dist/errors.js

@@ -0,0 +1,59 @@
+// Typed error classes for the metadata parser.
+/** Stable, language-neutral error codes — mirrors fixtures/conformance/ERROR-CODES.json. */
+// NOTE: The following codes are forward-declared (no emitting site in the current
+// TS parser/loader — the condition is not yet detected):
+//   - ERR_DUPLICATE_NAME: parser silently reuses existing same-name nodes (find-or-create).
+//   - ERR_MISSING_SUBTYPE: missing subType is resolved to the registry default, never an error.
+//   - ERR_INVALID_SUBTYPE_CHILD: no child-rule validation pass exists yet.
+// Cross-language conformance consumers should not expect these codes from the TS adapter.
+export const ERROR_CODES = [
+    "ERR_TOP_LEVEL_NOT_OBJECT",
+    "ERR_UNKNOWN_TYPE",
+    "ERR_UNKNOWN_SUBTYPE",
+    "ERR_MISSING_SUBTYPE",
+    "ERR_DUPLICATE_NAME",
+    "ERR_UNRESOLVED_SUPER",
+    "ERR_INVALID_SUBTYPE_CHILD",
+    "ERR_UNKNOWN_ATTR",
+    "ERR_BAD_ATTR_VALUE",
+    "ERR_BAD_DEFAULT_SORT_FIELD",
+    "ERR_PROVIDER_DEPENDENCY_CYCLE",
+    "ERR_PROVIDER_DUPLICATE_ID",
+    "ERR_PROVIDER_MISSING_DEPENDENCY",
+    "ERR_PROVIDER_ATTR_CONFLICT",
+    "ERR_MALFORMED_JSON",
+    "ERR_MISSING_REQUIRED_ATTR",
+    "ERR_SUBTYPE_RULE_VIOLATION",
+    "ERR_OVERLAY_NO_TARGET",
+    "ERR_MALFORMED_YAML",
+    "ERR_INVALID_ORIGIN",
+    "ERR_BAD_ATTR_FILTER",
+    "ERR_UNKNOWN",
+];
+export class ParseError extends Error {
+    source;
+    path; // logical path within the JSON, e.g. "metadata.children[2].field"
+    code;
+    constructor(message, opts) {
+        super(message);
+        this.name = "ParseError";
+        this.source = opts?.source;
+        this.path = opts?.path;
+        this.code = opts?.code;
+    }
+}
+/**
+ * Error class for metamodel-level errors that are not parse errors — e.g.
+ * provider composition failures (dependency cycles, missing dependencies,
+ * attribute conflicts). Carries the same stable `.code` field as ParseError
+ * for cross-language conformance.
+ */
+export class MetaModelError extends Error {
+    code;
+    constructor(message, opts) {
+        super(message);
+        this.name = "MetaModelError";
+        this.code = opts?.code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAE/C,4FAA4F;AAC5F,kFAAkF;AAClF,yDAAyD;AACzD,4FAA4F;AAC5F,gGAAgG;AAChG,2EAA2E;AAC3E,0FAA0F;AAC1F,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,0BAA0B;IAC1B,kBAAkB;IAClB,qBAAqB;IACrB,qBAAqB;IACrB,oBAAoB;IACpB,sBAAsB;IACtB,2BAA2B;IAC3B,kBAAkB;IAClB,oBAAoB;IACpB,4BAA4B;IAC5B,+BAA+B;IAC/B,2BAA2B;IAC3B,iCAAiC;IACjC,4BAA4B;IAC5B,oBAAoB;IACpB,2BAA2B;IAC3B,4BAA4B;IAC5B,uBAAuB;IACvB,oBAAoB;IACpB,oBAAoB;IACpB,qBAAqB;IACrB,aAAa;CACL,CAAC;AAIX,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,MAAM,CAAqB;IAC3B,IAAI,CAAqB,CAAC,kEAAkE;IAC5F,IAAI,CAAwB;IAErC,YACE,OAAe,EACf,IAA2D;QAE3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC;IACzB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAwB;IAErC,YAAY,OAAe,EAAE,IAA2B;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC;IACzB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,70 @@
+import type { MetaRoot } from "./shared/meta-root.js";
+import type { MetaObject } from "./core/object/meta-object.js";
+import type { MetaField } from "./core/field/meta-field.js";
+import type { MetaIdentity } from "./core/identity/meta-identity.js";
+import type { MetaRelationship } from "./core/relationship/meta-relationship.js";
+import type { MetaValidator } from "./core/validator/meta-validator.js";
+import type { MetaView } from "./presentation/view/meta-view.js";
+import type { MetaAttr } from "./core/attr/meta-attr.js";
+import type { MetaLayout } from "./presentation/layout/meta-layout.js";
+import type { MetaSource } from "./persistence/source/meta-source.js";
+import type { MetaOrigin } from "./persistence/origin/meta-origin.js";
+export * from "./shared/base-types.js";
+export * from "./shared/structural.js";
+export * from "./core/object/object-constants.js";
+export * from "./core/field/field-constants.js";
+export * from "./core/attr/attr-constants.js";
+export * from "./core/validator/validator-constants.js";
+export * from "./core/identity/identity-constants.js";
+export * from "./core/relationship/relationship-constants.js";
+export * from "./core/query/query-constants.js";
+export * from "./persistence/source/source-constants.js";
+export * from "./persistence/origin/origin-constants.js";
+export * from "./persistence/db/db-constants.js";
+export * from "./presentation/view/view-constants.js";
+export * from "./presentation/layout/layout-constants.js";
+export { MetaData } from "./shared/meta-data.js";
+export type { AttrValue } from "./shared/meta-data.js";
+export { MetaRoot } from "./shared/meta-root.js";
+export { MetaObject } from "./core/object/meta-object.js";
+export { MetaField } from "./core/field/meta-field.js";
+export { MetaAttr } from "./core/attr/meta-attr.js";
+export { MetaIdentity, MetaPrimaryIdentity, MetaSecondaryIdentity, MetaReferenceIdentity, } from "./core/identity/meta-identity.js";
+export type { IdentityGeneration } from "./core/identity/meta-identity.js";
+export { MetaRelationship } from "./core/relationship/meta-relationship.js";
+export { findReferenceBetween } from "./core/relationship/find-reference.js";
+export type { ReferenceLookup } from "./core/relationship/find-reference.js";
+export { MetaValidator, MetaRequiredValidator, MetaLengthValidator, MetaRegexValidator, MetaNumericValidator, MetaArrayValidator, } from "./core/validator/meta-validator.js";
+export { MetaSource } from "./persistence/source/meta-source.js";
+export { MetaOrigin, MetaPassthroughOrigin, MetaAggregateOrigin, } from "./persistence/origin/meta-origin.js";
+export { MetaView } from "./presentation/view/meta-view.js";
+export { MetaLayout } from "./presentation/layout/meta-layout.js";
+export type AnyMeta = MetaRoot | MetaObject | MetaField | MetaIdentity | MetaRelationship | MetaValidator | MetaView | MetaAttr | MetaLayout | MetaSource | MetaOrigin;
+export { TypeId, TypeRegistry, childRuleMatches } from "./registry.js";
+export type { AttrSchema, ChildRule, TypeDefinition } from "./registry.js";
+export { registerCoreTypes, coreTypesProvider, coreProviders } from "./core-types.js";
+export { dbProvider } from "./persistence/db/db-provider.js";
+export { composeRegistry } from "./provider.js";
+export type { MetaDataTypeProvider } from "./provider.js";
+export { DATA_TYPES, 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";
+export type { DataType, DataTypeAware } from "./data-type.js";
+export { objectToJson, jsonToObject } from "./object-serializer.js";
+export type { ObjectSerializeOptions } from "./object-serializer.js";
+export { convertToDataType, toAttrValue } from "./data-converter.js";
+export { buildTree } from "./parser-core.js";
+export type { ParseOptions, ParseResult } from "./parser-core.js";
+export { parseJson } from "./parser-json.js";
+export { serializeJson, canonicalSerialize, inferAttrSubType } from "./serializer-json.js";
+export type { SerializeOptions } from "./serializer-json.js";
+export { resolveSuperRef } from "./super-resolve.js";
+export { MetaDataLoader } from "./loader/meta-data-loader.js";
+export type { LoadOptions, LoadResult, LoadingState } from "./loader/meta-data-loader.js";
+export { InMemorySource } from "./loader/meta-data-source.js";
+export type { MetaDataSource, MetaDataFormat } from "./loader/meta-data-source.js";
+export { ParseError, MetaModelError, ERROR_CODES } from "./errors.js";
+export type { ErrorCode } from "./errors.js";
+export { validateAttrSchema } from "./attr-schema-validate.js";
+export type { AttrSchemaValidationResult } from "./attr-schema-validate.js";
+export { toSnakeCase, pluralize, resolveTableName, resolveColumnName, resolveTableSchema, buildNameMap, stripPackage, } from "./naming.js";
+export type { EntityNameMap } from "./naming.js";
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,76 @@
+// Public API surface for @metaobjectsdev/metadata v0.2.0
+//
+// Architecture: one typed tree of concrete node classes organized under
+// src/{core,persistence,presentation}/<concern>/, plus open type registry
+// + JSON parser/serializer + Loader orchestration. Java-pattern aligned.
+//
+// See docs/strategy/2026-05-09-northstar-v4.md and
+// docs/specs/2026-05-09-v0.2-ts-pillar.md for context.
+// Constants — type names, subtype names, reserved keys, separators
+export * from "./shared/base-types.js";
+export * from "./shared/structural.js";
+export * from "./core/object/object-constants.js";
+export * from "./core/field/field-constants.js";
+export * from "./core/attr/attr-constants.js";
+export * from "./core/validator/validator-constants.js";
+export * from "./core/identity/identity-constants.js";
+export * from "./core/relationship/relationship-constants.js";
+export * from "./core/query/query-constants.js";
+export * from "./persistence/source/source-constants.js";
+export * from "./persistence/origin/origin-constants.js";
+export * from "./persistence/db/db-constants.js";
+export * from "./presentation/view/view-constants.js";
+export * from "./presentation/layout/layout-constants.js";
+// MetaData node base — abstract class; also exports AttrValue
+export { MetaData } from "./shared/meta-data.js";
+// Shared node classes
+export { MetaRoot } from "./shared/meta-root.js";
+// Core node classes
+export { MetaObject } from "./core/object/meta-object.js";
+export { MetaField } from "./core/field/meta-field.js";
+export { MetaAttr } from "./core/attr/meta-attr.js";
+// Identity: base + subtype-specific
+export { MetaIdentity, MetaPrimaryIdentity, MetaSecondaryIdentity, MetaReferenceIdentity, } from "./core/identity/meta-identity.js";
+// Relationship
+export { MetaRelationship } from "./core/relationship/meta-relationship.js";
+// Cross-entity reference lookup
+export { findReferenceBetween } from "./core/relationship/find-reference.js";
+// Validator: base + subtype-specific
+export { MetaValidator, MetaRequiredValidator, MetaLengthValidator, MetaRegexValidator, MetaNumericValidator, MetaArrayValidator, } from "./core/validator/meta-validator.js";
+// Persistence node classes
+export { MetaSource } from "./persistence/source/meta-source.js";
+// Origin: base + subtype-specific
+export { MetaOrigin, MetaPassthroughOrigin, MetaAggregateOrigin, } from "./persistence/origin/meta-origin.js";
+// Presentation node classes
+export { MetaView } from "./presentation/view/meta-view.js";
+export { MetaLayout } from "./presentation/layout/meta-layout.js";
+// Registry
+export { TypeId, TypeRegistry, childRuleMatches } from "./registry.js";
+export { registerCoreTypes, coreTypesProvider, coreProviders } from "./core-types.js";
+export { dbProvider } from "./persistence/db/db-provider.js";
+// Type provider model
+export { composeRegistry } from "./provider.js";
+// DataType classification
+export { DATA_TYPES, 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";
+// Metadata-driven object serializer
+export { objectToJson, jsonToObject } from "./object-serializer.js";
+// Data converter — convert a value to a known DataType (no inference)
+export { convertToDataType, toAttrValue } from "./data-converter.js";
+// Parser — shared core builder + per-format front-ends
+export { buildTree } from "./parser-core.js";
+export { parseJson } from "./parser-json.js";
+// Serializer
+export { serializeJson, canonicalSerialize, inferAttrSubType } from "./serializer-json.js";
+// Super resolution helper (most resolution moved into parser; this is the lookup utility)
+export { resolveSuperRef } from "./super-resolve.js";
+// Loader hierarchy
+export { MetaDataLoader } from "./loader/meta-data-loader.js";
+export { InMemorySource } from "./loader/meta-data-source.js";
+// Errors
+export { ParseError, MetaModelError, ERROR_CODES } from "./errors.js";
+// Attribute-schema validation pass (Phase A3)
+export { validateAttrSchema } from "./attr-schema-validate.js";
+// Naming — hoisted from runtime-ts in v0.2.3 so multiple consumers (runtime-ts, migrate-ts, codegen-ts)
+// share identical name resolution. See spec §4.1.
+export { toSnakeCase, pluralize, resolveTableName, resolveColumnName, resolveTableSchema, buildNameMap, stripPackage, } from "./naming.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/loader/meta-data-loader.d.ts

@@ -0,0 +1,87 @@
+import type { MetaData } from "../shared/meta-data.js";
+import { MetaRoot } from "../shared/meta-root.js";
+import { TypeRegistry } from "../registry.js";
+import type { MetaDataSource } from "./meta-data-source.js";
+import type { ParseOptions, ParseResult } from "../parser-core.js";
+/** Loader lifecycle state. Mirrors Java's MetaDataLoader phase enum. */
+export type LoadingState = "uninitialized" | "loading" | "loaded" | "error";
+export interface LoadOptions {
+    /** TypeRegistry to use; defaults to a fresh registry pre-populated via composeRegistry(coreProviders). */
+    registry?: TypeRegistry;
+    /** Freeze the loaded tree after parsing. Default true. */
+    freeze?: boolean;
+    /** Strict parsing mode — passed through to parser. Default false. */
+    strict?: boolean;
+}
+export interface LoadResult {
+    root: MetaRoot;
+    warnings: string[];
+    errors: Error[];
+}
+export declare class MetaDataLoader {
+    private readonly _registry;
+    private readonly _freeze;
+    private readonly _strict;
+    private _state;
+    private _root;
+    constructor(opts?: LoadOptions);
+    private static _defaultRegistry;
+    /** Current loading state. */
+    get state(): LoadingState;
+    /**
+     * The TypeRegistry this MetaDataLoader uses to look up type definitions.
+     * Either the one passed in via constructor, or the default registry
+     * pre-populated with core types via composeRegistry(coreProviders).
+     *
+     * Exposed for downstream consumers (codegen, runtime libraries) that
+     * need to introspect registered types.
+     */
+    get registry(): TypeRegistry;
+    /**
+     * Returns the loaded root MetaRoot.
+     * Accessible once load() has completed, in either "loaded" or "error" state.
+     * Throws only before or during loading (state "uninitialized" or "loading").
+     */
+    get root(): MetaRoot;
+    /**
+     * Guards read accessors — throws only when loading has not yet completed
+     * (state "uninitialized" or "loading"). Both "loaded" and "error" states
+     * are valid for reads: load() always sets _root before returning.
+     */
+    private _checkStateForRead;
+    /**
+     * Returns the first child of the root with the given name, or undefined.
+     * Throws if not yet loaded.
+     */
+    findByName(name: string): MetaData | undefined;
+    /**
+     * Returns the first child of the root with the given (type, name), or undefined.
+     * Throws if not yet loaded.
+     */
+    findByTypeAndName(type: string, name: string): MetaData | undefined;
+    /**
+     * Returns all direct children of the root with the given type.
+     * Throws if not yet loaded.
+     */
+    childrenOfType(type: string): MetaData[];
+    /**
+     * Parse one source's raw content into a ParseResult. The base loader handles
+     * JSON only; a non-JSON format throws. Subclasses override this seam to add
+     * formats — e.g. FileMetaDataLoader (in @metaobjectsdev/metadata/core) adds YAML.
+     * This keeps the browser-safe base loader free of the YAML parser.
+     */
+    protected parseSource(content: string, source: MetaDataSource, parseOpts: ParseOptions): ParseResult;
+    /**
+     * Load metadata from one or more MetaDataSource instances. Sources are read
+     * in order; each source's content is parsed and merged into the accumulating
+     * root using the parser's `intoRoot` mechanism.
+     *
+     * Source read failures are collected in errors[] — no throw. If all sources
+     * fail (read or parse), a synthetic empty root is returned.
+     *
+     * This is a one-shot pipeline — calling load() again on the same loader
+     * after it has completed (state "loaded" or "error") throws.
+     */
+    load(sources: MetaDataSource[]): Promise<LoadResult>;
+}
+//# sourceMappingURL=meta-data-loader.d.ts.map

package/dist/loader/meta-data-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-data-loader.d.ts","sourceRoot":"","sources":["../../src/loader/meta-data-loader.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAUtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMnE,wEAAwE;AACxE,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5E,MAAM,WAAW,WAAW;IAC1B,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAcD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAElC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,KAAK,CAAuB;gBAExB,IAAI,CAAC,EAAE,WAAW;IAM9B,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAQ/B,6BAA6B;IAC7B,IAAI,KAAK,IAAI,YAAY,CAExB;IAED;;;;;;;OAOG;IACH,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,QAAQ,CAGnB;IAED;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAK9C;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAKnE;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE;IASxC;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,YAAY,GACtB,WAAW;IAcd;;;;;;;;;;OAUG;IACG,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;CAmH3D"}