Compress & palette

Sharp-backed helpers exposed as await painter.image.compress(image, options?) and await painter.image.extractPalette(image, options?) (lib-next/output/compression.ts).

Sources:** Buffer, http(s) URL, or filesystem path (**joined with process.cwd() when not absolute / URL).

#compress(image, options?)

##CompressionOptions

Returns encoded Buffer (not necessarily PNG).

1const webp = await painter.image.compress(buf, { format: 'webp', quality: 82, maxWidth: 1024 });

#extractPalette(image, options?)

Downsamples internally to ~200×200 raw RGB, then clusters.

##PaletteOptions

##Return shape

Array<{ color: string; percentage: number }> sorted descending by percentage.

1const swatches = await painter.image.extractPalette('./hero.png', {2  count: 8,3  method: 'median-cut',4  format: 'hsl',5});

#Operational notes

• Network / disk IO failures surface as compress failed: / extractPalette failed: wraps.
• extractPalette percentage derives from clustered pixel assignments vs total sample count (see implementation for details).