@eigenpal/docx-editor-vue 0.0.0

package/dist/composables/useDocxEditor.d.ts

@@ -0,0 +1,56 @@
+import { MaybeRef, Ref, ShallowRef } from 'vue';
+import { EditorState, Plugin } from 'prosemirror-state';
+import { EditorView } from 'prosemirror-view';
+import { CommandMap } from '@eigenpal/docx-editor-core/prosemirror/extensions/types';
+import { Layout } from '@eigenpal/docx-editor-core/layout-engine/types';
+import { Document } from '@eigenpal/docx-editor-core/types/document';
+import { LayoutSelectionGate } from '@eigenpal/docx-editor-core/prosemirror';
+export interface UseDocxEditorOptions {
+    /** Container element for the hidden ProseMirror editor */
+    hiddenContainer: Ref<HTMLElement | null>;
+    /** Container element for the visible pages */
+    pagesContainer: Ref<HTMLElement | null>;
+    /** Whether the editor is read-only */
+    readOnly?: MaybeRef<boolean>;
+    /** Page gap in pixels */
+    pageGap?: number;
+    /** Callback on document change */
+    onChange?: (doc: Document) => void;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+    /** Callback on selection change */
+    onSelectionUpdate?: () => void;
+    /** External ProseMirror plugins supplied by the host app. */
+    externalPlugins?: Plugin[];
+    /** Coordinates layout updates with visible selection/decoration overlays. */
+    syncCoordinator?: LayoutSelectionGate;
+}
+export interface UseDocxEditorReturn {
+    /** ProseMirror editor view (hidden). */
+    editorView: ShallowRef<EditorView | null>;
+    /** Latest editor state. Updated on each transaction. */
+    editorState: ShallowRef<EditorState | null>;
+    /** True once the editor view has mounted and a document is loaded. */
+    isReady: Ref<boolean>;
+    /** Last parse error message, or null if the most recent load succeeded. */
+    parseError: Ref<string | null>;
+    /** Computed page layout. */
+    layout: ShallowRef<Layout | null>;
+    /** Load a DOCX from a binary buffer. */
+    loadBuffer: (buffer: ArrayBuffer | Uint8Array | Blob | File) => Promise<void>;
+    /** Load a parsed `Document` directly. */
+    loadDocument: (doc: Document) => void;
+    /** Serialize the current document to a DOCX blob. */
+    save: () => Promise<Blob | null>;
+    /** Focus the hidden ProseMirror view. */
+    focus: () => void;
+    /** Destroy the editor view and clean up listeners. */
+    destroy: () => void;
+    /** Snapshot the current document model. */
+    getDocument: () => Document | null;
+    /** Access the extension command map for invoking marks/nodes/features. */
+    getCommands: () => CommandMap;
+    /** Force a re-layout without a doc change (e.g. after page-setup changes). */
+    reLayout: () => void;
+}
+export declare function useDocxEditor(options: UseDocxEditorOptions): UseDocxEditorReturn;

package/dist/composables/useDocxEditorRefApi.d.ts

@@ -0,0 +1,49 @@
+import { Ref, ShallowRef } from 'vue';
+import { EditorView } from 'prosemirror-view';
+import { Document } from '@eigenpal/docx-editor-core/types/document';
+import { Comment } from '@eigenpal/docx-editor-core/types/content';
+import { DocxInput } from '@eigenpal/docx-editor-core/utils';
+import { Layout } from '@eigenpal/docx-editor-core/layout-engine';
+import { DocxEditorRef } from '../components/DocxEditor/types';
+import { ApplyFormattingOptions } from './useFormattingActions';
+export interface UseDocxEditorRefApiOptions {
+    editorView: Ref<EditorView | null>;
+    layout: Ref<Layout | null>;
+    pagesRef: Ref<HTMLElement | null>;
+    pagesViewportRef: Ref<HTMLElement | null>;
+    zoom: Ref<number>;
+    comments: ShallowRef<Comment[]>;
+    focus: () => void;
+    destroy: () => void;
+    getDocument: () => Document | null;
+    setZoom: (zoom: number) => void;
+    save: () => Promise<ArrayBuffer | null>;
+    loadDocument: (doc: Document) => void;
+    loadDocumentBuffer: (buffer: DocxInput) => Promise<void>;
+    addComment: (options: {
+        paraId: string;
+        text: string;
+        author: string;
+        search?: string;
+    }) => number | null;
+    replyToComment: (commentId: number, text: string, author: string) => number | null;
+    resolveComment: (commentId: number) => void;
+    proposeChange: (options: {
+        paraId: string;
+        search: string;
+        replaceWith: string;
+        author: string;
+    }) => boolean;
+    applyFormatting: (options: ApplyFormattingOptions) => boolean;
+    setParagraphStyle: (options: {
+        paraId: string;
+        styleId: string;
+    }) => boolean;
+    scrollVisiblePositionIntoView: (pmPos: number) => void;
+    contentChangeSubscribers: Set<(document: unknown) => void>;
+    selectionChangeSubscribers: Set<(selection: unknown) => void>;
+    onPrint?: () => void;
+}
+export declare function useDocxEditorRefApi(opts: UseDocxEditorRefApiOptions): {
+    exposed: DocxEditorRef;
+};

package/dist/composables/useDragAutoScroll.d.ts

