@assistant-ui/react-generative-ui 0.0.6 → 0.0.8

package/dist/slack/constants.d.ts

@@ -0,0 +1,111 @@
+import { SlackAlertBlock, SlackButtonElement, SlackCardBlock, SlackCarouselBlock, SlackContextBlock, SlackDataTableBlock, SlackDataTableCell, SlackImageBlock, SlackSectionBlock, SlackTextObject } from "./types.js";
+//#region src/slack/constants.d.ts
+/** The maximum normalized traversal depth. */
+declare const MAX_TRAVERSAL_DEPTH = 64;
+/**
+ * The maximum number of entries kept at any single level (root, or a
+ * `children` array at any depth) of the raw spec, before it ever reaches
+ * `normalizeSpec`. Bounds a hostile array's reported `length` so the pre-pass
+ * can never be made to walk further than this regardless of what the array
+ * claims about itself.
+ */
+declare const CHILDREN_CAP = 200;
+/**
+ * The total number of nodes the pre-normalization bounding walk will visit
+ * across one call, regardless of how many times a shared reference recurs.
+ * Bounds the combinatorial work a DAG of shared or self-referential nodes
+ * would otherwise force even though each individual array stays within
+ * {@link CHILDREN_CAP}.
+ */
+declare const NODE_BUDGET = 5000;
+/** The block limit for a Slack message. */
+declare const MESSAGE_BLOCK_CAP = 50;
+/** The block limit for a Slack modal. */
+declare const MODAL_BLOCK_CAP = 100;
+/**
+ * The maximum number of top-level blocks accepted when parsing Slack Block
+ * Kit JSON back into generative UI, guarding against a hostile or malformed
+ * payload.
+ */
+declare const INBOUND_BLOCK_CAP = 200;
+/** The character limit for header text. */
+declare const HEADER_TEXT_CAP = 150;
+/** The character limit for section text. */
+declare const SECTION_TEXT_CAP = 3000;
+/** The maximum number of fields in one section. */
+declare const FACT_FIELD_CAP = 10;
+/** The character limit for one section field. */
+declare const FACT_FIELD_TEXT_CAP = 2000;
+/** The character limit for button labels and option labels. */
+declare const INTERACTIVE_TEXT_CAP = 75;
+/** The character limit for an action_id. */
+declare const ACTION_ID_CAP = 255;
+/** The character limit for a button's serialized value payload. */
+declare const BUTTON_VALUE_CAP = 2000;
+/** The maximum number of elements in one actions block. */
+declare const ACTIONS_ELEMENT_CAP = 25;
+/** The maximum number of options in a static select. */
+declare const SELECT_OPTION_CAP = 100;
+/** The maximum number of options in a radio-button group. */
+declare const RADIO_OPTION_CAP = 10;
+/** The character limit for a select or input placeholder. */
+declare const PLACEHOLDER_TEXT_CAP = 150;
+/** The character limit for an input's label. */
+declare const INPUT_LABEL_CAP = 2000;
+/** The maximum number of elements in one context block. */
+declare const CONTEXT_ELEMENT_CAP = 10;
+/** The character limit for one context element's text. */
+declare const CONTEXT_TEXT_CAP = 3000;
+/** The character limit for card titles and subtitles. */
+declare const CARD_TITLE_CAP = 150;
+/** The character limit for a card's body text. */
+declare const CARD_BODY_CAP = 200;
+/** The character limit for a card's subtext. */
+declare const CARD_SUBTEXT_CAP = 200;
+/** The maximum number of buttons in a card's actions. */
+declare const CARD_ACTIONS_CAP = 3;
+/** The minimum number of elements in a renderable carousel. */
+declare const CAROUSEL_CARD_MIN = 1;
+/** The maximum number of elements in a carousel. */
+declare const CAROUSEL_CARD_CAP = 10;
+/** The character limit for an alert's text. */
+declare const ALERT_TEXT_CAP = 200;
+/**
+ * The maximum number of data rows in a data-table block; the emitted `rows`
+ * array additionally carries one header row.
+ */
+declare const DATA_TABLE_ROW_CAP = 100;
+/** The maximum number of columns in a data-table block. */
+declare const DATA_TABLE_COLUMN_CAP = 20;
+/**
+ * The cumulative character limit (summed across every cell's text) shared by
+ * every data-table block in one payload.
+ */
+declare const DATA_TABLE_CHAR_BUDGET = 10000;
+/** The caption emitted on every native data-table block. */
+declare const TABLE_CAPTION = "Table";
+/** The cumulative character limit for native markdown blocks. */
+declare const MARKDOWN_TEXT_BUDGET = 12000;
+/** Builds the message-surface fallback for an alert. */
+declare function buildAlertFallback(title: string, description: string, tone: "info" | "success" | "warning" | "danger"): readonly [SlackContextBlock, SlackSectionBlock];
+/** Builds a 2026 Slack modal-only alert block, mapping `tone` to its `level`. */
+declare function buildAlertBlock(text: string, tone: "info" | "success" | "warning" | "danger"): SlackAlertBlock;
+type CardBlockFields = {
+  readonly heroImage?: SlackImageBlock;
+  readonly title?: SlackTextObject;
+  readonly subtitle?: SlackTextObject;
+  readonly body?: SlackTextObject;
+  readonly subtext?: SlackTextObject;
+  readonly actions?: readonly SlackButtonElement[];
+};
+/** Builds a 2026 Slack card block from its already-clamped fields. */
+declare function buildCardBlock(fields: CardBlockFields): SlackCardBlock;
+/** Builds a 2026 Slack carousel block. */
+declare function buildCarouselBlock(elements: readonly SlackCardBlock[]): SlackCarouselBlock;
+/** Builds a 2026 Slack data-table block; `rows[0]` must be the header row. */
+declare function buildDataTableBlock(rows: readonly (readonly SlackDataTableCell[])[]): SlackDataTableBlock;
+/** Builds the final note used when a surface block budget is exceeded. */
+declare function buildBlockBudgetNote(omitted: number): SlackContextBlock;
+//#endregion
+export { ACTIONS_ELEMENT_CAP, ACTION_ID_CAP, ALERT_TEXT_CAP, BUTTON_VALUE_CAP, CARD_ACTIONS_CAP, CARD_BODY_CAP, CARD_SUBTEXT_CAP, CARD_TITLE_CAP, CAROUSEL_CARD_CAP, CAROUSEL_CARD_MIN, CHILDREN_CAP, CONTEXT_ELEMENT_CAP, CONTEXT_TEXT_CAP, DATA_TABLE_CHAR_BUDGET, DATA_TABLE_COLUMN_CAP, DATA_TABLE_ROW_CAP, FACT_FIELD_CAP, FACT_FIELD_TEXT_CAP, HEADER_TEXT_CAP, INBOUND_BLOCK_CAP, INPUT_LABEL_CAP, INTERACTIVE_TEXT_CAP, MARKDOWN_TEXT_BUDGET, MAX_TRAVERSAL_DEPTH, MESSAGE_BLOCK_CAP, MODAL_BLOCK_CAP, NODE_BUDGET, PLACEHOLDER_TEXT_CAP, RADIO_OPTION_CAP, SECTION_TEXT_CAP, SELECT_OPTION_CAP, TABLE_CAPTION, buildAlertBlock, buildAlertFallback, buildBlockBudgetNote, buildCardBlock, buildCarouselBlock, buildDataTableBlock };
+//# sourceMappingURL=constants.d.ts.map

