@eigenpal/docx-editor-core 0.0.0

package/dist/prosemirror/utils/ClickPositionResolver.d.mts

@@ -0,0 +1,109 @@
+/**
+ * Click Position Resolver
+ *
+ * Provides fast, indexed lookups for click-to-position mapping.
+ * Caches page, fragment, and run positions for O(log n) lookups
+ * instead of O(n) DOM traversal.
+ * @packageDocumentation
+ * @public
+ */
+/**
+ * Cached page information for fast Y-coordinate lookup.
+ */
+interface PageInfo {
+    element: HTMLElement;
+    index: number;
+    top: number;
+    bottom: number;
+}
+/**
+ * Cached fragment information.
+ */
+interface FragmentInfo {
+    element: HTMLElement;
+    blockId: string;
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+/**
+ * Cached run (text span) information.
+ */
+interface RunInfo {
+    element: HTMLElement;
+    pmStart: number;
+    pmEnd: number;
+    left: number;
+    right: number;
+    isTab: boolean;
+}
+/**
+ * Result of a position lookup.
+ */
+interface PositionLookupResult {
+    pageIndex: number;
+    pmPosition: number;
+    element: HTMLElement;
+}
+/**
+ * ClickPositionResolver provides fast click-to-position mapping
+ * by caching DOM element positions and using binary search.
+ */
+declare class ClickPositionResolver {
+    #private;
+    /**
+     * Rebuild the entire index from the container.
+     * Call this after layout changes.
+     */
+    rebuild(container: HTMLElement): void;
+    /**
+     * Mark the index as dirty (needs rebuild).
+     */
+    invalidate(): void;
+    /**
+     * Check if index needs rebuilding.
+     */
+    isDirty(): boolean;
+    /**
+     * Get the page at a Y coordinate using binary search.
+     */
+    getPageAtY(clientY: number): PageInfo | null;
+    /**
+     * Get the fragment at a point within a page.
+     */
+    getFragmentAtPoint(pageIndex: number, _clientX: number, clientY: number): FragmentInfo | null;
+    /**
+     * Get the run at an X coordinate within a fragment.
+     */
+    getRunAtX(blockId: string, clientX: number): RunInfo | null;
+    /**
+     * Get the exact PM position within a run using binary search.
+     */
+    getPositionInRun(run: RunInfo, clientX: number): number;
+    /**
+     * Get PM position from client coordinates.
+     * Main entry point for click-to-position mapping.
+     */
+    getPositionAtPoint(clientX: number, clientY: number): PositionLookupResult | null;
+    /**
+     * Get the element containing a PM position.
+     * Useful for caret positioning.
+     */
+    getElementAtPosition(pmPos: number): HTMLElement | null;
+    /**
+     * Get all pages info (for debugging).
+     */
+    getPages(): ReadonlyArray<PageInfo>;
+    /**
+     * Get debug info.
+     */
+    getDebugInfo(): {
+        pageCount: number;
+        fragmentCount: number;
+        runCount: number;
+        dirty: boolean;
+    };
+}
+
+export { ClickPositionResolver, type PositionLookupResult };

package/dist/prosemirror/utils/ClickPositionResolver.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Click Position Resolver
+ *
+ * Provides fast, indexed lookups for click-to-position mapping.
+ * Caches page, fragment, and run positions for O(log n) lookups
+ * instead of O(n) DOM traversal.
+ * @packageDocumentation
+ * @public
+ */
+/**
+ * Cached page information for fast Y-coordinate lookup.
+ */
+interface PageInfo {
+    element: HTMLElement;
+    index: number;
+    top: number;
+    bottom: number;
+}
+/**
+ * Cached fragment information.
+ */
+interface FragmentInfo {
+    element: HTMLElement;
+    blockId: string;
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+/**
+ * Cached run (text span) information.
+ */
+interface RunInfo {
+    element: HTMLElement;
+    pmStart: number;
+    pmEnd: number;
+    left: number;
+    right: number;
+    isTab: boolean;
+}
+/**
+ * Result of a position lookup.
+ */
+interface PositionLookupResult {
+    pageIndex: number;
+    pmPosition: number;
+    element: HTMLElement;
+}
+/**
+ * ClickPositionResolver provides fast click-to-position mapping
+ * by caching DOM element positions and using binary search.
+ */
+declare class ClickPositionResolver {
+    #private;
+    /**
+     * Rebuild the entire index from the container.
+     * Call this after layout changes.
+     */
+    rebuild(container: HTMLElement): void;
+    /**
+     * Mark the index as dirty (needs rebuild).
+     */
+    invalidate(): void;
+    /**
+     * Check if index needs rebuilding.
+     */
+    isDirty(): boolean;
+    /**
+     * Get the page at a Y coordinate using binary search.
+     */
+    getPageAtY(clientY: number): PageInfo | null;
+    /**
+     * Get the fragment at a point within a page.
+     */
+    getFragmentAtPoint(pageIndex: number, _clientX: number, clientY: number): FragmentInfo | null;
+    /**
+     * Get the run at an X coordinate within a fragment.
+     */
+    getRunAtX(blockId: string, clientX: number): RunInfo | null;
+    /**
+     * Get the exact PM position within a run using binary search.
+     */
+    getPositionInRun(run: RunInfo, clientX: number): number;
+    /**
+     * Get PM position from client coordinates.
+     * Main entry point for click-to-position mapping.
+     */
+    getPositionAtPoint(clientX: number, clientY: number): PositionLookupResult | null;
+    /**
+     * Get the element containing a PM position.
+     * Useful for caret positioning.
+     */
+    getElementAtPosition(pmPos: number): HTMLElement | null;
+    /**
+     * Get all pages info (for debugging).
+     */
+    getPages(): ReadonlyArray<PageInfo>;
+    /**
+     * Get debug info.
+     */
+    getDebugInfo(): {
+        pageCount: number;
+        fragmentCount: number;
+        runCount: number;
+        dirty: boolean;
+    };
+}
+
+export { ClickPositionResolver, type PositionLookupResult };

package/dist/prosemirror/utils/ClickPositionResolver.js

@@ -0,0 +1 @@
+'use strict';var chunkDC7S76ZX_js=require('../../chunk-DC7S76ZX.js');var a,p,f,c,g,b,T,x,M=class{constructor(){chunkDC7S76ZX_js.c(this,b);chunkDC7S76ZX_js.c(this,a,[]);chunkDC7S76ZX_js.c(this,p,new Map);chunkDC7S76ZX_js.c(this,f,new Map);chunkDC7S76ZX_js.c(this,c,null);chunkDC7S76ZX_js.c(this,g,true);}rebuild(e){chunkDC7S76ZX_js.d(this,c,e),chunkDC7S76ZX_js.d(this,a,[]),chunkDC7S76ZX_js.b(this,p).clear(),chunkDC7S76ZX_js.b(this,f).clear();let o=e.querySelectorAll(".layout-page");for(let t=0;t<o.length;t++){let r=o[t],s=r.getBoundingClientRect();chunkDC7S76ZX_js.b(this,a).push({element:r,index:t,top:s.top,bottom:s.bottom}),chunkDC7S76ZX_js.e(this,b,T).call(this,r,t);}chunkDC7S76ZX_js.b(this,a).sort((t,r)=>t.top-r.top),chunkDC7S76ZX_js.d(this,g,false);}invalidate(){chunkDC7S76ZX_js.d(this,g,true);}isDirty(){return chunkDC7S76ZX_js.b(this,g)}getPageAtY(e){if(chunkDC7S76ZX_js.b(this,a).length===0)return null;let o=0,t=chunkDC7S76ZX_js.b(this,a).length-1;for(;o<=t;){let r=Math.floor((o+t)/2),s=chunkDC7S76ZX_js.b(this,a)[r];if(e<s.top)t=r-1;else if(e>s.bottom)o=r+1;else return s}return o>=chunkDC7S76ZX_js.b(this,a).length?chunkDC7S76ZX_js.b(this,a)[chunkDC7S76ZX_js.b(this,a).length-1]:t<0?chunkDC7S76ZX_js.b(this,a)[0]:null}getFragmentAtPoint(e,o,t){let r=chunkDC7S76ZX_js.b(this,p).get(e);if(!r||r.length===0)return null;for(let i of r)if(t>=i.top&&t<=i.bottom)return i;let s=null,n=1/0;for(let i of r){let u=t<i.top?i.top-t:t-i.bottom;u<n&&(n=u,s=i);}return s}getRunAtX(e,o){let t=chunkDC7S76ZX_js.b(this,f).get(e);if(!t||t.length===0)return null;for(let n of t)if(o>=n.left&&o<=n.right)return n;let r=null,s=1/0;for(let n of t){let i=o<n.left?n.left-o:o-n.right;i<s&&(s=i,r=n);}return r}getPositionInRun(e,o){if(e.isTab){let m=(e.left+e.right)/2;return o<m?e.pmStart:e.pmEnd}let t=e.element.firstChild;if(!t||t.nodeType!==Node.TEXT_NODE)return e.pmStart;let r=t,s=r.length;if(s===0)return e.pmStart;let n=e.element.ownerDocument;if(!n)return e.pmStart;let i=0,u=s;for(;i<u;){let m=Math.floor((i+u)/2),E=n.createRange();E.setStart(r,m),E.setEnd(r,m);let R=E.getBoundingClientRect();o<R.left?u=m:i=m+1;}let I=Math.max(0,Math.min(i,e.pmEnd-e.pmStart));return e.pmStart+I}getPositionAtPoint(e,o){chunkDC7S76ZX_js.b(this,g)&&chunkDC7S76ZX_js.b(this,c)&&this.rebuild(chunkDC7S76ZX_js.b(this,c));let t=this.getPageAtY(o);if(!t)return null;let r=this.getFragmentAtPoint(t.index,e,o);if(!r)return null;let s=this.getRunAtX(r.blockId,e);if(!s){let i=Number(r.element.dataset.pmStart);return {pageIndex:t.index,pmPosition:i||0,element:r.element}}let n=this.getPositionInRun(s,e);return {pageIndex:t.index,pmPosition:n,element:s.element}}getElementAtPosition(e){for(let o of chunkDC7S76ZX_js.b(this,f).values())for(let t of o)if(t.isTab){if(e>=t.pmStart&&e<t.pmEnd)return t.element}else if(e>=t.pmStart&&e<=t.pmEnd)return t.element;return null}getPages(){return chunkDC7S76ZX_js.b(this,a)}getDebugInfo(){let e=0,o=0;for(let t of chunkDC7S76ZX_js.b(this,p).values())e+=t.length;for(let t of chunkDC7S76ZX_js.b(this,f).values())o+=t.length;return {pageCount:chunkDC7S76ZX_js.b(this,a).length,fragmentCount:e,runCount:o,dirty:chunkDC7S76ZX_js.b(this,g)}}};a=new WeakMap,p=new WeakMap,f=new WeakMap,c=new WeakMap,g=new WeakMap,b=new WeakSet,T=function(e,o){let t=[],r=e.querySelectorAll(".layout-paragraph, .layout-table, .layout-image");for(let s of Array.from(r)){let n=s,i=n.dataset.blockId||"",u=n.getBoundingClientRect();t.push({element:n,blockId:i,top:u.top,bottom:u.bottom,left:u.left,right:u.right}),chunkDC7S76ZX_js.e(this,b,x).call(this,n,i);}t.sort((s,n)=>s.top-n.top),chunkDC7S76ZX_js.b(this,p).set(o,t);},x=function(e,o){let t=[],r=e.querySelectorAll("span[data-pm-start][data-pm-end]");for(let s of Array.from(r)){let n=s,i=Number(n.dataset.pmStart),u=Number(n.dataset.pmEnd),I=n.getBoundingClientRect(),m=n.classList.contains("layout-run-tab");t.push({element:n,pmStart:i,pmEnd:u,left:I.left,right:I.right,isTab:m});}t.sort((s,n)=>s.left-n.left),chunkDC7S76ZX_js.b(this,f).set(o,t);};exports.ClickPositionResolver=M;

package/dist/prosemirror/utils/ClickPositionResolver.mjs

@@ -0,0 +1 @@
+import {c as c$1,d,b as b$1,e}from'../../chunk-QYUPLKLP.mjs';var a,p,f,c,g,b,T,x,M=class{constructor(){c$1(this,b);c$1(this,a,[]);c$1(this,p,new Map);c$1(this,f,new Map);c$1(this,c,null);c$1(this,g,true);}rebuild(e$1){d(this,c,e$1),d(this,a,[]),b$1(this,p).clear(),b$1(this,f).clear();let o=e$1.querySelectorAll(".layout-page");for(let t=0;t<o.length;t++){let r=o[t],s=r.getBoundingClientRect();b$1(this,a).push({element:r,index:t,top:s.top,bottom:s.bottom}),e(this,b,T).call(this,r,t);}b$1(this,a).sort((t,r)=>t.top-r.top),d(this,g,false);}invalidate(){d(this,g,true);}isDirty(){return b$1(this,g)}getPageAtY(e){if(b$1(this,a).length===0)return null;let o=0,t=b$1(this,a).length-1;for(;o<=t;){let r=Math.floor((o+t)/2),s=b$1(this,a)[r];if(e<s.top)t=r-1;else if(e>s.bottom)o=r+1;else return s}return o>=b$1(this,a).length?b$1(this,a)[b$1(this,a).length-1]:t<0?b$1(this,a)[0]:null}getFragmentAtPoint(e,o,t){let r=b$1(this,p).get(e);if(!r||r.length===0)return null;for(let i of r)if(t>=i.top&&t<=i.bottom)return i;let s=null,n=1/0;for(let i of r){let u=t<i.top?i.top-t:t-i.bottom;u<n&&(n=u,s=i);}return s}getRunAtX(e,o){let t=b$1(this,f).get(e);if(!t||t.length===0)return null;for(let n of t)if(o>=n.left&&o<=n.right)return n;let r=null,s=1/0;for(let n of t){let i=o<n.left?n.left-o:o-n.right;i<s&&(s=i,r=n);}return r}getPositionInRun(e,o){if(e.isTab){let m=(e.left+e.right)/2;return o<m?e.pmStart:e.pmEnd}let t=e.element.firstChild;if(!t||t.nodeType!==Node.TEXT_NODE)return e.pmStart;let r=t,s=r.length;if(s===0)return e.pmStart;let n=e.element.ownerDocument;if(!n)return e.pmStart;let i=0,u=s;for(;i<u;){let m=Math.floor((i+u)/2),E=n.createRange();E.setStart(r,m),E.setEnd(r,m);let R=E.getBoundingClientRect();o<R.left?u=m:i=m+1;}let I=Math.max(0,Math.min(i,e.pmEnd-e.pmStart));return e.pmStart+I}getPositionAtPoint(e,o){b$1(this,g)&&b$1(this,c)&&this.rebuild(b$1(this,c));let t=this.getPageAtY(o);if(!t)return null;let r=this.getFragmentAtPoint(t.index,e,o);if(!r)return null;let s=this.getRunAtX(r.blockId,e);if(!s){let i=Number(r.element.dataset.pmStart);return {pageIndex:t.index,pmPosition:i||0,element:r.element}}let n=this.getPositionInRun(s,e);return {pageIndex:t.index,pmPosition:n,element:s.element}}getElementAtPosition(e){for(let o of b$1(this,f).values())for(let t of o)if(t.isTab){if(e>=t.pmStart&&e<t.pmEnd)return t.element}else if(e>=t.pmStart&&e<=t.pmEnd)return t.element;return null}getPages(){return b$1(this,a)}getDebugInfo(){let e=0,o=0;for(let t of b$1(this,p).values())e+=t.length;for(let t of b$1(this,f).values())o+=t.length;return {pageCount:b$1(this,a).length,fragmentCount:e,runCount:o,dirty:b$1(this,g)}}};a=new WeakMap,p=new WeakMap,f=new WeakMap,c=new WeakMap,g=new WeakMap,b=new WeakSet,T=function(e$1,o){let t=[],r=e$1.querySelectorAll(".layout-paragraph, .layout-table, .layout-image");for(let s of Array.from(r)){let n=s,i=n.dataset.blockId||"",u=n.getBoundingClientRect();t.push({element:n,blockId:i,top:u.top,bottom:u.bottom,left:u.left,right:u.right}),e(this,b,x).call(this,n,i);}t.sort((s,n)=>s.top-n.top),b$1(this,p).set(o,t);},x=function(e,o){let t=[],r=e.querySelectorAll("span[data-pm-start][data-pm-end]");for(let s of Array.from(r)){let n=s,i=Number(n.dataset.pmStart),u=Number(n.dataset.pmEnd),I=n.getBoundingClientRect(),m=n.classList.contains("layout-run-tab");t.push({element:n,pmStart:i,pmEnd:u,left:I.left,right:I.right,isTab:m});}t.sort((s,n)=>s.left-n.left),b$1(this,f).set(o,t);};export{M as ClickPositionResolver};

package/dist/prosemirror/utils/LayoutSelectionGate.d.mts

@@ -0,0 +1,81 @@
+/**
+ * Layout Selection Gate
+ *
+ * Guards selection rendering until layout is up-to-date.
+ * Uses sequenced versioning to prevent stale cursor positions.
+ * @packageDocumentation
+ * @public
+ */
+type RenderCallback = () => void;
+/**
+ * LayoutSelectionGate coordinates the timing between document edits and
+ * layout reflow so that selection overlays are only painted against
+ * current DOM geometry.
+ *
+ * Workflow:
+ * 1. Document changes → setStateSeq(++seq)
+ * 2. Layout starts → onLayoutStart()
+ * 3. Layout completes → onLayoutComplete(seq)
+ * 4. Selection update requested → requestRender()
+ * 5. If safe → callback is called
+ */
+declare class LayoutSelectionGate {
+    #private;
+    /**
+     * Set the document state sequence (call when document changes).
+     * This should be called on every ProseMirror transaction that changes the doc.
+     */
+    setStateSeq(seq: number): void;
+    /**
+     * Increment document state sequence (convenience method).
+     * Returns the new sequence value.
+     */
+    incrementStateSeq(): number;
+    /**
+     * Get current document state sequence.
+     */
+    getStateSeq(): number;
+    /**
+     * Get current layout render sequence.
+     */
+    getRenderSeq(): number;
+    /**
+     * Called when layout computation starts.
+     */
+    onLayoutStart(): void;
+    /**
+     * Called when layout computation and DOM painting completes.
+     * @param seq - The document state sequence that was just painted
+     */
+    onLayoutComplete(seq: number): void;
+    /**
+     * Check if it's safe to render selection.
+     * Safe when: layout is not updating AND render sequence >= state sequence
+     */
+    isSafeToRender(): boolean;
+    /**
+     * Request a selection render. Will be executed when safe.
+     * If already safe, executes immediately.
+     */
+    requestRender(): void;
+    /**
+     * Register a callback to be called on render events.
+     */
+    onRender(callback: RenderCallback): () => void;
+    /**
+     * Reset the gate state (useful for testing or document reload).
+     */
+    reset(): void;
+    /**
+     * Get debug info about current state.
+     */
+    getDebugInfo(): {
+        stateSeq: number;
+        renderSeq: number;
+        layoutUpdating: boolean;
+        hasPendingRender: boolean;
+        isSafe: boolean;
+    };
+}
+
+export { LayoutSelectionGate };

package/dist/prosemirror/utils/LayoutSelectionGate.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Layout Selection Gate
+ *
+ * Guards selection rendering until layout is up-to-date.
+ * Uses sequenced versioning to prevent stale cursor positions.
+ * @packageDocumentation
+ * @public
+ */
+type RenderCallback = () => void;
+/**
+ * LayoutSelectionGate coordinates the timing between document edits and
+ * layout reflow so that selection overlays are only painted against
+ * current DOM geometry.
+ *
+ * Workflow:
+ * 1. Document changes → setStateSeq(++seq)
+ * 2. Layout starts → onLayoutStart()
+ * 3. Layout completes → onLayoutComplete(seq)
+ * 4. Selection update requested → requestRender()
+ * 5. If safe → callback is called
+ */
+declare class LayoutSelectionGate {
+    #private;
+    /**
+     * Set the document state sequence (call when document changes).
+     * This should be called on every ProseMirror transaction that changes the doc.
+     */
+    setStateSeq(seq: number): void;
+    /**
+     * Increment document state sequence (convenience method).
+     * Returns the new sequence value.
+     */
+    incrementStateSeq(): number;
+    /**
+     * Get current document state sequence.
+     */
+    getStateSeq(): number;
+    /**
+     * Get current layout render sequence.
+     */
+    getRenderSeq(): number;
+    /**
+     * Called when layout computation starts.
+     */
+    onLayoutStart(): void;
+    /**
+     * Called when layout computation and DOM painting completes.
+     * @param seq - The document state sequence that was just painted
+     */
+    onLayoutComplete(seq: number): void;
+    /**
+     * Check if it's safe to render selection.
+     * Safe when: layout is not updating AND render sequence >= state sequence
+     */
+    isSafeToRender(): boolean;
+    /**
+     * Request a selection render. Will be executed when safe.
+     * If already safe, executes immediately.
+     */
+    requestRender(): void;
+    /**
+     * Register a callback to be called on render events.
+     */
+    onRender(callback: RenderCallback): () => void;
+    /**
+     * Reset the gate state (useful for testing or document reload).
+     */
+    reset(): void;
+    /**
+     * Get debug info about current state.
+     */
+    getDebugInfo(): {
+        stateSeq: number;
+        renderSeq: number;
+        layoutUpdating: boolean;
+        hasPendingRender: boolean;
+        isSafe: boolean;
+    };
+}
+
+export { LayoutSelectionGate };

package/dist/prosemirror/utils/LayoutSelectionGate.js

@@ -0,0 +1 @@
+'use strict';var chunk4GER4JLW_js=require('../../chunk-4GER4JLW.js');require('../../chunk-DC7S76ZX.js');Object.defineProperty(exports,"LayoutSelectionGate",{enumerable:true,get:function(){return chunk4GER4JLW_js.a}});

package/dist/prosemirror/utils/LayoutSelectionGate.mjs

@@ -0,0 +1 @@
+export{a as LayoutSelectionGate}from'../../chunk-Q5QOBZWT.mjs';import'../../chunk-QYUPLKLP.mjs';

package/dist/prosemirror/utils/PointerEventHandler.d.mts

@@ -0,0 +1,94 @@
+/**
+ * Pointer Event Handler
+ *
+ * Centralized input handling for all pointer events.
+ * Provides single source of truth for click, drag, and focus management.
+ * @packageDocumentation
+ * @public
+ */
+import { ClickPositionResolver } from './ClickPositionResolver.mjs';
+
+/**
+ * Pointer Event Handler
+ *
+ * Centralized input handling for all pointer events.
+ * Provides single source of truth for click, drag, and focus management.
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Interface for the editor that the handler controls.
+ */
+interface EditorInterface {
+    /** Set selection to a position (collapsed) */
+    setSelection(pos: number): void;
+    /** Set selection range */
+    setSelectionRange(from: number, to: number): void;
+    /** Get current selection */
+    getSelection(): {
+        from: number;
+        to: number;
+    } | null;
+    /** Focus the editor */
+    focus(): void;
+}
+/**
+ * Callback for input events.
+ */
+type InputEventCallback = (event: {
+    type: 'click' | 'doubleClick' | 'tripleClick' | 'dragStart' | 'drag' | 'dragEnd';
+    position?: number;
+    from?: number;
+    to?: number;
+}) => void;
+/**
+ * Options for PointerEventHandler.
+ */
+interface PointerEventHandlerOptions {
+    /** The editor to control */
+    editor: EditorInterface;
+    /** Position resolver for click mapping */
+    positionResolver: ClickPositionResolver;
+    /** Callback for input events */
+    onInput?: InputEventCallback;
+}
+/**
+ * PointerEventHandler handles all pointer input for the paged editor.
+ * It provides:
+ * - Single/double/triple click detection
+ * - Drag selection with anchor tracking
+ * - Coordinate normalization for zoom
+ * - Focus management
+ */
+declare class PointerEventHandler {
+    #private;
+    static readonly MULTI_CLICK_DELAY = 500;
+    constructor(options: PointerEventHandlerOptions);
+    /**
+     * Attach event listeners to a container element.
+     */
+    attach(container: HTMLElement): void;
+    /**
+     * Detach event listeners from the container.
+     */
+    detach(): void;
+    /**
+     * Update the position resolver reference.
+     */
+    setPositionResolver(positionResolver: ClickPositionResolver): void;
+    /**
+     * Get current drag state.
+     */
+    isDragging(): boolean;
+    /**
+     * Get drag anchor position.
+     */
+    getDragAnchor(): number | null;
+    /**
+     * Cancel any ongoing drag.
+     */
+    cancelDrag(): void;
+}
+
+export { type EditorInterface, type InputEventCallback, PointerEventHandler, type PointerEventHandlerOptions };

package/dist/prosemirror/utils/PointerEventHandler.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Pointer Event Handler
+ *
+ * Centralized input handling for all pointer events.
+ * Provides single source of truth for click, drag, and focus management.
+ * @packageDocumentation
+ * @public
+ */
+import { ClickPositionResolver } from './ClickPositionResolver.js';
+
+/**
+ * Pointer Event Handler
+ *
+ * Centralized input handling for all pointer events.
+ * Provides single source of truth for click, drag, and focus management.
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Interface for the editor that the handler controls.
+ */
+interface EditorInterface {
+    /** Set selection to a position (collapsed) */
+    setSelection(pos: number): void;
+    /** Set selection range */
+    setSelectionRange(from: number, to: number): void;
+    /** Get current selection */
+    getSelection(): {
+        from: number;
+        to: number;
+    } | null;
+    /** Focus the editor */
+    focus(): void;
+}
+/**
+ * Callback for input events.
+ */
+type InputEventCallback = (event: {
+    type: 'click' | 'doubleClick' | 'tripleClick' | 'dragStart' | 'drag' | 'dragEnd';
+    position?: number;
+    from?: number;
+    to?: number;
+}) => void;
+/**
+ * Options for PointerEventHandler.
+ */
+interface PointerEventHandlerOptions {
+    /** The editor to control */
+    editor: EditorInterface;
+    /** Position resolver for click mapping */
+    positionResolver: ClickPositionResolver;
+    /** Callback for input events */
+    onInput?: InputEventCallback;
+}
+/**
+ * PointerEventHandler handles all pointer input for the paged editor.
+ * It provides:
+ * - Single/double/triple click detection
+ * - Drag selection with anchor tracking
+ * - Coordinate normalization for zoom
+ * - Focus management
+ */
+declare class PointerEventHandler {
+    #private;
+    static readonly MULTI_CLICK_DELAY = 500;
+    constructor(options: PointerEventHandlerOptions);
+    /**
+     * Attach event listeners to a container element.
+     */
+    attach(container: HTMLElement): void;
+    /**
+     * Detach event listeners from the container.
+     */
+    detach(): void;
+    /**
+     * Update the position resolver reference.
+     */
+    setPositionResolver(positionResolver: ClickPositionResolver): void;
+    /**
+     * Get current drag state.
+     */
+    isDragging(): boolean;
+    /**
+     * Get drag anchor position.
+     */
+    getDragAnchor(): number | null;
+    /**
+     * Cancel any ongoing drag.
+     */
+    cancelDrag(): void;
+}
+
+export { type EditorInterface, type InputEventCallback, PointerEventHandler, type PointerEventHandlerOptions };

package/dist/prosemirror/utils/PointerEventHandler.js

@@ -0,0 +1 @@
+'use strict';var chunkWLKRUBY4_js=require('../../chunk-WLKRUBY4.js'),chunkDC7S76ZX_js=require('../../chunk-DC7S76ZX.js');var s,p,a,C,u,d,S,L,v,b,E,g,P,n,I,N,w,T,U,Y,_,f,k=class k{constructor(e){chunkDC7S76ZX_js.c(this,n);chunkDC7S76ZX_js.c(this,s);chunkDC7S76ZX_js.c(this,p);chunkDC7S76ZX_js.c(this,a,null);chunkDC7S76ZX_js.c(this,C);chunkDC7S76ZX_js.c(this,u,false);chunkDC7S76ZX_js.c(this,d,null);chunkDC7S76ZX_js.c(this,S,0);chunkDC7S76ZX_js.c(this,L,null);chunkDC7S76ZX_js.c(this,v,0);chunkDC7S76ZX_js.c(this,b);chunkDC7S76ZX_js.c(this,E);chunkDC7S76ZX_js.c(this,g);chunkDC7S76ZX_js.c(this,P);chunkDC7S76ZX_js.d(this,s,e.editor),chunkDC7S76ZX_js.d(this,p,e.positionResolver),chunkDC7S76ZX_js.d(this,C,e.onInput),chunkDC7S76ZX_js.d(this,b,chunkDC7S76ZX_js.e(this,n,N).bind(this)),chunkDC7S76ZX_js.d(this,E,chunkDC7S76ZX_js.e(this,n,w).bind(this)),chunkDC7S76ZX_js.d(this,g,chunkDC7S76ZX_js.e(this,n,T).bind(this)),chunkDC7S76ZX_js.d(this,P,chunkDC7S76ZX_js.e(this,n,U).bind(this));}attach(e){chunkDC7S76ZX_js.d(this,a,e),e.addEventListener("pointerdown",chunkDC7S76ZX_js.b(this,b)),e.addEventListener("pointermove",chunkDC7S76ZX_js.b(this,E)),e.addEventListener("pointerup",chunkDC7S76ZX_js.b(this,g)),e.addEventListener("pointerleave",chunkDC7S76ZX_js.b(this,P));}detach(){chunkDC7S76ZX_js.b(this,a)&&(chunkDC7S76ZX_js.b(this,a).removeEventListener("pointerdown",chunkDC7S76ZX_js.b(this,b)),chunkDC7S76ZX_js.b(this,a).removeEventListener("pointermove",chunkDC7S76ZX_js.b(this,E)),chunkDC7S76ZX_js.b(this,a).removeEventListener("pointerup",chunkDC7S76ZX_js.b(this,g)),chunkDC7S76ZX_js.b(this,a).removeEventListener("pointerleave",chunkDC7S76ZX_js.b(this,P)),chunkDC7S76ZX_js.d(this,a,null));}setPositionResolver(e){chunkDC7S76ZX_js.d(this,p,e);}isDragging(){return chunkDC7S76ZX_js.b(this,u)}getDragAnchor(){return chunkDC7S76ZX_js.b(this,d)}cancelDrag(){chunkDC7S76ZX_js.d(this,u,false),chunkDC7S76ZX_js.d(this,d,null);}};s=new WeakMap,p=new WeakMap,a=new WeakMap,C=new WeakMap,u=new WeakMap,d=new WeakMap,S=new WeakMap,L=new WeakMap,v=new WeakMap,b=new WeakMap,E=new WeakMap,g=new WeakMap,P=new WeakMap,n=new WeakSet,I=function(e,i){return chunkDC7S76ZX_js.b(this,p).getPositionAtPoint(e,i)?.pmPosition??null},N=function(e){if(e.button!==0)return;chunkDC7S76ZX_js.b(this,s).focus();let i=chunkDC7S76ZX_js.e(this,n,I).call(this,e.clientX,e.clientY);if(i===null)return;let h=Date.now();if(h-chunkDC7S76ZX_js.b(this,S)<k.MULTI_CLICK_DELAY&&chunkDC7S76ZX_js.b(this,L)===i?chunkDC7S76ZX_js.f(this,v)._++:chunkDC7S76ZX_js.d(this,v,1),chunkDC7S76ZX_js.d(this,S,h),chunkDC7S76ZX_js.d(this,L,i),chunkDC7S76ZX_js.b(this,v)===1){if(e.shiftKey){let m=chunkDC7S76ZX_js.b(this,s).getSelection();m?chunkDC7S76ZX_js.b(this,s).setSelectionRange(m.from,i):chunkDC7S76ZX_js.b(this,s).setSelection(i);}else chunkDC7S76ZX_js.b(this,s).setSelection(i);chunkDC7S76ZX_js.d(this,u,true),chunkDC7S76ZX_js.d(this,d,i),chunkDC7S76ZX_js.e(this,n,f).call(this,{type:"click",position:i}),chunkDC7S76ZX_js.e(this,n,f).call(this,{type:"dragStart",position:i});}else chunkDC7S76ZX_js.b(this,v)===2?(chunkDC7S76ZX_js.e(this,n,Y).call(this,i),chunkDC7S76ZX_js.e(this,n,f).call(this,{type:"doubleClick",position:i})):chunkDC7S76ZX_js.b(this,v)>=3&&(chunkDC7S76ZX_js.e(this,n,_).call(this,i),chunkDC7S76ZX_js.e(this,n,f).call(this,{type:"tripleClick",position:i}),chunkDC7S76ZX_js.d(this,v,0));},w=function(e){if(!chunkDC7S76ZX_js.b(this,u)||chunkDC7S76ZX_js.b(this,d)===null)return;let i=chunkDC7S76ZX_js.e(this,n,I).call(this,e.clientX,e.clientY);if(i===null)return;let h=Math.min(chunkDC7S76ZX_js.b(this,d),i),c=Math.max(chunkDC7S76ZX_js.b(this,d),i);chunkDC7S76ZX_js.b(this,s).setSelectionRange(h,c),chunkDC7S76ZX_js.e(this,n,f).call(this,{type:"drag",from:h,to:c});},T=function(e){if(chunkDC7S76ZX_js.b(this,u)){let i=chunkDC7S76ZX_js.b(this,s).getSelection();chunkDC7S76ZX_js.e(this,n,f).call(this,{type:"dragEnd",from:i?.from,to:i?.to});}chunkDC7S76ZX_js.d(this,u,false);},U=function(e){},Y=function(e){let i=chunkDC7S76ZX_js.b(this,p).getElementAtPosition(e);if(!i){chunkDC7S76ZX_js.b(this,s).setSelection(e);return}let h=i.textContent||"",c=Number(i.dataset.pmStart)||0,m=e-c,[H,K]=chunkWLKRUBY4_js.c(h,m),R=c+H,y=c+K;R<y?chunkDC7S76ZX_js.b(this,s).setSelectionRange(R,y):chunkDC7S76ZX_js.b(this,s).setSelection(e);},_=function(e){let i=chunkDC7S76ZX_js.b(this,p).getElementAtPosition(e);if(!i){chunkDC7S76ZX_js.b(this,s).setSelection(e);return}let h=i.closest(".layout-paragraph");if(!h){chunkDC7S76ZX_js.b(this,s).setSelection(e);return}let c=Number(h.dataset.pmStart),m=Number(h.dataset.pmEnd);!isNaN(c)&&!isNaN(m)&&c<m?chunkDC7S76ZX_js.b(this,s).setSelectionRange(c,m):chunkDC7S76ZX_js.b(this,s).setSelection(e);},f=function(e){var i;(i=chunkDC7S76ZX_js.b(this,C))==null||i.call(this,e);},chunkDC7S76ZX_js.a(k,"MULTI_CLICK_DELAY",500);var A=k;exports.PointerEventHandler=A;

package/dist/prosemirror/utils/PointerEventHandler.mjs

@@ -0,0 +1 @@
+import {c as c$1}from'../../chunk-OBMN4VSM.mjs';import {a as a$1,c,d as d$1,e,b as b$1,f as f$1}from'../../chunk-QYUPLKLP.mjs';var s,p,a,C,u,d,S,L,v,b,E,g,P,n,I,N,w,T,U,Y,_,f,k=class k{constructor(e$1){c(this,n);c(this,s);c(this,p);c(this,a,null);c(this,C);c(this,u,false);c(this,d,null);c(this,S,0);c(this,L,null);c(this,v,0);c(this,b);c(this,E);c(this,g);c(this,P);d$1(this,s,e$1.editor),d$1(this,p,e$1.positionResolver),d$1(this,C,e$1.onInput),d$1(this,b,e(this,n,N).bind(this)),d$1(this,E,e(this,n,w).bind(this)),d$1(this,g,e(this,n,T).bind(this)),d$1(this,P,e(this,n,U).bind(this));}attach(e){d$1(this,a,e),e.addEventListener("pointerdown",b$1(this,b)),e.addEventListener("pointermove",b$1(this,E)),e.addEventListener("pointerup",b$1(this,g)),e.addEventListener("pointerleave",b$1(this,P));}detach(){b$1(this,a)&&(b$1(this,a).removeEventListener("pointerdown",b$1(this,b)),b$1(this,a).removeEventListener("pointermove",b$1(this,E)),b$1(this,a).removeEventListener("pointerup",b$1(this,g)),b$1(this,a).removeEventListener("pointerleave",b$1(this,P)),d$1(this,a,null));}setPositionResolver(e){d$1(this,p,e);}isDragging(){return b$1(this,u)}getDragAnchor(){return b$1(this,d)}cancelDrag(){d$1(this,u,false),d$1(this,d,null);}};s=new WeakMap,p=new WeakMap,a=new WeakMap,C=new WeakMap,u=new WeakMap,d=new WeakMap,S=new WeakMap,L=new WeakMap,v=new WeakMap,b=new WeakMap,E=new WeakMap,g=new WeakMap,P=new WeakMap,n=new WeakSet,I=function(e,i){return b$1(this,p).getPositionAtPoint(e,i)?.pmPosition??null},N=function(e$1){if(e$1.button!==0)return;b$1(this,s).focus();let i=e(this,n,I).call(this,e$1.clientX,e$1.clientY);if(i===null)return;let h=Date.now();if(h-b$1(this,S)<k.MULTI_CLICK_DELAY&&b$1(this,L)===i?f$1(this,v)._++:d$1(this,v,1),d$1(this,S,h),d$1(this,L,i),b$1(this,v)===1){if(e$1.shiftKey){let m=b$1(this,s).getSelection();m?b$1(this,s).setSelectionRange(m.from,i):b$1(this,s).setSelection(i);}else b$1(this,s).setSelection(i);d$1(this,u,true),d$1(this,d,i),e(this,n,f).call(this,{type:"click",position:i}),e(this,n,f).call(this,{type:"dragStart",position:i});}else b$1(this,v)===2?(e(this,n,Y).call(this,i),e(this,n,f).call(this,{type:"doubleClick",position:i})):b$1(this,v)>=3&&(e(this,n,_).call(this,i),e(this,n,f).call(this,{type:"tripleClick",position:i}),d$1(this,v,0));},w=function(e$1){if(!b$1(this,u)||b$1(this,d)===null)return;let i=e(this,n,I).call(this,e$1.clientX,e$1.clientY);if(i===null)return;let h=Math.min(b$1(this,d),i),c=Math.max(b$1(this,d),i);b$1(this,s).setSelectionRange(h,c),e(this,n,f).call(this,{type:"drag",from:h,to:c});},T=function(e$1){if(b$1(this,u)){let i=b$1(this,s).getSelection();e(this,n,f).call(this,{type:"dragEnd",from:i?.from,to:i?.to});}d$1(this,u,false);},U=function(e){},Y=function(e){let i=b$1(this,p).getElementAtPosition(e);if(!i){b$1(this,s).setSelection(e);return}let h=i.textContent||"",c=Number(i.dataset.pmStart)||0,m=e-c,[H,K]=c$1(h,m),R=c+H,y=c+K;R<y?b$1(this,s).setSelectionRange(R,y):b$1(this,s).setSelection(e);},_=function(e){let i=b$1(this,p).getElementAtPosition(e);if(!i){b$1(this,s).setSelection(e);return}let h=i.closest(".layout-paragraph");if(!h){b$1(this,s).setSelection(e);return}let c=Number(h.dataset.pmStart),m=Number(h.dataset.pmEnd);!isNaN(c)&&!isNaN(m)&&c<m?b$1(this,s).setSelectionRange(c,m):b$1(this,s).setSelection(e);},f=function(e){var i;(i=b$1(this,C))==null||i.call(this,e);},a$1(k,"MULTI_CLICK_DELAY",500);var A=k;export{A as PointerEventHandler};

package/dist/prosemirror/utils/extractTrackedChanges.d.mts

@@ -0,0 +1,63 @@
+/**
+ * Walk the PM doc once and derive (a) the tracked-change list and (b) a
+ * comment→revision overlap map for threading. Adjacent entries from the
+ * same revision are merged; deletion+insertion pairs from the same
+ * author/date become a single `replacement` entry (matches Word's UX
+ * for replace ops).
+ *
+ * Pure function — no React, no Vue, no side effects. Single O(N) walk
+ * over text nodes. Lifted from packages/react/src/hooks/useTrackedChanges.ts
+ * so both adapters can call it directly.
+ *
+ * @remarks
+ * Tagged `@internal` post-1.0 cut. Both adapters re-export this through
+ * their own composables (`useTrackedChanges`); consumers should prefer
+ * those. The subpath stays in `package.json` `exports` for back-compat;
+ * expect it to move behind a public surface in a future major.
+ *
+ * @packageDocumentation
+ * @internal
+ */
+import { EditorState } from 'prosemirror-state';
+import { TrackedChangeEntry } from '../../utils/comments.mjs';
+import '../../types/content.mjs';
+import '../../formatting-D9I-lFS4.mjs';
+import '../../colors-C3vA7HUU.mjs';
+import '../../docx/wrapTypes.mjs';
+import '../../lists-JDB80qyP.mjs';
+
+/**
+ * Walk the PM doc once and derive (a) the tracked-change list and (b) a
+ * comment→revision overlap map for threading. Adjacent entries from the
+ * same revision are merged; deletion+insertion pairs from the same
+ * author/date become a single `replacement` entry (matches Word's UX
+ * for replace ops).
+ *
+ * Pure function — no React, no Vue, no side effects. Single O(N) walk
+ * over text nodes. Lifted from packages/react/src/hooks/useTrackedChanges.ts
+ * so both adapters can call it directly.
+ *
+ * @remarks
+ * Tagged `@internal` post-1.0 cut. Both adapters re-export this through
+ * their own composables (`useTrackedChanges`); consumers should prefer
+ * those. The subpath stays in `package.json` `exports` for back-compat;
+ * expect it to move behind a public surface in a future major.
+ *
+ * @packageDocumentation
+ * @internal
+ */
+
+/** @internal */
+interface TrackedChangesResult {
+    /** Tracked-change entries, sorted by document position, with adjacent same-revision entries merged. */
+    entries: TrackedChangeEntry[];
+    /**
+     * Map of `commentId -> revisionId` for comments whose range overlaps a tracked-change mark.
+     * Consumers (DocxEditor's threading effect) use this to thread comments under their tracked change.
+     */
+    commentToRevision: Map<number, number>;
+}
+/** @internal */
+declare function extractTrackedChanges(state: EditorState | null): TrackedChangesResult;
+
+export { type TrackedChangesResult, extractTrackedChanges };