@pixerate/editor 0.183.0 → 0.186.0

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

@@ -10,6 +10,8 @@ export interface QuickMaskStyle {
     color?: readonly [number, number, number];
     /** 0..1 (default 0.5): opacity over fully unselected pixels. */
     opacity?: number;
+    /** Tint the unselected area (`masked`, default) or the selected area (`selected`). */
+    indicates?: 'masked' | 'selected';
 }
 /**
  * Quick Mask view: RGBA pixels (natural image size) tinting the *unselected* area, so the

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,16 @@ 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`, alpha channels (`list_channels`, `save_selection`,
+ *   `load_selection_from_channel`, `set_channel_properties`, `duplicate_channel`,
+ *   `delete_channel`), `set_quick_mask`,
+ *   `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,16 @@ 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`, alpha channels (`list_channels`, `save_selection`,
+ *   `load_selection_from_channel`, `set_channel_properties`, `duplicate_channel`,
+ *   `delete_channel`), `set_quick_mask`,
+ *   `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

@@ -2,6 +2,7 @@ import type { GlobalLight } from '../raster/effects/model.cjs';
 import type { EffectPattern } from '../raster/effects/patterns.cjs';
 import type { BlendMode } from './blend.cjs';
 import type { SelectionMask, SerializedSelection } from './selection/mask.cjs';
+import type { AlphaChannel, SerializedAlphaChannel } from './selection/channels.cjs';
 import type { ImageLayer, LayerTarget } from './layers/model.cjs';
 import type { SerializedLayeredImageEditorState } from './layers/serialize.cjs';
 import type { PaintOptions } from './controller.cjs';
@@ -311,6 +312,15 @@ 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';
+    /**
+     * Quick Mask mode: painting and fills without a layer edit the selection itself (white
+     * selects, black deselects), shown as a tint. View state; the edits are undo steps.
+     */
+    quickMaskEditing?: boolean;
+    /** Alpha channels: saved selections kept with the document, recorded in undo history. */
+    channels?: AlphaChannel[];
     /**
      * 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.
@@ -378,6 +388,8 @@ export interface LegacySerializedImageEditorState {
     annotations: Annotation[];
     /** The active selection, run-length encoded. Missing when nothing is selected. */
     selection?: SerializedSelection;
+    /** Alpha channels (saved selections), run-length encoded. */
+    channels?: SerializedAlphaChannel[];
 }
 /**
  * A stored editor state: the document-level schema (v1 / v2) or the layered schema (v3, see

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

@@ -2,6 +2,7 @@ import type { GlobalLight } from '../raster/effects/model.js';
 import type { EffectPattern } from '../raster/effects/patterns.js';
 import type { BlendMode } from './blend.js';
 import type { SelectionMask, SerializedSelection } from './selection/mask.js';
+import type { AlphaChannel, SerializedAlphaChannel } from './selection/channels.js';
 import type { ImageLayer, LayerTarget } from './layers/model.js';
 import type { SerializedLayeredImageEditorState } from './layers/serialize.js';
 import type { PaintOptions } from './controller.js';
@@ -311,6 +312,15 @@ 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';
+    /**
+     * Quick Mask mode: painting and fills without a layer edit the selection itself (white
+     * selects, black deselects), shown as a tint. View state; the edits are undo steps.
+     */
+    quickMaskEditing?: boolean;
+    /** Alpha channels: saved selections kept with the document, recorded in undo history. */
+    channels?: AlphaChannel[];
     /**
      * 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.
@@ -378,6 +388,8 @@ export interface LegacySerializedImageEditorState {
     annotations: Annotation[];
     /** The active selection, run-length encoded. Missing when nothing is selected. */
     selection?: SerializedSelection;
