@wafertools/wafermap 0.30.4 → 0.32.0

package/AGENTS.md

@@ -19,7 +19,7 @@ loudly over guessing.
 
 ### Entry points
 
-- `@wafertools/wafermap` — `buildWaferMap()`, geometry, `registerBinColorScheme()` / `registerValueColorScheme()`. Pure, no DOM, server-safe.
+- `@wafertools/wafermap` — `buildWaferMap()`, `registerBinColorScheme()` / `registerValueColorScheme()`. Pure, no DOM, server-safe.
 - `@wafertools/wafermap/render` — `renderWaferMap()`, `renderWaferGallery()`. Needs the DOM.
 - `@wafertools/wafermap/stats` — `analyzeWaferMap()`, `analyzeWaferLot()`. Pure analysis.
 - `@wafertools/wafermap/worker` — `createWafermapWorker()` for off-main-thread builds.
@@ -27,22 +27,13 @@ loudly over guessing.
 Default path: `buildWaferMap()` once when data loads, then `renderWaferMap()` for a
 single wafer or `renderWaferGallery()` for several.
 
-**The types still export a large deprecated surface that is removed in 0.31.0 — do not
-reach into it just because autocomplete offers it.** Four groups, all replaced by the
-default path above:
+**There is no low-level drawing pipeline, chart-data builder or region builder to reach
+for.** The library draws through the renderers, and every figure it shows (yield, bin
+counts, region yield, per-test statistics, capability) comes back from
+`analyzeWaferMap()` / `analyzeWaferLot()`.
 
-- the low-level drawing pipeline — `buildView()`, `toCanvas()`, `createWafer()`,
-  `generateDies()`, and the geometry and transform helpers around them;
-- the chart-data builders — `buildYieldData()`, `buildCorrelationMatrix()`,
-  `buildTestBoxplotData()` and the rest: these were the internals of the Insights tab,
-  which the renderers now mount for you (see below);
-- the region builders — `buildRingRegions()`, `buildQuadrantRegions()` and friends:
-  region yield comes back from `analyzeWaferMap()`;
-- per-die and per-colour helpers — `getDieTestValue()`, `buildHoverText()`,
-  `resolveBinColors()`, `getValueColorScheme()`, `valueToViridis()`.
-
-If the only way to do something is through one of these, that is a library gap worth
-reporting, not a pattern to build on.
+If the only way to do something is to rebuild one of those pieces, that is a library gap
+worth reporting, not a pattern to build on.
 
 ### Traps that produce silently wrong maps
 
@@ -54,12 +45,11 @@ reporting, not a pattern to build on.
   pre-multiply. The geometry inputs are `waferConfig` (type `WaferConfig`) and
   `dieConfig` (type `DieConfig`) — both optional, both inferred when omitted.
 - **Bins and test values must be numbers, and verdicts booleans.** Every parser —
-  CSV, JSON, a spreadsheet export — hands you `"1"`, and `"1"` is not pass bin 1: those
-  dies count as fails and the yield is wrong, while a test value left as text is not
-  plotted or analysed correctly. Convert with `Number()` at parse time. `buildWaferMap`
-  samples the input and reports `input-values-not-numbers` (severity `'error'`) rather
-  than coercing behind your back, so a build that "works" can still be wrong — read the
-  warnings.
+  CSV, JSON, a spreadsheet export — hands you `"1"`, and `"1"` is not pass bin 1.
+  `buildWaferMap` never converts them: each is treated as missing and reported as
+  `input-values-not-numbers` (severity `'error'`), so those dies have no bin or no value
+  and a build that "works" can be mostly empty — read the warnings. 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` — passing one there is a type error in
@@ -124,9 +114,8 @@ reporting, not a pattern to build on.
   `insights: { enabled: true }` and it mounts the chart suite (yield, bin pareto,
   boxplot, histogram, correlation, scatter, capability, and one card per
   `insights.sweeps` entry). `renderWaferGallery` takes the same option across a whole
-  lot. Supply or replace the analysis later with `setStatsSummary()`. Hand-building
-  those charts is what the deprecated chart-data builders were for, and they go in
-  0.31.0. Charting a selection or one wafer (right-click → histogram, capability,
+  lot. Supply or replace the analysis later with `setStatsSummary()`. There is no
+  chart-data API to hand-build them from. Charting a selection or one wafer (right-click → histogram, capability,
   sweeps) is built in too, with no wiring.
 - **A value computed from other tests is a derived test, not a host-side column.** Pass
   `derivedTests` (a `TestDef` plus an `expression`, e.g. `'abs(t[1020] - t[1010])'`) to
@@ -147,9 +136,9 @@ reporting, not a pattern to build on.
   but `'traffic'` and `'jet'` reads low = dark, high = light; if you draw your own
   colorbar or swatch, resolve the colour through `resolveValueColorFn(name, reversed)`
   so it cannot disagree with the dies.
-- `result.view` is internal. Use the promoted fields: `result.plotMode`,
-  `result.metadata`, `result.isLotStack`, `result.hbinDefs`, `result.sbinDefs`,
-  `result.testDefs`.
+- What a map was built with is on the result: `result.plotMode`, `result.metadata`,
+  `result.isLotStack`, `result.hbinDefs`, `result.sbinDefs`, `result.testDefs`. The renderers
+  read them; pass nothing again.
 - 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
@@ -190,9 +179,10 @@ it is handed, because it has no way to know which tests anyone will look at.
   `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.
+- **A Web Worker buys responsiveness, not speed.** `createWafermapWorker` moves a
+  result's test values to the page without copying them, but still copies the dies and the
+  input, so total time goes *up*. Use it when a build would otherwise visibly freeze the
+  page, not for small datasets.
 - **Capability, pass rates, region yield and the spatial-pattern label come back from
   the analysis** — `stats.capability` (with `computePerTestStats`), `stats.testSpecYield`,
   `stats.testFlagYield`, `stats.functionalYield`, `stats.regionYield` and

package/CHANGELOG.md

@@ -22,7 +22,271 @@ under `### Breaking`.
 
 ---
 
