@pixerate/editor 0.269.2 → 0.271.0

package/dist/video-editor/index.js

@@ -1,6 +1,6 @@
 import {
   createEffectAuthoringSession
-} from "../chunk-GBEF2D4P.js";
+} from "../chunk-23YL2EAB.js";
 import {
   VIDEO_ADJUSTMENT_SCOPES,
   VIDEO_BLEND_MODES,
@@ -149,7 +149,7 @@ import {
   videoTransitionEase,
   videoValueAt,
   videoWipeRect
-} from "../chunk-MWUZCEFT.js";
+} from "../chunk-S2XPXA47.js";
 import {
   namedWithSuggestion
 } from "../chunk-EUKY4KFX.js";
@@ -160,7 +160,7 @@ import {
   effectTemplateTools,
   fillEffectTemplate
 } from "../chunk-DHQPRKXF.js";
-import "../chunk-EHLOCVWB.js";
+import "../chunk-T2URHAJX.js";
 import {
   CAMERA_MOVE_MAX_MS,
   EffectsSlot,
@@ -179,7 +179,7 @@ import {
 import "../chunk-HF5QZS7Z.js";
 import {
   HistoryManager
-} from "../chunk-NS62CQ2B.js";
+} from "../chunk-GAZPHCTV.js";
 import {
   AnimationPlayer
 } from "../chunk-F6R67I3A.js";

package/package.json

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

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

@@ -235,7 +235,7 @@ When to use which:
 | The effect in a wash that flows, or in thick paint | `set_effect_paint` and a watercolour, gouache, oil or impasto brush |
 | The effect inside an exact shape, unchanged by water | Paint the shape, dry it, then `fill_layer_with_effect` with `lockTransparency: true` |
 | The effect over the whole sheet | `set_paper_effect` or `add_effect_layer` |
-| A pattern that follows the stroke, or paint that moves | `map: { by: "stroke" }`, `live: true` on a stroke layer |
+| A pattern that follows the stroke, or paint that moves | `map: { by: "stroke" }` (bends any effect as a strip), or `map: { by: "path" }` for effects with a path control (`accepts: ["path"]`: beams, trails, signatures); `live: true` on a stroke layer |
 
 ## Canvas-hosted layer
 
@@ -394,7 +394,7 @@ Listing, saving, sharing and previewing brushes are the brush library's tools (`
 | `set_paper_effect` | Draw a generator over the paper (`values`, `opacity`, `blend` default `multiply`, `time`); `effect: null` removes it. One undo step. Returns the effect paper. |
 | `add_effect_layer` | Add a layer drawn by a generator, overlay or title effect (`values`, `name`, `aboveId`, `opacity`, `blend`, `time`); it becomes active. Returns the layer and its effect. |
 | `fill_layer_with_effect` | Composite a generator, overlay or title effect onto a layer (`layerId`, `values`, `opacity`, `lockTransparency`, `time`). One undo step. Returns the layer id and the effect. |
-| `set_effect_paint` | Paint with a generator, overlay or title effect (`effect`, `values`, `time` ms default 0): rendered once at the canvas size, strokes take each pixel's colour from it; `map` `{ by: "stroke", length, repeat }` lays it along each stroke; `live` keeps it playing on stroke layers. Call after `describe_effect`, then `paint_stroke`. Editor state, not an undo step. Returns `effectPaint`. |
+| `set_effect_paint` | Paint with a generator, overlay or title effect (`effect`, `values`, `time` ms default 0): rendered once at the canvas size, strokes take each pixel's colour from it; `map` `{ by: "stroke", length, repeat }` bends a strip along each stroke, or `{ by: "path" }` passes the stroke's centreline to an effect with a path control (`format: "svg-path"`, `accepts: ["path"]`); `live` keeps it playing on stroke layers. Call after `describe_effect`, then `paint_stroke`. Editor state, not an undo step. Returns `effectPaint`. |
 | `set_effect_playback` | Play or pause live effect paint in the view (`playing`) and cap its frame rate (`fps` 1..60). Editor state. Returns `playing`, `fps`, `time` and `animation` (what plays, or null). Export a moment with `export_image` / `export_psd` `time`. |
 
 ### Guides

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

@@ -1,14 +1,36 @@
 # Effect paint along the stroke, and live effect paint
 
-- **Along the stroke** (`set_effect_paint` `map: { by: "stroke", length, repeat }`): the effect is
-  rendered as a strip `length` px long (16..4096, default 300) and 256 px across. Each pixel takes
+- **Along the stroke (native path)** (`set_effect_paint` `map: { by: "path" }`): when an effect has
+  a path control (`format: "svg-path"`, reported by `describe_effect` as `pathControls` and
+  `accepts: ["path"]`), each stroke passes its centreline `[x0, y0, x1, y1, …]` in canvas pixels
+  directly to that control and renders at the canvas size. The effect draws and lights itself along
+  the stroke's exact curve (e.g. a neon beam, laser trail or signature whose glow and lighting
+  belong to the path), while the brush's dabs and coverage still decide where paint lands. Strokes
+  with more than 256 points are evenly resampled to 256 points rather than refused. **Prefer
+  `by: "path"` over `by: "stroke"` whenever the effect has a path control** (`accepts: ["path"]`);
+  `set_effect_paint` refuses `by: "path"` on effects without a path control and tells you to use
+  `by: "stroke"` or `by: "canvas"`. Each stroke is a render of its own at the canvas size, so:
+  - A stroke painted by hand shows the effect along the path drawn so far while it is drawn,
+    re-rendered one render at a time, so it trails the pen by about one render. It is painted
+    again along its whole path when the pen lifts, as one undo step; if the preview already
+    rendered the whole path, at once. On a slow provider the editor is busy until that lands
+    (`effectPaintRendering`). `paint_stroke` and `stroke_path` know the path up front and paint
+    it at once.
+  - Wet brushes can't be painted by hand this way, as the simulation can't run twice; give them
+    the points through `paint_stroke`, or use `by: "stroke"`.
+  - With `live: true`, every stroke is a live source of its own, so at most 8 can play.
+  - Symmetry copies sample the same render, which only follows the original stroke: paint each
+    copy as its own stroke if it should draw too.
+- **Along the stroke (strip)** (`set_effect_paint` `map: { by: "stroke", length, repeat }`): for
+  effects without a path control, the effect is rendered as a strip `length` px long (16..4096,
+  default 300) and 256 px across. Each pixel takes
   the colour at its distance along the stroke and its place across the tip, so the pattern follows
   the stroke's turns instead of staying fixed to the canvas. `repeat` starts the strip again
   (default), `mirror` runs it back, `clamp` holds the last colour. Use it for ribbons, ropes,
-  flames and textures that should flow with the mark; use the default canvas mapping to reveal one
-  hidden picture across many strokes. Every colour-laying brush takes it (watercolour, gouache, oil
-  and impasto too; sprayed stickers at their centre); particle and bristle marks take the place of
-  their pen dab.
+  flames and textures that have no path control of their own; use the default canvas mapping to
+  reveal one hidden picture across many strokes. Every colour-laying brush takes it (watercolour,
+  gouache, oil and impasto too; sprayed stickers at their centre); particle and bristle marks take
+  the place of their pen dab.
   Scaled replays (`export_high_res`) scale `length` with the canvas.
 - **Live** (`live: true`): on a stroke layer (`add_layer {type: "strokes"}`) each stroke keeps
   playing the effect, so the paint moves. Paint the strokes, then `set_effect_playback`