@wafertools/wafermap 0.27.0 → 0.28.0

package/dist/packages/stats/renderSummaryReport.js

@@ -1,21 +1,21 @@
-import{isParametricTest as me}from"../renderer/buildWaferMap.js";import{buildRingRegions as W,buildQuadrantRegions as k}from"./regions.js";import{openHtmlReport as pe}from"./renderFindingsReport.js";import{analyzeWaferLot as ge}from"./analyzeWaferLot.js";import{computeFunctionalYield as he}from"./analyzeWaferMap.js";import{sortBinsForDisplay as C}from"./binPareto.js";import{buildFacetTable as be,facetValueOf as ye,FACET_NONE_VALUE as Se}from"./facets.js";import{visibleFindings as H}from"./filterFindings.js";import{buildYieldDataCombined as we}from"./yield.js";import{buildTestPassRateData as $e,hasJudgeableTests as xe,poolFunctionalYield as ve}from"./testPassRate.js";import{buildCapabilityData as Te}from"./capability.js";import{fmt as B}from"../renderer/fmt.js";import{getDieKey as L,isPositionedDie as j}from"../core/dies.js";import{formatFindingDelta as Fe,formatFindingCoverage as De,formatFindingTooltip as Pe,escHtml as S,renderMetadataSection as I,renderMetricGrid as A,renderSection as v,renderSeverityBadge as Be,renderTable as F,reportStyles as R}from"./reportHtml.js";function Y(a,l){return l===0?"\u2014":`${(a/l*100).toFixed(1)}%`}function Ye(a){if(!a)return"";const l=a.lot??a.lotId,i=a.wafer??a.waferId,n=[l,i].filter(Boolean).map(String);return n.length?` \u2014 ${n.map(S).join(" \xB7 ")}`:""}function O(a,l,i,n,s=[1]){const e=new Map;if(n)for(const[t,c]of Object.entries(n))e.set(Number(t),c);else for(const t of a){if(t.partial||t.edgeExcluded)continue;const c=i==="hard"?t.hbin:t.sbin;c!=null&&e.set(c,(e.get(c)??0)+1)}if(!e.size)return"";const o=[...e.values()].reduce((t,c)=>t+c,0),r=l?new Map(l.map(t=>[t.bin,t])):null,d=C(e.entries(),s).map(([t,c])=>{const m=r?.get(t)?.name??"\u2014";return[String(t),m,String(c),Y(c,o)]});return v(i==="hard"?"Hard Bin Breakdown":"Soft Bin Breakdown",F(["Bin","Name","Count","%"],d,{className:"compact"}))}function z(a,l,i,n){const s=new Set(n),e=new Map(i.map(d=>[L(d),d]));if(!i.some(d=>d.hbin!=null||d.sbin!=null)||!l.length)return"";const r=[];for(const d of l){let u=0,t=0;for(const c of d.dieKeys){const g=e.get(c);if(!g||g.partial||g.edgeExcluded)continue;const m=g.hbin??g.sbin;m!=null&&(t++,s.has(m)&&u++)}t&&r.push([d.label,String(u),String(t),Y(u,t)])}return r.length?v(a,F(["Region","Pass","Total","Yield"],r,{className:"compact"})):""}function G(a,l,i){if(!l.length)return"";const n=a.filter(o=>!o.partial&&!o.edgeExcluded),s=new Map((i??[]).map(o=>[o.testNumber,o])),e=[];for(const o of l.filter(me)){const r=o.testNumber,d=o.unit||void 0,u=s.get(r);let t,c,g;if(u)({min:t,max:c,mean:g}=u);else{const m=n.map(w=>w.testValues?.[r]).filter(w=>w!==void 0&&isFinite(w));if(!m.length)continue;m.sort((w,p)=>w-p),t=m[0],c=m[m.length-1],g=m.reduce((w,p)=>w+p,0)/m.length}e.push([S(o.name),B(t,d),B(g,d),B(c,d)])}return e.length?v("Test Values",F(["Test","Min","Mean","Max"],e,{className:"compact"})):""}function K(a,l,i){const n=i??he(a,l);if(!n?.length)return"";const s=n.map(e=>[S(e.label),String(e.totalDies),String(e.passDies),String(e.failDies),e.passRatePercent!==null?`${e.passRatePercent.toFixed(1)}%`:"\u2014"]);return v("Functional Tests",F(["Test","N","Pass","Fail","Pass Rate"],s,{className:"compact"}))}function U(a,l){const i=Te(a,l);if(!i.length)return"";const n=e=>e===null?"\u2014":e.toFixed(2),s=i.map(e=>[S(e.label),e.hasSpec?`${B(e.lsl,e.unit)} \u2013 ${B(e.usl,e.unit)}`:"\u2014",B(e.mean,e.unit),n(e.cp),n(e.cpk),n(e.pp),n(e.ppk)]);return v("Process Capability",F(["Test","Spec (LSL\u2013USL)","Mean","Cp","Cpk","Pp","Ppk"],s,{className:"compact"}))}function V(a,l){const i=a.map(s=>`<tr title="${S(Pe(s))}">
-      <td class="tight">${Be(s.severity)}</td>
-      <td class="tight">${S(s.comparison.left)}</td>
-      <td>${S(s.variable.label)}</td>
-      <td class="numeric">${S(Fe(s))}</td>
-      <td class="numeric">${S(De(s,l))}</td>
+import{isParametricTest as ge}from"../renderer/buildWaferMap.js";import{buildRingRegions as E,buildQuadrantRegions as k}from"./regions.js";import{openHtmlReport as he}from"./renderFindingsReport.js";import{analyzeWaferLot as be}from"./analyzeWaferLot.js";import{computeFunctionalYield as ye}from"./analyzeWaferMap.js";import{sortBinsForDisplay as C}from"./binPareto.js";import{buildFacetTable as Se,facetValueOf as we,FACET_NONE_VALUE as $e}from"./facets.js";import{visibleFindings as H}from"./filterFindings.js";import{buildYieldDataCombined as xe}from"./yield.js";import{describeWaferPopulation as I,populationLabel as ve}from"./population.js";import{buildTestPassRateData as Te,hasJudgeableTests as Fe,poolFunctionalYield as De}from"./testPassRate.js";import{buildCapabilityData as Pe}from"./capability.js";import{fmt as B}from"../renderer/fmt.js";import{getDieKey as L,isPositionedDie as j}from"../core/dies.js";import{formatFindingDelta as Be,formatFindingCoverage as Ye,formatFindingTooltip as Me,escHtml as S,renderMetadataSection as A,renderMetricGrid as O,renderSection as v,renderSeverityBadge as Ne,renderTable as F,reportStyles as W}from"./reportHtml.js";function Y(s,l){return l===0?"\u2014":`${(s/l*100).toFixed(1)}%`}function We(s){if(!s)return"";const l=s.lot??s.lotId,i=s.wafer??s.waferId,n=[l,i].filter(Boolean).map(String);return n.length?` \u2014 ${n.map(S).join(" \xB7 ")}`:""}function z(s,l,i,n,a=[1]){const e=new Map;if(n)for(const[t,c]of Object.entries(n))e.set(Number(t),c);else for(const t of s){if(t.partial||t.edgeExcluded)continue;const c=i==="hard"?t.hbin:t.sbin;c!=null&&e.set(c,(e.get(c)??0)+1)}if(!e.size)return"";const o=[...e.values()].reduce((t,c)=>t+c,0),r=l?new Map(l.map(t=>[t.bin,t])):null,d=C(e.entries(),a).map(([t,c])=>{const m=r?.get(t)?.name??"\u2014";return[String(t),m,String(c),Y(c,o)]});return v(i==="hard"?"Hard Bin Breakdown":"Soft Bin Breakdown",F(["Bin","Name","Count","%"],d,{className:"compact"}))}function G(s,l,i,n){const a=new Set(n),e=new Map(i.map(d=>[L(d),d]));if(!i.some(d=>d.hbin!=null||d.sbin!=null)||!l.length)return"";const r=[];for(const d of l){let u=0,t=0;for(const c of d.dieKeys){const b=e.get(c);if(!b||b.partial||b.edgeExcluded)continue;const m=b.hbin??b.sbin;m!=null&&(t++,a.has(m)&&u++)}t&&r.push([d.label,String(u),String(t),Y(u,t)])}return r.length?v(s,F(["Region","Pass","Total","Yield"],r,{className:"compact"})):""}function K(s,l,i){if(!l.length)return"";const n=s.filter(o=>!o.partial&&!o.edgeExcluded),a=new Map((i??[]).map(o=>[o.testNumber,o])),e=[];for(const o of l.filter(ge)){const r=o.testNumber,d=o.unit||void 0,u=a.get(r);let t,c,b;if(u)({min:t,max:c,mean:b}=u);else{const m=n.map(w=>w.testValues?.[r]).filter(w=>w!==void 0&&isFinite(w));if(!m.length)continue;m.sort((w,p)=>w-p),t=m[0],c=m[m.length-1],b=m.reduce((w,p)=>w+p,0)/m.length}e.push([S(o.name),B(t,d),B(b,d),B(c,d)])}return e.length?v("Test Values",F(["Test","Min","Mean","Max"],e,{className:"compact"})):""}function U(s,l,i){const n=i??ye(s,l);if(!n?.length)return"";const a=n.map(e=>[S(e.label),String(e.totalDies),String(e.passDies),String(e.failDies),e.passRatePercent!==null?`${e.passRatePercent.toFixed(1)}%`:"\u2014"]);return v("Functional Tests",F(["Test","N","Pass","Fail","Pass Rate"],a,{className:"compact"}))}function V(s,l){const i=Pe(s,l);if(!i.length)return"";const n=e=>e===null?"\u2014":e.toFixed(2),a=i.map(e=>[S(e.label),e.hasSpec?`${B(e.lsl,e.unit)} \u2013 ${B(e.usl,e.unit)}`:"\u2014",B(e.mean,e.unit),n(e.cp),n(e.cpk),n(e.pp),n(e.ppk)]);return v("Process Capability",F(["Test","Spec (LSL\u2013USL)","Mean","Cp","Cpk","Pp","Ppk"],a,{className:"compact"}))}function _(s,l){const i=s.map(a=>`<tr title="${S(Me(a))}">
+      <td class="tight">${Ne(a.severity)}</td>
+      <td class="tight">${S(a.comparison.left)}</td>
+      <td>${S(a.variable.label)}</td>
+      <td class="numeric">${S(Be(a))}</td>
+      <td class="numeric">${S(Ye(a,l))}</td>
     </tr>`).join(`
 `);return`<table class="report-table findings-table compact"><thead><tr>
     <th>Severity</th><th>Region</th><th>Metric</th><th class="numeric">Delta</th><th class="numeric">${l!==void 0?"Wafers":"N (region/rest)"}</th>
-  </tr></thead><tbody>${i}</tbody></table>`}function _(a,l){const i=H(a);return i.length?v("Findings",V(i,l)):""}export function renderSummaryReportHtml(a,l={}){const{wafer:i,dies:n,yieldSummary:s,dataCoverage:e,hbinDefs:o,sbinDefs:r,testDefs:d=[],statsSummary:u,passBins:t=[1],ringCount:c=4}=a,g=i.metadata,m=Ye(g),w=l.title??`Wafer Summary${m}`,p=new Date().toLocaleString(),f=n.some(P=>P.hbin!=null),b=n.some(P=>P.sbin!=null),h=n.filter(j),$=W(h,i,c),x=k(h,i,c),T=[{label:"Total dies",value:String(s.totalDies)},{label:"Filled dies",value:String(e.filledDies),hint:`${Y(e.filledDies,e.totalDies)} fill`},{label:"Pass dies",value:String(s.passDies)},{label:"Fail dies",value:String(s.failDies)},...s.partialDies>0?[{label:"Partial",value:String(s.partialDies)}]:[],...s.yieldPercent!==null?[{label:`Yield (pass: ${t.length===1?`bin ${t[0]}`:`bins ${t.join(", ")}`})`,value:`${s.yieldPercent.toFixed(1)}%`}]:[],...s.edgeExcludedDies>0?[{label:"Edge excluded (outer zone)",value:String(s.edgeExcludedDies)}]:[]],N=[I([{metadata:i.metadata}]),v("Summary",[A(T)].filter(Boolean).join(`
-`)),f?O(n,o,"hard",u?.stats.hardBinCounts,t):b?O(n,r,"soft",u?.stats.softBinCounts,t):"",z("Ring Yield",$,n,t),z("Quadrant Yield",x,n,t),G(n,d,u?.stats.perTestStats),K(n,d,u?.stats.functionalYield),U([{dies:n}],d),u?_(u.findings):""].filter(Boolean).join(`
+  </tr></thead><tbody>${i}</tbody></table>`}function Q(s,l){const i=H(s);return i.length?v("Findings",_(i,l)):""}export function renderSummaryReportHtml(s,l={}){const{wafer:i,dies:n,yieldSummary:a,dataCoverage:e,hbinDefs:o,sbinDefs:r,testDefs:d=[],statsSummary:u,passBins:t=[1],ringCount:c=4}=s,b=i.metadata,m=We(b),w=l.title??`Wafer Summary${m}`,p=new Date().toLocaleString(),f=n.some(P=>P.hbin!=null),g=n.some(P=>P.sbin!=null),y=n.filter(j),$=E(y,i,c),x=k(y,i,c),T=[{label:"Total dies",value:String(a.totalDies)},{label:"Filled dies",value:String(e.filledDies),hint:`${Y(e.filledDies,e.totalDies)} fill`},{label:"Pass dies",value:String(a.passDies)},{label:"Fail dies",value:String(a.failDies)},...a.partialDies>0?[{label:"Partial",value:String(a.partialDies)}]:[],...a.yieldPercent!==null?[{label:`Yield (pass: ${t.length===1?`bin ${t[0]}`:`bins ${t.join(", ")}`})`,value:`${a.yieldPercent.toFixed(1)}%`}]:[],...a.edgeExcludedDies>0?[{label:"Edge excluded (outer zone)",value:String(a.edgeExcludedDies)}]:[]],N=[A([{metadata:i.metadata}]),v("Summary",[O(T)].filter(Boolean).join(`
+`)),f?z(n,o,"hard",u?.stats.hardBinCounts,t):g?z(n,r,"soft",u?.stats.softBinCounts,t):"",G("Ring Yield",$,n,t),G("Quadrant Yield",x,n,t),K(n,d,u?.stats.perTestStats),U(n,d,u?.stats.functionalYield),V([{dies:n}],d),u?Q(u.findings):""].filter(Boolean).join(`
 `);return`<!DOCTYPE html>
 <html lang="en">
 <head>
 <meta charset="UTF-8">
 <title>${S(w)}</title>
 <style>
-${R()}
+${W()}
 </style>
 </head>
 <body>
@@ -28,30 +28,30 @@ ${R()}
   <p class="footer">Generated ${S(p)}</p>
 </main>
 </body>
-</html>`}function Me(a,l){const i=a.perWafer.map(n=>{const s=l[n.waferIndex]?.label??`W${n.waferIndex+1}`,e=n.summary.stats.yieldPercent;return[s,e!==null?`${e.toFixed(1)}%`:"N/A"]});return F(["Wafer","Yield"],i,{className:"compact"})}function Ne(a){const l=[];for(const e of a.perWafer){const o=H(e.summary.findings);if(!o.length)continue;const r=e.summary.wafer?.waferId??`Wafer ${e.waferIndex+1}`;l.push(`<h3 class="report-subheading">${S(r)}</h3>`+V(o))}if(!l.length)return"";const i=l.length,n=a.perWafer.length,s=`<p class="report-note">${i} of ${n} wafer${n===1?"":"s"} have per-wafer findings; the rest had none.</p>`;return v("Findings by Wafer",s+l.join(`
-`))}const Re=3;function Ee(a,l,i){const n=a.map(d=>({metadata:d.wafer?.metadata})),s=be(n,{facetableOnly:!0}).filter(d=>d.splittable);if(!s.length)return"";const e=s.slice(0,Re),o=[];for(const d of e){const u=new Map;a.forEach((f,b)=>{const h=ye(f.wafer?.metadata,d.key)??Se;(u.get(h)??u.set(h,[]).get(h)).push(b)});const t=[...u.entries()].map(([f,b])=>({key:f,items:b.map(h=>a[h])}));if(t.length<2)continue;const c=t.map(f=>[S(f.key),S(f.items.map(b=>b.label).join(", "))]),g=we(t.map(f=>({key:f.key,items:f.items.map(b=>({label:b.label,dies:b.dies}))})),i).map(f=>[S(f.label),String(f.itemCount),`${f.percent.toFixed(1)}%`]),m=[F([d.label,"Wafers"],c,{className:"compact"}),F([d.label,"Wafers","Yield"],g,{className:"compact"})],w=a.flatMap(f=>f.dies??[]);let p=0;for(const f of["spec","testFlag","functional"]){if(!xe(l,f,w))continue;const b=$e(t.map(x=>({key:x.key,items:x.items.map(T=>({dies:T.dies,testSpecYield:T.statsSummary?.stats.testSpecYield,functionalYield:T.statsSummary?.stats.functionalYield}))})),l,f);if(!b.rows.length)continue;const h=b.rows.map(x=>[S(x.label),...x.byGroup.map(T=>T.passRatePercent===null?"\u2014":`${T.passRatePercent.toFixed(1)}%`),x.overall.passRatePercent===null?"\u2014":`${x.overall.passRatePercent.toFixed(1)}%`]),$=f==="spec"?"Pass rate \xB7 spec limits":f==="testFlag"?"Pass rate \xB7 tester flag":"Pass rate \xB7 functional";b.disagreementDies&&(p=b.disagreementDies),m.push(`<h4 class="report-subheading">${S($)}</h4>`+F(["Test",...b.groups,"All"],h,{className:"compact"}))}p&&m.push(`<p class="report-note">${p.toLocaleString()} dies judged differently by limits and tester flag.</p>`),o.push(`<h3 class="report-subheading">${S(d.label)}</h3>${m.join(`
-`)}`)}if(!o.length)return"";const r=s.length>e.length?`<p class="report-note">${s.length-e.length} further splittable field(s) not shown.</p>`:"";return v("Split Comparison",o.join(`
-`)+r)}function Q(a,l,i,n,s=[1]){const e=new Map,o=i==="hard"?"hardBinCounts":"softBinCounts";if(n?.length&&n.every(t=>t.stats[o]!==void 0))for(const t of n)for(const[c,g]of Object.entries(t.stats[o])){const m=Number(c);e.set(m,(e.get(m)??0)+g)}else for(const t of a){if(t.partial||t.edgeExcluded)continue;const c=i==="hard"?t.hbin:t.sbin;c!=null&&e.set(c,(e.get(c)??0)+1)}if(!e.size)return"";const r=[...e.values()].reduce((t,c)=>t+c,0),d=l?new Map(l.map(t=>[t.bin,t])):null,u=C(e.entries(),s).map(([t,c])=>{const g=d?.get(t);return[g?.name?`Bin ${t} \xB7 ${g.name} (${c})`:`Bin ${t} (${c})`,Y(c,r)]});return v(i==="hard"?"Hard Bin Breakdown (All Wafers)":"Soft Bin Breakdown (All Wafers)",F(["Bin","Yield"],u,{className:"compact"}))}function q(a,l,i,n,s,e){const o=new Set(e),r=new Map,d=[];for(let t=0;t<n.length;t++){const c=n[t],g=i[t]??[];if(!g.length)continue;const m=l(g.filter(j),c,s),w=new Map(g.map(p=>[L(p),p]));for(const p of m){d.includes(p.label)||d.push(p.label);const f=r.get(p.label)??{pass:0,total:0};for(const b of p.dieKeys){const h=w.get(b);if(!h||h.partial||h.edgeExcluded)continue;const $=h.hbin??h.sbin;$!=null&&(f.total++,o.has($)&&f.pass++)}r.set(p.label,f)}}if(!r.size)return"";const u=d.filter(t=>r.get(t)?.total).map(t=>{const c=r.get(t);return[t,Y(c.pass,c.total)]});return u.length?v(a,F(["Region","Yield"],u,{className:"compact"})):""}function We(a,l,i){let n;if(i?.length&&i.every(s=>s.stats.perTestStats!==void 0)){const s=new Map;for(const e of i)for(const o of e.stats.perTestStats??[]){const r=s.get(o.testNumber);r?(r.n+=o.count,r.sum+=o.mean*o.count,r.min=Math.min(r.min,o.min),r.max=Math.max(r.max,o.max)):s.set(o.testNumber,{n:o.count,sum:o.mean*o.count,min:o.min,max:o.max})}n=[...s.entries()].map(([e,o])=>({testNumber:e,min:o.min,max:o.max,mean:o.sum/o.n}))}return G(a,l,n)}function ke(a,l,i){const n=ve(i);return K(a,l,n)}const E=["lot","product","testProgram","temperature"];function Ce(a){const l=new Map(E.map(e=>[e,new Set]));for(const e of a)for(const o of E){const r=e.wafer?.metadata?.[o];r!=null&&r!==""&&l.get(o).add(String(r))}const i=E.filter(e=>l.get(e).size>1);if(i.length===0)return[{label:"",items:a,varying:i}];const n=new Map,s=[];for(const e of a){const o=i.map(r=>String(e.wafer?.metadata?.[r]??"(none)")).join(" \xB7 ");n.has(o)||(n.set(o,[]),s.push(o)),n.get(o).push(e)}return s.map(e=>({label:e,items:n.get(e),varying:i}))}function J(a,l,i,n,s,e,o){const r=ge(a,{perWaferSummaries:a.map(y=>y.statsSummary),...o}),d=[],u=[],t=[];for(const y of a){const D=y.dies??[];y.wafer&&(d.push(y.wafer),t.push(D)),D.length&&u.push(...D)}const c=u.some(y=>y.hbin!=null),g=u.some(y=>y.sbin!=null),m=c||g,w=r.perWafer.map(y=>y.summary.stats.yieldPercent).filter(y=>y!==null),p=w.length?w.reduce((y,D)=>y+D,0)/w.length:null,f=new Set(s);let b=0,h=0,$=0,x=0,T=0;for(const y of u){if(b++,y.edgeExcluded&&x++,y.partial&&T++,y.partial||y.edgeExcluded)continue;const D=y.hbin??y.sbin;D!=null&&(h++,f.has(D)&&$++)}const N=h-$,P=h>0?$/h*100:null,Z=[{label:"Wafers",value:String(r.stats.waferCount)},{label:"Total dies",value:String(b)},...m?[{label:"Good dies",value:String($)},{label:"Bad dies",value:String(N)}]:[],...x>0?[{label:"Edge excluded",value:String(x)}]:[],...T>0?[{label:"Partial dies",value:String(T)}]:[],...p!==null?[{label:"Mean wafer yield",value:`${p.toFixed(1)}%`}]:[],...P!==null?[{label:"Total yield",value:`${P.toFixed(1)}%`}]:[]],ee=v("Lot Summary",A(Z)),te=I(a.map(y=>({metadata:y.wafer?.metadata}))),ne=v("Per-Wafer Yield",Me(r,a)),se=Ee(a,n,s),M=r.perWafer.map(y=>y.summary),ae=m?c?Q(u,l,"hard",M,s):Q(u,i,"soft",M,s):"",oe=m&&d.length?q("Ring Yield (All Wafers)",W,t,d,e,s):"",ie=m&&d.length?q("Quadrant Yield (All Wafers)",k,t,d,e,s):"",le=n.length?We(u,n,M):"",re=n.length?ke(u,n,M):"",ce=n.length?U(a,n):"",de=r.findings.length?_(r.findings,r.stats.waferCount):"",ue=Ne(r),fe=[ee,te,ne,se,ae,oe,ie,le,re,ce,de,ue].filter(Boolean).join(`
-`);return{lotSummary:r,sections:fe}}function X(a,l,i){return`<main class="report">
+</html>`}function Re(s,l){const i=s.perWafer.map(n=>{const a=l[n.waferIndex]?.label??`W${n.waferIndex+1}`,e=n.summary.stats.yieldPercent;return[a,e!==null?`${e.toFixed(1)}%`:"N/A"]});return F(["Wafer","Yield"],i,{className:"compact"})}function Ee(s){const l=[];for(const e of s.perWafer){const o=H(e.summary.findings);if(!o.length)continue;const r=e.summary.wafer?.waferId??`Wafer ${e.waferIndex+1}`;l.push(`<h3 class="report-subheading">${S(r)}</h3>`+_(o))}if(!l.length)return"";const i=l.length,n=s.perWafer.length,a=`<p class="report-note">${i} of ${n} wafer${n===1?"":"s"} have per-wafer findings; the rest had none.</p>`;return v("Findings by Wafer",a+l.join(`
+`))}const ke=3;function Ce(s,l,i){const n=s.map(d=>({metadata:d.wafer?.metadata})),a=Se(n,{facetableOnly:!0}).filter(d=>d.splittable);if(!a.length)return"";const e=a.slice(0,ke),o=[];for(const d of e){const u=new Map;s.forEach((f,g)=>{const y=we(f.wafer?.metadata,d.key)??$e;(u.get(y)??u.set(y,[]).get(y)).push(g)});const t=[...u.entries()].map(([f,g])=>({key:f,items:g.map(y=>s[y])}));if(t.length<2)continue;const c=t.map(f=>[S(f.key),S(f.items.map(g=>g.label).join(", "))]),b=xe(t.map(f=>({key:f.key,items:f.items.map(g=>({label:g.label,dies:g.dies}))})),i).map(f=>[S(f.label),String(f.itemCount),`${f.percent.toFixed(1)}%`]),m=[F([d.label,"Wafers"],c,{className:"compact"}),F([d.label,"Wafers","Yield"],b,{className:"compact"})],w=s.flatMap(f=>f.dies??[]);let p=0;for(const f of["spec","testFlag","functional"]){if(!Fe(l,f,w))continue;const g=Te(t.map(x=>({key:x.key,items:x.items.map(T=>({dies:T.dies,testSpecYield:T.statsSummary?.stats.testSpecYield,functionalYield:T.statsSummary?.stats.functionalYield}))})),l,f);if(!g.rows.length)continue;const y=g.rows.map(x=>[S(x.label),...x.byGroup.map(T=>T.passRatePercent===null?"\u2014":`${T.passRatePercent.toFixed(1)}%`),x.overall.passRatePercent===null?"\u2014":`${x.overall.passRatePercent.toFixed(1)}%`]),$=f==="spec"?"Pass rate \xB7 spec limits":f==="testFlag"?"Pass rate \xB7 tester flag":"Pass rate \xB7 functional";g.disagreementDies&&(p=g.disagreementDies),m.push(`<h4 class="report-subheading">${S($)}</h4>`+F(["Test",...g.groups,"All"],y,{className:"compact"}))}p&&m.push(`<p class="report-note">${p.toLocaleString()} dies judged differently by limits and tester flag.</p>`),o.push(`<h3 class="report-subheading">${S(d.label)}</h3>${m.join(`
+`)}`)}if(!o.length)return"";const r=a.length>e.length?`<p class="report-note">${a.length-e.length} further splittable field(s) not shown.</p>`:"";return v("Split Comparison",o.join(`
+`)+r)}function q(s,l,i,n,a=[1]){const e=new Map,o=i==="hard"?"hardBinCounts":"softBinCounts";if(n?.length&&n.every(t=>t.stats[o]!==void 0))for(const t of n)for(const[c,b]of Object.entries(t.stats[o])){const m=Number(c);e.set(m,(e.get(m)??0)+b)}else for(const t of s){if(t.partial||t.edgeExcluded)continue;const c=i==="hard"?t.hbin:t.sbin;c!=null&&e.set(c,(e.get(c)??0)+1)}if(!e.size)return"";const r=[...e.values()].reduce((t,c)=>t+c,0),d=l?new Map(l.map(t=>[t.bin,t])):null,u=C(e.entries(),a).map(([t,c])=>{const b=d?.get(t);return[b?.name?`Bin ${t} \xB7 ${b.name} (${c})`:`Bin ${t} (${c})`,Y(c,r)]});return v(i==="hard"?"Hard Bin Breakdown (All Wafers)":"Soft Bin Breakdown (All Wafers)",F(["Bin","Yield"],u,{className:"compact"}))}function J(s,l,i,n,a,e){const o=new Set(e),r=new Map,d=[];for(let t=0;t<n.length;t++){const c=n[t],b=i[t]??[];if(!b.length)continue;const m=l(b.filter(j),c,a),w=new Map(b.map(p=>[L(p),p]));for(const p of m){d.includes(p.label)||d.push(p.label);const f=r.get(p.label)??{pass:0,total:0};for(const g of p.dieKeys){const y=w.get(g);if(!y||y.partial||y.edgeExcluded)continue;const $=y.hbin??y.sbin;$!=null&&(f.total++,o.has($)&&f.pass++)}r.set(p.label,f)}}if(!r.size)return"";const u=d.filter(t=>r.get(t)?.total).map(t=>{const c=r.get(t);return[t,Y(c.pass,c.total)]});return u.length?v(s,F(["Region","Yield"],u,{className:"compact"})):""}function He(s,l,i){let n;if(i?.length&&i.every(a=>a.stats.perTestStats!==void 0)){const a=new Map;for(const e of i)for(const o of e.stats.perTestStats??[]){const r=a.get(o.testNumber);r?(r.n+=o.count,r.sum+=o.mean*o.count,r.min=Math.min(r.min,o.min),r.max=Math.max(r.max,o.max)):a.set(o.testNumber,{n:o.count,sum:o.mean*o.count,min:o.min,max:o.max})}n=[...a.entries()].map(([e,o])=>({testNumber:e,min:o.min,max:o.max,mean:o.sum/o.n}))}return K(s,l,n)}function Ie(s,l,i){const n=De(i);return U(s,l,n)}const R=["lot","product","testProgram","temperature"];function Le(s){const l=new Map(R.map(e=>[e,new Set]));for(const e of s)for(const o of R){const r=e.wafer?.metadata?.[o];r!=null&&r!==""&&l.get(o).add(String(r))}const i=R.filter(e=>l.get(e).size>1);if(i.length===0)return[{label:"",items:s,varying:i}];const n=new Map,a=[];for(const e of s){const o=i.map(r=>String(e.wafer?.metadata?.[r]??"(none)")).join(" \xB7 ");n.has(o)||(n.set(o,[]),a.push(o)),n.get(o).push(e)}return a.map(e=>({label:e,items:n.get(e),varying:i}))}function X(s,l,i,n,a,e,o){const r=be(s,{perWaferSummaries:s.map(h=>h.statsSummary),...o}),d=[],u=[],t=[];for(const h of s){const D=h.dies??[];h.wafer&&(d.push(h.wafer),t.push(D)),D.length&&u.push(...D)}const c=u.some(h=>h.hbin!=null),b=u.some(h=>h.sbin!=null),m=c||b,w=r.perWafer.map(h=>h.summary.stats.yieldPercent).filter(h=>h!==null),p=w.length?w.reduce((h,D)=>h+D,0)/w.length:null,f=new Set(a);let g=0,y=0,$=0,x=0,T=0;for(const h of u){if(g++,h.edgeExcluded&&x++,h.partial&&T++,h.partial||h.edgeExcluded)continue;const D=h.hbin??h.sbin;D!=null&&(y++,f.has(D)&&$++)}const N=y-$,P=y>0?$/y*100:null,ee=[{label:"Wafers",value:String(r.stats.waferCount)},{label:"Total dies",value:String(g)},...m?[{label:"Good dies",value:String($)},{label:"Bad dies",value:String(N)}]:[],...x>0?[{label:"Edge excluded",value:String(x)}]:[],...T>0?[{label:"Partial dies",value:String(T)}]:[],...p!==null?[{label:"Mean wafer yield",value:`${p.toFixed(1)}%`}]:[],...P!==null?[{label:"Total yield",value:`${P.toFixed(1)}%`}]:[]],te=I(r.perWafer.map(h=>h.summary.wafer)),ne=v(te.lotId!==void 0?"Lot Summary":"Summary",O(ee)),ae=A(s.map(h=>({metadata:h.wafer?.metadata}))),se=v("Per-Wafer Yield",Re(r,s)),oe=Ce(s,n,a),M=r.perWafer.map(h=>h.summary),ie=m?c?q(u,l,"hard",M,a):q(u,i,"soft",M,a):"",le=m&&d.length?J("Ring Yield (All Wafers)",E,t,d,e,a):"",re=m&&d.length?J("Quadrant Yield (All Wafers)",k,t,d,e,a):"",ce=n.length?He(u,n,M):"",de=n.length?Ie(u,n,M):"",ue=n.length?V(s,n):"",fe=r.findings.length?Q(r.findings,r.stats.waferCount):"",me=Ee(r),pe=[ne,ae,se,oe,ie,le,re,ce,de,ue,fe,me].filter(Boolean).join(`
+`);return{lotSummary:r,sections:pe}}function Z(s,l,i){return`<main class="report">
   <header class="report-header">
-    <h1>${S(a)}</h1>
+    <h1>${S(s)}</h1>
     <p class="report-subtitle">Generated ${S(i)}</p>
   </header>
   ${l}
   <p class="footer">Generated ${S(i)}</p>
-</main>`}export function renderLotSummaryReportHtml(a,l={}){const{items:i,hbinDefs:n,sbinDefs:s,testDefs:e=[],passBins:o=[1],ringCount:r=4,analyzeOptions:d}=a,u=new Date().toLocaleString(),t=Ce(i);if(t.length===1){const{lotSummary:p,sections:f}=J(t[0].items,n,s,e,o,r,d),b=(()=>{const $=p.lot;if(!$)return"";const x=$.lot??$.lotId;return x?` \u2014 ${S(String(x))}`:""})(),h=l.title??`Lot Summary${b}`;return`<!DOCTYPE html>
+</main>`}export function renderLotSummaryReportHtml(s,l={}){const{items:i,hbinDefs:n,sbinDefs:a,testDefs:e=[],passBins:o=[1],ringCount:r=4,analyzeOptions:d}=s,u=new Date().toLocaleString(),t=Le(i);if(t.length===1){const{lotSummary:p,sections:f}=X(t[0].items,n,a,e,o,r,d),g=I(p.perWafer.map($=>$.summary.wafer)),y=l.title??(g.lotId!==void 0?`Lot Summary \u2014 ${g.lotId}`:`Summary \u2014 ${ve(g)}`);return`<!DOCTYPE html>
 <html lang="en">
 <head>
 <meta charset="UTF-8">
-<title>${S(h)}</title>
+<title>${S(y)}</title>
 <style>
-${R()}
+${W()}
 </style>
 </head>
 <body>
-${X(h,f,u)}
+${Z(y,f,u)}
 </body>
-</html>`}const c=l.title??"Lot Summary",g=t.map(p=>{const{lotSummary:f,sections:b}=J(p.items,n,s,e,o,r,d),h=p.varying.includes("lot")?void 0:f.lot?.lot??f.lot?.lotId,$=h?`${p.label} \xB7 Lot ${String(h)}`:p.label;return X(`${c} \u2014 ${$}`,b,u)}),m=`<p style="max-width:1080px;margin:0 auto 8px;padding:8px 12px;background:var(--report-surface);border:1px solid var(--report-line);border-radius:4px;font-size:12px;color:var(--report-muted);">This load spans ${t.length} groups by identity \u2014 shown separately below so stats are never pooled across them.</p>`,w=g.map((p,f)=>`${f===0?"":'<hr style="max-width:1080px;margin:32px auto 0;border:none;border-top:3px solid var(--report-line-strong);">'}
+</html>`}const c=l.title??"Summary",b=t.map(p=>{const{lotSummary:f,sections:g}=X(p.items,n,a,e,o,r,d),y=p.varying.includes("lot")?void 0:f.lot?.lot??f.lot?.lotId,$=y?`${p.label} \xB7 Lot ${String(y)}`:p.label;return Z(`${c} \u2014 ${$}`,g,u)}),m=`<p style="max-width:1080px;margin:0 auto 8px;padding:8px 12px;background:var(--report-surface);border:1px solid var(--report-line);border-radius:4px;font-size:12px;color:var(--report-muted);">This load spans ${t.length} groups by identity \u2014 shown separately below so stats are never pooled across them.</p>`,w=b.map((p,f)=>`${f===0?"":'<hr style="max-width:1080px;margin:32px auto 0;border:none;border-top:3px solid var(--report-line-strong);">'}
 ${p}`).join(`
 `);return`<!DOCTYPE html>
 <html lang="en">
@@ -59,7 +59,7 @@ ${p}`).join(`
 <meta charset="UTF-8">
 <title>${S(c)}</title>
 <style>
-${R()}
+${W()}
 </style>
 </head>
 <body>
@@ -68,4 +68,4 @@ ${m}
 </div>
 ${w}
 </body>
-</html>`}export{pe as openHtmlReport};
+</html>`}export{he as openHtmlReport};

package/dist/packages/stats/yield.js

@@ -1 +1 @@
-import{isYieldEligibleDie as d}from"../core/dies.js";import{compareNatural as b}from"../core/utils.js";function p(e,n){let i=0,t=0;for(const l of e){if(!d(l))continue;const o=l.hbin??l.sbin;o!==void 0&&(t++,n.includes(o)&&i++)}return t>0?i/t*100:0}function s(e,n){return e.yieldPercent!==void 0?e.yieldPercent??0:p(e.dies??[],n)}function m(e){let n=0;for(const i of e)d(i)&&n++;return n}function f(e,n){n==="yield"?e.sort((i,t)=>t.value-i.value):e.sort((i,t)=>b(i.label,t.label))}export function buildYieldData(e,n=[1],i="label"){const t=e.map((l,o)=>{const r=s(l,n);return{label:l.label??`#${o}`,value:r,percent:r,itemCount:1,key:l.key}});return f(t,i),t}export function buildYieldDataCombined(e,n=[1],i="label"){const t=e.map(l=>{let o=0,r=0;for(const c of l.items){const a=m(c.dies??[]);o+=s(c,n)*a,r+=a}const u=r>0?o/r:0;return{label:l.key,value:u,percent:u,itemCount:l.items.length}});return f(t,i),t}
+import{isYieldEligibleDie as c,diePassStatus as p}from"../core/dies.js";import{compareNatural as b}from"../core/utils.js";function m(e,n){let i=0,t=0;const l=new Set(n);for(const r of e){if(!c(r))continue;const o=p(r,l);o!==void 0&&(t++,o&&i++)}return t>0?i/t*100:0}function d(e,n){return e.yieldPercent!==void 0?e.yieldPercent??0:m(e.dies??[],n)}function y(e){let n=0;for(const i of e)c(i)&&n++;return n}function f(e,n){n==="yield"?e.sort((i,t)=>t.value-i.value):e.sort((i,t)=>b(i.label,t.label))}export function buildYieldData(e,n=[1],i="label"){const t=e.map((l,r)=>{const o=d(l,n);return{label:l.label??`#${r}`,value:o,percent:o,itemCount:1,key:l.key}});return f(t,i),t}export function buildYieldDataCombined(e,n=[1],i="label"){const t=e.map(l=>{let r=0,o=0;for(const a of l.items){const s=y(a.dies??[]);r+=d(a,n)*s,o+=s}const u=o>0?r/o:0;return{label:l.key,value:u,percent:u,itemCount:l.items.length}});return f(t,i),t}

package/package.json

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