@metaobjectsdev/metadata 0.5.0-rc.1

package/dist/core/identity/meta-identity.js

@@ -0,0 +1,129 @@
+// MetaIdentity — concrete node class for type=identity nodes.
+// MetaPrimaryIdentity and MetaSecondaryIdentity are co-located subtype classes.
+//
+// Extends MetaData directly: no model wrapper, no metaOf() indirection.
+import { MetaData } from "../../shared/meta-data.js";
+import { IDENTITY_SUBTYPE_PRIMARY, IDENTITY_SUBTYPE_SECONDARY, IDENTITY_SUBTYPE_REFERENCE, IDENTITY_ATTR_FIELDS, IDENTITY_ATTR_GENERATION, IDENTITY_ATTR_UNIQUE, IDENTITY_REFERENCE_ATTR_REFERENCES, IDENTITY_REFERENCE_ATTR_ENFORCE, } from "./identity-constants.js";
+export class MetaIdentity extends MetaData {
+    get fields() {
+        const f = this.ownAttr(IDENTITY_ATTR_FIELDS);
+        return Array.isArray(f) ? f : [];
+    }
+    /**
+     * Whether the identity enforces uniqueness.
+     * Defaults to true; explicit `@unique: false` makes it a non-unique index.
+     */
+    get unique() {
+        return this.ownAttr(IDENTITY_ATTR_UNIQUE) !== false;
+    }
+    isPrimary() {
+        return this.subType === IDENTITY_SUBTYPE_PRIMARY;
+    }
+    isSecondary() {
+        return this.subType === IDENTITY_SUBTYPE_SECONDARY;
+    }
+    isReference() {
+        return this.subType === IDENTITY_SUBTYPE_REFERENCE;
+    }
+    isComposite() {
+        return this.fields.length > 1;
+    }
+}
+/**
+ * Primary identity (the entity's PK). Always unique by definition.
+ * Carries `@generation` (increment / uuid / assigned).
+ */
+export class MetaPrimaryIdentity extends MetaIdentity {
+    get generation() {
+        const v = this.ownAttr(IDENTITY_ATTR_GENERATION);
+        return typeof v === "string" ? v : undefined;
+    }
+}
+/**
+ * Secondary identity — a unique or non-unique index on one or more fields.
+ * `@generation` does not apply here.
+ */
+export class MetaSecondaryIdentity extends MetaIdentity {
+}
+/**
+ * Reference identity — a field (or compound field set) on this entity whose
+ * value(s) identify an instance of another entity.
+ *
+ * Maps to: SQL foreign key, document linked reference, graph edge target,
+ * OO pointer/reference. Backend-agnostic at the metamodel level.
+ *
+ * Carries `@references` — either a bare entity name (defaults to that
+ * entity's primary identity) or a dotted `Entity.field` or
+ * `Entity.fieldA,fieldB` form for explicit field/compound targets.
+ */
+export class MetaReferenceIdentity extends MetaIdentity {
+    /** Raw `@references` attr value, unparsed. */
+    get referencesRaw() {
+        const v = this.ownAttr(IDENTITY_REFERENCE_ATTR_REFERENCES);
+        return typeof v === "string" ? v : undefined;
+    }
+    /** Target entity name (the bit before the dot, or the whole bare value). */
+    get targetEntity() {
+        const raw = this.referencesRaw;
+        if (raw === undefined)
+            return undefined;
+        const dotIdx = raw.indexOf(".");
+        return dotIdx === -1 ? raw : raw.slice(0, dotIdx);
+    }
+    /**
+     * Whether the reference is physically enforced by the backend.
+     * Default true (hard FK constraint emitted). Explicit `@enforce: false`
+     * marks the reference as logical-only — drizzle-schema skips `.references()`
+     * and migrate-ts's expected schema omits the FK descriptor. relations()
+     * block and projection JOIN inference are unaffected.
+     */
+    get enforce() {
+        return this.ownAttr(IDENTITY_REFERENCE_ATTR_ENFORCE) !== false;
+    }
+    /**
+     * Target field names. Empty array means "use the target's primary identity"
+     * (the bare-entity form). For dotted forms, returns the field(s) after the
+     * dot (comma-split, trimmed).
+     */
+    get targetFields() {
+        const raw = this.referencesRaw;
+        if (raw === undefined)
+            return [];
+        const dotIdx = raw.indexOf(".");
+        if (dotIdx === -1)
+            return [];
+        return raw
+            .slice(dotIdx + 1)
+            .split(",")
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+    }
+    /**
+     * Resolve the target field on the referenced entity that this reference
+     * points at. Priority: explicit dotted-form `@references: "Entity.field"`
+     * override → target entity's primary identity field → "id" fallback.
+     *
+     * Returns undefined only if the target entity cannot be found in `root`.
+     * Centralizes the FK-target resolution rule used by projection view DDL,
+     * Drizzle schema emit, and migration schema comparison.
+     */
+    resolvedTargetPkField(root) {
+        const explicit = this.targetFields[0];
+        if (explicit !== undefined)
+            return explicit;
+        const targetName = this.targetEntity;
+        if (targetName === undefined)
+            return undefined;
+        const targetObj = root.findObject(targetName);
+        if (!targetObj)
+            return undefined;
+        const primary = targetObj.primaryIdentity();
+        const fields = primary?.ownAttr(IDENTITY_ATTR_FIELDS);
+        if (typeof fields === "string")
+            return fields.split(",")[0].trim();
+        if (Array.isArray(fields) && fields.length > 0)
+            return String(fields[0]).trim();
+        return "id";
+    }
+}
+//# sourceMappingURL=meta-identity.js.map

