@metaobjectsdev/metadata 0.9.0-rc.1 → 0.10.0

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

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

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

@@ -0,0 +1,48 @@
+import { MetaData, type AttrValue } from "./meta-data.js";
+import { type DataType, type DataTypeAware } from "../data-type.js";
+import type { MetaValidator } from "./meta-validator.js";
+import type { MetaView } from "./meta-view.js";
+export declare class MetaField extends MetaData implements DataTypeAware {
+    /** The coarse value-type classification for this field's subtype. */
+    get dataType(): DataType;
+    /** The target object name for an object-typed field (the `@objectRef` attr). */
+    get objectRef(): string | undefined;
+    get dbColumn(): string | undefined;
+    get default(): unknown;
+    /**
+     * The default value for this field, converted to the field's own DataType.
+     *
+     * Java parity: MetaField.getDefaultValue() — reads the raw @default attr and
+     * converts it via DataConverter.toTypeSafe(getDataType(), raw). This ensures
+     * that even if the raw value was stored as a string (e.g. "@default": "false"
+     * in YAML or string-keyed JSON), the returned value is the correctly-typed
+     * boolean/number/string for this field's subtype.
+     *
+     * Returns undefined when @default is not set on this field.
+     * Result is cached after freeze (same pattern as validators()/views()).
+     */
+    defaultValue(): AttrValue | undefined;
+    get maxLength(): number | undefined;
+    get precision(): number | undefined;
+    get scale(): number | undefined;
+    /** True if `@unique: true` is set on the field itself (column-level unique). */
+    get unique(): boolean;
+    /**
+     * True if the field is required (NOT NULL).
+     *
+     * Checks both `@required: true` attr and `validator.required` children —
+     * matches the codegen-ts isRequired() semantics.
+     */
+    get isRequired(): boolean;
+    /** All effective validators (own + inherited via extends). Java parity: MetaField.getValidators() / getChildren(MetaValidator.class, true). */
+    validators(): MetaValidator[];
+    /** Own validators only — excludes validators inherited via extends. Java parity: getChildren(Class, false). */
+    ownValidators(): MetaValidator[];
+    /** All effective views (own + inherited via extends). Java parity: MetaField.getViews() / getChildren(MetaView.class, true). */
+    views(): MetaView[];
+    /** Own views only — excludes views inherited via extends. */
+    ownViews(): MetaView[];
+    /** The typed supertype field if `extends:` resolved, else undefined. */
+    resolveSuper(): MetaField | undefined;
+}
+//# sourceMappingURL=meta-field.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-field.d.ts","sourceRoot":"","sources":["../../src/meta/meta-field.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAoB,MAAM,iBAAiB,CAAC;AAetF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qBAAa,SAAU,SAAQ,QAAS,YAAW,aAAa;IAC9D,qEAAqE;IACrE,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAED,gFAAgF;IAChF,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAGlC;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAGjC;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;;;;;;;OAWG;IACH,YAAY,IAAI,SAAS,GAAG,SAAS;IAQrC,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAGlC;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAGlC;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAG9B;IAED,gFAAgF;IAChF,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;;;OAKG;IACH,IAAI,UAAU,IAAI,OAAO,CAGxB;IAED,+IAA+I;IAC/I,UAAU,IAAI,aAAa,EAAE;IAM7B,+GAA+G;IAC/G,aAAa,IAAI,aAAa,EAAE;IAMhC,gIAAgI;IAChI,KAAK,IAAI,QAAQ,EAAE;IAMnB,6DAA6D;IAC7D,QAAQ,IAAI,QAAQ,EAAE;IAMtB,wEAAwE;IACxE,YAAY,IAAI,SAAS,GAAG,SAAS;CAGtC"}

package/dist/meta/meta-field.js

