base-paint 0.3.2 → 0.3.3

package/README.md

@@ -1,8 +1,101 @@
 # base-paint help模板铁律
 
 1. 新页面只许 blocks 组装，禁新巨串：HTML/CSS/JS 大字面量不得进 `src`（走子路径 `base-paint/blocks` 组合或本 help模板管线）。
-2. 改模板只改源：`assets/help-template.html`（唯一真相源；3 槽注释 ＋ 前缀 `__HELP_TITLE__` 占位即契约；行尾 CRLF 禁转 LF）。
+2. 改模板只改源：`assets/help-template.html`（唯一真相源；3 槽注释 ＋ 前缀 `__HELP_TITLE__` 占位即契约；行尾 CRLF 禁转 LF）。**还原／变异回写这一件时**：它被 `.gitattributes` 钉了 `text eol=crlf`（库内存 LF、检出 CRLF），故**不要**拿 `git show HEAD:<路径>` 的原文直接写回（那是 LF，会让 `gen-help-shell.cjs` 的 CRLF 断言当场抛错）；用工作树原文读进写出（`readFileSync` → `writeFileSync`）即逐字节安全。
 3. 改后跑 gen：一键 `pnpm --filter base-paint gen:help-shell`（重写 `src/helpShell.ts`＋测试哈希；字节锁随 `pnpm test` 在 CI 验 drift，`gen:help-shell:check` 本地同口径）。
 4. 过门：字节锁（`test/help-shell-136.test.mjs` 哈希）＋像素门（skill-calorie `help-shell-134` 双端/覆盖序）＋ `tsc -b` 全绿。
 5. 手改生成物（`src/helpShell.ts`／测试哈希）必红：`--check` 非 0＋字节锁红。
 6. 源不进包：`files` 仅 `dist`（省约 105KB；追溯靠仓库＋哈希锁），包内只留 `dist/helpShell.js`。
