canvu-react 0.4.5 → 0.4.7

package/dist/react.d.cts

@@ -1,14 +1,14 @@
-import { I as IndexedDbImageStore } from './asset-hydration-B7yMDQE-.cjs';
-export { H as HydratedSceneItemsWithAssetsResult, h as hydrateSceneItemsWithAssets } from './asset-hydration-B7yMDQE-.cjs';
+import { I as IndexedDbImageStore } from './asset-hydration-CWhld14A.cjs';
+export { H as HydratedSceneItemsWithAssetsResult, h as hydrateSceneItemsWithAssets } from './asset-hydration-CWhld14A.cjs';
 import { V as VectorSceneItem } from './types-BCCvY6ie.cjs';
-import { V as VectorViewportAssetKind, E as VectorViewportAssetStore } from './shape-builders-BAWu-PxX.cjs';
-export { G as VectorViewportAssetHydrationRequest, H as VectorViewportAssetResolveRequest, I as VectorViewportAssetResolveResult, J as VectorViewportAssetUploadRequest, K as VectorViewportAssetUploadResult } from './shape-builders-BAWu-PxX.cjs';
-import { B as BoardComponentPosition, V as VectorToolDefinition, C as CanvasPlugin, a as VectorSelectionInspector } from './types-BC9Xgfu6.cjs';
-export { b as CanvasPluginComponentProps, c as CanvasPluginContribution, d as CanvasPluginItemsChangeMiddlewareContext, e as CanvasPluginRenderContext, f as CanvuChromeActiveToolStyle, g as CanvuChromeContext, h as CanvuChromeContextValue, i as CanvuChromeSelectionStyleChange, j as CanvuPluginContext, k as CanvuPluginContextValue, l as CanvuPluginViewportSnapshot, m as CustomShapePlacementOptions, P as PlacementPreview, n as VectorCanvasSpacePosition, o as VectorSelectionInspectorProps, p as VectorViewport, q as VectorViewportHandle, r as VectorViewportProps, W as WorldPointerDownDetail, s as createCanvuPlugin, t as getBoardPositionStyle, u as useCanvuChromeContext, v as useCanvuDocumentContext, w as useCanvuPluginContext, x as useCanvuPluginContribution, y as useCanvuResolvedTools, z as useCanvuViewportContext } from './types-BC9Xgfu6.cjs';
+import { V as VectorViewportAssetKind, a as VectorViewportAssetStore } from './link-item-D870_X6P.cjs';
+export { d as VectorViewportAssetHydrationRequest, e as VectorViewportAssetResolveRequest, f as VectorViewportAssetResolveResult, h as VectorViewportAssetUploadRequest, j as VectorViewportAssetUploadResult } from './link-item-D870_X6P.cjs';
+import { B as BoardComponentPosition, V as VectorToolDefinition, C as CanvasPlugin, a as VectorSelectionInspector } from './types-Bw1SdC9v.cjs';
+export { b as CanvasPluginComponentProps, c as CanvasPluginContribution, d as CanvasPluginItemsChangeMiddlewareContext, e as CanvasPluginRenderContext, f as CanvuChromeActiveToolStyle, g as CanvuChromeContext, h as CanvuChromeContextValue, i as CanvuChromeSelectionStyleChange, j as CanvuPluginContext, k as CanvuPluginContextValue, l as CanvuPluginViewportSnapshot, m as CustomShapePlacementOptions, P as PlacementPreview, n as VectorCanvasSpacePosition, o as VectorSelectionInspectorProps, p as VectorViewport, q as VectorViewportHandle, r as VectorViewportProps, W as WorldPointerDownDetail, s as createCanvuPlugin, t as getBoardPositionStyle, u as useCanvuChromeContext, v as useCanvuDocumentContext, w as useCanvuPluginContext, x as useCanvuPluginContribution, y as useCanvuResolvedTools, z as useCanvuViewportContext } from './types-Bw1SdC9v.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { CSSProperties, ReactNode, ReactElement, SVGProps } from 'react';
-import { C as Camera2D } from './camera-CVVG7z56.cjs';
+import { C as Camera2D } from './shape-builders-CKEMjivV.cjs';
 import { V as VectorCanvasPersistenceAdapter, a as VectorCanvasRemoteAdapter } from './types-BUPc2Zgw.cjs';
 export { b as VectorCanvasSnapshot } from './types-BUPc2Zgw.cjs';
 

package/dist/react.d.ts

@@ -1,14 +1,14 @@
-import { I as IndexedDbImageStore } from './asset-hydration-CbwQVAwh.js';
-export { H as HydratedSceneItemsWithAssetsResult, h as hydrateSceneItemsWithAssets } from './asset-hydration-CbwQVAwh.js';
+import { I as IndexedDbImageStore } from './asset-hydration-D35mHbUP.js';
+export { H as HydratedSceneItemsWithAssetsResult, h as hydrateSceneItemsWithAssets } from './asset-hydration-D35mHbUP.js';
 import { V as VectorSceneItem } from './types-BCCvY6ie.js';
