@fileverse-dev/dsheet 2.0.33-rtc-d → 2.0.33-rtc-e

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

@@ -2,7 +2,7 @@ import { default as React } from 'react';
 import { LiveQueryData, Sheet, WorkbookInstance } from '../../sheet-engine/react';
 import { IndexeddbPersistence } from 'y-indexeddb';
 import { DataBlockApiKeyHandlerType, SheetUpdateData } from '../types';
-import { CollaborationProps, CollabState } from '../../sync-local/types';
+import { CollaborationProps, CollabState, CollabUser } from '../../sync-local/types';
 import { Awareness } from 'y-protocols/awareness';
 
 import * as Y from 'yjs';
@@ -45,6 +45,10 @@ export interface EditorContextType {
     hasCollabContentInitialised?: boolean;
     awareness?: Awareness | null;
     terminateSession?: () => void;
+    onCollaboratorsChange?: (collaborators: CollabUser[]) => void;
+    /** Attach collab methods to the WorkbookInstance — must be called from a
+     * callback ref so we re-attach every time Workbook regenerates its handle. */
+    augmentEditorRef?: (instance: WorkbookInstance | null) => void;
     handleLiveQuery: (subsheetIndex: number, data: LiveQueryData) => void;
 }
 interface EditorProviderProps {

package/dist/editor/hooks/use-collab-awareness.d.ts

@@ -1,11 +1,17 @@
 import { Awareness } from 'y-protocols/awareness';
 import { WorkbookInstance } from '../../sheet-engine/react';
+import { CollabUser } from '../../sync-local/types';
 
 /**
  * Reads remote cursor positions from Yjs awareness and keeps Fortune sheet's
  * native presence list in sync. Fortune renders colored cell borders + username
  * labels automatically via context.presences[].
+ *
+ * Also emits the full collaborator list (including the local user) via
+ * `onCollaboratorsChange` so host apps can render navbar chips. This mirrors
+ * ddoc's editor-layer awareness handler, which maps awareness.states →
+ * `{ clientId, ...user }` and fires on every awareness update + once on mount.
  */
-export declare const useCollabAwareness: (awareness: Awareness | null | undefined, sheetEditorRef: React.MutableRefObject<WorkbookInstance | null>) => {
+export declare const useCollabAwareness: (awareness: Awareness | null | undefined, sheetEditorRef: React.MutableRefObject<WorkbookInstance | null>, onCollaboratorsChange?: (collaborators: CollabUser[]) => void) => {
     localColor: "#30bced" | "#6eeb83" | "#fa69d1" | "#ecd444" | "#ee6352" | "#db3041" | "#0ad7f2" | "#1bff39";
 };