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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ilia Dzhiubanskii
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/chunk-NINRTPOJ.mjs

@@ -0,0 +1,104 @@
+// 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

@@ -0,0 +1 @@
+{"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":"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","names":[]}

package/dist/index.d.mts

@@ -1,221 +1,6 @@
-import { FabricObject, Canvas, ImageFormat } from 'fabric';
-
-type Unit = 'px' | 'mm' | 'in';
-type LayerType = 'image' | 'text' | 'shape' | 'template' | 'group';
-interface LayerData {
-    id: string;
-    type: LayerType;
-    name: string;
-    visible: boolean;
-    locked: boolean;
-    opacity: number;
-    /** Non-fabric metadata persisted with the layer (pattern config, etc). */
-    meta?: LayerMeta;
-}
-interface LayerMeta {
-    pattern?: PatternState;
-    [key: string]: unknown;
-}
-interface SerializedLayer extends LayerData {
-    fabricObject: Record<string, unknown>;
-}
-interface EditorState {
-    version: string;
-    canvas: {
-        width: number;
-        height: number;
-    };
-    layers: SerializedLayer[];
-    background?: string;
-    mockup?: MockupConfig | null;
-}
-interface EditorConfig {
-    width: number;
-    height: number;
-    backgroundColor?: string;
-    fileAdapter?: FileAdapter;
-    imageProvider?: ImageProvider;
-    preserveObjectStacking?: boolean;
-    unit?: Unit;
-    dpi?: number;
-}
-type ExportFormat = 'png' | 'svg' | 'json';
-interface FileAdapter {
-    save(data: Blob | string, filename: string, format: ExportFormat): Promise<string>;
-}
-interface ImageProviderResult {
-    url: string;
-    width: number;
-    height: number;
-}
-interface ImageProvider {
-    upload(file: File): Promise<ImageProviderResult>;
-    browse?(): Promise<ImageProviderResult | null>;
-}
-interface ShapePlugin {
-    name: string;
-    icon: string;
-    category?: string;
-    create(options?: Record<string, unknown>): FabricObject;
-}
-interface TemplateParameter {
-    key: string;
-    label: string;
-    type: 'text' | 'color' | 'number' | 'font';
-    default: string | number;
-}
-interface TemplateDefinition {
-    id: string;
-    name: string;
-    category: string;
-    svg: string;
-    parameters: TemplateParameter[];
-    preview?: string;
-}
-interface PrintifyPositioning {
-    x: number;
-    y: number;
-    scale: number;
-    angle: number;
-}
-type TileMode = 'grid' | 'brick-horizontal' | 'brick-vertical';
-interface PatternConfig {
-    mode: TileMode;
-    /**
-     * Tile size as a % of the source image's on-canvas size (100 = natural).
-     * Smaller values pack more repeats across the print area; larger values make
-     * fewer, bigger tiles. Independent of how the source layer was placed.
-     */
-    scale: number;
-    /** Extra horizontal gap between tiles, as % of tile width. */
-    horizontalSpacing: number;
-    /** Extra vertical gap between tiles, as % of tile height. */
-    verticalSpacing: number;
-    /** Rotation of the whole pattern, in degrees. */
-    angle: number;
-    /** Brick row/column shift, as % of tile size. */
-    horizontalOffset: number;
-    /**
-     * Phase shift of the whole tile grid inside the print area, as % of tile
-     * width. The pattern object itself is pinned to the print area (it can't be
-     * dragged — that would expose bare edges), so this is how the tiling is
-     * nudged into alignment. Clamped to ±100% so coverage is never broken.
-     */
-    offsetX: number;
-    /** Phase shift of the tile grid, as % of tile height. See {@link offsetX}. */
-    offsetY: number;
-    /** Added rotation per horizontal step, in degrees. */
-    rotationStepH: number;
-    /** Added rotation per vertical step, in degrees. */
-    rotationStepV: number;
-}
-/** Fabric interaction flags frozen while a layer is rendered as a pattern. */
-interface PatternLocks {
-    lockMovementX: boolean;
-    lockMovementY: boolean;
-    lockScalingX: boolean;
-    lockScalingY: boolean;
-    lockRotation: boolean;
-    hasControls: boolean;
-}
-/** Persisted on a layer's meta while it is rendered as a repeating pattern. */
-interface PatternState {
-    config: PatternConfig;
-    /** Original (pre-pattern) image source, as a durable data URL when possible. */
-    originalSrc: string;
-    /**
-     * Serialized `clipPath` the image carried before it became a pattern, or null
-     * if it had none. A pattern must fill the whole print area, so any pre-pattern
-     * clip (e.g. a template crop sized to the original box) is stripped while the
-     * pattern is on and re-applied when it is turned off. Persisted so it survives
-     * serialization / reload / undo.
-     */
-    originalClip?: Record<string, unknown> | null;
-    /**
-     * Interaction flags the object carried before it became a pattern. A pattern
-     * fills the whole print area, so while it is on the object is locked in place
-     * (a drag/resize would slide the tiled bitmap off the area and leave a bare
-     * band); the captured flags are restored when the pattern is turned off.
-     */
-    originalLocks?: PatternLocks;
-    /** Original fabric transform, restored when the pattern is turned off. */
-    original: {
-        left: number;
-        top: number;
-        scaleX: number;
-        scaleY: number;
-        width: number;
-        height: number;
-        angle: number;
-        cropX: number;
-        cropY: number;
-    };
-}
-declare const DEFAULT_PATTERN_CONFIG: PatternConfig;
-interface MockupPrintArea {
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-}
-interface MockupConfig {
-    /** Garment/product image rendered behind the design (preview only). */
-    image: string;
-    /** Print-area rectangle, in canvas pixels. Drawn as a guide. */
-    printArea?: MockupPrintArea;
-}
-interface EditorEvents {
-    'layer:added': {
-        layer: LayerData;
-    };
-    'layer:removed': {
-        layerId: string;
-    };
-    'layer:selected': {
-        layerId: string | null;
-    };
-    'layer:modified': {
-        layerId: string;
-    };
-    'layer:reordered': {
-        layerIds: string[];
-    };
-    'layers:changed': {
-        layers: LayerData[];
-    };
-    'selection:changed': {
-        selected: string[];
-    };
-    'history:changed': {
-        canUndo: boolean;
-        canRedo: boolean;
-    };
-    'zoom:changed': {
-        zoom: number;
-    };
-    'snap:changed': {
-        enabled: boolean;
-    };
-    'crop:changed': {
-        active: boolean;
-        layerId: string | null;
-    };
-    'mockup:changed': {
-        mockup: MockupConfig | null;
-    };
-    'canvas:modified': Record<string, never>;
-    'export:start': {
-        format: string;
-    };
-    'export:complete': {
-        format: string;
-        url?: string;
-    };
-    error: {
-        message: string;
-        error?: unknown;
-    };
-}
+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';
 
 type EventHandler<T> = (data: T) => void;
 declare class EventEmitter<TEvents extends {} = Record<string, unknown>> {
@@ -236,7 +21,7 @@ declare class Layer {
     opacity: number;
     /** Non-fabric data (e.g. pattern config) that must persist with the layer. */
     meta: LayerMeta;
-    readonly fabricObject: FabricObject;
+    fabricObject: FabricObject;
     constructor(type: LayerType, fabricObject: FabricObject, name?: string, id?: string);
     private hasMeta;
     toData(): LayerData;
@@ -246,9 +31,13 @@ declare class LayerManager {
     private canvas;
     private events;
     private layers;
+    private onPropertyChanged?;
     constructor(canvas: Canvas, events: EventEmitter<EditorEvents>);
+    setHistoryCallback(callback: () => void): void;
     add(type: LayerType, fabricObject: FabricObject, name?: string, id?: string): Layer;
     remove(id: string): boolean;
+    /** Replace a layer's render object while preserving its immutable ID and panel state. */
+    replaceObject(id: string, fabricObject: FabricObject): boolean;
     reorder(id: string, newIndex: number): boolean;
     select(id: string | null): void;
     get(id: string): Layer | undefined;
@@ -267,21 +56,28 @@ declare class HistoryManager {
     private undoStack;
     private redoStack;
     private maxSize;
+    private maxBytes;
     private paused;
     private debounceTimer;
     private debounceMs;
     private getState;
     private restoreState;
     private events;
+    private transactionDepth;
+    private transactionDirty;
     constructor(opts: {
         getState: () => string;
         restoreState: (state: string) => Promise<void>;
         events: EventEmitter<EditorEvents>;
         maxSize?: number;
+        maxBytes?: number;
         debounceMs?: number;
     });
     save(): void;
     saveImmediate(): void;
+    beginTransaction(): void;
+    endTransaction(): void;
+    transaction<T>(operation: () => T | Promise<T>): Promise<T>;
     undo(): Promise<void>;
     redo(): Promise<void>;
     /** True while a restore (undo/redo/deserialize) is in flight. Managers that
@@ -292,9 +88,12 @@ declare class HistoryManager {
     canUndo(): boolean;
     canRedo(): boolean;
     clear(): void;
+    getSnapshotBytes(): number;
     private cancelPending;
     dispose(): void;
     private emitChanged;
+    private snapshotBytes;
+    private trimToBudget;
 }
 
 /**
@@ -357,8 +156,10 @@ declare class PatternManager {
     private canvas;
     private layers;
     private history;
+    private events;
+    private sourceResolver?;
     private chains;
-    constructor(canvas: Canvas, layers: LayerManager, history: HistoryManager);
+    constructor(canvas: Canvas, layers: LayerManager, history: HistoryManager, events: EventEmitter<EditorEvents>, sourceResolver?: PatternSourceResolver | undefined);
     isPattern(layerId: string): boolean;
     getConfig(layerId: string): PatternConfig | null;
     /** Turn a plain image layer into a pattern, or update an existing one. */
@@ -388,6 +189,7 @@ declare function applyPatternLocks(obj: FabricObject): void;
  * leaving it frozen forever.
  */
 declare function restoreLocks(obj: FabricObject, locks: PatternLocks | undefined): void;
+declare function loadPatternImage(src: string, resolver?: PatternSourceResolver): Promise<HTMLImageElement>;
 /** Clear the decoded-image cache (e.g. on teardown). Exported for completeness. */
 declare function clearPatternImageCache(): void;
 /**
@@ -396,7 +198,7 @@ declare function clearPatternImageCache(): void;
  *
  * Exported for unit testing of the tile geometry.
  */
-declare function buildPatternDataURL(src: string, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number): Promise<string>;
+declare function buildPatternDataURL(src: string, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, sourceResolver?: PatternSourceResolver): Promise<string>;
 /** Placement of one tile, relative to the (already rotated) pattern centre. */
 interface TilePlacement {
     /** Tile-centre offset from the pattern centre, in px. */
@@ -442,10 +244,70 @@ interface PngExportOptions {
     format?: ImageFormat;
     quality?: number;
 }
+interface CoverPlacement {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+declare function computePrintAreaClip(area: MockupPrintArea, scaleX: number, scaleY: number, targetWidth: number, targetHeight: number): MockupPrintArea;
+/** Object-fit: cover geometry, exported for deterministic preview/composite tests. */
+declare function computeCoverPlacement(sourceWidth: number, sourceHeight: number, targetWidth: number, targetHeight: number): CoverPlacement;
 declare function exportPNG(canvas: Canvas, options?: PngExportOptions): Promise<Blob>;
+/** Rasterize the browser mockup preview together with the transparent design. */
+declare function exportMockup(canvas: Canvas, mockup: MockupConfig, options?: PngExportOptions): Promise<Blob>;
 declare function exportSVG(canvas: Canvas): string;
 declare function exportDataURL(canvas: Canvas, format?: ImageFormat, multiplier?: number): string;
 
+/** Browser font loader and SVG embedding registry. */
+declare class FontRegistry {
+    private definitions;
+    private loads;
+    register(definition: FontDefinition): void;
+    unregister(family: string): boolean;
+    getAll(): FontDefinition[];
+    load(family: string): Promise<FontFace>;
+    ready(): Promise<void>;
+    getEmbeddedCss(): Promise<string>;
+}
+
+/** Inert, honor-system licensing and usage seam; it never performs a network request. */
+declare class LicenseManager {
+    private config;
+    private status;
+    private readyPromise;
+    constructor(config?: LicenseConfig);
+    getStatus(): LicenseStatus;
+    ready(): Promise<LicenseStatus>;
+    hasFeature(feature: string): boolean;
+    track(name: string): void;
+    private validate;
+}
+
+/** Multi-page document state bound to one live editor canvas. */
+declare class ProjectManager {
+    private editor;
+    private pages;
+    private activePageId;
+    constructor(editor: CanvasEditor);
+    getAll(): Array<{
+        id: string;
+        name: string;
+    }>;
+    getActivePageId(): string;
+    add(name?: string, cloneCurrent?: boolean): string;
+    switchTo(id: string): Promise<boolean>;
+    duplicate(id: string): Promise<string | null>;
+    remove(id: string): Promise<boolean>;
+    rename(id: string, name: string): boolean;
+    reorder(id: string, newIndex: number): boolean;
+    toJSON(): ProjectState;
+    fromJSON(project: ProjectState): Promise<void>;
+    private saveCurrent;
+    private blankState;
+    private emitChanged;
+}
+
 declare class CanvasEditor {
     readonly canvas: Canvas;
     readonly layers: LayerManager;
@@ -455,16 +317,22 @@ declare class CanvasEditor {
     readonly snapping: SnapManager;
     readonly crop: CropController;
     readonly patterns: PatternManager;
+    readonly fonts: FontRegistry;
+    readonly licensing: LicenseManager;
+    readonly pages: ProjectManager;
     private fileAdapter?;
     private imageProvider?;
     private zoomLevel;
     private mockup;
     private designBackground;
+    private designBackgroundImage;
     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. */
+    replaceImageSource(layerId: string, url: string): Promise<Layer>;
     addText(text: string, options?: Partial<Record<string, unknown>>): Layer;
     addShape(plugin: ShapePlugin, options?: Record<string, unknown>): Layer;
-    addTemplate(template: TemplateDefinition, _params: Record<string, string | number>): Promise<Layer>;
+    addTemplate(template: TemplateDefinition, params: Record<string, string | number>): Promise<Layer>;
     removeLayer(id: string): void;
     selectLayer(id: string | null): void;
     getSelectedLayer(): Layer | null;
@@ -472,11 +340,22 @@ declare class CanvasEditor {
     flipLayer(id: string, axis: 'horizontal' | 'vertical'): void;
     /** Clone a layer (offset slightly) and select the copy. */
     duplicateLayer(id: string): Promise<Layer | null>;
+    applyImageAdjustments(layerId: string, adjustments: ImageAdjustments): boolean;
+    /** Combine two or more layers into a single editable group layer. */
+    groupLayers(ids: string[], name?: string): Promise<Layer | null>;
+    /** Restore a group created by groupLayers back to its original layer records. */
+    ungroupLayer(id: string): Promise<Layer[]>;
     toJSON(): EditorState;
     fromJSON(state: EditorState): Promise<void>;
     toPNG(options?: PngExportOptions): Promise<Blob>;
+    toJPEG(options?: Omit<PngExportOptions, 'format'>): Promise<Blob>;
+    toWebP(options?: Omit<PngExportOptions, 'format'>): Promise<Blob>;
+    private toRaster;
     toSVG(): string;
+    toSVGAsync(options?: SvgExportOptions): Promise<string>;
     toDataURL(format?: ImageFormat, multiplier?: number): string;
+    /** Export the current product-preview composite. Advanced warping is host-defined. */
+    toMockupImage(options?: PngExportOptions): Promise<Blob>;
     /**
      * Run an export with the configured design background applied, even when a
      * mockup preview has forced the live canvas transparent — so exports reflect
@@ -484,14 +363,34 @@ declare class CanvasEditor {
      */
     private withDesignBackground;
     toPrintifyPositioning(): Record<string, PrintifyPositioning>;
-    save(filename: string, format: 'png' | 'svg' | 'json'): Promise<string | undefined>;
+    /** Provider-neutral, ID-stable placement data in 0..1 canvas coordinates. */
+    toNormalizedPositioning(): NormalizedLayerPosition[];
+    toProviderPositioning<T>(adapter: PositioningAdapter<T>): T;
+    save(filename: string, format: 'png' | 'jpeg' | 'webp' | 'svg' | 'json'): Promise<string | undefined>;
     uploadImage(file: File): Promise<ImageProviderResult | undefined>;
     browseImages(): Promise<ImageProviderResult | null>;
+    searchImages(query: string, options?: ImageSearchOptions): Promise<ImageSearchResult | null>;
+    /** Track provider usage, then insert its hotlinked image as a normal layer. */
+    addProviderImage(image: ImageProviderResult, options?: Partial<Record<string, unknown>>): Promise<Layer>;
     setFileAdapter(adapter: FileAdapter): void;
     setImageProvider(provider: ImageProvider): void;
     setBackground(color: string): void;
     getDesignBackground(): string;
-    resize(width: number, height: number): void;
+    getDesignBackgroundImage(): FabricObject | 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;
+    setTransparentBackground(): void;
+    resize(width: number, height: number, options?: ResizeOptions): void;
+    /** Effective source resolution for an image at its current physical size. */
+    getImageDpi(layerId: string): number | null;
+    validateImageDpi(minimumDpi?: number): DpiIssue[];
+    /** Render a small data-URL preview without changing document dimensions. */
+    toThumbnail(maxWidth?: number, maxHeight?: number, format?: ImageFormat): string;
+    bringToFront(id: string): boolean;
+    sendToBack(id: string): boolean;
+    bringForward(id: string): boolean;
+    sendBackward(id: string): boolean;
     setZoom(level: number): void;
     /** @deprecated use setZoom — kept for backward compatibility. */
     zoom(level: number): void;
@@ -501,6 +400,8 @@ declare class CanvasEditor {
     resetZoom(): void;
     /** Fit the canvas inside a viewport (in px), accounting for padding. */
     zoomToFit(viewportWidth: number, viewportHeight: number, padding?: number): void;
+    /** Zoom until the current selection fills the artboard viewport. */
+    zoomToSelection(padding?: number): void;
     applyPattern(layerId: string, config: PatternConfig): Promise<void>;
     clearPattern(layerId: string): Promise<void>;
     setMockup(mockup: MockupConfig | null): void;
@@ -515,7 +416,25 @@ declare const generateId: () => string;
 declare function clamp(v: number, min: number, max: number): number;
 declare function round2(v: number): number;
 
+/** XML text/attribute escaping for values interpolated into an SVG document. */
+declare function escapeXml(value: string | number): string;
+/**
+ * Strip active and externally-loaded content from an SVG before it is parsed
+ * into canvas objects.
+ *
+ * This is the single implementation of the control — every path that turns
+ * untrusted SVG into layers must call it, so it is exported rather than
+ * re-declared per package.
+ */
+declare function sanitizeSvg(svg: string): string;
+
+/** True for values safe to use as a canvas/SVG colour. Empty means transparent. */
+declare function isCssColor(value: unknown, allowEmpty?: boolean): value is string;
+
 declare function serializeEditor(editor: CanvasEditor): EditorState;
 declare function deserializeEditor(editor: CanvasEditor, state: EditorState): Promise<void>;
 
-export { CanvasEditor, CropController, DEFAULT_PATTERN_CONFIG, type EditorConfig, type EditorEvents, type EditorState, EventEmitter, type ExportFormat, type FileAdapter, HistoryManager, type ImageProvider, type ImageProviderResult, Layer, type LayerData, LayerManager, type LayerMeta, type LayerType, type MockupConfig, type MockupPrintArea, type PatternConfig, type PatternLocks, PatternManager, type PatternState, type PngExportOptions, type PrintifyPositioning, type SerializedLayer, type ShapePlugin, SnapManager, type TemplateDefinition, type TemplateParameter, type TileMode, type TilePlacement, type Unit, UnitConverter, applyPatternLocks, buildPatternDataURL, captureLocks, clamp, clearPatternImageCache, computeTilePositions, deserializeEditor, drawTiles, exportDataURL, exportPNG, exportSVG, generateId, restoreLocks, round2, serializeEditor };
+/** 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 };