@docx-editor.dev/core 2.17.0 → 2.19.0

package/dist/{protocol-K-Djpjjw.d.ts → protocol-OdRd17KZ.d.ts}

@@ -1,5 +1,18 @@
-import { H as HeaderFooterVariant } from './hf-references-kSSFMq9X.js';
-import { N as NoteKind } from './tree-store-BRfhZceK.js';
+import { A as AutomationTableMutation } from './tree-op-types-DbdM7fJV.js';
+import { H as HeaderFooterVariant, N as NoteKind } from './tree-package-fragment-1pdDnhZ_.js';
+
+interface AutomationInlinePictureRead {
+    readonly width: number;
+    readonly height: number;
+    readonly lockAspectRatio: boolean;
+    readonly altTextDescription: string;
+}
+interface AutomationInlinePictureWrite {
+    readonly width?: number;
+    readonly height?: number;
+    readonly lockAspectRatio?: boolean;
+    readonly altTextDescription?: string;
+}
 
 /** Alignment as this protocol publishes it. `Mixed`/`Unknown` are read-only answers. */
 type AutomationAlignment = 'Mixed' | 'Unknown' | 'Left' | 'Centered' | 'Right' | 'Justified';
@@ -13,6 +26,11 @@ type AutomationAlignment = 'Mixed' | 'Unknown' | 'Left' | 'Centered' | 'Right' |
 interface AutomationFontRead {
     readonly bold: boolean | null;
     readonly italic: boolean | null;
+    readonly underline: string | null;
+    readonly strikeThrough: boolean | null;
+    readonly highlightColor: string | null;
+    readonly subscript: boolean | null;
+    readonly superscript: boolean | null;
     /** `w:rFonts/@w:ascii`. */
     readonly name: string | null;
     /** Points. */
@@ -24,6 +42,11 @@ interface AutomationFontRead {
 interface AutomationFontWrite {
     readonly bold?: boolean;
     readonly italic?: boolean;
+    readonly underline?: string;
+    readonly strikeThrough?: boolean;
+    readonly highlightColor?: string | null;
+    readonly subscript?: boolean;
+    readonly superscript?: boolean;
     readonly name?: string;
     readonly size?: number;
     readonly color?: string;
@@ -73,6 +96,118 @@ interface AutomationParagraphFormatWrite {
     readonly widowControl?: boolean;
 }
 
+type AutomationListBullet = 'Custom' | 'Solid' | 'Hollow' | 'Square' | 'Diamonds' | 'Arrow' | 'Checkmark';
+type AutomationListNumbering = 'None' | 'Arabic' | 'UpperRoman' | 'LowerRoman' | 'UpperLetter' | 'LowerLetter';
+interface AutomationListLevelFormat {
+    readonly bullet?: AutomationListBullet;
+    readonly charCode?: number;
+    readonly fontName?: string;
+    readonly numbering?: AutomationListNumbering;
+    readonly formatString?: readonly (string | number)[];
+    readonly startingNumber?: number;
+    readonly textIndent?: number;
+    readonly bulletNumberPictureIndent?: number;
+}
+
+/** Table, picture, field, break, and list authoring transport operations. */
+type AutomationAuthoringOperation = {
+    readonly op: 'getFields';
+    readonly span: AutomationSpanRef;
+} | {
+    readonly op: 'getField' | 'deleteField' | 'updateFieldResult';
+    readonly field: AutomationHandle;
+} | {
+    readonly op: 'setFieldCode';
+    readonly field: AutomationHandle;
+    readonly code: string;
+} | {
+    readonly op: 'insertField';
+    readonly span: AutomationSpanRef;
+    readonly location: 'Before' | 'After' | 'Start' | 'End' | 'Replace';
+    readonly fieldType?: string;
+    readonly text?: string;
+    readonly removeFormatting?: boolean;
+} | {
+    readonly op: 'getTables';
+    readonly scope: AutomationSpanRef;
+} | {
+    readonly op: 'getTable' | 'getTableRows';
+    readonly table: AutomationHandle;
+} | {
+    readonly op: 'getTableCells';
+    readonly row: AutomationHandle;
+} | {
+    readonly op: 'getTableCell';
+    readonly table: AutomationHandle;
+    readonly rowIndex: number;
+    readonly cellIndex: number;
+} | {
+    readonly op: 'getTableCellProperties' | 'getTableCellBody';
+    readonly cell: AutomationHandle;
+} | {
+    readonly op: 'updateTable';
+    readonly table: AutomationHandle;
+    readonly mutation: Exclude<AutomationTableMutation, {
+        kind: 'cell';
+    }>;
+} | {
+    readonly op: 'updateTableCell';
+    readonly cell: AutomationHandle;
+    readonly properties: Omit<Extract<AutomationTableMutation, {
+        kind: 'cell';
+    }>, 'kind' | 'cellId'>;
+} | {
+    readonly op: 'insertTable';
+    readonly span: AutomationSpanRef;
+    readonly location: 'Before' | 'After';
+    readonly rowCount: number;
+    readonly columnCount: number;
+    readonly values?: readonly (readonly string[])[];
+} | {
+    readonly op: 'getInlinePictures';
+    readonly span: AutomationSpanRef;
+} | {
+    readonly op: 'getInlinePicture';
+    readonly picture: AutomationHandle;
+} | {
+    readonly op: 'setInlinePicture';
+    readonly picture: AutomationHandle;
+    readonly properties: AutomationInlinePictureWrite;
+} | {
+    readonly op: 'deleteInlinePicture';
+    readonly picture: AutomationHandle;
+} | {
+    readonly op: 'insertInlinePicture';
+    readonly span: AutomationSpanRef;
+    readonly base64: string;
+    readonly location: 'Before' | 'After' | 'Start' | 'End' | 'Replace';
+} | {
+    readonly op: 'insertBreak';
+    readonly span: AutomationSpanRef;
+    readonly breakType: string;
+    readonly location: string;
+} | {
+    readonly op: 'startNewList';
+    readonly paragraph: AutomationHandle;
+} | {
+    readonly op: 'attachToList';
+    readonly paragraph: AutomationHandle;
+    readonly listId: number;
+    readonly level: number;
+} | {
+    readonly op: 'detachFromList';
+    readonly paragraph: AutomationHandle;
+} | {
+    readonly op: 'setListLevelFormat';
+    readonly list: AutomationHandle;
+    readonly level: number;
+    readonly format: AutomationListLevelFormat;
+} | {
+    readonly op: 'getRange';
+    readonly span: AutomationSpanRef;
+    readonly location: 'Whole' | 'Content' | 'Start' | 'End' | 'Before' | 'After';
+};
+
 /**
  * Which way round a page is, in OOXML's own lower-case spelling.
  *
@@ -232,7 +367,7 @@ type AutomationSelectionMode = 'select' | 'start' | 'end';
  * Reads never open a transaction; commands in one batch commit together. Handles are NAMES the
  * host minted, never pointers, so an operation is plain transport data.
  */
-type AutomationOperation = {
+type AutomationOperation = AutomationAuthoringOperation | {
     readonly op: 'getChangeTrackingMode';
 } | {
     readonly op: 'setChangeTrackingMode';
@@ -971,6 +1106,8 @@ type AutomationOperation = {
 /** Author tag, title or lock. An omitted member is left as it is; `null` removes it. */
  | {
     readonly op: 'setContentControlProperties';
+    readonly cannotEdit?: boolean;
+    readonly cannotDelete?: boolean;
     readonly contentControl: AutomationHandle;
     readonly tag?: string | null;
     readonly title?: string | null;
@@ -998,6 +1135,7 @@ type AutomationOperation = {
 /** Wrap a span in a new control of the named type. */
  | {
     readonly op: 'insertContentControl';
+    readonly returnHandle?: boolean;
     readonly span: AutomationSpanRef;
     readonly subtype: AutomationContentControlSubtype;
     readonly tag?: string;
@@ -1060,9 +1198,9 @@ interface AutomationCustomNodePayload {
 /** Just the `op` discriminants of {@link AutomationOperation}, for dispatch tables. */
 type AutomationOperationKind = AutomationOperation['op'];
 /** Operations that read. They never open a transaction. */
-declare const AUTOMATION_QUERY_OPERATIONS: readonly ["getChangeTrackingMode", "getDocument", "getBody", "getParagraphs", "getSpanParagraphs", "getText", "getSpanText", "getParagraphId", "search", "getFont", "getParagraphFormat", "getStyle", "getSections", "getPageSetup", "getFurniture", "getNotes", "getNoteBody", "getNoteText", "getNoteKind", "getLists", "getListId", "getListById", "getListParagraphs", "getParagraphList", "getListLevel", "getHyperlink", "getBookmarks", "getBookmarkName", "getBookmarkRange", "getComments", "getCommentReplies", "getCommentId", "getCommentAuthor", "getCommentDate", "getCommentText", "getCommentRange", "getCommentResolved", "getRevisions", "getRevisionType", "getRevisionAuthor", "getRevisionDate", "getRevisionRange", "getContentControls", "getContentControlById", "getContentControlsByTag", "getContentControlsByTitle", "getContentControlTag", "getContentControlTitle", "getContentControlFileId", "getContentControlSubtype", "getContentControlLock", "getContentControlIsBound", "getContentControlPlaceholderShown", "getContentControlTemporary", "getContentControlText", "getContentControlParagraphs", "getContentControlRange"];
+declare const AUTOMATION_QUERY_OPERATIONS: readonly ["getTables", "getTable", "getTableRows", "getTableCells", "getTableCell", "getTableCellProperties", "getTableCellBody", "getFields", "getField", "getInlinePictures", "getInlinePicture", "getChangeTrackingMode", "getDocument", "getBody", "getParagraphs", "getRange", "getSpanParagraphs", "getText", "getSpanText", "getParagraphId", "search", "getFont", "getParagraphFormat", "getStyle", "getSections", "getPageSetup", "getFurniture", "getNotes", "getNoteBody", "getNoteText", "getNoteKind", "getLists", "getListId", "getListById", "getListParagraphs", "getParagraphList", "getListLevel", "getHyperlink", "getBookmarks", "getBookmarkName", "getBookmarkRange", "getComments", "getCommentReplies", "getCommentId", "getCommentAuthor", "getCommentDate", "getCommentText", "getCommentRange", "getCommentResolved", "getRevisions", "getRevisionType", "getRevisionAuthor", "getRevisionDate", "getRevisionRange", "getContentControls", "getContentControlById", "getContentControlsByTag", "getContentControlsByTitle", "getContentControlTag", "getContentControlTitle", "getContentControlFileId", "getContentControlSubtype", "getContentControlLock", "getContentControlIsBound", "getContentControlPlaceholderShown", "getContentControlTemporary", "getContentControlText", "getContentControlParagraphs", "getContentControlRange"];
 /** Operations that write. Every one of these goes through the single transaction path. */
-declare const AUTOMATION_COMMAND_OPERATIONS: readonly ["setChangeTrackingMode", "proposeInsertion", "proposeDeletion", "proposeReplacement", "insertText", "replaceSpan", "replaceStoryBlocks", "insertParagraph", "splitParagraph", "deleteParagraph", "selectSpan", "selectBookmark", "setFont", "setParagraphFormat", "setStyle", "setPageSetup", "deleteNote", "setListLevel", "insertListParagraph", "setHyperlink", "insertComment", "setCommentResolved", "replyToComment", "deleteComment", "acceptRevision", "rejectRevision", "acceptAllRevisions", "rejectAllRevisions", "setContentControlValue", "setContentControlProperties", "deleteContentControl", "insertContentControlText", "insertContentControl", "insertCustomNode"];
+declare const AUTOMATION_COMMAND_OPERATIONS: readonly ["insertTable", "updateTable", "updateTableCell", "setInlinePicture", "deleteInlinePicture", "insertField", "setFieldCode", "deleteField", "updateFieldResult", "insertInlinePicture", "insertBreak", "setChangeTrackingMode", "proposeInsertion", "proposeDeletion", "proposeReplacement", "insertText", "replaceSpan", "replaceStoryBlocks", "insertParagraph", "splitParagraph", "deleteParagraph", "selectSpan", "selectBookmark", "setFont", "setParagraphFormat", "setStyle", "setPageSetup", "deleteNote", "setListLevel", "startNewList", "attachToList", "detachFromList", "setListLevelFormat", "insertListParagraph", "setHyperlink", "insertComment", "setCommentResolved", "replyToComment", "deleteComment", "acceptRevision", "rejectRevision", "acceptAllRevisions", "rejectAllRevisions", "setContentControlValue", "setContentControlProperties", "deleteContentControl", "insertContentControlText", "insertContentControl", "insertCustomNode"];
 /**
  * Commands that commit as a PACKAGE transaction and therefore share a batch with nothing.
  *
@@ -1072,7 +1210,7 @@ declare const AUTOMATION_COMMAND_OPERATIONS: readonly ["setChangeTrackingMode",
  * beside a story command, would be two commits: two revisions, and a moment where half the
  * caller's batch is published. Refused while planning instead.
  */
-declare const AUTOMATION_SOLITARY_OPERATIONS: readonly ["deleteNote", "insertComment", "setCommentResolved", "replyToComment", "insertCustomNode"];
+declare const AUTOMATION_SOLITARY_OPERATIONS: readonly ["insertTable", "insertInlinePicture", "insertBreak", "startNewList", "deleteNote", "insertComment", "setCommentResolved", "replyToComment", "insertCustomNode"];
 /** Whether an operation must be the only one in its batch. */
 declare function isSolitaryAutomationCommand(operation: AutomationOperation): boolean;
 /** Whether an operation writes. Drives the query/command split inside one batch. */
@@ -1084,7 +1222,7 @@ declare function isAutomationCommand(operation: AutomationOperation): boolean;
  * `body` is one STORY — the main body, a header or footer variant of a section, or one note — so
  * every object reached through a body is reached in a named story rather than in "the document".
  */
-type AutomationObjectKind = 'document' | 'body' | 'paragraph' | 'section' | 'note' | 'comment' | 'revision' | 'bookmark' | 'list' | 'contentControl';
+type AutomationObjectKind = 'document' | 'body' | 'paragraph' | 'section' | 'note' | 'comment' | 'revision' | 'bookmark' | 'list' | 'contentControl' | 'table' | 'tableRow' | 'tableCell' | 'field' | 'inlinePicture';
 declare const AUTOMATION_HANDLE_BRAND: unique symbol;
 /**
  * An opaque host-minted name for a document object.
@@ -1222,6 +1360,31 @@ interface AutomationSpan {
 }
 /** What an operation answered with. */
 type AutomationValue = {
+    readonly kind: 'field';
+    readonly field: {
+        readonly code: string;
+    };
+} | {
+    readonly kind: 'table';
+    readonly table: {
+        readonly values: readonly (readonly string[])[];
+        readonly style: string;
+        readonly headerRowCount: number;
+        readonly rowCount: number;
+        readonly columnCount: number;
+    };
+} | {
+    readonly kind: 'tableCell';
+    readonly cell: {
+        readonly value: string;
+        readonly columnWidth: number;
+        readonly shadingColor: string;
+        readonly verticalAlignment: 'Top' | 'Center' | 'Bottom';
+    };
+} | {
+    readonly kind: 'inlinePicture';
+    readonly picture: AutomationInlinePictureRead;
+} | {
     readonly kind: 'handle';
     readonly handle: AutomationHandle;
 } | {
@@ -1375,6 +1538,8 @@ interface AutomationHost {
      * nothing is written at all.
      */
     execute(request: AutomationBatchRequest): AutomationBatchResponse;
+    /** Settle optional pagination resources before a field-update batch. Does not write content. */
+    prepare?(request: AutomationBatchRequest): Promise<void>;
     /** The current document as DOCX bytes, through the normalizing serializer. */
     save(): AutomationSaveResult;
     /** Change notification. Returns an unsubscribe that is safe to call more than once. */

package/dist/{review-items-CiliAz8H.d.ts → review-items-CJz-kAW8.d.ts}

@@ -1,4 +1,4 @@
-import { c as OoxmlElement, O as OoxmlPart, b as OoxmlPackage, R as RevisionAddress } from './tree-op-types-C71G7rIv.js';
+import { e as OoxmlElement, O as OoxmlPart, b as OoxmlPackage, R as RevisionAddress } from './tree-op-types-DbdM7fJV.js';
 
 /** The `w15` namespace: `commentsExtended.xml` — thread parent and resolved state. */
 declare const W15_NAMESPACE_URI = "http://schemas.microsoft.com/office/word/2012/wordml";
@@ -367,4 +367,4 @@ declare function activeReviewItem(items: readonly ReviewItem[], position: Review
  */
 declare function reviewThreadRootOf(items: readonly ReviewItem[], comment: ReviewCommentItem): ReviewItem;
 
-export { type CommentRecord as C, type ReviewModelInput as R, W15_NAMESPACE_URI as W, type ReviewItem as a, type ReviewRevisionItem as b, type ReviewCommentItem as c, type ReviewCustomItem as d, type ReviewPosition as e, type ReviewRange as f, type ReviewRevisionKind as g, type CommentThreadState as h, type CommentAnchor as i, type CommentPosition as j, commentAnchorsOfStory as k, commentsOfPart as l, firstReviewRange as m, hasAnyComment as n, reviewItemRanges as o, activeReviewItem as p, reviewItemPositionRank as q, reviewItemKey as r, reviewItemsAt as s, threadStateOfPart as t, reviewThreadRootOf as u };
+export { type CommentRecord as C, type ReviewModelInput as R, W15_NAMESPACE_URI as W, type ReviewItem as a, type ReviewRevisionItem as b, type ReviewCommentItem as c, type ReviewCustomItem as d, type ReviewPosition as e, type ReviewRange as f, type ReviewRevisionKind as g, type CommentAnchor as h, type CommentPosition as i, type CommentThreadState as j, activeReviewItem as k, firstReviewRange as l, reviewItemPositionRank as m, reviewItemRanges as n, reviewItemsAt as o, reviewThreadRootOf as p, commentAnchorsOfStory as q, reviewItemKey as r, commentsOfPart as s, hasAnyComment as t, threadStateOfPart as u };

package/dist/{review-paragraph-order-BlSnyg9a.d.ts → review-paragraph-order--jLHXIcd.d.ts}

@@ -1,5 +1,5 @@
-import { a as OoxmlNode, c as OoxmlElement, r as OoxmlContentControlNode, e as OoxmlGenericElementNode, s as OoxmlContentControlContentNode, O as OoxmlPart } from './tree-op-types-C71G7rIv.js';
-import { C as CommentRecord } from './review-items-CiliAz8H.js';
+import { a as OoxmlNode, e as OoxmlElement, i as OoxmlContentControlNode, d as OoxmlGenericElementNode, j as OoxmlContentControlContentNode, O as OoxmlPart } from './tree-op-types-DbdM7fJV.js';
+import { C as CommentRecord } from './review-items-CJz-kAW8.js';
 
 /** Nested content-control wrappers deeper than this stop flattening; content stays preserved. */
 declare const MAX_CONTENT_CONTROL_NESTING = 32;
@@ -76,4 +76,4 @@ declare function paragraphOrderOfPart(part: OoxmlPart): ReadonlyMap<string, numb
  */
 declare function deepParagraphOrderOfPart(part: OoxmlPart): ReadonlyMap<string, number>;
 
-export { MAX_CONTENT_CONTROL_NESTING as M, commentBodyText as a, commentInitials as b, collectFlowBlocks as c, contentControlContentOf as d, deepParagraphOrderOfPart as e, isContentControlContent as f, walkParagraphInline as g, walkStoryBlocks as h, isContentControl as i, contentControlContentChildren as j, paragraphOrderOfPart as p, walkAllStoryParagraphs as w };
+export { MAX_CONTENT_CONTROL_NESTING as M, commentBodyText as a, commentInitials as b, collectFlowBlocks as c, contentControlContentChildren as d, isContentControlContent as e, contentControlContentOf as f, deepParagraphOrderOfPart as g, walkParagraphInline as h, isContentControl as i, walkStoryBlocks as j, paragraphOrderOfPart as p, walkAllStoryParagraphs as w };

package/dist/{revision-projection-JiDclAFU.d.ts → revision-projection-BIHO_qvw.d.ts}

@@ -1,4 +1,4 @@
-import { a as OoxmlNode } from './tree-op-types-C71G7rIv.js';
+import { a as OoxmlNode } from './tree-op-types-DbdM7fJV.js';
 
 /**
  * What a revision wrapper asserts about the content inside it.

package/dist/{semantic-cell-selection-C-VsxNee.d.ts → semantic-cell-selection-lCYAVCCF.d.ts}

@@ -1,7 +1,7 @@
-import { O as OoxmlPart, c as OoxmlElement, a as OoxmlNode } from './tree-op-types-C71G7rIv.js';
-import { P as PageGeometry, I as InlineDrawingRecord, A as AnchoredDrawingRecord, T as TextMeasurer, L as LineRecord, a as StyleSpanRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, b as TableRowFragmentRecord, c as TableCellFragmentRecord } from './semantic-records-Bc-MGXbM.js';
-import { R as RevisionDisplayMode, a as RevisionAuthorFilter } from './revision-projection-JiDclAFU.js';
-import { S as SemanticPosition, C as CaretGeometry, a as SemanticSelection } from './semantic-interaction-2vPh96Ey.js';
+import { O as OoxmlPart, e as OoxmlElement, a as OoxmlNode } from './tree-op-types-DbdM7fJV.js';
+import { P as PageGeometry, I as InlineDrawingRecord, A as AnchoredDrawingRecord, T as TextMeasurer, L as LineRecord, a as StyleSpanRecord, S as SemanticLayout, C as ContentControlBoundaryRecord, b as TableRowFragmentRecord, c as TableCellFragmentRecord } from './semantic-records-ZcYuB4-H.js';
+import { R as RevisionDisplayMode, a as RevisionAuthorFilter } from './revision-projection-BIHO_qvw.js';
+import { S as SemanticPosition, C as CaretGeometry, a as SemanticSelection } from './semantic-interaction-0vQXcMZk.js';
 
 /**
  * Hard ceiling on sections enumerated from a document (matches write-path
@@ -282,26 +282,8 @@ declare function hitTestSheet(layout: SemanticLayout, point: HitPoint, options?:
  */
 declare function contentControlAtPoint(layout: SemanticLayout, pageIndex: number, point: HitPoint): ContentControlBoundaryRecord | null;
 /**
- * The end position of a line, as Word places it.
- *
- * On a SOFT-WRAPPED line the space that caused the break is painted at the end of the line
- * but the caret belongs before it — otherwise clicking in the right margin puts the caret
- * visually at the start of the NEXT line, which reads as the click having missed. The last
- * line of a paragraph has no such space to discount.
- *
- * A HARD BREAK is the same story with a character that is always there: the position after
- * it belongs to the line the break opened (`caretAt` places it there), so a click in the
- * right margin of the line the break ENDED has to stop in front of it or the caret appears
- * a row below the click.
- *
- * A PAGE break is discounted even on the paragraph's LAST line, which is the one case the
- * last-line shortcut got wrong. The position after such a break is on the next page — and
- * when the remainder is empty it has no line anywhere, because Word Online starts the
- * following block flush at the top of that page. So the caret for it stays behind on the
- * line the break ended, and a click in the wide blank space beside the mark resolved to a
- * position a page away from where it landed: the caret appeared under the pointer and the
- * typing came out on the next page. `<w:p><w:r><w:br w:type="page"/></w:r></w:p>` is the
- * commonest way to end a page, so that blank space is most of a page wide.
+ * Logical line end, excluding the wrap space or hard break whose following position
+ * belongs to the next line. Page breaks are excluded even on the paragraph's last line.
  */
 declare function lineEndOffset(layout: SemanticLayout, line: LineRecord): number;
 /**

package/dist/{semantic-interaction-2vPh96Ey.d.ts → semantic-interaction-0vQXcMZk.d.ts}

@@ -1,4 +1,4 @@
-import { T as TextMeasurer, S as SemanticLayout, B as BlockFragmentRecord, C as ContentControlBoundaryRecord, a as StyleSpanRecord } from './semantic-records-Bc-MGXbM.js';
+import { T as TextMeasurer, S as SemanticLayout, B as BlockFragmentRecord, C as ContentControlBoundaryRecord, a as StyleSpanRecord } from './semantic-records-ZcYuB4-H.js';
 
 /** A caret position in the model. */
 interface SemanticPosition {
@@ -102,24 +102,7 @@ type NavigationCommand = 'left' | 'right' | 'up' | 'down' | 'wordLeft' | 'wordRi
  * motion in the interaction lane instead of making it a second consumer of the model.
  */
 declare function paragraphTextFromLayout(layout: SemanticLayout, paragraphId: string): string;
-/**
- * Paragraph offsets a WORD may not run through: the edges of every struck half on screen.
- *
- * Deleted text is the one thing a view paints that does not exist in the document the reader
- * is heading towards — it is the OTHER version, spliced in beside the proposal so the two can
- * be compared. Its characters are therefore not adjacent to their neighbours in any single
- * version, however adjacent they look.
- *
- * A replacement is where that stops being pedantic. Word writes one as a deletion immediately
- * followed by an insertion, with no separator between them, so `ALL CAPS` struck and `fsdfsd`
- * added read as the single word `CAPSfsdfsd`: a double-click on the old text selected the new
- * text with it, across a decision the reader had not taken. Feeding these to `wordBoundary`
- * makes each half its own word.
- *
- * Only the halves this view actually renders contribute. `proposed` paints no deletion, so it
- * has no seams and this answers empty — which is also why the walk reads the LAYOUT rather
- * than the tree.
- */
+/** Visible deletion boundaries split words without changing canonical text offsets. */
 declare function deletedTextBoundaries(layout: SemanticLayout, paragraphId: string): ReadonlySet<number>;
 /** Story-scoped stops are required when navigating inside an open header or footer. */
 interface MoveCaretOptions {

package/dist/{semantic-paint-BEjYcsPK.d.ts → semantic-paint-BSan4pBk.d.ts}

@@ -1,5 +1,5 @@
-import { C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-Bc-MGXbM.js';
-import { V as ValidatedImageBytesHandle, t as RenderableImageMime } from './tree-op-types-C71G7rIv.js';
+import { C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-ZcYuB4-H.js';
+import { V as ValidatedImageBytesHandle, k as RenderableImageMime } from './tree-op-types-DbdM7fJV.js';
 
 /**
  * Everything a host can say about ONE author's presentation. Every field is optional and
@@ -21,6 +21,14 @@ interface RevisionAuthorStyle {
     color?: string;
     /** Background wash behind this author's changes in the document. */
     background?: string;
+    /**
+     * Background of the highlight band over this author's OPEN change — the one the caret
+     * is in. Applied inline, so it outranks the `--doc-revision-*-active-bg` kind tokens,
+     * and the kind-coloured rule under the band goes with it: a custom background with a
+     * green or red rule beneath it would contradict the decoration it sits behind, and a
+     * `transparent` that left a floating rule would not read as cleared at all.
+     */
+    activeBackground?: string;
     /**
      * Class names added to every painted span of this author's changes, for styling the
      * typed fields do not cover. Keep the rules metric-safe (outlines, shadows, accents):

package/dist/{semantic-records-Bc-MGXbM.d.ts → semantic-records-ZcYuB4-H.d.ts}

@@ -1,6 +1,6 @@
-import { b as RevisionAttribution, R as RevisionDisplayMode, a as RevisionAuthorFilter } from './revision-projection-JiDclAFU.js';
-import { q as OoxmlProperty, c as OoxmlElement, a as OoxmlNode, O as OoxmlPart, U as TableBorderStyle, x as ImageResourceState, W as DrawingAccessibility, X as DrawingImageEffects, S as SourceCrop, Y as DrawingTransform, Z as VectorShapeProjection, z as DrawingHorizontalReferenceFrame, A as DrawingVerticalReferenceFrame, u as ImageWrapTarget, _ as DrawingProjection, $ as OoxmlDrawingNode } from './tree-op-types-C71G7rIv.js';
-import { O as OmmlEquationProjection } from './omml-equation-C9AJfWy5.js';
+import { b as RevisionAttribution, R as RevisionDisplayMode, a as RevisionAuthorFilter } from './revision-projection-BIHO_qvw.js';
+import { h as OoxmlProperty, e as OoxmlElement, a as OoxmlNode, O as OoxmlPart, X as TableBorderStyle, o as ImageResourceState, Y as DrawingAccessibility, Z as DrawingImageEffects, S as SourceCrop, _ as DrawingTransform, $ as VectorShapeProjection, q as DrawingHorizontalReferenceFrame, r as DrawingVerticalReferenceFrame, I as ImageWrapTarget, a0 as DrawingProjection, a1 as OoxmlDrawingNode } from './tree-op-types-DbdM7fJV.js';
+import { O as OmmlEquationProjection } from './omml-equation-hcP9AUFX.js';
 
 /** Soft ceiling on abstractNum / num entries read from one part. */
 declare const MAX_NUMBERING_DEFINITIONS = 512;
@@ -17,6 +17,13 @@ type ListMarkerAlign = 'left' | 'center' | 'right';
  * must not overwrite an inherited `hanging` with a synthesized zero.
  */
 interface NumberingLevelIndent {
+    /** Authored physical/logical sides, in points, before paragraph direction resolves them. */
+    readonly authored?: {
+        readonly left?: number;
+        readonly right?: number;
+        readonly start?: number;
+        readonly end?: number;
+    };
     readonly left: number;
     readonly right: number;
     readonly hanging: number;
@@ -276,6 +283,16 @@ interface ResolvedRunStyle {
      * slot-homogeneous pieces happens downstream (`piecesOfParagraph`).
      */
     readonly fontFamilyEastAsia: string | null;
+    /** Script and paragraph-resolved direction for shaping and visual placement. */
+    readonly shaping?: {
+        readonly script: string;
+        readonly direction: 'ltr' | 'rtl';
+        readonly level: number;
+        readonly baseLevel: number;
+        /** Resolved w:rtl context; absent when authored Unicode controls govern the paragraph. */
+        readonly runDirection?: 'ltr' | 'rtl';
+        readonly wordSpacingPt?: number;
+    };
     /** Points. `w:sz` is half-points, so 22 becomes 11. */
     readonly fontSizePt: number;
     /** RRGGBB, or null for the inherited/automatic colour. */
@@ -340,6 +357,12 @@ interface ThemeFonts {
     readonly majorEastAsia?: string | null;
     /** `a:minorFont` east asian typeface (`a:ea`) — body text. Optional for back-compat. */
     readonly minorEastAsia?: string | null;
+    /** Complex-script heading and body theme faces. */
+    readonly majorBidi?: string | null;
+    readonly minorBidi?: string | null;
+    /** Language-specific theme faces, keyed by ISO 15924 script. */
+    readonly majorSupplemental?: Readonly<Record<string, string>>;
+    readonly minorSupplemental?: Readonly<Record<string, string>>;
 }
 /**
  * Resolve one run's direct formatting.
@@ -1087,6 +1110,9 @@ type HyperlinkProjector = (link: OoxmlNode) => SpanLinkRecord | null;
  */
 type FieldLinkProjector = (spec: HyperlinkFieldSpec) => SpanLinkRecord | null;
 
+/** Horizontal alignment of a paragraph (`w:jc`, ECMA-376 §17.3.1.13). */
+type Alignment = 'left' | 'center' | 'right' | 'both';
+
 /** Document-wide East Asian line-break and whitespace policy. @public */
 interface CjkTypographySettings {
     /** Apply the strict Japanese small-kana and prolonged-sound-mark restrictions. */
@@ -1348,9 +1374,6 @@ interface DrawingGeometry {
     readonly effectInsets: DrawingInsets;
 }
 
-/** Horizontal alignment of a paragraph (`w:jc`, ECMA-376 §17.3.1.13). */
-type Alignment = 'left' | 'center' | 'right' | 'both';
-
 /** Test-only mutable counters; omitted by production call sites. Not package-public. */
 interface TableBorderGridResolveWork {
     /** Sparse intervals emitted (not dense column slots). */
@@ -2110,13 +2133,10 @@ interface SemanticTableCell {
     readonly legacyContentAlignment?: true;
     /** Clamped to [1, MAX_TABLE_COLUMNS] at read time; layout never re-derives it. */
     readonly gridSpan: number;
-    /**
-     * Absolute grid column this cell starts on, after `w:gridBefore` and every preceding
-     * span. Structural conditional formats and cell geometry both key on this, never on the
-     * cell's position in the row: one `gridSpan` cell otherwise shifts firstCol/lastCol and
-     * the vertical bands for every cell after it.
-     */
+    /** Physical grid column after width/style resolution and the bidiVisual projection. */
     readonly gridColumn: number;
+    /** Stored grid index when bidiVisual maps this cell into a physical RTL grid. */
+    readonly logicalGridColumn?: number;
     /** Canonical `w:gridCol` node id for this cell's start column, when the grid is authored. */
     readonly gridColumnId?: string;
     /** A vMerge cell that is not the restart continues the cell above: box, no content. */
@@ -2181,6 +2201,8 @@ interface SemanticTableRow {
  * spans — vertical merges and column spans are already accounted for.
  */
 interface SemanticTableStructure {
+    /** Whether stored columns and horizontal table properties display right to left. */
+    readonly bidiVisual?: true;
     readonly columnWidthsPt: readonly number[];
     readonly rows: readonly SemanticTableRow[];
     /** Verified pre-2013 content-aligned full-width inline table; derived, never serialized. */
@@ -2429,6 +2451,13 @@ interface SpanLinkRecord {
 }
 /** A run of text on one line sharing identical resolved formatting. */
 interface StyleSpanRecord {
+    /**
+     * Horizontal ink displacement in points from box.x, before drawing the glyphs.
+     * CJK opening punctuation removes its left side bearing; its advance and caret
+     * boundaries remain box-based. Zero marks trailing-bearing compression with no
+     * ink displacement. Exporters must apply this offset to the ink origin.
+     */
+    readonly glyphOffsetPt?: number;
     readonly range: SourceRange;
     readonly text: string;
     /** The run's authored properties, retained as evidence. */
@@ -2561,7 +2590,7 @@ interface LineRecord {
      * the caret each fell back to `box.x` and drew a centred empty paragraph's caret hard
      * against the left margin, where it stayed until the first character was typed.
      *
-     * Equal to the first span's x whenever there is one, so it is the single origin every
+     * Equal to the leftmost span's x whenever there is one, so it is the single origin every
      * consumer can read without a spans-or-box fallback of its own.
      */
     readonly contentX: number;
@@ -2895,6 +2924,8 @@ interface TableCellFragmentRecord {
     readonly id: string;
     /** First grid column this cell occupies. */
     readonly gridColumn: number;
+    /** Stored grid index for an RTL cell; gridColumn indexes physical columnEdges. */
+    readonly logicalGridColumn?: number;
     /** Canonical `w:gridCol` node id for this cell's start column, when authored. */
     readonly gridColumnId?: string;
     /** Grid columns spanned, already clamped at read time. */
@@ -3197,6 +3228,21 @@ declare const DEFAULT_PAGE_GEOMETRY: PageGeometry;
 interface TextMeasurer {
     /** Advance width of `text` in the resolved style. */
     measure(text: string, style: ResolvedRunStyle): number;
+    /**
+     * Optional whole-span logical caret advances, indexed by UTF-16 offset. Values
+     * are nondecreasing, start at zero, and end at the measured advance. Ligature
+     * interiors may share an edge. Undefined selects a bounded approximate fallback.
+     */
+    caretAdvances?(text: string, style: ResolvedRunStyle): readonly number[] | undefined;
+    /**
+     * Optional conservative ink bounds for one grapheme, in points from its origin.
+     * Includes size and horizontal scale, but not trailing character spacing.
+     * Undefined keeps layout on the advance-only path.
+     */
+    inkBounds?(text: string, style: ResolvedRunStyle): {
+        left: number;
+        right: number;
+    } | undefined;
     /** Line height and baseline for the resolved style. */
     lineMetrics(style: ResolvedRunStyle): {
         height: number;