@wafertools/wafermap 0.26.1 → 0.28.0

package/dist/packages/stats/histogram.js

@@ -1 +1 @@
-export function buildTestHistogramData(g,M,a=16,m,h){const n=[];for(const e of g)for(const i of e.dies??[]){const t=i.testValues?.[M];t!==void 0&&Number.isFinite(t)&&n.push(t)}if(n.length===0)return[];let s=n[0],o=n[0];for(let e=1;e<n.length;e++)n[e]<s&&(s=n[e]),n[e]>o&&(o=n[e]);const f=m!==void 0?Math.min(s,m):s,u=((h!==void 0?Math.max(o,h):o)-f||1)/a,d=Array.from({length:a},(e,i)=>({rangeLow:f+i*u,rangeHigh:f+(i+1)*u,count:0}));for(const e of n){const i=Math.min(a-1,Math.floor((e-f)/u));d[i].count++}return d}export function buildTestHistogramSeries(g,M,a=16,m,h){const n=new Map;let s=1/0,o=-1/0;for(const t of g){const r=[];for(const x of t.items)for(const p of x.dies??[]){const c=p.testValues?.[M];c!==void 0&&Number.isFinite(c)&&(r.push(c),c<s&&(s=c),c>o&&(o=c))}n.set(t.key,r)}const f=g.map(t=>t.key).filter(t=>n.get(t).length>0);if(f.length===0)return{ranges:[],series:[]};const l=m!==void 0?Math.min(s,m):s,d=((h!==void 0?Math.max(o,h):o)-l||1)/a,e=Array.from({length:a},(t,r)=>({rangeLow:l+r*d,rangeHigh:l+(r+1)*d})),i=f.map(t=>{const r=new Array(a).fill(0);for(const x of n.get(t)){const p=Math.min(a-1,Math.floor((x-l)/d));r[p]++}return{groupKey:t,counts:r}});return{ranges:e,series:i}}
+export function collectTestValues(d,u){const t=[];for(const i of d)for(const a of i.dies??[]){const s=a.testValues?.[u];s!==void 0&&Number.isFinite(s)&&t.push(s)}return t}export function testValueExtent(d,u){let t=1/0,i=-1/0;for(const a of d)for(const s of a.dies??[]){const n=s.testValues?.[u];n!==void 0&&Number.isFinite(n)&&(n<t&&(t=n),n>i&&(i=n))}return t===1/0?{min:NaN,max:NaN}:{min:t,max:i}}export function buildTestHistogramData(d,u,t=16,i,a,s){let n=collectTestValues(d,u);if(s&&(n=n.filter(e=>e>=s.lo&&e<=s.hi)),n.length===0)return[];let f=n[0],r=n[0];for(let e=1;e<n.length;e++)n[e]<f&&(f=n[e]),n[e]>r&&(r=n[e]);const l=i!==void 0?Math.min(f,i):f,M=((a!==void 0?Math.max(r,a):r)-l||1)/t,h=Array.from({length:t},(e,x)=>({rangeLow:l+x*M,rangeHigh:l+(x+1)*M,count:0}));for(const e of n){const x=Math.min(t-1,Math.floor((e-l)/M));h[x].count++}return h}export function buildTestHistogramSeries(d,u,t=16,i,a,s){const n=new Map;let f=1/0,r=-1/0;for(const o of d){const m=[];for(const y of o.items)for(const p of y.dies??[]){const c=p.testValues?.[u];if(c!==void 0&&Number.isFinite(c)){if(s&&(c<s.lo||c>s.hi))continue;m.push(c),c<f&&(f=c),c>r&&(r=c)}}n.set(o.key,m)}const l=d.map(o=>o.key).filter(o=>n.get(o).length>0);if(l.length===0)return{ranges:[],series:[]};const g=i!==void 0?Math.min(f,i):f,h=((a!==void 0?Math.max(r,a):r)-g||1)/t,e=Array.from({length:t},(o,m)=>({rangeLow:g+m*h,rangeHigh:g+(m+1)*h})),x=l.map(o=>{const m=new Array(t).fill(0);for(const y of n.get(o)){const p=Math.min(t-1,Math.floor((y-g)/h));m[p]++}return{groupKey:o,counts:m}});return{ranges:e,series:x}}

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

