@docx-editor.dev/core 2.5.0 → 2.6.0

package/dist/{protocol-B5oSt08P.d.cts → protocol-CD7slqvl.d.cts}

@@ -1,5 +1,5 @@
-import { H as HeaderFooterVariant } from './hf-references-BPET4tlK.cjs';
-import { N as NoteKind } from './note-nodes-B2wWES2L.cjs';
+import { H as HeaderFooterVariant } from './hf-references-CgEOSw3i.cjs';
+import { N as NoteKind } from './note-nodes-C6DLxlvj.cjs';
 
 /** Alignment as this protocol publishes it. `Mixed`/`Unknown` are read-only answers. */
 type AutomationAlignment = 'Mixed' | 'Unknown' | 'Left' | 'Centered' | 'Right' | 'Justified';

package/dist/{protocol-ooK7PAXz.d.ts → protocol-DsbfgBwA.d.ts}

@@ -1,5 +1,5 @@
-import { H as HeaderFooterVariant } from './hf-references-CAp1xTv6.js';
-import { N as NoteKind } from './note-nodes-CZQXU6Fg.js';
+import { H as HeaderFooterVariant } from './hf-references-BdjsQNE_.js';
+import { N as NoteKind } from './note-nodes-BPSTVDMr.js';
 
 /** Alignment as this protocol publishes it. `Mixed`/`Unknown` are read-only answers. */
 type AutomationAlignment = 'Mixed' | 'Unknown' | 'Left' | 'Centered' | 'Right' | 'Justified';

package/dist/{note-properties-Dhqkro--.d.cts → review-reads-Dr0CpW6u.d.cts}

