@fileverse-dev/ddoc 4.1.11 → 4.1.12-durability-1

package/dist/{index-rpz9D-nF.mjs → index-DOdUt7ap.mjs}

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

@@ -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-BhAjJb8w.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-CTR-epIo.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-DTszGHF9.mjs → markdown-source-pane-CHsU7nVH.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-CTR-epIo.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-DOdUt7ap.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-tab-editor.d.ts

@@ -17,7 +17,6 @@ interface UseTabEditorArgs {
     initialContent: DdocProps['initialContent'];
     collaboration?: CollaborationProps;
     isReady?: boolean;
-    isSyncing?: boolean;
     awareness?: any;
     disableInlineComment?: boolean;
     isFocusMode?: boolean;
@@ -45,6 +44,8 @@ interface UseTabEditorArgs {
     ignoreCorruptedData?: boolean;
     onCollaboratorChange?: DdocProps['onCollaboratorChange'];
     onConnect: (connectConfig: CollabConnectionConfig) => void;
+    onDisconnect: () => void;
+    isIndexeddbSynced: boolean;
     hasCollabContentInitialised?: boolean;
     initialiseYjsIndexedDbProvider: () => Promise<void>;
     externalExtensions?: Record<string, AnyExtension>;
@@ -56,7 +57,7 @@ interface UseTabEditorArgs {
     initialCommentAnchors?: SerializedCommentAnchor[];
     dBlockRuntimeStateRef?: DBlockRuntimeStateRef;
 }
-export declare const useTabEditor: ({ ydoc, isVersionMode, hasTabState, versionId, isPreviewMode, viewerMode, initialContent, collaboration, isReady, isSyncing, 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, onCollaboratorChange, onConnect, hasCollabContentInitialised, initialiseYjsIndexedDbProvider, externalExtensions, isContentLoading, activeTabId, tabIds, theme, editorRef, initialCommentAnchors, dBlockRuntimeStateRef, }: UseTabEditorArgs) => {
+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, onCollaboratorChange, onConnect, onDisconnect, isIndexeddbSynced, hasCollabContentInitialised, initialiseYjsIndexedDbProvider, externalExtensions, isContentLoading, activeTabId, tabIds, theme, editorRef, initialCommentAnchors, dBlockRuntimeStateRef, }: UseTabEditorArgs) => {
     editor: Editor | null;
     cachedEditorEntries: import('./use-tab-editor-cache').CachedTabEditorRenderEntry[];
     ref: import('react').RefObject<HTMLDivElement>;

package/dist/package/hooks/use-yjs-setup.d.ts

@@ -11,6 +11,7 @@ interface UseYjsSetupArgs {
 export declare const useYjsSetup: ({ onChange, enableIndexeddbSync, ddocId, collaboration, onIndexedDbError, }: UseYjsSetupArgs) => {
     ydoc: Y.Doc;
     onConnect: (connectConfig: import('../types').CollabConnectionConfig) => void;
+    onDisconnect: () => void;
     isReady: boolean;
     isSyncing: boolean;
     terminateSession: () => void;

package/dist/package/sync-local/SyncManager.d.ts

@@ -11,21 +11,23 @@ export declare class SyncManager {
     private roomKeyBytes;
     private isOwner;
     private updateQueue;
-    private uncommittedUpdatesIdList;
     private contentTobeAppliedQueue;
     private isProcessing;
     private syncId;
+    private floor;
+    private updatesSinceSnapshot;
+    private isAuthoringSnapshot;
+    private readonly SNAPSHOT_THRESHOLD;
     private flushTimer;
     private readonly FLUSH_INTERVAL_MS;
     private readonly MAX_QUEUE_SIZE;
     private _awarenessUpdateHandler;
     private ydoc;
-    private servicesRef;
     private callbacksRef;
     private onLocalUpdate?;
     constructor(config: SyncManagerConfig, onCollabStateChange: (state: CollabState) => void);
     /** Called by useSyncManager on every render to keep refs fresh */
-    updateRefs(services: CollabServices | undefined, callbacks: CollabCallbacks | undefined, onLocalUpdate?: (updatedDocContent: string, updateChunk: string) => void): void;
+    updateRefs(_services: CollabServices | undefined, callbacks: CollabCallbacks | undefined, onLocalUpdate?: (updatedDocContent: string, updateChunk: string) => void): void;
     get isConnected(): boolean;
     get isReady(): boolean;
     get awareness(): Awareness | null;
@@ -46,21 +48,23 @@ export declare class SyncManager {
      * Fire-and-forget: merge all queued updates, encrypt, and emit via Socket.IO
      * without awaiting the server ACK. The server broadcasts to peers immediately
      * (before MongoDB write), so content reaches observers in near-real-time.
-     * ACK callback handles updateId tracking and auto-commit asynchronously.
      */
     private sendUpdateBatch;
+    buildPendingBeaconPayload(): string | null;
+    fireBeacon(): void;
     forceCleanup(): void;
     private handleConnectionError;
     private handleReconnection;
     private connectSocket;
-    private syncLatestCommit;
+    private decodeInto;
+    private catchUpFloor;
+    private authorSnapshot;
+    private hydrate;
     private initializeAwareness;
     private cleanupAwareness;
-    private commitLocalContents;
     private broadcastLocalContents;
     private processUpdateQueue;
     private processNextUpdate;
-    private processCommit;
     private handleRemoteContentUpdate;
     private applyRemoteYjsUpdate;
     private applyQueuedRemoteContents;

package/dist/package/sync-local/floor.d.ts

@@ -0,0 +1,6 @@
+export declare function advanceFloor(floor: number, pageSeqsAscending: number[]): number;
+export declare function shouldAuthorSnapshot(p: {
+    isOwner: boolean;
+    updatesSinceLastSnapshot: number;
+    threshold: number;
+}): boolean;

package/dist/package/sync-local/socketClient.d.ts

@@ -1,4 +1,4 @@
-import { ISocketInitConfig, RoomMember, SocketStatusEnum, SendUpdateResponse, CommitResponse, AckResponse } from './types';
+import { ISocketInitConfig, RoomMember, SocketStatusEnum, SendUpdateResponse, HydrationResponse, SnapshotResponse, AckResponse } from './types';
 import { Awareness } from 'y-protocols/awareness.js';
 
 interface ISocketClientConfig {
@@ -8,6 +8,9 @@ interface ISocketClientConfig {
     ownerEdSecret?: string;
     contractAddress?: string;
     ownerAddress?: string;
+    ownerIdentityDid?: string;
+    editLock?: string;
+    encryptedTitle?: string;
     onHandshakeData?: (response: {
         data: AckResponse;
         roomKey: string;
@@ -20,6 +23,8 @@ interface ISocketClientConfig {
 }
 export declare class SocketClient {
     private _socketUrl;
+    private _restBase;
+    private _lastSessionToken;
     private _socket;
     private _webSocketStatus;
     private _isIntentionalDisconnect;
@@ -34,6 +39,9 @@ export declare class SocketClient {
     private ownerUcan?;
     private collaborationUcan?;
     private ownerAddress?;
+    private ownerIdentityDid?;
+    private editLock?;
+    private encryptedTitle?;
     private roomKey;
     private roomInfo?;
     private awareness;
@@ -46,15 +54,17 @@ export declare class SocketClient {
     sendUpdate({ update }: {
         update: string;
     }): Promise<SendUpdateResponse>;
-    commitUpdates({ updates, cid }: {
-        updates: string[];
-        cid: string;
-    }): Promise<CommitResponse>;
-    fetchLatestCommit(): Promise<AckResponse<any>>;
-    getUncommittedChanges(): Promise<AckResponse<any>>;
+    fetchHydrationRange(sinceSeq?: number): Promise<HydrationResponse>;
+    sendSnapshot({ data, floorSeq, publishedMarker, }: {
+        data: string;
+        floorSeq: number;
+        publishedMarker?: string | null;
+    }): Promise<SnapshotResponse>;
+    setDocumentMeta(): Promise<void>;
     broadcastAwareness(awarenessUpdate: string): Promise<void>;
     disconnect: () => void;
     terminateSession: () => Promise<void>;
+    flushBeacon(mergedUpdate: string): void;
     private getCollaborationKeyPair;
     private isUcanValid;
     private getOwnerToken;

package/dist/package/sync-local/types/index.d.ts

@@ -7,6 +7,16 @@ export interface CollabConnectionConfig {
     roomId: string;
     wsUrl: string;
     isOwner: boolean;
+    /** Host signal: doc is in an active live-collaboration context (shared / peers present). Keeps the socket connected. */
+    livePresence?: boolean;
+    /** Host signal: connect once on open to initialise durability even without an edit. */
+    connectOnOpen?: boolean;
+    /** Host signal (owner-only): the owner identity signingKey DID. Recorded by the durable server on the first owner /auth as the R3 owner binding. */
+    ownerIdentityDid?: string;
+    /** Host signal (owner-only): wrapped roomKey bytes (owner-lock construction), uploaded as the server editLock recovery artifact. Opaque to the package. */
+    editLock?: string;
+    /** Host signal (owner-only): the document title encrypted with the roomKey, uploaded as the server title recovery artifact. Opaque to the package. */
+    encryptedTitle?: string;
     ownerEdSecret?: string;
     contractAddress?: string;
     ownerAddress?: string;
@@ -21,11 +31,7 @@ export interface CollabSessionMeta {
     username: string;
     isEns?: boolean;
 }
-/** Storage integrations the sync engine depends on */
-export interface CollabServices {
-    commitToStorage?: (file: File) => Promise<string>;
-    fetchFromStorage?: (cid: string) => Promise<any>;
-}
+export type CollabServices = Record<string, never>;
 export type CollabErrorCode = 'CONNECTION_FAILED' | 'AUTH_FAILED' | 'SYNC_FAILED' | 'TIMEOUT' | 'UNKNOWN';
 export type CollabError = {
     code: CollabErrorCode;
@@ -145,11 +151,30 @@ export interface SendUpdateResponse extends AckResponse<{
     createdAt: number;
 }> {
 }
-export interface CommitResponse extends AckResponse<{
-    cid: string;
-    createdAt: number;
+export interface HydrationRow {
+    id: string;
     documentId: string;
-    updates: string[];
+    seq: number;
+    data: string;
+    updateType: string;
+    committed?: boolean;
+    commitCid?: string | null;
+    createdAt?: number;
+    sessionDid?: string;
+    publishedMarker?: string | null;
+    floorSeq?: number | null;
+}
+export interface HydrationResponse extends AckResponse<{
+    history: HydrationRow[];
+    total: number;
+    snapshot: HydrationRow | null;
+    nextSeq: number | null;
+    hasMore: boolean;
+}> {
+}
+export interface SnapshotResponse extends AckResponse<{
+    id: string;
+    seq: number;
 }> {
 }
 export interface ISocketInitConfig {
@@ -196,4 +221,5 @@ export interface IAuthArgs {
     contractAddress?: string;
     sessionDid?: string;
     roomInfo?: string;
+    ownerIdentityDid?: string;
 }

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/use-ddoc-editor.d.ts

@@ -28,6 +28,7 @@ export declare const useDdocEditor: ({ isPreviewMode, viewerMode, initialContent
     duplicateTab: (tabId: string) => string | undefined;
     orderTab: (destinationTabId: string, movedTabId: string) => void;
     onConnect: (connectConfig: import('./types').CollabConnectionConfig) => void;
+    onDisconnect: () => void;
     isReady: boolean;
     isSyncing: boolean;
     hasCollabContentInitialised: boolean;

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

@@ -1,7 +1,7 @@
-import { j as d } from "./index-BhAjJb8w.mjs";
+import { j as d } from "./index-CTR-epIo.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-DOdUt7ap.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(