reporting-labs 0.6.0 → 0.6.2

package/dist/template.js

@@ -660,6 +660,12 @@ a.btn{text-decoration:none}
 .skp{list-style:none;margin:0;padding:0} .skp li{border-top:1px solid var(--line)} .skp li:first-child{border-top:0}
 .skp button{width:100%;text-align:left;padding:8px 4px;display:flex;flex-direction:column;gap:2px}
 .skp .t{font-size:13px;font-weight:500;color:var(--ink)} .skp .r{font-size:12px;color:var(--ink-3)}
+.gchart .gchart-head{display:flex;justify-content:space-between;align-items:flex-start;gap:12px}
+.gchart .gchart-head h2{margin:0}
+.gchart .gchart-sub{color:var(--ink-3);font-size:12px;margin-top:4px}
+.gchart .gchart-body{margin-top:14px}
+.gchart .empty{padding:22px 0;color:var(--ink-3);text-align:center}
+.graphs-grid .card{background:var(--surface)}
 .kv.env{grid-template-columns:max-content 1fr;gap:8px 16px} .kv.env dt{font-size:11.5px;font-weight:600;letter-spacing:.05em;text-transform:uppercase;padding-top:1px} .kv.env dd{font:12.5px var(--mono);word-break:break-word} .kv.env a{color:var(--accent-2)}
 .hm-wrap{overflow-x:auto} .hm{border-collapse:separate;border-spacing:4px;font-size:12.5px;min-width:100%}
 .hm th{font-weight:600;color:var(--ink-2);text-align:left;padding:4px 8px;white-space:nowrap} .hm thead th{font:600 11px var(--mono);color:var(--ink-3);text-align:center;letter-spacing:.03em}
@@ -740,6 +746,7 @@ app.append(h('div',{class:'band'}, stripe(), header(), nav()),
   h('div',{class:'view','data-view':'tests'}, main()),
   h('div',{class:'view','data-view':'failures'}, h('div',{class:'view-pad'}, failuresView())),
   h('div',{class:'view','data-view':'api'}, h('div',{class:'view-pad'}, apiView())),
+  h('div',{class:'view','data-view':'graphs'}, graphsView()),
   hasTimelineView()? h('div',{class:'view','data-view':'timeline'}, h('div',{class:'view-pad'}, timelineView())) : null);
 select(state.selected || firstInteresting(), true);
 showView(state.view);
@@ -747,7 +754,7 @@ window.addEventListener('keydown', e=>{
   if(e.key==='Escape'){const lb=$('.lb'); if(lb) lb.remove(); return;}
   const tag=(e.target.tagName||'').toLowerCase(); if(tag==='input'||tag==='select'||tag==='textarea') return;
   if(e.key==='/'){ e.preventDefault(); showView('tests'); $('.tools input').focus(); return; }
-  const vk={'1':'overview','2':'tests','3':'failures','4':'api','5':'timeline'}[e.key]; if(vk&&document.querySelector('.nav button[data-view='+vk+']')){ showView(vk); return; }
+  const vk={'1':'overview','2':'tests','3':'failures','4':'api','5':'graphs','6':'timeline'}[e.key]; if(vk&&document.querySelector('.nav button[data-view='+vk+']')){ showView(vk); return; }
   if(e.key==='f'){ state.status=state.status==='failed'?'all':'failed'; refresh(); return; }
   if(e.key==='j'||e.key==='k'){ const ids=[...document.querySelectorAll('.item')].map(i=>i.dataset.id); if(!ids.length) return; let i=ids.indexOf(state.selected); i=e.key==='j'?Math.min(ids.length-1,i+1):Math.max(0,i-1); select(ids[i]); }
 });
