@arbidocs/blocks 0.4.102 → 0.4.104

package/dist/{chunk-MYALCKDR.js → chunk-W2RTZOK3.js}

@@ -1,15 +1,17 @@
 "use client";
-import { stylesXml, definitionBookmark, groupDefinitions, definitionLabels, filterTermGroups, esc, docxPackage, documentXml, definitionIdOfBookmark, compareTerms, parseDefinition } from './chunk-D3QPYKZG.js';
+import { FactPassageItem } from './chunk-HFZ45FD3.js';
+import { stylesXml, definitionBookmark, groupDefinitions, definitionLabels, filterTermGroups, esc, hyperlinkRelationship, docxPackage, documentXml, definitionIdOfBookmark, compareTerms, parseDefinition } from './chunk-EPHGD4YV.js';
 import { filterMentionCandidates, MentionMenu, findMentionQuery, listOptionId, extractMentions, useListKeyNav } from './chunk-AA3PT6KR.js';
 import { unzipSync, strFromU8, strToU8, zipSync } from 'fflate';
 import { collectReviewItems, revisionItemsOf } from '@docx-editor.dev/core/store';
-import React3, { createContext, useContext, useState, useRef, useCallback, useEffect, useLayoutEffect, useMemo, useSyncExternalStore } from 'react';
+import React4, { createContext, useContext, useState, useRef, useCallback, useEffect, useLayoutEffect, useMemo, useSyncExternalStore } from 'react';
 import { useDocxEditor, ReviewRailContext, useEditorSnapshot, useEditorState, useChromeTranslate, DocxEditor, createFontSource, useParagraphStyle, normalizeImageBytes, usePageSetup, useEditorCommand } from '@docx-editor.dev/react';
-import { AiMarkdown, Dialog, DialogContent, DialogHeader, DialogTitle, cn, splitMarkdownBlocks } from '@arbidocs/react/ui';
-import { MessageSquarePlus, MessageSquare, PencilLine, ChevronLeft, ChevronRight, X, ChevronUp, ChevronDown, CheckCheck, RotateCcw, CircleCheck, Trash2, Check, SendHorizontal, Loader2, Sparkles, Type, Ellipsis, RefreshCw, WifiOff, Download, Save, BookA, Blocks, Superscript, NotebookText, Columns2, Settings2, BetweenHorizontalStart, BetweenHorizontalEnd, BetweenVerticalStart, BetweenVerticalEnd, Merge, Split, Heading, AlignVerticalJustifyStart, AlignVerticalJustifyCenter, AlignVerticalJustifyEnd, RotateCw, FlipHorizontal2, FlipVertical2, Scaling, RectangleVertical, RectangleHorizontal, FileText, SeparatorHorizontal, Captions } from 'lucide-react';
+import { AiMarkdown, Dialog, DialogContent, DialogHeader, DialogTitle, cn, DialogDescription, Button, DialogFooter, Tabs, TabsList, TabsTrigger, TabsContent, Input, splitMarkdownBlocks } from '@arbidocs/react/ui';
+import { MessageSquarePlus, MessageSquare, PencilLine, ChevronLeft, ChevronRight, X, ChevronUp, ChevronDown, CheckCheck, RotateCcw, CircleCheck, Trash2, Check, SendHorizontal, Loader2, Sparkles, Type, Pilcrow, UsersRound, RefreshCw, WifiOff, Download, Save, Ellipsis, BookA, Blocks, Link2, Superscript, NotebookText, RefreshCcw, Columns2, Settings2, BetweenHorizontalStart, BetweenHorizontalEnd, BetweenVerticalStart, BetweenVerticalEnd, Merge, Split, Heading, AlignVerticalJustifyStart, AlignVerticalJustifyCenter, AlignVerticalJustifyEnd, RotateCw, FlipHorizontal2, FlipVertical2, Scaling, RectangleVertical, RectangleHorizontal, FileText, SeparatorHorizontal, Captions } from 'lucide-react';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import { createPortal } from 'react-dom';
 import { defaultLegalTemplate, listBuildingBlocks, attachedTemplateOf, linkedLevelStyles, styleDivergence, buildingBlockFragment, fragmentClipboardHtml, trackInsertion, newFromTemplate } from '@arbidocs/coedit/template';
+import { resolveNumberingLevel, resolveStoryListItems, buildStyleCascadeTable, withNumberingStyleLinks, buildNumberingIndex } from '@docx-editor.dev/core/layout';
 import { executeImageCommand } from '@docx-editor.dev/core/editor';
 import { renderToStaticMarkup } from 'react-dom/server';
 import * as Y from 'yjs';
