@overtone-art/canvas-editor-core 0.2.7 → 0.2.8

package/dist/chunk-ORZZ6MGQ.mjs

@@ -0,0 +1,228 @@
+// src/displacement.ts
+var CHANNEL_INDEX = {
+  red: 0,
+  green: 1,
+  blue: 2,
+  alpha: 3
+};
+function finiteScale(value, fallback, label) {
+  const resolved = value ?? fallback;
+  if (!Number.isFinite(resolved)) throw new Error(`${label} must be finite`);
+  return resolved;
+}
+function sample(source, width, height, x, y, channel) {
+  const clampedX = Math.max(0, Math.min(width - 1, x));
+  const clampedY = Math.max(0, Math.min(height - 1, y));
+  const x0 = Math.floor(clampedX);
+  const y0 = Math.floor(clampedY);
+  const x1 = Math.min(width - 1, x0 + 1);
+  const y1 = Math.min(height - 1, y0 + 1);
+  const tx = clampedX - x0;
+  const ty = clampedY - y0;
+  const top = source[(y0 * width + x0) * 4 + channel] * (1 - tx) + source[(y0 * width + x1) * 4 + channel] * tx;
+  const bottom = source[(y1 * width + x0) * 4 + channel] * (1 - tx) + source[(y1 * width + x1) * 4 + channel] * tx;
+  return top * (1 - ty) + bottom * ty;
+}
+function displaceRgba(source, map, width, height, options) {
+  if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0) {
+    throw new Error("Displacement dimensions must be positive integers");
+  }
+  const expectedLength = width * height * 4;
+  if (source.length !== expectedLength || map.length !== expectedLength) {
+    throw new Error("Displacement source and map must match the requested dimensions");
+  }
+  const scaleX = finiteScale(options.scaleX, 10, "Displacement scaleX");
+  const scaleY = finiteScale(options.scaleY, 10, "Displacement scaleY");
+  const channelX = CHANNEL_INDEX[options.channelX ?? "red"];
+  const channelY = CHANNEL_INDEX[options.channelY ?? "green"];
+  const output = new Uint8ClampedArray(expectedLength);
+  for (let y = 0; y < height; y += 1) {
+    for (let x = 0; x < width; x += 1) {
+      const offset = (y * width + x) * 4;
+      const sourceX = x + (map[offset + channelX] - 128) / 127 * scaleX;
+      const sourceY = y + (map[offset + channelY] - 128) / 127 * scaleY;
+      for (let channel = 0; channel < 4; channel += 1) {
+        output[offset + channel] = Math.round(
+          sample(source, width, height, sourceX, sourceY, channel)
+        );
+      }
+    }
+  }
+  return output;
+}
+
+// src/export.ts
+import { StaticCanvas } from "fabric";
+function computePrintAreaClip(area, scaleX, scaleY, targetWidth, targetHeight) {
+  const left = Math.max(0, Math.min(targetWidth, area.left * scaleX));
+  const top = Math.max(0, Math.min(targetHeight, area.top * scaleY));
+  const right = Math.max(left, Math.min(targetWidth, (area.left + area.width) * scaleX));
+  const bottom = Math.max(top, Math.min(targetHeight, (area.top + area.height) * scaleY));
+  return { left, top, width: right - left, height: bottom - top };
+}
+function computeCoverPlacement(sourceWidth, sourceHeight, targetWidth, targetHeight) {
+  if (sourceWidth <= 0 || sourceHeight <= 0 || targetWidth <= 0 || targetHeight <= 0) {
+    throw new Error("Cover dimensions must be positive");
+  }
+  const scale = Math.max(targetWidth / sourceWidth, targetHeight / sourceHeight);
+  const width = sourceWidth * scale;
+  const height = sourceHeight * scale;
+  return {
+    left: (targetWidth - width) / 2,
+    top: (targetHeight - height) / 2,
+    width,
+    height
+  };
+}
+function canvasElementToBlob(output, format, quality) {
+  const mime = format === "jpeg" ? "image/jpeg" : `image/${format}`;
+  return new Promise((resolve, reject) => {
+    output.toBlob(
+      (blob) => blob ? resolve(blob) : reject(new Error(`Failed to export ${format}`)),
+      mime,
+      quality
+    );
+  });
+}
+async function exportPNG(canvas, options = {}) {
+  const { multiplier = 1, format = "png", quality = 1 } = options;
+  const output = canvas.toCanvasElement(multiplier);
+  return canvasElementToBlob(output, format, quality);
+}
+async function exportIsolatedPNG(source, objects, options = {}) {
+  const element = source.lowerCanvasEl.ownerDocument.createElement("canvas");
+  const canvas = new StaticCanvas(element, {
+    width: options.width ?? source.getWidth(),
+    height: options.height ?? source.getHeight(),
+    backgroundColor: options.backgroundColor || void 0
+  });
+  try {
+    const clones = options.cloneObjects === false ? objects : await Promise.all(objects.map((object) => object.clone()));
+    if (clones.length) canvas.add(...clones);
+    if (options.backgroundImage) canvas.backgroundImage = await options.backgroundImage.clone();
+    canvas.requestRenderAll();
+    return await exportPNG(canvas, options);
+  } finally {
+    canvas.dispose();
+  }
+}
+async function exportMockup(canvas, mockup, options = {}) {
+  const { multiplier = 1, format = "png", quality = 1 } = options;
+  const design = canvas.toCanvasElement(multiplier);
+  const output = design.ownerDocument.createElement("canvas");
+  output.width = design.width;
+  output.height = design.height;
+  const context = output.getContext("2d");
+  if (!context) throw new Error("2D canvas context is unavailable");
+  const loadImage = (url) => new Promise((resolve, reject) => {
+    const element = new Image();
+    element.crossOrigin = "anonymous";
+    element.onload = () => resolve(element);
+    element.onerror = () => reject(new Error(`Failed to load mockup image: ${url}`));
+    element.src = url;
+  });
+  const drawCover = (image, targetContext = context) => {
+    const placement = computeCoverPlacement(
+      image.naturalWidth || image.width,
+      image.naturalHeight || image.height,
+      output.width,
+      output.height
+    );
+    targetContext.drawImage(
+      image,
+      placement.left,
+      placement.top,
+      placement.width,
+      placement.height
+    );
+  };
+  const scratch = [design];
+  try {
+    drawCover(await loadImage(mockup.image));
+    let compositedDesign = design;
+    if (mockup.displacement) {
+      const sourceContext = design.getContext("2d");
+      if (!sourceContext) throw new Error("2D design context is unavailable");
+      const mapCanvas = design.ownerDocument.createElement("canvas");
+      scratch.push(mapCanvas);
+      mapCanvas.width = design.width;
+      mapCanvas.height = design.height;
+      const mapContext = mapCanvas.getContext("2d");
+      if (!mapContext) throw new Error("2D displacement-map context is unavailable");
+      drawCover(await loadImage(mockup.displacement.image), mapContext);
+      const warped = design.ownerDocument.createElement("canvas");
+      scratch.push(warped);
+      warped.width = design.width;
+      warped.height = design.height;
+      const warpedContext = warped.getContext("2d");
+      if (!warpedContext) throw new Error("2D displaced-design context is unavailable");
+      let sourcePixels;
+      let mapPixels;
+      try {
+        sourcePixels = sourceContext.getImageData(0, 0, design.width, design.height).data;
+        mapPixels = mapContext.getImageData(0, 0, design.width, design.height).data;
+      } catch (error) {
+        throw new Error("Failed to apply mockup displacement map; verify image CORS access", {
+          cause: error
+        });
+      }
+      const pixels = displaceRgba(sourcePixels, mapPixels, design.width, design.height, {
+        ...mockup.displacement,
+        scaleX: (mockup.displacement.scaleX ?? 10) * multiplier,
+        scaleY: (mockup.displacement.scaleY ?? 10) * multiplier
+      });
+      const imageData = warpedContext.createImageData(design.width, design.height);
+      imageData.data.set(pixels);
+      warpedContext.putImageData(imageData, 0, 0);
+      compositedDesign = warped;
+    }
+    context.save();
+    if (mockup.printArea && mockup.clipToPrintArea !== false) {
+      const clip = computePrintAreaClip(
+        mockup.printArea,
+        output.width / canvas.getWidth(),
+        output.height / canvas.getHeight(),
+        output.width,
+        output.height
+      );
+      context.beginPath();
+      context.rect(clip.left, clip.top, clip.width, clip.height);
+      context.clip();
+    }
+    context.globalAlpha = Math.max(0, Math.min(1, mockup.designOpacity ?? 1));
+    context.globalCompositeOperation = !mockup.designBlendMode || mockup.designBlendMode === "normal" ? "source-over" : mockup.designBlendMode;
+    context.drawImage(compositedDesign, 0, 0);
+    context.restore();
+    if (mockup.overlay) {
+      context.save();
+      context.globalAlpha = Math.max(0, Math.min(1, mockup.overlay.opacity ?? 1));
+      context.globalCompositeOperation = mockup.overlay.blendMode === "normal" ? "source-over" : mockup.overlay.blendMode ?? "multiply";
+      drawCover(await loadImage(mockup.overlay.image));
+      context.restore();
+    }
+    return await canvasElementToBlob(output, format, quality);
+  } finally {
+    for (const element of scratch) {
+      element.width = 0;
+      element.height = 0;
+    }
+  }
+}
+function exportSVG(canvas) {
+  return canvas.toSVG();
+}
+function exportDataURL(canvas, format = "png", multiplier = 1) {
+  return canvas.toDataURL({ format, multiplier });
+}
+
+export {
+  displaceRgba,
+  computePrintAreaClip,
+  computeCoverPlacement,
+  exportPNG,
+  exportIsolatedPNG,
+  exportMockup,
+  exportSVG,
+  exportDataURL
+};
+//# sourceMappingURL=chunk-ORZZ6MGQ.mjs.map

