canvu-react 0.3.6 → 0.3.7

package/dist/{types--ALu1mF-.d.ts → types-BCtWx3zP.d.ts}

@@ -1,7 +1,46 @@
 import * as react from 'react';
-import { ReactNode, RefObject } from 'react';
-import { R as Rect, V as VectorSceneItem } from './types-CB0TZZuk.js';
+import { CSSProperties, ReactNode, RefObject } from 'react';
+import { V as VectorSceneItem, R as Rect } from './types-CB0TZZuk.js';
 import { C as Camera2D } from './camera-KwCYYPhm.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { S as StrokeStyle } from './shape-builders-DTYvub8W.js';
+
+type CanvuChromeActiveToolStyle = StrokeStyle & {
+    toolKind: "draw" | "marker";
+    label?: string;
+};
+type CanvuChromeSelectionStyleChange = (patch: {
+    stroke: string;
+    strokeWidth: number;
+    strokeOpacity?: number;
+}) => void;
+/**
+ * Runtime data and handlers shared with floating board chrome (e.g. {@link NavMenu},
+ * {@link VectorSelectionInspector}). Populated by `VectorViewport` and consumed via
+ * {@link useCanvuChromeContext}.
+ */
+type CanvuChromeContextValue = {
+    camera: Camera2D | null;
+    viewportWidth: number;
+    viewportHeight: number;
+    items: readonly VectorSceneItem[];
+    selectedItems: readonly VectorSceneItem[];
+    interactive: boolean;
+    canEditSelection: boolean;
+    activeToolStyle: CanvuChromeActiveToolStyle | null;
+    onSelectionStyleChange: CanvuChromeSelectionStyleChange | null;
+    zoomPercent: number;
+    onZoomIn: () => void;
+    onZoomOut: () => void;
+    onUndo: () => void;
+    onRedo: () => void;
+    canUndo: boolean;
+    canRedo: boolean;
+    onRequestRender: () => void;
+};
+declare const CanvuChromeContext: react.Context<CanvuChromeContextValue | null>;
+/** Returns the current chrome context or `null` when used outside `VectorViewport`. */
+declare function useCanvuChromeContext(): CanvuChromeContextValue | null;
 
 type PlacementPreview = {
     kind: "rect" | "ellipse";
@@ -30,6 +69,180 @@ type PlacementPreview = {
     }[];
 };
 
