@tightknitai/slack-block-kit-validator 0.1.9 → 0.1.11

package/README.md

@@ -85,6 +85,7 @@ import {
   findDuplicateBlockIds,
   checkCumulativeMarkdownLength,
   checkSingleTableBlock,
+  checkSinglePlanBlock,
   checkFocusOnLoadUniqueness,
   checkSurfaceCompatibility,
 } from "@tightknitai/slack-block-kit-validator";
@@ -123,6 +124,7 @@ The schema uses `$defs` for every block, element, composition object, rich-text
 | `findDuplicateBlockIds` | `(blocks) => string[]` | Duplicate `block_id` values in a blocks array. |
 | `checkCumulativeMarkdownLength` | `(blocks) => string[]` | Sum of all `markdown` block text > 12,000 chars. |
 | `checkSingleTableBlock` | `(blocks) => string[]` | More than one `table` block per payload. |
+| `checkSinglePlanBlock` | `(blocks) => string[]` | More than one `plan` block per payload. |
 | `checkDataVisualizationMax` | `(blocks) => string[]` | More than two `data_visualization` blocks per message. |
 | `checkDataVisualizationConsistency` | `(blocks) => string[]` | Chart series with duplicate names, or data points that don't line up with `axis_config.categories`. |
 | `checkFocusOnLoadUniqueness` | `(blocks) => string[]` | More than one element with `focus_on_load: true` in a view (walks nested elements + accessories). |
@@ -141,12 +143,12 @@ Each returns an array of human-readable error strings — empty when valid.
 
 ## Coverage
 
-- **20 blocks**: actions, alert, card, carousel, container, context, context_actions, data_visualization, divider, file, header, image, input, markdown, plan, rich_text, section, table, task_card, video.
+- **21 blocks**: actions, alert, card, carousel, container, context, context_actions, data_table, data_visualization, divider, file, header, image, input, markdown, plan, rich_text, section, table, task_card, video.
 - **All block elements**: button, icon_button, workflow_button, feedback_buttons, plain_text / email / url / number inputs, datepicker, datetimepicker, timepicker, file_input, rich_text_input, checkboxes, radio_buttons, image, overflow, url source, and all 5 single + 5 multi-select menu variants.
 - **All 9 composition objects**: text (plain_text + mrkdwn), confirm, option (3 contextual variants), option_group, slack_file, dispatch_action_config, conversation_filter, trigger, workflow.
 - **Rich text**: 4 container kinds (section, list, preformatted, quote) + 10 leaf kinds (text, link, user, usergroup, team, channel, emoji, broadcast, color, date) with style flags.
 - **View envelopes**: `modal_view` + `home_view` under `$defs`.
-- **Cross-payload rules** (via helpers): dup `block_id`, cumulative markdown, single-table, two-data-visualization-per-message, chart series/category consistency, `focus_on_load` uniqueness, surface compatibility.
+- **Cross-payload rules** (via helpers): dup `block_id`, cumulative markdown, single-table, single-plan, two-data-visualization-per-message, chart series/category consistency, `focus_on_load` uniqueness, surface compatibility.
 
 Every documented `maxLength`, regex (date / time / user ID / channel ID / team ID format), enum value, and array cardinality limit is enforced structurally.
 

package/dist/helpers/check-single-plan-block.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Checks that a payload contains at most one `plan` block. Slack rejects
+ * multi-plan payloads with `invalid_blocks` / "Cannot have more than 1 plan
+ * block" (surfaced on e.g. `chat.update`).
+ * @param blocks - array of Block Kit blocks
+ * @returns array of error messages (empty when zero or one `plan` block present)
+ */
+export declare function checkSinglePlanBlock(blocks: readonly {
+    type?: string;
+}[]): string[];
+//# sourceMappingURL=check-single-plan-block.d.ts.map

package/dist/helpers/check-single-plan-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-single-plan-block.d.ts","sourceRoot":"","sources":["../../src/helpers/check-single-plan-block.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,EAAE,CAWnF"}

package/dist/helpers/check-single-plan-block.js

