canvu-react 0.4.64 → 0.4.65

package/dist/realtime.d.cts

@@ -1,4 +1,4 @@
-import { P as PlacementPreview, E as VectorViewportProps, D as VectorViewportHandle, V as VectorToolDefinition, x as VectorItemsChangeInfo, c as CanvasPlugin, h as CanvasPluginRenderContext } from './types-Ce4-OZbd.cjs';
+import { P as PlacementPreview, G as VectorViewportProps, F as VectorViewportHandle, V as VectorToolDefinition, z as VectorItemsChangeInfo, c as CanvasPlugin, h as CanvasPluginRenderContext } from './types-Bw3REwrb.cjs';
 import { a as RemotePresenceMarkupStroke, R as RemotePresencePeer, b as RemotePresenceCamera, c as RealtimeConnectionState } from './types-DqsqQQVf.cjs';
 export { P as PresenceOverlayRenderContext } from './types-DqsqQQVf.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';

package/dist/realtime.d.ts

@@ -1,4 +1,4 @@
-import { P as PlacementPreview, E as VectorViewportProps, D as VectorViewportHandle, V as VectorToolDefinition, x as VectorItemsChangeInfo, c as CanvasPlugin, h as CanvasPluginRenderContext } from './types-PsLgDGZT.js';
+import { P as PlacementPreview, G as VectorViewportProps, F as VectorViewportHandle, V as VectorToolDefinition, z as VectorItemsChangeInfo, c as CanvasPlugin, h as CanvasPluginRenderContext } from './types-BZUp3LpC.js';
 import { a as RemotePresenceMarkupStroke, R as RemotePresencePeer, b as RemotePresenceCamera, c as RealtimeConnectionState } from './types-BXa2CIrc.js';
 export { P as PresenceOverlayRenderContext } from './types-BXa2CIrc.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';

package/dist/{types-PsLgDGZT.d.ts → types-BZUp3LpC.d.ts}

@@ -118,6 +118,36 @@ type VectorToolDefinition = {
     ariaLabel?: string;
 };
 
+type ReadOnlyItemClickCandidateDetail = {
+    /** The item Canvu hit-tested under the read-only click. */
+    item: VectorSceneItem;
+    /** World-space pointer location at press time. */
+    worldX: number;
+    worldY: number;
+    /** Viewport/client pointer location at press time. */
+    clientX: number;
+    clientY: number;
+    pointerType: string;
+    shiftKey: boolean;
+    altKey: boolean;
+    metaKey: boolean;
+    ctrlKey: boolean;
+    /** Current viewport items. */
+    items: readonly VectorSceneItem[];
+    /** Selection snapshot before read-only activation handles the click. */
+    selectedIds: readonly string[];
+};
+/**
+ * Controls which items may receive select-mode click activation while
+ * `VectorViewport` is read-only (`interactive={false}`).
+ *
+ * `"custom"` keeps the default high-level behavior: custom placement/tool
+ * items with `onSelectModeItemClick` remain clickable, while regular items do
+ * not become selectable unless the app opts in. Use `"all"` or a predicate for
+ * read-only viewers that still need item selection or item-specific side effects.
+ */
+type ReadOnlyItemClickScope = "custom" | "all" | ((detail: ReadOnlyItemClickCandidateDetail) => boolean);
+
 type ActiveToolStyle = StrokeStyle & {
     toolKind: "draw" | "marker" | "text" | "rect" | "ellipse" | "architectural-cloud" | "line" | "arrow";
     label?: string;
@@ -179,6 +209,47 @@ type SelectModeItemClickDetail = {
     /** Set the viewport selection when activation should also select or clear. */
     setSelectedIds: (ids: readonly string[]) => void;
 };
+
+/**
+ * Read-only interaction exceptions for viewers that should stay immutable while
+ * still allowing explicit activation/selection clicks.
+ *
+ * Canvu-owned editing remains disabled: no placement, draw, move, resize,
+ * rotate, eraser, paste/drop mutation, text editing, handles, or inspector.
+ * Explicit user callbacks may still call `updateItem` when that is the desired
+ * app-level exception.
+ *
+ * @example
+ * ```tsx
+ * <VectorViewport
+ *   interactive={false}
+ *   readOnlyInteraction={{
+ *     itemClicks: "all",
+ *     onItemClick: ({ item, setSelectedIds }) => {
+ *       setSelectedIds([item.id]);
+ *       return "handled";
+ *     },
+ *   }}
+ * />
+ * ```
+ */
+type ReadOnlyInteractionOptions = {
+    /**
+     * Which read-only item clicks Canvu should capture.
+     *
+     * Defaults to `"custom"`, which only activates custom placement/tool items
+     * that provide `onSelectModeItemClick`.
+     */
+    itemClicks?: ReadOnlyItemClickScope;
+    /**
+     * Optional handler for read-only item clicks enabled by `itemClicks`.
+     *
+     * Custom placement `onSelectModeItemClick` handlers run first for their own
+     * items. For non-custom opt-in clicks, returning `undefined` lets Canvu apply
+     * default read-only selection semantics.
+     */
+    onItemClick?: (detail: SelectModeItemClickDetail) => SelectModeItemClickResult;
+};
 /**
  * Best-effort reason attached to a React viewport item change.
  *
@@ -338,8 +409,10 @@ type CustomShapePlacementOptions = {
      * 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.
+     * of selecting or moving the item. Resize and rotate handles still win first in
+     * interactive viewports, and dragging past the tap threshold falls back to normal
+     * move behavior. In read-only viewports, the same click still activates the item
+     * by default, while dragging past the tap threshold cancels activation.
      */
     onSelectModeItemClick?: (detail: SelectModeItemClickDetail) => SelectModeItemClickResult;
 };