package/dist/core/identity/meta-identity.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+export { FileSource } from "./file-source.js";
+export { FileMetaDataLoader } from "./file-meta-data-loader.js";
+export { parseYaml } from "./parser-yaml.js";
+export { loadAndExportJson } from "./export-json.js";
+export type { ExportResult } from "./export-json.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,11 @@
+// @metaobjectsdev/metadata/core — server-side capabilities.
+//
+// This entry point holds everything that touches node:fs or the `yaml`
+// dependency: the file loaders, the YAML authoring parser, and the
+// load-and-export convenience. The root `@metaobjectsdev/metadata` entry is
+// browser-safe and imports none of this. See the package README.
+export { FileSource } from "./file-source.js";
+export { FileMetaDataLoader } from "./file-meta-data-loader.js";
+export { parseYaml } from "./parser-yaml.js";
+export { loadAndExportJson } from "./export-json.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,uEAAuE;AACvE,mEAAmE;AACnE,4EAA4E;AAC5E,iEAAiE;AAEjE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/core/object/meta-object.d.ts

@@ -0,0 +1,39 @@
+import { MetaData } from "../../shared/meta-data.js";
+import type { MetaField } from "../field/meta-field.js";
+import type { MetaIdentity, MetaReferenceIdentity } from "../identity/meta-identity.js";
+import type { MetaLayout } from "../../presentation/layout/meta-layout.js";
+import type { MetaRelationship } from "../relationship/meta-relationship.js";
+import type { MetaValidator } from "../validator/meta-validator.js";
+export declare class MetaObject extends MetaData {
+    get dbTable(): string | undefined;
+    isEntity(): boolean;
+    isValue(): boolean;
+    /** All effective fields (own + inherited via extends). */
+    fields(): MetaField[];
+    /** Own fields only — excludes fields inherited via extends. Java parity: getMetaFields(false). */
+    ownFields(): MetaField[];
+    /** All effective identities (own + inherited via extends). */
+    identities(): MetaIdentity[];
+    /** Own identities only — excludes inherited. */
+    ownIdentities(): MetaIdentity[];
+    /** Returns the single primary identity, if any. */
+    primaryIdentity(): MetaIdentity | undefined;
+    /** Secondary identities. */
+    secondaryIdentities(): MetaIdentity[];
+    /** Reference identities — fields on this entity that identify another entity. */
+    referenceIdentities(): MetaReferenceIdentity[];
+    /** All effective relationships (own + inherited via extends). */
+    relationships(): MetaRelationship[];
+    /** Own relationships only — excludes inherited. */
+    ownRelationships(): MetaRelationship[];
+    /** All effective validators (own + inherited via extends). */
+    validators(): MetaValidator[];
+    /** Own validators only — excludes validators inherited via extends. Java parity: getChildren(Class, false). */
+    ownValidators(): MetaValidator[];
+    /** All effective layouts (own + inherited via extends). */
+    layouts(): MetaLayout[];
+    /** Own layouts only — excludes inherited. */
+    ownLayouts(): MetaLayout[];
+    findField(name: string): MetaField | undefined;
+}
+//# sourceMappingURL=meta-object.d.ts.map

