@fileverse-dev/ddoc 4.2.0-yjs-dedupe-1 → 4.2.0-yjs-dedupe-2

package/dist/{index-BfVM4ukb.mjs → index-QQcgsp20.mjs}

@@ -1,4 +1,4 @@
-import { k as Ql, b as Zl, s as eh } from "./index-DYlSDaET.mjs";
+import { k as Ql, b as Zl, s as eh } from "./index-CM9WymRI.mjs";
 let An = [], Xr = [];
 (() => {
   let s = "lc,34,7n,7,7b,19,,,,2,,2,,,20,b,1c,l,g,,2t,7,2,6,2,2,,4,z,,u,r,2j,b,1m,9,9,,o,4,,9,,3,,5,17,3,3b,f,,w,1j,,,,4,8,4,,3,7,a,2,t,,1m,,,,2,4,8,,9,,a,2,q,,2,2,1l,,4,2,4,2,2,3,3,,u,2,3,,b,2,1l,,4,5,,2,4,,k,2,m,6,,,1m,,,2,,4,8,,7,3,a,2,u,,1n,,,,c,,9,,14,,3,,1l,3,5,3,,4,7,2,b,2,t,,1m,,2,,2,,3,,5,2,7,2,b,2,s,2,1l,2,,,2,4,8,,9,,a,2,t,,20,,4,,2,3,,,8,,29,,2,7,c,8,2q,,2,9,b,6,22,2,r,,,,,,1j,e,,5,,2,5,b,,10,9,,2u,4,,6,,2,2,2,p,2,4,3,g,4,d,,2,2,6,,f,,jj,3,qa,3,t,3,t,2,u,2,1s,2,,7,8,,2,b,9,,19,3,3b,2,y,,3a,3,4,2,9,,6,3,63,2,2,,1m,,,7,,,,,2,8,6,a,2,,1c,h,1r,4,1c,7,,,5,,14,9,c,2,w,4,2,2,,3,1k,,,2,3,,,3,1m,8,2,2,48,3,,d,,7,4,,6,,3,2,5i,1m,,5,ek,,5f,x,2da,3,3x,,2o,w,fe,6,2x,2,n9w,4,,a,w,2,28,2,7k,,3,,4,,p,2,5,,47,2,q,i,d,,12,8,p,b,1a,3,1c,,2,4,2,2,13,,1v,6,2,2,2,2,c,,8,,1b,,1f,,,3,2,2,5,2,,,16,2,8,,6m,,2,,4,,fn4,,kh,g,g,g,a6,2,gt,,6a,,45,5,1ae,3,,2,5,4,14,3,4,,4l,2,fx,4,ar,2,49,b,4w,,1i,f,1k,3,1d,4,2,2,1x,3,10,5,,8,1q,,c,2,1g,9,a,4,2,,2n,3,2,,,2,6,,4g,,3,8,l,2,1l,2,,,,,m,,e,7,3,5,5f,8,2,3,,,n,,29,,2,6,,,2,,,2,,2,6j,,2,4,6,2,,2,r,2,2d,8,2,,,2,2y,,,,2,6,,,2t,3,2,4,,5,77,9,,2,6t,,a,2,,,4,,40,4,2,2,4,,w,a,14,6,2,4,8,,9,6,2,3,1a,d,,2,ba,7,,6,,,2a,m,2,7,,2,,2,3e,6,3,,,2,,7,,,20,2,3,,,,9n,2,f0b,5,1n,7,t4,,1r,4,29,,f5k,2,43q,,,3,4,5,8,8,2,7,u,4,44,3,1iz,1j,4,1e,8,,e,,m,5,,f,11s,7,,h,2,7,,2,,5,79,7,c5,4,15s,7,31,7,240,5,gx7k,2o,3k,6o".split(",").map((e) => e ? parseInt(e, 36) : 1);

package/dist/index.d.ts

@@ -3,8 +3,12 @@ export { PreviewDdocEditor } from './package/preview-ddoc-editor';
 export { handleContentPrint } from './package/utils/handle-print';
 export { DdocExportModal } from './package/components/export-modal';
 export { useHeadlessEditor } from './package/hooks/use-headless-editor';
+export { useEditorCommands } from './package/hooks/use-editor-commands';
+export type { EditorCommand, EditorCommandId, UseEditorCommandsOptions, } from './package/hooks/use-editor-commands';
 export { useExportHeadlessEditorContent } from './package/hooks/use-export-headless-editor-content';
 export { mergeTabAwareYjsUpdates } from './package/components/tabs/utils/tab-utils';
+export { validateCustomCss, sanitizeCustomCss, } from './package/utils/sanitize-css';
+export type { CssDiagnostic, CssValidationResult, } from './package/utils/sanitize-css';
 export { buildVersionDiffSnapshot } from './package/components/tabs/utils/version-diff-snapshot';
 export type { DdocExportModalProps, ExportFormatOption, ExportTabOption, } from './package/components/export-modal';
 export type { VersionTabSnapshot } from './package/components/tabs/utils/version-diff-snapshot';

package/dist/index.es.js

@@ -1,12 +1,15 @@
-import { D as e, a as o, E as d, P as t, d as r, h as i, m as n, c as E, u as l } from "./index-DYlSDaET.mjs";
+import { D as e, a as o, E as t, P as d, f as r, h as i, m as n, e as E, c as m, d as u, u as C, v as l } from "./index-CM9WymRI.mjs";
 export {
   e as DdocEditor,
   o as DdocExportModal,
-  d as Editor,
-  t as PreviewDdocEditor,
+  t as Editor,
+  d as PreviewDdocEditor,
   r as buildVersionDiffSnapshot,
   i as handleContentPrint,
   n as mergeTabAwareYjsUpdates,
-  E as useExportHeadlessEditorContent,
-  l as useHeadlessEditor
+  E as sanitizeCustomCss,
+  m as useEditorCommands,
+  u as useExportHeadlessEditorContent,
+  C as useHeadlessEditor,
+  l as validateCustomCss
 };

package/dist/{markdown-source-pane-ve9MJKFE.mjs → markdown-source-pane-PIk1fw5v.mjs}

@@ -1,9 +1,9 @@
 var Vr = Object.defineProperty;
 var Wr = (t, e, O) => e in t ? Vr(t, e, { enumerable: !0, configurable: !0, writable: !0, value: O }) : t[e] = O;
 var gt = (t, e, O) => Wr(t, typeof e != "symbol" ? e + "" : e, O);
-import { j as Cr } from "./index-DYlSDaET.mjs";
+import { j as Cr } from "./index-CM9WymRI.mjs";
 import { useRef as pe, useEffect as St } from "react";
-import { s as y, A as pO, T as dO, a as Gr, S as et, b as Lr, P as fO, E as j, i as QO, c as _, D as le, k as tt, F as Ar, M as Pt, W as Er, R as Ur, d as mO, N as oe, e as V, f as Mr, g as Ot, h as ce, p as $O, j as Y, t as h, l as Ir, I as rt, L as at, m as ye, n as ue, o as Qe, q as gO, r as te, u as SO, v as Br, w as Nr, x as PO, y as kO, z as Dr, B as Fr, C as Kr, G as Oe, H as ZO, J as Jr, K as kt, O as Hr, Q as ea, U as ta, V as Oa, X as ra, Y as aa, Z as ia, _ as sa, $ as na, a0 as la, a1 as oa, a2 as ca } from "./index-BfVM4ukb.mjs";
+import { s as y, A as pO, T as dO, a as Gr, S as et, b as Lr, P as fO, E as j, i as QO, c as _, D as le, k as tt, F as Ar, M as Pt, W as Er, R as Ur, d as mO, N as oe, e as V, f as Mr, g as Ot, h as ce, p as $O, j as Y, t as h, l as Ir, I as rt, L as at, m as ye, n as ue, o as Qe, q as gO, r as te, u as SO, v as Br, w as Nr, x as PO, y as kO, z as Dr, B as Fr, C as Kr, G as Oe, H as ZO, J as Jr, K as kt, O as Hr, Q as ea, U as ta, V as Oa, X as ra, Y as aa, Z as ia, _ as sa, $ as na, a0 as la, a1 as oa, a2 as ca } from "./index-QQcgsp20.mjs";
 class ua {
   /**
   Create a new completion context. (Mostly useful for testing

package/dist/package/components/editor-bubble-menu/types.d.ts

@@ -30,7 +30,6 @@ export type EditorBubbleMenuProps = Omit<BubbleMenuProps, 'children'> & {
         file: File;
     }>;
     fetchV1ImageFn?: (url: string) => Promise<ArrayBuffer | undefined>;
-    enableCollaboration?: boolean;
     isCollabDocOwner?: boolean;
 };
 export interface NodeSelectorProps {

package/dist/package/components/editor-utils.d.ts

@@ -22,30 +22,7 @@ type PickerEntry = {
 };
 export declare const baselineFonts: PickerEntry[];
 export declare function buildPickerEntries(consumerFonts: FontDescriptor[]): PickerEntry[];
-export declare const FONT_SIZES: readonly [8, 9, 10, 11, 12, 14, 16, 18, 24, 30, 32, 36, 48, 60, 72, 96];
-export declare const getFontSizeOptions: (editor?: Editor) => {
-    title: string;
-    value: string;
-    label: string;
-    command: (editor: Editor) => void;
-    isActive: () => boolean | undefined;
-}[];
-export declare const getCurrentFontSize: (editor: Editor | null, currentSize: string) => string;
-export declare const uiValueToPercentage: (uiValue: string) => string;
-export declare const percentageToUiValue: (percentage: string) => string;
-export declare const LINE_HEIGHT_OPTIONS: {
-    value: string;
-    label: string;
-    uiValue: string;
-    description: string;
-}[];
-export declare const getLineHeightOptions: () => {
-    value: string;
-    label: string;
-    uiValue: string;
-    description: string;
-}[];
-export declare const getCurrentLineHeight: (editor: Editor | null, currentLineHeight?: string) => string;
+export * from '../utils/typography';
 export declare const ERR_MSG_MAP: {
     IMAGE_SIZE: string;
 };
@@ -184,4 +161,3 @@ export declare const checkActiveListsAndDBlocks: (editor: Editor) => {
     state: import('prosemirror-state').EditorState;
     hasMultipleLists: boolean;
 };
-export {};

package/dist/package/components/inline-comment/comment-drawer-desktop.d.ts

@@ -9,7 +9,6 @@ interface CommentDrawerDesktopProps {
     commentType: string;
     commentTypeOptions: DrawerSelectOption[];
     filteredComments: IComment[];
-    isCollaborationEnabled: boolean;
     isCommentTypeSelectOpen: boolean;
     isConnected: boolean;
     isNavbarVisible: boolean;
@@ -31,5 +30,5 @@ interface CommentDrawerDesktopProps {
     tabList: DrawerSelectOption[];
     tabNameById: Record<string, string>;
 }
-export declare const CommentDrawerDesktop: ({ activeCommentId, commentType, commentTypeOptions, filteredComments, isCollaborationEnabled, isCommentTypeSelectOpen, isConnected, isNavbarVisible, isOpen, isPresentationMode, isPreviewMode, isTabSelectOpen, newCommentTabId, onClose, onCommentFocus, onCommentTypeChange, onCommentTypeSelectOpenChange, onReset, onTabChange, onTabSelectOpenChange, sectionLabel, selectedTab, selectedTabLabel, tabList, tabNameById, }: CommentDrawerDesktopProps) => import("react/jsx-runtime").JSX.Element;
+export declare const CommentDrawerDesktop: ({ activeCommentId, commentType, commentTypeOptions, filteredComments, isCommentTypeSelectOpen, isConnected, isNavbarVisible, isOpen, isPresentationMode, isPreviewMode, isTabSelectOpen, newCommentTabId, onClose, onCommentFocus, onCommentTypeChange, onCommentTypeSelectOpenChange, onReset, onTabChange, onTabSelectOpenChange, sectionLabel, selectedTab, selectedTabLabel, tabList, tabNameById, }: CommentDrawerDesktopProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/package/components/inline-comment/comment-drawer-mobile.d.ts

@@ -9,7 +9,6 @@ interface CommentDrawerMobileProps {
     canGoToNextMobileComment: boolean;
     canGoToPreviousMobileComment: boolean;
     comments: IComment[];
-    isCollaborationEnabled: boolean;
     isCommentMobileFocused: boolean;
     isConnected: boolean;
     isDiscardCommentOverlayVisible: boolean;
@@ -39,5 +38,5 @@ interface CommentDrawerMobileProps {
     tabNameById: Record<string, string>;
     username: string | null;
 }
-export declare const CommentDrawerMobile: ({ activeCommentId, activeDraft, activeDraftId, activeSuggestionDraftCard, canGoToNextMobileComment, canGoToPreviousMobileComment, comments, isCollaborationEnabled, isCommentMobileFocused, isConnected, isDiscardCommentOverlayVisible, isDiscardSuggestionOverlayVisible, isInlineDraftOpen, isMobileDrawerVisible, isNavbarVisible, isPresentationMode, mobileActiveCommentsCount, mobileDraftRef, mobileFocusedCommentIndex, onAttemptCloseNewComment, onAttemptCloseSuggestionDraft, onCancelDiscardComment, onCancelDiscardSuggestion, onCloseDrawer, onCommentFocus, onCreateComment, onDiscardSuggestionDraft, onFocusSuggestionDraft, onNextMobileComment, onPreviousMobileComment, onStartNewMobileComment, onSubmitSuggestionDraft, onUpdateInlineDraftText, onViewAllComments, tabNameById, username, }: CommentDrawerMobileProps) => import("react/jsx-runtime").JSX.Element;
+export declare const CommentDrawerMobile: ({ activeCommentId, activeDraft, activeDraftId, activeSuggestionDraftCard, canGoToNextMobileComment, canGoToPreviousMobileComment, comments, isCommentMobileFocused, isConnected, isDiscardCommentOverlayVisible, isDiscardSuggestionOverlayVisible, isInlineDraftOpen, isMobileDrawerVisible, isNavbarVisible, isPresentationMode, mobileActiveCommentsCount, mobileDraftRef, mobileFocusedCommentIndex, onAttemptCloseNewComment, onAttemptCloseSuggestionDraft, onCancelDiscardComment, onCancelDiscardSuggestion, onCloseDrawer, onCommentFocus, onCreateComment, onDiscardSuggestionDraft, onFocusSuggestionDraft, onNextMobileComment, onPreviousMobileComment, onStartNewMobileComment, onSubmitSuggestionDraft, onUpdateInlineDraftText, onViewAllComments, tabNameById, username, }: CommentDrawerMobileProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/package/components/inline-comment/comment-drawer.d.ts

@@ -1,3 +1,3 @@
 import { CommentDrawerProps } from './types';
 
-export declare const CommentDrawer: ({ isOpen, onClose, isNavbarVisible, isPresentationMode, activeCommentId, activeTabId, onTabChange, isPreviewMode, tabs, isCollaborationEnabled, }: CommentDrawerProps) => import("react/jsx-runtime").JSX.Element;
+export declare const CommentDrawer: ({ isOpen, onClose, isNavbarVisible, isPresentationMode, activeCommentId, activeTabId, onTabChange, isPreviewMode, tabs, }: CommentDrawerProps) => import("react/jsx-runtime").JSX.Element;

package/dist/package/components/inline-comment/comment-input-field.d.ts

@@ -1,4 +1,3 @@
-export declare const CommentInputField: ({ tabId, isCollaborationEnabled, }: {
+export declare const CommentInputField: ({ tabId }: {
     tabId?: string;
-    isCollaborationEnabled: boolean;
 }) => import("react/jsx-runtime").JSX.Element;

package/dist/package/components/inline-comment/comment-reply-input.d.ts

@@ -2,7 +2,6 @@ interface CommentReplyInputProps {
     commentId: string;
     commentUsername?: string;
     replyCount: number;
-    isCollaborationEnabled: boolean;
 }
-export declare const CommentReplyInput: ({ commentId, replyCount, isCollaborationEnabled, commentUsername, }: CommentReplyInputProps) => import("react/jsx-runtime").JSX.Element;
+export declare const CommentReplyInput: ({ commentId, replyCount, commentUsername, }: CommentReplyInputProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/package/components/inline-comment/comment-section.d.ts

@@ -1,3 +1,3 @@
 import { CommentSectionProps } from './types';
 
-export declare const CommentSection: ({ activeCommentId, isNavbarVisible, isPresentationMode, isMobile, comments: commentsProp, commentType, tabNameById, selectedTabLabel, newCommentTabId, showNewCommentInput, onCommentFocus, onReset, isCollaborationEnabled, }: CommentSectionProps) => import("react/jsx-runtime").JSX.Element;
+export declare const CommentSection: ({ activeCommentId, isNavbarVisible, isPresentationMode, isMobile, comments: commentsProp, commentType, tabNameById, selectedTabLabel, newCommentTabId, showNewCommentInput, onCommentFocus, onReset, }: CommentSectionProps) => import("react/jsx-runtime").JSX.Element;

package/dist/package/components/inline-comment/floating-comment/comment-floating-container.d.ts

@@ -1,3 +1,3 @@
 import { CommentFloatingContainerProps } from './types';
 
-export declare const CommentFloatingContainer: ({ editor, editorWrapperRef, scrollContainerRef, tabName, isHidden, isCollaborationEnabled, }: CommentFloatingContainerProps) => import("react/jsx-runtime").JSX.Element | null;
+export declare const CommentFloatingContainer: ({ editor, editorWrapperRef, scrollContainerRef, tabName, isHidden, }: CommentFloatingContainerProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/package/components/inline-comment/floating-comment/suggestion-thread-floating-card.d.ts

@@ -12,4 +12,4 @@ import { ThreadFloatingCardProps } from './types';
  * uses — so once a draft is submitted, nothing else in the pipeline needs
  * to change to show the suggestion here.
  */
-export declare const SuggestionThreadFloatingCard: ({ thread, comment, isHidden, registerCardNode, isCollaborationEnabled, }: ThreadFloatingCardProps) => import("react/jsx-runtime").JSX.Element | null;
+export declare const SuggestionThreadFloatingCard: ({ thread, comment, isHidden, registerCardNode, }: ThreadFloatingCardProps) => import("react/jsx-runtime").JSX.Element | null;

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

@@ -1,3 +1,3 @@
 import { ThreadFloatingCardProps } from './types';
 
-export declare const ThreadFloatingCard: ({ thread, comment, tabName, isHidden, registerCardNode, isCollaborationEnabled, }: ThreadFloatingCardProps) => import("react/jsx-runtime").JSX.Element;
+export declare const ThreadFloatingCard: ({ thread, comment, tabName, isHidden, registerCardNode, }: ThreadFloatingCardProps) => import("react/jsx-runtime").JSX.Element;

package/dist/package/components/inline-comment/floating-comment/types.d.ts

@@ -10,7 +10,6 @@ export interface CommentFloatingContainerProps {
     scrollContainerRef: RefObject<HTMLDivElement>;
     tabName: string;
     isHidden: boolean;
-    isCollaborationEnabled?: boolean;
 }
 export interface FloatingCardShellProps {
     floatingCardId: string;
@@ -30,7 +29,6 @@ export interface ThreadFloatingCardProps {
     tabName: string;
     isHidden: boolean;
     registerCardNode: RegisterCardNode;
-    isCollaborationEnabled?: boolean;
 }
 export interface SuggestionDraftFloatingCardProps {
     card: SuggestionFloatingDraftCard;

package/dist/package/components/inline-comment/types.d.ts

@@ -36,7 +36,6 @@ export interface CommentDrawerProps {
     onTabChange?: (tabId: string) => void;
     isPreviewMode: boolean;
     tabs: Tab[];
-    isCollaborationEnabled: boolean;
 }
 export interface CommentCardProps extends IComment {
     comment?: string;
@@ -87,7 +86,6 @@ export interface CommentSectionProps {
     showNewCommentInput?: boolean;
     onCommentFocus?: (commentId: string, tabId?: string) => void;
     onReset?: () => void;
-    isCollaborationEnabled: boolean;
 }
 export interface UserDisplayProps {
     username: string;

package/dist/package/components/split-view/split-view-css-accordion.d.ts

@@ -0,0 +1,13 @@
+interface SplitViewCssAccordionProps {
+    /** The document's custom CSS (raw author selectors). */
+    customCSS?: string;
+}
+/**
+ * Split View LEFT pane: a collapsible, READ-ONLY view of the document's custom
+ * CSS, shown above the markdown source. Custom CSS is edited in the styling
+ * palette (the single source of truth), not in the markdown pane — this is a
+ * transparency affordance so the author can see what CSS is applied while in
+ * markdown mode. Renders nothing when there is no custom CSS.
+ */
+export declare const SplitViewCssAccordion: ({ customCSS, }: SplitViewCssAccordionProps) => import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/package/components/split-view/split-view-markdown-pane.d.ts

@@ -6,6 +6,8 @@ interface SplitViewMarkdownPaneProps {
     /** Same uploader the editor uses — for the markdown toolbar's Image button. */
     ipfsImageUploadFn?: (file: File) => Promise<IpfsImageUploadResponse>;
     onError?: (error: string) => void;
+    /** Document custom CSS — shown read-only in a collapsible accordion. */
+    customCSS?: string;
     /** Sizing for the resizable split (flex-grow set by the draggable splitter). */
     style?: React.CSSProperties;
 }
@@ -15,5 +17,5 @@ interface SplitViewMarkdownPaneProps {
  * real ddoc editor itself — see ddoc-editor.tsx, which keeps that editor mounted
  * in place (never a second <EditorContent>) so its React node views survive.
  */
-export declare const SplitViewMarkdownPane: ({ markdown, onMarkdownChange, ipfsImageUploadFn, onError, style, }: SplitViewMarkdownPaneProps) => import("react/jsx-runtime").JSX.Element;
+export declare const SplitViewMarkdownPane: ({ markdown, onMarkdownChange, ipfsImageUploadFn, onError, customCSS, style, }: SplitViewMarkdownPaneProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/package/extensions/mardown-paste-handler/index.d.ts

@@ -5,7 +5,13 @@ import { IpfsImageFetchPayload, IpfsImageUploadResponse } from '../../types';
 
 export declare const turndownService: TurndownService;
 export declare const setMarkdownInlineStyles: (enabled: boolean) => void;
+export declare const setResolveColorVars: (enabled: boolean) => void;
 declare module '@tiptap/core' {
+    interface Storage {
+        markdownPasteHandler: {
+            customCSS: string;
+        };
+    }
     interface Commands {
         uploadMarkdownFile: {
             uploadMarkdownFile: (ipfsImageUploadFn?: (file: File) => Promise<IpfsImageUploadResponse>, onError?: (error: string) => void) => any;

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

@@ -0,0 +1,20 @@
+import { Editor } from '@tiptap/react';
+import { UploadImageOptions } from '../utils/insert-commands';
+
+export type EditorCommand = {
+    run: (arg?: string) => void;
+    isActive?: boolean;
+    isEnabled: boolean;
+    current?: string | null;
+};
+export type EditorCommandId = 'edit.undo' | 'edit.redo' | 'edit.selectAll' | 'edit.cut' | 'edit.copy' | 'edit.paste' | 'edit.pasteWithoutFormatting' | 'edit.delete' | 'edit.findReplace' | 'insert.image' | 'insert.table' | 'insert.link' | 'insert.comment' | 'insert.callout' | 'insert.quote' | 'insert.code' | 'insert.codeBlock' | 'insert.video' | 'insert.mermaid' | 'insert.plainText' | 'insert.tweet' | 'insert.soundcloud' | 'insert.divider' | 'insert.pageBreak' | 'insert.columns2' | 'insert.columns3' | 'format.bold' | 'format.italic' | 'format.underline' | 'format.strike' | 'format.superscript' | 'format.subscript' | 'format.heading' | 'format.align' | 'format.direction' | 'format.lineHeight' | 'format.fontFamily' | 'format.fontSize.increase' | 'format.fontSize.decrease' | 'format.list.bullet' | 'format.list.numbered' | 'format.list.check' | 'format.clearFormatting' | 'table.addRowAbove' | 'table.addRowBelow' | 'table.mergeCells' | 'table.deleteRow' | 'table.addColumnLeft' | 'table.addColumnRight' | 'table.deleteColumn' | 'table.toggleHeaderRow' | 'table.toggleHeaderColumn' | 'table.toggleHeaderCell' | 'table.deleteTable';
+export type UseEditorCommandsOptions = UploadImageOptions;
+/**
+ * Reactive, editor-derived command registry (architecture doc §2 bucket 1).
+ * INVARIANT: all isActive/current/isEnabled values are derived from the
+ * editor via `useEditorState` (Tiptap's useSyncExternalStore wrapper) — the
+ * hook holds no authoritative state of its own, so any number of instances
+ * stay in sync, and consumers only re-render when a derived value changes
+ * (deep-equality gated), not on every transaction.
+ */
+export declare const useEditorCommands: (editor: Editor | null, options?: UseEditorCommandsOptions) => Record<EditorCommandId, EditorCommand>;

package/dist/package/hooks/use-focus-mode.d.ts

@@ -1,7 +1,12 @@
 type UseFocusModeOptions = {
+    /** Notify callback — fires on every toggle in both modes (existing API). */
     onFocusMode?: (isFocusMode: boolean) => void;
+    /** Controlled value (D6). Omit for the legacy internal-state behavior. */
+    isFocusMode?: boolean;
+    /** Controlled setter — receives the next value instead of internal mutation. */
+    onFocusModeChange?: (isFocusMode: boolean) => void;
 };
-export declare const useFocusMode: ({ onFocusMode }?: UseFocusModeOptions) => {
+export declare const useFocusMode: ({ onFocusMode, isFocusMode: controlledValue, onFocusModeChange, }?: UseFocusModeOptions) => {
     isFocusMode: boolean;
     toggleFocusMode: () => Promise<void>;
 };

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

@@ -1,4 +1,4 @@
-import { Editor, JSONContent } from '@tiptap/react';
+import { AnyExtension, Editor, JSONContent } from '@tiptap/react';
 import { handleMarkdownContent } from '../extensions/mardown-paste-handler';
 import { IpfsImageUploadResponse } from '../types';
 
@@ -6,6 +6,14 @@ import * as Y from 'yjs';
 export interface UseHeadlessEditorProps {
     optionalExtensions?: string[];
 }
+/**
+ * The exact extension set the headless editor runs with. Exported so tests
+ * can build an equivalent editor without the hook.
+ */
+export declare const getHeadlessExtensions: (options?: {
+    ydoc?: Y.Doc;
+    optionalExtensions?: string[];
+}) => AnyExtension[];
 export declare const useHeadlessEditor: (props?: UseHeadlessEditorProps) => {
     setContent: (initialContent: string | string[] | JSONContent, editor: Editor, ydoc: Y.Doc) => void;
     getEditor: () => {

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

@@ -17,7 +17,6 @@ interface UseTabEditorArgs {
     initialContent: DdocProps['initialContent'];
     collaboration?: CollaborationProps;
     isReady?: boolean;
-    isSyncing?: boolean;
     awareness?: any;
     disableInlineComment?: boolean;
     isFocusMode?: boolean;
@@ -43,8 +42,9 @@ interface UseTabEditorArgs {
     isPresentationMode?: boolean;
     onInvalidContentError?: DdocProps['onInvalidContentError'];
     ignoreCorruptedData?: boolean;
-    onCollaboratorChange?: DdocProps['onCollaboratorChange'];
     onConnect: (connectConfig: CollabConnectionConfig) => void;
+    onDisconnect: () => void;
+    isIndexeddbSynced: boolean;
     hasCollabContentInitialised?: boolean;
     initialiseYjsIndexedDbProvider: () => Promise<void>;
     externalExtensions?: Record<string, AnyExtension>;
@@ -56,7 +56,7 @@ interface UseTabEditorArgs {
     initialCommentAnchors?: SerializedCommentAnchor[];
     dBlockRuntimeStateRef?: DBlockRuntimeStateRef;
 }
-export declare const useTabEditor: ({ ydoc, isVersionMode, hasTabState, versionId, isPreviewMode, viewerMode, initialContent, collaboration, isReady, isSyncing, awareness, disableInlineComment, isFocusMode, onCommentInteraction, onError, ipfsImageUploadFn, metadataProxyUrl, onCopyHeadingLink, ipfsImageFetchFn, fetchV1ImageFn, isConnected, activeModel, maxTokens, isAIAgentEnabled, setCharacterCount, setWordCount, setSelectedWordCount, setPageCount, setIsContentLoading, setIsCollabContentLoading, unFocused, zoomLevel, isPresentationMode, onInvalidContentError, ignoreCorruptedData, onCollaboratorChange, onConnect, hasCollabContentInitialised, initialiseYjsIndexedDbProvider, externalExtensions, isContentLoading, activeTabId, tabIds, theme, editorRef, initialCommentAnchors, dBlockRuntimeStateRef, }: UseTabEditorArgs) => {
+export declare const useTabEditor: ({ ydoc, isVersionMode, hasTabState, versionId, isPreviewMode, viewerMode, initialContent, collaboration, isReady, awareness, disableInlineComment, isFocusMode, onCommentInteraction, onError, ipfsImageUploadFn, metadataProxyUrl, onCopyHeadingLink, ipfsImageFetchFn, fetchV1ImageFn, isConnected, activeModel, maxTokens, isAIAgentEnabled, setCharacterCount, setWordCount, setSelectedWordCount, setPageCount, setIsContentLoading, setIsCollabContentLoading, unFocused, zoomLevel, isPresentationMode, onInvalidContentError, ignoreCorruptedData, onConnect, onDisconnect, isIndexeddbSynced, hasCollabContentInitialised, initialiseYjsIndexedDbProvider, externalExtensions, isContentLoading, activeTabId, tabIds, theme, editorRef, initialCommentAnchors, dBlockRuntimeStateRef, }: UseTabEditorArgs) => {
     editor: Editor | null;
     cachedEditorEntries: import('./use-tab-editor-cache').CachedTabEditorRenderEntry[];
     ref: import('react').RefObject<HTMLDivElement>;

package/dist/package/hooks/use-yjs-setup.d.ts

@@ -6,14 +6,20 @@ interface UseYjsSetupArgs {
     enableIndexeddbSync?: boolean;
     ddocId?: string;
     collaboration?: CollaborationProps;
+    onCollaboratorChange?: DdocProps['onCollaboratorChange'];
     onIndexedDbError?: (error: Error) => void;
 }
-export declare const useYjsSetup: ({ onChange, enableIndexeddbSync, ddocId, collaboration, onIndexedDbError, }: UseYjsSetupArgs) => {
+export declare const useYjsSetup: ({ onChange, enableIndexeddbSync, ddocId, collaboration, onCollaboratorChange, onIndexedDbError, }: UseYjsSetupArgs) => {
     ydoc: Y.Doc;
     onConnect: (connectConfig: import('../types').CollabConnectionConfig) => void;
+    onDisconnect: () => void;
     isReady: boolean;
     isSyncing: boolean;
     terminateSession: () => void;
+    updateTitle: (args: {
+        encryptedTitle: string;
+        documentTitle: string;
+    }) => void;
     awareness: import('y-protocols/awareness.js').Awareness | null;
     hasCollabContentInitialised: boolean;
     isIndexeddbSynced: boolean;

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

@@ -44,9 +44,11 @@ export interface CommentStoreProviderProps {
     isConnected?: boolean;
     isLoading?: boolean;
     isDDocOwner?: boolean;
+    /** Inline comments usable — see ddoc-editor.tsx's derivation. */
+    isInlineCommentAvailable?: 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, onDeleteReply, onInlineComment, onComment, setCommentDrawerOpen, connectViaWallet, connectViaUsername, ensResolutionUrl, commentAnchorsRef, draftAnchorsRef, storeApiRef, initialCommentAnchors, setUsername: setUsernameProp, initialComments, username, activeCommentId, activeTabId, isConnected, isLoading, isDDocOwner, }: CommentStoreProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const CommentStoreProvider: ({ children, editor, ydoc, isFocusMode, setActiveCommentId, focusCommentWithActiveId, setInitialComments, onNewComment, onEditComment, onEditReply, onCommentReply, onResolveComment, onUnresolveComment, onDeleteComment, onDeleteReply, onInlineComment, onComment, setCommentDrawerOpen, connectViaWallet, connectViaUsername, ensResolutionUrl, commentAnchorsRef, draftAnchorsRef, storeApiRef, initialCommentAnchors, setUsername: setUsernameProp, initialComments, username, activeCommentId, activeTabId, isConnected, isLoading, isDDocOwner, isInlineCommentAvailable, }: CommentStoreProviderProps) => import("react/jsx-runtime").JSX.Element;
 interface CommentRefsContextType {
     commentsSectionRef: React.RefObject<HTMLDivElement>;
     replySectionRef: React.RefObject<HTMLDivElement>;

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

@@ -108,6 +108,10 @@ export interface CommentStoreState {
     isConnected: boolean;
     isLoading: boolean;
     isDDocOwner: boolean;
+    /** Inline comments usable at all (not RTC, published, not disabled) —
+     *  synced from CommentStoreProvider's prop; drives insert.comment
+     *  enablement in useEditorCommands. */
+    isInlineCommentAvailable: boolean;
     onComment: (() => void) | null;
     setCommentDrawerOpen: ((open: boolean) => void) | null;
     connectViaWallet: (() => Promise<void>) | null;
@@ -146,6 +150,7 @@ export interface CommentStoreState {
     setIsConnected: (connected: boolean) => void;
     setIsLoading: (loading: boolean) => void;
     setIsDDocOwner: (isOwner: boolean) => void;
+    setIsInlineCommentAvailable: (value: boolean) => void;
     setOnComment: (fn: (() => void) | null) => void;
     setCommentDrawerOpenFn: (fn: ((open: boolean) => void) | null) => void;
     setConnectViaWallet: (fn: (() => Promise<void>) | null) => void;
@@ -284,4 +289,14 @@ export interface CommentStoreState {
 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;
+/**
+ * Non-throwing variant of useCommentStore: returns undefined when no
+ * CommentStoreProvider is above the caller (e.g. useEditorCommands used
+ * outside DdocEditor). The selector's RETURN VALUE must be Object.is-stable
+ * for unchanged state (primitives or refs already held by the store) —
+ * useSyncExternalStore compares snapshots with Object.is, so a selector
+ * that constructs a fresh object/array per call would re-render forever.
+ * Selector function identity itself doesn't matter.
+ */
+export declare function useCommentStoreOptional<T>(selector: (state: CommentStoreState) => T): T | undefined;
 export {};

package/dist/package/sync-local/SyncManager.d.ts

@@ -9,32 +9,47 @@ export declare class SyncManager {
     private socketClient;
     private roomKey;
     private roomKeyBytes;
+    private encryptMirror;
+    private fileKeyEpoch;
+    private mirrorIdleTimer;
+    private readonly MIRROR_IDLE_MS;
     private isOwner;
+    private joinOnly;
     private updateQueue;
-    private uncommittedUpdatesIdList;
     private contentTobeAppliedQueue;
     private isProcessing;
+    private syncId;
+    private floor;
+    private updatesSinceSnapshot;
+    private isAuthoringSnapshot;
+    private readonly SNAPSHOT_THRESHOLD;
     private flushTimer;
     private readonly FLUSH_INTERVAL_MS;
     private readonly MAX_QUEUE_SIZE;
     private _awarenessUpdateHandler;
     private ydoc;
-    private servicesRef;
     private callbacksRef;
     private onLocalUpdate?;
     constructor(config: SyncManagerConfig, onCollabStateChange: (state: CollabState) => void);
     /** Called by useSyncManager on every render to keep refs fresh */
-    updateRefs(services: CollabServices | undefined, callbacks: CollabCallbacks | undefined, onLocalUpdate?: (updatedDocContent: string, updateChunk: string) => void): void;
+    updateRefs(_services: CollabServices | undefined, callbacks: CollabCallbacks | undefined, onLocalUpdate?: (updatedDocContent: string, updateChunk: string) => void): void;
     get isConnected(): boolean;
     get isReady(): boolean;
     get awareness(): Awareness | null;
     get status(): CollabStatus;
     get collabState(): CollabState;
+    private beginSyncAttempt;
+    private isCurrentSyncAttempt;
     private send;
     private runExitActions;
     private runEntryActions;
     connect(config: CollabConnectionConfig): Promise<void>;
     disconnect(): Promise<void>;
+    /** Owner rename mid-session — see SocketClient.updateDocumentMeta. */
+    updateTitle(args: {
+        encryptedTitle: string;
+        documentTitle: string;
+    }): Promise<void>;
     terminateSession(): Promise<void>;
     enqueueLocalUpdate(update: Uint8Array): void;
     private flushUpdates;
@@ -43,21 +58,29 @@ export declare class SyncManager {
      * 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;
+    private isRevocationResponse;
+    private classifyRevocation;
+    private handleWriteRevocation;
+    private maybeAuthorSnapshotAfterSend;
+    private scheduleMirror;
+    private authorMirror;
+    buildPendingBeaconPayload(): string | null;
+    fireBeacon(): void;
     forceCleanup(): void;
     private handleConnectionError;
     private handleReconnection;
     private connectSocket;
-    private syncLatestCommit;
+    private decodeInto;
+    private catchUpFloor;
+    private authorSnapshot;
+    private hydrate;
     private initializeAwareness;
     private cleanupAwareness;
-    private commitLocalContents;
     private broadcastLocalContents;
     private processUpdateQueue;
     private processNextUpdate;
-    private processCommit;
     private handleRemoteContentUpdate;
     private applyRemoteYjsUpdate;
     private applyQueuedRemoteContents;

package/dist/package/sync-local/floor.d.ts

@@ -0,0 +1,6 @@
+export declare function advanceFloor(floor: number, pageSeqsAscending: number[]): number;
+export declare function shouldAuthorSnapshot(p: {
+    isOwner: boolean;
+    updatesSinceLastSnapshot: number;
+    threshold: number;
+}): boolean;

package/dist/package/sync-local/presence.d.ts

@@ -0,0 +1,11 @@
+import { IDocCollabUsers } from '../types';
+
+export interface AwarenessIdentity {
+    name: string;
+    color: string;
+    isEns: string | boolean;
+}
+export declare const PLACEHOLDER_COLOR = "#9CA3AF";
+export declare function buildIdentityMap(states: Map<number, Record<string, unknown>>): Map<string, AwarenessIdentity>;
+export declare function mergePresence(roomMembers: string[], identityBySocketId: Map<string, AwarenessIdentity>): IDocCollabUsers[];
+export declare function identitySignature(roomMembers: string[], identityBySocketId: Map<string, AwarenessIdentity>): string;