@eigenpal/docx-editor-core 0.0.0

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

@@ -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.js';
+import '../../types/content.js';
+import '../../formatting-BwpZWdGi.js';
+import '../../colors-C3vA7HUU.js';
+import '../../docx/wrapTypes.js';
+import '../../lists-CdiIk_c1.js';
+
+/**
+ * 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 };

package/dist/prosemirror/utils/extractTrackedChanges.js

@@ -0,0 +1 @@
+'use strict';require('../../chunk-DC7S76ZX.js');var l={entries:[],commentToRevision:new Map};function k(d){if(!d)return l;let{doc:h,schema:i}=d,a=i.marks.insertion,u=i.marks.deletion,p=i.marks.comment;if(!a&&!u)return l;let f=[],m=new Map;h.descendants((e,t)=>{if(!e.isText)return;let r=null;for(let n of e.marks)(n.type===a||n.type===u)&&(f.push({type:n.type===a?"insertion":"deletion",text:e.text||"",author:n.attrs.author||"",date:n.attrs.date,from:t,to:t+e.nodeSize,revisionId:n.attrs.revisionId}),r=n);if(p&&r){let n=e.marks.find(s=>s.type===p);if(n){let s=n.attrs.commentId,y=r.attrs.revisionId;m.has(s)||m.set(s,y);}}});let o=[];for(let e of f){let t=o[o.length-1];t&&t.revisionId===e.revisionId&&t.type===e.type&&t.to===e.from?(t.text+=e.text,t.to=e.to):o.push({...e});}let c=[];for(let e=0;e<o.length;e++){let t=o[e],r=o[e+1];t.type==="deletion"&&r&&r.type==="insertion"&&t.author===r.author&&t.date===r.date&&t.to===r.from?(c.push({type:"replacement",text:r.text,deletedText:t.text,author:t.author,date:t.date,from:t.from,to:r.to,revisionId:t.revisionId,insertionRevisionId:r.revisionId}),e++):c.push(t);}return {entries:c,commentToRevision:m}}exports.extractTrackedChanges=k;

package/dist/prosemirror/utils/extractTrackedChanges.mjs

@@ -0,0 +1 @@
+import'../../chunk-QYUPLKLP.mjs';var l={entries:[],commentToRevision:new Map};function k(d){if(!d)return l;let{doc:h,schema:i}=d,a=i.marks.insertion,u=i.marks.deletion,p=i.marks.comment;if(!a&&!u)return l;let f=[],m=new Map;h.descendants((e,t)=>{if(!e.isText)return;let r=null;for(let n of e.marks)(n.type===a||n.type===u)&&(f.push({type:n.type===a?"insertion":"deletion",text:e.text||"",author:n.attrs.author||"",date:n.attrs.date,from:t,to:t+e.nodeSize,revisionId:n.attrs.revisionId}),r=n);if(p&&r){let n=e.marks.find(s=>s.type===p);if(n){let s=n.attrs.commentId,y=r.attrs.revisionId;m.has(s)||m.set(s,y);}}});let o=[];for(let e of f){let t=o[o.length-1];t&&t.revisionId===e.revisionId&&t.type===e.type&&t.to===e.from?(t.text+=e.text,t.to=e.to):o.push({...e});}let c=[];for(let e=0;e<o.length;e++){let t=o[e],r=o[e+1];t.type==="deletion"&&r&&r.type==="insertion"&&t.author===r.author&&t.date===r.date&&t.to===r.from?(c.push({type:"replacement",text:r.text,deletedText:t.text,author:t.author,date:t.date,from:t.from,to:r.to,revisionId:t.revisionId,insertionRevisionId:r.revisionId}),e++):c.push(t);}return {entries:c,commentToRevision:m}}export{k as extractTrackedChanges};

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

@@ -0,0 +1,45 @@
+/**
+ * Visual line navigation helpers — implements Word/Google-Docs-style
+ * ArrowUp / ArrowDown with sticky X across visual lines (not just
+ * paragraphs). Lifted from packages/react/src/paged-editor/
+ * useVisualLineNavigation.ts so both adapters share the algorithm.
+ *
+ * Frontend-agnostic: takes a `getContainer: () => HTMLElement | null`
+ * callback and a mutable sticky-state object, returns the same
+ * function quartet React's hook returns.
+ *
+ * @remarks
+ * Tagged `@internal` post-1.0 cut. Both adapters re-export this through
+ * their own composables (`useVisualLineNavigation`); 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 { EditorView } from 'prosemirror-view';
+
+/** @internal */
+interface VisualLineState {
+    stickyX: number | null;
+    lastVisualLineIndex: number;
+}
+/** @internal */
+declare function createVisualLineState(): VisualLineState;
+/** @internal */
+declare function getCaretClientX(container: HTMLElement, pmPos: number): number | null;
+/** @internal */
+declare function findLineElementAtPosition(container: HTMLElement, pmPos: number): HTMLElement | null;
+/** @internal */
+declare function findPositionOnLineAtClientX(lineEl: HTMLElement, clientX: number): number | null;
+/**
+ * Handle PM ArrowUp / ArrowDown with visual-line awareness + sticky
+ * X. Returns true if the event was handled and PM should not run
+ * its default behaviour. Mutates `state` so consecutive presses
+ * keep the same sticky X.
+ */
+/** @internal */
+declare function handleVisualLineKeyDown(state: VisualLineState, view: EditorView, event: KeyboardEvent, container: HTMLElement | null): boolean;
+
+export { type VisualLineState, createVisualLineState, findLineElementAtPosition, findPositionOnLineAtClientX, getCaretClientX, handleVisualLineKeyDown };

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

