@pixerate/editor 0.266.2 → 0.267.0

package/dist/paint-editor/path-samples.d.cts

@@ -11,6 +11,8 @@ export interface PathSampleOptions {
     spacing?: number;
     /** Pressure along each subpath, spread evenly from its start to its end (default full pressure). */
     pressure?: readonly number[];
+    /** Drawing speed in document pixels per millisecond; when set, gives each sample a time `t` in ms along its subpath. */
+    speed?: number;
 }
 /**
  * Samples SVG path data (document pixels) into pen points, one array per subpath. Closed

package/dist/paint-editor/path-samples.d.ts

@@ -11,6 +11,8 @@ export interface PathSampleOptions {
     spacing?: number;
     /** Pressure along each subpath, spread evenly from its start to its end (default full pressure). */
     pressure?: readonly number[];
+    /** Drawing speed in document pixels per millisecond; when set, gives each sample a time `t` in ms along its subpath. */
+    speed?: number;
 }
 /**
  * Samples SVG path data (document pixels) into pen points, one array per subpath. Closed

package/dist/paint-editor/presence.d.cts

@@ -1,12 +1,22 @@
 import { PresenceStore, type PresenceActor, type PresenceActorInfo, type PresenceClock, type PresenceState } from '../animation/presence.cjs';
+import type { MixerLoad } from '../paint/mixer.cjs';
 import type { RasterRect } from '../raster/surface.cjs';
-import type { FillLayerOptions, PaintEditorController, PaintStrokeInit, ReplayOptions } from './controller.cjs';
+import { type FillLayerOptions, type PaintEditorController, type PaintStrokeInit, type ReplayOptions } from './controller.cjs';
 import type { PenPoint } from './engine.cjs';
 export type PaintPresenceActor = PresenceActor;
 export type PaintPresenceState = PresenceState;
 /** Cursor positions (document pixels) and notes of agents painting, for an overlay. */
 export declare class PaintPresence extends PresenceStore {
 }
