image-to-pixel 3.0.0 → 3.1.0

package/lib/core/dither/bluenoise-data.js

@@ -1,3 +1,3 @@
-// Generated by scripts/gen-bluenoise.mjs: 64×64 void-and-cluster blue noise, one byte per cell (0..255).
-export const BLUE_NOISE_SIZE = 64;
-export const BLUE_NOISE_B64 = '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';
+// Generated by scripts/gen-bluenoise.mjs: 64×64 void-and-cluster blue noise, one byte per cell (0..255).
+export const BLUE_NOISE_SIZE = 64;
+export const BLUE_NOISE_B64 = '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';

package/lib/core/dither/kernels.js

@@ -1,27 +1,27 @@
-// Error-diffusion kernels as push offsets [dx, dy, weight] (weights already divided).
-// `skew` is the wavefront slope the GPU needs: pixels with x + skew*y = k only depend on
-// earlier waves, so each wave is one draw (see docs/how-it-works.md).
-
-const k = (div, list) => list.map(([dx, dy, w]) => [dx, dy, w / div]);
-
-export const KERNELS = {
-  'floyd-steinberg': k(16, [[1, 0, 7], [-1, 1, 3], [0, 1, 5], [1, 1, 1]]),
-  'atkinson': k(8, [[1, 0, 1], [2, 0, 1], [-1, 1, 1], [0, 1, 1], [1, 1, 1], [0, 2, 1]]),
-  'sierra-lite': k(4, [[1, 0, 2], [-1, 1, 1], [0, 1, 1]]),
-  'sierra': k(32, [[1, 0, 5], [2, 0, 3], [-2, 1, 2], [-1, 1, 4], [0, 1, 5], [1, 1, 4], [2, 1, 2], [-1, 2, 2], [0, 2, 3], [1, 2, 2]]),
-  'burkes': k(32, [[1, 0, 8], [2, 0, 4], [-2, 1, 2], [-1, 1, 4], [0, 1, 8], [1, 1, 4], [2, 1, 2]]),
-  'jarvis': k(48, [[1, 0, 7], [2, 0, 5], [-2, 1, 3], [-1, 1, 5], [0, 1, 7], [1, 1, 5], [2, 1, 3], [-2, 2, 1], [-1, 2, 3], [0, 2, 5], [1, 2, 3], [2, 2, 1]]),
-  'stucki': k(42, [[1, 0, 8], [2, 0, 4], [-2, 1, 2], [-1, 1, 4], [0, 1, 8], [1, 1, 4], [2, 1, 2], [-2, 2, 1], [-1, 2, 2], [0, 2, 4], [1, 2, 2], [2, 2, 1]]),
-};
-
-export const MAX_KERNEL = 12;
-
-/** Smallest integer s so that every push offset lands on a later wave x + s*y. */
-export function kernelSkew(kernel) {
-  let s = 1;
-  for (const [dx, dy] of kernel) if (dy > 0) s = Math.max(s, Math.floor(-dx / dy) + 1);
-  return s;
-}
-
-/** Number of waves (GPU draws) for an image of w × h. */
-export const waveCount = (w, h, skew) => (w - 1) + skew * (h - 1) + 1;
+// Error-diffusion kernels as push offsets [dx, dy, weight] (weights already divided).
+// `skew` is the wavefront slope the GPU needs: pixels with x + skew*y = k only depend on
+// earlier waves, so each wave is one draw (see docs/how-it-works.md).
+
+const k = (div, list) => list.map(([dx, dy, w]) => [dx, dy, w / div]);
+
+export const KERNELS = {
+  'floyd-steinberg': k(16, [[1, 0, 7], [-1, 1, 3], [0, 1, 5], [1, 1, 1]]),
+  'atkinson': k(8, [[1, 0, 1], [2, 0, 1], [-1, 1, 1], [0, 1, 1], [1, 1, 1], [0, 2, 1]]),
+  'sierra-lite': k(4, [[1, 0, 2], [-1, 1, 1], [0, 1, 1]]),
+  'sierra': k(32, [[1, 0, 5], [2, 0, 3], [-2, 1, 2], [-1, 1, 4], [0, 1, 5], [1, 1, 4], [2, 1, 2], [-1, 2, 2], [0, 2, 3], [1, 2, 2]]),
+  'burkes': k(32, [[1, 0, 8], [2, 0, 4], [-2, 1, 2], [-1, 1, 4], [0, 1, 8], [1, 1, 4], [2, 1, 2]]),
+  'jarvis': k(48, [[1, 0, 7], [2, 0, 5], [-2, 1, 3], [-1, 1, 5], [0, 1, 7], [1, 1, 5], [2, 1, 3], [-2, 2, 1], [-1, 2, 3], [0, 2, 5], [1, 2, 3], [2, 2, 1]]),
+  'stucki': k(42, [[1, 0, 8], [2, 0, 4], [-2, 1, 2], [-1, 1, 4], [0, 1, 8], [1, 1, 4], [2, 1, 2], [-2, 2, 1], [-1, 2, 2], [0, 2, 4], [1, 2, 2], [2, 2, 1]]),
+};
+
+export const MAX_KERNEL = 12;
+
+/** Smallest integer s so that every push offset lands on a later wave x + s*y. */
+export function kernelSkew(kernel) {
+  let s = 1;
+  for (const [dx, dy] of kernel) if (dy > 0) s = Math.max(s, Math.floor(-dx / dy) + 1);
+  return s;
+}
+
+/** Number of waves (GPU draws) for an image of w × h. */
+export const waveCount = (w, h, skew) => (w - 1) + skew * (h - 1) + 1;

