File size: 22,340 Bytes
692cfd0
 
 
54fbf53
 
692cfd0
54fbf53
58b4c7d
692cfd0
 
 
 
 
 
 
 
9c441d2
692cfd0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
54fbf53
 
692cfd0
 
54fbf53
692cfd0
 
9c441d2
692cfd0
 
 
f92b2e1
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
54fbf53
 
 
 
 
 
 
 
 
 
 
692cfd0
 
 
 
 
 
 
 
 
 
 
 
 
56180a7
1fc6257
 
56180a7
 
 
 
 
 
 
 
 
 
692cfd0
 
 
 
 
 
 
1fc6257
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
9c441d2
b994870
9c441d2
 
 
 
b994870
 
 
 
 
9c441d2
 
 
 
901faa6
 
 
 
 
42f1fba
 
 
 
3eb8e8d
9c441d2
42f1fba
 
 
9c441d2
 
 
42f1fba
9c441d2
42f1fba
9c441d2
54fbf53
9c441d2
 
 
 
 
 
 
 
 
b994870
9c441d2
 
 
3eb8e8d
 
 
54fbf53
9c441d2
f92b2e1
 
 
 
3eb8e8d
42f1fba
 
 
 
 
692cfd0
 
9c441d2
54fbf53
65801b6
9c441d2
65801b6
f92b2e1
 
54fbf53
 
692cfd0
54fbf53
692cfd0
 
 
 
 
 
 
 
 
f92b2e1
 
 
3eb8e8d
f92b2e1
692cfd0
65801b6
42f1fba
901faa6
9c441d2
42f1fba
 
 
9c441d2
 
42f1fba
692cfd0
f92b2e1
3eb8e8d
f92b2e1
 
 
 
 
 
 
 
 
 
692cfd0
9c441d2
 
 
 
692cfd0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
65801b6
 
 
 
 
 
692cfd0
 
65801b6
 
 
 
692cfd0
65801b6
692cfd0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
// One deterministic renderer for preview, individual exports, and the overview.
export const KINDS = ['space', 'model', 'dataset', 'paper', 'blog'];
export const LABELS = {space:'Spaces', model:'Models', dataset:'Datasets', paper:'Papers', blog:'Blog posts'};
export const WIDTHS = {slim:240,wide:320,wider:640};
export const spineWidth = mode => WIDTHS[mode] || WIDTHS.slim;
export const ICONS = {
  chip:'M7 7h10v10H7z M9 3v4 M15 3v4 M9 17v4 M15 17v4 M3 9h4 M3 15h4 M17 9h4 M17 15h4',
  calendar:'M5 4h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2z M7 2v4 M17 2v4 M3 10h18 M8 14h2 M14 14h2 M8 18h2',
  space:'M4 5h16a1 1 0 0 1 1 1v13a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V6a1 1 0 0 1 1-1z M3 10h18 M6 7.5h.1 M9 7.5h.1 M12 7.5h.1',
  model:'M12 6a2.5 2.5 0 1 0 0-5 2.5 2.5 0 0 0 0 5z M5 22a2.5 2.5 0 1 0 0-5 2.5 2.5 0 0 0 0 5z M19 22a2.5 2.5 0 1 0 0-5 2.5 2.5 0 0 0 0 5z M10.7 5.7 6.2 17 M13.3 5.7 17.8 17 M7.5 19.5h9',
  dataset:'M20 5c0 2-3.6 3.5-8 3.5S4 7 4 5s3.6-3.5 8-3.5S20 3 20 5z M4 5v14c0 2 3.6 3.5 8 3.5s8-1.5 8-3.5V5 M4 12c0 2 3.6 3.5 8 3.5s8-1.5 8-3.5',
  paper:'M5 2h9l5 5v15H5z M14 2v6h5 M8 12h8 M8 16h8 M8 19h5',
  blog:'M4 20l1-5L17 3a2 2 0 0 1 3 3L8 18z M14.5 5.5l3 3 M3 22h18',
  plus:'M12 5v14 M5 12h14', close:'M6 6l12 12 M18 6 6 18',
  search:'M17 10a7 7 0 1 1-14 0 7 7 0 0 1 14 0z M15.3 15.3 21 21',
  down:'M6 9l6 6 6-6', up:'M6 15l6-6 6 6',
  upvote:'M12 21V3 M5 10l7-7 7 7',
  grip:'M9 5h.1 M15 5h.1 M9 12h.1 M15 12h.1 M9 19h.1 M15 19h.1',
  heart:'M20.8 4.6a5.5 5.5 0 0 0-7.8 0L12 5.7l-1.1-1.1a5.5 5.5 0 0 0-7.8 7.8L12 21l8.8-8.6a5.5 5.5 0 0 0 0-7.8z',
  download:'M12 3v12 M7 10l5 5 5-5 M4 16v5h16v-5',
  link:'M10 13a5 5 0 0 0 7 .1l4-4a5 5 0 0 0-7-7l-2 2 M14 11a5 5 0 0 0-7-.1l-4 4a5 5 0 0 0 7 7l2-2',
  arrow:'M7 17 17 7 M7 7h10v10', check:'m5 12 4 4L19 6',
  refresh:'M20 7a9 9 0 1 0 1 8 M20 3v5h-5',
  edit:'m3 21 1-6L17 2l5 5L9 20z M14 5l5 5',
  share:'M12 16V2 M7 7l5-5 5 5 M5 11H3v11h18V11h-2',
  trash:'M3 6h18 M9 6V3h6v3 M5 6l1 15h12l1-15 M10 10v7 M14 10v7',
};
export function icon(name, cls='') {
  return `<svg class="icon ${cls}" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="${ICONS[name] || ICONS.paper}"/></svg>`;
}

