@metaobjectsdev/metadata 0.5.0-rc.1

package/dist/shared/base-types.d.ts

@@ -0,0 +1,23 @@
+export declare const TYPE_METADATA = "metadata";
+export declare const TYPE_OBJECT = "object";
+export declare const TYPE_FIELD = "field";
+export declare const TYPE_ATTR = "attr";
+export declare const TYPE_VALIDATOR = "validator";
+export declare const TYPE_VIEW = "view";
+export declare const TYPE_IDENTITY = "identity";
+export declare const TYPE_RELATIONSHIP = "relationship";
+export declare const TYPE_LAYOUT = "layout";
+export declare const TYPE_SOURCE = "source";
+export declare const TYPE_ORIGIN = "origin";
+export declare const BASE_TYPES: readonly ["metadata", "object", "field", "attr", "validator", "view", "identity", "relationship", "layout", "source", "origin"];
+export type BaseType = (typeof BASE_TYPES)[number];
+export declare const SUBTYPE_BASE = "base";
+/**
+ * The metadata document root subtype. The root node is `metadata.root` in the
+ * canonical format. (Distinct from the universal SUBTYPE_BASE — the redesigned
+ * format spec confirms the root subtype is `root`, not `base`.)
+ */
+export declare const SUBTYPE_ROOT = "root";
+export declare const METADATA_SUBTYPES: readonly ["root"];
+export type MetadataSubType = (typeof METADATA_SUBTYPES)[number];
+//# sourceMappingURL=base-types.d.ts.map

package/dist/shared/base-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-types.d.ts","sourceRoot":"","sources":["../../src/shared/base-types.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,eAAO,MAAM,WAAW,WAAW,CAAC;AACpC,eAAO,MAAM,UAAU,UAAU,CAAC;AAClC,eAAO,MAAM,SAAS,SAAS,CAAC;AAChC,eAAO,MAAM,cAAc,cAAc,CAAC;AAC1C,eAAO,MAAM,SAAS,SAAS,CAAC;AAChC,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAChD,eAAO,MAAM,WAAW,WAAW,CAAC;AACpC,eAAO,MAAM,WAAW,WAAW,CAAC;AACpC,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC,eAAO,MAAM,UAAU,iIAYb,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAMnD,eAAO,MAAM,YAAY,SAAS,CAAC;AAMnC;;;;GAIG;AACH,eAAO,MAAM,YAAY,SAAS,CAAC;AAEnC,eAAO,MAAM,iBAAiB,mBAA0B,CAAC;AACzD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/shared/base-types.js

@@ -0,0 +1,43 @@
+// Base type vocabulary — the 11 registered base types + universal/metadata subtypes.
+// ---------------------------------------------------------------------------
+// Base type names (the 11 registered base types — Java metaobjects-core vocabulary)
+// ---------------------------------------------------------------------------
+export const TYPE_METADATA = "metadata";
+export const TYPE_OBJECT = "object";
+export const TYPE_FIELD = "field";
+export const TYPE_ATTR = "attr";
+export const TYPE_VALIDATOR = "validator";
+export const TYPE_VIEW = "view";
+export const TYPE_IDENTITY = "identity";
+export const TYPE_RELATIONSHIP = "relationship";
+export const TYPE_LAYOUT = "layout";
+export const TYPE_SOURCE = "source";
+export const TYPE_ORIGIN = "origin";
+export const BASE_TYPES = [
+    TYPE_METADATA,
+    TYPE_OBJECT,
+    TYPE_FIELD,
+    TYPE_ATTR,
+    TYPE_VALIDATOR,
+    TYPE_VIEW,
+    TYPE_IDENTITY,
+    TYPE_RELATIONSHIP,
+    TYPE_LAYOUT,
+    TYPE_SOURCE,
+    TYPE_ORIGIN,
+];
+// ---------------------------------------------------------------------------
+// Universal subtype
+// ---------------------------------------------------------------------------
+export const SUBTYPE_BASE = "base";
+// ---------------------------------------------------------------------------
+// Metadata subtypes (1)
+// ---------------------------------------------------------------------------
+/**
+ * The metadata document root subtype. The root node is `metadata.root` in the
+ * canonical format. (Distinct from the universal SUBTYPE_BASE — the redesigned
+ * format spec confirms the root subtype is `root`, not `base`.)
+ */
+export const SUBTYPE_ROOT = "root";
+export const METADATA_SUBTYPES = [SUBTYPE_ROOT];
+//# sourceMappingURL=base-types.js.map

