@pixerate/editor 0.249.0 → 0.250.0

package/dist/{chunk-ZEYMKDYS.cjs → chunk-4JNWA3VT.cjs}

@@ -1,5 +1,8 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class;
 
+var _chunkU67EN7GGcjs = require('./chunk-U67EN7GG.cjs');
+
+
 var _chunk3K6HWEXZcjs = require('./chunk-3K6HWEXZ.cjs');
 
 // src/stickers/stamps.ts
@@ -58,25 +61,15 @@ function stampCoverage(kind, u, v, t) {
   }
 }
 
-// src/stickers/errors.ts
-var StickerError = class extends Error {
-  constructor(code, message) {
-    super(message);
-    this.code = code;
-    this.name = "StickerError";
-  }
-  
-};
-
 // src/stickers/helpers.ts
 var DEFAULT_STICKER_PAGE = 24;
 var MAX_STICKER_PAGE = 100;
 var EDITOR_STICKERS_ID = "editor";
 function checkStickerSearchOptions(options = {}) {
   if (options.limit !== void 0 && !(Number.isInteger(options.limit) && options.limit >= 1 && options.limit <= MAX_STICKER_PAGE)) {
-    throw new StickerError("invalid_argument", `limit must be a whole number from 1 to ${MAX_STICKER_PAGE}, got ${options.limit}.`);
+    throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `limit must be a whole number from 1 to ${MAX_STICKER_PAGE}, got ${options.limit}.`);
   }
