Docx Editor releases

Major Changes

• 6272b32: # 1.0.0

  First multi-package, multi-framework release. The monolithic @eigenpal/docx-js-editor is split into a framework-agnostic core and per-framework adapters, Vue 3 ships as a first-class adapter alongside React, and the license moves to Apache 2.0 across all packages.

  Package restructure (breaking)

  | Old import | New import |
  | ------------------------------------------ | ----------------------------------------- |
  | @eigenpal/docx-js-editor | @eigenpal/docx-editor-react |
  | @eigenpal/docx-js-editor/react | @eigenpal/docx-editor-react |
  | @eigenpal/docx-editor-react/core | @eigenpal/docx-editor-core |
  | @eigenpal/docx-editor-react/headless | @eigenpal/docx-editor-core/headless |
  | @eigenpal/docx-editor-react/core-plugins | @eigenpal/docx-editor-core/core-plugins |
  | @eigenpal/docx-editor-react/mcp | @eigenpal/docx-editor-agents/mcp |
  | @eigenpal/docx-editor-react/i18n/*.json | @eigenpal/docx-editor-i18n/*.json |

  The old @eigenpal/docx-js-editor package stays on 0.x for legacy maintenance — no 1.x compatibility shim ships. Framework-agnostic utilities (e.g. createEmptyDocument) move to core:

  - import { DocxEditor, createEmptyDocument } from '@eigenpal/docx-js-editor';
  + import { DocxEditor } from '@eigenpal/docx-editor-react';
  + import { createEmptyDocument } from '@eigenpal/docx-editor-core';
  

  Vue 3 adapter (@eigenpal/docx-editor-vue)

  The Vue package becomes a real adapter (previously a stub). Public API mirrors React:

  • <DocxEditor> with matching prop surface
  • useDocxEditor composable + renderAsync for the Node.js path
  • /ui, /composables, /dialogs, /plugin-api, /styles subpaths

  Parity gates cover insert-table, find/replace, page-setup, context menus, image overlay (resize/move/rotate/aspect-locked corners, dimension tooltip), advanced cell/row options (margins, height rule, text direction, no-wrap), menu-bar icons + shortcuts + carets, toolbar pickers, and the agent UI surface.

  Shared i18n package (@eigenpal/docx-editor-i18n)

  Locale strings move out of @eigenpal/docx-editor-react into a dedicated package consumed by both adapters from a single source.

  - import de from '@eigenpal/docx-editor-react/i18n/de.json';
  + import de from '@eigenpal/docx-editor-i18n/de.json';
  

  The defaultLocale value (English) is still re-exported from the adapter packages, unchanged.

  Agent UI relocation (breaking)

  AgentPanel, AgentChatLog, AgentComposer, AgentSuggestionChip, AgentTimeline no longer ship from @eigenpal/docx-editor-react. They live at:

  • @eigenpal/docx-editor-agents/react — React components + useAgentChat
  • @eigenpal/docx-editor-agents/vue — Vue 3 twins, plus AIContextMenu and AIResponsePreview
  • @eigenpal/docx-editor-agents/ai-sdk/react / /ai-sdk/vue — @ai-sdk/* adapters
  • @eigenpal/docx-editor-agents/bridge — React-free createEditorBridge, agentTools, executeToolCall, getToolSchemas, createReviewerBridge. Safe for headless / Vue / Node.

  - import { AgentPanel, AgentChatLog } from '@eigenpal/docx-editor-react';
  + import { AgentPanel, AgentChatLog } from '@eigenpal/docx-editor-agents/react';
  

  The agent components no longer call useTranslation directly — pass localized *Label props instead. <DocxEditor>'s built-in agent panel slot still forwards localized strings automatically.

  Accessibility polish on the agent surface: keyboard-operable resize handle, Escape-dismissable context menu, live-region chat log, WCAG AA contrast on response previews.

  Toolbar naming unified (breaking)

  The standalone formatting bar is Toolbar on both adapters. The old "classic" single-row Toolbar (with File/Format/Insert menus baked in) is removed — compose EditorToolbar.MenuBar + EditorToolbar.Toolbar for that layout.

  | Old (React) | New (React + Vue) |
  | ------------------------------ | ----------------------- |
  | FormattingBar | Toolbar |
  | Classic Toolbar (with menus) | EditorToolbar |
  | EditorToolbar.FormattingBar | EditorToolbar.Toolbar |

  Vue: BasicToolbar / FormattingBar aliases removed; EditorToolbar's formatting-bar slot is now toolbar. Vue's table border-color and cell-fill pickers now use the advanced color picker matching React. Vue MenuDropdown's showChevron default flips from true to false — pass :show-chevron="true" explicitly to keep the caret.

  showPrintButton prop removed (breaking)

  Removed from <DocxEditor> and <Toolbar> on both adapters; the Vue <Toolbar> print event is gone with it. onPrint callback stays.

  - <DocxEditor showPrintButton onPrint={handlePrint} />
  + <DocxEditor onPrint={handlePrint} />
  

  To hide File > Print, omit onPrint. Programmatic print still works via ref.current.print() / editorRef.value.print().

  License moves to Apache 2.0

  All published packages relicense to Apache 2.0. Notably: @eigenpal/docx-editor-agents was AGPL-3.0-or-later — the relicense lifts copyleft obligations on agent embedders.

Patch Changes

• c5125ff: Wire API Extractor on @eigenpal/docx-editor-agents/server. Tag the 11 public exports with @public. Commits the first etc/agents-server.api.md snapshot; CI now fails on undocumented public-surface drift via bun run api:check. No runtime change.
• f7b8dc7: Move the source folder from packages/agent-use to packages/agents so it matches the published npm name (@eigenpal/docx-editor-agents). The npm package name, version, exports, and import paths are unchanged — no consumer action needed.

Major Changes

• 6272b32: # 1.0.0

  First multi-package, multi-framework release. The monolithic @eigenpal/docx-js-editor is split into a framework-agnostic core and per-framework adapters, Vue 3 ships as a first-class adapter alongside React, and the license moves to Apache 2.0 across all packages.

  Package restructure (breaking)

  | Old import | New import |
  | ------------------------------------------ | ----------------------------------------- |
  | @eigenpal/docx-js-editor | @eigenpal/docx-editor-react |
  | @eigenpal/docx-js-editor/react | @eigenpal/docx-editor-react |
  | @eigenpal/docx-editor-react/core | @eigenpal/docx-editor-core |
  | @eigenpal/docx-editor-react/headless | @eigenpal/docx-editor-core/headless |
  | @eigenpal/docx-editor-react/core-plugins | @eigenpal/docx-editor-core/core-plugins |
  | @eigenpal/docx-editor-react/mcp | @eigenpal/docx-editor-agents/mcp |
  | @eigenpal/docx-editor-react/i18n/*.json | @eigenpal/docx-editor-i18n/*.json |

  The old @eigenpal/docx-js-editor package stays on 0.x for legacy maintenance — no 1.x compatibility shim ships. Framework-agnostic utilities (e.g. createEmptyDocument) move to core:

  - import { DocxEditor, createEmptyDocument } from '@eigenpal/docx-js-editor';
  + import { DocxEditor } from '@eigenpal/docx-editor-react';
  + import { createEmptyDocument } from '@eigenpal/docx-editor-core';
  

  Vue 3 adapter (@eigenpal/docx-editor-vue)

  The Vue package becomes a real adapter (previously a stub). Public API mirrors React:

  • <DocxEditor> with matching prop surface
  • useDocxEditor composable + renderAsync for the Node.js path
  • /ui, /composables, /dialogs, /plugin-api, /styles subpaths

  Parity gates cover insert-table, find/replace, page-setup, context menus, image overlay (resize/move/rotate/aspect-locked corners, dimension tooltip), advanced cell/row options (margins, height rule, text direction, no-wrap), menu-bar icons + shortcuts + carets, toolbar pickers, and the agent UI surface.

  Shared i18n package (@eigenpal/docx-editor-i18n)

  Locale strings move out of @eigenpal/docx-editor-react into a dedicated package consumed by both adapters from a single source.

  - import de from '@eigenpal/docx-editor-react/i18n/de.json';
  + import de from '@eigenpal/docx-editor-i18n/de.json';
  

  The defaultLocale value (English) is still re-exported from the adapter packages, unchanged.

  Agent UI relocation (breaking)

  AgentPanel, AgentChatLog, AgentComposer, AgentSuggestionChip, AgentTimeline no longer ship from @eigenpal/docx-editor-react. They live at:

  • @eigenpal/docx-editor-agents/react — React components + useAgentChat
  • @eigenpal/docx-editor-agents/vue — Vue 3 twins, plus AIContextMenu and AIResponsePreview
  • @eigenpal/docx-editor-agents/ai-sdk/react / /ai-sdk/vue — @ai-sdk/* adapters
  • @eigenpal/docx-editor-agents/bridge — React-free createEditorBridge, agentTools, executeToolCall, getToolSchemas, createReviewerBridge. Safe for headless / Vue / Node.

  - import { AgentPanel, AgentChatLog } from '@eigenpal/docx-editor-react';
  + import { AgentPanel, AgentChatLog } from '@eigenpal/docx-editor-agents/react';
  

  The agent components no longer call useTranslation directly — pass localized *Label props instead. <DocxEditor>'s built-in agent panel slot still forwards localized strings automatically.

  Accessibility polish on the agent surface: keyboard-operable resize handle, Escape-dismissable context menu, live-region chat log, WCAG AA contrast on response previews.

  Toolbar naming unified (breaking)

  The standalone formatting bar is Toolbar on both adapters. The old "classic" single-row Toolbar (with File/Format/Insert menus baked in) is removed — compose EditorToolbar.MenuBar + EditorToolbar.Toolbar for that layout.

  | Old (React) | New (React + Vue) |
  | ------------------------------ | ----------------------- |
  | FormattingBar | Toolbar |
  | Classic Toolbar (with menus) | EditorToolbar |
  | EditorToolbar.FormattingBar | EditorToolbar.Toolbar |

  Vue: BasicToolbar / FormattingBar aliases removed; EditorToolbar's formatting-bar slot is now toolbar. Vue's table border-color and cell-fill pickers now use the advanced color picker matching React. Vue MenuDropdown's showChevron default flips from true to false — pass :show-chevron="true" explicitly to keep the caret.

  showPrintButton prop removed (breaking)

  Removed from <DocxEditor> and <Toolbar> on both adapters; the Vue <Toolbar> print event is gone with it. onPrint callback stays.

  - <DocxEditor showPrintButton onPrint={handlePrint} />
  + <DocxEditor onPrint={handlePrint} />
  

  To hide File > Print, omit onPrint. Programmatic print still works via ref.current.print() / editorRef.value.print().

  License moves to Apache 2.0

  All published packages relicense to Apache 2.0. Notably: @eigenpal/docx-editor-agents was AGPL-3.0-or-later — the relicense lifts copyleft obligations on agent embedders.

Patch Changes

• 6b8f1fb: Fill in the last 26 untranslated keys in de, he, pl, pt-BR, tr, and zh-CN. All six community locales now reach 100% coverage against en.json.

Major Changes

• 6272b32: # 1.0.0

  First multi-package, multi-framework release. The monolithic @eigenpal/docx-js-editor is split into a framework-agnostic core and per-framework adapters, Vue 3 ships as a first-class adapter alongside React, and the license moves to Apache 2.0 across all packages.

  Package restructure (breaking)

  | Old import | New import |
  | ------------------------------------------ | ----------------------------------------- |
  | @eigenpal/docx-js-editor | @eigenpal/docx-editor-react |
  | @eigenpal/docx-js-editor/react | @eigenpal/docx-editor-react |
  | @eigenpal/docx-editor-react/core | @eigenpal/docx-editor-core |
  | @eigenpal/docx-editor-react/headless | @eigenpal/docx-editor-core/headless |
  | @eigenpal/docx-editor-react/core-plugins | @eigenpal/docx-editor-core/core-plugins |
  | @eigenpal/docx-editor-react/mcp | @eigenpal/docx-editor-agents/mcp |
  | @eigenpal/docx-editor-react/i18n/*.json | @eigenpal/docx-editor-i18n/*.json |

  The old @eigenpal/docx-js-editor package stays on 0.x for legacy maintenance — no 1.x compatibility shim ships. Framework-agnostic utilities (e.g. createEmptyDocument) move to core:

  - import { DocxEditor, createEmptyDocument } from '@eigenpal/docx-js-editor';
  + import { DocxEditor } from '@eigenpal/docx-editor-react';
  + import { createEmptyDocument } from '@eigenpal/docx-editor-core';
  

  Vue 3 adapter (@eigenpal/docx-editor-vue)

  The Vue package becomes a real adapter (previously a stub). Public API mirrors React:

  • <DocxEditor> with matching prop surface
  • useDocxEditor composable + renderAsync for the Node.js path
  • /ui, /composables, /dialogs, /plugin-api, /styles subpaths

  Parity gates cover insert-table, find/replace, page-setup, context menus, image overlay (resize/move/rotate/aspect-locked corners, dimension tooltip), advanced cell/row options (margins, height rule, text direction, no-wrap), menu-bar icons + shortcuts + carets, toolbar pickers, and the agent UI surface.

  Shared i18n package (@eigenpal/docx-editor-i18n)

  Locale strings move out of @eigenpal/docx-editor-react into a dedicated package consumed by both adapters from a single source.

  - import de from '@eigenpal/docx-editor-react/i18n/de.json';
  + import de from '@eigenpal/docx-editor-i18n/de.json';
  

  The defaultLocale value (English) is still re-exported from the adapter packages, unchanged.

  Agent UI relocation (breaking)

  AgentPanel, AgentChatLog, AgentComposer, AgentSuggestionChip, AgentTimeline no longer ship from @eigenpal/docx-editor-react. They live at:

  • @eigenpal/docx-editor-agents/react — React components + useAgentChat
  • @eigenpal/docx-editor-agents/vue — Vue 3 twins, plus AIContextMenu and AIResponsePreview
  • @eigenpal/docx-editor-agents/ai-sdk/react / /ai-sdk/vue — @ai-sdk/* adapters
  • @eigenpal/docx-editor-agents/bridge — React-free createEditorBridge, agentTools, executeToolCall, getToolSchemas, createReviewerBridge. Safe for headless / Vue / Node.

  - import { AgentPanel, AgentChatLog } from '@eigenpal/docx-editor-react';
  + import { AgentPanel, AgentChatLog } from '@eigenpal/docx-editor-agents/react';
  

  The agent components no longer call useTranslation directly — pass localized *Label props instead. <DocxEditor>'s built-in agent panel slot still forwards localized strings automatically.

  Accessibility polish on the agent surface: keyboard-operable resize handle, Escape-dismissable context menu, live-region chat log, WCAG AA contrast on response previews.

  Toolbar naming unified (breaking)

  The standalone formatting bar is Toolbar on both adapters. The old "classic" single-row Toolbar (with File/Format/Insert menus baked in) is removed — compose EditorToolbar.MenuBar + EditorToolbar.Toolbar for that layout.

  | Old (React) | New (React + Vue) |
  | ------------------------------ | ----------------------- |
  | FormattingBar | Toolbar |
  | Classic Toolbar (with menus) | EditorToolbar |
  | EditorToolbar.FormattingBar | EditorToolbar.Toolbar |

  Vue: BasicToolbar / FormattingBar aliases removed; EditorToolbar's formatting-bar slot is now toolbar. Vue's table border-color and cell-fill pickers now use the advanced color picker matching React. Vue MenuDropdown's showChevron default flips from true to false — pass :show-chevron="true" explicitly to keep the caret.

  showPrintButton prop removed (breaking)

  Removed from <DocxEditor> and <Toolbar> on both adapters; the Vue <Toolbar> print event is gone with it. onPrint callback stays.

  - <DocxEditor showPrintButton onPrint={handlePrint} />
  + <DocxEditor onPrint={handlePrint} />
  

  To hide File > Print, omit onPrint. Programmatic print still works via ref.current.print() / editorRef.value.print().

  License moves to Apache 2.0

  All published packages relicense to Apache 2.0. Notably: @eigenpal/docx-editor-agents was AGPL-3.0-or-later — the relicense lifts copyleft obligations on agent embedders.

Patch Changes

• 0187af2: Emit consumer-friendly JSON docs at docs/json/<pkg-slug>/<subpath>.json for every @public export across the published packages. Companion to the existing etc/<slug>.api.md snapshots — same source of truth (API Extractor), different output shape: instead of human-readable Markdown, the JSON is structured for a docs site to render any layout it wants. Includes per-export source-link URLs into the GitHub source tree, type-reference canonical IDs for cross-page linking, and TSDoc summaries/remarks/examples parsed out of the source.

  New tooling: bun run docs:json regenerates, bun run docs:check (in CI) fails on drift. Contract documented in CLAUDE.md under ### Docs JSON. No runtime change to any published package.

• 348fa6b: API Extractor snapshots for the 6 published subpaths of @eigenpal/docx-editor-react (root, /ui, /hooks, /dialogs, /plugin-api, /styles) and @eigenpal/docx-editor-vue (root, /ui, /composables, /dialogs, /plugin-api, /styles). CI now fails on undocumented public-surface drift via bun run api:check.

  Adds etc/parity.contract.json — the cross-adapter parity contract listing which DocxEditorProps fields and DocxEditorRef members are paired between React and Vue, which are deliberately deferred in Vue, and which are Vue-exclusive. bun run check:parity-contract (also gated in CI) parses both snapshots and fails on any drift the contract doesn't acknowledge. Adding a new prop or ref method to either adapter forces an explicit classification in the contract.

  Vue composables now declare named Use*Return interfaces (UseClipboardReturn, UseFindReplaceReturn, UseSelectionHighlightReturn, UseTableSelectionReturn, UseHistoryReturn, UseTableResizeReturn, UseDragAutoScrollReturn, UseVisualLineNavigationReturn, UseDocxEditorReturn). Before this change the composables returned anonymous object literals that recursively expanded core's internal types in the published .d.ts, inflating etc/composables.api.md to 3,526 lines and locking core's internal Run/Comment shape into Vue's public contract. Named returns drop the snapshot to ~450 lines and decouple Vue's surface from core's internals.

  Vue's useTableSelection no longer exposes manager: TableSelectionManager in its return — it was unused by any internal consumer and leaked core's TableSelectionManager class as part of Vue's public surface.

  Side effect for @eigenpal/docx-editor-vue: the build no longer writes workspace-relative source paths (e.g. ../../core/src/core.ts) into published declarations. Those paths were valid in this repo but unresolvable once installed from npm; setting pathsToAliases: false on the dts plugin keeps the package names (@eigenpal/docx-editor-core, @eigenpal/docx-editor-i18n) intact in dist/*.d.ts.

  No runtime change for either package.

• 2e6398a: Drop framework-prefixed names from Vue's public surface — the package name already encodes the framework, so Vue-prefixed identifiers are redundant in consumer code.

  Renames VueRenderAsyncOptions → RenderAsyncOptions in packages/vue/src/renderAsync.ts. The previous compat alias (VueRenderAsyncOptions as RenderAsyncOptions) is dropped — RenderAsyncOptions is now the only exported name. Matches React's RenderAsyncOptions 1:1.

  Adds EditorPlugin as a type alias for VueEditorPlugin in packages/vue/src/plugin-api/types.ts, mirroring React's EditorPlugin / ReactEditorPlugin pair. Consumers writing import { EditorPlugin } from '@eigenpal/docx-editor-vue/plugin-api' now resolve. VueEditorPlugin stays exported for callers who want the framework-explicit name.

  No runtime change.

• Updated dependencies [6272b32]

• Updated dependencies [c5125ff]

• Updated dependencies [76093f9]

• Updated dependencies [c5125ff]

• Updated dependencies [348fa6b]

• Updated dependencies [0187af2]

• Updated dependencies [6b8f1fb]

• Updated dependencies [61983ca]

• Updated dependencies [f7b8dc7]

• Updated dependencies [b2230a3]

• Updated dependencies [8836214]

  • @eigenpal/[email protected]
  • @eigenpal/[email protected]
  • @eigenpal/[email protected]

Minor Changes

• 159cad2: Curated subpath exports + peerDeps move. Replaces the ./* wildcard on @eigenpal/docx-core with 17 explicit, tree-shakeable subpaths:

  • Top level: ., ./headless, ./core-plugins, ./mcp
  • ProseMirror: ./prosemirror, ./prosemirror/extensions, ./prosemirror/conversion, ./prosemirror/commands, ./prosemirror/plugins, ./prosemirror/editor.css
  • DOCX I/O: ./docx, ./docx/serializer
  • Headless agent: ./agent
  • Layout (@experimental): ./layout-engine, ./layout-painter, ./layout-bridge, ./plugin-api
  • Types: ./types/document, ./types/content, ./types/agentApi
  • Utilities: ./utils

  Breaking change for consumers: prosemirror-* packages are now peerDependencies (in both @eigenpal/docx-core and @eigenpal/docx-js-editor) so consumer bundles don't end up with duplicate ProseMirror copies. After upgrading you must install them yourself:

  npm i prosemirror-commands prosemirror-dropcursor prosemirror-history \
        prosemirror-keymap prosemirror-model prosemirror-state \
        prosemirror-tables prosemirror-transform prosemirror-view
  

  Also breaks the schema → StarterKit → extensions → schema circular import that crashed bundled consumers with X is not a function. Extensions now receive their owning ExtensionManager via ExtensionContext.manager instead of reaching for the module-level singletonManager. The singletonManager is no longer exported from ./prosemirror — internal commands still get it via the relative ./schema path inside the package.

Patch Changes

• 23a2c7e: Add Hebrew (he) locale

Full Changelog: https://github.com/eigenpal/docx-editor/compare/v0.0.25...v0.0.26

Full Changelog: https://github.com/eigenpal/docx-js-editor/compare/v0.0.15...v0.0.16