package/dist/core/object/meta-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-object.d.ts","sourceRoot":"","sources":["../../../src/core/object/meta-object.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAsBrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,qBAAa,UAAW,SAAQ,QAAQ;IACtC,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAQhC;IAED,QAAQ,IAAI,OAAO;IAInB,OAAO,IAAI,OAAO;IAIlB,0DAA0D;IAC1D,MAAM,IAAI,SAAS,EAAE;IAMrB,kGAAkG;IAClG,SAAS,IAAI,SAAS,EAAE;IAMxB,8DAA8D;IAC9D,UAAU,IAAI,YAAY,EAAE;IAM5B,gDAAgD;IAChD,aAAa,IAAI,YAAY,EAAE;IAM/B,mDAAmD;IACnD,eAAe,IAAI,YAAY,GAAG,SAAS;IAM3C,4BAA4B;IAC5B,mBAAmB,IAAI,YAAY,EAAE;IAMrC,iFAAiF;IACjF,mBAAmB,IAAI,qBAAqB,EAAE;IAQ9C,iEAAiE;IACjE,aAAa,IAAI,gBAAgB,EAAE;IAMnC,mDAAmD;IACnD,gBAAgB,IAAI,gBAAgB,EAAE;IAMtC,8DAA8D;IAC9D,UAAU,IAAI,aAAa,EAAE;IAM7B,+GAA+G;IAC/G,aAAa,IAAI,aAAa,EAAE;IAMhC,2DAA2D;IAC3D,OAAO,IAAI,UAAU,EAAE;IAMvB,6CAA6C;IAC7C,UAAU,IAAI,UAAU,EAAE;IAM1B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;CAK/C"}

package/dist/core/object/meta-object.js

@@ -0,0 +1,80 @@
+// MetaObject — concrete node class for type=object nodes.
+//
+// Extends MetaData directly: no model wrapper, no metaOf() indirection.
+// Children are already concrete typed nodes; accessors filter by type constant.
+import { MetaData } from "../../shared/meta-data.js";
+import { TYPE_FIELD, TYPE_IDENTITY, TYPE_RELATIONSHIP, TYPE_VALIDATOR, TYPE_SOURCE, TYPE_LAYOUT, } from "../../shared/base-types.js";
+import { SOURCE_SUBTYPE_DB_TABLE, SOURCE_DB_TABLE_ATTR_NAME, } from "../../persistence/source/source-constants.js";
+import { OBJECT_SUBTYPE_ENTITY, OBJECT_SUBTYPE_VALUE, } from "./object-constants.js";
+import { IDENTITY_SUBTYPE_PRIMARY, IDENTITY_SUBTYPE_SECONDARY, IDENTITY_SUBTYPE_REFERENCE, } from "../identity/identity-constants.js";
+export class MetaObject extends MetaData {
+    get dbTable() {
+        return this.cached("dbTable", () => {
+            const source = this.children().find((c) => c.type === TYPE_SOURCE && c.subType === SOURCE_SUBTYPE_DB_TABLE);
+            const name = source?.ownAttr(SOURCE_DB_TABLE_ATTR_NAME);
+            return typeof name === "string" && name !== "" ? name : undefined;
+        });
+    }
+    isEntity() {
+        return this.subType === OBJECT_SUBTYPE_ENTITY;
+    }
+    isValue() {
+        return this.subType === OBJECT_SUBTYPE_VALUE;
+    }
+    /** All effective fields (own + inherited via extends). */
+    fields() {
+        return this.cached("fields", () => this.children().filter((c) => c.type === TYPE_FIELD));
+    }
+    /** Own fields only — excludes fields inherited via extends. Java parity: getMetaFields(false). */
+    ownFields() {
+        return this.cached("ownFields", () => this.ownChildren().filter((c) => c.type === TYPE_FIELD));
+    }
+    /** All effective identities (own + inherited via extends). */
+    identities() {
+        return this.cached("identities", () => this.children().filter((c) => c.type === TYPE_IDENTITY));
+    }
+    /** Own identities only — excludes inherited. */
+    ownIdentities() {
+        return this.cached("ownIdentities", () => this.ownChildren().filter((c) => c.type === TYPE_IDENTITY));
+    }
+    /** Returns the single primary identity, if any. */
+    primaryIdentity() {
+        return this.cached("primaryIdentity", () => this.identities().find((i) => i.subType === IDENTITY_SUBTYPE_PRIMARY));
+    }
+    /** Secondary identities. */
+    secondaryIdentities() {
+        return this.cached("secondaryIdentities", () => this.identities().filter((i) => i.subType === IDENTITY_SUBTYPE_SECONDARY));
+    }
+    /** Reference identities — fields on this entity that identify another entity. */
+    referenceIdentities() {
+        return this.cached("referenceIdentities", () => this.identities().filter((i) => i.subType === IDENTITY_SUBTYPE_REFERENCE));
+    }
+    /** All effective relationships (own + inherited via extends). */
+    relationships() {
+        return this.cached("relationships", () => this.children().filter((c) => c.type === TYPE_RELATIONSHIP));
+    }
+    /** Own relationships only — excludes inherited. */
+    ownRelationships() {
+        return this.cached("ownRelationships", () => this.ownChildren().filter((c) => c.type === TYPE_RELATIONSHIP));
+    }
+    /** All effective validators (own + inherited via extends). */
+    validators() {
+        return this.cached("validators", () => this.children().filter((c) => c.type === TYPE_VALIDATOR));
+    }
+    /** Own validators only — excludes validators inherited via extends. Java parity: getChildren(Class, false). */
+    ownValidators() {
+        return this.cached("ownValidators", () => this.ownChildren().filter((c) => c.type === TYPE_VALIDATOR));
+    }
+    /** All effective layouts (own + inherited via extends). */
+    layouts() {
+        return this.cached("layouts", () => this.children().filter((c) => c.type === TYPE_LAYOUT));
+    }
+    /** Own layouts only — excludes inherited. */
+    ownLayouts() {
+        return this.cached("ownLayouts", () => this.ownChildren().filter((c) => c.type === TYPE_LAYOUT));
+    }
+    findField(name) {
+        return this.cached(`findField:${name}`, () => this.fields().find((f) => f.name === name));
+    }
+}
+//# sourceMappingURL=meta-object.js.map