-  if (options.after !== void 0 && !/^\d+$/.test(options.after)) throw new StickerError("invalid_argument", `after "${options.after}" is not a cursor from this provider; pass the next value of the previous page.`);
+  if (options.after !== void 0 && !/^\d+$/.test(options.after)) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `after "${options.after}" is not a cursor from this provider; pass the next value of the previous page.`);
 }
 var words = (s) => s.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter(Boolean);
 function stickerPage(items, options = {}, query = "") {
@@ -97,13 +90,13 @@ function stickerPage(items, options = {}, query = "") {
   return { items: page, total: matches.length, ...start + limit < matches.length ? { next: String(start + limit) } : {} };
 }
 function parseStickerRef(ref) {
-  if (typeof ref !== "string" || !ref) throw new StickerError("invalid_argument", 'A sticker ref is a "provider:id" string, e.g. "editor:star" (find_stickers lists them).');
+  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(":");
   if (i === -1) {
     if (STAMP_KINDS.includes(ref)) return { provider: EDITOR_STICKERS_ID, id: ref };
-    throw new StickerError("invalid_argument", `"${ref}" is not a sticker ref; refs are "provider:id" (e.g. "editor:${STAMP_KINDS[1]}"); find_stickers lists them.`);
+    throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `"${ref}" is not a sticker ref; refs are "provider:id" (e.g. "editor:${STAMP_KINDS[1]}"); find_stickers lists them.`);
   }
-  if (i === 0 || i === ref.length - 1) throw new StickerError("invalid_argument", `"${ref}" is not a sticker ref; refs are "provider:id".`);
+  if (i === 0 || i === ref.length - 1) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `"${ref}" is not a sticker ref; refs are "provider:id".`);
   return { provider: ref.slice(0, i), id: ref.slice(i + 1) };
 }
 function normalizeStickerRef(ref) {
@@ -164,6 +157,7 @@ var StickersSlot = (_class = class {
 
 // src/stickers/tools.ts
 var READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+var WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
 function stickerForAgent(provider, s) {
   const { id, thumbnail: _thumbnail, ...rest } = s;
   return { ref: stickerRefOf(provider, id), ...rest };
@@ -187,7 +181,7 @@ async function describeStickerRef(provider, ref) {
   const near = closestStickerRefs(ref, await knownRefs(provider));
   const owner = parseStickerRef(ref).provider;
   const where = id === null && !provider.namespaced ? ` The sticker library is "${provider.id}", not "${owner}".` : "";
-  throw new StickerError("unknown_sticker", `No sticker "${ref}".${where} Closest: ${near.join(", ") || "none"}; find_stickers lists them.`);
+  throw new (0, _chunkU67EN7GGcjs.StickerError)("unknown_sticker", `No sticker "${ref}".${where} Closest: ${near.join(", ") || "none"}; find_stickers lists them.`);
 }
 function createStickerTools(options) {
   const find = {
@@ -211,11 +205,11 @@ function createStickerTools(options) {
       const p = options.provider();
       const categories = await _asyncNullishCoalesce(await _optionalChain([p, 'access', _4 => _4.categories, 'optionalCall', _5 => _5()]), async () => ( null));
       if (category !== void 0 && categories && !categories.some((c) => c.id === category)) {
-        throw new StickerError("invalid_argument", `No category "${category}" in "${p.name}"; categories: ${categories.map((c) => c.id).join(", ")}.`);
+        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 q = typeof query === "string" ? query.trim() : "";
-      if (q && !p.capabilities.supportsSearch) throw new StickerError("invalid_argument", `"${p.name}" can't search; leave query out and filter by category instead.`);
+      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 } : {} };
     }
@@ -233,7 +227,45 @@ function createStickerTools(options) {
       return { ref: stickerRefOf(p, id), ...rest };
     }
   };
-  return [find, describe];
+  return options.insert ? [find, describe, createInsertStickerTool(options.provider, options.insert)] : [find, describe];
+}
+async function loadForHost(provider, ref, d, host, colour, size) {
+  const id = stickerIdFor(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 } : {} });
+}
+async function insertSticker(provider, host, options) {
+  const d = await describeStickerRef(provider, options.ref);
+  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 = stickerRefOf(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 };
+}
+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).`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        ref: { type: "string", minLength: 1, description: "Sticker ref provider:id from find_stickers (e.g. editor:star)." },
+        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." }
+      },
+      required: ["ref"],
+      additionalProperties: false
+    },
+    annotations: { title: "Insert a sticker", ...WRITE },
+    handler: ({ ref, x, y, width, color }) => insertSticker(provider(), host, { ref, x, y, width, color })
+  };
 }
 function createStickerToolProvider(options) {
   return {
@@ -266,4 +298,5 @@ function createStickerToolProvider(options) {
 
 
 
-exports.STAMP_KINDS = STAMP_KINDS; exports.stampCoverage = stampCoverage; exports.StickerError = StickerError; 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.stickerForAgent = stickerForAgent; exports.describeStickerRef = describeStickerRef; exports.createStickerTools = createStickerTools; exports.createStickerToolProvider = createStickerToolProvider;
+
+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.stickerForAgent = stickerForAgent; exports.describeStickerRef = describeStickerRef; exports.createStickerTools = createStickerTools; exports.insertSticker = insertSticker; exports.createInsertStickerTool = createInsertStickerTool; exports.createStickerToolProvider = createStickerToolProvider;

package/dist/{chunk-L3JFOTBQ.js → chunk-5E2Q7ZHI.js}

@@ -7,7 +7,7 @@ import {
   EffectsSlot,
   createEffectPixels,
   effectValueErrors
-} from "./chunk-OFH6Q67U.js";
+} from "./chunk-JA57JIT5.js";
 import {
   validateJsonSchema
 } from "./chunk-V2ZCJRDM.js";

package/dist/{chunk-AU6MWQKZ.js → chunk-ABL7IWFZ.js}

@@ -3,7 +3,7 @@ import {
   EffectDisposedError,
   EffectUnsupportedError,
   effectValueErrors
-} from "./chunk-OFH6Q67U.js";
+} from "./chunk-JA57JIT5.js";
 import {
   HistoryManager
 } from "./chunk-NS62CQ2B.js";

package/dist/{chunk-LJRCU3BJ.cjs → chunk-ATK6ABN3.cjs}

@@ -4,8 +4,10 @@
 
 
 
+var _chunk4JNWA3VTcjs = require('./chunk-4JNWA3VT.cjs');
 
-var _chunkZEYMKDYScjs = require('./chunk-ZEYMKDYS.cjs');
+
+var _chunkU67EN7GGcjs = require('./chunk-U67EN7GG.cjs');
 
 
 var _chunkW5M3J7PVcjs = require('./chunk-W5M3J7PV.cjs');
@@ -30,7 +32,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] = _chunkZEYMKDYScjs.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] = _chunk4JNWA3VTcjs.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) => {
@@ -167,7 +169,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 += _chunkZEYMKDYScjs.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 += _chunk4JNWA3VTcjs.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;
@@ -189,32 +191,32 @@ 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 (!_chunkZEYMKDYScjs.STAMP_KINDS.includes(id)) throw new (0, _chunkZEYMKDYScjs.StickerError)("unknown_sticker", `The editor has no sticker "${id}"; its stickers are ${_chunkZEYMKDYScjs.STAMP_KINDS.join(", ")}.`);
+    if (!_chunk4JNWA3VTcjs.STAMP_KINDS.includes(id)) throw new (0, _chunkU67EN7GGcjs.StickerError)("unknown_sticker", `The editor has no sticker "${id}"; its stickers are ${_chunk4JNWA3VTcjs.STAMP_KINDS.join(", ")}.`);
     return id;
   };
   return {
-    id: _chunkZEYMKDYScjs.EDITOR_STICKERS_ID,
+    id: _chunk4JNWA3VTcjs.EDITOR_STICKERS_ID,
     name: "Editor stickers",
     version: "1",
     capabilities: { supportsSearch: true, supportsSvg: true, supportsRaster: true, maxSize: 1024 },
-    list: (options) => _chunkZEYMKDYScjs.stickerPage.call(void 0, _chunkZEYMKDYScjs.STAMP_KINDS.map(summary), options),
-    search: (query, options) => _chunkZEYMKDYScjs.stickerPage.call(void 0, _chunkZEYMKDYScjs.STAMP_KINDS.map(summary), options, query),
+    list: (options) => _chunk4JNWA3VTcjs.stickerPage.call(void 0, _chunk4JNWA3VTcjs.STAMP_KINDS.map(summary), options),
+    search: (query, options) => _chunk4JNWA3VTcjs.stickerPage.call(void 0, _chunk4JNWA3VTcjs.STAMP_KINDS.map(summary), options, query),
     describe(id) {
-      if (!_chunkZEYMKDYScjs.STAMP_KINDS.includes(id)) return void 0;
+      if (!_chunk4JNWA3VTcjs.STAMP_KINDS.includes(id)) return void 0;
       const k = id;
       return { ...summary(k), silhouette: outline(k), colours: [META[k].colour] };
     },
-    categories: () => [...new Set(_chunkZEYMKDYScjs.STAMP_KINDS.map((k) => META[k].category))].map((c) => ({ id: c, name: c[0].toUpperCase() + c.slice(1), count: _chunkZEYMKDYScjs.STAMP_KINDS.filter((k) => META[k].category === c).length })),
+    categories: () => [...new Set(_chunk4JNWA3VTcjs.STAMP_KINDS.map((k) => META[k].category))].map((c) => ({ id: c, name: c[0].toUpperCase() + c.slice(1), count: _chunk4JNWA3VTcjs.STAMP_KINDS.filter((k) => META[k].category === c).length })),
     load(id, options = {}) {
       const k = kind(id);
       const colour = _nullishCoalesce(options.colour, () => ( META[k].colour));
-      if (!HEX.test(colour)) throw new (0, _chunkZEYMKDYScjs.StickerError)("invalid_argument", `colour ${JSON.stringify(colour)} must be #rrggbb.`);
+      if (!HEX.test(colour)) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `colour ${JSON.stringify(colour)} must be #rrggbb.`);
       if (options.format === "png") {
         const size = _nullishCoalesce(options.size, () => ( 256));
-        if (!(Number.isInteger(size) && size >= 8 && size <= 1024)) throw new (0, _chunkZEYMKDYScjs.StickerError)("invalid_argument", `size must be a whole number of px from 8 to 1024, got ${size}.`);
+        if (!(Number.isInteger(size) && size >= 8 && size <= 1024)) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `size must be a whole number of px from 8 to 1024, got ${size}.`);
         return { kind: "image", url: _chunkW5M3J7PVcjs.pngDataUrl.call(void 0, size, size, stampPixels(k, size, colour.toLowerCase())), width: size, height: size };
       }