// Hub Space-card color tokens, observed 2026-11-18. These are NOT CSS named colors.
export const COLOR_LCH = {
  red:[.577,.245,27.325], yellow:[.666,.179,58.318], green:[.596,.145,163.225],
  blue:[.546,.245,262.881], indigo:[.511,.262,276.966], purple:[.541,.281,293.009],
  pink:[.592,.249,.584], gray:[.446,.03,256.802],
};
const lab = ([l,c,h]) => [l, c*Math.cos(h*Math.PI/180), c*Math.sin(h*Math.PI/180)];
function rgb([L,a,b]) {
  const l=(L+.3963377774*a+.2158037573*b)**3, m=(L-.1055613458*a-.0638541728*b)**3, s=(L-.0894841775*a-1.291485548*b)**3;
  const values=[4.0767416621*l-3.3077115913*m+.2309699292*s, -1.2684380046*l+2.6097574011*m-.3413193965*s, -.0041960863*l-.7034186147*m+1.707614701*s];
  const gamma=v => Math.round(255*Math.max(0,Math.min(1,v<=.0031308?12.92*v:1.055*Math.max(v,0)**(1/2.4)-.055)));
  return `rgb(${values.map(gamma).join(',')})`;
}
export const COLORS = Object.fromEntries(Object.entries(COLOR_LCH).map(([k,v])=>[k,rgb(lab(v))]));
export function gradientCSS(p) { return `linear-gradient(140deg,${COLORS[p?.from]||COLORS.blue},${COLORS[p?.to]||COLORS.indigo})`; }
export function compact(n) {
  if (!Number.isFinite(n)) return '';
  for (const [unit,div] of [['B',1e9],['M',1e6],['k',1e3]]) if(n>=div) {
    const v=n/div; return `${Number(v.toFixed(v>=100?1:2))}${unit}`;
  }
  return String(n);
}
export function facts(item) {
  const result=[];
  if(item.kind==='space' && item.hardware) result.push({value:item.hardware,label:'Hardware',icon:'chip'});
  if(['model','dataset'].includes(item.kind) && Number.isFinite(item.downloads)) result.push({value:compact(item.downloads),label:'downloads / 30d',icon:'download'});
  if(['paper','blog'].includes(item.kind) && item.publishedAt) {
    const date=new Date(item.publishedAt);
    if(!Number.isNaN(+date)) result.push({value:item.kind==='paper'?String(date.getUTCFullYear()):date.toLocaleDateString('en-US',{month:'short',year:'numeric',timeZone:'UTC'}).toUpperCase(),label:'Published',icon:'calendar'});
  }
  if(Number.isFinite(item.likes)) result.push({value:`${compact(item.likes)} likes`,icon:'heart'});
  if(Number.isFinite(item.upvotes)) result.push({value:`${compact(item.upvotes)} upvotes`,icon:'upvote'});
  return result.slice(0,2);
}