package/dist/core/object/meta-object.js.map

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

package/dist/core/object/object-constants.d.ts

@@ -0,0 +1,5 @@
+export declare const OBJECT_SUBTYPE_ENTITY = "entity";
+export declare const OBJECT_SUBTYPE_VALUE = "value";
+export declare const OBJECT_SUBTYPES: readonly ["base", "entity", "value"];
+export type ObjectSubType = (typeof OBJECT_SUBTYPES)[number];
+//# sourceMappingURL=object-constants.d.ts.map

package/dist/core/object/object-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-constants.d.ts","sourceRoot":"","sources":["../../../src/core/object/object-constants.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,qBAAqB,WAAW,CAAC;AAC9C,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAE5C,eAAO,MAAM,eAAe,sCAIlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/core/object/object-constants.js

@@ -0,0 +1,18 @@
+// Object concern constants — subtypes for the object.* type family.
+import { SUBTYPE_BASE } from "../../shared/base-types.js";
+// ---------------------------------------------------------------------------
+// Object subtypes (cross-language, conceptual)
+// ---------------------------------------------------------------------------
+//
+//   - base   : abstract template (no runtime semantics)
+//   - entity : persistent record (typically has @primary identity)
+//   - value  : value-object (no identity; equality by content)
+//
+export const OBJECT_SUBTYPE_ENTITY = "entity";
+export const OBJECT_SUBTYPE_VALUE = "value";
+export const OBJECT_SUBTYPES = [
+    SUBTYPE_BASE,
+    OBJECT_SUBTYPE_ENTITY,
+    OBJECT_SUBTYPE_VALUE,
+];
+//# sourceMappingURL=object-constants.js.map

package/dist/core/object/object-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-constants.js","sourceRoot":"","sources":["../../../src/core/object/object-constants.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAC9E,EAAE;AACF,wDAAwD;AACxD,mEAAmE;AACnE,+DAA+D;AAC/D,EAAE;AACF,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAC;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAE5C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY;IACZ,qBAAqB;IACrB,oBAAoB;CACZ,CAAC"}

package/dist/core/object/object-schema.d.ts

@@ -0,0 +1,4 @@
+import type { AttrSchema } from "../../registry.js";
+/** Attrs common to every object subtype. */
+export declare const objectAttrs: AttrSchema[];
+//# sourceMappingURL=object-schema.d.ts.map

package/dist/core/object/object-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-schema.d.ts","sourceRoot":"","sources":["../../../src/core/object/object-schema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,4CAA4C;AAC5C,eAAO,MAAM,WAAW,EAAE,UAAU,EAAO,CAAC"}

package/dist/core/object/object-schema.js

@@ -0,0 +1,5 @@
+// Object attribute schemas — attrs common to every object subtype.
+// Consumed by registerCoreTypes().
+/** Attrs common to every object subtype. */
+export const objectAttrs = [];
+//# sourceMappingURL=object-schema.js.map

