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

package/dist/{index-BWdjUdQy.mjs → index-DvBqPqhC.mjs}

@@ -1,4 +1,4 @@
-import { k as Ql, b as Zl, s as eh } from "./index-DwLAI_Ie.mjs";
+import { k as Ql, b as Zl, s as eh } from "./index-DWI3-T75.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

@@ -7,6 +7,8 @@ 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';
+export type { CssDiagnostic, CssValidationResult, } from './package/utils/sanitize-css';
 export { buildVersionDiffSnapshot } from './package/components/tabs/utils/version-diff-snapshot';
 export type { DdocExportModalProps, ExportFormatOption, ExportTabOption, } from './package/components/export-modal';
 export type { VersionTabSnapshot } from './package/components/tabs/utils/version-diff-snapshot';

package/dist/index.es.js

@@ -1,13 +1,15 @@
-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";
+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-DWI3-T75.mjs";
 export {
   e as DdocEditor,
   o as DdocExportModal,
-  d as Editor,
-  t as PreviewDdocEditor,
+  t as Editor,
+  d as PreviewDdocEditor,
   r as buildVersionDiffSnapshot,
   i as handleContentPrint,
   n as mergeTabAwareYjsUpdates,
-  E as useEditorCommands,
-  l as useExportHeadlessEditorContent,
-  m as useHeadlessEditor
+  E as sanitizeCustomCss,
+  m as useEditorCommands,
+  u as useExportHeadlessEditorContent,
+  C as useHeadlessEditor,
+  l as validateCustomCss
 };

