canvu-react 0.4.47 → 0.4.48

package/dist/{types-BUPc2Zgw.d.cts → types-6HszqSa5.d.cts}

@@ -1,4 +1,4 @@
-import { V as VectorSceneItem } from './types-BCCvY6ie.cjs';
+import { V as VectorSceneItem } from './types-fJNwEnHf.cjs';
 
 /**
  * Serializable document for persistence (localStorage, API, WebSocket).

package/dist/{types-B7xZAKVJ.d.ts → types-BAEHaIYO.d.ts}

@@ -1,10 +1,10 @@
 import * as react from 'react';
 import { CSSProperties, ReactNode, RefObject } from 'react';
-import { V as VectorSceneItem, R as Rect } from './types-BCCvY6ie.js';
-import { S as StrokeStyle, C as Camera2D } from './shape-builders-Cyh8zvDG.js';
-import { C as CanvuLinkData } from './link-item-IW4GTnxl.js';
-import { a as VectorViewportAssetStore } from './asset-store-DQPRZEcy.js';
-import { R as RemotePresencePeer, P as PresenceOverlayRenderContext } from './types-B82WiQQh.js';
+import { V as VectorSceneItem, R as Rect } from './types-fJNwEnHf.js';
+import { S as StrokeStyle, C as Camera2D } from './shape-builders-BCOAG0pS.js';
+import { C as CanvuLinkData } from './link-item-COoNNvCu.js';
+import { a as VectorViewportAssetStore } from './asset-store-D_FjW_CN.js';
+import { R as RemotePresencePeer, P as PresenceOverlayRenderContext } from './types-BMMPUak7.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 type CanvuChromeActiveToolStyle = StrokeStyle & {
@@ -157,6 +157,28 @@ type WorldPointerDownDetail = {
     toolId: string;
     pointerType: string;
 };
+type SelectModeItemClickResult = "handled" | undefined;
+type SelectModeItemClickDetail = {
+    /** The item hit by the click in select mode. */
+    item: VectorSceneItem;
+    /** World-space pointer location at release. */
+    worldX: number;
+    worldY: number;
+    /** Viewport/client pointer location at release. */
+    clientX: number;
+    clientY: number;
+    pointerType: string;
+    shiftKey: boolean;
+    altKey: boolean;
+    metaKey: boolean;
+    ctrlKey: boolean;
+    /** Current viewport items. */
+    items: readonly VectorSceneItem[];
+    /** Replace the clicked item while preserving item order. */
+    updateItem: (next: VectorSceneItem) => void;
+    /** Set the viewport selection when activation should also select or clear. */
+    setSelectedIds: (ids: readonly string[]) => void;
+};
 /**
  * Imperative API for pan/zoom and integrations (e.g. AI agents following a region).
  * Call {@link requestRender} after mutating the {@link Camera2D} from {@link getCamera}.
@@ -187,6 +209,21 @@ type CustomShapePlacementOptions = {
         id: string;
         bounds: Rect;
     }) => VectorSceneItem;
+    /**
+     * Whether the item should become selected immediately after placement.
+     *
+     * Defaults to `true` to preserve existing behavior. Set to `false` for custom
+     * tools that behave like clickable pins, buttons, or cards.
+     */
+    selectAfterCreate?: boolean;
+    /**
+     * Optional select-mode click handler for items created by this placement.
+     *
+     * If provided, a plain click on the item in select mode calls this handler instead
+     * of selecting or moving the item. Resize and rotate handles still win first, and
+     * dragging past the tap threshold falls back to normal move behavior.
+     */
+    onSelectModeItemClick?: (detail: SelectModeItemClickDetail) => SelectModeItemClickResult;
 };
 type VectorViewportProps = {
     /** Vector items to draw (SVG fragments). */
@@ -430,4 +467,4 @@ declare function useCanvuResolvedTools(): VectorToolDefinition[];
  */
 declare function useCanvuPluginContribution(pluginId: string, contribution: CanvasPluginContribution): void;
 
-export { type BoardComponentPosition as B, type CanvasPlugin as C, type PlacementPreview as P, type VectorToolDefinition as V, type WorldPointerDownDetail as W, VectorSelectionInspector as a, type CanvasPluginComponentProps as b, type CanvasPluginContribution as c, type CanvasPluginItemsChangeMiddlewareContext as d, type CanvasPluginRenderContext as e, type CanvuChromeActiveToolStyle as f, CanvuChromeContext as g, type CanvuChromeContextValue as h, type CanvuChromeSelectionStyleChange as i, CanvuPluginContext as j, type CanvuPluginContextValue as k, type CanvuPluginViewportSnapshot as l, type CustomShapePlacementOptions as m, type VectorCanvasSpacePosition as n, type VectorSelectionInspectorProps as o, VectorViewport as p, type VectorViewportHandle as q, type VectorViewportProps as r, createCanvuPlugin as s, getBoardPositionStyle as t, useCanvuChromeContext as u, useCanvuDocumentContext as v, useCanvuPluginContext as w, useCanvuPluginContribution as x, useCanvuResolvedTools as y, useCanvuViewportContext as z };
+export { useCanvuViewportContext as A, type BoardComponentPosition as B, type CustomShapePlacementOptions as C, type PlacementPreview as P, type SelectModeItemClickDetail as S, type VectorToolDefinition as V, type WorldPointerDownDetail as W, type CanvasPlugin as a, VectorSelectionInspector as b, type CanvasPluginComponentProps as c, type CanvasPluginContribution as d, type CanvasPluginItemsChangeMiddlewareContext as e, type CanvasPluginRenderContext as f, type CanvuChromeActiveToolStyle as g, CanvuChromeContext as h, type CanvuChromeContextValue as i, type CanvuChromeSelectionStyleChange as j, CanvuPluginContext as k, type CanvuPluginContextValue as l, type CanvuPluginViewportSnapshot as m, type SelectModeItemClickResult as n, type VectorCanvasSpacePosition as o, type VectorSelectionInspectorProps as p, VectorViewport as q, type VectorViewportHandle as r, type VectorViewportProps as s, createCanvuPlugin as t, getBoardPositionStyle as u, useCanvuChromeContext as v, useCanvuDocumentContext as w, useCanvuPluginContext as x, useCanvuPluginContribution as y, useCanvuResolvedTools as z };

package/dist/{types-B82WiQQh.d.ts → types-BMMPUak7.d.ts}

@@ -1,4 +1,4 @@
-import { C as Camera2D } from './shape-builders-Cyh8zvDG.js';
+import { C as Camera2D } from './shape-builders-BCOAG0pS.js';
 
 type RealtimeConnectionState = "connecting" | "connected" | "reconnecting" | "offline" | "error";
 /**

package/dist/{types-BQUbxMgz.d.cts → types-BOQLWyCw.d.cts}

@@ -1,4 +1,4 @@
-import { C as Camera2D } from './shape-builders-CKEMjivV.cjs';
+import { C as Camera2D } from './shape-builders-BmLS8CNh.cjs';
 
 type RealtimeConnectionState = "connecting" | "connected" | "reconnecting" | "offline" | "error";
 /**

package/dist/{types-CYtq9Pr9.d.ts → types-BtWbGOqh.d.ts}

@@ -1,4 +1,4 @@
-import { V as VectorSceneItem } from './types-BCCvY6ie.js';
+import { V as VectorSceneItem } from './types-fJNwEnHf.js';
 
 /**
  * Serializable document for persistence (localStorage, API, WebSocket).

package/dist/{types-BCCvY6ie.d.cts → types-fJNwEnHf.d.cts}

@@ -16,6 +16,17 @@ declare function rectsIntersect(a: Rect, b: Rect): boolean;
  */
 declare function normalizeRect(r: Rect): Rect;
 
+type ResizeHandleId = "nw" | "n" | "ne" | "e" | "se" | "s" | "sw" | "w";
+/**
+ * Resize handles exposed for a custom shape.
+ *
+ * Use `"all"` for the default 8 handles, `"corners"` for corner-only resize,
+ * or pass explicit handle ids for constrained tools such as a single southeast
+ * corner handle. An empty array hides resize dots but leaves selection and
+ * rotation available.
+ */
+type CustomShapeResizeHandles = "all" | "corners" | readonly ResizeHandleId[];
+
 /** Identifies how `childrenSvg` was produced for editing (resize, handles). */
 type VectorToolKind = "rect" | "ellipse" | "architectural-cloud" | "line" | "arrow" | "draw" | "pencil" | "brush" | "marker" | "text" | "image" | "custom";
 /** Local segment for line/arrow (relative to item `x`, `y`). */
@@ -152,8 +163,31 @@ type VectorSceneItem = {
         width: number;
         height: number;
     };
+    /**
+     * For {@link toolKind} `"custom"`: controls which resize handles are visible and active.
+     *
+     * Defaults to `"all"` when omitted. Use `"corners"` for corner-only resize, explicit ids
+     * such as `["se"]` for constrained custom tools, or an empty array to hide resize dots
+     * while keeping selection and rotation available.
+     */
+    readonly customResizeHandles?: CustomShapeResizeHandles;
+    /**
+     * Identifies the custom tool / placement that created this item.
+     *
+     * Canvu sets this automatically for items created through `customPlacement`,
+     * `customPlacements`, or `createToolPlugin(...)`. It is used to route
+     * select-mode item activation back to the tool that owns the item.
+     */
+    readonly customToolId?: string;
+    /**
+     * Optional CSS class applied to the outer SVG item `<g>`.
+     *
+     * Use this for app-level styling and animation hooks. Pair with renderer attributes such
+     * as `data-canvu-hovered="true"` for hover animations in interactive canvases.
+     */
+    readonly svgClassName?: string;
     /** Optional app/plugin metadata persisted alongside the item. */
     readonly pluginData?: Record<string, unknown>;
 };
 