package/dist/core/object/object-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-schema.js","sourceRoot":"","sources":["../../../src/core/object/object-schema.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,mCAAmC;AAInC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAiB,EAAE,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ParseOptions, ParseResult } from "../parser-core.js";
+export declare function parseYaml(content: string, opts: ParseOptions): ParseResult;
+//# sourceMappingURL=parser-yaml.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser-yaml.d.ts","sourceRoot":"","sources":["../../src/core/parser-yaml.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGnE,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,WAAW,CAwC1E"}

package/dist/core/parser-yaml.js

@@ -0,0 +1,39 @@
+// Authoring YAML parser.
+//
+// parseYaml is a front-end: yaml.parse → desugar → the shared buildTree
+// (parser-core.ts). The desugar applies the four authoring-sugar rules so the
+// resulting typed tree is identical to the one the equivalent canonical JSON
+// produces.
+import { parse as parseYamlText } from "yaml";
+import { ParseError } from "../errors.js";
+import { buildTree, errOpts } from "../parser-core.js";
+import { desugar } from "./yaml-desugar.js";
+export function parseYaml(content, opts) {
+    // Strip UTF-8 BOM if present (consistent with parseJson).
+    const normalizedContent = content.charCodeAt(0) === 0xfeff ? content.slice(1) : content;
+    // YAML syntax errors throw — consistent with parseJson on invalid JSON.
+    // The loader's per-source try/catch collects the throw into LoadResult.errors.
+    let parsed;
+    try {
+        parsed = parseYamlText(normalizedContent);
+    }
+    catch (err) {
+        throw new ParseError(`Invalid YAML: ${err.message}`, { ...errOpts(opts.sourceName), code: "ERR_MALFORMED_YAML" });
+    }
+    // Desugar the sugared authoring object into the canonical structure.
+    const { canonical, errors: desugarErrors } = desugar(parsed, opts.registry);
+    // If the desugar could not produce a usable document at all, surface the
+    // first desugar error as a throw — parallels parseJson's top-level throws.
+    if (Object.keys(canonical).length === 0) {
+        throw new ParseError(desugarErrors[0], { ...errOpts(opts.sourceName), code: "ERR_MALFORMED_YAML" });
+    }
+    const result = buildTree(canonical, opts);
+    // Merge collected desugar errors ahead of buildTree's own collected errors.
+    const desugarParseErrors = desugarErrors.map((msg) => new ParseError(msg, { ...errOpts(opts.sourceName), code: "ERR_MALFORMED_YAML" }));
+    return {
+        root: result.root,
+        warnings: result.warnings,
+        errors: [...desugarParseErrors, ...result.errors],
+    };
+}
+//# sourceMappingURL=parser-yaml.js.map

package/dist/core/parser-yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-yaml.js","sourceRoot":"","sources":["../../src/core/parser-yaml.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,EAAE;AACF,wEAAwE;AACxE,8EAA8E;AAC9E,6EAA6E;AAC7E,YAAY;AAEZ,OAAO,EAAE,KAAK,IAAI,aAAa,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,IAAkB;IAC3D,0DAA0D;IAC1D,MAAM,iBAAiB,GACrB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAEhE,wEAAwE;IACxE,+EAA+E;IAC/E,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAClB,iBAAkB,GAAa,CAAC,OAAO,EAAE,EACzC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAC5D,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE5E,yEAAyE;IACzE,2EAA2E;IAC3E,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,UAAU,CAClB,aAAa,CAAC,CAAC,CAAE,EACjB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAC5D,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAE1C,4EAA4E;IAC5E,MAAM,kBAAkB,GAAG,aAAa,CAAC,GAAG,CAC1C,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAC1F,CAAC;IACF,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,CAAC,GAAG,kBAAkB,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC;KAClD,CAAC;AACJ,CAAC"}

package/dist/core/query/query-constants.d.ts

@@ -0,0 +1,20 @@
+export declare const FILTER_OP_EQ = "eq";
+export declare const FILTER_OP_NE = "ne";
+export declare const FILTER_OP_GT = "gt";
+export declare const FILTER_OP_GTE = "gte";
+export declare const FILTER_OP_LT = "lt";
+export declare const FILTER_OP_LTE = "lte";
+export declare const FILTER_OP_IN = "in";
+export declare const FILTER_OP_LIKE = "like";
+export declare const FILTER_OP_IS_NULL = "isNull";
+export declare const FILTER_COMPOSE_OR = "or";
+export declare const FILTER_COMPOSE_AND = "and";
+export declare const FILTER_OPS: readonly ["eq", "ne", "gt", "gte", "lt", "lte", "in", "like", "isNull"];
+export type FilterOp = (typeof FILTER_OPS)[number];
+export declare const OPS_BY_SUBTYPE: Readonly<Record<string, readonly FilterOp[]>>;
+export declare function opsForSubType(subType: string): readonly FilterOp[];
+export declare const SORT_ORDER_ASC = "asc";
+export declare const SORT_ORDER_DESC = "desc";
+export declare const SORT_ORDER_VALUES: readonly ["asc", "desc"];
+export type SortOrderValue = (typeof SORT_ORDER_VALUES)[number];
+//# sourceMappingURL=query-constants.d.ts.map

