@bensitu/image-editor 1.2.2 → 1.3.0

package/image-editor.d.ts

@@ -4,13 +4,16 @@ declare module '@bensitu/image-editor' {
   import { Canvas, Image as FabricImage, Object as FabricObject } from 'fabric';
 
   export interface LabelOptions {
-    getText?: (mask: MaskObject, maskIndex: number) => string;
+    /** Receives the mask and its stable zero-based creation index (`mask.maskId - 1`). */
+    getText?: (mask: MaskObject, creationIndex: number) => string;
     create?: (mask: MaskObject, fabric: any) => FabricObject;
     textOptions?: Record<string, any>;
   }
 
   export interface CropOptions {
+    /** Minimum crop rectangle width, clamped to the current image bounds. */
     minWidth?: number;
+    /** Minimum crop rectangle height, clamped to the current image bounds. */
     minHeight?: number;
     padding?: number;
     hideMasksDuringCrop?: boolean;
@@ -36,6 +39,7 @@ declare module '@bensitu/image-editor' {
     downsampleMaxWidth?: number;
     downsampleMaxHeight?: number;
     downsampleQuality?: number;
+    imageLoadTimeoutMs?: number;
 
     exportMultiplier?: number;
     exportImageAreaByDefault?: boolean;
@@ -95,7 +99,7 @@ declare module '@bensitu/image-editor' {
     radius?: number | string | ((canvas: Canvas, options: ImageEditorOptions) => number);
     rx?: number | string | ((canvas: Canvas, options: ImageEditorOptions) => number);
     ry?: number | string | ((canvas: Canvas, options: ImageEditorOptions) => number);
-    points?: Array<{ x: number; y: number }>;
+    points?: Array<{ x: number; y: number }> | Array<[number, number]>;
     color?: string;
     alpha?: number;
     gap?: number;
@@ -141,17 +145,21 @@ declare module '@bensitu/image-editor' {
     saveHistory?: boolean;
   }
 
+  export interface LoadImageOptions {
+    preserveScroll?: boolean;
+  }
+
   export class ImageEditor {
     readonly options: ImageEditorOptions;
     readonly canvas: Canvas | null;
     readonly canvasElement: HTMLCanvasElement | null;
     readonly containerElement: HTMLElement | null;
     readonly placeholderElement: HTMLElement | null;
-    /** @deprecated Use canvasElement instead. */
+    /** @deprecated Use canvasElement instead. This alias will be removed in v2.0.0. */
     readonly canvasEl: HTMLCanvasElement | null;
-    /** @deprecated Use containerElement instead. */
+    /** @deprecated Use containerElement instead. This alias will be removed in v2.0.0. */
     readonly containerEl: HTMLElement | null;
-    /** @deprecated Use placeholderElement instead. */
+    /** @deprecated Use placeholderElement instead. This alias will be removed in v2.0.0. */
     readonly placeholderEl: HTMLElement | null;
     readonly originalImage: FabricImage | null;
     readonly currentScale: number;
@@ -163,27 +171,29 @@ declare module '@bensitu/image-editor' {
     constructor(options?: ImageEditorOptions);
 
     init(idMap?: ElementIdMap): void;
-    loadImage(imageBase64: string): Promise<void>;
+    loadImage(imageBase64: string, options?: LoadImageOptions): Promise<void>;
     isImageLoaded(): boolean;
 
+    /** Public callers should pass only `factor`; internal history control options are intentionally not exposed. */
     scaleImage(factor: number): Promise<void>;
+    /** Public callers should pass only `degrees`; internal history control options are intentionally not exposed. */
     rotateImage(degrees: number): Promise<void>;
     resetImageTransform(): Promise<void>;
-    /** @deprecated Use resetImageTransform() instead. */
+    /** @deprecated Use resetImageTransform() instead. This alias will be removed in v2.0.0. */
     reset(): Promise<void>;
 
     createMask(config?: MaskConfig): MaskObject | null;
-    /** @deprecated Use createMask() instead. */
+    /** @deprecated Use createMask() instead. This alias will be removed in v2.0.0. */
     addMask(config?: MaskConfig): MaskObject | null;
     removeSelectedMask(): void;
     removeAllMasks(options?: RemoveAllMasksOptions): void;
 
     mergeMasks(): Promise<void>;
-    /** @deprecated Use mergeMasks() instead. */
+    /** @deprecated Use mergeMasks() instead. This alias will be removed in v2.0.0. */
     merge(): Promise<void>;
     downloadImage(fileName?: string): void;
     exportImageBase64(options?: Base64ExportOptions): Promise<string>;
-    /** @deprecated Use exportImageBase64() instead. */
+    /** @deprecated Use exportImageBase64() instead. This alias will be removed in v2.0.0. */
     getImageBase64(options?: Base64ExportOptions): Promise<string>;
     exportImageFile(options?: ImageFileExportOptions): Promise<File>;
 
@@ -194,7 +204,7 @@ declare module '@bensitu/image-editor' {
     undo(): Promise<void>;
     redo(): Promise<void>;
     saveState(): void;
-    loadFromState(jsonString: string | object): Promise<void>;
+    loadFromState(serializedState: string | object): Promise<void>;
 
     dispose(): void;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bensitu/image-editor",
-    "version": "1.2.2",
+    "version": "1.3.0",
     "description": "Lightweight canvas-based image editor",
     "main": "./dist/image-editor.js",
     "module": "./dist/image-editor.esm.mjs",