@wafertools/wafermap 0.21.1 → 0.23.0

package/AGENTS.md

@@ -0,0 +1,181 @@
+# wafermap — rules for AI coding agents
+
+Guidance for AI tools (Claude Code, Codex, Copilot, Cursor, …) writing code that
+**uses** `@wafertools/wafermap`. Paste the rules below into your project's own
+agent config so they are loaded whenever the agent works on wafer map code.
+
+This library renders semiconductor wafer maps. Its output drives yield calls, lot
+dispositions and process changes, so a plot that is *plausibly but silently wrong*
+is the expensive failure — worse than one that throws. Most rules here exist
+because the obvious-looking code produces exactly that.
+
+<!-- RULES:START -->
+
+## wafermap — usage rules
+
+`@wafertools/wafermap` renders wafer maps from semiconductor die test data.
+Wrong-but-plausible output drives real yield and lot decisions, so prefer failing
+loudly over guessing.
+
+### Entry points
+
+- `@wafertools/wafermap` — `buildWaferMap()`, geometry, `registerColorScheme()`. Pure, no DOM, server-safe.
+- `@wafertools/wafermap/render` — `renderWaferMap()`, `renderWaferGallery()`, `toCanvas()`. Needs the DOM.
+- `@wafertools/wafermap/stats` — `analyzeWaferMap()`, `analyzeWaferLot()`. Pure analysis.
+- `@wafertools/wafermap/worker` — `createWafermapWorker()` for off-main-thread builds.
+
+Default path: `buildWaferMap()` once when data loads, then `renderWaferMap()` for a
+single wafer or `renderWaferGallery()` for several. Reach for `toCanvas()`/`buildView()`
+only when you need the low-level pipeline — they give up the toolbar and every UI
+correctness guarantee that comes with it.
+
+### Traps that produce silently wrong maps
+
+- **Never `die.hbin ?? 0` or `die.sbin ?? 0`.** A missing bin is not bin 0 — it is
+  no-data, and must render grey. Defaulting to 0 invents a bin and changes the
+  yield number. Leave the field absent.
+- **`x` and `y` are prober step positions (integers), not millimetres.** Pass them
+  through unchanged; `dieConfig.width`/`height` convert to physical units. Do not
+  pre-multiply. The geometry inputs are `waferConfig` (type `WaferConfig`) and
+  `dieConfig` (type `DieConfig`) — both optional, both inferred when omitted.
+- **`passBins` decides both the yield number and the wording of its label.** Set it
+  from the actual test program. Do not assume `[1]`.
+- **`testValues` is keyed by test number**, e.g. `{ 1050: 0.42 }` — not a positional
+  array. `activeTest` likewise takes a *test number* (`1050`), not an index.
+- **Functional tests (`testType: 'F'`) have no measured value.** Read their verdicts
+  only via `getTestPassStatus(die, testNumber, def)`; never read `die.testPass`
+  directly and never interpret a 0/1 in `testValues`. A missing verdict is no-data,
+  never a fail.
+- **Show users `die.x` / `die.y` only.** Never surface internal display or
+  transformed coordinates in tooltips, labels or reports, whatever the rotation or
+  flip state.
+- **A die with test results is always fully on the wafer.** A prober only steps to
+  sites that fit. Never recompute a `partial` flag by testing die corners against
+  the wafer circle — that manufactures fake partial dies which are then greyed out
+  and dropped from yield. A die outside the wafer means the *geometry* is wrong.
+- **Check `result.warnings` and `summary.stats.warnings`.** Both carry
+  `WaferWarning` — `{ code, message, severity }`. Branch on `code`, never on the
+  prose. **The two differ in shape and the difference throws:**
+  `result.warnings` is required and always an array (`[]` when clean), but
+  `summary.stats.warnings` is *optional* and is `undefined` when there is nothing
+  to report. Write `summary.stats.warnings?.length` — a bare
+  `summary.stats.warnings.length` is a TypeError on every clean wafer, which is
+  most of them, so it will pass your testing and fail in production.
+  Geometry advisories are severity `'error'`: they mean dies may be drawn in
+  the wrong place. The renderers surface these themselves in a toolbar indicator, so
+  do NOT hand-roll a second display — pass
+  `warnings: { display: false, onWarning }` if the app has its own notification UI.
+  (`result.inference.warnings` is a deprecated string mirror; do not use it.)
+- **Give the container a resolved height.** `renderWaferMap` fills its container.
+  A bare block-flow `<div>` is fine — it grows to the canvas. The real failure is a
+  flex/grid child whose ancestors never resolve a height: it stays 0-tall and the
+  map is invisible. The library detects exactly that case after layout settles and
+  `console.warn`s with the fix, so read the console before debugging further. Either
+  give the container a real CSS height, or pass `{ height: 600 }` in the render
+  options and the library will size it for you.
+
+### API facts that are easy to guess wrong
+
+- `PlotMode` values are camelCase: `'hardBin'`, `'softBin'`, `'value'`, `'metadata'`,
+  `'stackedValues'`, `'stackedBins'`, `'stackedSoftBins'`. Never snake_case.
+- `retestCount` is the total probe count — `2` means probed twice. Do not add 1.
+- `retestPolicy: 'best'`/`'worst'` is pass/fail-aware via `passBins`; bin number only
+  breaks ties within a category.
+- Hard bins (`hbin`) and soft bins (`sbin`) are independent number spaces. Never merge them.
+- Build once, render many: `buildWaferMap()` handles data + geometry; re-render UI
+  changes through the controller's `setOptions()`, not by rebuilding.
+- `result.view` is internal. Use the promoted fields: `result.plotMode`,
+  `result.metadata`, `result.isLotStack`, `result.hbinDefs`, `result.sbinDefs`,
+  `result.testDefs`.
+- Die keys come from `getDieKey(die)`. A hand-rolled `` `${x},${y}` `` breaks
+  click-to-highlight silently, because findings carry `dieKeys` in that exact format.
+- `stats.warnings` is `WaferWarning[]` (it was `string[]` before 0.22.0). Read
+  `w.message` to display, branch on `w.code`. Code that calls a string method on an
+  entry — `warnings[0].includes('…')` — is the old shape and will throw.
+- **`summary.findings` is the complete list and contains restatements of the same
+  fact.** Building a list for a human to read? Exclude what other findings absorb:
+  `const absorbed = new Set(summary.findings.flatMap(f => f.absorbedIds ?? []))`.
+  Skip that and one edge failure is reported up to three times per region — a hard
+  bin row, its soft-bin twin, and the yield row that restates the pass bin. Do NOT
+  use `relatedIds` for this; it is a different relationship and some ids it names
+  no longer exist in `findings`.
+
+### Scale: do not turn this into a data explorer
+
+The most common performance mistake is treating the library as somewhere to dump
+an entire test program and browse it. It is a *renderer* — it analyses everything
+it is handed, because it has no way to know which tests anyone will look at.
+
+- **Pass only the tests you will actually chart or analyse in `testDefs`.** A real
+  parametric program can carry hundreds of tests while the user ever looks at a
+  handful. Cost scales with test count, and test correlation scales
+  *quadratically*: on a ~1,000-die wafer, `enableTestValueAnalysis` costs ~25 ms at
+  6 tests and ~91 ms at 60, while the correlation matrix goes from 15 pairs to 1,770.
+- **Do not "load everything, filter in the UI".** Filtering after the fact means you
+  already paid for the parse, the transfer and the analysis.
+- **The right shape is pre-scan → select → load.** Scan the source for which test
+  numbers exist (and their names/limits if available), let the user choose, then
+  parse and build only the chosen tests. A scan that reads test identity without
+  reading every value is dramatically cheaper than a full load, and it is what makes
+  a large file feel instant.
+- **Above 250 discovered tests, `analyzeWaferMap` gives up on test-value analysis
+  entirely** — it returns no test findings rather than a trimmed set, and records a
+  `WaferWarning` with code `'test-count-capped'` in `stats.warnings`. Silence is not
+  success here: an empty findings list is indistinguishable from "nothing to report"
+  unless you check. Pass `testNumbers: [...]` to scope the analysis explicitly.
+- **Reach for options deliberately.** Plain `analyzeWaferMap()` is cheap;
+  `computePerTestStats` is modest; `enableTestValueAnalysis` is the expensive one
+  (roughly 10× the base analysis on a large wafer) and exists to find spatial
+  patterns automatically — do not enable it by default just because it sounds good.
+- **A Web Worker buys responsiveness, not speed.** `createWafermapWorker` copies data
+  across `postMessage`, so total time goes *up*. Use it when a build would otherwise
+  visibly freeze the page, not for small datasets.
+- **In a gallery, pass `perWaferSummaries` to `analyzeWaferLot`** so it reuses the
+  per-wafer analysis you already ran instead of redoing it.
+
+### Removed — do not emit these
+
+| Never | Use instead |
+| --- | --- |
+| `DieResult.values` / `Die.values` | `testValues` (keyed by test number) |
+| `TestDef.index` | `TestDef.testNumber` (required) |
+| `ViewOptions.colorBySpec` | `passFailDisplay: 'spec'` |
+| `ViewOptions.testIndex` | `activeTest` |
+| `mountWaferCanvas` | `renderWaferMap` |
+| `HARD_BIN_COLORS` / `SOFT_BIN_COLORS` | `BIN_PALETTE` |
+| `GalleryItem` | `WaferMapDisplayItem` |
+| `MountOptions` | `RenderOptions` |
+| `WaferCanvasController` | `WaferMapController` |
+| `CanvasHitTarget` | `HitTarget` |
+| `buildScene` / `BuildSceneOptions` / `SceneOptions` | `buildView` / `ViewOptions` |
+| `WaferFlat`, field `flat` | `WaferNotch`, field `notch` |
+| `isInsideWaferWithFlat` | `isInsideWafer` |
+| `DieSample` / `WaferMapPoint` | `DieResult` |
+| `colorScheme: 'color'` | `colorScheme: 'default'` |
+| `plotMode: 'specLimit'` | `passFailDisplay: 'spec'` |
+| standalone `getDieAtPoint` | `hitTarget.getDieAtPoint` from `toCanvas()` |
+| `RenderOptions.tooltipTestLimit` | (was a no-op; nothing replaces it) |
+
+Passing a removed option is a type error, and is ignored at runtime. Do not add
+compatibility shims for them.
+
+### Terminology in user-facing text
+
+- Never write "channel" — use "index", "slot" or "test". "Channel" is tester
+  hardware jargon that confuses the engineers reading these maps.
+- Label what is actually shown. Name the real pass bins rather than assuming bin 1;
+  say "Hard Bin Breakdown" not "Bin Breakdown"; identify an aggregated or filtered
+  population (`N=50`, "6 wafers · mean") so nobody mistakes a lot stack for one wafer.
+
+<!-- RULES:END -->
+
+## Where to look
+
+- [API reference](https://wafertools.github.io/wafermap/api/) — every type, option and return value
+- [Developer guide](https://wafertools.github.io/wafermap/guide/) — worked walkthroughs
+- [Troubleshooting](https://wafertools.github.io/wafermap/troubleshooting/)
+- [Examples](https://wafertools.github.io/wafermap/examples/) — 20 runnable pages, also
+  [downloadable](https://wafertools.github.io/wafermap/wafermap-examples.zip) to run offline
+
+When a rule here and the API reference disagree, the API reference wins — tell the
+user, so this file gets fixed.

package/CHANGELOG.md

@@ -19,15 +19,275 @@ under `### Breaking`.
 
 ---
 
-## [Unreleased]
+## [0.23.0] — 2026-08-16
+
+### Breaking
+
+- **`Die.x`/`y`/`physX`/`physY` are now optional**, not `number`. Existing code
+  that reads `die.x` as a bare number (e.g. arithmetic without a guard) now gets
+  a type error under strict TS — the runtime value for already-positioned data
+  is unchanged, only the type widened. New `isPositionedDie(die): die is PositionedDie`
+  (`@wafertools/wafermap/core`) narrows it back; every spatial function in the
+  library (region builders, cluster/pattern detection, `buildView`) now takes
+  `PositionedDie[]` rather than `Die[]`, so a caller passing unfiltered `Die[]`
+  into one of these will see the type error at the call site rather than a
+  runtime surprise. Its sibling `hasPosition(die)` is the looser guard for
+  inputs that carry `x`/`y` but no `physX`/`physY` (a raw `DieResult`, before
+  layout); use `isPositionedDie` for anything holding built `Die`s.
+
+### Added
+
+- **`renderWaferMap` accepts a `RenderableWaferMap`** — `{ wafer, dies }` plus
+  every other `WaferMapResult` field as optional — rather than requiring a full
+  `WaferMapResult`. A `WaferMapResult` still satisfies it, so no caller needs to
+  change. This makes the gallery's own use honest: it renders each card through
+  `renderWaferMap`, but a card is a `WaferMapDisplayItem` carrying no
+  `dataCoverage`/`viewport`/`legendBox`/`binLegendRows`/`reticleConfig`, and it
+  used to be passed via `item as WaferMapResult`. That cast asserted fields
+  which were absent at runtime; reading one unguarded threw, and each such read
+  had to be found by hitting it. `collectWarnings` likewise now types
+  `result.warnings` as optional, which its body already handled.
+
+- **Support for dies/wafers with no reported X/Y position.** Real-world data
+  sometimes has no spatial layout at all (wafer-number-only test logs), or a
+  lot/wafer where some dies report a position and others don't — previously
+  such a die was silently dropped by every parser upstream of this library, and
+  wmap itself had no representation for "no position" beyond crashing or
+  drawing garbage.
+  - `hasPosition(die)` / `isPositionedDie(die)` (`packages/core/dies.ts`) are
+    the predicates every spatial code path filters on — the first narrows
+    `x`/`y`, the second narrows `physX`/`physY` with them and so yields a
+    `PositionedDie`. `getDieKey` falls back to `` `id:${id}` `` for an
+    unpositioned die so two of them never collide.
+  - `buildWaferMap` partitions positioned/unpositioned dies before geometry
+    inference runs; unpositioned dies are folded back into the returned
+    `dies`/`dataCoverage`/`yield` afterward. `dataCoverage` gained
+    `unpositionedDies: number` (always present); `totalDies`/`filledDies`/
+    `ratio` stay scoped to positioned dies only. Yield is deliberately
+    **not** spatial — a coordinate-less die with bin data still counts toward
+    it, same as `isYieldEligibleDie` always ignored position.
+  - `analyzeWaferMap`/`regions.ts` exclude unpositioned dies from spatial
+    region families only (ring/quadrant/sector/reticle-position, cluster and
+    pattern detection). Everything value-based (yield, bin counts, per-test
+    stats, spec-limit yield) is unaffected — coordinate-less dies still count.
+  - A wafer with **zero** positioned dies never renders as a wafer-shaped
+    visual — a fabricated mosaic risks being misread as real spatial data.
+    `renderWaferMap`/`renderWaferGallery` instead show a compact,
+    plot-mode-aware summary in its place: a bin breakdown (reusing the
+    existing summary-panel component, so colours match the map's own bin
+    legend) for hard/soft-bin modes, or a small histogram for value mode
+    (coloured through the same colour-scheme/log-scale/spec-range resolution
+    the map's own colorbar uses). A **View die list** toggle reaches the full
+    per-die table (`buildDieListSection`, new, exported from `/render`) for
+    CSV export and per-die inspection, and **View chart** returns. A mixed
+    wafer keeps its normal map for the positioned dies, plus an expandable
+    "+N dies without position data" footer giving the same chart/die-list
+    toggle for the rest.
+  - The toolbar's spatial-only controls (zoom/pan/select/download,
+    orientation, overlays, legend position) are hidden on a fully
+    coordinate-less card — nothing to act on with no map drawn. Plot mode and
+    colour scheme stay, since both drive the summary's own appearance.
+  - A gallery card's own "expand" button now preserves that card's live view
+    state (plot mode, active test, colour scheme, …) when opening the
+    detached window/popup, rather than always reverting to the gallery's
+    shared default — a pre-existing gap for any card (not specific to
+    coordinate-less data) that became far more visible once a card's
+    representation could change shape between modes (bin breakdown vs.
+    histogram vs. map).
+
+### Fixed
+
+- **`buildDieListSection`'s table was capped at a fixed 360px**, regardless of
+  how much room its container actually had — a short table floated in a
+  half-empty card, and a host mounting it inside a scrolling container of its
+  own got two nested scrollbars. It now fills its container by default
+  (`flex: 1; min-height: 0`); a new optional `maxHeight` re-imposes a cap for a
+  host with no definite-height container to fill.
+
+### Known gaps (not fixed this pass, tracked for a follow-up)
+
+- Stacked plot modes (`stackedValues`/`stackedBins`/`stackedSoftBins`) discard
+  every individual wafer card from the gallery grid and pool across the lot —
+  a coordinate-less wafer's dies are correctly excluded from those pooled
+  aggregates (stacking is inherently position-based), but nothing in the UI
+  currently indicates a wafer was excluded; it's indistinguishable from that
+  wafer not existing in the lot at all.
+- `hasPosition`, `PositionedDie`, `dataCoverage.unpositionedDies`, and
+  `buildDieListSection`/`DieListOptions` are documented in `docs/api.md`
+  (§12.1, §7); a dedicated numbered reference entry for `hasPosition` and
+  `buildDieListSection` alongside the library's other numbered API entries
+  has not been added yet.
+
+---
+
+## [0.22.0] — 2026-08-04
+
+### Breaking
+
+- **`StatsSummary.stats.warnings` is now `WaferWarning[]`, not `string[]`.** The
+  library raised advisories in two incompatible shapes — structured
+  `{ code, message }` on `WaferMapResult.warnings`, raw prose strings on the stats
+  summary — so a host had two vocabularies to handle and no stable key to branch
+  on for half of them. Both are now `WaferWarning`.
+
+  Migration: read `w.message` where you previously read the string, and branch on
+  the new stable `w.code` (`'test-count-capped'` is the one raised today) instead
+  of matching prose. Code that did `warnings[0].includes('…')` is exactly what
+  this replaces — that string was never a contract.
+
+- **`findTestDef`, `resolveTestNumber`, `getUniqueTestNumbers` and
+  `generateTextOverlay` are no longer exported from `/renderer` (or the root).**
+  They are internal helpers of the view pipeline with no documented contract, and
+  nothing outside the library used them. An export nobody can look up is still API
+  surface you cannot change later, so they were withdrawn rather than documented.
+
+  Migration: none expected. If you did depend on one, import it from
+  `@wafertools/wafermap/renderer/buildView.js` and open an issue saying what for —
+  the fix is to give you a supported entry point, not to re-widen the surface.
+
+### Added
+
+- **The library now surfaces its own data warnings.** A ⚠ indicator appears in the
+  toolbar only when there is something to say; clicking it lists each advisory with
+  its code and explanation. It also feeds the Summary panel's banner and a new
+  `onWarning` callback, all from one collected, de-duplicated, severity-ordered set.
+
+  This closes a real gap rather than adding a nicety: **geometry advisories were
+  rendered by no UI at all.** `'partial-coverage'` means the inferred diameter and
+  centre may be wrong and dies may be drawn in the wrong place, and nothing ever
+  told the person looking at the map. Analysis advisories fared little better — they
+  appeared only if the host both passed `statsSummary` and the user opened the
+  Summary panel. The library has the information to know the display may mislead,
+  so showing it is its responsibility, not the caller's.
+
+  Deliberately not a toast: these are persistent conditions about whether the map
+  can be trusted, and a message that dismisses itself leaves the map still wrong
+  with no way back to the explanation.
+
+- **`WarningsOptions` on `renderWaferMap` and `renderWaferGallery`** —
+  `{ display?: boolean; onWarning?: (warnings: WaferWarning[]) => void }`. Hosts
+  with their own notification system pass `{ display: false, onWarning }`: the
+  library still collects, de-duplicates and severity-orders, and the host owns only
+  presentation. `collectWarnings` and `severityOf` are exported from
+  `@wafertools/wafermap/render` so such a host can reproduce exactly the set the
+  built-in UI would have shown rather than re-deriving it from two sources.
+
+- **`WaferWarning.severity`** — `'error' | 'warning' | 'info'`, defaulting to
+  `'warning'`. Geometry advisories are `'error'` (the map may be positionally
+  wrong); the test-count cap is `'warning'` (a feature produced nothing, but what
+  is drawn is correct). Drives the indicator's colour and ordering — and the
+  severity is always in the accessible name too, never colour alone.
+
+- New `--wmap-err-bg` / `--wmap-err-border` / `--wmap-err-text` theme tokens
+  (9.55:1 contrast on their background, clearing WCAG AA on all three surfaces
+  they appear on).
+
+
+- **Downloadable examples package.** `site/wafermap-examples.zip`, built as part of
+  `npm run build:site` and published alongside the docs. Contains every example, the
+  bundled library, the sample datasets, and a `starter/` skeleton to copy as the seed
+  of an application. Unzip, run `sh serve.sh` (or `serve.cmd` on Windows), and it works
+  with no npm install and no network — the offline path matters for locked-down fab
+  networks. The bundled `serve.py` pins the MIME type for `.js` rather than trusting
+  the platform: Python's stdlib server reads MIME types from the Windows registry, and
+  where that mapping has been altered it serves JavaScript as `text/plain`, which
+  browsers refuse to execute as a module — failing every page on Windows while working
+  on Linux.
+- **`AGENTS.md` — usage rules for AI coding agents.** Most consumers now write wafer
+  map code through Claude Code, Codex, Copilot or Cursor, and this library's inputs
+  invite confident wrong guesses: `die.hbin ?? 0` reads as ordinary defensive coding
+  but turns no-data dies into bin 0 and moves the yield number; `activeTest` reads
+  like an index but is a test number. The file's core is a copy-paste block for the
+  consumer's own agent config, surfaced at
+  [/agents/](https://wafertools.github.io/wafermap/agents/), shipped in the npm
+  package (`node_modules/@wafertools/wafermap/AGENTS.md`) and at the root of the
+  examples archive. `scripts/check-agents-guide.mjs` verifies it against
+  `dist/**/*.d.ts` on every `npm run check` and CI run — every recommended symbol
+  must exist, every symbol in the removal table (parsed from the table itself, not a
+  duplicate list) must be absent, and structural claims are checked rather than
+  trusted. An agent guide that names a removed API is worse than none.
+- `llms.txt` now ships in the npm package and the examples archive, with its
+  repo-relative links replaced by absolute ones — they resolved to nothing in both
+  of those locations.
+- `docs/examples/manifest.json` — single source for the examples list, consumed by
+  `demo-nav.js`, the `index.md` generator, the archive builder, and a nav consistency
+  check wired into `npm run check` and the test suite.
 
 ### Changed
 
+- **Findings no longer restate the same fact several times.** One edge failure
+  could produce, per region: a hard-bin row, its soft-bin twin with an identical
+  delta, a pass-bin row, and a yield row saying the same thing as the pass-bin row
+  — up to seven rows for what an engineer would state in one sentence. Two exact
+  redundancies now collapse:
+
+  - A soft-bin finding whose hard-bin twin covers **provably the same dies** is
+    absorbed, and the surviving row says so (`Hard and soft bin 3 (same dies)`).
+    The test is die-set identity computed from the dies, never bin-number
+    equality — hard and soft bins are independent number spaces, and merging on
+    the number would report one population under the other's name.
+  - When exactly one pass bin is configured, that bin's row and the yield row are
+    the same statement by definition, so the bin row is absorbed into the yield
+    row. With several pass bins no single bin equals yield, and the rule correctly
+    does not fire.
+
+  The surviving row names what it absorbed — "Ring 4 (edge) has hard bin 3 and
+  soft bin 3 (same dies) occurrence 8.8 percentage points higher…" — rather than
+  quietly dropping the other half. "(same dies)" is load-bearing: without it the
+  wording could be read as two populations summed.
+
+  This applies at lot level too. `analyzeWaferLot` skips per-wafer findings that
+  were absorbed, so a twin does not reappear as its own lot row — which is where
+  the duplication was most misleading, since every lot row is annotated "seen on
+  N/M wafers" and one fact stated twice reads as two signals corroborating
+  each other.
+
+  Nothing is discarded: absorbed findings remain in `summary.findings` and are
+  still returned by `filterFindings`. Only the Summary panel and the findings
+  report hide them, via the new `StatsFinding.absorbedIds`.
+
+- `StatsFinding.absorbedIds` — IDs of findings another finding restates. Kept
+  separate from `relatedIds`, which already meant two different things (a
+  run-merge's audit trail of constituents it *replaced*, which no longer exist,
+  and a spatial pattern's live supporting detail). Anything in `absorbedIds` is
+  guaranteed still present in `findings`.
+
+- **Examples consolidated from 26 pages to 20.** Several demos differed only by which
+  option was enabled. `findings`, `summary-panel`, `lot-findings`, `gallery` and
+  `lot-stack-analysis` are now one `statistics.html` with a scope selector
+  (single wafer / lot gallery / lot stack) whose banner names the exact calls and
+  options in force; `color-schemes` folded into `display-control.html`, where the
+  existing scheme dropdown already did the same job; `partial-data` folded into
+  `geometry.html` as a second section. Every old URL keeps a redirect stub pointing at
+  the merged page and the anchor that reproduces what it used to show, and the Guide
+  cross-links now target those anchors, so per-topic granularity is unchanged.
+
 - **Package renamed from `@paulrobins/wafermap` to `@wafertools/wafermap`.** The GitHub repo
   moved from `telecasterer/wafermap` to `wafertools/wafermap` along with it — repository,
   homepage, and issue-tracker URLs all point at the new org. `@paulrobins/wafermap` is
   deprecated on npm in favour of this package; no functional changes.
 
+### Fixed
+
+- **The toolbar could overflow across neighbouring content.** It is pinned by its
+  right edge with no width bound, so once wider than its container the excess grew
+  leftward — out of the card and over whatever sat beside it (the next map in a
+  grid, an adjacent gallery card). It had always been wider than a ~400px
+  container. It now wraps within the container, breaking between control groups
+  rather than mid-group, with `wrap-reverse` so the trailing group keeps the top
+  row and Expand keeps its top-right corner.
+
+
+- **Custom colour schemes did not work on the built documentation site.**
+  `scripts/bundle-docs.mjs` built each importmap entry point as an independent esbuild
+  bundle, so `wafermap` and `wafermap/render` each inlined a private copy of the
+  colour-scheme registry. `registerColorScheme` imported from `wafermap` wrote into a
+  registry the renderer never read, and a custom scheme rendered pixel-identical to the
+  default palette — silently, with no error. All entry points are now built in one
+  invocation with code splitting, so shared module state lives in a common chunk. Only
+  ever affected the bundled site build; `npm run dev` serves unbundled modules that
+  resolve to one shared file, which is why it went unnoticed.
+
 ## [0.21.1] — 2026-07-31
 
 ### Added

package/README.md

@@ -1,5 +1,7 @@
 # wafermap
 
+<img src="docs/images/wafermap-readme-header-256.png" width="64" height="64" alt="wafermap icon">
+
 [![CI](https://github.com/wafertools/wafermap/actions/workflows/ci.yml/badge.svg)](https://github.com/wafertools/wafermap/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@wafertools/wafermap.svg)](https://www.npmjs.com/package/@wafertools/wafermap)
 ![runtime deps](https://img.shields.io/badge/runtime%20deps-0-brightgreen)
@@ -14,6 +16,11 @@ Browser-first wafer map visualization for semiconductor test data.
 
 **[Project Portal: Docs & Interactive Demos →](https://wafertools.github.io/wafermap/)**
 
+## Community
+
+Questions, ideas, or want to show off a wafer map you built? Use [GitHub
+Discussions](https://github.com/wafertools/.github/discussions).
+
 ## Overview
 
 wafermap renders interactive wafer maps from semiconductor prober output. Hard bins, soft bins, test values, retest runs, edge exclusion, and spec limits are native inputs.
@@ -56,8 +63,9 @@ and stats layers.
 - [Developer Guide](https://wafertools.github.io/wafermap/guide/)
 - [SvelteKit](https://wafertools.github.io/wafermap/sveltekit/) · [React](https://wafertools.github.io/wafermap/react/) · [Vue 3](https://wafertools.github.io/wafermap/vue/) integration guides
 - [API Reference](https://wafertools.github.io/wafermap/api/)
+- [Using wafermap with an AI coding agent](https://wafertools.github.io/wafermap/agents/) — rules to paste into Claude Code / Codex / Copilot / Cursor, also shipped as `AGENTS.md` in this package
 - [Architecture](https://wafertools.github.io/wafermap/architecture/) · [Performance](https://wafertools.github.io/wafermap/performance/) · [Troubleshooting](https://wafertools.github.io/wafermap/troubleshooting/)
-- [Live examples](https://wafertools.github.io/wafermap/examples/)
+- [Live examples](https://wafertools.github.io/wafermap/examples/) — or [download them](https://wafertools.github.io/wafermap/wafermap-examples.zip) to run and edit locally, offline, with the library bundled in
 
 **Using an app built with wafermap** (test / device / yield engineers):
 

package/dist/packages/canvas-adapter/charts/histogram.js

@@ -1 +1 @@
-import{buildTestHistogramData as Ht,buildTestHistogramSeries as At}from"../../stats/histogram.js";import{CLR as lt}from"../toolbar.js";import{fmt as st}from"../../renderer/fmt.js";import{QUANTITY as Wt,categorical as Ct}from"./palette.js";import{cardShell as Et,observeResize as xt,makeTooltip as Pt,positionChartTooltip as bt,makeTestSelect as $t,makeWaferSelect as Bt,makeToggle as Rt,renderEmptyState as pt,chartFillHeight as yt,applyCanvasFlow as Mt,resolveChartCanvasColors as Tt,makeAxisFormat as vt,PADDING as tt}from"./chartShell.js";const mt=230,St=36,at=18;function kt(s,R,N,z,rt,I,b,u=4){const j=Math.max(1,I/u),F=Math.pow(10,Math.floor(Math.log10(j))),f=j/F,G=(f<=1?1:f<=2?2:f<=5?5:10)*F,$=z-N;s.save(),s.font="10px system-ui, sans-serif",s.textAlign="right",s.textBaseline="middle";for(let K=0;K<=I+1e-9;K+=G){const _=z-K/(I||1)*$;s.strokeStyle=b.grid,s.lineWidth=1,s.beginPath(),s.moveTo(R,_),s.lineTo(R+rt,_),s.stroke(),s.fillStyle=b.text,s.fillText(String(Math.round(K)),R-4,_)}s.strokeStyle=b.axis,s.lineWidth=1,s.beginPath(),s.moveTo(R,N),s.lineTo(R,z),s.stroke(),s.restore()}export function renderHistogramPanel(s){const{title:R="Test value distribution",items:N,testDefs:z,onSaveImage:rt,groups:I}=s,{card:b,body:u,controlsRow:j}=Et(R,rt),F=z.filter(a=>a.testNumber!==void 0);let f=s.selectedTestNumber??F[0]?.testNumber??null,G=null,$=!1;const K=$t(F,f,a=>{f=a,U()},{maxWidth:"200px"});j.appendChild(K);const _=Bt(N,G,a=>{G=a,U()});j.appendChild(_),j.appendChild(Rt("Axis includes limits",$,a=>{$=a,U()}));const A=Pt(b);let J=null,M=null;function et(a){const w=z.find(O=>O.testNumber===a);return{unit:w?.unit,limitLow:w?.limitLow,limitHigh:w?.limitHigh}}function U(){if(J?.disconnect(),J=null,u.innerHTML="",f===null){pt(u,"No parametric test data available for a histogram.");return}const a=I&&I.length>0?At(I,f,16,$?et(f).limitLow:void 0,$?et(f).limitHigh:void 0):null;if(_.style.display=a?"none":"",a){if(a.series.length===0){pt(u,"No parametric test data available for a histogram.");return}Lt(a);return}const w=G!==null?[N[G]]:N,{unit:O,limitLow:nt,limitHigh:x}=et(f),i=Ht(w,f,16,$?nt:void 0,$?x:void 0);if(i.length===0){pt(u,"No parametric test data available for a histogram.");return}const D=Math.max(...i.map(p=>p.count),1),P=document.createElement("div");Object.assign(P.style,{fontSize:"12px",color:lt.label,marginBottom:"2px"}),P.textContent=`max ${D} dies/bucket`,u.appendChild(P);const h=document.createElement("canvas");h.style.display="block",h.style.cursor="default",u.appendChild(h);let v=-1;const g=window.devicePixelRatio||1,B=i[0].rangeLow,X=i[i.length-1].rangeHigh,ot=X-B||1,Z=vt(Math.max(Math.abs(B),Math.abs(X)),O);function Y(p){const m=tt+36,e=h.clientWidth-m-tt,n=p-St-at;return{plotX:m,plotMaxWidth:Math.max(10,e),plotMaxHeight:n,plotTop:at}}function ct(p){const{plotX:m,plotMaxWidth:e}=Y(mt);if(p<m||p>m+e)return-1;const n=Math.floor((p-m)/e*i.length);return n>=0&&n<i.length?n:-1}function H(){Mt(h,P.offsetHeight);const p=u.clientWidth,m=yt(b,u,h,mt);h.width=Math.max(1,Math.floor(p*g)),h.height=Math.max(1,Math.floor(m*g)),h.style.width=`${p}px`,h.style.height=`${m}px`;const e=h.getContext("2d");e.setTransform(g,0,0,g,0,0),e.clearRect(0,0,p,m),e.font="11px system-ui, sans-serif";const n=Tt(b),{plotX:c,plotMaxWidth:t,plotMaxHeight:d,plotTop:o}=Y(m),l=o+d,S=t/i.length;kt(e,c,o,l,t,D,{text:n.textMuted,axis:n.border,grid:n.border}),i.forEach((y,C)=>{const k=y.count/D*d,r=c+C*S,L=l-k;e.fillStyle=C===v?n.text:Wt,e.globalAlpha=C===v?1:.7,e.fillRect(r+1,L,Math.max(1,S-2),k),e.globalAlpha=1,C===v&&(e.fillStyle=n.text,e.textAlign="center",e.textBaseline="bottom",e.fillText(`${y.count}`,r+S/2,L-2))});const V=y=>c+(y-B)/ot*t;e.font="10px system-ui, sans-serif";for(const[y,C]of[[nt,"LSL"],[x,"USL"]]){if(y===void 0)continue;const k=V(y);e.strokeStyle=n.warnBorder,e.setLineDash([3,3]),e.lineWidth=1,e.beginPath(),e.moveTo(k,o),e.lineTo(k,l),e.stroke(),e.setLineDash([]),e.fillStyle=n.warnBorder,e.textAlign="center",e.textBaseline="bottom",e.fillText(C,k,o-2)}e.font="11px system-ui, sans-serif",e.strokeStyle=n.border,e.lineWidth=1,e.beginPath(),e.moveTo(c,l),e.lineTo(c+t,l),e.stroke(),e.fillStyle=n.textMuted,e.textAlign="center",e.textBaseline="top";const W=Math.max(2,Math.floor(t/44)),dt=Math.ceil(i.length/W),ht=Math.max(1,dt);for(let y=0;y<=i.length;y+=ht){const C=y<i.length?i[y].rangeLow:i[i.length-1].rangeHigh,k=c+y*S;e.beginPath(),e.moveTo(k,l),e.lineTo(k,l+4),e.stroke(),e.fillText(Z.tick(C),k,l+6)}Z.unitLabel&&(e.save(),e.font="10px system-ui, sans-serif",e.fillStyle=n.textMuted,e.textAlign="right",e.textBaseline="top",e.fillText(`(${Z.unitLabel})`,c+t,l+20),e.restore())}h.addEventListener("mousemove",p=>{const m=h.getBoundingClientRect(),e=ct(p.clientX-m.left);if(e!==v&&(v=e,H()),e>=0){const n=i[e];A.innerHTML=`<strong>${st(n.rangeLow,O,"engineering")} \u2013 ${st(n.rangeHigh,O,"engineering")}</strong><br>${n.count} dies`,A.style.display="block",bt(A,b,p.clientX,p.clientY)}else A.style.display="none"}),h.addEventListener("mouseleave",()=>{v!==-1&&(v=-1,H()),A.style.display="none"}),J=xt(b,()=>H()),H()}function Lt(a){const{unit:w,limitLow:O,limitHigh:nt}=et(f),x=a.ranges,i=a.series,D=Ct;M&&!i.some(n=>n.groupKey===M)&&(M=null);const P=Math.max(1,...i.flatMap(n=>n.counts)),h=document.createElement("div");Object.assign(h.style,{fontSize:"12px",color:lt.label,marginBottom:"2px"}),h.textContent=`${i.length} groups \xB7 max ${P} dies/bucket`,u.appendChild(h);const v=document.createElement("div");Object.assign(v.style,{display:"flex",flexWrap:"wrap",gap:"4px 12px",marginBottom:"4px"}),i.forEach((n,c)=>{const t=document.createElement("button");t.type="button",t.title=`${n.groupKey} \u2014 click to emphasize (dim the rest)`,Object.assign(t.style,{display:"inline-flex",alignItems:"center",gap:"5px",fontSize:"11px",padding:"1px 4px",border:"none",background:"none",cursor:"pointer",color:lt.text,borderRadius:"3px"});const d=document.createElement("span");Object.assign(d.style,{width:"10px",height:"10px",borderRadius:"2px",background:D(c),flex:"0 0 auto"});const o=document.createElement("span");o.textContent=n.groupKey,t.append(d,o);const l=M!==null&&M!==n.groupKey;t.style.opacity=l?"0.45":"1",M===n.groupKey&&(t.style.background=lt.bgHover),t.addEventListener("click",()=>{M=M===n.groupKey?null:n.groupKey,U()}),v.appendChild(t)}),u.appendChild(v);const g=document.createElement("canvas");g.style.display="block",g.style.cursor="default",u.appendChild(g);const B=window.devicePixelRatio||1,X=x[0].rangeLow,ot=x[x.length-1].rangeHigh,Z=ot-X||1,Y=vt(Math.max(Math.abs(X),Math.abs(ot)),w),ct=()=>h.offsetHeight+v.offsetHeight;let H=-1,p={plotX:tt+36,plotMaxWidth:10,barWidth:10};function m(){Mt(g,ct());const n=u.clientWidth,c=yt(b,u,g,mt);g.width=Math.max(1,Math.floor(n*B)),g.height=Math.max(1,Math.floor(c*B)),g.style.width=`${n}px`,g.style.height=`${c}px`;const t=g.getContext("2d");t.setTransform(B,0,0,B,0,0),t.clearRect(0,0,n,c),t.font="11px system-ui, sans-serif";const d=Tt(b),o=tt+36,l=Math.max(10,n-o-tt),S=at,V=c-St-at,T=S+V,W=l/x.length;p={plotX:o,plotMaxWidth:l,barWidth:W},kt(t,o,S,T,l,P,{text:d.textMuted,axis:d.border,grid:d.border}),H>=0&&(t.fillStyle=d.bgHover,t.globalAlpha=.5,t.fillRect(o+H*W,S,W,V),t.globalAlpha=1);const dt=i.map((r,L)=>({s:r,i:L})).sort((r,L)=>(r.s.groupKey===M?1:0)-(L.s.groupKey===M?1:0));for(const{s:r,i:L}of dt){const E=M===r.groupKey,ut=M!==null&&!E,ft=D(L);t.strokeStyle=ft,t.fillStyle=ft,t.lineWidth=E?2:1,t.globalAlpha=ut?.12:M?.32:.22,t.beginPath(),t.moveTo(o,T),r.counts.forEach((gt,it)=>{const Q=o+it*W,q=T-gt/P*V;t.lineTo(Q,q),t.lineTo(Q+W,q)}),t.lineTo(o+l,T),t.closePath(),t.fill(),t.globalAlpha=ut?.3:1,t.beginPath(),r.counts.forEach((gt,it)=>{const Q=o+it*W,q=T-gt/P*V;it===0?t.moveTo(Q,q):t.lineTo(Q,q),t.lineTo(Q+W,q)}),t.stroke()}t.globalAlpha=1;const ht=r=>o+(r-X)/Z*l;t.font="10px system-ui, sans-serif";for(const[r,L]of[[O,"LSL"],[nt,"USL"]]){if(r===void 0)continue;const E=ht(r);t.strokeStyle=d.warnBorder,t.setLineDash([3,3]),t.lineWidth=1,t.beginPath(),t.moveTo(E,S),t.lineTo(E,T),t.stroke(),t.setLineDash([]),t.fillStyle=d.warnBorder,t.textAlign="center",t.textBaseline="bottom",t.fillText(L,E,S-2)}t.font="11px system-ui, sans-serif",t.strokeStyle=d.border,t.lineWidth=1,t.beginPath(),t.moveTo(o,T),t.lineTo(o+l,T),t.stroke(),t.fillStyle=d.textMuted,t.textAlign="center",t.textBaseline="top";const C=Math.max(2,Math.floor(l/44)),k=Math.max(1,Math.ceil(x.length/C));for(let r=0;r<=x.length;r+=k){const L=r<x.length?x[r].rangeLow:x[x.length-1].rangeHigh,E=o+r*W;t.beginPath(),t.moveTo(E,T),t.lineTo(E,T+4),t.stroke(),t.fillText(Y.tick(L),E,T+6)}Y.unitLabel&&(t.save(),t.font="10px system-ui, sans-serif",t.fillStyle=d.textMuted,t.textAlign="right",t.textBaseline="top",t.fillText(`(${Y.unitLabel})`,o+l,T+20),t.restore())}function e(n){const{plotX:c,plotMaxWidth:t,barWidth:d}=p;if(n<c||n>c+t)return-1;const o=Math.floor((n-c)/d);return o>=0&&o<x.length?o:-1}g.addEventListener("mousemove",n=>{const c=g.getBoundingClientRect(),t=e(n.clientX-c.left);if(t!==H&&(H=t,m()),t>=0){const d=x[t],o=i.map((l,S)=>`<span style="display:inline-block;width:9px;height:9px;border-radius:2px;background:${D(S)};margin-right:5px;"></span>${l.groupKey}: ${l.counts[t]}`).join("<br>");A.innerHTML=`<strong>${st(d.rangeLow,w,"engineering")} \u2013 ${st(d.rangeHigh,w,"engineering")}</strong><br>${o}`,A.style.display="block",bt(A,b,n.clientX,n.clientY)}else A.style.display="none"}),g.addEventListener("mouseleave",()=>{H!==-1&&(H=-1,m()),A.style.display="none"}),J=xt(b,()=>m()),m()}U();function wt(a){!F.some(w=>w.testNumber===a)||a===f||(f=a,K.value=String(a),U())}return{card:b,setTest:wt,destroy:()=>J?.disconnect()}}
+import{buildTestHistogramData as Ht,buildTestHistogramSeries as At}from"../../stats/histogram.js";import{CLR as lt}from"../toolbar.js";import{fmt as st}from"../../renderer/fmt.js";import{QUANTITY as Wt,categorical as Ct}from"./palette.js";import{cardShell as Et,observeResize as xt,makeTooltip as Pt,positionChartTooltip as bt,makeTestSelect as $t,makeWaferSelect as Bt,makeToggle as Rt,renderEmptyState as pt,chartFillHeight as yt,applyCanvasFlow as Mt,resolveChartCanvasColors as Tt,makeAxisFormat as vt,PADDING as tt}from"./chartShell.js";const mt=230,St=36,at=18;function kt(s,R,N,z,rt,I,b,u=4){const j=Math.max(1,I/u),F=Math.pow(10,Math.floor(Math.log10(j))),f=j/F,G=(f<=1?1:f<=2?2:f<=5?5:10)*F,$=z-N;s.save(),s.font="10px system-ui, sans-serif",s.textAlign="right",s.textBaseline="middle";for(let K=0;K<=I+1e-9;K+=G){const _=z-K/(I||1)*$;s.strokeStyle=b.grid,s.lineWidth=1,s.beginPath(),s.moveTo(R,_),s.lineTo(R+rt,_),s.stroke(),s.fillStyle=b.text,s.fillText(String(Math.round(K)),R-4,_)}s.strokeStyle=b.axis,s.lineWidth=1,s.beginPath(),s.moveTo(R,N),s.lineTo(R,z),s.stroke(),s.restore()}export function renderHistogramPanel(s){const{title:R="Test value distribution",items:N,testDefs:z,onSaveImage:rt,groups:I}=s,{card:b,body:u,controlsRow:j}=Et(R,rt),F=z.filter(a=>a.testNumber!==void 0);let f=s.selectedTestNumber??F[0]?.testNumber??null,G=null,$=!1;const K=$t(F,f,a=>{f=a,U()},{maxWidth:"200px"});j.appendChild(K);const _=Bt(N,G,a=>{G=a,U()});j.appendChild(_),j.appendChild(Rt("Axis includes limits",$,a=>{$=a,U()}));const A=Pt(b);let J=null,y=null;function et(a){const w=z.find(O=>O.testNumber===a);return{unit:w?.unit,limitLow:w?.limitLow,limitHigh:w?.limitHigh}}function U(){if(J?.disconnect(),J=null,u.innerHTML="",f===null){pt(u,"No parametric test data available for a histogram.");return}const a=I&&I.length>0?At(I,f,16,$?et(f).limitLow:void 0,$?et(f).limitHigh:void 0):null;if(_.style.display=a?"none":"",a){if(a.series.length===0){pt(u,"No parametric test data available for a histogram.");return}Lt(a);return}const w=G!==null?[N[G]]:N,{unit:O,limitLow:nt,limitHigh:x}=et(f),i=Ht(w,f,16,$?nt:void 0,$?x:void 0);if(i.length===0){pt(u,"No parametric test data available for a histogram.");return}const D=Math.max(...i.map(p=>p.count),1),P=document.createElement("div");Object.assign(P.style,{fontSize:"12px",color:lt.label,marginBottom:"2px"}),P.textContent=`max ${D} dies/bucket`,u.appendChild(P);const h=document.createElement("canvas");h.style.display="block",h.style.cursor="default",u.appendChild(h);let v=-1;const g=window.devicePixelRatio||1,B=i[0].rangeLow,X=i[i.length-1].rangeHigh,ot=X-B||1,Z=vt(Math.max(Math.abs(B),Math.abs(X)),O);function Y(p){const m=tt+36,e=h.clientWidth-m-tt,n=p-St-at;return{plotX:m,plotMaxWidth:Math.max(10,e),plotMaxHeight:n,plotTop:at}}function ct(p){const{plotX:m,plotMaxWidth:e}=Y(mt);if(p<m||p>m+e)return-1;const n=Math.floor((p-m)/e*i.length);return n>=0&&n<i.length?n:-1}function H(){Mt(h,P.offsetHeight);const p=u.clientWidth,m=yt(b,u,h,mt);h.width=Math.max(1,Math.floor(p*g)),h.height=Math.max(1,Math.floor(m*g)),h.style.width=`${p}px`,h.style.height=`${m}px`;const e=h.getContext("2d");e.setTransform(g,0,0,g,0,0),e.clearRect(0,0,p,m),e.font="11px system-ui, sans-serif";const n=Tt(b),{plotX:c,plotMaxWidth:t,plotMaxHeight:d,plotTop:o}=Y(m),l=o+d,S=t/i.length;kt(e,c,o,l,t,D,{text:n.textMuted,axis:n.border,grid:n.border}),i.forEach((M,C)=>{const k=M.count/D*d,r=c+C*S,L=l-k;e.fillStyle=C===v?n.text:Wt,e.globalAlpha=C===v?1:.7,e.fillRect(r+1,L,Math.max(1,S-2),k),e.globalAlpha=1,C===v&&(e.fillStyle=n.text,e.textAlign="center",e.textBaseline="bottom",e.fillText(`${M.count}`,r+S/2,L-2))});const V=M=>c+(M-B)/ot*t;e.font="10px system-ui, sans-serif";for(const[M,C]of[[nt,"LSL"],[x,"USL"]]){if(M===void 0)continue;const k=V(M);e.strokeStyle=n.warnBorder,e.setLineDash([3,3]),e.lineWidth=1,e.beginPath(),e.moveTo(k,o),e.lineTo(k,l),e.stroke(),e.setLineDash([]),e.fillStyle=n.warnBorder,e.textAlign="center",e.textBaseline="bottom",e.fillText(C,k,o-2)}e.font="11px system-ui, sans-serif",e.strokeStyle=n.border,e.lineWidth=1,e.beginPath(),e.moveTo(c,l),e.lineTo(c+t,l),e.stroke(),e.fillStyle=n.textMuted,e.textAlign="center",e.textBaseline="top";const W=Math.max(2,Math.floor(t/44)),dt=Math.ceil(i.length/W),ht=Math.max(1,dt);for(let M=0;M<=i.length;M+=ht){const C=M<i.length?i[M].rangeLow:i[i.length-1].rangeHigh,k=c+M*S;e.beginPath(),e.moveTo(k,l),e.lineTo(k,l+4),e.stroke(),e.fillText(Z.tick(C),k,l+6)}Z.unitLabel&&(e.save(),e.font="10px system-ui, sans-serif",e.fillStyle=n.textMuted,e.textAlign="right",e.textBaseline="top",e.fillText(`(${Z.unitLabel})`,c+t,l+20),e.restore())}h.addEventListener("mousemove",p=>{const m=h.getBoundingClientRect(),e=ct(p.clientX-m.left);if(e!==v&&(v=e,H()),e>=0){const n=i[e];A.innerHTML=`<strong>${st(n.rangeLow,O,"engineering")} \u2013 ${st(n.rangeHigh,O,"engineering")}</strong><br>${n.count} dies`,A.style.display="block",bt(A,b,p.clientX,p.clientY)}else A.style.display="none"}),h.addEventListener("mouseleave",()=>{v!==-1&&(v=-1,H()),A.style.display="none"}),J=xt(b,()=>H()),H()}function Lt(a){const{unit:w,limitLow:O,limitHigh:nt}=et(f),x=a.ranges,i=a.series,D=Ct;y&&!i.some(n=>n.groupKey===y)&&(y=null);const P=Math.max(1,...i.flatMap(n=>n.counts)),h=document.createElement("div");Object.assign(h.style,{fontSize:"12px",color:lt.label,marginBottom:"2px"}),h.textContent=`${i.length} groups \xB7 max ${P} dies/bucket`,u.appendChild(h);const v=document.createElement("div");Object.assign(v.style,{display:"flex",flexWrap:"wrap",gap:"4px 12px",marginBottom:"4px"}),i.forEach((n,c)=>{const t=document.createElement("button");t.type="button",t.title=`${n.groupKey} \u2014 click to emphasize (dim the rest)`,Object.assign(t.style,{display:"inline-flex",alignItems:"center",gap:"5px",fontSize:"11px",padding:"1px 4px",border:"none",background:"none",cursor:"pointer",color:lt.text,borderRadius:"3px"});const d=document.createElement("span");Object.assign(d.style,{width:"10px",height:"10px",borderRadius:"2px",background:D(c),flex:"0 0 auto"});const o=document.createElement("span");o.textContent=n.groupKey,t.append(d,o);const l=y!==null&&y!==n.groupKey;t.style.opacity=l?"0.45":"1",y===n.groupKey&&(t.style.background=lt.bgHover),t.setAttribute("aria-pressed",y===n.groupKey?"true":"false"),t.addEventListener("click",()=>{y=y===n.groupKey?null:n.groupKey,U()}),v.appendChild(t)}),u.appendChild(v);const g=document.createElement("canvas");g.style.display="block",g.style.cursor="default",u.appendChild(g);const B=window.devicePixelRatio||1,X=x[0].rangeLow,ot=x[x.length-1].rangeHigh,Z=ot-X||1,Y=vt(Math.max(Math.abs(X),Math.abs(ot)),w),ct=()=>h.offsetHeight+v.offsetHeight;let H=-1,p={plotX:tt+36,plotMaxWidth:10,barWidth:10};function m(){Mt(g,ct());const n=u.clientWidth,c=yt(b,u,g,mt);g.width=Math.max(1,Math.floor(n*B)),g.height=Math.max(1,Math.floor(c*B)),g.style.width=`${n}px`,g.style.height=`${c}px`;const t=g.getContext("2d");t.setTransform(B,0,0,B,0,0),t.clearRect(0,0,n,c),t.font="11px system-ui, sans-serif";const d=Tt(b),o=tt+36,l=Math.max(10,n-o-tt),S=at,V=c-St-at,T=S+V,W=l/x.length;p={plotX:o,plotMaxWidth:l,barWidth:W},kt(t,o,S,T,l,P,{text:d.textMuted,axis:d.border,grid:d.border}),H>=0&&(t.fillStyle=d.bgHover,t.globalAlpha=.5,t.fillRect(o+H*W,S,W,V),t.globalAlpha=1);const dt=i.map((r,L)=>({s:r,i:L})).sort((r,L)=>(r.s.groupKey===y?1:0)-(L.s.groupKey===y?1:0));for(const{s:r,i:L}of dt){const E=y===r.groupKey,ut=y!==null&&!E,ft=D(L);t.strokeStyle=ft,t.fillStyle=ft,t.lineWidth=E?2:1,t.globalAlpha=ut?.12:y?.32:.22,t.beginPath(),t.moveTo(o,T),r.counts.forEach((gt,it)=>{const Q=o+it*W,q=T-gt/P*V;t.lineTo(Q,q),t.lineTo(Q+W,q)}),t.lineTo(o+l,T),t.closePath(),t.fill(),t.globalAlpha=ut?.3:1,t.beginPath(),r.counts.forEach((gt,it)=>{const Q=o+it*W,q=T-gt/P*V;it===0?t.moveTo(Q,q):t.lineTo(Q,q),t.lineTo(Q+W,q)}),t.stroke()}t.globalAlpha=1;const ht=r=>o+(r-X)/Z*l;t.font="10px system-ui, sans-serif";for(const[r,L]of[[O,"LSL"],[nt,"USL"]]){if(r===void 0)continue;const E=ht(r);t.strokeStyle=d.warnBorder,t.setLineDash([3,3]),t.lineWidth=1,t.beginPath(),t.moveTo(E,S),t.lineTo(E,T),t.stroke(),t.setLineDash([]),t.fillStyle=d.warnBorder,t.textAlign="center",t.textBaseline="bottom",t.fillText(L,E,S-2)}t.font="11px system-ui, sans-serif",t.strokeStyle=d.border,t.lineWidth=1,t.beginPath(),t.moveTo(o,T),t.lineTo(o+l,T),t.stroke(),t.fillStyle=d.textMuted,t.textAlign="center",t.textBaseline="top";const C=Math.max(2,Math.floor(l/44)),k=Math.max(1,Math.ceil(x.length/C));for(let r=0;r<=x.length;r+=k){const L=r<x.length?x[r].rangeLow:x[x.length-1].rangeHigh,E=o+r*W;t.beginPath(),t.moveTo(E,T),t.lineTo(E,T+4),t.stroke(),t.fillText(Y.tick(L),E,T+6)}Y.unitLabel&&(t.save(),t.font="10px system-ui, sans-serif",t.fillStyle=d.textMuted,t.textAlign="right",t.textBaseline="top",t.fillText(`(${Y.unitLabel})`,o+l,T+20),t.restore())}function e(n){const{plotX:c,plotMaxWidth:t,barWidth:d}=p;if(n<c||n>c+t)return-1;const o=Math.floor((n-c)/d);return o>=0&&o<x.length?o:-1}g.addEventListener("mousemove",n=>{const c=g.getBoundingClientRect(),t=e(n.clientX-c.left);if(t!==H&&(H=t,m()),t>=0){const d=x[t],o=i.map((l,S)=>`<span style="display:inline-block;width:9px;height:9px;border-radius:2px;background:${D(S)};margin-right:5px;"></span>${l.groupKey}: ${l.counts[t]}`).join("<br>");A.innerHTML=`<strong>${st(d.rangeLow,w,"engineering")} \u2013 ${st(d.rangeHigh,w,"engineering")}</strong><br>${o}`,A.style.display="block",bt(A,b,n.clientX,n.clientY)}else A.style.display="none"}),g.addEventListener("mouseleave",()=>{H!==-1&&(H=-1,m()),A.style.display="none"}),J=xt(b,()=>m()),m()}U();function wt(a){!F.some(w=>w.testNumber===a)||a===f||(f=a,K.value=String(a),U())}return{card:b,setTest:wt,destroy:()=>J?.disconnect()}}

package/dist/packages/canvas-adapter/charts/scatter.js

@@ -1 +1 @@
-import{getColorScheme as ht}from"../../renderer/colorSchemes.js";import{categorical as gt}from"./palette.js";import{buildScatterData as bt,buildScatterDataGrouped as yt}from"../../stats/scatter.js";import{buildFacetTable as St}from"../../stats/facets.js";import{CLR as M}from"../toolbar.js";import{cardShell as Mt,observeResize as Tt,makeTooltip as wt,makeTestSelect as kt,makeWaferSelect as vt,chartFillHeight as Lt,applyCanvasFlow as Ct,drawAxisUnit as At,resolveChartCanvasColors as Bt,makeAxisFormat as nt}from"./chartShell.js";const s=52,Ot=16,i=16,Et=44;export function renderScatterPanel(j){const{title:ot="Test scatter",items:B,testDefs:_,colorScheme:it="default",onSaveImage:lt,groups:P}=j,{card:T,body:C,controlsRow:X}=Mt(ot,lt),R=_.filter(e=>e.testNumber!==void 0),b=!!(P&&P.length>0),Y=(P??[]).map(e=>e.key),at=new Map(Y.map((e,n)=>[e,n]));let m=j.xTestNumber??R[0]?.testNumber??null,f=j.yTestNumber??R[1]?.testNumber??m,O=null;const q=()=>O!==null?B[O]?[B[O]]:[]:B;function K(e,n,o){const c=document.createElement("label");Object.assign(c.style,{display:"inline-flex",alignItems:"center",gap:"4px",fontSize:"11px",color:M.label});const d=document.createElement("span");d.textContent=e;const p=kt(R,n,o,{maxWidth:"180px",emptyText:"No tests"});return c.append(d,p),{wrap:c,select:p}}const{wrap:st,select:rt}=K("X:",m,e=>{m=e,H()}),{wrap:ct,select:dt}=K("Y:",f,e=>{f=e,H()});X.append(st,ct),!b&&B.length>1&&X.appendChild(vt(B,O,e=>{O=e,H()}));const E=document.createElement("div");Object.assign(E.style,{color:M.warnText,background:M.warnBg,border:`1px solid ${M.warnBorder}`,borderRadius:"4px",padding:"4px 8px",fontSize:"11px",marginBottom:"4px",display:"none"}),T.insertBefore(E,C);function J(){const e=b?[]:St(q(),{facetableOnly:!0}).filter(n=>n.splittable).map(n=>n.label);e.length>0?(E.textContent=`\u26A0 Mixed ${e.join(", ")} across these points \u2014 trends here may be confounded (Simpson's paradox). Use Group by, or the Wafer picker, to narrow to a like-for-like set.`,E.style.display=""):E.style.display="none"}J();const D=document.createElement("div");D.textContent=b?"One point per die \xB7 coloured by group \xB7 click legend to filter":"One point per die across all wafers \xB7 coloured by hard bin \xB7 click legend to filter",Object.assign(D.style,{color:M.label,fontSize:"11px",marginBottom:"4px"}),T.insertBefore(D,C);const pt=ht(it),{forBin:mt}=pt,G=e=>b?e.group??"\u2014":String(e.hbin??0),Q=e=>b?gt(at.get(e)??0):mt(Number(e)),V=e=>b?e:e==="0"?"No bin data":`Bin ${e}`,g=new Set,A=document.createElement("div");Object.assign(A.style,{display:"flex",flexWrap:"wrap",gap:"4px",marginBottom:"6px"}),C.appendChild(A);const u=document.createElement("canvas");u.style.display="block",u.style.cursor="crosshair",C.appendChild(u);const F=window.devicePixelRatio||1,Ht=wt(T);let h=[],w=0,I=1,k=0,N=1;function $(e){const n=_.find(o=>o.testNumber===e);return{unit:n?.unit,limitLow:n?.limitLow,limitHigh:n?.limitHigh}}function xt(){const e=C.clientWidth,n=Math.max(200,Math.min(400,e*.65)),o=Lt(T,C,u,n);return{w:e,h:o,plotW:Math.max(10,e-s-Ot),plotH:Math.max(10,o-i-Et)}}function Z(){for(const e of A.querySelectorAll("[data-cat]")){const n=e.dataset.cat,o=g.size===0||g.has(n);e.style.opacity=o?"1":"0.35",e.style.boxShadow=g.has(n)?`0 0 0 2px ${M.text}`:"none"}}function tt(e){A.innerHTML="",g.clear();for(const n of e){const o=document.createElement("button");o.type="button",o.dataset.cat=n,o.title=`${V(n)} \u2014 click to filter`;const c=Q(n);Object.assign(o.style,{display:"inline-flex",alignItems:"center",gap:"4px",padding:"2px 7px",borderRadius:"10px",border:`1px solid ${M.menuBorder}`,background:"none",cursor:"pointer",fontSize:"11px",color:M.text,whiteSpace:"nowrap"});const d=document.createElement("span");Object.assign(d.style,{display:"inline-block",width:"9px",height:"9px",borderRadius:"50%",background:c,flexShrink:"0"}),o.append(d,document.createTextNode(V(n))),o.addEventListener("click",()=>{g.has(n)?g.delete(n):g.add(n),Z(),z()}),A.appendChild(o)}Z()}function z(){Ct(u,A.offsetHeight);const e=Bt(T),n=I-w,o=N-k,{w:c,h:d,plotW:p,plotH:r}=xt();u.width=Math.max(1,Math.floor(c*F)),u.height=Math.max(1,Math.floor(d*F)),u.style.width=`${c}px`,u.style.height=`${d}px`;const t=u.getContext("2d");if(t.setTransform(F,0,0,F,0,0),t.clearRect(0,0,c,d),h.length===0){t.font="12px system-ui, sans-serif",t.fillStyle=e.textMuted,t.textAlign="center",t.textBaseline="middle",t.fillText("No data \u2014 select two parametric tests with values.",c/2,d/2);return}const y=4,v=nt(Math.max(Math.abs(w),Math.abs(I)),m!==null?$(m).unit:void 0),U=nt(Math.max(Math.abs(k),Math.abs(N)),f!==null?$(f).unit:void 0);t.font="10px system-ui, sans-serif",t.strokeStyle=e.border,t.lineWidth=.5,t.fillStyle=e.textMuted;for(let l=0;l<=y;l++){const S=w+n*l/y,a=s+l/y*p;t.beginPath(),t.moveTo(a,i),t.lineTo(a,i+r),t.stroke(),t.textAlign="center",t.textBaseline="top",t.fillText(v.tick(S),a,i+r+4);const L=k+o*l/y,x=i+(1-l/y)*r;t.beginPath(),t.moveTo(s,x),t.lineTo(s+p,x),t.stroke(),t.textAlign="right",t.textBaseline="middle",t.fillText(U.tick(L),s-4,x)}v.unitLabel&&At(t,v.unitLabel,s+p/2,i+r+24,e.textMuted),U.unitLabel&&(t.save(),t.font="10px system-ui, sans-serif",t.fillStyle=e.textMuted,t.textAlign="center",t.textBaseline="middle",t.translate(6,i+r/2),t.rotate(-Math.PI/2),t.fillText(`(${U.unitLabel})`,0,0),t.restore());const W=g.size===0?h:h.filter(l=>g.has(G(l))),et=W.length>5e3?Math.ceil(W.length/5e3):1;t.globalAlpha=Math.max(.15,Math.min(.7,200/(W.length/et)));for(let l=0;l<W.length;l+=et){const S=W[l],a=s+(S.x-w)/n*p,L=i+(1-(S.y-k)/o)*r;t.beginPath(),t.arc(a,L,2.5,0,Math.PI*2),t.fillStyle=Q(G(S)),t.fill()}if(t.globalAlpha=1,m!==null&&f!==null){const l=$(m),S=$(f);t.strokeStyle=e.textMuted,t.fillStyle=e.textMuted,t.lineWidth=1,t.setLineDash([4,3]),t.font="9px system-ui, sans-serif",t.textBaseline="top";for(const[a,L]of[[l.limitLow,"LSL"],[l.limitHigh,"USL"]]){if(a===void 0||a<w||a>I)continue;const x=s+(a-w)/n*p;t.beginPath(),t.moveTo(x,i),t.lineTo(x,i+r),t.stroke(),t.textAlign="left",t.fillText(L,x+2,i+2)}for(const[a,L]of[[S.limitLow,"LSL"],[S.limitHigh,"USL"]]){if(a===void 0||a<k||a>N)continue;const x=i+(1-(a-k)/o)*r;t.beginPath(),t.moveTo(s,x),t.lineTo(s+p,x),t.stroke(),t.textAlign="left",t.fillText(L,s+3,x+2)}t.setLineDash([])}t.strokeStyle=e.border,t.lineWidth=1,t.beginPath(),t.moveTo(s,i),t.lineTo(s,i+r),t.moveTo(s,i+r),t.lineTo(s+p,i+r),t.stroke()}function H(){if(J(),R.length<2||m===null||f===null){h=[],tt([]),z();return}h=b?yt(P,m,f):bt(q(),m,f);let e;if(b){const n=new Set(h.map(G));e=Y.filter(o=>n.has(o))}else e=Array.from(new Set(h.map(n=>n.hbin??0))).sort((n,o)=>n-o).map(String);if(tt(e),h.length>0){const n=h.map(v=>v.x),o=h.map(v=>v.y),c=Math.min(...n),d=Math.max(...n),p=Math.min(...o),r=Math.max(...o),t=(d-c)*.05||1,y=(r-p)*.05||1;w=c-t,I=d+t,k=p-y,N=r+y}z()}const ft=Tt(T,()=>z());H();function ut(e,n){m=e,f=n,rt.value=String(e),dt.value=String(n),H()}return{card:T,setXY:ut,destroy:()=>ft.disconnect()}}
+import{getColorScheme as ht}from"../../renderer/colorSchemes.js";import{categorical as gt}from"./palette.js";import{buildScatterData as bt,buildScatterDataGrouped as yt}from"../../stats/scatter.js";import{buildFacetTable as St}from"../../stats/facets.js";import{CLR as M}from"../toolbar.js";import{cardShell as Mt,observeResize as Tt,makeTooltip as wt,makeTestSelect as kt,makeWaferSelect as vt,chartFillHeight as Lt,applyCanvasFlow as Ct,drawAxisUnit as At,resolveChartCanvasColors as Bt,makeAxisFormat as nt}from"./chartShell.js";const r=52,Ot=16,l=16,Et=44;export function renderScatterPanel(j){const{title:ot="Test scatter",items:B,testDefs:_,colorScheme:it="default",onSaveImage:lt,groups:P}=j,{card:T,body:C,controlsRow:X}=Mt(ot,lt),R=_.filter(e=>e.testNumber!==void 0),b=!!(P&&P.length>0),Y=(P??[]).map(e=>e.key),at=new Map(Y.map((e,n)=>[e,n]));let m=j.xTestNumber??R[0]?.testNumber??null,f=j.yTestNumber??R[1]?.testNumber??m,O=null;const q=()=>O!==null?B[O]?[B[O]]:[]:B;function K(e,n,o){const i=document.createElement("label");Object.assign(i.style,{display:"inline-flex",alignItems:"center",gap:"4px",fontSize:"11px",color:M.label});const d=document.createElement("span");d.textContent=e;const p=kt(R,n,o,{maxWidth:"180px",emptyText:"No tests"});return i.append(d,p),{wrap:i,select:p}}const{wrap:st,select:rt}=K("X:",m,e=>{m=e,H()}),{wrap:ct,select:dt}=K("Y:",f,e=>{f=e,H()});X.append(st,ct),!b&&B.length>1&&X.appendChild(vt(B,O,e=>{O=e,H()}));const E=document.createElement("div");Object.assign(E.style,{color:M.warnText,background:M.warnBg,border:`1px solid ${M.warnBorder}`,borderRadius:"4px",padding:"4px 8px",fontSize:"11px",marginBottom:"4px",display:"none"}),T.insertBefore(E,C);function J(){const e=b?[]:St(q(),{facetableOnly:!0}).filter(n=>n.splittable).map(n=>n.label);e.length>0?(E.textContent=`\u26A0 Mixed ${e.join(", ")} across these points \u2014 trends here may be confounded (Simpson's paradox). Use Group by, or the Wafer picker, to narrow to a like-for-like set.`,E.style.display=""):E.style.display="none"}J();const D=document.createElement("div");D.textContent=b?"One point per die \xB7 coloured by group \xB7 click legend to filter":"One point per die across all wafers \xB7 coloured by hard bin \xB7 click legend to filter",Object.assign(D.style,{color:M.label,fontSize:"11px",marginBottom:"4px"}),T.insertBefore(D,C);const pt=ht(it),{forBin:mt}=pt,G=e=>b?e.group??"\u2014":String(e.hbin??0),Q=e=>b?gt(at.get(e)??0):mt(Number(e)),V=e=>b?e:e==="0"?"No bin data":`Bin ${e}`,g=new Set,A=document.createElement("div");Object.assign(A.style,{display:"flex",flexWrap:"wrap",gap:"4px",marginBottom:"6px"}),C.appendChild(A);const u=document.createElement("canvas");u.style.display="block",u.style.cursor="crosshair",C.appendChild(u);const F=window.devicePixelRatio||1,Ht=wt(T);let h=[],w=0,I=1,k=0,N=1;function $(e){const n=_.find(o=>o.testNumber===e);return{unit:n?.unit,limitLow:n?.limitLow,limitHigh:n?.limitHigh}}function xt(){const e=C.clientWidth,n=Math.max(200,Math.min(400,e*.65)),o=Lt(T,C,u,n);return{w:e,h:o,plotW:Math.max(10,e-r-Ot),plotH:Math.max(10,o-l-Et)}}function Z(){for(const e of A.querySelectorAll("[data-cat]")){const n=e.dataset.cat,o=g.size===0||g.has(n);e.style.opacity=o?"1":"0.35";const i=g.has(n);e.style.boxShadow=i?`0 0 0 2px ${M.text}`:"none",e.setAttribute("aria-pressed",i?"true":"false")}}function tt(e){A.innerHTML="",g.clear();for(const n of e){const o=document.createElement("button");o.type="button",o.dataset.cat=n,o.title=`${V(n)} \u2014 click to filter`;const i=Q(n);Object.assign(o.style,{display:"inline-flex",alignItems:"center",gap:"4px",padding:"2px 7px",borderRadius:"10px",border:`1px solid ${M.menuBorder}`,background:"none",cursor:"pointer",fontSize:"11px",color:M.text,whiteSpace:"nowrap"});const d=document.createElement("span");Object.assign(d.style,{display:"inline-block",width:"9px",height:"9px",borderRadius:"50%",background:i,flexShrink:"0"}),o.append(d,document.createTextNode(V(n))),o.addEventListener("click",()=>{g.has(n)?g.delete(n):g.add(n),Z(),z()}),A.appendChild(o)}Z()}function z(){Ct(u,A.offsetHeight);const e=Bt(T),n=I-w,o=N-k,{w:i,h:d,plotW:p,plotH:c}=xt();u.width=Math.max(1,Math.floor(i*F)),u.height=Math.max(1,Math.floor(d*F)),u.style.width=`${i}px`,u.style.height=`${d}px`;const t=u.getContext("2d");if(t.setTransform(F,0,0,F,0,0),t.clearRect(0,0,i,d),h.length===0){t.font="12px system-ui, sans-serif",t.fillStyle=e.textMuted,t.textAlign="center",t.textBaseline="middle",t.fillText("No data \u2014 select two parametric tests with values.",i/2,d/2);return}const y=4,v=nt(Math.max(Math.abs(w),Math.abs(I)),m!==null?$(m).unit:void 0),U=nt(Math.max(Math.abs(k),Math.abs(N)),f!==null?$(f).unit:void 0);t.font="10px system-ui, sans-serif",t.strokeStyle=e.border,t.lineWidth=.5,t.fillStyle=e.textMuted;for(let a=0;a<=y;a++){const S=w+n*a/y,s=r+a/y*p;t.beginPath(),t.moveTo(s,l),t.lineTo(s,l+c),t.stroke(),t.textAlign="center",t.textBaseline="top",t.fillText(v.tick(S),s,l+c+4);const L=k+o*a/y,x=l+(1-a/y)*c;t.beginPath(),t.moveTo(r,x),t.lineTo(r+p,x),t.stroke(),t.textAlign="right",t.textBaseline="middle",t.fillText(U.tick(L),r-4,x)}v.unitLabel&&At(t,v.unitLabel,r+p/2,l+c+24,e.textMuted),U.unitLabel&&(t.save(),t.font="10px system-ui, sans-serif",t.fillStyle=e.textMuted,t.textAlign="center",t.textBaseline="middle",t.translate(6,l+c/2),t.rotate(-Math.PI/2),t.fillText(`(${U.unitLabel})`,0,0),t.restore());const W=g.size===0?h:h.filter(a=>g.has(G(a))),et=W.length>5e3?Math.ceil(W.length/5e3):1;t.globalAlpha=Math.max(.15,Math.min(.7,200/(W.length/et)));for(let a=0;a<W.length;a+=et){const S=W[a],s=r+(S.x-w)/n*p,L=l+(1-(S.y-k)/o)*c;t.beginPath(),t.arc(s,L,2.5,0,Math.PI*2),t.fillStyle=Q(G(S)),t.fill()}if(t.globalAlpha=1,m!==null&&f!==null){const a=$(m),S=$(f);t.strokeStyle=e.textMuted,t.fillStyle=e.textMuted,t.lineWidth=1,t.setLineDash([4,3]),t.font="9px system-ui, sans-serif",t.textBaseline="top";for(const[s,L]of[[a.limitLow,"LSL"],[a.limitHigh,"USL"]]){if(s===void 0||s<w||s>I)continue;const x=r+(s-w)/n*p;t.beginPath(),t.moveTo(x,l),t.lineTo(x,l+c),t.stroke(),t.textAlign="left",t.fillText(L,x+2,l+2)}for(const[s,L]of[[S.limitLow,"LSL"],[S.limitHigh,"USL"]]){if(s===void 0||s<k||s>N)continue;const x=l+(1-(s-k)/o)*c;t.beginPath(),t.moveTo(r,x),t.lineTo(r+p,x),t.stroke(),t.textAlign="left",t.fillText(L,r+3,x+2)}t.setLineDash([])}t.strokeStyle=e.border,t.lineWidth=1,t.beginPath(),t.moveTo(r,l),t.lineTo(r,l+c),t.moveTo(r,l+c),t.lineTo(r+p,l+c),t.stroke()}function H(){if(J(),R.length<2||m===null||f===null){h=[],tt([]),z();return}h=b?yt(P,m,f):bt(q(),m,f);let e;if(b){const n=new Set(h.map(G));e=Y.filter(o=>n.has(o))}else e=Array.from(new Set(h.map(n=>n.hbin??0))).sort((n,o)=>n-o).map(String);if(tt(e),h.length>0){const n=h.map(v=>v.x),o=h.map(v=>v.y),i=Math.min(...n),d=Math.max(...n),p=Math.min(...o),c=Math.max(...o),t=(d-i)*.05||1,y=(c-p)*.05||1;w=i-t,I=d+t,k=p-y,N=c+y}z()}const ft=Tt(T,()=>z());H();function ut(e,n){m=e,f=n,rt.value=String(e),dt.value=String(n),H()}return{card:T,setXY:ut,destroy:()=>ft.disconnect()}}

package/dist/packages/canvas-adapter/dieList.d.ts

@@ -0,0 +1,41 @@
+import type { Die } from '../core/dies.js';
+import { type TestDef } from '../renderer/buildWaferMap.js';
+import { type SaveTextHandler } from './toolbar.js';
+export interface DieListOptions {
+    /** Heading text. Default: `Die list (N)`. */
+    title?: string;
+    /** Optional note shown under the heading, e.g. explaining why this replaced the map. */
+    note?: string;
+    /** CSV filename, including extension. Default: `'dies.csv'`. */
+    csvFilename?: string;
+    /** Host hook for "Export CSV" — see `saveTextFile` (toolbar.ts). */
+    onSaveText?: SaveTextHandler;
+    /**
+     * Extra leading column, e.g. a wafer-id label for a lot-level combined
+     * list spanning multiple wafers. `get(die)` returning `undefined` renders
+     * an empty cell for that row.
+     */
+    extraColumn?: {
+        label: string;
+        get: (die: Die) => string | undefined;
+    };
+    /**
+     * Cap the scrolling table at this CSS length instead of letting it fill.
+     *
+     * Default (omitted) is **fill**: the table grows to consume whatever height
+     * its container gives it (`flex: 1; min-height: 0`), which is what every
+     * in-library caller wants — a card overlay, a footer panel and a resizable
+     * modal all have a definite height, and a fixed cap left a short table
+     * floating in a half-empty box. In a container with NO definite height the
+     * table simply renders at its natural full length and the host page
+     * scrolls; set this if that isn't wanted (e.g. mounting a 10k-row list
+     * directly into a long document).
+     */
+    maxHeight?: string;
+}
+/**
+ * Build a scrollable die-list table + "Export CSV" button. Returns `null`
+ * when `dies` is empty (nothing to show).
+ */
+export declare function buildDieListSection(dies: Die[], testDefs: TestDef[] | undefined, options?: DieListOptions): HTMLDivElement | null;
+//# sourceMappingURL=dieList.d.ts.map

package/dist/packages/canvas-adapter/dieList.js

@@ -0,0 +1,2 @@
+import{hasPosition as S}from"../core/dies.js";import{isParametricTest as v}from"../renderer/buildWaferMap.js";import{CLR as r,saveTextFile as w}from"./toolbar.js";import{csvField as C}from"./summaryPanel.js";import{fmt as y}from"../renderer/fmt.js";function o(n,d,t){const l=document.createElement(n);return d&&Object.assign(l.style,d),t!==void 0&&(l.textContent=t),l}function B(n){return S(n)?`(${n.x}, ${n.y})`:"\u2014"}function $(n,d){if(d?.length)return d.filter(v);const t=new Map;for(const l of n)for(const a of Object.keys(l.testValues??{})){const s=Number(a);t.has(s)||t.set(s,{testNumber:s,name:`Test ${s}`})}return[...t.values()].sort((l,a)=>l.testNumber-a.testNumber)}export function buildDieListSection(n,d,t={}){if(!n.length)return null;const l=$(n,d),a=o("div",{display:"flex",flexDirection:"column",gap:"8px",flex:"1",minHeight:"0"}),s=o("div",{display:"flex",alignItems:"center",justifyContent:"space-between",flexShrink:"0"});s.appendChild(o("div",{fontSize:"10px",fontWeight:"700",letterSpacing:"0.06em",textTransform:"uppercase",color:r.label},t.title??`Die list (${n.length})`));const f=o("button",{fontSize:"11px",padding:"3px 8px",borderRadius:"4px",border:`1px solid ${r.menuBorder}`,background:r.menuBg,color:r.text,cursor:"pointer"},"Export CSV");f.type="button",s.appendChild(f),a.appendChild(s),t.note&&a.appendChild(o("div",{fontSize:"11px",color:r.label,lineHeight:"1.4",flexShrink:"0"},t.note));const m=o("div",{overflow:"auto",flex:"1",minHeight:"0",border:`1px solid ${r.menuBorder}`,borderRadius:"4px",...t.maxHeight?{maxHeight:t.maxHeight}:{}}),c=o("table",{width:"100%",borderCollapse:"collapse",fontSize:"11px"});c.setAttribute("aria-label",t.title??`Die list (${n.length} dies)`);const u=[...t.extraColumn?[{label:t.extraColumn.label,get:e=>t.extraColumn.get(e)??""}]:[],{label:"Position",get:B},{label:"Site",get:e=>e.siteNum!==void 0?String(e.siteNum):""},{label:"Hard bin",get:e=>e.hbin!==void 0?String(e.hbin):""},{label:"Soft bin",get:e=>e.sbin!==void 0?String(e.sbin):""},...l.map(e=>({label:e.name,get:i=>{const p=i.testValues?.[e.testNumber];if(p!==void 0)return y(p,e.unit);const g=i.testPass?.[e.testNumber];return g===void 0?"":g?"PASS":"FAIL"}}))],b=o("thead"),x=o("tr");for(const e of u){const i=o("th",{textAlign:"left",padding:"4px 8px",position:"sticky",top:"0",background:r.panelBg,color:r.label,fontWeight:"600",borderBottom:`1px solid ${r.menuBorder}`,whiteSpace:"nowrap"},e.label);i.scope="col",x.appendChild(i)}b.appendChild(x),c.appendChild(b);const h=o("tbody");for(const e of n){const i=o("tr");for(const p of u)i.appendChild(o("td",{padding:"3px 8px",color:r.text,borderBottom:`1px solid ${r.menuBorder}`,whiteSpace:"nowrap"},p.get(e)));h.appendChild(i)}return c.appendChild(h),m.appendChild(c),a.appendChild(m),f.addEventListener("click",()=>{const e=[u.map(i=>C(i.label)).join(",")];for(const i of n)e.push(u.map(p=>C(p.get(i))).join(","));w(e.join(`
+`),t.csvFilename??"dies.csv","text/csv",t.onSaveText)}),a}