package/lib/core/dither/matrices.js

@@ -1,95 +1,95 @@
-// Threshold maps for ordered dithering.
-// A map is { w, h, levels, values: Uint8Array } and the threshold of a cell is (value + 0.5) / levels.
-// The GPU reads the same bytes from a texture, so CPU and GPU agree exactly.
-
-import { BLUE_NOISE_B64, BLUE_NOISE_SIZE } from './bluenoise-data.js';
-
-function fromB64(b64) {
-  if (typeof atob === 'function') return Uint8Array.from(atob(b64), c => c.charCodeAt(0));
-  return new Uint8Array(Buffer.from(b64, 'base64'));
-}
-
-/** Bayer index matrix of size n (power of two). */
-export function bayer(n) {
-  let m = [[0]];
-  for (let s = 1; s < n; s *= 2) {
-    const next = [];
-    for (let y = 0; y < s * 2; y++) next.push(new Array(s * 2));
-    for (let y = 0; y < s; y++) for (let x = 0; x < s; x++) {
-      const v = 4 * m[y][x];
-      next[y][x] = v; next[y][x + s] = v + 2; next[y + s][x] = v + 3; next[y + s][x + s] = v + 1;
-    }
-    m = next;
-  }
-  return m;
-}
-
-/** Turn arbitrary numbers into ranks 0..n-1 (ties keep reading order). */
-export function toRanks(rows) {
-  const h = rows.length, w = rows[0].length;
-  const cells = [];
-  for (let y = 0; y < h; y++) for (let x = 0; x < w; x++) cells.push({ i: y * w + x, v: rows[y][x] });
-  cells.sort((a, b) => a.v - b.v || a.i - b.i);
-  const out = new Uint8Array(w * h);
-  cells.forEach((c, r) => { out[c.i] = r; });
-  return out;
-}
-
-/** Clustered-dot screen: cells ranked by a dot function, two dots per tile at 45°. */
-function clustered(n) {
-  const rows = [];
-  for (let y = 0; y < n; y++) {
-    const row = [];
-    for (let x = 0; x < n; x++) {
-      const u = (x + 0.5) / n * 2 * Math.PI, v = (y + 0.5) / n * 2 * Math.PI;
-      row.push(-(Math.cos(u) + Math.cos(v)) + (x * n + y) * 1e-9);
-    }
-    rows.push(row);
-  }
-  return rows;
-}
-
-const CLUSTER4 = [[7, 13, 11, 4], [12, 16, 14, 8], [10, 15, 6, 2], [5, 9, 3, 1]];   // classic editor's matrix
-const cache = new Map();
-
-/**
- * Threshold map for an ordered method id ('bayer4', 'bluenoise', 'custom' …).
- * @param {string} method
- * @param {number[][]|null} [custom] matrix for 'custom'
- */
-export function thresholdMap(method, custom = null) {
-  if (method === 'custom') {
-    const m = custom && custom.length ? custom : bayer(4);
-    return { w: m[0].length, h: m.length, levels: m.length * m[0].length, values: toRanks(m) };
-  }
-  if (cache.has(method)) return cache.get(method);
-  let map;
-  const sq = rows => ({ w: rows[0].length, h: rows.length, levels: rows.length * rows[0].length, values: toRanks(rows) });
-  switch (method) {
-    case 'bayer2': map = sq(bayer(2)); break;
-    case 'bayer4': map = sq(bayer(4)); break;
-    case 'bayer8': map = sq(bayer(8)); break;
-    case 'bayer16': map = sq(bayer(16)); break;
-    case 'cluster4': map = sq(CLUSTER4); break;
-    case 'cluster8': map = sq(clustered(8)); break;
-    case 'lines': map = sq([[0], [2], [1], [3]]); break;
-    case 'bluenoise': map = { w: BLUE_NOISE_SIZE, h: BLUE_NOISE_SIZE, levels: 256, values: fromB64(BLUE_NOISE_B64) }; break;
-    default: map = sq(bayer(4));
-  }
-  cache.set(method, map);
-  return map;
-}
-
-/**
- * Parse a custom matrix typed by a person: rows on lines, numbers separated by spaces or commas.
- * Accepts an optional "/ 16" style divisor line, which is ignored (only the order matters).
- */
-export function parseMatrix(text) {
-  const rows = String(text).split(/\r?\n|;/).map(l => l.trim()).filter(l => l && !/^\//.test(l))
-    .map(l => l.replace(/[[\]]/g, '').split(/[\s,]+/).filter(Boolean).map(Number));
-  if (!rows.length) throw new Error('Matrix is empty');
-  const w = rows[0].length;
-  if (rows.some(r => r.length !== w || r.some(v => !Number.isFinite(v)))) throw new Error('Every row needs the same number of values');
-  if (w > 16 || rows.length > 16) throw new Error('Matrices are limited to 16×16');
-  return rows;
-}
+// Threshold maps for ordered dithering.
+// A map is { w, h, levels, values: Uint8Array } and the threshold of a cell is (value + 0.5) / levels.
+// The GPU reads the same bytes from a texture, so CPU and GPU agree exactly.
+
+import { BLUE_NOISE_B64, BLUE_NOISE_SIZE } from './bluenoise-data.js';
+
+function fromB64(b64) {
+  if (typeof atob === 'function') return Uint8Array.from(atob(b64), c => c.charCodeAt(0));
+  return new Uint8Array(Buffer.from(b64, 'base64'));
+}
+
+/** Bayer index matrix of size n (power of two). */
+export function bayer(n) {
+  let m = [[0]];
+  for (let s = 1; s < n; s *= 2) {
+    const next = [];
+    for (let y = 0; y < s * 2; y++) next.push(new Array(s * 2));
+    for (let y = 0; y < s; y++) for (let x = 0; x < s; x++) {
+      const v = 4 * m[y][x];
+      next[y][x] = v; next[y][x + s] = v + 2; next[y + s][x] = v + 3; next[y + s][x + s] = v + 1;
+    }
+    m = next;
+  }
+  return m;
+}
+
+/** Turn arbitrary numbers into ranks 0..n-1 (ties keep reading order). */
+export function toRanks(rows) {
+  const h = rows.length, w = rows[0].length;
+  const cells = [];
+  for (let y = 0; y < h; y++) for (let x = 0; x < w; x++) cells.push({ i: y * w + x, v: rows[y][x] });
+  cells.sort((a, b) => a.v - b.v || a.i - b.i);
+  const out = new Uint8Array(w * h);
+  cells.forEach((c, r) => { out[c.i] = r; });
+  return out;
+}
+
+/** Clustered-dot screen: cells ranked by a dot function, two dots per tile at 45°. */
+function clustered(n) {
+  const rows = [];
+  for (let y = 0; y < n; y++) {
+    const row = [];
+    for (let x = 0; x < n; x++) {
+      const u = (x + 0.5) / n * 2 * Math.PI, v = (y + 0.5) / n * 2 * Math.PI;
+      row.push(-(Math.cos(u) + Math.cos(v)) + (x * n + y) * 1e-9);
+    }
+    rows.push(row);
+  }
+  return rows;
+}
+
+const CLUSTER4 = [[7, 13, 11, 4], [12, 16, 14, 8], [10, 15, 6, 2], [5, 9, 3, 1]];   // classic editor's matrix
+const cache = new Map();
+
+/**
+ * Threshold map for an ordered method id ('bayer4', 'bluenoise', 'custom' …).
+ * @param {string} method
+ * @param {number[][]|null} [custom] matrix for 'custom'
+ */
+export function thresholdMap(method, custom = null) {
+  if (method === 'custom') {
+    const m = custom && custom.length ? custom : bayer(4);
+    return { w: m[0].length, h: m.length, levels: m.length * m[0].length, values: toRanks(m) };
+  }
+  if (cache.has(method)) return cache.get(method);
+  let map;
+  const sq = rows => ({ w: rows[0].length, h: rows.length, levels: rows.length * rows[0].length, values: toRanks(rows) });
+  switch (method) {
+    case 'bayer2': map = sq(bayer(2)); break;
+    case 'bayer4': map = sq(bayer(4)); break;
+    case 'bayer8': map = sq(bayer(8)); break;
+    case 'bayer16': map = sq(bayer(16)); break;
+    case 'cluster4': map = sq(CLUSTER4); break;
+    case 'cluster8': map = sq(clustered(8)); break;
+    case 'lines': map = sq([[0], [2], [1], [3]]); break;
+    case 'bluenoise': map = { w: BLUE_NOISE_SIZE, h: BLUE_NOISE_SIZE, levels: 256, values: fromB64(BLUE_NOISE_B64) }; break;
+    default: map = sq(bayer(4));
+  }
+  cache.set(method, map);
+  return map;
+}
+
+/**
+ * Parse a custom matrix typed by a person: rows on lines, numbers separated by spaces or commas.
+ * Accepts an optional "/ 16" style divisor line, which is ignored (only the order matters).
+ */
+export function parseMatrix(text) {
+  const rows = String(text).split(/\r?\n|;/).map(l => l.trim()).filter(l => l && !/^\//.test(l))
+    .map(l => l.replace(/[[\]]/g, '').split(/[\s,]+/).filter(Boolean).map(Number));
+  if (!rows.length) throw new Error('Matrix is empty');
+  const w = rows[0].length;
+  if (rows.some(r => r.length !== w || r.some(v => !Number.isFinite(v)))) throw new Error('Every row needs the same number of values');
+  if (w > 16 || rows.length > 16) throw new Error('Matrices are limited to 16×16');
+  return rows;
+}

package/lib/core/engine.js

@@ -1,158 +1,158 @@
-// The public engine: createPixelator() picks a backend and turns sources into pixel art.
-
-import { makePlan } from './plan.js';
-import { runCPU } from './cpu/pipeline.js';
-import { createGPUBackend } from './gpu/backend.js';
-import { toFrame } from './source.js';
-import { normalizeSettings, LEGACY_DITHER } from './settings.js';
-import { uniqueColors } from './export/scale.js';
-import { toCanvas } from './export/canvas.js';
-import { encodePNG } from './export/png.js';
-
-const isVideo = s => typeof HTMLVideoElement !== 'undefined' && s instanceof HTMLVideoElement;
-const isVideoFrame = s => typeof VideoFrame !== 'undefined' && s instanceof VideoFrame;
-
-/**
- * Create an engine. Reuse one for many images: the GPU backend compiles its shaders once.
- * @param {{ backend?: 'auto' | 'webgl' | 'cpu', diffusion?: 'auto' | 'gpu' | 'cpu', maxSourceSize?: number }} [options]
- *   diffusion: where error diffusion runs. 'auto' uses the GPU unless WebGL is software-rendered.
- */
-export async function createPixelator(options = {}) {
-  const want = options.backend || 'auto';
-  let gpu = null, gpuError = null;
-  if (want !== 'cpu' && typeof document !== 'undefined') {
-    try { gpu = await createGPUBackend(); } catch (e) {
-      gpuError = e;
-      if (want === 'webgl') throw e;
-    }
-  }
-  const scratch = typeof document !== 'undefined' ? document.createElement('canvas') : null;
-  let last = { source: null, frame: null };
-  let queue = Promise.resolve();
-
-  async function frameFor(source) {
-    if (source === last.source && last.frame && !isVideo(source) && !isVideoFrame(source)) {
-      last.frame.dirty = false;
-      return last.frame;
-    }
-    const frame = await toFrame(source, { maxSize: options.maxSourceSize, canvas: scratch });
-    last = { source, frame };
-    return frame;
-  }
-
-  async function processNow(source, settings) {
-    const t0 = typeof performance !== 'undefined' ? performance.now() : Date.now();
-    const frame = await frameFor(source);
-    const plan = makePlan(settings, frame);
-    let data, backend = 'cpu';
-    const diffusionOnCPU = plan.kind === 'diffusion' && (options.diffusion === 'cpu' || (options.diffusion !== 'gpu' && gpu && gpu.software));
-    if (gpu && frame.canvas && !diffusionOnCPU) {
-      data = await gpu.run(plan, frame);
-      backend = 'webgl';
-    } else {
-      data = runCPU(plan, frame);
-    }
-    const ms = (typeof performance !== 'undefined' ? performance.now() : Date.now()) - t0;
-    return makeResult(plan, data, backend, ms);
-  }
-
-  return {
-    /** 'webgl' or 'cpu' */
-    get backend() { return gpu ? 'webgl' : 'cpu'; },
-    /** GPU renderer string (WebGL backend only). */
-    get renderer() { return gpu ? gpu.renderer : ''; },
-    /** Why the GPU backend is not in use, if it isn't. */
-    get fallbackReason() { return gpuError ? String(gpuError.message || gpuError) : ''; },
-    /**
-     * Process one source. Calls are queued, so it is safe to call from input handlers.
-     * @returns {Promise<PixelResult>}
-     */
-    process(source, settings = {}) {
-      const run = queue.then(() => processNow(source, settings));
-      queue = run.catch(() => { });
-      return run;
-    },
-    /** Forget the cached source (call after drawing new content into the same canvas). */
-    invalidate() { last = { source: null, frame: null }; },
-    destroy() { if (gpu) gpu.destroy(); gpu = null; },
-    /** The underlying ShaderMate instance (GPU backend only), for debugging. */
-    get shader() { return gpu ? gpu.shader : null; },
-  };
-}
-
-/**
- * @typedef {object} PixelResult
- * @property {number} width
- * @property {number} height
- * @property {Uint8ClampedArray} data RGBA, rows top-down
- * @property {string[]} palette colours actually available ('#rrggbb')
- * @property {object} settings normalised settings used
- * @property {'webgl'|'cpu'} backend
- * @property {number} ms processing time
- */
-export function makeResult(plan, data, backend = 'cpu', ms = 0) {
-  const result = {
-    width: plan.width,
-    height: plan.height,
-    data,
-    palette: plan.paletteHex ? plan.paletteHex.slice() : null,
-    settings: plan.settings,
-    kind: plan.kind,
-    waves: plan.waves,
-    /** The framed part of the source, as fractions of its width and height. */
-    crop: { x: plan.crop.x / plan.srcWidth, y: plan.crop.y / plan.srcHeight, w: plan.crop.w / plan.srcWidth, h: plan.crop.h / plan.srcHeight },
-    backend,
-    ms,
-    /** Distinct colours actually used in the image. */
-    usedColors() { return uniqueColors(this); },
-    toImageData() { return new ImageData(new Uint8ClampedArray(this.data), this.width, this.height); },
-    /** Canvas at `scale` × (nearest-neighbour), optional grid lines. */
-    toCanvas(scale = 1, opts = {}) { return toCanvas(this, scale, opts); },
-    /** PNG bytes (indexed when ≤ 256 colours unless `indexed: false`). */
-    toPNG(opts = {}) { return encodePNG(this, opts); },
-    async toBlob(opts = {}) { return new Blob([await encodePNG(this, opts)], { type: 'image/png' }); },
-  };
-  return result;
-}
-
-let shared = null;
-/** One-shot helper with a shared engine. `pixelate(source, settings)`. */
-export async function pixelate(source, settings) {
-  // classic API: pixelate({ image, width, dither, strength, palette, resolution }) → canvas
-  if (settings === undefined && source && typeof source === 'object' && 'image' in source && 'width' in source) {
-    return pixelateClassic(source);
-  }
-  shared ||= createPixelator();
-  return (await shared).process(source, settings);
-}
-
-/** Compatibility with image-to-pixel.js 2.x. Returns a canvas like the old function did. */
-async function pixelateClassic(opts) {
-  const { image, width, dither = 'none', strength = 0, palette = null, resolution = 'original' } = opts;
-  let pal = { source: 'none' };
-  if (Array.isArray(palette)) pal = { source: 'custom', colors: palette };
-  else if (typeof palette === 'string') {
-    const { fetchLospec } = await import('./palette/lospec.js');
-    const p = await fetchLospec(palette);
-    pal = { source: 'custom', colors: p.colors, name: p.name };
-  }
-  const settings = normalizeSettings({
-    size: { width },
-    palette: pal,
-    dither: { method: LEGACY_DITHER[String(dither).toLowerCase()] || 'none', strength: strength / 100 },
-    alpha: { threshold: 0 },
-  });
-  shared ||= createPixelator();
-  const engine = await shared;
-  const res = await engine.process(image, settings);
-  if (resolution === 'original') {
-    const frame = await toFrame(image);
-    const c = document.createElement('canvas');
-    c.width = frame.width; c.height = frame.height;
-    const ctx = c.getContext('2d');
-    ctx.imageSmoothingEnabled = false;
-    ctx.drawImage(res.toCanvas(1), 0, 0, c.width, c.height);
-    return c;
-  }
-  return res.toCanvas(1);
-}
+// The public engine: createPixelator() picks a backend and turns sources into pixel art.
+
+import { makePlan } from './plan.js';
+import { runCPU } from './cpu/pipeline.js';
+import { createGPUBackend } from './gpu/backend.js';
+import { toFrame } from './source.js';
+import { normalizeSettings, LEGACY_DITHER } from './settings.js';
+import { uniqueColors } from './export/scale.js';
+import { toCanvas } from './export/canvas.js';
+import { encodePNG } from './export/png.js';
+
+const isVideo = s => typeof HTMLVideoElement !== 'undefined' && s instanceof HTMLVideoElement;
+const isVideoFrame = s => typeof VideoFrame !== 'undefined' && s instanceof VideoFrame;
+
+/**
+ * Create an engine. Reuse one for many images: the GPU backend compiles its shaders once.
+ * @param {{ backend?: 'auto' | 'webgl' | 'cpu', diffusion?: 'auto' | 'gpu' | 'cpu', maxSourceSize?: number }} [options]
+ *   diffusion: where error diffusion runs. 'auto' uses the GPU unless WebGL is software-rendered.
+ */
+export async function createPixelator(options = {}) {
+  const want = options.backend || 'auto';
+  let gpu = null, gpuError = null;
+  if (want !== 'cpu' && typeof document !== 'undefined') {
+    try { gpu = await createGPUBackend(); } catch (e) {
+      gpuError = e;
+      if (want === 'webgl') throw e;
+    }
+  }
+  const scratch = typeof document !== 'undefined' ? document.createElement('canvas') : null;
+  let last = { source: null, frame: null };
+  let queue = Promise.resolve();
+
+  async function frameFor(source) {
+    if (source === last.source && last.frame && !isVideo(source) && !isVideoFrame(source)) {
+      last.frame.dirty = false;
+      return last.frame;
+    }
+    const frame = await toFrame(source, { maxSize: options.maxSourceSize, canvas: scratch });
+    last = { source, frame };
+    return frame;
+  }
+
+  async function processNow(source, settings) {
+    const t0 = typeof performance !== 'undefined' ? performance.now() : Date.now();
+    const frame = await frameFor(source);
+    const plan = makePlan(settings, frame);
+    let data, backend = 'cpu';
+    const diffusionOnCPU = plan.kind === 'diffusion' && (options.diffusion === 'cpu' || (options.diffusion !== 'gpu' && gpu && gpu.software));
+    if (gpu && frame.canvas && !diffusionOnCPU) {
+      data = await gpu.run(plan, frame);
+      backend = 'webgl';
+    } else {
+      data = runCPU(plan, frame);
+    }
+    const ms = (typeof performance !== 'undefined' ? performance.now() : Date.now()) - t0;
+    return makeResult(plan, data, backend, ms);
+  }
+
+  return {
+    /** 'webgl' or 'cpu' */
+    get backend() { return gpu ? 'webgl' : 'cpu'; },
+    /** GPU renderer string (WebGL backend only). */
+    get renderer() { return gpu ? gpu.renderer : ''; },
+    /** Why the GPU backend is not in use, if it isn't. */
+    get fallbackReason() { return gpuError ? String(gpuError.message || gpuError) : ''; },
+    /**
+     * Process one source. Calls are queued, so it is safe to call from input handlers.
+     * @returns {Promise<PixelResult>}
+     */
+    process(source, settings = {}) {
+      const run = queue.then(() => processNow(source, settings));
+      queue = run.catch(() => { });
+      return run;
+    },
+    /** Forget the cached source (call after drawing new content into the same canvas). */
+    invalidate() { last = { source: null, frame: null }; },
+    destroy() { if (gpu) gpu.destroy(); gpu = null; },
+    /** The underlying ShaderMate instance (GPU backend only), for debugging. */
+    get shader() { return gpu ? gpu.shader : null; },
+  };
+}
+
+/**
+ * @typedef {object} PixelResult
+ * @property {number} width
+ * @property {number} height
+ * @property {Uint8ClampedArray} data RGBA, rows top-down
+ * @property {string[]} palette colours actually available ('#rrggbb')
+ * @property {object} settings normalised settings used
+ * @property {'webgl'|'cpu'} backend
+ * @property {number} ms processing time
+ */
+export function makeResult(plan, data, backend = 'cpu', ms = 0) {
+  const result = {
+    width: plan.width,
+    height: plan.height,
+    data,
+    palette: plan.paletteHex ? plan.paletteHex.slice() : null,
+    settings: plan.settings,
+    kind: plan.kind,
+    waves: plan.waves,
+    /** The framed part of the source, as fractions of its width and height. */
+    crop: { x: plan.crop.x / plan.srcWidth, y: plan.crop.y / plan.srcHeight, w: plan.crop.w / plan.srcWidth, h: plan.crop.h / plan.srcHeight },
+    backend,
+    ms,
+    /** Distinct colours actually used in the image. */
+    usedColors() { return uniqueColors(this); },
+    toImageData() { return new ImageData(new Uint8ClampedArray(this.data), this.width, this.height); },
+    /** Canvas at `scale` × (nearest-neighbour), optional grid lines. */
+    toCanvas(scale = 1, opts = {}) { return toCanvas(this, scale, opts); },
+    /** PNG bytes (indexed when ≤ 256 colours unless `indexed: false`). */
+    toPNG(opts = {}) { return encodePNG(this, opts); },
+    async toBlob(opts = {}) { return new Blob([await encodePNG(this, opts)], { type: 'image/png' }); },
+  };
+  return result;
+}
+
+let shared = null;
+/** One-shot helper with a shared engine. `pixelate(source, settings)`. */
+export async function pixelate(source, settings) {
+  // classic API: pixelate({ image, width, dither, strength, palette, resolution }) → canvas
+  if (settings === undefined && source && typeof source === 'object' && 'image' in source && 'width' in source) {
+    return pixelateClassic(source);
+  }
+  shared ||= createPixelator();
+  return (await shared).process(source, settings);
+}
+
+/** Compatibility with image-to-pixel.js 2.x. Returns a canvas like the old function did. */
+async function pixelateClassic(opts) {
+  const { image, width, dither = 'none', strength = 0, palette = null, resolution = 'original' } = opts;
+  let pal = { source: 'none' };
+  if (Array.isArray(palette)) pal = { source: 'custom', colors: palette };
+  else if (typeof palette === 'string') {
+    const { fetchLospec } = await import('./palette/lospec.js');
+    const p = await fetchLospec(palette);
+    pal = { source: 'custom', colors: p.colors, name: p.name };
+  }
+  const settings = normalizeSettings({
+    size: { width },
+    palette: pal,
+    dither: { method: LEGACY_DITHER[String(dither).toLowerCase()] || 'none', strength: strength / 100 },
+    alpha: { threshold: 0 },
+  });
+  shared ||= createPixelator();
+  const engine = await shared;
+  const res = await engine.process(image, settings);
+  if (resolution === 'original') {
+    const frame = await toFrame(image);
+    const c = document.createElement('canvas');
+    c.width = frame.width; c.height = frame.height;
+    const ctx = c.getContext('2d');
+    ctx.imageSmoothingEnabled = false;
+    ctx.drawImage(res.toCanvas(1), 0, 0, c.width, c.height);
+    return c;
+  }
+  return res.toCanvas(1);
+}

package/lib/core/export/canvas.js

@@ -1,22 +1,22 @@
-// DOM helpers: canvases and downloads.
-
-import { upscale } from './scale.js';
-
-/** RGBA image → <canvas>, upscaled by an integer factor with optional grid lines. */
-export function toCanvas(img, scale = 1, opts = {}) {
-  const up = scale > 1 || opts.grid ? upscale(img, scale, opts) : img;
-  const c = opts.canvas || document.createElement('canvas');
-  c.width = up.width; c.height = up.height;
-  c.getContext('2d').putImageData(new ImageData(new Uint8ClampedArray(up.data), up.width, up.height), 0, 0);
-  return c;
-}
-
-/** Trigger a browser download for a Blob or bytes. */
-export function downloadBlob(data, filename, type = 'application/octet-stream') {
-  const blob = data instanceof Blob ? data : new Blob([data], { type });
-  const url = URL.createObjectURL(blob);
-  const a = document.createElement('a');
-  a.href = url; a.download = filename; a.rel = 'noopener';
-  document.body.appendChild(a); a.click(); a.remove();
-  setTimeout(() => URL.revokeObjectURL(url), 10000);
-}
+// DOM helpers: canvases and downloads.
+
+import { upscale } from './scale.js';
+
+/** RGBA image → <canvas>, upscaled by an integer factor with optional grid lines. */
+export function toCanvas(img, scale = 1, opts = {}) {
+  const up = scale > 1 || opts.grid ? upscale(img, scale, opts) : img;
+  const c = opts.canvas || document.createElement('canvas');
+  c.width = up.width; c.height = up.height;
+  c.getContext('2d').putImageData(new ImageData(new Uint8ClampedArray(up.data), up.width, up.height), 0, 0);
+  return c;
+}
+
+/** Trigger a browser download for a Blob or bytes. */
+export function downloadBlob(data, filename, type = 'application/octet-stream') {
+  const blob = data instanceof Blob ? data : new Blob([data], { type });
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement('a');
+  a.href = url; a.download = filename; a.rel = 'noopener';
+  document.body.appendChild(a); a.click(); a.remove();
+  setTimeout(() => URL.revokeObjectURL(url), 10000);
+}