@pixerate/editor 0.262.1 → 0.263.0

package/dist/vector/index.js

@@ -26,7 +26,7 @@ import {
   traceField,
   traceVectorImage,
   vectorTraceContours
-} from "../chunk-CQVTGBQI.js";
+} from "../chunk-JGI4PZWO.js";
 import {
   applyHomography,
   homographyFromPoints,
@@ -53,7 +53,7 @@ import {
   reverseMorphContour,
   subpathToMorphContour,
   turnMorphContour
-} from "../chunk-QAR2N7HZ.js";
+} from "../chunk-6XX7E7O2.js";
 import {
   DEFAULT_VECTOR_FONT,
   IDENTITY_MATRIX,
@@ -529,11 +529,11 @@ import {
   withVectorStrokes,
   withVectorTargetPaint,
   zigzagPaths
-} from "../chunk-6NZL24W4.js";
+} from "../chunk-34HIZXFX.js";
 import {
   snapshotBrushLibrary
-} from "../chunk-5IW65VQ6.js";
-import "../chunk-APX63ILU.js";
+} from "../chunk-P5343XZO.js";
+import "../chunk-ACFSFUQH.js";
 import {
   createProvenance
 } from "../chunk-M6DNZNVY.js";
@@ -18372,10 +18372,11 @@ function stickerVectorGroup(placement, id = "sticker") {
   const s = placement.width / box.width;
   return transformVectorNode(group, [s, 0, 0, s, placement.x - box.width * s / 2, placement.y - box.height * s / 2]);
 }
-function createVectorStickerHost(controller) {
+function createVectorStickerHost(controller, options = {}) {
   return {
     noun: "group of editable paths",
     format: "svg",
+    ...options.dark ? { dark: options.dark } : {},
     defaultCentre: () => {
       const d = controller.getDocument();
       return { x: d.width / 2, y: d.height / 2 };

package/dist/vector/stickers.d.cts

@@ -7,5 +7,10 @@ import type { VectorEditorController } from './controller.cjs';
 import type { VectorGroupNode } from './types.cjs';
 /** A group of the sticker's paths, `placement.width` wide and centred on (`x`, `y`). */
 export declare function stickerVectorGroup(placement: StickerPlacement, id?: string): VectorGroupNode;
-/** `insert_sticker` for a vector editor: a group of editable paths, one undo step, selected. */
-export declare function createVectorStickerHost(controller: VectorEditorController): StickerInsertHost;
+/**
+ * `insert_sticker` for a vector editor: a group of editable paths, one undo step, selected. With
+ * `dark` (the host's dark theme or artboard), stickers that have a dark variant use it.
+ */
+export declare function createVectorStickerHost(controller: VectorEditorController, options?: {
+    dark?: () => boolean;
+}): StickerInsertHost;

package/dist/vector/stickers.d.ts

@@ -7,5 +7,10 @@ import type { VectorEditorController } from './controller.js';
 import type { VectorGroupNode } from './types.js';
 /** A group of the sticker's paths, `placement.width` wide and centred on (`x`, `y`). */
 export declare function stickerVectorGroup(placement: StickerPlacement, id?: string): VectorGroupNode;
-/** `insert_sticker` for a vector editor: a group of editable paths, one undo step, selected. */
-export declare function createVectorStickerHost(controller: VectorEditorController): StickerInsertHost;
+/**
+ * `insert_sticker` for a vector editor: a group of editable paths, one undo step, selected. With
+ * `dark` (the host's dark theme or artboard), stickers that have a dark variant use it.
+ */
+export declare function createVectorStickerHost(controller: VectorEditorController, options?: {
+    dark?: () => boolean;
+}): StickerInsertHost;

package/package.json

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

package/skills/pixerate-stickers/SKILL.md

@@ -1,6 +1,6 @@
 ---
 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.
+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, collections, tags, tintable art, light / dark variants, AI-generated labels and licences. Use when asked to add, spray, place, search for or credit stickers, or when find_stickers or describe_sticker are available.
 ---
 
 # Stickers
@@ -14,17 +14,22 @@ none, it is the editor's own stamps (`editorStickers()`: `editor:dot`, `editor:s
 ## 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.
+   suggest one, a `category`. When the result lists `collections` (themed sets, such as one per
+   brand) and the job names one, pass its id as `collection`. 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.
+   it asks for), whether the art is `aiGenerated`, its `variants`, dominant colours and outline.
 3. **Use.** Pass refs to the editor that places them: in the paint editor, a sticker brush
    (`set_brush` `tip.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.
+   `color`; the rest keep their own colours. A sticker whose `variants` include `dark` has art
+   drawn for dark backgrounds: `insert_sticker` uses it when the host's canvas or theme is dark
+   (or pass `variant`), and the paint editor's sticker brush sprays it on a dark colour scheme
+   (each sticker keeps the variant it was drawn in).
 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,
@@ -35,6 +40,10 @@ none, it is the editor's own stamps (`editorStickers()`: `editor:dot`, `editor:s
 - 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.
+- Say when art is `aiGenerated: true` if the user asked for hand-made art or must disclose AI
+  content; absent means the provider didn't say, not that it is hand-made.
+- Leave `variant` out of `insert_sticker` unless the user asked for one: the default matches the
+  background.
 - 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.
@@ -42,7 +51,9 @@ none, it is the editor's own stamps (`editorStickers()`: `editor:dot`, `editor:s
 ## 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.
+- A category or collection that the library doesn't have is refused with the list of its
+  categories or collections. In a combined library, collection ids are `provider:collection`.
+- `variant: "dark"` on a sticker without a dark variant is refused; check `variants` first.
 - `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,
@@ -52,6 +63,6 @@ none, it is the editor's own stamps (`editorStickers()`: `editor:dot`, `editor:s
 
 | 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. |
+| `find_stickers` | Search or list the library: `query`, `category`, `collection`, `tags`, `commercial`, `limit`, `after`. Returns `items` (each `ref`, name, category, collection, tags, width, height, formats, tintable, aiGenerated, variants, licence), `total`, `next`, `categories`, `collections`. 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, in its dark `variant` on a dark background (or the one passed). One undo step. Returns the new group, layer or node `id`, the size, the `variant` used and the licence. |
+| `describe_sticker` | One sticker by `ref`: everything `find_stickers` returns plus `silhouette` (SVG path data) and `colours`. Unknown refs are refused with the closest ones. Changes nothing. |