@pixerate/editor 0.281.0 → 0.282.0

package/dist/vector/index.js

@@ -35,7 +35,7 @@ import {
   traceField,
   traceVectorImage,
   vectorTraceContours
-} from "../chunk-HN57I7KT.js";
+} from "../chunk-CG3FBNXE.js";
 import {
   rasterizeCoverage
 } from "../chunk-ADMRNWR7.js";
@@ -66,7 +66,7 @@ import {
   reverseMorphContour,
   subpathToMorphContour,
   turnMorphContour
-} from "../chunk-FKO3CY2C.js";
+} from "../chunk-ULPXJ3NB.js";
 import {
   DEFAULT_VECTOR_FONT,
   IDENTITY_MATRIX,
@@ -556,10 +556,10 @@ import {
   withVectorStrokes,
   withVectorTargetPaint,
   zigzagPaths
-} from "../chunk-YOM76H2V.js";
+} from "../chunk-VEX6YVNG.js";
 import {
   snapshotBrushLibrary
-} from "../chunk-PPDUCZZV.js";
+} from "../chunk-YRGTQLDN.js";
 import "../chunk-JL6YH5WD.js";
 import {
   createProvenance

package/package.json

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

package/skills/pixerate-brushes/SKILL.md

@@ -16,7 +16,7 @@ built-in presets (read-only) and the user's brushes, shared by every editor that
 | Medium and variety | Marks: what it lays (`paint`, `ink`, `dry`, `spray`) and what kind (`oil`, `watercolor`, `gouache`, `pencil`, `charcoal`, `airbrush`, `marker`, `highlighter`…). Descriptive, for finding brushes; a wet brush whose variety is `watercolor`, `gouache` or `oil` paints that medium. |
 | Tool | Tools: `eraser`, `blender`, `smudge`, and on wet paint `water`, `dryer`, `blow`, `blot`, `wet-blend`, `wet-drag`. |
 | Tip | `shape` (`round`, `flat`, `chisel` are ellipses set by `roundness` and `angle`; `bristle` has a tuft; `stamp` takes the shape of `stamps`: an editor stamp `editor:star`, any sticker ref from `find_stickers`, or an image source `source:<id>` from `list_brush_sources`), size in px, hardness (an image tip fades towards its edges below 1), spacing, opacity, flow, blend mode, and `grain`: texture inside each dab (`source`: a pattern such as `rough`, `canvas`, `sanded`, or `source:<id>`; `mode` `texturised` stays put on the canvas, `moving` rolls with the tip; `scale`, `depth`, `contrast`, `invert`). |
-| Marks | `continuous` dabs (default; on a stamp tip every dab is the first stamp's shape, in the paint colour), `scatter` (a spray: droplets across the tip, `density`, `size`), `particles` (strands, springs, ribbons, sparks; textured dots from the stamps) or `objects` (each mark an editable sticker, in its own colours). |
+| Marks | `continuous` dabs (default; on a stamp tip every dab is the first stamp's shape, in the paint colour), `scatter` (a spray: droplets across the tip, `density`, `size`), `particles` (strands, springs, ribbons, sparks; textured dots from the stamps), `objects` (each mark an editable sticker, in its own colours) or `antimatter` (reactive blasts that invert, scorch and annihilate paint across every visible layer in the paint editor; presets `antimatter`, `antimatter-flare`, `antimatter-charge`). |
 | Dynamics | Pen feel: pressure to size and opacity, smoothing, tilt, velocity, jitter (`sizeJitter`, `angleJitter` for rotation, `opacityJitter`, `scatter`), rotation, `count` (dabs per spacing step, each jittered) and `flip` (mirror dabs at random: `x`, `y`, `xy`). |
 | Behaviour | `surface` `dry`, `wet` (`wet` settings) or `thick` (`thick` impasto settings); paper `grain`; `exchange` (pick-up and mix; a `reservoir` makes a Mixer Brush); tool `strength`. |
 | Light | Light the brush gives off (`amount`), plus suggested layer `spill` and `glow`. |

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

@@ -12,7 +12,7 @@ is never part of a layer. Coordinates are document pixels, (0, 0) top-left, y do
 `pixerate-agent-tools` for errors, namespacing and batching.
 
 - **Brush colours.** Choosing a brush with a default colour (highlighter yellow, ballpoint blue, chalk light or dark for the colour scheme) makes it the paint colour, unless the colour is locked (`set_color` `locked`). Set the colour after choosing the brush, or lock it first. Strokes painted in a light / dark colour (a brush's pair, or `set_color` `dualColor`) record the pair. Paint them on a stroke layer (`add_layer` type `strokes`) when they should follow the viewer's theme: the document keeps the light side and each viewer sees their own scheme's; a pixel layer keeps the side it was painted in.
-- **Brushes** come from the shared brush library (`pixerate-brushes`: `list_brush_presets`, `create_brush`, `preview_brush`…) and are made of facets: a tip (size, hardness, spacing, angle, roundness, opacity, flow, blend), dynamics (pressure, tilt, velocity, jitter, a **rotation** mode `fixed`, `stroke` or `barrel`), behaviour (paper **grain** response, pick-up, wet or thick surface), marks, light, ferrofluid, motion and colour. `set_brush` chooses one and lays facet changes over it; `get_brush` reads it with the engine it paints with: `dab` (most media), `eraser`, `mixer` (the Mixer Brush: a reservoir of paint plus paint it picks up), `blender` (mixes the colours under and near the tip) or `smudge` (drags paint along the stroke), `wet` (watercolour, gouache, oil and the wet tools, below), `impasto` (thick paint with relief and material, below), `particle` (procedural particle brushes), `bristle` (a tuft of bristles) or `sticker` (sprays editable stickers).
+- **Brushes** come from the shared brush library (`pixerate-brushes`: `list_brush_presets`, `create_brush`, `preview_brush`…) and are made of facets: a tip (size, hardness, spacing, angle, roundness, opacity, flow, blend), dynamics (pressure, tilt, velocity, jitter, a **rotation** mode `fixed`, `stroke` or `barrel`), behaviour (paper **grain** response, pick-up, wet or thick surface), marks, light, ferrofluid, motion and colour. `set_brush` chooses one and lays facet changes over it; `get_brush` reads it with the engine it paints with: `dab` (most media), `eraser`, `mixer` (the Mixer Brush: a reservoir of paint plus paint it picks up), `blender` (mixes the colours under and near the tip) or `smudge` (drags paint along the stroke), `wet` (watercolour, gouache, oil and the wet tools, below), `impasto` (thick paint with relief and material, below), `particle` (procedural particle brushes), `bristle` (a tuft of bristles), `sticker` (sprays editable stickers) or `antimatter` (blasts that invert, scorch and annihilate paint across every visible layer).
 - **Wet media** (engine `wet`: `behaviour.surface` `wet`, and the wet tools; categories `watercolor` and `wet-tool`): a stroke lays water and pigment on the layer's **wet layer**, a fluid simulation that keeps running after the stroke: the water spreads until its edge is pinned by the paper, carries pigment out to the rim as it dries (edge darkening), drops pigment into the paper's valleys (granulation), pushes pigment back where new water flows in (blooms), bleeds between touching wet colours and runs downhill on a tilted canvas. Paint stays wet until it dries by itself (a few thousand steps) or `dry_paint` dries it; a dried wash is fixed, so the next wash **glazes** over it. A wet brush paints, or is a tool (`tool` `water`, `dryer`, `blow`, `blot`, `wet-blend`, `wet-drag`); `behaviour.wet` `water`, `pigment` (concentration), `body` (0 transparent watercolour .. 1 opaque gouache) and `rewet`, and `behaviour.strength`, set it up. Every result says whether paint is still wet (`wet` / `stillWet`).
 - **Behaviour** (`behaviour.exchange`, dab and mixer brushes) is how a brush treats paint already on the canvas: a **pick-up ratio** (how much paint each dab lifts and carries), a **mix ratio** (how much of the carried paint goes into what it lays down), **dirty** (keep the carried colour into the next stroke) and **multi-colour** (`tip`: several colours side by side across the tip; `dab`: the colour changes along the stroke). A Mixer Brush's `mixer.wet` / `mixer.mix` are the same two ratios. `get_mixer_brush` reads what the brush carries; `clean_mixer_brush` wipes it.
 - **Grain**: a brush's grain response times the paper's `depth` decides how much light pressure
@@ -121,6 +121,12 @@ inner glow, shadows, stroke, bevel, satin and overlays, as in the image editor
   with `marks` (kind `particles`): physics (string, spring, orbit, flow, elastic, fuzzy), render
   (dot, line, sequence, ribbon), waves and textured dots (`tip.stamps`); read [references/particle-brushes.md](references/particle-brushes.md).
   Draw slowly and with varying direction: the particles react to movement.
+- **Antimatter paint** (`marks.kind: "antimatter"`, presets `antimatter`, `antimatter-flare`,
+  `antimatter-charge`): does nothing on bare canvas, and detonates wherever it touches paint across
+  every visible layer — inverting colours (`rgb` or `oklab`), removing alpha (`annihilate`), burning
+  a soot ring (`scorch`), carving craters into impasto relief (`crater`), clearing core light and
+  throwing sparks in the brush colour on the active layer, all in one undo step. Read
+  [references/antimatter.md](references/antimatter.md).
 - **Bristle brushes** (category `bristle`): `bristle-round`, `bristle-flat`, `dry-brush`. Every
   bristle draws its own line: press harder to splay the tuft, tilt to flatten it; soft bristles
   bend into curves at turns; a low `tip.bristle.load` runs dry into broken streaks.
@@ -257,7 +263,7 @@ Listing, saving, sharing and previewing brushes are the brush library's tools (`
 
 | Tool | Use |
 | --- | --- |
-| `paint_stroke` | Paint one stroke through `points` (document px; `pressure` 0..1, `t` ms, `tiltX` / `tiltY` or `altitude` / `azimuth`, `twist`) with `brushId` (default the active brush), optional per-stroke `brush` facet changes (as `set_brush` takes), `color` or `paint` (a gradient for this stroke), `layerId`, `seed`, `snapToPerspective`. The symmetry guide adds its copies; a sampling tracing image supplies the colour when `color` is missing. Returns `layerId`, `bounds`, `dabs`, `strokeId` and, for brushes that pick up paint, `mixerLoad` (what the brush carries now). Refused on locked, hidden or group layers, with the fix in the message. |
+| `paint_stroke` | Paint one stroke through `points` (document px; `pressure` 0..1, `t` ms, `tiltX` / `tiltY` or `altitude` / `azimuth`, `twist`) with `brushId` (default the active brush), optional per-stroke `brush` facet changes (as `set_brush` takes), `color` or `paint` (a gradient for this stroke), `layerId`, `seed`, `snapToPerspective`. The symmetry guide adds its copies; a sampling tracing image supplies the colour when `color` is missing. Returns `layerId`, `bounds`, `dabs`, `strokeId`, `mixerLoad` (for brushes that pick up paint) and, for antimatter brushes, `antimatter` (`blasts`, `sparks`, `fuel`, `layers`, `skippedLayers`; `blasts: 0` and `bounds: null` over bare canvas). Refused on locked, hidden or group layers, with the fix in the message. |
 | `stroke_path` | Brush SVG path data (`path`, document px; M, L, C, Q, A, Z…) with the active brush or `brushId` / `brush`, as if drawn along it by hand: each subpath one recorded stroke, sampled every `spacing` px (default 2), with a `pressure` profile spread along each subpath (`[0.2, 1, 0.2]` tapers both ends) and optional `speed` (px/ms, stamps each sample with `t`). With an agent director, each subpath is painted live in turn. One undo step. Returns `layerId`, `bounds`, `dabs` and `strokeIds` (for `replay_strokes`, `update_stroke`). Use it for clean curves, outlines of shapes and lettering guides instead of working out points; use `paint_stroke` when the marks need variable timing or tilt. |
 | `list_strokes` | Read the recorded strokes, oldest first (default the last 100): id, layer, brush, colour, point count, seed, bounds, `live`. With `ids`, their points too; with `layerId`, one layer's. With `live: true`, the editable strokes of stroke layers as they are now, bottom first: the ids for the stroke layer tools. |
 | `get_live_stroke` | Read the stroke the user is painting right now (layer, brush, colour, samples so far; `live: false` when none). For painting along with the user; hosts stream the samples live. |

package/skills/pixerate-paint-editor/references/antimatter.md

@@ -0,0 +1,49 @@
+# Antimatter paint
+
+Antimatter paint (`marks: { kind: "antimatter", ... }`, engine `antimatter`; presets `antimatter`,
+`antimatter-flare`, `antimatter-charge`) is a reactive mark brush that does nothing over bare
+canvas, and detonates wherever it touches existing paint across every visible layer.
+
+- **Fuel and firing.** Each dab measures fuel (`0..1`) from the **pre-stroke** pixels of every
+  visible pixel layer (layers in hidden groups are ignored): tip coverage times the combined
+  visibility-weighted alpha $1 - \prod (1 - \alpha_i \cdot \text{opacity}_i)$, where each layer's
+  opacity is multiplied by its groups' opacities (paint in a half-opaque group is half the fuel). The first dab whose
+  fuel reaches `threshold` (default `0.1`) fires immediately so a single tap works; further blasts
+  fire every `blastSpacing` tip diameters (default `2`) of travel over paint. Over bare canvas,
+  `blasts` is `0`, `bounds` is `null`, and no undo step is recorded.
+- **Heat field and single inversion.** Each blast writes a noise-edged radial profile (`0..1`) into
+  one stroke-wide `heat` field shared across all layers and combined by **maximum**, so overlapping
+  blasts in the same stroke invert the core once instead of cancelling back.
+- **What changes on each visible editable layer.** Each target layer is recomposited from its own
+  pre-stroke pixels:
+  - **Core (`heat` > 0.55)**: inverts the layer's colours (`invert` `0..1`, `invertMode` `'rgb'` or
+    `'oklab'` — `oklab` flips lightness and hue so mid-grey `#808080` visibly changes too) and
+    destroys `annihilate` (`0..1`, default `0.25`) of its alpha (unless `locks.transparency` is on,
+    which preserves alpha while inverting colour).
+  - **Ring (`heat` 0.12..0.68)**: darkens and desaturates paint towards soot (`scorch` `0..1`,
+    default `0.6`).
+  - **Thick paint (`doc.thick`)**: on layers with impasto relief, the core lowers `height` and raises
+    a rim around the blast (`crater` `0..1`, default `0.5`).
+  - **Light paint (`doc.light`)**: blasts clear existing light in the core across target layers.
+  - Light and relief the blasts don't reach stay exactly as they were, including on a layer whose
+    pixels change elsewhere.
+- **Active layer extras.** Bare-canvas soot fade and ballistic sparks (`sparks` `0..1`, `sparkReach`
+  `0.5..8` tip diameters) land on the **active layer only**, starting white-hot and cooling into the
+  stroke's paint colour (or gradient / effect paint). When `light.amount > 0` (`antimatter-flare`),
+  sparks also write glowing trails to the active layer's `doc.light`. Mask stencils contain the
+  blast and sparks.
+- **Locked, stroke and sticker layers.** Uneditable visible layers (`locks.pixels`, stroke layers,
+  sticker layers, effect layers) still count as fuel so blasts fire over them, stay unchanged, and
+  are reported in `antimatter.skippedLayers`.
+- **Single undo step and replay.** Any visible wet paint dries first in the same undo step, and all
+  changed layers commit together. `RecordedStroke.targets` records the stroke's **fuel layers** (every
+  visible pixel layer when it was painted, locked and stroke layers included). `replay_strokes` and
+  replays read fuel from exactly those layers, even if they are hidden now, and change the editable
+  ones. Layers added later are neither fuel nor changed. Passing `layerId` to `replay_strokes`
+  drops the recorded targets and uses the layers visible now.
+- **Presets.**
+  - `antimatter`: balanced blast (`blastRadius` 2.5, `scorch` 0.6, `annihilate` 0.25, `sparks` 0.5).
+  - `antimatter-flare`: bright spark burst with glowing light trails (`sparks` 0.9, `sparkReach` 4.5,
+    `annihilate` 0.1, `light.amount` 0.7).
+  - `antimatter-charge`: wide, deep craters spaced farther apart (`blastRadius` 4, `blastSpacing` 3.5,
+    `annihilate` 0.45, `crater` 0.8, `invertMode: "oklab"`).

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

@@ -17,6 +17,7 @@ more; this is where each one went.
 | Impasto (thickness, gloss, metallic, rim, clarity…) | `behaviour.surface` `thick` and `behaviour.thick` |
 | Particle settings | `marks` `{ kind: 'particles', physics, render, count… }`; textured dots are `tip.stamps` on a `stamp` tip |
 | Sticker spray | `marks` `{ kind: 'objects', density… }` and `tip.stamps` (sticker refs) |
+| Antimatter blasts | `marks` `{ kind: 'antimatter', blastRadius, blastSpacing, threshold, invert, invertMode, scorch, annihilate, sparks, sparkReach, crater, duration }` |
 | 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`) |