@pixerate/editor 0.183.0 → 0.186.0

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

@@ -4,11 +4,12 @@ import { type BlendMode } from './blend.cjs';
 import type { ImageHistogram } from './histogram.cjs';
 import { type PixelBuffer, type SelectionChannel, type SelectionMask, type SelectionMode } from './selection/mask.cjs';
 import { type ShapeSelectionOptions } from './selection/shapes.cjs';
-import { type ColorRangeOptions, type ColorRangeSample, type MagicWandOptions } from './selection/wand.cjs';
+import { type GrowSimilarOptions, type ColorRangeOptions, type ColorRangePreset, type ColorRangeSample, type MagicWandOptions } from './selection/wand.cjs';
 import { type SelectionModifyOp } from './selection/modify.cjs';
 import { type SegmentationProvider } from './selection/segmentation.cjs';
 import { type RefineEdgeParams } from './selection/refine.cjs';
-import type { LayerMaskProps } from './selection/layer-mask.cjs';
+import { type LayerMaskProps } from './selection/layer-mask.cjs';
+import { type AlphaChannel } from './selection/channels.cjs';
 import type { AdjustmentLayerMask } from './types.cjs';
 import { type LayerBlendMode, type ImageLayer, type LayerFilter, type LayerTarget, type PixelLayer, type RasterMask, type SmartContents, type SmartFilter, type SmartPlacement, type LiveShape, type ShapeFillRule, type ShapeOperation, type ShapePaint, type ShapeStroke, type ParagraphStyle, type TextStyle, type TypeLayer, type ImageEffectAnimation } from './layers/model.cjs';
 import { type TextLayout, type TextShaper } from './layers/text.cjs';
@@ -107,7 +108,11 @@ export interface SelectionCommandOptions {
     mode?: SelectionMode;
     /** Feather the new shape by this many pixels before combining (default 0). */
     feather?: number;
+    /** Invert the new shape before combining (Color Range › Invert; default false). */
+    invert?: boolean;
 }
