@metaobjectsdev/metadata 0.9.0 → 0.10.0

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

@@ -2,6 +2,7 @@
 // not the core metamodel.
 import { ATTR_SUBTYPE_STRING, ATTR_SUBTYPE_BOOLEAN, } from "../../core/attr/attr-constants.js";
 import { FIELD_ATTR_COLUMN, FIELD_ATTR_DB_INDEXED, FIELD_ATTR_DB_COLUMN_TYPE, DB_COLUMN_TYPE_VALUES, } from "./db-constants.js";
+import { FIELD_ATTR_STORAGE, FIELD_ATTR_AUTO_SET, STORAGE_VALUES, AUTO_SET_VALUES, } from "../../core/field/field-constants.js";
 /** `@column` — column-name override on every field subtype (source.rdb). */
 export const columnSchema = {
     name: FIELD_ATTR_COLUMN,
@@ -32,4 +33,30 @@ export const dbColumnTypeSchema = {
         "field subtype (uuid/jsonb on field.string, timestamp_with_tz on field.timestamp). " +
         "The logical field type and its native binding are unchanged.",
 };
+/**
+ * `@storage` — physical-storage strategy for an object-typed field (set with
+ * @objectRef). Re-homed out of the core field definition by FR-033 S1-field-A
+ * (it is a physical-storage concern). Still on every field subtype at this step;
+ * step B narrows it to field.object. Description copied VERBATIM from field.json.
+ */
+export const storageSchema = {
+    name: FIELD_ATTR_STORAGE,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    allowedValues: [...STORAGE_VALUES],
+    description: 'Storage strategy for an object-typed field (set with @objectRef). "flattened" expands the nested value into prefixed columns on the parent table. "jsonb" stores the structured value in a single jsonb column (supports isArray=true for arrays of values). "subdocument" is a hint for document-store codegen targets and emits no Postgres column.',
+};
+/**
+ * `@autoSet` — auto-set semantics for timestamp-like fields. Re-homed out of the
+ * core field definition by FR-033 S1-field-A (it is a DB-write-time concern).
+ * Still on every field subtype at this step; step B narrows it to temporal
+ * subtypes. Description copied VERBATIM from field.json.
+ */
+export const autoSetSchema = {
+    name: FIELD_ATTR_AUTO_SET,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    allowedValues: [...AUTO_SET_VALUES],
+    description: "Auto-set semantics for timestamp-like fields: 'onCreate' stamps on insert, 'onUpdate' stamps on every write.",
+};
 //# sourceMappingURL=db-schema.js.map

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

@@ -1 +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,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,4EAA4E;AAC5E,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,IAAI,EAAE,iBAAiB;IACvB,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,4GAA4G;CAC/G,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;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,IAAI,EAAE,yBAAyB;IAC/B,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,6EAA6E;QAC7E,GAAG,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,0CAA0C;QAC9E,oFAAoF;QACpF,8DAA8D;CACjE,CAAC"}
+{"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,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,GAChB,MAAM,qCAAqC,CAAC;AAE7C,4EAA4E;AAC5E,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,IAAI,EAAE,iBAAiB;IACvB,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,4GAA4G;CAC/G,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;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,IAAI,EAAE,yBAAyB;IAC/B,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,6EAA6E;QAC7E,GAAG,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,0CAA0C;QAC9E,oFAAoF;QACpF,8DAA8D;CACjE,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAe;IACvC,IAAI,EAAE,kBAAkB;IACxB,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,aAAa,EAAE,CAAC,GAAG,cAAc,CAAC;IAClC,WAAW,EACT,uVAAuV;CAC1V,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAe;IACvC,IAAI,EAAE,mBAAmB;IACzB,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,aAAa,EAAE,CAAC,GAAG,eAAe,CAAC;IACnC,WAAW,EACT,8GAA8G;CACjH,CAAC"}

package/dist/persistence/origin/origin-definition.embedded.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderDefinition } from "../../provider-data.js";
+export declare const ORIGIN_DEFINITION: ProviderDefinition;
+//# sourceMappingURL=origin-definition.embedded.d.ts.map

package/dist/persistence/origin/origin-definition.embedded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin-definition.embedded.d.ts","sourceRoot":"","sources":["../../../src/persistence/origin/origin-definition.embedded.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,eAAO,MAAM,iBAAiB,EAAE,kBAsF/B,CAAC"}

package/dist/persistence/origin/origin-definition.embedded.js

