@arbidocs/blocks 0.4.102 → 0.4.104

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/RibbonMenu.d.ts

@@ -5,7 +5,7 @@ import React from 'react';
  * press outside it. `children` may be a function that receives `close`, for panels that close
  * themselves once the user has picked something.
  */
-export declare function RibbonMenu({ label, icon, children, className, testId, title, }: {
+export declare function RibbonMenu({ label, icon, children, className, testId, title, keepMounted, popoverClassName, }: {
     label: string;
     /** Tooltip; defaults to `label`. */
     title?: string;
@@ -14,4 +14,7 @@ export declare function RibbonMenu({ label, icon, children, className, testId, t
     children: React.ReactNode | ((close: () => void) => React.ReactNode);
     className?: string;
     testId?: string;
+    /** Keep the panel's content mounted (hidden) while closed, so its controls keep their state. */
+    keepMounted?: boolean;
+    popoverClassName?: string;
 }): React.JSX.Element;

package/dist/docx/RibbonOverflow.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A ribbon tab's row of controls that never crowds: what does not fit collapses into a trailing
+ * "…" (More) menu, as Word's ribbon does. Each control is a `RibbonItem` with a label and a
+ * priority; the row measures the controls (ResizeObserver) and collapses the lowest priority
+ * first, the rightmost first among equals. A collapsed control is the same component, moved by a
+ * portal into its row of the More menu, beside its label, so it keeps working (and keeps its
+ * state while the menu is closed).
+ */
+import React from 'react';
+/**
+ * The row of one ribbon tab. `tab` names the tab shown, so the More menu closes and the row is
+ * measured afresh when it changes.
+ */
+export declare function RibbonOverflow({ tab, children }: {
+    tab: string;
+    children: React.ReactNode;
+}): React.JSX.Element;
+/**
+ * One control of a ribbon row. `label` names it in the More menu; `priority` (default 0) decides
+ * what collapses first. Outside a `RibbonOverflow` it renders its children as they are.
+ */
+export declare function RibbonItem({ id, label, priority, children, }: {
+    id: string;
+    label: string;
+    priority?: number;
+    children: React.ReactNode;
+}): React.JSX.Element;

package/dist/docx/WordReferences.d.ts

@@ -6,8 +6,9 @@
  * and its note in `footnotes.xml` (creating the part on a document that has none), moves the caret
  * into the note so the user types it straight away, numbers notes in document order, and lays
  * them out at the foot of the page, where an existing note is edited in place. What it leaves out
- * is Word's note paragraph style, so a new note is given the document's "footnote text" (or
- * "endnote text") style when it defines one.
+ * is what Word adds around a new note: the note styles in a document that has none (without
+ * "footnote reference" the reference and the number are painted at body size on the baseline),
+ * the note's "footnote text" (or "endnote text") paragraph style, and the space after its number.
  */
 import React, { type RefObject } from 'react';
 /** References tab: Insert footnote, Insert endnote. */

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 chunkZT2EBBSC_cjs = require('../chunk-ZT2EBBSC.cjs');
-var chunkFAGQTB3D_cjs = require('../chunk-FAGQTB3D.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(
-    chunkFAGQTB3D_cjs.NativeDocxEditor,
+    chunkZWWN4CUL_cjs.NativeDocxEditor,
     {
       adapter,
       documentId,
@@ -72,131 +73,179 @@ function NativeDocxComparison({
 
 Object.defineProperty(exports, "StreamedWordArtifact", {
   enumerable: true,
-  get: function () { return chunkZT2EBBSC_cjs.StreamedWordArtifact; }
+  get: function () { return chunkTP3FAP5J_cjs.StreamedWordArtifact; }
 });
 Object.defineProperty(exports, "BUILTIN_TEMPLATE_NAME", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_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 chunkFAGQTB3D_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 chunkFAGQTB3D_cjs.DEFINED_TERM_TRIGGER; }
+  get: function () { return chunkZWWN4CUL_cjs.DEFINED_TERM_TRIGGER; }
 });
 Object.defineProperty(exports, "DefinedTermsProvider", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.DefinedTermsProvider; }
+  get: function () { return chunkZWWN4CUL_cjs.DefinedTermsProvider; }
 });
 Object.defineProperty(exports, "DocxAuthorContext", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.DocxAuthorContext; }
+  get: function () { return chunkZWWN4CUL_cjs.DocxAuthorContext; }
 });
 Object.defineProperty(exports, "DocxCommentActivity", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.DocxCommentActivity; }
+  get: function () { return chunkZWWN4CUL_cjs.DocxCommentActivity; }
 });
 Object.defineProperty(exports, "DocxEditorReview", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.DocxEditorReview; }
+  get: function () { return chunkZWWN4CUL_cjs.DocxEditorReview; }
 });
 Object.defineProperty(exports, "DocxMentions", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.DocxMentions; }
+  get: function () { return chunkZWWN4CUL_cjs.DocxMentions; }
 });
 Object.defineProperty(exports, "DocxParticipants", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.DocxParticipants; }
+  get: function () { return chunkZWWN4CUL_cjs.DocxParticipants; }
 });
 Object.defineProperty(exports, "DocxRibbon", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.DocxRibbon; }
+  get: function () { return chunkZWWN4CUL_cjs.DocxRibbon; }
 });
 Object.defineProperty(exports, "GenerateImageButton", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.GenerateImageButton; }
+  get: function () { return chunkZWWN4CUL_cjs.GenerateImageButton; }
 });
 Object.defineProperty(exports, "HouseTemplateProvider", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_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 chunkFAGQTB3D_cjs.NativeDocxEditor; }