package/dist/{markdown-source-pane-D6jRN_JD.mjs → markdown-source-pane-BywaJO6j.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-DwLAI_Ie.mjs";
+import { j as Cr } from "./index-DWI3-T75.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-BWdjUdQy.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-DvBqPqhC.mjs";
 class ua {
   /**
   Create a new completion context. (Mostly useful for testing

package/dist/package/components/split-view/split-view-css-accordion.d.ts

@@ -0,0 +1,13 @@
+interface SplitViewCssAccordionProps {
+    /** The document's custom CSS (raw author selectors). */
+    customCSS?: string;
+}
+/**
+ * Split View LEFT pane: a collapsible, READ-ONLY view of the document's custom
+ * CSS, shown above the markdown source. Custom CSS is edited in the styling
+ * palette (the single source of truth), not in the markdown pane — this is a
+ * transparency affordance so the author can see what CSS is applied while in
+ * markdown mode. Renders nothing when there is no custom CSS.
+ */
+export declare const SplitViewCssAccordion: ({ customCSS, }: SplitViewCssAccordionProps) => import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/package/components/split-view/split-view-markdown-pane.d.ts

@@ -6,6 +6,8 @@ interface SplitViewMarkdownPaneProps {
     /** Same uploader the editor uses — for the markdown toolbar's Image button. */
     ipfsImageUploadFn?: (file: File) => Promise<IpfsImageUploadResponse>;
     onError?: (error: string) => void;
+    /** Document custom CSS — shown read-only in a collapsible accordion. */
+    customCSS?: string;
     /** Sizing for the resizable split (flex-grow set by the draggable splitter). */
     style?: React.CSSProperties;
 }
@@ -15,5 +17,5 @@ interface SplitViewMarkdownPaneProps {
  * real ddoc editor itself — see ddoc-editor.tsx, which keeps that editor mounted
  * in place (never a second <EditorContent>) so its React node views survive.
  */
-export declare const SplitViewMarkdownPane: ({ markdown, onMarkdownChange, ipfsImageUploadFn, onError, style, }: SplitViewMarkdownPaneProps) => import("react/jsx-runtime").JSX.Element;
+export declare const SplitViewMarkdownPane: ({ markdown, onMarkdownChange, ipfsImageUploadFn, onError, customCSS, style, }: SplitViewMarkdownPaneProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/package/extensions/mardown-paste-handler/index.d.ts

@@ -7,6 +7,11 @@ export declare const turndownService: TurndownService;
 export declare const setMarkdownInlineStyles: (enabled: boolean) => void;
 export declare const setResolveColorVars: (enabled: boolean) => void;
 declare module '@tiptap/core' {
+    interface Storage {
+        markdownPasteHandler: {
+            customCSS: string;
+        };
+    }
     interface Commands {
         uploadMarkdownFile: {
             uploadMarkdownFile: (ipfsImageUploadFn?: (file: File) => Promise<IpfsImageUploadResponse>, onError?: (error: string) => void) => any;

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

@@ -7,7 +7,7 @@ export type EditorCommand = {
     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 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).

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

@@ -103,6 +103,17 @@ export interface DocumentStyling {
      * @example "portrait" | "landscape"
      */
     orientation?: 'portrait' | 'landscape';
+    /**
+     * Custom CSS
+     * @description The author's escape hatch for styling the document beyond the
+     * structured options above. Write BARE selectors (`h1 { … }`, `p { … }`,
+     * `blockquote { … }`) — they are auto-scoped to the document content, so rules
+     * can't leak into the toolbar or the host app. Bare top-level declarations
+     * (e.g. `background`, `font-family`) style the document surface itself.
+     * Applies live in the editor, in preview, and in exports (Markdown/HTML).
+     * @example "h1 { letter-spacing: -0.02em } p { line-height: 1.8 }"
+     */
+    customCSS?: string;
 }
 export interface DdocProps extends CommentAccountProps {
     /**

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/sanitize-css.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Sanitize + scope + validate author-supplied custom CSS before it is injected
+ * into the document.
+ *
+ * Authors write **normal, full-page CSS** — `body { … }`, `html body h1 { … }`,
+ * `h1 { … }`, `* { … }` — the way they'd style any web page. We transparently
+ * scope every rule to the document so it can't leak into the app, AND we map the
+ * page-root selectors (`html`, `body`, `:root`) onto the document root so that
+ * `body { background: … }` styles the doc surface and `html body h1 { … }`
+ * styles the doc's headings. No `.ProseMirror` prefix, no learning curve.
+ *
+ * Because the raw string reaches VIEWERS of a published doc, it is untrusted.
+ * Every selector is force-scoped (so a `}` breakout is neutralised — the escaped
+ * rule is simply scoped too), and dangerous declarations are stripped:
+ *  - external resource loads / exfiltration: `url(…)`, `@import`;
+ *  - clickjacking / UI redressing: `position: fixed | sticky`;
+ *  - legacy script vectors: `expression()`, `-moz-binding`, `behavior:`.
+ *
+ * We parse with the browser's own CSS engine (no dependency), rewrite each
+ * selector, strip dangerous declarations at every nesting level, and let the
+ * engine re-serialise — so the output is always a valid, balanced stylesheet.
+ *
+ * The sanitizer knows exactly what it removed, so it returns non-blocking
+ * `diagnostics`; the editing UI surfaces them (CSS is forgiving — we warn,
+ * never block).
+ */
+export interface CssDiagnostic {
+    level: 'warning' | 'error';
+    message: string;
+}
+export interface CssValidationResult {
+    /** Sanitized, scoped CSS, safe to inject. '' when nothing survives. */
+    css: string;
+    /** What was stripped/ignored, deduped. Empty when the CSS was fully clean. */
+    diagnostics: CssDiagnostic[];
+}
+/**
+ * Sanitize + scope AND report. Use this from the editing UI for diagnostics.
+ */
+export declare const validateCustomCss: (raw: string | undefined | null, scope?: string) => CssValidationResult;
+/**
+ * Sanitized + scoped CSS only — used at injection/export sinks that just need
+ * the safe string. Diagnostics are surfaced separately via validateCustomCss.
+ */
+export declare const sanitizeCustomCss: (raw: string | undefined | null, scope?: string) => string;

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/{split-view-toolbar-D4bIgxWm.mjs → split-view-toolbar-Ikwoly83.mjs}

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