@arbidocs/blocks 0.5.114 → 0.5.116

package/dist/{chunk-4ED7CNOX.cjs → chunk-2CSLFAGF.cjs}

@@ -2050,17 +2050,23 @@ function RibbonMenu({
   testId,
   title,
   keepMounted = false,
-  popoverClassName
+  popoverClassName,
+  restoreFocus = false
 }) {
   const [open, setOpen] = React4.useState(false);
   const element = React4.useRef(null);
+  const trigger = React4.useRef(null);
   React4.useEffect(() => {
     if (!open) return;
     const dismiss = (event) => {
       if (!element.current?.contains(event.target)) setOpen(false);
     };
     const escape = (event) => {
-      if (event.key === "Escape") setOpen(false);
+      if (event.key === "Escape") {
+        if (restoreFocus && element.current?.contains(document.activeElement))
+          trigger.current?.focus();
+        setOpen(false);
+      }
     };
     document.addEventListener("pointerdown", dismiss);
     document.addEventListener("keydown", escape);
@@ -2068,12 +2074,13 @@ function RibbonMenu({
       document.removeEventListener("pointerdown", dismiss);
       document.removeEventListener("keydown", escape);
     };
-  }, [open]);
+  }, [open, restoreFocus]);
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "native-docx-ribbon-menu", ref: element, children: [
     /* @__PURE__ */ jsxRuntime.jsx(
       "button",
       {
         type: "button",
+        ref: trigger,
         className: ["native-docx-ribbon-trigger", className].filter(Boolean).join(" "),
         "aria-label": label,
         title: title ?? label,
@@ -2116,6 +2123,10 @@ function planOverflow(items, available, moreWidth) {
   return collapsed;
 }
 var Overflow = React4.createContext(null);
+var NamedCommands = React4.createContext(false);
+function NamedCommandList({ children }) {
+  return /* @__PURE__ */ jsxRuntime.jsx(NamedCommands.Provider, { value: true, children });
+}
 var MORE_WIDTH = 32;
 var sameSet = (a, b) => a.size === b.size && [...a].every((id) => b.has(id));
 function RibbonOverflow({ tab, children }) {
@@ -2237,13 +2248,31 @@ function RibbonItem({
   children
 }) {
   const context = React4.useContext(Overflow);
+  const named = React4.useContext(NamedCommands);
   const element = React4.useRef(null);
   const register = context?.register;
   React4.useLayoutEffect(() => {
     if (!register || !element.current) return;
     return register(id, { label, priority, element: element.current });
   }, [register, id, label, priority]);
-  if (!context) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
+  if (!context) {
+    if (!named) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
+    return /* @__PURE__ */ jsxRuntime.jsxs(
+      "span",
+      {
+        className: "native-docx-command-item",
+        "data-ribbon-item": id,
+        onClick: (event) => {
+          if (event.target.classList.contains("native-docx-command-label"))
+            event.currentTarget.querySelector("button:not([disabled])")?.click();
+        },
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "native-docx-command-control", children }),
+          /* @__PURE__ */ jsxRuntime.jsx("span", { className: "native-docx-command-label", children: label })
+        ]
+      }
+    );
+  }
   const collapsed = context.collapsed.has(id);
   const slot = context.slots[id];
   return /* @__PURE__ */ jsxRuntime.jsx(
@@ -4030,79 +4059,12 @@ function GenerateImageButton({ generation }) {
     }
   );
 }
-var contains = (node, id) => node.id === id || (node.children ?? []).some((child) => contains(child, id));
-function firstParagraph(node) {
-  for (const child of node.children ?? []) {
-    if (child.kind === "paragraph" && child.id) return child.id;
-    if (child.localName === "tbl") continue;
-    const nested = firstParagraph(child);
-    if (nested) return nested;
-  }
-  return null;
-}
-function tableCells(root, paragraphId) {
-  let table = null;
-  const find = (node) => {
-    if (node.localName === "tbl" && contains(node, paragraphId)) table = node;
-    for (const child of node.children ?? []) if (contains(child, paragraphId)) find(child);
-  };
-  find(root);
-  if (!table) return null;
-  const cells = [];
-  let index = -1;
-  const rows = (node) => (node.children ?? []).flatMap(
-    (child) => child.localName === "tr" ? [child] : child.localName === "tbl" ? [] : rows(child)
-  );
-  for (const row of rows(table))
-    for (const cell of (row.children ?? []).filter((child) => child.localName === "tc")) {
-      const first = firstParagraph(cell);
-      if (!first) continue;
-      if (contains(cell, paragraphId)) index = cells.length;
-      cells.push(first);
-    }
-  return index < 0 ? null : { cells, index };
-}
-function TableTabKeys({ scope }) {
-  const editor = react.useDocxEditor();
-  const latest = React4.useRef(editor);
-  latest.current = editor;
-  React4.useEffect(() => {
-    const element = scope.current;
-    if (!element) return;
-    const onKeyDown = (event) => {
-      if (event.key !== "Tab" || event.ctrlKey || event.metaKey || event.altKey) return;
-      const editor2 = latest.current;
-      const surface = editor2?.surface;
-      const head = surface?.state().selection?.head;
-      if (!editor2 || !surface || !head) return;
-      const root = () => surface.session.part().root;
-      const table = tableCells(root(), head.paragraphId);
-      if (!table) return;
-      event.preventDefault();
-      event.stopPropagation();
-      let target = table.cells[table.index + (event.shiftKey ? -1 : 1)];
-      if (!target && !event.shiftKey && editor2.exec({ type: "insertRow", where: "below" }).ok) {
-        const grown = tableCells(
-          root(),
-          surface.state().selection?.head.paragraphId ?? head.paragraphId
-        );
-        target = grown?.cells[table.cells.length] ?? "";
-      }
-      if (!target) return;
-      const point = { paragraphId: target, offset: 0 };
-      surface.setSelection({ anchor: point, head: point });
-    };
-    element.addEventListener("keydown", onKeyDown, true);
-    return () => element.removeEventListener("keydown", onKeyDown, true);
-  }, [scope]);
-  return null;
-}
 function QuickParts() {
   const house = chunkGA5ZO4YA_cjs.useHouseTemplate();
   if (!house || house.blocks.length === 0) return null;
-  const categories = [...new Set(house.blocks.map((b) => b.category))];
+  const categories2 = [...new Set(house.blocks.map((b) => b.category))];
   return /* @__PURE__ */ jsxRuntime.jsx(RibbonMenu, { label: "Quick Parts", icon: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Blocks, { size: 16 }), testId: "docx-quick-parts", children: (close) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "native-docx-quick-parts", "data-testid": "docx-quick-parts-panel", children: [
-    categories.map((category) => /* @__PURE__ */ jsxRuntime.jsxs("section", { "aria-label": category, children: [
+    categories2.map((category) => /* @__PURE__ */ jsxRuntime.jsxs("section", { "aria-label": category, children: [
       /* @__PURE__ */ jsxRuntime.jsx("h3", { children: category }),
       /* @__PURE__ */ jsxRuntime.jsx("ul", { children: house.blocks.filter((b) => b.category === category).map((block) => /* @__PURE__ */ jsxRuntime.jsx("li", { children: /* @__PURE__ */ jsxRuntime.jsxs(
         "button",
@@ -4127,6 +4089,65 @@ function QuickParts() {
     ] })
   ] }) });
 }
+var SOURCE = {
+  workspace: "This workspace's house template",
+  deployment: "The house template for all workspaces",
+  builtin: "ARBI\u2019s built-in template (no house template has been set)"
+};
+function download(bytes, name) {
+  const isTemplate = !/\.docx$/i.test(name);
+  const url = URL.createObjectURL(
+    new Blob([bytes], {
+      type: isTemplate ? "application/vnd.openxmlformats-officedocument.wordprocessingml.template" : "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+    })
+  );
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = /\.(dotx|docx)$/i.test(name) ? name : `${name}.dotx`;
+  a.click();
+  setTimeout(() => URL.revokeObjectURL(url), 5e3);
+}
+function HouseTemplatePanel() {
+  const house = chunkGA5ZO4YA_cjs.useHouseTemplate();
+  if (!house) return null;
+  const summary = divergenceSummary(house.divergence);
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    RibbonMenu,
+    {
+      label: "House template",
+      className: "native-docx-style-trigger",
+      testId: "docx-house-template",
+      icon: /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "native-docx-style-current", children: "House template" }),
+        /* @__PURE__ */ jsxRuntime.jsx(lucideReact.ChevronDown, { size: 12, "aria-hidden": true })
+      ] }),
+      children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "native-docx-house-template", "data-testid": "docx-house-template-panel", children: [
+        /* @__PURE__ */ jsxRuntime.jsxs("p", { children: [
+          /* @__PURE__ */ jsxRuntime.jsx("strong", { children: house.template.name }),
+          /* @__PURE__ */ jsxRuntime.jsx("br", {}),
+          SOURCE[house.template.source],
+          ". New documents start from it."
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsx("p", { "data-testid": "docx-house-template-status", children: house.divergence === null ? "Comparing this document\u2019s styles\u2026" : !house.basedOnTemplate ? "This document was not started from the house template." : summary ?? "This document\u2019s styles match the house template." }),
+        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "native-docx-house-template-actions", children: [
+          /* @__PURE__ */ jsxRuntime.jsxs("button", { type: "button", onClick: () => download(house.template.bytes, house.template.name), children: [
+            /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Download, { size: 14 }),
+            " Download template"
+          ] }),
+          house.setAsHouseTemplate && /* @__PURE__ */ jsxRuntime.jsx(
+            "button",
+            {
+              type: "button",
+              "data-testid": "docx-set-house-template",
+              onClick: () => void house.setAsHouseTemplate(),
+              children: "Use this document as the house template"
+            }
+          )
+        ] })
+      ] })
+    }
+  );
+}
 var SignatureFieldsContext = React4.createContext(null);
 function SignatureFieldsProvider({
   signers,
@@ -4135,13 +4156,21 @@ function SignatureFieldsProvider({
   mySignature,
   children
 }) {
+  const [pending, setPending] = React4.useState(null);
   return /* @__PURE__ */ jsxRuntime.jsxs(
     SignatureFieldsContext.Provider,
     {
-      value: signers || mySignature ? { fields: !!signers, signers: signers ?? [], editable, notify, mySignature } : null,
+      value: signers || mySignature ? {
+        fields: !!signers,
+        signers: signers ?? [],
+        editable,
+        notify,
+        mySignature,
+        openAdopt: setPending
+      } : null,
       children: [
         children,
-        mySignature && /* @__PURE__ */ jsxRuntime.jsx(MySignatureDialog, {})
+        mySignature && /* @__PURE__ */ jsxRuntime.jsx(MySignatureDialog, { pending, setPending })
       ]
     }
   );
@@ -4168,12 +4197,12 @@ async function insertSavedMark(editor$1, saved, mark) {
   });
   if (!result.ok) throw new Error(result.reason || "The picture could not be inserted here.");
 }
-var openAdopt = null;
-function MySignatureDialog() {
+function MySignatureDialog({
+  pending,
+  setPending
+}) {
   const context = React4.useContext(SignatureFieldsContext);
   const editor = react.useDocxEditor();
-  const [pending, setPending] = React4.useState(null);
-  openAdopt = setPending;
   const mine = context?.mySignature;
   if (!mine) return null;
   return /* @__PURE__ */ jsxRuntime.jsx(
@@ -4207,7 +4236,7 @@ function useInsertMySignature() {
   return async (mark) => {
     try {
       const saved = await mine.load();
-      if (!saved) return openAdopt?.(mark);
+      if (!saved) return context?.openAdopt(mark);
       await insertSavedMark(editor, saved, mark);
     } catch (failure) {
       context?.notify?.(
@@ -4274,6 +4303,42 @@ function MySignatureContextItems() {
     )
   ] });
 }
+function SignatureFieldContextItem() {
+  const context = React4.useContext(SignatureFieldsContext);
+  const editor = react.useDocxEditor();
+  const target = react.useContextMenuTarget();
+  const surface = editor?.surface;
+  const head = surface?.state().selection?.head;
+  const run = target?.closest("[data-paragraph-id][data-start][data-end]");
+  const start = Number(run?.dataset.start);
+  const end = Number(run?.dataset.end);
+  const onSelectedRun = run && head && run.dataset.paragraphId === head.paragraphId && head.offset >= start && head.offset <= end;
+  const control = onSelectedRun && surface?.contentControls.atCaret();
+  if (!context?.fields || !control || !commands.parseSignatureFieldTag(control.tag)) return null;
+  return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.ContextMenu.Separator, {}),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      react.DocxEditor.ContextMenu.Item,
+      {
+        label: "Remove selected signature field",
+        icon: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Trash2, { size: 14 }),
+        disabled: !context.editable || control.effectiveLock === "sdtLocked" || control.effectiveLock === "sdtContentLocked",
+        onSelect: () => {
+          try {
+            if (!editor || !surface) return;
+            const result = withDirectEditing(
+              editor,
+              () => surface.session.removeCustomNode(control.id)
+            );
+            if (!result.ok) throw new Error("The signature field could not be removed.");
+          } catch (failure) {
+            context.notify?.(failure instanceof Error ? failure.message : String(failure), "error");
+          }
+        }
+      }
+    )
+  ] });
+}
 var OTHER = "__other__";
 var NONE2 = "";
 function insertSignatureField(editor, spec) {
@@ -4295,7 +4360,7 @@ function insertSignatureField(editor, spec) {
   }
   return tag;
 }
-function SignatureFieldMenu() {
+function SignatureFieldMenu({ onInserted } = {}) {
   const context = React4.useContext(SignatureFieldsContext);
   const editor = react.useDocxEditor();
   const [kind, setKind] = React4.useState("signature");
@@ -4319,6 +4384,7 @@ function SignatureFieldMenu() {
         required
       });
       close();
+      onInserted?.();
       setEmail("");
       setName("");
     } catch (failure) {
@@ -4431,65 +4497,240 @@ function SignatureFieldMenu() {
     }
   );
 }
-var SOURCE = {
-  workspace: "This workspace's house template",
-  deployment: "The house template for all workspaces",
-  builtin: "ARBI\u2019s built-in template (no house template has been set)"
-};
-function download(bytes, name) {
-  const isTemplate = !/\.docx$/i.test(name);
-  const url = URL.createObjectURL(
-    new Blob([bytes], {
-      type: isTemplate ? "application/vnd.openxmlformats-officedocument.wordprocessingml.template" : "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
-    })
-  );
-  const a = document.createElement("a");
-  a.href = url;
-  a.download = /\.(dotx|docx)$/i.test(name) ? name : `${name}.dotx`;
-  a.click();
-  setTimeout(() => URL.revokeObjectURL(url), 5e3);
-}
-function HouseTemplatePanel() {
-  const house = chunkGA5ZO4YA_cjs.useHouseTemplate();
-  if (!house) return null;
-  const summary = divergenceSummary(house.divergence);
+function DefinedTermButton() {
+  const terms = useDefinedTerms();
+  if (!terms) return null;
   return /* @__PURE__ */ jsxRuntime.jsx(
-    RibbonMenu,
+    "button",
     {
-      label: "House template",
-      className: "native-docx-style-trigger",
-      testId: "docx-house-template",
-      icon: /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-        /* @__PURE__ */ jsxRuntime.jsx("span", { className: "native-docx-style-current", children: "House template" }),
-        /* @__PURE__ */ jsxRuntime.jsx(lucideReact.ChevronDown, { size: 12, "aria-hidden": true })
-      ] }),
-      children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "native-docx-house-template", "data-testid": "docx-house-template-panel", children: [
-        /* @__PURE__ */ jsxRuntime.jsxs("p", { children: [
-          /* @__PURE__ */ jsxRuntime.jsx("strong", { children: house.template.name }),
-          /* @__PURE__ */ jsxRuntime.jsx("br", {}),
-          SOURCE[house.template.source],
-          ". New documents start from it."
-        ] }),
-        /* @__PURE__ */ jsxRuntime.jsx("p", { "data-testid": "docx-house-template-status", children: house.divergence === null ? "Comparing this document\u2019s styles\u2026" : !house.basedOnTemplate ? "This document was not started from the house template." : summary ?? "This document\u2019s styles match the house template." }),
-        /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "native-docx-house-template-actions", children: [
-          /* @__PURE__ */ jsxRuntime.jsxs("button", { type: "button", onClick: () => download(house.template.bytes, house.template.name), children: [
-            /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Download, { size: 14 }),
-            " Download template"
-          ] }),
-          house.setAsHouseTemplate && /* @__PURE__ */ jsxRuntime.jsx(
-            "button",
-            {
-              type: "button",
-              "data-testid": "docx-set-house-template",
-              onClick: () => void house.setAsHouseTemplate(),
-              children: "Use this document as the house template"
-            }
-          )
-        ] })
-      ] })
+      type: "button",
+      className: "native-docx-ribbon-trigger",
+      "aria-label": terms.labels.insert,
+      title: `${terms.labels.insert} (type @@)`,
+      "data-testid": "docx-insert-defined-term",
+      onMouseDown: (event) => event.preventDefault(),
+      onClick: (event) => terms.openPicker(event.currentTarget),
+      children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.BookA, { size: 16 })
     }
   );
 }
