@zeke-02/docx-editor-core 0.1.0

package/dist/plugin-api/RenderedDomContext.d.mts

@@ -0,0 +1,74 @@
+/**
+ * RenderedDomContext Implementation
+ *
+ * Provides DOM-based position mapping for the LayoutPainter output.
+ * Uses the same data-pm-start/data-pm-end attribute pattern as the
+ * selection overlay in PagedEditor.
+ * @packageDocumentation
+ * @public
+ */
+import { RenderedDomContext, PositionCoordinates } from './types.mjs';
+import 'prosemirror-state';
+import 'prosemirror-view';
+import 'prosemirror-model';
+
+/**
+ * RenderedDomContext Implementation
+ *
+ * Provides DOM-based position mapping for the LayoutPainter output.
+ * Uses the same data-pm-start/data-pm-end attribute pattern as the
+ * selection overlay in PagedEditor.
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Implementation of RenderedDomContext.
+ *
+ * This class provides position mapping between ProseMirror document
+ * positions and pixel coordinates in the rendered DOM. It uses the
+ * data-pm-start and data-pm-end attributes that LayoutPainter adds
+ * to span elements.
+ */
+declare class RenderedDomContextImpl implements RenderedDomContext {
+    pagesContainer: HTMLElement;
+    zoom: number;
+    constructor(pagesContainer: HTMLElement, zoom?: number);
+    /**
+     * Get pixel coordinates for a ProseMirror position.
+     * Uses the browser's text rendering via Range API for precise positioning.
+     */
+    getCoordinatesForPosition(pmPos: number): PositionCoordinates | null;
+    /**
+     * Find DOM elements that overlap with a ProseMirror position range.
+     */
+    findElementsForRange(from: number, to: number): Element[];
+    /**
+     * Get bounding rectangles for a range of text.
+     * Handles line wraps by returning multiple rects.
+     */
+    getRectsForRange(from: number, to: number): Array<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+    /**
+     * Get the offset of the pages container from its parent viewport.
+     * This is needed for positioning overlays that are rendered in the
+     * viewport container rather than directly in the pages container.
+     */
+    getContainerOffset(): {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Create a RenderedDomContext for a pages container element.
+ *
+ * @param pagesContainer - The container element holding rendered pages
+ * @param zoom - Current zoom level (default 1)
+ */
+declare function createRenderedDomContext(pagesContainer: HTMLElement, zoom?: number): RenderedDomContext;
+
+export { RenderedDomContextImpl, createRenderedDomContext };

package/dist/plugin-api/RenderedDomContext.d.ts

@@ -0,0 +1,74 @@
+/**
+ * RenderedDomContext Implementation
+ *
+ * Provides DOM-based position mapping for the LayoutPainter output.
+ * Uses the same data-pm-start/data-pm-end attribute pattern as the
+ * selection overlay in PagedEditor.
+ * @packageDocumentation
+ * @public
+ */
+import { RenderedDomContext, PositionCoordinates } from './types.js';
+import 'prosemirror-state';
+import 'prosemirror-view';
+import 'prosemirror-model';
+
+/**
+ * RenderedDomContext Implementation
+ *
+ * Provides DOM-based position mapping for the LayoutPainter output.
+ * Uses the same data-pm-start/data-pm-end attribute pattern as the
+ * selection overlay in PagedEditor.
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Implementation of RenderedDomContext.
+ *
+ * This class provides position mapping between ProseMirror document
+ * positions and pixel coordinates in the rendered DOM. It uses the
+ * data-pm-start and data-pm-end attributes that LayoutPainter adds
+ * to span elements.
+ */
+declare class RenderedDomContextImpl implements RenderedDomContext {
+    pagesContainer: HTMLElement;
+    zoom: number;
+    constructor(pagesContainer: HTMLElement, zoom?: number);
+    /**
+     * Get pixel coordinates for a ProseMirror position.
+     * Uses the browser's text rendering via Range API for precise positioning.
+     */
+    getCoordinatesForPosition(pmPos: number): PositionCoordinates | null;
+    /**
+     * Find DOM elements that overlap with a ProseMirror position range.
+     */
+    findElementsForRange(from: number, to: number): Element[];
+    /**
+     * Get bounding rectangles for a range of text.
+     * Handles line wraps by returning multiple rects.
+     */
+    getRectsForRange(from: number, to: number): Array<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+    /**
+     * Get the offset of the pages container from its parent viewport.
+     * This is needed for positioning overlays that are rendered in the
+     * viewport container rather than directly in the pages container.
+     */
+    getContainerOffset(): {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Create a RenderedDomContext for a pages container element.
+ *
+ * @param pagesContainer - The container element holding rendered pages
+ * @param zoom - Current zoom level (default 1)
+ */
+declare function createRenderedDomContext(pagesContainer: HTMLElement, zoom?: number): RenderedDomContext;
+
+export { RenderedDomContextImpl, createRenderedDomContext };

package/dist/plugin-api/RenderedDomContext.js

@@ -0,0 +1 @@
+'use strict';var chunkDC7S76ZX_js=require('../chunk-DC7S76ZX.js');var E=class{constructor(t,n=1){chunkDC7S76ZX_js.a(this,"pagesContainer");chunkDC7S76ZX_js.a(this,"zoom");this.pagesContainer=t,this.zoom=n;}getCoordinatesForPosition(t){let n=this.pagesContainer.getBoundingClientRect(),s=this.pagesContainer.querySelectorAll("span[data-pm-start][data-pm-end]");for(let a of Array.from(s)){let e=a,o=Number(e.dataset.pmStart),m=Number(e.dataset.pmEnd);if(e.classList.contains("layout-run-tab")){if(t>=o&&t<m){let c=e.getBoundingClientRect(),r=e.closest(".layout-line"),l=r?r.offsetHeight:16;return {x:(c.left-n.left)/this.zoom,y:(c.top-n.top)/this.zoom,height:l/this.zoom}}continue}if(t>=o&&t<=m&&a.firstChild?.nodeType===Node.TEXT_NODE){let c=a.firstChild,r=Math.min(t-o,c.length),l=e.ownerDocument;if(!l)continue;let h=l.createRange();h.setStart(c,r),h.setEnd(c,r);let p=h.getBoundingClientRect(),i=e.closest(".layout-line"),g=i?i.offsetHeight:16;return {x:(p.left-n.left)/this.zoom,y:(p.top-n.top)/this.zoom,height:g/this.zoom}}}let u=this.pagesContainer.querySelectorAll(".layout-empty-run");for(let a of Array.from(u)){let e=a.closest(".layout-paragraph");if(!e)continue;let o=Number(e.dataset.pmStart),m=Number(e.dataset.pmEnd);if(t>=o&&t<=m){let c=a.getBoundingClientRect(),r=a.closest(".layout-line"),l=r?r.offsetHeight:16;return {x:(c.left-n.left)/this.zoom,y:(c.top-n.top)/this.zoom,height:l/this.zoom}}}return null}findElementsForRange(t,n){let s=[],u=this.pagesContainer.querySelectorAll("span[data-pm-start][data-pm-end]");for(let a of Array.from(u)){let e=a,o=Number(e.dataset.pmStart);Number(e.dataset.pmEnd)>t&&o<n&&s.push(e);}return s}getRectsForRange(t,n){let s=this.pagesContainer.getBoundingClientRect(),u=[],a=this.pagesContainer.querySelectorAll("span[data-pm-start][data-pm-end]");for(let e of Array.from(a)){let o=e,m=Number(o.dataset.pmStart);if(Number(o.dataset.pmEnd)>t&&m<n){if(o.classList.contains("layout-run-tab")){let i=o.getBoundingClientRect();u.push({x:(i.left-s.left)/this.zoom,y:(i.top-s.top)/this.zoom,width:i.width/this.zoom,height:i.height/this.zoom});continue}if(e.firstChild?.nodeType!==Node.TEXT_NODE)continue;let r=e.firstChild,l=o.ownerDocument;if(!l)continue;let h=Math.max(0,t-m),p=Math.min(r.length,n-m);if(h<p){let i=l.createRange();i.setStart(r,h),i.setEnd(r,p);let g=i.getClientRects();for(let d of Array.from(g))u.push({x:(d.left-s.left)/this.zoom,y:(d.top-s.top)/this.zoom,width:d.width/this.zoom,height:d.height/this.zoom});}}}return u}getContainerOffset(){let t=this.pagesContainer.parentElement;if(!t)return {x:0,y:0};let n=this.pagesContainer.getBoundingClientRect(),s=t.getBoundingClientRect();return {x:(n.left-s.left)/this.zoom,y:(n.top-s.top)/this.zoom}}};function C(y,t=1){return new E(y,t)}exports.RenderedDomContextImpl=E;exports.createRenderedDomContext=C;

package/dist/plugin-api/RenderedDomContext.mjs

@@ -0,0 +1 @@
+import {a}from'../chunk-QYUPLKLP.mjs';var E=class{constructor(t,n=1){a(this,"pagesContainer");a(this,"zoom");this.pagesContainer=t,this.zoom=n;}getCoordinatesForPosition(t){let n=this.pagesContainer.getBoundingClientRect(),s=this.pagesContainer.querySelectorAll("span[data-pm-start][data-pm-end]");for(let a of Array.from(s)){let e=a,o=Number(e.dataset.pmStart),m=Number(e.dataset.pmEnd);if(e.classList.contains("layout-run-tab")){if(t>=o&&t<m){let c=e.getBoundingClientRect(),r=e.closest(".layout-line"),l=r?r.offsetHeight:16;return {x:(c.left-n.left)/this.zoom,y:(c.top-n.top)/this.zoom,height:l/this.zoom}}continue}if(t>=o&&t<=m&&a.firstChild?.nodeType===Node.TEXT_NODE){let c=a.firstChild,r=Math.min(t-o,c.length),l=e.ownerDocument;if(!l)continue;let h=l.createRange();h.setStart(c,r),h.setEnd(c,r);let p=h.getBoundingClientRect(),i=e.closest(".layout-line"),g=i?i.offsetHeight:16;return {x:(p.left-n.left)/this.zoom,y:(p.top-n.top)/this.zoom,height:g/this.zoom}}}let u=this.pagesContainer.querySelectorAll(".layout-empty-run");for(let a of Array.from(u)){let e=a.closest(".layout-paragraph");if(!e)continue;let o=Number(e.dataset.pmStart),m=Number(e.dataset.pmEnd);if(t>=o&&t<=m){let c=a.getBoundingClientRect(),r=a.closest(".layout-line"),l=r?r.offsetHeight:16;return {x:(c.left-n.left)/this.zoom,y:(c.top-n.top)/this.zoom,height:l/this.zoom}}}return null}findElementsForRange(t,n){let s=[],u=this.pagesContainer.querySelectorAll("span[data-pm-start][data-pm-end]");for(let a of Array.from(u)){let e=a,o=Number(e.dataset.pmStart);Number(e.dataset.pmEnd)>t&&o<n&&s.push(e);}return s}getRectsForRange(t,n){let s=this.pagesContainer.getBoundingClientRect(),u=[],a=this.pagesContainer.querySelectorAll("span[data-pm-start][data-pm-end]");for(let e of Array.from(a)){let o=e,m=Number(o.dataset.pmStart);if(Number(o.dataset.pmEnd)>t&&m<n){if(o.classList.contains("layout-run-tab")){let i=o.getBoundingClientRect();u.push({x:(i.left-s.left)/this.zoom,y:(i.top-s.top)/this.zoom,width:i.width/this.zoom,height:i.height/this.zoom});continue}if(e.firstChild?.nodeType!==Node.TEXT_NODE)continue;let r=e.firstChild,l=o.ownerDocument;if(!l)continue;let h=Math.max(0,t-m),p=Math.min(r.length,n-m);if(h<p){let i=l.createRange();i.setStart(r,h),i.setEnd(r,p);let g=i.getClientRects();for(let d of Array.from(g))u.push({x:(d.left-s.left)/this.zoom,y:(d.top-s.top)/this.zoom,width:d.width/this.zoom,height:d.height/this.zoom});}}}return u}getContainerOffset(){let t=this.pagesContainer.parentElement;if(!t)return {x:0,y:0};let n=this.pagesContainer.getBoundingClientRect(),s=t.getBoundingClientRect();return {x:(n.left-s.left)/this.zoom,y:(n.top-s.top)/this.zoom}}};function C(y,t=1){return new E(y,t)}export{E as RenderedDomContextImpl,C as createRenderedDomContext};

package/dist/plugin-api/index.d.mts

@@ -0,0 +1,15 @@
+/**
+ * Core Plugin API — Framework-Agnostic
+ *
+ * Exports the core plugin interfaces and types that can be used
+ * by any framework adapter (React, Vue, etc.).
+ *
+ * @experimental Plugin API is still evolving. Breaking changes may
+ * happen in minor releases until plugin authors stabilize the contract.
+ * @packageDocumentation
+ * @public
+ */
+export { EditorPluginCore, PanelConfig, PluginPanelProps, PositionCoordinates, RenderedDomContext, SidebarItem, SidebarItemContext } from './types.mjs';
+import 'prosemirror-state';
+import 'prosemirror-view';
+import 'prosemirror-model';

package/dist/plugin-api/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Core Plugin API — Framework-Agnostic
+ *
+ * Exports the core plugin interfaces and types that can be used
+ * by any framework adapter (React, Vue, etc.).
+ *
+ * @experimental Plugin API is still evolving. Breaking changes may
+ * happen in minor releases until plugin authors stabilize the contract.
+ * @packageDocumentation
+ * @public
+ */
+export { EditorPluginCore, PanelConfig, PluginPanelProps, PositionCoordinates, RenderedDomContext, SidebarItem, SidebarItemContext } from './types.js';
+import 'prosemirror-state';
+import 'prosemirror-view';
+import 'prosemirror-model';

package/dist/plugin-api/index.js

@@ -0,0 +1 @@
+'use strict';

package/dist/plugin-api/resolveItemPositions.d.mts

@@ -0,0 +1,54 @@
+/**
+ * Pure layout algorithm: given a list of sidebar items + their
+ * anchor sources, return a list of resolved Y positions with
+ * collision avoidance applied. Lifted from React's
+ * components/sidebar/resolveItemPositions.ts so the Vue adapter
+ * can call it directly.
+ *
+ * The algorithm walks the items in three priority stages:
+ *   1. explicit fixedY (already in scroll-container coords)
+ *   2. anchorKey lookup in anchorPositions (layout-engine coords)
+ *   3. DOM-based anchor lookup via renderedDomContext.getRectsForRange
+ *   4. last-known cache so cards don't pop out during transient layout
+ *
+ * Then it sorts by target Y and pushes overlapping cards down by
+ * their height + MIN_CARD_GAP.
+ * @packageDocumentation
+ * @public
+ */
+import { SidebarItem, RenderedDomContext } from './types.mjs';
+import 'prosemirror-state';
+import 'prosemirror-view';
+import 'prosemirror-model';
+
+/**
+ * Pure layout algorithm: given a list of sidebar items + their
+ * anchor sources, return a list of resolved Y positions with
+ * collision avoidance applied. Lifted from React's
+ * components/sidebar/resolveItemPositions.ts so the Vue adapter
+ * can call it directly.
+ *
+ * The algorithm walks the items in three priority stages:
+ *   1. explicit fixedY (already in scroll-container coords)
+ *   2. anchorKey lookup in anchorPositions (layout-engine coords)
+ *   3. DOM-based anchor lookup via renderedDomContext.getRectsForRange
+ *   4. last-known cache so cards don't pop out during transient layout
+ *
+ * Then it sorts by target Y and pushes overlapping cards down by
+ * their height + MIN_CARD_GAP.
+ * @packageDocumentation
+ * @public
+ */
+
+/** Generic sidebar item with optional fixedY / estimatedHeight. */
+interface ResolvableSidebarItem extends SidebarItem {
+    fixedY?: number;
+    estimatedHeight?: number;
+}
+interface ResolvedPosition<T extends ResolvableSidebarItem = ResolvableSidebarItem> {
+    item: T;
+    y: number;
+}
+declare function resolveItemPositions<T extends ResolvableSidebarItem>(items: T[], anchorPositions: Map<string, number>, renderedDomContext: RenderedDomContext | null, zoom: number, cardHeights: Map<string, number>, lastKnown: Map<string, number>): ResolvedPosition<T>[];
+
+export { type ResolvableSidebarItem, type ResolvedPosition, resolveItemPositions };

package/dist/plugin-api/resolveItemPositions.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Pure layout algorithm: given a list of sidebar items + their
+ * anchor sources, return a list of resolved Y positions with
+ * collision avoidance applied. Lifted from React's
+ * components/sidebar/resolveItemPositions.ts so the Vue adapter
+ * can call it directly.
+ *
+ * The algorithm walks the items in three priority stages:
+ *   1. explicit fixedY (already in scroll-container coords)
+ *   2. anchorKey lookup in anchorPositions (layout-engine coords)
+ *   3. DOM-based anchor lookup via renderedDomContext.getRectsForRange
+ *   4. last-known cache so cards don't pop out during transient layout
+ *
+ * Then it sorts by target Y and pushes overlapping cards down by
+ * their height + MIN_CARD_GAP.
+ * @packageDocumentation
+ * @public
+ */
+import { SidebarItem, RenderedDomContext } from './types.js';
+import 'prosemirror-state';
+import 'prosemirror-view';
+import 'prosemirror-model';
+
+/**
+ * Pure layout algorithm: given a list of sidebar items + their
+ * anchor sources, return a list of resolved Y positions with
+ * collision avoidance applied. Lifted from React's
+ * components/sidebar/resolveItemPositions.ts so the Vue adapter
+ * can call it directly.
+ *
+ * The algorithm walks the items in three priority stages:
+ *   1. explicit fixedY (already in scroll-container coords)
+ *   2. anchorKey lookup in anchorPositions (layout-engine coords)
+ *   3. DOM-based anchor lookup via renderedDomContext.getRectsForRange
+ *   4. last-known cache so cards don't pop out during transient layout
+ *
+ * Then it sorts by target Y and pushes overlapping cards down by
+ * their height + MIN_CARD_GAP.
+ * @packageDocumentation
+ * @public
+ */
+
+/** Generic sidebar item with optional fixedY / estimatedHeight. */
+interface ResolvableSidebarItem extends SidebarItem {
+    fixedY?: number;
+    estimatedHeight?: number;
+}
+interface ResolvedPosition<T extends ResolvableSidebarItem = ResolvableSidebarItem> {
+    item: T;
+    y: number;
+}
+declare function resolveItemPositions<T extends ResolvableSidebarItem>(items: T[], anchorPositions: Map<string, number>, renderedDomContext: RenderedDomContext | null, zoom: number, cardHeights: Map<string, number>, lastKnown: Map<string, number>): ResolvedPosition<T>[];
+
+export { type ResolvableSidebarItem, type ResolvedPosition, resolveItemPositions };

package/dist/plugin-api/resolveItemPositions.js

@@ -0,0 +1 @@
+'use strict';require('../chunk-AAPBAMD7.js'),require('../chunk-DC7S76ZX.js');function g(s,u,n,r,d,l){if(s.length===0)return [];let a=n?.getContainerOffset(),o=[];for(let e of s){let t;if(e.fixedY!=null&&(t=e.fixedY*r),t==null&&e.anchorKey){let i=u.get(e.anchorKey);i!=null&&(t=i*r);}if(t==null&&n){let i=n.getRectsForRange(e.anchorPos,e.anchorPos+1);i.length>0&&a&&(t=(i[0].y+a.y)*r);}if(t==null){let i=l.get(e.id);i!=null&&(t=i);}t!=null&&(o.push({item:e,targetY:t}),l.set(e.id,t));}o.sort((e,t)=>{let i=e.targetY-t.targetY;return i!==0?i:(e.item.priority??0)-(t.item.priority??0)});let m=[],f=0;for(let e of o){let t=d.get(e.item.id)??e.item.estimatedHeight??80,i=Math.max(e.targetY,f+8);m.push({item:e.item,y:i}),f=i+t;}return m}exports.resolveItemPositions=g;

package/dist/plugin-api/resolveItemPositions.mjs

@@ -0,0 +1 @@
+import'../chunk-PRRM64JO.mjs';import'../chunk-QYUPLKLP.mjs';function g(s,u,n,r,d,l){if(s.length===0)return [];let a=n?.getContainerOffset(),o=[];for(let e of s){let t;if(e.fixedY!=null&&(t=e.fixedY*r),t==null&&e.anchorKey){let i=u.get(e.anchorKey);i!=null&&(t=i*r);}if(t==null&&n){let i=n.getRectsForRange(e.anchorPos,e.anchorPos+1);i.length>0&&a&&(t=(i[0].y+a.y)*r);}if(t==null){let i=l.get(e.id);i!=null&&(t=i);}t!=null&&(o.push({item:e,targetY:t}),l.set(e.id,t));}o.sort((e,t)=>{let i=e.targetY-t.targetY;return i!==0?i:(e.item.priority??0)-(t.item.priority??0)});let m=[],f=0;for(let e of o){let t=d.get(e.item.id)??e.item.estimatedHeight??80,i=Math.max(e.targetY,f+8);m.push({item:e.item,y:i}),f=i+t;}return m}export{g as resolveItemPositions};

package/dist/plugin-api/types.d.mts

@@ -0,0 +1,190 @@
+/**
+ * Framework-Agnostic Plugin Interface for the DOCX Editor
+ *
+ * Core plugin types that can be used by any framework (React, Vue, etc.).
+ * Framework-specific adapters extend EditorPluginCore with their own
+ * UI rendering capabilities (e.g., ReactEditorPlugin, VueEditorPlugin).
+ * @packageDocumentation
+ * @public
+ */
+import { Plugin } from 'prosemirror-state';
+import { EditorView } from 'prosemirror-view';
+import { Node } from 'prosemirror-model';
+
+/**
+ * Framework-Agnostic Plugin Interface for the DOCX Editor
+ *
+ * Core plugin types that can be used by any framework (React, Vue, etc.).
+ * Framework-specific adapters extend EditorPluginCore with their own
+ * UI rendering capabilities (e.g., ReactEditorPlugin, VueEditorPlugin).
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Coordinates returned by position lookup in the rendered DOM.
+ */
+interface PositionCoordinates {
+    x: number;
+    y: number;
+    height: number;
+}
+/**
+ * Context for accessing the rendered DOM in the paged editor.
+ *
+ * Provides DOM-based position mapping that works with the LayoutPainter
+ * output (visible pages). Use this for rendering overlays, annotations,
+ * and other visual elements positioned relative to rendered content.
+ *
+ * The rendered DOM uses data-pm-start/data-pm-end attributes on spans
+ * to map between ProseMirror positions and DOM elements.
+ */
+interface RenderedDomContext {
+    /** The container element holding all rendered pages. */
+    pagesContainer: HTMLElement;
+    /**
+     * Get pixel coordinates for a ProseMirror position in the rendered DOM.
+     * Returns null if the position cannot be found.
+     */
+    getCoordinatesForPosition(pmPos: number): PositionCoordinates | null;
+    /**
+     * Find DOM elements that overlap with a ProseMirror position range.
+     */
+    findElementsForRange(from: number, to: number): Element[];
+    /**
+     * Get bounding rectangles for a range of text, accounting for line wraps.
+     * Returns rects relative to the pages container.
+     */
+    getRectsForRange(from: number, to: number): Array<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+    /** Current zoom level (1 = 100%). */
+    zoom: number;
+    /**
+     * Offset of the pages container from its parent viewport.
+     */
+    getContainerOffset(): {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Props passed to plugin panel components (framework-agnostic base).
+ */
+interface PluginPanelProps<TState = unknown> {
+    /** Current ProseMirror editor view */
+    editorView: EditorView | null;
+    /** Current ProseMirror document */
+    doc: Node | null;
+    /** Scroll editor to a specific position */
+    scrollToPosition: (pos: number) => void;
+    /** Select a range in the editor */
+    selectRange: (from: number, to: number) => void;
+    /** Plugin-specific state (managed by the plugin) */
+    pluginState: TState;
+    /** Width of the panel in pixels */
+    panelWidth: number;
+    /**
+     * Context for the rendered DOM (LayoutPainter output).
+     * May be null if layout hasn't completed yet.
+     */
+    renderedDomContext: RenderedDomContext | null;
+}
+/**
+ * Configuration for plugin panel rendering.
+ */
+interface PanelConfig {
+    /** Where to render the panel */
+    position: 'left' | 'right' | 'bottom';
+    /** Default width/height of the panel */
+    defaultSize: number;
+    /** Minimum size */
+    minSize?: number;
+    /** Maximum size */
+    maxSize?: number;
+    /** Whether the panel is resizable */
+    resizable?: boolean;
+    /** Whether the panel can be collapsed */
+    collapsible?: boolean;
+    /** Initial collapsed state */
+    defaultCollapsed?: boolean;
+}
+/**
+ * Framework-agnostic core plugin interface.
+ *
+ * Contains all non-UI plugin capabilities:
+ * - ProseMirror plugins (decorations, keymaps, etc.)
+ * - State management (initialize, onStateChange, destroy)
+ * - CSS injection
+ * - Panel configuration
+ *
+ * Framework adapters (ReactEditorPlugin, VueEditorPlugin) extend this
+ * with their own Panel component type and renderOverlay function.
+ */
+interface EditorPluginCore<TState = any> {
+    /** Unique plugin identifier */
+    id: string;
+    /** Display name for the plugin */
+    name: string;
+    /**
+     * ProseMirror plugins to register with the editor.
+     * These are merged with the editor's internal plugins.
+     */
+    proseMirrorPlugins?: Plugin[];
+    /**
+     * Configuration for the panel (position, size, etc.)
+     */
+    panelConfig?: PanelConfig;
+    /**
+     * Called when the editor state changes.
+     * Use this to update plugin-specific state based on document changes.
+     */
+    onStateChange?: (view: EditorView) => TState | undefined;
+    /**
+     * Initialize plugin state when the plugin is first loaded.
+     */
+    initialize?: (view: EditorView | null) => TState;
+    /**
+     * Called when the plugin is being destroyed.
+     * Use this for cleanup (subscriptions, timers, etc.)
+     */
+    destroy?: () => void;
+    /**
+     * CSS styles to inject for this plugin.
+     * Can be a string of CSS or a URL to a stylesheet.
+     */
+    styles?: string;
+}
+/**
+ * A sidebar item anchored to a document position.
+ * Framework adapters extend this with rendering capabilities.
+ */
+interface SidebarItem {
+    /** Unique ID for this item (used as React key and for overlap resolution). */
+    id: string;
+    /** ProseMirror document position this item anchors to. */
+    anchorPos: number;
+    /** Optional key into the anchorPositions Map (e.g. "comment-42", "revision-7"). */
+    anchorKey?: string;
+    /** Sort priority within items at the same anchor Y. Lower = first. Default: 0. */
+    priority?: number;
+    /** Temporary items (e.g. "add comment" input) skip entrance animation. */
+    isTemporary?: boolean;
+    /** Pre-computed Y position (scroll-container coords, pre-zoom). Overrides anchor resolution. */
+    fixedY?: number;
+}
+/**
+ * Context provided to plugins when computing sidebar items.
+ */
+interface SidebarItemContext {
+    editorView: EditorView | null;
+    renderedDomContext: RenderedDomContext | null;
+    /** Pre-computed Y positions from layout engine (keys like "comment-{id}"). */
+    anchorPositions: Map<string, number>;
+    zoom: number;
+}
+
+export type { EditorPluginCore, PanelConfig, PluginPanelProps, PositionCoordinates, RenderedDomContext, SidebarItem, SidebarItemContext };