@burdenoff/fluidgrids-fe-sdk 2026.922.1 → 2026.922.2

package/dist/{chunk-XASNLRFQ.js → chunk-3RWKQIV4.js}

@@ -4,7 +4,7 @@ import { Badge as Badge$1, Button as Button$1 } from './chunk-DBOMRIP5.js';
 import { getGlobalStoreClient, createGlobalStoreClient, setGlobalStoreClient, resetGlobalStoreClient } from './chunk-BQXHJIER.js';
 import { GetMyNodeInstallationsDocument, BrowseWorkflowTemplatesDocument, InstallWorkflowNodeDocument, InstallPurchasedNodeDocument, BrowseWorkflowNodesDocument, UninstallWorkflowNodeDocument, CreateStoreOrderDocument, GetNodeInstallableVersionsDocument } from './chunk-6LXMUIR3.js';
 import { deepClone, applyTemplateInputs } from './chunk-XQP33UJR.js';
-import { useFlowStore, QuotaExhaustedDialog } from './chunk-KT72XMAB.js';
+import { useFlowStore, QuotaExhaustedDialog } from './chunk-I3WUYESA.js';
 import { SdkPermissionGate, FLUIDGRIDS_PERMISSIONS, SdkPermissionButton } from './chunk-UIY2HBWA.js';
 import { cn as cn$1 } from './chunk-3ZYUGTIT.js';
 import { useWorkflowVersions, useRestoreWorkflowVersion, useActivateWorkflow, useDeleteWorkflow, useDeactivateWorkflow } from './chunk-ELB3LXRJ.js';
@@ -37,7 +37,7 @@ import { ApolloProvider, useQuery, useMutation } from '@apollo/client/react';
 import { TagBadge, TagsWidget } from '@burdenoff/fe-libs/tag';
 import { gql as gql$1 } from '@apollo/client/core';
 import 'jszip';
-import { Sparkles, Star, Download, Eye, History, Loader2, Play, RotateCcw, Trash2, Maximize2, LayoutGrid, Plus, GitBranch, AlertCircle, Search, RefreshCw, CheckCircle2, Package, Info, Copy, BadgeCheck, DollarSign, Type, Code, Hash, List, Braces, Workflow, PlusCircle, ChevronDown, ChevronRight, Layers, X, AlertTriangle } from 'lucide-react';
+import { Sparkles, Star, Download, Eye, History, Loader2, Play, RotateCcw, Trash2, Maximize2, Undo2, Redo2, LayoutGrid, Keyboard, Plus, GitBranch, AlertCircle, Search, RefreshCw, CheckCircle2, Package, Info, Copy, BadgeCheck, DollarSign, Type, Code, Hash, List, Braces, Workflow, PlusCircle, ChevronDown, ChevronRight, Layers, X, AlertTriangle } from 'lucide-react';
 import { produce } from 'immer';
 import { isEmpty } from 'radash';
 import { animate, easeOut } from 'popmotion';