package/dist/slack/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","names":[],"sources":["../../src/slack/constants.ts"],"mappings":";;;cAca;;;;;;;;cASA;;;;;;;;cASA;;cAGA;;cAGA;;;;;;cAOA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;cAGA;;;;;cAMA;;cAGA;;;;;cAMA;;cAGA;;cAGA;;iBAGG,mBACd,eACA,qBACA,4DACW,mBAAmB;;iBAmBhB,gBACd,cACA,kDACC;KAUE;WACM,YAAY;WACZ,QAAQ;WACR,WAAW;WACX,OAAO;WACP,UAAU;WACV,mBAAmB;;;iBAId,eAAe,QAAQ,kBAAkB;;iBAczC,mBACd,mBAAmB,mBAClB;;iBAKa,oBACd,yBAAyB,0BACxB;;iBAKa,qBAAqB,kBAAkB"}

package/dist/slack/constants.js

@@ -0,0 +1,168 @@
+//#region src/slack/constants.ts
+/** The maximum normalized traversal depth. */
+const MAX_TRAVERSAL_DEPTH = 64;
+/**
+* The maximum number of entries kept at any single level (root, or a
+* `children` array at any depth) of the raw spec, before it ever reaches
+* `normalizeSpec`. Bounds a hostile array's reported `length` so the pre-pass
+* can never be made to walk further than this regardless of what the array
+* claims about itself.
+*/
+const CHILDREN_CAP = 200;
+/**
+* The total number of nodes the pre-normalization bounding walk will visit
+* across one call, regardless of how many times a shared reference recurs.
+* Bounds the combinatorial work a DAG of shared or self-referential nodes
+* would otherwise force even though each individual array stays within
+* {@link CHILDREN_CAP}.
+*/
+const NODE_BUDGET = 5e3;
+/** The block limit for a Slack message. */
+const MESSAGE_BLOCK_CAP = 50;
+/** The block limit for a Slack modal. */
+const MODAL_BLOCK_CAP = 100;
+/**
+* The maximum number of top-level blocks accepted when parsing Slack Block
+* Kit JSON back into generative UI, guarding against a hostile or malformed
+* payload.
+*/
+const INBOUND_BLOCK_CAP = 200;
+/** The character limit for header text. */
+const HEADER_TEXT_CAP = 150;
+/** The character limit for section text. */
+const SECTION_TEXT_CAP = 3e3;
+/** The maximum number of fields in one section. */
+const FACT_FIELD_CAP = 10;
+/** The character limit for one section field. */
+const FACT_FIELD_TEXT_CAP = 2e3;
+/** The character limit for button labels and option labels. */
+const INTERACTIVE_TEXT_CAP = 75;
+/** The character limit for an action_id. */
+const ACTION_ID_CAP = 255;
+/** The character limit for a button's serialized value payload. */
+const BUTTON_VALUE_CAP = 2e3;
+/** The maximum number of elements in one actions block. */
+const ACTIONS_ELEMENT_CAP = 25;
+/** The maximum number of options in a static select. */
+const SELECT_OPTION_CAP = 100;
+/** The maximum number of options in a radio-button group. */
+const RADIO_OPTION_CAP = 10;
+/** The character limit for a select or input placeholder. */
+const PLACEHOLDER_TEXT_CAP = 150;
+/** The character limit for an input's label. */
+const INPUT_LABEL_CAP = 2e3;
+/** The maximum number of elements in one context block. */
+const CONTEXT_ELEMENT_CAP = 10;
+/** The character limit for one context element's text. */
+const CONTEXT_TEXT_CAP = 3e3;
+/** The character limit for card titles and subtitles. */
+const CARD_TITLE_CAP = 150;
+/** The character limit for a card's body text. */
+const CARD_BODY_CAP = 200;
+/** The character limit for a card's subtext. */
+const CARD_SUBTEXT_CAP = 200;
+/** The maximum number of buttons in a card's actions. */
+const CARD_ACTIONS_CAP = 3;
+/** The minimum number of elements in a renderable carousel. */
+const CAROUSEL_CARD_MIN = 1;
+/** The maximum number of elements in a carousel. */
+const CAROUSEL_CARD_CAP = 10;
+/** The character limit for an alert's text. */
+const ALERT_TEXT_CAP = 200;
+/**
+* The maximum number of data rows in a data-table block; the emitted `rows`
+* array additionally carries one header row.
+*/
+const DATA_TABLE_ROW_CAP = 100;
+/** The maximum number of columns in a data-table block. */
+const DATA_TABLE_COLUMN_CAP = 20;
+/**
+* The cumulative character limit (summed across every cell's text) shared by
+* every data-table block in one payload.
+*/
+const DATA_TABLE_CHAR_BUDGET = 1e4;
+/** The caption emitted on every native data-table block. */
+const TABLE_CAPTION = "Table";
+/** The cumulative character limit for native markdown blocks. */
+const MARKDOWN_TEXT_BUDGET = 12e3;
+/** Builds the message-surface fallback for an alert. */
+function buildAlertFallback(title, description, tone) {
+	const emoji = {
+		info: "ℹ️",
+		success: "✅",
+		warning: "⚠️",
+		danger: "🛑"
+	}[tone];
+	return [{
+		type: "context",
+		elements: [{
+			type: "mrkdwn",
+			text: title ? `${emoji} *${title}*` : emoji
+		}]
+	}, {
+		type: "section",
+		text: {
+			type: "mrkdwn",
+			text: description
+		}
+	}];
+}
+/** Builds a 2026 Slack modal-only alert block, mapping `tone` to its `level`. */
+function buildAlertBlock(text, tone) {
+	const level = {
+		info: "info",
+		success: "success",
+		warning: "warning",
+		danger: "error"
+	}[tone];
+	return {
+		type: "alert",
+		text: {
+			type: "mrkdwn",
+			text
+		},
+		level
+	};
+}
+/** Builds a 2026 Slack card block from its already-clamped fields. */
+function buildCardBlock(fields) {
+	const { heroImage, title, subtitle, body, subtext, actions } = fields;
+	return {
+		type: "card",
+		...heroImage !== void 0 ? { hero_image: heroImage } : {},
+		...title !== void 0 ? { title } : {},
+		...subtitle !== void 0 ? { subtitle } : {},
+		...body !== void 0 ? { body } : {},
+		...subtext !== void 0 ? { subtext } : {},
+		...actions !== void 0 ? { actions } : {}
+	};
+}
+/** Builds a 2026 Slack carousel block. */
+function buildCarouselBlock(elements) {
+	return {
+		type: "carousel",
+		elements
+	};
+}
+/** Builds a 2026 Slack data-table block; `rows[0]` must be the header row. */
+function buildDataTableBlock(rows) {
+	return {
+		type: "data_table",
+		caption: TABLE_CAPTION,
+		rows
+	};
+}
+/** Builds the final note used when a surface block budget is exceeded. */
+function buildBlockBudgetNote(omitted) {
+	return {
+		type: "context",
+		elements: [{
+			type: "mrkdwn",
+			text: `${omitted} ${omitted === 1 ? "block was" : "blocks were"} omitted.`
+		}]
+	};
+}
+//#endregion
+export { ACTIONS_ELEMENT_CAP, ACTION_ID_CAP, ALERT_TEXT_CAP, BUTTON_VALUE_CAP, CARD_ACTIONS_CAP, CARD_BODY_CAP, CARD_SUBTEXT_CAP, CARD_TITLE_CAP, CAROUSEL_CARD_CAP, CAROUSEL_CARD_MIN, CHILDREN_CAP, CONTEXT_ELEMENT_CAP, CONTEXT_TEXT_CAP, DATA_TABLE_CHAR_BUDGET, DATA_TABLE_COLUMN_CAP, DATA_TABLE_ROW_CAP, FACT_FIELD_CAP, FACT_FIELD_TEXT_CAP, HEADER_TEXT_CAP, INBOUND_BLOCK_CAP, INPUT_LABEL_CAP, INTERACTIVE_TEXT_CAP, MARKDOWN_TEXT_BUDGET, MAX_TRAVERSAL_DEPTH, MESSAGE_BLOCK_CAP, MODAL_BLOCK_CAP, NODE_BUDGET, PLACEHOLDER_TEXT_CAP, RADIO_OPTION_CAP, SECTION_TEXT_CAP, SELECT_OPTION_CAP, TABLE_CAPTION, buildAlertBlock, buildAlertFallback, buildBlockBudgetNote, buildCardBlock, buildCarouselBlock, buildDataTableBlock };
+
+//# sourceMappingURL=constants.js.map

