@eigenpal/docx-editor-core 1.0.3 → 1.1.0

package/dist/prosemirror/plugins/index.d.mts

@@ -7,39 +7,56 @@
  * @public
  */
 export { SelectionChangeCallback, SelectionContext, createSelectionTrackerPlugin, extractSelectionContext, getSelectionContext, selectionTrackerKey } from './selectionTracker.mjs';
-import { Plugin, EditorState, Transaction, PluginKey } from 'prosemirror-state';
+import { PluginKey, EditorState, Transaction, Plugin } from 'prosemirror-state';
+import { m as RevisionInfo } from '../../content-5Mrz6w_b.mjs';
 import '../../formatting-BH4hcZiq.mjs';
 import '../../colors-C3vA7HUU.mjs';
+import '../../docx/wrapTypes.mjs';
 
 /**
- * Suggestion Mode Plugin
- *
- * When active, intercepts all text insertions and deletions,
- * wrapping them in tracked change marks (insertion/deletion)
- * instead of modifying the document directly.
+ * Suggestion-mode plugin state + shared meta keys.
  *
- * - Typed text is marked as insertion (green underline)
- * - Deleted text is NOT removed — it's marked as deletion (red strikethrough)
- * - Text already marked as insertion by the current author is deleted normally
- *   (retracting your own suggestion)
+ * Kept in its own module to avoid an import cycle: every handler file needs
+ * the plugin key + meta constants but should not transitively pull in the
+ * plugin factory.
  */
 
-declare const suggestionModeKey: PluginKey<SuggestionModeState>;
 interface SuggestionModeState {
     active: boolean;
     author: string;
 }
+declare const suggestionModeKey: PluginKey<SuggestionModeState>;
+
 /**
- * Create the suggestion mode plugin.
- * When active, text edits become tracked changes.
+ * Suggesting-mode toggle / set / query commands. Each dispatches a meta on
+ * the plugin key — the plugin's `state.apply` merges it into
+ * `SuggestionModeState`. No-ops gracefully when the plugin isn't mounted.
  */
