@bensitu/image-editor 1.2.2 → 1.3.1

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.1",
     "description": "Lightweight canvas-based image editor",
     "main": "./dist/image-editor.js",
     "module": "./dist/image-editor.esm.mjs",
@@ -16,7 +16,7 @@
         "dev": "node esbuild.config.mjs --watch",
         "build": "node esbuild.config.mjs",
         "build:babel": "babel src --out-dir dist --copy-files",
-        "lint": "eslint src --ext .js",
+        "lint": "eslint src",
         "test": "npm run build && node --test tests/image-editor.test.mjs tests/package.test.mjs"
     },
     "repository": {
@@ -33,6 +33,9 @@
     "peerDependencies": {
         "fabric": "^5.5.2"
     },
+    "overrides": {
+        "canvas": "^3.2.3"
+    },
     "publishConfig": {
         "access": "public"
     },
@@ -40,9 +43,11 @@
         "@babel/cli": "^7.22.9",
         "@babel/core": "^7.22.9",
         "@babel/preset-env": "^7.22.9",
-        "esbuild": "^0.19.12",
+        "@eslint/js": "^10.0.1",
+        "esbuild": "^0.28.0",
         "esbuild-plugin-babel": "^0.2.3",
-        "eslint": "^8.49.0"
+        "eslint": "^10.4.0",
+        "globals": "^17.6.0"
     },
     "browserslist": [
         "Chrome >= 100",