@betteroffice/docx 0.0.1 → 0.0.3

package/dist/utils/index.d.mts

@@ -1,155 +1,13 @@
-export { TWIPS_PER_INCH, clamp, eighthsToPixels, emuToTwips, formatPx, halfPointsToPixels, halfPointsToPoints, pixelsToTwips, pointsToHalfPoints, roundPixels, twipsToEmu, twipsToPixels } from './units.mjs';
-export { C as CreateEmptyDocumentOptions, P as ProcessTemplateOptions, a as ProcessTemplateResult, T as TemplateError, c as colorsEqual, b as createDocumentWithText, d as createEmptyDocument, e as createRgbColor, f as createTemplateProcessor, g as createThemeColor, t as ensureHexPrefix, h as getMissingVariables, i as getTemplateTags, j as isBlack, k as isWhite, p as parseColorString, l as previewTemplate, m as processTemplate, n as processTemplateAdvanced, w as processTemplateAndDownload, o as processTemplateAsBlob, q as processTemplateDetailed, r as resolveHighlightColor, u as resolveHighlightToCss, s as resolveShadingColor, v as validateTemplate } from '../colorResolver-n0o7H7ep.mjs';
-import { a as Theme, B as BorderSpec, P as ParagraphFormatting, S as ShadingProperties, T as TextFormatting } from '../formatting-DoL7KBSL.mjs';
-export { G as ThemeMatrixCell, b as blendColors, d as darkenColor, H as generateThemeTintShadeMatrix, g as getContrastingColor, I as getThemeTintShadeHex, l as lightenColor, r as resolveColor, J as resolveColorToHex } from '../formatting-DoL7KBSL.mjs';
-import { R as Run, P as Paragraph, C as Comment } from '../content-sSHuWw49.mjs';
+export { PIXELS_PER_INCH, TWIPS_PER_INCH, clamp, eighthsToPixels, emuToPixels, emuToTwips, formatPx, halfPointsToPixels, halfPointsToPoints, pixelsToEmu, pixelsToTwips, pointsToHalfPoints, pointsToPixels, roundPixels, twipsToEmu, twipsToPixels } from './units.mjs';
+export { F as FONT_MAPPING, v as FontDefinition, c as canRenderFont, a as colorsEqual, b as createRgbColor, d as createThemeColor, e as ensureHexPrefix, w as extractFontsFromDocument, x as getGoogleFontEquivalent, g as getLoadedFonts, i as isBlack, f as isFontLoaded, j as isGoogleFontsEnabled, h as isLoading, k as isWhite, y as loadDocumentFonts, l as loadFont, z as loadFontDefinitions, m as loadFontFromBuffer, A as loadFontFromUrl, B as loadFontWithMapping, n as loadFonts, C as loadFontsWithMapping, D as onFontError, o as onFontsLoaded, p as parseColorString, q as preloadCommonFonts, r as resolveHighlightColor, s as resolveHighlightToCss, t as resolveShadingColor, u as setGoogleFontsEnabled } from '../fontLoader-aSewHMKF.mjs';
 export { D as DocxInput, t as toArrayBuffer } from '../docxInput-DTbCa48g.mjs';
-export { F as FONT_MAPPING, B as FontDefinition, I as InsertPosition, c as canRenderFont, a as countPageBreaks, b as createColumnBreak, d as createHorizontalRule, e as createLineBreak, f as createPageBreak, g as createPageBreakParagraph, h as createPageBreakRun, C as extractFontsFromDocument, i as findPageBreaks, D as getGoogleFontEquivalent, j as getLoadedFonts, k as hasPageBreakBefore, l as insertHorizontalRule, m as insertPageBreak, n as isBreakContent, o as isColumnBreak, p as isFontLoaded, r as isGoogleFontsEnabled, s as isLineBreak, q as isLoading, t as isPageBreak, E as loadDocumentFonts, u as loadFont, G as loadFontDefinitions, v as loadFontFromBuffer, H as loadFontFromUrl, J as loadFontWithMapping, w as loadFonts, K as loadFontsWithMapping, L as onFontError, x as onFontsLoaded, y as preloadCommonFonts, z as removePageBreak, A as setGoogleFontsEnabled } from '../fontLoader-Bx6DK6-2.mjs';
-import { F as FontTable } from '../styles-VxNcXLdi.mjs';
+import { F as FontTable } from '../styles-Dn_o3Vo5.mjs';
 import { Document } from '../types/document.mjs';
 import { FontOption } from './fontOptions.mjs';