// Two semantic slots keep mixed shelves aligned, including missing public data.
export function spineFacts(item){
  const known=Number.isFinite,repo=['model','dataset'].includes(item.kind),votes=['paper','blog'].includes(item.kind);
  let value='—',label=item.kind==='space'?'Hardware':repo?'Downloads / 30d':'Published';
  if(item.kind==='space'&&typeof item.hardware==='string'&&item.hardware.trim())value=item.hardware.trim();
  if(repo&&known(item.downloads)&&item.downloads>=0)value=compact(item.downloads);
  if(votes&&item.publishedAt){
    const date=new Date(item.publishedAt);
    if(!Number.isNaN(+date))value=item.kind==='paper'?String(date.getUTCFullYear()):date.toLocaleDateString('en-US',{month:'short',year:'numeric',timeZone:'UTC'});
  }
  const count=votes?item.upvotes:item.likes;
  // Three significant digits bound a single community line; source counts stay exact.
  let community='—';
  if(known(count)&&count>=0){
    const rounded=count>=1000?Number(count.toPrecision(3)):count;
    community=compact(rounded);
  }
  return {primary:{value,label},community:{value:community,label:votes?'upvotes':'likes',icon:votes?'upvote':'heart'}};
}

export function contextFacts(item){
  const result=[];
  if(item.kind==='space'&&item.sdk)result.push({label:'SDK',value:item.sdk});
  if(item.kind==='model'&&item.library)result.push({label:'Library',value:item.library});
  if(['model','dataset'].includes(item.kind)&&item.languages)result.push({label:'Languages',value:item.languages});
  if(['space','model','dataset'].includes(item.kind)&&item.license)result.push({label:'License',value:item.license});
  if(item.kind==='paper')result.push({label:'arXiv',value:item.id});
  if(item.kind==='blog'&&item.articleType)result.push({label:'Article',value:item.articleType});
  return result;
}

