@pixerate/editor 0.219.2 → 0.221.0

package/skills/pixerate-image-editor/references/painting.md

@@ -1,4 +1,20 @@
-# Painting: mixing paint, the Mixer Brush and gradient paint
+# Painting: strokes, mixing paint, the Mixer Brush and gradient paint
+
+## Strokes
+
+1. **Paint on its own layer** (`add_pixel_layer`), not on the Background (active on a new image, so
+   strokes without `layerId` land there) unless asked: a layer can be faded, masked or deleted.
+2. **Retouch through masks**, not the eraser (see `pixerate-image-selection-masking`).
+3. **One stroke is one call and one undo step.** Send the path's points in order (a few points
+   per brush diameter is enough; dabs are spaced by `brush.spacing`). Use `opacity` for the
+   overall strength and `flow` for gradual build-up within the stroke.
+4. **Limit paint with a selection**, or lock transparency (`set_layer_properties`
+   `locks.transparency`) to paint only where the layer already has pixels.
+5. **Mixing paint, the Mixer Brush and gradient paint**: `mix_colors` mixes named paints like
+   pigment; `paint_stroke` `tool: "mixer"` picks up and smears the layer's colours; gradient paint
+   changes colour along a stroke. See below.
+
+## Mixing paint, the Mixer Brush and gradient paint
 
 Read this before `mix_colors`, a `paint_stroke` with `tool: "mixer"`, or gradient paint
 (`set_paint` / `paint_stroke` `paint`).

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

@@ -40,9 +40,9 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
    **Check:** `get_selection` → `empty: false` and a plausible `percent` (for a person in a
    portrait, typically 15–50 %). A wand or range above about 80 % has flooded: undo, then lower
    `tolerance` / `fuzziness`.
-2. **Build it in steps** with `mode`: start with `replace`, `add` what was missed, `subtract`
-   what leaked, and `intersect` to limit it to a region (for example `select_rect` around the
-   subject).
+2. **Build it in steps** with `mode`: `replace`, then `add` what was missed, `subtract` what
+   leaked, `intersect` to limit it. The steps are kept (`get_selection_recipe`): fix one with
+   `edit_selection_step` (a wand's tolerance, a box) rather than starting over.
    **Check:** `bounds` hug the subject. A bounds as large as the image means a leak. Smart tools
    return `uncertainRegions` (edge with no image edge under it): look there, refine with `regions`.
 3. **Measure the edge, then look.** `inspect_mask_edge` scores it: `haloScore` ≥ 0.35 is old