@arbidocs/blocks 0.4.92 → 0.4.94

package/dist/docx/NativeDocxEditor.d.ts

@@ -2,6 +2,7 @@ import { type DocxMention, type DocxAgentCommentRequest, type DocxMentionDeliver
 import React from 'react';
 import { type FontConfiguration } from '@docx-editor.dev/react';
 import type { DocxCollaborationSession } from '@arbidocs/coedit';
+import type { DefinitionSource } from '../tags/definitions';
 /**
  * The editor path of a document's DOCX bytes. A version reference (`doc-…@v2`, a read-only
  * snapshot of an older version) reads that version; a plain id the current one.
@@ -38,6 +39,11 @@ export interface NativeDocxAdapter {
     mentions?: readonly DocxMention[];
     requestAgent?: (documentId: string, request: DocxAgentCommentRequest) => Promise<DocxMentionDelivery | void>;
     getAgentStatus?: (responseId: string) => Promise<DocxAgentRunStatus>;
+    /**
+     * The workspace's definitions: facts labelled "Definitions". Present: the Insert tab offers
+     * Defined term and Update definitions, and typing `@@` in the body opens the term type-ahead.
+     */
+    definitions?: () => Promise<DefinitionSource[]>;
 }
 export interface NativeDocxEditorProps {
     adapter: NativeDocxAdapter;

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

@@ -0,0 +1,50 @@
+/**
+ * Defined terms in the Word editor: a type-ahead of the workspace's definitions (typing `@@` in the
+ * body, or Insert › Defined term), a hover card on an inserted term, and Update definitions. Mount
+ * `DefinedTermsProvider` inside `DocxEditor.Root`; the ribbon's buttons read it from context.
+ */
+import React from 'react';
+import { type DefinitionSource } from '../../tags/definitions';
+import { type UpdateDefinitionsResult } from './commands';
+/** Typing this in the body opens the type-ahead. */
+export declare const DEFINED_TERM_TRIGGER = "@@";
+export interface DefinedTermsLabels {
+    insert: string;
+    update: string;
+    search: string;
+    allAgreements: string;
+    loading: string;
+    empty: string;
+    noMatch: string;
+    hint: string;
+    preferred: string;
+    alsoIn: (source: string) => string;
+    updated: string;
+    updateSummary: (r: UpdateDefinitionsResult) => string;
+    unusedTitle: string;
+    unusedNone: string;
+    unknownTitle: string;
+    show: string;
+    close: string;
+}
+export declare const DEFAULT_DEFINED_TERMS_LABELS: DefinedTermsLabels;
+interface DefinedTermsContextValue {
+    /** Open the type-ahead at the caret, with a search box. */
+    openPicker: (anchor?: HTMLElement | null) => void;
+    /** Update the Definitions section and show what changed. */
+    update: () => void;
+    labels: DefinedTermsLabels;
+}
+/** The defined-term commands, or `null` where the editor has no definitions to offer. */
+export declare const useDefinedTerms: () => DefinedTermsContextValue | null;
+export interface DefinedTermsProviderProps {
+    children: React.ReactNode;
+    /** The workspace's definition facts. Absent: no defined-term features. */
+    load?: () => Promise<DefinitionSource[]>;
+    /** Editing is possible (not a snapshot, a stream or a read-only document). */
+    editable: boolean;
+    notify?: (message: string, kind: 'success' | 'error') => void;
+    labels?: Partial<DefinedTermsLabels>;
+}
+export declare function DefinedTermsProvider({ children, load, editable, notify, labels, }: DefinedTermsProviderProps): React.JSX.Element;
+export {};

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

@@ -0,0 +1,78 @@
+/**
+ * The defined-term commands: insert a term as a link to its definition (adding the definition to
+ * the document's Definitions section when it is not there yet), and update the section from the
+ * definition facts. Written against {@link DefinitionsPort}, so they run on the live editor and on
+ * the in-memory model the tests use alike.
+ *
+ * Where the Definitions section is: the first top-level paragraph titled "Definitions",
+ * "Definitions and interpretation", "Interpretation", "Defined terms" or "Glossary" (clause numbers
+ * ignored), up to the next heading. A document without one gets a "Definitions" heading at its end:
+ * appended, it never splits the clause being drafted, and it is where a reader of a draft looks
+ * for a schedule of terms. Inside the section, definitions are kept in alphabetical order.
+ */
+import { type Definition } from '../../tags/definitions';
+import type { DefinitionsPort, DocParagraph, DocPoint } from './port';
+/** Title of a Definitions section the commands create. */
+export declare const DEFINITIONS_HEADING = "Definitions";
+/** Whether a paragraph titles a Definitions section. */
+export declare function isDefinitionsTitle(paragraph: DocParagraph): boolean;
+/** The Definitions section: its title's index and the paragraphs after it, up to the next heading. */
+export interface DefinitionsSection {
+    title: number;
+    /** First paragraph after the title. */
+    start: number;
+    /** Index after the section's last paragraph (the next heading, a table, or the end). */
+    end: number;
+}
+export declare function findDefinitionsSection(paragraphs: readonly DocParagraph[]): DefinitionsSection | null;
+/**
+ * Where a definition of `term` goes in the section, alphabetically: before the first definition
+ * whose term sorts after it, else after the last definition (else right after the title).
+ */
+export declare function insertionIndex(paragraphs: readonly DocParagraph[], section: DefinitionsSection, term: string, skip?: ReadonlySet<string>): number;
+/**
+ * Add a definition paragraph to the Definitions section (made at the end of the document when there
+ * is none), in alphabetical order. Answers where `keep` moved to.
+ */
+export declare function addDefinition(port: DefinitionsPort, definition: Definition, keep?: DocPoint): DocPoint | undefined;
+export interface InsertTermResult {
+    /** The definition was not in the document yet and was added to its Definitions section. */
+    addedDefinition: boolean;
+}
+/**
+ * Insert a defined term at the caret: the term as an internal link to its definition's bookmark
+ * (its definition as the link's tooltip), the definition added to the Definitions section first
+ * when the document does not have it. `replace` characters before the caret (a typed `@@query`)
+ * are removed first. The caret ends after the term.
+ */
+export declare function insertDefinedTerm(port: DefinitionsPort, definition: Definition, options?: {
+    replace?: number;
+}): InsertTermResult;
+/** A definition in the section that nothing in the document uses. */
+export interface UnusedDefinition {
+    term: string;
+    paragraphId: string;
+}
+export interface UpdateDefinitionsResult {
+    /** Terms whose definitions were added (linked from the text, missing from the section). */
+    added: string[];
+    /** Terms whose wording changed to the fact's current text. */
+    refreshed: string[];
+    /** Terms moved back into alphabetical order. */
+    reordered: string[];
+    /** Definitions in the section never used in the rest of the document (left in place). */
+    unused: UnusedDefinition[];
+    /** Linked bookmarks whose definition fact no longer exists or is no longer a definition. */
+    unknown: string[];
+}
+/**
+ * Update the Definitions section from the definition facts (`definitions`, by fact id): add the
+ * definitions the text links to but the section lacks, refresh the wording of the ones it has,
+ * put them back in alphabetical order, and report — without removing anything — the definitions
+ * in the section the rest of the document never uses.
+ */
+export declare function updateDefinitions(port: DefinitionsPort, definitions: ReadonlyMap<string, Definition>): UpdateDefinitionsResult;
+/** Term groups keyed for quick lookup of the definition a bookmark points at. */
+export declare function definitionsById(definitions: readonly Definition[]): Map<string, Definition>;
+/** The definition an internal link points at, from its bookmark name. */
+export declare function definitionOfAnchor(anchor: string, definitions: ReadonlyMap<string, Definition>): Definition | undefined;

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

@@ -0,0 +1,29 @@
+/**
+ * Defined-term content as WordprocessingML, and the clipboard fragment that carries it into the
+ * editor. The engine has no "insert bookmark" command, but its paste lands an embedded `.docx`
+ * fragment with everything in it — `w:bookmarkStart`/`w:bookmarkEnd` and `w:hyperlink w:anchor`
+ * included — freshening bookmark ids as it goes. So the term link, the bookmarked definition and a
+ * new Definitions heading are written here and pasted.
+ */
+import type { Definition } from '../../tags/definitions';
+/** Character style of an inserted term: a dotted underline, so a defined term reads as one. */
+export declare const DEFINED_TERM_STYLE = "DefinedTerm";
+/** 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.` */
+export declare const definitionParagraphText: (definition: Pick<Definition, "term" | "rest">) => string;
+/**
+ * A definition paragraph: the quoted term in bold, bookmarked (`bookmark`), then the definition as
+ * the fact writes it. `id` is the bookmark id inside the fragment; the paste renumbers it.
+ */
+export declare function definitionParagraphXml(definition: Pick<Definition, 'term' | 'rest'>, bookmark: string, id?: number): string;
+/** A heading paragraph: the document's own heading style when it has one, else bold text. */
+export declare function headingParagraphXml(text: string, styleId?: string): string;
+/** The term as an internal link to its definition's bookmark, with the definition as its tooltip. */
+export declare function termLinkXml(term: string, bookmark: string, tooltip: string): string;
+/**
+ * Clipboard HTML carrying `body` (paragraph XML) as the editor's own fragment. `covered` says the
+ * last paragraph mark is part of it: the paste then ends with a whole paragraph (a block inserted
+ * before the caret's paragraph) instead of running into the text after the caret (inline).
+ */
+export declare function fragmentHtml(body: string, covered: boolean): string;

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

@@ -0,0 +1,76 @@
+/**
+ * The few things the defined-term commands need from a live Word editor, behind an interface so
+ * the commands are tested against a small in-memory model rather than the engine.
+ */
+import type { DocxEditorInstance } from '@docx-editor.dev/core';
+/** A position: a paragraph (the engine's node id) and a UTF-16 offset into its text. */
+export interface DocPoint {
+    paragraphId: string;
+    offset: number;
+}
+/** An internal link in a paragraph. */
+export interface DocLink {
+    anchor: string;
+    text: string;
+}
+/** One paragraph, in document order. */
+export interface DocParagraph {
+    id: string;
+    text: string;
+    /** Styled as a heading (a `Heading n` style or an outline level). */
+    heading: boolean;
+    styleId?: string;
+    /** A paragraph of the body itself, not inside a table. */
+    topLevel: boolean;
+    /** Names of the bookmarks that start in it. */
+    bookmarks: string[];
+    /** Its internal links (`w:hyperlink w:anchor`). */
+    links: DocLink[];
+}
+export interface DefinitionsPort {
+    /** Every body paragraph, in document order (table cells included, `topLevel: false`). */
+    paragraphs(): DocParagraph[];
+    /** The caret, or `null` when the selection is a range or there is none. */
+    caret(): DocPoint | null;
+    setCaret(point: DocPoint): void;
+    /** Delete everything between two points (across paragraphs: the marks between them go too). */
+    deleteRange(from: DocPoint, to: DocPoint): void;
+    /**
+     * 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;
+    /** Split the caret's paragraph (Enter), the caret moving into the new one. */
+    splitParagraph(): void;
+}
+type Node = {
+    id: string;
+    kind: string;
+    localName?: string;
+    value?: string;
+    attributes?: readonly {
+        localName: string;
+        value: string;
+    }[];
+    children?: readonly Node[];
+};
+/** The paragraphs of a part's body, read from the engine's OOXML tree. */
+export declare function readParagraphs(root: Node): DocParagraph[];
+/** The port over a live editor. Writes go through the editor's own commands and paste. */
+export declare function editorPort(editor: DocxEditorInstance): DefinitionsPort;
+/**
+ * Run `fn` with direct editing. The engine pastes rich content (bookmarks, links) only outside
+ * Suggesting mode, so a suggesting editor switches for the command and back; a read-only one refuses.
+ */
+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.
+ *
+ * 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.
+ */
+export declare function holdCaret(editor: DocxEditorInstance, timeoutMs?: number): void;
+export {};

package/dist/docx/index.cjs

@@ -1,8 +1,10 @@
 "use client";
 'use strict';
 
-var chunk6XS5IJ5R_cjs = require('../chunk-6XS5IJ5R.cjs');
-var chunk2ZDFVRGV_cjs = require('../chunk-2ZDFVRGV.cjs');
+var chunk3OXWJ3CZ_cjs = require('../chunk-3OXWJ3CZ.cjs');
+var chunkE2AAIMXO_cjs = require('../chunk-E2AAIMXO.cjs');
+require('../chunk-AOFATOT3.cjs');
+require('../chunk-RC25WMVB.cjs');
 require('../chunk-7UTB4PHM.cjs');
 require('../chunk-MHVNT4J3.cjs');
 require('../chunk-DES3K4SD.cjs');
@@ -58,7 +60,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(
-    chunk2ZDFVRGV_cjs.NativeDocxEditor,
+    chunkE2AAIMXO_cjs.NativeDocxEditor,
     {
       adapter,
       documentId,
@@ -70,51 +72,87 @@ function NativeDocxComparison({
 
 Object.defineProperty(exports, "StreamedWordArtifact", {
   enumerable: true,
-  get: function () { return chunk6XS5IJ5R_cjs.StreamedWordArtifact; }
+  get: function () { return chunk3OXWJ3CZ_cjs.StreamedWordArtifact; }
+});
+Object.defineProperty(exports, "DEFAULT_DEFINED_TERMS_LABELS", {
+  enumerable: true,
+  get: function () { return chunkE2AAIMXO_cjs.DEFAULT_DEFINED_TERMS_LABELS; }
+});
+Object.defineProperty(exports, "DEFINED_TERM_TRIGGER", {
+  enumerable: true,
+  get: function () { return chunkE2AAIMXO_cjs.DEFINED_TERM_TRIGGER; }
+});
+Object.defineProperty(exports, "DefinedTermsProvider", {
+  enumerable: true,
+  get: function () { return chunkE2AAIMXO_cjs.DefinedTermsProvider; }
 });
 Object.defineProperty(exports, "DocxCommentActivity", {
   enumerable: true,
-  get: function () { return chunk2ZDFVRGV_cjs.DocxCommentActivity; }
+  get: function () { return chunkE2AAIMXO_cjs.DocxCommentActivity; }
 });
 Object.defineProperty(exports, "DocxEditorReview", {
   enumerable: true,
-  get: function () { return chunk2ZDFVRGV_cjs.DocxEditorReview; }
+  get: function () { return chunkE2AAIMXO_cjs.DocxEditorReview; }
 });
 Object.defineProperty(exports, "DocxMentions", {
   enumerable: true,
-  get: function () { return chunk2ZDFVRGV_cjs.DocxMentions; }
+  get: function () { return chunkE2AAIMXO_cjs.DocxMentions; }
 });
 Object.defineProperty(exports, "DocxParticipants", {
   enumerable: true,
-  get: function () { return chunk2ZDFVRGV_cjs.DocxParticipants; }
+  get: function () { return chunkE2AAIMXO_cjs.DocxParticipants; }
 });
 Object.defineProperty(exports, "DocxRibbon", {
   enumerable: true,
-  get: function () { return chunk2ZDFVRGV_cjs.DocxRibbon; }
+  get: function () { return chunkE2AAIMXO_cjs.DocxRibbon; }
 });
 Object.defineProperty(exports, "NativeDocxEditor", {
   enumerable: true,
-  get: function () { return chunk2ZDFVRGV_cjs.NativeDocxEditor; }
+  get: function () { return chunkE2AAIMXO_cjs.NativeDocxEditor; }
+});
+Object.defineProperty(exports, "editorPort", {
+  enumerable: true,
+  get: function () { return chunkE2AAIMXO_cjs.editorPort; }
+});
+Object.defineProperty(exports, "findDefinitionsSection", {
+  enumerable: true,
+  get: function () { return chunkE2AAIMXO_cjs.findDefinitionsSection; }
+});
+Object.defineProperty(exports, "insertDefinedTerm", {
+  enumerable: true,
+  get: function () { return chunkE2AAIMXO_cjs.insertDefinedTerm; }
 });
 Object.defineProperty(exports, "loadDocxFonts", {
   enumerable: true,
-  get: function () { return chunk2ZDFVRGV_cjs.loadDocxFonts; }
+  get: function () { return chunkE2AAIMXO_cjs.loadDocxFonts; }
 });
 Object.defineProperty(exports, "normalizeDocxExport", {
   enumerable: true,
-  get: function () { return chunk2ZDFVRGV_cjs.normalizeDocxExport; }
+  get: function () { return chunkE2AAIMXO_cjs.normalizeDocxExport; }
 });
 Object.defineProperty(exports, "reviewModule", {
   enumerable: true,
-  get: function () { return chunk2ZDFVRGV_cjs.reviewModule; }
+  get: function () { return chunkE2AAIMXO_cjs.reviewModule; }
+});
+Object.defineProperty(exports, "updateDefinitions", {
+  enumerable: true,
+  get: function () { return chunkE2AAIMXO_cjs.updateDefinitions; }
+});
+Object.defineProperty(exports, "useDefinedTerms", {
+  enumerable: true,
+  get: function () { return chunkE2AAIMXO_cjs.useDefinedTerms; }
 });
 Object.defineProperty(exports, "useReview", {
   enumerable: true,
-  get: function () { return chunk2ZDFVRGV_cjs.useReview; }
+  get: function () { return chunkE2AAIMXO_cjs.useReview; }
 });
 Object.defineProperty(exports, "useReviewItem", {
   enumerable: true,
-  get: function () { return chunk2ZDFVRGV_cjs.useReviewItem; }
+  get: function () { return chunkE2AAIMXO_cjs.useReviewItem; }
+});
+Object.defineProperty(exports, "withDirectEditing", {
+  enumerable: true,
+  get: function () { return chunkE2AAIMXO_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

@@ -9,3 +9,6 @@ export { loadDocxFonts } from './fonts';
 export { normalizeDocxExport } from './export';
 export { StreamedWordArtifact, type StreamedWordArtifactProps } from './StreamedWordArtifact';
 export { NativeDocxComparison, type NativeDocxComparisonProps } from './NativeDocxComparison';
+export { DefinedTermsProvider, useDefinedTerms, DEFINED_TERM_TRIGGER, DEFAULT_DEFINED_TERMS_LABELS, type DefinedTermsProviderProps, type DefinedTermsLabels, } from './definitions/DefinedTerms';
+export { insertDefinedTerm, updateDefinitions, findDefinitionsSection, type UpdateDefinitionsResult, } from './definitions/commands';
+export { editorPort, withDirectEditing, type DefinitionsPort } from './definitions/port';

package/dist/docx/index.js

@@ -1,7 +1,9 @@
 "use client";
-export { StreamedWordArtifact } from '../chunk-BX62HJZU.js';
-import { NativeDocxEditor } from '../chunk-W2R7YVFM.js';
-export { DocxCommentActivity, DocxEditorReview, DocxMentions, DocxParticipants, DocxRibbon, NativeDocxEditor, loadDocxFonts, normalizeDocxExport, reviewModule, useReview, useReviewItem } from '../chunk-W2R7YVFM.js';
+export { StreamedWordArtifact } from '../chunk-YPKSLTL5.js';
+import { NativeDocxEditor } from '../chunk-WXLKMEMB.js';
+export { DEFAULT_DEFINED_TERMS_LABELS, DEFINED_TERM_TRIGGER, DefinedTermsProvider, DocxCommentActivity, DocxEditorReview, DocxMentions, DocxParticipants, DocxRibbon, NativeDocxEditor, editorPort, findDefinitionsSection, insertDefinedTerm, loadDocxFonts, normalizeDocxExport, reviewModule, updateDefinitions, useDefinedTerms, useReview, useReviewItem, withDirectEditing } from '../chunk-WXLKMEMB.js';
+import '../chunk-D3QPYKZG.js';
+import '../chunk-AF6RDAJF.js';
 import '../chunk-AA3PT6KR.js';
 import '../chunk-7F6CBP3Z.js';
 import '../chunk-VUNV25KB.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/facts/index.cjs

@@ -4,13 +4,14 @@
 var chunk2WLXQGWC_cjs = require('../chunk-2WLXQGWC.cjs');
 var chunkOUW6G4O2_cjs = require('../chunk-OUW6G4O2.cjs');
 var chunkVPPX5XUF_cjs = require('../chunk-VPPX5XUF.cjs');
+var chunkRC25WMVB_cjs = require('../chunk-RC25WMVB.cjs');
 var chunk7RGLTF76_cjs = require('../chunk-7RGLTF76.cjs');
 var chunkV4ISCZJ7_cjs = require('../chunk-V4ISCZJ7.cjs');
 var chunk2EI7NCUA_cjs = require('../chunk-2EI7NCUA.cjs');
-var chunkPPCATBOY_cjs = require('../chunk-PPCATBOY.cjs');
 require('../chunk-C54XEN5T.cjs');
-var chunkKDG6FER6_cjs = require('../chunk-KDG6FER6.cjs');
 var chunkIXALYQT7_cjs = require('../chunk-IXALYQT7.cjs');
+var chunkPPCATBOY_cjs = require('../chunk-PPCATBOY.cjs');
+var chunkKDG6FER6_cjs = require('../chunk-KDG6FER6.cjs');
 require('../chunk-FX3K6LNZ.cjs');
 var chunkMHVNT4J3_cjs = require('../chunk-MHVNT4J3.cjs');
 require('../chunk-DES3K4SD.cjs');
@@ -19,15 +20,6 @@ var ui = require('@arbidocs/react/ui');
 var jsxRuntime = require('react/jsx-runtime');
 var react = require('react');
 
-// src/facts/fact-text.ts
-var WHITESPACE_CODE_POINTS = /* @__PURE__ */ new Set([32, 9, 160]);
-function decodeWhitespaceEntities(text) {
-  if (!text) return "";
-  return text.replace(/&#x([0-9a-f]+);|&#(\d+);/gi, (match, hex, dec) => {
-    const code = hex ? parseInt(hex, 16) : parseInt(dec, 10);
-    return WHITESPACE_CODE_POINTS.has(code) ? String.fromCodePoint(code) : match;
-  });
-}
 var DEFAULT_FACT_COLUMN_LABELS = {
   inChatHeaderTooltip: "Facts added to this chat are always in context for this chat",
   inChatTitle: "In this chat \u2014 always in context for it. Click to remove from chat.",
@@ -144,7 +136,7 @@ function createFactColumns(slots) {
       filter: "agTextColumnFilter",
       // Decode the editor's whitespace entities (` ` for a trailing space) so the tooltip
       // reads as typed, not as raw markdown references.
-      tooltipValueGetter: (p) => decodeWhitespaceEntities(p.data?.text),
+      tooltipValueGetter: (p) => chunkRC25WMVB_cjs.decodeWhitespaceEntities(p.data?.text),
       // Editable only via the grid api (Rename in the row's menu); clicks never open the editor
       // (suppressClickEdit on the grid).
       editable: true,
@@ -173,7 +165,7 @@ function createFactColumns(slots) {
               "data-testid": chunkMHVNT4J3_cjs.testIdOr(ids?.text?.(fact.external_id), {
                 testId: `facts-grid-text-${fact.external_id}`
               }),
-              children: decodeWhitespaceEntities(fact.text)
+              children: chunkRC25WMVB_cjs.decodeWhitespaceEntities(fact.text)
             }
           ),
           /* @__PURE__ */ jsxRuntime.jsx("div", { className: "facts-row-kebab absolute right-0.5 top-1/2 -translate-y-1/2", children: slots.renderRowActions(fact, params) })
@@ -2260,6 +2252,10 @@ function FactSearchResult({
   ] });
 }
 
+Object.defineProperty(exports, "decodeWhitespaceEntities", {
+  enumerable: true,
+  get: function () { return chunkRC25WMVB_cjs.decodeWhitespaceEntities; }
+});
 Object.defineProperty(exports, "DEFAULT_FACTS_FILTER_INPUT_LABELS", {
   enumerable: true,
   get: function () { return chunk2EI7NCUA_cjs.DEFAULT_FILTER_INPUT_LABELS; }
@@ -2316,7 +2312,6 @@ exports.FactsToolbar = FactsToolbar;
 exports.FactsViewToggle = FactsViewToggle;
 exports.ISO_DATE_FILTER_PARAMS = ISO_DATE_FILTER_PARAMS;
 exports.createFactColumns = createFactColumns;
-exports.decodeWhitespaceEntities = decodeWhitespaceEntities;
 exports.detectTimezone = detectTimezone;
 exports.factDateFieldsToSpan = factDateFieldsToSpan;
 exports.factDateSpanToFields = factDateSpanToFields;