@zeke-02/docx-editor-core 0.1.0

package/dist/core-plugins.d.mts

@@ -0,0 +1,63 @@
+/**
+ * Core Plugin System
+ *
+ * Headless plugin system for extending DocumentAgent with custom
+ * commands and exposing MCP tools for AI integration.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   pluginRegistry,
+ *   docxtemplaterPlugin,
+ *   type CorePlugin
+ * } from '@eigenpal/docx-editor/core-plugins';
+ *
+ * // Register the docxtemplater plugin
+ * pluginRegistry.register(docxtemplaterPlugin);
+ *
+ * // Get MCP tools for MCP server
+ * const tools = pluginRegistry.getMcpTools();
+ *
+ * // Check available command handlers
+ * const commandTypes = pluginRegistry.getCommandTypes();
+ * ```
+ * @packageDocumentation
+ * @public
+ */
+import { b as CorePlugin } from './types-dYdjUZMo.mjs';
+export { C as CommandHandler, a as CommandResult, E as ExtractCommand, J as JsonSchema, L as LoadedDocument, M as McpSession, c as McpToolAnnotations, d as McpToolContent, e as McpToolContext, f as McpToolDefinition, n as McpToolExample, g as McpToolHandler, h as McpToolResult, P as PluginCommand, C as PluginCommandHandler, i as PluginEvent, j as PluginEventListener, k as PluginOptions, l as PluginRegistrationResult, f as ToolDefinition, g as ToolHandler, h as ToolResult, T as TypedCommandHandler, Z as ZodSchemaLike, m as isZodSchema } from './types-dYdjUZMo.mjs';
+export { P as PluginRegistry, c as createPluginRegistrar, p as pluginRegistry, r as registerPlugins } from './registry-Cpyybgij.mjs';
+import './types/document.mjs';
+import './colors-C3vA7HUU.mjs';
+import './formatting-BH4hcZiq.mjs';
+import './content-5Mrz6w_b.mjs';
+import './docx/wrapTypes.mjs';
+import './styles-EI2lxeEN.mjs';
+import './types/agentApi.mjs';
+
+/**
+ * Docxtemplater Plugin
+ *
+ * Core plugin for template variable functionality using docxtemplater.
+ *
+ * **Command handlers** — `insertTemplateVariable` and `replaceWithTemplateVariable`
+ * allow DocumentAgent to programmatically insert `{variable}` placeholders.
+ *
+ * @example
+ * ```ts
+ * import { pluginRegistry } from '@eigenpal/docx-editor/core-plugins';
+ * import { docxtemplaterPlugin } from '@eigenpal/docx-editor/core-plugins/docxtemplater';
+ *
+ * pluginRegistry.register(docxtemplaterPlugin);
+ * ```
+ */
+
+/**
+ * Docxtemplater plugin for template variable functionality.
+ *
+ * Dependency validation is handled lazily by `processTemplate` at call time,
+ * so no eager `initialize()` is needed.
+ */
+declare const docxtemplaterPlugin: CorePlugin;
+
+export { CorePlugin, CorePlugin as Plugin, docxtemplaterPlugin };