-import { V as VectorViewportAssetKind, E as VectorViewportAssetStore } from './shape-builders-ClKv9tz9.js';
-export { G as VectorViewportAssetHydrationRequest, H as VectorViewportAssetResolveRequest, I as VectorViewportAssetResolveResult, J as VectorViewportAssetUploadRequest, K as VectorViewportAssetUploadResult } from './shape-builders-ClKv9tz9.js';
-import { B as BoardComponentPosition, V as VectorToolDefinition, C as CanvasPlugin, a as VectorSelectionInspector } from './types-DlSVGX0w.js';
-export { b as CanvasPluginComponentProps, c as CanvasPluginContribution, d as CanvasPluginItemsChangeMiddlewareContext, e as CanvasPluginRenderContext, f as CanvuChromeActiveToolStyle, g as CanvuChromeContext, h as CanvuChromeContextValue, i as CanvuChromeSelectionStyleChange, j as CanvuPluginContext, k as CanvuPluginContextValue, l as CanvuPluginViewportSnapshot, m as CustomShapePlacementOptions, P as PlacementPreview, n as VectorCanvasSpacePosition, o as VectorSelectionInspectorProps, p as VectorViewport, q as VectorViewportHandle, r as VectorViewportProps, W as WorldPointerDownDetail, s as createCanvuPlugin, t as getBoardPositionStyle, u as useCanvuChromeContext, v as useCanvuDocumentContext, w as useCanvuPluginContext, x as useCanvuPluginContribution, y as useCanvuResolvedTools, z as useCanvuViewportContext } from './types-DlSVGX0w.js';
+import { V as VectorViewportAssetKind, a as VectorViewportAssetStore } from './link-item-Bg5vj0RI.js';
+export { d as VectorViewportAssetHydrationRequest, e as VectorViewportAssetResolveRequest, f as VectorViewportAssetResolveResult, h as VectorViewportAssetUploadRequest, j as VectorViewportAssetUploadResult } from './link-item-Bg5vj0RI.js';
+import { B as BoardComponentPosition, V as VectorToolDefinition, C as CanvasPlugin, a as VectorSelectionInspector } from './types-DeXFfs7Y.js';
+export { b as CanvasPluginComponentProps, c as CanvasPluginContribution, d as CanvasPluginItemsChangeMiddlewareContext, e as CanvasPluginRenderContext, f as CanvuChromeActiveToolStyle, g as CanvuChromeContext, h as CanvuChromeContextValue, i as CanvuChromeSelectionStyleChange, j as CanvuPluginContext, k as CanvuPluginContextValue, l as CanvuPluginViewportSnapshot, m as CustomShapePlacementOptions, P as PlacementPreview, n as VectorCanvasSpacePosition, o as VectorSelectionInspectorProps, p as VectorViewport, q as VectorViewportHandle, r as VectorViewportProps, W as WorldPointerDownDetail, s as createCanvuPlugin, t as getBoardPositionStyle, u as useCanvuChromeContext, v as useCanvuDocumentContext, w as useCanvuPluginContext, x as useCanvuPluginContribution, y as useCanvuResolvedTools, z as useCanvuViewportContext } from './types-DeXFfs7Y.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { CSSProperties, ReactNode, ReactElement, SVGProps } from 'react';
-import { C as Camera2D } from './camera-CoRYN_IV.js';
+import { C as Camera2D } from './shape-builders-Cyh8zvDG.js';
 import { V as VectorCanvasPersistenceAdapter, a as VectorCanvasRemoteAdapter } from './types-CYtq9Pr9.js';
 export { b as VectorCanvasSnapshot } from './types-CYtq9Pr9.js';
 

package/dist/realtime.d.cts

@@ -1,11 +1,11 @@
-import { P as PlacementPreview, R as RemotePresenceMarkupStroke, A as RemotePresencePeer, D as RemotePresenceCamera, E as RealtimeConnectionState, q as VectorViewportHandle, V as VectorToolDefinition, r as VectorViewportProps, C as CanvasPlugin, e as CanvasPluginRenderContext } from './types-BC9Xgfu6.cjs';
-export { F as PresenceOverlayRenderContext } from './types-BC9Xgfu6.cjs';
+import { P as PlacementPreview, R as RemotePresenceMarkupStroke, A as RemotePresencePeer, D as RemotePresenceCamera, E as RealtimeConnectionState, q as VectorViewportHandle, V as VectorToolDefinition, r as VectorViewportProps, C as CanvasPlugin, e as CanvasPluginRenderContext } from './types-Bw1SdC9v.cjs';
+export { F as PresenceOverlayRenderContext } from './types-Bw1SdC9v.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { C as Camera2D } from './camera-CVVG7z56.cjs';
+import { C as Camera2D } from './shape-builders-CKEMjivV.cjs';
 import { V as VectorSceneItem, R as Rect } from './types-BCCvY6ie.cjs';
 import { ReactNode, RefObject } from 'react';
 import { a as VectorCanvasRemoteAdapter } from './types-BUPc2Zgw.cjs';
