@metaobjectsdev/metadata 0.5.0-rc.1

package/dist/persistence/db/db-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-constants.d.ts","sourceRoot":"","sources":["../../../src/persistence/db/db-constants.ts"],"names":[],"mappings":"AAEA,iFAAiF;AACjF,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAC/C,gGAAgG;AAChG,eAAO,MAAM,qBAAqB,eAAe,CAAC"}

package/dist/persistence/db/db-constants.js

@@ -0,0 +1,6 @@
+// DB concern constants — physical DB column attr keys.
+/** Custom DB column name override on a field (maps to @dbColumn in metadata). */
+export const FIELD_ATTR_DB_COLUMN = "dbColumn";
+/** When true, suppress the @filterable-without-index Loader warning (Project D drift check). */
+export const FIELD_ATTR_DB_INDEXED = "db.indexed";
+//# sourceMappingURL=db-constants.js.map

package/dist/persistence/db/db-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-constants.js","sourceRoot":"","sources":["../../../src/persistence/db/db-constants.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,iFAAiF;AACjF,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAC/C,gGAAgG;AAChG,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC"}

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

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

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

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

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

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

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

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

package/dist/persistence/db/db-schema.d.ts

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

package/dist/persistence/db/db-schema.d.ts.map

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

package/dist/persistence/db/db-schema.js

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

package/dist/persistence/db/db-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-schema.js","sourceRoot":"","sources":["../../../src/persistence/db/db-schema.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,0BAA0B;AAG1B,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE,kEAAkE;AAClE,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,IAAI,EAAE,oBAAoB;IAC1B,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,mIAAmI;CACtI,CAAC;AAEF,8FAA8F;AAC9F,MAAM,CAAC,MAAM,eAAe,GAAe;IACzC,IAAI,EAAE,qBAAqB;IAC3B,SAAS,EAAE,oBAAoB;IAC/B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,yGAAyG;CAC5G,CAAC;AAEF,oFAAoF;AACpF,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,gBAAgB;IACtB,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,4HAA4H;CAC/H,CAAC"}

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

@@ -0,0 +1,32 @@
+import { MetaData } from "../../shared/meta-data.js";
+import { type AggregateFunction } from "./origin-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/persistence/origin/meta-origin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-origin.d.ts","sourceRoot":"","sources":["../../../src/persistence/origin/meta-origin.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAML,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,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"}

package/dist/persistence/origin/meta-origin.js

