@pixerate/editor 0.272.1 → 0.274.0

package/skills/pixerate-paint-mutation/evals/dry-ink-answer.json

@@ -0,0 +1,74 @@
+{
+  "prompt": "Claim the pending dry ink mutation on the canvas, let its temporary layer fade out, and answer with a crimson (#dc2626) ink stroke.",
+  "fixture": {
+    "editor": "paint",
+    "width": 200,
+    "height": 200,
+    "setup": [
+      { "tool": "set_brush", "args": { "id": "mutation-ink" } },
+      {
+        "tool": "paint_stroke",
+        "args": {
+          "color": "#1e293b",
+          "points": [
+            { "x": 30, "y": 80, "pressure": 0.8 },
+            { "x": 110, "y": 80, "pressure": 0.8 }
+          ]
+        }
+      },
+      { "tool": "advance_wet_paint", "args": { "seconds": 2 } }
+    ]
+  },
+  "checks": [
+    {
+      "tool": "list_mutations",
+      "expect": { "mutations": { "$length": 0 } },
+      "why": "No pending mutations remain"
+    },
+    {
+      "tool": "list_mutations",
+      "args": { "includeAll": true },
+      "expect": {
+        "mutations": [
+          {
+            "id": "m1",
+            "state": "answered"
+          }
+        ]
+      },
+      "why": "Mutation m1 was claimed and answered"
+    },
+    {
+      "tool": "list_strokes",
+      "expect": {
+        "strokes": {
+          "$length": 1,
+          "$every": { "color": "#dc2626" }
+        }
+      },
+      "why": "The temporary mutation stroke faded away and only the crimson answer stroke remains"
+    }
+  ],
+  "solution": [
+    { "tool": "list_mutations" },
+    { "tool": "read_mutation", "args": { "id": "m1" } },
+    {
+      "tool": "answer_mutation",
+      "args": {
+        "id": "m1",
+        "strokes": [
+          {
+            "brushId": "ink-pen",
+            "brush": { "tip": { "size": 8 } },
+            "color": "#dc2626",
+            "points": [
+              { "x": 60, "y": 40, "pressure": 0.7 },
+              { "x": 140, "y": 140, "pressure": 0.8 }
+            ]
+          }
+        ]
+      }
+    },
+    { "tool": "advance_wet_paint", "args": { "seconds": 3 } }
+  ]
+}

package/skills/pixerate-paint-mutation/evals/wet-wash-answer.json

@@ -0,0 +1,76 @@
+{
+  "prompt": "Claim the pending wet mutation stroke on the canvas, let it fade away, and paint a warm amber (#d97706) watercolour-round answer stroke across the canvas.",
+  "fixture": {
+    "editor": "paint",
+    "width": 200,
+    "height": 200,
+    "setup": [
+      { "tool": "set_brush", "args": { "id": "mutation-wash" } },
+      {
+        "tool": "paint_stroke",
+        "args": {
+          "color": "#2563eb",
+          "points": [
+            { "x": 40, "y": 100, "pressure": 0.8 },
+            { "x": 120, "y": 100, "pressure": 0.8 }
+          ]
+        }
+      },
+      { "tool": "advance_wet_paint", "args": { "seconds": 2 } }
+    ]
+  },
+  "checks": [
+    {
+      "tool": "list_mutations",
+      "expect": { "mutations": { "$length": 0 } },
+      "why": "No pending mutations remain"
+    },
+    {
+      "tool": "list_mutations",
+      "args": { "includeAll": true },
+      "expect": {
+        "mutations": [
+          {
+            "id": "m1",
+            "state": "answered",
+            "answerStrokeIds": { "$length": { "$min": 1 } }
+          }
+        ]
+      },
+      "why": "Mutation m1 was claimed and answered"
+    },
+    {
+      "tool": "list_strokes",
+      "expect": {
+        "strokes": {
+          "$some": { "color": "#d97706" }
+        }
+      },
+      "why": "The warm amber answer stroke is recorded on the canvas"
+    }
+  ],
+  "solution": [
+    { "tool": "list_mutations" },
+    { "tool": "read_mutation", "args": { "id": "m1" } },
+    {
+      "tool": "answer_mutation",
+      "args": {
+        "id": "m1",
+        "note": "Warm amber arc answering the blue wash",
+        "strokes": [
+          {
+            "brushId": "watercolor-round",
+            "brush": { "tip": { "size": 18 } },
+            "color": "#d97706",
+            "points": [
+              { "x": 70, "y": 50, "pressure": 0.6 },
+              { "x": 110, "y": 100, "pressure": 0.85 },
+              { "x": 150, "y": 150, "pressure": 0.6 }
+            ]
+          }
+        ]
+      }
+    },
+    { "tool": "advance_wet_paint", "args": { "seconds": 3 } }
+  ]
+}