+    /** Alpha channels (saved selections), run-length encoded. */
+    channels?: SerializedAlphaChannel[];
 }
 /**
  * A stored editor state: the document-level schema (v1 / v2) or the layered schema (v3, see

package/dist/paint-editor/index.cjs

@@ -7,7 +7,7 @@ var _chunkZ64NRDEHcjs = require('../chunk-Z64NRDEH.cjs');
 
 
 
-var _chunkUHMSMUHKcjs = require('../chunk-UHMSMUHK.cjs');
+var _chunkX2KQQZBTcjs = require('../chunk-X2KQQZBT.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 } = _chunkX2KQQZBTcjs.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 _chunkX2KQQZBTcjs.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(_chunkX2KQQZBTcjs.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 _chunkX2KQQZBTcjs.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 = _chunkX2KQQZBTcjs.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-FW7N64XK.js";
 import "../chunk-3CI7FRMK.js";
 import {
   EffectRendererPool

package/package.json

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

package/skills/pixerate-image-editor/SKILL.md

@@ -74,24 +74,9 @@ Also an optional selection and crop/rotate/flip. See `pixerate-agent-tools` for
 
 ### Free Transform
 
-1. **Read the frame first**: `get_transform_frame` says what a transform would move (`content`,
-   `moved`) and its `frame` (document bounds of the content) with its corners. Every transform
-   works on that frame: the numeric fields are percent of it and turn about one of its anchors.
-2. **Pick what moves** with `content`: `layer` (all its pixels and a linked mask), `selection`
-   (only the selected pixels, committed back into the same layer; the hole they leave is
-   transparent and the outline moves with them), `selection-copy` (Layer via Copy, then the copy
-   is transformed on a new layer; the original stays) or `auto` (selection when something is
-   selected). `channel: "mask"` moves an unlinked mask alone; `transform_selection` moves only
-   the outline.
-3. **Choose the tool by the change**: `transform_layer` with `scaleX` / `scaleY` (percent),
-   `rotate`, `skewX` / `skewY` (degrees), `dx` / `dy` and a `reference` anchor for scale, rotate
-   and skew; `corners` for Distort (each corner free) and Perspective (move two corners
-   symmetrically: the top pair in by the same amount narrows the top); `matrix` when you have one;
-   `warp_layer` for a preset bend (`style`, `bend`, `horizontal`, `vertical`) or a custom `mesh`;
-   `flip_layer` and `rotate_layer_90` for exact flips and quarter turns.
-4. **Transform once.** Every call resamples the pixels, so chained calls soften them: put scale,
-   rotation and move into one `transform_layer` call (or one matrix) instead of several.
-5. **Look**: `render_preview`, or `capture_view` at the edges; each call is one undo step.
+`get_transform_frame` first, pick `content` (`layer`, `selection`, `selection-copy`, `auto`), and
+put every change into one `transform_layer` call (each call resamples). Read
+[references/free-transform.md](references/free-transform.md) before transforming.
 
 ### Smart objects
 
@@ -256,6 +241,7 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | `get_adjustments` | Read the current state: `values` by control id, `process` version (1 or 2), and `layers` bottom to top with id, kind, params, opacity, blend, enabled and mask. Call first, and to find layer ids. |
 | `list_controls` | Get every base control (id, label, section, min, max, step, default, `requiresProcess`), each layer kind's settable controls (plus `opacity`), the blend mode ids and the `layers.<layerId>.<controlId>` path format. Call once per session before writing. |
 | `get_selection` | Read the active selection: `empty`, `bounds` (natural pixels), `area` in pixels, `percent` of the image and a description. Check it after every select or modify step and before masking: a wand that covered 90% of the image is the wrong selection. |
+| `list_channels` | Read the alpha channels (saved selections): id, name, bounds, percent, overlay and visibility, and whether Quick Mask mode is on. |
 | `select_subject` | Select › Subject (only when the host has a segmentation model): `target` describes what to select ("the dog", "the sky"); an AI model finds the matching objects and selects their outlines, combined by `mode`. `maxSegments` 1 for a single subject. Returns the selection and `found` (label, bounds per object); nothing found leaves the selection unchanged. |
 | `list_layers` | Read the layer stack bottom to top as a tree: id, type (`pixel`, `adjustment`, `group`, `shape`, `annotation`, `smart`; smart objects add their `contents`, `smartFilters` and `filterMask`; shapes a `shape` summary of component ops and kinds and paint types, and `annotation` when migrated from one), name, document `bounds` of pixel layers, visibility, opacity, `fillOpacity`, blend, `clipped`, locks, a `mask` summary, an `effects` summary (master switch, scale, effect ids and kinds), pixel-layer `filters` (the Background's `develop` filter is the base adjustments), adjustment `kind` and `params`, group `children`, and which layer is `active`. Call it to understand a document with more than the Background before changing it; adjustment layer ids work with every adjustment-layer tool. |
 | `list_layer_effects` | Read one layer's effects: `enabled` (master switch), `scale` (Scale Effects), `margin` (px they reach beyond the shape), `fromPsd`, and every effect with `id`, `kind`, `label` and all its settings. Also returns the `globalLight`, the `patterns` pattern effects can use and the effect `kinds`. Call before changing effects you did not add. |
@@ -280,7 +266,7 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | Tool | Use it to |
 | --- | --- |
 | `set_adjustments` | Set base controls and existing layer parameters in one undo step: `values` is a map of control id or `layers.<layerId>.<controlId>` path to number; `label` is echoed. Values are clamped to range; returns `applied` and `clamped` (and a note when `tint` is set on a process 1 edit). Unknown ids fail and change nothing. Cannot set curves points, booleans or colours. |
-| `add_adjustment_layer` | Add a layer above the other adjustment layers and below annotations (or directly above `aboveId`, or at the top of group `parentId`): `kind` (curves, levels, hueSaturation, vibrance, colorBalance, blackWhite, photoFilter, invert, posterize, threshold), optional `params` merged with neutral defaults, `opacity` 0..1 (default 1), `blend` (default normal), `name`. Returns the layer (with its new id) and its stack index. The only tool that sets curves points, `colorize`, `preserveLuminosity`, a black and white `tint` or a photo filter `color`. |
+| `add_adjustment_layer` | Add a layer above the other adjustment layers and below annotations (or directly above `aboveId`, or at the top of group `parentId`): `kind` (curves, levels, hueSaturation, vibrance, colorBalance, blackWhite, photoFilter, invert, posterize, threshold), optional `params` merged with neutral defaults, `opacity` 0..1 (default 1), `blend` (default normal), `name`. With a selection the layer is masked by it (`useSelection`, default true; `false` for a global layer; `masked` in the result). Returns the layer (with its new id) and its stack index. The only tool that sets curves points, `colorize`, `preserveLuminosity`, a black and white `tint` or a photo filter `color`. |
 | `select_all` | Select › All. Returns the selection summary (`empty`, `bounds`, `area`, `percent`). |
 | `deselect` | Clear the selection so edits apply to the whole layer. Returns the empty summary. |
 | `invert_selection` | Select › Inverse (soft edges stay soft; with nothing selected, selects all). Returns the summary. |
@@ -354,7 +340,7 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | `copy_smart_object` | Duplicate a smart object above it: `linked: true` shares the contents (edits show in both), `linked: false` (default, New Smart Object via Copy) gives independent contents. Returns the copy and its `contentsId`. |
 | `edit_smart_object_contents` | Open a smart object's contents as their own document (raster contents as one pixel layer, "Layer 0") with their own undo; all tools then act inside them. Returns the size, `layerIds`, `layers` and `editing` (the open path). Always close it. |
 | `close_smart_object_contents` | Close the innermost open contents: `save` true (default) writes them back and re-renders every linked instance (one undo step), false discards. Returns `layerId`, `changed`, `layerIds` and what is still `editing`. |
-| `add_smart_filter` | Add a `develop` (brightness … tint) or `blur` (`radius`) smart filter with its own `blend` and `opacity`, at `index` (default top); kinds may repeat. Returns the `filter` (with id) and the stack. |
+| `add_smart_filter` | Add a `develop` (brightness … tint) or `blur` (`radius`) smart filter with its own `blend` and `opacity`, at `index` (default top); kinds may repeat. With a selection the filter mask is set from it (`useSelection`, default true). Returns the `filter` (with id), the stack and `masked`. |
 | `update_smart_filter` | Change one smart filter's settings, `enabled`, `blend` or `opacity` (`filterId` from `get_smart_object`); kind `psd` filters take only the last three. Returns the filter and the stack. |
 | `remove_smart_filter` | Remove one smart filter (the filter mask goes with the last one). Returns the stack. |
 | `move_smart_filter` | Move a smart filter to `index` (0 = bottom, applied first). Returns the stack. |
@@ -398,12 +384,24 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | `mix_colors` | Read-only. Mix 1 to 16 `colors` (`{color: #rrggbb, weight, strength?}`) like paint (Kubelka-Munk over reflectance spectra). Returns `mixed` (#rrggbb), `rgbLerp` (the plain RGB average, for comparison) and the normalised `weights`. Call it before `paint_stroke` / `fill_pixels` to pick a paint colour. |
 | `clear_pixels` | Remove the selected pixels (alpha to 0; a transparency-locked layer or a mask gets the background colour). Returns the changed bounds. |
 | `import_psd` | Open a PSD / PSB (`data` base64, a `data:` URL is fine) as the document, replacing the layers, crop and rotation (one undo step). Returns the new `layers` tree with ids, `layerIds`, size and `warnings` naming the affected layers. Call `inspect_psd` first when losses matter. |
-| `apply_effect` | Run a provider filter effect on a layer as a smart filter (`target`, `effect`, `values`, `index`, `enabled`, `opacity`); a pixel, shape or type layer becomes a smart object in the same undo step (`converted`). Returns the filter id. |
+| `apply_effect` | Run a provider filter effect on a layer as a smart filter (`target`, `effect`, `values`, `index`, `enabled`, `opacity`); a pixel, shape or type layer becomes a smart object in the same undo step (`converted`). With a selection the filter mask is set from it (`masked`): deselect first to filter the whole layer. Returns the filter id. |
 | `update_effect` | Change an effect smart filter (`values` merged, `null` resets; `enabled`, `opacity`, `index`) or redraw an effect layer (`effect: "generator"`, values only). |
 | `remove_effect` | Remove an effect smart filter, or (`generator`) keep an effect layer's pixels as a plain layer. |
 | `add_effect_layer` | Add a layer drawn by a generator, overlay or title effect at the document's size and bit depth (`values`, `time`, `animate`, `name`, `aboveId` / `belowId`, `opacity`, `blend`). An effect with its own background (`backgroundOpacity` in `describe_effect`) starts with it transparent when there are layers below. Returns the layer id. |
 | `set_effect_layer` | Change an effect layer: swap its `effect` (its defaults plus `values`), pick the still frame (`time`, ms), or make it play in an animation (`animate: { duration }`; `null` for a still frame). The longest animating layer sets the animation's length. |
 | `apply_selection_as_mask` | Mask a layer with the current selection: pass `layerId` to mask an existing layer, or `kind` (plus optional `params`) to create a new masked layer in one step. `density` 0..1 and `feather` px soften the mask non-destructively. Returns `layerId`, kind, mask info and the selection summary. |
+| `stroke_selection` | Edit › Stroke: a band `width` px (≤ 250) `outside` (default), `inside` or `center` on the selection edge, with `color`, `opacity`, `blend`, on a layer's pixels or mask (`channel`). One undo step. Returns the changed `bounds`. |
+| `crop_to_selection` | Set the crop box to the selection's bounds (non-destructive; `reset_crop` undoes it). Returns the `crop`. |
+| `content_aware_fill` | Remove what is selected by synthesising texture from around it on a pixel layer; `output` `new-layer` (keeps the fill separate, recommended) or `current`; `sampleRadius`, `seed` (another seed, another fill). Select with a 2–4 px margin. 8-bit only. Returns `layerId` and `bounds`. |
+| `copy_pixels` | Copy the selected pixels of a layer (or with `merged` the visible image) to the editor clipboard, cropped to the selection with its soft edge. No undo step. Returns `width`, `height`, `x`, `y`. |
+| `cut_pixels` | Copy, then clear the selected pixels (one undo step). Returns the size and position. |
+| `paste_pixels` | Paste the clipboard as a new layer: `mode` `new-layer` (centred on the selection or canvas), `in-place`, `into` (masked by the selection) or `outside` (masked by its inverse). One undo step. Returns `layerId`, `bounds`, `masked`. |
+| `save_selection` | Save the selection to a new alpha channel (`name`), or into `channelId` by `mode`. Saved with the document and in PSD. Returns the `channel`. |
+| `load_selection_from_channel` | Load an alpha channel as the selection (`channelId`, `invert`, `mode`). Returns the summary. |
+| `set_channel_properties` | Rename a channel or change its overlay `color`, `opacity`, `indicates` (`masked` / `selected`) and `visible`. Returns the `channel`. |
+| `duplicate_channel` | Copy a channel (`name`, default "<name> copy"). Returns the copy. |
+| `delete_channel` | Delete a channel (undoable). Returns the remaining channels. |
+| `set_quick_mask` | Quick Mask mode (`enabled`): paint, fill and retouch tools without `layerId` edit the selection (white selects, black deselects); turn it off before painting layers. Returns the mode. |
 
 ### Save and open
 

package/skills/pixerate-image-editor/references/free-transform.md

@@ -0,0 +1,22 @@
+# Free Transform
+
+How to move, scale, rotate, skew, distort and warp layers, selected pixels and masks in the Pixerate image editor. Read it before `transform_layer`, `warp_layer`, `transform_selection`, `flip_layer` or `rotate_layer_90`.
+
+1. **Read the frame first**: `get_transform_frame` says what a transform would move (`content`,
+   `moved`) and its `frame` (document bounds of the content) with its corners. Every transform
+   works on that frame: the numeric fields are percent of it and turn about one of its anchors.
+2. **Pick what moves** with `content`: `layer` (all its pixels and a linked mask), `selection`
+   (only the selected pixels, committed back into the same layer; the hole they leave is
+   transparent and the outline moves with them), `selection-copy` (Layer via Copy, then the copy
+   is transformed on a new layer; the original stays) or `auto` (selection when something is
+   selected). `channel: "mask"` moves an unlinked mask alone; `transform_selection` moves only
+   the outline.
+3. **Choose the tool by the change**: `transform_layer` with `scaleX` / `scaleY` (percent),
+   `rotate`, `skewX` / `skewY` (degrees), `dx` / `dy` and a `reference` anchor for scale, rotate
+   and skew; `corners` for Distort (each corner free) and Perspective (move two corners
+   symmetrically: the top pair in by the same amount narrows the top); `matrix` when you have one;
+   `warp_layer` for a preset bend (`style`, `bend`, `horizontal`, `vertical`) or a custom `mesh`;
+   `flip_layer` and `rotate_layer_90` for exact flips and quarter turns.
+4. **Transform once.** Every call resamples the pixels, so chained calls soften them: put scale,
+   rotation and move into one `transform_layer` call (or one matrix) instead of several.
+5. **Look**: `render_preview`, or `capture_view` at the edges; each call is one undo step.

package/skills/pixerate-image-selection-masking/SKILL.md

@@ -53,19 +53,30 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
    - `grow_selection` (tolerance 10–30) picks up the shades a wand click missed;
      `select_similar` adds the same colours elsewhere in the image.
    - `contract` 1–2 px pulls the edge off a halo.
+   - Paint it directly: `set_quick_mask` `enabled: true`, then `paint_stroke` without
+     `layerId` (white adds, black removes, a soft brush feathers; `blur_stroke` softens a part
+     of the edge), then `set_quick_mask` `enabled: false`.
    - `refine_selection` snaps to real edges: radius 2–4 for hard edges, 8–20 for hair and fur;
      `smartRadius: true` for mixed edges.
    - `shiftEdge` −10..−30 % tightens a refined edge that picked up background.
    **Check:** `percent` changed by roughly what you intended (a few percent at most for a
    cleanup).
 5. **Output.** Choose by goal:
-   - A local adjustment: `apply_selection_as_mask` with `kind` (one step).
+   - A local adjustment: `add_adjustment_layer` while the selection is active (it is masked
+     by it), or `apply_selection_as_mask` with `kind`. Filters (`apply_effect`,
+     `add_smart_filter`) are also limited to an active selection.
    - A cutout: `layer_via_copy` (the original stays), or `add_layer_mask` `from: "selection"` on
      the layer itself.
-   - Painting or fills inside it: keep the selection active and paint.
+   - Painting or fills inside it: keep the selection active and paint; `stroke_selection` for
+     an outline that follows it.
+   - Removing what it covers: `content_aware_fill` `output: "new-layer"`.
+   - A copy elsewhere: `copy_pixels`, then `paste_pixels` (`into` masks it by a selection).
    Soften with the mask's own `feather` / `density` rather than `modify_selection` `feather`, so
    it stays adjustable.
-6. **Verify.** `render_preview` at 1024 px or more, and `capture_view` on the edge at 2–8×.
+6. **Store.** `save_selection` with a clear name before you change a selection that took
+   work, and whenever it will be needed again (a second adjustment, a later refinement). Load
+   it with `load_selection_from_channel`; channels are saved with the document and in PSDs.
+7. **Verify.** `render_preview` at 1024 px or more, and `capture_view` on the edge at 2–8×.
    **Check:** no fringe of the old background colour, no stair-steps, no visible line where an
    adjustment ends. Fix by loading the mask back (`load_selection_from_mask`), refining, and
    masking again.
@@ -114,6 +125,14 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
   a smart object's filters.
 - **Clip a texture or colour to a layer:** put it directly above and set `clipped: true` with
   `set_layer_properties`; no selection is needed.
+- **Remove an object:** select it with a 2–4 px margin (`modify_selection` `expand`), then
+  `content_aware_fill` `output: "new-layer"`; try another `seed` if the fill repeats texture,
+  and mask out what is wrong.
+- **Outline a cutout:** `select_layer_transparency` on it, then `stroke_selection`
+  `location: "outside"` on a new layer below it.
+- **Crop to a subject:** select it, then `crop_to_selection` (non-destructive).
+- **Put a picture into a shape:** select the shape, `copy_pixels` the picture, then
+  `paste_pixels` `mode: "into"`.
 - **Picture inside a frame:** mask the picture with the frame's shape, then
   `set_layer_mask_properties` `linked: false` so the picture moves under a fixed mask; link it
   again afterwards.
@@ -135,6 +154,11 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
 - **Deselected by mistake:** `reselect` brings it back (or `undo_image`).
 - **Empty selection:** `modify_selection`, `refine_selection` and `apply_selection_as_mask` fail
   on it. Select first.
+- **A forgotten selection limits new layers and filters:** `add_adjustment_layer`,
+  `apply_effect` and `add_smart_filter` mask themselves by it. `deselect` first for a global
+  change, or pass `useSelection: false`.
+- **Quick Mask left on:** while it is on, `paint_stroke` and `fill_pixels` without `layerId`
+  edit the selection, not the image. Turn it off when the selection is done.
 - **Hidden selection still applies:** with `set_selection_display` `none`, paint and fills are
   still limited to it. `deselect` before a whole-layer edit.
 - **Wrong coordinates:** use natural image pixels, not preview pixels. On a cropped or rotated
@@ -152,6 +176,10 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
 - `select_layer_transparency`: a layer's own pixels
 - `grow_selection`, `select_similar`: add similar colour, connected or anywhere
 - `reselect`: undo a deselect
+- `save_selection`, `load_selection_from_channel`, `list_channels`: keep selections as alpha channels
+- `set_channel_properties`, `duplicate_channel`, `delete_channel`: manage channels
+- `set_quick_mask`: paint the selection
+- `fill_pixels`, `blur_stroke`: fill or soften the selection in Quick Mask mode
 - `magic_wand`: similar colour from a seed
 - `select_color_range`: colour samples, hue, tone and skin presets
 - `select_subject`: a subject by description (needs a host model)
@@ -167,6 +195,11 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
 - `add_layer_mask`, `set_layer_mask_properties`, `apply_layer_mask`, `remove_layer_mask`: layer masks
 - `set_smart_filter_mask`: limit smart filters
 - `layer_via_copy`: lift the selection onto a new layer
+- `stroke_selection`: an outline along the selection edge
+- `crop_to_selection`: crop to the selection's bounds
+- `content_aware_fill`: remove what is selected
+- `copy_pixels`, `cut_pixels`, `paste_pixels`: the editor clipboard
+- `add_adjustment_layer`, `apply_effect`, `add_smart_filter`: masked by an active selection
 - `paint_stroke`: paint on a mask with `channel: "mask"`
 - `undo_image`: take back a step
 - `set_layer_properties`: clipping