@tightknitai/block-kitchen 0.9.9 → 0.9.10

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 import * as react from 'react';
-import { B as BlockKitchenProps, $ as Template, K as PreviewSurface, N as PreviewTheme } from './palette-CKP8CK5Z.cjs';
-export { A as AlertBlock, a as AlertLevel, b as BrandPreset, c as BrandTheme, d as BrandTokens, e as BuilderBlock, C as CardBlock, f as CarouselBlock, g as CartesianChart, h as ChannelOption, i as Chart, j as ChartAxisConfig, k as ChartDataPoint, l as ChartSeries, m as ChartType, n as ContainerBlock, o as ContainerChildBlock, p as ContextActionsBlock, q as ContextActionsElement, r as CustomEmoji, D as DataVisualizationBlock, E as EditableVia, s as EditingConfig, F as FeedbackButtonSubobject, t as FeedbackButtonsElement, H as HeaderLevel, I as IconButtonElement, u as IconButtonIcon, v as InputBlock, L as LoadMessageInput, w as LoadResult, M as MarkdownBlock, P as PaletteSection, x as PaletteVariant, y as PieChart, z as PieChartSegment, G as PlanBlock, J as PreviewHooks, R as RecentMessage, S as SendAsUserStatus, O as SendPayload, Q as SendResult, T as SupportedBlock, U as SupportedBlockType, V as SupportedHeaderBlock, W as TableBlock, X as TableCell, Y as TableColumnSetting, Z as TaskCardBlock, _ as TaskCardStatus, a0 as UpdatePayload, a1 as UpdateResult, a2 as UrlSourceElement, a3 as VideoBlock, a5 as defaultPalette, a6 as extraAlertVariant, a7 as legacyInputVariants } from './palette-CKP8CK5Z.cjs';
+import { ReactNode } from 'react';
+import { c as BlockKitchenProps, Z as SupportedBlock, k as ChannelOption, V as SendAsUserStatus, X as SendPayload, W as SendExtrasContext, a5 as Template, Q as PreviewSurface, R as PreviewTheme } from './palette-Duj901T6.cjs';
+export { A as AlertBlock, a as AlertLevel, B as BlockKitchenBaseProps, b as BlockKitchenComposeOnlyProps, d as BlockKitchenSendProps, e as BrandPreset, f as BrandTheme, g as BrandTokens, h as BuilderBlock, C as CardBlock, i as CarouselBlock, j as CartesianChart, l as Chart, m as ChartAxisConfig, n as ChartDataPoint, o as ChartSeries, p as ChartType, q as ContainerBlock, r as ContainerChildBlock, s as ContextActionsBlock, t as ContextActionsElement, u as CustomEmoji, D as DataVisualizationBlock, E as EditableVia, v as EditingConfig, F as FeedbackButtonSubobject, w as FeedbackButtonsElement, H as HeaderLevel, I as IconButtonElement, x as IconButtonIcon, y as InputBlock, L as LoadMessageInput, z as LoadResult, M as MarkdownBlock, P as PaletteSection, G as PaletteVariant, J as PieChart, K as PieChartSegment, N as PlanBlock, O as PreviewHooks, S as PrimaryActionConfig, T as PrimaryActionContext, U as RecentMessage, Y as SendResult, _ as SupportedBlockType, $ as SupportedHeaderBlock, a0 as TableBlock, a1 as TableCell, a2 as TableColumnSetting, a3 as TaskCardBlock, a4 as TaskCardStatus, a6 as UpdatePayload, a7 as UpdateResult, a8 as UrlSourceElement, a9 as ValidationSummary, aa as VideoBlock, ac as defaultPalette, ad as extraAlertVariant, ae as legacyInputVariants } from './palette-Duj901T6.cjs';
 export { decodeBlocksFromString, encodeBlocksToString, toSlackBlocks } from './helpers.cjs';
 import 'slack-web-api-client';
 
@@ -14,6 +15,85 @@ import 'slack-web-api-client';
  */
 declare function BlockKitchen(props: BlockKitchenProps): react.JSX.Element;
 