package/skills/pixerate-paint-oil-impasto/SKILL.md

@@ -69,6 +69,7 @@ This skill is the method. `pixerate-paint-editor` has the full tool reference an
 | A glowing, glassy bead (a neon or glass tube) | `glow-gel` (light paint with rim and clarity, on dark paper; one loop per layer where they cross) |
 | Dry, broken strokes over texture | `dry-brush`, or a lower `behaviour.thick.load` |
 | A metallic highlight | `metallic-paint` |
+| Iridescent structural colour (beetle shell, soap film, pearl glaze) | `scarab-lacquer`, `soap-film`, `pearl-glaze` (or `iridescence` facet); tilt view with `set_view_tilt` |
 | Paint that stays exactly as laid | `set_instant_dry` on |
 
 ## Recipes
@@ -98,7 +99,7 @@ light → short strokes following the form → `set_lighting` → `get_relief`.
 - `add_layer`, `update_layer`: a layer per pass
 - `mix_colors`, `color_harmony`, `add_swatch`, `set_color`: palette
 - `set_brush`, `paint_stroke`, `clean_mixer_brush`: block in, build, blend and impasto strokes
-- `set_lighting`, `get_relief`, `flatten_relief`: the relief and its light
+- `set_lighting`, `set_view_tilt`, `get_view_tilt`, `get_relief`, `flatten_relief`: the relief, thin-film iridescence and their light / view angle
 - `set_instant_dry`: strokes that dry as they end
 - `undo_paint`: take back a step
 - `export_image`: deliver

package/skills/pixerate-paint-sketch-to-finish/SKILL.md

@@ -46,9 +46,15 @@ This skill is the method. `pixerate-paint-editor` has the full tool reference.
 4. **Hide the sketch.** `update_layer` the Sketch layer `visible: false` (or lower its `opacity`
    while inking, then hide it).
    **Check:** `list_layers` shows it hidden.
-5. **Flats.** `add_layer` "Flats", then `move_layer` it below the Ink layer; fill each shape with
-   its base colour (`marker` or a flat brush, or `fill_layer` for a background).
-   **Check:** `pick_color` inside a shape is the flat colour; on a line still the ink.
+5. **Flats.** `add_layer` "Flats", then `move_layer` it below the Ink layer. Call
+   `find_unfilled_regions` (`reference` set to the Ink layer id or `"all"`, `layerId` set to the
+   Flats layer, `closeGap: 4..8`) to get each enclosed shape's interior seed `point` and `bounds`.
+   Fill each shape in one call with `fill_region` (`x`, `y` or `points` for same-coloured shapes,
+   `reference` set to the Ink layer id or `"all"`, `closeGap: 4..8` to bridge small line gaps,
+   `expand: 1..2` to bleed under anti-aliased ink edges so no white halo shows, or `wet: true` for a
+   watercolour wash). Check `leaked`: if `true`, undo (`undo_paint`) and raise `closeGap` or close
+   the open line. Use `fill_layer` for a full-canvas ground.
+   **Check:** `pick_color` inside a shape is the flat colour; on a line still the ink; `leaked` is `false`.
 6. **Shading and light.** `add_layer` "Shading" directly above the flats, `update_layer`
    `blend: "multiply"` (or `shadow`) and `clipped: true`; paint shadows on the side away from the
    light. A "Light" layer the same way with `highlight` or `screen`.
