@zeke-02/docx-editor 0.5.1 → 0.5.3

package/dist/layout-bridge-5GYGYKM5.mjs

@@ -0,0 +1 @@
+export{Nb as DEFAULT_BODY_MARGIN_PX,Ob as DEFAULT_HF_DISTANCE_PX,Mb as DEFAULT_PAGE_HEIGHT_PX,Lb as DEFAULT_PAGE_WIDTH_PX,kb as FOOTNOTE_SEPARATOR_HEIGHT,lb as MAX_FOOTNOTE_LAYOUT_PASSES,Gb as TABLE_INSERT_EDGE_PROXIMITY,Hb as TABLE_INSERT_HIDE_DELAY_MS,pb as applyFootnotePresentation,H as buildFontString,rb as buildFootnoteContentMap,ub as buildFootnoteRenderItems,sb as calculateFootnoteReservedHeights,xb as calculateHeaderFooterVisualBounds,na as clearAllCaches,ea as clearFontMetricsCache,ka as clearParagraphMeasureCache,$ as clearTextWidthCache,Ea as clickToPosition,La as clickToPositionDom,Ca as clickToPositionInParagraph,Da as clickToPositionInTableCell,nb as collectFootnoteRefs,A as convertBorderSpecToLayout,qb as convertFootnoteToContent,yb as convertHeaderFooterToContent,D as countTableColumns,Ib as detectTableInsertHover,Ia as findBodyEmptyRuns,Ka as findBodyPmAnchor,Ja as findBodyPmAnchors,Ha as findBodyPmSpans,M as findCharacterAtX,mb as footnoteReservedHeightsEqual,ca as getCachedFontMetrics,ia as getCachedParagraphMeasure,Z as getCachedTextWidth,F as getCanvasContext,Pa as getCaretPosition,Na as getCaretPositionFromDom,V as getFloatingMargins,ga as getFontCacheSize,I as getFontMetrics,Qb as getMargins,Ba as getPageBounds,ua as getPageIndexAtY,Pb as getPageSize,ta as getPageTop,ma as getParagraphCacheSize,Ga as getPositionRect,Y as getRunCharWidths,Aa as getScrollYForPage,Ma as getSelectionRectsFromDom,ba as getTextCacheSize,oa as getTotalCacheSize,za as getTotalDocumentHeight,N as getXForCharacter,Ra as groupRectsByPage,S as halfPtToPx,ha as hashParagraphBlock,ya as hitTest,va as hitTestFragment,wa as hitTestImageFragment,sa as hitTestPage,xa as hitTestTableCell,Qa as isMultiPageSelection,ob as mapFootnotesToPages,W as measureParagraph,X as measureParagraphs,L as measureRun,Kb as measureTableBlock,Jb as measureTableCellBlockVisualHeight,K as measureText,J as measureTextWidth,La as mouseToPosition,vb as normalizeHeaderFooterMeasureBlocks,E as normalizeTableColumnWidths,Fa as positionToX,Q as ptToPx,T as pxToHalfPt,R as pxToPt,P as pxToTwips,U as rectsToFloatingZones,z as resetBlockIdCounter,G as resetCanvasContext,Rb as resolveHeaderFooter,wb as resolveHeaderFooterVisualTop,y as resolveListTemplate,C as resolveTableWidthPx,Oa as selectionToRects,da as setCachedFontMetrics,ja as setCachedParagraphMeasure,_ as setCachedTextWidth,fa as setFontCacheSize,la as setParagraphCacheSize,aa as setTextCacheSize,tb as stabilizeFootnoteLayout,B as toFlowBlocks,O as twipsToPx}from'./chunk-XQZTWWRF.mjs';import'./chunk-ONIYA2FU.mjs';import'./chunk-FWPVBFKQ.mjs';import'./chunk-TAUMSKRE.mjs';

package/dist/layout-bridge-QQDA7ELH.js