+/** How the canvas shows the selection: marching ants, a Quick Mask tint, or not at all. */
+export type SelectionDisplay = 'ants' | 'quickMask' | 'none';
 /** Where an AI result goes (see `applyInpaintedImage`, `applyBackgroundRemovedImage`). */
 export interface AIResultOptions {
     /** `new-layer`: a new layer (inpainting) or a mask (background removal); `replace`: the Background's pixels. Default: by `isMultiLayer`. */
@@ -133,6 +138,11 @@ export interface AdjustmentLayerInit<K extends AdjustmentKind = AdjustmentKind>
     aboveId?: string;
     /** Put the new layer at the top of this group. */
     parentId?: string;
+    /**
+     * Mask the new layer with the selection when there is one and no `mask` is given (Photoshop's
+     * behaviour). Default false here, for compatibility; the agent tool and the panels pass true.
+     */
+    useSelection?: boolean;
 }
 /** A new pixel layer: empty, a solid colour over the canvas, or given pixels, plus its properties and position. */
 export interface PixelLayerInit extends LayerPlacement {
@@ -345,6 +355,33 @@ export interface FillOptions {
     /** Limit to the selection when there is one (default true). */
     useSelection?: boolean;
 }
+/** The `layerId` paint results report for Quick Mask edits (the selection, not a layer). */
+export declare const QUICK_MASK_TARGET = "quick-mask";
+/** Edit › Stroke (see `strokeSelection`). */
+export interface StrokeSelectionOptions extends Omit<FillOptions, 'useSelection'> {
+    /** Width of the band in pixels (0 < width ≤ 250). */
+    width: number;
+    /** Where the band lies against the selection edge (default `outside`). */
+    location?: 'inside' | 'center' | 'outside';
+}
+/** Edit › Content-Aware Fill (see `contentAwareFill`). */
+export interface ContentAwareFillOptions {
+    /** The pixel layer to sample and fill (default the active layer). */
+    layerId?: string;
+    /** `current` (default) paints into the layer; `new-layer` puts the fill on a new layer above it. */
+    output?: 'current' | 'new-layer';
+    /** How far around the selection to sample, in pixels (default its larger side, at least 32). */
+    sampleRadius?: number;
+    /** Random seed: the same seed gives the same fill (default 0). */
+    seed?: number;
+}
+/** Pixels on the editor's clipboard: RGBA, and where they were copied from (document pixels). */
+export interface ClipboardImage extends PixelBuffer {
+    x?: number;
+    y?: number;
+}
+export type PasteMode = 'new-layer' | 'in-place' | 'into' | 'outside';
+export declare const PASTE_MODES: readonly PasteMode[];
 /** What a stroke, fill or clear changed. */
 export interface PaintStrokeResult {
     layerId: string;
@@ -595,10 +632,13 @@ export declare class ImageEditorController {
         enabled?: boolean;
         blend?: string;
         opacity?: number;
+        /** Limit the filter to the selection (sets the filter mask from it, same undo step). Default false. */
+        useSelection?: boolean;
     }): Promise<{
         layerId: string;
         filter: SmartFilter;
         converted: boolean;
+        masked: boolean;
     }>;
     /**
      * Changes an effect smart filter: `values` merged over its own (`null` resets a control to the
@@ -668,6 +708,14 @@ export declare class ImageEditorController {
     private stack;
     private captureHistoryEntry;
     private restoreHistoryEntry;
+    /** Set while `asOneStep` runs: the step is already recorded, so nested commands add none. */
+    private historyGrouped;
+    /**
+     * Runs `fn` as one undo step: history is recorded once, before it, and the commands it calls
+     * record none. If `fn` throws, the step is dropped and the state goes back to before it, so a
+     * failure never leaves half a change.
+     */
+    private asOneStep;
     private recordHistory;
     /**
      * Bytes of pixel tiles held only by undo / redo steps (not by the current state). The oldest
@@ -824,11 +872,12 @@ export declare class ImageEditorController {
         bounds: CropBox | null;
     };
     /**
-     * Adds a mask to a layer (one undo step): `reveal-all` (white), `hide-all` (black) or
-     * `selection` (the selection's coverage). Replaces an existing mask. Makes the mask the paint
+     * Adds a mask to a layer (one undo step): `reveal-all` (white), `hide-all` (black),
+     * `selection` (the selection's coverage), `hide-selection` (its inverse) or `transparency`
+     * (the layer's own alpha, so the pixels can then be made opaque and edited). Replaces an existing mask. Makes the mask the paint
      * target when the layer is active.
      */
-    addLayerMask(id: string, from?: 'reveal-all' | 'hide-all' | 'selection', props?: LayerMaskProps): RasterMask;
+    addLayerMask(id: string, from?: 'reveal-all' | 'hide-all' | 'selection' | 'hide-selection' | 'transparency', props?: LayerMaskProps): RasterMask;
     /** Removes a layer's mask (one undo step). */
     removeLayerMask(id: string): void;
     /** Changes any layer mask's density, feather, enabled or linked flag (pixels kept). Returns the mask. */
@@ -978,7 +1027,14 @@ export declare class ImageEditorController {
     /** Adds a smart filter (`develop` or `blur`, with `blend` and `opacity`) at `index` (default the top), as one undo step. */
     addSmartFilter(id: string, filter: Record<string, unknown> & {
         kind: string;
-    }, index?: number): SmartFilter;
+    }, index?: number, options?: {
+        useSelection?: boolean;
+    }): SmartFilter;
+    /**
+     * After adding a smart filter: with `useSelection` and a selection, sets the filter mask from
+     * it in the same undo step (Photoshop limits a filter to the selection). Returns whether it did.
+     */
+    private maskFiltersWithSelection;
     /** Changes one smart filter (one undo step, or none with `commitToHistory = false` during a drag). */
     updateSmartFilter(id: string, filterId: string, changes: Record<string, unknown>, commitToHistory?: boolean): SmartFilter;
     /** Removes one smart filter (one undo step). Returns the remaining filters. */
