canvu-react 0.4.67 → 0.4.69

package/dist/{types-B-Jdh-n6.d.ts → types-CMuEaiM7.d.ts}

@@ -2,8 +2,8 @@ import * as react from 'react';
 import { CSSProperties, ReactNode, RefObject } from 'react';
 import { V as VectorSceneItem, R as Rect } from './types-fJNwEnHf.js';
 import { S as StrokeStyle, C as Camera2D } from './shape-builders-xG3A66sv.js';
+import { a as VectorViewportAssetStore, R as RasterImageCanvasRenderingOptions } from './raster-image-canvas-CCOmB4NY.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-BXa2CIrc.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
@@ -704,6 +704,17 @@ type VectorViewportProps = {
      * canvu's native file tool.
      */
     assetStore?: VectorViewportAssetStore;
+    /**
+     * Optional canvas-backed raster rendering for image items.
+     *
+     * Use this for large PDF/page images where the item SVG should stay stable while
+     * the viewport progressively redraws a sharper bitmap as users zoom in. The
+     * original SVG `<image>` remains as the fallback while the canvas target loads.
+     *
+     * Provide `resolveRenderTarget` when your app has a resize/proxy image endpoint;
+     * it receives the target pixel size and can return the URL that best matches it.
+     */
+    imageCanvasRendering?: RasterImageCanvasRenderingOptions | null;
     /**
      * When false (default), finishing a draw/place/erase gesture requests switching back to `autoResetToolTo`.
      * Use with controlled tool state (`onToolChangeRequest`) to keep "select-after-use" behavior.

package/dist/{types-D5d-3dvz.d.cts → types-D402X18k.d.cts}

@@ -2,8 +2,8 @@ import * as react from 'react';
 import { CSSProperties, ReactNode, RefObject } from 'react';
 import { V as VectorSceneItem, R as Rect } from './types-fJNwEnHf.cjs';
 import { S as StrokeStyle, C as Camera2D } from './shape-builders-DzhCOuzo.cjs';
+import { a as VectorViewportAssetStore, R as RasterImageCanvasRenderingOptions } from './raster-image-canvas-nK9kM9UJ.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-DqsqQQVf.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
@@ -704,6 +704,17 @@ type VectorViewportProps = {
      * canvu's native file tool.
      */
     assetStore?: VectorViewportAssetStore;
+    /**
+     * Optional canvas-backed raster rendering for image items.
+     *
+     * Use this for large PDF/page images where the item SVG should stay stable while
+     * the viewport progressively redraws a sharper bitmap as users zoom in. The
+     * original SVG `<image>` remains as the fallback while the canvas target loads.
+     *
+     * Provide `resolveRenderTarget` when your app has a resize/proxy image endpoint;
+     * it receives the target pixel size and can return the URL that best matches it.
+     */
+    imageCanvasRendering?: RasterImageCanvasRenderingOptions | null;
     /**
      * When false (default), finishing a draw/place/erase gesture requests switching back to `autoResetToolTo`.
      * Use with controlled tool state (`onToolChangeRequest`) to keep "select-after-use" behavior.

package/package.json

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

package/dist/asset-store-35ysK28r.d.cts

@@ -1,113 +0,0 @@
-import { V as VectorSceneItem } from './types-fJNwEnHf.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;
-};
-/**
- * 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);
- *
- *     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();
- *   },
- * };
- * ```
- */
-type VectorViewportAssetUploadResult = {
-    /**
-     * 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.
-     */
-    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;
-};
-
-export type { VectorViewportAssetKind as V, VectorViewportAssetStore as a, VectorViewportAssetHydrationRequest as b, VectorViewportAssetResolveRequest as c, VectorViewportAssetResolveResult as d, VectorViewportAssetUploadRequest as e, VectorViewportAssetUploadResult as f };

package/dist/asset-store-D_FjW_CN.d.ts

@@ -1,113 +0,0 @@
-import { V as VectorSceneItem } from './types-fJNwEnHf.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;
-};
-/**
- * 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);
- *
- *     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();
- *   },
- * };
- * ```
- */
-type VectorViewportAssetUploadResult = {
-    /**
-     * 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.
-     */
-    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;
-};
-
-export type { VectorViewportAssetKind as V, VectorViewportAssetStore as a, VectorViewportAssetHydrationRequest as b, VectorViewportAssetResolveRequest as c, VectorViewportAssetResolveResult as d, VectorViewportAssetUploadRequest as e, VectorViewportAssetUploadResult as f };