@@ -0,0 +1,45 @@
+/**
+ * Visual line navigation helpers — implements Word/Google-Docs-style
+ * ArrowUp / ArrowDown with sticky X across visual lines (not just
+ * paragraphs). Lifted from packages/react/src/paged-editor/
+ * useVisualLineNavigation.ts so both adapters share the algorithm.
+ *
+ * Frontend-agnostic: takes a `getContainer: () => HTMLElement | null`
+ * callback and a mutable sticky-state object, returns the same
+ * function quartet React's hook returns.
+ *
+ * @remarks
+ * Tagged `@internal` post-1.0 cut. Both adapters re-export this through
+ * their own composables (`useVisualLineNavigation`); 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 { EditorView } from 'prosemirror-view';
+
+/** @internal */
+interface VisualLineState {
+    stickyX: number | null;
+    lastVisualLineIndex: number;
+}
+/** @internal */
+declare function createVisualLineState(): VisualLineState;
+/** @internal */
+declare function getCaretClientX(container: HTMLElement, pmPos: number): number | null;
+/** @internal */
+declare function findLineElementAtPosition(container: HTMLElement, pmPos: number): HTMLElement | null;
+/** @internal */
+declare function findPositionOnLineAtClientX(lineEl: HTMLElement, clientX: number): number | null;
+/**
+ * Handle PM ArrowUp / ArrowDown with visual-line awareness + sticky
+ * X. Returns true if the event was handled and PM should not run
+ * its default behaviour. Mutates `state` so consecutive presses
+ * keep the same sticky X.
+ */
+/** @internal */
+declare function handleVisualLineKeyDown(state: VisualLineState, view: EditorView, event: KeyboardEvent, container: HTMLElement | null): boolean;
+
+export { type VisualLineState, createVisualLineState, findLineElementAtPosition, findPositionOnLineAtClientX, getCaretClientX, handleVisualLineKeyDown };

package/dist/prosemirror/utils/visualLineNavigation.js

