canvu-react 0.4.63 → 0.4.65

package/dist/react.js

@@ -3146,7 +3146,9 @@ function ToolPluginComponent({
   toolTransform,
   createItem,
   selectAfterCreate,
-  onSelectModeItemClick
+  onSelectModeItemClick,
+  onBeforeInteraction,
+  onAfterInteraction
 }) {
   const contribution = useMemo(
     () => ({
@@ -3159,9 +3161,27 @@ function ToolPluginComponent({
           selectAfterCreate,
           onSelectModeItemClick
         }
-      ] : void 0
+      ] : void 0,
+      interactionHooks: onBeforeInteraction || onAfterInteraction ? {
+        onBeforeInteraction: onBeforeInteraction ? (detail) => {
+          if (detail.toolId !== tool.id) return void 0;
+          return onBeforeInteraction(detail);
+        } : void 0,
+        onAfterInteraction: onAfterInteraction ? (detail) => {
+          if (detail.toolId !== tool.id) return;
+          onAfterInteraction(detail);
+        } : void 0
+      } : void 0
     }),
-    [createItem, onSelectModeItemClick, selectAfterCreate, tool, toolTransform]
+    [
+      createItem,
+      onAfterInteraction,
+      onBeforeInteraction,
+      onSelectModeItemClick,
+      selectAfterCreate,
+      tool,
+      toolTransform
+    ]
   );
   useCanvuPluginContribution(pluginId, contribution);
   return null;
@@ -3172,6 +3192,8 @@ function createToolPlugin(options) {
     toolTransform,
     selectAfterCreate,
     onSelectModeItemClick,
+    onBeforeInteraction,
+    onAfterInteraction,
     ...tool
   } = options;
   const pluginId = `canvu.plugin.tool:${tool.id}`;
@@ -3186,7 +3208,9 @@ function createToolPlugin(options) {
           toolTransform,
           createItem,
           selectAfterCreate,
-          onSelectModeItemClick
+          onSelectModeItemClick,
+          onBeforeInteraction,
+          onAfterInteraction
         }
       );
     }
