@eigenpal/docx-editor-core 1.2.0 → 1.3.0

package/dist/{footnotes-lCH_P3N3.d.mts → footnotes-BtVc6VFl.d.mts}

@@ -39,6 +39,19 @@ interface HeaderFooterLayoutInfo {
         left: number;
     };
 }
+/**
+ * Resolve the CSS `left` (px) for an anchored object (image or text box) in a
+ * header/footer, honoring `wp:positionH` (relativeTo page/margin, align
+ * left/center/right, or posOffset). Shared by floating images and text boxes so
+ * a page-centered text box in the header lands centered like Word, not pinned
+ * to the left.
+ */
+declare function resolveHeaderFooterFloatLeft(width: number, h: {
+    relativeTo?: string;
+    posOffset?: number;
+    align?: string;
+    alignment?: string;
+} | undefined, layout: HeaderFooterLayoutInfo): string;
 /**
  * Resolve the (left, top) position for a floating table inside a header/
  * footer container, per ECMA-376 §17.4.57. The table's `floating.tblpX/tblpY`
@@ -75,4 +88,4 @@ interface FootnoteRenderItem {
     content?: FootnoteContent;
 }
 
-export { type FootnoteRenderItem as F, type HeaderFooterContent as H, type HeaderFooterLayoutInfo as a, resolveHeaderFooterFloatingTablePosition as r };
+export { type FootnoteRenderItem as F, type HeaderFooterContent as H, type HeaderFooterLayoutInfo as a, resolveHeaderFooterFloatingTablePosition as b, resolveHeaderFooterFloatLeft as r };

package/dist/{footnotes-skVvEHvZ.d.ts → footnotes-DcUMWXul.d.ts}

@@ -39,6 +39,19 @@ interface HeaderFooterLayoutInfo {
         left: number;
     };
 }
+/**
+ * Resolve the CSS `left` (px) for an anchored object (image or text box) in a
+ * header/footer, honoring `wp:positionH` (relativeTo page/margin, align
+ * left/center/right, or posOffset). Shared by floating images and text boxes so
+ * a page-centered text box in the header lands centered like Word, not pinned
+ * to the left.
+ */
+declare function resolveHeaderFooterFloatLeft(width: number, h: {
+    relativeTo?: string;
+    posOffset?: number;
+    align?: string;
+    alignment?: string;
+} | undefined, layout: HeaderFooterLayoutInfo): string;
 /**
  * Resolve the (left, top) position for a floating table inside a header/
  * footer container, per ECMA-376 §17.4.57. The table's `floating.tblpX/tblpY`
@@ -75,4 +88,4 @@ interface FootnoteRenderItem {
     content?: FootnoteContent;
 }
 
-export { type FootnoteRenderItem as F, type HeaderFooterContent as H, type HeaderFooterLayoutInfo as a, resolveHeaderFooterFloatingTablePosition as r };
+export { type FootnoteRenderItem as F, type HeaderFooterContent as H, type HeaderFooterLayoutInfo as a, resolveHeaderFooterFloatingTablePosition as b, resolveHeaderFooterFloatLeft as r };

package/dist/{headerFooterLayout-Bd58Tum3.d.ts → headerFooterLayout-4E-S4Aay.d.ts}

@@ -1,9 +1,9 @@
 import { Node } from 'prosemirror-model';
 import { EditorView } from 'prosemirror-view';
 import { FlowBlock, Measure, LayoutOptions, FootnoteContent, Layout, Page, PageMargins, ImageRun } from './layout-engine/types.js';
-import { F as Footnote, y as HeaderFooter } from './content-CYXJ2tfQ.js';
-import { a as StyleDefinitions, T as Theme } from './styles-BBv7doYK.js';
-import { F as FootnoteRenderItem, H as HeaderFooterContent } from './footnotes-skVvEHvZ.js';
+import { F as Footnote, y as HeaderFooter } from './content-C8fc_tL6.js';
+import { S as StyleDefinitions, T as Theme } from './styles-BWqX2AS-.js';
+import { F as FootnoteRenderItem, H as HeaderFooterContent } from './footnotes-DcUMWXul.js';
 import { Document } from './types/document.js';
 
 /**
@@ -265,7 +265,7 @@ declare function invalidateHfDomCache(): void;
  *
  * @public
  */