-export { type ArrowEndpointBinding as A, type LineEndpointsLocal as L, type Rect as R, type VectorSceneItem as V, type ArrowBindings as a, type VectorPathPoint as b, normalizeRect as n, rectsIntersect as r };
+export { type ArrowEndpointBinding as A, type CustomShapeResizeHandles as C, type LineEndpointsLocal as L, type Rect as R, type VectorSceneItem as V, type ArrowBindings as a, type ResizeHandleId as b, type VectorPathPoint as c, normalizeRect as n, rectsIntersect as r };

package/dist/{types-BCCvY6ie.d.ts → types-fJNwEnHf.d.ts}

@@ -16,6 +16,17 @@ declare function rectsIntersect(a: Rect, b: Rect): boolean;
  */
 declare function normalizeRect(r: Rect): Rect;
 
+type ResizeHandleId = "nw" | "n" | "ne" | "e" | "se" | "s" | "sw" | "w";
+/**
+ * Resize handles exposed for a custom shape.
+ *
+ * Use `"all"` for the default 8 handles, `"corners"` for corner-only resize,
+ * or pass explicit handle ids for constrained tools such as a single southeast
+ * corner handle. An empty array hides resize dots but leaves selection and
+ * rotation available.
+ */
+type CustomShapeResizeHandles = "all" | "corners" | readonly ResizeHandleId[];
+
 /** Identifies how `childrenSvg` was produced for editing (resize, handles). */
 type VectorToolKind = "rect" | "ellipse" | "architectural-cloud" | "line" | "arrow" | "draw" | "pencil" | "brush" | "marker" | "text" | "image" | "custom";
 /** Local segment for line/arrow (relative to item `x`, `y`). */
