@arbidocs/blocks 0.4.103 → 0.4.105

package/dist/{chunk-O33EBMIX.cjs → chunk-ZWWN4CUL.cjs}

@@ -1,17 +1,19 @@
 "use client";
 'use strict';
 
-var chunkAOFATOT3_cjs = require('./chunk-AOFATOT3.cjs');
+var chunk5FYU7ZIU_cjs = require('./chunk-5FYU7ZIU.cjs');
+var chunk2A4MDHJR_cjs = require('./chunk-2A4MDHJR.cjs');
 var chunk7UTB4PHM_cjs = require('./chunk-7UTB4PHM.cjs');
 var fflate = require('fflate');
 var store = require('@docx-editor.dev/core/store');
-var React3 = require('react');
+var React4 = require('react');
 var react = require('@docx-editor.dev/react');
 var ui = require('@arbidocs/react/ui');
 var lucideReact = require('lucide-react');
 var jsxRuntime = require('react/jsx-runtime');
 var reactDom = require('react-dom');
 var template = require('@arbidocs/coedit/template');
+var layout = require('@docx-editor.dev/core/layout');
 var editor = require('@docx-editor.dev/core/editor');
 var server = require('react-dom/server');
 var Y = require('yjs');
@@ -38,7 +40,7 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
-var React3__default = /*#__PURE__*/_interopDefault(React3);
+var React4__default = /*#__PURE__*/_interopDefault(React4);
 var Y__namespace = /*#__PURE__*/_interopNamespace(Y);
 
 function normalizeDocxExport(data) {
@@ -134,10 +136,10 @@ function useReview() {
   const editor = react.useDocxEditor();
   const version = react.useEditorSnapshot(editor);
   const revision = editor?.getReviewRevision() ?? 0;
-  const items = React3.useMemo(() => editor ? editor.getReviewItems() : NONE, [editor, revision]);
+  const items = React4.useMemo(() => editor ? editor.getReviewItems() : NONE, [editor, revision]);
   const paneOpen = editor?.isReviewPaneOpen() ?? false;
   const activeKey = items.find((item) => item.isActive)?.key ?? null;
-  return React3.useMemo(
+  return React4.useMemo(
     () => ({
       ready: editor !== null,
       items,
@@ -159,9 +161,9 @@ function useReview() {
     [editor, items, activeKey, paneOpen, version]
   );
 }
-var ReviewItemContext = React3.createContext(null);
+var ReviewItemContext = React4.createContext(null);
 function useReviewItem() {
-  return React3.useContext(ReviewItemContext);
+  return React4.useContext(ReviewItemContext);
 }
 
 // src/docx/review/commentText.ts
@@ -287,7 +289,7 @@ function ReplyForm({
   review,
   onDismiss
 }) {
-  const [text, setText] = React3.useState("");
+  const [text, setText] = React4.useState("");
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "form",
     {
@@ -458,9 +460,9 @@ function Draft({
   onCancel,
   formRef
 }) {
-  const [text, setText] = React3.useState("");
-  const input = React3.useRef(null);
-  React3.useEffect(() => input.current?.focus(), []);
+  const [text, setText] = React4.useState("");
+  const input = React4.useRef(null);
+  React4.useEffect(() => input.current?.focus(), []);
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "form",
     {
@@ -510,11 +512,11 @@ function Draft({
   );
 }
 function useScrollArea(anchor, ready) {
-  const [area, setArea] = React3.useState({
+  const [area, setArea] = React4.useState({
     element: null,
     width: 0
   });
-  React3.useLayoutEffect(() => {
+  React4.useLayoutEffect(() => {
     const element = anchor.current?.closest(".docx-editor__scroll-container") ?? null;
     const measure = () => setArea(
       (previous) => previous.element === element && previous.width === (element?.clientWidth ?? 0) ? previous : { element, width: element?.clientWidth ?? 0 }
@@ -531,26 +533,26 @@ function DocxEditorReviewRail({
   children
 }) {
   const editor = react.useDocxEditor();
-  const registry = React3.useContext(react.ReviewRailContext);
+  const registry = React4.useContext(react.ReviewRailContext);
   const review = useReview();
-  const [draft, setDraft] = React3.useState(null);
-  const [tops, setTops] = React3.useState({});
-  const [showResolved, setShowResolved] = React3.useState(true);
-  const elements = React3.useRef(/* @__PURE__ */ new Map());
-  const anchor = React3.useRef(null);
-  const toolbar = React3.useRef(null);
+  const [draft, setDraft] = React4.useState(null);
+  const [tops, setTops] = React4.useState({});
+  const [showResolved, setShowResolved] = React4.useState(true);
+  const elements = React4.useRef(/* @__PURE__ */ new Map());
+  const anchor = React4.useRef(null);
+  const toolbar = React4.useRef(null);
   const area = useScrollArea(anchor, review.ready);
   const layout = area.width === 0 || area.width >= REVIEW_MARGIN_MIN_WIDTH ? "margin" : "compact";
-  const openDraft = React3.useCallback(() => {
+  const openDraft = React4.useCallback(() => {
     const placement = editor?.getSelectionPlacement();
     if (!placement) return;
     review.setPaneOpen(true);
     setDraft({ anchorY: placement.anchorY });
   }, [editor, review.setPaneOpen]);
-  React3.useEffect(() => registry?.register(), [registry]);
-  React3.useEffect(() => registry?.registerCommentDraft(openDraft), [registry, openDraft]);
-  const shownLayout = React3.useRef(null);
-  React3.useEffect(() => {
+  React4.useEffect(() => registry?.register(), [registry]);
+  React4.useEffect(() => registry?.registerCommentDraft(openDraft), [registry, openDraft]);
+  const shownLayout = React4.useRef(null);
+  React4.useEffect(() => {
     if (!review.ready || area.width === 0 || shownLayout.current === layout) return;
     editor?.setReviewPaneOptions({ opening: layout === "margin" ? "auto" : "manual" });
     const deepLinked = shownLayout.current === null && review.activeKey !== null;
@@ -566,7 +568,7 @@ function DocxEditorReviewRail({
   const changes = review.items.filter((entry) => entry.kind === "revision").length;
   const comments = top.filter((entry) => entry.kind === "comment").length;
   const hasResolved = review.items.some((entry) => entry.kind === "comment" && entry.resolved);
-  const repliesOf = React3.useCallback(
+  const repliesOf = React4.useCallback(
     (entry) => review.items.filter(
       (other) => other.kind === "comment" && (other.parentId === entry.id || other.parentRevisionId === entry.id)
     ),
@@ -574,19 +576,19 @@ function DocxEditorReviewRail({
   );
   const column = layout === "margin" && review.paneOpen && (top.length > 0 || draft !== null);
   const bubbleOpen = layout === "compact" && (review.paneOpen || draft !== null);
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     const element = area.element;
     if (!element) return;
     if (column) element.setAttribute("data-review-margin", "");
     else element.removeAttribute("data-review-margin");
     return () => element.removeAttribute("data-review-margin");
   }, [area.element, column]);
-  const dismiss = React3.useCallback(() => {
+  const dismiss = React4.useCallback(() => {
     setDraft(null);
     if (layout === "compact") review.setPaneOpen(false);
     else review.setActive(null);
   }, [layout, review.setPaneOpen, review.setActive]);
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     const element = area.element;
     if (!element || !bubbleOpen) return;
     const close = (event) => {
@@ -611,7 +613,7 @@ function DocxEditorReviewRail({
       document2.removeEventListener("keydown", escape);
     };
   }, [area.element, bubbleOpen, dismiss]);
-  React3.useLayoutEffect(() => {
+  React4.useLayoutEffect(() => {
     if (!column) return;
     const next = {};
     let floor = (toolbar.current?.offsetHeight ?? 0) + CARD_GAP;
@@ -910,18 +912,18 @@ function mentionCandidates(mentions) {
 function mentionedDocxRecipients(text, mentions) {
   return chunk7UTB4PHM_cjs.extractMentions(text, mentionCandidates(mentions)).map((person) => person.id);
 }
-var ActivityContext = React3.createContext({});
+var ActivityContext = React4.createContext({});
 function DocxCommentActivity() {
   const item = useReviewItem();
   const review = useReview();
-  const activity = React3.useContext(ActivityContext);
-  const [reading, setReading] = React3.useState(false);
+  const activity = React4.useContext(ActivityContext);
+  const [reading, setReading] = React4.useState(false);
   if (!item || item.kind !== "comment") return null;
   const commentId = item.parentId || item.item.id;
   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",
@@ -933,18 +935,18 @@ function DocxCommentActivity() {
     unknown: "Status unavailable"
   };
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "native-docx-comment-extra", "data-review-selectable": "", children: [
-    statuses.map(([id, run]) => /* @__PURE__ */ jsxRuntime.jsxs(
+    statuses.map(([id, run2]) => /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsx("span", { className: "native-docx-agent-spinner", "aria-hidden": "true" }),
-          run.label,
+          ["delivering", "queued", "in_progress"].includes(run2.status) && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "native-docx-agent-spinner", "aria-hidden": "true" }),
+          run2.label,
           ": ",
-          labels[run.status]
+          labels[run2.status]
         ]
       },
       id
@@ -972,10 +974,10 @@ function DocxCommentActivity() {
             /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-sm font-medium", children: entry.author || "Reviewer" }),
             /* @__PURE__ */ jsxRuntime.jsx("div", { "data-testid": "docx-full-comment-text", children: /* @__PURE__ */ jsxRuntime.jsx(ui.AiMarkdown, { allowHtml: false, children: commentText(entry) }) })
           ] }, entry.key)),
-          statuses.map(([id, run]) => /* @__PURE__ */ jsxRuntime.jsxs("p", { role: "status", className: "text-sm", children: [
-            run.label,
+          statuses.map(([id, run2]) => /* @__PURE__ */ jsxRuntime.jsxs("p", { role: "status", className: "text-sm", children: [
+            run2.label,
             ": ",
-            labels[run.status]
+            labels[run2.status]
           ] }, id))
         ]
       }
@@ -991,10 +993,10 @@ function DocxMentions({
   notify
 }) {
   const review = useReview();
-  const [activity, setActivity] = React3.useState({});
-  const root = React3.useRef(null);
-  const [composers, setComposers] = React3.useState([]);
-  React3.useEffect(() => {
+  const [activity, setActivity] = React4.useState({});
+  const root = React4.useRef(null);
+  const [composers, setComposers] = React4.useState([]);
+  React4.useEffect(() => {
     const element = root.current;
     if (!element || !requestAgent) return;
     const discover = () => {
@@ -1020,15 +1022,15 @@ function DocxMentions({
     field.setSelectionRange(value.length, value.length);
     setSuggestions(null);
   };
-  const alive = React3.useRef(true);
-  React3.useEffect(() => {
+  const alive = React4.useRef(true);
+  React4.useEffect(() => {
     alive.current = true;
     return () => {
       alive.current = false;
     };
   }, []);
-  const activated = React3.useRef(void 0);
-  React3.useEffect(() => {
+  const activated = React4.useRef(void 0);
+  React4.useEffect(() => {
     if (!initialCommentId || activated.current === initialCommentId || !review.ready) return;
     const target = review.items.find(
       (item) => item.kind === "comment" && item.item.id === initialCommentId
@@ -1037,16 +1039,16 @@ function DocxMentions({
     review.setPaneOpen(true);
     if (review.setActive(target.key)) activated.current = initialCommentId;
   }, [initialCommentId, review]);
-  const input = React3.useRef(null);
-  const replyTarget = React3.useRef(null);
-  const pending = React3.useRef(null);
-  const [suggestions, setSuggestions] = React3.useState(null);
-  const [selected, setSelected] = React3.useState(0);
+  const input = React4.useRef(null);
+  const replyTarget = React4.useRef(null);
+  const pending = React4.useRef(null);
+  const [suggestions, setSuggestions] = React4.useState(null);
+  const [selected, setSelected] = React4.useState(0);
   const candidates = chunk7UTB4PHM_cjs.filterMentionCandidates(
     mentionCandidates(mentions),
     suggestions?.query || ""
   ).slice(0, 8);
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     const submission = pending.current;
     if (!submission || !requestAgent) return;
     const created = review.items.find(
@@ -1287,26 +1289,36 @@ function DocxMentions({
   ) });
 }
 var DEFINED_TERM_STYLE = "DefinedTerm";
-var FRAGMENT_STYLES = chunkAOFATOT3_cjs.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) => chunk2A4MDHJR_cjs.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">${chunkAOFATOT3_cjs.esc(text)}</w:t></w:r>`;
+var textRun = (text, props = "") => `<w:r>${props ? `<w:rPr>${props}</w:rPr>` : ""}<w:t xml:space="preserve">${chunk2A4MDHJR_cjs.esc(text)}</w:t></w:r>`;
 function definitionTooltip(definition) {
   const line = `\u201C${definition.term}\u201D${definition.rest}`.replace(/\s+/g, " ").trim();
   return line.length > 255 ? `${line.slice(0, 254)}\u2026` : line;
 }
 function definitionParagraphXml(definition, bookmark, id = 0) {
-  return `<w:p><w:bookmarkStart w:id="${id}" w:name="${chunkAOFATOT3_cjs.esc(bookmark)}"/>${textRun("\u201C")}${textRun(
+  return `<w:p><w:bookmarkStart w:id="${id}" w:name="${chunk2A4MDHJR_cjs.esc(bookmark)}"/>${textRun("\u201C")}${textRun(
     definition.term,
     "<w:b/>"
   )}${textRun("\u201D")}<w:bookmarkEnd w:id="${id}"/>${textRun(definition.rest)}</w:p>`;
 }
 function headingParagraphXml(text, styleId) {
-  return styleId ? `<w:p><w:pPr><w:pStyle w:val="${chunkAOFATOT3_cjs.esc(styleId)}"/></w:pPr>${textRun(text)}</w:p>` : `<w:p><w:pPr><w:keepNext/></w:pPr>${textRun(text, "<w:b/>")}</w:p>`;
+  return styleId ? `<w:p><w:pPr><w:pStyle w:val="${chunk2A4MDHJR_cjs.esc(styleId)}"/></w:pPr>${textRun(text)}</w:p>` : `<w:p><w:pPr><w:keepNext/></w:pPr>${textRun(text, "<w:b/>")}</w:p>`;
 }
 function termLinkXml(term, bookmark, tooltip) {
-  return `<w:p><w:hyperlink w:anchor="${chunkAOFATOT3_cjs.esc(bookmark)}" w:tooltip="${chunkAOFATOT3_cjs.esc(tooltip)}" w:history="1">${textRun(
+  return `<w:p><w:hyperlink w:anchor="${chunk2A4MDHJR_cjs.esc(bookmark)}" w:tooltip="${chunk2A4MDHJR_cjs.esc(tooltip)}" w:history="1">${textRun(
     term,
     `<w:rStyle w:val="${DEFINED_TERM_STYLE}"/>`
   )}</w:hyperlink></w:p>`;
@@ -1317,11 +1329,16 @@ function base64(bytes) {
     binary += String.fromCharCode(...bytes.subarray(i, i + 32768));
   return btoa(binary);
 }
-function fragmentHtml(body, covered2, revision) {
-  const untracked = chunkAOFATOT3_cjs.docxPackage({
-    document: chunkAOFATOT3_cjs.documentXml(body),
-    styles: FRAGMENT_STYLES,
-    title: "Defined terms"
+function fragmentHtml(body, covered2, {
+  revision,
+  relationships,
+  styles = stylesUsed(body)
+} = {}) {
+  const untracked = chunk2A4MDHJR_cjs.docxPackage({
+    document: chunk2A4MDHJR_cjs.documentXml(body),
+    styles: fragmentStyles(styles),
+    title: "Defined terms",
+    relationships
   });
   const bytes = revision ? template.trackInsertion(untracked, revision, covered2) : untracked;
   return `<div data-docx-fragment="${base64(bytes)}" data-docx-fragment-end="${covered2 ? "covered" : "open"}"></div>`;
@@ -1343,14 +1360,14 @@ function findDefinitionsSection(paragraphs) {
   while (end < paragraphs.length && paragraphs[end].topLevel && !paragraphs[end].heading) end++;
   return { title, start: title + 1, end };
 }
-var termOf = (paragraph) => chunkAOFATOT3_cjs.parseDefinition(paragraph.text)?.term ?? null;
+var termOf = (paragraph) => chunk2A4MDHJR_cjs.parseDefinition(paragraph.text)?.term ?? null;
 function insertionIndex(paragraphs, section, term, skip = /* @__PURE__ */ new Set()) {
   let afterLast = section.start;
   for (let i = section.start; i < section.end; i++) {
     if (skip.has(paragraphs[i].id)) continue;
     const other = termOf(paragraphs[i]);
     if (other === null) continue;
-    if (chunkAOFATOT3_cjs.compareTerms(other, term) > 0) return i;
+    if (chunk2A4MDHJR_cjs.compareTerms(other, term) > 0) return i;
     afterLast = i + 1;
   }
   return afterLast;
@@ -1377,7 +1394,7 @@ function insertParagraphs(port, index, body, count, keep) {
 function addDefinition(port, definition, keep) {
   const paragraphs = port.paragraphs();
   const section = findDefinitionsSection(paragraphs);
-  const paragraph = definitionParagraphXml(definition, chunkAOFATOT3_cjs.definitionBookmark(definition.id));
+  const paragraph = definitionParagraphXml(definition, chunk2A4MDHJR_cjs.definitionBookmark(definition.id));
   if (section)
     return insertParagraphs(
       port,
@@ -1403,7 +1420,7 @@ function insertDefinedTerm(port, definition, options = {}) {
     caret = { paragraphId: start.paragraphId, offset: Math.max(0, start.offset - options.replace) };
     port.deleteRange(caret, start);
   }
-  const bookmark = chunkAOFATOT3_cjs.definitionBookmark(definition.id);
+  const bookmark = chunk2A4MDHJR_cjs.definitionBookmark(definition.id);
   const addedDefinition = !hasBookmark(port.paragraphs(), bookmark);
   if (addedDefinition) caret = addDefinition(port, definition, caret) ?? caret;
   port.setCaret(caret);
@@ -1417,12 +1434,96 @@ function insertDefinedTerm(port, definition, options = {}) {
   return { addedDefinition };
 }
 function definitionOfAnchor(anchor, definitions) {
-  const id = chunkAOFATOT3_cjs.definitionIdOfBookmark(anchor.replace(/^#/, ""));
+  const id = chunk2A4MDHJR_cjs.definitionIdOfBookmark(anchor.replace(/^#/, ""));
   return id ? definitions.get(id) : void 0;
 }
+function LinkHoverCard({
+  root,
+  matches,
+  resolve,
+  onFirstHover,
+  testId
+}) {
+  const [card, setCard] = React4.useState(null);
+  const hovered = React4.useRef(false);
+  const latest = React4.useRef({ matches, onFirstHover });
+  latest.current = { matches, onFirstHover };
+  React4.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 reactDom.createPortal(
+    /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+          content.title && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "font-medium", children: content.title }),
+          /* @__PURE__ */ jsxRuntime.jsx("p", { className: content.title ? "mt-1 text-muted-foreground" : void 0, children: content.body }),
+          content.footer && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "mt-2 text-xs text-muted-foreground", children: content.footer })
+        ] }) : /* @__PURE__ */ jsxRuntime.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 = [];
@@ -1449,8 +1550,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");
@@ -1459,6 +1596,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);
@@ -1472,11 +1617,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);
     }
   };
@@ -1488,9 +1644,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;
@@ -1510,8 +1677,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) {
@@ -1524,34 +1700,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
@@ -1608,11 +1818,11 @@ function structuralPort(editor) {
     }
   };
 }
-var DocxAuthorContext = React3.createContext("You");
+var DocxAuthorContext = React4.createContext("You");
 function useTrackedOrNoted() {
   const editor = react.useDocxEditor();
-  const author = React3.useContext(DocxAuthorContext);
-  return React3.useCallback(
+  const author = React4.useContext(DocxAuthorContext);
+  return React4.useCallback(
     (spec) => editor ? trackedOrNoted(structuralPort(editor), { ...spec, author }) : void 0,
     [editor, author]
   );
@@ -1632,8 +1842,8 @@ var DEFAULT_DEFINED_TERMS_LABELS = {
   preferred: "Preferred",
   alsoIn: (source) => `Also defined${source ? ` in ${source}` : ""}`
 };
-var DefinedTermsContext = React3.createContext(null);
-var useDefinedTerms = () => React3.useContext(DefinedTermsContext);
+var DefinedTermsContext = React4.createContext(null);
+var useDefinedTerms = () => React4.useContext(DefinedTermsContext);
 function rowsOf(groups) {
   return groups.flatMap(
     (group) => group.definitions.map((definition, i) => ({ group, definition, variant: i > 0 }))
@@ -1649,16 +1859,16 @@ function DefinedTermsProvider({
 }) {
   const editor = react.useDocxEditor();
   const track = useTrackedOrNoted();
-  const l = React3.useMemo(() => ({ ...DEFAULT_DEFINED_TERMS_LABELS, ...labels }), [labels]);
-  const [sources, setSources] = React3.useState(null);
-  const loadedAt = React3.useRef(0);
-  const loading = React3.useRef(null);
-  const [labelId, setLabelId] = React3.useState(null);
-  const [picker, setPicker] = React3.useState(null);
-  const [selected, setSelected] = React3.useState(0);
-  const marker = React3.useRef(null);
-  const dismissedAt = React3.useRef(null);
-  const refresh = React3.useCallback(
+  const l = React4.useMemo(() => ({ ...DEFAULT_DEFINED_TERMS_LABELS, ...labels }), [labels]);
+  const [sources, setSources] = React4.useState(null);
+  const loadedAt = React4.useRef(0);
+  const loading = React4.useRef(null);
+  const [labelId, setLabelId] = React4.useState(null);
+  const [picker, setPicker] = React4.useState(null);
+  const [selected, setSelected] = React4.useState(0);
+  const marker = React4.useRef(null);
+  const dismissedAt = React4.useRef(null);
+  const refresh = React4.useCallback(
     (force = false) => {
       if (!load) return Promise.resolve([]);
       if (!force && sources && Date.now() - loadedAt.current < STALE_AFTER_MS)
@@ -1682,29 +1892,29 @@ function DefinedTermsProvider({
     },
     [load, sources, notify]
   );
-  const all = React3.useMemo(() => chunkAOFATOT3_cjs.groupDefinitions(sources ?? []).groups, [sources]);
-  const byId = React3.useMemo(
+  const all = React4.useMemo(() => chunk2A4MDHJR_cjs.groupDefinitions(sources ?? []).groups, [sources]);
+  const byId = React4.useMemo(
     () => new Map(all.flatMap((g) => g.definitions).map((d) => [d.id, d])),
     [all]
   );
-  const agreements = React3.useMemo(() => chunkAOFATOT3_cjs.definitionLabels(sources ?? []), [sources]);
-  const groups = React3.useMemo(
-    () => picker ? chunkAOFATOT3_cjs.filterTermGroups(chunkAOFATOT3_cjs.groupDefinitions(sources ?? [], { labelId }).groups, picker.query).slice(
+  const agreements = React4.useMemo(() => chunk2A4MDHJR_cjs.definitionLabels(sources ?? []), [sources]);
+  const groups = React4.useMemo(
+    () => picker ? chunk2A4MDHJR_cjs.filterTermGroups(chunk2A4MDHJR_cjs.groupDefinitions(sources ?? [], { labelId }).groups, picker.query).slice(
       0,
       MAX_GROUPS
     ) : [],
     [sources, labelId, picker]
   );
-  const rows = React3.useMemo(() => rowsOf(groups), [groups]);
-  React3.useEffect(() => setSelected(0), [picker?.query, labelId]);
+  const rows = React4.useMemo(() => rowsOf(groups), [groups]);
+  React4.useEffect(() => setSelected(0), [picker?.query, labelId]);
   const container = () => marker.current?.closest(".native-docx-viewer") ?? document.body;
-  const [viewer, setViewer] = React3.useState(null);
-  React3.useEffect(() => setViewer(container()), []);
-  const refreshRef = React3.useRef(refresh);
+  const [viewer, setViewer] = React4.useState(null);
+  React4.useEffect(() => setViewer(container()), []);
+  const refreshRef = React4.useRef(refresh);
   refreshRef.current = refresh;
-  const firstHover = React3.useCallback(() => void refreshRef.current(), []);
+  const firstHover = React4.useCallback(() => void refreshRef.current(), []);
   const caretRect = () => container().querySelector(".docx-editor-one-surface__caret")?.getBoundingClientRect();
-  const attempt = React3.useCallback(
+  const attempt = React4.useCallback(
     (fn) => {
       try {
         return fn();
@@ -1715,19 +1925,26 @@ function DefinedTermsProvider({
     },
     [notify]
   );
-  const run = React3.useCallback(
+  const run2 = React4.useCallback(
     (fn) => editor ? attempt(() => withDirectEditing(editor, fn)) : void 0,
     [editor, attempt]
   );
-  const pick = React3.useCallback(
+  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 = React4.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;
       });
@@ -1743,9 +1960,9 @@ 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 = React3.useCallback(
+  const openPicker = React4.useCallback(
     (anchor) => {
       if (!editor || !editable) return;
       const caret = editorPort(editor).caret();
@@ -1762,7 +1979,7 @@ function DefinedTermsProvider({
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [editor, editable, refresh]
   );
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     if (!editor || !editable || !load) return;
     let frame = 0;
     const check = () => {
@@ -1797,7 +2014,7 @@ function DefinedTermsProvider({
       offSelection();
     };
   }, [editor, editable, load, refresh]);
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     if (picker?.mode !== "typing") return;
     const keys = (event) => {
       if (event.key === "Escape") {
@@ -1814,7 +2031,7 @@ function DefinedTermsProvider({
     window.addEventListener("keydown", keys, true);
     return () => window.removeEventListener("keydown", keys, true);
   }, [picker, rows, selected, pick]);
-  const value = React3.useMemo(
+  const value = React4.useMemo(
     () => load && editable ? { openPicker, labels: l } : null,
     [load, editable, openPicker, l]
   );
@@ -1822,11 +2039,16 @@ function DefinedTermsProvider({
     /* @__PURE__ */ jsxRuntime.jsx("span", { ref: marker, hidden: true }),
     children,
     load && /* @__PURE__ */ jsxRuntime.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 && reactDom.createPortal(
@@ -1868,17 +2090,17 @@ function DefinedTermMenu({
   onClose,
   labels: l
 }) {
-  const listboxId = React3__default.default.useId();
-  const element = React3.useRef(null);
+  const listboxId = React4__default.default.useId();
+  const element = React4.useRef(null);
   const search = picker.mode === "search";
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     const dismiss = (event) => {
       if (!element.current?.contains(event.target)) onClose();
     };
     document.addEventListener("pointerdown", dismiss);
     return () => document.removeEventListener("pointerdown", dismiss);
   }, [onClose]);
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     element.current?.querySelector(`[data-index="${selected}"]`)?.scrollIntoView?.({ block: "nearest" });
   }, [selected]);
   const left = Math.max(8, Math.min(picker.left, window.innerWidth - 368));
@@ -1979,83 +2201,6 @@ function DefinedTermMenu({
     }
   );
 }
-function DefinedTermHover({
-  root,
-  resolve,
-  onFirstHover
-}) {
-  const [card, setCard] = React3.useState(null);
-  const hovered = React3.useRef(false);
-  React3.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 reactDom.createPortal(
-    /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-          /* @__PURE__ */ jsxRuntime.jsx("p", { className: "font-medium", children: definition.term }),
-          /* @__PURE__ */ jsxRuntime.jsx("p", { className: "mt-1 text-muted-foreground", children: definition.meaning }),
-          sourceOf(definition) && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "mt-2 text-xs text-muted-foreground", children: sourceOf(definition) })
-        ] }) : /* @__PURE__ */ jsxRuntime.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;
@@ -2071,8 +2216,8 @@ async function resolveHouseTemplate(host) {
     return builtinHouseTemplate();
   }
 }
-var HouseTemplateContext = React3.createContext(null);
-var useHouseTemplate = () => React3.useContext(HouseTemplateContext);
+var HouseTemplateContext = React4.createContext(null);
+var useHouseTemplate = () => React4.useContext(HouseTemplateContext);
 function HouseTemplateProvider({
   host,
   documentId,
@@ -2083,26 +2228,26 @@ function HouseTemplateProvider({
 }) {
   const editor = react.useDocxEditor();
   const track = useTrackedOrNoted();
-  const [template$1, setTemplate] = React3.useState(builtinHouseTemplate);
-  const [divergence, setDivergence] = React3.useState(null);
-  const [basedOnTemplate, setBasedOnTemplate] = React3.useState(false);
-  const [levels, setLevels] = React3.useState({});
-  const [generation, setGeneration] = React3.useState(0);
-  React3.useEffect(() => {
+  const [template$1, setTemplate] = React4.useState(builtinHouseTemplate);
+  const [divergence, setDivergence] = React4.useState(null);
+  const [basedOnTemplate, setBasedOnTemplate] = React4.useState(false);
+  const [levels, setLevels] = React4.useState({});
+  const [generation, setGeneration] = React4.useState(0);
+  React4.useEffect(() => {
     let live = true;
     void resolveHouseTemplate(host).then((t) => live && setTemplate(t));
     return () => {
       live = false;
     };
   }, [host]);
-  const blocks = React3.useMemo(() => {
+  const blocks = React4.useMemo(() => {
     try {
       return template.listBuildingBlocks(template$1.bytes);
     } catch {
       return [];
     }
   }, [template$1]);
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     if (!editor || !enabled) return;
     let live = true;
     void editor.save().then((saved) => {
@@ -2116,8 +2261,8 @@ function HouseTemplateProvider({
       live = false;
     };
   }, [editor, template$1, generation, enabled]);
-  const refresh = React3.useCallback(() => setGeneration((g) => g + 1), []);
-  const insertBlock = React3.useCallback(
+  const refresh = React4.useCallback(() => setGeneration((g) => g + 1), []);
+  const insertBlock = React4.useCallback(
     (name) => {
       if (!editor || !editable) return false;
       const fragment = template.buildingBlockFragment(template$1.bytes, name);
@@ -2147,7 +2292,7 @@ function HouseTemplateProvider({
     },
     [editor, editable, template$1, notify, refresh, track]
   );
-  const setAsHouseTemplate = React3.useMemo(
+  const setAsHouseTemplate = React4.useMemo(
     () => host?.setFromDocument && documentId ? async () => {
       try {
         await host.setFromDocument(documentId);
@@ -2162,7 +2307,7 @@ function HouseTemplateProvider({
     } : void 0,
     [host, documentId, notify]
   );
-  const value = React3.useMemo(
+  const value = React4.useMemo(
     () => ({
       template: template$1,
       blocks,
@@ -2188,6 +2333,825 @@ function HouseTemplateProvider({
   );
   return /* @__PURE__ */ jsxRuntime.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">${chunk2A4MDHJR_cjs.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"> ${chunk2A4MDHJR_cjs.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="${chunk2A4MDHJR_cjs.esc(bookmark)}" w:tooltip="${chunk2A4MDHJR_cjs.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="${chunk2A4MDHJR_cjs.esc(tooltip)}"` : ""} w:history="1">${run(text, CROSS_REFERENCE_STYLE)}</w:hyperlink></w:p>`;
+  if (!port.paste(link, text, false, chunk2A4MDHJR_cjs.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 chunk2A4MDHJR_cjs.esc(node.value ?? "");
+  const name = `${node.prefix ?? "w"}:${node.localName}`;
+  const attrs = (node.attributes ?? []).map((a) => ` ${a.prefix ? `${a.prefix}:` : ""}${a.localName}="${chunk2A4MDHJR_cjs.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 = layout.buildStyleCascadeTable(s.stylesRoot(), void 0, s.settingsRoot());
+      numbering = layout.withNumberingStyleLinks(layout.buildNumberingIndex(s.numberingRoot()), cascade);
+    }
+    return numbering;
+  };
+  return {
+    ...base,
+    listItems: () => {
+      const body = root().children?.find((n) => n.kind === "body");
+      const items = layout.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 = layout.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 = React4.createContext(null);
+var useCrossReferences = () => React4.useContext(CrossReferencesContext);
+function CrossReferencesProvider({
+  children,
+  editable,
+  references,
+  documentId,
+  notify,
+  labels
+}) {
+  const editor = react.useDocxEditor();
+  const track = useTrackedOrNoted();
+  const l = React4.useMemo(() => ({ ...DEFAULT_CROSS_REFERENCES_LABELS, ...labels }), [labels]);
+  const [dialog, setDialog] = React4.useState(
+    null
+  );
+  const marker = React4.useRef(null);
+  const [viewer, setViewer] = React4.useState(null);
+  React4.useEffect(() => setViewer(marker.current?.closest(".native-docx-viewer") ?? null), []);
+  const openDialog = React4.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 = React4.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]
+  );
+  React4.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] = React4.useState(null);
+  const update = React4.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] = React4.useState({});
+  const loadPassages = React4.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]
+  );
+  React4.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 = React4.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__ */ jsxRuntime.jsxs(CrossReferencesContext.Provider, { value, children: [
+    /* @__PURE__ */ jsxRuntime.jsx("span", { ref: marker, hidden: true }),
+    children,
+    /* @__PURE__ */ jsxRuntime.jsx(
+      LinkHoverCard,
+      {
+        root: viewer,
+        matches: (href) => href.startsWith(`#${REF_BOOKMARK_PREFIX}`),
+        resolve: resolveInternal,
+        testId: "docx-cross-reference-card"
+      }
+    ),
+    references && /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.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__ */ jsxRuntime.jsx(ui.Dialog, { open: !!report, onOpenChange: (open) => !open && setReport(null), children: /* @__PURE__ */ jsxRuntime.jsxs(
+      ui.DialogContent,
+      {
+        className: "max-h-[85dvh] overflow-y-auto",
+        "data-testid": "docx-cross-references-report",
+        children: [
+          /* @__PURE__ */ jsxRuntime.jsxs(ui.DialogHeader, { children: [
+            /* @__PURE__ */ jsxRuntime.jsx(ui.DialogTitle, { children: l.updated }),
+            /* @__PURE__ */ jsxRuntime.jsx(ui.DialogDescription, { children: report && l.updateSummary(report.refreshed) })
+          ] }),
+          report && /* @__PURE__ */ jsxRuntime.jsxs("section", { className: "space-y-1 text-sm", children: [
+            /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "font-medium", children: l.brokenTitle }),
+            report.broken.length ? /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+              /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-muted-foreground", children: l.brokenHelp }),
+              /* @__PURE__ */ jsxRuntime.jsx("ul", { className: "space-y-1", "data-testid": "docx-cross-references-broken", children: report.broken.map((b) => /* @__PURE__ */ jsxRuntime.jsxs(
+                "li",
+                {
+                  className: "flex items-center justify-between gap-2",
+                  children: [
+                    /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-red-text", children: b.text }),
+                    /* @__PURE__ */ jsxRuntime.jsx(
+                      ui.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__ */ jsxRuntime.jsx("p", { className: "text-muted-foreground", children: l.brokenNone })
+          ] }),
+          /* @__PURE__ */ jsxRuntime.jsx(ui.DialogFooter, { children: /* @__PURE__ */ jsxRuntime.jsx(ui.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] = React4.useState("this");
+  const [query, setQuery] = React4.useState("");
+  const [chosen, setChosen] = React4.useState(null);
+  const [mode, setMode] = React4.useState("number");
+  const shown = React4.useMemo(() => filterTargets(targets, query), [targets, query]);
+  const effectiveMode = chosen?.number ? mode : "text";
+  const [documents, setDocuments] = React4.useState(null);
+  const [docId, setDocId] = React4.useState(null);
+  const [passageQuery, setPassageQuery] = React4.useState("");
+  const [passage, setPassage] = React4.useState(null);
+  const [text, setText] = React4.useState("");
+  React4.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__ */ jsxRuntime.jsx(ui.Dialog, { open: true, onOpenChange: (open) => !open && onCancel(), children: /* @__PURE__ */ jsxRuntime.jsxs(
+    ui.DialogContent,
+    {
+      className: "max-h-[85dvh] overflow-y-auto",
+      "data-testid": "docx-cross-reference-dialog",
+      onCloseAutoFocus: (event) => {
+        if (!onClosed) return;
+        event.preventDefault();
+        onClosed();
+      },
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsxs(ui.DialogHeader, { children: [
+          /* @__PURE__ */ jsxRuntime.jsx(ui.DialogTitle, { children: l.title }),
+          /* @__PURE__ */ jsxRuntime.jsx(ui.DialogDescription, { children: l.description })
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsxs(ui.Tabs, { value: tab, onValueChange: (v) => setTab(v), children: [
+          /* @__PURE__ */ jsxRuntime.jsxs(ui.TabsList, { children: [
+            /* @__PURE__ */ jsxRuntime.jsx(ui.TabsTrigger, { value: "this", "data-testid": "docx-cross-reference-this", children: l.thisDocument }),
+            references && /* @__PURE__ */ jsxRuntime.jsx(ui.TabsTrigger, { value: "other", "data-testid": "docx-cross-reference-other", children: l.otherDocument })
+          ] }),
+          /* @__PURE__ */ jsxRuntime.jsxs(ui.TabsContent, { value: "this", className: "space-y-3", children: [
+            /* @__PURE__ */ jsxRuntime.jsx(
+              ui.Input,
+              {
+                value: query,
+                placeholder: l.filterTargets,
+                "aria-label": l.filterTargets,
+                onChange: (e) => setQuery(e.target.value),
+                "data-testid": "docx-cross-reference-filter"
+              }
+            ),
+            /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsx("p", { className: "p-2 text-sm text-muted-foreground", children: l.noTargets }),
+                  shown.map((t) => /* @__PURE__ */ jsxRuntime.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: ui.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__ */ jsxRuntime.jsx("span", { className: "shrink-0 font-mono text-xs text-muted-foreground", children: t.marker || l.heading }),
+                        /* @__PURE__ */ jsxRuntime.jsx("span", { className: ui.cn("truncate", t.heading && "font-medium"), children: t.text })
+                      ]
+                    },
+                    t.paragraphId
+                  ))
+                ]
+              }
+            ),
+            chosen && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-wrap items-center gap-3 text-sm", children: [
+              /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-muted-foreground", children: l.insertAs }),
+              chosen.number && /* @__PURE__ */ jsxRuntime.jsxs("label", { className: "flex items-center gap-1", children: [
+                /* @__PURE__ */ jsxRuntime.jsx(
+                  "input",
+                  {
+                    type: "radio",
+                    name: "cross-reference-mode",
+                    checked: effectiveMode === "number",
+                    onChange: () => setMode("number")
+                  }
+                ),
+                l.number
+              ] }),
+              /* @__PURE__ */ jsxRuntime.jsxs("label", { className: "flex items-center gap-1", children: [
+                /* @__PURE__ */ jsxRuntime.jsx(
+                  "input",
+                  {
+                    type: "radio",
+                    name: "cross-reference-mode",
+                    checked: effectiveMode === "text",
+                    onChange: () => setMode("text")
+                  }
+                ),
+                l.text
+              ] }),
+              /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsxs(ui.TabsContent, { value: "other", className: "space-y-3", children: [
+            references.renderDocumentPicker ? references.renderDocumentPicker(chooseDocument, docId) : /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsx("option", { value: "", children: l.chooseDocument }),
+                  (documents ?? []).map((d) => /* @__PURE__ */ jsxRuntime.jsx("option", { value: d.id, children: d.title }, d.id))
+                ]
+              }
+            ),
+            docId && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+              /* @__PURE__ */ jsxRuntime.jsx(
+                ui.Input,
+                {
+                  value: passageQuery,
+                  placeholder: l.filterPassages,
+                  "aria-label": l.filterPassages,
+                  onChange: (e) => setPassageQuery(e.target.value),
+                  "data-testid": "docx-cross-reference-passage-filter"
+                }
+              ),
+              /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsx("p", { className: "p-2 text-sm text-muted-foreground", children: l.loadingPassages }) : shownPassages.length === 0 ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: "p-2 text-sm text-muted-foreground", children: l.noPassages }) : shownPassages.map((p, i) => /* @__PURE__ */ jsxRuntime.jsx(
+                    chunk5FYU7ZIU_cjs.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__ */ jsxRuntime.jsxs("label", { className: "block space-y-1 text-sm", children: [
+                /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-muted-foreground", children: l.referenceText }),
+                /* @__PURE__ */ jsxRuntime.jsx(
+                  ui.Input,
+                  {
+                    value: text,
+                    onChange: (e) => setText(e.target.value),
+                    "data-testid": "docx-cross-reference-text"
+                  }
+                )
+              ] })
+            ] })
+          ] })
+        ] }),
+        /* @__PURE__ */ jsxRuntime.jsxs(ui.DialogFooter, { children: [
+          /* @__PURE__ */ jsxRuntime.jsx(ui.Button, { variant: "outline", onClick: onCancel, children: l.cancel }),
+          /* @__PURE__ */ jsxRuntime.jsx(ui.Button, { disabled: !canInsert, onClick: insert, "data-testid": "docx-cross-reference-insert", children: l.insertButton })
+        ] })
+      ]
+    }
+  ) });
+}
 function RibbonMenu({
   label,
   icon,
@@ -2198,9 +3162,9 @@ function RibbonMenu({
   keepMounted = false,
   popoverClassName
 }) {
-  const [open, setOpen] = React3.useState(false);
-  const element = React3.useRef(null);
-  React3.useEffect(() => {
+  const [open, setOpen] = React4.useState(false);
+  const element = React4.useRef(null);
+  React4.useEffect(() => {
     if (!open) return;
     const dismiss = (event) => {
       if (!element.current?.contains(event.target)) setOpen(false);
@@ -2309,7 +3273,7 @@ var AUTO = "";
 function useGenerateImageTarget() {
   const editor = react.useDocxEditor();
   const loaded2 = react.useEditorState((snapshot) => !snapshot.isLoading);
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     if (!editor || !loaded2) return;
     mounted.push(editor);
     return () => void mounted.splice(mounted.indexOf(editor), 1);
@@ -2317,16 +3281,16 @@ function useGenerateImageTarget() {
 }
 function GenerateImageButton({ generation }) {
   const editor = react.useDocxEditor();
-  const [prompt, setPrompt] = React3.useState("");
-  const [aspectRatio, setAspectRatio] = React3.useState(AUTO);
-  const [busy, setBusy] = React3.useState(false);
-  const [error, setError] = React3.useState("");
-  const abort = React3.useRef(null);
-  const close = React3.useRef(() => {
+  const [prompt, setPrompt] = React4.useState("");
+  const [aspectRatio, setAspectRatio] = React4.useState(AUTO);
+  const [busy, setBusy] = React4.useState(false);
+  const [error, setError] = React4.useState("");
+  const abort = React4.useRef(null);
+  const close = React4.useRef(() => {
   });
   const editable = react.useEditorState((snapshot) => snapshot.editable);
-  const generating = React3.useSyncExternalStore(subscribe, () => running > 0);
-  async function run() {
+  const generating = React4.useSyncExternalStore(subscribe, () => running > 0);
+  async function run2() {
     if (!editor || !prompt.trim() || busy) return;
     const caret = rememberCaret(editor);
     const controller = new AbortController();
@@ -2372,7 +3336,7 @@ function GenerateImageButton({ generation }) {
             className: "native-docx-form native-docx-generate-image",
             onSubmit: (event) => {
               event.preventDefault();
-              void run();
+              void run2();
             },
             children: [
               /* @__PURE__ */ jsxRuntime.jsxs("label", { children: [
@@ -2388,7 +3352,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();
                     }
                   }
                 )
@@ -2528,18 +3492,18 @@ function planOverflow(items, available, moreWidth) {
   }
   return collapsed;
 }
-var Overflow = React3.createContext(null);
+var Overflow = React4.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 = React3.useRef(null);
-  const items = React3.useRef(/* @__PURE__ */ new Map());
-  const widths = React3.useRef(/* @__PURE__ */ new Map());
-  const [version, setVersion] = React3.useState(0);
-  const [collapsed, setCollapsed] = React3.useState(() => /* @__PURE__ */ new Set());
-  const [slots, setSlots] = React3.useState({});
-  const [menu, setMenu] = React3.useState([]);
-  const register = React3.useCallback((id, item) => {
+  const row = React4.useRef(null);
+  const items = React4.useRef(/* @__PURE__ */ new Map());
+  const widths = React4.useRef(/* @__PURE__ */ new Map());
+  const [version, setVersion] = React4.useState(0);
+  const [collapsed, setCollapsed] = React4.useState(() => /* @__PURE__ */ new Set());
+  const [slots, setSlots] = React4.useState({});
+  const [menu, setMenu] = React4.useState([]);
+  const register = React4.useCallback((id, item) => {
     items.current.set(id, item);
     setVersion((v) => v + 1);
     return () => {
@@ -2547,7 +3511,7 @@ function RibbonOverflow({ tab, children }) {
       setVersion((v) => v + 1);
     };
   }, []);
-  const plan = React3.useCallback(() => {
+  const plan = React4.useCallback(() => {
     const element = row.current;
     if (!element) return;
     const gap = parseFloat(getComputedStyle(element).columnGap) || 0;
@@ -2567,8 +3531,8 @@ function RibbonOverflow({ tab, children }) {
       (current) => current.length === entries.length && current.every((entry, i) => entry.id === entries[i].id && entry.label === entries[i].label) ? current : entries
     );
   }, []);
-  React3.useLayoutEffect(plan, [plan, version, tab, collapsed]);
-  React3.useLayoutEffect(() => {
+  React4.useLayoutEffect(plan, [plan, version, tab, collapsed]);
+  React4.useLayoutEffect(() => {
     const element = row.current;
     if (!element) return;
     const observer = new ResizeObserver(() => plan());
@@ -2576,7 +3540,7 @@ function RibbonOverflow({ tab, children }) {
     for (const item of items.current.values()) observer.observe(item.element);
     return () => observer.disconnect();
   }, [plan, version]);
-  const slotRef = React3.useCallback(
+  const slotRef = React4.useCallback(
     (id) => (node) => setSlots((current) => {
       if (node ? current[id] === node : !(id in current)) return current;
       const next = { ...current };
@@ -2586,7 +3550,7 @@ function RibbonOverflow({ tab, children }) {
     }),
     []
   );
-  const context = React3.useMemo(() => ({ collapsed, slots, register }), [collapsed, slots, register]);
+  const context = React4.useMemo(() => ({ collapsed, slots, register }), [collapsed, slots, register]);
   const shown = menu.filter((entry) => collapsed.has(entry.id));
   return /* @__PURE__ */ jsxRuntime.jsx(Overflow.Provider, { value: context, children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "native-docx-ribbon-row", ref: row, "data-testid": "docx-ribbon-row", children: [
     children,
@@ -2610,16 +3574,16 @@ function MoreRows({
   slotRef,
   close
 }) {
-  const refs = React3.useRef(/* @__PURE__ */ new Map());
+  const refs = React4.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 = React3.useRef(null);
-  const latest = React3.useRef(close);
+  const list = React4.useRef(null);
+  const latest = React4.useRef(close);
   latest.current = close;
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     const element = list.current;
     if (!element) return;
     const onClick = (event) => {
@@ -2649,10 +3613,10 @@ function RibbonItem({
   priority = 0,
   children
 }) {
-  const context = React3.useContext(Overflow);
-  const element = React3.useRef(null);
+  const context = React4.useContext(Overflow);
+  const element = React4.useRef(null);
   const register = context?.register;
-  React3.useLayoutEffect(() => {
+  React4.useLayoutEffect(() => {
     if (!register || !element.current) return;
     return register(id, { label, priority, element: element.current });
   }, [register, id, label, priority]);
@@ -2734,14 +3698,14 @@ function Gallery({ close }) {
   const changed = new Set(
     house?.basedOnTemplate ? house.divergence?.styles.filter((s) => s.kind === "changed").map((s) => s.styleId) : []
   );
-  const [query, setQuery] = React3.useState("");
-  const quick = React3.useMemo(
+  const [query, setQuery] = React4.useState("");
+  const quick = React4.useMemo(
     () => QUICK_STYLES.map((name) => findStyle(options, name)).filter(
       (o) => !!o
     ),
     [options]
   );
-  const shown = React3.useMemo(() => {
+  const shown = React4.useMemo(() => {
     const q = query.trim().toLowerCase();
     return q ? options.filter(
       (o) => o.name.toLowerCase().includes(q) || o.styleId.toLowerCase().includes(q)
@@ -2988,9 +3952,9 @@ function WordShortcuts({ scope }) {
   const styles = react.useParagraphStyle();
   const editor = react.useDocxEditor();
   const levels = useHouseTemplate()?.levels;
-  const latest = React3.useRef({ footnote, endnote, styles, editor, levels });
+  const latest = React4.useRef({ footnote, endnote, styles, editor, levels });
   latest.current = { footnote, endnote, styles, editor, levels };
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     const element = scope.current;
     if (!element) return;
     const onKeyDown = (event) => {
@@ -3028,6 +3992,65 @@ function WordShortcuts({ scope }) {
   }, [scope]);
   return null;
 }
+function CrossReferenceButton() {
+  const references = useCrossReferences();
+  if (!references) return null;
+  return /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsx(lucideReact.Link2, { size: 16 })
+    }
+  );
+}
+function UpdateCrossReferencesButton() {
+  const references = useCrossReferences();
+  if (!references) return null;
+  return /* @__PURE__ */ jsxRuntime.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__ */ jsxRuntime.jsx(lucideReact.RefreshCcw, { size: 16 })
+    }
+  );
+}
+function DocxContextMenuExtras() {
+  const terms = useDefinedTerms();
+  const references = useCrossReferences();
+  if (!terms && !references) return null;
+  return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.ContextMenu.Separator, {}),
+    terms && /* @__PURE__ */ jsxRuntime.jsx(
+      react.DocxEditor.ContextMenu.Item,
+      {
+        label: "Insert defined term",
+        icon: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.BookA, { size: 14 }),
+        shortcut: "@@",
+        onSelect: () => terms.openPicker()
+      }
+    ),
+    references && /* @__PURE__ */ jsxRuntime.jsx(
+      react.DocxEditor.ContextMenu.Item,
+      {
+        label: references.labels.insert,
+        icon: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Link2, { size: 14 }),
+        onSelect: () => references.openDialog()
+      }
+    )
+  ] });
+}
 
 // src/docx/layout/presets.ts
 var TWIPS_PER_INCH = 1440;
@@ -3240,7 +4263,7 @@ function Breaks() {
 }
 function LayoutButtons() {
   const { pageSetup, apply } = react.usePageSetup();
-  const [dialog, setDialog] = React3.useState(false);
+  const [dialog, setDialog] = React4.useState(false);
   const props = { setup: pageSetup, apply, openDialog: () => setDialog(true) };
   return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
     /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "layout-margins", label: "Margins", children: /* @__PURE__ */ jsxRuntime.jsx(Margins, { ...props }) }),
@@ -3434,7 +4457,7 @@ function TableButtons() {
   ] });
 }
 var CAPTION_LABELS = ["Figure", "Table", "Equation"];
-var CAPTION_STYLES = chunkAOFATOT3_cjs.stylesXml(
+var CAPTION_STYLES = chunk2A4MDHJR_cjs.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="paragraph" w:styleId="Caption"><w:name w:val="caption"/><w:basedOn w:val="Normal"/><w:next w:val="Normal"/><w:uiPriority w:val="35"/><w:unhideWhenUsed/><w:qFormat/><w:pPr><w:spacing w:after="200" w:line="240" w:lineRule="auto"/></w:pPr><w:rPr><w:i/><w:iCs/><w:color w:val="44546A"/><w:sz w:val="18"/><w:szCs w:val="18"/></w:rPr></w:style>'
 );
@@ -3462,9 +4485,9 @@ function countSeqFields(root, label, throughId) {
   return count;
 }
 function captionParagraphXml(label, number, text) {
-  const run = (value) => `<w:r><w:t xml:space="preserve">${chunkAOFATOT3_cjs.esc(value)}</w:t></w:r>`;
+  const run2 = (value) => `<w:r><w:t xml:space="preserve">${chunk2A4MDHJR_cjs.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 ${chunkAOFATOT3_cjs.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 ${chunk2A4MDHJR_cjs.esc(label)} \\* ARABIC "><w:r><w:t>${number}</w:t></w:r></w:fldSimple>${rest ? run2(rest) : ""}</w:p>`;
 }
 function base642(bytes) {
   let binary = "";
@@ -3473,8 +4496,8 @@ function base642(bytes) {
   return btoa(binary);
 }
 function captionFragmentHtml(label, number, text, revision) {
-  const untracked = chunkAOFATOT3_cjs.docxPackage({
-    document: chunkAOFATOT3_cjs.documentXml(captionParagraphXml(label, number, text)),
+  const untracked = chunk2A4MDHJR_cjs.docxPackage({
+    document: chunk2A4MDHJR_cjs.documentXml(captionParagraphXml(label, number, text)),
     styles: CAPTION_STYLES,
     title: "Caption"
   });
@@ -3547,9 +4570,9 @@ function insertCaption(editor, label, text, track) {
 function CaptionButton({ defaultLabel = "Figure" }) {
   const editor = react.useDocxEditor();
   const track = useTrackedOrNoted();
-  const [label, setLabel] = React3.useState(defaultLabel);
-  const [text, setText] = React3.useState("");
-  const [error, setError] = React3.useState("");
+  const [label, setLabel] = React4.useState(defaultLabel);
+  const [text, setText] = React4.useState("");
+  const [error, setError] = React4.useState("");
   return /* @__PURE__ */ jsxRuntime.jsx(RibbonMenu, { label: "Insert caption", icon: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Captions, { size: 16 }), testId: "docx-insert-caption", children: (close) => /* @__PURE__ */ jsxRuntime.jsxs(
     "form",
     {
@@ -3668,9 +4691,9 @@ function tableCells(root, paragraphId) {
 }
 function TableTabKeys({ scope }) {
   const editor = react.useDocxEditor();
-  const latest = React3.useRef(editor);
+  const latest = React4.useRef(editor);
   latest.current = editor;
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     const element = scope.current;
     if (!element) return;
     const onKeyDown = (event) => {
@@ -3816,7 +4839,7 @@ function covered(room, vector, receipt) {
     }
   return true;
 }
-var EditorBoundary = class extends React3__default.default.Component {
+var EditorBoundary = class extends React4__default.default.Component {
   state = {};
   static getDerivedStateFromError(error) {
     return { error };
@@ -3829,8 +4852,8 @@ var EditorBoundary = class extends React3__default.default.Component {
   }
 };
 function DocxParticipants({ session }) {
-  const [people, setPeople] = React3.useState([]);
-  React3.useEffect(() => {
+  const [people, setPeople] = React4.useState([]);
+  React4.useEffect(() => {
     if (!session) return;
     setPeople(session.participants());
     return session.subscribeParticipants(setPeople);
@@ -3859,7 +4882,7 @@ function DocxRibbon({
   badge,
   imageGeneration
 }) {
-  const [selected, setTab] = React3.useState("Home");
+  const [selected, setTab] = React4.useState("Home");
   const contextual = useContextualTabs(selected);
   useGenerateImageTarget();
   const tab = contextual.shown;
@@ -3908,11 +4931,16 @@ function DocxRibbon({
           /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-page-break", label: "Page break", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Button, { slotId: "insert.pageBreak" }) }),
           /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-link", label: "Link", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Link, {}) }),
           /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-defined-term", label: "Defined term", children: /* @__PURE__ */ jsxRuntime.jsx(DefinedTermButtons, {}) }),
-          /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-quick-parts", label: "Quick Parts", children: /* @__PURE__ */ jsxRuntime.jsx(QuickParts, {}) })
+          /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-quick-parts", label: "Quick Parts", children: /* @__PURE__ */ jsxRuntime.jsx(QuickParts, {}) }),
+          /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "insert-cross-reference", label: "Cross-reference", children: /* @__PURE__ */ jsxRuntime.jsx(CrossReferenceButton, {}) })
         ] }),
         /* @__PURE__ */ jsxRuntime.jsx(LayoutTabContent, { tab }),
         tab === "Design" && /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "design-house-template", label: "House template", children: /* @__PURE__ */ jsxRuntime.jsx(HouseTemplatePanel, {}) }),
-        tab === "References" && /* @__PURE__ */ jsxRuntime.jsx(NoteButtons, {}),
+        tab === "References" && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+          /* @__PURE__ */ jsxRuntime.jsx(NoteButtons, {}),
+          /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "references-cross-reference", label: "Cross-reference", children: /* @__PURE__ */ jsxRuntime.jsx(CrossReferenceButton, {}) }),
+          /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "references-update-cross-references", label: "Update cross-references", children: /* @__PURE__ */ jsxRuntime.jsx(UpdateCrossReferencesButton, {}) })
+        ] }),
         tab === "Review" && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
           /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "review-editing-mode", label: "Editing mode", priority: 10, children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.EditingMode, {}) }),
           /* @__PURE__ */ jsxRuntime.jsx(RibbonItem, { id: "review-comments", label: "Comments", children: /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Toolbar.Comments, {}) }),
@@ -3935,18 +4963,18 @@ function NativeDocxEditor({
   stream,
   adapter
 }) {
-  const [ready, setReady] = React3.useState(), [error, setError] = React3.useState(""), [retry, setRetry] = React3.useState(0);
-  const [status, setStatus] = React3.useState("Connecting\u2026"), [dirty, setDirty] = React3.useState(false), [saving, setSaving] = React3.useState(false), [offline, setOffline] = React3.useState(false);
-  const revision = React3.useRef(0);
-  const stageRef = React3.useRef(null), fitCleanup = React3.useRef(void 0);
-  const ref = React3.useRef(null), dirtyRef = React3.useRef(false), draftTimer = React3.useRef(void 0);
+  const [ready, setReady] = React4.useState(), [error, setError] = React4.useState(""), [retry, setRetry] = React4.useState(0);
+  const [status, setStatus] = React4.useState("Connecting\u2026"), [dirty, setDirty] = React4.useState(false), [saving, setSaving] = React4.useState(false), [offline, setOffline] = React4.useState(false);
+  const revision = React4.useRef(0);
+  const stageRef = React4.useRef(null), fitCleanup = React4.useRef(void 0);
+  const ref = React4.useRef(null), dirtyRef = React4.useRef(false), draftTimer = React4.useRef(void 0);
   const isDraft = draftContent !== void 0;
-  const streamRef = React3.useRef(stream);
+  const streamRef = React4.useRef(stream);
   streamRef.current = stream;
-  const streamWriter = React3.useRef(null);
-  const streamFinished = React3.useRef(false);
-  const streamTimer = React3.useRef(void 0);
-  const [streamAttempt, setStreamAttempt] = React3.useState(0);
+  const streamWriter = React4.useRef(null);
+  const streamFinished = React4.useRef(false);
+  const streamTimer = React4.useRef(void 0);
+  const [streamAttempt, setStreamAttempt] = React4.useState(0);
   function updateStream() {
     const current = streamRef.current;
     if (!current || !streamWriter.current || streamFinished.current) return;
@@ -3962,7 +4990,7 @@ function NativeDocxEditor({
       );
     }
   }
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     if (!streamRef.current) return;
     if (!streamRef.current.busy) {
       clearTimeout(streamTimer.current);
@@ -3975,8 +5003,8 @@ function NativeDocxEditor({
       }, 120);
     }
   }, [stream?.content, stream?.busy, stream?.error, streamAttempt]);
-  React3.useEffect(() => () => clearTimeout(streamTimer.current), []);
-  React3.useEffect(() => {
+  React4.useEffect(() => () => clearTimeout(streamTimer.current), []);
+  React4.useEffect(() => {
     let cancelled = false;
     let room;
     const cleanups = [];
@@ -4104,7 +5132,7 @@ function NativeDocxEditor({
       room?.destroy();
     };
   }, [documentId, isDraft, snapshot, retry]);
-  React3.useEffect(() => {
+  React4.useEffect(() => {
     adapter.onDirtyChange?.(dirty);
     const beforeUnload = (e) => {
       if (dirtyRef.current) e.preventDefault();
@@ -4116,6 +5144,7 @@ function NativeDocxEditor({
     };
   }, [dirty]);
   async function exportDocument() {
+    runBeforeSave(ref.current);
     const data = await ref.current?.save();
     if (!data) return;
     const url = URL.createObjectURL(
@@ -4129,7 +5158,7 @@ function NativeDocxEditor({
     a.click();
     setTimeout(() => URL.revokeObjectURL(url), 5e3);
   }
-  React3.useLayoutEffect(() => {
+  React4.useLayoutEffect(() => {
     const editor = ref.current;
     return () => {
       if (isDraft && editor && dirtyRef.current)
@@ -4142,6 +5171,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 () => {
@@ -4265,7 +5295,7 @@ function NativeDocxEditor({
                 load: adapter.definitions,
                 editable: !stream && !snapshot && ready.canEdit,
                 notify: adapter.notify,
-                children: /* @__PURE__ */ jsxRuntime.jsxs(
+                children: /* @__PURE__ */ jsxRuntime.jsx(
                   HouseTemplateProvider,
                   {
                     enabled: !stream,
@@ -4273,67 +5303,76 @@ function NativeDocxEditor({
                     documentId: isDraft || snapshot ? void 0 : documentId,
                     editable: !stream && !snapshot && ready.canEdit,
                     notify: adapter.notify,
-                    children: [
-                      /* @__PURE__ */ jsxRuntime.jsx(
-                        react.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__ */ jsxRuntime.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__ */ jsxRuntime.jsx("span", { title: "Edits sync live with everyone who has this document open", children: "Co-edit mode" }) : void 0
+                    children: /* @__PURE__ */ jsxRuntime.jsxs(
+                      CrossReferencesProvider,
+                      {
+                        editable: !stream && !snapshot && ready.canEdit,
+                        references: adapter.references,
+                        documentId,
+                        notify: adapter.notify,
+                        children: [
+                          /* @__PURE__ */ jsxRuntime.jsx(
+                            react.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__ */ jsxRuntime.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__ */ jsxRuntime.jsx("span", { title: "Edits sync live with everyone who has this document open", children: "Co-edit mode" }) : void 0
+                              )
+                            }
+                          ),
+                          !stream && /* @__PURE__ */ jsxRuntime.jsx(WordShortcuts, { scope: stageRef }),
+                          !stream && /* @__PURE__ */ jsxRuntime.jsx(TableTabKeys, { scope: stageRef }),
+                          /* @__PURE__ */ jsxRuntime.jsxs(
+                            "div",
+                            {
+                              className: "native-docx-stage",
+                              ref: stageRef,
+                              onMouseDownCapture: (event) => {
+                                if (event.button === 2 && ref.current?.getSelectionPlacement())
+                                  event.preventDefault();
+                              },
+                              children: [
+                                /* @__PURE__ */ jsxRuntime.jsxs(react.DocxEditor.Viewport, { className: "native-docx-viewport", children: [
+                                  /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Content, {}),
+                                  /* @__PURE__ */ jsxRuntime.jsx(
+                                    DocxMentions,
+                                    {
+                                      initialCommentId,
+                                      mentions: adapter.mentions,
+                                      notify: adapter.notify,
+                                      getAgentStatus: adapter.getAgentStatus,
+                                      requestAgent: adapter.requestAgent ? (request) => adapter.requestAgent(documentId, request) : void 0,
+                                      children: /* @__PURE__ */ jsxRuntime.jsx(DocxEditorReview, { children: () => /* @__PURE__ */ jsxRuntime.jsx(DocxEditorReview.Card, { children: /* @__PURE__ */ jsxRuntime.jsx(DocxCommentActivity, {}) }) })
+                                    }
+                                  ),
+                                  /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.HeaderFooterChrome, {}),
+                                  /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.NotesChrome, {}),
+                                  /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Equation, {}),
+                                  /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.HyperLink, {}),
+                                  /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.ContextMenu, { children: /* @__PURE__ */ jsxRuntime.jsx(DocxContextMenuExtras, {}) })
+                                ] }),
+                                /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.PageNumber, {})
+                              ]
+                            }
                           )
-                        }
-                      ),
-                      !stream && /* @__PURE__ */ jsxRuntime.jsx(WordShortcuts, { scope: stageRef }),
-                      !stream && /* @__PURE__ */ jsxRuntime.jsx(TableTabKeys, { scope: stageRef }),
-                      /* @__PURE__ */ jsxRuntime.jsxs(
-                        "div",
-                        {
-                          className: "native-docx-stage",
-                          ref: stageRef,
-                          onMouseDownCapture: (event) => {
-                            if (event.button === 2 && ref.current?.getSelectionPlacement())
-                              event.preventDefault();
-                          },
-                          children: [
-                            /* @__PURE__ */ jsxRuntime.jsxs(react.DocxEditor.Viewport, { className: "native-docx-viewport", children: [
-                              /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Content, {}),
-                              /* @__PURE__ */ jsxRuntime.jsx(
-                                DocxMentions,
-                                {
-                                  initialCommentId,
-                                  mentions: adapter.mentions,
-                                  notify: adapter.notify,
-                                  getAgentStatus: adapter.getAgentStatus,
-                                  requestAgent: adapter.requestAgent ? (request) => adapter.requestAgent(documentId, request) : void 0,
-                                  children: /* @__PURE__ */ jsxRuntime.jsx(DocxEditorReview, { children: () => /* @__PURE__ */ jsxRuntime.jsx(DocxEditorReview.Card, { children: /* @__PURE__ */ jsxRuntime.jsx(DocxCommentActivity, {}) }) })
-                                }
-                              ),
-                              /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.HeaderFooterChrome, {}),
-                              /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.NotesChrome, {}),
-                              /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.Equation, {}),
-                              /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.HyperLink, {}),
-                              /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.ContextMenu, {})
-                            ] }),
-                            /* @__PURE__ */ jsxRuntime.jsx(react.DocxEditor.PageNumber, {})
-                          ]
-                        }
-                      )
-                    ]
+                        ]
+                      }
+                    )
                   }
                 )
               }
@@ -4433,6 +5472,9 @@ async function loadFonts(baseUrl) {
 }
 
 exports.BUILTIN_TEMPLATE_NAME = BUILTIN_TEMPLATE_NAME;
+exports.CrossReferenceDialog = CrossReferenceDialog;
+exports.CrossReferencesProvider = CrossReferencesProvider;
+exports.DEFAULT_CROSS_REFERENCES_LABELS = DEFAULT_CROSS_REFERENCES_LABELS;
 exports.DEFAULT_DEFINED_TERMS_LABELS = DEFAULT_DEFINED_TERMS_LABELS;
 exports.DEFINED_TERM_TRIGGER = DEFINED_TERM_TRIGGER;
 exports.DefinedTermsProvider = DefinedTermsProvider;
@@ -4444,24 +5486,33 @@ exports.DocxParticipants = DocxParticipants;
 exports.DocxRibbon = DocxRibbon;
 exports.GenerateImageButton = GenerateImageButton;
 exports.HouseTemplateProvider = HouseTemplateProvider;
+exports.LinkHoverCard = LinkHoverCard;
 exports.NativeDocxEditor = NativeDocxEditor;
 exports.builtinHouseTemplate = builtinHouseTemplate;
 exports.contentPath = contentPath;
 exports.editorPort = editorPort;
 exports.findDefinitionsSection = findDefinitionsSection;
+exports.insertCrossReference = insertCrossReference;
 exports.insertDefinedTerm = insertDefinedTerm;
+exports.insertDocumentReference = insertDocumentReference;
+exports.listTargets = listTargets;
 exports.loadDocxFonts = loadDocxFonts;
 exports.normalizeDocxExport = normalizeDocxExport;
+exports.paragraphNumber = paragraphNumber;
+exports.referenceText = referenceText;
+exports.referencesPort = referencesPort;
 exports.resolveHouseTemplate = resolveHouseTemplate;
 exports.reviewModule = reviewModule;
+exports.shortTitle = shortTitle;
 exports.structuralPort = structuralPort;
 exports.templateFileName = templateFileName;
 exports.trackedOrNoted = trackedOrNoted;
+exports.useCrossReferences = useCrossReferences;
 exports.useDefinedTerms = useDefinedTerms;
 exports.useHouseTemplate = useHouseTemplate;
 exports.useReview = useReview;
 exports.useReviewItem = useReviewItem;
 exports.useTrackedOrNoted = useTrackedOrNoted;
 exports.withDirectEditing = withDirectEditing;
-//# sourceMappingURL=chunk-O33EBMIX.cjs.map
-//# sourceMappingURL=chunk-O33EBMIX.cjs.map
+//# sourceMappingURL=chunk-ZWWN4CUL.cjs.map
+//# sourceMappingURL=chunk-ZWWN4CUL.cjs.map