@arbidocs/blocks 0.4.103 → 0.4.105

package/dist/docx/LinkHoverCard.d.ts

@@ -0,0 +1,24 @@
+/**
+ * A card over a painted link in the Word editor, for the links a feature inserts: a defined term
+ * shows its definition, a cross-reference the text it points at. The link's own tooltip (what Word
+ * shows on hover) is held back while the card shows. Typing, clicking or scrolling hides it, since
+ * a repaint can replace the link under the pointer without a mouseout.
+ */
+import React from 'react';
+export interface LinkHoverContent {
+    title?: string;
+    body: string;
+    footer?: string;
+}
+export interface LinkHoverCardProps {
+    /** The element the painted pages are inside (the editor). */
+    root: Element | null;
+    /** Whether this card handles a link (by its `href`). */
+    matches: (href: string, link: HTMLAnchorElement) => boolean;
+    /** The card's content for a link, or null to show the link's own tooltip. */
+    resolve: (href: string) => LinkHoverContent | null | undefined;
+    /** Called on the first hover (e.g. to load what `resolve` reads). */
+    onFirstHover?: () => void;
+    testId: string;
+}
+export declare function LinkHoverCard({ root, matches, resolve, onFirstHover, testId, }: LinkHoverCardProps): React.ReactPortal | null;

package/dist/docx/NativeDocxEditor.d.ts

@@ -3,6 +3,7 @@ import React from 'react';
 import { type FontConfiguration } from '@docx-editor.dev/react';
 import type { DocxCollaborationSession } from '@arbidocs/coedit';
 import type { DefinitionSource } from '../tags/definitions';
+import { type DocxReferencesAdapter } from './references/CrossReferences';
 import { type DocxImageGeneration } from './layout/GenerateImage';
 import { type HouseTemplateHost } from './template/HouseTemplate';
 /**
@@ -46,6 +47,11 @@ export interface NativeDocxAdapter {
      * Defined term, and typing `@@` in the body opens the term type-ahead.
      */
     definitions?: () => Promise<DefinitionSource[]>;
+    /**
+     * References to the workspace's other documents. Present: Insert cross-reference also offers a
+     * passage of another document, inserted as a link that opens it there.
+     */
+    references?: DocxReferencesAdapter;
     /** The platform's image generation. Present: the Insert tab offers Generate image. */
     imageGeneration?: DocxImageGeneration;
     /**

package/dist/docx/beforeSave.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Work to do on a document just before it is saved or downloaded (e.g. bringing cross-reference
+ * results up to date, so the stored .docx reads right in Word). Features register against the
+ * editor instance; the widget runs them before Save version and DOCX download.
+ */
+/** Run `fn` before each save of `editor`'s document. Answers the unregister function. */
+export declare function onBeforeSave(editor: object, fn: () => void): () => void;
+/** Run the registered work; one failing does not stop the save. */
+export declare function runBeforeSave(editor: object | null | undefined): void;

package/dist/docx/definitions/fragment.d.ts

@@ -9,6 +9,18 @@ import type { Definition } from '../../tags/definitions';
 import { type Revision } from '@arbidocs/coedit/template';
 /** Character style of an inserted term: a dotted underline, so a defined term reads as one. */
 export declare const DEFINED_TERM_STYLE = "DefinedTerm";
+/** Character style of a cross-reference: a muted blue with a dotted underline (Word's name). */
+export declare const CROSS_REFERENCE_STYLE = "CrossReference";
+/** Character style of a cross-reference whose target is gone: its last text, flagged. */
+export declare const BROKEN_CROSS_REFERENCE_STYLE = "CrossReferenceBroken";
+/**
+ * The character styles the inserted content uses. A paste brings a style the document does not
+ * define; one it already defines (a house template's) is used as it is, so only the missing ones
+ * go into a fragment (see {@link stylesUsed}).
+ */
+export declare const CHARACTER_STYLES: Record<string, string>;
+/** The character styles a fragment's runs use (`w:rStyle`), as ids. */
+export declare function stylesUsed(body: string): string[];
 /** What Word shows on hover over a term: its definition, as one line of at most 255 characters. */
 export declare function definitionTooltip(definition: Pick<Definition, 'term' | 'rest'>): string;
 /** The definition paragraph's text as the document shows it: `“Shares” means the issued shares.` */