@@ -152,8 +163,31 @@ type VectorSceneItem = {
         width: number;
         height: number;
     };
+    /**
+     * For {@link toolKind} `"custom"`: controls which resize handles are visible and active.
+     *
+     * Defaults to `"all"` when omitted. Use `"corners"` for corner-only resize, explicit ids
+     * such as `["se"]` for constrained custom tools, or an empty array to hide resize dots
+     * while keeping selection and rotation available.
+     */
+    readonly customResizeHandles?: CustomShapeResizeHandles;
+    /**
+     * Identifies the custom tool / placement that created this item.
+     *
+     * Canvu sets this automatically for items created through `customPlacement`,
+     * `customPlacements`, or `createToolPlugin(...)`. It is used to route
+     * select-mode item activation back to the tool that owns the item.
+     */
+    readonly customToolId?: string;
+    /**
+     * Optional CSS class applied to the outer SVG item `<g>`.
+     *
+     * Use this for app-level styling and animation hooks. Pair with renderer attributes such
+     * as `data-canvu-hovered="true"` for hover animations in interactive canvases.
+     */
+    readonly svgClassName?: string;
     /** Optional app/plugin metadata persisted alongside the item. */
     readonly pluginData?: Record<string, unknown>;
 };
 
-export { type ArrowEndpointBinding as A, type LineEndpointsLocal as L, type Rect as R, type VectorSceneItem as V, type ArrowBindings as a, type VectorPathPoint as b, normalizeRect as n, rectsIntersect as r };
+export { type ArrowEndpointBinding as A, type CustomShapeResizeHandles as C, type LineEndpointsLocal as L, type Rect as R, type VectorSceneItem as V, type ArrowBindings as a, type ResizeHandleId as b, type VectorPathPoint as c, normalizeRect as n, rectsIntersect as r };

