@fileverse-dev/ddoc 3.1.5 → 3.1.6-patch-001

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

@@ -0,0 +1,23 @@
+import { RefObject } from 'react';
+import { Editor } from '@tiptap/react';
+import { CommentFloatingCard } from './context/types';
+
+interface UseFloatingCommentCardLayoutProps {
+    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>;
+}
+interface UseFloatingCommentCardLayoutResult {
+    floatingCardListContainerRef: RefObject<HTMLDivElement>;
+    mountedFloatingCardIds: string[];
+    registerCardNode: (floatingCardId: string, node: HTMLDivElement | null) => void;
+}
+export declare const useFloatingCommentCardLayout: ({ blurFloatingCard, closeFloatingCard, editor, editorWrapperRef, floatingCardIdsKey, floatingCards, focusedFloatingCardId, isDesktopFloatingEnabled, isHidden, scrollContainerRef, }: UseFloatingCommentCardLayoutProps) => UseFloatingCommentCardLayoutResult;
+export {};

package/dist/package/components/inline-comment/use-floating-comment-card-state.d.ts

@@ -0,0 +1,13 @@
+import { CommentFloatingCard } from './context/types';
+
+interface UseFloatingCommentCardStateResult {
+    blurFloatingCard: (floatingCardId: string) => void;
+    closeFloatingCard: (floatingCardId: string) => void;
+    floatingCardIdsKey: string;
+    floatingCardMap: Map<string, CommentFloatingCard>;
+    floatingCards: CommentFloatingCard[];
+    focusedFloatingCardId: string | null;
+    isDesktopFloatingEnabled: boolean;
+}
+export declare const useFloatingCommentCardState: () => UseFloatingCommentCardStateResult;
+export {};

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/presentation-mode/presentation-mode.d.ts

@@ -1,5 +1,5 @@
 import { Editor } from '@tiptap/react';
-import { IpfsImageFetchPayload, DdocProps, ThemeKey } from '../../types';
+import { IpfsImageFetchPayload, DdocProps } from '../../types';
 
 interface PresentationModeProps {
     editor: Editor;
@@ -22,7 +22,7 @@ interface PresentationModeProps {
     }>;
     documentStyling?: DdocProps['documentStyling'];
     fetchV1ImageFn?: (url: string) => Promise<ArrayBuffer | undefined>;
-    theme?: ThemeKey;
+    theme?: 'light' | 'dark';
 }
 export declare const PresentationMode: ({ editor, onClose, isFullscreen, setIsFullscreen, onError, setCommentDrawerOpen, sharedSlidesLink, isPreviewMode, documentName, onSlidesShare, slides, setSlides, renderThemeToggle, isContentLoading, ipfsImageFetchFn, documentStyling, fetchV1ImageFn, theme, }: PresentationModeProps) => import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/package/components/presentation-mode/preview-panel.d.ts

