@heyirisai/docx-editor-vue 1.9.0

package/dist/_plugin-vue_export-helper-B52Kst-M.js

@@ -0,0 +1,8 @@
+//#region \0plugin-vue:export-helper
+var e = (e, t) => {
+	let n = e.__vccOpts || e;
+	for (let [e, r] of t) n[e] = r;
+	return n;
+};
+//#endregion
+export { e as t };

package/dist/_plugin-vue_export-helper-CX7YVcP6.cjs

@@ -0,0 +1 @@
+var e=(e,t)=>{let n=e.__vccOpts||e;for(let[e,r]of t)n[e]=r;return n};Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return e}});

package/dist/components/DocxEditor/types.d.ts

@@ -0,0 +1,193 @@
+import { Plugin } from 'prosemirror-state';
+import { EditorView } from 'prosemirror-view';
+import { Document, Theme } from '@heyirisai/docx-editor-core/types/document';
+import { Comment } from '@heyirisai/docx-editor-core/types/content';
+import { SelectionState, PMContentControl } from '@heyirisai/docx-editor-core/prosemirror';
+import { DocxInput, ScrollToParaIdOptions, FontDefinition } from '@heyirisai/docx-editor-core/utils';
+import { FontOption } from '@heyirisai/docx-editor-core/utils/fontOptions';
+import { StyleValue, VNodeChild } from 'vue';
+import { EditorRefLike } from '@heyirisai/docx-editor-agents/bridge';
+import { ContentControlFilter, ContentControlValue } from '@heyirisai/docx-editor-core/agent';
+import { Translations } from '@heyirisai/docx-editor-i18n';
+export type EditorMode = 'editing' | 'suggesting' | 'viewing';
+/**
+ * Public props for the Vue editor component.
+ */
+export interface DocxEditorProps {
+    /** Document data — ArrayBuffer, Uint8Array, Blob, or File. */
+    documentBuffer?: DocxInput | null;
+    /** Pre-parsed document model, alternative to documentBuffer. */
+    document?: Document | null;
+    /** Whether to show the main formatting toolbar. */
+    showToolbar?: boolean;
+    /**
+     * Whether to show `File > Open` and enable Cmd/Ctrl+O (default: true).
+     * Set false when you provide your own open action elsewhere.
+     */
+    showFileOpen?: boolean;
+    /** Whether to show the Help menu in the menu bar (default: true). */
+    showHelpMenu?: boolean;
+    /** Whether to show the title/menu bar. Vue-only chrome toggle. */
+    showMenuBar?: boolean;
+    /** Whether to show page rulers. */
+    showRuler?: boolean;
+    /** Document name shown in the title bar. */
+    documentName?: string;
+    /** Whether the editor is read-only. */
+    readOnly?: boolean;
+    /** Author name used for comments and tracked changes created in the UI. Defaults to `'User'`. */
+    author?: string;
+    /** Editor mode: direct editing, suggesting, or viewing. */
+    mode?: EditorMode;
+    /** Callback when the editing mode changes. */
+    onModeChange?: (mode: EditorMode) => void;
+    /** Controlled comments-sidebar visibility; source of truth when set. Pair with `onCommentsSidebarOpenChange`; omit for the default self-managed behavior. */
+    commentsSidebarOpen?: boolean;
+    /** Fires with the next open state whenever the editor wants to show or hide the comments sidebar. Fires in both controlled and uncontrolled modes. */
+    onCommentsSidebarOpenChange?: (open: boolean) => void;
+    /** Translation overrides merged with English fallback. */
+    i18n?: Translations;
+    /** Theme override used for toolbar color palettes when the document has no theme. */
+    theme?: Theme | null;
+    /** Color theme mode for UI styling. `'system'` follows the OS preference. */
+    colorMode?: 'light' | 'dark' | 'system';
+    /** External ProseMirror plugins supplied by the host app. */
+    externalPlugins?: Plugin[];
+    /** Whether to show the zoom controls in the toolbar. */
+    showZoomControl?: boolean;
+    /** Initial zoom level. */
+    initialZoom?: number;
+    /** Custom toolbar content appended after the built-in controls. */
+    toolbarExtra?: () => VNodeChild;
+    /** Additional CSS class name on the editor root. */
+    className?: string;
+    /** Additional inline styles on the editor root. */
+    style?: StyleValue;
+    /** Whether to show the document outline panel initially. */
+    showOutline?: boolean;
+    /** Whether to show the floating outline toggle button. */
+    showOutlineButton?: boolean;
+    /** Custom list of fonts shown in the font-family dropdown. */
+    fontFamilies?: ReadonlyArray<string | FontOption>;
+    /**
+     * Custom font faces to register before the editor measures text. Each entry
+     * injects an `@font-face` rule. Pass a URL (woff2/woff/ttf/otf), an
+     * ArrayBuffer, or omit `src` to load by name from Google Fonts. Multiple
+     * entries can share `family` to register different weights/styles.
+     */
+    fonts?: ReadonlyArray<FontDefinition>;
+    /**
+     * Text-watermark presets shown in the watermark dialog's preset dropdown.
+     * Omit to use the built-in MS Word phrases (`DEFAULT_WATERMARK_PRESETS`).
+     * Pass an empty array to hide the preset dropdown.
+     */
+    watermarkPresets?: readonly string[];
+    /**
+     * Callback fired when the print action is triggered. Pass it to enable the
+     * `File > Print` menu entry; omit to hide. The `editor.print()` ref method
+     * also invokes this callback.
+     */
+    onPrint?: () => void;
+    /**
+     * Callback when a DOCX file is selected through `File > Open` or Cmd/Ctrl+O.
+     * Pass it to route the picked file through your own import pipeline. Omit it
+     * to keep the built-in local document load behavior.
+     */
+    onOpen?: (file: File) => void | Promise<void>;
+    /** Disable Cmd/Ctrl+F and Cmd/Ctrl+H interception. */
+    disableFindReplaceShortcuts?: boolean;
+    /** Custom logo/icon renderer for the title bar. Slots remain preferred in templates. */
+    renderLogo?: () => VNodeChild;
+    /** Callback when the document name changes. */
+    onDocumentNameChange?: (name: string) => void;
+    /** Whether the document name is editable. */
+    documentNameEditable?: boolean;
+    /** Custom right-side actions renderer for the title bar. Slots remain preferred in templates. */
+    renderTitleBarRight?: () => VNodeChild;
+    /** Callback fired whenever the document changes. Mirrors the `@change` event. */
+    onChange?: (document: Document) => void;
+    /** Callback fired when the editor errors (parse/layout/font). Mirrors the `@error` event. */
+    onError?: (error: Error) => void;
+    /** Callback fired when the selection changes, with the current selection state (or null). */
+    onSelectionChange?: (state: SelectionState | null) => void;
+    /** Callback fired once the underlying ProseMirror EditorView is ready. */
+    onEditorViewReady?: (view: EditorView) => void;
+    /** Callback fired when a top-level comment is added via the UI. */
+    onCommentAdd?: (comment: Comment) => void;
+    /** Callback fired when a comment is resolved via the UI. Receives the comment with `done: true`. */
+    onCommentResolve?: (comment: Comment) => void;
+    /** Callback fired when a comment (and its replies) is deleted via the UI. */
+    onCommentDelete?: (comment: Comment) => void;
+    /** Callback fired when a reply is added to a comment via the UI. */
+    onCommentReply?: (reply: Comment, parent: Comment) => void;
+    /** Callback fired with the full comment array whenever it changes (add/reply/resolve/delete). */
+    onCommentsChange?: (comments: Comment[]) => void;
+}
+/**
+ * Public ref shape for `<DocxEditor>`. Exposes the full editor-scope
+ * `EditorRefLike` contract so the agent bridge can attach to either
+ * React or Vue without an adapter shim.
+ */
+export type DocxEditorRef = EditorRefLike & {
+    /** Agent instance access is React-only today; Vue returns null for API parity. */
+    getAgent(): null;
+    /** Save the document and return DOCX bytes, matching React's component ref. */
+    save(): Promise<ArrayBuffer | null>;
+    /** Set zoom level (1.0 = 100%). */
+    setZoom(zoom: number): void;
+    /** Get current zoom level. */
+    getZoom(): number;
+    /** Focus the editor's hidden ProseMirror view. Vue-only — not in EditorRefLike. */
+    focus(): void;
+    /** Scroll to a body paragraph by Word `w14:paraId`, optionally flashing it. */
+    scrollToParaId(paraId: string, options?: ScrollToParaIdOptions): boolean;
+    /** Scroll the visible pages to a 1-indexed page number. */
+    scrollToPage(pageNumber: number): void;
+    /** Scroll to a raw ProseMirror document position. */
+    scrollToPosition(pmPos: number): void;
+    /**
+     * Scroll the comment with the given id into view and select its anchored
+     * range so the selection overlay highlights it. False when the id no longer
+     * resolves (the comment was deleted or its anchored text removed).
+     */
+    scrollToCommentId(commentId: number): boolean;
+    /**
+     * Scroll the tracked change with the given revision id into view and select
+     * its range so the selection overlay highlights it. False when the id no
+     * longer resolves (the change was accepted/rejected/deleted).
+     */
+    scrollToChangeId(revisionId: number): boolean;
+    /**
+     * Select the position range `[from, to]` so the selection overlay highlights
+     * it, and scroll its start into view. No-op for a malformed range or a
+     * `from` past the document end; `to` is clamped to the document size.
+     */
+    highlightRange(from: number, to: number): void;
+    /** Open print preview / browser print. */
+    openPrintPreview(): void;
+    /** Print the document. */
+    print(): void;
+    /** Load a pre-parsed document programmatically. */
+    loadDocument(doc: Document): void;
+    /** Load a DOCX buffer programmatically. */
+    loadDocumentBuffer(buffer: DocxInput): Promise<void>;
+    /** Tear down the editor (destroys the PM view + frees listeners). */
+    destroy(): void;
+    /** List block-level content controls (SDTs), optionally filtered by tag/alias/id/type. */
+    getContentControls(filter?: ContentControlFilter): PMContentControl[];
+    /** Scroll the first content control matching `filter` into view. False if none. */
+    scrollToContentControl(filter: ContentControlFilter): boolean;
+    /** Replace a control's content by tag with `text`. False if no match; throws if locked. */
+    setContentControlContent(filter: ContentControlFilter, text: string, options?: {
+        force?: boolean;
+    }): boolean;
+    /** Remove a control by tag (or unwrap with `keepContent`). False if no match; throws if locked. */
+    removeContentControl(filter: ContentControlFilter, options?: {
+        force?: boolean;
+        keepContent?: boolean;
+    }): boolean;
+    /** Set a typed value (dropdown / checkbox / date) on a control by tag. False if no match. */
+    setContentControlValue(filter: ContentControlFilter, value: ContentControlValue, options?: {
+        force?: boolean;
+    }): boolean;
+};

