docs(readme): WASM core architecture; bump v1.2.0

README documents unfake-core (Rust -> WASM + native CLI) and the slimmed
dependency set (imagetracer + tweakpane + wasm core). Version 1.1.0 -> 1.2.0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: jenissimo

README.md

@@ -30,12 +30,12 @@ This mode is tailored for cleaning up pixel art, especially pieces generated by
 - **Intelligent Scale Detection**: Automatically detects the "true" pixel size of an upscaled pixel art image using `runs-based` or `edge-aware` algorithms. It can also accept a manual scale factor.
 - **Content-Aware Downscaling**: Provides multiple high-quality downscaling methods (`dominant`, `median`, `content-adaptive`, etc.) to reduce the image to its native 1x scale without introducing new colors or blurriness.
 - **Grid Snapping**: Automatically crops the image to align it perfectly with the detected pixel grid, ensuring clean edges.
-- **Color Quantization**: Reduces the color palette to a specified maximum number of colors using the high-quality `image-q` library, with support for fixed custom palettes.
+- **Color Quantization**: Reduces the color palette to a specified maximum number of colors using `imagequant` (libimagequant) in the WASM core, with support for fixed custom palettes.
 - **Artifact Cleanup**: Includes optional post-processing steps like morphological cleanup (to fill holes and remove noise) and jaggy cleanup.
 - **Alpha Channel Processing**: Supports alpha binarization to create sharp, clean transparency.
 
 ### 2. Image Vectorizer
-This mode converts raster images (PNG, JPG) into clean, scalable SVG files. It's an intelligent wrapper around `imagetracer.js` with extensive pre- and post-processing capabilities powered by `OpenCV.js`.
+This mode converts raster images (PNG, JPG) into clean, scalable SVG files. It's an intelligent wrapper around `imagetracer.js` with extensive pre- and post-processing capabilities powered by the `unfake-core` WASM filters.
 
 - **Noise Reduction Pre-Processing**: Applies filters like `Bilateral` or `Median` blur before vectorization to reduce noise and create smoother outlines.
 - **Smart Color Quantization**: Reduces and simplifies the color palette *before* tracing for cleaner vector shapes. It can even auto-detect the optimal number of colors.
@@ -163,13 +163,21 @@ try {
 }
 ```
 
+## Architecture
+
+The image-processing core lives in **`unfake-core`**, a headless Rust crate compiled to **WebAssembly** for the browser tool and to a **native binary** for the CLI (`crates/`). It owns scale detection, grid snapping, downscaling (`dominant` / `median` / `mode` / `mean` / `qvote`), morphological cleanup, color quantization (`imagequant`), content-adaptive downscaling, the vector pre/post filters, and PNG encoding — **no OpenCV**. The JavaScript layer in `browser-tool/` is a thin interface: file I/O, canvas, the Tweakpane UI, and calls into the WASM core.
+
+```sh
+bun run core:wasm   # build the WASM core into browser-tool/vendor/unfake-core/
+bun run core:test   # cargo test
+bun run core:eval   # CLI scale-detection eval on the bghira corpus
+```
+
 ## Core Dependencies
 
-- **OpenCV.js**: For advanced image pre-processing tasks like filtering and transformations.
-- **ImageTracer.js**: The core engine for the vectorization process.
-- **image-q**: A high-quality library for color quantization.
-- **UPNG.js**: For fast PNG encoding and decoding.
-- **Tweakpane**: Used for the interactive settings UI in the browser tool.
+- **unfake-core (Rust → WebAssembly / native)**: The headless image-processing core (see Architecture). Uses `imagequant` for quantization and the `png` crate for encoding.
+- **ImageTracer.js**: The engine for the vectorization (raster → SVG) process.
+- **Tweakpane**: The interactive settings UI in the browser tool.
 
 ## License
 

package.json

@@ -1,13 +1,17 @@
 {
   "name": "unfake.js",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "private": true,
   "type": "module",
   "description": "AI upscaled image → pixel art & vector converter (browser tool + lib)",
   "scripts": {
     "vendor": "bun scripts/vendor-copy.mjs",
     "deploy": "bun scripts/deploy.ts",
-    "deploy:zip": "bun scripts/deploy.ts --zip"
+    "deploy:zip": "bun scripts/deploy.ts --zip",
+    "core:build": "cargo build --release",
+    "core:wasm": "bun scripts/build-core-wasm.mjs",
+    "core:eval": "cargo run --release -- eval-bghira experiments/data/bghira",
+    "core:test": "cargo test"
   },
   "devDependencies": {
     "@types/bun": "latest",