@fileverse-dev/ddoc 6.0.0-drop-in.2 → 6.0.0-drop-in.3

package/dist/{markdown-source-pane-CXO7aIOp.mjs → markdown-source-pane-D-8OmL1r.mjs}

@@ -3,7 +3,7 @@ var Wr = (t, e, O) => e in t ? Vr(t, e, { enumerable: !0, configurable: !0, writ
 var gt = (t, e, O) => Wr(t, typeof e != "symbol" ? e + "" : e, O);
 import { jsx as Cr } from "react/jsx-runtime";
 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-8MQH4TSF.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-eP_xxZsk.mjs";
 class ua {
   /**
   Create a new completion context. (Mostly useful for testing

package/dist/package/hooks/use-doc-schema-version.d.ts

@@ -1,11 +1,13 @@
+import { SchemaStampGuardEvent } from '../types';
 import * as Y from 'yjs';
 interface UseDocSchemaVersionArgs {
     ydoc: Y.Doc;
     isNewDdoc: boolean;
     isContentResolved: boolean;
     preferredSchemaVersion?: number;
+    onSchemaStampGuard?: (event: SchemaStampGuardEvent) => void;
 }
-export declare const useDocSchemaVersion: ({ ydoc, isNewDdoc, isContentResolved, preferredSchemaVersion, }: UseDocSchemaVersionArgs) => {
+export declare const useDocSchemaVersion: ({ ydoc, isNewDdoc, isContentResolved, preferredSchemaVersion, onSchemaStampGuard, }: UseDocSchemaVersionArgs) => {
     docSchemaVersion: number;
     isSchemaUnsupported: boolean;
 };

package/dist/package/sync-local/server-clock.d.ts

@@ -0,0 +1,26 @@
+import type * as ucans from '@ucans/ucans';
+/**
+ * The collab server's clock, learned from its handshake. The server checks auth UCAN nbf/exp
+ * against its own clock, so tokens built from a skewed device clock get a 401.
+ */
+export declare class ServerClock {
+    private readonly wallNow;
+    private readonly monoNow;
+    private anchor;
+    constructor(wallNow?: () => number, monoNow?: (() => number) | null);
+    /**
+     * Time since the handshake is measured on the monotonic clock, so a device clock change
+     * mid-session cannot skew it. A missing or implausible stamp (older server) falls back to the
+     * device clock. Delivery delay and sleep only make the estimate trail the server, which the
+     * token window absorbs.
+     */
+    sync(serverTimeMs: unknown): void;
+    nowSeconds(): number;
+    ucanWindow(): {
+        notBefore: number;
+        expiration: number;
+    };
+    /** Whether a cached UCAN can still be presented: active, and not expiring within the margin. */
+    isUsable(ucan: ucans.Ucan): boolean;
+    private elapsedBase;
+}

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

@@ -74,6 +74,7 @@ export declare class SocketClient {
     private contractAddress?;
     private ownerUcan?;
     private collaborationUcan?;
+    private serverClock;
     private ownerAddress?;
     private ddocId?;
     private editLock?;
@@ -130,7 +131,6 @@ export declare class SocketClient {
     terminateSession: () => Promise<void>;
     flushBeacon(mergedUpdate: string): void;
     private getCollaborationKeyPair;
-    private isUcanValid;
     private getOwnerToken;
     private buildSessionToken;
     private _authenticate;

package/dist/package/types.d.ts

@@ -143,6 +143,15 @@ export interface DdocProps extends CommentAccountProps {
     };
     tabSectionContainer?: HTMLElement;
     isCollabDocumentPublished?: boolean;
+    /**
+     * Storage-agnostic image fetch function. Receives the stored location of an
+     * encrypted image (`url` + `contentRef`, e.g. an IPFS gateway URL + CID or a
+     * Swarm URL + reference) along with its decryption parameters, and returns
+     * the decrypted image. Preferred over the deprecated `ipfsImageFetchFn`;
+     * when both are provided, `imageFetchFn` wins.
+     */
+    imageFetchFn?: ImageFetchFn;
+    /** @deprecated Use the storage-agnostic `imageFetchFn` instead. */
     ipfsImageFetchFn?: (_data: IpfsImageFetchPayload) => Promise<{
         url: string;
         file: File;
@@ -191,6 +200,15 @@ export interface DdocProps extends CommentAccountProps {
     isPreviewMode?: boolean;
     viewerMode?: 'suggest' | 'view-only';
     ensResolutionUrl?: string;
+    /**
+     * Storage-agnostic image upload function. Encrypts and stores the file on
+     * the host's storage backend (IPFS, Swarm, ...) and returns its location
+     * (`url` + `contentRef`) plus the decryption parameters. Preferred over the
+     * deprecated `ipfsImageUploadFn`; when both are provided, `imageUploadFn`
+     * wins.
+     */
+    imageUploadFn?: ImageUploadFn;
+    /** @deprecated Use the storage-agnostic `imageUploadFn` instead. */
     ipfsImageUploadFn?: (file: File) => Promise<IpfsImageUploadResponse>;
     enableIndexeddbSync?: boolean;
     ddocId?: string;
@@ -298,7 +316,19 @@ export interface DdocProps extends CommentAccountProps {
      * @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.
      */
     onIndexedDbError?: (error: Error) => void;
+    /**
+     * Called when the schema-version stamp was refused or reverted
+     * @description The editor stamps brand-new docs with the preferred schema. If the host passed an empty body for a doc that turns out to hold v1 content, the stamp is blocked (or reverted when the content arrived late). Hosts report these to see how often an existing doc is mounted without its body.
+     */
+    onSchemaStampGuard?: (event: SchemaStampGuardEvent) => void;
 }
+export type SchemaStampGuardEvent = {
+    kind: 'blocked';
+    preferredSchemaVersion: number;
+} | {
+    kind: 'reverted';
+    preferredSchemaVersion: number;
+};
 export interface IEditorSelectionData {
     from: number;
     to: number;
@@ -314,6 +344,39 @@ export interface IUser {
     isEns: boolean;
 }
 export { type IComment };
+/**
+ * Storage-agnostic result of an image upload. The editor treats both fields
+ * as opaque: `url` is a fetchable location of the encrypted blob (e.g. an
+ * IPFS gateway URL or a Swarm `/bytes` URL) and `contentRef` is the backend's
+ * content address (IPFS CID, Swarm reference, ...). Both are stored in the
+ * document and handed back verbatim to `imageFetchFn`.
+ */
+export interface StorageImageUploadResponse {
+    encryptionKey: string;
+    nonce: string;
+    authTag: string;
+    url: string;
+    contentRef: string;
+}
+/**
+ * Storage-agnostic payload handed to `imageFetchFn`: the `url`/`contentRef`
+ * returned by `imageUploadFn` at upload time, plus the parameters needed to
+ * decrypt the blob.
+ */
+export interface StorageImageFetchPayload {
+    encryptionKey: string;
+    nonce: string;
+    authTag: string;
+    mimeType: string;
+    url: string;
+    contentRef: string;
+}
+export type ImageUploadFn = (file: File) => Promise<StorageImageUploadResponse>;
+export type ImageFetchFn = (_data: StorageImageFetchPayload) => Promise<{
+    url: string;
+    file: File;
+}>;
+/** @deprecated Use the storage-agnostic {@link StorageImageUploadResponse} instead. */
 export interface IpfsImageUploadResponse {
     encryptionKey: string;
     nonce: string;
@@ -321,6 +384,7 @@ export interface IpfsImageUploadResponse {
     ipfsHash: string;
     authTag: string;
 }
+/** @deprecated Use the storage-agnostic {@link StorageImageFetchPayload} instead. */
 export interface IpfsImageFetchPayload {
     encryptionKey: string;
     nonce: string;

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

@@ -3,7 +3,7 @@ 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, ...rest }: Partial<DdocProps> & {
+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> & {
     isFocusMode?: boolean;
     isPreviewEditor?: boolean;
     editorWidthStore?: EditorWidthStore;

package/dist/package/utils/focus-mode-canvas-click.d.ts

@@ -0,0 +1,2 @@
+/** Whether a focus-mode mousedown landed on the bare canvas around the page. */
+export declare const isFocusModeCanvasClick: (target: Element, editorContent: Element | null) => boolean;

package/dist/package/utils/schema-version.d.ts

@@ -4,3 +4,5 @@ export declare const SCHEMA_VERSION_META_KEY = "schemaVersion";
 export declare const SUPPORTED_SCHEMA_VERSION = 2;
 export declare const getDocSchemaVersion: (doc: Y.Doc) => number;
 export declare const isDocSchemaSupported: (doc: Y.Doc) => boolean;
+export declare const docHasBlockContent: (doc: Y.Doc) => boolean;
+export declare const docHasV1Blocks: (doc: Y.Doc) => boolean;

package/dist/package/utils/storage-adapter.d.ts

@@ -0,0 +1,30 @@
+import { ImageFetchFn, ImageUploadFn, IpfsImageFetchPayload, IpfsImageUploadResponse } from '../types';
+
+/**
+ * Boundary adapters between the storage-agnostic public props
+ * (`imageUploadFn` / `imageFetchFn`) and the IPFS-shaped interface the editor
+ * internals still use. Internals are untouched: a storage-agnostic host
+ * function is wrapped here, at the prop boundary, so that downstream code
+ * keeps seeing the legacy `ipfsUrl` / `ipfsHash` field names regardless of
+ * which backend the host actually stores on.
+ */
+type LegacyImageUploadFn = (file: File) => Promise<IpfsImageUploadResponse>;
+type LegacyImageFetchFn = (_data: IpfsImageFetchPayload) => Promise<{
+    url: string;
+    file: File;
+}>;
+/**
+ * Resolve the upload function to use internally. The storage-agnostic
+ * `imageUploadFn` wins over the deprecated `ipfsImageUploadFn`; its response
+ * is mapped onto the legacy field names (`url` → `ipfsUrl`,
+ * `contentRef` → `ipfsHash`).
+ */
+export declare const resolveImageUploadFn: (imageUploadFn?: ImageUploadFn, ipfsImageUploadFn?: LegacyImageUploadFn) => LegacyImageUploadFn | undefined;
+/**
+ * Resolve the fetch function to use internally. The storage-agnostic
+ * `imageFetchFn` wins over the deprecated `ipfsImageFetchFn`; the legacy
+ * payload built by the internals is mapped onto the agnostic field names
+ * (`ipfsUrl` → `url`, `ipfsHash` → `contentRef`).
+ */
+export declare const resolveImageFetchFn: (imageFetchFn?: ImageFetchFn, ipfsImageFetchFn?: LegacyImageFetchFn) => LegacyImageFetchFn | undefined;
+export {};

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

@@ -1,7 +1,7 @@
 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-8MQH4TSF.mjs";
+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(