@fileverse-dev/ddoc 3.1.7-linkCaption-1 → 3.1.8

package/dist/package/components/inline-comment/use-floating-layout-engine.d.ts

@@ -0,0 +1,26 @@
+import { RefObject } from 'react';
+import { Editor } from '@tiptap/react';
+import { CommentFloatingCard } from './context/types';
+import { UseAnchorRegistryResult } from './use-anchor-registry';
+import { UseFloatingCardStateResult } from './use-floating-card-state';
+
+interface UseFloatingLayoutEngineProps {
+    blurFloatingCard: (floatingCardId: string) => void;
+    closeFloatingCard: (floatingCardId: string) => void;
+    editor: Editor;
+    editorWrapperRef: RefObject<HTMLDivElement>;
+    floatingCardIdsKey: string;
+    floatingCards: CommentFloatingCard[];
+    focusedFloatingCardId: string | null;
+    isDesktopFloatingEnabled: boolean;
+    isHidden: boolean;
+    scrollContainerRef: RefObject<HTMLDivElement>;
+    anchorRegistry: UseAnchorRegistryResult;
+    floatingCardState: UseFloatingCardStateResult;
+}
+export interface UseFloatingLayoutEngineResult {
+    floatingCardListContainerRef: RefObject<HTMLDivElement>;
+    registerCardNode: (floatingCardId: string, node: HTMLDivElement | null) => void;
+}
+export declare const useFloatingLayoutEngine: ({ blurFloatingCard, closeFloatingCard, editor, editorWrapperRef, floatingCardIdsKey, floatingCards, focusedFloatingCardId, isDesktopFloatingEnabled, isHidden, scrollContainerRef, anchorRegistry, floatingCardState, }: UseFloatingLayoutEngineProps) => UseFloatingLayoutEngineResult;
+export {};

package/dist/package/components/inline-comment/use-is-selected-content-deleted.d.ts

@@ -0,0 +1 @@
+export declare function useIsSelectedContentDeleted(commentId: string | undefined, selectedContent: string | undefined, commentTabId: string | undefined): boolean;

package/dist/package/components/tabs/document-tabs-sidebar.d.ts

@@ -31,9 +31,10 @@ export interface DocumentTabsSidebarProps {
     tabConfig?: DocumentOutlineProps['tabConfig'];
     deleteTab?: (tabId: string) => void;
     isConnected?: boolean;
+    isFocusMode?: boolean;
 }
 export declare const DocumentTabsSidebar: ({ tabSectionContainer, ...rest }: DocumentTabsSidebarProps) => import("react/jsx-runtime").JSX.Element | null;
