@pixerate/editor 0.248.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.248.0",
+  "version": "0.250.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",
@@ -334,6 +334,16 @@
         "default": "./dist/effects/index.cjs"
       }
     },
+    "./stickers": {
+      "import": {
+        "types": "./dist/stickers/index.d.ts",
+        "default": "./dist/stickers/index.js"
+      },
+      "require": {
+        "types": "./dist/stickers/index.d.cts",
+        "default": "./dist/stickers/index.cjs"
+      }
+    },
     "./diagram": {
       "import": {
         "types": "./dist/diagram/index.d.ts",

package/skills/README.md

@@ -29,6 +29,7 @@ model and its general practice.
 | [`pixerate-effect-authoring`](pixerate-effect-authoring/SKILL.md) | Authoring shaders and procedural effects: inspecting parameters and source code, setting values and presets, keyframing animation tracks, playback timing, and previewing. |
 | [`pixerate-color`](pixerate-color/SKILL.md) | Colour inspection, WCAG accessibility and contrast optimization, CVD simulation, palette audits, harmonies, and OKLab/OKLCH blends. |
 | [`pixerate-typography`](pixerate-typography/SKILL.md) | Fonts and fallback stacks, font loading, modular type scales and hierarchies, fluid sizes, readability and type-aware contrast audits, text segmentation, the font picker. |
+| [`pixerate-stickers`](pixerate-stickers/SKILL.md) | Sticker libraries: finding stickers by ref (`provider:id`), categories, tags, tintable art and licences, for the editors that spray or place them. |
 
 ## Workflow skills
 

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-paint-editor/SKILL.md

@@ -184,8 +184,9 @@ inner glow, shadows, stroke, bevel, satin and overlays, as in the image editor
 - **Bristle brushes** (category `bristle`): `bristle-round`, `bristle-flat`, `dry-brush`. Every
   bristle draws its own line: press harder to splay the tuft, tilt to flatten it; soft bristles
   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 onto an **empty layer**, each staying an object:
+- **Sticker spray** (category `sticker`): stickers by ref (`editor:star`, `editor:leaf`… or any
+  from the host's library: `find_stickers`; tintable ones take the paint colour) sprayed onto an
+  **empty layer**, each staying an object:
   `add_stickers` (exact places), `sticker_at`, `list_stickers`, `update_sticker`, `arrange_stickers`,
   `remove_stickers`. A sticker layer takes no other paint; sprays are refused under an enabled
   mask stencil (hide it with `update_stencil` `enabled` false, then remove unwanted stickers).
@@ -372,10 +373,12 @@ is a canvas coordinate: read [references/canvas-hosted.md](references/canvas-hos
 
 | 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. |
+| `list_stickers` | Read a layer's stickers bottom first: id, `ref` (and `stamp` for the editor's own), x, y, size, rotation, color, opacity. |
+| `add_stickers` | Place stickers exactly (`ref` from `find_stickers`, `x`, `y`, optional `size`, `rotation`, `color`, `opacity`, `seed`) on a sticker layer or an empty layer; a provider's art loads first. 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. |
+| `update_sticker` | Change one sticker by `id`: `ref`, `x`, `y`, `size`, `rotation`, `color`, `opacity`. One undo step. Returns it. |
+| `find_stickers` | Search the sticker library (the editor's stamps unless the host plugged in its own) by words, category, tags and commercial licence, a page at a time. Returns refs (`provider:id`) for sticker brushes (`set_brush` `sticker.stamps`) and `add_stickers`, with tintable and licence. |
+| `describe_sticker` | One sticker by `ref`: licence and attribution, colours, outline. Unknown refs are refused with the closest ones. |
 | `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. |
 

package/skills/pixerate-stickers/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: pixerate-stickers
+description: How to find, check and use stickers from the Pixerate sticker library through find_stickers and describe_sticker - the editor's own stamps (editor:star, editor:heart, ...) or any library a host plugged in (brand packs, uploads, third-party APIs), with refs (provider:id), categories, tags, tintable art and licences. Use when asked to add, spray, place, search for or credit stickers, or when find_stickers or describe_sticker are available.
+---
+
+# Stickers
+
+A sticker library is a `StickerProvider` the host plugs in (`@pixerate/editor/stickers`); with
+none, it is the editor's own stamps (`editorStickers()`: `editor:dot`, `editor:star`,
+`editor:heart`, `editor:leaf`, `editor:flower`, `editor:confetti`, `editor:splat`,
+`editor:sparkle`, `editor:ring`, all MIT and tintable). Every sticker is named by a **ref**,
+`provider:id`; the editors' sticker tools take refs.
+
+## Working method
+
+1. **Find.** `find_stickers` with a few words (`query`) and, when the result's `categories`
+   suggest one, a `category`. Pages are small: pass `next` as `after` for more, or narrow the
+   query. Filter with `commercial: true` for anything that will be sold or used in marketing.
+2. **Check.** `describe_sticker` when the choice matters: its licence (and the attribution line
+   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. 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
+
+- Keep refs exactly as `find_stickers` returns them; a bare editor stamp (`star`) also works
+  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. |