@metaobjectsdev/metadata 0.5.0 → 0.6.0-rc.1

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

@@ -1,18 +1,20 @@
 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;
+    /** Physical SQL table/view name from @table (source.rdb). */
+    get tableName(): 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.
+     * The effective kind for this source: the value of `@kind`, defaulting to
+     * `"table"` when omitted (ADR-0007 Rule 3 — per-paradigm default).
      */
-    isWritable(): boolean;
+    get effectiveKind(): string;
+    /** The multi-source role for this source (defaults to "primary" when omitted). */
+    get role(): string;
     /**
-     * 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.
+     * True when this source's effective kind is read-only (view, materializedView,
+     * storedProc, tableFunction). Derived from the @kind attr on source.rdb.
      */
     isReadOnly(): boolean;
+    /** True when this source is writable (i.e. not read-only). */
+    isWritable(): boolean;
 }
 //# sourceMappingURL=meta-source.d.ts.map

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

@@ -1 +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"}
+{"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;AAUrD,qBAAa,UAAW,SAAQ,QAAQ;IACtC,6DAA6D;IAC7D,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAGlC;IAED;;;OAGG;IACH,IAAI,aAAa,IAAI,MAAM,CAG1B;IAED,kFAAkF;IAClF,IAAI,IAAI,IAAI,MAAM,CAGjB;IAED;;;OAGG;IACH,UAAU,IAAI,OAAO;IAIrB,8DAA8D;IAC9D,UAAU,IAAI,OAAO;CAGtB"}

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

@@ -1,31 +1,39 @@
 // 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.
+// source.rdb uses @table/@kind/@role/@schema; read-only is derived from @kind.
 //
 // 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";