-export declare const TabSidebar: ({ tabs, activeTabId, setActiveTabId, showTOC, setShowTOC, hasToC, isPreviewMode, editor, items, setItems, orientation, createTab, renameTab, duplicateTab, orderTab, tabCommentCounts, isVersionHistoryMode, tabConfig, deleteTab, isConnected, }: DocumentTabsSidebarProps) => import("react/jsx-runtime").JSX.Element;
+export declare const TabSidebar: ({ tabs, activeTabId, setActiveTabId, showTOC, setShowTOC, hasToC, isPreviewMode, editor, items, setItems, orientation, createTab, renameTab, duplicateTab, orderTab, tabCommentCounts, isVersionHistoryMode, tabConfig, deleteTab, isConnected, isFocusMode, }: DocumentTabsSidebarProps) => import("react/jsx-runtime").JSX.Element;
 export declare const DdocTab: ({ tab, tabIndex, tabCount, handleEmojiChange, handleNameChange, onClick, editor, tocItem, setTocItems, orientation, activeTabId, duplicateTab, commentCount, moveTabUp, moveTabDown, isPreviewMode, isVersionHistoryMode, tabConfig, onDelete, showOutline, onShowOutlineChange, isConnected, }: {
     tab: Tab;
     tabIndex: number;

package/dist/package/extensions/comment/comment-decoration-plugin.d.ts

@@ -0,0 +1,70 @@
+import { Extension, Editor } from '@tiptap/core';
+import { EditorState, PluginKey } from '@tiptap/pm/state';
+import { Transform } from '@tiptap/pm/transform';
+import { DecorationSet } from '@tiptap/pm/view';
+
+import * as Y from 'yjs';
+export interface CommentAnchor {
+    id: string;
+    anchorFrom: Y.RelativePosition;
+    anchorTo: Y.RelativePosition;
+    resolved: boolean;
+    deleted: boolean;
+}
+interface CommentDecorationPluginState {
+    decorations: DecorationSet;
+}
+type CommentAnchorRange = {
+    from: number;
+    to: number;
+};
+type CommentAnchorRelativeRange = {
+    anchorFrom: Y.RelativePosition;
+    anchorTo: Y.RelativePosition;
+};
+export type CommentAnchorTransactionChange = {
+    id: string;
+    type: 'unchanged';
+} | {
+    id: string;
+    type: 'deleted';
+} | ({
+    id: string;
+    type: 'edited';
+} & CommentAnchorRange & CommentAnchorRelativeRange);
+export declare const commentDecorationPluginKey: PluginKey<CommentDecorationPluginState>;
+export declare function resolveCommentAnchorRangeInState(anchor: Pick<CommentAnchor, 'anchorFrom' | 'anchorTo'>, state: EditorState): CommentAnchorRange | null;
+export declare function resolveCommentAnchorRangeForAnalysis(anchor: Pick<CommentAnchor, 'id' | 'anchorFrom' | 'anchorTo'>, state: EditorState): CommentAnchorRange | null;
+/**
+ * Analyze transaction changes to classify each active anchor's mutation status.
+ *
+ * This is the core transaction analysis function that determines
+ * whether each anchor remains unchanged, gets edited, or is deleted.
+ *
+ * Classification rules (in order):
+ * 1. Skip deleted or resolved anchors → 'unchanged'
+ * 2. If anchor has no old position → 'unchanged'
+ * 3. If no changed ranges touch the anchor → 'unchanged'
+ * 4. If any changed range fully covers the anchor → 'deleted' (full-span replacement)
+ * 5. If combined changed ranges fully cover the anchor → 'deleted' (multi-step removal)
+ * 6. If anchor maps through transform → check if position or content changed:
+ *    a. If both unchanged → 'unchanged'
+ *    b. Otherwise → 'edited' (return new position and relative anchor)
+ * 7. If mapping fails → 'deleted'
+ */
+export declare function analyzeCommentAnchorTransactionChanges(anchors: CommentAnchor[], oldState: EditorState, newState: EditorState, transform: Transform): CommentAnchorTransactionChange[];
+export interface CommentDecorationOptions {
+    getAnchors: () => CommentAnchor[];
+    getActiveCommentId: () => string | null;
+}
+export declare const CommentDecorationExtension: Extension<CommentDecorationOptions, any>;
+/**
+ * Public helper functions for comment anchor creation and inspection.
+ * These are consumed by the draft-creation flow and transaction-analysis layer.
+ */
+export declare function createCommentAnchorFromEditor(editor: Editor, from: number, to: number): CommentAnchorRelativeRange | null;
+export declare function createCommentAnchorFromSelection(editor: Editor): CommentAnchorRelativeRange | null;
+export declare function triggerDecorationRebuild(editor: Editor): void;
+export declare function getCommentAtPosition(editor: Editor, pos: number, getAnchors: () => CommentAnchor[]): CommentAnchor | null;
+export declare function getCommentAnchorRange(editor: Editor, commentId: string, getAnchors: () => CommentAnchor[]): CommentAnchorRange | null;
+export {};

package/dist/package/extensions/comment/comment.d.ts

@@ -1,5 +1,7 @@
 import { Mark, Range } from '@tiptap/core';
 import { Mark as PMMark } from '@tiptap/pm/model';
+import { PluginKey, EditorState } from '@tiptap/pm/state';
+import { DecorationSet } from '@tiptap/pm/view';
 
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
@@ -28,6 +30,18 @@ declare module '@tiptap/core' {
              * Unset comment active
              */
             unsetCommentActive: () => ReturnType;
+            /**
+             * Add a local draft anchor that tracks through transactions.
+             */
+            setDraftComment: (draftId: string) => ReturnType;
+            /**
+             * Remove a local draft anchor.
+             */
+            unsetDraftComment: (draftId: string) => ReturnType;
+            /**
+             * Replace a draft anchor with a persisted comment mark.
+             */
+            promoteDraftComment: (draftId: string, commentId: string) => ReturnType;
         };
     }
 }
@@ -35,6 +49,10 @@ export interface MarkWithRange {
     mark: PMMark;
     range: Range;
 }
