@fileverse-dev/ddoc 4.1.12 → 4.2.0-durability-1

package/dist/{index-C4IzZi0k.mjs → index-CioSbJ2V.mjs}

@@ -1,4 +1,4 @@
-import { k as Ql, b as Zl, s as eh } from "./index-wRSSphoI.mjs";
+import { k as Ql, b as Zl, s as eh } from "./index-BREkA3S3.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,6 +3,8 @@ 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';

package/dist/index.es.js

@@ -1,4 +1,4 @@
-import { D as e, a as o, E as t, P as d, e as r, h as i, m as n, d as E, c as l, u, v as C } from "./index-wRSSphoI.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-BREkA3S3.mjs";
 export {
   e as DdocEditor,
   o as DdocExportModal,
@@ -8,7 +8,8 @@ export {
   i as handleContentPrint,
   n as mergeTabAwareYjsUpdates,
   E as sanitizeCustomCss,
-  l as useExportHeadlessEditorContent,
-  u as useHeadlessEditor,
-  C as validateCustomCss
+  m as useEditorCommands,
+  u as useExportHeadlessEditorContent,
+  C as useHeadlessEditor,
+  l as validateCustomCss
 };

package/dist/{markdown-source-pane-QRkiwIcH.mjs → markdown-source-pane-yIzyW1Ll.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-wRSSphoI.mjs";
+import { j as Cr } from "./index-BREkA3S3.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-C4IzZi0k.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-CioSbJ2V.mjs";
 class ua {
   /**
   Create a new completion context. (Mostly useful for testing

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/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;
@@ -45,6 +44,8 @@ interface UseTabEditorArgs {
     ignoreCorruptedData?: boolean;
     onCollaboratorChange?: DdocProps['onCollaboratorChange'];
     onConnect: (connectConfig: CollabConnectionConfig) => void;
+    onDisconnect: () => void;
+    isIndexeddbSynced: boolean;
     hasCollabContentInitialised?: boolean;
     initialiseYjsIndexedDbProvider: () => Promise<void>;
     externalExtensions?: Record<string, AnyExtension>;
@@ -56,7 +57,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, onCollaboratorChange, 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

@@ -11,6 +11,7 @@ interface UseYjsSetupArgs {
 export declare const useYjsSetup: ({ onChange, enableIndexeddbSync, ddocId, collaboration, onIndexedDbError, }: UseYjsSetupArgs) => {
     ydoc: Y.Doc;
     onConnect: (connectConfig: import('../types').CollabConnectionConfig) => void;
+    onDisconnect: () => void;
     isReady: boolean;
     isSyncing: boolean;
     terminateSession: () => void;

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

@@ -11,21 +11,23 @@ export declare class SyncManager {
     private roomKeyBytes;
     private isOwner;
     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;
@@ -46,21 +48,24 @@ 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 maybeAuthorSnapshotAfterSend;
+    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/socketClient.d.ts

@@ -1,4 +1,4 @@
-import { ISocketInitConfig, RoomMember, SocketStatusEnum, SendUpdateResponse, CommitResponse, AckResponse } from './types';
+import { ISocketInitConfig, RoomMember, SocketStatusEnum, SendUpdateResponse, HydrationResponse, SnapshotResponse, AckResponse } from './types';
 import { Awareness } from 'y-protocols/awareness.js';
 
 interface ISocketClientConfig {
@@ -8,6 +8,11 @@ interface ISocketClientConfig {
     ownerEdSecret?: string;
     contractAddress?: string;
     ownerAddress?: string;
+    ownerIdentityDid?: string;
+    editLock?: string;
+    encryptedTitle?: string;
+    identityToken?: string;
+    identityContractAddress?: string;
     onHandshakeData?: (response: {
         data: AckResponse;
         roomKey: string;
@@ -20,6 +25,8 @@ interface ISocketClientConfig {
 }
 export declare class SocketClient {
     private _socketUrl;
+    private _restBase;
+    private _lastSessionToken;
     private _socket;
     private _webSocketStatus;
     private _isIntentionalDisconnect;
@@ -34,6 +41,11 @@ export declare class SocketClient {
     private ownerUcan?;
     private collaborationUcan?;
     private ownerAddress?;
+    private ownerIdentityDid?;
+    private editLock?;
+    private encryptedTitle?;
+    private identityToken?;
+    private identityContractAddress?;
     private roomKey;
     private roomInfo?;
     private awareness;
@@ -46,15 +58,17 @@ export declare class SocketClient {
     sendUpdate({ update }: {
         update: string;
     }): Promise<SendUpdateResponse>;
-    commitUpdates({ updates, cid }: {
-        updates: string[];
-        cid: string;
-    }): Promise<CommitResponse>;
-    fetchLatestCommit(): Promise<AckResponse<any>>;
-    getUncommittedChanges(): Promise<AckResponse<any>>;
+    fetchHydrationRange(sinceSeq?: number): Promise<HydrationResponse>;
+    sendSnapshot({ data, floorSeq, publishedMarker, }: {
+        data: string;
+        floorSeq: number;
+        publishedMarker?: string | null;
+    }): Promise<SnapshotResponse>;
+    setDocumentMeta(): Promise<void>;
     broadcastAwareness(awarenessUpdate: string): Promise<void>;
     disconnect: () => void;
     terminateSession: () => Promise<void>;
+    flushBeacon(mergedUpdate: string): void;
     private getCollaborationKeyPair;
     private isUcanValid;
     private getOwnerToken;

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

@@ -7,6 +7,20 @@ export interface CollabConnectionConfig {
     roomId: string;
     wsUrl: string;
     isOwner: boolean;
+    /** Host signal: doc is in an active live-collaboration context (shared / peers present). Keeps the socket connected. */
+    livePresence?: boolean;
+    /** Host signal: connect once on open to initialise durability even without an edit. */
+    connectOnOpen?: boolean;
+    /** Host signal (owner-only): the owner identity signingKey DID. Recorded by the durable server on the first owner /auth as the R3 owner binding. */
+    ownerIdentityDid?: string;
+    /** Host signal (owner-only): wrapped roomKey bytes (owner-lock construction), uploaded as the server editLock recovery artifact. Opaque to the package. */
+    editLock?: string;
+    /** Host signal (owner-only): the document title encrypted with the roomKey, uploaded as the server title recovery artifact. Opaque to the package. */
+    encryptedTitle?: string;
+    /** Host signal (owner-only): Ed25519 UCAN proving the owner identity, sent on /auth so the server binds the CRYPTOGRAPHICALLY PROVEN owner DID (not a bare asserted string). Opaque to the package. */
+    identityToken?: string;
+    /** Host signal (owner-only): the identity contract address the server reads to resolve the on-chain signingDid that verifies identityToken. */
+    identityContractAddress?: string;
     ownerEdSecret?: string;
     contractAddress?: string;
     ownerAddress?: string;
@@ -21,11 +35,7 @@ export interface CollabSessionMeta {
     username: string;
     isEns?: boolean;
 }
-/** Storage integrations the sync engine depends on */
-export interface CollabServices {
-    commitToStorage?: (file: File) => Promise<string>;
-    fetchFromStorage?: (cid: string) => Promise<any>;
-}
+export type CollabServices = Record<string, never>;
 export type CollabErrorCode = 'CONNECTION_FAILED' | 'AUTH_FAILED' | 'SYNC_FAILED' | 'TIMEOUT' | 'UNKNOWN';
 export type CollabError = {
     code: CollabErrorCode;
@@ -145,11 +155,30 @@ export interface SendUpdateResponse extends AckResponse<{
     createdAt: number;
 }> {
 }
-export interface CommitResponse extends AckResponse<{
-    cid: string;
-    createdAt: number;
+export interface HydrationRow {
+    id: string;
     documentId: string;
-    updates: string[];
+    seq: number;
+    data: string;
+    updateType: string;
+    committed?: boolean;
+    commitCid?: string | null;
+    createdAt?: number;
+    sessionDid?: string;
+    publishedMarker?: string | null;
+    floorSeq?: number | null;
+}
+export interface HydrationResponse extends AckResponse<{
+    history: HydrationRow[];
+    total: number;
+    snapshot: HydrationRow | null;
+    nextSeq: number | null;
+    hasMore: boolean;
+}> {
+}
+export interface SnapshotResponse extends AckResponse<{
+    id: string;
+    seq: number;
 }> {
 }
 export interface ISocketInitConfig {
@@ -196,4 +225,7 @@ export interface IAuthArgs {
     contractAddress?: string;
     sessionDid?: string;
     roomInfo?: string;
+    ownerIdentityDid?: string;
+    identityToken?: string;
+    identityContractAddress?: string;
 }

package/dist/package/types.d.ts

@@ -180,8 +180,11 @@ export interface DdocProps extends CommentAccountProps {
     walletAddress?: string | null;
     username?: string | null;
     setUsername?: React.Dispatch<SetStateAction<string>>;
-    renderNavbar?: ({ editor }: {
+    renderNavbar?: ({ editor, liveEditor, }: {
+        /** JSON snapshot — legacy field, unchanged. */
         editor: JSONContent;
+        /** Live Tiptap editor instance (D8) — null until the editor is ready. */
+        liveEditor: Editor | null;
     }) => JSX.Element;
     onChange?: (updatedDocContent: string | JSONContent, updateChunk: string) => void;
     onCollaboratorChange?: (collaborators: undefined | IDocCollabUsers[]) => void;
@@ -209,6 +212,9 @@ export interface DdocProps extends CommentAccountProps {
     onComment?: () => void;
     onInlineComment?: () => void;
     onFocusMode?: (isFocusMode: boolean) => void;
+    /** Controlled focus mode (D6). Omit for the legacy internal-state behavior. */
+    isFocusMode?: boolean;
+    onFocusModeChange?: (isFocusMode: boolean) => void;
     onMarkdownExport?: () => void;
     onMarkdownImport?: () => void;
     onPdfExport?: () => void;

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

@@ -28,6 +28,7 @@ export declare const useDdocEditor: ({ isPreviewMode, viewerMode, initialContent
     duplicateTab: (tabId: string) => string | undefined;
     orderTab: (destinationTabId: string, movedTabId: string) => void;
     onConnect: (connectConfig: import('./types').CollabConnectionConfig) => void;
+    onDisconnect: () => void;
     isReady: boolean;
     isSyncing: boolean;
     hasCollabContentInitialised: boolean;

package/dist/package/utils/insert-commands.d.ts

@@ -0,0 +1,20 @@
+import { Editor, Range } from '@tiptap/core';
+import { IpfsImageUploadResponse } from '../types';
+
+type InsertCommand = (editor: Editor, range?: Range) => void;
+export type UploadImageOptions = {
+    onError?: (errorString: string) => void;
+    ipfsImageUploadFn?: (file: File) => Promise<IpfsImageUploadResponse>;
+};
+/**
+ * File-picker image upload — mirrors the toolbar flow
+ * (editor-utils.tsx "Upload Image") and the slash "Image" item.
+ */
+export declare const uploadImageCommand: (editor: Editor, { onError, ipfsImageUploadFn }?: UploadImageOptions) => void;
+/**
+ * Insert commands shared by the slash menu and `useEditorCommands`.
+ * Bodies are moved verbatim from `slash-command-utils.tsx`; the optional
+ * `range` only differs when invoked from the slash menu.
+ */
+export declare const insertCommands: Record<string, InsertCommand>;
+export {};

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

@@ -0,0 +1,9 @@
+import { Editor } from '@tiptap/react';
+
+/**
+ * Shared jsdom editor factory for unit tests (use-editor-commands.test.tsx,
+ * selection-utils.test.ts, ...). Collaboration owns the doc, so content must
+ * be set via `setContent` *after* construction — passing `content` to the
+ * `Editor` constructor is silently ignored once Collaboration is configured.
+ */
+export declare const makeEditor: (content?: string) => Editor;

package/dist/package/utils/selection-utils.d.ts

@@ -0,0 +1,35 @@
+import { Editor } from '@tiptap/core';
+
+/**
+ * Cursor-relative word range in the current textblock, or null when the
+ * cursor is not adjacent to a word character (whitespace runs, empty
+ * blocks). Position math is relative ($from.start() + parentOffset), so it
+ * is schema-agnostic (works under dBlock wrappers).
+ */
+export declare const findWordRangeAtCursor: (editor: Editor) => {
+    from: number;
+    to: number;
+} | null;
+/**
+ * Ensure a text target for anchored actions (inline comments): keep any
+ * existing non-empty TextSelection; otherwise select the word under the
+ * collapsed cursor. Shares findWordRangeAtCursor with enablement so
+ * "enabled" always implies "dispatch does something".
+ *
+ * Only a TextSelection passes through untouched — a non-empty NodeSelection
+ * (e.g. an image or horizontal rule selected as a node) looks "non-empty"
+ * but has no text content, so `textBetween` over it is '' and anything
+ * downstream that needs real text (e.g. createFloatingDraft) would silently
+ * no-op. Falling through to findWordRangeAtCursor for any other selection
+ * type gives either a legitimate adjacent word or null (schema-dependent —
+ * e.g. false for a NodeSelection whose dBlock wrapper has no text).
+ */
+export declare const selectWordAtCursor: (editor: Editor) => boolean;
+/**
+ * Single enablement predicate for anchored text actions (inline comments):
+ * true when there's already a non-empty TextSelection, or a word is
+ * reachable from a collapsed cursor via findWordRangeAtCursor. Mirrors the
+ * passthrough condition in selectWordAtCursor so "enabled" always implies
+ * selectWordAtCursor will produce a real text target.
+ */
+export declare const hasTextTargetAtSelection: (editor: Editor) => boolean;

package/dist/package/utils/typography.d.ts

@@ -0,0 +1,26 @@
+import { Editor } from '@tiptap/core';
+
+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;

package/dist/{split-view-toolbar-D2GdAA9D.mjs → split-view-toolbar-BwZg4Gmd.mjs}

@@ -1,7 +1,7 @@
-import { j as d } from "./index-wRSSphoI.mjs";
+import { j as d } from "./index-BREkA3S3.mjs";
 import { useRef as I, useState as N, useEffect as D } from "react";
 import { DynamicDropdown as E, Tooltip as R, IconButton as O } from "@fileverse/ui";
-import { a3 as A, a4 as P, c as y } from "./index-C4IzZi0k.mjs";
+import { a3 as A, a4 as P, c as y } from "./index-CioSbJ2V.mjs";
 const p = (e, t, o = t) => {
   const { state: s } = e, l = s.changeByRange((n) => {
     const u = s.sliceDoc(n.from, n.to), r = s.sliceDoc(