@eigenpal/docx-js-editor 0.0.2 → 0.0.4

package/dist/index.d.cts

@@ -1,10 +1,10 @@
 import * as prosemirror_view from 'prosemirror-view';
 import { EditorView, DecorationSet } from 'prosemirror-view';
 import * as prosemirror_state from 'prosemirror-state';
-import { EditorState, Command, Plugin, PluginKey } from 'prosemirror-state';
+import { Plugin, EditorState, Transaction, PluginKey } from 'prosemirror-state';
 import * as React$1 from 'react';
 import React__default, { CSSProperties, ReactNode, Component, ErrorInfo } from 'react';
-import { T as TextFormatting, e as Paragraph, f as Table, a1 as SectionProperties, an as HeaderFooter, h as Document, ab as Theme, U as ParagraphFormatting, a2 as SelectionContext, a8 as TableCell, ao as ParagraphAlignment, a4 as Style, A as AIAction, l as AgentResponse, ap as StyleType, aq as BorderSpec, ar as ShadingProperties, R as Run, as as BreakContent, $ as RunContent } from './types-BJXChtaM.cjs';
+import { T as TextFormatting, e as Paragraph, f as Table, a1 as SectionProperties, an as HeaderFooter, h as Document, ab as Theme, U as ParagraphFormatting, a8 as TableCell, ao as ParagraphAlignment, a4 as Style, a2 as SelectionContext, A as AIAction, l as AgentResponse, ap as StyleType, aq as BorderSpec, ar as ShadingProperties, R as Run, as as BreakContent, $ as RunContent } from './types-BJXChtaM.cjs';
 export { i as AIActionRequest, j as AgentCommand, k as AgentContext, m as ApplyStyleCommand, B as BlockContent, at as BookmarkEnd, au as BookmarkStart, C as CorePlugin, q as DeleteTextCommand, D as DocumentBody, r as DocxPackage, E as Endnote, av as Field, aw as FooterReference, F as Footnote, t as FormatTextCommand, ax as HeaderReference, H as Hyperlink, I as Image, u as InsertHyperlinkCommand, v as InsertImageCommand, w as InsertTableCommand, x as InsertTextCommand, L as ListLevel, d as McpSession, M as McpToolDefinition, N as McpToolHandler, O as McpToolResult, Q as NumberingDefinitions, S as ParagraphContext, g as Position, Y as Range, Z as Relationship, _ as ReplaceTextCommand, a3 as SetVariableCommand, ay as Shape, a5 as StyleDefinitions, a7 as SuggestedAction, a9 as TableRow, az as TextBox, aa as TextContent, aA as ThemeColorScheme, aB as ThemeFont, aC as ThemeFontScheme } from './types-BJXChtaM.cjs';
 import { D as DocumentAgent } from './colorResolver-C-tITrbI.cjs';
 export { A as AgentContextOptions, C as CreateEmptyDocumentOptions, E as ExtendedSelectionContext, P as ProcessTemplateOptions, e as ProcessTemplateResult, f as SelectionContextOptions, g as blendColors, h as buildExtendedSelectionContext, i as buildSelectionContext, k as colorsEqual, n as createDocumentWithText, o as createEmptyDocument, p as createRgbColor, r as createThemeColor, s as darkenColor, t as emuToPixels, u as emuToTwips, v as executeCommand, w as executeCommands, x as formatPx, y as getAgentContext, z as getContrastingColor, B as getDocumentSummary, J as getTemplateTags, K as halfPointsToPixels, L as isBlack, M as isWhite, N as lightenColor, O as parseColorString, Q as parseDocx, R as pixelsToEmu, U as pixelsToTwips, V as pointsToPixels, X as processTemplate, Z as processTemplateAsBlob, _ as processTemplateDetailed, $ as resolveColor, a0 as resolveHighlightColor, a1 as resolveShadingColor, a2 as serializeDocumentBody, a3 as serializeDocx, a4 as serializeSectionProperties, a5 as twipsToEmu, a6 as twipsToPixels, a7 as validateTemplate } from './colorResolver-C-tITrbI.cjs';