@@ -896,7 +898,7 @@ function DocxCommentActivity() {
   const thread = review.items.filter(
     (entry) => entry.kind === "comment" && (entry.item.id === commentId || entry.parentId === commentId)
   );
-  const statuses = Object.entries(activity).filter(([, run]) => run.commentId === commentId);
+  const statuses = Object.entries(activity).filter(([, run2]) => run2.commentId === commentId);
   const labels = {
     delivering: "Delivering mention\u2026",
     queued: "Queued\u2026",
@@ -908,18 +910,18 @@ function DocxCommentActivity() {
     unknown: "Status unavailable"
   };
   return /* @__PURE__ */ jsxs("div", { className: "native-docx-comment-extra", "data-review-selectable": "", children: [
-    statuses.map(([id, run]) => /* @__PURE__ */ jsxs(
+    statuses.map(([id, run2]) => /* @__PURE__ */ jsxs(
       "div",
       {
         role: "status",
         "data-testid": "docx-comment-agent-status",
-        "data-status": run.status,
+        "data-status": run2.status,
         className: "native-docx-comment-activity",
         children: [
-          ["delivering", "queued", "in_progress"].includes(run.status) && /* @__PURE__ */ jsx("span", { className: "native-docx-agent-spinner", "aria-hidden": "true" }),
-          run.label,
+          ["delivering", "queued", "in_progress"].includes(run2.status) && /* @__PURE__ */ jsx("span", { className: "native-docx-agent-spinner", "aria-hidden": "true" }),
+          run2.label,
           ": ",
-          labels[run.status]
+          labels[run2.status]
         ]
       },
       id
@@ -947,10 +949,10 @@ function DocxCommentActivity() {
             /* @__PURE__ */ jsx("p", { className: "text-sm font-medium", children: entry.author || "Reviewer" }),
             /* @__PURE__ */ jsx("div", { "data-testid": "docx-full-comment-text", children: /* @__PURE__ */ jsx(AiMarkdown, { allowHtml: false, children: commentText(entry) }) })
           ] }, entry.key)),
-          statuses.map(([id, run]) => /* @__PURE__ */ jsxs("p", { role: "status", className: "text-sm", children: [
-            run.label,
+          statuses.map(([id, run2]) => /* @__PURE__ */ jsxs("p", { role: "status", className: "text-sm", children: [
+            run2.label,
             ": ",
-            labels[run.status]
+            labels[run2.status]
           ] }, id))
         ]
       }
@@ -1262,9 +1264,19 @@ function DocxMentions({
   ) });
 }
 var DEFINED_TERM_STYLE = "DefinedTerm";
-var FRAGMENT_STYLES = stylesXml(
+var CROSS_REFERENCE_STYLE = "CrossReference";
+var BROKEN_CROSS_REFERENCE_STYLE = "CrossReferenceBroken";
+var CHARACTER_STYLES = {
+  [DEFINED_TERM_STYLE]: `<w:style w:type="character" w:customStyle="1" w:styleId="${DEFINED_TERM_STYLE}"><w:name w:val="Defined Term"/><w:rPr><w:u w:val="dotted" w:color="7F7F7F"/></w:rPr></w:style>`,
+  [CROSS_REFERENCE_STYLE]: `<w:style w:type="character" w:customStyle="1" w:styleId="${CROSS_REFERENCE_STYLE}"><w:name w:val="Cross Reference"/><w:rPr><w:color w:val="1F4E79"/><w:u w:val="dotted" w:color="8EA9C1"/></w:rPr></w:style>`,
+  [BROKEN_CROSS_REFERENCE_STYLE]: `<w:style w:type="character" w:customStyle="1" w:styleId="${BROKEN_CROSS_REFERENCE_STYLE}"><w:name w:val="Cross Reference Broken"/><w:basedOn w:val="${CROSS_REFERENCE_STYLE}"/><w:rPr><w:color w:val="C00000"/><w:u w:val="wave" w:color="C00000"/></w:rPr></w:style>`
+};
+function stylesUsed(body) {
+  return [...new Set([...body.matchAll(/<w:rStyle w:val="([^"]+)"/g)].map((m) => m[1]))];
+}
+var fragmentStyles = (ids) => stylesXml(
   "",
-  `<w:style w:type="paragraph" w:default="1" w:styleId="Normal"><w:name w:val="Normal"/><w:qFormat/></w:style><w:style w:type="character" w:customStyle="1" w:styleId="${DEFINED_TERM_STYLE}"><w:name w:val="Defined Term"/><w:rPr><w:u w:val="dotted" w:color="7F7F7F"/></w:rPr></w:style>`
+  `<w:style w:type="paragraph" w:default="1" w:styleId="Normal"><w:name w:val="Normal"/><w:qFormat/></w:style>${ids.map((id) => CHARACTER_STYLES[id] ?? "").join("")}`
 );
 var textRun = (text, props = "") => `<w:r>${props ? `<w:rPr>${props}</w:rPr>` : ""}<w:t xml:space="preserve">${esc(text)}</w:t></w:r>`;
 function definitionTooltip(definition) {
@@ -1292,11 +1304,16 @@ function base64(bytes) {
     binary += String.fromCharCode(...bytes.subarray(i, i + 32768));
   return btoa(binary);
 }
-function fragmentHtml(body, covered2, revision) {
+function fragmentHtml(body, covered2, {
+  revision,
+  relationships,
+  styles = stylesUsed(body)
+} = {}) {
   const untracked = docxPackage({
     document: documentXml(body),
-    styles: FRAGMENT_STYLES,
-    title: "Defined terms"
+    styles: fragmentStyles(styles),
+    title: "Defined terms",
+    relationships
   });
   const bytes = revision ? trackInsertion(untracked, revision, covered2) : untracked;
   return `<div data-docx-fragment="${base64(bytes)}" data-docx-fragment-end="${covered2 ? "covered" : "open"}"></div>`;
@@ -1395,9 +1412,93 @@ function definitionOfAnchor(anchor, definitions) {
   const id = definitionIdOfBookmark(anchor.replace(/^#/, ""));
   return id ? definitions.get(id) : void 0;
 }
+function LinkHoverCard({
+  root,
+  matches,
+  resolve,
+  onFirstHover,
+  testId
+}) {
+  const [card, setCard] = useState(null);
+  const hovered = useRef(false);
+  const latest = useRef({ matches, onFirstHover });
+  latest.current = { matches, onFirstHover };
+  useEffect(() => {
+    if (!root) return;
+    const over = (event) => {
+      const link = event.target?.closest?.(
+        "a.docx-hyperlink"
+      );
+      const href = link?.getAttribute("href") ?? "";
+      if (!link || !href || !latest.current.matches(href, link)) return;
+      if (!hovered.current) {
+        hovered.current = true;
+        latest.current.onFirstHover?.();
+      }
+      const title = link.getAttribute("title");
+      if (title) {
+        link.dataset.hoverTitle = title;
+        link.removeAttribute("title");
+      }
+      const rect = link.getBoundingClientRect();
+      setCard({
+        left: rect.left,
+        top: rect.bottom + 6,
+        href,
+        fallback: link.dataset.hoverTitle ?? ""
+      });
+    };
+    const out = (event) => {
+      const link = event.target?.closest?.("a.docx-hyperlink");
+      if (link && !link.contains(event.relatedTarget)) setCard(null);
+    };
+    const hide = () => setCard(null);
+    root.addEventListener("mouseover", over);
+    root.addEventListener("mouseout", out);
+    window.addEventListener("keydown", hide, true);
+    window.addEventListener("pointerdown", hide, true);
+    window.addEventListener("scroll", hide, true);
+    return () => {
+      root.removeEventListener("mouseover", over);
+      root.removeEventListener("mouseout", out);
+      window.removeEventListener("keydown", hide, true);
+      window.removeEventListener("pointerdown", hide, true);
+      window.removeEventListener("scroll", hide, true);
+    };
+  }, [root]);
+  if (!card) return null;
+  const content = resolve(card.href);
+  if (!content && !card.fallback) return null;
+  return createPortal(
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        role: "tooltip",
+        className: "native-docx-link-card rounded-md border border-border bg-popover p-3 text-sm text-popover-foreground shadow-lg",
+        style: {
+          position: "fixed",
+          left: Math.max(8, Math.min(card.left, window.innerWidth - 348)),
+          top: card.top,
+          width: 340,
+          zIndex: 1e3,
+          pointerEvents: "none"
+        },
+        "data-testid": testId,
+        children: content ? /* @__PURE__ */ jsxs(Fragment, { children: [
+          content.title && /* @__PURE__ */ jsx("p", { className: "font-medium", children: content.title }),
+          /* @__PURE__ */ jsx("p", { className: content.title ? "mt-1 text-muted-foreground" : void 0, children: content.body }),
+          content.footer && /* @__PURE__ */ jsx("p", { className: "mt-2 text-xs text-muted-foreground", children: content.footer })
+        ] }) : /* @__PURE__ */ jsx("p", { children: card.fallback })
+      }
+    ),
+    document.body
+  );
+}
 
 // src/docx/definitions/port.ts
+var WATCHED_STYLES = /* @__PURE__ */ new Set([BROKEN_CROSS_REFERENCE_STYLE]);
 var attr = (node, name) => node.attributes?.find((a) => a.localName === name)?.value;
+var FIELD_ATOM = "\uFFFC";
 var HEADING_STYLE = /^(heading|berschrift|titre|t[ií]tulo|titolo|kop)\s*\d/i;
 function readParagraphs(root) {
   const out = [];
@@ -1424,8 +1525,44 @@ function readParagraph(node, topLevel, bookmarks) {
   const links = [];
   let styleId;
   let outline = false;
+  let fieldDepth = 0;
+  const marks = [];
+  let runStyle;
+  const fields = [];
+  let current = null;
+  const field = (c) => {
+    const type = attr(c, "fldCharType");
+    if (type === "begin") {
+      if (fieldDepth === 0) {
+        current = { offset: text.length, instruction: "", result: "", inResult: false };
+        text += FIELD_ATOM;
+      }
+      fieldDepth++;
+    } else if (type === "separate" && fieldDepth === 1 && current) current.inResult = true;
+    else if (type === "end") {
+      fieldDepth = Math.max(0, fieldDepth - 1);
+      if (fieldDepth === 0 && current) {
+        const { offset, instruction, result } = current;
+        fields.push({ offset, instruction: instruction.trim(), result });
+        current = null;
+      }
+    }
+  };
   const walk = (n, link) => {
     for (const c of n.children ?? []) {
+      if (c.localName === "fldChar") {
+        field(c);
+        continue;
+      }
+      if (c.localName === "fldSimple") {
+        if (fieldDepth === 0) text += FIELD_ATOM;
+        continue;
+      }
+      if (c.localName === "instrText") {
+        if (fieldDepth === 1 && current)
+          current.instruction += (c.children ?? []).map((t) => t.value ?? "").join("");
+        continue;
+      }
       if (c.kind === "paragraphProperties" || c.localName === "pPr") {
         for (const p of c.children ?? []) {
           if (p.localName === "pStyle") styleId = attr(p, "val");
@@ -1434,6 +1571,14 @@ function readParagraph(node, topLevel, bookmarks) {
         continue;
       }
       if (c.localName === "delText" || c.localName === "del" || c.localName === "rPr") continue;
+      if (c.localName === "r") {
+        const rStyle = c.children?.find((x) => x.localName === "rPr")?.children?.find((x) => x.localName === "rStyle");
+        const watched = rStyle && attr(rStyle, "val");
+        runStyle = watched && WATCHED_STYLES.has(watched) ? watched : void 0;
+        walk(c, link);
+        runStyle = void 0;
+        continue;
+      }
       if (c.localName === "bookmarkStart") {
         const name = attr(c, "name");
         if (name) bookmarks.push(name);
@@ -1447,11 +1592,22 @@ function readParagraph(node, topLevel, bookmarks) {
         continue;
       }
       if (c.kind === "textValue") {
+        if (fieldDepth > 0) {
+          const open = current;
+          if (fieldDepth === 1 && open?.inResult) open.result += c.value ?? "";
+          continue;
+        }
+        if (runStyle && c.value) {
+          const last = marks[marks.length - 1];
+          if (last && last.styleId === runStyle && last.offset + last.text.length === text.length)
+            last.text += c.value;
+          else marks.push({ styleId: runStyle, offset: text.length, text: c.value });
+        }
         text += c.value ?? "";
         if (link) link.text += c.value ?? "";
         continue;
       }
-      if (c.localName === "tab") text += "	";
+      if (c.localName === "tab" && fieldDepth === 0) text += "	";
       walk(c, link);
     }
   };
@@ -1463,9 +1619,20 @@ function readParagraph(node, topLevel, bookmarks) {
     styleId,
     topLevel,
     bookmarks,
-    links
+    links,
+    ...fields.length ? { fields } : {},
+    ...marks.length ? { marks } : {}
   };
 }
+function documentStyleIds(root) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const style of root?.children ?? [])
+    if (style.localName === "style") {
+      const id = attr(style, "styleId");
+      if (id) ids.add(id);
+    }
+  return ids;
+}
 function editorPort(editor, revision) {
   const surface = () => {
     const s = editor.surface;
@@ -1485,8 +1652,17 @@ function editorPort(editor, revision) {
       surface().setSelection({ anchor: from, head: to });
       surface().deleteSelection();
     },
-    paste: (body, text, covered2) => editor.exec({ type: "paste", text, html: fragmentHtml(body, covered2, revision) }).ok,
-    splitParagraph: () => surface().splitParagraph()
+    paste: (body, text, covered2, relationships) => {
+      const defined = documentStyleIds(surface().session.stylesRoot());
+      const styles = stylesUsed(body).filter((id) => !defined.has(id));
+      return editor.exec({
+        type: "paste",
+        text,
+        html: fragmentHtml(body, covered2, { revision, relationships, styles })
+      }).ok;
+    },
+    splitParagraph: () => surface().splitParagraph(),
+    typeText: (text) => surface().insertPlainText(text)
   };
 }
 function withDirectEditing(editor, fn) {
@@ -1499,34 +1675,68 @@ function withDirectEditing(editor, fn) {
     if (mode === "suggesting") editor.setEditingMode("suggesting");
   }
 }
-function holdCaret(editor, timeoutMs = 5e3) {
+function holdCaret(editor, { settleMs = 600, maxMs = 2e3 } = {}) {
   const surface = editor.surface;
   const selection = surface?.state().selection;
   if (!surface || !selection) return;
-  const { paragraphId, offset } = selection.head;
-  const paraId = surface.session.paraIdOf(paragraphId);
+  const { offset } = selection.head;
+  const paraId = surface.session.paraIdOf(selection.head.paragraphId);
   if (!paraId) return;
+  let typed = "";
   let done = false;
+  let settle;
   const stop = () => {
     done = true;
     offChange();
-    offSelection();
-    clearTimeout(timer);
+    clearTimeout(settle);
+    clearTimeout(limit);
+    window.removeEventListener("keydown", key, true);
+    window.removeEventListener("pointerdown", click, true);
   };
-  const restore = () => {
+  const finish = () => {
     if (done) return;
-    const now = surface.state().selection;
-    const node = surface.session.nodeIdOf(paraId);
-    if (!now || !node) return;
-    if (now.head.offset !== offset || now.head.paragraphId !== paragraphId) return stop();
-    if (node === paragraphId) return;
     stop();
+    const node = surface.session.nodeIdOf(paraId);
+    if (!node) return;
     const point = { paragraphId: node, offset };
     surface.setSelection({ anchor: point, head: point });
+    if (typed) surface.insertPlainText(typed);
+  };
+  const key = (event) => {
+    if (event.key.length === 1 && !event.ctrlKey && !event.metaKey && !event.altKey) {
+      event.preventDefault();
+      event.stopPropagation();
+      typed += event.key;
+      return;
+    }
+    finish();
+  };
+  const click = () => {
+    if (typed) finish();
+    else stop();
+  };
+  const quiet = () => {
+    clearTimeout(settle);
+    settle = setTimeout(finish, settleMs);
   };
-  const offChange = editor.on("change", restore);
-  const offSelection = editor.on("selectionChange", restore);
-  const timer = setTimeout(stop, timeoutMs);
+  const offChange = editor.on("change", quiet);
+  window.addEventListener("keydown", key, true);
+  window.addEventListener("pointerdown", click, true);
+  settle = setTimeout(finish, settleMs);
+  const limit = setTimeout(finish, maxMs);
+}
+function preservingCaret(editor, fn) {
+  const surface = editor.surface;
+  const before = surface?.state().selection?.head;
+  const paraId = before && surface?.session.paraIdOf(before.paragraphId);
+  const result = fn();
+  const node = paraId && surface?.session.nodeIdOf(paraId);
+  if (before && node) {
+    const point = { paragraphId: node, offset: before.offset };
+    surface.setSelection({ anchor: point, head: point });
+    holdCaret(editor);
+  }
+  return result;
 }
 
 // src/docx/structural/trackedOrNoted.ts
@@ -1690,19 +1900,26 @@ function DefinedTermsProvider({
     },
     [notify]
   );
-  const run = useCallback(
+  const run2 = useCallback(
     (fn) => editor ? attempt(() => withDirectEditing(editor, fn)) : void 0,
     [editor, attempt]
   );
+  const typedTrigger = (port) => {
+    if (picker?.mode !== "typing") return 0;
+    const caret = port.caret();
+    const paragraph = caret && port.paragraphs().find((p) => p.id === caret.paragraphId);
+    const match = paragraph && TRIGGER_QUERY.exec(paragraph.text.slice(0, caret.offset));
+    return match ? DEFINED_TERM_TRIGGER.length + match[1].length : 0;
+  };
   const pick = useCallback(
     (row) => {
       if (!editor || !picker || !row) return;
       const port = editorPort(editor);
-      const placed = run(() => {
+      const placed = run2(() => {
         if (picker.mode === "search" && picker.caret) port.setCaret(picker.caret);
         const caret = port.caret();
         if (!caret) throw new Error("Place the cursor where the term should go.");
-        const typed = picker.mode === "typing" ? DEFINED_TERM_TRIGGER.length + picker.query.length : 0;
+        const typed = typedTrigger(port);
         if (typed) port.deleteRange({ ...caret, offset: Math.max(0, caret.offset - typed) }, caret);
         return true;
       });
@@ -1718,7 +1935,7 @@ function DefinedTermsProvider({
       if (result?.addedDefinition)
         notify?.(`\u201C${row.definition.term}\u201D added to the Definitions section.`, "success");
     },
-    [editor, picker, run, attempt, track, notify]
+    [editor, picker, run2, attempt, track, notify]
   );
   const openPicker = useCallback(
     (anchor) => {
@@ -1797,11 +2014,16 @@ function DefinedTermsProvider({
     /* @__PURE__ */ jsx("span", { ref: marker, hidden: true }),
     children,
     load && /* @__PURE__ */ jsx(
-      DefinedTermHover,
+      LinkHoverCard,
       {
         root: viewer,
-        resolve: (anchor) => definitionOfAnchor(anchor, byId),
-        onFirstHover: firstHover
+        matches: (href) => href.startsWith("#_dt_"),
+        resolve: (href) => {
+          const definition = definitionOfAnchor(href, byId);
+          return definition ? { title: definition.term, body: definition.meaning, footer: sourceOf(definition) } : null;
+        },
+        onFirstHover: firstHover,
+        testId: "docx-defined-term-card"
       }
     ),
     picker && createPortal(
@@ -1843,7 +2065,7 @@ function DefinedTermMenu({
   onClose,
   labels: l
 }) {
-  const listboxId = React3.useId();
+  const listboxId = React4.useId();
   const element = useRef(null);
   const search = picker.mode === "search";
   useEffect(() => {
@@ -1954,83 +2176,6 @@ function DefinedTermMenu({
     }
   );
 }
-function DefinedTermHover({
-  root,
-  resolve,
-  onFirstHover
-}) {
-  const [card, setCard] = useState(null);
-  const hovered = useRef(false);
-  useEffect(() => {
-    if (!root) return;
-    const over = (event) => {
-      const link = event.target?.closest?.(
-        'a.docx-hyperlink[data-docx-link-kind="internal"]'
-      );
-      const href = link?.getAttribute("href") ?? "";
-      if (!link || !href.startsWith("#_dt_")) return;
-      if (!hovered.current) {
-        hovered.current = true;
-        onFirstHover();
-      }
-      const title = link.getAttribute("title");
-      if (title) {
-        link.dataset.definition = title;
-        link.removeAttribute("title");
-      }
-      const rect = link.getBoundingClientRect();
-      setCard({
-        left: rect.left,
-        top: rect.bottom + 6,
-        anchor: href.slice(1),
-        fallback: link.dataset.definition ?? ""
-      });
-    };
-    const out = (event) => {
-      const link = event.target?.closest?.("a.docx-hyperlink");
-      if (link && !link.contains(event.relatedTarget)) setCard(null);
-    };
-    root.addEventListener("mouseover", over);
-    root.addEventListener("mouseout", out);
-    const hide = () => setCard(null);
-    window.addEventListener("keydown", hide, true);
-    window.addEventListener("pointerdown", hide, true);
-    window.addEventListener("scroll", hide, true);
-    return () => {
-      root.removeEventListener("mouseover", over);
-      root.removeEventListener("mouseout", out);
-      window.removeEventListener("keydown", hide, true);
-      window.removeEventListener("pointerdown", hide, true);
-      window.removeEventListener("scroll", hide, true);
-    };
-  }, [root, onFirstHover]);
-  if (!card) return null;
-  const definition = resolve(card.anchor);
-  return createPortal(
-    /* @__PURE__ */ jsx(
-      "div",
-      {
-        role: "tooltip",
-        className: "native-docx-term-card rounded-md border border-border bg-popover p-3 text-sm text-popover-foreground shadow-lg",
-        style: {
-          position: "fixed",
-          left: Math.max(8, Math.min(card.left, window.innerWidth - 348)),
-          top: card.top,
-          width: 340,
-          zIndex: 1e3,
-          pointerEvents: "none"
-        },
-        "data-testid": "docx-defined-term-card",
-        children: definition ? /* @__PURE__ */ jsxs(Fragment, { children: [
-          /* @__PURE__ */ jsx("p", { className: "font-medium", children: definition.term }),
-          /* @__PURE__ */ jsx("p", { className: "mt-1 text-muted-foreground", children: definition.meaning }),
-          sourceOf(definition) && /* @__PURE__ */ jsx("p", { className: "mt-2 text-xs text-muted-foreground", children: sourceOf(definition) })
-        ] }) : /* @__PURE__ */ jsx("p", { children: card.fallback })
-      }
-    ),
-    document.body
-  );
-}
 var BUILTIN_TEMPLATE_NAME = "ARBI legal template";
 var templateFileName = (t) => /\.(dotx|dotm|docx|docm)$/i.test(t.name) ? t.name : `${t.name}.dotx`;
 var builtin;
@@ -2163,13 +2308,834 @@ function HouseTemplateProvider({
   );
   return /* @__PURE__ */ jsx(HouseTemplateContext.Provider, { value: enabled ? value : null, children });
 }
+
+// src/docx/references/numbering.ts
+var numbers = (level) => !!level && level.numFmt !== "bullet" && level.numFmt !== "none" && (level.lvlText ?? level.markerText ?? "").length > 0;
+function paragraphNumber(order, items, levelOf, paragraphId) {
+  const item = items.get(paragraphId);
+  if (!item || !numbers(item)) return null;
+  const at = order.indexOf(paragraphId);
+  const markerAt = (ilvl) => {
+    if (ilvl === item.ilvl) return item.markerText;
+    for (let i = at - 1; i >= 0; i--) {
+      const other = items.get(order[i]);
+      if (other && other.numId === item.numId && other.ilvl === ilvl) return other.markerText;
+    }
+    return null;
+  };
+  const chain = [];
+  const texts = [];
+  for (let u = item.ilvl; u >= 0; u--) {
+    const level = levelOf(item.numId, u);
+    if (!level || !numbers(level)) continue;
+    if (u !== item.ilvl && texts.some((t) => t.includes(`%${u + 1}`))) continue;
+    chain.push(u);
+    texts.push(level.lvlText);
+  }
+  const value = chain.reverse().map((u) => markerAt(u) ?? "").join("");
+  if (!value) return null;
+  return value.length > 1 && value.endsWith(".") ? value.slice(0, -1) : value;
+}
+function listTargets(paragraphs, items, levelOf) {
+  const order = paragraphs.map((p) => p.id);
+  const out = [];
+  for (const p of paragraphs) {
+    const text = p.text.replace(//g, "").trim();
+    if (!text) continue;
+    const number = paragraphNumber(order, items, levelOf, p.id);
+    const item = items.get(p.id);
+    if (number !== null)
+      out.push({
+        paragraphId: p.id,
+        kind: "numbered",
+        number,
+        marker: item?.markerText ?? "",
+        text,
+        heading: p.heading,
+        level: item?.ilvl ?? 0
+      });
+    else if (p.heading)
+      out.push({
+        paragraphId: p.id,
+        kind: "heading",
+        number: null,
+        marker: "",
+        text,
+        heading: true,
+        level: 0
+      });
+  }
+  return out;
+}
+function filterTargets(targets, query) {
+  const q = query.trim().toLowerCase();
+  if (!q) return [...targets];
+  return targets.filter(
+    (t) => (t.number ?? "").toLowerCase().startsWith(q) || t.text.toLowerCase().includes(q)
+  );
+}
+
+// src/docx/references/commands.ts
+var REF_BOOKMARK_PREFIX = "_Ref";
+function newRefBookmark(taken, random = Math.random) {
+  for (; ; ) {
+    const name = `${REF_BOOKMARK_PREFIX}${String(Math.floor(random() * 9e8) + 1e8)}`;
+    if (!taken.has(name)) return name;
+  }
+}
+var styled = (style) => style ? `<w:rPr><w:rStyle w:val="${style}"/></w:rPr>` : "";
+var run = (text, style) => `<w:r>${styled(style)}<w:t xml:space="preserve">${esc(text)}</w:t></w:r>`;
+function refFieldXml(instruction, cached) {
+  const r = (inner) => `<w:r>${styled(CROSS_REFERENCE_STYLE)}${inner}</w:r>`;
+  return `${r('<w:fldChar w:fldCharType="begin"/>')}${r(
+    `<w:instrText xml:space="preserve"> ${esc(instruction)} </w:instrText>`
+  )}${r('<w:fldChar w:fldCharType="separate"/>')}${run(cached, CROSS_REFERENCE_STYLE)}${r(
+    '<w:fldChar w:fldCharType="end"/>'
+  )}`;
+}
+var refTooltip = (value, mode) => mode === "number" ? `Cross-reference to clause ${value}` : `Cross-reference to \u201C${value}\u201D`;
+function crossReferenceXml(bookmark, mode, value) {
+  return `<w:hyperlink w:anchor="${esc(bookmark)}" w:tooltip="${esc(
+    refTooltip(value, mode)
+  )}" w:history="1">${refFieldXml(refInstruction(bookmark, mode), value)}</w:hyperlink>`;
+}
+var refInstruction = (bookmark, mode) => mode === "number" ? `REF ${bookmark} \\r \\h` : `REF ${bookmark} \\h`;
+var refResult = (target, mode) => mode === "number" && target.number ? target.number : target.text;
+var allBookmarks = (port) => new Set(port.paragraphs().flatMap((p) => p.bookmarks));
+function ensureTargetBookmark(port, target, mode) {
+  const paragraph = port.paragraphs().find((p) => p.id === target.paragraphId);
+  if (!paragraph) throw new Error("That clause is no longer in the document.");
+  const existing = paragraph.bookmarks.find((b) => b.startsWith(REF_BOOKMARK_PREFIX));
+  if (existing && mode === "number") return existing;
+  const name = newRefBookmark(allBookmarks(port));
+  const start = `<w:bookmarkStart w:id="0" w:name="${name}"/>`;
+  const end = '<w:bookmarkEnd w:id="0"/>';
+  if (mode === "number") {
+    port.setCaret({ paragraphId: paragraph.id, offset: 0 });
+    if (!port.paste(`<w:p>${start}${end}</w:p>`, "", false))
+      throw new Error("The cross-reference target could not be marked.");
+    return name;
+  }
+  const runs = port.runsXml(paragraph.id);
+  if (!runs) throw new Error("This heading cannot be referred to by its text; use its number.");
+  port.deleteRange(
+    { paragraphId: paragraph.id, offset: 0 },
+    { paragraphId: paragraph.id, offset: paragraph.text.length }
+  );
+  if (!port.paste(`<w:p>${start}${runs}${end}</w:p>`, paragraph.text, false))
+    throw new Error("The cross-reference target could not be marked.");
+  return name;
+}
+function pastePoint(port, caret) {
+  const paragraph = port.paragraphs().find((p) => p.id === caret.paragraphId);
+  if (paragraph?.text[caret.offset - 1] !== FIELD_ATOM) return caret;
+  port.setCaret(caret);
+  port.typeText(" ");
+  return { paragraphId: caret.paragraphId, offset: caret.offset + 1 };
+}
+function markCrossReferenceTarget(port, target, mode) {
+  if (mode === "number" && !target.number) mode = "text";
+  const bookmark = ensureTargetBookmark(port, target, mode);
+  return { bookmark, mode, value: refResult(target, mode) };
+}
+function insertCrossReferenceField(port, { bookmark, mode, value }, caret) {
+  caret = pastePoint(port, caret);
+  port.setCaret(caret);
+  if (!port.paste(`<w:p>${crossReferenceXml(bookmark, mode, value)}</w:p>`, value, false))
+    throw new Error("The cross-reference could not be inserted.");
+  port.setCaret({ paragraphId: caret.paragraphId, offset: caret.offset + 1 });
+  return { bookmark };
+}
+function insertCrossReference(port, target, mode, caret) {
+  return insertCrossReferenceField(port, markCrossReferenceTarget(port, target, mode), caret);
+}
+var documentReferenceTooltip = (text, appName = "ARBI") => `Cross-reference: ${text} \u2014 opens in ${appName}`;
+function insertDocumentReference(port, reference, caret) {
+  const text = reference.text.trim();
+  if (!text) throw new Error("Enter the reference text.");
+  const tooltip = documentReferenceTooltip(text, reference.appName).slice(0, 255);
+  caret = pastePoint(port, caret);
+  port.setCaret(caret);
+  const link = `<w:p><w:hyperlink r:id="rIdRef1"${tooltip ? ` w:tooltip="${esc(tooltip)}"` : ""} w:history="1">${run(text, CROSS_REFERENCE_STYLE)}</w:hyperlink></w:p>`;
+  if (!port.paste(link, text, false, hyperlinkRelationship("rIdRef1", reference.url)))
+    throw new Error("The reference could not be inserted.");
+  port.setCaret({ paragraphId: caret.paragraphId, offset: caret.offset + text.length });
+}
+var REF_FIELD = /^REF\s+(\S+)((?:\s+\\[A-Za-z*]+(?:\s+MERGEFORMAT)?)*)\s*$/i;
+function staleCrossReferences(port) {
+  const paragraphs = port.paragraphs();
+  if (!paragraphs.some((p) => p.fields?.length)) return [];
+  const items = port.listItems();
+  const order = paragraphs.map((p) => p.id);
+  const owner = /* @__PURE__ */ new Map();
+  for (const p of paragraphs) for (const b of p.bookmarks) if (!owner.has(b)) owner.set(b, p.id);
+  const out = [];
+  for (const p of paragraphs)
+    for (const field of p.fields ?? []) {
+      const match = REF_FIELD.exec(field.instruction);
+      if (!match || !match[1].startsWith(REF_BOOKMARK_PREFIX)) continue;
+      const switches = match[2].toLowerCase();
+      const mode = /\\[rwn]\b/.test(switches) ? "number" : "text";
+      const target = owner.get(match[1]);
+      const base = {
+        paragraphId: p.id,
+        offset: field.offset,
+        instruction: field.instruction,
+        cached: field.result,
+        bookmark: match[1],
+        mode
+      };
+      if (!target) {
+        out.push({ ...base, value: null });
+        continue;
+      }
+      const value = /\\[rwn]\b/.test(switches) ? switches.includes("\\r") ? paragraphNumber(order, items, port.levelOf, target) : null : (paragraphs.find((x) => x.id === target)?.text ?? "").replace(//g, "").trim();
+      if (value && value !== field.result.trim()) out.push({ ...base, value });
+    }
+  return out;
+}
+function brokenCrossReferences(port) {
+  return port.paragraphs().flatMap(
+    (p) => (p.marks ?? []).filter((m) => m.styleId === BROKEN_CROSS_REFERENCE_STYLE).map((m) => ({ paragraphId: p.id, offset: m.offset, text: m.text }))
+  );
+}
+function refreshCrossReferences(port) {
+  const stale = staleCrossReferences(port).sort(
+    (a, b) => a.paragraphId === b.paragraphId ? b.offset - a.offset : 0
+  );
+  let refreshed = 0;
+  for (const ref of stale) {
+    const paragraph = port.paragraphs().find((p) => p.id === ref.paragraphId);
+    if (!paragraph || paragraph.text[ref.offset - 1] === FIELD_ATOM) continue;
+    const at = { paragraphId: ref.paragraphId, offset: ref.offset };
+    port.deleteRange(at, { paragraphId: ref.paragraphId, offset: ref.offset + 1 });
+    port.setCaret(at);
+    const text = ref.value ?? (ref.cached.trim() || ref.bookmark);
+    const body = ref.value === null ? run(text, BROKEN_CROSS_REFERENCE_STYLE) : crossReferenceXml(ref.bookmark, ref.mode, ref.value);
+    if (port.paste(`<w:p>${body}</w:p>`, text, false) && ref.value !== null) refreshed++;
+  }
+  return { refreshed, broken: brokenCrossReferences(port) };
+}
+
+// src/docx/references/passages.ts
+function shortTitle(title) {
+  const base = title.replace(/\.[A-Za-z0-9]{1,5}$/, "").trim();
+  const defined = /\(\s*(?:the\s+)?["“'‘]([^"”'’]{1,30})["”'’]\s*\)/i.exec(base);
+  return defined ? defined[1] : base;
+}
+function passageClause(text) {
+  const first = text.trim().split("\n")[0] ?? "";
+  const match = /^(?:#+\s*)?(?:\*\*)?(?:clause|section|article)?\s*(\d+(?:\.\d+)*)[.)]?(?:\*\*)?\s+\S/i.exec(
+    first
+  );
+  return match ? match[1] : null;
+}
+function referenceText(title, passage) {
+  const name = shortTitle(title);
+  const clause = passageClause(passage.text);
+  if (clause) return `${name}, clause ${clause}`;
+  if (passage.page) return `${name}, p. ${passage.page}`;
+  return name;
+}
+function passageExcerpt(text, max = 280) {
+  const plain = text.replace(/[#*_`>|]+/g, " ").replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/\s+/g, " ").trim();
+  return plain.length > max ? `${plain.slice(0, max - 1)}\u2026` : plain;
+}
+function filterPassages(passages, query) {
+  const q = query.trim().toLowerCase();
+  return q ? passages.filter((p) => p.text.toLowerCase().includes(q)) : [...passages];
+}
+var RUN_PARTS = /* @__PURE__ */ new Set(["rPr", "t", "tab", "br", "lastRenderedPageBreak"]);
+var SKIPPED = /* @__PURE__ */ new Set(["pPr", "bookmarkStart", "bookmarkEnd", "proofErr", "permStart", "permEnd"]);
+function serialize(node) {
+  if (node.kind === "textValue") return esc(node.value ?? "");
+  const name = `${node.prefix ?? "w"}:${node.localName}`;
+  const attrs = (node.attributes ?? []).map((a) => ` ${a.prefix ? `${a.prefix}:` : ""}${a.localName}="${esc(a.value)}"`).join("");
+  const children = (node.children ?? []).map((c) => serialize(c)).join("");
+  return children ? `<${name}${attrs}>${children}</${name}>` : `<${name}${attrs}/>`;
+}
+function paragraphRunsXml(paragraph) {
+  const runs = [];
+  for (const child of paragraph.children ?? []) {
+    if (child.localName && SKIPPED.has(child.localName)) continue;
+    if (child.localName !== "r") return null;
+    if ((child.children ?? []).some((c) => !c.localName || !RUN_PARTS.has(c.localName))) return null;
+    runs.push(serialize(child));
+  }
+  return runs.length ? runs.join("") : null;
+}
+function findNode2(node, id) {
+  if (node.id === id) return node;
+  for (const child of node.children ?? []) {
+    const found = findNode2(child, id);
+    if (found) return found;
+  }
+  return void 0;
+}
+function referencesPort(editor, revision) {
+  const base = editorPort(editor, revision);
+  const session = () => {
+    const s = editor.surface?.session;
+    if (!s) throw new Error("The document is not open.");
+    return s;
+  };
+  const root = () => session().part().root;
+  let numbering;
+  let cascade;
+  const index = () => {
+    if (!numbering) {
+      const s = session();
+      cascade = buildStyleCascadeTable(s.stylesRoot(), void 0, s.settingsRoot());
+      numbering = withNumberingStyleLinks(buildNumberingIndex(s.numberingRoot()), cascade);
+    }
+    return numbering;
+  };
+  return {
+    ...base,
+    listItems: () => {
+      const body = root().children?.find((n) => n.kind === "body");
+      const items = resolveStoryListItems(
+        body?.children ?? [],
+        index(),
+        cascade
+      );
+      const out = /* @__PURE__ */ new Map();
+      for (const [id, item] of items)
+        out.set(id, {
+          numId: item.numId,
+          ilvl: item.ilvl,
+          markerText: item.markerText,
+          numFmt: item.numFmt
+        });
+      return out;
+    },
+    levelOf: (numId, ilvl) => {
+      const level = resolveNumberingLevel(index(), numId, ilvl)?.level;
+      return level ? { lvlText: level.lvlText, numFmt: level.numFmt } : null;
+    },
+    runsXml: (paragraphId) => {
+      const node = findNode2(root(), paragraphId);
+      return node ? paragraphRunsXml(node) : null;
+    }
+  };
+}
+
+// src/docx/beforeSave.ts
+var hooks = /* @__PURE__ */ new WeakMap();
+function onBeforeSave(editor, fn) {
+  let set = hooks.get(editor);
+  if (!set) hooks.set(editor, set = /* @__PURE__ */ new Set());
+  set.add(fn);
+  return () => set.delete(fn);
+}
+function runBeforeSave(editor) {
+  if (!editor) return;
+  for (const fn of hooks.get(editor) ?? [])
+    try {
+      fn();
+    } catch {
+    }
+}
+var DEFAULT_CROSS_REFERENCES_LABELS = {
+  insert: "Insert cross-reference",
+  title: "Insert cross-reference",
+  description: "Refer to a clause of this document, or to a passage of another document.",
+  thisDocument: "This document",
+  otherDocument: "Another document",
+  filterTargets: "Find a clause or heading",
+  noTargets: "This document has no numbered clauses or headings yet.",
+  number: "Paragraph number",
+  text: "Heading text",
+  insertAs: "Insert",
+  chooseDocument: "Choose a document",
+  filterPassages: "Find a passage",
+  loadingPassages: "Loading passages\u2026",
+  noPassages: "No passage matches.",
+  referenceText: "Reference text",
+  insertButton: "Insert",
+  cancel: "Cancel",
+  clause: (number) => `Clause ${number}`,
+  heading: "Heading",
+  update: "Update cross-references",
+  updated: "Cross-references updated",
+  updateSummary: (refreshed) => refreshed ? `${refreshed} cross-reference${refreshed === 1 ? "" : "s"} brought up to date.` : "Every cross-reference is up to date.",
+  brokenTitle: "Broken cross-references",
+  brokenNone: "No cross-reference points at a deleted target.",
+  brokenHelp: "Their target was deleted: the last text is kept and marked. Insert the reference again to repair it.",
+  brokenCard: "Broken cross-reference",
+  brokenCardBody: "Its target was deleted. Update cross-references to mark it.",
+  show: "Show",
+  close: "Close"
+};
+var CrossReferencesContext = createContext(null);
+var useCrossReferences = () => useContext(CrossReferencesContext);
+function CrossReferencesProvider({
+  children,
+  editable,
+  references,
+  documentId,
+  notify,
+  labels
+}) {
+  const editor = useDocxEditor();
+  const track = useTrackedOrNoted();
+  const l = useMemo(() => ({ ...DEFAULT_CROSS_REFERENCES_LABELS, ...labels }), [labels]);
+  const [dialog, setDialog] = useState(
+    null
+  );
+  const marker = useRef(null);
+  const [viewer, setViewer] = useState(null);
+  useEffect(() => setViewer(marker.current?.closest(".native-docx-viewer") ?? null), []);
+  const openDialog = useCallback(() => {
+    if (!editor || !editable) return;
+    try {
+      const port = referencesPort(editor);
+      const caret = port.caret();
+      if (!caret) return notify?.("Place the cursor where the reference should go.", "error");
+      setDialog({ caret, targets: listTargets(port.paragraphs(), port.listItems(), port.levelOf) });
+    } catch (error) {
+      notify?.(error instanceof Error ? error.message : "Could not read the document.", "error");
+    }
+  }, [editor, editable, notify]);
+  const run2 = useCallback(
+    (label, prepare, insert) => {
+      if (!editor) return;
+      try {
+        const prepared = withDirectEditing(editor, prepare);
+        if (dialog) referencesPort(editor).setCaret(dialog.caret);
+        track({ label, insert: (revision) => insert(prepared, revision), inserted: () => true });
+        setDialog(null);
+        editor.surface?.focus();
+        holdCaret(editor);
+      } catch (error) {
+        notify?.(
+          error instanceof Error ? error.message : "Could not insert the reference.",
+          "error"
+        );
+      }
+    },
+    [editor, dialog, track, notify]
+  );
+  useEffect(() => {
+    if (!editor || !editable) return;
+    const refresh = () => {
+      try {
+        const port = referencesPort(editor);
+        if (!port.paragraphs().some((p) => p.fields?.length)) return;
+        preservingCaret(editor, () => withDirectEditing(editor, () => refreshCrossReferences(port)));
+      } catch {
+      }
+    };
+    const off = onBeforeSave(editor, refresh);
+    const timer = setTimeout(refresh, 1500);
+    return () => {
+      off();
+      clearTimeout(timer);
+    };
+  }, [editor, editable]);
+  const [report, setReport] = useState(null);
+  const update = useCallback(() => {
+    if (!editor || !editable) return;
+    try {
+      const result = preservingCaret(
+        editor,
+        () => withDirectEditing(editor, () => refreshCrossReferences(referencesPort(editor)))
+      );
+      setReport(result);
+    } catch (error) {
+      notify?.(
+        error instanceof Error ? error.message : "Could not update cross-references.",
+        "error"
+      );
+    }
+  }, [editor, editable, notify]);
+  const [passages, setPassages] = useState({});
+  const loadPassages = useCallback(
+    (id) => {
+      if (!references || passages[id]) return;
+      setPassages((p) => ({ ...p, [id]: "loading" }));
+      references.passages(id).then((list) => setPassages((p) => ({ ...p, [id]: list }))).catch(() => setPassages((p) => ({ ...p, [id]: [] })));
+    },
+    [references, passages]
+  );
+  useEffect(() => {
+    if (!viewer || !references) return;
+    const targetOf = (event) => {
+      const link = event.target?.closest?.(
+        'a.docx-hyperlink[data-docx-link-kind="external"]'
+      );
+      if (!link || !viewer.contains(link)) return null;
+      const mouse = event;
+      if (mouse.button !== 0 || mouse.ctrlKey || mouse.metaKey || mouse.shiftKey) return null;
+      return references.targetOf(link.getAttribute("href") ?? "");
+    };
+    const take = (event) => {
+      const target = targetOf(event);
+      if (!target) return;
+      event.preventDefault();
+      event.stopPropagation();
+      if (event.type === "click") references.open(target);
+    };
+    const types = ["pointerdown", "mousedown", "pointerup", "mouseup", "click"];
+    for (const type of types) window.addEventListener(type, take, true);
+    return () => {
+      for (const type of types) window.removeEventListener(type, take, true);
+    };
+  }, [viewer, references]);
+  const value = useMemo(
+    () => editable ? { openDialog, update, labels: l } : null,
+    [editable, openDialog, update, l]
+  );
+  const resolveInternal = (href) => {
+    if (!editor) return null;
+    const name = href.replace(/^#/, "");
+    try {
+      const port = referencesPort(editor);
+      const paragraphs = port.paragraphs();
+      const target = paragraphs.find((p) => p.bookmarks.includes(name));
+      if (!target) return { title: l.brokenCard, body: l.brokenCardBody };
+      const number = paragraphNumber(
+        paragraphs.map((p) => p.id),
+        port.listItems(),
+        port.levelOf,
+        target.id
+      );
+      return {
+        title: number ? l.clause(number) : l.heading,
+        body: passageExcerpt(target.text.replace(//g, ""))
+      };
+    } catch {
+      return null;
+    }
+  };
+  return /* @__PURE__ */ jsxs(CrossReferencesContext.Provider, { value, children: [
+    /* @__PURE__ */ jsx("span", { ref: marker, hidden: true }),
+    children,
+    /* @__PURE__ */ jsx(
+      LinkHoverCard,
+      {
+        root: viewer,
+        matches: (href) => href.startsWith(`#${REF_BOOKMARK_PREFIX}`),
+        resolve: resolveInternal,
+        testId: "docx-cross-reference-card"
+      }
+    ),
+    references && /* @__PURE__ */ jsx(
+      LinkHoverCard,
+      {
+        root: viewer,
+        matches: (href) => !!references.targetOf(href),
+        resolve: (href) => {
+          const target = references.targetOf(href);
+          if (!target) return null;
+          const list = passages[target.documentId];
+          if (!list) loadPassages(target.documentId);
+          const passage = Array.isArray(list) ? list.find((p) => p.chunkId === target.chunkId) : void 0;
+          return passage ? {
+            body: passageExcerpt(passage.text),
+            footer: passage.page ? `p. ${passage.page}` : void 0
+          } : null;
+        },
+        testId: "docx-cross-reference-card"
+      }
+    ),
+    dialog && /* @__PURE__ */ jsx(
+      CrossReferenceDialog,
+      {
+        targets: dialog.targets,
+        references,
+        documentId,
+        passages,
+        loadPassages,
+        labels: l,
+        onCancel: () => setDialog(null),
+        onClosed: () => editor?.surface?.focus(),
+        onInsertTarget: (target, mode) => run2(
+          `Inserted cross-reference: ${refResult(target, mode)}`,
+          () => markCrossReferenceTarget(referencesPort(editor), target, mode),
+          (marked, revision) => insertCrossReferenceField(referencesPort(editor, revision), marked, dialog.caret)
+        ),
+        onInsertPassage: (target, text) => run2(
+          `Inserted cross-reference: ${text}`,
+          () => void 0,
+          (_, revision) => insertDocumentReference(
+            referencesPort(editor, revision),
+            { text, url: references.linkFor(target), appName: references.appName },
+            dialog.caret
+          )
+        )
+      }
+    ),
+    /* @__PURE__ */ jsx(Dialog, { open: !!report, onOpenChange: (open) => !open && setReport(null), children: /* @__PURE__ */ jsxs(
+      DialogContent,
+      {
+        className: "max-h-[85dvh] overflow-y-auto",
+        "data-testid": "docx-cross-references-report",
+        children: [
+          /* @__PURE__ */ jsxs(DialogHeader, { children: [
+            /* @__PURE__ */ jsx(DialogTitle, { children: l.updated }),
+            /* @__PURE__ */ jsx(DialogDescription, { children: report && l.updateSummary(report.refreshed) })
+          ] }),
+          report && /* @__PURE__ */ jsxs("section", { className: "space-y-1 text-sm", children: [
+            /* @__PURE__ */ jsx("h3", { className: "font-medium", children: l.brokenTitle }),
+            report.broken.length ? /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx("p", { className: "text-muted-foreground", children: l.brokenHelp }),
+              /* @__PURE__ */ jsx("ul", { className: "space-y-1", "data-testid": "docx-cross-references-broken", children: report.broken.map((b) => /* @__PURE__ */ jsxs(
+                "li",
+                {
+                  className: "flex items-center justify-between gap-2",
+                  children: [
+                    /* @__PURE__ */ jsx("span", { className: "text-red-text", children: b.text }),
+                    /* @__PURE__ */ jsx(
+                      Button,
+                      {
+                        size: "sm",
+                        variant: "ghost",
+                        onClick: () => {
+                          const point = { paragraphId: b.paragraphId, offset: b.offset };
+                          editor?.surface?.setSelection({ anchor: point, head: point });
+                          editor?.surface?.revealParagraph(b.paragraphId);
+                          setReport(null);
+                        },
+                        children: l.show
+                      }
+                    )
+                  ]
+                },
+                `${b.paragraphId}:${b.offset}`
+              )) })
+            ] }) : /* @__PURE__ */ jsx("p", { className: "text-muted-foreground", children: l.brokenNone })
+          ] }),
+          /* @__PURE__ */ jsx(DialogFooter, { children: /* @__PURE__ */ jsx(Button, { variant: "outline", onClick: () => setReport(null), children: l.close }) })
+        ]
+      }
+    ) })
+  ] });
+}
+function CrossReferenceDialog({
+  targets,
+  references,
+  documentId,
+  passages,
+  loadPassages,
+  labels,
+  onCancel,
+  onInsertTarget,
+  onInsertPassage,
+  onClosed
+}) {
+  const l = { ...DEFAULT_CROSS_REFERENCES_LABELS, ...labels };
+  const [tab, setTab] = useState("this");
+  const [query, setQuery] = useState("");
+  const [chosen, setChosen] = useState(null);
+  const [mode, setMode] = useState("number");
+  const shown = useMemo(() => filterTargets(targets, query), [targets, query]);
+  const effectiveMode = chosen?.number ? mode : "text";
+  const [documents, setDocuments] = useState(null);
+  const [docId, setDocId] = useState(null);
+  const [passageQuery, setPassageQuery] = useState("");
+  const [passage, setPassage] = useState(null);
+  const [text, setText] = useState("");
+  useEffect(() => {
+    if (tab !== "other" || !references || documents) return;
+    references.documents().then((list2) => setDocuments(list2.filter((d) => d.id !== documentId))).catch(() => setDocuments([]));
+  }, [tab, references, documents, documentId]);
+  const chooseDocument = (id) => {
+    setDocId(id);
+    setPassage(null);
+    setText("");
+    loadPassages(id);
+  };
+  const title = documents?.find((d) => d.id === docId)?.title ?? "";
+  const list = docId ? passages[docId] : void 0;
+  const shownPassages = Array.isArray(list) ? filterPassages(list, passageQuery) : [];
+  const canInsert = tab === "this" ? !!chosen : !!(docId && passage && text.trim());
+  const insert = () => {
+    if (tab === "this" && chosen) onInsertTarget(chosen, effectiveMode);
+    if (tab === "other" && docId && passage)
+      onInsertPassage(
+        { documentId: docId, chunkId: passage.chunkId, page: passage.page ?? null },
+        text
+      );
+  };
+  return /* @__PURE__ */ jsx(Dialog, { open: true, onOpenChange: (open) => !open && onCancel(), children: /* @__PURE__ */ jsxs(
+    DialogContent,
+    {
+      className: "max-h-[85dvh] overflow-y-auto",
+      "data-testid": "docx-cross-reference-dialog",
+      onCloseAutoFocus: (event) => {
+        if (!onClosed) return;
+        event.preventDefault();
+        onClosed();
+      },
+      children: [
+        /* @__PURE__ */ jsxs(DialogHeader, { children: [
+          /* @__PURE__ */ jsx(DialogTitle, { children: l.title }),
+          /* @__PURE__ */ jsx(DialogDescription, { children: l.description })
+        ] }),
+        /* @__PURE__ */ jsxs(Tabs, { value: tab, onValueChange: (v) => setTab(v), children: [
+          /* @__PURE__ */ jsxs(TabsList, { children: [
+            /* @__PURE__ */ jsx(TabsTrigger, { value: "this", "data-testid": "docx-cross-reference-this", children: l.thisDocument }),
+            references && /* @__PURE__ */ jsx(TabsTrigger, { value: "other", "data-testid": "docx-cross-reference-other", children: l.otherDocument })
+          ] }),
+          /* @__PURE__ */ jsxs(TabsContent, { value: "this", className: "space-y-3", children: [
+            /* @__PURE__ */ jsx(
+              Input,
+              {
+                value: query,
+                placeholder: l.filterTargets,
+                "aria-label": l.filterTargets,
+                onChange: (e) => setQuery(e.target.value),
+                "data-testid": "docx-cross-reference-filter"
+              }
+            ),
+            /* @__PURE__ */ jsxs(
+              "div",
+              {
+                role: "listbox",
+                "aria-label": l.filterTargets,
+                className: "max-h-64 space-y-0.5 overflow-y-auto rounded-md border border-border p-1",
+                children: [
+                  shown.length === 0 && /* @__PURE__ */ jsx("p", { className: "p-2 text-sm text-muted-foreground", children: l.noTargets }),
+                  shown.map((t) => /* @__PURE__ */ jsxs(
+                    "button",
+                    {
+                      type: "button",
+                      role: "option",
+                      "aria-selected": chosen?.paragraphId === t.paragraphId,
+                      "data-testid": "docx-cross-reference-target",
+                      onClick: () => setChosen(t),
+                      onDoubleClick: () => onInsertTarget(t, t.number ? mode : "text"),
+                      className: cn(
+                        "flex w-full items-baseline gap-2 rounded px-2 py-1 text-left text-sm",
+                        chosen?.paragraphId === t.paragraphId ? "bg-accent" : "hover:bg-accent/50"
+                      ),
+                      style: { paddingLeft: 8 + t.level * 16 },
+                      children: [
+                        /* @__PURE__ */ jsx("span", { className: "shrink-0 font-mono text-xs text-muted-foreground", children: t.marker || l.heading }),
+                        /* @__PURE__ */ jsx("span", { className: cn("truncate", t.heading && "font-medium"), children: t.text })
+                      ]
+                    },
+                    t.paragraphId
+                  ))
+                ]
+              }
+            ),
+            chosen && /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-3 text-sm", children: [
+              /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: l.insertAs }),
+              chosen.number && /* @__PURE__ */ jsxs("label", { className: "flex items-center gap-1", children: [
+                /* @__PURE__ */ jsx(
+                  "input",
+                  {
+                    type: "radio",
+                    name: "cross-reference-mode",
+                    checked: effectiveMode === "number",
+                    onChange: () => setMode("number")
+                  }
+                ),
+                l.number
+              ] }),
+              /* @__PURE__ */ jsxs("label", { className: "flex items-center gap-1", children: [
+                /* @__PURE__ */ jsx(
+                  "input",
+                  {
+                    type: "radio",
+                    name: "cross-reference-mode",
+                    checked: effectiveMode === "text",
+                    onChange: () => setMode("text")
+                  }
+                ),
+                l.text
+              ] }),
+              /* @__PURE__ */ jsx(
+                "span",
+                {
+                  className: "ml-auto rounded bg-muted px-2 py-0.5",
+                  "data-testid": "docx-cross-reference-preview",
+                  children: refResult(chosen, effectiveMode)
+                }
+              )
+            ] })
+          ] }),
+          references && /* @__PURE__ */ jsxs(TabsContent, { value: "other", className: "space-y-3", children: [
+            references.renderDocumentPicker ? references.renderDocumentPicker(chooseDocument, docId) : /* @__PURE__ */ jsxs(
+              "select",
+              {
+                className: "h-9 w-full rounded-md border border-border bg-background px-2 text-sm",
+                "aria-label": l.chooseDocument,
+                value: docId ?? "",
+                onChange: (e) => e.target.value && chooseDocument(e.target.value),
+                "data-testid": "docx-cross-reference-document",
+                children: [
+                  /* @__PURE__ */ jsx("option", { value: "", children: l.chooseDocument }),
+                  (documents ?? []).map((d) => /* @__PURE__ */ jsx("option", { value: d.id, children: d.title }, d.id))
+                ]
+              }
+            ),
+            docId && /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx(
+                Input,
+                {
+                  value: passageQuery,
+                  placeholder: l.filterPassages,
+                  "aria-label": l.filterPassages,
+                  onChange: (e) => setPassageQuery(e.target.value),
+                  "data-testid": "docx-cross-reference-passage-filter"
+                }
+              ),
+              /* @__PURE__ */ jsx(
+                "div",
+                {
+                  className: "max-h-64 space-y-1 overflow-y-auto",
+                  "data-testid": "docx-cross-reference-passages",
+                  children: list === "loading" || list === void 0 ? /* @__PURE__ */ jsx("p", { className: "p-2 text-sm text-muted-foreground", children: l.loadingPassages }) : shownPassages.length === 0 ? /* @__PURE__ */ jsx("p", { className: "p-2 text-sm text-muted-foreground", children: l.noPassages }) : shownPassages.map((p, i) => /* @__PURE__ */ jsx(
+                    FactPassageItem,
+                    {
+                      index: i,
+                      page: p.page,
+                      excerpt: passageExcerpt(p.text, 200),
+                      isViewing: passage?.chunkId === p.chunkId,
+                      onSelect: () => {
+                        setPassage(p);
+                        setText(referenceText(title, p));
+                      },
+                      testId: "docx-cross-reference-passage"
+                    },
+                    p.chunkId
+                  ))
+                }
+              ),
+              passage && /* @__PURE__ */ jsxs("label", { className: "block space-y-1 text-sm", children: [
+                /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: l.referenceText }),
+                /* @__PURE__ */ jsx(
+                  Input,
+                  {
+                    value: text,
+                    onChange: (e) => setText(e.target.value),
+                    "data-testid": "docx-cross-reference-text"
+                  }
+                )
+              ] })
+            ] })
+          ] })
+        ] }),
+        /* @__PURE__ */ jsxs(DialogFooter, { children: [
+          /* @__PURE__ */ jsx(Button, { variant: "outline", onClick: onCancel, children: l.cancel }),
+          /* @__PURE__ */ jsx(Button, { disabled: !canInsert, onClick: insert, "data-testid": "docx-cross-reference-insert", children: l.insertButton })
+        ] })
+      ]
+    }
+  ) });
+}
 function RibbonMenu({
   label,
   icon,
   children,
   className,
   testId,
-  title
+  title,
+  keepMounted = false,
+  popoverClassName
 }) {
   const [open, setOpen] = useState(false);
   const element = useRef(null);
@@ -2203,12 +3169,13 @@ function RibbonMenu({
         children: icon
       }
     ),
-    open && /* @__PURE__ */ jsx(
+    (open || keepMounted) && /* @__PURE__ */ jsx(
       "div",
       {
-        className: "native-docx-ribbon-popover",
+        className: ["native-docx-ribbon-popover", popoverClassName].filter(Boolean).join(" "),
         role: "group",
         "aria-label": label,
+        hidden: !open,
         onMouseDown: (event) => {
           if (!(event.target instanceof HTMLInputElement || event.target instanceof HTMLSelectElement))
             event.preventDefault();
@@ -2298,7 +3265,7 @@ function GenerateImageButton({ generation }) {
   });
   const editable = useEditorState((snapshot) => snapshot.editable);
   const generating = useSyncExternalStore(subscribe, () => running > 0);
-  async function run() {
+  async function run2() {
     if (!editor || !prompt.trim() || busy) return;
     const caret = rememberCaret(editor);
     const controller = new AbortController();
@@ -2344,7 +3311,7 @@ function GenerateImageButton({ generation }) {
             className: "native-docx-form native-docx-generate-image",
             onSubmit: (event) => {
               event.preventDefault();
-              void run();
+              void run2();
             },
             children: [
               /* @__PURE__ */ jsxs("label", { children: [
@@ -2360,7 +3327,7 @@ function GenerateImageButton({ generation }) {
                     "data-testid": "docx-generate-image-prompt",
                     onChange: (event) => setPrompt(event.target.value),
                     onKeyDown: (event) => {
-                      if (event.key === "Enter" && (event.metaKey || event.ctrlKey)) void run();
+                      if (event.key === "Enter" && (event.metaKey || event.ctrlKey)) void run2();
                     }
                   }
                 )
@@ -2486,6 +3453,163 @@ var WordDraftStream = class {
   }
 };
 
+// src/docx/overflowPlan.ts
+function planOverflow(items, available, moreWidth) {
+  const collapsed = /* @__PURE__ */ new Set();
+  let used = items.reduce((sum, item) => sum + item.width, 0);
+  if (used <= available) return collapsed;
+  used += moreWidth;
+  const order = items.map((item, index) => ({ item, index })).sort((a, b) => a.item.priority - b.item.priority || b.index - a.index);
+  for (const { item } of order) {
+    if (used <= available) break;
+    collapsed.add(item.id);
+    used -= item.width;
+  }
+  return collapsed;
+}
+var Overflow = createContext(null);
+var MORE_WIDTH = 32;
+var sameSet = (a, b) => a.size === b.size && [...a].every((id) => b.has(id));
+function RibbonOverflow({ tab, children }) {
+  const row = useRef(null);
+  const items = useRef(/* @__PURE__ */ new Map());
+  const widths = useRef(/* @__PURE__ */ new Map());
+  const [version, setVersion] = useState(0);
+  const [collapsed, setCollapsed] = useState(() => /* @__PURE__ */ new Set());
+  const [slots, setSlots] = useState({});
+  const [menu, setMenu] = useState([]);
+  const register = useCallback((id, item) => {
+    items.current.set(id, item);
+    setVersion((v) => v + 1);
+    return () => {
+      if (items.current.get(id) === item) items.current.delete(id);
+      setVersion((v) => v + 1);
+    };
+  }, []);
+  const plan = useCallback(() => {
+    const element = row.current;
+    if (!element) return;
+    const gap = parseFloat(getComputedStyle(element).columnGap) || 0;
+    const ordered = Array.from(element.querySelectorAll("[data-ribbon-item]")).map((node) => node.dataset.ribbonItem).filter((id) => items.current.has(id));
+    const measured = ordered.map((id) => {
+      const { element: node, priority } = items.current.get(id);
+      if (!node.hidden) {
+        const width = node.getBoundingClientRect().width;
+        widths.current.set(id, width ? width + gap : 0);
+      }
+      return { id, priority, width: widths.current.get(id) ?? 0 };
+    });
+    const next = planOverflow(measured, element.clientWidth, MORE_WIDTH);
+    setCollapsed((current) => sameSet(current, next) ? current : next);
+    const entries = ordered.filter((id) => next.has(id)).map((id) => ({ id, label: items.current.get(id).label }));
+    setMenu(
+      (current) => current.length === entries.length && current.every((entry, i) => entry.id === entries[i].id && entry.label === entries[i].label) ? current : entries
+    );
+  }, []);
+  useLayoutEffect(plan, [plan, version, tab, collapsed]);
+  useLayoutEffect(() => {
+    const element = row.current;
+    if (!element) return;
+    const observer = new ResizeObserver(() => plan());
+    observer.observe(element);
+    for (const item of items.current.values()) observer.observe(item.element);
+    return () => observer.disconnect();
+  }, [plan, version]);
+  const slotRef = useCallback(
+    (id) => (node) => setSlots((current) => {
+      if (node ? current[id] === node : !(id in current)) return current;
+      const next = { ...current };
+      if (node) next[id] = node;
+      else delete next[id];
+      return next;
+    }),
+    []
+  );
+  const context = useMemo(() => ({ collapsed, slots, register }), [collapsed, slots, register]);
+  const shown = menu.filter((entry) => collapsed.has(entry.id));
+  return /* @__PURE__ */ jsx(Overflow.Provider, { value: context, children: /* @__PURE__ */ jsxs("div", { className: "native-docx-ribbon-row", ref: row, "data-testid": "docx-ribbon-row", children: [
+    children,
+    shown.length > 0 && /* @__PURE__ */ jsx(
+      RibbonMenu,
+      {
+        label: "More",
+        title: "More commands",
+        icon: /* @__PURE__ */ jsx(Ellipsis, { size: 16 }),
+        testId: "docx-ribbon-more",
+        keepMounted: true,
+        popoverClassName: "native-docx-ribbon-more",
+        children: (close) => /* @__PURE__ */ jsx(MoreRows, { entries: shown, slotRef, close })
+      },
+      tab
+    )
+  ] }) });
+}
+function MoreRows({
+  entries,
+  slotRef,
+  close
+}) {
+  const refs = useRef(/* @__PURE__ */ new Map());
+  const refFor = (id) => {
+    let ref = refs.current.get(id);
+    if (!ref) refs.current.set(id, ref = slotRef(id));
+    return ref;
+  };
+  const list = useRef(null);
+  const latest = useRef(close);
+  latest.current = close;
+  useEffect(() => {
+    const element = list.current;
+    if (!element) return;
+    const onClick = (event) => {
+      const target = event.target;
+      const row = target.closest(".native-docx-ribbon-more-row");
+      if (!row) return;
+      const control = row.querySelector(".native-docx-ribbon-more-control");
+      if (!control.contains(target)) {
+        control.querySelector("button:not([disabled])")?.click();
+        return;
+      }
+      const button = target.closest("button");
+      if (button && !button.disabled && !control.querySelector(".native-docx-ribbon-popover")?.contains(button) && !button.hasAttribute("aria-expanded") && !button.hasAttribute("aria-haspopup"))
+        latest.current();
+    };
+    element.addEventListener("click", onClick, true);
+    return () => element.removeEventListener("click", onClick, true);
+  }, []);
+  return /* @__PURE__ */ jsx("div", { className: "native-docx-ribbon-more-list", ref: list, children: entries.map((entry) => /* @__PURE__ */ jsxs("div", { className: "native-docx-ribbon-more-row", "data-ribbon-more": entry.id, children: [
+    /* @__PURE__ */ jsx("span", { className: "native-docx-ribbon-more-control", ref: refFor(entry.id) }),
+    /* @__PURE__ */ jsx("span", { className: "native-docx-ribbon-more-label", children: entry.label })
+  ] }, entry.id)) });
+}
+function RibbonItem({
+  id,
+  label,
+  priority = 0,
+  children
+}) {
+  const context = useContext(Overflow);
+  const element = useRef(null);
+  const register = context?.register;
+  useLayoutEffect(() => {
+    if (!register || !element.current) return;
+    return register(id, { label, priority, element: element.current });
+  }, [register, id, label, priority]);
+  if (!context) return /* @__PURE__ */ jsx(Fragment, { children });
+  const collapsed = context.collapsed.has(id);
+  const slot = context.slots[id];
+  return /* @__PURE__ */ jsx(
+    "span",
+    {
+      ref: element,
+      className: "native-docx-ribbon-item",
+      "data-ribbon-item": id,
+      hidden: collapsed || void 0,
+      children: collapsed ? slot ? createPortal(children, slot) : null : children
+    }
+  );
+}
+
 // src/docx/wordStyles.ts
 var QUICK_STYLES = ["Normal", "Title", "heading 1", "heading 2", "heading 3"];
 function findStyle(options, name) {
@@ -2671,18 +3795,87 @@ function StyleGallery() {
     }
   );
 }
+var W = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+var DEFAULT_PARAGRAPH_FONT = {
+  id: "DefaultParagraphFont",
+  type: "character",
+  xml: '<w:style w:type="character" w:default="1" w:styleId="DefaultParagraphFont"><w:name w:val="Default Paragraph Font"/><w:uiPriority w:val="1"/><w:semiHidden/><w:unhideWhenUsed/></w:style>'
+};
+function stylesOf(kind) {
+  const Kind = kind === "footnote" ? "Footnote" : "Endnote";
+  const text = `${Kind}Text`;
+  return [
+    {
+      id: text,
+      type: "paragraph",
+      xml: `<w:style w:type="paragraph" w:styleId="${text}"><w:name w:val="${kind} text"/><w:basedOn w:val="Normal"/><w:link w:val="${text}Char"/><w:uiPriority w:val="99"/><w:semiHidden/><w:unhideWhenUsed/><w:pPr><w:spacing w:after="0" w:line="240" w:lineRule="auto"/></w:pPr><w:rPr><w:sz w:val="20"/><w:szCs w:val="20"/></w:rPr></w:style>`
+    },
+    {
+      id: `${text}Char`,
+      type: "character",
+      xml: `<w:style w:type="character" w:customStyle="1" w:styleId="${text}Char"><w:name w:val="${Kind} Text Char"/><w:basedOn w:val="DefaultParagraphFont"/><w:link w:val="${text}"/><w:uiPriority w:val="99"/><w:semiHidden/><w:rPr><w:sz w:val="20"/><w:szCs w:val="20"/></w:rPr></w:style>`
+    },
+    {
+      id: `${Kind}Reference`,
+      type: "character",
+      xml: `<w:style w:type="character" w:styleId="${Kind}Reference"><w:name w:val="${kind} reference"/><w:basedOn w:val="DefaultParagraphFont"/><w:uiPriority w:val="99"/><w:semiHidden/><w:unhideWhenUsed/><w:rPr><w:vertAlign w:val="superscript"/></w:rPr></w:style>`
+    }
+  ];
+}
+function noteTextStyle(styles, kind) {
+  const paragraph = styles.filter((style) => style.type === "paragraph");
+  const id = kind === "footnote" ? "FootnoteText" : "EndnoteText";
+  return paragraph.find((style) => style.name.toLowerCase() === `${kind} text`)?.styleId ?? paragraph.find((style) => style.styleId === id)?.styleId;
+}
+function missingNoteStyles(styles, kind) {
+  const has = (type, id) => styles.some((style) => style.type === type && style.styleId === id);
+  const text = noteTextStyle(styles, kind);
+  const missing = stylesOf(kind).filter(
+    (style) => style.type === "paragraph" ? !text : !has("character", style.id)
+  );
+  if (!missing.length) return [];
+  const base = has("character", DEFAULT_PARAGRAPH_FONT.id) ? [] : [DEFAULT_PARAGRAPH_FONT];
+  return [...base, ...missing].map((style) => style.xml);
+}
+var CONTENT_TYPES = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="xml" ContentType="application/xml"/><Override PartName="/word/document.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"/><Override PartName="/word/styles.xml" ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml"/></Types>';
+function stylesOnlyClipboardHtml(styles) {
+  const fragment = zipSync({
+    "[Content_Types].xml": strToU8(CONTENT_TYPES),
+    "_rels/.rels": strToU8(
+      '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="word/document.xml"/></Relationships>'
+    ),
+    "word/document.xml": strToU8(
+      `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<w:document xmlns:w="${W}"><w:body><w:p/></w:body></w:document>`
+    ),
+    "word/_rels/document.xml.rels": strToU8(
+      '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\n<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rIdStyles" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles" Target="styles.xml"/></Relationships>'
+    ),
+    "word/styles.xml": strToU8(
+      `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<w:styles xmlns:w="${W}">${styles.join("")}</w:styles>`
+    )
+  });
+  return fragmentClipboardHtml(fragment, false);
+}
+function ensureNoteStyles(editor, kind, direct = (fn) => fn()) {
+  if (!editor.can({ type: "insertNote", noteKind: kind }).ok) return void 0;
+  const missing = missingNoteStyles(editor.getDocumentStyles(), kind);
+  if (missing.length)
+    direct(() => editor.exec({ type: "paste", text: "", html: stylesOnlyClipboardHtml(missing) }));
+  return noteTextStyle(editor.getDocumentStyles(), kind);
+}
 function useInsertNote(kind) {
   const command = useEditorCommand(kind === "footnote" ? "insert.footnote" : "insert.endnote");
-  const { options } = useParagraphStyle();
   const editor = useDocxEditor();
   const insert = () => {
+    const text = editor && ensureNoteStyles(editor, kind, (fn) => withDirectEditing(editor, fn));
     if (!command.execute()) return false;
-    const text = findStyle(options, `${kind} text`);
-    if (text && editor)
-      withDirectEditing(
-        editor,
-        () => editor.exec({ type: "setParagraphStyle", styleId: text.styleId })
-      );
+    if (editor) {
+      if (text)
+        withDirectEditing(editor, () => editor.exec({ type: "setParagraphStyle", styleId: text }));
+      editor.exec({ type: "insertText", text: " " });
+    }
     return true;
   };
   return { insert, isEnabled: command.isEnabled, disabledReason: command.disabledReason };
@@ -2694,7 +3887,7 @@ function NoteAction({
   icon
 }) {
   const note = useInsertNote(kind);
-  return /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx(RibbonItem, { id: `references-${kind}`, label, children: /* @__PURE__ */ jsx(
     DocxEditor.Toolbar.Action,
     {
       label: `${label} (${shortcut})`,
@@ -2704,7 +3897,7 @@ function NoteAction({
       onSelect: () => void note.insert(),
       className: `native-docx-insert-${kind}`
     }
-  );
+  ) });
 }
 function NoteButtons() {
   return /* @__PURE__ */ jsxs(Fragment, { children: [
@@ -2774,6 +3967,65 @@ function WordShortcuts({ scope }) {
   }, [scope]);
   return null;
 }
+function CrossReferenceButton() {
+  const references = useCrossReferences();
+  if (!references) return null;
+  return /* @__PURE__ */ jsx(
+    "button",
+    {
+      type: "button",
+      className: "native-docx-ribbon-trigger",
+      "aria-label": references.labels.insert,
+      title: references.labels.insert,
+      "data-testid": "docx-insert-cross-reference",
+      onMouseDown: (event) => event.preventDefault(),
+      onClick: () => references.openDialog(),
+      children: /* @__PURE__ */ jsx(Link2, { size: 16 })
+    }
+  );
+}
+function UpdateCrossReferencesButton() {
+  const references = useCrossReferences();
+  if (!references) return null;
+  return /* @__PURE__ */ jsx(
+    "button",
+    {
+      type: "button",
+      className: "native-docx-ribbon-trigger",
+      "aria-label": references.labels.update,
+      title: references.labels.update,
+      "data-testid": "docx-update-cross-references",
+      onMouseDown: (event) => event.preventDefault(),
+      onClick: () => references.update(),
+      children: /* @__PURE__ */ jsx(RefreshCcw, { size: 16 })
+    }
+  );
+}
+function DocxContextMenuExtras() {
+  const terms = useDefinedTerms();
+  const references = useCrossReferences();
+  if (!terms && !references) return null;
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(DocxEditor.ContextMenu.Separator, {}),
+    terms && /* @__PURE__ */ jsx(
+      DocxEditor.ContextMenu.Item,
+      {
+        label: "Insert defined term",
+        icon: /* @__PURE__ */ jsx(BookA, { size: 14 }),
+        shortcut: "@@",
+        onSelect: () => terms.openPicker()
+      }
+    ),
+    references && /* @__PURE__ */ jsx(
+      DocxEditor.ContextMenu.Item,
+      {
+        label: references.labels.insert,
+        icon: /* @__PURE__ */ jsx(Link2, { size: 14 }),
+        onSelect: () => references.openDialog()
+      }
+    )
+  ] });
+}
 
 // src/docx/layout/presets.ts
 var TWIPS_PER_INCH = 1440;
@@ -2989,10 +4241,10 @@ function LayoutButtons() {
   const [dialog, setDialog] = useState(false);
   const props = { setup: pageSetup, apply, openDialog: () => setDialog(true) };
   return /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsx(Margins, { ...props }),
-    /* @__PURE__ */ jsx(Orientation, { ...props }),
-    /* @__PURE__ */ jsx(Size, { ...props }),
-    /* @__PURE__ */ jsx(
+    /* @__PURE__ */ jsx(RibbonItem, { id: "layout-margins", label: "Margins", children: /* @__PURE__ */ jsx(Margins, { ...props }) }),
+    /* @__PURE__ */ jsx(RibbonItem, { id: "layout-orientation", label: "Orientation", children: /* @__PURE__ */ jsx(Orientation, { ...props }) }),
+    /* @__PURE__ */ jsx(RibbonItem, { id: "layout-size", label: "Size", children: /* @__PURE__ */ jsx(Size, { ...props }) }),
+    /* @__PURE__ */ jsx(RibbonItem, { id: "layout-columns", label: "Columns", children: /* @__PURE__ */ jsx(
       DocxEditor.Toolbar.Action,
       {
         label: "Columns",
@@ -3001,9 +4253,9 @@ function LayoutButtons() {
         disabledReason: COLUMNS_UNSUPPORTED,
         className: "native-docx-layout-columns"
       }
-    ),
-    /* @__PURE__ */ jsx(Breaks, {}),
-    /* @__PURE__ */ jsx(
+    ) }),
+    /* @__PURE__ */ jsx(RibbonItem, { id: "layout-breaks", label: "Breaks", children: /* @__PURE__ */ jsx(Breaks, {}) }),
+    /* @__PURE__ */ jsx(RibbonItem, { id: "layout-page-setup", label: "Page Setup\u2026", children: /* @__PURE__ */ jsx(
       DocxEditor.Toolbar.Action,
       {
         label: "Page Setup\u2026",
@@ -3011,7 +4263,7 @@ function LayoutButtons() {
         onSelect: () => setDialog(true),
         className: "native-docx-layout-page-setup"
       }
-    ),
+    ) }),
     /* @__PURE__ */ jsx(DocxEditor.PageSetupDialog, { open: dialog, onClose: () => setDialog(false) })
   ] });
 }
@@ -3038,7 +4290,7 @@ function CommandGallery({
   rows
 }) {
   const bound = useRows(rows);
-  return /* @__PURE__ */ jsx(RibbonMenu, { label, icon, testId, children: (close) => /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx(RibbonItem, { id: testId, label, children: /* @__PURE__ */ jsx(RibbonMenu, { label, icon, testId, children: (close) => /* @__PURE__ */ jsx(
     RibbonGallery,
     {
       label,
@@ -3052,7 +4304,7 @@ function CommandGallery({
       })),
       onPick: (id) => void bound.find((row) => row.id === id)?.state.execute()
     }
-  ) });
+  ) }) });
 }
 function CommandAction({
   command,
@@ -3061,7 +4313,7 @@ function CommandAction({
   testId
 }) {
   const state = useEditorCommand(command);
-  return /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx(RibbonItem, { id: `table-${testId}`, label, children: /* @__PURE__ */ jsx(
     DocxEditor.Toolbar.Action,
     {
       label,
@@ -3072,7 +4324,7 @@ function CommandAction({
       onSelect: () => void state.execute(),
       className: `native-docx-table-${testId}`
     }
-  );
+  ) });
 }
 function TableButtons() {
   return /* @__PURE__ */ jsxs(Fragment, { children: [
@@ -3172,11 +4424,11 @@ function TableButtons() {
         ]
       }
     ),
-    /* @__PURE__ */ jsx(DocxEditor.Toolbar.TableBorderTarget, {}),
-    /* @__PURE__ */ jsx(DocxEditor.Toolbar.TableBorderStyle, {}),
-    /* @__PURE__ */ jsx(DocxEditor.Toolbar.TableBorderWidth, {}),
-    /* @__PURE__ */ jsx(DocxEditor.Toolbar.TableBorderColor, {}),
-    /* @__PURE__ */ jsx(DocxEditor.Toolbar.TableCellFill, {})
+    /* @__PURE__ */ jsx(RibbonItem, { id: "table-border-target", label: "Borders", children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.TableBorderTarget, {}) }),
+    /* @__PURE__ */ jsx(RibbonItem, { id: "table-border-style", label: "Border style", children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.TableBorderStyle, {}) }),
+    /* @__PURE__ */ jsx(RibbonItem, { id: "table-border-width", label: "Border width", children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.TableBorderWidth, {}) }),
+    /* @__PURE__ */ jsx(RibbonItem, { id: "table-border-color", label: "Border color", children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.TableBorderColor, {}) }),
+    /* @__PURE__ */ jsx(RibbonItem, { id: "table-cell-fill", label: "Shading", children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.TableCellFill, {}) })
   ] });
 }
 var CAPTION_LABELS = ["Figure", "Table", "Equation"];
@@ -3208,9 +4460,9 @@ function countSeqFields(root, label, throughId) {
   return count;
 }
 function captionParagraphXml(label, number, text) {
-  const run = (value) => `<w:r><w:t xml:space="preserve">${esc(value)}</w:t></w:r>`;
+  const run2 = (value) => `<w:r><w:t xml:space="preserve">${esc(value)}</w:t></w:r>`;
   const rest = text.trim() ? `: ${text.trim()}` : "";
-  return `<w:p><w:pPr><w:pStyle w:val="Caption"/></w:pPr>${run(`${label} `)}<w:fldSimple w:instr=" SEQ ${esc(label)} \\* ARABIC "><w:r><w:t>${number}</w:t></w:r></w:fldSimple>${rest ? run(rest) : ""}</w:p>`;
+  return `<w:p><w:pPr><w:pStyle w:val="Caption"/></w:pPr>${run2(`${label} `)}<w:fldSimple w:instr=" SEQ ${esc(label)} \\* ARABIC "><w:r><w:t>${number}</w:t></w:r></w:fldSimple>${rest ? run2(rest) : ""}</w:p>`;
 }
 function base642(bytes) {
   let binary = "";
@@ -3239,7 +4491,7 @@ function TransformAction({
   icon
 }) {
   const state = useEditorCommand(TRANSFORMS[action]);
-  return /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ jsx(RibbonItem, { id: `picture-${action}`, label, children: /* @__PURE__ */ jsx(
     DocxEditor.Toolbar.Action,
     {
       label,
@@ -3249,7 +4501,7 @@ function TransformAction({
       onSelect: () => void state.execute(),
       className: `native-docx-picture-${action}`
     }
-  );
+  ) });
 }
 function insertCaption(editor, label, text, track) {
   const surface = editor.surface;
@@ -3347,9 +4599,9 @@ function CaptionButton({ defaultLabel = "Figure" }) {
 }
 function PictureButtons() {
   return /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsx(DocxEditor.Toolbar.ImageWrap, {}),
-    /* @__PURE__ */ jsx(DocxEditor.Toolbar.ImageProperties, {}),
-    /* @__PURE__ */ jsx(DocxEditor.Toolbar.ImageAltText, {}),
+    /* @__PURE__ */ jsx(RibbonItem, { id: "picture-wrap", label: "Wrap text", children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.ImageWrap, {}) }),
+    /* @__PURE__ */ jsx(RibbonItem, { id: "picture-properties", label: "Size and position", children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.ImageProperties, {}) }),
+    /* @__PURE__ */ jsx(RibbonItem, { id: "picture-alt-text", label: "Alt text", children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.ImageAltText, {}) }),
     /* @__PURE__ */ jsx(TransformAction, { action: "rotateCW", label: "Rotate right 90\xB0", icon: /* @__PURE__ */ jsx(RotateCw, { size: 16 }) }),
     /* @__PURE__ */ jsx(TransformAction, { action: "rotateCCW", label: "Rotate left 90\xB0", icon: /* @__PURE__ */ jsx(RotateCcw, { size: 16 }) }),
     /* @__PURE__ */ jsx(
@@ -3361,7 +4613,7 @@ function PictureButtons() {
       }
     ),
     /* @__PURE__ */ jsx(TransformAction, { action: "flipV", label: "Flip vertical", icon: /* @__PURE__ */ jsx(FlipVertical2, { size: 16 }) }),
-    /* @__PURE__ */ jsx(CaptionButton, {})
+    /* @__PURE__ */ jsx(RibbonItem, { id: "picture-caption", label: "Insert caption", children: /* @__PURE__ */ jsx(CaptionButton, {}) })
   ] });
 }
 var LAYOUT_TAB = "Layout";
@@ -3562,7 +4814,7 @@ function covered(room, vector, receipt) {
     }
   return true;
 }
-var EditorBoundary = class extends React3.Component {
+var EditorBoundary = class extends React4.Component {
   state = {};
   static getDerivedStateFromError(error) {
     return { error };
@@ -3624,46 +4876,53 @@ function DocxRibbon({
       /* @__PURE__ */ jsx(DocxEditor.Toolbar.Undo, {}),
       /* @__PURE__ */ jsx(DocxEditor.Toolbar.Redo, {}),
       /* @__PURE__ */ jsx(DocxEditor.Toolbar.Save, {}),
-      tab === "Home" && /* @__PURE__ */ jsxs(Fragment, { children: [
-        /* @__PURE__ */ jsx(StyleGallery, {}),
-        /* @__PURE__ */ jsx(DocxEditor.Toolbar.Bold, {}),
-        /* @__PURE__ */ jsx(DocxEditor.Toolbar.Italic, {}),
-        /* @__PURE__ */ jsx(DocxEditor.Toolbar.Underline, {}),
-        /* @__PURE__ */ jsxs(RibbonMenu, { label: "Font", icon: /* @__PURE__ */ jsx(Type, { size: 16 }), children: [
-          /* @__PURE__ */ jsx(DocxEditor.Toolbar.FontFamily, {}),
-          /* @__PURE__ */ jsx(DocxEditor.Toolbar.FontSize, {}),
-          /* @__PURE__ */ jsx(DocxEditor.Toolbar.FontColor, {}),
-          /* @__PURE__ */ jsx(DocxEditor.Toolbar.Highlight, {})
+      /* @__PURE__ */ jsxs(RibbonOverflow, { tab, children: [
+        tab === "Home" && /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(RibbonItem, { id: "home-style", label: "Styles", priority: 80, children: /* @__PURE__ */ jsx(StyleGallery, {}) }),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "home-bold", label: "Bold", priority: 100, children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.Bold, {}) }),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "home-italic", label: "Italic", priority: 95, children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.Italic, {}) }),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "home-underline", label: "Underline", priority: 90, children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.Underline, {}) }),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "home-font", label: "Font", priority: 60, children: /* @__PURE__ */ jsxs(RibbonMenu, { label: "Font", icon: /* @__PURE__ */ jsx(Type, { size: 16 }), children: [
+            /* @__PURE__ */ jsx(DocxEditor.Toolbar.FontFamily, {}),
+            /* @__PURE__ */ jsx(DocxEditor.Toolbar.FontSize, {}),
+            /* @__PURE__ */ jsx(DocxEditor.Toolbar.FontColor, {}),
+            /* @__PURE__ */ jsx(DocxEditor.Toolbar.Highlight, {})
+          ] }) }),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "home-more-formatting", label: "More formatting", priority: 50, children: /* @__PURE__ */ jsxs(RibbonMenu, { label: "More formatting", icon: /* @__PURE__ */ jsx(Pilcrow, { size: 16 }), children: [
+            /* @__PURE__ */ jsx(DocxEditor.Toolbar.Alignment, {}),
+            /* @__PURE__ */ jsx(DocxEditor.Toolbar.BulletList, {}),
+            /* @__PURE__ */ jsx(DocxEditor.Toolbar.NumberedList, {}),
+            /* @__PURE__ */ jsx(DocxEditor.Toolbar.LineSpacing, {}),
+            /* @__PURE__ */ jsx(DocxEditor.Toolbar.Indent, {}),
+            /* @__PURE__ */ jsx(DocxEditor.Toolbar.Outdent, {}),
+            /* @__PURE__ */ jsx(DocxEditor.Toolbar.Strike, {}),
+            /* @__PURE__ */ jsx(DocxEditor.Toolbar.ClearFormatting, {})
+          ] }) })
+        ] }),
+        tab === "Insert" && /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(RibbonItem, { id: "insert-table", label: "Table", children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.TableInsert, {}) }),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "insert-picture", label: "Picture", children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.ImageInsert, {}) }),
+          imageGeneration && /* @__PURE__ */ jsx(RibbonItem, { id: "insert-generate-image", label: "Generate image", children: /* @__PURE__ */ jsx(GenerateImageButton, { generation: imageGeneration }) }),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "insert-page-break", label: "Page break", children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.Button, { slotId: "insert.pageBreak" }) }),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "insert-link", label: "Link", children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.Link, {}) }),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "insert-defined-term", label: "Defined term", children: /* @__PURE__ */ jsx(DefinedTermButtons, {}) }),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "insert-quick-parts", label: "Quick Parts", children: /* @__PURE__ */ jsx(QuickParts, {}) }),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "insert-cross-reference", label: "Cross-reference", children: /* @__PURE__ */ jsx(CrossReferenceButton, {}) })
         ] }),