@@ -0,0 +1,11 @@
+import { Ref } from 'vue';
+export interface DragAutoScrollOptions {
+    pagesContainer: Ref<HTMLElement | null>;
+    /** Called during auto-scroll to extend the selection at the current mouse position. */
+    onScrollExtendSelection: (clientX: number, clientY: number) => void;
+}
+export interface UseDragAutoScrollReturn {
+    updateMousePosition: (clientX: number, clientY: number) => void;
+    stopAutoScroll: () => void;
+}
+export declare function useDragAutoScroll({ pagesContainer, onScrollExtendSelection, }: DragAutoScrollOptions): UseDragAutoScrollReturn;

package/dist/composables/useFileIO.d.ts

@@ -0,0 +1,30 @@
+import { Document } from '@eigenpal/docx-editor-core/types/document';
+export interface UseFileIOOptions {
+    /** From useDocxEditor — loads a .docx buffer into the editor. */
+    loadBuffer: (buffer: ArrayBuffer | Uint8Array | Blob | File) => Promise<void>;
+    /** From useDocxEditor — loads an already-parsed Document model. */
+    loadParsedDocument: (doc: Document) => void;
+    /** From useDocxEditor — returns the current Document, or null. */
+    getDocument: () => Document | null;
+    /** From useDocxEditor — serializes the current state to a .docx Blob. */
+    saveBlob: () => Promise<Blob | null>;
+    /** Fired after load+extract so the next tick sees comments/tracked-changes. */
+    extractCommentsAndChanges: () => void;
+    /** SFC's emit function — re-emits ready / rename / update:document / error. */
+    emit: (event: string, ...args: unknown[]) => void;
+    /** Accessor — read freshly inside the handler so prop updates are honored. */
+    documentName: () => string | undefined;
+    onDocumentNameChange?: (name: string) => void;
+    /** Vue's `nextTick` — passed in so the composable doesn't require its own import wiring. */
+    nextTick: () => Promise<void>;
+}
+export declare function useFileIO(opts: UseFileIOOptions): {
+    docxInputRef: import('vue').Ref<HTMLInputElement | null, HTMLInputElement | null>;
+    handleDocxFileChange: (event: Event) => Promise<void>;
+    handleDocumentNameChange: (name: string) => void;
+    downloadCurrentDocument: () => Promise<void>;
+    emitReadyAfterSidebarStateRefresh: () => Promise<void>;
+    loadDocumentBuffer: (buffer: Parameters<typeof opts.loadBuffer>[0]) => Promise<void>;
+    loadDocument: (doc: Document) => void;
+    save: () => Promise<ArrayBuffer | null>;
+};

package/dist/composables/useFindReplace.d.ts

@@ -0,0 +1,34 @@
+import { ComputedRef } from 'vue';
+import { FindMatch, FindOptions } from '@eigenpal/docx-editor-core/utils/findReplace';
+export type { FindMatch, FindOptions };
+export interface FindReplaceOptions {
+    initialReplaceMode?: boolean;
+    onMatchesChange?: (matches: FindMatch[]) => void;
+    onCurrentMatchChange?: (match: FindMatch | null, index: number) => void;
+}
+export interface FindReplaceState {
+    isOpen: boolean;
+    searchText: string;
+    replaceText: string;
+    options: FindOptions;
+    matches: FindMatch[];
+    currentIndex: number;
+    replaceMode: boolean;
+}
+export interface UseFindReplaceReturn {
+    state: FindReplaceState;
+    currentMatch: ComputedRef<FindMatch | null>;
+    hasMatches: ComputedRef<boolean>;
+    openFind: (selectedText?: string) => void;
+    openReplace: (selectedText?: string) => void;
+    close: () => void;
+    toggle: () => void;
+    setSearchText: (text: string) => void;
+    setReplaceText: (text: string) => void;
+    setOptions: (opts: Partial<FindOptions>) => void;
+    setMatches: (matches: FindMatch[], currentIndex?: number) => void;
+    goToNextMatch: () => number;
+    goToPreviousMatch: () => number;
+    goToMatch: (index: number) => void;
+}
+export declare function useFindReplace(hookOptions?: FindReplaceOptions): UseFindReplaceReturn;

package/dist/composables/useFixedDropdown.d.ts

@@ -0,0 +1,14 @@
+import { Ref, CSSProperties } from 'vue';
+export interface UseFixedDropdownOptions {
+    isOpen: Ref<boolean>;
+    onClose: () => void;
+    /** 'left' aligns dropdown left edge to trigger, 'right' aligns right edge. */
+    align?: 'left' | 'right';
+}
+export interface UseFixedDropdownReturn {
+    containerRef: Ref<HTMLElement | null>;
+    dropdownRef: Ref<HTMLElement | null>;
+    dropdownStyle: Ref<CSSProperties>;
+    handleMouseDown: (e: MouseEvent) => void;
+}
+export declare function useFixedDropdown({ isOpen, onClose, align, }: UseFixedDropdownOptions): UseFixedDropdownReturn;

package/dist/composables/useFormattingActions.d.ts

