@fileverse-dev/ddoc 6.0.1 → 7.0.0-drop-in.0

package/dist/markdown-source-pane-BJbpMXo2.mjs

@@ -0,0 +1,143 @@
+var k = Object.defineProperty;
+var v = (t, o, r) => o in t ? k(t, o, { enumerable: !0, configurable: !0, writable: !0, value: r }) : t[o] = r;
+var d = (t, o, r) => v(t, typeof o != "symbol" ? o + "" : o, r);
+import { jsx as C } from "react/jsx-runtime";
+import { useRef as m, useEffect as f } from "react";
+import { EditorState as b, Annotation as L, Transaction as S, RangeSetBuilder as y } from "@codemirror/state";
+import { EditorView as u, lineNumbers as D, highlightActiveLine as E, highlightActiveLineGutter as w, keymap as H, ViewPlugin as P, placeholder as N, Decoration as A } from "@codemirror/view";
+import { history as M, defaultKeymap as T, historyKeymap as W } from "@codemirror/commands";
+import { markdown as $ } from "@codemirror/lang-markdown";
+import { syntaxHighlighting as G, defaultHighlightStyle as K, syntaxTree as F } from "@codemirror/language";
+const I = "Write your ideas. Watch them grow. 🌱", h = L.define(), O = /^https?:\/\/\S+$/i, R = u.domEventHandlers({
+  paste(t, o) {
+    var c, a;
+    const r = (a = (c = t.clipboardData) == null ? void 0 : c.getData("text/plain")) == null ? void 0 : a.trim();
+    if (!r || !O.test(r)) return !1;
+    const { from: s, to: e } = o.state.selection.main, l = o.state.sliceDoc(s, e), n = l ? `[${l}](${r})` : `<${r}>`;
+    return t.preventDefault(), o.dispatch({
+      changes: { from: s, to: e, insert: n },
+      selection: { anchor: s + n.length }
+    }), !0;
+  }
+}), U = A.mark({ class: "cm-md-link" }), _ = /* @__PURE__ */ new Set(["Link", "Autolink"]), p = (t) => {
+  const o = new y();
+  for (const { from: r, to: s } of t.visibleRanges)
+    F(t.state).iterate({
+      from: r,
+      to: s,
+      enter: (e) => {
+        _.has(e.name) && e.to > e.from && o.add(e.from, e.to, U);
+      }
+    });
+  return o.finish();
+}, j = P.fromClass(
+  class {
+    constructor(t) {
+      d(this, "decorations");
+      this.decorations = p(t);
+    }
+    update(t) {
+      (t.docChanged || t.viewportChanged) && (this.decorations = p(t.view));
+    }
+  },
+  { decorations: (t) => t.decorations }
+), z = u.theme({
+  "&": {
+    height: "100%",
+    fontSize: "14px",
+    backgroundColor: "transparent",
+    color: "hsl(var(--color-text-default))"
+  },
+  ".cm-scroller": {
+    fontFamily: "ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace",
+    lineHeight: "1.7",
+    padding: "12px 16px 12px 8px"
+  },
+  ".cm-content": { caretColor: "hsl(var(--color-text-default))", padding: "0" },
+  "&.cm-focused": { outline: "none" },
+  ".cm-gutters": {
+    backgroundColor: "transparent",
+    border: "none",
+    color: "hsl(var(--color-text-secondary))"
+  },
+  ".cm-lineNumbers .cm-gutterElement": {
+    minWidth: "26px",
+    padding: "0 8px 0 4px"
+  },
+  ".cm-activeLine": { backgroundColor: "hsl(var(--color-bg-secondary))" },
+  ".cm-activeLineGutter": { backgroundColor: "transparent" },
+  ".cm-cursor, .cm-dropCursor": {
+    borderLeftColor: "hsl(var(--color-text-default))"
+  },
+  // Markdown links use the editor's text-link token (override the default
+  // syntax color, incl. the inner highlight spans).
+  ".cm-md-link, .cm-md-link span": {
+    color: "hsla(var(--color-text-link)) !important"
+  }
+});
+function tt({
+  value: t,
+  onChange: o,
+  onViewReady: r
+}) {
+  const s = m(null), e = m(null), l = m(o);
+  l.current = o;
+  const n = m(r);
+  return n.current = r, f(() => {
+    var a;
+    if (!s.current) return;
+    const c = new u({
+      parent: s.current,
+      state: b.create({
+        doc: t,
+        extensions: [
+          D(),
+          E(),
+          w(),
+          M(),
+          // Swallow Ctrl/Cmd+S so it doesn't open the browser "Save page"
+          // dialog — there's no manual save in Split View (changes are live).
+          H.of([
+            { key: "Mod-s", run: () => !0, preventDefault: !0 },
+            ...T,
+            ...W
+          ]),
+          $(),
+          G(K),
+          j,
+          R,
+          N(I),
+          u.lineWrapping,
+          z,
+          u.updateListener.of((i) => {
+            const g = i.transactions.some(
+              (x) => x.annotation(h)
+            );
+            i.docChanged && !g && l.current(i.state.doc.toString());
+          })
+        ]
+      })
+    });
+    return e.current = c, (a = n.current) == null || a.call(n, c), () => {
+      var i;
+      (i = n.current) == null || i.call(n, null), c.destroy(), e.current = null;
+    };
+  }, []), f(() => {
+    const c = e.current;
+    if (!c) return;
+    const a = c.state.doc.toString();
+    t !== a && c.dispatch({
+      changes: { from: 0, to: a.length, insert: t },
+      // Keep the seed out of the undo history: its base state is the empty
+      // mount-time doc, so an undo would revert the pane to empty and the
+      // change listener would replace the whole document with nothing.
+      annotations: [
+        h.of(!0),
+        S.addToHistory.of(!1)
+      ]
+    });
+  }, [t]), /* @__PURE__ */ C("div", { ref: s, className: "w-full h-full overflow-auto" });
+}
+export {
+  tt as default
+};

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

