@zeke-02/docx-editor-core 0.1.0

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

@@ -0,0 +1,154 @@
+/**
+ * ProseMirror Plugins
+ *
+ * Selection tracker plugin for the DOCX editor.
+ * Keymap plugins are now provided by the extension system.
+ * @packageDocumentation
+ * @public
+ */
+export { SelectionChangeCallback, SelectionContext, createSelectionTrackerPlugin, extractSelectionContext, getSelectionContext, selectionTrackerKey } from './selectionTracker.js';
+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 state + shared meta keys.
+ *
+ * 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.
+ */
+
+interface SuggestionModeState {
+    active: boolean;
+    author: string;
+}
+declare const suggestionModeKey: PluginKey<SuggestionModeState>;
+
+/**
+ * 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.
+ */
+
+/**
+ * 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 '@zeke-02/docx-editor-core/prosemirror/plugins';
+ * toggleSuggestionMode(view.state, view.dispatch);
+ * ```
+ */
+declare function toggleSuggestionMode(state: EditorState, dispatch?: (tr: Transaction) => void): boolean;
+/**
+ * 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 '@zeke-02/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;
+/**
+ * Check if suggestion mode is currently active.
+ */
+declare function isSuggestionModeActive(state: EditorState): boolean;
+
+/**
+ * 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 (`@zeke-02/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 '@zeke-02/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

@@ -0,0 +1 @@
+'use strict';require('../../chunk-U74VPTIU.js');var chunk2HFQ4QTU_js=require('../../chunk-2HFQ4QTU.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 chunk2HFQ4QTU_js.d}});Object.defineProperty(exports,"isSuggestionModeActive",{enumerable:true,get:function(){return chunk2HFQ4QTU_js.c}});Object.defineProperty(exports,"setSuggestionMode",{enumerable:true,get:function(){return chunk2HFQ4QTU_js.b}});Object.defineProperty(exports,"toggleSuggestionMode",{enumerable:true,get:function(){return chunk2HFQ4QTU_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

@@ -0,0 +1 @@
+import'../../chunk-FDEDN2RC.mjs';export{d as createSuggestionModePlugin,c as isSuggestionModeActive,b as setSuggestionMode,a as toggleSuggestionMode}from'../../chunk-G3YJ5RKC.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/plugins/selectionTracker.d.mts

@@ -0,0 +1,78 @@
+/**
+ * Selection Tracker Plugin
+ *
+ * Tracks selection changes and emits events for toolbar state updates.
+ * Provides the current selection context including:
+ * - Text formatting at cursor/selection
+ * - Paragraph formatting
+ * - Selection range information
+ * @packageDocumentation
+ * @public
+ */
+import { Plugin, EditorState, PluginKey } from 'prosemirror-state';
+import { T as TextFormatting, P as ParagraphFormatting } from '../../formatting-BH4hcZiq.mjs';
+import '../../colors-C3vA7HUU.mjs';
+
+/**
+ * Selection Tracker Plugin
+ *
+ * Tracks selection changes and emits events for toolbar state updates.
+ * Provides the current selection context including:
+ * - Text formatting at cursor/selection
+ * - Paragraph formatting
+ * - Selection range information
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Selection context for toolbar state
+ */
+interface SelectionContext {
+    /** Whether there's a non-collapsed selection */
+    hasSelection: boolean;
+    /** Whether selection spans multiple paragraphs */
+    isMultiParagraph: boolean;
+    /** Current text formatting at cursor/selection */
+    textFormatting: TextFormatting;
+    /** Current paragraph formatting */
+    paragraphFormatting: ParagraphFormatting;
+    /** Start paragraph index */
+    startParagraphIndex: number;
+    /** End paragraph index */
+    endParagraphIndex: number;
+    /** Whether cursor is in a list */
+    inList: boolean;
+    /** List type if in list */
+    listType?: 'bullet' | 'numbered';
+    /** List level (0-8) */
+    listLevel?: number;
+    /** Active comment IDs at cursor position */
+    activeCommentIds: number[];
+    /** Whether cursor is inside a tracked insertion */
+    inInsertion: boolean;
+    /** Whether cursor is inside a tracked deletion */
+    inDeletion: boolean;
+}
+/**
+ * Plugin key for accessing selection tracker state
+ */
+declare const selectionTrackerKey: PluginKey<SelectionContext>;
+/**
+ * Callback type for selection changes
+ */
+type SelectionChangeCallback = (context: SelectionContext) => void;
+/**
+ * Extract selection context from editor state
+ */
+declare function extractSelectionContext(state: EditorState): SelectionContext;
+/**
+ * Create selection tracker plugin
+ */
+declare function createSelectionTrackerPlugin(onSelectionChange?: SelectionChangeCallback): Plugin;
+/**
+ * Get current selection context from editor state
+ */
+declare function getSelectionContext(state: EditorState): SelectionContext | null;
+
+export { type SelectionChangeCallback, type SelectionContext, createSelectionTrackerPlugin, extractSelectionContext, getSelectionContext, selectionTrackerKey };

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