@@ -28,4 +40,10 @@ export declare function termLinkXml(term: string, bookmark: string, tooltip: str
  * before the caret's paragraph) instead of running into the text after the caret (inline).
  * With a `revision`, the fragment is one tracked insertion by it.
  */
-export declare function fragmentHtml(body: string, covered: boolean, revision?: Revision | null): string;
+export declare function fragmentHtml(body: string, covered: boolean, { revision, relationships, styles, }?: {
+    revision?: Revision | null;
+    /** Relationships the body refers to (a hyperlink's target). */
+    relationships?: string;
+    /** The character styles to bring (default: every one the body uses). */
+    styles?: readonly string[];
+}): string;

package/dist/docx/definitions/port.d.ts

@@ -27,6 +27,24 @@ export interface DocParagraph {
     bookmarks: string[];
     /** Its internal links (`w:hyperlink w:anchor`). */
     links: DocLink[];
+    /** Its complex fields: where each sits (its one-character offset), its instruction and result. */
+    fields?: DocField[];
+    /** Its runs in a watched character style (a broken cross-reference's mark), with their text. */
+    marks?: DocMark[];
+}
+/** A stretch of a paragraph's text in a watched character style. */
+export interface DocMark {
+    styleId: string;
+    offset: number;
+    text: string;
+}
+/** Character styles whose runs a paragraph read reports as marks. */
+export declare const WATCHED_STYLES: Set<string>;
+/** A complex field of a paragraph. */
+export interface DocField {
+    offset: number;
+    instruction: string;
+    result: string;
 }
 export interface DefinitionsPort {
     /** Every body paragraph, in document order (table cells included, `topLevel: false`). */
@@ -40,11 +58,13 @@ export interface DefinitionsPort {
      * Paste paragraph XML at the caret. `covered`: the fragment ends with a whole paragraph, so at
      * the start of a paragraph it lands as paragraphs before it. Otherwise it runs inline.
      */
-    paste(body: string, text: string, covered: boolean): boolean;
+    paste(body: string, text: string, covered: boolean, relationships?: string): boolean;
     /** Split the caret's paragraph (Enter), the caret moving into the new one. */
     splitParagraph(): void;
+    /** Type plain text at the caret. */
+    typeText(text: string): void;
 }
-type Node = {
+export type OoxmlNodeLike = {
     id: string;
     kind: string;
     localName?: string;
@@ -53,10 +73,14 @@ type Node = {
         localName: string;
         value: string;
     }[];
-    children?: readonly Node[];
+    children?: readonly OoxmlNodeLike[];
 };
+/** How a field counts in a paragraph's text (the engine's model vocabulary). */
+export declare const FIELD_ATOM = "\uFFFC";
 /** The paragraphs of a part's body, read from the engine's OOXML tree. */
-export declare function readParagraphs(root: Node): DocParagraph[];
+export declare function readParagraphs(root: OoxmlNodeLike): DocParagraph[];
+/** The style ids a document's styles part defines. */
+export declare function documentStyleIds(root: OoxmlNodeLike | null | undefined): Set<string>;
 /**
  * The port over a live editor. Writes go through the editor's own commands and paste; with a
  * `revision`, what it pastes is a tracked insertion by it (see `trackedOrNoted`).
@@ -68,13 +92,21 @@ export declare function editorPort(editor: DocxEditorInstance, revision?: Revisi
  */
 export declare function withDirectEditing<T>(editor: DocxEditorInstance, fn: () => T): T;
 /**
- * Keep the caret where a command left it across the collaboration room's next re-install.
+ * Keep the caret where a command left it while the collaboration room settles after the command.
  *
  * A paste lands as a package-level write; in a collaboration room the engine then re-installs the
- * document, numbering its paragraph nodes afresh by position. The selection keeps its old node id,
- * which after a paragraph was inserted above it names a different paragraph, so the next keystroke
- * would go nowhere. The paragraph's own `w14:paraId` survives the re-install: the caret is put back
- * on it once, unless the person has moved it meanwhile.
+ * document, numbering its paragraph nodes afresh. Keystrokes typed in between would address the
+ * old nodes and be lost, so for a moment (until the document has been quiet for `settleMs`, at most
+ * `maxMs`) typed characters are held back; then the caret is put back on its paragraph — found by
+ * its `w14:paraId`, which survives the re-install — and what was typed goes in there. Any other key
+ * or a click ends the wait at once.
+ */
+export declare function holdCaret(editor: DocxEditorInstance, { settleMs, maxMs }?: {
+    settleMs?: number;
+    maxMs?: number;
+}): void;
+/**
+ * Run `fn` (an edit elsewhere in the document) and put the caret back where it was: on its
+ * paragraph, found by its `w14:paraId` (which survives the edits), at the same offset.
  */
-export declare function holdCaret(editor: DocxEditorInstance, timeoutMs?: number): void;
-export {};
+export declare function preservingCaret<T>(editor: DocxEditorInstance, fn: () => T): T;

package/dist/docx/index.cjs

@@ -1,9 +1,10 @@
 "use client";
 'use strict';
 
-var chunkN36PWG7A_cjs = require('../chunk-N36PWG7A.cjs');
-var chunkO33EBMIX_cjs = require('../chunk-O33EBMIX.cjs');
-require('../chunk-AOFATOT3.cjs');
+var chunkTP3FAP5J_cjs = require('../chunk-TP3FAP5J.cjs');
+var chunkZWWN4CUL_cjs = require('../chunk-ZWWN4CUL.cjs');
+require('../chunk-5FYU7ZIU.cjs');
+require('../chunk-2A4MDHJR.cjs');
 require('../chunk-RC25WMVB.cjs');
 require('../chunk-7UTB4PHM.cjs');
 require('../chunk-MHVNT4J3.cjs');
@@ -60,7 +61,7 @@ function NativeDocxComparison({
   if (!documentId)
     return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "native-docx-error", role: "status", children: "Comparing Word documents\u2026" });
   return /* @__PURE__ */ jsxRuntime.jsx(
-    chunkO33EBMIX_cjs.NativeDocxEditor,
+    chunkZWWN4CUL_cjs.NativeDocxEditor,
     {
       adapter,
       documentId,
@@ -72,131 +73,179 @@ function NativeDocxComparison({
 
 Object.defineProperty(exports, "StreamedWordArtifact", {
   enumerable: true,
-  get: function () { return chunkN36PWG7A_cjs.StreamedWordArtifact; }
+  get: function () { return chunkTP3FAP5J_cjs.StreamedWordArtifact; }
 });
 Object.defineProperty(exports, "BUILTIN_TEMPLATE_NAME", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.BUILTIN_TEMPLATE_NAME; }
+  get: function () { return chunkZWWN4CUL_cjs.BUILTIN_TEMPLATE_NAME; }
+});
+Object.defineProperty(exports, "CrossReferenceDialog", {
+  enumerable: true,
+  get: function () { return chunkZWWN4CUL_cjs.CrossReferenceDialog; }
+});
+Object.defineProperty(exports, "CrossReferencesProvider", {
+  enumerable: true,
+  get: function () { return chunkZWWN4CUL_cjs.CrossReferencesProvider; }
+});
+Object.defineProperty(exports, "DEFAULT_CROSS_REFERENCES_LABELS", {
+  enumerable: true,
+  get: function () { return chunkZWWN4CUL_cjs.DEFAULT_CROSS_REFERENCES_LABELS; }
 });
 Object.defineProperty(exports, "DEFAULT_DEFINED_TERMS_LABELS", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.DEFAULT_DEFINED_TERMS_LABELS; }
+  get: function () { return chunkZWWN4CUL_cjs.DEFAULT_DEFINED_TERMS_LABELS; }
 });
 Object.defineProperty(exports, "DEFINED_TERM_TRIGGER", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.DEFINED_TERM_TRIGGER; }
+  get: function () { return chunkZWWN4CUL_cjs.DEFINED_TERM_TRIGGER; }
 });
 Object.defineProperty(exports, "DefinedTermsProvider", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.DefinedTermsProvider; }
+  get: function () { return chunkZWWN4CUL_cjs.DefinedTermsProvider; }
 });
 Object.defineProperty(exports, "DocxAuthorContext", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.DocxAuthorContext; }
+  get: function () { return chunkZWWN4CUL_cjs.DocxAuthorContext; }
 });
 Object.defineProperty(exports, "DocxCommentActivity", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.DocxCommentActivity; }