@@ -0,0 +1,40 @@
+import { Ref } from 'vue';
+import { EditorView } from 'prosemirror-view';
+import { Document } from '@eigenpal/docx-editor-core/types/document';
+export interface UseFormattingActionsOptions {
+    editorView: Ref<EditorView | null>;
+    getDocument: () => Document | null;
+}
+export interface ApplyFormattingOptions {
+    paraId: string;
+    search?: string;
+    marks: {
+        bold?: boolean;
+        italic?: boolean;
+        underline?: boolean | {
+            style?: string;
+        };
+        strike?: boolean;
+        color?: {
+            rgb?: string;
+            themeColor?: string;
+        };
+        highlight?: string;
+        fontSize?: number;
+        fontFamily?: {
+            ascii?: string;
+            hAnsi?: string;
+        };
+    };
+}
+export declare function useFormattingActions(opts: UseFormattingActionsOptions): {
+    handleClearFormatting: () => void;
+    handleApplyStyle: (styleId: string) => void;
+    handleInsertPageBreak: () => void;
+    handleInsertSymbol: (symbol: string) => void;
+    applyFormatting: (options: ApplyFormattingOptions) => boolean;
+    setParagraphStyle: (options: {
+        paraId: string;
+        styleId: string;
+    }) => boolean;
+};

package/dist/composables/useHistory.d.ts

@@ -0,0 +1,9 @@
+import { ComputedRef, Ref } from 'vue';
+import { EditorView } from 'prosemirror-view';
+export interface UseHistoryReturn {
+    canUndo: ComputedRef<boolean>;
+    canRedo: ComputedRef<boolean>;
+    undo: () => boolean;
+    redo: () => boolean;
+}
+export declare function useHistory(view: Ref<EditorView | null>, stateTick: Ref<number>): UseHistoryReturn;

package/dist/composables/useHyperlinkManagement.d.ts

@@ -0,0 +1,38 @@
+import { Ref } from 'vue';
+import { EditorView } from 'prosemirror-view';
+import { HyperlinkPopupData } from '../components/ui/hyperlinkPopupTypes';
+export type { HyperlinkPopupData };
+type Commands = Record<string, (...args: unknown[]) => unknown>;
+export interface UseHyperlinkManagementOptions {
+    editorView: Ref<EditorView | null>;
+    getCommands: () => Commands;
+}
+export declare function useHyperlinkManagement(opts: UseHyperlinkManagementOptions): {
+    hyperlinkPopupData: Ref<{
+        href: string;
+        displayText: string;
+        tooltip?: string | undefined;
+        position: {
+            top: number;
+            left: number;
+        };
+    } | null, HyperlinkPopupData | {
+        href: string;
+        displayText: string;
+        tooltip?: string | undefined;
+        position: {
+            top: number;
+            left: number;
+        };
+    } | null>;
+    handleHyperlinkSubmit: (data: {
+        url?: string;
+        bookmark?: string;
+        displayText: string;
+        tooltip: string;
+    }) => void;
+    handleHyperlinkRemove: () => void;
+    handleHyperlinkPopupNavigate: (href: string) => void;
+    handleHyperlinkPopupEdit: (displayText: string, href: string) => void;
+    handleHyperlinkPopupRemove: () => void;
+};

package/dist/composables/useImageActions.d.ts

@@ -0,0 +1,30 @@
+import { Ref } from 'vue';
+import { EditorView } from 'prosemirror-view';
+import { ImageSelectionInfo } from '../components/imageSelectionTypes';
+type Commands = Record<string, ((...args: unknown[]) => unknown) | undefined>;
+export interface UseImageActionsOptions {
+    editorView: Ref<EditorView | null>;
+    zoom: Ref<number>;
+    stateTick: Ref<number>;
+    getCommands: () => Commands;
+}
+export interface ImageToolbarContext {
+    wrapType: string;
+    displayMode: string;
+    cssFloat: string | null;
+}
+export interface UseImageActionsReturn {
+    selectedImage: import('vue').ShallowRef<ImageSelectionInfo | null>;
+    imageInteracting: import('vue').Ref<boolean>;
+    imageToolbarContext: import('vue').ComputedRef<ImageToolbarContext | null>;
+    handleInsertImage: (data: {
+        src: string;
+        width: number;
+        height: number;
+        alt: string;
+    }) => void;
+    handleToolbarImageWrap: (value: string) => void;
+    handleImageTransform: (action: 'rotateCW' | 'rotateCCW' | 'flipH' | 'flipV') => void;
+}
+export declare function useImageActions(opts: UseImageActionsOptions): UseImageActionsReturn;
+export {};

package/dist/composables/useKeyboardShortcuts.d.ts

@@ -0,0 +1,17 @@
+import { Ref } from 'vue';
+export interface UseKeyboardShortcutsOptions {
+    showKeyboardShortcuts: Ref<boolean>;
+    showFindReplace: Ref<boolean>;
+    showHyperlink: Ref<boolean>;
+    /** From useZoom — handles Ctrl+= / Ctrl+- / Ctrl+0. */
+    handleZoomKeyDown: (e: KeyboardEvent) => void;
+    /**
+     * Host prop accessor — read freshly inside the handler so a host
+     * toggle at runtime is honored. (Capturing the prop value at setup
+     * time would freeze it.)
+     */
+    disableFindReplaceShortcuts?: () => boolean | undefined;
+}
+export declare function useKeyboardShortcuts(opts: UseKeyboardShortcutsOptions): {
+    handleKeyDown: (e: KeyboardEvent) => void;
+};

package/dist/composables/useMenuActions.d.ts

