@fileverse-dev/ddoc 6.0.0-drop-in.3 → 6.0.1-dist-slim.0

package/dist/package/types.d.ts

@@ -116,13 +116,6 @@ 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
@@ -159,8 +152,6 @@ 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[];
@@ -174,8 +165,6 @@ 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[];
@@ -185,19 +174,13 @@ export interface DdocProps extends CommentAccountProps {
     inlineCommentData?: InlineCommentData;
     setInlineCommentData?: React.Dispatch<React.SetStateAction<InlineCommentData>>;
     theme?: ThemeKey;
-    /** 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>>;
+    zoomLevel: string;
+    setZoomLevel: React.Dispatch<SetStateAction<string>>;
+    isNavbarVisible: boolean;
+    setIsNavbarVisible: React.Dispatch<SetStateAction<boolean>>;
     editorCanvasClassNames?: string;
     isCommentSectionOpen?: boolean;
-    isPreviewMode?: boolean;
+    isPreviewMode: boolean;
     viewerMode?: 'suggest' | 'view-only';
     ensResolutionUrl?: string;
     /**
@@ -222,13 +205,6 @@ 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;
@@ -236,6 +212,24 @@ export interface DdocProps extends CommentAccountProps {
         liveEditor: Editor | null;
     }) => JSX.Element;
     onChange?: (updatedDocContent: string | JSONContent, updateChunk: string) => void;
+    /**
+     * Called when the document changes, from the same places as `onChange`
+     * (after typing pauses, on a flushed structural change, and when a
+     * collaborator's update arrives), but with no arguments. A host that passes
+     * this and not `onChange` never pays for encoding the whole document on
+     * every change. A host that keeps the content elsewhere (the package's
+     * y-indexeddb store) only needs to know that an edit happened.
+     */
+    onLocalChange?: () => void;
+    /**
+     * Whether this is a brand-new document. When omitted the editor derives it
+     * as "owner, no collaboration, no `initialContent`". A host that loads an
+     * existing document from the package's y-indexeddb store passes no
+     * `initialContent`, so it must pass `false` here: a new document is stamped
+     * with the preferred schema version, which would relabel an existing older
+     * document.
+     */
+    isNewDocument?: boolean;
     onCollaboratorChange?: (collaborators: undefined | IDocCollabUsers[]) => void;
     onTextSelection?: (data: IEditorSelectionData) => void;
     onCommentInteraction?: (data: IEditorSelectionData) => void;
@@ -248,15 +242,9 @@ 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;
@@ -265,17 +253,12 @@ 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;
@@ -301,7 +284,6 @@ 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;
@@ -312,8 +294,8 @@ export interface DdocProps extends CommentAccountProps {
      */
     documentStyling?: DocumentStyling;
     /**
-     * Callback when IndexedDB initialization fails
-     * @description Called when the IndexedDB persistence provider fails to initialize (e.g., private browsing, quota exceeded, corrupted DB). The editor will continue to function without local persistence.
+     * Callback when local saving to IndexedDB has a problem
+     * @description Called when the IndexedDB persistence provider fails to initialize (e.g., private browsing, corrupted DB), when a save is rejected (e.g., quota exceeded), when the browser closes or another tab deletes the database (the editor detaches from it), and when a corrupt store was repaired on load. The editor keeps working in memory; `refreshYjsIndexedDbProvider` attaches again and saves what it holds.
      */
     onIndexedDbError?: (error: Error) => void;
     /**

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

@@ -1,12 +1,10 @@
 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, 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> & {
+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> & {
     isFocusMode?: boolean;
     isPreviewEditor?: boolean;
-    editorWidthStore?: EditorWidthStore;
 }) => {
     ydoc: import('yjs').Doc;
     awareness: import('y-protocols/awareness.js').Awareness | null;

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

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

package/dist/persistence.d.ts

@@ -0,0 +1 @@
+export * from './package/persistence';

package/dist/persistence.es.js

@@ -0,0 +1,10 @@
+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,
+  D as deleteDdocContent,
+  a as getDdocContentFingerprint,
+  r as mergeDdocContent,
+  d as readDdocContent,
+  C as repairDdocContent
+};

package/dist/{split-view-toolbar-NTimkQK1.mjs → split-view-toolbar-6aBSjsO2.mjs}

@@ -1,66 +1,67 @@
 import { jsx as m, jsxs as L } from "react/jsx-runtime";
 import { useRef as D, useState as E, useEffect as A } from "react";
 import { DynamicDropdown as P, Tooltip as O, IconButton as T } from "@fileverse/ui";
-import { a3 as _, a4 as w, c as R } from "./index-eP_xxZsk.mjs";
-const p = (e, n, o = n) => {
-  const { state: i } = e, l = i.changeByRange((t) => {
-    const d = i.sliceDoc(t.from, t.to), r = i.sliceDoc(
-      Math.max(0, t.from - n.length),
-      t.from
+import { EditorSelection as R } from "@codemirror/state";
+import { redo as _, undo as w } from "@codemirror/commands";
+const p = (e, t, o = t) => {
+  const { state: i } = e, l = i.changeByRange((n) => {
+    const d = i.sliceDoc(n.from, n.to), r = i.sliceDoc(
+      Math.max(0, n.from - t.length),
+      n.from
     ), u = i.sliceDoc(
-      t.to,
-      Math.min(i.doc.length, t.to + o.length)
+      n.to,
+      Math.min(i.doc.length, n.to + o.length)
     );
-    if (r === n && u === o)
+    if (r === t && u === o)
       return {
         changes: [
-          { from: t.from - n.length, to: t.from, insert: "" },
-          { from: t.to, to: t.to + o.length, insert: "" }
+          { from: n.from - t.length, to: n.from, insert: "" },
+          { from: n.to, to: n.to + o.length, insert: "" }
         ],
         range: R.range(
-          t.from - n.length,
-          t.to - n.length
+          n.from - t.length,
+          n.to - t.length
         )
       };
-    const b = n + d + o;
+    const b = t + d + o;
     return {
-      changes: { from: t.from, to: t.to, insert: b },
+      changes: { from: n.from, to: n.to, insert: b },
       range: R.range(
-        t.from + n.length,
-        t.from + n.length + d.length
+        n.from + t.length,
+        n.from + t.length + d.length
       )
     };
   });
   e.dispatch(i.update(l, { scrollIntoView: !0 })), e.focus();
-}, B = (e, n) => {
+}, B = (e, t) => {
   const { state: o } = e, i = [], l = /* @__PURE__ */ new Set();
-  for (const t of o.selection.ranges) {
-    let d = t.from;
+  for (const n of o.selection.ranges) {
+    let d = n.from;
     for (; ; ) {
       const r = o.doc.lineAt(d);
       if (!l.has(r.number)) {
         l.add(r.number);
-        const u = n(r.text, r.from);
+        const u = t(r.text, r.from);
         u && i.push(u);
       }
-      if (r.to >= t.to) break;
+      if (r.to >= n.to) break;
       d = r.to + 1;
     }
   }
   i.length && e.dispatch(o.update({ changes: i, scrollIntoView: !0 })), e.focus();
-}, y = (e, n) => B(
+}, y = (e, t) => B(
   e,
-  (o, i) => o.startsWith(n) ? { from: i, to: i + n.length, insert: "" } : { from: i, insert: n }
-), z = (e, n) => {
-  const o = "#".repeat(n) + " ";
+  (o, i) => o.startsWith(t) ? { from: i, to: i + t.length, insert: "" } : { from: i, insert: t }
+), z = (e, t) => {
+  const o = "#".repeat(t) + " ";
   return B(e, (i, l) => {
-    const t = i.match(/^(#{1,6})\s/);
-    return t && t[1].length === n ? { from: l, to: l + t[0].length, insert: "" } : t ? { from: l, to: l + t[0].length, insert: o } : { from: l, insert: o };
+    const n = i.match(/^(#{1,6})\s/);
+    return n && n[1].length === t ? { from: l, to: l + n[0].length, insert: "" } : n ? { from: l, to: l + n[0].length, insert: o } : { from: l, insert: o };
   });
-}, f = (e, n) => {
+}, f = (e, t) => {
   const { state: o } = e, i = o.selection.main, r = `${o.doc.lineAt(i.from).text.trim() === "" ? "" : `
 
-`}${n}
+`}${t}
 `;
   e.dispatch(
     o.update({
@@ -69,19 +70,19 @@ const p = (e, n, o = n) => {
       scrollIntoView: !0
     })
   ), e.focus();
-}, G = (e, n) => {
+}, G = (e, t) => {
   const { state: o } = e, i = o.changeByRange((l) => {
-    const t = o.sliceDoc(l.from, l.to) || "text", d = n ?? "url", r = `[${t}](${d})`, u = l.from + 1 + t.length + 2;
+    const n = o.sliceDoc(l.from, l.to) || "text", d = t ?? "url", r = `[${n}](${d})`, u = l.from + 1 + n.length + 2;
     return {
       changes: { from: l.from, to: l.to, insert: r },
       range: R.range(u, u + d.length)
     };
   });
   e.dispatch(o.update(i, { scrollIntoView: !0 })), e.focus();
-}, K = (e, n) => {
-  const o = `<img src="${n.src}" media-type="secure-img" encryptionKey="${n.encryptionKey}" nonce="${n.nonce}" ipfsUrl="${n.ipfsUrl}" ipfsHash="${n.ipfsHash}" version="2" authTag="${n.authTag}" mimeType="${n.mimeType}" />`;
+}, K = (e, t) => {
+  const o = `<img src="${t.src}" media-type="secure-img" encryptionKey="${t.encryptionKey}" nonce="${t.nonce}" ipfsUrl="${t.ipfsUrl}" ipfsHash="${t.ipfsHash}" version="2" authTag="${t.authTag}" mimeType="${t.mimeType}" />`;
   f(e, o);
-}, M = (e, n) => f(e, `<img src="${n}" media-type="img" />`), W = `| Column 1 | Column 2 |
+}, M = (e, t) => f(e, `<img src="${t}" media-type="img" />`), W = `| Column 1 | Column 2 |
 | -------- | -------- |
 |          |          |`, c = {
   bold: (e) => p(e, "**"),
@@ -89,7 +90,7 @@ const p = (e, n, o = n) => {
   strike: (e) => p(e, "~~"),
   inlineCode: (e) => p(e, "`"),
   underline: (e) => p(e, "<u>", "</u>"),
-  heading: (e, n) => z(e, n),
+  heading: (e, t) => z(e, t),
   bulletList: (e) => y(e, "- "),
   orderedList: (e) => y(e, "1. "),
   taskList: (e) => y(e, "- [ ] "),
@@ -97,7 +98,7 @@ const p = (e, n, o = n) => {
   codeBlock: (e) => f(e, "```\n\n```"),
   horizontalRule: (e) => f(e, "---"),
   table: (e) => f(e, W),
-  link: (e, n) => G(e, n),
+  link: (e, t) => G(e, t),
   undo: (e) => {
     w(e), e.focus();
   },
@@ -105,7 +106,7 @@ const p = (e, n, o = n) => {
     _(e), e.focus();
   },
   // Highlight → inline HTML (round-trips via our turndown/DOMPurify rules).
-  highlight: (e, n) => n ? p(e, `<mark style="background-color: ${n}">`, "</mark>") : p(e, "<mark>", "</mark>")
+  highlight: (e, t) => t ? p(e, `<mark style="background-color: ${t}">`, "</mark>") : p(e, "<mark>", "</mark>")
 }, H = [
   [
     { icon: "Undo", label: "Undo", run: (e) => c.undo(e) },
@@ -188,9 +189,9 @@ const p = (e, n, o = n) => {
     }
   ]
 ], $ = 3, V = H.slice(0, $), U = H.slice($), S = "!h-6 !w-6 !min-w-0", j = 560, C = () => /* @__PURE__ */ m("div", { className: "w-[1px] h-4 vertical-divider mx-1" });
-function X({
+function J({
   view: e,
-  ipfsImageUploadFn: n,
+  ipfsImageUploadFn: t,
   onError: o
 }) {
   const i = (s) => {
@@ -200,8 +201,8 @@ function X({
       const h = (x = a.files) == null ? void 0 : x[0];
       if (!(!h || !h.type.includes("image/")))
         try {
-          if (n) {
-            const g = await n(h);
+          if (t) {
+            const g = await t(h);
             K(s, {
               src: URL.createObjectURL(h),
               ipfsUrl: g.ipfsUrl,
@@ -228,9 +229,9 @@ function X({
       return;
     }
     s.run(a);
-  }, t = D(null), [d, r] = E(!1);
+  }, n = D(null), [d, r] = E(!1);
   A(() => {
-    const s = t.current;
+    const s = n.current;
     if (!s || typeof ResizeObserver > "u") return;
     const a = () => r(s.clientWidth < j);
     a();
@@ -254,7 +255,7 @@ function X({
   return /* @__PURE__ */ m("div", { className: "flex items-center px-2 py-2 border-b color-border-default shrink-0", children: /* @__PURE__ */ L(
     "div",
     {
-      ref: t,
+      ref: n,
       className: "flex items-center gap-0.5 flex-1 min-w-0 overflow-hidden",
       children: [
         V.map((s, a) => b(s, a > 0)),
@@ -285,5 +286,5 @@ function X({
   ) });
 }
 export {
-  X as default
+  J as default
 };