@@ -0,0 +1 @@
+'use strict';var chunkJY5EFI4D_js=require('../../chunk-JY5EFI4D.js');require('../../chunk-DC7S76ZX.js');var prosemirrorState=require('prosemirror-state');var S=".layout-page-content .layout-line";function C(){return {stickyX:null,lastVisualLineIndex:-1}}function T(o){let t=chunkJY5EFI4D_js.a(o);if(!t)return;let n=o.getBoundingClientRect(),l=t.getBoundingClientRect(),e=40;n.bottom>l.bottom-e?t.scrollTop+=n.bottom-l.bottom+e:n.top<l.top+e&&(t.scrollTop-=l.top-n.top+e);}function x(o,t){let n=o.querySelectorAll("span[data-pm-start][data-pm-end]");for(let e of Array.from(n)){let i=e,c=Number(i.dataset.pmStart),r=Number(i.dataset.pmEnd);if(i.classList.contains("layout-run-tab")){if(t>=c&&t<r)return i.getBoundingClientRect().left;continue}if(t>=c&&t<=r&&e.firstChild?.nodeType===Node.TEXT_NODE){let a=e.firstChild,u=Math.min(t-c,a.length),p=i.ownerDocument;if(!p)continue;let f=p.createRange();return f.setStart(a,u),f.setEnd(a,u),f.getBoundingClientRect().left}}let l=o.querySelectorAll(".layout-empty-run");for(let e of Array.from(l)){let i=e.closest(".layout-paragraph");if(!i)continue;let c=Number(i.dataset.pmStart),r=Number(i.dataset.pmEnd);if(t>=c&&t<=r)return e.getBoundingClientRect().left}return null}function M(o,t){let n=o.querySelectorAll(S);for(let l of Array.from(n)){let e=l,i=e.querySelectorAll("span[data-pm-start][data-pm-end]");for(let c of Array.from(i)){let r=c,a=Number(r.dataset.pmStart),u=Number(r.dataset.pmEnd);if(t>=a&&t<=u)return e}}for(let l of Array.from(n)){let e=l,i=e.closest(".layout-paragraph");if(!i)continue;let c=Number(i.dataset.pmStart),r=Number(i.dataset.pmEnd);if(t>=c&&t<=r&&i.querySelector(".layout-line")===e)return e}return null}function N(o,t){let n=o.querySelectorAll("span[data-pm-start][data-pm-end]");if(n.length===0){let c=o.closest(".layout-paragraph");return c?.dataset.pmStart?Number(c.dataset.pmStart)+1:null}for(let c of Array.from(n)){let r=c,a=r.getBoundingClientRect(),u=Number(r.dataset.pmStart),p=Number(r.dataset.pmEnd);if(r.classList.contains("layout-run-tab")){if(t>=a.left&&t<=a.right){let f=(a.left+a.right)/2;return t<f?u:p}continue}if(t>=a.left&&t<=a.right){let f=r.firstChild;if(!f||f.nodeType!==Node.TEXT_NODE)return u;let m=f,g=r.ownerDocument;if(!g)return u;let s=0,y=m.length;for(;s<y;){let d=Math.floor((s+y)/2),E=g.createRange();E.setStart(m,d),E.setEnd(m,d),t<E.getBoundingClientRect().left?y=d:s=d+1;}if(s>0&&s<=m.length){let d=g.createRange();d.setStart(m,s-1),d.setEnd(m,s-1);let E=d.getBoundingClientRect().left;d.setStart(m,Math.min(s,m.length)),d.setEnd(m,Math.min(s,m.length));let b=d.getBoundingClientRect().left;if(Math.abs(t-E)<Math.abs(t-b))return u+(s-1)}return u+Math.min(s,p-u)}}let l=null,e=1/0;for(let c of Array.from(n)){let r=c,a=r.getBoundingClientRect(),u=t<a.left?a.left-t:t-a.right;u<e&&(e=u,l=r);}if(!l)return null;let i=l.getBoundingClientRect();return t<i.left?Number(l.dataset.pmStart):Number(l.dataset.pmEnd)}function w(o,t,n,l){if(n.key!=="ArrowUp"&&n.key!=="ArrowDown")return (["ArrowLeft","ArrowRight","Home","End"].includes(n.key)||n.key.length===1&&!n.ctrlKey&&!n.metaKey)&&(o.stickyX=null,o.lastVisualLineIndex=-1),false;if(n.ctrlKey||n.metaKey)return o.stickyX=null,o.lastVisualLineIndex=-1,false;if(!l)return  false;let e=Array.from(l.querySelectorAll(S));if(e.length===0)return  false;let{from:i,anchor:c}=t.state.selection;if(o.stickyX===null){let s=x(l,i);if(s===null)return  false;o.stickyX=s;}let r;if(o.lastVisualLineIndex>=0&&o.lastVisualLineIndex<e.length)r=o.lastVisualLineIndex;else {let s=M(l,i);if(!s||(r=e.indexOf(s),r===-1))return  false}let a=n.key==="ArrowUp"?r-1:r+1;if(a<0||a>=e.length)return o.lastVisualLineIndex=-1,false;let u=e[a],p=N(u,o.stickyX);if(p===null)return  false;o.lastVisualLineIndex=a;let{state:f,dispatch:m}=t,g=Math.max(0,Math.min(p,f.doc.content.size));try{let s=n.shiftKey?prosemirrorState.TextSelection.create(f.doc,c,g):prosemirrorState.TextSelection.create(f.doc,g);m(f.tr.setSelection(s));}catch{let s=f.doc.resolve(g),y=n.shiftKey?prosemirrorState.TextSelection.between(f.doc.resolve(c),s):prosemirrorState.TextSelection.near(s);m(f.tr.setSelection(y));}return T(u),true}exports.createVisualLineState=C;exports.findLineElementAtPosition=M;exports.findPositionOnLineAtClientX=N;exports.getCaretClientX=x;exports.handleVisualLineKeyDown=w;