@@ -4409,6 +4409,72 @@ function nodeAccent(key) {
 function tint(hex, pct = 14) {
   return `color-mix(in srgb, ${hex} ${pct}%, transparent)`;
 }
+function InlineEditableLabel({
+  value,
+  placeholder,
+  editing,
+  onStartEdit,
+  onCommit,
+  onCancel,
+  className,
+  inputClassName
+}) {
+  const tr = useTr();
+  const [draft, setDraft] = React2.useState(value);
+  const inputRef = React2.useRef(null);
+  React2.useEffect(() => {
+    if (!editing) return;
+    setDraft(value);
+    const raf = requestAnimationFrame(() => {
+      inputRef.current?.focus();
+      inputRef.current?.select();
+    });
+    return () => cancelAnimationFrame(raf);
+  }, [editing, value]);
+  if (editing) {
+    return /* @__PURE__ */ jsx(
+      "input",
+      {
+        ref: inputRef,
+        value: draft,
+        onChange: (e) => setDraft(e.target.value),
+        onClick: (e) => e.stopPropagation(),
+        onDoubleClick: (e) => e.stopPropagation(),
+        onMouseDown: (e) => e.stopPropagation(),
+        onKeyDown: (e) => {
+          e.stopPropagation();
+          if (e.key === "Enter") {
+            e.preventDefault();
+            onCommit(draft.trim());
+          } else if (e.key === "Escape") {
+            e.preventDefault();
+            onCancel();
+          }
+        },
+        onBlur: () => onCommit(draft.trim()),
+        className: cn(
+          "min-w-0 flex-1 rounded border border-primary/50 bg-card px-1 text-inherit outline-none",
+          inputClassName
+        )
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx(
+    "span",
+    {
+      className: cn("cursor-text truncate", className),
+      title: tr(
+        "fluidgrids.builder.nodeCard.renameTooltip",
+        "Double-click or press F2 to rename"
+      ),
+      onDoubleClick: (e) => {
+        e.stopPropagation();
+        onStartEdit();
+      },
+      children: value || placeholder
+    }
+  );
+}
 var NodeCard = React2.forwardRef(
   ({
     className,
@@ -4422,6 +4488,8 @@ var NodeCard = React2.forwardRef(
     onDelete,
     isExecuting = false,
     infoButton,
+    disabled = false,
+    onToggleDisabled,
     children,
     ...props
   }, ref) => {
@@ -4440,7 +4508,7 @@ var NodeCard = React2.forwardRef(
             " ",
             itemCount !== 1 ? tr("fluidgrids.builder.nodeCard.itemCountOther", "items") : tr("fluidgrids.builder.nodeCard.itemCountOne", "item")
           ] }) }),
-          (onSettings || onExecute || onDelete || infoButton) && /* @__PURE__ */ jsxs(
+          (onSettings || onExecute || onDelete || onToggleDisabled || infoButton) && /* @__PURE__ */ jsxs(
             "div",
             {
               className: cn(
@@ -4494,6 +4562,29 @@ var NodeCard = React2.forwardRef(
                   }
                 ),
                 infoButton,
+                onToggleDisabled && /* @__PURE__ */ jsx(
+                  ToolbarButton2,
+                  {
+                    title: disabled ? tr(
+                      "fluidgrids.builder.nodeCard.enableTooltip",
+                      "Enable node"
+                    ) : tr(
+                      "fluidgrids.builder.nodeCard.disableTooltip",
+                      "Disable node (skip on run)"
+                    ),
+                    onClick: onToggleDisabled,
+                    children: /* @__PURE__ */ jsx(
+                      Icon,
+                      {
+                        icon: disabled ? "mdi:power" : "mdi:power-off",
+                        className: cn(
+                          "size-4",
+                          disabled ? "text-[var(--color-status-warning-text)]" : "text-muted-foreground"
+                        )
+                      }
+                    )
+                  }
+                ),
                 onDelete && /* @__PURE__ */ jsx(
                   ToolbarButton2,
                   {
@@ -4514,6 +4605,10 @@ var NodeCard = React2.forwardRef(
               ]
             }
           ),
+          disabled && /* @__PURE__ */ jsx("div", { className: "absolute -top-2 right-2 z-10", children: /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-1 rounded-full border border-[var(--color-status-warning-border)] bg-[var(--color-status-warning-bg)] px-1.5 py-0.5 text-[9px] font-semibold uppercase tracking-wide text-[var(--color-status-warning-text)] shadow-sm", children: [
+            /* @__PURE__ */ jsx(Icon, { icon: "mdi:power-off", className: "size-2.5" }),
+            tr("fluidgrids.builder.nodeCard.disabledBadge", "Disabled")
+          ] }) }),
           /* @__PURE__ */ jsxs(
             "div",
             {
@@ -4523,6 +4618,7 @@ var NodeCard = React2.forwardRef(
                 "relative w-72 rounded-xl border border-border bg-card shadow-sm will-change-transform",
                 statusRing,
                 executionStatus === "success" && "animate-success-glow",
+                disabled && "opacity-50 grayscale-[0.6]",
                 className
               ),
               style: {
@@ -4609,7 +4705,17 @@ function StatusCorner({
   ) });
 }
 var NodeCardHeader = React2.forwardRef(
-  ({ icon, appName, accentKey, missingCredentials = false }, ref) => {
+  ({
+    icon,
+    appName,
+    accentKey,
+    missingCredentials = false,
+    label,
+    isRenaming = false,
+    onStartRename,
+    onCommitRename,
+    onCancelRename
+  }, ref) => {
     const tr = useTr();
     const accent = nodeAccent(accentKey);
     return /* @__PURE__ */ jsxs("div", { ref, className: "flex items-center gap-2.5 px-3 pb-3 pt-4", children: [
@@ -4625,7 +4731,19 @@ var NodeCardHeader = React2.forwardRef(
           children: /* @__PURE__ */ jsx(NodeTypeIcon, { icon, alt: appName, className: "size-[18px]" })
         }
       ),
-      /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate text-[11px] font-semibold uppercase tracking-wide text-muted-foreground", children: appName }),
+      onStartRename && onCommitRename && onCancelRename ? /* @__PURE__ */ jsx(
+        InlineEditableLabel,
+        {
+          value: label ?? "",
+          placeholder: appName,
+          editing: isRenaming,
+          onStartEdit: onStartRename,
+          onCommit: onCommitRename,
+          onCancel: onCancelRename,
+          className: "min-w-0 flex-1 truncate text-[11px] font-semibold uppercase tracking-wide text-muted-foreground",
+          inputClassName: "text-[11px] font-semibold uppercase tracking-wide"
+        }
+      ) : /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate text-[11px] font-semibold uppercase tracking-wide text-muted-foreground", children: label || appName }),
       missingCredentials && /* @__PURE__ */ jsx(
         "span",
         {
@@ -4995,7 +5113,13 @@ function LogicNodeCard({
   onSettings,
   onExecute,
   onDelete,
-  infoButton
+  infoButton,
+  disabled = false,
+  onToggleDisabled,
+  isRenaming = false,
+  onStartRename,
+  onCommitRename,
+  onCancelRename
 }) {
   const minHeight = Math.max(
     64,
@@ -5018,6 +5142,8 @@ function LogicNodeCard({
       onExecute,
       onDelete,
       infoButton,
+      disabled,
+      onToggleDisabled,
       children: [
         /* @__PURE__ */ jsxs(
           "div",
@@ -5026,7 +5152,19 @@ function LogicNodeCard({
             style: { minHeight },
             children: [
               /* @__PURE__ */ jsx("div", { className: "flex size-9 items-center justify-center rounded-lg bg-muted", children: /* @__PURE__ */ jsx(Icon, { icon, className: "size-5", style: { color: accent } }) }),
-              /* @__PURE__ */ jsx("span", { className: "max-w-full truncate text-sm font-semibold leading-tight", children: title }),
+              onStartRename && onCommitRename && onCancelRename ? /* @__PURE__ */ jsx(
+                InlineEditableLabel,
+                {
+                  value: title,
+                  placeholder: title,
+                  editing: isRenaming,
+                  onStartEdit: onStartRename,
+                  onCommit: onCommitRename,
+                  onCancel: onCancelRename,
+                  className: "max-w-full truncate text-sm font-semibold leading-tight",
+                  inputClassName: "text-sm font-semibold text-center"
+                }
+              ) : /* @__PURE__ */ jsx("span", { className: "max-w-full truncate text-sm font-semibold leading-tight", children: title }),
               subtitle && /* @__PURE__ */ jsx(
                 "span",
                 {
@@ -6315,14 +6453,24 @@ var getNodeMetadata = (value) => {
       executingNodeId,
       nodeStatuses,
       nodeItemCounts,
-      zustandSetNodes
+      zustandSetNodes,
+      renamingNodeId,
+      toggleNodeDisabled,
+      renameNode,
+      startRename,
+      endRename
     ] = useFlowStore(
       useShallow((s) => [
         s.execution.isExecuting,
         s.execution.executingNodeId,
         s.execution.nodeStatuses,
         s.execution.nodeItemCounts,
-        s.actions.nodes.setNodes
+        s.actions.nodes.setNodes,
+        s.workflow.renamingNodeId,
+        s.actions.nodes.toggleDisabled,
+        s.actions.nodes.renameNode,
+        s.actions.nodes.startRename,
+        s.actions.nodes.endRename
       ])
     );
     useEffect(() => {
@@ -6346,6 +6494,22 @@ var getNodeMetadata = (value) => {
     const handleDeleteNode = () => {
       deleteNode(id);
     };
+    const handleToggleDisabled = useCallback(() => {
+      toggleNodeDisabled(id);
+    }, [id, toggleNodeDisabled]);
+    const isRenamingThisNode = renamingNodeId === id;
+    const handleStartRename = useCallback(() => {
+      startRename(id);
+    }, [id, startRename]);
+    const handleCommitRename = useCallback(
+      (value2) => {
+        renameNode(id, value2);
+      },
+      [id, renameNode]
+    );
+    const handleCancelRename = useCallback(() => {
+      endRename();
+    }, [endRename]);
     const openNdv = useFlowStore((s) => s.actions.ndv.open);
     const openQuickConfig = useFlowStore((s) => s.actions.quickConfig.open);
     const clickTimerRef = useRef(null);
@@ -6408,6 +6572,8 @@ var getNodeMetadata = (value) => {
     const nodeStatus = nodeStatuses[id] || "idle";
     const executionStatus = nodeStatus === "success" ? "success" : nodeStatus === "error" ? "error" : nodeStatus === "running" ? "running" : "idle";
     const itemCount = nodeItemCounts[id];
+    const isDisabled = data?.disabled === true;
+    const nodeLabel = data?.label || "";
     const nodeKinds = data?.nodeData?.kind;
     const pinnedOpType = (data?.operation_type || "").toLowerCase();
     const isTrigger = pinnedOpType === "trigger" || (value?.type || "").toLowerCase().includes("trigger") || // Kind-based detection only when NO operation is pinned: dual-role
@@ -6472,7 +6638,13 @@ var getNodeMetadata = (value) => {
             onSettings: handleOpenNdv,
             onExecute: handleExecuteStep,
             onDelete: handleDeleteNode,
-            infoButton: /* @__PURE__ */ jsx(NodeInfoButtonWithModal, { metadata: nodeInfoMetadata })
+            infoButton: /* @__PURE__ */ jsx(NodeInfoButtonWithModal, { metadata: nodeInfoMetadata }),
+            disabled: isDisabled,
+            onToggleDisabled: handleToggleDisabled,
+            isRenaming: isRenamingThisNode,
+            onStartRename: handleStartRename,
+            onCommitRename: handleCommitRename,
+            onCancelRename: handleCancelRename
           }
         ),
         /* @__PURE__ */ jsx(
@@ -6501,6 +6673,8 @@ var getNodeMetadata = (value) => {
           onExecute: handleExecuteStep,
           onDelete: handleDeleteNode,
           infoButton: /* @__PURE__ */ jsx(NodeInfoButtonWithModal, { metadata: nodeInfoMetadata }),
+          disabled: isDisabled,
+          onToggleDisabled: handleToggleDisabled,
           children: [
             /* @__PURE__ */ jsx(
               NodeCardHeader,
@@ -6508,7 +6682,12 @@ var getNodeMetadata = (value) => {
                 icon: meta.icon,
                 appName,
                 accentKey: value?.type || meta.title,
-                missingCredentials
+                missingCredentials,
+                label: nodeLabel,
+                isRenaming: isRenamingThisNode,
+                onStartRename: handleStartRename,
+                onCommitRename: handleCommitRename,
+                onCancelRename: handleCancelRename
               }
             ),
             operationDisplay === "execute" && (value?.type || "").startsWith("internal:") || isTrigger ? (
@@ -17906,6 +18085,10 @@ function CustomDeletableEdge(props) {
   const nodeStatuses = useFlowStore(
     useShallow((s) => s.execution.nodeStatuses)
   );
+  const nodeItemCounts = useFlowStore(
+    useShallow((s) => s.execution.nodeItemCounts)
+  );
+  const sourceItemCount = nodeItemCounts[source];
   const sourceNodeStatus = nodeStatuses[source] || "idle";
   const isRunning = sourceNodeStatus === "running";
   const isSuccess = sourceNodeStatus === "success";
@@ -18805,6 +18988,26 @@ function CustomDeletableEdge(props) {
       }
     ),
     /* @__PURE__ */ jsxs(EdgeLabelRenderer, { children: [
+      sourceItemCount !== void 0 && sourceItemCount > 0 && /* @__PURE__ */ jsx(
+        "div",
+        {
+          className: "pointer-events-none absolute z-[999]",
+          style: {
+            transform: `translate(${labelX}px, ${labelY}px) translate(-50%, -100%) translateY(-10px)`
+          },
+          children: /* @__PURE__ */ jsxs("div", { className: "rounded-full border border-border bg-card px-1.5 py-0.5 text-[10px] font-medium text-muted-foreground shadow-sm", children: [
+            sourceItemCount,
+            " ",
+            sourceItemCount !== 1 ? tr(
+              "fluidgrids.builder.edges.customDeletableEdge.itemCountOther",
+              "items"
+            ) : tr(
+              "fluidgrids.builder.edges.customDeletableEdge.itemCountOne",
+              "item"
+            )
+          ] })
+        }
+      ),
       /* @__PURE__ */ jsxs(
         "div",
         {
@@ -19197,6 +19400,276 @@ function computeMinimapRect(panelRect, bounds, margin) {
   top = Math.min(Math.max(top, bounds.top + margin), maxTop);
   return { left, top };
 }
+var SHORTCUT_ROWS = [
+  {
+    labelKey: "fluidgrids.builder.shortcutsHelp.undo",
+    labelDefault: "Undo",
+    mac: "\u2318Z",
+    other: "Ctrl+Z"
+  },
+  {
+    labelKey: "fluidgrids.builder.shortcutsHelp.redo",
+    labelDefault: "Redo",
+    mac: "\u2318\u21E7Z",
+    other: "Ctrl+Shift+Z / Ctrl+Y"
+  },
+  {
+    labelKey: "fluidgrids.builder.shortcutsHelp.copy",
+    labelDefault: "Copy selected node(s)",
+    mac: "\u2318C",
+    other: "Ctrl+C"
+  },
+  {
+    labelKey: "fluidgrids.builder.shortcutsHelp.cut",
+    labelDefault: "Cut selected node(s)",
+    mac: "\u2318X",
+    other: "Ctrl+X"
+  },
+  {
+    labelKey: "fluidgrids.builder.shortcutsHelp.paste",
+    labelDefault: "Paste \u2014 works across workflows/tabs",
+    mac: "\u2318V",
+    other: "Ctrl+V"
+  },
+  {
+    labelKey: "fluidgrids.builder.shortcutsHelp.duplicate",
+    labelDefault: "Duplicate selected node(s)",
+    mac: "\u2318D",
+    other: "Ctrl+D"
+  },
+  {
+    labelKey: "fluidgrids.builder.shortcutsHelp.delete",
+    labelDefault: "Delete selected node(s)/connection(s)",
+    mac: "\u232B / Delete",
+    other: "Backspace / Delete"
+  },
+  {
+    labelKey: "fluidgrids.builder.shortcutsHelp.rename",
+    labelDefault: "Rename the selected node",
+    mac: "F2 or double-click its title",
+    other: "F2 or double-click its title"
+  },
+  {
+    labelKey: "fluidgrids.builder.shortcutsHelp.multiSelectClick",
+    labelDefault: "Add a node to the selection",
+    mac: "\u2318-click / \u2303-click",
+    other: "Ctrl-click"
+  },
+  {
+    labelKey: "fluidgrids.builder.shortcutsHelp.multiSelectBox",
+    labelDefault: "Box-select multiple nodes",
+    mac: "\u21E7-drag on empty canvas",
+    other: "Shift-drag on empty canvas"
+  },
+  {
+    labelKey: "fluidgrids.builder.shortcutsHelp.stickyNote",
+    labelDefault: "Add a sticky note",
+    mac: "\u21E7S",
+    other: "Shift+S"
+  },
+  {
+    labelKey: "fluidgrids.builder.shortcutsHelp.cancel",
+    labelDefault: "Close a panel / cancel an edit",
+    mac: "Esc",
+    other: "Esc"
+  },
+  {
+    labelKey: "fluidgrids.builder.shortcutsHelp.help",
+    labelDefault: "Open this shortcuts panel",
+    mac: "?",
+    other: "?"
+  }
+];
+function Kbd({ children }) {
+  return /* @__PURE__ */ jsx("kbd", { className: "rounded border border-border bg-muted px-1.5 py-0.5 font-mono text-[11px] font-medium text-muted-foreground", children });
+}
+function ShortcutsHelpPanel({
+  open,
+  onOpenChange
+}) {
+  const tr = useTr();
+  const isMac = typeof navigator !== "undefined" && /Mac|iPhone|iPad/.test(navigator.platform ?? "");
+  return /* @__PURE__ */ jsx(Dialog$1, { open, onOpenChange, children: /* @__PURE__ */ jsxs(DialogContent$1, { className: "max-w-lg", children: [
+    /* @__PURE__ */ jsxs(DialogHeader$1, { children: [
+      /* @__PURE__ */ jsx(DialogTitle$1, { children: tr("fluidgrids.builder.shortcutsHelp.title", "Keyboard shortcuts") }),
+      /* @__PURE__ */ jsx(DialogDescription$1, { children: tr(
+        "fluidgrids.builder.shortcutsHelp.description",
+        "Speed up editing the workflow canvas."
+      ) })
+    ] }),
+    /* @__PURE__ */ jsx("div", { className: "max-h-[60vh] space-y-0.5 overflow-y-auto pr-1", children: SHORTCUT_ROWS.map((row) => /* @__PURE__ */ jsxs(
+      "div",
+      {
+        className: "flex items-center justify-between gap-4 rounded-md px-2 py-1.5 text-sm hover:bg-muted/50",
+        children: [
+          /* @__PURE__ */ jsx("span", { className: "text-foreground/80", children: tr(row.labelKey, row.labelDefault) }),
+          /* @__PURE__ */ jsx(Kbd, { children: isMac ? row.mac : row.other })
+        ]
+      },
+      row.labelKey
+    )) })
+  ] }) });
+}
+
+// src/builder/lib/clipboard-payload.ts
+var CLIPBOARD_MARKER = "fluidgrids/flow-clipboard@1";
+function buildClipboardPayload(nodes, edges) {
+  const selected = nodes.filter((n) => n.selected);
+  const idSet = new Set(selected.map((n) => n.id));
+  const internalEdges = edges.filter(
+    (e) => idSet.has(e.source) && idSet.has(e.target)
+  );
+  return { marker: CLIPBOARD_MARKER, nodes: selected, edges: internalEdges };
+}
+function parseClipboardPayload(text) {
+  if (!text) return null;
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    return null;
+  }
+  if (!parsed || typeof parsed !== "object") return null;
+  const rec = parsed;
+  if (rec.marker !== CLIPBOARD_MARKER || !Array.isArray(rec.nodes)) {
+    return null;
+  }
+  return {
+    marker: CLIPBOARD_MARKER,
+    nodes: rec.nodes,
+    edges: Array.isArray(rec.edges) ? rec.edges : []
+  };
+}
+
+// src/builder/hooks/use-flow-clipboard.ts
+function useFlowClipboard() {
+  const { getNodes, getEdges } = useReactFlow();
+  const pasteNodes = useFlowStore((s) => s.actions.nodes.pasteNodes);
+  const deleteNodes = useFlowStore((s) => s.actions.nodes.deleteNodes);
+  const copySelection = useCallback(async () => {
+    const payload = buildClipboardPayload(getNodes(), getEdges());
+    if (payload.nodes.length === 0) return false;
+    try {
+      await navigator.clipboard.writeText(JSON.stringify(payload));
+      return true;
+    } catch {
+      return false;
+    }
+  }, [getNodes, getEdges]);
+  const cutSelection = useCallback(async () => {
+    const selected = getNodes().filter((n) => n.selected);
+    if (selected.length === 0) return false;
+    const copied = await copySelection();
+    if (!copied) return false;
+    deleteNodes(selected);
+    return true;
+  }, [copySelection, deleteNodes, getNodes]);
+  const pasteFromClipboard = useCallback(async () => {
+    let text;
+    try {
+      text = await navigator.clipboard.readText();
+    } catch {
+      return false;
+    }
+    const payload = parseClipboardPayload(text);
+    if (!payload || payload.nodes.length === 0) return false;
+    pasteNodes({ nodes: payload.nodes, edges: payload.edges });
+    return true;
+  }, [pasteNodes]);
+  return { copySelection, cutSelection, pasteFromClipboard };
+}
+
+// src/builder/hooks/use-editor-shortcuts.ts
+function isEditableTarget(target) {
+  const el = target;
+  if (!el) return false;
+  return el.tagName === "INPUT" || el.tagName === "TEXTAREA" || el.tagName === "SELECT" || el.isContentEditable;
+}
+function hasTextSelection() {
+  const sel = typeof window !== "undefined" ? window.getSelection?.() : null;
+  return !!sel && sel.toString().length > 0;
+}
+function useEditorShortcuts(options) {
+  const readOnly = options?.readOnly ?? false;
+  const onOpenHelp = options?.onOpenHelp;
+  const { getNodes } = useReactFlow();
+  const undo = useFlowStore((s) => s.actions.history.undo);
+  const redo = useFlowStore((s) => s.actions.history.redo);
+  const duplicateNodes = useFlowStore((s) => s.actions.nodes.duplicateNodes);
+  const startRename = useFlowStore((s) => s.actions.nodes.startRename);
+  const { copySelection, cutSelection, pasteFromClipboard } = useFlowClipboard();
+  const insertStickyNote = useInsertStickyNote();
+  useEffect(() => {
+    if (readOnly) return;
+    const onKeyDown = (e) => {
+      const editable = isEditableTarget(e.target);
+      const mod = e.metaKey || e.ctrlKey;
+      if (!mod && !e.altKey && e.shiftKey && e.key.toLowerCase() === "s" && !editable) {
+        e.preventDefault();
+        insertStickyNote();
+        return;
+      }
+      if (!mod && !editable && onOpenHelp && (e.key === "?" || e.shiftKey && e.key === "/")) {
+        e.preventDefault();
+        onOpenHelp();
+        return;
+      }
+      if (!mod && !editable && e.key === "F2") {
+        const selected = getNodes().filter((n) => n.selected);
+        if (selected.length === 1 && selected[0]) {
+          e.preventDefault();
+          startRename(selected[0].id);
+        }
+        return;
+      }
+      if (!mod || editable) return;
+      const key = e.key.toLowerCase();
+      if (key === "z") {
+        e.preventDefault();
+        if (e.shiftKey) redo();
+        else undo();
+        return;
+      }
+      if (key === "y") {
+        e.preventDefault();
+        redo();
+        return;
+      }
+      if ((key === "c" || key === "x") && !hasTextSelection()) {
+        const hasSelection = getNodes().some((n) => n.selected);
+        if (!hasSelection) return;
+        e.preventDefault();
+        void (key === "c" ? copySelection() : cutSelection());
+        return;
+      }
+      if (key === "v") {
+        e.preventDefault();
+        void pasteFromClipboard();
+        return;
+      }
+      if (key === "d") {
+        const selectedIds = getNodes().filter((n) => n.selected).map((n) => n.id);
+        if (selectedIds.length === 0) return;
+        e.preventDefault();
+        duplicateNodes(selectedIds);
+      }
+    };
+    window.addEventListener("keydown", onKeyDown);
+    return () => window.removeEventListener("keydown", onKeyDown);
+  }, [
+    readOnly,
+    getNodes,
+    undo,
+    redo,
+    duplicateNodes,
+    startRename,
+    copySelection,
+    cutSelection,
+    pasteFromClipboard,
+    insertStickyNote,
+    onOpenHelp
+  ]);
+}
 var ZOOM_DURATION = 500;
 var NODE_WIDTH = 220;
 var NODE_HEIGHT = 80;
@@ -19257,6 +19730,7 @@ function CanvasControls() {
   const isReadOnly = searchParams.get("readonly") === "true";
   const [showMinimap, setShowMinimap] = useState(false);
   const [edgesHidden, setEdgesHidden] = useState(false);
+  const [shortcutsHelpOpen, setShortcutsHelpOpen] = useState(false);
   const [dragOffset, setDragOffset] = useState({ x: 0, y: 0 });
   const [isDragging, setIsDragging] = useState(false);
   const panelRef = useRef(null);
@@ -19266,6 +19740,18 @@ function CanvasControls() {
     shallow
   );
   const { zoomIn, zoomOut, fitView, setEdges, getEdges, getNodes, setNodes } = useReactFlow();
+  const [canUndo, canRedo, undo, redo] = useFlowStore(
+    useShallow((s) => [
+      s.history.past.length > 0,
+      s.history.future.length > 0,
+      s.actions.history.undo,
+      s.actions.history.redo
+    ])
+  );
+  useEditorShortcuts({
+    readOnly: isReadOnly,
+    onOpenHelp: () => setShortcutsHelpOpen(true)
+  });
   const toggleEdges = useCallback(() => {
     setEdgesHidden((prev) => {
       const next = !prev;
@@ -19274,20 +19760,6 @@ function CanvasControls() {
     });
   }, [setEdges]);
   const insertStickyNote = useInsertStickyNote();
-  useEffect(() => {
-    if (isReadOnly) return;
-    const onKeyDown = (e) => {
-      if (!e.shiftKey || e.key.toLowerCase() !== "s") return;
-      if (e.metaKey || e.ctrlKey || e.altKey) return;
-      const t = e.target;
-      if (t && (t.tagName === "INPUT" || t.tagName === "TEXTAREA" || t.isContentEditable))
-        return;
-      e.preventDefault();
-      insertStickyNote();
-    };
-    window.addEventListener("keydown", onKeyDown);
-    return () => window.removeEventListener("keydown", onKeyDown);
-  }, [insertStickyNote, isReadOnly]);
   const tidyUp = useCallback(() => {
     const nodes = getNodes().filter((n) => n.type !== STICKY_NOTE_TYPE);
     const edges = getEdges();
@@ -19489,6 +19961,31 @@ function CanvasControls() {
             }
           ),
           !isReadOnly && /* @__PURE__ */ jsxs(Fragment, { children: [
+            /* @__PURE__ */ jsx("div", { className: "w-px h-5 bg-card-foreground/10 mx-0.5" }),
+            /* @__PURE__ */ jsx(
+              ControlBtn,
+              {
+                title: tr(
+                  "fluidgrids.builder.canvasControls.undo",
+                  "Undo (Ctrl/Cmd+Z)"
+                ),
+                disabled: !canUndo,
+                onClick: undo,
+                children: /* @__PURE__ */ jsx(Undo2, { className: "size-4" })
+              }
+            ),
+            /* @__PURE__ */ jsx(
+              ControlBtn,
+              {
+                title: tr(
+                  "fluidgrids.builder.canvasControls.redo",
+                  "Redo (Ctrl/Cmd+Shift+Z)"
+                ),
+                disabled: !canRedo,
+                onClick: redo,
+                children: /* @__PURE__ */ jsx(Redo2, { className: "size-4" })
+              }
+            ),
             /* @__PURE__ */ jsx("div", { className: "w-px h-5 bg-card-foreground/10 mx-0.5" }),
             /* @__PURE__ */ jsx(
               ControlBtn,
@@ -19532,10 +20029,29 @@ function CanvasControls() {
                 onClick: insertStickyNote,
                 children: /* @__PURE__ */ jsx(Icon, { icon: "mdi:note-plus-outline", className: "size-4" })
               }
+            ),
+            /* @__PURE__ */ jsx("div", { className: "w-px h-5 bg-card-foreground/10 mx-0.5" }),
+            /* @__PURE__ */ jsx(
+              ControlBtn,
+              {
+                title: tr(
+                  "fluidgrids.builder.canvasControls.shortcutsHelp",
+                  "Keyboard shortcuts (?)"
+                ),
+                onClick: () => setShortcutsHelpOpen(true),
+                children: /* @__PURE__ */ jsx(Keyboard, { className: "size-4" })
+              }
             )
           ] })
         ]
       }
+    ),
+    !isReadOnly && /* @__PURE__ */ jsx(
+      ShortcutsHelpPanel,
+      {
+        open: shortcutsHelpOpen,
+        onOpenChange: setShortcutsHelpOpen
+      }
     )
   ] });
 }
@@ -23698,7 +24214,7 @@ var FlowBuilder = ({ readOnly = false }) => {
               nodesDraggable: !isReadOnly,
               nodesConnectable: !isReadOnly,
               elementsSelectable: !isReadOnly,
-              multiSelectionKeyCode: null,
+              multiSelectionKeyCode: isReadOnly ? null : ["Meta", "Control"],
               deleteKeyCode: isReadOnly ? null : deleteKeyCode,
               snapGrid: [16, 16],
               snapToGrid: true,
@@ -23824,5 +24340,5 @@ var FlowBuilderPage = ({
 };
 
 export { Card2 as Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, ConnectionFormDialog, ConnectionSelector, EntityTagPicker, FLUIDGRIDS_ENTITY_TYPES, FlowBuilderPage, FluidGridsProvider, ProviderPicker, SchemaConnectionForm, ScopePicker, TemplateCard, buildNodeCheck, buildRequiredNodeTypes, listCustomBlocks, mergeStickyNotes, refetchStoreNodes, registerCustomBlock, resolveUiSpec, stripSubmitActions, tagLabel, useAvailableTags, useConnection, useConnectionDialog, useConnections, useConnectionsByProvider, useCreateConnection, useCreateTag, useDraftEntityTags, useEntityTags, useFluidGridsContext, useImportWorkflowTemplate, useInitiateOAuth, useInstalledNodes, useNodeExecution, useProviderByKey, useProviderCatalog, useProviders, useReplaceEntityTags, useSearchTags, useTagEntity, useUntagEntity, useWorkflowTemplates };
-//# sourceMappingURL=chunk-XASNLRFQ.js.map
-//# sourceMappingURL=chunk-XASNLRFQ.js.map
+//# sourceMappingURL=chunk-3RWKQIV4.js.map
+//# sourceMappingURL=chunk-3RWKQIV4.js.map