@pixerate/editor 0.248.0 → 0.249.0

package/dist/stickers/conformance.d.cts

@@ -0,0 +1,18 @@
+import type { StickerProvider } from './types.cjs';
+export interface StickerConformanceIssue {
+    /** The sticker it is about, when it is about one. */
+    stickerId?: string;
+    message: string;
+}
+export interface StickerConformanceOptions {
+    /** Stop walking pages after this many (default 50). */
+    maxPages?: number;
+    /** Load at most this many stickers in each format (default 3). */
+    loads?: number;
+}
+/**
+ * Checks a sticker provider against the contract: capabilities, every listed sticker (walking the
+ * pages), search and list agreeing, paging limits, describe and load for known and unknown ids,
+ * and tinting. Returns the problems found (empty when it conforms).
+ */
+export declare function checkStickerProvider(provider: StickerProvider, options?: StickerConformanceOptions): Promise<StickerConformanceIssue[]>;

package/dist/stickers/conformance.d.ts

@@ -0,0 +1,18 @@
+import type { StickerProvider } from './types.js';
+export interface StickerConformanceIssue {
+    /** The sticker it is about, when it is about one. */
+    stickerId?: string;
+    message: string;
+}
+export interface StickerConformanceOptions {
+    /** Stop walking pages after this many (default 50). */
+    maxPages?: number;
+    /** Load at most this many stickers in each format (default 3). */
+    loads?: number;
+}
+/**
+ * Checks a sticker provider against the contract: capabilities, every listed sticker (walking the
+ * pages), search and list agreeing, paging limits, describe and load for known and unknown ids,
+ * and tinting. Returns the problems found (empty when it conforms).
+ */
+export declare function checkStickerProvider(provider: StickerProvider, options?: StickerConformanceOptions): Promise<StickerConformanceIssue[]>;

package/dist/stickers/editor.d.cts

@@ -0,0 +1,14 @@
+/**
+ * `editorStickers()`: the editor's own stamps as a sticker provider (id `editor`), the default in
+ * every `StickersSlot`, so stickers work with no setup. Each stamp is MIT-licensed and tintable.
+ * Its SVG is the stamp's outline, contoured from the coverage function the paint editor draws, so
+ * the vector art and the painted stamp have the same shape; its PNG is drawn from the function.
+ */
+import { type StampKind } from './stamps.cjs';
+import type { StickerProvider } from './types.cjs';
+/** The stamp's outline as SVG path data in a `BOX` px square (marching squares on the 0.5 level, simplified). */
+export declare function stampOutline(kind: StampKind): string;
+/** The stamp drawn flat in `colour` as RGBA, `size` px square (supersampled). */
+export declare function stampPixels(kind: StampKind, size: number, colour: string): Uint8ClampedArray;
+/** The editor's own stamps as a `StickerProvider` (id `editor`): tintable, MIT, SVG and PNG. */
+export declare function editorStickers(): StickerProvider;

package/dist/stickers/editor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `editorStickers()`: the editor's own stamps as a sticker provider (id `editor`), the default in
+ * every `StickersSlot`, so stickers work with no setup. Each stamp is MIT-licensed and tintable.
+ * Its SVG is the stamp's outline, contoured from the coverage function the paint editor draws, so
+ * the vector art and the painted stamp have the same shape; its PNG is drawn from the function.
+ */
+import { type StampKind } from './stamps.js';
+import type { StickerProvider } from './types.js';
+/** The stamp's outline as SVG path data in a `BOX` px square (marching squares on the 0.5 level, simplified). */
+export declare function stampOutline(kind: StampKind): string;
+/** The stamp drawn flat in `colour` as RGBA, `size` px square (supersampled). */
+export declare function stampPixels(kind: StampKind, size: number, colour: string): Uint8ClampedArray;
+/** The editor's own stamps as a `StickerProvider` (id `editor`): tintable, MIT, SVG and PNG. */
+export declare function editorStickers(): StickerProvider;

package/dist/stickers/errors.d.cts

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

package/dist/stickers/errors.d.ts

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