@@ -5622,7 +5646,7 @@ function attachViewportInput(options) {
     if (touchMomentum) {
       touchMomentum.cancel();
     }
-    const panOk = allowPrimaryPointerPan();
+    const panOk = allowPrimaryPointerPan(e);
     if (e.pointerType === "mouse" && e.button === 0) {
       if (!panOk) {
         return;
@@ -7646,6 +7670,93 @@ function PresenceRemoteLayer({
   );
 }
 
+// src/react/read-only-activation.ts
+function findReadOnlyItemClickPlacement(item, placements) {
+  const toolId = item.customToolId;
+  if (!toolId) return null;
+  return [...placements].reverse().find(
+    (placement) => placement.toolId === toolId && placement.onSelectModeItemClick
+  ) ?? null;
+}
+function resolveReadOnlyActivationTarget(input) {
+  const {
+    pointer,
+    camera,
+    container,
+    items,
+    detailItems = items,
+    placements,
+    scope,
+    selectedIds
+  } = input;
+  const rect = container.getBoundingClientRect();
+  const world = camera.screenToWorld(
+    pointer.clientX - rect.left,
+    pointer.clientY - rect.top
+  );
+  const hit = hitTestWorldPoint(items, world.worldX, world.worldY, {
+    lineHitWorld: 10 / camera.zoom,
+    ignoreLocked: true
+  });
+  if (!hit) return null;
+  const customPlacement = findReadOnlyItemClickPlacement(hit, placements);
+  if (customPlacement?.onSelectModeItemClick) {
+    return {
+      item: hit,
+      activation: "custom",
+      worldX: world.worldX,
+      worldY: world.worldY
+    };
+  }
+  if (scope === "all") {
+    return {
+      item: hit,
+      activation: "read-only",
+      worldX: world.worldX,
+      worldY: world.worldY
+    };
+  }
+  if (typeof scope === "function") {
+    const allowed = scope({
+      item: hit,
+      worldX: world.worldX,
+      worldY: world.worldY,
+      clientX: pointer.clientX,
+      clientY: pointer.clientY,
+      pointerType: pointer.pointerType,
+      shiftKey: pointer.shiftKey,
+      altKey: pointer.altKey,
+      metaKey: pointer.metaKey,
+      ctrlKey: pointer.ctrlKey,
+      items: detailItems,
+      selectedIds
+    });
+    if (allowed) {
+      return {
+        item: hit,
+        activation: "read-only",
+        worldX: world.worldX,
+        worldY: world.worldY
+      };
+    }
+  }
+  return null;
+}
+function createReadOnlyActivationSession(target, pointer) {
+  return {
+    pointerId: pointer.pointerId,
+    itemId: target.item.id,
+    activation: target.activation,
+    startWorld: { x: target.worldX, y: target.worldY },
+    startScreen: { x: pointer.clientX, y: pointer.clientY }
+  };
+}
+function didReadOnlyActivationMovePastTap(session, pointer, tapPx) {
+  const dx = pointer.clientX - session.startScreen.x;
+  const dy = pointer.clientY - session.startScreen.y;
+  return Math.hypot(dx, dy) > tapPx;
+}
+
 // src/react/stable-selection.ts
 function shallowEqualStringArray(a, b) {
   if (a === b) return true;
@@ -7999,13 +8110,6 @@ function isDefaultMarkerToolStyle(style) {
 function tagCustomPlacementItem(item, toolId) {
   return item.customToolId === toolId ? item : { ...item, customToolId: toolId };
 }
-function findSelectModeItemClickPlacement(item, placements) {
-  const toolId = item.customToolId;
-  if (!toolId) return null;
-  return [...placements].reverse().find(
-    (placement) => placement.toolId === toolId && placement.onSelectModeItemClick
-  ) ?? null;
-}
 function mergeToolListById(baseTools, pluginTools) {
   const next = [...baseTools];
   for (const tool of pluginTools) {
@@ -8133,9 +8237,12 @@ var VectorViewport = forwardRef(
     toolId = "hand",
     applePencilNav = false,
     interactive = false,
+    readOnlyInteraction,
     selectedIds: selectedIdsProp,
     onSelectionChange,
     onItemsChange: consumerOnItemsChange,
+    onBeforeInteraction: consumerOnBeforeInteraction,
+    onAfterInteraction: consumerOnAfterInteraction,
     onActivateLink,
     onWorldPointerDown: consumerOnWorldPointerDown,
     toolbar,
@@ -8261,6 +8368,24 @@ var VectorViewport = forwardRef(
         (contribution) => contribution.callbacks?.onCameraChange
       )
     );
+    const beforeInteractionHooks = useMemo(
+      () => [
+        consumerOnBeforeInteraction,
+        ...orderedPluginContributions.map(
+          (contribution) => contribution.interactionHooks?.onBeforeInteraction
+        )
+      ].filter((hook) => hook != null),
+      [consumerOnBeforeInteraction, orderedPluginContributions]
+    );
+    const afterInteractionHooks = useMemo(
+      () => [
+        consumerOnAfterInteraction,
+        ...orderedPluginContributions.map(
+          (contribution) => contribution.interactionHooks?.onAfterInteraction
+        )
+      ].filter((hook) => hook != null),
+      [consumerOnAfterInteraction, orderedPluginContributions]
+    );
     const onItemsChange = useMemo(() => {
       const middlewares = orderedPluginContributions.map((contribution) => contribution.wrapOnItemsChange).filter(
         (middleware) => middleware != null
@@ -8315,6 +8440,8 @@ var VectorViewport = forwardRef(
     );
     const toolIdRef = useRef(toolId);
     const interactiveRef = useRef(interactive);
+    const readOnlyInteractionRef = useRef(readOnlyInteraction);
+    readOnlyInteractionRef.current = readOnlyInteraction;
     const reducedMotionRef = useRef(false);
     const itemsRef = useRef(items);
     const onWorldPointerDownRef = useRef(onWorldPointerDown);
@@ -8328,6 +8455,7 @@ var VectorViewport = forwardRef(
     const allCustomPlacementsRef = useRef(allCustomPlacements);
     allCustomPlacementsRef.current = allCustomPlacements;
     const dragStateRef = useRef({ kind: "idle" });
+    const readOnlyItemClickStateRef = useRef(null);
     const clipboardRef = useRef(null);
     const undoStackRef = useRef([]);
     const redoStackRef = useRef([]);
@@ -8404,6 +8532,81 @@ var VectorViewport = forwardRef(
       [items]
     );
     itemsRef.current = normalizedItems;
+    const beforeInteractionHooksRef = useRef(beforeInteractionHooks);
+    beforeInteractionHooksRef.current = beforeInteractionHooks;
+    const afterInteractionHooksRef = useRef(afterInteractionHooks);
+    afterInteractionHooksRef.current = afterInteractionHooks;
+    const canvuInteractionSeqRef = useRef(0);
+    const activeCanvuInteractionRef = useRef(null);
+    const makeInteractionPoint = useCallback(
+      (input) => ({
+        worldX: input.worldX,
+        worldY: input.worldY,
+        clientX: input.clientX,
+        clientY: input.clientY
+      }),
+      []
+    );
+    const startCanvuInteraction = useCallback(
+      (input) => {
+        const start = makeInteractionPoint(input);
+        const detail = {
+          interactionId: `canvu-interaction-${++canvuInteractionSeqRef.current}`,
+          kind: input.kind,
+          toolId: input.toolId,
+          pointerType: input.pointerType,
+          button: input.button,
+          shiftKey: input.shiftKey,
+          altKey: input.altKey,
+          metaKey: input.metaKey,
+          ctrlKey: input.ctrlKey,
+          start,
+          current: start,
+          selectedIds: [...effectiveSelectedIdsRef.current],
+          itemIds: [...input.itemIds ?? []],
+          items: itemsRef.current
+        };
+        for (const hook of beforeInteractionHooksRef.current) {
+          if (hook(detail) === "handled") {
+            return null;
+          }
+        }
+        activeCanvuInteractionRef.current = detail;
+        return detail;
+      },
+      [makeInteractionPoint]
+    );
+    const updateCanvuInteractionCurrent = useCallback(
+      (input) => {
+        const detail = activeCanvuInteractionRef.current;
+        if (!detail) return;
+        activeCanvuInteractionRef.current = {
+          ...detail,
+          current: makeInteractionPoint(input)
+        };
+      },
+      [makeInteractionPoint]
+    );
+    const finishCanvuInteraction = useCallback(
+      (outcome, options) => {
+        const detail = activeCanvuInteractionRef.current;
+        if (!detail) return;
+        activeCanvuInteractionRef.current = null;
+        const current = options?.current ? makeInteractionPoint(options.current) : detail.current;
+        const info = options?.info;
+        const afterDetail = {
+          ...detail,
+          current,
+          itemIds: detail.itemIds.length > 0 ? detail.itemIds : [...info?.itemIds ?? []],
+          outcome,
+          ...info ? { info } : {}
+        };
+        for (const hook of afterInteractionHooksRef.current) {
+          hook(afterDetail);
+        }
+      },
+      [makeInteractionPoint]
+    );
     onWorldPointerDownRef.current = onWorldPointerDown;
     const originalOnItemsChangeRef = useRef(onItemsChange);
     originalOnItemsChangeRef.current = onItemsChange;
@@ -8430,6 +8633,31 @@ var VectorViewport = forwardRef(
     );
     const resolvedItemsRef = useRef(resolvedItems);
     resolvedItemsRef.current = resolvedItems;
+    const readOnlyActivationResolutionCacheRef = useRef(/* @__PURE__ */ new WeakMap());
+    const resolveReadOnlyActivation = useCallback(
+      (pointer) => {
+        const cache = readOnlyActivationResolutionCacheRef.current;
+        if (cache.has(pointer)) return cache.get(pointer) ?? null;
+        let target = null;
+        const cam = cameraRef.current;
+        const container = sceneContainerRef.current;
+        if (!interactiveRef.current && toolIdRef.current === "select" && cam && container) {
+          target = resolveReadOnlyActivationTarget({
+            pointer,
+            camera: cam,
+            container,
+            items: resolvedItemsRef.current,
+            detailItems: itemsRef.current,
+            placements: allCustomPlacementsRef.current,
+            scope: readOnlyInteractionRef.current?.itemClicks ?? "custom",
+            selectedIds: effectiveSelectedIdsRef.current
+          });
+        }
+        cache.set(pointer, target);
+        return target;
+      },
+      []
+    );
     const liveId = useId();
     const reducedMotion = usePrefersReducedMotion();
     reducedMotionRef.current = reducedMotion;
@@ -8644,9 +8872,14 @@ var VectorViewport = forwardRef(
         );
         if (item) {
           const exists = itemsRef.current.some((it) => it.id === id);
+          const info = {
+            motive: "draw",
+            itemIds: [id],
+            toolId: args.tool
+          };
           change(
             exists ? replaceItem(itemsRef.current, id, item) : [...itemsRef.current, item],
-            { motive: "draw", itemIds: [id], toolId: args.tool }
+            info
           );
           patchCurrentStrokeStyle({
             stroke: item.stroke ?? DEFAULT_STROKE_STYLE.stroke,
@@ -8654,10 +8887,15 @@ var VectorViewport = forwardRef(
             strokeOpacity: item.strokeOpacity,
             strokeDash: item.strokeDash
           });
+          if (!shouldKeepToolForContinuousPenInput(args.tool, args.pointerType)) {
+            requestAutoResetTool(args.tool);
+          }
+          return info;
         }
         if (!shouldKeepToolForContinuousPenInput(args.tool, args.pointerType)) {
           requestAutoResetTool(args.tool);
         }
+        return void 0;
       },
       [
         patchCurrentStrokeStyle,
@@ -8788,17 +9026,19 @@ var VectorViewport = forwardRef(
         }
         emitRemoteStrokePreviewClear();
         setPlacementPreview(null);
-        commitCompletedStroke({
+        const info = commitCompletedStroke({
           tool,
           pointerType,
           points: [...pts],
           style,
           itemId
         });
+        finishCanvuInteraction("completed", { info });
       },
       [
         commitCompletedStroke,
         emitRemoteStrokePreviewClear,
+        finishCanvuInteraction,
         releaseInteractionPointer,
         renderSceneWithLivePenStroke
       ]
@@ -8847,12 +9087,14 @@ var VectorViewport = forwardRef(
         onUpdate: renderFrame,
         wheelElement: wrapperRef.current ?? void 0,
         touchHandledElsewhere: applePencilNav,
-        allowPrimaryPointerPan: () => {
+        allowPrimaryPointerPan: (event) => {
           if (interactiveRef.current) {
             return toolIdRef.current === "hand";
           }
           const t = toolIdRef.current;
-          return t === "hand" || t === "select";
+          if (t === "hand") return true;
+          if (t !== "select") return false;
+          return resolveReadOnlyActivation(event) === null;
         }
       });
       let detachPencil;
@@ -8873,7 +9115,7 @@ var VectorViewport = forwardRef(
         cameraRef.current = null;
         setCameraForOverlay(null);
       };
-    }, [applePencilNav, renderFrame]);
+    }, [applePencilNav, renderFrame, resolveReadOnlyActivation]);
     useEffect(() => {
       rendererRef.current?.setInteractionState({
         selectedIds: effectiveSelectedIds,
@@ -9387,6 +9629,29 @@ var VectorViewport = forwardRef(
       const rect = el.getBoundingClientRect();
       return cam.screenToWorld(clientX - rect.left, clientY - rect.top);
     }, []);
+    const buildSelectModeItemClickDetail = useCallback(
+      (item, world, pointer) => ({
+        item,
+        worldX: world.worldX,
+        worldY: world.worldY,
+        clientX: pointer.clientX,
+        clientY: pointer.clientY,
+        pointerType: pointer.pointerType,
+        shiftKey: pointer.shiftKey,
+        altKey: pointer.altKey,
+        metaKey: pointer.metaKey,
+        ctrlKey: pointer.ctrlKey,
+        items: itemsRef.current,
+        updateItem: (next) => {
+          onItemsChangeRef.current?.(replaceItem(itemsRef.current, item.id, next), {
+            motive: "custom",
+            itemIds: [item.id]
+          });
+        },
+        setSelectedIds: (ids) => setEffectiveSelectedIdsRef.current(ids)
+      }),
+      []
+    );
     const handleOverlayContextMenu = useCallback(
       (e) => {
         if (!interactiveRef.current || !onItemsChangeRef.current) return;
@@ -9813,6 +10078,118 @@ var VectorViewport = forwardRef(
       },
       [screenToWorld]
     );
+    useEffect(() => {
+      const root = interactionRootRef.current;
+      if (!root) return;
+      const onReadOnlyPointerDownCapture = (e) => {
+        if (e.button !== 0) return;
+        if (readOnlyItemClickStateRef.current) return;
+        const target = resolveReadOnlyActivation(e);
+        if (!target) return;
+        const accepted = startCanvuInteraction({
+          kind: "select-mode-item-click",
+          toolId: "select",
+          pointerType: e.pointerType,
+          button: e.button,
+          worldX: target.worldX,
+          worldY: target.worldY,
+          clientX: e.clientX,
+          clientY: e.clientY,
+          shiftKey: e.shiftKey,
+          altKey: e.altKey,
+          metaKey: e.metaKey,
+          ctrlKey: e.ctrlKey,
+          itemIds: [target.item.id]
+        });
+        if (!accepted) {
+          e.preventDefault();
+          e.stopPropagation();
+          return;
+        }
+        wrapperRef.current?.focus({ preventScroll: true });
+        readOnlyItemClickStateRef.current = createReadOnlyActivationSession(
+          target,
+          e
+        );
+        e.preventDefault();
+        e.stopPropagation();
+      };
+      root.addEventListener("pointerdown", onReadOnlyPointerDownCapture, {
+        capture: true
+      });
+      return () => {
+        root.removeEventListener("pointerdown", onReadOnlyPointerDownCapture, {
+          capture: true
+        });
+      };
+    }, [resolveReadOnlyActivation, startCanvuInteraction]);
+    useEffect(() => {
+      const finishReadOnlyClick = (ev) => {
+        const st = readOnlyItemClickStateRef.current;
+        if (!st || st.pointerId !== ev.pointerId) return;
+        readOnlyItemClickStateRef.current = null;
+        const world = screenToWorld(ev.clientX, ev.clientY);
+        const current = {
+          worldX: world.worldX,
+          worldY: world.worldY,
+          clientX: ev.clientX,
+          clientY: ev.clientY
+        };
+        updateCanvuInteractionCurrent(current);
+        if (ev.type === "pointercancel") {
+          finishCanvuInteraction("cancelled", { current });
+          return;
+        }
+        if (didReadOnlyActivationMovePastTap(st, ev, TAP_PX)) {
+          finishCanvuInteraction("cancelled", { current });
+          return;
+        }
+        const item = itemsRef.current.find((candidate) => candidate.id === st.itemId) ?? resolvedItemsRef.current.find((candidate) => candidate.id === st.itemId);
+        if (!item) {
+          finishCanvuInteraction("cancelled", { current });
+          return;
+        }
+        const detail = buildSelectModeItemClickDetail(item, world, ev);
+        if (st.activation === "custom") {
+          const placement = findReadOnlyItemClickPlacement(
+            item,
+            allCustomPlacementsRef.current
+          );
+          const onSelectModeItemClick = placement?.onSelectModeItemClick;
+          if (!onSelectModeItemClick) {
+            finishCanvuInteraction("cancelled", { current });
+            return;
+          }
+          onSelectModeItemClick(detail);
+          finishCanvuInteraction("completed", {
+            current,
+            info: { motive: "custom", itemIds: [item.id], toolId: "select" }
+          });
+          return;
+        }
+        const handled = readOnlyInteractionRef.current?.onItemClick?.(detail) === "handled";
+        if (!handled) {
+          const cur = effectiveSelectedIdsRef.current;
+          const next = ev.shiftKey ? cur.includes(item.id) ? cur.filter((id) => id !== item.id) : [...cur, item.id] : [item.id];
+          setEffectiveSelectedIdsRef.current(next);
+        }
+        finishCanvuInteraction("completed", {
+          current,
+          info: { motive: "custom", itemIds: [item.id], toolId: "select" }
+        });
+      };
+      document.addEventListener("pointerup", finishReadOnlyClick);
+      document.addEventListener("pointercancel", finishReadOnlyClick);
+      return () => {
+        document.removeEventListener("pointerup", finishReadOnlyClick);
+        document.removeEventListener("pointercancel", finishReadOnlyClick);
+      };
+    }, [
+      buildSelectModeItemClickDetail,
+      finishCanvuInteraction,
+      screenToWorld,
+      updateCanvuInteractionCurrent
+    ]);
     const handleOverlayPointerDown = useCallback(
       (e) => {
         let currentDragState = dragStateRef.current;
@@ -9868,12 +10245,26 @@ var VectorViewport = forwardRef(
           if (!raw) return void 0;
           return raw.toolKind === "arrow" && raw.arrowBind ? bakeArrowItemToAbsolute(raw, canonical) : raw;
         };
+        const startInteraction = (kind, itemIds) => startCanvuInteraction({
+          kind,
+          toolId: tool,
+          pointerType: e.pointerType,
+          button: e.button,
+          worldX,
+          worldY,
+          clientX: e.clientX,
+          clientY: e.clientY,
+          shiftKey: e.shiftKey,
+          altKey: e.altKey,
+          metaKey: e.metaKey,
+          ctrlKey: e.ctrlKey,
+          itemIds
+        });
+        const stopHandledInteraction = () => {
+          e.preventDefault();
+          e.stopPropagation();
+        };
         if (tool === "eraser") {
-          dragStateRef.current = { kind: "erase" };
-          eraserPreviewIdsRef.current = /* @__PURE__ */ new Set();
-          setEraserPreviewIds([]);
-          setEraserTrail([{ x: worldX, y: worldY, t: Date.now() }]);
-          setEraserActive(true);
           const toErase = collectEraserTargetsAtWorldPoint(
             resolved,
             worldX,
@@ -9883,6 +10274,15 @@ var VectorViewport = forwardRef(
               ignoreLocked: true
             }
           );
+          if (!startInteraction("erase", toErase)) {
+            stopHandledInteraction();
+            return;
+          }
+          dragStateRef.current = { kind: "erase" };
+          eraserPreviewIdsRef.current = /* @__PURE__ */ new Set();
+          setEraserPreviewIds([]);
+          setEraserTrail([{ x: worldX, y: worldY, t: Date.now() }]);
+          setEraserActive(true);
           if (toErase.length > 0) {
             for (const id of toErase) {
               eraserPreviewIdsRef.current.add(id);
@@ -9915,6 +10315,10 @@ var VectorViewport = forwardRef(
               const snapSpin = bakedSnapshot(selected.id);
               if (!snapSpin) return;
               const pivot = itemPivotWorld(selected);
+              if (!startInteraction("rotate", [selected.id])) {
+                stopHandledInteraction();
+                return;
+              }
               dragStateRef.current = {
                 kind: "rotate",
                 id: selected.id,
@@ -9939,6 +10343,10 @@ var VectorViewport = forwardRef(
             if (hb) {
               const snapRs = bakedSnapshot(selected.id);
               if (!snapRs) return;
+              if (!startInteraction("resize", [selected.id])) {
+                stopHandledInteraction();
+                return;
+              }
               dragStateRef.current = {
                 kind: "resize",
                 id: selected.id,
@@ -9960,7 +10368,7 @@ var VectorViewport = forwardRef(
             ignoreLocked: true
           });
           if (hit) {
-            const selectModeClickPlacement = !e.shiftKey ? findSelectModeItemClickPlacement(hit, allCustomPlacementsRef.current) : null;
+            const selectModeClickPlacement = !e.shiftKey ? findReadOnlyItemClickPlacement(hit, allCustomPlacementsRef.current) : null;
             if (selectModeClickPlacement) {
               const isAlreadySelected = cur.includes(hit.id);
               const moveIds = isAlreadySelected ? [...cur] : [hit.id];
@@ -9971,6 +10379,10 @@ var VectorViewport = forwardRef(
                   moveSnapshots[id] = snap;
                 }
               }
+              if (!startInteraction("select-mode-item-click", [hit.id])) {
+                stopHandledInteraction();
+                return;
+              }
               dragStateRef.current = {
                 kind: "select-mode-item-click",
                 id: hit.id,
@@ -9987,7 +10399,14 @@ var VectorViewport = forwardRef(
             }
             if (e.shiftKey) {
               const next = cur.includes(hit.id) ? cur.filter((id) => id !== hit.id) : [...cur, hit.id];
+              if (!startInteraction("select-mode-item-click", [hit.id])) {
+                stopHandledInteraction();
+                return;
+              }
               setEffectiveSelectedIdsRef.current(next);
+              finishCanvuInteraction("completed", {
+                info: { motive: "custom", itemIds: [hit.id], toolId: tool }
+              });
               e.preventDefault();
               e.stopPropagation();
               return;
@@ -9995,7 +10414,6 @@ var VectorViewport = forwardRef(
             let idsToMove;
             if (!cur.includes(hit.id)) {
               idsToMove = [hit.id];
-              setEffectiveSelectedIdsRef.current(idsToMove);
             } else {
               idsToMove = [...cur];
             }
@@ -10006,6 +10424,13 @@ var VectorViewport = forwardRef(
                 snapshots[id] = snap;
               }
             }
+            if (!startInteraction("move", idsToMove)) {
+              stopHandledInteraction();
+              return;
+            }
+            if (!cur.includes(hit.id)) {
+              setEffectiveSelectedIdsRef.current(idsToMove);
+            }
             dragStateRef.current = {
               kind: "move",
               ids: idsToMove,
@@ -10030,9 +10455,14 @@ var VectorViewport = forwardRef(
                 }
               }
               if (Object.keys(snapshots).length > 0) {
+                const moveIds = Object.keys(snapshots);
+                if (!startInteraction("move", moveIds)) {
+                  stopHandledInteraction();
+                  return;
+                }
                 dragStateRef.current = {
                   kind: "move",
-                  ids: Object.keys(snapshots),
+                  ids: moveIds,
                   snapshots,
                   startWorld: { x: worldX, y: worldY }
                 };
@@ -10043,6 +10473,10 @@ var VectorViewport = forwardRef(
               }
             }
           }
+          if (!startInteraction("marquee")) {
+            stopHandledInteraction();
+            return;
+          }
           dragStateRef.current = {
             kind: "marquee",
             startWorld: { x: worldX, y: worldY },
@@ -10071,6 +10505,10 @@ var VectorViewport = forwardRef(
           );
           const straightLine = tool === "draw" ? createStraightStrokeState(startPoint, e.clientX, e.clientY) : void 0;
           const directPenStroke = e.pointerType === "pen" && (tool === "draw" || tool === "marker");
+          if (!startInteraction("stroke")) {
+            stopHandledInteraction();
+            return;
+          }
           let itemId;
           if (directPenStroke) {
             itemId = createShapeId();
@@ -10114,6 +10552,10 @@ var VectorViewport = forwardRef(
           return;
         }
         if (tool === "text" || tool === "image") {
+          if (!startInteraction("tap")) {
+            stopHandledInteraction();
+            return;
+          }
           dragStateRef.current = {
             kind: "tap",
             tool,
@@ -10127,6 +10569,10 @@ var VectorViewport = forwardRef(
         }
         const cp = customPlacementRef.current;
         if (tool === "rect" || tool === "ellipse" || tool === "architectural-cloud" || tool === "line" || tool === "arrow" || cp && tool === cp.toolId) {
+          if (!startInteraction("place")) {
+            stopHandledInteraction();
+            return;
+          }
           dragStateRef.current = {
             kind: "place",
             tool,
@@ -10144,8 +10590,10 @@ var VectorViewport = forwardRef(
         captureInteractionPointer,
         emitRemoteStrokePreview,
         finalizeStrokeDragState,
+        finishCanvuInteraction,
         renderSceneWithLivePenStroke,
         screenToWorld,
+        startCanvuInteraction,
         startOrRestartStraightStrokeHoldTimer
       ]
     );
@@ -10174,14 +10622,32 @@ var VectorViewport = forwardRef(
           e.stopImmediatePropagation();
           return;
         }
-        wrapperRef.current?.focus({ preventScroll: true });
-        setContextMenu(null);
         const startPoint = pointerSampleToWorldPoint(
           screenToWorld,
           e.clientX,
           e.clientY,
           e.pressure
         );
+        if (!startCanvuInteraction({
+          kind: "stroke",
+          toolId: tool,
+          pointerType: e.pointerType,
+          button: e.button,
+          worldX: startPoint.x,
+          worldY: startPoint.y,
+          clientX: e.clientX,
+          clientY: e.clientY,
+          shiftKey: e.shiftKey,
+          altKey: e.altKey,
+          metaKey: e.metaKey,
+          ctrlKey: e.ctrlKey
+        })) {
+          e.preventDefault();
+          e.stopImmediatePropagation();
+          return;
+        }
+        wrapperRef.current?.focus({ preventScroll: true });
+        setContextMenu(null);
         const straightLine = tool === "draw" ? createStraightStrokeState(startPoint, e.clientX, e.clientY) : void 0;
         const itemId = createShapeId();
         const item = createFreehandStrokeItem(
@@ -10229,6 +10695,7 @@ var VectorViewport = forwardRef(
       interactive,
       renderSceneWithLivePenStroke,
       screenToWorld,
+      startCanvuInteraction,
       startOrRestartStraightStrokeHoldTimer
     ]);
     useEffect(() => {
@@ -10279,15 +10746,32 @@ var VectorViewport = forwardRef(
           stopTouchEvent(ev);
           return;
         }
-        wrapperRef.current?.focus({ preventScroll: true });
-        setContextMenu(null);
-        penDetectedRef.current = true;
         const startPoint = pointerSampleToWorldPoint(
           screenToWorld,
           touch.clientX,
           touch.clientY,
           touchPressure(touch)
         );
+        if (!startCanvuInteraction({
+          kind: "stroke",
+          toolId: tool,
+          pointerType: "pen",
+          button: 0,
+          worldX: startPoint.x,
+          worldY: startPoint.y,
+          clientX: touch.clientX,
+          clientY: touch.clientY,
+          shiftKey: ev.shiftKey,
+          altKey: ev.altKey,
+          metaKey: ev.metaKey,
+          ctrlKey: ev.ctrlKey
+        })) {
+          stopTouchEvent(ev);
+          return;
+        }
+        wrapperRef.current?.focus({ preventScroll: true });
+        setContextMenu(null);
+        penDetectedRef.current = true;
         const straightLine = tool === "draw" ? createStraightStrokeState(startPoint, touch.clientX, touch.clientY) : void 0;
         const itemId = createShapeId();
         const item = createFreehandStrokeItem(
@@ -10333,6 +10817,12 @@ var VectorViewport = forwardRef(
           touch.clientY,
           touchPressure(touch)
         );
+        updateCanvuInteractionCurrent({
+          worldX: endpoint.x,
+          worldY: endpoint.y,
+          clientX: touch.clientX,
+          clientY: touch.clientY
+        });
         if (updateStraightStrokeForMove(st, touch.clientX, touch.clientY, endpoint)) {
           debugApplePencilPointer("touchmove-stroke", {
             touchId: touch.identifier,
@@ -10374,16 +10864,42 @@ var VectorViewport = forwardRef(
         if (st.kind !== "stroke") return;
         const touch = findChangedTouch(ev.changedTouches);
         if (!touch) return;
+        const currentPoint = pointerSampleToWorldPoint(
+          screenToWorld,
+          touch.clientX,
+          touch.clientY,
+          touchPressure(touch)
+        );
+        updateCanvuInteractionCurrent({
+          worldX: currentPoint.x,
+          worldY: currentPoint.y,
+          clientX: touch.clientX,
+          clientY: touch.clientY
+        });
+        if (ev.type === "touchcancel") {
+          clearStraightStrokeHoldTimer(st);
+          dragStateRef.current = { kind: "idle" };
+          releaseInteractionPointer();
+          if (st.itemId) {
+            renderSceneWithLivePenStroke(null);
+          }
+          emitRemoteStrokePreviewClear();
+          setPlacementPreview(null);
+          finishCanvuInteraction("cancelled", {
+            current: {
+              worldX: currentPoint.x,
+              worldY: currentPoint.y,
+              clientX: touch.clientX,
+              clientY: touch.clientY
+            }
+          });
+          stopTouchEvent(ev);
+          return;
+        }
         const cam = cameraRef.current;
         if (cam) {
           if (st.straightLine?.active) {
-            const endpoint = pointerSampleToWorldPoint(
-              screenToWorld,
-              touch.clientX,
-              touch.clientY,
-              touchPressure(touch)
-            );
-            setStraightStrokeEndpoint(st, endpoint);
+            setStraightStrokeEndpoint(st, currentPoint);
           } else {
             const completedPoints = appendTouchToStrokePoints(
               st.points,
@@ -10434,12 +10950,17 @@ var VectorViewport = forwardRef(
     }, [
       applePencilNav,
       emitRemoteStrokePreview,
+      emitRemoteStrokePreviewClear,
       finalizeStrokeDragState,
+      finishCanvuInteraction,
       interactive,
+      releaseInteractionPointer,
       renderSceneWithLivePenStroke,
       screenToWorld,
       setStraightStrokeEndpoint,
+      startCanvuInteraction,
       startOrRestartStraightStrokeHoldTimer,
+      updateCanvuInteractionCurrent,
       updateStraightStrokeForMove
     ]);
     useEffect(() => {
@@ -10452,6 +10973,12 @@ var VectorViewport = forwardRef(
         if (st.kind === "tap") return;
         if (st.kind === "marquee") {
           const { worldX: worldX2, worldY: worldY2 } = screenToWorld(ev.clientX, ev.clientY);
+          updateCanvuInteractionCurrent({
+            worldX: worldX2,
+            worldY: worldY2,
+            clientX: ev.clientX,
+            clientY: ev.clientY
+          });
           const raw = rectFromCorners(st.startWorld, { x: worldX2, y: worldY2 });
           setPlacementPreview({ kind: "marquee", rect: raw });
           const nextCand = collectItemIdsInRect(
@@ -10479,6 +11006,12 @@ var VectorViewport = forwardRef(
             ev.clientY,
             ev.pointerType === "pen" ? ev.pressure : void 0
           );
+          updateCanvuInteractionCurrent({
+            worldX: endpoint.x,
+            worldY: endpoint.y,
+            clientX: ev.clientX,
+            clientY: ev.clientY
+          });
           if (updateStraightStrokeForMove(st, ev.clientX, ev.clientY, endpoint)) {
             return;
           }
@@ -10527,6 +11060,12 @@ var VectorViewport = forwardRef(
         }
         if (st.kind === "erase") {
           const { worldX: worldX2, worldY: worldY2 } = screenToWorld(ev.clientX, ev.clientY);
+          updateCanvuInteractionCurrent({
+            worldX: worldX2,
+            worldY: worldY2,
+            clientX: ev.clientX,
+            clientY: ev.clientY
+          });
           const lineHitWorld = 10 / cam.zoom;
           setEraserTrail(
             (prev) => pruneEraserTrail([...prev, { x: worldX2, y: worldY2, t: Date.now() }])
@@ -10552,6 +11091,12 @@ var VectorViewport = forwardRef(
         const change = onItemsChangeRef.current;
         if (!change) return;
         const { worldX, worldY } = screenToWorld(ev.clientX, ev.clientY);
+        updateCanvuInteractionCurrent({
+          worldX,
+          worldY,
+          clientX: ev.clientX,
+          clientY: ev.clientY
+        });
         if (st.kind === "select-mode-item-click") {
           const screenDx = ev.clientX - st.startScreen.x;
           const screenDy = ev.clientY - st.startScreen.y;
@@ -10684,48 +11229,69 @@ var VectorViewport = forwardRef(
           setPlacementPreview(null);
           marqueeCandidateIdsRef.current = [];
           setMarqueeCandidateIds([]);
+          finishCanvuInteraction("cancelled");
           return;
         }
+        const finishOutcome = ev.type === "pointercancel" ? "cancelled" : "completed";
+        const currentWorld = screenToWorld(ev.clientX, ev.clientY);
+        const currentInteractionPoint = {
+          worldX: currentWorld.worldX,
+          worldY: currentWorld.worldY,
+          clientX: ev.clientX,
+          clientY: ev.clientY
+        };
+        updateCanvuInteractionCurrent(currentInteractionPoint);
         if (st.kind === "move" || st.kind === "resize" || st.kind === "rotate") {
+          const info = st.kind === "move" ? { motive: "move", itemIds: [...st.ids] } : st.kind === "resize" ? { motive: "resize", itemIds: [st.id] } : { motive: "rotate", itemIds: [st.id] };
           dragStateRef.current = { kind: "idle" };
           releaseInteractionPointer();
+          finishCanvuInteraction(finishOutcome, {
+            current: currentInteractionPoint,
+            ...finishOutcome === "completed" ? { info } : {}
+          });
           return;
         }
         if (st.kind === "select-mode-item-click") {
           dragStateRef.current = { kind: "idle" };
           releaseInteractionPointer();
-          if (ev.type === "pointercancel") return;
+          if (finishOutcome === "cancelled") {
+            finishCanvuInteraction("cancelled", {
+              current: currentInteractionPoint
+            });
+            return;
+          }
           const dx = ev.clientX - st.startScreen.x;
           const dy = ev.clientY - st.startScreen.y;
-          if (Math.hypot(dx, dy) > TAP_PX) return;
+          if (Math.hypot(dx, dy) > TAP_PX) {
+            finishCanvuInteraction("cancelled", {
+              current: currentInteractionPoint
+            });
+            return;
+          }
           const item = itemsRef.current.find((candidate) => candidate.id === st.id) ?? resolvedItemsRef.current.find((candidate) => candidate.id === st.id);
-          if (!item) return;
-          const placement = findSelectModeItemClickPlacement(
+          if (!item) {
+            finishCanvuInteraction("cancelled", {
+              current: currentInteractionPoint
+            });
+            return;
+          }
+          const placement = findReadOnlyItemClickPlacement(
             item,
             allCustomPlacementsRef.current
           );
           const onSelectModeItemClick = placement?.onSelectModeItemClick;
-          if (!onSelectModeItemClick) return;
-          const { worldX, worldY } = screenToWorld(ev.clientX, ev.clientY);
-          onSelectModeItemClick({
-            item,
-            worldX,
-            worldY,
-            clientX: ev.clientX,
-            clientY: ev.clientY,
-            pointerType: ev.pointerType,
-            shiftKey: ev.shiftKey,
-            altKey: ev.altKey,
-            metaKey: ev.metaKey,
-            ctrlKey: ev.ctrlKey,
-            items: itemsRef.current,
-            updateItem: (next) => {
-              onItemsChangeRef.current?.(
-                replaceItem(itemsRef.current, item.id, next),
-                { motive: "custom", itemIds: [item.id] }
-              );
-            },
-            setSelectedIds: (ids) => setEffectiveSelectedIdsRef.current(ids)
+          if (!onSelectModeItemClick) {
+            finishCanvuInteraction("cancelled", {
+              current: currentInteractionPoint
+            });
+            return;
+          }
+          onSelectModeItemClick(
+            buildSelectModeItemClickDetail(item, currentWorld, ev)
+          );
+          finishCanvuInteraction("completed", {
+            current: currentInteractionPoint,
+            info: { motive: "custom", itemIds: [item.id], toolId: "select" }
           });
           return;
         }
@@ -10735,16 +11301,25 @@ var VectorViewport = forwardRef(
           setPlacementPreview(null);
           marqueeCandidateIdsRef.current = [];
           setMarqueeCandidateIds([]);
-          const { worldX, worldY } = screenToWorld(ev.clientX, ev.clientY);
+          const { worldX, worldY } = currentWorld;
           const raw = rectFromCorners(st.startWorld, { x: worldX, y: worldY });
           const br = normalizeRect(raw);
           const screenDx = ev.clientX - st.startScreen.x;
           const screenDy = ev.clientY - st.startScreen.y;
+          if (finishOutcome === "cancelled") {
+            finishCanvuInteraction("cancelled", {
+              current: currentInteractionPoint
+            });
+            return;
+          }
           const tooSmall = Math.hypot(screenDx, screenDy) < TAP_PX || br.width < MIN_MARQUEE_WORLD && br.height < MIN_MARQUEE_WORLD;
           if (tooSmall) {
             if (!st.shiftKey) {
               setEffectiveSelectedIdsRef.current([]);
             }
+            finishCanvuInteraction("cancelled", {
+              current: currentInteractionPoint
+            });
             return;
           }
           const picked = collectItemIdsInRect(resolvedItemsRef.current, br);
@@ -10761,9 +11336,26 @@ var VectorViewport = forwardRef(
           } else {
             setEffectiveSelectedIdsRef.current(picked);
           }
+          finishCanvuInteraction("completed", {
+            current: currentInteractionPoint
+          });
           return;
         }
         if (st.kind === "stroke") {
+          if (finishOutcome === "cancelled") {
+            clearStraightStrokeHoldTimer(st);
+            dragStateRef.current = { kind: "idle" };
+            releaseInteractionPointer();
+            if (st.itemId) {
+              renderSceneWithLivePenStroke(null);
+            }
+            emitRemoteStrokePreviewClear();
+            setPlacementPreview(null);
+            finishCanvuInteraction("cancelled", {
+              current: currentInteractionPoint
+            });
+            return;
+          }
           const completedPoints = (() => {
             if (st.straightLine?.active) {
               const endpoint = pointerSampleToWorldPoint(
@@ -10794,15 +11386,20 @@ var VectorViewport = forwardRef(
         }
         if (st.kind === "erase") {
           const change = onItemsChangeRef.current;
+          const erasedIds = [...eraserPreviewIdsRef.current];
+          const info = erasedIds.length > 0 ? {
+            motive: "erase",
+            itemIds: erasedIds,
+            toolId: "eraser"
+          } : void 0;
           if (change && eraserPreviewIdsRef.current.size > 0) {
             const idSet = new Set(eraserPreviewIdsRef.current);
-            change(
-              itemsRef.current.filter((i) => !idSet.has(i.id)),
-              {
-                motive: "erase",
-                itemIds: [...idSet]
-              }
-            );
+            if (finishOutcome === "completed") {
+              change(
+                itemsRef.current.filter((i) => !idSet.has(i.id)),
+                info
+              );
+            }
           }
           eraserPreviewIdsRef.current.clear();
           setEraserPreviewIds([]);
@@ -10810,7 +11407,13 @@ var VectorViewport = forwardRef(
           setEraserActive(false);
           dragStateRef.current = { kind: "idle" };
           releaseInteractionPointer();
-          requestAutoResetTool("eraser");
+          if (finishOutcome === "completed") {
+            requestAutoResetTool("eraser");
+          }
+          finishCanvuInteraction(finishOutcome, {
+            current: currentInteractionPoint,
+            ...finishOutcome === "completed" && info ? { info } : {}
+          });
           return;
         }
         if (st.kind === "tap") {
@@ -10818,11 +11421,22 @@ var VectorViewport = forwardRef(
           const dy = ev.clientY - st.startScreen.y;
           dragStateRef.current = { kind: "idle" };
           releaseInteractionPointer();
-          if (Math.hypot(dx, dy) > TAP_PX) return;
+          if (finishOutcome === "cancelled" || Math.hypot(dx, dy) > TAP_PX) {
+            finishCanvuInteraction("cancelled", {
+              current: currentInteractionPoint
+            });
+            return;
+          }
           const change = onItemsChangeRef.current;
-          if (!change) return;
+          if (!change) {
+            finishCanvuInteraction("cancelled", {
+              current: currentInteractionPoint
+            });
+            return;
+          }
           const id = createShapeId();
           const { x: worldX, y: worldY } = st.startWorld;
+          let info;
           if (st.tool === "text") {
             const fs = strokeStyleRef.current.textFontSize;
             const baseline = textBaselineYFor(fs);
@@ -10845,11 +11459,12 @@ var VectorViewport = forwardRef(
               bounds: { ...newItem.bounds }
             };
             const hidden = applyTextDraftWhileEditing(newItem, "");
-            change([...itemsRef.current, hidden], {
+            info = {
               motive: "text-create",
               itemIds: [id],
               toolId: st.tool
-            });
+            };
+            change([...itemsRef.current, hidden], info);
             setEffectiveSelectedIdsRef.current([id]);
             setEditingTextId(id);
             setDraftText("");
@@ -10858,6 +11473,10 @@ var VectorViewport = forwardRef(
             imageInputRef.current?.click();
           }
           requestAutoResetTool(st.tool);
+          finishCanvuInteraction("completed", {
+            current: currentInteractionPoint,
+            ...info ? { info } : {}
+          });
           return;
         }
         if (st.kind === "place") {
@@ -10868,11 +11487,19 @@ var VectorViewport = forwardRef(
           dragStateRef.current = { kind: "idle" };
           releaseInteractionPointer();
           setPlacementPreview(null);
-          if (!change) return;
+          if (finishOutcome === "cancelled" || !change) {
+            finishCanvuInteraction("cancelled", {
+              current: currentInteractionPoint
+            });
+            return;
+          }
           if (st.tool === "arrow") {
             const screenDx = ev.clientX - st.startScreen.x;
             const screenDy = ev.clientY - st.startScreen.y;
             if (Math.hypot(screenDx, screenDy) < MIN_ARROW_DRAG_PX) {
+              finishCanvuInteraction("cancelled", {
+                current: currentInteractionPoint
+              });
               return;
             }
             const maxDist = ARROW_BIND_SNAP_PX / cam.zoom;
@@ -10904,18 +11531,23 @@ var VectorViewport = forwardRef(
                 ...snapB ? { end: snapB.binding } : {}
               };
             }
+            const info2 = {
+              motive: "place",
+              itemIds: [id2],
+              toolId: st.tool
+            };
             change(
               [
                 ...itemsRef.current,
                 createLineItem(id2, rawArrow, line, "arrow", pen2, arrowBind)
               ],
-              {
-                motive: "place",
-                itemIds: [id2],
-                toolId: st.tool
-              }
+              info2
             );
             setEffectiveSelectedIdsRef.current([id2]);
+            finishCanvuInteraction("completed", {
+              current: currentInteractionPoint,
+              info: info2
+            });
             return;
           }
           let raw = rectFromCorners(a, b);
@@ -10940,47 +11572,61 @@ var VectorViewport = forwardRef(
           }
           const id = createShapeId();
           const pen = strokeStyleRef.current;
+          let info;
           if (cpUp && st.tool === cpUp.toolId) {
             const item = tagCustomPlacementItem(
               cpUp.createItem({ id, bounds: br }),
               cpUp.toolId
             );
-            change(itemsRef.current.concat(item), {
+            info = {
               motive: "place",
               itemIds: [id],
               toolId: st.tool
-            });
+            };
+            change(itemsRef.current.concat(item), info);
             if (cpUp.selectAfterCreate !== false) {
               setEffectiveSelectedIdsRef.current([id]);
             }
+            finishCanvuInteraction("completed", {
+              current: currentInteractionPoint,
+              info
+            });
             return;
           }
           if (st.tool === "rect") {
-            change([...itemsRef.current, createRectangleItem(id, raw, pen)], {
+            info = {
               motive: "place",
               itemIds: [id],
               toolId: st.tool
-            });
+            };
+            change([...itemsRef.current, createRectangleItem(id, raw, pen)], info);
             setEffectiveSelectedIdsRef.current([id]);
           } else if (st.tool === "ellipse") {
-            change([...itemsRef.current, createEllipseItem(id, raw, pen)], {
+            info = {
               motive: "place",
               itemIds: [id],
               toolId: st.tool
-            });
+            };
+            change([...itemsRef.current, createEllipseItem(id, raw, pen)], info);
             setEffectiveSelectedIdsRef.current([id]);
           } else if (st.tool === "architectural-cloud") {
+            info = {
+              motive: "place",
+              itemIds: [id],
+              toolId: st.tool
+            };
             change(
               [...itemsRef.current, createArchitecturalCloudItem(id, raw, pen)],
-              {
-                motive: "place",
-                itemIds: [id],
-                toolId: st.tool
-              }
+              info
             );
             setEffectiveSelectedIdsRef.current([id]);
           } else if (st.tool === "line" || st.tool === "arrow") {
             const line = lineEndpointsToLocal(raw, lineA, lineB);
+            info = {
+              motive: "place",
+              itemIds: [id],
+              toolId: st.tool
+            };
             change(
               [
                 ...itemsRef.current,
@@ -10992,15 +11638,15 @@ var VectorViewport = forwardRef(
                   pen
                 )
               ],
-              {
-                motive: "place",
-                itemIds: [id],
-                toolId: st.tool
-              }
+              info
             );
             setEffectiveSelectedIdsRef.current([id]);
           }
           requestAutoResetTool(st.tool);
+          finishCanvuInteraction("completed", {
+            current: currentInteractionPoint,
+            ...info ? { info } : {}
+          });
         }
       };
       document.addEventListener("pointermove", onMove);
@@ -11012,17 +11658,20 @@ var VectorViewport = forwardRef(
         document.removeEventListener("pointercancel", onUp);
       };
     }, [
+      buildSelectModeItemClickDetail,
       emitRemoteStrokePreview,
       emitRemoteStrokePreviewClear,
       interactive,
       pruneEraserTrail,
       pruneLaserTrail,
       finalizeStrokeDragState,
+      finishCanvuInteraction,
       renderSceneWithLivePenStroke,
       releaseInteractionPointer,
       requestAutoResetTool,
       screenToWorld,
       setStraightStrokeEndpoint,
+      updateCanvuInteractionCurrent,
       updateStraightStrokeForMove
     ]);
     const selectedItemsForOverlay = useMemo(() => {