canvu-react 0.4.59 → 0.4.61

package/dist/realtime.d.cts

@@ -1,4 +1,4 @@
-import { P as PlacementPreview, r as VectorViewportHandle, V as VectorToolDefinition, s as VectorViewportProps, a as CanvasPlugin, f as CanvasPluginRenderContext } from './types-BFZpRGyr.cjs';
+import { P as PlacementPreview, u as VectorViewportProps, t as VectorViewportHandle, V as VectorToolDefinition, p as VectorItemsChangeInfo, a as CanvasPlugin, f as CanvasPluginRenderContext } from './types--jCoyZIF.cjs';
 import { a as RemotePresenceMarkupStroke, R as RemotePresencePeer, b as RemotePresenceCamera, c as RealtimeConnectionState } from './types-DqsqQQVf.cjs';
 export { P as PresenceOverlayRenderContext } from './types-DqsqQQVf.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -175,7 +175,7 @@ type RealtimeCommentsAuthor = {
 };
 type UseRealtimeCommentsOptions = {
     items: readonly VectorSceneItem[];
-    onItemsChange: (items: VectorSceneItem[]) => void;
+    onItemsChange: NonNullable<VectorViewportProps["onItemsChange"]>;
     author: RealtimeCommentsAuthor;
     viewportRef?: RefObject<VectorViewportHandle | null>;
     activeToolId?: string;
@@ -195,7 +195,7 @@ type UseRealtimeCommentsResult = {
     tools: VectorToolDefinition[];
     overlay: ReactNode;
     viewport: RealtimeCommentsViewportBindings;
-    handleViewportItemsChange: (items: VectorSceneItem[], onItemsChange?: (items: VectorSceneItem[]) => void) => void;
+    handleViewportItemsChange: (items: VectorSceneItem[], onItemsChange?: NonNullable<VectorViewportProps["onItemsChange"]>, info?: VectorItemsChangeInfo) => void;
     isComposerOpen: boolean;
     closeComposer: () => void;
 };
@@ -284,7 +284,7 @@ type RealtimeCommentData = {
 };
 type RealtimeCommentsOverlayProps = {
     items: readonly VectorSceneItem[];
-    onItemsChange?: (items: VectorSceneItem[]) => void;
+    onItemsChange?: (items: VectorSceneItem[], info?: VectorItemsChangeInfo) => void;
     isDragEnabled?: boolean;
     cameraVersion: number;
     viewportRef?: CanvasPluginRenderContext["viewportRef"];
@@ -331,14 +331,14 @@ declare function realtimeSessionPlugin(options: RealtimeSessionPluginOptions): C
 type UseRealtimeCanvasDocumentOptions = {
     session: Pick<UseRealtimeSessionResult, "connection" | "document" | "remoteAdapter" | "hasLocalOfflineDraft" | "hasPendingDocumentSync" | "syncState" | "conflict" | "resolveConflict" | "clearLocalDraft" | "flushDocumentSync"> | null;
     items: readonly VectorSceneItem[];
-    onItemsChange?: (nextItems: VectorSceneItem[]) => void;
+    onItemsChange?: (nextItems: VectorSceneItem[], info?: VectorItemsChangeInfo) => void;
     normalizeItems?: (nextItems: readonly VectorSceneItem[]) => VectorSceneItem[];
     hydrateItems?: (nextItems: readonly VectorSceneItem[]) => Promise<VectorSceneItem[]>;
     enabled?: boolean;
 };
 type UseRealtimeCanvasDocumentResult = {
     items: readonly VectorSceneItem[];
-    onItemsChange?: (nextItems: VectorSceneItem[]) => void;
+    onItemsChange?: (nextItems: VectorSceneItem[], info?: VectorItemsChangeInfo) => void;
     loading: boolean;
     saving: boolean;
     hasLocalOfflineDraft: boolean;

package/dist/realtime.d.ts

@@ -1,4 +1,4 @@
-import { P as PlacementPreview, r as VectorViewportHandle, V as VectorToolDefinition, s as VectorViewportProps, a as CanvasPlugin, f as CanvasPluginRenderContext } from './types-D2zesNI8.js';
+import { P as PlacementPreview, u as VectorViewportProps, t as VectorViewportHandle, V as VectorToolDefinition, p as VectorItemsChangeInfo, a as CanvasPlugin, f as CanvasPluginRenderContext } from './types-C_PMen-D.js';
 import { a as RemotePresenceMarkupStroke, R as RemotePresencePeer, b as RemotePresenceCamera, c as RealtimeConnectionState } from './types-BXa2CIrc.js';
 export { P as PresenceOverlayRenderContext } from './types-BXa2CIrc.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -175,7 +175,7 @@ type RealtimeCommentsAuthor = {
 };
 type UseRealtimeCommentsOptions = {
     items: readonly VectorSceneItem[];
-    onItemsChange: (items: VectorSceneItem[]) => void;
+    onItemsChange: NonNullable<VectorViewportProps["onItemsChange"]>;
     author: RealtimeCommentsAuthor;
     viewportRef?: RefObject<VectorViewportHandle | null>;
     activeToolId?: string;
@@ -195,7 +195,7 @@ type UseRealtimeCommentsResult = {
     tools: VectorToolDefinition[];
     overlay: ReactNode;
     viewport: RealtimeCommentsViewportBindings;
-    handleViewportItemsChange: (items: VectorSceneItem[], onItemsChange?: (items: VectorSceneItem[]) => void) => void;
+    handleViewportItemsChange: (items: VectorSceneItem[], onItemsChange?: NonNullable<VectorViewportProps["onItemsChange"]>, info?: VectorItemsChangeInfo) => void;
     isComposerOpen: boolean;
     closeComposer: () => void;
 };
@@ -284,7 +284,7 @@ type RealtimeCommentData = {
 };
 type RealtimeCommentsOverlayProps = {
     items: readonly VectorSceneItem[];
-    onItemsChange?: (items: VectorSceneItem[]) => void;
+    onItemsChange?: (items: VectorSceneItem[], info?: VectorItemsChangeInfo) => void;
     isDragEnabled?: boolean;
     cameraVersion: number;
     viewportRef?: CanvasPluginRenderContext["viewportRef"];
@@ -331,14 +331,14 @@ declare function realtimeSessionPlugin(options: RealtimeSessionPluginOptions): C
 type UseRealtimeCanvasDocumentOptions = {
     session: Pick<UseRealtimeSessionResult, "connection" | "document" | "remoteAdapter" | "hasLocalOfflineDraft" | "hasPendingDocumentSync" | "syncState" | "conflict" | "resolveConflict" | "clearLocalDraft" | "flushDocumentSync"> | null;
     items: readonly VectorSceneItem[];
-    onItemsChange?: (nextItems: VectorSceneItem[]) => void;
+    onItemsChange?: (nextItems: VectorSceneItem[], info?: VectorItemsChangeInfo) => void;
     normalizeItems?: (nextItems: readonly VectorSceneItem[]) => VectorSceneItem[];
     hydrateItems?: (nextItems: readonly VectorSceneItem[]) => Promise<VectorSceneItem[]>;
     enabled?: boolean;
 };
 type UseRealtimeCanvasDocumentResult = {
     items: readonly VectorSceneItem[];
-    onItemsChange?: (nextItems: VectorSceneItem[]) => void;
+    onItemsChange?: (nextItems: VectorSceneItem[], info?: VectorItemsChangeInfo) => void;
     loading: boolean;
     saving: boolean;
     hasLocalOfflineDraft: boolean;

package/dist/realtime.js

@@ -1226,7 +1226,10 @@ function RealtimeCommentsOverlay({
         (item) => item.id === drag.itemId ? moveCommentItem(item, deltaX, deltaY) : item
       );
       itemsRef.current = nextItems;
-      onItemsChange(nextItems);
+      onItemsChange(nextItems, {
+        motive: "plugin",
+        itemIds: [drag.itemId]
+      });
     };
     const onPointerUp = () => {
       dragStateRef.current = null;
@@ -1732,20 +1735,20 @@ function useRealtimeComments({
     [author.color]
   );
   const handleViewportItemsChange = useCallback(
-    (nextItems, overrideOnItemsChange) => {
+    (nextItems, overrideOnItemsChange, info) => {
       const applyItemsChange = overrideOnItemsChange ?? onItemsChange;
       const currentIds = new Set(items.map((item) => item.id));
       const draftItem = nextItems.find(
         (item) => !currentIds.has(item.id) && isRealtimeCommentDraftItem(item)
       );
       if (!draftItem) {
-        applyItemsChange(nextItems);
+        applyItemsChange(nextItems, info);
         return;
       }
       const filteredItems = nextItems.filter((item) => item.id !== draftItem.id);
       const shouldPersistFiltered = filteredItems.length !== items.length || filteredItems.some((item, index) => items[index]?.id !== item.id);
       if (shouldPersistFiltered) {
-        applyItemsChange(filteredItems);
+        applyItemsChange(filteredItems, info);
       }
       setCommentComposer({
         worldX: draftItem.bounds.x + draftItem.bounds.width / 2,
@@ -1787,7 +1790,10 @@ function useRealtimeComments({
         authorImage
       }
     );
-    onItemsChange(items.concat(nextItem));
+    onItemsChange(items.concat(nextItem), {
+      motive: "plugin",
+      itemIds: [nextItem.id]
+    });
     setCommentComposer(null);
   }, [
     author.color,
@@ -1845,7 +1851,7 @@ function useRealtimeComments({
   const viewport = useMemo(
     () => ({
       customPlacement,
-      onItemsChange: (nextItems) => handleViewportItemsChange(nextItems),
+      onItemsChange: (nextItems, info) => handleViewportItemsChange(nextItems, void 0, info),
       onCameraChange
     }),
     [customPlacement, handleViewportItemsChange, onCameraChange]
@@ -3498,7 +3504,7 @@ function RealtimeCollaborationPluginComponent({
   );
   const handleCommentItemsChange = useCallback(
     (nextItems) => {
-      onItemsChange?.([...nextItems]);
+      onItemsChange?.([...nextItems], { motive: "plugin" });
       session.remoteAdapter.send?.([...nextItems]);
     },
     [onItemsChange, session.remoteAdapter]
@@ -3548,7 +3554,7 @@ function RealtimeCollaborationPluginComponent({
   useEffect(() => {
     if (!onItemsChange || !session.document) return;
     if (session.document.updatedByClientId === session.connection.clientId) return;
-    onItemsChange(session.document.items);
+    onItemsChange(session.document.items, { motive: "remote-sync" });
   }, [onItemsChange, session.connection.clientId, session.document]);
   const contribution = useMemo(
     () => ({
@@ -3563,15 +3569,19 @@ function RealtimeCollaborationPluginComponent({
         onPlacementPreviewChange: presenceBindings.onPlacementPreviewChange,
         onCameraChange: onViewportCameraChange
       },
-      wrapOnItemsChange: (nextItems, ctx) => {
+      wrapOnItemsChange: (nextItems, ctx, info) => {
         if (commentOptions) {
-          comments.handleViewportItemsChange(nextItems, (processedItems) => {
-            ctx.next(processedItems);
-            session.remoteAdapter.send?.([...processedItems]);
-          });
+          comments.handleViewportItemsChange(
+            nextItems,
+            (processedItems, processedInfo) => {
+              ctx.next(processedItems, processedInfo);
+              session.remoteAdapter.send?.([...processedItems]);
+            },
+            info
+          );
           return;
         }
-        ctx.next(nextItems);
+        ctx.next(nextItems, info);
         session.remoteAdapter.send?.(nextItems);
       }
     }),
@@ -3712,14 +3722,17 @@ function useRealtimeCanvasDocument(options) {
     [hydrateItems, normalizeItems]
   );
   const handleItemsChange = useCallback(
-    (nextItems) => {
+    (nextItems, info) => {
       if (!enabled) {
-        onItemsChange?.(normalizeItems ? normalizeItems(nextItems) : nextItems);
+        onItemsChange?.(
+          normalizeItems ? normalizeItems(nextItems) : nextItems,
+          info
+        );
         return;
       }
       hasLocalChangeInFlightRef.current = true;
       const normalizedItems = normalizeItems ? normalizeItems(nextItems) : nextItems;
-      onItemsChange?.(normalizedItems);
+      onItemsChange?.(normalizedItems, info);
       session?.remoteAdapter.send?.(normalizedItems);
     },
     [enabled, normalizeItems, onItemsChange, session]
@@ -3770,7 +3783,7 @@ function useRealtimeCanvasDocument(options) {
       if (resolvedItems.length > 0) {
         hasEverPropagatedItemsRef.current = true;
       }
-      onItemsChange(resolvedItems);
+      onItemsChange(resolvedItems, { motive: "remote-sync" });
     }).finally(() => {
       if (inFlightRevisionRef.current === documentRevision) {
         inFlightRevisionRef.current = null;