agentcss 0.11.16 → 0.13.1

package/docs/ACCESSIBILITY.md

@@ -5,7 +5,7 @@
 
 | 项目 | 值 |
 |---|---|
-| 声明适用版本 | agentcss `0.11.9` |
+| 声明适用版本 | agentcss `0.13.1` |
 | 声明日期 | 2026-10-29 |
 | 复核节奏 | 每次发版前重跑（`npm run gate` 内含全部证据） |
 | 范围 | 本库交付的 CSS / JS、全部 `demo.html`（组件页 + 图表页 + 组合页）、以及文档站生成的页面 |
@@ -67,7 +67,7 @@
 | 3.3.2 | 标签或说明 | ✅ | 必填项有可见标记 + `required` |
 | 3.3.7 | 冗余输入（2.2 A） | — | 由业务表单决定，库不承载 |
 | 3.3.8 | 可访问的认证（2.2 AA） | — | 库不含登录流程 |
-| 4.1.2 | 名称、角色、值 | ✅ | `a11y-ax.js`：**全部 38 个 demo 页**的可访问性树逐节点判，每个可交互控件有非空名称；朗读序列逐页存快照防回归 |
+| 4.1.2 | 名称、角色、值 | ✅ | `a11y-ax.js`：**全部 40 个 demo 页**的可访问性树逐节点判，每个可交互控件有非空名称；朗读序列逐页存快照防回归 |
 | 4.1.3 | 状态消息 | ◐ | toast / 表单错误用 `role="status"` / `alert`；**未**在真实读屏里验证播报时机 |
 
 **统计：✅ 27 条 · ◐ 7 条 · ✗ 0 条 · — 12 条。**
@@ -80,11 +80,11 @@
 
 | 手段 | 覆盖 | 最近结果 |
 |---|---|---|
-| `axe-core`（`a11y-scan.js`） | 38 页（35 组件 demo + 文档站） | **0 类违规**，991 条规则通过 |
+| `axe-core`（`a11y-scan.js`） | 39 页（37 组件 demo + 2 个非组件页） | **0 类违规**，991 条规则通过 |
 | 反向控制（注入 5 类典型违规） | 证明上一条不是"没查" | 5 类全部抓到 |
-| `a11y-ax.js` 可访问性树 | **全部 `demo.html`（现 38 个）**；清单与磁盘不一致即红 | 0 个无名控件；38 份朗读序列快照在 `10-review/a11y-tree/` |
+| `a11y-ax.js` 可访问性树 | **全部 `demo.html`（现 40 个）**；清单与磁盘不一致即红 | 0 个无名控件；40 份朗读序列快照在 `10-review/a11y-tree/` |
 | `contrast.py` / `dark-contrast.js` | 亮 / 暗两套，逐对实算 | 正文 ≥ 4.5:1 |
-| `zoom-reflow.js` | 38 页 × 3 条 AA 硬项 | 320px 不横滚 · 200% 不裁字 · 焦点不被遮挡 |
+| `zoom-reflow.js` | 40 页 × 3 条 AA 硬项 | 320px 不横滚 · 200% 不裁字 · 焦点不被遮挡 |
 | `focus-ring-check` / `focus-return-check` / `keyboard-nav` | 焦点可见、焦点归还、键盘路径 | 全绿 |
 
 ### 人工（**尚未执行** —— 这是本声明最大的空白）

package/docs/CONVENTIONS.md

@@ -5,7 +5,7 @@
 本文是它们的**唯一说明书** —— 规则写在这里，判据在仓库里，两边一一对应。
 
 读法：如果你只想知道「我该写哪个变量」，看第一节和第二节；
-如果你想改这套东西，看第十节，那里列了每条规则由什么挡住。
+如果你想改这套东西，看第十一节，那里列了每条规则由什么挡住。
 
 ## 一 · 令牌分三层，你只用中间层
 
@@ -172,7 +172,37 @@
 - 不要用更深的选择器去压（`.page .btn.btn--primary`）—— 那是把特异性当版本管理，
   下次改版必然打架。
 
