canvico-editor 1.0.2 → 2.0.0

package/dist/types.d.ts

@@ -26,6 +26,17 @@ export type CropModuleConfig = {
     /** Optional color for the semi-transparent overlay outside the crop area. */
     outsideOverlayColor?: string;
 };
+/**
+ * Configuration options for the Transform module.
+ */
+export type TransformModuleConfig = {
+    /** Optional CSS selector for rotate input (degrees). */
+    rotateInputSelector?: string;
+    /** Optional CSS selector for flip horizontal button. */
+    flipHorizontalButtonSelector?: string;
+    /** Optional CSS selector for flip vertical button. */
+    flipVerticalButtonSelector?: string;
+};
 /**
  * A container for all module-specific configuration options.
  */
@@ -34,7 +45,17 @@ export type ModuleConfig = {
     resize?: ResizeModuleConfig;
     /** Configuration for the Crop module. */
     crop?: CropModuleConfig;
+    /** Configuration for the Transform module. */
+    transform?: TransformModuleConfig;
+};
+export type CanvicoEditorErrorSource = "editor" | "dom" | "resize" | "crop" | "transform" | "validation" | "state";
+export type CanvicoEditorErrorReport = {
+    error: Error;
+    source: CanvicoEditorErrorSource;
+    operation?: string;
+    timestamp: Date;
 };
+export type CanvicoEditorErrorCallback = (report: CanvicoEditorErrorReport) => void;
 /**
  * The main configuration object for the CanvicoEditor.
  */
@@ -51,8 +72,20 @@ export type CanvicoEditorConfig = {
     clearCanvasButtonSelector: string;
     /** Optional maximum allowed file size in megabytes (MB). */
     maxFileSizeMB?: number;
+    /**
+     * When true, invalid module selectors throw during initialization
+     * (fail-fast behavior).
+     * When false, invalid module selectors disable only the affected module
+     * and report the error through the editor error pipeline.
+     * Defaults to `false`.
+     */
+    strictModuleSelectors?: boolean;
     /** Optional container for all module configurations. */
     modules?: ModuleConfig;
+    /** Optional callback to report handled runtime errors to host application. */
+    onError?: CanvicoEditorErrorCallback;
+    /** Controls whether handled errors are printed to console. Defaults to `true`. */
+    logErrorsToConsole?: boolean;
 };
 /**
  * The interface that all editor modules must implement.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,8CAA8C;IAC9C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,uBAAuB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B,4DAA4D;IAC5D,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yDAAyD;IACzD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,yCAAyC;IACzC,IAAI,CAAC,EAAE,gBAAgB,CAAC;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,sBAAsB,EAAE,MAAM,CAAC;IAC/B,+EAA+E;IAC/E,wBAAwB,EAAE,MAAM,CAAC;IACjC,0EAA0E;IAC1E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,yBAAyB,EAAE,MAAM,CAAC;IAClC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,OAAO,CAAC,EAAE,YAAY,CAAC;CAC1B,CAAC;AAEF;;GAEG;AAEH,MAAM,WAAW,OAAO;IACpB,sEAAsE;IACtE,IAAI,IAAI,IAAI,CAAC;IAEb,sEAAsE;IACtE,OAAO,IAAI,IAAI,CAAC;IAEhB,6GAA6G;IAC7G,QAAQ,IAAI,IAAI,CAAC;IAEjB,2EAA2E;IAC3E,UAAU,IAAI,IAAI,CAAC;IAEnB,sEAAsE;IACtE,OAAO,IAAI,MAAM,CAAC;IAElB,sHAAsH;IACtH,WAAW,CAAC,IAAI,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC7B,8CAA8C;IAC9C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,uBAAuB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B,4DAA4D;IAC5D,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yDAAyD;IACzD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,sDAAsD;IACtD,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,yCAAyC;IACzC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,GAAG,OAAO,CAAC;AAEnH,MAAM,MAAM,wBAAwB,GAAG;IACnC,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAC;AAEpF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,sBAAsB,EAAE,MAAM,CAAC;IAC/B,+EAA+E;IAC/E,wBAAwB,EAAE,MAAM,CAAC;IACjC,0EAA0E;IAC1E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,yBAAyB,EAAE,MAAM,CAAC;IAClC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,wDAAwD;IACxD,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,0BAA0B,CAAC;IACrC,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF;;GAEG;AAEH,MAAM,WAAW,OAAO;IACpB,sEAAsE;IACtE,IAAI,IAAI,IAAI,CAAC;IAEb,sEAAsE;IACtE,OAAO,IAAI,IAAI,CAAC;IAEhB,6GAA6G;IAC7G,QAAQ,IAAI,IAAI,CAAC;IAEjB,2EAA2E;IAC3E,UAAU,IAAI,IAAI,CAAC;IAEnB,sEAAsE;IACtE,OAAO,IAAI,MAAM,CAAC;IAElB,sHAAsH;IACtH,WAAW,CAAC,IAAI,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC"}

package/dist/utils/dom-manager.d.ts

@@ -25,6 +25,14 @@ export interface CropDOMElements {
     activateButton: HTMLButtonElement;
     applyButton: HTMLButtonElement;
 }
+/**
+ * Defines the DOM elements for the Transform module.
+ */
+export interface TransformDOMElements {
+    rotateInput?: HTMLInputElement;
+    flipHorizontalButton?: HTMLButtonElement;
+    flipVerticalButton?: HTMLButtonElement;
+}
 /**
  * Manages all DOM interactions for the CanvicoEditor.
  * It queries and validates the existence of all required and optional
@@ -37,7 +45,10 @@ export declare class DOMManager {
     readonly resizeElements?: ResizeDOMElements;
     /** Contains DOM elements for the crop module. Undefined if the module is not configured. */
     readonly cropElements?: CropDOMElements;
-    private errorHandler;
+    /** Contains DOM elements for the transform module. Undefined if the module is not configured. */
+    readonly transformElements?: TransformDOMElements;
+    private readonly errorHandler;
+    private readonly strictModuleSelectors;
     /**
      * Creates an instance of DOMManager.
      * @param config - The main editor configuration object containing CSS selectors.

package/dist/utils/dom-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom-manager.d.ts","sourceRoot":"","sources":["../../src/utils/dom-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,WAAW,CAAC;IACvB,cAAc,EAAE,gBAAgB,CAAC;IACjC,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,UAAU,EAAE,iBAAiB,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,cAAc,EAAE,iBAAiB,CAAC;IAClC,WAAW,EAAE,iBAAiB,CAAC;CAClC;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACnB,uDAAuD;IACvD,SAAgB,QAAQ,EAAE,eAAe,CAAC;IAE1C,8FAA8F;IAC9F,SAAgB,cAAc,CAAC,EAAE,iBAAiB,CAAC;IAEnD,4FAA4F;IAC5F,SAAgB,YAAY,CAAC,EAAE,eAAe,CAAC;IAE/C,OAAO,CAAC,YAAY,CAAe;IAEnC;;;;;OAKG;gBACS,MAAM,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY;IA8BnE;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;CAWnC"}
+{"version":3,"file":"dom-manager.d.ts","sourceRoot":"","sources":["../../src/utils/dom-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,WAAW,CAAC;IACvB,cAAc,EAAE,gBAAgB,CAAC;IACjC,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,UAAU,EAAE,iBAAiB,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,WAAW,EAAE,gBAAgB,CAAC;IAC9B,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,cAAc,EAAE,iBAAiB,CAAC;IAClC,WAAW,EAAE,iBAAiB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,oBAAoB,CAAC,EAAE,iBAAiB,CAAC;IACzC,kBAAkB,CAAC,EAAE,iBAAiB,CAAC;CAC1C;AAED;;;;GAIG;AACH,qBAAa,UAAU;IACnB,uDAAuD;IACvD,SAAgB,QAAQ,EAAE,eAAe,CAAC;IAE1C,8FAA8F;IAC9F,SAAgB,cAAc,CAAC,EAAE,iBAAiB,CAAC;IAEnD,4FAA4F;IAC5F,SAAgB,YAAY,CAAC,EAAE,eAAe,CAAC;IAE/C,iGAAiG;IACjG,SAAgB,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;IAEzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAU;IAEhD;;;;;OAKG;gBACS,MAAM,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY;IA6CnE;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;CAanC"}

package/dist/utils/dom-manager.js

@@ -1,38 +1,44 @@
-import { createInvalidInputTypeError as l, createDOMElementNotFoundError as n } from "./validation.js";
-class s {
+import { createInvalidInputTypeError as o, createDOMElementNotFoundError as n } from "./validation.js";
+class u {
   /** Contains the core, always-required DOM elements. */
   elements;
   /** Contains DOM elements for the resize module. Undefined if the module is not configured. */
   resizeElements;
   /** Contains DOM elements for the crop module. Undefined if the module is not configured. */
   cropElements;
