@bensitu/image-editor 2.0.0 → 2.1.0

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

@@ -0,0 +1,82 @@
+/**
+ * Mosaic mode controller.
+ *
+ * Owns the Mosaic session lifecycle, preview objects, Fabric pointer handlers,
+ * and the base-image pixel replacement pipeline. The ImageEditor facade owns
+ * canonical editor state and passes it in through the context callbacks.
+ *
+ * @module
+ */
+import type * as FabricNS from 'fabric';
+import type { 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 {
+    isMosaicPreview?: boolean;
+}
+interface MosaicPreviewImage extends FabricNS.FabricImage {
+    isMosaicPreview?: boolean;
+}
+export interface MosaicSession {
+    previewCircle: MosaicPreviewCircle | null;
+    previewImage: MosaicPreviewImage | null;
+    prevSelection: boolean;
+    prevDefaultCursor: string | undefined;
+    prevObjectStates: Array<{
+        object: FabricNS.FabricObject;
+        evented: boolean;
+        selectable: boolean;
+    }>;
+    handlers: Array<{
+        eventName: string;
+        callback: (event: unknown) => void;
+    }>;
+    rasterCache: MosaicRasterCache | null;
+    pendingCanvasPoints: Array<{
+        x: number;
+        y: number;
+    }>;
+    isPointerDown: boolean;
+    isApplying: boolean;
+    commitRequested: boolean;
+    hasUncommittedChanges: boolean;
+    lastImagePoint: MosaicImagePoint | null;
+}
+export interface MosaicControllerContext {
+    readonly fabric: FabricModule;
+    readonly canvas: FabricNS.Canvas;
+    readonly options: ResolvedOptions;
+    readonly historyManager: HistoryManager;
+    getMosaicConfig(): ResolvedMosaicConfig;
+    isImageLoaded(): boolean;
+    getOriginalImage(): FabricNS.FabricImage | null;
+    setOriginalImage(image: FabricNS.FabricImage | null): void;
+    getCurrentImageMimeType(): ImageMimeType | null;
+    setCurrentImageMimeType(mimeType: ImageMimeType | null): void;
+    getLastSnapshot(): string | null;
+    setLastSnapshot(snapshot: string | null): void;
+    captureSnapshot(): string;
+    loadFromState(snapshot: string): Promise<void>;
+    updateUi(): void;
+    updateInputs(): void;
+    hideAllMaskLabels(): void;
+    emitImageChanged(context: ImageEditorCallbackContext): void;
+    emitBusyChangeIfChanged(context: ImageEditorCallbackContext): void;
+    buildCallbackContext(operation: ImageEditorOperation, isInternal?: boolean): ImageEditorCallbackContext;
+    getMosaicSession(): MosaicSession | null;
+    setMosaicSession(session: MosaicSession | null): void;
+}
+interface MosaicRasterCache {
+    offscreenCanvas: HTMLCanvasElement;
+    renderingContext: CanvasRenderingContext2D;
+    imageData: ImageData;
+    source: string;
+    width: number;
+    height: number;
+}
+export declare function enterMosaicMode(context: MosaicControllerContext): void;
+export declare function exitMosaicMode(context: MosaicControllerContext): void;
+export declare function updateMosaicPreview(context: MosaicControllerContext): void;
+export declare function isMosaicPreviewObject(object: FabricNS.FabricObject): boolean;
+export {};
+//# sourceMappingURL=mosaic-controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mosaic-controller.d.ts","sourceRoot":"","sources":["../../../src/mosaic/mosaic-controller.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,29 @@
+/**
+ * Canvas-to-source-image coordinate conversion for Mosaic mode.
+ *
+ * Fabric object bounding boxes are not sufficient for rotated images. These
+ * helpers invert the image transform matrix and convert the pointer into the
+ * image's natural pixel coordinate space.
+ *
+ * @module
+ */
+import type * as FabricNS from 'fabric';
+import type { FabricModule } from '../core/public-types.js';
+export interface MosaicImagePoint {
+    sourceX: number;
+    sourceY: number;
+    sourceRadius: number;
+}
+/**
+ * Convert a Fabric canvas pointer into source-image pixels.
+ *
+ * For non-uniform image scale, `sourceRadius` uses the smaller canvas scale
+ * axis, which yields the larger source-space radius. This conservative
+ * deterministic strategy ensures the circular canvas brush covers the clicked
+ * image area after inverse transformation.
+ */
+export declare function getMosaicImagePoint(fabric: FabricModule, image: FabricNS.FabricImage, canvasPoint: {
+    x: number;
+    y: number;
+}, brushDiameterCanvasPx: number): MosaicImagePoint | null;
+//# sourceMappingURL=mosaic-geometry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mosaic-geometry.d.ts","sourceRoot":"","sources":["../../../src/mosaic/mosaic-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,KAAK,QAAQ,MAAM,QAAQ,CAAC;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACxB;AAwED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,QAAQ,CAAC,WAAW,EAC3B,WAAW,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACrC,qBAAqB,EAAE,MAAM,GAC9B,gBAAgB,GAAG,IAAI,CAmCzB"}

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

@@ -0,0 +1,23 @@
+/**
+ * Pure pixelation helpers for Mosaic mode.
+ *
+ * The helpers mutate caller-supplied ImageData in place and do not touch DOM
+ * or Fabric state, which keeps the algorithm deterministic and directly
+ * testable.
+ *
+ * @module
+ */
+export interface MosaicPixelateOptions {
+    imageData: ImageData;
+    centerX: number;
+    centerY: number;
+    radius: number;
+    blockSize: number;
+}
+/**
+ * Applies blocky pixelation inside a circular brush region.
+ *
+ * @returns `true` when at least one pixel was processed, otherwise `false`.
+ */
+export declare function applyCircularMosaicToImageData(options: MosaicPixelateOptions): boolean;
+//# sourceMappingURL=mosaic-pixelate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mosaic-pixelate.d.ts","sourceRoot":"","sources":["../../../src/mosaic/mosaic-pixelate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACrB;AAsBD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAiEtF"}

package/dist/types/ui/dom-bindings.d.ts

@@ -64,6 +64,7 @@ export declare class DomBindings {
     private registry;
     private readonly resolveElementId;
     private readonly isDisposed;
+    private readonly resolveDocument;
     /**
      * @param resolveElementId - Returns the resolved DOM element ID for a given logical key, or a
      *   falsy value when the integrator omitted that key from the `idMap`.
@@ -71,8 +72,9 @@ export declare class DomBindings {
      * @param isDisposed - Returns the editor's current `isDisposed` flag. Bound handlers
      *   consult this on every dispatch and exit early when it returns
      *   `true`.
+     * @param resolveDocument - Returns the document that owns the bound controls.
      */
-    constructor(resolveElementId: (key: ElementKey) => string | null | undefined, isDisposed: () => boolean);
+    constructor(resolveElementId: (key: ElementKey) => string | null | undefined, isDisposed: () => boolean, resolveDocument?: () => Document);
     /**
      * Look up the element registered under `key`. If it exists, attach
      * `handler` for `eventType` and record the binding so `removeAll` can

package/dist/types/ui/dom-bindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom-bindings.d.ts","sourceRoot":"","sources":["../../../src/ui/dom-bindings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;AActD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiD;IAClF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAE3C;;;;;;;OAOG;gBAEC,gBAAgB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,EAChE,UAAU,EAAE,MAAM,OAAO;IAM7B;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO;IAmBjF;;;;;;OAMG;IACH,SAAS,IAAI,IAAI;IAgBjB;;;OAGG;IACH,IAAI,IAAI,MAAM;CAGjB"}
+{"version":3,"file":"dom-bindings.d.ts","sourceRoot":"","sources":["../../../src/ui/dom-bindings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;AActD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiD;IAClF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IAEjD;;;;;;;;OAQG;gBAEC,gBAAgB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,EAChE,UAAU,EAAE,MAAM,OAAO,EACzB,eAAe,GAAE,MAAM,QAAyB;IAOpD;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO;IAmBjF;;;;;;OAMG;IACH,SAAS,IAAI,IAAI;IAgBjB;;;OAGG;IACH,IAAI,IAAI,MAAM;CAGjB"}

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

@@ -35,8 +35,7 @@
  *   deterministic across canvas resizes.
  * - The helper does NOT clamp the result against canvas bounds; callers
  *   are responsible for any subsequent clamping (the mask factory may
- *   expand the canvas to accommodate larger placements when
- *   `expandCanvasToImage` is enabled).
+ *   expand the canvas to accommodate larger placements in expand layout mode).
  *
  * ## Non-goals
  *

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

@@ -1 +1 @@
-{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../src/utils/number.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,KAAK,KAAK,QAAQ,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE9F;;;;;;GAMG;AACH,MAAM,MAAM,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,cAAc,CAC1B,GAAG,EAAE,eAAe,GAAG,SAAS,EAChC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,QAAQ,CAAC,MAAM,EACvB,OAAO,EAAE,eAAe,GACzB,MAAM,CAgBR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,YAAY,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAKtE"}
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../src/utils/number.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,OAAO,KAAK,KAAK,QAAQ,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE9F;;;;;;GAMG;AACH,MAAM,MAAM,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,cAAc,CAC1B,GAAG,EAAE,eAAe,GAAG,SAAS,EAChC,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,QAAQ,CAAC,MAAM,EACvB,OAAO,EAAE,eAAe,GACzB,MAAM,CAgBR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,YAAY,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAKtE"}