@pixerate/editor 0.275.1 → 0.277.0

package/dist/vector/index.js

@@ -35,7 +35,7 @@ import {
   traceField,
   traceVectorImage,
   vectorTraceContours
-} from "../chunk-75SYKUOT.js";
+} from "../chunk-N4MCWQZ7.js";
 import {
   rasterizeCoverage
 } from "../chunk-ADMRNWR7.js";
@@ -66,7 +66,7 @@ import {
   reverseMorphContour,
   subpathToMorphContour,
   turnMorphContour
-} from "../chunk-43XJC3PP.js";
+} from "../chunk-DWPFGWW5.js";
 import {
   DEFAULT_VECTOR_FONT,
   IDENTITY_MATRIX,
@@ -556,10 +556,10 @@ import {
   withVectorStrokes,
   withVectorTargetPaint,
   zigzagPaths
-} from "../chunk-Y2ISSVPH.js";
+} from "../chunk-HHX7ST6Z.js";
 import {
   snapshotBrushLibrary
-} from "../chunk-ZM7IKQ4X.js";
+} from "../chunk-PPDUCZZV.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.1",
+  "version": "0.277.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",

package/skills/pixerate-brushes/SKILL.md

@@ -24,6 +24,7 @@ built-in presets (read-only) and the user's brushes, shared by every editor that
 | Thermochromic | Heat-reactive ink (`hotColor` `#rrggbb`, `threshold` 0.05..0.95) that shifts colour where the paint editor's heat brush warms the canvas (preset `thermo-ink`). |
 | 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`. |
+| Ferro | Liquid magnetic ferrofluid (`amount` 0..1, capillary `wavelength` 4..64 px, `threshold` 0..1; presets `ferrofluid`, `ferro-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. |

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

@@ -11,35 +11,10 @@ seed: its grain is a height map (peaks and valleys) that grain-responsive brushe
 is never part of a layer. Coordinates are document pixels, (0, 0) top-left, y down. See
 `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.
-- **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, 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).
-- **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.
+- **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.
+- **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).
+- **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
   skips the valleys. Pencil, pastel and charcoal are grainy; airbrush, marker and ink are not.
   A brush can also carry its own texture, `tip.grain` (a pattern such as `sanded` or `canvas`, or
@@ -126,6 +101,7 @@ in wet paint and freeze when it dries; presets `turing-wash`, `coral-ink`):
 
 Wet oil blends where the brush meets it; impasto adds relief lit by `set_lighting`, and `iridescence` (`scarab-lacquer`, `soap-film`, `pearl-glaze`) adds thin-film structural colour that shifts hue with light and `set_view_tilt`: load `pixerate-paint-oil-impasto` and read [references/oils.md](references/oils.md). **Light paint** (neon, glowing glass and watercolour: `light.amount`, the Light category; backlit paper): [references/light-paint.md](references/light-paint.md).
 **Smart inks** (`fluorescence` for UV/invisible ink under `set_uv_light`, `thermochromic` for heat-reactive ink with `paint_heat` / `advance_heat`; presets `uv-marker`, `thermo-ink`): [references/smart-inks.md](references/smart-inks.md).
+**Ferrofluid paint** (`ferro.amount`, presets `ferrofluid` and `ferro-ink`, pulled by dipole magnets into lit Rosensweig spikes until cured): [references/ferrofluid.md](references/ferrofluid.md).
 
 ## Gradient paint
 
@@ -336,6 +312,12 @@ Listing, saving, sharing and previewing brushes are the brush library's tools (`
 | `advance_heat` | Step thermal diffusion and Newtonian cooling by `steps` (1..200, default 10) so warm patches spread and fade. Not an undo step. Returns `steps`, heat stats and `dried`. |
 | `clear_heat` | Cool the entire canvas heat field back to 0 at once so thermochromic paint returns to its cold colour. One undo step when warm. Returns `{ cleared }`. |
 | `get_heat` | Read the canvas heat stats (`max`, `mean`, `hotCells`, `bounds`), optional temperature `samples` at `points`, and `thermochromicLayerIds`. Changes nothing. |
