@pixerate/editor 0.207.0 → 0.209.0

package/dist/{chunk-NQMP3CWF.js → chunk-YBJXCQTR.js}

@@ -9,32 +9,37 @@ import {
   multiplyHomographies
 } from "./chunk-OHKOFKBY.js";
 import {
-  TILE,
-  TiledSurface,
+  gaussianBlur
+} from "./chunk-ZIF4UJJ6.js";
+import {
   blendChannel,
   blendRgb,
-  contentBounds,
   deepTile,
-  emptySurface,
-  finishTile,
   isBlendMode,
   isSeparableBlendMode,
   mixPigment8,
   mixPigmentRgb,
   readDeepRegion,
-  readRegion,
   srgbDecode,
   srgbEncode,
   surfaceDepth,
+  tileSamples,
+  to32From8,
+  writeDeepRegion
+} from "./chunk-42TWUPNJ.js";
+import {
+  TILE,
+  TiledSurface,
+  contentBounds,
+  emptySurface,
+  finishTile,
+  readRegion,
   surfaceFromPixels,
   tileKey,
-  tileSamples,
   tilesInRect,
-  to32From8,
   translateSurface,
-  writeDeepRegion,
   writeRegion
-} from "./chunk-H367YTXI.js";
+} from "./chunk-HVVR5PZW.js";
 
 // src/raster/effects/model.ts
 var DEFAULT_GLOBAL_LIGHT = { angle: 120, altitude: 30 };
@@ -2263,104 +2268,6 @@ function decodeInPlace(d) {
   }
 }
 