-        /* @__PURE__ */ jsxs(RibbonMenu, { label: "More formatting", icon: /* @__PURE__ */ jsx(Ellipsis, { size: 16 }), children: [
-          /* @__PURE__ */ jsx(DocxEditor.Toolbar.Alignment, {}),
-          /* @__PURE__ */ jsx(DocxEditor.Toolbar.BulletList, {}),
-          /* @__PURE__ */ jsx(DocxEditor.Toolbar.NumberedList, {}),
-          /* @__PURE__ */ jsx(DocxEditor.Toolbar.LineSpacing, {}),
-          /* @__PURE__ */ jsx(DocxEditor.Toolbar.Indent, {}),
-          /* @__PURE__ */ jsx(DocxEditor.Toolbar.Outdent, {}),
-          /* @__PURE__ */ jsx(DocxEditor.Toolbar.Strike, {}),
-          /* @__PURE__ */ jsx(DocxEditor.Toolbar.ClearFormatting, {})
+        /* @__PURE__ */ jsx(LayoutTabContent, { tab }),
+        tab === "Design" && /* @__PURE__ */ jsx(RibbonItem, { id: "design-house-template", label: "House template", children: /* @__PURE__ */ jsx(HouseTemplatePanel, {}) }),
+        tab === "References" && /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(NoteButtons, {}),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "references-cross-reference", label: "Cross-reference", children: /* @__PURE__ */ jsx(CrossReferenceButton, {}) }),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "references-update-cross-references", label: "Update cross-references", children: /* @__PURE__ */ jsx(UpdateCrossReferencesButton, {}) })
+        ] }),
+        tab === "Review" && /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(RibbonItem, { id: "review-editing-mode", label: "Editing mode", priority: 10, children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.EditingMode, {}) }),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "review-comments", label: "Comments", children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.Comments, {}) }),
+          /* @__PURE__ */ jsx(RibbonItem, { id: "review-options", label: "Review options", children: /* @__PURE__ */ jsx(RibbonMenu, { label: "Review options", icon: /* @__PURE__ */ jsx(UsersRound, { size: 16 }), children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.Reviewers, {}) }) })
         ] })
       ] }),
