@fileverse-dev/dsheet 4.0.5-edit-mode-5 → 4.0.5-edit-mode-7

package/dist/editor/components/editor-workbook.d.ts

@@ -25,6 +25,7 @@ interface EditorWorkbookProps {
     sidebarPortalRegistry?: SidebarPortalRegistryHandle | null;
     sidebarPortalRenderers?: Record<string, SidebarPortalRenderer>;
     permissionMode?: DSheetPermissionMode | null;
+    onEnterEdit?: () => void;
     theme?: ThemeKey;
 }
 export declare const EditorWorkbook: React.NamedExoticComponent<EditorWorkbookProps>;

package/dist/editor/components/permission-chip-model.d.ts

@@ -13,6 +13,10 @@ export declare const getPermissionChipConfig: (mode: DSheetPermissionMode) => {
     readonly label: "Edit";
     readonly modifier: "edit";
 };
+export declare const canShowEditElevation: ({ mode, onEnterEdit, }: {
+    mode: DSheetPermissionMode;
+    onEnterEdit?: () => void;
+}) => boolean;
 export declare const resolvePermissionChipMode: ({ allowComments, isReadOnly, permissionMode, }: {
     allowComments: boolean;
     isReadOnly: boolean;

package/dist/editor/components/permission-chip.d.ts

@@ -3,6 +3,7 @@ import { DSheetPermissionMode } from '../types';
 
 interface PermissionChipProps {
     mode: DSheetPermissionMode;
+    onEnterEdit?: () => void;
 }
 export declare const PermissionChip: React.FC<PermissionChipProps>;
 export {};

package/dist/editor/contexts/editor-context.d.ts

@@ -11,7 +11,7 @@ import { CollaborationProps, CollabState, CollabUser } from '../../sync-local/ty
 import { Awareness } from 'y-protocols/awareness';
 import { DSheetContentSnapshot } from '../../persistence';
 
-import * as Y from "yjs";
+import * as Y from 'yjs';
 export interface EditorContextType {
     setIsDataLoaded: React.Dispatch<React.SetStateAction<boolean>>;
     handleOnChangePortalUpdate: () => void;
@@ -44,7 +44,7 @@ export interface EditorContextType {
     loading: boolean;
     forceSheetRender: number;
     setForceSheetRender: React.Dispatch<React.SetStateAction<number>>;
-    syncStatus: "initializing" | "syncing" | "synced" | "error";
+    syncStatus: 'initializing' | 'syncing' | 'synced' | 'error';
     collabEnabled?: boolean;
     isLiveCollabSession: boolean;
     collabIsOwner?: boolean;
@@ -101,7 +101,8 @@ interface EditorProviderProps {
     apiKeyStorage?: ApiKeyStorage;
     onDataBlockEvent?: (event: DataBlockEvent) => void;
     smartContracts?: SmartContractConfig;
-    onContentSyncStatusChange?: (status: "initializing" | "syncing" | "synced" | "error") => void;
+    onContentSyncStatusChange?: (status: 'initializing' | 'syncing' | 'synced' | 'error') => void;
+    onCollaborationInitializationComplete?: (result: 'ready' | 'error') => void;
     onIndexedDbError?: (error: Error) => void;
 }
 export declare const EditorProvider: React.FC<EditorProviderProps>;

package/dist/editor/hooks/collaboration-lifecycle.d.ts

@@ -7,6 +7,11 @@ export declare const isQualifyingCollaborationEdit: (origin: unknown, indexeddbO
 export declare const shouldRenderBootstrappedWorkbook: (collabEnabled: boolean, sheetCount: number) => boolean;
 export declare const shouldInitializeDefaultWorkbook: (syncStatus: string | undefined, collabEnabled: boolean, collabStatus: string | undefined) => boolean;
 export declare const getWorkbookHydrationReason: (status: string | undefined, previousStatus: string | undefined, hasHydratedReadyState: boolean) => "initial" | "reconnect" | null;
+export declare const shouldRehydrateWorkbookOnReady: ({ reason, isOwner, hasUnmergedPeerUpdates, }: {
+    reason: "initial" | "reconnect";
+    isOwner: boolean;
+    hasUnmergedPeerUpdates: boolean;
+}) => boolean;
 export interface CollaborationConnectionController {
     onYdocUpdate: (update: Uint8Array, origin: unknown) => void;
     dispose: () => void;

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

@@ -1,6 +1,6 @@
 import { IndexeddbPersistence } from 'y-indexeddb';
 import { CollaborationProps } from '../../sync-local/types';
-import * as Y from "yjs";
+import * as Y from 'yjs';
 export declare const useEditorSync: (dsheetId: string, enableIndexeddbSync?: boolean, isReadOnly?: boolean, portalContent?: string, collaboration?: CollaborationProps, onCollabUpdate?: (fullState: string, updateChunk: string) => void, onIndexedDbError?: (error: Error) => void) => {
     ydocRef: import('react').MutableRefObject<Y.Doc | null>;
     persistenceRef: import('react').MutableRefObject<IndexeddbPersistence | null>;

package/dist/editor/types.d.ts

@@ -8,9 +8,9 @@ import { ApiKeyStorage } from './utils/api-key-storage';
 import { ThemeKey } from '../sheet-engine/core/theme';
 import { DSheetContentSnapshot } from '../persistence';
 
-import * as Y from "yjs";
+import * as Y from 'yjs';
 export type { ThemeKey } from '../sheet-engine/core/theme';
-export type DSheetPermissionMode = "view" | "comment" | "edit";
+export type DSheetPermissionMode = 'view' | 'comment' | 'edit';
 export type { CommentThread, CommentReply, CommentActionParams, CommentsConfig, } from './types/comments';
 export { CommentAction } from './types/comments';
 export interface SheetUpdateData {
@@ -50,7 +50,7 @@ export type OnboardingHandlerType = (params: {
     row: number;
     column: number;
 };
-export type DataBlockEventType = "success" | "error" | "api-key-required" | "api-key-saved" | "retry";
+export type DataBlockEventType = 'success' | 'error' | 'api-key-required' | 'api-key-saved' | 'retry';
 export interface DataBlockEvent {
     type: DataBlockEventType;
     functionName?: string;
@@ -86,6 +86,9 @@ export interface DsheetProps {
     /** Permission status displayed above the toolbar. When omitted, read-only
      * sheets retain the existing View/View-and-comment behavior. */
     permissionMode?: DSheetPermissionMode;
+    /** Called when a read-only consumer asks to elevate to edit mode. The host
+     * owns access proof, loading, errors, and the resulting mode transition. */
+    onEnterEdit?: () => void;
     allowSheetDownload?: boolean;
     isTemplateOpen?: boolean;
     selectedTemplate?: string;
@@ -107,7 +110,10 @@ export interface DsheetProps {
     /** Fires whenever local content-sync status changes. Host apps should gate
      * collab start/resume on 'synced' — starting before local content is fully
      * synced is what let the RTC layer bind to a stale doc in the past. */
-    onContentSyncStatusChange?: (status: "initializing" | "syncing" | "synced" | "error") => void;
+    onContentSyncStatusChange?: (status: 'initializing' | 'syncing' | 'synced' | 'error') => void;
+    /** Fires once the first collaboration sync has been reconciled with the
+     * workbook, or when that reconciliation fails. */
+    onCollaborationInitializationComplete?: (result: 'ready' | 'error') => void;
     editorStateRef?: React.MutableRefObject<{
         refreshIndexedDB: () => Promise<void>;
         getContentSnapshot: () => DSheetContentSnapshot;