@@ -0,0 +1,78 @@
+/**
+ * Selection Tracker Plugin
+ *
+ * Tracks selection changes and emits events for toolbar state updates.
+ * Provides the current selection context including:
+ * - Text formatting at cursor/selection
+ * - Paragraph formatting
+ * - Selection range information
+ * @packageDocumentation
+ * @public
+ */
+import { Plugin, EditorState, PluginKey } from 'prosemirror-state';
+import { T as TextFormatting, P as ParagraphFormatting } from '../../formatting-_OXU8gLB.js';
+import '../../colors-C3vA7HUU.js';
+
+/**
+ * Selection Tracker Plugin
+ *
+ * Tracks selection changes and emits events for toolbar state updates.
+ * Provides the current selection context including:
+ * - Text formatting at cursor/selection
+ * - Paragraph formatting
+ * - Selection range information
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Selection context for toolbar state
+ */
+interface SelectionContext {
+    /** Whether there's a non-collapsed selection */
+    hasSelection: boolean;
+    /** Whether selection spans multiple paragraphs */
+    isMultiParagraph: boolean;
+    /** Current text formatting at cursor/selection */
+    textFormatting: TextFormatting;
+    /** Current paragraph formatting */
+    paragraphFormatting: ParagraphFormatting;
+    /** Start paragraph index */
+    startParagraphIndex: number;
+    /** End paragraph index */
+    endParagraphIndex: number;
+    /** Whether cursor is in a list */
+    inList: boolean;
+    /** List type if in list */
+    listType?: 'bullet' | 'numbered';
+    /** List level (0-8) */
+    listLevel?: number;
+    /** Active comment IDs at cursor position */
+    activeCommentIds: number[];
+    /** Whether cursor is inside a tracked insertion */
+    inInsertion: boolean;
+    /** Whether cursor is inside a tracked deletion */
+    inDeletion: boolean;
+}
+/**
+ * Plugin key for accessing selection tracker state
+ */
+declare const selectionTrackerKey: PluginKey<SelectionContext>;
+/**
+ * Callback type for selection changes
+ */
+type SelectionChangeCallback = (context: SelectionContext) => void;
+/**
+ * Extract selection context from editor state
+ */
+declare function extractSelectionContext(state: EditorState): SelectionContext;
+/**
+ * Create selection tracker plugin
+ */
+declare function createSelectionTrackerPlugin(onSelectionChange?: SelectionChangeCallback): Plugin;
+/**
+ * Get current selection context from editor state
+ */
+declare function getSelectionContext(state: EditorState): SelectionContext | null;
+
+export { type SelectionChangeCallback, type SelectionContext, createSelectionTrackerPlugin, extractSelectionContext, getSelectionContext, selectionTrackerKey };

package/dist/prosemirror/plugins/selectionTracker.js

@@ -0,0 +1 @@
+'use strict';var chunk6LVPRTB6_js=require('../../chunk-6LVPRTB6.js');require('../../chunk-DC7S76ZX.js');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}});

package/dist/prosemirror/plugins/selectionTracker.mjs

@@ -0,0 +1 @@
+export{c as createSelectionTrackerPlugin,b as extractSelectionContext,d as getSelectionContext,a as selectionTrackerKey}from'../../chunk-BGY3CB37.mjs';import'../../chunk-QYUPLKLP.mjs';

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

