@pixerate/editor 0.248.0 → 0.249.0

package/dist/vector/index.js

@@ -26,7 +26,7 @@ import {
   traceField,
   traceVectorImage,
   vectorTraceContours
-} from "../chunk-5GLYUSNT.js";
+} from "../chunk-DOIU7VJG.js";
 import {
   applyHomography,
   homographyFromPoints,
@@ -53,7 +53,7 @@ import {
   reverseMorphContour,
   subpathToMorphContour,
   turnMorphContour
-} from "../chunk-XNRBMYNB.js";
+} from "../chunk-O75V4ZS3.js";
 import {
   DEFAULT_VECTOR_FONT,
   IDENTITY_MATRIX,
@@ -526,8 +526,9 @@ import {
   withVectorStrokes,
   withVectorTargetPaint,
   zigzagPaths
-} from "../chunk-Q2HA52V4.js";
-import "../chunk-VNBUDVD4.js";
+} from "../chunk-PZP2SZIZ.js";
+import "../chunk-J7T5QZ45.js";
+import "../chunk-5RH3VXAK.js";
 import {
   createProvenance
 } from "../chunk-M6DNZNVY.js";
@@ -562,14 +563,16 @@ import {
 import "../chunk-V2ZCJRDM.js";
 import {
   GRAIN_PATTERNS
-} from "../chunk-2PBZBRP5.js";
+} from "../chunk-D5KGAO4Z.js";
+import "../chunk-4D6KP5BV.js";
 import "../chunk-ODBT55Q7.js";
+import "../chunk-IRSTHLQQ.js";
 import {
   bytesToBase64,
   decodePng,
   isPng,
   parseDataUrl
-} from "../chunk-42TWUPNJ.js";
+} from "../chunk-OTTT5N3K.js";
 import "../chunk-HVVR5PZW.js";
 import {
   deflate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.248.0",
+  "version": "0.249.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-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,45 @@
+---
+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. 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.
+
+## 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.
+
+## 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.
+
+## 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. |
+| `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. |