@tightknitai/block-kitchen 0.10.23 → 0.10.24

package/README.md

@@ -139,6 +139,7 @@ Given no height to work with — a plain `<div>` in ordinary document flow — i
 | `confirmUpdateLabel` | `string` | no | Label for the update dialog's final confirm button. Defaults to `'Update message'` (shows `'Updating…'` while in flight). |
 | `previewHooks` | `PreviewHooks` | no | Hooks forwarded to `slack-blocks-to-jsx`'s `<Message>` for resolving user / channel / emoji directives. |
 | `blockActions` | `BlockAction[]` | no | Host buttons added to every block's action toolbar, before Edit / Duplicate / Delete. Each is `{ id, label, icon, onSelect }`, and `onSelect` receives the block's `{ index, childIndex }`. See [Adding your own block actions](#adding-your-own-block-actions-blockactions). |
+| `renderBlockAdornment` | `(position: BlockPosition) => ReactNode` | no | Host content shown beside every block, at its right edge, all the time (unlike `blockActions`, which show on hover), e.g. a count of comments on the block. Return `null` for a block with nothing to show. See [Adding your own block actions](#adding-your-own-block-actions-blockactions). |
 | `customEmojis` | `CustomEmoji[]` | no | Workspace custom emoji (`{ name, url, alias }`) the preview resolves. Entries with a `url` render `:name:` as the workspace image; alias entries (`url: null`) fall back to their target emoji. Render-only — never serialized into the emitted Block Kit JSON. A caller-supplied `previewHooks.emoji` takes precedence. |
 | `mentions` | `{ searchUsers, getUserName?, searchChannels?, getChannelName? }` | no | Opt-in rich-text mentions. `@` and the Mention button search users; when `searchChannels` is provided, `#` and the Channel button search channels. Picks serialize as Slack `user` / `channel` elements. See [Mentions](#mentions-opt-in). |
 | `palette` | `PaletteSection[]` | no | The left-hand palette of draggable variants. Defaults to `defaultPalette`. Spread it to filter, reorder, or add your own pre-configured variants — see [Customizing the palette](#customizing-the-palette). |
@@ -467,6 +468,19 @@ top-level block). Map it onto the blocks `onChange` last reported; builder
 ids never leave the package. An `svg` icon is sized to match the built-in
 ones.
 
+For something that should show all the time, like a count of comments on
+each block, pass `renderBlockAdornment`. It's called with the same position
+and renders beside the block, at its right edge; return `null` for a block
+with nothing to show:
+
+```tsx
+<BlockKitchen
+  renderBlockAdornment={({ index, childIndex }) =>
+    childIndex === null && counts[index] ? <CommentCount count={counts[index]} /> : null
+  }
+/>
+```
+
 Each block's row also carries `data-bk-block-index` (plus
 `data-bk-child-index` inside a container), so the host can find a block on
 the canvas, for example to scroll to it or highlight it:

package/dist/helpers.d.cts

@@ -1,5 +1,5 @@
-import { S as SupportedBlock } from './palette-DFTL0Han.cjs';
-export { aa as SupportedBlockType } from './palette-DFTL0Han.cjs';
+import { S as SupportedBlock } from './palette-Bup6i-9c.cjs';
+export { aa as SupportedBlockType } from './palette-Bup6i-9c.cjs';
 import 'react';
 import 'slack-web-api-client';
 

package/dist/helpers.d.ts

@@ -1,5 +1,5 @@
-import { S as SupportedBlock } from './palette-DFTL0Han.js';
-export { aa as SupportedBlockType } from './palette-DFTL0Han.js';
+import { S as SupportedBlock } from './palette-Bup6i-9c.js';
+export { aa as SupportedBlockType } from './palette-Bup6i-9c.js';
 import 'react';
 import 'slack-web-api-client';
 

package/dist/index.cjs

@@ -10501,7 +10501,8 @@ function BlockRow({
   onReorder,
   isPaletteDrag = false,
   position,
-  blockActions
+  blockActions,
+  renderBlockAdornment
 }) {
   const { attributes, listeners, setNodeRef, transform, transition, isDragging, isOver } = sortable.useSortable({
     id: builderBlock.id
@@ -10516,6 +10517,63 @@ function BlockRow({
   const [inlineEditing, setInlineEditing] = React.useState(false);
   const showDropIndicator = isPaletteDrag && isOver;
   const preview = /* @__PURE__ */ jsxRuntime.jsx(SlackBlockPreview, { block: builderBlock.block, hooks: previewHooks, theme: previewTheme });
+  const body = isRichText && inlineEditing ? /* @__PURE__ */ jsxRuntime.jsx(
+    RichTextInlineEditor,
+    {
+      block: builderBlock.block,
+      onSave: (next) => {
+        onUpdate(builderBlock.id, next);
+        setInlineEditing(false);
+      },
+      onCancel: () => setInlineEditing(false)
+    }
+  ) : isRichText ? /* @__PURE__ */ jsxRuntime.jsx(
+    "button",
+    {
+      type: "button",
+      "aria-label": "Edit block",
+      onClick: () => setInlineEditing(true),
+      ...attributes,
+      ...listeners,
+      className: cn(
+        "block w-full cursor-grab rounded-sm border-0 bg-transparent p-0 text-left transition-shadow hover:shadow-md focus-visible:ring-1 focus-visible:ring-ring active:cursor-grabbing",
+        hasErrors ? "ring-1 ring-destructive/60 hover:ring-destructive" : "hover:ring-1 hover:ring-border"
+      ),
+      children: preview
+    }
+  ) : /* @__PURE__ */ jsxRuntime.jsxs(Popover, { open: isOpen, onOpenChange, children: [
+    /* @__PURE__ */ jsxRuntime.jsx(PopoverTrigger, { asChild: true, children: /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        role: "button",
+        tabIndex: 0,
+        "aria-label": "Edit block",
+        ...sortableA11yAttrs,
+        ...listeners,
+        onKeyDown: (e) => {
+          if (e.key === "Enter" || e.key === " ") {
+            e.preventDefault();
+            onOpenChange?.(!isOpen);
+          }
+        },
+        className: cn(
+          "block w-full cursor-grab rounded-sm transition-shadow hover:shadow-md focus-visible:ring-1 focus-visible:ring-ring active:cursor-grabbing",
+          hasErrors ? "ring-1 ring-destructive/60 hover:ring-destructive" : "hover:ring-1 hover:ring-border"
+        ),
+        children: preview
+      }
+    ) }),
+    /* @__PURE__ */ jsxRuntime.jsx(PopoverContent, { className: "w-[min(32rem,calc(100vw-1.5rem))] sm:w-[32rem]", align: "start", children: /* @__PURE__ */ jsxRuntime.jsx(
+      BlockEditor,
+      {
+        block: builderBlock.block,
+        errors,
+        onChange: (next) => onUpdate(builderBlock.id, next),
+        onDone: () => onOpenChange?.(false)
+      }
+    ) })
+  ] });
+  const adornment = position && renderBlockAdornment?.(position);
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
@@ -10534,62 +10592,10 @@ function BlockRow({
           }
         ) : null,
         /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "relative w-full", children: [
-          isRichText && inlineEditing ? /* @__PURE__ */ jsxRuntime.jsx(
-            RichTextInlineEditor,
-            {
-              block: builderBlock.block,
-              onSave: (next) => {
-                onUpdate(builderBlock.id, next);
-                setInlineEditing(false);
-              },
-              onCancel: () => setInlineEditing(false)
-            }
-          ) : isRichText ? /* @__PURE__ */ jsxRuntime.jsx(
-            "button",
-            {
-              type: "button",
-              "aria-label": "Edit block",
-              onClick: () => setInlineEditing(true),
-              ...attributes,
-              ...listeners,
-              className: cn(
-                "block w-full cursor-grab rounded-sm border-0 bg-transparent p-0 text-left transition-shadow hover:shadow-md focus-visible:ring-1 focus-visible:ring-ring active:cursor-grabbing",
-                hasErrors ? "ring-1 ring-destructive/60 hover:ring-destructive" : "hover:ring-1 hover:ring-border"
-              ),
-              children: preview
-            }
-          ) : /* @__PURE__ */ jsxRuntime.jsxs(Popover, { open: isOpen, onOpenChange, children: [
-            /* @__PURE__ */ jsxRuntime.jsx(PopoverTrigger, { asChild: true, children: /* @__PURE__ */ jsxRuntime.jsx(
-              "div",
-              {
-                role: "button",
-                tabIndex: 0,
-                "aria-label": "Edit block",
-                ...sortableA11yAttrs,
-                ...listeners,
-                onKeyDown: (e) => {
-                  if (e.key === "Enter" || e.key === " ") {
-                    e.preventDefault();
-                    onOpenChange?.(!isOpen);
-                  }
-                },
-                className: cn(
-                  "block w-full cursor-grab rounded-sm transition-shadow hover:shadow-md focus-visible:ring-1 focus-visible:ring-ring active:cursor-grabbing",
-                  hasErrors ? "ring-1 ring-destructive/60 hover:ring-destructive" : "hover:ring-1 hover:ring-border"
-                ),
-                children: preview
-              }
-            ) }),
-            /* @__PURE__ */ jsxRuntime.jsx(PopoverContent, { className: "w-[min(32rem,calc(100vw-1.5rem))] sm:w-[32rem]", align: "start", children: /* @__PURE__ */ jsxRuntime.jsx(
-              BlockEditor,
-              {
-                block: builderBlock.block,
-                errors,
-                onChange: (next) => onUpdate(builderBlock.id, next),
-                onDone: () => onOpenChange?.(false)
-              }
-            ) })
-          ] }),
+          renderBlockAdornment ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-start gap-2", children: [
+            /* @__PURE__ */ jsxRuntime.jsx("div", { className: "min-w-0 flex-1", children: body }),
+            adornment != null && adornment !== false ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "shrink-0", children: adornment }) : null
+          ] }) : body,
           /* @__PURE__ */ jsxRuntime.jsx("span", { className: "-translate-x-1/2 pointer-events-none absolute bottom-full left-1/2 z-10 hidden bg-background px-1.5 text-[11px] text-muted-foreground opacity-0 transition-opacity group-hover:opacity-100 md:block", children: BLOCK_TYPE_LABELS[builderBlock.block.type] }),
           /* @__PURE__ */ jsxRuntime.jsxs(
             "div",
@@ -10801,7 +10807,8 @@ function ContainerRow({
   index,
   total,
   isPaletteDrag = false,
-  blockActions
+  blockActions,
+  renderBlockAdornment
 }) {
   const { id } = builderBlock;
   const block = builderBlock.block;
@@ -10815,105 +10822,111 @@ function ContainerRow({
   const style = { transform: utilities.CSS.Transform.toString(transform), transition };
   const icon = block.icon && "image_url" in block.icon ? block.icon.image_url : void 0;
   const position = typeof index === "number" ? { index, childIndex: null } : void 0;
-  return /* @__PURE__ */ jsxRuntime.jsxs(
+  const adornment = position && renderBlockAdornment?.(position);
+  const card = /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
-      ref: setNodeRef,
-      style,
-      "data-bk-block-index": index,
-      className: cn("group/container relative mb-2 last:mb-0 hover:z-10", isDragging && "opacity-40"),
+      className: cn(
+        "overflow-hidden rounded-md border bg-card transition-shadow",
+        hasErrors ? "border-destructive/60" : "border-border"
+      ),
       children: [
-        /* @__PURE__ */ jsxRuntime.jsxs(
+        /* @__PURE__ */ jsxRuntime.jsxs(Popover, { open: isOpen, onOpenChange: (open) => onOpenBlockChange?.(open ? id : null), children: [
+          /* @__PURE__ */ jsxRuntime.jsx(PopoverTrigger, { asChild: true, children: /* @__PURE__ */ jsxRuntime.jsxs(
+            "div",
+            {
+              role: "button",
+              tabIndex: 0,
+              "aria-label": "Edit container",
+              ...sortableA11yAttrs,
+              ...listeners,
+              onKeyDown: (e) => {
+                if (e.key === "Enter" || e.key === " ") {
+                  e.preventDefault();
+                  onOpenBlockChange?.(!isOpen ? id : null);
+                }
+              },
+              className: "flex w-full cursor-grab items-center gap-2 border-b bg-muted/40 px-3 py-2 text-left transition-colors hover:bg-muted active:cursor-grabbing",
+              children: [
+                icon ? /* @__PURE__ */ jsxRuntime.jsx("img", { src: icon, alt: "", "aria-hidden": "true", className: "h-5 w-5 shrink-0 rounded object-cover" }) : null,
+                /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 flex-col", children: [
+                  /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate text-xs font-semibold text-foreground", children: containerTitleText(block) || "Container" }),
+                  block.subtitle?.text ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate text-[11px] text-muted-foreground", children: block.subtitle.text }) : null
+                ] }),
+                /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ml-auto shrink-0 text-[10px] font-medium uppercase tracking-wide text-muted-foreground", children: "Container" })
+              ]
+            }
+          ) }),
+          /* @__PURE__ */ jsxRuntime.jsx(PopoverContent, { className: "w-[min(32rem,calc(100vw-1.5rem))] sm:w-[32rem]", align: "start", children: /* @__PURE__ */ jsxRuntime.jsx(
+            BlockEditor,
+            {
+              block,
+              errors,
+              onChange: (next) => onUpdate(id, next),
+              onDone: () => onOpenBlockChange?.(null)
+            }
+          ) })
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx(
           "div",
           {
+            ref: setBodyRef,
             className: cn(
-              "overflow-hidden rounded-md border bg-card transition-shadow",
-              hasErrors ? "border-destructive/60" : "border-border"
+              "flex flex-col gap-2 p-3 transition-colors",
+              isPaletteDrag && "outline-2 -outline-offset-2 outline-dashed outline-primary/40",
+              isPaletteDrag && isBodyOver && "bg-primary/5"
             ),
-            children: [
-              /* @__PURE__ */ jsxRuntime.jsxs(Popover, { open: isOpen, onOpenChange: (open) => onOpenBlockChange?.(open ? id : null), children: [
-                /* @__PURE__ */ jsxRuntime.jsx(PopoverTrigger, { asChild: true, children: /* @__PURE__ */ jsxRuntime.jsxs(
-                  "div",
-                  {
-                    role: "button",
-                    tabIndex: 0,
-                    "aria-label": "Edit container",
-                    ...sortableA11yAttrs,
-                    ...listeners,
-                    onKeyDown: (e) => {
-                      if (e.key === "Enter" || e.key === " ") {
-                        e.preventDefault();
-                        onOpenBlockChange?.(!isOpen ? id : null);
-                      }
-                    },
-                    className: "flex w-full cursor-grab items-center gap-2 border-b bg-muted/40 px-3 py-2 text-left transition-colors hover:bg-muted active:cursor-grabbing",
-                    children: [
-                      icon ? /* @__PURE__ */ jsxRuntime.jsx("img", { src: icon, alt: "", "aria-hidden": "true", className: "h-5 w-5 shrink-0 rounded object-cover" }) : null,
-                      /* @__PURE__ */ jsxRuntime.jsxs("span", { className: "flex min-w-0 flex-col", children: [
-                        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate text-xs font-semibold text-foreground", children: containerTitleText(block) || "Container" }),
-                        block.subtitle?.text ? /* @__PURE__ */ jsxRuntime.jsx("span", { className: "truncate text-[11px] text-muted-foreground", children: block.subtitle.text }) : null
-                      ] }),
-                      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ml-auto shrink-0 text-[10px] font-medium uppercase tracking-wide text-muted-foreground", children: "Container" })
-                    ]
-                  }
-                ) }),
-                /* @__PURE__ */ jsxRuntime.jsx(PopoverContent, { className: "w-[min(32rem,calc(100vw-1.5rem))] sm:w-[32rem]", align: "start", children: /* @__PURE__ */ jsxRuntime.jsx(
-                  BlockEditor,
-                  {
-                    block,
-                    errors,
-                    onChange: (next) => onUpdate(id, next),
-                    onDone: () => onOpenBlockChange?.(null)
-                  }
-                ) })
-              ] }),
-              /* @__PURE__ */ jsxRuntime.jsx(
-                "div",
+            children: children.length === 0 ? /* @__PURE__ */ jsxRuntime.jsx(
+              "div",
+              {
+                className: cn(
+                  "flex items-center justify-center rounded-md border border-dashed px-3 py-6 text-center text-[11px] transition-colors",
+                  isBodyOver ? "border-primary/60 text-primary" : "border-border text-muted-foreground"
+                ),
+                children: "Drag blocks here"
+              }
+            ) : /* @__PURE__ */ jsxRuntime.jsxs(sortable.SortableContext, { items: children.map((c) => c.id), strategy: sortable.verticalListSortingStrategy, children: [
+              children.map((child, idx) => /* @__PURE__ */ jsxRuntime.jsx(
+                BlockRow,
                 {
-                  ref: setBodyRef,
-                  className: cn(
-                    "flex flex-col gap-2 p-3 transition-colors",
-                    isPaletteDrag && "outline-2 -outline-offset-2 outline-dashed outline-primary/40",
-                    isPaletteDrag && isBodyOver && "bg-primary/5"
-                  ),
-                  children: children.length === 0 ? /* @__PURE__ */ jsxRuntime.jsx(
-                    "div",
-                    {
-                      className: cn(
-                        "flex items-center justify-center rounded-md border border-dashed px-3 py-6 text-center text-[11px] transition-colors",
-                        isBodyOver ? "border-primary/60 text-primary" : "border-border text-muted-foreground"
-                      ),
-                      children: "Drag blocks here"
-                    }
-                  ) : /* @__PURE__ */ jsxRuntime.jsxs(sortable.SortableContext, { items: children.map((c) => c.id), strategy: sortable.verticalListSortingStrategy, children: [
-                    children.map((child, idx) => /* @__PURE__ */ jsxRuntime.jsx(
-                      BlockRow,
-                      {
-                        builderBlock: child,
-                        previewHooks,
-                        previewTheme,
-                        errors: errorsByBlockId?.get(child.id),
-                        isOpen: openBlockId === child.id,
-                        onOpenChange: (open) => onOpenBlockChange?.(open ? child.id : null),
-                        onUpdate,
-                        onDuplicate,
-                        onDelete,
-                        index: idx,
-                        total: children.length,
-                        onReorder,
-                        isPaletteDrag,
-                        position: typeof index === "number" ? { index, childIndex: idx } : void 0,
-                        blockActions
-                      },
-                      child.id
-                    )),
-                    isPaletteDrag && isBodyOver ? /* @__PURE__ */ jsxRuntime.jsx(DropIndicator, {}) : null
-                  ] })
-                }
-              )
-            ]
+                  builderBlock: child,
+                  previewHooks,
+                  previewTheme,
+                  errors: errorsByBlockId?.get(child.id),
+                  isOpen: openBlockId === child.id,
+                  onOpenChange: (open) => onOpenBlockChange?.(open ? child.id : null),
+                  onUpdate,
+                  onDuplicate,
+                  onDelete,
+                  index: idx,
+                  total: children.length,
+                  onReorder,
+                  isPaletteDrag,
+                  position: typeof index === "number" ? { index, childIndex: idx } : void 0,
+                  blockActions,
+                  renderBlockAdornment
+                },
+                child.id
+              )),
+              isPaletteDrag && isBodyOver ? /* @__PURE__ */ jsxRuntime.jsx(DropIndicator, {}) : null
+            ] })
           }
-        ),
+        )
+      ]
+    }
+  );
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      ref: setNodeRef,
+      style,
+      "data-bk-block-index": index,
+      className: cn("group/container relative mb-2 last:mb-0 hover:z-10", isDragging && "opacity-40"),
+      children: [
+        renderBlockAdornment ? /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-start gap-2", children: [
+          /* @__PURE__ */ jsxRuntime.jsx("div", { className: "min-w-0 flex-1", children: card }),
+          adornment != null && adornment !== false ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "shrink-0", children: adornment }) : null
+        ] }) : card,
         /* @__PURE__ */ jsxRuntime.jsxs(
           "div",
           {
@@ -11039,7 +11052,8 @@ function Surface({
   onReorder,
   isPaletteDrag = false,
   onOpenPalette,
-  blockActions
+  blockActions,
+  renderBlockAdornment
 }) {
   const { setNodeRef, isOver } = core.useDroppable({ id: SURFACE_DROPPABLE_ID });
   const isDark = previewTheme === "dark";
@@ -11072,7 +11086,8 @@ function Surface({
               total: blocks.length,
               onReorder,
               isPaletteDrag,
-              blockActions
+              blockActions,
+              renderBlockAdornment
             },
             block.id
           ) : /* @__PURE__ */ jsxRuntime.jsx(
@@ -11092,7 +11107,8 @@ function Surface({
               onReorder,
               isPaletteDrag,
               position: { index: idx, childIndex: null },
-              blockActions
+              blockActions,
+              renderBlockAdornment
             },
             block.id
           )
@@ -11851,6 +11867,7 @@ function BlockKitchen(props) {
     onValidationChange,
     previewHooks,
     blockActions,
+    renderBlockAdornment,
     customEmojis,
     mentions,
     loadChannels,
@@ -12232,7 +12249,8 @@ function BlockKitchen(props) {
                     onReorder: reorderBlock,
                     isPaletteDrag: activePaletteVariant !== null,
                     onOpenPalette: () => setPaletteOpen(true),
-                    blockActions
+                    blockActions,
+                    renderBlockAdornment
                   }
                 ) })
               ] })