package/dist/slack/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":[],"sources":["../../src/slack/constants.ts"],"sourcesContent":["import type {\n  SlackAlertBlock,\n  SlackButtonElement,\n  SlackCardBlock,\n  SlackCarouselBlock,\n  SlackContextBlock,\n  SlackDataTableBlock,\n  SlackDataTableCell,\n  SlackImageBlock,\n  SlackSectionBlock,\n  SlackTextObject,\n} from \"./types\";\n\n/** The maximum normalized traversal depth. */\nexport const MAX_TRAVERSAL_DEPTH = 64;\n\n/**\n * The maximum number of entries kept at any single level (root, or a\n * `children` array at any depth) of the raw spec, before it ever reaches\n * `normalizeSpec`. Bounds a hostile array's reported `length` so the pre-pass\n * can never be made to walk further than this regardless of what the array\n * claims about itself.\n */\nexport const CHILDREN_CAP = 200;\n\n/**\n * The total number of nodes the pre-normalization bounding walk will visit\n * across one call, regardless of how many times a shared reference recurs.\n * Bounds the combinatorial work a DAG of shared or self-referential nodes\n * would otherwise force even though each individual array stays within\n * {@link CHILDREN_CAP}.\n */\nexport const NODE_BUDGET = 5000;\n\n/** The block limit for a Slack message. */\nexport const MESSAGE_BLOCK_CAP = 50;\n\n/** The block limit for a Slack modal. */\nexport const MODAL_BLOCK_CAP = 100;\n\n/**\n * The maximum number of top-level blocks accepted when parsing Slack Block\n * Kit JSON back into generative UI, guarding against a hostile or malformed\n * payload.\n */\nexport const INBOUND_BLOCK_CAP = 200;\n\n/** The character limit for header text. */\nexport const HEADER_TEXT_CAP = 150;\n\n/** The character limit for section text. */\nexport const SECTION_TEXT_CAP = 3000;\n\n/** The maximum number of fields in one section. */\nexport const FACT_FIELD_CAP = 10;\n\n/** The character limit for one section field. */\nexport const FACT_FIELD_TEXT_CAP = 2000;\n\n/** The character limit for button labels and option labels. */\nexport const INTERACTIVE_TEXT_CAP = 75;\n\n/** The character limit for an action_id. */\nexport const ACTION_ID_CAP = 255;\n\n/** The character limit for a button's serialized value payload. */\nexport const BUTTON_VALUE_CAP = 2000;\n\n/** The maximum number of elements in one actions block. */\nexport const ACTIONS_ELEMENT_CAP = 25;\n\n/** The maximum number of options in a static select. */\nexport const SELECT_OPTION_CAP = 100;\n\n/** The maximum number of options in a radio-button group. */\nexport const RADIO_OPTION_CAP = 10;\n\n/** The character limit for a select or input placeholder. */\nexport const PLACEHOLDER_TEXT_CAP = 150;\n\n/** The character limit for an input's label. */\nexport const INPUT_LABEL_CAP = 2000;\n\n/** The maximum number of elements in one context block. */\nexport const CONTEXT_ELEMENT_CAP = 10;\n\n/** The character limit for one context element's text. */\nexport const CONTEXT_TEXT_CAP = 3000;\n\n/** The character limit for card titles and subtitles. */\nexport const CARD_TITLE_CAP = 150;\n\n/** The character limit for a card's body text. */\nexport const CARD_BODY_CAP = 200;\n\n/** The character limit for a card's subtext. */\nexport const CARD_SUBTEXT_CAP = 200;\n\n/** The maximum number of buttons in a card's actions. */\nexport const CARD_ACTIONS_CAP = 3;\n\n/** The minimum number of elements in a renderable carousel. */\nexport const CAROUSEL_CARD_MIN = 1;\n\n/** The maximum number of elements in a carousel. */\nexport const CAROUSEL_CARD_CAP = 10;\n\n/** The character limit for an alert's text. */\nexport const ALERT_TEXT_CAP = 200;\n\n/**\n * The maximum number of data rows in a data-table block; the emitted `rows`\n * array additionally carries one header row.\n */\nexport const DATA_TABLE_ROW_CAP = 100;\n\n/** The maximum number of columns in a data-table block. */\nexport const DATA_TABLE_COLUMN_CAP = 20;\n\n/**\n * The cumulative character limit (summed across every cell's text) shared by\n * every data-table block in one payload.\n */\nexport const DATA_TABLE_CHAR_BUDGET = 10000;\n\n/** The caption emitted on every native data-table block. */\nexport const TABLE_CAPTION = \"Table\";\n\n/** The cumulative character limit for native markdown blocks. */\nexport const MARKDOWN_TEXT_BUDGET = 12000;\n\n/** Builds the message-surface fallback for an alert. */\nexport function buildAlertFallback(\n  title: string,\n  description: string,\n  tone: \"info\" | \"success\" | \"warning\" | \"danger\",\n): readonly [SlackContextBlock, SlackSectionBlock] {\n  const emoji = {\n    info: \"ℹ️\",\n    success: \"✅\",\n    warning: \"⚠️\",\n    danger: \"🛑\",\n  }[tone];\n  return [\n    {\n      type: \"context\",\n      elements: [\n        { type: \"mrkdwn\", text: title ? `${emoji} *${title}*` : emoji },\n      ],\n    },\n    { type: \"section\", text: { type: \"mrkdwn\", text: description } },\n  ];\n}\n\n/** Builds a 2026 Slack modal-only alert block, mapping `tone` to its `level`. */\nexport function buildAlertBlock(\n  text: string,\n  tone: \"info\" | \"success\" | \"warning\" | \"danger\",\n): SlackAlertBlock {\n  const level = {\n    info: \"info\",\n    success: \"success\",\n    warning: \"warning\",\n    danger: \"error\",\n  }[tone] as const;\n  return { type: \"alert\", text: { type: \"mrkdwn\", text }, level };\n}\n\ntype CardBlockFields = {\n  readonly heroImage?: SlackImageBlock;\n  readonly title?: SlackTextObject;\n  readonly subtitle?: SlackTextObject;\n  readonly body?: SlackTextObject;\n  readonly subtext?: SlackTextObject;\n  readonly actions?: readonly SlackButtonElement[];\n};\n\n/** Builds a 2026 Slack card block from its already-clamped fields. */\nexport function buildCardBlock(fields: CardBlockFields): SlackCardBlock {\n  const { heroImage, title, subtitle, body, subtext, actions } = fields;\n  return {\n    type: \"card\",\n    ...(heroImage !== undefined ? { hero_image: heroImage } : {}),\n    ...(title !== undefined ? { title } : {}),\n    ...(subtitle !== undefined ? { subtitle } : {}),\n    ...(body !== undefined ? { body } : {}),\n    ...(subtext !== undefined ? { subtext } : {}),\n    ...(actions !== undefined ? { actions } : {}),\n  };\n}\n\n/** Builds a 2026 Slack carousel block. */\nexport function buildCarouselBlock(\n  elements: readonly SlackCardBlock[],\n): SlackCarouselBlock {\n  return { type: \"carousel\", elements };\n}\n\n/** Builds a 2026 Slack data-table block; `rows[0]` must be the header row. */\nexport function buildDataTableBlock(\n  rows: readonly (readonly SlackDataTableCell[])[],\n): SlackDataTableBlock {\n  return { type: \"data_table\", caption: TABLE_CAPTION, rows };\n}\n\n/** Builds the final note used when a surface block budget is exceeded. */\nexport function buildBlockBudgetNote(omitted: number): SlackContextBlock {\n  return {\n    type: \"context\",\n    elements: [\n      {\n        type: \"mrkdwn\",\n        text: `${omitted} ${omitted === 1 ? \"block was\" : \"blocks were\"} omitted.`,\n      },\n    ],\n  };\n}\n"],"mappings":";;AAcA,MAAa,sBAAsB;;;;;;;;AASnC,MAAa,eAAe;;;;;;;;AAS5B,MAAa,cAAc;;AAG3B,MAAa,oBAAoB;;AAGjC,MAAa,kBAAkB;;;;;;AAO/B,MAAa,oBAAoB;;AAGjC,MAAa,kBAAkB;;AAG/B,MAAa,mBAAmB;;AAGhC,MAAa,iBAAiB;;AAG9B,MAAa,sBAAsB;;AAGnC,MAAa,uBAAuB;;AAGpC,MAAa,gBAAgB;;AAG7B,MAAa,mBAAmB;;AAGhC,MAAa,sBAAsB;;AAGnC,MAAa,oBAAoB;;AAGjC,MAAa,mBAAmB;;AAGhC,MAAa,uBAAuB;;AAGpC,MAAa,kBAAkB;;AAG/B,MAAa,sBAAsB;;AAGnC,MAAa,mBAAmB;;AAGhC,MAAa,iBAAiB;;AAG9B,MAAa,gBAAgB;;AAG7B,MAAa,mBAAmB;;AAGhC,MAAa,mBAAmB;;AAGhC,MAAa,oBAAoB;;AAGjC,MAAa,oBAAoB;;AAGjC,MAAa,iBAAiB;;;;;AAM9B,MAAa,qBAAqB;;AAGlC,MAAa,wBAAwB;;;;;AAMrC,MAAa,yBAAyB;;AAGtC,MAAa,gBAAgB;;AAG7B,MAAa,uBAAuB;;AAGpC,SAAgB,mBACd,OACA,aACA,MACiD;CACjD,MAAM,QAAQ;EACZ,MAAM;EACN,SAAS;EACT,SAAS;EACT,QAAQ;CACV,EAAE;CACF,OAAO,CACL;EACE,MAAM;EACN,UAAU,CACR;GAAE,MAAM;GAAU,MAAM,QAAQ,GAAG,MAAM,IAAI,MAAM,KAAK;EAAM,CAChE;CACF,GACA;EAAE,MAAM;EAAW,MAAM;GAAE,MAAM;GAAU,MAAM;EAAY;CAAE,CACjE;AACF;;AAGA,SAAgB,gBACd,MACA,MACiB;CACjB,MAAM,QAAQ;EACZ,MAAM;EACN,SAAS;EACT,SAAS;EACT,QAAQ;CACV,EAAE;CACF,OAAO;EAAE,MAAM;EAAS,MAAM;GAAE,MAAM;GAAU;EAAK;EAAG;CAAM;AAChE;;AAYA,SAAgB,eAAe,QAAyC;CACtE,MAAM,EAAE,WAAW,OAAO,UAAU,MAAM,SAAS,YAAY;CAC/D,OAAO;EACL,MAAM;EACN,GAAI,cAAc,KAAA,IAAY,EAAE,YAAY,UAAU,IAAI,CAAC;EAC3D,GAAI,UAAU,KAAA,IAAY,EAAE,MAAM,IAAI,CAAC;EACvC,GAAI,aAAa,KAAA,IAAY,EAAE,SAAS,IAAI,CAAC;EAC7C,GAAI,SAAS,KAAA,IAAY,EAAE,KAAK,IAAI,CAAC;EACrC,GAAI,YAAY,KAAA,IAAY,EAAE,QAAQ,IAAI,CAAC;EAC3C,GAAI,YAAY,KAAA,IAAY,EAAE,QAAQ,IAAI,CAAC;CAC7C;AACF;;AAGA,SAAgB,mBACd,UACoB;CACpB,OAAO;EAAE,MAAM;EAAY;CAAS;AACtC;;AAGA,SAAgB,oBACd,MACqB;CACrB,OAAO;EAAE,MAAM;EAAc,SAAS;EAAe;CAAK;AAC5D;;AAGA,SAAgB,qBAAqB,SAAoC;CACvE,OAAO;EACL,MAAM;EACN,UAAU,CACR;GACE,MAAM;GACN,MAAM,GAAG,QAAQ,GAAG,YAAY,IAAI,cAAc,cAAc;EAClE,CACF;CACF;AACF"}

