smart-downscaler 0.5.0 → 0.6.0

package/package.json

@@ -5,7 +5,7 @@
     "Pixagram"
   ],
   "description": "Intelligent pixel art downscaler with region-aware color quantization",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "license": "MIT",
   "repository": {
     "type": "git",

package/smart_downscaler.d.ts

@@ -1,34 +1,18 @@
 /* tslint:disable */
 /* eslint-disable */
 
-/**
- * Result of color analysis
- */
 export class ColorAnalysisResult {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
-    /**
-     * Get color at index
-     */
     get_color(index: number): ColorEntry | undefined;
-    /**
-     * Get all colors as a flat array: [r, g, b, count(4 bytes), percentage(4 bytes), ...]
-     * Each color is 11 bytes
-     */
     get_colors_flat(): Uint8Array;
-    /**
-     * Get colors as JSON-compatible array
-     */
     to_json(): any;
     readonly color_count: number;
     readonly success: boolean;
     readonly total_pixels: number;
 }
 
-/**
- * A single color entry with statistics
- */
 export class ColorEntry {
     private constructor();
     free(): void;
@@ -52,13 +36,7 @@ export class WasmDownscaleConfig {
     edge_weight: number;
     hierarchy_min_size: number;
     hierarchy_threshold: number;
-    /**
-     * Iterations for tile centroid
-     */
     k_centroid_iterations: number;
-    /**
-     * K-Means centroid mode (1=Avg, 2=Dom, 3=Foremost)
-     */
     k_centroid: number;
     kmeans_iterations: number;
     max_color_preprocess: number;
@@ -88,78 +66,39 @@ export class WasmDownscaleResult {
 }
 
 /**
- * Analyze colors in an image
- *
- * # Arguments
- * * `image_data` - RGBA pixel data
- * * `max_colors` - Maximum number of unique colors to track (stops if exceeded)
- * * `sort_method` - Sorting method: "frequency", "morton", or "hilbert"
- *
- * # Returns
- * ColorAnalysisResult with array of colors (r, g, b, count, percentage, hex)
- * If unique colors exceed max_colors, returns early with success=false
+ * Analyze colors — FIX: uses HashMap<u32, usize> for O(1) lookup (was O(n) linear scan)
  */
 export function analyze_colors(image_data: Uint8Array, max_colors: number, sort_method: string): ColorAnalysisResult;
 
-/**
- * Compute perceptual color distance between two RGB colors
- */
 export function color_distance(r1: number, g1: number, b1: number, r2: number, g2: number, b2: number): number;
 
 export function downscale(image_data: Uint8Array, width: number, height: number, target_width: number, target_height: number, config?: WasmDownscaleConfig | null): WasmDownscaleResult;
 
 export function downscale_rgba(image_data: Uint8ClampedArray, width: number, height: number, target_width: number, target_height: number, config?: WasmDownscaleConfig | null): WasmDownscaleResult;
 
-/**
- * Simple downscale function with minimal parameters
- */
 export function downscale_simple(image_data: Uint8Array, width: number, height: number, target_width: number, target_height: number, num_colors: number): WasmDownscaleResult;
 
 export function downscale_with_palette(image_data: Uint8Array, width: number, height: number, target_width: number, target_height: number, palette_data: Uint8Array, config?: WasmDownscaleConfig | null): WasmDownscaleResult;
 
-/**
- * Extract a color palette from an image without downscaling
- */
 export function extract_palette_from_image(image_data: Uint8Array, _width: number, _height: number, num_colors: number, kmeans_iterations: number, strategy?: string | null): Uint8Array;
 
-/**
- * Get chroma (saturation) of an RGB color
- */
 export function get_chroma(r: number, g: number, b: number): number;
 
-/**
- * Get lightness of an RGB color in Oklab space
- */
 export function get_lightness(r: number, g: number, b: number): number;
 
-/**
- * Get available palette strategies
- */
 export function get_palette_strategies(): Array<any>;
 
 export function init(): void;
 
-/**
- * Log a message to the browser console (for debugging)
- */
 export function log(message: string): void;
 
-/**
- * Convert Oklab to RGB (utility function for JS)
- */
 export function oklab_to_rgb(l: number, a: number, b: number): Uint8Array;
 
 /**
- * Quantize an image to a specific palette without resizing
+ * Quantize to palette — FIX: compute Oklab once per pixel (was twice)
  */
 export function quantize_to_palette(image_data: Uint8Array, width: number, height: number, palette_data: Uint8Array): WasmDownscaleResult;
 
-/**
- * Convert RGB to Oklab (utility function for JS)
- */
 export function rgb_to_oklab(r: number, g: number, b: number): Float32Array;
 
-/**
- * Get library version
- */
 export function version(): string;

package/smart_downscaler_bg.js

@@ -1,6 +1,3 @@
-/**
- * Result of color analysis
- */
 export class ColorAnalysisResult {
     static __wrap(ptr) {
         ptr = ptr >>> 0;
@@ -27,7 +24,6 @@ export class ColorAnalysisResult {
         return ret >>> 0;
     }
     /**
-     * Get color at index
      * @param {number} index
      * @returns {ColorEntry | undefined}
      */
@@ -36,8 +32,6 @@ export class ColorAnalysisResult {
         return ret === 0 ? undefined : ColorEntry.__wrap(ret);
     }
     /**
-     * Get all colors as a flat array: [r, g, b, count(4 bytes), percentage(4 bytes), ...]
-     * Each color is 11 bytes
      * @returns {Uint8Array}
      */
     get_colors_flat() {
@@ -52,7 +46,6 @@ export class ColorAnalysisResult {
         return ret !== 0;
     }
     /**
-     * Get colors as JSON-compatible array
      * @returns {any}
      */
     to_json() {
@@ -72,9 +65,6 @@ export class ColorAnalysisResult {
 }
 if (Symbol.dispose) ColorAnalysisResult.prototype[Symbol.dispose] = ColorAnalysisResult.prototype.free;
 
-/**
- * A single color entry with statistics
- */
 export class ColorEntry {
     static __wrap(ptr) {
         ptr = ptr >>> 0;
@@ -186,7 +176,6 @@ export class WasmDownscaleConfig {
         return ret;
     }
     /**
-     * Iterations for tile centroid
      * @returns {number}
      */
     get k_centroid_iterations() {
@@ -194,7 +183,6 @@ export class WasmDownscaleConfig {
         return ret >>> 0;
     }
     /**
-     * K-Means centroid mode (1=Avg, 2=Dom, 3=Foremost)
      * @returns {number}
      */
     get k_centroid() {
@@ -290,14 +278,12 @@ export class WasmDownscaleConfig {
         wasm.__wbg_set_wasmdownscaleconfig_hierarchy_threshold(this.__wbg_ptr, arg0);
     }
     /**
-     * Iterations for tile centroid
      * @param {number} arg0
      */
     set k_centroid_iterations(arg0) {
         wasm.__wbg_set_wasmdownscaleconfig_k_centroid_iterations(this.__wbg_ptr, arg0);
     }
     /**
-     * K-Means centroid mode (1=Avg, 2=Dom, 3=Foremost)
      * @param {number} arg0
      */
     set k_centroid(arg0) {
@@ -517,16 +503,7 @@ export class WasmDownscaleResult {
 if (Symbol.dispose) WasmDownscaleResult.prototype[Symbol.dispose] = WasmDownscaleResult.prototype.free;
 
 /**
- * Analyze colors in an image
- *
- * # Arguments
- * * `image_data` - RGBA pixel data
- * * `max_colors` - Maximum number of unique colors to track (stops if exceeded)
- * * `sort_method` - Sorting method: "frequency", "morton", or "hilbert"
- *
- * # Returns
- * ColorAnalysisResult with array of colors (r, g, b, count, percentage, hex)
- * If unique colors exceed max_colors, returns early with success=false
+ * Analyze colors — FIX: uses HashMap<u32, usize> for O(1) lookup (was O(n) linear scan)
  * @param {Uint8Array} image_data
  * @param {number} max_colors
  * @param {string} sort_method
@@ -543,7 +520,6 @@ export function analyze_colors(image_data, max_colors, sort_method) {
 }
 
 /**
- * Compute perceptual color distance between two RGB colors
  * @param {number} r1
  * @param {number} g1
  * @param {number} b1
@@ -602,7 +578,6 @@ export function downscale_rgba(image_data, width, height, target_width, target_h
 }
 
 /**
- * Simple downscale function with minimal parameters
  * @param {Uint8Array} image_data
  * @param {number} width
  * @param {number} height
@@ -643,7 +618,6 @@ export function downscale_with_palette(image_data, width, height, target_width,
 }
 
 /**
- * Extract a color palette from an image without downscaling
  * @param {Uint8Array} image_data
  * @param {number} _width
  * @param {number} _height
@@ -663,7 +637,6 @@ export function extract_palette_from_image(image_data, _width, _height, num_colo
 }
 
 /**
- * Get chroma (saturation) of an RGB color
  * @param {number} r
  * @param {number} g
  * @param {number} b
@@ -675,7 +648,6 @@ export function get_chroma(r, g, b) {
 }
 
 /**
- * Get lightness of an RGB color in Oklab space
  * @param {number} r
  * @param {number} g
  * @param {number} b
@@ -687,7 +659,6 @@ export function get_lightness(r, g, b) {
 }
 
 /**
- * Get available palette strategies
  * @returns {Array<any>}
  */
 export function get_palette_strategies() {
@@ -700,7 +671,6 @@ export function init() {
 }
 
 /**
- * Log a message to the browser console (for debugging)
  * @param {string} message
  */
 export function log(message) {
@@ -710,7 +680,6 @@ export function log(message) {
 }
 
 /**
- * Convert Oklab to RGB (utility function for JS)
  * @param {number} l
  * @param {number} a
  * @param {number} b
@@ -722,7 +691,7 @@ export function oklab_to_rgb(l, a, b) {
 }
 
 /**
- * Quantize an image to a specific palette without resizing
+ * Quantize to palette — FIX: compute Oklab once per pixel (was twice)
  * @param {Uint8Array} image_data
  * @param {number} width
  * @param {number} height
@@ -738,7 +707,6 @@ export function quantize_to_palette(image_data, width, height, palette_data) {
 }
 
 /**
- * Convert RGB to Oklab (utility function for JS)
  * @param {number} r
  * @param {number} g
  * @param {number} b
@@ -750,7 +718,6 @@ export function rgb_to_oklab(r, g, b) {
 }
 
 /**
- * Get library version
  * @returns {string}
  */
 export function version() {