-declare function computeHfCaretRectFromView(view: EditorView, doc?: globalThis.Document): {
+declare function computeHfCaretRectFromView(view: EditorView, section: 'header' | 'footer', doc?: globalThis.Document): {
     top: number;
     left: number;
     height: number;
@@ -282,7 +282,7 @@ declare function computeHfCaretRectFromView(view: EditorView, doc?: globalThis.D
  *
  * @public
  */
-declare function computeHfSelectionRectsFromView(view: EditorView, doc?: globalThis.Document): Array<{
+declare function computeHfSelectionRectsFromView(view: EditorView, section: 'header' | 'footer', doc?: globalThis.Document): Array<{
     top: number;
     left: number;
     width: number;

package/dist/{headerFooterLayout-CuIJiIzi.d.mts → headerFooterLayout-DlJLWmpR.d.mts}

@@ -1,9 +1,9 @@
 import { Node } from 'prosemirror-model';
 import { EditorView } from 'prosemirror-view';
 import { FlowBlock, Measure, LayoutOptions, FootnoteContent, Layout, Page, PageMargins, ImageRun } from './layout-engine/types.mjs';
-import { F as Footnote, y as HeaderFooter } from './content-CE-ZdMwG.mjs';
-import { a as StyleDefinitions, T as Theme } from './styles-EI2lxeEN.mjs';
-import { F as FootnoteRenderItem, H as HeaderFooterContent } from './footnotes-lCH_P3N3.mjs';
+import { F as Footnote, y as HeaderFooter } from './content-3xF4WDE8.mjs';
+import { S as StyleDefinitions, T as Theme } from './styles-BOJ93SAm.mjs';
+import { F as FootnoteRenderItem, H as HeaderFooterContent } from './footnotes-BtVc6VFl.mjs';
 import { Document } from './types/document.mjs';
 
 /**
@@ -265,7 +265,7 @@ declare function invalidateHfDomCache(): void;
  *
  * @public
  */
-declare function computeHfCaretRectFromView(view: EditorView, doc?: globalThis.Document): {
+declare function computeHfCaretRectFromView(view: EditorView, section: 'header' | 'footer', doc?: globalThis.Document): {
     top: number;
     left: number;
     height: number;
@@ -282,7 +282,7 @@ declare function computeHfCaretRectFromView(view: EditorView, doc?: globalThis.D
  *
  * @public
  */
-declare function computeHfSelectionRectsFromView(view: EditorView, doc?: globalThis.Document): Array<{
+declare function computeHfSelectionRectsFromView(view: EditorView, section: 'header' | 'footer', doc?: globalThis.Document): Array<{
     top: number;
     left: number;
     width: number;

package/dist/headless.d.mts

@@ -42,27 +42,63 @@
  */
 export { A as AgentContextOptions, S as ContextSelectionOptions, D as DocumentAgent, E as ExtendedSelectionContext, F as FormattedTextSegment, a as FormattingSummary, I as InsertHyperlinkOptions, b as InsertImageOptions, c as InsertTableOptions, d as InsertTextOptions, e as SelectionContextOptions, f as buildExtendedSelectionContext, g as buildSelectionContext, h as buildSelectionContextFromContext, i as createAgent, j as createAgentFromDocument, k as executeCommand, l as executeCommands, m as getAgentContext, n as getDocumentSummary, o as getSelectionFormattingSummary } from './selectionContext-CoZat7QZ.mjs';
 export { RepeatingSectionError, addRepeatingSectionItem, countCharacters, countWords, getBlockIndexForParagraph, getBodyCharacterCount, getBodyText, getBodyWordCount, getFormattingAtPosition, getHyperlinkAtPosition, getHyperlinkText, getParagraphAtIndex, getParagraphText, getParagraphs, getRunText, getTableText, getTextAfter, getTextBefore, hasHyperlinks, hasImages, hasTables, isHeadingStyle, isPositionInHyperlink, isRepeatingSection, isRepeatingSectionItem, parseHeadingLevel, removeRepeatingSectionItem } from './agent/index.mjs';
-export { C as ContentControlBoundError, a as ContentControlFilter, b as ContentControlInfo, c as ContentControlLockedError, d as ContentControlNotFoundError, e as ContentControlTypeError, f as ContentControlValue, g as ContentControlValueError, h as findContentControl, i as findContentControls, j as formatSdtDate, k as getContentControlText, r as removeContentControl, s as setContentControlContent, l as setContentControlValue } from './contentControlValues-DAwTWfgR.mjs';
+export { C as ContentControlBoundError, a as ContentControlFilter, b as ContentControlInfo, c as ContentControlLockedError, d as ContentControlNotFoundError, e as ContentControlTypeError, f as ContentControlValue, g as ContentControlValueError, h as findContentControl, i as findContentControls, j as formatSdtDate, k as getContentControlText, r as removeContentControl, s as setContentControlContent, l as setContentControlValue } from './contentControlValues-DjWvoJQ-.mjs';
 export { parseDocx } from './docx/parser.mjs';
-export { s as serializeDocumentBody, a as serializeDocx, b as serializeSectionProperties } from './documentSerializer-Bghq9rFI.mjs';
+export { s as serializeDocumentBody, a as serializeDocx, b as serializeSectionProperties } from './sectionPropertiesSerializer-D86QlzlT.mjs';
 export { createDocx, default as repackDocx, updateMultipleFiles } from './docx/rezip.mjs';
+import { Document } from './types/document.mjs';
+export { DocxPackage } from './types/document.mjs';
+import { W as Watermark } from './watermark-DAcnAs_J.mjs';
 export { a as attemptSelectiveSave } from './selectiveSave-jinP_4xa.mjs';
 export { b as buildPatchedDocumentXml, v as validatePatchSafety } from './selectiveXmlPatch-ypkxlTD_.mjs';
-export { C as CreateEmptyDocumentOptions, P as ProcessTemplateOptions, a as ProcessTemplateResult, T as TemplateError, b as blendColors, c as colorsEqual, d as createDocumentWithText, e as createEmptyDocument, f as createRgbColor, g as createTemplateProcessor, h as createThemeColor, i as darkenColor, j as getContrastingColor, k as getMissingVariables, l as getTemplateTags, m as isBlack, n as isWhite, o as lightenColor, p as parseColorString, q as previewTemplate, r as processTemplate, s as processTemplateAdvanced, t as processTemplateAsBlob, u as processTemplateDetailed, v as resolveColor, w as resolveHighlightColor, x as resolveShadingColor, y as validateTemplate } from './colorResolver-C6DtsoFI.mjs';
-export { V as VariableDetectionResult, a as VariableOccurrence, d as detectVariables, b as detectVariablesDetailed, c as detectVariablesInBody, e as detectVariablesInParagraph, f as documentHasVariables, g as extractVariablesFromText, h as formatVariable, i as hasTemplateVariables, j as isValidVariableName, p as parseVariable, r as removeVariables, k as replaceVariables, s as sanitizeVariableName } from './variableDetector-C7BLz9sJ.mjs';
+export { C as CreateEmptyDocumentOptions, P as ProcessTemplateOptions, a as ProcessTemplateResult, T as TemplateError, b as blendColors, c as colorsEqual, d as createDocumentWithText, e as createEmptyDocument, f as createRgbColor, g as createTemplateProcessor, h as createThemeColor, i as darkenColor, j as getContrastingColor, k as getMissingVariables, l as getTemplateTags, m as isBlack, n as isWhite, o as lightenColor, p as parseColorString, q as previewTemplate, r as processTemplate, s as processTemplateAdvanced, t as processTemplateAsBlob, u as processTemplateDetailed, v as resolveColor, w as resolveHighlightColor, x as resolveShadingColor, y as validateTemplate } from './colorResolver-BCvxTlLF.mjs';
+export { V as VariableDetectionResult, a as VariableOccurrence, d as detectVariables, b as detectVariablesDetailed, c as detectVariablesInBody, e as detectVariablesInParagraph, f as documentHasVariables, g as extractVariablesFromText, h as formatVariable, i as hasTemplateVariables, j as isValidVariableName, p as parseVariable, r as removeVariables, k as replaceVariables, s as sanitizeVariableName } from './variableDetector-CaY-sDau.mjs';
 export { emuToPixels, emuToTwips, formatPx, halfPointsToPixels, pixelsToEmu, pixelsToTwips, pointsToHalfPoints, pointsToPixels, twipsToEmu, twipsToPixels } from './utils/units.mjs';
 export { mapHexToHighlightName } from './utils/highlightColors.mjs';
-export { C as CommandHandler, a as CommandResult, b as CorePlugin, J as JsonSchema, L as LoadedDocument, M as McpSession, c as McpToolAnnotations, d as McpToolContent, e as McpToolContext, f as McpToolDefinition, g as McpToolHandler, h as McpToolResult, b as Plugin, P as PluginCommand, C as PluginCommandHandler, i as PluginEvent, j as PluginEventListener, k as PluginOptions, l as PluginRegistrationResult, f as ToolDefinition, g as ToolHandler, h as ToolResult, Z as ZodSchemaLike, m as isZodSchema } from './types-dYdjUZMo.mjs';
-export { P as PluginRegistry, c as createPluginRegistrar, p as pluginRegistry, r as registerPlugins } from './registry-Cpyybgij.mjs';
-export { Document, DocxPackage } from './types/document.mjs';
+export { b as CommandHandler, d as CommandResult, C as CorePlugin, J as JsonSchema, L as LoadedDocument, e as McpSession, f as McpToolAnnotations, g as McpToolContent, h as McpToolContext, M as McpToolDefinition, i as McpToolHandler, j as McpToolResult, C as Plugin, k as PluginCommand, b as PluginCommandHandler, l as PluginEvent, c as PluginEventListener, P as PluginOptions, a as PluginRegistrationResult, M as ToolDefinition, i as ToolHandler, j as ToolResult, Z as ZodSchemaLike, m as isZodSchema } from './types-DTF0N7UE.mjs';
+export { P as PluginRegistry, c as createPluginRegistrar, p as pluginRegistry, r as registerPlugins } from './registry-NLnxX7pq.mjs';
 export { AIAction, AIActionRequest, AgentCommand, AgentContext, AgentResponse, ApplyStyleCommand, ApplyVariablesCommand, DEFAULT_AI_ACTIONS, DeleteTextCommand, FormatParagraphCommand, FormatTextCommand, InsertHyperlinkCommand, InsertImageCommand, InsertTableCommand, InsertTextCommand, ParagraphContext, ParagraphOutline, Position, Range, ReplaceTextCommand, SectionInfo, SelectionContext, SetVariableCommand, StyleInfo, SuggestedAction, comparePositions, createCollapsedRange, createCommand, createRange, getActionDescription, getActionLabel, isPositionInRange } from './types/agentApi.mjs';
-export { B as BlockContent, C as Comment, a as CommentRangeEnd, b as CommentRangeStart, D as Deletion, c as DocumentBody, E as Endnote, F as Footnote, H as Hyperlink, I as Image, d as Insertion, L as ListLevel, M as MoveFrom, e as MoveTo, N as NumberingDefinitions, P as Paragraph, f as ParagraphContent, R as Run, g as RunContent, S as SectionProperties, T as Table, h as TableCell, i as TableRow, j as TextContent, k as TrackedChangeInfo, l as TrackedRunChange } from './content-CE-ZdMwG.mjs';
+export { B as BlockContent, e as Comment, f as CommentRangeEnd, g as CommentRangeStart, h as Deletion, D as DocumentBody, E as Endnote, F as Footnote, H as Hyperlink, I as Image, i as Insertion, L as ListLevel, M as MoveFrom, j as MoveTo, k as NumberingDefinitions, P as Paragraph, l as ParagraphContent, m as Run, n as RunContent, S as SectionProperties, T as Table, o as TableCell, p as TableRow, q as TextContent, r as TrackedChangeInfo, s as TrackedRunChange } from './content-3xF4WDE8.mjs';
 export { P as ParagraphFormatting, T as TextFormatting } from './formatting-BH4hcZiq.mjs';
-export { R as Relationship, S as Style, a as StyleDefinitions, T as Theme } from './styles-EI2lxeEN.mjs';
+export { R as Relationship, a as Style, S as StyleDefinitions, T as Theme } from './styles-BOJ93SAm.mjs';
 import './docxInput-DTbCa48g.mjs';
-import 'jszip';
 import './colors-C3vA7HUU.mjs';
 import './docx/wrapTypes.mjs';
+import 'jszip';
+
+/**
+ * Watermark document API
+ *
+ * Platform-agnostic helpers for reading and applying a document watermark.
+ * Shared by the React and Vue adapters (and the imperative ref API) so the
+ * "Design → Watermark" behavior stays identical across frameworks.
+ *
+ * A watermark lives on `HeaderFooter.watermark`. MS Word repeats the same
+ * watermark across the default, first-page, and even-page headers of every
+ * section, so `setDocumentWatermark`:
+ *
+ * 1. Applies the watermark (a per-header copy) to every existing header, and
+ * 2. Creates the header parts a section needs but lacks, so the watermark
+ *    still shows on title pages (`w:titlePg`) and even pages
+ *    (`w:evenAndOddHeaders`) and on documents that had no header at all.
+ *
+ * To avoid breaking header inheritance (a section that omits a header
+ * reference inherits the previous section's header — Word's "link to
+ * previous"), a missing `first`/`even` header part is only created when **no**
+ * header of that type exists anywhere in the document, i.e. there is nothing to
+ * inherit. All updates are immutable — a new `Document` is returned so the
+ * change lands in the host's undo/redo history.
+ */
+
+/** Read the document's watermark (the first header that carries one). */
+declare function getDocumentWatermark(doc: Document | null | undefined): Watermark | undefined;
+/**
+ * Return a new `Document` with the watermark applied to all headers, or removed
+ * when `watermark` is null. Creates the header parts a section needs but lacks
+ * (default for a headerless doc; first/even for title/even pages) so the
+ * watermark shows on every page MS Word would show it.
+ */
+declare function setDocumentWatermark(doc: Document, watermark: Watermark | null): Document;
 
 /**
  * @eigenpal/docx-editor-core/headless
@@ -108,4 +144,4 @@ import './docx/wrapTypes.mjs';
  */
 declare const VERSION = "0.0.2";
 
-export { VERSION };
+export { Document, VERSION, getDocumentWatermark, setDocumentWatermark };

package/dist/headless.d.ts

@@ -42,27 +42,63 @@
  */
 export { A as AgentContextOptions, S as ContextSelectionOptions, D as DocumentAgent, E as ExtendedSelectionContext, F as FormattedTextSegment, a as FormattingSummary, I as InsertHyperlinkOptions, b as InsertImageOptions, c as InsertTableOptions, d as InsertTextOptions, e as SelectionContextOptions, f as buildExtendedSelectionContext, g as buildSelectionContext, h as buildSelectionContextFromContext, i as createAgent, j as createAgentFromDocument, k as executeCommand, l as executeCommands, m as getAgentContext, n as getDocumentSummary, o as getSelectionFormattingSummary } from './selectionContext-BPAqgNgk.js';
 export { RepeatingSectionError, addRepeatingSectionItem, countCharacters, countWords, getBlockIndexForParagraph, getBodyCharacterCount, getBodyText, getBodyWordCount, getFormattingAtPosition, getHyperlinkAtPosition, getHyperlinkText, getParagraphAtIndex, getParagraphText, getParagraphs, getRunText, getTableText, getTextAfter, getTextBefore, hasHyperlinks, hasImages, hasTables, isHeadingStyle, isPositionInHyperlink, isRepeatingSection, isRepeatingSectionItem, parseHeadingLevel, removeRepeatingSectionItem } from './agent/index.js';
-export { C as ContentControlBoundError, a as ContentControlFilter, b as ContentControlInfo, c as ContentControlLockedError, d as ContentControlNotFoundError, e as ContentControlTypeError, f as ContentControlValue, g as ContentControlValueError, h as findContentControl, i as findContentControls, j as formatSdtDate, k as getContentControlText, r as removeContentControl, s as setContentControlContent, l as setContentControlValue } from './contentControlValues-gyVPsi6m.js';
+export { C as ContentControlBoundError, a as ContentControlFilter, b as ContentControlInfo, c as ContentControlLockedError, d as ContentControlNotFoundError, e as ContentControlTypeError, f as ContentControlValue, g as ContentControlValueError, h as findContentControl, i as findContentControls, j as formatSdtDate, k as getContentControlText, r as removeContentControl, s as setContentControlContent, l as setContentControlValue } from './contentControlValues-DGDKD589.js';
 export { parseDocx } from './docx/parser.js';
-export { s as serializeDocumentBody, a as serializeDocx, b as serializeSectionProperties } from './documentSerializer-C4lFC60P.js';
+export { s as serializeDocumentBody, a as serializeDocx, b as serializeSectionProperties } from './sectionPropertiesSerializer-uXyGONxu.js';
 export { createDocx, default as repackDocx, updateMultipleFiles } from './docx/rezip.js';
+import { Document } from './types/document.js';
+export { DocxPackage } from './types/document.js';
+import { W as Watermark } from './watermark-DAcnAs_J.js';
 export { a as attemptSelectiveSave } from './selectiveSave-CWaPEv0B.js';
 export { b as buildPatchedDocumentXml, v as validatePatchSafety } from './selectiveXmlPatch-ypkxlTD_.js';
-export { C as CreateEmptyDocumentOptions, P as ProcessTemplateOptions, a as ProcessTemplateResult, T as TemplateError, b as blendColors, c as colorsEqual, d as createDocumentWithText, e as createEmptyDocument, f as createRgbColor, g as createTemplateProcessor, h as createThemeColor, i as darkenColor, j as getContrastingColor, k as getMissingVariables, l as getTemplateTags, m as isBlack, n as isWhite, o as lightenColor, p as parseColorString, q as previewTemplate, r as processTemplate, s as processTemplateAdvanced, t as processTemplateAsBlob, u as processTemplateDetailed, v as resolveColor, w as resolveHighlightColor, x as resolveShadingColor, y as validateTemplate } from './colorResolver-BZ_yScf4.js';
-export { V as VariableDetectionResult, a as VariableOccurrence, d as detectVariables, b as detectVariablesDetailed, c as detectVariablesInBody, e as detectVariablesInParagraph, f as documentHasVariables, g as extractVariablesFromText, h as formatVariable, i as hasTemplateVariables, j as isValidVariableName, p as parseVariable, r as removeVariables, k as replaceVariables, s as sanitizeVariableName } from './variableDetector-HPZbJ_gw.js';
+export { C as CreateEmptyDocumentOptions, P as ProcessTemplateOptions, a as ProcessTemplateResult, T as TemplateError, b as blendColors, c as colorsEqual, d as createDocumentWithText, e as createEmptyDocument, f as createRgbColor, g as createTemplateProcessor, h as createThemeColor, i as darkenColor, j as getContrastingColor, k as getMissingVariables, l as getTemplateTags, m as isBlack, n as isWhite, o as lightenColor, p as parseColorString, q as previewTemplate, r as processTemplate, s as processTemplateAdvanced, t as processTemplateAsBlob, u as processTemplateDetailed, v as resolveColor, w as resolveHighlightColor, x as resolveShadingColor, y as validateTemplate } from './colorResolver-8A-qj-LP.js';
+export { V as VariableDetectionResult, a as VariableOccurrence, d as detectVariables, b as detectVariablesDetailed, c as detectVariablesInBody, e as detectVariablesInParagraph, f as documentHasVariables, g as extractVariablesFromText, h as formatVariable, i as hasTemplateVariables, j as isValidVariableName, p as parseVariable, r as removeVariables, k as replaceVariables, s as sanitizeVariableName } from './variableDetector-1mxzPfs2.js';
 export { emuToPixels, emuToTwips, formatPx, halfPointsToPixels, pixelsToEmu, pixelsToTwips, pointsToHalfPoints, pointsToPixels, twipsToEmu, twipsToPixels } from './utils/units.js';
 export { mapHexToHighlightName } from './utils/highlightColors.js';
-export { C as CommandHandler, a as CommandResult, b as CorePlugin, J as JsonSchema, L as LoadedDocument, M as McpSession, c as McpToolAnnotations, d as McpToolContent, e as McpToolContext, f as McpToolDefinition, g as McpToolHandler, h as McpToolResult, b as Plugin, P as PluginCommand, C as PluginCommandHandler, i as PluginEvent, j as PluginEventListener, k as PluginOptions, l as PluginRegistrationResult, f as ToolDefinition, g as ToolHandler, h as ToolResult, Z as ZodSchemaLike, m as isZodSchema } from './types-DXG7vqe9.js';
-export { P as PluginRegistry, c as createPluginRegistrar, p as pluginRegistry, r as registerPlugins } from './registry-E5pahPKL.js';
-export { Document, DocxPackage } from './types/document.js';
+export { b as CommandHandler, d as CommandResult, C as CorePlugin, J as JsonSchema, L as LoadedDocument, e as McpSession, f as McpToolAnnotations, g as McpToolContent, h as McpToolContext, M as McpToolDefinition, i as McpToolHandler, j as McpToolResult, C as Plugin, k as PluginCommand, b as PluginCommandHandler, l as PluginEvent, c as PluginEventListener, P as PluginOptions, a as PluginRegistrationResult, M as ToolDefinition, i as ToolHandler, j as ToolResult, Z as ZodSchemaLike, m as isZodSchema } from './types-DDQWU7-j.js';
+export { P as PluginRegistry, c as createPluginRegistrar, p as pluginRegistry, r as registerPlugins } from './registry-egK81C_z.js';
 export { AIAction, AIActionRequest, AgentCommand, AgentContext, AgentResponse, ApplyStyleCommand, ApplyVariablesCommand, DEFAULT_AI_ACTIONS, DeleteTextCommand, FormatParagraphCommand, FormatTextCommand, InsertHyperlinkCommand, InsertImageCommand, InsertTableCommand, InsertTextCommand, ParagraphContext, ParagraphOutline, Position, Range, ReplaceTextCommand, SectionInfo, SelectionContext, SetVariableCommand, StyleInfo, SuggestedAction, comparePositions, createCollapsedRange, createCommand, createRange, getActionDescription, getActionLabel, isPositionInRange } from './types/agentApi.js';
-export { B as BlockContent, C as Comment, a as CommentRangeEnd, b as CommentRangeStart, D as Deletion, c as DocumentBody, E as Endnote, F as Footnote, H as Hyperlink, I as Image, d as Insertion, L as ListLevel, M as MoveFrom, e as MoveTo, N as NumberingDefinitions, P as Paragraph, f as ParagraphContent, R as Run, g as RunContent, S as SectionProperties, T as Table, h as TableCell, i as TableRow, j as TextContent, k as TrackedChangeInfo, l as TrackedRunChange } from './content-CYXJ2tfQ.js';
+export { B as BlockContent, e as Comment, f as CommentRangeEnd, g as CommentRangeStart, h as Deletion, D as DocumentBody, E as Endnote, F as Footnote, H as Hyperlink, I as Image, i as Insertion, L as ListLevel, M as MoveFrom, j as MoveTo, k as NumberingDefinitions, P as Paragraph, l as ParagraphContent, m as Run, n as RunContent, S as SectionProperties, T as Table, o as TableCell, p as TableRow, q as TextContent, r as TrackedChangeInfo, s as TrackedRunChange } from './content-C8fc_tL6.js';
 export { P as ParagraphFormatting, T as TextFormatting } from './formatting-_OXU8gLB.js';
-export { R as Relationship, S as Style, a as StyleDefinitions, T as Theme } from './styles-BBv7doYK.js';
+export { R as Relationship, a as Style, S as StyleDefinitions, T as Theme } from './styles-BWqX2AS-.js';
 import './docxInput-DTbCa48g.js';
-import 'jszip';
 import './colors-C3vA7HUU.js';
 import './docx/wrapTypes.js';
+import 'jszip';
+
+/**
+ * Watermark document API
+ *
+ * Platform-agnostic helpers for reading and applying a document watermark.
+ * Shared by the React and Vue adapters (and the imperative ref API) so the
+ * "Design → Watermark" behavior stays identical across frameworks.
+ *
+ * A watermark lives on `HeaderFooter.watermark`. MS Word repeats the same
+ * watermark across the default, first-page, and even-page headers of every
+ * section, so `setDocumentWatermark`:
+ *
+ * 1. Applies the watermark (a per-header copy) to every existing header, and
+ * 2. Creates the header parts a section needs but lacks, so the watermark
+ *    still shows on title pages (`w:titlePg`) and even pages
+ *    (`w:evenAndOddHeaders`) and on documents that had no header at all.
+ *
+ * To avoid breaking header inheritance (a section that omits a header
+ * reference inherits the previous section's header — Word's "link to
+ * previous"), a missing `first`/`even` header part is only created when **no**
+ * header of that type exists anywhere in the document, i.e. there is nothing to
+ * inherit. All updates are immutable — a new `Document` is returned so the
+ * change lands in the host's undo/redo history.
+ */
+
+/** Read the document's watermark (the first header that carries one). */
+declare function getDocumentWatermark(doc: Document | null | undefined): Watermark | undefined;
+/**
+ * Return a new `Document` with the watermark applied to all headers, or removed
+ * when `watermark` is null. Creates the header parts a section needs but lacks
+ * (default for a headerless doc; first/even for title/even pages) so the
+ * watermark shows on every page MS Word would show it.
+ */
+declare function setDocumentWatermark(doc: Document, watermark: Watermark | null): Document;
 
 /**
  * @eigenpal/docx-editor-core/headless
@@ -108,4 +144,4 @@ import './docx/wrapTypes.js';
  */
 declare const VERSION = "0.0.2";
 
-export { VERSION };
+export { Document, VERSION, getDocumentWatermark, setDocumentWatermark };

package/dist/headless.js

@@ -1 +1 @@
-'use strict';var chunkQEACB5VG_js=require('./chunk-QEACB5VG.js'),chunkXXU7YQVV_js=require('./chunk-XXU7YQVV.js'),chunkU4WUDHDK_js=require('./chunk-U4WUDHDK.js'),chunk5M7TI6TV_js=require('./chunk-5M7TI6TV.js'),chunkNXLJVVVE_js=require('./chunk-NXLJVVVE.js'),chunk4QEETB7U_js=require('./chunk-4QEETB7U.js'),chunkU4UCHBZ7_js=require('./chunk-U4UCHBZ7.js'),chunkESI4BSBF_js=require('./chunk-ESI4BSBF.js'),chunkTE2AF7FM_js=require('./chunk-TE2AF7FM.js'),chunkSZIOF5SG_js=require('./chunk-SZIOF5SG.js'),chunkL72YAV5N_js=require('./chunk-L72YAV5N.js'),chunk4BFNWPKW_js=require('./chunk-4BFNWPKW.js'),chunkQYF7BRG3_js=require('./chunk-QYF7BRG3.js');require('./chunk-ROG4MNOR.js'),require('./chunk-44FHVKSI.js'),require('./chunk-MNOHUTKE.js');var chunkFO6IX2DB_js=require('./chunk-FO6IX2DB.js');require('./chunk-E4JMCA5X.js'),require('./chunk-HQPWFUP5.js'),require('./chunk-DV6GWBUJ.js');var chunkMJ5FQX7Q_js=require('./chunk-MJ5FQX7Q.js');require('./chunk-C2BAPYGJ.js');var chunk4Q2IP5FW_js=require('./chunk-4Q2IP5FW.js');require('./chunk-GSKMHXHG.js'),require('./chunk-DC7S76ZX.js');var Ct="0.0.2";Object.defineProperty(exports,"mapHexToHighlightName",{enumerable:true,get:function(){return chunkQEACB5VG_js.b}});Object.defineProperty(exports,"DEFAULT_AI_ACTIONS",{enumerable:true,get:function(){return chunkXXU7YQVV_js.g}});Object.defineProperty(exports,"comparePositions",{enumerable:true,get:function(){return chunkXXU7YQVV_js.d}});Object.defineProperty(exports,"createCollapsedRange",{enumerable:true,get:function(){return chunkXXU7YQVV_js.a}});Object.defineProperty(exports,"createCommand",{enumerable:true,get:function(){return chunkXXU7YQVV_js.h}});Object.defineProperty(exports,"createRange",{enumerable:true,get:function(){return chunkXXU7YQVV_js.b}});Object.defineProperty(exports,"getActionDescription",{enumerable:true,get:function(){return chunkXXU7YQVV_js.f}});Object.defineProperty(exports,"getActionLabel",{enumerable:true,get:function(){return chunkXXU7YQVV_js.e}});Object.defineProperty(exports,"isPositionInRange",{enumerable:true,get:function(){return chunkXXU7YQVV_js.c}});Object.defineProperty(exports,"DocumentAgent",{enumerable:true,get:function(){return chunkU4WUDHDK_js.a}});Object.defineProperty(exports,"buildExtendedSelectionContext",{enumerable:true,get:function(){return chunkU4WUDHDK_js.h}});Object.defineProperty(exports,"buildSelectionContext",{enumerable:true,get:function(){return chunkU4WUDHDK_js.g}});Object.defineProperty(exports,"buildSelectionContextFromContext",{enumerable:true,get:function(){return chunkU4WUDHDK_js.e}});Object.defineProperty(exports,"createAgent",{enumerable:true,get:function(){return chunkU4WUDHDK_js.b}});Object.defineProperty(exports,"createAgentFromDocument",{enumerable:true,get:function(){return chunkU4WUDHDK_js.c}});Object.defineProperty(exports,"getAgentContext",{enumerable:true,get:function(){return chunkU4WUDHDK_js.d}});Object.defineProperty(exports,"getDocumentSummary",{enumerable:true,get:function(){return chunkU4WUDHDK_js.f}});Object.defineProperty(exports,"getSelectionFormattingSummary",{enumerable:true,get:function(){return chunkU4WUDHDK_js.i}});Object.defineProperty(exports,"attemptSelectiveSave",{enumerable:true,get:function(){return chunk5M7TI6TV_js.c}});Object.defineProperty(exports,"buildPatchedDocumentXml",{enumerable:true,get:function(){return chunk5M7TI6TV_js.b}});Object.defineProperty(exports,"validatePatchSafety",{enumerable:true,get:function(){return chunk5M7TI6TV_js.a}});Object.defineProperty(exports,"createDocumentWithText",{enumerable:true,get:function(){return chunkNXLJVVVE_js.b}});Object.defineProperty(exports,"createEmptyDocument",{enumerable:true,get:function(){return chunkNXLJVVVE_js.a}});Object.defineProperty(exports,"isZodSchema",{enumerable:true,get:function(){return chunk4QEETB7U_js.a}});Object.defineProperty(exports,"detectVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.a}});Object.defineProperty(exports,"detectVariablesDetailed",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.b}});Object.defineProperty(exports,"detectVariablesInBody",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.c}});Object.defineProperty(exports,"detectVariablesInParagraph",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.d}});Object.defineProperty(exports,"documentHasVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.m}});Object.defineProperty(exports,"extractVariablesFromText",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.e}});Object.defineProperty(exports,"formatVariable",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.i}});Object.defineProperty(exports,"hasTemplateVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.f}});Object.defineProperty(exports,"isValidVariableName",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.g}});Object.defineProperty(exports,"parseVariable",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.j}});Object.defineProperty(exports,"removeVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.l}});Object.defineProperty(exports,"replaceVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.k}});Object.defineProperty(exports,"sanitizeVariableName",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.h}});Object.defineProperty(exports,"createTemplateProcessor",{enumerable:true,get:function(){return chunkESI4BSBF_js.j}});Object.defineProperty(exports,"getMissingVariables",{enumerable:true,get:function(){return chunkESI4BSBF_js.g}});Object.defineProperty(exports,"getTemplateTags",{enumerable:true,get:function(){return chunkESI4BSBF_js.e}});Object.defineProperty(exports,"previewTemplate",{enumerable:true,get:function(){return chunkESI4BSBF_js.h}});Object.defineProperty(exports,"processTemplate",{enumerable:true,get:function(){return chunkESI4BSBF_js.a}});Object.defineProperty(exports,"processTemplateAdvanced",{enumerable:true,get:function(){return chunkESI4BSBF_js.i}});Object.defineProperty(exports,"processTemplateAsBlob",{enumerable:true,get:function(){return chunkESI4BSBF_js.c}});Object.defineProperty(exports,"processTemplateDetailed",{enumerable:true,get:function(){return chunkESI4BSBF_js.b}});Object.defineProperty(exports,"validateTemplate",{enumerable:true,get:function(){return chunkESI4BSBF_js.f}});Object.defineProperty(exports,"executeCommand",{enumerable:true,get:function(){return chunkTE2AF7FM_js.a}});Object.defineProperty(exports,"executeCommands",{enumerable:true,get:function(){return chunkTE2AF7FM_js.b}});Object.defineProperty(exports,"createDocx",{enumerable:true,get:function(){return chunkSZIOF5SG_js.s}});Object.defineProperty(exports,"repackDocx",{enumerable:true,get:function(){return chunkSZIOF5SG_js.h}});Object.defineProperty(exports,"updateMultipleFiles",{enumerable:true,get:function(){return chunkSZIOF5SG_js.l}});Object.defineProperty(exports,"serializeDocumentBody",{enumerable:true,get:function(){return chunkL72YAV5N_js.f}});Object.defineProperty(exports,"serializeDocx",{enumerable:true,get:function(){return chunkL72YAV5N_js.g}});Object.defineProperty(exports,"serializeSectionProperties",{enumerable:true,get:function(){return chunkL72YAV5N_js.e}});Object.defineProperty(exports,"PluginRegistry",{enumerable:true,get:function(){return chunk4BFNWPKW_js.a}});Object.defineProperty(exports,"createPluginRegistrar",{enumerable:true,get:function(){return chunk4BFNWPKW_js.d}});Object.defineProperty(exports,"pluginRegistry",{enumerable:true,get:function(){return chunk4BFNWPKW_js.b}});Object.defineProperty(exports,"registerPlugins",{enumerable:true,get:function(){return chunk4BFNWPKW_js.c}});Object.defineProperty(exports,"parseDocx",{enumerable:true,get:function(){return chunkQYF7BRG3_js.f}});Object.defineProperty(exports,"ContentControlBoundError",{enumerable:true,get:function(){return chunkFO6IX2DB_js.C}});Object.defineProperty(exports,"ContentControlLockedError",{enumerable:true,get:function(){return chunkFO6IX2DB_js.A}});Object.defineProperty(exports,"ContentControlNotFoundError",{enumerable:true,get:function(){return chunkFO6IX2DB_js.z}});Object.defineProperty(exports,"ContentControlTypeError",{enumerable:true,get:function(){return chunkFO6IX2DB_js.B}});Object.defineProperty(exports,"ContentControlValueError",{enumerable:true,get:function(){return chunkFO6IX2DB_js.K}});Object.defineProperty(exports,"RepeatingSectionError",{enumerable:true,get:function(){return chunkFO6IX2DB_js.R}});Object.defineProperty(exports,"addRepeatingSectionItem",{enumerable:true,get:function(){return chunkFO6IX2DB_js.T}});Object.defineProperty(exports,"countCharacters",{enumerable:true,get:function(){return chunkFO6IX2DB_js.g}});Object.defineProperty(exports,"countWords",{enumerable:true,get:function(){return chunkFO6IX2DB_js.f}});Object.defineProperty(exports,"findContentControl",{enumerable:true,get:function(){return chunkFO6IX2DB_js.y}});Object.defineProperty(exports,"findContentControls",{enumerable:true,get:function(){return chunkFO6IX2DB_js.x}});Object.defineProperty(exports,"formatSdtDate",{enumerable:true,get:function(){return chunkFO6IX2DB_js.L}});Object.defineProperty(exports,"getBlockIndexForParagraph",{enumerable:true,get:function(){return chunkFO6IX2DB_js.v}});Object.defineProperty(exports,"getBodyCharacterCount",{enumerable:true,get:function(){return chunkFO6IX2DB_js.i}});Object.defineProperty(exports,"getBodyText",{enumerable:true,get:function(){return chunkFO6IX2DB_js.e}});Object.defineProperty(exports,"getBodyWordCount",{enumerable:true,get:function(){return chunkFO6IX2DB_js.h}});Object.defineProperty(exports,"getContentControlText",{enumerable:true,get:function(){return chunkFO6IX2DB_js.w}});Object.defineProperty(exports,"getFormattingAtPosition",{enumerable:true,get:function(){return chunkFO6IX2DB_js.l}});Object.defineProperty(exports,"getHyperlinkAtPosition",{enumerable:true,get:function(){return chunkFO6IX2DB_js.n}});Object.defineProperty(exports,"getHyperlinkText",{enumerable:true,get:function(){return chunkFO6IX2DB_js.c}});Object.defineProperty(exports,"getParagraphAtIndex",{enumerable:true,get:function(){return chunkFO6IX2DB_js.u}});Object.defineProperty(exports,"getParagraphText",{enumerable:true,get:function(){return chunkFO6IX2DB_js.a}});Object.defineProperty(exports,"getParagraphs",{enumerable:true,get:function(){return chunkFO6IX2DB_js.t}});Object.defineProperty(exports,"getRunText",{enumerable:true,get:function(){return chunkFO6IX2DB_js.b}});Object.defineProperty(exports,"getTableText",{enumerable:true,get:function(){return chunkFO6IX2DB_js.d}});Object.defineProperty(exports,"getTextAfter",{enumerable:true,get:function(){return chunkFO6IX2DB_js.k}});Object.defineProperty(exports,"getTextBefore",{enumerable:true,get:function(){return chunkFO6IX2DB_js.j}});Object.defineProperty(exports,"hasHyperlinks",{enumerable:true,get:function(){return chunkFO6IX2DB_js.r}});Object.defineProperty(exports,"hasImages",{enumerable:true,get:function(){return chunkFO6IX2DB_js.q}});Object.defineProperty(exports,"hasTables",{enumerable:true,get:function(){return chunkFO6IX2DB_js.s}});Object.defineProperty(exports,"isHeadingStyle",{enumerable:true,get:function(){return chunkFO6IX2DB_js.o}});Object.defineProperty(exports,"isPositionInHyperlink",{enumerable:true,get:function(){return chunkFO6IX2DB_js.m}});Object.defineProperty(exports,"isRepeatingSection",{enumerable:true,get:function(){return chunkFO6IX2DB_js.P}});Object.defineProperty(exports,"isRepeatingSectionItem",{enumerable:true,get:function(){return chunkFO6IX2DB_js.Q}});Object.defineProperty(exports,"parseHeadingLevel",{enumerable:true,get:function(){return chunkFO6IX2DB_js.p}});Object.defineProperty(exports,"removeContentControl",{enumerable:true,get:function(){return chunkFO6IX2DB_js.J}});Object.defineProperty(exports,"removeRepeatingSectionItem",{enumerable:true,get:function(){return chunkFO6IX2DB_js.U}});Object.defineProperty(exports,"setContentControlContent",{enumerable:true,get:function(){return chunkFO6IX2DB_js.I}});Object.defineProperty(exports,"setContentControlValue",{enumerable:true,get:function(){return chunkFO6IX2DB_js.N}});Object.defineProperty(exports,"blendColors",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.m}});Object.defineProperty(exports,"colorsEqual",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.r}});Object.defineProperty(exports,"createRgbColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.j}});Object.defineProperty(exports,"createThemeColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.i}});Object.defineProperty(exports,"darkenColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.k}});Object.defineProperty(exports,"getContrastingColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.g}});Object.defineProperty(exports,"isBlack",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.e}});Object.defineProperty(exports,"isWhite",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.f}});Object.defineProperty(exports,"lightenColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.l}});Object.defineProperty(exports,"parseColorString",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.h}});Object.defineProperty(exports,"resolveColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.a}});Object.defineProperty(exports,"resolveHighlightColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.c}});Object.defineProperty(exports,"resolveShadingColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.d}});Object.defineProperty(exports,"emuToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.e}});Object.defineProperty(exports,"emuToTwips",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.g}});Object.defineProperty(exports,"formatPx",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.p}});Object.defineProperty(exports,"halfPointsToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.j}});Object.defineProperty(exports,"pixelsToEmu",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.f}});Object.defineProperty(exports,"pixelsToTwips",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.d}});Object.defineProperty(exports,"pointsToHalfPoints",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.l}});Object.defineProperty(exports,"pointsToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.i}});Object.defineProperty(exports,"twipsToEmu",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.h}});Object.defineProperty(exports,"twipsToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.c}});exports.VERSION=Ct;
+'use strict';var chunkQEACB5VG_js=require('./chunk-QEACB5VG.js'),chunkXXU7YQVV_js=require('./chunk-XXU7YQVV.js'),chunk2SGJZYQF_js=require('./chunk-2SGJZYQF.js'),chunkCZSAC65M_js=require('./chunk-CZSAC65M.js'),chunkNXLJVVVE_js=require('./chunk-NXLJVVVE.js'),chunk3QPKTG2Y_js=require('./chunk-3QPKTG2Y.js'),chunkU4UCHBZ7_js=require('./chunk-U4UCHBZ7.js'),chunkESI4BSBF_js=require('./chunk-ESI4BSBF.js'),chunkTE2AF7FM_js=require('./chunk-TE2AF7FM.js'),chunkBH3ACQ3M_js=require('./chunk-BH3ACQ3M.js'),chunkNAFMAKLK_js=require('./chunk-NAFMAKLK.js'),chunk4BFNWPKW_js=require('./chunk-4BFNWPKW.js'),chunkOTHV7YV2_js=require('./chunk-OTHV7YV2.js');require('./chunk-LERLET2D.js'),require('./chunk-FIGLFSNR.js'),require('./chunk-MNOHUTKE.js');var chunkFO6IX2DB_js=require('./chunk-FO6IX2DB.js'),chunkRQVHKDXK_js=require('./chunk-RQVHKDXK.js');require('./chunk-SCK6ZM5V.js'),require('./chunk-Z3LGMBJC.js'),require('./chunk-3R7QHNI5.js');var chunkMJ5FQX7Q_js=require('./chunk-MJ5FQX7Q.js');require('./chunk-C2BAPYGJ.js');var chunk4Q2IP5FW_js=require('./chunk-4Q2IP5FW.js');require('./chunk-GSKMHXHG.js'),require('./chunk-DC7S76ZX.js');var xt="0.0.2";Object.defineProperty(exports,"mapHexToHighlightName",{enumerable:true,get:function(){return chunkQEACB5VG_js.b}});Object.defineProperty(exports,"DEFAULT_AI_ACTIONS",{enumerable:true,get:function(){return chunkXXU7YQVV_js.g}});Object.defineProperty(exports,"comparePositions",{enumerable:true,get:function(){return chunkXXU7YQVV_js.d}});Object.defineProperty(exports,"createCollapsedRange",{enumerable:true,get:function(){return chunkXXU7YQVV_js.a}});Object.defineProperty(exports,"createCommand",{enumerable:true,get:function(){return chunkXXU7YQVV_js.h}});Object.defineProperty(exports,"createRange",{enumerable:true,get:function(){return chunkXXU7YQVV_js.b}});Object.defineProperty(exports,"getActionDescription",{enumerable:true,get:function(){return chunkXXU7YQVV_js.f}});Object.defineProperty(exports,"getActionLabel",{enumerable:true,get:function(){return chunkXXU7YQVV_js.e}});Object.defineProperty(exports,"isPositionInRange",{enumerable:true,get:function(){return chunkXXU7YQVV_js.c}});Object.defineProperty(exports,"DocumentAgent",{enumerable:true,get:function(){return chunk2SGJZYQF_js.a}});Object.defineProperty(exports,"buildExtendedSelectionContext",{enumerable:true,get:function(){return chunk2SGJZYQF_js.h}});Object.defineProperty(exports,"buildSelectionContext",{enumerable:true,get:function(){return chunk2SGJZYQF_js.g}});Object.defineProperty(exports,"buildSelectionContextFromContext",{enumerable:true,get:function(){return chunk2SGJZYQF_js.e}});Object.defineProperty(exports,"createAgent",{enumerable:true,get:function(){return chunk2SGJZYQF_js.b}});Object.defineProperty(exports,"createAgentFromDocument",{enumerable:true,get:function(){return chunk2SGJZYQF_js.c}});Object.defineProperty(exports,"getAgentContext",{enumerable:true,get:function(){return chunk2SGJZYQF_js.d}});Object.defineProperty(exports,"getDocumentSummary",{enumerable:true,get:function(){return chunk2SGJZYQF_js.f}});Object.defineProperty(exports,"getSelectionFormattingSummary",{enumerable:true,get:function(){return chunk2SGJZYQF_js.i}});Object.defineProperty(exports,"attemptSelectiveSave",{enumerable:true,get:function(){return chunkCZSAC65M_js.c}});Object.defineProperty(exports,"buildPatchedDocumentXml",{enumerable:true,get:function(){return chunkCZSAC65M_js.b}});Object.defineProperty(exports,"validatePatchSafety",{enumerable:true,get:function(){return chunkCZSAC65M_js.a}});Object.defineProperty(exports,"createDocumentWithText",{enumerable:true,get:function(){return chunkNXLJVVVE_js.b}});Object.defineProperty(exports,"createEmptyDocument",{enumerable:true,get:function(){return chunkNXLJVVVE_js.a}});Object.defineProperty(exports,"isZodSchema",{enumerable:true,get:function(){return chunk3QPKTG2Y_js.a}});Object.defineProperty(exports,"detectVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.a}});Object.defineProperty(exports,"detectVariablesDetailed",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.b}});Object.defineProperty(exports,"detectVariablesInBody",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.c}});Object.defineProperty(exports,"detectVariablesInParagraph",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.d}});Object.defineProperty(exports,"documentHasVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.m}});Object.defineProperty(exports,"extractVariablesFromText",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.e}});Object.defineProperty(exports,"formatVariable",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.i}});Object.defineProperty(exports,"hasTemplateVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.f}});Object.defineProperty(exports,"isValidVariableName",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.g}});Object.defineProperty(exports,"parseVariable",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.j}});Object.defineProperty(exports,"removeVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.l}});Object.defineProperty(exports,"replaceVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.k}});Object.defineProperty(exports,"sanitizeVariableName",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.h}});Object.defineProperty(exports,"createTemplateProcessor",{enumerable:true,get:function(){return chunkESI4BSBF_js.j}});Object.defineProperty(exports,"getMissingVariables",{enumerable:true,get:function(){return chunkESI4BSBF_js.g}});Object.defineProperty(exports,"getTemplateTags",{enumerable:true,get:function(){return chunkESI4BSBF_js.e}});Object.defineProperty(exports,"previewTemplate",{enumerable:true,get:function(){return chunkESI4BSBF_js.h}});Object.defineProperty(exports,"processTemplate",{enumerable:true,get:function(){return chunkESI4BSBF_js.a}});Object.defineProperty(exports,"processTemplateAdvanced",{enumerable:true,get:function(){return chunkESI4BSBF_js.i}});Object.defineProperty(exports,"processTemplateAsBlob",{enumerable:true,get:function(){return chunkESI4BSBF_js.c}});Object.defineProperty(exports,"processTemplateDetailed",{enumerable:true,get:function(){return chunkESI4BSBF_js.b}});Object.defineProperty(exports,"validateTemplate",{enumerable:true,get:function(){return chunkESI4BSBF_js.f}});Object.defineProperty(exports,"executeCommand",{enumerable:true,get:function(){return chunkTE2AF7FM_js.a}});Object.defineProperty(exports,"executeCommands",{enumerable:true,get:function(){return chunkTE2AF7FM_js.b}});Object.defineProperty(exports,"createDocx",{enumerable:true,get:function(){return chunkBH3ACQ3M_js.t}});Object.defineProperty(exports,"repackDocx",{enumerable:true,get:function(){return chunkBH3ACQ3M_js.i}});Object.defineProperty(exports,"updateMultipleFiles",{enumerable:true,get:function(){return chunkBH3ACQ3M_js.m}});Object.defineProperty(exports,"serializeDocumentBody",{enumerable:true,get:function(){return chunkNAFMAKLK_js.g}});Object.defineProperty(exports,"serializeDocx",{enumerable:true,get:function(){return chunkNAFMAKLK_js.h}});Object.defineProperty(exports,"serializeSectionProperties",{enumerable:true,get:function(){return chunkNAFMAKLK_js.c}});Object.defineProperty(exports,"PluginRegistry",{enumerable:true,get:function(){return chunk4BFNWPKW_js.a}});Object.defineProperty(exports,"createPluginRegistrar",{enumerable:true,get:function(){return chunk4BFNWPKW_js.d}});Object.defineProperty(exports,"pluginRegistry",{enumerable:true,get:function(){return chunk4BFNWPKW_js.b}});Object.defineProperty(exports,"registerPlugins",{enumerable:true,get:function(){return chunk4BFNWPKW_js.c}});Object.defineProperty(exports,"parseDocx",{enumerable:true,get:function(){return chunkOTHV7YV2_js.f}});Object.defineProperty(exports,"ContentControlBoundError",{enumerable:true,get:function(){return chunkFO6IX2DB_js.C}});Object.defineProperty(exports,"ContentControlLockedError",{enumerable:true,get:function(){return chunkFO6IX2DB_js.A}});Object.defineProperty(exports,"ContentControlNotFoundError",{enumerable:true,get:function(){return chunkFO6IX2DB_js.z}});Object.defineProperty(exports,"ContentControlTypeError",{enumerable:true,get:function(){return chunkFO6IX2DB_js.B}});Object.defineProperty(exports,"ContentControlValueError",{enumerable:true,get:function(){return chunkFO6IX2DB_js.K}});Object.defineProperty(exports,"RepeatingSectionError",{enumerable:true,get:function(){return chunkFO6IX2DB_js.R}});Object.defineProperty(exports,"addRepeatingSectionItem",{enumerable:true,get:function(){return chunkFO6IX2DB_js.T}});Object.defineProperty(exports,"countCharacters",{enumerable:true,get:function(){return chunkFO6IX2DB_js.g}});Object.defineProperty(exports,"countWords",{enumerable:true,get:function(){return chunkFO6IX2DB_js.f}});Object.defineProperty(exports,"findContentControl",{enumerable:true,get:function(){return chunkFO6IX2DB_js.y}});Object.defineProperty(exports,"findContentControls",{enumerable:true,get:function(){return chunkFO6IX2DB_js.x}});Object.defineProperty(exports,"formatSdtDate",{enumerable:true,get:function(){return chunkFO6IX2DB_js.L}});Object.defineProperty(exports,"getBlockIndexForParagraph",{enumerable:true,get:function(){return chunkFO6IX2DB_js.v}});Object.defineProperty(exports,"getBodyCharacterCount",{enumerable:true,get:function(){return chunkFO6IX2DB_js.i}});Object.defineProperty(exports,"getBodyText",{enumerable:true,get:function(){return chunkFO6IX2DB_js.e}});Object.defineProperty(exports,"getBodyWordCount",{enumerable:true,get:function(){return chunkFO6IX2DB_js.h}});Object.defineProperty(exports,"getContentControlText",{enumerable:true,get:function(){return chunkFO6IX2DB_js.w}});Object.defineProperty(exports,"getFormattingAtPosition",{enumerable:true,get:function(){return chunkFO6IX2DB_js.l}});Object.defineProperty(exports,"getHyperlinkAtPosition",{enumerable:true,get:function(){return chunkFO6IX2DB_js.n}});Object.defineProperty(exports,"getHyperlinkText",{enumerable:true,get:function(){return chunkFO6IX2DB_js.c}});Object.defineProperty(exports,"getParagraphAtIndex",{enumerable:true,get:function(){return chunkFO6IX2DB_js.u}});Object.defineProperty(exports,"getParagraphText",{enumerable:true,get:function(){return chunkFO6IX2DB_js.a}});Object.defineProperty(exports,"getParagraphs",{enumerable:true,get:function(){return chunkFO6IX2DB_js.t}});Object.defineProperty(exports,"getRunText",{enumerable:true,get:function(){return chunkFO6IX2DB_js.b}});Object.defineProperty(exports,"getTableText",{enumerable:true,get:function(){return chunkFO6IX2DB_js.d}});Object.defineProperty(exports,"getTextAfter",{enumerable:true,get:function(){return chunkFO6IX2DB_js.k}});Object.defineProperty(exports,"getTextBefore",{enumerable:true,get:function(){return chunkFO6IX2DB_js.j}});Object.defineProperty(exports,"hasHyperlinks",{enumerable:true,get:function(){return chunkFO6IX2DB_js.r}});Object.defineProperty(exports,"hasImages",{enumerable:true,get:function(){return chunkFO6IX2DB_js.q}});Object.defineProperty(exports,"hasTables",{enumerable:true,get:function(){return chunkFO6IX2DB_js.s}});Object.defineProperty(exports,"isHeadingStyle",{enumerable:true,get:function(){return chunkFO6IX2DB_js.o}});Object.defineProperty(exports,"isPositionInHyperlink",{enumerable:true,get:function(){return chunkFO6IX2DB_js.m}});Object.defineProperty(exports,"isRepeatingSection",{enumerable:true,get:function(){return chunkFO6IX2DB_js.P}});Object.defineProperty(exports,"isRepeatingSectionItem",{enumerable:true,get:function(){return chunkFO6IX2DB_js.Q}});Object.defineProperty(exports,"parseHeadingLevel",{enumerable:true,get:function(){return chunkFO6IX2DB_js.p}});Object.defineProperty(exports,"removeContentControl",{enumerable:true,get:function(){return chunkFO6IX2DB_js.J}});Object.defineProperty(exports,"removeRepeatingSectionItem",{enumerable:true,get:function(){return chunkFO6IX2DB_js.U}});Object.defineProperty(exports,"setContentControlContent",{enumerable:true,get:function(){return chunkFO6IX2DB_js.I}});Object.defineProperty(exports,"setContentControlValue",{enumerable:true,get:function(){return chunkFO6IX2DB_js.N}});Object.defineProperty(exports,"getDocumentWatermark",{enumerable:true,get:function(){return chunkRQVHKDXK_js.a}});Object.defineProperty(exports,"setDocumentWatermark",{enumerable:true,get:function(){return chunkRQVHKDXK_js.b}});Object.defineProperty(exports,"blendColors",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.m}});Object.defineProperty(exports,"colorsEqual",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.r}});Object.defineProperty(exports,"createRgbColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.j}});Object.defineProperty(exports,"createThemeColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.i}});Object.defineProperty(exports,"darkenColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.k}});Object.defineProperty(exports,"getContrastingColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.g}});Object.defineProperty(exports,"isBlack",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.e}});Object.defineProperty(exports,"isWhite",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.f}});Object.defineProperty(exports,"lightenColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.l}});Object.defineProperty(exports,"parseColorString",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.h}});Object.defineProperty(exports,"resolveColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.a}});Object.defineProperty(exports,"resolveHighlightColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.c}});Object.defineProperty(exports,"resolveShadingColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.d}});Object.defineProperty(exports,"emuToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.e}});Object.defineProperty(exports,"emuToTwips",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.g}});Object.defineProperty(exports,"formatPx",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.p}});Object.defineProperty(exports,"halfPointsToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.j}});Object.defineProperty(exports,"pixelsToEmu",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.f}});Object.defineProperty(exports,"pixelsToTwips",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.d}});Object.defineProperty(exports,"pointsToHalfPoints",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.l}});Object.defineProperty(exports,"pointsToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.i}});Object.defineProperty(exports,"twipsToEmu",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.h}});Object.defineProperty(exports,"twipsToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.c}});exports.VERSION=xt;

package/dist/headless.mjs

@@ -1 +1 @@
-export{b as mapHexToHighlightName}from'./chunk-XPV6VILW.mjs';export{g as DEFAULT_AI_ACTIONS,d as comparePositions,a as createCollapsedRange,h as createCommand,b as createRange,f as getActionDescription,e as getActionLabel,c as isPositionInRange}from'./chunk-MVZOTKNL.mjs';export{a as DocumentAgent,h as buildExtendedSelectionContext,g as buildSelectionContext,e as buildSelectionContextFromContext,b as createAgent,c as createAgentFromDocument,d as getAgentContext,f as getDocumentSummary,i as getSelectionFormattingSummary}from'./chunk-QKLY4F2J.mjs';export{c as attemptSelectiveSave,b as buildPatchedDocumentXml,a as validatePatchSafety}from'./chunk-KRN6YSR2.mjs';export{b as createDocumentWithText,a as createEmptyDocument}from'./chunk-CKKO4JWE.mjs';export{a as isZodSchema}from'./chunk-7BVHKWEW.mjs';export{a as detectVariables,b as detectVariablesDetailed,c as detectVariablesInBody,d as detectVariablesInParagraph,m as documentHasVariables,e as extractVariablesFromText,i as formatVariable,f as hasTemplateVariables,g as isValidVariableName,j as parseVariable,l as removeVariables,k as replaceVariables,h as sanitizeVariableName}from'./chunk-ARHPXIBJ.mjs';export{j as createTemplateProcessor,g as getMissingVariables,e as getTemplateTags,h as previewTemplate,a as processTemplate,i as processTemplateAdvanced,c as processTemplateAsBlob,b as processTemplateDetailed,f as validateTemplate}from'./chunk-CGJ6S3AH.mjs';export{a as executeCommand,b as executeCommands}from'./chunk-CUY2THAO.mjs';export{s as createDocx,h as repackDocx,l as updateMultipleFiles}from'./chunk-MERJFGEP.mjs';export{f as serializeDocumentBody,g as serializeDocx,e as serializeSectionProperties}from'./chunk-WLDI6N3B.mjs';export{a as PluginRegistry,d as createPluginRegistrar,b as pluginRegistry,c as registerPlugins}from'./chunk-3NRMSZX2.mjs';export{f as parseDocx}from'./chunk-44JKHPGF.mjs';import'./chunk-7ZN4WI5N.mjs';import'./chunk-BOOHU5EW.mjs';import'./chunk-7LRR7RKE.mjs';export{C as ContentControlBoundError,A as ContentControlLockedError,z as ContentControlNotFoundError,B as ContentControlTypeError,K as ContentControlValueError,R as RepeatingSectionError,T as addRepeatingSectionItem,g as countCharacters,f as countWords,y as findContentControl,x as findContentControls,L as formatSdtDate,v as getBlockIndexForParagraph,i as getBodyCharacterCount,e as getBodyText,h as getBodyWordCount,w as getContentControlText,l as getFormattingAtPosition,n as getHyperlinkAtPosition,c as getHyperlinkText,u as getParagraphAtIndex,a as getParagraphText,t as getParagraphs,b as getRunText,d as getTableText,k as getTextAfter,j as getTextBefore,r as hasHyperlinks,q as hasImages,s as hasTables,o as isHeadingStyle,m as isPositionInHyperlink,P as isRepeatingSection,Q as isRepeatingSectionItem,p as parseHeadingLevel,J as removeContentControl,U as removeRepeatingSectionItem,I as setContentControlContent,N as setContentControlValue}from'./chunk-KOEWROYV.mjs';import'./chunk-6ZXL3EIP.mjs';import'./chunk-OEXVWIHW.mjs';import'./chunk-WLHNIXWC.mjs';export{m as blendColors,r as colorsEqual,j as createRgbColor,i as createThemeColor,k as darkenColor,g as getContrastingColor,e as isBlack,f as isWhite,l as lightenColor,h as parseColorString,a as resolveColor,c as resolveHighlightColor,d as resolveShadingColor}from'./chunk-67LVRQIR.mjs';import'./chunk-LE67NTCN.mjs';export{e as emuToPixels,g as emuToTwips,p as formatPx,j as halfPointsToPixels,f as pixelsToEmu,d as pixelsToTwips,l as pointsToHalfPoints,i as pointsToPixels,h as twipsToEmu,c as twipsToPixels}from'./chunk-VW22RZ6C.mjs';import'./chunk-DI6CRWSW.mjs';import'./chunk-QYUPLKLP.mjs';var Ct="0.0.2";export{Ct as VERSION};
+export{b as mapHexToHighlightName}from'./chunk-XPV6VILW.mjs';export{g as DEFAULT_AI_ACTIONS,d as comparePositions,a as createCollapsedRange,h as createCommand,b as createRange,f as getActionDescription,e as getActionLabel,c as isPositionInRange}from'./chunk-MVZOTKNL.mjs';export{a as DocumentAgent,h as buildExtendedSelectionContext,g as buildSelectionContext,e as buildSelectionContextFromContext,b as createAgent,c as createAgentFromDocument,d as getAgentContext,f as getDocumentSummary,i as getSelectionFormattingSummary}from'./chunk-YNUPP7UG.mjs';export{c as attemptSelectiveSave,b as buildPatchedDocumentXml,a as validatePatchSafety}from'./chunk-FYRJTDC4.mjs';export{b as createDocumentWithText,a as createEmptyDocument}from'./chunk-CKKO4JWE.mjs';export{a as isZodSchema}from'./chunk-DFUWJHKF.mjs';export{a as detectVariables,b as detectVariablesDetailed,c as detectVariablesInBody,d as detectVariablesInParagraph,m as documentHasVariables,e as extractVariablesFromText,i as formatVariable,f as hasTemplateVariables,g as isValidVariableName,j as parseVariable,l as removeVariables,k as replaceVariables,h as sanitizeVariableName}from'./chunk-ARHPXIBJ.mjs';export{j as createTemplateProcessor,g as getMissingVariables,e as getTemplateTags,h as previewTemplate,a as processTemplate,i as processTemplateAdvanced,c as processTemplateAsBlob,b as processTemplateDetailed,f as validateTemplate}from'./chunk-CGJ6S3AH.mjs';export{a as executeCommand,b as executeCommands}from'./chunk-CUY2THAO.mjs';export{t as createDocx,i as repackDocx,m as updateMultipleFiles}from'./chunk-CHN26LLL.mjs';export{g as serializeDocumentBody,h as serializeDocx,c as serializeSectionProperties}from'./chunk-WWNOXNEX.mjs';export{a as PluginRegistry,d as createPluginRegistrar,b as pluginRegistry,c as registerPlugins}from'./chunk-3NRMSZX2.mjs';export{f as parseDocx}from'./chunk-UE2ZKRYB.mjs';import'./chunk-3G44SFHX.mjs';import'./chunk-MOCGHQ4A.mjs';import'./chunk-7LRR7RKE.mjs';export{C as ContentControlBoundError,A as ContentControlLockedError,z as ContentControlNotFoundError,B as ContentControlTypeError,K as ContentControlValueError,R as RepeatingSectionError,T as addRepeatingSectionItem,g as countCharacters,f as countWords,y as findContentControl,x as findContentControls,L as formatSdtDate,v as getBlockIndexForParagraph,i as getBodyCharacterCount,e as getBodyText,h as getBodyWordCount,w as getContentControlText,l as getFormattingAtPosition,n as getHyperlinkAtPosition,c as getHyperlinkText,u as getParagraphAtIndex,a as getParagraphText,t as getParagraphs,b as getRunText,d as getTableText,k as getTextAfter,j as getTextBefore,r as hasHyperlinks,q as hasImages,s as hasTables,o as isHeadingStyle,m as isPositionInHyperlink,P as isRepeatingSection,Q as isRepeatingSectionItem,p as parseHeadingLevel,J as removeContentControl,U as removeRepeatingSectionItem,I as setContentControlContent,N as setContentControlValue}from'./chunk-KOEWROYV.mjs';export{a as getDocumentWatermark,b as setDocumentWatermark}from'./chunk-GYWTUUXX.mjs';import'./chunk-7CZEZ3UL.mjs';import'./chunk-W77JXDEV.mjs';import'./chunk-3ANZ3252.mjs';export{m as blendColors,r as colorsEqual,j as createRgbColor,i as createThemeColor,k as darkenColor,g as getContrastingColor,e as isBlack,f as isWhite,l as lightenColor,h as parseColorString,a as resolveColor,c as resolveHighlightColor,d as resolveShadingColor}from'./chunk-67LVRQIR.mjs';import'./chunk-LE67NTCN.mjs';export{e as emuToPixels,g as emuToTwips,p as formatPx,j as halfPointsToPixels,f as pixelsToEmu,d as pixelsToTwips,l as pointsToHalfPoints,i as pointsToPixels,h as twipsToEmu,c as twipsToPixels}from'./chunk-VW22RZ6C.mjs';import'./chunk-DI6CRWSW.mjs';import'./chunk-QYUPLKLP.mjs';var xt="0.0.2";export{xt as VERSION};

package/dist/layout-bridge/clickToPositionDom.d.mts

@@ -36,6 +36,31 @@ interface DomSelectionRect {
     height: number;
     pageIndex: number;
 }
+/**
+ * Vertically clip a client rect to the enclosing page-fragment table's visible
+ * box. A table that breaks across a page sits in a `.layout-table` with
+ * `overflow:hidden` and `height = visibleHeight`; getClientRects() still reports
+ * the geometry of lines that are visually clipped (off the page / in the
+ * inter-page gap), so selection highlights must be clipped to the same box.
+ *
+ * Uses `.layout-table:not(.layout-nested-table)` because only the page-fragment
+ * table carries the window clip — the inner nested table has no overflow:hidden.
+ * Clips vertically only (the gap bug is vertical; horizontal clipping could trim
+ * change bars on tracked-change tables that set overflow-x: visible).
+ *
+ * Returns null when the rect is fully outside the window.
+ */
+declare function clipRectToTableWindow(spanEl: Element, rect: {
+    readonly left: number;
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+}): {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+} | null;
 declare function getSelectionRectsFromDom(container: HTMLElement, from: number, to: number, overlayRect: DOMRect): DomSelectionRect[];
 /**
  * Get caret position from DOM for a PM position.
@@ -53,4 +78,4 @@ interface DomCaretPosition {
 }
 declare function getCaretPositionFromDom(container: HTMLElement, pmPos: number, overlayRect: DOMRect): DomCaretPosition | null;
 
-export { type DomCaretPosition, type DomSelectionRect, clickToPositionDom, getCaretPositionFromDom, getSelectionRectsFromDom };
+export { type DomCaretPosition, type DomSelectionRect, clickToPositionDom, clipRectToTableWindow, getCaretPositionFromDom, getSelectionRectsFromDom };

package/dist/layout-bridge/clickToPositionDom.d.ts

@@ -36,6 +36,31 @@ interface DomSelectionRect {
     height: number;
     pageIndex: number;
 }
+/**
+ * Vertically clip a client rect to the enclosing page-fragment table's visible
+ * box. A table that breaks across a page sits in a `.layout-table` with
+ * `overflow:hidden` and `height = visibleHeight`; getClientRects() still reports
+ * the geometry of lines that are visually clipped (off the page / in the
+ * inter-page gap), so selection highlights must be clipped to the same box.
+ *
+ * Uses `.layout-table:not(.layout-nested-table)` because only the page-fragment
+ * table carries the window clip — the inner nested table has no overflow:hidden.
+ * Clips vertically only (the gap bug is vertical; horizontal clipping could trim
+ * change bars on tracked-change tables that set overflow-x: visible).
+ *
+ * Returns null when the rect is fully outside the window.
+ */
+declare function clipRectToTableWindow(spanEl: Element, rect: {
+    readonly left: number;
+    readonly top: number;
+    readonly right: number;
+    readonly bottom: number;
+}): {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+} | null;
 declare function getSelectionRectsFromDom(container: HTMLElement, from: number, to: number, overlayRect: DOMRect): DomSelectionRect[];
 /**
  * Get caret position from DOM for a PM position.
@@ -53,4 +78,4 @@ interface DomCaretPosition {
 }
 declare function getCaretPositionFromDom(container: HTMLElement, pmPos: number, overlayRect: DOMRect): DomCaretPosition | null;
 
-export { type DomCaretPosition, type DomSelectionRect, clickToPositionDom, getCaretPositionFromDom, getSelectionRectsFromDom };
+export { type DomCaretPosition, type DomSelectionRect, clickToPositionDom, clipRectToTableWindow, getCaretPositionFromDom, getSelectionRectsFromDom };

package/dist/layout-bridge/clickToPositionDom.js

@@ -1 +1 @@
-'use strict';var chunk7RDCZLTU_js=require('../chunk-7RDCZLTU.js');require('../chunk-DC7S76ZX.js');Object.defineProperty(exports,"clickToPositionDom",{enumerable:true,get:function(){return chunk7RDCZLTU_js.e}});Object.defineProperty(exports,"getCaretPositionFromDom",{enumerable:true,get:function(){return chunk7RDCZLTU_js.g}});Object.defineProperty(exports,"getSelectionRectsFromDom",{enumerable:true,get:function(){return chunk7RDCZLTU_js.f}});
+'use strict';var chunk7WGN2OBZ_js=require('../chunk-7WGN2OBZ.js');require('../chunk-DC7S76ZX.js');Object.defineProperty(exports,"clickToPositionDom",{enumerable:true,get:function(){return chunk7WGN2OBZ_js.e}});Object.defineProperty(exports,"clipRectToTableWindow",{enumerable:true,get:function(){return chunk7WGN2OBZ_js.f}});Object.defineProperty(exports,"getCaretPositionFromDom",{enumerable:true,get:function(){return chunk7WGN2OBZ_js.h}});Object.defineProperty(exports,"getSelectionRectsFromDom",{enumerable:true,get:function(){return chunk7WGN2OBZ_js.g}});

package/dist/layout-bridge/clickToPositionDom.mjs

@@ -1 +1 @@
-export{e as clickToPositionDom,g as getCaretPositionFromDom,f as getSelectionRectsFromDom}from'../chunk-YMZ3F2FZ.mjs';import'../chunk-QYUPLKLP.mjs';
+export{e as clickToPositionDom,f as clipRectToTableWindow,h as getCaretPositionFromDom,g as getSelectionRectsFromDom}from'../chunk-MEVZCB56.mjs';import'../chunk-QYUPLKLP.mjs';

package/dist/layout-bridge/index.d.mts

@@ -10,19 +10,21 @@
  */
 export { ToFlowBlocksOptions, convertBorderSpecToLayout, resetBlockIdCounter, resolveListTemplate, toFlowBlocks } from './toFlowBlocks.mjs';
 import { TableBlock, Fragment, FlowBlock, Measure, Page, TableFragment, TableMeasure, ParagraphBlock, ParagraphMeasure, Layout, PageMargins } from '../layout-engine/types.mjs';
-export { FloatingExclusionRect, FloatingImageZone, FloatingLineSegmentZone, FontMetrics, FontStyle, MeasureBlockFn, MeasureParagraphOptions, RunMeasurement, TextMeasurement, buildFontString, clampFloatingWrapMargins, clearAllCaches, clearFontMetricsCache, clearParagraphMeasureCache, clearTextWidthCache, findCharacterAtX, getCachedFontMetrics, getCachedParagraphMeasure, getCachedTextWidth, getCanvasContext, getFloatingMargins, getFontCacheSize, getFontMetrics, getParagraphCacheSize, getRunCharWidths, getTextCacheSize, getTotalCacheSize, getXForCharacter, halfPtToPx, hashParagraphBlock, measureBlocksWithFloats, measureParagraph, measureParagraphs, measureRun, measureText, measureTextWidth, ptToPx, pxToHalfPt, pxToPt, pxToTwips, rectsToFloatingZones, resetCanvasContext, setCachedFontMetrics, setCachedParagraphMeasure, setCachedTextWidth, setFontCacheSize, setParagraphCacheSize, setTextCacheSize, twipsToPx } from './measuring/index.mjs';
-export { DomCaretPosition, DomSelectionRect, clickToPositionDom, getCaretPositionFromDom, getSelectionRectsFromDom, clickToPositionDom as mouseToPosition } from './clickToPositionDom.mjs';
-export { C as ConvertFootnoteOptions, a as ConvertHeaderFooterOptions, F as FOOTNOTE_SEPARATOR_HEIGHT, H as HeaderFooterMetrics, M as MAX_FOOTNOTE_LAYOUT_PASSES, b as MeasureBlocksFn, S as StabilizeFootnoteLayoutArgs, c as StabilizeFootnoteLayoutResult, j as applyFootnotePresentation, d as buildFootnoteContentMap, e as buildFootnoteRenderItems, f as calculateFootnoteReservedHeights, k as calculateHeaderFooterVisualBounds, g as collectFootnoteRefs, l as computeHfCaretRectFromView, n as computeHfSelectionRectsFromView, o as convertFootnoteToContent, p as convertHeaderFooterPmDocToContent, h as convertHeaderFooterToContent, i as footnoteReservedHeightsEqual, q as invalidateHfDomCache, m as mapFootnotesToPages, r as normalizeHeaderFooterMeasureBlocks, t as resolveHeaderFooterVisualTop, s as stabilizeFootnoteLayout } from '../headerFooterLayout-CuIJiIzi.mjs';
+export { FloatPageGeometry, FloatingExclusionRect, FloatingImageZone, FloatingLineSegmentZone, FontMetrics, FontStyle, MeasureBlockFn, MeasureParagraphOptions, RunMeasurement, TextMeasurement, buildFontString, clampFloatingWrapMargins, clearAllCaches, clearFontMetricsCache, clearParagraphMeasureCache, clearTextWidthCache, findCharacterAtX, getCachedFontMetrics, getCachedParagraphMeasure, getCachedTextWidth, getCanvasContext, getFloatingMargins, getFontCacheSize, getFontMetrics, getParagraphCacheSize, getRunCharWidths, getTextCacheSize, getTotalCacheSize, getXForCharacter, halfPtToPx, hashParagraphBlock, measureBlocksWithFloats, measureParagraph, measureParagraphs, measureRun, measureText, measureTextWidth, ptToPx, pxToHalfPt, pxToPt, pxToTwips, rectsToFloatingZones, resetCanvasContext, setCachedFontMetrics, setCachedParagraphMeasure, setCachedTextWidth, setFontCacheSize, setParagraphCacheSize, setTextCacheSize, twipsToPx } from './measuring/index.mjs';
+export { DomCaretPosition, DomSelectionRect, clickToPositionDom, clipRectToTableWindow, getCaretPositionFromDom, getSelectionRectsFromDom, clickToPositionDom as mouseToPosition } from './clickToPositionDom.mjs';
+export { C as ConvertFootnoteOptions, a as ConvertHeaderFooterOptions, F as FOOTNOTE_SEPARATOR_HEIGHT, H as HeaderFooterMetrics, M as MAX_FOOTNOTE_LAYOUT_PASSES, b as MeasureBlocksFn, S as StabilizeFootnoteLayoutArgs, c as StabilizeFootnoteLayoutResult, j as applyFootnotePresentation, d as buildFootnoteContentMap, e as buildFootnoteRenderItems, f as calculateFootnoteReservedHeights, k as calculateHeaderFooterVisualBounds, g as collectFootnoteRefs, l as computeHfCaretRectFromView, n as computeHfSelectionRectsFromView, o as convertFootnoteToContent, p as convertHeaderFooterPmDocToContent, h as convertHeaderFooterToContent, i as footnoteReservedHeightsEqual, q as invalidateHfDomCache, m as mapFootnotesToPages, r as normalizeHeaderFooterMeasureBlocks, t as resolveHeaderFooterVisualTop, s as stabilizeFootnoteLayout } from '../headerFooterLayout-DlJLWmpR.mjs';
 export { TABLE_INSERT_EDGE_PROXIMITY, TABLE_INSERT_HIDE_DELAY_MS, TableInsertHoverHit, TableInsertHoverInput, detectTableInsertHover } from './tableInsertHover.mjs';
 import { Document } from '../types/document.mjs';
-import { S as SectionProperties, y as HeaderFooter } from '../content-CE-ZdMwG.mjs';
+import { S as SectionProperties, y as HeaderFooter } from '../content-3xF4WDE8.mjs';
 import 'prosemirror-model';
-import '../styles-EI2lxeEN.mjs';
+import '../styles-BOJ93SAm.mjs';
 import '../formatting-BH4hcZiq.mjs';
 import '../colors-C3vA7HUU.mjs';
 import '../docx/wrapTypes.mjs';
+import '../watermark-DAcnAs_J.mjs';
+import '../anchoredObjectPosition-KJEyF-wr.mjs';
 import 'prosemirror-view';
-import '../footnotes-lCH_P3N3.mjs';
+import '../footnotes-BtVc6VFl.mjs';
 
 /**
  * @internal Helpers for resolving DOCX table-width metadata into pixel widths.
@@ -35,6 +37,26 @@ import '../footnotes-lCH_P3N3.mjs';
  * @internal
  */
 declare function resolveTableWidthPx(value: number | undefined, widthType: string | undefined, parentWidth: number): number | undefined;
+/** A cell with its resolved grid position (column index honoring spans). */
+interface ResolvedGridCell {
+    rowIndex: number;
+    cellIndex: number;
+    columnIndex: number;
+    colSpan: number;
+    rowSpan: number;
+}
+/**
+ * Resolve every cell's grid column index, accounting for `colSpan` and the
+ * columns occupied by vertically-merged (`rowSpan`) cells from earlier rows.
+ *
+ * Single source of truth for table grid geometry — the measurer, the painter,
+ * and the row-break paginator all consume this so they agree on which column a
+ * cell lives in. Width-free on purpose: callers multiply `columnIndex` by their
+ * own (possibly scaled) column widths to get an x offset.
+ *
+ * @internal
+ */
+declare function resolveCellGrid(tableBlock: TableBlock): ResolvedGridCell[];
 /** Total grid columns, derived from the widest row's accumulated colSpans. */
 declare function countTableColumns(tableBlock: TableBlock): number;
 /**
@@ -459,4 +481,4 @@ declare function resolveHeaderFooter(doc: Document | null, sp: SectionProperties
     firstFooter: HeaderFooter | null;
 };
 
-export { type CaretPosition, DEFAULT_BODY_MARGIN_PX, DEFAULT_HF_DISTANCE_PX, DEFAULT_PAGE_HEIGHT_PX, DEFAULT_PAGE_WIDTH_PX, type FragmentHit, type HitTestResult, type PageHit, type Point, type PositionResult, type SelectionRect, type TableCellHit, clickToPosition, clickToPositionInParagraph, clickToPositionInTableCell, countTableColumns, findBodyEmptyRuns, findBodyPmAnchor, findBodyPmAnchors, findBodyPmSpans, getCaretPosition, getMargins, getPageBounds, getPageIndexAtY, getPageSize, getPageTop, getPositionRect, getScrollYForPage, getTotalDocumentHeight, groupRectsByPage, hitTest, hitTestFragment, hitTestImageFragment, hitTestPage, hitTestTableCell, isMultiPageSelection, measureTableBlock, measureTableCellBlockVisualHeight, normalizeTableColumnWidths, positionToX, resolveHeaderFooter, resolveTableWidthPx, selectionToRects };
+export { type CaretPosition, DEFAULT_BODY_MARGIN_PX, DEFAULT_HF_DISTANCE_PX, DEFAULT_PAGE_HEIGHT_PX, DEFAULT_PAGE_WIDTH_PX, type FragmentHit, type HitTestResult, type PageHit, type Point, type PositionResult, type ResolvedGridCell, type SelectionRect, type TableCellHit, clickToPosition, clickToPositionInParagraph, clickToPositionInTableCell, countTableColumns, findBodyEmptyRuns, findBodyPmAnchor, findBodyPmAnchors, findBodyPmSpans, getCaretPosition, getMargins, getPageBounds, getPageIndexAtY, getPageSize, getPageTop, getPositionRect, getScrollYForPage, getTotalDocumentHeight, groupRectsByPage, hitTest, hitTestFragment, hitTestImageFragment, hitTestPage, hitTestTableCell, isMultiPageSelection, measureTableBlock, measureTableCellBlockVisualHeight, normalizeTableColumnWidths, positionToX, resolveCellGrid, resolveHeaderFooter, resolveTableWidthPx, selectionToRects };