package/dist/core/query/query-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-constants.d.ts","sourceRoot":"","sources":["../../../src/core/query/query-constants.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,YAAY,OAAY,CAAC;AACtC,eAAO,MAAM,YAAY,OAAY,CAAC;AACtC,eAAO,MAAM,YAAY,OAAY,CAAC;AACtC,eAAO,MAAM,aAAa,QAAY,CAAC;AACvC,eAAO,MAAM,YAAY,OAAY,CAAC;AACtC,eAAO,MAAM,aAAa,QAAY,CAAC;AACvC,eAAO,MAAM,YAAY,OAAY,CAAC;AACtC,eAAO,MAAM,cAAc,SAAY,CAAC;AACxC,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAG1C,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,eAAO,MAAM,UAAU,yEAGb,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC,CAa/D,CAAC;AAEX,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,QAAQ,EAAE,CAElE;AAOD,eAAO,MAAM,cAAc,QAAS,CAAC;AACrC,eAAO,MAAM,eAAe,SAAS,CAAC;AAEtC,eAAO,MAAM,iBAAiB,0BAA6C,CAAC;AAC5E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/core/query/query-constants.js

@@ -0,0 +1,56 @@
+// Query concern constants — filter operators, sort order values.
+//
+// NOTE: `query` is NOT a metamodel node type — it has no subtype, schema, or
+// accessor. It's a cross-cutting vocabulary grouping for query/filter helpers
+// consumed by both core/field (@filterable/@sortable) and presentation/layout
+// (dataGrid @defaultSortOrder). Co-located here as the most foundational shared
+// home; intentional, not an incomplete migration.
+// ---------------------------------------------------------------------------
+// Filter operators (Project D) — shared source of truth across server +
+// codegen. Each subtype declares which operators are legal for fields of that
+// type. Server allowlist generation + TS type generation + codegen-time grid
+// validation all import from here.
+// ---------------------------------------------------------------------------
+// Individual operator constants — used by the parse-time desugar in
+// parser-core.ts. Must stay in sync with FILTER_OPS below.
+export const FILTER_OP_EQ = "eq";
+export const FILTER_OP_NE = "ne";
+export const FILTER_OP_GT = "gt";
+export const FILTER_OP_GTE = "gte";
+export const FILTER_OP_LT = "lt";
+export const FILTER_OP_LTE = "lte";
+export const FILTER_OP_IN = "in";
+export const FILTER_OP_LIKE = "like";
+export const FILTER_OP_IS_NULL = "isNull";
+// Composition-key constants — used by desugarFilterObject in meta-attr-filter.ts.
+export const FILTER_COMPOSE_OR = "or";
+export const FILTER_COMPOSE_AND = "and";
+export const FILTER_OPS = [
+    FILTER_OP_EQ, FILTER_OP_NE, FILTER_OP_GT, FILTER_OP_GTE, FILTER_OP_LT, FILTER_OP_LTE,
+    FILTER_OP_IN, FILTER_OP_LIKE, FILTER_OP_IS_NULL,
+];
+export const OPS_BY_SUBTYPE = {
+    string: [FILTER_OP_EQ, FILTER_OP_NE, FILTER_OP_IN, FILTER_OP_LIKE, FILTER_OP_IS_NULL],
+    int: [FILTER_OP_EQ, FILTER_OP_NE, FILTER_OP_GT, FILTER_OP_GTE, FILTER_OP_LT, FILTER_OP_LTE, FILTER_OP_IN, FILTER_OP_IS_NULL],
+    short: [FILTER_OP_EQ, FILTER_OP_NE, FILTER_OP_GT, FILTER_OP_GTE, FILTER_OP_LT, FILTER_OP_LTE, FILTER_OP_IN, FILTER_OP_IS_NULL],
+    byte: [FILTER_OP_EQ, FILTER_OP_NE, FILTER_OP_GT, FILTER_OP_GTE, FILTER_OP_LT, FILTER_OP_LTE, FILTER_OP_IN, FILTER_OP_IS_NULL],
+    long: [FILTER_OP_EQ, FILTER_OP_NE, FILTER_OP_GT, FILTER_OP_GTE, FILTER_OP_LT, FILTER_OP_LTE, FILTER_OP_IN, FILTER_OP_IS_NULL],
+    double: [FILTER_OP_EQ, FILTER_OP_NE, FILTER_OP_GT, FILTER_OP_GTE, FILTER_OP_LT, FILTER_OP_LTE, FILTER_OP_IN, FILTER_OP_IS_NULL],
+    float: [FILTER_OP_EQ, FILTER_OP_NE, FILTER_OP_GT, FILTER_OP_GTE, FILTER_OP_LT, FILTER_OP_LTE, FILTER_OP_IN, FILTER_OP_IS_NULL],
+    decimal: [FILTER_OP_EQ, FILTER_OP_NE, FILTER_OP_GT, FILTER_OP_GTE, FILTER_OP_LT, FILTER_OP_LTE, FILTER_OP_IN, FILTER_OP_IS_NULL],
+    boolean: [FILTER_OP_EQ, FILTER_OP_IS_NULL],
+    date: [FILTER_OP_EQ, FILTER_OP_NE, FILTER_OP_GT, FILTER_OP_GTE, FILTER_OP_LT, FILTER_OP_LTE, FILTER_OP_IN, FILTER_OP_IS_NULL],
+    time: [FILTER_OP_EQ, FILTER_OP_NE, FILTER_OP_GT, FILTER_OP_GTE, FILTER_OP_LT, FILTER_OP_LTE, FILTER_OP_IN, FILTER_OP_IS_NULL],
+    timestamp: [FILTER_OP_EQ, FILTER_OP_NE, FILTER_OP_GT, FILTER_OP_GTE, FILTER_OP_LT, FILTER_OP_LTE, FILTER_OP_IN, FILTER_OP_IS_NULL],
+};
+export function opsForSubType(subType) {
+    return OPS_BY_SUBTYPE[subType] ?? [];
+}
+// ---------------------------------------------------------------------------
+// Sort order values (used by @sortableDefaultOrder on fields and
+// @defaultSortOrder on dataGrid layouts)
+// ---------------------------------------------------------------------------
+export const SORT_ORDER_ASC = "asc";
+export const SORT_ORDER_DESC = "desc";
+export const SORT_ORDER_VALUES = [SORT_ORDER_ASC, SORT_ORDER_DESC];
+//# sourceMappingURL=query-constants.js.map

