@pixerate/editor 0.204.0 → 0.205.0

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

@@ -161,6 +161,16 @@ export interface FocusAreaCommandOptions extends FocusAreaOptions {
     /** 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';
+/** What {@link ImageEditorController.refineSelectionTo} made. */
+export interface RefineOutputResult {
+    output: RefineOutput;
+    /** The layer the output came from (all but `selection`). */
+    layerId?: string;
+    /** The layer it made (`new-layer`, `new-layer-with-mask`). */
+    newLayerId?: string;
+}
 /** Options of {@link ImageEditorController.selectSky}. */
 export interface SkyCommandOptions extends SkyOptions {
     /** With a segmentation provider set, ask it for the sky (default true); false finds it classically. */
@@ -1632,6 +1642,26 @@ export declare class ImageEditorController {
      * to the image's edges with a guided filter, then smooth / feather / contrast / shift edge.
      */
     refineSelection(params: RefineEdgeParams, options?: SampleOptions): Promise<boolean>;
+    /**
+     * Select and Mask's output: refines the selection with `params`, then puts the result where
+     * `output` says, as one undo step:
+     * - `selection`: the refined selection;
+     * - `layer-mask`: a mask on the layer (`layerId`, default the active one), then deselects;
+     * - `new-layer`: a new layer of the layer's selected pixels (Layer via Copy), the source hidden;
+     * - `new-layer-with-mask`: a copy of the layer masked by the selection, the source hidden.
+     * `decontaminate` (0..100, new-layer outputs only) replaces the old background's colour in the
+     * soft edge with the subject's own (see `decontaminateColors`).
+     */
+    refineSelectionTo(params: RefineEdgeParams, output?: RefineOutput, options?: SampleOptions & {
+        layerId?: string;
+        decontaminate?: number;
+    }): Promise<RefineOutputResult>;
+    /**
+     * Decontaminate Colors along the soft edge of `coverage`: the colours are estimated from the
+     * source layer (whose background is still there) and written into layer `id`'s RGB, keeping
+     * its alpha.
+     */
+    private decontaminateLayer;
     /**
      * 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.

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

@@ -161,6 +161,16 @@ export interface FocusAreaCommandOptions extends FocusAreaOptions {
     /** 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';
+/** What {@link ImageEditorController.refineSelectionTo} made. */
+export interface RefineOutputResult {
+    output: RefineOutput;
+    /** The layer the output came from (all but `selection`). */
+    layerId?: string;
+    /** The layer it made (`new-layer`, `new-layer-with-mask`). */
+    newLayerId?: string;
+}
 /** Options of {@link ImageEditorController.selectSky}. */
 export interface SkyCommandOptions extends SkyOptions {
     /** With a segmentation provider set, ask it for the sky (default true); false finds it classically. */
@@ -1632,6 +1642,26 @@ export declare class ImageEditorController {
      * to the image's edges with a guided filter, then smooth / feather / contrast / shift edge.
      */
     refineSelection(params: RefineEdgeParams, options?: SampleOptions): Promise<boolean>;
+    /**
+     * Select and Mask's output: refines the selection with `params`, then puts the result where
+     * `output` says, as one undo step:
+     * - `selection`: the refined selection;
+     * - `layer-mask`: a mask on the layer (`layerId`, default the active one), then deselects;
+     * - `new-layer`: a new layer of the layer's selected pixels (Layer via Copy), the source hidden;
+     * - `new-layer-with-mask`: a copy of the layer masked by the selection, the source hidden.
+     * `decontaminate` (0..100, new-layer outputs only) replaces the old background's colour in the
+     * soft edge with the subject's own (see `decontaminateColors`).
+     */
+    refineSelectionTo(params: RefineEdgeParams, output?: RefineOutput, options?: SampleOptions & {
+        layerId?: string;
+        decontaminate?: number;
+    }): Promise<RefineOutputResult>;
+    /**
+     * Decontaminate Colors along the soft edge of `coverage`: the colours are estimated from the
+     * source layer (whose background is still there) and written into layer `id`'s RGB, keeping
+     * its alpha.
+     */
+    private decontaminateLayer;
     /**
      * 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.