@@ -0,0 +1,94 @@
+// MetaField — concrete node class for type=field nodes.
+//
+// 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 { DATA_TYPE_STRING } from "../data-type.js";
+import { convertToDataType } from "../data-converter.js";
+import { TYPE_VALIDATOR, TYPE_VIEW, FIELD_ATTR_DB_COLUMN, FIELD_ATTR_REQUIRED, FIELD_ATTR_UNIQUE, FIELD_ATTR_DEFAULT, FIELD_ATTR_MAX_LENGTH, FIELD_ATTR_PRECISION, FIELD_ATTR_SCALE, FIELD_ATTR_OBJECT_REF, VALIDATOR_SUBTYPE_REQUIRED, } from "../constants.js";
+export class MetaField extends MetaData {
+    /** The coarse value-type classification for this field's subtype. */
+    get dataType() {
+        return this._dataType ?? DATA_TYPE_STRING;
+    }
+    /** The target object name for an object-typed field (the `@objectRef` attr). */
+    get objectRef() {
+        const v = this.ownAttr(FIELD_ATTR_OBJECT_REF);
+        return typeof v === "string" ? v : undefined;
+    }
+    get dbColumn() {
+        const v = this.ownAttr(FIELD_ATTR_DB_COLUMN);
+        return typeof v === "string" ? v : undefined;
+    }
+    get default() {
+        return this.ownAttr(FIELD_ATTR_DEFAULT);
+    }
+    /**
+     * The default value for this field, converted to the field's own DataType.
+     *
+     * Java parity: MetaField.getDefaultValue() — reads the raw @default attr and
+     * converts it via DataConverter.toTypeSafe(getDataType(), raw). This ensures
+     * that even if the raw value was stored as a string (e.g. "@default": "false"
+     * in YAML or string-keyed JSON), the returned value is the correctly-typed
+     * boolean/number/string for this field's subtype.
+     *
+     * Returns undefined when @default is not set on this field.
+     * Result is cached after freeze (same pattern as validators()/views()).
+     */
+    defaultValue() {
+        return this.cached("defaultValue", () => {
+            const raw = this.ownAttr(FIELD_ATTR_DEFAULT);
+            if (raw === undefined)
+                return undefined;
+            return convertToDataType(this.dataType, raw);
+        });
+    }
+    get maxLength() {
+        const v = this.ownAttr(FIELD_ATTR_MAX_LENGTH);
+        return typeof v === "number" ? v : undefined;
+    }
+    get precision() {
+        const v = this.ownAttr(FIELD_ATTR_PRECISION);
+        return typeof v === "number" ? v : undefined;
+    }
+    get scale() {
+        const v = this.ownAttr(FIELD_ATTR_SCALE);
+        return typeof v === "number" ? v : undefined;
+    }
+    /** True if `@unique: true` is set on the field itself (column-level unique). */
+    get unique() {
+        return this.ownAttr(FIELD_ATTR_UNIQUE) === true;
+    }
+    /**
+     * True if the field is required (NOT NULL).
+     *
+     * Checks both `@required: true` attr and `validator.required` children —
+     * matches the codegen-ts isRequired() semantics.
+     */
+    get isRequired() {
+        if (this.ownAttr(FIELD_ATTR_REQUIRED) === true)
+            return true;
+        return this.validators().some((v) => v.subType === VALIDATOR_SUBTYPE_REQUIRED);
+    }
+    /** All effective validators (own + inherited via extends). Java parity: MetaField.getValidators() / getChildren(MetaValidator.class, true). */
+    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 views (own + inherited via extends). Java parity: MetaField.getViews() / getChildren(MetaView.class, true). */
+    views() {
+        return this.cached("views", () => this.children().filter((c) => c.type === TYPE_VIEW));
+    }
+    /** Own views only — excludes views inherited via extends. */
+    ownViews() {
+        return this.cached("ownViews", () => this.ownChildren().filter((c) => c.type === TYPE_VIEW));
+    }
+    /** The typed supertype field if `extends:` resolved, else undefined. */
+    resolveSuper() {
+        return this.superData;
+    }
+}
+//# sourceMappingURL=meta-field.js.map

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

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

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

