@betteroffice/docx 0.0.1 → 0.0.3

package/dist/core.d.mts

@@ -1,66 +1,34 @@
-export { parseDocx } from './docx/parser.mjs';
-export { serializeDocumentBody, serializeDocument as serializeDocx, serializeSectionProperties } from './docx/serializer/index.mjs';
-export { createDocx, default as repackDocx, updateMultipleFiles } from './docx/rezip.mjs';
-export { a as attemptSelectiveSave } from './selectiveSave-oFBJ1n71.mjs';
-export { b as buildPatchedDocumentXml, v as validatePatchSafety } from './selectiveXmlPatch-ypkxlTD_.mjs';
-export { C as CreateEmptyDocumentOptions, P as ProcessTemplateOptions, a as ProcessTemplateResult, c as colorsEqual, b as createDocumentWithText, d as createEmptyDocument, e as createRgbColor, g as createThemeColor, t as ensureHexPrefix, i as getTemplateTags, j as isBlack, k as isWhite, p as parseColorString, m as processTemplate, o as processTemplateAsBlob, q as processTemplateDetailed, r as resolveHighlightColor, u as resolveHighlightToCss, s as resolveShadingColor, v as validateTemplate } from './colorResolver-n0o7H7ep.mjs';
-export { A as AgentContextOptions, D as DocumentAgent, E as ExtendedSelectionContext, e as SelectionContextOptions, f as buildExtendedSelectionContext, g as buildSelectionContext, k as executeCommand, l as executeCommands, m as getAgentContext, n as getDocumentSummary } from './selectionContext-Buc9BCU1.mjs';
-export { emuToTwips, formatPx, halfPointsToPixels, pixelsToTwips, twipsToEmu, twipsToPixels } from './utils/units.mjs';
-export { 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, i as findPageBreaks, j as getLoadedFonts, k as hasPageBreakBefore, l as insertHorizontalRule, m as insertPageBreak, n as isBreakContent, o as isColumnBreak, p as isFontLoaded, q as isFontsLoading, r as isGoogleFontsEnabled, s as isLineBreak, t as isPageBreak, u as loadFont, v as loadFontFromBuffer, w as loadFonts, x as onFontsLoaded, y as preloadCommonFonts, z as removePageBreak, A as setGoogleFontsEnabled } from './fontLoader-Bx6DK6-2.mjs';
-export { D as DocxInput, t as toArrayBuffer } from './docxInput-DTbCa48g.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-Borj29SF.mjs';
+export { a as attemptSelectiveSave, c as createDocx, p as parseDocx, r as repackDocx, u as updateMultipleFiles } from './selectiveSave-CVoajSKE.mjs';
 import { Document } from './types/document.mjs';
 export { DocxPackage } from './types/document.mjs';
