@fileverse-dev/ddoc 4.1.11 → 4.1.12-menubar-3

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 { buildVersionDiffSnapshot } from './package/components/tabs/utils/version-diff-snapshot';

package/dist/index.es.js

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

package/dist/{markdown-source-pane-DTszGHF9.mjs → markdown-source-pane-D6jRN_JD.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-BhAjJb8w.mjs";
+import { j as Cr } from "./index-DwLAI_Ie.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-rpz9D-nF.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-BWdjUdQy.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.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/types.d.ts

@@ -169,8 +169,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;
@@ -198,6 +201,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/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-Bpk4iUtd.mjs → split-view-toolbar-D4bIgxWm.mjs}

@@ -1,7 +1,7 @@
-import { j as d } from "./index-BhAjJb8w.mjs";
+import { j as d } from "./index-DwLAI_Ie.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-rpz9D-nF.mjs";
+import { a3 as A, a4 as P, c as y } from "./index-BWdjUdQy.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(