@tightknitai/block-kitchen 0.9.9 → 0.10.0

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, _ as SupportedBlock, k as ChannelOption, W as SendAsUserStatus, Y as SendPayload, X as SendExtrasContext, a6 as Template, R as PreviewSurface, S as PreviewTheme } from './palette-C8sPJuXx.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, F as FeedbackButtonSubobject, v as FeedbackButtonsElement, H as HeaderLevel, I as IconButtonElement, w as IconButtonIcon, x as InputBlock, L as LoadMessageInput, y as LoadResult, z as LoadedMessage, G as LoadingConfig, M as MarkdownBlock, P as PaletteSection, J as PaletteVariant, K as PieChart, N as PieChartSegment, O as PlanBlock, Q as PreviewHooks, T as PrimaryActionConfig, U as PrimaryActionContext, V as RecentMessage, Z as SendResult, $ as SupportedBlockType, a0 as SupportedHeaderBlock, a1 as TableBlock, a2 as TableCell, a3 as TableColumnSetting, a4 as TaskCardBlock, a5 as TaskCardStatus, a7 as UpdatePayload, a8 as UpdateResult, a9 as UrlSourceElement, aa as ValidationSummary, ab as VideoBlock, ad as defaultPalette, ae as extraAlertVariant, af as legacyInputVariants } from './palette-C8sPJuXx.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, _ as SupportedBlock, k as ChannelOption, W as SendAsUserStatus, Y as SendPayload, X as SendExtrasContext, a6 as Template, R as PreviewSurface, S as PreviewTheme } from './palette-C8sPJuXx.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, F as FeedbackButtonSubobject, v as FeedbackButtonsElement, H as HeaderLevel, I as IconButtonElement, w as IconButtonIcon, x as InputBlock, L as LoadMessageInput, y as LoadResult, z as LoadedMessage, G as LoadingConfig, M as MarkdownBlock, P as PaletteSection, J as PaletteVariant, K as PieChart, N as PieChartSegment, O as PlanBlock, Q as PreviewHooks, T as PrimaryActionConfig, U as PrimaryActionContext, V as RecentMessage, Z as SendResult, $ as SupportedBlockType, a0 as SupportedHeaderBlock, a1 as TableBlock, a2 as TableCell, a3 as TableColumnSetting, a4 as TaskCardBlock, a5 as TaskCardStatus, a7 as UpdatePayload, a8 as UpdateResult, a9 as UrlSourceElement, aa as ValidationSummary, ab as VideoBlock, ad as defaultPalette, ae as extraAlertVariant, af as legacyInputVariants } from './palette-C8sPJuXx.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
@@ -2225,6 +2226,29 @@ function useBlockKitchenState({
     replaceAll
   };
 }
