canvu-react 0.4.65 → 0.4.67

package/dist/react.d.cts

@@ -4,8 +4,8 @@ import { I as IndexedDbImageStore } from './asset-hydration-F6aM5C7x.cjs';
 export { H as HydratedSceneItemsWithAssetsResult, h as hydrateSceneItemsWithAssets } from './asset-hydration-F6aM5C7x.cjs';
 import { V as VectorViewportAssetKind, a as VectorViewportAssetStore } from './asset-store-35ysK28r.cjs';
 export { b as VectorViewportAssetHydrationRequest, c as VectorViewportAssetResolveRequest, d as VectorViewportAssetResolveResult, e as VectorViewportAssetUploadRequest, f as VectorViewportAssetUploadResult } from './asset-store-35ysK28r.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-Bw3REwrb.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 SelectModeItemClickDetail, x as SelectModeItemClickResult, y as VectorCanvasSpacePosition, z as VectorItemsChangeInfo, A as VectorItemsChangeMotive, D as VectorSelectionInspectorProps, E as VectorViewport, F as VectorViewportHandle, G as VectorViewportProps, W as WorldPointerDownDetail, H as createCanvuPlugin, I as getBoardPositionStyle, J as useCanvuChromeContext, K as useCanvuDocumentContext, L as useCanvuPluginContext, M as useCanvuPluginContribution, N as useCanvuResolvedTools, O as useCanvuViewportContext } from './types-Bw3REwrb.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-D5d-3dvz.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-D5d-3dvz.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { CSSProperties, ReactNode, ReactElement, SVGProps } from 'react';