@@ -0,0 +1,29 @@
+/**
+ * ProseMirror Schema for DOCX Editor
+ *
+ * Singleton ExtensionManager that builds the schema and initializes runtime.
+ * Legacy code imports `schema` and commands from here; new code should use
+ * ExtensionManager directly.
+ * @packageDocumentation
+ * @public
+ */
+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-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 '../../colors-C3vA7HUU.mjs';
+import '../../formatting-BH4hcZiq.mjs';
+import '../../content-5Mrz6w_b.mjs';
+import '../../docx/wrapTypes.mjs';
+
+declare const singletonManager: ExtensionManager;
+declare const schema: prosemirror_model.Schema<any, any>;
+/**
+ * Export types for convenience
+ */
+type DocxSchema = typeof schema;
+type DocxNode = ReturnType<typeof schema.node>;
+type DocxMark = ReturnType<typeof schema.mark>;
+
+export { type DocxMark, type DocxNode, type DocxSchema, schema, singletonManager };

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

@@ -0,0 +1,29 @@
+/**
+ * ProseMirror Schema for DOCX Editor
+ *
+ * Singleton ExtensionManager that builds the schema and initializes runtime.
+ * Legacy code imports `schema` and commands from here; new code should use
+ * ExtensionManager directly.
+ * @packageDocumentation
+ * @public
+ */
+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-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 '../../colors-C3vA7HUU.js';
+import '../../formatting-_OXU8gLB.js';
+import '../../content-CmqAwdFL.js';
+import '../../docx/wrapTypes.js';
+
+declare const singletonManager: ExtensionManager;
+declare const schema: prosemirror_model.Schema<any, any>;
+/**
+ * Export types for convenience
+ */
+type DocxSchema = typeof schema;
+type DocxNode = ReturnType<typeof schema.node>;
+type DocxMark = ReturnType<typeof schema.mark>;
+
+export { type DocxMark, type DocxNode, type DocxSchema, schema, singletonManager };

package/dist/prosemirror/schema/index.js

