@pixerate/editor 0.237.0 → 0.238.0

package/dist/vector/index.js

@@ -26,7 +26,7 @@ import {
   traceField,
   traceVectorImage,
   vectorTraceContours
-} from "../chunk-XSVUNSDJ.js";
+} from "../chunk-UUBO6RB5.js";
 import {
   applyHomography,
   homographyFromPoints,
@@ -53,7 +53,7 @@ import {
   reverseMorphContour,
   subpathToMorphContour,
   turnMorphContour
-} from "../chunk-YMREOA67.js";
+} from "../chunk-XK4SST43.js";
 import {
   DEFAULT_VECTOR_FONT,
   IDENTITY_MATRIX,
@@ -526,8 +526,8 @@ import {
   withVectorStrokes,
   withVectorTargetPaint,
   zigzagPaths
-} from "../chunk-CU6ANS5L.js";
-import "../chunk-TQOL6CF7.js";
+} from "../chunk-7YGBSFC6.js";
+import "../chunk-PJYG6FCF.js";
 import {
   createProvenance
 } from "../chunk-M6DNZNVY.js";
@@ -584,13 +584,14 @@ import {
   HistoryManager
 } from "../chunk-RNSANXPT.js";
 import "../chunk-5UJHB3BW.js";
-import "../chunk-M2TPMYJE.js";
+import "../chunk-V6DT2CDH.js";
 import {
   hexToRgba
 } from "../chunk-2WPNAGHI.js";
-import "../chunk-7272D3K2.js";
-import "../chunk-YBAPT7NL.js";
-import "../chunk-MHLU6GRJ.js";
+import "../chunk-BP6KSGVD.js";
+import "../chunk-6ADHGQ73.js";
+import "../chunk-JEGJP4OW.js";
+import "../chunk-F67XMVDI.js";
 import "../chunk-6ONMQ6WF.js";
 
 // src/vector/stylize.ts

package/dist/video-editor/index.cjs

@@ -181,16 +181,17 @@ require('../chunk-2BSBFBOA.cjs');
 var _chunkFJ2MSI43cjs = require('../chunk-FJ2MSI43.cjs');
 
 
-var _chunkM5GLQQWGcjs = require('../chunk-M5GLQQWG.cjs');
+var _chunkLJZRHVZVcjs = require('../chunk-LJZRHVZV.cjs');
 
 
 
 var _chunkDWJJI6RTcjs = require('../chunk-DWJJI6RT.cjs');
-require('../chunk-4ZC5QJE2.cjs');
+require('../chunk-UTI5IITZ.cjs');
 require('../chunk-A6QWKBJP.cjs');
-require('../chunk-EUIDTZNQ.cjs');
-require('../chunk-TFF2GTGN.cjs');
-require('../chunk-5UEFBM2M.cjs');
+require('../chunk-7PT4RJL5.cjs');
+require('../chunk-PPFJHTW5.cjs');
+require('../chunk-RD7RX52G.cjs');
+require('../chunk-7AHBW2CQ.cjs');
 require('../chunk-IPJ3TEYR.cjs');
 
 // src/video-editor/parse.ts
@@ -3606,7 +3607,7 @@ var VideoEditorController = (_class7 = class _VideoEditorController {
     this.readOnly = _nullishCoalesce(options.readOnly, () => ( false));
     this.previewScale = checkPreviewScale(_nullishCoalesce(options.previewScale, () => ( "auto")));
     this.onChange = options.onChange;
-    this.player = new (0, _chunkM5GLQQWGcjs.AnimationPlayer)({ clock: options.clock, duration: () => _chunkZQIWBJGHcjs.videoProjectDuration.call(void 0, this.project), loop: "none" });
+    this.player = new (0, _chunkLJZRHVZVcjs.AnimationPlayer)({ clock: options.clock, duration: () => _chunkZQIWBJGHcjs.videoProjectDuration.call(void 0, this.project), loop: "none" });
     this.state = this.computeState();
     this.connect();
   }

package/dist/video-editor/index.js

@@ -181,16 +181,17 @@ import {
 } from "../chunk-RNSANXPT.js";
 import {
   AnimationPlayer
-} from "../chunk-F6R67I3A.js";
+} from "../chunk-CXXXAZ7H.js";
 import {
   CUBIC_BEZIER_PRESETS,
   evaluateEasing
 } from "../chunk-5UJHB3BW.js";