+  /** Contains DOM elements for the transform module. Undefined if the module is not configured. */
+  transformElements;
   errorHandler;
+  strictModuleSelectors;
   /**
    * Creates an instance of DOMManager.
    * @param config - The main editor configuration object containing CSS selectors.
    * @param errorHandler - The error handler instance for reporting non-fatal errors.
    * @throws {Error} If a required DOM element cannot be found.
    */
-  constructor(t, r) {
-    this.errorHandler = r, this.elements = {
+  constructor(t, i) {
+    this.errorHandler = i, this.strictModuleSelectors = t.strictModuleSelectors ?? !1, this.elements = {
       container: this.queryAndValidate(t.containerSelector),
       imageFileInput: this.queryAndValidate(t.imageFileInputSelector, (e) => {
         if (e.type !== "file")
-          throw l(t.imageFileInputSelector);
+          throw o(t.imageFileInputSelector);
       }),
       resetEditsButton: this.queryAndValidate(t.resetEditsButtonSelector),
       clearCanvasButton: this.queryAndValidate(t.clearCanvasButtonSelector),
       saveButton: this.queryAndValidate(t.saveButtonSelector)
     }, this.resizeElements = this.initializeModuleElements(t.modules?.resize, "Resize", (e) => {
-      const i = {
+      const r = {
         widthInput: this.queryAndValidate(e.widthInputSelector),
         heightInput: this.queryAndValidate(e.heightInputSelector)
       };
-      return e.lockAspectRatioSelector && (i.lockAspectRatio = this.queryAndValidate(e.lockAspectRatioSelector)), i;
+      return e.lockAspectRatioSelector && (r.lockAspectRatio = this.queryAndValidate(e.lockAspectRatioSelector)), r;
     }), this.cropElements = this.initializeModuleElements(t.modules?.crop, "Crop", (e) => ({
       activateButton: this.queryAndValidate(e.activateButtonSelector),
       applyButton: this.queryAndValidate(e.applyButtonSelector)
-    }));
+    })), this.transformElements = this.initializeModuleElements(t.modules?.transform, "Transform", (e) => {
+      const r = {};
+      return e.rotateInputSelector && (r.rotateInput = this.queryAndValidate(e.rotateInputSelector)), e.flipHorizontalButtonSelector && (r.flipHorizontalButton = this.queryAndValidate(e.flipHorizontalButtonSelector)), e.flipVerticalButtonSelector && (r.flipVerticalButton = this.queryAndValidate(e.flipVerticalButtonSelector)), r;
+    });
   }
   /**
    * Queries the document for an element and throws a detailed error if not found.
@@ -42,11 +48,11 @@ class s {
    * @returns The found element, correctly typed.
    * @throws {Error} If the element with the given selector does not exist in the DOM.
    */