+var categories = [
+  { name: "Home", icon: lucideReact.Home },
+  { name: "Insert", icon: lucideReact.Plus },
+  { name: "Design", icon: lucideReact.FilePenLine },
+  { name: LAYOUT_TAB, icon: lucideReact.LayoutGrid },
+  { name: "References", icon: lucideReact.BookA },
+  { name: "Review", icon: lucideReact.ListChecks }
+];
+function DocxCommandMenu({
+  onSave,
+  badge,
+  imageGeneration
+}) {
+  const [selected, setSelected] = React4.useState("Home");
+  const contextual = useContextualTabs(selected);
+  const tab = contextual.shown;
+  const t = react.useChromeTranslate();
+  useGenerateImageTarget();
+  const allCategories = [
+    ...categories,
+    ...contextual.tabs.map((name) => ({ name, icon: name === "Table" ? lucideReact.Table : lucideReact.Image }))
+  ];
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "native-docx-ribbon native-docx-command-menu", children: [
+    /* @__PURE__ */ jsxRuntime.jsxs(react.DocxEditor.Toolbar, { t, preset: false, onSave, children: [
+      /* @__PURE__ */ jsxRuntime.jsx(
+        RibbonMenu,
+        {
+          label: "Editing tools",
+          icon: /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+            /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Menu, { size: 16 }),
+            /* @__PURE__ */ jsxRuntime.jsx("span", { children: "Editing tools" }),
+            /* @__PURE__ */ jsxRuntime.jsx(lucideReact.ChevronDown, { size: 14 })
+          ] }),
+          className: "native-docx-command-trigger",
+          popoverClassName: "native-docx-command-panel",
+          keepMounted: true,
+          restoreFocus: true,
+          children: (close) => /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "native-docx-command-layout", children: [
+            /* @__PURE__ */ jsxRuntime.jsx("nav", { className: "native-docx-command-categories", "aria-label": "Editing tool categories", children: allCategories.map(({ name, icon: Icon }) => /* @__PURE__ */ jsxRuntime.jsxs(
+              "button",
+              {
+                type: "button",
+                "aria-pressed": tab === name,
+                onClick: () => setSelected(name),
+                children: [
+                  /* @__PURE__ */ jsxRuntime.jsx(Icon, { size: 16, "aria-hidden": "true" }),
+                  /* @__PURE__ */ jsxRuntime.jsx("span", { children: name })
+                ]
+              },
+              name
+            )) }),
+            /* @__PURE__ */ jsxRuntime.jsx(
+              "div",
+              {
+                className: "native-docx-command-list",
+                role: "group",
+                "aria-label": `${tab} commands`,
+                onClick: (event) => {
+                  const target = event.target;
+                  const button = target.closest("button");
+                  const item = target.closest("[data-ribbon-item]")?.dataset.ribbonItem;
+                  const direct = /* @__PURE__ */ new Set([
+                    "home-undo",
+                    "home-redo",
+                    "home-save",
+                    "home-bold",
+                    "home-italic",
+                    "home-underline",
+                    "home-bullets",
+                    "home-numbers",
+                    "home-indent",
+                    "home-outdent",
+                    "home-strike",
+                    "home-clear",
+                    "references-footnote",
+                    "references-endnote",
+                    "references-update-cross-references",
+                    "table-row-above",
+                    "table-row-below",
+                    "table-column-left",
+                    "table-column-right"
+                  ]);
+                  if ((!button || !button.disabled) && target.closest('[aria-disabled="true"]') === null && (button && item && direct.has(item) || target.closest('[role="gridcell"]') || target.closest('[role="menuitemradio"]') || target.closest('[data-testid="docx-insert-my-signature"]') || target.closest('[data-testid="docx-insert-my-initials"]') || target.closest('.native-docx-style-gallery [role="option"]') || button && button.closest(".native-docx-style-gallery"))) {
+                    close();
+                  }
+                },
+                children: /* @__PURE__ */ jsxRuntime.jsxs(NamedCommandList, { children: [
+                  tab === "Home" && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-undo", label: "Undo", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Undo, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-redo", label: "Redo", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Redo, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-save", label: "Save", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Save, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-style", label: "Styles", children: /* @__PURE__ */ jsxRuntime.jsx(StyleGallery, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-bold", label: "Bold", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Bold, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-italic", label: "Italic", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Italic, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-underline", label: "Underline", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Underline, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-font-family", label: "Font family", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.FontFamily, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-font-size", label: "Font size", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.FontSize, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-font-color", label: "Font color", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.FontColor, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-highlight", label: "Highlight", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Highlight, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-alignment", label: "Alignment", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Alignment, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-bullets", label: "Bulleted list", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.BulletList, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-numbers", label: "Numbered list", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.NumberedList, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-line-spacing", label: "Line spacing", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.LineSpacing, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-indent", label: "Increase indent", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Indent, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-outdent", label: "Decrease indent", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Outdent, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-strike", label: "Strikethrough", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Strike, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "home-clear", label: "Clear formatting", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.ClearFormatting, {}) })
+                  ] }),
+                  tab === "Insert" && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-table", label: "Table", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.TableInsert, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-picture", label: "Picture", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.ImageInsert, {}) }),
+                    imageGeneration && /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-generate-image", label: "Generate image", children: /* @__PURE__ */ jsxRuntime.jsx(GenerateImageButton, { generation: imageGeneration }) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-page-break", label: "Page break", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Button, { slotId: "insert.pageBreak" }) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-link", label: "Link", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Link, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-defined-term", label: "Defined term", children: /* @__PURE__ */ jsxRuntime.jsx(DefinedTermButton, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-quick-parts", label: "Quick Parts", children: /* @__PURE__ */ jsxRuntime.jsx(QuickParts, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-signature-field", label: "Signature field", children: /* @__PURE__ */ jsxRuntime.jsx(SignatureFieldMenu, { onInserted: close }) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-my-signature", label: "My signature", children: /* @__PURE__ */ jsxRuntime.jsx(MySignatureMenu, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-cross-reference", label: "Cross-reference", children: /* @__PURE__ */ jsxRuntime.jsx(CrossReferenceButton, {}) })
+                  ] }),
+                  /* @__PURE__ */ jsxRuntime.jsx(LayoutTabContent, { tab }),
+                  tab === "Design" && /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "design-house-template", label: "House template", children: /* @__PURE__ */ jsxRuntime.jsx(HouseTemplatePanel, {}) }),
+                  tab === "References" && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+                    /* @__PURE__ */ jsxRuntime.jsx(NoteButtons, {}),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "references-cross-reference", label: "Cross-reference", children: /* @__PURE__ */ jsxRuntime.jsx(CrossReferenceButton, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(
+                      RibbonItem,
+                      {
+                        id: "references-update-cross-references",
+                        label: "Update cross-references",
+                        children: /* @__PURE__ */ jsxRuntime.jsx(UpdateCrossReferencesButton, {})
+                      }
+                    )
+                  ] }),
+                  tab === "Review" && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "review-editing-mode", label: "Editing mode", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.EditingMode, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "review-comments", label: "Comments", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Comments, {}) }),
+                    /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "review-options", label: "Review options", children: /* @__PURE__ */ jsxRuntime.jsx(RibbonMenu, { label: "Review options", icon: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.UsersRound, { size: 16 }), children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Reviewers, {}) }) })
+                  ] })
+                ] })
+              }
+            )
+          ] })
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.TableCellFill, { hidden: true })
+    ] }),
+    badge && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "native-docx-ribbon-badge", "data-testid": "docx-ribbon-badge", children: badge })
+  ] });
+}
+var contains = (node, id) => node.id === id || (node.children ?? []).some((child) => contains(child, id));
+function firstParagraph(node) {
+  for (const child of node.children ?? []) {
+    if (child.kind === "paragraph" && child.id) return child.id;
+    if (child.localName === "tbl") continue;
+    const nested = firstParagraph(child);
+    if (nested) return nested;
+  }
+  return null;
+}
+function tableCells(root, paragraphId) {
+  let table = null;
+  const find = (node) => {
+    if (node.localName === "tbl" && contains(node, paragraphId)) table = node;
+    for (const child of node.children ?? []) if (contains(child, paragraphId)) find(child);
+  };
+  find(root);
+  if (!table) return null;
+  const cells = [];
+  let index = -1;
+  const rows = (node) => (node.children ?? []).flatMap(
+    (child) => child.localName === "tr" ? [child] : child.localName === "tbl" ? [] : rows(child)
+  );
+  for (const row of rows(table))
+    for (const cell of (row.children ?? []).filter((child) => child.localName === "tc")) {
+      const first = firstParagraph(cell);
+      if (!first) continue;
+      if (contains(cell, paragraphId)) index = cells.length;
+      cells.push(first);
+    }
+  return index < 0 ? null : { cells, index };
+}
+function TableTabKeys({ scope }) {
+  const editor = react.useDocxEditor();
+  const latest = React4.useRef(editor);
+  latest.current = editor;
+  React4.useEffect(() => {
+    const element = scope.current;
+    if (!element) return;
+    const onKeyDown = (event) => {
+      if (event.key !== "Tab" || event.ctrlKey || event.metaKey || event.altKey) return;
+      const editor2 = latest.current;
+      const surface = editor2?.surface;
+      const head = surface?.state().selection?.head;
+      if (!editor2 || !surface || !head) return;
+      const root = () => surface.session.part().root;
+      const table = tableCells(root(), head.paragraphId);
+      if (!table) return;
+      event.preventDefault();
+      event.stopPropagation();
+      let target = table.cells[table.index + (event.shiftKey ? -1 : 1)];
+      if (!target && !event.shiftKey && editor2.exec({ type: "insertRow", where: "below" }).ok) {
+        const grown = tableCells(
+          root(),
+          surface.state().selection?.head.paragraphId ?? head.paragraphId
+        );
+        target = grown?.cells[table.cells.length] ?? "";
+      }
+      if (!target) return;
+      const point = { paragraphId: target, offset: 0 };
+      surface.setSelection({ anchor: point, head: point });
+    };
+    element.addEventListener("keydown", onKeyDown, true);
+    return () => element.removeEventListener("keydown", onKeyDown, true);
+  }, [scope]);
+  return null;
+}
 var drafts = /* @__PURE__ */ new Map();
 var stateBytes = (room) => Y__namespace.encodeStateAsUpdate(room.ydoc);
 var encodeState = (room) => {
@@ -4524,12 +4765,21 @@ var EditorBoundary = class extends React4__default.default.Component {
     ] }) : this.props.children;
   }
 };