+  get: function () { return chunkZWWN4CUL_cjs.NativeDocxEditor; }
 });
 Object.defineProperty(exports, "builtinHouseTemplate", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.builtinHouseTemplate; }
+  get: function () { return chunkZWWN4CUL_cjs.builtinHouseTemplate; }
 });
 Object.defineProperty(exports, "contentPath", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.contentPath; }
+  get: function () { return chunkZWWN4CUL_cjs.contentPath; }
 });
 Object.defineProperty(exports, "editorPort", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.editorPort; }
+  get: function () { return chunkZWWN4CUL_cjs.editorPort; }
 });
 Object.defineProperty(exports, "findDefinitionsSection", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_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 chunkFAGQTB3D_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 chunkFAGQTB3D_cjs.loadDocxFonts; }
+  get: function () { return chunkZWWN4CUL_cjs.loadDocxFonts; }
 });
 Object.defineProperty(exports, "normalizeDocxExport", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_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 chunkFAGQTB3D_cjs.resolveHouseTemplate; }
+  get: function () { return chunkZWWN4CUL_cjs.resolveHouseTemplate; }
 });
 Object.defineProperty(exports, "reviewModule", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_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 chunkFAGQTB3D_cjs.structuralPort; }
+  get: function () { return chunkZWWN4CUL_cjs.structuralPort; }
 });
 Object.defineProperty(exports, "templateFileName", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.templateFileName; }
+  get: function () { return chunkZWWN4CUL_cjs.templateFileName; }
 });
 Object.defineProperty(exports, "trackedOrNoted", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_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 chunkFAGQTB3D_cjs.useDefinedTerms; }
+  get: function () { return chunkZWWN4CUL_cjs.useDefinedTerms; }
 });
 Object.defineProperty(exports, "useHouseTemplate", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.useHouseTemplate; }
+  get: function () { return chunkZWWN4CUL_cjs.useHouseTemplate; }
 });
 Object.defineProperty(exports, "useReview", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.useReview; }
+  get: function () { return chunkZWWN4CUL_cjs.useReview; }
 });
 Object.defineProperty(exports, "useReviewItem", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.useReviewItem; }
+  get: function () { return chunkZWWN4CUL_cjs.useReviewItem; }
 });
 Object.defineProperty(exports, "useTrackedOrNoted", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_cjs.useTrackedOrNoted; }
+  get: function () { return chunkZWWN4CUL_cjs.useTrackedOrNoted; }
 });
 Object.defineProperty(exports, "withDirectEditing", {
   enumerable: true,
-  get: function () { return chunkFAGQTB3D_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":"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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"]}
+{"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"]}

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-YGREW5TZ.js';
-import { NativeDocxEditor } from '../chunk-MYALCKDR.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-MYALCKDR.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":"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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"]}

package/dist/docx/noteStyles.d.ts

@@ -0,0 +1,46 @@
+export type NoteKind = 'footnote' | 'endnote';
+/** A style the document defines, as the engine lists them (`getDocumentStyles`). */
+export interface DocumentStyle {
+    readonly styleId: string;
+    readonly name: string;
+    readonly type: string;
+}
+/** The note text style among `styles`: by Word's built-in name, else by its standard id. */
+export declare function noteTextStyle(styles: readonly DocumentStyle[], kind: NoteKind): string | undefined;
+/**
+ * The definitions of the note styles `styles` lacks, in `styles.xml` form ([] when none). The
+ * reference style is matched by id, the id the engine writes on the reference; the text style by
+ * Word's built-in name too, which a document saved in another language keeps under its own id.
+ */
+export declare function missingNoteStyles(styles: readonly DocumentStyle[], kind: NoteKind): string[];
+/**
+ * A fragment that carries only `styles`: one empty, open paragraph, so pasting it at the caret
+ * inserts nothing and the editor's paste merges the styles the document lacks (as it does for a
+ * Quick Part's).
+ */
+export declare function stylesOnlyClipboardHtml(styles: readonly string[]): string;
+/** The editor surface `ensureNoteStyles` needs. */
+interface NoteStyleEditor {
+    can(command: {
+        type: 'insertNote';
+        noteKind: NoteKind;
+    }): {
+        ok: boolean;
+    };
+    getDocumentStyles(): readonly DocumentStyle[];
+    exec(command: {
+        type: 'paste';
+        text: string;
+        html: string;
+    }): {
+        ok: boolean;
+    };
+}
+/**
+ * Before a note is inserted: add Word's note styles the document lacks, so the reference and the
+ * note number are superscript and the note text is Word's smaller footnote text. `direct` runs
+ * the write untracked, as Word adds styles. Returns the id of the document's note text style
+ * ("footnote text" / "endnote text"), for the new note's paragraph.
+ */
+export declare function ensureNoteStyles(editor: NoteStyleEditor, kind: NoteKind, direct?: <T>(fn: () => T) => T): string | undefined;
+export {};

package/dist/docx/overflowPlan.d.ts

@@ -0,0 +1,15 @@
+/** What a ribbon row collapses into its More menu (see `RibbonOverflow`). */
+/** One control as the row measured it, in ribbon order. */
+export interface OverflowItem {
+    id: string;
+    /** Width in the row, including the gap after it. */
+    width: number;
+    /** Higher stays in the row longer. */
+    priority: number;
+}
+/**
+ * The controls to collapse so the rest fit in `available` beside a More trigger `moreWidth`
+ * wide: none when everything fits; otherwise the lowest priority first, and among equal
+ * priorities the rightmost first.
+ */
+export declare function planOverflow(items: readonly OverflowItem[], available: number, moreWidth: number): Set<string>;