@pixerate/editor 0.262.1 → 0.264.0

package/dist/stickers/browser.d.ts

@@ -1,9 +1,10 @@
 /**
  * `StickerBrowser`: the state behind a sticker picker, shared by the React and Svelte pickers. It
- * searches or lists the provider a page at a time (search words, category), keeps the pages it
- * has loaded and its categories, and tells listeners when anything changes. UI-agnostic.
+ * searches or lists the provider a page at a time (search words, category, collection), keeps the
+ * pages it has loaded, its categories and collections, and tells listeners when anything changes.
+ * UI-agnostic.
  */
-import type { StickerProvider, StickerRef, StickerSummary } from './types.js';
+import type { StickerCollection, StickerProvider, StickerRef, StickerSummary } from './types.js';
 export interface StickerBrowserItem extends StickerSummary {
     ref: StickerRef;
 }
@@ -11,6 +12,8 @@ export interface StickerBrowserState {
     query: string;
     /** `''` for every category. */
     category: string;
+    /** `''` for every collection. */
+    collection: string;
     items: StickerBrowserItem[];
     total: number;
     /** More pages to load (`more()`). */
@@ -22,6 +25,8 @@ export interface StickerBrowserState {
         name: string;
         count: number;
     }>;
+    /** The provider's collections (empty when it has none). */
+    collections: StickerCollection[];
     /** The provider's name. */
     provider: string;
 }