package/dist/components/EditorToolbarContext.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared toolbar prop bag — mirrors React's ToolbarProps. Loosely
+ * typed because the consumer surface here is just the slot-down
+ * channel; tightening would require dragging the entire
+ * ToolbarProps interface across the framework boundary.
+ */
+export type EditorToolbarProps = Record<string, unknown>;
+export declare function provideEditorToolbar(props: EditorToolbarProps): void;
+export declare function useEditorToolbar(): EditorToolbarProps;

package/dist/components/Toolbar/presets.d.ts

@@ -0,0 +1,20 @@
+import { FontOption } from '@heyirisai/docx-editor-core/utils/fontOptions';
+import { TranslationKey } from '@heyirisai/docx-editor-i18n';
+export declare const defaultFonts: FontOption[];
+export declare const fontSizePresets: number[];
+export interface ParagraphStylePreset {
+    id: string;
+    /** Fallback label used if the i18n key resolves to nothing. */
+    label: string;
+    nameKey: TranslationKey;
+}
+export declare const paragraphStyles: ParagraphStylePreset[];
+export interface LineSpacingPreset {
+    /** Fallback label; localized presets carry a `labelKey` instead. */
+    label: string;
+    labelKey?: TranslationKey;
+    value: number;
+}
+export declare const lineSpacingOptions: LineSpacingPreset[];
+export declare const ZOOM_PRESETS: number[];
+export declare const DEFAULT_ZOOM_PERCENT = 100;

