@pixerate/editor 0.249.0 → 0.250.0

package/dist/paint-editor/index.js

@@ -1,10 +1,10 @@
 import {
   StickerBrowser,
   editorStickers
-} from "../chunk-EJLRBS5Q.js";
+} from "../chunk-U4NUOKBT.js";
 import {
   toVideoFfmpeg
-} from "../chunk-L3JFOTBQ.js";
+} from "../chunk-5E2Q7ZHI.js";
 import {
   createLayerEffectTools,
   deserializeLayers,
@@ -12,7 +12,7 @@ import {
   resolveExternalAssets,
   serializeLayers,
   serializeLayersExternal
-} from "../chunk-UBRJOIR5.js";
+} from "../chunk-3TWOCSCY.js";
 import "../chunk-3CI7FRMK.js";
 import "../chunk-ZNA3IQZF.js";
 import {
@@ -68,7 +68,7 @@ import {
   realPresenceClock,
   tweenPresenceCursor
 } from "../chunk-IVSWRVB4.js";
-import "../chunk-PZP2SZIZ.js";
+import "../chunk-KDLBJ6QR.js";
 import {
   BRUSH_ID,
   BRUSH_ROTATIONS,
@@ -155,7 +155,7 @@ import {
   tiltToOrientation,
   toStrokePoint,
   usesPaintExchange
-} from "../chunk-J7T5QZ45.js";
+} from "../chunk-OTEPAQJX.js";
 import {
   STAMP_KINDS,
   StickersSlot,
@@ -163,10 +163,11 @@ import {
   editorStampOf,
   normalizeStickerRef,
   stampCoverage
-} from "../chunk-5RH3VXAK.js";
+} from "../chunk-WKH5ZAUA.js";
 import "../chunk-M6DNZNVY.js";
 import "../chunk-WEIK3UYB.js";
 import "../chunk-PWBZH3FK.js";
+import "../chunk-SZTI6EER.js";
 import {
   EffectRendererPool
 } from "../chunk-EHLOCVWB.js";
@@ -175,7 +176,7 @@ import {
   EffectsSlot,
   createEffectToolProvider,
   resolveEffectValues
-} from "../chunk-OFH6Q67U.js";
+} from "../chunk-JA57JIT5.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   CoverageMap,

package/dist/stickers/index.cjs

@@ -3,7 +3,7 @@
 
 
 
-var _chunkLJRCU3BJcjs = require('../chunk-LJRCU3BJ.cjs');
+var _chunkATK6ABN3cjs = require('../chunk-ATK6ABN3.cjs');
 
 
 
@@ -24,7 +24,11 @@ var _chunkLJRCU3BJcjs = require('../chunk-LJRCU3BJ.cjs');
 
 
 
-var _chunkZEYMKDYScjs = require('../chunk-ZEYMKDYS.cjs');
+
+var _chunk4JNWA3VTcjs = require('../chunk-4JNWA3VT.cjs');
+
+
+var _chunkU67EN7GGcjs = require('../chunk-U67EN7GG.cjs');
 require('../chunk-3K6HWEXZ.cjs');
 
 