@@ -0,0 +1 @@
+'use strict';var chunkSHJBS42Y_js=require('../../chunk-SHJBS42Y.js');require('../../chunk-MCFHOMA2.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 chunkSHJBS42Y_js.b}});Object.defineProperty(exports,"singletonManager",{enumerable:true,get:function(){return chunkSHJBS42Y_js.a}});

package/dist/prosemirror/schema/index.mjs

@@ -0,0 +1 @@
+export{b as schema,a as singletonManager}from'../../chunk-J7NADDC4.mjs';import'../../chunk-2MSZXH6Q.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/styles/index.d.mts

@@ -0,0 +1,124 @@
+/**
+ * Style utilities for ProseMirror editor
+ * @packageDocumentation
+ * @public
+ */
+import { P as ParagraphFormatting, T as TextFormatting } from '../../formatting-BH4hcZiq.mjs';
+import { a as StyleDefinitions, S as Style, D as DocDefaults } from '../../styles-EI2lxeEN.mjs';
+import '../../colors-C3vA7HUU.mjs';
+
+/**
+ * Style Resolver for ProseMirror Editor
+ *
+ * Resolves OOXML style definitions to final paragraph and run properties.
+ * Handles the cascade:
+ * 1. Document defaults (docDefaults)
+ * 2. Normal style (if no explicit styleId)
+ * 3. Style chain (basedOn inheritance - already resolved by styleParser)
+ * 4. Inline properties
+ *
+ * Based on ECMA-376 style cascade rules.
+ */
+
+/**
+ * Resolved style properties ready for rendering
+ */
+interface ResolvedParagraphStyle {
+    /** Paragraph formatting (alignment, spacing, indentation, etc.) */
+    paragraphFormatting?: ParagraphFormatting;
+    /** Default run formatting from the style */
+    runFormatting?: TextFormatting;
+}
+/**
+ * StyleResolver provides efficient access to resolved style properties
+ */
+declare class StyleResolver {
+    private readonly stylesById;
+    private readonly docDefaults;
+    private readonly defaultParagraphStyle;
+    private readonly defaultTableStyle;
+    private readonly defaultCharacterStyle;
+    constructor(styleDefinitions: StyleDefinitions | undefined);
+    /**
+     * Get a style by ID
+     */
+    getStyle(styleId: string): Style | undefined;
+    /**
+     * Get all available paragraph styles (for toolbar dropdown)
+     */
+    getParagraphStyles(): Style[];
+    /**
+     * Whether a paragraph style with the given id is defined in the
+     * document's `styles.xml`. Used by the agent toolkit to refuse
+     * `set_paragraph_style({ styleId: 'NoSuchStyle' })` instead of
+     * silently writing an invalid `<w:pStyle>` reference.
+     */
+    hasParagraphStyle(styleId: string): boolean;
+    /**
+     * Resolve paragraph style properties, including docDefaults cascade
+     *
+     * @param styleId - The style ID to resolve (e.g., 'Heading1', 'Normal')
+     * @returns Resolved paragraph and run formatting
+     */
+    resolveParagraphStyle(styleId: string | undefined | null): ResolvedParagraphStyle;
+    /**
+     * Get all available table styles (for style gallery)
+     */
+    getTableStyles(): Style[];
+    /**
+     * Resolve run (character) style properties
+     *
+     * @param styleId - The character style ID to resolve
+     * @returns Resolved text formatting
+     */
+    resolveRunStyle(styleId: string | undefined | null): TextFormatting | undefined;
+    /**
+     * Get a character style's own properties WITHOUT docDefaults.
+     * Used when the caller already has docDefaults applied (e.g., from paragraph style resolution).
+     * This prevents docDefault fonts from incorrectly overriding paragraph style fonts.
+     */
+    getRunStyleOwnProperties(styleId: string | undefined | null): TextFormatting | undefined;
+    /**
+     * Get document defaults
+     */
+    getDocDefaults(): DocDefaults | undefined;
+    /**
+     * Get default paragraph style (usually "Normal")
+     */
+    getDefaultParagraphStyle(): Style | undefined;
+    /**
+     * Get the default table style (the one marked `w:default="1"`).
+     *
+     * Per ECMA-376 §17.7.4.18, tables that don't specify a `w:tblStyle`
+     * inherit from this style. The styleId varies by document language
+     * ("Normal Table", "TableNormal", "Tabelanormal", etc.) — find it by
+     * the parsed `default` flag, not by name.
+     */
+    getDefaultTableStyle(): Style | undefined;
+    /**
+     * Get the default character style (the one marked `w:default="1"`).
+     *
+     * Per ECMA-376 §17.7.4.18, runs without an explicit `w:rStyle` reference
+     * inherit from this style. The styleId varies by document language
+     * ("Default Paragraph Font", "FontePadrao", "Fontepargpadro" in
+     * Portuguese fixtures, etc.) — find it by the parsed `default` flag.
+     */
+    getDefaultCharacterStyle(): Style | undefined;
+    /**
+     * Check if a style exists
+     */
+    hasStyle(styleId: string): boolean;
+    private findDefaultStyle;
+    private mergeStyleIntoResult;
+    /**
+     * Merge paragraph formatting (source overrides target)
+     */
+    private mergeParagraphFormatting;
+    private mergeTextFormatting;
+}
+/**
+ * Create a style resolver from document's style definitions
+ */
+declare function createStyleResolver(styleDefinitions: StyleDefinitions | undefined): StyleResolver;
+
+export { type ResolvedParagraphStyle, StyleResolver, createStyleResolver };

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

@@ -0,0 +1,124 @@
+/**
+ * Style utilities for ProseMirror editor
+ * @packageDocumentation
+ * @public
+ */
+import { P as ParagraphFormatting, T as TextFormatting } from '../../formatting-_OXU8gLB.js';
+import { a as StyleDefinitions, S as Style, D as DocDefaults } from '../../styles-BBv7doYK.js';
+import '../../colors-C3vA7HUU.js';
+
+/**
+ * Style Resolver for ProseMirror Editor
+ *
+ * Resolves OOXML style definitions to final paragraph and run properties.
+ * Handles the cascade:
+ * 1. Document defaults (docDefaults)
+ * 2. Normal style (if no explicit styleId)
+ * 3. Style chain (basedOn inheritance - already resolved by styleParser)
+ * 4. Inline properties
+ *
+ * Based on ECMA-376 style cascade rules.
+ */
+
+/**
+ * Resolved style properties ready for rendering
+ */
+interface ResolvedParagraphStyle {
+    /** Paragraph formatting (alignment, spacing, indentation, etc.) */
+    paragraphFormatting?: ParagraphFormatting;
+    /** Default run formatting from the style */
+    runFormatting?: TextFormatting;
+}
+/**
+ * StyleResolver provides efficient access to resolved style properties
+ */
+declare class StyleResolver {
+    private readonly stylesById;
+    private readonly docDefaults;
+    private readonly defaultParagraphStyle;
+    private readonly defaultTableStyle;
+    private readonly defaultCharacterStyle;
+    constructor(styleDefinitions: StyleDefinitions | undefined);
+    /**
+     * Get a style by ID
+     */
+    getStyle(styleId: string): Style | undefined;
+    /**
+     * Get all available paragraph styles (for toolbar dropdown)
+     */
+    getParagraphStyles(): Style[];
+    /**
+     * Whether a paragraph style with the given id is defined in the
+     * document's `styles.xml`. Used by the agent toolkit to refuse
+     * `set_paragraph_style({ styleId: 'NoSuchStyle' })` instead of
+     * silently writing an invalid `<w:pStyle>` reference.
+     */
+    hasParagraphStyle(styleId: string): boolean;
+    /**
+     * Resolve paragraph style properties, including docDefaults cascade
+     *
+     * @param styleId - The style ID to resolve (e.g., 'Heading1', 'Normal')
+     * @returns Resolved paragraph and run formatting
+     */
+    resolveParagraphStyle(styleId: string | undefined | null): ResolvedParagraphStyle;
+    /**
+     * Get all available table styles (for style gallery)
+     */
+    getTableStyles(): Style[];
+    /**
+     * Resolve run (character) style properties
+     *
+     * @param styleId - The character style ID to resolve
+     * @returns Resolved text formatting
+     */
+    resolveRunStyle(styleId: string | undefined | null): TextFormatting | undefined;
+    /**
+     * Get a character style's own properties WITHOUT docDefaults.
+     * Used when the caller already has docDefaults applied (e.g., from paragraph style resolution).
+     * This prevents docDefault fonts from incorrectly overriding paragraph style fonts.
+     */
+    getRunStyleOwnProperties(styleId: string | undefined | null): TextFormatting | undefined;
+    /**
+     * Get document defaults
+     */
+    getDocDefaults(): DocDefaults | undefined;
+    /**
+     * Get default paragraph style (usually "Normal")
+     */
+    getDefaultParagraphStyle(): Style | undefined;
+    /**
+     * Get the default table style (the one marked `w:default="1"`).
+     *
+     * Per ECMA-376 §17.7.4.18, tables that don't specify a `w:tblStyle`
+     * inherit from this style. The styleId varies by document language
+     * ("Normal Table", "TableNormal", "Tabelanormal", etc.) — find it by
+     * the parsed `default` flag, not by name.
+     */
+    getDefaultTableStyle(): Style | undefined;
+    /**
+     * Get the default character style (the one marked `w:default="1"`).
+     *
+     * Per ECMA-376 §17.7.4.18, runs without an explicit `w:rStyle` reference
+     * inherit from this style. The styleId varies by document language
+     * ("Default Paragraph Font", "FontePadrao", "Fontepargpadro" in
+     * Portuguese fixtures, etc.) — find it by the parsed `default` flag.
+     */
+    getDefaultCharacterStyle(): Style | undefined;
+    /**
+     * Check if a style exists
+     */
+    hasStyle(styleId: string): boolean;
+    private findDefaultStyle;
+    private mergeStyleIntoResult;
+    /**
+     * Merge paragraph formatting (source overrides target)
+     */
+    private mergeParagraphFormatting;
+    private mergeTextFormatting;
+}
+/**
+ * Create a style resolver from document's style definitions
+ */
+declare function createStyleResolver(styleDefinitions: StyleDefinitions | undefined): StyleResolver;
+
+export { type ResolvedParagraphStyle, StyleResolver, createStyleResolver };

package/dist/prosemirror/styles/index.js

@@ -0,0 +1 @@
+'use strict';var chunkIP2VXNWG_js=require('../../chunk-IP2VXNWG.js');require('../../chunk-MZOVDLYL.js'),require('../../chunk-Q4CKLXWA.js'),require('../../chunk-DC7S76ZX.js');Object.defineProperty(exports,"StyleResolver",{enumerable:true,get:function(){return chunkIP2VXNWG_js.a}});Object.defineProperty(exports,"createStyleResolver",{enumerable:true,get:function(){return chunkIP2VXNWG_js.b}});

package/dist/prosemirror/styles/index.mjs

@@ -0,0 +1 @@
+export{a as StyleResolver,b as createStyleResolver}from'../../chunk-NBLJPT54.mjs';import'../../chunk-ILJUDEZ5.mjs';import'../../chunk-VQWZHPWI.mjs';import'../../chunk-QYUPLKLP.mjs';