@bensitu/image-editor 2.1.0 → 2.3.0

package/dist/types/mask/mask-label-manager.d.ts

@@ -1,18 +1,19 @@
 /**
  * Per-mask label overlay creation, positioning, show/hide, and
- * removal. Owns the legacy `createLabelForMask`, `syncMaskLabel`,
- * `showLabelForMask`, `hideAllMaskLabels`, and
- * `removeLabelForMask` logic that was inlined on the editor
- * in legacy and is now extracted into pure(ish) helpers that take a
- * {@link MaskLabelManagerContext}.
+ * removal.
+ *
+ * The ImageEditor facade owns the canvas and resolved options; this module
+ * receives those dependencies through {@link MaskLabelManagerContext} so
+ * label behavior can be tested without the full facade.
  *
  * ## Owned contracts
  *
  * - Label text is computed via
  *   `options.label.getText(mask, mask.maskId - 1)`. The index argument is
  *   the stable creation index (`maskId - 1`), NOT the live canvas list
- *   position. legacy passed `this.maskCounter` here, which drifted whenever
- *   masks were added or removed; the current contract pins the index to the
+ *   position. Earlier implementations passed `this.maskCounter` here,
+ *   which drifted whenever masks were added or removed; the current
+ *   contract pins the index to the
  *   mask's own identity so labels stay consistent across
  *   `createMask` / `removeSelectedMask` / `removeAllMasks` / `undo`/`redo`.
  *
@@ -23,7 +24,7 @@
  *   re-asserts them on every sync so an externally-mutated label still
  *   honors the contract.
  *
- * - **Pretty_Printer filter** — Every label object is
+ * - **State serializer filter** — Every label object is
  *   tagged with `maskLabel = true` so `core/state-serializer.ts` can
  *   exclude it from history snapshots. Labels are session-only and never
  *   persisted.
@@ -60,7 +61,7 @@ import type { FabricModule, MaskObject, ResolvedOptions } from '../core/public-t
  *
  * The module does NOT own any of these slots — it only reads them so
  * ownership of the canvas, Fabric module, and resolved options stays on the
- * orchestrator (where legacy left them).
+ * orchestrator.
  */
 export interface MaskLabelManagerContext {
     /** Injected Fabric.js v7 module used to construct the label text. */

package/dist/types/mask/mask-label-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mask-label-manager.d.ts","sourceRoot":"","sources":["../../../src/mask/mask-label-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,OAAO,KAAK,KAAK,QAAQ,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAIzF;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACpC,qEAAqE;IACrE,MAAM,EAAE,YAAY,CAAC;IACrB,4DAA4D;IAC5D,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,+DAA+D;IAC/D,OAAO,EAAE,eAAe,CAAC;CAC5B;AAUD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAc3F;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAgE3F;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CA2BtF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CASzF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAuBxE"}
+{"version":3,"file":"mask-label-manager.d.ts","sourceRoot":"","sources":["../../../src/mask/mask-label-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,KAAK,KAAK,QAAQ,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAKzF;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACpC,qEAAqE;IACrE,MAAM,EAAE,YAAY,CAAC;IACrB,4DAA4D;IAC5D,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACxB,+DAA+D;IAC/D,OAAO,EAAE,eAAe,CAAC;CAC5B;AAUD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAc3F;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAiE3F;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CA2BtF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CASzF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAuBxE"}

package/dist/types/mask/mask-list.d.ts

@@ -1,7 +1,8 @@
 /**
- * Mask list DOM rendering — owns the legacy `updateMaskList` and
- * `_handleMaskListClick` logic that was inlined on the editor in
- * legacy and is now extracted into pure(ish) helpers that take a
+ * Mask list DOM rendering and click-to-select behavior.
+ *
+ * The ImageEditor facade owns canvas selection state; this module rebuilds
+ * the list from the current canvas objects and reports user selection through
  * {@link MaskListContext}.
  *
  * ## Owned contracts
@@ -15,7 +16,7 @@
  * - Every `<li>` carries a `data-mask-id` attribute
  *   (via `dataset.maskId`) equal to the mask's `maskId`. Clients keying off
  *   the list (the click handler below, the test suite under
- *   `tests/properties/mask-list-dom.test.mjs`) MUST use this attribute and
+ *   `tests/mask-list-dom.property.test.mjs`) MUST use this attribute and
  *   never the visible label text — the label may be rewritten by the
  *   integrator via `options.label.getText`, so it is NOT a stable key.
  *
@@ -44,8 +45,8 @@
  *   tested in isolation against a stub Fabric environment plus a JSDOM
  *   container.
  * - The DOM contract — `<li class="list-group-item mask-item">` with a
- *   `dataset.maskId` — matches legacy verbatim so existing CSS, theme overrides,
- *   and integrator selectors continue to work unchanged.
+ *   `dataset.maskId` — is stable so existing CSS, theme overrides, and
+ *   integrator selectors continue to work unchanged.
  * - Each render replaces the container's `innerHTML`. That is intentional:
  *   it guarantees the DOM mirrors `canvas.getObjects` exactly, and the
  *   Fabric event handlers (`object:added`, `object:removed`, `selection:*`)
@@ -62,8 +63,7 @@ import type { MaskObject } from '../core/public-types.js';
  *
  * The module does NOT own any of these slots — it only reads them so
  * ownership of the canvas, the resolved DOM element ID map, and the
- * selection-changed pipeline stays on the orchestrator (where legacy left
- * them).
+ * selection-changed pipeline stays on the orchestrator.
  */
 export interface MaskListContext {
     /**
@@ -82,8 +82,7 @@ export interface MaskListContext {
      * Invoked by the click handler after `setActiveObject(mask)` has run,
      * so the orchestrator can drive its selection-changed pipeline (label
      * overlay, hover/selection styling, list highlight) the same way it
-     * does for canvas-originated selections. Mirrors legacy's
-     * `_handleSelectionChanged([mask])` call from `_handleMaskListClick`.
+     * does for canvas-originated selections.
      */
     onMaskSelected(mask: MaskObject): void;
 }
@@ -105,8 +104,8 @@ export interface MaskListContext {
  *    listener bookkeeping to track separately.
  * 3. For each {@link MaskObject} returned by `canvas.getObjects` (in
  *    canvas object order), build a fresh `<li>`:
- *      - class `list-group-item mask-item` (matches legacy verbatim so
- *        existing CSS keeps working);
+ *      - class `list-group-item mask-item` (part of the stable DOM
+ *        contract so existing CSS keeps working);
  *      - `textContent` set to `mask.maskName` (the label-text contract
  *        owned by `mask/mask-label-manager.ts`; this list shows the same
  *        identifier);

package/dist/types/mask/mask-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mask-list.d.ts","sourceRoot":"","sources":["../../../src/mask/mask-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAEH,OAAO,KAAK,KAAK,QAAQ,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC5B;;;;OAIG;IACH,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9C;;;;;;OAMG;IACH,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1C;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CA2C7D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CACnC,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,UAAU,GAAG,IAAI,GAChC,IAAI,CAWN"}
+{"version":3,"file":"mask-list.d.ts","sourceRoot":"","sources":["../../../src/mask/mask-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAEH,OAAO,KAAK,KAAK,QAAQ,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC5B;;;;OAIG;IACH,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9C;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1C;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CA2C7D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CACnC,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,UAAU,GAAG,IAAI,GAChC,IAAI,CAWN"}

package/dist/types/mask/mask-style.d.ts

@@ -1,10 +1,10 @@
 /**
  * Hover, selection, and "original style restore" helpers for
- * mask visual state. Owns the legacy `_getMaskNormalStyle`,
- * `_withNormalizedMaskStyles`, `_rebindMaskEvents`, and the
- * selected/unselected stroke logic from `_handleSelectionChanged`
- * that were inlined on the editor in legacy and are now extracted
- * into pure(ish) helpers that take a {@link MaskStyleContext}.
+ * mask visual state.
+ *
+ * The ImageEditor facade owns canvas state; this module receives the live
+ * canvas and resolved options through {@link MaskStyleContext} so mask
+ * visual behavior stays centralized.
  *
  * Two callers consume the same backup shape:
  *
@@ -21,8 +21,8 @@
  * Centralizing the backup shape, the hover style literals (`#ff5500`,
  * `strokeWidth: 2`, `opacity = originalAlpha + 0.2`), and the
  * selected/unselected stroke literals (`#ff0000`, `mask.originalStroke ||
- * '#ccc'`) here means the legacy visuals stay pixel-identical and any future
- * tweak happens in one place.
+ * '#ccc'`) here keeps mask visuals consistent and any future tweak in one
+ * place.
  *
  * ## Owned contracts
  *
@@ -51,18 +51,17 @@
  *   and `lockRotation` from the captured {@link MaskBackup}, matching the current
  *   documented `MaskBackup` interface.
  *
- * - **Mirrors legacy hover behavior** — {@link attachMaskHoverHandlers} and
- *   {@link reattachMaskHoverHandlers} bind the same `mouseover`/`mouseout`
- *   handlers legacy's `_rebindMaskEvents` used. The handlers read
+ * - **Hover behavior** — {@link attachMaskHoverHandlers} and
+ *   {@link reattachMaskHoverHandlers} bind `mouseover`/`mouseout`
+ *   handlers that read
  *   `mask.originalAlpha` / `mask.originalStroke` / `mask.originalStrokeWidth`
  *   on each invocation so they always reflect the current "live" state
  *   (e.g. after a stroke change from a selection event).
  *
- * - **Mirrors legacy selection styling** — {@link applyMaskSelectedStyle} sets
+ * - **Selection styling** — {@link applyMaskSelectedStyle} sets
  *   the selection-highlight stroke (`#ff0000`, `strokeWidth: 1`) and
  *   {@link applyMaskUnselectedStyle} restores the normal stroke from the
- *   per-mask `originalStroke` / `originalStrokeWidth`. Both literals match
- *   legacy's `_handleSelectionChanged`.
+ *   per-mask `originalStroke` / `originalStrokeWidth`.
  *
  * ## Out of scope (handled by sibling modules)
  *
@@ -81,10 +80,11 @@
  * - Hover handlers do NOT cache the normal/hover style at attach time. They
  *   read `mask.originalAlpha` / `mask.originalStroke` / `mask.originalStrokeWidth`
  *   on every event so the visual matches the live "original" values even
- *   after a stroke or opacity change (matching legacy).
+ *   after a stroke or opacity change.
  * - The handlers are tagged on `mask.imageEditorMaskHandlers` exactly as
- *   legacy did so {@link reattachMaskHoverHandlers} can drop the old pair before
- *   binding fresh ones, avoiding duplicate listeners after `loadFromJSON`.
+ *   {@link reattachMaskHoverHandlers} expects so it can drop the old pair
+ *   before binding fresh ones, avoiding duplicate listeners after
+ *   `loadFromJSON`.
  *
  * @module
  */
@@ -94,8 +94,7 @@ import type { MaskBackup, MaskObject, ResolvedOptions } from '../core/public-typ
  * State the mask-style helpers read from the `ImageEditor` orchestrator.
  *
  * The module does NOT own any of these slots — it only reads them so
- * ownership of the canvas and resolved options stays on the orchestrator
- * (where legacy left them).
+ * ownership of the canvas and resolved options stays on the orchestrator.
  */
 export interface MaskStyleContext {
     /**
@@ -202,8 +201,8 @@ export declare function attachMaskHoverHandlers(mask: MaskObject): void;
  * Also re-asserts the persisted `original*` metadata when missing — legacy's
  * `_rebindMaskEvents` did the same so a snapshot from an older format that
  * happens to lack `originalStroke`/`originalStrokeWidth` still hovers
- * correctly. The current Pretty_Printer always serializes
- * `originalAlpha`, but we defend against partial payloads here too.
+ * correctly. Current snapshots always serialize `originalAlpha`, but we
+ * defend against partial payloads here too.
  *
  * @param mask - The mask to refresh handlers on.
  */

package/dist/types/mask/mask-style.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mask-style.d.ts","sourceRoot":"","sources":["../../../src/mask/mask-style.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFG;AAEH,OAAO,KAAK,KAAK,QAAQ,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAwBvF;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;OAGG;IACH,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,QAAQ,CAAC,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACnB;AAoBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAQpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAQnE;AAID;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAE7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAM/D;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAe9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAwChE;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAU9D;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAWnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAiB/D;AAeD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAiC3F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACvC,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,EAClD,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAM7D"}
+{"version":3,"file":"mask-style.d.ts","sourceRoot":"","sources":["../../../src/mask/mask-style.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFG;AAEH,OAAO,KAAK,KAAK,QAAQ,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAwBvF;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;OAGG;IACH,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,QAAQ,CAAC,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACnB;AAoBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAQpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAQnE;AAID;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAE7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAM/D;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAe9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAwChE;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAU9D;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAWnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAiB/D;AAeD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAiC3F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACvC,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,EAClD,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC,CAiBZ;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAM7D"}

package/dist/types/mosaic/mosaic-controller.d.ts

@@ -8,7 +8,7 @@
  * @module
  */
 import type * as FabricNS from 'fabric';
-import type { FabricModule, ImageEditorCallbackContext, ImageEditorOperation, ImageMimeType, ResolvedMosaicConfig, ResolvedOptions } from '../core/public-types.js';
+import type { BaseImageObject, FabricModule, ImageEditorCallbackContext, ImageEditorOperation, ImageMimeType, ResolvedMosaicConfig, ResolvedOptions } from '../core/public-types.js';
 import { type HistoryManager } from '../history/history-manager.js';
 import { type MosaicImagePoint } from './mosaic-geometry.js';
 interface MosaicPreviewCircle extends FabricNS.Circle {
@@ -49,8 +49,8 @@ export interface MosaicControllerContext {
     readonly historyManager: HistoryManager;
     getMosaicConfig(): ResolvedMosaicConfig;
     isImageLoaded(): boolean;
-    getOriginalImage(): FabricNS.FabricImage | null;
-    setOriginalImage(image: FabricNS.FabricImage | null): void;
+    getOriginalImage(): BaseImageObject | null;
+    setOriginalImage(image: BaseImageObject | null): void;
     getCurrentImageMimeType(): ImageMimeType | null;
     setCurrentImageMimeType(mimeType: ImageMimeType | null): void;
     getLastSnapshot(): string | null;

package/dist/types/mosaic/mosaic-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mosaic-controller.d.ts","sourceRoot":"","sources":["../../../src/mosaic/mosaic-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,KAAK,QAAQ,MAAM,QAAQ,CAAC;AAGxC,OAAO,KAAK,EACR,YAAY,EACZ,0BAA0B,EAC1B,oBAAoB,EACpB,aAAa,EACb,oBAAoB,EACpB,eAAe,EAClB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG7E,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGlF,UAAU,mBAAoB,SAAQ,QAAQ,CAAC,MAAM;IACjD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,UAAU,kBAAmB,SAAQ,QAAQ,CAAC,WAAW;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC1B,aAAa,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACxC,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,gBAAgB,EAAE,KAAK,CAAC;QACpB,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC;QAC9B,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC;KACvB,CAAC,CAAC;IACH,QAAQ,EAAE,KAAK,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;KACtC,CAAC,CAAC;IACH,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACtC,mBAAmB,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,cAAc,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB;IACpC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC,eAAe,IAAI,oBAAoB,CAAC;IACxC,aAAa,IAAI,OAAO,CAAC;IACzB,gBAAgB,IAAI,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC;IAChD,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC;IAC3D,uBAAuB,IAAI,aAAa,GAAG,IAAI,CAAC;IAChD,uBAAuB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAAC;IAC9D,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/C,eAAe,IAAI,MAAM,CAAC;IAC1B,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,QAAQ,IAAI,IAAI,CAAC;IACjB,YAAY,IAAI,IAAI,CAAC;IACrB,iBAAiB,IAAI,IAAI,CAAC;IAC1B,gBAAgB,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAC5D,uBAAuB,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACnE,oBAAoB,CAChB,SAAS,EAAE,oBAAoB,EAC/B,UAAU,CAAC,EAAE,OAAO,GACrB,0BAA0B,CAAC;IAC9B,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAAC;IACzC,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAAC;CACzD;AAQD,UAAU,iBAAiB;IACvB,eAAe,EAAE,iBAAiB,CAAC;IACnC,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB;AAsuBD,wBAAgB,eAAe,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CA8CtE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAYrE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAc1E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,GAAG,OAAO,CAE5E"}
+{"version":3,"file":"mosaic-controller.d.ts","sourceRoot":"","sources":["../../../src/mosaic/mosaic-controller.ts"],"names":[],"mappings":"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"}

package/dist/types/ui/visibility-state.d.ts

@@ -1,7 +1,7 @@
 /**
  * Placeholder/canvas-container visibility helper. Owns the
- * standard-DOM-state transition that the orchestrator's
- * private `_setPlaceholderVisible` method delegates to.
+ * standard-DOM-state transition used by the ImageEditor facade and image
+ * loading pipeline.
  *
  * ## Owned contracts
  *

package/dist/types/utils/file.d.ts

@@ -29,6 +29,19 @@
  */
 export declare const SUPPORTED_IMAGE_EXTENSIONS: Record<string, string>;
 export declare const SUPPORTED_IMAGE_MIME_TYPES: Set<string>;
+/**
+ * Return true only for image data URLs whose MIME type is accepted by the
+ * upload path. This keeps public `loadImage(dataUrl)` validation aligned
+ * with file-input validation and rejects unsupported image containers such as
+ * SVG before any canvas or lifecycle state is touched.
+ *
+ * The `data:image/` prefix remains case-sensitive to preserve the previous
+ * public no-op contract for non-matching data URL prefixes.
+ *
+ * @param value - Candidate data URL.
+ * @returns True when the data URL carries a supported image MIME type.
+ */
+export declare function isSupportedImageDataUrl(value: unknown): value is string;
 /**
  * Determine whether a `File` is a supported image and return its resolved
  * MIME type, or `null` when it should be rejected.

package/dist/types/utils/file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/utils/file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAO7D,CAAC;AAEF,eAAO,MAAM,0BAA0B,aAAqD,CAAC;AAE7F;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAO5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAOnE"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/utils/file.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAO7D,CAAC;AAEF,eAAO,MAAM,0BAA0B,aAAqD,CAAC;AAE7F;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAMvE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAO5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAOnE"}

package/dist/types/utils/image-element-loader.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared browser image element loading primitive.
+ *
+ * Callers provide their own error factory and validation so image loading and
+ * export pipelines can share listener cleanup without sharing domain errors.
+ *
+ * @module
+ */
+export interface ImageElementLoadHandle {
+    promise: Promise<HTMLImageElement>;
+    cleanup(clearSource?: boolean): void;
+}
+export interface ImageElementLoadOptions {
+    crossOrigin?: string;
+    validate?: (imageElement: HTMLImageElement) => Error | null;
+    createError: (event: Event | string) => Error;
+}
+export declare function startImageElementLoad(dataUrl: string, options: ImageElementLoadOptions): ImageElementLoadHandle;
+//# sourceMappingURL=image-element-loader.d.ts.map

package/dist/types/utils/image-element-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-element-loader.d.ts","sourceRoot":"","sources":["../../../src/utils/image-element-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnC,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,uBAAuB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,YAAY,EAAE,gBAAgB,KAAK,KAAK,GAAG,IAAI,CAAC;IAC5D,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,KAAK,KAAK,CAAC;CACjD;AAED,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,uBAAuB,GACjC,sBAAsB,CAsDxB"}

package/dist/types/utils/pointer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Fabric event pointer extraction helpers.
+ *
+ * Supports Fabric v7 `scenePoint`, older pointer fields, and the
+ * `canvas.getPointer(event.e)` fallback used by controller event handlers.
+ *
+ * @module
+ */
+import type * as FabricNS from 'fabric';
+export interface CanvasPoint {
+    x: number;
+    y: number;
+}
+export declare function isFinitePoint(value: unknown): value is CanvasPoint;
+export declare function getPointerFromFabricEvent(canvas: FabricNS.Canvas, event: unknown): CanvasPoint | null;
+//# sourceMappingURL=pointer.d.ts.map

package/dist/types/utils/pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../../src/utils/pointer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,QAAQ,MAAM,QAAQ,CAAC;AAExC,MAAM,WAAW,WAAW;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CASlE;AAED,wBAAgB,yBAAyB,CACrC,MAAM,EAAE,QAAQ,CAAC,MAAM,EACvB,KAAK,EAAE,OAAO,GACf,WAAW,GAAG,IAAI,CAwBpB"}