@@ -0,0 +1,55 @@
+// MetaOrigin — concrete node class for type=origin nodes.
+// Field-level provenance (Project E).
+// passthrough / aggregate origin subtypes declare how field values are derived.
+//
+// MetaPassthroughOrigin and MetaAggregateOrigin are co-located subtype classes
+// (mirrors the meta-identity.ts pattern).
+//
+// Extends MetaData directly: no model wrapper, no metaOf() indirection.
+import { MetaData } from "../../shared/meta-data.js";
+import { ORIGIN_PASSTHROUGH_ATTR_FROM, ORIGIN_PASSTHROUGH_ATTR_VIA, ORIGIN_AGGREGATE_ATTR_AGG, ORIGIN_AGGREGATE_ATTR_OF, ORIGIN_AGGREGATE_ATTR_VIA, } from "./origin-constants.js";
+export 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 class MetaPassthroughOrigin extends MetaOrigin {
+    /** The dotted-path cross-entity field reference this origin passes through (e.g. "Program.title"). */
+    get from() {
+        const v = this.ownAttr(ORIGIN_PASSTHROUGH_ATTR_FROM);
+        return typeof v === "string" ? v : undefined;
+    }
+    /** Optional dotted relationship path used to reach the source entity (e.g. "Program.weeks"). */
+    get via() {
+        const v = this.ownAttr(ORIGIN_PASSTHROUGH_ATTR_VIA);
+        return typeof v === "string" ? v : 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 class MetaAggregateOrigin extends MetaOrigin {
+    /** The aggregate function (count | sum | avg | min | max). */
+    get agg() {
+        const v = this.ownAttr(ORIGIN_AGGREGATE_ATTR_AGG);
+        return typeof v === "string" ? v : undefined;
+    }
+    /** The dotted-path target of the aggregate (e.g. "Week.id"). */
+    get of() {
+        const v = this.ownAttr(ORIGIN_AGGREGATE_ATTR_OF);
+        return typeof v === "string" ? v : undefined;
+    }
+    /** The dotted relationship path the aggregate walks (e.g. "Program.weeks"). */
+    get via() {
+        const v = this.ownAttr(ORIGIN_AGGREGATE_ATTR_VIA);
+        return typeof v === "string" ? v : undefined;
+    }
+}
+//# sourceMappingURL=meta-origin.js.map

package/dist/persistence/origin/meta-origin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-origin.js","sourceRoot":"","sources":["../../../src/persistence/origin/meta-origin.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,sCAAsC;AACtC,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,0CAA0C;AAC1C,EAAE;AACF,wEAAwE;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,GAE1B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,OAAO,UAAW,SAAQ,QAAQ;CAAG;AAE3C;;;;;;GAMG;AACH,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IACnD,sGAAsG;IACtG,IAAI,IAAI;QACN,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,gGAAgG;IAChG,IAAI,GAAG;QACL,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC;QACpD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACjD,8DAA8D;IAC9D,IAAI,GAAG;QACL,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAuB,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,CAAC;IAED,gEAAgE;IAChE,IAAI,EAAE;QACJ,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QACjD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED,+EAA+E;IAC/E,IAAI,GAAG;QACL,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;CACF"}

package/dist/persistence/origin/origin-constants.d.ts

@@ -0,0 +1,12 @@
+export declare const ORIGIN_SUBTYPE_PASSTHROUGH = "passthrough";
+export declare const ORIGIN_SUBTYPE_AGGREGATE = "aggregate";
+export declare const ORIGIN_SUBTYPES: readonly ["base", "passthrough", "aggregate"];
+export type OriginSubType = (typeof ORIGIN_SUBTYPES)[number];
+export declare const ORIGIN_PASSTHROUGH_ATTR_FROM = "from";
+export declare const ORIGIN_PASSTHROUGH_ATTR_VIA = "via";
+export declare const ORIGIN_AGGREGATE_ATTR_AGG = "agg";
+export declare const ORIGIN_AGGREGATE_ATTR_OF = "of";
+export declare const ORIGIN_AGGREGATE_ATTR_VIA = "via";
+export declare const AGGREGATE_FUNCTIONS: readonly ["count", "sum", "avg", "min", "max"];
+export type AggregateFunction = (typeof AGGREGATE_FUNCTIONS)[number];
+//# sourceMappingURL=origin-constants.d.ts.map

package/dist/persistence/origin/origin-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin-constants.d.ts","sourceRoot":"","sources":["../../../src/persistence/origin/origin-constants.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,0BAA0B,gBAAgB,CAAC;AACxD,eAAO,MAAM,wBAAwB,cAAgB,CAAC;AAEtD,eAAO,MAAM,eAAe,+CAIlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAG7D,eAAO,MAAM,4BAA4B,SAAS,CAAC;AACnD,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAGlD,eAAO,MAAM,yBAAyB,QAAQ,CAAC;AAC/C,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,yBAAyB,QAAQ,CAAC;AAG/C,eAAO,MAAM,mBAAmB,gDAAiD,CAAC;AAClF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/persistence/origin/origin-constants.js

@@ -0,0 +1,27 @@
+// Origin concern constants — subtypes and attr keys for the origin.* type family.
+import { SUBTYPE_BASE } from "../../shared/base-types.js";
+// ---------------------------------------------------------------------------
+// Origin type — field-level provenance (Project E).
+//
+// Origin is a child of `field`. Says "this field's value comes from there."
+// passthrough: from <Entity.field> [via <relationship path>]
+// aggregate:   <agg> of <Entity.field> via <relationship path>
+//
+// ---------------------------------------------------------------------------
+export const ORIGIN_SUBTYPE_PASSTHROUGH = "passthrough";
+export const ORIGIN_SUBTYPE_AGGREGATE = "aggregate";
+export const ORIGIN_SUBTYPES = [
+    SUBTYPE_BASE,
+    ORIGIN_SUBTYPE_PASSTHROUGH,
+    ORIGIN_SUBTYPE_AGGREGATE,
+];
+// passthrough attrs
+export const ORIGIN_PASSTHROUGH_ATTR_FROM = "from";
+export const ORIGIN_PASSTHROUGH_ATTR_VIA = "via";
+// aggregate attrs
+export const ORIGIN_AGGREGATE_ATTR_AGG = "agg";
+export const ORIGIN_AGGREGATE_ATTR_OF = "of";
+export const ORIGIN_AGGREGATE_ATTR_VIA = "via";
+// aggregate function vocabulary
+export const AGGREGATE_FUNCTIONS = ["count", "sum", "avg", "min", "max"];
+//# sourceMappingURL=origin-constants.js.map

package/dist/persistence/origin/origin-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin-constants.js","sourceRoot":"","sources":["../../../src/persistence/origin/origin-constants.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,8EAA8E;AAC9E,oDAAoD;AACpD,EAAE;AACF,4EAA4E;AAC5E,6DAA6D;AAC7D,+DAA+D;AAC/D,EAAE;AACF,8EAA8E;AAE9E,MAAM,CAAC,MAAM,0BAA0B,GAAG,aAAa,CAAC;AACxD,MAAM,CAAC,MAAM,wBAAwB,GAAK,WAAW,CAAC;AAEtD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY;IACZ,0BAA0B;IAC1B,wBAAwB;CAChB,CAAC;AAGX,oBAAoB;AACpB,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AACnD,MAAM,CAAC,MAAM,2BAA2B,GAAI,KAAK,CAAC;AAElD,kBAAkB;AAClB,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAC/C,MAAM,CAAC,MAAM,wBAAwB,GAAI,IAAI,CAAC;AAC9C,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAE/C,gCAAgC;AAChC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC"}

package/dist/persistence/origin/origin-schema.d.ts

@@ -0,0 +1,4 @@
+import type { AttrSchema } from "../../registry.js";
+/** Attrs per origin subtype. base has none; passthrough and aggregate carry their respective attrs. */
+export declare const ORIGIN_ATTRS_MAP: Map<string, AttrSchema[]>;
+//# sourceMappingURL=origin-schema.d.ts.map

package/dist/persistence/origin/origin-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin-schema.d.ts","sourceRoot":"","sources":["../../../src/persistence/origin/origin-schema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAyDpD,uGAAuG;AACvG,eAAO,MAAM,gBAAgB,2BAI3B,CAAC"}

package/dist/persistence/origin/origin-schema.js

@@ -0,0 +1,49 @@
+// Origin attribute schemas — per-subtype attr inventories for origin types.
+// Consumed by registerCoreTypes().
+import { ATTR_SUBTYPE_STRING } from "../../core/attr/attr-constants.js";
+import { SUBTYPE_BASE } from "../../shared/base-types.js";
+import { ORIGIN_SUBTYPE_PASSTHROUGH, ORIGIN_SUBTYPE_AGGREGATE, ORIGIN_PASSTHROUGH_ATTR_FROM, ORIGIN_PASSTHROUGH_ATTR_VIA, ORIGIN_AGGREGATE_ATTR_AGG, ORIGIN_AGGREGATE_ATTR_OF, ORIGIN_AGGREGATE_ATTR_VIA, AGGREGATE_FUNCTIONS, } from "./origin-constants.js";
+/** Attrs on origin.passthrough — @from is required. */
+const passthroughOriginAttrs = [
+    {
+        name: ORIGIN_PASSTHROUGH_ATTR_FROM,
+        valueType: ATTR_SUBTYPE_STRING,
+        required: true,
+        description: "Dotted Entity.field reference identifying the source value this projection field passes through (e.g. 'Program.title').",
+    },
+    {
+        name: ORIGIN_PASSTHROUGH_ATTR_VIA,
+        valueType: ATTR_SUBTYPE_STRING,
+        required: false,
+        description: "Optional dotted relationship path used to reach the source entity (e.g. 'Program.weeks').",
+    },
+];
+/** Attrs on origin.aggregate — @agg, @of, @via all required. */
+const aggregateOriginAttrs = [
+    {
+        name: ORIGIN_AGGREGATE_ATTR_AGG,
+        valueType: ATTR_SUBTYPE_STRING,
+        required: true,
+        allowedValues: [...AGGREGATE_FUNCTIONS],
+        description: "Aggregate function applied over the relationship path: count, sum, avg, min, or max.",
+    },
+    {
+        name: ORIGIN_AGGREGATE_ATTR_OF,
+        valueType: ATTR_SUBTYPE_STRING,
+        required: true,
+        description: "Dotted Entity.field reference identifying the column being aggregated (e.g. 'Week.durationMinutes').",
+    },
+    {
+        name: ORIGIN_AGGREGATE_ATTR_VIA,
+        valueType: ATTR_SUBTYPE_STRING,
+        required: true,
+        description: "Dotted relationship path from the base entity to the aggregated rows (e.g. 'Program.weeks' or 'Program.weeks.workouts').",
+    },
+];
+/** Attrs per origin subtype. base has none; passthrough and aggregate carry their respective attrs. */
+export const ORIGIN_ATTRS_MAP = new Map([
+    [SUBTYPE_BASE, []],
+    [ORIGIN_SUBTYPE_PASSTHROUGH, [...passthroughOriginAttrs]],
+    [ORIGIN_SUBTYPE_AGGREGATE, [...aggregateOriginAttrs]],
+]);
+//# sourceMappingURL=origin-schema.js.map

package/dist/persistence/origin/origin-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin-schema.js","sourceRoot":"","sources":["../../../src/persistence/origin/origin-schema.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,mCAAmC;AAGnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,uDAAuD;AACvD,MAAM,sBAAsB,GAAiB;IAC3C;QACE,IAAI,EAAE,4BAA4B;QAClC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,yHAAyH;KAC5H;IACD;QACE,IAAI,EAAE,2BAA2B;QACjC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,WAAW,EACT,2FAA2F;KAC9F;CACF,CAAC;AAEF,gEAAgE;AAChE,MAAM,oBAAoB,GAAiB;IACzC;QACE,IAAI,EAAE,yBAAyB;QAC/B,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,IAAI;QACd,aAAa,EAAE,CAAC,GAAG,mBAAmB,CAAC;QACvC,WAAW,EAAE,sFAAsF;KACpG;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,sGAAsG;KACzG;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,0HAA0H;KAC7H;CACF,CAAC;AAEF,uGAAuG;AACvG,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAuB;IAC5D,CAAC,YAAY,EAAE,EAAE,CAAC;IAClB,CAAC,0BAA0B,EAAE,CAAC,GAAG,sBAAsB,CAAC,CAAC;IACzD,CAAC,wBAAwB,EAAE,CAAC,GAAG,oBAAoB,CAAC,CAAC;CACtD,CAAC,CAAC"}

package/dist/persistence/source/meta-source.d.ts

@@ -0,0 +1,18 @@
+import { MetaData } from "../../shared/meta-data.js";
+export declare class MetaSource extends MetaData {
+    /** The SQL table or view name (value of @name attr on the source child). */
+    get sourceName(): string | undefined;
+    /**
+     * True when this source is a `dbTable` (writable).
+     * Explicitly defined rather than derived from `isReadOnly()` so it remains
+     * correct if a third source subtype is added in the future.
+     */
+    isWritable(): boolean;
+    /**
+     * True when this source is a `dbView` (read-only projection).
+     * Explicitly defined rather than derived from `isWritable()` so it remains
+     * correct if a third source subtype is added in the future.
+     */
+    isReadOnly(): boolean;
+}
+//# sourceMappingURL=meta-source.d.ts.map

package/dist/persistence/source/meta-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-source.d.ts","sourceRoot":"","sources":["../../../src/persistence/source/meta-source.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAOrD,qBAAa,UAAW,SAAQ,QAAQ;IACtC,4EAA4E;IAC5E,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAGnC;IAED;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;OAIG;IACH,UAAU,IAAI,OAAO;CAGtB"}

package/dist/persistence/source/meta-source.js

@@ -0,0 +1,31 @@
+// MetaSource — concrete node class for type=source nodes.
+// Declares where an object's data lives (Project E).
+// dbTable / dbView source subtypes declare the SQL table or view name.
+//
+// Extends MetaData directly: no model wrapper, no metaOf() indirection.
+import { MetaData } from "../../shared/meta-data.js";
+import { SOURCE_ATTR_NAME, SOURCE_SUBTYPE_DB_TABLE, SOURCE_SUBTYPE_DB_VIEW, } from "./source-constants.js";
+export class MetaSource extends MetaData {
+    /** The SQL table or view name (value of @name attr on the source child). */
+    get sourceName() {
+        const v = this.ownAttr(SOURCE_ATTR_NAME);
+        return typeof v === "string" ? v : undefined;
+    }
+    /**
+     * True when this source is a `dbTable` (writable).
+     * Explicitly defined rather than derived from `isReadOnly()` so it remains
+     * correct if a third source subtype is added in the future.
+     */
+    isWritable() {
+        return this.subType === SOURCE_SUBTYPE_DB_TABLE;
+    }
+    /**
+     * True when this source is a `dbView` (read-only projection).
+     * Explicitly defined rather than derived from `isWritable()` so it remains
+     * correct if a third source subtype is added in the future.
+     */
+    isReadOnly() {
+        return this.subType === SOURCE_SUBTYPE_DB_VIEW;
+    }
+}
+//# sourceMappingURL=meta-source.js.map

package/dist/persistence/source/meta-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-source.js","sourceRoot":"","sources":["../../../src/persistence/source/meta-source.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,qDAAqD;AACrD,uEAAuE;AACvE,EAAE;AACF,wEAAwE;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,OAAO,UAAW,SAAQ,QAAQ;IACtC,4EAA4E;IAC5E,IAAI,UAAU;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACzC,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,KAAK,uBAAuB,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,KAAK,sBAAsB,CAAC;IACjD,CAAC;CACF"}

package/dist/persistence/source/source-constants.d.ts

@@ -0,0 +1,16 @@
+export declare const SOURCE_SUBTYPE_DB_TABLE = "dbTable";
+export declare const SOURCE_SUBTYPE_DB_VIEW = "dbView";
+export declare const SOURCE_SUBTYPES: readonly ["base", "dbTable", "dbView"];
+export type SourceSubType = (typeof SOURCE_SUBTYPES)[number];
+export declare const SOURCE_DB_TABLE_ATTR_NAME = "name";
+export declare const SOURCE_DB_VIEW_ATTR_NAME = "name";
+/** Shared @name attr key for MetaSource (covers both dbTable and dbView). Use this
+ *  in generic source accessors instead of the subtype-specific aliases above. */
+export declare const SOURCE_ATTR_NAME = "name";
+/** Optional DB schema attr on source[dbTable] / source[dbView]. Postgres uses
+ *  this to namespace tables/views. SQLite has no schema concept and rejects
+ *  any non-default value. Default for Postgres: "public". */
+export declare const SOURCE_ATTR_SCHEMA = "schema";
+/** Default Postgres schema when @schema is omitted from a source. */
+export declare const DEFAULT_DB_SCHEMA_POSTGRES = "public";
+//# sourceMappingURL=source-constants.d.ts.map

package/dist/persistence/source/source-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-constants.d.ts","sourceRoot":"","sources":["../../../src/persistence/source/source-constants.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,uBAAuB,YAAY,CAAC;AACjD,eAAO,MAAM,sBAAsB,WAAY,CAAC;AAEhD,eAAO,MAAM,eAAe,wCAIlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAI7D,eAAO,MAAM,yBAAyB,SAAS,CAAC;AAChD,eAAO,MAAM,wBAAwB,SAAU,CAAC;AAChD;iFACiF;AACjF,eAAO,MAAM,gBAAgB,SAAkB,CAAC;AAEhD;;6DAE6D;AAC7D,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,qEAAqE;AACrE,eAAO,MAAM,0BAA0B,WAAW,CAAC"}

package/dist/persistence/source/source-constants.js

@@ -0,0 +1,28 @@
+// Source concern constants — subtypes and attr keys for the source.* type family.
+import { SUBTYPE_BASE } from "../../shared/base-types.js";
+// ---------------------------------------------------------------------------
+// Source type — declares where an object's data lives (Project E).
+// dbTable / dbView ship in v1. Multiple sources per object are allowed
+// and meaningful (write-through CQRS: dbTable for writes + dbView for reads).
+// ---------------------------------------------------------------------------
+export const SOURCE_SUBTYPE_DB_TABLE = "dbTable";
+export const SOURCE_SUBTYPE_DB_VIEW = "dbView";
+export const SOURCE_SUBTYPES = [
+    SUBTYPE_BASE,
+    SOURCE_SUBTYPE_DB_TABLE,
+    SOURCE_SUBTYPE_DB_VIEW,
+];
+// Source attrs — both dbTable and dbView use @name for the SQL identifier
+// (table name and view name respectively). Same key for ergonomic consistency.
+export const SOURCE_DB_TABLE_ATTR_NAME = "name";
+export const SOURCE_DB_VIEW_ATTR_NAME = "name";
+/** Shared @name attr key for MetaSource (covers both dbTable and dbView). Use this
+ *  in generic source accessors instead of the subtype-specific aliases above. */
+export const SOURCE_ATTR_NAME = "name";
+/** Optional DB schema attr on source[dbTable] / source[dbView]. Postgres uses
+ *  this to namespace tables/views. SQLite has no schema concept and rejects
+ *  any non-default value. Default for Postgres: "public". */
+export const SOURCE_ATTR_SCHEMA = "schema";
+/** Default Postgres schema when @schema is omitted from a source. */
+export const DEFAULT_DB_SCHEMA_POSTGRES = "public";
+//# sourceMappingURL=source-constants.js.map

package/dist/persistence/source/source-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-constants.js","sourceRoot":"","sources":["../../../src/persistence/source/source-constants.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,8EAA8E;AAC9E,mEAAmE;AACnE,uEAAuE;AACvE,8EAA8E;AAC9E,8EAA8E;AAE9E,MAAM,CAAC,MAAM,uBAAuB,GAAG,SAAS,CAAC;AACjD,MAAM,CAAC,MAAM,sBAAsB,GAAI,QAAQ,CAAC;AAEhD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY;IACZ,uBAAuB;IACvB,sBAAsB;CACd,CAAC;AAGX,0EAA0E;AAC1E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAChD,MAAM,CAAC,MAAM,wBAAwB,GAAI,MAAM,CAAC;AAChD;iFACiF;AACjF,MAAM,CAAC,MAAM,gBAAgB,GAAY,MAAM,CAAC;AAEhD;;6DAE6D;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE3C,qEAAqE;AACrE,MAAM,CAAC,MAAM,0BAA0B,GAAG,QAAQ,CAAC"}

package/dist/presentation/layout/layout-constants.d.ts

@@ -0,0 +1,10 @@
+export declare const LAYOUT_SUBTYPE_DATA_GRID = "dataGrid";
+export declare const LAYOUT_SUBTYPES: readonly ["base", "dataGrid"];
+export type LayoutSubType = (typeof LAYOUT_SUBTYPES)[number];
+export declare const LAYOUT_DATA_GRID_ATTR_PAGE_SIZE = "pageSize";
+export declare const LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD = "defaultSortField";
+export declare const LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER = "defaultSortOrder";
+export declare const LAYOUT_DATA_GRID_ATTR_FILTERABLE = "filterable";
+export declare const LAYOUT_DATA_GRID_ATTR_FILTER = "filter";
+export declare const LAYOUT_DATA_GRID_ATTR_COLUMNS = "columns";
+//# sourceMappingURL=layout-constants.d.ts.map

package/dist/presentation/layout/layout-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-constants.d.ts","sourceRoot":"","sources":["../../../src/presentation/layout/layout-constants.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,wBAAwB,aAAa,CAAC;AAEnD,eAAO,MAAM,eAAe,+BAGlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAM7D,eAAO,MAAM,+BAA+B,aAAsB,CAAC;AACnE,eAAO,MAAM,wCAAwC,qBAAqB,CAAC;AAC3E,eAAO,MAAM,wCAAwC,qBAAqB,CAAC;AAC3E,eAAO,MAAM,gCAAgC,eAAuB,CAAC;AACrE,eAAO,MAAM,4BAA4B,WAAuB,CAAC;AACjE,eAAO,MAAM,6BAA6B,YAAuB,CAAC"}

package/dist/presentation/layout/layout-constants.js

@@ -0,0 +1,21 @@
+// Layout concern constants — subtypes and dataGrid attr keys.
+import { SUBTYPE_BASE } from "../../shared/base-types.js";
+// ---------------------------------------------------------------------------
+// Layout type — object-level UI surfaces (replaces Project B's object-attached
+// data-grid view subtype; views are now strictly field-level per Java parity).
+// ---------------------------------------------------------------------------
+export const LAYOUT_SUBTYPE_DATA_GRID = "dataGrid";
+export const LAYOUT_SUBTYPES = [
+    SUBTYPE_BASE,
+    LAYOUT_SUBTYPE_DATA_GRID,
+];
+// ---------------------------------------------------------------------------
+// Layout attrs (on dataGrid layouts)
+// ---------------------------------------------------------------------------
+export const LAYOUT_DATA_GRID_ATTR_PAGE_SIZE = "pageSize";
+export const LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD = "defaultSortField";
+export const LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER = "defaultSortOrder";
+export const LAYOUT_DATA_GRID_ATTR_FILTERABLE = "filterable";
+export const LAYOUT_DATA_GRID_ATTR_FILTER = "filter";
+export const LAYOUT_DATA_GRID_ATTR_COLUMNS = "columns";
+//# sourceMappingURL=layout-constants.js.map

package/dist/presentation/layout/layout-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-constants.js","sourceRoot":"","sources":["../../../src/presentation/layout/layout-constants.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,8EAA8E;AAE9E,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAC;AAEnD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY;IACZ,wBAAwB;CAChB,CAAC;AAGX,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,+BAA+B,GAAY,UAAU,CAAC;AACnE,MAAM,CAAC,MAAM,wCAAwC,GAAG,kBAAkB,CAAC;AAC3E,MAAM,CAAC,MAAM,wCAAwC,GAAG,kBAAkB,CAAC;AAC3E,MAAM,CAAC,MAAM,gCAAgC,GAAW,YAAY,CAAC;AACrE,MAAM,CAAC,MAAM,4BAA4B,GAAe,QAAQ,CAAC;AACjE,MAAM,CAAC,MAAM,6BAA6B,GAAc,SAAS,CAAC"}

package/dist/presentation/layout/layout-schema.d.ts

@@ -0,0 +1,4 @@
+import type { AttrSchema } from "../../registry.js";
+/** Attrs on layout.dataGrid. */
+export declare const dataGridLayoutAttrs: AttrSchema[];
+//# sourceMappingURL=layout-schema.d.ts.map

package/dist/presentation/layout/layout-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-schema.d.ts","sourceRoot":"","sources":["../../../src/presentation/layout/layout-schema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAkBpD,gCAAgC;AAChC,eAAO,MAAM,mBAAmB,EAAE,UAAU,EAuC3C,CAAC"}

package/dist/presentation/layout/layout-schema.js

@@ -0,0 +1,46 @@
+// Layout attribute schemas — attrs for layout subtypes (e.g. dataGrid).
+// Consumed by registerCoreTypes().
+import { ATTR_SUBTYPE_INT, ATTR_SUBTYPE_STRING, ATTR_SUBTYPE_BOOLEAN, ATTR_SUBTYPE_FILTER, ATTR_SUBTYPE_STRINGARRAY, } from "../../core/attr/attr-constants.js";
+import { SORT_ORDER_VALUES } from "../../core/query/query-constants.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 "./layout-constants.js";
+/** Attrs on layout.dataGrid. */
+export const dataGridLayoutAttrs = [
+    {
+        name: LAYOUT_DATA_GRID_ATTR_PAGE_SIZE,
+        valueType: ATTR_SUBTYPE_INT,
+        required: false,
+        description: "Number of rows per page in the generated data grid.",
+    },
+    {
+        name: LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_FIELD,
+        valueType: ATTR_SUBTYPE_STRING,
+        required: false,
+        description: "Field name the grid is sorted by on initial render. Must reference an actual field on the entity.",
+    },
+    {
+        name: LAYOUT_DATA_GRID_ATTR_DEFAULT_SORT_ORDER,
+        valueType: ATTR_SUBTYPE_STRING,
+        required: false,
+        allowedValues: [...SORT_ORDER_VALUES],
+        description: "Initial sort direction for the default sort field: 'asc' or 'desc'.",
+    },
+    {
+        name: LAYOUT_DATA_GRID_ATTR_FILTERABLE,
+        valueType: ATTR_SUBTYPE_BOOLEAN,
+        required: false,
+        description: "When true, the generated grid exposes column filtering UI.",
+    },
+    {
+        name: LAYOUT_DATA_GRID_ATTR_FILTER,
+        valueType: ATTR_SUBTYPE_FILTER,
+        required: false,
+        description: "Structured preset filter object applied to the grid at the metadata level. Desugared to canonical { field: { op: value } } form at parse time.",
+    },
+    {
+        name: LAYOUT_DATA_GRID_ATTR_COLUMNS,
+        valueType: ATTR_SUBTYPE_STRINGARRAY,
+        required: false,
+        description: "Flat ordered list of field names to display as grid columns.",
+    },
+];
+//# sourceMappingURL=layout-schema.js.map

package/dist/presentation/layout/layout-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-schema.js","sourceRoot":"","sources":["../../../src/presentation/layout/layout-schema.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,mCAAmC;AAGnC,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EACL,+BAA+B,EAC/B,wCAAwC,EACxC,wCAAwC,EACxC,gCAAgC,EAChC,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAE/B,gCAAgC;AAChC,MAAM,CAAC,MAAM,mBAAmB,GAAiB;IAC/C;QACE,IAAI,EAAE,+BAA+B;QACrC,SAAS,EAAE,gBAAgB;QAC3B,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,qDAAqD;KACnE;IACD;QACE,IAAI,EAAE,wCAAwC;QAC9C,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,WAAW,EACT,mGAAmG;KACtG;IACD;QACE,IAAI,EAAE,wCAAwC;QAC9C,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,aAAa,EAAE,CAAC,GAAG,iBAAiB,CAAC;QACrC,WAAW,EAAE,qEAAqE;KACnF;IACD;QACE,IAAI,EAAE,gCAAgC;QACtC,SAAS,EAAE,oBAAoB;QAC/B,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,4DAA4D;KAC1E;IACD;QACE,IAAI,EAAE,4BAA4B;QAClC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,gJAAgJ;KAC9J;IACD;QACE,IAAI,EAAE,6BAA6B;QACnC,SAAS,EAAE,wBAAwB;QACnC,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,8DAA8D;KAC5E;CACF,CAAC"}

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

@@ -0,0 +1,23 @@
+import { MetaData } from "../../shared/meta-data.js";
+import type { SortOrderValue } from "../../core/query/query-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;
+    /** The desugared preset filter object for the dataGrid layout, or undefined. */
+    get filter(): Record<string, unknown> | 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/presentation/layout/meta-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-layout.d.ts","sourceRoot":"","sources":["../../../src/presentation/layout/meta-layout.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AASrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E,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,gFAAgF;IAChF,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAKhD;IAED,oFAAoF;IACpF,IAAI,OAAO,IAAI,MAAM,EAAE,CAGtB;CACF"}

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

@@ -0,0 +1,47 @@
+// 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 "../../shared/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 "./layout-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;
+    }
+    /** The desugared preset filter object for the dataGrid layout, or undefined. */
+    get filter() {
+        const v = this.ownAttr(LAYOUT_DATA_GRID_ATTR_FILTER);
+        return typeof v === "object" && v !== null && !Array.isArray(v)
+            ? 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