-export { HeadingInfo, collectHeadings } from './headingCollector.mjs';
-export { WordSelectionResult, createDoubleClickWordSelector, createTripleClickParagraphSelector, expandSelectionToWordBoundaries, findWordAt, findWordBoundaries, getWordAt, handleClickForMultiClick, selectParagraphAtCursor, selectWordAtCursor, selectWordInTextNode } from './textSelection.mjs';
 export { MIN_CARD_GAP, SIDEBAR_DOCUMENT_SHIFT, SIDEBAR_PAGE_GAP, SIDEBAR_WIDTH } from './sidebarConstants.mjs';
-export { P as PIXELS_PER_INCH, e as emuToPixels, p as pixelsToEmu, a as pointsToPixels } from '../units-O5Y02RKQ.mjs';
+import { g as Comment } from '../content-MOZ6hKP4.mjs';
+export { x as ThemeMatrixCell, y as blendColors, z as darkenColor, A as generateThemeTintShadeMatrix, D as getContrastingColor, G as getThemeTintShadeHex, H as lightenColor, I as resolveColor, J as resolveColorToHex } from '../formatting-D1EPSaJP.mjs';
 import '../docx/wrapTypes.mjs';
-import '../settingsParser-CcGvtmCK.mjs';
-import '../editorTree-DO5PyDK8.mjs';
-
-/**
- * Clipboard utilities for copy/paste with formatting
- *
- * Handles:
- * - Copy: puts formatted HTML and plain text on clipboard
- * - Paste: reads HTML clipboard, converts to runs with formatting
- * - Handles paste from Word (cleans up Word HTML)
- * - Ctrl+C, Ctrl+V, Ctrl+X keyboard shortcuts
- */
-
-/**
- * Clipboard content format
- */
-interface ClipboardContent {
-    /** Plain text representation */
-    plainText: string;
-    /** HTML representation */
-    html: string;
-    /** Internal format (JSON) for preserving full formatting */
-    internal?: string;
-}
-/**
- * Parsed clipboard content
- */
-interface ParsedClipboardContent {
-    /** Runs parsed from clipboard */
-    runs: Run[];
-    /** Whether content came from Word */
-    fromWord: boolean;
-    /** Whether content came from our editor */
-    fromEditor: boolean;
-    /** Original plain text */
-    plainText: string;
-}
-/**
- * Options for clipboard operations
- */
-interface ClipboardOptions {
-    /** Whether to include formatting in copy */
-    includeFormatting?: boolean;
-    /** Whether to clean Word-specific formatting */
-    cleanWordFormatting?: boolean;
-    /** Callback for handling errors */
-    onError?: (error: Error) => void;
-    /** Document theme — required to resolve themed text/shading colors in HTML. */
-    theme?: Theme | null;
-}
-/**
- * Custom MIME type for internal clipboard format
- */
-declare const INTERNAL_CLIPBOARD_TYPE = "application/x-docx-editor";
-/**
- * Standard clipboard MIME types
- */
-declare const CLIPBOARD_TYPES: {
-    readonly HTML: "text/html";
-    readonly PLAIN: "text/plain";
-};
-/**
- * Extract image files from clipboard data (if present).
- */
-declare function getClipboardImageFiles(clipboardData: DataTransfer | null): File[];
-/**
- * Copy runs to clipboard with formatting
- */
-declare function copyRuns(runs: Run[], options?: ClipboardOptions): Promise<boolean>;
-/**
- * Copy paragraphs to clipboard with formatting
- */
-declare function copyParagraphs(paragraphs: Paragraph[], options?: ClipboardOptions): Promise<boolean>;
-/**
- * Convert runs to clipboard content (HTML and plain text).
- *
- * @param theme - Optional document theme. Pass it so themed text color and
- *   shading resolve correctly in the HTML payload (matters when pasting into
- *   Gmail/Word/etc.). Omit for rgb-only content.
- */
-declare function runsToClipboardContent(runs: Run[], includeFormatting?: boolean, theme?: Theme | null): ClipboardContent;
-/**
- * Convert paragraphs to clipboard content.
- *
- * @param theme - See {@link runsToClipboardContent}.
- */
-declare function paragraphsToClipboardContent(paragraphs: Paragraph[], includeFormatting?: boolean, theme?: Theme | null): ClipboardContent;
-/**
- * Write content to clipboard
- */
-declare function writeToClipboard(content: ClipboardContent): Promise<boolean>;
-/**
- * Read content from clipboard
- */
-declare function readFromClipboard(options?: ClipboardOptions): Promise<ParsedClipboardContent | null>;
-/**
- * Handle paste event
- */
-declare function handlePasteEvent(event: ClipboardEvent, options?: ClipboardOptions): ParsedClipboardContent | null;
-/**
- * Parse HTML from clipboard
- */
-declare function parseClipboardHtml(html: string, plainText: string, cleanWordFormatting?: boolean): ParsedClipboardContent;
-/**
- * Check if HTML is from Microsoft Word
- */
-declare function isWordHtml(html: string): boolean;
-/**
- * Check if HTML is from our editor
- */
-declare function isEditorHtml(html: string): boolean;
-/**
- * Clean Microsoft Word HTML
- */
-declare function cleanWordHtml(html: string): string;
-/**
- * Convert HTML to runs
- */
-declare function htmlToRuns(html: string, plainTextFallback: string): Run[];
-/**
- * Create clipboard keyboard handlers for an editor
- */
-declare function createClipboardHandlers(options: {
-    onCopy?: () => {
-        runs: Run[];
-    } | null;
-    onCut?: () => {
-        runs: Run[];
-    } | null;
-    onPaste?: (content: ParsedClipboardContent) => void;
-    clipboardOptions?: ClipboardOptions;
-}): {
-    handleCopy: (event: ClipboardEvent) => Promise<void>;
-    handleCut: (event: ClipboardEvent) => Promise<void>;
-    handlePaste: (event: ClipboardEvent) => void;
-    handleKeyDown: (event: KeyboardEvent) => Promise<void>;
-};
 
 /**
  * Embedded font de-obfuscation (ECMA-376 Part 4 §2.8.1, "Font Embedding").
@@ -293,450 +151,65 @@ declare function getRenderableDocumentFonts(doc: Document, options?: RenderableF
 declare function excludeFontsByName(fonts: readonly FontOption[] | undefined, existingNames: Iterable<string>): FontOption[];
 
 /**
- * Formatting to CSS Converter
- *
- * Converts OOXML formatting objects (TextFormatting, ParagraphFormatting)
- * to React CSSProperties for rendering.
- *
- * Handles ALL formatting properties:
- * - Font: family, size, weight, style
- * - Text: color, background, decoration (underline, strike, double-strike)
- * - Effects: superscript, subscript, small-caps, all-caps
- * - Spacing: letter-spacing
- * - Paragraph: alignment, line-height, margins, padding, borders, background
- */
-/** Framework-agnostic CSS properties type (compatible with React.CSSProperties) */
-type CSSProperties$1 = Record<string, any>;
-
-/**
- * Convert TextFormatting to CSS properties for a run/span
- *
- * @param formatting - Text formatting from OOXML
- * @param theme - Theme for resolving colors and fonts
- * @returns React CSSProperties
- */
-declare function textToStyle(formatting: TextFormatting | undefined | null, theme?: Theme | null): CSSProperties$1;
-/**
- * Convert ParagraphFormatting to CSS properties
- *
- * @param formatting - Paragraph formatting from OOXML
- * @param theme - Theme for resolving colors
- * @returns React CSSProperties
- */
-declare function paragraphToStyle(formatting: ParagraphFormatting | undefined | null, theme?: Theme | null): CSSProperties$1;
-/**
- * Convert a BorderSpec to CSS border properties
- *
- * @param border - Border specification
- * @param side - 'Top' | 'Bottom' | 'Left' | 'Right' | '' for all
- * @param theme - Theme for color resolution
- * @returns Partial CSSProperties with border styles
- */
-declare function borderToStyle(border: BorderSpec | undefined | null, side?: 'Top' | 'Bottom' | 'Left' | 'Right' | '', theme?: Theme | null): CSSProperties$1;
-/**
- * Convert ShadingProperties to background color
- *
- * @param shading - Shading properties
- * @param theme - Theme for color resolution
- * @returns CSS color string or empty string
- */
-declare function resolveShadingFill(shading: ShadingProperties | undefined | null, theme?: Theme | null): string;
-/**
- * Merge multiple CSSProperties objects
- *
- * Later objects override earlier ones for conflicting properties.
- *
- * @param styles - Array of CSSProperties objects
- * @returns Merged CSSProperties
- */
-declare function mergeStyles(...styles: (CSSProperties$1 | undefined | null)[]): CSSProperties$1;
-/**
- * Get CSS for a table cell based on formatting
- *
- * @param formatting - Table cell formatting
- * @param theme - Theme for color resolution
- * @returns CSSProperties for the cell
+ * Structural mark contract consumed by the legacy tree-to-layout adapter.
+ * @public
  */