package/dist/prosemirror/utils/visualLineNavigation.mjs

@@ -0,0 +1 @@
+import {a}from'../../chunk-RPIQG46O.mjs';import'../../chunk-QYUPLKLP.mjs';import {TextSelection}from'prosemirror-state';var S=".layout-page-content .layout-line";function C(){return {stickyX:null,lastVisualLineIndex:-1}}function T(o){let t=a(o);if(!t)return;let n=o.getBoundingClientRect(),l=t.getBoundingClientRect(),e=40;n.bottom>l.bottom-e?t.scrollTop+=n.bottom-l.bottom+e:n.top<l.top+e&&(t.scrollTop-=l.top-n.top+e);}function x(o,t){let n=o.querySelectorAll("span[data-pm-start][data-pm-end]");for(let e of Array.from(n)){let i=e,c=Number(i.dataset.pmStart),r=Number(i.dataset.pmEnd);if(i.classList.contains("layout-run-tab")){if(t>=c&&t<r)return i.getBoundingClientRect().left;continue}if(t>=c&&t<=r&&e.firstChild?.nodeType===Node.TEXT_NODE){let a=e.firstChild,u=Math.min(t-c,a.length),p=i.ownerDocument;if(!p)continue;let f=p.createRange();return f.setStart(a,u),f.setEnd(a,u),f.getBoundingClientRect().left}}let l=o.querySelectorAll(".layout-empty-run");for(let e of Array.from(l)){let i=e.closest(".layout-paragraph");if(!i)continue;let c=Number(i.dataset.pmStart),r=Number(i.dataset.pmEnd);if(t>=c&&t<=r)return e.getBoundingClientRect().left}return null}function M(o,t){let n=o.querySelectorAll(S);for(let l of Array.from(n)){let e=l,i=e.querySelectorAll("span[data-pm-start][data-pm-end]");for(let c of Array.from(i)){let r=c,a=Number(r.dataset.pmStart),u=Number(r.dataset.pmEnd);if(t>=a&&t<=u)return e}}for(let l of Array.from(n)){let e=l,i=e.closest(".layout-paragraph");if(!i)continue;let c=Number(i.dataset.pmStart),r=Number(i.dataset.pmEnd);if(t>=c&&t<=r&&i.querySelector(".layout-line")===e)return e}return null}function N(o,t){let n=o.querySelectorAll("span[data-pm-start][data-pm-end]");if(n.length===0){let c=o.closest(".layout-paragraph");return c?.dataset.pmStart?Number(c.dataset.pmStart)+1:null}for(let c of Array.from(n)){let r=c,a=r.getBoundingClientRect(),u=Number(r.dataset.pmStart),p=Number(r.dataset.pmEnd);if(r.classList.contains("layout-run-tab")){if(t>=a.left&&t<=a.right){let f=(a.left+a.right)/2;return t<f?u:p}continue}if(t>=a.left&&t<=a.right){let f=r.firstChild;if(!f||f.nodeType!==Node.TEXT_NODE)return u;let m=f,g=r.ownerDocument;if(!g)return u;let s=0,y=m.length;for(;s<y;){let d=Math.floor((s+y)/2),E=g.createRange();E.setStart(m,d),E.setEnd(m,d),t<E.getBoundingClientRect().left?y=d:s=d+1;}if(s>0&&s<=m.length){let d=g.createRange();d.setStart(m,s-1),d.setEnd(m,s-1);let E=d.getBoundingClientRect().left;d.setStart(m,Math.min(s,m.length)),d.setEnd(m,Math.min(s,m.length));let b=d.getBoundingClientRect().left;if(Math.abs(t-E)<Math.abs(t-b))return u+(s-1)}return u+Math.min(s,p-u)}}let l=null,e=1/0;for(let c of Array.from(n)){let r=c,a=r.getBoundingClientRect(),u=t<a.left?a.left-t:t-a.right;u<e&&(e=u,l=r);}if(!l)return null;let i=l.getBoundingClientRect();return t<i.left?Number(l.dataset.pmStart):Number(l.dataset.pmEnd)}function w(o,t,n,l){if(n.key!=="ArrowUp"&&n.key!=="ArrowDown")return (["ArrowLeft","ArrowRight","Home","End"].includes(n.key)||n.key.length===1&&!n.ctrlKey&&!n.metaKey)&&(o.stickyX=null,o.lastVisualLineIndex=-1),false;if(n.ctrlKey||n.metaKey)return o.stickyX=null,o.lastVisualLineIndex=-1,false;if(!l)return  false;let e=Array.from(l.querySelectorAll(S));if(e.length===0)return  false;let{from:i,anchor:c}=t.state.selection;if(o.stickyX===null){let s=x(l,i);if(s===null)return  false;o.stickyX=s;}let r;if(o.lastVisualLineIndex>=0&&o.lastVisualLineIndex<e.length)r=o.lastVisualLineIndex;else {let s=M(l,i);if(!s||(r=e.indexOf(s),r===-1))return  false}let a=n.key==="ArrowUp"?r-1:r+1;if(a<0||a>=e.length)return o.lastVisualLineIndex=-1,false;let u=e[a],p=N(u,o.stickyX);if(p===null)return  false;o.lastVisualLineIndex=a;let{state:f,dispatch:m}=t,g=Math.max(0,Math.min(p,f.doc.content.size));try{let s=n.shiftKey?TextSelection.create(f.doc,c,g):TextSelection.create(f.doc,g);m(f.tr.setSelection(s));}catch{let s=f.doc.resolve(g),y=n.shiftKey?TextSelection.between(f.doc.resolve(c),s):TextSelection.near(s);m(f.tr.setSelection(y));}return T(u),true}export{C as createVisualLineState,M as findLineElementAtPosition,N as findPositionOnLineAtClientX,x as getCaretClientX,w as handleVisualLineKeyDown};