@@ -361,6 +434,15 @@ type VectorViewportProps = {
      * Requires `onItemsChange` to persist mutations.
      */
     interactive?: boolean;
+    /**
+     * Read-only click exceptions used when `interactive` is false.
+     *
+     * By default, read-only viewports still allow custom placement/tool items
+     * with `onSelectModeItemClick` to activate. Opt into `"all"` or a predicate
+     * when a read-only viewer should also allow regular item selection/clicks.
+     * Canvu-owned editing stays disabled; only explicit callbacks may mutate.
+     */
+    readOnlyInteraction?: ReadOnlyInteractionOptions;
     /** Selected item ids (order preserved). Empty = none. */
     selectedIds?: readonly string[];
     onSelectionChange?: (ids: string[]) => void;
@@ -624,4 +706,4 @@ declare function useCanvuResolvedTools(): VectorToolDefinition[];
  */
 declare function useCanvuPluginContribution(pluginId: string, contribution: CanvasPluginContribution): void;
 
-export { VectorViewport as A, type BoardComponentPosition as B, type CustomShapePlacementOptions as C, type VectorViewportHandle as D, type VectorViewportProps as E, createCanvuPlugin as F, getBoardPositionStyle as G, useCanvuChromeContext as H, useCanvuDocumentContext as I, useCanvuPluginContext as J, useCanvuPluginContribution as K, useCanvuResolvedTools as L, useCanvuViewportContext as M, type PlacementPreview as P, type SelectModeItemClickDetail as S, type VectorToolDefinition as V, type WorldPointerDownDetail as W, type CanvuBeforeInteractionHook as a, type CanvuAfterInteractionHook as b, type CanvasPlugin as c, VectorSelectionInspector as d, type CanvasPluginComponentProps as e, type CanvasPluginContribution as f, type CanvasPluginItemsChangeMiddlewareContext as g, type CanvasPluginRenderContext as h, type CanvuAfterInteractionDetail as i, type CanvuBeforeInteractionResult as j, type CanvuChromeActiveToolStyle as k, CanvuChromeContext as l, type CanvuChromeContextValue as m, type CanvuChromeSelectionStyleChange as n, type CanvuInteractionDetail as o, type CanvuInteractionKind as p, type CanvuInteractionOutcome as q, type CanvuInteractionPoint as r, CanvuPluginContext as s, type CanvuPluginContextValue as t, type CanvuPluginViewportSnapshot as u, type SelectModeItemClickResult as v, type VectorCanvasSpacePosition as w, type VectorItemsChangeInfo as x, type VectorItemsChangeMotive as y, type VectorSelectionInspectorProps as z };
+export { type VectorItemsChangeMotive as A, type BoardComponentPosition as B, type CustomShapePlacementOptions as C, type VectorSelectionInspectorProps as D, VectorViewport as E, type VectorViewportHandle as F, type VectorViewportProps as G, createCanvuPlugin as H, getBoardPositionStyle as I, useCanvuChromeContext as J, useCanvuDocumentContext as K, useCanvuPluginContext as L, useCanvuPluginContribution as M, useCanvuResolvedTools as N, useCanvuViewportContext as O, type PlacementPreview as P, type ReadOnlyInteractionOptions as R, type SelectModeItemClickDetail as S, type VectorToolDefinition as V, type WorldPointerDownDetail as W, type CanvuBeforeInteractionHook as a, type CanvuAfterInteractionHook as b, type CanvasPlugin as c, VectorSelectionInspector as d, type CanvasPluginComponentProps as e, type CanvasPluginContribution as f, type CanvasPluginItemsChangeMiddlewareContext as g, type CanvasPluginRenderContext as h, type CanvuAfterInteractionDetail as i, type CanvuBeforeInteractionResult as j, type CanvuChromeActiveToolStyle as k, CanvuChromeContext as l, type CanvuChromeContextValue as m, type CanvuChromeSelectionStyleChange as n, type CanvuInteractionDetail as o, type CanvuInteractionKind as p, type CanvuInteractionOutcome as q, type CanvuInteractionPoint as r, CanvuPluginContext as s, type CanvuPluginContextValue as t, type CanvuPluginViewportSnapshot as u, type ReadOnlyItemClickCandidateDetail as v, type ReadOnlyItemClickScope as w, type SelectModeItemClickResult as x, type VectorCanvasSpacePosition as y, type VectorItemsChangeInfo as z };

package/dist/{types-Ce4-OZbd.d.cts → types-Bw3REwrb.d.cts}

@@ -118,6 +118,36 @@ type VectorToolDefinition = {
     ariaLabel?: string;
 };
 
+type ReadOnlyItemClickCandidateDetail = {
+    /** The item Canvu hit-tested under the read-only click. */
+    item: VectorSceneItem;
+    /** World-space pointer location at press time. */
+    worldX: number;
+    worldY: number;
+    /** Viewport/client pointer location at press time. */
+    clientX: number;
+    clientY: number;
+    pointerType: string;
+    shiftKey: boolean;
+    altKey: boolean;
+    metaKey: boolean;
+    ctrlKey: boolean;
+    /** Current viewport items. */
+    items: readonly VectorSceneItem[];
+    /** Selection snapshot before read-only activation handles the click. */
+    selectedIds: readonly string[];
+};
+/**
+ * Controls which items may receive select-mode click activation while
+ * `VectorViewport` is read-only (`interactive={false}`).
+ *
+ * `"custom"` keeps the default high-level behavior: custom placement/tool
+ * items with `onSelectModeItemClick` remain clickable, while regular items do
+ * not become selectable unless the app opts in. Use `"all"` or a predicate for
+ * read-only viewers that still need item selection or item-specific side effects.
+ */
+type ReadOnlyItemClickScope = "custom" | "all" | ((detail: ReadOnlyItemClickCandidateDetail) => boolean);
+
 type ActiveToolStyle = StrokeStyle & {
     toolKind: "draw" | "marker" | "text" | "rect" | "ellipse" | "architectural-cloud" | "line" | "arrow";
     label?: string;
@@ -179,6 +209,47 @@ type SelectModeItemClickDetail = {
     /** Set the viewport selection when activation should also select or clear. */
     setSelectedIds: (ids: readonly string[]) => void;
 };
+
+/**
+ * Read-only interaction exceptions for viewers that should stay immutable while
+ * still allowing explicit activation/selection clicks.
+ *
+ * Canvu-owned editing remains disabled: no placement, draw, move, resize,
+ * rotate, eraser, paste/drop mutation, text editing, handles, or inspector.
+ * Explicit user callbacks may still call `updateItem` when that is the desired
+ * app-level exception.
+ *
+ * @example
+ * ```tsx
+ * <VectorViewport
+ *   interactive={false}
+ *   readOnlyInteraction={{
+ *     itemClicks: "all",
+ *     onItemClick: ({ item, setSelectedIds }) => {
+ *       setSelectedIds([item.id]);
+ *       return "handled";
+ *     },
+ *   }}
+ * />
+ * ```
+ */
+type ReadOnlyInteractionOptions = {
+    /**
+     * Which read-only item clicks Canvu should capture.
+     *
+     * Defaults to `"custom"`, which only activates custom placement/tool items
+     * that provide `onSelectModeItemClick`.
+     */
+    itemClicks?: ReadOnlyItemClickScope;
+    /**
+     * Optional handler for read-only item clicks enabled by `itemClicks`.
+     *
+     * Custom placement `onSelectModeItemClick` handlers run first for their own
+     * items. For non-custom opt-in clicks, returning `undefined` lets Canvu apply
+     * default read-only selection semantics.
+     */
+    onItemClick?: (detail: SelectModeItemClickDetail) => SelectModeItemClickResult;
+};
 /**
  * Best-effort reason attached to a React viewport item change.
  *
@@ -338,8 +409,10 @@ type CustomShapePlacementOptions = {
      * 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.
+     * of selecting or moving the item. Resize and rotate handles still win first in
+     * interactive viewports, and dragging past the tap threshold falls back to normal
+     * move behavior. In read-only viewports, the same click still activates the item
+     * by default, while dragging past the tap threshold cancels activation.
      */
     onSelectModeItemClick?: (detail: SelectModeItemClickDetail) => SelectModeItemClickResult;
 };
@@ -361,6 +434,15 @@ type VectorViewportProps = {
      * Requires `onItemsChange` to persist mutations.
      */
     interactive?: boolean;
+    /**
+     * Read-only click exceptions used when `interactive` is false.
+     *
+     * By default, read-only viewports still allow custom placement/tool items
+     * with `onSelectModeItemClick` to activate. Opt into `"all"` or a predicate
+     * when a read-only viewer should also allow regular item selection/clicks.
+     * Canvu-owned editing stays disabled; only explicit callbacks may mutate.
+     */
+    readOnlyInteraction?: ReadOnlyInteractionOptions;
     /** Selected item ids (order preserved). Empty = none. */
     selectedIds?: readonly string[];
     onSelectionChange?: (ids: string[]) => void;
@@ -624,4 +706,4 @@ declare function useCanvuResolvedTools(): VectorToolDefinition[];
  */
 declare function useCanvuPluginContribution(pluginId: string, contribution: CanvasPluginContribution): void;
 
-export { VectorViewport as A, type BoardComponentPosition as B, type CustomShapePlacementOptions as C, type VectorViewportHandle as D, type VectorViewportProps as E, createCanvuPlugin as F, getBoardPositionStyle as G, useCanvuChromeContext as H, useCanvuDocumentContext as I, useCanvuPluginContext as J, useCanvuPluginContribution as K, useCanvuResolvedTools as L, useCanvuViewportContext as M, type PlacementPreview as P, type SelectModeItemClickDetail as S, type VectorToolDefinition as V, type WorldPointerDownDetail as W, type CanvuBeforeInteractionHook as a, type CanvuAfterInteractionHook as b, type CanvasPlugin as c, VectorSelectionInspector as d, type CanvasPluginComponentProps as e, type CanvasPluginContribution as f, type CanvasPluginItemsChangeMiddlewareContext as g, type CanvasPluginRenderContext as h, type CanvuAfterInteractionDetail as i, type CanvuBeforeInteractionResult as j, type CanvuChromeActiveToolStyle as k, CanvuChromeContext as l, type CanvuChromeContextValue as m, type CanvuChromeSelectionStyleChange as n, type CanvuInteractionDetail as o, type CanvuInteractionKind as p, type CanvuInteractionOutcome as q, type CanvuInteractionPoint as r, CanvuPluginContext as s, type CanvuPluginContextValue as t, type CanvuPluginViewportSnapshot as u, type SelectModeItemClickResult as v, type VectorCanvasSpacePosition as w, type VectorItemsChangeInfo as x, type VectorItemsChangeMotive as y, type VectorSelectionInspectorProps as z };
+export { type VectorItemsChangeMotive as A, type BoardComponentPosition as B, type CustomShapePlacementOptions as C, type VectorSelectionInspectorProps as D, VectorViewport as E, type VectorViewportHandle as F, type VectorViewportProps as G, createCanvuPlugin as H, getBoardPositionStyle as I, useCanvuChromeContext as J, useCanvuDocumentContext as K, useCanvuPluginContext as L, useCanvuPluginContribution as M, useCanvuResolvedTools as N, useCanvuViewportContext as O, type PlacementPreview as P, type ReadOnlyInteractionOptions as R, type SelectModeItemClickDetail as S, type VectorToolDefinition as V, type WorldPointerDownDetail as W, type CanvuBeforeInteractionHook as a, type CanvuAfterInteractionHook as b, type CanvasPlugin as c, VectorSelectionInspector as d, type CanvasPluginComponentProps as e, type CanvasPluginContribution as f, type CanvasPluginItemsChangeMiddlewareContext as g, type CanvasPluginRenderContext as h, type CanvuAfterInteractionDetail as i, type CanvuBeforeInteractionResult as j, type CanvuChromeActiveToolStyle as k, CanvuChromeContext as l, type CanvuChromeContextValue as m, type CanvuChromeSelectionStyleChange as n, type CanvuInteractionDetail as o, type CanvuInteractionKind as p, type CanvuInteractionOutcome as q, type CanvuInteractionPoint as r, CanvuPluginContext as s, type CanvuPluginContextValue as t, type CanvuPluginViewportSnapshot as u, type ReadOnlyItemClickCandidateDetail as v, type ReadOnlyItemClickScope as w, type SelectModeItemClickResult as x, type VectorCanvasSpacePosition as y, type VectorItemsChangeInfo as z };

package/package.json

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