@@ -0,0 +1,71 @@
+import { MetaData } from "./meta-data.js";
+import type { MetaRoot } from "./meta-root.js";
+/** Strongly-typed identity generation strategies. */
+export type IdentityGeneration = "increment" | "uuid" | "assigned";
+export declare class MetaIdentity extends MetaData {
+    get fields(): string[];
+    /**
+     * Whether the identity enforces uniqueness.
+     * Defaults to true; explicit `@unique: false` makes it a non-unique index.
+     */
+    get unique(): boolean;
+    isPrimary(): boolean;
+    isSecondary(): boolean;
+    isReference(): boolean;
+    isComposite(): boolean;
+}
+/**
+ * Primary identity (the entity's PK). Always unique by definition.
+ * Carries `@generation` (increment / uuid / assigned).
+ */
+export declare class MetaPrimaryIdentity extends MetaIdentity {
+    get generation(): IdentityGeneration | undefined;
+}
+/**
+ * Secondary identity — a unique or non-unique index on one or more fields.
+ * `@generation` does not apply here.
+ */
+export declare 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 declare class MetaReferenceIdentity extends MetaIdentity {
+    /** Raw `@references` attr value, unparsed. */
+    get referencesRaw(): string | undefined;
+    /** Target entity name (the bit before the dot, or the whole bare value). */
+    get targetEntity(): string | undefined;
+    /**
+     * 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(): boolean;
+    /**
+     * 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(): string[];
+    /**
+     * 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: MetaRoot): string | undefined;
+}
+//# sourceMappingURL=meta-identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-identity.d.ts","sourceRoot":"","sources":["../../src/meta/meta-identity.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAW1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnE,qBAAa,YAAa,SAAQ,QAAQ;IACxC,IAAI,MAAM,IAAI,MAAM,EAAE,CAGrB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,SAAS,IAAI,OAAO;IAIpB,WAAW,IAAI,OAAO;IAItB,WAAW,IAAI,OAAO;IAItB,WAAW,IAAI,OAAO;CAGvB;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,IAAI,UAAU,IAAI,kBAAkB,GAAG,SAAS,CAG/C;CACF;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;CAAG;AAE1D;;;;;;;;;;GAUG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,8CAA8C;IAC9C,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAGtC;IAED,4EAA4E;IAC5E,IAAI,YAAY,IAAI,MAAM,GAAG,SAAS,CAKrC;IAED;;;;;;OAMG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;OAIG;IACH,IAAI,YAAY,IAAI,MAAM,EAAE,CAU3B;IAED;;;;;;;;OAQG;IACH,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS;CAe1D"}

package/dist/meta/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 "./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 "../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/meta/meta-identity.js.map

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

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

@@ -0,0 +1,23 @@
+import { MetaData } from "./meta-data.js";
+import { type SortOrderValue } from "../constants.js";
+export declare class MetaLayout extends MetaData {
+    /** The number of rows per page for the dataGrid layout. */
+    get pageSize(): number | undefined;
+    /** The field name to sort by default in the dataGrid layout. */
+    get defaultSortField(): string | undefined;
+    /**
+     * The default sort order (`"asc"` or `"desc"`) for the dataGrid layout.
+     * Returns `undefined` when the attr is absent.
+     */
+    get defaultSortOrder(): SortOrderValue | undefined;
+    /**
+     * True when `@filterable: true` is set on the dataGrid layout.
+     * Defaults to `false` when the attr is absent.
+     */
+    get filterable(): boolean;
+    /** A JSON-encoded preset filter string for the dataGrid layout. */
+    get filter(): string | undefined;
+    /** The ordered list of field names to display as columns in the dataGrid layout. */
+    get columns(): string[];
+}
+//# sourceMappingURL=meta-layout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-layout.d.ts","sourceRoot":"","sources":["../../src/meta/meta-layout.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,UAAW,SAAQ,QAAQ;IACtC,2DAA2D;IAC3D,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAGjC;IAED,gEAAgE;IAChE,IAAI,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAGzC;IAED;;;OAGG;IACH,IAAI,gBAAgB,IAAI,cAAc,GAAG,SAAS,CAGjD;IAED;;;OAGG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,mEAAmE;IACnE,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAG/B;IAED,oFAAoF;IACpF,IAAI,OAAO,IAAI,MAAM,EAAE,CAGtB;CACF"}

