react-blockkit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Siraj Chokshi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,203 @@
+# react-blockkit
+
+React components that render Slack Block Kit JSON exactly as Slack does.
+
+`react-blockkit` accepts any Block Kit payload; it is not coupled to a Markdown
+source or compiler. The package uses Slack's official `@slack/types`
+definitions, adds typed definitions for newer blocks not yet covered there,
+offers explicit runtime validators, and ships precompiled StyleX CSS.
+
+Compiling Markdown first? `react-blockkit` pairs perfectly with
+[`slackmark`](https://github.com/SirajChokshi/slackmark/tree/main/packages/core).
+
+## Install
+
+```bash
+pnpm add react-blockkit react react-dom
+```
+
+Import the precompiled stylesheet once in your application:
+
+```tsx
+import "react-blockkit/styles.css";
+```
+
+Consumers do not need a StyleX plugin.
+
+## Render typed Block Kit
+
+```tsx
+import { BlockKit, type BlockKitData } from "react-blockkit";
+
+const data = {
+  blocks: [
+    {
+      type: "section",
+      text: {
+        type: "mrkdwn",
+        text: "A message with *bold text* and <https://slack.com|a link>.",
+      },
+    },
+    {
+      type: "actions",
+      elements: [
+        {
+          type: "button",
+          action_id: "approve",
+          text: { type: "plain_text", text: "Approve" },
+          style: "primary",
+        },
+      ],
+    },
+  ],
+} satisfies BlockKitData;
+
+export function Preview() {
+  return (
+    <BlockKit
+      data={data}
+      onAction={(action) => {
+        // Route the action to your preview tooling or app.
+      }}
+    />
+  );
+}
+```
+
+`data` may also be a JSON string. It is parsed before blocks render:
+
+```tsx
+<BlockKit data={jsonFromEditor} />
+```
+
+Malformed JSON throws `BlockKitInvariantError` with a stable `code` and JSON
+`path`. Valid JSON with future or unusual block shapes renders a visible,
+human-readable fallback instead of crashing or silently dropping content.
+
+## Compose individual blocks
+
+Every layout block and core element is exported independently:
+
+```tsx
+import {
+  BlockKitProvider,
+  ButtonElement,
+  SectionBlock,
+} from "react-blockkit";
+
+export function ComposedPreview() {
+  return (
+    <BlockKitProvider surface="message">
+      <SectionBlock
+        block={{
+          type: "section",
+          text: { type: "plain_text", text: "Composable block" },
+        }}
+      />
+      <ButtonElement
+        element={{
+          type: "button",
+          action_id: "continue",
+          text: { type: "plain_text", text: "Continue" },
+        }}
+      />
+    </BlockKitProvider>
+  );
+}
+```
+
+Standalone components use the same tolerant rendering behavior as
+`<BlockKit />`.
+
+## Themes and surfaces
+
+```tsx
+<BlockKit data={data} theme="dark" surface="message" />
+```
+
+- `theme`: `light` or `dark`
+- `surface`: `message`, `modal`, or `home`
+
+Rendering does not reject payloads based on the selected surface. Pass the same
+surface to `assertBlockKitData` or `parseBlockKitData` when strict compatibility
+checks are required. For example, `alert` is modal-only, while `container`,
+`data_table`, and `data_visualization` are currently documented for messages.
+
+## Resolve workspace references
+
+Slack IDs can be mapped to human-readable labels without changing the payload:
+
+```tsx
+<BlockKit
+  data={data}
+  resolvers={{
+    user: (id) => users[id] ?? id,
+    channel: (id) => channels[id] ?? id,
+    emoji: (name) => emoji[name] ?? `:${name}:`,
+  }}
+/>
+```
+
+Resolvers may return any React node.
+
+## Runtime guarantees
+
+Rendering is total for valid block-shaped JSON: unknown blocks and elements,
+empty collections, and out-of-range presentation values degrade to bounded,
+visible output. Use the explicit validation API when strict Slack acceptance
+checks are required. Strict validation includes:
+
+- message/view block limits and duplicate `block_id` detection
+- required fields, discriminators, lengths, and per-block element limits
+- legal accessory/input/action element placement
+- rich-text nesting and preformatted/list constraints
+- table shape, cell types, row/column limits, and aggregate text budgets
+- data-table header, row width, page size, and row-header invariants
+- chart category/series/point consistency
+- card, carousel, container, task-card, and plan constraints
+- surface compatibility
+
+Use the validation API without React:
+
+```ts
+import {
+  assertBlockKitData,
+  parseBlockKitData,
+} from "react-blockkit";
+
+assertBlockKitData(unknownPayload, "message");
+const typed = parseBlockKitData(json, "message");
+```
+
+The audited before/after inventory is in
+[`docs/coverage-matrix.md`](./docs/coverage-matrix.md).
+
+## Type source
+
+Classic and current SDK-supported shapes come directly from `@slack/types`.
+The package locally augments:
+
+- `header.level`
+- `rich_text_list.offset` and `rich_text_preformatted.language`
+- `raw_number` table cells
+- `card.subtext` and `card.slack_icon`
+- `container`
+- `data_table`
+- `data_visualization`
+
+These local definitions should be removed in favor of upstream Slack types as
+the SDK catches up.
+
+## Development
+
+```bash
+pnpm --filter react-blockkit typecheck
+pnpm --filter react-blockkit test
+pnpm --filter react-blockkit build
+```
+
+The build emits ESM, CJS, declarations, source maps, and a single
+`dist/styles.css` containing the compiled StyleX atoms and theme variables.
+
+Measured Builder values and the remaining fidelity matrix are tracked in
+[`docs/slack-style-baseline.md`](./docs/slack-style-baseline.md).

package/dist/Block.d.ts

@@ -0,0 +1,13 @@
+import type { ReactElement } from "react";
+import type { BlockComponentProps, ContainerBlockData, RenderableBlock } from "./types.js";
+export type BlockProps = BlockComponentProps<RenderableBlock>;
+interface RuntimeBlockProps {
+    readonly block: unknown;
+    readonly className?: string | undefined;
+    readonly path?: string | undefined;
+}
+export declare function RuntimeBlock({ block, className, path, }: RuntimeBlockProps): ReactElement;
+export declare function Block(props: BlockProps): ReactElement;
+export declare function ContainerBlock({ block, className, path, }: BlockComponentProps<ContainerBlockData>): ReactElement;
+export {};
+//# sourceMappingURL=Block.d.ts.map

package/dist/Block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Block.d.ts","sourceRoot":"","sources":["../src/Block.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AA8B1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE3F,MAAM,MAAM,UAAU,GAAG,mBAAmB,CAAC,eAAe,CAAC,CAAC;AAE9D,UAAU,iBAAiB;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AASD,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,iBAAiB,GAAG,YAAY,CA+DlC;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAErD;AAoGD,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,GAAG,YAAY,CA8BxD"}

package/dist/BlockKit.d.ts

@@ -0,0 +1,13 @@
+import { type ReactElement } from "react";
+import type { BlockKitAction, BlockKitInput, BlockKitResolvers, BlockKitSurface, BlockKitTheme } from "./types.js";
+export interface BlockKitProps {
+    readonly "aria-label"?: string | undefined;
+    readonly className?: string | undefined;
+    readonly data: BlockKitInput;
+    readonly onAction?: ((action: BlockKitAction) => void) | undefined;
+    readonly resolvers?: BlockKitResolvers | undefined;
+    readonly surface?: BlockKitSurface | undefined;
+    readonly theme?: BlockKitTheme | undefined;
+}
+export declare function BlockKit({ "aria-label": ariaLabel, className, data, onAction, resolvers, surface, theme, }: BlockKitProps): ReactElement;
+//# sourceMappingURL=BlockKit.d.ts.map

package/dist/BlockKit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockKit.d.ts","sourceRoot":"","sources":["../src/BlockKit.tsx"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAOnD,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AA4BpB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC5C;AAED,wBAAgB,QAAQ,CAAC,EACvB,YAAY,EAAE,SAAqC,EACnD,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,OAAmB,EACnB,KAAe,GAChB,EAAE,aAAa,GAAG,YAAY,CA+B9B"}

