@tightknitai/slack-block-kit-validator 0.1.7-alpha.1 → 0.1.8

package/README.md

@@ -123,6 +123,8 @@ 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. |
+| `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). |
 | `checkSurfaceCompatibility` | `(blocks, surface) => string[]` | Blocks not allowed on the target surface (e.g. `alert` on message, `markdown` on modal, `file_input` outside modals). |
 | `checkCardActionsMax` | `(blocks) => string[]` | More than `CARD_ACTIONS_MAX` action buttons on a card block. |
@@ -139,12 +141,12 @@ Each returns an array of human-readable error strings — empty when valid.
 
 ## Coverage
 
-- **18 blocks**: actions, alert, card, carousel, context, context_actions, divider, file, header, image, input, markdown, plan, rich_text, section, table, task_card, video.
+- **19 blocks**: actions, alert, card, carousel, context, context_actions, 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, `focus_on_load` uniqueness, surface compatibility.
+- **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.
 
 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-data-visualization-consistency.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Enforces the two `data_visualization` rules Slack applies at runtime that
+ * JSON Schema can't express, because each depends on the values of sibling
+ * fields:
+ *
+ *   1. **Unique series names** — every series in a chart must have a distinct
+ *      `name`.
+ *   2. **Label ↔ category matching** — each series must contain exactly one
+ *      data point for every label in `axis_config.categories`, and no data
+ *      point may use a label outside `categories`.
+ *
+ * Only cartesian (line/bar/area) charts have `series` + `axis_config`; pie
+ * charts (segments only) carry no categories and are skipped. Structurally
+ * malformed charts are skipped too — the schema reports those.
+ *
+ * @param blocks - array of Block Kit blocks
+ * @returns array of error messages (empty when every chart is internally consistent)
+ */
+export declare function checkDataVisualizationConsistency(blocks: readonly {
+    type?: string;
+}[]): string[];
+//# sourceMappingURL=check-data-visualization-consistency.d.ts.map

package/dist/helpers/check-data-visualization-consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-data-visualization-consistency.d.ts","sourceRoot":"","sources":["../../src/helpers/check-data-visualization-consistency.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,EAAE,CAmEhG"}

package/dist/helpers/check-data-visualization-consistency.js

@@ -0,0 +1,75 @@
+/**
+ * Enforces the two `data_visualization` rules Slack applies at runtime that
+ * JSON Schema can't express, because each depends on the values of sibling
+ * fields:
+ *
+ *   1. **Unique series names** — every series in a chart must have a distinct
+ *      `name`.
+ *   2. **Label ↔ category matching** — each series must contain exactly one
+ *      data point for every label in `axis_config.categories`, and no data
+ *      point may use a label outside `categories`.
+ *
+ * Only cartesian (line/bar/area) charts have `series` + `axis_config`; pie
+ * charts (segments only) carry no categories and are skipped. Structurally
+ * malformed charts are skipped too — the schema reports those.
+ *
+ * @param blocks - array of Block Kit blocks
+ * @returns array of error messages (empty when every chart is internally consistent)
+ */
+export function checkDataVisualizationConsistency(blocks) {
+    const errors = [];
+    blocks.forEach((block, i) => {
+        if (block?.type !== "data_visualization") {
+            return;
+        }
+        const chart = block.chart;
+        const series = chart?.series;
+        if (!Array.isArray(series)) {
+            // Pie chart or malformed cartesian — nothing to cross-check here.
+            return;
+        }
+        // 1. Series names must be unique within the chart.
+        const seenNames = new Set();
+        series.forEach((entry) => {
+            const name = entry?.name;
+            if (typeof name !== "string") {
+                return;
+            }
+            if (seenNames.has(name)) {
+                errors.push(`blocks[${i}].chart.series has a duplicate series name '${name}' — series names must be unique within a chart`);
+            }
+            seenNames.add(name);
+        });
+        // 2. Every series' data points must line up exactly with the categories.
+        const categories = chart?.axis_config?.categories;
+        if (!Array.isArray(categories)) {
+            return;
+        }
+        const categorySet = new Set(categories.filter((c) => typeof c === "string"));
+        series.forEach((entry, si) => {
+            const data = entry?.data;
+            if (!Array.isArray(data)) {
+                return;
+            }
+            const labels = data.map((d) => d?.label).filter((l) => typeof l === "string");
+            // Labels that aren't a declared category.
+            for (const label of labels) {
+                if (!categorySet.has(label)) {
+                    errors.push(`blocks[${i}].chart.series[${si}] has a data point labeled '${label}' that is not in axis_config.categories`);
+                }
+            }
+            // Each category must be covered by exactly one data point.
+            for (const category of categorySet) {
+                const count = labels.filter((l) => l === category).length;
+                if (count === 0) {
+                    errors.push(`blocks[${i}].chart.series[${si}] is missing a data point for category '${category}'`);
+                }
+                else if (count > 1) {
+                    errors.push(`blocks[${i}].chart.series[${si}] has ${count} data points for category '${category}' — expected exactly one`);
+                }
+            }
+        });
+    });
+    return errors;
+}
+//# sourceMappingURL=check-data-visualization-consistency.js.map

package/dist/helpers/check-data-visualization-consistency.js.map

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

package/dist/helpers/check-data-visualization-max.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Maximum number of `data_visualization` blocks Slack renders in a single
+ * message. Additional ones beyond this cap are dropped.
+ */
+export declare const DATA_VISUALIZATION_MAX = 2;
+/**
+ * Checks that a payload contains at most {@link DATA_VISUALIZATION_MAX}
+ * `data_visualization` blocks. Slack renders only the first two data
+ * visualization blocks per message; any beyond that are silently dropped.
+ * @param blocks - array of Block Kit blocks
+ * @returns array of error messages (empty when within the limit)
+ */
+export declare function checkDataVisualizationMax(blocks: readonly {
+    type?: string;
+}[]): string[];
+//# sourceMappingURL=check-data-visualization-max.d.ts.map

package/dist/helpers/check-data-visualization-max.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-data-visualization-max.d.ts","sourceRoot":"","sources":["../../src/helpers/check-data-visualization-max.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,MAAM,EAAE,CAaxF"}

package/dist/helpers/check-data-visualization-max.js

@@ -0,0 +1,27 @@
+/**
+ * Maximum number of `data_visualization` blocks Slack renders in a single
+ * message. Additional ones beyond this cap are dropped.
+ */
+export const DATA_VISUALIZATION_MAX = 2;
+/**
+ * Checks that a payload contains at most {@link DATA_VISUALIZATION_MAX}
+ * `data_visualization` blocks. Slack renders only the first two data
+ * visualization blocks per message; any beyond that are silently dropped.
+ * @param blocks - array of Block Kit blocks
+ * @returns array of error messages (empty when within the limit)
+ */
+export function checkDataVisualizationMax(blocks) {
+    const indices = [];
+    blocks.forEach((block, i) => {
+        if (block?.type === "data_visualization") {
+            indices.push(i);
+        }
+    });
+    if (indices.length > DATA_VISUALIZATION_MAX) {
+        return [
+            `at most ${DATA_VISUALIZATION_MAX} 'data_visualization' blocks are allowed per message — found ${indices.length} at indices ${indices.join(", ")}`,
+        ];
+    }
+    return [];
+}
+//# sourceMappingURL=check-data-visualization-max.js.map

package/dist/helpers/check-data-visualization-max.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-data-visualization-max.js","sourceRoot":"","sources":["../../src/helpers/check-data-visualization-max.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAoC;IAC5E,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,IAAI,KAAK,EAAE,IAAI,KAAK,oBAAoB,EAAE,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;QAC5C,OAAO;YACL,WAAW,sBAAsB,gEAAgE,OAAO,CAAC,MAAM,eAAe,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACnJ,CAAC;IACJ,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;AAyDnD;;;;;;;;;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;AA+DnD;;;;;;;;;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

@@ -11,10 +11,15 @@ 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",
     "context_actions",
+    "data_visualization",
     "file",
     "markdown",
     "plan",
@@ -24,6 +29,7 @@ const BLOCKS_NOT_ALLOWED_IN_MODAL = new Set([
 const BLOCKS_NOT_ALLOWED_IN_HOME = new Set([
     "alert",
     "context_actions",
+    "data_visualization",
     "file",
     "markdown",
     "plan",

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,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC;IAC1C,MAAM;IACN,UAAU;IACV,iBAAiB;IACjB,MAAM;IACN,UAAU;IACV,MAAM;IACN,OAAO;IACP,WAAW;CACZ,CAAC,CAAC;AAEH,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IACzC,OAAO;IACP,iBAAiB;IACjB,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,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,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,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"}

package/dist/helpers.d.ts

@@ -1,5 +1,7 @@
 export * from "./helpers/check-card-actions-max.js";
 export * from "./helpers/check-cumulative-markdown-length.js";
+export * from "./helpers/check-data-visualization-consistency.js";
+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";

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,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,uCAAuC,CAAC;AACtD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC"}

package/dist/helpers.js

@@ -3,6 +3,8 @@
 // can't express, and can be composed with any other validator.
 export * from "./helpers/check-card-actions-max.js";
 export * from "./helpers/check-cumulative-markdown-length.js";
+export * from "./helpers/check-data-visualization-consistency.js";
+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";

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,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,uCAAuC,CAAC;AACtD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC"}

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

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://tightknit.com/schemas/slack-block-kit.schema.json",
   "title": "Slack Block Kit",
-  "description": "JSON Schema (draft 2020-12) for Slack Block Kit payloads. Validates a top-level array of blocks. Individual block, element, and composition object schemas are exposed via $defs for re-use. Compiled from https://docs.slack.dev/reference/block-kit (fetched 2026-04-16). Surface restrictions (messages vs modals vs home) and payload-level rules (e.g. cumulative 12k char markdown limit, single-table-per-message) are documented in $defs descriptions but not enforced at the per-block level.",
+  "description": "JSON Schema (draft 2020-12) for Slack Block Kit payloads. Validates a top-level array of blocks. Individual block, element, and composition object schemas are exposed via $defs for re-use. Compiled from https://docs.slack.dev/reference/block-kit (fetched 2026-04-16). Surface restrictions (messages vs modals vs home) and payload-level rules (e.g. cumulative 12k char markdown limit, single-table-per-message, max two data-visualization blocks per message) are documented in $defs descriptions but not enforced at the per-block level.",
   "type": "array",
   "minItems": 1,
   "maxItems": 100,
@@ -1210,6 +1210,109 @@
       }
     },
 
+    "data_visualization_data_point": {
+      "description": "A single point in a chart series: an x-axis label and its numeric value. The label must match one of axis_config.categories (enforced via checkDataVisualizationConsistency). Negative values are permitted — line/bar/area charts render against a zero baseline.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["label", "value"],
+      "properties": {
+        "label": { "type": "string", "minLength": 1, "maxLength": 20 },
+        "value": { "type": "number" }
+      }
+    },
+
+    "data_visualization_series": {
+      "description": "A named series of data points plotted on a line/bar/area chart. The name drives the chart legend and must be unique across all series in the same chart (enforced via checkDataVisualizationConsistency).",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "data"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1, "maxLength": 20 },
+        "data": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 20,
+          "items": { "$ref": "#/$defs/data_visualization_data_point" }
+        }
+      }
+    },
+
+    "data_visualization_axis_config": {
+      "description": "Axis configuration for cartesian (line/bar/area) charts. categories define the valid x-axis labels and their left-to-right display order.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["categories"],
+      "properties": {
+        "categories": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1, "maxLength": 20 }
+        },
+        "x_label": { "type": "string", "maxLength": 50 },
+        "y_label": { "type": "string", "maxLength": 50 }
+      }
+    },
+
+    "data_visualization_segment": {
+      "description": "A single slice of a pie chart. value must be greater than 0; Slack derives the displayed percentage from each segment's value as a share of the total.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["label", "value"],
+      "properties": {
+        "label": { "type": "string", "minLength": 1, "maxLength": 20 },
+        "value": { "type": "number", "exclusiveMinimum": 0 }
+      }
+    },
+
+    "data_visualization_chart": {
+      "description": "The chart rendered by a data_visualization block. line/bar/area charts use series + axis_config; pie charts use segments.",
+      "oneOf": [
+        {
+          "description": "Cartesian chart — line, bar, or area. 1–6 series; axis_config required.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "series", "axis_config"],
+          "properties": {
+            "type": { "enum": ["line", "bar", "area"] },
+            "series": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 6,
+              "items": { "$ref": "#/$defs/data_visualization_series" }
+            },
+            "axis_config": { "$ref": "#/$defs/data_visualization_axis_config" }
+          }
+        },
+        {
+          "description": "Pie chart. 1–6 segments.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["type", "segments"],
+          "properties": {
+            "type": { "const": "pie" },
+            "segments": {
+              "type": "array",
+              "minItems": 1,
+              "maxItems": 6,
+              "items": { "$ref": "#/$defs/data_visualization_segment" }
+            }
+          }
+        }
+      ]
+    },
+
+    "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",
+      "additionalProperties": false,
+      "required": ["type", "title", "chart"],
+      "properties": {
+        "type": { "const": "data_visualization" },
+        "block_id": { "$ref": "#/$defs/block_id" },
+        "title": { "type": "string", "minLength": 1, "maxLength": 50 },
+        "chart": { "$ref": "#/$defs/data_visualization_chart" }
+      }
+    },
+
     "divider_block": {
       "type": "object",
       "additionalProperties": false,
@@ -1242,7 +1345,8 @@
         "text": {
           "allOf": [{ "$ref": "#/$defs/plain_text_object" }, { "properties": { "text": { "maxLength": 150 } } }]
         },
-        "block_id": { "$ref": "#/$defs/block_id" }
+        "block_id": { "$ref": "#/$defs/block_id" },
+        "level": { "type": "integer", "minimum": 1, "maximum": 4 }
       }
     },
 
@@ -1521,6 +1625,7 @@
         { "$ref": "#/$defs/carousel_block" },
         { "$ref": "#/$defs/context_actions_block" },
         { "$ref": "#/$defs/context_block" },
+        { "$ref": "#/$defs/data_visualization_block" },
         { "$ref": "#/$defs/divider_block" },
         { "$ref": "#/$defs/file_block" },
         { "$ref": "#/$defs/header_block" },