package/dist/components/dialogs/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @heyirisai/docx-editor-vue/dialogs
+ *
+ * Modal dialog components — hyperlinks, find/replace, page setup, image
+ * properties, and keyboard shortcuts. Mirrors the React dialogs subpath.
+ *
+ * @example
+ * ```ts
+ * import { HyperlinkDialog, FindReplaceDialog } from '@heyirisai/docx-editor-vue/dialogs';
+ * ```
+ *
+ * @packageDocumentation
+ * @public
+ */
+export { default as FindReplaceDialog } from './FindReplaceDialog.vue';
+export { default as FootnotePropertiesDialog } from './FootnotePropertiesDialog.vue';
+export { default as HyperlinkDialog } from './HyperlinkDialog.vue';
+export { default as ImagePositionDialog } from './ImagePositionDialog.vue';
+export { default as ImagePropertiesDialog } from './ImagePropertiesDialog.vue';
+export { default as InsertImageDialog } from './InsertImageDialog.vue';
+export { default as InsertSymbolDialog } from './InsertSymbolDialog.vue';
+export { default as InsertTableDialog } from './InsertTableDialog.vue';
+export { default as KeyboardShortcutsDialog } from './KeyboardShortcutsDialog.vue';
+export { default as PageSetupDialog } from './PageSetupDialog.vue';
+export { default as PasteSpecialDialog } from './PasteSpecialDialog.vue';
+export { default as SplitCellDialog } from './SplitCellDialog.vue';
+export { default as TablePropertiesDialog } from './TablePropertiesDialog.vue';