package/dist/assert-never.d.ts

@@ -0,0 +1,2 @@
+export declare function assertNever(value: never): never;
+//# sourceMappingURL=assert-never.d.ts.map

package/dist/assert-never.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-never.d.ts","sourceRoot":"","sources":["../src/assert-never.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAE/C"}

package/dist/blocks/AdvancedBlocks.d.ts

@@ -0,0 +1,21 @@
+import { type ReactElement } from "react";
+import type { AlertBlockData, BlockComponentProps, CardBlockData, CarouselBlockData, DataTableBlockData, PlanBlockData, TableBlockData, TableCellData, TaskCardBlockData } from "../types.js";
+export interface TableCellProps {
+    readonly align?: "center" | "left" | "right" | undefined;
+    readonly cell: TableCellData;
+    readonly className?: string | undefined;
+    readonly firstColumn?: boolean | undefined;
+    readonly header?: boolean | undefined;
+    readonly path?: string | undefined;
+    readonly scope?: "col" | "row" | undefined;
+    readonly wrapped?: boolean | undefined;
+}
+export declare function TableCell({ align, cell, className, firstColumn, header, path, scope, wrapped, }: TableCellProps): ReactElement;
+export declare function TableBlock({ block, className, path, }: BlockComponentProps<TableBlockData>): ReactElement;
+export declare function DataTableBlock({ block, className, path, }: BlockComponentProps<DataTableBlockData>): ReactElement;
+export declare function CardBlock({ block, className, path, }: BlockComponentProps<CardBlockData>): ReactElement;
+export declare function CarouselBlock({ block, className, path, }: BlockComponentProps<CarouselBlockData>): ReactElement;
+export declare function AlertBlock({ block, className, path, }: BlockComponentProps<AlertBlockData>): ReactElement;
+export declare function TaskCardBlock({ block, className, path, }: BlockComponentProps<TaskCardBlockData>): ReactElement;
+export declare function PlanBlock({ block, className, path, }: BlockComponentProps<PlanBlockData>): ReactElement;
+//# sourceMappingURL=AdvancedBlocks.d.ts.map