package/dist/stickers/fake.d.cts

@@ -0,0 +1,16 @@
+/**
+ * `createFakeStickerProvider()`: a small, deterministic sticker library for tests and demos (id
+ * `fake`). Flat badges are tintable; two-colour tiles are not; one sticker is for non-commercial
+ * use only. Art is a generated SVG and a PNG drawn to the same design, so it works in Node.
+ */
+import type { StickerProvider } from './types.cjs';
+export interface FakeStickerProviderOptions {
+    /** Provider id (default `fake`). */
+    id?: string;
+    /** Delay every `load` by this many ms (to test loading states). */
+    loadDelayMs?: number;
+    /** Ids whose `load` rejects (to test failures). */
+    failIds?: readonly string[];
+}
+/** A deterministic sticker library for tests and demos. */
+export declare function createFakeStickerProvider(options?: FakeStickerProviderOptions): StickerProvider;

package/dist/stickers/fake.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `createFakeStickerProvider()`: a small, deterministic sticker library for tests and demos (id
+ * `fake`). Flat badges are tintable; two-colour tiles are not; one sticker is for non-commercial
+ * use only. Art is a generated SVG and a PNG drawn to the same design, so it works in Node.
+ */
+import type { StickerProvider } from './types.js';
+export interface FakeStickerProviderOptions {
+    /** Provider id (default `fake`). */
+    id?: string;
+    /** Delay every `load` by this many ms (to test loading states). */
+    loadDelayMs?: number;
+    /** Ids whose `load` rejects (to test failures). */
+    failIds?: readonly string[];
+}
+/** A deterministic sticker library for tests and demos. */
+export declare function createFakeStickerProvider(options?: FakeStickerProviderOptions): StickerProvider;

package/dist/stickers/helpers.d.cts

@@ -0,0 +1,51 @@
+/**
+ * Helpers for sticker providers and the editors that use them: paging and searching an in-memory
+ * catalogue, `provider:id` refs, and the slot an editor keeps its provider in.
+ */
+import { type StampKind } from './stamps.cjs';
+import type { StickerPage, StickerProvider, StickerRef, StickerSearchOptions, StickerSummary } from './types.cjs';
+/** Default and largest page size. */
+export declare const DEFAULT_STICKER_PAGE = 24;
+export declare const MAX_STICKER_PAGE = 100;
+/** The id of the editor's own sticker set (`editorStickers()`). */
+export declare const EDITOR_STICKERS_ID = "editor";
+/** Checks search options, throwing a `StickerError` that names the bad one. */
+export declare function checkStickerSearchOptions(options?: StickerSearchOptions): void;
+/**
+ * One page of `items` filtered by `options` (category, every tag, commercial licence) and, when
+ * `query` has words, by every word appearing in the name, tags, category or description. Cursors
+ * are offsets as strings.
+ */
+export declare function stickerPage(items: readonly StickerSummary[], options?: StickerSearchOptions, query?: string): StickerPage;
+/** A ref split into provider and id. A bare editor stamp (`"star"`) is `editor:star`; any other bare id is refused. */
+export declare function parseStickerRef(ref: StickerRef): {
+    provider: string;
+    id: string;
+};
+/** The canonical form of a ref (`"star"` → `"editor:star"`). */
+export declare function normalizeStickerRef(ref: StickerRef): StickerRef;
+/** The editor stamp a ref names, or `null` for another provider's sticker. */
+export declare function editorStampOf(ref: StickerRef): StampKind | null;
+/** The ref of a sticker `id` listed by `provider`. */
+export declare function stickerRefOf(provider: StickerProvider, id: string): StickerRef;
+/**
+ * The id to pass to `provider` for `ref`, or `null` when the ref names another provider. A
+ * combined provider takes the whole ref; any other takes the part after its own id.
+ */
+export declare function stickerIdFor(provider: StickerProvider, ref: StickerRef): string | null;
+/** Up to `n` of `candidates` closest to `wanted` (shared prefix, then edit distance), for "did you mean" refusals. */
+export declare function closestStickerRefs(wanted: string, candidates: readonly string[], n?: number): string[];
+/**
+ * Holds an editor's sticker provider: the editor's own set (`editorStickers()`) until a host sets
+ * another. Controllers expose it as `stickersProvider` and `setStickersProvider(provider | null)`
+ * (`null` goes back to the default); listeners hear every change.
+ */
+export declare class StickersSlot {
+    readonly fallback: StickerProvider;
+    private current;
+    private readonly listeners;
+    constructor(fallback: StickerProvider);
+    get provider(): StickerProvider;
+    set(provider: StickerProvider | null): void;
+    subscribe(listener: (provider: StickerProvider) => void): () => void;
+}

