@fileverse-dev/ddoc 4.1.9 → 4.1.11-patch-1

package/dist/index.d.ts

@@ -5,6 +5,8 @@ export { DdocExportModal } from './package/components/export-modal';
 export { useHeadlessEditor } from './package/hooks/use-headless-editor';
 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,12 +1,14 @@
-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-nuyyRI2j.mjs";
+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-ES2pPSG6.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 useExportHeadlessEditorContent,
-  l as useHeadlessEditor
+  E as sanitizeCustomCss,
+  l as useExportHeadlessEditorContent,
+  u as useHeadlessEditor,
+  C as validateCustomCss
 };

package/dist/{markdown-source-pane-CJNood8d.mjs → markdown-source-pane-CL7ZPDWq.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-nuyyRI2j.mjs";
+import { j as Cr } from "./index-ES2pPSG6.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-DRxp2R0b.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-CqX0iYGN.mjs";
 class ua {
   /**
   Create a new completion context. (Mostly useful for testing

package/dist/package/components/inline-comment/mobile-inline-comment-sheet.d.ts

@@ -3,6 +3,7 @@ import { InlineCommentDraft } from './context/types';
 interface MobileInlineCommentProps {
     activeDraft: InlineCommentDraft | null;
     activeDraftId: string | null;
+    isConnected: boolean;
     isDiscardCommentOverlayVisible: boolean;
     mobileDraftRef: React.RefObject<HTMLDivElement>;
     onAttemptClose: () => void;
@@ -11,5 +12,5 @@ interface MobileInlineCommentProps {
     onSubmit: () => void;
     onUpdateDraftText: (draftId: string, text: string) => void;
 }
-export declare const MobileInlineComment: ({ activeDraft, activeDraftId, isDiscardCommentOverlayVisible, mobileDraftRef, onAttemptClose, onCancelDiscard, onConfirmDiscard, onSubmit, onUpdateDraftText, }: MobileInlineCommentProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MobileInlineComment: ({ activeDraft, activeDraftId, isConnected, isDiscardCommentOverlayVisible, mobileDraftRef, onAttemptClose, onCancelDiscard, onConfirmDiscard, onSubmit, onUpdateDraftText, }: MobileInlineCommentProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/package/components/inline-comment/use-auto-submit-countdown.d.ts

@@ -0,0 +1,10 @@
+interface UseAutoSubmitCountdownProps {
+    label: string;
+    onSubmit: () => void;
+    resetKey: string | null;
+    shouldRun: boolean;
+}
+export declare const useAutoSubmitCountdown: ({ label, onSubmit, resetKey, shouldRun, }: UseAutoSubmitCountdownProps) => {
+    submitLabel: string;
+};
+export {};

package/dist/package/components/inline-comment/use-comment-draft-auto-submit-countdown.d.ts

@@ -0,0 +1,11 @@
+interface UseCommentDraftAutoSubmitCountdownProps {
+    draftId: string | null;
+    canAutoSubmit: boolean;
+    onSubmit: () => void;
+}
+export declare const useCommentDraftAutoSubmitCountdown: ({ draftId, canAutoSubmit, onSubmit, }: UseCommentDraftAutoSubmitCountdownProps) => {
+    handleDraftBlur: () => void;
+    handleDraftFocus: () => void;
+    submitLabel: string;
+};
+export {};

package/dist/package/components/inline-comment/use-suggestion-auto-submit-countdown.d.ts

@@ -0,0 +1,9 @@
+interface UseSuggestionAutoSubmitCountdownProps {
+    suggestionId: string;
+    canAutoSubmit: boolean;
+    onSubmit: () => void;
+}
+export declare const useSuggestionAutoSubmitCountdown: ({ suggestionId, canAutoSubmit, onSubmit, }: UseSuggestionAutoSubmitCountdownProps) => {
+    submitLabel: string;
+};
+export {};

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/comment/comment-decoration-plugin.d.ts

@@ -46,6 +46,7 @@ export declare function resolveCommentAnchorRangeInState(anchor: Pick<CommentAnc
  * so we need a separate path that allows a point position.
  */
 export declare function resolveCommentAnchorPointInState(anchor: Pick<CommentAnchor, 'anchorFrom'>, state: EditorState): number | null;
+export declare function hasResolvableCommentAnchorInState(anchor: Pick<CommentAnchor, 'anchorFrom' | 'anchorTo' | 'isSuggestion' | 'suggestionType'>, state: EditorState): boolean;
 export declare function resolveCommentAnchorRangeForAnalysis(anchor: Pick<CommentAnchor, 'id' | 'anchorFrom' | 'anchorTo'>, state: EditorState): CommentAnchorRange | null;
 export declare function resolveCommentAnchorPointForAnalysis(anchor: Pick<CommentAnchor, 'id' | 'anchorFrom'>, state: EditorState): number | null;
 /**

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/extensions/suggestion/suggestion-tracking-extension.d.ts

@@ -23,6 +23,8 @@ export interface SuggestionTrackingOptions {
     onDeleteSelection: (from: number, to: number) => void;
     /** Viewer pastes a link over selected text. */
     onPasteLink: (from: number, to: number, href: string) => void;
+    /** Viewer attempted an unsupported paste/drop in suggestion mode. */
+    onUnsupportedPaste?: () => void;
     /**
      * Viewer presses Backspace/Delete with a collapsed cursor.
      * The consumer decides whether this should shrink an active draft or create

package/dist/package/stores/comment-store.d.ts

@@ -126,6 +126,8 @@ export interface CommentStoreState {
     pendingPrehydrationFloatingThreadIds: string[];
     /** In-progress suggestion drafts — keyed by suggestionId. Viewer-local, lost on refresh. */
     drafts: Record<string, DraftSuggestion>;
+    /** Suggestion draft currently under the focused editor cursor, if any. */
+    activeSuggestionDraftIdAtCursor: string | null;
     inlineDrafts: InlineDraftRecordMap;
     activeDraftId: string | null;
     isDesktopFloatingEnabled: boolean;
@@ -255,6 +257,11 @@ export interface CommentStoreState {
      * range while the viewer's draft is open.
      */
     refreshDraftOriginalContent: (suggestionId: string, currentText: string) => void;
+    /**
+     * Sync the draft id under the current editor cursor. Each draft card uses
+     * this to decide whether its own auto-submit countdown should run.
+     */
+    syncActiveSuggestionDraftAtCursor: () => void;
     /**
      * Promote a draft to a submitted suggestion. Pushes the anchor into
      * commentAnchorsRef, calls onNewComment, removes the draft, and swaps the

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

@@ -0,0 +1,45 @@
+/**
+ * Sanitize + validate author-supplied custom CSS before it is injected into the
+ * document.
+ *
+ * Custom CSS travels to VIEWERS of a published document, so the raw string is
+ * NOT a trusted stylesheet. We defend against:
+ *  - scope breakout: a `}` in the CSS escaping the `scope { … }` wrapper to
+ *    style the whole app (toolbar, other content, security UI, overlays);
+ *  - external resource loads / exfiltration: `url(…)` and `@import` (tracking
+ *    beacons, plus CSS attribute-selector data exfiltration);
+ *  - clickjacking / UI redressing: `position: fixed | sticky` overlays that
+ *    escape the document box and cover the viewport;
+ *  - legacy script vectors: `expression()`, `-moz-binding`, `behavior:`.
+ *
+ * Strategy: wrap the raw CSS in `scope { … }` and parse it with the browser's
+ * own CSS engine (no dependency, no regex parsing). A well-formed input yields
+ * exactly ONE top-level rule whose selector is `scope`; a breakout produces
+ * extra top-level rules with other selectors — we keep only `scope` rules and
+ * drop the rest. Dangerous declarations are stripped at every nesting level.
+ * The kept rules are re-serialized by the engine, so the output is always a
+ * valid, balanced stylesheet.
+ *
+ * The sanitizer knows exactly what it removed, so it also returns non-blocking
+ * `diagnostics` — the editing UI shows these so authors aren't left wondering
+ * why a rule silently vanished (CSS is forgiving; we warn, never block).
+ */
+export interface CssDiagnostic {
+    level: 'warning' | 'error';
+    message: string;
+}
+export interface CssValidationResult {
+    /** Sanitized, scope-wrapped CSS, safe to inject. '' when nothing survives. */
+    css: string;
+    /** What was stripped/ignored, deduped. Empty when the CSS was fully clean. */
+    diagnostics: CssDiagnostic[];
+}
+/**
+ * Sanitize AND report. Use this from the editing UI to surface diagnostics.
+ */
+export declare const validateCustomCss: (raw: string | undefined | null, scope?: string) => CssValidationResult;
+/**
+ * Sanitized 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/{split-view-toolbar-DQ9aZxVZ.mjs → split-view-toolbar-Kh-dQ_qt.mjs}

@@ -1,7 +1,7 @@
-import { j as d } from "./index-nuyyRI2j.mjs";
+import { j as d } from "./index-ES2pPSG6.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-DRxp2R0b.mjs";
+import { a3 as A, a4 as P, c as y } from "./index-CqX0iYGN.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(