@@ -0,0 +1,88 @@
+export const ORIGIN_DEFINITION = {
+    "provider": "metaobjects-core-types",
+    "types": [
+        {
+            "type": "origin",
+            "subType": "base",
+            "description": "Abstract base origin — the shared root subtype for field-level provenance. A field carrying any origin.* is derived ⇒ read-only wherever it lives. The base carries no attrs of its own; concrete subtypes add their provenance attrs."
+        },
+        {
+            "type": "origin",
+            "subType": "passthrough",
+            "description": "A cross-entity field reference: this projection field passes a source entity's value straight through (@from), optionally reached via a relationship path (@via).",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "from",
+                    "min": 1,
+                    "max": 1,
+                    "description": "Dotted Entity.field reference identifying the source value this projection field passes through (e.g. 'Program.title')."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "via",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Optional dotted relationship path used to reach the source entity (e.g. 'Program.weeks')."
+                }
+            ]
+        },
+        {
+            "type": "origin",
+            "subType": "aggregate",
+            "description": "A count/sum/avg/min/max (@agg) computed over a column (@of) reached along a relationship path (@via) from the base entity.",
+            "rules": "@via may be omitted only when exactly one single-hop relationship leads from the base entity to the @of entity (single-hop-unique inference; FR-024, ADR-0029). Multi-hop paths must always be stated explicitly.",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "agg",
+                    "min": 1,
+                    "max": 1,
+                    "allowedValues": [
+                        "count",
+                        "sum",
+                        "avg",
+                        "min",
+                        "max"
+                    ],
+                    "description": "Aggregate function applied over the relationship path: count, sum, avg, min, or max."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "of",
+                    "min": 1,
+                    "max": 1,
+                    "description": "Dotted Entity.field reference identifying the column being aggregated (e.g. 'Week.durationMinutes')."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "via",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Dotted relationship path from the base entity to the aggregated rows (e.g. 'Program.weeks' or 'Program.weeks.workouts'). May be omitted only when exactly one single-hop relationship leads from the base entity to the @of entity (FR-024, ADR-0029)."
+                }
+            ]
+        },
+        {
+            "type": "origin",
+            "subType": "collection",
+            "description": "A relationship-derived array of nested view-objects: walks @via to produce the collection (e.g. 'Author.posts'), or a wildcard selector for a package-spanning collection.",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "via",
+                    "min": 1,
+                    "max": 1,
+                    "description": "Dotted relationship path the collection walks to produce an array of nested view-objects (e.g. 'Author.posts'), or a wildcard selector for a package-spanning collection (e.g. '*.User')."
+                }
+            ]
+        }
+    ]
+};
+//# sourceMappingURL=origin-definition.embedded.js.map

package/dist/persistence/origin/origin-definition.embedded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"origin-definition.embedded.js","sourceRoot":"","sources":["../../../src/persistence/origin/origin-definition.embedded.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,iBAAiB,GAAuB;IACnD,UAAU,EAAE,wBAAwB;IACpC,OAAO,EAAE;QACP;YACE,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,MAAM;YACjB,aAAa,EAAE,wOAAwO;SACxP;QACD;YACE,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,aAAa;YACxB,aAAa,EAAE,mKAAmK;YAClL,UAAU,EAAE;gBACV;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,MAAM;oBACd,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,yHAAyH;iBACzI;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,KAAK;oBACb,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,2FAA2F;iBAC3G;aACF;SACF;QACD;YACE,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,WAAW;YACtB,aAAa,EAAE,4HAA4H;YAC3I,OAAO,EAAE,mNAAmN;YAC5N,UAAU,EAAE;gBACV;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,KAAK;oBACb,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,eAAe,EAAE;wBACf,OAAO;wBACP,KAAK;wBACL,KAAK;wBACL,KAAK;wBACL,KAAK;qBACN;oBACD,aAAa,EAAE,sFAAsF;iBACtG;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,IAAI;oBACZ,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,sGAAsG;iBACtH;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,KAAK;oBACb,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,wPAAwP;iBACxQ;aACF;SACF;QACD;YACE,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,YAAY;YACvB,aAAa,EAAE,4KAA4K;YAC3L,UAAU,EAAE;gBACV;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,KAAK;oBACb,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,2LAA2L;iBAC3M;aACF;SACF;KACF;CACF,CAAC"}

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

@@ -1 +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;AAsEpD,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,2BAK3B,CAAC"}
+{"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;AA0EpD,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,2BAK3B,CAAC"}

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

