@metaobjectsdev/metadata 0.8.1 → 0.9.0

package/dist/naming.js

@@ -42,13 +42,14 @@ export function pluralize(s) {
     return s + "s";
 }
 export function resolveTableName(entity) {
-    // Primary source carries the physical table/view name (@table). Writability
-    // (table vs view/storedProc/tableFunction) only affects write-routing — for
-    // SELECT-side name resolution, a read-only primary source is the right answer.
+    // FR-016: primary source's `physicalName` implements the four-step rule
+    // (kind-matching alias → legacy @table → source.name → entity-name fallback),
+    // so this helper now just delegates. Writability (table vs view/storedProc/
+    // tableFunction) only affects write-routing — for SELECT-side name resolution,
+    // a read-only primary source is the right answer.
     const source = entity.ownChildren().find((c) => c instanceof MetaSource && c.role === SOURCE_ROLE_PRIMARY);
-    const name = source?.tableName;
-    if (typeof name === "string" && name !== "")
-        return name;
+    if (source !== undefined)
+        return source.physicalName;
     return pluralize(toSnakeCase(entity.name));
 }
 export function resolveColumnName(field, strategy = DEFAULT_COLUMN_NAMING_STRATEGY) {

package/dist/naming.js.map

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

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

@@ -2,4 +2,27 @@
 export declare const FIELD_ATTR_COLUMN = "column";
 /** When true, suppress the @filterable-without-index Loader warning (Project D drift check). */
 export declare const FIELD_ATTR_DB_INDEXED = "db.indexed";
+/**
+ * R6 Plan 2b: `@dbColumnType` — physical DB column-type override on a field.
+ * Selects the DB column type WITHOUT changing the logical field type or its
+ * native binding (ADR-0013 — the canonical physical escape hatch). Registered
+ * by the dbProvider, validated as a (logical subtype × value) pairing.
+ */
+export declare const FIELD_ATTR_DB_COLUMN_TYPE = "dbColumnType";
+/** `@dbColumnType: uuid` — native Postgres `uuid` column (legal on field.string). */
+export declare const DB_COLUMN_TYPE_UUID = "uuid";
+/** `@dbColumnType: jsonb` — genuinely-open `jsonb` column (legal on field.string). */
+export declare const DB_COLUMN_TYPE_JSONB = "jsonb";
+/** `@dbColumnType: timestamp_with_tz` — `timestamp with time zone` (legal on field.timestamp). */
+export declare const DB_COLUMN_TYPE_TIMESTAMP_WITH_TZ = "timestamp_with_tz";
+/** The closed set of legal `@dbColumnType` values (raw-dialect passthrough deferred). */
+export declare const DB_COLUMN_TYPE_VALUES: readonly ["uuid", "jsonb", "timestamp_with_tz"];
+export type DbColumnTypeValue = (typeof DB_COLUMN_TYPE_VALUES)[number];
+/**
+ * Legal `@dbColumnType` value → the field subtypes it may be applied to (ADR-0013,
+ * R6 Plan 2b). Any other (subtype × value) pairing — or an unrecognized value — is
+ * an ERR_BAD_ATTR_VALUE. Keyed by value; the value-set is enforced by membership in
+ * this map. Subtype names are the bare FIELD_SUBTYPE_* constants (string / timestamp).
+ */
+export declare const DB_COLUMN_TYPE_LEGAL_SUBTYPES: Readonly<Record<DbColumnTypeValue, readonly string[]>>;
 //# sourceMappingURL=db-constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"db-constants.d.ts","sourceRoot":"","sources":["../../../src/persistence/db/db-constants.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAC1C,gGAAgG;AAChG,eAAO,MAAM,qBAAqB,eAAe,CAAC"}
+{"version":3,"file":"db-constants.d.ts","sourceRoot":"","sources":["../../../src/persistence/db/db-constants.ts"],"names":[],"mappings":"AAOA,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAC1C,gGAAgG;AAChG,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,iBAAiB,CAAC;AAExD,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAC1C,sFAAsF;AACtF,eAAO,MAAM,oBAAoB,UAAU,CAAC;AAC5C,kGAAkG;AAClG,eAAO,MAAM,gCAAgC,sBAAsB,CAAC;AAEpE,yFAAyF;AACzF,eAAO,MAAM,qBAAqB,iDAIxB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC,CAIvF,CAAC"}

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

@@ -1,6 +1,37 @@
 // DB concern constants — physical DB column attr keys.
+import { FIELD_SUBTYPE_STRING, FIELD_SUBTYPE_TIMESTAMP, } from "../../core/field/field-constants.js";
 /** Column name override on a field (maps to @column in metadata). */
 export const FIELD_ATTR_COLUMN = "column";
 /** When true, suppress the @filterable-without-index Loader warning (Project D drift check). */
 export const FIELD_ATTR_DB_INDEXED = "db.indexed";
+/**
+ * R6 Plan 2b: `@dbColumnType` — physical DB column-type override on a field.
+ * Selects the DB column type WITHOUT changing the logical field type or its
+ * native binding (ADR-0013 — the canonical physical escape hatch). Registered
+ * by the dbProvider, validated as a (logical subtype × value) pairing.
+ */
+export const FIELD_ATTR_DB_COLUMN_TYPE = "dbColumnType";
+/** `@dbColumnType: uuid` — native Postgres `uuid` column (legal on field.string). */
+export const DB_COLUMN_TYPE_UUID = "uuid";
+/** `@dbColumnType: jsonb` — genuinely-open `jsonb` column (legal on field.string). */
+export const DB_COLUMN_TYPE_JSONB = "jsonb";
+/** `@dbColumnType: timestamp_with_tz` — `timestamp with time zone` (legal on field.timestamp). */
+export const DB_COLUMN_TYPE_TIMESTAMP_WITH_TZ = "timestamp_with_tz";
+/** The closed set of legal `@dbColumnType` values (raw-dialect passthrough deferred). */
+export const DB_COLUMN_TYPE_VALUES = [
+    DB_COLUMN_TYPE_UUID,
+    DB_COLUMN_TYPE_JSONB,
+    DB_COLUMN_TYPE_TIMESTAMP_WITH_TZ,
+];
+/**
+ * Legal `@dbColumnType` value → the field subtypes it may be applied to (ADR-0013,
+ * R6 Plan 2b). Any other (subtype × value) pairing — or an unrecognized value — is
+ * an ERR_BAD_ATTR_VALUE. Keyed by value; the value-set is enforced by membership in
+ * this map. Subtype names are the bare FIELD_SUBTYPE_* constants (string / timestamp).
+ */
+export const DB_COLUMN_TYPE_LEGAL_SUBTYPES = {
+    [DB_COLUMN_TYPE_UUID]: [FIELD_SUBTYPE_STRING],
+    [DB_COLUMN_TYPE_JSONB]: [FIELD_SUBTYPE_STRING],
+    [DB_COLUMN_TYPE_TIMESTAMP_WITH_TZ]: [FIELD_SUBTYPE_TIMESTAMP],
+};
 //# sourceMappingURL=db-constants.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"db-constants.js","sourceRoot":"","sources":["../../../src/persistence/db/db-constants.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAC1C,gGAAgG;AAChG,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC"}
+{"version":3,"file":"db-constants.js","sourceRoot":"","sources":["../../../src/persistence/db/db-constants.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EACL,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,qCAAqC,CAAC;AAE7C,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAC1C,gGAAgG;AAChG,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,cAAc,CAAC;AAExD,qFAAqF;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAC1C,sFAAsF;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAC5C,kGAAkG;AAClG,MAAM,CAAC,MAAM,gCAAgC,GAAG,mBAAmB,CAAC;AAEpE,yFAAyF;AACzF,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,mBAAmB;IACnB,oBAAoB;IACpB,gCAAgC;CACxB,CAAC;AAGX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAA2D;IACnG,CAAC,mBAAmB,CAAC,EAAE,CAAC,oBAAoB,CAAC;IAC7C,CAAC,oBAAoB,CAAC,EAAE,CAAC,oBAAoB,CAAC;IAC9C,CAAC,gCAAgC,CAAC,EAAE,CAAC,uBAAuB,CAAC;CACrD,CAAC"}

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

@@ -5,16 +5,16 @@
 import { TYPE_FIELD, TYPE_SOURCE } from "../../shared/base-types.js";
 import { FIELD_SUBTYPES } from "../../core/field/field-constants.js";
 import { SOURCE_SUBTYPE_RDB } from "../source/source-constants.js";
-import { columnSchema, dbIndexedSchema } from "./db-schema.js";
+import { columnSchema, dbIndexedSchema, dbColumnTypeSchema } from "./db-schema.js";
 import { sourceRdbAttrs } from "../source/source-schema.js";
 export const dbProvider = {
     id: "metaobjects-db",
     dependencies: ["metaobjects-core-types"],
-    description: "DB-domain attributes — @column / @db.indexed on fields, @table/@kind/@role/@schema on source.rdb.",
+    description: "DB-domain attributes — @column / @db.indexed / @dbColumnType on fields, @table/@kind/@role/@schema on source.rdb.",
     registerTypes(registry) {
         for (const subType of FIELD_SUBTYPES) {
             registry.extend(TYPE_FIELD, subType, {
-                attributes: [columnSchema, dbIndexedSchema],
+                attributes: [columnSchema, dbIndexedSchema, dbColumnTypeSchema],
             });
         }
         // source.rdb — @table/@kind/@role/@schema attrs.

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

@@ -1 +1 @@
-{"version":3,"file":"db-provider.js","sourceRoot":"","sources":["../../../src/persistence/db/db-provider.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,6EAA6E;AAC7E,qEAAqE;AACrE,qDAAqD;AAIrD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC9C,EAAE,EAAE,gBAAgB;IACpB,YAAY,EAAE,CAAC,wBAAwB,CAAC;IACxC,WAAW,EACT,mGAAmG;IACrG,aAAa,CAAC,QAAsB;QAClC,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;YACrC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE;gBACnC,UAAU,EAAE,CAAC,YAAY,EAAE,eAAe,CAAC;aAC5C,CAAC,CAAC;QACL,CAAC;QACD,iDAAiD;QACjD,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,kBAAkB,EAAE;YAC/C,UAAU,EAAE,CAAC,GAAG,cAAc,CAAC;SAChC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}
+{"version":3,"file":"db-provider.js","sourceRoot":"","sources":["../../../src/persistence/db/db-provider.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,6EAA6E;AAC7E,qEAAqE;AACrE,qDAAqD;AAIrD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC9C,EAAE,EAAE,gBAAgB;IACpB,YAAY,EAAE,CAAC,wBAAwB,CAAC;IACxC,WAAW,EACT,mHAAmH;IACrH,aAAa,CAAC,QAAsB;QAClC,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;YACrC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE;gBACnC,UAAU,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,kBAAkB,CAAC;aAChE,CAAC,CAAC;QACL,CAAC;QACD,iDAAiD;QACjD,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,kBAAkB,EAAE;YAC/C,UAAU,EAAE,CAAC,GAAG,cAAc,CAAC;SAChC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

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

@@ -3,4 +3,12 @@ import type { AttrSchema } from "../../registry.js";
 export declare const columnSchema: AttrSchema;
 /** `@db.indexed` — suppress the @filterable-without-index warning; on every field subtype. */
 export declare const dbIndexedSchema: AttrSchema;
+/**
+ * R6 Plan 2b: `@dbColumnType` — physical DB column-type override on every field
+ * subtype. The legal value depends on the field's logical subtype, so the
+ * subtype × value pairing is validated own-only by the loader
+ * (validateAttrSchema → ERR_BAD_ATTR_VALUE), not by a flat `allowedValues` set.
+ * The string valueType keeps the schema's type check intact.
+ */
+export declare const dbColumnTypeSchema: AttrSchema;
 //# sourceMappingURL=db-schema.d.ts.map

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

@@ -1 +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;AAUpD,4EAA4E;AAC5E,eAAO,MAAM,YAAY,EAAE,UAM1B,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,eAAe,EAAE,UAM7B,CAAC"}
+{"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;AAYpD,4EAA4E;AAC5E,eAAO,MAAM,YAAY,EAAE,UAM1B,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,eAAe,EAAE,UAM7B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,UAShC,CAAC"}

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

@@ -1,7 +1,7 @@
 // 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_COLUMN, FIELD_ATTR_DB_INDEXED, } from "./db-constants.js";
+import { FIELD_ATTR_COLUMN, FIELD_ATTR_DB_INDEXED, FIELD_ATTR_DB_COLUMN_TYPE, DB_COLUMN_TYPE_VALUES, } from "./db-constants.js";
 /** `@column` — column-name override on every field subtype (source.rdb). */
 export const columnSchema = {
     name: FIELD_ATTR_COLUMN,
@@ -16,4 +16,20 @@ export const dbIndexedSchema = {
     required: false,
     description: "When true, suppress the @filterable-without-index Loader warning (the field is indexed by other means).",
 };
+/**
+ * R6 Plan 2b: `@dbColumnType` — physical DB column-type override on every field
+ * subtype. The legal value depends on the field's logical subtype, so the
+ * subtype × value pairing is validated own-only by the loader
+ * (validateAttrSchema → ERR_BAD_ATTR_VALUE), not by a flat `allowedValues` set.
+ * The string valueType keeps the schema's type check intact.
+ */
+export const dbColumnTypeSchema = {
+    name: FIELD_ATTR_DB_COLUMN_TYPE,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    description: "Physical DB column-type override (ADR-0013 escape hatch). Legal values are " +
+        `${DB_COLUMN_TYPE_VALUES.join(" | ")}, each legal only on a specific logical ` +
+        "field subtype (uuid/jsonb on field.string, timestamp_with_tz on field.timestamp). " +
+        "The logical field type and its native binding are unchanged.",
+};
 //# 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,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"}
+{"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"}

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

@@ -1,6 +1,8 @@
 import { MetaData } from "../../shared/meta-data.js";
 export declare class MetaSource extends MetaData {
-    /** Physical SQL table/view name from @table (source.rdb). */
+    /** Physical SQL table/view name from the legacy @table attr. Kept as a
+     *  back-compat accessor that reads ONLY the @table slot — callers should
+     *  use physicalName for the FR-016 four-step rule. */
     get tableName(): string | undefined;
     /**
      * The effective kind for this source: the value of `@kind`, defaulting to
@@ -16,5 +18,17 @@ export declare class MetaSource extends MetaData {
     isReadOnly(): boolean;
     /** True when this source is writable (i.e. not read-only). */
     isWritable(): boolean;
+    /**
+     * Resolved physical SQL name for this source, following the FR-016 / ADR-0018
+     * four-step rule:
+     *   1. Kind-matching alias (e.g. @proc when @kind: "storedProc").
+     *   2. Legacy @table for non-table kind (pre-1.0 fallback).
+     *   3. Source's bare structural `name` via snake_case.
+     *   4. Owning entity's name via pluralize(snake_case).
+     *
+     * Callers needing the legacy raw @table slot only should use `tableName`;
+     * codegen / migrate / runtime should use `physicalName`.
+     */
+    get physicalName(): string;
 }
 //# 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;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"}
+{"version":3,"file":"meta-source.d.ts","sourceRoot":"","sources":["../../../src/persistence/source/meta-source.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AA0BrD,qBAAa,UAAW,SAAQ,QAAQ;IACtC;;0DAEsD;IACtD,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;IAIrB;;;;;;;;;;OAUG;IACH,IAAI,YAAY,IAAI,MAAM,CA8BzB;CACF"}

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

@@ -1,12 +1,25 @@
 // MetaSource — concrete node class for type=source nodes.
 // Declares where an object's data lives (Project E).
-// source.rdb uses @table/@kind/@role/@schema; read-only is derived from @kind.
+// source.rdb uses kind-aware physical-name aliases + @kind/@role/@schema;
+// read-only-ness is derived from @kind.
 //
 // Extends MetaData directly: no model wrapper, no metaOf() indirection.
 import { MetaData } from "../../shared/meta-data.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";
+import { pluralize, toSnakeCase } from "../../naming.js";
+import { SOURCE_ATTR_TABLE, SOURCE_ATTR_VIEW, SOURCE_ATTR_MATERIALIZED_VIEW, SOURCE_ATTR_PROC, SOURCE_ATTR_FUNCTION, SOURCE_ATTR_KIND, SOURCE_ATTR_ROLE, SOURCE_READ_ONLY_KINDS, DEFAULT_SOURCE_KIND, DEFAULT_SOURCE_ROLE, PHYSICAL_NAME_ATTR_BY_KIND, } from "./source-constants.js";
+/** Every kind-aware physical-name alias key, ordered for deterministic
+ *  iteration (matches the SOURCE_RDB_KINDS order). */
+const ALL_PHYSICAL_NAME_ALIASES = [
+    SOURCE_ATTR_TABLE,
+    SOURCE_ATTR_VIEW,
+    SOURCE_ATTR_MATERIALIZED_VIEW,
+    SOURCE_ATTR_PROC,
+    SOURCE_ATTR_FUNCTION,
+];
 export class MetaSource extends MetaData {
-    /** Physical SQL table/view name from @table (source.rdb). */
+    /** Physical SQL table/view name from the legacy @table attr. Kept as a
+     *  back-compat accessor that reads ONLY the @table slot — callers should
+     *  use physicalName for the FR-016 four-step rule. */
     get tableName() {
         const v = this.ownAttr(SOURCE_ATTR_TABLE);
         return typeof v === "string" && v !== "" ? v : undefined;
@@ -35,5 +48,44 @@ export class MetaSource extends MetaData {
     isWritable() {
         return !this.isReadOnly();
     }
+    /**
+     * Resolved physical SQL name for this source, following the FR-016 / ADR-0018
+     * four-step rule:
+     *   1. Kind-matching alias (e.g. @proc when @kind: "storedProc").
+     *   2. Legacy @table for non-table kind (pre-1.0 fallback).
+     *   3. Source's bare structural `name` via snake_case.
+     *   4. Owning entity's name via pluralize(snake_case).
+     *
+     * Callers needing the legacy raw @table slot only should use `tableName`;
+     * codegen / migrate / runtime should use `physicalName`.
+     */
+    get physicalName() {
+        const kind = this.effectiveKind;
+        // Step 1: kind-matching alias.
+        const canonicalAttr = PHYSICAL_NAME_ATTR_BY_KIND.get(kind);
+        if (canonicalAttr !== undefined) {
+            const v = this.ownAttr(canonicalAttr);
+            if (typeof v === "string" && v !== "")
+                return v;
+        }
+        // Step 2: legacy @table for non-table kind.
+        if (canonicalAttr !== SOURCE_ATTR_TABLE) {
+            const legacy = this.ownAttr(SOURCE_ATTR_TABLE);
+            if (typeof legacy === "string" && legacy !== "")
+                return legacy;
+        }
+        // Step 3: source's structural `name` via snake_case (no pluralization —
+        // the source's name IS the logical name).
+        if (this.name !== "") {
+            return toSnakeCase(this.name);
+        }
+        // Step 4: owning entity's name via pluralize(snake_case). The MetaData
+        // parent of a source is always the entity that declared it.
+        const owner = this.parent;
+        if (owner !== undefined && owner.name !== "") {
+            return pluralize(toSnakeCase(owner.name));
+        }
+        return "";
+    }
 }
 //# 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,+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"}
+{"version":3,"file":"meta-source.js","sourceRoot":"","sources":["../../../src/persistence/source/meta-source.ts"],"names":[],"mappings":"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"}

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

@@ -7,12 +7,26 @@ export type SourceSubType = (typeof SOURCE_SUBTYPES)[number];
 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. */
+/** Physical SQL table name. Canonical attr for @kind: "table" (default). */
 export declare const SOURCE_ATTR_TABLE = "table";
+/** Physical SQL view name. Canonical attr for @kind: "view". */
+export declare const SOURCE_ATTR_VIEW = "view";
+/** Physical SQL materialized-view name. Canonical attr for @kind: "materializedView". */
+export declare const SOURCE_ATTR_MATERIALIZED_VIEW = "materializedView";
+/** Physical SQL stored-procedure name. Canonical attr for @kind: "storedProc". */
+export declare const SOURCE_ATTR_PROC = "proc";
+/** Physical SQL table-function name. Canonical attr for @kind: "tableFunction". */
+export declare const SOURCE_ATTR_FUNCTION = "function";
 /** 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";
+/** FR-015: reference to an object.value describing the input shape of a callable
+ *  source. Required for @kind: "storedProc" | "tableFunction" that take args;
+ *  ignored for non-callable kinds. Wire-format symmetric with template.@payloadRef
+ *  (FR-004) — the typed-input pattern reuses object.value rather than minting a
+ *  new parameter.* node type. */
+export declare const SOURCE_ATTR_PARAMETER_REF = "parameterRef";
 export declare const SOURCE_KIND_TABLE = "table";
 export declare const SOURCE_KIND_VIEW = "view";
 export declare const SOURCE_KIND_MATERIALIZED_VIEW = "materializedView";
@@ -20,6 +34,11 @@ 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];
+/** Map @kind → canonical kind-aware physical-name attr key (FR-016 / ADR-0018).
+ *  Drives the four-step physical-name resolution rule and the canonical-serializer
+ *  per-kind rewrite. The single internal physical-name "slot" on a source is the
+ *  value of whichever alias matches the source's @kind. */
+export declare const PHYSICAL_NAME_ATTR_BY_KIND: ReadonlyMap<string, string>;
 /** 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). */

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":"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"}
+{"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;AAiBnD,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,SAAS,CAAC;AACvC,yFAAyF;AACzF,eAAO,MAAM,6BAA6B,qBAAqB,CAAC;AAChE,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,SAAS,CAAC;AACvC,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAE/C,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,SAAS,CAAC;AACvC,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC;;;;iCAIiC;AACjC,eAAO,MAAM,yBAAyB,iBAAiB,CAAC;AAExD,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;;;2DAG2D;AAC3D,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAMjE,CAAC;AAEH,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

@@ -21,12 +21,36 @@ 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. */
+// FR-016 / ADR-0007 point 2: the source's "logical name" is the structural
+// `name` field every MetaData node already carries — accessed via `source.name`,
+// NOT an @-attr. (An @-attr would conflict with the ERR_RESERVED_ATTR rule for
+// the reserved structural key `name`.) See the four-step physical-name
+// resolution rule on MetaSource.physicalName.
+// --- Per-kind physical-name aliases (FR-016 / ADR-0018) -----------------------
+// One canonical attr key per rdb @kind. The single internal physical-name
+// "slot" on the source is filled by whichever alias matches @kind; the
+// canonical serializer emits the kind-matching alias regardless of which
+// spelling was on input.
+/** Physical SQL table name. Canonical attr for @kind: "table" (default). */
 export const SOURCE_ATTR_TABLE = "table";
+/** Physical SQL view name. Canonical attr for @kind: "view". */
+export const SOURCE_ATTR_VIEW = "view";
+/** Physical SQL materialized-view name. Canonical attr for @kind: "materializedView". */
+export const SOURCE_ATTR_MATERIALIZED_VIEW = "materializedView";
+/** Physical SQL stored-procedure name. Canonical attr for @kind: "storedProc". */
+export const SOURCE_ATTR_PROC = "proc";
+/** Physical SQL table-function name. Canonical attr for @kind: "tableFunction". */
+export const SOURCE_ATTR_FUNCTION = "function";
 /** 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";
+/** FR-015: reference to an object.value describing the input shape of a callable
+ *  source. Required for @kind: "storedProc" | "tableFunction" that take args;
+ *  ignored for non-callable kinds. Wire-format symmetric with template.@payloadRef
+ *  (FR-004) — the typed-input pattern reuses object.value rather than minting a
+ *  new parameter.* node type. */
+export const SOURCE_ATTR_PARAMETER_REF = "parameterRef";
 export const SOURCE_KIND_TABLE = "table";
 export const SOURCE_KIND_VIEW = "view";
 export const SOURCE_KIND_MATERIALIZED_VIEW = "materializedView";
@@ -39,6 +63,17 @@ export const SOURCE_RDB_KINDS = [
     SOURCE_KIND_STORED_PROC,
     SOURCE_KIND_TABLE_FUNCTION,
 ];
+/** Map @kind → canonical kind-aware physical-name attr key (FR-016 / ADR-0018).
+ *  Drives the four-step physical-name resolution rule and the canonical-serializer
+ *  per-kind rewrite. The single internal physical-name "slot" on a source is the
+ *  value of whichever alias matches the source's @kind. */
+export const PHYSICAL_NAME_ATTR_BY_KIND = new Map([
+    [SOURCE_KIND_TABLE, SOURCE_ATTR_TABLE],
+    [SOURCE_KIND_VIEW, SOURCE_ATTR_VIEW],
+    [SOURCE_KIND_MATERIALIZED_VIEW, SOURCE_ATTR_MATERIALIZED_VIEW],
+    [SOURCE_KIND_STORED_PROC, SOURCE_ATTR_PROC],
+    [SOURCE_KIND_TABLE_FUNCTION, SOURCE_ATTR_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). */

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

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

@@ -1 +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"}
+{"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;AAkHpD,6EAA6E;AAC7E,eAAO,MAAM,cAAc,EAAE,UAAU,EAUtC,CAAC"}

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

@@ -1,13 +1,48 @@
 // 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. */
+import { SOURCE_ATTR_TABLE, SOURCE_ATTR_VIEW, SOURCE_ATTR_MATERIALIZED_VIEW, SOURCE_ATTR_PROC, SOURCE_ATTR_FUNCTION, SOURCE_ATTR_KIND, SOURCE_ATTR_ROLE, SOURCE_ATTR_SCHEMA, SOURCE_ATTR_PARAMETER_REF, SOURCE_RDB_KINDS, SOURCE_ROLES, } from "./source-constants.js";
+/** `@table` — physical SQL table name for @kind: "table" (default). FR-016: one
+ *  of five kind-aware physical-name aliases; all write to the same internal slot.
+ *  Pre-1.0 legacy: also accepted with non-table @kind (canonical-serializer
+ *  rewrites; loader emits WARN_LEGACY_PHYSICAL_NAME_ALIAS). */
 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.",
+    description: "Physical SQL table name for source.rdb @kind: \"table\" (default). FR-016: " +
+        "Defaults from the source's bare structural `name` via the project's columnNamingStrategy " +
+        "when omitted, then from the owning entity's name. Pre-1.0 legacy spelling for " +
+        "view/materializedView/storedProc/tableFunction kinds during the transition; " +
+        "canonical-serializer rewrites to the kind-matching alias.",
+};
+/** `@view` — physical SQL view name for @kind: "view" (FR-016 / ADR-0018). */
+const viewSchema = {
+    name: SOURCE_ATTR_VIEW,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    description: "Physical SQL view name for source.rdb @kind: \"view\". Same internal slot as @table.",
+};
+/** `@materializedView` — physical SQL materialized-view name for @kind: "materializedView". */
+const materializedViewSchema = {
+    name: SOURCE_ATTR_MATERIALIZED_VIEW,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    description: "Physical SQL materialized-view name for source.rdb @kind: \"materializedView\". Same internal slot as @table.",
+};
+/** `@proc` — physical SQL stored-procedure name for @kind: "storedProc". */
+const procSchema = {
+    name: SOURCE_ATTR_PROC,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    description: "Physical SQL stored-procedure name for source.rdb @kind: \"storedProc\". Same internal slot as @table.",
+};
+/** `@function` — physical SQL table-function name for @kind: "tableFunction". */
+const functionSchema = {
+    name: SOURCE_ATTR_FUNCTION,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    description: "Physical SQL table-function name for source.rdb @kind: \"tableFunction\". Same internal slot as @table.",
 };
 /** `@kind` — object kind within the rdb paradigm; drives read-only derivation. */
 const kindSchema = {
@@ -32,6 +67,32 @@ const schemaSchema = {
     required: false,
     description: "Optional database schema name (e.g. 'catalog', 'public'). Postgres defaults to 'public'; SQLite rejects any non-default value.",
 };
+/** `@parameterRef` — name or FQN of an object.value describing the input shape
+ *  of a callable source (FR-015). Required when @kind is "storedProc" or
+ *  "tableFunction" and the proc takes args; ignored for non-callable kinds.
+ *  Mirrors template.@payloadRef from FR-004. */
+const parameterRefSchema = {
+    name: SOURCE_ATTR_PARAMETER_REF,
+    valueType: ATTR_SUBTYPE_STRING,
+    required: false,
+    description: "FR-015: name or FQN of an object.value describing the input shape of " +
+        "this source's callable interface. Permitted on @kind: \"storedProc\" / " +
+        "\"tableFunction\"; rejected on non-callable kinds (table / view / " +
+        "materializedView). Field children of the referenced object.value become " +
+        "the call-site parameter list in declaration order. Symmetric with " +
+        "template.@payloadRef in FR-004 — the typed-input pattern reuses " +
+        "object.value rather than minting a new parameter.* node type.",
+};
 /** All attr schemas for source.rdb, to be registered via registry.extend. */
-export const sourceRdbAttrs = [tableSchema, kindSchema, roleSchema, schemaSchema];
+export const sourceRdbAttrs = [
+    tableSchema,
+    viewSchema,
+    materializedViewSchema,
+    procSchema,
+    functionSchema,
+    kindSchema,
+    roleSchema,
+    schemaSchema,
+    parameterRefSchema,
+];
 //# sourceMappingURL=source-schema.js.map

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

@@ -1 +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"}
+{"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,6BAA6B,EAC7B,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,YAAY,GACb,MAAM,uBAAuB,CAAC;AAE/B;;;+DAG+D;AAC/D,MAAM,WAAW,GAAe;IAC9B,IAAI,EAAE,iBAAiB;IACvB,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,6EAA6E;QAC7E,2FAA2F;QAC3F,gFAAgF;QAChF,8EAA8E;QAC9E,2DAA2D;CAC9D,CAAC;AAEF,8EAA8E;AAC9E,MAAM,UAAU,GAAe;IAC7B,IAAI,EAAE,gBAAgB;IACtB,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,sFAAsF;CACpG,CAAC;AAEF,+FAA+F;AAC/F,MAAM,sBAAsB,GAAe;IACzC,IAAI,EAAE,6BAA6B;IACnC,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,+GAA+G;CAClH,CAAC;AAEF,4EAA4E;AAC5E,MAAM,UAAU,GAAe;IAC7B,IAAI,EAAE,gBAAgB;IACtB,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,wGAAwG;CAC3G,CAAC;AAEF,iFAAiF;AACjF,MAAM,cAAc,GAAe;IACjC,IAAI,EAAE,oBAAoB;IAC1B,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,yGAAyG;CAC5G,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;;;gDAGgD;AAChD,MAAM,kBAAkB,GAAe;IACrC,IAAI,EAAE,yBAAyB;IAC/B,SAAS,EAAE,mBAAmB;IAC9B,QAAQ,EAAE,KAAK;IACf,WAAW,EACT,uEAAuE;QACvE,yEAAyE;QACzE,oEAAoE;QACpE,0EAA0E;QAC1E,oEAAoE;QACpE,kEAAkE;QAClE,+DAA+D;CAClE,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,WAAW;IACX,UAAU;IACV,sBAAsB;IACtB,UAAU;IACV,cAAc;IACd,UAAU;IACV,UAAU;IACV,YAAY;IACZ,kBAAkB;CACnB,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { MetaData } from "../../shared/meta-data.js";
+import { ParseError } from "../../errors.js";
+export declare function validateSourceParameterRef(root: MetaData): ParseError[];
+//# sourceMappingURL=validate-source-parameter-ref.d.ts.map

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

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