@pixerate/editor 0.216.0 → 0.217.0

package/dist/image-editor/controller.d.cts

@@ -1,5 +1,6 @@
 import { AdjustmentKind, AdjustmentLayer, AdjustmentParamsMap, Annotation, CreateAnnotationPayload, AspectRatio, CropBox, DepthMaskOptions, ExportOptions, ImageAdjustments, ImageDimensions, ImageEditorFit, ImageEditorOptions, ImageEditorState, ImageEditorTool, ImageTransform, ImagePoint, SerializedImageEditorState, DocumentOpener } from './types.cjs';
 import { type InspectMaskEdgeOptions, type MaskEdgeReport } from './selection/inspect.cjs';
+import { type CompareSelectionsOptions, type SelectionDiff } from './selection/diff.cjs';
 import { type SelectionUncertainty, type SelectionUncertaintyOptions } from './selection/uncertainty.cjs';
 import { type PathToSelectionOptions, type SelectionToPathOptions } from './selection/path.cjs';
 import { type MagneticEdgeOptions } from './selection/magnetic.cjs';
@@ -284,6 +285,22 @@ export interface CloneSource {
 /** A vector mask's path: several `components`, or one `shape` / `subpaths` (with `op`). */
 /** What `inspectMaskEdge` reads: the selection, a layer's painted mask or its vector mask. */
 export type MaskEdgeTarget = 'selection' | 'layer-mask' | 'vector-mask';
+/** A selection `compareSelections` reads (see `selectionFrom`). */
+export type SelectionSource = {
+    kind: 'selection';
+} | {
+    kind: 'history';
+    steps?: number;
+} | {
+    kind: 'channel';
+    channelId: string;
+} | {
+    kind: 'layer-mask';
+    layerId: string;
+} | {
+    kind: 'vector-mask';
+    layerId: string;
+};
 /** A layer's edge colour as `getEdgeColor` describes it (percentages). */
 export interface EdgeColorInfo {
     layerId: string;
@@ -2066,6 +2083,22 @@ export declare class ImageEditorController {
      * selection has none.
      */
     selectionUncertainty(options?: SelectionUncertaintyOptions): SelectionUncertainty;
+    /**
+     * A selection to compare (`compareSelections`): the current one, the one `steps` undo steps
+     * ago, a saved channel, or a layer's painted or vector mask. `null` is nothing selected.
+     */
+    selectionFrom(source: SelectionSource): SelectionMask | null;
+    /**
+     * What changed from selection `a` (default: before the last undo step) to `b` (default: the
+     * current selection): added and removed area with their largest pieces, IoU and the coverage
+     * change. With `show` (default true) the canvas tints added area green and removed red until the
+     * selection next changes (view state, no undo step). Read-only otherwise.
+     */
+    compareSelections(a?: SelectionSource, b?: SelectionSource, options?: CompareSelectionsOptions & {
+        show?: boolean;
+    }): SelectionDiff;
+    /** Hides the `compareSelections` overlay. */
+    clearSelectionDiff(): void;
     /** A layer's painted mask over the canvas as a selection mask; null without one (or for a depth mask). */
     private layerMaskCoverage;
     /**

package/dist/image-editor/controller.d.ts

@@ -1,5 +1,6 @@
 import { AdjustmentKind, AdjustmentLayer, AdjustmentParamsMap, Annotation, CreateAnnotationPayload, AspectRatio, CropBox, DepthMaskOptions, ExportOptions, ImageAdjustments, ImageDimensions, ImageEditorFit, ImageEditorOptions, ImageEditorState, ImageEditorTool, ImageTransform, ImagePoint, SerializedImageEditorState, DocumentOpener } from './types.js';
 import { type InspectMaskEdgeOptions, type MaskEdgeReport } from './selection/inspect.js';
+import { type CompareSelectionsOptions, type SelectionDiff } from './selection/diff.js';
 import { type SelectionUncertainty, type SelectionUncertaintyOptions } from './selection/uncertainty.js';
 import { type PathToSelectionOptions, type SelectionToPathOptions } from './selection/path.js';
 import { type MagneticEdgeOptions } from './selection/magnetic.js';
@@ -284,6 +285,22 @@ export interface CloneSource {
 /** A vector mask's path: several `components`, or one `shape` / `subpaths` (with `op`). */
 /** What `inspectMaskEdge` reads: the selection, a layer's painted mask or its vector mask. */
 export type MaskEdgeTarget = 'selection' | 'layer-mask' | 'vector-mask';
+/** A selection `compareSelections` reads (see `selectionFrom`). */
+export type SelectionSource = {
+    kind: 'selection';
+} | {
+    kind: 'history';
+    steps?: number;
+} | {
+    kind: 'channel';
+    channelId: string;
+} | {
+    kind: 'layer-mask';
+    layerId: string;
+} | {
+    kind: 'vector-mask';
+    layerId: string;
+};
 /** A layer's edge colour as `getEdgeColor` describes it (percentages). */
 export interface EdgeColorInfo {
     layerId: string;
@@ -2066,6 +2083,22 @@ export declare class ImageEditorController {
      * selection has none.
      */
     selectionUncertainty(options?: SelectionUncertaintyOptions): SelectionUncertainty;
+    /**
+     * A selection to compare (`compareSelections`): the current one, the one `steps` undo steps
+     * ago, a saved channel, or a layer's painted or vector mask. `null` is nothing selected.
+     */
+    selectionFrom(source: SelectionSource): SelectionMask | null;
+    /**
+     * What changed from selection `a` (default: before the last undo step) to `b` (default: the
+     * current selection): added and removed area with their largest pieces, IoU and the coverage
+     * change. With `show` (default true) the canvas tints added area green and removed red until the
+     * selection next changes (view state, no undo step). Read-only otherwise.
+     */
+    compareSelections(a?: SelectionSource, b?: SelectionSource, options?: CompareSelectionsOptions & {
+        show?: boolean;
+    }): SelectionDiff;
+    /** Hides the `compareSelections` overlay. */
+    clearSelectionDiff(): void;
     /** A layer's painted mask over the canvas as a selection mask; null without one (or for a depth mask). */
     private layerMaskCoverage;
     /**