package/dist/registry-Cpyybgij.d.mts

@@ -0,0 +1,165 @@
+import { b as CorePlugin, k as PluginOptions, l as PluginRegistrationResult, C as CommandHandler, f as McpToolDefinition, j as PluginEventListener } from './types-dYdjUZMo.mjs';
+
+/**
+ * Plugin Registry
+ *
+ * Central registry for core plugins. Manages plugin lifecycle,
+ * collects command handlers from all plugins, and aggregates
+ * MCP tool definitions for the MCP server.
+ */
+
+/**
+ * Plugin Registry - manages core plugins
+ *
+ * @example
+ * ```ts
+ * import { pluginRegistry, docxtemplaterPlugin } from '@eigenpal/docx-editor/core-plugins';
+ *
+ * // Register plugins
+ * pluginRegistry.register(docxtemplaterPlugin);
+ *
+ * // Get all MCP tools for MCP server
+ * const tools = pluginRegistry.getMcpTools();
+ *
+ * // Get command handler for executor
+ * const handler = pluginRegistry.getCommandHandler('insertTemplateVariable');
+ * ```
+ */
+declare class PluginRegistry {
+    private plugins;
+    private commandHandlers;
+    private eventListeners;
+    private initialized;
+    /**
+     * Register a plugin
+     *
+     * @param plugin - The plugin to register
+     * @param options - Optional configuration
+     * @returns Registration result
+     */
+    register(plugin: CorePlugin, options?: PluginOptions): PluginRegistrationResult;
+    /**
+     * Unregister a plugin
+     *
+     * @param pluginId - ID of the plugin to unregister
+     * @returns Whether unregistration succeeded
+     */
+    unregister(pluginId: string): boolean;
+    /**
+     * Get a registered plugin by ID
+     *
+     * @param id - Plugin ID
+     * @returns The plugin or undefined
+     */
+    get(id: string): CorePlugin | undefined;
+    /**
+     * Get all registered plugins
+     *
+     * @returns Array of all plugins
+     */
+    getAll(): CorePlugin[];
+    /**
+     * Check if a plugin is registered
+     *
+     * @param id - Plugin ID
+     * @returns Whether the plugin is registered
+     */
+    has(id: string): boolean;
+    /**
+     * Get number of registered plugins
+     */
+    get size(): number;
+    /**
+     * Get a command handler for a command type
+     *
+     * @param commandType - The command type
+     * @returns The handler or undefined
+     */
+    getCommandHandler(commandType: string): CommandHandler | undefined;
+    /**
+     * Get all registered command types
+     *
+     * @returns Array of command type strings
+     */
+    getCommandTypes(): string[];
+    /**
+     * Check if a command type has a handler
+     *
+     * @param commandType - The command type
+     * @returns Whether a handler exists
+     */
+    hasCommandHandler(commandType: string): boolean;
+    /**
+     * Get all MCP tools from all registered plugins
+     *
+     * @returns Array of MCP tool definitions
+     */
+    getMcpTools(): McpToolDefinition[];
+    /**
+     * Get MCP tools from a specific plugin
+     *
+     * @param pluginId - Plugin ID
+     * @returns Array of MCP tool definitions
+     */
+    getMcpToolsForPlugin(pluginId: string): McpToolDefinition[];
+    /**
+     * Get an MCP tool by name
+     *
+     * @param toolName - Tool name
+     * @returns The tool definition or undefined
+     */
+    getMcpTool(toolName: string): McpToolDefinition | undefined;
+    /**
+     * Add an event listener
+     *
+     * @param listener - Event listener function
+     */
+    addEventListener(listener: PluginEventListener): void;
+    /**
+     * Remove an event listener
+     *
+     * @param listener - Event listener function
+     */
+    removeEventListener(listener: PluginEventListener): void;
+    /**
+     * Emit an event to all listeners
+     */
+    private emit;
+    /**
+     * Clear all registered plugins
+     *
+     * Useful for testing or resetting state.
+     */
+    clear(): void;
+    /**
+     * Get registry state for debugging
+     */
+    getDebugInfo(): {
+        plugins: string[];
+        commandTypes: string[];
+        mcpTools: string[];
+        initialized: string[];
+    };
+}
+/**
+ * Global plugin registry instance
+ *
+ * Use this for registering plugins and accessing their capabilities.
+ */
+declare const pluginRegistry: PluginRegistry;
+/**
+ * Register multiple plugins at once
+ *
+ * @param plugins - Array of plugins to register
+ * @returns Array of registration results
+ */
+declare function registerPlugins(plugins: CorePlugin[], options?: PluginOptions): PluginRegistrationResult[];
+/**
+ * Create a plugin registration helper with options pre-configured
+ *
+ * @param options - Default options for plugin registration
+ * @returns Registration function
+ */
+declare function createPluginRegistrar(options: PluginOptions): (plugin: CorePlugin) => PluginRegistrationResult;
+
+export { PluginRegistry as P, createPluginRegistrar as c, pluginRegistry as p, registerPlugins as r };