package/dist/components/imageContextMenuTypes.d.ts

@@ -0,0 +1,30 @@
+import { WrapType } from '@heyirisai/docx-editor-core/docx/wrapTypes';
+type ImageAttrsCssFloat = 'left' | 'right' | 'none' | null;
+export interface ImageContextMenuState {
+    open: boolean;
+    position: {
+        x: number;
+        y: number;
+    };
+    pmPos: number;
+    currentWrapType: WrapType;
+    currentCssFloat?: ImageAttrsCssFloat;
+    inlinePositionEmu?: {
+        horizontalEmu: number;
+        verticalEmu: number;
+    };
+}
+/**
+ * Item appended below a divider — mirrors the React side
+ * (`ImageContextMenuTextAction`). `dividerAfter` lets the host group
+ * the items the same way Word does (Cut/Copy/Paste then divider then
+ * Delete).
+ */
+export interface ImageContextMenuTextAction {
+    action: string;
+    label: string;
+    shortcut?: string;
+    disabled?: boolean;
+    dividerAfter?: boolean;
+}
+export {};

package/dist/components/imageSelectionTypes.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared `ImageSelectionInfo` type — imported by
+ * `ImageSelectionOverlay.vue` (for `defineProps`) and
+ * `useImageActions.ts` (for the composable's `selectedImage` ref).
+ * Pulled out of the .vue SFC so a plain .ts module can reference it
+ * without going through the `*.vue` wildcard shim, which doesn't
+ * carry named type exports.
+ */
+export interface ImageSelectionInfo {
+    element: HTMLElement;
+    pmPos: number;
+    width: number;
+    height: number;
+}

package/dist/components/insertTableState.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Last-used Insert-Table dimensions. Module-level so the dialog reopens with
+ * whatever the user picked last time (mirrors React lifting this to component
+ * state that survives reopen).
+ */
+export declare const rememberedTableSize: {
+    rows: number;
+    cols: number;
+};

package/dist/components/sidebar/cardStyles.d.ts

@@ -0,0 +1,3 @@
+import { CSSProperties } from 'vue';
+export declare const CARD_STYLE_COLLAPSED: CSSProperties;
+export declare const CARD_STYLE_EXPANDED: CSSProperties;

package/dist/components/sidebar/cardUtils.d.ts

@@ -0,0 +1 @@
+export * from './sidebarUtils';

package/dist/components/sidebar/resolveItemPositions.d.ts

@@ -0,0 +1,4 @@
+import { CommentSidebarItem } from '../../composables/useCommentSidebarItems';
+import { ResolvedPosition as CoreResolvedPosition } from '@heyirisai/docx-editor-core/plugin-api/resolveItemPositions';
+export type ResolvedPosition = CoreResolvedPosition<CommentSidebarItem>;
+export declare const resolveItemPositions: (items: CommentSidebarItem[], anchorPositions: Map<string, number>, renderedDomContext: import('@heyirisai/docx-editor-core').RenderedDomContext | null, zoom: number, cardHeights: Map<string, number>, lastKnown: Map<string, number>) => CoreResolvedPosition<CommentSidebarItem>[];

package/dist/components/sidebar/sidebarUtils.d.ts

@@ -0,0 +1,4 @@
+import { CSSProperties } from 'vue';
+export { getCommentText, formatDate, getInitials, getAvatarColor, truncateText, type TrackedChangeEntry, } from '@heyirisai/docx-editor-core/utils/comments';
+/** Inline style for an avatar bubble — mirrors React's avatarStyle(). */
+export declare function avatarStyle(name: string, size?: 32 | 28): CSSProperties;

package/dist/components/tableStylePresets.d.ts

@@ -0,0 +1,53 @@
+import { CSSProperties } from 'vue';
+export interface TableStyleBorder {
+    style: string;
+    size?: number;
+    color?: {
+        rgb: string;
+    };
+}
+export interface TableStylePreset {
+    id: string;
+    name: string;
+    /** Table-level borders */
+    tableBorders?: {
+        top?: TableStyleBorder;
+        bottom?: TableStyleBorder;
+        left?: TableStyleBorder;
+        right?: TableStyleBorder;
+        insideH?: TableStyleBorder;
+        insideV?: TableStyleBorder;
+    };
+    /** Conditional formatting per cell position */
+    conditionals?: Record<string, {
+        backgroundColor?: string;
+        borders?: {
+            top?: TableStyleBorder | null;
+            bottom?: TableStyleBorder | null;
+            left?: TableStyleBorder | null;
+            right?: TableStyleBorder | null;
+        };
+        bold?: boolean;
+        color?: string;
+    }>;
+    /** Which conditional formatting is active by default */
+    look?: {
+        firstRow?: boolean;
+        lastRow?: boolean;
+        firstCol?: boolean;
+        lastCol?: boolean;
+        noHBand?: boolean;
+        noVBand?: boolean;
+    };
+}
+export declare const BUILTIN_TABLE_STYLES: TableStylePreset[];
+/** Get a built-in table style preset by ID. */
+export declare function getBuiltinTableStyle(styleId: string): TableStylePreset | undefined;
+/** Map from built-in style ID to en.json translation key under `table.styles.*`. */
+export declare const TABLE_STYLE_NAME_KEYS: Record<string, string>;
+/**
+ * Build the per-cell inline styles for a small preview grid of the given
+ * preset. Shared by TableStyleGallery and InsertTableDialog so the preview
+ * rendering stays in one place.
+ */
+export declare function getPreviewCells(preset: TableStylePreset, rows?: number, cols?: number): CSSProperties[];

package/dist/components/toolbarUtils.d.ts

@@ -0,0 +1 @@
+export { HIGHLIGHT_HEX_TO_NAME, mapHexToHighlightName, } from '@heyirisai/docx-editor-core/utils/highlightColors';

package/dist/components/ui/Icons.d.ts

@@ -0,0 +1 @@
+export { default as MaterialSymbol } from './MaterialSymbol.vue';

package/dist/components/ui/fontPickerValue.d.ts

@@ -0,0 +1 @@
+export declare function getPrimaryFontFamily(fontFamily: string): string;

package/dist/components/ui/fontPickerValue.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/ui/hyperlinkPopupTypes.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared `HyperlinkPopupData` type — imported by `HyperlinkPopup.vue`
+ * (for `defineProps`) and `useHyperlinkManagement.ts` (for the
+ * composable's `hyperlinkPopupData` ref). Pulled out of the .vue SFC so
+ * a plain .ts module can reference it without going through the `*.vue`
+ * wildcard shim, which doesn't carry named type exports.
+ */
+export interface HyperlinkPopupData {
+    href: string;
+    displayText: string;
+    tooltip?: string;
+    /** Popup position in the editor's pages-viewport coordinate space (CSS
+     *  pixels from its top-left). Computed once at click time. The popup
+     *  renders inside that viewport with `position: absolute`, so the
+     *  browser handles repositioning during scroll for free. */
+    position: {
+        top: number;
+        left: number;
+    };
+}

package/dist/composables/fileOpen.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/composables/imageOverlayRect.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Pure geometry for the Vue image-selection overlay. Kept separate from the
+ * component so the scrollbar-gutter handling can be unit-tested without a DOM.
+ */
+export interface OverlayRectInputs {
+    /** `image.getBoundingClientRect()` (viewport coords). */
+    imageRect: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    /** `offsetParent.getBoundingClientRect()` (the scroll container, viewport coords). */
+    parentRect: {
+        left: number;
+        top: number;
+    };
+    scrollLeft: number;
+    scrollTop: number;
+    /** `offsetParent.offsetWidth` / `.clientWidth` — used to derive the gutter. */
+    parentOffsetWidth: number;
+    parentClientWidth: number;
+    zoom: number;
+}
+export interface OverlayRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/**
+ * Position the overlay (absolute, inside the scroll container) over the image.
+ *
+ * The scroll container uses `scrollbar-gutter: stable both-edges`, which
+ * reserves an inline-start gutter that sits OUTSIDE the absolute-positioning
+ * origin. `getBoundingClientRect().left` is the border-box left (before the
+ * gutter), so `imageRect.left - parentRect.left` over-counts the left gutter
+ * and the frame lands shifted right by that width (issue #764). With
+ * `both-edges` the two gutters are equal, so the left gutter is half of the
+ * total reserved inline space (`offsetWidth - clientWidth`, no borders here).
+ * On overlay-scrollbar platforms (e.g. macOS) the reserved space is 0, so the
+ * correction is a no-op and behavior is unchanged.
+ */
+export declare function computeImageOverlayRect(i: OverlayRectInputs): OverlayRect;

package/dist/composables/imageOverlayRect.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/composables/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @heyirisai/docx-editor-vue/composables
+ *
+ * Vue composables mirroring the React `hooks` subpath — history, table
+ * selection, find/replace, autosave, clipboard, zoom, and the high-level
+ * `useDocxEditor` host composable.
+ *
+ * @example
+ * ```ts
+ * import { useAutoSave, useFindReplace } from '@heyirisai/docx-editor-vue/composables';
+ * ```
+ *
+ * @packageDocumentation
+ * @public
+ */
+export * from './useAutoSave';
+export * from './useClipboard';
+export * from './useCommentSidebarItems';
+export * from './useDocxEditor';
+export * from './useDragAutoScroll';
+export * from './useFindReplace';
+export * from './useFixedDropdown';
+export * from './useHistory';
+export * from './useSelectionHighlight';
+export * from './useTableResize';
+export * from './useTableSelection';
+export * from './useTrackedChanges';
+export * from './useVisualLineNavigation';
+export * from './useWheelZoom';
+export * from './useZoom';

package/dist/composables/useAutoSave.d.ts

@@ -0,0 +1,40 @@
+import { MaybeRef, Ref } from 'vue';
+import { formatLastSaveTime, getAutoSaveStatusLabel, getAutoSaveStorageSize, formatStorageSize, isAutoSaveSupported } from '@heyirisai/docx-editor-core';
+import { AutoSaveStatus, SavedDocumentData } from '@heyirisai/docx-editor-core/managers/types';
+import { Document } from '@heyirisai/docx-editor-core/types/document';
+export type { AutoSaveStatus, SavedDocumentData };
+export { formatLastSaveTime, getAutoSaveStatusLabel, getAutoSaveStorageSize, formatStorageSize, isAutoSaveSupported, };
+export interface UseAutoSaveOptions {
+    /** localStorage key (default: 'docx-editor-autosave') */
+    storageKey?: string;
+    /** Auto-save interval in ms (default: 30000) */
+    interval?: number;
+    /** Whether auto-save starts enabled (default: true). */
+    enabled?: boolean;
+    /** Maximum age of auto-save before it is considered stale. */
+    maxAge?: number;
+    /** Callback when save succeeds. */
+    onSave?: (timestamp: Date) => void;
+    /** Callback when save fails. */
+    onError?: (error: Error) => void;
+    /** Callback when recovery data is found. */
+    onRecoveryAvailable?: (savedDocument: SavedDocumentData) => void;
+    /** Whether document changes trigger a debounced save. */
+    saveOnChange?: boolean;
+    /** Debounce delay for saveOnChange in milliseconds. */
+    debounceDelay?: number;
+}
+export interface UseAutoSaveReturn {
+    status: Ref<AutoSaveStatus>;
+    lastSaveTime: Ref<Date | null>;
+    save: () => Promise<boolean>;
+    clearAutoSave: () => void;
+    hasRecoveryData: Ref<boolean>;
+    getRecoveryData: () => SavedDocumentData | null;
+    acceptRecovery: () => Document | null;
+    dismissRecovery: () => void;
+    isEnabled: Ref<boolean>;
+    enable: () => void;
+    disable: () => void;
+}
+export declare function useAutoSave(document: MaybeRef<Document | null | undefined>, options?: UseAutoSaveOptions): UseAutoSaveReturn;

package/dist/composables/useClipboard.d.ts

@@ -0,0 +1,22 @@
+import { Ref } from 'vue';
+import { runsToClipboardContent, ParsedClipboardContent } from '@heyirisai/docx-editor-core/utils';
+import { getSelectionRuns, createSelectionFromDOM, ClipboardSelection, Theme } from '@heyirisai/docx-editor-core';
+export { getSelectionRuns, createSelectionFromDOM, runsToClipboardContent };
+export type { ClipboardSelection };
+export interface UseClipboardOptions {
+    onCopy?: (selection: ClipboardSelection) => void;
+    onCut?: (selection: ClipboardSelection) => void;
+    onPaste?: (content: ParsedClipboardContent, asPlainText: boolean) => void;
+    cleanWordFormatting?: boolean;
+    editable?: boolean;
+    onError?: (error: Error) => void;
+    theme?: Theme | null;
+}
+export interface UseClipboardReturn {
+    copy: (selection: ClipboardSelection) => Promise<boolean>;
+    cut: (selection: ClipboardSelection) => Promise<boolean>;
+    paste: (asPlainText?: boolean) => Promise<ParsedClipboardContent | null>;
+    isProcessing: Ref<boolean>;
+    lastPastedContent: Ref<ParsedClipboardContent | null>;
+}
+export declare function useClipboard(options?: UseClipboardOptions): UseClipboardReturn;

package/dist/composables/useColorMode.d.ts

@@ -0,0 +1,8 @@
+import { ComputedRef } from 'vue';
+import { ColorMode } from '@heyirisai/docx-editor-core/utils';
+/**
+ * Resolve the effective dark flag from a reactive `colorMode`. `'system'`
+ * follows the OS via `subscribeSystemDark` (SSR-safe; re-syncs on entry).
+ * Mirrors the React adapter's inline colorMode logic via the shared core helpers.
+ */
+export declare function useColorMode(colorMode: () => ColorMode): ComputedRef<boolean>;

package/dist/composables/useCommentLifecycle.d.ts

@@ -0,0 +1,62 @@
+import { MaybeRef, Ref } from 'vue';
+import { EditorView } from 'prosemirror-view';
+import { Document } from '@heyirisai/docx-editor-core/types/document';
+import { Comment } from '@heyirisai/docx-editor-core/types/content';
+import { CommentIdAllocator } from '@heyirisai/docx-editor-core/prosemirror/commentIdAllocator';
+import { TrackedChangeEntry } from '../components/sidebar/sidebarUtils';
+import { CommentCallbacks } from './useCommentManagement';
+export interface UseCommentLifecycleOptions {
+    editorView: Ref<EditorView | null>;
+    getDocument: () => Document | null;
+    comments: Ref<Comment[]>;
+    trackedChanges: Ref<TrackedChangeEntry[]>;
+    resolvedCommentIds: Ref<Set<number>>;
+    /** Shared per-instance ID allocator (see useCommentManagement). */
+    commentIdAllocator: CommentIdAllocator;
+    activeSidebarItem: Ref<string | null>;
+    showSidebar: Ref<boolean>;
+    isAddingComment: Ref<boolean>;
+    readOnly: Ref<boolean>;
+    zoom: Ref<number>;
+    stateTick: Ref<number>;
+    pagesRef: Ref<HTMLElement | null>;
+    pagesViewportRef: Ref<HTMLElement | null>;
+    emit: (event: string, ...args: unknown[]) => void;
+    /** Author name for UI-created comments (the `author` prop). */
+    author?: MaybeRef<string>;
+    /** Host-facing comment lifecycle callbacks (the `onComment*` props). */
+    commentCallbacks?: CommentCallbacks;
+    /** Get all active header/footer ProseMirror EditorViews. */
+    getHfPmViews?: () => Map<string, EditorView>;
+}
+export declare function useCommentLifecycle(opts: UseCommentLifecycleOptions): {
+    floatingCommentBtn: Ref<{
+        top: number;
+        left: number;
+    } | null, {
+        top: number;
+        left: number;
+    } | {
+        top: number;
+        left: number;
+    } | null>;
+    pendingCommentRange: Ref<{
+        from: number;
+        to: number;
+    } | null, {
+        from: number;
+        to: number;
+    } | {
+        from: number;
+        to: number;
+    } | null>;
+    addCommentYPosition: Ref<number | null, number | null>;
+    sidebarAutoOpenedRef: Ref<boolean, boolean>;
+    extractCommentsAndChanges: () => void;
+    handleAddComment: (text: string) => void;
+    handleCancelAddComment: () => void;
+    handleStartAddComment: () => void;
+    handleMarkerClick: (_commentId: number) => void;
+    recomputeFloatingCommentBtn: () => void;
+    recomputeActiveSidebarItem: () => void;
+};