+/**
+ * Props for {@link SendDialog}. Exported so hosts building a bespoke send
+ * flow (compose-only mode) can reuse the built-in dialog standalone instead
+ * of rebuilding channel loading, identity, and sending states from scratch.
+ */
+interface SendDialogProps {
+    /** Whether the dialog is open. */
+    open: boolean;
+    /** Notified when the user closes the dialog. */
+    onOpenChange: (open: boolean) => void;
+    /** The draft blocks to send (builder-native format). */
+    blocks: SupportedBlock[];
+    /** Returns channels available to send to. Called when the dialog opens. */
+    loadChannels: () => Promise<ChannelOption[]>;
+    /** Returns user-token status + OAuth URL. */
+    loadSendAsUserStatus: () => Promise<SendAsUserStatus>;
+    /** Terminal action; should return `{ ok }` or `{ ok: false, error }`. */
+    onSend: (payload: SendPayload) => Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /**
+     * Renders host-defined fields below the built-in pickers; collected
+     * values are delivered on {@link SendPayload.extras}.
+     */
+    renderSendExtras?: (context: SendExtrasContext) => ReactNode;
+    /** Label for the final confirm button. Defaults to `'Send'`. */
+    confirmSendLabel?: string;
+    /** Total validation errors against the current draft. */
+    errorCount: number;
+    /** Asks the parent to open the global issues panel. */
+    onShowIssues?: () => void;
+}
+/**
+ * Modal dialog that collects the destination channel + send-as identity
+ * (plus any host-defined extras), then calls the consumer's `onSend`.
+ *
+ * Channels and user-token status are loaded async via callback props on open.
+ * The consumer brokers all I/O; the dialog never makes a network call.
+ * @param props - {@link SendDialogProps}
+ * @returns the rendered send dialog
+ */
+declare function SendDialog({ open, onOpenChange, blocks, loadChannels, loadSendAsUserStatus, onSend, renderSendExtras, confirmSendLabel, errorCount, onShowIssues }: SendDialogProps): react.JSX.Element;
+
+/**
+ * Tracks the "act as the user" Slack token status for a dialog and drives the
+ * OAuth sign-in flow. Shared by {@link SendDialog} and {@link UpdateDialog}.
+ *
+ * While `open && enabled` it fetches status on open and refreshes on window
+ * focus. Once `startSignIn` opens the OAuth tab it also background-polls until
+ * the token appears or the retry cap is hit, so the dialog unlocks itself
+ * without a manual reload. All work stops when the dialog closes, the token
+ * path doesn't apply, or the component unmounts.
+ *
+ * @param loadStatus - consumer callback returning user-token status + OAuth URL
+ * @param options.open - whether the host dialog is open
+ * @param options.enabled - whether the user-token path applies (idle when false)
+ * @returns `{ userStatus, polling, startSignIn }`
+ */
+declare function useSlackSignIn(loadStatus: () => Promise<SendAsUserStatus>, { open, enabled }: {
+    open: boolean;
+    enabled: boolean;
+}): {
+    userStatus: SendAsUserStatus | null;
+    polling: boolean;
+    startSignIn: () => void;
+};
+/**
+ * The "Sign in with Slack" button used by both dialogs. Opens OAuth and shows a
+ * spinner while {@link useSlackSignIn} polls for the completed round-trip. The
+ * surrounding explanatory copy stays with each caller since it differs.
+ * @param props.onClick - starts the sign-in flow (typically `startSignIn`)
+ * @param props.polling - whether a background poll is in flight
+ */
+declare function SlackSignInButton({ onClick, polling }: {
+    onClick: () => void;
+    polling: boolean;
+}): react.JSX.Element;
+
 /**
  * Standalone, page-sized picker that displays {@link Template}s as a
  * grid of cards with live block previews, organized into category
@@ -51,4 +131,4 @@ declare function TemplatePicker({ templates, onSelect, surface, theme, heading,
     className?: string;
 }): react.JSX.Element;
 
-export { BlockKitchen, BlockKitchenProps, PreviewSurface, PreviewTheme, Template, TemplatePicker };
+export { BlockKitchen, BlockKitchenProps, ChannelOption, PreviewSurface, PreviewTheme, SendAsUserStatus, SendDialog, type SendDialogProps, SendExtrasContext, SendPayload, SlackSignInButton, SupportedBlock, Template, TemplatePicker, useSlackSignIn };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import * as react from 'react';
-import { B as BlockKitchenProps, $ as Template, K as PreviewSurface, N as PreviewTheme } from './palette-CKP8CK5Z.js';
-export { A as AlertBlock, a as AlertLevel, b as BrandPreset, c as BrandTheme, d as BrandTokens, e as BuilderBlock, C as CardBlock, f as CarouselBlock, g as CartesianChart, h as ChannelOption, i as Chart, j as ChartAxisConfig, k as ChartDataPoint, l as ChartSeries, m as ChartType, n as ContainerBlock, o as ContainerChildBlock, p as ContextActionsBlock, q as ContextActionsElement, r as CustomEmoji, D as DataVisualizationBlock, E as EditableVia, s as EditingConfig, F as FeedbackButtonSubobject, t as FeedbackButtonsElement, H as HeaderLevel, I as IconButtonElement, u as IconButtonIcon, v as InputBlock, L as LoadMessageInput, w as LoadResult, M as MarkdownBlock, P as PaletteSection, x as PaletteVariant, y as PieChart, z as PieChartSegment, G as PlanBlock, J as PreviewHooks, R as RecentMessage, S as SendAsUserStatus, O as SendPayload, Q as SendResult, T as SupportedBlock, U as SupportedBlockType, V as SupportedHeaderBlock, W as TableBlock, X as TableCell, Y as TableColumnSetting, Z as TaskCardBlock, _ as TaskCardStatus, a0 as UpdatePayload, a1 as UpdateResult, a2 as UrlSourceElement, a3 as VideoBlock, a5 as defaultPalette, a6 as extraAlertVariant, a7 as legacyInputVariants } from './palette-CKP8CK5Z.js';
+import { ReactNode } from 'react';
+import { c as BlockKitchenProps, Z as SupportedBlock, k as ChannelOption, V as SendAsUserStatus, X as SendPayload, W as SendExtrasContext, a5 as Template, Q as PreviewSurface, R as PreviewTheme } from './palette-Duj901T6.js';
+export { A as AlertBlock, a as AlertLevel, B as BlockKitchenBaseProps, b as BlockKitchenComposeOnlyProps, d as BlockKitchenSendProps, e as BrandPreset, f as BrandTheme, g as BrandTokens, h as BuilderBlock, C as CardBlock, i as CarouselBlock, j as CartesianChart, l as Chart, m as ChartAxisConfig, n as ChartDataPoint, o as ChartSeries, p as ChartType, q as ContainerBlock, r as ContainerChildBlock, s as ContextActionsBlock, t as ContextActionsElement, u as CustomEmoji, D as DataVisualizationBlock, E as EditableVia, v as EditingConfig, F as FeedbackButtonSubobject, w as FeedbackButtonsElement, H as HeaderLevel, I as IconButtonElement, x as IconButtonIcon, y as InputBlock, L as LoadMessageInput, z as LoadResult, M as MarkdownBlock, P as PaletteSection, G as PaletteVariant, J as PieChart, K as PieChartSegment, N as PlanBlock, O as PreviewHooks, S as PrimaryActionConfig, T as PrimaryActionContext, U as RecentMessage, Y as SendResult, _ as SupportedBlockType, $ as SupportedHeaderBlock, a0 as TableBlock, a1 as TableCell, a2 as TableColumnSetting, a3 as TaskCardBlock, a4 as TaskCardStatus, a6 as UpdatePayload, a7 as UpdateResult, a8 as UrlSourceElement, a9 as ValidationSummary, aa as VideoBlock, ac as defaultPalette, ad as extraAlertVariant, ae as legacyInputVariants } from './palette-Duj901T6.js';
 export { decodeBlocksFromString, encodeBlocksToString, toSlackBlocks } from './helpers.js';
 import 'slack-web-api-client';
 
@@ -14,6 +15,85 @@ import 'slack-web-api-client';
  */
 declare function BlockKitchen(props: BlockKitchenProps): react.JSX.Element;
 