+type ActiveToolStyle = StrokeStyle & {
+    toolKind: "draw" | "marker";
+    label?: string;
+};
+/**
+ * Color + stroke-width inspector for the current selection (or active drawing tool style).
+ * When rendered inside `VectorViewport` (e.g. via the `selectionInspector` slot), `items`,
+ * `activeToolStyle`, and `onChange` default to values from {@link CanvuChromeContext};
+ * pass any prop to override.
+ */
+type VectorSelectionInspectorProps = {
+    /** Selected items that support stroke/fill styling (caller may filter). */
+    items?: readonly VectorSceneItem[];
+    /** Optional active tool style shown even without a selection. */
+    activeToolStyle?: ActiveToolStyle | null;
+    /** Apply stroke / width / opacity to every item in `items`. */
+    onChange?: CanvuChromeSelectionStyleChange;
+    /** Anchor preset. Defaults to top-left. */
+    position?: BoardComponentPosition;
+    /** Distance (px) from anchored edges. @default 12 */
+    inset?: number;
+    /** @default 24 */
+    zIndex?: number;
+    className?: string;
+    /** Merged on top of position-derived styles for custom tweaks. */
+    style?: CSSProperties;
+};
+/**
+ * Color + stroke width for the current selection. Supports multiple selected shapes: one change applies to all.
+ */
+declare function VectorSelectionInspector({ items: itemsProp, activeToolStyle: activeToolStyleProp, onChange: onChangeProp, position, inset, zIndex, className, style, }: VectorSelectionInspectorProps): react_jsx_runtime.JSX.Element | null;
+
+type VectorCanvasSlotProps = {
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+};
+/**
+ * Anchor presets for floating board components.
+ *
+ * Names are `<edge>-<position-along-edge>`:
+ * - `top-*` / `bottom-*` anchor to the top or bottom edge.
+ * - `left-*` / `right-*` anchor to the left or right edge.
+ *
+ * Corner aliases are equivalent (e.g. `top-left` and `left-top` resolve to the same anchor),
+ * but kept distinct so callers can pick whichever reads best in their layout (a vertical
+ * strip might prefer `left-top`; a horizontal strip prefers `top-left`).
+ */
+type BoardComponentPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right" | "left-top" | "left-center" | "left-bottom" | "right-top" | "right-center" | "right-bottom" | "center" | "fill";
+/** @deprecated Use {@link BoardComponentPosition}. */
+type VectorCanvasSpacePosition = BoardComponentPosition;
+/**
+ * Compute absolute-position CSS for a board component anchor preset.
+ * Returns `position`, `zIndex`, and the relevant edge offsets / transforms.
+ * Callers merge the result with their own style/className overrides.
+ */
+declare function getBoardPositionStyle(position: BoardComponentPosition, inset?: number, zIndex?: number): CSSProperties;
+type VectorCanvasSpaceProps = VectorCanvasSlotProps & {
+    position?: BoardComponentPosition;
+    /** @default 12 */
+    inset?: number;
+    /** @default 40 */
+    zIndex?: number;
+    /** Pointer events value on the content wrapper. @default "auto" */
+    contentPointerEvents?: CSSProperties["pointerEvents"];
+};
+/**
+ * Full-viewport column shell for a vector canvas (header + body with stage).
+ * Use with {@link VectorCanvasBody}, {@link VectorCanvasMain}. Pass `toolbar` on {@link VectorViewport};
+ * Compose the floating tool strip with {@link VectorCanvasToolbar} around {@link VectorToolbar} (see example below).
+ */
+declare function VectorCanvasRoot({ children, className, style, }: VectorCanvasSlotProps): react_jsx_runtime.JSX.Element;
+/** Optional top chrome (title, hints, toggles). */
+declare function VectorCanvasHeader({ children, className, style, }: VectorCanvasSlotProps): react_jsx_runtime.JSX.Element;
+/** Fills remaining space below the header (typically one {@link VectorCanvasMain}). */
+declare function VectorCanvasBody({ children, className, style, }: VectorCanvasSlotProps): react_jsx_runtime.JSX.Element;
+/**
+ * Stretch area for {@link VectorViewport} (or any child that should fill the stage).
+ */
+declare function VectorCanvasMain({ children, className, style, }: VectorCanvasSlotProps): react_jsx_runtime.JSX.Element;
+/**
+ * Flex child that fills {@link VectorCanvasMain} and gives {@link VectorViewport} a bounded height
+ * (white surface by default). Omit if you set the background on `Main` or the viewport yourself.
+ */
+declare function VectorCanvasViewportSurface({ children, className, style, }: VectorCanvasSlotProps): react_jsx_runtime.JSX.Element;
+type VectorCanvasToolbarProps = {
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+    /** Anchor preset. @default "bottom-center" */
+    position?: BoardComponentPosition;
+    /** Distance (px) from the anchored edge(s). @default 12 */
+    inset?: number;
+    /** @default 30 */
+    zIndex?: number;
+};
+/**
+ * Floating strip anchor for {@link VectorToolbar} or custom controls. Defaults to bottom-center.
+ * Renders `pointer-events: none` on the shell and `auto` on children so the canvas keeps receiving hits outside the bar.
+ * Pass as the `toolbar` prop of `VectorViewport`; pick a different `position` for top / side anchoring.
+ * Z-index defaults to 30 so the strip stays above zoom controls.
+ */
+declare function VectorCanvasToolbar({ children, className, style, position, inset, zIndex, }: VectorCanvasToolbarProps): react_jsx_runtime.JSX.Element;
+/**
+ * Absolute canvas-aligned space for floating UI such as chats, rosters, inspectors, and overlays.
+ * Use this instead of ad-hoc wrapper divs or plugin hosts when a feature can be expressed as React nodes.
+ */
+declare function VectorCanvasSpace({ children, className, style, position, inset, zIndex, contentPointerEvents, }: VectorCanvasSpaceProps): react_jsx_runtime.JSX.Element;
+/**
+ * Namespaced layout primitives for composing a vector canvas shell without ad-hoc wrapper divs.
+ *
+ * @example
+ * ```tsx
+ * <VectorCanvas.Root>
+ *   <VectorCanvas.Header>…</VectorCanvas.Header>
+ *   <VectorCanvas.Body>
+ *     <VectorCanvas.Main>
+ *       <VectorCanvas.ViewportSurface>
+ *         <VectorViewport
+ *           toolbar={
+ *             <VectorCanvas.Toolbar>
+ *               <VectorToolbar … />
+ *             </VectorCanvas.Toolbar>
+ *           }
+ *           …
+ *         />
+ *       </VectorCanvas.ViewportSurface>
+ *     </VectorCanvas.Main>
+ *   </VectorCanvas.Body>
+ * </VectorCanvas.Root>
+ * ```
+ */
+declare const VectorCanvas: {
+    readonly Root: typeof VectorCanvasRoot;
+    readonly Header: typeof VectorCanvasHeader;
+    readonly Body: typeof VectorCanvasBody;
+    readonly Main: typeof VectorCanvasMain;
+    readonly ViewportSurface: typeof VectorCanvasViewportSurface;
+    readonly Toolbar: typeof VectorCanvasToolbar;
+    readonly Space: typeof VectorCanvasSpace;
+    readonly NavMenu: typeof NavMenu;
+    readonly SelectionInspector: typeof VectorSelectionInspector;
+};
+
+/**
+ * Floating bottom-bar combining zoom controls, undo/redo, and an expandable minimap.
+ * When rendered inside `VectorViewport` (e.g. via the `navMenu` slot), data props default
+ * to values from {@link CanvuChromeContext}; pass any prop to override.
+ */
+type NavMenuProps = {
+    camera?: Camera2D;
+    viewportWidth?: number;
+    viewportHeight?: number;
+    items?: readonly VectorSceneItem[];
+    zoomPercent?: number;
+    onZoomIn?: () => void;
+    onZoomOut?: () => void;
+    onUndo?: () => void;
+    onRedo?: () => void;
+    canUndo?: boolean;
+    canRedo?: boolean;
+    onRequestRender?: () => void;
+    /** Anchor preset. Defaults to bottom-left. */
+    position?: BoardComponentPosition;
+    /** Distance (px) from anchored edges. @default 12 */
+    inset?: number;
+    /** @default 23 */
+    zIndex?: number;
+    className?: string;
+    /** Merged on top of position-derived styles for custom tweaks. */
+    style?: CSSProperties;
+};
+declare function NavMenu({ camera: cameraProp, viewportWidth: viewportWidthProp, viewportHeight: viewportHeightProp, items: itemsProp, zoomPercent: zoomPercentProp, onZoomIn: onZoomInProp, onZoomOut: onZoomOutProp, onUndo: onUndoProp, onRedo: onRedoProp, canUndo: canUndoProp, canRedo: canRedoProp, onRequestRender: onRequestRenderProp, position, inset, zIndex, className, style, }: NavMenuProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Describes one entry in {@link VectorToolbar}.
  */
@@ -182,6 +395,12 @@ type VectorViewportProps = {
      * Pass `<VectorCanvas.SelectionInspector position="..." />` to relocate or style it. Pass `null` to hide it.
      */
     selectionInspector?: ReactNode | null;
+    /**
+     * Props forwarded to the built-in {@link VectorSelectionInspector}.
+     *
+     * Use this to reposition or theme the default left-side style panel without replacing it.
+     */
+    selectionInspectorProps?: Pick<VectorSelectionInspectorProps, "className" | "style">;
     /**
      * Plug and play board extensions.
      *
@@ -271,7 +490,7 @@ type CanvasPluginContribution = {
     /** Simple viewport prop overrides owned by the plugin runtime. */
     viewportProps?: Partial<Pick<VectorViewportProps, "remotePresence" | "presenceOverlay">>;
     /** Event callbacks chained into the viewport without manual wiring in app code. */
-    callbacks?: Partial<Pick<VectorViewportProps, "onWorldPointerMove" | "onWorldPointerLeave" | "onPlacementPreviewChange" | "onCameraChange">>;
+    callbacks?: Partial<Pick<VectorViewportProps, "onWorldPointerDown" | "onWorldPointerMove" | "onWorldPointerLeave" | "onPlacementPreviewChange" | "onCameraChange">>;
     /** Middleware around `onItemsChange` for collaboration, comments, persistence, etc. */
     wrapOnItemsChange?: (nextItems: VectorSceneItem[], ctx: CanvasPluginItemsChangeMiddlewareContext) => void;
 };
@@ -348,9 +567,9 @@ declare function useCanvuResolvedTools(): VectorToolDefinition[];
 /**
  * Registers non-visual plugin contributions with the current `VectorViewport` runtime.
  *
- * Use this inside `plugin.Component` when you want to inject tools, viewport behavior, or document
- * middleware without requiring the consumer to wire hooks manually.
+ * Use this inside `plugin.Component` when you want to inject tools, pointer/camera behavior, or
+ * document middleware without requiring the consumer to wire hooks manually.
  */
 declare function useCanvuPluginContribution(pluginId: string, contribution: CanvasPluginContribution): void;
 
-export { type CanvasPlugin as C, type PlacementPreview as P, type RemotePresenceMarkupStroke as R, type VectorToolDefinition as V, type WorldPointerDownDetail as W, type CanvasPluginComponentProps as a, type CanvasPluginContribution as b, type CanvasPluginItemsChangeMiddlewareContext as c, type CanvasPluginRenderContext as d, CanvuPluginContext as e, type CanvuPluginContextValue as f, type CanvuPluginViewportSnapshot as g, type CustomShapePlacementOptions as h, VectorViewport as i, type VectorViewportHandle as j, type VectorViewportProps as k, createCanvuPlugin as l, useCanvuPluginContext as m, useCanvuPluginContribution as n, useCanvuResolvedTools as o, useCanvuViewportContext as p, type RemotePresencePeer as q, type RealtimeConnectionState as r, type PresenceOverlayRenderContext as s, useCanvuDocumentContext as u };
+export { VectorViewport as A, type BoardComponentPosition as B, type CanvasPlugin 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, NavMenu as N, type RemotePresencePeer as O, type PlacementPreview as P, type RealtimeConnectionState as Q, type RemotePresenceMarkupStroke as R, type PresenceOverlayRenderContext as S, type VectorToolDefinition as V, type WorldPointerDownDetail as W, type CanvasPluginComponentProps as a, type CanvasPluginContribution as b, type CanvasPluginItemsChangeMiddlewareContext as c, type CanvasPluginRenderContext as d, type CanvuChromeActiveToolStyle as e, CanvuChromeContext as f, type CanvuChromeContextValue as g, type CanvuChromeSelectionStyleChange as h, CanvuPluginContext as i, type CanvuPluginContextValue as j, type CanvuPluginViewportSnapshot as k, type CustomShapePlacementOptions as l, type NavMenuProps as m, VectorCanvas as n, VectorCanvasBody as o, VectorCanvasHeader as p, VectorCanvasMain as q, VectorCanvasRoot as r, type VectorCanvasSlotProps as s, type VectorCanvasSpacePosition as t, type VectorCanvasSpaceProps as u, VectorCanvasToolbar as v, type VectorCanvasToolbarProps as w, VectorCanvasViewportSurface as x, VectorSelectionInspector as y, type VectorSelectionInspectorProps as z };

package/dist/{types-D1ftVsOQ.d.cts → types-B_rv7p8b.d.cts}

@@ -1,7 +1,46 @@
 import * as react from 'react';
-import { ReactNode, RefObject } from 'react';
-import { R as Rect, V as VectorSceneItem } from './types-CB0TZZuk.cjs';
+import { CSSProperties, ReactNode, RefObject } from 'react';
+import { V as VectorSceneItem, R as Rect } from './types-CB0TZZuk.cjs';
 import { C as Camera2D } from './camera-BwQjm5oh.cjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { S as StrokeStyle } from './shape-builders-DxPoOecg.cjs';
+
+type CanvuChromeActiveToolStyle = StrokeStyle & {
+    toolKind: "draw" | "marker";
+    label?: string;
+};
+type CanvuChromeSelectionStyleChange = (patch: {
+    stroke: string;
+    strokeWidth: number;
+    strokeOpacity?: number;
+}) => void;
+/**
+ * Runtime data and handlers shared with floating board chrome (e.g. {@link NavMenu},
+ * {@link VectorSelectionInspector}). Populated by `VectorViewport` and consumed via
+ * {@link useCanvuChromeContext}.
+ */
+type CanvuChromeContextValue = {
+    camera: Camera2D | null;
+    viewportWidth: number;
+    viewportHeight: number;
+    items: readonly VectorSceneItem[];
+    selectedItems: readonly VectorSceneItem[];
+    interactive: boolean;
+    canEditSelection: boolean;
+    activeToolStyle: CanvuChromeActiveToolStyle | null;
+    onSelectionStyleChange: CanvuChromeSelectionStyleChange | null;
+    zoomPercent: number;
+    onZoomIn: () => void;
+    onZoomOut: () => void;
+    onUndo: () => void;
+    onRedo: () => void;
+    canUndo: boolean;
+    canRedo: boolean;
+    onRequestRender: () => void;
+};
+declare const CanvuChromeContext: react.Context<CanvuChromeContextValue | null>;
+/** Returns the current chrome context or `null` when used outside `VectorViewport`. */
+declare function useCanvuChromeContext(): CanvuChromeContextValue | null;
 
 type PlacementPreview = {
     kind: "rect" | "ellipse";
@@ -30,6 +69,180 @@ type PlacementPreview = {
     }[];
 };
 
+type ActiveToolStyle = StrokeStyle & {
+    toolKind: "draw" | "marker";
+    label?: string;
+};
+/**
+ * Color + stroke-width inspector for the current selection (or active drawing tool style).
+ * When rendered inside `VectorViewport` (e.g. via the `selectionInspector` slot), `items`,
+ * `activeToolStyle`, and `onChange` default to values from {@link CanvuChromeContext};
+ * pass any prop to override.
+ */
+type VectorSelectionInspectorProps = {
+    /** Selected items that support stroke/fill styling (caller may filter). */
+    items?: readonly VectorSceneItem[];
+    /** Optional active tool style shown even without a selection. */
+    activeToolStyle?: ActiveToolStyle | null;
+    /** Apply stroke / width / opacity to every item in `items`. */
+    onChange?: CanvuChromeSelectionStyleChange;
+    /** Anchor preset. Defaults to top-left. */
+    position?: BoardComponentPosition;
+    /** Distance (px) from anchored edges. @default 12 */
+    inset?: number;
+    /** @default 24 */
+    zIndex?: number;
+    className?: string;
+    /** Merged on top of position-derived styles for custom tweaks. */
+    style?: CSSProperties;
+};
+/**
+ * Color + stroke width for the current selection. Supports multiple selected shapes: one change applies to all.
+ */
+declare function VectorSelectionInspector({ items: itemsProp, activeToolStyle: activeToolStyleProp, onChange: onChangeProp, position, inset, zIndex, className, style, }: VectorSelectionInspectorProps): react_jsx_runtime.JSX.Element | null;
+
+type VectorCanvasSlotProps = {
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+};
+/**
+ * Anchor presets for floating board components.
+ *
+ * Names are `<edge>-<position-along-edge>`:
+ * - `top-*` / `bottom-*` anchor to the top or bottom edge.
+ * - `left-*` / `right-*` anchor to the left or right edge.
+ *
+ * Corner aliases are equivalent (e.g. `top-left` and `left-top` resolve to the same anchor),
+ * but kept distinct so callers can pick whichever reads best in their layout (a vertical
+ * strip might prefer `left-top`; a horizontal strip prefers `top-left`).
+ */
+type BoardComponentPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right" | "left-top" | "left-center" | "left-bottom" | "right-top" | "right-center" | "right-bottom" | "center" | "fill";
+/** @deprecated Use {@link BoardComponentPosition}. */
+type VectorCanvasSpacePosition = BoardComponentPosition;
+/**
+ * Compute absolute-position CSS for a board component anchor preset.
+ * Returns `position`, `zIndex`, and the relevant edge offsets / transforms.
+ * Callers merge the result with their own style/className overrides.
+ */
+declare function getBoardPositionStyle(position: BoardComponentPosition, inset?: number, zIndex?: number): CSSProperties;
+type VectorCanvasSpaceProps = VectorCanvasSlotProps & {
+    position?: BoardComponentPosition;
+    /** @default 12 */
+    inset?: number;
+    /** @default 40 */
+    zIndex?: number;
+    /** Pointer events value on the content wrapper. @default "auto" */
+    contentPointerEvents?: CSSProperties["pointerEvents"];
+};
+/**
+ * Full-viewport column shell for a vector canvas (header + body with stage).
+ * Use with {@link VectorCanvasBody}, {@link VectorCanvasMain}. Pass `toolbar` on {@link VectorViewport};
+ * Compose the floating tool strip with {@link VectorCanvasToolbar} around {@link VectorToolbar} (see example below).
+ */
+declare function VectorCanvasRoot({ children, className, style, }: VectorCanvasSlotProps): react_jsx_runtime.JSX.Element;
+/** Optional top chrome (title, hints, toggles). */
+declare function VectorCanvasHeader({ children, className, style, }: VectorCanvasSlotProps): react_jsx_runtime.JSX.Element;
+/** Fills remaining space below the header (typically one {@link VectorCanvasMain}). */
+declare function VectorCanvasBody({ children, className, style, }: VectorCanvasSlotProps): react_jsx_runtime.JSX.Element;
+/**
+ * Stretch area for {@link VectorViewport} (or any child that should fill the stage).
+ */
+declare function VectorCanvasMain({ children, className, style, }: VectorCanvasSlotProps): react_jsx_runtime.JSX.Element;
+/**
+ * Flex child that fills {@link VectorCanvasMain} and gives {@link VectorViewport} a bounded height
+ * (white surface by default). Omit if you set the background on `Main` or the viewport yourself.
+ */
+declare function VectorCanvasViewportSurface({ children, className, style, }: VectorCanvasSlotProps): react_jsx_runtime.JSX.Element;
+type VectorCanvasToolbarProps = {
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+    /** Anchor preset. @default "bottom-center" */
+    position?: BoardComponentPosition;
+    /** Distance (px) from the anchored edge(s). @default 12 */
+    inset?: number;
+    /** @default 30 */
+    zIndex?: number;
+};
+/**
+ * Floating strip anchor for {@link VectorToolbar} or custom controls. Defaults to bottom-center.
+ * Renders `pointer-events: none` on the shell and `auto` on children so the canvas keeps receiving hits outside the bar.
+ * Pass as the `toolbar` prop of `VectorViewport`; pick a different `position` for top / side anchoring.
+ * Z-index defaults to 30 so the strip stays above zoom controls.
+ */
+declare function VectorCanvasToolbar({ children, className, style, position, inset, zIndex, }: VectorCanvasToolbarProps): react_jsx_runtime.JSX.Element;
+/**
+ * Absolute canvas-aligned space for floating UI such as chats, rosters, inspectors, and overlays.
+ * Use this instead of ad-hoc wrapper divs or plugin hosts when a feature can be expressed as React nodes.
+ */
+declare function VectorCanvasSpace({ children, className, style, position, inset, zIndex, contentPointerEvents, }: VectorCanvasSpaceProps): react_jsx_runtime.JSX.Element;
+/**
+ * Namespaced layout primitives for composing a vector canvas shell without ad-hoc wrapper divs.
+ *
+ * @example
+ * ```tsx
+ * <VectorCanvas.Root>
+ *   <VectorCanvas.Header>…</VectorCanvas.Header>
+ *   <VectorCanvas.Body>
+ *     <VectorCanvas.Main>
+ *       <VectorCanvas.ViewportSurface>
+ *         <VectorViewport
+ *           toolbar={
+ *             <VectorCanvas.Toolbar>
+ *               <VectorToolbar … />
+ *             </VectorCanvas.Toolbar>
+ *           }
+ *           …
+ *         />
+ *       </VectorCanvas.ViewportSurface>
+ *     </VectorCanvas.Main>
+ *   </VectorCanvas.Body>
+ * </VectorCanvas.Root>
+ * ```
+ */
+declare const VectorCanvas: {
+    readonly Root: typeof VectorCanvasRoot;
+    readonly Header: typeof VectorCanvasHeader;
+    readonly Body: typeof VectorCanvasBody;
+    readonly Main: typeof VectorCanvasMain;
+    readonly ViewportSurface: typeof VectorCanvasViewportSurface;
+    readonly Toolbar: typeof VectorCanvasToolbar;
+    readonly Space: typeof VectorCanvasSpace;
+    readonly NavMenu: typeof NavMenu;
+    readonly SelectionInspector: typeof VectorSelectionInspector;
+};
+
+/**
+ * Floating bottom-bar combining zoom controls, undo/redo, and an expandable minimap.
+ * When rendered inside `VectorViewport` (e.g. via the `navMenu` slot), data props default
+ * to values from {@link CanvuChromeContext}; pass any prop to override.
+ */
+type NavMenuProps = {
+    camera?: Camera2D;
+    viewportWidth?: number;
+    viewportHeight?: number;
+    items?: readonly VectorSceneItem[];
+    zoomPercent?: number;
+    onZoomIn?: () => void;
+    onZoomOut?: () => void;
+    onUndo?: () => void;
+    onRedo?: () => void;
+    canUndo?: boolean;
+    canRedo?: boolean;
+    onRequestRender?: () => void;
+    /** Anchor preset. Defaults to bottom-left. */
+    position?: BoardComponentPosition;
+    /** Distance (px) from anchored edges. @default 12 */
+    inset?: number;
+    /** @default 23 */
+    zIndex?: number;
+    className?: string;
+    /** Merged on top of position-derived styles for custom tweaks. */
+    style?: CSSProperties;
+};
+declare function NavMenu({ camera: cameraProp, viewportWidth: viewportWidthProp, viewportHeight: viewportHeightProp, items: itemsProp, zoomPercent: zoomPercentProp, onZoomIn: onZoomInProp, onZoomOut: onZoomOutProp, onUndo: onUndoProp, onRedo: onRedoProp, canUndo: canUndoProp, canRedo: canRedoProp, onRequestRender: onRequestRenderProp, position, inset, zIndex, className, style, }: NavMenuProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Describes one entry in {@link VectorToolbar}.
  */
@@ -182,6 +395,12 @@ type VectorViewportProps = {
      * Pass `<VectorCanvas.SelectionInspector position="..." />` to relocate or style it. Pass `null` to hide it.
      */
     selectionInspector?: ReactNode | null;
+    /**
+     * Props forwarded to the built-in {@link VectorSelectionInspector}.
+     *
+     * Use this to reposition or theme the default left-side style panel without replacing it.
+     */
+    selectionInspectorProps?: Pick<VectorSelectionInspectorProps, "className" | "style">;
     /**
      * Plug and play board extensions.
      *
@@ -271,7 +490,7 @@ type CanvasPluginContribution = {
     /** Simple viewport prop overrides owned by the plugin runtime. */
     viewportProps?: Partial<Pick<VectorViewportProps, "remotePresence" | "presenceOverlay">>;
     /** Event callbacks chained into the viewport without manual wiring in app code. */
-    callbacks?: Partial<Pick<VectorViewportProps, "onWorldPointerMove" | "onWorldPointerLeave" | "onPlacementPreviewChange" | "onCameraChange">>;
+    callbacks?: Partial<Pick<VectorViewportProps, "onWorldPointerDown" | "onWorldPointerMove" | "onWorldPointerLeave" | "onPlacementPreviewChange" | "onCameraChange">>;
     /** Middleware around `onItemsChange` for collaboration, comments, persistence, etc. */
     wrapOnItemsChange?: (nextItems: VectorSceneItem[], ctx: CanvasPluginItemsChangeMiddlewareContext) => void;
 };
@@ -348,9 +567,9 @@ declare function useCanvuResolvedTools(): VectorToolDefinition[];
 /**
  * Registers non-visual plugin contributions with the current `VectorViewport` runtime.
  *
- * Use this inside `plugin.Component` when you want to inject tools, viewport behavior, or document
- * middleware without requiring the consumer to wire hooks manually.
+ * Use this inside `plugin.Component` when you want to inject tools, pointer/camera behavior, or
+ * document middleware without requiring the consumer to wire hooks manually.
  */
 declare function useCanvuPluginContribution(pluginId: string, contribution: CanvasPluginContribution): void;
 
-export { type CanvasPlugin as C, type PlacementPreview as P, type RemotePresenceMarkupStroke as R, type VectorToolDefinition as V, type WorldPointerDownDetail as W, type CanvasPluginComponentProps as a, type CanvasPluginContribution as b, type CanvasPluginItemsChangeMiddlewareContext as c, type CanvasPluginRenderContext as d, CanvuPluginContext as e, type CanvuPluginContextValue as f, type CanvuPluginViewportSnapshot as g, type CustomShapePlacementOptions as h, VectorViewport as i, type VectorViewportHandle as j, type VectorViewportProps as k, createCanvuPlugin as l, useCanvuPluginContext as m, useCanvuPluginContribution as n, useCanvuResolvedTools as o, useCanvuViewportContext as p, type RemotePresencePeer as q, type RealtimeConnectionState as r, type PresenceOverlayRenderContext as s, useCanvuDocumentContext as u };
+export { VectorViewport as A, type BoardComponentPosition as B, type CanvasPlugin 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, NavMenu as N, type RemotePresencePeer as O, type PlacementPreview as P, type RealtimeConnectionState as Q, type RemotePresenceMarkupStroke as R, type PresenceOverlayRenderContext as S, type VectorToolDefinition as V, type WorldPointerDownDetail as W, type CanvasPluginComponentProps as a, type CanvasPluginContribution as b, type CanvasPluginItemsChangeMiddlewareContext as c, type CanvasPluginRenderContext as d, type CanvuChromeActiveToolStyle as e, CanvuChromeContext as f, type CanvuChromeContextValue as g, type CanvuChromeSelectionStyleChange as h, CanvuPluginContext as i, type CanvuPluginContextValue as j, type CanvuPluginViewportSnapshot as k, type CustomShapePlacementOptions as l, type NavMenuProps as m, VectorCanvas as n, VectorCanvasBody as o, VectorCanvasHeader as p, VectorCanvasMain as q, VectorCanvasRoot as r, type VectorCanvasSlotProps as s, type VectorCanvasSpacePosition as t, type VectorCanvasSpaceProps as u, VectorCanvasToolbar as v, type VectorCanvasToolbarProps as w, VectorCanvasViewportSurface as x, VectorSelectionInspector as y, type VectorSelectionInspectorProps as z };

package/package.json

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