+/** Result of painting several strokes as one undo step (e.g. a path's subpaths). */
+export interface PaintStrokesResult {
+    layerId: string;
+    bounds: RasterRect | null;
+    dabs: number;
+    strokeIds: string[];
+    mixerLoad?: MixerLoad;
+    wet?: boolean;
+}
 /** What an agent asks for. Each command that paints commits as one undo step. */
 export type PaintAgentCommand = {
     kind: 'stroke';
@@ -14,6 +24,13 @@ export type PaintAgentCommand = {
         points: readonly PenPoint[];
     };
     note?: string;
+} | {
+    kind: 'strokes';
+    strokes: ReadonlyArray<PaintStrokeInit & {
+        points: readonly PenPoint[];
+    }>;
+    label?: string;
+    note?: string;
 } | {
     kind: 'fill';
     fill: FillLayerOptions;
@@ -85,4 +102,6 @@ export declare class PaintDirector {
     private performOne;
     /** Paints a stroke live: begins it, pushes its points frame by frame as the cursor reaches them, then ends it (one undo step). */
     private stroke;
+    /** Paints several strokes live in turn and commits them as one undo step (e.g. a path's subpaths). */
+    private strokes;
 }

package/dist/paint-editor/presence.d.ts

@@ -1,12 +1,22 @@
 import { PresenceStore, type PresenceActor, type PresenceActorInfo, type PresenceClock, type PresenceState } from '../animation/presence.js';
+import type { MixerLoad } from '../paint/mixer.js';
 import type { RasterRect } from '../raster/surface.js';
-import type { FillLayerOptions, PaintEditorController, PaintStrokeInit, ReplayOptions } from './controller.js';
+import { type FillLayerOptions, type PaintEditorController, type PaintStrokeInit, type ReplayOptions } from './controller.js';
 import type { PenPoint } from './engine.js';
 export type PaintPresenceActor = PresenceActor;
 export type PaintPresenceState = PresenceState;
 /** Cursor positions (document pixels) and notes of agents painting, for an overlay. */
 export declare class PaintPresence extends PresenceStore {
 }
+/** Result of painting several strokes as one undo step (e.g. a path's subpaths). */
+export interface PaintStrokesResult {
+    layerId: string;
+    bounds: RasterRect | null;
+    dabs: number;
+    strokeIds: string[];
+    mixerLoad?: MixerLoad;
+    wet?: boolean;
+}
 /** What an agent asks for. Each command that paints commits as one undo step. */
 export type PaintAgentCommand = {
     kind: 'stroke';
@@ -14,6 +24,13 @@ export type PaintAgentCommand = {
         points: readonly PenPoint[];
     };
     note?: string;
+} | {
+    kind: 'strokes';
+    strokes: ReadonlyArray<PaintStrokeInit & {
+        points: readonly PenPoint[];
+    }>;
+    label?: string;
+    note?: string;
 } | {
     kind: 'fill';
     fill: FillLayerOptions;
@@ -85,4 +102,6 @@ export declare class PaintDirector {
     private performOne;
     /** Paints a stroke live: begins it, pushes its points frame by frame as the cursor reaches them, then ends it (one undo step). */
     private stroke;
+    /** Paints several strokes live in turn and commits them as one undo step (e.g. a path's subpaths). */
+    private strokes;
 }

package/dist/stickers/helpers.d.cts

@@ -31,6 +31,8 @@ export declare function stickerCollections(items: readonly StickerSummary[], nam
     name: string;
     description?: string;
 }>): StickerCollection[];
+/** Calls `provider.collections()` or `provider.listCollections()` when the provider defines either. */
+export declare function providerCollections(provider: StickerProvider): ReturnType<NonNullable<StickerProvider['collections']>> | undefined;
 /** 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

@@ -31,6 +31,8 @@ export declare function stickerCollections(items: readonly StickerSummary[], nam
     name: string;
     description?: string;
 }>): StickerCollection[];
+/** Calls `provider.collections()` or `provider.listCollections()` when the provider defines either. */
+export declare function providerCollections(provider: StickerProvider): ReturnType<NonNullable<StickerProvider['collections']>> | undefined;
 /** 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 _chunkXORJ7UZOcjs = require('../chunk-XORJ7UZO.cjs');
+var _chunk3VHH6V67cjs = require('../chunk-3VHH6V67.cjs');
 
 
 
@@ -11,7 +11,7 @@ var _chunkXORJ7UZOcjs = require('../chunk-XORJ7UZO.cjs');
 
 
 
-var _chunkPE6YJMQTcjs = require('../chunk-PE6YJMQT.cjs');
+var _chunkPFHJS4HEcjs = require('../chunk-PFHJS4HE.cjs');
 
 
 
@@ -32,7 +32,8 @@ var _chunkPE6YJMQTcjs = require('../chunk-PE6YJMQT.cjs');
 
 
 
-var _chunkOTN6VB5Scjs = require('../chunk-OTN6VB5S.cjs');
+
+var _chunkRDFHWAHLcjs = require('../chunk-RDFHWAHL.cjs');
 
 
 var _chunkU67EN7GGcjs = require('../chunk-U67EN7GG.cjs');
@@ -114,21 +115,23 @@ function createFakeStickerProvider(options = {}) {
     name: "Fake stickers",
     version: "1",
     capabilities: { supportsSearch: true, supportsSvg: true, supportsRaster: true, maxSize: 512 },
-    list: (o) => _chunkOTN6VB5Scjs.stickerPage.call(void 0, summaries, o),
-    search: (q, o) => _chunkOTN6VB5Scjs.stickerPage.call(void 0, summaries, o, q),
+    list: (o) => _chunkRDFHWAHLcjs.stickerPage.call(void 0, summaries, o),
+    search: (q, o) => _chunkRDFHWAHLcjs.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),
+    collections: () => _chunkRDFHWAHLcjs.stickerCollections.call(void 0, summaries, COLLECTIONS),
+    listCollections: () => _chunkRDFHWAHLcjs.stickerCollections.call(void 0, summaries, COLLECTIONS),
+    // the older name, kept for callers that use it
     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 variant = _chunkRDFHWAHLcjs.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));
@@ -147,22 +150,22 @@ 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 } = _chunkOTN6VB5Scjs.parseStickerRef.call(void 0, ref);
+    const { provider, id } = _chunkRDFHWAHLcjs.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 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 prefix = (p, s) => ({ ...s, id: _chunkRDFHWAHLcjs.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).`);
+    if (!p) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `No collection "${c}"; collections here are "provider:collection" (collections() lists them).`);
     return { p, collection: p.namespaced ? c : c.slice(i + 1) };
   };
   const page = async (query, o = {}) => {
-    const { after, limit = _chunkOTN6VB5Scjs.DEFAULT_STICKER_PAGE, collection, ...filters } = o;
-    _chunkOTN6VB5Scjs.checkStickerSearchOptions.call(void 0, { limit });
+    const { after, limit = _chunkRDFHWAHLcjs.DEFAULT_STICKER_PAGE, collection, ...filters } = o;
+    _chunkRDFHWAHLcjs.checkStickerSearchOptions.call(void 0, { limit });
     const only = collection !== void 0 ? collectionOwner(collection) : null;
     let i = 0;
     let inner;
@@ -196,6 +199,11 @@ function combineStickerProviders(providers, options = {}) {
     if (!next && items.length >= limit && i < providers.length) next = `${i}|`;
     return { items, total, ...next ? { next } : {} };
   };
+  const collections = async () => {
+    const out = [];
+    for (const p of providers) for (const c of await _asyncNullishCoalesce(await _chunkRDFHWAHLcjs.providerCollections.call(void 0, p), async () => ( []))) out.push({ ...c, id: collectionOf(p, c.id) });
+    return out;
+  };
   return {
     id: _nullishCoalesce(options.id, () => ( "stickers")),
     name: _nullishCoalesce(options.name, () => ( providers.map((p) => p.name).join(" + "))),
@@ -232,11 +240,8 @@ 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;
-    }
+    collections,
+    listCollections: collections
   };
 }
 
@@ -250,10 +255,10 @@ 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', _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 (_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 (!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', _16 => _16.licence, 'optionalAccess', _17 => _17.commercial]) !== "boolean") at("licence.commercial is not a boolean");
+  if (typeof _optionalChain([s, 'access', _14 => _14.licence, 'optionalAccess', _15 => _15.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");
@@ -263,7 +268,7 @@ function checkSummary(s, provider, issues) {
     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()`);
+  if (s.collection !== void 0 && !provider.collections && !provider.listCollections) at(`is in collection "${s.collection}" but the provider has no collections()`);
 }
 async function checkStickerProvider(provider, options = {}) {
   const issues = [];
@@ -272,8 +277,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', _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");
+  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");
   const all = [];
   const ids = /* @__PURE__ */ new Set();
   let after;
@@ -286,7 +291,7 @@ async function checkStickerProvider(provider, options = {}) {
       top(`list() rejected: ${e.message}`);
       break;
     }
-    if (!Array.isArray(_optionalChain([page, 'optionalAccess', _20 => _20.items])) || typeof page.total !== "number") {
+    if (!Array.isArray(_optionalChain([page, 'optionalAccess', _18 => _18.items])) || typeof page.total !== "number") {
       top("list() did not return { items, total }");
       break;
     }
@@ -319,27 +324,27 @@ 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', _21 => _21.colours, 'optionalAccess', _22 => _22.some, 'call', _23 => _23((c) => !HEX.test(c))])) top(`describe("${first.id}").colours must be #rrggbb`);
+    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 (await provider.describe("__no_such_sticker__") !== void 0) top("describe of an unknown id returned a sticker");
-  if (provider.listCollections) {
+  if (provider.collections || provider.listCollections) {
     try {
-      const collections = await provider.listCollections();
+      const collections = await _asyncNullishCoalesce(await _chunkRDFHWAHLcjs.providerCollections.call(void 0, provider), async () => ( []));
       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`);
+        if (typeof _optionalChain([c, 'optionalAccess', _22 => _22.id]) !== "string" || !c.id || typeof c.name !== "string" || !c.name || !(Number.isInteger(c.count) && c.count >= 0)) {
+          top(`collections() returned ${JSON.stringify(c)}; each needs id, name and a count`);
           continue;
         }
-        if (known.has(c.id)) top(`listCollections() lists "${c.id}" twice`);
+        if (known.has(c.id)) top(`collections() 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()` });
+      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 collections()` });
     } catch (e) {
-      top(`listCollections() rejected: ${e.message}`);
+      top(`collections() rejected: ${e.message}`);
     }
   }
   let rejected = false;
@@ -360,7 +365,7 @@ async function checkStickerProvider(provider, options = {}) {
       }
     }
   }