package/dist/{types-C4wI3Jyc.d.cts → types-uzeExFkd.d.cts}

@@ -1,10 +1,10 @@
 import * as react from 'react';
 import { CSSProperties, ReactNode, RefObject } from 'react';
-import { V as VectorSceneItem, R as Rect } from './types-BCCvY6ie.cjs';
-import { S as StrokeStyle, C as Camera2D } from './shape-builders-CKEMjivV.cjs';
-import { C as CanvuLinkData } from './link-item-DwzXOwU5.cjs';
-import { a as VectorViewportAssetStore } from './asset-store-TzOPvlgn.cjs';
-import { R as RemotePresencePeer, P as PresenceOverlayRenderContext } from './types-BQUbxMgz.cjs';
+import { V as VectorSceneItem, R as Rect } from './types-fJNwEnHf.cjs';
+import { S as StrokeStyle, C as Camera2D } from './shape-builders-BmLS8CNh.cjs';
+import { C as CanvuLinkData } from './link-item-BMV3VUCr.cjs';
+import { a as VectorViewportAssetStore } from './asset-store-35ysK28r.cjs';
+import { R as RemotePresencePeer, P as PresenceOverlayRenderContext } from './types-BOQLWyCw.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 type CanvuChromeActiveToolStyle = StrokeStyle & {
@@ -157,6 +157,28 @@ type WorldPointerDownDetail = {
     toolId: string;
     pointerType: string;
 };