-// src/raster/blur.ts
-function gaussianKernel(sigma) {
-  const r = Math.ceil(sigma * 3);
-  const k = new Float32Array(2 * r + 1);
-  let s = 0;
-  for (let i = -r; i <= r; i++) {
-    const v = Math.exp(-(i * i) / (2 * sigma * sigma));
-    k[i + r] = v;
-    s += v;
-  }
-  for (let i = 0; i < k.length; i++) k[i] /= s;
-  return k;
-}
-var DIRECT_GAUSSIAN_MAX_SIGMA = 8;
-function boxRadii(sigma) {
-  const n = 3;
-  const wIdeal = Math.sqrt(12 * sigma * sigma / n + 1);
-  let wl = Math.floor(wIdeal);
-  if (wl % 2 === 0) wl--;
-  const wu = wl + 2;
-  const mIdeal = (12 * sigma * sigma - n * wl * wl - 4 * n * wl - 3 * n) / (-4 * wl - 4);
-  const m = Math.round(mIdeal);
-  const sizes = [0, 1, 2].map((i) => i < m ? wl : wu);
-  return sizes.map((s) => (s - 1) / 2);
-}
-function convolveLine(src, off, stride, len, k, edge, dst) {
-  const r = (k.length - 1) / 2;
-  for (let i = 0; i < len; i++) {
-    let a = 0;
-    const lo = i - r;
-    for (let j = 0; j < k.length; j++) {
-      let x = lo + j;
-      if (x < 0 || x >= len) {
-        if (edge === "zero") continue;
-        x = x < 0 ? 0 : len - 1;
-      }
-      a += src[off + x * stride] * k[j];
-    }
-    dst[i] = a;
-  }
-}
-function boxesLine(src, off, stride, len, radii, edge, a, b, dst) {
-  const pad = radii.reduce((s, r) => s + r, 0);
-  const plen = len + 2 * pad;
-  for (let i = 0; i < plen; i++) {
-    const j = i - pad;
-    a[i] = j < 0 ? edge === "zero" ? 0 : src[off] : j >= len ? edge === "zero" ? 0 : src[off + (len - 1) * stride] : src[off + j * stride];
-  }
-  let from = a;
-  let to = b;
-  for (const r of radii) {
-    let sum = 0;
-    for (let i = 0; i <= Math.min(r, plen - 1); i++) sum += from[i];
-    const k = 2 * r + 1;
-    for (let i = 0; i < plen; i++) {
-      to[i] = sum / k;
-      const add = i + r + 1;
-      const drop = i - r;
-      if (add < plen) sum += from[add];
-      if (drop >= 0) sum -= from[drop];
-    }
-    const t = from;
-    from = to;
-    to = t;
-  }
-  for (let i = 0; i < len; i++) dst[i] = from[i + pad];
-}
-function gaussianBlur(src, w, h, sigma, edge = "zero") {
-  const out = Float32Array.from(src);
-  if (!(sigma >= 0.1) || w <= 0 || h <= 0) return out;
-  const s = Math.min(sigma, 4 * Math.max(w, h));
-  const line = new Float32Array(Math.max(w, h));
-  const passes = [];
-  if (s <= DIRECT_GAUSSIAN_MAX_SIGMA) {
-    const k = gaussianKernel(s);
-    passes.push((buf, off, stride, len) => convolveLine(buf, off, stride, len, k, edge, line));
-  } else {
-    const radii = boxRadii(s);
-    const plen = Math.max(w, h) + 2 * radii.reduce((a2, r) => a2 + r, 0);
-    const a = new Float32Array(plen);
-    const b = new Float32Array(plen);
-    passes.push((buf, off, stride, len) => boxesLine(buf, off, stride, len, radii, edge, a, b, line));
-  }
-  for (const pass of passes) {
-    for (let y = 0; y < h; y++) {
-      pass(out, y * w, 1, w);
-      out.set(line.subarray(0, w), y * w);
-    }
-  }
-  for (const pass of passes) {
-    for (let x = 0; x < w; x++) {
-      pass(out, x, w, h);
-      for (let y = 0; y < h; y++) out[y * w + x] = line[y];
-    }
-  }
-  return out;
-}
-
 // src/raster/layers.ts
 var childrenOf = (l) => l.type === "group" ? l.children ?? null : null;
 function flattenLayers(layers) {
@@ -4293,8 +4200,6 @@ export {
   renderLayerEffects,
   DeepCompositor,
   workingToSamples,
-  DIRECT_GAUSSIAN_MAX_SIGMA,
-  gaussianBlur,
   flattenLayers,
   findLayer,
   mapLayer,

package/dist/chunk-ZIF4UJJ6.js

@@ -0,0 +1,102 @@
+// src/raster/blur.ts
+function gaussianKernel(sigma) {
+  const r = Math.ceil(sigma * 3);
+  const k = new Float32Array(2 * r + 1);
+  let s = 0;
+  for (let i = -r; i <= r; i++) {
+    const v = Math.exp(-(i * i) / (2 * sigma * sigma));
+    k[i + r] = v;
+    s += v;
+  }
+  for (let i = 0; i < k.length; i++) k[i] /= s;
+  return k;
+}
+var DIRECT_GAUSSIAN_MAX_SIGMA = 8;
+function boxRadii(sigma) {
+  const n = 3;
+  const wIdeal = Math.sqrt(12 * sigma * sigma / n + 1);
+  let wl = Math.floor(wIdeal);
+  if (wl % 2 === 0) wl--;
+  const wu = wl + 2;
+  const mIdeal = (12 * sigma * sigma - n * wl * wl - 4 * n * wl - 3 * n) / (-4 * wl - 4);
+  const m = Math.round(mIdeal);
+  const sizes = [0, 1, 2].map((i) => i < m ? wl : wu);
+  return sizes.map((s) => (s - 1) / 2);
+}
+function convolveLine(src, off, stride, len, k, edge, dst) {
+  const r = (k.length - 1) / 2;
+  for (let i = 0; i < len; i++) {
+    let a = 0;
+    const lo = i - r;
+    for (let j = 0; j < k.length; j++) {
+      let x = lo + j;
+      if (x < 0 || x >= len) {
+        if (edge === "zero") continue;
+        x = x < 0 ? 0 : len - 1;
+      }
+      a += src[off + x * stride] * k[j];
+    }
+    dst[i] = a;
+  }
+}
+function boxesLine(src, off, stride, len, radii, edge, a, b, dst) {
+  const pad = radii.reduce((s, r) => s + r, 0);
+  const plen = len + 2 * pad;
+  for (let i = 0; i < plen; i++) {
+    const j = i - pad;
+    a[i] = j < 0 ? edge === "zero" ? 0 : src[off] : j >= len ? edge === "zero" ? 0 : src[off + (len - 1) * stride] : src[off + j * stride];
+  }
+  let from = a;
+  let to = b;
+  for (const r of radii) {
+    let sum = 0;
+    for (let i = 0; i <= Math.min(r, plen - 1); i++) sum += from[i];
+    const k = 2 * r + 1;
+    for (let i = 0; i < plen; i++) {
+      to[i] = sum / k;
+      const add = i + r + 1;
+      const drop = i - r;
+      if (add < plen) sum += from[add];
+      if (drop >= 0) sum -= from[drop];
+    }
+    const t = from;
+    from = to;
+    to = t;
+  }
+  for (let i = 0; i < len; i++) dst[i] = from[i + pad];
+}
+function gaussianBlur(src, w, h, sigma, edge = "zero") {
+  const out = Float32Array.from(src);
+  if (!(sigma >= 0.1) || w <= 0 || h <= 0) return out;
+  const s = Math.min(sigma, 4 * Math.max(w, h));
+  const line = new Float32Array(Math.max(w, h));
+  const passes = [];
+  if (s <= DIRECT_GAUSSIAN_MAX_SIGMA) {
+    const k = gaussianKernel(s);
+    passes.push((buf, off, stride, len) => convolveLine(buf, off, stride, len, k, edge, line));
+  } else {
+    const radii = boxRadii(s);
+    const plen = Math.max(w, h) + 2 * radii.reduce((a2, r) => a2 + r, 0);
+    const a = new Float32Array(plen);
+    const b = new Float32Array(plen);
+    passes.push((buf, off, stride, len) => boxesLine(buf, off, stride, len, radii, edge, a, b, line));
+  }
+  for (const pass of passes) {
+    for (let y = 0; y < h; y++) {
+      pass(out, y * w, 1, w);
+      out.set(line.subarray(0, w), y * w);
+    }
+  }
+  for (const pass of passes) {
+    for (let x = 0; x < w; x++) {
+      pass(out, x, w, h);
+      for (let y = 0; y < h; y++) out[y * w + x] = line[y];
+    }
+  }
+  return out;
+}
+
+export {
+  DIRECT_GAUSSIAN_MAX_SIGMA,
+  gaussianBlur
+};

package/dist/{chunk-WTW7QRTS.cjs → chunk-ZMHPQ6HP.cjs}

@@ -74,7 +74,7 @@ function profileAlongPolyline(points, values, count = 32) {
 var round3 = (v) => Math.round(v * 1e3) / 1e3;
 var loading = null;
 function loadCanvasBrushstrokeRenderer() {
-  loading ??= Promise.resolve().then(() => _interopRequireWildcard(require("./brushstrokeRender-VO4ZTWVA.cjs"))).catch((error) => {
+  loading ??= Promise.resolve().then(() => _interopRequireWildcard(require("./brushstrokeRender-EAJNE6WP.cjs"))).catch((error) => {
     loading = null;
     throw error;
   });

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

@@ -1,9 +1,11 @@
-import { AdjustmentKind, AdjustmentLayer, AdjustmentParamsMap, Annotation, CreateAnnotationPayload, AspectRatio, CropBox, DepthMaskOptions, ExportOptions, ImageAdjustments, ImageDimensions, ImageEditorFit, ImageEditorOptions, ImageEditorState, ImageEditorTool, ImageTransform, ImagePoint, SerializedImageEditorState } from './types.cjs';
+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 PathToSelectionOptions, type SelectionToPathOptions } from './selection/path.cjs';
 import { type MagneticEdgeOptions } from './selection/magnetic.cjs';
-import { type ObjectTarget } from './selection/segment/grabcut.cjs';
-import { type FocusAreaOptions } from './selection/segment/focus.cjs';
-import { type SkyOptions } from './selection/segment/sky.cjs';
+import type { ObjectTarget } from './selection/segment/grabcut.cjs';
+import { type SelectionJob, type SelectionJobResult, type SelectionWorkerFactory } from './selection/worker.cjs';
+import type { SelectionProgress } from './selection/segment/work.cjs';
+import type { FocusAreaOptions } from './selection/segment/focus.cjs';
+import type { SkyOptions } from './selection/segment/sky.cjs';
 import { RenderOptions } from './renderer.cjs';
 import { type BlendMode } from './blend.cjs';
 import type { ImageHistogram } from './histogram.cjs';
@@ -146,6 +148,8 @@ export interface SampleOptions {
 }
 /** Options of {@link ImageEditorController.quickSelect}. */
 export interface QuickSelectCommandOptions {
+    signal?: AbortSignal;
+    onProgress?: SelectionProgress;
     /** Brush diameter in natural pixels (default 30). */
     size?: number;
     /** How the strokes combine with the selection (default `replace`: the first replaces, the rest add). */
@@ -157,13 +161,14 @@ export interface QuickSelectCommandOptions {
 }
 /** Options of {@link ImageEditorController.selectFocusArea}. */
 export interface FocusAreaCommandOptions extends FocusAreaOptions {
+    signal?: AbortSignal;
     /** How the area combines with the selection (default `replace`). */
     mode?: SelectionMode;
     /** Sample every layer (default true) or only the active pixel layer. */
     sampleAllLayers?: boolean;
 }
 /** Where Select and Mask puts its result (Photoshop's Output To). */
-export type RefineOutput = 'selection' | 'layer-mask' | 'new-layer' | 'new-layer-with-mask';
+export type RefineOutput = 'selection' | 'layer-mask' | 'new-layer' | 'new-layer-with-mask' | 'new-document' | 'new-document-with-mask';
 /** What {@link ImageEditorController.refineSelectionTo} made. */
 export interface RefineOutputResult {
     output: RefineOutput;
@@ -171,6 +176,8 @@ export interface RefineOutputResult {
     layerId?: string;
     /** The layer it made (`new-layer`, `new-layer-with-mask`). */
     newLayerId?: string;
+    /** The id the host's document opener returned (`new-document`, `new-document-with-mask`). */
+    documentId?: string;
     /** How the edge was refined: by colour, or with the segmentation model (object aware). */
     refineMode: 'color' | 'object';
 }
@@ -186,6 +193,7 @@ export interface SkyCommandOptions extends SkyOptions {
 }
 /** Options of {@link ImageEditorController.selectObject}. */
 export interface SelectObjectCommandOptions {
+    onProgress?: SelectionProgress;
     /**
      * With a segmentation provider set, ask it for the object in the box or under the point (default
      * true), falling back to GrabCut when nothing it returns fits; false always uses GrabCut.
@@ -684,6 +692,8 @@ export declare class ImageEditorController {
     private compositor;
     /** The segmentation provider behind `selectSubject` (see `setSegmentationProvider`). */
     private segmentation;
+    private selectionWorker;
+    private documentOpener;
     /** The effects provider slot (see `setEffectsProvider`). */
     readonly effects: EffectsSlot;
     /** Renders provider effects: effect smart filter results and effect layers. */
@@ -714,6 +724,40 @@ export declare class ImageEditorController {
     private refreshEffectSurfaces;
     /** The registered segmentation provider, or `null` (then `selectSubject` finds the most salient subject without a model). */
     get segmentationProvider(): SegmentationProvider | null;
+    /**
+     * Runs the long selections in a Web Worker made by `factory` (or with `null`, on the page again).
+     * A worker that is cancelled or fails is replaced by a fresh one on the next job.
+     */
+    setSelectionWorker(factory: SelectionWorkerFactory | null): void;
+    /** Sets (or with `null` removes) how new documents are opened (see `DocumentOpener`). Not an edit. */
+    setDocumentOpener(opener: DocumentOpener | null): void;
+    /** Whether the host can open new documents (the New Document outputs are available). */
+    get canOpenDocuments(): boolean;
+    /**
+     * A new one-layer document from the selection (or `options.selection`) on a pixel layer
+     * (`layerId`, default the active one), the size of this image: the selected pixels on
+     * transparency, or with `withMask` the whole layer masked by the selection. This document is
+     * not changed. `decontaminate` (0..100) cleans the soft edge's colours as the new-layer
+     * outputs do.
+     */
+    documentFromSelection(options?: {
+        layerId?: string;
+        withMask?: boolean;
+        selection?: SelectionMask | null;
+        decontaminate?: number;
+        radius?: number;
+    }): SerializedLayeredImageEditorState;
+    /** Whether the long selections run in a worker. */
+    get hasSelectionWorker(): boolean;
+    /**
+     * Runs a long selection job on `pixels`: in the worker when there is one, else here (which
+     * blocks the page until it is done). `signal` cancels it (rejecting with an `AbortError`);
+     * `onProgress` hears its stages. The document is not changed.
+     */
+    runSelectionJob(job: SelectionJob, pixels: PixelBuffer, options?: {
+        signal?: AbortSignal;
+        onProgress?: SelectionProgress;
+    }): Promise<SelectionJobResult>;
     /** Registers (or with `null` removes) the segmentation provider. Not an edit: no undo step. */
     setSegmentationProvider(provider: SegmentationProvider | null): void;
     /** The registered effects provider, or `null`. */
@@ -1673,6 +1717,8 @@ export declare class ImageEditorController {
      * its alpha.
      */
     private decontaminateLayer;
+    /** `layer`'s surface with Decontaminate Colors applied along `coverage`'s soft edge, colours read from `source`. */
+    private decontaminatedSurface;
     /**
      * Loads a selection from a mask image (an AI segmentation, a saved mask): a data URL / URL or
      * RGBA pixels, by luminance (white = selected) or a channel. Any size; it is resampled.
@@ -1723,6 +1769,8 @@ export declare class ImageEditorController {
         beforeApply?: (outlines: ImagePoint[][]) => void | Promise<void>;
         /** Without a model: smoother, less blocky edges (Auto-Enhance). */
         enhanceEdge?: boolean;
+        /** Without a model: hears the stages of finding the subject. */
+        onProgress?: SelectionProgress;
     }): Promise<{
         segments: {
             label: string;

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

@@ -1,9 +1,11 @@
-import { AdjustmentKind, AdjustmentLayer, AdjustmentParamsMap, Annotation, CreateAnnotationPayload, AspectRatio, CropBox, DepthMaskOptions, ExportOptions, ImageAdjustments, ImageDimensions, ImageEditorFit, ImageEditorOptions, ImageEditorState, ImageEditorTool, ImageTransform, ImagePoint, SerializedImageEditorState } from './types.js';
+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 PathToSelectionOptions, type SelectionToPathOptions } from './selection/path.js';
 import { type MagneticEdgeOptions } from './selection/magnetic.js';
-import { type ObjectTarget } from './selection/segment/grabcut.js';
-import { type FocusAreaOptions } from './selection/segment/focus.js';
-import { type SkyOptions } from './selection/segment/sky.js';
+import type { ObjectTarget } from './selection/segment/grabcut.js';
+import { type SelectionJob, type SelectionJobResult, type SelectionWorkerFactory } from './selection/worker.js';
+import type { SelectionProgress } from './selection/segment/work.js';
+import type { FocusAreaOptions } from './selection/segment/focus.js';
+import type { SkyOptions } from './selection/segment/sky.js';
 import { RenderOptions } from './renderer.js';
 import { type BlendMode } from './blend.js';
 import type { ImageHistogram } from './histogram.js';
@@ -146,6 +148,8 @@ export interface SampleOptions {
 }
 /** Options of {@link ImageEditorController.quickSelect}. */
 export interface QuickSelectCommandOptions {
+    signal?: AbortSignal;
+    onProgress?: SelectionProgress;
     /** Brush diameter in natural pixels (default 30). */
     size?: number;
     /** How the strokes combine with the selection (default `replace`: the first replaces, the rest add). */
@@ -157,13 +161,14 @@ export interface QuickSelectCommandOptions {
 }
 /** Options of {@link ImageEditorController.selectFocusArea}. */
 export interface FocusAreaCommandOptions extends FocusAreaOptions {
+    signal?: AbortSignal;
     /** How the area combines with the selection (default `replace`). */
     mode?: SelectionMode;
     /** Sample every layer (default true) or only the active pixel layer. */
     sampleAllLayers?: boolean;
 }
 /** Where Select and Mask puts its result (Photoshop's Output To). */
-export type RefineOutput = 'selection' | 'layer-mask' | 'new-layer' | 'new-layer-with-mask';
+export type RefineOutput = 'selection' | 'layer-mask' | 'new-layer' | 'new-layer-with-mask' | 'new-document' | 'new-document-with-mask';
 /** What {@link ImageEditorController.refineSelectionTo} made. */
 export interface RefineOutputResult {
     output: RefineOutput;
@@ -171,6 +176,8 @@ export interface RefineOutputResult {
     layerId?: string;
     /** The layer it made (`new-layer`, `new-layer-with-mask`). */
     newLayerId?: string;
+    /** The id the host's document opener returned (`new-document`, `new-document-with-mask`). */
+    documentId?: string;
     /** How the edge was refined: by colour, or with the segmentation model (object aware). */
     refineMode: 'color' | 'object';
 }
@@ -186,6 +193,7 @@ export interface SkyCommandOptions extends SkyOptions {
 }
 /** Options of {@link ImageEditorController.selectObject}. */
 export interface SelectObjectCommandOptions {
+    onProgress?: SelectionProgress;
     /**
      * With a segmentation provider set, ask it for the object in the box or under the point (default
      * true), falling back to GrabCut when nothing it returns fits; false always uses GrabCut.
@@ -684,6 +692,8 @@ export declare class ImageEditorController {
     private compositor;
     /** The segmentation provider behind `selectSubject` (see `setSegmentationProvider`). */
     private segmentation;
+    private selectionWorker;
+    private documentOpener;
     /** The effects provider slot (see `setEffectsProvider`). */
     readonly effects: EffectsSlot;
     /** Renders provider effects: effect smart filter results and effect layers. */
@@ -714,6 +724,40 @@ export declare class ImageEditorController {
     private refreshEffectSurfaces;
     /** The registered segmentation provider, or `null` (then `selectSubject` finds the most salient subject without a model). */
     get segmentationProvider(): SegmentationProvider | null;
+    /**
+     * Runs the long selections in a Web Worker made by `factory` (or with `null`, on the page again).
+     * A worker that is cancelled or fails is replaced by a fresh one on the next job.
+     */
+    setSelectionWorker(factory: SelectionWorkerFactory | null): void;
+    /** Sets (or with `null` removes) how new documents are opened (see `DocumentOpener`). Not an edit. */
+    setDocumentOpener(opener: DocumentOpener | null): void;
+    /** Whether the host can open new documents (the New Document outputs are available). */
+    get canOpenDocuments(): boolean;
+    /**
+     * A new one-layer document from the selection (or `options.selection`) on a pixel layer
+     * (`layerId`, default the active one), the size of this image: the selected pixels on
+     * transparency, or with `withMask` the whole layer masked by the selection. This document is
+     * not changed. `decontaminate` (0..100) cleans the soft edge's colours as the new-layer
+     * outputs do.
+     */
+    documentFromSelection(options?: {
+        layerId?: string;
+        withMask?: boolean;
+        selection?: SelectionMask | null;
+        decontaminate?: number;
+        radius?: number;
+    }): SerializedLayeredImageEditorState;
+    /** Whether the long selections run in a worker. */
+    get hasSelectionWorker(): boolean;
+    /**
+     * Runs a long selection job on `pixels`: in the worker when there is one, else here (which
+     * blocks the page until it is done). `signal` cancels it (rejecting with an `AbortError`);
+     * `onProgress` hears its stages. The document is not changed.
+     */
+    runSelectionJob(job: SelectionJob, pixels: PixelBuffer, options?: {
+        signal?: AbortSignal;
+        onProgress?: SelectionProgress;
+    }): Promise<SelectionJobResult>;
     /** Registers (or with `null` removes) the segmentation provider. Not an edit: no undo step. */
     setSegmentationProvider(provider: SegmentationProvider | null): void;
     /** The registered effects provider, or `null`. */
@@ -1673,6 +1717,8 @@ export declare class ImageEditorController {
      * its alpha.
      */
     private decontaminateLayer;
+    /** `layer`'s surface with Decontaminate Colors applied along `coverage`'s soft edge, colours read from `source`. */
+    private decontaminatedSurface;
     /**
      * Loads a selection from a mask image (an AI segmentation, a saved mask): a data URL / URL or
      * RGBA pixels, by luminance (white = selected) or a channel. Any size; it is resampled.
@@ -1723,6 +1769,8 @@ export declare class ImageEditorController {
         beforeApply?: (outlines: ImagePoint[][]) => void | Promise<void>;
         /** Without a model: smoother, less blocky edges (Auto-Enhance). */
         enhanceEdge?: boolean;
+        /** Without a model: hears the stages of finding the subject. */
+        onProgress?: SelectionProgress;
     }): Promise<{
         segments: {
             label: string;