-import './shape-builders-BAWu-PxX.cjs';
+import './link-item-D870_X6P.cjs';
 
 /**
  * Maps a local {@link PlacementPreview} stroke to {@link RemotePresenceMarkupStroke} for broadcasting.

package/dist/realtime.d.ts

@@ -1,11 +1,11 @@
-import { P as PlacementPreview, R as RemotePresenceMarkupStroke, A as RemotePresencePeer, D as RemotePresenceCamera, E as RealtimeConnectionState, q as VectorViewportHandle, V as VectorToolDefinition, r as VectorViewportProps, C as CanvasPlugin, e as CanvasPluginRenderContext } from './types-DlSVGX0w.js';
-export { F as PresenceOverlayRenderContext } from './types-DlSVGX0w.js';
+import { P as PlacementPreview, R as RemotePresenceMarkupStroke, A as RemotePresencePeer, D as RemotePresenceCamera, E as RealtimeConnectionState, q as VectorViewportHandle, V as VectorToolDefinition, r as VectorViewportProps, C as CanvasPlugin, e as CanvasPluginRenderContext } from './types-DeXFfs7Y.js';
+export { F as PresenceOverlayRenderContext } from './types-DeXFfs7Y.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { C as Camera2D } from './camera-CoRYN_IV.js';
+import { C as Camera2D } from './shape-builders-Cyh8zvDG.js';
 import { V as VectorSceneItem, R as Rect } from './types-BCCvY6ie.js';
 import { ReactNode, RefObject } from 'react';
 import { a as VectorCanvasRemoteAdapter } from './types-CYtq9Pr9.js';
-import './shape-builders-ClKv9tz9.js';
+import './link-item-Bg5vj0RI.js';
 
 /**
  * Maps a local {@link PlacementPreview} stroke to {@link RemotePresenceMarkupStroke} for broadcasting.

package/dist/{shape-builders-BAWu-PxX.d.cts → shape-builders-CKEMjivV.d.cts}

@@ -1,152 +1,51 @@
-import { V as VectorSceneItem, R as Rect, L as LineEndpointsLocal, b as VectorPathPoint, a as ArrowBindings } from './types-BCCvY6ie.cjs';
+import { R as Rect, V as VectorSceneItem, L as LineEndpointsLocal, b as VectorPathPoint, a as ArrowBindings } from './types-BCCvY6ie.cjs';
 
-/**
- * Kind of binary selected through the built-in canvu asset ingestion flow.
- *
- * Use this to branch your backend upload logic when images and PDFs should be
- * stored differently.
- */
-type VectorViewportAssetKind = "image" | "pdf";
-/**
- * Original browser `File` intercepted from the built-in asset flow.
- *
- * This is the high-level hook for apps that want canvu to keep its native file
- * UX while still uploading the raw binary to their backend or object storage.
- *
- * The same request shape is also reused by
- * {@link ingestAssetFilesToSceneItems}, so custom import flows and the native
- * viewport UX can share one backend contract.
- */
-type VectorViewportAssetUploadRequest = {
-    /** Original browser file before canvu converts it into scene items. */
-    file: File;
-    /** High-level bucket for routing image vs PDF upload behavior. */
-    kind: VectorViewportAssetKind;
+type Camera2DOptions = {
+    /** Minimum zoom scale (world units per CSS pixel). */
+    minZoom?: number;
+    /** Maximum zoom scale. */
+    maxZoom?: number;
 };
 /**
- * Persisted metadata returned by a custom asset upload.
- *
- * The returned `pluginData` is shallow-merged into every `VectorSceneItem`
- * created from the uploaded file, making it available to custom persistence
- * adapters and later hydration flows.
- *
- * @example
- * ```ts
- * const assetStore: VectorViewportAssetStore = {
- *   async upload({ file, kind }) {
- *     const form = new FormData();
- *     form.append("file", file);
- *     form.append("kind", kind);
+ * 2D camera: pan (`x`, `y`) in **screen space** (CSS pixels) and uniform zoom `zoom`.
  *
- *     const response = await fetch("/api/canvu/assets", {
- *       method: "POST",
- *       body: form,
- *     });
- *
- *     const asset = await response.json();
- *     return {
- *       pluginData: {
- *         assetId: asset.id,
- *         assetKey: asset.key,
- *         mimeType: file.type,
- *       },
- *     };
- *   },
- *   async resolve({ assetIds }) {
- *     const response = await fetch("/api/canvu/assets/resolve", {
- *       method: "POST",
- *       headers: { "content-type": "application/json" },
- *       body: JSON.stringify({ assetIds }),
- *     });
- *
- *     return response.json();
- *   },
- * };
- * ```
+ * Screen mapping: `screen = world * zoom + cameraOffset`
+ * (world origin maps to `(x, y)` on screen).
  */
-type VectorViewportAssetUploadResult = {
+declare class Camera2D {
+    x: number;
+    y: number;
+    /** Scale: world units per CSS pixel (larger = more zoomed in). */
+    zoom: number;
+    readonly minZoom: number;
+    readonly maxZoom: number;
+    constructor(options?: Camera2DOptions);
     /**
-     * Opaque persisted metadata attached to created items.
-     *
-     * Use this for asset ids, bucket keys, original file names, or any backend
-     * reference needed to rehydrate the binary later from your own persistence
-     * adapter.
+     * Converts a point from world coordinates to CSS pixel coordinates relative to the viewport top-left.
      */
-    pluginData?: VectorSceneItem["pluginData"];
-};
-/**
- * Request to resolve persisted asset ids back into runtime URLs.
- *
- * This is useful inside custom persistence adapters when you want to rehydrate
- * signed URLs or CDN URLs after loading a snapshot.
- */
-type VectorViewportAssetResolveRequest = {
-    assetIds: string[];
-};
-/**
- * Runtime URL payload returned by a custom asset resolver.
- */
-type VectorViewportAssetResolveResult = Record<string, {
-    url: string;
-    thumbnailUrl?: string;
-}>;
-type VectorViewportAssetHydrationRequest = {
-    assetId: string;
-    kind: VectorViewportAssetKind;
-    pageNumber?: number;
-    scale?: number;
-};
-/**
- * High-level hook for apps that want to persist raw binaries out-of-band while
- * keeping canvu's built-in file UX.
- *
- * `upload` is used by the built-in file picker / drag-and-drop flow and by
- * {@link ingestAssetFilesToSceneItems}. `resolve` is optional for custom
- * persistence adapters and future hydration flows.
- */
-type VectorViewportAssetStore = {
-    upload: (request: VectorViewportAssetUploadRequest) => Promise<VectorViewportAssetUploadResult | undefined>;
-    resolve?: (request: VectorViewportAssetResolveRequest) => Promise<VectorViewportAssetResolveResult>;
-    getHydrationRequest?: (item: VectorSceneItem) => VectorViewportAssetHydrationRequest | null;
-};
-
-/** Plugin key under which link metadata is stored on a link item's `pluginData`. */
-declare const LINK_PLUGIN_KEY = "canvuLink";
-/**
- * Metadata describing a clickable link/bookmark item.
- * `href` is required; the rest enrich the rendered card (unfurl result).
- */
-type CanvuLinkData = {
-    /** Absolute URL the card points to. */
-    href: string;
-    /** Human readable title (falls back to the hostname). */
-    title?: string;
-    /** Short description shown under the title. */
-    description?: string;
-    /** Preview image URL (og:image). */
-    image?: string;
-    /** Favicon URL shown in the leading badge. */
-    favicon?: string;
-};
-/**
- * Builds the inner SVG (no outer `<svg>`) for a link/bookmark card at the given box size.
- * Uses fixed pixel bands so text never overlaps regardless of the card's aspect ratio.
- */
-declare function buildLinkCardSvg(width: number, height: number, link: CanvuLinkData): string;
-/** Reads the link metadata from an item, or `null` when the item is not a link. */
-declare function getLinkData(item: VectorSceneItem): CanvuLinkData | null;
-/** True when the item carries link metadata (clickable card). */
-declare function isLinkItem(item: VectorSceneItem): boolean;
-/**
- * Creates a clickable link/bookmark card item ready to append to the scene.
- * The card resizes by scaling its authored SVG, like other custom shapes.
- */
-declare function createLinkItem(id: string, bounds: Rect, link: CanvuLinkData): VectorSceneItem;
-/** Default card size used when placing a new link without explicit bounds. */
-declare const DEFAULT_LINK_CARD_SIZE: {
-    readonly width: 360;
-    readonly height: 132;
-};
+    worldToScreen(worldX: number, worldY: number): {
+        screenX: number;
+        screenY: number;
+    };
+    /**
+     * Converts a point from CSS pixel coordinates (viewport-relative) to world coordinates.
+     */
+    screenToWorld(screenX: number, screenY: number): {
+        worldX: number;
+        worldY: number;
+    };
+    /**
+     * Sets zoom, clamped to `[minZoom, maxZoom]`, optionally anchoring a screen point so it stays under the cursor.
+     */
+    setZoom(nextZoom: number, anchorScreen?: {
+        x: number;
+        y: number;
+    }): void;
+    /**
+     * Returns the world-space rectangle visible in a viewport of `viewportWidth` x `viewportHeight` CSS pixels.
+     */
+    getVisibleWorldRect(viewportWidth: number, viewportHeight: number): Rect;
+}
 
 /** Stroke dash pattern for freehand drawings. `solid` = perfect-freehand fill; `dashed` = centerline stroke with dashes. */
 type StrokeDash = "solid" | "dashed";
@@ -283,4 +182,4 @@ declare function createImageFromVectorTrace(id: string, bounds: Rect, imageVecto
     height: number;
 }): VectorSceneItem;
 