-  queryAndValidate(t, r) {
+  queryAndValidate(t, i) {
     const e = document.querySelector(t);
     if (!e)
       throw n(t);
-    return r && r(e), e;
+    return i && i(e), e;
   }
   /**
    * Initializes DOM elements for a module using a provided extractor function.
@@ -55,17 +61,19 @@ class s {
    * @param extractor - A function that extracts and validates DOM elements from the config.
    * @returns An object with DOM elements or `undefined`.
    */
-  initializeModuleElements(t, r, e) {
+  initializeModuleElements(t, i, e) {
     if (t)
       try {
         return e(t);
-      } catch (i) {
-        console.warn(`DOM elements for ${r} module not found. The module will be disabled.`), this.errorHandler.handle(i);
+      } catch (r) {
+        const l = this.errorHandler.handle(r, { source: "dom", operation: `initialize-module-elements:${i}` });
+        if (this.strictModuleSelectors)
+          throw l;
         return;
       }
   }
 }
 export {
-  s as DOMManager
+  u as DOMManager
 };
 //# sourceMappingURL=dom-manager.js.map

package/dist/utils/dom-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom-manager.js","sources":["../../src/utils/dom-manager.ts"],"sourcesContent":["import type { CanvicoEditorConfig } from \"../types.js\";\r\nimport { ErrorHandler } from \"./error-handler.js\";\r\nimport { createDOMElementNotFoundError, createInvalidInputTypeError } from \"./validation.js\";\r\n\r\n/**\r\n * Defines the core DOM elements required by the editor.\r\n */\r\nexport interface CoreDOMElements {\r\n    container: HTMLElement;\r\n    imageFileInput: HTMLInputElement;\r\n    resetEditsButton: HTMLButtonElement;\r\n    clearCanvasButton: HTMLButtonElement;\r\n    saveButton: HTMLButtonElement;\r\n}\r\n\r\n/**\r\n * Defines the DOM elements for the Resize module.\r\n */\r\nexport interface ResizeDOMElements {\r\n    widthInput: HTMLInputElement;\r\n    heightInput: HTMLInputElement;\r\n    lockAspectRatio?: HTMLInputElement;\r\n}\r\n\r\n/**\r\n * Defines the DOM elements for the Crop module.\r\n */\r\nexport interface CropDOMElements {\r\n    activateButton: HTMLButtonElement;\r\n    applyButton: HTMLButtonElement;\r\n}\r\n\r\n/**\r\n * Manages all DOM interactions for the CanvicoEditor.\r\n * It queries and validates the existence of all required and optional\r\n * elements upon instantiation, providing a single, reliable source of DOM nodes.\r\n */\r\nexport class DOMManager {\r\n    /** Contains the core, always-required DOM elements. */\r\n    public readonly elements: CoreDOMElements;\r\n\r\n    /** Contains DOM elements for the resize module. Undefined if the module is not configured. */\r\n    public readonly resizeElements?: ResizeDOMElements;\r\n\r\n    /** Contains DOM elements for the crop module. Undefined if the module is not configured. */\r\n    public readonly cropElements?: CropDOMElements;\r\n\r\n    private errorHandler: ErrorHandler;\r\n\r\n    /**\r\n     * Creates an instance of DOMManager.\r\n     * @param config - The main editor configuration object containing CSS selectors.\r\n     * @param errorHandler - The error handler instance for reporting non-fatal errors.\r\n     * @throws {Error} If a required DOM element cannot be found.\r\n     */\r\n    constructor(config: CanvicoEditorConfig, errorHandler: ErrorHandler) {\r\n        this.errorHandler = errorHandler;\r\n        this.elements = {\r\n            container: this.queryAndValidate<HTMLElement>(config.containerSelector),\r\n            imageFileInput: this.queryAndValidate<HTMLInputElement>(config.imageFileInputSelector, (el) => {\r\n                if (el.type !== \"file\") {\r\n                    throw createInvalidInputTypeError(config.imageFileInputSelector);\r\n                }\r\n            }),\r\n            resetEditsButton: this.queryAndValidate<HTMLButtonElement>(config.resetEditsButtonSelector),\r\n            clearCanvasButton: this.queryAndValidate<HTMLButtonElement>(config.clearCanvasButtonSelector),\r\n            saveButton: this.queryAndValidate<HTMLButtonElement>(config.saveButtonSelector),\r\n        };\r\n\r\n        this.resizeElements = this.initializeModuleElements(config.modules?.resize, \"Resize\", (cfg) => {\r\n            const elements: ResizeDOMElements = {\r\n                widthInput: this.queryAndValidate<HTMLInputElement>(cfg.widthInputSelector),\r\n                heightInput: this.queryAndValidate<HTMLInputElement>(cfg.heightInputSelector),\r\n            };\r\n            if (cfg.lockAspectRatioSelector) {\r\n                elements.lockAspectRatio = this.queryAndValidate<HTMLInputElement>(cfg.lockAspectRatioSelector);\r\n            }\r\n            return elements;\r\n        });\r\n        this.cropElements = this.initializeModuleElements(config.modules?.crop, \"Crop\", (cfg) => ({\r\n            activateButton: this.queryAndValidate<HTMLButtonElement>(cfg.activateButtonSelector),\r\n            applyButton: this.queryAndValidate<HTMLButtonElement>(cfg.applyButtonSelector),\r\n        }));\r\n    }\r\n\r\n    /**\r\n     * Queries the document for an element and throws a detailed error if not found.\r\n     * @template T - The expected HTML element type.\r\n     * @param selector - The CSS selector for the element.\r\n     * @param validator - Optional validation function to check specific element properties.\r\n     * @returns The found element, correctly typed.\r\n     * @throws {Error} If the element with the given selector does not exist in the DOM.\r\n     */\r\n    private queryAndValidate<T extends HTMLElement>(selector: string, validator?: (element: T) => void): T {\r\n        const element = document.querySelector<T>(selector);\r\n        if (!element) {\r\n            throw createDOMElementNotFoundError(selector);\r\n        }\r\n        if (validator) {\r\n            validator(element);\r\n        }\r\n        return element;\r\n    }\r\n\r\n    /**\r\n     * Initializes DOM elements for a module using a provided extractor function.\r\n     * @param config - The module configuration object.\r\n     * @param moduleName - The name of the module for error logging.\r\n     * @param extractor - A function that extracts and validates DOM elements from the config.\r\n     * @returns An object with DOM elements or `undefined`.\r\n     */\r\n    private initializeModuleElements<TConfig, TResult>(config: TConfig | undefined, moduleName: string, extractor: (config: TConfig) => TResult): TResult | undefined {\r\n        if (!config) return undefined;\r\n\r\n        try {\r\n            return extractor(config);\r\n        } catch (error) {\r\n            console.warn(`DOM elements for ${moduleName} module not found. The module will be disabled.`);\r\n            this.errorHandler.handle(error as Error);\r\n            return undefined;\r\n        }\r\n    }\r\n}\r\n"],"names":["DOMManager","config","errorHandler","el","createInvalidInputTypeError","cfg","elements","selector","validator","element","createDOMElementNotFoundError","moduleName","extractor","error"],"mappings":";AAqCO,MAAMA,EAAW;AAAA;AAAA,EAEJ;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA,EAER;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQR,YAAYC,GAA6BC,GAA4B;AACjE,SAAK,eAAeA,GACpB,KAAK,WAAW;AAAA,MACZ,WAAW,KAAK,iBAA8BD,EAAO,iBAAiB;AAAA,MACtE,gBAAgB,KAAK,iBAAmCA,EAAO,wBAAwB,CAACE,MAAO;AAC3F,YAAIA,EAAG,SAAS;AACZ,gBAAMC,EAA4BH,EAAO,sBAAsB;AAAA,MAEvE,CAAC;AAAA,MACD,kBAAkB,KAAK,iBAAoCA,EAAO,wBAAwB;AAAA,MAC1F,mBAAmB,KAAK,iBAAoCA,EAAO,yBAAyB;AAAA,MAC5F,YAAY,KAAK,iBAAoCA,EAAO,kBAAkB;AAAA,IAAA,GAGlF,KAAK,iBAAiB,KAAK,yBAAyBA,EAAO,SAAS,QAAQ,UAAU,CAACI,MAAQ;AAC3F,YAAMC,IAA8B;AAAA,QAChC,YAAY,KAAK,iBAAmCD,EAAI,kBAAkB;AAAA,QAC1E,aAAa,KAAK,iBAAmCA,EAAI,mBAAmB;AAAA,MAAA;AAEhF,aAAIA,EAAI,4BACJC,EAAS,kBAAkB,KAAK,iBAAmCD,EAAI,uBAAuB,IAE3FC;AAAA,IACX,CAAC,GACD,KAAK,eAAe,KAAK,yBAAyBL,EAAO,SAAS,MAAM,QAAQ,CAACI,OAAS;AAAA,MACtF,gBAAgB,KAAK,iBAAoCA,EAAI,sBAAsB;AAAA,MACnF,aAAa,KAAK,iBAAoCA,EAAI,mBAAmB;AAAA,IAAA,EAC/E;AAAA,EACN;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUQ,iBAAwCE,GAAkBC,GAAqC;AACnG,UAAMC,IAAU,SAAS,cAAiBF,CAAQ;AAClD,QAAI,CAACE;AACD,YAAMC,EAA8BH,CAAQ;AAEhD,WAAIC,KACAA,EAAUC,CAAO,GAEdA;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,yBAA2CR,GAA6BU,GAAoBC,GAA8D;AAC9J,QAAKX;AAEL,UAAI;AACA,eAAOW,EAAUX,CAAM;AAAA,MAC3B,SAASY,GAAO;AACZ,gBAAQ,KAAK,oBAAoBF,CAAU,iDAAiD,GAC5F,KAAK,aAAa,OAAOE,CAAc;AACvC;AAAA,MACJ;AAAA,EACJ;AACJ;"}
+{"version":3,"file":"dom-manager.js","sources":["../../src/utils/dom-manager.ts"],"sourcesContent":["import type { CanvicoEditorConfig } from \"../types.js\";\r\nimport { ErrorHandler } from \"./error-handler.js\";\r\nimport { createDOMElementNotFoundError, createInvalidInputTypeError } from \"./validation.js\";\r\n\r\n/**\r\n * Defines the core DOM elements required by the editor.\r\n */\r\nexport interface CoreDOMElements {\r\n    container: HTMLElement;\r\n    imageFileInput: HTMLInputElement;\r\n    resetEditsButton: HTMLButtonElement;\r\n    clearCanvasButton: HTMLButtonElement;\r\n    saveButton: HTMLButtonElement;\r\n}\r\n\r\n/**\r\n * Defines the DOM elements for the Resize module.\r\n */\r\nexport interface ResizeDOMElements {\r\n    widthInput: HTMLInputElement;\r\n    heightInput: HTMLInputElement;\r\n    lockAspectRatio?: HTMLInputElement;\r\n}\r\n\r\n/**\r\n * Defines the DOM elements for the Crop module.\r\n */\r\nexport interface CropDOMElements {\r\n    activateButton: HTMLButtonElement;\r\n    applyButton: HTMLButtonElement;\r\n}\r\n\r\n/**\r\n * Defines the DOM elements for the Transform module.\r\n */\r\nexport interface TransformDOMElements {\r\n    rotateInput?: HTMLInputElement;\r\n    flipHorizontalButton?: HTMLButtonElement;\r\n    flipVerticalButton?: HTMLButtonElement;\r\n}\r\n\r\n/**\r\n * Manages all DOM interactions for the CanvicoEditor.\r\n * It queries and validates the existence of all required and optional\r\n * elements upon instantiation, providing a single, reliable source of DOM nodes.\r\n */\r\nexport class DOMManager {\r\n    /** Contains the core, always-required DOM elements. */\r\n    public readonly elements: CoreDOMElements;\r\n\r\n    /** Contains DOM elements for the resize module. Undefined if the module is not configured. */\r\n    public readonly resizeElements?: ResizeDOMElements;\r\n\r\n    /** Contains DOM elements for the crop module. Undefined if the module is not configured. */\r\n    public readonly cropElements?: CropDOMElements;\r\n\r\n    /** Contains DOM elements for the transform module. Undefined if the module is not configured. */\r\n    public readonly transformElements?: TransformDOMElements;\r\n\r\n    private readonly errorHandler: ErrorHandler;\r\n    private readonly strictModuleSelectors: boolean;\r\n\r\n    /**\r\n     * Creates an instance of DOMManager.\r\n     * @param config - The main editor configuration object containing CSS selectors.\r\n     * @param errorHandler - The error handler instance for reporting non-fatal errors.\r\n     * @throws {Error} If a required DOM element cannot be found.\r\n     */\r\n    constructor(config: CanvicoEditorConfig, errorHandler: ErrorHandler) {\r\n        this.errorHandler = errorHandler;\r\n        this.strictModuleSelectors = config.strictModuleSelectors ?? false;\r\n        this.elements = {\r\n            container: this.queryAndValidate<HTMLElement>(config.containerSelector),\r\n            imageFileInput: this.queryAndValidate<HTMLInputElement>(config.imageFileInputSelector, (el) => {\r\n                if (el.type !== \"file\") {\r\n                    throw createInvalidInputTypeError(config.imageFileInputSelector);\r\n                }\r\n            }),\r\n            resetEditsButton: this.queryAndValidate<HTMLButtonElement>(config.resetEditsButtonSelector),\r\n            clearCanvasButton: this.queryAndValidate<HTMLButtonElement>(config.clearCanvasButtonSelector),\r\n            saveButton: this.queryAndValidate<HTMLButtonElement>(config.saveButtonSelector),\r\n        };\r\n\r\n        this.resizeElements = this.initializeModuleElements(config.modules?.resize, \"Resize\", (cfg) => {\r\n            const elements: ResizeDOMElements = {\r\n                widthInput: this.queryAndValidate<HTMLInputElement>(cfg.widthInputSelector),\r\n                heightInput: this.queryAndValidate<HTMLInputElement>(cfg.heightInputSelector),\r\n            };\r\n            if (cfg.lockAspectRatioSelector) {\r\n                elements.lockAspectRatio = this.queryAndValidate<HTMLInputElement>(cfg.lockAspectRatioSelector);\r\n            }\r\n            return elements;\r\n        });\r\n        this.cropElements = this.initializeModuleElements(config.modules?.crop, \"Crop\", (cfg) => ({\r\n            activateButton: this.queryAndValidate<HTMLButtonElement>(cfg.activateButtonSelector),\r\n            applyButton: this.queryAndValidate<HTMLButtonElement>(cfg.applyButtonSelector),\r\n        }));\r\n\r\n        this.transformElements = this.initializeModuleElements(config.modules?.transform, \"Transform\", (cfg) => {\r\n            const elements: TransformDOMElements = {};\r\n            if (cfg.rotateInputSelector) {\r\n                elements.rotateInput = this.queryAndValidate<HTMLInputElement>(cfg.rotateInputSelector);\r\n            }\r\n            if (cfg.flipHorizontalButtonSelector) {\r\n                elements.flipHorizontalButton = this.queryAndValidate<HTMLButtonElement>(cfg.flipHorizontalButtonSelector);\r\n            }\r\n            if (cfg.flipVerticalButtonSelector) {\r\n                elements.flipVerticalButton = this.queryAndValidate<HTMLButtonElement>(cfg.flipVerticalButtonSelector);\r\n            }\r\n            return elements;\r\n        });\r\n    }\r\n\r\n    /**\r\n     * Queries the document for an element and throws a detailed error if not found.\r\n     * @template T - The expected HTML element type.\r\n     * @param selector - The CSS selector for the element.\r\n     * @param validator - Optional validation function to check specific element properties.\r\n     * @returns The found element, correctly typed.\r\n     * @throws {Error} If the element with the given selector does not exist in the DOM.\r\n     */\r\n    private queryAndValidate<T extends HTMLElement>(selector: string, validator?: (element: T) => void): T {\r\n        const element = document.querySelector<T>(selector);\r\n        if (!element) {\r\n            throw createDOMElementNotFoundError(selector);\r\n        }\r\n        if (validator) {\r\n            validator(element);\r\n        }\r\n        return element;\r\n    }\r\n\r\n    /**\r\n     * Initializes DOM elements for a module using a provided extractor function.\r\n     * @param config - The module configuration object.\r\n     * @param moduleName - The name of the module for error logging.\r\n     * @param extractor - A function that extracts and validates DOM elements from the config.\r\n     * @returns An object with DOM elements or `undefined`.\r\n     */\r\n    private initializeModuleElements<TConfig, TResult>(config: TConfig | undefined, moduleName: string, extractor: (config: TConfig) => TResult): TResult | undefined {\r\n        if (!config) return undefined;\r\n\r\n        try {\r\n            return extractor(config);\r\n        } catch (error) {\r\n            const handledError = this.errorHandler.handle(error, { source: \"dom\", operation: `initialize-module-elements:${moduleName}` });\r\n            if (this.strictModuleSelectors) {\r\n                throw handledError;\r\n            }\r\n            return undefined;\r\n        }\r\n    }\r\n}\r\n"],"names":["DOMManager","config","errorHandler","el","createInvalidInputTypeError","cfg","elements","selector","validator","element","createDOMElementNotFoundError","moduleName","extractor","error","handledError"],"mappings":";AA8CO,MAAMA,EAAW;AAAA;AAAA,EAEJ;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA;AAAA,EAGA;AAAA,EAEC;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQjB,YAAYC,GAA6BC,GAA4B;AACjE,SAAK,eAAeA,GACpB,KAAK,wBAAwBD,EAAO,yBAAyB,IAC7D,KAAK,WAAW;AAAA,MACZ,WAAW,KAAK,iBAA8BA,EAAO,iBAAiB;AAAA,MACtE,gBAAgB,KAAK,iBAAmCA,EAAO,wBAAwB,CAACE,MAAO;AAC3F,YAAIA,EAAG,SAAS;AACZ,gBAAMC,EAA4BH,EAAO,sBAAsB;AAAA,MAEvE,CAAC;AAAA,MACD,kBAAkB,KAAK,iBAAoCA,EAAO,wBAAwB;AAAA,MAC1F,mBAAmB,KAAK,iBAAoCA,EAAO,yBAAyB;AAAA,MAC5F,YAAY,KAAK,iBAAoCA,EAAO,kBAAkB;AAAA,IAAA,GAGlF,KAAK,iBAAiB,KAAK,yBAAyBA,EAAO,SAAS,QAAQ,UAAU,CAACI,MAAQ;AAC3F,YAAMC,IAA8B;AAAA,QAChC,YAAY,KAAK,iBAAmCD,EAAI,kBAAkB;AAAA,QAC1E,aAAa,KAAK,iBAAmCA,EAAI,mBAAmB;AAAA,MAAA;AAEhF,aAAIA,EAAI,4BACJC,EAAS,kBAAkB,KAAK,iBAAmCD,EAAI,uBAAuB,IAE3FC;AAAA,IACX,CAAC,GACD,KAAK,eAAe,KAAK,yBAAyBL,EAAO,SAAS,MAAM,QAAQ,CAACI,OAAS;AAAA,MACtF,gBAAgB,KAAK,iBAAoCA,EAAI,sBAAsB;AAAA,MACnF,aAAa,KAAK,iBAAoCA,EAAI,mBAAmB;AAAA,IAAA,EAC/E,GAEF,KAAK,oBAAoB,KAAK,yBAAyBJ,EAAO,SAAS,WAAW,aAAa,CAACI,MAAQ;AACpG,YAAMC,IAAiC,CAAA;AACvC,aAAID,EAAI,wBACJC,EAAS,cAAc,KAAK,iBAAmCD,EAAI,mBAAmB,IAEtFA,EAAI,iCACJC,EAAS,uBAAuB,KAAK,iBAAoCD,EAAI,4BAA4B,IAEzGA,EAAI,+BACJC,EAAS,qBAAqB,KAAK,iBAAoCD,EAAI,0BAA0B,IAElGC;AAAA,IACX,CAAC;AAAA,EACL;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUQ,iBAAwCC,GAAkBC,GAAqC;AACnG,UAAMC,IAAU,SAAS,cAAiBF,CAAQ;AAClD,QAAI,CAACE;AACD,YAAMC,EAA8BH,CAAQ;AAEhD,WAAIC,KACAA,EAAUC,CAAO,GAEdA;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,yBAA2CR,GAA6BU,GAAoBC,GAA8D;AAC9J,QAAKX;AAEL,UAAI;AACA,eAAOW,EAAUX,CAAM;AAAA,MAC3B,SAASY,GAAO;AACZ,cAAMC,IAAe,KAAK,aAAa,OAAOD,GAAO,EAAE,QAAQ,OAAO,WAAW,8BAA8BF,CAAU,GAAA,CAAI;AAC7H,YAAI,KAAK;AACL,gBAAMG;AAEV;AAAA,MACJ;AAAA,EACJ;AACJ;"}