-export { AIAction, AIActionRequest, AgentCommand, AgentContext, AgentResponse, ApplyStyleCommand, DeleteTextCommand, FormatTextCommand, InsertHyperlinkCommand, InsertImageCommand, InsertTableCommand, InsertTextCommand, ParagraphContext, Position, Range, ReplaceTextCommand, SelectionContext, SetVariableCommand, SuggestedAction } from './types/agentApi.mjs';
-export { EditorPluginCore, PanelConfig, PluginPanelProps, PositionCoordinates, RenderedDomContext } from './plugin-api/types.mjs';
-export { b as CorePlugin, M as McpSession, f as McpToolDefinition, g as McpToolHandler, h as McpToolResult } from './types-dYdjUZMo.mjs';
-export { P as PluginRegistry, p as pluginRegistry, r as registerPlugins } from './registry-DMM5VTdT.mjs';
-export { docxtemplaterPlugin } from './core-plugins.mjs';
-import { S as Subscribable } from './Subscribable-DOz6Ohoo.mjs';
-import { ErrorManagerSnapshot, PluginLifecycleSnapshot, PluginLifecycleConfig } from './managers/types.mjs';
-export { AutoSaveManagerOptions, AutoSaveSnapshot, AutoSaveStatus, CellCoordinates, EditorHandle, ErrorNotification, ErrorSeverity, SavedDocumentData, TableSelectionSnapshot } from './managers/types.mjs';
-export { AutoSaveManager, formatLastSaveTime, formatStorageSize, getAutoSaveStatusLabel, getAutoSaveStorageSize, isAutoSaveSupported } from './managers/AutoSaveManager.mjs';
-export { TABLE_DATA_ATTRIBUTES, TableSelectionManager, deleteTableFromDocument, findTableFromClick, getTableFromDocument, updateTableInDocument } from './managers/TableSelectionManager.mjs';
-import { R as Run } from './content-sSHuWw49.mjs';
-export { B as BlockContent, q as BookmarkEnd, r as BookmarkStart, C as Comment, a as CommentRangeEnd, b as CommentRangeStart, D as Deletion, c as DocumentBody, E as Endnote, a1 as Field, a6 as FooterReference, F as Footnote, m as HeaderFooter, aa as HeaderReference, 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, g as RunContent, S as SectionProperties, aU as Shape, T as Table, h as TableCell, i as TableRow, bc as TextBox, j as TextContent, k as TrackedChangeInfo, l as TrackedRunChange } from './content-sSHuWw49.mjs';
-export { B as BlockExtent, F as FootnoteContent, a as Layout, e as LayoutBlock, g as Page, a7 as ResolvedLine, a8 as ResolvedSegment } from './types-DNrYr6yQ.mjs';
-export { P as ParagraphFormatting, T as TextFormatting, a as Theme, y as ThemeColorScheme, A as ThemeFont, D as ThemeFontScheme, G as ThemeMatrixCell, b as blendColors, d as darkenColor, H as generateThemeTintShadeMatrix, g as getContrastingColor, I as getThemeTintShadeHex, l as lightenColor, r as resolveColor } from './formatting-DoL7KBSL.mjs';
-export { e as emuToPixels, p as pixelsToEmu, a as pointsToPixels } from './units-O5Y02RKQ.mjs';
-export { C as ConvertFootnoteOptions, a as ConvertHeaderFooterOptions, b as FOOTNOTE_SEPARATOR_HEIGHT, c as FootnoteRefLocation, H as HeaderFooterMetrics, M as MAX_FOOTNOTE_LAYOUT_PASSES, d as MeasureBlocksFn, S as StabilizeFootnoteLayoutArgs, e as StabilizeFootnoteLayoutResult, g as buildFootnoteContentMap, h as buildFootnoteRenderItems, i as calculateFootnoteReservedHeights, k as collectFootnoteRefs, p as convertHeaderFooterToContent, r as footnoteReservedHeightsEqual, s as mapFootnotesToPages, v as stabilizeFootnoteLayout } from './headerFooterLayout-0zPT64Qc.mjs';
-export { R as Relationship, S as Style, a as StyleDefinitions } from './styles-VxNcXLdi.mjs';
+import { h as DocumentBody, S as SectionProperties, b5 as Table } from './content-MOZ6hKP4.mjs';
+export { B as BlockContent, n as BookmarkEnd, o as BookmarkStart, g as Comment, I as CommentRangeEnd, J as CommentRangeStart, Q as Deletion, k as Endnote, X as Field, a0 as FooterReference, j as Footnote, H as HeaderFooter, a3 as HeaderReference, a4 as Hyperlink, a6 as Image, ai as Insertion, am as ListLevel, ap as MoveFrom, as as MoveTo, i as NumberingDefinitions, f as Paragraph, aE as ParagraphContent, aI as Run, aJ as RunContent, aT as Shape, b6 as TableCell, b9 as TableRow, bc as TextBox, bd as TextContent, bf as TrackedChangeInfo, bg as TrackedRunChange } from './content-MOZ6hKP4.mjs';
+export { emuToPixels, emuToTwips, formatPx, halfPointsToPixels, pixelsToEmu, pixelsToTwips, pointsToPixels, twipsToEmu, twipsToPixels } from './utils/units.mjs';
+export { c as canRenderFont, a as colorsEqual, b as createRgbColor, d as createThemeColor, e as ensureHexPrefix, g as getLoadedFonts, i as isBlack, f as isFontLoaded, h as isFontsLoading, j as isGoogleFontsEnabled, k as isWhite, l as loadFont, m as loadFontFromBuffer, n as loadFonts, 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 { EditorPluginCore, PanelConfig, PluginPanelProps, PositionCoordinates, RenderedDomContext } from './plugin-api/index.mjs';
+export { B as BlockExtent, F as FootnoteContent, a as Layout, L as LayoutBlock, P as Page, R as ResolvedLine, c as ResolvedSegment } from './types-BfqUl2h_.mjs';
+export { P as ParagraphFormatting, a as TextFormatting, e as Theme, u as ThemeColorScheme, v as ThemeFont, w as ThemeFontScheme, x as ThemeMatrixCell, y as blendColors, z as darkenColor, A as generateThemeTintShadeMatrix, D as getContrastingColor, G as getThemeTintShadeHex, H as lightenColor, I as resolveColor } from './formatting-D1EPSaJP.mjs';
+export { d as Relationship, a as Style, S as StyleDefinitions } from './styles-Dn_o3Vo5.mjs';
 import './docx/wrapTypes.mjs';
-import './settingsParser-CcGvtmCK.mjs';
-import './measuredBlock-DZwz8zhD.mjs';
-import './displayListQueries-p-ijSzdh.mjs';
-import './rustDisplayList-dqunvwxH.mjs';
 
 /**
- * Minimal document-tree node contract used by paragraph position helpers.
- * It is intentionally structural so callers do not need an editor runtime
- * dependency merely to walk a document tree.
- * @public
- */
-interface ParagraphPositionNode {
-    readonly attrs: Record<string, unknown>;
-    readonly isTextblock: boolean;
-    readonly nodeSize: number;
-    descendants(callback: (node: ParagraphPositionNode, pos: number) => boolean | void): void;
-}
-/**
- * Position immediately before the first textblock whose `paraId` attribute
- * equals `paraId`.
- * @public
- */
-declare function findStartPosForParaId(doc: ParagraphPositionNode, paraId: string): number | null;
-/**
- * Position range for the textblock whose `paraId` attribute equals `paraId`.
+ * DOCX XML serializers.
+ *
+ * The public synchronous serializer surface is retained for compatibility, but
+ * all OOXML emission is owned by the Rust writer. The fixed context only
+ * supplies deterministic IDs to standalone XML calls; package saves use the
+ * source-package hash and clock through {@link ../rustSaveFacade}.
+ * @packageDocumentation
  * @public
  */
-declare function findParagraphByParaId(doc: ParagraphPositionNode, paraId: string): {
-    node: ParagraphPositionNode;
-    from: number;
-    to: number;
-} | null;
+
+/** Serialize a complete `word/document.xml` part. */
+declare function serializeDocument(doc: Document): string;
+/** Serialize the contents of `w:body`, without the body tags. */
+declare function serializeDocumentBody(body: DocumentBody): string;
+/** Serialize section properties. */
+declare function serializeSectionProperties(props: SectionProperties | undefined): string;
 
 /**
  * Framework-agnostic print helpers shared by the React and Vue
@@ -109,43 +77,134 @@ declare function formatPageRange(range: {
 declare function isPrintSupported(): boolean;
 
 /**
- * ClipboardManager
+ * Subscribable Base Class
  *
- * Framework-agnostic class for clipboard operations in the editor.
- * Extracted from the React `useClipboard` hook.
+ * Framework-agnostic base for manager classes that need to notify
+ * UI frameworks of state changes.
  *
- * Handles:
- * - DOM selection traversal and run extraction
- * - Formatting extraction from computed styles
- * - Clipboard read/write operations
+ * Compatible with:
+ * - React: useSyncExternalStore(manager.subscribe, manager.getSnapshot)
+ * - Vue: watchEffect(() => { manager.subscribe(triggerRef) })
  */
+declare abstract class Subscribable<TSnapshot> {
+    private listeners;
+    private snapshot;
+    constructor(initialSnapshot: TSnapshot);
+    /**
+     * Subscribe to state changes. Returns an unsubscribe function.
+     * Bound method — safe to pass as `useSyncExternalStore(manager.subscribe, ...)`.
+     */
+    subscribe: (listener: () => void) => (() => void);
+    /**
+     * Get the current snapshot. Returns a stable reference unless state has changed.
+     * Bound method — safe to pass as `useSyncExternalStore(..., manager.getSnapshot)`.
+     */
+    getSnapshot: () => TSnapshot;
+    /**
+     * Update the snapshot and notify all subscribers.
+     * Subclasses should call this whenever their state changes.
+     */
+    protected setSnapshot(snapshot: TSnapshot): void;
+    private notify;
+}
 
-/** Selection data for clipboard operations */
-interface ClipboardSelection {
-    text: string;
-    runs: Run[];
-    startParagraphIndex: number;
-    startRunIndex: number;
-    startOffset: number;
-    endParagraphIndex: number;
-    endRunIndex: number;
-    endOffset: number;
-    isMultiParagraph: boolean;
+/**
+ * Manager Types
+ *
+ * Framework-agnostic interfaces for the editor's manager classes.
+ * @packageDocumentation
+ * @public
+ */
+/** Cell coordinates in a table */
+interface CellCoordinates {
+    tableIndex: number;
+    rowIndex: number;
+    columnIndex: number;
+}
+/** TableSelectionManager snapshot */
+interface TableSelectionSnapshot {
+    /** Currently selected cell, or null if no selection */
+    selectedCell: CellCoordinates | null;
+}
+/** Error severity levels */
+type ErrorSeverity = 'error' | 'warning' | 'info';
+/** Error notification */
+interface ErrorNotification {
+    id: string;
+    message: string;
+    severity: ErrorSeverity;
+    details?: string;
+    timestamp: number;
+    dismissed?: boolean;
+}
+/** ErrorManager snapshot */
+interface ErrorManagerSnapshot {
+    notifications: ErrorNotification[];
 }
+
 /**
- * Convert a CSS color string (rgb/rgba/hex) to a 6-char uppercase hex string.
+ * TableSelectionManager
+ *
+ * Framework-agnostic class for managing table cell selection state.
+ * Extracted from the React `useTableSelection` hook.
  *
- * NOTE: This differs from `colorResolver.rgbToHex(r, g, b)` which takes
- * numeric components. This function parses CSS color strings.
+ * Handles:
+ * - Cell selection via data-attribute queries on the DOM
+ * - Table document operations (add/delete rows/columns, merge/split)
+ *
+ * @remarks
+ * Tagged `@internal` post-1.0 cut. Adapters bind to this class today,
+ * but consumers should reach for `useTableSelection()` (React/Vue) instead
+ * of this raw subpath. The subpath stays in `package.json` `exports` for
+ * back-compat; expect it to move behind a public surface in a future major.
+ *
+ * @packageDocumentation
+ * @internal
  */
-declare function cssColorToHex(color: string): string | null;
-/** Extract formatting from an HTML element's computed styles. */
-declare function extractFormattingFromElement(element: HTMLElement): Run['formatting'];
-/** Get selected runs from the current DOM selection. */
-declare function getSelectionRuns(): Run[];
-/** Create a ClipboardSelection from the current DOM selection. */
-declare function createSelectionFromDOM(): ClipboardSelection | null;
-declare const rgbToHex: typeof cssColorToHex;
+
+/**
+ * Data attributes for table elements in the rendered DOM
+ * @internal
+ */
+declare const TABLE_DATA_ATTRIBUTES: {
+    readonly TABLE_INDEX: "data-table-index";
+    readonly ROW_INDEX: "data-row";
+    readonly COLUMN_INDEX: "data-col";
+    readonly TABLE_CELL: "data-table-cell";
+};
+/**
+ * Find table cell coordinates from a click target by walking up the DOM
+ * and reading data attributes.
+ * @internal
+ */
+declare function findTableFromClick(target: EventTarget | null, container?: HTMLElement | null): CellCoordinates | null;
+/**
+ * Get a table from the document by index.
+ * @internal
+ */
+declare function getTableFromDocument(doc: Document, tableIndex: number): Table | null;
+/**
+ * Update a table in the document immutably.
+ * @internal
+ */
+declare function updateTableInDocument(doc: Document, tableIndex: number, newTable: Table): Document;
+/**
+ * Delete a table from the document immutably.
+ * @internal
+ */
+declare function deleteTableFromDocument(doc: Document, tableIndex: number): Document;
+/** @internal */
+declare class TableSelectionManager extends Subscribable<TableSelectionSnapshot> {
+    constructor();
+    /** Select a specific cell. */
+    selectCell(coords: CellCoordinates): void;
+    /** Clear the current selection. */
+    clearSelection(): void;
+    /** Check if a specific cell is selected. */
+    isCellSelected(tableIndex: number, rowIndex: number, columnIndex: number): boolean;
+    /** Get the currently selected cell coordinates, or null. */
+    getSelectedCell(): CellCoordinates | null;
+}
 
 /**
  * ErrorManager
@@ -180,264 +239,12 @@ declare class ErrorManager extends Subscribable<ErrorManagerSnapshot> {
     private emitSnapshot;
 }
 
-/**
- * PluginLifecycleManager
- *
- * Framework-agnostic class for managing editor plugin lifecycle.
- * Extracted from React's `PluginHost.tsx`.
- *
- * Handles:
- * - Plugin initialization and state tracking
- * - Plugin state updates via `updateStates()`
- * - Plugin destroy/cleanup
- *
- * Does NOT handle (framework hosts are responsible for):
- * - CSS injection (use the exported `injectStyles` utility)
- * - DOM event listeners / dispatch wrapping
- */
-
-/** Inject CSS styles into the document head. Returns a cleanup function. */
-declare function injectStyles(pluginId: string, css: string): () => void;
-declare class PluginLifecycleManager extends Subscribable<PluginLifecycleSnapshot> {
-    private plugins;
-    private pluginStates;
-    private version;
-    constructor();
-    /**
-     * Initialize plugins with the adapter's current editor state.
-     * Calls `plugin.initialize(editorState)` for each plugin.
-     *
-     * Note: CSS injection and DOM event listeners are the responsibility
-     * of the framework-specific host (e.g. React PluginHost).
-     */
-    initialize(plugins: PluginLifecycleConfig[], editorState: unknown): void;
-    /**
-     * Update all plugin states by calling `onStateChange` on each plugin.
-     * Returns true if any plugin state changed.
-     */
-    updateStates(editorState: unknown): boolean;
-    /** Get plugin state by ID. */
-    getPluginState<T>(pluginId: string): T | undefined;
-    /** Set plugin state by ID. */
-    setPluginState<T>(pluginId: string, state: T): void;
-    /** Destroy all plugins and clean up. */
-    destroy(): void;
-    private destroyPlugins;
-    private emitSnapshot;
-}
-
-/**
- * LayoutCoordinator
- *
- * Framework-agnostic class coordinating the PM state → layout engine →
- * layout painter → selection overlay pipeline.
- *
- * Extracted from PagedEditor.tsx. Manages:
- * - Layout pipeline state (blocks, measures, layout)
- * - Selection state (selectionRects, caretPosition)
- * - Drag selection state
- * - Column resize state
- * - Image interaction state
- *
- * Usage with React:
- * ```ts
- * const snapshot = useSyncExternalStore(coordinator.subscribe, coordinator.getSnapshot);
- * ```
- *
- * NOTE: This class defines the state shape and subscription pattern.
- * Full integration with PagedEditor is done incrementally.
- */
-
-/** Selection rectangle for rendering selection overlays */
-interface SelectionRect {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    pageIndex: number;
-}
-/** Caret position for rendering the blinking cursor */
-interface CaretPosition {
-    x: number;
-    y: number;
-    height: number;
-    pageIndex: number;
-}
-/** Info about the currently selected/hovered image */
-interface ImageSelectionInfo {
-    pmPos: number;
-    pageIndex: number;
-    rect: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    widthEmu: number;
-    heightEmu: number;
-    isInline: boolean;
-}
-/** Column resize tracking state */
-interface ColumnResizeState {
-    isResizing: boolean;
-    startX: number;
-    columnIndex: number;
-    tablePmStart: number;
-    originalWidths: {
-        left: number;
-        right: number;
-    };
-}
-/** The full snapshot exposed to UI frameworks */
-interface LayoutCoordinatorSnapshot {
-    /** Computed page layout, null until first computation */
-    hasLayout: boolean;
-    /** Selection rectangles for range selection overlay */
-    selectionRects: SelectionRect[];
-    /** Caret position for cursor overlay */
-    caretPosition: CaretPosition | null;
-    /** Currently selected/hovered image */
-    selectedImageInfo: ImageSelectionInfo | null;
-    /** Whether the editor is focused */
-    isFocused: boolean;
-    /** Whether a text drag is in progress */
-    isDragging: boolean;
-    /** Whether a column resize is in progress */
-    isResizingColumn: boolean;
-    /** Whether an image interaction is in progress */
-    isImageInteracting: boolean;
-    /** Version counter — incremented on every state change */
-    version: number;
-}
-declare class LayoutCoordinator extends Subscribable<LayoutCoordinatorSnapshot> {
-    private _hasLayout;
-    private _selectionRects;
-    private _caretPosition;
-    private _isDragging;
-    private _dragAnchor;
-    private _columnResize;
-    private _selectedImageInfo;
-    private _isImageInteracting;
-    private _isFocused;
-    private _version;
-    constructor();
-    /** Notify that layout has been computed. */
-    setLayoutReady(hasLayout: boolean): void;
-    /** Update selection rectangles and caret position. */
-    updateSelection(selectionRects: SelectionRect[], caretPosition: CaretPosition | null): void;
-    /** Start a drag selection from the given PM anchor position. */
-    startDrag(anchor: number): void;
-    /** End drag selection. */
-    endDrag(): void;
-    /** Get the drag anchor position. */
-    getDragAnchor(): number | null;
-    /** Start resizing a table column. */
-    startColumnResize(tablePmStart: number, columnIndex: number, startX: number, originalWidths: {
-        left: number;
-        right: number;
-    }): void;
-    /** End column resize. */
-    endColumnResize(): void;
-    /** Get current column resize state. */
-    getColumnResize(): ColumnResizeState;
-    /** Set the currently selected image. */
-    setSelectedImage(imageInfo: ImageSelectionInfo | null): void;
-    /** Clear the image selection. */
-    clearSelectedImage(): void;
-    /** Set whether an image interaction (resize/move) is in progress. */
-    setImageInteracting(interacting: boolean): void;
-    /** Update focus state. */
-    setFocused(focused: boolean): void;
-    private emitSnapshot;
-}
-
-/**
- * EditorCoordinator
- *
- * Framework-agnostic class managing the document editor lifecycle:
- * - Document parsing and loading
- * - Font loading coordination
- * - Zoom level management
- * - Extension manager initialization
- * - Agent command execution
- *
- * Extracted from DocxEditor.tsx.
- *
- * Usage with React:
- * ```ts
- * const snapshot = useSyncExternalStore(coordinator.subscribe, coordinator.getSnapshot);
- * ```
- *
- * NOTE: This class defines the state shape and coordination logic.
- * Full integration with DocxEditor is done incrementally.
- */
-
-/** Editor loading state */
-type EditorLoadingState = 'idle' | 'parsing' | 'loading-fonts' | 'ready' | 'error';
-/** Configuration for EditorCoordinator */
-interface EditorCoordinatorOptions {
-    /** Initial zoom level (default: 1.0) */
-    initialZoom?: number;
-    /** Callback when the document changes */
-    onChange?: (document: Document) => void;
-    /** Callback when an error occurs */
-    onError?: (error: Error) => void;
-}
-/** The full snapshot exposed to UI frameworks */
-interface EditorCoordinatorSnapshot {
-    /** Current loading state */
-    loadingState: EditorLoadingState;
-    /** Error message if loadingState is 'error' */
-    parseError: string | null;
-    /** Whether the editor is ready for interaction */
-    isReady: boolean;
-    /** Current zoom level (1.0 = 100%) */
-    zoom: number;
-    /** Whether fonts have been loaded */
-    fontsLoaded: boolean;
-    /** Version counter */
-    version: number;
-}
-declare class EditorCoordinator extends Subscribable<EditorCoordinatorSnapshot> {
-    private _loadingState;
-    private _parseError;
-    private _zoom;
-    private _fontsLoaded;
-    private _document;
-    private _version;
-    private onChangeCallback?;
-    private onErrorCallback?;
-    constructor(options?: EditorCoordinatorOptions);
-    /** Signal that document parsing has started. */
-    setParsingStarted(): void;
-    /** Signal that document parsing completed successfully. */
-    setDocumentLoaded(document: Document): void;
-    /** Signal that font loading completed. */
-    setFontsLoaded(): void;
-    /** Signal that an error occurred during loading. */
-    setLoadError(error: Error): void;
-    /** Get the current document. */
-    getDocument(): Document | null;
-    /** Update the document (after edits). */
-    updateDocument(document: Document): void;
-    /** Set the zoom level (1.0 = 100%). */
-    setZoom(zoom: number): void;
-    /** Get the current zoom level. */
-    getZoom(): number;
-    private emitSnapshot;
-}
-
 /**
  * @betteroffice/docx (default entry point)
  *
- * Fat barrel that re-exports the parser, serializer, agent, plugin
- * registry, and the most-used types. No React/DOM imports.
- *
- * **When to import from `.` vs `./headless`:** identical for Node.js
- * use; `.` is the convenient aggregate, `./headless` is its mirror with
- * a slightly different name suffix. Adapter authors who only need a
- * specific slice should prefer the smaller subpaths (`./docx`, `./agent`,
- * `./prosemirror`, `./layout-*`, `./utils`) — they tree-shake better.
+ * Fat barrel that re-exports the parser, serializer, and the most-used types.
+ * No React/DOM imports. Adapter authors who only need a specific slice should
+ * prefer the smaller subpaths.
  *
  * @example
  * ```ts
@@ -448,4 +255,4 @@ declare class EditorCoordinator extends Subscribable<EditorCoordinatorSnapshot>
  */
 declare const VERSION = "0.0.2";
 
-export { type CaretPosition, type ClipboardSelection, type ColumnResizeState, Document, EditorCoordinator, type EditorCoordinatorOptions, type EditorCoordinatorSnapshot, type EditorLoadingState, ErrorManager, ErrorManagerSnapshot, type ImageSelectionInfo, LayoutCoordinator, type LayoutCoordinatorSnapshot, type ParagraphPositionNode, PluginLifecycleConfig, PluginLifecycleManager, PluginLifecycleSnapshot, type PrintOptions, Run, type SelectionRect, Subscribable, VERSION, createSelectionFromDOM, extractFormattingFromElement, findParagraphByParaId, findStartPosForParaId, formatPageRange, getDefaultPrintOptions, getSelectionRuns, injectStyles, isPrintSupported, openPrintWindow, parsePageRange, rgbToHex, triggerPrint };
+export { type CellCoordinates, Document, DocumentBody, ErrorManager, type ErrorManagerSnapshot, type ErrorNotification, type ErrorSeverity, type PrintOptions, SectionProperties, Subscribable, TABLE_DATA_ATTRIBUTES, Table, TableSelectionManager, type TableSelectionSnapshot, VERSION, deleteTableFromDocument, findTableFromClick, formatPageRange, getDefaultPrintOptions, getTableFromDocument, isPrintSupported, openPrintWindow, parsePageRange, serializeDocumentBody, serializeDocument as serializeDocx, serializeSectionProperties, triggerPrint, updateTableInDocument };

package/dist/core.mjs

@@ -1 +1 @@
-export{a as AutoSaveManager,b as formatLastSaveTime,e as formatStorageSize,c as getAutoSaveStatusLabel,d as getAutoSaveStorageSize,f as isAutoSaveSupported}from'./chunk-VCER63GQ.mjs';export{a as TABLE_DATA_ATTRIBUTES,f as TableSelectionManager,e as deleteTableFromDocument,b as findTableFromClick,c as getTableFromDocument,d as updateTableInDocument}from'./chunk-JY6ILTNS.mjs';import {a}from'./chunk-BI3B33LI.mjs';export{a as Subscribable}from'./chunk-BI3B33LI.mjs';export{a as FOOTNOTE_SEPARATOR_HEIGHT,c as MAX_FOOTNOTE_LAYOUT_PASSES,k as buildFootnoteContentMap,o as buildFootnoteRenderItems,m as calculateFootnoteReservedHeights,f as collectFootnoteRefs,t as convertHeaderFooterToContent,d as footnoteReservedHeightsEqual,g as mapFootnotesToPages,n as stabilizeFootnoteLayout}from'./chunk-P3KDV4M2.mjs';import'./chunk-7DEIW7FL.mjs';import'./chunk-IL5JZJT7.mjs';import'./chunk-GWKJ2Y4Y.mjs';import'./chunk-52GB3Y42.mjs';export{n as countPageBreaks,b as createColumnBreak,g as createHorizontalRule,c as createLineBreak,a as createPageBreak,e as createPageBreakParagraph,d as createPageBreakRun,o as findPageBreaks,m as hasPageBreakBefore,h as insertHorizontalRule,f as insertPageBreak,l as isBreakContent,j as isColumnBreak,k as isLineBreak,i as isPageBreak,p as removePageBreak}from'./chunk-34K66SY4.mjs';import'./chunk-7PCO5I2O.mjs';import'./chunk-X4XDO3LZ.mjs';export{b as createDocumentWithText,a as createEmptyDocument}from'./chunk-VAOUFAUH.mjs';export{j as colorsEqual,g as createRgbColor,f as createThemeColor,h as ensureHexPrefix,c as isBlack,d as isWhite,e as parseColorString,a as resolveHighlightColor,i as resolveHighlightToCss,b as resolveShadingColor}from'./chunk-L5ISVQ3W.mjs';export{b as docxtemplaterPlugin}from'./chunk-XYH6XWP3.mjs';export{e as getTemplateTags,a as processTemplate,c as processTemplateAsBlob,b as processTemplateDetailed,f as validateTemplate}from'./chunk-O2QSE2I7.mjs';import'./chunk-OMR3TWCD.mjs';import'./chunk-XWUOLYRQ.mjs';import'./chunk-HJGAQIU7.mjs';export{b as buildPatchedDocumentXml,a as validatePatchSafety}from'./chunk-KEE52TT5.mjs';export{i as blendColors,g as darkenColor,k as generateThemeTintShadeMatrix,f as getContrastingColor,j as getThemeTintShadeHex,h as lightenColor,d as resolveColor}from'./chunk-FZIA7OFY.mjs';import'./chunk-OBQGPMPQ.mjs';export{a as DocumentAgent,h as buildExtendedSelectionContext,g as buildSelectionContext,d as getAgentContext,f as getDocumentSummary}from'./chunk-XQBCCJBO.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-UIEJWORW.mjs';export{a as executeCommand,b as executeCommands}from'./chunk-6PW4CWUG.mjs';import'./chunk-KXNZFTTK.mjs';export{a as PluginRegistry,b as pluginRegistry,c as registerPlugins}from'./chunk-VBOTMRXV.mjs';export{a as attemptSelectiveSave}from'./chunk-OJOHXQNQ.mjs';export{s as createDocx,h as repackDocx,l as updateMultipleFiles}from'./chunk-KVKLLTDP.mjs';import'./chunk-BIQWVK5P.mjs';export{b as emuToPixels,i as emuToTwips,q as formatPx,k as halfPointsToPixels,c as pixelsToEmu,h as pixelsToTwips,d as pointsToPixels,j as twipsToEmu,g as twipsToPixels}from'./chunk-3UBMCDME.mjs';export{a as parseDocx}from'./chunk-LDUWIM7M.mjs';export{o as canRenderFont,l as getLoadedFonts,h as isFontLoaded,k as isFontsLoading,j as isGoogleFontsEnabled,f as loadFont,p as loadFontFromBuffer,g as loadFonts,m as onFontsLoaded,w as preloadCommonFonts,i as setGoogleFontsEnabled,a as toArrayBuffer}from'./chunk-DXKG3HQ5.mjs';import'./chunk-FPZBTOD6.mjs';import'./chunk-H3JCIGWK.mjs';export{c as serializeDocumentBody,b as serializeDocx,d as serializeSectionProperties}from'./chunk-N5Q3YN64.mjs';import'./chunk-SINEY6ZF.mjs';import'./chunk-T4EZMUXM.mjs';import {b as b$1}from'./chunk-TTRUPDAB.mjs';function kt(r,o){if(!o||!o.trim())return null;let e=null;return r.descendants((t,n)=>e!==null?false:t.attrs?.paraId===o&&t.isTextblock?(e=n,false):true),e}function zt(r,o){if(!o||!o.trim())return null;let e=null;return r.descendants((t,n)=>e!==null?false:t.isTextblock&&t.attrs?.paraId===o?(e={node:t,from:n,to:n+t.nodeSize},false):true),e}var Ot={includeHeaders:true,includeFooters:true,includePageNumbers:true,pageRange:null,scale:1,printBackground:true,margins:"default"};function Nt(){return {...Ot}}function wt(){typeof window<"u"&&window.print();}var Mt="@media print { body { margin: 0; padding: 0; } @page { margin: 0; } }";function Bt(r="Document",o){if(typeof window>"u")return null;let e=window.open("","_blank");if(!e)return null;e.opener=null;let t=e.document;t.title=r;let n=t.createElement("style");n.textContent=Mt,t.head.appendChild(n);let i=new DOMParser().parseFromString(o,"text/html");for(let s of Array.from(i.body.childNodes))t.body.appendChild(t.importNode(s,true));return e}function Ht(r,o){if(!r||!r.trim())return null;let e=r.trim();if(/^\d+$/.test(e)){let n=parseInt(e,10);return n>=1&&n<=o?{start:n,end:n}:null}let t=e.match(/^(\d+)-(\d+)$/);if(t){let n=parseInt(t[1],10),i=parseInt(t[2],10);if(n>=1&&i<=o&&n<=i)return {start:n,end:i}}return null}function Vt(r,o){return r?r.start===r.end?`Page ${r.start}`:`Pages ${r.start}-${r.end}`:`All (${o} pages)`}function Wt(){return typeof window<"u"&&typeof window.print=="function"}function k(r){if(!r||r==="transparent"||r==="inherit")return null;if(r.startsWith("#"))return r.slice(1).toUpperCase();let o=r.match(/rgba?\((\d+),\s*(\d+),\s*(\d+)/);if(o){let e=parseInt(o[1]).toString(16).padStart(2,"0"),t=parseInt(o[2]).toString(16).padStart(2,"0"),n=parseInt(o[3]).toString(16).padStart(2,"0");return (e+t+n).toUpperCase()}return null}function S(r){let o=window.getComputedStyle(r),e={};(o.fontWeight==="bold"||parseInt(o.fontWeight)>=700)&&(e.bold=true),o.fontStyle==="italic"&&(e.italic=true);let t=o.textDecoration||o.textDecorationLine;t&&t.includes("underline")&&(e.underline={style:"single"}),t&&t.includes("line-through")&&(e.strike=true);let n=parseFloat(o.fontSize);!isNaN(n)&&n>0&&(e.fontSize=Math.round(n/1.333*2));let i=o.fontFamily.replace(/["']/g,"").split(",")[0].trim();i&&(e.fontFamily={ascii:i});let s=o.color;if(s&&s!=="rgb(0, 0, 0)"){let m=k(s);m&&(e.color={rgb:m});}let l=o.backgroundColor;if(l&&l!=="transparent"&&l!=="rgba(0, 0, 0, 0)"){let m=x(l);m&&(e.shading={fill:{rgb:m}});}return Object.keys(e).length>0?e:void 0}function $t(r,o){let e=document.createRange();e.selectNodeContents(r);let t=o.compareBoundaryPoints(Range.START_TO_START,e)>=0&&o.compareBoundaryPoints(Range.START_TO_END,e)<=0,n=o.compareBoundaryPoints(Range.END_TO_START,e)>=0&&o.compareBoundaryPoints(Range.END_TO_END,e)<=0;if(t&&n)return o.toString();if(t){let i=document.createRange();return i.setStart(o.startContainer,o.startOffset),i.selectNodeContents(r),i.setEnd(e.endContainer,e.endOffset),i.toString()}else if(n){let i=document.createRange();return i.selectNodeContents(r),i.setEnd(o.endContainer,o.endOffset),i.setStart(e.startContainer,e.startOffset),i.toString()}else if(o.intersectsNode(r))return r.textContent||"";return ""}function A(r){let o=r;for(;o;){if(o.nodeType===Node.ELEMENT_NODE){let e=o;if(e.hasAttribute("data-paragraph-index"))return e}o=o.parentNode;}return null}function b(){let r=window.getSelection();if(!r||r.isCollapsed)return [];let o=[],e=r.getRangeAt(0),t=e.commonAncestorContainer,n=t.nodeType===Node.ELEMENT_NODE?t:t.parentElement;if(!n)return o;if(n.querySelectorAll(".docx-run").forEach(s=>{if(e.intersectsNode(s)){let l=$t(s,e);if(l){let m=S(s);o.push({type:"run",formatting:m,content:[{type:"text",text:l}]});}}}),o.length===0){let s=r.toString();s&&o.push({type:"run",content:[{type:"text",text:s}]});}return o}function z(){let r=window.getSelection();if(!r||r.isCollapsed)return null;let o=b();if(o.length===0)return null;let e=r.toString(),t=r.getRangeAt(0),n=A(t.startContainer),i=A(t.endContainer),s=n?parseInt(n.getAttribute("data-paragraph-index")||"0",10):0,l=i?parseInt(i.getAttribute("data-paragraph-index")||"0",10):0;return {text:e,runs:o,startParagraphIndex:s,startRunIndex:0,startOffset:t.startOffset,endParagraphIndex:l,endRunIndex:0,endOffset:t.endOffset,isMultiParagraph:s!==l}}var x=k;var p=class extends a{constructor(){super({notifications:[]});b$1(this,"notifications",[]);b$1(this,"idCounter",0);b$1(this,"timers",new Set);}showError(e,t){return this.addNotification(e,"error",t)}showWarning(e,t){return this.addNotification(e,"warning",t)}showInfo(e,t){return this.addNotification(e,"info",t)}dismiss(e){this.notifications=this.notifications.map(n=>n.id===e?{...n,dismissed:true}:n),this.emitSnapshot();let t=setTimeout(()=>{this.timers.delete(t),this.notifications=this.notifications.filter(n=>n.id!==e),this.emitSnapshot();},300);this.timers.add(t);}clearAll(){this.notifications=[];for(let e of this.timers)clearTimeout(e);this.timers.clear(),this.emitSnapshot();}destroy(){for(let e of this.timers)clearTimeout(e);this.timers.clear(),this.notifications=[];}addNotification(e,t,n){let i=`error-${++this.idCounter}-${Date.now()}`,s={id:i,message:e,severity:t,details:n,timestamp:Date.now()};if(this.notifications=[...this.notifications,s],this.emitSnapshot(),t!=="error"){let l=setTimeout(()=>{this.timers.delete(l),this.dismiss(i);},5e3);this.timers.add(l);}return i}emitSnapshot(){this.setSnapshot({notifications:this.notifications});}};function O(r,o){let e=`plugin-styles-${r}`,t=document.getElementById(e);t&&t.remove();let n=document.createElement("style");return n.id=e,n.textContent=o,document.head.appendChild(n),()=>{let i=document.getElementById(e);i&&i.remove();}}var g=class extends a{constructor(){super({states:new Map,version:0});b$1(this,"plugins",[]);b$1(this,"pluginStates",new Map);b$1(this,"version",0);}initialize(e,t){this.destroyPlugins(),this.plugins=e;for(let n of e)n.initialize&&!this.pluginStates.has(n.id)&&this.pluginStates.set(n.id,n.initialize(t));this.emitSnapshot();}updateStates(e){let t=false;for(let n of this.plugins)if(n.onStateChange){let i=n.onStateChange(e);i!==void 0&&(this.pluginStates.set(n.id,i),t=true);}return t&&(this.version++,this.emitSnapshot()),t}getPluginState(e){return this.pluginStates.get(e)}setPluginState(e,t){this.pluginStates.set(e,t),this.version++,this.emitSnapshot();}destroy(){this.destroyPlugins(),this.emitSnapshot();}destroyPlugins(){for(let e of this.plugins)e.destroy&&e.destroy();this.pluginStates.clear(),this.plugins=[];}emitSnapshot(){this.setSnapshot({states:new Map(this.pluginStates),version:this.version});}};var f=class extends a{constructor(){super({hasLayout:false,selectionRects:[],caretPosition:null,selectedImageInfo:null,isFocused:false,isDragging:false,isResizingColumn:false,isImageInteracting:false,version:0});b$1(this,"_hasLayout",false);b$1(this,"_selectionRects",[]);b$1(this,"_caretPosition",null);b$1(this,"_isDragging",false);b$1(this,"_dragAnchor",null);b$1(this,"_columnResize",{isResizing:false,startX:0,columnIndex:0,tablePmStart:0,originalWidths:{left:0,right:0}});b$1(this,"_selectedImageInfo",null);b$1(this,"_isImageInteracting",false);b$1(this,"_isFocused",false);b$1(this,"_version",0);}setLayoutReady(e){this._hasLayout=e,this.emitSnapshot();}updateSelection(e,t){this._selectionRects=e,this._caretPosition=t,this.emitSnapshot();}startDrag(e){this._isDragging=true,this._dragAnchor=e,this.emitSnapshot();}endDrag(){this._isDragging=false,this._dragAnchor=null,this.emitSnapshot();}getDragAnchor(){return this._dragAnchor}startColumnResize(e,t,n,i){this._columnResize={isResizing:true,startX:n,columnIndex:t,tablePmStart:e,originalWidths:i},this.emitSnapshot();}endColumnResize(){this._columnResize={...this._columnResize,isResizing:false},this.emitSnapshot();}getColumnResize(){return this._columnResize}setSelectedImage(e){this._selectedImageInfo=e,this.emitSnapshot();}clearSelectedImage(){this._selectedImageInfo=null,this._isImageInteracting=false,this.emitSnapshot();}setImageInteracting(e){this._isImageInteracting=e,this.emitSnapshot();}setFocused(e){this._isFocused=e,this.emitSnapshot();}emitSnapshot(){this._version++,this.setSnapshot({hasLayout:this._hasLayout,selectionRects:this._selectionRects,caretPosition:this._caretPosition,selectedImageInfo:this._selectedImageInfo,isFocused:this._isFocused,isDragging:this._isDragging,isResizingColumn:this._columnResize.isResizing,isImageInteracting:this._isImageInteracting,version:this._version});}};var h=class extends a{constructor(e={}){let t=e.initialZoom??1;super({loadingState:"idle",parseError:null,isReady:false,zoom:t,fontsLoaded:false,version:0});b$1(this,"_loadingState","idle");b$1(this,"_parseError",null);b$1(this,"_zoom");b$1(this,"_fontsLoaded",false);b$1(this,"_document",null);b$1(this,"_version",0);b$1(this,"onChangeCallback");b$1(this,"onErrorCallback");this._zoom=t,this.onChangeCallback=e.onChange,this.onErrorCallback=e.onError;}setParsingStarted(){this._loadingState="parsing",this._parseError=null,this.emitSnapshot();}setDocumentLoaded(e){this._document=e,this._loadingState="loading-fonts",this._parseError=null,this.emitSnapshot();}setFontsLoaded(){this._fontsLoaded=true,this._loadingState="ready",this.emitSnapshot();}setLoadError(e){this._loadingState="error",this._parseError=e.message,this.onErrorCallback?.(e),this.emitSnapshot();}getDocument(){return this._document}updateDocument(e){this._document=e,this.onChangeCallback?.(e),this.emitSnapshot();}setZoom(e){this._zoom=Math.max(.25,Math.min(4,e)),this.emitSnapshot();}getZoom(){return this._zoom}emitSnapshot(){this._version++,this.setSnapshot({loadingState:this._loadingState,parseError:this._parseError,isReady:this._loadingState==="ready",zoom:this._zoom,fontsLoaded:this._fontsLoaded,version:this._version});}};var vo="0.0.2";export{h as EditorCoordinator,p as ErrorManager,f as LayoutCoordinator,g as PluginLifecycleManager,vo as VERSION,z as createSelectionFromDOM,S as extractFormattingFromElement,zt as findParagraphByParaId,kt as findStartPosForParaId,Vt as formatPageRange,Nt as getDefaultPrintOptions,b as getSelectionRuns,O as injectStyles,Wt as isPrintSupported,Bt as openPrintWindow,Ht as parsePageRange,x as rgbToHex,wt as triggerPrint};
+export{i as attemptSelectiveSave,h as createDocx,a as parseDocx,f as repackDocx,c as serializeDocumentBody,b as serializeDocx,d as serializeSectionProperties,g as updateMultipleFiles}from'./chunk-AEQOEQJ7.mjs';export{f as blendColors,r as colorsEqual,o as createRgbColor,n as createThemeColor,d as darkenColor,p as ensureHexPrefix,h as generateThemeTintShadeMatrix,c as getContrastingColor,g as getThemeTintShadeHex,k as isBlack,l as isWhite,e as lightenColor,m as parseColorString,a as resolveColor,i as resolveHighlightColor,q as resolveHighlightToCss,j as resolveShadingColor}from'./chunk-IFT6DUJX.mjs';export{b as emuToPixels,i as emuToTwips,q as formatPx,k as halfPointsToPixels,c as pixelsToEmu,h as pixelsToTwips,d as pointsToPixels,j as twipsToEmu,g as twipsToPixels}from'./chunk-3UBMCDME.mjs';export{o as canRenderFont,l as getLoadedFonts,h as isFontLoaded,k as isFontsLoading,j as isGoogleFontsEnabled,f as loadFont,p as loadFontFromBuffer,g as loadFonts,m as onFontsLoaded,w as preloadCommonFonts,i as setGoogleFontsEnabled,a as toArrayBuffer}from'./chunk-AZ52IWB6.mjs';import'./chunk-NJHOPXZW.mjs';import'./chunk-B4IR6YP4.mjs';import'./chunk-T4EZMUXM.mjs';import {b as b$1}from'./chunk-TTRUPDAB.mjs';var ce={includeHeaders:true,includeFooters:true,includePageNumbers:true,pageRange:null,scale:1,printBackground:true,margins:"default"};function me(){return {...ce}}function de(){typeof window<"u"&&window.print();}var fe="@media print { body { margin: 0; padding: 0; } @page { margin: 0; } }";function ge(t="Document",r){if(typeof window>"u")return null;let e=window.open("","_blank");if(!e)return null;e.opener=null;let n=e.document;n.title=t;let o=n.createElement("style");o.textContent=fe,n.head.appendChild(o);let i=new DOMParser().parseFromString(r,"text/html");for(let l of Array.from(i.body.childNodes))n.body.appendChild(n.importNode(l,true));return e}function he(t,r){if(!t||!t.trim())return null;let e=t.trim();if(/^\d+$/.test(e)){let o=parseInt(e,10);return o>=1&&o<=r?{start:o,end:o}:null}let n=e.match(/^(\d+)-(\d+)$/);if(n){let o=parseInt(n[1],10),i=parseInt(n[2],10);if(o>=1&&i<=r&&o<=i)return {start:o,end:i}}return null}function Te(t,r){return t?t.start===t.end?`Page ${t.start}`:`Pages ${t.start}-${t.end}`:`All (${r} pages)`}function be(){return typeof window<"u"&&typeof window.print=="function"}var s=class{constructor(r){b$1(this,"listeners",new Set);b$1(this,"snapshot");b$1(this,"subscribe",r=>(this.listeners.add(r),()=>{this.listeners.delete(r);}));b$1(this,"getSnapshot",()=>this.snapshot);this.snapshot=r;}setSnapshot(r){this.snapshot=r,this.notify();}notify(){for(let r of this.listeners)r();}};var c={TABLE_INDEX:"data-table-index",ROW_INDEX:"data-row",COLUMN_INDEX:"data-col",TABLE_CELL:"data-table-cell"};function g(t,r){if(!(t instanceof Element))return null;let e=t;for(;e&&e!==r;){if(e.tagName==="TD"||e.tagName==="TH"){let n=e.getAttribute(c.ROW_INDEX),o=e.getAttribute(c.COLUMN_INDEX);if(n!==null&&o!==null){let i=e;for(;i&&i!==r;){if(i.tagName==="TABLE"){let l=i.getAttribute(c.TABLE_INDEX);if(l!==null)return {tableIndex:parseInt(l,10),rowIndex:parseInt(n,10),columnIndex:parseInt(o,10)};break}i=i.parentElement;}}break}e=e.parentElement;}return null}function h(t,r){if(!t.package?.document?.content)return null;let e=0;for(let n of t.package.document.content)if(n.type==="table"){if(e===r)return n;e++;}return null}function T(t,r,e){if(!t.package?.document?.content)return t;let n=0,o=t.package.document.content.map(i=>{if(i.type==="table"){if(n===r)return n++,e;n++;}return i});return {...t,package:{...t.package,document:{...t.package.document,content:o}}}}function b(t,r){if(!t.package?.document?.content)return t;let e=0,n=t.package.document.content.filter(o=>{if(o.type==="table"){let i=e===r;return e++,!i}return  true});return {...t,package:{...t.package,document:{...t.package.document,content:n}}}}var m=class extends s{constructor(){super({selectedCell:null});}selectCell(r){this.setSnapshot({selectedCell:r});}clearSelection(){this.setSnapshot({selectedCell:null});}isCellSelected(r,e,n){let{selectedCell:o}=this.getSnapshot();return o?o.tableIndex===r&&o.rowIndex===e&&o.columnIndex===n:false}getSelectedCell(){return this.getSnapshot().selectedCell}};var d=class extends s{constructor(){super({notifications:[]});b$1(this,"notifications",[]);b$1(this,"idCounter",0);b$1(this,"timers",new Set);}showError(e,n){return this.addNotification(e,"error",n)}showWarning(e,n){return this.addNotification(e,"warning",n)}showInfo(e,n){return this.addNotification(e,"info",n)}dismiss(e){this.notifications=this.notifications.map(o=>o.id===e?{...o,dismissed:true}:o),this.emitSnapshot();let n=setTimeout(()=>{this.timers.delete(n),this.notifications=this.notifications.filter(o=>o.id!==e),this.emitSnapshot();},300);this.timers.add(n);}clearAll(){this.notifications=[];for(let e of this.timers)clearTimeout(e);this.timers.clear(),this.emitSnapshot();}destroy(){for(let e of this.timers)clearTimeout(e);this.timers.clear(),this.notifications=[];}addNotification(e,n,o){let i=`error-${++this.idCounter}-${Date.now()}`,l={id:i,message:e,severity:n,details:o,timestamp:Date.now()};if(this.notifications=[...this.notifications,l],this.emitSnapshot(),n!=="error"){let f=setTimeout(()=>{this.timers.delete(f),this.dismiss(i);},5e3);this.timers.add(f);}return i}emitSnapshot(){this.setSnapshot({notifications:this.notifications});}};var Me="0.0.2";export{d as ErrorManager,s as Subscribable,c as TABLE_DATA_ATTRIBUTES,m as TableSelectionManager,Me as VERSION,b as deleteTableFromDocument,g as findTableFromClick,Te as formatPageRange,me as getDefaultPrintOptions,h as getTableFromDocument,be as isPrintSupported,ge as openPrintWindow,he as parsePageRange,de as triggerPrint,T as updateTableInDocument};

package/dist/{displayListQueries-p-ijSzdh.d.mts → displayListQueries-BJlo7Jkz.d.mts}

@@ -1,4 +1,5 @@
-import { I as ImagePrimitive, D as DisplayList, R as RustDisplayListQueryEngine } from './rustDisplayList-dqunvwxH.mjs';
+import { I as ImagePrimitive, D as DisplayList } from './frameDelta-D965X8yK.mjs';
+import { R as RustDisplayListQueryEngine } from './rustDisplayList-BRuZBqdL.mjs';
 
 /**
  * Locate an image primitive in a built DisplayList by its document position.
@@ -59,10 +60,14 @@ declare function captureInlinePositionEmuFromDisplayList(queries: DisplayListQue
  * facade parses the display list into the Rust store exactly ONCE
  * (`openDisplayList` → handle) and routes every hit-test / range-rect query
  * through the by-handle exports — no per-query re-serialization or re-parse.
- * When those exports are absent (before the integrator re-embeds the wasm) it
- * falls back to the JSON-arg exports, stringifying the list once and reusing
- * the string for every query. Either way the query RESULTS are byte-identical —
- * the handle path is pure perf.
+ * The handle is acquired LAZILY: at the first query that needs it, or when the
+ * host calls `prime()` from idle time. Keystroke-driven facade replacement
+ * therefore costs no serialization on the input path; superseded generations
+ * chain their adoption donor so a deferred pickup still ships one page-delta
+ * instead of a full re-open. When the session exports are absent (before the
+ * integrator re-embeds the wasm) it falls back to the JSON-arg exports,
+ * stringifying the list once and reusing the string for every query. Either
+ * way the query RESULTS are byte-identical — the handle path is pure perf.
  *
  * Handle lifecycle: the handle is opened once per facade (per display-list
  * build) and released by `dispose()`. Callers that drop the facade without
@@ -204,6 +209,13 @@ interface DisplayListQueries {
     anchorRect(pos: number): DisplayListRect | null;
     /** Explicit body-sidebar alias retained alongside `anchorRect`. */
     sidebarAnchorRect(pos: number): DisplayListRect | null;
+    /**
+     * Acquire the Rust session handle now (adopting the donor facade's parsed
+     * list when possible). Optional: the first query acquires it on demand;
+     * hosts call this from idle time to keep serialization off interaction
+     * paths. No-op once attempted, superseded, or disposed.
+     */
+    prime(): void;
     /**
      * Release the wasm session handle backing this facade. Idempotent; safe to
      * call even when no handle was opened (JSON-arg fallback path). Callers that
@@ -216,7 +228,13 @@ interface DisplayListQueries {
  * Build a query facade for one display list. The optional `engine` makes the
  * facade synchronous and deterministic in tests; without it the shared wasm
  * module is loaded lazily and queries no-op (`null`/`[]`) until it resolves.
+ *
+ * `previous` (the facade this build replaces) enables handle adoption: instead
+ * of re-serializing and re-parsing the WHOLE list into the Rust store, the new
+ * facade takes over the previous parsed list and patches only the pages that
+ * changed. The donor facade's remaining queries degrade to its own JSON-arg
+ * path (same stale-list semantics it always had after replacement).
  */
-declare function createDisplayListQueries(list: DisplayList, engine?: RustDisplayListQueryEngine | ResidentDisplayListQueryEngine): DisplayListQueries;
+declare function createDisplayListQueries(list: DisplayList, engine?: RustDisplayListQueryEngine | ResidentDisplayListQueryEngine, previous?: DisplayListQueries | null): DisplayListQueries;
 
 export { type DisplayListRect as D, type LocatedImagePrimitive as L, type ResidentDisplayListQueryEngine as R, type DisplayListQueries as a, type DisplayListRegionHit as b, type DisplayListHitRegion as c, type DisplayListImageGeometry as d, type DisplayListImageRegion as e, type DisplayListParagraphGeometry as f, type DisplayListQuerySourceState as g, type DisplayListVisualLine as h, captureInlinePositionEmuFromDisplayList as i, createDisplayListQueries as j, findImagePrimitiveAtPoint as k, findImagePrimitiveByDocPos as l };