-export { rebuildItemSvg as A, resolveStrokeStyle as B, type CanvuLinkData as C, DEFAULT_LINK_CARD_SIZE as D, type VectorViewportAssetStore as E, type FreehandSvgPayload as F, type VectorViewportAssetHydrationRequest as G, type VectorViewportAssetResolveRequest as H, type VectorViewportAssetResolveResult as I, type VectorViewportAssetUploadRequest as J, type VectorViewportAssetUploadResult as K, LINK_PLUGIN_KEY as L, type StrokeStyle as S, type VectorViewportAssetKind as V, DEFAULT_STROKE_STYLE as a, applyStrokeToItem as b, buildArchitecturalCloudPathD as c, buildArchitecturalCloudSvg as d, buildArrowSvg as e, buildDrawDotSvg as f, buildEllipseSvg as g, buildFreehandPathSvg as h, buildLineSvg as i, buildLinkCardSvg as j, buildRectSvg as k, computeFreehandSvgPayload as l, createArchitecturalCloudItem as m, createDrawDotItem as n, createEllipseItem as o, createFreehandStrokeItem as p, createImageFromVectorTrace as q, createImageItem as r, createLineItem as s, createLinkItem as t, createRectangleItem as u, createShapeId as v, createTextItem as w, getLinkData as x, isLinkItem as y, lineEndpointsToLocal as z };
+export { Camera2D as C, DEFAULT_STROKE_STYLE as D, type FreehandSvgPayload as F, type StrokeStyle as S, type Camera2DOptions as a, applyStrokeToItem as b, buildArchitecturalCloudPathD as c, buildArchitecturalCloudSvg as d, buildArrowSvg as e, buildDrawDotSvg as f, buildEllipseSvg as g, buildFreehandPathSvg as h, buildLineSvg as i, buildRectSvg as j, computeFreehandSvgPayload as k, createArchitecturalCloudItem as l, createDrawDotItem as m, createEllipseItem as n, createFreehandStrokeItem as o, createImageFromVectorTrace as p, createImageItem as q, createLineItem as r, createRectangleItem as s, createShapeId as t, createTextItem as u, lineEndpointsToLocal as v, rebuildItemSvg as w, resolveStrokeStyle as x };

