@docx4j/core-ts 0.4.0 → 0.6.0

package/dist/model/content/binder.d.mts

@@ -10,7 +10,8 @@ export interface Bound {
      * The tree object: for an element, what a walk of the typed tree would hand you at that path,
      * never a `{ name, value }` wrapper; for an attribute or a text node, the object of the element
      * that owns it. Undefined for an element the model does not build - a wildcard child is its own
-     * object, so this is undefined only above the root or for a node the marshal did not report.
+     * object, and so is each element inside one (the node at the same place in the tree), so this is
+     * undefined only above the root or for a node the marshal did not report.
      */
     object: unknown;
     /** Set when an attribute was selected: its qualified name on `object`'s element. */

package/dist/model/content/binder.mjs

@@ -33,11 +33,12 @@ export async function bindSnapshot(element) {
 /** Turns selected nodes into `Bound`s against a snapshot, with one path cache for them all. */
 export function boundsOf(nodes, snapshot) {
     const paths = new Paths();
+    const indexes = new Map();
     return nodes.map((node) => {
         const owner = owningElement(node);
         const bound = {
             node,
-            object: owner === undefined ? undefined : snapshot.objects.get(owner),
+            object: owner === undefined ? undefined : objectOf(owner, snapshot.objects, indexes),
             path: paths.of(node),
         };
         if (node.nodeType === 2)
@@ -45,6 +46,49 @@ export function boundsOf(nodes, snapshot) {
         return bound;
     });
 }
+/**
+ * The tree object behind a snapshot element. The marshal reports a wildcard child's imported copy
+ * but nothing inside it, so an element there maps to the node at the same place under the original:
+ * the copy is deep, so the child positions agree. Since CR-010 phase 4 a kept branch's DrawingML is
+ * DOM from the branch down (an `xdr:graphicFrame`, a `p:sp`), and a selection lands inside it.
+ * Below a typed ancestor an unreported element stays unmapped.
+ */
+function objectOf(element, objects, indexes) {
+    if (objects.has(element))
+        return objects.get(element);
+    const path = [];
+    let at = element;
+    while (!objects.has(at)) {
+        path.push(at);
+        const parent = at.parentNode;
+        if (parent === null || parent.nodeType !== 1)
+            return undefined;
+        at = parent;
+    }
+    let node = objects.get(at);
+    if (!isNode(node))
+        return undefined;
+    for (let k = path.length - 1; k >= 0; k--) {
+        node = node.childNodes[childIndex(path[k], indexes)];
+        if (node === undefined || node === null)
+            return undefined;
+    }
+    return node;
+}
+/** A node's position among its parent's child nodes, each parent's counted once. */
+function childIndex(node, indexes) {
+    var _a;
+    const parent = node.parentNode;
+    let index = indexes.get(parent);
+    if (index === undefined) {
+        index = new Map();
+        let i = 0;
+        for (let child = parent.firstChild; child; child = child.nextSibling)
+            index.set(child, i++);
+        indexes.set(parent, index);
+    }
+    return (_a = index.get(node)) !== null && _a !== void 0 ? _a : -1;
+}
 /**
  * The element an XPath result belongs to: itself for an element, its owner for an attribute, its
  * parent for a text, comment or processing-instruction node. A document node has none.
@@ -123,6 +167,9 @@ class Paths {
         return (_b = positions.get(element)) !== null && _b !== void 0 ? _b : 0;
     }
 }
+function isNode(node) {
+    return typeof node === 'object' && node !== null && typeof node.nodeType === 'number';
+}
 function isElement(node) {
     return typeof node === 'object' && node !== null && node.nodeType === 1;
 }

package/dist/model/content/comments.d.mts

@@ -3,7 +3,7 @@ import type * as w15 from '@docx4j/generated-objects-ts/modules/org_docx4j_w15';
 import type * as w16cid from '@docx4j/generated-objects-ts/modules/org_docx4j_w16cid';
 import type { XmlCalendar } from '@docx4j/generated-objects-ts';
 import type { XmlPart } from '../../parts/XmlPart.mjs';
-import { type Element } from './tree.mjs';
+import { type BranchMode, type HiddenRuns, type Element } from './tree.mjs';
 import type { Body } from './Body.mjs';
 import type { Paragraph } from './Paragraph.mjs';
 import type { Range } from './Range.mjs';
@@ -92,6 +92,14 @@ export interface CommentParts {
     ensureCommentsEx(): w15.CTCommentsEx;
     /** Loads and creates the side parts the bookkeeping needs (w15, w16cid; w16cex only if present). */
     ensureAll(): Promise<CommentParts>;
+    /** Loads the side parts the document has, creating none: what removing a comment needs. */
+    loadExisting(): Promise<CommentParts>;
+    /**
+     * Takes the comments part and its commentsExtended, commentsIds and commentsExtensible parts out of
+     * the package, with their relationships, and the people part too when `people` is true. A part
+     * another relationship still targets stays.
+     */
+    drop(people: boolean): void;
 }
 /** How the content API reaches the comment parts; implemented and registered by `src/parts/wml/comments.mts`. */
 export interface CommentPartsAccess {
@@ -130,11 +138,13 @@ export interface CommentMarker {
 }
 /**
  * Every comment marker under a container (a body, a cell, a paragraph), in document order.
- * Deleted content (`w:del`) is not entered, as the text model does not enter it either.
+ * Deleted content (`w:del`) is not entered, as the text model does not enter it either. A kept
+ * `mc:AlternateContent` at block, row or cell level is read as `mode` says (CR-013 phase 2): a reader's
+ * walk takes its selected branch, an edit's (`removeMarkers`, the ids) every branch.
  */
-export declare function markersOf(container: object): CommentMarker[];
-/** The markers of one paragraph, with their offsets in its text. */
-export declare function markersOfParagraph(element: Element<wml.P>, container: Element[]): CommentMarker[];
+export declare function markersOf(container: object, hidden?: (p: wml.P) => HiddenRuns, mode?: BranchMode): CommentMarker[];
+/** The markers of one paragraph, with their offsets in its text (`Paragraph.text` where `hidden` is its `hiddenRuns()`). */
+export declare function markersOfParagraph(element: Element<wml.P>, container: Element[], hidden?: HiddenRuns): CommentMarker[];
 /** The comment ids under a container, in document order, first occurrence first. */
 export declare function commentIdsOf(container: object): number[];
 /** Removes every marker of a comment from a body, and the reference run when nothing is left in it. */
@@ -143,7 +153,11 @@ export declare function removeMarkers(container: object, id: number): void;
 export declare function nextCommentId(comments: wml.Comments, container: object): number;
 /** An 8 hex digit id, as Word writes `w14:paraId` and `w16cid:durableId` (never 0, high bit clear). */
 export declare function randomHexId(taken: (id: string) => boolean): string;
-/** The `w14:paraId` of a comment's first paragraph: the key of its w15 and w16cid entries. */
+/**
+ * The `w14:paraId` of a comment's first paragraph: the key of its w15 and w16cid entries. A kept
+ * `mc:AlternateContent` before any paragraph is read in its selected branch, as Word reads it (CR-013
+ * phase 3; docx4j's `Trees.lastParaId` looks into the branch the same way).
+ */
 export declare function commentParaId(comment: wml.Comments.Comment): string | undefined;
 /** True when a paragraph id is already used by a comment or by a paragraph of the document. */
 export declare function paraIdTaken(parts: CommentParts, container: object, id: string): boolean;

package/dist/model/content/comments.mjs

@@ -1,5 +1,5 @@
 import { Docx4JException } from '../../opc/exceptions.mjs';
-import { typeNameOf, childrenOf, runItemsOf, itemTextOf, revisionKindOf, RUN_HOLDERS } from './tree.mjs';
+import { typeNameOf, childrenOf, segmentsOf, rowsOf, cellsOf, branchesOf, selectedBranchOf, ALTERNATE_CONTENT } from './tree.mjs';
 /** The style Word gives a comment's paragraphs. */
 export const COMMENT_TEXT_STYLE = 'CommentText';
 /** The character style of the annotation reference run, in the comment and in the body. */
@@ -34,64 +34,51 @@ const COMMENT_RANGE_END = 'org_docx4j_wml.CommentRangeEnd';
 const COMMENT_REFERENCE = 'org_docx4j_wml.R.CommentReference';
 /**
  * Every comment marker under a container (a body, a cell, a paragraph), in document order.
- * Deleted content (`w:del`) is not entered, as the text model does not enter it either.
+ * Deleted content (`w:del`) is not entered, as the text model does not enter it either. A kept
+ * `mc:AlternateContent` at block, row or cell level is read as `mode` says (CR-013 phase 2): a reader's
+ * walk takes its selected branch, an edit's (`removeMarkers`, the ids) every branch.
  */
-export function markersOf(container) {
+export function markersOf(container, hidden, mode = 'read') {
     const out = [];
-    collect(out, container);
+    collect(out, container, undefined, hidden, mode);
     return out;
 }
-/** The markers of one paragraph, with their offsets in its text. */
-export function markersOfParagraph(element, container) {
+/** The markers of one paragraph, with their offsets in its text (`Paragraph.text` where `hidden` is its `hiddenRuns()`). */
+export function markersOfParagraph(element, container, hidden) {
     const out = [];
-    collect(out, undefined, { element, container });
+    collect(out, undefined, { element, container }, hidden === undefined ? undefined : () => hidden);
     return out;
 }
-function collect(out, container, paragraph) {
+/**
+ * The walk behind both. A paragraph's markers are found by the same walk as its text (`segmentsOf`, in
+ * the accepted view: a `w:ins` and a `w:moveTo` hold text and markers, a `w:del` and a `w:moveFrom` hold
+ * neither), so that each offset is one in `Paragraph.text`, hidden runs left out where `hidden` says
+ * which they are, and a kept `mc:AlternateContent`'s selected branch read (CR-012 phase 4).
+ */
+function collect(out, container, paragraph, hidden, mode = 'read') {
     var _a;
     const visitParagraph = (element, blockContainer) => {
-        let pos = 0;
-        const visitRuns = (items) => {
-            var _a, _b, _c;
-            if (!items)
-                return;
-            for (const el of items) {
+        segmentsOf(element.value, {
+            hidden: hidden === null || hidden === void 0 ? void 0 : hidden(element.value),
+            visit: (el, at, owner, run) => {
                 const tn = typeNameOf(el);
-                if (tn === 'org_docx4j_wml.R') {
-                    const content = (_a = el.value.content) !== null && _a !== void 0 ? _a : [];
-                    for (const item of content) {
-                        if (typeNameOf(item) === COMMENT_REFERENCE) {
-                            out.push({
-                                id: item.value.id, kind: 'reference', item, owner: content,
-                                run: el, runOwner: items, paragraph: element, paragraphContainer: blockContainer, offset: pos,
-                            });
-                        }
-                        else
-                            pos += (_c = (_b = itemTextOf(item)) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0;
-                    }
+                if (tn === COMMENT_REFERENCE && run) {
+                    out.push({
+                        id: el.value.id, kind: 'reference', item: el, owner,
+                        run: run.element, runOwner: run.owner, paragraph: element, paragraphContainer: blockContainer, offset: at,
+                    });
                 }
                 else if (tn === COMMENT_RANGE_START || tn === COMMENT_RANGE_END) {
                     out.push({
                         id: el.value.id, kind: tn === COMMENT_RANGE_START ? 'start' : 'end',
-                        item: el, owner: items, paragraph: element, paragraphContainer: blockContainer, offset: pos,
+                        item: el, owner, paragraph: element, paragraphContainer: blockContainer, offset: at,
                     });
                 }
-                else if (tn !== undefined && RUN_HOLDERS.has(tn)) {
-                    visitRuns(runItemsOf(el.value));
-                }
-                else {
-                    // the accepted view, which is what the offsets are in: a w:ins and a w:moveTo hold text
-                    // and markers, a w:del and a w:moveFrom hold neither (CR-002 phase F)
-                    const kind = revisionKindOf(el);
-                    if (kind === 'ins' || kind === 'moveTo')
-                        visitRuns(runItemsOf(el.value));
-                }
-            }
-        };
-        visitRuns(runItemsOf(element.value));
+            },
+        });
     };
     const visitBlocks = (items) => {
-        var _a, _b, _c;
+        var _a, _b;
         for (const el of items) {
             const tn = typeNameOf(el);
             if (tn === 'org_docx4j_wml.P')
@@ -101,10 +88,14 @@ function collect(out, container, paragraph) {
             }
             else if (typeof el.value === 'object' && el.value !== null) {
                 if (tn === 'org_docx4j_wml.Tbl') {
-                    for (const row of (_a = childrenOf(el.value)) !== null && _a !== void 0 ? _a : []) {
-                        for (const cell of (_b = childrenOf(row.value)) !== null && _b !== void 0 ? _b : [])
-                            visitBlocks((_c = childrenOf(cell.value)) !== null && _c !== void 0 ? _c : []);
-                    }
+                    for (const row of rowsOf(el.value, mode))
+                        for (const cell of cellsOf(row.element.value, mode))
+                            visitBlocks((_a = childrenOf(cell.element.value)) !== null && _a !== void 0 ? _a : []);
+                }
+                else if (tn === ALTERNATE_CONTENT) {
+                    const ac = el.value;
+                    for (const branch of mode === 'every' ? branchesOf(ac) : [(_b = selectedBranchOf(ac)) !== null && _b !== void 0 ? _b : []])
+                        visitBlocks(branch);
                 }
                 else {
                     const children = childrenOf(el.value);
@@ -133,7 +124,7 @@ export function commentIdsOf(container) {
 /** Removes every marker of a comment from a body, and the reference run when nothing is left in it. */
 export function removeMarkers(container, id) {
     var _a;
-    for (const marker of markersOf(container)) {
+    for (const marker of markersOf(container, undefined, 'every')) {
         if (marker.id !== id)
             continue;
         const i = marker.owner.indexOf(marker.item);
@@ -157,7 +148,7 @@ export function nextCommentId(comments, container) {
     for (const c of (_a = comments.comment) !== null && _a !== void 0 ? _a : [])
         if (typeof c.id === 'number' && c.id > max)
             max = c.id;
-    for (const m of markersOf(container))
+    for (const m of markersOf(container, undefined, 'every'))
         if (m.id > max)
             max = m.id;
     return max + 1;
@@ -171,13 +162,28 @@ export function randomHexId(taken) {
     }
     throw new Docx4JException('Could not allocate a paragraph id');
 }
-/** The `w14:paraId` of a comment's first paragraph: the key of its w15 and w16cid entries. */
+/**
+ * The `w14:paraId` of a comment's first paragraph: the key of its w15 and w16cid entries. A kept
+ * `mc:AlternateContent` before any paragraph is read in its selected branch, as Word reads it (CR-013
+ * phase 3; docx4j's `Trees.lastParaId` looks into the branch the same way).
+ */
 export function commentParaId(comment) {
-    var _a;
-    for (const el of (_a = comment.content) !== null && _a !== void 0 ? _a : [])
-        if (typeNameOf(el) === 'org_docx4j_wml.P')
-            return el.value.paraId;
-    return undefined;
+    var _a, _b;
+    const first = (items) => {
+        var _a;
+        for (const el of items) {
+            const tn = typeNameOf(el);
+            if (tn === 'org_docx4j_wml.P')
+                return el.value.paraId;
+            if (tn === ALTERNATE_CONTENT) {
+                const found = first((_a = selectedBranchOf(el.value)) !== null && _a !== void 0 ? _a : []);
+                if (found !== null)
+                    return found;
+            }
+        }
+        return null;
+    };
+    return (_b = first(((_a = comment.content) !== null && _a !== void 0 ? _a : []))) !== null && _b !== void 0 ? _b : undefined;
 }
 /** True when a paragraph id is already used by a comment or by a paragraph of the document. */
 export function paraIdTaken(parts, container, id) {
@@ -189,7 +195,7 @@ export function paraIdTaken(parts, container, id) {
         }
     let found = false;
     const visit = (items) => {
-        var _a, _b, _c;
+        var _a;
         for (const el of items) {
             const tn = typeNameOf(el);
             if (tn === 'org_docx4j_wml.P') {
@@ -198,9 +204,13 @@ export function paraIdTaken(parts, container, id) {
             }
             else if (typeof el.value === 'object' && el.value !== null) {
                 if (tn === 'org_docx4j_wml.Tbl') {
-                    for (const row of (_a = childrenOf(el.value)) !== null && _a !== void 0 ? _a : [])
-                        for (const cell of (_b = childrenOf(row.value)) !== null && _b !== void 0 ? _b : [])
-                            visit((_c = childrenOf(cell.value)) !== null && _c !== void 0 ? _c : []);
+                    for (const row of rowsOf(el.value, 'every'))
+                        for (const cell of cellsOf(row.element.value, 'every'))
+                            visit((_a = childrenOf(cell.element.value)) !== null && _a !== void 0 ? _a : []);
+                }
+                else if (tn === ALTERNATE_CONTENT) {
+                    for (const branch of branchesOf(el.value))
+                        visit(branch); // an id is every branch's (CR-013)
                 }
                 else {
                     const children = childrenOf(el.value);

package/dist/model/content/generalException.d.mts

@@ -0,0 +1,18 @@
+import { Docx4JException } from '../../opc/exceptions.mjs';
+/**
+ * What Office JS throws where the host refuses an operation it has no answer for: its `code`, so that
+ * add-in code branching on `error.code` behaves the same here (check 19: a hyperlink set on an empty range;
+ * check 52: a range starting or ending inside a table deleted or replaced).
+ */
+export declare class GeneralException extends Docx4JException {
+    readonly code = "GeneralException";
+    constructor(message: string);
+}
+/**
+ * What Office JS throws for an argument it won't take (`InvalidArgument`): its `code`, as `GeneralException` carries its
+ * own (check 56: `insertTable` into a bound block content control).
+ */
+export declare class InvalidArgument extends Docx4JException {
+    readonly code = "InvalidArgument";
+    constructor(message: string);
+}

package/dist/model/content/generalException.mjs

@@ -0,0 +1,24 @@
+import { Docx4JException } from '../../opc/exceptions.mjs';
+/**
+ * What Office JS throws where the host refuses an operation it has no answer for: its `code`, so that
+ * add-in code branching on `error.code` behaves the same here (check 19: a hyperlink set on an empty range;
+ * check 52: a range starting or ending inside a table deleted or replaced).
+ */
+export class GeneralException extends Docx4JException {
+    constructor(message) {
+        super(message);
+        this.code = 'GeneralException';
+        this.name = 'GeneralException';
+    }
+}
+/**
+ * What Office JS throws for an argument it won't take (`InvalidArgument`): its `code`, as `GeneralException` carries its
+ * own (check 56: `insertTable` into a bound block content control).
+ */
+export class InvalidArgument extends Docx4JException {
+    constructor(message) {
+        super(message);
+        this.code = 'InvalidArgument';
+        this.name = 'InvalidArgument';
+    }
+}

package/dist/model/content/index.d.mts

@@ -7,13 +7,18 @@ export { List, ListItem, ListItemNotFoundError, NumberingFacade, listsOf, listLa
 export { type Author, type CommentContent, type CommentOptions, type CommentEntry, type CommentParts, type CommentPartsAccess, type CommentsExtensible, type CommentMarker, COMMENT_TEXT_STYLE, COMMENT_REFERENCE_STYLE, markersOf, markersOfParagraph, commentIdsOf } from './comments.mjs';
 export { Font, type UnderlineType, type RPrHolder, type FontTracking } from './Font.mjs';
 export { Table, TableRow, TableCell, cellOf } from './Table.mjs';
+export { endsWithParagraph, endWithParagraph } from './tableRules.mjs';
 export { layoutModeOf, textWidthTwips, gridWidthsOf, widthTypeOf, insertGridColumns, deleteGridColumns, gridRangeOf, type TableLayoutMode, type ColumnInsertion } from './tableColumns.mjs';
 export { InlinePicture, imageInfoOf, naturalSizeEmu, addImage, addImagePart, writableWidthEmu, type ImageFormat, type ImageInfo, type InlinePictureOptions, type NewPicture, type NewImagePart } from './InlinePicture.mjs';
 export { ContentControl, collectControls, collectRunControls, W14_NS, W15_NS, type ContentControlType, type ContentControlForm, type ContentControlAppearance } from './ContentControl.mjs';
 export { contentOf, isFlatOpc, rewriteRelationshipIds, type OoxmlOptions } from './ooxml.mjs';
-export { type SearchOptions, searchPattern, findAll, matchesOf, expandReplacement } from './search.mjs';
-export { segmentsOf, runsOf, runItemsOf, childrenOf, rowsOf, cellsOf, BLOCK_LEVEL_TYPES, SDT_TYPES, runOf, paragraphOf, textOfView, revisionKindOf, type TextSegment, type Located, type TextView, type TextViewOptions, type RevisionKind, type RevisionHolder } from './tree.mjs';
-export { TrackedChange, trackedChangesOfParagraph, trackedChangesOfRow, joinWithNext, type TrackedChangeType, type TrackedChangeTarget } from './TrackedChange.mjs';
+export { type SearchOptions, searchPattern, findAll, matchesOf, expandReplacement, officeMatches, type OfficeMatch, type SearchSegment } from './search.mjs';
+export { segmentsOf, runsOf, runItemsOf, selectedBranchOf, isAlternateContent, childrenOf, rowsOf, cellsOf, BLOCK_LEVEL_TYPES, SDT_TYPES, runOf, paragraphOf, textOfView, revisionKindOf, officeItemText, hiddenRunsOf, type TextSegment, type Located, type TextView, type TextViewOptions, type SegmentOptions, type HiddenRuns, type AlternateLocation, type RevisionKind, type RevisionHolder } from './tree.mjs';
+export { mathTextOf, mathLetter } from './mathText.mjs';
+export { textBoxesOf, type AnchoredBox } from './textBoxes.mjs';
+export { ResolvedView } from './ResolvedView.mjs';
+export { TrackedChange, trackedChangesOfParagraph, trackedChangesOfRow, joinWithNext, type TrackedChangeType, type TrackedChangeKind, type TrackedChangeTarget, type NoteRemovals } from './TrackedChange.mjs';
+export type { TrackedChangeFilter, TrackedChangeSelection } from './trackedChangeFilter.mjs';
 export { ChangeTracker, trackerOf, calendarOf, dateOf, wordCalendarOf, revisionDateOf, copyRPr, markDeleted, markInserted, highestAnnotationId, MARKUP_TYPES, toDeletedText, toRestoredText, restoreRPr, restorePPr, trackInsertedParagraph, trackInsertedTable, trackInsertedBlocks, wrapNewRuns, wrapInsertedRuns, paraRPrOf, rowPrOf, pruneParagraphProperties, type ChangeTrackingMode, type TrackingHost, type TrackingScope, type TrackedPart, } from './tracking.mjs';
 export { wml, wmlOne, p, r, t, br, tab, tbl, tr, tc, sdt, sdtPr, nextSdtId, sdtProperty, sdtKindOf, inlinePicture, rPrToElements, rPrFromElements, textOf, walk, walkAll, find, linkParents, applyRunOptions, readRunOptions, UNDERLINE_TO_WML, isElement, typeNameOf, W_NS, type Element, type Wrapper, type WmlOptions, type Raw, type Interpolated, type RunOptions, type RunFormatting, type ParagraphOptions, type TableOptions, type CellOptions, type SdtKind, type SdtForm, type SdtOptions } from '@docx4j/generated-objects-ts/builders/wml';
 export { StylesFacade, type StylePackageLike } from './stylesFacade.mjs';

package/dist/model/content/index.mjs

@@ -9,13 +9,18 @@ export { List, ListItem, ListItemNotFoundError, NumberingFacade, listsOf, listLa
 export { COMMENT_TEXT_STYLE, COMMENT_REFERENCE_STYLE, markersOf, markersOfParagraph, commentIdsOf } from './comments.mjs';
 export { Font } from './Font.mjs';
 export { Table, TableRow, TableCell, cellOf } from './Table.mjs';
+// Word's rule for what a cell holds (CR-002 section 55; docx4j's TableRules)
+export { endsWithParagraph, endWithParagraph } from './tableRules.mjs';
 export { layoutModeOf, textWidthTwips, gridWidthsOf, widthTypeOf, insertGridColumns, deleteGridColumns, gridRangeOf } from './tableColumns.mjs';
 export { InlinePicture, imageInfoOf, naturalSizeEmu, addImage, addImagePart, writableWidthEmu } from './InlinePicture.mjs';
 export { ContentControl, collectControls, collectRunControls, W14_NS, W15_NS } from './ContentControl.mjs';
 export { contentOf, isFlatOpc, rewriteRelationshipIds } from './ooxml.mjs';
-export { searchPattern, findAll, matchesOf, expandReplacement } from './search.mjs';
-export { segmentsOf, runsOf, runItemsOf, childrenOf, rowsOf, cellsOf, BLOCK_LEVEL_TYPES, SDT_TYPES, runOf, paragraphOf, textOfView, revisionKindOf } from './tree.mjs';
+export { searchPattern, findAll, matchesOf, expandReplacement, officeMatches } from './search.mjs';
+export { segmentsOf, runsOf, runItemsOf, selectedBranchOf, isAlternateContent, childrenOf, rowsOf, cellsOf, BLOCK_LEVEL_TYPES, SDT_TYPES, runOf, paragraphOf, textOfView, revisionKindOf, officeItemText, hiddenRunsOf } from './tree.mjs';
+export { mathTextOf, mathLetter } from './mathText.mjs';
+export { textBoxesOf } from './textBoxes.mjs';
 // change tracking (CR-002 phase F)
+export { ResolvedView } from './ResolvedView.mjs';
 export { TrackedChange, trackedChangesOfParagraph, trackedChangesOfRow, joinWithNext } from './TrackedChange.mjs';
 export { ChangeTracker, trackerOf, calendarOf, dateOf, wordCalendarOf, revisionDateOf, copyRPr, markDeleted, markInserted, highestAnnotationId, MARKUP_TYPES, toDeletedText, toRestoredText, restoreRPr, restorePPr, trackInsertedParagraph, trackInsertedTable, trackInsertedBlocks, wrapNewRuns, wrapInsertedRuns, paraRPrOf, rowPrOf, pruneParagraphProperties, } from './tracking.mjs';
 // The objects package's builders, re-exported so that one import serves the content API and the tree it works on.

package/dist/model/content/mathText.d.mts

@@ -0,0 +1,21 @@
+import type { Element } from '@docx4j/generated-objects-ts/builders/wml';
+/** The two views a paragraph's text is read in. */
+type View = 'accepted' | 'original';
+/** True for an equation at run-holder level: `m:oMath` or `m:oMathPara`. */
+export declare function isMath(el: Element): boolean;
+/**
+ * The text of an equation (`m:oMath`, `m:oMathPara`) in a view: the `m:t` of every math run in document
+ * order, a revision's runs as the view has them, a structure the view hides (its `m:ctrlPr`'s revision) left out
+ * whole, each letter mapped as Word draws it (`mathLetter`).
+ */
+export declare function mathTextOf(math: unknown, view?: View): string;
+/**
+ * A character as Word draws it in a math run with this `m:sty` (`p`, `b`, `i`, `bi`; none is Word's default,
+ * italic) and `m:scr` (`roman`, the default, `script`, `fraktur`, `double-struck`, `sans-serif`,
+ * `monospace`), as check 51 measured: letters, Greek capitals, small letters and nabla alike, in the
+ * alphabet of the style and script; digits upright in the script's family (bold for bold or bold italic,
+ * sans-serif under sans-serif, none of their own in script or fraktur); a character no alphabet has is
+ * itself.
+ */
+export declare function mathLetter(c: string, sty: string | undefined, scr: string | undefined): string;
+export {};