-      tab === "Insert" && /* @__PURE__ */ jsxs(Fragment, { children: [
-        /* @__PURE__ */ jsx(DocxEditor.Toolbar.TableInsert, {}),
-        /* @__PURE__ */ jsx(DocxEditor.Toolbar.ImageInsert, {}),
-        imageGeneration && /* @__PURE__ */ jsx(GenerateImageButton, { generation: imageGeneration }),
-        /* @__PURE__ */ jsx(DocxEditor.Toolbar.Button, { slotId: "insert.pageBreak" }),
-        /* @__PURE__ */ jsx(DocxEditor.Toolbar.Link, {}),
-        /* @__PURE__ */ jsx(DefinedTermButtons, {}),
-        /* @__PURE__ */ jsx(QuickParts, {})
-      ] }),
-      /* @__PURE__ */ jsx(DocxEditor.Toolbar.TableCellFill, { hidden: true }),
-      /* @__PURE__ */ jsx(LayoutTabContent, { tab }),
-      tab === "Design" && /* @__PURE__ */ jsx(HouseTemplatePanel, {}),
-      tab === "References" && /* @__PURE__ */ jsx(NoteButtons, {}),
-      tab === "Review" && /* @__PURE__ */ jsxs(Fragment, { children: [
-        /* @__PURE__ */ jsx(DocxEditor.Toolbar.EditingMode, {}),
-        /* @__PURE__ */ jsx(DocxEditor.Toolbar.Comments, {}),
-        /* @__PURE__ */ jsx(RibbonMenu, { label: "Review options", icon: /* @__PURE__ */ jsx(Ellipsis, { size: 16 }), children: /* @__PURE__ */ jsx(DocxEditor.Toolbar.Reviewers, {}) })
-      ] })
+      /* @__PURE__ */ jsx(DocxEditor.Toolbar.TableCellFill, { hidden: true })
     ] }),
     badge && /* @__PURE__ */ jsx("span", { className: "native-docx-ribbon-badge", "data-testid": "docx-ribbon-badge", children: badge })
   ] });