package/dist/{shape-builders-ClKv9tz9.d.ts → shape-builders-Cyh8zvDG.d.ts}

@@ -1,152 +1,51 @@
-import { V as VectorSceneItem, R as Rect, L as LineEndpointsLocal, b as VectorPathPoint, a as ArrowBindings } from './types-BCCvY6ie.js';
+import { R as Rect, V as VectorSceneItem, L as LineEndpointsLocal, b as VectorPathPoint, a as ArrowBindings } from './types-BCCvY6ie.js';
 
-/**
- * Kind of binary selected through the built-in canvu asset ingestion flow.
- *
- * Use this to branch your backend upload logic when images and PDFs should be
- * stored differently.
- */
-type VectorViewportAssetKind = "image" | "pdf";
-/**
- * Original browser `File` intercepted from the built-in asset flow.
- *
- * This is the high-level hook for apps that want canvu to keep its native file
- * UX while still uploading the raw binary to their backend or object storage.
- *
- * The same request shape is also reused by
- * {@link ingestAssetFilesToSceneItems}, so custom import flows and the native
- * viewport UX can share one backend contract.
- */
-type VectorViewportAssetUploadRequest = {
-    /** Original browser file before canvu converts it into scene items. */
-    file: File;
-    /** High-level bucket for routing image vs PDF upload behavior. */
-    kind: VectorViewportAssetKind;
+type Camera2DOptions = {
+    /** Minimum zoom scale (world units per CSS pixel). */
+    minZoom?: number;
+    /** Maximum zoom scale. */
+    maxZoom?: number;
 };
 /**
- * Persisted metadata returned by a custom asset upload.
- *
- * The returned `pluginData` is shallow-merged into every `VectorSceneItem`
- * created from the uploaded file, making it available to custom persistence
- * adapters and later hydration flows.
- *
- * @example
- * ```ts
- * const assetStore: VectorViewportAssetStore = {
- *   async upload({ file, kind }) {
- *     const form = new FormData();
- *     form.append("file", file);
- *     form.append("kind", kind);
+ * 2D camera: pan (`x`, `y`) in **screen space** (CSS pixels) and uniform zoom `zoom`.
  *
- *     const response = await fetch("/api/canvu/assets", {
- *       method: "POST",
- *       body: form,
- *     });
- *
- *     const asset = await response.json();
- *     return {
- *       pluginData: {
- *         assetId: asset.id,
- *         assetKey: asset.key,
- *         mimeType: file.type,
- *       },
- *     };
- *   },
- *   async resolve({ assetIds }) {
- *     const response = await fetch("/api/canvu/assets/resolve", {
- *       method: "POST",
- *       headers: { "content-type": "application/json" },
- *       body: JSON.stringify({ assetIds }),
- *     });
- *
- *     return response.json();
- *   },
- * };
- * ```
+ * Screen mapping: `screen = world * zoom + cameraOffset`
+ * (world origin maps to `(x, y)` on screen).
  */
-type VectorViewportAssetUploadResult = {
+declare class Camera2D {
+    x: number;
+    y: number;
+    /** Scale: world units per CSS pixel (larger = more zoomed in). */
+    zoom: number;
+    readonly minZoom: number;
+    readonly maxZoom: number;
+    constructor(options?: Camera2DOptions);
     /**
-     * Opaque persisted metadata attached to created items.
-     *
-     * Use this for asset ids, bucket keys, original file names, or any backend
-     * reference needed to rehydrate the binary later from your own persistence
-     * adapter.
+     * Converts a point from world coordinates to CSS pixel coordinates relative to the viewport top-left.
      */
-    pluginData?: VectorSceneItem["pluginData"];
-};
-/**
- * Request to resolve persisted asset ids back into runtime URLs.
- *
- * This is useful inside custom persistence adapters when you want to rehydrate
- * signed URLs or CDN URLs after loading a snapshot.
- */
-type VectorViewportAssetResolveRequest = {
-    assetIds: string[];
-};
-/**
- * Runtime URL payload returned by a custom asset resolver.
- */
-type VectorViewportAssetResolveResult = Record<string, {
-    url: string;
-    thumbnailUrl?: string;
-}>;
-type VectorViewportAssetHydrationRequest = {
-    assetId: string;
-    kind: VectorViewportAssetKind;
-    pageNumber?: number;
-    scale?: number;
-};
-/**
- * High-level hook for apps that want to persist raw binaries out-of-band while
- * keeping canvu's built-in file UX.
- *
- * `upload` is used by the built-in file picker / drag-and-drop flow and by
- * {@link ingestAssetFilesToSceneItems}. `resolve` is optional for custom
- * persistence adapters and future hydration flows.
- */
-type VectorViewportAssetStore = {
-    upload: (request: VectorViewportAssetUploadRequest) => Promise<VectorViewportAssetUploadResult | undefined>;
-    resolve?: (request: VectorViewportAssetResolveRequest) => Promise<VectorViewportAssetResolveResult>;
-    getHydrationRequest?: (item: VectorSceneItem) => VectorViewportAssetHydrationRequest | null;
-};
-
-/** Plugin key under which link metadata is stored on a link item's `pluginData`. */
-declare const LINK_PLUGIN_KEY = "canvuLink";
-/**
- * Metadata describing a clickable link/bookmark item.
- * `href` is required; the rest enrich the rendered card (unfurl result).
- */
-type CanvuLinkData = {
-    /** Absolute URL the card points to. */
-    href: string;
-    /** Human readable title (falls back to the hostname). */
-    title?: string;
-    /** Short description shown under the title. */
-    description?: string;
-    /** Preview image URL (og:image). */
-    image?: string;
-    /** Favicon URL shown in the leading badge. */
-    favicon?: string;
-};
-/**
- * Builds the inner SVG (no outer `<svg>`) for a link/bookmark card at the given box size.
- * Uses fixed pixel bands so text never overlaps regardless of the card's aspect ratio.
- */
-declare function buildLinkCardSvg(width: number, height: number, link: CanvuLinkData): string;
-/** Reads the link metadata from an item, or `null` when the item is not a link. */
-declare function getLinkData(item: VectorSceneItem): CanvuLinkData | null;
-/** True when the item carries link metadata (clickable card). */
-declare function isLinkItem(item: VectorSceneItem): boolean;
-/**
- * Creates a clickable link/bookmark card item ready to append to the scene.
- * The card resizes by scaling its authored SVG, like other custom shapes.
- */
-declare function createLinkItem(id: string, bounds: Rect, link: CanvuLinkData): VectorSceneItem;
-/** Default card size used when placing a new link without explicit bounds. */
-declare const DEFAULT_LINK_CARD_SIZE: {
-    readonly width: 360;
-    readonly height: 132;
-};
+    worldToScreen(worldX: number, worldY: number): {
+        screenX: number;
+        screenY: number;
+    };
+    /**
+     * Converts a point from CSS pixel coordinates (viewport-relative) to world coordinates.
+     */
+    screenToWorld(screenX: number, screenY: number): {
+        worldX: number;
+        worldY: number;
+    };
+    /**
+     * Sets zoom, clamped to `[minZoom, maxZoom]`, optionally anchoring a screen point so it stays under the cursor.
+     */
+    setZoom(nextZoom: number, anchorScreen?: {
+        x: number;
+        y: number;
+    }): void;
+    /**
+     * Returns the world-space rectangle visible in a viewport of `viewportWidth` x `viewportHeight` CSS pixels.
+     */
+    getVisibleWorldRect(viewportWidth: number, viewportHeight: number): Rect;
+}
 
 /** Stroke dash pattern for freehand drawings. `solid` = perfect-freehand fill; `dashed` = centerline stroke with dashes. */
 type StrokeDash = "solid" | "dashed";
@@ -283,4 +182,4 @@ declare function createImageFromVectorTrace(id: string, bounds: Rect, imageVecto
     height: number;
 }): VectorSceneItem;
 
