@zeke-02/docx-editor-core 0.1.0

package/dist/utils/index.d.ts

@@ -0,0 +1,710 @@
+/**
+ * Editor utilities (curated public surface).
+ *
+ * The named exports below are the public API contract. Adding a helper
+ * to a source module does not automatically make it public — it must
+ * be added to this barrel to be reachable from `@zeke-02/docx-editor-core/utils`.
+ * @packageDocumentation
+ * @public
+ */
+export { PIXELS_PER_INCH, TWIPS_PER_INCH, clamp, eighthsToPixels, emuToPixels, emuToTwips, formatPx, halfPointsToPixels, halfPointsToPoints, pixelsToEmu, pixelsToTwips, pointsToHalfPoints, pointsToPixels, roundPixels, twipsToEmu, twipsToPixels } from './units.js';
+export { C as CreateEmptyDocumentOptions, P as ProcessTemplateOptions, a as ProcessTemplateResult, T as TemplateError, z as ThemeMatrixCell, b as blendColors, c as colorsEqual, d as createDocumentWithText, e as createEmptyDocument, f as createRgbColor, g as createTemplateProcessor, h as createThemeColor, i as darkenColor, A as ensureHexPrefix, B as generateThemeTintShadeMatrix, j as getContrastingColor, k as getMissingVariables, l as getTemplateTags, D as getThemeTintShadeHex, m as isBlack, n as isWhite, o as lightenColor, p as parseColorString, q as previewTemplate, r as processTemplate, s as processTemplateAdvanced, F as processTemplateAndDownload, t as processTemplateAsBlob, u as processTemplateDetailed, v as resolveColor, G as resolveColorToHex, w as resolveHighlightColor, E as resolveHighlightToCss, x as resolveShadingColor, y as validateTemplate } from '../colorResolver-BZ_yScf4.js';
+import { R as Run, P as Paragraph } from '../content-CmqAwdFL.js';
+import { T as Theme } from '../styles-BBv7doYK.js';
+export { D as DocxInput, t as toArrayBuffer } from '../docxInput-DTbCa48g.js';
+export { F as FONT_MAPPING, z 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, A as extractFontsFromDocument, i as findPageBreaks, B 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 isLineBreak, q as isLoading, s as isPageBreak, C as loadDocumentFonts, t as loadFont, D as loadFontDefinitions, u as loadFontFromBuffer, E as loadFontFromUrl, G as loadFontWithMapping, v as loadFonts, H as loadFontsWithMapping, J as onFontError, w as onFontsLoaded, x as preloadCommonFonts, y as removePageBreak } from '../fontLoader-CK2QLq68.js';
+import { B as BorderSpec, S as ShadingProperties } from '../colors-C3vA7HUU.js';
+import { P as ParagraphFormatting, T as TextFormatting } from '../formatting-_OXU8gLB.js';
+export { HeadingInfo, collectHeadings } from './headingCollector.js';
+export { WordSelectionResult, createDoubleClickWordSelector, createTripleClickParagraphSelector, expandSelectionToWordBoundaries, findWordAt, findWordBoundaries, getWordAt, handleClickForMultiClick, selectParagraphAtCursor, selectWordAtCursor, selectWordInTextNode } from './textSelection.js';
+export { MIN_CARD_GAP, SIDEBAR_DOCUMENT_SHIFT, SIDEBAR_PAGE_GAP, SIDEBAR_WIDTH } from './sidebarConstants.js';
+import '../types/document.js';
+import '../docx/wrapTypes.js';
+import 'prosemirror-model';
+
+/**
+ * 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>;
+};
+
+/**
+ * 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
+ */
+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;
+        };
+    };
+} | 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;
+}
+/**
+ * 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.
+ *
+ * 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
+ */
+interface SelectionRange {
+    /** Start position */
+    start: {
+        paragraphIndex: number;
+        contentIndex: number;
+        offset: number;
+    };
+    /** End position */
+    end: {
+        paragraphIndex: number;
+        contentIndex: number;
+        offset: number;
+    };
+}
+/**
+ * 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
+ */
+declare function isSelectionWithin(element: HTMLElement): boolean;
+/**
+ * Get the bounding rect of the current selection
+ */
+declare function getSelectionBoundingRect(): DOMRect | null;
+/**
+ * Create a selection highlight for a specific text range
+ *
+ * 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
+ */
+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;
+
+/**
+ * Shared table split algorithm — model-agnostic core logic.
+ *
+ * This module contains the pure layout computation for splitting a table cell:
+ * column width redistribution, neighbor span adjustment, and new-cell placement.
+ * Both the ProseMirror path (tableSplit.ts) and the Document-model path
+ * (TableToolbar.tsx) delegate to these functions.
+ */
+/** A cell's position and span within the logical grid. */
+interface CellAnchor<T> {
+    /** Opaque payload — the caller's cell type (PMNode, TableCell, etc.) */
+    data: T;
+    row: number;
+    col: number;
+    rowspan: number;
+    colspan: number;
+}
+/** Parameters describing the split target. */
+interface SplitTarget {
+    row: number;
+    col: number;
+    rowspan: number;
+    colspan: number;
+}
+/** Result of `computeSplitLayout`. */
+interface SplitLayoutResult<T> {
+    /** All anchors after the split (neighbors adjusted + new split cells). */
+    anchors: CellAnchor<T>[];
+    deltaRows: number;
+    deltaCols: number;
+    newRowCount: number;
+}
+declare function sumColumnWidths(widths: number[], start: number, span: number): number;
+/**
+ * Redistribute column widths when splitting a cell's column span.
+ *
+ * @param existing   Current column widths array for the whole table.
+ * @param startCol   First column of the cell being split.
+ * @param currentSpan Current column span of the cell.
+ * @param targetSpan  Desired column span after split.
+ * @returns New column widths array with the split applied.
+ */
+declare function redistributeColumnWidths(existing: number[], startCol: number, currentSpan: number, targetSpan: number): number[];
+/**
+ * Compute the new anchor layout after splitting a target cell.
+ *
+ * This is the core algorithm shared between ProseMirror and Document-model
+ * paths. It adjusts neighbor spans, shifts positions for inserted rows/cols,
+ * and creates placeholder anchors for the new split cells.
+ *
+ * @param anchors     All cell anchors in the current table.
+ * @param target      The anchor being split.
+ * @param rows        Number of rows the target should become.
+ * @param cols        Number of columns the target should become.
+ * @param totalRows   Current total row count.
+ * @param createSplitCellData  Factory to create `data` for each new split cell.
+ *   Called with `(isOriginal, rowOffset, colOffset)` — `isOriginal` is true for
+ *   the top-left cell that retains the original content.
+ */
+declare function computeSplitLayout<T>(anchors: CellAnchor<T>[], target: CellAnchor<T>, rows: number, cols: number, totalRows: number, createSplitCellData: (isOriginal: boolean, rowOffset: number, colOffset: number) => T): SplitLayoutResult<T>;
+/**
+ * Build lookup maps from an anchor list — by start position and by covered slot.
+ */
+declare function buildAnchorMaps<T>(anchors: CellAnchor<T>[]): {
+    byStart: Map<string, CellAnchor<T>>;
+    byCoveredSlot: Map<string, CellAnchor<T>>;
+};
+/**
+ * Compute the initial dialog values for a split-cell dialog.
+ */
+declare function computeSplitDialogDefaults(rowspan: number, colspan: number): {
+    minRows: number;
+    minCols: number;
+    initialRows: number;
+    initialCols: number;
+};
+
+/**
+ * Shared file-input → docx-buffer reader.
+ *
+ * React (DocxEditor.tsx `handleDocxFileChange`) and Vue
+ * (DocxEditor.vue `handleDocxFileChange`) had byte-equivalent
+ * `await file.arrayBuffer()` + `name.replace(/\.docx$/i, '')` boilerplate
+ * around their hidden file inputs. This helper folds the common steps
+ * into one place so the two adapters can never drift on filename
+ * normalization or on the "reset input.value so re-picking the same
+ * file fires `change` again" detail.
+ *
+ * Returns `null` when the user cancelled the picker (no file chosen).
+ */
+interface ReadDocxFileResult {
+    /** ArrayBuffer ready to feed into `loadBuffer` / `parseDocx`. */
+    buffer: ArrayBuffer;
+    /** File name with the trailing `.docx` extension stripped. */
+    name: string;
+}
+/**
+ * Read the first selected file out of an `<input type="file">` change
+ * event, return its ArrayBuffer + a stem-form name. Always resets
+ * `input.value` so re-selecting the same file in the same picker fires
+ * the next `change` event.
+ */
+declare function readDocxFileFromInput(event: Event): Promise<ReadDocxFileResult | null>;
+
+export { CLIPBOARD_TYPES, type CellAnchor, type ClipboardContent, type ClipboardOptions, DEFAULT_SELECTION_STYLE, HIGH_CONTRAST_SELECTION_STYLE, type HighlightRect, INTERNAL_CLIPBOARD_TYPE, type KeyboardShortcut, NAVIGATION_SHORTCUTS, type NavigationAction, type NavigationDirection, type NavigationUnit, type ParsedClipboardContent, type ReadDocxFileResult, SELECTION_CSS_VARS, type SelectionHighlightConfig, type SelectionRange, type SplitLayoutResult, type SplitTarget, areSelectionStylesInjected, borderToStyle, buildAnchorMaps, cleanWordHtml, clearSelection, computeSplitDialogDefaults, computeSplitLayout, copyParagraphs, copyRuns, createClipboardHandlers, createSelectionChangeHandler, describeShortcut, expandSelectionToWord, extendSelectionTo, findNextWordStart, findPreviousWordStart, findVisualLineEnd, findVisualLineStart, findWordEnd, findWordStart, generateSelectionCSS, getClipboardImageFiles, getHighlightRectStyle, getMergedSelectionRects, getNavigationShortcutDescriptions, getSelectedText, getSelectionBoundingRect, getSelectionInfo, getSelectionRects, getWordAtCursor, handleNavigationKey, handlePasteEvent, hasActiveSelection, highlightTextRange, htmlToRuns, injectSelectionStyles, isEditorHtml, isNavigationKey, isPunctuation, isSelectionBackwards, isSelectionWithin, isWhitespace, isWordCharacter, isWordHtml, matchesShortcut, mergeAdjacentRects, mergeStyles, moveByWord, moveToLineEdge, normalizeSelectionDirection, paragraphToStyle, paragraphsToClipboardContent, parseClipboardHtml, parseNavigationAction, readDocxFileFromInput, readFromClipboard, redistributeColumnWidths, removeSelectionStyles, resolveShadingFill, runsToClipboardContent, sectionToStyle, selectRange, setSelectionPosition, sumColumnWidths, tableCellToStyle, textToStyle, writeToClipboard };