@@ -762,7 +769,7 @@ function showView(v){
 }
 function nav(){
   const s=data.stats, f=s.failed+s.timedOut+s.interrupted, apiN=data.tests.reduce((a,t)=>a+t.results.reduce((b,r)=>b+r.api.length,0),0);
-  const tabs=[['overview','Overview',null],['tests','Tests',s.total],['failures','Failures',f+s.flaky,f>0],['api','API',apiN],['timeline','Timeline',null]].filter(t=>(t[0]!=='api'||apiN>0)&&(t[0]!=='timeline'||hasTimelineView()));
+  const tabs=[['overview','Overview',null],['tests','Tests',s.total],['failures','Failures',f+s.flaky,f>0],['api','API',apiN],['graphs','Graphs',null],['timeline','Timeline',null]].filter(t=>(t[0]!=='api'||apiN>0)&&(t[0]!=='timeline'||hasTimelineView())&&(t[0]!=='graphs'||data.tests.length>0));
   return h('nav',{class:'nav'}, h('div',{}, tabs.map(([v,l,n,bad])=>h('button',{'data-view':v,'aria-selected':state.view===v,onclick:()=>showView(v)}, l, n!=null?h('span',{class:'cnt'+(bad?' bad':'')},n):null))));
 }
 function failuresView(){
@@ -802,6 +809,214 @@ function timelineView(){
   return h('div',{class:'grid'}, cards);
 }
 function hasTimelineView(){ return data.options.widgets.timeline!==false || data.options.widgets.durations!==false; }
+
+/* ---------- Graphs tab: 4 presentation-ready charts with PNG download ---------- */
+function gEsc(s){ return String(s==null?'':s).replace(/[&<>"']/g, c => ({ '&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c])); }
+function graphsView(){
+  return h('div',{class:'view-pad'},
+    h('div',{class:'grid graphs-grid'},
+      chartCard('outcomes-by-priority', 'Outcomes by priority', 'Stacked pass / fail / flaky / skipped for each priority tier.', chartPriorityOutcome),
+      chartCard('failure-categories',   'Failure categories',    'What kinds of failures are hurting the suite.',              chartFailureCategories),
+      chartCard('duration-distribution','Duration distribution', 'How test durations are spread across the run.',              chartDurationHistogram),
+      chartCard('trend-by-priority',    'Pass rate trend by priority', 'How each priority tier trends over the last runs.',   chartTrendByPriority),
+      chartCard('owner-leaderboard',    'Owner leaderboard',      'Failures and flakes ranked by owner. Add meta({owner:...}) to see this.', chartOwnerLeaderboard),
+    ));
+}
+
+/* Chart 5: horizontal stacked bar per owner — total tests, failed vs flaky highlighted */
+function chartOwnerLeaderboard(){
+  const rows = new Map();
+  for(const t of data.tests){
+    const o = (t.meta.owner||'').toString().trim(); if(!o) continue;
+    let r = rows.get(o); if(!r){ r={owner:o, total:0, failed:0, flaky:0, passed:0, skipped:0}; rows.set(o,r); }
+    r.total++;
+    if(isFail(t.outcome)) r.failed++;
+    else if(t.outcome==='flaky') r.flaky++;
+    else if(t.outcome==='skipped') r.skipped++;
+    else if(t.outcome==='passed') r.passed++;
+  }
+  const list = [...rows.values()].sort((a,b)=> (b.failed - a.failed) || (b.flaky - a.flaky) || (b.total - a.total));
+  if(!list.length) return null;
+  const maxTotal = Math.max(...list.map(r=>r.total));
+  const W=520, rowH=28, gap=8, labW=110, barW=W-labW-70;
+  const H = list.length*(rowH+gap)+30;
+  const parts = list.map((r,i)=>{
+    const y=i*(rowH+gap)+14, scale=barW/maxTotal;
+    const passedW = r.passed*scale, flakyW = r.flaky*scale, failedW = r.failed*scale, skippedW = r.skipped*scale;
+    let x = labW;
+    const segs=[];
+    if(passedW>0){ segs.push('<rect x="'+x+'" y="'+y+'" width="'+passedW+'" height="'+rowH+'" fill="var(--pass)" rx="3"><title>'+gEsc(r.owner)+' · '+r.passed+' passed</title></rect>'); x+=passedW; }
+    if(flakyW>0){  segs.push('<rect x="'+x+'" y="'+y+'" width="'+flakyW+'"  height="'+rowH+'" fill="var(--flaky)"><title>'+gEsc(r.owner)+' · '+r.flaky+' flaky</title></rect>');   x+=flakyW; }
+    if(failedW>0){ segs.push('<rect x="'+x+'" y="'+y+'" width="'+failedW+'" height="'+rowH+'" fill="var(--fail)"><title>'+gEsc(r.owner)+' · '+r.failed+' failed</title></rect>');  x+=failedW; }
+    if(skippedW>0){segs.push('<rect x="'+x+'" y="'+y+'" width="'+skippedW+'" height="'+rowH+'" fill="var(--skip)"><title>'+gEsc(r.owner)+' · '+r.skipped+' skipped</title></rect>'); x+=skippedW; }
+    return '<text x="0" y="'+(y+rowH/2+4)+'" fill="var(--ink)" font-size="12" font-weight="600">'+gEsc(r.owner)+'</text>'+segs.join('')+
+      '<text x="'+(labW+barW+8)+'" y="'+(y+rowH/2+4)+'" fill="var(--ink-2)" font-size="12" font-variant-numeric="tabular-nums">'+r.total+'</text>';
+  }).join('');
+  const legendPairs = [['Passed','var(--pass)'],['Flaky','var(--flaky)'],['Failed','var(--fail)'],['Skipped','var(--skip)']];
+  const hasKind = { Passed:list.some(r=>r.passed>0), Flaky:list.some(r=>r.flaky>0), Failed:list.some(r=>r.failed>0), Skipped:list.some(r=>r.skipped>0) };
+  const legend = legendPairs.filter(([n])=>hasKind[n]).map(([n,c],i)=>'<g transform="translate('+(labW+i*90)+','+(H-4)+')"><rect width="10" height="10" y="-9" fill="'+c+'"/><text x="14" y="0" font-size="11" fill="var(--ink-2)">'+n+'</text></g>').join('');
+  return h('div',{class:'gchart-body',html:'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 '+W+' '+(H+14)+'" width="100%">'+parts+legend+'</svg>'});
+}
+
+function chartCard(id, title, sub, chartFn){
+  const chart = chartFn();
+  const empty = !chart;
+  return h('div',{class:'card w6 gchart','data-chart':id},
+    h('div',{class:'gchart-head'},
+      h('div',{},
+        h('h2',{},title),
+        h('div',{class:'gchart-sub'},sub)),
+      empty? null : h('button',{class:'btn',title:'Download this chart as a PNG image',
+        onclick:e=>downloadChartPng(id, title, e.currentTarget)},'Download PNG')),
+    empty? h('div',{class:'empty'},'Not enough data yet. Add meta({ priority }) or run the suite once more.') : chart);
+}
+
+/* Chart 1: horizontal stacked bar per priority (P0..P4 in order, plus 'no priority') */
+function chartPriorityOutcome(){
+  const order = ['P0','P1','P2','P3','P4'];
+  const outs  = ['passed','flaky','failed','timedOut','interrupted','skipped'];
+  const colors= {passed:'var(--pass)', flaky:'var(--flaky)', failed:'var(--fail)', timedOut:'var(--fail)', interrupted:'var(--fail)', skipped:'var(--skip)'};
+  const buckets = new Map();
+  const put=(k,o)=>{ let m=buckets.get(k); if(!m){ m={}; for(const x of outs) m[x]=0; buckets.set(k,m); } m[o]=(m[o]||0)+1; };
+  for(const t of data.tests){ const p=(t.meta.priority||'').toString().trim().toUpperCase(); put(order.includes(p)? p : 'No priority', t.outcome); }
+  const rows = [...order.filter(k=>buckets.has(k)), ...(buckets.has('No priority')?['No priority']:[])];
+  if(!rows.length) return null;
+  const maxN = Math.max(...rows.map(r=>outs.reduce((a,o)=>a+buckets.get(r)[o],0)));
+  const W=520, rowH=34, gap=10, labW=90, barW=W-labW-70;
+  const H = rows.length*(rowH+gap)+30;
+  const parts = rows.map((r,i)=>{
+    const y=i*(rowH+gap)+18, m=buckets.get(r), tot=outs.reduce((a,o)=>a+m[o],0), scale=barW/maxN;
+    let x=labW;
+    const segs=[]; for(const o of outs){ const w=m[o]*scale; if(w<=0) continue; segs.push('<rect x="'+x+'" y="'+y+'" width="'+w+'" height="'+rowH+'" fill="'+colors[o]+'" data-outcome="'+o+'"><title>'+r+' · '+label[o]+' '+m[o]+'</title></rect>'); x+=w; }
+    return '<text x="0" y="'+(y+rowH/2+4)+'" fill="var(--ink)" font-size="12" font-weight="600">'+r+'</text>'+
+      segs.join('')+
+      '<text x="'+(labW+barW+8)+'" y="'+(y+rowH/2+4)+'" fill="var(--ink-2)" font-size="12" font-variant-numeric="tabular-nums">'+tot+'</text>';
+  }).join('');
+  const legend = outs.filter(o=>rows.some(r=>buckets.get(r)[o]>0)).map(o=>'<g><rect width="10" height="10" fill="'+colors[o]+'"/><text x="14" y="9" fill="var(--ink-2)" font-size="11">'+label[o]+'</text></g>');
+  const legendSvg = '<g transform="translate('+labW+','+(H-2)+')">'+legend.map((g,i)=>'<g transform="translate('+(i*90)+',0)">'+g.slice(3,-4)+'</g>').join('')+'</g>';
+  return h('div',{class:'gchart-body',html:'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 '+W+' '+(H+18)+'" width="100%">'+parts+legendSvg+'</svg>'});
+}
+
+/* Chart 2: horizontal bar of the 18 error 'kinds' from explainError, sorted by count desc */
+function chartFailureCategories(){
+  const counts = new Map();
+  for(const t of data.tests){ const r=t.results[t.results.length-1], e=r&&r.errors[0]; if(!e||!e.explain) continue; const k=e.explain.label||e.explain.kind||'other'; counts.set(k,(counts.get(k)||0)+1); }
+  const rows=[...counts.entries()].sort((a,b)=>b[1]-a[1]);
+  if(!rows.length) return null;
+  const maxN = rows[0][1];
+  const W=520, rowH=22, gap=6, labW=200, barW=W-labW-40;
+  const H = rows.length*(rowH+gap)+8;
+  const parts = rows.map(([k,n],i)=>{
+    const y=i*(rowH+gap)+8, w=Math.max(2, n/maxN*barW);
+    return '<text x="0" y="'+(y+rowH/2+4)+'" fill="var(--ink)" font-size="12">'+gEsc(k)+'</text>'+
+      '<rect x="'+labW+'" y="'+y+'" width="'+w+'" height="'+rowH+'" fill="var(--fail)" rx="3"><title>'+gEsc(k)+' · '+n+'</title></rect>'+
+      '<text x="'+(labW+w+6)+'" y="'+(y+rowH/2+4)+'" fill="var(--ink-2)" font-size="12" font-variant-numeric="tabular-nums">'+n+'</text>';
+  }).join('');
+  return h('div',{class:'gchart-body',html:'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 '+W+' '+H+'" width="100%">'+parts+'</svg>'});
+}
+
+/* Chart 3: duration histogram — bars for 5 buckets across all tests */
+function chartDurationHistogram(){
+  if(!data.tests.length) return null;
+  const buckets = [
+    {label:'< 1s',   min:0,    max:1000},
+    {label:'1-3s',   min:1000, max:3000},
+    {label:'3-10s',  min:3000, max:10000},
+    {label:'10-30s', min:10000,max:30000},
+    {label:'30s+',   min:30000,max:Infinity},
+  ];
+  const counts = buckets.map(()=>0);
+  for(const t of data.tests){ const d=t.duration||0; for(let i=0;i<buckets.length;i++){ if(d>=buckets[i].min && d<buckets[i].max){ counts[i]++; break; } } }
+  const maxN = Math.max(1,...counts);
+  const W=520, colW=80, gap=16, padL=32, padT=24, padB=36, chartH=180;
+  const H = chartH+padT+padB;
+  const bars = counts.map((n,i)=>{
+    const x=padL+i*(colW+gap), h=n/maxN*chartH, y=padT+chartH-h;
+    return '<rect x="'+x+'" y="'+y+'" width="'+colW+'" height="'+h+'" fill="var(--accent)" rx="3"><title>'+buckets[i].label+' · '+n+' tests</title></rect>'+
+      (n>0?'<text x="'+(x+colW/2)+'" y="'+(y-4)+'" text-anchor="middle" fill="var(--ink)" font-size="12" font-weight="600" font-variant-numeric="tabular-nums">'+n+'</text>':'')+
+      '<text x="'+(x+colW/2)+'" y="'+(padT+chartH+22)+'" text-anchor="middle" fill="var(--ink-2)" font-size="12">'+buckets[i].label+'</text>';
+  }).join('');
+  return h('div',{class:'gchart-body',html:'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 '+W+' '+H+'" width="100%">'+bars+'</svg>'});
+}
+
+/* Chart 4: multi-line — pass rate per priority over the last N history entries */
+function chartTrendByPriority(){
+  const hist = data.history || [];
+  if(hist.length < 2) return null;
+  const orders = ['P0','P1','P2','P3','P4'];
+  const seenPri = new Set();
+  for(const t of data.tests){ const p=(t.meta.priority||'').toString().trim().toUpperCase(); if(orders.includes(p)) seenPri.add(p); }
+  const priorities = orders.filter(p=>seenPri.has(p));
+  if(!priorities.length) return null;
+  const colors = { P0:'#E5405E', P1:'#F59E0B', P2:'#3B82F6', P3:'#8B95A5', P4:'#6B7280' };
+  const currentTests = new Map(data.tests.map(t=>[t.key, (t.meta.priority||'').toString().trim().toUpperCase()]));
+  const series = priorities.map(pri=>{
+    const points = hist.map(e=>{
+      let p=0,f=0; for(const [key,val] of Object.entries(e.tests||{})){ if(currentTests.get(key)!==pri) continue; const outcome=val[0]||''; if(outcome==='p') p++; else if(outcome==='f'||outcome==='t'||outcome==='i') f++; }
+      const ran = p+f; return ran? Math.round(p/ran*100) : null;
+    });
+    return { pri, color: colors[pri]||'#888', points };
+  }).filter(sr=>sr.points.some(v=>v!==null));
+  if(!series.length) return null;
+  const W=520, padL=36, padR=24, padT=16, padB=28, chartH=180;
+  const H = chartH+padT+padB;
+  const N = hist.length;
+  const xAt = i => padL + (N===1? 0 : i*((W-padL-padR)/(N-1)));
+  const yAt = pct => padT + (100-pct)/100*chartH;
+  const grid = [0,25,50,75,100].map(y=>'<line x1="'+padL+'" x2="'+(W-padR)+'" y1="'+yAt(y)+'" y2="'+yAt(y)+'" stroke="var(--line)" stroke-dasharray="2 3"/><text x="'+(padL-6)+'" y="'+(yAt(y)+3)+'" text-anchor="end" font-size="10" fill="var(--ink-3)">'+y+'%</text>').join('');
+  const lines = series.map(sr=>{
+    // A series may start with (or contain) nulls — runs where this priority
+    // had no tests. Each stretch after a gap must restart with M, or the
+    // path begins with L and the browser rejects it.
+    let pen=false;
+    const d = sr.points.map((v,i)=>{ if(v===null){ pen=false; return null; } const cmd=pen?'L':'M'; pen=true; return cmd+xAt(i)+' '+yAt(v); }).filter(Boolean).join(' ');
+    const dots = sr.points.map((v,i)=> v===null? '' : '<circle cx="'+xAt(i)+'" cy="'+yAt(v)+'" r="2.5" fill="'+sr.color+'"><title>'+sr.pri+' · '+v+'% at run '+(i+1)+'</title></circle>').join('');
+    return '<path d="'+d+'" fill="none" stroke="'+sr.color+'" stroke-width="2" stroke-linejoin="round" stroke-linecap="round"/>'+dots;
+  }).join('');
+  const legend = series.map((sr,i)=>'<g transform="translate('+(padL+i*70)+','+(H-8)+')"><rect width="10" height="10" y="-9" fill="'+sr.color+'"/><text x="14" y="0" font-size="11" fill="var(--ink-2)">'+sr.pri+'</text></g>').join('');
+  return h('div',{class:'gchart-body',html:'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 '+W+' '+H+'" width="100%">'+grid+lines+legend+'</svg>'});
+}
+
+/* PNG download: serialize the chart's SVG, draw onto a canvas at 2x, trigger download. */
+function downloadChartPng(chartId, title, btn){
+  const card = document.querySelector('[data-chart="'+chartId+'"]');
+  const src  = card && card.querySelector('svg');
+  if(!src) return;
+  const label = btn.textContent; btn.textContent = 'Rendering…'; btn.disabled = true;
+  const clone = src.cloneNode(true);
+  clone.setAttribute('xmlns','http://www.w3.org/2000/svg');
+  // Inline computed colors so CSS var() references resolve inside the standalone SVG.
+  const cs = getComputedStyle(document.documentElement);
+  const varRe = /var\(--([a-z0-9-]+)\)/gi;
+  const walk = el => { for(const a of ['fill','stroke']){ const v=el.getAttribute(a); if(v && varRe.test(v)){ el.setAttribute(a, v.replace(varRe,(_,n)=>cs.getPropertyValue('--'+n).trim() || 'currentColor')); } } for(const c of el.children) walk(c); };
+  walk(clone);
+  // Ensure the SVG has explicit width/height (in px) for correct raster size.
+  const vb = clone.viewBox && clone.viewBox.baseVal;
+  const w = (vb && vb.width) || 800, hpx = (vb && vb.height) || 400;
+  const scale = 2;
+  clone.setAttribute('width', w); clone.setAttribute('height', hpx);
+  const xml = new XMLSerializer().serializeToString(clone);
+  const svgBlob = new Blob([xml], {type:'image/svg+xml;charset=utf-8'});
+  const url = URL.createObjectURL(svgBlob);
+  const img = new Image();
+  img.onload = () => {
+    const canvas = document.createElement('canvas');
+    canvas.width = w*scale; canvas.height = hpx*scale;
+    const ctx = canvas.getContext('2d');
+    ctx.fillStyle = cs.getPropertyValue('--surface').trim() || '#ffffff';
+    ctx.fillRect(0,0,canvas.width,canvas.height);
+    ctx.drawImage(img, 0, 0, canvas.width, canvas.height);
+    URL.revokeObjectURL(url);
+    canvas.toBlob(b => {
+      const a = document.createElement('a');
+      a.href = URL.createObjectURL(b); a.download = 'reporting-labs-'+chartId+'.png'; a.click();
+      URL.revokeObjectURL(a.href);
+      btn.textContent = label; btn.disabled = false;
+    }, 'image/png');
+  };
+  img.onerror = () => { btn.textContent = 'PNG failed'; btn.disabled = false; URL.revokeObjectURL(url); };
+  img.src = url;
+}
 function stripe(){
   const s=data.stats, f=s.failed+s.timedOut+s.interrupted, tot=s.total||1;
   return h('div',{class:'stripe','aria-hidden':'true'}, [['passed',s.passed],['flaky',s.flaky],['failed',f],['skipped',s.skipped]].filter(x=>x[1]).map(([k,n])=>h('i',{style:'width:'+(n/tot*100)+'%;background:'+colorOf(k)})));
@@ -1339,8 +1554,8 @@ function renderDetail(t){
       editorLink(t))),
     h('div',{class:'badges'}, h('span',{class:'badge '+t.outcome},label[t.outcome]), t.expectedFailure? h('span',{class:'badge xfail',title:'Marked test.fail(): failing is the expected result'},'Expected failure') : null, sinceBadge(t), dots(t,10), data.bdd?h('span',{class:'badge scenario'},'Scenario'):null, t.tags.map(g=>h('span',{class:'badge tag'},g)), data.projects.length>1?h('span',{class:'badge tag'},t.project):null, h('span',{class:'loc'}, t.file+':'+t.line+' · '+ms(t.duration)+(t.outcome==='timedOut'&&t.timeout?' · timeout '+ms(t.timeout):'')+(t.retries?' · retries '+t.retries:''))));
   const metaKeys=Object.keys(t.meta);
-  const linkFor=(k,v)=>{ const tpl=data.options.links[k]||data.options.links['*']; if(tpl) return tpl.replace('{id}',encodeURIComponent(v)); if(/^https?:\/\//.test(v)) return v; return null; };
-  if(metaKeys.length) d.append(h('div',{class:'metas'}, metaKeys.map(k=>{ const v=t.meta[k], low=/^(P[3-4]|low|minor|trivial|normal|medium)$/i.test(v), href=linkFor(k,v); return h('span',{class:'meta '+k+(low?' low':'')}, h('span',{class:'k'},k), href? h('a',{href,target:'_blank',rel:'noopener'},v) : h('span',{class:'v'},v)); })));
+  const linkFor=(k,v)=>{ if(t.links&&t.links[k]) return t.links[k]; const tpl=data.options.links[k]||data.options.links['*']; if(tpl) return tpl.replace('{id}',encodeURIComponent(v)); if(/^https?:\/\//.test(v)) return v; return null; };
+  if(metaKeys.length) d.append(h('div',{class:'metas'}, metaKeys.map(k=>{ const v=t.meta[k], low=/^(P[3-4]|low|minor|trivial|normal|medium)$/i.test(v); const parts=(t.links&&t.links[k])||!data.options.links[k]&&!data.options.links['*']?[v]:v.split(/,\s+/); const nodes=[]; parts.forEach((part,i)=>{ const href=linkFor(k,part); if(i) nodes.push(', '); nodes.push(href? h('a',{href,target:'_blank',rel:'noopener'},part) : h('span',{class:'v'},part)); }); return h('span',{class:'meta '+k+(low?' low':'')}, h('span',{class:'k'},k), ...nodes); })));
   const otherAnn=t.annotations.filter(a=>!DIMS.includes(a.type.toLowerCase()) && !(a.type.toLowerCase() in t.meta));
   if(otherAnn.length) d.append(h('h4',{},'Annotations'), h('dl',{class:'kv'}, otherAnn.map(a=>[h('dt',{},a.type),h('dd',{},a.description||'')])));
   if(t.results.length>1){

package/dist/types.d.ts

@@ -77,8 +77,14 @@ export interface ReportingLabsOptions {
     /**
      * Turn meta values into links. Key = meta key (story, epic, ticket, issue, jira...), value = URL template with {id}.
      * e.g. { story: 'https://acme.atlassian.net/browse/{id}', epic: 'https://acme.atlassian.net/browse/{id}' }
+     *
+     * A link that needs more than the displayed value takes an object. Placeholders name the fields of the
+     * object passed to meta(); `display` (default '{id}') is what the report shows, the rest only builds the URL:
+     *   links: { octaneTestCase: { url: 'https://oss.valueedge.com/ui/?p={p}#/entity-navigation?entityType=test&id={id}', display: '{id}' } }
+     *   meta({ octaneTestCase: { id: '58966', p: '4001/14014' } })
+     * The report shows "octaneTestCase 58966", clicking it opens the full URL; p is never shown.
      */
-    links?: Record<string, string>;
+    links?: Record<string, string | LinkTemplate>;
     /** Keys (case-insensitive substrings) whose values are masked in test data and API panels. */
     maskKeys?: string[];
     /** Keep a rolling run history next to the report and draw a trend chart. Per-test outcomes are stored too, which powers new-vs-known failures, flaky history and duration regressions. */
@@ -94,6 +100,13 @@ export interface ReportingLabsOptions {
     /** Style Given/When/Then steps as Gherkin and label describe blocks as Features/Scenarios. Default: auto-detect */
     bdd?: boolean;
 }
+/** A link built from several fields of a meta() object. */
+export interface LinkTemplate {
+    /** URL with {field} placeholders, e.g. 'https://tms.example.com/{project}/cases/{id}'. */
+    url: string;
+    /** What the report shows for this meta key, with the same placeholders. Default '{id}'. */
+    display?: string;
+}
 /** Lets you type a known value and still accept any string. */
 export type Loose<T extends string> = T | (string & {});
 /**
@@ -114,14 +127,14 @@ export interface TestMeta extends CustomMeta {
     feature?: string;
     /** Epic key, e.g. 'EPIC-18'. Becomes a link when `links.epic` is configured. */
     epic?: string;
-    /** User story key, e.g. 'SHOP-250'. Becomes a link when `links.story` is configured. */
-    story?: string;
-    /** Bug / issue key this test guards against, e.g. 'PROMO-118'. */
-    issue?: string;
+    /** User story key, e.g. 'SHOP-250', or several. Becomes a link when `links.story` is configured. */
+    story?: string | string[];
+    /** Bug / issue key this test guards against, e.g. 'PROMO-118', or several. */
+    issue?: string | string[];
     /** Test case id in your TCM tool (TestRail, Xray, Zephyr...). */
     testCaseId?: string;
-    /** Free-form tags or any other key you like. */
-    [key: string]: string | number | undefined;
+    /** Free-form tags or any other key you like. An object holds the fields of a multi-parameter link, see `links`. */
+    [key: string]: string | number | (string | number)[] | Record<string, string | number> | undefined;
 }
 /** Empty by default; augment it to add typed keys of your own. */
 export interface CustomMeta {
@@ -237,6 +250,8 @@ export interface TestData {
     }[];
     /** extracted dimension values, e.g. { priority: 'P1', severity: 'critical' } */
     meta: Record<string, string>;
+    /** Ready-made hrefs for meta keys whose link needed more than the displayed value (object meta + LinkTemplate). */
+    links?: Record<string, string>;
     outcome: Status;
     duration: number;
     results: ResultData[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reporting-labs",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "reportingLabs – beautiful, customizable single-file HTML test reports. One line of config. Playwright adapter included, more runners on the way.",
   "keywords": [
     "test-report",
@@ -43,7 +43,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "tsc -p tsconfig.json && node bin/build-template.js",
     "demo": "npm run build && cd example && npx playwright test; cd .. && echo 'open example/reporting-labs/index.html'",
     "prepublishOnly": "npm run build",
     "pack:check": "npm run build && npm pack --dry-run"