@@ -64,7 +70,8 @@ This skill is the method. `pixerate-paint-editor` has the full tool reference.
 | Sketch | `pencil-hb`, light colour, own layer, hidden at the end |
 | Line art | `ink-pen` (even), `brush-pen` (swelling); own layer on top |
 | Clean geometric lines (curves, circles, borders) | `stroke_path` with SVG path data and a `pressure` taper, on the Ink layer |
-| Flats | `marker` or a flat brush on a layer under the ink |
+| Flats inside line art | `find_unfilled_regions` then `fill_region` (`reference` = Ink layer id or `"all"`, `closeGap: 4..8`, `expand: 1..2`) on a Flats layer under the ink |
+| Watercolour wash inside line art | `fill_region` with `wet: true`, `reference` = Ink layer id, `closeGap: 4..8`, `expand: 1` |
 | Patterned or textured flats (sky, gradient, galaxy) | `set_effect_paint` with a provider generator, then a flat dry brush on the Flats layer; `set_color` after |
 | Textured passes (dry brush, sponge, foliage) | A brush with `tip.grain` (`set_brush` `{ tip: { grain: { source: "sanded", depth: 0.6 } } }`) or an image tip from the brush library, with `dynamics.angleJitter` and `flip` so repeats don't show |
 | Shadows | Clipped layer, `multiply` or `shadow`, a cool colour |
@@ -75,7 +82,10 @@ This skill is the method. `pixerate-paint-editor` has the full tool reference.
 ## Recipes
 
 **Flats under ink.** `add_layer` "Flats" → `move_layer` with the new layer's id and `index` below
-the Ink layer → `set_brush` `marker` → `set_color` → strokes inside the shape.
+the Ink layer → `find_unfilled_regions` `{ reference: inkLayerId, layerId: flatsLayerId, closeGap: 4 }`
+→ `fill_region` `{ x, y, color, reference: inkLayerId, closeGap: 4, expand: 1 }` (or pass `points`
+to fill multiple regions of the same colour in one undo step). If `leaked: true`, `undo_paint` and
+increase `closeGap`.
 
 **Effect flats.** With an effects provider: `search_effects` (`use` generator) → `describe_effect`
 → `set_effect_paint` → `marker` strokes inside the shape on the Flats layer (the effect shows
@@ -100,6 +110,7 @@ clipped: true }` → `set_brush` `airbrush` → paint the shadow side.
 
 - `get_canvas_info`, `list_layers`, `list_strokes`, `pick_color`, `render_preview`: read and check
 - `set_paper`, `fill_layer`: the ground and backgrounds
+- `find_unfilled_regions`, `fill_region`: inspect enclosed line-art shapes and fill flats under the ink with gap closing and edge expansion
 - `add_layer`, `update_layer`, `move_layer`, `remove_layer`: one layer per pass; hide, clip, blend
 - `set_brush`, `set_color`, `paint_stroke`, `replay_strokes`: sketch, ink, flats and shading
 - `stroke_path`: clean geometric line art from SVG path data

package/skills/pixerate-paint-sketch-to-finish/evals/flats-under-ink.json

@@ -20,8 +20,7 @@
 	"solution": [
 		{ "tool": "add_layer", "args": { "name": "Flats" } },
 		{ "tool": "move_layer", "args": { "layerId": { "$read": "list_layers", "path": "layers.0.id" }, "index": 0 } },
-		{ "tool": "set_brush", "args": { "id": "marker" } },
-		{ "tool": "set_color", "args": { "color": "#f2c14e" } },
-		{ "tool": "paint_stroke", "args": { "points": [{ "x": 14, "y": 16 }, { "x": 50, "y": 16 }, { "x": 50, "y": 24 }, { "x": 14, "y": 24 }, { "x": 14, "y": 32 }, { "x": 50, "y": 32 }, { "x": 50, "y": 40 }, { "x": 14, "y": 40 }, { "x": 14, "y": 48 }, { "x": 50, "y": 48 }] } }
+		{ "tool": "find_unfilled_regions", "args": { "reference": "all", "closeGap": 4 } },
+		{ "tool": "fill_region", "args": { "x": 32, "y": 32, "color": "#f2c14e", "reference": "all", "closeGap": 4, "expand": 1 } }
 	]
 }