canvu-react 0.4.76 → 0.4.78

package/dist/react.d.cts

@@ -4,8 +4,8 @@ import { V as VectorViewportAssetKind, a as VectorViewportAssetStore } from './r
 export { b as RasterImageCanvasRenderRequest, c as RasterImageCanvasRenderTarget, d as RasterImageCanvasRenderTargetResolver, R as RasterImageCanvasRenderingOptions, e as RasterImageCanvasSource, f as RasterImageCanvasSourceRequest, g as RasterImageCanvasSourceResolver, h as RasterImageCanvasSourceSizeRequest, i as RasterImageCanvasSourceSizeResolver, j as VectorViewportAssetHydrationRequest, k as VectorViewportAssetResolveRequest, l as VectorViewportAssetResolveResult, m as VectorViewportAssetUploadRequest, n as VectorViewportAssetUploadResult } from './raster-image-canvas-ByaCKEVw.cjs';
 import { I as IndexedDbImageStore } from './asset-hydration-6swZ6ciN.cjs';
 export { H as HydratedSceneItemsWithAssetsResult, h as hydrateSceneItemsWithAssets } from './asset-hydration-6swZ6ciN.cjs';
-import { B as BoardComponentPosition, V as VectorToolDefinition, C as CustomShapePlacementOptions, a as CanvuBeforeInteractionHook, b as CanvuAfterInteractionHook, c as CanvasPlugin, d as VectorSelectionInspector } from './types-DOUBapS4.cjs';
-export { e as CanvasPluginComponentProps, f as CanvasPluginContribution, g as CanvasPluginItemsChangeMiddlewareContext, h as CanvasPluginRenderContext, i as CanvuAfterInteractionDetail, j as CanvuBeforeInteractionResult, k as CanvuChromeActiveToolStyle, l as CanvuChromeContext, m as CanvuChromeContextValue, n as CanvuChromeSelectionStyleChange, o as CanvuInteractionDetail, p as CanvuInteractionKind, q as CanvuInteractionOutcome, r as CanvuInteractionPoint, s as CanvuPluginContext, t as CanvuPluginContextValue, u as CanvuPluginViewportSnapshot, P as PlacementPreview, R as ReadOnlyInteractionOptions, v as ReadOnlyItemClickCandidateDetail, w as ReadOnlyItemClickScope, S as SHAPE_CONTEXT_MENU_ITEM_IDS, x as SelectModeItemClickDetail, y as SelectModeItemClickResult, z as ShapeContextMenu, A as ShapeContextMenuItem, D as ShapeContextMenuProps, E as ShapeContextMenuRenderContext, F as VectorCanvasSpacePosition, G as VectorItemsChangeInfo, H as VectorItemsChangeMotive, I as VectorSelectionInspectorProps, J as VectorViewport, K as VectorViewportHandle, L as VectorViewportProps, W as WorldPointerDownDetail, M as createCanvuPlugin, N as getBoardPositionStyle, O as useCanvuChromeContext, Q as useCanvuDocumentContext, T as useCanvuPluginContext, U as useCanvuPluginContribution, X as useCanvuResolvedTools, Y as useCanvuViewportContext } from './types-DOUBapS4.cjs';
+import { V as VectorToolDefinition, C as CustomShapePlacementOptions, a as CanvuBeforeInteractionHook, b as CanvuAfterInteractionHook, c as CanvasPlugin, d as VectorItemsChangeInfo, B as BoardComponentPosition, e as VectorSelectionInspector } from './VectorViewport-MlKilYoG.cjs';
+export { f as CanvasPluginComponentProps, g as CanvasPluginContribution, h as CanvasPluginItemsChangeMiddlewareContext, i as CanvasPluginRenderContext, j as CanvuAfterInteractionDetail, k as CanvuBeforeInteractionResult, l as CanvuChromeActiveToolStyle, m as CanvuChromeContext, n as CanvuChromeContextValue, o as CanvuChromeSelectionStyleChange, p as CanvuInteractionDetail, q as CanvuInteractionKind, r as CanvuInteractionOutcome, s as CanvuInteractionPoint, t as CanvuPluginContext, u as CanvuPluginContextValue, v as CanvuPluginViewportSnapshot, P as PlacementPreview, R as ReadOnlyInteractionOptions, w as ReadOnlyItemClickCandidateDetail, x as ReadOnlyItemClickScope, S as SHAPE_CONTEXT_MENU_ITEM_IDS, y as SelectModeItemClickDetail, z as SelectModeItemClickResult, A as ShapeContextMenu, D as ShapeContextMenuItem, E as ShapeContextMenuProps, F as ShapeContextMenuRenderContext, G as VectorCanvasSpacePosition, H as VectorItemsChangeMotive, I as VectorSelectionInspectorProps, J as VectorViewport, K as VectorViewportHandle, L as VectorViewportProps, W as WorldPointerDownDetail, M as createCanvuPlugin, N as getBoardPositionStyle, O as useCanvuChromeContext, Q as useCanvuDocumentContext, T as useCanvuPluginContext, U as useCanvuPluginContribution, X as useCanvuResolvedTools, Y as useCanvuViewportContext } from './VectorViewport-MlKilYoG.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { CSSProperties, ReactNode, ReactElement, SVGProps } from 'react';
@@ -164,6 +164,74 @@ type IngestAssetFilesToSceneItemsResult = {
  */
 declare function ingestAssetFilesToSceneItems(options: IngestAssetFilesToSceneItemsOptions): Promise<IngestAssetFilesToSceneItemsResult>;
 
+type CreateToolPluginOptions = VectorToolDefinition & {
+    /**
+     * Optional custom placement factory for tools that create scene items directly.
+     *
+     * When provided, the resulting plugin contributes a `customPlacement` entry for this tool id.
+     */
+    createItem?: (args: {
+        id: string;
+        bounds: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    }) => VectorSceneItem;
+    /**
+     * Whether items created by this tool should become selected immediately after placement.
+     *
+     * Defaults to `true`. Set to `false` for clickable custom tools such as pins,
+     * reactions, or cards that should act without showing selection handles on placement.
+     */
+    selectAfterCreate?: CustomShapePlacementOptions["selectAfterCreate"];
+    /**
+     * Handles plain clicks on this tool's items while the viewport is in select mode.
+     *
+     * Resize and rotate handles still take priority. Returning `"handled"` marks the
+     * click as owned by the tool; dragging past the tap threshold still falls back to
+     * normal move behavior.
+     */
+    onSelectModeItemClick?: CustomShapePlacementOptions["onSelectModeItemClick"];
+    /**
+     * Runs before Canvu handles this tool's accepted pointer interaction.
+     *
+     * Return `"handled"` to claim the gesture and skip Canvu's built-in behavior.
+     * The hook is automatically scoped to this tool id.
+     */
+    onBeforeInteraction?: CanvuBeforeInteractionHook;
+    /**
+     * Runs once after this tool's accepted pointer interaction completes or is
+     * cancelled.
+     *
+     * The hook is automatically scoped to this tool id. Use it for custom cleanup,
+     * analytics, or side effects that should happen after the gesture lifecycle.
+     */
+    onAfterInteraction?: CanvuAfterInteractionHook;
+    /**
+     * Optional tool list transform applied after this tool is merged.
+     *
+     * Use this when you need custom ordering or to replace an existing tool position.
+     */
+    toolTransform?: (tools: VectorToolDefinition[]) => VectorToolDefinition[];
+};
+/**
+ * Creates a lightweight plugin that contributes a single tool to `VectorViewport`.
+ *
+ * Use this for isolated tools such as custom shapes, review pins, or lightweight creation flows.
+ * For larger features that also need presence, panels, or network integration, prefer a dedicated
+ * feature plugin such as `realtimeCollaborationPlugin(...)`.
+ */
+declare function createToolPlugin(options: CreateToolPluginOptions): CanvasPlugin;
+
+/**
+ * CSS `cursor` for the active toolbar tool id (see default vector tools).
+ * SVG cursors matching Lucide toolbar glyphs are used for freehand tools only.
+ * Shape tools keep the old native crosshair cursor.
+ */
+declare function cursorForVectorToolId(toolId: string): string;
+
 type ImagesMenuLabels = {
     title?: string;
     dragHandle?: string;
@@ -211,7 +279,27 @@ type ImagesMenuCollapsedButtonRenderProps = {
 type ImagesMenuActionId = "duplicate" | "rotate" | "delete";
 type ImagesMenuProps = {
     items: readonly VectorSceneItem[];
-    onItemsChange: (items: VectorSceneItem[]) => void;
+    /**
+     * Called when the managed image list changes.
+     *
+     * The optional `info` argument matches {@link VectorViewportProps.onItemsChange}
+     * metadata. Built-in menu actions emit `"duplicate"`, `"rotate"`, `"delete"`,
+     * or `"reorder"` motives with affected item ids when known, so middleware,
+     * analytics, and confirmation flows can treat image-menu mutations like other
+     * Canvu-owned actions. Simple state setters can ignore the second argument.
+     *
+     * @example
+     * ```tsx
+     * <ImagesMenu
+     *   items={items}
+     *   onItemsChange={(next, info) => {
+     *     if (info?.motive === "delete") confirmDelete(next);
+     *     else setItems(next);
+     *   }}
+     * />
+     * ```
+     */
+    onItemsChange: (items: VectorSceneItem[], info?: VectorItemsChangeInfo) => void;
     /**
      * Fires when the user clicks an image's thumbnail/label area. Use this to
      * pan/zoom the canvas to the item (e.g. `viewportRef.current?.fitWorldRect(item.bounds)`).
@@ -469,74 +557,6 @@ type UseVectorCanvasDocumentResult = {
  */
 declare function useVectorCanvasDocument(options?: UseVectorCanvasDocumentOptions): UseVectorCanvasDocumentResult;
 
-/**
- * CSS `cursor` for the active toolbar tool id (see default vector tools).
- * SVG cursors matching Lucide toolbar glyphs are used for freehand tools only.
- * Shape tools keep the old native crosshair cursor.
- */
-declare function cursorForVectorToolId(toolId: string): string;
-
-type CreateToolPluginOptions = VectorToolDefinition & {
-    /**
-     * Optional custom placement factory for tools that create scene items directly.
-     *
-     * When provided, the resulting plugin contributes a `customPlacement` entry for this tool id.
-     */
-    createItem?: (args: {
-        id: string;
-        bounds: {
-            x: number;
-            y: number;
-            width: number;
-            height: number;
-        };
-    }) => VectorSceneItem;
-    /**
-     * Whether items created by this tool should become selected immediately after placement.
-     *
-     * Defaults to `true`. Set to `false` for clickable custom tools such as pins,
-     * reactions, or cards that should act without showing selection handles on placement.
-     */
-    selectAfterCreate?: CustomShapePlacementOptions["selectAfterCreate"];
-    /**
-     * Handles plain clicks on this tool's items while the viewport is in select mode.
-     *
-     * Resize and rotate handles still take priority. Returning `"handled"` marks the
-     * click as owned by the tool; dragging past the tap threshold still falls back to
-     * normal move behavior.
-     */
-    onSelectModeItemClick?: CustomShapePlacementOptions["onSelectModeItemClick"];
-    /**
-     * Runs before Canvu handles this tool's accepted pointer interaction.
-     *
-     * Return `"handled"` to claim the gesture and skip Canvu's built-in behavior.
-     * The hook is automatically scoped to this tool id.
-     */
-    onBeforeInteraction?: CanvuBeforeInteractionHook;
-    /**
-     * Runs once after this tool's accepted pointer interaction completes or is
-     * cancelled.
-     *
-     * The hook is automatically scoped to this tool id. Use it for custom cleanup,
-     * analytics, or side effects that should happen after the gesture lifecycle.
-     */
-    onAfterInteraction?: CanvuAfterInteractionHook;
-    /**
-     * Optional tool list transform applied after this tool is merged.
-     *
-     * Use this when you need custom ordering or to replace an existing tool position.
-     */
-    toolTransform?: (tools: VectorToolDefinition[]) => VectorToolDefinition[];
-};
-/**
- * Creates a lightweight plugin that contributes a single tool to `VectorViewport`.
- *
- * Use this for isolated tools such as custom shapes, review pins, or lightweight creation flows.
- * For larger features that also need presence, panels, or network integration, prefer a dedicated
- * feature plugin such as `realtimeCollaborationPlugin(...)`.
- */
-declare function createToolPlugin(options: CreateToolPluginOptions): CanvasPlugin;
-
 /**
  * Tool ids shown in the overflow menu at the end of the default toolbar (horizontal layout).
  * Order: shapes, marker, laser, image.
@@ -845,4 +865,4 @@ type VectorToolbarWithStatics = ((props: VectorToolbarProps) => ReactElement) &
  */
 declare const VectorToolbar: VectorToolbarWithStatics;
 
-export { BoardComponentPosition, CanvasPlugin, CanvuAfterInteractionHook, CanvuBeforeInteractionHook, type CreateLocalStoragePersistenceAdapterOptions, type CreateToolPluginOptions, CustomShapePlacementOptions, DEFAULT_OVERFLOW_TOOL_IDS, DEFAULT_VECTOR_CANVAS_STORAGE_KEY, DEFAULT_VECTOR_TOOLS, IconArchitecturalCloud, IconArrow, IconDraw, IconEllipse, IconHand, IconImage, IconLaser, IconLine, IconRect, IconSelect, IconText, ImagesMenu, type ImagesMenuActionId, type ImagesMenuCollapsedButtonProps, type ImagesMenuCollapsedButtonRenderProps, type ImagesMenuLabels, type ImagesMenuProps, type IngestAssetFileError, type IngestAssetFilesToSceneItemsOptions, type IngestAssetFilesToSceneItemsResult, type IngestedAssetItemContext, NavMenu, type NavMenuMinimapProps, type NavMenuProps, type NavMenuUndoRedoProps, type NavMenuZoomControlsProps, type UseVectorCanvasDocumentOptions, type UseVectorCanvasDocumentResult, VectorCanvas, VectorCanvasBody, VectorCanvasHeader, VectorCanvasMain, VectorCanvasPersistenceAdapter, VectorCanvasRemoteAdapter, VectorCanvasRoot, type VectorCanvasSlotProps, type VectorCanvasSpaceProps, VectorCanvasToolbar, type VectorCanvasToolbarProps, VectorCanvasViewportSurface, VectorSelectionInspector, VectorToolDefinition, VectorToolbar, type VectorToolbarOverflowProps, type VectorToolbarProps, type VectorToolbarRenderContext, type VectorToolbarToolLockProps, type VectorToolbarToolProps, VectorViewportAssetKind, VectorViewportAssetStore, createIndexedDbPersistenceAdapter, createLocalStoragePersistenceAdapter, createNoopPersistenceAdapter, createToolPlugin, cursorForVectorToolId, ingestAssetFilesToSceneItems, useVectorCanvasDocument };
+export { BoardComponentPosition, CanvasPlugin, CanvuAfterInteractionHook, CanvuBeforeInteractionHook, type CreateLocalStoragePersistenceAdapterOptions, type CreateToolPluginOptions, CustomShapePlacementOptions, DEFAULT_OVERFLOW_TOOL_IDS, DEFAULT_VECTOR_CANVAS_STORAGE_KEY, DEFAULT_VECTOR_TOOLS, IconArchitecturalCloud, IconArrow, IconDraw, IconEllipse, IconHand, IconImage, IconLaser, IconLine, IconRect, IconSelect, IconText, ImagesMenu, type ImagesMenuActionId, type ImagesMenuCollapsedButtonProps, type ImagesMenuCollapsedButtonRenderProps, type ImagesMenuLabels, type ImagesMenuProps, type IngestAssetFileError, type IngestAssetFilesToSceneItemsOptions, type IngestAssetFilesToSceneItemsResult, type IngestedAssetItemContext, NavMenu, type NavMenuMinimapProps, type NavMenuProps, type NavMenuUndoRedoProps, type NavMenuZoomControlsProps, type UseVectorCanvasDocumentOptions, type UseVectorCanvasDocumentResult, VectorCanvas, VectorCanvasBody, VectorCanvasHeader, VectorCanvasMain, VectorCanvasPersistenceAdapter, VectorCanvasRemoteAdapter, VectorCanvasRoot, type VectorCanvasSlotProps, type VectorCanvasSpaceProps, VectorCanvasToolbar, type VectorCanvasToolbarProps, VectorCanvasViewportSurface, VectorItemsChangeInfo, VectorSelectionInspector, VectorToolDefinition, VectorToolbar, type VectorToolbarOverflowProps, type VectorToolbarProps, type VectorToolbarRenderContext, type VectorToolbarToolLockProps, type VectorToolbarToolProps, VectorViewportAssetKind, VectorViewportAssetStore, createIndexedDbPersistenceAdapter, createLocalStoragePersistenceAdapter, createNoopPersistenceAdapter, createToolPlugin, cursorForVectorToolId, ingestAssetFilesToSceneItems, useVectorCanvasDocument };

package/dist/react.d.ts

@@ -4,8 +4,8 @@ import { V as VectorViewportAssetKind, a as VectorViewportAssetStore } from './r
 export { b as RasterImageCanvasRenderRequest, c as RasterImageCanvasRenderTarget, d as RasterImageCanvasRenderTargetResolver, R as RasterImageCanvasRenderingOptions, e as RasterImageCanvasSource, f as RasterImageCanvasSourceRequest, g as RasterImageCanvasSourceResolver, h as RasterImageCanvasSourceSizeRequest, i as RasterImageCanvasSourceSizeResolver, j as VectorViewportAssetHydrationRequest, k as VectorViewportAssetResolveRequest, l as VectorViewportAssetResolveResult, m as VectorViewportAssetUploadRequest, n as VectorViewportAssetUploadResult } from './raster-image-canvas-D3ZrySjr.js';
 import { I as IndexedDbImageStore } from './asset-hydration-P0M5hn-p.js';
 export { H as HydratedSceneItemsWithAssetsResult, h as hydrateSceneItemsWithAssets } from './asset-hydration-P0M5hn-p.js';
-import { B as BoardComponentPosition, V as VectorToolDefinition, C as CustomShapePlacementOptions, a as CanvuBeforeInteractionHook, b as CanvuAfterInteractionHook, c as CanvasPlugin, d as VectorSelectionInspector } from './types-C5wxwquF.js';
-export { e as CanvasPluginComponentProps, f as CanvasPluginContribution, g as CanvasPluginItemsChangeMiddlewareContext, h as CanvasPluginRenderContext, i as CanvuAfterInteractionDetail, j as CanvuBeforeInteractionResult, k as CanvuChromeActiveToolStyle, l as CanvuChromeContext, m as CanvuChromeContextValue, n as CanvuChromeSelectionStyleChange, o as CanvuInteractionDetail, p as CanvuInteractionKind, q as CanvuInteractionOutcome, r as CanvuInteractionPoint, s as CanvuPluginContext, t as CanvuPluginContextValue, u as CanvuPluginViewportSnapshot, P as PlacementPreview, R as ReadOnlyInteractionOptions, v as ReadOnlyItemClickCandidateDetail, w as ReadOnlyItemClickScope, S as SHAPE_CONTEXT_MENU_ITEM_IDS, x as SelectModeItemClickDetail, y as SelectModeItemClickResult, z as ShapeContextMenu, A as ShapeContextMenuItem, D as ShapeContextMenuProps, E as ShapeContextMenuRenderContext, F as VectorCanvasSpacePosition, G as VectorItemsChangeInfo, H as VectorItemsChangeMotive, I as VectorSelectionInspectorProps, J as VectorViewport, K as VectorViewportHandle, L as VectorViewportProps, W as WorldPointerDownDetail, M as createCanvuPlugin, N as getBoardPositionStyle, O as useCanvuChromeContext, Q as useCanvuDocumentContext, T as useCanvuPluginContext, U as useCanvuPluginContribution, X as useCanvuResolvedTools, Y as useCanvuViewportContext } from './types-C5wxwquF.js';
+import { V as VectorToolDefinition, C as CustomShapePlacementOptions, a as CanvuBeforeInteractionHook, b as CanvuAfterInteractionHook, c as CanvasPlugin, d as VectorItemsChangeInfo, B as BoardComponentPosition, e as VectorSelectionInspector } from './VectorViewport-bSpT1CrU.js';
+export { f as CanvasPluginComponentProps, g as CanvasPluginContribution, h as CanvasPluginItemsChangeMiddlewareContext, i as CanvasPluginRenderContext, j as CanvuAfterInteractionDetail, k as CanvuBeforeInteractionResult, l as CanvuChromeActiveToolStyle, m as CanvuChromeContext, n as CanvuChromeContextValue, o as CanvuChromeSelectionStyleChange, p as CanvuInteractionDetail, q as CanvuInteractionKind, r as CanvuInteractionOutcome, s as CanvuInteractionPoint, t as CanvuPluginContext, u as CanvuPluginContextValue, v as CanvuPluginViewportSnapshot, P as PlacementPreview, R as ReadOnlyInteractionOptions, w as ReadOnlyItemClickCandidateDetail, x as ReadOnlyItemClickScope, S as SHAPE_CONTEXT_MENU_ITEM_IDS, y as SelectModeItemClickDetail, z as SelectModeItemClickResult, A as ShapeContextMenu, D as ShapeContextMenuItem, E as ShapeContextMenuProps, F as ShapeContextMenuRenderContext, G as VectorCanvasSpacePosition, H as VectorItemsChangeMotive, I as VectorSelectionInspectorProps, J as VectorViewport, K as VectorViewportHandle, L as VectorViewportProps, W as WorldPointerDownDetail, M as createCanvuPlugin, N as getBoardPositionStyle, O as useCanvuChromeContext, Q as useCanvuDocumentContext, T as useCanvuPluginContext, U as useCanvuPluginContribution, X as useCanvuResolvedTools, Y as useCanvuViewportContext } from './VectorViewport-bSpT1CrU.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { CSSProperties, ReactNode, ReactElement, SVGProps } from 'react';
@@ -164,6 +164,74 @@ type IngestAssetFilesToSceneItemsResult = {
  */
 declare function ingestAssetFilesToSceneItems(options: IngestAssetFilesToSceneItemsOptions): Promise<IngestAssetFilesToSceneItemsResult>;
 
+type CreateToolPluginOptions = VectorToolDefinition & {
+    /**
+     * Optional custom placement factory for tools that create scene items directly.
+     *
+     * When provided, the resulting plugin contributes a `customPlacement` entry for this tool id.
+     */
+    createItem?: (args: {
+        id: string;
+        bounds: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    }) => VectorSceneItem;
+    /**
+     * Whether items created by this tool should become selected immediately after placement.
+     *
+     * Defaults to `true`. Set to `false` for clickable custom tools such as pins,
+     * reactions, or cards that should act without showing selection handles on placement.
+     */
+    selectAfterCreate?: CustomShapePlacementOptions["selectAfterCreate"];
+    /**
+     * Handles plain clicks on this tool's items while the viewport is in select mode.
+     *
+     * Resize and rotate handles still take priority. Returning `"handled"` marks the
+     * click as owned by the tool; dragging past the tap threshold still falls back to
+     * normal move behavior.
+     */
+    onSelectModeItemClick?: CustomShapePlacementOptions["onSelectModeItemClick"];
+    /**
+     * Runs before Canvu handles this tool's accepted pointer interaction.
+     *
+     * Return `"handled"` to claim the gesture and skip Canvu's built-in behavior.
+     * The hook is automatically scoped to this tool id.
+     */
+    onBeforeInteraction?: CanvuBeforeInteractionHook;
+    /**
+     * Runs once after this tool's accepted pointer interaction completes or is
+     * cancelled.
+     *
+     * The hook is automatically scoped to this tool id. Use it for custom cleanup,
+     * analytics, or side effects that should happen after the gesture lifecycle.
+     */
+    onAfterInteraction?: CanvuAfterInteractionHook;
+    /**
+     * Optional tool list transform applied after this tool is merged.
+     *
+     * Use this when you need custom ordering or to replace an existing tool position.
+     */
+    toolTransform?: (tools: VectorToolDefinition[]) => VectorToolDefinition[];
+};
+/**
+ * Creates a lightweight plugin that contributes a single tool to `VectorViewport`.
+ *
+ * Use this for isolated tools such as custom shapes, review pins, or lightweight creation flows.
+ * For larger features that also need presence, panels, or network integration, prefer a dedicated
+ * feature plugin such as `realtimeCollaborationPlugin(...)`.
+ */
+declare function createToolPlugin(options: CreateToolPluginOptions): CanvasPlugin;
+
+/**
+ * CSS `cursor` for the active toolbar tool id (see default vector tools).
+ * SVG cursors matching Lucide toolbar glyphs are used for freehand tools only.
+ * Shape tools keep the old native crosshair cursor.
+ */
+declare function cursorForVectorToolId(toolId: string): string;
+
 type ImagesMenuLabels = {
     title?: string;
     dragHandle?: string;
@@ -211,7 +279,27 @@ type ImagesMenuCollapsedButtonRenderProps = {
 type ImagesMenuActionId = "duplicate" | "rotate" | "delete";
 type ImagesMenuProps = {
     items: readonly VectorSceneItem[];
-    onItemsChange: (items: VectorSceneItem[]) => void;
+    /**
+     * Called when the managed image list changes.
+     *
+     * The optional `info` argument matches {@link VectorViewportProps.onItemsChange}
+     * metadata. Built-in menu actions emit `"duplicate"`, `"rotate"`, `"delete"`,
+     * or `"reorder"` motives with affected item ids when known, so middleware,
+     * analytics, and confirmation flows can treat image-menu mutations like other
+     * Canvu-owned actions. Simple state setters can ignore the second argument.
+     *
+     * @example
+     * ```tsx
+     * <ImagesMenu
+     *   items={items}
+     *   onItemsChange={(next, info) => {
+     *     if (info?.motive === "delete") confirmDelete(next);
+     *     else setItems(next);
+     *   }}
+     * />
+     * ```
+     */
+    onItemsChange: (items: VectorSceneItem[], info?: VectorItemsChangeInfo) => void;
     /**
      * Fires when the user clicks an image's thumbnail/label area. Use this to
      * pan/zoom the canvas to the item (e.g. `viewportRef.current?.fitWorldRect(item.bounds)`).
@@ -469,74 +557,6 @@ type UseVectorCanvasDocumentResult = {
  */
 declare function useVectorCanvasDocument(options?: UseVectorCanvasDocumentOptions): UseVectorCanvasDocumentResult;
 
-/**
- * CSS `cursor` for the active toolbar tool id (see default vector tools).
- * SVG cursors matching Lucide toolbar glyphs are used for freehand tools only.
- * Shape tools keep the old native crosshair cursor.
- */
-declare function cursorForVectorToolId(toolId: string): string;
-
-type CreateToolPluginOptions = VectorToolDefinition & {
-    /**
-     * Optional custom placement factory for tools that create scene items directly.
-     *
-     * When provided, the resulting plugin contributes a `customPlacement` entry for this tool id.
-     */
-    createItem?: (args: {
-        id: string;
-        bounds: {
-            x: number;
-            y: number;
-            width: number;
-            height: number;
-        };
-    }) => VectorSceneItem;
-    /**
-     * Whether items created by this tool should become selected immediately after placement.
-     *
-     * Defaults to `true`. Set to `false` for clickable custom tools such as pins,
-     * reactions, or cards that should act without showing selection handles on placement.
-     */
-    selectAfterCreate?: CustomShapePlacementOptions["selectAfterCreate"];
-    /**
-     * Handles plain clicks on this tool's items while the viewport is in select mode.
-     *
-     * Resize and rotate handles still take priority. Returning `"handled"` marks the
-     * click as owned by the tool; dragging past the tap threshold still falls back to
-     * normal move behavior.
-     */
-    onSelectModeItemClick?: CustomShapePlacementOptions["onSelectModeItemClick"];
-    /**
-     * Runs before Canvu handles this tool's accepted pointer interaction.
-     *
-     * Return `"handled"` to claim the gesture and skip Canvu's built-in behavior.
-     * The hook is automatically scoped to this tool id.
-     */
-    onBeforeInteraction?: CanvuBeforeInteractionHook;
-    /**
-     * Runs once after this tool's accepted pointer interaction completes or is
-     * cancelled.
-     *
-     * The hook is automatically scoped to this tool id. Use it for custom cleanup,
-     * analytics, or side effects that should happen after the gesture lifecycle.
-     */
-    onAfterInteraction?: CanvuAfterInteractionHook;
-    /**
-     * Optional tool list transform applied after this tool is merged.
-     *
-     * Use this when you need custom ordering or to replace an existing tool position.
-     */
-    toolTransform?: (tools: VectorToolDefinition[]) => VectorToolDefinition[];
-};
-/**
- * Creates a lightweight plugin that contributes a single tool to `VectorViewport`.
- *
- * Use this for isolated tools such as custom shapes, review pins, or lightweight creation flows.
- * For larger features that also need presence, panels, or network integration, prefer a dedicated
- * feature plugin such as `realtimeCollaborationPlugin(...)`.
- */
-declare function createToolPlugin(options: CreateToolPluginOptions): CanvasPlugin;
-
 /**
  * Tool ids shown in the overflow menu at the end of the default toolbar (horizontal layout).
  * Order: shapes, marker, laser, image.
@@ -845,4 +865,4 @@ type VectorToolbarWithStatics = ((props: VectorToolbarProps) => ReactElement) &
  */
 declare const VectorToolbar: VectorToolbarWithStatics;
 
-export { BoardComponentPosition, CanvasPlugin, CanvuAfterInteractionHook, CanvuBeforeInteractionHook, type CreateLocalStoragePersistenceAdapterOptions, type CreateToolPluginOptions, CustomShapePlacementOptions, DEFAULT_OVERFLOW_TOOL_IDS, DEFAULT_VECTOR_CANVAS_STORAGE_KEY, DEFAULT_VECTOR_TOOLS, IconArchitecturalCloud, IconArrow, IconDraw, IconEllipse, IconHand, IconImage, IconLaser, IconLine, IconRect, IconSelect, IconText, ImagesMenu, type ImagesMenuActionId, type ImagesMenuCollapsedButtonProps, type ImagesMenuCollapsedButtonRenderProps, type ImagesMenuLabels, type ImagesMenuProps, type IngestAssetFileError, type IngestAssetFilesToSceneItemsOptions, type IngestAssetFilesToSceneItemsResult, type IngestedAssetItemContext, NavMenu, type NavMenuMinimapProps, type NavMenuProps, type NavMenuUndoRedoProps, type NavMenuZoomControlsProps, type UseVectorCanvasDocumentOptions, type UseVectorCanvasDocumentResult, VectorCanvas, VectorCanvasBody, VectorCanvasHeader, VectorCanvasMain, VectorCanvasPersistenceAdapter, VectorCanvasRemoteAdapter, VectorCanvasRoot, type VectorCanvasSlotProps, type VectorCanvasSpaceProps, VectorCanvasToolbar, type VectorCanvasToolbarProps, VectorCanvasViewportSurface, VectorSelectionInspector, VectorToolDefinition, VectorToolbar, type VectorToolbarOverflowProps, type VectorToolbarProps, type VectorToolbarRenderContext, type VectorToolbarToolLockProps, type VectorToolbarToolProps, VectorViewportAssetKind, VectorViewportAssetStore, createIndexedDbPersistenceAdapter, createLocalStoragePersistenceAdapter, createNoopPersistenceAdapter, createToolPlugin, cursorForVectorToolId, ingestAssetFilesToSceneItems, useVectorCanvasDocument };
+export { BoardComponentPosition, CanvasPlugin, CanvuAfterInteractionHook, CanvuBeforeInteractionHook, type CreateLocalStoragePersistenceAdapterOptions, type CreateToolPluginOptions, CustomShapePlacementOptions, DEFAULT_OVERFLOW_TOOL_IDS, DEFAULT_VECTOR_CANVAS_STORAGE_KEY, DEFAULT_VECTOR_TOOLS, IconArchitecturalCloud, IconArrow, IconDraw, IconEllipse, IconHand, IconImage, IconLaser, IconLine, IconRect, IconSelect, IconText, ImagesMenu, type ImagesMenuActionId, type ImagesMenuCollapsedButtonProps, type ImagesMenuCollapsedButtonRenderProps, type ImagesMenuLabels, type ImagesMenuProps, type IngestAssetFileError, type IngestAssetFilesToSceneItemsOptions, type IngestAssetFilesToSceneItemsResult, type IngestedAssetItemContext, NavMenu, type NavMenuMinimapProps, type NavMenuProps, type NavMenuUndoRedoProps, type NavMenuZoomControlsProps, type UseVectorCanvasDocumentOptions, type UseVectorCanvasDocumentResult, VectorCanvas, VectorCanvasBody, VectorCanvasHeader, VectorCanvasMain, VectorCanvasPersistenceAdapter, VectorCanvasRemoteAdapter, VectorCanvasRoot, type VectorCanvasSlotProps, type VectorCanvasSpaceProps, VectorCanvasToolbar, type VectorCanvasToolbarProps, VectorCanvasViewportSurface, VectorItemsChangeInfo, VectorSelectionInspector, VectorToolDefinition, VectorToolbar, type VectorToolbarOverflowProps, type VectorToolbarProps, type VectorToolbarRenderContext, type VectorToolbarToolLockProps, type VectorToolbarToolProps, VectorViewportAssetKind, VectorViewportAssetStore, createIndexedDbPersistenceAdapter, createLocalStoragePersistenceAdapter, createNoopPersistenceAdapter, createToolPlugin, cursorForVectorToolId, ingestAssetFilesToSceneItems, useVectorCanvasDocument };

package/dist/react.js

@@ -2248,6 +2248,10 @@ var defaultLabels = {
   collapse: "Collapse images menu",
   expand: "Open images menu"
 };
+function getAddedItemIds(before, after) {
+  const beforeIds = new Set(before.map((item) => item.id));
+  return after.filter((item) => !beforeIds.has(item.id)).map((item) => item.id);
+}
 function ImagesMenu({
   items,
   onItemsChange,
@@ -2306,12 +2310,17 @@ function ImagesMenu({
   const onDragEnd = (event) => {
     const { active, over } = event;
     if (!over || active.id === over.id) return;
-    const oldIndex = managed.findIndex((i) => i.id === active.id);
-    const newIndex = managed.findIndex((i) => i.id === over.id);
+    const activeId = String(active.id);
+    const overId = String(over.id);
+    const oldIndex = managed.findIndex((i) => i.id === activeId);
+    const newIndex = managed.findIndex((i) => i.id === overId);
     if (oldIndex < 0 || newIndex < 0) return;
     const reorderedManaged = arrayMove(managed, oldIndex, newIndex);
     const orderedIds = reorderedManaged.map((i) => i.id);
-    onItemsChange(reorderManagedImages(items, orderedIds));
+    onItemsChange(reorderManagedImages(items, orderedIds), {
+      motive: "reorder",
+      itemIds: [activeId]
+    });
   };
   return /* @__PURE__ */ jsxs(
     "section",
@@ -2349,9 +2358,22 @@ function ImagesMenu({
                 labels: resolvedLabels,
                 hiddenActionSet,
                 onFocus: onFocusItem ? () => onFocusItem(item) : void 0,
-                onCopy: () => onItemsChange(copyManagedImage(items, item.id)),
-                onRotate: () => onItemsChange(rotateManagedImage(items, item.id)),
-                onDelete: () => onItemsChange(deleteManagedImage(items, item.id))
+                onCopy: () => {
+                  const next = copyManagedImage(items, item.id);
+                  const addedIds = getAddedItemIds(items, next);
+                  onItemsChange(next, {
+                    motive: "duplicate",
+                    itemIds: addedIds.length > 0 ? addedIds : [item.id]
+                  });
+                },
+                onRotate: () => onItemsChange(rotateManagedImage(items, item.id), {
+                  motive: "rotate",
+                  itemIds: [item.id]
+                }),
+                onDelete: () => onItemsChange(deleteManagedImage(items, item.id), {
+                  motive: "delete",
+                  itemIds: [item.id]
+                })
               },
               item.id
             )) })
@@ -8544,6 +8566,42 @@ function didReadOnlyActivationMovePastTap(session, pointer, tapPx) {
   return Math.hypot(dx, dy) > tapPx;
 }
 
+// src/react/render-scheduler.ts
+var getDefaultAnimationFrameRuntime = () => typeof window === "undefined" ? {} : window;
+function createAnimationFrameRenderScheduler({
+  render,
+  runtime = getDefaultAnimationFrameRuntime()
+}) {
+  let frameId = null;
+  const canceledFrameIds = /* @__PURE__ */ new Set();
+  const request = () => {
+    if (frameId != null) return;
+    if (typeof runtime.requestAnimationFrame !== "function") {
+      render();
+      return;
+    }
+    const scheduledFrameId = runtime.requestAnimationFrame(() => {
+      const currentFrameId = scheduledFrameId;
+      if (canceledFrameIds.has(currentFrameId)) {
+        canceledFrameIds.delete(currentFrameId);
+        return;
+      }
+      if (frameId === currentFrameId) {
+        frameId = null;
+      }
+      render();
+    });
+    frameId = scheduledFrameId;
+  };
+  const cancel = () => {
+    if (frameId == null) return;
+    canceledFrameIds.add(frameId);
+    runtime.cancelAnimationFrame?.(frameId);
+    frameId = null;
+  };
+  return { request, cancel };
+}
+
 // src/react/stable-selection.ts
 function shallowEqualStringArray(a, b) {
   if (a === b) return true;
@@ -9556,6 +9614,9 @@ var VectorViewport = forwardRef(
     reducedMotionRef.current = reducedMotion;
     const [zoomPercent, setZoomPercent] = useState(100);
     const [cameraTick, setCameraTick] = useState(0);
+    const renderFrameSchedulerRef = useRef(
+      null
+    );
     const [placementPreview, setPlacementPreview] = useState(null);
     const [eraserTrail, setEraserTrail] = useState([]);
     const [laserTrail, setLaserTrail] = useState([]);
@@ -9936,7 +9997,7 @@ var VectorViewport = forwardRef(
         renderSceneWithLivePenStroke
       ]
     );
-    const renderFrame = useCallback(() => {
+    const renderFrameNow = useCallback(() => {
       const renderer = rendererRef.current;
       const cam = cameraRef.current;
       if (!renderer || !cam) return;
@@ -9949,6 +10010,14 @@ var VectorViewport = forwardRef(
       }
       onCameraChangeRef.current?.();
     }, []);
+    const renderFrame = useCallback(() => {
+      const scheduler = renderFrameSchedulerRef.current;
+      if (!scheduler) {
+        renderFrameNow();
+        return;
+      }
+      scheduler.request();
+    }, [renderFrameNow]);
     useEffect(() => {
       const el = sceneContainerRef.current;
       const interactionEl = interactionRootRef.current;
@@ -9967,6 +10036,9 @@ var VectorViewport = forwardRef(
         rasterImageCanvas: imageCanvasRenderingRef.current
       });
       rendererRef.current = renderer;
+      renderFrameSchedulerRef.current = createAnimationFrameRenderScheduler({
+        render: renderFrameNow
+      });
       renderer.setInteractionState({
         selectedIds: effectiveSelectedIdsRef.current,
         hoveredItemId: hoveredItemIdRef.current
@@ -10001,6 +10073,8 @@ var VectorViewport = forwardRef(
         });
       }
       return () => {
+        renderFrameSchedulerRef.current?.cancel();
+        renderFrameSchedulerRef.current = null;
         detachInput();
         detachPencil?.();
         renderer.destroy();
@@ -10009,7 +10083,7 @@ var VectorViewport = forwardRef(
         cameraRef.current = null;
         setCameraForOverlay(null);
       };
-    }, [applePencilNav, renderFrame, resolveReadOnlyActivation]);
+    }, [applePencilNav, renderFrame, renderFrameNow, resolveReadOnlyActivation]);
     useEffect(() => {
       rendererRef.current?.setInteractionState({
         selectedIds: effectiveSelectedIds,
@@ -10137,10 +10211,10 @@ var VectorViewport = forwardRef(
           livePenStrokeItemRef.current = null;
         }
         scene.setItems(resolvedSceneItems);
-        renderFrame();
+        renderFrameNow();
         renderer?.renderLiveItem(livePenStrokeItemRef.current);
       }
-    }, [resolvedSceneItems, renderFrame]);
+    }, [resolvedSceneItems, renderFrameNow]);
     useEffect(() => {
       const ids = effectiveSelectedIds;
       const valid = ids.filter((id) => items.some((i) => i.id === id));