@tightknitai/block-kitchen 0.9.8 → 0.9.10

package/dist/{palette-CKP8CK5Z.d.cts → palette-Duj901T6.d.cts}

@@ -1,4 +1,4 @@
-import { ComponentType, SVGProps } from 'react';
+import { ComponentType, SVGProps, ReactNode } from 'react';
 import { SectionBlock, HeaderBlock, DividerBlock, ContextBlock, ActionsBlock, ImageBlock, RichTextBlock, ImageElement, Button, ViewInputBlock } from 'slack-web-api-client';
 
 /**
@@ -571,6 +571,38 @@ interface SendPayload {
     channelId: string;
     blocks: SupportedBlock[];
     sendAsUser: boolean;
+    /**
+     * Values collected from the host's
+     * {@link BlockKitchenSendProps.renderSendExtras} fields, exactly as
+     * accumulated through {@link SendExtrasContext.setExtras}. Present
+     * (possibly `{}`) iff `renderSendExtras` is wired; absent otherwise, so
+     * existing consumers never see a new key.
+     */
+    extras?: Record<string, unknown>;
+}
+/**
+ * Context passed to {@link BlockKitchenSendProps.renderSendExtras} on every
+ * render of the send dialog. The `extras` object is owned by the dialog —
+ * it resets each time the dialog opens (alongside the channel and identity
+ * pickers) and is delivered on {@link SendPayload.extras} when the user
+ * confirms.
+ */
+interface SendExtrasContext {
+    /**
+     * Destination channel currently selected in the dialog, or `null` while
+     * channels are still loading / none is selected. Lets extras react to the
+     * destination (e.g. only offer cross-posting for some channels).
+     */
+    channelId: string | null;
+    /** Whether "post as the user" (vs. the app bot) is currently selected. */
+    sendAsUser: boolean;
+    /** The values collected so far. Render controlled inputs from these. */
+    extras: Record<string, unknown>;
+    /**
+     * Shallow-merges `patch` into {@link SendExtrasContext.extras}. Keys you
+     * never set simply don't appear in the payload.
+     */
+    setExtras: (patch: Record<string, unknown>) => void;
 }
 /**
  * Result returned from {@link BlockKitchenProps.onSend}.
@@ -580,6 +612,66 @@ interface SendResult {
     ok: boolean;
     error?: string;
 }
+/**
+ * Snapshot of the builder's validation verdict, reported through
+ * {@link BlockKitchenBaseProps.onValidationChange}. Mirrors exactly what the
+ * built-in issues chip / issues sheet show, so a host-owned CTA (e.g. in
+ * compose-only mode) can gate on the same verdict without re-running the
+ * validator and risking drift.
+ */
+interface ValidationSummary {
+    /** True iff the current draft has zero validation errors. */
+    valid: boolean;
+    /** Total error count — the number the toolbar's issues chip displays. */
+    errorCount: number;
+    /**
+     * Raw validator messages, verbatim from
+     * `@tightknitai/slack-block-kit-validator`. Block-scoped messages are
+     * rooted at `blocks[N]`, indexing into the payload `toSlackBlocks` emits.
+     */
+    errors: readonly string[];
+}
+/**
+ * Context handed to {@link PrimaryActionConfig.onClick}: everything a
+ * host-owned commitment step needs, captured at click time.
+ */
+interface PrimaryActionContext {
+    /**
+     * The current draft in the builder's native format — the same shape
+     * `onChange` reports and `initialBlocks` accepts. Persist this to re-open
+     * the draft later; run it through `toSlackBlocks` when you need the
+     * Slack-ready payload.
+     */
+    blocks: SupportedBlock[];
+    /**
+     * The validation verdict at click time — the same summary
+     * {@link BlockKitchenBaseProps.onValidationChange} reports.
+     */
+    validation: ValidationSummary;
+}
+/**
+ * A host-owned primary action for compose-only mode, rendered in the
+ * toolbar slot where the built-in "Review & send" button normally sits.
+ * Use it when the builder's commitment step belongs to your app — e.g. a
+ * message drafter whose CTA is "Save template" — but you still want the
+ * button inside the builder chrome. For a CTA outside the builder, skip
+ * this and use {@link BlockKitchenBaseProps.onChange} +
+ * {@link BlockKitchenBaseProps.onValidationChange} instead.
+ */
+interface PrimaryActionConfig {
+    /** Label + accessible name for the toolbar button. */
+    label: string;
+    /** Called on click with the current draft and validation verdict. */
+    onClick: (context: PrimaryActionContext) => void;
+    /**
+     * Disable the button while the draft has validation errors, mirroring the
+     * built-in Send gating. Defaults to `false`: a drafter typically allows
+     * committing a work-in-progress draft and surfaces the verdict in its own
+     * flow instead. The button is never disabled for an empty draft — gate on
+     * `context.blocks.length` in `onClick` if you need that.
+     */
+    disableWhenInvalid?: boolean;
+}
 /**
  * Which token can edit a loaded message, as computed by the host.
  * `chat.update` only edits a message authored by the calling token:
@@ -794,11 +886,15 @@ interface Template {
     blocks: SupportedBlock[];
 }
 /**
- * Props for the top-level {@link BlockKitchen} component.
+ * Props shared by every {@link BlockKitchen} configuration.
  * The package is integration-agnostic: every I/O concern is brokered
  * through these props. The component never makes a network call itself.
+ *
+ * Combined with either {@link BlockKitchenSendProps} (the built-in send
+ * flow) or {@link BlockKitchenComposeOnlyProps} (compose-only: no send
+ * button, the host owns the send flow) to form {@link BlockKitchenProps}.
  */