function fitText(ctx, text, maxWidth, preferred, minimum, weight='600') {
  let size=preferred;
  while(true){ctx.font=`${weight} ${size}px "Source Sans 3", sans-serif`;if(ctx.measureText(text).width<=maxWidth||size<=minimum)break;size--;}
  return size;
}
function clippedText(ctx,text,width){
  if(ctx.measureText(text).width<=width)return text;
  const chars=Array.from(text);while(chars.length&&ctx.measureText(chars.join('')+'…').width>width)chars.pop();return chars.join('')+'…';
}
function wrapText(ctx,text,width,maxLines=3){
  const words=text.split(/\s+/).flatMap(word=>{
    const chunks=[];let chunk='';
    for(const char of word){if(chunk&&ctx.measureText(chunk+char).width>width){chunks.push(chunk);chunk='';}chunk+=char;}
    if(chunk)chunks.push(chunk);
    // Prefer balanced breaks at hyphens over splitting a name after its first letter.
    if(chunks.length>1){
      const chars=Array.from(chunks.slice(-2).join(''));let best=null;
      for(let i=1;i<chars.length;i++){
        const a=chars.slice(0,i).join(''),b=chars.slice(i).join(''),aw=ctx.measureText(a).width,bw=ctx.measureText(b).width;
        if(aw>width||bw>width)continue;
        const score=Math.abs(aw-bw)+(chars[i-1]==='-'?0:width*.2);
        if(!best||score<best.score)best={a,b,score};
      }
      if(best)chunks.splice(-2,2,best.a,best.b);
    }
    return chunks;
  }),lines=[];let line='';
  for(const word of words){const candidate=line?`${line} ${word}`:word;
    if(ctx.measureText(candidate).width>width&&line){lines.push(line);line=word;}else line=candidate;
  }if(line)lines.push(line);
  if(lines.length<=maxLines)return lines;
  const out=lines.slice(0,maxLines);out[maxLines-1]=lines.slice(maxLines-1).join(' ');return out;
}
function balancedTitleLines(ctx,text,width,original){
  const words=text.split(/\s+/),count=original.length;
  if(count<2||words.length<count||words.some(w=>ctx.measureText(w).width>width))return original;
  const space=ctx.measureText(' ').width,prefix=[0];
  words.forEach(w=>prefix.push(prefix.at(-1)+ctx.measureText(w).width));
  const target=(prefix.at(-1)+(words.length-count)*space)/count;
  const costs=Array.from({length:count+1},()=>Array(words.length+1).fill(Infinity)),breaks=costs.map(a=>a.map(()=>0));costs[0][0]=0;
  for(let k=1;k<=count;k++)for(let end=k;end<=words.length;end++)for(let start=k-1;start<end;start++){
    const length=prefix[end]-prefix[start]+(end-start-1)*space;
    if(length>width)continue;
    const cost=costs[k-1][start]+(length-target)**2;
    if(cost<costs[k][end]){costs[k][end]=cost;breaks[k][end]=start;}
  }
  if(!Number.isFinite(costs[count][words.length]))return original;
  const lines=[];let end=words.length;
  for(let k=count;k>0;k--){const start=breaks[k][end];lines.unshift(words.slice(start,end).join(' '));end=start;}
  return lines.every(line=>ctx.measureText(line).width<=width)?lines:original;
}
export function titleLayout(ctx,title,width,wide=false,maxHeight=Infinity){
  const wider=wide==='wider',preferred=wider?200:wide?100:84,minimum=wider?84:wide?56:52,maxLines=wider?5:wide?4:3;
  const text=title.replace(/\s+/g,' ').trim();
  for(let size=preferred;size>=minimum;size--){
    ctx.font=`600 ${size}px "Source Sans 3", sans-serif`;
    const lines=wrapText(ctx,text,width,Infinity),m=inkMetrics(ctx,'Hgj'),leading=Math.round(size*.98);
    if(lines.length<=maxLines&&m.ascent+m.descent+(lines.length-1)*leading<=maxHeight){
      const fitted=!wider&&lines.length===2?Math.min(size,wide?90:76):size;
      ctx.font=`600 ${fitted}px "Source Sans 3", sans-serif`;
      return {size:fitted,lines:balancedTitleLines(ctx,text,width,lines)};
    }
  }
  ctx.font=`600 ${minimum}px "Source Sans 3", sans-serif`;
  const m=inkMetrics(ctx,'Hgj'),count=Math.max(1,Math.min(maxLines,1+Math.floor((maxHeight-m.ascent-m.descent)/Math.round(minimum*.98))));
  return {size:minimum,lines:wrapText(ctx,text,width,count).map(line=>clippedText(ctx,line,width))};
}
export function byline(item){
  const task=typeof item.task==='string'?item.task.trim().replace(/-/g,' '):'';
  return [item.author,task?task[0].toUpperCase()+task.slice(1):''].filter(Boolean).join(' · ');
}
function inkMetrics(ctx,text){
  const metrics=ctx.measureText(text),size=Number(ctx.font.match(/([\d.]+)px/)?.[1])||40;
  return {ascent:metrics.actualBoundingBoxAscent??size*.75,descent:metrics.actualBoundingBoxDescent??size*.2};
}
// Center fixed typographic line boxes, rather than moving baselines for each word.
export function textBlockLayout(width,titleMetrics,lineHeight,authorMetrics=null,gap=14,contextMetrics=[],contextLeading=40){
  const top=Math.min(...titleMetrics.map((m,i)=>i*lineHeight-m.ascent));
  const titleBottom=Math.max(...titleMetrics.map((m,i)=>i*lineHeight+m.descent));
  const author=authorMetrics?titleBottom+gap+authorMetrics.ascent:null;
  const bodyBottom=authorMetrics?author+authorMetrics.descent:titleBottom;
  const context=contextMetrics.map((m,i)=>bodyBottom+22+contextMetrics[0].ascent+i*contextLeading);
  const bottom=context.length?context.at(-1)+contextMetrics.at(-1).descent:bodyBottom;
  const offset=(width-(bottom-top))/2-top;
  return {title:titleMetrics.map((_,i)=>offset+i*lineHeight),author:author===null?null:offset+author,context:context.map(y=>y+offset)};
}
export function spineTypography(ctx,title,author,width,maxLength,context=[]){
  ctx.font=`400 ${width===640?48:width===320?44:40}px "Source Sans 3", sans-serif`;
  const authorFont=ctx.font,authorText=clippedText(ctx,author,maxLength),authorMetrics=author?inkMetrics(ctx,'Hgj'):null;
  ctx.font='400 36px "Source Sans 3", sans-serif';
  const contextFont=ctx.font,contextMetrics=inkMetrics(ctx,'Hgj');
  const contextText=context.flatMap((text,i)=>wrapText(ctx,text,maxLength,1).map(line=>{
    let value=clippedText(ctx,line,maxLength);
    if(value.endsWith('…')&&value.includes(' '))value=value.slice(0,value.lastIndexOf(' '))+'…';
    return value;
  })).slice(0,2);
  const reserved=(authorMetrics?authorMetrics.ascent+authorMetrics.descent+14:0)+(contextText.length?22+contextMetrics.ascent+contextMetrics.descent+(contextText.length-1)*40:0);
  const margin=width===640?36:width===320?30:20;
  const {size,lines}=titleLayout(ctx,title,maxLength,width===640?'wider':width===320,width-2*margin-reserved),titleFont=ctx.font,reference=inkMetrics(ctx,'Hgj');
  const layout=textBlockLayout(width,lines.map(()=>reference),Math.round(size*.98),authorMetrics,14,contextText.map(()=>contextMetrics));
  return {lines,titleFont,authorFont,authorText,contextFont,contextText,layout};
}
export function spineGeometry(width,options={},hasFacts=false){
  const ranked=options.numbers!==false,details=options.details!==false&&hasFacts;
  const base=1930-(ranked?128:0)-(details?280:0);
  return {base,ruleY:base+64,rankRuleY:1840,firstValueY:base+150,rowHeight:106,
    labelY:base+198,communityY:base+264,
    inset:width===640?96:width===320?52:36,valueSize:width===640?72:width===320?62:52,valueMin:width===640?42:width===320?32:26,
    labelSize:width===640?36:width===320?30:24,communitySize:width===640?44:width===320?34:28,communityMin:width===640?36:width===320?28:22,
    iconSize:width===640?36:width===320?28:24,iconGap:width===640?14:width===320?10:8};
}
export function counterIconTop(ctx,value,baseline,iconSize){
  // Align to the number, independent of descenders in labels such as "upvotes".
  const {ascent,descent}=inkMetrics(ctx,value.split(' ')[0]);
  return baseline+(descent-ascent)/2-iconSize/2;
}
function drawIcon(ctx,name,x,y,size){ctx.save();ctx.translate(x,y);ctx.scale(size/24,size/24);ctx.lineWidth=1.65;ctx.lineCap='round';ctx.lineJoin='round';ctx.strokeStyle='#fff';ctx.stroke(new Path2D(ICONS[name]||ICONS.paper));ctx.restore();}