+function useDevWarning(condition, message) {
+  const warnedRef = useRef(false);
+  useEffect(() => {
+    if (condition && !warnedRef.current) {
+      warnedRef.current = true;
+      console.warn(message);
+    }
+  }, [condition, message]);
+}
+function useNotifyOnChange(value, toKey, callback) {
+  const lastNotifiedRef = useRef(null);
+  useEffect(() => {
+    if (!callback) {
+      return;
+    }
+    const key = toKey(value);
+    if (lastNotifiedRef.current === key) {
+      return;
+    }
+    lastNotifiedRef.current = key;
+    callback(value);
+  }, [value, toKey, callback]);
+}
 
 // src/lib/brand-theme.ts
 var TOKEN_TO_CSS_VAR = {
@@ -3022,7 +3046,7 @@ function LoadMessageDialog({
     loadRecentMessagesRef.current = loadRecentMessages;
     loadChannelsRef.current = loadChannels;
   });
-  const hasRecent = !!loadRecentMessages;
+  const hasRecent = !!loadRecentMessages && !!loadChannels;
   useEffect(() => {
     if (!open) {
       return;
@@ -3033,7 +3057,10 @@ function LoadMessageDialog({
     setRecent(null);
     setRecentError(null);
     setSelectedRecent(null);
-    if (!loadRecentMessagesRef.current) {
+  }, [open]);
+  useEffect(() => {
+    const load = loadChannelsRef.current;
+    if (!open || !hasRecent || !load) {
       setChannels([]);
       setChannelsError(null);
       return;
@@ -3041,7 +3068,7 @@ function LoadMessageDialog({
     setChannels(null);
     setChannelsError(null);
     let cancelled = false;
-    loadChannelsRef.current().then((list) => {
+    load().then((list) => {
       if (!cancelled) {
         setChannels(list);
       }
@@ -3053,7 +3080,7 @@ function LoadMessageDialog({
     return () => {
       cancelled = true;
     };
-  }, [open]);
+  }, [open, hasRecent]);
   useEffect(() => {
     if (!open || !loadRecentMessagesRef.current || !channelId) {
       return;
@@ -3532,6 +3559,7 @@ function SendDialog({
   loadChannels,
   loadSendAsUserStatus,
   onSend,
+  renderSendExtras,
   confirmSendLabel = "Send",
   errorCount,
   onShowIssues
@@ -3541,6 +3569,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 +3587,7 @@ function SendDialog({
     setChannelsError(null);
     setChannelId("");
     setSendAs("bot");
+    setExtrasState({});
     let cancelled = false;
     loadChannelsRef.current().then((list) => {
       if (cancelled) {
@@ -3582,7 +3615,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 +3685,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,8 +9437,11 @@ function Toolbar2({
   showThemeControl = true,
   docsLink,
   errorCount,
+  showSend = true,
+  primaryAction,
   sendButtonLabel = "Review & send",
-  editingEnabled = false,
+  loadEnabled = false,
+  updateEnabled = false,
   editBadge,
   onOpenLoad,
   onOpenUpdate,
@@ -9416,7 +9461,7 @@ function Toolbar2({
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center justify-between gap-x-2 gap-y-1 border-b bg-background px-2 py-1.5 sm:px-3 sm:py-2", children: [
       /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 flex-1 items-center gap-1 sm:gap-2", children: [
-        editingEnabled ? /* @__PURE__ */ jsxs(Button, { type: "button", size: "sm", onClick: onOpenLoad, "aria-label": loadButtonLabel, children: [
+        loadEnabled ? /* @__PURE__ */ jsxs(Button, { type: "button", size: "sm", onClick: onOpenLoad, "aria-label": loadButtonLabel, children: [
           /* @__PURE__ */ jsx(MailSearch, { className: "h-3.5 w-3.5" }),
           /* @__PURE__ */ jsx("span", { className: "hidden md:inline", children: loadButtonLabel })
         ] }) : null,
@@ -9529,9 +9574,29 @@ function Toolbar2({
           /* @__PURE__ */ jsx(Code2, { className: "h-3.5 w-3.5" }),
           /* @__PURE__ */ jsx("span", { className: "hidden md:inline", children: "View JSON" })
         ] }),
-        editBadge ? (
-          // A message is loaded: split button. Main action updates it in
-          // place; the menu also offers posting the blocks as a new message.
+        !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 && updateEnabled ? (
+          // A message is loaded and update-in-place is wired: split button.
+          // Main action updates it in place; the menu also offers posting
+          // the blocks as a new message. Without `updateEnabled` (loading
+          // configured but no `editing.onUpdate`), the plain send button
+          // below stays — the loaded message can only be posted as new.
           /* @__PURE__ */ jsxs("div", { className: "flex items-stretch", children: [
             /* @__PURE__ */ jsxs(
               Button,
@@ -9604,7 +9669,7 @@ function Toolbar2({
         ] })
       ] })
     ] }),
-    editingEnabled && editBadge ? /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-x-3 gap-y-1 border-b bg-muted px-2 py-2 text-foreground sm:px-3", children: [
+    loadEnabled && editBadge ? /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-x-3 gap-y-1 border-b bg-muted px-2 py-2 text-foreground sm:px-3", children: [
       /* @__PURE__ */ jsx(Pencil, { className: "h-4 w-4 shrink-0 text-primary" }),
       /* @__PURE__ */ jsxs("span", { className: "min-w-0 flex-1 text-sm", children: [
         "References an existing message in ",
@@ -9767,17 +9832,34 @@ function UpdateDialog({
     ] })
   ] }) });
 }
+function toLoadedMessage({
+  ok: _ok,
+  blocks: _blocks,
+  ...loadedMessage
+}) {
+  return loadedMessage;
+}
+function loadedMessageKey(message) {
+  return message ? JSON.stringify(message) : null;
+}
+function validationSummaryKey(summary) {
+  return JSON.stringify([summary.valid, summary.errorCount, ...summary.errors]);
+}
 function BlockKitchen(props) {
   const {
     workspaceName,
     initialBlocks,
     onChange,
+    onValidationChange,
     previewHooks,
     customEmojis,
     loadChannels,
     loadSendAsUserStatus,
     onSend,
-    editing,
+    renderSendExtras,
+    loading,
+    onUpdate: onUpdateProp,
+    primaryAction,
     loadButtonLabel,
     updateButtonLabel,
     confirmUpdateLabel,
@@ -9794,6 +9876,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,14 +9901,40 @@ 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;
-  useEffect(() => {
-    if (editing?.initialTarget && initialBlocks) {
-      console.warn(
-        "[BlockKitchen] Both `initialBlocks` and `editing.initialTarget` were provided; using the target\u2019s blocks and ignoring `initialBlocks`."
-      );
-    }
-  }, []);
+  const sendEnabled = Boolean(loadChannels && loadSendAsUserStatus && onSend);
+  const loadEnabled = Boolean(loading);
+  const recentChannelSource = loading?.loadChannels ?? (sendEnabled ? loadChannels : void 0);
+  const onUpdate = sendEnabled ? onUpdateProp : void 0;
+  const seededBlocks = loading?.initialTarget?.blocks ?? initialBlocks;
+  const sendPropsProvided = [loadChannels, loadSendAsUserStatus, onSend].filter(Boolean).length;
+  useDevWarning(
+    Boolean(loading?.initialTarget && initialBlocks),
+    "[BlockKitchen] Both `initialBlocks` and an `initialTarget` were provided; using the target\u2019s blocks and ignoring `initialBlocks`."
+  );
+  useDevWarning(
+    sendPropsProvided > 0 && sendPropsProvided < 3,
+    "[BlockKitchen] Partial send wiring: `loadChannels`, `loadSendAsUserStatus`, and `onSend` are all-or-nothing. The send button is hidden until all three are provided."
+  );
+  useDevWarning(
+    Boolean(onUpdateProp && !sendEnabled),
+    "[BlockKitchen] `onUpdate` requires the send integration (`loadChannels`, `loadSendAsUserStatus`, `onSend`); ignoring `onUpdate`. To load an existing message without the send integration, use the `loading` prop instead."
+  );
+  useDevWarning(
+    Boolean(sendEnabled && onUpdateProp && !loading),
+    "[BlockKitchen] `onUpdate` needs a loaded message, but no load source is configured \u2014 provide the `loading` prop. The update flow is unreachable."
+  );
+  useDevWarning(
+    Boolean(loading?.loadRecentMessages && !recentChannelSource),
+    "[BlockKitchen] `loading.loadRecentMessages` needs a channel list to scope its lookup \u2014 provide `loading.loadChannels` (compose-only mode has no send integration to reuse). Hiding the recent-messages picker."
+  );
+  useDevWarning(
+    Boolean(renderSendExtras && !sendEnabled),
+    "[BlockKitchen] `renderSendExtras` extends the built-in send dialog, which requires the send integration (`loadChannels`, `loadSendAsUserStatus`, `onSend`); ignoring `renderSendExtras`."
+  );
+  useDevWarning(
+    Boolean(primaryAction && sendEnabled),
+    "[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(() => {
     const map = /* @__PURE__ */ new Map();
@@ -9836,8 +9951,11 @@ 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(
+    () => loading?.initialTarget ? toLoadedMessage(loading.initialTarget) : null
+  );
+  const activeEditTarget = loadEnabled ? editTarget : null;
+  useNotifyOnChange(activeEditTarget, loadedMessageKey, loading?.onLoadedMessageChange);
   const [issuesOpen, setIssuesOpen] = useState(false);
   const [paletteOpen, setPaletteOpen] = useState(false);
   const [openBlockId, setOpenBlockId] = useState(null);
@@ -9855,6 +9973,11 @@ 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]
+  );
+  useNotifyOnChange(validationSummary, validationSummaryKey, onValidationChange);
   const sensors = useSensors(
     useSensor(PointerSensor, { activationConstraint: { distance: 4 } }),
     useSensor(TouchSensor, { activationConstraint: { delay: 150, tolerance: 8 } }),
@@ -9958,8 +10081,19 @@ function BlockKitchen(props) {
               allowedSurfaces,
               showThemeControl: isPreviewThemeControlled ? false : showThemeControl,
               docsLink,
+              showSend: sendEnabled,
+              primaryAction: !sendEnabled && primaryAction ? {
+                label: primaryAction.label,
+                onClick: () => primaryAction.onClick({
+                  blocks: blockPayloads,
+                  validation: validationSummary,
+                  loadedMessage: activeEditTarget
+                }),
+                disabled: primaryAction.disableWhenInvalid ? !validationSummary.valid : false
+              } : null,
               sendButtonLabel,
-              editingEnabled: !!editing,
+              loadEnabled,
+              updateEnabled: Boolean(onUpdate),
               editBadge: activeEditTarget ? {
                 channelLabel: activeEditTarget.channelName ? `#${activeEditTarget.channelName}` : activeEditTarget.channelId,
                 ts: activeEditTarget.ts
@@ -9967,9 +10101,13 @@ function BlockKitchen(props) {
               onOpenLoad: () => setLoadOpen(true),
               onOpenUpdate: () => setUpdateOpen(true),
               onExitEdit: () => {
+                if (sendEnabled) {
+                  setEditTarget(null);
+                  replaceAll([]);
+                  setLoadOpen(true);
+                  return;
+                }
                 setEditTarget(null);
-                replaceAll([]);
-                setLoadOpen(true);
               },
               loadButtonLabel,
               updateButtonLabel
@@ -10041,7 +10179,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 +10188,7 @@ function BlockKitchen(props) {
             loadChannels,
             loadSendAsUserStatus,
             onSend,
+            renderSendExtras,
             confirmSendLabel,
             errorCount: validation.total,
             onShowIssues: () => {
@@ -10057,8 +10196,8 @@ function BlockKitchen(props) {
               setIssuesOpen(true);
             }
           }
-        ),
-        activeEditTarget && editing ? /* @__PURE__ */ jsx(
+        ) : null,
+        activeEditTarget && onUpdate && loadSendAsUserStatus ? /* @__PURE__ */ jsx(
           UpdateDialog,
           {
             open: updateOpen,
@@ -10066,7 +10205,7 @@ function BlockKitchen(props) {
             target: activeEditTarget,
             blocks: blockPayloads,
             loadSendAsUserStatus,
-            onUpdate: editing.onUpdate,
+            onUpdate,
             confirmUpdateLabel,
             errorCount: validation.total,
             onShowIssues: () => {
@@ -10075,25 +10214,17 @@ function BlockKitchen(props) {
             }
           }
         ) : null,
-        editing ? /* @__PURE__ */ jsx(
+        loading ? /* @__PURE__ */ jsx(
           LoadMessageDialog,
           {
             open: loadOpen,
             onOpenChange: setLoadOpen,
-            onLoadMessage: editing.onLoadMessage,
-            loadRecentMessages: editing.loadRecentMessages,
-            loadChannels,
+            onLoadMessage: loading.onLoadMessage,
+            loadRecentMessages: loading.loadRecentMessages,
+            loadChannels: recentChannelSource,
             onLoaded: (result) => {
               replaceAll(result.blocks);
-              setEditTarget({
-                channelId: result.channelId,
-                channelName: result.channelName,
-                ts: result.ts,
-                editableVia: result.editableVia,
-                workspaceName: result.workspaceName,
-                username: result.username,
-                iconUrl: result.iconUrl
-              });
+              setEditTarget(toLoadedMessage(result));
               setLoadOpen(false);
             },
             onOpenAsNew: (loadedBlocks) => {
@@ -10275,6 +10406,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