@arbidocs/blocks 0.4.120 → 0.4.122

package/node_modules/@arbidocs/coedit/dist/commands.d.cts

@@ -1,5 +1,5 @@
-import { g as DocParagraph, k as ListItemInfo, j as LevelOf, R as ReferencesPort, a as CrossReferenceTarget, h as DocPoint, O as OoxmlNodeLike, b as DefinitionsPort, i as DocumentNumbering } from './port-ip7WByvH.cjs';
-export { B as BROKEN_CROSS_REFERENCE_STYLE, C as CROSS_REFERENCE_STYLE, D as DEFINED_TERM_STYLE, c as DocField, d as DocLink, e as DocMark, f as DocNote, F as FIELD_ATOM, L as LevelInfo, N as NumberingSource, W as WATCHED_STYLES, l as documentNumbering, m as filterTargets, n as listTargets, p as paragraphNumber, r as readParagraphs, s as styleNames } from './port-ip7WByvH.cjs';
+import { g as DocParagraph, l as ListItemInfo, k as LevelOf, R as ReferencesPort, a as CrossReferenceTarget, h as DocPoint, O as OoxmlNodeLike, b as DefinitionsPort, j as DocumentNumbering } from './port-BbN5OZHx.cjs';
+export { B as BROKEN_CROSS_REFERENCE_STYLE, C as CROSS_REFERENCE_STYLE, D as DEFINED_TERM_STYLE, c as DocField, d as DocLink, e as DocMark, f as DocNote, i as DocRevision, F as FIELD_ATOM, L as LevelInfo, N as NumberingSource, W as WATCHED_STYLES, m as documentNumbering, n as engineLength, o as engineOffset, p as filterTargets, q as listTargets, r as paragraphNumber, s as readParagraphs, t as styleNames } from './port-BbN5OZHx.cjs';
 import { OoxmlProperty, TabStopWrite, TreeDocOp } from '@docx-editor.dev/core/store';
 import { R as Revision } from './track-eYC94jTp.cjs';
 
@@ -377,11 +377,26 @@ interface InsertTermResult {
     /** The definition was not in the document yet and was added to its Definitions section. */
     addedDefinition: boolean;
 }