package/dist/meta/meta-layout.js

@@ -0,0 +1,45 @@
+// MetaLayout — concrete node class for type=layout nodes.
+// Object-level UI surfaces (Project E; replaces object-attached data-grid view
+// subtype; views are strictly field-level per Java parity).
+//
+// Extends MetaData directly: no model wrapper, no metaOf() indirection.
+import { MetaData } from "./meta-data.js";
+import { LAYOUT_DATA_GRID_ATTR_PAGE_SIZE, LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD, LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER, LAYOUT_DATA_GRID_ATTR_FILTERABLE, LAYOUT_DATA_GRID_ATTR_FILTER, LAYOUT_DATA_GRID_ATTR_COLUMNS, } from "../constants.js";
+export class MetaLayout extends MetaData {
+    /** The number of rows per page for the dataGrid layout. */
+    get pageSize() {
+        const v = this.ownAttr(LAYOUT_DATA_GRID_ATTR_PAGE_SIZE);
+        return typeof v === "number" ? v : undefined;
+    }
+    /** The field name to sort by default in the dataGrid layout. */
+    get defaultSortField() {
+        const v = this.ownAttr(LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD);
+        return typeof v === "string" ? v : undefined;
+    }
+    /**
+     * The default sort order (`"asc"` or `"desc"`) for the dataGrid layout.
+     * Returns `undefined` when the attr is absent.
+     */
+    get defaultSortOrder() {
+        const v = this.ownAttr(LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER);
+        return typeof v === "string" ? v : undefined;
+    }
+    /**
+     * True when `@filterable: true` is set on the dataGrid layout.
+     * Defaults to `false` when the attr is absent.
+     */
+    get filterable() {
+        return this.ownAttr(LAYOUT_DATA_GRID_ATTR_FILTERABLE) === true;
+    }
+    /** A JSON-encoded preset filter string for the dataGrid layout. */
+    get filter() {
+        const v = this.ownAttr(LAYOUT_DATA_GRID_ATTR_FILTER);
+        return typeof v === "string" ? v : undefined;
+    }
+    /** The ordered list of field names to display as columns in the dataGrid layout. */
+    get columns() {
+        const c = this.ownAttr(LAYOUT_DATA_GRID_ATTR_COLUMNS);
+        return Array.isArray(c) ? c : [];
+    }
+}
+//# sourceMappingURL=meta-layout.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-layout.js","sourceRoot":"","sources":["../../src/meta/meta-layout.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,+EAA+E;AAC/E,4DAA4D;AAC5D,EAAE;AACF,wEAAwE;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EACL,+BAA+B,EAC/B,wCAAwC,EACxC,wCAAwC,EACxC,gCAAgC,EAChC,4BAA4B,EAC5B,6BAA6B,GAE9B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,OAAO,UAAW,SAAQ,QAAQ;IACtC,2DAA2D;IAC3D,IAAI,QAAQ;QACV,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,gEAAgE;IAChE,IAAI,gBAAgB;QAClB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;QACjE,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED;;;OAGG;IACH,IAAI,gBAAgB;QAClB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,wCAAwC,CAAC,CAAC;QACjE,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAoB,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,gCAAgC,CAAC,KAAK,IAAI,CAAC;IACjE,CAAC;IAED,mEAAmE;IACnE,IAAI,MAAM;QACR,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,oFAAoF;IACpF,IAAI,OAAO;QACT,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"}

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

