@pixerate/editor 0.196.0 → 0.198.0

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

@@ -1,6 +1,7 @@
 import { AdjustmentKind, AdjustmentLayer, AdjustmentParamsMap, Annotation, CreateAnnotationPayload, AspectRatio, CropBox, DepthMaskOptions, ExportOptions, ImageAdjustments, ImageDimensions, ImageEditorFit, ImageEditorOptions, ImageEditorState, ImageEditorTool, ImageTransform, ImagePoint, SerializedImageEditorState } 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 { RenderOptions } from './renderer.cjs';
 import { type BlendMode } from './blend.cjs';
 import type { ImageHistogram } from './histogram.cjs';
@@ -140,6 +141,26 @@ export interface SampleOptions {
     /** Pixels to use instead of reading the source image (natural size, RGBA). */
     pixels?: PixelBuffer;
 }
+/** Options of {@link ImageEditorController.quickSelect}. */
+export interface QuickSelectCommandOptions {
+    /** Brush diameter in natural pixels (default 30). */
+    size?: number;
+    /** How the strokes combine with the selection (default `replace`: the first replaces, the rest add). */
+    mode?: SelectionMode;
+    /** Sample every layer (default true) or only the active pixel layer. */
+    sampleAllLayers?: boolean;
+    /** Smoother, less blocky edges (Photoshop's Auto-Enhance). Default false. */
+    enhanceEdge?: boolean;
+}
+/** Options of {@link ImageEditorController.selectObject}. */
+export interface SelectObjectCommandOptions {
+    /** How the object combines with the selection (default `replace`). */
+    mode?: SelectionMode;
+    /** Sample every layer (default true) or only the active pixel layer. */
+    sampleAllLayers?: boolean;
+    /** Smoother, less blocky edges (Auto-Enhance). Default false. */
+    enhanceEdge?: boolean;
+}
 /** A new adjustment layer: its kind plus optional initial values and position. */
 export interface AdjustmentLayerInit<K extends AdjustmentKind = AdjustmentKind> extends AdjustmentLayerUpdate<K> {
     kind: K;
@@ -1505,6 +1526,20 @@ export declare class ImageEditorController {
      * snapped outline in natural pixels, for {@link selectPolygon}.
      */
     snapToEdges(points: ImagePoint[], options?: MagneticEdgeOptions & SampleOptions): Promise<ImagePoint[]>;
+    /**
+     * Quick Selection: each stroke (the brush's path in natural pixels) grows into the region it is
+     * painted on, out to that region's edges, and is combined with the selection by `mode`; with
+     * `replace`, the first stroke replaces it and the rest add, as the brush does. All strokes are
+     * one undo step. Resolves to the resulting selection.
+     */
+    quickSelect(strokes: ImagePoint[][], options?: QuickSelectCommandOptions): Promise<SelectionMask | null>;
+    /**
+     * Object Selection: the object inside `target.rect` (natural pixels; what is outside the box is
+     * background) or under `target.point`, found by GrabCut (colour models of object and background
+     * plus a graph cut along edges), combined with the selection by `mode` as one undo step.
+     * Resolves to the resulting selection.
+     */
+    selectObject(target: ObjectTarget, options?: SelectObjectCommandOptions): Promise<SelectionMask | null>;
     /**
      * Supplies the pixels the selection tools sample (natural size RGBA), e.g. decoded in a worker
      * or in a test; `null` goes back to reading the source image. Without a canvas (Node, workers)

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

@@ -1,6 +1,7 @@
 import { AdjustmentKind, AdjustmentLayer, AdjustmentParamsMap, Annotation, CreateAnnotationPayload, AspectRatio, CropBox, DepthMaskOptions, ExportOptions, ImageAdjustments, ImageDimensions, ImageEditorFit, ImageEditorOptions, ImageEditorState, ImageEditorTool, ImageTransform, ImagePoint, SerializedImageEditorState } 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 { RenderOptions } from './renderer.js';
 import { type BlendMode } from './blend.js';
 import type { ImageHistogram } from './histogram.js';
@@ -140,6 +141,26 @@ export interface SampleOptions {
     /** Pixels to use instead of reading the source image (natural size, RGBA). */
     pixels?: PixelBuffer;
 }
+/** Options of {@link ImageEditorController.quickSelect}. */
+export interface QuickSelectCommandOptions {
+    /** Brush diameter in natural pixels (default 30). */
+    size?: number;
+    /** How the strokes combine with the selection (default `replace`: the first replaces, the rest add). */
+    mode?: SelectionMode;
+    /** Sample every layer (default true) or only the active pixel layer. */
+    sampleAllLayers?: boolean;
+    /** Smoother, less blocky edges (Photoshop's Auto-Enhance). Default false. */
+    enhanceEdge?: boolean;
+}
+/** Options of {@link ImageEditorController.selectObject}. */
+export interface SelectObjectCommandOptions {
+    /** How the object combines with the selection (default `replace`). */
+    mode?: SelectionMode;
+    /** Sample every layer (default true) or only the active pixel layer. */
+    sampleAllLayers?: boolean;
+    /** Smoother, less blocky edges (Auto-Enhance). Default false. */
+    enhanceEdge?: boolean;
+}
 /** A new adjustment layer: its kind plus optional initial values and position. */
 export interface AdjustmentLayerInit<K extends AdjustmentKind = AdjustmentKind> extends AdjustmentLayerUpdate<K> {
     kind: K;
@@ -1505,6 +1526,20 @@ export declare class ImageEditorController {
      * snapped outline in natural pixels, for {@link selectPolygon}.
      */
     snapToEdges(points: ImagePoint[], options?: MagneticEdgeOptions & SampleOptions): Promise<ImagePoint[]>;
+    /**
+     * Quick Selection: each stroke (the brush's path in natural pixels) grows into the region it is
+     * painted on, out to that region's edges, and is combined with the selection by `mode`; with
+     * `replace`, the first stroke replaces it and the rest add, as the brush does. All strokes are
+     * one undo step. Resolves to the resulting selection.
+     */
+    quickSelect(strokes: ImagePoint[][], options?: QuickSelectCommandOptions): Promise<SelectionMask | null>;
+    /**
+     * Object Selection: the object inside `target.rect` (natural pixels; what is outside the box is
+     * background) or under `target.point`, found by GrabCut (colour models of object and background
+     * plus a graph cut along edges), combined with the selection by `mode` as one undo step.
+     * Resolves to the resulting selection.
+     */
+    selectObject(target: ObjectTarget, options?: SelectObjectCommandOptions): Promise<SelectionMask | null>;
     /**
      * Supplies the pixels the selection tools sample (natural size RGBA), e.g. decoded in a worker
      * or in a test; `null` goes back to reading the source image. Without a canvas (Node, workers)