@@ -0,0 +1 @@
+'use strict';var chunkB45ECEGY_js=require('./chunk-B45ECEGY.js');require('./chunk-ZXPCJWVY.js'),require('./chunk-ILYKDR3C.js'),require('./chunk-H5NTJZO4.js');Object.defineProperty(exports,"DEFAULT_BODY_MARGIN_PX",{enumerable:true,get:function(){return chunkB45ECEGY_js.Nb}});Object.defineProperty(exports,"DEFAULT_HF_DISTANCE_PX",{enumerable:true,get:function(){return chunkB45ECEGY_js.Ob}});Object.defineProperty(exports,"DEFAULT_PAGE_HEIGHT_PX",{enumerable:true,get:function(){return chunkB45ECEGY_js.Mb}});Object.defineProperty(exports,"DEFAULT_PAGE_WIDTH_PX",{enumerable:true,get:function(){return chunkB45ECEGY_js.Lb}});Object.defineProperty(exports,"FOOTNOTE_SEPARATOR_HEIGHT",{enumerable:true,get:function(){return chunkB45ECEGY_js.kb}});Object.defineProperty(exports,"MAX_FOOTNOTE_LAYOUT_PASSES",{enumerable:true,get:function(){return chunkB45ECEGY_js.lb}});Object.defineProperty(exports,"TABLE_INSERT_EDGE_PROXIMITY",{enumerable:true,get:function(){return chunkB45ECEGY_js.Gb}});Object.defineProperty(exports,"TABLE_INSERT_HIDE_DELAY_MS",{enumerable:true,get:function(){return chunkB45ECEGY_js.Hb}});Object.defineProperty(exports,"applyFootnotePresentation",{enumerable:true,get:function(){return chunkB45ECEGY_js.pb}});Object.defineProperty(exports,"buildFontString",{enumerable:true,get:function(){return chunkB45ECEGY_js.H}});Object.defineProperty(exports,"buildFootnoteContentMap",{enumerable:true,get:function(){return chunkB45ECEGY_js.rb}});Object.defineProperty(exports,"buildFootnoteRenderItems",{enumerable:true,get:function(){return chunkB45ECEGY_js.ub}});Object.defineProperty(exports,"calculateFootnoteReservedHeights",{enumerable:true,get:function(){return chunkB45ECEGY_js.sb}});Object.defineProperty(exports,"calculateHeaderFooterVisualBounds",{enumerable:true,get:function(){return chunkB45ECEGY_js.xb}});Object.defineProperty(exports,"clearAllCaches",{enumerable:true,get:function(){return chunkB45ECEGY_js.na}});Object.defineProperty(exports,"clearFontMetricsCache",{enumerable:true,get:function(){return chunkB45ECEGY_js.ea}});Object.defineProperty(exports,"clearParagraphMeasureCache",{enumerable:true,get:function(){return chunkB45ECEGY_js.ka}});Object.defineProperty(exports,"clearTextWidthCache",{enumerable:true,get:function(){return chunkB45ECEGY_js.$}});Object.defineProperty(exports,"clickToPosition",{enumerable:true,get:function(){return chunkB45ECEGY_js.Ea}});Object.defineProperty(exports,"clickToPositionDom",{enumerable:true,get:function(){return chunkB45ECEGY_js.La}});Object.defineProperty(exports,"clickToPositionInParagraph",{enumerable:true,get:function(){return chunkB45ECEGY_js.Ca}});Object.defineProperty(exports,"clickToPositionInTableCell",{enumerable:true,get:function(){return chunkB45ECEGY_js.Da}});Object.defineProperty(exports,"collectFootnoteRefs",{enumerable:true,get:function(){return chunkB45ECEGY_js.nb}});Object.defineProperty(exports,"convertBorderSpecToLayout",{enumerable:true,get:function(){return chunkB45ECEGY_js.A}});Object.defineProperty(exports,"convertFootnoteToContent",{enumerable:true,get:function(){return chunkB45ECEGY_js.qb}});Object.defineProperty(exports,"convertHeaderFooterToContent",{enumerable:true,get:function(){return chunkB45ECEGY_js.yb}});Object.defineProperty(exports,"countTableColumns",{enumerable:true,get:function(){return chunkB45ECEGY_js.D}});Object.defineProperty(exports,"detectTableInsertHover",{enumerable:true,get:function(){return chunkB45ECEGY_js.Ib}});Object.defineProperty(exports,"findBodyEmptyRuns",{enumerable:true,get:function(){return chunkB45ECEGY_js.Ia}});Object.defineProperty(exports,"findBodyPmAnchor",{enumerable:true,get:function(){return chunkB45ECEGY_js.Ka}});Object.defineProperty(exports,"findBodyPmAnchors",{enumerable:true,get:function(){return chunkB45ECEGY_js.Ja}});Object.defineProperty(exports,"findBodyPmSpans",{enumerable:true,get:function(){return chunkB45ECEGY_js.Ha}});Object.defineProperty(exports,"findCharacterAtX",{enumerable:true,get:function(){return chunkB45ECEGY_js.M}});Object.defineProperty(exports,"footnoteReservedHeightsEqual",{enumerable:true,get:function(){return chunkB45ECEGY_js.mb}});Object.defineProperty(exports,"getCachedFontMetrics",{enumerable:true,get:function(){return chunkB45ECEGY_js.ca}});Object.defineProperty(exports,"getCachedParagraphMeasure",{enumerable:true,get:function(){return chunkB45ECEGY_js.ia}});Object.defineProperty(exports,"getCachedTextWidth",{enumerable:true,get:function(){return chunkB45ECEGY_js.Z}});Object.defineProperty(exports,"getCanvasContext",{enumerable:true,get:function(){return chunkB45ECEGY_js.F}});Object.defineProperty(exports,"getCaretPosition",{enumerable:true,get:function(){return chunkB45ECEGY_js.Pa}});Object.defineProperty(exports,"getCaretPositionFromDom",{enumerable:true,get:function(){return chunkB45ECEGY_js.Na}});Object.defineProperty(exports,"getFloatingMargins",{enumerable:true,get:function(){return chunkB45ECEGY_js.V}});Object.defineProperty(exports,"getFontCacheSize",{enumerable:true,get:function(){return chunkB45ECEGY_js.ga}});Object.defineProperty(exports,"getFontMetrics",{enumerable:true,get:function(){return chunkB45ECEGY_js.I}});Object.defineProperty(exports,"getMargins",{enumerable:true,get:function(){return chunkB45ECEGY_js.Qb}});Object.defineProperty(exports,"getPageBounds",{enumerable:true,get:function(){return chunkB45ECEGY_js.Ba}});Object.defineProperty(exports,"getPageIndexAtY",{enumerable:true,get:function(){return chunkB45ECEGY_js.ua}});Object.defineProperty(exports,"getPageSize",{enumerable:true,get:function(){return chunkB45ECEGY_js.Pb}});Object.defineProperty(exports,"getPageTop",{enumerable:true,get:function(){return chunkB45ECEGY_js.ta}});Object.defineProperty(exports,"getParagraphCacheSize",{enumerable:true,get:function(){return chunkB45ECEGY_js.ma}});Object.defineProperty(exports,"getPositionRect",{enumerable:true,get:function(){return chunkB45ECEGY_js.Ga}});Object.defineProperty(exports,"getRunCharWidths",{enumerable:true,get:function(){return chunkB45ECEGY_js.Y}});Object.defineProperty(exports,"getScrollYForPage",{enumerable:true,get:function(){return chunkB45ECEGY_js.Aa}});Object.defineProperty(exports,"getSelectionRectsFromDom",{enumerable:true,get:function(){return chunkB45ECEGY_js.Ma}});Object.defineProperty(exports,"getTextCacheSize",{enumerable:true,get:function(){return chunkB45ECEGY_js.ba}});Object.defineProperty(exports,"getTotalCacheSize",{enumerable:true,get:function(){return chunkB45ECEGY_js.oa}});Object.defineProperty(exports,"getTotalDocumentHeight",{enumerable:true,get:function(){return chunkB45ECEGY_js.za}});Object.defineProperty(exports,"getXForCharacter",{enumerable:true,get:function(){return chunkB45ECEGY_js.N}});Object.defineProperty(exports,"groupRectsByPage",{enumerable:true,get:function(){return chunkB45ECEGY_js.Ra}});Object.defineProperty(exports,"halfPtToPx",{enumerable:true,get:function(){return chunkB45ECEGY_js.S}});Object.defineProperty(exports,"hashParagraphBlock",{enumerable:true,get:function(){return chunkB45ECEGY_js.ha}});Object.defineProperty(exports,"hitTest",{enumerable:true,get:function(){return chunkB45ECEGY_js.ya}});Object.defineProperty(exports,"hitTestFragment",{enumerable:true,get:function(){return chunkB45ECEGY_js.va}});Object.defineProperty(exports,"hitTestImageFragment",{enumerable:true,get:function(){return chunkB45ECEGY_js.wa}});Object.defineProperty(exports,"hitTestPage",{enumerable:true,get:function(){return chunkB45ECEGY_js.sa}});Object.defineProperty(exports,"hitTestTableCell",{enumerable:true,get:function(){return chunkB45ECEGY_js.xa}});Object.defineProperty(exports,"isMultiPageSelection",{enumerable:true,get:function(){return chunkB45ECEGY_js.Qa}});Object.defineProperty(exports,"mapFootnotesToPages",{enumerable:true,get:function(){return chunkB45ECEGY_js.ob}});Object.defineProperty(exports,"measureParagraph",{enumerable:true,get:function(){return chunkB45ECEGY_js.W}});Object.defineProperty(exports,"measureParagraphs",{enumerable:true,get:function(){return chunkB45ECEGY_js.X}});Object.defineProperty(exports,"measureRun",{enumerable:true,get:function(){return chunkB45ECEGY_js.L}});Object.defineProperty(exports,"measureTableBlock",{enumerable:true,get:function(){return chunkB45ECEGY_js.Kb}});Object.defineProperty(exports,"measureTableCellBlockVisualHeight",{enumerable:true,get:function(){return chunkB45ECEGY_js.Jb}});Object.defineProperty(exports,"measureText",{enumerable:true,get:function(){return chunkB45ECEGY_js.K}});Object.defineProperty(exports,"measureTextWidth",{enumerable:true,get:function(){return chunkB45ECEGY_js.J}});Object.defineProperty(exports,"mouseToPosition",{enumerable:true,get:function(){return chunkB45ECEGY_js.La}});Object.defineProperty(exports,"normalizeHeaderFooterMeasureBlocks",{enumerable:true,get:function(){return chunkB45ECEGY_js.vb}});Object.defineProperty(exports,"normalizeTableColumnWidths",{enumerable:true,get:function(){return chunkB45ECEGY_js.E}});Object.defineProperty(exports,"positionToX",{enumerable:true,get:function(){return chunkB45ECEGY_js.Fa}});Object.defineProperty(exports,"ptToPx",{enumerable:true,get:function(){return chunkB45ECEGY_js.Q}});Object.defineProperty(exports,"pxToHalfPt",{enumerable:true,get:function(){return chunkB45ECEGY_js.T}});Object.defineProperty(exports,"pxToPt",{enumerable:true,get:function(){return chunkB45ECEGY_js.R}});Object.defineProperty(exports,"pxToTwips",{enumerable:true,get:function(){return chunkB45ECEGY_js.P}});Object.defineProperty(exports,"rectsToFloatingZones",{enumerable:true,get:function(){return chunkB45ECEGY_js.U}});Object.defineProperty(exports,"resetBlockIdCounter",{enumerable:true,get:function(){return chunkB45ECEGY_js.z}});Object.defineProperty(exports,"resetCanvasContext",{enumerable:true,get:function(){return chunkB45ECEGY_js.G}});Object.defineProperty(exports,"resolveHeaderFooter",{enumerable:true,get:function(){return chunkB45ECEGY_js.Rb}});Object.defineProperty(exports,"resolveHeaderFooterVisualTop",{enumerable:true,get:function(){return chunkB45ECEGY_js.wb}});Object.defineProperty(exports,"resolveListTemplate",{enumerable:true,get:function(){return chunkB45ECEGY_js.y}});Object.defineProperty(exports,"resolveTableWidthPx",{enumerable:true,get:function(){return chunkB45ECEGY_js.C}});Object.defineProperty(exports,"selectionToRects",{enumerable:true,get:function(){return chunkB45ECEGY_js.Oa}});Object.defineProperty(exports,"setCachedFontMetrics",{enumerable:true,get:function(){return chunkB45ECEGY_js.da}});Object.defineProperty(exports,"setCachedParagraphMeasure",{enumerable:true,get:function(){return chunkB45ECEGY_js.ja}});Object.defineProperty(exports,"setCachedTextWidth",{enumerable:true,get:function(){return chunkB45ECEGY_js._}});Object.defineProperty(exports,"setFontCacheSize",{enumerable:true,get:function(){return chunkB45ECEGY_js.fa}});Object.defineProperty(exports,"setParagraphCacheSize",{enumerable:true,get:function(){return chunkB45ECEGY_js.la}});Object.defineProperty(exports,"setTextCacheSize",{enumerable:true,get:function(){return chunkB45ECEGY_js.aa}});Object.defineProperty(exports,"stabilizeFootnoteLayout",{enumerable:true,get:function(){return chunkB45ECEGY_js.tb}});Object.defineProperty(exports,"toFlowBlocks",{enumerable:true,get:function(){return chunkB45ECEGY_js.B}});Object.defineProperty(exports,"twipsToPx",{enumerable:true,get:function(){return chunkB45ECEGY_js.O}});