-      if (options.format !== void 0 && options.format !== "svg") throw new (0, _chunkZEYMKDYScjs.StickerError)("unsupported_format", `format must be svg or png, got ${JSON.stringify(options.format)}.`);
+      if (options.format !== void 0 && options.format !== "svg") throw new (0, _chunkU67EN7GGcjs.StickerError)("unsupported_format", `format must be svg or png, got ${JSON.stringify(options.format)}.`);
       const d = outline(k);
       const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${BOX} ${BOX}" width="${BOX}" height="${BOX}"><path fill="${colour.toLowerCase()}" fill-rule="evenodd" d="${d}"/></svg>`;
       return { kind: "svg", svg, silhouette: d };
@@ -288,7 +290,7 @@ var StickerBrowser = (_class = class {
     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: _chunkZEYMKDYScjs.stickerRefOf.call(void 0, p, s.id) }));
+    const items = res.items.map((s) => ({ ...s, ref: _chunk4JNWA3VTcjs.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/{chunk-H4AOUUBE.cjs → chunk-GT77U7QG.cjs}

@@ -5,8 +5,10 @@
 
 
 
+var _chunk4JNWA3VTcjs = require('./chunk-4JNWA3VT.cjs');
 
-var _chunkZEYMKDYScjs = require('./chunk-ZEYMKDYS.cjs');
+
+var _chunkU67EN7GGcjs = require('./chunk-U67EN7GG.cjs');
 
 
 
@@ -613,7 +615,7 @@ var defaultStickerRasterizer = async (asset, size) => {
   }
   const g = globalThis;
   if (!g.createImageBitmap || !g.OffscreenCanvas) {
-    throw new (0, _chunkZEYMKDYScjs.StickerError)("unsupported_format", `This environment can't draw ${asset.kind === "svg" ? "SVG" : "non-PNG"} sticker art; pass rasterizeSticker in the paint editor's options (or use a provider that offers png).`);
+    throw new (0, _chunkU67EN7GGcjs.StickerError)("unsupported_format", `This environment can't draw ${asset.kind === "svg" ? "SVG" : "non-PNG"} sticker art; pass rasterizeSticker in the paint editor's options (or use a provider that offers png).`);
   }
   const blob = asset.kind === "svg" ? new Blob([asset.svg], { type: "image/svg+xml" }) : await (await g.fetch(asset.url)).blob();
   const bitmap = await g.createImageBitmap(blob);
@@ -635,7 +637,7 @@ var StickerArtCache = (_class4 = class {constructor() { _class4.prototype.__init
   }}
   /** `ready`, `loading`, `failed` (with the reason) or `none` (never asked for). Editor stamps are always `ready`. */
   status(ref) {
-    if (_chunkZEYMKDYScjs.editorStampOf.call(void 0, ref)) return { status: "ready" };
+    if (_chunk4JNWA3VTcjs.editorStampOf.call(void 0, ref)) return { status: "ready" };
     const e = this.entries.get(ref);
     if (!e) return { status: "none" };
     return e.status === "failed" ? { status: "failed", error: e.error } : { status: e.status };
@@ -646,18 +648,18 @@ var StickerArtCache = (_class4 = class {constructor() { _class4.prototype.__init
    * the next call.
    */
   ensure(provider, ref, rasterize) {
-    if (_chunkZEYMKDYScjs.editorStampOf.call(void 0, ref)) return Promise.resolve(null);
+    if (_chunk4JNWA3VTcjs.editorStampOf.call(void 0, ref)) return Promise.resolve(null);
     const e = this.entries.get(ref);
     if (_optionalChain([e, 'optionalAccess', _9 => _9.status]) === "ready") return Promise.resolve(e.art);
     if (_optionalChain([e, 'optionalAccess', _10 => _10.status]) === "loading") return e.promise;
     const promise = (async () => {
-      const d = await _chunkZEYMKDYScjs.describeStickerRef.call(void 0, provider, ref);
-      const id = _chunkZEYMKDYScjs.stickerIdFor.call(void 0, provider, ref);
+      const d = await _chunk4JNWA3VTcjs.describeStickerRef.call(void 0, provider, ref);
+      const id = _chunk4JNWA3VTcjs.stickerIdFor.call(void 0, provider, ref);
       const max = _nullishCoalesce(provider.capabilities.maxSize, () => ( STICKER_ART_SIZE));
       const size = Math.min(STICKER_ART_SIZE, max);
       const asset = await provider.load(id, d.formats.includes("png") ? { format: "png", size } : { format: _nullishCoalesce(d.formats[0], () => ( "svg")), size });
       const px = await rasterize(asset, size);
-      if (!(px.width > 0 && px.height > 0) || px.data.length !== px.width * px.height * 4) throw new (0, _chunkZEYMKDYScjs.StickerError)("load_failed", `The art for "${ref}" came back empty or the wrong size.`);
+      if (!(px.width > 0 && px.height > 0) || px.data.length !== px.width * px.height * 4) throw new (0, _chunkU67EN7GGcjs.StickerError)("load_failed", `The art for "${ref}" came back empty or the wrong size.`);
       return { ...px, tintable: d.tintable };
     })();
     this.entries.set(ref, { status: "loading", promise });
@@ -716,7 +718,7 @@ var unit2 = (v, d) => typeof v === "number" && Number.isFinite(v) ? Math.min(1,
 function normalizeStickerSettings(raw = {}, base = DEFAULT_STICKER) {
   const refs = (list) => list.flatMap((s) => {
     try {
-      return [_chunkZEYMKDYScjs.normalizeStickerRef.call(void 0, s)];
+      return [_chunk4JNWA3VTcjs.normalizeStickerRef.call(void 0, s)];
     } catch (e3) {
       return [];
     }
@@ -744,12 +746,12 @@ function stickerRect(s) {
 function stickerStamp(s) {
   if (s.ref) {
     try {
-      return _chunkZEYMKDYScjs.editorStampOf.call(void 0, s.ref);
+      return _chunk4JNWA3VTcjs.editorStampOf.call(void 0, s.ref);
     } catch (e4) {
       return null;
     }
   }
-  return s.stamp && _chunkZEYMKDYScjs.STAMP_KINDS.includes(s.stamp) ? s.stamp : null;
+  return s.stamp && _chunk4JNWA3VTcjs.STAMP_KINDS.includes(s.stamp) ? s.stamp : null;
 }
 function drawSticker(medium, s, art) {
   const kind = stickerStamp(s);
@@ -774,7 +776,7 @@ function drawSticker(medium, s, art) {
       const v = (-dx * sa + dy * ca) / rad;
       if (u < -1.05 || u > 1.05 || v < -1.05 || v > 1.05) continue;
       let c = 0;
-      for (let k = 0; k < 4; k++) c += _chunkZEYMKDYScjs.stampCoverage.call(void 0, kind, u + ((k & 1) - 0.5) / rad / 2, v + ((k >> 1) - 0.5) / rad / 2, s.seed);
+      for (let k = 0; k < 4; k++) c += _chunk4JNWA3VTcjs.stampCoverage.call(void 0, kind, u + ((k & 1) - 0.5) / rad / 2, v + ((k >> 1) - 0.5) / rad / 2, s.seed);
       c /= 4;
       if (c <= 0) continue;
       cov[p] = c;
@@ -946,12 +948,12 @@ function normalizeStickerUpdate(u) {
   const out = {};
   if (u.ref !== void 0 && u.stamp !== void 0) throw new Error("Give ref or stamp, not both (stamp is the older name for an editor stamp).");
   if (u.stamp !== void 0) {
-    if (!_chunkZEYMKDYScjs.STAMP_KINDS.includes(u.stamp)) throw new Error(`stamp ${JSON.stringify(u.stamp)} is not a stamp; use ${_chunkZEYMKDYScjs.STAMP_KINDS.join(", ")}, or ref for any sticker (find_stickers).`);
+    if (!_chunk4JNWA3VTcjs.STAMP_KINDS.includes(u.stamp)) throw new Error(`stamp ${JSON.stringify(u.stamp)} is not a stamp; use ${_chunk4JNWA3VTcjs.STAMP_KINDS.join(", ")}, or ref for any sticker (find_stickers).`);
     out.ref = `editor:${u.stamp}`;
     out.stamp = u.stamp;
   }
   if (u.ref !== void 0) {
-    out.ref = _chunkZEYMKDYScjs.normalizeStickerRef.call(void 0, u.ref);
+    out.ref = _chunk4JNWA3VTcjs.normalizeStickerRef.call(void 0, u.ref);
     const stamp = stickerStamp({ ref: out.ref });
     if (stamp) out.stamp = stamp;
     else out.stamp = void 0;
@@ -1020,7 +1022,7 @@ function stickerAt(stickers, x, y, art) {
     if (s.size < 16) return s;
     const kind = stickerStamp(s);
     if (kind) {
-      if (_chunkZEYMKDYScjs.stampCoverage.call(void 0, kind, u, v, s.seed) > 0.25) return s;
+      if (_chunk4JNWA3VTcjs.stampCoverage.call(void 0, kind, u, v, s.seed) > 0.25) return s;
       continue;
     }
     const pic = _optionalChain([art, 'optionalCall', _15 => _15(s.ref)]);
@@ -1140,7 +1142,7 @@ var MarkStroke = (_class6 = class {
           for (let sx = 0; sx < ss; sx++) {
             const dx = rect.x + xx + (sx + 0.5) / ss - x;
             const dy = rect.y + yy + (sy + 0.5) / ss - y;
-            sum += _chunkZEYMKDYScjs.stampCoverage.call(void 0, kind, (dx * c + dy * s) * inv, (dy * c - dx * s) * inv, seed);
+            sum += _chunk4JNWA3VTcjs.stampCoverage.call(void 0, kind, (dx * c + dy * s) * inv, (dy * c - dx * s) * inv, seed);
           }
         }
         vals[k] = sum / (ss * ss) * a;
@@ -1219,7 +1221,7 @@ var DEFAULT_PARTICLE = {
 var unit3 = (v, d) => typeof v === "number" && Number.isFinite(v) ? Math.min(1, Math.max(0, v)) : d;
 var oneOf = (v, all, d) => all.includes(v) ? v : d;
 function normalizeParticle(raw = {}, base = DEFAULT_PARTICLE) {
-  const textures = Array.isArray(raw.dotTextures) ? raw.dotTextures.filter((t) => _chunkZEYMKDYScjs.STAMP_KINDS.includes(t)).slice(0, MAX_DOT_TEXTURES) : [..._nullishCoalesce(base.dotTextures, () => ( []))];
+  const textures = Array.isArray(raw.dotTextures) ? raw.dotTextures.filter((t) => _chunk4JNWA3VTcjs.STAMP_KINDS.includes(t)).slice(0, MAX_DOT_TEXTURES) : [..._nullishCoalesce(base.dotTextures, () => ( []))];
   return {
     kind: oneOf(raw.kind, PARTICLE_KINDS, base.kind),
     render: oneOf(raw.render, PARTICLE_RENDERS, base.render),

package/dist/{chunk-GHCSC2WP.cjs → chunk-ISIO63Q5.cjs}

@@ -168,6 +168,10 @@ function applyEffectMask(result, mask, source) {
   }
   return result;
 }
+function layerImageInput(d) {
+  const images = d.inputs.filter((i) => i.kind === "image");
+  return _nullishCoalesce(_optionalChain([(_nullishCoalesce(_nullishCoalesce(images.find((i) => i.name === "source"), () => ( images.find((i) => i.required))), () => ( images[0]))), 'optionalAccess', _9 => _9.name]), () => ( null));
+}
 var EffectsSlot = (_class = class {constructor() { _class.prototype.__init.call(this);_class.prototype.__init2.call(this); }
   __init() {this.current = null}
   __init2() {this.listeners = /* @__PURE__ */ new Set()}
@@ -234,7 +238,7 @@ async function sampleEffectCameraMove(provider, id, request) {
 }
 var cameraMoveField = (role) => role === "transition" ? "in" : "during";
 function cameraMovesFor(catalog, role) {
-  return catalog.filter((e) => e.kind === "camera" && _optionalChain([e, 'access', _9 => _9.camera, 'optionalAccess', _10 => _10.role]) === role);
+  return catalog.filter((e) => e.kind === "camera" && _optionalChain([e, 'access', _10 => _10.camera, 'optionalAccess', _11 => _11.role]) === role);
 }
 function cameraMoveIdList(catalog, role) {
   const ids = cameraMovesFor(catalog, role).map((e) => JSON.stringify(e.id));
@@ -324,12 +328,12 @@ var summaryOut = (e) => ({
   category: e.category,
   uses: e.uses,
   ...e.description ? { description: e.description } : {},
-  ..._optionalChain([e, 'access', _11 => _11.tags, 'optionalAccess', _12 => _12.length]) ? { tags: e.tags } : {},
+  ..._optionalChain([e, 'access', _12 => _12.tags, 'optionalAccess', _13 => _13.length]) ? { tags: e.tags } : {},
   transparent: e.transparent,
   loop: e.loop,
   ...e.duration !== void 0 ? { duration: e.duration } : {},
   ...e.camera ? { camera: e.camera } : {},
-  ..._optionalChain([e, 'access', _13 => _13.accepts, 'optionalAccess', _14 => _14.length]) ? { accepts: e.accepts } : {}
+  ..._optionalChain([e, 'access', _14 => _14.accepts, 'optionalAccess', _15 => _15.length]) ? { accepts: e.accepts } : {}
 });
 function createEffectToolProvider(host) {
   let catalog = null;
@@ -337,7 +341,7 @@ function createEffectToolProvider(host) {
   const notify = () => listeners.forEach((l) => l());
   const catalogFor = (provider) => {
     if (!provider) return null;
-    if (_optionalChain([catalog, 'optionalAccess', _15 => _15.provider]) !== provider) {
+    if (_optionalChain([catalog, 'optionalAccess', _16 => _16.provider]) !== provider) {
       const entry = { provider, effects: null };
       catalog = entry;
       Promise.resolve().then(() => provider.list()).then((effects) => {
@@ -373,8 +377,9 @@ function createEffectToolProvider(host) {
     description: `${what}: control name \u2192 value, as listed by describe_effect (its "controls" schema: types, ranges, units and defaults). Only the given controls change; colours are "#rrggbb".${keyframes ? " A number control may instead be keyframes { keys: [{ t: ms from the start, v, ease }] }." : ""} Unknown controls and out-of-range values are refused with the valid ones.`
   });
   const effectIdSchema = (uses) => {
-    const effects = _optionalChain([catalogFor, 'call', _16 => _16(host.provider()), 'optionalAccess', _17 => _17.filter, 'call', _18 => _18((e) => effectOffered(e, uses))]);
-    const base = `An effect id from search_effects (use ${uses.map((u) => `"${u}"`).join(" or ")}).`;
+    const open = host.applyImageInputs && uses === host.applyUses;
+    const effects = open ? void 0 : _optionalChain([catalogFor, 'call', _17 => _17(host.provider()), 'optionalAccess', _18 => _18.filter, 'call', _19 => _19((e) => effectOffered(e, uses))]);
+    const base = `An effect id from search_effects (use ${uses.map((u) => `"${u}"`).join(" or ")}${open ? `, or any effect whose describe_effect inputs take an image: the ${host.target.noun} is its picture` : ""}).`;
     return effects && effects.length && effects.length <= ENUM_LIMIT ? { type: "string", enum: effects.map((e) => e.id), description: `${base} One of: ${effects.map((e) => `${e.id} (${e.name})`).join(", ")}.` } : { type: "string", minLength: 1, description: base };
   };
   const context = { requireProvider: writable, valuesSchema, effectIdSchema, annotations: ANNOTATIONS };
@@ -403,8 +408,8 @@ function createEffectToolProvider(host) {
         if (!p) return { available: false, reason: NO_PROVIDER, effects: [], total: 0 };
         const tags = args.tags;
         const accepts = args.accepts;
-        let found = (await explain(async () => p.search(_nullishCoalesce(args.query, () => ( "")), { kind: args.kind, category: args.category, use: args.use, tags, ..._optionalChain([accepts, 'optionalAccess', _19 => _19.length]) ? { accepts } : {} }))).filter((e) => hasEffectTags(e, tags));
-        if (_optionalChain([accepts, 'optionalAccess', _20 => _20.includes, 'call', _21 => _21("path")])) {
+        let found = (await explain(async () => p.search(_nullishCoalesce(args.query, () => ( "")), { kind: args.kind, category: args.category, use: args.use, tags, ..._optionalChain([accepts, 'optionalAccess', _20 => _20.length]) ? { accepts } : {} }))).filter((e) => hasEffectTags(e, tags));
+        if (_optionalChain([accepts, 'optionalAccess', _21 => _21.includes, 'call', _22 => _22("path")])) {
           const kept = [];
           for (const e of found) {
             if (e.accepts) {
@@ -415,7 +420,7 @@ function createEffectToolProvider(host) {
         }
         const limit = _nullishCoalesce(args.limit, () => ( 20));
         const out = { available: true, provider: { id: p.id, name: p.name, capabilities: p.capabilities }, effects: found.slice(0, limit).map(summaryOut), total: found.length, tags: countEffectTags(found).slice(0, TAG_LIMIT) };
-        if (_optionalChain([tags, 'optionalAccess', _22 => _22.length]) && !found.length) {
+        if (_optionalChain([tags, 'optionalAccess', _23 => _23.length]) && !found.length) {
           const known = countEffectTags(await explain(async () => p.list()));
           const have = new Set(known.map((k) => k.tag));
           const unknown = tags.filter((t) => !have.has(normaliseEffectTag(t)));
@@ -435,7 +440,7 @@ function createEffectToolProvider(host) {
         if (!p) return { available: false, reason: NO_PROVIDER };
         const d = await explain(async () => p.describe(args.effect));
         const pathControls = pathControlsOf(d);
-        return { available: true, ...summaryOut(d), controls: d.controls, defaults: d.defaults, presets: d.presets, inputs: d.inputs, appliesHere: effectOffered(d, host.applyUses), ...pathControls.length ? { pathControls } : {} };
+        return { available: true, ...summaryOut(d), controls: d.controls, defaults: d.defaults, presets: d.presets, inputs: d.inputs, appliesHere: effectOffered(d, host.applyUses) || !!host.applyImageInputs && d.kind !== "motion" && layerImageInput(d) !== null, ...pathControls.length ? { pathControls } : {} };
       }
     },
     {
@@ -531,16 +536,16 @@ function createEffectToolProvider(host) {
     ...host.description ? { description: host.description } : {},
     ...host.skill ? { skill: host.skill } : {},
     tools: () => {
-      const extra = _nullishCoalesce(_optionalChain([host, 'access', _23 => _23.extraTools, 'optionalCall', _24 => _24(context)]), () => ( []));
-      if (host.readOnlyReason()) return [...readTools(), ...extra.filter((t) => _optionalChain([t, 'access', _25 => _25.annotations, 'optionalAccess', _26 => _26.readOnlyHint]))];
+      const extra = _nullishCoalesce(_optionalChain([host, 'access', _24 => _24.extraTools, 'optionalCall', _25 => _25(context)]), () => ( []));
+      if (host.readOnlyReason()) return [...readTools(), ...extra.filter((t) => _optionalChain([t, 'access', _26 => _26.annotations, 'optionalAccess', _27 => _27.readOnlyHint]))];
       return [...readTools(), ...writeTools(), ...extra];
     },
     subscribe: (l) => {
       listeners.add(l);
-      const off = _optionalChain([host, 'access', _27 => _27.subscribe, 'optionalCall', _28 => _28(l)]);
+      const off = _optionalChain([host, 'access', _28 => _28.subscribe, 'optionalCall', _29 => _29(l)]);
       return () => {
         listeners.delete(l);
-        _optionalChain([off, 'optionalCall', _29 => _29()]);
+        _optionalChain([off, 'optionalCall', _30 => _30()]);
       };
     }
   };
@@ -592,4 +597,5 @@ function createEffectToolProvider(host) {
 
 
 
-exports.EFFECT_KINDS = EFFECT_KINDS; exports.EFFECT_USES = EFFECT_USES; exports.CAMERA_MOVE_ROLES = CAMERA_MOVE_ROLES; exports.EFFECT_ACCEPTS = EFFECT_ACCEPTS; exports.EFFECT_PATH_FORMAT = EFFECT_PATH_FORMAT; exports.EFFECT_SUBJECT_KINDS = EFFECT_SUBJECT_KINDS; exports.EFFECT_LAYER_ROLES = EFFECT_LAYER_ROLES; exports.EFFECT_TRANSITION_MS = EFFECT_TRANSITION_MS; exports.EFFECT_TEMPLATE_SLOT_TYPES = EFFECT_TEMPLATE_SLOT_TYPES; exports.EFFECT_ERROR_CODES = EFFECT_ERROR_CODES; exports.EffectError = EffectError; exports.UnknownEffectError = UnknownEffectError; exports.UnknownTemplateError = UnknownTemplateError; exports.EffectControlError = EffectControlError; exports.EffectUnsupportedError = EffectUnsupportedError; exports.EffectDisposedError = EffectDisposedError; exports.NoEffectsProviderError = NoEffectsProviderError; exports.isEffectError = isEffectError; exports.effectValueErrors = effectValueErrors; exports.resolveEffectValues = resolveEffectValues; exports.effectOffered = effectOffered; exports.normaliseEffectTag = normaliseEffectTag; exports.hasEffectTags = hasEffectTags; exports.countEffectTags = countEffectTags; exports.pathControlsOf = pathControlsOf; exports.searchEffectSummaries = searchEffectSummaries; exports.createEffectPixels = createEffectPixels; exports.isEffectPixels = isEffectPixels; exports.srgbToLinear = srgbToLinear; exports.linearToSrgb = linearToSrgb; exports.encodeEffectFloat = encodeEffectFloat; exports.applyEffectMask = applyEffectMask; exports.EffectsSlot = EffectsSlot; exports.isCameraView = isCameraView; exports.sampleCameraViews = sampleCameraViews; exports.sampleEffectCameraMove = sampleEffectCameraMove; exports.cameraMoveField = cameraMoveField; exports.cameraMovesFor = cameraMovesFor; exports.cameraMoveIdList = cameraMoveIdList; exports.cameraMoveParts = cameraMoveParts; exports.CAMERA_MOVE_MAX_MS = CAMERA_MOVE_MAX_MS; exports.resolveCameraMoveSpec = resolveCameraMoveSpec; exports.cameraViewOfBox = cameraViewOfBox; exports.cameraBoxOfView = cameraBoxOfView; exports.createEffectToolProvider = createEffectToolProvider;
+
+exports.EFFECT_KINDS = EFFECT_KINDS; exports.EFFECT_USES = EFFECT_USES; exports.CAMERA_MOVE_ROLES = CAMERA_MOVE_ROLES; exports.EFFECT_ACCEPTS = EFFECT_ACCEPTS; exports.EFFECT_PATH_FORMAT = EFFECT_PATH_FORMAT; exports.EFFECT_SUBJECT_KINDS = EFFECT_SUBJECT_KINDS; exports.EFFECT_LAYER_ROLES = EFFECT_LAYER_ROLES; exports.EFFECT_TRANSITION_MS = EFFECT_TRANSITION_MS; exports.EFFECT_TEMPLATE_SLOT_TYPES = EFFECT_TEMPLATE_SLOT_TYPES; exports.EFFECT_ERROR_CODES = EFFECT_ERROR_CODES; exports.EffectError = EffectError; exports.UnknownEffectError = UnknownEffectError; exports.UnknownTemplateError = UnknownTemplateError; exports.EffectControlError = EffectControlError; exports.EffectUnsupportedError = EffectUnsupportedError; exports.EffectDisposedError = EffectDisposedError; exports.NoEffectsProviderError = NoEffectsProviderError; exports.isEffectError = isEffectError; exports.effectValueErrors = effectValueErrors; exports.resolveEffectValues = resolveEffectValues; exports.effectOffered = effectOffered; exports.normaliseEffectTag = normaliseEffectTag; exports.hasEffectTags = hasEffectTags; exports.countEffectTags = countEffectTags; exports.pathControlsOf = pathControlsOf; exports.searchEffectSummaries = searchEffectSummaries; exports.createEffectPixels = createEffectPixels; exports.isEffectPixels = isEffectPixels; exports.srgbToLinear = srgbToLinear; exports.linearToSrgb = linearToSrgb; exports.encodeEffectFloat = encodeEffectFloat; exports.applyEffectMask = applyEffectMask; exports.layerImageInput = layerImageInput; exports.EffectsSlot = EffectsSlot; exports.isCameraView = isCameraView; exports.sampleCameraViews = sampleCameraViews; exports.sampleEffectCameraMove = sampleEffectCameraMove; exports.cameraMoveField = cameraMoveField; exports.cameraMovesFor = cameraMovesFor; exports.cameraMoveIdList = cameraMoveIdList; exports.cameraMoveParts = cameraMoveParts; exports.CAMERA_MOVE_MAX_MS = CAMERA_MOVE_MAX_MS; exports.resolveCameraMoveSpec = resolveCameraMoveSpec; exports.cameraViewOfBox = cameraViewOfBox; exports.cameraBoxOfView = cameraBoxOfView; exports.createEffectToolProvider = createEffectToolProvider;

package/dist/{chunk-OFH6Q67U.js → chunk-JA57JIT5.js}

@@ -168,6 +168,10 @@ function applyEffectMask(result, mask, source) {
   }
   return result;
 }
+function layerImageInput(d) {
+  const images = d.inputs.filter((i) => i.kind === "image");
+  return (images.find((i) => i.name === "source") ?? images.find((i) => i.required) ?? images[0])?.name ?? null;
+}
 var EffectsSlot = class {
   current = null;
   listeners = /* @__PURE__ */ new Set();
@@ -373,8 +377,9 @@ function createEffectToolProvider(host) {
     description: `${what}: control name \u2192 value, as listed by describe_effect (its "controls" schema: types, ranges, units and defaults). Only the given controls change; colours are "#rrggbb".${keyframes ? " A number control may instead be keyframes { keys: [{ t: ms from the start, v, ease }] }." : ""} Unknown controls and out-of-range values are refused with the valid ones.`
   });
   const effectIdSchema = (uses) => {
-    const effects = catalogFor(host.provider())?.filter((e) => effectOffered(e, uses));
-    const base = `An effect id from search_effects (use ${uses.map((u) => `"${u}"`).join(" or ")}).`;
+    const open = host.applyImageInputs && uses === host.applyUses;
+    const effects = open ? void 0 : catalogFor(host.provider())?.filter((e) => effectOffered(e, uses));
+    const base = `An effect id from search_effects (use ${uses.map((u) => `"${u}"`).join(" or ")}${open ? `, or any effect whose describe_effect inputs take an image: the ${host.target.noun} is its picture` : ""}).`;
     return effects && effects.length && effects.length <= ENUM_LIMIT ? { type: "string", enum: effects.map((e) => e.id), description: `${base} One of: ${effects.map((e) => `${e.id} (${e.name})`).join(", ")}.` } : { type: "string", minLength: 1, description: base };
   };
   const context = { requireProvider: writable, valuesSchema, effectIdSchema, annotations: ANNOTATIONS };
@@ -435,7 +440,7 @@ function createEffectToolProvider(host) {
         if (!p) return { available: false, reason: NO_PROVIDER };
         const d = await explain(async () => p.describe(args.effect));
         const pathControls = pathControlsOf(d);
-        return { available: true, ...summaryOut(d), controls: d.controls, defaults: d.defaults, presets: d.presets, inputs: d.inputs, appliesHere: effectOffered(d, host.applyUses), ...pathControls.length ? { pathControls } : {} };
+        return { available: true, ...summaryOut(d), controls: d.controls, defaults: d.defaults, presets: d.presets, inputs: d.inputs, appliesHere: effectOffered(d, host.applyUses) || !!host.applyImageInputs && d.kind !== "motion" && layerImageInput(d) !== null, ...pathControls.length ? { pathControls } : {} };
       }
     },
     {
@@ -579,6 +584,7 @@ export {
   linearToSrgb,
   encodeEffectFloat,
   applyEffectMask,
+  layerImageInput,
   EffectsSlot,
   isCameraView,
   sampleCameraViews,

package/dist/{chunk-PZP2SZIZ.js → chunk-KDLBJ6QR.js}

@@ -1,6 +1,6 @@
 import {
   BUILTIN_BRUSHES
-} from "./chunk-J7T5QZ45.js";
+} from "./chunk-OTEPAQJX.js";
 import {
   parseProvenance
 } from "./chunk-M6DNZNVY.js";