wafermap 0.30.0: 78 exports deprecated, removed in 0.31.0

[telecasterer]

wafermap 0.30.0 deprecates 78 exports that are probably never used. They still work in 0.30.0 and will be removed in 0.31.0. This is the first time wafermap has given notice before removing something, and it's how removals will be handled from here.

What's affected

• The low-level drawing pipeline: buildView, toCanvas, createWafer,
  generateDies and related functions. Use renderWaferMap or
  renderWaferGallery instead.
• The chart-data builders (buildYieldData, buildTestBoxplotData and so on),
  which the Insights tab now draws for you.
• valueToViridis, valueToGreyscale and getValueColorScheme. Use
  resolveValueColorFn.
• Helpers that were exported by accident, such as the region and report
  builders.

How to tell whether you're affected
Each deprecated function logs one console notice the first time you call it,
naming what to use instead. Editors show deprecated names struck through.

If you need one that has no replacement, say so in this thread or open an
issue before 0.31.0.

0.30.0 also contains breaking changes that did not get a deprecation release.
The main one: the passBins options on the analysis and render functions are
removed. Set pass bins once on buildWaferMap; everything downstream uses
them.

Full list: https://github.com/wafertools/wafermap/blob/main/CHANGELOG.md#0300--2026-09-15
What's New: https://wafertools.github.io/whats-new/#2026-09-15-a-bin-keeps-its-colour-in-every-lot-your-pass-bins-count-everywhere-tsmap-works-offline

[telecasterer]

Update for 0.30.1: five of the 78 are staying.

On review, these are each the only supported way to do something an app needs, so they are no longer deprecated and no longer log a notice:

• visibleFindings, the one rule for collapsing restated findings (summary.findings is deliberately uncollapsed)
• openReportModal, to show a report when your app has installed its own setReportOpener
• metadataDisplayValue, the one rule for how a metadata value reads in an export
• getReticleCell, the only source of a die's reticle cell outside the tooltip
• renderFindingsReportHtml, which takes a summary alone and so can't be given inconsistent inputs

The other 73 are still removed in 0.31.0, and 0.30.1 adds replacements for the ones that had none:

• Capability, pass rates and region yield: analyzeWaferMap and analyzeWaferLot now return stats.capability (Cp/Cpk/Pp/Ppk), stats.testFlagYield and stats.regionYield. These replace buildCapabilityData, buildTestPassRateData and buildRegionYieldData.
• Spatial pattern: stats.spatialPattern replaces a direct classifyPattern call.
• Reports: renderWaferReportHtml(result, summary?) and renderLotReportHtml(results) replace renderSummaryReportHtml and renderLotSummaryReportHtml.
• Bin colours: binColorsForMaps(results), plus getBinColors() on both controllers, replace resolveBinColors and getBinColorScheme.
• Layout without data: buildWaferMap({ layout: true, waferConfig, dieConfig }) replaces createWafer + generateDies + clipDiesToWafer.

Every remaining console notice now names what to use instead, or says plainly that there is no replacement.

One new deprecation: downloadFilename is not being removed, but in 0.31.0 it becomes a prefix for the generated file names (LOT123_W05_hard-bin.png) rather than the whole name. If you rely on setting the whole name, please say so here.

closeSummaryPanel() and GalleryController.setColumns(), which 0.30.0 removed without notice, are back.

Changelog: https://github.com/wafertools/wafermap/blob/main/CHANGELOG.md#0301--2026-09-16
What's New: https://wafertools.github.io/whats-new/#2026-09-17-a-security-fix-exports-named-for-their-data-choosing-a-test-on-a-phone

[telecasterer]

0.31.0 is out: the deprecated exports are removed.

74 exports are gone: the 73 still deprecated after 0.30.1, plus renderFindingsReportHtml. That one was among the five kept in 0.30.1, and 0.30.3 deprecated it again: renderWaferReportHtml and renderLotReportHtml now carry the same findings table, together with the population and yield it was drawn from. The other four (visibleFindings, openReportModal, metadataDisplayValue, getReticleCell) stay.

Upgrading: the Upgrading page lists every removed name with what to use instead. If your app ran on 0.30.x with no deprecation notices in the console, none of the removals affect it.

Also in 0.31.0:

• downloadFilename is now a prefix for every saved file (<downloadFilename>_W05_hard-bin.png, <downloadFilename>_W05_die-list.csv), as announced in 0.30.1.
• Values outside the STDF V4 ranges (bins, coordinates, test and site numbers, results that aren't finite numbers) are treated as missing, as 0.30.4's input-values-outside-stdf warning announced. waferConfig.orientation accepts 0, 90, 180 or 270.
• A few things are removed without a deprecation release, because each had no effect or duplicated another setting:
  • buildWaferMap's second argument: set the starting plot mode with the renderers' viewOptions.plotMode.
  • showPartialDies and includePartial: no map buildWaferMap builds contains partial dies.
  • The View* type exports, which described an internal structure.

Changelog: https://github.com/wafertools/wafermap/blob/main/CHANGELOG.md#0310--2026-09-25
What's New: https://wafertools.github.io/whats-new/#2026-09-25-spec-limits-on-the-charts-files-in-different-units-combine-and-a-slimmer-api