package/dist/blocks/AdvancedBlocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdvancedBlocks.d.ts","sourceRoot":"","sources":["../../src/blocks/AdvancedBlocks.tsx"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,YAAY,EAAkB,MAAM,OAAO,CAAC;AAOpE,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,aAAa,EACb,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACxC;AAED,wBAAgB,SAAS,CAAC,EACxB,KAAc,EACd,IAAI,EACJ,SAAS,EACT,WAAmB,EACnB,MAAc,EACd,IAAa,EACb,KAAa,EACb,OAAe,GAChB,EAAE,cAAc,GAAG,YAAY,CAwC/B;AAMD,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,YAAY,CA0CpD;AAsDD,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,GAAG,YAAY,CAwKxD;AAED,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,mBAAmB,CAAC,aAAa,CAAC,GAAG,YAAY,CAmEnD;AAMD,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,GAAG,YAAY,CA4BvD;AAED,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,YAAY,CAoBpD;AAED,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,GAAG,YAAY,CAyDvD;AAMD,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,mBAAmB,CAAC,aAAa,CAAC,GAAG,YAAY,CA+BnD"}

package/dist/blocks/BasicBlocks.d.ts

@@ -0,0 +1,21 @@
+import type { ReactElement, ReactNode } from "react";
+import type { BlockComponentProps, ContextBlockData, DividerBlockData, FileBlockData, HeaderBlockData, ImageBlockData, MarkdownBlockData, RichTextBlockData, SectionBlockData, VideoBlockData } from "../types.js";
+interface FrameProps {
+    readonly blockId?: string | undefined;
+    readonly blockType: string;
+    readonly children: ReactNode;
+    readonly className?: string | undefined;
+}
+/** Shared per-block wrapper (data attributes + base style); internal to blocks/. */
+export declare function Frame({ blockId, blockType, children, className }: FrameProps): ReactElement;
+export declare function SectionBlock({ block, className, path, }: BlockComponentProps<SectionBlockData>): ReactElement;
+export declare function HeaderBlock({ block, className, }: BlockComponentProps<HeaderBlockData>): ReactElement;
+export declare function DividerBlock({ block, className, }: BlockComponentProps<DividerBlockData>): ReactElement;
+export declare function ImageBlock({ block, className, path, }: BlockComponentProps<ImageBlockData>): ReactElement;
+export declare function ContextBlock({ block, className, path, }: BlockComponentProps<ContextBlockData>): ReactElement;
+export declare function RichTextBlock({ block, className, path, }: BlockComponentProps<RichTextBlockData>): ReactElement;
+export declare function MarkdownBlock({ block, className, }: BlockComponentProps<MarkdownBlockData>): ReactElement;
+export declare function FileBlock({ block, className }: BlockComponentProps<FileBlockData>): ReactElement;
+export declare function VideoBlock({ block, className, }: BlockComponentProps<VideoBlockData>): ReactElement;
+export {};
+//# sourceMappingURL=BasicBlocks.d.ts.map

