@pixerate/editor 0.249.0 → 0.250.0

package/dist/video-editor/index.js

@@ -1,6 +1,6 @@
 import {
   createEffectAuthoringSession
-} from "../chunk-AU6MWQKZ.js";
+} from "../chunk-ABL7IWFZ.js";
 import {
   VIDEO_ADJUSTMENT_SCOPES,
   VIDEO_BLEND_MODES,
@@ -149,7 +149,7 @@ import {
   videoTransitionEase,
   videoValueAt,
   videoWipeRect
-} from "../chunk-L3JFOTBQ.js";
+} from "../chunk-5E2Q7ZHI.js";
 import {
   namedWithSuggestion
 } from "../chunk-EUKY4KFX.js";
@@ -159,7 +159,7 @@ import {
   effectSequenceTiming,
   effectTemplateTools,
   fillEffectTemplate
-} from "../chunk-RXZL4NG5.js";
+} from "../chunk-226QDRO3.js";
 import "../chunk-EHLOCVWB.js";
 import {
   CAMERA_MOVE_MAX_MS,
@@ -171,7 +171,7 @@ import {
   pathControlsOf,
   resolveCameraMoveSpec,
   sampleEffectCameraMove
-} from "../chunk-OFH6Q67U.js";
+} from "../chunk-JA57JIT5.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   defineEditorDocument

package/package.json

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

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

@@ -341,7 +341,7 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | `mix_colors` | Read-only. Mix 1 to 16 `colors` (`{color: #rrggbb, weight, strength?}`) like paint (Kubelka-Munk over reflectance spectra). Returns `mixed` (#rrggbb), `rgbLerp` (the plain RGB average, for comparison) and the normalised `weights`. Call it before `paint_stroke` / `fill_pixels` to pick a paint colour. |
 | `clear_pixels` | Remove the selected pixels (alpha to 0; a transparency-locked layer or a mask gets the background colour). Returns the changed bounds. |
 | `import_psd` | Open a PSD / PSB (`data` base64, a `data:` URL is fine) as the document, replacing the layers, crop and rotation (one undo step). Returns the new `layers` tree with ids, `layerIds`, size and `warnings` naming the affected layers. Call `inspect_psd` first when losses matter. |
-| `apply_effect` | Run a provider filter effect on a layer as a smart filter (`target`, `effect`, `values`, `index`, `enabled`, `opacity`, `blend`); a pixel, shape or type layer becomes a smart object in the same undo step (`converted`). It keeps the layer's transparency (`preserveTransparency`, default true: the result is drawn over the layer and takes its alpha); `false` lets a shader fill transparent pixels. With a selection the filter mask is set from it (`masked`): deselect first to filter the whole layer. Returns the filter id and `preserveTransparency`. |
+| `apply_effect` | Run a provider filter effect, or any effect that takes a picture (the layer is its picture: a sticker from `insert_sticker` into a holo-foil treatment), on a layer as a smart filter (`target`, `effect`, `values`, `index`, `enabled`, `opacity`, `blend`); a pixel, shape or type layer becomes a smart object in the same undo step (`converted`). It keeps the layer's transparency (`preserveTransparency`, default true: the result is drawn over the layer and takes its alpha); `false` lets a shader fill transparent pixels. With a selection the filter mask is set from it (`masked`): deselect first to filter the whole layer. Returns the filter id and `preserveTransparency`. |
 | `update_effect` | Change an effect smart filter (`values` merged, `null` resets; `enabled`, `opacity`, `blend`, `preserveTransparency`, `index`) or redraw an effect layer (`effect: "generator"`, values only). Returns the filter as it is now. |
 | `remove_effect` | Remove an effect smart filter, or (`generator`) keep an effect layer's pixels as a plain layer. |
 | `add_effect_layer` | Add a layer drawn by a generator, overlay or title effect at the document's size and bit depth (`values`, `time`, `animate`, `name`, `aboveId` / `belowId`, `opacity`, `blend`, `clipped`). `clipped: true` clips it to the layer directly below in the same undo step, so it shows only over that layer's pixels (refused when nothing is below it in its group). An effect with its own background (`backgroundOpacity` in `describe_effect`) starts with it transparent when there are layers below. Returns the layer id and `clipped`. |

package/skills/pixerate-stickers/SKILL.md

@@ -20,9 +20,15 @@ none, it is the editor's own stamps (`editorStickers()`: `editor:dot`, `editor:s
    it asks for), dominant colours, variants and outline.
 3. **Use.** Pass refs to the editor that places them: in the paint editor, a sticker brush
    (`set_brush` `sticker.stamps`, then `paint_stroke`) sprays them and `add_stickers` places
-   them exactly. A provider's art loads before it is drawn.
+   them exactly. In the vector, image and canvas editors, `insert_sticker` puts one in (`x`,
+   `y` centre, `width`): vector, a group of editable paths; image, a pixel layer; canvas, a
+   shape node from its outline in one colour. A provider's art loads before it is drawn.
 4. **Colour.** Tintable stickers (flat, single-colour art) take the paint colour or a sticker's
    `color`; the rest keep their own colours.
+5. **Treat it with an effect.** In the image editor, `insert_sticker` returns the layer `id`;
+   `apply_effect` with that `target` and any effect whose `describe_effect` inputs take an
+   image (`appliesHere`) uses the sticker as its picture (holo foil, cut-out). For a whole set,
+   repeat the two calls per sticker.
 
 ## Best practices
 
@@ -30,16 +36,22 @@ none, it is the editor's own stamps (`editorStickers()`: `editor:dot`, `editor:s
   and means `editor:star`.
 - Credit stickers whose licence has an `attribution` wherever the work is published.
 - Prefer tintable stickers when they must match a palette.
+- Vector stickers need SVG art and canvas stickers an outline (`silhouette`); `find_stickers`
+  lists `formats`, and `describe_sticker` the outline. The image editor takes either.
 
 ## Pitfalls
 
 - An unknown ref is refused with the closest refs: pick one of those or search again.
 - A category that the library doesn't have is refused with the list of its categories.
 - `limit` is 1..100; results beyond a page need `after`, not a larger limit.
+- `color` on a sticker that is not tintable is refused; leave it out.
+- On the canvas, multi-colour art becomes its outline in its dominant colour; for the art itself,
+  use the image editor (the vector and canvas editors take effects on stickers in a later change).
 
 ## Tool reference
 
 | Tool | Use |
 | --- | --- |
 | `find_stickers` | Search or list the library: `query`, `category`, `tags`, `commercial`, `limit`, `after`. Returns `items` (each `ref`, name, category, tags, width, height, formats, tintable, licence), `total`, `next`, `categories`. Changes nothing. |
+| `insert_sticker` | Put one sticker (`ref`) into the vector, image or canvas editor, centred at `x`, `y` (default the middle), `width` wide (default natural), tinted with `color` when tintable. One undo step. Returns the new group, layer or node `id`, the size and the licence. |
 | `describe_sticker` | One sticker by `ref`: everything `find_stickers` returns plus `silhouette` (SVG path data), `colours` and `variants`. Unknown refs are refused with the closest ones. Changes nothing. |