@@ -510,29 +510,6 @@ type CreateToolPluginOptions = VectorToolDefinition & {
  */
 declare function createToolPlugin(options: CreateToolPluginOptions): CanvasPlugin;
 
-type ShapeContextMenuProps = {
-    /** Viewport client coordinates (from `clientX` / `clientY`). */
-    x: number;
-    y: number;
-    /** When true, all selected items are locked — action is “unlock”. */
-    allSelectedLocked: boolean;
-    onClose: () => void;
-    onToggleLock: () => void;
-    onCut: () => void;
-    onCopy: () => void;
-    onBringToFront: () => void;
-    onBringForward: () => void;
-    onSendBackward: () => void;
-    onSendToBack: () => void;
-    onDuplicate: () => void;
-    onDelete: () => void;
-};
-/**
- * Floating menu for shape actions (reorder, clipboard, lock, delete).
- * Renders in a portal and closes on Escape or outside click.
- */
-declare function ShapeContextMenu({ x, y, allSelectedLocked, onClose, onToggleLock, onCut, onCopy, onBringToFront, onBringForward, onSendBackward, onSendToBack, onDuplicate, onDelete, }: ShapeContextMenuProps): react.ReactPortal | null;
-
 /**
  * Tool ids shown in the overflow menu at the end of the default toolbar (horizontal layout).
  * Order: shapes, marker, laser, image.
@@ -664,8 +641,31 @@ type VectorToolbarProps = {
     /** Controlled selection. */
     value: string;
     onChange: (toolId: string) => void;
-    /** Defaults to {@link DEFAULT_VECTOR_TOOLS}. Ignored when JSX `children` are provided. */
-    tools?: VectorToolDefinition[];
+    /**
+     * Exact base tool list for default and render-prop modes.
+     *
+     * Omit this to use plugin-resolved tools from {@link VectorViewport}, falling back to
+     * {@link DEFAULT_VECTOR_TOOLS}. JSX `children` mode ignores this and renders exactly
+     * the children you provide.
+     */
+    tools?: readonly VectorToolDefinition[];
+    /**
+     * Tool additions or replacements merged by `id` into the base list.
+     *
+     * Use this for small customizations: a matching `id` replaces the built-in or plugin tool
+     * in place, while new ids append at the end. Later contributions win. Prefer `tools`
+     * when you want to own the entire base list, and JSX `children` when you want exact markup.
+     *
+     * @example
+     * ```tsx
+     * <VectorToolbar
+     *   value={tool}
+     *   onChange={setTool}
+     *   toolContributions={[{ id: "rect", label: "Box", icon: <BoxIcon /> }]}
+     * />
+     * ```
+     */
+    toolContributions?: readonly VectorToolDefinition[];
     /**
      * Tool ids placed in the overflow menu at the end of the toolbar (horizontal) or bottom (vertical).
      * Defaults to {@link DEFAULT_OVERFLOW_TOOL_IDS}. Pass an empty array to show every tool in the main strip.
@@ -818,4 +818,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 ImagesMenuCollapsedButtonProps, type ImagesMenuCollapsedButtonRenderProps, type ImagesMenuLabels, type ImagesMenuProps, type IngestAssetFileError, type IngestAssetFilesToSceneItemsOptions, type IngestAssetFilesToSceneItemsResult, type IngestedAssetItemContext, NavMenu, type NavMenuMinimapProps, type NavMenuProps, type NavMenuUndoRedoProps, type NavMenuZoomControlsProps, ShapeContextMenu, type ShapeContextMenuProps, 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 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 };

package/dist/react.d.ts

@@ -4,8 +4,8 @@ import { I as IndexedDbImageStore } from './asset-hydration-BSjiek7Q.js';
 export { H as HydratedSceneItemsWithAssetsResult, h as hydrateSceneItemsWithAssets } from './asset-hydration-BSjiek7Q.js';
 import { V as VectorViewportAssetKind, a as VectorViewportAssetStore } from './asset-store-D_FjW_CN.js';
 export { b as VectorViewportAssetHydrationRequest, c as VectorViewportAssetResolveRequest, d as VectorViewportAssetResolveResult, e as VectorViewportAssetUploadRequest, f as VectorViewportAssetUploadResult } from './asset-store-D_FjW_CN.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-BZUp3LpC.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 SelectModeItemClickDetail, x as SelectModeItemClickResult, y as VectorCanvasSpacePosition, z as VectorItemsChangeInfo, A as VectorItemsChangeMotive, D as VectorSelectionInspectorProps, E as VectorViewport, F as VectorViewportHandle, G as VectorViewportProps, W as WorldPointerDownDetail, H as createCanvuPlugin, I as getBoardPositionStyle, J as useCanvuChromeContext, K as useCanvuDocumentContext, L as useCanvuPluginContext, M as useCanvuPluginContribution, N as useCanvuResolvedTools, O as useCanvuViewportContext } from './types-BZUp3LpC.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-B-Jdh-n6.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-B-Jdh-n6.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { CSSProperties, ReactNode, ReactElement, SVGProps } from 'react';
@@ -510,29 +510,6 @@ type CreateToolPluginOptions = VectorToolDefinition & {
  */
 declare function createToolPlugin(options: CreateToolPluginOptions): CanvasPlugin;
 
-type ShapeContextMenuProps = {
-    /** Viewport client coordinates (from `clientX` / `clientY`). */
-    x: number;
-    y: number;
-    /** When true, all selected items are locked — action is “unlock”. */
-    allSelectedLocked: boolean;
-    onClose: () => void;
-    onToggleLock: () => void;
-    onCut: () => void;
-    onCopy: () => void;
-    onBringToFront: () => void;
-    onBringForward: () => void;
-    onSendBackward: () => void;
-    onSendToBack: () => void;
-    onDuplicate: () => void;
-    onDelete: () => void;
-};
-/**
- * Floating menu for shape actions (reorder, clipboard, lock, delete).
- * Renders in a portal and closes on Escape or outside click.
- */
-declare function ShapeContextMenu({ x, y, allSelectedLocked, onClose, onToggleLock, onCut, onCopy, onBringToFront, onBringForward, onSendBackward, onSendToBack, onDuplicate, onDelete, }: ShapeContextMenuProps): react.ReactPortal | null;
-
 /**
  * Tool ids shown in the overflow menu at the end of the default toolbar (horizontal layout).
  * Order: shapes, marker, laser, image.
@@ -664,8 +641,31 @@ type VectorToolbarProps = {
     /** Controlled selection. */
     value: string;
     onChange: (toolId: string) => void;
-    /** Defaults to {@link DEFAULT_VECTOR_TOOLS}. Ignored when JSX `children` are provided. */
-    tools?: VectorToolDefinition[];
+    /**
+     * Exact base tool list for default and render-prop modes.
+     *
+     * Omit this to use plugin-resolved tools from {@link VectorViewport}, falling back to
+     * {@link DEFAULT_VECTOR_TOOLS}. JSX `children` mode ignores this and renders exactly
+     * the children you provide.
+     */
+    tools?: readonly VectorToolDefinition[];
+    /**
+     * Tool additions or replacements merged by `id` into the base list.
+     *
+     * Use this for small customizations: a matching `id` replaces the built-in or plugin tool
+     * in place, while new ids append at the end. Later contributions win. Prefer `tools`
+     * when you want to own the entire base list, and JSX `children` when you want exact markup.
+     *
+     * @example
+     * ```tsx
+     * <VectorToolbar
+     *   value={tool}
+     *   onChange={setTool}
+     *   toolContributions={[{ id: "rect", label: "Box", icon: <BoxIcon /> }]}
+     * />
+     * ```
+     */
+    toolContributions?: readonly VectorToolDefinition[];
     /**
      * Tool ids placed in the overflow menu at the end of the toolbar (horizontal) or bottom (vertical).
      * Defaults to {@link DEFAULT_OVERFLOW_TOOL_IDS}. Pass an empty array to show every tool in the main strip.
@@ -818,4 +818,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 ImagesMenuCollapsedButtonProps, type ImagesMenuCollapsedButtonRenderProps, type ImagesMenuLabels, type ImagesMenuProps, type IngestAssetFileError, type IngestAssetFilesToSceneItemsOptions, type IngestAssetFilesToSceneItemsResult, type IngestedAssetItemContext, NavMenu, type NavMenuMinimapProps, type NavMenuProps, type NavMenuUndoRedoProps, type NavMenuZoomControlsProps, ShapeContextMenu, type ShapeContextMenuProps, 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 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 };

package/dist/react.js

@@ -1,5 +1,5 @@
 import getStroke from 'perfect-freehand';
-import { createContext, forwardRef, useRef, useState, useCallback, useMemo, useId, useEffect, useImperativeHandle, useContext, useLayoutEffect, Children, isValidElement } from 'react';
+import { createContext, forwardRef, useRef, useState, useCallback, useMemo, useId, useEffect, useImperativeHandle, useContext, useLayoutEffect, Fragment as Fragment$1, Children, isValidElement } from 'react';
 import { useSensors, useSensor, PointerSensor, DndContext } from '@dnd-kit/core';
 import { SortableContext, verticalListSortingStrategy, useSortable, arrayMove } from '@dnd-kit/sortable';
 import { CSS } from '@dnd-kit/utilities';
@@ -3216,6 +3216,30 @@ function createToolPlugin(options) {
     }
   });
 }
+
+// src/react/merge-by-id.ts
+function mergeById(baseItems, ...contributions) {
+  const next = [...baseItems];
+  const indexById = /* @__PURE__ */ new Map();
+  for (const [index, item] of next.entries()) {
+    if (!indexById.has(item.id)) {
+      indexById.set(item.id, index);
+    }
+  }
+  for (const contribution of contributions) {
+    if (!contribution?.length) continue;
+    for (const item of contribution) {
+      const existingIndex = indexById.get(item.id);
+      if (existingIndex !== void 0) {
+        next[existingIndex] = item;
+        continue;
+      }
+      indexById.set(item.id, next.length);
+      next.push(item);
+    }
+  }
+  return next;
+}
 var menuStyle = {
   position: "fixed",
   zIndex: 1e4,
@@ -3245,9 +3269,97 @@ var dividerStyle = {
   margin: "4px 8px",
   background: "#e2e8f0"
 };
+var SHAPE_CONTEXT_MENU_ITEM_IDS = {
+  cut: "cut",
+  copy: "copy",
+  duplicate: "duplicate",
+  reorderDivider: "reorder-divider",
+  bringToFront: "bring-to-front",
+  bringForward: "bring-forward",
+  sendBackward: "send-backward",
+  sendToBack: "send-to-back",
+  lockDivider: "lock-divider",
+  toggleLock: "toggle-lock",
+  delete: "delete"
+};
+function renderAction(label, onClick, options) {
+  return /* @__PURE__ */ jsx(
+    "button",
+    {
+      type: "button",
+      role: "menuitem",
+      style: {
+        ...itemStyle,
+        ...options?.danger ? { color: "#b91c1c" } : {}
+      },
+      onMouseEnter: (e) => {
+        e.currentTarget.style.background = options?.danger ? "#fef2f2" : "#f1f5f9";
+      },
+      onMouseLeave: (e) => {
+        e.currentTarget.style.background = "transparent";
+      },
+      onClick,
+      children: label
+    }
+  );
+}
+function renderDivider() {
+  return /* @__PURE__ */ jsx("div", { "aria-hidden": true, style: dividerStyle });
+}
+var DEFAULT_SHAPE_CONTEXT_MENU_ITEMS = [
+  {
+    id: SHAPE_CONTEXT_MENU_ITEM_IDS.cut,
+    render: (ctx) => renderAction("Recortar", ctx.cut)
+  },
+  {
+    id: SHAPE_CONTEXT_MENU_ITEM_IDS.copy,
+    render: (ctx) => renderAction("Copiar", ctx.copy)
+  },
+  {
+    id: SHAPE_CONTEXT_MENU_ITEM_IDS.duplicate,
+    render: (ctx) => renderAction("Duplicar", ctx.duplicate)
+  },
+  {
+    id: SHAPE_CONTEXT_MENU_ITEM_IDS.reorderDivider,
+    render: renderDivider
+  },
+  {
+    id: SHAPE_CONTEXT_MENU_ITEM_IDS.bringToFront,
+    render: (ctx) => renderAction("Trazer para frente", ctx.bringToFront)
+  },
+  {
+    id: SHAPE_CONTEXT_MENU_ITEM_IDS.bringForward,
+    render: (ctx) => renderAction("Avancar uma camada", ctx.bringForward)
+  },
+  {
+    id: SHAPE_CONTEXT_MENU_ITEM_IDS.sendBackward,
+    render: (ctx) => renderAction("Recuar uma camada", ctx.sendBackward)
+  },
+  {
+    id: SHAPE_CONTEXT_MENU_ITEM_IDS.sendToBack,
+    render: (ctx) => renderAction("Enviar para tras", ctx.sendToBack)
+  },
+  {
+    id: SHAPE_CONTEXT_MENU_ITEM_IDS.lockDivider,
+    render: renderDivider
+  },
+  {
+    id: SHAPE_CONTEXT_MENU_ITEM_IDS.toggleLock,
+    render: (ctx) => renderAction(
+      ctx.allSelectedLocked ? "Desbloquear" : "Bloquear",
+      ctx.toggleLock
+    )
+  },
+  {
+    id: SHAPE_CONTEXT_MENU_ITEM_IDS.delete,
+    render: (ctx) => renderAction("Apagar", ctx.delete, { danger: true })
+  }
+];
 function ShapeContextMenu({
   x,
   y,
+  selectedIds,
+  selectedItems = [],
   allSelectedLocked,
   onClose,
   onToggleLock,
@@ -3258,7 +3370,10 @@ function ShapeContextMenu({
   onSendBackward,
   onSendToBack,
   onDuplicate,
-  onDelete
+  onDelete,
+  items,
+  itemContributions,
+  children
 }) {
   const rootRef = useRef(null);
   useLayoutEffect(() => {
@@ -3298,49 +3413,43 @@ function ShapeContextMenu({
       document.removeEventListener("pointerdown", onPointerDown, true);
     };
   }, [onClose]);
+  const menuItems = useMemo(
+    () => mergeById(items ?? DEFAULT_SHAPE_CONTEXT_MENU_ITEMS, itemContributions),
+    [itemContributions, items]
+  );
   const run = (fn) => () => {
     fn();
     onClose();
   };
-  const renderAction = (label, onClick, options) => /* @__PURE__ */ jsx(
-    "button",
-    {
-      type: "button",
-      role: "menuitem",
-      style: {
-        ...itemStyle,
-        ...options?.danger ? { color: "#b91c1c" } : {}
-      },
-      onMouseEnter: (e) => {
-        e.currentTarget.style.background = options?.danger ? "#fef2f2" : "#f1f5f9";
-      },
-      onMouseLeave: (e) => {
-        e.currentTarget.style.background = "transparent";
-      },
-      onClick: run(onClick),
-      children: label
-    }
-  );
-  const menu = /* @__PURE__ */ jsxs(
+  const resolvedSelectedIds = selectedIds ?? selectedItems.map((item) => item.id);
+  const resolvedAllSelectedLocked = allSelectedLocked ?? (selectedItems.length > 0 && selectedItems.every((item) => item.locked));
+  const menuContext = {
+    position: { x, y },
+    selectedIds: resolvedSelectedIds,
+    selectedItems,
+    allSelectedLocked: resolvedAllSelectedLocked,
+    anySelectedLocked: selectedItems.some((item) => item.locked),
+    close: onClose,
+    cut: run(onCut),
+    copy: run(onCopy),
+    duplicate: run(onDuplicate),
+    toggleLock: run(onToggleLock),
+    bringToFront: run(onBringToFront),
+    bringForward: run(onBringForward),
+    sendBackward: run(onSendBackward),
+    sendToBack: run(onSendToBack),
+    delete: run(onDelete),
+    deleteSelection: run(onDelete)
+  };
+  const content = typeof children === "function" ? children(menuContext) : children !== void 0 ? children : menuItems.map((item) => /* @__PURE__ */ jsx(Fragment$1, { children: item.render(menuContext) }, item.id));
+  const menu = /* @__PURE__ */ jsx(
     "div",
     {
       ref: rootRef,
       "data-slot": "shape-context-menu",
       style: { ...menuStyle, left: x, top: y },
       role: "menu",
-      children: [
-        renderAction("Recortar", onCut),
-        renderAction("Copiar", onCopy),
-        renderAction("Duplicar", onDuplicate),
-        /* @__PURE__ */ jsx("div", { "aria-hidden": true, style: dividerStyle }),
-        renderAction("Trazer para frente", onBringToFront),
-        renderAction("Avancar uma camada", onBringForward),
-        renderAction("Recuar uma camada", onSendBackward),
-        renderAction("Enviar para tras", onSendToBack),
-        /* @__PURE__ */ jsx("div", { "aria-hidden": true, style: dividerStyle }),
-        renderAction(allSelectedLocked ? "Desbloquear" : "Bloquear", onToggleLock),
-        renderAction("Apagar", onDelete, { danger: true })
-      ]
+      children: content
     }
   );
   if (typeof document === "undefined") {
@@ -5055,6 +5164,7 @@ function VectorToolbarComponent({
   value,
   onChange,
   tools,
+  toolContributions,
   overflowToolIds = DEFAULT_OVERFLOW_TOOL_IDS,
   overflowMenuAriaLabel = "More tools",
   "aria-label": ariaLabel = "Canvas tools",
@@ -5072,7 +5182,10 @@ function VectorToolbarComponent({
 }) {
   const pluginContext = useContext(CanvuPluginContext);
   const runtimeTools = pluginContext?.resolvedTools;
-  const resolvedTools = tools ?? runtimeTools ?? DEFAULT_VECTOR_TOOLS;
+  const resolvedTools = useMemo(
+    () => mergeById(tools ?? runtimeTools ?? DEFAULT_VECTOR_TOOLS, toolContributions),
+    [runtimeTools, toolContributions, tools]
+  );
   const { primary: primaryTools, overflow: overflowTools } = splitToolbarTools(
     resolvedTools,
     overflowToolIds
@@ -8110,18 +8223,6 @@ function isDefaultMarkerToolStyle(style) {
 function tagCustomPlacementItem(item, toolId) {
   return item.customToolId === toolId ? item : { ...item, customToolId: toolId };
 }
-function mergeToolListById(baseTools, pluginTools) {
-  const next = [...baseTools];
-  for (const tool of pluginTools) {
-    const index = next.findIndex((candidate) => candidate.id === tool.id);
-    if (index >= 0) {
-      next[index] = tool;
-      continue;
-    }
-    next.push(tool);
-  }
-  return next;
-}
 function composePluginEvent(consumerHandler, pluginHandlers) {
   const activePluginHandlers = pluginHandlers.filter(
     (handler) => handler != null
@@ -8249,6 +8350,8 @@ var VectorViewport = forwardRef(
     navMenu,
     selectionInspector,
     selectionInspectorProps,
+    contextMenu: renderContextMenu,
+    contextMenuItems: consumerContextMenuItems,
     plugins = [],
     onCameraChange: consumerOnCameraChange,
     customPlacement: consumerCustomPlacement,
@@ -8307,7 +8410,7 @@ var VectorViewport = forwardRef(
       let nextTools = [...DEFAULT_VECTOR_TOOLS];
       for (const contribution of orderedPluginContributions) {
         if (contribution.tools?.length) {
-          nextTools = mergeToolListById(nextTools, contribution.tools);
+          nextTools = mergeById(nextTools, contribution.tools);
         }
         if (contribution.toolTransform) {
           nextTools = contribution.toolTransform(nextTools);
@@ -8315,6 +8418,16 @@ var VectorViewport = forwardRef(
       }
       return nextTools;
     }, [orderedPluginContributions]);
+    const resolvedContextMenuItems = useMemo(
+      () => mergeById(
+        DEFAULT_SHAPE_CONTEXT_MENU_ITEMS,
+        ...orderedPluginContributions.map(
+          (contribution) => contribution.contextMenuItems
+        ),
+        consumerContextMenuItems
+      ),
+      [consumerContextMenuItems, orderedPluginContributions]
+    );
     const allCustomPlacements = useMemo(() => {
       const placements = [];
       if (consumerCustomPlacement) placements.push(consumerCustomPlacement);
@@ -8494,7 +8607,7 @@ var VectorViewport = forwardRef(
       isUndoingRef.current = true;
       onItemsChangeRef.current?.(next, { motive: "redo" });
     }, []);
-    const [contextMenu, setContextMenu] = useState(null);
+    const [contextMenuState, setContextMenuState] = useState(null);
     const [uncontrolledSel, setUncontrolledSel] = useState([]);
     const isSelectionControlled = onSelectionChange !== void 0;
     const controlledSelectedKey = JSON.stringify(selectedIdsProp ?? []);
@@ -9661,15 +9774,26 @@ var VectorViewport = forwardRef(
         if (!cam) return;
         const { worldX, worldY } = screenToWorld(e.clientX, e.clientY);
         const lineHitWorld = 10 / cam.zoom;
+        const cur = effectiveSelectedIdsRef.current;
         const hit = hitTestWorldPoint(resolvedItemsRef.current, worldX, worldY, {
           lineHitWorld,
           ignoreLocked: true
         });
         if (!hit) {
-          setContextMenu(null);
+          const selectedUnlockedItems = cur.map((id) => resolvedItemsRef.current.find((item) => item.id === id)).filter((item) => item != null && !item.locked);
+          if (selectedUnlockedItems.some(
+            (item) => pointInSelectedItemBounds(item, worldX, worldY)
+          )) {
+            setContextMenuState({
+              x: e.clientX,
+              y: e.clientY,
+              itemIds: [...cur]
+            });
+            return;
+          }
+          setContextMenuState(null);
           return;
         }
-        const cur = effectiveSelectedIdsRef.current;
         let nextIds;
         if (!cur.includes(hit.id)) {
           nextIds = e.shiftKey ? [...cur, hit.id] : [hit.id];
@@ -9677,7 +9801,7 @@ var VectorViewport = forwardRef(
         } else {
           nextIds = cur;
         }
-        setContextMenu({
+        setContextMenuState({
           x: e.clientX,
           y: e.clientY,
           itemIds: nextIds
@@ -10227,7 +10351,7 @@ var VectorViewport = forwardRef(
         if (e.button !== 0) return;
         if (editingTextIdRef.current) return;
         wrapperRef.current?.focus({ preventScroll: true });
-        setContextMenu(null);
+        setContextMenuState(null);
         const tool = toolIdRef.current;
         if (tool === "hand") return;
         if (applePencilNav && e.pointerType === "pen" && navigator.maxTouchPoints > 0 && (tool === "draw" || tool === "marker")) {
@@ -10647,7 +10771,7 @@ var VectorViewport = forwardRef(
           return;
         }
         wrapperRef.current?.focus({ preventScroll: true });
-        setContextMenu(null);
+        setContextMenuState(null);
         const straightLine = tool === "draw" ? createStraightStrokeState(startPoint, e.clientX, e.clientY) : void 0;
         const itemId = createShapeId();
         const item = createFreehandStrokeItem(
@@ -10770,7 +10894,7 @@ var VectorViewport = forwardRef(
           return;
         }
         wrapperRef.current?.focus({ preventScroll: true });
-        setContextMenu(null);
+        setContextMenuState(null);
         penDetectedRef.current = true;
         const straightLine = tool === "draw" ? createStraightStrokeState(startPoint, touch.clientX, touch.clientY) : void 0;
         const itemId = createShapeId();
@@ -11810,6 +11934,66 @@ var VectorViewport = forwardRef(
     const defaultNavMenu = cameraForOverlay ? /* @__PURE__ */ jsx(NavMenu, {}) : null;
     const resolvedSelectionInspector = selectionInspector === void 0 ? defaultSelectionInspector : selectionInspector;
     const resolvedNavMenu = navMenu === void 0 ? defaultNavMenu : navMenu;
+    const contextMenuItemIds = contextMenuState?.itemIds ?? [];
+    const contextMenuSelectedItems = contextMenuState ? contextMenuItemIds.map((id) => items.find((item) => item.id === id)).filter((item) => item != null) : [];
+    const allContextMenuSelectedLocked = contextMenuItemIds.length > 0 && contextMenuItemIds.every((id) => items.find((item) => item.id === id)?.locked);
+    const closeContextMenu = () => setContextMenuState(null);
+    const runContextMenuAction = (fn) => () => {
+      fn();
+      closeContextMenu();
+    };
+    const contextMenuRenderContext = contextMenuState ? {
+      position: { x: contextMenuState.x, y: contextMenuState.y },
+      selectedIds: contextMenuItemIds,
+      selectedItems: contextMenuSelectedItems,
+      allSelectedLocked: allContextMenuSelectedLocked,
+      anySelectedLocked: contextMenuSelectedItems.some((item) => item.locked),
+      close: closeContextMenu,
+      cut: runContextMenuAction(() => cutIds(contextMenuItemIds)),
+      copy: runContextMenuAction(
+        () => copyIdsToInternalClipboard(contextMenuItemIds)
+      ),
+      duplicate: runContextMenuAction(() => duplicateIds(contextMenuItemIds)),
+      toggleLock: runContextMenuAction(
+        () => setLockedOnIds(contextMenuItemIds, !allContextMenuSelectedLocked)
+      ),
+      bringToFront: runContextMenuAction(
+        () => reorderIds(contextMenuItemIds, "front")
+      ),
+      bringForward: runContextMenuAction(
+        () => reorderIds(contextMenuItemIds, "forward")
+      ),
+      sendBackward: runContextMenuAction(
+        () => reorderIds(contextMenuItemIds, "backward")
+      ),
+      sendToBack: runContextMenuAction(
+        () => reorderIds(contextMenuItemIds, "back")
+      ),
+      delete: runContextMenuAction(() => deleteIds(contextMenuItemIds)),
+      deleteSelection: runContextMenuAction(() => deleteIds(contextMenuItemIds)),
+      items: resolvedContextMenuItems
+    } : null;
+    const resolvedContextMenu = interactive && onItemsChange && contextMenuState && contextMenuRenderContext && renderContextMenu !== null ? renderContextMenu ? renderContextMenu(contextMenuRenderContext) : /* @__PURE__ */ jsx(
+      ShapeContextMenu,
+      {
+        x: contextMenuState.x,
+        y: contextMenuState.y,
+        selectedIds: contextMenuItemIds,
+        selectedItems: contextMenuSelectedItems,
+        allSelectedLocked: allContextMenuSelectedLocked,
+        items: resolvedContextMenuItems,
+        onClose: closeContextMenu,
+        onToggleLock: () => setLockedOnIds(contextMenuItemIds, !allContextMenuSelectedLocked),
+        onCut: () => cutIds(contextMenuItemIds),
+        onCopy: () => copyIdsToInternalClipboard(contextMenuItemIds),
+        onBringToFront: () => reorderIds(contextMenuItemIds, "front"),
+        onBringForward: () => reorderIds(contextMenuItemIds, "forward"),
+        onSendBackward: () => reorderIds(contextMenuItemIds, "backward"),
+        onSendToBack: () => reorderIds(contextMenuItemIds, "back"),
+        onDuplicate: () => duplicateIds(contextMenuItemIds),
+        onDelete: () => deleteIds(contextMenuItemIds)
+      }
+    ) : null;
     return /* @__PURE__ */ jsx(CanvuPluginContext.Provider, { value: pluginContextValue, children: /* @__PURE__ */ jsx(CanvuChromeContext.Provider, { value: chromeContextValue, children: /* @__PURE__ */ jsxs(
       "div",
       {
@@ -11963,30 +12147,7 @@ var VectorViewport = forwardRef(
             }
           ),
           resolvedSelectionInspector,
-          interactive && onItemsChange && contextMenu && /* @__PURE__ */ jsx(
-            ShapeContextMenu,
-            {
-              x: contextMenu.x,
-              y: contextMenu.y,
-              allSelectedLocked: contextMenu.itemIds.length > 0 && contextMenu.itemIds.every(
-                (id) => items.find((i) => i.id === id)?.locked
-              ),
-              onClose: () => setContextMenu(null),
-              onToggleLock: () => {
-                const ids = contextMenu.itemIds;
-                const allLocked = ids.length > 0 && ids.every((id) => items.find((i) => i.id === id)?.locked);
-                setLockedOnIds(ids, !allLocked);
-              },
-              onCut: () => cutIds(contextMenu.itemIds),
-              onCopy: () => copyIdsToInternalClipboard(contextMenu.itemIds),
-              onBringToFront: () => reorderIds(contextMenu.itemIds, "front"),
-              onBringForward: () => reorderIds(contextMenu.itemIds, "forward"),
-              onSendBackward: () => reorderIds(contextMenu.itemIds, "backward"),
-              onSendToBack: () => reorderIds(contextMenu.itemIds, "back"),
-              onDuplicate: () => duplicateIds(contextMenu.itemIds),
-              onDelete: () => deleteIds(contextMenu.itemIds)
-            }
-          ),
+          resolvedContextMenu,
           resolvedNavMenu,
           /* @__PURE__ */ jsx(
             "div",
@@ -12005,6 +12166,6 @@ var VectorViewport = forwardRef(
 );
 VectorViewport.displayName = "VectorViewport";
 
-export { CanvuChromeContext, CanvuPluginContext, DEFAULT_OVERFLOW_TOOL_IDS, DEFAULT_VECTOR_CANVAS_STORAGE_KEY, DEFAULT_VECTOR_TOOLS, IconArchitecturalCloud, IconArrow, IconDraw, IconEllipse, IconHand, IconImage, IconLaser, IconLine, IconRect, IconSelect, IconText, ImagesMenu, NavMenu, ShapeContextMenu, VectorCanvas, VectorCanvasBody, VectorCanvasHeader, VectorCanvasMain, VectorCanvasRoot, VectorCanvasToolbar, VectorCanvasViewportSurface, VectorSelectionInspector, VectorToolbar, VectorViewport, createCanvuPlugin, createIndexedDbPersistenceAdapter, createLocalStoragePersistenceAdapter, createNoopPersistenceAdapter, createToolPlugin, cursorForVectorToolId, getBoardPositionStyle, hydrateSceneItemsWithAssets, ingestAssetFilesToSceneItems, useCanvuChromeContext, useCanvuDocumentContext, useCanvuPluginContext, useCanvuPluginContribution, useCanvuResolvedTools, useCanvuViewportContext, useVectorCanvasDocument };
+export { CanvuChromeContext, CanvuPluginContext, DEFAULT_OVERFLOW_TOOL_IDS, DEFAULT_VECTOR_CANVAS_STORAGE_KEY, DEFAULT_VECTOR_TOOLS, IconArchitecturalCloud, IconArrow, IconDraw, IconEllipse, IconHand, IconImage, IconLaser, IconLine, IconRect, IconSelect, IconText, ImagesMenu, NavMenu, SHAPE_CONTEXT_MENU_ITEM_IDS, ShapeContextMenu, VectorCanvas, VectorCanvasBody, VectorCanvasHeader, VectorCanvasMain, VectorCanvasRoot, VectorCanvasToolbar, VectorCanvasViewportSurface, VectorSelectionInspector, VectorToolbar, VectorViewport, createCanvuPlugin, createIndexedDbPersistenceAdapter, createLocalStoragePersistenceAdapter, createNoopPersistenceAdapter, createToolPlugin, cursorForVectorToolId, getBoardPositionStyle, hydrateSceneItemsWithAssets, ingestAssetFilesToSceneItems, useCanvuChromeContext, useCanvuDocumentContext, useCanvuPluginContext, useCanvuPluginContribution, useCanvuResolvedTools, useCanvuViewportContext, useVectorCanvasDocument };
 //# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map