package/dist/core/query/query-constants.js.map

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

package/dist/core/relationship/find-reference.d.ts

@@ -0,0 +1,22 @@
+import type { MetaObject } from "../object/meta-object.js";
+import type { MetaReferenceIdentity } from "../identity/meta-identity.js";
+export interface ReferenceLookup {
+    /** The entity whose identity.reference points at `other`. */
+    readonly holder: MetaObject;
+    /** The other side of the reference. */
+    readonly other: MetaObject;
+    /** The matching identity.reference declaration on `holder`. */
+    readonly referenceIdentity: MetaReferenceIdentity;
+}
+/**
+ * Find an identity.reference on either `a` or `b` whose @references targets the
+ * other side. Returns undefined if neither side declares one.
+ *
+ * Comparison is package-insensitive: `@references` may be a bare entity name
+ * ("User") or a fully-qualified one ("pkg::User"); both match `other.name`.
+ *
+ * If both sides declare references targeting each other (rare, but legal for
+ * mutual 1:1), returns the first found, walking `a` first.
+ */
+export declare function findReferenceBetween(a: MetaObject, b: MetaObject): ReferenceLookup | undefined;
+//# sourceMappingURL=find-reference.d.ts.map

package/dist/core/relationship/find-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-reference.d.ts","sourceRoot":"","sources":["../../../src/core/relationship/find-reference.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAG1E,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,iBAAiB,EAAE,qBAAqB,CAAC;CACnD;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,UAAU,EACb,CAAC,EAAE,UAAU,GACZ,eAAe,GAAG,SAAS,CAS7B"}

package/dist/core/relationship/find-reference.js