@@ -42,6 +47,8 @@ export declare class StickerBrowser {
     setQuery(query: string): Promise<void>;
     /** Shows one category (`''` for all) from the first page. */
     setCategory(category: string): Promise<void>;
+    /** Shows one collection (`''` for all) from the first page. */
+    setCollection(collection: string): Promise<void>;
     /** Loads the next page onto the list. */
     more(): Promise<void>;
     private page;

package/dist/stickers/combine.d.cts

@@ -3,6 +3,8 @@ import type { StickerProvider } from './types.cjs';
  * One provider over several, in order. Its ids are refs (`provider:id`, `namespaced`), so the
  * same id from two libraries stays two stickers. Pages run through the providers in turn; the
  * cursor is `<provider index>|<that provider's cursor>`. Capabilities are what any of them offers.
+ * Collections are namespaced the same way (`provider:collection`), so a picker can tell a
+ * provider's collections apart from another provider's.
  */
 export declare function combineStickerProviders(providers: readonly StickerProvider[], options?: {
     id?: string;

package/dist/stickers/combine.d.ts

@@ -3,6 +3,8 @@ import type { StickerProvider } from './types.js';
  * One provider over several, in order. Its ids are refs (`provider:id`, `namespaced`), so the
  * same id from two libraries stays two stickers. Pages run through the providers in turn; the
  * cursor is `<provider index>|<that provider's cursor>`. Capabilities are what any of them offers.
+ * Collections are namespaced the same way (`provider:collection`), so a picker can tell a
+ * provider's collections apart from another provider's.
  */
 export declare function combineStickerProviders(providers: readonly StickerProvider[], options?: {
     id?: string;

package/dist/stickers/conformance.d.cts

@@ -13,6 +13,6 @@ export interface StickerConformanceOptions {
 /**
  * Checks a sticker provider against the contract: capabilities, every listed sticker (walking the
  * pages), search and list agreeing, paging limits, describe and load for known and unknown ids,
- * and tinting. Returns the problems found (empty when it conforms).
+ * collections, light / dark variants and tinting. Returns the problems found (empty when it conforms).
  */
 export declare function checkStickerProvider(provider: StickerProvider, options?: StickerConformanceOptions): Promise<StickerConformanceIssue[]>;

package/dist/stickers/conformance.d.ts

@@ -13,6 +13,6 @@ export interface StickerConformanceOptions {
 /**
  * Checks a sticker provider against the contract: capabilities, every listed sticker (walking the
  * pages), search and list agreeing, paging limits, describe and load for known and unknown ids,
- * and tinting. Returns the problems found (empty when it conforms).
+ * collections, light / dark variants and tinting. Returns the problems found (empty when it conforms).
  */
 export declare function checkStickerProvider(provider: StickerProvider, options?: StickerConformanceOptions): Promise<StickerConformanceIssue[]>;

package/dist/stickers/errors.d.cts

@@ -1,4 +1,4 @@
-export type StickerErrorCode = 'unknown_sticker' | 'unknown_provider' | 'unsupported_format' | 'no_provider' | 'load_failed' | 'invalid_argument';
+export type StickerErrorCode = 'unknown_sticker' | 'unknown_provider' | 'unsupported_format' | 'unsupported_variant' | 'no_provider' | 'load_failed' | 'invalid_argument';
 /** A refusal from a sticker provider or the sticker tools. The message says what to do instead. */
 export declare class StickerError extends Error {
     readonly code: StickerErrorCode;

package/dist/stickers/errors.d.ts

@@ -1,4 +1,4 @@
-export type StickerErrorCode = 'unknown_sticker' | 'unknown_provider' | 'unsupported_format' | 'no_provider' | 'load_failed' | 'invalid_argument';
+export type StickerErrorCode = 'unknown_sticker' | 'unknown_provider' | 'unsupported_format' | 'unsupported_variant' | 'no_provider' | 'load_failed' | 'invalid_argument';
 /** A refusal from a sticker provider or the sticker tools. The message says what to do instead. */
 export declare class StickerError extends Error {
     readonly code: StickerErrorCode;

package/dist/stickers/fake.d.cts

@@ -1,7 +1,9 @@
 /**
  * `createFakeStickerProvider()`: a small, deterministic sticker library for tests and demos (id
- * `fake`). Flat badges are tintable; two-colour tiles are not; one sticker is for non-commercial
- * use only. Art is a generated SVG and a PNG drawn to the same design, so it works in Node.
+ * `fake`). Flat badges are tintable; two-colour tiles are not, and have a dark variant (a pale top
+ * half); one sticker is for non-commercial use only; the weather set is AI-generated. Stickers are
+ * in collections (`outdoors`, `kitchen`, `shop`) but the sketch, which is in none. Art is a
+ * generated SVG and a PNG drawn to the same design, so it works in Node.
  */
 import type { StickerProvider } from './types.cjs';
 export interface FakeStickerProviderOptions {

package/dist/stickers/fake.d.ts

@@ -1,7 +1,9 @@
 /**
  * `createFakeStickerProvider()`: a small, deterministic sticker library for tests and demos (id
- * `fake`). Flat badges are tintable; two-colour tiles are not; one sticker is for non-commercial
- * use only. Art is a generated SVG and a PNG drawn to the same design, so it works in Node.
+ * `fake`). Flat badges are tintable; two-colour tiles are not, and have a dark variant (a pale top
+ * half); one sticker is for non-commercial use only; the weather set is AI-generated. Stickers are
+ * in collections (`outdoors`, `kitchen`, `shop`) but the sketch, which is in none. Art is a
+ * generated SVG and a PNG drawn to the same design, so it works in Node.
  */
 import type { StickerProvider } from './types.js';
 export interface FakeStickerProviderOptions {

package/dist/stickers/helpers.d.cts

@@ -3,7 +3,7 @@
  * catalogue, `provider:id` refs, and the slot an editor keeps its provider in.
  */
 import { type StampKind } from './stamps.cjs';
-import type { StickerPage, StickerProvider, StickerRef, StickerSearchOptions, StickerSummary } from './types.cjs';
+import { type StickerCollection, type StickerPage, type StickerProvider, type StickerRef, type StickerSearchOptions, type StickerSummary, type StickerVariant } from './types.cjs';
 /** Default and largest page size. */
 export declare const DEFAULT_STICKER_PAGE = 24;
 export declare const MAX_STICKER_PAGE = 100;
@@ -12,11 +12,25 @@ export declare const EDITOR_STICKERS_ID = "editor";
 /** Checks search options, throwing a `StickerError` that names the bad one. */
 export declare function checkStickerSearchOptions(options?: StickerSearchOptions): void;
 /**
- * One page of `items` filtered by `options` (category, every tag, commercial licence) and, when
+ * One page of `items` filtered by `options` (category, collection, every tag, commercial licence) and, when
  * `query` has words, by every word appearing in the name, tags, category or description. Cursors
  * are offsets as strings.
  */
 export declare function stickerPage(items: readonly StickerSummary[], options?: StickerSearchOptions, query?: string): StickerPage;
+/** The variants a sticker has (`light` always, first). */
+export declare function stickerVariantsOf(s: Pick<StickerSummary, 'variants'>): StickerVariant[];
+/**
+ * Checks `load`'s variant against the sticker's, throwing an `unsupported_variant` `StickerError`
+ * that names the ones it has. Providers call it at the top of `load`; returns the variant to draw.
+ */
+export declare function checkStickerVariant(s: Pick<StickerSummary, 'id' | 'variants'>, variant: StickerVariant | undefined): StickerVariant;
+/** The variant to show on a dark or light background: `dark` when the background is dark and the sticker has it, else `light`. */
+export declare function stickerVariantFor(s: Pick<StickerSummary, 'variants'>, dark: boolean): StickerVariant;
+/** The collections of an in-memory catalogue with their counts, in first-seen order; `names` gives names and descriptions by id. */
+export declare function stickerCollections(items: readonly StickerSummary[], names?: Record<string, {
+    name: string;
+    description?: string;
+}>): StickerCollection[];
 /** A ref split into provider and id. A bare editor stamp (`"star"`) is `editor:star`; any other bare id is refused. */
 export declare function parseStickerRef(ref: StickerRef): {
     provider: string;

package/dist/stickers/helpers.d.ts

@@ -3,7 +3,7 @@
  * catalogue, `provider:id` refs, and the slot an editor keeps its provider in.
  */
 import { type StampKind } from './stamps.js';
-import type { StickerPage, StickerProvider, StickerRef, StickerSearchOptions, StickerSummary } from './types.js';
+import { type StickerCollection, type StickerPage, type StickerProvider, type StickerRef, type StickerSearchOptions, type StickerSummary, type StickerVariant } from './types.js';
 /** Default and largest page size. */
 export declare const DEFAULT_STICKER_PAGE = 24;
 export declare const MAX_STICKER_PAGE = 100;
@@ -12,11 +12,25 @@ export declare const EDITOR_STICKERS_ID = "editor";
 /** Checks search options, throwing a `StickerError` that names the bad one. */
 export declare function checkStickerSearchOptions(options?: StickerSearchOptions): void;
 /**
- * One page of `items` filtered by `options` (category, every tag, commercial licence) and, when
+ * One page of `items` filtered by `options` (category, collection, every tag, commercial licence) and, when
  * `query` has words, by every word appearing in the name, tags, category or description. Cursors
  * are offsets as strings.
  */
 export declare function stickerPage(items: readonly StickerSummary[], options?: StickerSearchOptions, query?: string): StickerPage;
+/** The variants a sticker has (`light` always, first). */
+export declare function stickerVariantsOf(s: Pick<StickerSummary, 'variants'>): StickerVariant[];
+/**
+ * Checks `load`'s variant against the sticker's, throwing an `unsupported_variant` `StickerError`
+ * that names the ones it has. Providers call it at the top of `load`; returns the variant to draw.
+ */
+export declare function checkStickerVariant(s: Pick<StickerSummary, 'id' | 'variants'>, variant: StickerVariant | undefined): StickerVariant;
+/** The variant to show on a dark or light background: `dark` when the background is dark and the sticker has it, else `light`. */
+export declare function stickerVariantFor(s: Pick<StickerSummary, 'variants'>, dark: boolean): StickerVariant;
+/** The collections of an in-memory catalogue with their counts, in first-seen order; `names` gives names and descriptions by id. */
+export declare function stickerCollections(items: readonly StickerSummary[], names?: Record<string, {
+    name: string;
+    description?: string;
+}>): StickerCollection[];
 /** A ref split into provider and id. A bare editor stamp (`"star"`) is `editor:star`; any other bare id is refused. */
 export declare function parseStickerRef(ref: StickerRef): {
     provider: string;

package/dist/stickers/index.cjs

@@ -3,7 +3,7 @@
 
 
 
-var _chunkRVGP2XLFcjs = require('../chunk-RVGP2XLF.cjs');
+var _chunkXORJ7UZOcjs = require('../chunk-XORJ7UZO.cjs');
 
 
 
@@ -11,7 +11,7 @@ var _chunkRVGP2XLFcjs = require('../chunk-RVGP2XLF.cjs');
 
 
 
-var _chunkAVTPZO4Zcjs = require('../chunk-AVTPZO4Z.cjs');
+var _chunkPE6YJMQTcjs = require('../chunk-PE6YJMQT.cjs');
 
 
 
@@ -27,7 +27,12 @@ var _chunkAVTPZO4Zcjs = require('../chunk-AVTPZO4Z.cjs');
 
 
 
-var _chunkJSDND7DFcjs = require('../chunk-JSDND7DF.cjs');
+
+
+
+
+
+var _chunkOTN6VB5Scjs = require('../chunk-OTN6VB5S.cjs');
 
 
 var _chunkU67EN7GGcjs = require('../chunk-U67EN7GG.cjs');
@@ -39,11 +44,17 @@ require('../chunk-XFM3OCHU.cjs');
 
 // src/stickers/fake.ts
 var CATALOGUE = [
-  ...["sun", "moon", "cloud", "rain", "snow", "wind"].map((w, i) => ({ id: `weather-${w}`, name: w[0].toUpperCase() + w.slice(1), category: "weather", tags: ["weather", w], shape: "badge", colours: [["#f59e0b", "#64748b", "#94a3b8", "#2563eb", "#e0f2fe", "#14b8a6"][i], "#ffffff"], commercial: true })),
-  ...["apple", "pear", "cherry", "lemon", "grape"].map((f, i) => ({ id: `fruit-${f}`, name: f[0].toUpperCase() + f.slice(1), category: "food", tags: ["fruit", f], shape: "tile", colours: [["#dc2626", "#84cc16", "#be123c", "#facc15", "#7c3aed"][i], "#166534"], commercial: true })),
-  ...["new", "sale", "hot", "free"].map((b, i) => ({ id: `badge-${b}`, name: `${b[0].toUpperCase() + b.slice(1)} badge`, category: "badges", tags: ["badge", "label", b], shape: "badge", colours: [["#16a34a", "#dc2626", "#ea580c", "#0891b2"][i], "#ffffff"], commercial: true })),
+  ...["sun", "moon", "cloud", "rain", "snow", "wind"].map((w, i) => ({ id: `weather-${w}`, name: w[0].toUpperCase() + w.slice(1), category: "weather", tags: ["weather", w], shape: "badge", colours: [["#f59e0b", "#64748b", "#94a3b8", "#2563eb", "#e0f2fe", "#14b8a6"][i], "#ffffff"], commercial: true, collection: "outdoors", aiGenerated: true })),
+  ...["apple", "pear", "cherry", "lemon", "grape"].map((f, i) => ({ id: `fruit-${f}`, name: f[0].toUpperCase() + f.slice(1), category: "food", tags: ["fruit", f], shape: "tile", colours: [["#dc2626", "#84cc16", "#be123c", "#facc15", "#7c3aed"][i], "#166534"], commercial: true, collection: "kitchen" })),
+  ...["new", "sale", "hot", "free"].map((b, i) => ({ id: `badge-${b}`, name: `${b[0].toUpperCase() + b.slice(1)} badge`, category: "badges", tags: ["badge", "label", b], shape: "badge", colours: [["#16a34a", "#dc2626", "#ea580c", "#0891b2"][i], "#ffffff"], commercial: true, collection: "shop" })),
   { id: "art-sketch", name: "Sketch", category: "art", tags: ["drawing", "non-commercial"], shape: "tile", colours: ["#1f2937", "#fde68a"], commercial: false }
 ];
+var COLLECTIONS = {
+  outdoors: { name: "Outdoors", description: "Weather, AI-generated." },
+  kitchen: { name: "Kitchen", description: "Fruit tiles with dark variants." },
+  shop: { name: "Shop", description: "Tintable sale badges." }
+};
+var DARK_TOP = "#f8fafc";
 var W = 120;
 var H = 120;
 function summaryOf(s) {
@@ -57,16 +68,22 @@ function summaryOf(s) {
     height: H,
     formats: ["svg", "png"],
     licence: s.commercial ? { spdx: "CC0-1.0", name: "CC0 1.0", commercial: true } : { spdx: "CC-BY-NC-4.0", name: "CC BY-NC 4.0", attribution: "Fake Artist", commercial: false },
-    tintable: s.shape === "badge"
+    tintable: s.shape === "badge",
+    ...s.shape === "tile" ? { variants: ["light", "dark"] } : {},
+    ...s.collection ? { collection: s.collection } : {},
+    ...s.aiGenerated ? { aiGenerated: true } : {}
   };
 }
-function svgOf(s, fill) {
+var tileColours = (s, variant) => variant === "dark" ? [s.colours[0], DARK_TOP] : s.colours;
+function svgOf(s, fill, variant) {
   if (s.shape === "badge") {
     return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${W} ${H}" width="${W}" height="${H}"><path fill="${fill}" fill-rule="evenodd" d="M60 6A54 54 0 1 1 59.9 6ZM45 45H75V75H45Z"/></svg>`;
   }
-  return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${W} ${H}" width="${W}" height="${H}"><rect x="10" y="10" width="100" height="100" fill="${s.colours[0]}"/><rect x="10" y="10" width="100" height="50" fill="${s.colours[1]}"/></svg>`;
+  const [bottom, top] = tileColours(s, variant);
+  return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${W} ${H}" width="${W}" height="${H}"><rect x="10" y="10" width="100" height="100" fill="${bottom}"/><rect x="10" y="10" width="100" height="50" fill="${top}"/></svg>`;
 }
-function pixelsOf(s, size, fill) {
+function pixelsOf(s, size, fill, variant) {
+  const [bottom, top] = tileColours(s, variant);
   const out = new Uint8ClampedArray(size * size * 4);
   const hex = (c) => [parseInt(c.slice(1, 3), 16), parseInt(c.slice(3, 5), 16), parseInt(c.slice(5, 7), 16)];
   for (let y = 0; y < size; y++) {
@@ -78,7 +95,7 @@ function pixelsOf(s, size, fill) {
         const inDisc = Math.hypot(u - 60, v - 60) <= 54;
         const inNotch = u >= 45 && u <= 75 && v >= 45 && v <= 75;
         if (inDisc && !inNotch) rgb = hex(fill);
-      } else if (u >= 10 && u <= 110 && v >= 10 && v <= 110) rgb = hex(v < 60 ? s.colours[1] : s.colours[0]);
+      } else if (u >= 10 && u <= 110 && v >= 10 && v <= 110) rgb = hex(v < 60 ? top : bottom);
       if (!rgb) continue;
       const i = (y * size + x) * 4;
       out[i] = rgb[0];
@@ -97,26 +114,28 @@ function createFakeStickerProvider(options = {}) {
     name: "Fake stickers",
     version: "1",
     capabilities: { supportsSearch: true, supportsSvg: true, supportsRaster: true, maxSize: 512 },
-    list: (o) => _chunkJSDND7DFcjs.stickerPage.call(void 0, summaries, o),
-    search: (q, o) => _chunkJSDND7DFcjs.stickerPage.call(void 0, summaries, o, q),
+    list: (o) => _chunkOTN6VB5Scjs.stickerPage.call(void 0, summaries, o),
+    search: (q, o) => _chunkOTN6VB5Scjs.stickerPage.call(void 0, summaries, o, q),
     describe(id) {
       const s = find(id);
       if (!s) return void 0;
       return { ...summaryOf(s), silhouette: s.shape === "badge" ? "M60 6A54 54 0 1 1 59.9 6Z" : "M10 10H110V110H10Z", colours: s.shape === "badge" ? [s.colours[0]] : [...s.colours] };
     },
+    listCollections: () => _chunkOTN6VB5Scjs.stickerCollections.call(void 0, summaries, COLLECTIONS),
     categories: () => [...new Set(CATALOGUE.map((s) => s.category))].map((c) => ({ id: c, name: c, count: CATALOGUE.filter((s) => s.category === c).length })),
     async load(id, o = {}) {
       if (options.loadDelayMs) await new Promise((r) => setTimeout(r, options.loadDelayMs));
       const s = find(id);
       if (!s) throw new (0, _chunkU67EN7GGcjs.StickerError)("unknown_sticker", `No fake sticker "${id}".`);
       if (_optionalChain([options, 'access', _ => _.failIds, 'optionalAccess', _2 => _2.includes, 'call', _3 => _3(id)])) throw new (0, _chunkU67EN7GGcjs.StickerError)("load_failed", `The fake sticker "${id}" failed to load (failIds).`);
+      const variant = _chunkOTN6VB5Scjs.checkStickerVariant.call(void 0, summaryOf(s), o.variant);
       const fill = s.shape === "badge" && o.colour ? o.colour.toLowerCase() : s.colours[0];
       if (o.format === "png") {
         const size = _nullishCoalesce(o.size, () => ( 128));
         if (!(Number.isInteger(size) && size >= 8 && size <= 512)) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `size must be 8..512 px, got ${size}.`);
-        return { kind: "image", url: _chunkW5M3J7PVcjs.pngDataUrl.call(void 0, size, size, pixelsOf(s, size, fill)), width: size, height: size };
+        return { kind: "image", url: _chunkW5M3J7PVcjs.pngDataUrl.call(void 0, size, size, pixelsOf(s, size, fill, variant)), width: size, height: size };
       }
-      return { kind: "svg", svg: svgOf(s, fill) };
+      return { kind: "svg", svg: svgOf(s, fill, variant) };
     }
   };
 }
@@ -128,15 +147,23 @@ function combineStickerProviders(providers, options = {}) {
   if (dup) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `Two sticker providers have the id "${dup}"; give each a unique id.`);
   const byId = new Map(providers.map((p) => [p.id, p]));
   const owner = (ref) => {
-    const { provider, id } = _chunkJSDND7DFcjs.parseStickerRef.call(void 0, ref);
+    const { provider, id } = _chunkOTN6VB5Scjs.parseStickerRef.call(void 0, ref);
     const p = byId.get(provider);
     if (!p) throw new (0, _chunkU67EN7GGcjs.StickerError)("unknown_provider", `No sticker provider "${provider}"; the providers are ${ids.join(", ") || "none"}.`);
     return { p, id };
   };
-  const prefix = (p, s) => ({ ...s, id: _chunkJSDND7DFcjs.stickerRefOf.call(void 0, p, s.id) });
+  const collectionOf = (p, c) => p.namespaced ? c : `${p.id}:${c}`;
+  const prefix = (p, s) => ({ ...s, id: _chunkOTN6VB5Scjs.stickerRefOf.call(void 0, p, s.id), ...s.collection ? { collection: collectionOf(p, s.collection) } : {} });
+  const collectionOwner = (c) => {
+    const i = c.indexOf(":");
+    const p = i > 0 ? byId.get(c.slice(0, i)) : void 0;
+    if (!p) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `No collection "${c}"; collections here are "provider:collection" (listCollections lists them).`);
+    return { p, collection: p.namespaced ? c : c.slice(i + 1) };
+  };
   const page = async (query, o = {}) => {
-    const { after, limit = _chunkJSDND7DFcjs.DEFAULT_STICKER_PAGE, ...filters } = o;
-    _chunkJSDND7DFcjs.checkStickerSearchOptions.call(void 0, { limit });
+    const { after, limit = _chunkOTN6VB5Scjs.DEFAULT_STICKER_PAGE, collection, ...filters } = o;
+    _chunkOTN6VB5Scjs.checkStickerSearchOptions.call(void 0, { limit });
+    const only = collection !== void 0 ? collectionOwner(collection) : null;
     let i = 0;
     let inner;
     if (after !== void 0) {
@@ -145,7 +172,11 @@ function combineStickerProviders(providers, options = {}) {
       i = Number(m[1]);
       inner = m[2] || void 0;
     }
-    const get = (p, opts) => query === null ? p.list(opts) : p.search(query, opts);
+    const get = async (p, opts) => {
+      if (only && only.p !== p) return { items: [], total: 0 };
+      const withCollection = only ? { ...opts, collection: only.collection } : opts;
+      return query === null ? p.list(withCollection) : p.search(query, withCollection);
+    };
     let total = 0;
     for (const p of providers) total += (await get(p, { ...filters, limit: 1 })).total;
     const items = [];
@@ -185,7 +216,7 @@ function combineStickerProviders(providers, options = {}) {
         return void 0;
       }
       const d = await o.p.describe(o.id);
-      return d ? { ...d, id: _chunkJSDND7DFcjs.stickerRefOf.call(void 0, o.p, d.id) } : void 0;
+      return d ? prefix(o.p, d) : void 0;
     },
     async load(ref, o) {
       const { p, id } = owner(ref);
@@ -200,6 +231,11 @@ function combineStickerProviders(providers, options = {}) {
         }
       }
       return [...counts.values()];
+    },
+    async listCollections() {
+      const out = [];
+      for (const p of providers) for (const c of await _asyncNullishCoalesce(await _optionalChain([p, 'access', _8 => _8.listCollections, 'optionalCall', _9 => _9()]), async () => ( []))) out.push({ ...c, id: collectionOf(p, c.id) });
+      return out;
     }
   };
 }
@@ -214,12 +250,20 @@ function checkSummary(s, provider, issues) {
   if (typeof s.category !== "string" || !s.category) at("category is missing");
   if (!(s.width > 0 && s.height > 0)) at(`width and height must be positive, got ${s.width} \xD7 ${s.height}`);
   if (!Array.isArray(s.formats) || !s.formats.length || s.formats.some((f) => f !== "svg" && f !== "png")) at("formats must list svg and / or png");
-  if (_optionalChain([s, 'access', _8 => _8.formats, 'optionalAccess', _9 => _9.includes, 'call', _10 => _10("svg")]) && !provider.capabilities.supportsSvg) at("lists svg but capabilities.supportsSvg is false");
-  if (_optionalChain([s, 'access', _11 => _11.formats, 'optionalAccess', _12 => _12.includes, 'call', _13 => _13("png")]) && !provider.capabilities.supportsRaster) at("lists png but capabilities.supportsRaster is false");
+  if (_optionalChain([s, 'access', _10 => _10.formats, 'optionalAccess', _11 => _11.includes, 'call', _12 => _12("svg")]) && !provider.capabilities.supportsSvg) at("lists svg but capabilities.supportsSvg is false");
+  if (_optionalChain([s, 'access', _13 => _13.formats, 'optionalAccess', _14 => _14.includes, 'call', _15 => _15("png")]) && !provider.capabilities.supportsRaster) at("lists png but capabilities.supportsRaster is false");
   if (!s.licence || typeof s.licence.name !== "string" || !s.licence.name) at("licence.name is missing (every sticker says how it may be used)");
-  if (typeof _optionalChain([s, 'access', _14 => _14.licence, 'optionalAccess', _15 => _15.commercial]) !== "boolean") at("licence.commercial is not a boolean");
+  if (typeof _optionalChain([s, 'access', _16 => _16.licence, 'optionalAccess', _17 => _17.commercial]) !== "boolean") at("licence.commercial is not a boolean");
   if (typeof s.tintable !== "boolean") at("tintable is not a boolean");
   if (s.thumbnail !== void 0 && !/^(data:|https:)/.test(s.thumbnail)) at("thumbnail must be a data: or https: URL");
+  if (s.aiGenerated !== void 0 && typeof s.aiGenerated !== "boolean") at("aiGenerated must be a boolean when present");
+  if (s.variants !== void 0) {
+    const v = s.variants;
+    if (!Array.isArray(v) || v.some((x) => x !== "light" && x !== "dark") || new Set(v).size !== v.length) at("variants must list light and / or dark, each once");
+    else if (!v.includes("light")) at("variants must include light (every sticker has its light art)");
+  }
+  if (s.collection !== void 0 && (typeof s.collection !== "string" || !s.collection)) at("collection must be a non-empty string when present");
+  if (s.collection !== void 0 && !provider.listCollections) at(`is in collection "${s.collection}" but the provider has no listCollections()`);
 }
 async function checkStickerProvider(provider, options = {}) {
   const issues = [];
@@ -228,8 +272,8 @@ async function checkStickerProvider(provider, options = {}) {
   else if (provider.id.includes(":")) top('provider id contains ":"');
   if (typeof provider.name !== "string" || !provider.name) top("provider has no name");
   const caps = provider.capabilities;
-  for (const k of ["supportsSearch", "supportsSvg", "supportsRaster"]) if (typeof _optionalChain([caps, 'optionalAccess', _16 => _16[k]]) !== "boolean") top(`capabilities.${k} is not a boolean`);
-  if (_optionalChain([caps, 'optionalAccess', _17 => _17.maxSize]) !== void 0 && !(caps.maxSize > 0)) top("capabilities.maxSize must be positive");
+  for (const k of ["supportsSearch", "supportsSvg", "supportsRaster"]) if (typeof _optionalChain([caps, 'optionalAccess', _18 => _18[k]]) !== "boolean") top(`capabilities.${k} is not a boolean`);
+  if (_optionalChain([caps, 'optionalAccess', _19 => _19.maxSize]) !== void 0 && !(caps.maxSize > 0)) top("capabilities.maxSize must be positive");
   const all = [];
   const ids = /* @__PURE__ */ new Set();
   let after;
@@ -242,7 +286,7 @@ async function checkStickerProvider(provider, options = {}) {
       top(`list() rejected: ${e.message}`);
       break;
     }
-    if (!Array.isArray(_optionalChain([page, 'optionalAccess', _18 => _18.items])) || typeof page.total !== "number") {
+    if (!Array.isArray(_optionalChain([page, 'optionalAccess', _20 => _20.items])) || typeof page.total !== "number") {
       top("list() did not return { items, total }");
       break;
     }
@@ -275,9 +319,29 @@ async function checkStickerProvider(provider, options = {}) {
     const d = await provider.describe(first.id);
     if (!d) top(`describe("${first.id}") returned nothing for a listed sticker`);
     else if (d.id !== first.id) top(`describe("${first.id}") returned id "${d.id}"`);
-    if (_optionalChain([d, 'optionalAccess', _19 => _19.colours, 'optionalAccess', _20 => _20.some, 'call', _21 => _21((c) => !HEX.test(c))])) top(`describe("${first.id}").colours must be #rrggbb`);
+    if (_optionalChain([d, 'optionalAccess', _21 => _21.colours, 'optionalAccess', _22 => _22.some, 'call', _23 => _23((c) => !HEX.test(c))])) top(`describe("${first.id}").colours must be #rrggbb`);
   }
   if (await provider.describe("__no_such_sticker__") !== void 0) top("describe of an unknown id returned a sticker");
+  if (provider.listCollections) {
+    try {
+      const collections = await provider.listCollections();
+      const known = /* @__PURE__ */ new Set();
+      for (const c of collections) {
+        if (typeof _optionalChain([c, 'optionalAccess', _24 => _24.id]) !== "string" || !c.id || typeof c.name !== "string" || !c.name || !(Number.isInteger(c.count) && c.count >= 0)) {
+          top(`listCollections() returned ${JSON.stringify(c)}; each needs id, name and a count`);
+          continue;
+        }
+        if (known.has(c.id)) top(`listCollections() lists "${c.id}" twice`);
+        known.add(c.id);
+        const page = await provider.list({ collection: c.id, limit: 100 });
+        if (page.total !== c.count) top(`collection "${c.id}" says count ${c.count} but list({ collection }) has ${page.total}`);
+        if (page.items.some((x) => x.collection !== c.id)) top(`list({ collection: "${c.id}" }) returned stickers of other collections`);
+      }
+      for (const x of all) if (x.collection !== void 0 && !known.has(x.collection)) issues.push({ stickerId: x.id, message: `collection "${x.collection}" is not in listCollections()` });
+    } catch (e) {
+      top(`listCollections() rejected: ${e.message}`);
+    }
+  }
   let rejected = false;
   try {
     await provider.load("__no_such_sticker__");
@@ -296,6 +360,24 @@ async function checkStickerProvider(provider, options = {}) {
       }
     }
   }
+  const dark = all.find((s) => _optionalChain([s, 'access', _25 => _25.variants, 'optionalAccess', _26 => _26.includes, 'call', _27 => _27("dark")]));
+  if (dark) {
+    try {
+      await provider.load(dark.id, { format: dark.formats[0], variant: "dark", size: 32 });
+    } catch (e) {
+      issues.push({ stickerId: dark.id, message: `load({ variant: "dark" }) rejected for a sticker that lists it: ${e.message}` });
+    }
+  }
+  const lightOnly = all.find((s) => !_optionalChain([s, 'access', _28 => _28.variants, 'optionalAccess', _29 => _29.includes, 'call', _30 => _30("dark")]));
+  if (lightOnly) {
+    let refused = false;
+    try {
+      await provider.load(lightOnly.id, { format: lightOnly.formats[0], variant: "dark", size: 32 });
+    } catch (e4) {
+      refused = true;
+    }
+    if (!refused) issues.push({ stickerId: lightOnly.id, message: 'load({ variant: "dark" }) did not reject for a sticker without a dark variant (checkStickerVariant does it)' });
+  }
   const tintable = all.find((s) => s.tintable);
   if (tintable) {
     try {
@@ -336,4 +418,9 @@ async function checkStickerProvider(provider, options = {}) {
 
 
 
-exports.DEFAULT_STICKER_PAGE = _chunkJSDND7DFcjs.DEFAULT_STICKER_PAGE; exports.EDITOR_STICKERS_ID = _chunkJSDND7DFcjs.EDITOR_STICKERS_ID; exports.MAX_STICKER_PAGE = _chunkJSDND7DFcjs.MAX_STICKER_PAGE; exports.STAMP_KINDS = _chunkJSDND7DFcjs.STAMP_KINDS; exports.StickerBrowser = _chunkRVGP2XLFcjs.StickerBrowser; exports.StickerError = _chunkU67EN7GGcjs.StickerError; exports.StickersSlot = _chunkJSDND7DFcjs.StickersSlot; exports.checkStickerProvider = checkStickerProvider; exports.checkStickerSearchOptions = _chunkJSDND7DFcjs.checkStickerSearchOptions; exports.closestStickerRefs = _chunkJSDND7DFcjs.closestStickerRefs; exports.combineStickerProviders = combineStickerProviders; exports.createFakeStickerProvider = createFakeStickerProvider; exports.createInsertStickerTool = _chunkAVTPZO4Zcjs.createInsertStickerTool; exports.createStickerToolProvider = _chunkAVTPZO4Zcjs.createStickerToolProvider; exports.createStickerTools = _chunkAVTPZO4Zcjs.createStickerTools; exports.describeStickerRef = _chunkAVTPZO4Zcjs.describeStickerRef; exports.editorStampOf = _chunkJSDND7DFcjs.editorStampOf; exports.editorStickers = _chunkRVGP2XLFcjs.editorStickers; exports.insertSticker = _chunkAVTPZO4Zcjs.insertSticker; exports.normalizeStickerRef = _chunkJSDND7DFcjs.normalizeStickerRef; exports.parseStickerRef = _chunkJSDND7DFcjs.parseStickerRef; exports.stampCoverage = _chunkJSDND7DFcjs.stampCoverage; exports.stampOutline = _chunkRVGP2XLFcjs.stampOutline; exports.stampPixels = _chunkRVGP2XLFcjs.stampPixels; exports.stickerForAgent = _chunkAVTPZO4Zcjs.stickerForAgent; exports.stickerIdFor = _chunkJSDND7DFcjs.stickerIdFor; exports.stickerPage = _chunkJSDND7DFcjs.stickerPage; exports.stickerRefOf = _chunkJSDND7DFcjs.stickerRefOf;
+
+
+
+
+
+exports.DEFAULT_STICKER_PAGE = _chunkOTN6VB5Scjs.DEFAULT_STICKER_PAGE; exports.EDITOR_STICKERS_ID = _chunkOTN6VB5Scjs.EDITOR_STICKERS_ID; exports.MAX_STICKER_PAGE = _chunkOTN6VB5Scjs.MAX_STICKER_PAGE; exports.STAMP_KINDS = _chunkOTN6VB5Scjs.STAMP_KINDS; exports.STICKER_VARIANTS = _chunkOTN6VB5Scjs.STICKER_VARIANTS; exports.StickerBrowser = _chunkXORJ7UZOcjs.StickerBrowser; exports.StickerError = _chunkU67EN7GGcjs.StickerError; exports.StickersSlot = _chunkOTN6VB5Scjs.StickersSlot; exports.checkStickerProvider = checkStickerProvider; exports.checkStickerSearchOptions = _chunkOTN6VB5Scjs.checkStickerSearchOptions; exports.checkStickerVariant = _chunkOTN6VB5Scjs.checkStickerVariant; exports.closestStickerRefs = _chunkOTN6VB5Scjs.closestStickerRefs; exports.combineStickerProviders = combineStickerProviders; exports.createFakeStickerProvider = createFakeStickerProvider; exports.createInsertStickerTool = _chunkPE6YJMQTcjs.createInsertStickerTool; exports.createStickerToolProvider = _chunkPE6YJMQTcjs.createStickerToolProvider; exports.createStickerTools = _chunkPE6YJMQTcjs.createStickerTools; exports.describeStickerRef = _chunkPE6YJMQTcjs.describeStickerRef; exports.editorStampOf = _chunkOTN6VB5Scjs.editorStampOf; exports.editorStickers = _chunkXORJ7UZOcjs.editorStickers; exports.insertSticker = _chunkPE6YJMQTcjs.insertSticker; exports.normalizeStickerRef = _chunkOTN6VB5Scjs.normalizeStickerRef; exports.parseStickerRef = _chunkOTN6VB5Scjs.parseStickerRef; exports.stampCoverage = _chunkOTN6VB5Scjs.stampCoverage; exports.stampOutline = _chunkXORJ7UZOcjs.stampOutline; exports.stampPixels = _chunkXORJ7UZOcjs.stampPixels; exports.stickerCollections = _chunkOTN6VB5Scjs.stickerCollections; exports.stickerForAgent = _chunkPE6YJMQTcjs.stickerForAgent; exports.stickerIdFor = _chunkOTN6VB5Scjs.stickerIdFor; exports.stickerPage = _chunkOTN6VB5Scjs.stickerPage; exports.stickerRefOf = _chunkOTN6VB5Scjs.stickerRefOf; exports.stickerVariantFor = _chunkOTN6VB5Scjs.stickerVariantFor; exports.stickerVariantsOf = _chunkOTN6VB5Scjs.stickerVariantsOf;