@wafertools/wafermap 0.29.0 → 0.30.1

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

@@ -72,7 +72,7 @@ export const USER_GUIDE_HTML=`<div class="wmap-guide">
   .wmap-guide-toc{display:none!important}
 }
 </style>
-<h1 id="wafer-map-user-guide">Wafer Map \u2014 User Guide<span class="wmap-guide-version" title="Built 2026-09-12T08:32:38.570Z">v0.29.0</span></h1>
+<h1 id="wafer-map-user-guide">Wafer Map \u2014 User Guide<span class="wmap-guide-version" title="Built 2026-09-17T07:11:09.912Z">v0.30.1</span></h1>
 <p class="wmap-guide-online-link">This is a quick reference. <a href="https://wafertools.github.io/wafermap/user-guide/" target="_blank" rel="noopener">View the full illustrated guide online \u2197</a></p>
 <p>This guide describes the display and analysis features of the wafer map viewer.
 It is written for users who may be semiconductor test engineers, device engineers, and yield engineers
@@ -129,7 +129,9 @@ fail; it simply has no result recorded. Edge-excluded dies are shown dimmed and
 not counted in yield calculations.</p>
 <h3 id="14-legend-and-colorbar">1.4 Legend and colorbar</h3>
 <p><strong>Bin modes</strong> show a discrete colour legend: one swatch per bin, with bin number
-and name if the application has supplied bin names.</p>
+and name if the application has supplied bin names. Passing bins are listed first,
+then failing bins from the most dies to the fewest \u2014 the same order as the Summary
+panel and reports.</p>
 <p><strong>Value mode</strong> shows a continuous colorbar: the colour scale runs from the minimum
 to maximum value, with units when available. The colorbar is informational only \u2014
 clicking it has no effect. To switch to a pass/fail view, use the <strong>Spec pass/fail</strong>
@@ -358,20 +360,23 @@ shows die tooltips \u2014 a separate thing from the toolbar, which is always pre
 </tbody></table>
 <p><strong>This guide&#39;s own window</strong> (and a gallery card detached into its own window,
 see <a href="#gallery" onclick="(function(e){e.preventDefault();var g=e.target.closest('.wmap-guide');var el=g&&g.querySelector('[id=\\'gallery\\']');if(el)el.scrollIntoView({behavior:'smooth'});})(event)">Section 3 \u2014 Gallery</a> below) is a floating window, not a modal \u2014
-its header shows minimize, maximize, and close buttons, and it can be dragged
-and resized by its corner grip. Minimizing collapses it to a small title strip
-without closing it; click it again to restore.</p>
+its header shows collapse, maximize, and close buttons, and it can be dragged
+and resized by its corner grip. Collapse shrinks it to a small title strip
+without closing it; click the same button (now <strong>Show contents</strong>) to restore it.
+While the window is maximized only restore and close are shown.</p>
 <p><strong>Highlight bin</strong> \u2014 in bin modes, click any bin swatch in the legend to highlight
 that bin and dim all others. Click again to clear. Useful for isolating a specific
 failure category across the wafer.</p>
 <div data-wmap-demo="bin-highlight" class="wmap-demo"></div><p><em>Bin 2 (Fail) highlighted \u2014 all other bins are dimmed.</em></p>
 <p><strong>Bin colours</strong> \u2014 a bin&#39;s colour tells you whether it passed before you read the legend:
 passing bins are always shades of green and failing bins never are, whichever bin numbers
-your test program uses. The bins with the most dies get the most distinct colours. In a
-gallery the colours are worked out across every wafer it shows, so a bin is the same
-colour on every card. If there are more bins than the colour scheme has distinct colours, some bins
-have to share one \u2014 a <strong>Data warnings</strong> entry names them, and you can tell them apart with
-the legend, the tooltip, or by highlighting one bin at a time.</p>
+your test program uses. Each bin number keeps its colour: bin 7 is the same colour in every
+lot, every gallery and every screenshot, however many dies it holds, so you can learn your
+program&#39;s colours. Hard and soft bins are coloured separately, so hard bin 3 and soft bin 3
+are different colours. A colour scheme has a limited number of colours, so bins far enough
+apart in number repeat one \u2014 when two of them are on screen together a <strong>Data warnings</strong>
+entry names them, and you can tell them apart with the legend, the tooltip, or by
+highlighting one bin at a time.</p>
 <h3 id="overlays">Overlays</h3>
 <p>Use the <strong>Overlays</strong> menu to toggle optional display layers on and off:</p>
 <ul>
@@ -462,7 +467,7 @@ the legend, the tooltip, or by highlighting one bin at a time.</p>
 <tr>
 <td><img src="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjE2IiBoZWlnaHQ9IjE2IiBmaWxsPSJub25lIiBzdHJva2U9IiMzNzQxNTEiIHN0cm9rZS13aWR0aD0iMS44IiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPgogIDxyZWN0IHg9IjMiIHk9IjMiIHdpZHRoPSI0IiBoZWlnaHQ9IjE4IiByeD0iMSIvPgogIDxyZWN0IHg9IjEwIiB5PSIzIiB3aWR0aD0iNCIgaGVpZ2h0PSIxOCIgcng9IjEiLz4KICA8cmVjdCB4PSIxNyIgeT0iMyIgd2lkdGg9IjQiIGhlaWdodD0iMTgiIHJ4PSIxIi8+Cjwvc3ZnPgo=" width="20" height="20"></td>
 <td>Columns</td>
-<td>Sets the number of columns in the card grid.</td>
+<td>Sets the number of columns. <strong>Auto</strong> fits as many cards as stay readable; a number divides the full width between that many columns.</td>
 </tr>
 <tr>
 <td><img src="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjE2IiBoZWlnaHQ9IjE2IiBmaWxsPSJub25lIiBzdHJva2U9IiMzNzQxNTEiIHN0cm9rZS13aWR0aD0iMS44IiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjxwYXRoIGQ9Ik0xMy45OTcgNGEyIDIgMCAwIDEgMS43NiAxLjA1bC40ODYuOUEyIDIgMCAwIDAgMTguMDAzIDdIMjBhMiAyIDAgMCAxIDIgMnY5YTIgMiAwIDAgMS0yIDJINGEyIDIgMCAwIDEtMi0yVjlhMiAyIDAgMCAxIDItMmgxLjk5N2EyIDIgMCAwIDAgMS43NTktMS4wNDhsLjQ4OS0uOTA0QTIgMiAwIDAgMSAxMC4wMDQgNHoiLz48Y2lyY2xlIGN4PSIxMiIgY3k9IjEzIiByPSIzIi8+PGNpcmNsZSBjeD0iNS41IiBjeT0iNC41IiByPSIwLjgiIGZpbGw9IiMzNzQxNTEiIHN0cm9rZT0ibm9uZSIvPjxjaXJjbGUgY3g9IjgiIGN5PSI0LjUiIHI9IjAuOCIgZmlsbD0iIzM3NDE1MSIgc3Ryb2tlPSJub25lIi8+PGNpcmNsZSBjeD0iNS41IiBjeT0iNyIgcj0iMC44IiBmaWxsPSIjMzc0MTUxIiBzdHJva2U9Im5vbmUiLz48Y2lyY2xlIGN4PSI4IiBjeT0iNyIgcj0iMC44IiBmaWxsPSIjMzc0MTUxIiBzdHJva2U9Im5vbmUiLz48L3N2Zz4K" width="20" height="20"></td>
@@ -482,7 +487,7 @@ the legend, the tooltip, or by highlighting one bin at a time.</p>
 <tr>
 <td><img src="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjE2IiBoZWlnaHQ9IjE2IiBmaWxsPSJub25lIiBzdHJva2U9IiMzNzQxNTEiIHN0cm9rZS13aWR0aD0iMS44IiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjxyZWN0IHdpZHRoPSI3IiBoZWlnaHQ9IjciIHg9IjMiIHk9IjMiIHJ4PSIxIi8+PHJlY3Qgd2lkdGg9IjciIGhlaWdodD0iNyIgeD0iMyIgeT0iMTQiIHJ4PSIxIi8+PHBhdGggZD0iTTE0IDRoNyIvPjxwYXRoIGQ9Ik0xNCA5aDciLz48cGF0aCBkPSJNMTQgMTVoNyIvPjxwYXRoIGQ9Ik0xNCAyMGg3Ii8+PC9zdmc+Cg==" width="20" height="20"></td>
 <td>Legend style</td>
-<td>Bin modes only. Sets where the bin legend sits relative to each card.</td>
+<td><strong>Legend on each map</strong> adds a legend to every card as well as the shared one above the grid (off by default). While it is on, bin modes also let you choose where that legend sits on each card.</td>
 </tr>
 <tr>
 <td><img src="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjE2IiBoZWlnaHQ9IjE2IiBmaWxsPSJub25lIiBzdHJva2U9IiMzNzQxNTEiIHN0cm9rZS13aWR0aD0iMS44IiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjxwYXRoIGQ9Ik01IDQgTDUgMjAiLz48cGF0aCBkPSJNNSA0IEw4IDQiLz48cGF0aCBkPSJNNSAyMCBMOCAyMCIvPjxwYXRoIGQ9Ik0xOSA0IEwxOSAyMCIvPjxwYXRoIGQ9Ik0xOSA0IEwxNiA0Ii8+PHBhdGggZD0iTTE5IDIwIEwxNiAyMCIvPjxwYXRoIGQ9Ik01IDEyIEwxOSAxMiIgc3Ryb2tlLWRhc2hhcnJheT0iMyAyIi8+PC9zdmc+Cg==" width="20" height="20"></td>
@@ -829,9 +834,15 @@ onto that pair.</em></p>
 <p>Every chart panel has a <strong>camera</strong> button that saves the current view as a PNG at the displayed
 resolution. To get a clean full-resolution render, use the panel&#39;s expand (corner-arrows)
 button first to open it in the fullscreen modal, then click the camera button.</p>
-<p>Each exported PNG includes a header strip above the chart with the panel title, source
-filename, wafer and die counts, the active test name (where applicable), and the time of
-export. The live card is unchanged \u2014 the header appears only in the saved file.</p>
+<p>The saved image is the chart as shown, on a white background. It carries no title or
+context of its own, but its file name identifies the lot, wafers and chart (see below).</p>
+<h3 id="names-of-saved-files">Names of saved files</h3>
+<p>Every image and CSV you save is named for what it shows: the lot, then the wafer (or how many
+wafers), then the content. For example, <code>LOT123_W05_hard-bin.png</code>, <code>LOT123_W05_die-list.csv</code> or
+<code>LOT123_25-wafers_yield-by-wafer.png</code>. Saving the same export from different wafers gives
+different names, so files don&#39;t overwrite each other or need renaming. A part is left out when
+the data doesn&#39;t have it, for example a wafer with no ID. Your application may choose its own
+name for map images instead.</p>
 <hr>
 <h2 id="9-reticle-overlay">9. Reticle overlay</h2>
 <p>When reticle (stepper field) geometry is configured, the <strong>Reticle grid</strong> overlay

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

@@ -1,3 +1,3 @@
-export declare const WMAP_VERSION = "0.29.0";
-export declare const WMAP_BUILD_TIME = "2026-09-12T08:42:54.616Z";
+export declare const WMAP_VERSION = "0.30.1";
+export declare const WMAP_BUILD_TIME = "2026-09-17T07:12:45.499Z";
 //# sourceMappingURL=version.d.ts.map

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

@@ -1 +1 @@
-export const WMAP_VERSION="0.29.0",WMAP_BUILD_TIME="2026-09-12T08:42:54.616Z";
+export const WMAP_VERSION="0.30.1",WMAP_BUILD_TIME="2026-09-17T07:12:45.499Z";

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

@@ -1 +1 @@
-import{SHADOW as w,TRACKING as O,SPACE as s,RADIUS as E,FONT as y,CLR as d,Z_BASE as A}from"./toolbar.js";const $={error:0,warning:1,info:2};export function severityOf(t){return t.severity??"warning"}export function collectWarnings(t){const o=[],i=new Set,n=e=>{if(!e?.message)return;const r=`${e.code}\0${e.message}`;i.has(r)||(i.add(r),o.push(e))};for(const e of t.result?.warnings??[])n(e);for(const e of t.statsSummary?.stats.warnings??[])n(e);for(const e of t.lotStatsSummary?.perWafer??[])for(const r of e.summary.stats.warnings??[])n(r);for(const e of t.extra??[])n(e);return o.sort((e,r)=>$[severityOf(e)]-$[severityOf(r)])}function v(t){return t==="error"?{bg:d.errBg,border:d.errBorder,text:d.errText}:{bg:d.warnBg,border:d.warnBorder,text:d.warnText}}function C(t){return t==="error"?"\u26D4":t==="info"?"\u2139":"\u26A0"}export const SHORT_LABEL={"partial-coverage":"Partial wafer coverage","geometry-conflict":"Geometry conflict","non-standard-diameter":"Non-standard wafer diameter","diameter-exceeds-die-extent":"Diameter exceeds die extent","edge-exclusion-exceeds-radius":"Edge exclusion exceeds radius","test-count-capped":"Test analysis skipped","test-def-collision":"Test definitions disagree","analysis-option-corrected":"Analysis option corrected"};function S(t){const o=t.code?SHORT_LABEL[t.code]:void 0;if(o)return o;const i=t.message.split(/(?<=\.)\s/)[0]??t.message;return i.length>60?`${i.slice(0,57)}\u2026`:i}export function buildWarningsBanner(t,o=document){const i=o.createElement("div");Object.assign(i.style,{marginBottom:s.lg});for(const n of t){const e=severityOf(n),r=v(e),m=o.createElement("div");Object.assign(m.style,{background:r.bg,border:`1px solid ${r.border}`,borderRadius:E.control,marginBottom:s.sm,fontSize:y.body,color:r.text,lineHeight:"1.5"}),m.setAttribute("role","status");const a=o.createElement("button");a.type="button",Object.assign(a.style,{display:"flex",alignItems:"center",gap:s.sm,width:"100%",background:"none",border:"none",font:"inherit",color:"inherit",textAlign:"left",padding:`${s.sm} ${s.lg}`,cursor:"pointer"});const g=o.createElement("span");Object.assign(g.style,{flex:"1",minWidth:"0"}),g.textContent=`${C(e)} ${S(n)}`;const l=o.createElement("span");Object.assign(l.style,{flexShrink:"0"}),a.append(g,l);const p=o.createElement("div");Object.assign(p.style,{padding:`0 ${s.lg} ${s.sm}`}),p.textContent=n.message;let c=!1;const f=()=>{l.textContent=c?"\u25B4":"\u25BE",p.style.display=c?"block":"none",a.setAttribute("aria-expanded",String(c)),a.setAttribute("aria-label",`${S(n)}. ${c?"Click to collapse.":"Click to expand for detail."}`)};f(),a.addEventListener("click",()=>{c=!c,f()}),a.addEventListener("mouseenter",()=>{l.style.opacity="0.65"}),a.addEventListener("mouseleave",()=>{l.style.opacity="1"}),m.append(a,p),i.appendChild(m)}return i}export function buildWarningsMenuEl(t,o,i=window){const n=i.document,e=n.createElement("div"),r=280,a=t.left+r<=(i.innerWidth??1/0)?t.left:Math.max(4,t.right-r);Object.assign(e.style,{position:"fixed",top:`${t.bottom+4}px`,left:`${a}px`,background:d.menuBg,border:`1px solid ${d.menuBorder}`,borderRadius:E.control,boxShadow:w.menu,zIndex:A,width:`${r}px`,maxHeight:"320px",overflowY:"auto",padding:"4px 0",pointerEvents:"auto"}),e.setAttribute("role","dialog"),e.setAttribute("aria-label","Data warnings");const g=n.createElement("div");Object.assign(g.style,{padding:`${s.sm} ${s.xl} ${s.xs}`,fontSize:y.body,fontWeight:"700",letterSpacing:O,textTransform:"uppercase",color:d.label}),g.textContent=o.length===1?"1 warning":`${o.length} warnings`,e.appendChild(g);for(const l of o){const p=severityOf(l),c=v(p),f=n.createElement("div");Object.assign(f.style,{display:"flex",gap:s.md,padding:`${s.md} ${s.xl}`,fontSize:y.body,lineHeight:"1.5",color:d.text,borderTop:`1px solid ${d.menuBorder}`,alignItems:"flex-start"});const x=n.createElement("span");Object.assign(x.style,{color:c.text,flexShrink:"0"}),x.textContent=C(p),f.appendChild(x);const u=n.createElement("div"),b=n.createElement("div");Object.assign(b.style,{fontWeight:"700",color:c.text,marginBottom:s.xxs}),b.textContent=l.code,u.appendChild(b);const h=n.createElement("div");h.textContent=l.message,u.appendChild(h),f.appendChild(u),e.appendChild(f)}return e}
+import{SHADOW as S,TRACKING as O,SPACE as s,RADIUS as v,FONT as y,CLR as d,Z_BASE as B}from"./toolbar.js";const E={error:0,warning:1,info:2};export function severityOf(t){return t.severity??"warning"}export function collectWarnings(t){const o=[],i=new Set,n=e=>{if(!e?.message)return;const r=`${e.code}\0${e.message}`;i.has(r)||(i.add(r),o.push(e))};for(const e of t.result?.warnings??[])n(e);for(const e of t.statsSummary?.stats.warnings??[])n(e);for(const e of t.lotStatsSummary?.perWafer??[])for(const r of e.summary.stats.warnings??[])n(r);for(const e of t.extra??[])n(e);return o.sort((e,r)=>E[severityOf(e)]-E[severityOf(r)])}function $(t){return t==="error"?{bg:d.errBg,border:d.errBorder,text:d.errText}:{bg:d.warnBg,border:d.warnBorder,text:d.warnText}}function w(t){return t==="error"?"\u26D4":t==="info"?"\u2139":"\u26A0"}export const SHORT_LABEL={"partial-coverage":"Partial wafer coverage","geometry-conflict":"Geometry conflict","non-standard-diameter":"Non-standard wafer diameter","diameter-exceeds-die-extent":"Diameter exceeds die extent","edge-exclusion-exceeds-radius":"Edge exclusion exceeds radius","test-count-capped":"Test analysis skipped","test-def-collision":"Test definitions disagree","analysis-option-corrected":"Analysis option corrected","bin-colors-shared":"Bins share a colour","pass-bins-mixed":"Pass bins differ by wafer","ring-count-mixed":"Ring counts differ by wafer","input-field-removed":"Removed input name ignored","input-values-not-numbers":"Bins or test values are text"};function C(t){const o=t.code?SHORT_LABEL[t.code]:void 0;if(o)return o;const i=t.message.split(/(?<=\.)\s/)[0]??t.message;return i.length>60?`${i.slice(0,57)}\u2026`:i}export function buildWarningsBanner(t,o=document){const i=o.createElement("div");Object.assign(i.style,{marginBottom:s.lg});for(const n of t){const e=severityOf(n),r=$(e),m=o.createElement("div");Object.assign(m.style,{background:r.bg,border:`1px solid ${r.border}`,borderRadius:v.control,marginBottom:s.sm,fontSize:y.body,color:r.text,lineHeight:"1.5"}),m.setAttribute("role","status");const a=o.createElement("button");a.type="button",Object.assign(a.style,{display:"flex",alignItems:"center",gap:s.sm,width:"100%",background:"none",border:"none",font:"inherit",color:"inherit",textAlign:"left",padding:`${s.sm} ${s.lg}`,cursor:"pointer"});const g=o.createElement("span");Object.assign(g.style,{flex:"1",minWidth:"0"}),g.textContent=`${w(e)} ${C(n)}`;const l=o.createElement("span");Object.assign(l.style,{flexShrink:"0"}),a.append(g,l);const p=o.createElement("div");Object.assign(p.style,{padding:`0 ${s.lg} ${s.sm}`}),p.textContent=n.message;let c=!1;const f=()=>{l.textContent=c?"\u25B4":"\u25BE",p.style.display=c?"block":"none",a.setAttribute("aria-expanded",String(c)),a.setAttribute("aria-label",`${C(n)}. ${c?"Click to collapse.":"Click to expand for detail."}`)};f(),a.addEventListener("click",()=>{c=!c,f()}),a.addEventListener("mouseenter",()=>{l.style.opacity="0.65"}),a.addEventListener("mouseleave",()=>{l.style.opacity="1"}),m.append(a,p),i.appendChild(m)}return i}export function buildWarningsMenuEl(t,o,i=window){const n=i.document,e=n.createElement("div"),r=280,a=t.left+r<=(i.innerWidth??1/0)?t.left:Math.max(4,t.right-r);Object.assign(e.style,{position:"fixed",top:`${t.bottom+4}px`,left:`${a}px`,background:d.menuBg,border:`1px solid ${d.menuBorder}`,borderRadius:v.control,boxShadow:S.menu,zIndex:B,width:`${r}px`,maxHeight:"320px",overflowY:"auto",padding:"4px 0",pointerEvents:"auto"}),e.setAttribute("role","dialog"),e.setAttribute("aria-label","Data warnings");const g=n.createElement("div");Object.assign(g.style,{padding:`${s.sm} ${s.xl} ${s.xs}`,fontSize:y.body,fontWeight:"700",letterSpacing:O,textTransform:"uppercase",color:d.label}),g.textContent=o.length===1?"1 warning":`${o.length} warnings`,e.appendChild(g);for(const l of o){const p=severityOf(l),c=$(p),f=n.createElement("div");Object.assign(f.style,{display:"flex",gap:s.md,padding:`${s.md} ${s.xl}`,fontSize:y.body,lineHeight:"1.5",color:d.text,borderTop:`1px solid ${d.menuBorder}`,alignItems:"flex-start"});const x=n.createElement("span");Object.assign(x.style,{color:c.text,flexShrink:"0"}),x.textContent=w(p),f.appendChild(x);const u=n.createElement("div"),b=n.createElement("div");Object.assign(b.style,{fontWeight:"700",color:c.text,marginBottom:s.xxs}),b.textContent=l.code,u.appendChild(b);const h=n.createElement("div");h.textContent=l.message,u.appendChild(h),f.appendChild(u),e.appendChild(f)}return e}

package/dist/packages/core/deprecated.d.ts

@@ -0,0 +1,60 @@
+import { createWafer as createWaferImpl } from './wafer.js';
+import { generateDies as generateDiesImpl, isPositionedDie as isPositionedDieImpl } from './dies.js';
+import { clipDiesToWafer as clipDiesToWaferImpl, applyOrientation as applyOrientationImpl, transformDies as transformDiesImpl, mapDataToDies as mapDataToDiesImpl, isInsideWafer as isInsideWaferImpl, affineIdentity as affineIdentityImpl, affineRotation as affineRotationImpl, affineMirror as affineMirrorImpl, affineCompose as affineComposeImpl, affineInvert as affineInvertImpl, affinePoint as affinePointImpl, affineVector as affineVectorImpl, affineSwapsAxes as affineSwapsAxesImpl } from './transforms.js';
+import { applyProbeSequence as applyProbeSequenceImpl } from './probe.js';
+import { generateReticleGrid as generateReticleGridImpl } from './reticle.js';
+import { classifyDie as classifyDieImpl, getRingLabel as getRingLabelImpl } from './classify.js';
+import { aggregateValues as aggregateValuesImpl, aggregateBinCounts as aggregateBinCountsImpl, getUniqueBins as getUniqueBinsImpl } from './aggregates.js';
+import { metadataCategoricalValue as metadataCategoricalValueImpl } from './metadata.js';
+import { resolveGridPitch as resolveGridPitchImpl } from './inference/pitch.js';
+/** @deprecated Removed in 0.31.0. For a die layout with no test data use `buildWaferMap({ layout: true, waferConfig, dieConfig })`; otherwise build with `buildWaferMap` and draw with `renderWaferMap` or `renderWaferGallery`. */
+export declare const createWafer: typeof createWaferImpl;
+/** @deprecated Removed in 0.31.0. For a die layout with no test data use `buildWaferMap({ layout: true, waferConfig, dieConfig })`, which keeps every site fully on the wafer. */
+export declare const generateDies: typeof generateDiesImpl;
+/** @deprecated Removed in 0.31.0. Use `hasPosition` to test whether a die has a position. */
+export declare const isPositionedDie: typeof isPositionedDieImpl;
+/** @deprecated Removed in 0.31.0. For a die layout with no test data use `buildWaferMap({ layout: true, waferConfig, dieConfig })`, which keeps every site fully on the wafer. */
+export declare const clipDiesToWafer: typeof clipDiesToWaferImpl;
+/** @deprecated Removed in 0.31.0. It belongs to the low-level drawing pipeline, which is being withdrawn: build with `buildWaferMap` and draw with `renderWaferMap` or `renderWaferGallery`. */
+export declare const applyOrientation: typeof applyOrientationImpl;
+/** @deprecated Removed in 0.31.0. It belongs to the low-level drawing pipeline, which is being withdrawn: build with `buildWaferMap` and draw with `renderWaferMap` or `renderWaferGallery`. */
+export declare const transformDies: typeof transformDiesImpl;
+/** @deprecated Removed in 0.31.0. `buildWaferMap` maps results onto dies. */
+export declare const mapDataToDies: typeof mapDataToDiesImpl;
+/** @deprecated Removed in 0.31.0. It belongs to the low-level drawing pipeline, which is being withdrawn: build with `buildWaferMap` and draw with `renderWaferMap` or `renderWaferGallery`. */
+export declare const isInsideWafer: typeof isInsideWaferImpl;
+/** @deprecated Removed in 0.31.0. It belongs to the low-level drawing pipeline, which is being withdrawn: build with `buildWaferMap` and draw with `renderWaferMap` or `renderWaferGallery`. */
+export declare const affineIdentity: typeof affineIdentityImpl;
+/** @deprecated Removed in 0.31.0. It belongs to the low-level drawing pipeline, which is being withdrawn: build with `buildWaferMap` and draw with `renderWaferMap` or `renderWaferGallery`. */
+export declare const affineRotation: typeof affineRotationImpl;
+/** @deprecated Removed in 0.31.0. It belongs to the low-level drawing pipeline, which is being withdrawn: build with `buildWaferMap` and draw with `renderWaferMap` or `renderWaferGallery`. */
+export declare const affineMirror: typeof affineMirrorImpl;
+/** @deprecated Removed in 0.31.0. It belongs to the low-level drawing pipeline, which is being withdrawn: build with `buildWaferMap` and draw with `renderWaferMap` or `renderWaferGallery`. */
+export declare const affineCompose: typeof affineComposeImpl;
+/** @deprecated Removed in 0.31.0. It belongs to the low-level drawing pipeline, which is being withdrawn: build with `buildWaferMap` and draw with `renderWaferMap` or `renderWaferGallery`. */
+export declare const affineInvert: typeof affineInvertImpl;
+/** @deprecated Removed in 0.31.0. It belongs to the low-level drawing pipeline, which is being withdrawn: build with `buildWaferMap` and draw with `renderWaferMap` or `renderWaferGallery`. */
+export declare const affinePoint: typeof affinePointImpl;
+/** @deprecated Removed in 0.31.0. It belongs to the low-level drawing pipeline, which is being withdrawn: build with `buildWaferMap` and draw with `renderWaferMap` or `renderWaferGallery`. */
+export declare const affineVector: typeof affineVectorImpl;
+/** @deprecated Removed in 0.31.0. It belongs to the low-level drawing pipeline, which is being withdrawn: build with `buildWaferMap` and draw with `renderWaferMap` or `renderWaferGallery`. */
+export declare const affineSwapsAxes: typeof affineSwapsAxesImpl;
+/** @deprecated Removed in 0.31.0. It belongs to the low-level drawing pipeline, which is being withdrawn: build with `buildWaferMap` and draw with `renderWaferMap` or `renderWaferGallery`. */
+export declare const applyProbeSequence: typeof applyProbeSequenceImpl;
+/** @deprecated Removed in 0.31.0. It belongs to the low-level drawing pipeline, which is being withdrawn: build with `buildWaferMap` and draw with `renderWaferMap` or `renderWaferGallery`. */
+export declare const generateReticleGrid: typeof generateReticleGridImpl;
+/** @deprecated Removed in 0.31.0. A die's ring and quadrant are in the die list's CSV export (Ring and Quadrant columns); ring and quadrant yield is `stats.regionYield.` */
+export declare const classifyDie: typeof classifyDieImpl;
+/** @deprecated Removed in 0.31.0. Ring labels come with ring yield (`stats.regionYield.ring[].label`) and ring findings (`comparison.left`). */
+export declare const getRingLabel: typeof getRingLabelImpl;
+/** @deprecated Removed in 0.31.0. Stack wafers with `buildWaferMap`'s `lotStack` option. */
+export declare const aggregateValues: typeof aggregateValuesImpl;
+/** @deprecated Removed in 0.31.0. Stack wafers with `buildWaferMap`'s `lotStack` option. */
+export declare const aggregateBinCounts: typeof aggregateBinCountsImpl;
+/** @deprecated Removed in 0.31.0. Stack wafers with `buildWaferMap`'s `lotStack` option. */
+export declare const getUniqueBins: typeof getUniqueBinsImpl;
+/** @deprecated Removed in 0.31.0. Use `metadataDisplayValue` for a metadata value's text. */
+export declare const metadataCategoricalValue: typeof metadataCategoricalValueImpl;
+/** @deprecated Removed in 0.31.0. `buildWaferMap` resolves the die pitch itself; each built die's width and height carry it. */
+export declare const resolveGridPitch: typeof resolveGridPitchImpl;
+//# sourceMappingURL=deprecated.d.ts.map

package/dist/packages/core/deprecated.js

@@ -0,0 +1 @@
+import{deprecated as e}from"../renderer/deprecate.js";import{createWafer as o}from"./wafer.js";import{generateDies as r,isPositionedDie as n}from"./dies.js";import{clipDiesToWafer as s,applyOrientation as f,transformDies as p,mapDataToDies as l,isInsideWafer as d,affineIdentity as c,affineRotation as g,affineMirror as m,affineCompose as u,affineInvert as I,affinePoint as $,affineVector as h,affineSwapsAxes as D}from"./transforms.js";import{applyProbeSequence as y}from"./probe.js";import{generateReticleGrid as w}from"./reticle.js";import{classifyDie as x,getRingLabel as C}from"./classify.js";import{aggregateValues as b,aggregateBinCounts as W,getUniqueBins as P}from"./aggregates.js";import{metadataCategoricalValue as V}from"./metadata.js";import{resolveGridPitch as S}from"./inference/pitch.js";const a="If you depend on it, say so at https://github.com/wafertools/wafermap/issues.",t="It belongs to the low-level drawing pipeline, which is being withdrawn: build with buildWaferMap and draw with renderWaferMap or renderWaferGallery.",A="Use hasPosition to test whether a die has a position.",M="buildWaferMap maps results onto dies.",i="Stack wafers with buildWaferMap's lotStack option.",R="buildWaferMap resolves the die pitch itself; each built die's width and height carry it.";export const createWafer=e(o,"createWafer",`For a die layout with no test data use buildWaferMap({ layout: true, waferConfig, dieConfig }); otherwise build with buildWaferMap and draw with renderWaferMap or renderWaferGallery. ${a}`),generateDies=e(r,"generateDies",`For a die layout with no test data use buildWaferMap({ layout: true, waferConfig, dieConfig }), which keeps every site fully on the wafer. ${a}`),isPositionedDie=e(n,"isPositionedDie",`${A} ${a}`),clipDiesToWafer=e(s,"clipDiesToWafer",`For a die layout with no test data use buildWaferMap({ layout: true, waferConfig, dieConfig }), which keeps every site fully on the wafer. ${a}`),applyOrientation=e(f,"applyOrientation",`${t} ${a}`),transformDies=e(p,"transformDies",`${t} ${a}`),mapDataToDies=e(l,"mapDataToDies",`${M} ${a}`),isInsideWafer=e(d,"isInsideWafer",`${t} ${a}`),affineIdentity=e(c,"affineIdentity",`${t} ${a}`),affineRotation=e(g,"affineRotation",`${t} ${a}`),affineMirror=e(m,"affineMirror",`${t} ${a}`),affineCompose=e(u,"affineCompose",`${t} ${a}`),affineInvert=e(I,"affineInvert",`${t} ${a}`),affinePoint=e($,"affinePoint",`${t} ${a}`),affineVector=e(h,"affineVector",`${t} ${a}`),affineSwapsAxes=e(D,"affineSwapsAxes",`${t} ${a}`),applyProbeSequence=e(y,"applyProbeSequence",`${t} ${a}`),generateReticleGrid=e(w,"generateReticleGrid",`${t} ${a}`),classifyDie=e(x,"classifyDie",`A die's ring and quadrant are in the die list's CSV export (Ring and Quadrant columns); ring and quadrant yield is stats.regionYield. ${a}`),getRingLabel=e(C,"getRingLabel",`Ring labels come with ring yield (stats.regionYield.ring[].label) and ring findings (comparison.left). ${a}`),aggregateValues=e(b,"aggregateValues",`${i} ${a}`),aggregateBinCounts=e(W,"aggregateBinCounts",`${i} ${a}`),getUniqueBins=e(P,"getUniqueBins",`${i} ${a}`),metadataCategoricalValue=e(V,"metadataCategoricalValue",`Use metadataDisplayValue for a metadata value's text. ${a}`),resolveGridPitch=e(S,"resolveGridPitch",`${R} ${a}`);