@@ -0,0 +1,23 @@
+import { Ref } from 'vue';
+import { EditorView } from 'prosemirror-view';
+export interface UseMenuActionsOptions {
+    editorView: Ref<EditorView | null>;
+    getCommands: () => Record<string, (...args: any[]) => any>;
+    docxInputRef: Ref<HTMLInputElement | null>;
+    showPageSetup: Ref<boolean>;
+    showInsertImage: Ref<boolean>;
+    showHyperlink: Ref<boolean>;
+    showInsertSymbol: Ref<boolean>;
+    showKeyboardShortcuts: Ref<boolean>;
+    handleClearFormatting: () => void;
+    handleInsertPageBreak: () => void;
+    handleToggleOutline: () => void;
+    handleToggleSidebar: () => void;
+    downloadCurrentDocument: () => Promise<void>;
+    emit: (event: string, ...args: unknown[]) => void;
+}
+export declare function useMenuActions(opts: UseMenuActionsOptions): {
+    handleMenuAction: (action: string) => void;
+    handleMenuTableInsert: (rows: number, cols: number) => void;
+    execSimpleCommand: (name: string) => void;
+};

package/dist/composables/useOutlineSidebar.d.ts

@@ -0,0 +1,17 @@
+import { Ref } from 'vue';
+import { EditorView } from 'prosemirror-view';
+import { HeadingInfo } from '@eigenpal/docx-editor-core/utils/headingCollector';
+export interface UseOutlineSidebarOptions {
+    editorView: Ref<EditorView | null>;
+    showOutline: Ref<boolean>;
+    showSidebar: Ref<boolean>;
+    outlineHeadings: Ref<HeadingInfo[]>;
+    activeSidebarItem: Ref<string | null>;
+    extractCommentsAndChanges: () => void;
+}
+export declare function useOutlineSidebar(opts: UseOutlineSidebarOptions): {
+    handleToggleOutline: () => void;
+    handleOutlineNavigate: (pmPos: number) => void;
+    handleToggleSidebar: () => void;
+    handleEditorScrollMouseDown: (event: MouseEvent) => void;
+};

package/dist/composables/usePageSetupControls.d.ts

@@ -0,0 +1,22 @@
+import { Ref } from 'vue';
+import { EditorView } from 'prosemirror-view';
+import { Document, SectionProperties } from '@eigenpal/docx-editor-core/types/document';
+export interface UsePageSetupControlsOptions {
+    editorView: Ref<EditorView | null>;
+    getDocument: () => Document | null;
+    readOnly: Ref<boolean>;
+    stateTick: Ref<number>;
+    reLayout: () => void;
+    emit: (event: string, ...args: unknown[]) => void;
+}
+export declare function usePageSetupControls(opts: UsePageSetupControlsOptions): {
+    handlePageSetupApply: (sp: Partial<SectionProperties>) => void;
+    handleLeftMarginChange: (twips: number) => void;
+    handleRightMarginChange: (twips: number) => void;
+    handleTopMarginChange: (twips: number) => void;
+    handleBottomMarginChange: (twips: number) => void;
+    handleIndentLeftChange: (twips: number) => void;
+    handleIndentRightChange: (twips: number) => void;
+    handleFirstLineIndentChange: (twips: number) => void;
+    handleTabStopRemove: (positionTwips: number) => void;
+};

package/dist/composables/usePagesPointer.d.ts

@@ -0,0 +1,70 @@
+import { Ref, ShallowRef } from 'vue';
+import { EditorView } from 'prosemirror-view';
+import { HeaderFooter, Paragraph, Table } from '@eigenpal/docx-editor-core/types/content';
+import { Document } from '@eigenpal/docx-editor-core/types/document';
+import { ImageSelectionInfo } from '../components/imageSelectionTypes';
+import { Layout } from '@eigenpal/docx-editor-core/layout-engine';
+import { HyperlinkPopupData } from '../components/ui/hyperlinkPopupTypes';
+type TableResizeApi = {
+    tryStartResize: (e: MouseEvent, view: EditorView) => boolean;
+    isResizing: Ref<boolean>;
+};
+type Commands = Record<string, ((...args: unknown[]) => unknown) | undefined>;
+export interface TableInsertButton {
+    type: 'row' | 'column';
+    x: number;
+    y: number;
+    cellPmPos: number;
+}
+export interface HfEditState {
+    position: 'header' | 'footer';
+    rId: string | null;
+    headerFooter: HeaderFooter | null;
+    targetRect: {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+    } | null;
+}
+export interface ScrollPageInfo {
+    currentPage: number;
+    totalPages: number;
+    visible: boolean;
+}
+export interface UsePagesPointerOptions {
+    editorView: Ref<EditorView | null>;
+    pagesRef: Ref<HTMLElement | null>;
+    pagesViewportRef: Ref<HTMLElement | null>;
+    selectedImage: ShallowRef<ImageSelectionInfo | null>;
+    imageInteracting: Ref<boolean>;
+    hyperlinkPopupData: Ref<HyperlinkPopupData | null>;
+    readOnly: Ref<boolean>;
+    zoom: Ref<number>;
+    layout: Ref<Layout | null>;
+    tableResize: TableResizeApi;
+    getCommands: () => Commands;
+    getDocument: () => Document | null;
+    reLayout: () => void;
+    emit: (event: string, ...args: unknown[]) => void;
+    clearOverlay: () => void;
+}
+export interface UsePagesPointerReturn {
+    tableInsertButton: Ref<TableInsertButton | null>;
+    hfEdit: Ref<HfEditState | null>;
+    scrollPageInfo: Ref<ScrollPageInfo>;
+    resolvePos: (clientX: number, clientY: number) => number | null;
+    setPmSelection: (anchor: number, head?: number) => void;
+    scrollVisiblePositionIntoView: (pmPos: number) => void;
+    navigateToBookmark: (bookmarkName: string) => void;
+    handlePagesMouseDown: (event: MouseEvent) => void;
+    handlePagesMouseMove: (event: MouseEvent) => void;
+    handlePagesClick: (event: MouseEvent) => void;
+    handlePagesDoubleClick: (event: MouseEvent) => void;
+    handleTableInsertClick: (event: MouseEvent) => void;
+    clearTableInsertTimer: () => void;
+    handleHfSave: (content: (Paragraph | Table)[]) => void;
+    handleHfRemove: () => void;
+}
+export declare function usePagesPointer(opts: UsePagesPointerOptions): UsePagesPointerReturn;
+export {};