-interface BlockKitchenProps {
+interface BlockKitchenBaseProps {
     /**
      * Workspace name shown in the preview chrome to mimic a Slack message header.
      * Cosmetic only.
@@ -813,6 +909,15 @@ interface BlockKitchenProps {
      * (URL search param, localStorage, etc).
      */
     onChange?: (blocks: SupportedBlock[]) => void;
+    /**
+     * Fires when the draft's validation verdict changes (piggybacking on the
+     * builder's own debounced validation pass — not on every keystroke, and
+     * not when the verdict is unchanged). Always scoped to the `message`
+     * surface, matching what Send would post. Useful in compose-only mode: a
+     * host-rendered CTA can disable itself on `!valid` using the exact verdict
+     * the issues sheet displays.
+     */
+    onValidationChange?: (summary: ValidationSummary) => void;
     /**
      * Optional hooks forwarded to the underlying `<Message>` component for
      * resolving user / channel / emoji directives. If omitted, those
@@ -830,29 +935,6 @@ interface BlockKitchenProps {
      * is never serialized into the emitted Block Kit JSON.
      */
     customEmojis?: CustomEmoji[];
-    /**
-     * Returns channels available to send to. Called when the send dialog opens.
-     */
-    loadChannels: () => Promise<ChannelOption[]>;
-    /**
-     * Returns whether the current user can post as themselves and, if not, an
-     * OAuth URL to start the install flow.
-     */
-    loadSendAsUserStatus: () => Promise<SendAsUserStatus>;
-    /**
-     * Called when the user submits the send dialog. Should return
-     * `{ ok: true }` on success or `{ ok: false, error }` on failure.
-     */
-    onSend: (payload: SendPayload) => Promise<SendResult>;
-    /**
-     * Opt-in edit mode. When provided, the toolbar exposes an "Edit existing
-     * message" entry: the user pastes a Slack message link, the host loads it
-     * and returns an editability verdict ({@link EditingConfig.onLoadMessage}),
-     * and a successful load flips the primary action from Send to "Update
-     * message" ({@link EditingConfig.onUpdate}). Omit to keep today's send-only
-     * behavior. The user-token path reuses {@link BlockKitchenProps.loadSendAsUserStatus}.
-     */
-    editing?: EditingConfig;
     /**
      * Label + accessible name for the toolbar button that opens the
      * load-message dialog (the edit-mode entry point). Defaults to
@@ -1022,5 +1104,84 @@ interface BlockKitchenProps {
      */
     theme?: BrandTheme | BrandPreset;
 }
+/**
+ * The send integration: the trio of I/O callbacks powering the built-in
+ * send dialog, plus opt-in edit mode (which reuses them). All-or-nothing by
+ * design — see {@link BlockKitchenComposeOnlyProps} for the alternative.
+ */
+interface BlockKitchenSendProps {
+    /**
+     * Returns channels available to send to. Called when the send dialog opens.
+     */
+    loadChannels: () => Promise<ChannelOption[]>;
+    /**
+     * Returns whether the current user can post as themselves and, if not, an
+     * OAuth URL to start the install flow.
+     */
+    loadSendAsUserStatus: () => Promise<SendAsUserStatus>;
+    /**
+     * Called when the user submits the send dialog. Should return
+     * `{ ok: true }` on success or `{ ok: false, error }` on failure.
+     */
+    onSend: (payload: SendPayload) => Promise<SendResult>;
+    /**
+     * Opt-in edit mode. When provided, the toolbar exposes an "Edit existing
+     * message" entry: the user pastes a Slack message link, the host loads it
+     * and returns an editability verdict ({@link EditingConfig.onLoadMessage}),
+     * and a successful load flips the primary action from Send to "Update
+     * message" ({@link EditingConfig.onUpdate}). Omit to keep send-only
+     * behavior. The user-token path reuses {@link BlockKitchenSendProps.loadSendAsUserStatus}.
+     */
+    editing?: EditingConfig;
+    /**
+     * Renders host-defined fields inside the built-in send dialog, below the
+     * channel and identity pickers. Values collected via
+     * {@link SendExtrasContext.setExtras} are delivered on
+     * {@link SendPayload.extras} when the user confirms. Use this when the
+     * built-in flow is almost right and you need a few extra controls (a
+     * cross-post toggle, a custom sender name) without rebuilding the dialog.
+     */
+    renderSendExtras?: (context: SendExtrasContext) => ReactNode;
+    /**
+     * Unavailable with the send integration: the built-in Send/Update flow
+     * owns the toolbar's primary action. A host-owned
+     * {@link PrimaryActionConfig} exists only in compose-only mode.
+     */
+    primaryAction?: undefined;
+}
+/**
+ * Compose-only mode: omit the entire send integration and the builder
+ * renders no send button — it becomes a pure editor. The host owns the
+ * moment of commitment: mirror the draft via
+ * {@link BlockKitchenBaseProps.onChange}, gate a host-rendered CTA via
+ * {@link BlockKitchenBaseProps.onValidationChange}, and hand the finished
+ * payload (`toSlackBlocks(draft)`) to your own audience/delivery flow.
+ *
+ * The explicit `undefined` members make the send trio all-or-nothing at the
+ * type level: wiring only some of the three is a type error instead of a
+ * silently dead send button.
+ */
+interface BlockKitchenComposeOnlyProps {
+    loadChannels?: undefined;
+    loadSendAsUserStatus?: undefined;
+    onSend?: undefined;
+    /** Edit mode depends on the send integration, so it is unavailable too. */
+    editing?: undefined;
+    /** Extends the built-in send dialog, which doesn't exist in this mode. */
+    renderSendExtras?: undefined;
+    /**
+     * Optional host-owned button rendered in the toolbar slot where the
+     * built-in "Review & send" normally sits — e.g. "Save template" for a
+     * message drafter. `onClick` receives the current draft and validation
+     * verdict ({@link PrimaryActionContext}). Omit it to render no primary
+     * action at all and place your CTA outside the builder.
+     */
+    primaryAction?: PrimaryActionConfig;
+}
+/**
+ * Props for the top-level {@link BlockKitchen} component: the shared base
+ * plus either the full send integration or none of it.
+ */
+type BlockKitchenProps = BlockKitchenBaseProps & (BlockKitchenSendProps | BlockKitchenComposeOnlyProps);
 
-export { type Template as $, type AlertBlock as A, type BlockKitchenProps as B, type CardBlock as C, type DataVisualizationBlock as D, type EditableVia as E, type FeedbackButtonSubobject as F, type PlanBlock as G, type HeaderLevel as H, type IconButtonElement as I, type PreviewHooks as J, type PreviewSurface as K, type LoadMessageInput as L, type MarkdownBlock as M, type PreviewTheme as N, type SendPayload as O, type PaletteSection as P, type SendResult as Q, type RecentMessage as R, type SendAsUserStatus as S, type SupportedBlock as T, type SupportedBlockType as U, type SupportedHeaderBlock as V, type TableBlock as W, type TableCell as X, type TableColumnSetting as Y, type TaskCardBlock as Z, type TaskCardStatus as _, type AlertLevel as a, type UpdatePayload as a0, type UpdateResult as a1, type UrlSourceElement as a2, type VideoBlock as a3, buildVariantById as a4, defaultPalette as a5, extraAlertVariant as a6, legacyInputVariants as a7, type BrandPreset as b, type BrandTheme as c, type BrandTokens as d, type BuilderBlock as e, type CarouselBlock as f, type CartesianChart as g, type ChannelOption as h, type Chart as i, type ChartAxisConfig as j, type ChartDataPoint as k, type ChartSeries as l, type ChartType as m, type ContainerBlock as n, type ContainerChildBlock as o, type ContextActionsBlock as p, type ContextActionsElement as q, type CustomEmoji as r, type EditingConfig as s, type FeedbackButtonsElement as t, type IconButtonIcon as u, type InputBlock as v, type LoadResult as w, type PaletteVariant as x, type PieChart as y, type PieChartSegment as z };
+export { type SupportedHeaderBlock as $, type AlertBlock as A, type BlockKitchenBaseProps as B, type CardBlock as C, type DataVisualizationBlock as D, type EditableVia as E, type FeedbackButtonSubobject as F, type PaletteVariant as G, type HeaderLevel as H, type IconButtonElement as I, type PieChart as J, type PieChartSegment as K, type LoadMessageInput as L, type MarkdownBlock as M, type PlanBlock as N, type PreviewHooks as O, type PaletteSection as P, type PreviewSurface as Q, type PreviewTheme as R, type PrimaryActionConfig as S, type PrimaryActionContext as T, type RecentMessage as U, type SendAsUserStatus as V, type SendExtrasContext as W, type SendPayload as X, type SendResult as Y, type SupportedBlock as Z, type SupportedBlockType as _, type AlertLevel as a, type TableBlock as a0, type TableCell as a1, type TableColumnSetting as a2, type TaskCardBlock as a3, type TaskCardStatus as a4, type Template as a5, type UpdatePayload as a6, type UpdateResult as a7, type UrlSourceElement as a8, type ValidationSummary as a9, type VideoBlock as aa, buildVariantById as ab, defaultPalette as ac, extraAlertVariant as ad, legacyInputVariants as ae, type BlockKitchenComposeOnlyProps as b, type BlockKitchenProps as c, type BlockKitchenSendProps as d, type BrandPreset as e, type BrandTheme as f, type BrandTokens as g, type BuilderBlock as h, type CarouselBlock as i, type CartesianChart as j, type ChannelOption as k, type Chart as l, type ChartAxisConfig as m, type ChartDataPoint as n, type ChartSeries as o, type ChartType as p, type ContainerBlock as q, type ContainerChildBlock as r, type ContextActionsBlock as s, type ContextActionsElement as t, type CustomEmoji as u, type EditingConfig as v, type FeedbackButtonsElement as w, type IconButtonIcon as x, type InputBlock as y, type LoadResult as z };

package/dist/{palette-CKP8CK5Z.d.ts → palette-Duj901T6.d.ts}

@@ -1,4 +1,4 @@
-import { ComponentType, SVGProps } from 'react';
+import { ComponentType, SVGProps, ReactNode } from 'react';
 import { SectionBlock, HeaderBlock, DividerBlock, ContextBlock, ActionsBlock, ImageBlock, RichTextBlock, ImageElement, Button, ViewInputBlock } from 'slack-web-api-client';
 
 /**
@@ -571,6 +571,38 @@ interface SendPayload {
     channelId: string;
     blocks: SupportedBlock[];
     sendAsUser: boolean;
+    /**
+     * Values collected from the host's
+     * {@link BlockKitchenSendProps.renderSendExtras} fields, exactly as
+     * accumulated through {@link SendExtrasContext.setExtras}. Present
+     * (possibly `{}`) iff `renderSendExtras` is wired; absent otherwise, so
+     * existing consumers never see a new key.
+     */
+    extras?: Record<string, unknown>;
+}
+/**
+ * Context passed to {@link BlockKitchenSendProps.renderSendExtras} on every
+ * render of the send dialog. The `extras` object is owned by the dialog —
+ * it resets each time the dialog opens (alongside the channel and identity
+ * pickers) and is delivered on {@link SendPayload.extras} when the user
+ * confirms.
+ */
+interface SendExtrasContext {
+    /**
+     * Destination channel currently selected in the dialog, or `null` while
+     * channels are still loading / none is selected. Lets extras react to the
+     * destination (e.g. only offer cross-posting for some channels).
+     */
+    channelId: string | null;
+    /** Whether "post as the user" (vs. the app bot) is currently selected. */
+    sendAsUser: boolean;
+    /** The values collected so far. Render controlled inputs from these. */
+    extras: Record<string, unknown>;
+    /**
+     * Shallow-merges `patch` into {@link SendExtrasContext.extras}. Keys you
+     * never set simply don't appear in the payload.
+     */
+    setExtras: (patch: Record<string, unknown>) => void;
 }
 /**
  * Result returned from {@link BlockKitchenProps.onSend}.
@@ -580,6 +612,66 @@ interface SendResult {
     ok: boolean;
     error?: string;
 }
+/**
+ * Snapshot of the builder's validation verdict, reported through
+ * {@link BlockKitchenBaseProps.onValidationChange}. Mirrors exactly what the
+ * built-in issues chip / issues sheet show, so a host-owned CTA (e.g. in
+ * compose-only mode) can gate on the same verdict without re-running the
+ * validator and risking drift.
+ */
+interface ValidationSummary {
+    /** True iff the current draft has zero validation errors. */
+    valid: boolean;
+    /** Total error count — the number the toolbar's issues chip displays. */
+    errorCount: number;
+    /**
+     * Raw validator messages, verbatim from
+     * `@tightknitai/slack-block-kit-validator`. Block-scoped messages are
+     * rooted at `blocks[N]`, indexing into the payload `toSlackBlocks` emits.
+     */
+    errors: readonly string[];
+}
+/**
+ * Context handed to {@link PrimaryActionConfig.onClick}: everything a
+ * host-owned commitment step needs, captured at click time.
+ */
+interface PrimaryActionContext {
+    /**
+     * The current draft in the builder's native format — the same shape
+     * `onChange` reports and `initialBlocks` accepts. Persist this to re-open
+     * the draft later; run it through `toSlackBlocks` when you need the
+     * Slack-ready payload.
+     */
+    blocks: SupportedBlock[];
+    /**
+     * The validation verdict at click time — the same summary
+     * {@link BlockKitchenBaseProps.onValidationChange} reports.
+     */
+    validation: ValidationSummary;
+}
+/**
+ * A host-owned primary action for compose-only mode, rendered in the
+ * toolbar slot where the built-in "Review & send" button normally sits.
+ * Use it when the builder's commitment step belongs to your app — e.g. a
+ * message drafter whose CTA is "Save template" — but you still want the
+ * button inside the builder chrome. For a CTA outside the builder, skip
+ * this and use {@link BlockKitchenBaseProps.onChange} +
+ * {@link BlockKitchenBaseProps.onValidationChange} instead.
+ */
+interface PrimaryActionConfig {
+    /** Label + accessible name for the toolbar button. */
+    label: string;
+    /** Called on click with the current draft and validation verdict. */
+    onClick: (context: PrimaryActionContext) => void;
+    /**
+     * Disable the button while the draft has validation errors, mirroring the
+     * built-in Send gating. Defaults to `false`: a drafter typically allows
+     * committing a work-in-progress draft and surfaces the verdict in its own
+     * flow instead. The button is never disabled for an empty draft — gate on
+     * `context.blocks.length` in `onClick` if you need that.
+     */
+    disableWhenInvalid?: boolean;
+}
 /**
  * Which token can edit a loaded message, as computed by the host.
  * `chat.update` only edits a message authored by the calling token:
@@ -794,11 +886,15 @@ interface Template {
     blocks: SupportedBlock[];
 }
 /**
- * Props for the top-level {@link BlockKitchen} component.
+ * Props shared by every {@link BlockKitchen} configuration.
  * The package is integration-agnostic: every I/O concern is brokered
  * through these props. The component never makes a network call itself.
+ *
+ * Combined with either {@link BlockKitchenSendProps} (the built-in send
+ * flow) or {@link BlockKitchenComposeOnlyProps} (compose-only: no send
+ * button, the host owns the send flow) to form {@link BlockKitchenProps}.
  */