package/dist/slack/decodeBlockAction.d.ts

@@ -0,0 +1,11 @@
+import { Action } from "../ir.js";
+//#region src/slack/decodeBlockAction.d.ts
+/**
+ * Decodes one structural entry from a Slack `block_actions` payload.
+ * `$input` is reserved for the runtime selection: a `$input` key inside the
+ * button's JSON `value` payload is dropped rather than spread into the result.
+ */
+declare function decodeBlockAction(action: unknown): Action | undefined;
+//#endregion
+export { decodeBlockAction };
+//# sourceMappingURL=decodeBlockAction.d.ts.map

package/dist/slack/decodeBlockAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeBlockAction.d.ts","names":[],"sources":["../../src/slack/decodeBlockAction.ts"],"mappings":";;;;;;;iBAegB,kBAAkB,kBAAkB"}

package/dist/slack/decodeBlockAction.js

@@ -0,0 +1,40 @@
+//#region src/slack/decodeBlockAction.ts
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const optionValue = (value) => isRecord(value) && typeof value["value"] === "string" ? value["value"] : void 0;
+/**
+* Decodes one structural entry from a Slack `block_actions` payload.
+* `$input` is reserved for the runtime selection: a `$input` key inside the
+* button's JSON `value` payload is dropped rather than spread into the result.
+*/
+function decodeBlockAction(action) {
+	try {
+		if (!isRecord(action) || typeof action["action_id"] !== "string") return;
+		const actionId = action["action_id"];
+		if (!actionId) return void 0;
+		const rawValue = action["value"];
+		let payload = {};
+		let plainValue;
+		if (typeof rawValue === "string") try {
+			const parsed = JSON.parse(rawValue);
+			if (isRecord(parsed)) payload = parsed;
+			else plainValue = rawValue;
+		} catch {
+			plainValue = rawValue;
+		}
+		const selectedOption = optionValue(action["selected_option"]);
+		const selectedDate = typeof action["selected_date"] === "string" ? action["selected_date"] : void 0;
+		const selectedOptions = Array.isArray(action["selected_options"]) ? action["selected_options"].map(optionValue).filter((value) => value !== void 0) : void 0;
+		const input = selectedOption ?? selectedDate ?? (selectedOptions !== void 0 ? selectedOptions : plainValue);
+		return {
+			...Object.fromEntries(Object.entries(payload).filter(([key]) => key !== "$input")),
+			type: actionId,
+			...input !== void 0 ? { $input: input } : {}
+		};
+	} catch {
+		return;
+	}
+}
+//#endregion
+export { decodeBlockAction };
+
+//# sourceMappingURL=decodeBlockAction.js.map