-function RoomInputBinding({ session }) {
+function RoomInputBinding({
+  session,
+  flushRef
+}) {
   const editor = react.useDocxEditor();
   React4.useEffect(() => {
-    if (!editor || !session) return;
-    return session.bindEditorInput(() => editor.surface?.flushPendingInput());
-  }, [editor, session]);
+    if (!editor) return;
+    const flush = () => editor.surface?.flushPendingInput();
+    flushRef.current = flush;
+    const unbind = session?.bindEditorInput(flush);
+    return () => {
+      if (flushRef.current === flush) flushRef.current = null;
+      unbind?.();
+    };
+  }, [editor, session, flushRef]);
   return null;
 }
 function DocxParticipants({ session }) {
@@ -4676,11 +4926,14 @@ function NativeDocxEditor({
   stream,
   adapter,
   compact = false,
-  stateRef
+  stateRef,
+  saveRef
 }) {
   const [ready, setReady] = React4.useState(), [error, setError] = React4.useState(""), [retry, setRetry] = React4.useState(0);
   const [status, setStatus] = React4.useState("Connecting\u2026"), [dirty, setDirty] = React4.useState(false), [saving, setSaving] = React4.useState(false), [offline, setOffline] = React4.useState(false);
   const revision = React4.useRef(0);
+  const savingRef = React4.useRef(false);
+  const flushInputRef = React4.useRef(null);
   const stageRef = React4.useRef(null), fitCleanup = React4.useRef(void 0), refit = React4.useRef(void 0);
   const fitting = React4.useRef(true), fitted = React4.useRef(void 0);
   const [fitWidth, setFitWidth] = React4.useState(true), [zoomPercent, setZoomPercent] = React4.useState(100);
@@ -4904,11 +5157,16 @@ function NativeDocxEditor({
     };
   }, [documentId, isDraft, ready]);
   async function saveVersion() {
-    if (!ready || saving || stream) return;
+    if (!ready || savingRef.current || stream) return false;
+    if (snapshot || !ready.canEdit) return true;
+    if (offline) return false;
+    savingRef.current = true;
     setSaving(true);
-    runBeforeSave(ref.current);
-    const atRevision = revision.current;
     try {
+      if (!flushInputRef.current) throw new Error("The editor is not ready to save yet.");
+      flushInputRef.current();
+      runBeforeSave(ref.current);
+      const atRevision = revision.current;
       const result = isDraft ? await (async () => {
         const bytes = await ref.current?.save();
         if (!bytes) throw new Error("The editor is not ready.");
@@ -4925,17 +5183,32 @@ function NativeDocxEditor({
         setDirty(false);
         drafts.delete(documentId);
       }
-      await Promise.resolve(adapter.onVersionSaved?.(result.document_ext_id)).catch(() => {
-      });
+      const savedVersion = "version" in result && typeof result.version === "number" ? result.version : void 0;
+      if (!isDraft && !savedVersion) throw new Error("Could not confirm the saved version.");
+      await adapter.onVersionSaved?.(result.document_ext_id, savedVersion);
       onSaved?.(result.document_ext_id);
+      if (revision.current !== atRevision) {
+        adapter.notify?.("The document changed while saving. Please try again.", "error");
+        return false;
+      }
       adapter.notify?.(isDraft ? "Word note saved" : "DOCX version saved", "success");
+      return savedVersion ?? true;
     } catch (e) {
       adapter.notify?.(e instanceof Error ? e.message : "Could not save this document.", "error");
       setStatus("Save failed \xB7 your draft is retained");
+      return false;
     } finally {
+      savingRef.current = false;
       setSaving(false);
     }
   }
+  React4.useEffect(() => {
+    if (!saveRef) return;
+    saveRef.current = saveVersion;
+    return () => {
+      saveRef.current = null;
+    };
+  });
   function editorReady(editor) {
     ref.current = editor;
     if (streamRef.current) {
@@ -5096,7 +5369,7 @@ function NativeDocxEditor({
                               ),
                               compact && !stream && /* @__PURE__ */ jsxRuntime.jsx(CompactToolbar, {}),
                               !compact && !stream && /* @__PURE__ */ jsxRuntime.jsx(
-                                DocxRibbon,
+                                DocxCommandMenu,
                                 {
                                   onSave: () => void saveVersion(),
                                   imageGeneration: adapter.imageGeneration && {
@@ -5137,7 +5410,13 @@ function NativeDocxEditor({
                                           getAgentStatus: adapter.getAgentStatus,
                                           requestAgent: adapter.requestAgent ? (request) => adapter.requestAgent(documentId, request) : void 0,
                                           children: [
-                                            /* @__PURE__ */ jsxRuntime.jsx(RoomInputBinding, { session: ready.room?.session }),
+                                            /* @__PURE__ */ jsxRuntime.jsx(
+                                              RoomInputBinding,
+                                              {
+                                                session: ready.room?.session,
+                                                flushRef: flushInputRef
+                                              }
+                                            ),
                                             /* @__PURE__ */ jsxRuntime.jsx(AgentUndoRoom.Provider, { value: ready.room?.ydoc ?? null, children: /* @__PURE__ */ jsxRuntime.jsx(DocxEditorReview, { children: () => /* @__PURE__ */ jsxRuntime.jsxs(DocxEditorReview.Card, { children: [
                                               /* @__PURE__ */ jsxRuntime.jsx(DocxCommentActivity, {}),
                                               /* @__PURE__ */ jsxRuntime.jsx(AgentUndo, {})
@@ -5151,7 +5430,8 @@ function NativeDocxEditor({
                                       /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.HyperLink, {}),
                                       /* @__PURE__ */ jsxRuntime.jsxs(react.DocxEditor.ContextMenu, { children: [
                                         /* @__PURE__ */ jsxRuntime.jsx(DocxContextMenuExtras, {}),
-                                        /* @__PURE__ */ jsxRuntime.jsx(MySignatureContextItems, {})
+                                        /* @__PURE__ */ jsxRuntime.jsx(MySignatureContextItems, {}),
+                                        /* @__PURE__ */ jsxRuntime.jsx(SignatureFieldContextItem, {})
                                       ] })
                                     ] }),
                                     !compact && /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.PageNumber, {})
@@ -5275,5 +5555,5 @@ exports.useDefinedTerms = useDefinedTerms;
 exports.useReview = useReview;
 exports.useReviewItem = useReviewItem;
 exports.withDirectEditing = withDirectEditing;
-//# sourceMappingURL=chunk-4ED7CNOX.cjs.map
-//# sourceMappingURL=chunk-4ED7CNOX.cjs.map
+//# sourceMappingURL=chunk-2CSLFAGF.cjs.map
+//# sourceMappingURL=chunk-2CSLFAGF.cjs.map