@@ -0,0 +1,12 @@
+import { Editor } from '@tiptap/react';
+import { DdocProps } from '../types';
+
+type EditorNavbarProps = {
+    editor: Editor | null;
+    renderNavbar?: DdocProps['renderNavbar'];
+    /** undefined: in flow. null: host element not attached yet, render nothing. */
+    container?: HTMLElement | null;
+    isHidden: boolean;
+};
+export declare const EditorNavbar: ({ editor, renderNavbar, container, isHidden, }: EditorNavbarProps) => import("react/jsx-runtime").JSX.Element | null;
+export {};

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

@@ -4,7 +4,7 @@ import { FontDescriptor, IpfsImageFetchPayload, IpfsImageUploadResponse } from '
 import { Tab } from './tabs/utils/tab-utils';
 
 import * as Y from 'yjs';
-declare const MemoizedTiptapToolBar: React.MemoExoticComponent<({ editor, onError, isPresentationMode, setIsPresentationMode, enableCollaboration, zoomLevel, setZoomLevel, isNavbarVisible, setIsNavbarVisible, ipfsImageUploadFn, onMarkdownExport, onMarkdownImport, onPdfExport, onHtmlExport, onTxtExport, onOdtExport, onDocxImport, ipfsImageFetchFn, fetchV1ImageFn, isConnected, tabs, ydoc, onRegisterExportTrigger, toggleFocusMode, isSplitView, onToggleSplitView, fonts: consumerFonts, renderToolbarLeading, }: {
+declare const MemoizedTiptapToolBar: React.MemoExoticComponent<({ editor, onError, isPresentationMode, setIsPresentationMode, enableCollaboration, zoomLevel, setZoomLevel, isNavbarVisible, setIsNavbarVisible, showNavbarToggle, ipfsImageUploadFn, onMarkdownExport, onMarkdownImport, onPdfExport, onHtmlExport, onTxtExport, onOdtExport, onDocxImport, ipfsImageFetchFn, fetchV1ImageFn, isConnected, tabs, ydoc, onRegisterExportTrigger, toggleFocusMode, isSplitView, onToggleSplitView, fonts: consumerFonts, renderToolbarLeading, }: {
     editor: Editor | null;
     onError?: (errorString: string) => void;
     isPresentationMode?: boolean;
@@ -14,6 +14,7 @@ declare const MemoizedTiptapToolBar: React.MemoExoticComponent<({ editor, onErro
     setZoomLevel: (zoom: string) => void;
     isNavbarVisible: boolean;
     setIsNavbarVisible: React.Dispatch<React.SetStateAction<boolean>>;
+    showNavbarToggle?: boolean;
     ipfsImageUploadFn?: (file: File) => Promise<IpfsImageUploadResponse>;
     onMarkdownExport?: () => void;
     onMarkdownImport?: () => void;

package/dist/package/components/fullscreen-toolbar.d.ts

@@ -4,8 +4,8 @@ import { DdocProps } from '../types';
 type FullScreenToolbarProps = {
     dropdownOpen: boolean;
     setDropdownOpen: Dispatch<SetStateAction<boolean>>;
-    zoomLevel: DdocProps['zoomLevel'];
-    setZoomLevel: DdocProps['setZoomLevel'];
+    zoomLevel: string;
+    setZoomLevel: Dispatch<SetStateAction<string>>;
     showTOC: DdocProps['showTOC'];
     setShowTOC: DdocProps['setShowTOC'];
     toggleFocusMode: () => Promise<void>;

package/dist/package/components/mobile-toolbar.d.ts

@@ -2,12 +2,13 @@ import { default as React } from 'react';
 import { Editor } from '@tiptap/react';
 import { FontDescriptor, IpfsImageFetchPayload, IpfsImageUploadResponse } from '../types';
 
-declare const MemoizedMobileToolbar: React.MemoExoticComponent<({ editor, onError, isKeyboardVisible, isNavbarVisible, setIsNavbarVisible, ipfsImageUploadFn, ipfsImageFetchFn, fetchV1ImageFn, fonts, }: {
+declare const MemoizedMobileToolbar: React.MemoExoticComponent<({ editor, onError, isKeyboardVisible, isNavbarVisible, setIsNavbarVisible, showNavbarToggle, ipfsImageUploadFn, ipfsImageFetchFn, fetchV1ImageFn, fonts, }: {
     editor: Editor | null;
     onError?: (errorString: string) => void;
     isKeyboardVisible: boolean;
     isNavbarVisible: boolean;
     setIsNavbarVisible: React.Dispatch<React.SetStateAction<boolean>>;
+    showNavbarToggle?: boolean;
     ipfsImageUploadFn?: (file: File) => Promise<IpfsImageUploadResponse>;
     ipfsImageFetchFn?: (_data: IpfsImageFetchPayload) => Promise<{
         url: string;

package/dist/package/components/tabs/document-mobile-tab-panel.d.ts

@@ -25,5 +25,7 @@ export interface DocumentMobileTabPanelProps {
     isVersionHistoryMode: boolean;
     isConnected?: boolean;
     isFocusMode?: boolean;
+    layout?: DocumentOutlineProps['layout'];
+    tabPanelSlot?: HTMLElement | null;
 }
-export declare const DocumentMobileTabPanel: ({ tabs, activeTabId, setActiveTabId, editor, items, setItems, orientation, renameTab, createTab, duplicateTab, orderTab, deleteTab, tabCommentCounts, isPreviewMode, tabConfig, isVersionHistoryMode, isConnected, isFocusMode, }: DocumentMobileTabPanelProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DocumentMobileTabPanel: ({ tabs, activeTabId, setActiveTabId, editor, items, setItems, orientation, renameTab, createTab, duplicateTab, orderTab, deleteTab, tabCommentCounts, isPreviewMode, tabConfig, isVersionHistoryMode, isConnected, isFocusMode, layout, tabPanelSlot, }: DocumentMobileTabPanelProps) => import("react/jsx-runtime").JSX.Element | null;

package/dist/package/components/tabs/document-tabs-sidebar.d.ts

@@ -32,9 +32,10 @@ export interface DocumentTabsSidebarProps {
     deleteTab?: (tabId: string) => void;
     isConnected?: boolean;
     isFocusMode?: boolean;
+    layout?: DocumentOutlineProps['layout'];
 }
 export declare const DocumentTabsSidebar: ({ tabSectionContainer, ...rest }: DocumentTabsSidebarProps) => import("react/jsx-runtime").JSX.Element | null;
-export declare const TabSidebar: ({ tabs, activeTabId, setActiveTabId, showTOC, setShowTOC, hasToC, isPreviewMode, editor, items, setItems, orientation, createTab, renameTab, duplicateTab, orderTab, tabCommentCounts, isVersionHistoryMode, tabConfig, deleteTab, isConnected, isFocusMode, }: DocumentTabsSidebarProps) => import("react/jsx-runtime").JSX.Element;
+export declare const TabSidebar: ({ tabs, activeTabId, setActiveTabId, showTOC, setShowTOC, hasToC, isPreviewMode, editor, items, setItems, orientation, createTab, renameTab, duplicateTab, orderTab, tabCommentCounts, isVersionHistoryMode, tabConfig, deleteTab, isConnected, isFocusMode, layout, }: DocumentTabsSidebarProps) => import("react/jsx-runtime").JSX.Element;
 export declare const DdocTab: ({ tab, tabIndex, tabCount, handleEmojiChange, handleNameChange, onClick, editor, tocItem, setTocItems, orientation, activeTabId, duplicateTab, commentCount, moveTabUp, moveTabDown, isPreviewMode, isVersionHistoryMode, tabConfig, onDelete, showOutline, onShowOutlineChange, isConnected, }: {
     tab: Tab;
     tabIndex: number;

package/dist/package/components/toc/document-outline.d.ts

@@ -1,3 +1,3 @@
 import { DocumentOutlineProps } from './types';
 
-export declare const DocumentOutline: ({ editor, hasToC, items, setItems, showTOC, setShowTOC, isPreviewMode, orientation, tabs, setTabs, activeTabId, setActiveTabId, createTab, renameTab, duplicateTab, orderTab, ydoc, tabCommentCounts, tabSectionContainer, isVersionHistoryMode, tabConfig, deleteTab, isConnected, isFocusMode, }: DocumentOutlineProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DocumentOutline: ({ editor, hasToC, items, setItems, showTOC, setShowTOC, isPreviewMode, orientation, tabs, setTabs, activeTabId, setActiveTabId, createTab, renameTab, duplicateTab, orderTab, ydoc, tabCommentCounts, tabSectionContainer, isVersionHistoryMode, tabConfig, deleteTab, isConnected, isFocusMode, layout, tabPanelSlot, }: DocumentOutlineProps) => import("react/jsx-runtime").JSX.Element;

package/dist/package/components/toc/toc.d.ts

@@ -1,5 +1,5 @@
 import { ToCProps, ToCItemProps } from './types';
 
-export declare const ToCItem: import('react').MemoExoticComponent<({ item, onItemClick, index, orientation, }: ToCItemProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const ToCItem: import('react').MemoExoticComponent<({ item, onItemClick, index, orientation, isMobile, isWide, }: ToCItemProps) => import("react/jsx-runtime").JSX.Element>;
 export declare const ToCEmptyState: import('react').MemoExoticComponent<() => import("react/jsx-runtime").JSX.Element>;
 export declare const ToC: import('react').MemoExoticComponent<({ items, editor, setItems, orientation }: ToCProps) => import("react/jsx-runtime").JSX.Element>;

package/dist/package/components/toc/types.d.ts

@@ -22,6 +22,10 @@ export type ToCItemProps = {
     onItemRemove: (e: React.MouseEvent, id: string) => void;
     index: number;
     orientation?: 'portrait' | 'landscape';
+    /** At or below 1280px: the item is in the mobile list. */
+    isMobile?: boolean;
+    /** At or above 1280px: the item takes the rail's width caps. */
+    isWide?: boolean;
 };
 export interface DocumentOutlineProps {
     editor: Editor;
@@ -54,4 +58,7 @@ export interface DocumentOutlineProps {
     deleteTab?: (tabId: string) => void;
     isConnected?: boolean;
     isFocusMode?: boolean;
+    /** 'contained': sized from the editor canvas. Only DdocEditor passes it. */
+    layout?: 'viewport' | 'contained';
+    tabPanelSlot?: HTMLElement | null;
 }

package/dist/package/extensions/emoji/components/emoji-utils.d.ts

@@ -1,4 +1,4 @@
-export declare function emojiSearch(query: string): {
+export declare function emojiSearch(query: string): Promise<{
     name: string;
     emoji: string;
-}[];
+}[]>;

package/dist/package/hooks/use-canvas-metrics.d.ts

@@ -0,0 +1,16 @@
+import { RefObject } from 'react';
+import { EditorWidthStore } from '../utils/editor-width-store';
+
+export declare const computeWidthDecisions: (width: number, scaledWidth: number, leftWidth: number) => {
+    shouldHideRight: boolean;
+    shouldScroll: boolean;
+};
+type WidthDecisions = ReturnType<typeof computeWidthDecisions>;
+export declare const useCanvasMetrics: ({ canvasRef, rootRef, scaledWidth, leftWidth, widthStore, }: {
+    canvasRef: RefObject<HTMLElement | null>;
+    rootRef: RefObject<HTMLElement | null>;
+    scaledWidth: number;
+    leftWidth: number;
+    widthStore?: EditorWidthStore;
+}) => WidthDecisions;
+export {};

package/dist/package/hooks/use-controllable-state.d.ts

@@ -0,0 +1,3 @@
+import { Dispatch, SetStateAction } from 'react';
+
+export declare const useControllableState: <T>(value: T | undefined, defaultValue: T, onChange?: (next: T) => void, legacySetter?: (next: T) => void) => [T, Dispatch<SetStateAction<T>>];

package/dist/package/hooks/use-editor-media-query.d.ts

@@ -0,0 +1,4 @@
+import { EditorWidthStore } from '../utils/editor-width-store';
+
+export declare const EditorWidthContext: import('react').Context<EditorWidthStore | null>;
+export declare const useEditorMediaQuery: (query: string, store?: EditorWidthStore) => boolean;

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

@@ -1,9 +1,7 @@
 type UseFocusModeOptions = {
-    /** Notify callback — fires on every toggle in both modes (existing API). */
+    /** @deprecated Use onFocusModeChange. Still fires on every change. */
     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, isFocusMode: controlledValue, onFocusModeChange, }?: UseFocusModeOptions) => {

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

@@ -4,12 +4,14 @@ import { AnyExtension, Editor } from '@tiptap/react';
 import { CommentAnchor } from '../extensions/comment/comment-decoration-plugin';
 import { DBlockRuntimeStateRef } from '../extensions/d-block/dblock-runtime';
 import { ToCItemType } from '../components/toc/types';
+import { EditorWidthStore } from '../utils/editor-width-store';
 import { CollabConnectionConfig, CollaborationProps } from '../sync-local/types';
 
 import * as Y from 'yjs';
 export declare const TAB_EDITOR_ATTRIBUTES: Record<string, string>;
 interface UseTabEditorArgs {
     ydoc: Y.Doc;
+    editorWidthStore?: EditorWidthStore;
     isVersionMode?: boolean;
     hasTabState?: boolean;
     versionId?: string;
@@ -36,6 +38,7 @@ interface UseTabEditorArgs {
     setWordCount?: DdocProps['setWordCount'];
     setSelectedWordCount?: DdocProps['setSelectedWordCount'];
     setPageCount?: DdocProps['setPageCount'];
+    onStatsChange?: DdocProps['onStatsChange'];
     setIsContentLoading: Dispatch<SetStateAction<boolean>>;
     setIsCollabContentLoading: Dispatch<SetStateAction<boolean>>;
     unFocused?: boolean;
@@ -58,7 +61,7 @@ interface UseTabEditorArgs {
     dBlockRuntimeStateRef?: DBlockRuntimeStateRef;
     docSchemaVersion?: number;
 }
-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, docSchemaVersion, }: UseTabEditorArgs) => {
+export declare const useTabEditor: ({ ydoc, editorWidthStore, 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, onStatsChange, setIsContentLoading, setIsCollabContentLoading, unFocused, zoomLevel, isPresentationMode, onInvalidContentError, ignoreCorruptedData, onConnect, onDisconnect, isIndexeddbSynced, hasCollabContentInitialised, initialiseYjsIndexedDbProvider, externalExtensions, isContentLoading, activeTabId, tabIds, theme, editorRef, initialCommentAnchors, dBlockRuntimeStateRef, docSchemaVersion, }: UseTabEditorArgs) => {
     editor: Editor | null;
     cachedEditorEntries: import('./use-tab-editor-cache').CachedTabEditorRenderEntry[];
     ref: import('react').RefObject<HTMLDivElement>;

package/dist/package/types.d.ts

@@ -126,6 +126,13 @@ export interface DocumentStyling {
      */
     customCSS?: string;
 }
+export type DdocStats = {
+    words: number;
+    characters: number;
+    selectedWords: number;
+    /** null until the active tab has been measured. */
+    pages: number | null;
+};
 export interface DdocProps extends CommentAccountProps {
     /**
      * Optional catalog of fonts available to the editor in addition to the
@@ -162,6 +169,8 @@ export interface DdocProps extends CommentAccountProps {
     fetchV1ImageFn?: (url: string) => Promise<ArrayBuffer | undefined>;
     disableInlineComment?: boolean;
     commentDrawerOpen?: boolean;
+    onCommentDrawerOpenChange?: (open: boolean) => void;
+    /** @deprecated Use onCommentDrawerOpenChange. */
     setCommentDrawerOpen?: React.Dispatch<SetStateAction<boolean>>;
     initialComments?: IComment[];
     initialCommentAnchors?: SerializedCommentAnchor[];
@@ -175,6 +184,8 @@ export interface DdocProps extends CommentAccountProps {
     onDeleteComment?: (activeCommentId: string, meta?: CommentMutationMeta) => void;
     onDeleteReply?: (activeCommentId: string, replyId: string) => void;
     showTOC?: boolean;
+    onShowTOCChange?: (show: boolean) => void;
+    /** @deprecated Use onShowTOCChange. */
     setShowTOC?: React.Dispatch<SetStateAction<boolean>>;
     extensions?: Record<string, Extension | any>;
     selectedTags?: TagType[];
@@ -184,13 +195,19 @@ export interface DdocProps extends CommentAccountProps {
     inlineCommentData?: InlineCommentData;
     setInlineCommentData?: React.Dispatch<React.SetStateAction<InlineCommentData>>;
     theme?: ThemeKey;
-    zoomLevel: string;
-    setZoomLevel: React.Dispatch<SetStateAction<string>>;
-    isNavbarVisible: boolean;
-    setIsNavbarVisible: React.Dispatch<SetStateAction<boolean>>;
+    /** Defaults to '1' when omitted. */
+    zoomLevel?: string;
+    onZoomLevelChange?: (zoomLevel: string) => void;
+    /** @deprecated Use onZoomLevelChange. */
+    setZoomLevel?: React.Dispatch<SetStateAction<string>>;
+    /** Defaults to true when omitted. */
+    isNavbarVisible?: boolean;
+    onNavbarVisibleChange?: (visible: boolean) => void;
+    /** @deprecated Use onNavbarVisibleChange. */
+    setIsNavbarVisible?: React.Dispatch<SetStateAction<boolean>>;
     editorCanvasClassNames?: string;
     isCommentSectionOpen?: boolean;
-    isPreviewMode: boolean;
+    isPreviewMode?: boolean;
     viewerMode?: 'suggest' | 'view-only';
     ensResolutionUrl?: string;
     /**
@@ -215,6 +232,13 @@ export interface DdocProps extends CommentAccountProps {
     walletAddress?: string | null;
     username?: string | null;
     setUsername?: React.Dispatch<SetStateAction<string>>;
+    /**
+     * Host element to render the navbar into. Omit to render it as the editor's
+     * first row. Pass null while the element is not attached yet.
+     */
+    navbarContainer?: HTMLElement | null;
+    /** Show the toolbar's navbar collapse chevron. Default true. */
+    showNavbarToggle?: boolean;
     renderNavbar?: ({ editor, liveEditor, }: {
         /** JSON snapshot — legacy field, unchanged. */
         editor: JSONContent;
@@ -252,9 +276,15 @@ export interface DdocProps extends CommentAccountProps {
      */
     enableFanficTemplate?: boolean;
     onError?: (error: string) => void;
+    /** Active-tab stats. Fires with all four fields whenever one changes. */
+    onStatsChange?: (stats: DdocStats) => void;
+    /** @deprecated Use onStatsChange. */
     setCharacterCount?: React.Dispatch<SetStateAction<number>>;
+    /** @deprecated Use onStatsChange. */
     setWordCount?: React.Dispatch<SetStateAction<number>>;
+    /** @deprecated Use onStatsChange. */
     setSelectedWordCount?: React.Dispatch<SetStateAction<number>>;
+    /** @deprecated Use onStatsChange. */
     setPageCount?: React.Dispatch<SetStateAction<number>>;
     tags?: Array<{
         name: string;
@@ -263,12 +293,17 @@ export interface DdocProps extends CommentAccountProps {
     className?: string;
     unFocused?: boolean;
     isPresentationMode?: boolean;
+    onPresentationModeChange?: (active: boolean) => void;
+    /** @deprecated Use onPresentationModeChange. */
     setIsPresentationMode?: React.Dispatch<SetStateAction<boolean>>;
     /** Split View: edit markdown on the left, see the read-only ddoc render on the right. */
     isSplitView?: boolean;
+    onSplitViewChange?: (active: boolean) => void;
+    /** @deprecated Use onSplitViewChange. */
     setIsSplitView?: React.Dispatch<SetStateAction<boolean>>;
     onComment?: () => void;
     onInlineComment?: () => void;
+    /** @deprecated Use onFocusModeChange. Still fires on every change. */
     onFocusMode?: (isFocusMode: boolean) => void;
     /** Controlled focus mode (D6). Omit for the legacy internal-state behavior. */
     isFocusMode?: boolean;
@@ -294,6 +329,7 @@ export interface DdocProps extends CommentAccountProps {
     renderToolbarLeading?: () => React.ReactNode;
     metadataProxyUrl?: string;
     onCopyHeadingLink?: (link: string) => void;
+    /** @deprecated No effect. The host footer sits outside the editor. */
     footerHeight?: string;
     activeModel?: CustomModel;
     maxTokens?: number;

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

@@ -1,10 +1,12 @@
 import { DdocProps } from './types';
 import { Editor } from '@tiptap/react';
 import { DBlockRuntimeState } from './extensions/d-block/dblock-runtime';
+import { EditorWidthStore } from './utils/editor-width-store';
 
-export declare const useDdocEditor: ({ isPreviewMode, viewerMode, initialContent, versionHistoryState, collaboration, onChange, onLocalChange, isNewDocument, onCollaboratorChange, onCommentInteraction, onError, setCharacterCount, setWordCount, setSelectedWordCount, setPageCount, ipfsImageUploadFn, ddocId, enableIndexeddbSync, unFocused, isFocusMode, theme, zoomLevel, onInvalidContentError, ignoreCorruptedData, isPresentationMode, metadataProxyUrl, extensions: externalExtensions, onCopyHeadingLink, ipfsImageFetchFn, fetchV1ImageFn, isConnected, activeModel, maxTokens, isAIAgentEnabled, onIndexedDbError, disableInlineComment, initialCommentAnchors, isPreviewEditor, fonts, preferredSchemaVersion, onSchemaStampGuard, ...rest }: Partial<DdocProps> & {
+export declare const useDdocEditor: ({ isPreviewMode, viewerMode, initialContent, versionHistoryState, collaboration, onChange, onLocalChange, isNewDocument, onCollaboratorChange, onCommentInteraction, onError, setCharacterCount, setWordCount, setSelectedWordCount, setPageCount, onStatsChange, ipfsImageUploadFn, ddocId, enableIndexeddbSync, unFocused, isFocusMode, theme, zoomLevel, onInvalidContentError, ignoreCorruptedData, isPresentationMode, metadataProxyUrl, extensions: externalExtensions, onCopyHeadingLink, ipfsImageFetchFn, fetchV1ImageFn, isConnected, activeModel, maxTokens, isAIAgentEnabled, onIndexedDbError, disableInlineComment, initialCommentAnchors, isPreviewEditor, fonts, preferredSchemaVersion, editorWidthStore, onSchemaStampGuard, ...rest }: Partial<DdocProps> & {
     isFocusMode?: boolean;
     isPreviewEditor?: boolean;
+    editorWidthStore?: EditorWidthStore;
 }) => {
     ydoc: import('yjs').Doc;
     awareness: import('y-protocols/awareness.js').Awareness | null;

package/dist/package/utils/container-query-support.d.ts

@@ -0,0 +1 @@
+export declare const canUseEditorContainerQueries: () => boolean;

package/dist/package/utils/editor-width-store.d.ts

@@ -0,0 +1,6 @@
+export type EditorWidthStore = {
+    get(): number | null;
+    set(width: number): void;
+    subscribe(listener: () => void): () => void;
+};
+export declare const createEditorWidthStore: () => EditorWidthStore;

package/dist/package/utils/responsive.d.ts

@@ -1,4 +1,6 @@
-export declare const useResponsive: () => {
+import { EditorWidthStore } from './editor-width-store';
+
+export declare const useResponsive: (store?: EditorWidthStore) => {
     isBelow1024px: boolean;
     isBelow1280px: boolean;
     isMobileScreen: boolean;

package/dist/package/utils/stats-publisher.d.ts

@@ -0,0 +1,8 @@
+import { DdocStats } from '../types';
+
+export declare const createStatsPublisher: (emit: (stats: DdocStats) => void) => {
+    beginTab(pages: number | null): void;
+    publish(patch: Partial<DdocStats>, options?: {
+        tick?: boolean;
+    }): void;
+};

package/dist/persistence.es.js

@@ -1,4 +1,4 @@
-import { D as n, a as o, d as D, g as a, m as r, r as d, b as C } from "./ddoc-persistence-C2ay3lLb.mjs";
+import { D as n, a as o, d as D, g as a, m as r, r as d, b as C } from "./ddoc-persistence-DLdSviUr.mjs";
 export {
   n as DDOC_STORE_REPAIRED,
   o as DEFAULT_DDOC_PERSISTENCE_TIMEOUT_MS,