@@ -0,0 +1,40 @@
+import { MetaData } from "./meta-data.js";
+import type { MetaField } from "./meta-field.js";
+import type { MetaIdentity, MetaReferenceIdentity } from "./meta-identity.js";
+import type { MetaLayout } from "./meta-layout.js";
+import type { MetaRelationship } from "./meta-relationship.js";
+import type { MetaValidator } from "./meta-validator.js";
+export declare class MetaObject extends MetaData {
+    get dbTable(): string | undefined;
+    get javaRuntime(): 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/meta/meta-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-object.d.ts","sourceRoot":"","sources":["../../src/meta/meta-object.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAiB1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,UAAW,SAAQ,QAAQ;IACtC,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAQhC;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAGpC;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/meta/meta-object.js

@@ -0,0 +1,81 @@
+// 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 "./meta-data.js";
+import { TYPE_FIELD, TYPE_IDENTITY, TYPE_RELATIONSHIP, TYPE_VALIDATOR, TYPE_SOURCE, TYPE_LAYOUT, SOURCE_SUBTYPE_DB_TABLE, SOURCE_DB_TABLE_ATTR_NAME, OBJECT_SUBTYPE_ENTITY, OBJECT_SUBTYPE_VALUE, IDENTITY_SUBTYPE_PRIMARY, IDENTITY_SUBTYPE_SECONDARY, IDENTITY_SUBTYPE_REFERENCE, OBJECT_ATTR_JAVA_RUNTIME, } from "../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;
+        });
+    }
+    get javaRuntime() {
+        const v = this.ownAttr(OBJECT_ATTR_JAVA_RUNTIME);
+        return typeof v === "string" ? v : 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/meta/meta-object.js.map

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

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

@@ -0,0 +1,32 @@
+import { MetaData } from "./meta-data.js";
+import { type AggregateFunction } from "../constants.js";
+export declare class MetaOrigin extends MetaData {
+}
+/**
+ * Passthrough origin — the field's value is sourced directly from a
+ * cross-entity field reference (e.g. a projection that forwards Program.title).
+ *
+ * Carries `@from` (required): the dotted Entity.field reference identifying
+ * the source value.
+ */
+export declare class MetaPassthroughOrigin extends MetaOrigin {
+    /** The dotted-path cross-entity field reference this origin passes through (e.g. "Program.title"). */
+    get from(): string | undefined;
+    /** Optional dotted relationship path used to reach the source entity (e.g. "Program.weeks"). */
+    get via(): string | undefined;
+}
+/**
+ * Aggregate origin — the field's value is computed by aggregating values
+ * over a relationship path (count / sum / avg / min / max).
+ *
+ * Carries `@agg`, `@of`, and `@via` (all required).
+ */
+export declare class MetaAggregateOrigin extends MetaOrigin {
+    /** The aggregate function (count | sum | avg | min | max). */
+    get agg(): AggregateFunction | undefined;
+    /** The dotted-path target of the aggregate (e.g. "Week.id"). */
+    get of(): string | undefined;
+    /** The dotted relationship path the aggregate walks (e.g. "Program.weeks"). */
+    get via(): string | undefined;
+}
+//# sourceMappingURL=meta-origin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-origin.d.ts","sourceRoot":"","sources":["../../src/meta/meta-origin.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAML,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAEzB,qBAAa,UAAW,SAAQ,QAAQ;CAAG;AAE3C;;;;;;GAMG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;IACnD,sGAAsG;IACtG,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAG7B;IAED,gGAAgG;IAChG,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAG5B;CACF;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,8DAA8D;IAC9D,IAAI,GAAG,IAAI,iBAAiB,GAAG,SAAS,CAGvC;IAED,gEAAgE;IAChE,IAAI,EAAE,IAAI,MAAM,GAAG,SAAS,CAG3B;IAED,+EAA+E;IAC/E,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAG5B;CACF"}