package/dist/composables/useSelectionHighlight.d.ts

@@ -0,0 +1,19 @@
+import { Ref, ComputedRef, CSSProperties } from 'vue';
+import { HighlightRect, SelectionHighlightConfig } from '@eigenpal/docx-editor-core/utils';
+export interface UseSelectionHighlightOptions {
+    containerRef: Ref<HTMLElement | null>;
+    enabled?: boolean;
+    config?: SelectionHighlightConfig;
+    useOverlay?: boolean;
+    debounceMs?: number;
+    onSelectionChange?: (hasSelection: boolean, text: string) => void;
+}
+export interface UseSelectionHighlightReturn {
+    hasSelection: ComputedRef<boolean>;
+    selectedText: ComputedRef<string>;
+    highlightRects: ComputedRef<HighlightRect[]>;
+    isSelectionInContainer: ComputedRef<boolean>;
+    refresh: () => void;
+    getOverlayStyle: (rect: HighlightRect) => CSSProperties;
+}
+export declare function useSelectionHighlight(options: UseSelectionHighlightOptions): UseSelectionHighlightReturn;

package/dist/composables/useSelectionSync.d.ts

@@ -0,0 +1,13 @@
+import { Ref, ShallowRef } from 'vue';
+import { EditorView } from 'prosemirror-view';
+import { ImageSelectionInfo } from '../components/imageSelectionTypes';
+export interface UseSelectionSyncOptions {
+    editorView: Ref<EditorView | null>;
+    pagesRef: Ref<HTMLElement | null>;
+    selectedImage: ShallowRef<ImageSelectionInfo | null>;
+}
+export interface UseSelectionSyncReturn {
+    clearOverlay: () => void;
+    updateSelectionOverlay: () => void;
+}
+export declare function useSelectionSync(opts: UseSelectionSyncOptions): UseSelectionSyncReturn;

package/dist/composables/useTableResize.d.ts

@@ -0,0 +1,7 @@
+import { EditorView } from 'prosemirror-view';
+export interface UseTableResizeReturn {
+    tryStartResize: (e: MouseEvent, view: EditorView) => boolean;
+    install: () => () => void;
+    isResizing: () => boolean;
+}
+export declare function useTableResize(): UseTableResizeReturn;

package/dist/composables/useTableSelection.d.ts

@@ -0,0 +1,10 @@
+import { Ref } from 'vue';
+import { CellCoordinates } from '@eigenpal/docx-editor-core/managers/types';
+export interface UseTableSelectionReturn {
+    selectedCell: Ref<CellCoordinates | null>;
+    handleCellClick: (tableIndex: number, rowIndex: number, columnIndex: number) => void;
+    handleClickTarget: (target: EventTarget | null, container?: HTMLElement | null) => void;
+    clearSelection: () => void;
+    isCellSelected: (tableIndex: number, rowIndex: number, columnIndex: number) => boolean;
+}
+export declare function useTableSelection(): UseTableSelectionReturn;

package/dist/composables/useToolbarDropdowns.d.ts

@@ -0,0 +1,14 @@
+import { Ref, CSSProperties } from 'vue';
+export interface UseToolbarDropdownsOptions {
+    zoom: Ref<HTMLElement | null>;
+    style: Ref<HTMLElement | null>;
+    font: Ref<HTMLElement | null>;
+    size: Ref<HTMLElement | null>;
+    align: Ref<HTMLElement | null>;
+    spacing: Ref<HTMLElement | null>;
+}
+export declare function useToolbarDropdowns(refs: UseToolbarDropdownsOptions): {
+    openDropdown: Ref<string | null, string | null>;
+    dropdownMenuStyle: import('vue').ComputedRef<CSSProperties>;
+    toggleDropdown: (name: string) => void;
+};

package/dist/composables/useTrackedChanges.d.ts

@@ -0,0 +1,12 @@
+import { Ref } from 'vue';
+import { EditorView } from 'prosemirror-view';
+import { extractTrackedChanges, TrackedChangesResult } from '@eigenpal/docx-editor-core/prosemirror/utils/extractTrackedChanges';
+export type { TrackedChangesResult };
+export { extractTrackedChanges };
+export type { TrackedChangeEntry } from '@eigenpal/docx-editor-core/utils/comments';
+/**
+ * Pass the editor view ref + a stateTick that bumps on every PM
+ * transaction (the same tick the Toolbar listens to). The computed
+ * re-runs whenever the tick advances.
+ */
+export declare function useTrackedChanges(view: Ref<EditorView | null>, stateTick: Ref<number>): import('vue').ComputedRef<TrackedChangesResult>;

package/dist/composables/useVisualLineNavigation.d.ts