export function spineContext(item){
  // Description and declared card data only. No generated summaries or inferred counts.
  const source=/^a blog post by .+ on hugging face\.?$/i.test(item.description||'')?'':item.description;
  const raw=(source||'').replace(/\p{Extended_Pictographic}|\uFE0F/gu,'').replace(/\s+/g,' ').trim();
  const description=raw?raw[0].toUpperCase()+raw.slice(1):'';
  const metadata=contextFacts(item).map(f=>['SDK','arXiv'].includes(f.label)?`${f.label} · ${f.value}`:f.value).join(' · ');
  return [metadata||description].filter(Boolean);
}

export function drawSpine(canvas,item,index,options={},scale=1) {
  const W=spineWidth(options.width),H=2048,wider=W===640;
  canvas.width=Math.round(W*scale);canvas.height=Math.round(H*scale);
  const ctx=canvas.getContext('2d');ctx.scale(scale,scale);
  const p=item.customPalette||item.palette||{from:'blue',to:'indigo'};
  const from=lab(COLOR_LCH[p.from]||COLOR_LCH.blue),to=lab(COLOR_LCH[p.to]||COLOR_LCH.indigo);
  const g=ctx.createLinearGradient(0,0,W,H);
  for(let n=0;n<=24;n++) {const t=n/24;g.addColorStop(t,rgb(from.map((v,i)=>v+(to[i]-v)*t)));}
  ctx.fillStyle=g;ctx.fillRect(0,0,W,H);
  const shadow=ctx.createLinearGradient(0,0,W*.85,H*.5);shadow.addColorStop(0,'rgba(0,0,0,.15)');shadow.addColorStop(1,'rgba(0,0,0,0)');ctx.fillStyle=shadow;ctx.fillRect(0,0,W,H);
  ctx.fillStyle='#fff';ctx.textAlign='center';
  if(options.icons===true)drawIcon(ctx,item.kind,(W-88)/2,95,88);
  ctx.font=`600 ${wider?40:32}px "Source Sans 3", sans-serif`;ctx.fillText(item.kind.toUpperCase(),W/2,options.icons===true?245:135);
  const detailFacts=spineFacts(item),hasFacts=options.details!==false;
  const geometry=spineGeometry(W,options,hasFacts),{base}=geometry;
  const maxTitle=base-(options.icons===true?380:230);
  const title=(item.displayTitle||item.title||item.id).trim();
  ctx.fillStyle='#fff';
  ctx.save();ctx.translate(0,base);ctx.rotate(-Math.PI/2);ctx.textAlign='left';
  const author=byline(item);
  const {lines,titleFont,authorFont,authorText,contextFont,contextText,layout}=spineTypography(ctx,title,author,W,maxTitle,wider&&options.details!==false?spineContext(item):[]);
  ctx.font=titleFont;
  for(let i=0;i<lines.length;i++)ctx.fillText(lines[i],0,layout.title[i]);
  if(author){ctx.font=authorFont;ctx.fillStyle='rgba(255,255,255,.9)';ctx.fillText(authorText,0,layout.author);}
  ctx.font=contextFont;ctx.fillStyle='rgba(255,255,255,.85)';
  contextText.forEach((text,i)=>ctx.fillText(text,0,layout.context[i]));
  ctx.restore();
  if(hasFacts){
    const {inset,ruleY,firstValueY,labelY,communityY,valueSize,valueMin,labelSize,communitySize,communityMin,iconSize,iconGap}=geometry;
    ctx.strokeStyle='rgba(255,255,255,.5)';ctx.lineWidth=2;ctx.beginPath();ctx.moveTo(inset,ruleY);ctx.lineTo(W-inset,ruleY);ctx.stroke();
    const {primary,community}=detailFacts,available=W-2*inset;
    ctx.textAlign='left';ctx.fillStyle='#fff';
    fitText(ctx,primary.value,available,valueSize,valueMin);
    ctx.fillText(clippedText(ctx,primary.value,available),inset,firstValueY);
    ctx.font=`400 ${labelSize}px "Source Sans 3", sans-serif`;ctx.fillStyle='rgba(255,255,255,.9)';
    ctx.fillText(primary.label,inset,labelY);
    const text=`${community.value} ${community.label}`,x=inset+iconSize+iconGap;
    fitText(ctx,text,W-inset-x,communitySize,communityMin,'400');ctx.fillStyle='#fff';
    ctx.fillText(clippedText(ctx,text,W-inset-x),x,communityY);
    drawIcon(ctx,community.icon,inset,counterIconTop(ctx,community.value,communityY,iconSize),iconSize);
  }
  if(options.numbers!==false){
    ctx.strokeStyle='rgba(255,255,255,.5)';ctx.lineWidth=2;ctx.beginPath();ctx.moveTo(geometry.inset,geometry.rankRuleY);ctx.lineTo(W-geometry.inset,geometry.rankRuleY);ctx.stroke();
    ctx.textAlign='center';ctx.fillStyle='#fff';ctx.font='600 80px "Source Sans 3", sans-serif';ctx.fillText(String(index+1).padStart(2,'0'),W/2,1960);
  }
  return canvas;
}

