@pixerate/editor 0.242.0 → 0.243.0

package/dist/vector/index.js

@@ -26,7 +26,7 @@ import {
   traceField,
   traceVectorImage,
   vectorTraceContours
-} from "../chunk-UDBDYZET.js";
+} from "../chunk-H4Z72Z4Z.js";
 import {
   applyHomography,
   homographyFromPoints,
@@ -53,7 +53,7 @@ import {
   reverseMorphContour,
   subpathToMorphContour,
   turnMorphContour
-} from "../chunk-ZDPLZDTT.js";
+} from "../chunk-4ZHXLFXS.js";
 import {
   DEFAULT_VECTOR_FONT,
   IDENTITY_MATRIX,
@@ -526,8 +526,8 @@ import {
   withVectorStrokes,
   withVectorTargetPaint,
   zigzagPaths
-} from "../chunk-ILM6GYAX.js";
-import "../chunk-XBZK47LV.js";
+} from "../chunk-6L3WWIDW.js";
+import "../chunk-HQZHOPNE.js";
 import {
   createProvenance
 } from "../chunk-M6DNZNVY.js";

package/package.json

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

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

@@ -159,8 +159,9 @@ read [references/wet-media.md](references/wet-media.md) for the engine and the w
 
 ## Oils and thick paint
 
-Wet oil barely flows and blends where the brush meets it; impasto brushes add relief lit by
-`set_lighting`. Load `pixerate-paint-oil-impasto`, and read [references/oils.md](references/oils.md).
+Wet oil blends where the brush meets it; impasto adds relief lit by `set_lighting`: load
+`pixerate-paint-oil-impasto` and read [references/oils.md](references/oils.md). **Light paint**
+(neon, glowing glass: `light.amount`, the Light category): [references/light-paint.md](references/light-paint.md).
 
 ## Gradient paint
 
@@ -261,12 +262,8 @@ When to use which:
 
 ## Canvas-hosted layer
 
-A host can mount the painting as a layer of a larger canvas (`createPaintEditorToolProvider` with
-`origin`). Then every position you pass or read back is a canvas coordinate, not a document
-pixel: stroke points, picks, bounds, guides, stencils, stickers and wet areas alike.
-`get_canvas_info` `bounds` says where the painting lies on that canvas; paint inside it. The
-host may leave out tools it owns (`new_canvas`, `set_canvas`, `extend_canvas`, exports, the
-view), so work with the tools you are given.
+When `get_canvas_info` has `bounds`, the painting is a layer of a larger canvas and every position
+is a canvas coordinate: read [references/canvas-hosted.md](references/canvas-hosted.md).
 
 ## Tool reference
 
@@ -375,7 +372,10 @@ view), so work with the tools you are given.
 | --- | --- |
 | `set_lighting` | Move the light for thick paint and metallic paper: `azimuth` (degrees clockwise from the top), `elevation` (5..90), `relief` (0..1). Nothing is repainted; not an undo step. Returns the lighting. Use a low elevation to show brushwork. |
 | `get_relief` | Read a layer's relief (`bounds`, `maxHeight` 0..255, null when flat) and the lighting. Changes nothing. |
-| `flatten_relief` | Remove a layer's relief and material, keeping its colour. One undo step. Returns whether anything was flattened. |
+| `flatten_relief` | Remove a layer's relief and material (rim and clarity too), keeping its colour and light. One undo step. Returns whether anything was flattened. |
+| `get_light` | Read a layer's light paint: `hasLight`, `bounds`, `peak` 0..255 and its `spill`. Changes nothing. |
+| `set_light_spill` | How far a layer's light spills (`radius` px, 0 off) and how strongly (`strength` 0..2). Not an undo step; nothing is repainted. |
+| `clear_light` | Take a layer's light away, keeping its colour. One undo step. |
 
 ### Stickers
 

package/skills/pixerate-paint-editor/references/canvas-hosted.md

@@ -0,0 +1,8 @@
+# Canvas-hosted layer
+
+A host can mount the painting as a layer of a larger canvas (`createPaintEditorToolProvider` with
+`origin`). Then every position you pass or read back is a canvas coordinate, not a document
+pixel: stroke points, picks, bounds, guides, stencils, stickers and wet areas alike.
+`get_canvas_info` `bounds` says where the painting lies on that canvas; paint inside it. The
+host may leave out tools it owns (`new_canvas`, `set_canvas`, `extend_canvas`, exports, the
+view), so work with the tools you are given.

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

@@ -0,0 +1,31 @@
+# Light paint
+
+Light paint is paint that gives off light: neon, light painting, glow-in-the-dark, glowing glassy
+tubes. Any dab, particle, bristle, Mixer Brush or impasto brush lays it with `light.amount` above 0
+(`set_brush`); the Light category presets are ready-made (`glow-gel`, `neon-marker`,
+`light-airbrush`, `spark-trail`).
+
+- **What it does.** Each layer keeps a light channel next to its colour. The light's colour is the
+  paint's colour at that pixel, so recolouring paint recolours its light. It glows (the paint
+  itself is brighter, whatever `set_lighting` says) and spills onto everything around and below it
+  in each stroke's own colour.
+- **It behaves like paint.** Plain paint over glowing paint dims it; erasers remove it; smudges,
+  blenders, the knife, the Mixer Brush and pick-up brushes carry it with the colour they move. A
+  smeared neon line glows along the smear. `clear_light` takes it away and keeps the colour.
+- **Spill** (`set_light_spill`, per layer): `radius` px (default 24; 0 turns it off) and
+  `strength` 0..2 (default 1). It is not an undo step and repaints nothing; it shows the
+  painting as committed, so a stroke's spill appears when the stroke ends. It spills onto
+  everything below, paper included, so it reads best on dark paper (`set_paper` colour).
+- **Glassy beads** (impasto): `impasto.rim` makes a bead's light stronger at its edges, where its
+  surface turns away (backlit glass); `impasto.clarity` lets the middle of a bead show the layers
+  below while its edges stay solid. `glow-gel` uses both: paint loops with a distance-mapped
+  gradient (`set_paint`) for glowing glass tubes.
+- **Crossings.** Beads on one layer fuse where they cross (their heights combine by maximum), so
+  clarity only shows other layers: paint one loop per layer for glassy crossings.
+- **Spill vs a glow layer style.** Spill takes each stroke's colour and strength. For a one-colour
+  halo around everything on a layer, use a blend or an effect layer instead.
+- **Not yet:** wet brushes (glowing watercolour is planned, #494), sticker sprays and stroke layers
+  refuse light above 0, with the alternatives.
+- **PSD.** `export_psd` writes each layer's pixels with their glow, and its spill as a
+  "‹layer› light" Linear Dodge (Add) layer directly above it. Re-importing gives plain pixel
+  layers, not editable light.

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

@@ -66,6 +66,7 @@ This skill is the method. `pixerate-paint-editor` has the full tool reference an
 | Scraped, smeared texture | `palette-knife` |
 | Blobs of paint straight from the tube | `paint-tube` |
 | A glossy bead or line | `gloop-pen` |
+| 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 `impasto.load` |
 | A metallic highlight | `metallic-paint` |
 | Paint that stays exactly as laid | `set_instant_dry` on |