+  get: function () { return chunkZWWN4CUL_cjs.DocxCommentActivity; }
 });
 Object.defineProperty(exports, "DocxEditorReview", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.DocxEditorReview; }
+  get: function () { return chunkZWWN4CUL_cjs.DocxEditorReview; }
 });
 Object.defineProperty(exports, "DocxMentions", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.DocxMentions; }
+  get: function () { return chunkZWWN4CUL_cjs.DocxMentions; }
 });
 Object.defineProperty(exports, "DocxParticipants", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.DocxParticipants; }
+  get: function () { return chunkZWWN4CUL_cjs.DocxParticipants; }
 });
 Object.defineProperty(exports, "DocxRibbon", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.DocxRibbon; }
+  get: function () { return chunkZWWN4CUL_cjs.DocxRibbon; }
 });
 Object.defineProperty(exports, "GenerateImageButton", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.GenerateImageButton; }
+  get: function () { return chunkZWWN4CUL_cjs.GenerateImageButton; }
 });
 Object.defineProperty(exports, "HouseTemplateProvider", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.HouseTemplateProvider; }
+  get: function () { return chunkZWWN4CUL_cjs.HouseTemplateProvider; }
+});
+Object.defineProperty(exports, "LinkHoverCard", {
+  enumerable: true,
+  get: function () { return chunkZWWN4CUL_cjs.LinkHoverCard; }
 });
 Object.defineProperty(exports, "NativeDocxEditor", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.NativeDocxEditor; }
+  get: function () { return chunkZWWN4CUL_cjs.NativeDocxEditor; }
 });
 Object.defineProperty(exports, "builtinHouseTemplate", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.builtinHouseTemplate; }
+  get: function () { return chunkZWWN4CUL_cjs.builtinHouseTemplate; }
 });
 Object.defineProperty(exports, "contentPath", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.contentPath; }
+  get: function () { return chunkZWWN4CUL_cjs.contentPath; }
 });
 Object.defineProperty(exports, "editorPort", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.editorPort; }
+  get: function () { return chunkZWWN4CUL_cjs.editorPort; }
 });
 Object.defineProperty(exports, "findDefinitionsSection", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.findDefinitionsSection; }
+  get: function () { return chunkZWWN4CUL_cjs.findDefinitionsSection; }
+});
+Object.defineProperty(exports, "insertCrossReference", {
+  enumerable: true,
+  get: function () { return chunkZWWN4CUL_cjs.insertCrossReference; }
 });
 Object.defineProperty(exports, "insertDefinedTerm", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.insertDefinedTerm; }
+  get: function () { return chunkZWWN4CUL_cjs.insertDefinedTerm; }
+});
+Object.defineProperty(exports, "insertDocumentReference", {
+  enumerable: true,
+  get: function () { return chunkZWWN4CUL_cjs.insertDocumentReference; }
+});
+Object.defineProperty(exports, "listTargets", {
+  enumerable: true,
+  get: function () { return chunkZWWN4CUL_cjs.listTargets; }
 });
 Object.defineProperty(exports, "loadDocxFonts", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.loadDocxFonts; }
+  get: function () { return chunkZWWN4CUL_cjs.loadDocxFonts; }
 });
 Object.defineProperty(exports, "normalizeDocxExport", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.normalizeDocxExport; }
+  get: function () { return chunkZWWN4CUL_cjs.normalizeDocxExport; }
+});
+Object.defineProperty(exports, "paragraphNumber", {
+  enumerable: true,
+  get: function () { return chunkZWWN4CUL_cjs.paragraphNumber; }
+});
+Object.defineProperty(exports, "referenceText", {
+  enumerable: true,
+  get: function () { return chunkZWWN4CUL_cjs.referenceText; }
+});
+Object.defineProperty(exports, "referencesPort", {
+  enumerable: true,
+  get: function () { return chunkZWWN4CUL_cjs.referencesPort; }
 });
 Object.defineProperty(exports, "resolveHouseTemplate", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.resolveHouseTemplate; }
+  get: function () { return chunkZWWN4CUL_cjs.resolveHouseTemplate; }
 });
 Object.defineProperty(exports, "reviewModule", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.reviewModule; }
+  get: function () { return chunkZWWN4CUL_cjs.reviewModule; }
+});
+Object.defineProperty(exports, "shortTitle", {
+  enumerable: true,
+  get: function () { return chunkZWWN4CUL_cjs.shortTitle; }
 });
 Object.defineProperty(exports, "structuralPort", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.structuralPort; }
+  get: function () { return chunkZWWN4CUL_cjs.structuralPort; }
 });
 Object.defineProperty(exports, "templateFileName", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.templateFileName; }
+  get: function () { return chunkZWWN4CUL_cjs.templateFileName; }
 });
 Object.defineProperty(exports, "trackedOrNoted", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.trackedOrNoted; }
+  get: function () { return chunkZWWN4CUL_cjs.trackedOrNoted; }
+});
+Object.defineProperty(exports, "useCrossReferences", {
+  enumerable: true,
+  get: function () { return chunkZWWN4CUL_cjs.useCrossReferences; }
 });
 Object.defineProperty(exports, "useDefinedTerms", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.useDefinedTerms; }
+  get: function () { return chunkZWWN4CUL_cjs.useDefinedTerms; }
 });
 Object.defineProperty(exports, "useHouseTemplate", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.useHouseTemplate; }
+  get: function () { return chunkZWWN4CUL_cjs.useHouseTemplate; }
 });
 Object.defineProperty(exports, "useReview", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.useReview; }
+  get: function () { return chunkZWWN4CUL_cjs.useReview; }
 });
 Object.defineProperty(exports, "useReviewItem", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.useReviewItem; }
+  get: function () { return chunkZWWN4CUL_cjs.useReviewItem; }
 });
 Object.defineProperty(exports, "useTrackedOrNoted", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.useTrackedOrNoted; }