-## 十 · 每条规则由什么挡住
+## 十 · 涨跌：语义在令牌层，口径是全局的
+
+红绿有两个完全不同的来处，**不许共用一个名字**：
+
+| 令牌 | 语义 | 例子 |
+|---|---|---|
+| `--danger` / `--success` | **评价**：错了 / 成了 | 审计失败、已停牌 |
+| `--dir-up` / `--dir-down` | **事实**：涨了 / 跌了 | 同比 +12.4% |
+
+「研发费用同比 +38%」是涨，但那是坏消息 —— 用 `--danger` 渲染它，
+颜色说"错了"、语义说"涨了"，读者收到矛盾信号。
+
+三条规则：
+
+- **组件只写 `color: var(--dir-up)`**，不许出现 `[data-market]` 分支。
+  口径切换改的是**令牌指向**，跟暗色同构（换底层值，语义名不动）。
+- **口径是全局约定**：`data-market="intl"` 加在任意祖先上，整块对调。
+  交换规则在选配文件 `01-tokens/market.css`，**不在 `tokens.css`** ——
+  条件规则进核心令牌会让六个靠词法读 CSS 的工具静默读错。
+- **方向必须有非颜色的载体**：`delta` 用 `+` / `−`（U+2212）符号，
+  且符号必须真的进可访问性树（CSS `::before` 生成的字符不在元素 name 里，
+  但会作为独立 StaticText 出现 —— 换空串/背景图/`visibility:hidden` 就会没）。
+- **容器不许再加一套方向类**。表格里只有会计正负（`num--pos` / `num--neg`），
+  市场涨跌一律嵌 `<span class="delta delta--up">`
+  —— 否则 `table` 会有四组颜色类，调用方每列都要记"这列用哪组"。
+  表格只管对齐（`td.num`），不管判色。
+- **零值不带符号**：符号必须跟**打印出来的数字**同号。
+  `0` 与「四舍五入到 0」（如精度 1 下的 `0.0004`）都不加 `+` / `−`
+  —— 「+0.0%」等于把持平念成上涨。会计列与市场列是同一条规则。
+
+## 十一 · 每条规则由什么挡住
 
 规则只有落到判据上才会被遵守。对应关系如下（文件都在 `05-audit/`）：
 
@@ -189,6 +219,10 @@
 | `@layer` 计数与 `!important` 分类 | `cascade-layer-gate.py` |
 | 触控目标 44px | `a11y.py`（静态） + 行为脚本（运行时） |
 | 页面骨架只有一份（改令牌能牵动全部页面） | `skeleton-lever-check.js` |
+| 涨跌方向色对、口径可切、符号进可访问性树 | `delta-check.js` |
+| 表格里的方向语义（涨跌嵌 `delta`、零值不带符号、口径只翻市场列） | `table-check.js` ⑫⑬⑭ |
+| 指标缺数是显式状态、数字等宽对齐 | `metric-check.js` |
+| 文档里的数字与实际一致（组件数/门禁数/精简档令牌数） | `doc-facts-gate.py` |
 
 想加一条新规则？先在门禁里加判据、确认它会红，再写进本文 ——
 **顺序反了就会得到一条"写在文档里、没人执行"的规则。**

package/index.html

@@ -26,7 +26,7 @@ li a:active { background: var(--surface-sunken); }
 <main id="main" class="wrap">
   <h1>agentcss · 演示</h1>
   <p class="lede">
-    35 个组件，每一页都能直接打开看。
+    37 个组件，每一页都能直接打开看。
     <strong>手机上也一样</strong> —— 布局、触控尺寸、暗色都是按移动端调的。
   </p>
 
@@ -39,7 +39,9 @@ li a:active { background: var(--surface-sunken); }
 <li><a href="02-primitives/choice/demo.html">checkbox / radio / select</a><span class="r__p">单选/多选/原生 select 外观的统一控件</span></li>
 <li><a href="02-primitives/combobox/demo.html">combobox · 组合框 / 标签输入</a><span class="r__p">可搜索 + 可多选标签的输入控件</span></li>
 <li><a href="02-primitives/date-range/demo.html">date-range · 日期区间</a><span class="r__p">日期区间选择，含预设快捷范围</span></li>
+<li><a href="02-primitives/delta/demo.html">delta · 变化量</a><span class="r__p">变化量：涨跌方向 + 符号 + 颜色。只描述往哪边变，不判断好坏（等于好恶是 badge 的事，会计正负是 ta</span></li>
 <li><a href="02-primitives/input/demo.html">input / field</a><span class="r__p">文本输入及其标签/帮助/错误三件套</span></li>
+<li><a href="02-primitives/metric/demo.html">metric · 指标块</a><span class="r__p">指标块：一个标签 + 一个值 + 一句上下文。数字等宽、单位分离、缺数是一等状态</span></li>
 <li><a href="02-primitives/popover/demo.html">popover · 气泡卡片</a><span class="r__p">锚定到触发元素的浮层</span></li>
 <li><a href="02-primitives/progress/demo.html">progress · 进度条</a><span class="r__p">进度条与进度环</span></li>
 <li><a href="02-primitives/select/demo.html">select · 自建下拉选择</a><span class="r__p">自定义下拉选择（非原生）</span></li>
@@ -92,7 +94,7 @@ li a:active { background: var(--surface-sunken); }
   </p>
 </main>
 <footer class="wrap">
-  <p class="note">0.11.16 · 零第三方运行时依赖</p>
+  <p class="note">0.13.1 · 零第三方运行时依赖</p>
 </footer>
 </body>
 </html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentcss",
-  "version": "0.11.16",
+  "version": "0.13.1",
   "description": "移动 Web 组件库：CSS + 可选行为脚本，零第三方运行时依赖。样式用 bundler 引入，交互行为用 script 标签引入。",
   "keywords": [
     "css",