package/dist/slack/decodeBlockAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decodeBlockAction.js","names":[],"sources":["../../src/slack/decodeBlockAction.ts"],"sourcesContent":["import type { Action } from \"../ir\";\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst optionValue = (value: unknown): string | undefined =>\n  isRecord(value) && typeof value[\"value\"] === \"string\"\n    ? value[\"value\"]\n    : undefined;\n\n/**\n * Decodes one structural entry from a Slack `block_actions` payload.\n * `$input` is reserved for the runtime selection: a `$input` key inside the\n * button's JSON `value` payload is dropped rather than spread into the result.\n */\nexport function decodeBlockAction(action: unknown): Action | undefined {\n  try {\n    if (!isRecord(action) || typeof action[\"action_id\"] !== \"string\") {\n      return undefined;\n    }\n\n    const actionId = action[\"action_id\"];\n    if (!actionId) return undefined;\n\n    const rawValue = action[\"value\"];\n    let payload: Record<string, unknown> = {};\n    let plainValue: string | undefined;\n    if (typeof rawValue === \"string\") {\n      try {\n        const parsed: unknown = JSON.parse(rawValue);\n        if (isRecord(parsed)) {\n          payload = parsed;\n        } else {\n          plainValue = rawValue;\n        }\n      } catch {\n        plainValue = rawValue;\n      }\n    }\n\n    const selectedOption = optionValue(action[\"selected_option\"]);\n    const selectedDate =\n      typeof action[\"selected_date\"] === \"string\"\n        ? action[\"selected_date\"]\n        : undefined;\n    const selectedOptions = Array.isArray(action[\"selected_options\"])\n      ? action[\"selected_options\"]\n          .map(optionValue)\n          .filter((value): value is string => value !== undefined)\n      : undefined;\n    const input =\n      selectedOption ??\n      selectedDate ??\n      (selectedOptions !== undefined ? selectedOptions : plainValue);\n\n    return {\n      ...Object.fromEntries(\n        Object.entries(payload).filter(([key]) => key !== \"$input\"),\n      ),\n      type: actionId,\n      ...(input !== undefined ? { $input: input } : {}),\n    };\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":";AAEA,MAAM,YAAY,UAChB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAErE,MAAM,eAAe,UACnB,SAAS,KAAK,KAAK,OAAO,MAAM,aAAa,WACzC,MAAM,WACN,KAAA;;;;;;AAON,SAAgB,kBAAkB,QAAqC;CACrE,IAAI;EACF,IAAI,CAAC,SAAS,MAAM,KAAK,OAAO,OAAO,iBAAiB,UACtD;EAGF,MAAM,WAAW,OAAO;EACxB,IAAI,CAAC,UAAU,OAAO,KAAA;EAEtB,MAAM,WAAW,OAAO;EACxB,IAAI,UAAmC,CAAC;EACxC,IAAI;EACJ,IAAI,OAAO,aAAa,UACtB,IAAI;GACF,MAAM,SAAkB,KAAK,MAAM,QAAQ;GAC3C,IAAI,SAAS,MAAM,GACjB,UAAU;QAEV,aAAa;EAEjB,QAAQ;GACN,aAAa;EACf;EAGF,MAAM,iBAAiB,YAAY,OAAO,kBAAkB;EAC5D,MAAM,eACJ,OAAO,OAAO,qBAAqB,WAC/B,OAAO,mBACP,KAAA;EACN,MAAM,kBAAkB,MAAM,QAAQ,OAAO,mBAAmB,IAC5D,OAAO,mBAAmB,CACvB,IAAI,WAAW,CAAC,CAChB,QAAQ,UAA2B,UAAU,KAAA,CAAS,IACzD,KAAA;EACJ,MAAM,QACJ,kBACA,iBACC,oBAAoB,KAAA,IAAY,kBAAkB;EAErD,OAAO;GACL,GAAG,OAAO,YACR,OAAO,QAAQ,OAAO,CAAC,CAAC,QAAQ,CAAC,SAAS,QAAQ,QAAQ,CAC5D;GACA,MAAM;GACN,GAAI,UAAU,KAAA,IAAY,EAAE,QAAQ,MAAM,IAAI,CAAC;EACjD;CACF,QAAQ;EACN;CACF;AACF"}

