canvu-react 0.4.69 → 0.4.71

package/dist/{raster-image-canvas-CCOmB4NY.d.ts → raster-image-canvas-BqBgE8C-.d.ts}

@@ -179,6 +179,37 @@ type RasterImageCanvasRenderRequest = {
     cameraZoom: number;
     devicePixelRatio: number;
 };
+/**
+ * Bitmap-like source returned by `imageCanvasRendering.resolveCanvasSource`.
+ *
+ * Apps can render into an offscreen canvas, create an `ImageBitmap`, or wrap any
+ * other canvas-compatible source and let Canvu copy it into the visible canvas
+ * without changing the underlying SVG image URL.
+ */
+type RasterImageCanvasSource = {
+    width: number;
+    height: number;
+    draw: (context: CanvasRenderingContext2D) => void;
+    close?: () => void;
+};
+/**
+ * Input passed to `imageCanvasRendering.resolveCanvasSource`.
+ *
+ * Use this for custom async rendering pipelines such as PDF page rasterization.
+ * Canvu keeps the previous canvas visible while this request resolves and aborts
+ * stale requests when the item leaves the viewport or a sharper target is queued.
+ */
+type RasterImageCanvasSourceRequest = RasterImageCanvasRenderRequest & {
+    targetHref: string;
+    sourceKey: string;
+    signal: AbortSignal;
+};
+/**
+ * Maps an image item plus requested bitmap size to a custom canvas source.
+ *
+ * Return `null`/`undefined` to let Canvu fetch and decode the resolved URL.
+ */
+type RasterImageCanvasSourceResolver = (request: RasterImageCanvasSourceRequest) => RasterImageCanvasSource | null | undefined | Promise<RasterImageCanvasSource | null | undefined>;
 /**
  * Resolved raster source for a zoom-aware canvas redraw.
  *
@@ -209,6 +240,7 @@ type RasterImageCanvasRenderTargetResolver = (request: RasterImageCanvasRenderRe
 type RasterImageCanvasRenderingOptions = {
     resolveSourceSize?: RasterImageCanvasSourceSizeResolver;
     resolveRenderTarget?: RasterImageCanvasRenderTargetResolver;
+    resolveCanvasSource?: RasterImageCanvasSourceResolver;
     devicePixelRatio?: number;
     pixelHeadroom?: number;
     maxPixelCount?: number;
@@ -216,4 +248,4 @@ type RasterImageCanvasRenderingOptions = {
     upscaleRedrawRatio?: number;
 };
 
-export type { RasterImageCanvasRenderingOptions as R, VectorViewportAssetKind as V, VectorViewportAssetStore as a, RasterImageCanvasRenderRequest as b, RasterImageCanvasRenderTarget as c, RasterImageCanvasRenderTargetResolver as d, RasterImageCanvasSourceSizeRequest as e, RasterImageCanvasSourceSizeResolver as f, VectorViewportAssetHydrationRequest as g, VectorViewportAssetResolveRequest as h, VectorViewportAssetResolveResult as i, VectorViewportAssetUploadRequest as j, VectorViewportAssetUploadResult as k };
+export type { RasterImageCanvasRenderingOptions as R, VectorViewportAssetKind as V, VectorViewportAssetStore as a, RasterImageCanvasRenderRequest as b, RasterImageCanvasRenderTarget as c, RasterImageCanvasRenderTargetResolver as d, RasterImageCanvasSource as e, RasterImageCanvasSourceRequest as f, RasterImageCanvasSourceResolver as g, RasterImageCanvasSourceSizeRequest as h, RasterImageCanvasSourceSizeResolver as i, VectorViewportAssetHydrationRequest as j, VectorViewportAssetResolveRequest as k, VectorViewportAssetResolveResult as l, VectorViewportAssetUploadRequest as m, VectorViewportAssetUploadResult as n };

package/dist/{raster-image-canvas-nK9kM9UJ.d.cts → raster-image-canvas-Byq087t9.d.cts}

@@ -179,6 +179,37 @@ type RasterImageCanvasRenderRequest = {
     cameraZoom: number;
     devicePixelRatio: number;
 };
+/**
+ * Bitmap-like source returned by `imageCanvasRendering.resolveCanvasSource`.
+ *
+ * Apps can render into an offscreen canvas, create an `ImageBitmap`, or wrap any
+ * other canvas-compatible source and let Canvu copy it into the visible canvas
+ * without changing the underlying SVG image URL.
+ */
+type RasterImageCanvasSource = {
+    width: number;
+    height: number;
+    draw: (context: CanvasRenderingContext2D) => void;
+    close?: () => void;
+};
+/**
+ * Input passed to `imageCanvasRendering.resolveCanvasSource`.
+ *
+ * Use this for custom async rendering pipelines such as PDF page rasterization.
+ * Canvu keeps the previous canvas visible while this request resolves and aborts
+ * stale requests when the item leaves the viewport or a sharper target is queued.
+ */
+type RasterImageCanvasSourceRequest = RasterImageCanvasRenderRequest & {
+    targetHref: string;
+    sourceKey: string;
+    signal: AbortSignal;
+};
+/**
+ * Maps an image item plus requested bitmap size to a custom canvas source.
+ *
+ * Return `null`/`undefined` to let Canvu fetch and decode the resolved URL.
+ */
+type RasterImageCanvasSourceResolver = (request: RasterImageCanvasSourceRequest) => RasterImageCanvasSource | null | undefined | Promise<RasterImageCanvasSource | null | undefined>;
 /**
  * Resolved raster source for a zoom-aware canvas redraw.
  *
@@ -209,6 +240,7 @@ type RasterImageCanvasRenderTargetResolver = (request: RasterImageCanvasRenderRe
 type RasterImageCanvasRenderingOptions = {
     resolveSourceSize?: RasterImageCanvasSourceSizeResolver;
     resolveRenderTarget?: RasterImageCanvasRenderTargetResolver;
+    resolveCanvasSource?: RasterImageCanvasSourceResolver;
     devicePixelRatio?: number;
     pixelHeadroom?: number;
     maxPixelCount?: number;
@@ -216,4 +248,4 @@ type RasterImageCanvasRenderingOptions = {
     upscaleRedrawRatio?: number;
 };
 
-export type { RasterImageCanvasRenderingOptions as R, VectorViewportAssetKind as V, VectorViewportAssetStore as a, RasterImageCanvasRenderRequest as b, RasterImageCanvasRenderTarget as c, RasterImageCanvasRenderTargetResolver as d, RasterImageCanvasSourceSizeRequest as e, RasterImageCanvasSourceSizeResolver as f, VectorViewportAssetHydrationRequest as g, VectorViewportAssetResolveRequest as h, VectorViewportAssetResolveResult as i, VectorViewportAssetUploadRequest as j, VectorViewportAssetUploadResult as k };
+export type { RasterImageCanvasRenderingOptions as R, VectorViewportAssetKind as V, VectorViewportAssetStore as a, RasterImageCanvasRenderRequest as b, RasterImageCanvasRenderTarget as c, RasterImageCanvasRenderTargetResolver as d, RasterImageCanvasSource as e, RasterImageCanvasSourceRequest as f, RasterImageCanvasSourceResolver as g, RasterImageCanvasSourceSizeRequest as h, RasterImageCanvasSourceSizeResolver as i, VectorViewportAssetHydrationRequest as j, VectorViewportAssetResolveRequest as k, VectorViewportAssetResolveResult as l, VectorViewportAssetUploadRequest as m, VectorViewportAssetUploadResult as n };

package/dist/react.cjs

@@ -6896,6 +6896,7 @@ function resolveRasterImageCanvasRenderingOptions(options) {
   return {
     resolveSourceSize: options.resolveSourceSize,
     resolveRenderTarget: options.resolveRenderTarget,
+    resolveCanvasSource: options.resolveCanvasSource,
     devicePixelRatio: toPositiveFiniteNumber(
       options.devicePixelRatio,
       fallbackDevicePixelRatio
@@ -7160,6 +7161,36 @@ function loadImageElement(href, signal) {
     image.src = href;
   });
 }
+function normalizeDecodedRasterImageSource(source) {
+  if (!source) return null;
+  const width = Math.max(1, Math.round(source.width));
+  const height = Math.max(1, Math.round(source.height));
+  if (!Number.isFinite(width) || !Number.isFinite(height)) return null;
+  return {
+    width,
+    height,
+    draw: source.draw,
+    close: source.close ?? (() => {
+    })
+  };
+}
+async function resolveDecodedRasterImageSource({
+  options,
+  request,
+  width,
+  height,
+  signal
+}) {
+  if (options?.resolveCanvasSource) {
+    const source = await options.resolveCanvasSource({
+      ...request,
+      signal
+    });
+    const decoded = normalizeDecodedRasterImageSource(source);
+    if (decoded) return decoded;
+  }
+  return decodeRasterImage(request.targetHref, width, height, signal);
+}
 var SvgVectorRenderer = class {
   container;
   scene;
@@ -7392,7 +7423,20 @@ var SvgVectorRenderer = class {
     }
     const request = {
       itemHref: item.imageRasterHref,
-      target
+      target,
+      sourceRequest: {
+        item,
+        href: item.imageRasterHref,
+        intrinsicSize: item.imageIntrinsicSize,
+        sourceSize,
+        contentRect: target.contentRect,
+        targetSize: target.targetSize,
+        viewportSize,
+        cameraZoom: this.camera.zoom,
+        devicePixelRatio: options.devicePixelRatio,
+        targetHref: target.href,
+        sourceKey: target.sourceKey
+      }
     };
     if (rasterCanvas.abortController) {
       if (rasterCanvas.loadingItemHref !== item.imageRasterHref) {
@@ -7482,7 +7526,13 @@ var SvgVectorRenderer = class {
     rasterCanvas.loadingWidth = width;
     rasterCanvas.loadingHeight = height;
     rasterCanvas.queuedTarget = null;
-    decodeRasterImage(target.href, width, height, abortController.signal).then((decoded) => {
+    resolveDecodedRasterImageSource({
+      options: this.rasterImageCanvasRendering,
+      request: request.sourceRequest,
+      width,
+      height,
+      signal: abortController.signal
+    }).then((decoded) => {
       if (abortController.signal.aborted || rasterCanvas.loadSequence !== sequence) {
         decoded.close();
         return;