package/dist/packages/core/index.d.ts

@@ -5,9 +5,7 @@ export * from './metadata.js';
 export * from './probe.js';
 export * from './reticle.js';
 export type { DataRow, MapOptions, TransformOptions, Affine, CoordFrame } from './transforms.js';
-export { isInsideWafer, clipDiesToWafer, applyOrientation, transformDies, mapDataToDies } from './transforms.js';
-export { affineIdentity, affineRotation, affineMirror, affineCompose, affineInvert, affinePoint, affineVector, affineSwapsAxes, } from './transforms.js';
 export * from './wafer.js';
 export type { PitchResult } from './inference/pitch.js';
-export { resolveGridPitch } from './inference/pitch.js';
+export { createWafer, generateDies, isPositionedDie, clipDiesToWafer, applyOrientation, transformDies, mapDataToDies, isInsideWafer, affineIdentity, affineRotation, affineMirror, affineCompose, affineInvert, affinePoint, affineVector, affineSwapsAxes, applyProbeSequence, generateReticleGrid, classifyDie, getRingLabel, aggregateValues, aggregateBinCounts, getUniqueBins, metadataCategoricalValue, resolveGridPitch, } from './deprecated.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/packages/core/index.js

@@ -1 +1 @@
-export*from"./aggregates.js";export*from"./classify.js";export*from"./dies.js";export*from"./metadata.js";export*from"./probe.js";export*from"./reticle.js";export{isInsideWafer,clipDiesToWafer,applyOrientation,transformDies,mapDataToDies}from"./transforms.js";export{affineIdentity,affineRotation,affineMirror,affineCompose,affineInvert,affinePoint,affineVector,affineSwapsAxes}from"./transforms.js";export*from"./wafer.js";export{resolveGridPitch}from"./inference/pitch.js";
+export*from"./aggregates.js";export*from"./classify.js";export*from"./dies.js";export*from"./metadata.js";export*from"./probe.js";export*from"./reticle.js";export*from"./wafer.js";export{createWafer,generateDies,isPositionedDie,clipDiesToWafer,applyOrientation,transformDies,mapDataToDies,isInsideWafer,affineIdentity,affineRotation,affineMirror,affineCompose,affineInvert,affinePoint,affineVector,affineSwapsAxes,applyProbeSequence,generateReticleGrid,classifyDie,getRingLabel,aggregateValues,aggregateBinCounts,getUniqueBins,metadataCategoricalValue,resolveGridPitch}from"./deprecated.js";