+
+---
+
+## 组件目录（发现口）
+
+**包名说明**：目录叫 `packages/base-render`，npm 包名叫 `base-paint`——是同一个包，下文均用包名，引用时照抄即可。
+
+本节回答“该调谁”。help 铁律见上，一字未动。机读正身在 `src/spec/`（冻结签名）＋契约正本 `../../docs/base-paint-contract.md`；行为示例看 `test/`。
+
+### 速查三问
+
+| 我要画 | 调谁 | 从哪引 |
+|---|---|---|
+| 分布条 | `renderDistributionRows` | `base-paint/blocks`（子路径） |
+| 徽章 | `renderStatusBadge`（空态／失败回执另有 `renderEmptyState`／`renderErrorReceipt`） | `base-paint` 根 |
+| 环图 | `charts`（`donut` 种）＋ `chartsCss` 取样式 ＋ `buildChartsHelpersJs` 取脚本 | `base-paint` 根 |
+
+注意：`blocks` 整组只走子路径 `base-paint/blocks`，根出口没有它；以下除注明外均走 `base-paint` 根。
+
+### 区块组装（`base-paint/blocks`）——新页面只许 blocks 组装
+
+| 函数 | 一句话 |
+|---|---|
+| `renderPageShell` | 页面容器与标题区，每页外层 |
+| `renderTocBlock` | 目录区块 |
+| `renderCaliberLine` | 口径说明行（一行小字） |
+| `renderConclusionBar` | 结论条（一句话总结） |
+| `renderMiniBar` | 细进度条 |
+| `renderDistributionRows` | 分布行（名＋条＋值，窄槽语义见包内测试） |
+| `renderChips` | 标签片组 |
+| `renderChangeRows` | 变化行（涨跌对照） |
+| `renderKpiCard`／`renderKpiGrid` | 指标卡／指标卡宫格 |
+| `renderDataTable` | 数据表 |
+| `renderChartBlock` | 图表容器块（承 `charts` 的产出） |
+| `renderListRows` | 列表行 |
+| `renderPreBlock` | 预排文本块（命令／CLI 展示） |
+| `renderDetailSection` | 详情分区 |
+| `renderDisclosure` | 折叠展开区 |
+| `renderParamForm` | 参数表单 |
+| `renderEmptyBlock` | 空态块 |
+| `renderCopyBlock` | 可复制文本块 |
+| `renderFeedbackBlock` | 反馈块 |
+| `blocksCss` | 区块样式唯一产出者（配 `BLOCK_STYLE_SECTIONS` 分段表） |
+
+示例：`test/blocks.test.mjs`；源：`src/blocks.ts`。
+
+### 控件（根）——原子交互与状态
+
+| 函数 | 一句话 |
+|---|---|
+| `renderToast`／`createToastController` | 轻提示与它的控制器（含堆叠语义） |
+| `copyText`／`createCopyRuntime`／`bindCopyAction` | 复制三件套（双通道＋提示反馈，唯一实现） |
+| `buildSharedHelpersJs` | 共享脚本唯一产出者（`SHARED-HELPERS` 槽填充物） |
+| `renderActionBar` | 操作条 |
+| `renderStatusBadge` | 状态徽标（`ok`／`warn`／`danger`／`empty`） |
+| `renderEmptyState` | 空态 |
+| `renderErrorReceipt` | 失败回执 |
+| `TOAST_ICON_GLYPHS` | 提示图标表 |
+
+示例：`test/controls.test.mjs`、`test/copy-*.test.mjs`；源：`src/controls.ts`。
+
+### 图表（根）——8 种纯字符串产出
+
+- `charts`：统一入口，`bar`／`line`／`donut`／`progress`／`combo`／`sparkline`／`gauge`／`scatter`（CSS＋SVG 字符串，无 canvas）。
+- `buildChartsHelpersJs`：图表脚本唯一产出者；`chartsCss`：图表样式。
+- 示例：`test/charts.test.mjs`；源：`src/charts.ts`；种定义：`src/spec/charts.ts`。
+
+### 页面级（根）——整页怎么摆，不参与区块组合
+
+- 形状件（`src/pageShapes.ts`）：`renderFactStrip` 事实条；`renderMediaFigure`／`renderMediaPlaceholder` 图片与媒体占位；`renderTimelineRows` 时间轴行；`pageShapeCss` 形状样式；`MEDIA_RATIOS` 比例表。
+- 移动端配方（`src/pageUi.ts`）：`pageUiCss` 断点／触摸区／安全区样式；`PAGE_UI_CLASS`／`PAGE_UI_VIEWPORT` 挂载常量。是否启用由整页装配决定，不启用则产出逐字节不变。
+
+### 管线与契约（根）
+
+| 函数 | 一句话 |
+|---|---|
+| `fillTemplate` | 占位符填充器（模板＋数据组装，失败抛错不返空页） |
+| `buildStyleSheet`／`cx`／`token` | 样式表唯一产出者与类名工具（`STYLE_TOKENS` 11 个 token 唯一真相源） |
+| `buildDataText`／`buildLogText` | 复制文本序列化（`text`／`json`／`csv` 三格式） |
+| `renderPage`／`renderReco` | 页面与推荐渲染；`escapeHtml` 转义；`RenderError` |
+| `mountInjector`／`openPage` | 多页挂载与开页 |
+| `createPageRegistry`／`pageOrReco`／`recoDescriptor` | 页面注册与推荐描述 |
+| `BODY_FONT_STACK` | 正文字体栈 |
+| `renderHelpShell` | 数据页分型 help 模板渲染 |
+
+### 错误类口径
+
+`RenderError` 根有导出；其余 `*Error`（`TemplateError`／`ControlsError`／`TextError`／`ChartError`／`BlocksError`／`HelpSchemaError`）不在根导出——冻结面无条目，调用方按 `name`／`code` 判定。
+
+### 正身与测试索引
+
+- 冻结签名正身：`src/spec/`（7 件）↔ `../../docs/base-paint-contract.md`，由 `test/contract-signatures.test.mjs` 逐字锁死。
+- 分组示例：`test/render.test.mjs`、`test/template.test.mjs`、`test/style.test.mjs`、`test/text.test.mjs`、`test/help.test.mjs`、`test/help-shell-136.test.mjs`（字节锁）、`test/ui-fix-154.test.mjs`。

package/dist/blocks.d.ts