+| `add_magnet` | Place a dipole magnet at `x`, `y` (document px; `strength` -1..1 default 0.8, `radius` 4..2048 px default 80): liquid ferrofluid gathers toward it and rises into hexagonal Rosensweig spikes shaded by `set_lighting`. One undo step. Returns the magnet (`id`, `x`, `y`, `strength`, `radius`). |
+| `update_magnet` | Move or tune a magnet by `id` (`x`, `y`, `strength`, `radius`): liquid ferrofluid gathers and spikes update at once. One undo step. Returns the magnet. |
+| `remove_magnets` | Remove magnets by `ids` (or all when omitted): uncured ferrofluid relaxes, cured relief stays. One undo step. Returns `removed`. |
+| `list_magnets` | List the canvas magnets (`id`, `x`, `y`, `strength`, `radius`). Changes nothing. |
+| `get_ferrofluid` | Read a layer's liquid ferrofluid and live spikes (`ferro`, `bounds`, `peak`, `coverage`, `activeSpikeArea`, `maxSpikeHeight`, `magnetCount`, `wavelength`, `threshold`). Changes nothing. |
+| `cure_ferrofluid` | Bake a layer's current magnetic spikes into solid impasto height and dark glossy material, clearing its liquid ferrofluid so magnet edits no longer change it. One undo step. Returns `layerId`, `cured`, `bounds`, `maxSpikeHeight`, `activeSpikeArea`. |
 
 ### Stickers
 

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

@@ -25,6 +25,7 @@ more; this is where each one went.
 | 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 |
 | Ghost paint (linger, smear) | `ghost` (`linger`, `smear`); `unset: ['ghost']` drops it |
+| Ferrofluid | `ferro` (`amount` 0..1 or numeric shorthand, `wavelength` 4..64 px, `threshold` 0..1); `unset: ['ferro']` drops it |
 
 ## Examples
 

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

@@ -0,0 +1,36 @@
+# Ferrofluid paint
+
+Ferrofluid paint is liquid magnetic paint (`ferro.amount` above 0 on any dab, particle, bristle,
+Mixer Brush or impasto brush; presets `ferrofluid` and `ferro-ink`). Place dipole magnets on the
+canvas (`add_magnet`), and the liquid paint gathers toward the magnets and rises into hexagonal
+Rosensweig relief spikes along the magnetic field lines, shaded live by `set_lighting`. The paint
+stays liquid and responds to magnet moves until `cure_ferrofluid` bakes the spikes into solid
+impasto relief.
+
+- **How it works.** Each layer keeps a liquid ferrofluid channel (`doc.ferro[layerId]`) alongside
+  its colour and impasto relief, and the document keeps dipole magnets (`doc.magnets`: `x`, `y`,
+  `strength` `-1..1`, `radius` `4..2048` px). At render time, wherever a pixel has liquid
+  ferrofluid (`ferro > 0`) and the analytical dipole field $|\mathbf{B}|$ exceeds the layer's
+  critical `threshold`, the surface rises into a hexagonal Rosensweig lattice of spikes spaced by
+  the capillary `wavelength` (4..64 px, default 14 px) with amplitude $\propto \sqrt{1 - B_c / |\mathbf{B}|} \times \text{ferro}$
+  and tilted along the horizontal component of $\mathbf{B}$.
+- **Shading and material.** The spikes feed directly into the impasto lighting pass (`lightTile` /
+  `set_lighting`). Where a layer has no explicit impasto material of its own, liquid ferrofluid
+  gives it a dark glossy metallic carrier finish (`gloss` 0.88, `metallic` 0.65, `rim` 0.25) and
+  deepens the colour toward `#111827`, so grazing light (`set_lighting` `elevation` 20..35) catches
+  crisp specular highlights on every spike tip.
+- **Gathering toward magnets.** Adding (`add_magnet`) or moving/tuning (`update_magnet`) a magnet
+  runs deterministic advection steps on every layer's liquid ferrofluid along $\nabla |\mathbf{B}|$,
+  so painted pools visibly pull toward nearby poles.
+- **Moving vs curing.** While uncured, moving or removing magnets (`update_magnet`,
+  `remove_magnets`) immediately reshapes or relaxes the spikes. Call `cure_ferrofluid` when a
+  layer's spike crown is right: it bakes the current spike height and dark glossy material into
+  the layer's permanent impasto relief (`doc.thick[layerId]`) and clears `doc.ferro[layerId]` in
+  one undo step, so later magnet changes leave that layer untouched.
+- **Brush facet.** Pass `ferro: 0.85` or `ferro: { amount: 0.85, wavelength: 14, threshold: 0.18 }`
+  to `set_brush` or per-stroke `paint_stroke` `brush`; `unset: ["ferro"]` turns it off.
+  - `ferrofluid`: thick, glossy dark ferrofluid pool (`wavelength` 14 px, `threshold` 0.18).
+  - `ferro-ink`: crisp calligraphic ferrofluid ink with finer spikes (`wavelength` 10 px,
+    `threshold` 0.15).
+- **Refusals.** Wet brushes, sticker sprays and stroke layers refuse `ferro.amount > 0`, naming
+  the fix (`ferrofluid` / `ferro-ink` on a pixel layer).