@@ -91,8 +95,8 @@ function createFakeStickerProvider(options = {}) {
     name: "Fake stickers",
     version: "1",
     capabilities: { supportsSearch: true, supportsSvg: true, supportsRaster: true, maxSize: 512 },
-    list: (o) => _chunkZEYMKDYScjs.stickerPage.call(void 0, summaries, o),
-    search: (q, o) => _chunkZEYMKDYScjs.stickerPage.call(void 0, summaries, o, q),
+    list: (o) => _chunk4JNWA3VTcjs.stickerPage.call(void 0, summaries, o),
+    search: (q, o) => _chunk4JNWA3VTcjs.stickerPage.call(void 0, summaries, o, q),
     describe(id) {
       const s = find(id);
       if (!s) return void 0;
@@ -102,12 +106,12 @@ function createFakeStickerProvider(options = {}) {
     async load(id, o = {}) {
       if (options.loadDelayMs) await new Promise((r) => setTimeout(r, options.loadDelayMs));
       const s = find(id);
-      if (!s) throw new (0, _chunkZEYMKDYScjs.StickerError)("unknown_sticker", `No fake sticker "${id}".`);
-      if (_optionalChain([options, 'access', _ => _.failIds, 'optionalAccess', _2 => _2.includes, 'call', _3 => _3(id)])) throw new (0, _chunkZEYMKDYScjs.StickerError)("load_failed", `The fake sticker "${id}" failed to load (failIds).`);
+      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 fill = s.shape === "badge" && o.colour ? o.colour.toLowerCase() : s.colours[0];
       if (o.format === "png") {
         const size = _nullishCoalesce(o.size, () => ( 128));
-        if (!(Number.isInteger(size) && size >= 8 && size <= 512)) throw new (0, _chunkZEYMKDYScjs.StickerError)("invalid_argument", `size must be 8..512 px, got ${size}.`);
+        if (!(Number.isInteger(size) && size >= 8 && size <= 512)) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `size must be 8..512 px, got ${size}.`);
         return { kind: "image", url: _chunkW5M3J7PVcjs.pngDataUrl.call(void 0, size, size, pixelsOf(s, size, fill)), width: size, height: size };
       }
       return { kind: "svg", svg: svgOf(s, fill) };
@@ -119,23 +123,23 @@ function createFakeStickerProvider(options = {}) {
 function combineStickerProviders(providers, options = {}) {
   const ids = providers.map((p) => p.id);
   const dup = ids.find((id, i) => ids.indexOf(id) !== i);
-  if (dup) throw new (0, _chunkZEYMKDYScjs.StickerError)("invalid_argument", `Two sticker providers have the id "${dup}"; give each a unique id.`);
+  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 } = _chunkZEYMKDYScjs.parseStickerRef.call(void 0, ref);
+    const { provider, id } = _chunk4JNWA3VTcjs.parseStickerRef.call(void 0, ref);
     const p = byId.get(provider);
-    if (!p) throw new (0, _chunkZEYMKDYScjs.StickerError)("unknown_provider", `No sticker provider "${provider}"; the providers are ${ids.join(", ") || "none"}.`);
+    if (!p) throw new (0, _chunkU67EN7GGcjs.StickerError)("unknown_provider", `No sticker provider "${provider}"; the providers are ${ids.join(", ") || "none"}.`);
     return { p, id };
   };
-  const prefix = (p, s) => ({ ...s, id: _chunkZEYMKDYScjs.stickerRefOf.call(void 0, p, s.id) });
+  const prefix = (p, s) => ({ ...s, id: _chunk4JNWA3VTcjs.stickerRefOf.call(void 0, p, s.id) });
   const page = async (query, o = {}) => {
-    const { after, limit = _chunkZEYMKDYScjs.DEFAULT_STICKER_PAGE, ...filters } = o;
-    _chunkZEYMKDYScjs.checkStickerSearchOptions.call(void 0, { limit });
+    const { after, limit = _chunk4JNWA3VTcjs.DEFAULT_STICKER_PAGE, ...filters } = o;
+    _chunk4JNWA3VTcjs.checkStickerSearchOptions.call(void 0, { limit });
     let i = 0;
     let inner;
     if (after !== void 0) {
       const m = /^(\d+)\|(.*)$/.exec(after);
-      if (!m || Number(m[1]) >= providers.length) throw new (0, _chunkZEYMKDYScjs.StickerError)("invalid_argument", `after "${after}" is not a cursor from this provider; pass the next value of the previous page.`);
+      if (!m || Number(m[1]) >= providers.length) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `after "${after}" is not a cursor from this provider; pass the next value of the previous page.`);
       i = Number(m[1]);
       inner = m[2] || void 0;
     }
@@ -179,7 +183,7 @@ function combineStickerProviders(providers, options = {}) {
         return void 0;
       }
       const d = await o.p.describe(o.id);
-      return d ? { ...d, id: _chunkZEYMKDYScjs.stickerRefOf.call(void 0, o.p, d.id) } : void 0;
+      return d ? { ...d, id: _chunk4JNWA3VTcjs.stickerRefOf.call(void 0, o.p, d.id) } : void 0;
     },
     async load(ref, o) {
       const { p, id } = owner(ref);
@@ -328,4 +332,6 @@ async function checkStickerProvider(provider, options = {}) {
 
 
 
-exports.DEFAULT_STICKER_PAGE = _chunkZEYMKDYScjs.DEFAULT_STICKER_PAGE; exports.EDITOR_STICKERS_ID = _chunkZEYMKDYScjs.EDITOR_STICKERS_ID; exports.MAX_STICKER_PAGE = _chunkZEYMKDYScjs.MAX_STICKER_PAGE; exports.STAMP_KINDS = _chunkZEYMKDYScjs.STAMP_KINDS; exports.StickerBrowser = _chunkLJRCU3BJcjs.StickerBrowser; exports.StickerError = _chunkZEYMKDYScjs.StickerError; exports.StickersSlot = _chunkZEYMKDYScjs.StickersSlot; exports.checkStickerProvider = checkStickerProvider; exports.checkStickerSearchOptions = _chunkZEYMKDYScjs.checkStickerSearchOptions; exports.closestStickerRefs = _chunkZEYMKDYScjs.closestStickerRefs; exports.combineStickerProviders = combineStickerProviders; exports.createFakeStickerProvider = createFakeStickerProvider; exports.createStickerToolProvider = _chunkZEYMKDYScjs.createStickerToolProvider; exports.createStickerTools = _chunkZEYMKDYScjs.createStickerTools; exports.describeStickerRef = _chunkZEYMKDYScjs.describeStickerRef; exports.editorStampOf = _chunkZEYMKDYScjs.editorStampOf; exports.editorStickers = _chunkLJRCU3BJcjs.editorStickers; exports.normalizeStickerRef = _chunkZEYMKDYScjs.normalizeStickerRef; exports.parseStickerRef = _chunkZEYMKDYScjs.parseStickerRef; exports.stampCoverage = _chunkZEYMKDYScjs.stampCoverage; exports.stampOutline = _chunkLJRCU3BJcjs.stampOutline; exports.stampPixels = _chunkLJRCU3BJcjs.stampPixels; exports.stickerForAgent = _chunkZEYMKDYScjs.stickerForAgent; exports.stickerIdFor = _chunkZEYMKDYScjs.stickerIdFor; exports.stickerPage = _chunkZEYMKDYScjs.stickerPage; exports.stickerRefOf = _chunkZEYMKDYScjs.stickerRefOf;
+
+
+exports.DEFAULT_STICKER_PAGE = _chunk4JNWA3VTcjs.DEFAULT_STICKER_PAGE; exports.EDITOR_STICKERS_ID = _chunk4JNWA3VTcjs.EDITOR_STICKERS_ID; exports.MAX_STICKER_PAGE = _chunk4JNWA3VTcjs.MAX_STICKER_PAGE; exports.STAMP_KINDS = _chunk4JNWA3VTcjs.STAMP_KINDS; exports.StickerBrowser = _chunkATK6ABN3cjs.StickerBrowser; exports.StickerError = _chunkU67EN7GGcjs.StickerError; exports.StickersSlot = _chunk4JNWA3VTcjs.StickersSlot; exports.checkStickerProvider = checkStickerProvider; exports.checkStickerSearchOptions = _chunk4JNWA3VTcjs.checkStickerSearchOptions; exports.closestStickerRefs = _chunk4JNWA3VTcjs.closestStickerRefs; exports.combineStickerProviders = combineStickerProviders; exports.createFakeStickerProvider = createFakeStickerProvider; exports.createInsertStickerTool = _chunk4JNWA3VTcjs.createInsertStickerTool; exports.createStickerToolProvider = _chunk4JNWA3VTcjs.createStickerToolProvider; exports.createStickerTools = _chunk4JNWA3VTcjs.createStickerTools; exports.describeStickerRef = _chunk4JNWA3VTcjs.describeStickerRef; exports.editorStampOf = _chunk4JNWA3VTcjs.editorStampOf; exports.editorStickers = _chunkATK6ABN3cjs.editorStickers; exports.insertSticker = _chunk4JNWA3VTcjs.insertSticker; exports.normalizeStickerRef = _chunk4JNWA3VTcjs.normalizeStickerRef; exports.parseStickerRef = _chunk4JNWA3VTcjs.parseStickerRef; exports.stampCoverage = _chunk4JNWA3VTcjs.stampCoverage; exports.stampOutline = _chunkATK6ABN3cjs.stampOutline; exports.stampPixels = _chunkATK6ABN3cjs.stampPixels; exports.stickerForAgent = _chunk4JNWA3VTcjs.stickerForAgent; exports.stickerIdFor = _chunk4JNWA3VTcjs.stickerIdFor; exports.stickerPage = _chunk4JNWA3VTcjs.stickerPage; exports.stickerRefOf = _chunk4JNWA3VTcjs.stickerRefOf;

package/dist/stickers/index.d.cts

@@ -12,5 +12,5 @@ export { editorStickers, stampOutline, stampPixels } from './editor.cjs';
 export { createFakeStickerProvider, type FakeStickerProviderOptions } from './fake.cjs';
 export { combineStickerProviders } from './combine.cjs';
 export { checkStickerProvider, type StickerConformanceIssue, type StickerConformanceOptions } from './conformance.cjs';
-export { createStickerTools, createStickerToolProvider, describeStickerRef, stickerForAgent, type StickerToolsOptions } from './tools.cjs';
+export { createInsertStickerTool, insertSticker, createStickerTools, createStickerToolProvider, describeStickerRef, stickerForAgent, type StickerInsertHost, type StickerPlacement, type StickerToolsOptions } from './tools.cjs';
 export { StickerBrowser, type StickerBrowserItem, type StickerBrowserState } from './browser.cjs';

package/dist/stickers/index.d.ts

@@ -12,5 +12,5 @@ export { editorStickers, stampOutline, stampPixels } from './editor.js';
 export { createFakeStickerProvider, type FakeStickerProviderOptions } from './fake.js';
 export { combineStickerProviders } from './combine.js';
 export { checkStickerProvider, type StickerConformanceIssue, type StickerConformanceOptions } from './conformance.js';
-export { createStickerTools, createStickerToolProvider, describeStickerRef, stickerForAgent, type StickerToolsOptions } from './tools.js';
+export { createInsertStickerTool, insertSticker, createStickerTools, createStickerToolProvider, describeStickerRef, stickerForAgent, type StickerInsertHost, type StickerPlacement, type StickerToolsOptions } from './tools.js';
 export { StickerBrowser, type StickerBrowserItem, type StickerBrowserState } from './browser.js';

package/dist/stickers/index.js

@@ -3,20 +3,21 @@ import {
   editorStickers,
   stampOutline,
   stampPixels
-} from "../chunk-EJLRBS5Q.js";
+} from "../chunk-U4NUOKBT.js";
 import {
   DEFAULT_STICKER_PAGE,
   EDITOR_STICKERS_ID,
   MAX_STICKER_PAGE,
   STAMP_KINDS,
-  StickerError,
   StickersSlot,
   checkStickerSearchOptions,
   closestStickerRefs,
+  createInsertStickerTool,
   createStickerToolProvider,
   createStickerTools,
   describeStickerRef,
   editorStampOf,
+  insertSticker,
   normalizeStickerRef,
   parseStickerRef,
   stampCoverage,
@@ -24,7 +25,10 @@ import {
   stickerIdFor,
   stickerPage,
   stickerRefOf
-} from "../chunk-5RH3VXAK.js";
+} from "../chunk-WKH5ZAUA.js";
+import {
+  StickerError
+} from "../chunk-SZTI6EER.js";
 import "../chunk-4D6KP5BV.js";
 import {
   pngDataUrl
@@ -314,11 +318,13 @@ export {
   closestStickerRefs,
   combineStickerProviders,
   createFakeStickerProvider,
+  createInsertStickerTool,
   createStickerToolProvider,
   createStickerTools,
   describeStickerRef,
   editorStampOf,
   editorStickers,
+  insertSticker,
   normalizeStickerRef,
   parseStickerRef,
   stampCoverage,

package/dist/stickers/tools.d.cts

@@ -4,7 +4,40 @@
  * stickers. Refusals name the valid choices.
  */
 import type { AgentTool, AgentToolProvider } from '../tools/registry.cjs';
-import type { StickerDescription, StickerProvider, StickerRef, StickerSummary } from './types.cjs';
+import type { MaybePromise, StickerAsset, StickerDescription, StickerFormat, StickerProvider, StickerRef, StickerSummary } from './types.cjs';
+/** Where and how big an inserted sticker goes, with its art. */
+export interface StickerPlacement {
+    ref: StickerRef;
+    description: StickerDescription;
+    asset: StickerAsset;
+    /** Centre, in the editor's document units. */
+    x: number;
+    y: number;
+    /** Size of its box (the natural aspect kept). */
+    width: number;
+    height: number;
+    /** #rrggbb it was tinted to, when tintable and asked for. */
+    colour?: string;
+}
+/**
+ * An editor that can take an inserted sticker (`insert_sticker`): the vector editor (editable
+ * paths), the image editor (a pixel layer), the canvas (a shape node) or any other.
+ */
+export interface StickerInsertHost {
+    /** What the editor calls the thing it makes ("group", "layer", "node"), for descriptions. */
+    noun: string;
+    /** The format it wants first (it gets the other when the sticker has only that). */
+    format: StickerFormat;
+    /** The default centre when the call gives none (the middle of the view or document). */
+    defaultCentre(): {
+        x: number;
+        y: number;
+    };
+    /** Adds the sticker as one undo step; returns what it made (its id at least) for later tools. */
+    insert(placement: StickerPlacement): MaybePromise<{
+        id: string;
+    } & Record<string, unknown>>;
+}
 /** A summary as the tools return it: `ref` instead of the provider's id. */
 export declare function stickerForAgent(provider: StickerProvider, s: StickerSummary): Record<string, unknown>;
 /**
@@ -15,9 +48,32 @@ export declare function describeStickerRef(provider: StickerProvider, ref: Stick
 export interface StickerToolsOptions {
     /** The provider to use, read on every call (an editor's `StickersSlot`). */
     provider: () => StickerProvider;
+    /** With it, `insert_sticker` puts a sticker into this editor. */
+    insert?: StickerInsertHost;
 }
 /** `find_stickers` and `describe_sticker` over the provider `options.provider()` returns. */
 export declare function createStickerTools(options: StickerToolsOptions): AgentTool[];
+/**
+ * Puts one sticker into an editor through its host (the panels and `insert_sticker` both use it):
+ * checks the ref, loads the art in the host's format, tinted when asked and tintable, and places
+ * it centred at (`x`, `y`) (default the host's centre), `width` wide (default its natural width).
+ * Returns what the host made, the ref, the size and the licence.
+ */
+export declare function insertSticker(provider: StickerProvider, host: StickerInsertHost, options: {
+    ref: StickerRef;
+    x?: number;
+    y?: number;
+    width?: number;
+    color?: string;
+}): Promise<{
+    id: string;
+    ref: StickerRef;
+    width: number;
+    height: number;
+    licence: StickerDescription['licence'];
+} & Record<string, unknown>>;
+/** `insert_sticker`: one sticker by ref into an editor, at a place and size, as one undo step. */
+export declare function createInsertStickerTool(provider: () => StickerProvider, host: StickerInsertHost): AgentTool;
 /** The sticker library tools as a provider (id `stickers` by default). */
 export declare function createStickerToolProvider(options: StickerToolsOptions & {
     id?: string;

package/dist/stickers/tools.d.ts

@@ -4,7 +4,40 @@
  * stickers. Refusals name the valid choices.
  */
 import type { AgentTool, AgentToolProvider } from '../tools/registry.js';
-import type { StickerDescription, StickerProvider, StickerRef, StickerSummary } from './types.js';
+import type { MaybePromise, StickerAsset, StickerDescription, StickerFormat, StickerProvider, StickerRef, StickerSummary } from './types.js';
+/** Where and how big an inserted sticker goes, with its art. */
+export interface StickerPlacement {
+    ref: StickerRef;
+    description: StickerDescription;
+    asset: StickerAsset;
+    /** Centre, in the editor's document units. */
+    x: number;
+    y: number;
+    /** Size of its box (the natural aspect kept). */
+    width: number;
+    height: number;
+    /** #rrggbb it was tinted to, when tintable and asked for. */
+    colour?: string;
+}
+/**
+ * An editor that can take an inserted sticker (`insert_sticker`): the vector editor (editable
+ * paths), the image editor (a pixel layer), the canvas (a shape node) or any other.
+ */
+export interface StickerInsertHost {
+    /** What the editor calls the thing it makes ("group", "layer", "node"), for descriptions. */
+    noun: string;
+    /** The format it wants first (it gets the other when the sticker has only that). */
+    format: StickerFormat;
+    /** The default centre when the call gives none (the middle of the view or document). */
+    defaultCentre(): {
+        x: number;
+        y: number;
+    };
+    /** Adds the sticker as one undo step; returns what it made (its id at least) for later tools. */
+    insert(placement: StickerPlacement): MaybePromise<{
+        id: string;
+    } & Record<string, unknown>>;
+}
 /** A summary as the tools return it: `ref` instead of the provider's id. */
 export declare function stickerForAgent(provider: StickerProvider, s: StickerSummary): Record<string, unknown>;
 /**
@@ -15,9 +48,32 @@ export declare function describeStickerRef(provider: StickerProvider, ref: Stick
 export interface StickerToolsOptions {
     /** The provider to use, read on every call (an editor's `StickersSlot`). */
     provider: () => StickerProvider;
+    /** With it, `insert_sticker` puts a sticker into this editor. */
+    insert?: StickerInsertHost;
 }
 /** `find_stickers` and `describe_sticker` over the provider `options.provider()` returns. */
 export declare function createStickerTools(options: StickerToolsOptions): AgentTool[];
+/**
+ * Puts one sticker into an editor through its host (the panels and `insert_sticker` both use it):
+ * checks the ref, loads the art in the host's format, tinted when asked and tintable, and places
+ * it centred at (`x`, `y`) (default the host's centre), `width` wide (default its natural width).
+ * Returns what the host made, the ref, the size and the licence.
+ */
+export declare function insertSticker(provider: StickerProvider, host: StickerInsertHost, options: {
+    ref: StickerRef;
+    x?: number;
+    y?: number;
+    width?: number;
+    color?: string;
+}): Promise<{
+    id: string;
+    ref: StickerRef;
+    width: number;
+    height: number;
+    licence: StickerDescription['licence'];
+} & Record<string, unknown>>;
+/** `insert_sticker`: one sticker by ref into an editor, at a place and size, as one undo step. */
+export declare function createInsertStickerTool(provider: () => StickerProvider, host: StickerInsertHost): AgentTool;
 /** The sticker library tools as a provider (id `stickers` by default). */
 export declare function createStickerToolProvider(options: StickerToolsOptions & {
     id?: string;