-declare function createSuggestionModePlugin(initialActive?: boolean, author?: string): Plugin;
+
 /**
- * Toggle suggestion mode on/off.
+ * Toggle suggesting mode on/off. The mounted `createSuggestionModePlugin`
+ * is required for the dispatch to have any effect — without it the meta
+ * is silently dropped. Returns `false` (no-op) if the plugin is missing.
+ *
+ * @example
+ * ```ts
+ * import { toggleSuggestionMode } from '@eigenpal/docx-editor-core/prosemirror/plugins';
+ * toggleSuggestionMode(view.state, view.dispatch);
+ * ```
  */
 declare function toggleSuggestionMode(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
 /**
- * Set suggestion mode active state and author.
+ * Set suggesting mode active state and (optionally) author. Author
+ * tracks across every revision minted while the mode is on. The
+ * mounted `createSuggestionModePlugin` is required.
+ *
+ * @example
+ * ```ts
+ * import { setSuggestionMode } from '@eigenpal/docx-editor-core/prosemirror/plugins';
+ * setSuggestionMode(true, view.state, view.dispatch, 'Jane');
+ * // ... typed text now wraps in <w:ins> with author="Jane"
+ * setSuggestionMode(false, view.state, view.dispatch);
+ * ```
  */
 declare function setSuggestionMode(active: boolean, state: EditorState, dispatch?: (tr: Transaction) => void, author?: string): boolean;
 /**
@@ -47,4 +64,91 @@ declare function setSuggestionMode(active: boolean, state: EditorState, dispatch
  */
 declare function isSuggestionModeActive(state: EditorState): boolean;
 
-export { createSuggestionModePlugin, isSuggestionModeActive, setSuggestionMode, suggestionModeKey, toggleSuggestionMode };
+/**
+ * Suggestion Mode Plugin
+ *
+ * When active, intercepts all text insertions and deletions, wrapping
+ * them in tracked-change marks (insertion/deletion) instead of modifying
+ * the document directly.
+ *
+ * - Typed text is marked as insertion (green underline)
+ * - Deleted text is NOT removed — it's marked as deletion (red strikethrough)
+ * - Text already marked as insertion by the current author is deleted
+ *   normally (retracting your own suggestion)
+ *
+ * The implementation is split across this directory for readability:
+ *   - `state.ts`       — plugin key, meta constants, shared types
+ *   - `markAttrs.ts`   — fresh-attr minting + projection
+ *   - `adjacency.ts`   — coalescing lookups (sibling, cross-block, cellMarker)
+ *   - `handlers/`      — keyboard / input handlers (delete, insert, structural)
+ *   - `commands.ts`    — toggle / set / isActive
+ *   - this file        — `createSuggestionModePlugin` + public re-exports
+ */
+
+/**
+ * Create the suggestion-mode ProseMirror plugin. **Must be mounted on
+ * the editor view for `setSuggestionMode` and `toggleSuggestionMode`
+ * to do anything** — both adapters (`@eigenpal/docx-editor-react`,
+ * `@eigenpal/docx-editor-vue`) auto-mount this inside the `DocxEditor`
+ * component, so consumers using the bundled components don't need to
+ * register it themselves.
+ *
+ * When active, typed text gets the `insertion` mark, deleted text gets
+ * the `deletion` mark (text stays in the doc; the painter strikes it
+ * through), Enter sets `pPrIns` on the originating paragraph, and
+ * Backspace at paragraph start sets `pPrDel` on the previous paragraph.
+ * Author + adjacent same-author marks coalesce into one tracked change.
+ *
+ * @param initialActive - Whether suggesting mode starts on. Default `false`.
+ * @param author - Author name attached to every minted revision. Default `'User'`.
+ *
+ * @example
+ * ```ts
+ * import { createSuggestionModePlugin } from '@eigenpal/docx-editor-core/prosemirror/plugins';
+ *
+ * const plugin = createSuggestionModePlugin(false, 'Jane');
+ * EditorState.create({ doc, plugins: [plugin, ...other] });
+ * ```
+ */
+declare function createSuggestionModePlugin(initialActive?: boolean, author?: string): Plugin;
+
+/**
+ * Single source of tracked-revision ids across the package.
+ *
+ * Why a shared module-level counter:
+ *
+ *   - Each `revisionId` is the OOXML `<w:ins w:id="…"/>` attribute. Two
+ *     unrelated revisions emitted by the same author with the same id
+ *     would silently collapse in the sidebar (grouped by id+author+date)
+ *     and on accept (resolved by id), so collisions are observable.
+ *   - Pre-refactor, three call sites each kept their own
+ *     `Date.now() + offset` counter (suggestionMode.ts, table commands
+ *     delete.ts, table commands insert.ts). Offsets made first-load
+ *     collisions rare but not impossible — counters drift independently,
+ *     and parallel-browser Playwright workers can start from identical
+ *     `Date.now()` seeds.
+ *
+ * Routing every mint through this module guarantees within-realm
+ * uniqueness even when callers interleave across plugins, commands, and
+ * test harnesses.
+ *
+ * Re-exported as `@public` through `prosemirror/plugins/index.ts` so
+ * adapter integrations (image insertion, custom commands) can mint
+ * revision triples without reaching into the implementation directly.
+ *
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Build a fresh `RevisionInfo` triple from the active suggesting-mode
+ * state. Returns `null` when suggesting mode is OFF — callers use this to
+ * decide whether to track an edit or apply it directly.
+ *
+ * Shared by `suggestionMode.ts`'s text/paragraph handlers and by the
+ * suggesting-aware table commands (`addRowBelow`, `deleteRow`, ...). One
+ * source of truth for both the mint and the author/date fields.
+ */
+declare function makeRevisionInfo(state: EditorState): RevisionInfo | null;
+
+export { RevisionInfo, createSuggestionModePlugin, isSuggestionModeActive, makeRevisionInfo, setSuggestionMode, suggestionModeKey, toggleSuggestionMode };

package/dist/prosemirror/plugins/index.d.ts

@@ -7,39 +7,56 @@
  * @public
  */
 export { SelectionChangeCallback, SelectionContext, createSelectionTrackerPlugin, extractSelectionContext, getSelectionContext, selectionTrackerKey } from './selectionTracker.js';
-import { Plugin, EditorState, Transaction, PluginKey } from 'prosemirror-state';
+import { PluginKey, EditorState, Transaction, Plugin } from 'prosemirror-state';
+import { m as RevisionInfo } from '../../content-CmqAwdFL.js';
 import '../../formatting-_OXU8gLB.js';
 import '../../colors-C3vA7HUU.js';
+import '../../docx/wrapTypes.js';
 
 /**
- * Suggestion Mode Plugin
- *
- * When active, intercepts all text insertions and deletions,
- * wrapping them in tracked change marks (insertion/deletion)
- * instead of modifying the document directly.
+ * Suggestion-mode plugin state + shared meta keys.
  *
- * - Typed text is marked as insertion (green underline)
- * - Deleted text is NOT removed — it's marked as deletion (red strikethrough)
- * - Text already marked as insertion by the current author is deleted normally
- *   (retracting your own suggestion)
+ * Kept in its own module to avoid an import cycle: every handler file needs
+ * the plugin key + meta constants but should not transitively pull in the
+ * plugin factory.
  */
 
-declare const suggestionModeKey: PluginKey<SuggestionModeState>;
 interface SuggestionModeState {
     active: boolean;
     author: string;
 }
+declare const suggestionModeKey: PluginKey<SuggestionModeState>;
+
 /**
- * Create the suggestion mode plugin.
- * When active, text edits become tracked changes.
+ * Suggesting-mode toggle / set / query commands. Each dispatches a meta on
+ * the plugin key — the plugin's `state.apply` merges it into
+ * `SuggestionModeState`. No-ops gracefully when the plugin isn't mounted.
  */
-declare function createSuggestionModePlugin(initialActive?: boolean, author?: string): Plugin;
+
 /**
- * Toggle suggestion mode on/off.
+ * Toggle suggesting mode on/off. The mounted `createSuggestionModePlugin`
+ * is required for the dispatch to have any effect — without it the meta
+ * is silently dropped. Returns `false` (no-op) if the plugin is missing.
+ *
+ * @example
+ * ```ts
+ * import { toggleSuggestionMode } from '@eigenpal/docx-editor-core/prosemirror/plugins';
+ * toggleSuggestionMode(view.state, view.dispatch);
+ * ```
  */
 declare function toggleSuggestionMode(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
 /**
- * Set suggestion mode active state and author.
+ * Set suggesting mode active state and (optionally) author. Author
+ * tracks across every revision minted while the mode is on. The
+ * mounted `createSuggestionModePlugin` is required.
+ *
+ * @example
+ * ```ts
+ * import { setSuggestionMode } from '@eigenpal/docx-editor-core/prosemirror/plugins';
+ * setSuggestionMode(true, view.state, view.dispatch, 'Jane');
+ * // ... typed text now wraps in <w:ins> with author="Jane"
+ * setSuggestionMode(false, view.state, view.dispatch);
+ * ```
  */
 declare function setSuggestionMode(active: boolean, state: EditorState, dispatch?: (tr: Transaction) => void, author?: string): boolean;
 /**
@@ -47,4 +64,91 @@ declare function setSuggestionMode(active: boolean, state: EditorState, dispatch
  */
 declare function isSuggestionModeActive(state: EditorState): boolean;
 
-export { createSuggestionModePlugin, isSuggestionModeActive, setSuggestionMode, suggestionModeKey, toggleSuggestionMode };
+/**
+ * Suggestion Mode Plugin
+ *
+ * When active, intercepts all text insertions and deletions, wrapping
+ * them in tracked-change marks (insertion/deletion) instead of modifying
+ * the document directly.
+ *
+ * - Typed text is marked as insertion (green underline)
+ * - Deleted text is NOT removed — it's marked as deletion (red strikethrough)
+ * - Text already marked as insertion by the current author is deleted
+ *   normally (retracting your own suggestion)
+ *
+ * The implementation is split across this directory for readability:
+ *   - `state.ts`       — plugin key, meta constants, shared types
+ *   - `markAttrs.ts`   — fresh-attr minting + projection
+ *   - `adjacency.ts`   — coalescing lookups (sibling, cross-block, cellMarker)
+ *   - `handlers/`      — keyboard / input handlers (delete, insert, structural)
+ *   - `commands.ts`    — toggle / set / isActive
+ *   - this file        — `createSuggestionModePlugin` + public re-exports
+ */
+
+/**
+ * Create the suggestion-mode ProseMirror plugin. **Must be mounted on
+ * the editor view for `setSuggestionMode` and `toggleSuggestionMode`
+ * to do anything** — both adapters (`@eigenpal/docx-editor-react`,
+ * `@eigenpal/docx-editor-vue`) auto-mount this inside the `DocxEditor`
+ * component, so consumers using the bundled components don't need to
+ * register it themselves.
+ *
+ * When active, typed text gets the `insertion` mark, deleted text gets
+ * the `deletion` mark (text stays in the doc; the painter strikes it
+ * through), Enter sets `pPrIns` on the originating paragraph, and
+ * Backspace at paragraph start sets `pPrDel` on the previous paragraph.
+ * Author + adjacent same-author marks coalesce into one tracked change.
+ *
+ * @param initialActive - Whether suggesting mode starts on. Default `false`.
+ * @param author - Author name attached to every minted revision. Default `'User'`.
+ *
+ * @example
+ * ```ts
+ * import { createSuggestionModePlugin } from '@eigenpal/docx-editor-core/prosemirror/plugins';
+ *
+ * const plugin = createSuggestionModePlugin(false, 'Jane');
+ * EditorState.create({ doc, plugins: [plugin, ...other] });
+ * ```
+ */
+declare function createSuggestionModePlugin(initialActive?: boolean, author?: string): Plugin;
+
+/**
+ * Single source of tracked-revision ids across the package.
+ *
+ * Why a shared module-level counter:
+ *
+ *   - Each `revisionId` is the OOXML `<w:ins w:id="…"/>` attribute. Two
+ *     unrelated revisions emitted by the same author with the same id
+ *     would silently collapse in the sidebar (grouped by id+author+date)
+ *     and on accept (resolved by id), so collisions are observable.
+ *   - Pre-refactor, three call sites each kept their own
+ *     `Date.now() + offset` counter (suggestionMode.ts, table commands
+ *     delete.ts, table commands insert.ts). Offsets made first-load
+ *     collisions rare but not impossible — counters drift independently,
+ *     and parallel-browser Playwright workers can start from identical
+ *     `Date.now()` seeds.
+ *
+ * Routing every mint through this module guarantees within-realm
+ * uniqueness even when callers interleave across plugins, commands, and
+ * test harnesses.
+ *
+ * Re-exported as `@public` through `prosemirror/plugins/index.ts` so
+ * adapter integrations (image insertion, custom commands) can mint
+ * revision triples without reaching into the implementation directly.
+ *
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Build a fresh `RevisionInfo` triple from the active suggesting-mode
+ * state. Returns `null` when suggesting mode is OFF — callers use this to
+ * decide whether to track an edit or apply it directly.
+ *
+ * Shared by `suggestionMode.ts`'s text/paragraph handlers and by the
+ * suggesting-aware table commands (`addRowBelow`, `deleteRow`, ...). One
+ * source of truth for both the mint and the author/date fields.
+ */
+declare function makeRevisionInfo(state: EditorState): RevisionInfo | null;
+
+export { RevisionInfo, createSuggestionModePlugin, isSuggestionModeActive, makeRevisionInfo, setSuggestionMode, suggestionModeKey, toggleSuggestionMode };

package/dist/prosemirror/plugins/index.js

@@ -1 +1 @@
-'use strict';var chunkTRJWRZZD_js=require('../../chunk-TRJWRZZD.js'),chunk6LVPRTB6_js=require('../../chunk-6LVPRTB6.js');require('../../chunk-DC7S76ZX.js');Object.defineProperty(exports,"createSuggestionModePlugin",{enumerable:true,get:function(){return chunkTRJWRZZD_js.b}});Object.defineProperty(exports,"isSuggestionModeActive",{enumerable:true,get:function(){return chunkTRJWRZZD_js.e}});Object.defineProperty(exports,"setSuggestionMode",{enumerable:true,get:function(){return chunkTRJWRZZD_js.d}});Object.defineProperty(exports,"suggestionModeKey",{enumerable:true,get:function(){return chunkTRJWRZZD_js.a}});Object.defineProperty(exports,"toggleSuggestionMode",{enumerable:true,get:function(){return chunkTRJWRZZD_js.c}});Object.defineProperty(exports,"createSelectionTrackerPlugin",{enumerable:true,get:function(){return chunk6LVPRTB6_js.c}});Object.defineProperty(exports,"extractSelectionContext",{enumerable:true,get:function(){return chunk6LVPRTB6_js.b}});Object.defineProperty(exports,"getSelectionContext",{enumerable:true,get:function(){return chunk6LVPRTB6_js.d}});Object.defineProperty(exports,"selectionTrackerKey",{enumerable:true,get:function(){return chunk6LVPRTB6_js.a}});
+'use strict';require('../../chunk-U74VPTIU.js');var chunk73AZQWIE_js=require('../../chunk-73AZQWIE.js');require('../../chunk-YTDWMXNS.js');var chunk6LVPRTB6_js=require('../../chunk-6LVPRTB6.js'),chunk7HANRHHL_js=require('../../chunk-7HANRHHL.js');require('../../chunk-Q4CKLXWA.js'),require('../../chunk-DC7S76ZX.js');Object.defineProperty(exports,"createSuggestionModePlugin",{enumerable:true,get:function(){return chunk73AZQWIE_js.d}});Object.defineProperty(exports,"isSuggestionModeActive",{enumerable:true,get:function(){return chunk73AZQWIE_js.c}});Object.defineProperty(exports,"setSuggestionMode",{enumerable:true,get:function(){return chunk73AZQWIE_js.b}});Object.defineProperty(exports,"toggleSuggestionMode",{enumerable:true,get:function(){return chunk73AZQWIE_js.a}});Object.defineProperty(exports,"createSelectionTrackerPlugin",{enumerable:true,get:function(){return chunk6LVPRTB6_js.c}});Object.defineProperty(exports,"extractSelectionContext",{enumerable:true,get:function(){return chunk6LVPRTB6_js.b}});Object.defineProperty(exports,"getSelectionContext",{enumerable:true,get:function(){return chunk6LVPRTB6_js.d}});Object.defineProperty(exports,"selectionTrackerKey",{enumerable:true,get:function(){return chunk6LVPRTB6_js.a}});Object.defineProperty(exports,"makeRevisionInfo",{enumerable:true,get:function(){return chunk7HANRHHL_js.i}});Object.defineProperty(exports,"suggestionModeKey",{enumerable:true,get:function(){return chunk7HANRHHL_js.e}});

package/dist/prosemirror/plugins/index.mjs

@@ -1 +1 @@
-export{b as createSuggestionModePlugin,e as isSuggestionModeActive,d as setSuggestionMode,a as suggestionModeKey,c as toggleSuggestionMode}from'../../chunk-NNQWQOC5.mjs';export{c as createSelectionTrackerPlugin,b as extractSelectionContext,d as getSelectionContext,a as selectionTrackerKey}from'../../chunk-BGY3CB37.mjs';import'../../chunk-QYUPLKLP.mjs';
+import'../../chunk-FDEDN2RC.mjs';export{d as createSuggestionModePlugin,c as isSuggestionModeActive,b as setSuggestionMode,a as toggleSuggestionMode}from'../../chunk-KHF4JU7D.mjs';import'../../chunk-VHUVPHPI.mjs';export{c as createSelectionTrackerPlugin,b as extractSelectionContext,d as getSelectionContext,a as selectionTrackerKey}from'../../chunk-BGY3CB37.mjs';export{i as makeRevisionInfo,e as suggestionModeKey}from'../../chunk-MJ6XZFVD.mjs';import'../../chunk-VQWZHPWI.mjs';import'../../chunk-QYUPLKLP.mjs';

package/dist/prosemirror/schema/index.d.mts

@@ -9,14 +9,13 @@
  */
 import * as prosemirror_model from 'prosemirror-model';
 import { a as ExtensionManager } from '../../types-RchZmPFN.mjs';
-export { I as ImageAttrs, a as ImagePositionAttrs, P as ParagraphAttrs, T as TableAttrs, b as TableCellAttrs, c as TableRowAttrs } from '../../nodes-CL8M0L-a.mjs';
+export { I as ImageAttrs, a as ImagePositionAttrs, P as ParagraphAttrs, T as TableAttrs, b as TableCellAttrs, c as TableRowAttrs } from '../../nodes-7753Bgi_.mjs';
 export { F as FontFamilyAttrs, a as FontSizeAttrs, H as HyperlinkAttrs, T as TextColorAttrs, U as UnderlineAttrs } from '../../marks-BY573yZn.mjs';
 import 'prosemirror-state';
-import '../../formatting-BH4hcZiq.mjs';
 import '../../colors-C3vA7HUU.mjs';
-import '../../lists-CvG_iVK3.mjs';
+import '../../formatting-BH4hcZiq.mjs';
+import '../../content-5Mrz6w_b.mjs';
 import '../../docx/wrapTypes.mjs';
-import '../../types/content.mjs';
 
 declare const singletonManager: ExtensionManager;
 declare const schema: prosemirror_model.Schema<any, any>;

package/dist/prosemirror/schema/index.d.ts

@@ -9,14 +9,13 @@
  */
 import * as prosemirror_model from 'prosemirror-model';
 import { a as ExtensionManager } from '../../types-RchZmPFN.js';
-export { I as ImageAttrs, a as ImagePositionAttrs, P as ParagraphAttrs, T as TableAttrs, b as TableCellAttrs, c as TableRowAttrs } from '../../nodes-D7PTUJ2N.js';
+export { I as ImageAttrs, a as ImagePositionAttrs, P as ParagraphAttrs, T as TableAttrs, b as TableCellAttrs, c as TableRowAttrs } from '../../nodes-CC_nwkT_.js';
 export { F as FontFamilyAttrs, a as FontSizeAttrs, H as HyperlinkAttrs, T as TextColorAttrs, U as UnderlineAttrs } from '../../marks-CjC9tF5k.js';
 import 'prosemirror-state';
-import '../../formatting-_OXU8gLB.js';
 import '../../colors-C3vA7HUU.js';
-import '../../lists-UTp_tk7B.js';
+import '../../formatting-_OXU8gLB.js';
+import '../../content-CmqAwdFL.js';
 import '../../docx/wrapTypes.js';
-import '../../types/content.js';
 
 declare const singletonManager: ExtensionManager;
 declare const schema: prosemirror_model.Schema<any, any>;

package/dist/prosemirror/schema/index.js

@@ -1 +1 @@
-'use strict';var chunkYVYB4YCI_js=require('../../chunk-YVYB4YCI.js');require('../../chunk-IO6HZ7KR.js'),require('../../chunk-BHBOAP6Z.js'),require('../../chunk-MZ7LW5CH.js'),require('../../chunk-N3Y5BUKV.js'),require('../../chunk-6LVPRTB6.js'),require('../../chunk-NERY274X.js'),require('../../chunk-MJ5FQX7Q.js'),require('../../chunk-C2BAPYGJ.js'),require('../../chunk-Q4CKLXWA.js'),require('../../chunk-4Q2IP5FW.js'),require('../../chunk-DC7S76ZX.js');Object.defineProperty(exports,"schema",{enumerable:true,get:function(){return chunkYVYB4YCI_js.b}});Object.defineProperty(exports,"singletonManager",{enumerable:true,get:function(){return chunkYVYB4YCI_js.a}});
+'use strict';var chunkOAWTQ3IY_js=require('../../chunk-OAWTQ3IY.js');require('../../chunk-GM4USWKO.js'),require('../../chunk-BHBOAP6Z.js'),require('../../chunk-MZ7LW5CH.js'),require('../../chunk-N3Y5BUKV.js'),require('../../chunk-YTDWMXNS.js'),require('../../chunk-6LVPRTB6.js'),require('../../chunk-TUIEV7Q7.js'),require('../../chunk-7HANRHHL.js'),require('../../chunk-MJ5FQX7Q.js'),require('../../chunk-C2BAPYGJ.js'),require('../../chunk-4Q2IP5FW.js'),require('../../chunk-Q4CKLXWA.js'),require('../../chunk-DC7S76ZX.js');Object.defineProperty(exports,"schema",{enumerable:true,get:function(){return chunkOAWTQ3IY_js.b}});Object.defineProperty(exports,"singletonManager",{enumerable:true,get:function(){return chunkOAWTQ3IY_js.a}});

package/dist/prosemirror/schema/index.mjs

@@ -1 +1 @@
-export{b as schema,a as singletonManager}from'../../chunk-TGPS3SRR.mjs';import'../../chunk-BRHHK4MG.mjs';import'../../chunk-MOKKS75W.mjs';import'../../chunk-OZMNIX6U.mjs';import'../../chunk-AMENZY5F.mjs';import'../../chunk-BGY3CB37.mjs';import'../../chunk-CP5OSG5Z.mjs';import'../../chunk-67LVRQIR.mjs';import'../../chunk-LE67NTCN.mjs';import'../../chunk-VQWZHPWI.mjs';import'../../chunk-VW22RZ6C.mjs';import'../../chunk-QYUPLKLP.mjs';
+export{b as schema,a as singletonManager}from'../../chunk-CA2EYL6T.mjs';import'../../chunk-IQG3KLWY.mjs';import'../../chunk-MOKKS75W.mjs';import'../../chunk-OZMNIX6U.mjs';import'../../chunk-AMENZY5F.mjs';import'../../chunk-VHUVPHPI.mjs';import'../../chunk-BGY3CB37.mjs';import'../../chunk-ZX26QZJ5.mjs';import'../../chunk-MJ6XZFVD.mjs';import'../../chunk-67LVRQIR.mjs';import'../../chunk-LE67NTCN.mjs';import'../../chunk-VW22RZ6C.mjs';import'../../chunk-VQWZHPWI.mjs';import'../../chunk-QYUPLKLP.mjs';

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

@@ -6,25 +6,22 @@
  * 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.
+ * over text nodes. Consumers building custom sidebars should prefer the
+ * adapter-specific wrappers (`useTrackedChanges` in
+ * `@eigenpal/docx-editor-react/hooks` and
+ * `@eigenpal/docx-editor-vue/composables`), which add the memoization
+ * and reactivity layer. Reach for the core function directly for
+ * server-side analysis or test fixtures.
  *
  * @packageDocumentation
- * @internal
+ * @public
  */
 import { EditorState } from 'prosemirror-state';
 import { TrackedChangeEntry } from '../../utils/comments.mjs';
-import '../../types/content.mjs';
+import '../../content-5Mrz6w_b.mjs';
 import '../../formatting-BH4hcZiq.mjs';
 import '../../colors-C3vA7HUU.mjs';
 import '../../docx/wrapTypes.mjs';
-import '../../lists-CvG_iVK3.mjs';
 
 /**
  * Walk the PM doc once and derive (a) the tracked-change list and (b) a
@@ -34,20 +31,22 @@ import '../../lists-CvG_iVK3.mjs';
  * 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.
+ * over text nodes. Consumers building custom sidebars should prefer the
+ * adapter-specific wrappers (`useTrackedChanges` in
+ * `@eigenpal/docx-editor-react/hooks` and
+ * `@eigenpal/docx-editor-vue/composables`), which add the memoization
+ * and reactivity layer. Reach for the core function directly for
+ * server-side analysis or test fixtures.
  *
  * @packageDocumentation
- * @internal
+ * @public
  */
 
-/** @internal */
+/**
+ * Output of {@link extractTrackedChanges}.
+ *
+ * @public
+ */
 interface TrackedChangesResult {
     /** Tracked-change entries, sorted by document position, with adjacent same-revision entries merged. */
     entries: TrackedChangeEntry[];
@@ -57,7 +56,30 @@ interface TrackedChangesResult {
      */
     commentToRevision: Map<number, number>;
 }
-/** @internal */
+/**
+ * Walk the PM doc and extract every tracked change as a flat list of
+ * `TrackedChangeEntry` plus a comment→revision overlap map. Adjacent
+ * inline marks coalesce by `(type, revisionId, author, date)`; a
+ * deletion immediately followed by an insertion (same author + same
+ * date) collapses into a single `replacement` entry; paragraph-mark
+ * cards (`paragraphMarkInsertion` / `paragraphMarkDeletion`) are
+ * hidden when an inline entry already covers their revision triple
+ * (one Accept clears every site of one conceptual change).
+ *
+ * Pure and deterministic. Returns `EMPTY_RESULT` on null state.
+ *
+ * @example
+ * ```ts
+ * import { extractTrackedChanges } from '@eigenpal/docx-editor-core/prosemirror/utils/extractTrackedChanges';
+ *
+ * const { entries, commentToRevision } = extractTrackedChanges(view.state);
+ * for (const e of entries) {
+ *   console.log(e.type, e.author, e.text);
+ * }
+ * ```
+ *
+ * @public
+ */
 declare function extractTrackedChanges(state: EditorState | null): TrackedChangesResult;
 
 export { type TrackedChangesResult, extractTrackedChanges };

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

@@ -6,25 +6,22 @@
  * 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.
+ * over text nodes. Consumers building custom sidebars should prefer the
+ * adapter-specific wrappers (`useTrackedChanges` in
+ * `@eigenpal/docx-editor-react/hooks` and
+ * `@eigenpal/docx-editor-vue/composables`), which add the memoization
+ * and reactivity layer. Reach for the core function directly for
+ * server-side analysis or test fixtures.
  *
  * @packageDocumentation
- * @internal
+ * @public
  */
 import { EditorState } from 'prosemirror-state';
 import { TrackedChangeEntry } from '../../utils/comments.js';
-import '../../types/content.js';
+import '../../content-CmqAwdFL.js';
 import '../../formatting-_OXU8gLB.js';
 import '../../colors-C3vA7HUU.js';
 import '../../docx/wrapTypes.js';
-import '../../lists-UTp_tk7B.js';
 
 /**
  * Walk the PM doc once and derive (a) the tracked-change list and (b) a
@@ -34,20 +31,22 @@ import '../../lists-UTp_tk7B.js';
  * 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.
+ * over text nodes. Consumers building custom sidebars should prefer the
+ * adapter-specific wrappers (`useTrackedChanges` in
+ * `@eigenpal/docx-editor-react/hooks` and
+ * `@eigenpal/docx-editor-vue/composables`), which add the memoization
+ * and reactivity layer. Reach for the core function directly for
+ * server-side analysis or test fixtures.
  *
  * @packageDocumentation
- * @internal
+ * @public
  */
 
-/** @internal */
+/**
+ * Output of {@link extractTrackedChanges}.
+ *
+ * @public
+ */
 interface TrackedChangesResult {
     /** Tracked-change entries, sorted by document position, with adjacent same-revision entries merged. */
     entries: TrackedChangeEntry[];
@@ -57,7 +56,30 @@ interface TrackedChangesResult {
      */
     commentToRevision: Map<number, number>;
 }
-/** @internal */
+/**
+ * Walk the PM doc and extract every tracked change as a flat list of
+ * `TrackedChangeEntry` plus a comment→revision overlap map. Adjacent
+ * inline marks coalesce by `(type, revisionId, author, date)`; a
+ * deletion immediately followed by an insertion (same author + same
+ * date) collapses into a single `replacement` entry; paragraph-mark
+ * cards (`paragraphMarkInsertion` / `paragraphMarkDeletion`) are
+ * hidden when an inline entry already covers their revision triple
+ * (one Accept clears every site of one conceptual change).
+ *
+ * Pure and deterministic. Returns `EMPTY_RESULT` on null state.
+ *
+ * @example
+ * ```ts
+ * import { extractTrackedChanges } from '@eigenpal/docx-editor-core/prosemirror/utils/extractTrackedChanges';
+ *
+ * const { entries, commentToRevision } = extractTrackedChanges(view.state);
+ * for (const e of entries) {
+ *   console.log(e.type, e.author, e.text);
+ * }
+ * ```
+ *
+ * @public
+ */
 declare function extractTrackedChanges(state: EditorState | null): TrackedChangesResult;
 
 export { type TrackedChangesResult, extractTrackedChanges };

package/dist/prosemirror/utils/extractTrackedChanges.js

@@ -1 +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;
+'use strict';require('../../chunk-DC7S76ZX.js');var B={entries:[],commentToRevision:new Map};function O(S){if(!S)return B;let{doc:K,schema:v}=S,b=v.marks.insertion,g=v.marks.deletion,w=v.marks.comment;if(!b&&!g)return B;let d=[],C=new Map;K.descendants((e,t)=>{if(e.type.name==="paragraph"){let r=e.attrs.pPrIns,i=e.attrs.pPrDel;r&&d.push({type:"paragraphMarkInsertion",text:e.textContent||"",author:r.author||"",date:r.date??void 0,from:t,to:t+e.nodeSize,revisionId:r.revisionId}),i&&d.push({type:"paragraphMarkDeletion",text:e.textContent||"",author:i.author||"",date:i.date??void 0,from:t,to:t+e.nodeSize,revisionId:i.revisionId});let o=e.attrs.pPrChange;if(Array.isArray(o))for(let a of o)d.push({type:"paragraphPropertiesChanged",text:e.textContent||"",author:a.info.author||"",date:a.info.date??void 0,from:t,to:t+e.nodeSize,revisionId:a.info.id});}if(e.type.name==="tableRow"){let r=e.attrs.trIns,i=e.attrs.trDel;r&&d.push({type:"rowInserted",text:e.textContent||"",author:r.author||"",date:r.date??void 0,from:t,to:t+e.nodeSize,revisionId:r.revisionId}),i&&d.push({type:"rowDeleted",text:e.textContent||"",author:i.author||"",date:i.date??void 0,from:t,to:t+e.nodeSize,revisionId:i.revisionId});let o=e.attrs.trPrChange;if(Array.isArray(o))for(let a of o)!a?.info||typeof a.info.id!="number"||d.push({type:"rowPropertiesChanged",text:e.textContent||"",author:a.info.author||"",date:a.info.date??void 0,from:t,to:t+e.nodeSize,revisionId:a.info.id});}if(e.type.name==="tableCell"||e.type.name==="tableHeader"){let r=e.attrs.cellMarker;if(r?.info&&typeof r.info.revisionId=="number"){let a={ins:"cellInserted",del:"cellDeleted",merge:"cellMerged"}[r.kind];a&&d.push({type:a,text:e.textContent||"",author:r.info.author||"",date:r.info.date??void 0,from:t,to:t+e.nodeSize,revisionId:r.info.revisionId});}let i=e.attrs.tcPrChange;if(Array.isArray(i))for(let o of i)!o?.info||typeof o.info.id!="number"||d.push({type:"cellPropertiesChanged",text:e.textContent||"",author:o.info.author||"",date:o.info.date??void 0,from:t,to:t+e.nodeSize,revisionId:o.info.id});}if(e.type.name==="table"){let r=e.attrs.tblPrChange;if(Array.isArray(r))for(let l of r)!l?.info||typeof l.info.id!="number"||d.push({type:"tablePropertiesChanged",text:"",author:l.info.author||"",date:l.info.date??void 0,from:t,to:t+e.nodeSize,revisionId:l.info.id});let i=e.firstChild,o=i?.attrs.trIns,a=i?.attrs.trDel,x=o?"trIns":a?"trDel":null;if(x){let l=o??a,R=true,M=[];if(e.forEach(p=>{if(p.type.name!=="tableRow"){R=false;return}let c=p.attrs[x];if(!c||(c.author??"")!==(l.author??"")||(c.date??null)!==(l.date??null)){R=false;return}M.push(c.revisionId);}),R){let p="";g?e.descendants(h=>{h.isText&&!h.marks.some(P=>P.type===g)&&(p+=h.text||"");}):p=e.textContent||"";let c=l.revisionId,A=M.filter((h,P)=>h!==c&&M.indexOf(h)===P);d.push({type:x==="trIns"?"tableInserted":"tableDeleted",text:p,author:l.author||"",date:l.date??void 0,from:t,to:t+e.nodeSize,revisionId:c,...A.length>0?{coalescedRevisionIds:A}:{}});}}}if(!e.isInline)return;let n=e.isText?e.text||"":e.type.name==="image"?e.attrs.alt||"image":e.type.name,s=null;for(let r of e.marks)(r.type===b||r.type===g)&&(d.push({type:r.type===b?"insertion":"deletion",text:n,author:r.attrs.author||"",date:r.attrs.date,from:t,to:t+e.nodeSize,revisionId:r.attrs.revisionId}),s=r);if(w&&s){let r=e.marks.find(i=>i.type===w);if(r){let i=r.attrs.commentId,o=s.attrs.revisionId;C.has(i)||C.set(i,o);}}});let k={tableInserted:6,tableDeleted:6,tablePropertiesChanged:5,rowInserted:4,rowDeleted:4,rowPropertiesChanged:4,cellInserted:3,cellDeleted:3,cellMerged:3,cellPropertiesChanged:3,paragraphMarkInsertion:2,paragraphMarkDeletion:2,paragraphPropertiesChanged:2},U=e=>e in k,E=new Map,f=[],T=(e,t)=>{let n=new Set(e.coalescedRevisionIds??[]);for(let s of t.coalescedRevisionIds??[])n.add(s);return n.add(t.revisionId),n.delete(e.revisionId),[...n]};for(let e of d){if(!U(e.type)){f.push(e);continue}let t=`${e.author}|${e.date??""}`,n=E.get(t);if(n===void 0){E.set(t,f.push(e)-1);continue}let s=f[n],r=k[e.type]??0,i=k[s.type]??0;r>i?f[n]={...e,coalescedRevisionIds:T(e,s)}:f[n]={...s,coalescedRevisionIds:T(s,e)};}let D=new Map,y=[];for(let e of f){if(!(e.type==="insertion"||e.type==="deletion")){y.push({...e});continue}let n=`${e.type}|${e.author}|${e.date??""}`,s=D.get(n);if(s){let r=s.to===e.from?"":" ";if(s.text+=r+e.text,s.to=e.to,e.revisionId!==s.revisionId){let i=new Set(s.coalescedRevisionIds??[]);for(let o of e.coalescedRevisionIds??[])i.add(o);i.add(e.revisionId),i.delete(s.revisionId),s.coalescedRevisionIds=i.size>0?[...i]:void 0;}}else {let r={...e};D.set(n,r),y.push(r);}}let u=[];for(let e=0;e<y.length;e++){let t=y[e],n=y[e+1];t.type==="deletion"&&n&&n.type==="insertion"&&t.author===n.author&&t.date===n.date&&t.to===n.from?(u.push({type:"replacement",text:n.text,deletedText:t.text,author:t.author,date:t.date,from:t.from,to:n.to,revisionId:t.revisionId,insertionRevisionId:n.revisionId}),e++):u.push(t);}let I=new Map;for(let e of u)if(e.type==="insertion"||e.type==="deletion"||e.type==="replacement"){let t=`${e.author}|${e.date??""}`;I.has(t)||I.set(t,e);}for(let e of u){if(e.type!=="paragraphMarkInsertion"&&e.type!=="paragraphMarkDeletion")continue;let t=I.get(`${e.author}|${e.date??""}`);if(!t)continue;let n=new Set(t.coalescedRevisionIds??[]);for(let s of e.coalescedRevisionIds??[])n.add(s);n.add(e.revisionId),n.delete(t.revisionId),t.type==="replacement"&&t.insertionRevisionId!=null&&n.delete(t.insertionRevisionId),t.coalescedRevisionIds=n.size>0?[...n]:void 0;}let z=new Set,m=new Map;for(let e of u){if(e.type!=="tableInserted"&&e.type!=="tableDeleted")continue;let t=`${e.author}|${e.date??""}`;e.text.trim().length>0||(z.add(e),m.has(t)||m.set(t,e));}for(let e of u){if(e.type!=="paragraphMarkInsertion"&&e.type!=="paragraphMarkDeletion")continue;let t=m.get(`${e.author}|${e.date??""}`);if(!t)continue;let n=new Set(t.coalescedRevisionIds??[]);for(let s of e.coalescedRevisionIds??[])n.add(s);n.add(e.revisionId),n.delete(t.revisionId),t.coalescedRevisionIds=n.size>0?[...n]:void 0;}let H=u.filter(e=>e.type==="insertion"||e.type==="replacement"),$=new Set;for(let e of u){if(e.type!=="paragraphPropertiesChanged")continue;let t=H.find(s=>s.author===e.author&&s.from<e.to&&e.from<s.to);if(!t)continue;let n=new Set(T(t,e));t.type==="replacement"&&t.insertionRevisionId!=null&&n.delete(t.insertionRevisionId),t.coalescedRevisionIds=n.size>0?[...n]:void 0,$.add(e);}return {entries:u.filter(e=>{let t=`${e.author}|${e.date??""}`;return e.type==="tableInserted"||e.type==="tableDeleted"?z.has(e):e.type==="paragraphMarkInsertion"||e.type==="paragraphMarkDeletion"?!I.has(t)&&!m.has(t):e.type==="paragraphPropertiesChanged"?!$.has(e):e.type==="insertion"||e.type==="deletion"||e.type==="replacement"?!m.has(t):true}),commentToRevision:C}}exports.extractTrackedChanges=O;