package/dist/chunk-ORZZ6MGQ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/displacement.ts","../src/export.ts"],"sourcesContent":["import type { MockupDisplacement, MockupDisplacementChannel } from './types';\n\nconst CHANNEL_INDEX: Record<MockupDisplacementChannel, number> = {\n  red: 0,\n  green: 1,\n  blue: 2,\n  alpha: 3,\n};\n\nfunction finiteScale(value: number | undefined, fallback: number, label: string): number {\n  const resolved = value ?? fallback;\n  if (!Number.isFinite(resolved)) throw new Error(`${label} must be finite`);\n  return resolved;\n}\n\nfunction sample(\n  source: Uint8ClampedArray,\n  width: number,\n  height: number,\n  x: number,\n  y: number,\n  channel: number,\n): number {\n  const clampedX = Math.max(0, Math.min(width - 1, x));\n  const clampedY = Math.max(0, Math.min(height - 1, y));\n  const x0 = Math.floor(clampedX);\n  const y0 = Math.floor(clampedY);\n  const x1 = Math.min(width - 1, x0 + 1);\n  const y1 = Math.min(height - 1, y0 + 1);\n  const tx = clampedX - x0;\n  const ty = clampedY - y0;\n  const top =\n    source[(y0 * width + x0) * 4 + channel] * (1 - tx) +\n    source[(y0 * width + x1) * 4 + channel] * tx;\n  const bottom =\n    source[(y1 * width + x0) * 4 + channel] * (1 - tx) +\n    source[(y1 * width + x1) * 4 + channel] * tx;\n  return top * (1 - ty) + bottom * ty;\n}\n\n/**\n * Warp RGBA pixels with an equally sized channel map. A channel value of 128\n * is neutral; 0 and 255 move by the configured negative/positive maximum.\n */\nexport function displaceRgba(\n  source: Uint8ClampedArray,\n  map: Uint8ClampedArray,\n  width: number,\n  height: number,\n  options: Omit<MockupDisplacement, 'image'>,\n): Uint8ClampedArray {\n  if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0) {\n    throw new Error('Displacement dimensions must be positive integers');\n  }\n  const expectedLength = width * height * 4;\n  if (source.length !== expectedLength || map.length !== expectedLength) {\n    throw new Error('Displacement source and map must match the requested dimensions');\n  }\n\n  const scaleX = finiteScale(options.scaleX, 10, 'Displacement scaleX');\n  const scaleY = finiteScale(options.scaleY, 10, 'Displacement scaleY');\n  const channelX = CHANNEL_INDEX[options.channelX ?? 'red'];\n  const channelY = CHANNEL_INDEX[options.channelY ?? 'green'];\n  const output = new Uint8ClampedArray(expectedLength);\n\n  for (let y = 0; y < height; y += 1) {\n    for (let x = 0; x < width; x += 1) {\n      const offset = (y * width + x) * 4;\n      const sourceX = x + ((map[offset + channelX] - 128) / 127) * scaleX;\n      const sourceY = y + ((map[offset + channelY] - 128) / 127) * scaleY;\n      for (let channel = 0; channel < 4; channel += 1) {\n        output[offset + channel] = Math.round(\n          sample(source, width, height, sourceX, sourceY, channel),\n        );\n      }\n    }\n  }\n  return output;\n}\n","import { StaticCanvas } from 'fabric';\nimport type { Canvas, FabricObject, ImageFormat } from 'fabric';\nimport type { MockupConfig, MockupPrintArea } from './types';\nimport { displaceRgba } from './displacement';\n\nexport interface PngExportOptions {\n  multiplier?: number;\n  format?: ImageFormat;\n  quality?: number;\n}\n\nexport interface CoverPlacement {\n  left: number;\n  top: number;\n  width: number;\n  height: number;\n}\n\nexport function computePrintAreaClip(\n  area: MockupPrintArea,\n  scaleX: number,\n  scaleY: number,\n  targetWidth: number,\n  targetHeight: number,\n): MockupPrintArea {\n  const left = Math.max(0, Math.min(targetWidth, area.left * scaleX));\n  const top = Math.max(0, Math.min(targetHeight, area.top * scaleY));\n  const right = Math.max(left, Math.min(targetWidth, (area.left + area.width) * scaleX));\n  const bottom = Math.max(top, Math.min(targetHeight, (area.top + area.height) * scaleY));\n  return { left, top, width: right - left, height: bottom - top };\n}\n\n/** Object-fit: cover geometry, exported for deterministic preview/composite tests. */\nexport function computeCoverPlacement(\n  sourceWidth: number,\n  sourceHeight: number,\n  targetWidth: number,\n  targetHeight: number,\n): CoverPlacement {\n  if (sourceWidth <= 0 || sourceHeight <= 0 || targetWidth <= 0 || targetHeight <= 0) {\n    throw new Error('Cover dimensions must be positive');\n  }\n  const scale = Math.max(targetWidth / sourceWidth, targetHeight / sourceHeight);\n  const width = sourceWidth * scale;\n  const height = sourceHeight * scale;\n  return {\n    left: (targetWidth - width) / 2,\n    top: (targetHeight - height) / 2,\n    width,\n    height,\n  };\n}\n\nfunction canvasElementToBlob(\n  output: HTMLCanvasElement,\n  format: ImageFormat,\n  quality: number,\n): Promise<Blob> {\n  const mime = format === 'jpeg' ? 'image/jpeg' : `image/${format}`;\n  return new Promise<Blob>((resolve, reject) => {\n    output.toBlob(\n      (blob) => (blob ? resolve(blob) : reject(new Error(`Failed to export ${format}`))),\n      mime,\n      quality,\n    );\n  });\n}\n\nexport async function exportPNG(canvas: Canvas, options: PngExportOptions = {}): Promise<Blob> {\n  const { multiplier = 1, format = 'png' as ImageFormat, quality = 1 } = options;\n  const output = canvas.toCanvasElement(multiplier);\n  return canvasElementToBlob(output, format, quality);\n}\n\n/** Render cloned objects without mutating the live editor canvas. */\nexport async function exportIsolatedPNG(\n  source: Canvas,\n  objects: FabricObject[],\n  options: PngExportOptions & {\n    width?: number;\n    height?: number;\n    backgroundColor?: string;\n    backgroundImage?: FabricObject | null;\n    cloneObjects?: boolean;\n  } = {},\n): Promise<Blob> {\n  const element = source.lowerCanvasEl.ownerDocument.createElement('canvas');\n  const canvas = new StaticCanvas(element, {\n    width: options.width ?? source.getWidth(),\n    height: options.height ?? source.getHeight(),\n    backgroundColor: options.backgroundColor || undefined,\n  });\n  try {\n    const clones =\n      options.cloneObjects === false\n        ? objects\n        : await Promise.all(objects.map((object) => object.clone()));\n    if (clones.length) canvas.add(...clones);\n    if (options.backgroundImage) canvas.backgroundImage = await options.backgroundImage.clone();\n    canvas.requestRenderAll();\n    // Awaited, not returned: `finally` would otherwise dispose the canvas while\n    // the export is still reading from it.\n    return await exportPNG(canvas as unknown as Canvas, options);\n  } finally {\n    canvas.dispose();\n  }\n}\n\n/** Rasterize the browser mockup preview together with the transparent design. */\nexport async function exportMockup(\n  canvas: Canvas,\n  mockup: MockupConfig,\n  options: PngExportOptions = {},\n): Promise<Blob> {\n  const { multiplier = 1, format = 'png' as ImageFormat, quality = 1 } = options;\n  const design = canvas.toCanvasElement(multiplier);\n  const output = design.ownerDocument.createElement('canvas');\n  output.width = design.width;\n  output.height = design.height;\n  const context = output.getContext('2d');\n  if (!context) throw new Error('2D canvas context is unavailable');\n\n  const loadImage = (url: string) =>\n    new Promise<HTMLImageElement>((resolve, reject) => {\n      const element = new Image();\n      element.crossOrigin = 'anonymous';\n      element.onload = () => resolve(element);\n      element.onerror = () => reject(new Error(`Failed to load mockup image: ${url}`));\n      element.src = url;\n    });\n  const drawCover = (\n    image: HTMLImageElement,\n    targetContext: CanvasRenderingContext2D = context,\n  ) => {\n    const placement = computeCoverPlacement(\n      image.naturalWidth || image.width,\n      image.naturalHeight || image.height,\n      output.width,\n      output.height,\n    );\n    targetContext.drawImage(\n      image,\n      placement.left,\n      placement.top,\n      placement.width,\n      placement.height,\n    );\n  };\n\n  // Full-size scratch buffers, released explicitly in the finally below: a\n  // detached canvas element can hold its backing store well past its last\n  // reference, and a 4K mockup allocates three of them per export.\n  const scratch: HTMLCanvasElement[] = [design];\n  try {\n    drawCover(await loadImage(mockup.image));\n    let compositedDesign: CanvasImageSource = design;\n    if (mockup.displacement) {\n      const sourceContext = design.getContext('2d');\n      if (!sourceContext) throw new Error('2D design context is unavailable');\n      const mapCanvas = design.ownerDocument.createElement('canvas');\n      scratch.push(mapCanvas);\n      mapCanvas.width = design.width;\n      mapCanvas.height = design.height;\n      const mapContext = mapCanvas.getContext('2d');\n      if (!mapContext) throw new Error('2D displacement-map context is unavailable');\n      drawCover(await loadImage(mockup.displacement.image), mapContext);\n\n      const warped = design.ownerDocument.createElement('canvas');\n      scratch.push(warped);\n      warped.width = design.width;\n      warped.height = design.height;\n      const warpedContext = warped.getContext('2d');\n      if (!warpedContext) throw new Error('2D displaced-design context is unavailable');\n      let sourcePixels: Uint8ClampedArray;\n      let mapPixels: Uint8ClampedArray;\n      try {\n        sourcePixels = sourceContext.getImageData(0, 0, design.width, design.height).data;\n        mapPixels = mapContext.getImageData(0, 0, design.width, design.height).data;\n      } catch (error) {\n        throw new Error('Failed to apply mockup displacement map; verify image CORS access', {\n          cause: error,\n        });\n      }\n      const pixels = displaceRgba(sourcePixels, mapPixels, design.width, design.height, {\n        ...mockup.displacement,\n        scaleX: (mockup.displacement.scaleX ?? 10) * multiplier,\n        scaleY: (mockup.displacement.scaleY ?? 10) * multiplier,\n      });\n      const imageData = warpedContext.createImageData(design.width, design.height);\n      imageData.data.set(pixels);\n      warpedContext.putImageData(imageData, 0, 0);\n      compositedDesign = warped;\n    }\n    context.save();\n    if (mockup.printArea && mockup.clipToPrintArea !== false) {\n      const clip = computePrintAreaClip(\n        mockup.printArea,\n        output.width / canvas.getWidth(),\n        output.height / canvas.getHeight(),\n        output.width,\n        output.height,\n      );\n      context.beginPath();\n      context.rect(clip.left, clip.top, clip.width, clip.height);\n      context.clip();\n    }\n    context.globalAlpha = Math.max(0, Math.min(1, mockup.designOpacity ?? 1));\n    context.globalCompositeOperation =\n      !mockup.designBlendMode || mockup.designBlendMode === 'normal'\n        ? 'source-over'\n        : mockup.designBlendMode;\n    context.drawImage(compositedDesign, 0, 0);\n    context.restore();\n\n    if (mockup.overlay) {\n      context.save();\n      context.globalAlpha = Math.max(0, Math.min(1, mockup.overlay.opacity ?? 1));\n      context.globalCompositeOperation =\n        mockup.overlay.blendMode === 'normal'\n          ? 'source-over'\n          : (mockup.overlay.blendMode ?? 'multiply');\n      drawCover(await loadImage(mockup.overlay.image));\n      context.restore();\n    }\n    return await canvasElementToBlob(output, format, quality);\n  } finally {\n    for (const element of scratch) {\n      element.width = 0;\n      element.height = 0;\n    }\n  }\n}\n\nexport function exportSVG(canvas: Canvas): string {\n  return canvas.toSVG();\n}\n\nexport function exportDataURL(canvas: Canvas, format: ImageFormat = 'png', multiplier = 1): string {\n  return canvas.toDataURL({ format, multiplier });\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { Canvas, FabricObject, ImageFormat } from 'fabric';
-import { b as EditorEvents, l as LayerType, k as LayerMeta, L as LayerData, S as SerializedLayer, t as PatternSourceResolver, P as PatternConfig, s as PatternLocks, U as Unit, r as MockupPrintArea, p as MockupConfig, e as FontDefinition, m as LicenseConfig, o as LicenseStatus, y as ProjectState, E as EditorConfig, z as ShapePlugin, T as TemplateDefinition, I as ImageAdjustments, c as EditorState, A as SvgExportOptions, w as PrintifyPositioning, N as NormalizedLayerPosition, v as PositioningAdapter, h as ImageProviderResult, i as ImageSearchOptions, j as ImageSearchResult, F as FileAdapter, g as ImageProvider, B as BackgroundImageOptions, R as ResizeOptions, a as DpiIssue, C as CanvasSizePreset } from './types-bOY7oYVq.mjs';
-export { D as DEFAULT_PATTERN_CONFIG, d as ExportFormat, f as ImageAttribution, n as LicensePayload, M as MockupBlendMode, q as MockupOverlay, u as PatternState, x as ProjectPage, G as TemplateParameter, H as TileMode } from './types-bOY7oYVq.mjs';
+import { b as EditorEvents, l as LayerType, k as LayerMeta, L as LayerData, U as SerializedLayer, G as PatternSourceResolver, P as PatternConfig, A as PatternLocks, _ as Unit, z as MockupPrintArea, v as MockupConfig, e as FontDefinition, m as LicenseConfig, o as LicenseStatus, Q as ProjectState, M as MaskBrushOptions, p as MaskPoint, r as MaskRefinementProvider, q as MaskRefinementPrompt, t as MaskRefinementResult, E as EditorConfig, V as ShapePlugin, X as TemplateDefinition, I as ImageAdjustments, c as EditorState, S as SemanticExportOptions, W as SvgExportOptions, K as PrintifyPositioning, N as NormalizedLayerPosition, J as PositioningAdapter, h as ImageProviderResult, i as ImageSearchOptions, j as ImageSearchResult, F as FileAdapter, g as ImageProvider, T as SerializedBackgroundImageOptions, B as BackgroundImageOptions, R as ResizeOptions, a as DpiIssue, C as CanvasSizePreset, w as MockupDisplacement } from './types-D60CfxL9.mjs';
+export { D as DEFAULT_PATTERN_CONFIG, d as ExportFormat, f as ImageAttribution, n as LicensePayload, s as MaskRefinementRequest, u as MockupBlendMode, x as MockupDisplacementChannel, y as MockupOverlay, H as PatternState, O as ProjectPage, Y as TemplateParameter, Z as TileMode } from './types-D60CfxL9.mjs';
 
 type EventHandler<T> = (data: T) => void;
 declare class EventEmitter<TEvents extends {} = Record<string, unknown>> {
@@ -53,8 +53,12 @@ declare class LayerManager {
 }
 
 declare class HistoryManager {
+    private static readonly ASSET_KEY;
     private undoStack;
     private redoStack;
+    private assets;
+    private assetIds;
+    private nextAssetId;
     private maxSize;
     private maxBytes;
     private paused;
@@ -94,6 +98,21 @@ declare class HistoryManager {
     private emitChanged;
     private snapshotBytes;
     private trimToBudget;
+    /**
+     * History is internal and can content-address large raster strings without
+     * changing the public EditorState wire format. Unchanged images are retained
+     * once even when dozens of snapshots reference them.
+     */
+    private compactState;
+    private expandState;
+    /**
+     * Runs on every commit, so it scans for the serialized reference marker
+     * instead of re-parsing every snapshot — parsing multi-megabyte raster states
+     * per save would cost more than the retention it reclaims. `JSON.stringify`
+     * emits the marker verbatim; the same text inside user data is escaped and
+     * therefore cannot match.
+     */
+    private pruneAssets;
 }
 
 /**
@@ -308,6 +327,60 @@ declare class ProjectManager {
     private emitChanged;
 }
 
+type MaskRefinementErrorCode = 'not-found' | 'cancelled' | 'provider' | 'invalid-result';
+declare class MaskRefinementError extends Error {
+    readonly code: MaskRefinementErrorCode;
+    readonly cause?: unknown | undefined;
+    constructor(code: MaskRefinementErrorCode, message: string, cause?: unknown | undefined);
+}
+interface MaskPerformanceSample {
+    width: number;
+    height: number;
+    backingBytes: number;
+    strokeBackupBytes: number;
+    estimatedPeakBytes: number;
+    historyBytes: number;
+    interactionLatencyMs: number;
+    usedJsHeapBytes?: number;
+    elapsedMs: number;
+}
+/** Raster-mask editing without exposing Fabric brush classes in the public contract. */
+declare class MaskController {
+    private readonly editor;
+    private backing;
+    private context;
+    private layerId;
+    private brush;
+    private previousPoint;
+    private strokeBackup;
+    private strokeStartedAt;
+    private lastInteractionLatencyMs;
+    private refinement;
+    private disposed;
+    constructor(editor: CanvasEditor);
+    create(width?: number, height?: number): Promise<Layer>;
+    attach(layerId: string): void;
+    beginStroke(options: MaskBrushOptions): void;
+    addPoint(point: MaskPoint): void;
+    endStroke(): Promise<void>;
+    cancelStroke(): void;
+    isStrokeActive(): boolean;
+    activeLayerId(): string | null;
+    detach(layerId?: string): void;
+    refine(layerId: string, provider: MaskRefinementProvider, prompts: MaskRefinementPrompt[], options?: {
+        signal?: AbortSignal;
+        onProgress?: (progress: number) => void;
+    }): Promise<MaskRefinementResult>;
+    cancelRefinement(): void;
+    measure(): MaskPerformanceSample | null;
+    dispose(): void;
+    private drawDot;
+    private makeCanvas;
+    private attachBacking;
+    private requireMask;
+    private assertActive;
+}
+
 declare class CanvasEditor {
     readonly canvas: Canvas;
     readonly layers: LayerManager;
@@ -320,12 +393,14 @@ declare class CanvasEditor {
     readonly fonts: FontRegistry;
     readonly licensing: LicenseManager;
     readonly pages: ProjectManager;
+    readonly masks: MaskController;
     private fileAdapter?;
     private imageProvider?;
     private zoomLevel;
     private mockup;
     private designBackground;
     private designBackgroundImage;
+    private backgroundImageOptions;
     constructor(canvasElement: HTMLCanvasElement, config: EditorConfig);
     addImage(url: string, options?: Partial<Record<string, unknown>>): Promise<Layer>;
     /** Replace an image source without changing its layer identity or visual transform. */
@@ -350,6 +425,10 @@ declare class CanvasEditor {
     toPNG(options?: PngExportOptions): Promise<Blob>;
     toJPEG(options?: Omit<PngExportOptions, 'format'>): Promise<Blob>;
     toWebP(options?: Omit<PngExportOptions, 'format'>): Promise<Blob>;
+    /** Export one layer in document coordinates or at its native image resolution. */
+    exportLayer(id: string, options?: SemanticExportOptions): Promise<Blob>;
+    /** Export only the configured document background, excluding design layers. */
+    exportBackground(options?: SemanticExportOptions): Promise<Blob>;
     private toRaster;
     toSVG(): string;
     toSVGAsync(options?: SvgExportOptions): Promise<string>;
@@ -377,9 +456,10 @@ declare class CanvasEditor {
     setBackground(color: string): void;
     getDesignBackground(): string;
     getDesignBackgroundImage(): FabricObject | null;
+    getBackgroundImageOptions(): SerializedBackgroundImageOptions | null;
     setBackgroundImage(url: string | null, options?: BackgroundImageOptions): Promise<void>;
     /** Used by state restoration and advanced integrations with an existing Fabric object. */
-    setBackgroundImageObject(image: FabricObject | null, save?: boolean): void;
+    setBackgroundImageObject(image: FabricObject | null, save?: boolean, options?: SerializedBackgroundImageOptions | null): void;
     setTransparentBackground(): void;
     resize(width: number, height: number, options?: ResizeOptions): void;
     /** Effective source resolution for an image at its current physical size. */
@@ -437,4 +517,77 @@ declare function deserializeEditor(editor: CanvasEditor, state: EditorState): Pr
 /** Common print and digital canvas sizes. */
 declare const CANVAS_SIZE_PRESETS: readonly CanvasSizePreset[];
 
-export { BackgroundImageOptions, CANVAS_SIZE_PRESETS, CanvasEditor, CanvasSizePreset, type CoverPlacement, CropController, DpiIssue, EditorConfig, EditorEvents, EditorState, EventEmitter, FileAdapter, FontDefinition, FontRegistry, HistoryManager, ImageAdjustments, ImageProvider, ImageProviderResult, ImageSearchOptions, ImageSearchResult, Layer, LayerData, LayerManager, LayerMeta, LayerType, LicenseConfig, LicenseManager, LicenseStatus, MockupConfig, MockupPrintArea, NormalizedLayerPosition, PatternConfig, PatternLocks, PatternManager, PatternSourceResolver, type PngExportOptions, PositioningAdapter, PrintifyPositioning, ProjectManager, ProjectState, ResizeOptions, SerializedLayer, ShapePlugin, SnapManager, SvgExportOptions, TemplateDefinition, type TilePlacement, Unit, UnitConverter, applyPatternLocks, buildPatternDataURL, captureLocks, clamp, clearPatternImageCache, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, drawTiles, escapeXml, exportDataURL, exportMockup, exportPNG, exportSVG, generateId, isCssColor, loadPatternImage, restoreLocks, round2, sanitizeSvg, serializeEditor };
+type AnnotationPrimitive = {
+    id: string;
+    type: 'point';
+    x: number;
+    y: number;
+    label?: string;
+} | {
+    id: string;
+    type: 'rectangle';
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    label?: string;
+} | {
+    id: string;
+    type: 'label';
+    x: number;
+    y: number;
+    text: string;
+} | {
+    id: string;
+    type: 'path';
+    points: Array<{
+        x: number;
+        y: number;
+    }>;
+    label?: string;
+};
+interface ViewportTransform {
+    zoom: number;
+    panX: number;
+    panY: number;
+    devicePixelRatio?: number;
+}
+/** Host-owned annotations that never enter editor layers, history, serialization, or exports. */
+declare class AnnotationOverlay {
+    private items;
+    private transform;
+    set(annotation: AnnotationPrimitive): void;
+    remove(id: string): boolean;
+    clear(): void;
+    getAll(): AnnotationPrimitive[];
+    setTransform(transform: ViewportTransform): void;
+    documentToViewport(point: {
+        x: number;
+        y: number;
+    }): {
+        x: number;
+        y: number;
+    };
+    viewportToDocument(point: {
+        x: number;
+        y: number;
+    }): {
+        x: number;
+        y: number;
+    };
+    documentToDevice(point: {
+        x: number;
+        y: number;
+    }): {
+        x: number;
+        y: number;
+    };
+}
+
+/**
+ * Warp RGBA pixels with an equally sized channel map. A channel value of 128
+ * is neutral; 0 and 255 move by the configured negative/positive maximum.
+ */
+declare function displaceRgba(source: Uint8ClampedArray, map: Uint8ClampedArray, width: number, height: number, options: Omit<MockupDisplacement, 'image'>): Uint8ClampedArray;
+
+export { AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, CANVAS_SIZE_PRESETS, CanvasEditor, CanvasSizePreset, type CoverPlacement, CropController, DpiIssue, EditorConfig, EditorEvents, EditorState, EventEmitter, FileAdapter, FontDefinition, FontRegistry, HistoryManager, ImageAdjustments, ImageProvider, ImageProviderResult, ImageSearchOptions, ImageSearchResult, Layer, LayerData, LayerManager, LayerMeta, LayerType, LicenseConfig, LicenseManager, LicenseStatus, MaskBrushOptions, MaskController, type MaskPerformanceSample, MaskPoint, MaskRefinementError, type MaskRefinementErrorCode, MaskRefinementPrompt, MaskRefinementProvider, MaskRefinementResult, MockupConfig, MockupDisplacement, MockupPrintArea, NormalizedLayerPosition, PatternConfig, PatternLocks, PatternManager, PatternSourceResolver, type PngExportOptions, PositioningAdapter, PrintifyPositioning, ProjectManager, ProjectState, ResizeOptions, SemanticExportOptions, SerializedBackgroundImageOptions, SerializedLayer, ShapePlugin, SnapManager, SvgExportOptions, TemplateDefinition, type TilePlacement, Unit, UnitConverter, type ViewportTransform, applyPatternLocks, buildPatternDataURL, captureLocks, clamp, clearPatternImageCache, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, drawTiles, escapeXml, exportDataURL, exportMockup, exportPNG, exportSVG, generateId, isCssColor, loadPatternImage, restoreLocks, round2, sanitizeSvg, serializeEditor };