export async function canvasBlob(canvas,type='image/jpeg',quality=.96){
  return new Promise((resolve,reject)=>canvas.toBlob(b=>b?resolve(b):reject(new Error('The image could not be exported.')),type,quality));
}

export async function exportImages(items,options,onProgress=()=>{}){
  await document.fonts.ready;
  const result=[];const stamp=Date.now();
  for(let i=0;i<items.length;i++){
    const canvas=drawSpine(document.createElement('canvas'),items[i],i,options);
    const blob=await canvasBlob(canvas);
    const file=new File([blob],`${String(i+1).padStart(2,'0')}-${items[i].kind}.jpg`,{type:'image/jpeg',lastModified:stamp-(items.length-i)*2000});
    result.push(file);canvas.width=1;canvas.height=1;onProgress(i+1,items.length);
    await new Promise(requestAnimationFrame);
  }return result;
}

export function overviewGeometry(count,mode){
  const logicalWidth=count*spineWidth(mode)+(count-1)*16+144,logicalHeight=2360;
  // Keep long Wider shelves within a conservative mobile canvas budget.
  const scale=Math.min(1,Math.sqrt(12e6/(logicalWidth*logicalHeight)),8192/logicalWidth);
  return {logicalWidth,logicalHeight,scale,width:Math.floor(logicalWidth*scale),height:Math.floor(logicalHeight*scale)};
}
export async function overview(items,options,title){
  await document.fonts.ready;
  const w=spineWidth(options.width), gap=16, margin=72,H=2360,g=overviewGeometry(items.length,options.width);
  const canvas=document.createElement('canvas');canvas.width=g.width;canvas.height=g.height;
  const ctx=canvas.getContext('2d');ctx.scale(g.scale,g.scale);ctx.fillStyle=options.preview==='light'?'#f7f8fa':'#10131b';ctx.fillRect(0,0,g.logicalWidth,H);
  ctx.fillStyle=options.preview==='light'?'#111827':'#fff';fitText(ctx,title,g.logicalWidth-margin*2,70,30);ctx.fillText(clippedText(ctx,title,g.logicalWidth-margin*2),margin,120);
  for(let i=0;i<items.length;i++){const strip=drawSpine(document.createElement('canvas'),items[i],i,options);ctx.drawImage(strip,margin+i*(w+gap),180);strip.width=1;}
  const credit='Made with HF Picks';fitText(ctx,credit,g.logicalWidth-margin*2,29,18,'400');ctx.fillStyle=options.preview==='light'?'#64748b':'#b5bfd0';ctx.fillText(credit,margin,H-55);
  const blob=await canvasBlob(canvas,'image/png');canvas.width=1;return blob;
}