+/** A paragraph's words between two engine offsets, as a replacement addresses them. */
+interface ReplacedSpan {
+    paragraphId: string;
+    from: number;
+    to: number;
+}
+/**
+ * Replace `span` with what `insert` puts at the caret (`length` characters), as one change that
+ * never removes words without their replacement: the replacement goes in first, right after the
+ * words, and only once it is in are the words deleted. A refused insert changes nothing; a refused
+ * deletion takes the insert back out (deleting an insertion of one's own removes it). Answers
+ * whether the replacement landed, the caret after it.
+ */
+declare function replaceSpan(port: DefinitionsPort, span: ReplacedSpan, insert: () => boolean, length: number): 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.
+ * when the document does not have it. `replace` characters before the caret (a typed `@@query`,
+ * or the term's own plain words) are replaced by it, as one change (see {@link replaceSpan}): a
+ * term that cannot be inserted leaves them in place. The caret ends after the term.
  */
 declare function insertDefinedTerm(port: DefinitionsPort, definition: Definition, options?: {
     replace?: number;
@@ -391,6 +406,68 @@ declare function definitionsById<D extends Definition>(definitions: readonly D[]
 /** The definition an internal link points at, from its bookmark name. */
 declare function definitionOfAnchor<D extends Definition>(anchor: string, definitions: ReadonlyMap<string, D>): D | undefined;
 
+interface TermSpec {
+    /** The defined term, as the document writes it ("Supplier"). */
+    term: string;
+    /** Other words used for it, each replaced by the term. */
+    variants?: readonly string[];
+    /** Link every use of the term (the replaced variants included) to its definition. */
+    link?: boolean;
+}
+/** One use of the term or a variant: `offset` into its paragraph's `text`. */
+interface TermUse {
+    paragraphId: string;
+    paraId?: string;
+    offset: number;
+    text: string;
+    kind: 'term' | 'variant';
+}
+type TermSkipReason = 'definition' | 'linked' | 'link' | 'field' | 'pending-change' | 'unsupported-content' | 'refused';
+/** A use left as it is, and why. */
+interface TermSkip extends TermUse {
+    reason: TermSkipReason;
+}
+/** A use changed: replaced by the term (`text` → `to`), linked to its definition or both. */
+interface TermChange extends TermUse {
+    to: string;
+    linked: boolean;
+}
+interface TermEverywhereResult {
+    changed: TermChange[];
+    skipped: TermSkip[];
+    /** The definition was not in the document and was added to its Definitions section. */
+    addedDefinition: boolean;
+}
+/**
+ * Every use of the term (when linking) and of its variants in `paragraphs`: the ones to change,
+ * and the ones left as they are with the reason. `bookmark` is the definition's, which tells an
+ * already linked term apart from a word inside some other link.
+ */
+declare function findTermUses(paragraphs: readonly DocParagraph[], spec: TermSpec, bookmark?: string): {
+    uses: TermUse[];
+    skipped: TermSkip[];
+};
+/** Raised when a paragraph does not read as intended afterwards: the caller discards the change. */
+declare class TermEverywhereError extends Error {
+    constructor(message: string);
+}
+/**
+ * Apply a defined term across the document (see the module's description): variants replaced by
+ * the term, and with `link` every use linked to `definition` (added to the Definitions section
+ * first when the document does not have it). Every replacement is one change that never leaves
+ * words removed without the term in their place ({@link replaceSpan}); a use the editor refuses is
+ * reported as skipped. After each paragraph its text is checked against what the replacements
+ * should make it, and a paragraph that reads otherwise throws {@link TermEverywhereError}: run
+ * this on a staged copy of the document and keep the copy only when it returns.
+ *
+ * `accept` may turn a whole paragraph down (its uses are skipped as `unsupported-content`).
+ */
+declare function applyTermEverywhere(port: DefinitionsPort, spec: TermSpec & {
+    definition?: DefinitionText;
+}, { accept }?: {
+    accept?: (paragraph: DocParagraph) => boolean;
+}): TermEverywhereResult;
+
 /** A document's parts as trees: a live editor's session or a headless view (`openHeadlessDocument`). */
 interface DocumentTrees {
     part(): {
@@ -418,4 +495,4 @@ declare function documentReader(view: DocumentTrees): DocumentReader;
 /** Read a document from its bytes (a collaboration room's `readRoom`). Throws on a bad package. */
 declare function readDocument(bytes: Uint8Array): DocumentReader;
 
-export { AGENT_UNDO_MAP, type BrokenReference, CHARACTER_STYLES, type CrossReference, type CrossReferenceMode, CrossReferenceTarget, DEFINITIONS_HEADING, DEFINITION_BOOKMARK_PREFIX, type DefinitionText, DefinitionsPort, type DefinitionsSection, DocParagraph, DocPoint, DocumentNumbering, type DocumentReader, type DocumentTrees, type InsertTermResult, LevelOf, ListItemInfo, OoxmlNodeLike, type ParagraphState, type ParsedDefinition, REF_BOOKMARK_PREFIX, ReferencesPort, type ReferencesReader, type RefreshResult, type SectionState, type StaleReference, type UndoRecord, W_NAMESPACES, addDefinition, brokenCrossReferences, compareTerms, crossReferenceXml, crossReferences, definitionBookmark, definitionIdOfBookmark, definitionOfAnchor, definitionParagraphText, definitionParagraphXml, definitionTooltip, definitionsById, documentReader, documentReferenceTooltip, documentStyleIds, documentXml, docxPackage, ensureTargetBookmark, esc, fieldNodeIds, findDefinitionsSection, fragmentPackage, headingParagraphXml, hyperlinkRelationship, insertCrossReference, insertCrossReferenceField, insertDefinedTerm, insertDocumentReference, insertionIndex, isDefinitionsTitle, markCrossReferenceTarget, newRefBookmark, paragraphIndex, paragraphRunsXml, paragraphState, parseDefinition, readDocument, refFieldXml, refInstruction, refResult, refTooltip, refreshCrossReferences, sectionStates, staleCrossReferences, stylesUsed, stylesXml, tableOf, tableState, termKey, termLinkXml, undoOps };
+export { AGENT_UNDO_MAP, type BrokenReference, CHARACTER_STYLES, type CrossReference, type CrossReferenceMode, CrossReferenceTarget, DEFINITIONS_HEADING, DEFINITION_BOOKMARK_PREFIX, type DefinitionText, DefinitionsPort, type DefinitionsSection, DocParagraph, DocPoint, DocumentNumbering, type DocumentReader, type DocumentTrees, type InsertTermResult, LevelOf, ListItemInfo, OoxmlNodeLike, type ParagraphState, type ParsedDefinition, REF_BOOKMARK_PREFIX, ReferencesPort, type ReferencesReader, type RefreshResult, type ReplacedSpan, type SectionState, type StaleReference, type TermChange, TermEverywhereError, type TermEverywhereResult, type TermSkip, type TermSkipReason, type TermSpec, type TermUse, type UndoRecord, W_NAMESPACES, addDefinition, applyTermEverywhere, brokenCrossReferences, compareTerms, crossReferenceXml, crossReferences, definitionBookmark, definitionIdOfBookmark, definitionOfAnchor, definitionParagraphText, definitionParagraphXml, definitionTooltip, definitionsById, documentReader, documentReferenceTooltip, documentStyleIds, documentXml, docxPackage, ensureTargetBookmark, esc, fieldNodeIds, findDefinitionsSection, findTermUses, fragmentPackage, headingParagraphXml, hyperlinkRelationship, insertCrossReference, insertCrossReferenceField, insertDefinedTerm, insertDocumentReference, insertionIndex, isDefinitionsTitle, markCrossReferenceTarget, newRefBookmark, paragraphIndex, paragraphRunsXml, paragraphState, parseDefinition, readDocument, refFieldXml, refInstruction, refResult, refTooltip, refreshCrossReferences, replaceSpan, sectionStates, staleCrossReferences, stylesUsed, stylesXml, tableOf, tableState, termKey, termLinkXml, undoOps };

package/node_modules/@arbidocs/coedit/dist/commands.d.ts

@@ -1,5 +1,5 @@
-import { g as DocParagraph, k as ListItemInfo, j as LevelOf, R as ReferencesPort, a as CrossReferenceTarget, h as DocPoint, O as OoxmlNodeLike, b as DefinitionsPort, i as DocumentNumbering } from './port-ip7WByvH.js';
-export { B as BROKEN_CROSS_REFERENCE_STYLE, C as CROSS_REFERENCE_STYLE, D as DEFINED_TERM_STYLE, c as DocField, d as DocLink, e as DocMark, f as DocNote, F as FIELD_ATOM, L as LevelInfo, N as NumberingSource, W as WATCHED_STYLES, l as documentNumbering, m as filterTargets, n as listTargets, p as paragraphNumber, r as readParagraphs, s as styleNames } from './port-ip7WByvH.js';
+import { g as DocParagraph, l as ListItemInfo, k as LevelOf, R as ReferencesPort, a as CrossReferenceTarget, h as DocPoint, O as OoxmlNodeLike, b as DefinitionsPort, j as DocumentNumbering } from './port-BbN5OZHx.js';
+export { B as BROKEN_CROSS_REFERENCE_STYLE, C as CROSS_REFERENCE_STYLE, D as DEFINED_TERM_STYLE, c as DocField, d as DocLink, e as DocMark, f as DocNote, i as DocRevision, F as FIELD_ATOM, L as LevelInfo, N as NumberingSource, W as WATCHED_STYLES, m as documentNumbering, n as engineLength, o as engineOffset, p as filterTargets, q as listTargets, r as paragraphNumber, s as readParagraphs, t as styleNames } from './port-BbN5OZHx.js';
 import { OoxmlProperty, TabStopWrite, TreeDocOp } from '@docx-editor.dev/core/store';
 import { R as Revision } from './track-eYC94jTp.js';
 
@@ -377,11 +377,26 @@ interface InsertTermResult {
     /** The definition was not in the document yet and was added to its Definitions section. */
     addedDefinition: boolean;
 }
+/** A paragraph's words between two engine offsets, as a replacement addresses them. */
+interface ReplacedSpan {
+    paragraphId: string;
+    from: number;
+    to: number;
+}
+/**
+ * Replace `span` with what `insert` puts at the caret (`length` characters), as one change that
+ * never removes words without their replacement: the replacement goes in first, right after the
+ * words, and only once it is in are the words deleted. A refused insert changes nothing; a refused
+ * deletion takes the insert back out (deleting an insertion of one's own removes it). Answers
+ * whether the replacement landed, the caret after it.
+ */
+declare function replaceSpan(port: DefinitionsPort, span: ReplacedSpan, insert: () => boolean, length: number): 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.
+ * when the document does not have it. `replace` characters before the caret (a typed `@@query`,
+ * or the term's own plain words) are replaced by it, as one change (see {@link replaceSpan}): a
+ * term that cannot be inserted leaves them in place. The caret ends after the term.
  */
 declare function insertDefinedTerm(port: DefinitionsPort, definition: Definition, options?: {
     replace?: number;
@@ -391,6 +406,68 @@ declare function definitionsById<D extends Definition>(definitions: readonly D[]
 /** The definition an internal link points at, from its bookmark name. */
 declare function definitionOfAnchor<D extends Definition>(anchor: string, definitions: ReadonlyMap<string, D>): D | undefined;
 
+interface TermSpec {
+    /** The defined term, as the document writes it ("Supplier"). */
+    term: string;
+    /** Other words used for it, each replaced by the term. */
+    variants?: readonly string[];
+    /** Link every use of the term (the replaced variants included) to its definition. */
+    link?: boolean;
+}
+/** One use of the term or a variant: `offset` into its paragraph's `text`. */
+interface TermUse {
+    paragraphId: string;
+    paraId?: string;
+    offset: number;
+    text: string;
+    kind: 'term' | 'variant';
+}
+type TermSkipReason = 'definition' | 'linked' | 'link' | 'field' | 'pending-change' | 'unsupported-content' | 'refused';
+/** A use left as it is, and why. */
+interface TermSkip extends TermUse {
+    reason: TermSkipReason;
+}
+/** A use changed: replaced by the term (`text` → `to`), linked to its definition or both. */
+interface TermChange extends TermUse {
+    to: string;
+    linked: boolean;
+}
+interface TermEverywhereResult {
+    changed: TermChange[];
+    skipped: TermSkip[];
+    /** The definition was not in the document and was added to its Definitions section. */
+    addedDefinition: boolean;
+}
+/**
+ * Every use of the term (when linking) and of its variants in `paragraphs`: the ones to change,
+ * and the ones left as they are with the reason. `bookmark` is the definition's, which tells an
+ * already linked term apart from a word inside some other link.
+ */
+declare function findTermUses(paragraphs: readonly DocParagraph[], spec: TermSpec, bookmark?: string): {
+    uses: TermUse[];
+    skipped: TermSkip[];
+};
+/** Raised when a paragraph does not read as intended afterwards: the caller discards the change. */
+declare class TermEverywhereError extends Error {
+    constructor(message: string);
+}
+/**
+ * Apply a defined term across the document (see the module's description): variants replaced by
+ * the term, and with `link` every use linked to `definition` (added to the Definitions section
+ * first when the document does not have it). Every replacement is one change that never leaves
+ * words removed without the term in their place ({@link replaceSpan}); a use the editor refuses is
+ * reported as skipped. After each paragraph its text is checked against what the replacements
+ * should make it, and a paragraph that reads otherwise throws {@link TermEverywhereError}: run
+ * this on a staged copy of the document and keep the copy only when it returns.
+ *
+ * `accept` may turn a whole paragraph down (its uses are skipped as `unsupported-content`).
+ */
+declare function applyTermEverywhere(port: DefinitionsPort, spec: TermSpec & {
+    definition?: DefinitionText;
+}, { accept }?: {
+    accept?: (paragraph: DocParagraph) => boolean;
+}): TermEverywhereResult;
+
 /** A document's parts as trees: a live editor's session or a headless view (`openHeadlessDocument`). */
 interface DocumentTrees {
     part(): {
@@ -418,4 +495,4 @@ declare function documentReader(view: DocumentTrees): DocumentReader;
 /** Read a document from its bytes (a collaboration room's `readRoom`). Throws on a bad package. */
 declare function readDocument(bytes: Uint8Array): DocumentReader;
 
-export { AGENT_UNDO_MAP, type BrokenReference, CHARACTER_STYLES, type CrossReference, type CrossReferenceMode, CrossReferenceTarget, DEFINITIONS_HEADING, DEFINITION_BOOKMARK_PREFIX, type DefinitionText, DefinitionsPort, type DefinitionsSection, DocParagraph, DocPoint, DocumentNumbering, type DocumentReader, type DocumentTrees, type InsertTermResult, LevelOf, ListItemInfo, OoxmlNodeLike, type ParagraphState, type ParsedDefinition, REF_BOOKMARK_PREFIX, ReferencesPort, type ReferencesReader, type RefreshResult, type SectionState, type StaleReference, type UndoRecord, W_NAMESPACES, addDefinition, brokenCrossReferences, compareTerms, crossReferenceXml, crossReferences, definitionBookmark, definitionIdOfBookmark, definitionOfAnchor, definitionParagraphText, definitionParagraphXml, definitionTooltip, definitionsById, documentReader, documentReferenceTooltip, documentStyleIds, documentXml, docxPackage, ensureTargetBookmark, esc, fieldNodeIds, findDefinitionsSection, fragmentPackage, headingParagraphXml, hyperlinkRelationship, insertCrossReference, insertCrossReferenceField, insertDefinedTerm, insertDocumentReference, insertionIndex, isDefinitionsTitle, markCrossReferenceTarget, newRefBookmark, paragraphIndex, paragraphRunsXml, paragraphState, parseDefinition, readDocument, refFieldXml, refInstruction, refResult, refTooltip, refreshCrossReferences, sectionStates, staleCrossReferences, stylesUsed, stylesXml, tableOf, tableState, termKey, termLinkXml, undoOps };
+export { AGENT_UNDO_MAP, type BrokenReference, CHARACTER_STYLES, type CrossReference, type CrossReferenceMode, CrossReferenceTarget, DEFINITIONS_HEADING, DEFINITION_BOOKMARK_PREFIX, type DefinitionText, DefinitionsPort, type DefinitionsSection, DocParagraph, DocPoint, DocumentNumbering, type DocumentReader, type DocumentTrees, type InsertTermResult, LevelOf, ListItemInfo, OoxmlNodeLike, type ParagraphState, type ParsedDefinition, REF_BOOKMARK_PREFIX, ReferencesPort, type ReferencesReader, type RefreshResult, type ReplacedSpan, type SectionState, type StaleReference, type TermChange, TermEverywhereError, type TermEverywhereResult, type TermSkip, type TermSkipReason, type TermSpec, type TermUse, type UndoRecord, W_NAMESPACES, addDefinition, applyTermEverywhere, brokenCrossReferences, compareTerms, crossReferenceXml, crossReferences, definitionBookmark, definitionIdOfBookmark, definitionOfAnchor, definitionParagraphText, definitionParagraphXml, definitionTooltip, definitionsById, documentReader, documentReferenceTooltip, documentStyleIds, documentXml, docxPackage, ensureTargetBookmark, esc, fieldNodeIds, findDefinitionsSection, findTermUses, fragmentPackage, headingParagraphXml, hyperlinkRelationship, insertCrossReference, insertCrossReferenceField, insertDefinedTerm, insertDocumentReference, insertionIndex, isDefinitionsTitle, markCrossReferenceTarget, newRefBookmark, paragraphIndex, paragraphRunsXml, paragraphState, parseDefinition, readDocument, refFieldXml, refInstruction, refResult, refTooltip, refreshCrossReferences, replaceSpan, sectionStates, staleCrossReferences, stylesUsed, stylesXml, tableOf, tableState, termKey, termLinkXml, undoOps };

package/node_modules/@arbidocs/coedit/dist/commands.js

@@ -8,6 +8,14 @@ import { zipSync, strToU8, strFromU8, unzipSync } from 'fflate';
 var DEFINED_TERM_STYLE = "DefinedTerm";
 var CROSS_REFERENCE_STYLE = "CrossReference";
 var BROKEN_CROSS_REFERENCE_STYLE = "CrossReferenceBroken";
+function engineOffset(paragraph, offset, pastDeletions = false) {
+  let out = offset;
+  for (const r of paragraph.revisions ?? [])
+    if (r.kind === "delete" && (r.offset < offset || pastDeletions && r.offset === offset))
+      out += r.length;
+  return out;
+}
+var engineLength = (paragraph) => engineOffset(paragraph, paragraph.text.length, true);
 var WATCHED_STYLES = /* @__PURE__ */ new Set([BROKEN_CROSS_REFERENCE_STYLE]);
 var attr = (node, name) => node.attributes?.find((a) => a.localName === name)?.value;
 var FIELD_ATOM = "\uFFFC";
@@ -42,6 +50,7 @@ function readParagraph(node, topLevel, bookmarks) {
   let runStyle;
   const fields = [];
   const notes = [];
+  const revisions = [];
   let current = null;
   const field = (c) => {
     const type = attr(c, "fldCharType");
@@ -83,7 +92,31 @@ function readParagraph(node, topLevel, bookmarks) {
         }
         continue;
       }
-      if (c.localName === "delText" || c.localName === "del" || c.localName === "rPr") continue;
+      if (c.localName === "del") {
+        const deleted = deletedText(c);
+        if (deleted && fieldDepth === 0)
+          revisions.push({
+            kind: "delete",
+            offset: text.length,
+            length: deleted.length,
+            author: attr(c, "author"),
+            text: deleted
+          });
+        continue;
+      }
+      if (c.localName === "ins") {
+        const start = text.length;
+        walk(c, link);
+        if (text.length > start && fieldDepth === 0)
+          revisions.push({
+            kind: "insert",
+            offset: start,
+            length: text.length - start,
+            author: attr(c, "author")
+          });
+        continue;
+      }
+      if (c.localName === "delText" || c.localName === "rPr") continue;
       if (c.localName === "r") {
         const rStyle = c.children?.find((x) => x.localName === "rPr")?.children?.find((x) => x.localName === "rStyle");
         const watched = rStyle && attr(rStyle, "val");
@@ -146,9 +179,20 @@ function readParagraph(node, topLevel, bookmarks) {
     links,
     ...fields.length ? { fields } : {},
     ...marks.length ? { marks } : {},
-    ...notes.length ? { notes } : {}
+    ...notes.length ? { notes } : {},
+    ...revisions.length ? { revisions } : {}
   };
 }
+function deletedText(node) {
+  let out = "";
+  for (const c of node.children ?? []) {
+    if (c.localName === "instrText") continue;
+    if (c.localName === "delText") out += (c.children ?? []).map((t) => t.value ?? "").join("");
+    else if (c.localName === "tab") out += "	";
+    else if (c.localName !== "rPr") out += deletedText(c);
+  }
+  return out;
+}
 function styleNames(root) {
   const names = /* @__PURE__ */ new Map();
   for (const style of root?.children ?? []) {
@@ -1039,7 +1083,7 @@ function insertParagraphs(port, index, body, count, keep) {
     port.setCaret({ paragraphId: before[index].id, offset: 0 });
   } else {
     const last = before[before.length - 1];
-    port.setCaret({ paragraphId: last.id, offset: last.text.length });
+    port.setCaret({ paragraphId: last.id, offset: engineLength(last) });
     port.splitParagraph();
     const opened = port.paragraphs();
     port.setCaret({ paragraphId: opened[opened.length - 1].id, offset: 0 });
@@ -1071,25 +1115,47 @@ function addDefinition(port, definition, keep) {
   );
 }
 var hasBookmark = (paragraphs, name) => paragraphs.some((p) => p.bookmarks.includes(name));
+var paragraphOf = (port, id) => port.paragraphs().find((p) => p.id === id);
+function replaceSpan(port, span, insert, length) {
+  const { paragraphId, from, to } = span;
+  if (from > to) throw new Error("A replacement runs forwards.");
+  const before = paragraphOf(port, paragraphId);
+  if (!before) throw new Error("That paragraph is no longer in the document.");
+  const length0 = engineLength(before);
+  port.setCaret({ paragraphId, offset: to });
+  if (!insert()) return false;
+  if (from < to) {
+    try {
+      port.deleteRange({ paragraphId, offset: from }, { paragraphId, offset: to });
+    } catch (error) {
+      port.deleteRange({ paragraphId, offset: to }, { paragraphId, offset: to + length });
+      throw error;
+    }
+  }
+  const after = paragraphOf(port, paragraphId);
+  const kept = after && engineLength(after) - length0 === length;
+  port.setCaret({ paragraphId, offset: (kept ? to : from) + length });
+  return true;
+}
 function insertDefinedTerm(port, definition, options = {}) {
   const start = port.caret();
   if (!start) throw new Error("Place the cursor where the term should go.");
-  let caret = start;
-  if (options.replace) {
-    caret = { paragraphId: start.paragraphId, offset: Math.max(0, start.offset - options.replace) };
-    port.deleteRange(caret, start);
-  }
   const bookmark = definitionBookmark(definition.id);
   const addedDefinition = !hasBookmark(port.paragraphs(), bookmark);
-  if (addedDefinition) caret = addDefinition(port, definition, caret) ?? caret;
-  port.setCaret(caret);
-  if (!port.paste(
+  const caret = addedDefinition && addDefinition(port, definition, start) || start;
+  const insert = () => port.paste(
     termLinkXml(definition.term, bookmark, definitionTooltip(definition)),
     definition.term,
     false
+  );
+  const from = Math.max(0, caret.offset - (options.replace ?? 0));
+  if (!replaceSpan(
+    port,
+    { paragraphId: caret.paragraphId, from, to: caret.offset },
+    insert,
+    definition.term.length
   ))
     throw new Error("The term could not be inserted.");
-  port.setCaret({ paragraphId: caret.paragraphId, offset: caret.offset + definition.term.length });
   return { addedDefinition };
 }
 function definitionsById(definitions) {
@@ -1100,6 +1166,144 @@ function definitionOfAnchor(anchor, definitions) {
   return id ? definitions.get(id) : void 0;
 }
 
+// src/commands/everywhere.ts
+var WORD = "[\\p{L}\\p{N}_\\-\u2010\u2011]";
+var escape = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function needlesOf(spec) {
+  const term = spec.term.replace(/\s+/g, " ").trim();
+  const variants = [
+    ...new Set((spec.variants ?? []).map((v) => v.replace(/\s+/g, " ").trim()))
+  ].filter((v) => v && v !== term);
+  const needles = [
+    ...variants.map((text) => ({ text, kind: "variant" })),
+    ...spec.link ? [{ text: term, kind: "term" }] : []
+  ];
+  return needles.map((n) => ({
+    ...n,
+    pattern: new RegExp(
+      `(?<!${WORD})${n.text.split(" ").map(escape).join("\\s+")}(?!${WORD})`,
+      "gu"
+    )
+  }));
+}
+function matchesIn(text, needles) {
+  const found = [];
+  for (const needle of needles)
+    for (const m of text.matchAll(needle.pattern))
+      found.push({ offset: m.index ?? 0, text: m[0], kind: needle.kind });
+  found.sort((a, b) => a.offset - b.offset || b.text.length - a.text.length);
+  const out = [];
+  for (const m of found)
+    if (!out.length || m.offset >= out[out.length - 1].offset + out[out.length - 1].text.length)
+      out.push(m);
+  return out;
+}
+var overlaps = (start, end, from, to) => start < to && from < end;
+function findTermUses(paragraphs, spec, bookmark) {
+  const needles = needlesOf(spec);
+  const defining = new Set([spec.term, ...spec.variants ?? []].map(termKey));
+  const uses = [];
+  const skipped = [];
+  for (const p of paragraphs) {
+    const at = { paragraphId: p.id, ...p.paraId ? { paraId: p.paraId } : {} };
+    const defined = parseDefinition(p.text.split(FIELD_ATOM).join(""));
+    const isDefinition = defined !== null && defining.has(termKey(defined.term));
+    for (const m of matchesIn(p.text, needles)) {
+      const use = { ...at, ...m };
+      const end = m.offset + m.text.length;
+      const link = p.links.find(
+        (l) => l.offset !== void 0 && overlaps(m.offset, end, l.offset, l.offset + l.text.length)
+      );
+      const pending = (p.revisions ?? []).some(
+        (r) => r.kind === "insert" ? overlaps(m.offset, end, r.offset, r.offset + r.length) : r.offset > m.offset && r.offset < end
+      );
+      const reason = isDefinition ? "definition" : link ? link.anchor === bookmark ? "linked" : "link" : pending ? "pending-change" : null;
+      if (reason) skipped.push({ ...use, reason });
+      else uses.push(use);
+    }
+    for (const field of p.fields ?? [])
+      for (const m of matchesIn(field.result, needles))
+        skipped.push({ ...at, offset: field.offset, text: m.text, kind: m.kind, reason: "field" });
+  }
+  return { uses, skipped };
+}
+function replacedText(text, uses, term) {
+  let out = text;
+  for (const use of [...uses].sort((a, b) => b.offset - a.offset))
+    out = out.slice(0, use.offset) + term + out.slice(use.offset + use.text.length);
+  return out;
+}
+var TermEverywhereError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "TermEverywhereError";
+  }
+};
+function applyTermEverywhere(port, spec, { accept } = {}) {
+  const term = spec.term.replace(/\s+/g, " ").trim();
+  if (!term) throw new Error("Name the defined term.");
+  let addedDefinition = false;
+  let link;
+  if (spec.link) {
+    if (!spec.definition) throw new Error(`Linking "${term}" needs its definition.`);
+    link = {
+      bookmark: definitionBookmark(spec.definition.id),
+      tooltip: definitionTooltip(spec.definition)
+    };
+    if (!port.paragraphs().some((p) => p.bookmarks.includes(link.bookmark))) {
+      addDefinition(port, spec.definition);
+      addedDefinition = true;
+    }
+  }
+  const paragraphs = port.paragraphs();
+  const { uses, skipped } = findTermUses(paragraphs, { ...spec, term }, link?.bookmark);
+  const changed = [];
+  const insert = link ? () => port.paste(termLinkXml(term, link.bookmark, link.tooltip), term, false) : () => {
+    port.typeText(term);
+    return true;
+  };
+  for (const p of paragraphs) {
+    const mine = uses.filter((u) => u.paragraphId === p.id);
+    if (!mine.length) continue;
+    if (accept && !accept(p)) {
+      skipped.push(...mine.map((u) => ({ ...u, reason: "unsupported-content" })));
+      continue;
+    }
+    const current = () => port.paragraphs().find((x) => p.paraId ? x.paraId === p.paraId : x.id === p.id);
+    const done = [];
+    for (const use of [...mine].sort((a, b) => b.offset - a.offset)) {
+      const now = current();
+      let ok = false;
+      if (now) {
+        const span = {
+          paragraphId: now.id,
+          from: engineOffset(p, use.offset, true),
+          to: engineOffset(p, use.offset + use.text.length)
+        };
+        try {
+          ok = replaceSpan(port, span, insert, term.length);
+        } catch {
+          ok = false;
+        }
+      }
+      if (ok) {
+        done.push(use);
+        changed.push({ ...use, to: term, linked: Boolean(link) });
+      } else skipped.push({ ...use, reason: "refused" });
+    }
+    const want = replacedText(p.text, done, term);
+    const got = current()?.text;
+    if (got !== want)
+      throw new TermEverywhereError(
+        `A paragraph did not read as intended after the changes: expected "${want}", got "${got ?? "(missing)"}".`
+      );
+  }
+  changed.sort(
+    (a, b) => paragraphs.findIndex((p) => p.id === a.paragraphId) - paragraphs.findIndex((p) => p.id === b.paragraphId) || a.offset - b.offset
+  );
+  return { changed, skipped, addedDefinition };
+}
+
 // src/commands/index.ts
 function documentReader(view) {
   const root = () => view.part().root;
@@ -1139,6 +1343,6 @@ function readDocument(bytes) {
   return documentReader(opened.view);
 }
 
-export { AGENT_UNDO_MAP, BROKEN_CROSS_REFERENCE_STYLE, CHARACTER_STYLES, CROSS_REFERENCE_STYLE, DEFINED_TERM_STYLE, DEFINITIONS_HEADING, DEFINITION_BOOKMARK_PREFIX, FIELD_ATOM, REF_BOOKMARK_PREFIX, WATCHED_STYLES, W_NAMESPACES, addDefinition, brokenCrossReferences, compareTerms, crossReferenceXml, crossReferences, definitionBookmark, definitionIdOfBookmark, definitionOfAnchor, definitionParagraphText, definitionParagraphXml, definitionTooltip, definitionsById, documentNumbering, documentReader, documentReferenceTooltip, documentStyleIds, documentXml, docxPackage, ensureTargetBookmark, esc, fieldNodeIds, filterTargets, findDefinitionsSection, fragmentPackage, headingParagraphXml, hyperlinkRelationship, insertCrossReference, insertCrossReferenceField, insertDefinedTerm, insertDocumentReference, insertionIndex, isDefinitionsTitle, listTargets, markCrossReferenceTarget, newRefBookmark, paragraphIndex, paragraphNumber, paragraphRunsXml, paragraphState, parseDefinition, readDocument, readParagraphs, refFieldXml, refInstruction, refResult, refTooltip, refreshCrossReferences, sectionStates, staleCrossReferences, styleNames, stylesUsed, stylesXml, tableOf, tableState, termKey, termLinkXml, undoOps };
+export { AGENT_UNDO_MAP, BROKEN_CROSS_REFERENCE_STYLE, CHARACTER_STYLES, CROSS_REFERENCE_STYLE, DEFINED_TERM_STYLE, DEFINITIONS_HEADING, DEFINITION_BOOKMARK_PREFIX, FIELD_ATOM, REF_BOOKMARK_PREFIX, TermEverywhereError, WATCHED_STYLES, W_NAMESPACES, addDefinition, applyTermEverywhere, brokenCrossReferences, compareTerms, crossReferenceXml, crossReferences, definitionBookmark, definitionIdOfBookmark, definitionOfAnchor, definitionParagraphText, definitionParagraphXml, definitionTooltip, definitionsById, documentNumbering, documentReader, documentReferenceTooltip, documentStyleIds, documentXml, docxPackage, engineLength, engineOffset, ensureTargetBookmark, esc, fieldNodeIds, filterTargets, findDefinitionsSection, findTermUses, fragmentPackage, headingParagraphXml, hyperlinkRelationship, insertCrossReference, insertCrossReferenceField, insertDefinedTerm, insertDocumentReference, insertionIndex, isDefinitionsTitle, listTargets, markCrossReferenceTarget, newRefBookmark, paragraphIndex, paragraphNumber, paragraphRunsXml, paragraphState, parseDefinition, readDocument, readParagraphs, refFieldXml, refInstruction, refResult, refTooltip, refreshCrossReferences, replaceSpan, sectionStates, staleCrossReferences, styleNames, stylesUsed, stylesXml, tableOf, tableState, termKey, termLinkXml, undoOps };
 //# sourceMappingURL=commands.js.map
 //# sourceMappingURL=commands.js.map