package/dist/core-plugins.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Core Plugin System
+ *
+ * Headless plugin system for extending DocumentAgent with custom
+ * commands and exposing MCP tools for AI integration.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   pluginRegistry,
+ *   docxtemplaterPlugin,
+ *   type CorePlugin
+ * } from '@eigenpal/docx-editor/core-plugins';
+ *
+ * // Register the docxtemplater plugin
+ * pluginRegistry.register(docxtemplaterPlugin);
+ *
+ * // Get MCP tools for MCP server
+ * const tools = pluginRegistry.getMcpTools();
+ *
+ * // Check available command handlers
+ * const commandTypes = pluginRegistry.getCommandTypes();
+ * ```
+ * @packageDocumentation
+ * @public
+ */
+import { b as CorePlugin } from './types-DXG7vqe9.js';
+export { C as CommandHandler, a as CommandResult, E as ExtractCommand, J as JsonSchema, L as LoadedDocument, M as McpSession, c as McpToolAnnotations, d as McpToolContent, e as McpToolContext, f as McpToolDefinition, n as McpToolExample, g as McpToolHandler, h as McpToolResult, P as PluginCommand, C as PluginCommandHandler, i as PluginEvent, j as PluginEventListener, k as PluginOptions, l as PluginRegistrationResult, f as ToolDefinition, g as ToolHandler, h as ToolResult, T as TypedCommandHandler, Z as ZodSchemaLike, m as isZodSchema } from './types-DXG7vqe9.js';
+export { P as PluginRegistry, c as createPluginRegistrar, p as pluginRegistry, r as registerPlugins } from './registry-E5pahPKL.js';
+import './types/document.js';
+import './colors-C3vA7HUU.js';
+import './formatting-_OXU8gLB.js';
+import './content-CmqAwdFL.js';
+import './docx/wrapTypes.js';
+import './styles-BBv7doYK.js';
+import './types/agentApi.js';
+
+/**
+ * Docxtemplater Plugin
+ *
+ * Core plugin for template variable functionality using docxtemplater.
+ *
+ * **Command handlers** — `insertTemplateVariable` and `replaceWithTemplateVariable`
+ * allow DocumentAgent to programmatically insert `{variable}` placeholders.
+ *
+ * @example
+ * ```ts
+ * import { pluginRegistry } from '@eigenpal/docx-editor/core-plugins';
+ * import { docxtemplaterPlugin } from '@eigenpal/docx-editor/core-plugins/docxtemplater';
+ *
+ * pluginRegistry.register(docxtemplaterPlugin);
+ * ```
+ */
+
+/**
+ * Docxtemplater plugin for template variable functionality.
+ *
+ * Dependency validation is handled lazily by `processTemplate` at call time,
+ * so no eager `initialize()` is needed.
+ */
+declare const docxtemplaterPlugin: CorePlugin;
+
+export { CorePlugin, CorePlugin as Plugin, docxtemplaterPlugin };

package/dist/core-plugins.js

@@ -0,0 +1 @@
+'use strict';var chunkJ4J2Y6EU_js=require('./chunk-J4J2Y6EU.js');require('./chunk-U4UCHBZ7.js'),require('./chunk-ESI4BSBF.js');var chunk4BFNWPKW_js=require('./chunk-4BFNWPKW.js');require('./chunk-LCICADWM.js'),require('./chunk-F44ZLDZS.js'),require('./chunk-44FHVKSI.js'),require('./chunk-MNOHUTKE.js'),require('./chunk-MZOVDLYL.js'),require('./chunk-E4JMCA5X.js'),require('./chunk-HQPWFUP5.js'),require('./chunk-DV6GWBUJ.js'),require('./chunk-4Q2IP5FW.js'),require('./chunk-Q4CKLXWA.js'),require('./chunk-DC7S76ZX.js');Object.defineProperty(exports,"docxtemplaterPlugin",{enumerable:true,get:function(){return chunkJ4J2Y6EU_js.b}});Object.defineProperty(exports,"isZodSchema",{enumerable:true,get:function(){return chunkJ4J2Y6EU_js.a}});Object.defineProperty(exports,"PluginRegistry",{enumerable:true,get:function(){return chunk4BFNWPKW_js.a}});Object.defineProperty(exports,"createPluginRegistrar",{enumerable:true,get:function(){return chunk4BFNWPKW_js.d}});Object.defineProperty(exports,"pluginRegistry",{enumerable:true,get:function(){return chunk4BFNWPKW_js.b}});Object.defineProperty(exports,"registerPlugins",{enumerable:true,get:function(){return chunk4BFNWPKW_js.c}});

package/dist/core-plugins.mjs

@@ -0,0 +1 @@
+export{b as docxtemplaterPlugin,a as isZodSchema}from'./chunk-7Z2AGPNQ.mjs';import'./chunk-ARHPXIBJ.mjs';import'./chunk-CGJ6S3AH.mjs';export{a as PluginRegistry,d as createPluginRegistrar,b as pluginRegistry,c as registerPlugins}from'./chunk-3NRMSZX2.mjs';import'./chunk-CTHHUJAB.mjs';import'./chunk-RFC2SXZ6.mjs';import'./chunk-BOOHU5EW.mjs';import'./chunk-7LRR7RKE.mjs';import'./chunk-ILJUDEZ5.mjs';import'./chunk-6ZXL3EIP.mjs';import'./chunk-OEXVWIHW.mjs';import'./chunk-WLHNIXWC.mjs';import'./chunk-VW22RZ6C.mjs';import'./chunk-VQWZHPWI.mjs';import'./chunk-QYUPLKLP.mjs';

package/dist/core.d.mts

@@ -0,0 +1,398 @@
+/**
+ * @zeke-02/docx-editor-core (default entry point)
+ *
+ * Fat barrel that re-exports the parser, serializer, agent, plugin
+ * registry, and the most-used types. No React/DOM imports.
+ *
+ * **When to import from `.` vs `./headless`:** identical for Node.js
+ * use; `.` is the convenient aggregate, `./headless` is its mirror with
+ * a slightly different name suffix. Adapter authors who only need a
+ * specific slice should prefer the smaller subpaths (`./docx`, `./agent`,
+ * `./prosemirror`, `./layout-*`, `./utils`) — they tree-shake better.
+ *
+ * @example
+ * ```ts
+ * import { parseDocx, serializeDocx, resolveColor } from '@zeke-02/docx-editor-core';
+ * ```
+ * @packageDocumentation
+ * @public
+ */
+export { parseDocx } from './docx/parser.mjs';
+export { s as serializeDocumentBody, a as serializeDocx, b as serializeSectionProperties } from './documentSerializer-DgO3A9av.mjs';
+export { createDocx, default as repackDocx, updateMultipleFiles } from './docx/rezip.mjs';
+export { a as attemptSelectiveSave } from './selectiveSave-jinP_4xa.mjs';
+export { b as buildPatchedDocumentXml, v as validatePatchSafety } from './selectiveXmlPatch-ypkxlTD_.mjs';
+export { C as CreateEmptyDocumentOptions, P as ProcessTemplateOptions, a as ProcessTemplateResult, z as ThemeMatrixCell, b as blendColors, c as colorsEqual, d as createDocumentWithText, e as createEmptyDocument, f as createRgbColor, h as createThemeColor, i as darkenColor, A as ensureHexPrefix, B as generateThemeTintShadeMatrix, j as getContrastingColor, l as getTemplateTags, D as getThemeTintShadeHex, m as isBlack, n as isWhite, o as lightenColor, p as parseColorString, r as processTemplate, t as processTemplateAsBlob, u as processTemplateDetailed, v as resolveColor, w as resolveHighlightColor, E as resolveHighlightToCss, x as resolveShadingColor, y as validateTemplate } from './colorResolver-C6DtsoFI.mjs';
+export { A as AgentContextOptions, D as DocumentAgent, E as ExtendedSelectionContext, e as SelectionContextOptions, f as buildExtendedSelectionContext, g as buildSelectionContext, k as executeCommand, l as executeCommands, m as getAgentContext, n as getDocumentSummary } from './selectionContext-CoZat7QZ.mjs';
+export { emuToPixels, emuToTwips, formatPx, halfPointsToPixels, pixelsToEmu, pixelsToTwips, pointsToPixels, twipsToEmu, twipsToPixels } from './utils/units.mjs';
+export { I as InsertPosition, c as canRenderFont, a as countPageBreaks, b as createColumnBreak, d as createHorizontalRule, e as createLineBreak, f as createPageBreak, g as createPageBreakParagraph, h as createPageBreakRun, i as findPageBreaks, j as getLoadedFonts, k as hasPageBreakBefore, l as insertHorizontalRule, m as insertPageBreak, n as isBreakContent, o as isColumnBreak, p as isFontLoaded, q as isFontsLoading, r as isLineBreak, s as isPageBreak, t as loadFont, u as loadFontFromBuffer, v as loadFonts, w as onFontsLoaded, x as preloadCommonFonts, y as removePageBreak } from './fontLoader-8b4X-AIh.mjs';
+export { D as DocxInput, t as toArrayBuffer } from './docxInput-DTbCa48g.mjs';
+export { f as findParagraphByParaId, a as findStartPosForParaId } from './findParagraphByParaId-Maw_8M5D.mjs';
+export { V as VariableDetectionResult, a as VariableOccurrence, d as detectVariables, b as detectVariablesDetailed, c as detectVariablesInBody, e as detectVariablesInParagraph, f as documentHasVariables, g as extractVariablesFromText, h as formatVariable, i as hasTemplateVariables, j as isValidVariableName, p as parseVariable, r as removeVariables, k as replaceVariables, s as sanitizeVariableName } from './variableDetector-DF3-nxUC.mjs';
+import { Document } from './types/document.mjs';
+export { DocxPackage } from './types/document.mjs';
+export { AIAction, AIActionRequest, AgentCommand, AgentContext, AgentResponse, ApplyStyleCommand, DeleteTextCommand, FormatTextCommand, InsertHyperlinkCommand, InsertImageCommand, InsertTableCommand, InsertTextCommand, ParagraphContext, Position, Range, ReplaceTextCommand, SelectionContext, SetVariableCommand, SuggestedAction } from './types/agentApi.mjs';
+export { EditorPluginCore, PanelConfig, PluginPanelProps, PositionCoordinates, RenderedDomContext } from './plugin-api/types.mjs';
+export { b as CorePlugin, M as McpSession, f as McpToolDefinition, g as McpToolHandler, h as McpToolResult } from './types-dYdjUZMo.mjs';
+export { P as PluginRegistry, p as pluginRegistry, r as registerPlugins } from './registry-Cpyybgij.mjs';
+export { docxtemplaterPlugin } from './core-plugins.mjs';
+import { S as Subscribable } from './Subscribable-DOz6Ohoo.mjs';
+import { ErrorManagerSnapshot, PluginLifecycleSnapshot, PluginLifecycleConfig } from './managers/types.mjs';
+export { AutoSaveManagerOptions, AutoSaveSnapshot, AutoSaveStatus, CellCoordinates, EditorHandle, ErrorNotification, ErrorSeverity, SavedDocumentData, TableSelectionSnapshot } from './managers/types.mjs';
+export { AutoSaveManager, formatLastSaveTime, formatStorageSize, getAutoSaveStatusLabel, getAutoSaveStorageSize, isAutoSaveSupported } from './managers/AutoSaveManager.mjs';
+export { TABLE_DATA_ATTRIBUTES, TableSelectionManager, deleteTableFromDocument, findTableFromClick, getTableFromDocument, updateTableInDocument } from './managers/TableSelectionManager.mjs';
+import { R as Run } from './content-5Mrz6w_b.mjs';
+export { B as BlockContent, w as BookmarkEnd, x as BookmarkStart, C as Comment, a as CommentRangeEnd, b as CommentRangeStart, D as Deletion, c as DocumentBody, E as Endnote, O as Field, V as FooterReference, F as Footnote, u as HeaderFooter, Z as HeaderReference, H as Hyperlink, I as Image, d as Insertion, L as ListLevel, M as MoveFrom, e as MoveTo, N as NumberingDefinitions, P as Paragraph, f as ParagraphContent, g as RunContent, S as SectionProperties, ap as Shape, T as Table, h as TableCell, i as TableRow, aA as TextBox, j as TextContent, k as TrackedChangeInfo, l as TrackedRunChange } from './content-5Mrz6w_b.mjs';
+import { EditorView } from 'prosemirror-view';
+export { FlowBlock, FootnoteContent, Layout, Measure, Page } from './layout-engine/types.mjs';
+export { P as ParagraphFormatting, T as TextFormatting } from './formatting-BH4hcZiq.mjs';
+export { C as ConvertFootnoteOptions, a as ConvertHeaderFooterOptions, F as FOOTNOTE_SEPARATOR_HEIGHT, H as HeaderFooterMetrics, M as MAX_FOOTNOTE_LAYOUT_PASSES, b as MeasureBlocksFn, S as StabilizeFootnoteLayoutArgs, c as StabilizeFootnoteLayoutResult, d as buildFootnoteContentMap, e as buildFootnoteRenderItems, f as calculateFootnoteReservedHeights, g as collectFootnoteRefs, h as convertHeaderFooterToContent, i as footnoteReservedHeightsEqual, m as mapFootnotesToPages, s as stabilizeFootnoteLayout } from './headerFooterLayout-72Vz7yp3.mjs';
+export { R as Relationship, S as Style, a as StyleDefinitions, T as Theme, f as ThemeColorScheme, g as ThemeFont, h as ThemeFontScheme } from './styles-EI2lxeEN.mjs';
+import './colors-C3vA7HUU.mjs';
+import './docx/wrapTypes.mjs';
+import 'jszip';
+import 'prosemirror-model';
+import 'prosemirror-state';
+import './footnotes-lCH_P3N3.mjs';
+
+/**
+ * ClipboardManager
+ *
+ * Framework-agnostic class for clipboard operations in the editor.
+ * Extracted from the React `useClipboard` hook.
+ *
+ * Handles:
+ * - DOM selection traversal and run extraction
+ * - Formatting extraction from computed styles
+ * - Clipboard read/write operations
+ */
+
+/** Selection data for clipboard operations */
+interface ClipboardSelection {
+    text: string;
+    runs: Run[];
+    startParagraphIndex: number;
+    startRunIndex: number;
+    startOffset: number;
+    endParagraphIndex: number;
+    endRunIndex: number;
+    endOffset: number;
+    isMultiParagraph: boolean;
+}
+/**
+ * Convert a CSS color string (rgb/rgba/hex) to a 6-char uppercase hex string.
+ *
+ * NOTE: This differs from `colorResolver.rgbToHex(r, g, b)` which takes
+ * numeric components. This function parses CSS color strings.
+ */
+declare function cssColorToHex(color: string): string | null;
+/** Extract formatting from an HTML element's computed styles. */
+declare function extractFormattingFromElement(element: HTMLElement): Run['formatting'];
+/** Get selected runs from the current DOM selection. */
+declare function getSelectionRuns(): Run[];
+/** Create a ClipboardSelection from the current DOM selection. */
+declare function createSelectionFromDOM(): ClipboardSelection | null;
+declare const rgbToHex: typeof cssColorToHex;
+
+/**
+ * ErrorManager
+ *
+ * Framework-agnostic pub/sub error notification system.
+ * Replaces React's `componentDidCatch` + context pattern for error notifications.
+ *
+ * Usage with React:
+ * ```ts
+ * const { notifications } = useSyncExternalStore(manager.subscribe, manager.getSnapshot);
+ * ```
+ */
+
+declare class ErrorManager extends Subscribable<ErrorManagerSnapshot> {
+    private notifications;
+    private idCounter;
+    private timers;
+    constructor();
+    /** Show an error notification (persistent, not auto-dismissed). */
+    showError(message: string, details?: string): string;
+    /** Show a warning notification (auto-dismissed after 5s). */
+    showWarning(message: string, details?: string): string;
+    /** Show an info notification (auto-dismissed after 5s). */
+    showInfo(message: string, details?: string): string;
+    /** Dismiss a notification by ID. */
+    dismiss(id: string): void;
+    /** Clear all notifications and cancel pending timers. */
+    clearAll(): void;
+    /** Destroy the manager and clean up all timers. */
+    destroy(): void;
+    private addNotification;
+    private emitSnapshot;
+}
+
+/**
+ * PluginLifecycleManager
+ *
+ * Framework-agnostic class for managing editor plugin lifecycle.
+ * Extracted from React's `PluginHost.tsx`.
+ *
+ * Handles:
+ * - Plugin initialization and state tracking
+ * - Plugin state updates via `updateStates()`
+ * - Plugin destroy/cleanup
+ *
+ * Does NOT handle (framework hosts are responsible for):
+ * - CSS injection (use the exported `injectStyles` utility)
+ * - DOM event listeners / dispatch wrapping
+ */
+
+/** Inject CSS styles into the document head. Returns a cleanup function. */
+declare function injectStyles(pluginId: string, css: string): () => void;
+declare class PluginLifecycleManager extends Subscribable<PluginLifecycleSnapshot> {
+    private plugins;
+    private pluginStates;
+    private version;
+    constructor();
+    /**
+     * Initialize plugins with an editor view.
+     * Calls `plugin.initialize(editorView)` for each plugin.
+     *
+     * Note: CSS injection and DOM event listeners are the responsibility
+     * of the framework-specific host (e.g. React PluginHost).
+     */
+    initialize(plugins: PluginLifecycleConfig[], editorView: EditorView): void;
+    /**
+     * Update all plugin states by calling `onStateChange` on each plugin.
+     * Returns true if any plugin state changed.
+     */
+    updateStates(editorView: EditorView): boolean;
+    /** Get plugin state by ID. */
+    getPluginState<T>(pluginId: string): T | undefined;
+    /** Set plugin state by ID. */
+    setPluginState<T>(pluginId: string, state: T): void;
+    /** Destroy all plugins and clean up. */
+    destroy(): void;
+    private destroyPlugins;
+    private emitSnapshot;
+}
+
+/**
+ * LayoutCoordinator
+ *
+ * Framework-agnostic class coordinating the PM state → layout engine →
+ * layout painter → selection overlay pipeline.
+ *
+ * Extracted from PagedEditor.tsx. Manages:
+ * - Layout pipeline state (blocks, measures, layout)
+ * - Selection state (selectionRects, caretPosition)
+ * - Drag selection state
+ * - Column resize state
+ * - Image interaction state
+ *
+ * Usage with React:
+ * ```ts
+ * const snapshot = useSyncExternalStore(coordinator.subscribe, coordinator.getSnapshot);
+ * ```
+ *
+ * NOTE: This class defines the state shape and subscription pattern.
+ * Full integration with PagedEditor is done incrementally.
+ */
+
+/** Selection rectangle for rendering selection overlays */
+interface SelectionRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    pageIndex: number;
+}
+/** Caret position for rendering the blinking cursor */
+interface CaretPosition {
+    x: number;
+    y: number;
+    height: number;
+    pageIndex: number;
+}
+/** Info about the currently selected/hovered image */
+interface ImageSelectionInfo {
+    pmPos: number;
+    pageIndex: number;
+    rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    widthEmu: number;
+    heightEmu: number;
+    isInline: boolean;
+}
+/** Column resize tracking state */
+interface ColumnResizeState {
+    isResizing: boolean;
+    startX: number;
+    columnIndex: number;
+    tablePmStart: number;
+    originalWidths: {
+        left: number;
+        right: number;
+    };
+}
+/** The full snapshot exposed to UI frameworks */
+interface LayoutCoordinatorSnapshot {
+    /** Computed page layout, null until first computation */
+    hasLayout: boolean;
+    /** Selection rectangles for range selection overlay */
+    selectionRects: SelectionRect[];
+    /** Caret position for cursor overlay */
+    caretPosition: CaretPosition | null;
+    /** Currently selected/hovered image */
+    selectedImageInfo: ImageSelectionInfo | null;
+    /** Whether the editor is focused */
+    isFocused: boolean;
+    /** Whether a text drag is in progress */
+    isDragging: boolean;
+    /** Whether a column resize is in progress */
+    isResizingColumn: boolean;
+    /** Whether an image interaction is in progress */
+    isImageInteracting: boolean;
+    /** Version counter — incremented on every state change */
+    version: number;
+}
+declare class LayoutCoordinator extends Subscribable<LayoutCoordinatorSnapshot> {
+    private _hasLayout;
+    private _selectionRects;
+    private _caretPosition;
+    private _isDragging;
+    private _dragAnchor;
+    private _columnResize;
+    private _selectedImageInfo;
+    private _isImageInteracting;
+    private _isFocused;
+    private _version;
+    constructor();
+    /** Notify that layout has been computed. */
+    setLayoutReady(hasLayout: boolean): void;
+    /** Update selection rectangles and caret position. */
+    updateSelection(selectionRects: SelectionRect[], caretPosition: CaretPosition | null): void;
+    /** Start a drag selection from the given PM anchor position. */
+    startDrag(anchor: number): void;
+    /** End drag selection. */
+    endDrag(): void;
+    /** Get the drag anchor position. */
+    getDragAnchor(): number | null;
+    /** Start resizing a table column. */
+    startColumnResize(tablePmStart: number, columnIndex: number, startX: number, originalWidths: {
+        left: number;
+        right: number;
+    }): void;
+    /** End column resize. */
+    endColumnResize(): void;
+    /** Get current column resize state. */
+    getColumnResize(): ColumnResizeState;
+    /** Set the currently selected image. */
+    setSelectedImage(imageInfo: ImageSelectionInfo | null): void;
+    /** Clear the image selection. */
+    clearSelectedImage(): void;
+    /** Set whether an image interaction (resize/move) is in progress. */
+    setImageInteracting(interacting: boolean): void;
+    /** Update focus state. */
+    setFocused(focused: boolean): void;
+    private emitSnapshot;
+}
+
+/**
+ * EditorCoordinator
+ *
+ * Framework-agnostic class managing the document editor lifecycle:
+ * - Document parsing and loading
+ * - Font loading coordination
+ * - Zoom level management
+ * - Extension manager initialization
+ * - Agent command execution
+ *
+ * Extracted from DocxEditor.tsx.
+ *
+ * Usage with React:
+ * ```ts
+ * const snapshot = useSyncExternalStore(coordinator.subscribe, coordinator.getSnapshot);
+ * ```
+ *
+ * NOTE: This class defines the state shape and coordination logic.
+ * Full integration with DocxEditor is done incrementally.
+ */
+
+/** Editor loading state */
+type EditorLoadingState = 'idle' | 'parsing' | 'loading-fonts' | 'ready' | 'error';
+/** Configuration for EditorCoordinator */
+interface EditorCoordinatorOptions {
+    /** Initial zoom level (default: 1.0) */
+    initialZoom?: number;
+    /** Callback when the document changes */
+    onChange?: (document: Document) => void;
+    /** Callback when an error occurs */
+    onError?: (error: Error) => void;
+}
+/** The full snapshot exposed to UI frameworks */
+interface EditorCoordinatorSnapshot {
+    /** Current loading state */
+    loadingState: EditorLoadingState;
+    /** Error message if loadingState is 'error' */
+    parseError: string | null;
+    /** Whether the editor is ready for interaction */
+    isReady: boolean;
+    /** Current zoom level (1.0 = 100%) */
+    zoom: number;
+    /** Whether fonts have been loaded */
+    fontsLoaded: boolean;
+    /** Version counter */
+    version: number;
+}
+declare class EditorCoordinator extends Subscribable<EditorCoordinatorSnapshot> {
+    private _loadingState;
+    private _parseError;
+    private _zoom;
+    private _fontsLoaded;
+    private _document;
+    private _version;
+    private onChangeCallback?;
+    private onErrorCallback?;
+    constructor(options?: EditorCoordinatorOptions);
+    /** Signal that document parsing has started. */
+    setParsingStarted(): void;
+    /** Signal that document parsing completed successfully. */
+    setDocumentLoaded(document: Document): void;
+    /** Signal that font loading completed. */
+    setFontsLoaded(): void;
+    /** Signal that an error occurred during loading. */
+    setLoadError(error: Error): void;
+    /** Get the current document. */
+    getDocument(): Document | null;
+    /** Update the document (after edits). */
+    updateDocument(document: Document): void;
+    /** Set the zoom level (1.0 = 100%). */
+    setZoom(zoom: number): void;
+    /** Get the current zoom level. */
+    getZoom(): number;
+    private emitSnapshot;
+}
+
+/**
+ * @zeke-02/docx-editor-core (default entry point)
+ *
+ * Fat barrel that re-exports the parser, serializer, agent, plugin
+ * registry, and the most-used types. No React/DOM imports.
+ *
+ * **When to import from `.` vs `./headless`:** identical for Node.js
+ * use; `.` is the convenient aggregate, `./headless` is its mirror with
+ * a slightly different name suffix. Adapter authors who only need a
+ * specific slice should prefer the smaller subpaths (`./docx`, `./agent`,
+ * `./prosemirror`, `./layout-*`, `./utils`) — they tree-shake better.
+ *
+ * @example
+ * ```ts
+ * import { parseDocx, serializeDocx, resolveColor } from '@zeke-02/docx-editor-core';
+ * ```
+ * @packageDocumentation
+ * @public
+ */
+declare const VERSION = "0.0.2";
+
+export { type CaretPosition, type ClipboardSelection, type ColumnResizeState, Document, EditorCoordinator, type EditorCoordinatorOptions, type EditorCoordinatorSnapshot, type EditorLoadingState, ErrorManager, ErrorManagerSnapshot, type ImageSelectionInfo, LayoutCoordinator, type LayoutCoordinatorSnapshot, PluginLifecycleConfig, PluginLifecycleManager, PluginLifecycleSnapshot, Run, type SelectionRect, Subscribable, VERSION, createSelectionFromDOM, extractFormattingFromElement, getSelectionRuns, injectStyles, rgbToHex };