@@ -12,12 +12,18 @@ export { buildFacetTable, facetValueOf, FACET_NONE_VALUE, DEFAULT_FACET_CURATION
 export type { FacetField, FacetValue, FacetCuration, FacetItem, BuildFacetTableOptions } from './facets.js';
 export { resolveMetadataColumns, discoverDieMetadataKeys } from './metadataColumns.js';
 export type { MetadataColumn, MetadataColumnScope, MetadataColumnSet, MetadataKeySelection, ResolveMetadataColumnsOptions, } from './metadataColumns.js';
+export { mergeTestDefs } from './mergeTestDefs.js';
+export type { MergedTestDefs, TestDefConflict, TestDefConflictKind } from './mergeTestDefs.js';
 export { buildCapabilityData } from './capability.js';
 export type { CapabilityDatum, CapabilityItem } from './capability.js';
 export { buildCorrelationMatrix, filterCorrelationMatrix } from './correlation.js';
 export type { CorrelationTestInfo, CorrelationCell, CorrelationMatrix, CorrelationSummary } from './correlation.js';
 export { buildTestBoxplotData } from './boxplot.js';
 export type { BoxplotDatum, BoxplotItem } from './boxplot.js';
+export { buildTestTrendData, trendCentre } from './trend.js';
+export type { TrendDatum, TrendItem } from './trend.js';
+export { buildTestPassRateData, hasJudgeableTests } from './testPassRate.js';
+export type { TestPassKind, TestPassRateData, TestPassRateItem, TestPassRateRow, TestPassRateValue } from './testPassRate.js';
 export { buildTestHistogramData, buildTestHistogramSeries } from './histogram.js';
 export type { HistogramBucket, HistogramItem, HistogramSeries, HistogramSeriesData } from './histogram.js';
 export { buildScatterData, buildScatterDataGrouped } from './scatter.js';

package/dist/packages/stats/index.js

@@ -1 +1 @@
-export*from"./types.js";export*from"./regions.js";export*from"./analyzeWaferMap.js";export*from"./analyzeWaferLot.js";export*from"./filterFindings.js";export{classifyPattern}from"./patternClassification.js";export{renderFindingsReportHtml,openHtmlReport,setReportOpener}from"./renderFindingsReport.js";export{renderSummaryReportHtml,renderLotSummaryReportHtml}from"./renderSummaryReport.js";export{buildFacetTable,facetValueOf,FACET_NONE_VALUE,DEFAULT_FACET_CURATION}from"./facets.js";export{resolveMetadataColumns,discoverDieMetadataKeys}from"./metadataColumns.js";export{buildCapabilityData}from"./capability.js";export{buildCorrelationMatrix,filterCorrelationMatrix}from"./correlation.js";export{buildTestBoxplotData}from"./boxplot.js";export{buildTestHistogramData,buildTestHistogramSeries}from"./histogram.js";export{buildScatterData,buildScatterDataGrouped}from"./scatter.js";export{buildYieldData,buildYieldDataCombined}from"./yield.js";export{buildBinParetoData,buildBinClusterData}from"./binPareto.js";
+export*from"./types.js";export*from"./regions.js";export*from"./analyzeWaferMap.js";export*from"./analyzeWaferLot.js";export*from"./filterFindings.js";export{classifyPattern}from"./patternClassification.js";export{renderFindingsReportHtml,openHtmlReport,setReportOpener}from"./renderFindingsReport.js";export{renderSummaryReportHtml,renderLotSummaryReportHtml}from"./renderSummaryReport.js";export{buildFacetTable,facetValueOf,FACET_NONE_VALUE,DEFAULT_FACET_CURATION}from"./facets.js";export{resolveMetadataColumns,discoverDieMetadataKeys}from"./metadataColumns.js";export{mergeTestDefs}from"./mergeTestDefs.js";export{buildCapabilityData}from"./capability.js";export{buildCorrelationMatrix,filterCorrelationMatrix}from"./correlation.js";export{buildTestBoxplotData}from"./boxplot.js";export{buildTestTrendData,trendCentre}from"./trend.js";export{buildTestPassRateData,hasJudgeableTests}from"./testPassRate.js";export{buildTestHistogramData,buildTestHistogramSeries}from"./histogram.js";export{buildScatterData,buildScatterDataGrouped}from"./scatter.js";export{buildYieldData,buildYieldDataCombined}from"./yield.js";export{buildBinParetoData,buildBinClusterData}from"./binPareto.js";

package/dist/packages/stats/mergeTestDefs.d.ts

@@ -0,0 +1,44 @@
+import type { TestDef, WaferWarning } from '../renderer/buildWaferMap.js';
+/** Which field disagreed. `'limits'` is the soft tier; the rest are hard. */
+export type TestDefConflictKind = 'name' | 'unit' | 'testType' | 'limits';
+/** One test number whose defs could not be reconciled across the population. */
+export interface TestDefConflict {
+    testNumber: number;
+    kind: TestDefConflictKind;
+    /** True when the test was withheld from `defs` (the hard tier). */
+    excluded: boolean;
+    /**
+     * The distinct STATED values that disagreed, in first-seen order, already
+     * stringified for display. Absent values are not represented — they were
+     * never in disagreement with anything.
+     */
+    values: string[];
+}
+export interface MergedTestDefs {
+    /**
+     * The union of every test number across every item, each carrying a def
+     * reconciled from all items that described it. Hard-conflicting tests are
+     * absent. Ordered by first appearance, so a single-program population gets
+     * back exactly the order it supplied.
+     */
+    defs: TestDef[];
+    /** Every unreconcilable test, both tiers. Empty for a clean population. */
+    conflicts: TestDefConflict[];
+    /**
+     * `conflicts` rendered as structured advisories, ready to hand to
+     * `collectWarnings` so the toolbar indicator and Summary banner report them
+     * with no host work. At most one warning per severity — a program mismatch
+     * hits many tests at once, and one line per test would bury everything else.
+     */
+    warnings: WaferWarning[];
+}
+/**
+ * Reconcile every item's `testDefs` into one list for the whole population.
+ *
+ * Items with no defs are skipped, not treated as disagreeing — a wafer that
+ * describes nothing contradicts nothing.
+ */
+export declare function mergeTestDefs(items: Array<{
+    testDefs?: TestDef[];
+} | null | undefined>): MergedTestDefs;
+//# sourceMappingURL=mergeTestDefs.d.ts.map

package/dist/packages/stats/mergeTestDefs.js

@@ -0,0 +1 @@
+const k=1e-6;function w(t,e){if(t===e)return!0;if(!Number.isFinite(t)||!Number.isFinite(e))return!1;const i=Math.max(Math.abs(t),Math.abs(e));return Math.abs(t-e)<=1e-6*i}function v(t){const e=t.name?.trim();return e||void 0}function y(t){const e=t.unit?.trim();return e||void 0}function L(t){return t.toLowerCase()}function h(t,e){const i=new Set,s=[];for(const o of t){const r=e(o);i.has(r)||(i.add(r),s.push(o))}return s}function g(t){const e=[];for(const i of t)e.some(s=>w(s,i))||e.push(i);return e}function T(t){return`${t.testNumber} (${t.values.join(" vs ")})`}function b(t,e=5){const i=t.slice(0,e).map(T).join(", "),s=t.length-Math.min(e,t.length);return s>0?`${i}, and ${s} more`:i}export function mergeTestDefs(t){const e=new Map,i=[];for(const r of t)for(const u of r?.testDefs??[]){const f=u.testNumber;let d=e.get(f);d||(d=[],e.set(f,d),i.push(f)),d.push(u)}const s=[],o=[];for(const r of i){const u=e.get(r),f=h(u.map(v).filter(n=>n!==void 0),L),d=h(u.map(y).filter(n=>n!==void 0),n=>n),l=h(u.map(n=>n.testType).filter(n=>n!==void 0),n=>n),p=f.length>1?{testNumber:r,kind:"name",excluded:!0,values:f}:d.length>1?{testNumber:r,kind:"unit",excluded:!0,values:d}:l.length>1?{testNumber:r,kind:"testType",excluded:!0,values:l}:void 0;if(p){o.push(p);continue}const a=g(u.map(n=>n.limitLow).filter(n=>n!==void 0)),c=g(u.map(n=>n.limitHigh).filter(n=>n!==void 0)),m=a.length>1||c.length>1;m&&o.push({testNumber:r,kind:"limits",excluded:!1,values:(a.length>1?a:c).map(n=>String(n))}),s.push({testNumber:r,name:f[0]??"",...d[0]!==void 0?{unit:d[0]}:{},...l[0]!==void 0?{testType:l[0]}:{},...u.find(n=>n.logScale!==void 0)?{logScale:u.find(n=>n.logScale!==void 0).logScale}:{},...!m&&a[0]!==void 0?{limitLow:a[0]}:{},...!m&&c[0]!==void 0?{limitHigh:c[0]}:{}})}return{defs:s,conflicts:o,warnings:N(o)}}function N(t){const e=[],i=t.filter(o=>o.excluded),s=t.filter(o=>o.kind==="limits");return i.length>0&&e.push({code:"test-def-collision",severity:"error",message:`${i.length} test ${i.length===1?"number describes":"numbers describe"} a different measurement in different wafers, so the same number cannot identify one test across this population. Affected: `+b(i)+". These tests are withheld from every cross-wafer chart, report and map mode \u2014 pooling them would mix unrelated measurements into one distribution. Each wafer's own view is unaffected. Load one test program at a time to see them."}),s.length>0&&e.push({code:"test-limit-conflict",severity:"warning",message:`${s.length} ${s.length===1?"test is":"tests are"} held to different spec limits in different wafers. Affected: `+b(s)+". The measured values are still comparable, so distributions include them, but capability (Cp/Cpk/Pp/Ppk), spec yield and the limit lines are withheld for these tests \u2014 there is no single spec to judge the merged population against."}),e}

package/dist/packages/stats/metadataColumns.d.ts

@@ -5,7 +5,21 @@ import type { MetadataFieldDef } from '../renderer/buildWaferMap.js';
  *  every row; a `'die'` column genuinely varies die to die. */
 export type MetadataColumnScope = 'die' | 'wafer';
 /** How metadata keys are chosen. `'auto'` = every key present in the data. */
-export type MetadataKeySelection = 'auto' | 'none' | string[];
+/**
+ * `'auto'` — every displayable key.
+ * `'identity'` — only the curated keys that identify a population (lot, wafer,
+ *   product, program, split, operator, date…), i.e. `DEFAULT_FACET_CURATION`.
+ * `'none'` — no columns.
+ * `string[]` — exactly these keys, when present.
+ *
+ * `'identity'` exists because `'auto'` is the wrong default for a per-test
+ * export: a host that maps an STDF header into wafer metadata carries WCR
+ * geometry (`Center X`, `Die Ht`, `Wf Flat`, `Wafr Siz`, `Pos X`…) alongside the
+ * identity fields, and `'auto'` stamped all fifteen of them as constant leading
+ * columns on every row — pushing the actual statistics off the right of the
+ * screen while answering none of "which wafer is this?".
+ */
+export type MetadataKeySelection = 'auto' | 'identity' | 'none' | string[];
 export interface MetadataColumn {
     /** The metadata key this column reads. */
     key: string;
@@ -62,9 +76,11 @@ export declare function discoverDieMetadataKeys(dies: Die[], metadataFields?: Me
  * Build the metadata column set for a population.
  *
  * A key present on both a die and its wafer yields exactly ONE column, scope
- * `'die'`, carrying the die value — the same shadowing rule the hover tooltip
- * applies with `{ ...waferMeta, ...die.metadata }`. Two columns for one key
- * could otherwise disagree in the same row.
+ * `'die'`, carrying the die value. Two columns for one key could otherwise
+ * disagree in the same row. (This used to cite the hover tooltip as applying the
+ * same `{ ...waferMeta, ...die.metadata }` shadowing; the tooltip no longer shows
+ * wafer metadata at all — that identity moved to the identity header — so the
+ * rule now stands on its own reasoning rather than a parallel that has gone.)
  */
 export declare function resolveMetadataColumns(o: ResolveMetadataColumnsOptions): MetadataColumnSet;
 //# sourceMappingURL=metadataColumns.d.ts.map

package/dist/packages/stats/metadataColumns.js

@@ -1 +1 @@
-import{metadataDisplayValue as k}from"../core/metadata.js";import{compareNatural as w,prettyKey as h}from"../core/utils.js";import{DEFAULT_FACET_CURATION as v}from"./facets.js";const K=64;export function discoverDieMetadataKeys(e,n,c=K){const d=new Set;for(const a of e)if(a.metadata)for(const i of Object.keys(a.metadata))d.add(i);const t=[];for(const a of n??[])d.has(a.key)&&!t.includes(a.key)&&t.push(a.key);const y=[...d].filter(a=>!t.includes(a)).sort(w),r=[...t,...y];return{keys:r.slice(0,c),truncated:r.slice(c)}}function A(e){const n=Object.keys(e).filter(t=>k(e[t])!==void 0),c=Object.keys(v).filter(t=>n.includes(t)),d=n.filter(t=>!c.includes(t)).sort(w);return[...c,...d]}const b=(e,n)=>e==="none"?[]:Array.isArray(e)?e.filter(c=>n.includes(c)):n;export function resolveMetadataColumns(e){const n=e.waferMetadata??{},c=e.waferPlacement??"csv",d=discoverDieMetadataKeys(e.dies??[],e.metadataFields,e.maxDieKeys??K),t=b(e.dieKeys,d.keys),y=c==="none"?[]:b(e.waferKeys,A(n)).filter(s=>!t.includes(s)),r=new Set(e.reservedLabels??[]),a=(s,o)=>{const f=e.metadataFields?.find(u=>u.key===s)?.label??h(s);if(!r.has(f))return r.add(f),f;const m=o==="die"?`${f} (metadata)`:`${f} (wafer metadata)`;if(!r.has(m))return r.add(m),m;const l=`${f} (${s})`;if(!r.has(l))return r.add(l),l;for(let u=2;;u++){const p=`${l} (${u})`;if(!r.has(p))return r.add(p),p}},i=[];for(const s of t)i.push({key:s,label:a(s,"die"),scope:"die",get:o=>k(o.metadata?.[s])??"",csvOnly:!1});for(const s of y){const o=k(n[s])??"";i.push({key:s,label:a(s,"wafer"),scope:"wafer",get:()=>o,constant:o,csvOnly:c==="csv"})}return{columns:i,truncatedKeys:d.truncated}}
+import{metadataDisplayValue as k}from"../core/metadata.js";import{compareNatural as w,prettyKey as A}from"../core/utils.js";import{DEFAULT_FACET_CURATION as K}from"./facets.js";const b=64;export function discoverDieMetadataKeys(e,n,s=b){const d=new Set;for(const c of e)if(c.metadata)for(const i of Object.keys(c.metadata))d.add(i);const t=[];for(const c of n??[])d.has(c.key)&&!t.includes(c.key)&&t.push(c.key);const y=[...d].filter(c=>!t.includes(c)).sort(w),a=[...t,...y];return{keys:a.slice(0,s),truncated:a.slice(s)}}function v(e){const n=Object.keys(e).filter(t=>k(e[t])!==void 0),s=Object.keys(K).filter(t=>n.includes(t)),d=n.filter(t=>!s.includes(t)).sort(w);return[...s,...d]}const h=(e,n)=>e==="none"?[]:Array.isArray(e)?e.filter(s=>n.includes(s)):e==="identity"?n.filter(s=>s in K):n;export function resolveMetadataColumns(e){const n=e.waferMetadata??{},s=e.waferPlacement??"csv",d=discoverDieMetadataKeys(e.dies??[],e.metadataFields,e.maxDieKeys??b),t=h(e.dieKeys,d.keys),y=s==="none"?[]:h(e.waferKeys,v(n)).filter(r=>!t.includes(r)),a=new Set(e.reservedLabels??[]),c=(r,o)=>{const f=e.metadataFields?.find(u=>u.key===r)?.label??A(r);if(!a.has(f))return a.add(f),f;const m=o==="die"?`${f} (metadata)`:`${f} (wafer metadata)`;if(!a.has(m))return a.add(m),m;const l=`${f} (${r})`;if(!a.has(l))return a.add(l),l;for(let u=2;;u++){const p=`${l} (${u})`;if(!a.has(p))return a.add(p),p}},i=[];for(const r of t)i.push({key:r,label:c(r,"die"),scope:"die",get:o=>k(o.metadata?.[r])??"",csvOnly:!1});for(const r of y){const o=k(n[r])??"";i.push({key:r,label:c(r,"wafer"),scope:"wafer",get:()=>o,constant:o,csvOnly:s==="csv"})}return{columns:i,truncatedKeys:d.truncated}}

package/dist/packages/stats/patternClassification.js

@@ -1 +1 @@
-import{getDieKey as F}from"../core/dies.js";import{clamp01 as j}from"../core/utils.js";export const DEFAULT_PATTERN_THRESHOLDS={nearFullGlobalRdd:.6,edgeRingEdgeRdd:.18,edgeRingEdgeRddHigh:.3,edgeRingRadialSpread:.45,edgeRingAngularSpread:.6,edgeLocalEdgeRdd:.1,edgeLocalCentroidDist:.76,donutP25Dist:.4,centerCentroidDist:.22,centerCentroidDistHigh:.1,centerEdgeRdd:.35,donutEdgeRdd:.22,scratchLinearScore:.25,scratchLinearScoreHigh:.45,scratchEccentricity:.75,minimumFailingDies:5};function J(t){if(t.length===0)return[];const e=new Map;for(const s of t)e.set(F(s),s);const c=new Set,i=[];for(const s of t){const d=F(s);if(c.has(d))continue;const r=[],n=[s];for(c.add(d);n.length>0;){const a=n.pop();r.push(a);for(let g=-1;g<=1;g++)for(let m=-1;m<=1;m++){if(g===0&&m===0)continue;const u=`${a.x+g},${a.y+m}`;!c.has(u)&&e.has(u)&&(c.add(u),n.push(e.get(u)))}}i.push(r)}return i}function O(t,e,c){const i=t.physX-e.center.x,s=t.physY-e.center.y,d=Math.sqrt(i*i+s*s)/e.radius;return Math.min(c,Math.max(1,Math.floor(d*c)+1))===c}function Q(t,e,c){if(t.length<3)return 0;let i=0,s=0,d=0;for(const p of t){const l=p.physX-e,D=p.physY-c;i+=l*l,s+=D*D,d+=l*D}i/=t.length,s/=t.length,d/=t.length;const r=i+s,n=i*s-d*d,a=Math.max(0,(r/2)**2-n),g=r/2+Math.sqrt(a),m=r/2-Math.sqrt(a);if(g<=0)return 0;const u=j(m/g);return Math.sqrt(1-u)}function V(t,e){if(e===0)return 0;const c=new Map,i=new Map,s=new Map,d=new Map;for(const n of t)c.set(n.y,(c.get(n.y)??0)+1),i.set(n.x,(i.get(n.x)??0)+1),s.set(n.x-n.y,(s.get(n.x-n.y)??0)+1),d.set(n.x+n.y,(d.get(n.x+n.y)??0)+1);let r=0;for(const n of c.values())n>r&&(r=n);for(const n of i.values())n>r&&(r=n);for(const n of s.values())n>r&&(r=n);for(const n of d.values())n>r&&(r=n);return r/e}function W(t,e,c,i){const s=e.length,d=t.length,r=s>0?d/s:0,n=e.filter(o=>O(o,c,i)),a=t.filter(o=>O(o,c,i)),g=n.length>0?a.length/n.length:0,m=J(t),u=m.length>0?[...m].sort((o,h)=>h.length-o.length):[t],p=u[0],l=u.slice(0,5).flat(),D=p.length,H=d>0?D/d:0,f=c.center.x,y=c.center.y,R=c.radius;let E=0,N=0,M=1/0,x=0;for(const o of p){E+=o.physX,N+=o.physY;const h=Math.sqrt((o.physX-f)**2+(o.physY-y)**2);h<M&&(M=h),h>x&&(x=h)}const P=E/p.length,T=N/p.length,w=Math.sqrt((P-f)**2+(T-y)**2)/R,I=M===1/0?0:M/R,v=Math.min(x/R,1),C=t.map(o=>Math.sqrt((o.physX-f)**2+(o.physY-y)**2)/R).sort((o,h)=>o-h),k=C[Math.floor(C.length*.25)]??0,b=e.filter(o=>Math.sqrt((o.physX-f)**2+(o.physY-y)**2)/R<.5).length,X=e.filter(o=>Math.sqrt((o.physX-f)**2+(o.physY-y)**2)/R>=.5).length,z=t.filter(o=>Math.sqrt((o.physX-f)**2+(o.physY-y)**2)/R<.5).length,A=t.filter(o=>Math.sqrt((o.physX-f)**2+(o.physY-y)**2)/R>=.5).length,Y=b>0?z/b:0,q=X>0?A/X:0,_=q>0?Y/q:Y>0?2:1,G=l.reduce((o,h)=>o+h.physX,0)/l.length,K=l.reduce((o,h)=>o+h.physY,0)/l.length,U=Q(l,G,K),$=V(l,l.length),S=16,L=new Set;for(const o of a){const h=(Math.atan2(o.physY-y,o.physX-f)+2*Math.PI)%(2*Math.PI);L.add(Math.floor(h/(2*Math.PI)*S)%S)}const B=a.length>0?L.size/S:0;return{globalRdd:r,edgeRdd:g,centroidDistNorm:w,minDistNorm:I,maxDistNorm:v,p25DistNorm:k,eccentricity:U,linearScore:$,salienceSize:D,salienceFraction:H,edgeAngularSpread:B,innerOuterRatio:_}}function Z(t,e,c){const i=Math.max(5,Math.round(c*.003)),s=t.salienceSize>=i;if(t.globalRdd<e.nearFullGlobalRdd&&t.salienceFraction<.1)return{pattern:"random",confidence:"low"};if(t.globalRdd>=e.nearFullGlobalRdd)return{pattern:"near-full",confidence:t.globalRdd>=.8?"high":"medium"};if(s&&t.linearScore>=e.scratchLinearScore&&t.eccentricity>=e.scratchEccentricity){const a=t.linearScore>=e.scratchLinearScoreHigh?"high":"medium";return{pattern:"scratch",confidence:a,note:a==="medium"?"Scratch detection is less reliable for fragmented or diagonal patterns":void 0}}const d=s&&t.edgeRdd>=e.edgeLocalEdgeRdd&&t.maxDistNorm>=.7;if(d&&t.p25DistNorm>=e.edgeLocalCentroidDist&&t.maxDistNorm-t.minDistNorm<=e.edgeRingRadialSpread)return{pattern:"edge-ring",confidence:t.edgeRdd>=e.edgeRingEdgeRddHigh?"high":"medium"};if(d&&t.p25DistNorm>=.55&&t.p25DistNorm<e.edgeLocalCentroidDist)return{pattern:"edge-local",confidence:t.edgeRdd>=e.edgeRingEdgeRdd?"medium":"low"};const r=s&&t.centroidDistNorm<=e.centerCentroidDist&&t.edgeRdd<=e.centerEdgeRdd,n="Center and donut patterns have similar geometry; classification may be imprecise";if(r&&t.p25DistNorm<e.donutP25Dist){const a=t.centroidDistNorm<=e.centerCentroidDistHigh?"high":"medium";return{pattern:"center",confidence:a,note:a!=="high"?n:void 0}}return r&&t.p25DistNorm>=e.donutP25Dist&&t.p25DistNorm<.55?{pattern:"donut",confidence:"medium",note:n}:{pattern:"random",confidence:"low"}}export function classifyPattern(t,e,c){const i={...DEFAULT_PATTERN_THRESHOLDS},s=c.ringCount??4,d=new Set(c.passBins),r=t.filter(p=>{const l=p.hbin??p.sbin;return l!==void 0&&!d.has(l)}),n=Math.max(i.minimumFailingDies,Math.round(t.length*.003));if(r.length<n)return null;const a=W(r,t,e,s),{pattern:g,confidence:m,note:u}=Z(a,i,t.length);return{pattern:g,confidence:m,features:a,...u?{note:u}:{}}}
+import{findConnectedComponents as J}from"./connectedComponents.js";import{clamp01 as K}from"../core/utils.js";export const DEFAULT_PATTERN_THRESHOLDS={nearFullGlobalRdd:.6,edgeRingEdgeRdd:.18,edgeRingEdgeRddHigh:.3,edgeRingRadialSpread:.45,edgeRingAngularSpread:.6,edgeLocalEdgeRdd:.1,edgeLocalCentroidDist:.76,donutP25Dist:.4,centerCentroidDist:.22,centerCentroidDistHigh:.1,centerEdgeRdd:.35,donutEdgeRdd:.22,scratchLinearScore:.25,scratchLinearScoreHigh:.45,scratchEccentricity:.75,minimumFailingDies:5};function F(t,o,s){const i=t.physX-o.center.x,r=t.physY-o.center.y,d=Math.sqrt(i*i+r*r)/o.radius;return Math.min(s,Math.max(1,Math.floor(d*s)+1))===s}function Q(t,o,s){if(t.length<3)return 0;let i=0,r=0,d=0;for(const g of t){const l=g.physX-o,D=g.physY-s;i+=l*l,r+=D*D,d+=l*D}i/=t.length,r/=t.length,d/=t.length;const c=i+r,n=i*r-d*d,a=Math.max(0,(c/2)**2-n),m=c/2+Math.sqrt(a),R=c/2-Math.sqrt(a);if(m<=0)return 0;const f=K(R/m);return Math.sqrt(1-f)}function V(t,o){if(o===0)return 0;const s=new Map,i=new Map,r=new Map,d=new Map;for(const n of t)s.set(n.y,(s.get(n.y)??0)+1),i.set(n.x,(i.get(n.x)??0)+1),r.set(n.x-n.y,(r.get(n.x-n.y)??0)+1),d.set(n.x+n.y,(d.get(n.x+n.y)??0)+1);let c=0;for(const n of s.values())n>c&&(c=n);for(const n of i.values())n>c&&(c=n);for(const n of r.values())n>c&&(c=n);for(const n of d.values())n>c&&(c=n);return c/o}function W(t,o,s,i){const r=o.length,d=t.length,c=r>0?d/r:0,n=o.filter(e=>F(e,s,i)),a=t.filter(e=>F(e,s,i)),m=n.length>0?a.length/n.length:0,R=J(t),f=R.length>0?[...R].sort((e,h)=>h.length-e.length):[t],g=f[0],l=f.slice(0,5).flat(),D=g.length,O=d>0?D/d:0,u=s.center.x,p=s.center.y,y=s.radius;let E=0,N=0,M=1/0,x=0;for(const e of g){E+=e.physX,N+=e.physY;const h=Math.sqrt((e.physX-u)**2+(e.physY-p)**2);h<M&&(M=h),h>x&&(x=h)}const H=E/g.length,P=N/g.length,T=Math.sqrt((H-u)**2+(P-p)**2)/y,I=M===1/0?0:M/y,v=Math.min(x/y,1),C=t.map(e=>Math.sqrt((e.physX-u)**2+(e.physY-p)**2)/y).sort((e,h)=>e-h),w=C[Math.floor(C.length*.25)]??0,b=o.filter(e=>Math.sqrt((e.physX-u)**2+(e.physY-p)**2)/y<.5).length,X=o.filter(e=>Math.sqrt((e.physX-u)**2+(e.physY-p)**2)/y>=.5).length,z=t.filter(e=>Math.sqrt((e.physX-u)**2+(e.physY-p)**2)/y<.5).length,A=t.filter(e=>Math.sqrt((e.physX-u)**2+(e.physY-p)**2)/y>=.5).length,Y=b>0?z/b:0,L=X>0?A/X:0,_=L>0?Y/L:Y>0?2:1,G=l.reduce((e,h)=>e+h.physX,0)/l.length,k=l.reduce((e,h)=>e+h.physY,0)/l.length,U=Q(l,G,k),B=V(l,l.length),S=16,q=new Set;for(const e of a){const h=(Math.atan2(e.physY-p,e.physX-u)+2*Math.PI)%(2*Math.PI);q.add(Math.floor(h/(2*Math.PI)*S)%S)}const j=a.length>0?q.size/S:0;return{globalRdd:c,edgeRdd:m,centroidDistNorm:T,minDistNorm:I,maxDistNorm:v,p25DistNorm:w,eccentricity:U,linearScore:B,salienceSize:D,salienceFraction:O,edgeAngularSpread:j,innerOuterRatio:_}}function Z(t,o,s){const i=Math.max(5,Math.round(s*.003)),r=t.salienceSize>=i;if(t.globalRdd<o.nearFullGlobalRdd&&t.salienceFraction<.1)return{pattern:"random",confidence:"low"};if(t.globalRdd>=o.nearFullGlobalRdd)return{pattern:"near-full",confidence:t.globalRdd>=.8?"high":"medium"};if(r&&t.linearScore>=o.scratchLinearScore&&t.eccentricity>=o.scratchEccentricity){const a=t.linearScore>=o.scratchLinearScoreHigh?"high":"medium";return{pattern:"scratch",confidence:a,note:a==="medium"?"Scratch detection is less reliable for fragmented or diagonal patterns":void 0}}const d=r&&t.edgeRdd>=o.edgeLocalEdgeRdd&&t.maxDistNorm>=.7;if(d&&t.p25DistNorm>=o.edgeLocalCentroidDist&&t.maxDistNorm-t.minDistNorm<=o.edgeRingRadialSpread)return{pattern:"edge-ring",confidence:t.edgeRdd>=o.edgeRingEdgeRddHigh?"high":"medium"};if(d&&t.p25DistNorm>=.55&&t.p25DistNorm<o.edgeLocalCentroidDist)return{pattern:"edge-local",confidence:t.edgeRdd>=o.edgeRingEdgeRdd?"medium":"low"};const c=r&&t.centroidDistNorm<=o.centerCentroidDist&&t.edgeRdd<=o.centerEdgeRdd,n="Center and donut patterns have similar geometry; classification may be imprecise";if(c&&t.p25DistNorm<o.donutP25Dist){const a=t.centroidDistNorm<=o.centerCentroidDistHigh?"high":"medium";return{pattern:"center",confidence:a,note:a!=="high"?n:void 0}}return c&&t.p25DistNorm>=o.donutP25Dist&&t.p25DistNorm<.55?{pattern:"donut",confidence:"medium",note:n}:{pattern:"random",confidence:"low"}}export function classifyPattern(t,o,s){const i={...DEFAULT_PATTERN_THRESHOLDS},r=s.ringCount??4,d=new Set(s.passBins),c=t.filter(g=>{const l=g.hbin??g.sbin;return l!==void 0&&!d.has(l)}),n=Math.max(i.minimumFailingDies,Math.round(t.length*.003));if(c.length<n)return null;const a=W(c,t,o,r),{pattern:m,confidence:R,note:f}=Z(a,i,t.length);return{pattern:m,confidence:R,features:a,...f?{note:f}:{}}}

package/dist/packages/stats/population.d.ts

@@ -0,0 +1,23 @@
+export interface WaferPopulation {
+    waferCount: number;
+    /** The lot ID every wafer records, when they all record the same one. */
+    lotId?: string;
+    /** Distinct lot IDs recorded across the wafers — 0 when none records one. */
+    lotCount: number;
+}
+type Metadata = Record<string, unknown> | null | undefined;
+/** One entry per wafer — its `wafer.metadata` (or a summary's `wafer` identity). */
+export declare function describeWaferPopulation(metadatas: readonly Metadata[]): WaferPopulation;
+/**
+ * What the set is, for a title: "Lot LOT123 · 13 wafers", "26 wafers from
+ * 2 lots", or "13 wafers" (no lot ID recorded).
+ */
+export declare function populationLabel(p: WaferPopulation): string;
+/**
+ * A statistic taken across the set, as a noun phrase: "lot median" for one
+ * lot, otherwise "median of all wafers". Reads correctly after "the" and
+ * "vs".
+ */
+export declare function populationStat(p: WaferPopulation, stat: 'mean' | 'median'): string;
+export {};
+//# sourceMappingURL=population.d.ts.map

package/dist/packages/stats/population.js

@@ -0,0 +1 @@
+function f(n){const t=n?.lot??n?.lotId;return t==null||t===""?void 0:String(t)}export function describeWaferPopulation(n){const t=n.map(f),o=new Set(t.filter(e=>e!==void 0)),u=o.size===1&&t.every(e=>e!==void 0);return{waferCount:n.length,lotCount:o.size,...u?{lotId:[...o][0]}:{}}}const r=n=>`${n} wafer${n===1?"":"s"}`;export function populationLabel(n){return n.lotId!==void 0?`Lot ${n.lotId} \xB7 ${r(n.waferCount)}`:n.lotCount>1?`${r(n.waferCount)} from ${n.lotCount} lots`:r(n.waferCount)}export function populationStat(n,t){return n.lotId!==void 0?`lot ${t}`:`${t} of all wafers`}

package/dist/packages/stats/renderFindingsReport.js

@@ -1,11 +1,11 @@
-import{formatFindingDelta as b,formatFindingCoverage as g,formatFindingTooltip as v,escHtml as a,buildMetadataRows as c,renderDefinitionList as p,renderSection as f,renderSeverityBadge as y,reportStyles as R}from"./reportHtml.js";import{buildFindingsNarrative as $}from"./findingsNarrative.js";import{plainBinTerms as u}from"../renderer/fmt.js";function S(e,n){if(e.level==="lot"){const o=e,l=o.perWafer.map(r=>r.summary.wafer?.wafer??r.summary.wafer?.waferId).filter(r=>r!=null).map(String).join(", ");return p([...c(o.perWafer.map(r=>({metadata:r.summary.wafer}))),...l?[{label:"Wafers",value:l}]:[],{label:"Wafer count",value:String(o.stats.waferCount)},{label:"Generated",value:n}])}const t=e,i=t.stats.yieldPercent!==null?`${t.stats.yieldPercent.toFixed(1)}%`:"N/A";return p([...c([{metadata:t.wafer}]),{label:"Total dies",value:String(t.stats.totalDies)},{label:"Analysed dies",value:String(t.stats.analyzedDies)},{label:"Yield",value:i},{label:"Generated",value:n}])}function F(e,n){return e.length?e.map(t=>`<tr title="${a(v(t))}">
-      <td class="tight">${y(t.severity)}</td>
-      <td class="tight">${a(t.comparison.left)}</td>
-      <td>${a(u(t.variable.label))}</td>
-      <td class="numeric">${a(b(t))}</td>
-      <td class="numeric">${a(g(t,n))}</td>
+import{describeWaferPopulation as b,populationLabel as h}from"./population.js";import{formatFindingDelta as g,formatFindingCoverage as v,formatFindingTooltip as y,escHtml as o,buildMetadataRows as d,renderDefinitionList as p,renderSection as c,renderSeverityBadge as R,reportStyles as $}from"./reportHtml.js";import{buildFindingsNarrative as F}from"./findingsNarrative.js";import{plainBinTerms as f}from"../renderer/fmt.js";import{visibleFindings as S}from"./filterFindings.js";function T(e,n){if(e.level==="lot"){const a=e,l=a.perWafer.map(r=>r.summary.wafer?.wafer??r.summary.wafer?.waferId).filter(r=>r!=null).map(String).join(", ");return p([...d(a.perWafer.map(r=>({metadata:r.summary.wafer}))),...l?[{label:"Wafers",value:l}]:[],{label:"Wafer count",value:String(a.stats.waferCount)},{label:"Generated",value:n}])}const t=e,i=t.stats.yieldPercent!==null?`${t.stats.yieldPercent.toFixed(1)}%`:"N/A";return p([...d([{metadata:t.wafer}]),{label:"Total dies",value:String(t.stats.totalDies)},{label:"Analysed dies",value:String(t.stats.analyzedDies)},{label:"Yield",value:i},{label:"Generated",value:n}])}function H(e,n){return e.length?e.map(t=>`<tr title="${o(y(t))}">
+      <td class="tight">${R(t.severity)}</td>
+      <td class="tight">${o(t.comparison.left)}</td>
+      <td>${o(f(t.variable.label))}</td>
+      <td class="numeric">${o(g(t))}</td>
+      <td class="numeric">${o(v(t,n))}</td>
     </tr>`).join(`
-`):'<tr><td colspan="5" class="no-data">No significant findings</td></tr>'}function T(e,n){return`<table class="report-table findings-table compact">
+`):'<tr><td colspan="5" class="no-data">No significant findings</td></tr>'}function L(e,n){return`<table class="report-table findings-table compact">
   <thead>
     <tr>
       <th>Severity</th>
@@ -16,26 +16,26 @@ import{formatFindingDelta as b,formatFindingCoverage as g,formatFindingTooltip a
     </tr>
   </thead>
   <tbody>
-    ${F(e,n)}
+    ${H(e,n)}
   </tbody>
-</table>`}export function renderFindingsReportHtml(e,n={}){const t=e.level==="lot",i=n.title??(t?"Lot Findings Report":"Wafer Findings Report"),o=new Date().toLocaleString(),l=new Set(e.findings.flatMap(s=>s.absorbedIds??[])),r=e.findings.filter(s=>!l.has(s.id)),m=e.level==="lot"?e.stats.waferCount:void 0,d=u($(r)??""),h=d?`<p class="findings-narrative">${a(d)}</p>
-`:"",w=[f("Summary",S(e,o)),f("Findings",h+T(r,m))].join(`
+</table>`}export function renderFindingsReportHtml(e,n={}){const t=e.level==="lot"?b(e.perWafer.map(w=>w.summary.wafer)):void 0,i=n.title??(t?t.lotId!==void 0?`Lot ${t.lotId} Findings Report`:`Findings Report \u2014 ${h(t)}`:"Wafer Findings Report"),a=new Date().toLocaleString(),l=S(e.findings),r=e.level==="lot"?e.stats.waferCount:void 0,s=f(F(l)??""),u=s?`<p class="findings-narrative">${o(s)}</p>
+`:"",m=[c("Summary",T(e,a)),c("Findings",u+L(l,r))].join(`
 `);return`<!DOCTYPE html>
 <html lang="en">
 <head>
 <meta charset="UTF-8">
-<title>${a(i)}</title>
+<title>${o(i)}</title>
 <style>
-${R()}
+${$()}
 </style>
 </head>
 <body>
 <main class="report">
   <header class="report-header">
-    <h1>${a(i)}</h1>
-    <p class="report-subtitle">Generated ${a(o)}</p>
+    <h1>${o(i)}</h1>
+    <p class="report-subtitle">Generated ${o(a)}</p>
   </header>
-  ${w}
+  ${m}
 </main>
 </body>
 </html>`}export function openHtmlReport(e){if(typeof window.__openHtmlReport=="function"){window.__openHtmlReport(e);return}const n=URL.createObjectURL(new Blob([e],{type:"text/html"})),t=window.open(n,"_blank");setTimeout(()=>URL.revokeObjectURL(n),3e4),t||console.warn("wmap: window.open() returned null, so the report could not be shown. If this host cannot use window.open (e.g. Tauri, or popups are blocked), call setReportOpener() to supply your own opener.")}export function setReportOpener(e){window.__openHtmlReport=e}

package/dist/packages/stats/renderSummaryReport.js

@@ -1,68 +1,71 @@
-import{isParametricTest as ct}from"../renderer/buildWaferMap.js";import{buildRingRegions as H,buildQuadrantRegions as L}from"./regions.js";import{openHtmlReport as dt}from"./renderFindingsReport.js";import{analyzeWaferLot as ut}from"./analyzeWaferLot.js";import{computeFunctionalYield as ft}from"./analyzeWaferMap.js";import{buildCapabilityData as mt}from"./capability.js";import{fmt as M}from"../renderer/fmt.js";import{getDieKey as W,isPositionedDie as k}from"../core/dies.js";import{formatFindingDelta as pt,formatFindingCoverage as gt,formatFindingTooltip as ht,escHtml as h,renderMetadataSection as I,renderMetricGrid as E,renderSection as $,renderSeverityBadge as bt,renderTable as D,reportStyles as R}from"./reportHtml.js";function Y(a,r){return r===0?"\u2014":`${(a/r*100).toFixed(1)}%`}function St(a){if(!a)return"";const r=a.lot??a.lotId,i=a.wafer??a.waferId,n=[r,i].filter(Boolean).map(String);return n.length?` \u2014 ${n.map(h).join(" \xB7 ")}`:""}function Rt(a,r){const i=[{label:"Total dies",value:String(a.totalDies)},{label:"Filled dies",value:String(r.filledDies),hint:`${Y(r.filledDies,r.totalDies)} fill`},{label:"Pass dies",value:String(a.passDies)},{label:"Fail dies",value:String(a.failDies)},...a.edgeExcludedDies>0?[{label:"Edge excluded",value:String(a.edgeExcludedDies)}]:[],...a.partialDies>0?[{label:"Partial dies",value:String(a.partialDies)}]:[],{label:"Yield",value:a.yieldPercent!==null?`${a.yieldPercent.toFixed(1)}%`:"N/A"}];return $("Yield",E(i))}function j(a,r,i,n){const l=new Map;if(n)for(const[e,o]of Object.entries(n))l.set(Number(e),o);else for(const e of a){if(e.partial||e.edgeExcluded)continue;const o=i==="hard"?e.hbin:e.sbin;o!=null&&l.set(o,(l.get(o)??0)+1)}if(!l.size)return"";const t=[...l.values()].reduce((e,o)=>e+o,0),s=r?new Map(r.map(e=>[e.bin,e])):null,c=[...l.entries()].sort((e,o)=>e[0]-o[0]).map(([e,o])=>{const p=s?.get(e)?.name??"\u2014";return[String(e),p,String(o),Y(o,t)]});return $(i==="hard"?"Hard Bin Breakdown":"Soft Bin Breakdown",D(["Bin","Name","Count","%"],c,{className:"compact"}))}function z(a,r,i,n){const l=new Set(n),t=new Map(i.map(d=>[W(d),d]));if(!i.some(d=>d.hbin!=null||d.sbin!=null)||!r.length)return"";const c=[];for(const d of r){let e=0,o=0;for(const m of d.dieKeys){const p=t.get(m);if(!p||p.partial||p.edgeExcluded)continue;const g=p.hbin??p.sbin;g!=null&&(o++,l.has(g)&&e++)}o&&c.push([d.label,String(e),String(o),Y(e,o)])}return c.length?$(a,D(["Region","Pass","Total","Yield"],c,{className:"compact"})):""}function A(a,r,i){if(!r.length)return"";const n=a.filter(s=>!s.partial&&!s.edgeExcluded),l=new Map((i??[]).map(s=>[s.testNumber,s])),t=[];for(const s of r.filter(ct)){const c=s.testNumber,d=s.unit||void 0,e=l.get(c);let o,m,p;if(e)({min:o,max:m,mean:p}=e);else{const g=n.map(b=>b.testValues?.[c]).filter(b=>b!==void 0&&isFinite(b));if(!g.length)continue;g.sort((b,u)=>b-u),o=g[0],m=g[g.length-1],p=g.reduce((b,u)=>b+u,0)/g.length}t.push([h(s.name),M(o,d),M(p,d),M(m,d)])}return t.length?$("Test Values",D(["Test","Min","Mean","Max"],t,{className:"compact"})):""}function G(a,r,i){const n=i??ft(a,r);if(!n?.length)return"";const l=n.map(t=>[h(t.label),String(t.totalDies),String(t.passDies),String(t.failDies),t.passRatePercent!==null?`${t.passRatePercent.toFixed(1)}%`:"\u2014"]);return $("Functional Tests",D(["Test","N","Pass","Fail","Pass Rate"],l,{className:"compact"}))}function O(a,r){const i=mt(a,r);if(!i.length)return"";const n=t=>t===null?"\u2014":t.toFixed(2),l=i.map(t=>[h(t.label),t.hasSpec?`${M(t.lsl,t.unit)} \u2013 ${M(t.usl,t.unit)}`:"\u2014",M(t.mean,t.unit),n(t.cp),n(t.cpk),n(t.pp),n(t.ppk)]);return $("Process Capability",D(["Test","Spec (LSL\u2013USL)","Mean","Cp","Cpk","Pp","Ppk"],l,{className:"compact"}))}function K(a,r){if(!a.length)return"";const i=a.map(t=>`<tr title="${h(ht(t))}">
-      <td class="tight">${bt(t.severity)}</td>
-      <td class="tight">${h(t.comparison.left)}</td>
-      <td>${h(t.variable.label)}</td>
-      <td class="numeric">${h(pt(t))}</td>
-      <td class="numeric">${h(gt(t,r))}</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(`
-`),l=`<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">${r!==void 0?"Wafers":"N (region/rest)"}</th>
-  </tr></thead><tbody>${i}</tbody></table>`;return $("Findings",l)}export function renderSummaryReportHtml(a,r={}){const{wafer:i,dies:n,yieldSummary:l,dataCoverage:t,hbinDefs:s,sbinDefs:c,testDefs:d=[],statsSummary:e,passBins:o=[1],ringCount:m=4}=a,p=i.metadata,g=St(p),b=r.title??`Wafer Summary${g}`,u=new Date().toLocaleString(),w=n.some(B=>B.hbin!=null),x=n.some(B=>B.sbin!=null),S=n.filter(k),y=H(S,i,m),v=L(S,i,m),P=[{label:"Total dies",value:String(l.totalDies)},...l.partialDies>0?[{label:"Partial",value:String(l.partialDies)}]:[],...l.yieldPercent!==null?[{label:`Yield (pass: ${o.length===1?`bin ${o[0]}`:`bins ${o.join(", ")}`})`,value:`${l.yieldPercent.toFixed(1)}%`}]:[],...l.edgeExcludedDies>0?[{label:"Edge excluded (outer zone)",value:String(l.edgeExcludedDies)}]:[]],N=[I([{metadata:i.metadata}]),$("Summary",[E(P)].filter(Boolean).join(`
-`)),w?j(n,s,"hard",e?.stats.hardBinCounts):x?j(n,c,"soft",e?.stats.softBinCounts):"",z("Ring Yield",y,n,o),z("Quadrant Yield",v,n,o),A(n,d,e?.stats.perTestStats),G(n,d,e?.stats.functionalYield),O([{dies:n}],d),e?K(e.findings):""].filter(Boolean).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 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>${h(b)}</title>
+<title>${S(w)}</title>
 <style>
-${R()}
+${W()}
 </style>
 </head>
 <body>
 <main class="report">
   <header class="report-header">
-    <h1>${h(b)}</h1>
-    <p class="report-subtitle">Generated ${h(u)}</p>
+    <h1>${S(w)}</h1>
+    <p class="report-subtitle">Generated ${S(p)}</p>
   </header>
   ${N}
-  <p class="footer">Generated ${h(u)}</p>
+  <p class="footer">Generated ${S(p)}</p>
 </main>
 </body>
-</html>`}function yt(a,r){const i=a.perWafer.map(n=>{const l=r[n.waferIndex]?.label??`W${n.waferIndex+1}`,t=n.summary.stats.yieldPercent;return[l,t!==null?`${t.toFixed(1)}%`:"N/A"]});return D(["Wafer","Yield"],i,{className:"compact"})}function wt(a){const r=a.map(i=>[i.label,i.wafer?.metadata?.split]).filter(i=>!!i[1]).map(([i,n])=>[h(i),h(n)]);return r.length?$("Splits",D(["Wafer","Split"],r,{className:"compact"})):""}function U(a,r,i,n){const l=new Map,t=i==="hard"?"hardBinCounts":"softBinCounts";if(n?.length&&n.every(e=>e.stats[t]!==void 0))for(const e of n)for(const[o,m]of Object.entries(e.stats[t])){const p=Number(o);l.set(p,(l.get(p)??0)+m)}else for(const e of a){if(e.partial||e.edgeExcluded)continue;const o=i==="hard"?e.hbin:e.sbin;o!=null&&l.set(o,(l.get(o)??0)+1)}if(!l.size)return"";const s=[...l.values()].reduce((e,o)=>e+o,0),c=r?new Map(r.map(e=>[e.bin,e])):null,d=[...l.entries()].sort((e,o)=>e[0]-o[0]).map(([e,o])=>{const m=c?.get(e);return[m?.name?`Bin ${e} \xB7 ${m.name} (${o})`:`Bin ${e} (${o})`,Y(o,s)]});return $(i==="hard"?"Hard Bin Breakdown (All Wafers)":"Soft Bin Breakdown (All Wafers)",D(["Bin","Yield"],d,{className:"compact"}))}function Q(a,r,i,n,l,t){const s=new Set(t),c=new Map,d=[];for(let o=0;o<n.length;o++){const m=n[o],p=i[o]??[];if(!p.length)continue;const g=r(p.filter(k),m,l),b=new Map(p.map(u=>[W(u),u]));for(const u of g){d.includes(u.label)||d.push(u.label);const w=c.get(u.label)??{pass:0,total:0};for(const x of u.dieKeys){const S=b.get(x);if(!S||S.partial||S.edgeExcluded)continue;const y=S.hbin??S.sbin;y!=null&&(w.total++,s.has(y)&&w.pass++)}c.set(u.label,w)}}if(!c.size)return"";const e=d.filter(o=>c.get(o)?.total).map(o=>{const m=c.get(o);return[o,Y(m.pass,m.total)]});return e.length?$(a,D(["Region","Yield"],e,{className:"compact"})):""}function $t(a,r,i){let n;if(i?.length&&i.every(l=>l.stats.perTestStats!==void 0)){const l=new Map;for(const t of i)for(const s of t.stats.perTestStats??[]){const c=l.get(s.testNumber);c?(c.n+=s.count,c.sum+=s.mean*s.count,c.min=Math.min(c.min,s.min),c.max=Math.max(c.max,s.max)):l.set(s.testNumber,{n:s.count,sum:s.mean*s.count,min:s.min,max:s.max})}n=[...l.entries()].map(([t,s])=>({testNumber:t,min:s.min,max:s.max,mean:s.sum/s.n}))}return A(a,r,n)}function xt(a,r,i){let n;if(i?.length&&i.every(l=>l.stats.functionalYield!==void 0)){const l=new Map;for(const t of i)for(const s of t.stats.functionalYield??[]){const c=l.get(s.testNumber)??{label:s.label,passDies:0,failDies:0,totalDies:0};c.passDies+=s.passDies,c.failDies+=s.failDies,c.totalDies+=s.totalDies,l.set(s.testNumber,c)}n=[...l.entries()].map(([t,s])=>({testNumber:t,...s,passRatePercent:s.totalDies>0?s.passDies/s.totalDies*100:null}))}return G(a,r,n?.length?n:void 0)}const C=["lot","product","testProgram","temperature"];function Dt(a){const r=new Map(C.map(t=>[t,new Set]));for(const t of a)for(const s of C){const c=t.wafer?.metadata?.[s];c!=null&&c!==""&&r.get(s).add(String(c))}const i=C.filter(t=>r.get(t).size>1);if(i.length===0)return[{label:"",items:a,varying:i}];const n=new Map,l=[];for(const t of a){const s=i.map(c=>String(t.wafer?.metadata?.[c]??"(none)")).join(" \xB7 ");n.has(s)||(n.set(s,[]),l.push(s)),n.get(s).push(t)}return l.map(t=>({label:t,items:n.get(t),varying:i}))}function q(a,r,i,n,l,t,s){const c=ut(a,{perWaferSummaries:a.map(f=>f.statsSummary),...s}),d=[],e=[],o=[];for(const f of a){const T=f.dies??[];f.wafer&&(d.push(f.wafer),o.push(T)),T.length&&e.push(...T)}const m=e.some(f=>f.hbin!=null),p=e.some(f=>f.sbin!=null),g=m||p,b=c.perWafer.map(f=>f.summary.stats.yieldPercent).filter(f=>f!==null),u=b.length?b.reduce((f,T)=>f+T,0)/b.length:null,w=new Set(l);let x=0,S=0,y=0,v=0,P=0;for(const f of e){if(x++,f.edgeExcluded&&v++,f.partial&&P++,f.partial||f.edgeExcluded)continue;const T=f.hbin??f.sbin;T!=null&&(S++,w.has(T)&&y++)}const N=S-y,B=S>0?y/S*100:null,_=[{label:"Wafers",value:String(c.stats.waferCount)},{label:"Total dies",value:String(x)},...g?[{label:"Good dies",value:String(y)},{label:"Bad dies",value:String(N)}]:[],...v>0?[{label:"Edge excluded",value:String(v)}]:[],...P>0?[{label:"Partial dies",value:String(P)}]:[],...u!==null?[{label:"Mean wafer yield",value:`${u.toFixed(1)}%`}]:[],...B!==null?[{label:"Total yield",value:`${B.toFixed(1)}%`}]:[]],J=$("Lot Summary",E(_)),X=I(a.map(f=>({metadata:f.wafer?.metadata}))),Z=$("Per-Wafer Yield",yt(c,a)),tt=wt(a),F=c.perWafer.map(f=>f.summary),et=g?m?U(e,r,"hard",F):U(e,i,"soft",F):"",nt=g&&d.length?Q("Ring Yield (All Wafers)",H,o,d,t,l):"",st=g&&d.length?Q("Quadrant Yield (All Wafers)",L,o,d,t,l):"",at=n.length?$t(e,n,F):"",ot=n.length?xt(e,n,F):"",it=n.length?O(a,n):"",lt=c.findings.length?K(c.findings,c.stats.waferCount):"",rt=[J,X,Z,tt,et,nt,st,at,ot,it,lt].filter(Boolean).join(`
-`);return{lotSummary:c,sections:rt}}function V(a,r,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>${h(a)}</h1>
-    <p class="report-subtitle">Generated ${h(i)}</p>
+    <h1>${S(s)}</h1>
+    <p class="report-subtitle">Generated ${S(i)}</p>
   </header>
-  ${r}
-  <p class="footer">Generated ${h(i)}</p>
-</main>`}export function renderLotSummaryReportHtml(a,r={}){const{items:i,hbinDefs:n,sbinDefs:l,testDefs:t=[],passBins:s=[1],ringCount:c=4,analyzeOptions:d}=a,e=new Date().toLocaleString(),o=Dt(i);if(o.length===1){const{lotSummary:u,sections:w}=q(o[0].items,n,l,t,s,c,d),x=(()=>{const y=u.lot;if(!y)return"";const v=y.lot??y.lotId;return v?` \u2014 ${h(String(v))}`:""})(),S=r.title??`Lot Summary${x}`;return`<!DOCTYPE html>
+  ${l}
+  <p class="footer">Generated ${S(i)}</p>
+</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>${h(S)}</title>
+<title>${S(y)}</title>
 <style>
-${R()}
+${W()}
 </style>
 </head>
 <body>
-${V(S,w,e)}
+${Z(y,f,u)}
 </body>
-</html>`}const m=r.title??"Lot Summary",p=o.map(u=>{const{lotSummary:w,sections:x}=q(u.items,n,l,t,s,c,d),S=u.varying.includes("lot")?void 0:w.lot?.lot??w.lot?.lotId,y=S?`${u.label} \xB7 Lot ${String(S)}`:u.label;return V(`${m} \u2014 ${y}`,x,e)}),g=`<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 ${o.length} groups by identity \u2014 shown separately below so stats are never pooled across them.</p>`,b=p.map((u,w)=>`${w===0?"":'<hr style="max-width:1080px;margin:32px auto 0;border:none;border-top:3px solid var(--report-line-strong);">'}
-${u}`).join(`
+</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">
 <head>
 <meta charset="UTF-8">
-<title>${h(m)}</title>
+<title>${S(c)}</title>
 <style>
-${R()}
+${W()}
 </style>
 </head>
 <body>
 <div class="report" style="padding-top:24px;">
-${g}
+${m}
 </div>
-${b}
+${w}
 </body>
-</html>`}export{dt as openHtmlReport};
+</html>`}export{he as openHtmlReport};

package/dist/packages/stats/reportHtml.js

@@ -1,21 +1,21 @@
-import{fmt as i}from"../renderer/fmt.js";import{buildFacetTable as d,prettyKey as s}from"./facets.js";export function escHtml(t){return t.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;")}export function renderSection(t,e,r=""){return`<section class="${["report-section",r].filter(Boolean).join(" ")}">
-  <h2>${escHtml(t)}</h2>
-  ${e}
-</section>`}export function renderDefinitionList(t,e="meta-list"){if(!t.length)return"";const r=t.map(a=>`<div class="definition-item"><dt>${escHtml(a.label)}</dt><dd>${escHtml(a.value)}</dd></div>`).join(`
-`);return`<dl class="${e}">
+import{fmt as n}from"../renderer/fmt.js";import{buildFacetTable as s,prettyKey as d}from"./facets.js";export function escHtml(e){return e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;")}export function renderSection(e,t,r=""){return`<section class="${["report-section",r].filter(Boolean).join(" ")}">
+  <h2>${escHtml(e)}</h2>
+  ${t}
+</section>`}export function renderDefinitionList(e,t="meta-list"){if(!e.length)return"";const r=e.map(o=>`<div class="definition-item"><dt>${escHtml(o.label)}</dt><dd>${escHtml(o.value)}</dd></div>`).join(`
+`);return`<dl class="${t}">
 ${r}
-</dl>`}export function buildMetadataRows(t){return d(t,{facetableOnly:t.length>1}).map(r=>({label:s(r.key),value:r.values.map(a=>a.value).join(", ")}))}export function renderMetadataSection(t){const e=buildMetadataRows(t);return e.length?renderSection("Wafer Info",renderDefinitionList(e)):""}export function renderMetricGrid(t){return t.length?`<dl class="metric-grid">
-${t.map(r=>`<div class="metric">
+</dl>`}export function buildMetadataRows(e){return s(e,{facetableOnly:e.length>1}).map(r=>({label:d(r.key),value:r.values.map(o=>o.value).join(", ")}))}export function renderMetadataSection(e){const t=buildMetadataRows(e);return t.length?renderSection("Wafer Info",renderDefinitionList(t)):""}export function renderMetricGrid(e){return e.length?`<dl class="metric-grid">
+${e.map(r=>`<div class="metric">
   <dt>${escHtml(r.label)}</dt>
   <dd>${escHtml(r.value)}</dd>
   ${r.hint?`<span class="metric-hint">${escHtml(r.hint)}</span>`:""}
 </div>`).join(`
 `)}
-</dl>`:""}export function renderTable(t,e,r={}){if(!e.length)return`<p class="no-data">${escHtml(r.emptyMessage??"No data")}</p>`;const a=["report-table",r.className].filter(Boolean).join(" "),n=t.map(o=>`<th>${escHtml(o)}</th>`).join(""),p=e.map(o=>`<tr>${o.map(l=>`<td>${l}</td>`).join("")}</tr>`).join(`
-`);return`<table class="${a}">
-  <thead><tr>${n}</tr></thead>
+</dl>`:""}export function renderTable(e,t,r={}){if(!t.length)return`<p class="no-data">${escHtml(r.emptyMessage??"No data")}</p>`;const o=["report-table",r.className].filter(Boolean).join(" "),i=e.map(a=>`<th>${escHtml(a)}</th>`).join(""),p=t.map(a=>`<tr>${a.map(l=>`<td>${l}</td>`).join("")}</tr>`).join(`
+`);return`<table class="${o}">
+  <thead><tr>${i}</tr></thead>
   <tbody>${p}</tbody>
-</table>`}export function renderSeverityBadge(t){const e=t.charAt(0).toUpperCase()+t.slice(1);return`<span class="badge badge-${t}">${e}</span>`}export function formatFindingDelta(t){const e=t.effect.absoluteDelta??0,r=e>0?"+":e<0?"\u2212":"";if(t.variable.kind==="yield"||t.variable.kind==="hardBin"||t.variable.kind==="softBin")return`${r}${Math.abs(e*100).toFixed(1)} pp`;if(t.variable.kind==="test"){if(t.effect.relativeDelta!==void 0&&Number.isFinite(t.effect.relativeDelta)){const a=Math.abs(t.effect.relativeDelta*100).toFixed(1);return`${r}${a}%`}return`${r}${i(Math.abs(e),t.variable.unit)}`}return`${r}${i(Math.abs(e),t.variable.unit)}`}export function formatFindingTooltip(t){return t.summary}export function formatFindingCoverage(t,e){return e!==void 0?`${t.stats.sampleSizeLeft}/${e}`:`${t.stats.sampleSizeLeft}/${t.stats.sampleSizeRight}`}export function reportStyles(){return`
+</table>`}export function renderSeverityBadge(e){const t=e.charAt(0).toUpperCase()+e.slice(1);return`<span class="badge badge-${e}">${t}</span>`}export function formatFindingDelta(e){const t=e.effect.absoluteDelta??0,r=t>0?"+":t<0?"\u2212":"";if(e.variable.kind==="yield"||e.variable.kind==="hardBin"||e.variable.kind==="softBin")return`${r}${Math.abs(t*100).toFixed(1)} pp`;if(e.variable.kind==="test"){if(e.effect.relativeDelta!==void 0&&Number.isFinite(e.effect.relativeDelta)){const o=Math.abs(e.effect.relativeDelta*100).toFixed(1);return`${r}${o}%`}return`${r}${n(Math.abs(t),e.variable.unit)}`}return`${r}${n(Math.abs(t),e.variable.unit)}`}export function formatFindingTooltip(e){return e.summary}export function formatFindingCoverage(e,t){return t!==void 0?`${e.stats.sampleSizeLeft}/${t}`:`${e.stats.sampleSizeLeft}/${e.stats.sampleSizeRight}`}export function reportStyles(){return`
   :root {
     --report-font: Inter, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
     --report-text: #1f2328;
@@ -72,6 +72,26 @@ ${t.map(r=>`<div class="metric">
     font-size: 12px;
   }
 
+  /* Sub-headings and notes inside a section \u2014 used by the split comparison,
+     which nests one block per facet under a single section heading. */
+  .report-subheading {
+    margin: 14px 0 6px;
+    font-size: 13px;
+    font-weight: 600;
+    color: var(--report-text);
+  }
+  h4.report-subheading {
+    margin: 10px 0 4px;
+    font-size: 12px;
+    font-weight: 600;
+    color: var(--report-muted);
+  }
+  .report-note {
+    margin: 4px 0 0;
+    font-size: 11px;
+    color: var(--report-muted);
+  }
+
   section.report-section {
     margin-top: 18px;
     break-inside: avoid;
@@ -186,7 +206,12 @@ ${t.map(r=>`<div class="metric">
     padding-top: 3px;
     padding-bottom: 5px;
     color: var(--report-muted);
-    font-size: 10px;
+    /* 11px, not 10px. This document prints (see @page below), where 10px is
+       about 7.5pt \u2014 too small to read on paper. The report keeps its own
+       document scale (20 title / 18 stat / 13 / 12 body / 11 label) rather than
+       the app's denser tiers; this is a print-legibility floor, not an
+       alignment to those. */
+    font-size: 11px;
     font-weight: 600;
     text-transform: uppercase;
     letter-spacing: 0.08em;
@@ -230,7 +255,7 @@ ${t.map(r=>`<div class="metric">
     padding: 1px 6px;
     border: 1px solid transparent;
     border-radius: 999px;
-    font-size: 10px;
+    font-size: 11px;   /* print floor \u2014 see the table-header note above */
     font-weight: 600;
     line-height: 1.35;
     letter-spacing: 0.04em;