package/dist/plugin-api.d.mts

@@ -0,0 +1,176 @@
+import { P as PluginHostProps, b as PluginHostRef, R as RenderedDomContext, c as PositionCoordinates, d as ReactEditorPlugin } from './types-Bd_YzkhG.mjs';
+export { E as EditorPlugin, e as PanelConfig, f as PluginContext, g as PluginPanelProps, a as ReactSidebarItem, S as SidebarItem, h as SidebarItemContext, i as SidebarItemRenderProps } from './types-Bd_YzkhG.mjs';
+import * as React from 'react';
+import * as prosemirror_state from 'prosemirror-state';
+import { Plugin, PluginKey } from 'prosemirror-state';
+import { DecorationSet, EditorView } from 'prosemirror-view';
+import 'prosemirror-model';
+
+declare const PLUGIN_HOST_STYLES = "\n.plugin-host {\n  display: flex;\n  width: 100%;\n  height: 100%;\n  overflow: visible;\n  position: relative;\n}\n\n.plugin-host-editor {\n  flex: 1;\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  overflow: visible;\n}\n\n\n.plugin-panels-left,\n.plugin-panels-right {\n  display: flex;\n  flex-direction: column;\n  flex-shrink: 0;\n  background: #f8f9fa;\n  border-color: #e9ecef;\n}\n\n.plugin-panels-left {\n  border-right: 1px solid #e9ecef;\n}\n\n.plugin-panels-right {\n  border-left: 1px solid #e9ecef;\n}\n\n.plugin-panels-bottom {\n  border-top: 1px solid #e9ecef;\n  background: #f8f9fa;\n}\n\n.plugin-panel {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  overflow: hidden;\n  transition: width 0.2s ease, height 0.2s ease;\n}\n\n.plugin-panel.collapsed {\n  overflow: visible;\n}\n\n.plugin-panel-toggle {\n  display: flex;\n  align-items: center;\n  gap: 4px;\n  padding: 6px 8px;\n  background: transparent;\n  border: none;\n  cursor: pointer;\n  font-size: 12px;\n  color: #6c757d;\n  white-space: nowrap;\n}\n\n.plugin-panel.collapsed .plugin-panel-toggle {\n  writing-mode: vertical-rl;\n  text-orientation: mixed;\n  flex-direction: column;\n  height: 100%;\n  padding: 8px 6px;\n}\n\n.plugin-panel-toggle:hover {\n  background: #e9ecef;\n  color: #495057;\n}\n\n.plugin-panel-toggle-icon {\n  font-weight: bold;\n  font-size: 14px;\n}\n\n.plugin-panel.collapsed .plugin-panel-toggle-icon {\n  transform: rotate(90deg);\n}\n\n.plugin-panel-toggle-label {\n  font-weight: 500;\n}\n\n.plugin-panel-content {\n  flex: 1;\n  overflow: auto;\n}\n\n/* Right panel rendered inside viewport - scrolls with content */\n.plugin-panel-in-viewport {\n  position: absolute;\n  top: 0;\n  /* Position is set dynamically via inline styles based on page edge */\n  width: 220px;\n  pointer-events: auto;\n  z-index: 10;\n  overflow: visible;\n}\n\n.plugin-panel-in-viewport.collapsed {\n  width: 32px;\n}\n\n.plugin-panel-in-viewport .plugin-panel-toggle {\n  position: sticky;\n  top: 0;\n  background: rgba(255, 255, 255, 0.95);\n  border-radius: 4px;\n  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);\n}\n\n.plugin-panel-in-viewport-content {\n  overflow: visible;\n  position: relative;\n}\n\n/* Plugin overlay container for rendering highlights/decorations */\n.plugin-overlays-container {\n  position: absolute;\n  top: 0;\n  left: 0;\n  right: 0;\n  bottom: 0;\n  pointer-events: none;\n  overflow: visible;\n  z-index: 5;\n}\n\n.plugin-overlay {\n  position: absolute;\n  top: 0;\n  left: 0;\n  right: 0;\n  bottom: 0;\n  pointer-events: none;\n}\n\n/* Individual overlay children manage their own pointer-events.\n   Do NOT set pointer-events: auto here \u2014 it overrides overlay containers\n   that need pointer-events: none to let clicks pass through to the editor. */\n";
+/**
+ * PluginHost Component
+ *
+ * Wraps the editor and provides:
+ * - Plugin state management
+ * - Panel rendering for each plugin
+ * - CSS injection for plugin styles
+ * - Callbacks for editor interaction
+ */
+declare const PluginHost: React.ForwardRefExoticComponent<PluginHostProps & React.RefAttributes<PluginHostRef>>;
+
+/**
+ * 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.
+ */
+
+/**
+ * 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;
+
+/**
+ * Template tag types
+ */
+type TagType = 'variable' | 'sectionStart' | 'sectionEnd' | 'invertedStart' | 'raw';
+/**
+ * A found template tag
+ */
+interface TemplateTag {
+    id: string;
+    type: TagType;
+    name: string;
+    rawTag: string;
+    from: number;
+    to: number;
+    /** For sections: nested variable names */
+    nestedVars?: string[];
+    /** True if this variable is inside a section (shown in section's nested vars) */
+    insideSection?: boolean;
+}
+/**
+ * Plugin state
+ */
+interface TemplatePluginState$1 {
+    tags: TemplateTag[];
+    decorations: DecorationSet;
+    hoveredId?: string;
+    selectedId?: string;
+}
+/**
+ * Plugin key
+ */
+declare const templatePluginKey: PluginKey<TemplatePluginState$1>;
+/**
+ * Create the template plugin
+ */
+declare function createTemplatePlugin(): Plugin<TemplatePluginState$1>;
+/**
+ * Get tags from editor state
+ */
+declare function getTemplateTags(state: prosemirror_state.EditorState): TemplateTag[];
+/**
+ * Set hovered tag
+ */
+declare function setHoveredElement(view: EditorView, id: string | undefined): void;
+/**
+ * Set selected tag
+ */
+declare function setSelectedElement(view: EditorView, id: string | undefined): void;
+/**
+ * CSS styles for template decorations
+ */
+declare const TEMPLATE_DECORATION_STYLES = "\n.docx-template-tag {\n  cursor: pointer;\n  transition: background-color 0.1s;\n}\n\n.docx-template-tag:hover,\n.docx-template-tag.hovered {\n  filter: brightness(0.95);\n}\n\n.docx-template-tag.selected {\n  box-shadow: 0 0 0 2px rgba(59, 130, 246, 0.5);\n}\n";
+
+/**
+ * Template Plugin
+ *
+ * Docxtemplater template support as a plugin for the DOCX Editor.
+ *
+ * Features:
+ * - Full docxtemplater syntax detection (variables, loops, conditionals)
+ * - Sidebar annotation chips showing template structure (via getSidebarItems)
+ * - Differentiated visual highlighting by element type
+ *
+ * @example
+ * ```tsx
+ * import { PluginHost, templatePlugin } from '@eigenpal/docx-editor-react/plugin-api';
+ *
+ * function MyEditor() {
+ *   return (
+ *     <PluginHost plugins={[templatePlugin]}>
+ *       <DocxEditor document={doc} onChange={handleChange} />
+ *     </PluginHost>
+ *   );
+ * }
+ * ```
+ */
+
+interface TemplatePluginState {
+    tags: TemplateTag[];
+    hoveredId?: string;
+    selectedId?: string;
+}
+/**
+ * Create the template plugin instance.
+ */
+declare function createPlugin(_options?: {
+    /** @deprecated — panel is no longer used; template chips render in the unified sidebar */
+    defaultCollapsed?: boolean;
+    /** @deprecated */
+    panelPosition?: 'left' | 'right';
+    /** @deprecated */
+    panelWidth?: number;
+}): ReactEditorPlugin<TemplatePluginState>;
+/**
+ * Default template plugin instance.
+ */
+declare const templatePlugin: ReactEditorPlugin<TemplatePluginState>;
+
+export { PLUGIN_HOST_STYLES, PluginHost, PluginHostProps, PluginHostRef, PositionCoordinates, ReactEditorPlugin, RenderedDomContext, RenderedDomContextImpl, TEMPLATE_DECORATION_STYLES, type TagType, type TemplateTag, createRenderedDomContext, createPlugin as createTemplatePlugin, createTemplatePlugin as createTemplateProseMirrorPlugin, getTemplateTags as getTemplatePluginTags, setHoveredElement, setSelectedElement, templatePlugin, templatePluginKey };