-declare function tableCellToStyle(formatting: {
-    verticalAlign?: 'top' | 'center' | 'bottom';
-    textDirection?: string;
-    shading?: ShadingProperties;
-    borders?: {
-        top?: BorderSpec;
-        bottom?: BorderSpec;
-        left?: BorderSpec;
-        right?: BorderSpec;
-    };
-    margins?: {
-        top?: {
-            value: number;
-            type: string;
-        };
-        bottom?: {
-            value: number;
-            type: string;
-        };
-        left?: {
-            value: number;
-            type: string;
-        };
-        right?: {
-            value: number;
-            type: string;
-        };
+interface EditorTreeMark {
+    readonly type: {
+        readonly name: string;
     };
-} | undefined | null, theme?: Theme | null): CSSProperties$1;
-/**
- * Get CSS for page/section container
- *
- * @param sectionProps - Section properties
- * @returns CSSProperties for the page container
- */
-declare function sectionToStyle(sectionProps: {
-    pageWidth?: number;
-    pageHeight?: number;
-    marginTop?: number;
-    marginBottom?: number;
-    marginLeft?: number;
-    marginRight?: number;
-    background?: {
-        color?: {
-            rgb?: string;
-            themeColor?: string;
-        };
-    };
-} | undefined | null, theme?: Theme | null): CSSProperties$1;
-
-/**
- * Keyboard Navigation Utilities
- *
- * Provides enhanced keyboard navigation for the editor:
- * - Ctrl+Left/Right: Move by word
- * - Home/End: Move to start/end of line
- * - Ctrl+Home/End: Move to start/end of document
- * - Ctrl+Shift+Left/Right: Select by word
- * - Shift+Home/End: Select to start/end of line
- */
-/**
- * Navigation direction
- */
-type NavigationDirection = 'left' | 'right' | 'up' | 'down';
-/**
- * Navigation unit
- */
-type NavigationUnit = 'character' | 'word' | 'line' | 'paragraph' | 'document';
-/**
- * Keyboard navigation action
- */
-interface NavigationAction {
-    /** Direction to navigate */
-    direction: NavigationDirection;
-    /** Unit of movement */
-    unit: NavigationUnit;
-    /** Whether to extend selection */
-    extend: boolean;
+    readonly attrs: Record<string, any>;
 }
 /**
- * Keyboard shortcut definition
- */
-interface KeyboardShortcut {
-    key: string;
-    ctrlKey?: boolean;
-    metaKey?: boolean;
-    shiftKey?: boolean;
-    altKey?: boolean;
-}
-/**
- * Check if a character is a word character (letter, digit, or underscore)
- */
-declare function isWordCharacter(char: string): boolean;
-/**
- * Check if a character is whitespace
- */
-declare function isWhitespace(char: string): boolean;
-/**
- * Check if a character is a punctuation character
- */
-declare function isPunctuation(char: string): boolean;
-/**
- * Find the start of the current or previous word
- */
-declare function findWordStart(text: string, position: number): number;
-/**
- * Find the end of the current or next word
- */
-declare function findWordEnd(text: string, position: number): number;
-/**
- * Find the next word start (for Ctrl+Right navigation)
- */
-declare function findNextWordStart(text: string, position: number): number;
-/**
- * Find the previous word start (for Ctrl+Left navigation)
- */
-declare function findPreviousWordStart(text: string, position: number): number;
-/**
- * Find the start of the current line in a text node
- * Uses visual line detection based on bounding rectangles
- */
-declare function findVisualLineStart(container: Node, offset: number): {
-    node: Node;
-    offset: number;
-} | null;
-/**
- * Find the end of the current line in a text node
- * Uses visual line detection based on bounding rectangles
- */
-declare function findVisualLineEnd(container: Node, offset: number): {
-    node: Node;
-    offset: number;
-} | null;
-/**
- * Get the current selection info
- */
-declare function getSelectionInfo(): {
-    node: Node;
-    offset: number;
-    anchorNode: Node | null;
-    anchorOffset: number;
-    focusNode: Node | null;
-    focusOffset: number;
-    isCollapsed: boolean;
-    text: string;
-} | null;
-/**
- * Set the selection to a specific position
- */
-declare function setSelectionPosition(node: Node, offset: number): void;
-/**
- * Extend selection to a specific position
- */
-declare function extendSelectionTo(node: Node, offset: number): void;
-/**
- * Move selection by word in a text node
- */
-declare function moveByWord(direction: 'left' | 'right', extend?: boolean): boolean;
-/**
- * Move to start/end of line
- */
-declare function moveToLineEdge(edge: 'start' | 'end', extend?: boolean): boolean;
-/**
- * Parse a keyboard event into a navigation action
- */
-declare function parseNavigationAction(event: KeyboardEvent): NavigationAction | null;
-/**
- * Handle a keyboard navigation event
- * Returns true if the event was handled
- */
-declare function handleNavigationKey(event: KeyboardEvent, options?: {
-    onDocumentStart?: () => void;
-    onDocumentEnd?: () => void;
-}): boolean;
-/**
- * Check if an event is a navigation key event
- */
-declare function isNavigationKey(event: KeyboardEvent): boolean;
-/**
- * Expand selection to word boundaries
- * Used for double-click word selection
- */
-declare function expandSelectionToWord(): boolean;
-/**
- * Get the word at the current cursor position
- */
-declare function getWordAtCursor(): string | null;
-/**
- * Check if a keyboard event matches a shortcut definition
- */
-declare function matchesShortcut(event: KeyboardEvent, shortcut: KeyboardShortcut): boolean;
-/**
- * Common navigation shortcuts
- */
-declare const NAVIGATION_SHORTCUTS: {
-    readonly wordLeft: KeyboardShortcut;
-    readonly wordRight: KeyboardShortcut;
-    readonly selectWordLeft: KeyboardShortcut;
-    readonly selectWordRight: KeyboardShortcut;
-    readonly lineStart: KeyboardShortcut;
-    readonly lineEnd: KeyboardShortcut;
-    readonly selectToLineStart: KeyboardShortcut;
-    readonly selectToLineEnd: KeyboardShortcut;
-    readonly documentStart: KeyboardShortcut;
-    readonly documentEnd: KeyboardShortcut;
-    readonly selectToDocumentStart: KeyboardShortcut;
-    readonly selectToDocumentEnd: KeyboardShortcut;
-};
-/**
- * Get a human-readable description of a shortcut
- */
-declare function describeShortcut(shortcut: KeyboardShortcut): string;
-/**
- * Get all navigation shortcuts with descriptions
- */
-declare function getNavigationShortcutDescriptions(): Array<{
-    action: string;
-    shortcut: string;
-}>;
-
-/**
- * Selection Highlight Utilities
- *
- * Provides visual highlighting for text selection across multiple runs.
- * Browsers handle ::selection pseudo-element differently, especially when
- * selection spans multiple elements with different backgrounds or styling.
+ * Structural node contract consumed by renderer-side tree walkers.
  *
- * This module provides:
- * - Custom selection highlight rendering
- * - Programmatic selection range marking
- * - Visual feedback for selection across runs
- */
-/** Framework-agnostic CSS properties type (compatible with React.CSSProperties) */
-type CSSProperties = Record<string, any>;
-/**
- * Highlight rectangle representing a selected region
- */
-interface HighlightRect {
-    /** Left position in pixels */
-    left: number;
-    /** Top position in pixels */
-    top: number;
-    /** Width in pixels */
-    width: number;
-    /** Height in pixels */
-    height: number;
-}
-/**
- * Selection highlight configuration
- */
-interface SelectionHighlightConfig {
-    /** Background color for selection */
-    backgroundColor: string;
-    /** Optional border color for selection */
-    borderColor?: string;
-    /** Optional border radius */
-    borderRadius?: number;
-    /** Z-index for overlay */
-    zIndex?: number;
-    /** Opacity for highlight */
-    opacity?: number;
-    /** Mix blend mode */
-    mixBlendMode?: CSSProperties['mixBlendMode'];
-}
-/**
- * Selection range in document coordinates
+ * The contract deliberately describes only the immutable tree operations the
+ * renderer needs, so core does not depend on any editor implementation.
+ * @public
  */
-interface SelectionRange {
-    /** Start position */
-    start: {
-        paragraphIndex: number;
-        contentIndex: number;
-        offset: number;
+interface EditorTreeNode {
+    readonly type: {
+        readonly name: string;
+        create(...args: any[]): EditorTreeNode;
     };
-    /** End position */
-    end: {
-        paragraphIndex: number;
-        contentIndex: number;
-        offset: number;
+    readonly attrs: Record<string, any>;
+    readonly marks: readonly EditorTreeMark[];
+    readonly nodeSize: number;
+    readonly content: {
+        readonly size: number;
     };
+    readonly isText: boolean;
+    readonly isTextblock: boolean;
+    readonly isInline: boolean;
+    readonly text?: string | null;
+    forEach(callback: (node: EditorTreeNode, offset: number, index: number) => void): void;
+    descendants(callback: (node: EditorTreeNode, pos: number) => boolean | void): void;
 }
+
 /**
- * Default selection highlight style (matches Word/Google Docs)
- */
-declare const DEFAULT_SELECTION_STYLE: SelectionHighlightConfig;
-/**
- * High contrast selection style
- */
-declare const HIGH_CONTRAST_SELECTION_STYLE: SelectionHighlightConfig;
-/**
- * Selection highlight CSS custom properties
- */
-declare const SELECTION_CSS_VARS: {
-    readonly backgroundColor: "--docx-selection-bg";
-    readonly borderColor: "--docx-selection-border";
-    readonly textColor: "--docx-selection-text";
-};
-/**
- * Get all selection rectangles from the current DOM selection
- *
- * Uses getClientRects() to get accurate rectangles even when
- * selection spans multiple inline elements.
- */
-declare function getSelectionRects(containerElement?: HTMLElement | null): HighlightRect[];
-/**
- * Merge adjacent or overlapping rectangles
- *
- * This reduces the number of highlight elements needed and creates
- * a cleaner visual appearance.
- */
-declare function mergeAdjacentRects(rects: HighlightRect[], tolerance?: number): HighlightRect[];
-/**
- * Get selection rectangles with merging applied
- */
-declare function getMergedSelectionRects(containerElement?: HTMLElement | null): HighlightRect[];
-/**
- * Generate CSS styles for a highlight rectangle
- */
-declare function getHighlightRectStyle(rect: HighlightRect, config?: SelectionHighlightConfig): CSSProperties;
-/**
- * Generate inline CSS for selection pseudo-elements
- *
- * This is used to inject consistent selection styling
- * across all editable elements.
- */
-declare function generateSelectionCSS(selector: string, config?: SelectionHighlightConfig): string;
-/**
- * Check if there is an active text selection (not collapsed)
- */
-declare function hasActiveSelection(): boolean;
-/**
- * Get the selected text
- */
-declare function getSelectedText(): string;
-/**
- * Check if selection is within a specific element
+ * @packageDocumentation
+ * @public
  */
-declare function isSelectionWithin(element: HTMLElement): boolean;
+
 /**
- * Get the bounding rect of the current selection
+ * Information about a heading found in the document.
  */
-declare function getSelectionBoundingRect(): DOMRect | null;
+interface HeadingInfo {
+    /** The text content of the heading */
+    text: string;
+    /** Outline level (0 = Heading 1, 1 = Heading 2, etc.) */
+    level: number;
+    /** ProseMirror document position of the paragraph node */
+    pmPos: number;
+}
 /**
- * Create a selection highlight for a specific text range
+ * Collect all headings from a ProseMirror document.
  *
- * This is useful for find/replace highlighting, AI action previews, etc.
- */
-declare function highlightTextRange(_containerElement: HTMLElement, startNode: Node, startOffset: number, endNode: Node, endOffset: number): Range | null;
-/**
- * Select a text range programmatically
- */
-declare function selectRange(range: Range): void;
-/**
- * Clear the current selection
- */
-declare function clearSelection(): void;
-/**
- * Check if selection is backwards (focus before anchor)
- */
-declare function isSelectionBackwards(): boolean;
-/**
- * Normalize selection to always be forward (start before end)
- */
-declare function normalizeSelectionDirection(): void;
-/**
- * Inject selection highlight CSS into document
- */
-declare function injectSelectionStyles(config?: SelectionHighlightConfig): void;
-/**
- * Remove injected selection styles
- */
-declare function removeSelectionStyles(): void;
-/**
- * Check if selection styles are injected
+ * Detection logic:
+ * 1. Check `outlineLevel` attr (set by OOXML parsing or style resolution)
+ * 2. Fallback to `styleId` matching /^[Hh]eading(\d)$/
  */
-declare function areSelectionStylesInjected(): boolean;
-/**
- * Create a selection change handler that updates highlight rects
- */
-declare function createSelectionChangeHandler(containerElement: HTMLElement | null, onRectsChange: (rects: HighlightRect[]) => void, merge?: boolean): () => void;
+declare function collectHeadings(doc: EditorTreeNode): HeadingInfo[];
 
 /**
  * Option shapes for `scrollToParaId(paraId, { highlight })`.
@@ -875,6 +348,67 @@ declare function computeSplitDialogDefaults(rowspan: number, colspan: number): {
     initialCols: number;
 };
 
+/**
+ * Find word boundaries around a position in text
+ * Returns [startIndex, endIndex] inclusive start, exclusive end
+ */
+declare function findWordBoundaries(text: string, position: number): [number, number];
+/**
+ * Get the word at a position in text
+ */
+declare function getWordAt(text: string, position: number): string;
+/**
+ * Word selection result
+ */
+interface WordSelectionResult {
+    /** The selected word */
+    word: string;
+    /** Start index in the text (inclusive) */
+    startIndex: number;
+    /** End index in the text (exclusive) */
+    endIndex: number;
+}
+/**
+ * Find the word at a position and return detailed info
+ */
+declare function findWordAt(text: string, position: number): WordSelectionResult;
+/**
+ * Select a word at the current cursor position using the browser's native APIs.
+ * This works reliably across different browsers and handles contentEditable well.
+ */
+declare function selectWordAtCursor(): boolean;
+/**
+ * Select a word in a specific text node at the given offset
+ */
+declare function selectWordInTextNode(textNode: Text, offset: number): boolean;
+/**
+ * Expand the current selection to word boundaries.
+ * If there's a collapsed selection (cursor), selects the word at cursor.
+ * If there's an existing selection, expands to include complete words.
+ */
+declare function expandSelectionToWordBoundaries(): boolean;
+/**
+ * Select the entire paragraph containing the current selection.
+ * Looks for the nearest element with [data-paragraph-index] attribute.
+ */
+declare function selectParagraphAtCursor(): boolean;
+/**
+ * Handle click event for multi-click detection.
+ * Call this in your click handler.
+ * Returns the click count (1 = single, 2 = double, 3 = triple).
+ */
+declare function handleClickForMultiClick(event: MouseEvent): number;
+/**
+ * Create a double-click handler that selects words.
+ * Returns a function that should be called on dblclick events.
+ */
+declare function createDoubleClickWordSelector(): (event: MouseEvent) => void;
+/**
+ * Create a triple-click handler that selects paragraphs.
+ * This uses our custom click counting since browsers have inconsistent triple-click.
+ */
+declare function createTripleClickParagraphSelector(): (event: MouseEvent) => void;
+
 /**
  * Shared file-input → docx-buffer reader.
  *
@@ -953,4 +487,4 @@ declare function createComment(allocator: CommentIdAllocator, text: string, auth
  */
 declare function sanitizeHref(href: string | null | undefined): string | undefined;
 
-export { CLIPBOARD_TYPES, type CellAnchor, type ClipboardContent, type ClipboardOptions, type ColorMode, type CommentIdAllocator, DEFAULT_PARAGRAPH_FLASH_COLOR, DEFAULT_PARAGRAPH_FLASH_DURATION_MS, DEFAULT_SELECTION_STYLE, type EmbeddedFontFace, HIGH_CONTRAST_SELECTION_STYLE, type HighlightRect, INTERNAL_CLIPBOARD_TYPE, type KeyboardShortcut, NAVIGATION_SHORTCUTS, type NavigationAction, type NavigationDirection, type NavigationUnit, PARAGRAPH_FLASH_CLASS_NAME, PENDING_COMMENT_ID, type ParagraphHighlightOptions, type ParsedClipboardContent, type ReadDocxFileResult, type RenderableFontOptions, SELECTION_CSS_VARS, type ScrollToParaIdOptions, type SelectionHighlightConfig, type SelectionRange, type SplitLayoutResult, type SplitTarget, areSelectionStylesInjected, borderToStyle, buildAnchorMaps, cleanWordHtml, clearSelection, computeSplitDialogDefaults, computeSplitLayout, copyParagraphs, copyRuns, createClipboardHandlers, createComment, createCommentIdAllocator, createSelectionChangeHandler, deobfuscateFont, describeShortcut, excludeFontsByName, expandSelectionToWord, extendSelectionTo, extractEmbeddedFontFaces, findNextWordStart, findParagraphFragmentsByParaId, findPreviousWordStart, findVisualLineEnd, findVisualLineStart, findWordEnd, findWordStart, flashParagraphElements, flashParagraphFragmentsByParaId, generateSelectionCSS, getClipboardImageFiles, getEmbeddedFontFaces, getEmbeddedFontFamilies, getHighlightRectStyle, getMergedSelectionRects, getNavigationShortcutDescriptions, getRenderableDocumentFonts, getSelectedText, getSelectionBoundingRect, getSelectionInfo, getSelectionRects, getWordAtCursor, handleNavigationKey, handlePasteEvent, hasActiveSelection, highlightTextRange, htmlToRuns, injectSelectionStyles, isEditorHtml, isNavigationKey, isPunctuation, isSelectionBackwards, isSelectionWithin, isValidFontKey, isWhitespace, isWordCharacter, isWordHtml, loadEmbeddedFonts, matchesShortcut, mergeAdjacentRects, mergeStyles, moveByWord, moveToLineEdge, normalizeSelectionDirection, paragraphToStyle, paragraphsToClipboardContent, parseClipboardHtml, parseNavigationAction, prefersColorSchemeDark, readDocxFileFromInput, readFromClipboard, redistributeColumnWidths, removeSelectionStyles, resolveIsDark, resolveShadingFill, runsToClipboardContent, sanitizeHref, sectionToStyle, selectRange, selectRenderableFonts, setSelectionPosition, subscribeSystemDark, sumColumnWidths, tableCellToStyle, textToStyle, writeToClipboard };
+export { type CellAnchor, type ColorMode, type CommentIdAllocator, DEFAULT_PARAGRAPH_FLASH_COLOR, DEFAULT_PARAGRAPH_FLASH_DURATION_MS, type EmbeddedFontFace, type HeadingInfo, PARAGRAPH_FLASH_CLASS_NAME, PENDING_COMMENT_ID, type ParagraphHighlightOptions, type ReadDocxFileResult, type RenderableFontOptions, type ScrollToParaIdOptions, type SplitLayoutResult, type SplitTarget, type WordSelectionResult, buildAnchorMaps, collectHeadings, computeSplitDialogDefaults, computeSplitLayout, createComment, createCommentIdAllocator, createDoubleClickWordSelector, createTripleClickParagraphSelector, deobfuscateFont, excludeFontsByName, expandSelectionToWordBoundaries, extractEmbeddedFontFaces, findParagraphFragmentsByParaId, findWordAt, findWordBoundaries, flashParagraphElements, flashParagraphFragmentsByParaId, getEmbeddedFontFaces, getEmbeddedFontFamilies, getRenderableDocumentFonts, getWordAt, handleClickForMultiClick, isValidFontKey, loadEmbeddedFonts, prefersColorSchemeDark, readDocxFileFromInput, redistributeColumnWidths, resolveIsDark, sanitizeHref, selectParagraphAtCursor, selectRenderableFonts, selectWordAtCursor, selectWordInTextNode, subscribeSystemDark, sumColumnWidths };