package/dist/utils/error-handler.d.ts

@@ -1,14 +1,25 @@
+import { CanvicoEditorErrorCallback, CanvicoEditorErrorSource } from '../types.js';
+export type ErrorHandlerContext = {
+    source: CanvicoEditorErrorSource;
+    operation?: string;
+};
+export type ErrorHandlerOptions = {
+    onError?: CanvicoEditorErrorCallback;
+    logToConsole?: boolean;
+};
 /**
- * A centralized class for handling errors that occur within the application.
- * By default, it logs errors to the console, but it can be extended
- * in the future to support other reporting mechanisms (e.g., sending to a logging service).
+ * Centralized error handling for the editor runtime.
+ * It can report errors to host application and optionally to the browser console.
  */
 export declare class ErrorHandler {
+    private readonly onError?;
+    private readonly logToConsole;
+    constructor(options?: ErrorHandlerOptions);
     /**
-     * Handles an error by logging it to the console.
-     * This is the central place for logging errors for developers.
-     * @param error - The error object to handle, which should include a message and preferably a stack trace.
+     * Handles an error and reports it using configured channels.
+     * Returns a normalized `Error` instance for callers that need it.
      */
-    handle(error: Error): void;
+    handle(errorLike: unknown, context?: ErrorHandlerContext): Error;
+    private _normalizeError;
 }
 //# sourceMappingURL=error-handler.d.ts.map

