@pixerate/editor 0.275.0 → 0.276.0

package/dist/vector/index.js

@@ -35,7 +35,7 @@ import {
   traceField,
   traceVectorImage,
   vectorTraceContours
-} from "../chunk-75SYKUOT.js";
+} from "../chunk-OS6OG7DN.js";
 import {
   rasterizeCoverage
 } from "../chunk-ADMRNWR7.js";
@@ -66,7 +66,7 @@ import {
   reverseMorphContour,
   subpathToMorphContour,
   turnMorphContour
-} from "../chunk-43XJC3PP.js";
+} from "../chunk-CVBTJVRN.js";
 import {
   DEFAULT_VECTOR_FONT,
   IDENTITY_MATRIX,
@@ -556,10 +556,10 @@ import {
   withVectorStrokes,
   withVectorTargetPaint,
   zigzagPaths
-} from "../chunk-Y2ISSVPH.js";
+} from "../chunk-4EM5NGCL.js";
 import {
   snapshotBrushLibrary
-} from "../chunk-ZM7IKQ4X.js";
+} from "../chunk-XVPQNX7O.js";
 import "../chunk-JL6YH5WD.js";
 import {
   createProvenance
@@ -597,11 +597,11 @@ import {
   resolveEffectValues
 } from "../chunk-MV7CYFMJ.js";
 import "../chunk-V2ZCJRDM.js";
-import "../chunk-LMG57L5A.js";
-import "../chunk-W6JDUXP3.js";
+import "../chunk-CTHWXW5M.js";
+import "../chunk-J23JOHPR.js";
 import {
   GRAIN_PATTERNS
-} from "../chunk-ACTHSQOI.js";
+} from "../chunk-LDZOXESA.js";
 import "../chunk-4D6KP5BV.js";
 import "../chunk-ODBT55Q7.js";
 import "../chunk-IRSTHLQQ.js";

package/package.json

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

package/skills/pixerate-brushes/SKILL.md