+import { SOURCE_ATTR_TABLE, SOURCE_ATTR_KIND, SOURCE_ATTR_ROLE, SOURCE_READ_ONLY_KINDS, DEFAULT_SOURCE_KIND, DEFAULT_SOURCE_ROLE, } 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;
+    /** Physical SQL table/view name from @table (source.rdb). */
+    get tableName() {
+        const v = this.ownAttr(SOURCE_ATTR_TABLE);
+        return typeof v === "string" && v !== "" ? 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.
+     * The effective kind for this source: the value of `@kind`, defaulting to
+     * `"table"` when omitted (ADR-0007 Rule 3 — per-paradigm default).
      */
-    isWritable() {
-        return this.subType === SOURCE_SUBTYPE_DB_TABLE;
+    get effectiveKind() {
+        const v = this.ownAttr(SOURCE_ATTR_KIND);
+        return typeof v === "string" && v !== "" ? v : DEFAULT_SOURCE_KIND;
+    }
+    /** The multi-source role for this source (defaults to "primary" when omitted). */
+    get role() {
+        const v = this.ownAttr(SOURCE_ATTR_ROLE);
+        return typeof v === "string" && v !== "" ? v : DEFAULT_SOURCE_ROLE;
     }
     /**
-     * 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.
+     * True when this source's effective kind is read-only (view, materializedView,
+     * storedProc, tableFunction). Derived from the @kind attr on source.rdb.
      */
     isReadOnly() {
-        return this.subType === SOURCE_SUBTYPE_DB_VIEW;
+        return SOURCE_READ_ONLY_KINDS.has(this.effectiveKind);
+    }
+    /** True when this source is writable (i.e. not read-only). */
+    isWritable() {
+        return !this.isReadOnly();
     }
 }
 //# sourceMappingURL=meta-source.js.map

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

@@ -1 +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"}
+{"version":3,"file":"meta-source.js","sourceRoot":"","sources":["../../../src/persistence/source/meta-source.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,qDAAqD;AACrD,+EAA+E;AAC/E,EAAE;AACF,wEAAwE;AAExE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,OAAO,UAAW,SAAQ,QAAQ;IACtC,6DAA6D;IAC7D,IAAI,SAAS;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAC1C,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACH,IAAI,aAAa;QACf,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACzC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;IACrE,CAAC;IAED,kFAAkF;IAClF,IAAI,IAAI;QACN,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACzC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;IACrE,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,OAAO,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACxD,CAAC;IAED,8DAA8D;IAC9D,UAAU;QACR,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;IAC5B,CAAC;CACF"}

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

@@ -1,16 +1,37 @@
-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 declare const SOURCE_SUBTYPE_RDB = "rdb";
+export declare const SOURCE_SUBTYPES: readonly ["base", "rdb"];
 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". */
+/** Optional DB schema attr on source.rdb. 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";
+/** Physical table/view name on source.rdb. */
+export declare const SOURCE_ATTR_TABLE = "table";
+/** Object kind within the rdb paradigm; read-only-ness is derived from it. */
+export declare const SOURCE_ATTR_KIND = "kind";
+/** Multi-source role; exactly one primary per object. */
+export declare const SOURCE_ATTR_ROLE = "role";
+export declare const SOURCE_KIND_TABLE = "table";
+export declare const SOURCE_KIND_VIEW = "view";
+export declare const SOURCE_KIND_MATERIALIZED_VIEW = "materializedView";
+export declare const SOURCE_KIND_STORED_PROC = "storedProc";
+export declare const SOURCE_KIND_TABLE_FUNCTION = "tableFunction";
+export declare const SOURCE_RDB_KINDS: readonly ["table", "view", "materializedView", "storedProc", "tableFunction"];
+export type SourceRdbKind = (typeof SOURCE_RDB_KINDS)[number];
+/** rdb @kind default when omitted (writable table). */
+export declare const DEFAULT_SOURCE_KIND = "table";
+/** Kinds whose source is read-only (codegen emits read-only model/queries/routes). */
+export declare const SOURCE_READ_ONLY_KINDS: ReadonlySet<string>;
+export declare const SOURCE_ROLE_PRIMARY = "primary";
+export declare const SOURCE_ROLE_REPLICA = "replica";
+export declare const SOURCE_ROLE_INDEX = "index";
+export declare const SOURCE_ROLE_CACHE = "cache";
+export declare const SOURCE_ROLE_PUBLISH = "publish";
+export declare const SOURCE_ROLE_MIRROR = "mirror";
+export declare const SOURCE_ROLES: readonly ["primary", "replica", "index", "cache", "publish", "mirror"];
+export type SourceRole = (typeof SOURCE_ROLES)[number];
+/** Role when @role is omitted (system of record). */
+export declare const DEFAULT_SOURCE_ROLE = "primary";
 //# sourceMappingURL=source-constants.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"source-constants.d.ts","sourceRoot":"","sources":["../../../src/persistence/source/source-constants.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,eAAO,MAAM,eAAe,0BAGlB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;6CAE6C;AAC7C,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,qEAAqE;AACrE,eAAO,MAAM,0BAA0B,WAAW,CAAC;AAMnD,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,SAAS,CAAC;AACvC,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC,eAAO,MAAM,iBAAiB,UAAuB,CAAC;AACtD,eAAO,MAAM,gBAAgB,SAAuB,CAAC;AACrD,eAAO,MAAM,6BAA6B,qBAAsB,CAAC;AACjE,eAAO,MAAM,uBAAuB,eAAsB,CAAC;AAC3D,eAAO,MAAM,0BAA0B,kBAAsB,CAAC;AAE9D,eAAO,MAAM,gBAAgB,+EAMnB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,UAAoB,CAAC;AAErD,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAKrD,CAAC;AAEH,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAC7C,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAC7C,eAAO,MAAM,iBAAiB,UAAY,CAAC;AAC3C,eAAO,MAAM,iBAAiB,UAAY,CAAC;AAC3C,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAC7C,eAAO,MAAM,kBAAkB,WAAY,CAAC;AAE5C,eAAO,MAAM,YAAY,wEAOf,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,YAAsB,CAAC"}

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

@@ -2,27 +2,66 @@
 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).
+// source.rdb (ADR-0007): paradigm subtype + @table/@kind/@role/@schema attrs.
+// Multiple sources per object are allowed and meaningful (write-through CQRS:
+// writable rdb[table] for writes + read-only rdb[view] for reads).
 // ---------------------------------------------------------------------------
-export const SOURCE_SUBTYPE_DB_TABLE = "dbTable";
-export const SOURCE_SUBTYPE_DB_VIEW = "dbView";
+// --- Source v2 (ADR-0007): paradigm subtype "rdb"; physical name @table; @kind + @role. ---
+export const SOURCE_SUBTYPE_RDB = "rdb";
 export const SOURCE_SUBTYPES = [
     SUBTYPE_BASE,
-    SOURCE_SUBTYPE_DB_TABLE,
-    SOURCE_SUBTYPE_DB_VIEW,
+    SOURCE_SUBTYPE_RDB,
 ];
-// 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". */
+/** Optional DB schema attr on source.rdb. 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";
+// ---------------------------------------------------------------------------
+// Source v2 (ADR-0007) — rdb paradigm: kind, role, physical table name.
+// ---------------------------------------------------------------------------
+/** Physical table/view name on source.rdb. */
+export const SOURCE_ATTR_TABLE = "table";
+/** Object kind within the rdb paradigm; read-only-ness is derived from it. */
+export const SOURCE_ATTR_KIND = "kind";
+/** Multi-source role; exactly one primary per object. */
+export const SOURCE_ATTR_ROLE = "role";
+export const SOURCE_KIND_TABLE = "table";
+export const SOURCE_KIND_VIEW = "view";
+export const SOURCE_KIND_MATERIALIZED_VIEW = "materializedView";
+export const SOURCE_KIND_STORED_PROC = "storedProc";
+export const SOURCE_KIND_TABLE_FUNCTION = "tableFunction";
+export const SOURCE_RDB_KINDS = [
+    SOURCE_KIND_TABLE,
+    SOURCE_KIND_VIEW,
+    SOURCE_KIND_MATERIALIZED_VIEW,
+    SOURCE_KIND_STORED_PROC,
+    SOURCE_KIND_TABLE_FUNCTION,
+];
+/** rdb @kind default when omitted (writable table). */
+export const DEFAULT_SOURCE_KIND = SOURCE_KIND_TABLE;
+/** Kinds whose source is read-only (codegen emits read-only model/queries/routes). */
+export const SOURCE_READ_ONLY_KINDS = new Set([
+    SOURCE_KIND_VIEW,
+    SOURCE_KIND_MATERIALIZED_VIEW,
+    SOURCE_KIND_STORED_PROC,
+    SOURCE_KIND_TABLE_FUNCTION,
+]);
+export const SOURCE_ROLE_PRIMARY = "primary";
+export const SOURCE_ROLE_REPLICA = "replica";
+export const SOURCE_ROLE_INDEX = "index";
+export const SOURCE_ROLE_CACHE = "cache";
+export const SOURCE_ROLE_PUBLISH = "publish";
+export const SOURCE_ROLE_MIRROR = "mirror";
+export const SOURCE_ROLES = [
+    SOURCE_ROLE_PRIMARY,
+    SOURCE_ROLE_REPLICA,
+    SOURCE_ROLE_INDEX,
+    SOURCE_ROLE_CACHE,
+    SOURCE_ROLE_PUBLISH,
+    SOURCE_ROLE_MIRROR,
+];
+/** Role when @role is omitted (system of record). */
+export const DEFAULT_SOURCE_ROLE = SOURCE_ROLE_PRIMARY;
 //# sourceMappingURL=source-constants.js.map

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

@@ -1 +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"}
+{"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,8EAA8E;AAC9E,8EAA8E;AAC9E,mEAAmE;AACnE,8EAA8E;AAE9E,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAExC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY;IACZ,kBAAkB;CACV,CAAC;AAGX;;6CAE6C;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAE3C,qEAAqE;AACrE,MAAM,CAAC,MAAM,0BAA0B,GAAG,QAAQ,CAAC;AAEnD,8EAA8E;AAC9E,wEAAwE;AACxE,8EAA8E;AAE9E,8CAA8C;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AACzC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AACvC,yDAAyD;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,MAAM,CAAC,MAAM,iBAAiB,GAAgB,OAAO,CAAC;AACtD,MAAM,CAAC,MAAM,gBAAgB,GAAiB,MAAM,CAAC;AACrD,MAAM,CAAC,MAAM,6BAA6B,GAAI,kBAAkB,CAAC;AACjE,MAAM,CAAC,MAAM,uBAAuB,GAAU,YAAY,CAAC;AAC3D,MAAM,CAAC,MAAM,0BAA0B,GAAO,eAAe,CAAC;AAE9D,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,iBAAiB;IACjB,gBAAgB;IAChB,6BAA6B;IAC7B,uBAAuB;IACvB,0BAA0B;CAClB,CAAC;AAGX,uDAAuD;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD,sFAAsF;AACtF,MAAM,CAAC,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC;IACjE,gBAAgB;IAChB,6BAA6B;IAC7B,uBAAuB;IACvB,0BAA0B;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAC7C,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAC7C,MAAM,CAAC,MAAM,iBAAiB,GAAK,OAAO,CAAC;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAK,OAAO,CAAC;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAI,QAAQ,CAAC;AAE5C,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,mBAAmB;IACnB,mBAAmB;IACnB,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,kBAAkB;CACV,CAAC;AAGX,qDAAqD;AACrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { AttrSchema } from "../../registry.js";
+/** All attr schemas for source.rdb, to be registered via registry.extend. */
+export declare const sourceRdbAttrs: AttrSchema[];
+//# sourceMappingURL=source-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-schema.d.ts","sourceRoot":"","sources":["../../../src/persistence/source/source-schema.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAiDpD,6EAA6E;AAC7E,eAAO,MAAM,cAAc,EAAE,UAAU,EAAwD,CAAC"}

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

@@ -0,0 +1,37 @@
+// Source v2 attribute schemas — registered by dbProvider for source.rdb.
+// Consumed via sourceRdbAttrs in db-provider.ts.
+import { ATTR_SUBTYPE_STRING } from "../../core/attr/attr-constants.js";
+import { SOURCE_ATTR_TABLE, SOURCE_ATTR_KIND, SOURCE_ATTR_ROLE, SOURCE_ATTR_SCHEMA, SOURCE_RDB_KINDS, SOURCE_ROLES, } from "./source-constants.js";
+/** `@table` — physical SQL table or view name for source.rdb. */
+const tableSchema = {
+    name: SOURCE_ATTR_TABLE,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    description: "Physical SQL table or view name for this rdb source. Defaults to the object name run through the project's columnNamingStrategy when omitted.",
+};
+/** `@kind` — object kind within the rdb paradigm; drives read-only derivation. */
+const kindSchema = {
+    name: SOURCE_ATTR_KIND,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    allowedValues: [...SOURCE_RDB_KINDS],
+    description: "The kind of database object this source represents: table (default, writable), view, materializedView, storedProc, or tableFunction. Non-table kinds are read-only.",
+};
+/** `@role` — multi-source role; exactly one primary per object. */
+const roleSchema = {
+    name: SOURCE_ATTR_ROLE,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    allowedValues: [...SOURCE_ROLES],
+    description: "Role this source plays when an object has multiple sources: primary (default, system of record), replica, index, cache, publish, or mirror.",
+};
+/** `@schema` — optional DB schema namespace for this source. */
+const schemaSchema = {
+    name: SOURCE_ATTR_SCHEMA,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    description: "Optional database schema name (e.g. 'catalog', 'public'). Postgres defaults to 'public'; SQLite rejects any non-default value.",
+};
+/** All attr schemas for source.rdb, to be registered via registry.extend. */
+export const sourceRdbAttrs = [tableSchema, kindSchema, roleSchema, schemaSchema];
+//# sourceMappingURL=source-schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-schema.js","sourceRoot":"","sources":["../../../src/persistence/source/source-schema.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,iDAAiD;AAGjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,GACb,MAAM,uBAAuB,CAAC;AAE/B,iEAAiE;AACjE,MAAM,WAAW,GAAe;IAC9B,IAAI,EAAE,iBAAiB;IACvB,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,+IAA+I;CAClJ,CAAC;AAEF,kFAAkF;AAClF,MAAM,UAAU,GAAe;IAC7B,IAAI,EAAE,gBAAgB;IACtB,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,aAAa,EAAE,CAAC,GAAG,gBAAgB,CAAC;IACpC,WAAW,EACT,qKAAqK;CACxK,CAAC;AAEF,mEAAmE;AACnE,MAAM,UAAU,GAAe;IAC7B,IAAI,EAAE,gBAAgB;IACtB,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,aAAa,EAAE,CAAC,GAAG,YAAY,CAAC;IAChC,WAAW,EACT,6IAA6I;CAChJ,CAAC;AAEF,gEAAgE;AAChE,MAAM,YAAY,GAAe;IAC/B,IAAI,EAAE,kBAAkB;IACxB,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,gIAAgI;CACnI,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAiB,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { MetaData } from "../../shared/meta-data.js";
+import { ParseError } from "../../errors.js";
+/**
+ * Walks every object in the root and enforces the one-primary rule for
+ * multi-source objects:
+ *  - 0 sources → no error (object is not backed by any store).
+ *  - 1+ sources, exactly 1 with role "primary" → OK.
+ *  - 1+ sources, 0 with role "primary" → ERR_SOURCE_NO_PRIMARY.
+ *  - 1+ sources, 2+ with role "primary" → ERR_SOURCE_MULTIPLE_PRIMARY.
+ */
+export declare function validateSourceRoles(root: MetaData): ParseError[];
+//# sourceMappingURL=validate-source-roles.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,38 @@
+// Validation pass: one-primary multi-source rule.
+//
+// An object that declares ≥1 source MUST have exactly one with role "primary".
+// Zero sources is allowed (object is not persisted). Violations:
+//   ERR_SOURCE_NO_PRIMARY      — sources present but none is role "primary"
+//   ERR_SOURCE_MULTIPLE_PRIMARY — more than one source has role "primary"
+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";
+/**
+ * Walks every object in the root and enforces the one-primary rule for
+ * multi-source objects:
+ *  - 0 sources → no error (object is not backed by any store).
+ *  - 1+ sources, exactly 1 with role "primary" → OK.
+ *  - 1+ sources, 0 with role "primary" → ERR_SOURCE_NO_PRIMARY.
+ *  - 1+ sources, 2+ with role "primary" → ERR_SOURCE_MULTIPLE_PRIMARY.
+ */
+export function validateSourceRoles(root) {
+    const errors = [];
+    for (const obj of root.ownChildren().filter((c) => c.type === TYPE_OBJECT)) {
+        const sources = obj
+            .ownChildren()
+            .filter((c) => c.type === TYPE_SOURCE)
+            .map((c) => c);
+        if (sources.length === 0)
+            continue;
+        const primaryCount = sources.filter((s) => s.role === SOURCE_ROLE_PRIMARY).length;
+        if (primaryCount === 0) {
+            errors.push(new ParseError(`object "${obj.name}" declares ${sources.length} source(s) but none has role "${SOURCE_ROLE_PRIMARY}"`, { code: "ERR_SOURCE_NO_PRIMARY" }));
+        }
+        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" }));
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=validate-source-roles.js.map

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

@@ -0,0 +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,CAClC,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,CACxC,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/registry.d.ts

@@ -58,6 +58,8 @@ export declare class TypeRegistry {
     private readonly _subTypes;
     /** Per-type designated default subType (queried by the YAML desugar). */
     private readonly _defaultSubTypes;
+    /** Attrs accepted on every metatype (declared by providers). */
+    private readonly _commonAttrs;
     register(def: TypeDefinition): void;
     find(type: string, subType: string): TypeDefinition | undefined;
     has(type: string, subType: string): boolean;
@@ -70,6 +72,17 @@ export declare class TypeRegistry {
     /** The declared attribute schema for a (type, subType), or [] if the
      *  pair is unregistered or declares no attributes. */
     attrsOf(type: string, subType: string): AttrSchema[];
+    /**
+     * Register attrs that are accepted on every metatype. Callers (providers) use
+     * this to declare cross-cutting attrs (e.g. doc attrs). Repeated registration
+     * of the same name is silently deduped (first registration wins); conflicts with
+     * per-type attrs are resolved at validation time (Task 1.3).
+     */
+    registerCommonAttrs(attrs: AttrSchema[]): void;
+    /** Returns the registered common attrs (attrs accepted on every metatype).
+     *  Returns a defensive copy so callers cannot mutate internal state, matching
+     *  the spread-copy pattern used by `attrsOf` and `allSubTypesOf`. */
+    getCommonAttrs(): readonly AttrSchema[];
     /**
      * Additively enrich an already-registered (type, subType): append attributes
      * and/or child rules. Does NOT touch factory / typeId / dataType / default

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,qBAAa,MAAM;aAEC,IAAI,EAAE,MAAM;aACZ,OAAO,EAAE,MAAM;gBADf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM;IAGjC,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAG/B;AAED,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,sFAAsF;IACtF,aAAa,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC;IACpD,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB;iFAC6E;IAC7E,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,qBAAa,YAAY;IACvB,iCAAiC;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D,gDAAgD;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IAEzD,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAE9D,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAgCnC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI/D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAI3C,QAAQ,IAAI,MAAM,EAAE;IAIpB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAIrC,0FAA0F;IAC1F,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAItD,sFAAsF;IACtF,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIlD;0DACsD;IACtD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;IAIpD;;;;;OAKG;IACH,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,GAAG,EAAE;QAAE,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;KAAE,GAC3D,IAAI;CA0BR;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrD,OAAO,CAMT"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/registry.js

@@ -23,6 +23,8 @@ export class TypeRegistry {
     _subTypes = new Map();
     /** Per-type designated default subType (queried by the YAML desugar). */
     _defaultSubTypes = new Map();
+    /** Attrs accepted on every metatype (declared by providers). */
+    _commonAttrs = [];
     register(def) {
         const key = def.typeId.toString();
         if (this._defs.has(key)) {
@@ -73,6 +75,30 @@ export class TypeRegistry {
     attrsOf(type, subType) {
         return [...(this.find(type, subType)?.attributes ?? [])];
     }
+    /**
+     * Register attrs that are accepted on every metatype. Callers (providers) use
+     * this to declare cross-cutting attrs (e.g. doc attrs). Repeated registration
+     * of the same name is silently deduped (first registration wins); conflicts with
+     * per-type attrs are resolved at validation time (Task 1.3).
+     */
+    registerCommonAttrs(attrs) {
+        for (const attr of attrs) {
+            if (attr.valueType === SUBTYPE_BASE) {
+                throw new Error(`TypeRegistry.registerCommonAttrs: attr "${attr.name}" declares valueType "${SUBTYPE_BASE}", ` +
+                    `which is not valid for attrs. Use no valueType (omit the field) for a polymorphic/untyped attr.`);
+            }
+            if (this._commonAttrs.some((existing) => existing.name === attr.name)) {
+                continue; // dedupe same-name re-registration; conflict-with-per-type-attr is checked at validation time
+            }
+            this._commonAttrs.push(attr);
+        }
+    }
+    /** Returns the registered common attrs (attrs accepted on every metatype).
+     *  Returns a defensive copy so callers cannot mutate internal state, matching
+     *  the spread-copy pattern used by `attrsOf` and `allSubTypesOf`. */
+    getCommonAttrs() {
+        return [...this._commonAttrs];
+    }
     /**
      * Additively enrich an already-registered (type, subType): append attributes
      * and/or child rules. Does NOT touch factory / typeId / dataType / default

package/dist/registry.js.map

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

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

@@ -9,7 +9,8 @@ export declare const TYPE_RELATIONSHIP = "relationship";
 export declare const TYPE_LAYOUT = "layout";
 export declare const TYPE_SOURCE = "source";
 export declare const TYPE_ORIGIN = "origin";
-export declare const BASE_TYPES: readonly ["metadata", "object", "field", "attr", "validator", "view", "identity", "relationship", "layout", "source", "origin"];
+export declare const TYPE_TEMPLATE = "template";
+export declare const BASE_TYPES: readonly ["metadata", "object", "field", "attr", "validator", "view", "identity", "relationship", "layout", "source", "origin", "template"];
 export type BaseType = (typeof BASE_TYPES)[number];
 export declare const SUBTYPE_BASE = "base";
 /**

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

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

package/dist/shared/base-types.js

@@ -1,6 +1,7 @@
-// Base type vocabulary — the 11 registered base types + universal/metadata subtypes.
+// Base type vocabulary — the 12 registered base types + universal/metadata subtypes.
 // ---------------------------------------------------------------------------
-// Base type names (the 11 registered base types — Java metaobjects-core vocabulary)
+// Base type names (the registered base types — Java metaobjects-core vocabulary,
+// plus `template`, the TS-first FR-004 addition for prompt construction)
 // ---------------------------------------------------------------------------
 export const TYPE_METADATA = "metadata";
 export const TYPE_OBJECT = "object";
@@ -13,6 +14,7 @@ export const TYPE_RELATIONSHIP = "relationship";
 export const TYPE_LAYOUT = "layout";
 export const TYPE_SOURCE = "source";
 export const TYPE_ORIGIN = "origin";
+export const TYPE_TEMPLATE = "template";
 export const BASE_TYPES = [
     TYPE_METADATA,
     TYPE_OBJECT,
@@ -25,6 +27,7 @@ export const BASE_TYPES = [
     TYPE_LAYOUT,
     TYPE_SOURCE,
     TYPE_ORIGIN,
+    TYPE_TEMPLATE,
 ];
 // ---------------------------------------------------------------------------
 // Universal subtype

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

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

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

@@ -0,0 +1,13 @@
+import { MetaData } from "../shared/meta-data.js";
+/**
+ * `template.*` node — the fourth-pillar metatype (FR-004, R1).
+ *
+ * A single class backs both subtypes (`template.prompt`, `template.output`),
+ * mirroring `MetaSource`: the loader dispatches by subtype and per-subtype
+ * attribute schemas (see `template-schema.ts`) drive validation. Typed accessors
+ * are deferred to the render-engine / verify work — attr values read generically
+ * via `ownAttr(...)` until then, so no untested forward-looking surface ships.
+ */
+export declare class MetaTemplate extends MetaData {
+}
+//# sourceMappingURL=meta-template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-template.d.ts","sourceRoot":"","sources":["../../src/template/meta-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD;;;;;;;;GAQG;AACH,qBAAa,YAAa,SAAQ,QAAQ;CAAG"}

package/dist/template/meta-template.js

@@ -0,0 +1,13 @@
+import { MetaData } from "../shared/meta-data.js";
+/**
+ * `template.*` node — the fourth-pillar metatype (FR-004, R1).
+ *
+ * A single class backs both subtypes (`template.prompt`, `template.output`),
+ * mirroring `MetaSource`: the loader dispatches by subtype and per-subtype
+ * attribute schemas (see `template-schema.ts`) drive validation. Typed accessors
+ * are deferred to the render-engine / verify work — attr values read generically
+ * via `ownAttr(...)` until then, so no untested forward-looking surface ships.
+ */
+export class MetaTemplate extends MetaData {
+}
+//# sourceMappingURL=meta-template.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-template.js","sourceRoot":"","sources":["../../src/template/meta-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAQ;CAAG"}

package/dist/template/template-constants.d.ts

@@ -0,0 +1,17 @@
+export declare const TEMPLATE_SUBTYPE_PROMPT = "prompt";
+export declare const TEMPLATE_SUBTYPE_OUTPUT = "output";
+export declare const TEMPLATE_SUBTYPES: readonly ["base", "prompt", "output"];
+export type TemplateSubType = (typeof TEMPLATE_SUBTYPES)[number];
+export declare const TEMPLATE_ATTR_PAYLOAD_REF = "payloadRef";
+export declare const TEMPLATE_ATTR_TEXT_REF = "textRef";
+export declare const TEMPLATE_ATTR_FORMAT = "format";
+export declare const TEMPLATE_ATTR_MAX_CHARS = "maxChars";
+export declare const TEMPLATE_ATTR_OWNER = "owner";
+export declare const TEMPLATE_ATTR_SINCE = "since";
+export declare const TEMPLATE_ATTR_REQUIRED_TAGS = "requiredTags";
+export declare const TEMPLATE_ATTR_MAX_TOKENS = "maxTokens";
+export declare const TEMPLATE_ATTR_REQUIRED_SLOTS = "requiredSlots";
+export declare const TEMPLATE_ATTR_MODEL = "model";
+export declare const TEMPLATE_FORMATS: readonly ["text", "html", "xml", "csv", "json", "markdown", "spreadsheet"];
+export type TemplateFormat = (typeof TEMPLATE_FORMATS)[number];
+//# sourceMappingURL=template-constants.d.ts.map

package/dist/template/template-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-constants.d.ts","sourceRoot":"","sources":["../../src/template/template-constants.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAChD,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAEhD,eAAO,MAAM,iBAAiB,uCAIpB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAGjE,eAAO,MAAM,yBAAyB,eAAe,CAAC;AACtD,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAChD,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAC7C,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAClD,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAC3C,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAI3C,eAAO,MAAM,2BAA2B,iBAAiB,CAAC;AAG1D,eAAO,MAAM,wBAAwB,cAAc,CAAC;AACpD,eAAO,MAAM,4BAA4B,kBAAkB,CAAC;AAC5D,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAI3C,eAAO,MAAM,gBAAgB,4EAQnB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC"}