@@ -3860,6 +5119,7 @@ function NativeDocxEditor({
     };
   }, [dirty]);
   async function exportDocument() {
+    runBeforeSave(ref.current);
     const data = await ref.current?.save();
     if (!data) return;
     const url = URL.createObjectURL(
@@ -3886,6 +5146,7 @@ function NativeDocxEditor({
   async function saveVersion() {
     if (!ready || saving || stream) return;
     setSaving(true);
+    runBeforeSave(ref.current);
     const atRevision = revision.current;
     try {
       const result = isDraft ? await (async () => {
@@ -4009,7 +5270,7 @@ function NativeDocxEditor({
                 load: adapter.definitions,
                 editable: !stream && !snapshot && ready.canEdit,
                 notify: adapter.notify,
-                children: /* @__PURE__ */ jsxs(
+                children: /* @__PURE__ */ jsx(
                   HouseTemplateProvider,
                   {
                     enabled: !stream,
@@ -4017,67 +5278,76 @@ function NativeDocxEditor({
                     documentId: isDraft || snapshot ? void 0 : documentId,
                     editable: !stream && !snapshot && ready.canEdit,
                     notify: adapter.notify,
-                    children: [
-                      /* @__PURE__ */ jsx(
-                        DocxEditor.RevisionMarkup,
-                        {
-                          insertions: { mark: "underline", color: "blue" },
-                          deletions: { mark: "strikethrough", color: "red" },
-                          movedFrom: { mark: "doubleStrikethrough", color: "green" },
-                          movedTo: { mark: "doubleUnderline", color: "green" },
-                          trackMoves: true
-                        }
-                      ),
-                      !stream && /* @__PURE__ */ jsx(
-                        DocxRibbon,
-                        {
-                          onSave: () => void saveVersion(),
-                          imageGeneration: adapter.imageGeneration && {
-                            notify: adapter.notify,
-                            ...adapter.imageGeneration
-                          },
-                          badge: (
-                            // Says the document is shared live, in place of a title row above the ribbon.
-                            ready.room && ready.canEdit && !snapshot ? /* @__PURE__ */ jsx("span", { title: "Edits sync live with everyone who has this document open", children: "Co-edit mode" }) : void 0
+                    children: /* @__PURE__ */ jsxs(
+                      CrossReferencesProvider,
+                      {
+                        editable: !stream && !snapshot && ready.canEdit,
+                        references: adapter.references,
+                        documentId,
+                        notify: adapter.notify,
+                        children: [
+                          /* @__PURE__ */ jsx(
+                            DocxEditor.RevisionMarkup,
+                            {
+                              insertions: { mark: "underline", color: "blue" },
+                              deletions: { mark: "strikethrough", color: "red" },
+                              movedFrom: { mark: "doubleStrikethrough", color: "green" },
+                              movedTo: { mark: "doubleUnderline", color: "green" },
+                              trackMoves: true
+                            }
+                          ),
+                          !stream && /* @__PURE__ */ jsx(
+                            DocxRibbon,
+                            {
+                              onSave: () => void saveVersion(),
+                              imageGeneration: adapter.imageGeneration && {
+                                notify: adapter.notify,
+                                ...adapter.imageGeneration
+                              },
+                              badge: (
+                                // Says the document is shared live, in place of a title row above the ribbon.
+                                ready.room && ready.canEdit && !snapshot ? /* @__PURE__ */ jsx("span", { title: "Edits sync live with everyone who has this document open", children: "Co-edit mode" }) : void 0
+                              )
+                            }
+                          ),
+                          !stream && /* @__PURE__ */ jsx(WordShortcuts, { scope: stageRef }),
+                          !stream && /* @__PURE__ */ jsx(TableTabKeys, { scope: stageRef }),
+                          /* @__PURE__ */ jsxs(
+                            "div",
+                            {
+                              className: "native-docx-stage",
+                              ref: stageRef,
+                              onMouseDownCapture: (event) => {
+                                if (event.button === 2 && ref.current?.getSelectionPlacement())
+                                  event.preventDefault();
+                              },
+                              children: [
+                                /* @__PURE__ */ jsxs(DocxEditor.Viewport, { className: "native-docx-viewport", children: [
+                                  /* @__PURE__ */ jsx(DocxEditor.Content, {}),
+                                  /* @__PURE__ */ jsx(
+                                    DocxMentions,
+                                    {
+                                      initialCommentId,
+                                      mentions: adapter.mentions,
+                                      notify: adapter.notify,
+                                      getAgentStatus: adapter.getAgentStatus,
+                                      requestAgent: adapter.requestAgent ? (request) => adapter.requestAgent(documentId, request) : void 0,
+                                      children: /* @__PURE__ */ jsx(DocxEditorReview, { children: () => /* @__PURE__ */ jsx(DocxEditorReview.Card, { children: /* @__PURE__ */ jsx(DocxCommentActivity, {}) }) })
+                                    }
+                                  ),
+                                  /* @__PURE__ */ jsx(DocxEditor.HeaderFooterChrome, {}),
+                                  /* @__PURE__ */ jsx(DocxEditor.NotesChrome, {}),
+                                  /* @__PURE__ */ jsx(DocxEditor.Equation, {}),
+                                  /* @__PURE__ */ jsx(DocxEditor.HyperLink, {}),
+                                  /* @__PURE__ */ jsx(DocxEditor.ContextMenu, { children: /* @__PURE__ */ jsx(DocxContextMenuExtras, {}) })
+                                ] }),
+                                /* @__PURE__ */ jsx(DocxEditor.PageNumber, {})
+                              ]
+                            }
                           )
-                        }
-                      ),
-                      !stream && /* @__PURE__ */ jsx(WordShortcuts, { scope: stageRef }),
-                      !stream && /* @__PURE__ */ jsx(TableTabKeys, { scope: stageRef }),
-                      /* @__PURE__ */ jsxs(
-                        "div",
-                        {
-                          className: "native-docx-stage",
-                          ref: stageRef,
-                          onMouseDownCapture: (event) => {
-                            if (event.button === 2 && ref.current?.getSelectionPlacement())
-                              event.preventDefault();
-                          },
-                          children: [
-                            /* @__PURE__ */ jsxs(DocxEditor.Viewport, { className: "native-docx-viewport", children: [
-                              /* @__PURE__ */ jsx(DocxEditor.Content, {}),
-                              /* @__PURE__ */ jsx(
-                                DocxMentions,
-                                {
-                                  initialCommentId,
-                                  mentions: adapter.mentions,
-                                  notify: adapter.notify,
-                                  getAgentStatus: adapter.getAgentStatus,
-                                  requestAgent: adapter.requestAgent ? (request) => adapter.requestAgent(documentId, request) : void 0,
-                                  children: /* @__PURE__ */ jsx(DocxEditorReview, { children: () => /* @__PURE__ */ jsx(DocxEditorReview.Card, { children: /* @__PURE__ */ jsx(DocxCommentActivity, {}) }) })
-                                }
-                              ),
-                              /* @__PURE__ */ jsx(DocxEditor.HeaderFooterChrome, {}),
-                              /* @__PURE__ */ jsx(DocxEditor.NotesChrome, {}),
-                              /* @__PURE__ */ jsx(DocxEditor.Equation, {}),
-                              /* @__PURE__ */ jsx(DocxEditor.HyperLink, {}),
-                              /* @__PURE__ */ jsx(DocxEditor.ContextMenu, {})
-                            ] }),
-                            /* @__PURE__ */ jsx(DocxEditor.PageNumber, {})
-                          ]
-                        }
-                      )
-                    ]
+                        ]
+                      }
+                    )
                   }
                 )
               }
@@ -4176,6 +5446,6 @@ async function loadFonts(baseUrl) {
   };
 }
 
-export { BUILTIN_TEMPLATE_NAME, DEFAULT_DEFINED_TERMS_LABELS, DEFINED_TERM_TRIGGER, DefinedTermsProvider, DocxAuthorContext, DocxCommentActivity, DocxEditorReview, DocxMentions, DocxParticipants, DocxRibbon, GenerateImageButton, HouseTemplateProvider, NativeDocxEditor, builtinHouseTemplate, contentPath, editorPort, findDefinitionsSection, insertDefinedTerm, loadDocxFonts, normalizeDocxExport, resolveHouseTemplate, reviewModule, structuralPort, templateFileName, trackedOrNoted, useDefinedTerms, useHouseTemplate, useReview, useReviewItem, useTrackedOrNoted, withDirectEditing };
-//# sourceMappingURL=chunk-MYALCKDR.js.map
-//# sourceMappingURL=chunk-MYALCKDR.js.map
+export { BUILTIN_TEMPLATE_NAME, CrossReferenceDialog, CrossReferencesProvider, DEFAULT_CROSS_REFERENCES_LABELS, DEFAULT_DEFINED_TERMS_LABELS, DEFINED_TERM_TRIGGER, DefinedTermsProvider, DocxAuthorContext, DocxCommentActivity, DocxEditorReview, DocxMentions, DocxParticipants, DocxRibbon, GenerateImageButton, HouseTemplateProvider, LinkHoverCard, NativeDocxEditor, builtinHouseTemplate, contentPath, editorPort, findDefinitionsSection, insertCrossReference, insertDefinedTerm, insertDocumentReference, listTargets, loadDocxFonts, normalizeDocxExport, paragraphNumber, referenceText, referencesPort, resolveHouseTemplate, reviewModule, shortTitle, structuralPort, templateFileName, trackedOrNoted, useCrossReferences, useDefinedTerms, useHouseTemplate, useReview, useReviewItem, useTrackedOrNoted, withDirectEditing };
+//# sourceMappingURL=chunk-W2RTZOK3.js.map
+//# sourceMappingURL=chunk-W2RTZOK3.js.map