+  get: function () { return chunkZWWN4CUL_cjs.useTrackedOrNoted; }
 });
 Object.defineProperty(exports, "withDirectEditing", {
   enumerable: true,
-  get: function () { return chunkO33EBMIX_cjs.withDirectEditing; }
+  get: function () { return chunkZWWN4CUL_cjs.withDirectEditing; }
 });
 Object.defineProperty(exports, "DocxEditor", {
   enumerable: true,

package/dist/docx/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/docx/NativeDocxComparison.tsx"],"names":["parseVersionRef","useRef","useState","useEffect","error","jsxs","jsx","NativeDocxEditor"],"mappings":";;;;;;;;;;;;;;;AAaA,SAAS,YAAA,CAAa,QAAgB,SAAA,EAAoC;AACxE,EAAA,MAAM,IAAA,GAAOA,0BAAgB,MAAM,CAAA;AACnC,EAAA,MAAM,OAAA,GAAUA,0BAAgB,SAAS,CAAA;AACzC,EAAA,MAAM,KAAA,GAAQ,IAAI,eAAA,CAAgB,EAAE,WAAA,EAAa,KAAK,KAAA,EAAO,cAAA,EAAgB,OAAA,CAAQ,KAAA,EAAO,CAAA;AAC5F,EAAA,IAAI,IAAA,CAAK,SAAS,KAAA,CAAM,GAAA,CAAI,gBAAgB,MAAA,CAAO,IAAA,CAAK,OAAO,CAAC,CAAA;AAChE,EAAA,IAAI,OAAA,CAAQ,SAAS,KAAA,CAAM,GAAA,CAAI,mBAAmB,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAC,CAAA;AACzE,EAAA,OAAO,KAAA;AACT;AAGO,SAAS,oBAAA,CAAqB;AAAA,EACnC,OAAA;AAAA,EACA,MAAA;AAAA,EACA,SAAA;AAAA,EACA,KAAA;AAAA,EACA;AACF,CAAA,EAA8B;AAC5B,EAAA,MAAM,IAAA,GAAOC,cAAA,CAAO,EAAE,OAAA,EAAS,YAAY,CAAA;AAC3C,EAAA,IAAA,CAAK,OAAA,GAAU,EAAE,OAAA,EAAS,UAAA,EAAW;AACrC,EAAA,MAAM,CAAC,UAAA,EAAY,aAAa,CAAA,GAAIC,iBAAS,EAAE,CAAA;AAC/C,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAIA,iBAAS,EAAE,CAAA;AACrC,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAIA,iBAAS,CAAC,CAAA;AACxC,EAAAC,iBAAA,CAAU,MAAM;AACd,IAAA,IAAI,SAAA,GAAY,KAAA;AAChB,IAAA,aAAA,CAAc,EAAE,CAAA;AAChB,IAAA,QAAA,CAAS,EAAE,CAAA;AACX,IAAA,KAAK,IAAA,CAAK,OAAA,CAAQ,OAAA,CACf,OAAA,CAAQ,CAAA,SAAA,EAAY,aAAa,MAAA,EAAQ,SAAS,CAAC,CAAA,CAAA,EAAI,EAAE,MAAA,EAAQ,QAAQ,CAAA,CACzE,IAAA,CAAK,CAAC,QAAA,KAAa,QAAA,CAAS,MAAM,CAAA,CAClC,IAAA,CAAK,CAAC,MAAA,KAAwC;AAC7C,MAAA,IAAI,CAAC,MAAA,CAAO,eAAA,EAAiB,MAAM,IAAI,MAAM,4CAA4C,CAAA;AACzF,MAAA,IAAI,CAAC,SAAA,EAAW;AACd,QAAA,aAAA,CAAc,OAAO,eAAe,CAAA;AACpC,QAAA,KAAK,OAAA,CAAQ,OAAA,CAAQ,IAAA,CAAK,OAAA,CAAQ,UAAA,GAAa,OAAO,eAAe,CAAC,CAAA,CAAE,KAAA,CAAM,MAAM;AAAA,QAAC,CAAC,CAAA;AAAA,MACxF;AAAA,IACF,CAAC,CAAA,CACA,KAAA,CAAM,CAACC,MAAAA,KAAU;AAChB,MAAA,IAAI,CAAC,WAAW,QAAA,CAASA,MAAAA,YAAiB,QAAQA,MAAAA,CAAM,OAAA,GAAU,MAAA,CAAOA,MAAK,CAAC,CAAA;AAAA,IACjF,CAAC,CAAA;AACH,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,IAAA;AAAA,IACd,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAC,CAAA;AAC/B,EAAA,IAAI,KAAA;AACF,IAAA,uBACEC,eAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,mBAAA,EAAoB,MAAK,OAAA,EACtC,QAAA,EAAA;AAAA,sBAAAC,cAAA,CAAC,OAAG,QAAA,EAAA,KAAA,EAAM,CAAA;AAAA,sBACVA,cAAA,CAAC,QAAA,EAAA,EAAO,OAAA,EAAS,MAAM,UAAA,CAAW,CAAC,KAAA,KAAU,KAAA,GAAQ,CAAC,CAAA,EAAG,QAAA,EAAA,kBAAA,EAAgB;AAAA,KAAA,EAC3E,CAAA;AAEJ,EAAA,IAAI,CAAC,UAAA;AACH,IAAA,sCACG,KAAA,EAAA,EAAI,SAAA,EAAU,mBAAA,EAAoB,IAAA,EAAK,UAAS,QAAA,EAAA,gCAAA,EAEjD,CAAA;AAEJ,EAAA,uBACEA,cAAA;AAAA,IAACC,kCAAA;AAAA,IAAA;AAAA,MAEC,OAAA;AAAA,MACA,UAAA;AAAA,MACA,OAAO,CAAA,EAAG,KAAA,CAAM,OAAA,CAAQ,UAAA,EAAY,EAAE,CAAC,CAAA,eAAA;AAAA,KAAA;AAAA,IAHlC;AAAA,GAIP;AAEJ","file":"index.cjs","sourcesContent":["import { useEffect, useRef, useState } from 'react'\nimport { parseVersionRef } from '@arbidocs/react/artifacts'\nimport { NativeDocxEditor, type NativeDocxAdapter } from './NativeDocxEditor'\n\nexport interface NativeDocxComparisonProps {\n  adapter: NativeDocxAdapter\n  baseId: string\n  revisedId: string\n  title: string\n  onCompared?: (documentId: string) => void | Promise<void>\n}\n\n/** A `doc-…@v{n}` side names an older version: the endpoint takes its document and version apart. */\nfunction redlineQuery(baseId: string, revisedId: string): URLSearchParams {\n  const base = parseVersionRef(baseId)\n  const revised = parseVersionRef(revisedId)\n  const query = new URLSearchParams({ base_ext_id: base.docId, revised_ext_id: revised.docId })\n  if (base.version) query.set('base_version', String(base.version))\n  if (revised.version) query.set('revised_version', String(revised.version))\n  return query\n}\n\n/** Word comparison through the host's authenticated transport and LibreOffice service. */\nexport function NativeDocxComparison({\n  adapter,\n  baseId,\n  revisedId,\n  title,\n  onCompared,\n}: NativeDocxComparisonProps) {\n  const host = useRef({ adapter, onCompared })\n  host.current = { adapter, onCompared }\n  const [documentId, setDocumentId] = useState('')\n  const [error, setError] = useState('')\n  const [attempt, setAttempt] = useState(0)\n  useEffect(() => {\n    let cancelled = false\n    setDocumentId('')\n    setError('')\n    void host.current.adapter\n      .request(`/redline?${redlineQuery(baseId, revisedId)}`, { method: 'POST' })\n      .then((response) => response.json())\n      .then((result: { document_ext_id: string }) => {\n        if (!result.document_ext_id) throw new Error('Comparison did not return a Word document.')\n        if (!cancelled) {\n          setDocumentId(result.document_ext_id)\n          void Promise.resolve(host.current.onCompared?.(result.document_ext_id)).catch(() => {})\n        }\n      })\n      .catch((error) => {\n        if (!cancelled) setError(error instanceof Error ? error.message : String(error))\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [baseId, revisedId, attempt])\n  if (error)\n    return (\n      <div className=\"native-docx-error\" role=\"alert\">\n        <p>{error}</p>\n        <button onClick={() => setAttempt((value) => value + 1)}>Retry comparison</button>\n      </div>\n    )\n  if (!documentId)\n    return (\n      <div className=\"native-docx-error\" role=\"status\">\n        Comparing Word documents…\n      </div>\n    )\n  return (\n    <NativeDocxEditor\n      key={documentId}\n      adapter={adapter}\n      documentId={documentId}\n      title={`${title.replace(/\\.[^.]+$/, '')} (redline).docx`}\n    />\n  )\n}\n"]}
+{"version":3,"sources":["../../src/docx/NativeDocxComparison.tsx"],"names":["parseVersionRef","useRef","useState","useEffect","error","jsxs","jsx","NativeDocxEditor"],"mappings":"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","file":"index.cjs","sourcesContent":["import { useEffect, useRef, useState } from 'react'\nimport { parseVersionRef } from '@arbidocs/react/artifacts'\nimport { NativeDocxEditor, type NativeDocxAdapter } from './NativeDocxEditor'\n\nexport interface NativeDocxComparisonProps {\n  adapter: NativeDocxAdapter\n  baseId: string\n  revisedId: string\n  title: string\n  onCompared?: (documentId: string) => void | Promise<void>\n}\n\n/** A `doc-…@v{n}` side names an older version: the endpoint takes its document and version apart. */\nfunction redlineQuery(baseId: string, revisedId: string): URLSearchParams {\n  const base = parseVersionRef(baseId)\n  const revised = parseVersionRef(revisedId)\n  const query = new URLSearchParams({ base_ext_id: base.docId, revised_ext_id: revised.docId })\n  if (base.version) query.set('base_version', String(base.version))\n  if (revised.version) query.set('revised_version', String(revised.version))\n  return query\n}\n\n/** Word comparison through the host's authenticated transport and LibreOffice service. */\nexport function NativeDocxComparison({\n  adapter,\n  baseId,\n  revisedId,\n  title,\n  onCompared,\n}: NativeDocxComparisonProps) {\n  const host = useRef({ adapter, onCompared })\n  host.current = { adapter, onCompared }\n  const [documentId, setDocumentId] = useState('')\n  const [error, setError] = useState('')\n  const [attempt, setAttempt] = useState(0)\n  useEffect(() => {\n    let cancelled = false\n    setDocumentId('')\n    setError('')\n    void host.current.adapter\n      .request(`/redline?${redlineQuery(baseId, revisedId)}`, { method: 'POST' })\n      .then((response) => response.json())\n      .then((result: { document_ext_id: string }) => {\n        if (!result.document_ext_id) throw new Error('Comparison did not return a Word document.')\n        if (!cancelled) {\n          setDocumentId(result.document_ext_id)\n          void Promise.resolve(host.current.onCompared?.(result.document_ext_id)).catch(() => {})\n        }\n      })\n      .catch((error) => {\n        if (!cancelled) setError(error instanceof Error ? error.message : String(error))\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [baseId, revisedId, attempt])\n  if (error)\n    return (\n      <div className=\"native-docx-error\" role=\"alert\">\n        <p>{error}</p>\n        <button onClick={() => setAttempt((value) => value + 1)}>Retry comparison</button>\n      </div>\n    )\n  if (!documentId)\n    return (\n      <div className=\"native-docx-error\" role=\"status\">\n        Comparing Word documents…\n      </div>\n    )\n  return (\n    <NativeDocxEditor\n      key={documentId}\n      adapter={adapter}\n      documentId={documentId}\n      title={`${title.replace(/\\.[^.]+$/, '')} (redline).docx`}\n    />\n  )\n}\n"]}

package/dist/docx/index.d.ts

@@ -12,6 +12,12 @@ export { NativeDocxComparison, type NativeDocxComparisonProps } from './NativeDo
 export { DefinedTermsProvider, useDefinedTerms, DEFINED_TERM_TRIGGER, DEFAULT_DEFINED_TERMS_LABELS, type DefinedTermsProviderProps, type DefinedTermsLabels, } from './definitions/DefinedTerms';
 export { insertDefinedTerm, findDefinitionsSection } from './definitions/commands';
 export { editorPort, withDirectEditing, type DefinitionsPort } from './definitions/port';
+export { CrossReferencesProvider, CrossReferenceDialog, useCrossReferences, DEFAULT_CROSS_REFERENCES_LABELS, type DocxReferencesAdapter, type CrossReferencesLabels, } from './references/CrossReferences';
+export { insertCrossReference, insertDocumentReference, type CrossReferenceMode, } from './references/commands';
+export { listTargets, paragraphNumber, type CrossReferenceTarget } from './references/numbering';
+export { referenceText, shortTitle, type DocumentPassage, type DocumentPassageTarget, type ReferenceDocument, } from './references/passages';
+export { referencesPort, type ReferencesPort } from './references/port';
+export { LinkHoverCard, type LinkHoverContent } from './LinkHoverCard';
 export { GenerateImageButton, type DocxImageGeneration } from './layout/GenerateImage';
 export { structuralPort, trackedOrNoted, type StructuralInsert, type StructuralOutcome, type StructuralPort, } from './structural/trackedOrNoted';
 export { DocxAuthorContext, useTrackedOrNoted } from './structural/useTrackedOrNoted';

package/dist/docx/index.js

@@ -1,8 +1,9 @@
 "use client";
-export { StreamedWordArtifact } from '../chunk-H6DFXG5N.js';
-import { NativeDocxEditor } from '../chunk-CVYY4X5R.js';
-export { BUILTIN_TEMPLATE_NAME, DEFAULT_DEFINED_TERMS_LABELS, DEFINED_TERM_TRIGGER, DefinedTermsProvider, DocxAuthorContext, DocxCommentActivity, DocxEditorReview, DocxMentions, DocxParticipants, DocxRibbon, GenerateImageButton, HouseTemplateProvider, NativeDocxEditor, builtinHouseTemplate, contentPath, editorPort, findDefinitionsSection, insertDefinedTerm, loadDocxFonts, normalizeDocxExport, resolveHouseTemplate, reviewModule, structuralPort, templateFileName, trackedOrNoted, useDefinedTerms, useHouseTemplate, useReview, useReviewItem, useTrackedOrNoted, withDirectEditing } from '../chunk-CVYY4X5R.js';
-import '../chunk-D3QPYKZG.js';
+export { StreamedWordArtifact } from '../chunk-PIT2YZCK.js';
+import { NativeDocxEditor } from '../chunk-W2RTZOK3.js';
+export { BUILTIN_TEMPLATE_NAME, CrossReferenceDialog, CrossReferencesProvider, DEFAULT_CROSS_REFERENCES_LABELS, DEFAULT_DEFINED_TERMS_LABELS, DEFINED_TERM_TRIGGER, DefinedTermsProvider, DocxAuthorContext, DocxCommentActivity, DocxEditorReview, DocxMentions, DocxParticipants, DocxRibbon, GenerateImageButton, HouseTemplateProvider, LinkHoverCard, NativeDocxEditor, builtinHouseTemplate, contentPath, editorPort, findDefinitionsSection, insertCrossReference, insertDefinedTerm, insertDocumentReference, listTargets, loadDocxFonts, normalizeDocxExport, paragraphNumber, referenceText, referencesPort, resolveHouseTemplate, reviewModule, shortTitle, structuralPort, templateFileName, trackedOrNoted, useCrossReferences, useDefinedTerms, useHouseTemplate, useReview, useReviewItem, useTrackedOrNoted, withDirectEditing } from '../chunk-W2RTZOK3.js';
+import '../chunk-HFZ45FD3.js';
+import '../chunk-EPHGD4YV.js';
 import '../chunk-AF6RDAJF.js';
 import '../chunk-AA3PT6KR.js';
 import '../chunk-7F6CBP3Z.js';

package/dist/docx/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/docx/NativeDocxComparison.tsx"],"names":["error"],"mappings":"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","file":"index.js","sourcesContent":["import { useEffect, useRef, useState } from 'react'\nimport { parseVersionRef } from '@arbidocs/react/artifacts'\nimport { NativeDocxEditor, type NativeDocxAdapter } from './NativeDocxEditor'\n\nexport interface NativeDocxComparisonProps {\n  adapter: NativeDocxAdapter\n  baseId: string\n  revisedId: string\n  title: string\n  onCompared?: (documentId: string) => void | Promise<void>\n}\n\n/** A `doc-…@v{n}` side names an older version: the endpoint takes its document and version apart. */\nfunction redlineQuery(baseId: string, revisedId: string): URLSearchParams {\n  const base = parseVersionRef(baseId)\n  const revised = parseVersionRef(revisedId)\n  const query = new URLSearchParams({ base_ext_id: base.docId, revised_ext_id: revised.docId })\n  if (base.version) query.set('base_version', String(base.version))\n  if (revised.version) query.set('revised_version', String(revised.version))\n  return query\n}\n\n/** Word comparison through the host's authenticated transport and LibreOffice service. */\nexport function NativeDocxComparison({\n  adapter,\n  baseId,\n  revisedId,\n  title,\n  onCompared,\n}: NativeDocxComparisonProps) {\n  const host = useRef({ adapter, onCompared })\n  host.current = { adapter, onCompared }\n  const [documentId, setDocumentId] = useState('')\n  const [error, setError] = useState('')\n  const [attempt, setAttempt] = useState(0)\n  useEffect(() => {\n    let cancelled = false\n    setDocumentId('')\n    setError('')\n    void host.current.adapter\n      .request(`/redline?${redlineQuery(baseId, revisedId)}`, { method: 'POST' })\n      .then((response) => response.json())\n      .then((result: { document_ext_id: string }) => {\n        if (!result.document_ext_id) throw new Error('Comparison did not return a Word document.')\n        if (!cancelled) {\n          setDocumentId(result.document_ext_id)\n          void Promise.resolve(host.current.onCompared?.(result.document_ext_id)).catch(() => {})\n        }\n      })\n      .catch((error) => {\n        if (!cancelled) setError(error instanceof Error ? error.message : String(error))\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [baseId, revisedId, attempt])\n  if (error)\n    return (\n      <div className=\"native-docx-error\" role=\"alert\">\n        <p>{error}</p>\n        <button onClick={() => setAttempt((value) => value + 1)}>Retry comparison</button>\n      </div>\n    )\n  if (!documentId)\n    return (\n      <div className=\"native-docx-error\" role=\"status\">\n        Comparing Word documents…\n      </div>\n    )\n  return (\n    <NativeDocxEditor\n      key={documentId}\n      adapter={adapter}\n      documentId={documentId}\n      title={`${title.replace(/\\.[^.]+$/, '')} (redline).docx`}\n    />\n  )\n}\n"]}
+{"version":3,"sources":["../../src/docx/NativeDocxComparison.tsx"],"names":["error"],"mappings":";;;;;;;;;;;;;;;AAaA,SAAS,YAAA,CAAa,QAAgB,SAAA,EAAoC;AACxE,EAAA,MAAM,IAAA,GAAO,gBAAgB,MAAM,CAAA;AACnC,EAAA,MAAM,OAAA,GAAU,gBAAgB,SAAS,CAAA;AACzC,EAAA,MAAM,KAAA,GAAQ,IAAI,eAAA,CAAgB,EAAE,WAAA,EAAa,KAAK,KAAA,EAAO,cAAA,EAAgB,OAAA,CAAQ,KAAA,EAAO,CAAA;AAC5F,EAAA,IAAI,IAAA,CAAK,SAAS,KAAA,CAAM,GAAA,CAAI,gBAAgB,MAAA,CAAO,IAAA,CAAK,OAAO,CAAC,CAAA;AAChE,EAAA,IAAI,OAAA,CAAQ,SAAS,KAAA,CAAM,GAAA,CAAI,mBAAmB,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAC,CAAA;AACzE,EAAA,OAAO,KAAA;AACT;AAGO,SAAS,oBAAA,CAAqB;AAAA,EACnC,OAAA;AAAA,EACA,MAAA;AAAA,EACA,SAAA;AAAA,EACA,KAAA;AAAA,EACA;AACF,CAAA,EAA8B;AAC5B,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,EAAE,OAAA,EAAS,YAAY,CAAA;AAC3C,EAAA,IAAA,CAAK,OAAA,GAAU,EAAE,OAAA,EAAS,UAAA,EAAW;AACrC,EAAA,MAAM,CAAC,UAAA,EAAY,aAAa,CAAA,GAAI,SAAS,EAAE,CAAA;AAC/C,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,SAAS,EAAE,CAAA;AACrC,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAI,SAAS,CAAC,CAAA;AACxC,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,SAAA,GAAY,KAAA;AAChB,IAAA,aAAA,CAAc,EAAE,CAAA;AAChB,IAAA,QAAA,CAAS,EAAE,CAAA;AACX,IAAA,KAAK,IAAA,CAAK,OAAA,CAAQ,OAAA,CACf,OAAA,CAAQ,CAAA,SAAA,EAAY,aAAa,MAAA,EAAQ,SAAS,CAAC,CAAA,CAAA,EAAI,EAAE,MAAA,EAAQ,QAAQ,CAAA,CACzE,IAAA,CAAK,CAAC,QAAA,KAAa,QAAA,CAAS,MAAM,CAAA,CAClC,IAAA,CAAK,CAAC,MAAA,KAAwC;AAC7C,MAAA,IAAI,CAAC,MAAA,CAAO,eAAA,EAAiB,MAAM,IAAI,MAAM,4CAA4C,CAAA;AACzF,MAAA,IAAI,CAAC,SAAA,EAAW;AACd,QAAA,aAAA,CAAc,OAAO,eAAe,CAAA;AACpC,QAAA,KAAK,OAAA,CAAQ,OAAA,CAAQ,IAAA,CAAK,OAAA,CAAQ,UAAA,GAAa,OAAO,eAAe,CAAC,CAAA,CAAE,KAAA,CAAM,MAAM;AAAA,QAAC,CAAC,CAAA;AAAA,MACxF;AAAA,IACF,CAAC,CAAA,CACA,KAAA,CAAM,CAACA,MAAAA,KAAU;AAChB,MAAA,IAAI,CAAC,WAAW,QAAA,CAASA,MAAAA,YAAiB,QAAQA,MAAAA,CAAM,OAAA,GAAU,MAAA,CAAOA,MAAK,CAAC,CAAA;AAAA,IACjF,CAAC,CAAA;AACH,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,IAAA;AAAA,IACd,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAC,CAAA;AAC/B,EAAA,IAAI,KAAA;AACF,IAAA,uBACE,IAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,mBAAA,EAAoB,MAAK,OAAA,EACtC,QAAA,EAAA;AAAA,sBAAA,GAAA,CAAC,OAAG,QAAA,EAAA,KAAA,EAAM,CAAA;AAAA,sBACV,GAAA,CAAC,QAAA,EAAA,EAAO,OAAA,EAAS,MAAM,UAAA,CAAW,CAAC,KAAA,KAAU,KAAA,GAAQ,CAAC,CAAA,EAAG,QAAA,EAAA,kBAAA,EAAgB;AAAA,KAAA,EAC3E,CAAA;AAEJ,EAAA,IAAI,CAAC,UAAA;AACH,IAAA,2BACG,KAAA,EAAA,EAAI,SAAA,EAAU,mBAAA,EAAoB,IAAA,EAAK,UAAS,QAAA,EAAA,gCAAA,EAEjD,CAAA;AAEJ,EAAA,uBACE,GAAA;AAAA,IAAC,gBAAA;AAAA,IAAA;AAAA,MAEC,OAAA;AAAA,MACA,UAAA;AAAA,MACA,OAAO,CAAA,EAAG,KAAA,CAAM,OAAA,CAAQ,UAAA,EAAY,EAAE,CAAC,CAAA,eAAA;AAAA,KAAA;AAAA,IAHlC;AAAA,GAIP;AAEJ","file":"index.js","sourcesContent":["import { useEffect, useRef, useState } from 'react'\nimport { parseVersionRef } from '@arbidocs/react/artifacts'\nimport { NativeDocxEditor, type NativeDocxAdapter } from './NativeDocxEditor'\n\nexport interface NativeDocxComparisonProps {\n  adapter: NativeDocxAdapter\n  baseId: string\n  revisedId: string\n  title: string\n  onCompared?: (documentId: string) => void | Promise<void>\n}\n\n/** A `doc-…@v{n}` side names an older version: the endpoint takes its document and version apart. */\nfunction redlineQuery(baseId: string, revisedId: string): URLSearchParams {\n  const base = parseVersionRef(baseId)\n  const revised = parseVersionRef(revisedId)\n  const query = new URLSearchParams({ base_ext_id: base.docId, revised_ext_id: revised.docId })\n  if (base.version) query.set('base_version', String(base.version))\n  if (revised.version) query.set('revised_version', String(revised.version))\n  return query\n}\n\n/** Word comparison through the host's authenticated transport and LibreOffice service. */\nexport function NativeDocxComparison({\n  adapter,\n  baseId,\n  revisedId,\n  title,\n  onCompared,\n}: NativeDocxComparisonProps) {\n  const host = useRef({ adapter, onCompared })\n  host.current = { adapter, onCompared }\n  const [documentId, setDocumentId] = useState('')\n  const [error, setError] = useState('')\n  const [attempt, setAttempt] = useState(0)\n  useEffect(() => {\n    let cancelled = false\n    setDocumentId('')\n    setError('')\n    void host.current.adapter\n      .request(`/redline?${redlineQuery(baseId, revisedId)}`, { method: 'POST' })\n      .then((response) => response.json())\n      .then((result: { document_ext_id: string }) => {\n        if (!result.document_ext_id) throw new Error('Comparison did not return a Word document.')\n        if (!cancelled) {\n          setDocumentId(result.document_ext_id)\n          void Promise.resolve(host.current.onCompared?.(result.document_ext_id)).catch(() => {})\n        }\n      })\n      .catch((error) => {\n        if (!cancelled) setError(error instanceof Error ? error.message : String(error))\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [baseId, revisedId, attempt])\n  if (error)\n    return (\n      <div className=\"native-docx-error\" role=\"alert\">\n        <p>{error}</p>\n        <button onClick={() => setAttempt((value) => value + 1)}>Retry comparison</button>\n      </div>\n    )\n  if (!documentId)\n    return (\n      <div className=\"native-docx-error\" role=\"status\">\n        Comparing Word documents…\n      </div>\n    )\n  return (\n    <NativeDocxEditor\n      key={documentId}\n      adapter={adapter}\n      documentId={documentId}\n      title={`${title.replace(/\\.[^.]+$/, '')} (redline).docx`}\n    />\n  )\n}\n"]}

package/dist/docx/references/CrossReferences.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Cross-references in the Word editor: the Insert cross-reference dialog (within this document,
+ * to a numbered clause or a heading; or to a passage of another document of the workspace), a
+ * hover card on an inserted reference showing what it points at, and in-app navigation when a
+ * reference to another document is clicked. Mount `CrossReferencesProvider` inside
+ * `DocxEditor.Root`; the ribbon and the context menu read it from context.
+ */
+import React, { type ReactNode } from 'react';
+import { type CrossReferenceMode } from './commands';
+import { type CrossReferenceTarget } from './numbering';
+import { type DocumentPassage, type DocumentPassageTarget, type ReferenceDocument } from './passages';
+/** What the host supplies for references to its other documents. */
+export interface DocxReferencesAdapter {
+    /** The documents a reference can point into (the open one is left out). */
+    documents: () => Promise<ReferenceDocument[]>;
+    /** A document's passages, in document order. */
+    passages: (documentId: string) => Promise<DocumentPassage[]>;
+    /** The address a reference links to (the app's link to that passage, so it works from Word). */
+    linkFor: (target: DocumentPassageTarget) => string;
+    /** The passage a link addresses, or null for any other link. */
+    targetOf: (href: string) => DocumentPassageTarget | null;
+    /** Open the document at that passage, highlighted. */
+    open: (target: DocumentPassageTarget) => void;
+    /** The app's name, for a reference's screen tip ("… opens in ARBI"). Default ARBI. */
+    appName?: string;
+    /** The host's document picker, as a slot (receives the chosen document id). */
+    renderDocumentPicker?: (onSelect: (documentId: string) => void, selectedId: string | null) => ReactNode;
+}
+export interface CrossReferencesLabels {
+    insert: string;
+    title: string;
+    description: string;
+    thisDocument: string;
+    otherDocument: string;
+    filterTargets: string;
+    noTargets: string;
+    number: string;
+    text: string;
+    insertAs: string;
+    chooseDocument: string;
+    filterPassages: string;
+    loadingPassages: string;
+    noPassages: string;
+    referenceText: string;
+    insertButton: string;
+    cancel: string;
+    clause: (number: string) => string;
+    heading: string;
+    update: string;
+    updated: string;
+    updateSummary: (refreshed: number) => string;
+    brokenTitle: string;
+    brokenNone: string;
+    brokenHelp: string;
+    brokenCard: string;
+    brokenCardBody: string;
+    show: string;
+    close: string;
+}
+export declare const DEFAULT_CROSS_REFERENCES_LABELS: CrossReferencesLabels;
+interface CrossReferencesContextValue {
+    /** Open the Insert cross-reference dialog for the caret. */
+    openDialog: () => void;
+    /** Update every cross-reference and show what changed and what is broken. */
+    update: () => void;
+    labels: CrossReferencesLabels;
+}
+/** The cross-reference commands, or `null` where the editor cannot take them. */
+export declare const useCrossReferences: () => CrossReferencesContextValue | null;
+export interface CrossReferencesProviderProps {
+    children: ReactNode;
+    /** Editing is possible (not a snapshot, a stream or a read-only document). */
+    editable: boolean;
+    /** References to other documents; absent, only this document's clauses are offered. */
+    references?: DocxReferencesAdapter;
+    /** The open document, left out of the documents to refer to. */
+    documentId?: string;
+    notify?: (message: string, kind: 'success' | 'error') => void;
+    labels?: Partial<CrossReferencesLabels>;
+}
+export declare function CrossReferencesProvider({ children, editable, references, documentId, notify, labels, }: CrossReferencesProviderProps): React.JSX.Element;
+export interface CrossReferenceDialogProps {
+    targets: CrossReferenceTarget[];
+    references?: DocxReferencesAdapter;
+    documentId?: string;
+    passages: Record<string, DocumentPassage[] | 'loading'>;
+    loadPassages: (documentId: string) => void;
+    labels?: Partial<CrossReferencesLabels>;
+    onCancel: () => void;
+    onInsertTarget: (target: CrossReferenceTarget, mode: CrossReferenceMode) => void;
+    onInsertPassage: (target: DocumentPassageTarget, text: string) => void;
+    /** After the dialog has closed: focus goes here (the document), not back to what opened it. */
+    onClosed?: () => void;
+}
+/** The Insert cross-reference dialog: a target of this document, or a passage of another one. */
+export declare function CrossReferenceDialog({ targets, references, documentId, passages, loadPassages, labels, onCancel, onInsertTarget, onInsertPassage, onClosed, }: CrossReferenceDialogProps): React.JSX.Element;
+export {};

package/dist/docx/references/EditorMenus.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Where the defined-term and cross-reference commands sit in the editor's chrome: an Insert-tab
+ * button, and rows appended to the editor's own right-click menu (its Cut, Copy, Paste… stay).
+ */
+/** Insert tab: Insert cross-reference. */
+export declare function CrossReferenceButton(): import("react").JSX.Element | null;
+/** References tab: Update cross-references (numbers brought up to date, broken ones listed). */
+export declare function UpdateCrossReferencesButton(): import("react").JSX.Element | null;
+/** Rows for the editor's right-click menu: Insert defined term, Insert cross-reference. */
+export declare function DocxContextMenuExtras(): import("react").JSX.Element | null;