package/dist/blocks/BasicBlocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasicBlocks.d.ts","sourceRoot":"","sources":["../../src/blocks/BasicBlocks.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQrD,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,eAAe,EAEf,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACf,MAAM,aAAa,CAAC;AAMrB,UAAU,UAAU;IAClB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED,oFAAoF;AACpF,wBAAgB,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,UAAU,GAAG,YAAY,CAY3F;AAED,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAAG,YAAY,CAmCtD;AAED,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,SAAS,GACV,EAAE,mBAAmB,CAAC,eAAe,CAAC,GAAG,YAAY,CAoCrD;AAED,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,SAAS,GACV,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAAG,YAAY,CAMtD;AAED,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,YAAY,CAapD;AAmBD,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAAG,YAAY,CAiDtD;AAED,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,GAAG,YAAY,CAMvD;AAED,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,SAAS,GACV,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,GAAG,YAAY,CAQvD;AAED,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,mBAAmB,CAAC,aAAa,CAAC,GAAG,YAAY,CAYhG;AAED,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,SAAS,GACV,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,YAAY,CAgDpD"}

package/dist/blocks/Charts.d.ts

@@ -0,0 +1,4 @@
+import { type ReactElement } from "react";
+import type { BlockComponentProps, DataVisualizationBlockData } from "../types.js";
+export declare function DataVisualizationBlock({ block, className, }: BlockComponentProps<DataVisualizationBlockData>): ReactElement;
+//# sourceMappingURL=Charts.d.ts.map

package/dist/blocks/Charts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Charts.d.ts","sourceRoot":"","sources":["../../src/blocks/Charts.tsx"],"names":[],"mappings":"AACA,OAAO,EAA4C,KAAK,YAAY,EAAkB,MAAM,OAAO,CAAC;AAmBpG,OAAO,KAAK,EACV,mBAAmB,EAEnB,0BAA0B,EAE3B,MAAM,aAAa,CAAC;AAygBrB,wBAAgB,sBAAsB,CAAC,EACrC,KAAK,EACL,SAAS,GACV,EAAE,mBAAmB,CAAC,0BAA0B,CAAC,GAAG,YAAY,CAgFhE"}

package/dist/blocks/InteractiveBlocks.d.ts

@@ -0,0 +1,6 @@
+import type { ReactElement } from "react";
+import type { ActionsBlockData, BlockComponentProps, ContextActionsBlockData, InputBlockData } from "../types.js";
+export declare function ActionsBlock({ block, className, path, }: BlockComponentProps<ActionsBlockData>): ReactElement;
+export declare function InputBlock({ block, className, path, }: BlockComponentProps<InputBlockData>): ReactElement;
+export declare function ContextActionsBlock({ block, className, }: BlockComponentProps<ContextActionsBlockData>): ReactElement;
+//# sourceMappingURL=InteractiveBlocks.d.ts.map

package/dist/blocks/InteractiveBlocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractiveBlocks.d.ts","sourceRoot":"","sources":["../../src/blocks/InteractiveBlocks.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAK1C,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACf,MAAM,aAAa,CAAC;AAiCrB,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,GAAG,YAAY,CAwBtD;AAED,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,SAAS,EACT,IAAc,GACf,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,YAAY,CAkCpD;AAWD,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,SAAS,GACV,EAAE,mBAAmB,CAAC,uBAAuB,CAAC,GAAG,YAAY,CAkG7D"}

package/dist/constants.d.ts