package/dist/shared/base-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-types.js","sourceRoot":"","sources":["../../src/shared/base-types.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,8EAA8E;AAC9E,oFAAoF;AACpF,8EAA8E;AAE9E,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AACpC,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC;AAClC,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC;AAChC,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;AAC1C,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC;AAChC,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;AACxC,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAChD,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AACpC,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AAEpC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,aAAa;IACb,WAAW;IACX,UAAU;IACV,SAAS;IACT,cAAc;IACd,SAAS;IACT,aAAa;IACb,iBAAiB;IACjB,WAAW;IACX,WAAW;IACX,WAAW;CACH,CAAC;AAGX,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AAEnC,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AAEnC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,YAAY,CAAU,CAAC"}

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

@@ -0,0 +1,123 @@
+import { TypeId } from "../registry.js";
+import type { DataType } from "../data-type.js";
+import type { MetaAttr } from "../core/attr/meta-attr.js";
+export type AttrValue = string | number | boolean | string[] | AttrObject;
+/**
+ * Object-shaped attr value (for `attr.filter` / `attr.properties`). Values are
+ * arbitrary JSON so a filter can hold nested `{ op: value }` clauses (including
+ * scalar arrays for `in` and `null` for `isNull`). Scalar/string[] attrs keep
+ * their existing arms — this arm is reached only by object-typed attr subtypes.
+ */
+export type AttrObject = {
+    readonly [key: string]: AttrJson;
+};
+export type AttrJson = string | number | boolean | null | AttrJson[] | AttrObject;
+export declare abstract class MetaData {
+    readonly typeId: TypeId;
+    readonly name: string;
+    package?: string;
+    superRef?: string;
+    private _superData?;
+    isAbstract: boolean;
+    isArray: boolean;
+    /**
+     * Per-node merge flag (v0.3 `merge: true` operator).
+     *
+     * When `true` on a node being parsed:
+     *   - If an existing same-(type,name) child is found in the current parent → reuse it (merge into it).
+     *   - If NOT found → throw: "Merge operation requested for [...] but no existing metadata found".
+     */
+    isMerge: boolean;
+    private _attrNodes;
+    private _ownValue?;
+    private _ownValueSet;
+    private _children;
+    private _parent?;
+    private _frozen;
+    protected _dataType?: DataType;
+    private readonly _cache;
+    constructor(typeId: TypeId, name: string);
+    /**
+     * Memoize a derived read. Only caches once the node is frozen — a value
+     * computed during the (mutable) load phase is never stored, so it cannot
+     * go stale. After freeze the tree is immutable, so a cached entry is valid
+     * for the node's lifetime; there is no invalidation.
+     */
+    protected cached<T>(key: string, compute: () => T): T;
+    get type(): string;
+    get subType(): string;
+    /** "package::name" if package is set, else just "name". Uses :: as separator (not .). */
+    fqn(): string;
+    private _assertNotFrozen;
+    setPackage(pkg: string): void;
+    /** Returns the resolved super model, or undefined if not yet resolved. */
+    get superData(): MetaData | undefined;
+    /** Temporary compatibility alias for `superData` — kept while super-resolve.ts still references this name; to be removed in a later task. */
+    get superResolved(): MetaData | undefined;
+    /**
+     * Sets the resolved super model. Normally called by Task 6's super resolution
+     * after parsing and before freezing.
+     */
+    setSuperResolved(model: MetaData): void;
+    setSuper(ref: string): void;
+    setIsArray(val: boolean): void;
+    /** Set the registry-supplied DataType. Called by the registry factory at
+     *  node construction. */
+    setDataType(dt: DataType): void;
+    setIsAbstract(val: boolean): void;
+    setIsMerge(val: boolean): void;
+    setAttr(name: string, value: AttrValue): void;
+    /** Attach a pre-built MetaAttr instance (the parser path, which knows the
+     *  declared subtype). Replaces any existing attr of the same name. */
+    setMetaAttr(node: MetaAttr): void;
+    /** Own (locally declared) attr value for `name`, or undefined — excludes inherited. */
+    ownAttr(name: string): AttrValue | undefined;
+    /** Own (locally declared) MetaAttr instance for `name`, or undefined. */
+    ownMetaAttr(name: string): MetaAttr | undefined;
+    /** Own MetaAttr instances, insertion-ordered, frozen; excludes inherited. */
+    ownMetaAttrs(): readonly MetaAttr[];
+    /** Own (locally declared) attr value map; excludes inherited. Cached. */
+    ownAttrs(): ReadonlyMap<string, AttrValue>;
+    /** True if `name` is an own (locally declared) attr — excludes inherited. */
+    ownHasAttr(name: string): boolean;
+    /**
+     * Effective attrs — own + inherited via the super chain, own winning on a key conflict; cached.
+     * Do not cast to `Map` and mutate — the same reference is returned on every call
+     * after freeze, so a mutation would corrupt subsequent reads.
+     */
+    attrs(): ReadonlyMap<string, AttrValue>;
+    /** Effective attr value for `name`, or undefined. */
+    attr(name: string): AttrValue | undefined;
+    /** True if `name` resolves to an effective attr (own or inherited). */
+    hasAttr(name: string): boolean;
+    addChild(child: MetaData): void;
+    /** The node this node was added to as a child, or undefined for the tree root. */
+    get parent(): MetaData | undefined;
+    /** Walk up to the top of the tree this node belongs to. */
+    root(): MetaData;
+    /** Own (locally declared) children — a cached frozen array; excludes children inherited via extends. */
+    ownChildren(): readonly MetaData[];
+    /** Own children whose type matches — excludes inherited. */
+    ownChildrenOfType(type: string): MetaData[];
+    /** Own children matching both type and subType — excludes inherited. */
+    ownChildrenOfSubType(type: string, subType: string): MetaData[];
+    /** First own child with matching name, or undefined — excludes inherited. */
+    ownChildByName(name: string): MetaData | undefined;
+    /** First own child matching both type and name, or undefined — excludes inherited. */
+    ownChildByTypeAndName(type: string, name: string): MetaData | undefined;
+    /** Effective children: own + inherited via the super chain, own shadowing super. Cached, frozen. */
+    children(): readonly MetaData[];
+    /** Effective children whose type matches. */
+    childrenOfType(type: string): MetaData[];
+    /** Effective children matching both type and subType. */
+    childrenOfSubType(type: string, subType: string): MetaData[];
+    /** First effective child with matching name, or undefined. */
+    childByName(name: string): MetaData | undefined;
+    /** First effective child matching both type and name, or undefined. */
+    childByTypeAndName(type: string, name: string): MetaData | undefined;
+    private _effectiveAttrs;
+    private _effectiveChildren;
+    freeze(): void;
+    isFrozen(): boolean;
+}
+//# sourceMappingURL=meta-data.d.ts.map

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

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

