@topmindspace/tms-skills 0.3.6 → 0.4.1

package/top-ppt-html/scripts/build_pptx.js

@@ -159,15 +159,22 @@ function _normColor(c) {
   if (/^[0-9a-f]{3}$/.test(v)) v = '#' + v;
   return v;
 }
-/** 取图标 PNG data URI；无缓存时按名挑色兜底（accent → 首色 → null） */
+/** 取图标 PNG data URI；无缓存时按名挑色兜底（accent → 首色 → 包内 512px PNG → null） */
 function iconPng(name, colorHex) {
   const n = name && ICON_ASSETS.icons[name] ? name : ICON_LIB.pickIconName(name, 0);
   const bag = ICON_ASSETS.icons[n];
-  if (!bag) return null;
-  const want = _normColor(colorHex);
-  if (bag[want]) return bag[want];
-  const keys = Object.keys(bag);
-  return bag[keys[0]] || null;
+  if (bag) {
+    const want = _normColor(colorHex);
+    if (bag[want]) return bag[want];
+    const keys = Object.keys(bag);
+    if (keys.length) return bag[keys[0]];
+  }
+  // 无 sharp / 无预生成资产时的可靠回落：包内 512px 预渲染 PNG（python-pptx/pptxgenjs 均可直接嵌入）
+  try {
+    const p = ICON_LIB.iconPngPath(n);
+    if (p) return 'data:image/png;base64,' + fs.readFileSync(p).toString('base64');
+  } catch (e) { /* 继续回落 accent 方块 */ }
+  return null;
 }
 /** 在指定盒内嵌图标（真导出）；无图标资产时回落 accent 小方块（可扫读路标） */
 function addIcon(s, name, x, y, size, colorHex) {
@@ -275,6 +282,30 @@ const FS_POLICY = (function () {
   }
 })();
 const FONT_LADDER = FS_POLICY.ladder;
