@tightknitai/block-kitchen 0.9.10 → 0.10.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 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';
+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';
 

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 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';
+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';
 

package/dist/index.js

@@ -2226,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 = {
@@ -3023,7 +3046,7 @@ function LoadMessageDialog({
     loadRecentMessagesRef.current = loadRecentMessages;
     loadChannelsRef.current = loadChannels;
   });
-  const hasRecent = !!loadRecentMessages;
+  const hasRecent = !!loadRecentMessages && !!loadChannels;
   useEffect(() => {
     if (!open) {
       return;
@@ -3034,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;
@@ -3042,7 +3068,7 @@ function LoadMessageDialog({
     setChannels(null);
     setChannelsError(null);
     let cancelled = false;
-    loadChannelsRef.current().then((list) => {
+    load().then((list) => {
       if (!cancelled) {
         setChannels(list);
       }
@@ -3054,7 +3080,7 @@ function LoadMessageDialog({
     return () => {
       cancelled = true;
     };
-  }, [open]);
+  }, [open, hasRecent]);
   useEffect(() => {
     if (!open || !loadRecentMessagesRef.current || !channelId) {
       return;
@@ -9414,7 +9440,8 @@ function Toolbar2({
   showSend = true,
   primaryAction,
   sendButtonLabel = "Review & send",
-  editingEnabled = false,
+  loadEnabled = false,
+  updateEnabled = false,
   editBadge,
   onOpenLoad,
   onOpenUpdate,
@@ -9434,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,
@@ -9564,9 +9591,12 @@ function Toolbar2({
               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.
+        ) : 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,
@@ -9639,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 ",
@@ -9802,6 +9832,19 @@ 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,
@@ -9814,7 +9857,8 @@ function BlockKitchen(props) {
     loadSendAsUserStatus,
     onSend,
     renderSendExtras,
-    editing,
+    loading,
+    onUpdate: onUpdateProp,
     primaryAction,
     loadButtonLabel,
     updateButtonLabel,
@@ -9858,36 +9902,39 @@ function BlockKitchen(props) {
   const variantById = useMemo(() => buildVariantById(paletteSections), [paletteSections]);
   const allowedSurfaces = allowedSurfacesProp && allowedSurfacesProp.length > 0 ? allowedSurfacesProp : ["message"];
   const sendEnabled = Boolean(loadChannels && loadSendAsUserStatus && onSend);
-  const editingConfig = sendEnabled ? editing : void 0;
-  const seededBlocks = editingConfig?.initialTarget?.blocks ?? initialBlocks;
-  useEffect(() => {
-    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 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();
@@ -9904,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(() => editingConfig?.initialTarget ?? null);
-  const activeEditTarget = editingConfig ? 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);
@@ -9927,18 +9977,7 @@ function BlockKitchen(props) {
     () => ({ 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]);
+  useNotifyOnChange(validationSummary, validationSummaryKey, onValidationChange);
   const sensors = useSensors(
     useSensor(PointerSensor, { activationConstraint: { distance: 4 } }),
     useSensor(TouchSensor, { activationConstraint: { delay: 150, tolerance: 8 } }),
@@ -10045,11 +10084,16 @@ function BlockKitchen(props) {
               showSend: sendEnabled,
               primaryAction: !sendEnabled && primaryAction ? {
                 label: primaryAction.label,
-                onClick: () => primaryAction.onClick({ blocks: blockPayloads, validation: validationSummary }),
+                onClick: () => primaryAction.onClick({
+                  blocks: blockPayloads,
+                  validation: validationSummary,
+                  loadedMessage: activeEditTarget
+                }),
                 disabled: primaryAction.disableWhenInvalid ? !validationSummary.valid : false
               } : null,
               sendButtonLabel,
-              editingEnabled: !!editingConfig,
+              loadEnabled,
+              updateEnabled: Boolean(onUpdate),
               editBadge: activeEditTarget ? {
                 channelLabel: activeEditTarget.channelName ? `#${activeEditTarget.channelName}` : activeEditTarget.channelId,
                 ts: activeEditTarget.ts
@@ -10057,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
@@ -10149,7 +10197,7 @@ function BlockKitchen(props) {
             }
           }
         ) : null,
-        activeEditTarget && editingConfig && loadSendAsUserStatus ? /* @__PURE__ */ jsx(
+        activeEditTarget && onUpdate && loadSendAsUserStatus ? /* @__PURE__ */ jsx(
           UpdateDialog,
           {
             open: updateOpen,
@@ -10157,7 +10205,7 @@ function BlockKitchen(props) {
             target: activeEditTarget,
             blocks: blockPayloads,
             loadSendAsUserStatus,
-            onUpdate: editingConfig.onUpdate,
+            onUpdate,
             confirmUpdateLabel,
             errorCount: validation.total,
             onShowIssues: () => {
@@ -10166,25 +10214,17 @@ function BlockKitchen(props) {
             }
           }
         ) : null,
-        editingConfig && loadChannels ? /* @__PURE__ */ jsx(
+        loading ? /* @__PURE__ */ jsx(
           LoadMessageDialog,
           {
             open: loadOpen,
             onOpenChange: setLoadOpen,
-            onLoadMessage: editingConfig.onLoadMessage,
-            loadRecentMessages: editingConfig.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) => {