+/**
+ * Props for {@link SendDialog}. Exported so hosts building a bespoke send
+ * flow (compose-only mode) can reuse the built-in dialog standalone instead
+ * of rebuilding channel loading, identity, and sending states from scratch.
+ */
+interface SendDialogProps {
+    /** Whether the dialog is open. */
+    open: boolean;
+    /** Notified when the user closes the dialog. */
+    onOpenChange: (open: boolean) => void;
+    /** The draft blocks to send (builder-native format). */
+    blocks: SupportedBlock[];
+    /** Returns channels available to send to. Called when the dialog opens. */
+    loadChannels: () => Promise<ChannelOption[]>;
+    /** Returns user-token status + OAuth URL. */
+    loadSendAsUserStatus: () => Promise<SendAsUserStatus>;
+    /** Terminal action; should return `{ ok }` or `{ ok: false, error }`. */
+    onSend: (payload: SendPayload) => Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /**
+     * Renders host-defined fields below the built-in pickers; collected
+     * values are delivered on {@link SendPayload.extras}.
+     */
+    renderSendExtras?: (context: SendExtrasContext) => ReactNode;
+    /** Label for the final confirm button. Defaults to `'Send'`. */
+    confirmSendLabel?: string;
+    /** Total validation errors against the current draft. */
+    errorCount: number;
+    /** Asks the parent to open the global issues panel. */
+    onShowIssues?: () => void;
+}
+/**
+ * Modal dialog that collects the destination channel + send-as identity
+ * (plus any host-defined extras), then calls the consumer's `onSend`.
+ *
+ * Channels and user-token status are loaded async via callback props on open.
+ * The consumer brokers all I/O; the dialog never makes a network call.
+ * @param props - {@link SendDialogProps}
+ * @returns the rendered send dialog
+ */
+declare function SendDialog({ open, onOpenChange, blocks, loadChannels, loadSendAsUserStatus, onSend, renderSendExtras, confirmSendLabel, errorCount, onShowIssues }: SendDialogProps): react.JSX.Element;
+
+/**
+ * Tracks the "act as the user" Slack token status for a dialog and drives the
+ * OAuth sign-in flow. Shared by {@link SendDialog} and {@link UpdateDialog}.
+ *
+ * While `open && enabled` it fetches status on open and refreshes on window
+ * focus. Once `startSignIn` opens the OAuth tab it also background-polls until
+ * the token appears or the retry cap is hit, so the dialog unlocks itself
+ * without a manual reload. All work stops when the dialog closes, the token
+ * path doesn't apply, or the component unmounts.
+ *
+ * @param loadStatus - consumer callback returning user-token status + OAuth URL
+ * @param options.open - whether the host dialog is open
+ * @param options.enabled - whether the user-token path applies (idle when false)
+ * @returns `{ userStatus, polling, startSignIn }`
+ */
+declare function useSlackSignIn(loadStatus: () => Promise<SendAsUserStatus>, { open, enabled }: {
+    open: boolean;
+    enabled: boolean;
+}): {
+    userStatus: SendAsUserStatus | null;
+    polling: boolean;
+    startSignIn: () => void;
+};
+/**
+ * The "Sign in with Slack" button used by both dialogs. Opens OAuth and shows a
+ * spinner while {@link useSlackSignIn} polls for the completed round-trip. The
+ * surrounding explanatory copy stays with each caller since it differs.
+ * @param props.onClick - starts the sign-in flow (typically `startSignIn`)
+ * @param props.polling - whether a background poll is in flight
+ */
+declare function SlackSignInButton({ onClick, polling }: {
+    onClick: () => void;
+    polling: boolean;
+}): react.JSX.Element;
+
 /**
  * Standalone, page-sized picker that displays {@link Template}s as a
  * grid of cards with live block previews, organized into category
@@ -51,4 +131,4 @@ declare function TemplatePicker({ templates, onSelect, surface, theme, heading,
     className?: string;
 }): react.JSX.Element;
 
-export { BlockKitchen, BlockKitchenProps, PreviewSurface, PreviewTheme, Template, TemplatePicker };
+export { BlockKitchen, BlockKitchenProps, ChannelOption, PreviewSurface, PreviewTheme, SendAsUserStatus, SendDialog, type SendDialogProps, SendExtrasContext, SendPayload, SlackSignInButton, SupportedBlock, Template, TemplatePicker, useSlackSignIn };

package/dist/index.js

@@ -1,8 +1,8 @@
 import { useSensors, useSensor, PointerSensor, TouchSensor, KeyboardSensor, pointerWithin, closestCenter, DndContext, DragOverlay, useDroppable, useDraggable } from '@dnd-kit/core';
 import { sortableKeyboardCoordinates, SortableContext, verticalListSortingStrategy, useSortable } from '@dnd-kit/sortable';
-import { X, Circle, Sparkles, FileText, AlignLeft, MousePointerClick, TextCursorInput, LayoutTemplate, Bell, Pilcrow, Image, Video, GalleryHorizontal, Table, ChartColumnBig, Container, GripVertical, Sun, Moon, MessageSquare, AppWindow, Home, MailSearch, Plus, ChevronDown, BookOpen, ExternalLink, AlertTriangle, Trash2, Code2, Pencil, Send, Search, Check, Copy, Info, CheckCircle2, ChevronRight, LayoutGrid, ArrowUp, ArrowDown, Loader2, Type, Bold, Italic, Strikethrough, Underline, Code, List, ListOrdered, Quote, Undo2, Redo2, Smile, Link as Link$1 } from 'lucide-react';
+import { X, Circle, Sparkles, FileText, AlignLeft, MousePointerClick, TextCursorInput, LayoutTemplate, Bell, Pilcrow, Image, Video, GalleryHorizontal, Table, ChartColumnBig, Container, Loader2, ExternalLink, AlertTriangle, GripVertical, Sun, Moon, MessageSquare, AppWindow, Home, MailSearch, Plus, ChevronDown, BookOpen, Trash2, Code2, Pencil, Send, Search, Check, Copy, Info, CheckCircle2, ChevronRight, LayoutGrid, ArrowUp, ArrowDown, Type, Bold, Italic, Strikethrough, Underline, Code, List, ListOrdered, Quote, Undo2, Redo2, Smile, Link as Link$1 } from 'lucide-react';
 import * as React from 'react';
-import { createContext, useMemo, useEffect, useState, useCallback, useRef, useId, useContext } from 'react';
+import { createContext, useState, useRef, useEffect, useCallback, useMemo, useId, useContext } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import { clsx } from 'clsx';
@@ -2015,6 +2015,7 @@ function computeValidation(blocks, surface) {
   const grouped = groupValidatorErrors(result.errors, blocks);
   return {
     valid: result.valid,
+    errors: result.errors,
     byBlockId: grouped.byBlockId,
     general: grouped.general,
     total: grouped.total
@@ -3532,6 +3533,7 @@ function SendDialog({
   loadChannels,
   loadSendAsUserStatus,
   onSend,
+  renderSendExtras,
   confirmSendLabel = "Send",
   errorCount,
   onShowIssues
@@ -3541,6 +3543,10 @@ function SendDialog({
   const [channelId, setChannelId] = useState("");
   const [sendAs, setSendAs] = useState("bot");
   const [status, setStatus] = useState({ kind: "idle" });
+  const [extras, setExtrasState] = useState({});
+  const setExtras = useCallback((patch) => {
+    setExtrasState((prev) => ({ ...prev, ...patch }));
+  }, []);
   const { userStatus, polling, startSignIn } = useSlackSignIn(loadSendAsUserStatus, { open, enabled: true });
   const loadChannelsRef = useRef(loadChannels);
   useEffect(() => {
@@ -3555,6 +3561,7 @@ function SendDialog({
     setChannelsError(null);
     setChannelId("");
     setSendAs("bot");
+    setExtrasState({});
     let cancelled = false;
     loadChannelsRef.current().then((list) => {
       if (cancelled) {
@@ -3582,7 +3589,10 @@ function SendDialog({
       const result = await onSend({
         channelId,
         blocks: toSlackBlocks(blocks),
-        sendAsUser: sendAs === "user"
+        sendAsUser: sendAs === "user",
+        // Only introduce the key when the extras slot is wired, so existing
+        // consumers never see a new payload field.
+        ...renderSendExtras ? { extras } : {}
       });
       if (result.ok) {
         setStatus({ kind: "idle" });
@@ -3649,6 +3659,12 @@ function SendDialog({
           }
         )
       ] }),
+      renderSendExtras ? /* @__PURE__ */ jsx("div", { className: "flex flex-col gap-1.5", children: renderSendExtras({
+        channelId: channelId || null,
+        sendAsUser: sendAs === "user",
+        extras,
+        setExtras
+      }) }) : null,
       errorCount > 0 ? /* @__PURE__ */ jsxs(
         "button",
         {
@@ -9395,6 +9411,8 @@ function Toolbar2({
   showThemeControl = true,
   docsLink,
   errorCount,
+  showSend = true,
+  primaryAction,
   sendButtonLabel = "Review & send",
   editingEnabled = false,
   editBadge,
@@ -9529,7 +9547,24 @@ function Toolbar2({
           /* @__PURE__ */ jsx(Code2, { className: "h-3.5 w-3.5" }),
           /* @__PURE__ */ jsx("span", { className: "hidden md:inline", children: "View JSON" })
         ] }),
-        editBadge ? (
+        !showSend ? primaryAction ? (
+          // Compose-only mode with a host-owned primary action: same
+          // placement and styling as the built-in send button. No icon —
+          // the action's meaning is the host's, so the label always shows
+          // (the send button can collapse to its icon on small screens;
+          // an icon-less button can't).
+          /* @__PURE__ */ jsx(
+            Button,
+            {
+              type: "button",
+              size: "sm",
+              onClick: primaryAction.onClick,
+              disabled: primaryAction.disabled,
+              "aria-label": primaryAction.label,
+              children: /* @__PURE__ */ jsx("span", { children: primaryAction.label })
+            }
+          )
+        ) : null : editBadge ? (
           // A message is loaded: split button. Main action updates it in
           // place; the menu also offers posting the blocks as a new message.
           /* @__PURE__ */ jsxs("div", { className: "flex items-stretch", children: [
@@ -9772,12 +9807,15 @@ function BlockKitchen(props) {
     workspaceName,
     initialBlocks,
     onChange,
+    onValidationChange,
     previewHooks,
     customEmojis,
     loadChannels,
     loadSendAsUserStatus,
     onSend,
+    renderSendExtras,
     editing,
+    primaryAction,
     loadButtonLabel,
     updateButtonLabel,
     confirmUpdateLabel,
@@ -9794,6 +9832,13 @@ function BlockKitchen(props) {
     sendButtonLabel,
     confirmSendLabel,
     theme
+    // Widen the all-or-nothing union so the branch-specific props
+    // destructure as independent optionals: untyped JS consumers can still
+    // pass partial wiring (handled by the runtime guards below), and the
+    // correlated-union narrowing would otherwise flag those guards as
+    // "always true". `primaryAction` is pulled from the compose-only branch
+    // (where it carries a real type) rather than the send branch's
+    // `undefined` pin, which would collapse the intersection to `undefined`.
   } = props;
   const paletteSections = useMemo(() => {
     const sections = palette ?? defaultPalette;
@@ -9812,13 +9857,36 @@ function BlockKitchen(props) {
   }, [palette, disabledBlockTypes]);
   const variantById = useMemo(() => buildVariantById(paletteSections), [paletteSections]);
   const allowedSurfaces = allowedSurfacesProp && allowedSurfacesProp.length > 0 ? allowedSurfacesProp : ["message"];
-  const seededBlocks = editing?.initialTarget?.blocks ?? initialBlocks;
+  const sendEnabled = Boolean(loadChannels && loadSendAsUserStatus && onSend);
+  const editingConfig = sendEnabled ? editing : void 0;
+  const seededBlocks = editingConfig?.initialTarget?.blocks ?? initialBlocks;
   useEffect(() => {
-    if (editing?.initialTarget && initialBlocks) {
+    if (editingConfig?.initialTarget && initialBlocks) {
       console.warn(
         "[BlockKitchen] Both `initialBlocks` and `editing.initialTarget` were provided; using the target\u2019s blocks and ignoring `initialBlocks`."
       );
     }
+    const sendPropsProvided = [loadChannels, loadSendAsUserStatus, onSend].filter(Boolean).length;
+    if (sendPropsProvided > 0 && sendPropsProvided < 3) {
+      console.warn(
+        "[BlockKitchen] Partial send wiring: `loadChannels`, `loadSendAsUserStatus`, and `onSend` are all-or-nothing. The send button is hidden until all three are provided."
+      );
+    }
+    if (editing && !sendEnabled) {
+      console.warn(
+        "[BlockKitchen] `editing` requires the send integration (`loadChannels`, `loadSendAsUserStatus`, `onSend`); ignoring `editing`."
+      );
+    }
+    if (renderSendExtras && !sendEnabled) {
+      console.warn(
+        "[BlockKitchen] `renderSendExtras` extends the built-in send dialog, which requires the send integration (`loadChannels`, `loadSendAsUserStatus`, `onSend`); ignoring `renderSendExtras`."
+      );
+    }
+    if (primaryAction && sendEnabled) {
+      console.warn(
+        "[BlockKitchen] `primaryAction` is only available in compose-only mode \u2014 with the send integration wired, the built-in Send/Update flow owns the toolbar\u2019s primary action; ignoring `primaryAction`."
+      );
+    }
   }, []);
   const { blocks, addBlock, addChild, updateBlock, removeBlock, duplicateBlock, reorderBlock, moveBlock, replaceAll } = useBlockKitchenState({ initialBlocks: seededBlocks, onChange });
   const childParentById = useMemo(() => {
@@ -9836,8 +9904,8 @@ function BlockKitchen(props) {
   const [sendOpen, setSendOpen] = useState(false);
   const [updateOpen, setUpdateOpen] = useState(false);
   const [loadOpen, setLoadOpen] = useState(false);
-  const [editTarget, setEditTarget] = useState(() => editing?.initialTarget ?? null);
-  const activeEditTarget = editing ? editTarget : null;
+  const [editTarget, setEditTarget] = useState(() => editingConfig?.initialTarget ?? null);
+  const activeEditTarget = editingConfig ? editTarget : null;
   const [issuesOpen, setIssuesOpen] = useState(false);
   const [paletteOpen, setPaletteOpen] = useState(false);
   const [openBlockId, setOpenBlockId] = useState(null);
@@ -9855,6 +9923,22 @@ function BlockKitchen(props) {
     return { emoji: makeEmojiHook(byName), ...previewHooks };
   }, [customEmojis, previewHooks]);
   const validation = useBlockKitValidation(blocks, "message");
+  const validationSummary = useMemo(
+    () => ({ valid: validation.valid, errorCount: validation.total, errors: validation.errors }),
+    [validation]
+  );
+  const lastNotifiedValidationRef = useRef(null);
+  useEffect(() => {
+    if (!onValidationChange) {
+      return;
+    }
+    const key = JSON.stringify([validationSummary.valid, validationSummary.errorCount, ...validationSummary.errors]);
+    if (lastNotifiedValidationRef.current === key) {
+      return;
+    }
+    lastNotifiedValidationRef.current = key;
+    onValidationChange(validationSummary);
+  }, [validationSummary, onValidationChange]);
   const sensors = useSensors(
     useSensor(PointerSensor, { activationConstraint: { distance: 4 } }),
     useSensor(TouchSensor, { activationConstraint: { delay: 150, tolerance: 8 } }),
@@ -9958,8 +10042,14 @@ function BlockKitchen(props) {
               allowedSurfaces,
               showThemeControl: isPreviewThemeControlled ? false : showThemeControl,
               docsLink,
+              showSend: sendEnabled,
+              primaryAction: !sendEnabled && primaryAction ? {
+                label: primaryAction.label,
+                onClick: () => primaryAction.onClick({ blocks: blockPayloads, validation: validationSummary }),
+                disabled: primaryAction.disableWhenInvalid ? !validationSummary.valid : false
+              } : null,
               sendButtonLabel,
-              editingEnabled: !!editing,
+              editingEnabled: !!editingConfig,
               editBadge: activeEditTarget ? {
                 channelLabel: activeEditTarget.channelName ? `#${activeEditTarget.channelName}` : activeEditTarget.channelId,
                 ts: activeEditTarget.ts
@@ -10041,7 +10131,7 @@ function BlockKitchen(props) {
           }
         ) }),
         /* @__PURE__ */ jsx(JsonDrawer, { open: jsonOpen, onOpenChange: setJsonOpen, blocks: blockPayloads, onApply: replaceAll }),
-        /* @__PURE__ */ jsx(
+        loadChannels && loadSendAsUserStatus && onSend ? /* @__PURE__ */ jsx(
           SendDialog,
           {
             open: sendOpen,
@@ -10050,6 +10140,7 @@ function BlockKitchen(props) {
             loadChannels,
             loadSendAsUserStatus,
             onSend,
+            renderSendExtras,
             confirmSendLabel,
             errorCount: validation.total,
             onShowIssues: () => {
@@ -10057,8 +10148,8 @@ function BlockKitchen(props) {
               setIssuesOpen(true);
             }
           }
-        ),
-        activeEditTarget && editing ? /* @__PURE__ */ jsx(
+        ) : null,
+        activeEditTarget && editingConfig && loadSendAsUserStatus ? /* @__PURE__ */ jsx(
           UpdateDialog,
           {
             open: updateOpen,
@@ -10066,7 +10157,7 @@ function BlockKitchen(props) {
             target: activeEditTarget,
             blocks: blockPayloads,
             loadSendAsUserStatus,
-            onUpdate: editing.onUpdate,
+            onUpdate: editingConfig.onUpdate,
             confirmUpdateLabel,
             errorCount: validation.total,
             onShowIssues: () => {
@@ -10075,13 +10166,13 @@ function BlockKitchen(props) {
             }
           }
         ) : null,
-        editing ? /* @__PURE__ */ jsx(
+        editingConfig && loadChannels ? /* @__PURE__ */ jsx(
           LoadMessageDialog,
           {
             open: loadOpen,
             onOpenChange: setLoadOpen,
-            onLoadMessage: editing.onLoadMessage,
-            loadRecentMessages: editing.loadRecentMessages,
+            onLoadMessage: editingConfig.onLoadMessage,
+            loadRecentMessages: editingConfig.loadRecentMessages,
             loadChannels,
             onLoaded: (result) => {
               replaceAll(result.blocks);
@@ -10275,6 +10366,6 @@ function fromBase64Url(b64url) {
   return b64 + "=".repeat(padLen);
 }
 
-export { BlockKitchen, TemplatePicker, decodeBlocksFromString, defaultPalette, encodeBlocksToString, extraAlertVariant, legacyInputVariants, toSlackBlocks };
+export { BlockKitchen, SendDialog, SlackSignInButton, TemplatePicker, decodeBlocksFromString, defaultPalette, encodeBlocksToString, extraAlertVariant, legacyInputVariants, toSlackBlocks, useSlackSignIn };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map