-interface BlockKitchenProps {
+interface BlockKitchenBaseProps {
     /**
      * Workspace name shown in the preview chrome to mimic a Slack message header.
      * Cosmetic only.
@@ -813,6 +909,15 @@ interface BlockKitchenProps {
      * (URL search param, localStorage, etc).
      */
     onChange?: (blocks: SupportedBlock[]) => void;
+    /**
+     * Fires when the draft's validation verdict changes (piggybacking on the
+     * builder's own debounced validation pass — not on every keystroke, and
+     * not when the verdict is unchanged). Always scoped to the `message`
+     * surface, matching what Send would post. Useful in compose-only mode: a
+     * host-rendered CTA can disable itself on `!valid` using the exact verdict
+     * the issues sheet displays.
+     */
+    onValidationChange?: (summary: ValidationSummary) => void;
     /**
      * Optional hooks forwarded to the underlying `<Message>` component for
      * resolving user / channel / emoji directives. If omitted, those
@@ -830,29 +935,6 @@ interface BlockKitchenProps {
      * is never serialized into the emitted Block Kit JSON.
      */
     customEmojis?: CustomEmoji[];
-    /**
-     * Returns channels available to send to. Called when the send dialog opens.
-     */
-    loadChannels: () => Promise<ChannelOption[]>;
-    /**
-     * Returns whether the current user can post as themselves and, if not, an
-     * OAuth URL to start the install flow.
-     */
-    loadSendAsUserStatus: () => Promise<SendAsUserStatus>;
-    /**
-     * Called when the user submits the send dialog. Should return
-     * `{ ok: true }` on success or `{ ok: false, error }` on failure.
-     */
-    onSend: (payload: SendPayload) => Promise<SendResult>;
-    /**
-     * Opt-in edit mode. When provided, the toolbar exposes an "Edit existing
-     * message" entry: the user pastes a Slack message link, the host loads it
-     * and returns an editability verdict ({@link EditingConfig.onLoadMessage}),
-     * and a successful load flips the primary action from Send to "Update
-     * message" ({@link EditingConfig.onUpdate}). Omit to keep today's send-only
-     * behavior. The user-token path reuses {@link BlockKitchenProps.loadSendAsUserStatus}.
-     */
-    editing?: EditingConfig;
     /**
      * Label + accessible name for the toolbar button that opens the
      * load-message dialog (the edit-mode entry point). Defaults to
@@ -1022,5 +1104,84 @@ interface BlockKitchenProps {
      */
     theme?: BrandTheme | BrandPreset;
 }
+/**
+ * The send integration: the trio of I/O callbacks powering the built-in
+ * send dialog, plus opt-in edit mode (which reuses them). All-or-nothing by
+ * design — see {@link BlockKitchenComposeOnlyProps} for the alternative.
+ */
+interface BlockKitchenSendProps {
+    /**
+     * Returns channels available to send to. Called when the send dialog opens.
+     */
+    loadChannels: () => Promise<ChannelOption[]>;
+    /**
+     * Returns whether the current user can post as themselves and, if not, an
+     * OAuth URL to start the install flow.
+     */
+    loadSendAsUserStatus: () => Promise<SendAsUserStatus>;
+    /**
+     * Called when the user submits the send dialog. Should return
+     * `{ ok: true }` on success or `{ ok: false, error }` on failure.
+     */
+    onSend: (payload: SendPayload) => Promise<SendResult>;
+    /**
+     * Opt-in edit mode. When provided, the toolbar exposes an "Edit existing
+     * message" entry: the user pastes a Slack message link, the host loads it
+     * and returns an editability verdict ({@link EditingConfig.onLoadMessage}),
+     * and a successful load flips the primary action from Send to "Update
+     * message" ({@link EditingConfig.onUpdate}). Omit to keep send-only
+     * behavior. The user-token path reuses {@link BlockKitchenSendProps.loadSendAsUserStatus}.
+     */
+    editing?: EditingConfig;
+    /**
+     * Renders host-defined fields inside the built-in send dialog, below the
+     * channel and identity pickers. Values collected via
+     * {@link SendExtrasContext.setExtras} are delivered on
+     * {@link SendPayload.extras} when the user confirms. Use this when the
+     * built-in flow is almost right and you need a few extra controls (a
+     * cross-post toggle, a custom sender name) without rebuilding the dialog.
+     */
+    renderSendExtras?: (context: SendExtrasContext) => ReactNode;
+    /**
+     * Unavailable with the send integration: the built-in Send/Update flow
+     * owns the toolbar's primary action. A host-owned
+     * {@link PrimaryActionConfig} exists only in compose-only mode.
+     */
+    primaryAction?: undefined;
+}
+/**
+ * Compose-only mode: omit the entire send integration and the builder
+ * renders no send button — it becomes a pure editor. The host owns the
+ * moment of commitment: mirror the draft via
+ * {@link BlockKitchenBaseProps.onChange}, gate a host-rendered CTA via
+ * {@link BlockKitchenBaseProps.onValidationChange}, and hand the finished
+ * payload (`toSlackBlocks(draft)`) to your own audience/delivery flow.
+ *
+ * The explicit `undefined` members make the send trio all-or-nothing at the
+ * type level: wiring only some of the three is a type error instead of a
+ * silently dead send button.
+ */
+interface BlockKitchenComposeOnlyProps {
+    loadChannels?: undefined;
+    loadSendAsUserStatus?: undefined;
+    onSend?: undefined;
+    /** Edit mode depends on the send integration, so it is unavailable too. */
+    editing?: undefined;
+    /** Extends the built-in send dialog, which doesn't exist in this mode. */
+    renderSendExtras?: undefined;
+    /**
+     * Optional host-owned button rendered in the toolbar slot where the
+     * built-in "Review & send" normally sits — e.g. "Save template" for a
+     * message drafter. `onClick` receives the current draft and validation
+     * verdict ({@link PrimaryActionContext}). Omit it to render no primary
+     * action at all and place your CTA outside the builder.
+     */
+    primaryAction?: PrimaryActionConfig;
+}
+/**
+ * Props for the top-level {@link BlockKitchen} component: the shared base
+ * plus either the full send integration or none of it.
+ */
+type BlockKitchenProps = BlockKitchenBaseProps & (BlockKitchenSendProps | BlockKitchenComposeOnlyProps);
 
-export { type Template as $, type AlertBlock as A, type BlockKitchenProps as B, type CardBlock as C, type DataVisualizationBlock as D, type EditableVia as E, type FeedbackButtonSubobject as F, type PlanBlock as G, type HeaderLevel as H, type IconButtonElement as I, type PreviewHooks as J, type PreviewSurface as K, type LoadMessageInput as L, type MarkdownBlock as M, type PreviewTheme as N, type SendPayload as O, type PaletteSection as P, type SendResult as Q, type RecentMessage as R, type SendAsUserStatus as S, type SupportedBlock as T, type SupportedBlockType as U, type SupportedHeaderBlock as V, type TableBlock as W, type TableCell as X, type TableColumnSetting as Y, type TaskCardBlock as Z, type TaskCardStatus as _, type AlertLevel as a, type UpdatePayload as a0, type UpdateResult as a1, type UrlSourceElement as a2, type VideoBlock as a3, buildVariantById as a4, defaultPalette as a5, extraAlertVariant as a6, legacyInputVariants as a7, type BrandPreset as b, type BrandTheme as c, type BrandTokens as d, type BuilderBlock as e, type CarouselBlock as f, type CartesianChart as g, type ChannelOption as h, type Chart as i, type ChartAxisConfig as j, type ChartDataPoint as k, type ChartSeries as l, type ChartType as m, type ContainerBlock as n, type ContainerChildBlock as o, type ContextActionsBlock as p, type ContextActionsElement as q, type CustomEmoji as r, type EditingConfig as s, type FeedbackButtonsElement as t, type IconButtonIcon as u, type InputBlock as v, type LoadResult as w, type PaletteVariant as x, type PieChart as y, type PieChartSegment as z };
+export { type SupportedHeaderBlock as $, type AlertBlock as A, type BlockKitchenBaseProps as B, type CardBlock as C, type DataVisualizationBlock as D, type EditableVia as E, type FeedbackButtonSubobject as F, type PaletteVariant as G, type HeaderLevel as H, type IconButtonElement as I, type PieChart as J, type PieChartSegment as K, type LoadMessageInput as L, type MarkdownBlock as M, type PlanBlock as N, type PreviewHooks as O, type PaletteSection as P, type PreviewSurface as Q, type PreviewTheme as R, type PrimaryActionConfig as S, type PrimaryActionContext as T, type RecentMessage as U, type SendAsUserStatus as V, type SendExtrasContext as W, type SendPayload as X, type SendResult as Y, type SupportedBlock as Z, type SupportedBlockType as _, type AlertLevel as a, type TableBlock as a0, type TableCell as a1, type TableColumnSetting as a2, type TaskCardBlock as a3, type TaskCardStatus as a4, type Template as a5, type UpdatePayload as a6, type UpdateResult as a7, type UrlSourceElement as a8, type ValidationSummary as a9, type VideoBlock as aa, buildVariantById as ab, defaultPalette as ac, extraAlertVariant as ad, legacyInputVariants as ae, type BlockKitchenComposeOnlyProps as b, type BlockKitchenProps as c, type BlockKitchenSendProps as d, type BrandPreset as e, type BrandTheme as f, type BrandTokens as g, type BuilderBlock as h, type CarouselBlock as i, type CartesianChart as j, type ChannelOption as k, type Chart as l, type ChartAxisConfig as m, type ChartDataPoint as n, type ChartSeries as o, type ChartType as p, type ContainerBlock as q, type ContainerChildBlock as r, type ContextActionsBlock as s, type ContextActionsElement as t, type CustomEmoji as u, type EditingConfig as v, type FeedbackButtonsElement as w, type IconButtonIcon as x, type InputBlock as y, type LoadResult as z };

package/dist/palette.d.cts

@@ -1,3 +1,3 @@
-export { P as PaletteSection, x as PaletteVariant, T as SupportedBlock, U as SupportedBlockType, a4 as buildVariantById, a5 as defaultPalette, a6 as extraAlertVariant, a7 as legacyInputVariants } from './palette-CKP8CK5Z.cjs';
+export { P as PaletteSection, G as PaletteVariant, Z as SupportedBlock, _ as SupportedBlockType, ab as buildVariantById, ac as defaultPalette, ad as extraAlertVariant, ae as legacyInputVariants } from './palette-Duj901T6.cjs';
 import 'react';
 import 'slack-web-api-client';

package/dist/palette.d.ts

@@ -1,3 +1,3 @@
-export { P as PaletteSection, x as PaletteVariant, T as SupportedBlock, U as SupportedBlockType, a4 as buildVariantById, a5 as defaultPalette, a6 as extraAlertVariant, a7 as legacyInputVariants } from './palette-CKP8CK5Z.js';
+export { P as PaletteSection, G as PaletteVariant, Z as SupportedBlock, _ as SupportedBlockType, ab as buildVariantById, ac as defaultPalette, ad as extraAlertVariant, ae as legacyInputVariants } from './palette-Duj901T6.js';
 import 'react';
 import 'slack-web-api-client';