@metaobjectsdev/metadata 0.5.0-rc.1

package/dist/loader/meta-data-loader.js

@@ -0,0 +1,232 @@
+// MetaDataLoader — loader with full load pipeline.
+//
+// Owns the load pipeline contract, lifecycle state, and accessor members.
+// The load() method sequences MetaDataSource reads into one accumulating tree,
+// using the parser's `intoRoot` param for merge-during-parse.
+//
+// Java MetaDataLoader lifecycle phases: UNINITIALIZED → LOADING → LOADED → ERROR.
+// Reads call _checkStateForRead() to enforce "loaded before read."
+import { MetaRoot } from "../shared/meta-root.js";
+import { TypeId, TypeRegistry } from "../registry.js";
+import { coreProviders } from "../core-types.js";
+import { composeRegistry } from "../provider.js";
+import { TYPE_METADATA, SUBTYPE_ROOT } from "../shared/base-types.js";
+import { ParseError } from "../errors.js";
+import { parseJson } from "../parser-json.js";
+import { validateDataGridSortFields, validateFilterableHasIndex, validateOriginPaths, validateDataGridFilterValues } from "./validation-passes.js";
+import { resolveDeferredSupers } from "../super-resolve.js";
+import { validateSubtypeRules } from "../subtype-rules.js";
+import { validateAttrSchema } from "../attr-schema-validate.js";
+// ---------------------------------------------------------------------------
+// Synthetic empty root (used when all sources fail to parse)
+// ---------------------------------------------------------------------------
+function makeSyntheticRoot() {
+    return new MetaRoot(new TypeId(TYPE_METADATA, SUBTYPE_ROOT), "");
+}
+// ---------------------------------------------------------------------------
+// MetaDataLoader class
+// ---------------------------------------------------------------------------
+export class MetaDataLoader {
+    _registry;
+    _freeze;
+    _strict;
+    _state = "uninitialized";
+    _root;
+    constructor(opts) {
+        this._registry = opts?.registry ?? MetaDataLoader._defaultRegistry();
+        this._freeze = opts?.freeze !== false; // default true
+        this._strict = opts?.strict === true; // default false
+    }
+    static _defaultRegistry() {
+        return composeRegistry(coreProviders);
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle
+    // ---------------------------------------------------------------------------
+    /** Current loading state. */
+    get state() {
+        return this._state;
+    }
+    /**
+     * 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() {
+        return this._registry;
+    }
+    /**
+     * 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() {
+        this._checkStateForRead();
+        return this._root;
+    }
+    /**
+     * 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.
+     */
+    _checkStateForRead() {
+        if (this._state === "uninitialized" || this._state === "loading") {
+            throw new Error(`MetaDataLoader.root accessed before loading has completed (state: "${this._state}"). ` +
+                `Call load() first.`);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Convenience accessors (mirror Java's MetaDataLoader getChildOfType etc.)
+    // ---------------------------------------------------------------------------
+    /**
+     * Returns the first child of the root with the given name, or undefined.
+     * Throws if not yet loaded.
+     */
+    findByName(name) {
+        this._checkStateForRead();
+        return this._root.ownChildByName(name);
+    }
+    /**
+     * Returns the first child of the root with the given (type, name), or undefined.
+     * Throws if not yet loaded.
+     */
+    findByTypeAndName(type, name) {
+        this._checkStateForRead();
+        return this._root.ownChildByTypeAndName(type, name);
+    }
+    /**
+     * Returns all direct children of the root with the given type.
+     * Throws if not yet loaded.
+     */
+    childrenOfType(type) {
+        this._checkStateForRead();
+        return this._root.ownChildrenOfType(type);
+    }
+    // ---------------------------------------------------------------------------
+    // parseSource — overridable format dispatch seam
+    // ---------------------------------------------------------------------------
+    /**
+     * 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.
+     */
+    parseSource(content, source, parseOpts) {
+        if (source.format === "json") {
+            return parseJson(content, parseOpts);
+        }
+        throw new Error(`MetaDataLoader parses JSON only; format "${source.format}" for source ` +
+            `"${source.id}" requires FileMetaDataLoader (from @metaobjectsdev/metadata/core)`);
+    }
+    // ---------------------------------------------------------------------------
+    // load — async pipeline over MetaDataSource[]
+    // ---------------------------------------------------------------------------
+    /**
+     * 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.
+     */
+    async load(sources) {
+        // Disallow re-use after a completed load (matches Java MetaDataLoader's
+        // INITIALIZED-once contract). Loader is a one-shot pipeline.
+        if (this._state === "loaded" || this._state === "error") {
+            throw new Error("MetaDataLoader cannot be reused after load completes. Construct a new MetaDataLoader for additional loads.");
+        }
+        this._state = "loading";
+        const warnings = [];
+        const errors = [];
+        let root;
+        // Parse all sources with super resolution DEFERRED so cross-file super
+        // refs work — one source may declare a super target that's defined in a
+        // source parsed later. A second pass (resolveDeferredSupers) resolves
+        // everything against the fully-merged root.
+        for (const source of sources) {
+            let content;
+            try {
+                content = await source.read();
+            }
+            catch (err) {
+                errors.push(err instanceof Error
+                    ? err
+                    : new Error(`Failed to read source "${source.id}": ${String(err)}`));
+                continue;
+            }
+            // Build parser options, honoring exactOptionalPropertyTypes — only include
+            // sourceName / intoRoot keys when defined.
+            const parseOpts = {
+                registry: this._registry,
+                strict: this._strict,
+                deferSuperResolution: true,
+                sourceName: source.id,
+            };
+            if (root !== undefined)
+                parseOpts.intoRoot = root;
+            try {
+                const parseResult = this.parseSource(content, source, parseOpts);
+                warnings.push(...parseResult.warnings);
+                errors.push(...parseResult.errors);
+                root = parseResult.root;
+            }
+            catch (err) {
+                errors.push(err instanceof Error
+                    ? err
+                    : new Error(`Parse error in "${source.id}": ${String(err)}`));
+            }
+        }
+        // Second pass: resolve every deferred super ref against the full tree.
+        // Unresolved refs are always errors (matches the original eager-throw
+        // behavior — broken metadata is broken regardless of strict mode).
+        if (root !== undefined) {
+            const failures = resolveDeferredSupers(root);
+            for (const failure of failures) {
+                errors.push(new ParseError(`the SuperClass '${failure.ref}' does not exist (referenced by ${failure.nodeFqn})`, { code: "ERR_UNRESOLVED_SUPER" }));
+            }
+            // Third pass: subtype rule validation (entity should have primary identity,
+            // value must not have one).
+            const ruleResult = validateSubtypeRules(root);
+            errors.push(...ruleResult.errors);
+            warnings.push(...ruleResult.warnings);
+            // Fourth pass: data-grid @defaultSortField cross-reference validation.
+            errors.push(...validateDataGridSortFields(root));
+            // Fifth pass: @filterable without index drift warning.
+            warnings.push(...validateFilterableHasIndex(root));
+            // Sixth pass: origin path validation — validates passthrough.@from,
+            // aggregate.@of, and .@via relationship chains.
+            errors.push(...validateOriginPaths(root));
+            // Seventh pass: @filter value validation — fields filterable + ops allowed per subtype.
+            errors.push(...validateDataGridFilterValues(root));
+            // Eighth pass: attribute-schema validation (Phase A3) — checks each
+            // node's @-attributes against its (type, subType) AttrSchema: required
+            // attrs present, declared attrs well-typed, allowedValues honored.
+            const attrSchemaResult = validateAttrSchema(root, this._registry);
+            errors.push(...attrSchemaResult.errors);
+            warnings.push(...attrSchemaResult.warnings);
+        }
+        // If nothing parsed successfully, synthesize an empty root so callers
+        // always get a valid MetaData. The state captures whether errors occurred.
+        if (root === undefined) {
+            root = makeSyntheticRoot();
+            this._state = errors.length > 0 ? "error" : "loaded";
+        }
+        else {
+            this._state = "loaded";
+        }
+        // Freeze applies to BOTH paths — synthetic-root callers shouldn't get a
+        // mutable model just because their inputs failed.
+        if (this._freeze) {
+            root.freeze();
+        }
+        this._root = root;
+        return { root, warnings, errors };
+    }
+}
+//# sourceMappingURL=meta-data-loader.js.map

package/dist/loader/meta-data-loader.js.map

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

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

@@ -0,0 +1,23 @@
+/** Format of a source's content. Selects the parser. */
+export type MetaDataFormat = "json" | "yaml";
+/** One unit of raw metadata input. */
+export interface MetaDataSource {
+    /** Human-readable identifier — used in parse-error messages (e.g. a filename). */
+    readonly id: string;
+    /** Content format hint — selects the parser. */
+    readonly format: MetaDataFormat;
+    /** Resolve the raw content. May perform I/O. */
+    read(): Promise<string>;
+}
+/** A metadata source backed by an in-memory string. */
+export declare class InMemorySource implements MetaDataSource {
+    readonly id: string;
+    readonly format: MetaDataFormat;
+    private readonly _content;
+    constructor(content: string, opts?: {
+        id?: string;
+        format?: MetaDataFormat;
+    });
+    read(): Promise<string>;
+}
+//# sourceMappingURL=meta-data-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-data-source.d.ts","sourceRoot":"","sources":["../../src/loader/meta-data-source.ts"],"names":[],"mappings":"AAMA,wDAAwD;AACxD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;AAE7C,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,gDAAgD;IAChD,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,uDAAuD;AACvD,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,cAAc,CAAA;KAAE;IAM5E,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;CAGxB"}

package/dist/loader/meta-data-source.js

@@ -0,0 +1,20 @@
+// MetaDataSource — the raw-document unit consumed by the loader pipeline.
+//
+// A loader (FileMetaDataLoader, later UrlMetaDataLoader) discovers/acquires
+// sources; the MetaDataLoader pipeline calls read() on each. read() is async
+// so file/URL sources can do I/O; InMemorySource resolves immediately.
+/** A metadata source backed by an in-memory string. */
+export class InMemorySource {
+    id;
+    format;
+    _content;
+    constructor(content, opts) {
+        this._content = content;
+        this.id = opts?.id ?? "<in-memory>";
+        this.format = opts?.format ?? "json";
+    }
+    read() {
+        return Promise.resolve(this._content);
+    }
+}
+//# sourceMappingURL=meta-data-source.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-data-source.js","sourceRoot":"","sources":["../../src/loader/meta-data-source.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,uEAAuE;AAevE,uDAAuD;AACvD,MAAM,OAAO,cAAc;IAChB,EAAE,CAAS;IACX,MAAM,CAAiB;IACf,QAAQ,CAAS;IAElC,YAAY,OAAe,EAAE,IAA+C;QAC1E,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,aAAa,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,MAAM,CAAC;IACvC,CAAC;IAED,IAAI;QACF,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/loader/validation-passes.d.ts

@@ -0,0 +1,7 @@
+import type { MetaData } from "../shared/meta-data.js";
+import { ParseError } from "../errors.js";
+export declare function validateDataGridSortFields(root: MetaData): ParseError[];
+export declare function validateFilterableHasIndex(root: MetaData): string[];
+export declare function validateOriginPaths(root: MetaData): ParseError[];
+export declare function validateDataGridFilterValues(root: MetaData): ParseError[];
+//# sourceMappingURL=validation-passes.d.ts.map

package/dist/loader/validation-passes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-passes.d.ts","sourceRoot":"","sources":["../../src/loader/validation-passes.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAsC1C,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,EAAE,CAuBvE;AAMD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CA8BnE;AAsID,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,EAAE,CAiDhE;AAWD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,EAAE,CAoBzE"}

package/dist/loader/validation-passes.js

@@ -0,0 +1,244 @@
+// Stateless validation passes for the MetaDataLoader pipeline.
+//
+// Each function takes a fully-merged MetaData root and returns errors or
+// warnings. No loader state is read or written — these are pure functions.
+//
+// Exported: validateDataGridSortFields, validateFilterableHasIndex,
+//           validateOriginPaths  (called by MetaDataLoader.load() in order).
+// Private:  _findObject, _findField, _findRelationship,
+//           _validateFromPath, _validateViaPath  (helpers, not exported).
+import { ParseError } from "../errors.js";
+import { TYPE_OBJECT, TYPE_FIELD, TYPE_LAYOUT, TYPE_IDENTITY, TYPE_ORIGIN, TYPE_RELATIONSHIP, } from "../shared/base-types.js";
+import { LAYOUT_SUBTYPE_DATA_GRID, LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD, LAYOUT_DATA_GRID_ATTR_FILTER, } from "../presentation/layout/layout-constants.js";
+import { FIELD_ATTR_FILTERABLE, } from "../core/field/field-constants.js";
+import { FIELD_ATTR_DB_INDEXED } from "../persistence/db/db-constants.js";
+import { IDENTITY_ATTR_FIELDS } from "../core/identity/identity-constants.js";
+import { ORIGIN_SUBTYPE_PASSTHROUGH, ORIGIN_SUBTYPE_AGGREGATE, ORIGIN_PASSTHROUGH_ATTR_FROM, ORIGIN_PASSTHROUGH_ATTR_VIA, ORIGIN_AGGREGATE_ATTR_OF, ORIGIN_AGGREGATE_ATTR_VIA, } from "../persistence/origin/origin-constants.js";
+import { RELATIONSHIP_ATTR_OBJECT_REF } from "../core/relationship/relationship-constants.js";
+import { FILTER_COMPOSE_OR, FILTER_COMPOSE_AND, opsForSubType, } from "../core/query/query-constants.js";
+// ---------------------------------------------------------------------------
+// Layout dataGrid @defaultSortField validation
+// ---------------------------------------------------------------------------
+export function validateDataGridSortFields(root) {
+    const errors = [];
+    for (const obj of root.ownChildren().filter((c) => c.type === TYPE_OBJECT)) {
+        // Use children() so inherited fields (via extends:/super:) are
+        // visible when validating @defaultSortField references.
+        const effective = obj.children();
+        const fieldNames = new Set(effective.filter((c) => c.type === TYPE_FIELD).map((f) => f.name));
+        for (const layout of effective.filter((c) => c.type === TYPE_LAYOUT && c.subType === LAYOUT_SUBTYPE_DATA_GRID)) {
+            const sortField = layout.ownAttr(LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD);
+            if (typeof sortField === "string" && !fieldNames.has(sortField)) {
+                errors.push(new ParseError(`dataGrid layout "${layout.name}" on entity "${obj.name}" has @defaultSortField "${sortField}" ` +
+                    `but no such field exists on "${obj.name}". Available fields: ${[...fieldNames].join(", ")}`, { code: "ERR_BAD_DEFAULT_SORT_FIELD" }));
+            }
+        }
+    }
+    return errors;
+}
+// ---------------------------------------------------------------------------
+// @filterable without index validation
+// ---------------------------------------------------------------------------
+export function validateFilterableHasIndex(root) {
+    const warnings = [];
+    for (const obj of root.ownChildren().filter((c) => c.type === TYPE_OBJECT)) {
+        // Use children() so inherited fields and identities (via extends:/super:)
+        // are included when checking filterable-without-index.
+        const effective = obj.children();
+        // Build the set of field names that are part of any identity on this object.
+        const indexedFieldNames = new Set();
+        for (const identity of effective.filter((c) => c.type === TYPE_IDENTITY)) {
+            const fields = identity.ownAttr(IDENTITY_ATTR_FIELDS);
+            if (typeof fields === "string") {
+                for (const name of fields.split(","))
+                    indexedFieldNames.add(name.trim());
+            }
+            else if (Array.isArray(fields)) {
+                for (const name of fields)
+                    if (typeof name === "string")
+                        indexedFieldNames.add(name);
+            }
+        }
+        for (const field of effective.filter((c) => c.type === TYPE_FIELD)) {
+            const filterable = field.ownAttr(FIELD_ATTR_FILTERABLE);
+            if (filterable !== true)
+                continue;
+            if (field.ownAttr(FIELD_ATTR_DB_INDEXED) === true)
+                continue;
+            if (indexedFieldNames.has(field.name))
+                continue;
+            warnings.push(`[filterable-without-index] field "${obj.name}.${field.name}" has @filterable: true but is not ` +
+                `part of any identity. Filtering on this field will sequential-scan. Add @db.indexed: true ` +
+                `to the field (when supported), or remove @filterable: true.`);
+        }
+    }
+    return warnings;
+}
+// ---------------------------------------------------------------------------
+// Origin path validation
+//
+// Walks every projection's fields, finds `origin` (TYPE_ORIGIN) children,
+// and validates:
+//   - passthrough.@from resolves to an existing entity + field
+//   - aggregate.@of resolves to an existing entity + field
+//   - .@via paths resolve through real relationships, hopping entity-by-entity
+//     using each relationship's @objectRef
+//
+// Note: @agg vocabulary is validated by validateAttrSchema (A3 pass) via
+// allowedValues on the origin.aggregate @agg attr schema — not here.
+// ---------------------------------------------------------------------------
+function _findObject(root, name) {
+    return root.ownChildren().find((c) => c.type === TYPE_OBJECT && c.name === name);
+}
+function _findField(obj, name) {
+    // Use children() so inherited fields (via extends:/super:) are included.
+    return obj.children().find((c) => c.type === TYPE_FIELD && c.name === name);
+}
+function _findRelationship(obj, name) {
+    // Use children() so inherited relationships (via extends:/super:) are included.
+    return obj.children().find((c) => c.type === TYPE_RELATIONSHIP && c.name === name);
+}
+function _validateFromPath(fromAttr, root, projectionName, fieldName, errors, label = "origin.passthrough.@from") {
+    const dotIdx = fromAttr.indexOf(".");
+    if (dotIdx < 1 || dotIdx === fromAttr.length - 1) {
+        errors.push(new ParseError(`${label} "${fromAttr}" on ${projectionName}.${fieldName}: must be of form "Entity.field".`, { code: "ERR_INVALID_ORIGIN" }));
+        return;
+    }
+    const entityName = fromAttr.slice(0, dotIdx);
+    const targetFieldName = fromAttr.slice(dotIdx + 1);
+    const sourceObj = _findObject(root, entityName);
+    if (!sourceObj) {
+        errors.push(new ParseError(`${label} "${fromAttr}" on ${projectionName}.${fieldName}: no such entity "${entityName}".`, { code: "ERR_INVALID_ORIGIN" }));
+        return;
+    }
+    const sourceField = _findField(sourceObj, targetFieldName);
+    if (!sourceField) {
+        errors.push(new ParseError(`${label} "${fromAttr}" on ${projectionName}.${fieldName}: no such field "${targetFieldName}" on ${entityName}.`, { code: "ERR_INVALID_ORIGIN" }));
+    }
+}
+function _validateViaPath(viaAttr, root, projectionName, fieldName, errors) {
+    const segments = viaAttr.split(".");
+    if (segments.length < 2) {
+        errors.push(new ParseError(`origin.@via "${viaAttr}" on ${projectionName}.${fieldName}: must be of form "Entity.relationship[.relationship...]".`, { code: "ERR_INVALID_ORIGIN" }));
+        return;
+    }
+    const [entityName, ...relSegments] = segments;
+    let currentObj = _findObject(root, entityName);
+    if (!currentObj) {
+        errors.push(new ParseError(`origin.@via "${viaAttr}" on ${projectionName}.${fieldName}: no such entity "${entityName}".`, { code: "ERR_INVALID_ORIGIN" }));
+        return;
+    }
+    for (const relName of relSegments) {
+        const rel = _findRelationship(currentObj, relName);
+        if (!rel) {
+            errors.push(new ParseError(`origin.@via "${viaAttr}" on ${projectionName}.${fieldName}: no such relationship "${relName}" on ${currentObj.name}.`, { code: "ERR_INVALID_ORIGIN" }));
+            return;
+        }
+        const refTarget = rel.ownAttr(RELATIONSHIP_ATTR_OBJECT_REF);
+        if (typeof refTarget !== "string" || refTarget === "") {
+            errors.push(new ParseError(`origin.@via "${viaAttr}" on ${projectionName}.${fieldName}: relationship "${relName}" on ${currentObj.name} is missing @objectRef.`, { code: "ERR_INVALID_ORIGIN" }));
+            return;
+        }
+        const nextObj = _findObject(root, refTarget);
+        if (!nextObj) {
+            errors.push(new ParseError(`origin.@via "${viaAttr}" on ${projectionName}.${fieldName}: relationship "${relName}" points to non-existent entity "${refTarget}".`, { code: "ERR_INVALID_ORIGIN" }));
+            return;
+        }
+        currentObj = nextObj;
+    }
+}
+export function validateOriginPaths(root) {
+    const errors = [];
+    for (const obj of root.ownChildren().filter((c) => c.type === TYPE_OBJECT)) {
+        for (const field of obj.ownChildren().filter((c) => c.type === TYPE_FIELD)) {
+            for (const origin of field.ownChildren().filter((c) => c.type === TYPE_ORIGIN)) {
+                if (origin.subType === ORIGIN_SUBTYPE_PASSTHROUGH) {
+                    const from = origin.ownAttr(ORIGIN_PASSTHROUGH_ATTR_FROM);
+                    if (typeof from !== "string" || from === "") {
+                        errors.push(new ParseError(`origin.passthrough on ${obj.name}.${field.name}: missing @from.`, { code: "ERR_INVALID_ORIGIN" }));
+                        continue;
+                    }
+                    _validateFromPath(from, root, obj.name, field.name, errors);
+                    const via = origin.ownAttr(ORIGIN_PASSTHROUGH_ATTR_VIA);
+                    if (typeof via === "string" && via !== "") {
+                        _validateViaPath(via, root, obj.name, field.name, errors);
+                    }
+                }
+                else if (origin.subType === ORIGIN_SUBTYPE_AGGREGATE) {
+                    const of_ = origin.ownAttr(ORIGIN_AGGREGATE_ATTR_OF);
+                    if (typeof of_ !== "string" || of_ === "") {
+                        errors.push(new ParseError(`origin.aggregate on ${obj.name}.${field.name}: missing @of.`, { code: "ERR_INVALID_ORIGIN" }));
+                        continue;
+                    }
+                    _validateFromPath(of_, root, obj.name, field.name, errors, "origin.aggregate.@of");
+                    const via = origin.ownAttr(ORIGIN_AGGREGATE_ATTR_VIA);
+                    if (typeof via !== "string" || via === "") {
+                        errors.push(new ParseError(`origin.aggregate on ${obj.name}.${field.name}: missing @via (aggregates require a relationship path).`, { code: "ERR_INVALID_ORIGIN" }));
+                        continue;
+                    }
+                    _validateViaPath(via, root, obj.name, field.name, errors);
+                }
+            }
+        }
+    }
+    return errors;
+}
+// ---------------------------------------------------------------------------
+// Layout dataGrid @filter value validation
+//
+// Runs after extends: resolution (so inherited @filterable fields are visible)
+// and after parse-time desugaring (so every clause is canonical { op: value }).
+// Builds the allowlist from @filterable fields using OPS_BY_SUBTYPE, then checks
+// every filtered field is filterable and every op is allowed for its subtype.
+// ---------------------------------------------------------------------------
+export function validateDataGridFilterValues(root) {
+    const errors = [];
+    for (const obj of root.ownChildren().filter((c) => c.type === TYPE_OBJECT)) {
+        const effective = obj.children();
+        const allow = new Map();
+        for (const f of effective.filter((c) => c.type === TYPE_FIELD)) {
+            if (f.ownAttr(FIELD_ATTR_FILTERABLE) === true) {
+                allow.set(f.name, opsForSubType(f.subType));
+            }
+        }
+        for (const layout of effective.filter((c) => c.type === TYPE_LAYOUT && c.subType === LAYOUT_SUBTYPE_DATA_GRID)) {
+            const filter = layout.ownAttr(LAYOUT_DATA_GRID_ATTR_FILTER);
+            // Type errors (e.g. legacy string form) are reported by validateAttrSchema.
+            if (typeof filter !== "object" || filter === null || Array.isArray(filter))
+                continue;
+            checkFilterClauses(filter, allow, obj.name, layout.name, errors);
+        }
+    }
+    return errors;
+}
+function checkFilterClauses(filter, allow, entityName, layoutName, errors) {
+    for (const [key, clause] of Object.entries(filter)) {
+        if (key === FILTER_COMPOSE_OR || key === FILTER_COMPOSE_AND) {
+            if (Array.isArray(clause)) {
+                for (const sub of clause) {
+                    if (typeof sub === "object" && sub !== null && !Array.isArray(sub)) {
+                        checkFilterClauses(sub, allow, entityName, layoutName, errors);
+                    }
+                }
+            }
+            continue;
+        }
+        const allowedOps = allow.get(key);
+        if (allowedOps === undefined) {
+            errors.push(new ParseError(`dataGrid layout "${layoutName}" on entity "${entityName}" has @filter over ` +
+                `non-filterable field "${key}". Filterable fields: ${[...allow.keys()].join(", ") || "(none)"}`, { code: "ERR_BAD_ATTR_FILTER" }));
+            continue;
+        }
+        // After parse-time desugaring (FilterAttr.desugar), every non-composition field clause
+        // is canonical { op: value } — a bare scalar should not reach here; the object guard is defensive.
+        if (typeof clause === "object" && clause !== null && !Array.isArray(clause)) {
+            for (const op of Object.keys(clause)) {
+                if (!allowedOps.includes(op)) {
+                    errors.push(new ParseError(`dataGrid layout "${layoutName}" on entity "${entityName}" @filter uses disallowed ` +
+                        `op "${key}.${op}". Allowed ops for "${key}": ${allowedOps.join(", ")}`, { code: "ERR_BAD_ATTR_FILTER" }));
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=validation-passes.js.map

package/dist/loader/validation-passes.js.map

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

package/dist/meta/find-reference.d.ts

@@ -0,0 +1,22 @@
+import type { MetaObject } from "./meta-object.js";
+import type { MetaReferenceIdentity } from "./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/meta/find-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-reference.d.ts","sourceRoot":"","sources":["../../src/meta/find-reference.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE,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/meta/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/meta/find-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-reference.js","sourceRoot":"","sources":["../../src/meta/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,cAAc,CAAC;AAW5C;;;;;;;;;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"}