@@ -1,11 +1,11 @@
-import { DdocProps, ThemeKey } from '../../types';
+import { DdocProps } from '../../types';
 
 interface PreviewPanelProps {
     slides: string[];
     currentSlide: number;
     setCurrentSlide: (index: number) => void;
     documentStyling?: DdocProps['documentStyling'];
-    theme?: ThemeKey;
+    theme?: 'light' | 'dark';
 }
 export declare const PreviewPanel: ({ slides, currentSlide, setCurrentSlide, documentStyling, theme, }: PreviewPanelProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/package/components/preview-export-trigger.d.ts

@@ -15,11 +15,10 @@ interface PreviewModeExportTriggerProps {
     onPdfExport?: DdocProps['onPdfExport'];
     onHtmlExport?: DdocProps['onHtmlExport'];
     onTxtExport?: DdocProps['onTxtExport'];
-    onOdtExport?: DdocProps['onOdtExport'];
     ipfsImageFetchFn?: DdocProps['ipfsImageFetchFn'];
     onDocxImport?: DdocProps['onDocxImport'];
     fetchV1ImageFn?: DdocProps['fetchV1ImageFn'];
     isConnected?: DdocProps['isConnected'];
 }
-declare const PreviewModeExportTrigger: ({ editor, ydoc, tabs, onRegisterExportTrigger, onError, ipfsImageUploadFn, onMarkdownExport, onMarkdownImport, onPdfExport, onHtmlExport, onTxtExport, onOdtExport, ipfsImageFetchFn, onDocxImport, fetchV1ImageFn, isConnected, }: PreviewModeExportTriggerProps) => import("react/jsx-runtime").JSX.Element;
+declare const PreviewModeExportTrigger: ({ editor, ydoc, tabs, onRegisterExportTrigger, onError, ipfsImageUploadFn, onMarkdownExport, onMarkdownImport, onPdfExport, onHtmlExport, onTxtExport, ipfsImageFetchFn, onDocxImport, fetchV1ImageFn, isConnected, }: PreviewModeExportTriggerProps) => import("react/jsx-runtime").JSX.Element;
 export { PreviewModeExportTrigger };

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/context/editor-context.d.ts

@@ -1,9 +1,9 @@
 import { default as React, ReactNode } from 'react';
-import { DocumentStyling, ThemeKey } from '../types';
+import { DocumentStyling } from '../types';
 
 interface EditorContextType {
     documentStyling?: DocumentStyling;
-    theme: ThemeKey;
+    theme: 'light' | 'dark';
     isFocusMode: boolean;
 }
 export declare const EditorContext: React.Context<EditorContextType | null>;
@@ -11,7 +11,7 @@ export declare const useEditorContext: () => EditorContextType;
 export declare const EditorProvider: React.FC<{
     children: ReactNode;
     documentStyling?: DocumentStyling;
-    theme?: ThemeKey;
+    theme?: 'light' | 'dark';
     isFocusMode?: boolean;
 }>;
 export {};

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

@@ -0,0 +1,67 @@
+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>;
+/**
+ * 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[];
+}
+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;
         };
     }
 }
@@ -45,6 +59,18 @@ 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 interface IComment {
     id?: string;
     tabId?: string;
@@ -63,3 +89,4 @@ export interface IComment {
     version?: string;
 }
 export declare const CommentExtension: Mark<CommentOptions, CommentStorage>;
+export {};

package/dist/package/extensions/default-extension.d.ts

@@ -14,5 +14,5 @@ export declare const defaultExtensions: ({ ipfsImageFetchFn, onError, metadataPr
     onCopyHeadingLink?: (link: string) => void;
     fetchV1ImageFn?: (url: string) => Promise<ArrayBuffer | undefined>;
     onTocUpdate?: (data: ToCItemType[], isCreate?: boolean) => void;
-}) => (import('@tiptap/core').AnyExtension | import('@tiptap/core').Node<import('@tiptap/extension-horizontal-rule').HorizontalRuleOptions, any> | import('@tiptap/core').Extension<import('./multi-column').ColumnExtensionOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-heading').HeadingOptions, any> | import('@tiptap/core').Node<import('./iframe').IframeOptions, any> | import('@tiptap/core').Node<import('./twitter-embed').EmbeddedTweetOptions, any> | import('@tiptap/core').Node<import('./d-block').DBlockOptions, any> | import('@tiptap/core').Extension<import('./trailing-node').TrailingNodeOptions, any> | import('@tiptap/core').Node<import('./action-button').ActionButtonOptions, any> | import('@tiptap/core').Node<import('./resizable-media').MediaOptions, any> | import('@tiptap/core').Extension<import('./link-preview/link-preview').LinkPreviewOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-code-block-lowlight').CodeBlockLowlightOptions, any> | import('@tiptap/core').Mark<import('./custom-link').CustomLinkOptions, any> | import('@tiptap/core').Mark<import('@tiptap/extension-text-style').TextStyleOptions, any> | import('@tiptap/core').Mark<import('@tiptap/extension-subscript').SubscriptExtensionOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extension-text-style').FontFamilyOptions, any> | import('@tiptap/core').Extension<import('@tiptap/starter-kit').StarterKitOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extension-table-of-contents').TableOfContentsOptions, import('@tiptap/extension-table-of-contents').TableOfContentsStorage> | import('@tiptap/core').Extension<import('@tiptap/extension-typography').TypographyOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extension-text-align').TextAlignOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extensions').PlaceholderOptions, any> | import('@tiptap/core').Mark<import('@tiptap/extension-highlight').HighlightOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').TaskListOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').TaskItemOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').BulletListOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').ListItemOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extensions').DropcursorOptions, any> | import('@tiptap/core').Extension<import('tiptap-markdown').MarkdownOptions, import('tiptap-markdown').MarkdownStorage> | import('@tiptap/core').Extension<import('@tiptap/extensions').CharacterCountOptions, import('@tiptap/extensions').CharacterCountStorage> | import('@tiptap/core').Extension<import('@aarkue/tiptap-math-extension').MathExtensionOption, any>)[];
+}) => (import('@tiptap/core').AnyExtension | import('@tiptap/core').Node<import('@tiptap/extension-horizontal-rule').HorizontalRuleOptions, any> | import('@tiptap/core').Extension<import('./multi-column').ColumnExtensionOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-heading').HeadingOptions, any> | import('@tiptap/core').Node<import('./iframe').IframeOptions, any> | import('@tiptap/core').Node<import('./twitter-embed').EmbeddedTweetOptions, any> | import('@tiptap/core').Node<import('./d-block').DBlockOptions, any> | import('@tiptap/core').Extension<import('./trailing-node').TrailingNodeOptions, any> | import('@tiptap/core').Node<import('./action-button').ActionButtonOptions, any> | import('@tiptap/core').Node<import('./resizable-media').MediaOptions, any> | import('@tiptap/core').Extension<import('./link-preview/link-preview').LinkPreviewOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-code-block-lowlight').CodeBlockLowlightOptions, any> | import('@tiptap/core').Mark<import('@tiptap/extension-text-style').TextStyleOptions, any> | import('@tiptap/core').Mark<import('@tiptap/extension-subscript').SubscriptExtensionOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extension-text-style').FontFamilyOptions, any> | import('@tiptap/core').Extension<import('@tiptap/starter-kit').StarterKitOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extension-table-of-contents').TableOfContentsOptions, import('@tiptap/extension-table-of-contents').TableOfContentsStorage> | import('@tiptap/core').Extension<import('@tiptap/extension-typography').TypographyOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extension-text-align').TextAlignOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extensions').PlaceholderOptions, any> | import('@tiptap/core').Mark<import('@tiptap/extension-highlight').HighlightOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').TaskListOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').TaskItemOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').BulletListOptions, any> | import('@tiptap/core').Node<import('@tiptap/extension-list').ListItemOptions, any> | import('@tiptap/core').Extension<import('@tiptap/extensions').DropcursorOptions, any> | import('@tiptap/core').Extension<import('tiptap-markdown').MarkdownOptions, import('tiptap-markdown').MarkdownStorage> | import('@tiptap/core').Extension<import('@tiptap/extensions').CharacterCountOptions, import('@tiptap/extensions').CharacterCountStorage> | import('@tiptap/core').Extension<import('@aarkue/tiptap-math-extension').MathExtensionOption, any>)[];
 export declare const createInputRule: (pattern: RegExp, data: string, type: NodeType) => InputRule;

package/dist/package/hooks/use-ddoc-export.d.ts

@@ -10,7 +10,7 @@ interface UseDdocExportArgs {
     exportOptions: (IEditorToolElement | null)[];
 }
 declare const useDdocExport: ({ editor, tabs, ydoc, exportOptions, }: UseDdocExportArgs) => {
-    getOptionFormat: (title: string) => "" | "md" | "pdf" | "html" | "txt" | "odt";
+    getOptionFormat: (title: string) => "" | "md" | "pdf" | "html" | "txt";
     formatSelectOptions: {
         id: string;
         label: string;

package/dist/package/hooks/use-export-headless-editor-content.d.ts

@@ -3,7 +3,7 @@ import { DdocExportModalProps } from '../components/export-modal';
 import { UseHeadlessEditorProps } from './use-headless-editor';
 
 import * as Y from 'yjs';
-export type HeadlessEditorExportFormat = 'pdf' | 'md' | 'html' | 'txt' | 'odt';
+export type HeadlessEditorExportFormat = 'pdf' | 'md' | 'html' | 'txt';
 export interface HeadlessEditorExportOption {
     content: string;
     fileName?: string;

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 } 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';
 
@@ -45,10 +46,10 @@ interface UseTabEditorArgs {
     externalExtensions?: Record<string, AnyExtension>;
     isContentLoading?: boolean;
     activeTabId: string;
-    theme?: ThemeKey;
+    theme?: 'dark' | 'light';
     editorRef?: MutableRefObject<Editor | null>;
 }
-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, onCommentInteraction, onError, ipfsImageUploadFn, metadataProxyUrl, onCopyHeadingLink, ipfsImageFetchFn, fetchV1ImageFn, isConnected, activeModel, maxTokens, isAIAgentEnabled, setCharacterCount, setWordCount, setPageCount, setIsContentLoading, setIsCollabContentLoading, unFocused, zoomLevel, isPresentationMode, onInvalidContentError, ignoreCorruptedData, onCollaboratorChange, onConnect, initialiseYjsIndexedDbProvider, externalExtensions, isContentLoading, activeTabId, theme, editorRef, }: UseTabEditorArgs) => {
     editor: Editor | null;
     ref: import('react').RefObject<HTMLDivElement>;
     slides: string[];
@@ -59,5 +60,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/hooks/use-tab-manager.d.ts

@@ -10,13 +10,12 @@ interface UseTabManagerArgs {
     createDefaultTabIfMissing: boolean;
     shouldSyncActiveTab: boolean;
     defaultTabId?: string;
-    preferFirstTabOnInit?: boolean;
     onVersionHistoryActiveTabChange?: (tabId: string | null) => void;
     getEditor?: () => Editor | null;
     flushPendingUpdate?: () => void;
 }
 export declare const getNewTabId: () => string;
-export declare const useTabManager: ({ ydoc, initialContent, enableCollaboration, isDDocOwner, createDefaultTabIfMissing, shouldSyncActiveTab, defaultTabId, preferFirstTabOnInit, onVersionHistoryActiveTabChange, flushPendingUpdate, getEditor, }: UseTabManagerArgs) => {
+export declare const useTabManager: ({ ydoc, initialContent, enableCollaboration, isDDocOwner, createDefaultTabIfMissing, shouldSyncActiveTab, defaultTabId, onVersionHistoryActiveTabChange, flushPendingUpdate, getEditor, }: UseTabManagerArgs) => {
     tabs: Tab[];
     hasTabState: boolean;
     activeTabId: string;

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

@@ -0,0 +1,50 @@
+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;
+export {};

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

@@ -0,0 +1,185 @@
+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[]>;
+}
+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;
+};
+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[];
+    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;
+    removeInvalidFloatingCards: () => 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) => 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/sync-local/SyncManager.d.ts

@@ -14,9 +14,6 @@ export declare class SyncManager {
     private uncommittedUpdatesIdList;
     private contentTobeAppliedQueue;
     private isProcessing;
-    private flushTimer;
-    private readonly FLUSH_INTERVAL_MS;
-    private readonly MAX_QUEUE_SIZE;
     private _awarenessUpdateHandler;
     private ydoc;
     private servicesRef;
@@ -37,15 +34,6 @@ export declare class SyncManager {
     disconnect(): Promise<void>;
     terminateSession(): Promise<void>;
     enqueueLocalUpdate(update: Uint8Array): void;
-    private flushUpdates;
-    private awaitFlush;
-    /**
-     * Fire-and-forget: merge all queued updates, encrypt, and emit via Socket.IO
-     * without awaiting the server ACK. The server broadcasts to peers immediately
-     * (before MongoDB write), so content reaches observers in near-real-time.
-     * ACK callback handles updateId tracking and auto-commit asynchronously.
-     */
-    private sendUpdateBatch;
     forceCleanup(): void;
     private handleConnectionError;
     private handleReconnection;

package/dist/package/sync-local/types/index.d.ts

@@ -109,10 +109,6 @@ export interface SyncManagerConfig {
     services?: CollabServices;
     callbacks?: CollabCallbacks;
     onLocalUpdate?: (updatedDocContent: Data['editorJSONData'], updateChunk: string) => void;
-    /** Origins to ignore in the ydoc update handler (e.g. IndexedDB provider) */
-    ignoredOrigins?: Array<{
-        current: unknown;
-    }>;
 }
 export declare enum ServerErrorCode {
     AUTH_TOKEN_MISSING = "AUTH_TOKEN_MISSING",