-## [Unreleased]
+## [0.32.0] — 2026-09-27
+
+### Breaking
+
+- **Input values of the wrong type are treated as missing.** A bin, site number or test value
+  that is not a number, or a pass/fail verdict that is not `true`/`false`, is left out of the
+  die — the same rule as a value outside the STDF V4 ranges — and still reported as
+  `input-values-not-numbers`. A die whose only bin was text therefore has no verdict rather
+  than a fail, which can change `yield` for such input. The input objects are not modified.
+- **Test values on dies from `buildWaferMap` are read-only snapshots.** A map holds test values and
+  verdicts as one column per test. `die.testValues` and `die.testPass` on a built die build a frozen
+  object from those columns on each read, keeping nothing on the die, so `die.testValues !==
+  die.testValues`. Assigning to either field throws a `TypeError`; changing a key of the frozen
+  object throws in strict-mode code and is ignored otherwise. Pass the values to `buildWaferMap`,
+  or copy the die with your own object (`{ ...die, testValues: mine }`). A spread, `structuredClone` or `JSON.stringify` of a built die
+  gives plain objects with the same values. A die no longer shares the input record's
+  `testValues`/`testPass` objects, so changing the input after the build does not change the map.
+  Dies a host builds itself keep ordinary objects.
+- **Pre-built `dies` get the same input checks as `results`.** Wrong-type and out-of-range
+  values are treated as missing, and a die whose coordinates STDF cannot store is kept as an
+  unpositioned die.
+- **`WaferMapResult.view` is removed.** It was marked `@internal`: the renderers build their own
+  draw list whenever they draw, so a result no longer carries one. Read the result's own fields
+  (`plotMode`, `metadata`, `isLotStack`, `hbinDefs`, `sbinDefs`, `testDefs`). This makes each
+  result smaller (about 86 bytes less per die) and roughly halves the copy the Web Worker makes of
+  a result. The internal `dataAxisFlip` field takes its place.
+
+### Changed
+
+- **The legend filters to several bins or metadata values at once.** Ctrl/Cmd+click on a legend
+  entry — the map's legend or the gallery's strip, where Ctrl/Cmd+Enter/Space works from the
+  keyboard — adds or removes a value; a plain click shows only that value, or clears the
+  filter when it is the only one shown. `highlightBin` accepts `number | number[]` and
+  `highlightMetadataValue` accepts `string | string[]`.
+- **A finding and the legend filter agree.** Clicking a finding about a bin filters the legend
+  to that bin, and one about yield or a test clears the filter — in a single map and in the
+  gallery alike. Changing the legend filter releases the finding, as changing the selection
+  does, including a selection made on a gallery card while a lot finding is active.
+- **Lot regional findings are tested on all wafers' data together.** A yield, bin,
+  functional pass-rate, limit-fail or test-value difference in a region is combined across
+  every wafer (Stouffer's Z over each wafer's own test, weighted by die count) and reported
+  with the wafer analysis's gates, redundancy collapse and opposite-region re-test, instead of
+  by counting wafers whose own analysis reported it — a pattern present on every wafer but
+  too faint on some to pass alone is the lot's pattern. The sentence gives the lot's figure
+  and "higher/lower on N/M wafers, all wafers' data combined", N counting the wafers whose
+  region differs in that direction; `stats.method` is `'stouffer-z'`. Clusters, edge arcs and
+  spatial-pattern labels are still counted by the wafers that report them. Lot findings keep
+  absorbed restatements in the list, marked by `absorbedIds`, as wafer findings do.
+- **Selected dies are shown by fading the rest of the map.** Every unselected die is faded
+  towards the map background and the selection is outlined, so selected dies keep their full
+  colour and it is clear which dies are selected whatever the selection's shape — a block, a
+  ring, an edge arc. A finding highlighted from the Summary panel, a gallery lot finding and
+  `setSelection` are drawn the same way. The fade and outline sit under the axes and legend.
+- **A map opens in select mode.** A drag draws a selection box; hold Space and drag, use the
+  arrow keys, or choose Pan in the toolbar to pan.
+- **Clicking the only selected die again clears the selection.** Clicking a die inside a
+  larger selection still selects just that die.
+- **Changing the selection on the map releases an active finding.** A click, box select,
+  right-click, Esc or `clearSelection` clears the Summary panel's active finding and its bin
+  highlight, so the panel never shows a finding the map no longer highlights.
+
+### Fixed
+
+- **Regional findings report patterns confined to one region.** A bin, limit-fail or
+  functional-fail rate that is zero in the rest of the wafer and raised in a region (a bin
+  found only at the edge) counts as the largest relative change for the effect gate and for
+  severity, for every region family: rings, quadrants, sectors, reticle positions and test
+  sites. On a lot whose wafers carry bin 2 only at the edge, the lot finding reads "seen on
+  8/8 wafers".
+- **Yield and functional pass-rate findings are judged by their failure rate.** The relative
+  effect of a pass rate is measured on its failures: yield 98% → 94% is failures 2% → 6%, and
+  reaches the same verdict as the bin rate of the same dies.
+- **A region is not reported as deviating only because another region deviates more.** A
+  finding opposite in direction to a stronger finding for the same variable and region family
+  must still hold when compared with the rest of the wafer without that region, so an edge
+  rich in a bin, a limit fail or high test values no longer makes the inner rings read as low
+  in it (or high in yield).
+- **The soft bin that restates yield is absorbed into the yield finding**, as the hard pass bin
+  is: the one soft bin every passing die carries and no failing die does.
+- **An edge ring made of scattered fails is classified as an edge ring.** The spatial-pattern
+  classifier recognises an edge ring from the failing dies' positions — most fails at the rim
+  and spread round at least 60% of it — when no connected group of fails is large enough to
+  judge shape by, and before the scratch rule, so a short run along the rim is not a scratch.
+  Against WM-811K: detection 86.4%, edge-ring recall 75% (precision 92%), scratch recall 24%.
+- **Lot spatial-pattern rows count related labels together and state the lot's figures.**
+  Edge-ring and edge-local wafers count as one edge pattern, and centre and donut as one,
+  naming each label's wafer count ("Spatial pattern: edge (edge-ring on 5, edge-local on 2) —
+  seen on 7/13 wafers"); the sentence gives the lot's count, not any one wafer's confidence or figures.
+  The gallery highlights each counted wafer's failing dies.
+- Findings, their severities and "seen on N wafers" counts can change.
+
+### Performance
+
+- **Insights no longer blocks while its test statistics are computed.** The Overview's Test Values
+  table is built in slices, showing "Computing test statistics…" until it is ready, and when the
+  gallery's summary panel is computing the same statistics at the time, the two share the one
+  calculation instead of each doing it.
+- **Gallery cards are drawn only when on screen.** A card below the fold keeps its map up to date
+  and is drawn as it scrolls into view. Printing and the gallery PNG draw every card first, so
+  both still show the whole gallery. On a 25-wafer, 266k-die lot, with 4 cards on screen:
+  switching to value mode takes 0.4 s in Chrome (was 1.1 s) and 0.5 s in WebKit (was 2.0 s);
+  the gallery opens in 1.8 s and 2.0 s.
+- **The gallery draws about twice as fast in WebKit** (the desktop app on Linux and macOS, and
+  Safari). Die fills and outlines are drawn as many small canvas paths rather than one per
+  colour, which WebKit rasterises far faster. On a 25-wafer, 266k-die lot the gallery opens in
+  4.0 s (was 7.0 s) and a switch to value or stacked mode takes 1.8–2.3 s (was 3.8–4.4 s).
+  Chrome draws identical pixels; in WebKit only anti-aliased edge pixels differ.
+- **The lot Summary report opens about five times faster on a large lot.** Its Test Values table
+  finds each test's minimum, mean and maximum in one pass instead of sorting every die's value.
+  On a 25-wafer, 266k-die lot the "Summary report" button takes 0.4 s in Chrome (was 6.0 s) and
+  0.9 s from click to report in WebKit (was 4.7 s). The report is unchanged (compared as HTML).
+  Boxplot quartiles and the histogram's outlier range are found the same way as the Summary
+  panel's, by selection, with the same figures.
+- **Test-value analysis (`enableTestValueAnalysis`) is two to three times faster on large lots.**
+  Spec-limit findings count each region's dies in one pass instead of re-reading every die for
+  every region, the test list is read column by column, and per-test statistics find their
+  quartiles by selection. Findings are unchanged (compared byte for byte on a 266k-die lot with
+  5,289 findings). On that lot: 18.9 s → 7.2 s in Chrome, 25.6 s → 10.7 s in WebKit.
+- **Analysis is about a third faster in Chrome on large lots.** Merging findings in adjacent
+  regions, pairing hard and soft bins that cover the same dies, and assigning dies to regions
+  now compare die positions as numbers rather than as a text key per die. Findings are
+  unchanged (compared byte for byte on a 266k-die lot). On that lot, load-time analysis takes
+  2.5 s in Chrome (was 3.7 s).
+- **Stacked modes and mode switches in the gallery are faster.** Stacked cards key die positions by
+  number rather than by a string per die, and a map no longer rebuilds a key for every die on
+  each redraw unless dies are selected. On a 25-wafer, 266k-die lot in Chrome: switching to
+  stacked bins 2.0 s → 1.6 s, to value mode 1.3 s → 1.1 s.
+- **The lot summary panel's test statistics are computed about three times faster.** The
+  quartiles of each test's pooled values are found by selection instead of sorting every value
+  (the same order statistics, so the same figures). On a 25-wafer, 266k-die lot the gallery
+  with its panel opens in 3.1 s in Chrome (was 3.9 s) and about 3.5 s in WebKit (was 4.0 s).
+- **Insights opens several times faster on a large lot** (25 wafers, 266k dies: the Overview
+  2.7 s → 0.65 s in Chrome, 0.9 s in WebKit). The Overview's Test Values table reuses the
+  pooled statistics the gallery's summary panel has already computed, whether or not the lot
+  has functional tests, and the pass-rate chart reads each die's values and recorded verdicts
+  in one pass per die.
+  Figures are unchanged.
+- **`analyzeWaferMap` is about five times faster on large wafers** (a 25-wafer, 266k-die lot:
+  32 s → 6.5 s in Chrome). Region membership, die keys and cluster neighbour lookups are each
+  computed once per analysis, not once per finding builder. Findings are unchanged.
+- **Faster building and analysis in WebKit** (the desktop app on Linux and macOS, and Safari).
+  Checks that asked whether a die holds any test data read the die's keys one at a time and stop
+  at the first; the coverage count checks bins before test data; input checking decides each
+  test number's legality once per wafer instead of once per die. On a 266k-die lot in WebKitGTK,
+  building fell from 2.5 s to 1.1 s and analysis from 14 s to 7 s. Results are unchanged.
+- **A hidden Summary panel is rendered when it is opened**, not on every mount and option
+  change. Every gallery card has one, so a large gallery mounts faster (266k-die lot: 7.3 s →
+  5.0 s) and switches plot mode faster (3.4 s → 1.4 s).
+- **Test values are held as one column per test**, not as an object on each die, so a map
+  holds a small fraction of the memory it did: on a 266k-die, 51-test lot in Chrome, about 330 MB
+  where it was 1.1 GB. A result from `createWafermapWorker` moves its columns to the page without
+  copying them.
+- **Die outlines are drawn as merged lines**, one per run of shared edges instead of four sides
+  per die. Galleries draw 10–17% faster in WebKit (the desktop app on Linux), where stroking each
+  die was most of the drawing time. Every outline is now the same weight in every browser: Chrome
+  drew the edge two dies share slightly darker than the wafer's outer edge, WebKit did not.
+
+### Added
+
+- **`HighlightWaferTarget.dieKeysByWafer`** — a lot regional finding names its region's dies
+  on each counted wafer, keyed by wafer index; the gallery highlights the region on every
+  counted card from it.
+
+- **`results` can be columns (`DieColumns`).** A host that already holds its results as columns
+  (a parser, Arrow, Parquet) passes one array per field and, for test values and verdicts, the
+  indices of the records that have one with their values. The map is built with no object per
+  record or die. Retests, derived tests, input checks and warnings behave exactly as for rows.
+  Missing entries are `NaN` or STDF's missing values (−32768 for coordinates, 65535 for bins and
+  sites). Mismatched lengths or out-of-range and repeated indices throw.
+
+---
+
+## [0.31.0] — 2026-09-25
+
+### Breaking
+
+- **The 74 deprecated exports are removed**: the 73 deprecated in 0.30.0 (the low-level drawing
+  pipeline, the chart-data builders, the region builders and the helpers exported by accident)
+  and `renderFindingsReportHtml`, deprecated in 0.30.3. Each named its replacement in a console
+  notice. [Upgrading](https://wafertools.github.io/wafermap/upgrading/) lists every name with
+  what to use instead; the main replacements:
+
+  | Removed | Use instead |
+  |---|---|
+  | `resolveBinColors`, `getBinColorScheme` | `binColorsForMaps(results)`, or `getBinColors()` on a map or gallery controller |
+  | `valueToViridis`, `valueToGreyscale`, `getValueColorScheme` | `resolveValueColorFn(name, reversed)` |
+  | `buildYieldData`, `buildYieldDataCombined` | `lotYieldSeries` on `analyzeWaferLot`'s result |
+  | `buildBinParetoData`, `buildBinClusterData` | `stats.hardBinCounts`, `stats.softBinCounts` |
+  | `buildCapabilityData`, `buildTestBoxplotData`, `buildTestTrendData`, `trendCentre` | `stats.capability`, `stats.perTestStats`, `perWaferTestStats` (with `computePerTestStats`) |
+  | `buildTestPassRateData`, `hasJudgeableTests`, `computeFunctionalYield` | `stats.testSpecYield`, `stats.testFlagYield`, `stats.functionalYield` |
+  | `buildRegionYieldData`, `buildRingRegions`, `buildQuadrantRegions`, `classifyDie`, `getRingLabel` | `stats.regionYield` |
+  | `classifyPattern` | `stats.spatialPattern` |
+  | `renderSummaryReportHtml`, `renderLotSummaryReportHtml`, `renderFindingsReportHtml` | `renderWaferReportHtml(result, summary?)`, `renderLotReportHtml(results)` |
+  | `openHtmlReport` | `openReportModal(html)`, `setReportOpener` |
+  | `createWafer`, `generateDies`, `clipDiesToWafer` | `buildWaferMap({ layout: true, waferConfig, dieConfig })` |
+  | `aggregateValues`, `aggregateBinCounts`, `getUniqueBins` | `buildWaferMap`'s `lotStack` |
+  | `STANDARD_WAFER_DIAMETERS_MM`, `resolveGridPitch` | `buildWaferMap`'s `standardDiameters`; each die's `width`/`height` |
+  | `getDieTestValue`, `isParametricTest`, `isPositionedDie`, `metadataCategoricalValue` | `die.testValues?.[n]`, `testType !== 'F'`, `hasPosition`, `metadataDisplayValue` |
+
+  `buildView`, `toCanvas`, `buildHoverText`, `buildMapTitle`, the transform and `affine*`
+  helpers, the histogram, scatter and correlation data builders, the sector, reticle and
+  test-site region builders, `parseRegionKey`, `contrastTextColor`, `dieHasTestData`,
+  `resolveMetadataColumns`, `discoverDieMetadataKeys`, `buildDieListSection` and
+  `DEFAULT_FACET_CURATION` have no public replacement: the renderers and the analysis do that
+  work themselves.
+- **63 types that belonged only to removed functions are removed with them**, among them the
+  chart-data types, the draw-list types (`View`, `ViewOptions`, `ViewRect` and the rest),
+  `PitchResult`, `ToCanvasResult`, `HitTarget`, `DieListOptions` and the geometry inputs
+  `WaferSpec`, `DieSpec` and `ReticleSpec`. Upgrading lists them all. `PlotMode` stays.
+- **`buildWaferMap` takes one argument.** The second (`WaferMapOptions`) set only the starting
+  `result.plotMode`, which the Web Worker never passed, so a build on and off the main thread
+  could start in different modes. Set the starting mode with `renderWaferMap`'s or
+  `renderWaferGallery`'s `viewOptions.plotMode`.
+- **`downloadFilename` is a prefix for every saved file**, on `renderWaferMap` and
+  `renderWaferGallery`: `<downloadFilename>_W05_hard-bin.png`, `<downloadFilename>_W05_die-list.csv`.
+  It applies to CSVs, charts, gallery cards and detached windows as well as the map's or gallery's
+  PNG, which it no longer names outright. Parts the prefix already names are not repeated. A host
+  that matched the exact name its `onSaveImage` receives should match on the prefix.
+- **Values outside the STDF V4 ranges are treated as missing.** 0.30.4 reported them with the
+  `input-values-outside-stdf` warning and used them as given; `buildWaferMap` now leaves them out,
+  and the warning says what it did:
+  - a bin outside 0–32767 or not a whole number: the die has no bin (so it is neither pass nor fail);
+  - a coordinate outside ±32767 or not a whole number: the die has no position, in either axis;
+  - a test number outside 0–4294967295: that test is left out of every die and of `testDefs`;
+  - a test value that is not finite: that value is left out;
+  - a site number outside 0–255: the die has no site;
+  - a `waferConfig.orientation` other than 0, 90, 180 or 270 (or an equivalent such as −90): the
+    map is built at 0. `WaferConfig.orientation` is typed `0 | 90 | 180 | 270`.
+
+  The caller's input objects are not modified. A derived test whose `testNumber` is outside
+  0–4294967295 is dropped with a `derived-test-invalid` warning.
+- **`WaferViewOptions.showPartialDies` and `isYieldEligibleDie`'s `includePartial` are removed.**
+  No map `buildWaferMap` builds has partial dies, so neither had anything to act on. A saved
+  preference that still carries `showPartialDies` is ignored. Partial dies a host supplies
+  itself are drawn in muted grey and always left out of yield.
+
+### Added
+
+- **Insights charts draw spec limits as well as test limits.** The boxplot, histogram,
+  wafer-to-wafer trend and scatter show a test's spec limits (`specLow`/`specHigh`, labelled
+  LSL/USL, long dashes) beside its test limits (Lo/Hi limit, short dashes). When a test has
+  both, a **Limits** choice (Test + spec, the default; Test limits; Spec limits; None) applies to
+  all four charts. Labels that would overlap move to a second row, **Axis includes limits**
+  covers every limit shown, and the scatter marks limits outside its plotted range at the edge,
+  as the other charts do. The wafer map still judges pass/fail by the test limits.
+- **Chart gridlines are lighter** (the border colour at 40% opacity), so the data and the limit
+  lines stand out from the grid in every theme. The scatter draws its limits in the same amber
+  as the other charts, and its limit labels sit on a panel-coloured backing where lines cross
+  them.
+
+### Changed
+
+- **The data-and-stats layer is ~49 KB gzipped**, from ~61 KB, with the removed exports gone.
+
+### Fixed
+
+- **Charts opened from a gallery card's right-click menu are saved under the card's lot and
+  wafer**, as they are from a single map.
+
+### Documentation
+
+- **New page, [Upgrading](https://wafertools.github.io/wafermap/upgrading/)**: what to change
+  for each breaking release, starting with 0.31.0.
+- **Every version has a GitHub release**, created when its tag is pushed, with that version's
+  changelog section as its notes.
 
 ## [0.30.4] — 2026-09-25
 

package/README.md

@@ -5,7 +5,7 @@
 [![CI and deploy](https://github.com/wafertools/wafermap/actions/workflows/deploy.yml/badge.svg)](https://github.com/wafertools/wafermap/actions/workflows/deploy.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)
-![bundle](https://img.shields.io/badge/data%20layer%20min%2Bgz-~61%20kB-blue)
+![bundle](https://img.shields.io/badge/data%20layer%20min%2Bgz-~50%20kB-blue)
 [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 
 <img src="docs/images/hero-test-values.png" alt="wafermap demo" style="max-width:640px; display:block; margin:8px 0;" />
@@ -13,7 +13,7 @@
 Browser-first wafer map visualization for semiconductor test data.
 
 **Zero runtime dependencies.** Pure ES modules with TypeScript types — works in React,
-Svelte, Vue, plain HTML, or a Web Worker. The DOM-free data-and-stats layer is ~61 kB
+Svelte, Vue, plain HTML, or a Web Worker. The DOM-free data-and-stats layer is ~50 kB
 min+gz; the interactive renderer is larger, and its chart suite and in-app guide are
 loaded on demand rather than shipped up front — [measured sizes](docs/performance.md).
 
@@ -75,7 +75,7 @@ export. Add `analyzeWaferMap` for the findings and summary panel, swap in
 
 The API reference is long because it documents every option, not because you need
 them: [tsmap](https://github.com/wafertools/tsmap), a complete cross-platform desktop
-application built on this library, imports **17** of its ~100 exports. Read the
+application built on this library, imports **16** of its ~100 exports. Read the
 [Quick Start](https://wafertools.github.io/wafermap/quickstart/) first and treat the
 [API reference](https://wafertools.github.io/wafermap/api/) as something to search,
 not to read.

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

@@ -1 +1 @@
-import{buildTestBoxplotData as nt}from"../../stats/boxplot.js";import{SPACE as Be,fontPx as Y,FONT as it,CLR as ot}from"../toolbar.js";import{fmt as he}from"../../renderer/fmt.js";import{fitTicks as lt}from"../../renderer/axisTicks.js";import{QUANTITY as He}from"./palette.js";import{cardShell as st,observeResize as at,makeTooltip as rt,positionChartTooltip as ct,makeBackButton as ft,makeLinkedTestSelect as ut,makeToggle as mt,makeLinkedAxisPrefs as dt,renderEmptyState as Re,fitRowsHeight as xt,setChartGrow as pt,resolveChartCanvasColors as ht,makeAxisFormat as De,horizontalTickSpacing as gt,resolveAxisRange as bt,shouldIncludeLimitsByDefault as Tt,drawOffAxisLimits as yt,limitLabelSide as wt,PADDING as M,VALUE_WIDTH as vt,WAFER_MENU_HINT as kt,prepareCanvas as Mt}from"./chartShell.js";import{escHtml as L,maxOf as Lt,minOf as Ct}from"../../core/utils.js";const C=24,A=5,We=110,At=12,Oe=20;export function renderBoxplotPanel(u){const{title:ee="Test value distribution",items:Ee,testDefs:ge,onSaveImage:Pe,groups:g,groupLabelText:te="group",onOpen:z}=u,_e=u.openActionLabel??"open that wafer",Ge=u.openActionLabel??"open this wafer",{card:a,heading:Ne,body:x,controlsRow:Q}=st(ee,Pe,u.ownerDocument);pt(a,"rows"),a.style.flex="0 0 auto",x.style.flex="0 0 auto",a.style.alignSelf="start";const ne=ge.filter(i=>i.testNumber!==void 0);let y=u.selectedTestNumber??ne[0]?.testNumber??null,ie=!1,U=0,b=null,R=null,oe=null,be=null;function Xe(){const i=!g||g.length===0?"":b??"\0overview";if(oe&&be===i)return oe;const p=!g||g.length===0?Ee:b!==null?g.find(h=>h.key===b)?.items??[]:g.map(h=>({label:h.key,dies:h.items.flatMap(f=>f.dies??[])}));return oe=p,be=i,p}function Te(){b!==null&&!R?(R=ft(()=>{ye(null),u.onGroupChange?.(null)},a.ownerDocument),Q.appendChild(R)):b===null&&R&&(R.remove(),R=null),Ne.textContent=b!==null?`${ee} \u2014 ${te}: ${b}`:ee}function ye(i){return b===i||i!==null&&!(g??[]).some(p=>p.key===i)?!1:(b=i,Te(),F(),$(),!0)}const we=ut(ne,y,i=>{y=i,$(),u.onTestChange?.(i)},{maxWidth:"240px",emptyText:"No parametric tests",ownerDocument:a.ownerDocument}),qe=we.el;Q.appendChild(qe),Q.appendChild(mt("Log scale",ie,i=>{ie=i,$()},a.ownerDocument));const le=a.ownerDocument.createElement("span");Object.assign(le.style,{display:"inline-flex",gap:Be.lg,alignItems:"center"}),Q.appendChild(le);const se=dt(le,u.axisPrefs,i=>{u.onAxisPrefsChange?.(i),$()},a.ownerDocument),ae=a.ownerDocument.createElement("div");Object.assign(ae.style,{color:ot.label,fontSize:it.body,marginBottom:Be.sm}),a.insertBefore(ae,x);function F(){const i=!!g&&g.length>0&&b===null,p=[];i?p.push(`click a ${te}'s box to see it by wafer`):z&&p.push(`click a box to ${_e}`);const h=p.length?`${p[0][0].toUpperCase()}${p[0].slice(1)} \xB7 `:"";ae.textContent=`${h}box = Q1\u2013Q3, line = median, whiskers = min/max \xB7 value shown is the median`+(U?` \xB7 axis clipped, ${U} value${U===1?"":"s"} outside`:"")}F(),Te();const D=rt(a);let re=null;function $(){const{includeLimits:i,clipOutliers:p}=se.get();if(F(),x.innerHTML="",ne.length===0||y===null){Re(x,"No parametric test data available for box plots.");return}const h=Xe(),f=nt(h,y),ce=ge.find(t=>t.testNumber===y),W=ce?.unit,V=ce?.limitLow,j=ce?.limitHigh;if(f.every(t=>t.count===0)){Re(x,"No parametric test data available for box plots.");return}const m=a.ownerDocument.createElement("canvas");m.style.display="block",m.style.cursor="default",x.appendChild(m);const ve=M*2+Math.min(f.length,At)*(C+A)+Oe;x.style.maxHeight=`${ve}px`,x.style.overflowY="auto",x.style.scrollbarGutter="stable";let P=-1;const fe=f.filter(t=>t.count>0),ke=Ct(fe.map(t=>t.min)),Me=Lt(fe.map(t=>t.max)),Le=i??Tt(ke,Me,V,j);se.sync(Le,V!==void 0||j!==void 0);const _=bt({dataMin:ke,dataMax:Me,limitLow:V,limitHigh:j,includeLimits:Le,clipOutliers:p,values:fe.flatMap(t=>[t.min,t.q1,t.median,t.q3,t.max])});U=_.clippedCount,F();const O=_.lo,K=_.hi,Qe=K-O||1,J=ie&&O>0,ue=J?Math.log10(O):0,Ce=(J?Math.log10(K):0)-ue||1,me=Math.max(Math.abs(O),Math.abs(K));function Ue(){const t=M+We,s=m.clientWidth-t-vt-M;return{plotX:t,plotMaxWidth:Math.max(10,s)}}function S(t,s,n){return J?s+(Math.log10(t)-ue)/Ce*n:s+(t-O)/Qe*n}function Fe(t,s){if(J){const d=[];for(let e=0;e<=4;e++)d.push(Math.pow(10,ue+Ce*e/4));return{ticks:d,axis:De(me,W)}}const n=lt(O,K,s,gt(t,me,W));return{ticks:n.ticks,axis:De(me,W,n.step||void 0)}}function Z(){const t=ht(a),s=M*2+f.length*(C+A)+Oe;x.style.maxHeight=`${xt(a,x,ve,s)}px`;const n=x.clientWidth,d=Mt(m,a,n,s);if(!d)return;const{ctx:e}=d;e.font=`${Y(-1)}px system-ui, sans-serif`,e.textBaseline="middle";const{plotX:l,plotMaxWidth:r}=Ue();f.forEach((o,T)=>{const v=M+T*(C+A),c=v+C/2;T===P&&(e.fillStyle=t.bgHover,e.fillRect(0,v-A/2,n,C+A)),e.fillStyle=t.text,e.textAlign="right";const Ke=o.label.length>16?`${o.label.slice(0,15)}\u2026`:o.label;if(e.fillText(Ke,M+We-8,c),o.count===0){e.fillStyle=t.textMuted,e.textAlign="left",e.fillText("no data",l,c);return}const Je=l+r,N=tt=>Math.min(Je,Math.max(l,tt)),$e=S(o.min,l,r),Se=S(o.max,l,r),I=N($e),X=N(S(o.q1,l,r)),Ie=N(S(o.median,l,r)),pe=N(S(o.q3,l,r)),B=N(Se),Ze=$e<I,et=Se>B,H=v+3,q=v+C-3;e.strokeStyle=t.textMuted,e.lineWidth=1,e.beginPath(),e.moveTo(I,c),e.lineTo(X,c),e.moveTo(pe,c),e.lineTo(B,c);const k=3;Ze?(e.moveTo(I+k,c-k),e.lineTo(I,c),e.lineTo(I+k,c+k)):(e.moveTo(I,H),e.lineTo(I,q)),et?(e.moveTo(B-k,c-k),e.lineTo(B,c),e.lineTo(B-k,c+k)):(e.moveTo(B,H),e.lineTo(B,q)),e.stroke(),e.fillStyle=He,e.globalAlpha=.35,e.fillRect(X,H,Math.max(1,pe-X),q-H),e.globalAlpha=1,e.strokeStyle=He,e.strokeRect(X,H,Math.max(1,pe-X),q-H),e.strokeStyle=t.text,e.lineWidth=2,e.beginPath(),e.moveTo(Ie,H),e.lineTo(Ie,q),e.stroke(),e.lineWidth=1,e.fillStyle=t.textMuted,e.textAlign="left",e.fillText(he(o.median,W,"engineering"),l+r+10,c)});const w=M+f.length*(C+A);e.font=`${Y(-1)}px system-ui, sans-serif`,yt(e,_.offAxis,{left:l,right:l+r,top:0,bottom:w},"horizontal",t.limitLine,o=>he(o,W,"engineering"));const Ve=new Set(_.offAxis.map(o=>o.value));for(const[o,T]of[[V,"Lo limit"],[j,"Hi limit"]]){if(o===void 0||Ve.has(o))continue;const v=S(o,l,r);e.strokeStyle=t.limitLine,e.setLineDash([3,3]),e.lineWidth=1,e.beginPath(),e.moveTo(v,0),e.lineTo(v,w),e.stroke(),e.setLineDash([]),e.fillStyle=t.limitLine;const c=wt(v,e.measureText(T).width,l,l+r,T==="Lo limit");e.textAlign=c<0?"right":"left",e.textBaseline="bottom",e.fillText(T,v+c*3,w-1)}e.font=`${Y(-1)}px system-ui, sans-serif`,e.strokeStyle=t.border,e.lineWidth=1,e.beginPath(),e.moveTo(l,w),e.lineTo(l+r,w),e.stroke(),e.fillStyle=t.textMuted,e.textAlign="center",e.textBaseline="top";const{ticks:je,axis:xe}=Fe(e,r);for(const o of je){const T=S(o,l,r);e.beginPath(),e.moveTo(T,w),e.lineTo(T,w+4),e.stroke(),e.fillText(xe.tick(o),T,w+6)}xe.unitLabel&&(e.textAlign="left",e.font=`${Y(-1)}px system-ui, sans-serif`,e.fillText(`(${xe.unitLabel})`,l+r+22,w+6),e.font=`${Y(-1)}px system-ui, sans-serif`),e.textBaseline="middle"}function de(t){const s=Math.floor((t-M+A/2)/(C+A));return s>=0&&s<f.length?s:-1}function G(t){return he(t,W,"engineering")}const E=!!g&&g.length>0&&b===null,Ae=t=>!E&&!!z&&h[t]?.waferIndex!==void 0;m.addEventListener("mousemove",t=>{const s=m.getBoundingClientRect(),n=de(t.clientY-s.top),d=n>=0&&f[n].count>0&&(E||Ae(n));if(n!==P&&(P=n,m.style.cursor=d?"pointer":"default",Z()),n>=0&&f[n].count>0){const e=f[n],l=E?`<br><em>click to see this ${L(te)} by wafer</em>`:Ae(n)?`<br><em>click to ${L(Ge)}</em>`:"",r=!E&&u.onWaferContextMenu&&h[n]?.waferIndex!==void 0?kt:"";D.innerHTML=`<strong>${L(e.label)}</strong> (${e.count} dies)<br>max ${L(G(e.max))}<br>q3 ${L(G(e.q3))}<br>median ${L(G(e.median))}<br>q1 ${L(G(e.q1))}<br>min ${L(G(e.min))}${l}${r}`,D.style.display="block",ct(D,a,t.clientX,t.clientY)}else D.style.display="none"}),m.addEventListener("mouseleave",()=>{P!==-1&&(P=-1,Z()),D.style.display="none"}),m.addEventListener("click",t=>{const s=m.getBoundingClientRect(),n=de(t.clientY-s.top);if(n===-1||f[n].count===0)return;if(E){const e=f[n].label;ye(e),u.onGroupChange?.(e);return}const d=h[n]?.waferIndex;z&&d!==void 0&&y!==null&&z(d,y)}),m.addEventListener("contextmenu",t=>{const s=m.getBoundingClientRect(),n=de(t.clientY-s.top),d=n===-1?void 0:h[n]?.waferIndex;E||d===void 0||!u.onWaferContextMenu||(D.style.display="none",u.onWaferContextMenu(d,y??void 0,t))}),re?.disconnect(),re=at(a,()=>Z()),Z()}$();function Ye(i){we.set(i)&&(y=i,$())}function ze(i){se.set(i)&&$()}return{card:a,setTest:Ye,setAxisPrefs:ze,destroy:()=>re?.disconnect()}}
+import{buildTestBoxplotData as rt}from"../../stats/boxplot.js";import{SPACE as He,fontPx as _,FONT as ct,CLR as ft}from"../toolbar.js";import{fmt as ge}from"../../renderer/fmt.js";import{fitTicks as ut}from"../../renderer/axisTicks.js";import{QUANTITY as De}from"./palette.js";import{cardShell as mt,observeResize as dt,makeTooltip as xt,positionChartTooltip as pt,makeBackButton as ht,makeLinkedTestSelect as gt,makeToggle as bt,makeLinkedAxisPrefs as yt,renderEmptyState as Ee,fitRowsHeight as Tt,setChartGrow as wt,resolveChartCanvasColors as vt,makeAxisFormat as Oe,horizontalTickSpacing as kt,resolveAxisRange as Mt,shouldIncludeLimitsByDefault as Lt,drawOffAxisLimits as Ct,limitLabelSide as At,limitLines as We,limitExtent as $t,hasBothLimitKinds as St,stackLabelRows as It,strokeLimitLine as Bt,PADDING as M,VALUE_WIDTH as Rt,WAFER_MENU_HINT as Ht,prepareCanvas as Dt}from"./chartShell.js";import{escHtml as L,maxOf as Et,minOf as Ot}from"../../core/utils.js";const C=24,A=5,Pe=110,Wt=12,_e=20;export function renderBoxplotPanel(u){const{title:te="Test value distribution",items:Ge,testDefs:be,onSaveImage:Ne,groups:g,groupLabelText:ne="group",onOpen:Q}=u,Xe=u.openActionLabel??"open that wafer",qe=u.openActionLabel??"open this wafer",{card:a,heading:Ye,body:x,controlsRow:U}=mt(te,Ne,u.ownerDocument);wt(a,"rows"),a.style.flex="0 0 auto",x.style.flex="0 0 auto",a.style.alignSelf="start";const oe=be.filter(i=>i.testNumber!==void 0);let T=u.selectedTestNumber??oe[0]?.testNumber??null,ie=!1,F=0,b=null,D=null,le=null,ye=null;function ze(){const i=!g||g.length===0?"":b??"\0overview";if(le&&ye===i)return le;const p=!g||g.length===0?Ge:b!==null?g.find(v=>v.key===b)?.items??[]:g.map(v=>({label:v.key,dies:v.items.flatMap(S=>S.dies??[])}));return le=p,ye=i,p}function Te(){b!==null&&!D?(D=ht(()=>{we(null),u.onGroupChange?.(null)},a.ownerDocument),U.appendChild(D)):b===null&&D&&(D.remove(),D=null),Ye.textContent=b!==null?`${te} \u2014 ${ne}: ${b}`:te}function we(i){return b===i||i!==null&&!(g??[]).some(p=>p.key===i)?!1:(b=i,Te(),V(),$(),!0)}const ve=gt(oe,T,i=>{T=i,$(),u.onTestChange?.(i)},{maxWidth:"240px",emptyText:"No parametric tests",ownerDocument:a.ownerDocument}),Qe=ve.el;U.appendChild(Qe),U.appendChild(bt("Log scale",ie,i=>{ie=i,$()},a.ownerDocument));const se=a.ownerDocument.createElement("span");Object.assign(se.style,{display:"inline-flex",gap:He.lg,alignItems:"center"}),U.appendChild(se);const ae=yt(se,u.axisPrefs,i=>{u.onAxisPrefsChange?.(i),$()},a.ownerDocument),re=a.ownerDocument.createElement("div");Object.assign(re.style,{color:ft.label,fontSize:ct.body,marginBottom:He.sm}),a.insertBefore(re,x);function V(){const i=!!g&&g.length>0&&b===null,p=[];i?p.push(`click a ${ne}'s box to see it by wafer`):Q&&p.push(`click a box to ${Xe}`);const v=p.length?`${p[0][0].toUpperCase()}${p[0].slice(1)} \xB7 `:"";re.textContent=`${v}box = Q1\u2013Q3, line = median, whiskers = min/max \xB7 value shown is the median`+(F?` \xB7 axis clipped, ${F} value${F===1?"":"s"} outside`:"")}V(),Te();const E=xt(a);let ce=null;function $(){const{includeLimits:i,clipOutliers:p,limits:v}=ae.get();if(V(),x.innerHTML="",oe.length===0||T===null){Ee(x,"No parametric test data available for box plots.");return}const S=ze(),h=rt(S,T),j=be.find(t=>t.testNumber===T),O=j?.unit,fe=We(j,v),{lo:Ve,hi:je}=$t(fe);if(h.every(t=>t.count===0)){Ee(x,"No parametric test data available for box plots.");return}const m=a.ownerDocument.createElement("canvas");m.style.display="block",m.style.cursor="default",x.appendChild(m);const ke=M*2+Math.min(h.length,Wt)*(C+A)+_e;x.style.maxHeight=`${ke}px`,x.style.overflowY="auto",x.style.scrollbarGutter="stable";let G=-1;const ue=h.filter(t=>t.count>0),Me=Ot(ue.map(t=>t.min)),Le=Et(ue.map(t=>t.max)),Ce=i??Lt(Me,Le,Ve,je);ae.sync(Ce,We(j).length>0,St(j));const N=Mt({dataMin:Me,dataMax:Le,limits:fe,includeLimits:Ce,clipOutliers:p,values:ue.flatMap(t=>[t.min,t.q1,t.median,t.q3,t.max])});F=N.clippedCount,V();const W=N.lo,K=N.hi,Ke=K-W||1,J=ie&&W>0,me=J?Math.log10(W):0,Ae=(J?Math.log10(K):0)-me||1,de=Math.max(Math.abs(W),Math.abs(K));function Je(){const t=M+Pe,s=m.clientWidth-t-Rt-M;return{plotX:t,plotMaxWidth:Math.max(10,s)}}function I(t,s,n){return J?s+(Math.log10(t)-me)/Ae*n:s+(t-W)/Ke*n}function Ze(t,s){if(J){const d=[];for(let e=0;e<=4;e++)d.push(Math.pow(10,me+Ae*e/4));return{ticks:d,axis:Oe(de,O)}}const n=ut(W,K,s,kt(t,de,O));return{ticks:n.ticks,axis:Oe(de,O,n.step||void 0)}}function Z(){const t=vt(a),s=M*2+h.length*(C+A)+_e;x.style.maxHeight=`${Tt(a,x,ke,s)}px`;const n=x.clientWidth,d=Dt(m,a,n,s);if(!d)return;const{ctx:e}=d;e.font=`${_(-1)}px system-ui, sans-serif`,e.textBaseline="middle";const{plotX:l,plotMaxWidth:c}=Je();h.forEach((o,f)=>{const y=M+f*(C+A),r=y+C/2;f===G&&(e.fillStyle=t.bgHover,e.fillRect(0,y-A/2,n,C+A)),e.fillStyle=t.text,e.textAlign="right";const ee=o.label.length>16?`${o.label.slice(0,15)}\u2026`:o.label;if(e.fillText(ee,M+Pe-8,r),o.count===0){e.fillStyle=t.textMuted,e.textAlign="left",e.fillText("no data",l,r);return}const it=l+c,q=at=>Math.min(it,Math.max(l,at)),Ie=I(o.min,l,c),Be=I(o.max,l,c),B=q(Ie),Y=q(I(o.q1,l,c)),Re=q(I(o.median,l,c)),he=q(I(o.q3,l,c)),R=q(Be),lt=Ie<B,st=Be>R,H=y+3,z=y+C-3;e.strokeStyle=t.textMuted,e.lineWidth=1,e.beginPath(),e.moveTo(B,r),e.lineTo(Y,r),e.moveTo(he,r),e.lineTo(R,r);const k=3;lt?(e.moveTo(B+k,r-k),e.lineTo(B,r),e.lineTo(B+k,r+k)):(e.moveTo(B,H),e.lineTo(B,z)),st?(e.moveTo(R-k,r-k),e.lineTo(R,r),e.lineTo(R-k,r+k)):(e.moveTo(R,H),e.lineTo(R,z)),e.stroke(),e.fillStyle=De,e.globalAlpha=.35,e.fillRect(Y,H,Math.max(1,he-Y),z-H),e.globalAlpha=1,e.strokeStyle=De,e.strokeRect(Y,H,Math.max(1,he-Y),z-H),e.strokeStyle=t.text,e.lineWidth=2,e.beginPath(),e.moveTo(Re,H),e.lineTo(Re,z),e.stroke(),e.lineWidth=1,e.fillStyle=t.textMuted,e.textAlign="left",e.fillText(ge(o.median,O,"engineering"),l+c+10,r)});const w=M+h.length*(C+A);e.font=`${_(-1)}px system-ui, sans-serif`,Ct(e,N.offAxis,{left:l,right:l+c,top:0,bottom:w},"horizontal",t.limitLine,o=>ge(o,O,"engineering"));const et=new Set(N.offAxis.map(o=>o.value)),Se=fe.filter(o=>!et.has(o.value)).map(o=>{const f=I(o.value,l,c),y=e.measureText(o.label).width,r=At(f,y,l,l+c,o.end==="lo"),ee=r<0?f-3-y:f+3;return{l:o,x:f,dir:r,start:ee,end:ee+y}}),tt=It(Se),nt=_(-1)+2;Se.forEach(({l:o,x:f,dir:y},r)=>{Bt(e,o,t.limitLine,f,0,f,w),e.fillStyle=t.limitLine,e.textAlign=y<0?"right":"left",e.textBaseline="bottom",e.fillText(o.label,f+y*3,w-1-tt[r]*nt)}),e.font=`${_(-1)}px system-ui, sans-serif`,e.strokeStyle=t.border,e.lineWidth=1,e.beginPath(),e.moveTo(l,w),e.lineTo(l+c,w),e.stroke(),e.fillStyle=t.textMuted,e.textAlign="center",e.textBaseline="top";const{ticks:ot,axis:pe}=Ze(e,c);for(const o of ot){const f=I(o,l,c);e.beginPath(),e.moveTo(f,w),e.lineTo(f,w+4),e.stroke(),e.fillText(pe.tick(o),f,w+6)}pe.unitLabel&&(e.textAlign="left",e.font=`${_(-1)}px system-ui, sans-serif`,e.fillText(`(${pe.unitLabel})`,l+c+22,w+6),e.font=`${_(-1)}px system-ui, sans-serif`),e.textBaseline="middle"}function xe(t){const s=Math.floor((t-M+A/2)/(C+A));return s>=0&&s<h.length?s:-1}function X(t){return ge(t,O,"engineering")}const P=!!g&&g.length>0&&b===null,$e=t=>!P&&!!Q&&S[t]?.waferIndex!==void 0;m.addEventListener("mousemove",t=>{const s=m.getBoundingClientRect(),n=xe(t.clientY-s.top),d=n>=0&&h[n].count>0&&(P||$e(n));if(n!==G&&(G=n,m.style.cursor=d?"pointer":"default",Z()),n>=0&&h[n].count>0){const e=h[n],l=P?`<br><em>click to see this ${L(ne)} by wafer</em>`:$e(n)?`<br><em>click to ${L(qe)}</em>`:"",c=!P&&u.onWaferContextMenu&&S[n]?.waferIndex!==void 0?Ht:"";E.innerHTML=`<strong>${L(e.label)}</strong> (${e.count} dies)<br>max ${L(X(e.max))}<br>q3 ${L(X(e.q3))}<br>median ${L(X(e.median))}<br>q1 ${L(X(e.q1))}<br>min ${L(X(e.min))}${l}${c}`,E.style.display="block",pt(E,a,t.clientX,t.clientY)}else E.style.display="none"}),m.addEventListener("mouseleave",()=>{G!==-1&&(G=-1,Z()),E.style.display="none"}),m.addEventListener("click",t=>{const s=m.getBoundingClientRect(),n=xe(t.clientY-s.top);if(n===-1||h[n].count===0)return;if(P){const e=h[n].label;we(e),u.onGroupChange?.(e);return}const d=S[n]?.waferIndex;Q&&d!==void 0&&T!==null&&Q(d,T)}),m.addEventListener("contextmenu",t=>{const s=m.getBoundingClientRect(),n=xe(t.clientY-s.top),d=n===-1?void 0:S[n]?.waferIndex;P||d===void 0||!u.onWaferContextMenu||(E.style.display="none",u.onWaferContextMenu(d,T??void 0,t))}),ce?.disconnect(),ce=dt(a,()=>Z()),Z()}$();function Ue(i){ve.set(i)&&(T=i,$())}function Fe(i){ae.set(i)&&$()}return{card:a,setTest:Ue,setAxisPrefs:Fe,destroy:()=>ce?.disconnect()}}

package/dist/packages/canvas-adapter/charts/chartShell.d.ts

@@ -43,7 +43,20 @@ export interface ChartCanvasColors {
      * limit line and its label need.
      */
     limitLine: string;
+    /**
+     * Gridlines: `border` at `GRID_ALPHA`. A gridline is a reading aid behind the
+     * data; drawn at full `border` strength (the axis colour) it competed with the
+     * points and with the limit lines, which in a theme with a strong border were
+     * hard to pick out from the grid at all.
+     */
+    grid: string;
 }
+/** Opacity of gridlines relative to the border colour. */
+export declare const GRID_ALPHA = 0.4;
+/** `color` at `alpha` × its own opacity. Understands the forms a computed
+ *  custom property holds — `#rgb`, `#rrggbb`, `#rrggbbaa`, `rgb()`, `rgba()` —
+ *  and returns anything else unchanged rather than guessing. */
+export declare function withAlpha(color: string, alpha: number): string;
 /** Resolve `--wmap-*` custom properties to concrete color strings for canvas
  *  drawing. Call once per draw (not cached) so a live theme change is picked
  *  up on the next redraw, matching `resolveCanvasTheme`'s own contract. */
@@ -349,6 +362,7 @@ export interface LinkedAxisPrefs {
     get(): {
         includeLimits: boolean | undefined;
         clipOutliers: boolean;
+        limits: LimitsShown;
     };
     /**
      * Rebuild the toggles for the state the panel has just RESOLVED.
@@ -356,9 +370,10 @@ export interface LinkedAxisPrefs {
      * Called from the redraw, because `includeLimits` is a tri-state: undefined
      * means "decide from the data" (`shouldIncludeLimitsByDefault`), and the
      * resolved answer is only known once the data range is. `hasLimits` decides
-     * whether the limits toggle is offered at all.
+     * whether the limits toggle is offered at all, and `hasBothKinds` whether the
+     * "Limits:" choice between test and spec limits is.
      */
-    sync(resolvedIncludeLimits: boolean, hasLimits: boolean): void;
+    sync(resolvedIncludeLimits: boolean, hasLimits: boolean, hasBothKinds?: boolean): void;
     /**
      * Adopt prefs chosen elsewhere. Returns false — changing nothing — when they
      * already match. Deliberately does NOT fire `onUserChange`, the same
@@ -490,7 +505,72 @@ export declare function positionChartTooltip(tooltip: HTMLElement, card: HTMLEle
 export interface AxisPrefs {
     includeLimits?: boolean;
     clipOutliers: boolean;
+    /** Which limits the charts draw. Undefined = `'both'`. */
+    limits?: LimitsShown;
 }
+export type LimitKind = 'test' | 'spec';
+/** The Insights "Limits" choice. */
+export type LimitsShown = 'test' | 'spec' | 'both' | 'none';
+export interface LimitLine {
+    value: number;
+    kind: LimitKind;
+    /** Which end of its pair: the low limit or the high one. */
+    end: 'lo' | 'hi';
+    label: string;
+}
+export declare const LIMIT_LABEL: Readonly<Record<LimitKind, {
+    lo: string;
+    hi: string;
+}>>;
+/** Canvas dash pattern per kind: short dashes for test limits, long for spec. */
+export declare const LIMIT_DASH: Readonly<Record<LimitKind, number[]>>;
+export declare const LIMITS_SHOWN_OPTIONS: ReadonlyArray<{
+    value: LimitsShown;
+    label: string;
+}>;
+type LimitSource = {
+    limitLow?: number;
+    limitHigh?: number;
+    specLow?: number;
+    specHigh?: number;
+} | undefined;
+/** Whether a test has both kinds of limit — the only case with a choice to make. */
+export declare function hasBothLimitKinds(def: LimitSource): boolean;
+/**
+ * The limit lines to draw for a test.
+ *
+ * `'none'` draws nothing. Otherwise the chosen kinds are drawn — and when the
+ * test has none of the chosen kind but does have the other, the other is drawn
+ * rather than nothing: a test with only test limits must not look unlimited
+ * because another test's spec limits were chosen. Each line carries its own
+ * label, so which kind is on screen is never in doubt.
+ */
+export declare function limitLines(def: LimitSource, shown?: LimitsShown): LimitLine[];
+/** The span the lines cover, for axis-range decisions. */
+export declare function limitExtent(lines: readonly LimitLine[]): {
+    lo?: number;
+    hi?: number;
+};
+/**
+ * Stack labels into rows so none overlaps another in the same row. Each label
+ * is an interval along the axis it is placed on; returns a row index per label
+ * (0 = the chart's usual label position), in input order. Greedy by position,
+ * so it is stable: labels that never collide all stay on row 0.
+ */
+export declare function stackLabelRows(spans: ReadonlyArray<{
+    start: number;
+    end: number;
+}>, gap?: number): number[];
+/**
+ * `fillText` on a backing of `halo` (the panel colour), so a label stays
+ * readable where a gridline, a limit line or data runs under it. Uses the
+ * current font, alignment and baseline; `halo` undefined draws plain text.
+ */
+export declare function fillTextOnHalo(ctx: CanvasRenderingContext2D, text: string, x: number, y: number, halo?: string): void;
+/** Stroke one limit line in its kind's dash pattern. */
+export declare function strokeLimitLine(ctx: CanvasRenderingContext2D, line: LimitLine, color: string, x0: number, y0: number, x1: number, y1: number): void;
+/** The "Limits:" dropdown, offered only where a test has both kinds. */
+export declare function makeLimitsSelect(current: LimitsShown, onChange: (v: LimitsShown) => void, ownerDocument?: Document): HTMLLabelElement;
 /** Robust outlier fence over a value list: Tukey's `Q1 − k·IQR … Q3 + k·IQR`.
  *
  *  Deliberately NOT mean ± 3σ. σ is computed FROM the data including the
@@ -524,7 +604,7 @@ export interface AxisRange {
      *  is merely off-screen is indistinguishable from a test having no limit. */
     offAxis: Array<{
         value: number;
-        label: 'Lo limit' | 'Hi limit';
+        label: string;
         side: 'lo' | 'hi';
     }>;
     /** Values excluded by the robust fence, when clipping is on. */
@@ -542,8 +622,8 @@ export interface AxisRange {
 export declare function resolveAxisRange(opts: {
     dataMin: number;
     dataMax: number;
-    limitLow?: number;
-    limitHigh?: number;
+    /** The limit lines the chart draws (`limitLines`). */
+    limits?: readonly LimitLine[];
     includeLimits: boolean;
     clipOutliers?: boolean;
     /** Raw values, needed only when `clipOutliers` is set. */
@@ -580,5 +660,8 @@ export declare function drawOffAxisLimits(ctx: CanvasRenderingContext2D, offAxis
     right: number;
     top: number;
     bottom: number;
-}, orient: 'horizontal' | 'vertical', color: string, format: (v: number) => string): void;
+}, orient: 'horizontal' | 'vertical', color: string, format: (v: number) => string, 
+/** Panel colour to back each marker with (`fillTextOnHalo`), for charts
+ *  where lines can run under the markers. */
+halo?: string): void;
 //# sourceMappingURL=chartShell.d.ts.map