package/dist/stickers/helpers.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Helpers for sticker providers and the editors that use them: paging and searching an in-memory
+ * catalogue, `provider:id` refs, and the slot an editor keeps its provider in.
+ */
+import { type StampKind } from './stamps.js';
+import type { StickerPage, StickerProvider, StickerRef, StickerSearchOptions, StickerSummary } from './types.js';
+/** Default and largest page size. */
+export declare const DEFAULT_STICKER_PAGE = 24;
+export declare const MAX_STICKER_PAGE = 100;
+/** The id of the editor's own sticker set (`editorStickers()`). */
+export declare const EDITOR_STICKERS_ID = "editor";
+/** Checks search options, throwing a `StickerError` that names the bad one. */
+export declare function checkStickerSearchOptions(options?: StickerSearchOptions): void;
+/**
+ * One page of `items` filtered by `options` (category, every tag, commercial licence) and, when
+ * `query` has words, by every word appearing in the name, tags, category or description. Cursors
+ * are offsets as strings.
+ */
+export declare function stickerPage(items: readonly StickerSummary[], options?: StickerSearchOptions, query?: string): StickerPage;
+/** A ref split into provider and id. A bare editor stamp (`"star"`) is `editor:star`; any other bare id is refused. */
+export declare function parseStickerRef(ref: StickerRef): {
+    provider: string;
+    id: string;
+};
+/** The canonical form of a ref (`"star"` → `"editor:star"`). */
+export declare function normalizeStickerRef(ref: StickerRef): StickerRef;
+/** The editor stamp a ref names, or `null` for another provider's sticker. */
+export declare function editorStampOf(ref: StickerRef): StampKind | null;
+/** The ref of a sticker `id` listed by `provider`. */
+export declare function stickerRefOf(provider: StickerProvider, id: string): StickerRef;
+/**
+ * The id to pass to `provider` for `ref`, or `null` when the ref names another provider. A
+ * combined provider takes the whole ref; any other takes the part after its own id.
+ */
+export declare function stickerIdFor(provider: StickerProvider, ref: StickerRef): string | null;
+/** Up to `n` of `candidates` closest to `wanted` (shared prefix, then edit distance), for "did you mean" refusals. */
+export declare function closestStickerRefs(wanted: string, candidates: readonly string[], n?: number): string[];
+/**
+ * Holds an editor's sticker provider: the editor's own set (`editorStickers()`) until a host sets
+ * another. Controllers expose it as `stickersProvider` and `setStickersProvider(provider | null)`
+ * (`null` goes back to the default); listeners hear every change.
+ */
+export declare class StickersSlot {
+    readonly fallback: StickerProvider;
+    private current;
+    private readonly listeners;
+    constructor(fallback: StickerProvider);
+    get provider(): StickerProvider;
+    set(provider: StickerProvider | null): void;
+    subscribe(listener: (provider: StickerProvider) => void): () => void;
+}

package/dist/stickers/index.cjs

