@fileverse-dev/ddoc 4.1.12 → 4.2.0

package/dist/{index-C4IzZi0k.mjs → index-DnbtCBdq.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-BmAUaDBd.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-BmAUaDBd.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-DJqeRQ7T.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-BmAUaDBd.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-DnbtCBdq.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/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/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/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-Cv3kcYDE.mjs}

@@ -1,7 +1,7 @@
-import { j as d } from "./index-wRSSphoI.mjs";
+import { j as d } from "./index-BmAUaDBd.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-DnbtCBdq.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(