@@ -0,0 +1,54 @@
+export declare const BLOCK_ID_MAX_CHARS = 255;
+export declare const MESSAGE_MAX_BLOCKS = 50;
+export declare const VIEW_MAX_BLOCKS = 100;
+export declare const TEXT_OBJECT_MAX_CHARS = 3000;
+export declare const SECTION_TEXT_MAX_CHARS = 3000;
+export declare const SECTION_FIELD_MAX_CHARS = 2000;
+export declare const SECTION_FIELDS_MAX = 10;
+export declare const HEADER_TEXT_MAX_CHARS = 150;
+export declare const HEADER_LEVEL_MAX = 4;
+export declare const IMAGE_URL_MAX_CHARS = 3000;
+export declare const IMAGE_ALT_MAX_CHARS = 2000;
+export declare const IMAGE_TITLE_MAX_CHARS = 2000;
+export declare const CONTEXT_ELEMENTS_MAX = 10;
+export declare const ACTION_ELEMENTS_MAX = 25;
+export declare const CONTEXT_ACTION_ELEMENTS_MAX = 5;
+export declare const MARKDOWN_CUMULATIVE_MAX_CHARS = 12000;
+export declare const BUTTON_TEXT_MAX_CHARS = 75;
+export declare const BUTTON_URL_MAX_CHARS = 3000;
+export declare const BUTTON_VALUE_MAX_CHARS = 2000;
+export declare const ACTION_ID_MAX_CHARS = 255;
+export declare const TABLE_MAX_ROWS = 100;
+export declare const TABLE_MAX_COLUMNS = 20;
+export declare const TABLE_MAX_CHARS = 10000;
+export declare const DATA_TABLE_MAX_ROWS = 201;
+export declare const DATA_TABLE_MAX_CHARS = 20000;
+export declare const DATA_TABLE_PAGE_SIZE_MAX = 100;
+export declare const CHART_TITLE_MAX_CHARS = 50;
+export declare const CHART_SERIES_MAX = 12;
+export declare const CHART_SEGMENTS_MAX = 12;
+export declare const CHART_POINTS_MAX = 20;
+export declare const CHART_LABEL_MAX_CHARS = 20;
+export declare const CHART_AXIS_LABEL_MAX_CHARS = 50;
+export declare const CHART_CARD_MIN_WIDTH = 400;
+export declare const CHART_CARD_MAX_WIDTH = 624;
+/** Card horizontal padding (12px × 2) plus borders (1px × 2). */
+export declare const CHART_SVG_INSET = 26;
+export declare const CHART_SVG_HEIGHT = 360;
+/** Left gutter reserved for y ticks and the rotated y-axis label. */
+export declare const CHART_PLOT_GUTTER = 74;
+export declare const CHART_PLOT_TOP = 9;
+export declare const CHART_PLOT_BOTTOM = 334;
+export declare const PIE_CENTER_Y = 180;
+export declare const PIE_RADIUS = 144;
+export declare const CARD_TITLE_MAX_CHARS = 150;
+export declare const CARD_BODY_MAX_CHARS = 200;
+export declare const CARD_ACTIONS_MAX = 3;
+export declare const CAROUSEL_CARDS_MAX = 10;
+export declare const ALERT_TEXT_MAX_CHARS = 200;
+export declare const CONTAINER_CHILDREN_MAX = 10;
+export declare const CONTAINER_TITLE_MAX_CHARS = 150;
+export declare const RICH_TEXT_LIST_INDENT_MAX = 8;
+export declare const BLOCK_TYPES: readonly ["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"];
+export type BlockType = (typeof BLOCK_TYPES)[number];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,eAAe,QAAS,CAAC;AACtC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAC3C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAM7C,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,iEAAiE;AACjE,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,eAAO,MAAM,WAAW,YACtB,SAAS,EACT,OAAO,EACP,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,SAAS,EACT,MAAM,EACN,QAAQ,EACR,OAAO,EACP,OAAO,EACP,UAAU,EACV,MAAM,EACN,WAAW,EACX,SAAS,EACT,OAAO,EACP,WAAW,EACX,OAAO,CACC,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,17 @@
+import { type ReactElement, type ReactNode } from "react";
+import type { BlockKitAction, BlockKitResolvers, BlockKitSurface } from "./types.js";
+interface RenderContextValue {
+    readonly onAction: ((action: BlockKitAction) => void) | undefined;
+    readonly resolvers: BlockKitResolvers;
+    readonly surface: BlockKitSurface;
+}
+export interface BlockKitProviderProps {
+    readonly children: ReactNode;
+    readonly onAction?: ((action: BlockKitAction) => void) | undefined;
+    readonly resolvers?: BlockKitResolvers | undefined;
+    readonly surface?: BlockKitSurface | undefined;
+}
+export declare function BlockKitProvider({ children, onAction, resolvers, surface, }: BlockKitProviderProps): ReactElement;
+export declare function useBlockKitContext(): RenderContextValue;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAErF,UAAU,kBAAkB;IAC1B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC;AAYD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CAChD;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,QAAQ,EACR,SAA2B,EAC3B,OAAmB,GACpB,EAAE,qBAAqB,GAAG,YAAY,CAOtC;AAED,wBAAgB,kBAAkB,IAAI,kBAAkB,CAEvD"}

