agentcss 0.11.3 → 0.11.5

package/01-tokens/README.md

@@ -51,8 +51,8 @@
 2. **容器自己不会涂底色**。`[data-theme]` 只切换令牌；要不要给这块区域加背景，
    由你决定（通常 `background: var(--paper)`）。
 3. **`color-scheme` 目前只由 `date-range` 局部设置**，根上没有。所以暗色下
-   原生滚动条/日期弹层不会跟着变 —— 这是已知未决项，见
-   `docs/RFC-THEME-SCOPE.md` 第六节（它会让既有 40 页视觉基线全变，需要单独一轮）。
+   原生滚动条/日期弹层不会跟着变 —— 这是已知未决项：改它会让既有 40 页视觉
+   基线全变，需要单独一轮。
 
 组件的明暗差异**全部由令牌表达**，组件 CSS 里不许出现
 `@media (prefers-color-scheme: dark)` —— 主题能从容器来之后，那种写法只反映系统偏好，

package/01-tokens/focus-ring.css

@@ -81,7 +81,7 @@
    四、只在键盘时"上浮"（可选的增强）
    ----------------------------------------------------------------------------
    聚焦时轻微提亮，帮助用户追踪焦点在长内容里的位置。
-   ⚠️ 用 `transition` 且尊重 reduced-motion（见 charter 07）。
+   ⚠️ 用 `transition` 且尊重 reduced-motion。
    ========================================================================== */
 @media (prefers-reduced-motion: no-preference) {
   :where(a, button, [role="button"], [role="tab"]) {

package/01-tokens/tokens.css

@@ -614,7 +614,7 @@
   /* 凹陷面不再更黑，改为比 paper 略浅（层级靠变亮） */
   --raw-surface-sunken:  #1A1D21;
 
-  /* 🔴滚动条（暗色）—— 见 charter 12
+  /* 🔴滚动条（暗色）
      ⚠️ 暗色下 thumb 要比浅色**更亮**（#4A515C）才看得见；
         用浅色那档会变成"黑里有黑"。 */
   --raw-scrollbar-thumb:     #6E747E;   /* 对 #14171a 3.82:1 · 对 #232830 3.15:1 ✅ */

package/03-patterns/nav/README.md

@@ -138,7 +138,7 @@ Toc.init({ links: '#toc-list .toc__link', sections: 'main h2[id]' });
 
 ---
 
-## 抽屉：五条判据（都来自 08 规范）
+## 抽屉：五条判据
 
 ### 1. 只动 `transform`，不动 `width/left/top`
 

package/03-patterns/pagination/pagination.css

@@ -67,7 +67,7 @@
   font-variant-numeric: tabular-nums;   /* 数字等宽，小数点才能对齐 */
   color: var(--text-primary);
   text-decoration: none;
-  /* 🔴 评审指出「不高级」。真因（实测）：
+  /* 🔴 普通态不能只是裸文字。真因（实测）：
      普通页 `background: transparent` + `border: transparent`
      ⇒ 整排只剩**裸文字**，没有"按钮"的实体感。
      通行做法（USWDS / GitHub / Stripe 一致）：
@@ -175,7 +175,7 @@
   .pagination__status { margin-inline-start: 0; width: 100%; }
 }
 
-/* 🔴 尊重 reduced-motion（见 charter 07） */
+/* 🔴 尊重 reduced-motion */
 @media (prefers-reduced-motion: reduce) {
   .pagination__link { transition: none; }
 }

package/03-patterns/reveal/README.md

@@ -66,12 +66,12 @@
 
 ## 为什么**没有**「动画进行中不打断」的守卫（实测结论）
 
-参考实现（huxx.me）有一条经验：进场动画在跑的时候不要被打断，
+有一种常见的加固做法：进场动画在跑的时候不要被打断，
 用 `getAnimations().some(a => a.playState === 'running')` 判断，
 说"快速滚动时这条决定了顺滑还是闪"。
 
-**那条针对的是它自己的 JS 动画**（Web Animations API 重启动画会跳）。
-我们用的是 CSS transition —— 被打断时是 **retarget**：从当前值继续插值，不重头再来。
+**那条针对的是 JS 驱动的动画**（Web Animations API 重启动画会跳）。
+CSS transition 被打断时是 **retarget**：从当前值继续插值，不重头再来。
 
 `05-audit/motion-concurrency.js` 在真浏览器里量过，结论：
 

package/04-recipes/analysis-report/demo.html

@@ -257,8 +257,8 @@
        同一材料的「区间带」和「曲线」必须写**同一个名字**：
        · 写了 ⇒ 它们共用一个色号，读者一看就知道这个带属于这条线
        · 不写 ⇒ 每条记录各吃一个色号 ⇒ 带是红的、线是绿的，看着像两种材料
-       （评审 VIZ-REPORT-01 · P0-2 抓的正是"不写 ⇒ 六条同色"，
-          而"每条一个色"是另一个反方向的错误 —— 两边都不能要。） */
+       （"不写 ⇒ 六条同色"是其中一种错法，
+          而"每条一个色"是反方向的另一种错法 —— 两边都不能要。） */
     series: [
       { type: 'band', data: band(BARE), name: '未包覆' },
       { type: 'band', data: band(AL2O), name: 'Al₂O₃ 包覆' },

package/04-recipes/longform/README.md

@@ -87,7 +87,7 @@ if (!('IntersectionObserver' in window)) { return; }  // 降级：不高亮，
 | 品味规范能不能被执行 | ✅ 能 |
 | token 层够不够 | ✅ 够，17KB 里样式只占很小一块 |
 | 六道门禁在真实页面上会不会误报 | ✅ 没有 |
-| 长文排版（行长/行高/层级）是否可复用 | ✅ 可，已进 charter |
+| 长文排版（行长/行高/层级）是否可复用 | ✅ 可，已进 `01-tokens/` 层 |
 
 **长文排版的可复用结论**：
 行长 68ch、正文行高 1.7、标题窄栏 —— 这三条对中文长文是硬约束，不是风格偏好。

package/04-recipes/longform/longform.html

@@ -249,11 +249,9 @@ body {
              color: var(--text-tertiary); font-style: normal; }
 
 /* 代码块：全文唯一允许重框的元素
-   🔴 第三轮修正。评审指出「代码块的里面表述一定要规范……
-   不允许再代码块写入时候的不规范，这个是有标准的规则的，
-   这种部分就不用自己去发挥」。
+   🔴 代码块里的排版必须照既有规范走，不要自己发明。
 
-   修正的三处（都是我自己发明的格式，不是规范）：
+   修正的三处（都不是规范写法）：
      ① <pre> 里有 2 个无意义前导空格 ⇒ Python 缩进变成 6 空格（应为 4）
      ② 注释里用中文破折号「——」⇒ 注释不是正文，不用破折号
      ③ shell 块里**命令和输出混在一起**，`AGC 0x0000  GO` 是输出，
@@ -282,8 +280,8 @@ p code, li code, td code {
 }
 
 /* 表格：只有数据表格才用框
-   🔴 第二轮修正。评审指出「这个字体一会儿左移一会儿又向右移
-      大家都贴在一起然后这个表头的标题也是很混乱的」。
+   🔴 列宽必须由表格结构决定，不能随内容漂移 ——
+      否则表头与正文的起点忽左忽右。
 
       两个根因：
         ① table-layout:auto ⇒ 列宽由**内容**决定，列边界必然随内容漂移
@@ -323,10 +321,8 @@ th {
 .num { font-variant-numeric: tabular-nums; white-space: nowrap; }
 
 /* 证据分级标记 —— 考古文章必须交代数字的来源等级
-   🔴 第二轮修正：我第一版把方框整个去掉，只留上标小字母。
-   评审指出：「C 的方框标识没有了，他们只会认为这是一个普通的上角标，
-   会对他感到迷惑」—— **方框是身份标识，不是装饰**。
-   去掉它，"证据等级 C"就变成了一个莫名其妙的角标。
+   🔴 方框不能去掉，**方框是身份标识，不是装饰**。
+   只留上标小字母时，"证据等级 C"会变成一个莫名其妙的角标。
 
    所以正确解法是**两个都要**：
      上标（上一轮要的：缩小 + 右上角 + 像平方符号）

package/04-recipes/report/demo.html

@@ -328,7 +328,7 @@
     ]
   });
 
-  /* 技术版：三组材料，带/线共用身份才不会看错（见 VIZ-REPORT-01 · P0-2） */
+  /* 技术版：三组材料，带/线共用身份才不会看错 */
   var HW = [0, 0.9, 1.3, 1.6, 1.9, 2.2, 2.4];
   function band(a) {
     var f = a === BARE ? 1.4 : a === AL2O ? 1.0 : 0.8;

package/04-recipes/table/demo.html

@@ -104,7 +104,7 @@
        signed-percent  同上，但正数加 + 、负数加 −（用于"同比/变化"）
      ====================================================================== */
 
-  /* 🔴🔴 动态文本一律**先转义**再拼进 HTML（外部评审 VIZ-REPORT-01 · P1-1）
+  /* 🔴🔴 动态文本一律**先转义**再拼进 HTML
      ----------------------------------------------------------------------
      这个页面是给人**照抄**的示例。用字符串拼表格本身没问题，
      问题在于把**数据里的文本**（公司名、列标签、单位）直接塞进 innerHTML：

package/04-recipes/table/table.css

@@ -80,7 +80,7 @@
 
 /* 🔴🔴 排序指示符：三态必须**同时**用形状 + 颜色表达（WCAG 1.4.1）
    --------------------------------------------------------------------
-   外部评审 VIZ-REPORT-01 · P1-1 实测到的缺陷：
+   实测到的缺陷：
      demo 把 `aria-sort` 放在**外围 <th>** 上（这是符合 ARIA 规范的写法），
      而这里的旧选择器要求它长在**按钮自己**身上 ⇒ 选择器永远匹配不上
      ⇒ 数据明明排好了，箭头一直是"↕"。

package/04-recipes/tierA-tokens.css

@@ -5,7 +5,7 @@
    **自动抽取**，请不要手改 —— 改源头，然后重新生成。
 
    🔴 它为什么存在：
-      charter 一直写着"精简档 只需复制 tokens.css 的 [核心] 段"，
+      "精简档只需复制 tokens.css 的 [核心] 段"，
       但**那个区块从来不存在**。复用的人照着做只会找不到。
       这个文件就是那个"核心"，真的、能复制、能用。
 

package/09-assets/README.md

@@ -8,7 +8,7 @@
 <!-- ==== ASSET-LIST-BEGIN ==== -->
 | 目录 | 它解决什么 |
 |---|---|
-| `09-assets/bar/` | 柱状图，含 charter 13 图表规范的裁剪铁律 |
+| `09-assets/bar/` | 柱状图，含图表规范的裁剪铁律 |
 | `09-assets/echarts-adapter/` | 把令牌喂给 ECharts，按需引入；本库不含 ECharts |
 | `09-assets/model-viewer/` | 惰性加载的 3D 模型查看器 |
 | `09-assets/scientific-plot/` | 二维科学绘图：坐标轴 / 误差棒 / 置信区间带 / 对数轴 |

package/09-assets/bar/README.md

@@ -1,6 +1,6 @@
 # bar · 柱状图
 
-**charter 13 图表规范**的四条铁律全部落地。ES5、零依赖、纯 SVG。
+**图表规范**的四条铁律全部落地。ES5、零依赖、纯 SVG。
 
 ## 🔴 四条铁律
 
@@ -60,8 +60,6 @@ const chart = Bar.draw({
 
 ## 🔴 堆叠 vs 分组：语义必须显式选择
 
-（外部评审 VIZ-REPORT-01 · P0-1 的教训）
-
 原实现的 `base` 数组在**每个系列开始时**被重置，且所有系列的柱用同一横坐标
 与同一柱宽 ⇒ 多系列不是堆叠，是**后画的盖住先画的**。它自称堆叠，实际重叠。
 

package/09-assets/bar/bar.css

@@ -1,5 +1,5 @@
 /* ============================================================================
-   bar.css — 柱状图样式（charter 13 图表规范）
+   bar.css — 柱状图样式（图表规范）
    ============================================================================
    ⭐ 铁律一的关键就写在下面这两行，**不能删**：
 
@@ -118,7 +118,7 @@
   font-variant-numeric: tabular-nums;
   /* ⭐ 描边画在字**下面**（不糊住笔画）——
      有了它，标注落在深色柱子上也看得清。
-     这是 charter 13 铁律二的三条硬性要求之一。 */
+     这是铁律二的三条硬性要求之一。 */
   paint-order: stroke fill;
   stroke: var(--surface, #fff);
   stroke-width: 3px;

package/09-assets/bar/bar.js

@@ -1,5 +1,5 @@
 /**
- * bar.js — 柱状图（charter 13 图表规范 · 四条铁律全部落地）
+ * bar.js — 柱状图（图表规范 · 四条铁律全部落地）
  * ============================================================================
  * 设计依据：见 API.md「资产类组件」一节
  *   铁律一 · 超量程必须被**容器裁剪**      → CSS 侧 overflow:hidden（本文件不参与）
@@ -7,7 +7,7 @@
  *   铁律三 · **量程必须显式声明**          → max 是必填参数，无默认值
  *   铁律四 · **门禁要能证伪**              → 05-audit/chart-check.js 已覆盖本组件
  *
- * ⭐ 为什么量程不自动适配（charter 13 铁律三）：
+ * ⭐ 为什么量程不自动适配（铁律三）：
  *   一个 400 的异常值 + 30 个 0.35 的常态值，若 Y 轴自适应到 400
  *   ⇒ 所有常态值被压成**一条贴底的直线**
  *   ⇒ 读者会得出「这些天完全没有变化」的**错误结论**。
@@ -77,7 +77,7 @@
    * @param {boolean}[opt.legend]   是否画图例（默认：系列数 ≥ 2 且都有名字时自动出）
    * @returns {Object} { el, clipped, mode, tops, legend, destroy() }
    *
-   * 🔴🔴 **堆叠 vs 分组，语义必须显式选择**（外部评审 VIZ-REPORT-01 · P0-1）
+   * 🔴🔴 **堆叠 vs 分组，语义必须显式选择**
    * --------------------------------------------------------------------
    *   修复前的实现声称"堆叠"，实际把 `base` 数组**在每个系列开头清零**，
    *   ⇒ 两个系列都从同一基线起算、**同横坐标同柱宽** ⇒ 后画的系列
@@ -98,7 +98,7 @@
     if (opt.max === undefined || opt.max === null) {
       /* 🔴 铁律三：不替调用方决定量程。
          宁可报错，也不要悄悄自适应（那会让 400 的异常值把常态值压成直线）。 */
-      throw new Error('bar.draw: max 是必填项（charter 13 铁律三：量程不得自动适配）');
+      throw new Error('bar.draw: max 是必填项（铁律三：量程不得自动适配）');
     }
 
     var series = opt.series || [];
@@ -244,7 +244,7 @@
       var h2 = Math.min((v2 / max) * plotH, plotH);
       var yy2 = padT + plotH - h2;
       var lb = el('text', {
-        /* 🔴 charter 13 铁律二：标注画在柱顶**外侧**（yy - 5），
+        /* 🔴 铁律二：标注画在柱顶**外侧**（yy - 5），
            不画在柱子上；且顶外侧不够高时改画内侧底部（见下方 clamp）。
            描边用 paint-order（在字下面），保证深色柱子上也看得清。 */
         'class': 'bar__label bar__label--' + keys[k],
@@ -265,7 +265,7 @@
      * 🔴 为什么默认就出（不再由调用方记得开）：
      *    两种颜色 + 没有图例 ⇒ 读者只能猜哪块是哪个系列；
      *    在黑白打印 / 色觉障碍下这块就直接失读了。
-     *    这与 charter 13「重要结论不允许只存在于颜色里」是同一条。
+     *    这与「重要结论不允许只存在于颜色里」是同一条。
      * ⇒ 要关就显式传 `legend: false`，别指望"忘了传也没事"。 */
     var hasNames = series.every(function (se) { return !!se.name; });
     var wantLegend = opt.legend === undefined ? (nS >= 2 && hasNames) : !!opt.legend;

package/09-assets/bar/demo.html

@@ -25,7 +25,7 @@
 <h1>bar · 柱状图</h1>
 
 <p class="note">
-  按 <strong>charter 13 图表规范</strong>四条铁律实现。
+  按 <strong>图表规范</strong>四条铁律实现。
   <br>① 超量程被容器裁剪（<code>.bar</code> + <code>.bar__svg</code> 两道
      <code>overflow:hidden</code>，缺一不可）
   <br>② 标注只标关键点（<strong>永远 ≤ 4 个</strong>）且画在柱顶外侧
@@ -73,7 +73,7 @@
 
 <h2>4 · 🔴 量程必填：不给 max 会直接报错</h2>
 <p class="note">
-  charter 13 铁律三：<b>量程不得自动适配</b>。
+  铁律三：<b>量程不得自动适配</b>。
   <br>一个 400 的异常值 + 30 个 0.35 的常态值，若 Y 轴自适应到 400
   ⇒ 所有常态值被压成<b>一条贴底的直线</b>
   ⇒ 读者会得出「这些天完全没有变化」的<b>错误结论</b>。

package/09-assets/echarts-adapter/echarts-adapter.js

@@ -14,7 +14,7 @@
  *
  *   ⇒ 本文件是**图表规范的机器可读版本**：
  *     - 主题：换主题时图表跟着变（不用手改 ECharts 配置）
- *     - 规范：把 charter 10 里的规则**变成默认值**（不用每次重想）
+ *     - 规范：把图表规则**变成默认值**（不用每次重想）
  *
  * ============================================================================
  * 为什么这个维护成本≈0
@@ -38,7 +38,7 @@
  *   </script>
  *
  *   ⚠️ 精简档（某项目）**不要引 ECharts**（约 1MB gzip）——
- *      那边继续用 09-assets/sparkline。见 charter 10。
+ *      那边继续用 `09-assets/sparkline`。
  */
 (function () {
   'use strict';
@@ -79,7 +79,7 @@
   /**
    * 取 n 个系列的颜色。
    * 🔴 **不让调色板自己循环** —— 超过可用色数就返回 null，
-   *    调用方应当**改图表类型**（charter 10 的规则：系列 ≤ 5）。
+   *    调用方应当**改图表类型**（规则：系列 ≤ 5）。
    *
    * 为什么不循环：第 6 个颜色和第 1 个同色，用户分不清谁是谁。
    * 「颜色不够用」是**该换图表**的信号，不是该加颜色的理由。
@@ -119,7 +119,7 @@
         borderColor: p.border,
         borderWidth: 1,
         textStyle: { color: p.text, fontSize: 12 },
-        // 🔴 数字统一等宽 + 千分位（charter 10 的数字格式规则）
+        // 🔴 数字统一等宽 + 千分位（数字格式规则）
         extraCssText: isDark
           ? 'box-shadow:0 2px 8px rgba(0,0,0,.5);'
           : 'box-shadow:0 2px 8px rgba(0,0,0,.1);',
@@ -137,7 +137,7 @@
       axisTick: { show: false },
       axisLabel: { color: p.textSub, fontSize: 11 },
       splitLine: { lineStyle: { color: p.border, type: 'dashed' } },
-      // 🔴 分类轴从 0 开始（柱状图的诚实性要求，见 charter 10）
+      // 🔴 分类轴从 0 开始（柱状图的诚实性要求）
       splitNumber: 4,
     };
   }
@@ -145,7 +145,7 @@
   /* ---------- 4. 合规的默认配置 ---------- */
 
   /**
-   * 一组**符合 charter 10 规范**的默认 option。
+   * 一组**符合图表规范**的默认 option。
    * 覆盖 ECharts 的默认值 —— 让你不写就合规。
    */
   function defaults(option) {
@@ -191,11 +191,11 @@
       if (y && y.min === undefined) y.min = 0;
     }
 
-    // 🔴 超过 5 个系列 ⇒ 明确警告（charter 10：系列 ≤ 5）
+    // 🔴 超过 5 个系列 ⇒ 明确警告（系列 ≤ 5）
     if (o.series.length > 5) {
       if (typeof console !== 'undefined' && console.warn) {
         console.warn('[frontend-lib] 系列数 ' + o.series.length +
-          ' 超过 5 —— 请改图表类型或分屏，见 charter 10。配色循环会让颜色撞车。');
+          ' 超过 5 —— 请改图表类型或分屏。配色循环会让颜色撞车。');
       }
     }
 

package/09-assets/model-viewer/model-viewer.css

@@ -118,12 +118,12 @@
   font-variant-numeric: tabular-nums;
 }
 
-/* 🔴 尊重 reduced-motion：不用动画掩盖（见 charter 07） */
+/* 🔴 尊重 reduced-motion：不用动画掩盖 */
 @media (prefers-reduced-motion: reduce) {
   .mv__btn { transition: none; }
 }
 
-/* 🔴 打印时不该出现 3D（见 charter 09） */
+/* 🔴 打印时不该出现 3D */
 @media print {
   .mv__btn, .mv__hint { display: none; }
 }

package/09-assets/scientific-plot/scientific-plot.js

@@ -326,7 +326,7 @@
     var dparts = [];            /* 数据层单独收集 ⇒ 统一挂裁剪。见下方 clipId */
     var tally = { n: 0 };       /* 画不出来的点数（对数轴非正 / 非有限值） */
 
-    /* 🔴🔴 系列样式身份（外部评审 VIZ-REPORT-01 · P0-2）
+    /* 🔴🔴 系列样式身份
        ------------------------------------------------------------------
        修复前每个系列都拿 `'splot__s' + (colorIdx % 5)`，而 `colorIdx` 从头到尾
        是 0 ⇒ 六条 series 全是 s0，同色同线型，读者分不出哪条是哪条材料。