@pixerate/editor 0.183.0 → 0.185.0

package/dist/image-editor/layers/panel.d.cts

@@ -6,6 +6,28 @@
 import type { ImageEditorController } from '../controller.cjs';
 import { type ImageLayer, type SmartFilter } from './model.cjs';
 import type { LayerPlacement } from './ops.cjs';
+/**
+ * A click on a layer's mask thumbnail, as in Photoshop: Ctrl/⌘-click loads the mask as the
+ * selection (with Shift adding, Alt subtracting, both intersecting), Shift-click turns the mask
+ * on or off, and a plain click makes the mask the paint target.
+ */
+export declare function maskThumbnailClick(controller: ImageEditorController, layer: ImageLayer, e: {
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+}): void;
+/**
+ * A click on a layer's pixel thumbnail: Ctrl/⌘-click loads the layer's transparency as the
+ * selection (Shift adds, Alt subtracts, both intersect) and returns true; other clicks are left
+ * to the row (false).
+ */
+export declare function layerThumbnailClick(controller: ImageEditorController, layer: ImageLayer, e: {
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+}): boolean;
 export interface LayerPanelRow {
     layer: ImageLayer;
     /** Nesting depth (0 = top level). */
@@ -34,7 +56,7 @@ export type DropZone = 'above' | 'below' | 'inside';
 export declare function dropZone(fraction: number, isGroup: boolean): DropZone;
 /** The placement for `move_layer` when `dragId` is dropped on row `targetId` in `zone`, or `null` for a no-op. */
 export declare function dropPlacement(layers: readonly ImageLayer[], dragId: string, targetId: string, zone: DropZone): LayerPlacement | null;
-export type LayerMenuAction = 'new-layer' | 'new-group' | 'duplicate' | 'delete' | 'group-selected' | 'ungroup' | 'merge-down' | 'merge-visible' | 'flatten' | 'via-copy' | 'via-cut' | 'add-mask' | 'add-mask-selection' | 'apply-mask' | 'delete-mask' | 'toggle-mask' | 'toggle-mask-link' | 'toggle-clip' | 'rasterize' | 'convert-smart' | 'edit-contents' | 'smart-via-copy' | 'add-filter-mask';
+export type LayerMenuAction = 'new-layer' | 'new-group' | 'duplicate' | 'delete' | 'group-selected' | 'ungroup' | 'merge-down' | 'merge-visible' | 'flatten' | 'via-copy' | 'via-cut' | 'add-mask' | 'add-mask-selection' | 'add-mask-hide-selection' | 'add-mask-transparency' | 'select-transparency' | 'apply-mask' | 'delete-mask' | 'toggle-mask' | 'toggle-mask-link' | 'toggle-clip' | 'rasterize' | 'convert-smart' | 'edit-contents' | 'smart-via-copy' | 'add-filter-mask';
 export interface LayerMenuItem {
     action: LayerMenuAction;
     label: string;

package/dist/image-editor/layers/panel.d.ts

@@ -6,6 +6,28 @@
 import type { ImageEditorController } from '../controller.js';
 import { type ImageLayer, type SmartFilter } from './model.js';
 import type { LayerPlacement } from './ops.js';
+/**
+ * A click on a layer's mask thumbnail, as in Photoshop: Ctrl/⌘-click loads the mask as the
+ * selection (with Shift adding, Alt subtracting, both intersecting), Shift-click turns the mask
+ * on or off, and a plain click makes the mask the paint target.
+ */
+export declare function maskThumbnailClick(controller: ImageEditorController, layer: ImageLayer, e: {
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+}): void;
+/**
+ * A click on a layer's pixel thumbnail: Ctrl/⌘-click loads the layer's transparency as the
+ * selection (Shift adds, Alt subtracts, both intersect) and returns true; other clicks are left
+ * to the row (false).
+ */
+export declare function layerThumbnailClick(controller: ImageEditorController, layer: ImageLayer, e: {
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+}): boolean;
 export interface LayerPanelRow {
     layer: ImageLayer;
     /** Nesting depth (0 = top level). */
@@ -34,7 +56,7 @@ export type DropZone = 'above' | 'below' | 'inside';
 export declare function dropZone(fraction: number, isGroup: boolean): DropZone;
 /** The placement for `move_layer` when `dragId` is dropped on row `targetId` in `zone`, or `null` for a no-op. */
 export declare function dropPlacement(layers: readonly ImageLayer[], dragId: string, targetId: string, zone: DropZone): LayerPlacement | null;
-export type LayerMenuAction = 'new-layer' | 'new-group' | 'duplicate' | 'delete' | 'group-selected' | 'ungroup' | 'merge-down' | 'merge-visible' | 'flatten' | 'via-copy' | 'via-cut' | 'add-mask' | 'add-mask-selection' | 'apply-mask' | 'delete-mask' | 'toggle-mask' | 'toggle-mask-link' | 'toggle-clip' | 'rasterize' | 'convert-smart' | 'edit-contents' | 'smart-via-copy' | 'add-filter-mask';
+export type LayerMenuAction = 'new-layer' | 'new-group' | 'duplicate' | 'delete' | 'group-selected' | 'ungroup' | 'merge-down' | 'merge-visible' | 'flatten' | 'via-copy' | 'via-cut' | 'add-mask' | 'add-mask-selection' | 'add-mask-hide-selection' | 'add-mask-transparency' | 'select-transparency' | 'apply-mask' | 'delete-mask' | 'toggle-mask' | 'toggle-mask-link' | 'toggle-clip' | 'rasterize' | 'convert-smart' | 'edit-contents' | 'smart-via-copy' | 'add-filter-mask';
 export interface LayerMenuItem {
     action: LayerMenuAction;
     label: string;

package/dist/image-editor/selection/gesture.d.cts

@@ -4,14 +4,26 @@ import { type SelectionToolOptions } from './tool-options.cjs';
 export interface GestureModifiers {
     shiftKey?: boolean;
     altKey?: boolean;
+    /** The click count of a mouse event (2 on a double-click). */
+    detail?: number;
 }
+/** `point` moved onto the nearest 45° ray from `from` (Shift with the polygonal lasso). */
+export declare function snapTo45(from: ImagePoint, point: ImagePoint): ImagePoint;
 /**
  * Pointer gestures of the selection tools, shared by the React and Svelte image editors: feed
  * it pointer positions in natural image pixels (`canvasToImagePoint(..., false)`).
  *
  * - Magic wand: selects on `begin` (async, as it may read pixels).
+ * - Color Range: on `begin`, samples the colour under the pointer and selects every similar pixel
+ *   (with the modifiers, Shift-click adds a colour and Alt-click removes one, as the + and −
+ *   eyedroppers).
  * - Rectangle / ellipse: drag a box; a click without a drag deselects (replace mode).
  * - Lasso: drag a free-hand path, closed on `end`.
+ * - Polygonal lasso: each click adds a corner (Shift: on a 45° ray from the last one), dragging
+ *   adds a free-hand stretch; a double-click, a click on the first corner or Enter (`key`)
+ *   closes it, Backspace removes the last corner and Escape cancels. It stays `active` between
+ *   clicks, so feed it pointer moves without a button too.
+ * - Single row / column: a click selects a 1 px line across the image.
  *
  * Shift adds, Alt subtracts, both intersect (overriding the options bar mode). While dragging,
  * {@link draftPath} is the outline to show (`RenderOptions.draftSelectionPath`).
@@ -23,6 +35,12 @@ export declare class SelectionGesture {
     private points;
     private current;
     private modifiers;
+    /** Polygonal lasso corners while one is being drawn. */
+    private polygon;
+    private pressedAt;
+    private freehand;
+    /** A click this close to the first corner (natural pixels) closes a polygonal lasso. */
+    closeRadius: number;
     /** The last error (e.g. pixels unavailable for the wand), for the UI to show. */
     error: string | null;
     constructor(controller: ImageEditorController, getOptions: () => SelectionToolOptions);
@@ -32,9 +50,29 @@ export declare class SelectionGesture {
     /** Pointer down. Resolves once a wand click has been applied. */
     begin(point: ImagePoint, modifiers?: GestureModifiers): Promise<void>;
     /** Pointer move; returns true when the draft changed (re-render). */
-    move(point: ImagePoint): boolean;
+    move(point: ImagePoint, modifiers?: GestureModifiers): boolean;
     /** Pointer up: commits the shape. Returns true when the selection changed. */
     end(point?: ImagePoint, modifiers?: GestureModifiers): boolean;
-    /** Abandons a drag without changing the selection. */
+    /** Closes a polygonal lasso and selects it. Returns true when the selection changed. */
+    close(): boolean;
+    /**
+     * Keys for a polygonal lasso being drawn: Enter closes it, Escape cancels, Backspace / Delete
+     * removes the last corner. Returns true when the key was used (the host prevents its default).
+     */
+    key(key: string): boolean;
+    /** Abandons a drag (or a polygonal lasso) without changing the selection. */
     cancel(): void;
 }
+/**
+ * Edit shortcuts in select mode, as in Photoshop: Ctrl/⌘+C copies (with Shift, Copy Merged),
+ * Ctrl/⌘+X cuts, Ctrl/⌘+V pastes (with Shift, in place; with Alt+Shift, into the selection),
+ * Ctrl/⌘+D deselects, Ctrl/⌘+Shift+D reselects and Ctrl/⌘+Shift+I inverts. Returns true when
+ * the key was used (the host prevents its default); errors go to `onError`.
+ */
+export declare function handleSelectionShortcut(controller: ImageEditorController, e: {
+    key: string;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+}, onError?: (message: string) => void): boolean;

package/dist/image-editor/selection/gesture.d.ts

@@ -4,14 +4,26 @@ import { type SelectionToolOptions } from './tool-options.js';
 export interface GestureModifiers {
     shiftKey?: boolean;
     altKey?: boolean;
+    /** The click count of a mouse event (2 on a double-click). */
+    detail?: number;
 }
+/** `point` moved onto the nearest 45° ray from `from` (Shift with the polygonal lasso). */
+export declare function snapTo45(from: ImagePoint, point: ImagePoint): ImagePoint;
 /**
  * Pointer gestures of the selection tools, shared by the React and Svelte image editors: feed
  * it pointer positions in natural image pixels (`canvasToImagePoint(..., false)`).
  *
  * - Magic wand: selects on `begin` (async, as it may read pixels).
+ * - Color Range: on `begin`, samples the colour under the pointer and selects every similar pixel
+ *   (with the modifiers, Shift-click adds a colour and Alt-click removes one, as the + and −
+ *   eyedroppers).
  * - Rectangle / ellipse: drag a box; a click without a drag deselects (replace mode).
  * - Lasso: drag a free-hand path, closed on `end`.
+ * - Polygonal lasso: each click adds a corner (Shift: on a 45° ray from the last one), dragging
+ *   adds a free-hand stretch; a double-click, a click on the first corner or Enter (`key`)
+ *   closes it, Backspace removes the last corner and Escape cancels. It stays `active` between
+ *   clicks, so feed it pointer moves without a button too.
+ * - Single row / column: a click selects a 1 px line across the image.
  *
  * Shift adds, Alt subtracts, both intersect (overriding the options bar mode). While dragging,
  * {@link draftPath} is the outline to show (`RenderOptions.draftSelectionPath`).
@@ -23,6 +35,12 @@ export declare class SelectionGesture {
     private points;
     private current;
     private modifiers;
+    /** Polygonal lasso corners while one is being drawn. */
+    private polygon;
+    private pressedAt;
+    private freehand;
+    /** A click this close to the first corner (natural pixels) closes a polygonal lasso. */
+    closeRadius: number;
     /** The last error (e.g. pixels unavailable for the wand), for the UI to show. */
     error: string | null;
     constructor(controller: ImageEditorController, getOptions: () => SelectionToolOptions);
@@ -32,9 +50,29 @@ export declare class SelectionGesture {
     /** Pointer down. Resolves once a wand click has been applied. */
     begin(point: ImagePoint, modifiers?: GestureModifiers): Promise<void>;
     /** Pointer move; returns true when the draft changed (re-render). */
-    move(point: ImagePoint): boolean;
+    move(point: ImagePoint, modifiers?: GestureModifiers): boolean;
     /** Pointer up: commits the shape. Returns true when the selection changed. */
     end(point?: ImagePoint, modifiers?: GestureModifiers): boolean;
-    /** Abandons a drag without changing the selection. */
+    /** Closes a polygonal lasso and selects it. Returns true when the selection changed. */
+    close(): boolean;
+    /**
+     * Keys for a polygonal lasso being drawn: Enter closes it, Escape cancels, Backspace / Delete
+     * removes the last corner. Returns true when the key was used (the host prevents its default).
+     */
+    key(key: string): boolean;
+    /** Abandons a drag (or a polygonal lasso) without changing the selection. */
     cancel(): void;
 }
+/**
+ * Edit shortcuts in select mode, as in Photoshop: Ctrl/⌘+C copies (with Shift, Copy Merged),
+ * Ctrl/⌘+X cuts, Ctrl/⌘+V pastes (with Shift, in place; with Alt+Shift, into the selection),
+ * Ctrl/⌘+D deselects, Ctrl/⌘+Shift+D reselects and Ctrl/⌘+Shift+I inverts. Returns true when
+ * the key was used (the host prevents its default); errors go to `onError`.
+ */
+export declare function handleSelectionShortcut(controller: ImageEditorController, e: {
+    key: string;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
+    altKey?: boolean;
+}, onError?: (message: string) => void): boolean;

package/dist/image-editor/selection/index.d.cts

@@ -8,3 +8,4 @@ export * from './overlay.cjs';
 export * from './tool-options.cjs';
 export * from './gesture.cjs';
 export * from './segmentation.cjs';
+export * from './stroke.cjs';

package/dist/image-editor/selection/index.d.ts

@@ -8,3 +8,4 @@ export * from './overlay.js';
 export * from './tool-options.js';
 export * from './gesture.js';
 export * from './segmentation.js';
+export * from './stroke.js';

package/dist/image-editor/selection/modify.d.cts

@@ -31,7 +31,8 @@ export declare function greyMorphology(src: ArrayLike<number>, w: number, h: num
  * use one morphology, the remainder blends with the next pixel, so 0.3 px differs from 1 px.
  */
 export declare function shiftCoverage(src: ArrayLike<number>, w: number, h: number, amount: number): Float32Array;
-export type SelectionModifyOp = 'grow' | 'shrink' | 'feather' | 'border' | 'smooth';
+/** `expand` / `contract` are Photoshop's names; `grow` / `shrink` are the same operations, kept as aliases. */
+export type SelectionModifyOp = 'expand' | 'contract' | 'grow' | 'shrink' | 'feather' | 'border' | 'smooth';
 export declare const SELECTION_MODIFY_OPS: readonly SelectionModifyOp[];
-/** Select › Modify (grow = Expand, shrink = Contract, feather, border, smooth) by `radius` pixels. */
+/** Select › Modify (expand, contract, feather, border, smooth; grow and shrink are aliases) by `radius` pixels. */
 export declare function modifySelection(mask: SelectionMask, op: SelectionModifyOp, radius: number): SelectionMask;

package/dist/image-editor/selection/modify.d.ts

@@ -31,7 +31,8 @@ export declare function greyMorphology(src: ArrayLike<number>, w: number, h: num
  * use one morphology, the remainder blends with the next pixel, so 0.3 px differs from 1 px.
  */
 export declare function shiftCoverage(src: ArrayLike<number>, w: number, h: number, amount: number): Float32Array;
-export type SelectionModifyOp = 'grow' | 'shrink' | 'feather' | 'border' | 'smooth';
+/** `expand` / `contract` are Photoshop's names; `grow` / `shrink` are the same operations, kept as aliases. */
+export type SelectionModifyOp = 'expand' | 'contract' | 'grow' | 'shrink' | 'feather' | 'border' | 'smooth';
 export declare const SELECTION_MODIFY_OPS: readonly SelectionModifyOp[];
-/** Select › Modify (grow = Expand, shrink = Contract, feather, border, smooth) by `radius` pixels. */
+/** Select › Modify (expand, contract, feather, border, smooth; grow and shrink are aliases) by `radius` pixels. */
 export declare function modifySelection(mask: SelectionMask, op: SelectionModifyOp, radius: number): SelectionMask;

package/dist/image-editor/selection/stroke.d.cts

@@ -0,0 +1,8 @@
+import { type SelectionMask } from './mask.cjs';
+/**
+ * The band Edit › Stroke paints along a selection's edge, `width` pixels wide: `inside` is the
+ * selection minus the selection contracted by `width`, `outside` the selection expanded by
+ * `width` minus the selection, and `center` straddles the edge by `width / 2` each way. Built
+ * from the exact distance transform the Modify commands use, so the band keeps soft edges.
+ */
+export declare function selectionRing(sel: SelectionMask, width: number, location: 'inside' | 'center' | 'outside'): SelectionMask;

package/dist/image-editor/selection/stroke.d.ts

@@ -0,0 +1,8 @@
+import { type SelectionMask } from './mask.js';
+/**
+ * The band Edit › Stroke paints along a selection's edge, `width` pixels wide: `inside` is the
+ * selection minus the selection contracted by `width`, `outside` the selection expanded by
+ * `width` minus the selection, and `center` straddles the edge by `width / 2` each way. Built
+ * from the exact distance transform the Modify commands use, so the band keeps soft edges.
+ */
+export declare function selectionRing(sel: SelectionMask, width: number, location: 'inside' | 'center' | 'outside'): SelectionMask;

package/dist/image-editor/selection/tool-options.d.cts

@@ -1,12 +1,14 @@
 import type { SelectionMask, SelectionMode } from './mask.cjs';
-import type { ColorDistance } from './wand.cjs';
+import type { ColorDistance, ColorRangePreset } from './wand.cjs';
 import type { RefineEdgeParams } from './refine.cjs';
 /** Selection tools of the image editor UI. */
-export type SelectionToolKind = 'wand' | 'rect' | 'ellipse' | 'lasso';
+export type SelectionToolKind = 'wand' | 'rect' | 'ellipse' | 'row' | 'column' | 'lasso' | 'polygon' | 'range';
 export declare const SELECTION_TOOLS: readonly {
     id: SelectionToolKind;
     label: string;
 }[];
+/** Labels of the Color Range presets, in menu order. */
+export declare const COLOR_RANGE_PRESET_LABELS: Record<ColorRangePreset, string>;
 export declare const SELECTION_MODE_LABELS: Record<SelectionMode, string>;
 /** The options bar of the selection tools (shared by the React and Svelte UIs). */
 export interface SelectionToolOptions {
@@ -21,6 +23,14 @@ export interface SelectionToolOptions {
     /** Sample the whole image (`composite`, default) or only the active pixel layer. */
     sample?: 'composite' | 'active-layer';
     distance: ColorDistance;
+    /** Feather new marquee, lasso, wand and Color Range selections by this many pixels (default 0). */
+    feather?: number;
+    /** Color Range: levels over which a sampled colour's coverage fades out (0..200, default 40). */
+    fuzziness?: number;
+    /** Color Range: limit each click to this radius in pixels (Localized Color Clusters; 0 = off). */
+    localized?: number;
+    /** Color Range: select everything except the sampled colours. */
+    rangeInvert?: boolean;
 }
 export declare const DEFAULT_SELECTION_TOOL_OPTIONS: SelectionToolOptions;
 /**

package/dist/image-editor/selection/tool-options.d.ts

@@ -1,12 +1,14 @@
 import type { SelectionMask, SelectionMode } from './mask.js';
-import type { ColorDistance } from './wand.js';
+import type { ColorDistance, ColorRangePreset } from './wand.js';
 import type { RefineEdgeParams } from './refine.js';
 /** Selection tools of the image editor UI. */
-export type SelectionToolKind = 'wand' | 'rect' | 'ellipse' | 'lasso';
+export type SelectionToolKind = 'wand' | 'rect' | 'ellipse' | 'row' | 'column' | 'lasso' | 'polygon' | 'range';
 export declare const SELECTION_TOOLS: readonly {
     id: SelectionToolKind;
     label: string;
 }[];
+/** Labels of the Color Range presets, in menu order. */
+export declare const COLOR_RANGE_PRESET_LABELS: Record<ColorRangePreset, string>;
 export declare const SELECTION_MODE_LABELS: Record<SelectionMode, string>;
 /** The options bar of the selection tools (shared by the React and Svelte UIs). */
 export interface SelectionToolOptions {
@@ -21,6 +23,14 @@ export interface SelectionToolOptions {
     /** Sample the whole image (`composite`, default) or only the active pixel layer. */
     sample?: 'composite' | 'active-layer';
     distance: ColorDistance;
+    /** Feather new marquee, lasso, wand and Color Range selections by this many pixels (default 0). */
+    feather?: number;
+    /** Color Range: levels over which a sampled colour's coverage fades out (0..200, default 40). */
+    fuzziness?: number;
+    /** Color Range: limit each click to this radius in pixels (Localized Color Clusters; 0 = off). */
+    localized?: number;
+    /** Color Range: select everything except the sampled colours. */
+    rangeInvert?: boolean;
 }
 export declare const DEFAULT_SELECTION_TOOL_OPTIONS: SelectionToolOptions;
 /**

package/dist/image-editor/selection/wand.d.cts

@@ -56,3 +56,40 @@ export declare function toneRange(pixels: PixelBuffer, range: ToneRangePreset |
  * the centre, none 60° away) × chroma × (2 − max), so neutrals are never selected.
  */
 export declare function hueRange(pixels: PixelBuffer, center: number): SelectionMask;
+/** Hue centres (degrees) of the Color Range colour presets. */
+export declare const HUE_RANGE_PRESETS: {
+    readonly reds: 0;
+    readonly yellows: 60;
+    readonly greens: 120;
+    readonly cyans: 180;
+    readonly blues: 240;
+    readonly magentas: 300;
+};
+/** Select › Color Range › Select menu: colours, tones and skin tones. */
+export type ColorRangePreset = keyof typeof HUE_RANGE_PRESETS | ToneRangePreset | 'skinTones';
+export declare const COLOR_RANGE_PRESETS: readonly ColorRangePreset[];
+export declare function isColorRangePreset(v: unknown): v is ColorRangePreset;
+/**
+ * Select › Color Range › Skin Tones: a heuristic over hue (full at 5–40°, none by 60° and −20°),
+ * HSV saturation (0.12–0.8) and value (above 0.3), so it covers light to dark skin and leaves
+ * out neutrals and saturated oranges. It also picks up skin-like wood, sand and leather.
+ */
+export declare function skinToneRange(pixels: PixelBuffer): SelectionMask;
+/**
+ * A Color Range preset: `reds` … `magentas` (`hueRange`), `highlights` / `midtones` / `shadows`
+ * (`toneRange`, with `falloff` levels, default 20) or `skinTones` (`skinToneRange`).
+ */
+export declare function colorRangePreset(pixels: PixelBuffer, preset: ColorRangePreset, options?: {
+    falloff?: number;
+}): SelectionMask;
+export interface GrowSimilarOptions {
+    /** 0..255, the largest per-channel difference from a selected colour (default 32, as the wand). */
+    tolerance?: number;
+}
+/**
+ * Select › Grow: adds the pixels connected (4-neighbours) to the selection whose colour is
+ * within `tolerance` of a selected colour. Unlike Expand, it follows colour, not distance.
+ */
+export declare function growSelection(pixels: PixelBuffer, sel: SelectionMask, options?: GrowSimilarOptions): SelectionMask;
+/** Select › Similar: adds every pixel in the image whose colour is within `tolerance` of a selected colour. */
+export declare function selectSimilar(pixels: PixelBuffer, sel: SelectionMask, options?: GrowSimilarOptions): SelectionMask;

package/dist/image-editor/selection/wand.d.ts

@@ -56,3 +56,40 @@ export declare function toneRange(pixels: PixelBuffer, range: ToneRangePreset |
  * the centre, none 60° away) × chroma × (2 − max), so neutrals are never selected.
  */
 export declare function hueRange(pixels: PixelBuffer, center: number): SelectionMask;
+/** Hue centres (degrees) of the Color Range colour presets. */
+export declare const HUE_RANGE_PRESETS: {
+    readonly reds: 0;
+    readonly yellows: 60;
+    readonly greens: 120;
+    readonly cyans: 180;
+    readonly blues: 240;
+    readonly magentas: 300;
+};
+/** Select › Color Range › Select menu: colours, tones and skin tones. */
+export type ColorRangePreset = keyof typeof HUE_RANGE_PRESETS | ToneRangePreset | 'skinTones';
+export declare const COLOR_RANGE_PRESETS: readonly ColorRangePreset[];
+export declare function isColorRangePreset(v: unknown): v is ColorRangePreset;
+/**
+ * Select › Color Range › Skin Tones: a heuristic over hue (full at 5–40°, none by 60° and −20°),
+ * HSV saturation (0.12–0.8) and value (above 0.3), so it covers light to dark skin and leaves
+ * out neutrals and saturated oranges. It also picks up skin-like wood, sand and leather.
+ */
+export declare function skinToneRange(pixels: PixelBuffer): SelectionMask;
+/**
+ * A Color Range preset: `reds` … `magentas` (`hueRange`), `highlights` / `midtones` / `shadows`
+ * (`toneRange`, with `falloff` levels, default 20) or `skinTones` (`skinToneRange`).
+ */
+export declare function colorRangePreset(pixels: PixelBuffer, preset: ColorRangePreset, options?: {
+    falloff?: number;
+}): SelectionMask;
+export interface GrowSimilarOptions {
+    /** 0..255, the largest per-channel difference from a selected colour (default 32, as the wand). */
+    tolerance?: number;
+}
+/**
+ * Select › Grow: adds the pixels connected (4-neighbours) to the selection whose colour is
+ * within `tolerance` of a selected colour. Unlike Expand, it follows colour, not distance.
+ */
+export declare function growSelection(pixels: PixelBuffer, sel: SelectionMask, options?: GrowSimilarOptions): SelectionMask;
+/** Select › Similar: adds every pixel in the image whose colour is within `tolerance` of a selected colour. */
+export declare function selectSimilar(pixels: PixelBuffer, sel: SelectionMask, options?: GrowSimilarOptions): SelectionMask;

package/dist/image-editor/selection-tools.d.cts

@@ -1,9 +1,14 @@
 import type { AgentTool, AgentToolProvider } from '../tools/registry.cjs';
 import type { ImageEditorController } from './controller.cjs';
 /**
- * Agent tools for selections and masks (part of `createImageEditorToolProvider`):
- * `get_selection`, `select_region`, `select_by_color`, `modify_selection`, `refine_selection`
- * and `apply_selection_as_mask`. Coordinates are natural pixels of the source image.
+ * Agent tools for selections and masks (part of `createImageEditorToolProvider`): reading
+ * (`get_selection`), selecting (`select_all`, `deselect`, `invert_selection`, `select_rect`,
+ * `select_ellipse`, `select_polygon`, `select_line`, `magic_wand`, `select_color_range`,
+ * `grow_selection`, `select_similar`, `reselect`), loading (`load_selection_from_image`,
+ * `load_selection_from_mask`, `select_layer_transparency`), the view
+ * (`set_selection_display`), editing (`modify_selection`, `refine_selection`) and masking
+ * (`apply_selection_as_mask`). `select_region` and `select_by_color` are deprecated aliases.
+ * Coordinates are natural pixels of the source image.
  */
 export declare function createImageSelectionTools(controller: ImageEditorController): AgentTool[];
 /** Options for `createImageSegmentationToolProvider`. */

package/dist/image-editor/selection-tools.d.ts

@@ -1,9 +1,14 @@
 import type { AgentTool, AgentToolProvider } from '../tools/registry.js';
 import type { ImageEditorController } from './controller.js';
 /**
- * Agent tools for selections and masks (part of `createImageEditorToolProvider`):
- * `get_selection`, `select_region`, `select_by_color`, `modify_selection`, `refine_selection`
- * and `apply_selection_as_mask`. Coordinates are natural pixels of the source image.
+ * Agent tools for selections and masks (part of `createImageEditorToolProvider`): reading
+ * (`get_selection`), selecting (`select_all`, `deselect`, `invert_selection`, `select_rect`,
+ * `select_ellipse`, `select_polygon`, `select_line`, `magic_wand`, `select_color_range`,
+ * `grow_selection`, `select_similar`, `reselect`), loading (`load_selection_from_image`,
+ * `load_selection_from_mask`, `select_layer_transparency`), the view
+ * (`set_selection_display`), editing (`modify_selection`, `refine_selection`) and masking
+ * (`apply_selection_as_mask`). `select_region` and `select_by_color` are deprecated aliases.
+ * Coordinates are natural pixels of the source image.
  */
 export declare function createImageSelectionTools(controller: ImageEditorController): AgentTool[];
 /** Options for `createImageSegmentationToolProvider`. */

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

@@ -23,8 +23,14 @@ export interface ImageEditorToolProviderOptions {
  * - `render_preview {maxSide}`: the rendered image as a PNG, longest side at most `maxSide`.
  * - `capture_view {region, rect?, ...}`: a screenshot of the whole image, the selection or a rect in
  *   natural pixels (up to 8× for close inspection), optionally with the selection shaded.
- * - Selections and masks: `get_selection`, `select_region`, `select_by_color`, `modify_selection`,
- *   `refine_selection`, `apply_selection_as_mask` (see `createImageSelectionTools`).
+ * - Selections and masks: `get_selection`, `select_all`, `deselect`, `invert_selection`,
+ *   `select_rect`, `select_ellipse`, `select_polygon`, `select_line`, `magic_wand`,
+ *   `select_color_range`, `grow_selection`, `select_similar`, `reselect`,
+ *   `select_layer_transparency`, `stroke_selection`, `crop_to_selection`, `content_aware_fill`,
+ *   `copy_pixels`, `cut_pixels`, `paste_pixels`,
+ *   `load_selection_from_image`, `load_selection_from_mask`, `set_selection_display`,
+ *   `modify_selection`, `refine_selection`, `apply_selection_as_mask` and the deprecated
+ *   `select_region` / `select_by_color` (see `createImageSelectionTools`).
  * - Layers, geometry and history: `get_image_info`, `get_histogram`, `update_adjustment_layer`,
  *   `remove_adjustment_layer`, `move_adjustment_layer`, `set_crop`, `reset_crop`, `set_rotation`,
  *   `flip_image`, `undo_image`, `redo_image` (see `createImageEditTools`).

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

@@ -23,8 +23,14 @@ export interface ImageEditorToolProviderOptions {
  * - `render_preview {maxSide}`: the rendered image as a PNG, longest side at most `maxSide`.
  * - `capture_view {region, rect?, ...}`: a screenshot of the whole image, the selection or a rect in
  *   natural pixels (up to 8× for close inspection), optionally with the selection shaded.
- * - Selections and masks: `get_selection`, `select_region`, `select_by_color`, `modify_selection`,
- *   `refine_selection`, `apply_selection_as_mask` (see `createImageSelectionTools`).
+ * - Selections and masks: `get_selection`, `select_all`, `deselect`, `invert_selection`,
+ *   `select_rect`, `select_ellipse`, `select_polygon`, `select_line`, `magic_wand`,
+ *   `select_color_range`, `grow_selection`, `select_similar`, `reselect`,
+ *   `select_layer_transparency`, `stroke_selection`, `crop_to_selection`, `content_aware_fill`,
+ *   `copy_pixels`, `cut_pixels`, `paste_pixels`,
+ *   `load_selection_from_image`, `load_selection_from_mask`, `set_selection_display`,
+ *   `modify_selection`, `refine_selection`, `apply_selection_as_mask` and the deprecated
+ *   `select_region` / `select_by_color` (see `createImageSelectionTools`).
  * - Layers, geometry and history: `get_image_info`, `get_histogram`, `update_adjustment_layer`,
  *   `remove_adjustment_layer`, `move_adjustment_layer`, `set_crop`, `reset_crop`, `set_rotation`,
  *   `flip_image`, `undo_image`, `redo_image` (see `createImageEditTools`).

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

@@ -311,6 +311,8 @@ export interface ImageEditorState {
     selection?: SelectionMask | null;
     /** Quick Mask view: tint the unselected area instead of drawing marching ants (view state). */
     quickMask?: boolean;
+    /** How the canvas shows the selection (view state; `quickMask` mirrors `'quickMask'`). */
+    selectionDisplay?: 'ants' | 'quickMask' | 'none';
     /**
      * The layer stack, bottom to top. Opening an image gives one pixel layer, "Background", whose
      * pixels are the source image. Layers are immutable: compare them by identity.

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

@@ -311,6 +311,8 @@ export interface ImageEditorState {
     selection?: SelectionMask | null;
     /** Quick Mask view: tint the unselected area instead of drawing marching ants (view state). */
     quickMask?: boolean;
+    /** How the canvas shows the selection (view state; `quickMask` mirrors `'quickMask'`). */
+    selectionDisplay?: 'ants' | 'quickMask' | 'none';
     /**
      * The layer stack, bottom to top. Opening an image gives one pixel layer, "Background", whose
      * pixels are the source image. Layers are immutable: compare them by identity.

package/dist/paint-editor/index.cjs

@@ -7,7 +7,7 @@ var _chunkZ64NRDEHcjs = require('../chunk-Z64NRDEH.cjs');
 
 
 
-var _chunkUHMSMUHKcjs = require('../chunk-UHMSMUHK.cjs');
+var _chunkC6TRAAG4cjs = require('../chunk-C6TRAAG4.cjs');
 require('../chunk-A2IS7EHE.cjs');
 
 
@@ -1653,11 +1653,11 @@ function header(state, options) {
   return out;
 }
 function serializePaintDocument(state, options = {}) {
-  const { layers, assets } = _chunkUHMSMUHKcjs.serializeLayers.call(void 0, state.layers);
+  const { layers, assets } = _chunkC6TRAAG4cjs.serializeLayers.call(void 0, state.layers);
   return { ...header(state, options), layers, assets };
 }
 async function serializePaintDocumentExternal(state, store, options = {}) {
-  const { layers, assets } = await _chunkUHMSMUHKcjs.serializeLayersExternal.call(void 0, state.layers, store);
+  const { layers, assets } = await _chunkC6TRAAG4cjs.serializeLayersExternal.call(void 0, state.layers, store);
   return { ...header(state, options), layers, assets };
 }
 function paintLayersOnly(layers, problems) {
@@ -1694,7 +1694,7 @@ function deserializePaintDocument(raw) {
   const canvas = normalizeCanvas({ width: r.width, height: r.height, dpi: _nullishCoalesce(r.dpi, () => ( void 0)) });
   const paper = _chunkYQ5C5BVKcjs.normalizePaper.call(void 0, _nullishCoalesce(r.paper, () => ( {})));
   const assets = r.assets && typeof r.assets === "object" ? r.assets : {};
-  const layers = paintLayersOnly(_chunkUHMSMUHKcjs.deserializeLayers.call(void 0, r.layers, { assets, problems }), problems);
+  const layers = paintLayersOnly(_chunkC6TRAAG4cjs.deserializeLayers.call(void 0, r.layers, { assets, problems }), problems);
   const wanted = typeof r.activeLayerId === "string" ? r.activeLayerId : null;
   const activeLayerId = wanted && _chunkHGTDMKNEcjs.findLayer.call(void 0, layers, wanted) ? wanted : _nullishCoalesce(_optionalChain([_chunkHGTDMKNEcjs.flattenLayers.call(void 0, layers), 'access', _70 => _70.filter, 'call', _71 => _71((l) => l.type === "pixel"), 'access', _72 => _72.pop, 'call', _73 => _73(), 'optionalAccess', _74 => _74.id]), () => ( null));
   const wetEvents = Array.isArray(r.wetEvents) ? r.wetEvents.filter((e) => e && typeof e === "object" && Number.isInteger(e.clock) && typeof e.kind === "string") : [];
@@ -1710,7 +1710,7 @@ async function deserializePaintDocumentAsync(raw, store) {
   if (!raw || typeof raw !== "object") throw new Error("Not a paint document: expected a JSON object.");
   const r = raw;
   const problems = [];
-  const assets = await _chunkUHMSMUHKcjs.resolveExternalAssets.call(void 0, _nullishCoalesce(r.assets, () => ( {})), store, problems);
+  const assets = await _chunkC6TRAAG4cjs.resolveExternalAssets.call(void 0, _nullishCoalesce(r.assets, () => ( {})), store, problems);
   const loaded = deserializePaintDocument({ ...r, assets });
   return { ...loaded, problems: [...problems, ...loaded.problems] };
 }
@@ -5409,7 +5409,7 @@ var PaintEditorController = (_class10 = class _PaintEditorController {
       return next.type === "group" ? { ...next, children: toStandard(next.children) } : next;
     });
     const layers = toStandard(dried);
-    const result = _chunkUHMSMUHKcjs.exportPsd.call(void 0, { width, height, layers: [paperLayer, ...layers], merged, resolution: dpi });
+    const result = _chunkC6TRAAG4cjs.exportPsd.call(void 0, { width, height, layers: [paperLayer, ...layers], merged, resolution: dpi });
     for (const [mode, names] of changed) {
       const label = _nullishCoalesce(_optionalChain([_chunkCWM3CUUXcjs.BLEND_MODES, 'access', _271 => _271.find, 'call', _272 => _272((m) => m.id === mode), 'optionalAccess', _273 => _273.label]), () => ( mode));
       const std = _nullishCoalesce(_optionalChain([_chunkCWM3CUUXcjs.BLEND_MODES, 'access', _274 => _274.find, 'call', _275 => _275((m) => m.id === _chunkCWM3CUUXcjs.standardBlendMode.call(void 0, mode)), 'optionalAccess', _276 => _276.label]), () => ( _chunkCWM3CUUXcjs.standardBlendMode.call(void 0, mode)));

package/dist/paint-editor/index.js

@@ -7,7 +7,7 @@ import {
   resolveExternalAssets,
   serializeLayers,
   serializeLayersExternal
-} from "../chunk-Y46OMERN.js";
+} from "../chunk-GYYSPMVU.js";
 import "../chunk-3CI7FRMK.js";
 import {
   EffectRendererPool

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.183.0",
+  "version": "0.185.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",