+type SelectModeItemClickResult = "handled" | undefined;
+type SelectModeItemClickDetail = {
+    /** The item hit by the click in select mode. */
+    item: VectorSceneItem;
+    /** World-space pointer location at release. */
+    worldX: number;
+    worldY: number;
+    /** Viewport/client pointer location at release. */
+    clientX: number;
+    clientY: number;
+    pointerType: string;
+    shiftKey: boolean;
+    altKey: boolean;
+    metaKey: boolean;
+    ctrlKey: boolean;
+    /** Current viewport items. */
+    items: readonly VectorSceneItem[];
+    /** Replace the clicked item while preserving item order. */
+    updateItem: (next: VectorSceneItem) => void;
+    /** Set the viewport selection when activation should also select or clear. */
+    setSelectedIds: (ids: readonly string[]) => void;
+};
 /**
  * Imperative API for pan/zoom and integrations (e.g. AI agents following a region).
  * Call {@link requestRender} after mutating the {@link Camera2D} from {@link getCamera}.
@@ -187,6 +209,21 @@ type CustomShapePlacementOptions = {
         id: string;
         bounds: Rect;
     }) => VectorSceneItem;
+    /**
+     * Whether the item should become selected immediately after placement.
+     *
+     * Defaults to `true` to preserve existing behavior. Set to `false` for custom
+     * tools that behave like clickable pins, buttons, or cards.
+     */
+    selectAfterCreate?: boolean;
+    /**
+     * Optional select-mode click handler for items created by this placement.
+     *
+     * If provided, a plain click on the item in select mode calls this handler instead
+     * of selecting or moving the item. Resize and rotate handles still win first, and
+     * dragging past the tap threshold falls back to normal move behavior.
+     */
+    onSelectModeItemClick?: (detail: SelectModeItemClickDetail) => SelectModeItemClickResult;
 };
 type VectorViewportProps = {
     /** Vector items to draw (SVG fragments). */
@@ -430,4 +467,4 @@ declare function useCanvuResolvedTools(): VectorToolDefinition[];
  */
 declare function useCanvuPluginContribution(pluginId: string, contribution: CanvasPluginContribution): void;
 
-export { type BoardComponentPosition as B, type CanvasPlugin as C, type PlacementPreview as P, type VectorToolDefinition as V, type WorldPointerDownDetail as W, VectorSelectionInspector as a, type CanvasPluginComponentProps as b, type CanvasPluginContribution as c, type CanvasPluginItemsChangeMiddlewareContext as d, type CanvasPluginRenderContext as e, type CanvuChromeActiveToolStyle as f, CanvuChromeContext as g, type CanvuChromeContextValue as h, type CanvuChromeSelectionStyleChange as i, CanvuPluginContext as j, type CanvuPluginContextValue as k, type CanvuPluginViewportSnapshot as l, type CustomShapePlacementOptions as m, type VectorCanvasSpacePosition as n, type VectorSelectionInspectorProps as o, VectorViewport as p, type VectorViewportHandle as q, type VectorViewportProps as r, createCanvuPlugin as s, getBoardPositionStyle as t, useCanvuChromeContext as u, useCanvuDocumentContext as v, useCanvuPluginContext as w, useCanvuPluginContribution as x, useCanvuResolvedTools as y, useCanvuViewportContext as z };
+export { useCanvuViewportContext as A, type BoardComponentPosition as B, type CustomShapePlacementOptions as C, type PlacementPreview as P, type SelectModeItemClickDetail as S, type VectorToolDefinition as V, type WorldPointerDownDetail as W, type CanvasPlugin as a, VectorSelectionInspector as b, type CanvasPluginComponentProps as c, type CanvasPluginContribution as d, type CanvasPluginItemsChangeMiddlewareContext as e, type CanvasPluginRenderContext as f, type CanvuChromeActiveToolStyle as g, CanvuChromeContext as h, type CanvuChromeContextValue as i, type CanvuChromeSelectionStyleChange as j, CanvuPluginContext as k, type CanvuPluginContextValue as l, type CanvuPluginViewportSnapshot as m, type SelectModeItemClickResult as n, type VectorCanvasSpacePosition as o, type VectorSelectionInspectorProps as p, VectorViewport as q, type VectorViewportHandle as r, type VectorViewportProps as s, createCanvuPlugin as t, getBoardPositionStyle as u, useCanvuChromeContext as v, useCanvuDocumentContext as w, useCanvuPluginContext as x, useCanvuPluginContribution as y, useCanvuResolvedTools as z };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "canvu-react",
-	"version": "0.4.47",
+	"version": "0.4.48",
 	"description": "Vector-first infinite canvas (SVG) with pan, zoom, React bindings, and optional plugins",
 	"license": "MIT",
 	"type": "module",