@pixerate/editor 0.262.1 → 0.264.0

package/dist/{chunk-JSDND7DF.cjs → chunk-OTN6VB5S.cjs}

@@ -61,6 +61,9 @@ function stampCoverage(kind, u, v, t) {
   }
 }
 
+// src/stickers/types.ts
+var STICKER_VARIANTS = ["light", "dark"];
+
 // src/stickers/helpers.ts
 var DEFAULT_STICKER_PAGE = 24;
 var MAX_STICKER_PAGE = 100;
@@ -78,6 +81,7 @@ function stickerPage(items, options = {}, query = "") {
   const tags = (_nullishCoalesce(options.tags, () => ( []))).map((t) => t.toLowerCase());
   const matches = items.filter((s) => {
     if (options.category && s.category !== options.category) return false;
+    if (options.collection && s.collection !== options.collection) return false;
     if (tags.length && !tags.every((t) => (_nullishCoalesce(s.tags, () => ( []))).some((x) => x.toLowerCase() === t))) return false;
     if (_optionalChain([options, 'access', _2 => _2.licence, 'optionalAccess', _3 => _3.commercial]) === true && !s.licence.commercial) return false;
     if (!q.length) return true;
@@ -89,6 +93,28 @@ function stickerPage(items, options = {}, query = "") {
   const page = matches.slice(start, start + limit);
   return { items: page, total: matches.length, ...start + limit < matches.length ? { next: String(start + limit) } : {} };
 }
+function stickerVariantsOf(s) {
+  return STICKER_VARIANTS.filter((v) => v === "light" || _optionalChain([s, 'access', _4 => _4.variants, 'optionalAccess', _5 => _5.includes, 'call', _6 => _6(v)]));
+}
+function checkStickerVariant(s, variant) {
+  const v = _nullishCoalesce(variant, () => ( "light"));
+  const has = stickerVariantsOf(s);
+  if (!has.includes(v)) throw new (0, _chunkU67EN7GGcjs.StickerError)("unsupported_variant", `Sticker "${s.id}" has no ${JSON.stringify(v)} variant; it has ${has.join(", ")}.`);
+  return v;
+}
+function stickerVariantFor(s, dark) {
+  return dark && _optionalChain([s, 'access', _7 => _7.variants, 'optionalAccess', _8 => _8.includes, 'call', _9 => _9("dark")]) ? "dark" : "light";
+}
+function stickerCollections(items, names = {}) {
+  const out = /* @__PURE__ */ new Map();
+  for (const s of items) {
+    if (!s.collection) continue;
+    const c = _nullishCoalesce(out.get(s.collection), () => ( { id: s.collection, ..._nullishCoalesce(names[s.collection], () => ( { name: s.collection })), count: 0 }));
+    c.count++;
+    out.set(s.collection, c);
+  }
+  return [...out.values()];
+}
 function parseStickerRef(ref) {
   if (typeof ref !== "string" || !ref) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", 'A sticker ref is a "provider:id" string, e.g. "editor:star" (find_stickers lists them).');
   const i = ref.indexOf(":");
@@ -170,4 +196,9 @@ var StickersSlot = (_class = class {
 
 
 
-exports.STAMP_KINDS = STAMP_KINDS; exports.stampCoverage = stampCoverage; exports.DEFAULT_STICKER_PAGE = DEFAULT_STICKER_PAGE; exports.MAX_STICKER_PAGE = MAX_STICKER_PAGE; exports.EDITOR_STICKERS_ID = EDITOR_STICKERS_ID; exports.checkStickerSearchOptions = checkStickerSearchOptions; exports.stickerPage = stickerPage; exports.parseStickerRef = parseStickerRef; exports.normalizeStickerRef = normalizeStickerRef; exports.editorStampOf = editorStampOf; exports.stickerRefOf = stickerRefOf; exports.stickerIdFor = stickerIdFor; exports.closestStickerRefs = closestStickerRefs; exports.StickersSlot = StickersSlot;
+
+
+
+
+
+exports.STAMP_KINDS = STAMP_KINDS; exports.stampCoverage = stampCoverage; exports.STICKER_VARIANTS = STICKER_VARIANTS; exports.DEFAULT_STICKER_PAGE = DEFAULT_STICKER_PAGE; exports.MAX_STICKER_PAGE = MAX_STICKER_PAGE; exports.EDITOR_STICKERS_ID = EDITOR_STICKERS_ID; exports.checkStickerSearchOptions = checkStickerSearchOptions; exports.stickerPage = stickerPage; exports.stickerVariantsOf = stickerVariantsOf; exports.checkStickerVariant = checkStickerVariant; exports.stickerVariantFor = stickerVariantFor; exports.stickerCollections = stickerCollections; exports.parseStickerRef = parseStickerRef; exports.normalizeStickerRef = normalizeStickerRef; exports.editorStampOf = editorStampOf; exports.stickerRefOf = stickerRefOf; exports.stickerIdFor = stickerIdFor; exports.closestStickerRefs = closestStickerRefs; exports.StickersSlot = StickersSlot;

package/dist/{chunk-AVTPZO4Z.cjs → chunk-PE6YJMQT.cjs}

@@ -4,7 +4,10 @@
 
 
 
-var _chunkJSDND7DFcjs = require('./chunk-JSDND7DF.cjs');
+
+
+
+var _chunkOTN6VB5Scjs = require('./chunk-OTN6VB5S.cjs');
 
 
 var _chunkU67EN7GGcjs = require('./chunk-U67EN7GG.cjs');
@@ -14,26 +17,26 @@ var READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, o
 var WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
 function stickerForAgent(provider, s) {
   const { id, thumbnail: _thumbnail, ...rest } = s;
-  return { ref: _chunkJSDND7DFcjs.stickerRefOf.call(void 0, provider, id), ...rest };
+  return { ref: _chunkOTN6VB5Scjs.stickerRefOf.call(void 0, provider, id), ...rest };
 }
 async function knownRefs(provider, cap = 500) {
   const refs = [];
   let after;
   while (refs.length < cap) {
-    const page = await provider.list({ limit: _chunkJSDND7DFcjs.MAX_STICKER_PAGE, ...after ? { after } : {} });
-    refs.push(...page.items.map((s) => _chunkJSDND7DFcjs.stickerRefOf.call(void 0, provider, s.id)));
+    const page = await provider.list({ limit: _chunkOTN6VB5Scjs.MAX_STICKER_PAGE, ...after ? { after } : {} });
+    refs.push(...page.items.map((s) => _chunkOTN6VB5Scjs.stickerRefOf.call(void 0, provider, s.id)));
     if (!page.next || !page.items.length) break;
     after = page.next;
   }
   return refs;
 }
 async function describeStickerRef(provider, ref) {
-  _chunkJSDND7DFcjs.parseStickerRef.call(void 0, ref);
-  const id = _chunkJSDND7DFcjs.stickerIdFor.call(void 0, provider, ref);
+  _chunkOTN6VB5Scjs.parseStickerRef.call(void 0, ref);
+  const id = _chunkOTN6VB5Scjs.stickerIdFor.call(void 0, provider, ref);
   const found = id === null ? void 0 : await provider.describe(id);
   if (found) return found;
-  const near = _chunkJSDND7DFcjs.closestStickerRefs.call(void 0, ref, await knownRefs(provider));
-  const owner = _chunkJSDND7DFcjs.parseStickerRef.call(void 0, ref).provider;
+  const near = _chunkOTN6VB5Scjs.closestStickerRefs.call(void 0, ref, await knownRefs(provider));
+  const owner = _chunkOTN6VB5Scjs.parseStickerRef.call(void 0, ref).provider;
   const where = id === null && !provider.namespaced ? ` The sticker library is "${provider.id}", not "${owner}".` : "";
   throw new (0, _chunkU67EN7GGcjs.StickerError)("unknown_sticker", `No sticker "${ref}".${where} Closest: ${near.join(", ") || "none"}; find_stickers lists them.`);
 }
@@ -41,70 +44,78 @@ function createStickerTools(options) {
   const find = {
     name: "find_stickers",
     title: "Find stickers",
-    description: "Searches the sticker library (the editor's own stamps unless the host plugged in its own): words in the name, tags, category or description, filtered by category, tags and commercial licence, a small page at a time. Returns each sticker's ref (provider:id, for the tools that spray or place stickers), name, category, tags, natural width and height, formats, whether it is tintable (recoloured to the paint colour) and its licence, plus total and next (pass as after for the next page) and the categories. Changes nothing.",
+    description: "Searches the sticker library (the editor's own stamps unless the host plugged in its own): words in the name, tags, category or description, filtered by category, collection, tags and commercial licence, a small page at a time. Returns each sticker's ref (provider:id, for the tools that spray or place stickers), name, category, tags, natural width and height, formats, whether it is tintable (recoloured to the paint colour), its licence, aiGenerated when the provider says whether AI made the art, variants (light, and dark when it has art for dark backgrounds) and its collection, plus total and next (pass as after for the next page), the categories and the collections. Changes nothing.",
     inputSchema: {
       type: "object",
       properties: {
         query: { type: "string", maxLength: 200, description: "Words to match (default: list everything)." },
         category: { type: "string", description: "Only this category (the result lists them)." },
+        collection: { type: "string", minLength: 1, description: "Only this collection id (the result lists them; default every collection)." },
         tags: { type: "array", maxItems: 10, items: { type: "string", description: "A tag." }, description: "Only stickers with every one of these tags." },
         commercial: { type: "boolean", description: "true: only stickers whose licence allows commercial use." },
-        limit: { type: "integer", minimum: 1, maximum: _chunkJSDND7DFcjs.MAX_STICKER_PAGE, description: "Page size (default 24)." },
+        limit: { type: "integer", minimum: 1, maximum: _chunkOTN6VB5Scjs.MAX_STICKER_PAGE, description: "Page size (default 24)." },
         after: { type: "string", description: "next from the previous page." }
       },
       additionalProperties: false
     },
     annotations: { title: "Find stickers", ...READ },
-    handler: async ({ query, category, tags, commercial, limit, after }) => {
+    handler: async ({ query, category, collection, tags, commercial, limit, after }) => {
       const p = options.provider();
       const categories = await _asyncNullishCoalesce(await _optionalChain([p, 'access', _ => _.categories, 'optionalCall', _2 => _2()]), async () => ( null));
       if (category !== void 0 && categories && !categories.some((c) => c.id === category)) {
         throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `No category "${category}" in "${p.name}"; categories: ${categories.map((c) => c.id).join(", ")}.`);
       }
-      const o = { ...category !== void 0 ? { category } : {}, ...tags ? { tags } : {}, ...commercial ? { licence: { commercial: true } } : {}, ...limit !== void 0 ? { limit } : {}, ...after !== void 0 ? { after } : {} };
+      const collections = await _asyncNullishCoalesce(await _optionalChain([p, 'access', _3 => _3.listCollections, 'optionalCall', _4 => _4()]), async () => ( null));
+      if (collection !== void 0 && !_optionalChain([collections, 'optionalAccess', _5 => _5.some, 'call', _6 => _6((c) => c.id === collection)])) {
+        throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", _optionalChain([collections, 'optionalAccess', _7 => _7.length]) ? `No collection "${collection}" in "${p.name}"; collections: ${collections.map((c) => c.id).join(", ")}.` : `"${p.name}" has no collections; leave collection out.`);
+      }
+      const o = { ...category !== void 0 ? { category } : {}, ...collection !== void 0 ? { collection } : {}, ...tags ? { tags } : {}, ...commercial ? { licence: { commercial: true } } : {}, ...limit !== void 0 ? { limit } : {}, ...after !== void 0 ? { after } : {} };
       const q = typeof query === "string" ? query.trim() : "";
       if (q && !p.capabilities.supportsSearch) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `"${p.name}" can't search; leave query out and filter by category instead.`);
       const page = q ? await p.search(q, o) : await p.list(o);
-      return { provider: p.id, items: page.items.map((s) => stickerForAgent(p, s)), total: page.total, ...page.next ? { next: page.next } : {}, ...categories ? { categories } : {} };
+      return { provider: p.id, items: page.items.map((s) => stickerForAgent(p, s)), total: page.total, ...page.next ? { next: page.next } : {}, ...categories ? { categories } : {}, ..._optionalChain([collections, 'optionalAccess', _8 => _8.length]) ? { collections } : {} };
     }
   };
   const describe = {
     name: "describe_sticker",
     title: "Describe a sticker",
-    description: "Everything about one sticker by ref (from find_stickers): name, category, tags, natural size, formats, tintable, licence (with any attribution it asks for), dominant colours, variants and its outline as SVG path data (silhouette). An unknown ref is refused with the closest refs. Changes nothing.",
+    description: "Everything about one sticker by ref (from find_stickers): name, category, collection, tags, natural size, formats, tintable, licence (with any attribution it asks for), aiGenerated, variants (light / dark), dominant colours and its outline as SVG path data (silhouette). An unknown ref is refused with the closest refs. Changes nothing.",
     inputSchema: { type: "object", properties: { ref: { type: "string", description: "Sticker ref provider:id from find_stickers (e.g. editor:star)." } }, required: ["ref"], additionalProperties: false },
     annotations: { title: "Describe a sticker", ...READ },
     handler: async ({ ref }) => {
       const p = options.provider();
       const d = await describeStickerRef(p, ref);
       const { thumbnail: _thumbnail, id, ...rest } = d;
-      return { ref: _chunkJSDND7DFcjs.stickerRefOf.call(void 0, p, id), ...rest };
+      return { ref: _chunkOTN6VB5Scjs.stickerRefOf.call(void 0, p, id), ...rest };
     }
   };
   return options.insert ? [find, describe, createInsertStickerTool(options.provider, options.insert)] : [find, describe];
 }
-async function loadForHost(provider, ref, d, host, colour, size) {
-  const id = _chunkJSDND7DFcjs.stickerIdFor.call(void 0, provider, ref);
+async function loadForHost(provider, ref, d, host, colour, size, variant) {
+  const id = _chunkOTN6VB5Scjs.stickerIdFor.call(void 0, provider, ref);
   const format = d.formats.includes(host.format) ? host.format : _nullishCoalesce(d.formats[0], () => ( host.format));
-  return provider.load(id, { format, ...format === "png" ? { size: Math.max(8, Math.min(_nullishCoalesce(provider.capabilities.maxSize, () => ( 1024)), Math.round(size))) } : {}, ...colour && d.tintable ? { colour } : {} });
+  return provider.load(id, { format, ...format === "png" ? { size: Math.max(8, Math.min(_nullishCoalesce(provider.capabilities.maxSize, () => ( 1024)), Math.round(size))) } : {}, ...colour && d.tintable ? { colour } : {}, ...variant !== "light" ? { variant } : {} });
 }
 async function insertSticker(provider, host, options) {
   const d = await describeStickerRef(provider, options.ref);
+  const has = _chunkOTN6VB5Scjs.stickerVariantsOf.call(void 0, d);
+  if (options.variant !== void 0 && !has.includes(options.variant)) throw new (0, _chunkU67EN7GGcjs.StickerError)("unsupported_variant", `"${options.ref}" has no ${JSON.stringify(options.variant)} variant; it has ${has.join(", ")}. Leave variant out to pick for the background.`);
+  const variant = _nullishCoalesce(options.variant, () => ( _chunkOTN6VB5Scjs.stickerVariantFor.call(void 0, d, _nullishCoalesce(_optionalChain([host, 'access', _9 => _9.dark, 'optionalCall', _10 => _10()]), () => ( false)))));
   if (options.color !== void 0 && !d.tintable) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `"${options.ref}" is not tintable (its art has its own colours); leave color out, or pick a tintable sticker (find_stickers lists tintable).`);
   if (options.width !== void 0 && !(options.width > 0)) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `width must be a positive size, got ${options.width}.`);
   const w = _nullishCoalesce(options.width, () => ( d.width));
   const h = w * d.height / d.width;
   const centre = host.defaultCentre();
-  const asset = await loadForHost(provider, options.ref, d, host, options.color, Math.max(w, h));
-  const ref = _chunkJSDND7DFcjs.stickerRefOf.call(void 0, provider, d.id);
-  const made = await host.insert({ ref, description: d, asset, x: _nullishCoalesce(options.x, () => ( centre.x)), y: _nullishCoalesce(options.y, () => ( centre.y)), width: w, height: h, ...options.color ? { colour: options.color.toLowerCase() } : {} });
-  return { ...made, ref, width: w, height: h, licence: d.licence };
+  const asset = await loadForHost(provider, options.ref, d, host, options.color, Math.max(w, h), variant);
+  const ref = _chunkOTN6VB5Scjs.stickerRefOf.call(void 0, provider, d.id);
+  const made = await host.insert({ ref, description: d, asset, variant, x: _nullishCoalesce(options.x, () => ( centre.x)), y: _nullishCoalesce(options.y, () => ( centre.y)), width: w, height: h, ...options.color ? { colour: options.color.toLowerCase() } : {} });
+  return { ...made, ref, width: w, height: h, variant, licence: d.licence };
 }
 function createInsertStickerTool(provider, host) {
   return {
     name: "insert_sticker",
     title: "Insert a sticker",
-    description: `Puts one sticker from the sticker library (ref from find_stickers) into the document as a new ${host.noun}, centred at x, y and width wide (its natural aspect kept; default its natural size), tinted to color when the sticker is tintable. Its art is loaded first; an unknown ref is refused with the closest ones. One undo step. Returns the new ${host.noun}'s id (for the editor's own tools, such as effects on it), the ref and its licence (credit any attribution it asks for).`,
+    description: `Puts one sticker from the sticker library (ref from find_stickers) into the document as a new ${host.noun}, centred at x, y and width wide (its natural aspect kept; default its natural size), tinted to color when the sticker is tintable, in its dark variant when the background is dark and it has one (or the variant asked for). Its art is loaded first; an unknown ref is refused with the closest ones. One undo step. Returns the new ${host.noun}'s id (for the editor's own tools, such as effects on it), the ref, the variant used and its licence (credit any attribution it asks for).`,
     inputSchema: {
       type: "object",
       properties: {
@@ -112,13 +123,14 @@ function createInsertStickerTool(provider, host) {
         x: { type: "number", description: "Centre x in document units (default the middle of the view or document)." },
         y: { type: "number", description: "Centre y in document units (default the middle of the view or document)." },
         width: { type: "number", exclusiveMinimum: 0, maximum: 1e4, description: "Width in document units (default the natural width); the height follows the aspect." },
-        color: { type: "string", pattern: "^#[0-9a-fA-F]{6}$", description: "Tint #rrggbb for tintable stickers (default the sticker's own colour); refused for stickers that are not tintable." }
+        color: { type: "string", pattern: "^#[0-9a-fA-F]{6}$", description: "Tint #rrggbb for tintable stickers (default the sticker's own colour); refused for stickers that are not tintable." },
+        variant: { type: "string", enum: [..._chunkOTN6VB5Scjs.STICKER_VARIANTS], description: "light or dark art (default: dark on a dark background when the sticker has it, else light); one the sticker does not list (find_stickers variants) is refused." }
       },
       required: ["ref"],
       additionalProperties: false
     },
     annotations: { title: "Insert a sticker", ...WRITE },
-    handler: ({ ref, x, y, width, color }) => insertSticker(provider(), host, { ref, x, y, width, color })
+    handler: ({ ref, x, y, width, color, variant }) => insertSticker(provider(), host, { ref, x, y, width, color, variant })
   };
 }
 function createStickerToolProvider(options) {

package/dist/{chunk-QAR2N7HZ.js → chunk-ROBSFJ6F.js}

@@ -18,7 +18,7 @@ import {
   unionBounds,
   vectorGradientPoints,
   widthProfileAt
-} from "./chunk-6NZL24W4.js";
+} from "./chunk-WWI6FLH2.js";
 import {
   segmentLength,
   segmentParamAtLength,

package/dist/{chunk-7AUQ2UJ3.cjs → chunk-USJX5SW4.cjs}

@@ -7,7 +7,7 @@
 
 
 
-var _chunkTZOX7KWVcjs = require('./chunk-TZOX7KWV.cjs');
+var _chunkBY5EBP26cjs = require('./chunk-BY5EBP26.cjs');
 
 
 var _chunkCVFAAZXEcjs = require('./chunk-CVFAAZXE.cjs');
@@ -2536,11 +2536,11 @@ function vectorExtrudeFaces(path, params) {
 
 // src/vector/brushstroke.ts
 var VECTOR_BRUSHSTROKE_SCALE = 2;
-var PRESETS = _chunkTZOX7KWVcjs.listPresets.call(void 0, _chunkTZOX7KWVcjs.VECTOR_PROFILE).map((spec) => _chunkTZOX7KWVcjs.BUILTIN_BRUSHES.find((b) => b.id === spec.id));
+var PRESETS = _chunkBY5EBP26cjs.listPresets.call(void 0, _chunkBY5EBP26cjs.VECTOR_PROFILE).map((spec) => _chunkBY5EBP26cjs.BUILTIN_BRUSHES.find((b) => b.id === spec.id));
 function admitted(spec) {
   try {
-    const brush = _chunkTZOX7KWVcjs.normalizeBrushSpec.call(void 0, spec);
-    return _chunkTZOX7KWVcjs.checkBrush.call(void 0, brush, _chunkTZOX7KWVcjs.VECTOR_PROFILE).ok && _chunkPXDIAYB6cjs.isBrushstrokeBrush.call(void 0, _chunkTZOX7KWVcjs.resolveBrush.call(void 0, brush)) ? brush : null;
+    const brush = _chunkBY5EBP26cjs.normalizeBrushSpec.call(void 0, spec);
+    return _chunkBY5EBP26cjs.checkBrush.call(void 0, brush, _chunkBY5EBP26cjs.VECTOR_PROFILE).ok && _chunkPXDIAYB6cjs.isBrushstrokeBrush.call(void 0, _chunkBY5EBP26cjs.resolveBrush.call(void 0, brush)) ? brush : null;
   } catch (e4) {
     return null;
   }
@@ -2549,7 +2549,7 @@ function vectorBrushstrokeBrushes(user = []) {
   const out = [...PRESETS];
   for (const raw of user) {
     const brush = admitted(raw);
-    if (brush && !out.some((b) => b.id === brush.id)) out.push(_chunkTZOX7KWVcjs.resolveBrush.call(void 0, brush));
+    if (brush && !out.some((b) => b.id === brush.id)) out.push(_chunkBY5EBP26cjs.resolveBrush.call(void 0, brush));
   }
   return out;
 }
@@ -2559,7 +2559,7 @@ function vectorBrushstrokeBrush(id) {
 function vectorBrushstrokeBrushOf(brush) {
   if (brush.spec) {
     const saved = admitted(brush.spec);
-    return saved && saved.id === brush.brushId ? _chunkTZOX7KWVcjs.resolveBrush.call(void 0, saved) : null;
+    return saved && saved.id === brush.brushId ? _chunkBY5EBP26cjs.resolveBrush.call(void 0, saved) : null;
   }
   return vectorBrushstrokeBrush(brush.brushId);
 }
@@ -2567,14 +2567,14 @@ function vectorBrushstrokeBrushError(id, user = []) {
   if (vectorBrushstrokeBrush(id)) return null;
   const saved = user.find((b) => b.id === id);
   const ids = vectorBrushstrokeBrushes(user).map((b) => b.id);
-  const reasons = (b) => _chunkTZOX7KWVcjs.checkBrush.call(void 0, b, _chunkTZOX7KWVcjs.VECTOR_PROFILE).issues.filter((i) => i.severity === "error").map((i) => `${i.reason} ${i.fix}`).join(" ") || "it is not a dry dab brush.";
+  const reasons = (b) => _chunkBY5EBP26cjs.checkBrush.call(void 0, b, _chunkBY5EBP26cjs.VECTOR_PROFILE).issues.filter((i) => i.severity === "error").map((i) => `${i.reason} ${i.fix}`).join(" ") || "it is not a dry dab brush.";
   if (saved) return admitted(saved) ? null : `Brush "${id}" (${saved.name}) can't paint a brushstroke: ${reasons(saved)} Use one of: ${ids.join(", ")}.`;
-  const preset = _chunkTZOX7KWVcjs.BRUSH_PRESETS.find((b) => b.id === id);
+  const preset = _chunkBY5EBP26cjs.BRUSH_PRESETS.find((b) => b.id === id);
   if (preset) return `Brush "${id}" (${preset.name}) can't paint a brushstroke: ${reasons(preset)} Use one of: ${ids.join(", ")}.`;
-  return `Unknown brush "${id}". ${_chunkTZOX7KWVcjs.closest.call(void 0, id, ids)}Use one of: ${ids.join(", ")} (vector.listBrushes lists them).`;
+  return `Unknown brush "${id}". ${_chunkBY5EBP26cjs.closest.call(void 0, id, ids)}Use one of: ${ids.join(", ")} (vector.listBrushes lists them).`;
 }
 function vectorBrushstrokeDefaultColour(id, user = [], scheme = "light") {
-  const brush = _nullishCoalesce(_chunkTZOX7KWVcjs.BRUSH_PRESETS.find((b) => b.id === id), () => ( user.find((b) => b.id === id)));
+  const brush = _nullishCoalesce(_chunkBY5EBP26cjs.BRUSH_PRESETS.find((b) => b.id === id), () => ( user.find((b) => b.id === id)));
   return brush ? _chunkLRTR4ASZcjs.brushColourHex.call(void 0, _optionalChain([brush, 'access', _55 => _55.colour, 'optionalAccess', _56 => _56.default]), scheme) : null;
 }
 function sanitizeVectorBrushstroke(value, user = []) {

package/dist/{chunk-3TQW5MPW.cjs → chunk-V7MJ4HIN.cjs}

@@ -5,7 +5,7 @@
 
 
 
-var _chunk7AUQ2UJ3cjs = require('./chunk-7AUQ2UJ3.cjs');
+var _chunkUSJX5SW4cjs = require('./chunk-USJX5SW4.cjs');
 
 
 var _chunkGF2RBSDMcjs = require('./chunk-GF2RBSDM.cjs');
@@ -1361,12 +1361,12 @@ var unit = (x, y) => {
   return l > 1e-12 && Number.isFinite(l) ? [x / l, y / l] : null;
 };
 function cubicOf(sp, i) {
-  const s = _chunk7AUQ2UJ3cjs.subpathSegment.call(void 0, sp, i);
+  const s = _chunkUSJX5SW4cjs.subpathSegment.call(void 0, sp, i);
   if (s.length === 4) return s;
   const [a, b] = s;
   return [a, [a[0] + (b[0] - a[0]) / 3, a[1] + (b[1] - a[1]) / 3], [a[0] + 2 * (b[0] - a[0]) / 3, a[1] + 2 * (b[1] - a[1]) / 3], b];
 }
-var isLine = (sp, i) => _chunk7AUQ2UJ3cjs.subpathSegment.call(void 0, sp, i).length === 2;
+var isLine = (sp, i) => _chunkUSJX5SW4cjs.subpathSegment.call(void 0, sp, i).length === 2;
 function startTangent(c) {
   for (let k = 1; k < 4; k++) {
     const u = unit(c[k][0] - c[0][0], c[k][1] - c[0][1]);
@@ -1386,10 +1386,10 @@ function sample(c, n, out, withStart) {
 }
 var onAnchor = (a, h) => !h || Math.abs(h.x - a.x) < EPS && Math.abs(h.y - a.y) < EPS;
 function tidy(a, keepType = true) {
-  const next = _chunk7AUQ2UJ3cjs.cloneAnchor.call(void 0, a);
+  const next = _chunkUSJX5SW4cjs.cloneAnchor.call(void 0, a);
   if (onAnchor(next, next.in)) delete next.in;
   if (onAnchor(next, next.out)) delete next.out;
-  const shown = _chunk7AUQ2UJ3cjs.inferAnchorType.call(void 0, next);
+  const shown = _chunkUSJX5SW4cjs.inferAnchorType.call(void 0, next);
   const type = keepType && a.type ? a.type === "symmetric" && shown !== "symmetric" ? shown === "corner" ? "corner" : "smooth" : a.type === "smooth" && shown === "corner" ? "corner" : a.type : shown;
   if (type === "corner") delete next.type;
   else next.type = type;
@@ -1433,7 +1433,7 @@ function fitAcross(pts, N, t0, t1) {
   return goldenMin(fit, 0, 1);
 }
 function removeAnchorKeepingShape(sp, index) {
-  const anchors = sp.anchors.map(_chunk7AUQ2UJ3cjs.cloneAnchor);
+  const anchors = sp.anchors.map(_chunkUSJX5SW4cjs.cloneAnchor);
   const n = anchors.length;
   if (index < 0 || index >= n) return { anchors, closed: sp.closed };
   if ((sp.closed || index > 0 && index < n - 1) && n >= 3) {
@@ -1467,12 +1467,12 @@ function removeAnchorKeepingShape(sp, index) {
 }
 function removeAnchorsKeepingShape(sp, indices) {
   const order = [...new Set(indices)].filter((i) => i >= 0 && i < sp.anchors.length).sort((a, b) => b - a);
-  return order.reduce((acc, i) => removeAnchorKeepingShape(acc, i), { anchors: sp.anchors.map(_chunk7AUQ2UJ3cjs.cloneAnchor), closed: sp.closed });
+  return order.reduce((acc, i) => removeAnchorKeepingShape(acc, i), { anchors: sp.anchors.map(_chunkUSJX5SW4cjs.cloneAnchor), closed: sp.closed });
 }
 function bendSegment(sp, segment, t, p) {
-  const anchors = sp.anchors.map(_chunk7AUQ2UJ3cjs.cloneAnchor);
+  const anchors = sp.anchors.map(_chunkUSJX5SW4cjs.cloneAnchor);
   const n = anchors.length;
-  if (segment < 0 || segment >= _chunk7AUQ2UJ3cjs.subpathSegmentCount.call(void 0, sp) || !Number.isFinite(t) || !Number.isFinite(p.x) || !Number.isFinite(p.y)) return { anchors, closed: sp.closed };
+  if (segment < 0 || segment >= _chunkUSJX5SW4cjs.subpathSegmentCount.call(void 0, sp) || !Number.isFinite(t) || !Number.isFinite(p.x) || !Number.isFinite(p.y)) return { anchors, closed: sp.closed };
   const tc = Math.min(0.95, Math.max(0.05, t));
   const ia = segment;
   const ib = (segment + 1) % n;
@@ -1483,16 +1483,16 @@ function bendSegment(sp, segment, t, p) {
   const oy = (p.y - (a.y + (b.y - a.y) * tc)) / k;
   const c1 = { x: a.x + (b.x - a.x) / 3 + ox, y: a.y + (b.y - a.y) / 3 + oy };
   const c2 = { x: b.x + (a.x - b.x) / 3 + ox, y: b.y + (a.y - b.y) / 3 + oy };
-  anchors[ia] = _chunk7AUQ2UJ3cjs.moveAnchorHandle.call(void 0, a, "out", c1);
-  anchors[ib] = _chunk7AUQ2UJ3cjs.moveAnchorHandle.call(void 0, b, "in", c2);
+  anchors[ia] = _chunkUSJX5SW4cjs.moveAnchorHandle.call(void 0, a, "out", c1);
+  anchors[ib] = _chunkUSJX5SW4cjs.moveAnchorHandle.call(void 0, b, "in", c2);
   return { anchors, closed: sp.closed };
 }
 function subpathPointAt(sp, segment, t) {
-  const [x, y] = _chunkGF2RBSDMcjs.segmentPoint.call(void 0, _chunk7AUQ2UJ3cjs.subpathSegment.call(void 0, sp, segment), t);
+  const [x, y] = _chunkGF2RBSDMcjs.segmentPoint.call(void 0, _chunkUSJX5SW4cjs.subpathSegment.call(void 0, sp, segment), t);
   return { x, y };
 }
 function curvatureMoveAnchor(sp, index, q) {
-  const anchors = sp.anchors.map(_chunk7AUQ2UJ3cjs.cloneAnchor);
+  const anchors = sp.anchors.map(_chunkUSJX5SW4cjs.cloneAnchor);
   const a = sp.anchors[index];
   if (!a) return { anchors, closed: sp.closed };
   const own = [
@@ -1538,7 +1538,7 @@ function curvatureMoveAnchor(sp, index, q) {
 function cutSubpathAt(sp, at) {
   const n = sp.anchors.length;
   const cuts = [...new Set(at)].filter((i) => Number.isInteger(i) && i >= 0 && i < n && (sp.closed || i > 0 && i < n - 1)).sort((a, b) => a - b);
-  if (!cuts.length || n < 2) return [{ anchors: sp.anchors.map(_chunk7AUQ2UJ3cjs.cloneAnchor), closed: sp.closed }];
+  if (!cuts.length || n < 2) return [{ anchors: sp.anchors.map(_chunkUSJX5SW4cjs.cloneAnchor), closed: sp.closed }];
   const first = cuts[0];
   const run = sp.closed ? Array.from({ length: n + 1 }, (_, i) => sp.anchors[(first + i) % n]) : sp.anchors;
   const cutSet = new Set(sp.closed ? [...cuts.map((c) => (c - first + n) % n), n] : cuts);
@@ -1546,7 +1546,7 @@ function cutSubpathAt(sp, at) {
   let cur = [];
   run.forEach((a, i) => {
     if (!cutSet.has(i)) {
-      cur.push(_chunk7AUQ2UJ3cjs.cloneAnchor.call(void 0, a));
+      cur.push(_chunkUSJX5SW4cjs.cloneAnchor.call(void 0, a));
       return;
     }
     if (cur.length) {
@@ -1561,10 +1561,10 @@ function cutSubpathAt(sp, at) {
 }
 function splitSubpathAt(sp, segment, t, endTolerance = 1e-6) {
   const n = sp.anchors.length;
-  if (segment < 0 || segment >= _chunk7AUQ2UJ3cjs.subpathSegmentCount.call(void 0, sp)) return [{ anchors: sp.anchors.map(_chunk7AUQ2UJ3cjs.cloneAnchor), closed: sp.closed }];
+  if (segment < 0 || segment >= _chunkUSJX5SW4cjs.subpathSegmentCount.call(void 0, sp)) return [{ anchors: sp.anchors.map(_chunkUSJX5SW4cjs.cloneAnchor), closed: sp.closed }];
   if (t <= endTolerance) return cutSubpathAt(sp, [segment]);
   if (t >= 1 - endTolerance) return cutSubpathAt(sp, [(segment + 1) % n]);
-  const { subpath, index } = _chunk7AUQ2UJ3cjs.insertAnchor.call(void 0, sp, segment, t);
+  const { subpath, index } = _chunkUSJX5SW4cjs.insertAnchor.call(void 0, sp, segment, t);
   return cutSubpathAt(subpath, [index]);
 }
 var endOf = (sp, last) => sp.anchors[last ? sp.anchors.length - 1 : 0];
@@ -1587,7 +1587,7 @@ function joinSubpaths(subpaths, tolerance) {
   const closed = [];
   let open = [];
   for (const sp of subpaths) {
-    const copy = { anchors: sp.anchors.map(_chunk7AUQ2UJ3cjs.cloneAnchor), closed: sp.closed };
+    const copy = { anchors: sp.anchors.map(_chunkUSJX5SW4cjs.cloneAnchor), closed: sp.closed };
     if (sp.closed || sp.anchors.length < 2) {
       if (sp.anchors.length) closed.push(copy);
     } else open.push(copy);
@@ -1642,7 +1642,7 @@ function smoothSubpath(sp, amount = 1, only) {
   const t = Math.min(1, Math.max(0, amount));
   const orig = sp.anchors;
   const n = orig.length;
-  const anchors = orig.map(_chunk7AUQ2UJ3cjs.cloneAnchor);
+  const anchors = orig.map(_chunkUSJX5SW4cjs.cloneAnchor);
   if (n < 3 || t === 0) return { anchors, closed: sp.closed };
   for (let i = 0; i < n; i++) {
     if (!sp.closed && (i === 0 || i === n - 1)) continue;
@@ -1671,8 +1671,8 @@ function smoothSubpath(sp, amount = 1, only) {
 }
 function segsOf(sp) {
   const out = [];
-  for (let i = 0; i < _chunk7AUQ2UJ3cjs.subpathSegmentCount.call(void 0, sp); i++) {
-    const s = _chunk7AUQ2UJ3cjs.subpathSegment.call(void 0, sp, i);
+  for (let i = 0; i < _chunkUSJX5SW4cjs.subpathSegmentCount.call(void 0, sp); i++) {
+    const s = _chunkUSJX5SW4cjs.subpathSegment.call(void 0, sp, i);
     out.push(s.length === 2 ? { c: s, line: true } : { c: s, line: false });
   }
   return out;
@@ -1729,7 +1729,7 @@ function removeRedundantPoints(sp, tolerance) {
   const tol = Math.max(tolerance, 1e-9);
   const types = new Map(sp.anchors.filter((a) => a.type).map((a) => [`${a.x},${a.y}`, a.type]));
   const segs = segsOf(sp).filter((s) => !isZeroSeg(s));
-  if (!segs.length) return { anchors: sp.anchors.map(_chunk7AUQ2UJ3cjs.cloneAnchor), closed: sp.closed };
+  if (!segs.length) return { anchors: sp.anchors.map(_chunkUSJX5SW4cjs.cloneAnchor), closed: sp.closed };
   const minSegs = sp.closed ? 2 : 1;
   let changed = true;
   while (changed && segs.length > minSegs) {
@@ -1747,7 +1747,7 @@ function removeRedundantPoints(sp, tolerance) {
       break;
     }
   }
-  return _nullishCoalesce(segsToSubpath(segs, sp.closed, types), () => ( { anchors: sp.anchors.map(_chunk7AUQ2UJ3cjs.cloneAnchor), closed: sp.closed }));
+  return _nullishCoalesce(segsToSubpath(segs, sp.closed, types), () => ( { anchors: sp.anchors.map(_chunkUSJX5SW4cjs.cloneAnchor), closed: sp.closed }));
 }
 
 

package/dist/{chunk-6NZL24W4.js → chunk-WWI6FLH2.js}

@@ -7,7 +7,7 @@ import {
   listPresets,
   normalizeBrushSpec,
   resolveBrush
-} from "./chunk-5IW65VQ6.js";
+} from "./chunk-EE7SAYBF.js";
 import {
   parseProvenance
 } from "./chunk-M6DNZNVY.js";

package/dist/{chunk-RVGP2XLF.cjs → chunk-XORJ7UZO.cjs}

@@ -4,7 +4,8 @@
 
 
 
-var _chunkJSDND7DFcjs = require('./chunk-JSDND7DF.cjs');
+
+var _chunkOTN6VB5Scjs = require('./chunk-OTN6VB5S.cjs');
 
 
 var _chunkU67EN7GGcjs = require('./chunk-U67EN7GG.cjs');
@@ -32,7 +33,7 @@ var HEX = /^#[0-9a-fA-F]{6}$/;
 function stampOutline(kind) {
   const n = GRID;
   const f = new Float32Array((n + 1) * (n + 1));
-  for (let j = 0; j <= n; j++) for (let i = 0; i <= n; i++) f[j * (n + 1) + i] = _chunkJSDND7DFcjs.stampCoverage.call(void 0, kind, i / n * 2 - 1, j / n * 2 - 1, SHAPE_SEED) - 0.5;
+  for (let j = 0; j <= n; j++) for (let i = 0; i <= n; i++) f[j * (n + 1) + i] = _chunkOTN6VB5Scjs.stampCoverage.call(void 0, kind, i / n * 2 - 1, j / n * 2 - 1, SHAPE_SEED) - 0.5;
   const at = (i, j) => f[j * (n + 1) + i];
   const points = /* @__PURE__ */ new Map();
   const point = (key, i0, j0, i1, j1) => {
@@ -169,7 +170,7 @@ function stampPixels(kind, size, colour) {
   for (let y = 0; y < size; y++) {
     for (let x = 0; x < size; x++) {
       let c = 0;
-      for (let sy = 0; sy < ss; sy++) for (let sx = 0; sx < ss; sx++) c += _chunkJSDND7DFcjs.stampCoverage.call(void 0, kind, (x + (sx + 0.5) / ss) / size * 2 - 1, (y + (sy + 0.5) / ss) / size * 2 - 1, SHAPE_SEED);
+      for (let sy = 0; sy < ss; sy++) for (let sx = 0; sx < ss; sx++) c += _chunkOTN6VB5Scjs.stampCoverage.call(void 0, kind, (x + (sx + 0.5) / ss) / size * 2 - 1, (y + (sy + 0.5) / ss) / size * 2 - 1, SHAPE_SEED);
       const a = Math.round(c / (ss * ss) * 255);
       if (!a) continue;
       const i = (y * size + x) * 4;
@@ -191,24 +192,25 @@ function editorStickers() {
     return { id: k, name: m.name, category: m.category, tags: m.tags, description: m.description, width: BOX, height: BOX, thumbnail: thumbs.get(k), formats: ["svg", "png"], licence: { ...LICENCE }, tintable: true };
   };
   const kind = (id) => {
-    if (!_chunkJSDND7DFcjs.STAMP_KINDS.includes(id)) throw new (0, _chunkU67EN7GGcjs.StickerError)("unknown_sticker", `The editor has no sticker "${id}"; its stickers are ${_chunkJSDND7DFcjs.STAMP_KINDS.join(", ")}.`);
+    if (!_chunkOTN6VB5Scjs.STAMP_KINDS.includes(id)) throw new (0, _chunkU67EN7GGcjs.StickerError)("unknown_sticker", `The editor has no sticker "${id}"; its stickers are ${_chunkOTN6VB5Scjs.STAMP_KINDS.join(", ")}.`);
     return id;
   };
   return {
-    id: _chunkJSDND7DFcjs.EDITOR_STICKERS_ID,
+    id: _chunkOTN6VB5Scjs.EDITOR_STICKERS_ID,
     name: "Editor stickers",
     version: "1",
     capabilities: { supportsSearch: true, supportsSvg: true, supportsRaster: true, maxSize: 1024 },
-    list: (options) => _chunkJSDND7DFcjs.stickerPage.call(void 0, _chunkJSDND7DFcjs.STAMP_KINDS.map(summary), options),
-    search: (query, options) => _chunkJSDND7DFcjs.stickerPage.call(void 0, _chunkJSDND7DFcjs.STAMP_KINDS.map(summary), options, query),
+    list: (options) => _chunkOTN6VB5Scjs.stickerPage.call(void 0, _chunkOTN6VB5Scjs.STAMP_KINDS.map(summary), options),
+    search: (query, options) => _chunkOTN6VB5Scjs.stickerPage.call(void 0, _chunkOTN6VB5Scjs.STAMP_KINDS.map(summary), options, query),
     describe(id) {
-      if (!_chunkJSDND7DFcjs.STAMP_KINDS.includes(id)) return void 0;
+      if (!_chunkOTN6VB5Scjs.STAMP_KINDS.includes(id)) return void 0;
       const k = id;
       return { ...summary(k), silhouette: outline(k), colours: [META[k].colour] };
     },
-    categories: () => [...new Set(_chunkJSDND7DFcjs.STAMP_KINDS.map((k) => META[k].category))].map((c) => ({ id: c, name: c[0].toUpperCase() + c.slice(1), count: _chunkJSDND7DFcjs.STAMP_KINDS.filter((k) => META[k].category === c).length })),
+    categories: () => [...new Set(_chunkOTN6VB5Scjs.STAMP_KINDS.map((k) => META[k].category))].map((c) => ({ id: c, name: c[0].toUpperCase() + c.slice(1), count: _chunkOTN6VB5Scjs.STAMP_KINDS.filter((k) => META[k].category === c).length })),
     load(id, options = {}) {
       const k = kind(id);
+      _chunkOTN6VB5Scjs.checkStickerVariant.call(void 0, { id: k }, options.variant);
       const colour = _nullishCoalesce(options.colour, () => ( META[k].colour));
       if (!HEX.test(colour)) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `colour ${JSON.stringify(colour)} must be #rrggbb.`);
       if (options.format === "png") {
@@ -229,7 +231,7 @@ var StickerBrowser = (_class = class {
   constructor(provider, pageSize = 24) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);
     this.provider = provider;
     this.pageSize = pageSize;
-    this.s = { query: "", category: "", items: [], total: 0, hasMore: false, loading: false, error: null, categories: [], provider: provider().name };
+    this.s = { query: "", category: "", collection: "", items: [], total: 0, hasMore: false, loading: false, error: null, categories: [], collections: [], provider: provider().name };
   }
   
   
@@ -256,8 +258,9 @@ var StickerBrowser = (_class = class {
     this.set({ loading: true, error: null, items: [], total: 0, hasMore: false, provider: p.name });
     try {
       const categories = await _asyncNullishCoalesce(await _optionalChain([p, 'access', _2 => _2.categories, 'optionalCall', _3 => _3()]), async () => ( []));
+      const collections = await _asyncNullishCoalesce(await _optionalChain([p, 'access', _4 => _4.listCollections, 'optionalCall', _5 => _5()]), async () => ( []));
       if (run !== this.run) return;
-      this.set({ categories });
+      this.set({ categories, collections, ...this.s.collection && !collections.some((c) => c.id === this.s.collection) ? { collection: "" } : {} });
       await this.page(run, p, true);
     } catch (e) {
       if (run === this.run) this.set({ loading: false, error: e instanceof Error ? e.message : String(e) });
@@ -273,6 +276,11 @@ var StickerBrowser = (_class = class {
     this.s = { ...this.s, category };
     return this.refresh();
   }
+  /** Shows one collection (`''` for all) from the first page. */
+  setCollection(collection) {
+    this.s = { ...this.s, collection };
+    return this.refresh();
+  }
   /** Loads the next page onto the list. */
   async more() {
     if (!this.next || this.s.loading) return;
@@ -285,12 +293,12 @@ var StickerBrowser = (_class = class {
     }
   }
   async page(run, p, first) {
-    const options = { limit: this.pageSize, ...this.s.category ? { category: this.s.category } : {}, ...!first && this.next ? { after: this.next } : {} };
+    const options = { limit: this.pageSize, ...this.s.category ? { category: this.s.category } : {}, ...this.s.collection ? { collection: this.s.collection } : {}, ...!first && this.next ? { after: this.next } : {} };
     const q = this.s.query.trim();
     const res = q && p.capabilities.supportsSearch ? await p.search(q, options) : await p.list(options);
     if (run !== this.run) return;
     this.next = res.next;
-    const items = res.items.map((s) => ({ ...s, ref: _chunkJSDND7DFcjs.stickerRefOf.call(void 0, p, s.id) }));
+    const items = res.items.map((s) => ({ ...s, ref: _chunkOTN6VB5Scjs.stickerRefOf.call(void 0, p, s.id) }));
     this.set({ items: first ? items : [...this.s.items, ...items], total: res.total, hasMore: Boolean(res.next), loading: false });
   }
 }, _class);

package/dist/image-editor/controller.d.cts

@@ -46,6 +46,7 @@ import { type ProofSetup } from './color-management.cjs';
 import type { EffectPattern } from '../raster/effects/patterns.cjs';
 import { type GlobalLight, type LayerEffect, type LayerEffectKind, type LayerEffects } from '../raster/effects/model.cjs';
 import { type BrushLibrary, type BrushLibraryEntry } from '../brushes/library.cjs';
+import type { BrushPreviewRenderer } from '../brushes/tools.cjs';
 import { type ImageBrushPreset } from './brush-presets.cjs';
 /** What `getSmartObject` reports. */
 export interface SmartObjectInfo {
@@ -1575,6 +1576,8 @@ export declare class ImageEditorController {
     }): string | null;
     /** The brush library the brush presets come from (shared with other editors when the host passes one). */
     readonly brushLibrary: BrushLibrary;
+    /** The `brushPreview` option: draws the brush editor's preview stroke, or `null`. */
+    readonly brushPreview: BrushPreviewRenderer | null;
     /** The brushes this editor can paint with (`IMAGE_PROFILE`): built-in presets, then saved brushes. */
     listBrushPresets(): Promise<BrushLibraryEntry[]>;
     /**

package/dist/image-editor/controller.d.ts

@@ -46,6 +46,7 @@ import { type ProofSetup } from './color-management.js';
 import type { EffectPattern } from '../raster/effects/patterns.js';
 import { type GlobalLight, type LayerEffect, type LayerEffectKind, type LayerEffects } from '../raster/effects/model.js';
 import { type BrushLibrary, type BrushLibraryEntry } from '../brushes/library.js';
+import type { BrushPreviewRenderer } from '../brushes/tools.js';
 import { type ImageBrushPreset } from './brush-presets.js';
 /** What `getSmartObject` reports. */
 export interface SmartObjectInfo {
@@ -1575,6 +1576,8 @@ export declare class ImageEditorController {
     }): string | null;
     /** The brush library the brush presets come from (shared with other editors when the host passes one). */
     readonly brushLibrary: BrushLibrary;
+    /** The `brushPreview` option: draws the brush editor's preview stroke, or `null`. */
+    readonly brushPreview: BrushPreviewRenderer | null;
     /** The brushes this editor can paint with (`IMAGE_PROFILE`): built-in presets, then saved brushes. */
     listBrushPresets(): Promise<BrushLibraryEntry[]>;
     /**