@rytass/bpm-core-nestjs-module 0.10.0 → 0.12.0

package/CHANGELOG.md

@@ -1,3 +1,49 @@
+## 0.12.0 (2026-08-27)
+
+### 🚀 Features
+
+- **form:** wire cell-level DataSources through the client and renderer ([c7561ad](https://github.com/Rytass/BPMCore/commit/c7561ad))
+- **form:** resolve table column DataSources per cell ([ca40a4c](https://github.com/Rytass/BPMCore/commit/ca40a4c))
+- **form:** add table column factories and row-scoped binding rename ([0c8c07d](https://github.com/Rytass/BPMCore/commit/0c8c07d))
+- **form:** validate and seed table values in the renderer helpers ([5c7edab](https://github.com/Rytass/BPMCore/commit/5c7edab))
+- **template:** reject published conditions that address table internals ([04d74e3](https://github.com/Rytass/BPMCore/commit/04d74e3))
+- **form:** validate submitted table form data ([69036d1](https://github.com/Rytass/BPMCore/commit/69036d1))
+- **form:** lint table field structure before publishing ([d9e95ee](https://github.com/Rytass/BPMCore/commit/d9e95ee))
+- **condition:** compile table emptiness from the row count ([624c96d](https://github.com/Rytass/BPMCore/commit/624c96d))
+- **form:** add table field definitions to the shared contract ([5f97165](https://github.com/Rytass/BPMCore/commit/5f97165))
+
+### 🩹 Fixes
+
+- **form:** keep a table's row indexes stable past a malformed row ([21d5a57](https://github.com/Rytass/BPMCore/commit/21d5a57))
+- **form:** read required DataSource parameters as own properties ([a5895a7](https://github.com/Rytass/BPMCore/commit/a5895a7))
+- **form:** report a table column's binding lint as an actionable binding error ([ed4fed2](https://github.com/Rytass/BPMCore/commit/ed4fed2))
+- **condition:** never match an edge value comparison against row records ([58b4194](https://github.com/Rytass/BPMCore/commit/58b4194))
+- **workflow:** no-op indexed set-form-field paths and read cells as own properties ([952b7bf](https://github.com/Rytass/BPMCore/commit/952b7bf))
+- **template:** close the whitespace gap in the table-internals condition lint ([6d15d07](https://github.com/Rytass/BPMCore/commit/6d15d07))
+- **condition:** keep table values from deciding form conditions ([894ef00](https://github.com/Rytass/BPMCore/commit/894ef00))
+- **workflow:** stop nested form writes from replacing a non-record value ([336951c](https://github.com/Rytass/BPMCore/commit/336951c))
+
+### ❤️ Thank You
+
+- Chia Yu Pai @fantasywind
+- Claude Opus 5 (1M context)
+
+## 0.11.0 (2026-08-18)
+
+### 🚀 Features
+
+- **notification:** bound delivery dispatch with a timeout ([d8115f0](https://github.com/Rytass/BPMCore/commit/d8115f0))
+
+### 🩹 Fixes
+
+- **notification:** read claimed ids from the UPDATE result pair ([2fe6e44](https://github.com/Rytass/BPMCore/commit/2fe6e44))
+- **notification:** move nodemailer to ^9.0.1 ([e094738](https://github.com/Rytass/BPMCore/commit/e094738))
+
+### ❤️ Thank You
+
+- Chia Yu Pai @fantasywind
+- Claude Opus 5
+
 ## 0.10.0 (2026-08-18)
 
 ### 🚀 Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rytass/bpm-core-nestjs-module",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Embeddable NestJS BPM approval workflow module: workflow engine, approval templates, forms, organization/member contracts, attachments, signatures, notifications, delegation, and TypeORM migrations.",
   "keywords": [
     "bpm",
@@ -155,7 +155,7 @@
     "@nestjs/core": ">=10.0.0",
     "@nestjs/graphql": ">=12.0.0",
     "@nestjs/typeorm": ">=10.0.0",
-    "@rytass/bpm-core-shared": "^0.10.0",
+    "@rytass/bpm-core-shared": "^0.12.0",
     "@rytass/secret-adapter-vault-nestjs": ">=0.4.5",
     "express": ">=4.0.0",
     "graphql": ">=16.0.0",
@@ -177,7 +177,7 @@
     "class-transformer": "^0.5.1",
     "class-validator": "^0.15.1",
     "handlebars": "^4.7.9",
-    "nodemailer": "^8.0.7",
+    "nodemailer": "^9.0.1",
     "tslib": "^2.3.0"
   }
 }

package/src/lib/condition/condition.service.js

@@ -5,7 +5,10 @@ const tslib_1 = require("tslib");
 const common_1 = require("@nestjs/common");
 const cel_js_1 = require("cel-js");
 const DEFAULT_MAX_EXPRESSION_LENGTH = 2000;
-const CEL_KEYWORDS = new Set(['false', 'has', 'in', 'null', 'true']);
+// `has` and `size` are CEL macros, not context identifiers; the root-identifier
+// lint must not report them as unknown. `size` is required by the table field
+// IS_FILLED / IS_EMPTY expressions (ADR 16 §3.8).
+const CEL_KEYWORDS = new Set(['false', 'has', 'in', 'null', 'size', 'true']);
 let ConditionService = class ConditionService {
     lintExpressions(expressions, options = {}) {
         return expressions.flatMap(({ expression, label }) => this.lintExpression(expression, label, options));

package/src/lib/condition/condition.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"condition.service.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/condition/condition.service.ts"],"names":[],"mappings":";;;;AAAA,2CAAiE;AACjE,mCAAyE;AAczE,MAAM,6BAA6B,GAAG,IAAI,CAAC;AAC3C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAG9D,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B,eAAe,CACb,WAA2C,EAC3C,UAAgC,EAAE;QAElC,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,CACnD,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,CAChD,CAAC;IACJ,CAAC;IAED,cAAc,CACZ,UAAqC,EACrC,KAAa,EACb,UAAgC,EAAE;QAElC,IAAI,OAAO,UAAU,KAAK,WAAW,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YAC7D,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,iBAAiB,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,mBAAmB,GACvB,OAAO,CAAC,mBAAmB,IAAI,6BAA6B,CAAC;QAE/D,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,iBAAiB,CAAC,MAAM,GAAG,mBAAmB,EAAE,CAAC;YACnD,OAAO,CAAC,GAAG,KAAK,YAAY,mBAAmB,sBAAsB,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,WAAW,GAAG,IAAA,cAAK,EAAC,iBAAiB,CAAC,CAAC;QAE7C,IAAI,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,OAAO,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,KAAK,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,mBAAmB,CAAC,iBAAiB,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,eAAe,CACb,UAAqC,EACrC,OAA6B,EAC7B,KAAa;QAEb,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;YACzD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAE7D,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,IAAI,4BAAmB,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;IACvE,CAAC;IAED,aAAa,CACX,UAAkB,EAClB,OAA6B,EAC7B,KAAa;QAEb,MAAM,iBAAiB,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;QAEnE,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,4BAAmB,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,WAAW,GAAG,IAAA,cAAK,EAAC,iBAAiB,CAAC,CAAC;QAE7C,IAAI,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,4BAAmB,CAC3B,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACnE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,OAAO,IAAA,iBAAQ,EAAC,WAAW,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,IAAI,4BAAmB,CAC3B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAA;AAtFY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,mBAAU,GAAE;GACA,gBAAgB,CAsF5B;AAED,SAAS,cAAc,CAAC,WAAwB;IAC9C,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC;AAChC,CAAC;AAED,SAAS,mBAAmB,CAC1B,UAAkB,EAClB,KAAa,EACb,OAA6B;IAE7B,MAAM,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAE9D,IAAI,CAAC,sBAAsB,EAAE,MAAM,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,sBAAsB,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;IACtE,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAC5B,mBAAmB,CAAC,QAAQ,CAC1B,8CAA8C,CAC/C,CACF,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,kBAAkB,GAAG;QACzB,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;KACzE,CAAC;IAEF,OAAO,kBAAkB,CAAC,GAAG,CAC3B,CAAC,UAAU,EAAE,EAAE,CAAC,GAAG,KAAK,sCAAsC,UAAU,EAAE,CAC3E,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,UAAkB;IAC7C,OAAO,UAAU,CAAC,OAAO,CAAC,mCAAmC,EAAE,IAAI,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"condition.service.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/condition/condition.service.ts"],"names":[],"mappings":"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"}

package/src/lib/form/form-schema.validator.js

@@ -4,6 +4,7 @@ exports.EMPTY_FORM_UI_SCHEMA = exports.EMPTY_FORM_SCHEMA = void 0;
 exports.parseAndValidateFormSchemas = parseAndValidateFormSchemas;
 exports.lintFormSchemaJson = lintFormSchemaJson;
 const form_1 = require("@rytass/bpm-core-shared/form");
+const form_table_reference_1 = require("./form-table-reference");
 const SUPPORTED_FIELD_TYPES = [
     'boolean',
     'checkbox',
@@ -15,6 +16,7 @@ const SUPPORTED_FIELD_TYPES = [
     'autocomplete',
     'radio',
     'select',
+    'table',
     'text',
     'textarea',
 ];
@@ -37,6 +39,11 @@ const DATE_FIELD_TYPES = new Set([
     'datetime',
 ]);
 const UI_WIDTHS = new Set(['FULL', 'HALF', 'THIRD']);
+const CONDITION_FIELD_KEYS = [
+    'visibleWhen',
+    'requiredWhen',
+    'readonlyWhen',
+];
 exports.EMPTY_FORM_SCHEMA = {
     fields: [],
     schemaVersion: 1,
@@ -105,7 +112,7 @@ function parseJsonValue(value, label) {
 }
 function lintFormSchemaValues(schema, uiSchema) {
     const schemaErrors = lintDefinitionSchema(schema);
-    const uiSchemaErrors = lintUiSchema(uiSchema, readFieldKeySet(schema));
+    const uiSchemaErrors = lintUiSchema(uiSchema, readFieldKeySet(schema), readTableFieldKeySet(schema));
     const errors = [...schemaErrors, ...uiSchemaErrors];
     return {
         errors,
@@ -121,8 +128,13 @@ function lintDefinitionSchema(schema) {
     if (!Array.isArray(fields)) {
         return [...versionErrors, 'schema.fields must be an array'];
     }
-    const fieldKeys = readFieldKeySet(schema);
-    const fieldErrors = fields.flatMap((field, index) => lintFieldDefinition(field, index, fieldKeys));
+    const tableFieldKeys = readTableFieldKeySet(schema);
+    const scope = {
+        columnKeys: null,
+        scalarFieldKeys: readScalarFieldKeySet(schema),
+        tableFieldKeys,
+    };
+    const fieldErrors = fields.flatMap((field, index) => lintFieldDefinition(field, index, scope));
     const duplicateErrors = readDuplicateFieldKeyErrors(fields);
     const dependencyErrors = lintFieldDependencyGraph(fields);
     return [
@@ -132,46 +144,80 @@ function lintDefinitionSchema(schema) {
         ...dependencyErrors,
     ];
 }
-function lintFieldDefinition(field, index, fieldKeys) {
+function lintFieldDefinition(field, index, scope) {
     if (!isRecord(field)) {
         return [`schema.fields[${index}] must be an object`];
     }
+    const path = `schema.fields[${index}]`;
     const type = field.type;
     const basicErrors = [
-        ...lintRequiredString(field.fieldKey, `schema.fields[${index}].fieldKey`),
-        ...lintRequiredString(field.label, `schema.fields[${index}].label`),
-        ...lintOptionalString(field.description, `schema.fields[${index}].description`),
-        ...lintOptionalString(field.placeholder, `schema.fields[${index}].placeholder`),
-        ...lintOptionalString(field.visibleWhen, `schema.fields[${index}].visibleWhen`),
-        ...lintOptionalString(field.requiredWhen, `schema.fields[${index}].requiredWhen`),
-        ...lintOptionalString(field.readonlyWhen, `schema.fields[${index}].readonlyWhen`),
-        ...(typeof field.required === 'boolean'
-            ? []
-            : [`schema.fields[${index}].required must be a boolean`]),
-        ...(isSupportedFieldType(type)
-            ? []
-            : [`schema.fields[${index}].type is not supported`]),
+        ...lintFieldIdentity(field, path),
+        ...lintOptionalString(field.visibleWhen, `${path}.visibleWhen`),
+        ...lintOptionalString(field.requiredWhen, `${path}.requiredWhen`),
+        ...lintOptionalString(field.readonlyWhen, `${path}.readonlyWhen`),
+        ...lintFieldRequiredFlag(field, path),
+        ...(isSupportedFieldType(type) ? [] : [`${path}.type is not supported`]),
+        ...lintConditionTableReferences(field, path, scope.tableFieldKeys),
     ];
     if (!isSupportedFieldType(type)) {
         return basicErrors;
     }
-    const path = `schema.fields[${index}]`;
+    return [...basicErrors, ...lintFieldTypeSpecifics(field, type, path, scope)];
+}
+function lintFieldTypeSpecifics(field, type, path, scope) {
     if (TEXT_FIELD_TYPES.has(type)) {
-        return [...basicErrors, ...lintTextField(field, path)];
+        return lintTextField(field, path);
     }
     if (NUMBER_FIELD_TYPES.has(type)) {
-        return [...basicErrors, ...lintNumberField(field, path)];
+        return lintNumberField(field, path);
     }
     if (DATE_FIELD_TYPES.has(type)) {
-        return [...basicErrors, ...lintDateField(field, path)];
+        return lintDateField(field, path);
     }
     if (SELECT_FIELD_TYPES.has(type)) {
-        return [...basicErrors, ...lintSelectField(field, type, path, fieldKeys)];
+        return lintSelectField(field, type, path, scope);
     }
     if (type === 'boolean') {
-        return [...basicErrors, ...lintBooleanField(field, path)];
+        return lintBooleanField(field, path);
+    }
+    if (type === 'table') {
+        return lintTableField(field, path, scope);
+    }
+    return lintFileUploadField(field, path);
+}
+function lintFieldIdentity(field, path) {
+    return [
+        ...lintRequiredString(field.fieldKey, `${path}.fieldKey`),
+        ...lintRequiredString(field.label, `${path}.label`),
+        ...lintOptionalString(field.description, `${path}.description`),
+        ...lintOptionalString(field.placeholder, `${path}.placeholder`),
+    ];
+}
+function lintFieldRequiredFlag(field, path) {
+    return typeof field.required === 'boolean'
+        ? []
+        : [`${path}.required must be a boolean`];
+}
+/**
+ * Form-level conditions cannot address a cell: neither the frontend nor the
+ * backend condition parser understands bracket paths, so referencing table
+ * internals is rejected outright instead of relying on a parse failure
+ * (ADR 16 §3.8). Referencing the table itself stays legal — that is what the
+ * IS_FILLED / IS_EMPTY operators compile to.
+ */
+function lintConditionTableReferences(field, path, tableFieldKeys) {
+    if (!tableFieldKeys.size) {
+        return [];
     }
-    return [...basicErrors, ...lintFileUploadField(field, path)];
+    return CONDITION_FIELD_KEYS.flatMap((conditionKey) => {
+        const expression = field[conditionKey];
+        if (typeof expression !== 'string') {
+            return [];
+        }
+        return [...tableFieldKeys]
+            .filter((tableKey) => (0, form_table_reference_1.referencesTableInternals)(expression, tableKey))
+            .map((tableKey) => `${path}.${conditionKey} must not reference table field internals: ${tableKey}`);
+    });
 }
 function lintTextField(field, path) {
     const minLengthErrors = lintOptionalInteger(field.minLength, `${path}.minLength`, 0);
@@ -206,8 +252,8 @@ function lintNumberField(field, path) {
 function lintDateField(field, path) {
     return lintOptionalDefaultValue(field.defaultValue, path, (value) => typeof value === 'string' || value === null);
 }
-function lintSelectField(field, type, path, fieldKeys) {
-    const sourceErrors = lintOptionSource(field, type, path, fieldKeys);
+function lintSelectField(field, type, path, scope) {
+    const sourceErrors = lintOptionSource(field, type, path, scope);
     const hasDataSource = Object.prototype.hasOwnProperty.call(field, 'dataSource');
     return [
         ...sourceErrors,
@@ -216,7 +262,7 @@ function lintSelectField(field, type, path, fieldKeys) {
             : lintSelectDefaultValue(field, type, path)),
     ];
 }
-function lintOptionSource(field, type, path, fieldKeys) {
+function lintOptionSource(field, type, path, scope) {
     const hasOptions = Object.prototype.hasOwnProperty.call(field, 'options');
     const hasDataSource = Object.prototype.hasOwnProperty.call(field, 'dataSource');
     const sourceCount = Number(hasOptions) + Number(hasDataSource);
@@ -239,7 +285,7 @@ function lintOptionSource(field, type, path, fieldKeys) {
     return [
         ...sourceShapeErrors,
         ...modeErrors,
-        ...lintDataSourceReference(field.dataSource, `${path}.dataSource`, fieldKeys),
+        ...lintDataSourceReference(field.dataSource, `${path}.dataSource`, scope),
     ];
 }
 function lintOptionMode(field, type, path) {
@@ -256,7 +302,7 @@ function lintOptionMode(field, type, path) {
         ? []
         : [`${path}.mode must be single or multiple`];
 }
-function lintDataSourceReference(value, path, fieldKeys) {
+function lintDataSourceReference(value, path, scope) {
     if (!isRecord(value)) {
         return [`${path} must be an object`];
     }
@@ -268,7 +314,7 @@ function lintDataSourceReference(value, path, fieldKeys) {
     if (!Array.isArray(bindings)) {
         return [...referenceErrors, `${path}.bindings must be an array`];
     }
-    const bindingErrors = bindings.flatMap((binding, index) => lintDataSourceBinding(binding, `${path}.bindings[${index}]`, fieldKeys));
+    const bindingErrors = bindings.flatMap((binding, index) => lintDataSourceBinding(binding, `${path}.bindings[${index}]`, scope));
     const parameters = bindings
         .filter(isRecord)
         .map((binding) => binding.parameter)
@@ -282,7 +328,7 @@ function lintDataSourceReference(value, path, fieldKeys) {
         ...duplicateParameters.map((parameter) => `${path}.bindings.parameter is duplicated: ${parameter}`),
     ];
 }
-function lintDataSourceBinding(value, path, fieldKeys) {
+function lintDataSourceBinding(value, path, scope) {
     if (!isRecord(value)) {
         return [`${path} must be an object`];
     }
@@ -295,9 +341,7 @@ function lintDataSourceBinding(value, path, fieldKeys) {
         return [
             ...errors,
             ...lintRequiredString(from.fieldKey, `${path}.from.fieldKey`),
-            ...(typeof from.fieldKey === 'string' && !fieldKeys.has(from.fieldKey)
-                ? [`${path}.from.fieldKey does not match a schema field`]
-                : []),
+            ...lintFieldBindingTarget(from.fieldKey, `${path}.from.fieldKey`, scope),
         ];
     }
     if (from.kind === 'CONSTANT') {
@@ -306,7 +350,37 @@ function lintDataSourceBinding(value, path, fieldKeys) {
             ...lintConstantValue(from.value, `${path}.from.value`),
         ];
     }
-    return [...errors, `${path}.from.kind must be FIELD or CONSTANT`];
+    if (from.kind === 'ROW_FIELD') {
+        const columnKeys = scope.columnKeys;
+        if (!columnKeys) {
+            return [
+                ...errors,
+                `${path}.from.kind ROW_FIELD is only supported inside a table column`,
+            ];
+        }
+        return [
+            ...errors,
+            ...lintRequiredString(from.columnKey, `${path}.from.columnKey`),
+            ...(typeof from.columnKey === 'string' && !columnKeys.has(from.columnKey)
+                ? [`${path}.from.columnKey does not match a table column`]
+                : []),
+        ];
+    }
+    return [...errors, `${path}.from.kind must be FIELD, CONSTANT, or ROW_FIELD`];
+}
+function lintFieldBindingTarget(fieldKey, path, scope) {
+    if (typeof fieldKey !== 'string') {
+        return [];
+    }
+    // A table value is a list of rows, so it can never stand in for a scalar
+    // data source parameter — and cross-row references have no single-value
+    // semantics in V1 (ADR 16 §3.4).
+    if (scope.tableFieldKeys.has(fieldKey)) {
+        return [`${path} must not reference a table field`];
+    }
+    return scope.scalarFieldKeys.has(fieldKey)
+        ? []
+        : [`${path} does not match a schema field`];
 }
 function lintConstantValue(value, path) {
     return value === null ||
@@ -324,6 +398,100 @@ function lintDynamicDefaultValue(field, path) {
 function lintBooleanField(field, path) {
     return lintOptionalDefaultValue(field.defaultValue, path, (value) => typeof value === 'boolean' || value === null);
 }
+function lintTableField(field, path, scope) {
+    const structureErrors = [
+        ...lintIdentifierKey(field.fieldKey, `${path}.fieldKey`),
+        ...lintOptionalString(field.addRowLabel, `${path}.addRowLabel`),
+        ...lintTableRowBounds(field, path),
+        ...(Object.prototype.hasOwnProperty.call(field, 'defaultValue')
+            ? [`${path}.defaultValue is not supported for table fields`]
+            : []),
+    ];
+    const columns = field.columns;
+    if (!Array.isArray(columns) || columns.length === 0) {
+        return [...structureErrors, `${path}.columns must contain at least one column`];
+    }
+    const columnKeys = columns
+        .filter(isRecord)
+        .map((column) => column.fieldKey)
+        .filter((columnKey) => typeof columnKey === 'string');
+    const columnScope = {
+        ...scope,
+        columnKeys: new Set(columnKeys),
+    };
+    const duplicatedColumnKeys = [
+        ...new Set(columnKeys.filter((columnKey, index) => columnKeys.indexOf(columnKey) !== index)),
+    ];
+    return [
+        ...structureErrors,
+        ...columns.flatMap((column, index) => lintTableColumn(column, `${path}.columns[${index}]`, columnScope)),
+        ...duplicatedColumnKeys.map((columnKey) => `${path}.columns fieldKey is duplicated: ${columnKey}`),
+    ];
+}
+function lintTableRowBounds(field, path) {
+    const minRowsErrors = lintOptionalInteger(field.minRows, `${path}.minRows`, 0);
+    const maxRowsErrors = lintOptionalInteger(field.maxRows, `${path}.maxRows`, 1);
+    const ceilingErrors = typeof field.maxRows === 'number' && field.maxRows > form_1.FORM_TABLE_MAX_ROWS
+        ? [
+            `${path}.maxRows must be less than or equal to ${form_1.FORM_TABLE_MAX_ROWS}`,
+        ]
+        : [];
+    const rangeErrors = typeof field.minRows === 'number' &&
+        typeof field.maxRows === 'number' &&
+        field.minRows > field.maxRows
+        ? [`${path}.minRows must be less than or equal to ${path}.maxRows`]
+        : [];
+    const implicitCeilingErrors = typeof field.minRows === 'number' &&
+        typeof field.maxRows === 'undefined' &&
+        field.minRows > form_1.FORM_TABLE_MAX_ROWS
+        ? [
+            `${path}.minRows must be less than or equal to ${form_1.FORM_TABLE_MAX_ROWS}`,
+        ]
+        : [];
+    return [
+        ...minRowsErrors,
+        ...maxRowsErrors,
+        ...ceilingErrors,
+        ...rangeErrors,
+        ...implicitCeilingErrors,
+    ];
+}
+function lintTableColumn(column, path, scope) {
+    if (!isRecord(column)) {
+        return [`${path} must be an object`];
+    }
+    const type = column.type;
+    const basicErrors = [
+        ...lintFieldIdentity(column, path),
+        ...lintIdentifierKey(column.fieldKey, `${path}.fieldKey`),
+        ...CONDITION_FIELD_KEYS.filter((conditionKey) => Object.prototype.hasOwnProperty.call(column, conditionKey)).map((conditionKey) => `${path}.${conditionKey} is not supported for table columns`),
+        ...lintFieldRequiredFlag(column, path),
+        ...lintTableColumnType(type, path),
+    ];
+    if (!isSupportedFieldType(type) || !(0, form_1.isTableColumnFieldType)(type)) {
+        return basicErrors;
+    }
+    return [...basicErrors, ...lintFieldTypeSpecifics(column, type, path, scope)];
+}
+function lintTableColumnType(type, path) {
+    if (type === 'table') {
+        return [`${path}.type must not be a nested table`];
+    }
+    if (!isSupportedFieldType(type)) {
+        return [`${path}.type is not supported`];
+    }
+    return (0, form_1.isTableColumnFieldType)(type)
+        ? []
+        : [`${path}.type is not supported for a table column`];
+}
+function lintIdentifierKey(value, path) {
+    if (typeof value !== 'string' || !value.trim()) {
+        return [];
+    }
+    return (0, form_1.isFormIdentifierKey)(value)
+        ? []
+        : [`${path} must match /^[A-Za-z_][A-Za-z0-9_]*$/`];
+}
 function lintFileUploadField(field, path) {
     return [
         ...lintOptionalInteger(field.maxFiles, `${path}.maxFiles`, 1),
@@ -378,7 +546,7 @@ function lintOptionalDefaultValue(value, path, predicate) {
     }
     return [`${path}.defaultValue has invalid type for field type`];
 }
-function lintUiSchema(uiSchema, fieldKeys) {
+function lintUiSchema(uiSchema, fieldKeys, tableFieldKeys) {
     if (!isRecord(uiSchema)) {
         return ['uiSchema must be an object'];
     }
@@ -389,10 +557,10 @@ function lintUiSchema(uiSchema, fieldKeys) {
     }
     return [
         ...versionErrors,
-        ...layout.flatMap((item, index) => lintLayoutItem(item, index, fieldKeys)),
+        ...layout.flatMap((item, index) => lintLayoutItem(item, index, fieldKeys, tableFieldKeys)),
     ];
 }
-function lintLayoutItem(item, index, fieldKeys) {
+function lintLayoutItem(item, index, fieldKeys, tableFieldKeys) {
     if (!isRecord(item)) {
         return [`uiSchema.layout[${index}] must be an object`];
     }
@@ -406,6 +574,11 @@ function lintLayoutItem(item, index, fieldKeys) {
         ...(isUiWidth(width)
             ? []
             : [`uiSchema.layout[${index}].width must be FULL, HALF, or THIRD`]),
+        ...(typeof fieldKey === 'string' &&
+            tableFieldKeys.has(fieldKey) &&
+            width !== 'FULL'
+            ? [`uiSchema.layout[${index}].width must be FULL for table fields`]
+            : []),
     ];
 }
 function readDuplicateFieldKeyErrors(fields) {
@@ -417,30 +590,68 @@ function readDuplicateFieldKeyErrors(fields) {
     const uniqueDuplicated = [...new Set(duplicated)];
     return uniqueDuplicated.map((key) => `schema.fields fieldKey is duplicated: ${key}`);
 }
+/**
+ * Two layers in one graph (ADR 16 §3.4): top-level fields joined by `FIELD`
+ * bindings, and each table's columns joined by `ROW_FIELD` bindings plus their
+ * `FIELD` edges up to the top level. Node ids are prefixed so a top-level key
+ * that happens to contain a dot cannot collide with a column node.
+ */
 function lintFieldDependencyGraph(fields) {
-    const dependencies = fields.reduce((graph, field) => {
-        if (!isRecord(field) || typeof field.fieldKey !== 'string') {
-            return graph;
-        }
-        const nextDependencies = isRecord(field.dataSource) &&
-            Array.isArray(field.dataSource.bindings)
-            ? field.dataSource.bindings
-                .filter(isRecord)
-                .map((binding) => binding.from)
-                .filter(isRecord)
-                .filter((from) => from.kind === 'FIELD')
-                .map((from) => from.fieldKey)
-                .filter((fieldKey) => typeof fieldKey === 'string')
-            : [];
-        return new Map(graph).set(field.fieldKey, nextDependencies);
-    }, new Map());
+    const dependencies = new Map(fields.filter(isRecord).flatMap(readFieldDependencyEntries));
     const cycles = [...dependencies.keys()]
-        .map((fieldKey) => findDependencyCycle(fieldKey, dependencies, []))
+        .map((node) => findDependencyCycle(node, dependencies, []))
         .filter((cycle) => Boolean(cycle))
-        .map((cycle) => cycle.join(' -> '));
+        .map((cycle) => cycle.map(readDependencyNodeLabel).join(' -> '));
     const uniqueCycles = [...new Set(cycles)];
     return uniqueCycles.map((cycle) => `schema.fields dependency cycle: ${cycle}`);
 }
+function readFieldDependencyEntries(field) {
+    if (typeof field.fieldKey !== 'string') {
+        return [];
+    }
+    const fieldKey = field.fieldKey;
+    if (field.type === 'table') {
+        return Array.isArray(field.columns)
+            ? field.columns
+                .filter(isRecord)
+                .filter((column) => typeof column.fieldKey === 'string')
+                .map((column) => [
+                `col:${fieldKey}.${String(column.fieldKey)}`,
+                readBindingSources(column).flatMap((from) => readColumnDependencyNode(from, fieldKey)),
+            ])
+            : [];
+    }
+    return [
+        [
+            `top:${fieldKey}`,
+            readBindingSources(field)
+                .filter((from) => from.kind === 'FIELD')
+                .map((from) => from.fieldKey)
+                .filter((dependencyKey) => typeof dependencyKey === 'string')
+                .map((dependencyKey) => `top:${dependencyKey}`),
+        ],
+    ];
+}
+function readColumnDependencyNode(from, tableKey) {
+    if (from.kind === 'FIELD' && typeof from.fieldKey === 'string') {
+        return [`top:${from.fieldKey}`];
+    }
+    if (from.kind === 'ROW_FIELD' && typeof from.columnKey === 'string') {
+        return [`col:${tableKey}.${from.columnKey}`];
+    }
+    return [];
+}
+function readBindingSources(field) {
+    return isRecord(field.dataSource) && Array.isArray(field.dataSource.bindings)
+        ? field.dataSource.bindings
+            .filter(isRecord)
+            .map((binding) => binding.from)
+            .filter(isRecord)
+        : [];
+}
+function readDependencyNodeLabel(node) {
+    return node.replace(/^(?:top|col):/u, '');
+}
 function findDependencyCycle(fieldKey, dependencies, path) {
     const cycleStart = path.indexOf(fieldKey);
     if (cycleStart >= 0) {
@@ -457,11 +668,21 @@ function findDependencyCycle(fieldKey, dependencies, path) {
     return null;
 }
 function readFieldKeySet(schema) {
+    return readFieldKeySetBy(schema, () => true);
+}
+function readTableFieldKeySet(schema) {
+    return readFieldKeySetBy(schema, (field) => field.type === 'table');
+}
+function readScalarFieldKeySet(schema) {
+    return readFieldKeySetBy(schema, (field) => field.type !== 'table');
+}
+function readFieldKeySetBy(schema, predicate) {
     if (!isRecord(schema) || !Array.isArray(schema.fields)) {
         return new Set();
     }
     return new Set(schema.fields
         .filter(isRecord)
+        .filter(predicate)
         .map((field) => field.fieldKey)
         .filter((fieldKey) => typeof fieldKey === 'string'));
 }