-export { rebuildItemSvg as A, resolveStrokeStyle as B, type CanvuLinkData as C, DEFAULT_LINK_CARD_SIZE as D, type VectorViewportAssetStore as E, type FreehandSvgPayload as F, type VectorViewportAssetHydrationRequest as G, type VectorViewportAssetResolveRequest as H, type VectorViewportAssetResolveResult as I, type VectorViewportAssetUploadRequest as J, type VectorViewportAssetUploadResult as K, LINK_PLUGIN_KEY as L, type StrokeStyle as S, type VectorViewportAssetKind as V, DEFAULT_STROKE_STYLE as a, applyStrokeToItem as b, buildArchitecturalCloudPathD as c, buildArchitecturalCloudSvg as d, buildArrowSvg as e, buildDrawDotSvg as f, buildEllipseSvg as g, buildFreehandPathSvg as h, buildLineSvg as i, buildLinkCardSvg as j, buildRectSvg as k, computeFreehandSvgPayload as l, createArchitecturalCloudItem as m, createDrawDotItem as n, createEllipseItem as o, createFreehandStrokeItem as p, createImageFromVectorTrace as q, createImageItem as r, createLineItem as s, createLinkItem as t, createRectangleItem as u, createShapeId as v, createTextItem as w, getLinkData as x, isLinkItem as y, lineEndpointsToLocal as z };
+export { Camera2D as C, DEFAULT_STROKE_STYLE as D, type FreehandSvgPayload as F, type StrokeStyle as S, type Camera2DOptions as a, applyStrokeToItem as b, buildArchitecturalCloudPathD as c, buildArchitecturalCloudSvg as d, buildArrowSvg as e, buildDrawDotSvg as f, buildEllipseSvg as g, buildFreehandPathSvg as h, buildLineSvg as i, buildRectSvg as j, computeFreehandSvgPayload as k, createArchitecturalCloudItem as l, createDrawDotItem as m, createEllipseItem as n, createFreehandStrokeItem as o, createImageFromVectorTrace as p, createImageItem as q, createLineItem as r, createRectangleItem as s, createShapeId as t, createTextItem as u, lineEndpointsToLocal as v, rebuildItemSvg as w, resolveStrokeStyle as x };