package/dist/packages/core/passBins.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Which bins pass, per wafer — and how to name a set of them.
+ *
+ * The rule this file exists for: `[1]` is a default only where data ENTERS the
+ * library (`buildWaferMap`'s input). From there the value travels on the result
+ * (`WaferMapResult.passBins`), and every display, analysis and report reads it —
+ * per wafer, because a gallery can hold wafers from programs with different pass
+ * bins. Every downstream surface used to default `passBins` to `[1]` on its own
+ * unless the caller repeated it, so a host that told `buildWaferMap` bins 1 and 2
+ * pass saw bin 2 drawn, sorted and totalled as a failure everywhere else — with
+ * `result.yield`, the one figure that did use them, disagreeing beside it.
+ *
+ * Deliberately internal (not re-exported from `core/index.ts`).
+ */
+/** The industry convention, applied ONLY to input that states no pass bins. */
+export declare const INPUT_DEFAULT_PASS_BINS: readonly number[];
+/**
+ * One wafer's pass bins: its own (carried from `buildWaferMap`), else the
+ * caller's default for items built without any, else the input convention.
+ */
+export declare function itemPassBins(item: {
+    passBins?: readonly number[];
+} | null | undefined, fallback?: readonly number[]): readonly number[];
+/** Same bins, in any order. */
+export declare function sameBins(a: readonly number[], b: readonly number[]): boolean;
+/**
+ * Names the pass bins in use, for a yield label: "bin 1", "bins 1, 2", or —
+ * when the wafers shown disagree — "per wafer: bin 1 · bins 1, 2". A label that
+ * named one wafer's set while the figure pooled wafers judged differently would
+ * be the exact mislabelled population the library must never show.
+ */
+export declare function passBinsLabel(sets: Iterable<readonly number[]>): string;
+//# sourceMappingURL=passBins.d.ts.map

package/dist/packages/core/passBins.js

@@ -0,0 +1 @@
+export const INPUT_DEFAULT_PASS_BINS=[1];export function itemPassBins(s,e=INPUT_DEFAULT_PASS_BINS){return s?.passBins??e}export function sameBins(s,e){const t=new Set(s),n=new Set(e);return t.size===n.size&&[...t].every(i=>n.has(i))}export function passBinsLabel(s){const e=[];for(const n of s)e.some(i=>sameBins(i,n))||e.push(n);const t=n=>n.length===0?"no bins":n.length===1?`bin ${n[0]}`:`bins ${n.join(", ")}`;return e.length<=1?t(e[0]??INPUT_DEFAULT_PASS_BINS):`per wafer: ${e.map(t).join(" \xB7 ")}`}

package/dist/packages/core/utils.d.ts

@@ -68,4 +68,16 @@ export declare function modeOf(values: number[]): number | null;
  * obvious. Every CSV this library writes must go through it.
  */
 export declare function csvField(value: string): string;
+/**
+ * Escape text for insertion into HTML — the one copy for the whole library.
+ *
+ * Every string the library puts into `innerHTML` that did not come from its own
+ * literals must go through this: test names, units, bin names, wafer labels and
+ * metadata values all arrive from input files (STDF/ATDF/CSV headers, MES
+ * fields, operator free text), and a name like `<img src=x onerror=…>` would
+ * otherwise run as script when a tooltip showed it — in a Tauri or Electron
+ * host, inside the app's own webview. It used to live in stats/reportHtml.ts,
+ * where only the reports used it, while every tooltip interpolated raw names.
+ */
+export declare function escHtml(value: string): string;
 //# sourceMappingURL=utils.d.ts.map

package/dist/packages/core/utils.js

@@ -1 +1 @@
-export function compareNatural(t,n){return t.localeCompare(n,"en",{numeric:!0})}export function prettyKey(t){return t.replace(/([A-Z])/g," $1").replace(/_/g," ").trim().replace(/^./,n=>n.toUpperCase())}export function clamp01(t){return Math.max(0,Math.min(1,t))}export function mean(t){if(t.length===0)return NaN;let n=0;for(const r of t)n+=r;return n/t.length}export function medianOfSorted(t){const n=t.length;if(n===0)return 0;const r=Math.floor(n/2);return n%2===1?t[r]:(t[r-1]+t[r])/2}export function median(t){return medianOfSorted([...t].sort((n,r)=>n-r))}export function percentile98(t){if(t.length===0)return 0;const n=[...t].sort((o,e)=>o-e),r=Math.floor(n.length*.98);return n[Math.min(r,n.length-1)]}export function modeOf(t){if(!t.length)return null;const n=new Map;for(const e of t)n.set(e,(n.get(e)??0)+1);let r=0,o=t[0];for(const[e,c]of n)c>r&&(r=c,o=e);return o}const i=/^[=+\-@]/;export function csvField(t){const n=i.test(t)&&Number.isNaN(Number(t))?`'${t}`:t;return/[",\n\r]/.test(n)?`"${n.replace(/"/g,'""')}"`:n}
+export function compareNatural(t,e){return t.localeCompare(e,"en",{numeric:!0})}export function prettyKey(t){return t.replace(/([A-Z])/g," $1").replace(/_/g," ").trim().replace(/^./,e=>e.toUpperCase())}export function clamp01(t){return Math.max(0,Math.min(1,t))}export function mean(t){if(t.length===0)return NaN;let e=0;for(const n of t)e+=n;return e/t.length}export function medianOfSorted(t){const e=t.length;if(e===0)return 0;const n=Math.floor(e/2);return e%2===1?t[n]:(t[n-1]+t[n])/2}export function median(t){return medianOfSorted([...t].sort((e,n)=>e-n))}export function percentile98(t){if(t.length===0)return 0;const e=[...t].sort((o,r)=>o-r),n=Math.floor(e.length*.98);return e[Math.min(n,e.length-1)]}export function modeOf(t){if(!t.length)return null;const e=new Map;for(const r of t)e.set(r,(e.get(r)??0)+1);let n=0,o=t[0];for(const[r,c]of e)c>n&&(n=c,o=r);return o}const p=/^[=+\-@]/;export function csvField(t){const e=p.test(t)&&Number.isNaN(Number(t))?`'${t}`:t;return/[",\n\r]/.test(e)?`"${e.replace(/"/g,'""')}"`:e}export function escHtml(t){return t.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}

package/dist/packages/core/waferLabel.d.ts

@@ -0,0 +1,35 @@
+import { type WaferMetadata } from './metadata.js';
+/**
+ * The name to show for one wafer among several — a gallery card's header, a
+ * findings or yield list row, a report's Wafer column, a die list's Wafer
+ * column, a detached window's title.
+ *
+ * Deliberately internal (not re-exported from `core/index.ts`): it is the one
+ * rule for every surface that names a wafer, not an API a host needs.
+ *
+ * Every one of those surfaces used to supply its own fallback for an item with
+ * no `label`, and they disagreed: the gallery card header was blank, the
+ * findings list and reports said `W3` (a position, which reads as a wafer ID
+ * and need not match one), a detached window said "Wafer map", and the
+ * Insights tab used the wafer ID. The wafer ID was on the item the whole time.
+ *
+ * Order: the caller's `label` (a blank one counts as absent), then the wafer's
+ * own `metadata.waferId`, then a position that says plainly it is not an ID.
+ */
+export declare function waferDisplayLabel(item: WaferLabelSource, index: number): string;
+type WaferLabelSource = {
+    label?: string;
+    wafer?: {
+        metadata?: WaferMetadata | null;
+    } | null;
+} | null | undefined;
+/**
+ * The wafer's real identity — the caller's `label`, else `metadata.waferId` —
+ * or `undefined` when it has none. `waferDisplayLabel` without its positional
+ * fallback, for places where a position must not stand in for an identity: a
+ * saved file's name (see canvas-adapter/exportName.ts), where "Wafer 3 (no ID)"
+ * would be written into every export of a lot and read back later as an ID.
+ */
+export declare function waferIdentityLabel(item: WaferLabelSource): string | undefined;
+export {};
+//# sourceMappingURL=waferLabel.d.ts.map

package/dist/packages/core/waferLabel.js

@@ -0,0 +1 @@
+import{metadataDisplayValue as r}from"./metadata.js";export function waferDisplayLabel(a,e){return waferIdentityLabel(a)??`Wafer ${e+1} (no ID)`}export function waferIdentityLabel(a){return(a?.label?.trim()||void 0)??r(a?.wafer?.metadata?.waferId)}

package/dist/packages/renderer/binColors.d.ts

@@ -12,15 +12,26 @@ export interface BinColors {
     hard: Map<number, string>;
     soft: Map<number, string>;
     /**
-     * Bins drawn in a colour that another bin of the same type also has — the
-     * population has more pass or fail bins than the palette has colours, or a
-     * defined colour duplicates one. Empty when every bin is distinguishable by
-     * colour alone. Ascending bin number.
+     * Bins drawn in a colour that another bin of the same type also has — two
+     * bins present whose numbers land on the same palette slot (they differ by a
+     * multiple of the palette's length), or a defined colour that duplicates one.
+     * Empty when every bin is distinguishable by colour alone. Ascending bin number.
      */
     shared: {
         hard: number[];
         soft: number[];
     };
+    /**
+     * Bins that pass, per type — the verdict the colours were chosen with. Hard:
+     * the bins in `passBins`. Soft: bins whose every die passes. Read this, never
+     * `passBins`, to order, total or judge SOFT bins: `passBins` holds hard-bin
+     * numbers, so testing a soft bin against it treats soft bin 1 as a pass and
+     * soft bin 100 as a fail whatever their dies did.
+     */
+    pass: {
+        hard: Set<number>;
+        soft: Set<number>;
+    };
 }
 export interface BinColorOptions {
     /** Which bins pass. Default `[1]`. Must match the `passBins` behind the yield figure. */
@@ -40,26 +51,107 @@ export interface BinColorOptions {
  * Assign every bin present in `dies` a colour — the ONE rule for bin colour,
  * shared by the map, its legends, the summary panels and the Insights charts.
  *
- * Why not a function of the bin number, as it used to be:
  * - **Pass/fail comes from `passBins`, never the number.** Passing bins take
  *   the palette's pass colours (greens) and failing bins its fail colours, so
- *   with `passBins: [1, 3]` bin 3 is green and a failing bin 12 is not. Keying
- *   colour on the number made bin 1 green even when it failed.
- * - **Rank, not hash.** Bins are ordered by die count (then bin number) and
- *   take palette slots in that order, so the bins that dominate the map get
- *   the most distinct colours and no two bins collide until the palette is
- *   exhausted. Hashing collided from the start: two of the first sixteen soft
- *   bins shared a colour exactly.
+ *   with `passBins: [1, 3]` bin 3 is green and a failing bin 1 is not.
+ * - **Which colour is keyed by bin number, never by die count.** A pass bin
+ *   takes `pass[(bin − 1) mod n]` and a fail bin `fail[(bin − 2) mod n]`: bin 1
+ *   (the conventional pass bin) and bin 2 (the conventional first fail bin)
+ *   land on the front, most distinct colour of each list, and the low bin
+ *   numbers most programs use get the clearest colours. So bin 7 is the same
+ *   colour in every lot, gallery subset and screenshot of a program, which is
+ *   how engineers learn to read a bin map. This used to rank bins by die count,
+ *   which gave "the biggest fail bin" a colour rather than any bin — two lots of
+ *   one program drew the same bin in different colours. Before that it hashed
+ *   the number, which collided two of the first sixteen soft bins; a modular
+ *   index collides only at a palette's length apart, and `shared` names those.
+ * - **The slot counts from the bin number alone**, not its position among the
+ *   pass or fail bins, so changing `passBins` recolours only the bins whose
+ *   verdict changed.
  * - **Soft bins are pass-aware too.** A soft bin passes when every die
  *   carrying it passes (by the same per-die rule yield uses); otherwise, or
  *   when no die says, it takes a fail colour. The library has the data to
  *   decide, so the caller never supplies it.
+ * - **Soft bins read the palette shifted by half its length**, so hard bin n
+ *   and soft bin n are different colours by default. They are separate number
+ *   spaces and are never on screen together, but a shared colour invites
+ *   reading one as the other.
  *
  * A gallery resolves ONCE over every wafer it shows and hands the result to every
- * card (`ViewOptions.binColors`), so a bin is the same colour on every wafer.
+ * card (`ViewOptions.binColors`): a `BinDef.color` supplied by one item then
+ * colours that bin on every card, and `shared` describes the whole gallery.
  * A lone map resolves over its own dies.
  */
 export declare function resolveBinColors(dies: Iterable<Die>, options?: BinColorOptions): BinColors;
+/** The inputs a built map carries for its bin colours. A `WaferMapResult` is one. */
+export interface BinColorSource {
+    dies: Iterable<Die>;
+    /** The pass bins the map was built with (`WaferMapResult.passBins`). */
+    passBins?: readonly number[];
+    hbinDefs?: readonly BinDef[];
+    sbinDefs?: readonly BinDef[];
+}
+/** Display choices for `binColorsForMaps` — the palette and whether defined colours win. */
+export interface MapBinColorOptions {
+    /** Registered bin palette name (`registerBinColorScheme`). Default `'default'`. */
+    binColorScheme?: string;
+    /** Honour `BinDef.color`. Default true. */
+    useDefinedBinColors?: boolean;
+}
+/**
+ * The bin colours for one or more built maps — exactly the colours
+ * `renderWaferMap` and `renderWaferGallery` draw them in, for a host surface of
+ * its own: a table swatch, a PDF, a chart in another library.
+ *
+ * Takes the maps rather than dies and a `passBins` list, so pass/fail cannot be
+ * judged by the wrong bins: each map's dies are judged by that map's own
+ * `passBins`, and bin definitions (with any `BinDef.color`) are merged across the
+ * maps, first definition of a bin winning — the gallery's own rule. For a live
+ * map with the user's palette choice, read `WaferMapController.getBinColors()` or
+ * `GalleryController.getBinColors()` instead.
+ */
+export declare function binColorsForMaps(maps: BinColorSource | readonly BinColorSource[], options?: MapBinColorOptions): BinColors;
+/** @internal `binColorsForMaps` plus the hard bins that pass on some maps and fail on others. */
+export declare function resolveBinColorsForMaps(maps: readonly BinColorSource[], options?: MapBinColorOptions): {
+    colors: BinColors;
+    mixedHardBins: number[];
+};
+/**
+ * @internal Bin definitions merged across maps: one per bin, the first map's
+ * definition winning. The one rule for a multi-map legend, report or colouring.
+ */
+export declare function mergeBinDefs(lists: Iterable<readonly BinDef[] | undefined>): BinDef[];
+/** One wafer's dies and the pass bins that wafer was built with. */
+export interface BinPassGroup {
+    dies: Iterable<Die>;
+    /** Omitted ⇒ the input convention `[1]` — pass `WaferMapResult.passBins`. */
+    passBins?: readonly number[];
+}
+/**
+ * `resolveBinColors` over several wafers that may carry DIFFERENT pass bins — a
+ * gallery of wafers from more than one test program. Each die is judged by its
+ * own wafer's `passBins`, and a bin passes only when every die carrying it
+ * passes (for one wafer that is exactly "the bin is in `passBins`").
+ *
+ * `mixedHardBins` names hard bins that pass on some wafers and fail on others.
+ * One colour and one legend row cannot be right for both, so the gallery states
+ * it (`mixedPassBinsWarning`) rather than letting either wafer's verdict
+ * silently stand for all of them.
+ */
+export declare function resolveBinColorsByWafer(groups: Iterable<BinPassGroup>, options?: Omit<BinColorOptions, 'passBins'>): {
+    colors: BinColors;
+    mixedHardBins: number[];
+};
+/**
+ * Which hard and soft bins pass — `BinColors.pass` without the colours, for a
+ * caller that has dies but no resolved assignment (the summary report). The same
+ * tally `resolveBinColors` uses, so the two cannot disagree about a verdict.
+ */
+export declare function binPassSets(dies: Iterable<Die>, passBins?: readonly number[]): BinColors['pass'];
+/** `binPassSets` over wafers that each carry their own pass bins. */
+export declare function binPassSetsByWafer(groups: Iterable<BinPassGroup>): BinColors['pass'];
+/** The `pass-bins-mixed` advisory for `resolveBinColorsByWafer`'s `mixedHardBins`, or null. */
+export declare function mixedPassBinsWarning(bins: readonly number[]): WaferWarning | null;
 /**
  * True when `colors` has an entry for every bin on these dies — i.e. it was
  * resolved over a population that includes them. `buildView` checks this

package/dist/packages/renderer/binColors.js

@@ -1 +1 @@
-import{diePassStatus as p}from"../core/dies.js";import{getBinColorScheme as m}from"./colorSchemes.js";export function resolveBinColors(r,o={}){const s=new Set(o.passBins??[1]),i=m(o.binColorScheme),l=o.useDefinedBinColors??!0,a=new Map,f=new Map,c=new Map;for(const e of r)if(e.hbin!=null&&a.set(e.hbin,(a.get(e.hbin)??0)+1),e.sbin!=null){f.set(e.sbin,(f.get(e.sbin)??0)+1);const n=p(e,s)===!0;c.set(e.sbin,(c.get(e.sbin)??!0)&&n)}const d=b(a,e=>s.has(e),i,l?o.hbinDefs:void 0),h=b(f,e=>c.get(e)===!0,i,l?o.sbinDefs:void 0);return{hard:d.colors,soft:h.colors,shared:{hard:d.shared,soft:h.shared}}}export function binColorsCover(r,o){for(const s of o)if(s.hbin!=null&&!r.hard.has(s.hbin)||s.sbin!=null&&!r.soft.has(s.sbin))return!1;return!0}export function binColorWarning(r,o){const s=o==="softBin"?"soft":o==="hardBin"?"hard":null;if(!s)return null;const i=r.shared[s];if(!i.length)return null;const l=i.length>8?`${i.slice(0,8).join(", ")} and ${i.length-8} more`:i.join(", ");return{code:"bin-colors-shared",severity:"warning",message:`${s==="hard"?"Hard":"Soft"} bins ${l} are drawn in a colour another bin also has, so colour alone cannot tell them apart. There are more bins than the colour scheme has distinct colours (or a bin definition repeats one). Use the legend, the tooltip, or highlight one bin at a time.`}}function b(r,o,s,i){const l=new Map;for(const n of i??[])n.color&&l.set(n.bin,n.color);const a=new Map,f=[],c=[];for(const n of r.keys()){const t=l.get(n);t!==void 0?a.set(n,t):(o(n)?f:c).push(n)}const d=(n,t)=>r.get(t)-r.get(n)||n-t;for(const[n,t]of[[f,s.pass],[c,s.fail]])n.sort(d),n.forEach((u,g)=>a.set(u,t[g%t.length]));const h=new Map;for(const[n,t]of a){const u=t.toLowerCase();h.set(u,[...h.get(u)??[],n])}const e=[...h.values()].filter(n=>n.length>1).flat().sort((n,t)=>n-t);return{colors:a,shared:e}}
+import{diePassStatus as g}from"../core/dies.js";import{INPUT_DEFAULT_PASS_BINS as B,itemPassBins as m}from"../core/passBins.js";import{getBinColorScheme as w}from"./colorSchemes.js";export function resolveBinColors(s,n={}){return resolveBinColorsByWafer([{dies:s,passBins:n.passBins}],n).colors}export function binColorsForMaps(s,n={}){return resolveBinColorsForMaps(Array.isArray(s)?s:[s],n).colors}export function resolveBinColorsForMaps(s,n={}){return resolveBinColorsByWafer(s.map(e=>({dies:e.dies,passBins:m(e)})),{...n,hbinDefs:mergeBinDefs(s.map(e=>e.hbinDefs)),sbinDefs:mergeBinDefs(s.map(e=>e.sbinDefs))})}export function mergeBinDefs(s){const n=new Set,e=[];for(const a of s)for(const o of a??[])n.has(o.bin)||(n.add(o.bin),e.push(o));return e}export function resolveBinColorsByWafer(s,n={}){const e=w(n.binColorScheme),a=n.useDefinedBinColors??!0,o=h(s),f=b(o.hardBins,i=>o.pass.hard.has(i),e,a?n.hbinDefs:void 0,!1),t=b(o.softBins,i=>o.pass.soft.has(i),e,a?n.sbinDefs:void 0,!0);return{colors:{hard:f.colors,soft:t.colors,shared:{hard:f.shared,soft:t.shared},pass:o.pass},mixedHardBins:o.mixedHardBins}}export function binPassSets(s,n){return h([{dies:s,passBins:n}]).pass}export function binPassSetsByWafer(s){return h(s).pass}function h(s){const n=new Map,e=new Map,a=new Set;for(const t of s){const i=new Set(t.passBins??B);for(const l of t.dies){const r=g(l,i)===!0;l.hbin!=null&&(n.set(l.hbin,(n.get(l.hbin)??!0)&&r),r&&a.add(l.hbin)),l.sbin!=null&&e.set(l.sbin,(e.get(l.sbin)??!0)&&r)}}const o=t=>new Set([...t].filter(([,i])=>i).map(([i])=>i)),f={hard:o(n),soft:o(e)};return{hardBins:[...n.keys()],softBins:[...e.keys()],pass:f,mixedHardBins:[...a].filter(t=>!f.hard.has(t)).sort((t,i)=>t-i)}}function u(s){return s.length>8?`${s.slice(0,8).join(", ")} and ${s.length-8} more`:s.join(", ")}export function mixedPassBinsWarning(s){if(!s.length)return null;const n=s.length===1;return{code:"pass-bins-mixed",severity:"warning",message:`Hard ${n?"bin":"bins"} ${u(s)} ${n?"passes":"pass"} on some wafers and ${n?"fails":"fail"} on others: these wafers were built with different pass bins. Each wafer's own yield and die verdicts are correct, but a bin has one colour and one legend row, so ${n?"it is":"they are"} shown as failing there.`}}export function binColorsCover(s,n){if(!s.pass)return!1;for(const e of n)if(e.hbin!=null&&!s.hard.has(e.hbin)||e.sbin!=null&&!s.soft.has(e.sbin))return!1;return!0}export function binColorWarning(s,n){const e=n==="softBin"?"soft":n==="hardBin"?"hard":null;if(!e)return null;const a=s.shared[e];if(!a.length)return null;const o=u(a);return{code:"bin-colors-shared",severity:"warning",message:`${e==="hard"?"Hard":"Soft"} bins ${o} are drawn in a colour another bin also has, so colour alone cannot tell them apart. There are more bins than the colour scheme has distinct colours (or a bin definition repeats one). Use the legend, the tooltip, or highlight one bin at a time.`}}const S=1,x=2;function p(s,n,e,a){const o=s.length,f=a?Math.floor(o/2):0;return s[((n-e+f)%o+o)%o]}function b(s,n,e,a,o){const f=new Map;for(const r of a??[])r.color&&f.set(r.bin,r.color);const t=new Map;for(const r of s)t.set(r,f.get(r)??(n(r)?p(e.pass,r,S,o):p(e.fail,r,x,o)));const i=new Map;for(const[r,c]of t){const d=c.toLowerCase();i.set(d,[...i.get(d)??[],r])}const l=[...i.values()].filter(r=>r.length>1).flat().sort((r,c)=>r-c);return{colors:t,shared:l}}

package/dist/packages/renderer/buildView.d.ts

@@ -155,7 +155,7 @@ export interface View {
     allIntegerValues?: boolean;
     /** Named test definitions — populated when `testDefs` is passed to `buildWaferMap`. */
     testDefs?: TestDef[];
-    /** Which `values[]` index is being displayed (for `value` plot mode). Default 0. */
+    /** The test number being displayed in `value` plot mode — a `die.testValues` key, not a position. */
     activeTest: number;
     /** True when log₁₀ scale is both requested and valid (vMin > 0). */
     logScale: boolean;
@@ -217,8 +217,6 @@ export interface View {
      * - `'off'`  — continuous value gradient (or a non-value plot mode).
      */
     passFailDisplay: 'off' | 'spec' | 'test';
-    /** True when `passFailDisplay === 'spec'` — kept for back-compat with existing consumers. */
-    colorBySpec: boolean;
     /** Whether the colorbar range is anchored to spec limits ('spec') or data extents ('data'). */
     colorbarRangeMode: 'spec' | 'data';
     /** Wafer centre in scene/display mm coordinates (the rotation pivot). */
@@ -284,7 +282,6 @@ export interface ViewOptions {
     showRingBoundaries?: boolean;
     showQuadrantBoundaries?: boolean;
     showXYIndicator?: boolean;
-    dieGap?: number;
     /** Bin palette for `hardBin`/`softBin` — any name registered via `registerBinColorScheme()`. Default `'default'`. */
     binColorScheme?: string;
     /** Value gradient for `value` and the stacked modes — any name registered via `registerValueColorScheme()`. Default `'default'`. */
@@ -364,9 +361,10 @@ export interface ViewOptions {
      * Which bins count as passing. Default `[1]`.
      *
      * Sets `ViewRect.binFail` and decides which bins take the palette's pass
-     * colours (see `resolveBinColors`) — never the bin number. Must match the
-     * `passBins` given to `buildWaferMap` / `analyzeWaferMap`, or the map will
-     * disagree with the yield figure beside it.
+     * colours (see `resolveBinColors`) — never the bin number. `buildWaferMap` and
+     * the renderers set this from `WaferMapResult.passBins`, so a map agrees with
+     * its own yield figure; only a hand-rolled pipeline calling `buildView`
+     * directly supplies it.
      */
     passBins?: number[];
     /**
@@ -374,10 +372,11 @@ export interface ViewOptions {
      * Generated by `generateReticleGrid` or the `reticle` option on `buildWaferMap`.
      */
     reticles?: Reticle[];
-    /** Named test definitions — one per `values[]` entry. */
+    /** Named test definitions — one per test number in `die.testValues`. */
     testDefs?: TestDef[];
     /**
-     * Which `values[]` index to display in `value` plot mode. Default `0`.
+     * The test number to display in `value` plot mode — a `die.testValues` key
+     * (`TestDef.testNumber`), not a position. Default `0`.
      * When `testDefs` is provided, the toolbar mode dropdown offers one item per test.
      */
     activeTest?: number;