@@ -0,0 +1,11 @@
+import { Ref } from 'vue';
+import { createVisualLineState } from '@eigenpal/docx-editor-core/prosemirror/utils/visualLineNavigation';
+import { EditorView } from 'prosemirror-view';
+export interface UseVisualLineNavigationReturn {
+    state: ReturnType<typeof createVisualLineState>;
+    getCaretClientX: (pmPos: number) => number | null;
+    findLineElementAtPosition: (pmPos: number) => HTMLElement | null;
+    findPositionOnLineAtClientX: (line: HTMLElement, clientX: number) => number | null;
+    handlePMKeyDown: (view: EditorView, event: KeyboardEvent) => boolean;
+}
+export declare function useVisualLineNavigation(pagesContainer: Ref<HTMLElement | null>): UseVisualLineNavigationReturn;

package/dist/composables/useWheelZoom.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Alias for cross-adapter parity — the React adapter has
+ * `useWheelZoom.ts` (Ctrl+wheel zoom + Ctrl+= / Ctrl+- / Ctrl+0
+ * shortcuts). Vue rolls the same behaviour into `useZoom`, which
+ * already exposes `handleWheel` and `installShortcuts()`. This file
+ * re-exports under the React-style name so plugin code can call
+ * `useWheelZoom()` either way and get the same composable.
+ */
+export { useZoom as useWheelZoom } from './useZoom';
+export type {} from './useZoom';

package/dist/composables/useZoom.d.ts

@@ -0,0 +1,16 @@
+import { Ref, ComputedRef } from 'vue';
+export interface UseZoomReturn {
+    zoom: Ref<number>;
+    zoomPercent: ComputedRef<number>;
+    isMinZoom: ComputedRef<boolean>;
+    isMaxZoom: ComputedRef<boolean>;
+    setZoom: (level: number) => void;
+    zoomIn: () => void;
+    zoomOut: () => void;
+    resetZoom: () => void;
+    handleWheel: (e: WheelEvent) => void;
+    handleKeyDown: (e: KeyboardEvent) => void;
+    installShortcuts: () => void;
+    ZOOM_PRESETS: number[];
+}
+export declare function useZoom(initialZoom?: number): UseZoomReturn;