@@ -60,7 +60,8 @@ export interface TocBlockInput {
     readonly items: readonly TocItem[];
 }
 /** #420-1 页内导航区块（`<nav aria-label="页内导航">` ＋ 逐项 `<a href="#id">`）。
- *  空列表＝不出这一块（与「没内容不留空块」同口径，返回空串）；非数组／项缺 `id`／`text` → `bad-input`。 */
+ *  空列表＝不出这一块（与「没内容不留空块」同口径，返回空串）；缺失（`undefined`）→ `bad-input`
+ *  （非数组即拒）；项缺 `id`／`text` → `bad-input`。 */
 export declare function renderTocBlock(input: TocBlockInput): string;
 /** #420-2 口径说明行（纯文本单参；五字符转义表与区块层其余函数同源 `esc`）。
  *  聚合数字旁那句灰色小字（例如「周目标口径＝每日目标 × 7」）的唯一落点。
@@ -111,7 +112,8 @@ export interface DistributionRowsInput {
     readonly rows: readonly DistributionRowInput[];
 }
 /** #421-2 分布条行：`名称 ｜ 条 ｜ 数值` 一格三栏，逐行拼出（行即件，不另加容器类）。
- *  `rows: []` ＝ 空串（与「没内容不留空块」同口径）；行内校验逐条 fail-fast。 */
+ *  `rows: []` ＝ 空串（与「没内容不留空块」同口径）；缺失（`undefined`）→ `bad-input`（非数组即拒）；
+ *  行内校验逐条 fail-fast。 */
 export declare function renderDistributionRows(input: DistributionRowsInput): string;
 export interface ChipItemInput {
     readonly text: string;
@@ -120,7 +122,7 @@ export interface ChipsInput {
     readonly items: readonly ChipItemInput[];
 }
 /** #421-3 徽章（并列小标签，如分类／标签这类短词并排）：逐项 `<span class="ilife-block-chip">`。
- *  项即件（不另加容器类）；`items: []` ＝ 空串。 */
+ *  项即件（不另加容器类）；`items: []` ＝ 空串；缺失（`undefined`）→ `bad-input`（非数组即拒）。 */
 export declare function renderChips(input: ChipsInput): string;
 export interface ChangeRowInput {
     readonly label: string;
@@ -136,7 +138,7 @@ export interface ChangeRowsInput {
 }
 /** #421-4 字段变更行（回执页「改前 → 改后」对照）：`字段名 ｜ 改前 ｜ 箭头 ｜ 改后`。
  *  `arrow: false` 只把字形藏起来、不删栏位（与老技能同一手法：左右栏靠箭位对齐）；
- *  `rows: []` ＝ 空串。 */
+ *  `rows: []` ＝ 空串；缺失（`undefined`）→ `bad-input`（非数组即拒）。 */
 export declare function renderChangeRows(input: ChangeRowsInput): string;
 export interface KpiCardInput {
     readonly label: string;
@@ -145,20 +147,35 @@ export interface KpiCardInput {
     readonly detail?: string;
     readonly status?: StatusKind;
     readonly statusText?: string;
+    /** 可选进度条（#418）：百分比 0–100；不给＝不产条（零变）。 */
+    readonly bar?: {
+        readonly pct: number;
+    };
 }
 /** B-02：单张 KPI 卡（value 带 `tnum`；非法 status 由冻结语义降级 `empty`）。 */
 export declare function renderKpiCard(input: KpiCardInput): string;
+/** B-02 伴生布局的标题选项（#513 段标题槽）：只 `title` 一位，与 `renderChartBlock`／`copyArea`
+ *  的 `title` 位同形（非空字符串 ⇒ 段标题 h2；缺省／空串 ⇒ 零渲染）。 */
+export interface KpiGridOptions {
+    readonly title?: string;
+}
 /** B-02 伴生布局：KPI 卡网格（不是第 13 个区块，无独立样式区，用 `kpiCard` 区）。 */
-export declare function renderKpiGrid(cards: readonly KpiCardInput[]): string;
+export declare function renderKpiGrid(cards: readonly KpiCardInput[], opts?: KpiGridOptions): string;
 export type DataTableAlign = 'left' | 'center' | 'right';
 export interface DataTableColumn {
     readonly key: string;
     readonly label: string;
     readonly align?: DataTableAlign;
 }
+/** 表格行（#513 行标记槽）：单元格映射＋可选 `marker`（非空字符串 ⇒ 首格前插行徽标；
+ *  缺省／空串 ⇒ 不产出。非字符串非 undefined 即 `bad-input`）。列 key 叫 `marker` 的表不受影响——
+ *  全仓既有调用点无此列键（#513 实施时 grep 实测），见证据件。 */
+export type DataTableRow = Readonly<Record<string, unknown> & {
+    marker?: unknown;
+}>;
 export interface DataTableInput {
     readonly columns: readonly DataTableColumn[];
-    readonly rows: readonly Readonly<Record<string, unknown>>[];
+    readonly rows: readonly DataTableRow[];
     readonly caption?: string;
     readonly emptyText?: string;
     /** 单元格 HTML（#567 状态列）：`(列 key, 单元格原值) => 受信 HTML／undefined`。

package/dist/blocks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../src/blocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAKH,OAAO,EAEL,cAAc,EAEd,eAAe,EAEf,iBAAiB,EAMjB,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EAEjB,KAAK,EAEL,UAAU,EACV,UAAU,EACX,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAI1B,qDAAqD;AACrD,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;gBAEf,OAAO,EAAE,MAAM;CAK5B;AAsED,4CAA4C;AAC5C,eAAO,MAAM,oBAAoB,8KAavB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAmCtE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;sDACkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAiB7D;AAMD,MAAM,WAAW,OAAO;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;CACpC;AAED;sEACsE;AACtE,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAc3D;AAOD;;;;;;;;;;yBAUyB;AACzB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED;;;;;;;;;oBASoB;AACpB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AA6GD,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;yFACqF;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;iEACiE;AACjE,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CASzD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,0BAA0B;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;yFACqF;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAChD;AAED;uDACuD;AACvD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAyB3E;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C;AAED;oCACoC;AACpC,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAarD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC,cAAc;IACd,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,CAAC;CAC1C;AAED;;uBAEuB;AACvB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAsB/D;AAMD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAwBzD;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAIpE;AAMD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;0DAGsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;CAC/E;AAYD,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CA0D7D;AAMD,MAAM,MAAM,oBAAoB,GAC5B,aAAa,GAAG,cAAc,GAAG,eAAe,GAAG,kBAAkB,GACrE,eAAe,GAAG,mBAAmB,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA0B/D;AAMD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CA8B3D;AAMD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAmB3D;AAMD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAiBD,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAuCrE;AAMD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAU/D;AAMD;2EAC2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,kGAAkG;IAClG,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,0BAA0B;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B;qFACiF;IACjF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;iDAMiD;AACjD,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CA4E7D;AAMD,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAS/D;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7C;;+CAE2C;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;CACxC;AAED;;;;2BAI2B;AAC3B,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CA+B7D;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC;;;;;;;;0FAQsF;IACtF,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AA2CD;+DAC+D;AAC/D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAgBrE;AAs/BD,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;qDAEqD;AACrD,wBAAgB,SAAS,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,MAAM,CAUxD;AAID,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC;AAC9E,YAAY,EACV,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,UAAU,GACX,CAAC"}
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../src/blocks.ts"],"names":[],"mappings":"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"}

package/dist/blocks.js

@@ -172,7 +172,8 @@ export function renderPageShell(input) {
     return parts.join('');
 }
 /** #420-1 页内导航区块（`<nav aria-label="页内导航">` ＋ 逐项 `<a href="#id">`）。
- *  空列表＝不出这一块（与「没内容不留空块」同口径，返回空串）；非数组／项缺 `id`／`text` → `bad-input`。 */
+ *  空列表＝不出这一块（与「没内容不留空块」同口径，返回空串）；缺失（`undefined`）→ `bad-input`
+ *  （非数组即拒）；项缺 `id`／`text` → `bad-input`。 */
 export function renderTocBlock(input) {
     assertPlainObject(input, 'renderTocBlock: input');
     assertNoInlineHandler(input, 'renderTocBlock: input');
@@ -290,7 +291,10 @@ function isRgbFunction(raw) {
 /** 色值入参（#421／#431）：`undefined` 透传（缺省色走样式段的冻结 token）；清单内的写法**逐字透传**
  *  （裸 token 名 `--x` 包成 `var(--x)`）。允许清单＝`#rgb`／`#rrggbb`／`rgb()`／`rgba()`／
  *  `var(--<冻结 token 名>)`／CSS 具名色；**清单外一律 `bad-input`**——`;`／`expression(`／`url(` 这类
- *  注入形态在这一步挡住，不让 `;` 穿进内联声明列表（审查 S3-6）。 */
+ *  注入形态在这一步挡住，不让 `;` 穿进内联声明列表（审查 S3-6）。
+ *  迁移提示（#441 实测，复核 D1 补第 4 处）：生产侧显式传色 4 处（`diet/nutritionPortDocs.ts:339` 一处带 3 个 `#rrggbb` 值、
+ *  `render/sportPortDocs.ts:609／775` 两处经 `categoryColor()` 取 4 个 `#rrggbb` 值，`diet/reviewDocs.ts:339-341` 一处经 `MEAL_COLORS` 由 `diet/todayDocs.ts:242` 进入生产），均属允许形态，
+ *  无须改动；其余生产调用不传色，走缺省冻结 token；新增写法先对清单，清单外改走冻结 token 或具名色。 */
 function optColor(value, field) {
     if (value === undefined)
         return undefined;
@@ -349,7 +353,8 @@ export function renderMiniBar(input) {
         + '</span>';
 }
 /** #421-2 分布条行：`名称 ｜ 条 ｜ 数值` 一格三栏，逐行拼出（行即件，不另加容器类）。
- *  `rows: []` ＝ 空串（与「没内容不留空块」同口径）；行内校验逐条 fail-fast。 */
+ *  `rows: []` ＝ 空串（与「没内容不留空块」同口径）；缺失（`undefined`）→ `bad-input`（非数组即拒）；
+ *  行内校验逐条 fail-fast。 */
 export function renderDistributionRows(input) {
     assertPlainObject(input, 'renderDistributionRows: input');
     assertNoInlineHandler(input, 'renderDistributionRows: input');
@@ -379,7 +384,7 @@ export function renderDistributionRows(input) {
     }).join('');
 }
 /** #421-3 徽章（并列小标签，如分类／标签这类短词并排）：逐项 `<span class="ilife-block-chip">`。
- *  项即件（不另加容器类）；`items: []` ＝ 空串。 */
+ *  项即件（不另加容器类）；`items: []` ＝ 空串；缺失（`undefined`）→ `bad-input`（非数组即拒）。 */
 export function renderChips(input) {
     assertPlainObject(input, 'renderChips: input');
     assertNoInlineHandler(input, 'renderChips: input');
@@ -398,7 +403,7 @@ export function renderChips(input) {
 }
 /** #421-4 字段变更行（回执页「改前 → 改后」对照）：`字段名 ｜ 改前 ｜ 箭头 ｜ 改后`。
  *  `arrow: false` 只把字形藏起来、不删栏位（与老技能同一手法：左右栏靠箭位对齐）；
- *  `rows: []` ＝ 空串。 */
+ *  `rows: []` ＝ 空串；缺失（`undefined`）→ `bad-input`（非数组即拒）。 */
 export function renderChangeRows(input) {
     assertPlainObject(input, 'renderChangeRows: input');
     assertNoInlineHandler(input, 'renderChangeRows: input');
@@ -424,6 +429,14 @@ export function renderChangeRows(input) {
             + '</div>';
     }).join('');
 }
+/** #418 条位判档（只此一处）：>=90 高档／>=60 中档／其余低档。 */
+function kpiBarClass(pct) {
+    if (pct >= 90)
+        return 'bar-high';
+    if (pct >= 60)
+        return 'bar-mid';
+    return 'bar-low';
+}
 /** B-02：单张 KPI 卡（value 带 `tnum`；非法 status 由冻结语义降级 `empty`）。 */
 export function renderKpiCard(input) {
     assertPlainObject(input, 'renderKpiCard: input');
@@ -442,6 +455,17 @@ export function renderKpiCard(input) {
     const detail = optText(card.detail);
     if (detail !== undefined)
         parts.push('<div class="' + blockPart('kpiCard', 'detail') + '">' + esc(detail) + '</div>');
+    const bar = card.bar;
+    if (bar !== undefined) {
+        assertPlainObject(bar, 'renderKpiCard: bar');
+        const pct = bar.pct;
+        if (typeof pct !== 'number' || !Number.isFinite(pct) || pct < 0 || pct > 100) {
+            badInput('renderKpiCard: bar.pct 必须在 0–100 之间');
+        }
+        parts.push('<div class="' + blockPart('kpiCard', 'bar') + '">'
+            + '<div class="' + blockPart('kpiCard', 'bar-fill') + ' ' + blockPart('kpiCard', kpiBarClass(pct)) + '" style="width:' + pct + '%"></div>'
+            + '</div>');
+    }
     if (card.status !== undefined) {
         const status = STATUS_KINDS.includes(card.status) ? card.status : 'empty';
         const badge = renderStatusBadge(card.statusText === undefined ? { status } : { status, text: card.statusText });
@@ -451,11 +475,22 @@ export function renderKpiCard(input) {
     return parts.join('');
 }
 /** B-02 伴生布局：KPI 卡网格（不是第 13 个区块，无独立样式区，用 `kpiCard` 区）。 */
-export function renderKpiGrid(cards) {
+export function renderKpiGrid(cards, opts) {
     if (!Array.isArray(cards) || cards.length === 0)
         badInput('renderKpiGrid: cards 必须是非空数组');
-    return '<div class="' + blockPart('kpiCard', 'grid') + '">'
+    if (opts !== undefined) {
+        assertPlainObject(opts, 'renderKpiGrid: opts');
+        assertNoInlineHandler(opts, 'renderKpiGrid: opts');
+    }
+    const grid = '<div class="' + blockPart('kpiCard', 'grid') + '">'
         + cards.map((card) => renderKpiCard(card)).join('') + '</div>';
+    // #513：不给 title 即返回原 grid 串（与改前逐字节同）；给了即标题 h2 ＋原 grid
+    // （与页面当刻手写形一致，页面票后迁可逐字节对）。标题类复用 #507 已落盘的 `kpi-card-title`
+    //（15px／700），不新增类名、不新增样式区。
+    const title = opts === undefined ? undefined : optText(opts.title);
+    if (title === undefined)
+        return grid;
+    return '<h2 class="' + blockPart('kpiCard', 'title') + '">' + esc(title) + '</h2>' + grid;
 }
 const TABLE_ALIGNS = ['left', 'center', 'right'];
 function cellText(value, field) {
@@ -497,7 +532,14 @@ export function renderDataTable(input) {
     const head = '<thead><tr>' + columns.map((column) => '<th scope="col" class="' + blockPart('dataTable', 'cell-' + column.align) + '">' + esc(column.label) + '</th>').join('') + '</tr></thead>';
     const body = '<tbody>' + table.rows.map((row, ri) => {
         assertPlainObject(row, 'renderDataTable: input.rows[' + ri + ']');
-        return '<tr>' + columns.map((column) => {
+        // #513 行标记槽：可选 `marker`（非空字符串 ⇒ 首格前插行徽标；缺省／空串 ⇒ 零渲染，
+        // 本行与改前逐字节同）；非字符串非 undefined 即 `bad-input`（与 `cellText` 同严格）。
+        const rawMarker = row.marker;
+        if (rawMarker !== undefined && typeof rawMarker !== 'string') {
+            badInput('renderDataTable: input.rows[' + ri + '].marker 必须是非空字符串／undefined');
+        }
+        const marker = rawMarker === undefined ? undefined : optText(rawMarker);
+        return '<tr>' + columns.map((column, ci) => {
             const raw = row[column.key];
             // #567 `cellHtml`：给了且对本格返回字符串即受信透传（调用方已转义）；
             // 返回 `undefined` 即走缺省转义文本。不给 `cellHtml` 时本行与改前逐字同。
@@ -518,8 +560,12 @@ export function renderDataTable(input) {
             const text = trusted === undefined
                 ? cellText(raw, 'renderDataTable: input.rows[' + ri + '].' + column.key)
                 : trusted;
-            return '<td class="' + blockPart('dataTable', 'cell-' + column.align) + '" data-label="' + esc(column.label) + '">'
-                + text + '</td>';
+            const open = '<td class="' + blockPart('dataTable', 'cell-' + column.align) + '" data-label="' + esc(column.label) + '">';
+            // #513：行标记只进首格（转义后前插；`cellHtml` 受信透传不受影响）。
+            const head = ci === 0 && marker !== undefined
+                ? '<span class="' + blockPart('dataTable', 'row-marker') + '">' + esc(marker) + '</span>'
+                : '';
+            return open + head + text + '</td>';
         }).join('') + '</tr>';
     }).join('') + '</tbody>';
     const caption = optText(table.caption);
@@ -1053,6 +1099,87 @@ const BLOCK_SECTION_BUILDERS = {
         '  font-size: 15px;',
         '  font-weight: 600;',
         '}',
+        // #434 操作卡头部（#422 共用件 `operationHead()` 的根类＋四色档＋四子件；样式落本区，不新增区）。
+        // 形态对齐老实物 `crud_receipt` 的 `id-card` 左色条（样张 `t156-样张-写后回执.html:153-160`：
+        // `border-left:4px solid` 随 op 切）：基规则出卡片＋ 4px 左条（缺省中性 `var(--line)`），
+        // 四色档只改 `border-left-color`。版式把页级四条覆盖收编（`sportUi.ts` 的 `.ilife-page …`
+        // 四条本票删除后落点）：图标＋徽章＋标题同排，记录号／时刻行各占整行（`flex:1 0 100%`）。
+        // 内距取同族卡片档 14px（`kpiCard`／`chartBlock`／`detailSection` 同值），样张的 18px 20px
+        // 是 throwaway 密度不照搬；块级 `margin:16px 0` 取 #154 同族值（与 #457 相邻兄弟规则折叠恒 16）。
+        '.' + p + 'block-op-head {',
+        '  display: flex;',
+        '  flex-wrap: wrap;',
+        '  align-items: center;',
+        '  gap: 8px 12px;',
+        '  margin: 16px 0;',
+        '  padding: 14px;',
+        '  border: 1px solid var(--line);',
+        '  border-left: 4px solid var(--line);',
+        '  border-radius: ' + RADIUS_MD + 'px;',
+        '  background: var(--card);',
+        '}',
+        // 四色档（`OPERATION_TONES` ok／warn／danger／empty 的样式落点；只改左条色）。
+        // 色值口径：ok 取冻结 token `var(--ok)`（值 `#34c759`，与样张 `opColors` 同值）；
+        // 冻结表无 warn／danger 灯位，故 warn／danger 取同仓状态徽章同源 D-5 常量
+        // （`src/style.ts` statusBadge 区 warn `#a25b00`／danger `#a83228`，不新增 token 名）；
+        // empty 取冻结 `var(--fg2)`（与 empty 徽章字色同值，中性）。
+        // 样张的 `#0071e3` 在 H-01 禁色表内（`test/style.test.mjs:241`），一律不用；
+        // 色条是非文本，不套 #179 的文本对比度档。
+        '.' + p + 'block-op-head-ok {',
+        '  border-left-color: var(--ok);',
+        '}',
+        '.' + p + 'block-op-head-warn {',
+        '  border-left-color: #a25b00;',
+        '}',
+        '.' + p + 'block-op-head-danger {',
+        '  border-left-color: #a83228;',
+        '}',
+        '.' + p + 'block-op-head-empty {',
+        '  border-left-color: var(--fg2);',
+        '}',
+        // 子件四条（`operationHead()` 的 `-icon`／`-title`／`-id`／`-time`）。
+        // 图标 40px 中性盒（样张 12px 圆角按 D-5 收进闭集取 14；底色取中性 `var(--soft)`，
+        // 色档由左条＋徽章承担，图标不跟色）；标题 18px／700 取 `detail-section-title` 档
+        // （#567 J4 标题 18 吸收 17／18／20／22）；记录号 13px 取 `--fg2`；时刻行 12px 取
+        // `--fg2`（#179：12px 小字须 4.5:1，`--fg3` 3.62:1 不用）。
+        // 时刻行首的「写入时间 」键（`sportUi.ts` 迁回）：`actionAt` 即写入时间
+        // （`body/receipt.ts:162` 同值同词 `{ k: '写入时间', v: actionAt }`），CSS 内容只进
+        // 渲染层；第二消费族出现时提到调用方文案面并删此条（过渡债务，本票如实记）。
+        '.' + p + 'block-op-head-icon {',
+        '  display: inline-flex;',
+        '  align-items: center;',
+        '  justify-content: center;',
+        '  width: 40px;',
+        '  height: 40px;',
+        '  border-radius: ' + RADIUS_MD + 'px;',
+        '  background: var(--soft);',
+        '  color: var(--fg);',
+        '  font-size: 20px;',
+        '  line-height: 1;',
+        '}',
+        '.' + p + 'block-op-head-title {',
+        '  display: inline-flex;',
+        '  align-items: center;',
+        '  margin: 0;',
+        '  color: var(--fg);',
+        '  font-size: 18px;',
+        '  font-weight: 700;',
+        '}',
+        '.' + p + 'block-op-head-id {',
+        '  flex: 1 0 100%;',
+        '  margin: 0;',
+        '  color: var(--fg2);',
+        '  font-size: 13px;',
+        '}',
+        '.' + p + 'block-op-head-time {',
+        '  flex: 1 0 100%;',
+        '  margin: 0;',
+        '  color: var(--fg2);',
+        '  font-size: 12px;',
+        '}',
+        '.' + p + 'block-op-head-time::before {',
+        '  content: "写入时间 ";',
+        '}',
         // #421 页面融合四件的样式随本区落盘（同 #420 处置：四件都是页面级、不属 12 区块，
         // `BLOCK_STYLE_SECTIONS` 由 `test/blocks.test.mjs` 钉死 12 项，故不新增样式区、不新增 token）。
         // **色值口径（#431 定稿）**：区块自身不写死任何色值字面量——样式里只出现冻结 token。不给 `color`
@@ -1204,7 +1331,20 @@ const BLOCK_SECTION_BUILDERS = {
         '  gap: 12px;',
         '  margin: 16px 0;',
         '}',
+        // #507 桌面列数上限（用户点名：6 张 KPI 在宽屏挤成一行）：基座 `auto-fit minmax(150px,1fr)`
+        // 无上限，越宽列越多。只加 ≥1024 一档 `repeat(3,…)`，基座一行不动；窄屏 2×2（#507 窄屏档）
+        // 与 400 单列（`pageUi` ⑦）各管各档。断点取票面值 1024；选择器挂祖先类（与窄屏档同法），
+        // 同名基座仍恰 1 条（`declsOf` 口径），不新类名、不新样式区。
+        '@media (min-width: 1024px) {',
+        '  .' + p + 'block-page-shell .' + p + 'block-kpi-card-grid {',
+        '    grid-template-columns: repeat(3, minmax(0, 1fr));',
+        '  }',
+        '}',
+        // #513 徽章贴底：卡片改纵向 flex 列（子元素仍纵向满宽，`align-items` 缺省 `stretch`、
+        // 无子元素设交叉轴尺寸 ⇒ 视觉同块流），余量由徽章的 `margin-top: auto` 吃掉（见下）。
         '.' + p + 'block-kpi-card {',
+        '  display: flex;',
+        '  flex-direction: column;',
         '  padding: 14px;',
         '  border: 1px solid var(--line);',
         '  border-radius: ' + RADIUS_MD + 'px;',
@@ -1249,8 +1389,33 @@ const BLOCK_SECTION_BUILDERS = {
         '  font-size: 12px;',
         '  overflow-wrap: anywhere;',
         '}',
+        // #513（续）：`margin-top: auto` 把徽章压到底；`padding-top: 8px` 保住改前 8px 最小间距
+        // （最高卡无余量时徽章位置与改前一致，只动有余量的短卡——正是要修的那几张）。
         '.' + p + 'block-kpi-card-badge {',
+        '  margin-top: auto;',
+        '  padding-top: 8px;',
+        '}',
+        // #418 条位：detail 之后 badge 之前产条（见 renderKpiCard）。色值单源（甲路）：
+        // 三档各一处字面量，源 spec/charts.ts CHART_PALETTE[1..3]，与状态徽章底色同值。
+        '.' + p + 'block-kpi-card-bar {',
+        '  height: 6px;',
+        '  border-radius: ' + RADIUS_PILL + 'px;',
+        '  background: var(--line);',
         '  margin-top: 8px;',
+        '  overflow: hidden;',
+        '}',
+        '.' + p + 'block-kpi-card-bar-fill {',
+        '  height: 100%;',
+        '  border-radius: ' + RADIUS_PILL + 'px;',
+        '}',
+        '.' + p + 'block-kpi-card-bar-high {',
+        '  background: #34c759;',
+        '}',
+        '.' + p + 'block-kpi-card-bar-mid {',
+        '  background: #ff9500;',
+        '}',
+        '.' + p + 'block-kpi-card-bar-low {',
+        '  background: #ff3b30;',
         '}',
         // #507 段标题统一（审查必改 #5）：`blocks.ts` 从 #401 起就给过这条类名产出器的位置
         // （`homeDocs.ts:247` 用 `<h2 class="ilife-block-kpi-card-title">` 出「今日速览」段标题），
@@ -1264,13 +1429,13 @@ const BLOCK_SECTION_BUILDERS = {
         '  font-size: 15px;',
         '  font-weight: 700;',
         '}',
-        // #507 窄屏档（审查必改 #4）：`auto-fit minmax(150px,1fr)` 只在容器有效宽 ≥474px 时排 3 列
+        // #507 窄屏档（审查必改 #4）＋ #427 收窄为单列：`auto-fit minmax(150px,1fr)` 只在容器有效宽 ≥474px 时排 3 列
         // （3×150 ＋ 2×12 间隙），而手机端页面模板 `padding:20px 16px`（见本区 ≤640px 段）——
         // 512 视口下栅格有效宽仅 480px ⇒ 正好卡在 3 列下沿，第 4 张卡单独占一行、宽度只有前三张的
         // 1/3（`grid-auto-rows:1fr` 又让它与前三张**等高**），看着像漏了一张。
-        // 本条只加**窄屏一档**：≤640px 显式 2 列 ⇒ 4 张卡排成整齐 2×2；`minmax(0,1fr)` 里的 0
-        // 是下限（不是 `auto` 那种取内容最小宽），长值卡不会被撑破。桌面档一行不动
-        // （桌面列数上限是另一票的事，本票不碰）。断点取本文件既有先例：`dataTable` 与 `pageShell`
+        // #427（#507§8 三条窄屏归 #427，同一段代码）：≤640 显式单列 ⇒ 390 每张占整行上下排列；
+        // `minmax(0,1fr)` 的 0 是下限（不是 `auto` 那种取内容最小宽），长值卡不会被撑破。
+        // 桌面档一行不动（桌面列数上限 #507 的 1024 三列帽另管）。断点取本文件既有先例：`dataTable` 与 `pageShell`
         // 两处都是 `@media (max-width: 640px)`。
         // 选择器是 `.ilife-block-page-shell .ilife-block-kpi-card-grid`（基础类名前挂一个祖先类），
         // **不是**同名再写一条：① 网格落在页面模板正文里（`renderKpiGrid` 的唯一用法），该祖先恒成立；
@@ -1278,7 +1443,7 @@ const BLOCK_SECTION_BUILDERS = {
         // 判账，同名再起一条会被数成 2 条而红；`dataTable` 区那条同名 640px 规则是历史写法，本票不动它。
         '@media (max-width: 640px) {',
         '  .' + p + 'block-page-shell .' + p + 'block-kpi-card-grid {',
-        '    grid-template-columns: repeat(2, minmax(0, 1fr));',
+        '    grid-template-columns: minmax(0, 1fr);',
         '  }',
         '}',
     ].join(LF),
@@ -1312,6 +1477,22 @@ const BLOCK_SECTION_BUILDERS = {
         '  font-weight: 600;',
         '  text-align: left;',
         '}',
+        // #513 行标记槽：首格前插的行徽标（`renderDataTable` 的 `rows[i].marker`）。行内小徽标：
+        // 色走冻结 token（底 `--soft`＋字 `--blue2`，与 `block-chip` 同口径，不新增 token；
+        // 12px 小字对比度约 5.4:1，#179 口径达 AA）；`white-space: nowrap` 保徽标不断行；
+        // 只吃内容宽，不改窄屏档位（横溢口径见证据件）。
+        '.' + p + 'block-data-table-row-marker {',
+        '  display: inline-block;',
+        '  margin-right: 6px;',
+        '  padding: 1px 7px;',
+        '  border-radius: ' + RADIUS_PILL + 'px;',
+        '  background: var(--soft);',
+        '  color: var(--blue2);',
+        '  font-size: 12px;',
+        '  font-weight: 600;',
+        '  white-space: nowrap;',
+        '  vertical-align: baseline;',
+        '}',
         '.' + p + 'block-data-table th {',
         '  padding: 10px 14px;',
         '  border-bottom: 1px solid var(--line);',
@@ -1340,6 +1521,13 @@ const BLOCK_SECTION_BUILDERS = {
         '.' + p + 'block-data-table tr:last-child td {',
         '  border-bottom: none;',
         '}',
+        // #507 表格斑马纹（用户点名的两条之一；另一条数值列等宽栈已由 #507 视觉底座落地，本票不重做）：
+        // 偶数数据行取 `var(--bg)`（既有冻结 token，不新增语义 token）。只染 `tbody` 行，列头不动；
+        // 背景落 `td`（本表 `border-collapse: collapse`，行背景不可靠）。伪类挂既有类上，不新类名、
+        // 不新样式区；窄屏行卡化（#457）下偶数卡整格同底，仍可读。
+        '.' + p + 'block-data-table tbody tr:nth-child(even) td {',
+        '  background-color: var(--bg);',
+        '}',
         '.' + p + 'block-data-table-cell-left {',
         '  text-align: left;',
         '}',
@@ -1686,6 +1874,13 @@ const BLOCK_SECTION_BUILDERS = {
         '.' + p + 'block-disclosure[open] > .' + p + 'block-disclosure-summary::before {',
         '  transform: rotate(90deg);',
         '}',
+        // #507 减动效归零档（照老壳 `style.ts` 归零档补：本区唯一的 `transition` 在此归零；
+        // 只停过渡，`rotate(90deg)` 开合终态照走）。
+        '@media (prefers-reduced-motion: reduce) {',
+        '  .' + p + 'block-disclosure-summary::before {',
+        '    transition: none;',
+        '  }',
+        '}',
         '.' + p + 'block-disclosure-body {',
         '  padding: 0 14px 14px;',
         '}',