-import "../chunk-M2TPMYJE.js";
+import "../chunk-V6DT2CDH.js";
 import "../chunk-2WPNAGHI.js";
-import "../chunk-7272D3K2.js";
-import "../chunk-YBAPT7NL.js";
-import "../chunk-MHLU6GRJ.js";
+import "../chunk-BP6KSGVD.js";
+import "../chunk-6ADHGQ73.js";
+import "../chunk-JEGJP4OW.js";
+import "../chunk-F67XMVDI.js";
 import "../chunk-6ONMQ6WF.js";
 
 // src/video-editor/parse.ts

package/package.json

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

package/skills/pixerate-color/SKILL.md

@@ -33,6 +33,7 @@ the pitfalls, and uses the tools below.
    - Run `check_gradient` to audit for crowded stops, banding risk, out-of-gamut colours, and text contrast along the ramp.
    - Run `list_gradient_presets` and `apply_gradient_preset` to quickly set tested gradient compositions.
    - Modify gradient structure using `set_gradient`, `set_gradient_geometry`, `add_gradient_stop`, `update_gradient_stop`, `remove_gradient_stop`, `reverse_gradient`, or `distribute_gradient_stops`.
+   - To match a gradient in a picture, read colours along a line (the image editor's `sample_gradient`, or your own picks) and pass them to `set_gradient_from_samples`. Raise `tolerance` (or lower `maxStops`) for a cleaner ramp, lower it for a closer match; `maxError` says how close it got.
 
 ## Best practices
 
@@ -65,6 +66,7 @@ the pitfalls, and uses the tools below.
 | `remove_gradient_stop` | Removes a color stop by ID | `{ gradient, css }` |
 | `reverse_gradient` | Reverses the order and offsets of all stops | `{ gradient, css }` |
 | `distribute_gradient_stops` | Evenly distributes all color stops between 0 and 1 | `{ gradient, css }` |
+| `set_gradient_from_samples` | Fits the fewest stops to colours sampled along a line (noise smoothed first) and makes them the stops, keeping type and angle, interpolation oklab. One undo step. Use it after sampling a gradient from a picture | `{ gradient, css, stopCount, maxError }` |
 | `apply_gradient_preset` | Applies a built-in gradient preset by ID | `{ preset, gradient, css }` |
 
 ## Pitfalls
@@ -72,6 +74,7 @@ the pitfalls, and uses the tools below.
 - **`light-dark()` requires `color-scheme`.** CSS `light-dark()` only resolves the dark colour when `color-scheme: light dark;` is set on the element or an ancestor (such as `:root`). Without `color-scheme`, browsers always render the light colour.
 - **JavaScript resolution required for non-CSS targets.** Canvas 2D, WebGL, SVG presentation attributes, and raster image exporters cannot read `light-dark()` strings; resolve them in JavaScript with `resolveColor(value, scheme)`.
 - **Gamut clipping.** Colours specified in wide-gamut spaces (e.g. high-chroma OKLCH) will be mapped into sRGB for hex representations. Check `inSrgbGamut` if exact fidelity is required.
+- **Sampled gradients are smoothed.** A sharp edge along the sampled line (a horizon, a hard shadow) is softened by `smoothing` and fitted as a steep ramp; pass `smoothing: 0` and a lower `tolerance` to keep it close to a step.
 - **Large text thresholds.** WCAG allows 3:1 for large text (18pt / 24px or 14pt / 18.5px bold); pass `large: true` to avoid overly aggressive contrast suggestions.
 - **Geometry fields depend on the type.** To make a radial circle, send `type: "radial"` and `shape: "circle"` in the same `set_gradient_geometry` call; sending `shape` to a linear gradient is an error.
 - **Ramp steps bounds.** `blend_colors` requires `steps` to be between 2 and 32 when generating a ramp.

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

@@ -312,6 +312,7 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | `paint_stroke` | Paint (`tool` brush), blend with the Mixer Brush (`tool` mixer) or erase (`tool` eraser) along `points` in document px (optional `pressure` 0..1) on a pixel layer or its mask (`channel`; the mixer paints pixels only); `color` #rrggbb (on a mask: black hides, white reveals; for the mixer, the reservoir colour) or `paint` (brush only: a gradient for this stroke); `brush` `{size, hardness, spacing, angle, roundness, opacity, flow, smoothing, pressureSize, pressureOpacity, blend}`; `mixer` `{wet, load, mix, loadEachStroke, cleanEachStroke, mixing: rgb \| pigment}` (tool mixer only). The selection limits the paint. One undo step per call. Returns the layer, channel, changed `bounds`, dab count and, for the mixer, `mixerLoad` `{reservoir, amount, pickup}`. |
 | `set_paint` | Set what the brush paints: one colour (it becomes the foreground) or gradient paint (`stops` sorted by offset, `space` pigment / oklab / srgb, `map`, `softness`). Errors say what is wrong. Returns `paint`, `foreground`, `background`, `brush`. |
 | `sample_color` | The Eyedropper: read the composite colour at a document point (`size` averages a square; default 1 px) and, unless `setForeground` is false, make it the paint foreground. Use it to match a colour already in the image before painting or retouching. Fails outside the canvas or on transparent pixels. Returns `color` and `foreground`. |
+| `sample_gradient` | Read the composite along a line (`start` → `end`, document pixels) and fit the fewest gradient stops to it (`tolerance` OKLab ΔE, `maxStops`, `sampleSize` averaging, `snapStep`). Changes nothing. Returns a linear `gradient` (angle of the line, oklab), its `css` and `pointsRead`. Use it to match a sky, a backdrop or a light falloff before painting a gradient or styling one. |
 | `get_paint` | Read-only. What the brush paints (`paint`), the foreground and background colours and the brush settings. |
 | `get_mixer_brush` | Read-only. The Mixer Brush settings and what it carries (`reservoir` #rrggbb or null, `amount` left 0..1, `pickup` #rrggbb or null). Call it before a mixer stroke with `loadEachStroke: false`. |
 | `load_mixer_brush` | Fill the Mixer Brush reservoir with `color` (default the foreground), amount 1; keeps the pickup. View state, not an undo step. Use before strokes with `loadEachStroke: false`. Returns the load. |

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

@@ -197,8 +197,10 @@ Paint that changes colour as the stroke goes: give a gradient where a colour wou
   bend into curves at turns; a low `bristle.load` runs dry into broken streaks.
 - **Sticker spray** (category `sticker`): stamps (`star`, `leaf`, `confetti`, `flower`, `heart`,
   `splat`, `sparkle`, `ring`, `dot`) sprayed along the stroke onto an **empty layer**, where each
-  stays an object: `list_stickers`, `update_sticker` (move, turn, resize, recolour, restamp),
-  `arrange_stickers`, `remove_stickers`. A sticker layer takes no other paint.
+  stays an object: `add_stickers` (place them exactly), `sticker_at` (pick one by point), `list_stickers`, `update_sticker` (move, turn, resize, recolour, restamp),
+  `arrange_stickers`, `remove_stickers`. A sticker layer takes no other paint. Stickers are drawn
+  whole, so a spray is refused while a mask stencil is on: hide it (`update_stencil` `enabled`
+  false) first, then remove the stickers you don't want.
 - **Stencils**: `add_stencil` lays a `ruler` or `arc` (strokes that start within `snap` px follow
   it exactly: straight lines, circles, rainbows) or a `line` / `shape` mask (paint lands only on
   one side or inside a rect, ellipse or polygon; `invert` for outside). Stencils stay until
@@ -367,6 +369,8 @@ view), so work with the tools you are given.
 | Tool | Use |
 | --- | --- |
 | `list_stickers` | Read a layer's stickers bottom first: id, stamp, x, y, size, rotation, color, opacity. |
+| `add_stickers` | Place stickers exactly (`stamp`, `x`, `y`, optional `size`, `rotation`, `color`, `opacity`, `seed`) on a sticker layer or an empty layer. Use it for deliberate placement, a sticker brush for a scatter. One undo step. Returns the new stickers with ids. |
+| `sticker_at` | Read the top-most sticker under a point (`x`, `y`), or null. Use it to pick one sticker among many similar ones before `update_sticker`, `arrange_stickers` or `remove_stickers`. |
 | `update_sticker` | Change one sticker by `id`: `stamp`, `x`, `y`, `size`, `rotation`, `color`, `opacity`. One undo step. Returns it. |
 | `arrange_stickers` | Move stickers (`ids`) to the `front` or `back` of their layer. One undo step. |
 | `remove_stickers` | Delete stickers by `ids`, or all on the layer. One undo step. |