@pixerate/editor 0.182.0 → 0.185.0

package/dist/image-editor/index.js

@@ -370,7 +370,7 @@ import {
   writePsd,
   xyToTempTint,
   xyToUv
-} from "../chunk-Y46OMERN.js";
+} from "../chunk-GYYSPMVU.js";
 import {
   parseCssColor
 } from "../chunk-3CI7FRMK.js";
@@ -1362,7 +1362,7 @@ var ImageEditorRenderer = class {
       }
       ctx.restore();
     }
-    const display = options.selectionDisplay ?? (state.quickMask ? "quickMask" : "ants");
+    const display = options.selectionDisplay ?? state.selectionDisplay ?? (state.quickMask ? "quickMask" : "ants");
     if (state.selection?.bounds && display !== "none" || options.draftSelectionPath?.length) {
       ctx.save();
       try {
@@ -3065,7 +3065,7 @@ var TONE_RANGE_PRESETS = {
 function toneRange(pixels, range, falloff = 20) {
   const n = checkPixels(pixels);
   const [lo, hi] = typeof range === "string" ? TONE_RANGE_PRESETS[range] : range;
-  const ramp = Math.max(1e-3, falloff);
+  const ramp2 = Math.max(1e-3, falloff);
   const out = new Uint8Array(n);
   const d = pixels.data;
   for (let i = 0; i < n; i++) {
@@ -3073,7 +3073,7 @@ function toneRange(pixels, range, falloff = 20) {
     if (d[p + 3] <= 0) continue;
     const l = Math.min(255, Math.max(0, 0.299 * d[p] + 0.587 * d[p + 1] + 0.114 * d[p + 2]));
     const outside = l < lo ? lo - l : l > hi ? l - hi : 0;
-    out[i] = coverageToByte(1 - outside / ramp);
+    out[i] = coverageToByte(1 - outside / ramp2);
   }
   return createSelectionMask(pixels.width, pixels.height, out);
 }
@@ -3102,6 +3102,111 @@ function hueRange(pixels, center) {
   }
   return createSelectionMask(pixels.width, pixels.height, out);
 }
+var HUE_RANGE_PRESETS = { reds: 0, yellows: 60, greens: 120, cyans: 180, blues: 240, magentas: 300 };
+var COLOR_RANGE_PRESETS = [
+  ...Object.keys(HUE_RANGE_PRESETS),
+  "highlights",
+  "midtones",
+  "shadows",
+  "skinTones"
+];
+function isColorRangePreset(v) {
+  return typeof v === "string" && COLOR_RANGE_PRESETS.includes(v);
+}
+var ramp = (v, lo, hi, soft) => v < lo ? Math.max(0, 1 - (lo - v) / soft) : v > hi ? Math.max(0, 1 - (v - hi) / soft) : 1;
+function skinToneRange(pixels) {
+  const n = checkPixels(pixels);
+  const out = new Uint8Array(n);
+  const d = pixels.data;
+  for (let i = 0; i < n; i++) {
+    const p = i * 4;
+    if (d[p + 3] <= 0) continue;
+    const r = d[p] / 255;
+    const g = d[p + 1] / 255;
+    const b = d[p + 2] / 255;
+    const mx = Math.max(r, g, b);
+    const mn = Math.min(r, g, b);
+    const chroma = mx - mn;
+    if (chroma <= 0 || mx <= 0) continue;
+    let hue;
+    if (mx === r) hue = ((g - b) / chroma % 6 + 6) % 6;
+    else if (mx === g) hue = (b - r) / chroma + 2;
+    else hue = (r - g) / chroma + 4;
+    hue *= 60;
+    if (hue > 180) hue -= 360;
+    const k = ramp(hue, 5, 40, 20) * ramp(chroma / mx, 0.12, 0.8, 0.1) * ramp(mx, 0.3, 1, 0.15);
+    out[i] = coverageToByte(k);
+  }
+  return createSelectionMask(pixels.width, pixels.height, out);
+}
+function colorRangePreset(pixels, preset, options = {}) {
+  if (preset === "skinTones") return skinToneRange(pixels);
+  if (preset === "highlights" || preset === "midtones" || preset === "shadows") return toneRange(pixels, preset, options.falloff ?? 20);
+  if (preset in HUE_RANGE_PRESETS) return hueRange(pixels, HUE_RANGE_PRESETS[preset]);
+  throw new Error(`Unknown Color Range preset "${String(preset)}". Use one of ${COLOR_RANGE_PRESETS.join(", ")}.`);
+}
+function selectedColorBins(pixels, sel, tolerance) {
+  const S = 64;
+  let bins = new Uint8Array(S * S * S);
+  const d = pixels.data;
+  const n = pixels.width * pixels.height;
+  for (let i = 0; i < n; i++) {
+    if (sel.data[i] < 128 || d[i * 4 + 3] === 0) continue;
+    bins[((d[i * 4] >> 2) * S + (d[i * 4 + 1] >> 2)) * S + (d[i * 4 + 2] >> 2)] = 1;
+  }
+  const r = Math.round(Math.max(0, tolerance) / 4);
+  if (r === 0) return bins;
+  for (const stride of [1, S, S * S]) {
+    const out = new Uint8Array(bins.length);
+    for (let i = 0; i < bins.length; i++) {
+      if (!bins[i]) continue;
+      const c = Math.floor(i / stride) % S;
+      const lo = Math.max(0, c - r);
+      const hi = Math.min(S - 1, c + r);
+      const base = i - c * stride;
+      for (let k = lo; k <= hi; k++) out[base + k * stride] = 1;
+    }
+    bins = out;
+  }
+  return bins;
+}
+function matcher(pixels, sel, options) {
+  if (sel.width !== pixels.width || sel.height !== pixels.height) throw new Error("The selection and the pixels differ in size");
+  const bins = selectedColorBins(pixels, sel, options.tolerance ?? 32);
+  const d = pixels.data;
+  return (i) => d[i * 4 + 3] > 0 && bins[((d[i * 4] >> 2 << 6) + (d[i * 4 + 1] >> 2)) * 64 + (d[i * 4 + 2] >> 2)] === 1;
+}
+function growSelection(pixels, sel, options = {}) {
+  checkPixels(pixels);
+  const match = matcher(pixels, sel, options);
+  const { width: w, height: h } = pixels;
+  const out = new Uint8Array(sel.data);
+  const stack = [];
+  for (let i = 0; i < out.length; i++) if (out[i] >= 128) stack.push(i);
+  while (stack.length) {
+    const i = stack.pop();
+    const x = i % w;
+    const y = (i - x) / w;
+    const visit = (j) => {
+      if (out[j] < 255 && match(j)) {
+        out[j] = 255;
+        stack.push(j);
+      }
+    };
+    if (x > 0) visit(i - 1);
+    if (x < w - 1) visit(i + 1);
+    if (y > 0) visit(i - w);
+    if (y < h - 1) visit(i + w);
+  }
+  return createSelectionMask(w, h, out);
+}
+function selectSimilar(pixels, sel, options = {}) {
+  const n = checkPixels(pixels);
+  const match = matcher(pixels, sel, options);
+  const out = new Uint8Array(sel.data);
+  for (let i = 0; i < n; i++) if (match(i)) out[i] = 255;
+  return createSelectionMask(pixels.width, pixels.height, out);
+}
 
 // src/image-editor/selection/segmentation.ts
 var isPoint = (p) => !!p && typeof p === "object" && Number.isFinite(p.x) && Number.isFinite(p.y);
@@ -3364,6 +3469,16 @@ function refineSelection(pixels, mask, params = {}) {
   return createSelectionMask(mask.width, mask.height, out);
 }
 
+// src/image-editor/selection/stroke.ts
+function selectionRing(sel, width, location) {
+  const half = location === "center" ? width / 2 : width;
+  const outer = location === "inside" ? sel : modifySelection(sel, "expand", half);
+  const inner = location === "outside" ? sel : modifySelection(sel, "contract", half);
+  const out = new Uint8Array(sel.data.length);
+  for (let i = 0; i < out.length; i++) out[i] = Math.max(0, outer.data[i] - inner.data[i]);
+  return createSelectionMask(sel.width, sel.height, out);
+}
+
 // src/image-editor/effect-layers.ts
 function hasLayersBelow(layers, id) {
   const all = flattenLayers(layers);
@@ -4274,6 +4389,7 @@ var IMAGE_EDITOR_SCHEMA_VERSION = LAYERED_SCHEMA_VERSION;
 var RETOUCH_TOOLS = ["clone", "heal", "spot-heal", "smudge", "dodge", "burn", "sponge", "blur", "sharpen", "history"];
 var isRetouchTool = (tool) => RETOUCH_TOOLS.includes(tool);
 var STROKE_TOOLS = ["brush", "eraser", "mixer", ...RETOUCH_TOOLS];
+var PASTE_MODES = ["new-layer", "in-place", "into", "outside"];
 function paintCoverageInto(base, coverage, apply, rects, depth = null) {
   const tiles = new Map(base.tiles);
   const done = /* @__PURE__ */ new Set();
@@ -4974,8 +5090,11 @@ var ImageEditorController = class {
     }
     const filter = normalizeSmartFilter({ kind: "effect", effect: d.id, provider: this.effects.require().id, name: d.name, values, enabled: options.enabled !== false, blend: options.blend, opacity: options.opacity });
     const res = addSmartFilter(layers, id, filter, this.canvasSize, options.index);
-    this.commitLayers(res.layers);
-    return { layerId: id, filter: res.filter, converted };
+    const masked = this.asOneStep(() => {
+      this.commitLayers(res.layers);
+      return this.maskFiltersWithSelection(id, options.useSelection);
+    });
+    return { layerId: id, filter: res.filter, converted, masked };
   }
   /**
    * Changes an effect smart filter: `values` merged over its own (`null` resets a control to the
@@ -5204,8 +5323,38 @@ var ImageEditorController = class {
       s.selectedAnnotationId = null;
     }
   }
+  /** Set while `asOneStep` runs: the step is already recorded, so nested commands add none. */
+  historyGrouped = false;
+  /**
+   * 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.
+   */
+  asOneStep(fn) {
+    if (this.historyGrouped || this.isApplyingHistory) return fn();
+    this.recordHistory();
+    const entry = this.undoStack[this.undoStack.length - 1];
+    this.historyGrouped = true;
+    try {
+      return fn();
+    } catch (err) {
+      if (this.undoStack[this.undoStack.length - 1] === entry) {
+        this.undoStack.pop();
+        this.isApplyingHistory = true;
+        try {
+          this.restoreHistoryEntry(entry);
+        } finally {
+          this.isApplyingHistory = false;
+        }
+        this.notify();
+      }
+      throw err;
+    } finally {
+      this.historyGrouped = false;
+    }
+  }
   recordHistory() {
-    if (this.isApplyingHistory) return;
+    if (this.isApplyingHistory || this.historyGrouped) return;
     this.docRevision++;
     this.undoStack.push(this.captureHistoryEntry());
     if (this.undoStack.length > this.maxHistoryDepth) {
@@ -5851,16 +6000,23 @@ var ImageEditorController = class {
     return { offset: { x: Math.round(x), y: Math.round(y) }, bounds: this.getLayerBounds(id) };
   }
   /**
-   * 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, from = "reveal-all", props = {}) {
     const layer = requireLayer(this.state.layers, id).layer;
     let mask;
-    if (from === "selection") {
-      const sel = this.state.selection;
-      if (!sel?.bounds) throw new LayerOperationError("Nothing is selected; select first, or use reveal-all / hide-all.");
+    if (from === "selection" || from === "hide-selection" || from === "transparency") {
+      let sel;
+      if (from === "transparency") {
+        sel = this.layerTransparency(id);
+      } else {
+        const current = this.state.selection;
+        if (!current?.bounds) throw new LayerOperationError("Nothing is selected; select first, or use reveal-all / hide-all / transparency.");
+        sel = from === "hide-selection" ? invertSelection(current) : current;
+      }
       mask = this.maskFromSelection(sel, props);
       if (layer.type === "pixel" && (layer.offset.x || layer.offset.y)) {
         mask = { ...mask, surface: translateSurface(mask.surface, -layer.offset.x, -layer.offset.y) };
@@ -6314,10 +6470,22 @@ var ImageEditorController = class {
     return res.layer.id;
   }
   /** Adds a smart filter (`develop` or `blur`, with `blend` and `opacity`) at `index` (default the top), as one undo step. */
-  addSmartFilter(id, filter, index) {
+  addSmartFilter(id, filter, index, options = {}) {
     const res = addSmartFilter(this.state.layers, id, normalizeSmartFilter(filter), this.canvasSize, index);
-    this.commitLayers(res.layers);
-    return res.filter;
+    return this.asOneStep(() => {
+      this.commitLayers(res.layers);
+      this.maskFiltersWithSelection(id, options.useSelection);
+      return res.filter;
+    });
+  }
+  /**
+   * 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.
+   */
+  maskFiltersWithSelection(id, useSelection) {
+    if (!useSelection || !this.state.selection?.bounds) return false;
+    this.setSmartFilterMask(id, "selection", {}, false);
+    return true;
   }
   /** Changes one smart filter (one undo step, or none with `commitToHistory = false` during a drag). */
   updateSmartFilter(id, filterId, changes, commitToHistory = true) {
@@ -7145,13 +7313,176 @@ var ImageEditorController = class {
   clearPixels(options = {}) {
     return this.fillOrClear(options, "erase");
   }
-  fillOrClear(options, mode) {
-    const target = this.paintTarget(options.layerId, options.channel, mode === "paint" ? "fill" : "clear");
+  /**
+   * 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) {
+    const sel = this.state.selection;
+    if (!sel?.bounds) throw new LayerOperationError("Nothing is selected; select first, then stroke the selection.");
+    const width = options.width;
+    if (!(width > 0 && width <= 250)) throw new LayerOperationError("width must be greater than 0 and at most 250 px.");
+    const location = options.location ?? "outside";
+    if (location !== "inside" && location !== "center" && location !== "outside") {
+      throw new LayerOperationError(`Unknown location "${String(location)}"; use inside, center or outside.`);
+    }
+    const ring = selectionRing(sel, width, location);
+    if (!ring.bounds) return { layerId: options.layerId ?? this.state.activeLayerId ?? "", channel: "pixels", bounds: null, dabs: 0 };
+    return this.fillOrClear(options, "paint", ring);
+  }
+  /**
+   * Image › Crop to the selection's bounds (one undo step). Returns the crop box (natural
+   * pixels). Throws without a selection.
+   */
+  cropToSelection() {
+    const sel = this.state.selection;
+    if (!sel?.bounds) throw new LayerOperationError("Nothing is selected; select the area to keep, then crop to it.");
+    const crop = { ...sel.bounds };
+    this.setCrop(crop);
+    return crop;
+  }
+  /**
+   * 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 = {}) {
+    const sel = this.state.selection;
+    if (!sel?.bounds) throw new LayerOperationError("Nothing is selected; select what to remove, then fill it.");
+    if (this.bitDepth !== 8) throw new LayerOperationError("Content-Aware Fill works on 8-bit documents for now; set_bit_depth 8 first, or use spot_heal.");
+    const output = options.output ?? "current";
+    if (output !== "current" && output !== "new-layer") throw new LayerOperationError(`Unknown output "${String(output)}"; use current or new-layer.`);
+    const target = this.paintTarget(options.layerId, "pixels", "fill");
+    const { width, height } = this.naturalSize;
+    const b = sel.bounds;
+    const margin = Math.max(32, Math.round(options.sampleRadius ?? Math.max(b.width, b.height)));
+    const x0 = Math.max(0, b.x - margin);
+    const y0 = Math.max(0, b.y - margin);
+    const win = { x: x0, y: y0, width: Math.min(width, b.x + b.width + margin) - x0, height: Math.min(height, b.y + b.height + margin) - y0 };
+    if (win.width * win.height > 16e6) throw new LayerOperationError("The area to fill and sample is too large (over 16 MP); fill a smaller selection or lower sampleRadius.");
+    const layerRect = { x: win.x - target.offset.x, y: win.y - target.offset.y, width: win.width, height: win.height };
+    const before = readRegion(target.surface, layerRect);
+    const img = new Float32Array(before.length);
+    for (let i = 0; i < before.length; i++) img[i] = before[i];
+    const coverage = new Float32Array(win.width * win.height);
+    const hole = new Uint8Array(win.width * win.height);
+    for (let y = 0; y < win.height; y++) {
+      for (let x = 0; x < win.width; x++) {
+        const c = sel.data[(win.y + y) * sel.width + win.x + x] / 255;
+        coverage[y * win.width + x] = c;
+        hole[y * win.width + x] = c > 0 ? 1 : 0;
+      }
+    }
+    const filled = contentAwareFill(win.width, win.height, 4, img, hole, { seed: options.seed ?? 0 });
+    const out = new Uint8ClampedArray(before.length);
+    for (let i = 0; i < coverage.length; i++) {
+      const k = coverage[i];
+      for (let c = 0; c < 4; c++) {
+        const p = i * 4 + c;
+        out[p] = output === "new-layer" ? c === 3 ? Math.round(filled[p] * k) : filled[p] : before[p] + (filled[p] - before[p]) * k;
+      }
+    }
+    if (output === "new-layer") {
+      const crop = { x: b.x - win.x, y: b.y - win.y, width: b.width, height: b.height };
+      const data = new Uint8ClampedArray(b.width * b.height * 4);
+      for (let y = 0; y < b.height; y++) data.set(out.subarray(((crop.y + y) * win.width + crop.x) * 4, ((crop.y + y) * win.width + crop.x + b.width) * 4), y * b.width * 4);
+      const id = this.addPixelLayer({ name: "Content-Aware Fill", pixels: { width: b.width, height: b.height, data }, x: b.x, y: b.y, aboveId: target.id });
+      return { layerId: id, bounds: { ...b }, output };
+    }
+    const surface = writeRegion(target.surface, layerRect, out);
+    this.commitLayers(mapLayer(this.state.layers, target.id, (l) => this.withSurface(l, "pixels", surface)));
+    return { layerId: target.id, bounds: { ...b }, output };
+  }
+  /** The pixel clipboard (Copy / Cut), or null. */
+  clipboard = null;
+  /** What Copy or Cut last put on the editor's clipboard, or null. */
+  getClipboard() {
+    return this.clipboard;
+  }
+  /** Puts pixels on the editor's clipboard (e.g. an image pasted from the system clipboard). */
+  setClipboard(image) {
+    if (image && (image.data.length !== image.width * image.height * 4 || image.width < 1 || image.height < 1)) {
+      throw new LayerOperationError("Clipboard pixels must be RGBA with width \xD7 height \xD7 4 bytes.");
+    }
+    this.clipboard = image;
+  }
+  /**
+   * 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 = {}) {
+    const { width, height } = this.naturalSize;
+    const sel = this.state.selection?.bounds ? this.state.selection : null;
+    const rect = sel?.bounds ?? { x: 0, y: 0, width, height };
+    let data;
+    if (options.merged) {
+      data = new Uint8ClampedArray(this.compositePixels(rect).data);
+    } else {
+      const id = options.layerId ?? this.state.activeLayerId;
+      if (!id) throw new LayerOperationError("No layer given and none is active; pass layerId, or merged: true to copy the visible image.");
+      const layer = requireLayer(this.state.layers, id).layer;
+      if (layer.type !== "pixel") throw new LayerOperationError(`Layer "${layer.name || id}" is not a pixel layer; copy merged, or rasterize it first.`);
+      data = readRegion(this.surfaceOf(layer), { x: rect.x - layer.offset.x, y: rect.y - layer.offset.y, width: rect.width, height: rect.height });
+    }
+    if (sel) {
+      for (let y = 0; y < rect.height; y++) {
+        for (let x = 0; x < rect.width; x++) {
+          const k = sel.data[(rect.y + y) * sel.width + rect.x + x];
+          const p = (y * rect.width + x) * 4 + 3;
+          data[p] = Math.round(data[p] * k / 255);
+        }
+      }
+    }
+    this.clipboard = { width: rect.width, height: rect.height, x: rect.x, y: rect.y, data };
+    return this.clipboard;
+  }
+  /** Edit › Cut: Copy, then clear the selected pixels, as one undo step. */
+  cutPixels(options = {}) {
+    return this.asOneStep(() => {
+      const clip = this.copyPixels({ layerId: options.layerId });
+      this.clearPixels({ layerId: options.layerId, channel: "pixels" });
+      return clip;
+    });
+  }
+  /**
+   * 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 = "new-layer", image = this.clipboard) {
+    if (!image) throw new LayerOperationError("The clipboard is empty; copy_pixels first.");
+    if (!PASTE_MODES.includes(mode)) throw new LayerOperationError(`Unknown paste mode "${String(mode)}"; use ${PASTE_MODES.join(", ")}.`);
+    const sel = this.state.selection?.bounds ? this.state.selection : null;
+    if ((mode === "into" || mode === "outside") && !sel) throw new LayerOperationError(`Paste ${mode === "into" ? "Into" : "Outside"} needs a selection; select where it goes first.`);
+    const { width, height } = this.naturalSize;
+    let x;
+    let y;
+    if (mode === "in-place" && image.x !== void 0 && image.y !== void 0) {
+      x = image.x;
+      y = image.y;
+    } else {
+      const frame = sel?.bounds ?? { x: 0, y: 0, width, height };
+      x = Math.round(frame.x + (frame.width - image.width) / 2);
+      y = Math.round(frame.y + (frame.height - image.height) / 2);
+    }
+    return this.asOneStep(() => {
+      const id = this.addPixelLayer({ name: "Pasted", pixels: { width: image.width, height: image.height, data: new Uint8ClampedArray(image.data) }, x, y });
+      if (mode === "into" || mode === "outside") this.addLayerMask(id, mode === "into" ? "selection" : "hide-selection");
+      return { layerId: id, bounds: { x, y, width: image.width, height: image.height }, masked: mode === "into" || mode === "outside" };
+    });
+  }
+  fillOrClear(options, mode, coverageMask) {
+    const target = this.paintTarget(options.layerId, options.channel, mode === "paint" ? coverageMask ? "stroke" : "fill" : "clear");
     const { width, height } = this.naturalSize;
     const opacity = options.opacity ?? 1;
     if (!(opacity >= 0 && opacity <= 1)) throw new LayerOperationError("opacity must be from 0 to 1.");
     const blend = parseBlend(options.blend) ?? "normal";
-    const sel = options.useSelection !== false && this.state.selection?.bounds ? this.state.selection : null;
+    const sel = coverageMask ?? (options.useSelection !== false && this.state.selection?.bounds ? this.state.selection : null);
     const region = sel?.bounds ?? { x: 0, y: 0, width, height };
     const coverage = new CoverageMap();
     const ones = new Float32Array(region.width * region.height);
@@ -7325,7 +7656,7 @@ var ImageEditorController = class {
       enabled: spec.enabled,
       opacity: spec.opacity,
       blend: spec.blend,
-      mask: spec.mask ?? void 0
+      mask: spec.mask ?? (spec.useSelection && this.state.selection?.bounds ? layerMaskFromSelection(this.state.selection) : void 0)
     });
     while (ids.has(layer.id)) layer.id = newLayerId("adj");
     const { width, height } = this.naturalSize;
@@ -7535,6 +7866,7 @@ var ImageEditorController = class {
     const prev = normalizeSelection(this.state.selection ?? null);
     if (prev === next || prev && next && sameSelection(prev, next)) return false;
     this.recordHistory();
+    if (!next && prev?.bounds) this.lastSelection = prev;
     this.state.selection = next;
     this.notify();
     return true;
@@ -7548,6 +7880,74 @@ var ImageEditorController = class {
   deselect() {
     return this.setSelection(null);
   }
+  /** The selection a Deselect cleared, for `reselect` (not saved, not part of history). */
+  lastSelection = null;
+  /** Whether `reselect` has a selection to bring back. */
+  canReselect() {
+    const { width, height } = this.naturalSize;
+    return Boolean(this.lastSelection && this.lastSelection.width === width && this.lastSelection.height === height);
+  }
+  /** Select › Reselect: brings back the last selection a Deselect cleared, as one undo step. */
+  reselect() {
+    if (!this.canReselect()) return false;
+    return this.setSelection(this.lastSelection);
+  }
+  /**
+   * 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, position, options = {}) {
+    const { width, height } = this.naturalSize;
+    const max = orientation === "row" ? height : width;
+    const at = Math.floor(position);
+    if (!Number.isFinite(position) || at < 0 || at >= max) {
+      throw new RangeError(`${orientation === "row" ? "y" : "x"} ${position} is outside the image (0..${max - 1}).`);
+    }
+    const rect = orientation === "row" ? { x: 0, y: at, width, height: 1 } : { x: at, y: 0, width: 1, height };
+    return this.shapeCommand(rectSelection(width, height, rect, { antiAlias: false }), options);
+  }
+  /** Select › Grow: adds connected pixels within `tolerance` of a selected colour (one undo step). */
+  async growSelection(options = {}) {
+    const sel = this.state.selection;
+    if (!sel?.bounds) return false;
+    const pixels = await this.requirePixels(options);
+    return this.setSelection(growSelection(pixels, sel, options));
+  }
+  /** Select › Similar: adds every pixel within `tolerance` of a selected colour (one undo step). */
+  async selectSimilar(options = {}) {
+    const sel = this.state.selection;
+    if (!sel?.bounds) return false;
+    const pixels = await this.requirePixels(options);
+    return this.setSelection(selectSimilar(pixels, sel, options));
+  }
+  /**
+   * 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, options = {}) {
+    const mask = this.layerTransparency(id);
+    return this.shapeCommand(mask, options);
+  }
+  layerTransparency(id) {
+    const layer = requireLayer(this.state.layers, id).layer;
+    if (!hasSurface(layer)) {
+      throw new LayerOperationError(`Layer "${layer.name || id}" has no pixels of its own; only pixel, shape, type and smart object layers do.`);
+    }
+    const { width, height } = this.naturalSize;
+    const out = new Uint8Array(width * height);
+    const pixels = this.getLayerPixels(id);
+    if (!pixels) return createSelectionMask(width, height, out);
+    for (let y = 0; y < pixels.height; y++) {
+      const dy = y + pixels.y;
+      if (dy < 0 || dy >= height) continue;
+      for (let x = 0; x < pixels.width; x++) {
+        const dx = x + pixels.x;
+        if (dx < 0 || dx >= width) continue;
+        out[dy * width + dx] = pixels.data[(y * pixels.width + x) * 4 + 3];
+      }
+    }
+    return createSelectionMask(width, height, out);
+  }
   /** Select › Inverse (with nothing selected, selects everything). */
   invertSelection() {
     const { width, height } = this.naturalSize;
@@ -7555,7 +7955,8 @@ var ImageEditorController = class {
     return this.setSelection(invertSelection(current));
   }
   shapeCommand(mask, options) {
-    const shaped = options.feather && options.feather > 0 ? modifySelection(mask, "feather", options.feather) : mask;
+    const feathered = options.feather && options.feather > 0 ? modifySelection(mask, "feather", options.feather) : mask;
+    const shaped = options.invert ? invertSelection(feathered) : feathered;
     return this.setSelection(shaped, options.mode ?? "replace");
   }
   /** Rectangular marquee in natural image pixels. */
@@ -7657,6 +8058,15 @@ var ImageEditorController = class {
     this.shapeCommand(colorRange(pixels, samples, options), options);
     return this.getSelection();
   }
+  /**
+   * Select › Color Range with a preset: `reds` … `magentas`, `highlights` / `midtones` /
+   * `shadows` (with `falloff` levels, default 20) or `skinTones`. One undo step.
+   */
+  async selectColorRangePreset(preset, options = {}) {
+    const pixels = await this.requirePixels(options);
+    this.shapeCommand(colorRangePreset(pixels, preset, options), options);
+    return this.getSelection();
+  }
   /** Select › Modify: grow, shrink, feather, border or smooth by `radius` pixels (one undo step). */
   modifySelection(op, radius) {
     const sel = this.state.selection;
@@ -7733,8 +8143,23 @@ var ImageEditorController = class {
   }
   /** Quick Mask view (tints the unselected area). View state: no undo step. */
   setQuickMask(on) {
-    if (Boolean(this.state.quickMask) === on) return;
-    this.state.quickMask = on;
+    this.setSelectionDisplay(on ? "quickMask" : "ants");
+  }
+  /** How the canvas shows the selection (`state.selectionDisplay`). */
+  getSelectionDisplay() {
+    return this.state.selectionDisplay ?? (this.state.quickMask ? "quickMask" : "ants");
+  }
+  /**
+   * 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) {
+    if (display !== "ants" && display !== "quickMask" && display !== "none") {
+      throw new Error(`Unknown selection display "${String(display)}". Use ants, quickMask or none.`);
+    }
+    if (this.getSelectionDisplay() === display) return;
+    this.state.selectionDisplay = display;
+    this.state.quickMask = display === "quickMask";
     this.notify();
   }
   // --- Layer masks ---
@@ -7778,8 +8203,11 @@ var ImageEditorController = class {
     if (!layer || layer.type !== "adjustment" || !layer.mask) return false;
     return this.setLayerMask(layerId, withMaskProps(layer.mask, props), commitToHistory);
   }
-  /** Load Selection from a layer mask (its pixels; density and feather are not applied). */
-  selectionFromLayerMask(layerId, mode = "replace") {
+  /**
+   * 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, mode = "replace", invert2 = false) {
     const layer = this.getLayer(layerId);
     if (!layer?.mask || layer.mask.source) return false;
     const { width, height } = this.naturalSize;
@@ -7787,7 +8215,7 @@ var ImageEditorController = class {
     const oy = layer.type === "pixel" ? layer.offset.y : 0;
     const data = readRegion(layer.mask.surface, { x: -ox, y: -oy, width, height });
     const sel = createSelectionMask(width, height, new Uint8Array(data.buffer, data.byteOffset, data.length));
-    return this.setSelection(sel, mode);
+    return this.setSelection(invert2 ? invertSelection(sel) : sel, mode);
   }
   // --- Histogram ---
   /**
@@ -10121,9 +10549,9 @@ var DEPTH_MASK_CONTROLS = [
 // src/image-editor/playback.ts
 var IMAGE_PLAYBACK_KIND = "layer";
 var PAINT = /^(paint_stroke|clone_stamp|heal_brush|spot_heal|dodge|burn|sponge|smudge|blur_stroke|sharpen_stroke|history_brush|set_clone_source|set_clone_transform|fill_pixels|clear_pixels|set_paint|set_retouch_options|load_mixer_brush|clean_mixer_brush)$/;
-var SELECT = /^(select_region|select_subject|select_by_color|modify_selection|refine_selection|transform_selection|apply_selection_as_mask|layer_via_copy)$/;
+var SELECT = /^(select_region|select_subject|select_by_color|select_all|deselect|invert_selection|select_rect|select_ellipse|select_polygon|select_line|magic_wand|grow_selection|select_similar|reselect|select_layer_transparency|select_color_range|load_selection_from_image|load_selection_from_mask|set_selection_display|modify_selection|refine_selection|transform_selection|apply_selection_as_mask|layer_via_copy|stroke_selection|content_aware_fill|copy_pixels|cut_pixels|paste_pixels)$/;
 var ANNOTATE = /^(add_shape_layer|update_shape|add_shape_component|set_shape_component|remove_shape_component|merge_shape_components|add_text_layer|set_text|set_text_style|set_paragraph_style|set_text_frame|convert_text_to_shape)$/;
-var CROP = /^(set_crop|reset_crop|set_rotation|flip_image|transform_layer|warp_layer|flip_layer|offset_layer)$/;
+var CROP = /^(set_crop|crop_to_selection|reset_crop|set_rotation|flip_image|transform_layer|warp_layer|flip_layer|offset_layer)$/;
 var ADJUST = /^(set_adjustments|add_adjustment_layer|update_adjustment_layer|remove_adjustment_layer|move_adjustment_layer)$/;
 function imagePlaybackPanel(tool) {
   if (ADJUST.test(tool)) return "adjust";
@@ -10238,8 +10666,24 @@ var SELECTION_TOOLS = [
   { id: "wand", label: "Magic Wand" },
   { id: "rect", label: "Rectangle" },
   { id: "ellipse", label: "Ellipse" },
-  { id: "lasso", label: "Lasso" }
+  { id: "row", label: "Single Row" },
+  { id: "column", label: "Single Column" },
+  { id: "lasso", label: "Lasso" },
+  { id: "polygon", label: "Polygonal Lasso" },
+  { id: "range", label: "Color Range" }
 ];
+var COLOR_RANGE_PRESET_LABELS = {
+  reds: "Reds",
+  yellows: "Yellows",
+  greens: "Greens",
+  cyans: "Cyans",
+  blues: "Blues",
+  magentas: "Magentas",
+  highlights: "Highlights",
+  midtones: "Midtones",
+  shadows: "Shadows",
+  skinTones: "Skin Tones"
+};
 var SELECTION_MODE_LABELS = {
   replace: "New",
   add: "Add",
@@ -10253,7 +10697,11 @@ var DEFAULT_SELECTION_TOOL_OPTIONS = {
   contiguous: true,
   antiAlias: true,
   sampleMerged: false,
-  distance: "rgb"
+  distance: "rgb",
+  feather: 0,
+  fuzziness: 40,
+  localized: 0,
+  rangeInvert: false
 };
 function selectionModeFromModifiers(modifiers, fallback) {
   if (modifiers.shiftKey && modifiers.altKey) return "intersect";
@@ -10284,6 +10732,41 @@ var modeSchema = {
   description: "How the result combines with the current selection (default replace)."
 };
 var num2 = (v, d) => typeof v === "number" && Number.isFinite(v) ? v : d;
+var featherSchema = { type: "number", minimum: 0, maximum: 1e3, description: "Feather the new shape by this many pixels before combining (default 0)." };
+var antiAliasSchema = { type: "boolean", description: "Soft one-pixel edge (default true)." };
+var sampleMergedSchema = { type: "boolean", description: "Sample the adjusted image (adjustment layers and filters applied) rather than the pixels as painted (default false)." };
+var sampleSchema = {
+  type: "string",
+  enum: ["composite", "active-layer"],
+  description: "composite (default): all layers; active-layer: only the active pixel layer (see set_active_layer)."
+};
+var pointSchema = {
+  type: "object",
+  properties: { x: { type: "number", description: "x in natural image pixels." }, y: { type: "number", description: "y in natural image pixels." } },
+  required: ["x", "y"],
+  additionalProperties: false
+};
+var rectProperties = {
+  x: { type: "number", description: "Left edge in natural image pixels." },
+  y: { type: "number", description: "Top edge in natural image pixels." },
+  width: { type: "number", exclusiveMinimum: 0, description: "Width in natural image pixels." },
+  height: { type: "number", exclusiveMinimum: 0, description: "Height in natural image pixels." }
+};
+function shapeOptions(args) {
+  return { mode: parseSelectionMode(args.mode), feather: num2(args.feather, 0), antiAlias: args.antiAlias !== false };
+}
+function sampleOptions(args) {
+  if (args.sample !== void 0 && args.sample !== "composite" && args.sample !== "active-layer") {
+    throw new Error(`Unknown sample "${String(args.sample)}". Use composite or active-layer.`);
+  }
+  return { sampleMerged: args.sampleMerged === true, sample: args.sample ?? "composite" };
+}
+function rectOf(args) {
+  const rect = { x: num2(args.x, NaN), y: num2(args.y, NaN), width: num2(args.width, NaN), height: num2(args.height, NaN) };
+  if (![rect.x, rect.y, rect.width, rect.height].every(Number.isFinite)) throw new Error("Pass numeric x, y, width and height in natural image pixels.");
+  if (rect.width <= 0 || rect.height <= 0) throw new Error("width and height must be greater than 0.");
+  return rect;
+}
 function summary(controller) {
   const sel = controller.getSelection();
   const { width, height } = controller.getState().imageDimensions;
@@ -10316,7 +10799,7 @@ function createImageSelectionTools(controller) {
   const selectRegion = {
     name: "select_region",
     title: "Select a region",
-    description: 'Selects a rectangle or ellipse (x, y, width, height in natural image pixels), a polygon (the lasso: points along an outline, closed automatically), everything ("all"), nothing ("none") or the inverse of the current selection ("invert"). To cut out a subject, trace its contour with polygon (then refine_selection for soft edges such as fur or foliage) rather than selecting its bounding box. One undoable step.',
+    description: 'Deprecated: use select_rect, select_ellipse, select_polygon, select_all, deselect or invert_selection (this alias goes in the next minor release). Selects a rectangle or ellipse (x, y, width, height in natural image pixels), a polygon (the lasso: points along an outline, closed automatically), everything ("all"), nothing ("none") or the inverse of the current selection ("invert"). To cut out a subject, trace its contour with polygon (then refine_selection for soft edges such as fur or foliage) rather than selecting its bounding box. One undoable step.',
     inputSchema: {
       type: "object",
       properties: {
@@ -10382,7 +10865,7 @@ function createImageSelectionTools(controller) {
   const selectByColor = {
     name: "select_by_color",
     title: "Select by colour",
-    description: 'Magic wand at (x, y) with tolerance (0-255) and contiguous, or with "color" ("#rrggbb") every pixel of a similar colour (Color Range, fuzziness 0-200). One undoable step.',
+    description: 'Deprecated: use magic_wand or select_color_range (this alias goes in the next minor release). Magic wand at (x, y) with tolerance (0-255) and contiguous, or with "color" ("#rrggbb") every pixel of a similar colour (Color Range, fuzziness 0-200). One undoable step.',
     inputSchema: {
       type: "object",
       properties: {
@@ -10422,7 +10905,7 @@ function createImageSelectionTools(controller) {
   const modify = {
     name: "modify_selection",
     title: "Modify the selection",
-    description: "Select \u203A Modify: grow, shrink, feather, border or smooth the selection by radius pixels. One undoable step.",
+    description: "Select \u203A Modify: expand, contract, feather, border or smooth the selection by radius pixels (grow and shrink are older names for expand and contract). Expand and contract move the edge by distance; to add pixels of similar colour use grow_selection or select_similar. One undoable step.",
     inputSchema: {
       type: "object",
       properties: {
@@ -10512,7 +10995,499 @@ function createImageSelectionTools(controller) {
       return { layerId: id, kind: layer.kind, mask, selection: summary(controller) };
     }
   };
-  return [getSelection, selectRegion, selectByColor, modify, refine, applyMask];
+  const selectAll = {
+    name: "select_all",
+    title: "Select all",
+    description: "Select \u203A All: selects the whole image. One undoable step. Returns the selection.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    annotations: writeAnnotations("Select all", true),
+    handler: () => {
+      controller.selectAll();
+      return summary(controller);
+    }
+  };
+  const deselect = {
+    name: "deselect",
+    title: "Deselect",
+    description: "Select \u203A Deselect: clears the selection, so later edits apply to the whole layer. One undoable step. Returns the (empty) selection.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    annotations: writeAnnotations("Deselect", true),
+    handler: () => {
+      controller.deselect();
+      return summary(controller);
+    }
+  };
+  const invert2 = {
+    name: "invert_selection",
+    title: "Invert the selection",
+    description: "Select \u203A Inverse: selects what was not selected (soft edges stay soft). With nothing selected, selects everything. One undoable step. Returns the selection.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    annotations: writeAnnotations("Invert the selection"),
+    handler: () => {
+      controller.invertSelection();
+      return summary(controller);
+    }
+  };
+  const selectRect = {
+    name: "select_rect",
+    title: "Select a rectangle",
+    description: "Rectangular Marquee: selects x, y, width, height (natural image pixels), combined with the selection by mode. Use it for geometric areas (a frame, a screen, a strip along an edge); for a subject, trace its outline with select_polygon or use select_subject. One undoable step. Returns the selection.",
+    inputSchema: {
+      type: "object",
+      properties: { ...rectProperties, mode: modeSchema, feather: featherSchema, antiAlias: antiAliasSchema },
+      required: ["x", "y", "width", "height"],
+      additionalProperties: false
+    },
+    annotations: writeAnnotations("Select a rectangle", true),
+    handler: (args) => {
+      controller.selectRect(rectOf(args), shapeOptions(args));
+      return summary(controller);
+    }
+  };
+  const selectEllipse = {
+    name: "select_ellipse",
+    title: "Select an ellipse",
+    description: "Elliptical Marquee: selects the ellipse inscribed in x, y, width, height (natural image pixels), combined by mode. Use feather for a vignette. One undoable step. Returns the selection.",
+    inputSchema: {
+      type: "object",
+      properties: { ...rectProperties, mode: modeSchema, feather: featherSchema, antiAlias: antiAliasSchema },
+      required: ["x", "y", "width", "height"],
+      additionalProperties: false
+    },
+    annotations: writeAnnotations("Select an ellipse", true),
+    handler: (args) => {
+      controller.selectEllipse(rectOf(args), shapeOptions(args));
+      return summary(controller);
+    }
+  };
+  const selectPolygonTool = {
+    name: "select_polygon",
+    title: "Select a polygon (lasso)",
+    description: "Lasso: selects the polygon through points (natural image pixels, in order along the outline, closed automatically), combined by mode. To cut out a subject, follow its contour closely (more points give a tighter edge), then refine_selection for hair or foliage. One undoable step. Returns the selection.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        points: { type: "array", minItems: 3, items: pointSchema, description: "At least 3 vertices along the outline, in order, in natural image pixels." },
+        mode: modeSchema,
+        feather: featherSchema,
+        antiAlias: antiAliasSchema
+      },
+      required: ["points"],
+      additionalProperties: false
+    },
+    annotations: writeAnnotations("Select a polygon (lasso)", true),
+    handler: (args) => {
+      const list = Array.isArray(args.points) ? args.points.map((p) => ({ x: num2(p?.x, NaN), y: num2(p?.y, NaN) })) : [];
+      if (list.length < 3 || !list.every((p) => Number.isFinite(p.x) && Number.isFinite(p.y))) {
+        throw new Error("points needs at least 3 { x, y } vertices in natural image pixels.");
+      }
+      controller.selectPolygon(list, shapeOptions(args));
+      return summary(controller);
+    }
+  };
+  const magicWandTool = {
+    name: "magic_wand",
+    title: "Magic wand",
+    description: "Magic Wand: selects pixels similar in colour to the one at (x, y). tolerance 0..255 (default 32) is the largest channel difference (rgb) or \u0394E scaled so 255 \u2248 \u0394E 100 (perceptual, closer to how colours look); contiguous (default true) keeps only the region connected to the seed. Best on flat backdrops and solid colours; check percent with get_selection before using it. One undoable step. Returns the selection.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        x: { type: "number", description: "Seed x in natural image pixels." },
+        y: { type: "number", description: "Seed y in natural image pixels." },
+        tolerance: { type: "number", minimum: 0, maximum: 255, description: "Colour tolerance 0..255 (default 32)." },
+        contiguous: { type: "boolean", description: "Only the region connected to the seed (default true); false selects every similar pixel." },
+        distance: { type: "string", enum: ["rgb", "perceptual"], description: "How colour difference is measured: rgb (default, as Photoshop) or perceptual (CIE \u0394E)." },
+        antiAlias: antiAliasSchema,
+        sampleMerged: sampleMergedSchema,
+        sample: sampleSchema,
+        mode: modeSchema,
+        feather: featherSchema
+      },
+      required: ["x", "y"],
+      additionalProperties: false
+    },
+    annotations: writeAnnotations("Magic wand", true),
+    handler: async (args) => {
+      const x = num2(args.x, NaN);
+      const y = num2(args.y, NaN);
+      if (!Number.isFinite(x) || !Number.isFinite(y)) throw new Error("Pass the seed point x and y in natural image pixels.");
+      const { width, height } = controller.getState().imageDimensions;
+      if (x < 0 || y < 0 || x >= width || y >= height) throw new Error(`(${x}, ${y}) is outside the image (0..${width - 1}, 0..${height - 1}).`);
+      if (args.distance !== void 0 && args.distance !== "rgb" && args.distance !== "perceptual") {
+        throw new Error(`Unknown distance "${String(args.distance)}". Use rgb or perceptual.`);
+      }
+      await controller.magicWand(
+        { x, y },
+        {
+          ...shapeOptions(args),
+          ...sampleOptions(args),
+          tolerance: Math.min(255, Math.max(0, num2(args.tolerance, 32))),
+          contiguous: args.contiguous !== false,
+          distance: args.distance ?? "rgb"
+        }
+      );
+      return summary(controller);
+    }
+  };
+  const colorRangeTool = {
+    name: "select_color_range",
+    title: "Select a colour range",
+    description: "Select \u203A Color Range: selects every pixel matching samples (colours, each optionally at the x, y where it was picked) or a preset (reds \u2026 magentas, highlights, midtones, shadows, skinTones), softly: coverage falls off with colour distance over fuzziness levels. localized limits each positioned sample to a radius. invert selects everything else. Pass samples or preset, not both. One undoable step. Returns the selection.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        samples: {
+          type: "array",
+          minItems: 1,
+          maxItems: 32,
+          items: {
+            type: "object",
+            properties: {
+              color: { type: "string", pattern: "^#?[0-9a-fA-F]{6}$", description: "The sampled colour, #rrggbb." },
+              x: { type: "number", description: "Where it was picked (natural image pixels), for localized." },
+              y: { type: "number", description: "Where it was picked (natural image pixels), for localized." }
+            },
+            required: ["color"],
+            additionalProperties: false
+          },
+          description: "Colours to select (the + eyedropper adds one). Read colours from capture_view or a seed pixel."
+        },
+        preset: { type: "string", enum: [...COLOR_RANGE_PRESETS], description: "A preset range instead of samples." },
+        fuzziness: {
+          type: "number",
+          minimum: 0,
+          maximum: 200,
+          description: "Colour samples: levels over which coverage fades to 0 (default 40). Tone presets: falloff in levels around the range (default 20). Ignored by colour and skin presets."
+        },
+        localized: { type: "number", exclusiveMinimum: 0, description: "Localized Color Clusters: positioned samples fade to 0 at this many pixels from where they were picked (default off)." },
+        invert: { type: "boolean", description: "Select everything except the range (default false)." },
+        sampleMerged: sampleMergedSchema,
+        sample: sampleSchema,
+        mode: modeSchema,
+        feather: featherSchema
+      },
+      additionalProperties: false
+    },
+    annotations: writeAnnotations("Select a colour range", true),
+    handler: async (args) => {
+      const hasSamples = Array.isArray(args.samples) && args.samples.length > 0;
+      if (hasSamples === (args.preset !== void 0)) throw new Error("Pass samples (colours to match) or preset, not both.");
+      const common = { ...sampleOptions(args), mode: parseSelectionMode(args.mode), feather: num2(args.feather, 0), invert: args.invert === true };
+      if (!hasSamples) {
+        if (!isColorRangePreset(args.preset)) throw new Error(`Unknown preset "${String(args.preset)}". Use one of ${COLOR_RANGE_PRESETS.join(", ")}.`);
+        await controller.selectColorRangePreset(args.preset, { ...common, falloff: num2(args.fuzziness, 20) });
+      } else {
+        const samples = args.samples.map((s, i) => {
+          if (typeof s?.color !== "string" || !/^#?[0-9a-f]{6}$/i.test(s.color.trim())) throw new Error(`samples[${i}].color must be #rrggbb.`);
+          const at = typeof s.x === "number" && typeof s.y === "number" ? { x: s.x, y: s.y } : void 0;
+          return at ? { color: s.color, at } : { color: s.color };
+        });
+        const localized = typeof args.localized === "number" && args.localized > 0 ? args.localized : void 0;
+        await controller.selectColorRange(samples, { ...common, fuzziness: num2(args.fuzziness, 40), localized });
+      }
+      return summary(controller);
+    }
+  };
+  const loadFromImage = {
+    name: "load_selection_from_image",
+    title: "Load a selection from a mask image",
+    description: "Loads a selection from a mask image (an AI segmentation, a saved matte): white = selected by luminance, or one channel. Any size; it is resampled to the image. threshold (0..255) makes it hard-edged; leave it unset to keep soft edges. Follow with refine_selection for a coarse mask. One undoable step. Returns the selection.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        image: { type: "string", minLength: 1, description: "The mask as a data URL (data:image/png;base64,\u2026) or an image URL." },
+        channel: { type: "string", enum: ["luminance", "alpha", "red", "green", "blue"], description: "What to read as coverage (default luminance; alpha for a cutout PNG)." },
+        threshold: { type: "number", minimum: 0, maximum: 255, description: "Values at or above this are selected, the rest not (default: keep soft values)." },
+        invert: { type: "boolean", description: "Black = selected instead (default false)." },
+        mode: modeSchema
+      },
+      required: ["image"],
+      additionalProperties: false
+    },
+    annotations: { ...writeAnnotations("Load a selection from a mask image", true), openWorldHint: true },
+    handler: async (args) => {
+      if (typeof args.image !== "string" || !args.image.trim()) throw new Error("image must be a data URL or image URL.");
+      const channel = args.channel ?? "luminance";
+      if (!["luminance", "alpha", "red", "green", "blue"].includes(channel)) throw new Error(`Unknown channel "${String(channel)}". Use luminance, alpha, red, green or blue.`);
+      await controller.loadSelectionFromImage(args.image, {
+        channel,
+        invert: args.invert === true,
+        threshold: typeof args.threshold === "number" ? Math.min(255, Math.max(0, args.threshold)) : void 0,
+        mode: parseSelectionMode(args.mode)
+      });
+      return summary(controller);
+    }
+  };
+  const loadFromMask = {
+    name: "load_selection_from_mask",
+    title: "Load a selection from a layer mask",
+    description: "Load Selection from a layer's mask (Ctrl/\u2318-click its mask thumbnail): the mask's pixels become the selection, combined by mode (density and feather are not applied). Use it to reuse a mask on another layer or to edit it as a selection. Fails when the layer has no painted mask. One undoable step. Returns the selection.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        layerId: { type: "string", minLength: 1, description: "The layer whose mask to load (see list_layers)." },
+        invert: { type: "boolean", description: "Select what the mask hides instead (default false)." },
+        mode: modeSchema
+      },
+      required: ["layerId"],
+      additionalProperties: false
+    },
+    annotations: writeAnnotations("Load a selection from a layer mask", true),
+    handler: (args) => {
+      const id = String(args.layerId ?? "");
+      const layer = controller.getLayer(id);
+      if (!layer) throw new Error(`No layer "${id}". Call list_layers for ids.`);
+      if (!layer.mask) throw new Error(`Layer "${id}" has no mask. Add one with add_layer_mask, or pick a layer with a mask.`);
+      if (layer.mask.source) throw new Error(`Layer "${id}" has a computed (depth) mask, not a painted one, so it cannot be loaded as a selection.`);
+      controller.selectionFromLayerMask(id, parseSelectionMode(args.mode), args.invert === true);
+      return summary(controller);
+    }
+  };
+  const display = {
+    name: "set_selection_display",
+    title: "Show or hide the selection",
+    description: "How the canvas shows the selection: ants (marching ants), quickMask (a red tint over what is not selected, to judge soft edges and feather) or none (hidden; it still limits edits). View state only: no undo step, not saved. Returns the display and the selection.",
+    inputSchema: {
+      type: "object",
+      properties: { display: { type: "string", enum: ["ants", "quickMask", "none"], description: "ants, quickMask or none." } },
+      required: ["display"],
+      additionalProperties: false
+    },
+    annotations: writeAnnotations("Show or hide the selection", true),
+    handler: (args) => {
+      controller.setSelectionDisplay(args.display);
+      return { display: controller.getSelectionDisplay(), selection: summary(controller) };
+    }
+  };
+  const sampleTolerance = {
+    tolerance: { type: "number", minimum: 0, maximum: 255, description: "Largest per-channel difference from a selected colour, 0..255 (default 32, as magic_wand)." },
+    sampleMerged: sampleMergedSchema,
+    sample: sampleSchema
+  };
+  const growTool = {
+    name: "grow_selection",
+    title: "Grow the selection by colour",
+    description: "Select \u203A Grow: adds the pixels connected to the selection whose colour is within tolerance of a selected colour (to the nearest 4 levels). Use it after a magic_wand click that missed shades of the same area. Unlike modify_selection expand, it follows colour, not distance. Fails when nothing is selected. One undoable step. Returns the selection.",
+    inputSchema: { type: "object", properties: sampleTolerance, additionalProperties: false },
+    annotations: writeAnnotations("Grow the selection by colour"),
+    handler: async (args) => {
+      if (!controller.getSelection()) throw new Error("Nothing is selected; select part of the area first (magic_wand, select_rect).");
+      await controller.growSelection({ ...sampleOptions(args), tolerance: Math.min(255, Math.max(0, num2(args.tolerance, 32))) });
+      return summary(controller);
+    }
+  };
+  const similarTool = {
+    name: "select_similar",
+    title: "Select similar colours",
+    description: "Select \u203A Similar: adds every pixel in the image whose colour is within tolerance of a selected colour, connected or not. Fails when nothing is selected. One undoable step. Returns the selection.",
+    inputSchema: { type: "object", properties: sampleTolerance, additionalProperties: false },
+    annotations: writeAnnotations("Select similar colours"),
+    handler: async (args) => {
+      if (!controller.getSelection()) throw new Error("Nothing is selected; select a sample of the colour first.");
+      await controller.selectSimilar({ ...sampleOptions(args), tolerance: Math.min(255, Math.max(0, num2(args.tolerance, 32))) });
+      return summary(controller);
+    }
+  };
+  const lineTool = {
+    name: "select_line",
+    title: "Select a single row or column",
+    description: "Single Row / Single Column Marquee: selects a 1 px line across the whole image, a row at y = position or a column at x = position (natural image pixels). Use it to fix a dead row or column of pixels, or to stretch an edge line. One undoable step. Returns the selection.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        orientation: { type: "string", enum: ["row", "column"], description: "row (horizontal, at y) or column (vertical, at x)." },
+        position: { type: "number", minimum: 0, description: "y of the row or x of the column, in natural image pixels." },
+        mode: modeSchema
+      },
+      required: ["orientation", "position"],
+      additionalProperties: false
+    },
+    annotations: writeAnnotations("Select a single row or column", true),
+    handler: (args) => {
+      if (args.orientation !== "row" && args.orientation !== "column") throw new Error("orientation must be row or column.");
+      controller.selectLine(args.orientation, num2(args.position, NaN), { mode: parseSelectionMode(args.mode) });
+      return summary(controller);
+    }
+  };
+  const reselectTool = {
+    name: "reselect",
+    title: "Reselect",
+    description: "Select \u203A Reselect: brings back the last selection that deselect (or select_region none) cleared. Fails when there is none (for example after reopening the document). One undoable step. Returns the selection.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    annotations: writeAnnotations("Reselect", true),
+    handler: () => {
+      if (!controller.canReselect()) throw new Error("There is no cleared selection to bring back.");
+      controller.reselect();
+      return summary(controller);
+    }
+  };
+  const transparencyTool = {
+    name: "select_layer_transparency",
+    title: "Select a layer's pixels",
+    description: "Load Selection from a layer's transparency (Ctrl/\u2318-click its thumbnail): selects where the layer has pixels, soft where it is partly transparent, combined by mode. Use it to select a cutout, a shape or text exactly. Pixel, shape, type and smart object layers. One undoable step. Returns the selection.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        layerId: { type: "string", minLength: 1, description: "The layer whose pixels to select (see list_layers)." },
+        mode: modeSchema,
+        feather: featherSchema
+      },
+      required: ["layerId"],
+      additionalProperties: false
+    },
+    annotations: writeAnnotations("Select a layer's pixels", true),
+    handler: (args) => {
+      const id = String(args.layerId ?? "");
+      if (!controller.getLayer(id)) throw new Error(`No layer "${id}". Call list_layers for ids.`);
+      controller.selectLayerTransparency(id, { mode: parseSelectionMode(args.mode), feather: num2(args.feather, 0) });
+      return summary(controller);
+    }
+  };
+  const colorSchema = { type: "string", pattern: "^#?[0-9a-fA-F]{6}$", description: "Colour #rrggbb (default the foreground colour)." };
+  const layerIdSchema = { type: "string", minLength: 1, description: "The layer (see list_layers; default the active layer)." };
+  const requireLayerId = (v) => {
+    if (v === void 0) return void 0;
+    const id = String(v);
+    if (!controller.getLayer(id)) throw new Error(`No layer "${id}". Call list_layers for ids.`);
+    return id;
+  };
+  const strokeTool = {
+    name: "stroke_selection",
+    title: "Stroke the selection",
+    description: "Edit \u203A Stroke: paints a band width px wide along the selection edge, outside it (default), inside it or centred on it, with color, opacity and blend, on a layer's pixels or mask (channel). Use it for outlines, frames and borders that follow a shape. Fails when nothing is selected. One undo step. Returns the layer, channel and changed bounds.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        width: { type: "number", exclusiveMinimum: 0, maximum: 250, description: "Band width in pixels." },
+        location: { type: "string", enum: ["outside", "inside", "center"], description: "Where the band lies against the edge (default outside)." },
+        color: colorSchema,
+        opacity: { type: "number", minimum: 0, maximum: 1, description: "Opacity 0..1 (default 1)." },
+        blend: { type: "string", enum: BLEND_MODES.map((m) => m.id), description: "Blend mode (default normal)." },
+        layerId: layerIdSchema,
+        channel: { type: "string", enum: ["pixels", "mask"], description: "Paint the pixels (default) or the layer mask." }
+      },
+      required: ["width"],
+      additionalProperties: false
+    },
+    annotations: writeAnnotations("Stroke the selection"),
+    handler: (args) => {
+      if (!controller.getSelection()) throw new Error("Nothing is selected; select the shape to outline first.");
+      return controller.strokeSelection({
+        width: num2(args.width, NaN),
+        location: args.location,
+        color: args.color,
+        opacity: args.opacity,
+        blend: args.blend,
+        layerId: requireLayerId(args.layerId),
+        channel: args.channel
+      });
+    }
+  };
+  const cropTool = {
+    name: "crop_to_selection",
+    title: "Crop to the selection",
+    description: "Image \u203A Crop to the selection: sets the crop box to the selection's bounds (non-destructive; reset_crop undoes it). Fails when nothing is selected. One undo step. Returns the crop box in natural image pixels.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    annotations: writeAnnotations("Crop to the selection", true),
+    handler: () => {
+      if (!controller.getSelection()) throw new Error("Nothing is selected; select the area to keep first.");
+      return { crop: controller.cropToSelection() };
+    }
+  };
+  const fillTool = {
+    name: "content_aware_fill",
+    title: "Content-Aware Fill",
+    description: "Edit \u203A Content-Aware Fill: removes what is selected by filling it with texture and edges synthesised from around it (on a pixel layer, default the active one). Select the object with a small margin (expand 2\u20134 px) first. output current paints into the layer; new-layer puts the fill on its own layer above it, so it can be masked or removed (recommended). sampleRadius limits where it samples from. Deterministic for a seed. 8-bit documents. One undo step. Returns the layer id and filled bounds.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        output: { type: "string", enum: ["new-layer", "current"], description: "new-layer or current (default current)." },
+        sampleRadius: { type: "number", minimum: 32, maximum: 4e3, description: "Sample within this many pixels of the selection (default its larger side)." },
+        seed: { type: "integer", minimum: 0, description: "Random seed; another seed gives another fill to choose from (default 0)." },
+        layerId: layerIdSchema
+      },
+      additionalProperties: false
+    },
+    annotations: writeAnnotations("Content-Aware Fill"),
+    handler: (args) => {
+      if (!controller.getSelection()) throw new Error("Nothing is selected; select what to remove first.");
+      return controller.contentAwareFill({
+        output: args.output,
+        sampleRadius: args.sampleRadius,
+        seed: args.seed,
+        layerId: requireLayerId(args.layerId)
+      });
+    }
+  };
+  const copyTool = {
+    name: "copy_pixels",
+    title: "Copy pixels",
+    description: "Edit \u203A Copy: puts the selected pixels of a pixel layer (default the active one), or with merged everything visible (Copy Merged), on the editor clipboard, cropped to the selection with its soft edge as alpha. Without a selection, the whole canvas. The document does not change. Returns the copied size and where it came from; then paste_pixels.",
+    inputSchema: {
+      type: "object",
+      properties: { layerId: layerIdSchema, merged: { type: "boolean", description: "Copy the visible image of all layers (default false)." } },
+      additionalProperties: false
+    },
+    annotations: { title: "Copy pixels", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    handler: (args) => {
+      const { width, height, x, y } = controller.copyPixels({ layerId: requireLayerId(args.layerId), merged: args.merged === true });
+      return { width, height, x, y };
+    }
+  };
+  const cutTool = {
+    name: "cut_pixels",
+    title: "Cut pixels",
+    description: "Edit \u203A Cut: copies the selected pixels of a pixel layer (default the active one) to the editor clipboard and clears them from the layer (transparent, or the background colour on a transparency-locked layer). One undo step. Returns the copied size and position; then paste_pixels.",
+    inputSchema: { type: "object", properties: { layerId: layerIdSchema }, additionalProperties: false },
+    annotations: { title: "Cut pixels", readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false },
+    handler: (args) => {
+      if (!controller.getSelection()) throw new Error("Nothing is selected; select what to cut first (cutting everything would empty the layer).");
+      const { width, height, x, y } = controller.cutPixels({ layerId: requireLayerId(args.layerId) });
+      return { width, height, x, y };
+    }
+  };
+  const pasteTool = {
+    name: "paste_pixels",
+    title: "Paste pixels",
+    description: "Edit \u203A Paste the editor clipboard (from copy_pixels or cut_pixels) as a new pixel layer above the active one: new-layer (default, centred on the selection or the canvas), in-place (where it was copied), into (centred in the selection, masked by it: Paste Into) or outside (masked by its inverse). One undo step. Returns the new layerId, its bounds and whether it is masked.",
+    inputSchema: {
+      type: "object",
+      properties: { mode: { type: "string", enum: ["new-layer", "in-place", "into", "outside"], description: "Where and how to paste (default new-layer)." } },
+      additionalProperties: false
+    },
+    annotations: writeAnnotations("Paste pixels"),
+    handler: (args) => controller.pastePixels(args.mode ?? "new-layer")
+  };
+  return [
+    getSelection,
+    selectAll,
+    deselect,
+    invert2,
+    selectRect,
+    selectEllipse,
+    selectPolygonTool,
+    lineTool,
+    magicWandTool,
+    colorRangeTool,
+    loadFromImage,
+    loadFromMask,
+    transparencyTool,
+    growTool,
+    similarTool,
+    reselectTool,
+    display,
+    selectRegion,
+    selectByColor,
+    modify,
+    refine,
+    applyMask,
+    strokeTool,
+    cropTool,
+    fillTool,
+    copyTool,
+    cutTool,
+    pasteTool
+  ];
 }
 function createImageSubjectSelectionTool(controller) {
   return {
@@ -11272,12 +12247,12 @@ function createImageLayerTools(controller) {
   const addMask = {
     name: "add_layer_mask",
     title: "Add a layer mask",
-    description: "Adds a mask to any layer, replacing an existing one: from reveal-all (white, paint black to hide), hide-all (black, paint white to reveal) or selection (the selection's coverage). density 0..1 and feather px soften it non-destructively. One undo step. Returns the mask summary.",
+    description: "Adds a mask to any layer, replacing an existing one: from reveal-all (white, paint black to hide), hide-all (black, paint white to reveal), selection (Reveal Selection: the selection's coverage), hide-selection (its inverse) or transparency (the layer's own alpha, for pixel, shape, type and smart object layers). density 0..1 and feather px soften it non-destructively. One undo step. Returns the mask summary.",
     inputSchema: {
       type: "object",
       properties: {
         layerId: LAYER_ID2,
-        from: { type: "string", enum: ["reveal-all", "hide-all", "selection"], description: "What the mask starts as (default reveal-all)." },
+        from: { type: "string", enum: ["reveal-all", "hide-all", "selection", "hide-selection", "transparency"], description: "What the mask starts as (default reveal-all)." },
         density: { type: "number", minimum: 0, maximum: 1, description: "Mask density 0..1 (default 1)." },
         feather: { type: "number", minimum: 0, maximum: 1e3, description: "Feather \u03C3 in px (default 0)." }
       },
@@ -13331,13 +14306,14 @@ function createImageSmartObjectTools(controller) {
   const addFilter = {
     name: "add_smart_filter",
     title: "Add a smart filter",
-    description: "Adds a smart filter to a smart object: develop (brightness, contrast, saturation, exposure, temperature, tint) or blur (radius px), with its own blend mode and opacity over the result below it. Filters run bottom to top on the placed contents, then the filter mask mixes in the unfiltered contents. Unlike layer filters, a kind can repeat. One undo step. Returns the filter (with its id) and the stack.",
+    description: "Adds a smart filter to a smart object: develop (brightness, contrast, saturation, exposure, temperature, tint) or blur (radius px), with its own blend mode and opacity over the result below it. Filters run bottom to top on the placed contents, then the filter mask mixes in the unfiltered contents. Unlike layer filters, a kind can repeat. With a selection (and useSelection, default true), the filter mask is set from it in the same step. One undo step. Returns the filter (with its id), the stack and masked.",
     inputSchema: {
       type: "object",
       properties: {
         layerId: LAYER_ID4,
         kind: { type: "string", enum: ["develop", "blur"], description: "Filter kind." },
         index: { type: "integer", minimum: 0, description: "Position in the stack, 0 = bottom, applied first (default the top)." },
+        useSelection: { type: "boolean", description: "With a selection, set the filter mask from it so the filter only changes the selected area (default true)." },
         ...FILTER_SETTINGS
       },
       required: ["layerId", "kind"],
@@ -13346,8 +14322,9 @@ function createImageSmartObjectTools(controller) {
     annotations: { title: "Add a smart filter", ...WRITE7 },
     handler: (args) => {
       const id = smartId(args.layerId);
-      const filter = controller.addSmartFilter(id, { kind: args.kind, ...settingsFrom(args) }, args.index);
-      return { layerId: id, filter, smartFilters: info(id).smartFilters };
+      const masked = args.useSelection !== false && controller.hasSelection;
+      const filter = controller.addSmartFilter(id, { kind: args.kind, ...settingsFrom(args) }, args.index, { useSelection: args.useSelection !== false });
+      return { layerId: id, filter, smartFilters: info(id).smartFilters, masked };
     }
   };
   const updateFilter = {
@@ -14160,7 +15137,7 @@ function createImageEditorToolProvider(controller, options = {}) {
   const addLayer = {
     name: "add_adjustment_layer",
     title: "Add an adjustment layer",
-    description: "Adds a non-destructive adjustment layer on top of the stack (one undoable step) and returns it. Kinds: " + ADJUSTMENT_KINDS.map((k) => k.kind).join(", ") + ". Omitted params are neutral.",
+    description: "Adds a non-destructive adjustment layer on top of the stack (one undoable step) and returns it; with a selection it is masked by it (useSelection, default true; masked in the result says so). Kinds: " + ADJUSTMENT_KINDS.map((k) => k.kind).join(", ") + ". Omitted params are neutral.",
     inputSchema: {
       type: "object",
       properties: {
@@ -14170,7 +15147,8 @@ function createImageEditorToolProvider(controller, options = {}) {
         blend: { type: "string", enum: BLEND_MODES.map((m) => m.id), description: "Blend mode (default normal)." },
         name: { type: "string", description: "Layer name shown in the layers panel." },
         aboveId: { type: "string", description: "Put the layer directly above this layer (from list_layers). Default: above the other adjustment layers, below annotations." },
-        parentId: { type: "string", description: "Put the layer at the top of this group (from list_layers)." }
+        parentId: { type: "string", description: "Put the layer at the top of this group (from list_layers)." },
+        useSelection: { type: "boolean", description: "With a selection, mask the new layer with it so the adjustment only affects the selected area (default true; false for a global layer)." }
       },
       required: ["kind"],
       additionalProperties: false
@@ -14182,7 +15160,7 @@ function createImageEditorToolProvider(controller, options = {}) {
       idempotentHint: false,
       openWorldHint: false
     },
-    handler: ({ kind, params, opacity, blend, name, aboveId, parentId }) => {
+    handler: ({ kind, params, opacity, blend, name, aboveId, parentId, useSelection }) => {
       if (!isAdjustmentKind(kind)) throw new Error(`Unknown adjustment kind "${kind}".`);
       if (blend !== void 0 && !isBlendMode(blend)) throw new Error(`Unknown blend mode "${blend}".`);
       if (aboveId !== void 0 && parentId !== void 0) throw new Error("Give aboveId or parentId, not both.");
@@ -14190,9 +15168,9 @@ function createImageEditorToolProvider(controller, options = {}) {
         if (ref !== void 0 && !controller.getLayer(ref)) throw new Error(`Unknown layer "${ref}". Call list_layers for ids.`);
       }
       if (parentId !== void 0 && controller.getLayer(parentId)?.type !== "group") throw new Error(`Layer "${parentId}" is not a group.`);
-      const id = controller.addAdjustmentLayer({ kind, params, opacity, blend, name, aboveId, parentId });
+      const id = controller.addAdjustmentLayer({ kind, params, opacity, blend, name, aboveId, parentId, useSelection: useSelection !== false });
       const layer = controller.getAdjustmentLayer(id);
-      return { layer: JSON.parse(JSON.stringify(layer)), index: controller.getAdjustmentLayers().findIndex((l) => l.id === id) };
+      return { layer: JSON.parse(JSON.stringify(layer)), index: controller.getAdjustmentLayers().findIndex((l) => l.id === id), masked: Boolean(layer.mask) };
     }
   };
   const renderPreview = {
@@ -14326,6 +15304,14 @@ function removeCurvePoint(points, index) {
 var round22 = (v) => Math.round(v * 100) / 100;
 
 // src/image-editor/selection/gesture.ts
+function snapTo45(from, point) {
+  const dx = point.x - from.x;
+  const dy = point.y - from.y;
+  const len = Math.hypot(dx, dy);
+  if (len === 0) return point;
+  const a = Math.round(Math.atan2(dy, dx) / (Math.PI / 4)) * (Math.PI / 4);
+  return { x: from.x + Math.cos(a) * len, y: from.y + Math.sin(a) * len };
+}
 var SelectionGesture = class {
   constructor(controller, getOptions) {
     this.controller = controller;
@@ -14337,13 +15323,20 @@ var SelectionGesture = class {
   points = [];
   current = null;
   modifiers = {};
+  /** Polygonal lasso corners while one is being drawn. */
+  polygon = null;
+  pressedAt = null;
+  freehand = false;
+  /** A click this close to the first corner (natural pixels) closes a polygonal lasso. */
+  closeRadius = 8;
   /** The last error (e.g. pixels unavailable for the wand), for the UI to show. */
   error = null;
   get active() {
-    return this.start !== null;
+    return this.start !== null || this.polygon !== null;
   }
   /** The outline of the shape being drawn, or `null`. */
   get draftPath() {
+    if (this.polygon) return this.current ? [...this.polygon, this.current] : this.polygon.slice();
     if (!this.start || !this.current) return null;
     const { tool } = this.getOptions();
     if (tool === "lasso") return this.points.length > 1 ? this.points.slice() : null;
@@ -14366,18 +15359,71 @@ var SelectionGesture = class {
   async begin(point, modifiers = {}) {
     const options = this.getOptions();
     this.error = null;
+    if (this.polygon && options.tool !== "polygon") this.cancel();
+    if (options.tool === "polygon") {
+      this.pressedAt = point;
+      this.freehand = false;
+      if (!this.polygon) {
+        this.modifiers = modifiers;
+        this.polygon = [point];
+        this.current = point;
+        return;
+      }
+      const last = this.polygon[this.polygon.length - 1];
+      const p = modifiers.shiftKey ? snapTo45(last, point) : point;
+      const first = this.polygon[0];
+      if (this.polygon.length >= 3 && Math.hypot(p.x - first.x, p.y - first.y) <= this.closeRadius) {
+        this.close();
+        return;
+      }
+      if (Math.hypot(p.x - last.x, p.y - last.y) >= 0.5) this.polygon.push(p);
+      this.current = p;
+      if ((modifiers.detail ?? 1) >= 2) this.close();
+      return;
+    }
     this.modifiers = modifiers;
-    if (options.tool === "wand") {
+    if (options.tool === "row" || options.tool === "column") {
+      this.start = null;
+      try {
+        this.controller.selectLine(options.tool, options.tool === "row" ? point.y : point.x, {
+          mode: selectionModeFromModifiers(modifiers, options.mode),
+          feather: options.feather ?? 0
+        });
+      } catch (err) {
+        this.error = err instanceof Error ? err.message : String(err);
+      }
+      return;
+    }
+    if (options.tool === "wand" || options.tool === "range") {
       this.start = null;
+      const common = {
+        sampleMerged: options.sampleMerged,
+        sample: options.sample,
+        feather: options.feather ?? 0,
+        mode: selectionModeFromModifiers(modifiers, options.mode)
+      };
       try {
+        if (options.tool === "range") {
+          const pixels = await this.controller.getSamplePixels(common);
+          if (!pixels) throw new Error("The image pixels are not available to sample.");
+          const x = Math.min(pixels.width - 1, Math.max(0, Math.floor(point.x)));
+          const y = Math.min(pixels.height - 1, Math.max(0, Math.floor(point.y)));
+          const p = (y * pixels.width + x) * 4;
+          const color = [pixels.data[p], pixels.data[p + 1], pixels.data[p + 2]];
+          await this.controller.selectColorRange([{ color, at: point }], {
+            ...common,
+            fuzziness: options.fuzziness ?? 40,
+            localized: options.localized ? options.localized : void 0,
+            invert: options.rangeInvert ?? false
+          });
+          return;
+        }
         await this.controller.magicWand(point, {
+          ...common,
           tolerance: options.tolerance,
           contiguous: options.contiguous,
           antiAlias: options.antiAlias,
-          distance: options.distance,
-          sampleMerged: options.sampleMerged,
-          sample: options.sample,
-          mode: selectionModeFromModifiers(modifiers, options.mode)
+          distance: options.distance
         });
       } catch (err) {
         this.error = err instanceof Error ? err.message : String(err);
@@ -14389,7 +15435,18 @@ var SelectionGesture = class {
     this.points = [point];
   }
   /** Pointer move; returns true when the draft changed (re-render). */
-  move(point) {
+  move(point, modifiers = {}) {
+    if (this.polygon) {
+      const last = this.polygon[this.polygon.length - 1];
+      if (this.pressedAt && (this.freehand || Math.hypot(point.x - this.pressedAt.x, point.y - this.pressedAt.y) >= 3)) {
+        this.freehand = true;
+        if (Math.hypot(point.x - last.x, point.y - last.y) >= 0.5) this.polygon.push(point);
+        this.current = null;
+        return true;
+      }
+      this.current = modifiers.shiftKey ? snapTo45(last, point) : point;
+      return true;
+    }
     if (!this.start) return false;
     this.current = point;
     if (this.getOptions().tool === "lasso") {
@@ -14401,6 +15458,12 @@ var SelectionGesture = class {
   }
   /** Pointer up: commits the shape. Returns true when the selection changed. */
   end(point, modifiers) {
+    if (this.polygon) {
+      if (point && this.freehand) this.move(point);
+      this.pressedAt = null;
+      this.freehand = false;
+      return false;
+    }
     if (!this.start) return false;
     if (point) this.move(point);
     const options = this.getOptions();
@@ -14416,17 +15479,65 @@ var SelectionGesture = class {
     this.current = null;
     this.points = [];
     if (!path) return mode === "replace" ? this.controller.deselect() : false;
-    const opts = { mode, antiAlias: options.antiAlias };
+    const opts = { mode, antiAlias: options.antiAlias, feather: options.feather ?? 0 };
     if (options.tool === "lasso") return path.length >= 3 ? this.controller.selectPolygon(path, opts) : false;
     return options.tool === "ellipse" ? this.controller.selectEllipse(rect, opts) : this.controller.selectRect(rect, opts);
   }
-  /** Abandons a drag without changing the selection. */
+  /** Closes a polygonal lasso and selects it. Returns true when the selection changed. */
+  close() {
+    const polygon = this.polygon;
+    if (!polygon) return false;
+    const options = this.getOptions();
+    this.cancel();
+    if (polygon.length < 3) return false;
+    return this.controller.selectPolygon(polygon, {
+      mode: selectionModeFromModifiers(this.modifiers, options.mode),
+      antiAlias: options.antiAlias,
+      feather: options.feather ?? 0
+    });
+  }
+  /**
+   * 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) {
+    if (!this.polygon) return false;
+    if (key === "Enter") this.close();
+    else if (key === "Escape") this.cancel();
+    else if (key === "Backspace" || key === "Delete") {
+      this.polygon.pop();
+      if (!this.polygon.length) this.cancel();
+    } else return false;
+    return true;
+  }
+  /** Abandons a drag (or a polygonal lasso) without changing the selection. */
   cancel() {
     this.start = null;
     this.current = null;
     this.points = [];
+    this.polygon = null;
+    this.pressedAt = null;
+    this.freehand = false;
   }
 };
+function handleSelectionShortcut(controller, e, onError) {
+  if (!(e.ctrlKey || e.metaKey)) return false;
+  const key = e.key.toLowerCase();
+  const run = (fn) => {
+    try {
+      fn();
+    } catch (err) {
+      onError?.(err instanceof Error ? err.message : String(err));
+    }
+    return true;
+  };
+  if (key === "c") return run(() => controller.copyPixels({ merged: Boolean(e.shiftKey) }));
+  if (key === "x" && !e.shiftKey) return run(() => controller.cutPixels());
+  if (key === "v") return run(() => controller.pastePixels(e.shiftKey && e.altKey ? "into" : e.shiftKey ? "in-place" : "new-layer"));
+  if (key === "d") return run(() => e.shiftKey ? controller.reselect() : controller.deselect());
+  if (key === "i" && e.shiftKey) return run(() => controller.invertSelection());
+  return false;
+}
 
 // src/image-editor/mosaic-filter.ts
 function resolveMosaicRegionBounds(region, imgWidth, imgHeight) {
@@ -14566,6 +15677,21 @@ function applyRegionBlur(imageData, regions, radius = 10) {
 }
 
 // src/image-editor/layers/panel.ts
+function maskThumbnailClick(controller, layer, e) {
+  if (!layer.mask) return;
+  if (e.ctrlKey || e.metaKey) {
+    controller.selectionFromLayerMask(layer.id, selectionModeFromModifiers(e, "replace"));
+  } else if (e.shiftKey) {
+    controller.setLayerMaskProps(layer.id, { enabled: layer.mask.enabled === false });
+  } else {
+    controller.setActiveLayer(layer.id, "mask");
+  }
+}
+function layerThumbnailClick(controller, layer, e) {
+  if (!(e.ctrlKey || e.metaKey)) return false;
+  controller.selectLayerTransparency(layer.id, { mode: selectionModeFromModifiers(e, "replace") });
+  return true;
+}
 function layerPanelRows(layers, activeId) {
   const rows = [];
   const walk = (list, depth, parentId) => {
@@ -14637,6 +15763,7 @@ function layerMenu(controller) {
   const below = loc ? siblings[loc.index - 1] : void 0;
   const hasSel = controller.hasSelection;
   const isPixel = active?.type === "pixel";
+  const hasOwnPixels = active?.type === "pixel" || active?.type === "shape" || active?.type === "type" || active?.type === "smart";
   return [
     { action: "new-layer", label: "New Layer", enabled: true },
     { action: "new-group", label: "New Group", enabled: true },
@@ -14651,6 +15778,9 @@ function layerMenu(controller) {
     { action: "via-cut", label: "Layer via Cut", enabled: isPixel && hasSel },
     { action: "add-mask", label: "Add Layer Mask", enabled: Boolean(active) },
     { action: "add-mask-selection", label: "Add Mask from Selection", enabled: Boolean(active) && hasSel },
+    { action: "add-mask-hide-selection", label: "Add Mask Hiding Selection", enabled: Boolean(active) && hasSel },
+    { action: "add-mask-transparency", label: "Add Mask from Transparency", enabled: hasOwnPixels },
+    { action: "select-transparency", label: "Select Layer Pixels", enabled: hasOwnPixels },
     { action: "apply-mask", label: "Apply Layer Mask", enabled: isPixel && Boolean(active?.mask) },
     { action: "delete-mask", label: "Delete Layer Mask", enabled: Boolean(active?.mask) },
     { action: "toggle-mask", label: active?.mask?.enabled === false ? "Enable Layer Mask" : "Disable Layer Mask", enabled: Boolean(active?.mask) },
@@ -14702,6 +15832,15 @@ async function runLayerMenuAction(controller, action) {
       case "add-mask":
         if (id) controller.addLayerMask(id, "reveal-all");
         break;
+      case "add-mask-hide-selection":
+        if (id) controller.addLayerMask(id, "hide-selection");
+        break;
+      case "add-mask-transparency":
+        if (id) controller.addLayerMask(id, "transparency");
+        break;
+      case "select-transparency":
+        if (id) controller.selectLayerTransparency(id);
+        break;
       case "add-mask-selection":
         if (id) controller.addLayerMask(id, "selection");
         break;
@@ -14886,6 +16025,7 @@ async function addLayerOfKind(controller, id, init) {
     if (isAdjustmentKind(kind)) {
       return controller.addAdjustmentLayer({
         kind,
+        useSelection: true,
         ...init
       });
     }
@@ -15834,7 +16974,7 @@ function createImageEffectsToolProvider(controller, options = {}) {
     skill: "pixerate-image-editor",
     target: { noun: "layer", id: "A layer id from list_layers." },
     applyUses: ["filter"],
-    applyDetails: "The effect becomes a smart filter: it runs on the layer's pixels after the smart filters below it, with its own blend and opacity, under the smart filter mask, and can be changed or removed later. A pixel, shape or type layer (or a group) is converted to a smart object first, in the same undo step (one layer keeps its id; the result says converted). Generators and overlays go on their own layer through add_effect_layer.",
+    applyDetails: "The effect becomes a smart filter: it runs on the layer's pixels after the smart filters below it, with its own blend and opacity, under the smart filter mask, and can be changed or removed later. A pixel, shape or type layer (or a group) is converted to a smart object first, in the same undo step (one layer keeps its id; the result says converted). With a selection, the filter mask is set from it in the same step, so the filter only changes the selected area (the result says masked); deselect first to filter the whole layer. Generators and overlays go on their own layer through add_effect_layer.",
     provider: () => controller.effectsProvider,
     readOnlyReason,
     list: (target) => {
@@ -15842,8 +16982,8 @@ function createImageEffectsToolProvider(controller, options = {}) {
       return layers.map((l) => ({ target: l.id, ...l.name ? { name: l.name } : {}, effects: imageLayerAppliedEffects(l) })).filter((t) => target || t.effects.length);
     },
     apply: async (target, effect, args) => {
-      const r = await controller.applyEffectFilter(target, effect, { values: plainValues(args.values), index: args.index, enabled: args.enabled, opacity: args.opacity });
-      return result(r.layerId, r.filter.id, { converted: r.converted });
+      const r = await controller.applyEffectFilter(target, effect, { values: plainValues(args.values), index: args.index, enabled: args.enabled, opacity: args.opacity, useSelection: true });
+      return result(r.layerId, r.filter.id, { converted: r.converted, masked: r.masked });
     },
     update: async (target, instance, changes) => {
       const layer = layerOf(target);
@@ -15974,6 +17114,8 @@ export {
   CANVAS_SIZE_PRESETS,
   CLONE_TRANSFORM_CONTROLS,
   COLOR_MODE_OPTIONS,
+  COLOR_RANGE_PRESETS,
+  COLOR_RANGE_PRESET_LABELS,
   CoverageMap,
   D50,
   D65,
@@ -16030,6 +17172,7 @@ export {
   HIDE,
   HISTOGRAM_BINS,
   HUE_RANGE_LABELS,
+  HUE_RANGE_PRESETS,
   IDENTITY_CLONE_TRANSFORM,
   IDENTITY_MATRIX3,
   IMAGE_ADJUSTMENT_CONTROLS,
@@ -16093,6 +17236,7 @@ export {
   PARAGRAPH_STYLE_FIELDS,
   PARAM,
   PARAM_FLOATS,
+  PASTE_MODES,
   PATTERN_BLOCK_KEYS,
   PIGMENT_BANDS,
   PIGMENT_CHANNELS,
@@ -16296,6 +17440,7 @@ export {
   colorModePlanes16,
   colorPanelView,
   colorRange,
+  colorRangePreset,
   combineSelections,
   compileAdjustmentLayer,
   componentPath,
@@ -16468,9 +17613,11 @@ export {
   grainHeights,
   greyMorphology,
   groupLayers,
+  growSelection,
   guidePlanes,
   guidedFilterColor,
   handlePaintShortcut,
+  handleSelectionShortcut,
   hasActiveEffects,
   hasLayersBelow,
   hasResampledLegacyMask,
@@ -16515,6 +17662,7 @@ export {
   isBitDepth,
   isBlendMode,
   isBrushstrokeBrush,
+  isColorRangePreset,
   isContentsDecoded,
   isDefaultDepthMask,
   isGradientPaint,
@@ -16561,6 +17709,7 @@ export {
   layerName,
   layerPanelRows,
   layerPanels,
+  layerThumbnailClick,
   layerTree,
   layerTypeLabel,
   layerWarning,
@@ -16589,6 +17738,7 @@ export {
   mapSubpaths,
   maskBounds,
   maskSummary,
+  maskThumbnailClick,
   matrixFromCorners,
   matrixFromParams,
   measureCanvasViewport,
@@ -16784,11 +17934,13 @@ export {
   segmentToSelection,
   segmentationOutlines,
   segmentsToSelection,
+  selectSimilar,
   selectionArea,
   selectionFromCoverage,
   selectionFromPixels,
   selectionModeFromModifiers,
   selectionOutline,
+  selectionRing,
   selectionToCoverage,
   selectionToPixels,
   selectionValueAt,
@@ -16821,11 +17973,13 @@ export {
   shapeOutline,
   shapeRenderClip,
   shiftCoverage,
+  skinToneRange,
   smartFilterRows,
   smartObjectLayers,
   smoothCoverage,
   smoothPoints,
   smudgeEffect,
+  snapTo45,
   solidPaint,
   solidSurface,
   solveMembrane,