@@ -18,7 +18,11 @@ const passthroughOriginAttrs = [
         description: "Optional dotted relationship path used to reach the source entity (e.g. 'Program.weeks').",
     },
 ];
-/** Attrs on origin.aggregate — @agg, @of, @via all required. */
+/** Attrs on origin.aggregate — @agg and @of required; @via omissible since
+ *  FR-024 (ADR-0029 decision 5: single-hop-unique inference from the base
+ *  entity). NOTE: the cross-port registry manifest still records @via as
+ *  required until the FR-024 Phase-E atomic flip — see
+ *  FR024_PENDING_REQUIRED_OVERRIDES in registry-manifest-exclusions.ts. */
 const aggregateOriginAttrs = [
     {
         name: ORIGIN_AGGREGATE_ATTR_AGG,
@@ -36,8 +40,8 @@ const aggregateOriginAttrs = [
     {
         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').",
+        required: false,
+        description: "Dotted relationship path from the base entity to the aggregated rows (e.g. 'Program.weeks' or 'Program.weeks.workouts'). May be omitted only when exactly one single-hop relationship leads from the base entity to the @of entity (FR-024, ADR-0029).",
     },
 ];
 /** Attrs on origin.collection — @via (the relationship path) is required. */

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

@@ -1 +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,yBAAyB,EACzB,4BAA4B,EAC5B,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,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,6EAA6E;AAC7E,MAAM,qBAAqB,GAAiB;IAC1C;QACE,IAAI,EAAE,0BAA0B;QAChC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,2LAA2L;KAC9L;CACF,CAAC;AAEF,wFAAwF;AACxF,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;IACrD,CAAC,yBAAyB,EAAE,CAAC,GAAG,qBAAqB,CAAC,CAAC;CACxD,CAAC,CAAC"}
+{"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,yBAAyB,EACzB,4BAA4B,EAC5B,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,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;;;;2EAI2E;AAC3E,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,KAAK;QACf,WAAW,EACT,wPAAwP;KAC3P;CACF,CAAC;AAEF,6EAA6E;AAC7E,MAAM,qBAAqB,GAAiB;IAC1C;QACE,IAAI,EAAE,0BAA0B;QAChC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,IAAI;QACd,WAAW,EACT,2LAA2L;KAC9L;CACF,CAAC;AAEF,wFAAwF;AACxF,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;IACrD,CAAC,yBAAyB,EAAE,CAAC,GAAG,qBAAqB,CAAC,CAAC;CACxD,CAAC,CAAC"}

package/dist/persistence/source/source-definition.embedded.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderDefinition } from "../../provider-data.js";
+export declare const SOURCE_DEFINITION: ProviderDefinition;
+//# sourceMappingURL=source-definition.embedded.d.ts.map

package/dist/persistence/source/source-definition.embedded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-definition.embedded.d.ts","sourceRoot":"","sources":["../../../src/persistence/source/source-definition.embedded.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,eAAO,MAAM,iBAAiB,EAAE,kBAe/B,CAAC"}

package/dist/persistence/source/source-definition.embedded.js

@@ -0,0 +1,17 @@
+export const SOURCE_DEFINITION = {
+    "provider": "metaobjects-core-types",
+    "types": [
+        {
+            "type": "source",
+            "subType": "base",
+            "description": "Abstract base source — the shared root subtype for declaring where an object's data lives (Project E). The base carries no attrs of its own; the concrete paradigm subtype (rdb) carries the physical-storage attrs, which are contributed by the db domain provider."
+        },
+        {
+            "type": "source",
+            "subType": "rdb",
+            "description": "The relational-database paradigm source (ADR-0007): binds an object to a physical relational object. Its physical name is the @table attr (not the structural `name`), and read-only-ness is DERIVED from @kind — table is writable; view, materializedView, storedProc, and tableFunction are read-only. The @table/@kind/@role/@schema/@parameterRef attrs are contributed by the db domain provider, not by core-types.",
+            "rules": "ADR-0007: source declares where an object's data lives; rdb is the relational paradigm subtype. An object may declare multiple sources, distinguished by @role, with exactly ONE @role: \"primary\" per object (write-through CQRS: a writable table for writes plus a read-only view for reads). The physical name is the @table attr (or the @kind-matching alias), never the structural `name`. Read-only-ness is derived from @kind (table → writable; view / materializedView / storedProc / tableFunction → read-only). The pre-v2 dbTable / dbView subtypes are retired."
+        }
+    ]
+};
+//# sourceMappingURL=source-definition.embedded.js.map

package/dist/persistence/source/source-definition.embedded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-definition.embedded.js","sourceRoot":"","sources":["../../../src/persistence/source/source-definition.embedded.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,iBAAiB,GAAuB;IACnD,UAAU,EAAE,wBAAwB;IACpC,OAAO,EAAE;QACP;YACE,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,MAAM;YACjB,aAAa,EAAE,uQAAuQ;SACvR;QACD;YACE,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,KAAK;YAChB,aAAa,EAAE,4ZAA4Z;YAC3a,OAAO,EAAE,ijBAAijB;SAC3jB;KACF;CACF,CAAC"}

package/dist/persistence/source/validate-source-parameter-ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-source-parameter-ref.d.ts","sourceRoot":"","sources":["../../../src/persistence/source/validate-source-parameter-ref.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA6B7C,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,EAAE,CA+FvE"}
+{"version":3,"file":"validate-source-parameter-ref.d.ts","sourceRoot":"","sources":["../../../src/persistence/source/validate-source-parameter-ref.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA6B7C,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,EAAE,CAqGvE"}

package/dist/persistence/source/validate-source-parameter-ref.js

@@ -27,7 +27,12 @@ const CALLABLE_KINDS = new Set([
 ]);
 export function validateSourceParameterRef(root) {
     const errors = [];
-    // Pre-index every object by name AND fqn so resolution costs O(1) per source.
+    // Pre-index every object by name, fqn AND effective FQN resolution key so
+    // resolution costs O(1) per source. FR-032 — @parameterRef is FQN-qualified
+    // after the desugar/sweep, but objects keep a BARE fqn() per the FR5d
+    // contract, so the FQN form `<package | fileDefaultPackage>::<name>` only
+    // matches via resolutionKey() (these fixtures declare package at metadata.root
+    // only, so obj.package is undefined and the file-default must be folded in).
     const objectIndex = new Map();
     for (const obj of root.ownChildren().filter((c) => c.type === TYPE_OBJECT)) {
         objectIndex.set(obj.name, obj);
@@ -35,6 +40,7 @@ export function validateSourceParameterRef(root) {
             ? `${obj.package}${PACKAGE_SEPARATOR}${obj.name}`
             : obj.name;
         objectIndex.set(fqn, obj);
+        objectIndex.set(obj.resolutionKey(), obj);
     }
     for (const obj of root.ownChildren().filter((c) => c.type === TYPE_OBJECT)) {
         for (const source of obj.ownChildren().filter((c) => c.type === TYPE_SOURCE && c.subType === SOURCE_SUBTYPE_RDB && c instanceof MetaSource)) {

package/dist/persistence/source/validate-source-parameter-ref.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-source-parameter-ref.js","sourceRoot":"","sources":["../../../src/persistence/source/validate-source-parameter-ref.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validate-source-parameter-ref.js","sourceRoot":"","sources":["../../../src/persistence/source/validate-source-parameter-ref.ts"],"names":[],"mappings":"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"}

package/dist/persistence/source/validate-source-roles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-source-roles.d.ts","sourceRoot":"","sources":["../../../src/persistence/source/validate-source-roles.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAK7C;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,EAAE,CA+BhE"}
+{"version":3,"file":"validate-source-roles.d.ts","sourceRoot":"","sources":["../../../src/persistence/source/validate-source-roles.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM7C;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,EAAE,CAmDhE"}

package/dist/persistence/source/validate-source-roles.js

@@ -7,7 +7,8 @@
 import { ParseError } from "../../errors.js";
 import { TYPE_OBJECT, TYPE_SOURCE } from "../../shared/base-types.js";
 import { MetaSource } from "./meta-source.js";
-import { SOURCE_ROLE_PRIMARY } from "./source-constants.js";
+import { SOURCE_ROLE_PRIMARY, SOURCE_READ_ONLY_KINDS } from "./source-constants.js";
+import { OBJECT_SUBTYPE_ENTITY } from "../../core/object/object-constants.js";
 /**
  * Walks every object in the root and enforces the one-primary rule for
  * multi-source objects:
@@ -32,6 +33,20 @@ export function validateSourceRoles(root) {
         else if (primaryCount > 1) {
             errors.push(new ParseError(`object "${obj.name}" declares ${primaryCount} sources with role "${SOURCE_ROLE_PRIMARY}"; exactly one is required`, { code: "ERR_SOURCE_MULTIPLE_PRIMARY", source: obj.source }));
         }
+        // FR-024 (ADR-0028) — THE HARD CUTOVER: an entity's PRIMARY source must be
+        // writable; read-only kinds (view/materializedView/storedProc/tableFunction)
+        // are legal only in non-primary (read) roles. The pre-FR-024 spellings
+        // (view-primary "projection" entities, proc-result-as-entity) are removed
+        // outright — a derived read model is an `object.projection`.
+        if (obj.subType === OBJECT_SUBTYPE_ENTITY) {
+            for (const s of sources) {
+                if (s.role === SOURCE_ROLE_PRIMARY && SOURCE_READ_ONLY_KINDS.has(s.effectiveKind)) {
+                    errors.push(new ParseError(`entity "${obj.name}" has a primary source of read-only kind "${s.effectiveKind}" — ` +
+                        `read-only kinds are legal only in non-primary roles; a derived read model ` +
+                        `is an object.projection (FR-024, ADR-0028)`, { code: "ERR_ENTITY_PRIMARY_SOURCE_READONLY", source: s.source }));
+                }
+            }
+        }
     }
     return errors;
 }

package/dist/persistence/source/validate-source-roles.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-source-roles.js","sourceRoot":"","sources":["../../../src/persistence/source/validate-source-roles.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,+EAA+E;AAC/E,iEAAiE;AACjE,4EAA4E;AAC5E,0EAA0E;AAG1E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAc;IAChD,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,CAAC;QAC3E,MAAM,OAAO,GAAG,GAAG;aAChB,WAAW,EAAE;aACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;aACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAe,CAAC,CAAC;QAE/B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEnC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,MAAM,CAAC;QAElF,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CACT,IAAI,UAAU,CACZ,WAAW,GAAG,CAAC,IAAI,cAAc,OAAO,CAAC,MAAM,iCAAiC,mBAAmB,GAAG,EACtG,EAAE,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CACtD,CACF,CAAC;QACJ,CAAC;aAAM,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CACT,IAAI,UAAU,CACZ,WAAW,GAAG,CAAC,IAAI,cAAc,YAAY,uBAAuB,mBAAmB,4BAA4B,EACnH,EAAE,IAAI,EAAE,6BAA6B,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAC5D,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"validate-source-roles.js","sourceRoot":"","sources":["../../../src/persistence/source/validate-source-roles.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,+EAA+E;AAC/E,iEAAiE;AACjE,4EAA4E;AAC5E,0EAA0E;AAG1E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAc;IAChD,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,CAAC;QAC3E,MAAM,OAAO,GAAG,GAAG;aAChB,WAAW,EAAE;aACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;aACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAe,CAAC,CAAC;QAE/B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEnC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,MAAM,CAAC;QAElF,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CACT,IAAI,UAAU,CACZ,WAAW,GAAG,CAAC,IAAI,cAAc,OAAO,CAAC,MAAM,iCAAiC,mBAAmB,GAAG,EACtG,EAAE,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CACtD,CACF,CAAC;QACJ,CAAC;aAAM,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CACT,IAAI,UAAU,CACZ,WAAW,GAAG,CAAC,IAAI,cAAc,YAAY,uBAAuB,mBAAmB,4BAA4B,EACnH,EAAE,IAAI,EAAE,6BAA6B,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAC5D,CACF,CAAC;QACJ,CAAC;QAED,2EAA2E;QAC3E,6EAA6E;QAC7E,uEAAuE;QACvE,0EAA0E;QAC1E,6DAA6D;QAC7D,IAAI,GAAG,CAAC,OAAO,KAAK,qBAAqB,EAAE,CAAC;YAC1C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC,IAAI,KAAK,mBAAmB,IAAI,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC;oBAClF,MAAM,CAAC,IAAI,CACT,IAAI,UAAU,CACZ,WAAW,GAAG,CAAC,IAAI,6CAA6C,CAAC,CAAC,aAAa,MAAM;wBACnF,4EAA4E;wBAC5E,4CAA4C,EAC9C,EAAE,IAAI,EAAE,oCAAoC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CACjE,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/presentation/layout/layout-definition.embedded.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderDefinition } from "../../provider-data.js";
+export declare const LAYOUT_DEFINITION: ProviderDefinition;
+//# sourceMappingURL=layout-definition.embedded.d.ts.map

package/dist/presentation/layout/layout-definition.embedded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-definition.embedded.d.ts","sourceRoot":"","sources":["../../../src/presentation/layout/layout-definition.embedded.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,eAAO,MAAM,iBAAiB,EAAE,kBAc/B,CAAC"}

package/dist/presentation/layout/layout-definition.embedded.js

@@ -0,0 +1,16 @@
+export const LAYOUT_DEFINITION = {
+    "provider": "metaobjects-core-types",
+    "types": [
+        {
+            "type": "layout",
+            "subType": "base",
+            "description": "Abstract base layout — the shared root subtype for object-level UI surfaces. A layout attaches a presentation concern (grids, forms, tabs, cards) to an object. The base carries no attrs of its own; concrete subtypes add their presentation attrs."
+        },
+        {
+            "type": "layout",
+            "subType": "dataGrid",
+            "description": "A metadata-driven data grid attached to an object: declares the displayed columns, page size, default sort, and an optional preset filter the generated grid renders."
+        }
+    ]
+};
+//# sourceMappingURL=layout-definition.embedded.js.map

package/dist/presentation/layout/layout-definition.embedded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-definition.embedded.js","sourceRoot":"","sources":["../../../src/presentation/layout/layout-definition.embedded.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,iBAAiB,GAAuB;IACnD,UAAU,EAAE,wBAAwB;IACpC,OAAO,EAAE;QACP;YACE,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,MAAM;YACjB,aAAa,EAAE,uPAAuP;SACvQ;QACD;YACE,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,UAAU;YACrB,aAAa,EAAE,uKAAuK;SACvL;KACF;CACF,CAAC"}

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

@@ -1 +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"}
+{"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;AAiBpD,gCAAgC;AAChC,eAAO,MAAM,mBAAmB,EAAE,UAAU,EAwC3C,CAAC"}

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

@@ -1,6 +1,6 @@
 // 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 { ATTR_SUBTYPE_INT, ATTR_SUBTYPE_STRING, ATTR_SUBTYPE_BOOLEAN, ATTR_SUBTYPE_FILTER, } 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. */
@@ -38,7 +38,8 @@ export const dataGridLayoutAttrs = [
     },
     {
         name: LAYOUT_DATA_GRID_ATTR_COLUMNS,
-        valueType: ATTR_SUBTYPE_STRINGARRAY,
+        valueType: ATTR_SUBTYPE_STRING,
+        isArray: true,
         required: false,
         description: "Flat ordered list of field names to display as grid columns.",
     },

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

@@ -1 +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"}
+{"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,GACpB,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,mBAAmB;QAC9B,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,8DAA8D;KAC5E;CACF,CAAC"}

package/dist/presentation/ui/ui-definition.embedded.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderDefinition } from "../../provider-data.js";
+export declare const UI_DEFINITION: ProviderDefinition;
+//# sourceMappingURL=ui-definition.embedded.d.ts.map

package/dist/presentation/ui/ui-definition.embedded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-definition.embedded.d.ts","sourceRoot":"","sources":["../../../src/presentation/ui/ui-definition.embedded.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,eAAO,MAAM,aAAa,EAAE,kBAgH3B,CAAC"}

package/dist/presentation/ui/ui-definition.embedded.js

@@ -0,0 +1,114 @@
+export const UI_DEFINITION = {
+    "provider": "metaobjects-ui",
+    "extends": [
+        {
+            "type": "field",
+            "subType": "*",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "boolean",
+                    "name": "filterable",
+                    "min": 0,
+                    "max": 1,
+                    "description": "When true, the field is exposed in generated CRUD filter allowlists (Project D filter layer)."
+                },
+                {
+                    "type": "attr",
+                    "subType": "boolean",
+                    "name": "sortable",
+                    "min": 0,
+                    "max": 1,
+                    "description": "When true, the field is exposed in generated CRUD sort allowlists. Inherits from @filterable by default; set false to opt out."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "sortableDefaultOrder",
+                    "min": 0,
+                    "max": 1,
+                    "allowedValues": [
+                        "asc",
+                        "desc"
+                    ],
+                    "description": "Default sort direction applied when this field is the default sort field."
+                }
+            ]
+        },
+        {
+            "type": "view",
+            "subType": "currency",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "locale",
+                    "min": 0,
+                    "max": 1,
+                    "default": "en-US",
+                    "description": "BCP 47 locale code controlling currency display formatting. Defaults to 'en-US' when omitted."
+                }
+            ]
+        },
+        {
+            "type": "layout",
+            "subType": "dataGrid",
+            "children": [
+                {
+                    "type": "attr",
+                    "subType": "int",
+                    "name": "pageSize",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Number of rows per page in the generated data grid."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "defaultSortField",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Field name the grid is sorted by on initial render. Must reference an actual field on the entity."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "defaultSortOrder",
+                    "min": 0,
+                    "max": 1,
+                    "allowedValues": [
+                        "asc",
+                        "desc"
+                    ],
+                    "description": "Initial sort direction for the default sort field: 'asc' or 'desc'."
+                },
+                {
+                    "type": "attr",
+                    "subType": "boolean",
+                    "name": "filterable",
+                    "min": 0,
+                    "max": 1,
+                    "description": "When true, the generated grid exposes column filtering UI."
+                },
+                {
+                    "type": "attr",
+                    "subType": "filter",
+                    "name": "filter",
+                    "min": 0,
+                    "max": 1,
+                    "description": "Structured preset filter object applied to the grid at the metadata level. Desugared to canonical { field: { op: value } } form at parse time."
+                },
+                {
+                    "type": "attr",
+                    "subType": "string",
+                    "name": "columns",
+                    "isArray": true,
+                    "min": 0,
+                    "max": 1,
+                    "description": "Flat ordered list of field names to display as grid columns."
+                }
+            ]
+        }
+    ]
+};
+//# sourceMappingURL=ui-definition.embedded.js.map

package/dist/presentation/ui/ui-definition.embedded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-definition.embedded.js","sourceRoot":"","sources":["../../../src/presentation/ui/ui-definition.embedded.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,aAAa,GAAuB;IAC/C,UAAU,EAAE,gBAAgB;IAC5B,SAAS,EAAE;QACT;YACE,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,GAAG;YACd,UAAU,EAAE;gBACV;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,SAAS;oBACpB,MAAM,EAAE,YAAY;oBACpB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,+FAA+F;iBAC/G;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,SAAS;oBACpB,MAAM,EAAE,UAAU;oBAClB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,gIAAgI;iBAChJ;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,sBAAsB;oBAC9B,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,eAAe,EAAE;wBACf,KAAK;wBACL,MAAM;qBACP;oBACD,aAAa,EAAE,2EAA2E;iBAC3F;aACF;SACF;QACD;YACE,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,UAAU;YACrB,UAAU,EAAE;gBACV;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,SAAS,EAAE,OAAO;oBAClB,aAAa,EAAE,+FAA+F;iBAC/G;aACF;SACF;QACD;YACE,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,UAAU;YACrB,UAAU,EAAE;gBACV;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,KAAK;oBAChB,MAAM,EAAE,UAAU;oBAClB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,qDAAqD;iBACrE;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,kBAAkB;oBAC1B,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,mGAAmG;iBACnH;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,kBAAkB;oBAC1B,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,eAAe,EAAE;wBACf,KAAK;wBACL,MAAM;qBACP;oBACD,aAAa,EAAE,qEAAqE;iBACrF;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,SAAS;oBACpB,MAAM,EAAE,YAAY;oBACpB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,4DAA4D;iBAC5E;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,gJAAgJ;iBAChK;gBACD;oBACE,MAAM,EAAE,MAAM;oBACd,SAAS,EAAE,QAAQ;oBACnB,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,IAAI;oBACf,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,8DAA8D;iBAC9E;aACF;SACF;KACF;CACF,CAAC"}

package/dist/presentation/ui/ui-provider.d.ts

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

package/dist/presentation/ui/ui-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-provider.d.ts","sourceRoot":"","sources":["../../../src/presentation/ui/ui-provider.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAK9D,eAAO,MAAM,UAAU,EAAE,oBAQxB,CAAC"}

package/dist/presentation/ui/ui-provider.js

@@ -0,0 +1,21 @@
+// uiProvider — the presentation + query-surface MetaDataTypeProvider. Extends
+// every field subtype with the UI/query-surface markers @filterable / @sortable /
+// @sortableDefaultOrder by extending the core-registered field types. These are
+// presentation/query concerns, NOT core field properties, so they live here —
+// mirroring the dbProvider (db-provider.ts) and promptProvider patterns.
+//
+// FR-033 S1.5-B: the attrs + their descriptions are now DATA — read from
+// spec/metamodel/ui.json (embedded as UI_DEFINITION) via the unified
+// applyProviderDefinition apply path's `extends` handling. The provider declares
+// no new types, so the factory map is empty.
+import { applyProviderDefinition } from "../../provider-data.js";
+import { UI_DEFINITION } from "./ui-definition.embedded.js";
+export const uiProvider = {
+    id: "metaobjects-ui",
+    dependencies: ["metaobjects-core-types"],
+    description: "UI/query-surface domain — @filterable / @sortable / @sortableDefaultOrder field markers driving generated CRUD filter + sort allowlists (Project D).",
+    registerTypes(registry) {
+        applyProviderDefinition(registry, UI_DEFINITION, {});
+    },
+};
+//# sourceMappingURL=ui-provider.js.map

package/dist/presentation/ui/ui-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-provider.js","sourceRoot":"","sources":["../../../src/presentation/ui/ui-provider.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,kFAAkF;AAClF,gFAAgF;AAChF,8EAA8E;AAC9E,yEAAyE;AACzE,EAAE;AACF,yEAAyE;AACzE,qEAAqE;AACrE,iFAAiF;AACjF,6CAA6C;AAI7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC9C,EAAE,EAAE,gBAAgB;IACpB,YAAY,EAAE,CAAC,wBAAwB,CAAC;IACxC,WAAW,EACT,sJAAsJ;IACxJ,aAAa,CAAC,QAAsB;QAClC,uBAAuB,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { AttrSchema } from "../../registry.js";
+/** `@filterable` — exposed in generated CRUD filter allowlists; on every field subtype. */
+export declare const filterableSchema: AttrSchema;
+/** `@sortable` — exposed in generated CRUD sort allowlists; on every field subtype. */
+export declare const sortableSchema: AttrSchema;
+/** `@sortableDefaultOrder` — default sort direction; on every field subtype. */
+export declare const sortableDefaultOrderSchema: AttrSchema;
+/** The three UI-domain field markers added to every field subtype. */
+export declare const uiFieldAttrs: readonly AttrSchema[];
+//# sourceMappingURL=ui-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui-schema.d.ts","sourceRoot":"","sources":["../../../src/presentation/ui/ui-schema.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAepD,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,EAAE,UAM9B,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,cAAc,EAAE,UAM5B,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,0BAA0B,EAAE,UAOxC,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAI7C,CAAC"}

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

@@ -0,0 +1,41 @@
+// UI-domain attribute schemas — registered by uiProvider (ui-provider.ts), the
+// presentation + query-surface concern. The @filterable/@sortable/
+// @sortableDefaultOrder field markers drive the generated CRUD filter + sort
+// allowlists (Project D). FR-033 S1-field-A re-homes them out of the core field
+// definition into this concern provider; the descriptions are copied VERBATIM
+// from spec/metamodel/field.json so the composed registry manifest stays
+// byte-identical.
+import { ATTR_SUBTYPE_STRING, ATTR_SUBTYPE_BOOLEAN, } from "../../core/attr/attr-constants.js";
+import { FIELD_ATTR_FILTERABLE, FIELD_ATTR_SORTABLE, FIELD_ATTR_SORTABLE_DEFAULT_ORDER, } from "../../core/field/field-constants.js";
+/** Sort directions for @sortableDefaultOrder (verbatim from field.json allowedValues). */
+const SORT_ORDER_ASC = "asc";
+const SORT_ORDER_DESC = "desc";
+/** `@filterable` — exposed in generated CRUD filter allowlists; on every field subtype. */
+export const filterableSchema = {
+    name: FIELD_ATTR_FILTERABLE,
+    valueType: ATTR_SUBTYPE_BOOLEAN,
+    required: false,
+    description: "When true, the field is exposed in generated CRUD filter allowlists (Project D filter layer).",
+};
+/** `@sortable` — exposed in generated CRUD sort allowlists; on every field subtype. */
+export const sortableSchema = {
+    name: FIELD_ATTR_SORTABLE,
+    valueType: ATTR_SUBTYPE_BOOLEAN,
+    required: false,
+    description: "When true, the field is exposed in generated CRUD sort allowlists. Inherits from @filterable by default; set false to opt out.",
+};
+/** `@sortableDefaultOrder` — default sort direction; on every field subtype. */
+export const sortableDefaultOrderSchema = {
+    name: FIELD_ATTR_SORTABLE_DEFAULT_ORDER,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    allowedValues: [SORT_ORDER_ASC, SORT_ORDER_DESC],
+    description: "Default sort direction applied when this field is the default sort field.",
+};
+/** The three UI-domain field markers added to every field subtype. */
+export const uiFieldAttrs = [
+    filterableSchema,
+    sortableSchema,
+    sortableDefaultOrderSchema,
+];
+//# sourceMappingURL=ui-schema.js.map