package/dist/shared/meta-data.js

@@ -0,0 +1,365 @@
+import { TypeId } from "../registry.js";
+import { TYPE_ATTR } from "./base-types.js";
+import { PACKAGE_SEPARATOR, RESERVED_KEY_VALUE } from "./structural.js";
+import { inferAttrSubType } from "../serializer-json.js";
+import { attrClassFor } from "../attr-class-map.js";
+export class MetaData {
+    typeId;
+    name;
+    // Identity / packaging
+    package;
+    superRef; // raw super reference string, pre-resolution
+    _superData; // post-resolution pointer; set by setSuperResolved() after parsing
+    isAbstract = false;
+    // Native @isArray (boolean property, NOT in attrs!)
+    isArray = false;
+    /**
+     * Per-node merge flag (v0.3 `merge: true` operator).
+     *
+     * When `true` on a node being parsed:
+     *   - If an existing same-(type,name) child is found in the current parent → reuse it (merge into it).
+     *   - If NOT found → throw: "Merge operation requested for [...] but no existing metadata found".
+     */
+    isMerge = false;
+    // Internal storage — attributes as MetaAttr instances, name-indexed and
+    // insertion-ordered. NOT in _children (attrs never appear in ownChildren()).
+    _attrNodes = new Map();
+    // A MetaAttr's own scalar/array/object value is a terminal stored under the
+    // reserved "value" key. It is NOT materialized as a nested MetaAttr (that
+    // would recurse forever — every node would build a child to hold its value,
+    // which would build a child, ...). Read via ownAttr(RESERVED_KEY_VALUE) /
+    // MetaAttr.value; set via setAttr(RESERVED_KEY_VALUE, ...).
+    _ownValue;
+    _ownValueSet = false;
+    _children = [];
+    _parent;
+    _frozen = false;
+    // Registry-supplied coarse value type — set by the registry factory at node
+    // construction (for field/attr nodes). Read via MetaField/MetaAttr.dataType.
+    _dataType;
+    // Per-instance read cache: only populated once the node is frozen.
+    _cache = new Map();
+    constructor(typeId, name) {
+        this.typeId = typeId;
+        this.name = name;
+    }
+    // ---------------------------------------------------------------------------
+    // Cache helper
+    // ---------------------------------------------------------------------------
+    /**
+     * Memoize a derived read. Only caches once the node is frozen — a value
+     * computed during the (mutable) load phase is never stored, so it cannot
+     * go stale. After freeze the tree is immutable, so a cached entry is valid
+     * for the node's lifetime; there is no invalidation.
+     */
+    cached(key, compute) {
+        if (this._frozen && this._cache.has(key)) {
+            return this._cache.get(key);
+        }
+        const value = compute();
+        if (this._frozen)
+            this._cache.set(key, value);
+        return value;
+    }
+    // ---------------------------------------------------------------------------
+    // Convenience accessors
+    // ---------------------------------------------------------------------------
+    get type() {
+        return this.typeId.type;
+    }
+    get subType() {
+        return this.typeId.subType;
+    }
+    /** "package::name" if package is set, else just "name". Uses :: as separator (not .). */
+    fqn() {
+        if (this.package !== undefined) {
+            return `${this.package}${PACKAGE_SEPARATOR}${this.name}`;
+        }
+        return this.name;
+    }
+    // ---------------------------------------------------------------------------
+    // Freeze guard
+    // ---------------------------------------------------------------------------
+    _assertNotFrozen() {
+        if (this._frozen) {
+            throw new Error(`Cannot mutate frozen MetaData ${this.fqn()}`);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Package
+    // ---------------------------------------------------------------------------
+    setPackage(pkg) {
+        this._assertNotFrozen();
+        this.package = pkg;
+    }
+    // ---------------------------------------------------------------------------
+    // Super
+    // ---------------------------------------------------------------------------
+    /** Returns the resolved super model, or undefined if not yet resolved. */
+    get superData() {
+        return this._superData;
+    }
+    /** Temporary compatibility alias for `superData` — kept while super-resolve.ts still references this name; to be removed in a later task. */
+    get superResolved() {
+        return this._superData;
+    }
+    /**
+     * Sets the resolved super model. Normally called by Task 6's super resolution
+     * after parsing and before freezing.
+     */
+    setSuperResolved(model) {
+        this._assertNotFrozen();
+        this._superData = model;
+    }
+    setSuper(ref) {
+        this._assertNotFrozen();
+        this.superRef = ref;
+    }
+    // ---------------------------------------------------------------------------
+    // isArray
+    // ---------------------------------------------------------------------------
+    setIsArray(val) {
+        this._assertNotFrozen();
+        this.isArray = val;
+    }
+    // ---------------------------------------------------------------------------
+    // dataType
+    // ---------------------------------------------------------------------------
+    /** Set the registry-supplied DataType. Called by the registry factory at
+     *  node construction. */
+    setDataType(dt) {
+        this._assertNotFrozen();
+        this._dataType = dt;
+    }
+    // ---------------------------------------------------------------------------
+    // isAbstract
+    // ---------------------------------------------------------------------------
+    setIsAbstract(val) {
+        this._assertNotFrozen();
+        this.isAbstract = val;
+    }
+    // ---------------------------------------------------------------------------
+    // isMerge
+    // ---------------------------------------------------------------------------
+    setIsMerge(val) {
+        this._assertNotFrozen();
+        this.isMerge = val;
+    }
+    // ---------------------------------------------------------------------------
+    // Attributes
+    // ---------------------------------------------------------------------------
+    setAttr(name, value) {
+        this._assertNotFrozen();
+        // The reserved "value" key is a node's own terminal value (e.g. a MetaAttr's
+        // value). It is stored directly, never materialized as a nested MetaAttr —
+        // doing so would recurse forever (each node would build a child to hold its
+        // value). See _ownValue.
+        if (name === RESERVED_KEY_VALUE) {
+            this._ownValue = value;
+            this._ownValueSet = true;
+            return;
+        }
+        const existing = this._attrNodes.get(name);
+        if (existing !== undefined) {
+            existing.setAttr(RESERVED_KEY_VALUE, value);
+            return;
+        }
+        // Resolve the attr's class. A declared subtype isn't known here (this is the
+        // node, not the registry), so infer from the value shape — same rule the
+        // serializer uses. The parser, which DOES know the declared subtype, builds
+        // the instance directly via setMetaAttr (below).
+        const subType = inferAttrSubType(value);
+        const AttrClass = attrClassFor(subType);
+        const node = new AttrClass(new TypeId(TYPE_ATTR, subType), name);
+        node.setAttr(RESERVED_KEY_VALUE, value);
+        this._attrNodes.set(name, node);
+    }
+    /** Attach a pre-built MetaAttr instance (the parser path, which knows the
+     *  declared subtype). Replaces any existing attr of the same name. */
+    setMetaAttr(node) {
+        this._assertNotFrozen();
+        this._attrNodes.set(node.name, node);
+    }
+    /** Own (locally declared) attr value for `name`, or undefined — excludes inherited. */
+    ownAttr(name) {
+        if (name === RESERVED_KEY_VALUE) {
+            return this._ownValueSet ? this._ownValue : undefined;
+        }
+        return this._attrNodes.get(name)?.value;
+    }
+    /** Own (locally declared) MetaAttr instance for `name`, or undefined. */
+    ownMetaAttr(name) {
+        return this._attrNodes.get(name);
+    }
+    /** Own MetaAttr instances, insertion-ordered, frozen; excludes inherited. */
+    ownMetaAttrs() {
+        return this.cached("ownMetaAttrs", () => Object.freeze([...this._attrNodes.values()]));
+    }
+    /** Own (locally declared) attr value map; excludes inherited. Cached. */
+    ownAttrs() {
+        return this.cached("ownAttrs", () => {
+            const m = new Map();
+            for (const [name, node] of this._attrNodes) {
+                if (node.value !== undefined)
+                    m.set(name, node.value);
+            }
+            return m;
+        });
+    }
+    /** True if `name` is an own (locally declared) attr — excludes inherited. */
+    ownHasAttr(name) {
+        if (name === RESERVED_KEY_VALUE) {
+            return this._ownValueSet;
+        }
+        return this._attrNodes.has(name);
+    }
+    // ---------------------------------------------------------------------------
+    // Effective attr accessors — the default. Own + attrs inherited via the
+    // super chain (own winning on a key conflict). Own-only access is the
+    // explicit own* opt-in above.
+    // ---------------------------------------------------------------------------
+    /**
+     * Effective attrs — own + inherited via the super chain, own winning on a key conflict; cached.
+     * Do not cast to `Map` and mutate — the same reference is returned on every call
+     * after freeze, so a mutation would corrupt subsequent reads.
+     */
+    attrs() {
+        return this.cached("attrs", () => this._effectiveAttrs(new Set([this])));
+    }
+    /** Effective attr value for `name`, or undefined. */
+    attr(name) {
+        return this.attrs().get(name);
+    }
+    /** True if `name` resolves to an effective attr (own or inherited). */
+    hasAttr(name) {
+        return this.attrs().has(name);
+    }
+    // ---------------------------------------------------------------------------
+    // Children
+    // ---------------------------------------------------------------------------
+    addChild(child) {
+        this._assertNotFrozen();
+        child._parent = this;
+        this._children.push(child);
+    }
+    /** The node this node was added to as a child, or undefined for the tree root. */
+    get parent() {
+        return this._parent;
+    }
+    /** Walk up to the top of the tree this node belongs to. */
+    root() {
+        let node = this;
+        while (node._parent !== undefined) {
+            node = node._parent;
+        }
+        return node;
+    }
+    /** Own (locally declared) children — a cached frozen array; excludes children inherited via extends. */
+    ownChildren() {
+        return this.cached("ownChildren", () => Object.freeze([...this._children]));
+    }
+    /** Own children whose type matches — excludes inherited. */
+    ownChildrenOfType(type) {
+        return this.ownChildren().filter((c) => c.type === type);
+    }
+    /** Own children matching both type and subType — excludes inherited. */
+    ownChildrenOfSubType(type, subType) {
+        return this.ownChildren().filter((c) => c.type === type && c.subType === subType);
+    }
+    /** First own child with matching name, or undefined — excludes inherited. */
+    ownChildByName(name) {
+        return this.ownChildren().find((c) => c.name === name);
+    }
+    /** First own child matching both type and name, or undefined — excludes inherited. */
+    ownChildByTypeAndName(type, name) {
+        return this.ownChildren().find((c) => c.type === type && c.name === name);
+    }
+    // ---------------------------------------------------------------------------
+    // Effective child accessors — the default. Own + children inherited via the
+    // super chain (own shadowing super on a (type, name) match). Own-only access
+    // is the explicit own* opt-in above.
+    // ---------------------------------------------------------------------------
+    /** Effective children: own + inherited via the super chain, own shadowing super. Cached, frozen. */
+    children() {
+        return this.cached("children", () => Object.freeze(this._effectiveChildren(new Set([this]))));
+    }
+    /** Effective children whose type matches. */
+    childrenOfType(type) {
+        return this.children().filter((c) => c.type === type);
+    }
+    /** Effective children matching both type and subType. */
+    childrenOfSubType(type, subType) {
+        return this.children().filter((c) => c.type === type && c.subType === subType);
+    }
+    /** First effective child with matching name, or undefined. */
+    childByName(name) {
+        return this.children().find((c) => c.name === name);
+    }
+    /** First effective child matching both type and name, or undefined. */
+    childByTypeAndName(type, name) {
+        return this.children().find((c) => c.type === type && c.name === name);
+    }
+    // ---------------------------------------------------------------------------
+    // Internal helpers for effective attr / child computation
+    // ---------------------------------------------------------------------------
+    _effectiveAttrs(visited) {
+        const ownValues = () => {
+            const m = new Map();
+            for (const [name, node] of this._attrNodes) {
+                if (node.value !== undefined)
+                    m.set(name, node.value);
+            }
+            return m;
+        };
+        if (this._superData === undefined || visited.has(this._superData)) {
+            return ownValues();
+        }
+        visited.add(this._superData);
+        const result = this._superData._effectiveAttrs(visited);
+        for (const [k, v] of ownValues()) {
+            result.set(k, v);
+        }
+        return result;
+    }
+    _effectiveChildren(visited) {
+        if (this._superData === undefined || visited.has(this._superData)) {
+            return [...this._children];
+        }
+        visited.add(this._superData);
+        // Start from the super's effective children (already a copy from the recursive call).
+        const result = this._superData._effectiveChildren(visited);
+        // Track which of our own children matched (overrode) a super child position.
+        const appendQueue = [];
+        for (const ownChild of this._children) {
+            // Find the index in result that has the same (type, name).
+            const idx = result.findIndex((sc) => sc.type === ownChild.type && sc.name === ownChild.name);
+            if (idx !== -1) {
+                // Replace the super child with our own (in-place override).
+                result[idx] = ownChild;
+            }
+            else {
+                // No matching super child — will be appended at the end.
+                appendQueue.push(ownChild);
+            }
+        }
+        // Append non-overriding own children.
+        result.push(...appendQueue);
+        return result;
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle
+    // ---------------------------------------------------------------------------
+    freeze() {
+        if (this._frozen) {
+            return; // Idempotent
+        }
+        this._frozen = true;
+        for (const child of this._children) {
+            child.freeze();
+        }
+    }
+    isFrozen() {
+        return this._frozen;
+    }
+}
+//# sourceMappingURL=meta-data.js.map

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

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

package/dist/shared/meta-root.d.ts

@@ -0,0 +1,12 @@
+import { MetaData } from "./meta-data.js";
+import type { MetaObject } from "../core/object/meta-object.js";
+import type { MetaField } from "../core/field/meta-field.js";
+export declare class MetaRoot extends MetaData {
+    /** Object entities defined at this root level. */
+    objects(): MetaObject[];
+    /** Abstract / package-level fields defined at root (rare; e.g. shared id fields). */
+    fields(): MetaField[];
+    /** Find an object by name. */
+    findObject(name: string): MetaObject | undefined;
+}
+//# sourceMappingURL=meta-root.d.ts.map

package/dist/shared/meta-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-root.d.ts","sourceRoot":"","sources":["../../src/shared/meta-root.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE7D,qBAAa,QAAS,SAAQ,QAAQ;IACpC,kDAAkD;IAClD,OAAO,IAAI,UAAU,EAAE;IAMvB,qFAAqF;IACrF,MAAM,IAAI,SAAS,EAAE;IAMrB,8BAA8B;IAC9B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;CAMjD"}

package/dist/shared/meta-root.js

@@ -0,0 +1,24 @@
+// MetaRoot — concrete node class for the type=metadata root node.
+//
+// Extends MetaData directly: no model wrapper, no metaOf() indirection.
+// Children are already concrete typed nodes; accessors filter by type constant.
+import { MetaData } from "./meta-data.js";
+import { TYPE_OBJECT, TYPE_FIELD } from "./base-types.js";
+export class MetaRoot extends MetaData {
+    /** Object entities defined at this root level. */
+    objects() {
+        return this.cached("objects", () => this.ownChildren().filter((c) => c.type === TYPE_OBJECT));
+    }
+    /** Abstract / package-level fields defined at root (rare; e.g. shared id fields). */
+    fields() {
+        return this.cached("fields", () => this.ownChildren().filter((c) => c.type === TYPE_FIELD));
+    }
+    /** Find an object by name. */
+    findObject(name) {
+        return this.cached(`findObject:${name}`, () => {
+            const child = this.ownChildByTypeAndName(TYPE_OBJECT, name);
+            return child !== undefined ? child : undefined;
+        });
+    }
+}
+//# sourceMappingURL=meta-root.js.map

package/dist/shared/meta-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-root.js","sourceRoot":"","sources":["../../src/shared/meta-root.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,EAAE;AACF,wEAAwE;AACxE,gFAAgF;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI1D,MAAM,OAAO,QAAS,SAAQ,QAAQ;IACpC,kDAAkD;IAClD,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,CACjC,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAC1E,CAAC;IACJ,CAAC;IAED,qFAAqF;IACrF,MAAM;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,CAChC,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CACxE,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,EAAE,EAAE,GAAG,EAAE;YAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,qBAAqB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAC5D,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAE,KAAoB,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}