package/dist/slack/fromSlackBlocks.d.ts

@@ -0,0 +1,30 @@
+import { FromSlackBlocksResult } from "./types.js";
+//#region src/slack/fromSlackBlocks.d.ts
+/**
+ * Converts Slack Block Kit JSON back into a generative-ui IR tree, inverting
+ * {@link toSlackBlocks}. Accepts a blocks array or a `{ blocks }` wrapper;
+ * malformed input resolves to an empty node list plus a warning, and an
+ * unrecognized block or action element is skipped with a "dropped" warning.
+ * Every array read along the way (blocks, fields, options, elements, cards,
+ * rows, cells) is bounded to its site's cap before it is mapped over, so a
+ * hostile array (sparse or proxied with a fabricated `length`) is clamped
+ * with a "clamped" warning instead of stalling the event loop. Never throws.
+ *
+ * The Slack shape is lossier than the IR, so some information cannot be
+ * recovered: a context block's elements always decode as `Caption` (the
+ * original `Badge` vs `Caption` distinction does not survive the round trip),
+ * a button's `buttonStyle` is only recovered for the `primary`/`danger` Slack
+ * styles, a native alert block's `title` and `description` merge into a
+ * single `description` string, and a card's layout collapses to its `title`,
+ * a flat `children` list (image, then text, then caption, in that order),
+ * and `confirm`/`cancel` footer buttons. A section field's label and value
+ * are split on the first `*`+newline delimiter, so a label or value that
+ * itself contains that exact delimiter cannot be split back unambiguously.
+ * A data-table cell that Slack carries as `raw_text` always decodes as a
+ * string, even when its text is the stringified form of a boolean, since the
+ * Slack shape does not distinguish a boolean from ordinary text.
+ */
+declare function fromSlackBlocks(blocks: unknown): FromSlackBlocksResult;
+//#endregion
+export { fromSlackBlocks };
+//# sourceMappingURL=fromSlackBlocks.d.ts.map

package/dist/slack/fromSlackBlocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromSlackBlocks.d.ts","names":[],"sources":["../../src/slack/fromSlackBlocks.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;iBA+pBgB,gBAAgB,kBAAkB"}