@@ -25,6 +25,7 @@ built-in presets (read-only) and the user's brushes, shared by every editor that
 | Iridescence | Structural thin-film interference (`thickness` 100..1000 nm, `pressureToThickness` 0..1, `ior` 1.2..2.0) whose hue shifts with light and view tilt (`scarab-lacquer`, `soap-film`, `pearl-glaze`). |
 | Ghost | On wet paint (`behaviour.surface: "wet"`): `linger` (0.5..60 s before the brush's own colour fades away) and `smear` (0..1, how much it lifts and drags the paint it crosses). Presets `ghost-wash`, `ghost-gouache`, `ghost-oil` and `invisible-ink`. |
 | Motion | Animation after painting (live effect paint, particle `waveSpeed`). |
+| Live patterns | `livePatterns`: Gray-Scott reaction-diffusion patterns (`pattern`: `spots`, `stripes`, `coral`, `maze`, `worms`, `feed`, `kill`, `scale`, `contrast`, `secondColor`, `relief`) that grow in wet paint (`behaviour.surface: 'wet'`) and freeze when it dries. Built-in presets: `turing-wash`, `coral-ink`. |
 | Colour | A `default` colour, a `palette` of up to 16, `own` (always its own colour). Each is a hex or `rgba()` colour, a light / dark pair `{ light, dark }`, a gradient or effect paint. A gradient default is always painted; a solid or light / dark default becomes the editor's colour when the brush is chosen (unless the user locked theirs), resolved for the colour scheme. Canvas strokes and vector brushstrokes take it too, when they are given no colour. Canvas and vector have the same lock (`canvas.setColorLocked`, `vector.setColorLocked`), and a canvas colour taken from a light / dark default follows the scheme like the paint editor's; vector strokes already made keep theirs. |
 
 How media map to facets: a **pencil** or **charcoal** is `dry` with high `grain` and tilt;

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

@@ -118,6 +118,9 @@ Which facet sets which engine setting: [references/brush-facets.md](references/b
 ## Wet media
 
 Watercolour, gouache and wet oil run on a fluid simulation: lay washes light to dark, let them flow (`advance_wet_paint`), dry them (`dry_paint`) before glazing. Nothing moves for an agent until you advance or dry it, and saving dries the paint. Load `pixerate-paint-watercolour`, and read [references/wet-media.md](references/wet-media.md) for the engine and the wet tools. **Ghost paint and invisible ink** (`ghost` facet: `ghost-wash`, `ghost-gouache`, `ghost-oil`, `invisible-ink`) mix and flow while wet, then fade without leaving their own colour, leaving only a smear in the paint they touched: read [references/ghost.md](references/ghost.md).
+**Live patterns** (Gray-Scott reaction-diffusion spots, stripes, coral, maze and worms that grow
+in wet paint and freeze when it dries; presets `turing-wash`, `coral-ink`):
+[references/live-patterns.md](references/live-patterns.md).
 
 ## Oils, thick paint and smart inks
 
@@ -247,7 +250,7 @@ Listing, saving, sharing and previewing brushes are the brush library's tools (`
 | Tool | Use |
 | --- | --- |
 | `get_brush` | Read a brush as facets (`brush`), or the active brush as edited (no `id`), with the `engine` and `category` it paints with, `builtin` (an unchanged preset) and `strokePaint` (what its next stroke paints). Read before changing a brush you did not build. |
-| `set_brush` | Choose the active brush (`id`, from `list_brush_presets`) and / or lay facets over it: `tip`, `marks`, `dynamics`, `behaviour`, `light`, `iridescence`, `ghost`, `mutation`, `motion`, `colour` (objects merge, lists replace; marks of another kind replace the marks), `unset` facets to drop. Editor state, not saved: `create_brush` stores a brush. Returns `brush` (facets), `engine` and `problems` (values clamped). The old flat fields (`particle`, `impasto`, `behavior`…) are refused. |
+| `set_brush` | Choose the active brush (`id`, from `list_brush_presets`) and / or lay facets over it: `tip`, `marks`, `dynamics`, `behaviour`, `light`, `iridescence`, `ghost`, `mutation`, `motion`, `colour`, `livePatterns` (objects merge, lists replace; marks of another kind replace the marks), `unset` facets to drop. Editor state, not saved: `create_brush` stores a brush. Returns `brush` (facets), `engine` and `problems` (values clamped). The old flat fields (`particle`, `impasto`, `behavior`…) are refused. |
 
 ### Colour
 
@@ -311,6 +314,9 @@ Listing, saving, sharing and previewing brushes are the brush library's tools (`
 | `set_water_overlay` | Show where the water is (`visible`), view only. |
 | `set_wet_engine` | Let Engine B (WebGPU in browsers, Metal in the Swift editors) shade large washes (`gpu` "auto", the default) or force the CPU (`gpu` "off"); `minTiles` sets the wet area at which the GPU takes over. Never changes the result, only how it is drawn; editor setting, not saved, not an undo step. Returns `engine` (`state`: off, not-started, starting, unavailable, standby, active, failed; `reason`, `adapter`). |
 | `set_instant_dry` | `on`: every wet stroke dries as it ends (same undo step); off (default) wet paint keeps moving. Returns `instantDry`. |
+| `get_live_patterns` | Read live reaction-diffusion pattern fields on one layer (`layerId`) or every layer, plus the Pearson `presets` (`spots`, `stripes`, `coral`, `maze`, `worms`) and built-in `brushPresets` (`turing-wash`, `coral-ink`). Returns `layers` (`active`, `settings`, `activeTiles`, `patternCells`, `wetPatternCells`, `maxV`, `meanV`, `bounds`). Changes nothing. |
+| `set_live_patterns` | Configure a layer's Gray-Scott reaction-diffusion settings (`layerId`, `pattern`, `feed`, `kill`, `scale`, `contrast`, `secondColor`, `relief`). One undo step. Returns `layerId`, `settings`, `stats` and `stillWet`. |
+| `seed_live_patterns` | Seed Gray-Scott reagent V at `points` (`[{x, y}]` in document px) with `radius` and `seed` on a layer (`layerId`, default active), optionally updating pattern settings (`pattern`, `feed`, `kill`, `scale`, `contrast`, `secondColor`, `relief`). Follow with `advance_wet_paint` to grow the pattern while wet, then `dry_paint` to freeze it. One undo step. Returns `layerId`, `seeded`, `radius`, `seed`, `settings`, `stats`, `stillWet`. |
 
 ### Thick paint, light and smart inks
 

package/skills/pixerate-paint-editor/references/brush-facets.md

@@ -20,6 +20,7 @@ more; this is where each one went.
 | Bristles | `tip.shape` `bristle` and `tip.bristle` |
 | A brush's own gradient (paint) | `colour.default` (a gradient); `unset: ['colour']` drops it |
 | Light | `light` (`amount`, `pressure`) |
+| Live reaction-diffusion patterns in wet paint | `livePatterns` (`pattern`: `spots` / `stripes` / `coral` / `maze` / `worms`, `feed`, `kill`, `scale`, `contrast`, `secondColor`, `relief`); `unset: ['livePatterns']` drops it |
 | UV-fluorescent ink (glows under `set_uv_light`, optional invisible ink) | `fluorescence` (`amount` 0..1, `invisible`); `unset: ['fluorescence']` drops it |
 | Thermochromic ink (shifts toward `hotColor` where `paint_heat` warms the canvas) | `thermochromic` (`hotColor` `#rrggbb`, `threshold` 0.05..0.95); `unset: ['thermochromic']` drops it |
 | Thin-film iridescence | `iridescence` (`thickness` 100..1000 nm, `pressureToThickness` 0..1, `ior` 1.2..2.0); `unset: ['iridescence']` drops it |

package/skills/pixerate-paint-editor/references/live-patterns.md

@@ -0,0 +1,41 @@
+# Live patterns in wet paint
+
+Live patterns are Gray-Scott reaction-diffusion patterns (`spots`, `stripes`, `coral`, `maze`, `worms`) that grow inside wet paint while water is present and **freeze when the paint dries**.
+
+## How it works
+
+1. **Seeding**:
+   - Paint with a wet brush carrying the `livePatterns` facet (built-in presets `turing-wash` and `coral-ink`, or `set_brush` / `paint_stroke` `brush: { livePatterns: { pattern: "spots", ... } }`), or
+   - Call `seed_live_patterns` on a wet layer (`points`, `radius`, `seed`, and optional pattern settings).
+2. **Growth**:
+   - Every `advance_wet_paint` step runs reaction-diffusion substeps on the layer's pattern field `(U, V)` at half tile resolution (`128 × 128` per `256 × 256` tile).
+   - Reaction-diffusion only runs where the wet world still holds water (`rho + sw > DRY_EPS`). Where the paint is dry, the rate is zero, so the pattern freezes in place.
+3. **Shading, relief and drying**:
+   - On screen and when baking (`dry_paint` or natural evaporation), reagent `V` blends the paint colour toward `secondColor` (or modulates pigment contrast when `secondColor` is `null`).
+   - When `relief > 0`, reagent `V` also writes thick height (`get_relief`), so pattern ridges catch the editor's light (`set_lighting`).
+   - Calling `dry_paint` bakes the pattern into the layer's pixels and freezes it permanently.
+
+## Pattern presets and tuning
+
+| Pattern | Pearson `(feed, kill)` | Look |
+| --- | --- | --- |
+| `spots` | `(0.035, 0.065)` | Mitosis spots and cell clusters (`turing-wash`) |
+| `stripes` | `(0.030, 0.062)` | Parallel and branching Turing stripes |
+| `coral` | `(0.0545, 0.062)` | Branching coral dendrites (`coral-ink`) |
+| `maze` | `(0.029, 0.057)` | Dense labyrinthine ridges |
+| `worms` | `(0.058, 0.065)` | Vermiculate worm tracks |
+
+Settings on `livePatterns`, `set_live_patterns` and `seed_live_patterns`:
+- `pattern`: `'spots' | 'stripes' | 'coral' | 'maze' | 'worms'`
+- `feed` (`0.005..0.1`), `kill` (`0.01..0.1`): explicit Gray-Scott feed and kill rates (setting `pattern` without `feed` / `kill` resets them to that preset's Pearson constants)
+- `scale` (`0.25..4`, default `1`): diffusion scale for wider or finer features
+- `contrast` (`0..2`, default `1`): strength of the pattern in the wet pigment
+- `secondColor` (`#rrggbb` or `null`): second colour mixed where `V` concentrates; `null` darkens and lightens the wet pigment itself
+- `relief` (`0..1`, default `0`): embosses `V` into the layer's height map so ridges catch the light
+
+## Workflow: let it grow, then dry
+
+1. Paint a wet wash with `turing-wash` or `coral-ink` (or lay a wash with `watercolor-wash` and call `seed_live_patterns`).
+2. Call `advance_wet_paint` (`steps` 30..120 or `seconds` 0.5..2) to let the pattern spread and branch inside the wet area.
+3. Check progress with `get_live_patterns` (`patternCells`, `wetPatternCells`, `maxV`, `meanV`) or `render_preview`.
+4. Call `dry_paint` once the pattern reaches the look you want so it freezes and bakes into the layer.

package/skills/pixerate-paint-watercolour/SKILL.md

@@ -63,6 +63,12 @@ light that flows and dries with its pigment: paint it on dark paper, let it flow
 `backlight` on any paper) before painting: strong transparent glazes glow, gouache and solid ink
 block the light. See `references/light-paint.md` in `pixerate-paint-editor`.
 
+**Live reaction-diffusion patterns (let it grow, then dry).** Paint with `turing-wash` or
+`coral-ink` (or seed any wet wash with `seed_live_patterns` and tune with `set_live_patterns`),
+then call `advance_wet_paint` to let Gray-Scott spots, stripes, coral, maze or worms grow where the
+layer holds water. Call `dry_paint` to freeze the pattern in place (`get_live_patterns` checks its
+coverage). See `references/live-patterns.md` in `pixerate-paint-editor`.
+
 ## Decision table
 
 | Want | Approach |
@@ -77,6 +83,7 @@ block the light. See `references/light-paint.md` in `pixerate-paint-editor`.
 | Cauliflower blooms | Add water into a drying wash; `bloom` up |
 | A glowing (neon) wash | Dark paper (`set_paper` `color`), `glow-wash` or `light.amount` on a wet brush; flow, dry, `get_light` |
 | Stained glass, a lightbox | `set_paper` `stained-glass` (or `backlight`); strong glazes for panes, opaque black lines above |
+| Organic spots, coral dendrites or Turing stripes in a wash | Paint with `turing-wash` or `coral-ink` (or `seed_live_patterns` into a wet wash), `advance_wet_paint` to let it grow, then `dry_paint` to freeze it |
 | Disturb or smear a wash without adding colour | `ghost-wash`, `ghost-gouache` or `invisible-ink` (`ghost` `linger`, `smear`) on the same layer; see `references/ghost.md` |
 
 ## Recipes
@@ -111,6 +118,7 @@ warm colour near the horizon → `advance_wet_paint` → `blot` a few clouds →
 - `paint_stroke`: washes, shapes and details, and the wet tools (water, dryer, blot)
 - `wet_paper`, `advance_wet_paint`, `dry_paint`, `get_wet_paint`: wet-in-wet, flow, drying and checking
 - `set_wet_settings`, `set_canvas_tilt`, `set_flow_map`: tune and steer the water
+- `get_live_patterns`, `set_live_patterns`, `seed_live_patterns`: grow and tune reaction-diffusion patterns in wet washes
 - `get_light`: check a glowing wash's light once it dries
 - `undo_paint`: take back a step
 - `export_image`: deliver