@@ -245,7 +245,7 @@ interface Line {
 /**
  * A laid out page
  */
-interface Page {
+interface Page$1 {
     /** Page number (1-indexed) */
     pageNumber: number;
     /** Section this page belongs to */
@@ -303,7 +303,7 @@ interface PageContent {
  */
 interface PageLayoutResult {
     /** All pages */
-    pages: Page[];
+    pages: Page$1[];
     /** Total page count */
     totalPages: number;
     /** Page number field values by location */
@@ -429,6 +429,12 @@ declare function formatPageRange(range: {
  */
 declare function isPrintSupported(): boolean;
 
+/**
+ * Selection State Utilities
+ *
+ * Extracts selection state from ProseMirror for toolbar integration.
+ */
+
 /**
  * Selection state for toolbar integration
  */
@@ -448,39 +454,162 @@ interface SelectionState {
     /** End paragraph index */
     endParagraphIndex: number;
 }
+
 /**
- * Ref interface for external control
+ * Layout Engine Types
+ *
+ * Core types for the paginated layout engine.
+ * Converts document blocks + measurements into positioned fragments on pages.
  */
-interface ProseMirrorEditorRef {
-    /** Focus the editor */
-    focus: () => void;
-    /** Blur the editor */
-    blur: () => void;
-    /** Get the current ProseMirror state */
-    getState: () => EditorState | null;
-    /** Get the current ProseMirror view */
-    getView: () => EditorView | null;
-    /** Undo the last change */
-    undo: () => boolean;
-    /** Redo the last undone change */
-    redo: () => boolean;
-    /** Check if undo is available */
-    canUndo: () => boolean;
-    /** Check if redo is available */
-    canRedo: () => boolean;
-    /** Execute a ProseMirror command */
-    executeCommand: (command: Command) => boolean;
-    /** Toggle bold mark */
-    toggleBold: () => boolean;
-    /** Toggle italic mark */
-    toggleItalic: () => boolean;
-    /** Toggle underline mark */
-    toggleUnderline: () => boolean;
-    /** Get the current Document from PM state */
-    getDocument: () => Document | null;
-    /** Get selection context for AI features */
-    getSelectionContext: () => SelectionContext | null;
-}
+/**
+ * Unique identifier for a block in the document.
+ * Format: typically `${index}-${type}` or just the block index.
+ */
+type BlockId = string | number;
+/**
+ * Base fragment properties common to all fragment types.
+ */
+type FragmentBase = {
+    /** Block ID this fragment belongs to. */
+    blockId: BlockId;
+    /** X position on page (relative to page left). */
+    x: number;
+    /** Y position on page (relative to page top). */
+    y: number;
+    /** Width of the fragment. */
+    width: number;
+    /** ProseMirror start position (for click mapping). */
+    pmStart?: number;
+    /** ProseMirror end position (for click mapping). */
+    pmEnd?: number;
+};
+/**
+ * A paragraph fragment positioned on a page.
+ * May span only part of the paragraph's lines if split across pages.
+ */
+type ParagraphFragment = FragmentBase & {
+    kind: 'paragraph';
+    /** First line index (inclusive) from the measure. */
+    fromLine: number;
+    /** Last line index (exclusive) from the measure. */
+    toLine: number;
+    /** Height of this fragment. */
+    height: number;
+    /** True if this continues from a previous page. */
+    continuesFromPrev?: boolean;
+    /** True if this continues onto the next page. */
+    continuesOnNext?: boolean;
+};
+/**
+ * A table fragment positioned on a page.
+ * May span only part of the table's rows if split across pages.
+ */
+type TableFragment = FragmentBase & {
+    kind: 'table';
+    /** First row index (inclusive). */
+    fromRow: number;
+    /** Last row index (exclusive). */
+    toRow: number;
+    /** Height of this fragment. */
+    height: number;
+    /** True if this continues from a previous page. */
+    continuesFromPrev?: boolean;
+    /** True if this continues onto the next page. */
+    continuesOnNext?: boolean;
+};
+/**
+ * An image fragment positioned on a page.
+ */
+type ImageFragment = FragmentBase & {
+    kind: 'image';
+    /** Height of the image. */
+    height: number;
+    /** True if this is an anchored/floating image. */
+    isAnchored?: boolean;
+    /** Z-index for layering. */
+    zIndex?: number;
+};
+/**
+ * Union of all fragment types.
+ */
+type Fragment = ParagraphFragment | TableFragment | ImageFragment;
+/**
+ * Page margin configuration.
+ */
+type PageMargins = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    /** Distance from page top to header content. */
+    header?: number;
+    /** Distance from page bottom to footer content. */
+    footer?: number;
+};
+/**
+ * A rendered page containing positioned fragments.
+ */
+type Page = {
+    /** Page number (1-indexed). */
+    number: number;
+    /** Fragments positioned on this page. */
+    fragments: Fragment[];
+    /** Page margins. */
+    margins: PageMargins;
+    /** Page size (width, height). */
+    size: {
+        w: number;
+        h: number;
+    };
+    /** Page orientation. */
+    orientation?: 'portrait' | 'landscape';
+    /** Section index this page belongs to. */
+    sectionIndex?: number;
+    /** Header/footer references for this page. */
+    headerFooterRefs?: {
+        headerDefault?: string;
+        headerFirst?: string;
+        headerEven?: string;
+        footerDefault?: string;
+        footerFirst?: string;
+        footerEven?: string;
+    };
+};
+/**
+ * Column layout configuration.
+ */
+type ColumnLayout = {
+    count: number;
+    gap: number;
+    equalWidth?: boolean;
+};
+/**
+ * Header/footer layout for a specific type.
+ */
+type HeaderFooterLayout = {
+    height: number;
+    fragments: Fragment[];
+};
+/**
+ * Final layout output ready for rendering/painting.
+ */
+type Layout = {
+    /** Default page size for the document. */
+    pageSize: {
+        w: number;
+        h: number;
+    };
+    /** All rendered pages with positioned fragments. */
+    pages: Page[];
+    /** Column configuration (if multi-column). */
+    columns?: ColumnLayout;
+    /** Header layouts by type (default, first, even). */
+    headers?: Record<string, HeaderFooterLayout>;
+    /** Footer layouts by type (default, first, even). */
+    footers?: Record<string, HeaderFooterLayout>;
+    /** Gap between pages in pixels (for rendering). */
+    pageGap?: number;
+};
 
 /**
  * Generic Plugin Interface for the DOCX Editor
@@ -711,6 +840,49 @@ interface PluginHostRef {
     refreshPluginStates: () => void;
 }
 
+/**
+ * PagedEditor Component
+ *
+ * Main paginated editing component that integrates:
+ * - HiddenProseMirror: off-screen editor for keyboard input
+ * - Layout engine: computes page layout from PM state
+ * - DOM painter: renders pages to visible DOM
+ * - Selection overlay: renders caret and selection highlights
+ *
+ * Architecture:
+ * 1. User clicks on visible pages → hit test → update PM selection
+ * 2. User types → hidden PM receives input → PM transaction
+ * 3. PM transaction → convert to blocks → measure → layout → paint
+ * 4. Selection changes → compute rects → update overlay
+ */
+
+interface PagedEditorRef {
+    /** Get the current document. */
+    getDocument(): Document | null;
+    /** Get the ProseMirror EditorState. */
+    getState(): EditorState | null;
+    /** Get the ProseMirror EditorView. */
+    getView(): EditorView | null;
+    /** Focus the editor. */
+    focus(): void;
+    /** Blur the editor. */
+    blur(): void;
+    /** Check if focused. */
+    isFocused(): boolean;
+    /** Dispatch a transaction. */
+    dispatch(tr: Transaction): void;
+    /** Undo. */
+    undo(): boolean;
+    /** Redo. */
+    redo(): boolean;
+    /** Set selection by PM position. */
+    setSelection(anchor: number, head?: number): void;
+    /** Get current layout. */
+    getLayout(): Layout | null;
+    /** Force re-layout. */
+    relayout(): void;
+}
+
 /**
  * DocxEditor props
  */
@@ -787,12 +959,6 @@ interface DocxEditorProps {
     onCut?: () => void;
     /** Callback when content is pasted */
     onPaste?: () => void;
-    /**
-     * Use paginated editor mode (experimental).
-     * When enabled, shows true paginated editing with visible page breaks.
-     * When disabled (default), uses standard ProseMirror editor.
-     */
-    usePaginatedEditor?: boolean;
     /**
      * Callback when rendered DOM context is ready (for plugin overlays).
      * Used by PluginHost to get access to the rendered page DOM for positioning.
@@ -812,8 +978,8 @@ interface DocxEditorRef {
     getAgent: () => DocumentAgent | null;
     /** Get the current document */
     getDocument: () => Document | null;
-    /** Get the ProseMirror editor ref */
-    getEditorRef: () => ProseMirrorEditorRef | null;
+    /** Get the editor ref */
+    getEditorRef: () => PagedEditorRef | null;
     /** Save the document to buffer */
     save: () => Promise<ArrayBuffer | null>;
     /** Set zoom level */
@@ -1380,7 +1546,7 @@ interface DocumentViewerProps {
     /** Callback when page becomes visible */
     onPageVisible?: (pageNumber: number) => void;
     /** Callback when document is clicked */
-    onDocumentClick?: (e: React__default.MouseEvent, page: Page | null) => void;
+    onDocumentClick?: (e: React__default.MouseEvent, page: Page$1 | null) => void;
     /** Additional CSS class name */
     className?: string;
     /** Additional inline styles */
@@ -2514,7 +2680,7 @@ interface ResponsiveToolbarProps {
  */
 interface UseResponsiveToolbarOptions {
     /** Container ref */
-    containerRef: React__default.RefObject<HTMLElement>;
+    containerRef: React__default.RefObject<HTMLElement | null>;
     /** Total items */
     items: ToolbarItem[];
     /** Gap between items */

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import * as prosemirror_view from 'prosemirror-view';
 import { EditorView, DecorationSet } from 'prosemirror-view';
 import * as prosemirror_state from 'prosemirror-state';
-import { EditorState, Command, Plugin, PluginKey } from 'prosemirror-state';
+import { Plugin, EditorState, Transaction, PluginKey } from 'prosemirror-state';
 import * as React$1 from 'react';
 import React__default, { CSSProperties, ReactNode, Component, ErrorInfo } from 'react';
-import { T as TextFormatting, e as Paragraph, f as Table, a1 as SectionProperties, an as HeaderFooter, h as Document, ab as Theme, U as ParagraphFormatting, a2 as SelectionContext, a8 as TableCell, ao as ParagraphAlignment, a4 as Style, A as AIAction, l as AgentResponse, ap as StyleType, aq as BorderSpec, ar as ShadingProperties, R as Run, as as BreakContent, $ as RunContent } from './types-BJXChtaM.js';
+import { T as TextFormatting, e as Paragraph, f as Table, a1 as SectionProperties, an as HeaderFooter, h as Document, ab as Theme, U as ParagraphFormatting, a8 as TableCell, ao as ParagraphAlignment, a4 as Style, a2 as SelectionContext, A as AIAction, l as AgentResponse, ap as StyleType, aq as BorderSpec, ar as ShadingProperties, R as Run, as as BreakContent, $ as RunContent } from './types-BJXChtaM.js';
 export { i as AIActionRequest, j as AgentCommand, k as AgentContext, m as ApplyStyleCommand, B as BlockContent, at as BookmarkEnd, au as BookmarkStart, C as CorePlugin, q as DeleteTextCommand, D as DocumentBody, r as DocxPackage, E as Endnote, av as Field, aw as FooterReference, F as Footnote, t as FormatTextCommand, ax as HeaderReference, H as Hyperlink, I as Image, u as InsertHyperlinkCommand, v as InsertImageCommand, w as InsertTableCommand, x as InsertTextCommand, L as ListLevel, d as McpSession, M as McpToolDefinition, N as McpToolHandler, O as McpToolResult, Q as NumberingDefinitions, S as ParagraphContext, g as Position, Y as Range, Z as Relationship, _ as ReplaceTextCommand, a3 as SetVariableCommand, ay as Shape, a5 as StyleDefinitions, a7 as SuggestedAction, a9 as TableRow, az as TextBox, aa as TextContent, aA as ThemeColorScheme, aB as ThemeFont, aC as ThemeFontScheme } from './types-BJXChtaM.js';
 import { D as DocumentAgent } from './colorResolver-Yakhydrt.js';
 export { A as AgentContextOptions, C as CreateEmptyDocumentOptions, E as ExtendedSelectionContext, P as ProcessTemplateOptions, e as ProcessTemplateResult, f as SelectionContextOptions, g as blendColors, h as buildExtendedSelectionContext, i as buildSelectionContext, k as colorsEqual, n as createDocumentWithText, o as createEmptyDocument, p as createRgbColor, r as createThemeColor, s as darkenColor, t as emuToPixels, u as emuToTwips, v as executeCommand, w as executeCommands, x as formatPx, y as getAgentContext, z as getContrastingColor, B as getDocumentSummary, J as getTemplateTags, K as halfPointsToPixels, L as isBlack, M as isWhite, N as lightenColor, O as parseColorString, Q as parseDocx, R as pixelsToEmu, U as pixelsToTwips, V as pointsToPixels, X as processTemplate, Z as processTemplateAsBlob, _ as processTemplateDetailed, $ as resolveColor, a0 as resolveHighlightColor, a1 as resolveShadingColor, a2 as serializeDocumentBody, a3 as serializeDocx, a4 as serializeSectionProperties, a5 as twipsToEmu, a6 as twipsToPixels, a7 as validateTemplate } from './colorResolver-Yakhydrt.js';
@@ -245,7 +245,7 @@ interface Line {
 /**
  * A laid out page
  */
-interface Page {
+interface Page$1 {
     /** Page number (1-indexed) */
     pageNumber: number;
     /** Section this page belongs to */
@@ -303,7 +303,7 @@ interface PageContent {
  */
 interface PageLayoutResult {
     /** All pages */
-    pages: Page[];
+    pages: Page$1[];
     /** Total page count */
     totalPages: number;
     /** Page number field values by location */
@@ -429,6 +429,12 @@ declare function formatPageRange(range: {
  */
 declare function isPrintSupported(): boolean;
 
+/**
+ * Selection State Utilities
+ *
+ * Extracts selection state from ProseMirror for toolbar integration.
+ */
+
 /**
  * Selection state for toolbar integration
  */
@@ -448,39 +454,162 @@ interface SelectionState {
     /** End paragraph index */
     endParagraphIndex: number;
 }
+
 /**
- * Ref interface for external control
+ * Layout Engine Types
+ *
+ * Core types for the paginated layout engine.
+ * Converts document blocks + measurements into positioned fragments on pages.
  */
-interface ProseMirrorEditorRef {
-    /** Focus the editor */
-    focus: () => void;
-    /** Blur the editor */
-    blur: () => void;
-    /** Get the current ProseMirror state */
-    getState: () => EditorState | null;
-    /** Get the current ProseMirror view */
-    getView: () => EditorView | null;
-    /** Undo the last change */
-    undo: () => boolean;
-    /** Redo the last undone change */
-    redo: () => boolean;
-    /** Check if undo is available */
-    canUndo: () => boolean;
-    /** Check if redo is available */
-    canRedo: () => boolean;
-    /** Execute a ProseMirror command */
-    executeCommand: (command: Command) => boolean;
-    /** Toggle bold mark */
-    toggleBold: () => boolean;
-    /** Toggle italic mark */
-    toggleItalic: () => boolean;
-    /** Toggle underline mark */
-    toggleUnderline: () => boolean;
-    /** Get the current Document from PM state */
-    getDocument: () => Document | null;
-    /** Get selection context for AI features */
-    getSelectionContext: () => SelectionContext | null;
-}
+/**
+ * Unique identifier for a block in the document.
+ * Format: typically `${index}-${type}` or just the block index.
+ */
+type BlockId = string | number;
+/**
+ * Base fragment properties common to all fragment types.
+ */
+type FragmentBase = {
+    /** Block ID this fragment belongs to. */
+    blockId: BlockId;
+    /** X position on page (relative to page left). */
+    x: number;
+    /** Y position on page (relative to page top). */
+    y: number;
+    /** Width of the fragment. */
+    width: number;
+    /** ProseMirror start position (for click mapping). */
+    pmStart?: number;
+    /** ProseMirror end position (for click mapping). */
+    pmEnd?: number;
+};
+/**
+ * A paragraph fragment positioned on a page.
+ * May span only part of the paragraph's lines if split across pages.
+ */
+type ParagraphFragment = FragmentBase & {
+    kind: 'paragraph';
+    /** First line index (inclusive) from the measure. */
+    fromLine: number;
+    /** Last line index (exclusive) from the measure. */
+    toLine: number;
+    /** Height of this fragment. */
+    height: number;
+    /** True if this continues from a previous page. */
+    continuesFromPrev?: boolean;
+    /** True if this continues onto the next page. */
+    continuesOnNext?: boolean;
+};
+/**
+ * A table fragment positioned on a page.
+ * May span only part of the table's rows if split across pages.
+ */
+type TableFragment = FragmentBase & {
+    kind: 'table';
+    /** First row index (inclusive). */
+    fromRow: number;
+    /** Last row index (exclusive). */
+    toRow: number;
+    /** Height of this fragment. */
+    height: number;
+    /** True if this continues from a previous page. */
+    continuesFromPrev?: boolean;
+    /** True if this continues onto the next page. */
+    continuesOnNext?: boolean;
+};
+/**
+ * An image fragment positioned on a page.
+ */
+type ImageFragment = FragmentBase & {
+    kind: 'image';
+    /** Height of the image. */
+    height: number;
+    /** True if this is an anchored/floating image. */
+    isAnchored?: boolean;
+    /** Z-index for layering. */
+    zIndex?: number;
+};
+/**
+ * Union of all fragment types.
+ */
+type Fragment = ParagraphFragment | TableFragment | ImageFragment;
+/**
+ * Page margin configuration.
+ */
+type PageMargins = {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    /** Distance from page top to header content. */
+    header?: number;
+    /** Distance from page bottom to footer content. */
+    footer?: number;
+};
+/**
+ * A rendered page containing positioned fragments.
+ */
+type Page = {
+    /** Page number (1-indexed). */
+    number: number;
+    /** Fragments positioned on this page. */
+    fragments: Fragment[];
+    /** Page margins. */
+    margins: PageMargins;
+    /** Page size (width, height). */
+    size: {
+        w: number;
+        h: number;
+    };
+    /** Page orientation. */
+    orientation?: 'portrait' | 'landscape';
+    /** Section index this page belongs to. */
+    sectionIndex?: number;
+    /** Header/footer references for this page. */
+    headerFooterRefs?: {
+        headerDefault?: string;
+        headerFirst?: string;
+        headerEven?: string;
+        footerDefault?: string;
+        footerFirst?: string;
+        footerEven?: string;
+    };
+};
+/**
+ * Column layout configuration.
+ */
+type ColumnLayout = {
+    count: number;
+    gap: number;
+    equalWidth?: boolean;
+};
+/**
+ * Header/footer layout for a specific type.
+ */
+type HeaderFooterLayout = {
+    height: number;
+    fragments: Fragment[];
+};
+/**
+ * Final layout output ready for rendering/painting.
+ */
+type Layout = {
+    /** Default page size for the document. */
+    pageSize: {
+        w: number;
+        h: number;
+    };
+    /** All rendered pages with positioned fragments. */
+    pages: Page[];
+    /** Column configuration (if multi-column). */
+    columns?: ColumnLayout;
+    /** Header layouts by type (default, first, even). */
+    headers?: Record<string, HeaderFooterLayout>;
+    /** Footer layouts by type (default, first, even). */
+    footers?: Record<string, HeaderFooterLayout>;
+    /** Gap between pages in pixels (for rendering). */
+    pageGap?: number;
+};
 
 /**
  * Generic Plugin Interface for the DOCX Editor
@@ -711,6 +840,49 @@ interface PluginHostRef {
     refreshPluginStates: () => void;
 }
 
+/**
+ * PagedEditor Component
+ *
+ * Main paginated editing component that integrates:
+ * - HiddenProseMirror: off-screen editor for keyboard input
+ * - Layout engine: computes page layout from PM state
+ * - DOM painter: renders pages to visible DOM
+ * - Selection overlay: renders caret and selection highlights
+ *
+ * Architecture:
+ * 1. User clicks on visible pages → hit test → update PM selection
+ * 2. User types → hidden PM receives input → PM transaction
+ * 3. PM transaction → convert to blocks → measure → layout → paint
+ * 4. Selection changes → compute rects → update overlay
+ */
+
+interface PagedEditorRef {
+    /** Get the current document. */
+    getDocument(): Document | null;
+    /** Get the ProseMirror EditorState. */
+    getState(): EditorState | null;
+    /** Get the ProseMirror EditorView. */
+    getView(): EditorView | null;
+    /** Focus the editor. */
+    focus(): void;
+    /** Blur the editor. */
+    blur(): void;
+    /** Check if focused. */
+    isFocused(): boolean;
+    /** Dispatch a transaction. */
+    dispatch(tr: Transaction): void;
+    /** Undo. */
+    undo(): boolean;
+    /** Redo. */
+    redo(): boolean;
+    /** Set selection by PM position. */
+    setSelection(anchor: number, head?: number): void;
+    /** Get current layout. */
+    getLayout(): Layout | null;
+    /** Force re-layout. */
+    relayout(): void;
+}
+
 /**
  * DocxEditor props
  */
@@ -787,12 +959,6 @@ interface DocxEditorProps {
     onCut?: () => void;
     /** Callback when content is pasted */
     onPaste?: () => void;
-    /**
-     * Use paginated editor mode (experimental).
-     * When enabled, shows true paginated editing with visible page breaks.
-     * When disabled (default), uses standard ProseMirror editor.
-     */
-    usePaginatedEditor?: boolean;
     /**
      * Callback when rendered DOM context is ready (for plugin overlays).
      * Used by PluginHost to get access to the rendered page DOM for positioning.
@@ -812,8 +978,8 @@ interface DocxEditorRef {
     getAgent: () => DocumentAgent | null;
     /** Get the current document */
     getDocument: () => Document | null;
-    /** Get the ProseMirror editor ref */
-    getEditorRef: () => ProseMirrorEditorRef | null;
+    /** Get the editor ref */
+    getEditorRef: () => PagedEditorRef | null;
     /** Save the document to buffer */
     save: () => Promise<ArrayBuffer | null>;
     /** Set zoom level */
@@ -1380,7 +1546,7 @@ interface DocumentViewerProps {
     /** Callback when page becomes visible */
     onPageVisible?: (pageNumber: number) => void;
     /** Callback when document is clicked */
-    onDocumentClick?: (e: React__default.MouseEvent, page: Page | null) => void;
+    onDocumentClick?: (e: React__default.MouseEvent, page: Page$1 | null) => void;
     /** Additional CSS class name */
     className?: string;
     /** Additional inline styles */
@@ -2514,7 +2680,7 @@ interface ResponsiveToolbarProps {
  */
 interface UseResponsiveToolbarOptions {
     /** Container ref */
-    containerRef: React__default.RefObject<HTMLElement>;
+    containerRef: React__default.RefObject<HTMLElement | null>;
     /** Total items */
     items: ToolbarItem[];
     /** Gap between items */