package/dist/elements/Elements.d.ts

@@ -0,0 +1,51 @@
+import type { ReactElement } from "react";
+import type { ButtonElementData, ImageElementData, InteractiveElementData } from "../types.js";
+export interface ImageElementProps {
+    readonly className?: string | undefined;
+    readonly element: ImageElementData;
+    readonly path?: string | undefined;
+    readonly variant?: "accessory" | "cardHero" | "cardIcon" | "context" | undefined;
+}
+export declare function ImageElement({ className, element, variant }: ImageElementProps): ReactElement;
+interface ActionElementProps {
+    readonly blockId?: string | undefined;
+    readonly className?: string | undefined;
+    readonly path?: string | undefined;
+}
+export interface ButtonElementProps extends ActionElementProps {
+    readonly element: ButtonElementData;
+}
+export declare function ButtonElement({ blockId, className, element, path, }: ButtonElementProps): ReactElement;
+type OverflowElementData = Extract<InteractiveElementData, {
+    readonly type: "overflow";
+}>;
+export interface OverflowElementProps extends ActionElementProps {
+    readonly element: OverflowElementData;
+}
+export declare function OverflowElement({ blockId, className, element, path, }: OverflowElementProps): ReactElement;
+interface ChoiceGroupProps extends ActionElementProps {
+    readonly element: Extract<InteractiveElementData, {
+        readonly type: "checkboxes" | "radio_buttons";
+    }>;
+}
+export declare function ChoiceGroup({ blockId, className, element, path, }: ChoiceGroupProps): ReactElement;
+type SelectElementData = Extract<InteractiveElementData, {
+    readonly type: "channels_select" | "conversations_select" | "external_select" | "multi_channels_select" | "multi_conversations_select" | "multi_external_select" | "multi_static_select" | "multi_users_select" | "static_select" | "users_select";
+}>;
+export interface SelectElementProps extends ActionElementProps {
+    readonly element: SelectElementData;
+}
+export declare function SelectElement({ blockId, className, element, path, }: SelectElementProps): ReactElement;
+type InputElementData = Extract<InteractiveElementData, {
+    readonly type: "datepicker" | "datetimepicker" | "email_text_input" | "file_input" | "number_input" | "plain_text_input" | "rich_text_input" | "timepicker" | "url_text_input";
+}>;
+export interface InputElementProps extends ActionElementProps {
+    readonly element: InputElementData;
+}
+export declare function InputElement({ blockId, className, element, path, }: InputElementProps): ReactElement;
+export interface InteractiveElementProps extends ActionElementProps {
+    readonly element: unknown;
+}
+export declare function InteractiveElement({ blockId, className, element, path, }: InteractiveElementProps): ReactElement;
+export {};
+//# sourceMappingURL=Elements.d.ts.map

package/dist/elements/Elements.d.ts.map

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

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+export type BlockKitInvariantCode = "invalid_json" | "invalid_type" | "missing_field" | "invalid_value" | "limit_exceeded" | "surface_mismatch" | "duplicate_id" | "unsupported_block" | "unsupported_element";
+export interface BlockKitInvariantDetails {
+    readonly code: BlockKitInvariantCode;
+    readonly path: string;
+}
+export declare class BlockKitInvariantError extends Error {
+    readonly code: BlockKitInvariantCode;
+    readonly path: string;
+    readonly name: string;
+    constructor(message: string, details: BlockKitInvariantDetails);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B,cAAc,GACd,cAAc,GACd,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,kBAAkB,GAClB,cAAc,GACd,mBAAmB,GACnB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,SAAkB,IAAI,EAAE,MAAM,CAAC;IAE/B,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,EAK7D;CACF"}