@@ -0,0 +1,20 @@
+/**
+ * Checks that a payload contains at most one `plan` block. Slack rejects
+ * multi-plan payloads with `invalid_blocks` / "Cannot have more than 1 plan
+ * block" (surfaced on e.g. `chat.update`).
+ * @param blocks - array of Block Kit blocks
+ * @returns array of error messages (empty when zero or one `plan` block present)
+ */
+export function checkSinglePlanBlock(blocks) {
+    const indices = [];
+    blocks.forEach((block, i) => {
+        if (block?.type === "plan") {
+            indices.push(i);
+        }
+    });
+    if (indices.length > 1) {
+        return [`only one 'plan' block is allowed per message — found ${indices.length} at indices ${indices.join(", ")}`];
+    }
+    return [];
+}
+//# sourceMappingURL=check-single-plan-block.js.map

package/dist/helpers/check-single-plan-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-single-plan-block.js","sourceRoot":"","sources":["../../src/helpers/check-single-plan-block.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoC;IACvE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,IAAI,KAAK,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,wDAAwD,OAAO,CAAC,MAAM,eAAe,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/helpers/check-surface-compatibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-surface-compatibility.d.ts","sourceRoot":"","sources":["../../src/helpers/check-surface-compatibility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAiEnD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EAAE,EACjE,OAAO,EAAE,OAAO,GACf,MAAM,EAAE,CAsBV"}
+{"version":3,"file":"check-surface-compatibility.d.ts","sourceRoot":"","sources":["../../src/helpers/check-surface-compatibility.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAqEnD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EAAE,EACjE,OAAO,EAAE,OAAO,GACf,MAAM,EAAE,CAsBV"}

package/dist/helpers/check-surface-compatibility.js

@@ -3,23 +3,26 @@
 // block entry there has an `available-in-surfaces` array valued with some
 // subset of ["Modals", "Messages", "Home tabs"]. Whatever's missing from
 // that array is what we forbid here.
-// `file` is only produced by Slack when retrieving messages that contain
-// remote files; apps cannot send it outbound on any surface
-// (https://docs.slack.dev/reference/block-kit/blocks/file-block:
-// "You can't add this block to app surfaces directly...").
+//
+// Four entries below intentionally deviate from blocks.json — Slack's canonical
+// data lists a surface where the block doesn't actually render. Each is
+// empirically grounded:
+//   • card / modals   — blocks.json lists Modals; fails to render there.
+//   • file / messages — inbound-only; apps can't send it outbound at all
+//     (https://docs.slack.dev/reference/block-kit/blocks/file-block:
+//     "You can't add this block to app surfaces directly...").
+//   • table / home tabs — blocks.json lists Home tabs; Tightknit testing shows
+//     the table block renders on messages only (modals and home drop it).
+//   • data_table / home tabs — same: blocks.json lists Home tabs, but as a
+//     table-family block it inherits table's messages-only behavior (mirrored
+//     for consistency, pending independent confirmation).
 const BLOCKS_NOT_ALLOWED_IN_MESSAGE = new Set(["alert", "file"]);
-// carousel/card are listed as modal-available in Slack's blocks.json but
-// empirically fail to render inside modal views — confirmed by the PR author
-// against the live API. They work in messages and home tabs.
-// `data_visualization` is a messages-only block — its reference page lists
-// "Available in Surfaces: Messages" only
-// (https://docs.slack.dev/reference/block-kit/blocks/data-visualization-block).
-// Forbidden in both modals and home tabs.
 const BLOCKS_NOT_ALLOWED_IN_MODAL = new Set([
     "card",
     "carousel",
     "container",
     "context_actions",
+    "data_table",
     "data_visualization",
     "file",
     "markdown",
@@ -31,6 +34,7 @@ const BLOCKS_NOT_ALLOWED_IN_HOME = new Set([
     "alert",
     "container",
     "context_actions",
+    "data_table",
     "data_visualization",
     "file",
     "markdown",

package/dist/helpers/check-surface-compatibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"check-surface-compatibility.js","sourceRoot":"","sources":["../../src/helpers/check-surface-compatibility.ts"],"names":[],"mappings":"AAMA,2EAA2E;AAC3E,0EAA0E;AAC1E,0EAA0E;AAC1E,yEAAyE;AACzE,qCAAqC;AACrC,yEAAyE;AACzE,4DAA4D;AAC5D,iEAAiE;AACjE,2DAA2D;AAC3D,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjE,yEAAyE;AACzE,6EAA6E;AAC7E,6DAA6D;AAC7D,2EAA2E;AAC3E,yCAAyC;AACzC,gFAAgF;AAChF,0CAA0C;AAC1C,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC;IAC1C,MAAM;IACN,UAAU;IACV,WAAW;IACX,iBAAiB;IACjB,oBAAoB;IACpB,MAAM;IACN,UAAU;IACV,MAAM;IACN,OAAO;IACP,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IACzC,OAAO;IACP,WAAW;IACX,iBAAiB;IACjB,oBAAoB;IACpB,MAAM;IACN,UAAU;IACV,MAAM;IACN,OAAO;IACP,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAiC;IACzD,OAAO,EAAE,6BAA6B;IACtC,KAAK,EAAE,2BAA2B;IAClC,IAAI,EAAE,0BAA0B;CACjC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,qBAAqB,GAA4B;IACrD,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,GAAG;CACV,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAiE,EACjE,OAAgB;IAEhB,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,YAAY,OAAO,oBAAoB,SAAS,gBAAgB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,IAAI,KAAK,EAAE,IAAI,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,KAAK,CAAC,IAAI,gCAAgC,OAAO,GAAG,CAAC,CAAC;YACxF,mEAAmE;YACnE,uCAAuC;YACvC,OAAO;QACT,CAAC;QACD,IAAI,KAAK,EAAE,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,KAAK,YAAY,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YAC3F,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,uEAAuE,OAAO,IAAI,CAAC,CAAC;QAC7G,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"check-surface-compatibility.js","sourceRoot":"","sources":["../../src/helpers/check-surface-compatibility.ts"],"names":[],"mappings":"AAMA,2EAA2E;AAC3E,0EAA0E;AAC1E,0EAA0E;AAC1E,yEAAyE;AACzE,qCAAqC;AACrC,EAAE;AACF,gFAAgF;AAChF,wEAAwE;AACxE,wBAAwB;AACxB,yEAAyE;AACzE,yEAAyE;AACzE,qEAAqE;AACrE,+DAA+D;AAC/D,+EAA+E;AAC/E,0EAA0E;AAC1E,2EAA2E;AAC3E,8EAA8E;AAC9E,0DAA0D;AAC1D,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjE,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC;IAC1C,MAAM;IACN,UAAU;IACV,WAAW;IACX,iBAAiB;IACjB,YAAY;IACZ,oBAAoB;IACpB,MAAM;IACN,UAAU;IACV,MAAM;IACN,OAAO;IACP,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IACzC,OAAO;IACP,WAAW;IACX,iBAAiB;IACjB,YAAY;IACZ,oBAAoB;IACpB,MAAM;IACN,UAAU;IACV,MAAM;IACN,OAAO;IACP,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAiC;IACzD,OAAO,EAAE,6BAA6B;IACtC,KAAK,EAAE,2BAA2B;IAClC,IAAI,EAAE,0BAA0B;CACjC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,qBAAqB,GAA4B;IACrD,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,GAAG;CACV,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAiE,EACjE,OAAgB;IAEhB,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,YAAY,OAAO,oBAAoB,SAAS,gBAAgB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAChG,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,IAAI,KAAK,EAAE,IAAI,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,KAAK,CAAC,IAAI,gCAAgC,OAAO,GAAG,CAAC,CAAC;YACxF,mEAAmE;YACnE,uCAAuC;YACvC,OAAO;QACT,CAAC;QACD,IAAI,KAAK,EAAE,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,KAAK,YAAY,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;YAC3F,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,uEAAuE,OAAO,IAAI,CAAC,CAAC;QAC7G,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/helpers.d.ts

@@ -5,6 +5,7 @@ export * from "./helpers/check-data-visualization-max.js";
 export * from "./helpers/check-focus-on-load-uniqueness.js";
 export * from "./helpers/check-number-input-bounds.js";
 export * from "./helpers/check-response-url-enabled-context.js";
+export * from "./helpers/check-single-plan-block.js";
 export * from "./helpers/check-single-table-block.js";
 export * from "./helpers/check-surface-compatibility.js";
 export * from "./helpers/find-duplicate-block-ids.js";

package/dist/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAIA,cAAc,qCAAqC,CAAC;AACpD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,mDAAmD,CAAC;AAClE,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AACvD,cAAc,iDAAiD,CAAC;AAChE,cAAc,uCAAuC,CAAC;AACtD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAIA,cAAc,qCAAqC,CAAC;AACpD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,mDAAmD,CAAC;AAClE,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AACvD,cAAc,iDAAiD,CAAC;AAChE,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC"}

package/dist/helpers.js

@@ -8,6 +8,7 @@ export * from "./helpers/check-data-visualization-max.js";
 export * from "./helpers/check-focus-on-load-uniqueness.js";
 export * from "./helpers/check-number-input-bounds.js";
 export * from "./helpers/check-response-url-enabled-context.js";
+export * from "./helpers/check-single-plan-block.js";
 export * from "./helpers/check-single-table-block.js";
 export * from "./helpers/check-surface-compatibility.js";
 export * from "./helpers/find-duplicate-block-ids.js";

package/dist/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,+DAA+D;AAE/D,cAAc,qCAAqC,CAAC;AACpD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,mDAAmD,CAAC;AAClE,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AACvD,cAAc,iDAAiD,CAAC;AAChE,cAAc,uCAAuC,CAAC;AACtD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,+DAA+D;AAE/D,cAAc,qCAAqC,CAAC;AACpD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,mDAAmD,CAAC;AAClE,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AACvD,cAAc,iDAAiD,CAAC;AAChE,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC"}

package/dist/slack-block-kit.schema.json

@@ -1352,6 +1352,69 @@
       ]
     },
 
+    "data_table_cell": {
+      "description": "A cell inside a data_table_block row. `raw_text` / `raw_number` for simple values, `rich_text` for formatted content. Per https://docs.slack.dev/reference/block-kit/blocks/data-table-block. The docs' per-cell schemas list `properties` without a `required` array; we mirror `table_cell` and require the value-bearing field(s). The rule 'the first (header) row cannot contain rich_text cells' is a row-position constraint JSON Schema can't express and is not enforced here.",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "text"],
+          "properties": {
+            "type": { "const": "raw_text" },
+            "text": { "type": "string", "minLength": 1 }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "value"],
+          "properties": {
+            "type": { "const": "raw_number" },
+            "value": { "type": "number" },
+            "text": { "type": "string", "minLength": 1 }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "elements"],
+          "properties": {
+            "type": { "const": "rich_text" },
+            "elements": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/rich_text_container_element" }
+            }
+          }
+        }
+      ]
+    },
+
+    "data_table_block": {
+      "description": "Rich, interactive table with pagination, sorting, and filtering (https://docs.slack.dev/reference/block-kit/blocks/data-table-block). Distinct from `table_block`, which is a simpler static table. The single-table and aggregate 10,000-character limits are payload-level rules not enforced here. `row_header_column_index` must point at an existing column, a cross-field rule JSON Schema can't check (bounded to 0–19 since a row has at most 20 cells).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "caption", "rows"],
+      "properties": {
+        "type": { "const": "data_table" },
+        "block_id": { "$ref": "#/$defs/block_id" },
+        "caption": { "type": "string", "minLength": 1 },
+        "page_size": { "type": "integer", "minimum": 1, "maximum": 100 },
+        "row_header_column_index": { "type": "integer", "minimum": 0, "maximum": 19 },
+        "rows": {
+          "description": "First row is the header; 2–101 rows total (1 header + 1–100 data rows), 1–20 cells per row.",
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 101,
+          "items": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 20,
+            "items": { "$ref": "#/$defs/data_table_cell" }
+          }
+        }
+      }
+    },
+
     "data_visualization_block": {
       "description": "Renders data as a line, bar, area, or pie chart. Messages only (https://docs.slack.dev/reference/block-kit/blocks/data-visualization-block). Slack renders at most two data_visualization blocks per message (enforced via the checkDataVisualizationMax helper, since JSON Schema can't count sibling blocks). Two further runtime rules are enforced via checkDataVisualizationConsistency, since they depend on sibling-field values JSON Schema can't compare: series names must be unique within a chart, and each series must contain exactly one data point per axis_config.categories label.",
       "type": "object",
@@ -1678,6 +1741,7 @@
         { "$ref": "#/$defs/container_block" },
         { "$ref": "#/$defs/context_actions_block" },
         { "$ref": "#/$defs/context_block" },
+        { "$ref": "#/$defs/data_table_block" },
         { "$ref": "#/$defs/data_visualization_block" },
         { "$ref": "#/$defs/divider_block" },
         { "$ref": "#/$defs/file_block" },