@@ -1,6 +1,70 @@
-import { a as OoxmlElement, e as OoxmlPart, O as OoxmlNode } from './ooxml-tree-CG0odFyi.cjs';
-import { R as RevisionAddress } from './tree-op-types-DOYNkKqD.cjs';
-import { O as OoxmlPackage } from './ooxml-package-Cmbe_M04.cjs';
+import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.cjs';
+import { O as OoxmlPackage } from './ooxml-package-CR5us6ad.cjs';
+import { R as RevisionAddress } from './tree-op-types-CUCwPWjT.cjs';
+
+/** `w:pos` — where a section's footnotes are laid out. */
+type FootnotePosition = 'pageBottom' | 'beneathText' | 'sectEnd' | 'docEnd';
+/** `w:pos` for endnotes — only the two document-level placements are legal. */
+type EndnotePosition = 'sectEnd' | 'docEnd';
+/** `w:numRestart` — when note numbering starts over. `eachPage` needs the reference's page. */
+type NoteNumRestart = 'continuous' | 'eachSect' | 'eachPage';
+/** Authored subset — only keys present in the file appear. */
+interface AuthoredNoteProperties {
+    readonly pos?: string;
+    readonly numFmt?: string;
+    readonly numStart?: number;
+    readonly numRestart?: string;
+}
+/** Fully resolved footnote properties (defaults filled). */
+interface ResolvedFootnoteProperties {
+    readonly pos: FootnotePosition;
+    readonly numFmt: string;
+    readonly numStart: number;
+    readonly numRestart: NoteNumRestart;
+}
+/** Fully resolved endnote properties (defaults filled). */
+interface ResolvedEndnoteProperties {
+    readonly pos: EndnotePosition;
+    readonly numFmt: string;
+    readonly numStart: number;
+    readonly numRestart: NoteNumRestart;
+}
+/** Word's own footnote defaults, applied where a section declares no `w:footnotePr`. */
+declare const DEFAULT_FOOTNOTE_PROPERTIES: ResolvedFootnoteProperties;
+/**
+ * Word-compatible defaults. ECMA-376 says omitted endnote `numFmt` is decimal;
+ * MS-OE376 / MS-OI29500 document that Word’s default is `lowerRoman` instead.
+ * Resolved (not authored) — unedited packages still invent nothing on save.
+ */
+declare const DEFAULT_ENDNOTE_PROPERTIES: ResolvedEndnoteProperties;
+/** Parse authored CT_FtnProps / CT_EdnProps without inventing defaults. */
+declare function parseAuthoredNoteProperties(propsNode: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
+/** Authored footnotePr on a sectPr node. */
+declare function authoredFootnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
+/** Authored endnotePr on a sectPr node. */
+declare function authoredEndnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
+/** Locate settings.xml via the main document relationship when present. */
+declare function settingsPartOf(pkg: OoxmlPackage): OoxmlPart | null;
+/** Authored document-level footnotePr from settings. */
+declare function authoredDocumentFootnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
+/** Authored document-level endnotePr from settings. */
+declare function authoredDocumentEndnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
+/**
+ * Resolve footnote properties: section → document → defaults.
+ * Illegal position strings fall through to the next layer / default.
+ */
+declare function resolveFootnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedFootnoteProperties;
+/**
+ * Resolve endnote properties: section → document → defaults.
+ * `pageBottom` is never a legal endnote position — falls back.
+ */
+declare function resolveEndnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedEndnoteProperties;
+/** Validate an authored endnote position write — refuse `pageBottom`. */
+declare function isLegalEndnotePosition(pos: string): pos is EndnotePosition;
+/** Validate an authored footnote position write. */
+declare function isLegalFootnotePosition(pos: string): pos is FootnotePosition;
+/** Whether a file-supplied string is a legal `w:numRestart` value. Narrows the type. */
+declare function isLegalNumRestart(value: string): value is NoteNumRestart;
 
 /** The `w15` namespace: `commentsExtended.xml` — thread parent and resolved state. */
 declare const W15_NAMESPACE_URI = "http://schemas.microsoft.com/office/word/2012/wordml";
@@ -365,68 +429,4 @@ declare function reviewItemRanges(item: ReviewItem): readonly ReviewRange[];
 /** The range an item is anchored at — where its card belongs and how it sorts. */
 declare function firstReviewRange(item: ReviewItem): ReviewRange | null;
 
-/** `w:pos` — where a section's footnotes are laid out. */
-type FootnotePosition = 'pageBottom' | 'beneathText' | 'sectEnd' | 'docEnd';
-/** `w:pos` for endnotes — only the two document-level placements are legal. */
-type EndnotePosition = 'sectEnd' | 'docEnd';
-/** `w:numRestart` — when note numbering starts over. `eachPage` needs the reference's page. */
-type NoteNumRestart = 'continuous' | 'eachSect' | 'eachPage';
-/** Authored subset — only keys present in the file appear. */
-interface AuthoredNoteProperties {
-    readonly pos?: string;
-    readonly numFmt?: string;
-    readonly numStart?: number;
-    readonly numRestart?: string;
-}
-/** Fully resolved footnote properties (defaults filled). */
-interface ResolvedFootnoteProperties {
-    readonly pos: FootnotePosition;
-    readonly numFmt: string;
-    readonly numStart: number;
-    readonly numRestart: NoteNumRestart;
-}
-/** Fully resolved endnote properties (defaults filled). */
-interface ResolvedEndnoteProperties {
-    readonly pos: EndnotePosition;
-    readonly numFmt: string;
-    readonly numStart: number;
-    readonly numRestart: NoteNumRestart;
-}
-/** Word's own footnote defaults, applied where a section declares no `w:footnotePr`. */
-declare const DEFAULT_FOOTNOTE_PROPERTIES: ResolvedFootnoteProperties;
-/**
- * Word-compatible defaults. ECMA-376 says omitted endnote `numFmt` is decimal;
- * MS-OE376 / MS-OI29500 document that Word’s default is `lowerRoman` instead.
- * Resolved (not authored) — unedited packages still invent nothing on save.
- */
-declare const DEFAULT_ENDNOTE_PROPERTIES: ResolvedEndnoteProperties;
-/** Parse authored CT_FtnProps / CT_EdnProps without inventing defaults. */
-declare function parseAuthoredNoteProperties(propsNode: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
-/** Authored footnotePr on a sectPr node. */
-declare function authoredFootnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
-/** Authored endnotePr on a sectPr node. */
-declare function authoredEndnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
-/** Locate settings.xml via the main document relationship when present. */
-declare function settingsPartOf(pkg: OoxmlPackage): OoxmlPart | null;
-/** Authored document-level footnotePr from settings. */
-declare function authoredDocumentFootnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
-/** Authored document-level endnotePr from settings. */
-declare function authoredDocumentEndnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
-/**
- * Resolve footnote properties: section → document → defaults.
- * Illegal position strings fall through to the next layer / default.
- */
-declare function resolveFootnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedFootnoteProperties;
-/**
- * Resolve endnote properties: section → document → defaults.
- * `pageBottom` is never a legal endnote position — falls back.
- */
-declare function resolveEndnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedEndnoteProperties;
-/** Validate an authored endnote position write — refuse `pageBottom`. */
-declare function isLegalEndnotePosition(pos: string): pos is EndnotePosition;
-/** Validate an authored footnote position write. */
-declare function isLegalFootnotePosition(pos: string): pos is FootnotePosition;
-/** Whether a file-supplied string is a legal `w:numRestart` value. Narrows the type. */
-declare function isLegalNumRestart(value: string): value is NoteNumRestart;
-
 export { type AuthoredNoteProperties as A, isLegalEndnotePosition as B, type CommentAnchor as C, DEFAULT_ENDNOTE_PROPERTIES as D, type EndnotePosition as E, type FootnotePosition as F, isLegalFootnotePosition as G, isLegalNumRestart as H, linkRevisionReplies as I, parseAuthoredNoteProperties as J, resolveEndnoteProperties as K, type LinkableReviewItem as L, resolveFootnoteProperties as M, type NoteNumRestart as N, reviewItemKey as O, reviewItemRanges as P, revisionItemsOf as Q, type ResolvedFootnoteProperties as R, settingsPartOf as S, threadStateOfPart as T, W15_NAMESPACE_URI as W, type ResolvedEndnoteProperties as a, type CommentPosition as b, type CommentRecord as c, type CommentThreadState as d, DEFAULT_FOOTNOTE_PROPERTIES as e, type ReviewCommentItem as f, type ReviewItem as g, type ReviewModelInput as h, type ReviewPosition as i, type ReviewRange as j, type ReviewRevisionItem as k, type ReviewRevisionKind as l, authoredDocumentEndnoteProperties as m, authoredDocumentFootnoteProperties as n, authoredEndnotePropertiesFromSectPr as o, paragraphOrderOfPart as p, authoredFootnotePropertiesFromSectPr as q, collectReviewItems as r, commentAnchorsOfStory as s, commentBodyText as t, commentInitials as u, commentItemsOf as v, commentsOfPart as w, deepParagraphOrderOfPart as x, firstReviewRange as y, hasAnyComment as z };

package/dist/{note-properties-BS66XmcC.d.ts → review-reads-HDvoQXK2.d.ts}

@@ -1,6 +1,70 @@
-import { a as OoxmlElement, e as OoxmlPart, O as OoxmlNode } from './ooxml-tree-CG0odFyi.js';
-import { R as RevisionAddress } from './tree-op-types-CZw9QhWX.js';
-import { O as OoxmlPackage } from './ooxml-package-BrxTmTsZ.js';
+import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.js';
+import { O as OoxmlPackage } from './ooxml-package-D_CtywTW.js';
+import { R as RevisionAddress } from './tree-op-types-D0fTNBVW.js';
+
+/** `w:pos` — where a section's footnotes are laid out. */
+type FootnotePosition = 'pageBottom' | 'beneathText' | 'sectEnd' | 'docEnd';
+/** `w:pos` for endnotes — only the two document-level placements are legal. */
+type EndnotePosition = 'sectEnd' | 'docEnd';
+/** `w:numRestart` — when note numbering starts over. `eachPage` needs the reference's page. */
+type NoteNumRestart = 'continuous' | 'eachSect' | 'eachPage';
+/** Authored subset — only keys present in the file appear. */
+interface AuthoredNoteProperties {
+    readonly pos?: string;
+    readonly numFmt?: string;
+    readonly numStart?: number;
+    readonly numRestart?: string;
+}
+/** Fully resolved footnote properties (defaults filled). */
+interface ResolvedFootnoteProperties {
+    readonly pos: FootnotePosition;
+    readonly numFmt: string;
+    readonly numStart: number;
+    readonly numRestart: NoteNumRestart;
+}
+/** Fully resolved endnote properties (defaults filled). */
+interface ResolvedEndnoteProperties {
+    readonly pos: EndnotePosition;
+    readonly numFmt: string;
+    readonly numStart: number;
+    readonly numRestart: NoteNumRestart;
+}
+/** Word's own footnote defaults, applied where a section declares no `w:footnotePr`. */
+declare const DEFAULT_FOOTNOTE_PROPERTIES: ResolvedFootnoteProperties;
+/**
+ * Word-compatible defaults. ECMA-376 says omitted endnote `numFmt` is decimal;
+ * MS-OE376 / MS-OI29500 document that Word’s default is `lowerRoman` instead.
+ * Resolved (not authored) — unedited packages still invent nothing on save.
+ */
+declare const DEFAULT_ENDNOTE_PROPERTIES: ResolvedEndnoteProperties;
+/** Parse authored CT_FtnProps / CT_EdnProps without inventing defaults. */
+declare function parseAuthoredNoteProperties(propsNode: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
+/** Authored footnotePr on a sectPr node. */
+declare function authoredFootnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
+/** Authored endnotePr on a sectPr node. */
+declare function authoredEndnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
+/** Locate settings.xml via the main document relationship when present. */
+declare function settingsPartOf(pkg: OoxmlPackage): OoxmlPart | null;
+/** Authored document-level footnotePr from settings. */
+declare function authoredDocumentFootnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
+/** Authored document-level endnotePr from settings. */
+declare function authoredDocumentEndnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
+/**
+ * Resolve footnote properties: section → document → defaults.
+ * Illegal position strings fall through to the next layer / default.
+ */
+declare function resolveFootnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedFootnoteProperties;
+/**
+ * Resolve endnote properties: section → document → defaults.
+ * `pageBottom` is never a legal endnote position — falls back.
+ */
+declare function resolveEndnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedEndnoteProperties;
+/** Validate an authored endnote position write — refuse `pageBottom`. */
+declare function isLegalEndnotePosition(pos: string): pos is EndnotePosition;
+/** Validate an authored footnote position write. */
+declare function isLegalFootnotePosition(pos: string): pos is FootnotePosition;
+/** Whether a file-supplied string is a legal `w:numRestart` value. Narrows the type. */
+declare function isLegalNumRestart(value: string): value is NoteNumRestart;
 
 /** The `w15` namespace: `commentsExtended.xml` — thread parent and resolved state. */
 declare const W15_NAMESPACE_URI = "http://schemas.microsoft.com/office/word/2012/wordml";
@@ -365,68 +429,4 @@ declare function reviewItemRanges(item: ReviewItem): readonly ReviewRange[];
 /** The range an item is anchored at — where its card belongs and how it sorts. */
 declare function firstReviewRange(item: ReviewItem): ReviewRange | null;
 
-/** `w:pos` — where a section's footnotes are laid out. */
-type FootnotePosition = 'pageBottom' | 'beneathText' | 'sectEnd' | 'docEnd';
-/** `w:pos` for endnotes — only the two document-level placements are legal. */
-type EndnotePosition = 'sectEnd' | 'docEnd';
-/** `w:numRestart` — when note numbering starts over. `eachPage` needs the reference's page. */
-type NoteNumRestart = 'continuous' | 'eachSect' | 'eachPage';
-/** Authored subset — only keys present in the file appear. */
-interface AuthoredNoteProperties {
-    readonly pos?: string;
-    readonly numFmt?: string;
-    readonly numStart?: number;
-    readonly numRestart?: string;
-}
-/** Fully resolved footnote properties (defaults filled). */
-interface ResolvedFootnoteProperties {
-    readonly pos: FootnotePosition;
-    readonly numFmt: string;
-    readonly numStart: number;
-    readonly numRestart: NoteNumRestart;
-}
-/** Fully resolved endnote properties (defaults filled). */
-interface ResolvedEndnoteProperties {
-    readonly pos: EndnotePosition;
-    readonly numFmt: string;
-    readonly numStart: number;
-    readonly numRestart: NoteNumRestart;
-}
-/** Word's own footnote defaults, applied where a section declares no `w:footnotePr`. */
-declare const DEFAULT_FOOTNOTE_PROPERTIES: ResolvedFootnoteProperties;
-/**
- * Word-compatible defaults. ECMA-376 says omitted endnote `numFmt` is decimal;
- * MS-OE376 / MS-OI29500 document that Word’s default is `lowerRoman` instead.
- * Resolved (not authored) — unedited packages still invent nothing on save.
- */
-declare const DEFAULT_ENDNOTE_PROPERTIES: ResolvedEndnoteProperties;
-/** Parse authored CT_FtnProps / CT_EdnProps without inventing defaults. */
-declare function parseAuthoredNoteProperties(propsNode: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
-/** Authored footnotePr on a sectPr node. */
-declare function authoredFootnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
-/** Authored endnotePr on a sectPr node. */
-declare function authoredEndnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
-/** Locate settings.xml via the main document relationship when present. */
-declare function settingsPartOf(pkg: OoxmlPackage): OoxmlPart | null;
-/** Authored document-level footnotePr from settings. */
-declare function authoredDocumentFootnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
-/** Authored document-level endnotePr from settings. */
-declare function authoredDocumentEndnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
-/**
- * Resolve footnote properties: section → document → defaults.
- * Illegal position strings fall through to the next layer / default.
- */
-declare function resolveFootnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedFootnoteProperties;
-/**
- * Resolve endnote properties: section → document → defaults.
- * `pageBottom` is never a legal endnote position — falls back.
- */
-declare function resolveEndnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedEndnoteProperties;
-/** Validate an authored endnote position write — refuse `pageBottom`. */
-declare function isLegalEndnotePosition(pos: string): pos is EndnotePosition;
-/** Validate an authored footnote position write. */
-declare function isLegalFootnotePosition(pos: string): pos is FootnotePosition;
-/** Whether a file-supplied string is a legal `w:numRestart` value. Narrows the type. */
-declare function isLegalNumRestart(value: string): value is NoteNumRestart;
-
 export { type AuthoredNoteProperties as A, isLegalEndnotePosition as B, type CommentAnchor as C, DEFAULT_ENDNOTE_PROPERTIES as D, type EndnotePosition as E, type FootnotePosition as F, isLegalFootnotePosition as G, isLegalNumRestart as H, linkRevisionReplies as I, parseAuthoredNoteProperties as J, resolveEndnoteProperties as K, type LinkableReviewItem as L, resolveFootnoteProperties as M, type NoteNumRestart as N, reviewItemKey as O, reviewItemRanges as P, revisionItemsOf as Q, type ResolvedFootnoteProperties as R, settingsPartOf as S, threadStateOfPart as T, W15_NAMESPACE_URI as W, type ResolvedEndnoteProperties as a, type CommentPosition as b, type CommentRecord as c, type CommentThreadState as d, DEFAULT_FOOTNOTE_PROPERTIES as e, type ReviewCommentItem as f, type ReviewItem as g, type ReviewModelInput as h, type ReviewPosition as i, type ReviewRange as j, type ReviewRevisionItem as k, type ReviewRevisionKind as l, authoredDocumentEndnoteProperties as m, authoredDocumentFootnoteProperties as n, authoredEndnotePropertiesFromSectPr as o, paragraphOrderOfPart as p, authoredFootnotePropertiesFromSectPr as q, collectReviewItems as r, commentAnchorsOfStory as s, commentBodyText as t, commentInitials as u, commentItemsOf as v, commentsOfPart as w, deepParagraphOrderOfPart as x, firstReviewRange as y, hasAnyComment as z };

package/dist/{review-support-Bl9sN8cv.d.ts → review-support-D4ZBdUXa.d.ts}

@@ -1,5 +1,5 @@
-import { e as OoxmlPart, a as OoxmlElement } from './ooxml-tree-CG0odFyi.js';
-import { R as RevisionAddress } from './tree-op-types-CZw9QhWX.js';
+import { e as OoxmlPart, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.js';
+import { R as RevisionAddress } from './tree-op-types-D0fTNBVW.js';
 
 /** The `w15` namespace: `commentsExtended.xml` — thread parent and resolved state. */
 declare const W15_NAMESPACE_URI = "http://schemas.microsoft.com/office/word/2012/wordml";

package/dist/{review-support-CHuJxHmz.d.cts → review-support-T-riLz4Y.d.cts}

@@ -1,5 +1,5 @@
-import { e as OoxmlPart, a as OoxmlElement } from './ooxml-tree-CG0odFyi.cjs';
-import { R as RevisionAddress } from './tree-op-types-DOYNkKqD.cjs';
+import { e as OoxmlPart, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.cjs';
+import { R as RevisionAddress } from './tree-op-types-CUCwPWjT.cjs';
 
 /** The `w15` namespace: `commentsExtended.xml` — thread parent and resolved state. */
 declare const W15_NAMESPACE_URI = "http://schemas.microsoft.com/office/word/2012/wordml";

package/dist/{revision-projection-u4nT52xT.d.ts → revision-projection-UKqvPa4-.d.ts}

@@ -1,4 +1,4 @@
-import { O as OoxmlNode } from './ooxml-tree-CG0odFyi.js';
+import { O as OoxmlNode } from './ooxml-tree-BU0e3DVi.js';
 
 /**
  * What a revision wrapper asserts about the content inside it.

package/dist/{revision-projection-DRZMzoLD.d.cts → revision-projection-WzlQGBJx.d.cts}

@@ -1,4 +1,4 @@
-import { O as OoxmlNode } from './ooxml-tree-CG0odFyi.cjs';
+import { O as OoxmlNode } from './ooxml-tree-BU0e3DVi.cjs';
 
 /**
  * What a revision wrapper asserts about the content inside it.

package/dist/{semantic-cell-selection-Dc-_enhm.d.ts → semantic-cell-selection-B5vfPz4Q.d.ts}

@@ -1,7 +1,7 @@
-import { e as OoxmlPart, a as OoxmlElement, O as OoxmlNode } from './ooxml-tree-CG0odFyi.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-B-qbrnp2.js';
-import { R as RevisionDisplayMode } from './revision-projection-u4nT52xT.js';
-import { S as SemanticPosition, C as CaretGeometry, a as SemanticSelection } from './semantic-interaction-CCVwyw2A.js';
+import { e as OoxmlPart, a as OoxmlElement, O as OoxmlNode } from './ooxml-tree-BU0e3DVi.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-CdQvpUj1.js';
+import { R as RevisionDisplayMode } from './revision-projection-UKqvPa4-.js';
+import { S as SemanticPosition, C as CaretGeometry, a as SemanticSelection } from './semantic-interaction-lvpzZRpA.js';
 
 /**
  * Hard ceiling on sections enumerated from a document (matches write-path

package/dist/{semantic-cell-selection-CdNQ-a9-.d.cts → semantic-cell-selection-BTQFpN0S.d.cts}

@@ -1,7 +1,7 @@
-import { e as OoxmlPart, a as OoxmlElement, O as OoxmlNode } from './ooxml-tree-CG0odFyi.cjs';
-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-Dq8SlCY8.cjs';
-import { R as RevisionDisplayMode } from './revision-projection-DRZMzoLD.cjs';
-import { S as SemanticPosition, C as CaretGeometry, a as SemanticSelection } from './semantic-interaction-DgaWs-5w.cjs';
+import { e as OoxmlPart, a as OoxmlElement, O as OoxmlNode } from './ooxml-tree-BU0e3DVi.cjs';
+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-DEOs3_tE.cjs';
+import { R as RevisionDisplayMode } from './revision-projection-WzlQGBJx.cjs';
+import { S as SemanticPosition, C as CaretGeometry, a as SemanticSelection } from './semantic-interaction-CDNEU_Tx.cjs';
 
 /**
  * Hard ceiling on sections enumerated from a document (matches write-path

package/dist/{semantic-interaction-DgaWs-5w.d.cts → semantic-interaction-CDNEU_Tx.d.cts}

@@ -1,4 +1,4 @@
-import { T as TextMeasurer, S as SemanticLayout, B as BlockFragmentRecord, C as ContentControlBoundaryRecord, a as StyleSpanRecord } from './semantic-records-Dq8SlCY8.cjs';
+import { T as TextMeasurer, S as SemanticLayout, B as BlockFragmentRecord, C as ContentControlBoundaryRecord, a as StyleSpanRecord } from './semantic-records-DEOs3_tE.cjs';
 
 /** A caret position in the model. */
 interface SemanticPosition {

package/dist/{semantic-interaction-CCVwyw2A.d.ts → semantic-interaction-lvpzZRpA.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-B-qbrnp2.js';
+import { T as TextMeasurer, S as SemanticLayout, B as BlockFragmentRecord, C as ContentControlBoundaryRecord, a as StyleSpanRecord } from './semantic-records-CdQvpUj1.js';
 
 /** A caret position in the model. */
 interface SemanticPosition {

package/dist/{semantic-paint-6iIB4fhx.d.cts → semantic-paint-BBPL3u5w.d.ts}

@@ -1,5 +1,98 @@
-import { C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-Dq8SlCY8.cjs';
-import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-CSlQmPIm.cjs';
+import { C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-CdQvpUj1.js';
+import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-Cl5_cNi9.js';
+
+/**
+ * Everything a host can say about ONE author's presentation. Every field is optional and
+ * every field is presentation-only — nothing here is ever serialised into the document.
+ *
+ * Deliberately about the PAINTED DOCUMENT (which only the painter can style) plus the
+ * author's identity data. Review-card DESIGN is not configured here: the review chrome
+ * follows `color` as its accent automatically, and everything further is composition —
+ * a custom card reading this style through the review surface's `useReviewAuthor`, or
+ * CSS on the cards' `data-review-author`/`data-review-author-slot` hooks.
+ *
+ * @public
+ */
+interface RevisionAuthorStyle {
+    /**
+     * Ink and decoration colour of this author's changes in the document — and the accent
+     * the review chrome keys on (avatar disc, card variable, marker).
+     */
+    color?: string;
+    /** Background wash behind this author's changes in the document. */
+    background?: 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):
+     * the engine measures the text it paints, and a class that resizes glyphs drifts the
+     * page from its layout.
+     */
+    spanClassName?: string;
+    /** Avatar image for this author; the packaged card renders it in place of initials. */
+    avatarUrl?: string;
+}
+/**
+ * Per-author style assignments.
+ *
+ * Keys match `w:author` exactly; a value is a CSS colour or a full
+ * {@link RevisionAuthorStyle}. `others` says what authors WITHOUT an entry take: the
+ * `--doc-review-author-N` ramp by default, or `'kind'` to leave them on the kind colours —
+ * which is how "highlight these reviewers, leave everyone else green and red" is said.
+ *
+ * @public
+ */
+interface RevisionAuthorAssignments {
+    /** Authors without an entry: the ramp (default), or the `'kind'` colours. */
+    readonly others?: 'kind' | 'author';
+    readonly authors: Readonly<Record<string, string | RevisionAuthorStyle>>;
+}
+/**
+ * How painted tracked changes are coloured.
+ *
+ * - `'author'` (the DEFAULT) — every change takes its author's colour from the
+ *   `--doc-review-author-N` ramp, assigned by order of first appearance in the document.
+ *   Word's own default, and the reason it is this engine's: a paragraph three people
+ *   edited has to read as three people. Restyle a slot under `.docx-editor` to change the
+ *   ramp.
+ * - `'kind'` — insertions and deletions take the two kind colours
+ *   (`--doc-revision-insertion` / `--doc-revision-deletion`), so "added" and "removed" are
+ *   what a reader tells apart at a glance, whoever proposed them.
+ * - {@link RevisionAuthorAssignments} — style the named authors; `others` decides whether
+ *   the rest take the ramp (the default) or the kind colours.
+ *
+ * Presentation only: nothing here is ever serialised into the document.
+ *
+ * @public
+ */
+type RevisionStyles = 'kind' | 'author' | RevisionAuthorAssignments;
+/**
+ * One document author, resolved: who, which ramp slot, and what they draw in.
+ *
+ * @public
+ */
+interface ReviewAuthorInfo {
+    /** The `w:author` string, exactly as the file carries it. */
+    readonly author: string;
+    /**
+     * Rank by order of first appearance — an UNBOUNDED index, not a ramp slot.
+     *
+     * The ramp defines {@link REVIEW_AUTHOR_SLOTS} colours and every DOM hook wraps into it,
+     * so the ninth author ranks 8 here and carries `data-review-author-slot="0"`. Building a
+     * selector from this value needs the same wrap: `slot % 8`.
+     */
+    readonly slot: number;
+    /**
+     * The colour this author is DRAWN IN by the review chrome — their declared colour, or
+     * their ramp slot's token.
+     *
+     * Not necessarily what the document paints. `'kind'`, and `others: 'kind'` for an author
+     * with no declaration, colour the painted text by insertion/deletion instead, while the
+     * cards keep the per-author accent this reports.
+     */
+    readonly color: string;
+    /** The host-supplied style, normalised; absent when the author rides the ramp. */
+    readonly style?: RevisionAuthorStyle;
+}
 
 /** Host port for safe blob URLs — only called for {@link ImageResourceState.kind} `ready`. */
 interface PaintImageUrlPort {
@@ -67,6 +160,12 @@ interface PaintOptions {
     readonly fieldShading?: FieldShadingMode;
     /** See {@link PaintContext.shadeFormFields}. */
     readonly shadeFormFields?: boolean;
+    /**
+     * How tracked changes are coloured: by AUTHOR through the `--doc-review-author-N`
+     * ramp (the default, as in Word), by kind, or by author with host-pinned colours.
+     * See {@link RevisionStyles}.
+     */
+    readonly revisionStyles?: RevisionStyles;
     /**
      * Relationship id of the header/footer story currently open for editing.
      *
@@ -116,6 +215,15 @@ interface PaintOptions {
         readonly additionalBoundaries?: readonly ContentControlBoundaryRecord[];
         /** Control ids that represent TOC regions (hover-only chrome; never caret-sticky). */
         readonly tocControlIds?: ReadonlySet<string>;
+        /**
+         * No control may be written right now — viewing mode, or a protected document.
+         *
+         * The widget is a `<button>` the ENGINE paints, and a click on it commits a tree op, so
+         * an enabled-looking checkbox on a read-only document is not a cosmetic lie: it is the
+         * write itself. Disabling it here also stops the pointer lane, which already skips a
+         * widget carrying `data-disabled-reason`.
+         */
+        readonly readOnly?: boolean;
     };
     readonly drawingStrings?: DrawingPaintStrings;
     readonly imageUrlPort?: PaintImageUrlPort;
@@ -130,4 +238,4 @@ interface PaintOptions {
  */
 declare function paintSemanticLayout(container: HTMLElement, layout: SemanticLayout, options?: PaintOptions): void;
 
-export { DEFAULT_FIELD_SHADING as D, type FieldShadingMode as F, type PaintOptions as P, type DrawingPaintStrings as a, paintSemanticLayout as p };
+export { DEFAULT_FIELD_SHADING as D, type FieldShadingMode as F, type PaintOptions as P, type ReviewAuthorInfo as R, type RevisionAuthorAssignments as a, type RevisionAuthorStyle as b, type RevisionStyles as c, type DrawingPaintStrings as d, paintSemanticLayout as p };