+export interface CommentMarkMatch {
+    commentId: string;
+    resolved: boolean;
+}
 export interface CommentOptions {
     HTMLAttributes: Record<string, any>;
     onCommentActivated: (commentId: string) => void;
@@ -45,6 +63,20 @@ export interface CommentOptions {
 export interface CommentStorage {
     activeCommentId: string | null;
 }
+export interface DraftCommentRange {
+    draftId: string;
+    from: number;
+    to: number;
+}
+interface DraftCommentPluginState {
+    decorations: DecorationSet;
+    drafts: Map<string, DraftCommentRange>;
+}
+export declare const draftCommentPluginKey: PluginKey<DraftCommentPluginState>;
+export declare const getDraftCommentState: (state: EditorState) => DraftCommentPluginState | undefined;
+export declare const getDraftCommentRange: (state: EditorState, draftId: string) => DraftCommentRange | null;
+export declare const getCommentMarkAtPosition: (state: EditorState, pos: number) => CommentMarkMatch | null;
+export declare const getCommentMarkRange: (state: EditorState, commentId: string) => Range | null;
 export interface IComment {
     id?: string;
     tabId?: string;
@@ -63,3 +95,4 @@ export interface IComment {
     version?: string;
 }
 export declare const CommentExtension: Mark<CommentOptions, CommentStorage>;
+export {};

package/dist/package/extensions/resizable-media/resizable-media-menu-util.d.ts

@@ -1,17 +1,18 @@
-import { Attrs, Node as ProseMirrorNode } from '@tiptap/pm/model';
-import { Editor } from '@tiptap/core';
+import { Attrs } from '@tiptap/pm/model';
 
 interface ResizableMediaAttributes {
     dataAlign: string;
     dataFloat: null | string;
+    showCaptionInput?: boolean;
+    caption?: string;
 }
 type UpdateAttributes = (attrs: Partial<ResizableMediaAttributes>) => void;
-type Action = (updateAttributes: UpdateAttributes, editor?: Editor, getPos?: (() => number | undefined) | boolean) => void;
+type Action = (updateAttributes: UpdateAttributes) => void;
 interface ResizableMediaAction {
     tooltip: string;
     icon?: string;
     action?: Action;
-    isActive?: (attrs: Attrs, node?: ProseMirrorNode) => boolean;
+    isActive?: (attrs: Attrs) => boolean;
     delete?: (d: () => void) => void;
 }
 export declare const resizableMediaActions: ResizableMediaAction[];

package/dist/package/extensions/resizable-media/resizable-media-node-view.d.ts

@@ -4,4 +4,4 @@ import { IpfsImageFetchPayload } from '../../types.ts';
 export declare const getResizableMediaNodeView: (ipfsImageFetchFn: (_data: IpfsImageFetchPayload) => Promise<{
     url: string;
     file: File;
-}>, fetchV1ImageFn: (url: string) => Promise<ArrayBuffer | undefined>) => ({ node, updateAttributes, deleteNode, selected, editor, getPos, }: NodeViewProps) => import("react/jsx-runtime").JSX.Element;
+}>, fetchV1ImageFn: (url: string) => Promise<ArrayBuffer | undefined>) => ({ node, updateAttributes, deleteNode, selected }: NodeViewProps) => import("react/jsx-runtime").JSX.Element;

package/dist/package/hooks/use-tab-editor.d.ts

@@ -1,6 +1,7 @@
 import { Dispatch, MutableRefObject, SetStateAction } from 'react';
-import { DdocProps, ThemeKey } from '../types';
+import { DdocProps, SerializedCommentAnchor, ThemeKey } from '../types';
 import { AnyExtension, Editor } from '@tiptap/react';
+import { CommentAnchor } from '../extensions/comment/comment-decoration-plugin';
 import { ToCItemType } from '../components/toc/types';
 import { CollabConnectionConfig, CollaborationProps } from '../sync-local/types';
 
@@ -17,6 +18,7 @@ interface UseTabEditorArgs {
     isSyncing?: boolean;
     awareness?: any;
     disableInlineComment?: boolean;
+    isFocusMode?: boolean;
     onCommentInteraction?: DdocProps['onCommentInteraction'];
     onError?: DdocProps['onError'];
     ipfsImageUploadFn?: DdocProps['ipfsImageUploadFn'];
@@ -47,8 +49,9 @@ interface UseTabEditorArgs {
     activeTabId: string;
     theme?: ThemeKey;
     editorRef?: MutableRefObject<Editor | null>;
+    initialCommentAnchors?: SerializedCommentAnchor[];
 }
-export declare const useTabEditor: ({ ydoc, isVersionMode, hasTabState, versionId, isPreviewMode, initialContent, collaboration, isReady, isSyncing, awareness, disableInlineComment, onCommentInteraction, onError, ipfsImageUploadFn, metadataProxyUrl, onCopyHeadingLink, ipfsImageFetchFn, fetchV1ImageFn, isConnected, activeModel, maxTokens, isAIAgentEnabled, setCharacterCount, setWordCount, setPageCount, setIsContentLoading, setIsCollabContentLoading, unFocused, zoomLevel, isPresentationMode, onInvalidContentError, ignoreCorruptedData, onCollaboratorChange, onConnect, hasCollabContentInitialised, initialiseYjsIndexedDbProvider, externalExtensions, isContentLoading, activeTabId, theme, editorRef, }: UseTabEditorArgs) => {
+export declare const useTabEditor: ({ ydoc, isVersionMode, hasTabState, versionId, isPreviewMode, initialContent, collaboration, isReady, isSyncing, awareness, disableInlineComment, isFocusMode, onCommentInteraction, onError, ipfsImageUploadFn, metadataProxyUrl, onCopyHeadingLink, ipfsImageFetchFn, fetchV1ImageFn, isConnected, activeModel, maxTokens, isAIAgentEnabled, setCharacterCount, setWordCount, setPageCount, setIsContentLoading, setIsCollabContentLoading, unFocused, zoomLevel, isPresentationMode, onInvalidContentError, ignoreCorruptedData, onCollaboratorChange, onConnect, hasCollabContentInitialised, initialiseYjsIndexedDbProvider, externalExtensions, isContentLoading, activeTabId, theme, editorRef, initialCommentAnchors, }: UseTabEditorArgs) => {
     editor: Editor | null;
     ref: import('react').RefObject<HTMLDivElement>;
     slides: string[];
@@ -59,5 +62,6 @@ export declare const useTabEditor: ({ ydoc, isVersionMode, hasTabState, versionI
     setActiveCommentId: Dispatch<SetStateAction<string | null>>;
     focusCommentWithActiveId: (id: string) => void;
     isContentLoading: boolean | undefined;
+    commentAnchorsRef: MutableRefObject<CommentAnchor[]>;
 };
 export {};

package/dist/package/stores/comment-store-provider.d.ts

@@ -0,0 +1,56 @@
+import { default as React } from 'react';
+import { Editor } from '@tiptap/core';
+import { IComment } from '../extensions/comment';
+import { CommentAnchor } from '../extensions/comment/comment-decoration-plugin';
+import { CommentMutationMeta, SerializedCommentAnchor } from '../types';
+
+import * as Y from 'yjs';
+export interface CommentStoreProviderProps {
+    children: React.ReactNode;
+    editor: Editor | null;
+    ydoc: Y.Doc;
+    isFocusMode?: boolean;
+    setActiveCommentId: (id: string | null) => void;
+    focusCommentWithActiveId: (id: string) => void;
+    setInitialComments?: React.Dispatch<React.SetStateAction<IComment[]>>;
+    onNewComment?: (comment: IComment, meta?: CommentMutationMeta) => void;
+    onEditComment?: (commentId: string, meta?: CommentMutationMeta) => void;
+    onEditReply?: (commentId: string, replyId: string, meta?: CommentMutationMeta) => void;
+    onCommentReply?: (activeCommentId: string, reply: IComment) => void;
+    onResolveComment?: (commentId: string, meta?: CommentMutationMeta) => void;
+    onUnresolveComment?: (commentId: string, meta?: CommentMutationMeta) => void;
+    onDeleteComment?: (commentId: string, meta?: CommentMutationMeta) => void;
+    onInlineComment?: () => void;
+    onComment?: () => void;
+    setCommentDrawerOpen?: (open: boolean) => void;
+    connectViaWallet?: () => Promise<void>;
+    connectViaUsername?: (username: string) => Promise<void>;
+    ensResolutionUrl: string;
+    commentAnchorsRef?: React.MutableRefObject<CommentAnchor[]>;
+    initialCommentAnchors?: SerializedCommentAnchor[];
+    initialComments: IComment[];
+    username: string | null;
+    activeCommentId: string | null;
+    activeTabId: string;
+    isConnected?: boolean;
+    isLoading?: boolean;
+    isDDocOwner?: boolean;
+    setUsername?: React.Dispatch<React.SetStateAction<string>>;
+}
+export declare const CommentStoreProvider: ({ children, editor, ydoc, isFocusMode, setActiveCommentId, focusCommentWithActiveId, setInitialComments, onNewComment, onEditComment, onEditReply, onCommentReply, onResolveComment, onUnresolveComment, onDeleteComment, onInlineComment, onComment, setCommentDrawerOpen, connectViaWallet, connectViaUsername, ensResolutionUrl, commentAnchorsRef, initialCommentAnchors, setUsername: setUsernameProp, initialComments, username, activeCommentId, activeTabId, isConnected, isLoading, isDDocOwner, }: CommentStoreProviderProps) => import("react/jsx-runtime").JSX.Element;
+interface CommentRefsContextType {
+    commentsSectionRef: React.RefObject<HTMLDivElement>;
+    replySectionRef: React.RefObject<HTMLDivElement>;
+    portalRef: React.RefObject<HTMLDivElement>;
+    buttonRef: React.RefObject<HTMLDivElement>;
+    dropdownRef: React.RefObject<HTMLDivElement>;
+    mobileDraftRef: React.RefObject<HTMLDivElement>;
+}
+export declare const useCommentRefs: () => CommentRefsContextType;
+interface CommentAnchorsContextType {
+    activeCommentAnchorIds: Set<string>;
+    activeCommentAnchorIdsTabId: string | null;
+    hasRenderedCommentAnchor: (commentId: string) => boolean;
+}
+export declare const useCommentAnchors: () => CommentAnchorsContextType;
+export {};

package/dist/package/stores/comment-store.d.ts

@@ -0,0 +1,195 @@
+import { Editor } from '@tiptap/react';
+import { default as React } from 'react';
+import { CommentAnchor } from '../extensions/comment/comment-decoration-plugin';
+import { CommentFloatingCard, EnsCache, InlineCommentData, InlineCommentDraft, InlineDraftLocation } from '../components/inline-comment/context/types';
+import { EnsStatus } from '../components/inline-comment/types';
+import { IComment } from '../extensions/comment';
+import { CommentMutationMeta, CommentMutationType } from '../types';
+
+import * as Y from 'yjs';
+export interface CommentExternalDeps {
+    editor: Editor | null;
+    ydoc: Y.Doc;
+    setActiveCommentId: (id: string | null) => void;
+    focusCommentWithActiveId: (id: string) => void;
+    setInitialComments?: React.Dispatch<React.SetStateAction<IComment[]>>;
+    setUsername?: React.Dispatch<React.SetStateAction<string>>;
+    onNewComment?: (comment: IComment, meta?: CommentMutationMeta) => void;
+    onEditComment?: (commentId: string, meta?: CommentMutationMeta) => void;
+    onEditReply?: (commentId: string, replyId: string, meta?: CommentMutationMeta) => void;
+    onCommentReply?: (activeCommentId: string, reply: IComment) => void;
+    onResolveComment?: (commentId: string, meta?: CommentMutationMeta) => void;
+    onUnresolveComment?: (commentId: string, meta?: CommentMutationMeta) => void;
+    onDeleteComment?: (commentId: string, meta?: CommentMutationMeta) => void;
+    onInlineComment?: () => void;
+    onComment?: () => void;
+    setCommentDrawerOpen?: (open: boolean) => void;
+    connectViaWallet?: () => Promise<void>;
+    connectViaUsername?: (username: string) => Promise<void>;
+    ensResolutionUrl: string;
+    commentAnchorsRef?: React.MutableRefObject<CommentAnchor[]>;
+    refreshCommentAnchorState?: () => void;
+}
+type FloatingCardsUpdater = React.SetStateAction<CommentFloatingCard[]>;
+type InlineCommentDataUpdater = Partial<InlineCommentData> | ((prev: InlineCommentData) => Partial<InlineCommentData> | InlineCommentData);
+type InlineDraftRecordMap = Record<string, InlineCommentDraft>;
+type CreateInlineDraftOptions = {
+    location?: InlineDraftLocation;
+    tabId?: string;
+    allowEmptySelection?: boolean;
+};
+type CommentEditRequest = {
+    requestId: string;
+    kind: 'comment' | 'reply';
+    commentId: string;
+    replyId?: string;
+    text: string;
+};
+type ReplyEditTarget = {
+    kind: 'comment' | 'reply';
+    commentId: string;
+    replyId?: string;
+    originalText: string;
+};
+type CommentEditCompletion = {
+    nonce: number;
+    kind: 'comment' | 'reply';
+    commentId: string;
+    replyId?: string;
+};
+type FocusCommentInEditorOptions = {
+    source?: 'explicit-ui' | 'passive';
+};
+type ReconcileFloatingThreadsForActiveTabOptions = {
+    hydrationReady: boolean;
+};
+export declare const EXPLICIT_COMMENT_FOCUS_META = "inlineCommentExplicitFocus";
+export interface CommentStoreState {
+    initialComments: IComment[];
+    tabComments: IComment[];
+    activeComments: IComment[];
+    activeComment: IComment | undefined;
+    activeCommentIndex: number;
+    username: string | null;
+    activeCommentId: string | null;
+    activeTabId: string;
+    isConnected: boolean;
+    isLoading: boolean;
+    isDDocOwner: boolean;
+    onComment: (() => void) | null;
+    setCommentDrawerOpen: ((open: boolean) => void) | null;
+    connectViaWallet: (() => Promise<void>) | null;
+    connectViaUsername: ((username: string) => Promise<void>) | null;
+    isCommentActive: boolean;
+    isCommentResolved: boolean;
+    showResolved: boolean;
+    reply: string;
+    comment: string;
+    openReplyId: string | null;
+    selectedText: string;
+    isCommentOpen: boolean;
+    isBubbleMenuSuppressed: boolean;
+    inlineCommentData: InlineCommentData;
+    floatingCards: CommentFloatingCard[];
+    pendingPrehydrationFloatingThreadIds: string[];
+    inlineDrafts: InlineDraftRecordMap;
+    activeDraftId: string | null;
+    isDesktopFloatingEnabled: boolean;
+    ensCache: EnsCache;
+    inProgressFetch: string[];
+    editRequest: CommentEditRequest | null;
+    replyEditTarget: ReplyEditTarget | null;
+    editCompletion: CommentEditCompletion | null;
+    _externalDepsRef: React.RefObject<CommentExternalDeps | null> | null;
+    setExternalDepsRef: (ref: React.RefObject<CommentExternalDeps | null>) => void;
+    _recomputeDerived: () => void;
+    setInitialComments: (comments: IComment[]) => void;
+    setUsername: (username: string | null) => void;
+    setActiveCommentId: (id: string | null) => void;
+    setActiveTabId: (tabId: string) => void;
+    setIsConnected: (connected: boolean) => void;
+    setIsLoading: (loading: boolean) => void;
+    setIsDDocOwner: (isOwner: boolean) => void;
+    setOnComment: (fn: (() => void) | null) => void;
+    setCommentDrawerOpenFn: (fn: ((open: boolean) => void) | null) => void;
+    setConnectViaWallet: (fn: (() => Promise<void>) | null) => void;
+    setConnectViaUsername: (fn: ((username: string) => Promise<void>) | null) => void;
+    setIsCommentActive: (active: boolean) => void;
+    setIsCommentResolved: (resolved: boolean) => void;
+    getTabComments: () => IComment[];
+    getActiveComment: () => IComment | undefined;
+    getActiveComments: () => IComment[];
+    getActiveCommentIndex: () => number;
+    getIsCommentActive: () => boolean;
+    getIsCommentResolved: () => boolean;
+    setShowResolved: (show: boolean) => void;
+    setReply: (reply: string) => void;
+    setComment: (comment: string) => void;
+    setOpenReplyId: (id: string | null) => void;
+    setSelectedText: (text: string) => void;
+    setIsCommentOpen: (open: boolean) => void;
+    setIsBubbleMenuSuppressed: (suppressed: boolean) => void;
+    setInlineCommentData: (data: InlineCommentDataUpdater) => void;
+    setFloatingCards: (floatingCards: FloatingCardsUpdater) => void;
+    clearFloatingCards: () => void;
+    setActiveDraftId: (draftId: string | null) => void;
+    setIsDesktopFloatingEnabled: (enabled: boolean) => void;
+    toggleResolved: () => void;
+    clearEditRequest: (requestId: string) => void;
+    setReplyEditTarget: (target: ReplyEditTarget | null) => void;
+    cancelReplyEdit: () => void;
+    handleInput: (e: React.FormEvent<HTMLTextAreaElement>, content: string) => void;
+    handleReplyChange: (e: React.ChangeEvent<HTMLTextAreaElement>) => void;
+    handleCommentChange: (e: React.ChangeEvent<HTMLTextAreaElement>) => void;
+    handleCommentKeyDown: (e: React.KeyboardEvent<HTMLTextAreaElement>, tabId?: string) => void;
+    handleReplyKeyDown: (e: React.KeyboardEvent<HTMLTextAreaElement>) => void;
+    handleReplySubmit: () => void;
+    handleCommentSubmit: (tabId?: string) => void;
+    handleInlineComment: () => void;
+    addComment: (content?: string, usernameProp?: string) => string | undefined;
+    createFloatingDraft: (options?: CreateInlineDraftOptions) => string | null;
+    updateInlineDraftText: (draftId: string, value: string) => void;
+    cancelInlineDraft: (draftId: string) => void;
+    submitInlineDraft: (draftId: string) => void;
+    updateFloatingDraftText: (draftId: string, value: string) => void;
+    cancelFloatingDraft: (draftId: string) => void;
+    submitFloatingDraft: (draftId: string) => void;
+    openFloatingThread: (commentId: string) => void;
+    closeFloatingCard: (floatingCardId: string) => void;
+    blurFloatingCard: (floatingCardId: string) => void;
+    focusFloatingCard: (floatingCardId: string) => void;
+    removeInvalidFloatingDrafts: () => void;
+    reconcileFloatingThreadsForActiveTab: (options: ReconcileFloatingThreadsForActiveTabOptions) => void;
+    syncFloatingThreadCardWithActiveComment: () => void;
+    submitPendingFloatingDrafts: () => void;
+    /**
+     * Apply anchor edits to local comment state.
+     * Called after transaction analysis identifies edited anchors.
+     * Updates selectedContent for each affected comment
+     * so thread display stays in sync immediately, before consumer rehydration.
+     */
+    applyCommentAnchorEdits: (edits: Array<{
+        commentId: string;
+        selectedContent: string;
+    }>) => void;
+    resolveComment: (commentId: string) => void;
+    unresolveComment: (commentId: string) => void;
+    deleteComment: (commentId: string, options?: {
+        skipExternalCallback?: boolean;
+    }) => void;
+    deleteReply: (commentId: string, replyId: string) => void;
+    requestEditComment: (commentId: string) => void;
+    requestEditReply: (commentId: string, replyId: string) => void;
+    editCommentContent: (commentId: string, content: string) => void;
+    editReplyContent: (commentId: string, replyId: string, content: string) => void;
+    handleAddReply: (activeCommentId: string, replyContent: string, replyCallback?: (activeCommentId: string, reply: IComment) => void) => void;
+    focusCommentInEditor: (commentId: string, options?: FocusCommentInEditorOptions) => void;
+    onPrevComment: () => void;
+    onNextComment: () => void;
+    getEnsStatus: (walletAddress: string, setEnsStatus: React.Dispatch<React.SetStateAction<EnsStatus>>) => void;
+    createMutationMeta: (type: CommentMutationType, mutate: () => boolean) => CommentMutationMeta | undefined;
+}
+export declare const createCommentStore: () => import('zustand').StoreApi<CommentStoreState>;
+export declare const CommentStoreContext: React.Context<import('zustand').StoreApi<CommentStoreState> | null>;
+export declare function useCommentStore<T>(selector: (state: CommentStoreState) => T): T;
+export {};

package/dist/package/types.d.ts

@@ -19,10 +19,21 @@ export type InlineCommentData = {
     highlightedTextContent: string;
     handleClick: boolean;
 };
-export type CommentMutationType = 'create' | 'resolve' | 'unresolve' | 'delete';
+export type CommentMutationType = 'create' | 'edit' | 'resolve' | 'unresolve' | 'delete';
 export interface CommentMutationMeta {
     type: CommentMutationType;
-    updateChunk: string;
+    updateChunk?: string;
+    anchorFrom?: string;
+    anchorTo?: string;
+    selectedContent?: string;
+    content?: string;
+}
+export interface SerializedCommentAnchor {
+    id: string;
+    anchorFrom: string;
+    anchorTo: string;
+    resolved: boolean;
+    deleted: boolean;
 }
 export interface CommentAccountProps {
     isConnected?: boolean;
@@ -107,9 +118,12 @@ export interface DdocProps extends CommentAccountProps {
     commentDrawerOpen?: boolean;
     setCommentDrawerOpen?: React.Dispatch<SetStateAction<boolean>>;
     initialComments?: IComment[];
+    initialCommentAnchors?: SerializedCommentAnchor[];
     setInitialComments?: React.Dispatch<SetStateAction<IComment[]>>;
     onCommentReply?: (activeCommentId: string, reply: IComment) => void;
     onNewComment?: (newComment: IComment, meta?: CommentMutationMeta) => void;
+    onEditComment?: (activeCommentId: string, meta?: CommentMutationMeta) => void;
+    onEditReply?: (activeCommentId: string, replyId: string, meta?: CommentMutationMeta) => void;
     onResolveComment?: (activeCommentId: string, meta?: CommentMutationMeta) => void;
     onUnresolveComment?: (activeCommentId: string, meta?: CommentMutationMeta) => void;
     onDeleteComment?: (activeCommentId: string, meta?: CommentMutationMeta) => void;

package/dist/package/use-ddoc-editor.d.ts

@@ -1,7 +1,9 @@
 import { DdocProps } from './types';
 import { Editor } from '@tiptap/react';
 
-export declare const useDdocEditor: ({ isPreviewMode, initialContent, versionHistoryState, collaboration, onChange, onCollaboratorChange, onCommentInteraction, onError, setCharacterCount, setWordCount, setPageCount, ipfsImageUploadFn, ddocId, enableIndexeddbSync, unFocused, theme, zoomLevel, onInvalidContentError, ignoreCorruptedData, isPresentationMode, metadataProxyUrl, extensions: externalExtensions, onCopyHeadingLink, ipfsImageFetchFn, fetchV1ImageFn, isConnected, activeModel, maxTokens, isAIAgentEnabled, onIndexedDbError, disableInlineComment, ...rest }: Partial<DdocProps>) => {
+export declare const useDdocEditor: ({ isPreviewMode, initialContent, versionHistoryState, collaboration, onChange, onCollaboratorChange, onCommentInteraction, onError, setCharacterCount, setWordCount, setPageCount, ipfsImageUploadFn, ddocId, enableIndexeddbSync, unFocused, isFocusMode, theme, zoomLevel, onInvalidContentError, ignoreCorruptedData, isPresentationMode, metadataProxyUrl, extensions: externalExtensions, onCopyHeadingLink, ipfsImageFetchFn, fetchV1ImageFn, isConnected, activeModel, maxTokens, isAIAgentEnabled, onIndexedDbError, disableInlineComment, initialCommentAnchors, ...rest }: Partial<DdocProps> & {
+    isFocusMode?: boolean;
+}) => {
     ydoc: import('yjs').Doc;
     awareness: import('y-protocols/awareness.js').Awareness | null;
     refreshYjsIndexedDbProvider: () => Promise<void>;
@@ -38,4 +40,5 @@ export declare const useDdocEditor: ({ isPreviewMode, initialContent, versionHis
     activeCommentId: string | null;
     setActiveCommentId: import('react').Dispatch<import('react').SetStateAction<string | null>>;
     focusCommentWithActiveId: (id: string) => void;
+    commentAnchorsRef: import('react').MutableRefObject<import('./extensions/comment/comment-decoration-plugin').CommentAnchor[]>;
 };

package/dist/package/utils/comment-anchor-serialization.d.ts

@@ -0,0 +1,5 @@
+import { CommentAnchor } from '../extensions/comment/comment-decoration-plugin';
+import { SerializedCommentAnchor } from '../types';
+
+export declare const getSerializedCommentAnchorsKey: (anchors?: SerializedCommentAnchor[]) => string | null;
+export declare const deserializeCommentAnchors: (anchors?: SerializedCommentAnchor[]) => CommentAnchor[];

package/dist/package/utils/comment-scroll-into-view.d.ts

@@ -0,0 +1,21 @@
+import { MutableRefObject } from 'react';
+import { Editor } from '@tiptap/react';
+import { CommentAnchor } from '../extensions/comment/comment-decoration-plugin';
+
+export declare const MOBILE_COMMENT_DRAWER_CANVAS_OFFSET_VAR = "--mobile-comment-drawer-canvas-offset";
+type CommentSelectionRange = {
+    from: number;
+    to: number;
+};
+export declare const clearMobileCommentDrawerCanvasOffset: (editorRoot?: HTMLElement | null) => void;
+export declare const resolveCommentSelectionRange: ({ editor, commentId, commentAnchorsRef, }: {
+    editor: Editor;
+    commentId: string;
+    commentAnchorsRef?: MutableRefObject<CommentAnchor[]>;
+}) => CommentSelectionRange | null;
+export declare const scrollCommentSelectionRangeIntoView: ({ editor, selectionRange, behavior, }: {
+    editor: Editor;
+    selectionRange: CommentSelectionRange;
+    behavior?: ScrollBehavior;
+}) => void;
+export {};