package/dist/composables.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./useTableResize-lWdIgX9x.cjs`);let t=require(`vue`),n=require(`prosemirror-history`),r=require(`@eigenpal/docx-editor-core/utils`),i=require(`@eigenpal/docx-editor-core/prosemirror/utils/extractTrackedChanges`),a=require(`@eigenpal/docx-editor-core`),o=require(`@eigenpal/docx-editor-core/utils/findVerticalScrollParent`),s=require(`@eigenpal/docx-editor-core/utils/findReplace`),c=require(`@eigenpal/docx-editor-core/managers/TableSelectionManager`),l=require(`@eigenpal/docx-editor-core/prosemirror/utils/visualLineNavigation`);function u(e,n={}){let r=(0,t.ref)(`idle`),i=(0,t.ref)(null),o=(0,t.ref)(!1),s=(0,t.ref)(!0),{storageKey:c,interval:l,enabled:u=!0,maxAge:d,onSave:f,onError:p,onRecoveryAvailable:m,saveOnChange:h,debounceDelay:g}=n;if(!(0,a.isAutoSaveSupported)())return{status:r,lastSaveTime:i,hasRecoveryData:o,isEnabled:s,save:async()=>!1,clearAutoSave:()=>{},getRecoveryData:()=>null,acceptRecovery:()=>null,dismissRecovery:()=>{},enable:()=>{},disable:()=>{}};let _=new a.AutoSaveManager({storageKey:c,interval:l,maxAge:d,saveOnChange:h,debounceDelay:g,onSave:f,onError:p,onRecoveryAvailable:m}),v=()=>{let e=_.getSnapshot();r.value=e.status,i.value=e.lastSaveTime,o.value=e.hasRecoveryData,s.value=e.isEnabled},y=_.subscribe(v);u?_.enable():_.disable(),v(),(0,t.watch)(()=>(0,t.unref)(e),e=>_.onDocumentChanged(e??null),{immediate:!0});function b(){return _.save()}function x(){_.clear()}function S(){return _.getRecoveryData()}function C(){return _.acceptRecovery()}function w(){_.dismissRecovery()}function T(){_.enable()}function E(){_.disable()}return(0,t.onBeforeUnmount)(()=>{y(),_.destroy()}),{status:r,lastSaveTime:i,hasRecoveryData:o,isEnabled:s,save:b,clearAutoSave:x,getRecoveryData:S,acceptRecovery:C,dismissRecovery:w,enable:T,disable:E}}function d(e={}){let{onCopy:n,onCut:i,onPaste:a,cleanWordFormatting:o=!0,editable:s=!0,onError:c,theme:l}=e,u=(0,t.ref)(!1),d=(0,t.ref)(null);async function f(e){if(u.value)return!1;u.value=!0;try{let t=await(0,r.copyRuns)(e.runs,{onError:c,theme:l});return t&&n?.(e),t}finally{u.value=!1}}async function p(e){if(u.value||!s)return!1;u.value=!0;try{let t=await(0,r.copyRuns)(e.runs,{onError:c,theme:l});return t&&i?.(e),t}finally{u.value=!1}}async function m(e=!1){if(u.value||!s)return null;u.value=!0;try{if(navigator.clipboard&&navigator.clipboard.read){let t=await navigator.clipboard.read(),n=``,i=``;for(let e of t)e.types.includes(`text/html`)&&(n=await(await e.getType(`text/html`)).text()),e.types.includes(`text/plain`)&&(i=await(await e.getType(`text/plain`)).text());e&&(n=``);let s=(0,r.parseClipboardHtml)(n,i,o);return d.value=s,a?.(s,e),s}return null}catch(e){return c?.(e instanceof Error?e:Error(String(e))),null}finally{u.value=!1}}return{copy:f,cut:p,paste:m,isProcessing:u,lastPastedContent:d}}function f({comments:e,trackedChanges:n,showResolved:r,isAddingComment:i,addCommentYPosition:a}){return(0,t.computed)(()=>{let t=[];i?.value&&a?.value!=null&&t.push({id:`new-comment-input`,anchorPos:0,fixedY:a.value,priority:-1e3,isTemporary:!0,estimatedHeight:120,kind:`add-comment`});let o=new Map;for(let t of e.value)if(t.parentId!=null){let e=o.get(t.parentId);e?e.push(t):o.set(t.parentId,[t])}for(let n of e.value)n.parentId??(n.done&&!r?.value||t.push({id:`comment-${n.id}`,anchorPos:0,anchorKey:`comment-${n.id}`,priority:0,estimatedHeight:n.done?28:80,kind:`comment`,comment:n,replies:o.get(n.id)??[]}));return n.value.forEach((e,n)=>{t.push({id:`tc-${e.revisionId}-${n}`,anchorPos:e.from,anchorKey:`revision-${e.revisionId}`,priority:1,estimatedHeight:80,kind:`tracked-change`,change:e})}),t})}var p=40,m=12;function h({pagesContainer:e,onScrollExtendSelection:n}){let r=null,i=0,a=0,s=!1,c=null;function l(){if(c)return c;let t=e.value;return t?(c=(0,o.findVerticalScrollParent)(t),c):null}function u(){s=!1,r!==null&&(cancelAnimationFrame(r),r=null)}function d(){if(!s)return;let e=l();if(!e)return;let t=e.getBoundingClientRect(),o=0;if(a<t.top+p){let e=Math.max(0,t.top+p-a);o=-Math.min(m,e/p*m)}else if(a>t.bottom-p){let e=Math.max(0,a-(t.bottom-p));o=Math.min(m,e/p*m)}o!==0&&(e.scrollTop+=o,n(i,a)),r=requestAnimationFrame(d)}function f(){s||(s=!0,r=requestAnimationFrame(d))}function h(e,t){if(i=e,a=t,!s){let e=l();if(!e)return;let n=e.getBoundingClientRect();(t<n.top+p||t>n.bottom-p)&&f()}}return(0,t.onBeforeUnmount)(()=>u()),{updateMousePosition:h,stopAutoScroll:u}}function g(e={}){let n=(0,t.reactive)({isOpen:!1,searchText:``,replaceText:``,options:(0,s.createDefaultFindOptions)(),matches:[],currentIndex:0,replaceMode:e.initialReplaceMode??!1});function r(e){n.isOpen=!0,n.replaceMode=!1,e&&(n.searchText=e),n.matches=[],n.currentIndex=0}function i(e){n.isOpen=!0,n.replaceMode=!0,e&&(n.searchText=e),n.matches=[],n.currentIndex=0}function a(){n.isOpen=!1}function o(){n.isOpen=!n.isOpen}function c(e){n.searchText=e}function l(e){n.replaceText=e}function u(e){n.options={...n.options,...e}}function d(t,r=0){let i=Math.max(0,Math.min(r,t.length-1));n.matches=t,n.currentIndex=t.length>0?i:0,e.onMatchesChange?.(t),t.length>0?e.onCurrentMatchChange?.(t[i],i):e.onCurrentMatchChange?.(null,-1)}function f(){return n.matches.length===0?0:(n.currentIndex=(n.currentIndex+1)%n.matches.length,n.currentIndex)}function p(){return n.matches.length===0?0:(n.currentIndex=n.currentIndex===0?n.matches.length-1:n.currentIndex-1,n.currentIndex)}function m(e){n.matches.length===0||e<0||e>=n.matches.length||(n.currentIndex=e)}return{state:n,currentMatch:(0,t.computed)(()=>n.matches.length===0?null:n.matches[n.currentIndex]??null),hasMatches:(0,t.computed)(()=>n.matches.length>0),openFind:r,openReplace:i,close:a,toggle:o,setSearchText:c,setReplaceText:l,setOptions:u,setMatches:d,goToNextMatch:f,goToPreviousMatch:p,goToMatch:m}}function _({isOpen:e,onClose:n,align:r=`left`}){let i=(0,t.ref)(null),a=(0,t.ref)(null),o=(0,t.ref)({position:`fixed`,top:`0px`,left:`0px`,zIndex:1e4});function s(e,t){o.value={position:`fixed`,top:e+`px`,left:t+`px`,zIndex:1e4}}function c(e){let t=e.target;i.value&&!i.value.contains(t)&&a.value&&!a.value.contains(t)&&n()}function l(e){e.key===`Escape`&&n()}function u(){n()}function d(){document.addEventListener(`mousedown`,c),document.addEventListener(`keydown`,l),window.addEventListener(`scroll`,u,!0)}function f(){document.removeEventListener(`mousedown`,c),document.removeEventListener(`keydown`,l),window.removeEventListener(`scroll`,u,!0)}(0,t.watch)(e,e=>{if(!e){f();return}let t=i.value;if(!t)return;let n=t.getBoundingClientRect();r===`right`?requestAnimationFrame(()=>{let e=a.value;if(e){let t=e.getBoundingClientRect();s(n.bottom+4,n.right-t.width)}else s(n.bottom+4,n.left)}):s(n.bottom+4,n.left),d()}),(0,t.onBeforeUnmount)(f);function p(e){e.preventDefault(),e.stopPropagation()}return{containerRef:i,dropdownRef:a,dropdownStyle:o,handleMouseDown:p}}function v(e,r){let i=(0,t.computed)(()=>{r.value;let t=e.value;return t?(0,n.undoDepth)(t.state)>0:!1}),a=(0,t.computed)(()=>{r.value;let t=e.value;return t?(0,n.redoDepth)(t.state)>0:!1});function o(){let t=e.value;return t?(0,n.undo)(t.state,t.dispatch):!1}function s(){let t=e.value;return t?(0,n.redo)(t.state,t.dispatch):!1}return{canUndo:i,canRedo:a,undo:o,redo:s}}function y(e){let{containerRef:n,enabled:i=!0,config:a=r.DEFAULT_SELECTION_STYLE,useOverlay:o=!1,debounceMs:s=16,onSelectionChange:c}=e,l=(0,t.ref)(!1),u=(0,t.ref)(``),d=(0,t.ref)([]),f=(0,t.ref)(!1),p=null,m=0;function h(){let e=n.value,t=(0,r.hasActiveSelection)(),i=(0,r.getSelectedText)(),a=e?(0,r.isSelectionWithin)(e):!1;l.value=t,u.value=i,f.value=a,d.value=o&&a&&e?(0,r.getMergedSelectionRects)(e):[],c?.(t&&a,i)}function g(){h()}function _(){let e=performance.now();if(e-m<s){p&&clearTimeout(p),p=setTimeout(()=>{m=performance.now(),h(),p=null},s);return}m=e,h()}function v(e){return{position:`absolute`,left:e.left+`px`,top:e.top+`px`,width:e.width+`px`,height:e.height+`px`,backgroundColor:a.backgroundColor,borderRadius:a.borderRadius?a.borderRadius+`px`:void 0,border:a.borderColor?`1px solid ${a.borderColor}`:void 0,zIndex:a.zIndex??0,pointerEvents:`none`}}return(0,t.onMounted)(()=>{i&&((0,r.areSelectionStylesInjected)()||(0,r.injectSelectionStyles)(a),document.addEventListener(`selectionchange`,_))}),(0,t.onBeforeUnmount)(()=>{document.removeEventListener(`selectionchange`,_),p&&clearTimeout(p)}),(0,t.watch)(n,()=>h()),{hasSelection:(0,t.computed)(()=>l.value),selectedText:(0,t.computed)(()=>u.value),highlightRects:(0,t.computed)(()=>d.value),isSelectionInContainer:(0,t.computed)(()=>f.value),refresh:g,getOverlayStyle:v}}function b(){let e=new c.TableSelectionManager,n=(0,t.ref)(null),r=()=>{n.value=e.getSnapshot().selectedCell},i=e.subscribe(r);r(),(0,t.onBeforeUnmount)(()=>{i()});function a(t,n,r){e.selectCell({tableIndex:t,rowIndex:n,columnIndex:r})}function o(t,n){let r=(0,c.findTableFromClick)(t,n);r?e.selectCell(r):e.clearSelection()}function s(){e.clearSelection()}function l(t,n,r){return e.isCellSelected(t,n,r)}return{selectedCell:n,handleCellClick:a,handleClickTarget:o,clearSelection:s,isCellSelected:l}}function x(e,n){return(0,t.computed)(()=>(n.value,(0,i.extractTrackedChanges)(e.value?.state??null)))}function S(e){let t=(0,l.createVisualLineState)();function n(t){let n=e.value;return n?(0,l.getCaretClientX)(n,t):null}function r(t){let n=e.value;return n?(0,l.findLineElementAtPosition)(n,t):null}function i(e,t){return(0,l.findPositionOnLineAtClientX)(e,t)}function a(n,r){return(0,l.handleVisualLineKeyDown)(t,n,r,e.value)}return{state:t,getCaretClientX:n,findLineElementAtPosition:r,findPositionOnLineAtClientX:i,handlePMKeyDown:a}}exports.createSelectionFromDOM=a.createSelectionFromDOM,exports.extractTrackedChanges=i.extractTrackedChanges,exports.formatLastSaveTime=a.formatLastSaveTime,exports.formatStorageSize=a.formatStorageSize,exports.getAutoSaveStatusLabel=a.getAutoSaveStatusLabel,exports.getAutoSaveStorageSize=a.getAutoSaveStorageSize,exports.getSelectionRuns=a.getSelectionRuns,exports.isAutoSaveSupported=a.isAutoSaveSupported,exports.runsToClipboardContent=r.runsToClipboardContent,exports.useAutoSave=u,exports.useClipboard=d,exports.useCommentSidebarItems=f,exports.useDocxEditor=e.r,exports.useDragAutoScroll=h,exports.useFindReplace=g,exports.useFixedDropdown=_,exports.useHistory=v,exports.useSelectionHighlight=y,exports.useTableResize=e.t,exports.useTableSelection=b,exports.useTrackedChanges=x,exports.useVisualLineNavigation=S,exports.useWheelZoom=e.n,exports.useZoom=e.n;