package/dist/registry-E5pahPKL.d.ts

@@ -0,0 +1,165 @@
+import { b as CorePlugin, k as PluginOptions, l as PluginRegistrationResult, C as CommandHandler, f as McpToolDefinition, j as PluginEventListener } from './types-DXG7vqe9.js';
+
+/**
+ * Plugin Registry
+ *
+ * Central registry for core plugins. Manages plugin lifecycle,
+ * collects command handlers from all plugins, and aggregates
+ * MCP tool definitions for the MCP server.
+ */
+
+/**
+ * Plugin Registry - manages core plugins
+ *
+ * @example
+ * ```ts
+ * import { pluginRegistry, docxtemplaterPlugin } from '@eigenpal/docx-editor/core-plugins';
+ *
+ * // Register plugins
+ * pluginRegistry.register(docxtemplaterPlugin);
+ *
+ * // Get all MCP tools for MCP server
+ * const tools = pluginRegistry.getMcpTools();
+ *
+ * // Get command handler for executor
+ * const handler = pluginRegistry.getCommandHandler('insertTemplateVariable');
+ * ```
+ */
+declare class PluginRegistry {
+    private plugins;
+    private commandHandlers;
+    private eventListeners;
+    private initialized;
+    /**
+     * Register a plugin
+     *
+     * @param plugin - The plugin to register
+     * @param options - Optional configuration
+     * @returns Registration result
+     */
+    register(plugin: CorePlugin, options?: PluginOptions): PluginRegistrationResult;
+    /**
+     * Unregister a plugin
+     *
+     * @param pluginId - ID of the plugin to unregister
+     * @returns Whether unregistration succeeded
+     */
+    unregister(pluginId: string): boolean;
+    /**
+     * Get a registered plugin by ID
+     *
+     * @param id - Plugin ID
+     * @returns The plugin or undefined
+     */
+    get(id: string): CorePlugin | undefined;
+    /**
+     * Get all registered plugins
+     *
+     * @returns Array of all plugins
+     */
+    getAll(): CorePlugin[];
+    /**
+     * Check if a plugin is registered
+     *
+     * @param id - Plugin ID
+     * @returns Whether the plugin is registered
+     */
+    has(id: string): boolean;
+    /**
+     * Get number of registered plugins
+     */
+    get size(): number;
+    /**
+     * Get a command handler for a command type
+     *
+     * @param commandType - The command type
+     * @returns The handler or undefined
+     */
+    getCommandHandler(commandType: string): CommandHandler | undefined;
+    /**
+     * Get all registered command types
+     *
+     * @returns Array of command type strings
+     */
+    getCommandTypes(): string[];
+    /**
+     * Check if a command type has a handler
+     *
+     * @param commandType - The command type
+     * @returns Whether a handler exists
+     */
+    hasCommandHandler(commandType: string): boolean;
+    /**
+     * Get all MCP tools from all registered plugins
+     *
+     * @returns Array of MCP tool definitions
+     */
+    getMcpTools(): McpToolDefinition[];
+    /**
+     * Get MCP tools from a specific plugin
+     *
+     * @param pluginId - Plugin ID
+     * @returns Array of MCP tool definitions
+     */
+    getMcpToolsForPlugin(pluginId: string): McpToolDefinition[];
+    /**
+     * Get an MCP tool by name
+     *
+     * @param toolName - Tool name
+     * @returns The tool definition or undefined
+     */
+    getMcpTool(toolName: string): McpToolDefinition | undefined;
+    /**
+     * Add an event listener
+     *
+     * @param listener - Event listener function
+     */
+    addEventListener(listener: PluginEventListener): void;
+    /**
+     * Remove an event listener
+     *
+     * @param listener - Event listener function
+     */
+    removeEventListener(listener: PluginEventListener): void;
+    /**
+     * Emit an event to all listeners
+     */
+    private emit;
+    /**
+     * Clear all registered plugins
+     *
+     * Useful for testing or resetting state.
+     */
+    clear(): void;
+    /**
+     * Get registry state for debugging
+     */
+    getDebugInfo(): {
+        plugins: string[];
+        commandTypes: string[];
+        mcpTools: string[];
+        initialized: string[];
+    };
+}
+/**
+ * Global plugin registry instance
+ *
+ * Use this for registering plugins and accessing their capabilities.
+ */
+declare const pluginRegistry: PluginRegistry;
+/**
+ * Register multiple plugins at once
+ *
+ * @param plugins - Array of plugins to register
+ * @returns Array of registration results
+ */
+declare function registerPlugins(plugins: CorePlugin[], options?: PluginOptions): PluginRegistrationResult[];
+/**
+ * Create a plugin registration helper with options pre-configured
+ *
+ * @param options - Default options for plugin registration
+ * @returns Registration function
+ */
+declare function createPluginRegistrar(options: PluginOptions): (plugin: CorePlugin) => PluginRegistrationResult;
+
+export { PluginRegistry as P, createPluginRegistrar as c, pluginRegistry as p, registerPlugins as r };