package/dist/{types-BC9Xgfu6.d.cts → types-Bw1SdC9v.d.cts}

@@ -1,8 +1,8 @@
 import * as react from 'react';
 import { CSSProperties, ReactNode, RefObject } from 'react';
 import { V as VectorSceneItem, R as Rect } from './types-BCCvY6ie.cjs';
-import { C as Camera2D } from './camera-CVVG7z56.cjs';
-import { S as StrokeStyle, C as CanvuLinkData, E as VectorViewportAssetStore } from './shape-builders-BAWu-PxX.cjs';
+import { S as StrokeStyle, C as Camera2D } from './shape-builders-CKEMjivV.cjs';
+import { C as CanvuLinkData, a as VectorViewportAssetStore } from './link-item-D870_X6P.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 type CanvuChromeActiveToolStyle = StrokeStyle & {

package/dist/{types-DlSVGX0w.d.ts → types-DeXFfs7Y.d.ts}

@@ -1,8 +1,8 @@
 import * as react from 'react';
 import { CSSProperties, ReactNode, RefObject } from 'react';
 import { V as VectorSceneItem, R as Rect } from './types-BCCvY6ie.js';
-import { C as Camera2D } from './camera-CoRYN_IV.js';
-import { S as StrokeStyle, C as CanvuLinkData, E as VectorViewportAssetStore } from './shape-builders-ClKv9tz9.js';
+import { S as StrokeStyle, C as Camera2D } from './shape-builders-Cyh8zvDG.js';
+import { C as CanvuLinkData, a as VectorViewportAssetStore } from './link-item-Bg5vj0RI.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 type CanvuChromeActiveToolStyle = StrokeStyle & {