-  const dark = all.find((s) => _optionalChain([s, 'access', _25 => _25.variants, 'optionalAccess', _26 => _26.includes, 'call', _27 => _27("dark")]));
+  const dark = all.find((s) => _optionalChain([s, 'access', _23 => _23.variants, 'optionalAccess', _24 => _24.includes, 'call', _25 => _25("dark")]));
   if (dark) {
     try {
       await provider.load(dark.id, { format: dark.formats[0], variant: "dark", size: 32 });
@@ -368,7 +373,7 @@ async function checkStickerProvider(provider, options = {}) {
       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")]));
+  const lightOnly = all.find((s) => !_optionalChain([s, 'access', _26 => _26.variants, 'optionalAccess', _27 => _27.includes, 'call', _28 => _28("dark")]));
   if (lightOnly) {
     let refused = false;
     try {
@@ -423,4 +428,5 @@ async function checkStickerProvider(provider, options = {}) {
 
 
 
-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;
+
+exports.DEFAULT_STICKER_PAGE = _chunkRDFHWAHLcjs.DEFAULT_STICKER_PAGE; exports.EDITOR_STICKERS_ID = _chunkRDFHWAHLcjs.EDITOR_STICKERS_ID; exports.MAX_STICKER_PAGE = _chunkRDFHWAHLcjs.MAX_STICKER_PAGE; exports.STAMP_KINDS = _chunkRDFHWAHLcjs.STAMP_KINDS; exports.STICKER_VARIANTS = _chunkRDFHWAHLcjs.STICKER_VARIANTS; exports.StickerBrowser = _chunk3VHH6V67cjs.StickerBrowser; exports.StickerError = _chunkU67EN7GGcjs.StickerError; exports.StickersSlot = _chunkRDFHWAHLcjs.StickersSlot; exports.checkStickerProvider = checkStickerProvider; exports.checkStickerSearchOptions = _chunkRDFHWAHLcjs.checkStickerSearchOptions; exports.checkStickerVariant = _chunkRDFHWAHLcjs.checkStickerVariant; exports.closestStickerRefs = _chunkRDFHWAHLcjs.closestStickerRefs; exports.combineStickerProviders = combineStickerProviders; exports.createFakeStickerProvider = createFakeStickerProvider; exports.createInsertStickerTool = _chunkPFHJS4HEcjs.createInsertStickerTool; exports.createStickerToolProvider = _chunkPFHJS4HEcjs.createStickerToolProvider; exports.createStickerTools = _chunkPFHJS4HEcjs.createStickerTools; exports.describeStickerRef = _chunkPFHJS4HEcjs.describeStickerRef; exports.editorStampOf = _chunkRDFHWAHLcjs.editorStampOf; exports.editorStickers = _chunk3VHH6V67cjs.editorStickers; exports.insertSticker = _chunkPFHJS4HEcjs.insertSticker; exports.normalizeStickerRef = _chunkRDFHWAHLcjs.normalizeStickerRef; exports.parseStickerRef = _chunkRDFHWAHLcjs.parseStickerRef; exports.providerCollections = _chunkRDFHWAHLcjs.providerCollections; exports.stampCoverage = _chunkRDFHWAHLcjs.stampCoverage; exports.stampOutline = _chunk3VHH6V67cjs.stampOutline; exports.stampPixels = _chunk3VHH6V67cjs.stampPixels; exports.stickerCollections = _chunkRDFHWAHLcjs.stickerCollections; exports.stickerForAgent = _chunkPFHJS4HEcjs.stickerForAgent; exports.stickerIdFor = _chunkRDFHWAHLcjs.stickerIdFor; exports.stickerPage = _chunkRDFHWAHLcjs.stickerPage; exports.stickerRefOf = _chunkRDFHWAHLcjs.stickerRefOf; exports.stickerVariantFor = _chunkRDFHWAHLcjs.stickerVariantFor; exports.stickerVariantsOf = _chunkRDFHWAHLcjs.stickerVariantsOf;

package/dist/stickers/index.js

@@ -3,7 +3,7 @@ import {
   editorStickers,
   stampOutline,
   stampPixels
-} from "../chunk-DOZ6F2K2.js";
+} from "../chunk-NSETJI74.js";
 import {
   createInsertStickerTool,
   createStickerToolProvider,
@@ -11,7 +11,7 @@ import {
   describeStickerRef,
   insertSticker,
   stickerForAgent
-} from "../chunk-6JL2D5SG.js";
+} from "../chunk-VE6UKYQ2.js";
 import {
   DEFAULT_STICKER_PAGE,
   EDITOR_STICKERS_ID,
@@ -25,6 +25,7 @@ import {
   editorStampOf,
   normalizeStickerRef,
   parseStickerRef,
+  providerCollections,
   stampCoverage,
   stickerCollections,
   stickerIdFor,
@@ -32,7 +33,7 @@ import {
   stickerRefOf,
   stickerVariantFor,
   stickerVariantsOf
-} from "../chunk-ACFSFUQH.js";
+} from "../chunk-JL6YH5WD.js";
 import {
   StickerError
 } from "../chunk-SZTI6EER.js";
@@ -121,7 +122,9 @@ function createFakeStickerProvider(options = {}) {
       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] };
     },
+    collections: () => stickerCollections(summaries, COLLECTIONS),
     listCollections: () => stickerCollections(summaries, COLLECTIONS),
+    // the older name, kept for callers that use it
     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));
@@ -157,7 +160,7 @@ function combineStickerProviders(providers, options = {}) {
   const collectionOwner = (c) => {
     const i = c.indexOf(":");
     const p = i > 0 ? byId.get(c.slice(0, i)) : void 0;
-    if (!p) throw new StickerError("invalid_argument", `No collection "${c}"; collections here are "provider:collection" (listCollections lists them).`);
+    if (!p) throw new StickerError("invalid_argument", `No collection "${c}"; collections here are "provider:collection" (collections() lists them).`);
     return { p, collection: p.namespaced ? c : c.slice(i + 1) };
   };
   const page = async (query, o = {}) => {
@@ -196,6 +199,11 @@ function combineStickerProviders(providers, options = {}) {
     if (!next && items.length >= limit && i < providers.length) next = `${i}|`;
     return { items, total, ...next ? { next } : {} };
   };
+  const collections = async () => {
+    const out = [];
+    for (const p of providers) for (const c of await providerCollections(p) ?? []) out.push({ ...c, id: collectionOf(p, c.id) });
+    return out;
+  };
   return {
     id: options.id ?? "stickers",
     name: options.name ?? providers.map((p) => p.name).join(" + "),
@@ -232,11 +240,8 @@ function combineStickerProviders(providers, options = {}) {
       }
       return [...counts.values()];
     },
-    async listCollections() {
-      const out = [];
-      for (const p of providers) for (const c of await p.listCollections?.() ?? []) out.push({ ...c, id: collectionOf(p, c.id) });
-      return out;
-    }
+    collections,
+    listCollections: collections
   };
 }
 
@@ -263,7 +268,7 @@ function checkSummary(s, provider, issues) {
     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()`);
+  if (s.collection !== void 0 && !provider.collections && !provider.listCollections) at(`is in collection "${s.collection}" but the provider has no collections()`);
 }
 async function checkStickerProvider(provider, options = {}) {
   const issues = [];
@@ -322,24 +327,24 @@ async function checkStickerProvider(provider, options = {}) {
     if (d?.colours?.some((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) {
+  if (provider.collections || provider.listCollections) {
     try {
-      const collections = await provider.listCollections();
+      const collections = await providerCollections(provider) ?? [];
       const known = /* @__PURE__ */ new Set();
       for (const c of collections) {
         if (typeof c?.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`);
+          top(`collections() returned ${JSON.stringify(c)}; each needs id, name and a count`);
           continue;
         }
-        if (known.has(c.id)) top(`listCollections() lists "${c.id}" twice`);
+        if (known.has(c.id)) top(`collections() 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()` });
+      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 collections()` });
     } catch (e) {
-      top(`listCollections() rejected: ${e.message}`);
+      top(`collections() rejected: ${e.message}`);
     }
   }
   let rejected = false;
@@ -413,6 +418,7 @@ export {
   insertSticker,
   normalizeStickerRef,
   parseStickerRef,
+  providerCollections,
   stampCoverage,
   stampOutline,
   stampPixels,

package/dist/stickers/types.d.cts

@@ -61,7 +61,7 @@ export interface StickerSummary {
      * picker or brush can pick the dark one for a dark background without calling `describe` first.
      */
     variants?: StickerVariant[];
-    /** The collection it belongs to (`listCollections`), when the provider groups its stickers. */
+    /** The collection it belongs to (`collections()`), when the provider groups its stickers. */
     collection?: string;
 }
 /** Everything about one sticker. */
@@ -93,7 +93,7 @@ export interface StickerPage {
 }
 export interface StickerSearchOptions {
     category?: string;
-    /** Only stickers of this collection (`listCollections`). */
+    /** Only stickers of this collection (`collections()`). */
     collection?: string;
     /** Every tag must match. */
     tags?: string[];
@@ -144,6 +144,8 @@ export interface StickerProvider {
         count: number;
     }>>;
     /** Its collections with counts, when it groups its stickers. Ids stay unique across collections, so `load(id)` needs none. */
+    collections?(): MaybePromise<StickerCollection[]>;
+    /** The older name for `collections()`, still read when a provider has no `collections()`. */
     listCollections?(): MaybePromise<StickerCollection[]>;
 }
 /** `provider:id`, the name of a sticker across providers. A bare editor stamp (`"star"`) means `editor:star`. */

package/dist/stickers/types.d.ts

@@ -61,7 +61,7 @@ export interface StickerSummary {
      * picker or brush can pick the dark one for a dark background without calling `describe` first.
      */
     variants?: StickerVariant[];
-    /** The collection it belongs to (`listCollections`), when the provider groups its stickers. */
+    /** The collection it belongs to (`collections()`), when the provider groups its stickers. */
     collection?: string;
 }
 /** Everything about one sticker. */
@@ -93,7 +93,7 @@ export interface StickerPage {
 }
 export interface StickerSearchOptions {
     category?: string;
-    /** Only stickers of this collection (`listCollections`). */
+    /** Only stickers of this collection (`collections()`). */
     collection?: string;
     /** Every tag must match. */
     tags?: string[];
@@ -144,6 +144,8 @@ export interface StickerProvider {
         count: number;
     }>>;
     /** Its collections with counts, when it groups its stickers. Ids stay unique across collections, so `load(id)` needs none. */
+    collections?(): MaybePromise<StickerCollection[]>;
+    /** The older name for `collections()`, still read when a provider has no `collections()`. */
     listCollections?(): MaybePromise<StickerCollection[]>;
 }
 /** `provider:id`, the name of a sticker across providers. A bare editor stamp (`"star"`) means `editor:star`. */

package/dist/vector/backdrop.d.cts

@@ -0,0 +1,13 @@
+import type { RasterRect } from '../raster/surface.cjs';
+import { type VectorPaintDef } from './gradient.cjs';
+import type { VectorRenderNode } from './render.cjs';
+import type { VectorMatrix } from './types.cjs';
+type M = VectorMatrix;
+/** An SVG `transform` attribute (`matrix`, `translate`, `scale`, `rotate`, in order) as a matrix. */
+export declare function parseVectorTransform(value: string | undefined): M;
+/**
+ * The render data's `nodes` (document space) drawn over `rect` (pixels) through `toPixels`, the
+ * map from document space to those pixels: straight-alpha RGBA, `rect.width × rect.height`.
+ */
+export declare function rasterizeVectorBackdrop(nodes: readonly VectorRenderNode[], defs: readonly VectorPaintDef[], toPixels: VectorMatrix, rect: RasterRect): Uint8ClampedArray;
+export {};

package/dist/vector/backdrop.d.ts

@@ -0,0 +1,13 @@
+import type { RasterRect } from '../raster/surface.js';
+import { type VectorPaintDef } from './gradient.js';
+import type { VectorRenderNode } from './render.js';
+import type { VectorMatrix } from './types.js';
+type M = VectorMatrix;
+/** An SVG `transform` attribute (`matrix`, `translate`, `scale`, `rotate`, in order) as a matrix. */
+export declare function parseVectorTransform(value: string | undefined): M;
+/**
+ * The render data's `nodes` (document space) drawn over `rect` (pixels) through `toPixels`, the
+ * map from document space to those pixels: straight-alpha RGBA, `rect.width × rect.height`.
+ */
+export declare function rasterizeVectorBackdrop(nodes: readonly VectorRenderNode[], defs: readonly VectorPaintDef[], toPixels: VectorMatrix, rect: RasterRect): Uint8ClampedArray;
+export {};