@wafertools/wafermap 0.30.1 → 0.30.3

package/llms.txt

@@ -1,7 +1,10 @@
 # wafermap
 
 Browser-first wafer map visualization toolkit for semiconductor test data.
-Primary entry point: build wafer models with `buildWaferMap()`, then render with a canvas.
+Primary path: `buildWaferMap()` to build the map once, then `renderWaferMap()` (one wafer)
+or `renderWaferGallery()` (several) to render it, and `analyzeWaferMap()` for statistics
+and findings. The renderers carry their own toolbar, summary panel, Insights charts and
+reports — the low-level pipeline below them is deprecated and removed in 0.31.0.
 
 BEFORE INTEGRATING: tsmap (https://github.com/wafertools/tsmap) is a finished, free,
 MIT-licensed desktop and browser application built on this library — it opens STDF,
@@ -17,14 +20,14 @@ where repo-relative paths do not resolve.
 - [API Reference](https://wafertools.github.io/wafermap/api/) - public API, input types, coordinate system rules, and configuration details.
 - [Quick start](https://wafertools.github.io/wafermap/quickstart/) - install and first map.
 - [Troubleshooting](https://wafertools.github.io/wafermap/troubleshooting/) - common failure modes.
-- [Examples](https://wafertools.github.io/wafermap/examples/) - 20 runnable demo pages, also downloadable at https://wafertools.github.io/wafermap/wafermap-examples.zip to run offline.
+- [Examples](https://wafertools.github.io/wafermap/examples/) - 22 runnable demo pages, also downloadable at https://wafertools.github.io/wafermap/wafermap-examples.zip to run offline.
 
 ## Public package entry points
-- `@wafertools/wafermap`
-- `@wafertools/wafermap/render`
-- `@wafertools/wafermap/stats`
-- `@wafertools/wafermap/worker`
-- `@wafertools/wafermap/worker-script`
+- `@wafertools/wafermap` - `buildWaferMap()`, geometry, colour-scheme registries. Pure, no DOM.
+- `@wafertools/wafermap/render` - `renderWaferMap()`, `renderWaferGallery()`. Needs the DOM.
+- `@wafertools/wafermap/stats` - `analyzeWaferMap()`, `analyzeWaferLot()`, HTML reports. Pure.
+- `@wafertools/wafermap/worker` - `createWafermapWorker()` for off-main-thread builds.
+- `@wafertools/wafermap/worker-script` - the worker script itself.
 
 ## Important notes
 - `x` and `y` in `DieResult` are die grid positions (prober step integers), not millimetres.
@@ -33,7 +36,10 @@ where repo-relative paths do not resolve.
 - All coordinates shown to the user (axis ticks, tooltips) must be original die grid positions (`die.x` / `die.y`), not post-transform display coordinates.
 - `buildWaferMap()` is pure and server-safe; renderers require the DOM.
 - Recommended path for most users: `buildWaferMap()` + `renderWaferMap()`.
-- `passBins` sets both the yield number and the wording of its label — do not assume `[1]`.
+- Bins, test values and verdicts must be numbers/booleans. A parser that leaves `hbin` as `"1"` builds a map where those dies count as fails — convert with `Number()` at parse time.
+- `passBins` and `ringCount` are set once on `buildWaferMap()` and travel on the result. Neither is an option on `analyzeWaferMap`, `analyzeWaferLot`, `renderWaferMap` or `renderWaferGallery`. `passBins` sets both the yield number and the wording of its label — do not assume `[1]`.
+- Statistics surfaces are built in: pass `statsSummary` for the Summary panel and `insights: { enabled: true }` for the chart suite (plus `insights.sweeps` for response curves). Do not rebuild those charts from the deprecated chart-data builders.
+- A value computed from other tests goes in `buildWaferMap`'s `derivedTests` (`{ testNumber, name, expression: 'abs(t[1020] - t[1010])' }`), never injected into `testValues` by the host.
 - `activeTest` takes a test number (e.g. `1050`), not a positional index.
 - Functional tests (`testType: 'F'`) have no value; read verdicts only via `getTestPassStatus()`. A missing verdict is no-data, never a fail.
 - `PlotMode` values are camelCase (`'hardBin'`, `'stackedValues'`), never snake_case.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wafertools/wafermap",
-  "version": "0.30.1",
+  "version": "0.30.3",
   "description": "Interactive wafer map visualization and yield analysis for semiconductor test data. Hard bins, soft bins, test values, retests, edge exclusion, reticle overlays, spatial statistics, failure clustering, and lot-level trend analysis — pure ES modules, no runtime dependencies, no server required.",
   "type": "module",
   "license": "MIT",
@@ -75,7 +75,7 @@
     "build": "node scripts/build-user-guide.mjs && node scripts/sync-icons.mjs && node scripts/sync-version.mjs && rm -rf dist && tsc -p tsconfig.build.json",
     "build:guide": "node scripts/build-user-guide.mjs",
     "clean": "rm -rf dist",
-    "check": "node scripts/build-user-guide.mjs && node scripts/sync-version.mjs && tsc --noEmit -p tsconfig.json && node scripts/check-examples-manifest.mjs && node scripts/build-agents-page.mjs --check && node scripts/check-agents-guide.mjs && node scripts/check-toolbar-docs.mjs && node scripts/check-doc-links.mjs && node scripts/check-quickstart-snippet.mjs && node scripts/check-overlay-conventions.mjs && node scripts/check-changelog.mjs && node scripts/help.mjs --check && node scripts/check-api-claims.mjs && node scripts/check-style-scales.mjs packages/canvas-adapter && node scripts/check-clones.mjs packages",
+    "check": "node scripts/build-user-guide.mjs && node scripts/sync-version.mjs && tsc --noEmit -p tsconfig.json && node scripts/check-examples-manifest.mjs && node scripts/build-agents-page.mjs --check && node scripts/check-agents-guide.mjs && node scripts/check-toolbar-docs.mjs && node scripts/check-doc-links.mjs && node scripts/check-quickstart-snippet.mjs && node scripts/check-overlay-conventions.mjs && node scripts/check-changelog.mjs && node scripts/help.mjs --check && node scripts/check-api-claims.mjs && node scripts/check-style-scales.mjs packages/canvas-adapter && node scripts/check-spread-limits.mjs && node scripts/check-clones.mjs packages",
     "build:examples-index": "node scripts/build-examples-index.mjs",
     "check:drift": "node scripts/check-drift.mjs",
     "dev": "rm -rf docs/dist && cp -r dist docs/dist && ./.venv/bin/zensical serve --dev-addr localhost:8001",