+/* 弹性文本单源（containers.adaptiveText · 0.2.0）：长标题/长列表/长表格单元格的降级规则。
+   调用处只读 AT_* 与下列 helper，禁止手写字号/行距/阈值 magic number。 */
+const AT = (LC.containers && LC.containers.adaptiveText) || {};
+const AT_TITLE = AT.title || {}, AT_LIST = AT.list || {}, AT_TABLE = AT.table || {};
+/* 标题字号上限：按字符数（CJK=1，拉丁/数字≈0.5，与 estLines 同口径）分档 */
+function titleMaxFor(text) {
+  const s = String(text == null ? '' : text);
+  let units = 0;
+  for (const ch of s) units += /[\x00-\xff]/.test(ch) ? 0.5 : 1;
+  if (units >= (AT_TITLE.xlongChars != null ? AT_TITLE.xlongChars : 44)) return AT_TITLE.xlongMax || 20;
+  if (units >= (AT_TITLE.longChars != null ? AT_TITLE.longChars : 28)) return AT_TITLE.longMax || 24;
+  return AT_TITLE.base || 30;
+}
+/* 列表密集度：条目数达标 → 收紧字号上限/段间距/行距 */
+function listFitOpts(n) {
+  const dense = n >= (AT_LIST.denseItems != null ? AT_LIST.denseItems : 6);
+  return {
+    dense,
+    max: dense ? (AT_LIST.denseMax || 12) : (AT_LIST.max || 14),
+    gapFactor: dense ? (AT_LIST.denseGapFactor != null ? AT_LIST.denseGapFactor : 0.25)
+                     : (AT_LIST.gapFactor != null ? AT_LIST.gapFactor : 0.5),
+    lineFactor: dense ? (AT_LIST.denseLineFactor || 1.3) : (AT_LIST.lineFactor || 1.45),
+  };
+}
 /* 缩字号触底记录：触底 = 内容量超出该版式承载力，是「该拆页/换组合」的信号，不得无声无息 */
 const SHRINK_FLOOR_HITS = [];
 function modeFloorPt() {
@@ -335,6 +366,13 @@ function fitRowH(avail, n, pref, floor) {
   return Math.max(lo, Math.min(pref, avail / Math.max(1, n)));
 }
 
+/* Exhibit 徽标文本：纯编号补 "Exhibit " 前缀（HTML 为 `Exhibit {no}` + CSS uppercase，视觉同 "EXHIBIT 1"）；
+   调用方已带前缀的不重复 */
+function exhibitBadge(no) {
+  const t = String(no == null ? '' : no).trim();
+  if (!t) return t;
+  return /^exhibit[\s\-:]*/i.test(t) ? t.toUpperCase() : ('EXHIBIT ' + t.toUpperCase());
+}
 /* ══════════ 内容模型 ══════════
  * 从 --model=<file.json> 读取（推荐：由 extract_model.py 从 HTML 报告抽取，
  * 保证 PPTX 与页面同源）；未提供时使用下方内嵌 CONTENT 示例。 */
@@ -463,9 +501,10 @@ function head(s, eyebrow, title, lead) {
   };
   if (eyebrow) s.addText(eyebrow, { x: H.x, y: H.y, w: H.w, h: 0.4, fontFace: STYLE.font,
     fontSize: sz(13), bold: true, color: STYLE.accent, charSpacing: 2 });
-  /* 主标题自适应：过长时缩一档，避免压到分隔线 */
+  /* 主标题自适应（adaptiveText.title 单源）：先按字符数分档定上限，再按高度验算降一档，避免压到分隔线 */
   const titleH = eyebrow ? (H.ruleY - H.titleY - 0.06) : 1.6 - 0.6;
-  const tSize = estTextH(title, CW, sz(30), 1.25) > titleH ? sz(24) : sz(30);
+  const tMax = titleMaxFor(title);
+  const tSize = sz(estTextH(title, CW, sz(tMax), 1.25) > titleH ? Math.min(tMax, AT_TITLE.step1 || 24) : tMax);
   s.addText(title, { x: H.x, y: eyebrow ? H.titleY : 0.6, w: H.w, h: Math.max(0.6, titleH),
     fontFace: STYLE.fontDisplay, fontSize: tSize, bold: true, color: STYLE.ink, fit: 'shrink' });
   s.addShape('rect', { x: H.x, y: eyebrow ? H.ruleY : 1.6, w: 0.9, h: 0.045, fill: { color: STYLE.accent }, line: { type: 'none' } });
@@ -508,7 +547,7 @@ function isRec(v) { return !!v && typeof v === 'object' && !Array.isArray(v); }
    pointKV: [k,v] | {k|t, v|d} | str（对齐 pts_list）
    metricKV: [v,k] | {v|value, k}（对齐 metrics_row）
    bulletKV: [k,a,t] | {k,a,t}（对齐 r_bullet；缺省保持 undefined 以便调用方判空）
-   phaseKV: [label,name,desc,state] | {label,name,d,s}（对齐 r_timeline）
+   phaseKV: [label,name,desc,state,icon?] | {label,name,d,s,icon?}（对齐 r_timeline；icon 为变体 timeline 节点图标）
    paraKV: [title,text] | str（对齐 r_twocol；str 为无加粗标题的正文段） */
 function pointKV(p) {
   if (Array.isArray(p)) return [String(p[0] == null ? '' : p[0]), String(p[1] == null ? '' : p[1])];
@@ -526,9 +565,10 @@ function bulletKV(it) {
   return [String(it == null ? '' : it), undefined, undefined];
 }
 function phaseKV(ph) {
-  if (Array.isArray(ph)) return [ph[0] || '', ph[1] || '', ph[2] || '', ph[3] || ''];
-  if (isRec(ph)) return [ph.label || '', ph.name || '', ph.d || '', ph.s || ''];
-  return [String(ph == null ? '' : ph), '', '', ''];
+  // 第 5 元 = icon（变体 timeline 的节点图标；缺省 ''，渲染回落圆点）
+  if (Array.isArray(ph)) return [ph[0] || '', ph[1] || '', ph[2] || '', ph[3] || '', ph[4] || ''];
+  if (isRec(ph)) return [ph.label || '', ph.name || '', ph.d || '', ph.s || '', ph.icon || ''];
+  return [String(ph == null ? '' : ph), '', '', '', ''];
 }
 function paraKV(p) {
   if (Array.isArray(p)) return [p[0] || '', p[1] || ''];
@@ -835,13 +875,30 @@ function dataTableRows(c) {
 function dataTableText(c) { return dataTableRows(c).map(r => r.join(' | ')).join('\n'); }
 
 /* 原生图表基础选项（位置由调用点附加） */
+/* 数据标签小数位：按模型数值实际小数位（上限 2 位）生成 format code。
+   原 '0"单位"' 会把 1.2 显示成 1（像素级数值失真）；无单位且无小数时保持 General。 */
+function chartDecimals(c) {
+  let d = 0;
+  const scan = (v) => {
+    if (typeof v === 'number' && isFinite(v)) {
+      const s = String(v), i = s.indexOf('.');
+      if (i >= 0) d = Math.max(d, Math.min(2, s.length - i - 1));
+    }
+  };
+  (c.values || []).forEach(scan);
+  (c.series || []).forEach(se => (se.values || []).forEach(scan));
+  (c.points || []).forEach(p => { if (Array.isArray(p)) p.forEach(scan); else scan(p); });
+  (c.start || []).forEach(scan); (c.target || []).forEach(scan);
+  return d;
+}
 function chartBaseOpts(c, colors, multi, kind) {
   const isLine = (kind === 'line' || kind === 'area');
+  const _dec = chartDecimals(c), _ds = _dec ? '.' + '0'.repeat(_dec) : '';
   const opts = {
     showValue: !isLine && !multi,
     dataLabelPosition: 'outEnd',
     dataLabelColor: STYLE.body, dataLabelFontSize: sz(11.5), dataLabelFontFace: STYLE.font,
-    dataLabelFormatCode: c.unit ? '0"' + c.unit + '"' : 'General',
+    dataLabelFormatCode: c.unit ? '0' + _ds + '"' + c.unit + '"' : (_dec ? '0' + _ds : 'General'),
     catAxisLabelColor: STYLE.faint, catAxisLabelFontSize: sz(10.5), catAxisLabelFontFace: STYLE.font,
     valAxisHidden: true, valAxisLineShow: false, catAxisLineShow: false,
     catGridLine: { style: 'none' }, valGridLine: { style: 'none' },
@@ -919,7 +976,19 @@ function nativeChart(s, c, x, y, w, h, dcols) {
   }
   const ctype = kind === 'line' ? pptx.ChartType.line
     : kind === 'area' ? pptx.ChartType.area : pptx.ChartType.bar;
-  chartTry(s, ctype, chartSeries(c), opts, c);
+  let cdata = chartSeries(c);
+  if (t === 'hbar') {
+    /* 条形图（barDir=bar）类目轴自下而上绘制：反转数据使首项居顶，
+       与 HTML svg-hbar 及 A 通道 hbarRows 同序（标签-数值配对不变） */
+    cdata = cdata.map(se => ({ name: se.name,
+      labels: (se.labels || []).slice().reverse(), values: (se.values || []).slice().reverse() }));
+    /* 单系列时颜色按数据点分配：颜色跟随数据走，与 A 通道 dcols[j%5] 同归属 */
+    if (!multi && colors && colors.length) {
+      const _n = Math.max(1, (cdata[0].values || []).length);
+      opts.chartColors = (cdata[0].values || []).map((_, i) => colors[(_n - 1 - i) % colors.length]);
+    }
+  }
+  chartTry(s, ctype, cdata, opts, c);
 }
 /* 散点（X/Y 双系列）/ 气泡（{x,y,w} 单系列）；labels 解析为 x，values 为 y */
 function xyChart(s, c, pos, kind, colors) {
@@ -1440,10 +1509,14 @@ function ribbonRects(s, pts, color) {
     const ca = (a[1] + a[2]) / 2, cb = (b[1] + b[2]) / 2;
     const dx = b[0] - a[0], dy = cb - ca;
     const len = Math.sqrt(dx * dx + dy * dy);
-    const th = Math.max(0.02, ((a[2] - a[1]) + (b[2] - b[1])) / 2);
+    /* 厚度取绝对值：sankey 按 [x,上,下]、streamgraph 按 [x,下,上] 传参（y 向下），
+       符号不应影响厚度（原 (a[2]-a[1]) 在 streamgraph 为负 → th 恒 0.02，流带变细线） */
+    const th = Math.max(0.02, Math.abs(((a[1] - a[2]) + (b[1] - b[2])) / 2));
     const ang = Math.atan2(dy, dx) * 180 / Math.PI;
-    s.addShape('rect', { x: (a[0] + b[0]) / 2 - len / 2, y: (ca + cb) / 2 - th / 2,
-      w: Math.max(0.02, len), h: th, rotate: Math.round(ang * 10) / 10,
+    /* 相邻 quad 沿走向微叠 0.02in：消除拼接处的抗锯齿发丝缝（streamgraph/sankey 像素级瑕疵） */
+    const ov = 0.02;
+    s.addShape('rect', { x: (a[0] + b[0]) / 2 - len / 2 - ov, y: (ca + cb) / 2 - th / 2,
+      w: Math.max(0.02, len) + ov * 2, h: th, rotate: Math.round(ang * 10) / 10,
       fill: { color: color }, line: { type: 'none' } });
   }
 }
@@ -1461,7 +1534,8 @@ function infoTableRows(sec) {
   if (t === 'network') return [['节点', '名称']].concat((sec.nodes || []).map(n => [String(n[0]), String(n[1])]));
   if (t === 'marimekko') {
     const head = ['列', '总量' + u].concat((sec.legend || []).map(String));
-    return [head].concat((sec.cols || []).map((c, i) => [String(c[0]), String(c[1])].concat(((sec.cells || [])[i] || []).map(String))));
+    return [head].concat((sec.cols || []).map((c, i) => [String(c[0]), String(c[1])]
+      .concat(marimekkoSegs((sec.cells || [])[i], 99).map(sg => sg.label != null ? sg.label + ' ' + sg.value : String(sg.value)))));
   }
   if (t === 'streamgraph') {
     return [['系列'].concat((sec.labels || []).map(String))]
@@ -1627,7 +1701,11 @@ function infoBoxplot(s, sec, y0, y1) {
       fontFace: STYLE.font, fontSize: sz(10.5), color: STYLE.body });
     s.addText(String(md) + (sec.unit || ''), { x: cx - step / 2, y: yFor(md) - 0.42, w: step, h: 0.26, align: 'center',
       fontFace: STYLE.font, fontSize: sz(10), bold: true, color: STYLE.accent });
-    s.addText(String(mn) + (sec.unit || ''), { x: cx - step / 2, y: yFor(mn) + 0.03, w: step, h: 0.24, align: 'center',
+    /* min 标签默认在须线帽下方；mn 贴轴时会被组标签带（P.y1-0.42 起）压住 →
+       翻到帽上方，同时避开箱体下沿（几何铁律②：禁叠印） */
+    let mnY = yFor(mn) + 0.03;
+    if (mnY + 0.24 > P.y1 - 0.42) mnY = Math.min(yFor(mn) - 0.28, yFor(q1) - 0.30);
+    s.addText(String(mn) + (sec.unit || ''), { x: cx - step / 2, y: mnY, w: step, h: 0.24, align: 'center',
       fontFace: STYLE.font, fontSize: sz(9.5), color: STYLE.faint });
     s.addText(String(mx) + (sec.unit || ''), { x: cx - step / 2, y: yFor(mx) - 0.28, w: step, h: 0.24, align: 'center',
       fontFace: STYLE.font, fontSize: sz(9.5), color: STYLE.faint });
@@ -1670,6 +1748,15 @@ function infoNetwork(s, sec, y0, y1) {
         align: outward ? 'left' : 'right', valign: 'middle', fontFace: STYLE.font, fontSize: sz(10), color: STYLE.body });
   });
 }
+/* marimekko 单元格归一化：裸数值 [70,25,5] 或 [标签,数值] 对 [["<50ms",70],…]
+   （与 cols/flows/groups 的 [标签,值] 惯例一致）；非数值 → 0，零值段过滤 */
+function marimekkoSegs(arr, maxSegs) {
+  return ((arr || []).slice(0, maxSegs == null ? 99 : maxSegs)).map(el => {
+    const pair = Array.isArray(el);
+    const v = Number(pair ? el[1] : el);
+    return { label: pair ? String(el[0]) : null, value: isFinite(v) ? v : 0 };
+  }).filter(sg => sg.value > 0);
+}
 /* 马赛克图：列宽按列总量、列高按 100% 构成的双重编码 */
 function infoMarimekko(s, sec, y0, y1) {
   const G = PT.marimekko;
@@ -1690,14 +1777,17 @@ function infoMarimekko(s, sec, y0, y1) {
   let cx0 = MX;
   cols.forEach((c, i) => {
     const cw = Math.max(0.2, (Number(c[1]) || 0) / total * availW);
-    const shares = (cells[i] || []).map(Number).slice(0, G.maxSegs);
-    const sum = shares.reduce((a, b) => a + b, 0) || 1;
+    const segs = marimekkoSegs(cells[i], G.maxSegs);
+    const sum = segs.reduce((a, sg) => a + sg.value, 0) || 1;
     let cy0 = P.y0;
-    shares.forEach((v, k) => {
+    segs.forEach((sg, k) => {
+      const v = sg.value;
       const sh = Math.max(0.02, v / sum * plotH);
       s.addShape('rect', { x: cx0, y: cy0, w: cw, h: sh,
         fill: { color: palette[k % palette.length] }, line: { color: STYLE.bg, width: 0.75 } });
-      s.addText(String(v) + (sec.unit || ''), { x: cx0, y: cy0 + sh / 2 - 0.13, w: cw, h: 0.26, align: 'center',
+      /* 有标签用标签（"<50ms"），裸数值沿用旧行为（值 + 单位） */
+      const segLabel = sg.label != null ? sg.label : (String(v) + (sec.unit || ''));
+      s.addText(segLabel, { x: cx0, y: cy0 + sh / 2 - 0.13, w: cw, h: 0.26, align: 'center',
         fontFace: STYLE.font, fontSize: sz(10), bold: true, fit: 'shrink',
         color: k === 0 ? STYLE.onAccent : STYLE.ink });
       cy0 += sh;
@@ -1779,7 +1869,7 @@ function addTable(s, tbl, x, y, w, availH, opts) {
   const minRowH = opts.minRowH != null ? opts.minRowH : PT.table.rowHMin;
   const headRowH = opts.headRowH != null ? opts.headRowH : (PT.table.headRowH || minRowH);
   /* 行数超过容量时优先压行高到 hardFloor，仍放不下则整体缩放到 availH（禁溢出） */
-  const hardFloor = Math.min(minRowH, 0.22);
+  const hardFloor = Math.min(minRowH, AT_TABLE.rowFloorIn != null ? AT_TABLE.rowFloorIn : 0.22);
   const ideal = availH / Math.max(1, n);
   let rowH = Math.min(maxRowH, Math.max(hardFloor, ideal));
   if (n * rowH > availH + 0.01) {
@@ -1790,11 +1880,46 @@ function addTable(s, tbl, x, y, w, availH, opts) {
   }
   /* 行多则同步收字号（research 密排允许更小；句子单元格仍走语义字号门禁） */
   const dense = rowH < 0.42;
-  const headSz = sz(dense ? 11 : 13), bodySz = sz(dense ? 10 : 12.5);
+  const headSz = sz(dense ? 11 : Math.min(13, AT_TABLE.headMax || 12));
+  const bodySz = sz(dense ? 10 : Math.min(12.5, AT_TABLE.cellMax || 13));
   const hRowH = Math.min(headRowH, Math.max(hardFloor, rowH * 1.15));
+  /* 内容高度预估：逐格用 estTextH 估算，超出行高则全表收字号 ——
+     禁依赖 fit:'shrink' 或渲染引擎自动撑高（PowerPoint/LibreOffice 会按内容增高行，压住脚注） */
+  const ncolsT = Math.max(head.length, 1, ...rowsIn.map(r => r.length));
+  const effColW = (Array.isArray(tbl.colW) && tbl.colW.length >= ncolsT) ? tbl.colW.slice(0, ncolsT)
+    : Array.from({ length: ncolsT }, () => w / ncolsT);
+  const cellPadIn = (dense ? 2 : 5) / 72;
+  /* 长表格单元格适配（adaptiveText.table 单源）：逐格估算，超出行高则全表收字号；
+     floor 取模式下限与表格下限之大者——表格不得突破模式可读性底线 */
+  const fitCellSz = (text, cw, availHh, maxSz) => fitFont([String(text == null ? '' : text)],
+    Math.max(0.5, cw - cellPadIn * 2), Math.max(0.2, availHh - cellPadIn * 2),
+    { max: maxSz, maxShrinkSteps: 6, floor: Math.max(modeFloorPt(), AT_TABLE.cellFloor || 0) });
+  let bodySzF = bodySz, headSzF = headSz;
+  rowsIn.forEach(r => r.forEach((c, j) => {
+    const f = fitCellSz(c, effColW[j] != null ? effColW[j] : effColW[0], rowH, bodySz);
+    if (f < bodySzF) bodySzF = f;
+  }));
+  head.forEach((h, j) => {
+    const f = fitCellSz(h, effColW[j] != null ? effColW[j] : effColW[0], hRowH, headSz);
+    if (f < headSzF) headSzF = f;
+  });
+  /* 字号触底仍装不下 → 显式告警（内容超承载，建议拆页/精简；行高不再自动撑高） */
+  const stillOver = (text, cw, availHh, f) =>
+    estTextH(String(text == null ? '' : text), Math.max(0.5, cw - cellPadIn * 2), f, TM_LINE) >
+    Math.max(0.2, availHh - cellPadIn * 2);
+  let overCells = 0;
+  rowsIn.forEach(r => r.forEach((c, j) => {
+    if (stillOver(c, effColW[j] != null ? effColW[j] : effColW[0], rowH, bodySzF)) overCells++;
+  }));
+  head.forEach((h, j) => {
+    if (stillOver(h, effColW[j] != null ? effColW[j] : effColW[0], hRowH, headSzF)) overCells++;
+  });
+  if (overCells > 0 && typeof console !== 'undefined')
+    console.warn(`addTable: ${overCells} 个单元格在字号下限（正文 ${bodySzF}pt/表头 ${headSzF}pt）仍超出分配行高 —— ` +
+      '内容超承载，建议拆页/精简文案（行高已锁定，防压脚注）');
   const rows = [head.map(h => ({ text: h, options: { bold: true, color: STYLE.onAccent,
-      fill: { color: STYLE.accent }, fontSize: headSz, fontFace: STYLE.font, valign: 'middle' } }))]
-    .concat(rowsIn.map(r => r.map(c => ({ text: String(c), options: { fontSize: bodySz,
+      fill: { color: STYLE.accent }, fontSize: headSzF, fontFace: STYLE.font, valign: 'middle' } }))]
+    .concat(rowsIn.map(r => r.map(c => ({ text: String(c), options: { fontSize: bodySzF,
       color: STYLE.body, fontFace: STYLE.font, valign: 'middle', fill: { color: STYLE.bg } } }))));
   /* rowH 数组：表头略高、正文均分剩余（pptxgenjs 支持逐行 rowH） */
   const rowHeights = [hRowH].concat(rowsIn.map(() => rowH));
@@ -1885,7 +2010,7 @@ CONTENT.sections.forEach((sec) => {
 
   /* 正文区起点 / 终点（含 lead 与 so-what / 来源行 / 待核实条占位） */
   /* 非 exhibit 页型也可带 Exhibit 编号（帧头徽标；正文区下移让位，避免与主图重叠） */
-  const exBadge = (type !== 'exhibit' && sec.exhibitNo) ? String(sec.exhibitNo).toUpperCase() : null;
+  const exBadge = (type !== 'exhibit' && sec.exhibitNo) ? exhibitBadge(sec.exhibitNo) : null;
   const bodyY0 = sec.lead ? PT.common.bodyYWithLead : CONTENT_TOP;
   const bodyY = exBadge ? bodyY0 + 0.42 : bodyY0;
   if (exBadge) {
@@ -1896,7 +2021,7 @@ CONTENT.sections.forEach((sec) => {
   const _F = PT.flagbar || { hdH: 0.26, rowH: 0.24, maxRows: 3, gap: 0.12 };
   const flagH = flagItems.length
     ? (_F.hdH + Math.min(_F.maxRows, flagItems.length) * _F.rowH + 0.06) : 0;
-  let bodyBottom = chartBottom(!!sec.soWhat, !!sec.footnote);
+  let bodyBottom = chartBottom(!!sec.soWhat, !!(sec.footnote || sec.note));
   let flagY = 0;
   if (flagH) {
     /* 待核实条底对齐 contentBottom；与来源行 / so-what 同页时上移让位（不重叠） */
@@ -1943,7 +2068,7 @@ CONTENT.sections.forEach((sec) => {
     /* R6：竖分隔线高度取原设计值与注释带感知下界的较小者——写死 3.1 会在
        so-what/来源行并存时越过注释带顶（ANNOTATION_BAND_OVERLAP），而无注释时
        不得比原设计更长（回归：smoke business-blue fixture slide 7）。 */
-    const kpiBottom = chartBottom(!!sec.soWhat, !!sec.footnote) - 0.05;
+    const kpiBottom = chartBottom(!!sec.soWhat, !!(sec.footnote || sec.note)) - 0.05;
     s.addShape('rect', { x: kdivX, y: K.heroY + 0.15, w: 0.025,
       h: Math.min(3.1, Math.max(0.6, kpiBottom - (K.heroY + 0.15))),
       fill: { color: STYLE.line }, line: { type: 'none' } });
@@ -1952,9 +2077,15 @@ CONTENT.sections.forEach((sec) => {
       { x: kdivX + 0.35, y: K.metricY0, w: CW * (1 - K.dividerX) - 0.5, h: CONTENT_BOTTOM - K.metricY0 };
     const kAvail = Math.max(0.8, kpiBottom - mreg.y);
     const kmets = sec.metrics || [];
-    const kCap = Math.max(1, Math.floor(kAvail / K.metricRowH));
+    /* 容量按最小允许行高判断，行高按全部指标自适应压缩 ——
+       原 kCap 用默认行高先截断，导致第 N+1 个指标被静默丢弃（禁静默丢数据） */
+    const K_MINROWH = 0.42;
+    const kCap = Math.max(1, Math.floor(kAvail / K_MINROWH));
     const kRows = Math.min(kmets.length, kCap);
-    const kRowH = fitRowH(kAvail, kRows, K.metricRowH, 0.42);
+    if (kRows < kmets.length)
+      console.warn(`[build_pptx] 警告：KPI 页「${sec.title || ''}」支撑指标 ${kmets.length} 个超出容量（${kAvail.toFixed(2)}in），` +
+        `仅渲染前 ${kRows} 个 —— 建议拆页`);
+    const kRowH = fitRowH(kAvail, kRows, K.metricRowH, K_MINROWH);
     kmets.slice(0, kRows).map(metricKV).forEach((m, i) => {
       const ky = mreg.y + i * kRowH;
       s.addText(m[0], { x: mreg.x, y: ky, w: mreg.w, h: Math.min(0.55, kRowH * 0.62),
@@ -1963,11 +2094,13 @@ CONTENT.sections.forEach((sec) => {
         h: Math.max(0.24, kRowH - Math.min(0.55, kRowH * 0.62)), fontFace: STYLE.font,
         fontSize: sz(10.5), color: STYLE.faint });
     });
-    /* 要点：指标行下方续排，k/v 双色（与 bar 侧栏同口径）；无位则静默舍去 */
+    /* 要点：指标行下方续排，k/v 双色（与 bar 侧栏同口径）；容量不足时显式告警（禁静默丢数据） */
     const kpts = (sec.points || []).filter(Boolean);
     const kpRowH = 0.5;
     const kpY0 = mreg.y + kRows * kRowH + 0.12;
     const kpCap = Math.max(0, Math.floor((kpiBottom - kpY0) / kpRowH));
+    if (kpts.length > kpCap)
+      console.warn(`[build_pptx] 警告：KPI 页「${sec.title || ''}」要点 ${kpts.length} 条超出容量，仅渲染前 ${kpCap} 条 —— 建议拆页`);
     kpts.slice(0, kpCap).forEach((p, i) => {
       const kv = pointKV(p), kk = kv[0], vv = kv[1];
       const ky = kpY0 + i * kpRowH;
@@ -2225,10 +2358,24 @@ CONTENT.sections.forEach((sec) => {
       s.addShape('roundRect', { x, y, w, h: rowH, rectRadius: 0.07,
         fill: { color: acc ? STYLE.soft : STYLE.surface },
         line: acc ? { type: 'none' } : { color: STYLE.line, width: 0.75 } });
-      s.addText(lt, { x: x + 0.22, y, w: Math.min(P.labelW, w - 0.44), h: rowH, valign: 'middle',
-        fontFace: STYLE.font, fontSize: sz(13.5), bold: true, color: acc ? STYLE.accent : STYLE.ink });
-      if (ld) s.addText(ld, { x: x + 0.22 + Math.min(P.labelW, w - 0.44), y, w: w - 0.44 - Math.min(P.labelW, w - 0.44), h: rowH,
-        valign: 'middle', fontFace: STYLE.font, fontSize: sz(11), color: STYLE.faint });
+      /* 标题列宽按层内宽比例分配（labelFrac≈0.3）；顶层窄时固定 3.2in 会把说明压成竖列叠印 →
+         改为标题上、说明下的单框混排（与 HTML .pyr__t/.pyr__d 同语义） */
+      const lwP = Math.min(P.labelW, (w - 0.44) * (P.labelFrac == null ? 0.32 : P.labelFrac));
+      const descW = w - 0.44 - lwP;
+      /* 窄层判定：说明列 < 1.2in，或标题在标题列内放不下单行（会中部换行）→
+         标题上、说明下单框混排（与 HTML 窄屏 .pyr__lvl 单列同语义） */
+      const narrowP = descW < 1.2 || (ld && estLines(lt, lwP, 13.5) > 1) || (!ld && estLines(lt, w - 0.44, 13.5) > 1);
+      if (narrowP) {
+        s.addText(lt, { x: x + 0.22, y: y + 0.03, w: w - 0.44, h: 0.30, valign: 'middle',
+          fontFace: STYLE.font, fontSize: sz(12.5), bold: true, color: acc ? STYLE.accent : STYLE.ink, fit: 'shrink' });
+        s.addText(ld, { x: x + 0.22, y: y + 0.33, w: w - 0.44, h: Math.max(0.2, rowH - 0.36), valign: 'middle',
+          fontFace: STYLE.font, fontSize: sz(10.5), color: STYLE.faint, fit: 'shrink' });
+      } else {
+        s.addText(lt, { x: x + 0.22, y, w: lwP, h: rowH, valign: 'middle',
+          fontFace: STYLE.font, fontSize: sz(13.5), bold: true, color: acc ? STYLE.accent : STYLE.ink, fit: 'shrink' });
+        if (ld) s.addText(ld, { x: x + 0.22 + lwP, y, w: descW, h: rowH,
+          valign: 'middle', fontFace: STYLE.font, fontSize: sz(11), color: STYLE.faint, fit: 'shrink' });
+      }
     });
   } else if (type === 'steps') {
     /* 步骤条：N 步横排 + 箭头；超 maxPerRow 折行；groups 分组标签 */
@@ -2297,8 +2444,14 @@ CONTENT.sections.forEach((sec) => {
     ps.forEach((p, i) => {
       const x = treg.x + 0.2 + i * stepW;
       const on = p[3] === 'done' || p[3] === 'now';
-      s.addShape('ellipse', { x: x - T.dotR / 2, y: T.dotY, w: T.dotR, h: T.dotR,
-        fill: { color: on ? STYLE.accent : STYLE.line }, line: { type: 'none' } });
+      // 变体 timeline：节点图标（icon:<name>）；无图标回落圆点
+      const wantIcon = (sec.variant === 'timeline') && p[4];
+      if (wantIcon) {
+        addIcon(s, p[4], x - 0.13, T.dotY - 0.06, 0.26, on ? STYLE.accent : STYLE.body);
+      } else {
+        s.addShape('ellipse', { x: x - T.dotR / 2, y: T.dotY, w: T.dotR, h: T.dotR,
+          fill: { color: on ? STYLE.accent : STYLE.line }, line: { type: 'none' } });
+      }
       s.addText(p[0], { x: x - 0.1, y: T.labelY, w: stepW - 0.2, h: 0.4, fontFace: STYLE.font,
         fontSize: sz(12), bold: true, color: STYLE.accent, charSpacing: 1 });
       s.addText(p[1], { x: x - 0.1, y: T.nameY, w: stepW - 0.2, h: 0.5, fontFace: STYLE.fontDisplay,
@@ -2354,11 +2507,25 @@ CONTENT.sections.forEach((sec) => {
     const fz = fitFont(items.length ? items : ['x'.repeat(longest)], g.w, availH, { max: 13.5, gapFactor: 1.2 });
     groups.forEach((col, ci) => {
       if (!col.length) return;
+      const colX = treg.x + ci * g.step;
+      // 变体 2-col-feature：首栏特性栏（accent 左线 + 标题放大一档）
+      const isFeature = (sec.variant === '2-col-feature') && ci === 0 && nCol === 2;
+      const fx = isFeature ? colX + 0.14 : colX;
+      const fw = isFeature ? g.w - 0.14 : g.w;
+      if (isFeature) {
+        // 特性栏 accent 左线：高度按首段实际文本估算（不用整栏 availH，避免无墨水区压进注释带触发 severe 门禁）
+        const p0 = col[0] || ['', ''];
+        const barH = Math.min(availH,
+          estTextH(p0[0] + '　', fw, sz(fz + 1), 1.5) +
+          estTextH(p0[1] || '', fw, sz(fz - 1), 1.5) + sz(7) / 72 + 0.06);
+        s.addShape('rect', { x: colX, y: treg.y, w: 0.045, h: Math.max(0.2, barH),
+          fill: { color: STYLE.accent }, line: { type: 'none' }, objectName: 'feature:bar' });
+      }
       const runs = col.map(p => ([
-        { text: p[0] + '　', options: { fontSize: sz(fz), bold: true, color: STYLE.ink } },
+        { text: p[0] + '　', options: { fontSize: sz(isFeature ? fz + 1 : fz), bold: true, color: STYLE.ink } },
         { text: p[1] + '\n', options: { fontSize: sz(fz - 1), color: STYLE.body, breakLine: true } },
       ])).flat();
-      s.addText(runs, { x: treg.x + ci * g.step, y: treg.y, w: g.w, h: availH, fontFace: STYLE.font,
+      s.addText(runs, { x: fx, y: treg.y, w: fw, h: availH, fontFace: STYLE.font,
         valign: 'top', lineSpacing: sz(fz * 1.5), paraSpaceBefore: sz(7) });
     });
   } else if (type === 'halftable') {
@@ -2452,8 +2619,10 @@ CONTENT.sections.forEach((sec) => {
         : (Array.isArray(cd)
           ? { title: cd[0] || '', points: cd.length > 1 ? [['', cd[1]]] : [] }
           : { title: String(cd == null ? '' : cd), points: [] }));
-    const c = Math.min(sec.columns || 3, cds.length || 1);
-    const r = Math.ceil((cds.length || 1) / c);
+    const isBento = (sec.variant === 'bento-grid') && cds.length >= 3;
+    const c = isBento ? 3 : Math.min(sec.columns || 3, cds.length || 1);
+    // bento-grid：首卡占 2 个槽位（跨 2 列），其余顺排；槽位数 = 卡数 + 1
+    const r = isBento ? Math.ceil((cds.length + 1) / c) : Math.ceil((cds.length || 1) / c);
     const gw = (creg.w - (c - 1) * cdC.gap) / c;
     const gh = fitRowH(creg.h - (r - 1) * cdC.gap, r, cdC.maxH, 0.6);
     /* points 文本归一化（scaffold v9 契约 {title, points:[[k,v]]} 兼容三种形态） */
@@ -2478,21 +2647,28 @@ CONTENT.sections.forEach((sec) => {
         { max: 12, lineFactor: 1.5, gapFactor: 0 }))) : 12;
     const ptsFz = sz(ptsFzB);
     cds.forEach((cd, i) => {
-      const col = i % c, row = Math.floor(i / c);
+      let col = i % c, row = Math.floor(i / c), span = 1;
+      if (isBento) {
+        // 首卡跨 2 列：槽位 = i===0 ? [0,1] : i+1
+        const slot = i === 0 ? 0 : i + 1;
+        if (i === 0) span = 2;
+        col = slot % c; row = Math.floor(slot / c);
+      }
+      const cw = span * gw + (span - 1) * cdC.gap;
       const x = creg.x + col * (gw + cdC.gap), y = creg.y + row * (gh + cdC.gap);
-      s.addShape('roundRect', { x, y, w: gw, h: gh, rectRadius: 0.08,
+      s.addShape('roundRect', { x, y, w: cw, h: gh, rectRadius: 0.08,
         fill: { color: STYLE.surface }, line: { color: STYLE.line, width: 0.75 } });
       /* 卡片头路标：真导出语义图标（SVG→PNG），与 HTML .card__ico 同源；无资产时回落 accent 方块 */
       const ico = 0.18;
       const icoName = cd.icon || ICON_LIB.pickIconName(cd.title || '', i);
       addIcon(s, icoName, x + 0.18, y + 0.2, ico, STYLE.accent);
-      s.addText(cd.title || '', { x: x + 0.18 + ico + 0.1, y: y + 0.14, w: gw - 0.36 - ico - 0.1, h: cdC.titleH, fontFace: STYLE.font,
+      s.addText(cd.title || '', { x: x + 0.18 + ico + 0.1, y: y + 0.14, w: cw - 0.36 - ico - 0.1, h: cdC.titleH, fontFace: STYLE.font,
         fontSize: sz(15), bold: true, color: STYLE.ink, fit: 'shrink' });
       /* points 兼容：[[k,v]…] | [str…] | [{t,d}…]（scaffold v9 契约 {title, points:[[k,v]]}） */
       const ptLines = (cd.points || []).map(cardPtText);
       s.addText(ptLines.map(t => ({ text: t + '\n',
           options: { fontSize: ptsFz, color: STYLE.body, fontFace: STYLE.font, breakLine: true } })),
-        { x: x + 0.18, y: y + 0.14 + cdC.titleH + 0.06, w: gw - 0.36, h: ptsBoxH,
+        { x: x + 0.18, y: y + 0.14 + cdC.titleH + 0.06, w: cw - 0.36, h: ptsBoxH,
           fontFace: STYLE.font, valign: 'top', lineSpacing: ptsFz * 1.5 });
     });
   } else if (type === 'split') {
@@ -2644,12 +2820,12 @@ CONTENT.sections.forEach((sec) => {
     const reg = REGIONS.regionOf('exhibit', 'primary', { withNote: !!(sec.soWhat || sec.footnote) })
       || { x: MX, y: PT.exhibit.chartY, w: CW, h: PT.exhibit.chartH };
     if (sec.exhibitNo) {
-      s.addText(String(sec.exhibitNo).toUpperCase(), { x: MX, y: PT.exhibit.badgeY, w: CW, h: 0.35,
+      s.addText(exhibitBadge(sec.exhibitNo), { x: MX, y: PT.exhibit.badgeY, w: CW, h: 0.35,
         fontFace: STYLE.font, fontSize: sz(11.5), bold: true, color: STYLE.accent, charSpacing: 2 });
     }
     if (ec.labels && ec.values) {
       const edcols = ec.colors || dataColors(styleArg);
-      const h = Math.max(1.2, chartBottom(!!sec.soWhat, !!sec.footnote) - reg.y - 0.05);
+      const h = Math.max(1.2, chartBottom(!!sec.soWhat, !!(sec.footnote || sec.note)) - reg.y - 0.05);
       if (ec.type === 'hbar') {
         chartBlock(s, ec, reg.x, reg.y, reg.w, h, edcols);
       } else {
@@ -2681,8 +2857,10 @@ CONTENT.sections.forEach((sec) => {
       : CW - 0.4;
     const avail = bodyBottom - bodyY;
     const rowH = fitRowH(avail, pts.length, P.rowH, 0.3);
+    /* 长列表收紧（adaptiveText.list 单源）：条目多时降字号上限/段间距/行距，仍装不下由 fitFont 阶梯下探 */
+    const _lo = listFitOpts(pts.length);
     const fzB = fitFont(pts.map(p => (p[0] || '') + (p[1] || '')), textW - 0.32, avail,
-      { max: 15, gapFactor: 0.55 });
+      { max: Math.min(15, _lo.max), gapFactor: _lo.gapFactor, lineFactor: _lo.lineFactor });
     const fz = sz(fzB), fzSm = sz(snapFont(fzB - 1));
     pts.forEach((p, i) => {
       const y = bodyY + i * rowH;

package/top-ppt-html/scripts/check_icons.py

@@ -0,0 +1,119 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""TopPPT HTML · 图标包校验（assets/icons/）
+
+检查：
+  1. 每个 *.svg 合法 XML；根为 svg；viewBox 恰为 "0 0 24 24"
+  2. 描边风格统一：fill="none"、stroke="currentColor"、stroke-width="1.8"、
+     stroke-linecap/linejoin="round"（同家族铁律）
+  3. 只含允许元素（path/circle/rect/ellipse/line/polyline/polygon），无 <text>/<image>，
+     无 fill="#..." 彩色填充（禁三方彩色标），无外链
+  4. index.json 一致性：icons 键 ↔ <name>.svg 文件一一对应；defaults 5~8 个且都在包内；
+     keywords 非空且含自身名
+  5. 每个图标有同名 512px PNG（PPTX 通道预渲染）
+
+用法: python scripts/check_icons.py [--strict]
+退出码：0=通过；1=有 FAIL；2=仅 WARN（--strict 下也按 1 处理）
+"""
+from __future__ import annotations
+
+import json
+import sys
+import xml.etree.ElementTree as ET
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+ICON_DIR = ROOT / 'assets' / 'icons'
+ALLOWED = {'path', 'circle', 'rect', 'ellipse', 'line', 'polyline', 'polygon'}
+
+
+def main() -> int:
+    strict = '--strict' in sys.argv
+    fails: list[str] = []
+    warns: list[str] = []
+
+    idx_path = ICON_DIR / 'index.json'
+    if not idx_path.exists():
+        print('FAIL: assets/icons/index.json 缺失')
+        return 1
+    index = json.loads(idx_path.read_text(encoding='utf-8'))
+    icons_meta = index.get('icons') or {}
+    if index.get('count') != len(icons_meta):
+        fails.append(f"index.json count={index.get('count')} 与实际条目 {len(icons_meta)} 不一致")
+
+    svg_names = {p.stem for p in ICON_DIR.glob('*.svg')}
+    meta_names = set(icons_meta)
+    for n in sorted(meta_names - svg_names):
+        fails.append(f'index.json 有条目但缺文件: {n}.svg')
+    for n in sorted(svg_names - meta_names):
+        warns.append(f'有 SVG 文件但 index.json 未登记: {n}.svg')
+
+    defaults = index.get('defaults') or []
+    if not 5 <= len(defaults) <= 8:
+        fails.append(f'defaults 应 5~8 个，实际 {len(defaults)} 个')
+    for d in defaults:
+        if d not in icons_meta:
+            fails.append(f'default 图标不在包内: {d}')
+
+    for name, meta in icons_meta.items():
+        kws = meta.get('keywords') or []
+        if not kws:
+            warns.append(f'{name}: keywords 为空')
+        elif name not in kws:
+            warns.append(f'{name}: keywords 未含自身名')
+        png = ICON_DIR / f'{name}.png'
+        if not png.exists():
+            fails.append(f'缺预渲染 PNG: {name}.png')
+        elif png.stat().st_size < 1024:
+            warns.append(f'{name}.png 疑似过小（{png.stat().st_size}B）')
+
+    for name in sorted(svg_names):
+        p = ICON_DIR / f'{name}.svg'
+        try:
+            root = ET.fromstring(p.read_text(encoding='utf-8'))
+        except ET.ParseError as e:
+            fails.append(f'{name}.svg XML 非法: {e}')
+            continue
+        tag = root.tag.split('}')[-1]
+        if tag != 'svg':
+            fails.append(f'{name}.svg 根元素不是 svg: {tag}')
+            continue
+        if root.get('viewBox') != '0 0 24 24':
+            fails.append(f"{name}.svg viewBox={root.get('viewBox')!r}（必须 '0 0 24 24'）")
+        style = {
+            'fill': root.get('fill'), 'stroke': root.get('stroke'),
+            'stroke-width': root.get('stroke-width'),
+            'stroke-linecap': root.get('stroke-linecap'),
+            'stroke-linejoin': root.get('stroke-linejoin'),
+        }
+        want = {'fill': 'none', 'stroke': 'currentColor', 'stroke-width': '1.8',
+                'stroke-linecap': 'round', 'stroke-linejoin': 'round'}
+        if style != want:
+            fails.append(f'{name}.svg 风格属性偏离家族规范: {style}')
+        for el in root.iter():
+            t = el.tag.split('}')[-1]
+            if t == 'svg':
+                continue
+            if t not in ALLOWED:
+                fails.append(f'{name}.svg 含非法元素 <{t}>（禁 text/image/彩色填充）')
+            for k, v in el.attrib.items():
+                if k == 'fill' and v not in ('none',):
+                    fails.append(f'{name}.svg <{t}> 有彩色填充 fill={v}')
+                if isinstance(v, str) and v.startswith('http'):
+                    fails.append(f'{name}.svg 含外链: {v[:60]}')
+
+    for w in warns:
+        print(f'WARN: {w}')
+    for f in fails:
+        print(f'FAIL: {f}')
+    print(f'[check_icons] {len(svg_names)} svg / {len(icons_meta)} index / '
+          f'{len(defaults)} defaults: {"OK" if not fails else "FAIL"}')
+    if fails:
+        return 1
+    if warns and strict:
+        return 1
+    return 0
+
+
+if __name__ == '__main__':
+    raise SystemExit(main())