package/dist/utils/error-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,YAAY;IACrB;;;;OAIG;IACI,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;CAIpC"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAA4B,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAElH,MAAM,MAAM,mBAAmB,GAAG;IAC9B,MAAM,EAAE,wBAAwB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,OAAO,CAAC,EAAE,0BAA0B,CAAC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAIF;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;gBAE3B,OAAO,CAAC,EAAE,mBAAmB;IAKzC;;;OAGG;IACI,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,KAAK;IA4BvE,OAAO,CAAC,eAAe;CAQ1B"}

package/dist/utils/error-handler.js

@@ -1,14 +1,41 @@
-class o {
+const c = { source: "editor" };
+class a {
+  onError;
+  logToConsole;
+  constructor(o) {
+    this.onError = o?.onError, this.logToConsole = o?.logToConsole ?? !0;
+  }
   /**
-   * Handles an error by logging it to the console.
-   * This is the central place for logging errors for developers.
-   * @param error - The error object to handle, which should include a message and preferably a stack trace.
+   * Handles an error and reports it using configured channels.
+   * Returns a normalized `Error` instance for callers that need it.
    */
-  handle(r) {
-    console.error(r);
+  handle(o, n) {
+    const r = n ?? c, e = this._normalizeError(o), s = {
+      error: e,
+      source: r.source,
+      operation: r.operation,
+      timestamp: /* @__PURE__ */ new Date()
+    };
+    if (this.logToConsole) {
+      const t = r.operation ? `:${r.operation}` : "";
+      console.error(`[CanvicoEditor][${r.source}${t}]`, e);
+    }
+    if (this.onError)
+      try {
+        this.onError(s);
+      } catch (t) {
+        this.logToConsole && console.error("[CanvicoEditor][error-handler:onError-callback]", t);
+      }
+    return e;
+  }
+  _normalizeError(o) {
+    if (o instanceof Error)
+      return o;
+    const n = typeof o == "string" ? o : "Unknown error";
+    return new Error(n);
   }
 }
 export {
-  o as ErrorHandler
+  a as ErrorHandler
 };
 //# sourceMappingURL=error-handler.js.map

package/dist/utils/error-handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-handler.js","sources":["../../src/utils/error-handler.ts"],"sourcesContent":["/**\r\n * A centralized class for handling errors that occur within the application.\r\n * By default, it logs errors to the console, but it can be extended\r\n * in the future to support other reporting mechanisms (e.g., sending to a logging service).\r\n */\r\nexport class ErrorHandler {\r\n    /**\r\n     * Handles an error by logging it to the console.\r\n     * This is the central place for logging errors for developers.\r\n     * @param error - The error object to handle, which should include a message and preferably a stack trace.\r\n     */\r\n    public handle(error: Error): void {\r\n        // We log the entire error object to provide the most detail in the console.\r\n        console.error(error);\r\n    }\r\n}\r\n"],"names":["ErrorHandler","error"],"mappings":"AAKO,MAAMA,EAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMf,OAAOC,GAAoB;AAE9B,YAAQ,MAAMA,CAAK;AAAA,EACvB;AACJ;"}
+{"version":3,"file":"error-handler.js","sources":["../../src/utils/error-handler.ts"],"sourcesContent":["import type { CanvicoEditorErrorCallback, CanvicoEditorErrorReport, CanvicoEditorErrorSource } from \"../types.js\";\r\n\r\nexport type ErrorHandlerContext = {\r\n    source: CanvicoEditorErrorSource;\r\n    operation?: string;\r\n};\r\n\r\nexport type ErrorHandlerOptions = {\r\n    onError?: CanvicoEditorErrorCallback;\r\n    logToConsole?: boolean;\r\n};\r\n\r\nconst DEFAULT_ERROR_CONTEXT: ErrorHandlerContext = { source: \"editor\" };\r\n\r\n/**\r\n * Centralized error handling for the editor runtime.\r\n * It can report errors to host application and optionally to the browser console.\r\n */\r\nexport class ErrorHandler {\r\n    private readonly onError?: CanvicoEditorErrorCallback;\r\n    private readonly logToConsole: boolean;\r\n\r\n    constructor(options?: ErrorHandlerOptions) {\r\n        this.onError = options?.onError;\r\n        this.logToConsole = options?.logToConsole ?? true;\r\n    }\r\n\r\n    /**\r\n     * Handles an error and reports it using configured channels.\r\n     * Returns a normalized `Error` instance for callers that need it.\r\n     */\r\n    public handle(errorLike: unknown, context?: ErrorHandlerContext): Error {\r\n        const resolvedContext = context ?? DEFAULT_ERROR_CONTEXT;\r\n        const error = this._normalizeError(errorLike);\r\n        const report: CanvicoEditorErrorReport = {\r\n            error,\r\n            source: resolvedContext.source,\r\n            operation: resolvedContext.operation,\r\n            timestamp: new Date(),\r\n        };\r\n\r\n        if (this.logToConsole) {\r\n            const operationLabel = resolvedContext.operation ? `:${resolvedContext.operation}` : \"\";\r\n            console.error(`[CanvicoEditor][${resolvedContext.source}${operationLabel}]`, error);\r\n        }\r\n\r\n        if (this.onError) {\r\n            try {\r\n                this.onError(report);\r\n            } catch (callbackError) {\r\n                if (this.logToConsole) {\r\n                    console.error(\"[CanvicoEditor][error-handler:onError-callback]\", callbackError);\r\n                }\r\n            }\r\n        }\r\n\r\n        return error;\r\n    }\r\n\r\n    private _normalizeError(errorLike: unknown): Error {\r\n        if (errorLike instanceof Error) {\r\n            return errorLike;\r\n        }\r\n\r\n        const message = typeof errorLike === \"string\" ? errorLike : \"Unknown error\";\r\n        return new Error(message);\r\n    }\r\n}\r\n"],"names":["DEFAULT_ERROR_CONTEXT","ErrorHandler","options","errorLike","context","resolvedContext","error","report","operationLabel","callbackError","message"],"mappings":"AAYA,MAAMA,IAA6C,EAAE,QAAQ,SAAA;AAMtD,MAAMC,EAAa;AAAA,EACL;AAAA,EACA;AAAA,EAEjB,YAAYC,GAA+B;AACvC,SAAK,UAAUA,GAAS,SACxB,KAAK,eAAeA,GAAS,gBAAgB;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,OAAOC,GAAoBC,GAAsC;AACpE,UAAMC,IAAkBD,KAAWJ,GAC7BM,IAAQ,KAAK,gBAAgBH,CAAS,GACtCI,IAAmC;AAAA,MACrC,OAAAD;AAAA,MACA,QAAQD,EAAgB;AAAA,MACxB,WAAWA,EAAgB;AAAA,MAC3B,+BAAe,KAAA;AAAA,IAAK;AAGxB,QAAI,KAAK,cAAc;AACnB,YAAMG,IAAiBH,EAAgB,YAAY,IAAIA,EAAgB,SAAS,KAAK;AACrF,cAAQ,MAAM,mBAAmBA,EAAgB,MAAM,GAAGG,CAAc,KAAKF,CAAK;AAAA,IACtF;AAEA,QAAI,KAAK;AACL,UAAI;AACA,aAAK,QAAQC,CAAM;AAAA,MACvB,SAASE,GAAe;AACpB,QAAI,KAAK,gBACL,QAAQ,MAAM,mDAAmDA,CAAa;AAAA,MAEtF;AAGJ,WAAOH;AAAA,EACX;AAAA,EAEQ,gBAAgBH,GAA2B;AAC/C,QAAIA,aAAqB;AACrB,aAAOA;AAGX,UAAMO,IAAU,OAAOP,KAAc,WAAWA,IAAY;AAC5D,WAAO,IAAI,MAAMO,CAAO;AAAA,EAC5B;AACJ;"}

package/dist/utils/validation.d.ts

@@ -32,13 +32,6 @@ export declare function createCanvasContextError(): Error;
  * @returns {Error} A new Error object with a descriptive message.
  */
 export declare function createImageSaveError(): Error;
-/**
- * Creates a standardized error for when a module is configured with an incomplete set of selectors.
- * @param {string} moduleName - The name of the module (e.g., 'Resize', 'Crop').
- * @param {string[]} selectors - The list of required selector names for the module.
- * @returns {Error} A new Error object with a descriptive message.
- */
-export declare function createMissingModuleSelectorsError(moduleName: string, selectors: string[]): Error;
 /**
  * Creates a standardized error for when a required browser feature is not supported.
  * @param {string} featureName - The name of the required feature (e.g., 'FileReader').

package/dist/utils/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAErE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,MAAiC,GAAG,KAAK,CAEtF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,KAAK,CAEhD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,KAAK,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,CAEhG;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAEzE;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAWpE"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAErE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,MAAiC,GAAG,KAAK,CAEtF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,KAAK,CAEhD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,KAAK,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAEzE;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAWpE"}

package/dist/utils/validation.js

@@ -1,40 +1,44 @@
-const r = "CanvicoEditor:";
-function a(e) {
-  return new Error(`${r} Required DOM element not found for selector: "${e}".`);
+const i = "CanvicoEditor:";
+function e(r, o) {
+  const t = new Error(`${i} ${o}`);
+  return t.name = r, t;
 }
-function u(e) {
-  return new Error(`${r} Element for selector "${e}" is not an <input type="file">.`);
+function u(r) {
+  return e("CanvicoDOMElementNotFoundError", `Required DOM element not found for selector: "${r}".`);
 }
-function n(e) {
-  return new Error(`${r} Invalid file: ${e}`);
+function c(r) {
+  return e("CanvicoInvalidInputTypeError", `Element for selector "${r}" is not an <input type="file">.`);
 }
-function c(e = "File could not be read") {
-  return new Error(`${r} Image load error: ${e}`);
+function a(r) {
+  return e("CanvicoInvalidFileError", `Invalid file: ${r}`);
 }
-function s() {
-  return new Error(`${r} 2D context is not supported by the browser.`);
+function d(r = "File could not be read") {
+  return e("CanvicoImageLoadError", `Image load error: ${r}`);
+}
+function p() {
+  return e("CanvicoCanvasContextError", "2D context is not supported by the browser.");
 }
-function d() {
-  return new Error(`${r} Cannot save because no image is loaded.`);
+function s() {
+  return e("CanvicoImageSaveError", "Cannot save because no image is loaded.");
 }
-function p(e) {
-  return new Error(`${r} Required browser feature not supported: ${e}.`);
+function l(r) {
+  return e("CanvicoFeatureNotSupportedError", `Required browser feature not supported: ${r}.`);
 }
-function l(e, t) {
-  const i = t * 1024 * 1024, o = ["image/jpeg", "image/png", "image/gif", "image/webp"];
-  if (!o.includes(e.type))
-    throw n(`Unsupported file type. Supported types are: ${o.join(", ")}.`);
-  if (e.size > i)
-    throw n(`File is too large. Maximum size is ${t}MB.`);
+function E(r, o) {
+  const t = o * 1024 * 1024, n = ["image/jpeg", "image/png", "image/webp"];
+  if (!n.includes(r.type))
+    throw a(`Unsupported file type. Supported types are: ${n.join(", ")}.`);
+  if (r.size > t)
+    throw a(`File is too large. Maximum size is ${o}MB.`);
 }
 export {
-  s as createCanvasContextError,
-  a as createDOMElementNotFoundError,
-  p as createFeatureNotSupportedError,
-  c as createImageLoadError,
-  d as createImageSaveError,
-  n as createInvalidFileError,
-  u as createInvalidInputTypeError,
-  l as validateFile
+  p as createCanvasContextError,
+  u as createDOMElementNotFoundError,
+  l as createFeatureNotSupportedError,
+  d as createImageLoadError,
+  s as createImageSaveError,
+  a as createInvalidFileError,
+  c as createInvalidInputTypeError,
+  E as validateFile
 };
 //# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sources":["../../src/utils/validation.ts"],"sourcesContent":["const PREFIX = \"CanvicoEditor:\";\r\n\r\n// --- ERROR FACTORY FUNCTIONS ---\r\n\r\n/**\r\n * Creates a standardized error for when a required DOM element is not found.\r\n * * @param selector - The CSS selector that failed to find an element.\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createDOMElementNotFoundError(selector: string): Error {\r\n    return new Error(`${PREFIX} Required DOM element not found for selector: \"${selector}\".`);\r\n}\r\n\r\n/**\r\n * Creates a standardized error for when the main input element is not of `type=\"file\"`.\r\n * @param {string} selector - The CSS selector used to find the input element.\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createInvalidInputTypeError(selector: string): Error {\r\n    return new Error(`${PREFIX} Element for selector \"${selector}\" is not an <input type=\"file\">.`);\r\n}\r\n\r\n/**\r\n * Creates a standardized error for file validation issues (e.g., wrong type, size).\r\n * @param {string} message - The specific reason why the file is invalid.\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createInvalidFileError(message: string): Error {\r\n    return new Error(`${PREFIX} Invalid file: ${message}`);\r\n}\r\n\r\n/**\r\n * Creates a standardized error for when an image fails to load from a file.\r\n * @param {string} [details=\"File could not be read\"] - Specific details about the loading error.\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createImageLoadError(details: string = \"File could not be read\"): Error {\r\n    return new Error(`${PREFIX} Image load error: ${details}`);\r\n}\r\n\r\n/**\r\n * Creates a standardized error for when the canvas 2D rendering context cannot be obtained.\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createCanvasContextError(): Error {\r\n    return new Error(`${PREFIX} 2D context is not supported by the browser.`);\r\n}\r\n\r\n/**\r\n * Creates a standardized error for when a save operation is attempted with no image loaded.\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createImageSaveError(): Error {\r\n    return new Error(`${PREFIX} Cannot save because no image is loaded.`);\r\n}\r\n\r\n/**\r\n * Creates a standardized error for when a module is configured with an incomplete set of selectors.\r\n * @param {string} moduleName - The name of the module (e.g., 'Resize', 'Crop').\r\n * @param {string[]} selectors - The list of required selector names for the module.\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createMissingModuleSelectorsError(moduleName: string, selectors: string[]): Error {\r\n    return new Error(`${PREFIX} To use the ${moduleName} module, you must provide all of these selectors: ${selectors.join(\", \")}.`);\r\n}\r\n\r\n/**\r\n * Creates a standardized error for when a required browser feature is not supported.\r\n * @param {string} featureName - The name of the required feature (e.g., 'FileReader').\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createFeatureNotSupportedError(featureName: string): Error {\r\n    return new Error(`${PREFIX} Required browser feature not supported: ${featureName}.`);\r\n}\r\n\r\n// --- VALIDATION FUNCTIONS ---\r\n\r\n/**\r\n * Validates if the selected file is a supported image and within the size limit.\r\n * @param {File} file - The file to validate.\r\n * @param {number} maxFileSizeMB - The maximum allowed file size in megabytes.\r\n * @throws {Error} If the file type is unsupported or the file size exceeds the limit.\r\n */\r\nexport function validateFile(file: File, maxFileSizeMB: number): void {\r\n    const maxFileSizeInBytes = maxFileSizeMB * 1024 * 1024;\r\n    const validTypes = [\"image/jpeg\", \"image/png\", \"image/gif\", \"image/webp\"];\r\n\r\n    if (!validTypes.includes(file.type)) {\r\n        throw createInvalidFileError(`Unsupported file type. Supported types are: ${validTypes.join(\", \")}.`);\r\n    }\r\n\r\n    if (file.size > maxFileSizeInBytes) {\r\n        throw createInvalidFileError(`File is too large. Maximum size is ${maxFileSizeMB}MB.`);\r\n    }\r\n}\r\n"],"names":["PREFIX","createDOMElementNotFoundError","selector","createInvalidInputTypeError","createInvalidFileError","message","createImageLoadError","details","createCanvasContextError","createImageSaveError","createFeatureNotSupportedError","featureName","validateFile","file","maxFileSizeMB","maxFileSizeInBytes","validTypes"],"mappings":"AAAA,MAAMA,IAAS;AASR,SAASC,EAA8BC,GAAyB;AACnE,SAAO,IAAI,MAAM,GAAGF,CAAM,kDAAkDE,CAAQ,IAAI;AAC5F;AAOO,SAASC,EAA4BD,GAAyB;AACjE,SAAO,IAAI,MAAM,GAAGF,CAAM,0BAA0BE,CAAQ,kCAAkC;AAClG;AAOO,SAASE,EAAuBC,GAAwB;AAC3D,SAAO,IAAI,MAAM,GAAGL,CAAM,kBAAkBK,CAAO,EAAE;AACzD;AAOO,SAASC,EAAqBC,IAAkB,0BAAiC;AACpF,SAAO,IAAI,MAAM,GAAGP,CAAM,sBAAsBO,CAAO,EAAE;AAC7D;AAMO,SAASC,IAAkC;AAC9C,SAAO,IAAI,MAAM,GAAGR,CAAM,8CAA8C;AAC5E;AAMO,SAASS,IAA8B;AAC1C,SAAO,IAAI,MAAM,GAAGT,CAAM,0CAA0C;AACxE;AAiBO,SAASU,EAA+BC,GAA4B;AACvE,SAAO,IAAI,MAAM,GAAGX,CAAM,4CAA4CW,CAAW,GAAG;AACxF;AAUO,SAASC,EAAaC,GAAYC,GAA6B;AAClE,QAAMC,IAAqBD,IAAgB,OAAO,MAC5CE,IAAa,CAAC,cAAc,aAAa,aAAa,YAAY;AAExE,MAAI,CAACA,EAAW,SAASH,EAAK,IAAI;AAC9B,UAAMT,EAAuB,+CAA+CY,EAAW,KAAK,IAAI,CAAC,GAAG;AAGxG,MAAIH,EAAK,OAAOE;AACZ,UAAMX,EAAuB,sCAAsCU,CAAa,KAAK;AAE7F;"}
+{"version":3,"file":"validation.js","sources":["../../src/utils/validation.ts"],"sourcesContent":["const PREFIX = \"CanvicoEditor:\";\r\n\r\nfunction createEditorError(name: string, message: string): Error {\r\n    const error = new Error(`${PREFIX} ${message}`);\r\n    error.name = name;\r\n    return error;\r\n}\r\n\r\n// --- ERROR FACTORY FUNCTIONS ---\r\n\r\n/**\r\n * Creates a standardized error for when a required DOM element is not found.\r\n * * @param selector - The CSS selector that failed to find an element.\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createDOMElementNotFoundError(selector: string): Error {\r\n    return createEditorError(\"CanvicoDOMElementNotFoundError\", `Required DOM element not found for selector: \"${selector}\".`);\r\n}\r\n\r\n/**\r\n * Creates a standardized error for when the main input element is not of `type=\"file\"`.\r\n * @param {string} selector - The CSS selector used to find the input element.\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createInvalidInputTypeError(selector: string): Error {\r\n    return createEditorError(\"CanvicoInvalidInputTypeError\", `Element for selector \"${selector}\" is not an <input type=\"file\">.`);\r\n}\r\n\r\n/**\r\n * Creates a standardized error for file validation issues (e.g., wrong type, size).\r\n * @param {string} message - The specific reason why the file is invalid.\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createInvalidFileError(message: string): Error {\r\n    return createEditorError(\"CanvicoInvalidFileError\", `Invalid file: ${message}`);\r\n}\r\n\r\n/**\r\n * Creates a standardized error for when an image fails to load from a file.\r\n * @param {string} [details=\"File could not be read\"] - Specific details about the loading error.\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createImageLoadError(details: string = \"File could not be read\"): Error {\r\n    return createEditorError(\"CanvicoImageLoadError\", `Image load error: ${details}`);\r\n}\r\n\r\n/**\r\n * Creates a standardized error for when the canvas 2D rendering context cannot be obtained.\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createCanvasContextError(): Error {\r\n    return createEditorError(\"CanvicoCanvasContextError\", \"2D context is not supported by the browser.\");\r\n}\r\n\r\n/**\r\n * Creates a standardized error for when a save operation is attempted with no image loaded.\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createImageSaveError(): Error {\r\n    return createEditorError(\"CanvicoImageSaveError\", \"Cannot save because no image is loaded.\");\r\n}\r\n\r\n/**\r\n * Creates a standardized error for when a required browser feature is not supported.\r\n * @param {string} featureName - The name of the required feature (e.g., 'FileReader').\r\n * @returns {Error} A new Error object with a descriptive message.\r\n */\r\nexport function createFeatureNotSupportedError(featureName: string): Error {\r\n    return createEditorError(\"CanvicoFeatureNotSupportedError\", `Required browser feature not supported: ${featureName}.`);\r\n}\r\n\r\n// --- VALIDATION FUNCTIONS ---\r\n\r\n/**\r\n * Validates if the selected file is a supported image and within the size limit.\r\n * @param {File} file - The file to validate.\r\n * @param {number} maxFileSizeMB - The maximum allowed file size in megabytes.\r\n * @throws {Error} If the file type is unsupported or the file size exceeds the limit.\r\n */\r\nexport function validateFile(file: File, maxFileSizeMB: number): void {\r\n    const maxFileSizeInBytes = maxFileSizeMB * 1024 * 1024;\r\n    const validTypes = [\"image/jpeg\", \"image/png\", \"image/webp\"];\r\n\r\n    if (!validTypes.includes(file.type)) {\r\n        throw createInvalidFileError(`Unsupported file type. Supported types are: ${validTypes.join(\", \")}.`);\r\n    }\r\n\r\n    if (file.size > maxFileSizeInBytes) {\r\n        throw createInvalidFileError(`File is too large. Maximum size is ${maxFileSizeMB}MB.`);\r\n    }\r\n}\r\n"],"names":["PREFIX","createEditorError","name","message","error","createDOMElementNotFoundError","selector","createInvalidInputTypeError","createInvalidFileError","createImageLoadError","details","createCanvasContextError","createImageSaveError","createFeatureNotSupportedError","featureName","validateFile","file","maxFileSizeMB","maxFileSizeInBytes","validTypes"],"mappings":"AAAA,MAAMA,IAAS;AAEf,SAASC,EAAkBC,GAAcC,GAAwB;AAC7D,QAAMC,IAAQ,IAAI,MAAM,GAAGJ,CAAM,IAAIG,CAAO,EAAE;AAC9C,SAAAC,EAAM,OAAOF,GACNE;AACX;AASO,SAASC,EAA8BC,GAAyB;AACnE,SAAOL,EAAkB,kCAAkC,iDAAiDK,CAAQ,IAAI;AAC5H;AAOO,SAASC,EAA4BD,GAAyB;AACjE,SAAOL,EAAkB,gCAAgC,yBAAyBK,CAAQ,kCAAkC;AAChI;AAOO,SAASE,EAAuBL,GAAwB;AAC3D,SAAOF,EAAkB,2BAA2B,iBAAiBE,CAAO,EAAE;AAClF;AAOO,SAASM,EAAqBC,IAAkB,0BAAiC;AACpF,SAAOT,EAAkB,yBAAyB,qBAAqBS,CAAO,EAAE;AACpF;AAMO,SAASC,IAAkC;AAC9C,SAAOV,EAAkB,6BAA6B,6CAA6C;AACvG;AAMO,SAASW,IAA8B;AAC1C,SAAOX,EAAkB,yBAAyB,yCAAyC;AAC/F;AAOO,SAASY,EAA+BC,GAA4B;AACvE,SAAOb,EAAkB,mCAAmC,2CAA2Ca,CAAW,GAAG;AACzH;AAUO,SAASC,EAAaC,GAAYC,GAA6B;AAClE,QAAMC,IAAqBD,IAAgB,OAAO,MAC5CE,IAAa,CAAC,cAAc,aAAa,YAAY;AAE3D,MAAI,CAACA,EAAW,SAASH,EAAK,IAAI;AAC9B,UAAMR,EAAuB,+CAA+CW,EAAW,KAAK,IAAI,CAAC,GAAG;AAGxG,MAAIH,EAAK,OAAOE;AACZ,UAAMV,EAAuB,sCAAsCS,CAAa,KAAK;AAE7F;"}

package/package.json

@@ -2,7 +2,7 @@
     "name": "canvico-editor",
     "description": "A simple and extensible image editor built with TypeScript and the Canvas API. Designed with modularity and developer experience in mind, it separates DOM logic from business logic, provides strong typing, and includes robust error handling. Easily integrable into web projects.",
     "private": false,
-    "version": "1.0.2",
+    "version": "2.0.0",
     "type": "module",
     "types": "dist/index.d.ts",
     "exports": {
@@ -47,14 +47,16 @@
         "docs:serve": "cd docs && npm run serve",
         "docs:api": "cd docs && npm run build",
         "release:patch": "npm run build && npm version patch && git push --follow-tags",
+        "release:minor": "npm run build && npm version minor && git push --follow-tags",
+        "release:major": "npm run build && npm version major && git push --follow-tags",
         "prepublishOnly": "vite build",
         "publish:package": "npm publish",
         "build:watch": "vite build --watch"
     },
     "devDependencies": {
-        "@types/node": "^25.0.3",
+        "@types/node": "^25.3.2",
         "typescript": "~5.9.3",
-        "vite": "^7.2.4",
-        "vite-plugin-dts": "^4.5.0"
+        "vite": "^7.3.1",
+        "vite-plugin-dts": "^4.5.4"
     }
 }