package/dist/plugin-api.d.ts

@@ -0,0 +1,176 @@
+import { P as PluginHostProps, b as PluginHostRef, R as RenderedDomContext, c as PositionCoordinates, d as ReactEditorPlugin } from './types-Bd_YzkhG.js';
+export { E as EditorPlugin, e as PanelConfig, f as PluginContext, g as PluginPanelProps, a as ReactSidebarItem, S as SidebarItem, h as SidebarItemContext, i as SidebarItemRenderProps } from './types-Bd_YzkhG.js';
+import * as React from 'react';
+import * as prosemirror_state from 'prosemirror-state';
+import { Plugin, PluginKey } from 'prosemirror-state';
+import { DecorationSet, EditorView } from 'prosemirror-view';
+import 'prosemirror-model';
+
+declare const PLUGIN_HOST_STYLES = "\n.plugin-host {\n  display: flex;\n  width: 100%;\n  height: 100%;\n  overflow: visible;\n  position: relative;\n}\n\n.plugin-host-editor {\n  flex: 1;\n  display: flex;\n  flex-direction: column;\n  min-width: 0;\n  overflow: visible;\n}\n\n\n.plugin-panels-left,\n.plugin-panels-right {\n  display: flex;\n  flex-direction: column;\n  flex-shrink: 0;\n  background: #f8f9fa;\n  border-color: #e9ecef;\n}\n\n.plugin-panels-left {\n  border-right: 1px solid #e9ecef;\n}\n\n.plugin-panels-right {\n  border-left: 1px solid #e9ecef;\n}\n\n.plugin-panels-bottom {\n  border-top: 1px solid #e9ecef;\n  background: #f8f9fa;\n}\n\n.plugin-panel {\n  position: relative;\n  display: flex;\n  flex-direction: column;\n  overflow: hidden;\n  transition: width 0.2s ease, height 0.2s ease;\n}\n\n.plugin-panel.collapsed {\n  overflow: visible;\n}\n\n.plugin-panel-toggle {\n  display: flex;\n  align-items: center;\n  gap: 4px;\n  padding: 6px 8px;\n  background: transparent;\n  border: none;\n  cursor: pointer;\n  font-size: 12px;\n  color: #6c757d;\n  white-space: nowrap;\n}\n\n.plugin-panel.collapsed .plugin-panel-toggle {\n  writing-mode: vertical-rl;\n  text-orientation: mixed;\n  flex-direction: column;\n  height: 100%;\n  padding: 8px 6px;\n}\n\n.plugin-panel-toggle:hover {\n  background: #e9ecef;\n  color: #495057;\n}\n\n.plugin-panel-toggle-icon {\n  font-weight: bold;\n  font-size: 14px;\n}\n\n.plugin-panel.collapsed .plugin-panel-toggle-icon {\n  transform: rotate(90deg);\n}\n\n.plugin-panel-toggle-label {\n  font-weight: 500;\n}\n\n.plugin-panel-content {\n  flex: 1;\n  overflow: auto;\n}\n\n/* Right panel rendered inside viewport - scrolls with content */\n.plugin-panel-in-viewport {\n  position: absolute;\n  top: 0;\n  /* Position is set dynamically via inline styles based on page edge */\n  width: 220px;\n  pointer-events: auto;\n  z-index: 10;\n  overflow: visible;\n}\n\n.plugin-panel-in-viewport.collapsed {\n  width: 32px;\n}\n\n.plugin-panel-in-viewport .plugin-panel-toggle {\n  position: sticky;\n  top: 0;\n  background: rgba(255, 255, 255, 0.95);\n  border-radius: 4px;\n  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);\n}\n\n.plugin-panel-in-viewport-content {\n  overflow: visible;\n  position: relative;\n}\n\n/* Plugin overlay container for rendering highlights/decorations */\n.plugin-overlays-container {\n  position: absolute;\n  top: 0;\n  left: 0;\n  right: 0;\n  bottom: 0;\n  pointer-events: none;\n  overflow: visible;\n  z-index: 5;\n}\n\n.plugin-overlay {\n  position: absolute;\n  top: 0;\n  left: 0;\n  right: 0;\n  bottom: 0;\n  pointer-events: none;\n}\n\n/* Individual overlay children manage their own pointer-events.\n   Do NOT set pointer-events: auto here \u2014 it overrides overlay containers\n   that need pointer-events: none to let clicks pass through to the editor. */\n";
+/**
+ * PluginHost Component
+ *
+ * Wraps the editor and provides:
+ * - Plugin state management
+ * - Panel rendering for each plugin
+ * - CSS injection for plugin styles
+ * - Callbacks for editor interaction
+ */
+declare const PluginHost: React.ForwardRefExoticComponent<PluginHostProps & React.RefAttributes<PluginHostRef>>;
+
+/**
+ * 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.
+ */
+
+/**
+ * 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;
+
+/**
+ * Template tag types
+ */
+type TagType = 'variable' | 'sectionStart' | 'sectionEnd' | 'invertedStart' | 'raw';
+/**
+ * A found template tag
+ */
+interface TemplateTag {
+    id: string;
+    type: TagType;
+    name: string;
+    rawTag: string;
+    from: number;
+    to: number;
+    /** For sections: nested variable names */
+    nestedVars?: string[];
+    /** True if this variable is inside a section (shown in section's nested vars) */
+    insideSection?: boolean;
+}
+/**
+ * Plugin state
+ */
+interface TemplatePluginState$1 {
+    tags: TemplateTag[];
+    decorations: DecorationSet;
+    hoveredId?: string;
+    selectedId?: string;
+}
+/**
+ * Plugin key
+ */
+declare const templatePluginKey: PluginKey<TemplatePluginState$1>;
+/**
+ * Create the template plugin
+ */
+declare function createTemplatePlugin(): Plugin<TemplatePluginState$1>;
+/**
+ * Get tags from editor state
+ */
+declare function getTemplateTags(state: prosemirror_state.EditorState): TemplateTag[];
+/**
+ * Set hovered tag
+ */
+declare function setHoveredElement(view: EditorView, id: string | undefined): void;
+/**
+ * Set selected tag
+ */
+declare function setSelectedElement(view: EditorView, id: string | undefined): void;
+/**
+ * CSS styles for template decorations
+ */
+declare const TEMPLATE_DECORATION_STYLES = "\n.docx-template-tag {\n  cursor: pointer;\n  transition: background-color 0.1s;\n}\n\n.docx-template-tag:hover,\n.docx-template-tag.hovered {\n  filter: brightness(0.95);\n}\n\n.docx-template-tag.selected {\n  box-shadow: 0 0 0 2px rgba(59, 130, 246, 0.5);\n}\n";
+
+/**
+ * Template Plugin
+ *
+ * Docxtemplater template support as a plugin for the DOCX Editor.
+ *
+ * Features:
+ * - Full docxtemplater syntax detection (variables, loops, conditionals)
+ * - Sidebar annotation chips showing template structure (via getSidebarItems)
+ * - Differentiated visual highlighting by element type
+ *
+ * @example
+ * ```tsx
+ * import { PluginHost, templatePlugin } from '@eigenpal/docx-editor-react/plugin-api';
+ *
+ * function MyEditor() {
+ *   return (
+ *     <PluginHost plugins={[templatePlugin]}>
+ *       <DocxEditor document={doc} onChange={handleChange} />
+ *     </PluginHost>
+ *   );
+ * }
+ * ```
+ */
+
+interface TemplatePluginState {
+    tags: TemplateTag[];
+    hoveredId?: string;
+    selectedId?: string;
+}
+/**
+ * Create the template plugin instance.
+ */
+declare function createPlugin(_options?: {
+    /** @deprecated — panel is no longer used; template chips render in the unified sidebar */
+    defaultCollapsed?: boolean;
+    /** @deprecated */
+    panelPosition?: 'left' | 'right';
+    /** @deprecated */
+    panelWidth?: number;
+}): ReactEditorPlugin<TemplatePluginState>;
+/**
+ * Default template plugin instance.
+ */
+declare const templatePlugin: ReactEditorPlugin<TemplatePluginState>;
+
+export { PLUGIN_HOST_STYLES, PluginHost, PluginHostProps, PluginHostRef, PositionCoordinates, ReactEditorPlugin, RenderedDomContext, RenderedDomContextImpl, TEMPLATE_DECORATION_STYLES, type TagType, type TemplateTag, createRenderedDomContext, createPlugin as createTemplatePlugin, createTemplatePlugin as createTemplateProseMirrorPlugin, getTemplateTags as getTemplatePluginTags, setHoveredElement, setSelectedElement, templatePlugin, templatePluginKey };