package/package.json

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

package/dist/camera-CVVG7z56.d.cts

@@ -1,50 +0,0 @@
-import { R as Rect } from './types-BCCvY6ie.cjs';
-
-type Camera2DOptions = {
-    /** Minimum zoom scale (world units per CSS pixel). */
-    minZoom?: number;
-    /** Maximum zoom scale. */
-    maxZoom?: number;
-};
-/**
- * 2D camera: pan (`x`, `y`) in **screen space** (CSS pixels) and uniform zoom `zoom`.
- *
- * Screen mapping: `screen = world * zoom + cameraOffset`
- * (world origin maps to `(x, y)` on screen).
- */
-declare class Camera2D {
-    x: number;
-    y: number;
-    /** Scale: world units per CSS pixel (larger = more zoomed in). */
-    zoom: number;
-    readonly minZoom: number;
-    readonly maxZoom: number;
-    constructor(options?: Camera2DOptions);
-    /**
-     * Converts a point from world coordinates to CSS pixel coordinates relative to the viewport top-left.
-     */
-    worldToScreen(worldX: number, worldY: number): {
-        screenX: number;
-        screenY: number;
-    };
-    /**
-     * Converts a point from CSS pixel coordinates (viewport-relative) to world coordinates.
-     */
-    screenToWorld(screenX: number, screenY: number): {
-        worldX: number;
-        worldY: number;
-    };
-    /**
-     * Sets zoom, clamped to `[minZoom, maxZoom]`, optionally anchoring a screen point so it stays under the cursor.
-     */
-    setZoom(nextZoom: number, anchorScreen?: {
-        x: number;
-        y: number;
-    }): void;
-    /**
-     * Returns the world-space rectangle visible in a viewport of `viewportWidth` x `viewportHeight` CSS pixels.
-     */
-    getVisibleWorldRect(viewportWidth: number, viewportHeight: number): Rect;
-}
-
-export { Camera2D as C, type Camera2DOptions as a };

package/dist/camera-CoRYN_IV.d.ts

@@ -1,50 +0,0 @@
-import { R as Rect } from './types-BCCvY6ie.js';
-
-type Camera2DOptions = {
-    /** Minimum zoom scale (world units per CSS pixel). */
-    minZoom?: number;
-    /** Maximum zoom scale. */
-    maxZoom?: number;
-};
-/**
- * 2D camera: pan (`x`, `y`) in **screen space** (CSS pixels) and uniform zoom `zoom`.
- *
- * Screen mapping: `screen = world * zoom + cameraOffset`
- * (world origin maps to `(x, y)` on screen).
- */
-declare class Camera2D {
-    x: number;
-    y: number;
-    /** Scale: world units per CSS pixel (larger = more zoomed in). */
-    zoom: number;
-    readonly minZoom: number;
-    readonly maxZoom: number;
-    constructor(options?: Camera2DOptions);
-    /**
-     * Converts a point from world coordinates to CSS pixel coordinates relative to the viewport top-left.
-     */
-    worldToScreen(worldX: number, worldY: number): {
-        screenX: number;
-        screenY: number;
-    };
-    /**
-     * Converts a point from CSS pixel coordinates (viewport-relative) to world coordinates.
-     */
-    screenToWorld(screenX: number, screenY: number): {
-        worldX: number;
-        worldY: number;
-    };
-    /**
-     * Sets zoom, clamped to `[minZoom, maxZoom]`, optionally anchoring a screen point so it stays under the cursor.
-     */
-    setZoom(nextZoom: number, anchorScreen?: {
-        x: number;
-        y: number;
-    }): void;
-    /**
-     * Returns the world-space rectangle visible in a viewport of `viewportWidth` x `viewportHeight` CSS pixels.
-     */
-    getVisibleWorldRect(viewportWidth: number, viewportHeight: number): Rect;
-}
-
-export { Camera2D as C, type Camera2DOptions as a };