// ZIP with stored entries (JPEGs are already compressed); UTF-8 file names.
const CRC_TABLE=Uint32Array.from({length:256},(_,value)=>{let c=value;for(let bit=0;bit<8;bit++)c=(c&1)?(0xedb88320^(c>>>1)):(c>>>1);return c>>>0;});
function crc32(bytes){let c=0xffffffff;for(const b of bytes)c=CRC_TABLE[(c^b)&255]^(c>>>8);return (c^0xffffffff)>>>0;}
export async function makeZip(files){
  const chunks=[],directory=[];let offset=0,dirSize=0;
  for(const file of files){
    const bytes=new Uint8Array(await file.arrayBuffer()),name=new TextEncoder().encode(file.name),crc=crc32(bytes);
    const date=new Date(file.lastModified||Date.now());const dosTime=(date.getHours()<<11)|(date.getMinutes()<<5)|(date.getSeconds()>>1),dosDate=((Math.max(1980,date.getFullYear())-1980)<<9)|((date.getMonth()+1)<<5)|date.getDate();
    const local=new DataView(new ArrayBuffer(30));local.setUint32(0,0x04034b50,true);local.setUint16(4,20,true);local.setUint16(6,0x800,true);local.setUint16(10,dosTime,true);local.setUint16(12,dosDate,true);local.setUint32(14,crc,true);local.setUint32(18,bytes.length,true);local.setUint32(22,bytes.length,true);local.setUint16(26,name.length,true);
    chunks.push(local.buffer,name,bytes);
    const central=new DataView(new ArrayBuffer(46));central.setUint32(0,0x02014b50,true);central.setUint16(4,20,true);central.setUint16(6,20,true);central.setUint16(8,0x800,true);central.setUint16(12,dosTime,true);central.setUint16(14,dosDate,true);central.setUint32(16,crc,true);central.setUint32(20,bytes.length,true);central.setUint32(24,bytes.length,true);central.setUint16(28,name.length,true);central.setUint32(42,offset,true);
    directory.push(central.buffer,name);dirSize+=46+name.length;offset+=30+name.length+bytes.length;
  }
  const end=new DataView(new ArrayBuffer(22));end.setUint32(0,0x06054b50,true);end.setUint16(8,files.length,true);end.setUint16(10,files.length,true);end.setUint32(12,dirSize,true);end.setUint32(16,offset,true);
  return new Blob([...chunks,...directory,end.buffer],{type:'application/zip'});
}