@@ -0,0 +1,331 @@
+"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 _chunkLJRCU3BJcjs = require('../chunk-LJRCU3BJ.cjs');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkZEYMKDYScjs = require('../chunk-ZEYMKDYS.cjs');
+require('../chunk-3K6HWEXZ.cjs');
+
+
+var _chunkW5M3J7PVcjs = require('../chunk-W5M3J7PV.cjs');
+require('../chunk-XFM3OCHU.cjs');
+
+// src/stickers/fake.ts
+var CATALOGUE = [
+  ...["sun", "moon", "cloud", "rain", "snow", "wind"].map((w, i) => ({ id: `weather-${w}`, name: w[0].toUpperCase() + w.slice(1), category: "weather", tags: ["weather", w], shape: "badge", colours: [["#f59e0b", "#64748b", "#94a3b8", "#2563eb", "#e0f2fe", "#14b8a6"][i], "#ffffff"], commercial: true })),
+  ...["apple", "pear", "cherry", "lemon", "grape"].map((f, i) => ({ id: `fruit-${f}`, name: f[0].toUpperCase() + f.slice(1), category: "food", tags: ["fruit", f], shape: "tile", colours: [["#dc2626", "#84cc16", "#be123c", "#facc15", "#7c3aed"][i], "#166534"], commercial: true })),
+  ...["new", "sale", "hot", "free"].map((b, i) => ({ id: `badge-${b}`, name: `${b[0].toUpperCase() + b.slice(1)} badge`, category: "badges", tags: ["badge", "label", b], shape: "badge", colours: [["#16a34a", "#dc2626", "#ea580c", "#0891b2"][i], "#ffffff"], commercial: true })),
+  { id: "art-sketch", name: "Sketch", category: "art", tags: ["drawing", "non-commercial"], shape: "tile", colours: ["#1f2937", "#fde68a"], commercial: false }
+];
+var W = 120;
+var H = 120;
+function summaryOf(s) {
+  return {
+    id: s.id,
+    name: s.name,
+    category: s.category,
+    tags: s.tags,
+    description: s.shape === "badge" ? "A flat badge (tintable)." : "A two-colour tile.",
+    width: W,
+    height: H,
+    formats: ["svg", "png"],
+    licence: s.commercial ? { spdx: "CC0-1.0", name: "CC0 1.0", commercial: true } : { spdx: "CC-BY-NC-4.0", name: "CC BY-NC 4.0", attribution: "Fake Artist", commercial: false },
+    tintable: s.shape === "badge"
+  };
+}
+function svgOf(s, fill) {
+  if (s.shape === "badge") {
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${W} ${H}" width="${W}" height="${H}"><path fill="${fill}" fill-rule="evenodd" d="M60 6A54 54 0 1 1 59.9 6ZM45 45H75V75H45Z"/></svg>`;
+  }
+  return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${W} ${H}" width="${W}" height="${H}"><rect x="10" y="10" width="100" height="100" fill="${s.colours[0]}"/><rect x="10" y="10" width="100" height="50" fill="${s.colours[1]}"/></svg>`;
+}
+function pixelsOf(s, size, fill) {
+  const out = new Uint8ClampedArray(size * size * 4);
+  const hex = (c) => [parseInt(c.slice(1, 3), 16), parseInt(c.slice(3, 5), 16), parseInt(c.slice(5, 7), 16)];
+  for (let y = 0; y < size; y++) {
+    for (let x = 0; x < size; x++) {
+      const u = (x + 0.5) / size * W;
+      const v = (y + 0.5) / size * H;
+      let rgb = null;
+      if (s.shape === "badge") {
+        const inDisc = Math.hypot(u - 60, v - 60) <= 54;
+        const inNotch = u >= 45 && u <= 75 && v >= 45 && v <= 75;
+        if (inDisc && !inNotch) rgb = hex(fill);
+      } else if (u >= 10 && u <= 110 && v >= 10 && v <= 110) rgb = hex(v < 60 ? s.colours[1] : s.colours[0]);
+      if (!rgb) continue;
+      const i = (y * size + x) * 4;
+      out[i] = rgb[0];
+      out[i + 1] = rgb[1];
+      out[i + 2] = rgb[2];
+      out[i + 3] = 255;
+    }
+  }
+  return out;
+}
+function createFakeStickerProvider(options = {}) {
+  const summaries = CATALOGUE.map(summaryOf);
+  const find = (id) => CATALOGUE.find((s) => s.id === id);
+  return {
+    id: _nullishCoalesce(options.id, () => ( "fake")),
+    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),
+    describe(id) {
+      const s = find(id);
+      if (!s) return void 0;
+      return { ...summaryOf(s), silhouette: s.shape === "badge" ? "M60 6A54 54 0 1 1 59.9 6Z" : "M10 10H110V110H10Z", colours: s.shape === "badge" ? [s.colours[0]] : [...s.colours] };
+    },
+    categories: () => [...new Set(CATALOGUE.map((s) => s.category))].map((c) => ({ id: c, name: c, count: CATALOGUE.filter((s) => s.category === c).length })),
+    async load(id, o = {}) {
+      if (options.loadDelayMs) await new Promise((r) => setTimeout(r, options.loadDelayMs));
+      const s = find(id);
+      if (!s) throw new (0, _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).`);
+      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}.`);
+        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) };
+    }
+  };
+}
+
+// src/stickers/combine.ts
+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.`);
+  const byId = new Map(providers.map((p) => [p.id, p]));
+  const owner = (ref) => {
+    const { provider, id } = _chunkZEYMKDYScjs.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"}.`);
+    return { p, id };
+  };
+  const prefix = (p, s) => ({ ...s, id: _chunkZEYMKDYScjs.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 });
+    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.`);
+      i = Number(m[1]);
+      inner = m[2] || void 0;
+    }
+    const get = (p, opts) => query === null ? p.list(opts) : p.search(query, opts);
+    let total = 0;
+    for (const p of providers) total += (await get(p, { ...filters, limit: 1 })).total;
+    const items = [];
+    let next;
+    while (i < providers.length && items.length < limit) {
+      const p = providers[i];
+      const res = await get(p, { ...filters, limit: limit - items.length, ...inner ? { after: inner } : {} });
+      items.push(...res.items.map((s) => prefix(p, s)));
+      if (res.next && res.items.length) {
+        inner = res.next;
+        if (items.length >= limit) next = `${i}|${inner}`;
+        continue;
+      }
+      i++;
+      inner = void 0;
+    }
+    if (!next && items.length >= limit && i < providers.length) next = `${i}|`;
+    return { items, total, ...next ? { next } : {} };
+  };
+  return {
+    id: _nullishCoalesce(options.id, () => ( "stickers")),
+    name: _nullishCoalesce(options.name, () => ( providers.map((p) => p.name).join(" + "))),
+    namespaced: true,
+    capabilities: {
+      supportsSearch: providers.some((p) => p.capabilities.supportsSearch),
+      supportsSvg: providers.some((p) => p.capabilities.supportsSvg),
+      supportsRaster: providers.some((p) => p.capabilities.supportsRaster),
+      ...providers.every((p) => p.capabilities.maxSize) ? { maxSize: Math.max(...providers.map((p) => p.capabilities.maxSize)) } : {}
+    },
+    list: (o) => page(null, o),
+    search: (q, o) => page(q, o),
+    async describe(ref) {
+      let o;
+      try {
+        o = owner(ref);
+      } catch (e2) {
+        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;
+    },
+    async load(ref, o) {
+      const { p, id } = owner(ref);
+      return p.load(id, o);
+    },
+    async categories() {
+      const counts = /* @__PURE__ */ new Map();
+      for (const p of providers) {
+        for (const c of await _asyncNullishCoalesce(await _optionalChain([p, 'access', _4 => _4.categories, 'optionalCall', _5 => _5()]), async () => ( []))) {
+          const had = counts.get(c.id);
+          counts.set(c.id, { id: c.id, name: _nullishCoalesce(_optionalChain([had, 'optionalAccess', _6 => _6.name]), () => ( c.name)), count: (_nullishCoalesce(_optionalChain([had, 'optionalAccess', _7 => _7.count]), () => ( 0))) + c.count });
+        }
+      }
+      return [...counts.values()];
+    }
+  };
+}
+
+// src/stickers/conformance.ts
+var HEX = /^#[0-9a-fA-F]{6}$/;
+function checkSummary(s, provider, issues) {
+  const at = (message) => issues.push({ stickerId: s.id, message });
+  if (typeof s.id !== "string" || !s.id) at("id is missing");
+  if (!provider.namespaced && s.id.includes(":")) at('id contains ":" (refs are provider:id; only a combined provider lists refs)');
+  if (typeof s.name !== "string" || !s.name) at("name is missing");
+  if (typeof s.category !== "string" || !s.category) at("category is missing");
+  if (!(s.width > 0 && s.height > 0)) at(`width and height must be positive, got ${s.width} \xD7 ${s.height}`);
+  if (!Array.isArray(s.formats) || !s.formats.length || s.formats.some((f) => f !== "svg" && f !== "png")) at("formats must list svg and / or png");
+  if (_optionalChain([s, 'access', _8 => _8.formats, 'optionalAccess', _9 => _9.includes, 'call', _10 => _10("svg")]) && !provider.capabilities.supportsSvg) at("lists svg but capabilities.supportsSvg is false");
+  if (_optionalChain([s, 'access', _11 => _11.formats, 'optionalAccess', _12 => _12.includes, 'call', _13 => _13("png")]) && !provider.capabilities.supportsRaster) at("lists png but capabilities.supportsRaster is false");
+  if (!s.licence || typeof s.licence.name !== "string" || !s.licence.name) at("licence.name is missing (every sticker says how it may be used)");
+  if (typeof _optionalChain([s, 'access', _14 => _14.licence, 'optionalAccess', _15 => _15.commercial]) !== "boolean") at("licence.commercial is not a boolean");
+  if (typeof s.tintable !== "boolean") at("tintable is not a boolean");
+  if (s.thumbnail !== void 0 && !/^(data:|https:)/.test(s.thumbnail)) at("thumbnail must be a data: or https: URL");
+}
+async function checkStickerProvider(provider, options = {}) {
+  const issues = [];
+  const top = (message) => issues.push({ message });
+  if (typeof provider.id !== "string" || !provider.id) top("provider has no id");
+  else if (provider.id.includes(":")) top('provider id contains ":"');
+  if (typeof provider.name !== "string" || !provider.name) top("provider has no name");
+  const caps = provider.capabilities;
+  for (const k of ["supportsSearch", "supportsSvg", "supportsRaster"]) if (typeof _optionalChain([caps, 'optionalAccess', _16 => _16[k]]) !== "boolean") top(`capabilities.${k} is not a boolean`);
+  if (_optionalChain([caps, 'optionalAccess', _17 => _17.maxSize]) !== void 0 && !(caps.maxSize > 0)) top("capabilities.maxSize must be positive");
+  const all = [];
+  const ids = /* @__PURE__ */ new Set();
+  let after;
+  let total = -1;
+  for (let n = 0; n < (_nullishCoalesce(options.maxPages, () => ( 50))); n++) {
+    let page;
+    try {
+      page = await provider.list({ limit: 10, ...after ? { after } : {} });
+    } catch (e) {
+      top(`list() rejected: ${e.message}`);
+      break;
+    }
+    if (!Array.isArray(_optionalChain([page, 'optionalAccess', _18 => _18.items])) || typeof page.total !== "number") {
+      top("list() did not return { items, total }");
+      break;
+    }
+    if (page.items.length > 10) top(`list({ limit: 10 }) returned ${page.items.length} stickers`);
+    if (total === -1) total = page.total;
+    for (const s of page.items) {
+      if (ids.has(s.id)) top(`duplicate id "${s.id}"`);
+      ids.add(s.id);
+      all.push(s);
+      checkSummary(s, provider, issues);
+    }
+    if (!page.next) break;
+    if (!page.items.length) {
+      top("list() returned an empty page with a next cursor");
+      break;
+    }
+    after = page.next;
+  }
+  if (total !== -1 && all.length !== total) top(`list() pages hold ${all.length} stickers but total says ${total}`);
+  try {
+    const found = await provider.search("", { limit: 1 });
+    if (found.total !== total) top(`search("") total ${found.total} differs from list() total ${total}`);
+  } catch (e) {
+    top(`search("") rejected: ${e.message}`);
+  }
+  const first = all[0];
+  if (first) {
+    const byCategory = await provider.list({ category: first.category, limit: 100 });
+    if (byCategory.items.some((s) => s.category !== first.category)) top(`list({ category: "${first.category}" }) returned stickers of other categories`);
+    const d = await provider.describe(first.id);
+    if (!d) top(`describe("${first.id}") returned nothing for a listed sticker`);
+    else if (d.id !== first.id) top(`describe("${first.id}") returned id "${d.id}"`);
+    if (_optionalChain([d, 'optionalAccess', _19 => _19.colours, 'optionalAccess', _20 => _20.some, 'call', _21 => _21((c) => !HEX.test(c))])) top(`describe("${first.id}").colours must be #rrggbb`);
+  }
+  if (await provider.describe("__no_such_sticker__") !== void 0) top("describe of an unknown id returned a sticker");
+  let rejected = false;
+  try {
+    await provider.load("__no_such_sticker__");
+  } catch (e3) {
+    rejected = true;
+  }
+  if (!rejected) top("load of an unknown id did not reject");
+  for (const s of all.slice(0, _nullishCoalesce(options.loads, () => ( 3)))) {
+    for (const format of _nullishCoalesce(s.formats, () => ( []))) {
+      try {
+        const asset = await provider.load(s.id, { format, size: 32 });
+        if (format === "svg" && (asset.kind !== "svg" || !/<svg[\s>]/.test(asset.svg))) issues.push({ stickerId: s.id, message: 'load({ format: "svg" }) did not return SVG' });
+        if (format === "png" && (asset.kind !== "image" || !/^(data:|https:)/.test(asset.url) || !(asset.width > 0 && asset.height > 0))) issues.push({ stickerId: s.id, message: 'load({ format: "png" }) did not return an image URL with its size' });
+      } catch (e) {
+        issues.push({ stickerId: s.id, message: `load({ format: "${format}" }) rejected: ${e.message}` });
+      }
+    }
+  }
+  const tintable = all.find((s) => s.tintable);
+  if (tintable) {
+    try {
+      const a = await provider.load(tintable.id, { format: tintable.formats[0], colour: "#123456", size: 32 });
+      if (a.kind === "svg" && !/#123456/i.test(a.svg)) issues.push({ stickerId: tintable.id, message: "a tintable sticker loaded with colour #123456 does not use it" });
+    } catch (e) {
+      issues.push({ stickerId: tintable.id, message: `load with a colour rejected: ${e.message}` });
+    }
+  }
+  return issues;
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+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;

package/dist/stickers/index.d.cts

@@ -0,0 +1,16 @@
+/**
+ * `@pixerate/editor/stickers`: the sticker provider contract (dependency-free). A host plugs in
+ * any sticker library (`StickerProvider`); the editor's own stamps are the built-in set
+ * (`editorStickers()`, the default in every `StickersSlot`). Also: a conformance checker, a fake
+ * provider for tests, combining providers, and the `find_stickers` / `describe_sticker` tools.
+ */
+export * from './types.cjs';
+export * from './errors.cjs';
+export * from './helpers.cjs';
+export * from './stamps.cjs';
+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 { StickerBrowser, type StickerBrowserItem, type StickerBrowserState } from './browser.cjs';

package/dist/stickers/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `@pixerate/editor/stickers`: the sticker provider contract (dependency-free). A host plugs in
+ * any sticker library (`StickerProvider`); the editor's own stamps are the built-in set
+ * (`editorStickers()`, the default in every `StickersSlot`). Also: a conformance checker, a fake
+ * provider for tests, combining providers, and the `find_stickers` / `describe_sticker` tools.
+ */
+export * from './types.js';
+export * from './errors.js';
+export * from './helpers.js';
+export * from './stamps.js';
+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 { StickerBrowser, type StickerBrowserItem, type StickerBrowserState } from './browser.js';