@@ -1182,6 +1238,59 @@ export declare class ImageEditorController {
      * whole canvas. One undo step. Returns the changed bounds.
      */
     clearPixels(options?: Omit<FillOptions, 'color' | 'blend'>): PaintStrokeResult;
+    /**
+     * Edit › Stroke: paints a band `width` px wide along the selection's edge, `inside` it, on the
+     * `center` of the edge or `outside` it (default), with `color` (default the foreground),
+     * `opacity` and `blend`, on a layer's pixels or mask. One undo step. Returns the changed bounds.
+     */
+    strokeSelection(options: StrokeSelectionOptions): PaintStrokeResult;
+    /**
+     * Image › Crop to the selection's bounds (one undo step). Returns the crop box (natural
+     * pixels). Throws without a selection.
+     */
+    cropToSelection(): CropBox;
+    /**
+     * Edit › Content-Aware Fill: fills the selection with texture synthesised from around it
+     * (PatchMatch, as the Spot Healing Brush's content-aware mode), blended by the selection's
+     * coverage. `output` `current` paints into the layer; `new-layer` puts the fill on a new layer
+     * above it. Samples within `sampleRadius` px of the selection (default its larger side, at
+     * least 32). Deterministic for a `seed`. One undo step. 8-bit documents only for now.
+     */
+    contentAwareFill(options?: ContentAwareFillOptions): {
+        layerId: string;
+        bounds: CropBox;
+        output: 'current' | 'new-layer';
+    };
+    /** The pixel clipboard (Copy / Cut), or null. */
+    private clipboard;
+    /** What Copy or Cut last put on the editor's clipboard, or null. */
+    getClipboard(): ClipboardImage | null;
+    /** Puts pixels on the editor's clipboard (e.g. an image pasted from the system clipboard). */
+    setClipboard(image: ClipboardImage | null): void;
+    /**
+     * Edit › Copy (or Copy Merged with `merged`): the selected pixels of a pixel layer (default the
+     * active one) or of the whole visible image, cropped to the selection's bounds, with the
+     * selection's soft edge in their alpha. Without a selection, the whole canvas. Not an undo step.
+     */
+    copyPixels(options?: {
+        layerId?: string;
+        merged?: boolean;
+    }): ClipboardImage;
+    /** Edit › Cut: Copy, then clear the selected pixels, as one undo step. */
+    cutPixels(options?: {
+        layerId?: string;
+    }): ClipboardImage;
+    /**
+     * Edit › Paste as a new pixel layer above the active one (one undo step): `new-layer` centred
+     * on the selection (or the canvas), `in-place` where it was copied, `into` centred in the
+     * selection with the selection as its mask (Paste Into), or `outside` with the inverse
+     * (Paste Outside). Returns the new layer id and where it went.
+     */
+    pastePixels(mode?: PasteMode, image?: ClipboardImage | null): {
+        layerId: string;
+        bounds: CropBox;
+        masked: boolean;
+    };
     private fillOrClear;
     /** The pixel layer the base sliders edit: the active pixel layer, else the Background. */
     private developLayer;
@@ -1265,6 +1374,27 @@ export declare class ImageEditorController {
     selectAll(): boolean;
     /** Select › Deselect. */
     deselect(): boolean;
+    /** The selection a Deselect cleared, for `reselect` (not saved, not part of history). */
+    private lastSelection;
+    /** Whether `reselect` has a selection to bring back. */
+    canReselect(): boolean;
+    /** Select › Reselect: brings back the last selection a Deselect cleared, as one undo step. */
+    reselect(): boolean;
+    /**
+     * Single Row / Single Column Marquee: a 1 px line across the whole image at `position`
+     * (natural pixels; y for a row, x for a column).
+     */
+    selectLine(orientation: 'row' | 'column', position: number, options?: SelectionCommandOptions): boolean;
+    /** Select › Grow: adds connected pixels within `tolerance` of a selected colour (one undo step). */
+    growSelection(options?: GrowSimilarOptions & SampleOptions): Promise<boolean>;
+    /** Select › Similar: adds every pixel within `tolerance` of a selected colour (one undo step). */
+    selectSimilar(options?: GrowSimilarOptions & SampleOptions): Promise<boolean>;
+    /**
+     * Load Selection from a layer's transparency (Ctrl/⌘-click its thumbnail): its alpha in
+     * document space, combined by `mode`. Works on pixel, shape, type and smart object layers.
+     */
+    selectLayerTransparency(id: string, options?: SelectionCommandOptions): boolean;
+    private layerTransparency;
     /** Select › Inverse (with nothing selected, selects everything). */
     invertSelection(): boolean;
     private shapeCommand;
@@ -1294,6 +1424,13 @@ export declare class ImageEditorController {
     magicWand(point: ImagePoint, options?: MagicWandOptions & SelectionCommandOptions & SampleOptions): Promise<SelectionMask | null>;
     /** Select › Color Range with colour samples (`#rrggbb` or `[r, g, b]`, optionally where they were picked). */
     selectColorRange(samples: ColorRangeSample[], options?: ColorRangeOptions & SelectionCommandOptions & SampleOptions): Promise<SelectionMask | null>;
+    /**
+     * Select › Color Range with a preset: `reds` … `magentas`, `highlights` / `midtones` /
+     * `shadows` (with `falloff` levels, default 20) or `skinTones`. One undo step.
+     */
+    selectColorRangePreset(preset: ColorRangePreset, options?: {
+        falloff?: number;
+    } & SelectionCommandOptions & SampleOptions): Promise<SelectionMask | null>;
     /** Select › Modify: grow, shrink, feather, border or smooth by `radius` pixels (one undo step). */
     modifySelection(op: SelectionModifyOp, radius: number): boolean;
     /**
@@ -1333,6 +1470,66 @@ export declare class ImageEditorController {
     }>;
     /** Quick Mask view (tints the unselected area). View state: no undo step. */
     setQuickMask(on: boolean): void;
+    /** How the canvas shows the selection (`state.selectionDisplay`). */
+    getSelectionDisplay(): SelectionDisplay;
+    /**
+     * Shows the selection as marching ants, as a Quick Mask tint over the unselected area, or hides
+     * it (the selection still applies). View state: no undo step, not saved.
+     */
+    setSelectionDisplay(display: SelectionDisplay): void;
+    /** The alpha channels (saved selections), in panel order. */
+    getChannels(): readonly AlphaChannel[];
+    getChannel(id: string): AlphaChannel | null;
+    private requireChannel;
+    private setChannels;
+    private newChannelId;
+    /**
+     * Select › Save Selection: a new alpha channel (`name`, default "Alpha n") holding the
+     * selection, or with `channelId` the selection combined into that channel by `mode` (replace,
+     * add, subtract, intersect). One undo step. Throws without a selection.
+     */
+    saveSelection(options?: {
+        channelId?: string;
+        name?: string;
+        mode?: SelectionMode;
+    }): AlphaChannel;
+    /**
+     * Select › Load Selection from an alpha channel (inverted with `invert`), combined with the
+     * selection by `mode`. One undo step.
+     */
+    loadSelectionFromChannel(id: string, options?: {
+        mode?: SelectionMode;
+        invert?: boolean;
+    }): boolean;
+    /** Changes a channel's name, overlay colour, opacity, what it indicates or visibility (one undo step). */
+    setChannelProperties(id: string, props: Partial<Pick<AlphaChannel, 'name' | 'color' | 'opacity' | 'indicates' | 'visible'>>): AlphaChannel;
+    /** Deletes an alpha channel (one undo step). */
+    deleteChannel(id: string): void;
+    /** Duplicates an alpha channel just after it (one undo step). Returns the copy. */
+    duplicateChannel(id: string, name?: string): AlphaChannel;
+    /** Channel summaries (no pixels) for panels and agents. */
+    describeChannels(): {
+        bounds: CropBox | null;
+        percent: number;
+        id: string;
+        name: string;
+        color: string;
+        opacity: number;
+        indicates: "masked" | "selected";
+        visible: boolean;
+    }[];
+    /** Whether Quick Mask mode is on (painting edits the selection). */
+    get quickMaskEditing(): boolean;
+    /**
+     * Quick Mask mode (Q): on, the selection shows as a tint and painting, fills and strokes that
+     * name no layer edit the selection itself (white selects, black deselects, grey partly);
+     * off, it shows as marching ants again. View state: no undo step (the edits are).
+     */
+    setQuickMaskMode(on: boolean): void;
+    /** The selection as a 1-channel surface to paint in Quick Mask mode. */
+    private quickMaskSurface;
+    /** The selection a painted Quick Mask surface stands for (`rects` changed since `base`). */
+    private selectionFromSurface;
     private maskFromSelection;
     /**
      * Adds the selection as the layer's mask (Reveal Selection), replacing any mask, as one undo
@@ -1344,8 +1541,11 @@ export declare class ImageEditorController {
     setAdjustmentLayerMask(layerId: string, mask: SelectionMask | null, props?: LayerMaskProps): boolean;
     /** Changes a layer mask's density (0..1), feather (px) or enabled flag; the mask pixels are kept. */
     setAdjustmentLayerMaskProps(layerId: string, props: LayerMaskProps, commitToHistory?: boolean): boolean;
-    /** Load Selection from a layer mask (its pixels; density and feather are not applied). */
-    selectionFromLayerMask(layerId: string, mode?: SelectionMode): boolean;
+    /**
+     * Load Selection from a layer mask (its pixels; density and feather are not applied), inverted
+     * with `invert`. False without a painted mask (a depth mask is computed, not painted).
+     */
+    selectionFromLayerMask(layerId: string, mode?: SelectionMode, invert?: boolean): boolean;
     /**
      * Histogram of the last rendered preview (after adjustments and layers, before annotations),
      * or `null` before the first render or without canvas pixel access.

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

@@ -4,11 +4,12 @@ import { type BlendMode } from './blend.js';
 import type { ImageHistogram } from './histogram.js';
 import { type PixelBuffer, type SelectionChannel, type SelectionMask, type SelectionMode } from './selection/mask.js';
 import { type ShapeSelectionOptions } from './selection/shapes.js';
-import { type ColorRangeOptions, type ColorRangeSample, type MagicWandOptions } from './selection/wand.js';
+import { type GrowSimilarOptions, type ColorRangeOptions, type ColorRangePreset, type ColorRangeSample, type MagicWandOptions } from './selection/wand.js';
 import { type SelectionModifyOp } from './selection/modify.js';
 import { type SegmentationProvider } from './selection/segmentation.js';
 import { type RefineEdgeParams } from './selection/refine.js';
-import type { LayerMaskProps } from './selection/layer-mask.js';
+import { type LayerMaskProps } from './selection/layer-mask.js';
+import { type AlphaChannel } from './selection/channels.js';
 import type { AdjustmentLayerMask } from './types.js';
 import { type LayerBlendMode, type ImageLayer, type LayerFilter, type LayerTarget, type PixelLayer, type RasterMask, type SmartContents, type SmartFilter, type SmartPlacement, type LiveShape, type ShapeFillRule, type ShapeOperation, type ShapePaint, type ShapeStroke, type ParagraphStyle, type TextStyle, type TypeLayer, type ImageEffectAnimation } from './layers/model.js';
 import { type TextLayout, type TextShaper } from './layers/text.js';
@@ -107,7 +108,11 @@ export interface SelectionCommandOptions {
     mode?: SelectionMode;
     /** Feather the new shape by this many pixels before combining (default 0). */
     feather?: number;
+    /** Invert the new shape before combining (Color Range › Invert; default false). */
+    invert?: boolean;
 }
+/** How the canvas shows the selection: marching ants, a Quick Mask tint, or not at all. */
+export type SelectionDisplay = 'ants' | 'quickMask' | 'none';
 /** Where an AI result goes (see `applyInpaintedImage`, `applyBackgroundRemovedImage`). */
 export interface AIResultOptions {
     /** `new-layer`: a new layer (inpainting) or a mask (background removal); `replace`: the Background's pixels. Default: by `isMultiLayer`. */
@@ -133,6 +138,11 @@ export interface AdjustmentLayerInit<K extends AdjustmentKind = AdjustmentKind>
     aboveId?: string;
     /** Put the new layer at the top of this group. */
     parentId?: string;
+    /**
+     * Mask the new layer with the selection when there is one and no `mask` is given (Photoshop's
+     * behaviour). Default false here, for compatibility; the agent tool and the panels pass true.
+     */
+    useSelection?: boolean;
 }
 /** A new pixel layer: empty, a solid colour over the canvas, or given pixels, plus its properties and position. */
 export interface PixelLayerInit extends LayerPlacement {
@@ -345,6 +355,33 @@ export interface FillOptions {
     /** Limit to the selection when there is one (default true). */
     useSelection?: boolean;
 }
+/** The `layerId` paint results report for Quick Mask edits (the selection, not a layer). */
+export declare const QUICK_MASK_TARGET = "quick-mask";
+/** Edit › Stroke (see `strokeSelection`). */
+export interface StrokeSelectionOptions extends Omit<FillOptions, 'useSelection'> {
+    /** Width of the band in pixels (0 < width ≤ 250). */
+    width: number;
+    /** Where the band lies against the selection edge (default `outside`). */
+    location?: 'inside' | 'center' | 'outside';
+}
+/** Edit › Content-Aware Fill (see `contentAwareFill`). */
+export interface ContentAwareFillOptions {
+    /** The pixel layer to sample and fill (default the active layer). */
+    layerId?: string;
+    /** `current` (default) paints into the layer; `new-layer` puts the fill on a new layer above it. */
+    output?: 'current' | 'new-layer';
+    /** How far around the selection to sample, in pixels (default its larger side, at least 32). */
+    sampleRadius?: number;
+    /** Random seed: the same seed gives the same fill (default 0). */
+    seed?: number;
+}
+/** Pixels on the editor's clipboard: RGBA, and where they were copied from (document pixels). */
+export interface ClipboardImage extends PixelBuffer {
+    x?: number;
+    y?: number;
+}
+export type PasteMode = 'new-layer' | 'in-place' | 'into' | 'outside';
+export declare const PASTE_MODES: readonly PasteMode[];
 /** What a stroke, fill or clear changed. */
 export interface PaintStrokeResult {
     layerId: string;
@@ -595,10 +632,13 @@ export declare class ImageEditorController {
         enabled?: boolean;
         blend?: string;
         opacity?: number;
+        /** Limit the filter to the selection (sets the filter mask from it, same undo step). Default false. */
+        useSelection?: boolean;
     }): Promise<{
         layerId: string;
         filter: SmartFilter;
         converted: boolean;
+        masked: boolean;
     }>;
     /**
      * Changes an effect smart filter: `values` merged over its own (`null` resets a control to the
@@ -668,6 +708,14 @@ export declare class ImageEditorController {
     private stack;
     private captureHistoryEntry;
     private restoreHistoryEntry;
+    /** Set while `asOneStep` runs: the step is already recorded, so nested commands add none. */
+    private historyGrouped;
+    /**
+     * Runs `fn` as one undo step: history is recorded once, before it, and the commands it calls
+     * record none. If `fn` throws, the step is dropped and the state goes back to before it, so a
+     * failure never leaves half a change.
+     */
+    private asOneStep;
     private recordHistory;
     /**
      * Bytes of pixel tiles held only by undo / redo steps (not by the current state). The oldest
@@ -824,11 +872,12 @@ export declare class ImageEditorController {
         bounds: CropBox | null;
     };
     /**
-     * Adds a mask to a layer (one undo step): `reveal-all` (white), `hide-all` (black) or
-     * `selection` (the selection's coverage). Replaces an existing mask. Makes the mask the paint
+     * Adds a mask to a layer (one undo step): `reveal-all` (white), `hide-all` (black),
+     * `selection` (the selection's coverage), `hide-selection` (its inverse) or `transparency`
+     * (the layer's own alpha, so the pixels can then be made opaque and edited). Replaces an existing mask. Makes the mask the paint
      * target when the layer is active.
      */
-    addLayerMask(id: string, from?: 'reveal-all' | 'hide-all' | 'selection', props?: LayerMaskProps): RasterMask;
+    addLayerMask(id: string, from?: 'reveal-all' | 'hide-all' | 'selection' | 'hide-selection' | 'transparency', props?: LayerMaskProps): RasterMask;
     /** Removes a layer's mask (one undo step). */
     removeLayerMask(id: string): void;
     /** Changes any layer mask's density, feather, enabled or linked flag (pixels kept). Returns the mask. */
@@ -978,7 +1027,14 @@ export declare class ImageEditorController {
     /** Adds a smart filter (`develop` or `blur`, with `blend` and `opacity`) at `index` (default the top), as one undo step. */
     addSmartFilter(id: string, filter: Record<string, unknown> & {
         kind: string;
-    }, index?: number): SmartFilter;
+    }, index?: number, options?: {
+        useSelection?: boolean;
+    }): SmartFilter;
+    /**
+     * After adding a smart filter: with `useSelection` and a selection, sets the filter mask from
+     * it in the same undo step (Photoshop limits a filter to the selection). Returns whether it did.
+     */
+    private maskFiltersWithSelection;
     /** Changes one smart filter (one undo step, or none with `commitToHistory = false` during a drag). */
     updateSmartFilter(id: string, filterId: string, changes: Record<string, unknown>, commitToHistory?: boolean): SmartFilter;
     /** Removes one smart filter (one undo step). Returns the remaining filters. */
@@ -1182,6 +1238,59 @@ export declare class ImageEditorController {
      * whole canvas. One undo step. Returns the changed bounds.
      */
     clearPixels(options?: Omit<FillOptions, 'color' | 'blend'>): PaintStrokeResult;
+    /**
+     * Edit › Stroke: paints a band `width` px wide along the selection's edge, `inside` it, on the
+     * `center` of the edge or `outside` it (default), with `color` (default the foreground),
+     * `opacity` and `blend`, on a layer's pixels or mask. One undo step. Returns the changed bounds.
+     */
+    strokeSelection(options: StrokeSelectionOptions): PaintStrokeResult;
+    /**
+     * Image › Crop to the selection's bounds (one undo step). Returns the crop box (natural
+     * pixels). Throws without a selection.
+     */
+    cropToSelection(): CropBox;
+    /**
+     * Edit › Content-Aware Fill: fills the selection with texture synthesised from around it
+     * (PatchMatch, as the Spot Healing Brush's content-aware mode), blended by the selection's
+     * coverage. `output` `current` paints into the layer; `new-layer` puts the fill on a new layer
+     * above it. Samples within `sampleRadius` px of the selection (default its larger side, at
+     * least 32). Deterministic for a `seed`. One undo step. 8-bit documents only for now.
+     */
+    contentAwareFill(options?: ContentAwareFillOptions): {
+        layerId: string;
+        bounds: CropBox;
+        output: 'current' | 'new-layer';
+    };
+    /** The pixel clipboard (Copy / Cut), or null. */
+    private clipboard;
+    /** What Copy or Cut last put on the editor's clipboard, or null. */
+    getClipboard(): ClipboardImage | null;
+    /** Puts pixels on the editor's clipboard (e.g. an image pasted from the system clipboard). */
+    setClipboard(image: ClipboardImage | null): void;
+    /**
+     * Edit › Copy (or Copy Merged with `merged`): the selected pixels of a pixel layer (default the
+     * active one) or of the whole visible image, cropped to the selection's bounds, with the
+     * selection's soft edge in their alpha. Without a selection, the whole canvas. Not an undo step.
+     */
+    copyPixels(options?: {
+        layerId?: string;
+        merged?: boolean;
+    }): ClipboardImage;
+    /** Edit › Cut: Copy, then clear the selected pixels, as one undo step. */
+    cutPixels(options?: {
+        layerId?: string;
+    }): ClipboardImage;
+    /**
+     * Edit › Paste as a new pixel layer above the active one (one undo step): `new-layer` centred
+     * on the selection (or the canvas), `in-place` where it was copied, `into` centred in the
+     * selection with the selection as its mask (Paste Into), or `outside` with the inverse
+     * (Paste Outside). Returns the new layer id and where it went.
+     */
+    pastePixels(mode?: PasteMode, image?: ClipboardImage | null): {
+        layerId: string;
+        bounds: CropBox;
+        masked: boolean;
+    };
     private fillOrClear;
     /** The pixel layer the base sliders edit: the active pixel layer, else the Background. */
     private developLayer;
@@ -1265,6 +1374,27 @@ export declare class ImageEditorController {
     selectAll(): boolean;
     /** Select › Deselect. */
     deselect(): boolean;
+    /** The selection a Deselect cleared, for `reselect` (not saved, not part of history). */
+    private lastSelection;
+    /** Whether `reselect` has a selection to bring back. */
+    canReselect(): boolean;
+    /** Select › Reselect: brings back the last selection a Deselect cleared, as one undo step. */
+    reselect(): boolean;
+    /**
+     * Single Row / Single Column Marquee: a 1 px line across the whole image at `position`
+     * (natural pixels; y for a row, x for a column).
+     */
+    selectLine(orientation: 'row' | 'column', position: number, options?: SelectionCommandOptions): boolean;
+    /** Select › Grow: adds connected pixels within `tolerance` of a selected colour (one undo step). */
+    growSelection(options?: GrowSimilarOptions & SampleOptions): Promise<boolean>;
+    /** Select › Similar: adds every pixel within `tolerance` of a selected colour (one undo step). */
+    selectSimilar(options?: GrowSimilarOptions & SampleOptions): Promise<boolean>;
+    /**
+     * Load Selection from a layer's transparency (Ctrl/⌘-click its thumbnail): its alpha in
+     * document space, combined by `mode`. Works on pixel, shape, type and smart object layers.
+     */
+    selectLayerTransparency(id: string, options?: SelectionCommandOptions): boolean;
+    private layerTransparency;
     /** Select › Inverse (with nothing selected, selects everything). */
     invertSelection(): boolean;
     private shapeCommand;
@@ -1294,6 +1424,13 @@ export declare class ImageEditorController {
     magicWand(point: ImagePoint, options?: MagicWandOptions & SelectionCommandOptions & SampleOptions): Promise<SelectionMask | null>;
     /** Select › Color Range with colour samples (`#rrggbb` or `[r, g, b]`, optionally where they were picked). */
     selectColorRange(samples: ColorRangeSample[], options?: ColorRangeOptions & SelectionCommandOptions & SampleOptions): Promise<SelectionMask | null>;
+    /**
+     * Select › Color Range with a preset: `reds` … `magentas`, `highlights` / `midtones` /
+     * `shadows` (with `falloff` levels, default 20) or `skinTones`. One undo step.
+     */
+    selectColorRangePreset(preset: ColorRangePreset, options?: {
+        falloff?: number;
+    } & SelectionCommandOptions & SampleOptions): Promise<SelectionMask | null>;
     /** Select › Modify: grow, shrink, feather, border or smooth by `radius` pixels (one undo step). */
     modifySelection(op: SelectionModifyOp, radius: number): boolean;
     /**
@@ -1333,6 +1470,66 @@ export declare class ImageEditorController {
     }>;
     /** Quick Mask view (tints the unselected area). View state: no undo step. */
     setQuickMask(on: boolean): void;
+    /** How the canvas shows the selection (`state.selectionDisplay`). */
+    getSelectionDisplay(): SelectionDisplay;
+    /**
+     * Shows the selection as marching ants, as a Quick Mask tint over the unselected area, or hides
+     * it (the selection still applies). View state: no undo step, not saved.
+     */
+    setSelectionDisplay(display: SelectionDisplay): void;
+    /** The alpha channels (saved selections), in panel order. */
+    getChannels(): readonly AlphaChannel[];
+    getChannel(id: string): AlphaChannel | null;
+    private requireChannel;
+    private setChannels;
+    private newChannelId;
+    /**
+     * Select › Save Selection: a new alpha channel (`name`, default "Alpha n") holding the
+     * selection, or with `channelId` the selection combined into that channel by `mode` (replace,
+     * add, subtract, intersect). One undo step. Throws without a selection.
+     */
+    saveSelection(options?: {
+        channelId?: string;
+        name?: string;
+        mode?: SelectionMode;
+    }): AlphaChannel;
+    /**
+     * Select › Load Selection from an alpha channel (inverted with `invert`), combined with the
+     * selection by `mode`. One undo step.
+     */
+    loadSelectionFromChannel(id: string, options?: {
+        mode?: SelectionMode;
+        invert?: boolean;
+    }): boolean;
+    /** Changes a channel's name, overlay colour, opacity, what it indicates or visibility (one undo step). */
+    setChannelProperties(id: string, props: Partial<Pick<AlphaChannel, 'name' | 'color' | 'opacity' | 'indicates' | 'visible'>>): AlphaChannel;
+    /** Deletes an alpha channel (one undo step). */
+    deleteChannel(id: string): void;
+    /** Duplicates an alpha channel just after it (one undo step). Returns the copy. */
+    duplicateChannel(id: string, name?: string): AlphaChannel;
+    /** Channel summaries (no pixels) for panels and agents. */
+    describeChannels(): {
+        bounds: CropBox | null;
+        percent: number;
+        id: string;
+        name: string;
+        color: string;
+        opacity: number;
+        indicates: "masked" | "selected";
+        visible: boolean;
+    }[];
+    /** Whether Quick Mask mode is on (painting edits the selection). */
+    get quickMaskEditing(): boolean;
+    /**
+     * Quick Mask mode (Q): on, the selection shows as a tint and painting, fills and strokes that
+     * name no layer edit the selection itself (white selects, black deselects, grey partly);
+     * off, it shows as marching ants again. View state: no undo step (the edits are).
+     */
+    setQuickMaskMode(on: boolean): void;
+    /** The selection as a 1-channel surface to paint in Quick Mask mode. */
+    private quickMaskSurface;
+    /** The selection a painted Quick Mask surface stands for (`rects` changed since `base`). */
+    private selectionFromSurface;
     private maskFromSelection;
     /**
      * Adds the selection as the layer's mask (Reveal Selection), replacing any mask, as one undo
@@ -1344,8 +1541,11 @@ export declare class ImageEditorController {
     setAdjustmentLayerMask(layerId: string, mask: SelectionMask | null, props?: LayerMaskProps): boolean;
     /** Changes a layer mask's density (0..1), feather (px) or enabled flag; the mask pixels are kept. */
     setAdjustmentLayerMaskProps(layerId: string, props: LayerMaskProps, commitToHistory?: boolean): boolean;
-    /** Load Selection from a layer mask (its pixels; density and feather are not applied). */
-    selectionFromLayerMask(layerId: string, mode?: SelectionMode): boolean;
+    /**
+     * Load Selection from a layer mask (its pixels; density and feather are not applied), inverted
+     * with `invert`. False without a painted mask (a depth mask is computed, not painted).
+     */
+    selectionFromLayerMask(layerId: string, mode?: SelectionMode, invert?: boolean): boolean;
     /**
      * Histogram of the last rendered preview (after adjustments and layers, before annotations),
      * or `null` before the first render or without canvas pixel access.