@@ -0,0 +1,29 @@
+// Cross-entity reference lookup — anchored to identity.reference declarations.
+//
+// Given a relationship-style query "is there a reference between A and B?",
+// walk A's and B's identity.reference children to find the side that physically
+// holds the reference. This is the single source of truth for FK direction
+// across projection codegen, Drizzle schema emit, relations() blocks, and
+// migration schema comparison.
+import { stripPackage } from "../../naming.js";
+/**
+ * Find an identity.reference on either `a` or `b` whose @references targets the
+ * other side. Returns undefined if neither side declares one.
+ *
+ * Comparison is package-insensitive: `@references` may be a bare entity name
+ * ("User") or a fully-qualified one ("pkg::User"); both match `other.name`.
+ *
+ * If both sides declare references targeting each other (rare, but legal for
+ * mutual 1:1), returns the first found, walking `a` first.
+ */
+export function findReferenceBetween(a, b) {
+    for (const [holder, other] of [[a, b], [b, a]]) {
+        for (const ref of holder.referenceIdentities()) {
+            if (stripPackage(ref.targetEntity) === other.name) {
+                return { holder, other, referenceIdentity: ref };
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=find-reference.js.map

package/dist/core/relationship/find-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-reference.js","sourceRoot":"","sources":["../../../src/core/relationship/find-reference.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,2EAA2E;AAC3E,0EAA0E;AAC1E,+BAA+B;AAI/B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAW/C;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,CAAa,EACb,CAAa;IAEb,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAU,EAAE,CAAC;QACxD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAC/C,IAAI,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;gBAClD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/relationship/meta-relationship.d.ts

@@ -0,0 +1,11 @@
+import { MetaData } from "../../shared/meta-data.js";
+export declare class MetaRelationship extends MetaData {
+    get cardinality(): string | undefined;
+    /** FQN of the target object (e.g., "acme::vehicle::Car"). */
+    get objectRef(): string | undefined;
+    /** Join-table entity name for N:M relationships. */
+    get joinEntity(): string | undefined;
+    /** Join-table column names for N:M relationships. */
+    get joinFields(): string[];
+}
+//# sourceMappingURL=meta-relationship.d.ts.map

package/dist/core/relationship/meta-relationship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-relationship.d.ts","sourceRoot":"","sources":["../../../src/core/relationship/meta-relationship.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAQrD,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAGpC;IAED,6DAA6D;IAC7D,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAGlC;IAED,oDAAoD;IACpD,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAGnC;IAED,qDAAqD;IACrD,IAAI,UAAU,IAAI,MAAM,EAAE,CAGzB;CACF"}

package/dist/core/relationship/meta-relationship.js

@@ -0,0 +1,27 @@
+// MetaRelationship — concrete node class for type=relationship nodes.
+//
+// Extends MetaData directly: no model wrapper, no metaOf() indirection.
+import { MetaData } from "../../shared/meta-data.js";
+import { RELATIONSHIP_ATTR_CARDINALITY, RELATIONSHIP_ATTR_OBJECT_REF, RELATIONSHIP_ATTR_JOIN_ENTITY, RELATIONSHIP_ATTR_JOIN_FIELDS, } from "./relationship-constants.js";
+export class MetaRelationship extends MetaData {
+    get cardinality() {
+        const v = this.ownAttr(RELATIONSHIP_ATTR_CARDINALITY);
+        return typeof v === "string" ? v : undefined;
+    }
+    /** FQN of the target object (e.g., "acme::vehicle::Car"). */
+    get objectRef() {
+        const v = this.ownAttr(RELATIONSHIP_ATTR_OBJECT_REF);
+        return typeof v === "string" ? v : undefined;
+    }
+    /** Join-table entity name for N:M relationships. */
+    get joinEntity() {
+        const v = this.ownAttr(RELATIONSHIP_ATTR_JOIN_ENTITY);
+        return typeof v === "string" ? v : undefined;
+    }
+    /** Join-table column names for N:M relationships. */
+    get joinFields() {
+        const f = this.ownAttr(RELATIONSHIP_ATTR_JOIN_FIELDS);
+        return Array.isArray(f) ? f : [];
+    }
+}
+//# sourceMappingURL=meta-relationship.js.map

package/dist/core/relationship/meta-relationship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-relationship.js","sourceRoot":"","sources":["../../../src/core/relationship/meta-relationship.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,wEAAwE;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC;AAErC,MAAM,OAAO,gBAAiB,SAAQ,QAAQ;IAC5C,IAAI,WAAW;QACb,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACtD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,6DAA6D;IAC7D,IAAI,SAAS;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,oDAAoD;IACpD,IAAI,UAAU;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACtD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,qDAAqD;IACrD,IAAI,UAAU;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACtD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,CAAC;CACF"}