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

package/dist/{types-bOY7oYVq.d.mts → types-Dh1unrzT.d.mts}

@@ -1,7 +1,7 @@
 import { FabricObject } from 'fabric';
 
 type Unit = 'px' | 'mm' | 'in';
-type LayerType = 'image' | 'text' | 'shape' | 'template' | 'group';
+type LayerType = 'image' | 'mask' | 'text' | 'shape' | 'template' | 'group';
 interface LayerData {
     id: string;
     type: LayerType;
@@ -14,8 +14,40 @@ interface LayerData {
 }
 interface LayerMeta {
     pattern?: PatternState;
+    mask?: {
+        width: number;
+        height: number;
+        revision: number;
+    };
+    /** Preset silhouette or texture the layer is clipped to. */
+    maskPreset?: MaskPresetId;
+    /** Baseline curve applied to a text layer. */
+    curve?: TextCurveConfig;
+    /** Text box width authored before a curve widened it, in px. */
+    curveWidth?: number;
+    /** Layer resizes uniformly: single-axis handles are hidden. */
+    lockAspect?: boolean;
     [key: string]: unknown;
 }
+interface TextCurveConfig {
+    /**
+     * Baseline bend, −100…100. Positive arcs the run upward (a rainbow),
+     * negative into a valley; ±100 closes it into a full ring. 0 is straight.
+     */
+    arc: number;
+    /** Sine-wave amplitude, 0…100, as a share of the font size. Ignored when arced. */
+    wave: number;
+}
+type ShapeMaskPresetId = 'circle' | 'square' | 'triangle' | 'star' | 'heart' | 'octagram' | 'arch' | 'zigzag';
+type TextureMaskPresetId = 'vignette' | 'halftone' | 'spray' | 'grunge' | 'torn' | 'band';
+type MaskPresetId = ShapeMaskPresetId | TextureMaskPresetId;
+interface LayerShadowConfig {
+    enabled: boolean;
+    color: string;
+    blur: number;
+    offsetX: number;
+    offsetY: number;
+}
 interface SerializedLayer extends LayerData {
     fabricObject: Record<string, unknown>;
 }
@@ -30,6 +62,7 @@ interface EditorState {
     layers: SerializedLayer[];
     background?: string;
     backgroundImage?: Record<string, unknown> | null;
+    backgroundImageOptions?: SerializedBackgroundImageOptions | null;
     mockup?: MockupConfig | null;
 }
 interface EditorConfig {
@@ -54,6 +87,63 @@ interface ResizeOptions {
 interface BackgroundImageOptions {
     fit?: 'cover' | 'contain' | 'stretch';
     opacity?: number;
+    /** Fabric/HTML image loading mode for remote assets. */
+    crossOrigin?: '' | 'anonymous' | 'use-credentials' | null;
+    /** Cancels the current load; never serialized. */
+    signal?: AbortSignal;
+}
+type SerializedBackgroundImageOptions = Omit<BackgroundImageOptions, 'signal'>;
+interface SemanticExportOptions extends PngLikeExportOptions {
+    /** Document keeps full-canvas coordinates; source returns native image pixels. */
+    resolution?: 'document' | 'source';
+}
+interface MaskPoint {
+    x: number;
+    y: number;
+}
+interface MaskBrushOptions {
+    mode: 'add' | 'subtract';
+    size: number;
+    /** Soft-edge inner radius ratio, from 0 (soft) to 1 (hard). */
+    hardness: number;
+}
+type MaskRefinementPrompt = {
+    type: 'point';
+    x: number;
+    y: number;
+    label: 'foreground' | 'background';
+} | {
+    type: 'rectangle';
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+} | {
+    type: 'text';
+    value: string;
+};
+interface MaskRefinementRequest {
+    mask: string;
+    width: number;
+    height: number;
+    prompts: MaskRefinementPrompt[];
+}
+interface MaskRefinementResult {
+    dataUrl: string;
+    width?: number;
+    height?: number;
+    metadata?: Record<string, unknown>;
+}
+interface MaskRefinementProvider {
+    refine(request: MaskRefinementRequest, options?: {
+        signal?: AbortSignal;
+        onProgress?: (progress: number) => void;
+    }): Promise<MaskRefinementResult>;
+}
+/** Kept structural to avoid coupling the public types module to export.ts. */
+interface PngLikeExportOptions {
+    multiplier?: number;
+    quality?: number;
 }
 interface DpiIssue {
     layerId: string;
@@ -303,6 +393,19 @@ interface MockupOverlay {
     blendMode?: MockupBlendMode;
     opacity?: number;
 }
+type MockupDisplacementChannel = 'red' | 'green' | 'blue' | 'alpha';
+interface MockupDisplacement {
+    /** Channel-map image cover-fitted to the mockup canvas. A value of 128 is neutral. */
+    image: string;
+    /** Maximum horizontal displacement in document pixels. Defaults to 10. */
+    scaleX?: number;
+    /** Maximum vertical displacement in document pixels. Defaults to 10. */
+    scaleY?: number;
+    /** Map channel controlling horizontal displacement. Defaults to red. */
+    channelX?: MockupDisplacementChannel;
+    /** Map channel controlling vertical displacement. Defaults to green. */
+    channelY?: MockupDisplacementChannel;
+}
 interface MockupConfig {
     /** Garment/product image rendered behind the design. */
     image: string;
@@ -312,6 +415,8 @@ interface MockupConfig {
     clipToPrintArea?: boolean;
     designBlendMode?: MockupBlendMode;
     designOpacity?: number;
+    /** Optional channel-map warp applied to the design before compositing. */
+    displacement?: MockupDisplacement;
     /** Optional product lighting/shadow pass rendered after the design. */
     overlay?: MockupOverlay;
 }
@@ -380,4 +485,4 @@ interface EditorEvents {
     };
 }
 
-export { type SvgExportOptions as A, type BackgroundImageOptions as B, type CanvasSizePreset as C, DEFAULT_PATTERN_CONFIG as D, type EditorConfig as E, type FileAdapter as F, type TemplateParameter as G, type TileMode as H, type ImageAdjustments as I, type LayerData as L, type MockupBlendMode as M, type NormalizedLayerPosition as N, type PatternConfig as P, type ResizeOptions as R, type SerializedLayer as S, type TemplateDefinition as T, type Unit as U, type DpiIssue as a, type EditorEvents as b, type EditorState as c, type ExportFormat as d, type FontDefinition as e, type ImageAttribution as f, type ImageProvider as g, type ImageProviderResult as h, type ImageSearchOptions as i, type ImageSearchResult as j, type LayerMeta as k, type LayerType as l, type LicenseConfig as m, type LicensePayload as n, type LicenseStatus as o, type MockupConfig as p, type MockupOverlay as q, type MockupPrintArea as r, type PatternLocks as s, type PatternSourceResolver as t, type PatternState as u, type PositioningAdapter as v, type PrintifyPositioning as w, type ProjectPage as x, type ProjectState as y, type ShapePlugin as z };
+export { type TemplateParameter as $, type MockupOverlay as A, type BackgroundImageOptions as B, type CanvasSizePreset as C, DEFAULT_PATTERN_CONFIG as D, type EditorConfig as E, type FileAdapter as F, type MockupPrintArea as G, type PatternLocks as H, type ImageAdjustments as I, type PatternSourceResolver as J, type PatternState as K, type LayerData as L, type MaskBrushOptions as M, type NormalizedLayerPosition as N, type PositioningAdapter as O, type PatternConfig as P, type PrintifyPositioning as Q, type ProjectPage as R, type ProjectState as S, type ResizeOptions as T, type SemanticExportOptions as U, type SerializedBackgroundImageOptions as V, type SerializedLayer as W, type ShapeMaskPresetId as X, type ShapePlugin as Y, type SvgExportOptions as Z, type TemplateDefinition as _, type DpiIssue as a, type TextCurveConfig as a0, type TextureMaskPresetId as a1, type TileMode as a2, type Unit as a3, type EditorEvents as b, type EditorState as c, type ExportFormat as d, type FontDefinition as e, type ImageAttribution as f, type ImageProvider as g, type ImageProviderResult as h, type ImageSearchOptions as i, type ImageSearchResult as j, type LayerMeta as k, type LayerShadowConfig as l, type LayerType as m, type LicenseConfig as n, type LicensePayload as o, type LicenseStatus as p, type MaskPoint as q, type MaskPresetId as r, type MaskRefinementPrompt as s, type MaskRefinementProvider as t, type MaskRefinementRequest as u, type MaskRefinementResult as v, type MockupBlendMode as w, type MockupConfig as x, type MockupDisplacement as y, type MockupDisplacementChannel as z };

package/dist/{types-bOY7oYVq.d.ts → types-Dh1unrzT.d.ts}

@@ -1,7 +1,7 @@
 import { FabricObject } from 'fabric';
 
 type Unit = 'px' | 'mm' | 'in';
-type LayerType = 'image' | 'text' | 'shape' | 'template' | 'group';
+type LayerType = 'image' | 'mask' | 'text' | 'shape' | 'template' | 'group';
 interface LayerData {
     id: string;
     type: LayerType;
@@ -14,8 +14,40 @@ interface LayerData {
 }
 interface LayerMeta {
     pattern?: PatternState;
+    mask?: {
+        width: number;
+        height: number;
+        revision: number;
+    };
+    /** Preset silhouette or texture the layer is clipped to. */
+    maskPreset?: MaskPresetId;
+    /** Baseline curve applied to a text layer. */
+    curve?: TextCurveConfig;
+    /** Text box width authored before a curve widened it, in px. */
+    curveWidth?: number;
+    /** Layer resizes uniformly: single-axis handles are hidden. */
+    lockAspect?: boolean;
     [key: string]: unknown;
 }
+interface TextCurveConfig {
+    /**
+     * Baseline bend, −100…100. Positive arcs the run upward (a rainbow),
+     * negative into a valley; ±100 closes it into a full ring. 0 is straight.
+     */
+    arc: number;
+    /** Sine-wave amplitude, 0…100, as a share of the font size. Ignored when arced. */
+    wave: number;
+}
+type ShapeMaskPresetId = 'circle' | 'square' | 'triangle' | 'star' | 'heart' | 'octagram' | 'arch' | 'zigzag';
+type TextureMaskPresetId = 'vignette' | 'halftone' | 'spray' | 'grunge' | 'torn' | 'band';
+type MaskPresetId = ShapeMaskPresetId | TextureMaskPresetId;
+interface LayerShadowConfig {
+    enabled: boolean;
+    color: string;
+    blur: number;
+    offsetX: number;
+    offsetY: number;
+}
 interface SerializedLayer extends LayerData {
     fabricObject: Record<string, unknown>;
 }
@@ -30,6 +62,7 @@ interface EditorState {
     layers: SerializedLayer[];
     background?: string;
     backgroundImage?: Record<string, unknown> | null;
+    backgroundImageOptions?: SerializedBackgroundImageOptions | null;
     mockup?: MockupConfig | null;
 }
 interface EditorConfig {
@@ -54,6 +87,63 @@ interface ResizeOptions {
 interface BackgroundImageOptions {
     fit?: 'cover' | 'contain' | 'stretch';
     opacity?: number;
+    /** Fabric/HTML image loading mode for remote assets. */
+    crossOrigin?: '' | 'anonymous' | 'use-credentials' | null;
+    /** Cancels the current load; never serialized. */
+    signal?: AbortSignal;
+}
+type SerializedBackgroundImageOptions = Omit<BackgroundImageOptions, 'signal'>;
+interface SemanticExportOptions extends PngLikeExportOptions {
+    /** Document keeps full-canvas coordinates; source returns native image pixels. */
+    resolution?: 'document' | 'source';
+}
+interface MaskPoint {
+    x: number;
+    y: number;
+}
+interface MaskBrushOptions {
+    mode: 'add' | 'subtract';
+    size: number;
+    /** Soft-edge inner radius ratio, from 0 (soft) to 1 (hard). */
+    hardness: number;
+}
+type MaskRefinementPrompt = {
+    type: 'point';
+    x: number;
+    y: number;
+    label: 'foreground' | 'background';
+} | {
+    type: 'rectangle';
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+} | {
+    type: 'text';
+    value: string;
+};
+interface MaskRefinementRequest {
+    mask: string;
+    width: number;
+    height: number;
+    prompts: MaskRefinementPrompt[];
+}
+interface MaskRefinementResult {
+    dataUrl: string;
+    width?: number;
+    height?: number;
+    metadata?: Record<string, unknown>;
+}
+interface MaskRefinementProvider {
+    refine(request: MaskRefinementRequest, options?: {
+        signal?: AbortSignal;
+        onProgress?: (progress: number) => void;
+    }): Promise<MaskRefinementResult>;
+}
+/** Kept structural to avoid coupling the public types module to export.ts. */
+interface PngLikeExportOptions {
+    multiplier?: number;
+    quality?: number;
 }
 interface DpiIssue {
     layerId: string;
@@ -303,6 +393,19 @@ interface MockupOverlay {
     blendMode?: MockupBlendMode;
     opacity?: number;
 }
+type MockupDisplacementChannel = 'red' | 'green' | 'blue' | 'alpha';
+interface MockupDisplacement {
+    /** Channel-map image cover-fitted to the mockup canvas. A value of 128 is neutral. */
+    image: string;
+    /** Maximum horizontal displacement in document pixels. Defaults to 10. */
+    scaleX?: number;
+    /** Maximum vertical displacement in document pixels. Defaults to 10. */
+    scaleY?: number;
+    /** Map channel controlling horizontal displacement. Defaults to red. */
+    channelX?: MockupDisplacementChannel;
+    /** Map channel controlling vertical displacement. Defaults to green. */
+    channelY?: MockupDisplacementChannel;
+}
 interface MockupConfig {
     /** Garment/product image rendered behind the design. */
     image: string;
@@ -312,6 +415,8 @@ interface MockupConfig {
     clipToPrintArea?: boolean;
     designBlendMode?: MockupBlendMode;
     designOpacity?: number;
+    /** Optional channel-map warp applied to the design before compositing. */
+    displacement?: MockupDisplacement;
     /** Optional product lighting/shadow pass rendered after the design. */
     overlay?: MockupOverlay;
 }
@@ -380,4 +485,4 @@ interface EditorEvents {
     };
 }
 
-export { type SvgExportOptions as A, type BackgroundImageOptions as B, type CanvasSizePreset as C, DEFAULT_PATTERN_CONFIG as D, type EditorConfig as E, type FileAdapter as F, type TemplateParameter as G, type TileMode as H, type ImageAdjustments as I, type LayerData as L, type MockupBlendMode as M, type NormalizedLayerPosition as N, type PatternConfig as P, type ResizeOptions as R, type SerializedLayer as S, type TemplateDefinition as T, type Unit as U, type DpiIssue as a, type EditorEvents as b, type EditorState as c, type ExportFormat as d, type FontDefinition as e, type ImageAttribution as f, type ImageProvider as g, type ImageProviderResult as h, type ImageSearchOptions as i, type ImageSearchResult as j, type LayerMeta as k, type LayerType as l, type LicenseConfig as m, type LicensePayload as n, type LicenseStatus as o, type MockupConfig as p, type MockupOverlay as q, type MockupPrintArea as r, type PatternLocks as s, type PatternSourceResolver as t, type PatternState as u, type PositioningAdapter as v, type PrintifyPositioning as w, type ProjectPage as x, type ProjectState as y, type ShapePlugin as z };
+export { type TemplateParameter as $, type MockupOverlay as A, type BackgroundImageOptions as B, type CanvasSizePreset as C, DEFAULT_PATTERN_CONFIG as D, type EditorConfig as E, type FileAdapter as F, type MockupPrintArea as G, type PatternLocks as H, type ImageAdjustments as I, type PatternSourceResolver as J, type PatternState as K, type LayerData as L, type MaskBrushOptions as M, type NormalizedLayerPosition as N, type PositioningAdapter as O, type PatternConfig as P, type PrintifyPositioning as Q, type ProjectPage as R, type ProjectState as S, type ResizeOptions as T, type SemanticExportOptions as U, type SerializedBackgroundImageOptions as V, type SerializedLayer as W, type ShapeMaskPresetId as X, type ShapePlugin as Y, type SvgExportOptions as Z, type TemplateDefinition as _, type DpiIssue as a, type TextCurveConfig as a0, type TextureMaskPresetId as a1, type TileMode as a2, type Unit as a3, type EditorEvents as b, type EditorState as c, type ExportFormat as d, type FontDefinition as e, type ImageAttribution as f, type ImageProvider as g, type ImageProviderResult as h, type ImageSearchOptions as i, type ImageSearchResult as j, type LayerMeta as k, type LayerShadowConfig as l, type LayerType as m, type LicenseConfig as n, type LicensePayload as o, type LicenseStatus as p, type MaskPoint as q, type MaskPresetId as r, type MaskRefinementPrompt as s, type MaskRefinementProvider as t, type MaskRefinementRequest as u, type MaskRefinementResult as v, type MockupBlendMode as w, type MockupConfig as x, type MockupDisplacement as y, type MockupDisplacementChannel as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@overtone-art/canvas-editor-core",
-  "version": "0.2.7",
+  "version": "0.3.0",
   "description": "Abstract pluggable canvas editor built on Fabric.js",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -37,9 +37,44 @@
   },
   "dependencies": {
     "fabric": "^7.4.0",
-    "nanoid": "^5.1.5"
+    "nanoid": "^5.1.16"
+  },
+  "peerDependencies": {
+    "fontkit": "^2.0.4",
+    "pdf-lib": "^1.17.1",
+    "pdfkit": "^0.19.1",
+    "sharp": "^0.35.0",
+    "svg-to-pdfkit": "^0.1.8"
+  },
+  "peerDependenciesMeta": {
+    "fontkit": {
+      "optional": true
+    },
+    "pdf-lib": {
+      "optional": true
+    },
+    "pdfkit": {
+      "optional": true
+    },
+    "sharp": {
+      "optional": true
+    },
+    "svg-to-pdfkit": {
+      "optional": true
+    }
   },
   "devDependencies": {
+    "@types/node": "^22.12.0",
+    "@types/fontkit": "^2.0.9",
+    "@types/opentype.js": "^1.3.10",
+    "@types/pdfkit": "^0.17.6",
+    "@types/svg-to-pdfkit": "^0.1.4",
+    "fontkit": "^2.0.4",
+    "opentype.js": "^1.3.4",
+    "pdf-lib": "^1.17.1",
+    "pdfkit": "^0.19.1",
+    "sharp": "^0.35.0",
+    "svg-to-pdfkit": "^0.1.8",
     "tsup": "^8.4.0",
     "typescript": "^5.8.2",
     "vitest": "^3.2.1",
@@ -49,9 +84,11 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "lint": "eslint src/",
-    "type-check": "tsc --noEmit",
+    "lint": "eslint src/ acceptance/ vitest.config.ts vitest.acceptance.config.ts",
+    "type-check": "tsc --noEmit && tsc --noEmit -p tsconfig.acceptance.json",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "acceptance:print": "vitest run --config vitest.acceptance.config.ts acceptance/generate-print.test.ts"
   }
 }

package/dist/chunk-NINRTPOJ.mjs

@@ -1,104 +0,0 @@
-// src/export.ts
-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 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) => {
-    const placement = computeCoverPlacement(
-      image.naturalWidth || image.width,
-      image.naturalHeight || image.height,
-      output.width,
-      output.height
-    );
-    context.drawImage(image, placement.left, placement.top, placement.width, placement.height);
-  };
-  drawCover(await loadImage(mockup.image));
-  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(design, 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 canvasElementToBlob(output, format, quality);
-}
-function exportSVG(canvas) {
-  return canvas.toSVG();
-}
-function exportDataURL(canvas, format = "png", multiplier = 1) {
-  return canvas.toDataURL({ format, multiplier });
-}
-
-export {
-  computePrintAreaClip,
-  computeCoverPlacement,
-  exportPNG,
-  exportMockup,
-  exportSVG,
-  exportDataURL
-};
-//# sourceMappingURL=chunk-NINRTPOJ.mjs.map

package/dist/chunk-NINRTPOJ.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/export.ts"],"sourcesContent":["import type { Canvas, ImageFormat } from 'fabric';\nimport type { MockupConfig, MockupPrintArea } from './types';\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/** 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 = (image: HTMLImageElement) => {\n    const placement = computeCoverPlacement(\n      image.naturalWidth || image.width,\n      image.naturalHeight || image.height,\n      output.width,\n      output.height,\n    );\n    context.drawImage(image, placement.left, placement.top, placement.width, placement.height);\n  };\n\n  drawCover(await loadImage(mockup.image));\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(design, 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 canvasElementToBlob(output, format, quality);\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":";AAgBO,SAAS,qBACd,MACA,QACA,QACA,aACA,cACiB;AACjB,QAAM,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,aAAa,KAAK,OAAO,MAAM,CAAC;AAClE,QAAM,MAAM,KAAK,IAAI,GAAG,KAAK,IAAI,cAAc,KAAK,MAAM,MAAM,CAAC;AACjE,QAAM,QAAQ,KAAK,IAAI,MAAM,KAAK,IAAI,cAAc,KAAK,OAAO,KAAK,SAAS,MAAM,CAAC;AACrF,QAAM,SAAS,KAAK,IAAI,KAAK,KAAK,IAAI,eAAe,KAAK,MAAM,KAAK,UAAU,MAAM,CAAC;AACtF,SAAO,EAAE,MAAM,KAAK,OAAO,QAAQ,MAAM,QAAQ,SAAS,IAAI;AAChE;AAGO,SAAS,sBACd,aACA,cACA,aACA,cACgB;AAChB,MAAI,eAAe,KAAK,gBAAgB,KAAK,eAAe,KAAK,gBAAgB,GAAG;AAClF,UAAM,IAAI,MAAM,mCAAmC;AAAA,EACrD;AACA,QAAM,QAAQ,KAAK,IAAI,cAAc,aAAa,eAAe,YAAY;AAC7E,QAAM,QAAQ,cAAc;AAC5B,QAAM,SAAS,eAAe;AAC9B,SAAO;AAAA,IACL,OAAO,cAAc,SAAS;AAAA,IAC9B,MAAM,eAAe,UAAU;AAAA,IAC/B;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAAS,oBACP,QACA,QACA,SACe;AACf,QAAM,OAAO,WAAW,SAAS,eAAe,SAAS,MAAM;AAC/D,SAAO,IAAI,QAAc,CAAC,SAAS,WAAW;AAC5C,WAAO;AAAA,MACL,CAAC,SAAU,OAAO,QAAQ,IAAI,IAAI,OAAO,IAAI,MAAM,oBAAoB,MAAM,EAAE,CAAC;AAAA,MAChF;AAAA,MACA;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAEA,eAAsB,UAAU,QAAgB,UAA4B,CAAC,GAAkB;AAC7F,QAAM,EAAE,aAAa,GAAG,SAAS,OAAsB,UAAU,EAAE,IAAI;AACvE,QAAM,SAAS,OAAO,gBAAgB,UAAU;AAChD,SAAO,oBAAoB,QAAQ,QAAQ,OAAO;AACpD;AAGA,eAAsB,aACpB,QACA,QACA,UAA4B,CAAC,GACd;AACf,QAAM,EAAE,aAAa,GAAG,SAAS,OAAsB,UAAU,EAAE,IAAI;AACvE,QAAM,SAAS,OAAO,gBAAgB,UAAU;AAChD,QAAM,SAAS,OAAO,cAAc,cAAc,QAAQ;AAC1D,SAAO,QAAQ,OAAO;AACtB,SAAO,SAAS,OAAO;AACvB,QAAM,UAAU,OAAO,WAAW,IAAI;AACtC,MAAI,CAAC,QAAS,OAAM,IAAI,MAAM,kCAAkC;AAEhE,QAAM,YAAY,CAAC,QACjB,IAAI,QAA0B,CAAC,SAAS,WAAW;AACjD,UAAM,UAAU,IAAI,MAAM;AAC1B,YAAQ,cAAc;AACtB,YAAQ,SAAS,MAAM,QAAQ,OAAO;AACtC,YAAQ,UAAU,MAAM,OAAO,IAAI,MAAM,gCAAgC,GAAG,EAAE,CAAC;AAC/E,YAAQ,MAAM;AAAA,EAChB,CAAC;AACH,QAAM,YAAY,CAAC,UAA4B;AAC7C,UAAM,YAAY;AAAA,MAChB,MAAM,gBAAgB,MAAM;AAAA,MAC5B,MAAM,iBAAiB,MAAM;AAAA,MAC7B,OAAO;AAAA,MACP,OAAO;AAAA,IACT;AACA,YAAQ,UAAU,OAAO,UAAU,MAAM,UAAU,KAAK,UAAU,OAAO,UAAU,MAAM;AAAA,EAC3F;AAEA,YAAU,MAAM,UAAU,OAAO,KAAK,CAAC;AACvC,UAAQ,KAAK;AACb,MAAI,OAAO,aAAa,OAAO,oBAAoB,OAAO;AACxD,UAAM,OAAO;AAAA,MACX,OAAO;AAAA,MACP,OAAO,QAAQ,OAAO,SAAS;AAAA,MAC/B,OAAO,SAAS,OAAO,UAAU;AAAA,MACjC,OAAO;AAAA,MACP,OAAO;AAAA,IACT;AACA,YAAQ,UAAU;AAClB,YAAQ,KAAK,KAAK,MAAM,KAAK,KAAK,KAAK,OAAO,KAAK,MAAM;AACzD,YAAQ,KAAK;AAAA,EACf;AACA,UAAQ,cAAc,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,OAAO,iBAAiB,CAAC,CAAC;AACxE,UAAQ,2BACN,CAAC,OAAO,mBAAmB,OAAO,oBAAoB,WAClD,gBACA,OAAO;AACb,UAAQ,UAAU,QAAQ,GAAG,CAAC;AAC9B,UAAQ,QAAQ;AAEhB,MAAI,OAAO,SAAS;AAClB,YAAQ,KAAK;AACb,YAAQ,cAAc,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,OAAO,QAAQ,WAAW,CAAC,CAAC;AAC1E,YAAQ,2BACN,OAAO,QAAQ,cAAc,WACzB,gBACC,OAAO,QAAQ,aAAa;AACnC,cAAU,MAAM,UAAU,OAAO,QAAQ,KAAK,CAAC;AAC/C,YAAQ,QAAQ;AAAA,EAClB;AACA,SAAO,oBAAoB,QAAQ,QAAQ,OAAO;AACpD;AAEO,SAAS,UAAU,QAAwB;AAChD,SAAO,OAAO,MAAM;AACtB;AAEO,SAAS,cAAc,QAAgB,SAAsB,OAAO,aAAa,GAAW;AACjG,SAAO,OAAO,UAAU,EAAE,QAAQ,WAAW,CAAC;AAChD;","names":[]}