@manohub/ui 1.0.4 → 1.0.5

package/dist/styles/components/steps.css

@@ -1,20 +1,17 @@
 /**
  * Steps —— 步骤条（横向节点式 + 条形燕尾段式 + 进度条）。
  *
- * 出处：`@aihub/theme` 的 `playground/components/steps.css` 与 `src/components/steps.css`
- * （节点 30 圆、字号 14、节点与标题**同行**、标题间距 12；连线是 2px **点线** + 末端 6px 方盒转 45°
- *  的 `>` 折角箭头、最小长 58.383、弹性撑开；段 140×30、相邻**重叠 10**、整条 inline-flex 收宽；
- *  进度条高 9）。
+ * 出处：规范（节点 30 圆、字号 14、节点与标题**同行**、标题间距 12；连线是 2px **点线** + 末端 6px 方盒
+ * 转 45° 的 `>` 折角箭头、最小长 58.383、弹性撑开；段 140×30、相邻**重叠 10**、整条 inline-flex 收宽；
+ * 进度条高 9）。
+ * ⚠️ **当前步之后那一段才转蓝**（已完成步之后仍是灰线）—— 规范实测的取向，别做成"已完成段全蓝"。
  *
- * **当前步之后那一段才转蓝**（已完成步之后仍是灰线）—— 这是规范实测的取向，别做成"已完成段全蓝"。
+ * 状态来源是**单一来源**（组件下发的 `--done` / `--current` / `--active`）：步骤序号不是原生元素能表达的
+ * 状态，故这里没有「三源等价」可言 —— 与勾选 / 开关那类不同，别照抄那份写法。
  *
- * 状态来源是**单一来源**（组件下发的 `--done` / `--current` / `--active`）：步骤序号不是原生元素能表达的状态，
- * 故这里没有「三源等价」可言 —— 与勾选/开关那类不同，别照抄那份写法。
- *
- * 连线用**独立空元素**（`.mh-steps__connector`）而不是 `.mh-steps__step + ::after`：折角箭头要撑开弹性余量，
- * 且 N 个节点配 N-1 条线，独立元素才能让两端节点各自保持自己的标题宽度。
- *
- * 可点档（`clickable`）下步元素是**原生 `<button>`** —— 归零、焦点环、禁用态见文件中间那节。
+ * 连线用**独立空元素**（`.mh-steps__connector`）而不是 `+ ::after`：折角箭头要撑开弹性余量，且 N 个节点
+ * 配 N-1 条线，独立元素才能让两端节点各自保持自己的标题宽度。
+ * 可点档（`clickable`）下步元素是**原生 `<button>`** —— 归零 / 焦点环 / 禁用态见文件中间那节。
  */
 
 /* 几何只挂在 node 档根件上：令牌在同名 `.tokens.css`（锚 `[data-manohub-ui]`），几何若跟着挂会给 bar / 进度条多套一层 flex */

package/dist/styles/components/steps.tokens.css

@@ -1,17 +1,9 @@
 /**
- * steps —— 单件令牌（**基础值**）。
+ * steps —— 单件令牌（**基础值**；只服务本件，故不随主题进 `@manohub/theme`）。
  *
- * 本件自己的几何 / 尺寸 / 色彩槽位；只服务本件，故不随主题进 `@manohub/theme`。
- *
- * ## 抽出说明
- * 本文件从面文件里抽出（原先混写在 `steps.css` 顶部）：这些是**基础值**，锚在
- * `[data-manohub-ui]` —— 跨包唯一作用域锚，由入口层无条件写在应用容器上，因此**任何落在
- * 容器里的分件都取得到值**，不再依赖「声明在某个组件根类上」这条脆弱假设
- * （历史症状：跨件消费的 `--ui-*-group-*` 取不到值，组内间距变 0）。
- *
- * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里 —— 它们靠「同一元素上两个
- * 选择器改写同一个令牌」生效，搬到本文件会让档位失效。
- * ⚠️ 新增组件要登记两处：本文件 + `src/styles/index.css`（见其文件头「五处齐备」）。
+ * 令牌锚 `[data-manohub-ui]`（容器是每个分件的祖先 ⇒ 落在容器里的分件都取得到值）。
+ * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里（搬走会让档位失效）；
+ * 新增组件要登记两处：本文件 + `src/styles/index.css`（见其文件头「五处齐备」）。
  */
 [data-manohub-ui] {
   /* bar 档与独立进度条都是**自己的根节点**（无 `.mh-steps` 祖先）—— 靠容器锚取到值 */

package/dist/styles/components/switch.css

@@ -1,15 +1,12 @@
 /**
  * Switch —— 开关（两档尺寸：表格档 36×18 / 表单档 50×24）。
  *
- * 出处：`@aihub/theme` 的 `playground/components/switch.css` 与 `src/components/switch.css`
- * （轨道 36×18、滑块 14、内距 2；表单档 50×24、滑块 18、内距 3；未选中底 Ne04、选中主色；
- *  文字与轨道间距 10；禁用整体降透明 0.5）。
- *
- * **结构固定**：`input` →（可选）`__label` → `__track > __knob` —— 轨道用**通用兄弟** `~` 命中，
- * 因为文字可以夹在开关与轨道之间（规范的结构如此），用相邻兄弟 `+` 会漏。
- *
- * 状态三源等价：原生 `input:checked`（零 JS）/ 组件下发 `[data-state='checked']` / 静态档 `.is-checked`。
+ * 出处：规范（轨道 36×18、滑块 14、内距 2；表单档 50×24、滑块 18、内距 3；未选中底 Ne04、选中主色；
+ * 文字与轨道间距 10；禁用整体降透明 0.5）。
  *
+ * **结构固定**：`input` →（可选）`__label` → `__track > __knob` —— 轨道用**通用兄弟** `~` 命中
+ * （文字可以夹在开关与轨道之间，用相邻兄弟 `+` 会漏）。
+ * 状态三源等价：原生 `input:checked`（零 JS）/ `[data-state='checked']` / 静态档 `.is-checked`。
  * **焦点环画在可见轨道上**（隐身开关没有可见焦点），外扩 2px —— 轨道自身无边框，内缩会吃掉滑块。
  */
 .mh-switch {

package/dist/styles/components/switch.tokens.css

@@ -3,16 +3,11 @@
  *
  * 本件自己的几何 / 尺寸 / 色彩槽位；只服务本件，故不随主题进 `@manohub/theme`。
  *
- * ## 抽出说明
- * 本文件从面文件里抽出（原先混写在 `switch.css` 顶部）：这些是**基础值**，锚在
- * `[data-manohub-ui]` —— 跨包唯一作用域锚，由入口层无条件写在应用容器上，因此**任何落在
- * 容器里的分件都取得到值**，不再依赖「声明在某个组件根类上」这条脆弱假设
- * （历史症状：跨件消费的 `--ui-*-group-*` 取不到值，组内间距变 0）。
  *
- * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里 —— 它们靠「同一元素上两个
- * 选择器改写同一个令牌」生效，搬到本文件会让档位失效。
- * ⚠️ 新增组件要登记两处：本文件 + `src/styles/index.css`（见其文件头「五处齐备」）。
- */
+ * 令牌锚 `[data-manohub-ui]`（容器是每个分件的祖先 ⇒ 落在容器里的分件都取得到值）。
+ * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里（搬走会让档位失效）；
+ * 新增组件要登记两处：本文件 + `src/styles/index.css`（见其文件头「五处齐备」）。
+*/
 [data-manohub-ui] {
   /* 单件令牌 */
   --ui-switch-track-w: 36px; /* 规范表格档 */

package/dist/styles/components/tabbar.css

@@ -1,21 +1,20 @@
 /**
  * TabBar —— 页签条（下划线指示条 + 禁用 + 「更多」页签）。
  *
- * 出处：`@aihub/theme` 的 `playground/components/tabbar.css` 与 `src/components/tabbar.css`
- * （区高 26 / 项间距 30 / 字号 14 / 指示条高 3、距文字 3、两端与文字同宽 / 未选字 `#446a9f` /
- *  滑过 `#529dff` / 选中 `#4e94ff` / 禁用 Te07）。
+ * 出处：规范（区高 26 / 项间距 30 / 字号 14 / 指示条高 3、距文字 3、两端与文字同宽 / 未选字 `#446a9f` /
+ * 滑过 `#529dff` / 选中 `#4e94ff` / 禁用 Te07）。
  *
  * 三条必须照做的几何（做错一眼就歪）：
- *
- * 1. **不画轨线**：规范明确警告 —— 页签区没有底边框，选中只由指示条表达；加轨线会扣走区高 1px。
- *    「像不像页签」全靠那道 3px 指示条，不靠一条横线。
- * 2. **指示条是每个项自己的伪元素**（`::after`），不是一条共享滑块：所有项的指示条常驻，未选 `opacity:0; scale:.75`，
- *    选中转 `opacity:1; scale:1` —— "滑过去"的观感来自这两个属性的过渡（`display` 直切补间不了）。
+ * 1. **不画轨线**：页签区没有底边框，选中只由指示条表达（加轨线还会扣走区高 1px）—— 「像不像页签」
+ *    全靠那道 3px 指示条，不靠一条横线。
+ * 2. **指示条是每项自己的伪元素**（`::after`），不是共享滑块：所有项的指示条常驻，未选
+ *    `opacity:0; scale:.75`、选中转 `opacity:1; scale:1` —— "滑过去"的观感来自这两个属性的过渡
+ *    （`display` 直切补间不了）。
  * 3. **文字贴底**：项高 26 = 文字框 20 + 留白 3 + 指示条 3，故 `align-items:flex-end` +
- *    `padding-bottom = indicator-gap + indicator-height`。少了这段内距，指示条会压在字上。
+ *    `padding-bottom = indicator-gap + indicator-height`（少了这段内距，指示条会压在字上）。
  *
- * **三源等价**（本仓通例）：原生 `:checked +` / 组件下发 `[data-state='active']` / 静态档 `.is-selected`
- * 指向同一份声明 —— 原生态给零 JS 用法（原生 radio 互斥 + ← → 换页签），组件态给受控值。
+ * **三源等价**（本仓通例）：原生 `:checked +` / `[data-state='active']` / 静态档 `.is-selected` ——
+ * 原生态给零 JS 用法，组件态给受控值。
  */
 .mh-tabbar {
   display: flex;

package/dist/styles/components/tabbar.tokens.css

@@ -3,16 +3,11 @@
  *
  * 本件自己的几何 / 尺寸 / 色彩槽位；只服务本件，故不随主题进 `@manohub/theme`。
  *
- * ## 抽出说明
- * 本文件从面文件里抽出（原先混写在 `tabbar.css` 顶部）：这些是**基础值**，锚在
- * `[data-manohub-ui]` —— 跨包唯一作用域锚，由入口层无条件写在应用容器上，因此**任何落在
- * 容器里的分件都取得到值**，不再依赖「声明在某个组件根类上」这条脆弱假设
- * （历史症状：跨件消费的 `--ui-*-group-*` 取不到值，组内间距变 0）。
  *
- * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里 —— 它们靠「同一元素上两个
- * 选择器改写同一个令牌」生效，搬到本文件会让档位失效。
- * ⚠️ 新增组件要登记两处：本文件 + `src/styles/index.css`（见其文件头「五处齐备」）。
- */
+ * 令牌锚 `[data-manohub-ui]`（容器是每个分件的祖先 ⇒ 落在容器里的分件都取得到值）。
+ * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里（搬走会让档位失效）；
+ * 新增组件要登记两处：本文件 + `src/styles/index.css`（见其文件头「五处齐备」）。
+*/
 [data-manohub-ui] {
   /* 单件令牌 */
   --ui-tabbar-height: var(--ui-control-height-md); /* 标准控件高 32 */

package/dist/styles/components/table.css

@@ -1,48 +1,34 @@
 /**
  * Table —— 表格（表头/行/单元格类型 + 行态四档 + 固定表头与列 + 批量栏与合计行）。
  *
- * 出处（**两套来源在关键几何上一致**，故此处没有取舍余地）：
- * - `@aihub/theme` 的 `src/components/table.css`：表头 **34** / 行 **30** / 字号 13 / 勾选列 40 /
- *   省略号 150 / 拖拽线 3×40 / 合计行 40；
- * - 设计稿《MH后台-0911》：表头 **34**（`0:3962` 1160×34）/ 行 **30**（`0:3956`–`0:3961` 919×30，
- *   节距 31 = 30 + 1px 线）/ 表头底 `#f1f2f5`（= `--ui-base-200`）/ 行线 `#e6e6e6`
- *   （每行 `DROP_SHADOW(0,1,b0,#e6e6e6)`）/ 外框 `#e6e6e6 @1` / 选中行底 `#dbe9ff`
- *   （= `--ui-primary-subtle`）。
- *
- * ⚠️ 改前这里写的是 44 / 46 —— 与上面两套来源**都不符**，是历史遗留值（文件头注释一直写着 34/30，
- * 是代码没跟上），本轮已归位。
- *
- * **单元格左右内距保持 16（`--ui-space-4`）**：设计稿里可量的只有「勾选框距表左 20」这一处，
- * 而它量的是**内容盒**、不是单元格盒（勾选列 40 宽 + 居中时内容盒落在 13 处），无法唯一反推内距，
- * 故不作推测性改动。勾选列宽 `40` 也不动，理由同此。
+ * 出处（两套来源在关键几何上一致，故没有取舍余地）：设计稿《MH后台-0911》表头 **34**
+ * （`0:3962`）/ 行 **30**（`0:3956`–`0:3961`，节距 31 = 30 + 1px 线）/ 表头底 `#f1f2f5`
+ * （= `--ui-base-200`）/ 行线 `#e6e6e6` / 外框 `#e6e6e6 @1` / 选中行底 `#dbe9ff`
+ * （= `--ui-primary-subtle`）；规范侧同值（勾选列 40 / 拖拽线 3×40 / 合计行 40）。
  *
  * 行态：表头底 `--ui-base-200` + 字 `--ui-base-content-muted` + 中粗 / 外框 1px `--ui-base-300` /
  * 斑马与禁用 `--ui-base-200` / 滑过 `--ui-primary-weak` / 选中 `--ui-primary-subtle`（**只底色**）。
  *
+ * ⚠️ **单元格左右内距保持 16（`--ui-space-4`）**：设计稿可量的只有「勾选框距表左 20」，而它量的是
+ * **内容盒**（勾选列 40 宽 + 居中时内容盒落在 13 处），无法唯一反推内距，故不作推测性改动。
+ *
  * 四条必须照做的**结构**决定（做错就与规范不是一回事）：
  *
- * 1. **边框模型**：默认是**外框**（画在 `.mh-table` 上）+ 表头下分割线 + 每行底线（末行去线），
- *    故 `border-collapse: separate` + `border-spacing: 0` —— 圆角只有在 separate 下才渲染得出来；
- *    `--borderless` 才切回 `collapse` 并去掉外框。
+ * 1. **边框模型**：默认是外框 + 表头下分割线 + 每行底线（末行去线）⇒ `border-collapse: separate`
+ *    + `border-spacing: 0`（圆角只在 separate 下渲染得出来）；`--borderless` 才切回 `collapse` 并去外框。
  *    **三条线之外的边一律显式清零**（`border: 0` 写在 `th` / `td` / `tr` 上，不是冗余）：特异性只在
- *    **同一个属性**上分胜负，宿主给单元格或行下的整圈边框（典型是 markdown 正文的
- *    `.vp-doc th, .vp-doc td { border: 1px solid }`、`.vp-doc tr { border-top: ... }`）不会被本件
- *    "没写的边"顶掉，结果就是与表外框叠成 2px、行交界处叠成 2px、还多出列分隔线。
- * 2. **斑马纹是显式类**（`.is-striped`）而非 `:nth-child(even)`：表里可以插分组行，`nth-child` 会整表错位
- *    —— 这是规范里唯一允许"用类代替结构选择器"的豁免。
- * 3. **行选中由行内的选择控件驱动**（`tr:has(.mh-table__col-check input:checked)`）：这样零 JS 也能选中；
- *    组件态给 `[data-state='selected']`，静态档给 `.is-selected` —— 三源等价。
- *    勾选列复用 `Checkbox` **组件**（不在表格里手写原生 input）：该件内部才是真实 `<input type="checkbox">`，
- *    故 `:has(...)` 这条路径照旧成立；`Checkbox` 的框体带 `data-state`（checked / indeterminate），
- *    半选与选中都走它自己的样式数据，表格这边不再画方块。
- *    **选择器必须限定在勾选列内**（`.mh-table__col-check`，勾选列单元格自带的类）：不限列时，
- *    功能列里任何「内部本来就是 checkbox」的件都会命中 —— `Switch` 的内部正是 `<input type="checkbox">`，
- *    于是「启用」这类**功能值**会把整行点亮。功能值与行选择语义不同，视觉必须分开（否则一张表里
- *    开关一开就整行变色，且用户无从判断那到底表示什么）。
+ *    **同一属性**上分胜负，宿主给单元格/行下的整圈边框（典型 markdown 正文的 `.vp-doc th { border }`）
+ *    不会被「没写的边」顶掉，否则与表外框、行交界处各叠成 2px，还凭空多出列分隔线。
+ * 2. **斑马纹是显式类**（`.is-striped`）而非 `:nth-child(even)`：表里可以插分组行，`nth-child` 会整表错位。
+ * 3. **行选中由行内的选择控件驱动**（`tr:has(.mh-table__col-check input:checked)`）：零 JS 也能选中；
+ *    组件态给 `[data-state='selected']`、静态档给 `.is-selected` —— 三源等价。勾选列复用 `Checkbox`
+ *    **组件**（它内部才是真实 `<input type="checkbox">`，故 `:has()` 成立；框体与半选状态归它自己的样式）。
+ *    ⚠️ **选择器必须限定在勾选列内**：不限列时功能列里任何「内部本来就是 checkbox」的件都会命中
+ *    —— `Switch` 内部正是 `<input type="checkbox">`，于是「启用」这类**功能值**会把整行点亮。
  * 4. **固定列必须自带底**（`background: var(--ui-base-100)`）：它是 sticky 的，不遮挡就会被滚过的单元格透出。
  *
- * **不做**：排序与列宽拖拽的**算法**（规范只给了 `↕` 字形与 3×40 拖拽线这两处视觉），也不做空态/加载态
- * （规范表格里没有这两个样张 —— 三态归 `QueryState`）。
+ * **不做**：排序与列宽拖拽的**算法**（规范只给 `↕` 字形与 3×40 拖拽线两处视觉），也不做空态/加载态
+ * （三态归 `QueryState`）。
  */
 .mh-table-wrapper {
   overflow: auto;
@@ -90,29 +76,24 @@
 }
 
 /* ===== 固定布局档（`layout="fixed"`）=====
- * 列宽由 `<colgroup>` 下发（与档位无关），本档只把布局算法换成 `fixed`：
- * 列宽从此**受声明约束、不再被内容撑破** ⇒ 长文本不会把表格撑得比容器还宽，
- * 于是「百分比 / 数字权重」可以「吃满容器 + 严格按比例」。
- *
- * 调用方要知道的：表体**默认不换行**（nowrap + 省略号，见下条）；要换行的列显式标 `wrap: true`。 */
+ * 列宽由 `<colgroup>` 下发，本档只把布局算法换成 `fixed`：列宽从此**受声明约束、不再被内容撑破**
+ * ⇒ 长文本不会把表格撑得比容器还宽，「百分比 / 数字权重」可以吃满容器 + 严格按比例。
+ * 调用方要知道的：表体**默认不换行**（见下条）；要换行的列显式标 `wrap: true`。 */
 .mh-table--fixed {
   table-layout: fixed;
 }
-/* `fixed` 档表体默认**不换行**（nowrap + 省略号）。两条依据：
- * ① 列宽已被 `<colgroup>` 钉死，换行救不回内容，只会把行高顶高（`td` 的 `height` 只是**下限**）；
- * ② 换行必然伴随**从字符间断字** —— 实测序号列窄到装不下两位数时，旧的 `overflow-wrap: anywhere`
- *    把 `10` 拆成 `1` / `0` 两行，行高 30 → **49**。
- * 于是「换行」改成**列级主动选择**：`TableColumn.wrap: true`（见 `.mh-table__cell-wrap`）。
- * ⚠️ **只在本档翻默认**：`auto` 档的列宽由内容计算，td 默认 nowrap 会让长文本列不再靠换行收敛、
- * 表格更容易撑破容器 —— 与本档「表头裁切只加在 fixed」同一条判据（见上一条注释）。 */
+/* `fixed` 档表体默认**不换行**。两条依据：① 列宽已被 `<colgroup>` 钉死，换行救不回内容、只会顶高行高
+ * （`td` 的 `height` 只是下限）；② 换行必然伴随**从字符间断字** —— 实测序号列窄到装不下两位数时，
+ * `overflow-wrap: anywhere` 把 `10` 拆成 `1` / `0` 两行，行高 30 → **49**。
+ * 于是「换行」改成**列级主动选择**（`TableColumn.wrap: true`，见 `.mh-table__cell-wrap`）。
+ * ⚠️ **只在本档翻默认**：`auto` 档的列宽由内容计算，td 默认 nowrap 会让长文本列不再靠换行收敛。 */
 .mh-table--fixed tbody td {
   overflow: hidden;
   text-overflow: ellipsis;
   white-space: nowrap;
 }
-/* 前导列（勾选 / 展开）在 auto 下靠内容把 40px 的「建议宽」撑出去；fixed 下是硬宽，
-   而 `thead th` / `tbody td` 的标准左右内距各 16px ⇒ 可用内容只有 40 − 32 = 8px，
-   装不下 16px 的勾选框（实测该列溢出 19px，还会被上面的 `overflow: hidden` 裁掉）。
+/* 前导列（勾选 / 展开）在 auto 下靠内容把 40px 的「建议宽」撑出去；fixed 下是硬宽，而标准左右内距
+   各 16px ⇒ 可用内容只有 40 − 32 = 8px，装不下 16px 的勾选框（实测该列溢出 19px、还会被裁掉）。
    故本档把前导列的内距清零，靠既有的 `text-align: center` 居中。 */
 .mh-table--fixed .mh-table__col-check,
 .mh-table--fixed .mh-table__col-expand {
@@ -120,11 +101,8 @@
 }
 
 /* ===== 表头 =====
- * `border: 0` **不是冗余**：本件只画「表外框 + 表头分割线 + 每行底线」三条，其余边必须显式清零。
- * 特异性和平局只发生在**同一个属性**上 —— 本件只声明 `border-bottom` 时，宿主给单元格下的整圈边框
- * （典型：markdown 正文的 `.vp-doc th, .vp-doc td { border: 1px solid }`）不会被任何组件声明顶掉，
- * 于是单元格四边各来一条：与表外框叠成 2px、每行交界处上一行底线 + 本行顶线叠成 2px，还凭空多出列分隔线。
- * 这三条不是「装饰」而是边框模型的一部分，故与 `border-bottom` 写在同一规则里（0-1-2 压过 `.vp-doc th` 0-1-1）。 */
+ * `border: 0` **不是冗余**：本件只画「表外框 + 表头分割线 + 每行底线」三条，其余边必须显式清零
+ * （理由见文件头第 1 条）。与 `border-bottom` 写在同一规则里：0-1-2 压过 `.vp-doc th` 的 0-1-1。 */
 .mh-table thead th {
   height: var(--ui-table-head-height);
   padding: 0 var(--ui-table-padding-x);
@@ -140,8 +118,7 @@
 .mh-table thead th.is-hover {
   background: var(--ui-table-head-bg-hover);
 }
-/* 固定档下表头也要裁切：列宽已被 colgroup 钉死，长表头文字会**溢出到相邻列**
-   （实测溢出 97px），必须靠这两条收住。`white-space: nowrap` 上面已有。
+/* 固定档下表头也要裁切：列宽已被 colgroup 钉死，长表头文字会**溢出到相邻列**（实测溢出 97px）。
    ⚠️ 只在本档加 —— auto 档下表头参与列宽计算，加裁切会改动老页面的列宽分配。 */
 .mh-table--fixed thead th {
   overflow: hidden;
@@ -159,8 +136,7 @@
 .mh-table tbody tr {
   border: 0;
 }
-/* 单元格的边框模型：**全清零 + 只留底线**（理由同表头处：宿主给 `th` / `td` 下的整圈边框只靠
- * 特异性挡不住未声明的三边，会让行线与表外框全部叠成双线）。 */
+/* 单元格的边框模型：**全清零 + 只留底线**（理由同表头处） */
 .mh-table tbody td {
   height: var(--ui-table-row-height);
   padding: var(--ui-space-1) var(--ui-table-padding-x);
@@ -180,9 +156,8 @@
 .mh-table tbody tr.is-hover td {
   background: var(--ui-table-row-hover);
 }
-/* 选中态**只有底色**：规范样张里那条 2px 主色下沿（Au01）已去掉 ——
-   行线只由单元格底边提供，选中行不再额外压一条线（`box-shadow: inset 0 -2px` 会盖住底边线，
-   看起来像"两行线叠在一起"）。要恢复下沿就加回 inset 阴影 + 对应令牌。
+/* 选中态**只有底色**：规范样张那条 2px 主色下沿（Au01）不取 —— 行线只由单元格底边提供，
+   额外压一条 `box-shadow: inset 0 -2px` 会盖住底边线，看起来像「两行线叠在一起」。
    第三条路径限定在勾选列内（见文件头第 3 条）：不限列会被功能列的 Switch 命中。 */
 .mh-table tbody tr.is-selected td,
 .mh-table tbody tr[data-state='selected'] td,
@@ -209,7 +184,7 @@
 }
 .mh-table__tree-caret {
   display: inline-flex;
-  width: var(--ui-font-icon); /* 常规图标档（改前无声明、掉到 `<svg>` 默认 16） */
+  width: var(--ui-font-icon); /* 常规图标档 */
   height: var(--ui-font-icon);
   margin-right: var(--ui-space-1);
   color: var(--ui-base-content-subtle);
@@ -220,8 +195,7 @@
 }
 
 /* ===== 列 ===== */
-/* 勾选列：只负责「多宽 + 居中」——`Checkbox` 组件是 inline-flex，靠格子的 text-align 居中；
-   方块尺寸 / 圆角 / 三态配色全归 `checkbox.css`（表格不再给这一列任何选中态样式） */
+/* 勾选列：只负责「多宽 + 居中」——尺寸 / 圆角 / 三态配色全归 `checkbox.css` */
 .mh-table__col-check {
   width: var(--ui-table-col-check);
   text-align: center;
@@ -230,12 +204,10 @@
   text-align: right;
 }
 
-/* ⚠️ **表头要把对齐重声明一遍**：上面这几条与 `.mh-table__cell-center` / `.mh-table__cell-amount`
- * 都只有 **0-1-0**，而 `.mh-table thead th { text-align: left }` 是 **0-1-1** ⇒ 表头被强拉成左对齐、
- * 与表体不齐：勾选框应居中却贴左（实测表头左留白 0 / 右留白 26，与表体错位 13px）、
- * 右对齐列的标题应靠右却被拉到左边。
- * 只用补 `text-align` —— `thead th` 没声明过其它会被这些类覆盖的属性（宽度/内距不冲突）。
- * 写法沿用 `th.mh-table__th-group`（组头居中）那条既有先例。 */
+/* ⚠️ **表头要把对齐重声明一遍**：下面几条与 `.mh-table__cell-center` / `--cell-amount` 都只有
+ * **0-1-0**，而 `.mh-table thead th { text-align: left }` 是 **0-1-1** ⇒ 表头被强拉成左对齐、与表体不齐
+ * （实测勾选列表头左留白 0 / 右留白 26，错位 13px；右对齐列的标题也被拉到左边）。
+ * 只补 `text-align`（`thead th` 没声明过其它会被这些类覆盖的属性）。写法沿用 `th.mh-table__th-group`。 */
 .mh-table thead th.mh-table__col-check,
 .mh-table thead th.mh-table__cell-center {
   text-align: center;
@@ -256,9 +228,8 @@
   background: var(--ui-table-head-bg);
 }
 /* `--sticky-head`：表头钉顶。
- * ⚠️ 选择器必须带 `tr`（0-1-3）：文件后段「拖拽线的定位上下文」那条
- * `.mh-table thead th { position: relative }` 是 **0-1-2**，与不写 `tr` 的写法**同特异性且在后**
- * ⇒ 会把 `position: sticky` 覆盖掉，`stickyHead` 静默失效（0.6.0 起就存在，0.9.0 复核仍在）。
+ * ⚠️ 选择器必须带 `tr`（0-1-3）：文件后段「拖拽线的定位上下文」那条 `.mh-table thead th` 是 **0-1-2**，
+ * 与不写 `tr` 的写法同特异性且在后 ⇒ 会覆盖 `position: sticky`，`stickyHead` 静默失效。
  * `sticky` 同样是定位元素，照样给表头里的拖拽线当包含块，故加 `tr` 不损失原能力。 */
 .mh-table--sticky-head thead tr th {
   position: sticky;
@@ -283,10 +254,8 @@
   text-decoration: underline;
 }
 /* 列级**放开换行**（列定义里 `wrap: true` 时下发，只作用于表体 `td`；表头始终 nowrap）。
- * 缺省不换行在面文件的 `.mh-table--fixed tbody td` 里 —— 本档才翻默认，故这里同时把
- * 「换行三件套」与 `overflow-wrap` 兜底一并给回：换来的是「长文本列自己决定换行」。
- * ⚠️ 选择器必须带 `td`（0-1-3）：`.mh-table--fixed tbody td` 是 **0-1-2**，
- * 单个类（0-1-0）压不过它（同 §表头对齐那条的先例）。 */
+ * 缺省不换行在 `.mh-table--fixed tbody td` 里 —— 本档才翻默认，故这里把「换行三件套」与兜底一并给回。
+ * ⚠️ 选择器必须带 `td`（0-1-3）：`.mh-table--fixed tbody td` 是 **0-1-2**，单个类压不过它。 */
 .mh-table tbody td.mh-table__cell-wrap {
   white-space: normal;
   overflow: visible;
@@ -313,11 +282,10 @@
   color: var(--ui-error);
 }
 
-/* 单元格里的编辑控件：**表格面不为它写规则**。
- * 编辑格由调用方在 `#cell` 插槽里自己摆（`Input` / `Select` / `NumberInput`，外层可套 `Form.Item`），
- * 框、内距、错误档、只读档全部沿用 form / input 两族既有口径 —— 表格侧再写一份就是开第二套会漂的规格。
- * 唯一要提醒的是**列宽**：`table-layout: auto` 下「输入框的最小内容宽」会把窄列顶开，
- * 列宽要守得住就开 `layout="fixed"`（列宽由 `<colgroup>` 决定，不再被内容撑破）。 */
+/* 单元格里的编辑控件：**表格面不为它写规则** —— 编辑格由调用方在 `#cell` 插槽里自己摆
+ * （`Input` / `Select` / `NumberInput`，外层可套 `Form.Item`），框 / 内距 / 错误档全沿用 form / input
+ * 两族既有口径。唯一要提醒的是**列宽**：`table-layout: auto` 下输入框的最小内容宽会把窄列顶开，
+ * 列宽要守得住就开 `layout="fixed"`。 */
 
 /* 状态点（语义四档） */
 .mh-table__status-dot {
@@ -357,16 +325,14 @@
 .mh-table__sort--active {
   color: var(--ui-primary);
 }
-/* 槽位尺寸：常规图标一律取全局图标档（**不写 `.mh-table__sort-icon`** —— 那是只作朝向锚点的结构类，
-   面上为排序指示写规则会被契约拦下，见下方注释） */
+/* 槽位尺寸：常规图标一律取全局图标档（**不写 `.mh-table__sort-icon`** —— 那是只作朝向锚点的结构类） */
 .mh-table__sort > svg {
   width: var(--ui-font-icon);
   height: var(--ui-font-icon);
 }
 /* 排序朝向：**方位在字形里**（升序 `chevron-up` / 降序与未排序 `chevron-down`，未排走浅色、已排随
-   `.mh-table__sort--active` 主色）—— 本层零 `transform`，不走"把别的图标旋转 90° 冒充上下"的老路
-   （包内硬约束）。`mh-table__sort-icon` 与 `--asc` / `--desc` 只作**状态锚点**（消费方与用例按它们定位
-   当前朝向），面上无声明，登记在测试契约的结构锚点台账里。 */
+   `.mh-table__sort--active` 主色）—— 本层零 `transform`，不走"把别的图标旋转 90° 冒充上下"的老路。
+   `mh-table__sort-icon` 与 `--asc` / `--desc` 只作**状态锚点**，面上无声明。 */
 .mh-table__drag-line {
   position: absolute;
   top: 50%;

package/dist/styles/components/table.tokens.css

@@ -2,12 +2,11 @@
  * 批量栏 `.mh-table__batch` 是包裹层的子元素（与 `<table>` 同级）—— 令牌锚在容器上，
  * 批量栏的高度 / 内距 / 底色照样取得到
  *
- * ## 抽出说明
- * 本文件从面文件里抽出：这些是**基础值**，锚在 `[data-manohub-ui]`（跨包唯一作用域锚，
- * 由入口层无条件写在应用容器上）—— 任何落在容器里的分件都取得到值，不再依赖
- * 「声明在某个组件根类上」这条脆弱假设。
- * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里（拆开会让档位失效）。
- */
+ *
+ * 令牌锚 `[data-manohub-ui]`（容器是每个分件的祖先 ⇒ 落在容器里的分件都取得到值）。
+ * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里（搬走会让档位失效）；
+ * 新增组件要登记两处：本文件 + `src/styles/index.css`（见其文件头「五处齐备」）。
+*/
 [data-manohub-ui] {
   /* 单件令牌 */
   --ui-table-font-size: var(--ui-font-caption);

package/dist/styles/components/tag.css

@@ -1,31 +1,21 @@
 /**
  * Tag —— **`Badge` 的交互封装**（可关闭 / 可新增）。
  *
- * ## 本件不画框（与 `select.css` 同一条纪律）
+ * **本件不画框**（与 `select.css` 同一条纪律）：底 / 边 / 圆角 / 高度 / 字号 / 内距 / 档位**全归 `badge` 面**
+ * —— 徽标是「只读标记」的唯一样式源，本件只往它上面加交互位。本文件只有四样东西：
+ * ① `.mh-tag` 内容与操作位之间的间距（比 `Badge` 的通用 gap 紧一档）；② `.mh-tag__close` /
+ * `__confirm` 两个操作位（14 圆底 + 悬停蒙层；图标 12 属有意保留的专属尺寸）；③ `.mh-tag--add`
+ * 新增入口（虚线框 + 中性字，滑过转主色）；④ `.mh-tag--editing` / `__input` 编辑态（框归 input 面，
+ * 这里只给**窄**宽度，与确认位沿用 `.mh-tag` 的间距）。
  *
- * 底 / 边 / 圆角 / 高度 / 字号 / 内距 / 档位**全归 `badge` 面** —— 徽标是「只读标记」的唯一样式源，
- * 本件只往它上面加两个交互位。2026-09-30 之前这里有一整套与 `badge` 重复的几何
- * （`--ui-tag-bg` / `-height` / `-font-size` / `-radius` …）：同一个高度上两件各走一个圆角档、
- * 同一个「浅主色标签底」两件给了两个色 —— 那批规则已整体撤除，本文件只剩三样东西：
+ * **特异性：两位本件类，不靠导入顺序**。`--add` 那组写成 `.mh-tag.mh-tag--add`（0-2-0），压过 badge 面的
+ * 单类规则（0-1-0）—— 两条备选都被否掉：引 `.mh-badge`（面文件的类名必须与文件词根同根）、靠导入顺序
+ * （顺序会被人无意调整，两位类权重不会）。`--add` 转发给 `Badge` 的档是 `plain`（底透明、字取中性），
+ * 需要覆盖的只剩 `border-color` 与字色。
  *
- *   1. `.mh-tag`：内容与操作位之间的间距（比 `Badge` 的通用 gap 紧一档）；
- *   2. `.mh-tag__close` / `.mh-tag__confirm`：两个操作位（14 圆底 + 悬停蒙层；图标 12 属有意保留的专属尺寸）；
- *   3. `.mh-tag--add`：新增入口形态（虚线框 + 中性字，滑过转主色）；
- *   4. `.mh-tag--editing` / `.mh-tag__input`：新增档点开后的编辑态（输入框的框归 input 面，
- *      这里只给**窄**宽度；输入框 ↔ 确认位沿用 `.mh-tag` 的间距）。
- *
- * ## 特异性：两位本件类，不靠导入顺序
- *
- * `--add` 那组写成 **`.mh-tag.mh-tag--add`（0-2-0）**，压过 badge 面的单类规则（0-1-0）。
- * 两条备选都被否掉：
- * ① 引用 `.mh-badge`（面文件的类名必须与文件词根同根，跨族引用要进豁免台账）；
- * ② 靠 `styles/index.css` 的导入顺序（badge 面在前、本面在后）—— 顺序会被人无意调整，
- *    两位类权重不会。`--add` 转发给 `Badge` 的档是 `plain`（底透明、字取中性），
- *    需要覆盖的只剩 `border-color` 与字色。
- *
- * ⚠️ 新增档的根是**真实 `<button>`**（走 `Badge` 的 `as="button"`）：按钮自带外观的三样
- * （`border` / `background` / `padding`）由 badge 面提供（`contract-reset.spec.ts` 按标签审计），
- * `font-family: inherit` 也在那边补 —— 本件只管虚线框与悬停色。
+ * ⚠️ 新增档的根是**真实 `<button>`**（走 `Badge` 的 `as="button"`）：按钮自带外观的三样（`border` /
+ * `background` / `padding`）与 `font-family: inherit` 都由 badge 面提供（`contract-reset.spec.ts` 按标签
+ * 审计），本件只管虚线框与悬停色。
  */
 
 /* ===== 内容 ↔ 关闭位：比 Badge 的通用 gap（6，给前置点的）紧一档 ===== */

package/dist/styles/components/tag.tokens.css

@@ -1,17 +1,11 @@
 /**
  * tag —— 单件令牌（**基础值**）。
  *
- * 本件是 **`Badge` 的交互封装**（可关闭 / 可新增）：底 / 边 / 圆角 / 高度 / 字号 / 内距 / 档位
- * 全归 `badge` 面，故这里只剩**交互位自己**的两个值 —— 文件这么短是**有意**的：
- * 2026-09-30 之前它带着一整套与 `badge` 重复的几何（`--ui-tag-bg` / `-height` / `-font-size` …），
- * 同一高度上还各走一个圆角档，那批令牌已随收口撤除。
- *
- * ## 抽出说明
- * 这些是**基础值**，锚在 `[data-manohub-ui]` —— 跨包唯一作用域锚，由入口层无条件写在应用容器上，
- * 因此**任何落在容器里的分件都取得到值**，不再依赖「声明在某个组件根类上」这条脆弱假设。
- *
- * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里（搬走会让档位失效）。
- * ⚠️ 新增组件要登记两处：本文件 + `src/styles/index.css`（见其文件头「五处齐备」）。
+ * 本件是 **`Badge` 的交互封装**（可关闭 / 可新增）：底 / 边 / 圆角 / 高度 / 字号 / 内距 / 档位全归
+ * `badge` 面，故这里只剩**交互位自己**的两个值 —— 文件这么短是**有意**的（从前它带着一整套与 `badge`
+ * 重复的几何、同一高度还各走一个圆角档，那批令牌已随收口撤除）。
+ * 令牌锚 `[data-manohub-ui]`（容器是每个分件的祖先 ⇒ 落在容器里的分件都取得到值）。
+ * ⚠️ 档位改写留在面文件的修饰符块里（搬走会让档位失效）；新增组件登记两处：本文件 + `src/styles/index.css`。
  */
 [data-manohub-ui] {
   /* 内容 ↔ 操作位：4（`Badge` 的通用 gap 是 6，那是给前置点的；操作位紧一档更像「贴在字尾」） */

package/dist/styles/components/text.css

@@ -1,37 +1,25 @@
 /**
  * Text —— 文本排版（字号 / 行高 / 字重 / 语义色 / 等宽 / 截断）。
  *
- * 本文件是 `@manohub/theme` 那套 `--ui-font-*` / `--ui-line-*` / `--ui-weight-*` 档位令牌的
- * **第一个消费者**：在此之前它们只有定义、没有件，于是「卡片里的文字层级」在应用侧无合规落点
- * （契约 L1-5 禁 `font-*` / `color`），每个应用都要留一条定版例外登记。
+ * 本文件是那套 `--ui-font-*` / `--ui-line-*` / `--ui-weight-*` 档位令牌的**第一个消费者**：在此之前它们
+ * 只有定义、没有件，于是「卡片里的文字层级」在应用侧无合规落点（L1-5 禁 `font-*` / `color`）。
  *
- * ## 取色口径
- *
- * 与 `Notice` / `Dialog` 的语义档同一张表：`success` / `warning` 取 `-strong` 档
+ * 取色口径：与 `Notice` / `Dialog` 的语义档同一张表 —— `success` / `warning` 取 `-strong` 档
  * （直接用 500 档主色在浅底上对比度不足，属可读性缺陷）。
- *
- * ## 为什么 tone 走内部变量
- *
- * `--mh-text-tone-color` 是**内部状态变量**（`--mh-` 命名空间），由修饰符类赋值、由根类消费 ——
- * 这样「一条规则管颜色」而不是七条各写一次 `color`。默认值取 `inherit`，
- * 故**不传 tone 的文字也不会被强行染色**（`tone` 缺省档是 `default`，与正文色一致）。
- *
- * ## 截断
- *
- * `--truncate`（单行）与 `--clamp`（N 行）都要 `min-width: 0` 才能在被 flex 拉伸的子项里生效
- * （flex 子项的 `min-width` 默认是 `auto`，不给就会把容器撑开而不是省略）。
- * N 行的行数经 `--mh-text-lines` 下发（`-webkit-line-clamp` 只吃值，不能由类名表达行数）。
+ * **tone 走内部变量**：`--mh-text-tone-color` 由修饰符类赋值、由根类消费 ⇒「一条规则管颜色」而不是七条
+ * 各写一次 `color`；默认值 `inherit`，故**不传 tone 的文字也不会被强行染色**。
+ * **截断**：`--truncate`（单行）与 `--clamp`（N 行）都要 `min-width: 0` 才能在 flex 拉伸的子项里生效
+ * （flex 子项的 `min-width` 默认是 `auto`，不给就会把容器撑开而不是省略）；行数经 `--mh-text-lines` 下发
+ * （`-webkit-line-clamp` 只吃值，不能由类名表达行数）。
  */
 
 .mh-text {
   color: var(--mh-text-tone-color, inherit);
 }
 
-/* 浏览器给 `h1`-`h6` 的那套字阶（`1.5em` + 粗体）只该是**语义**，视觉由 `size` / `weight` 定：
-   归零搬到了本件（元素级基线不再代管 —— 那条在 Tailwind 的层外，会压住消费方的 `text-*` 工具类）。
-   只点名标题标签：`strong` / `b` 的加粗是它们唯一的表达，不能被归零。
-   档位类在本文件里更靠后、且同特异性，故 `--heading` / `--semibold` 一类照样覆盖它
-   （静态页里手写 `<h2 class="mh-text">` 且不给档位时，也仍是「正文字号 + 继承字重」）。 */
+/* 浏览器给 `h1`-`h6` 的字阶（`1.5em` + 粗体）只该是**语义**，视觉由 `size` / `weight` 定 —— 归零搬到本件
+   （元素级基线不再代管：那条在 Tailwind 的层外，会压住消费方的 `text-*` 工具类）。只点名标题标签，
+   `strong` / `b` 的加粗是它们唯一的表达、不能被归零。档位类在本文件里更靠后且同特异性，故照样覆盖它。 */
 .mh-text:where(h1, h2, h3, h4, h5, h6) {
   font-size: inherit;
   font-weight: inherit;

package/dist/styles/components/toast.css

@@ -1,25 +1,18 @@
 /**
  * Toast —— 消息提示（一行提示 + 语义图标 + 可选动作；可堆叠）。
  *
- * 出处：`@aihub/theme` 的 `playground/components/toast.css` 与 `src/components/toast.css`
- * （宽 240 / 最大 560 / 最小高 52 / r8 / 1px 描边 / 内距 10 16 10 24 / 图标 18 圆 / 图标与文字间距 12 /
- *  投影 `0 2 12` 黑 10% / 正文 15；loading 样张 240x93 且图标顶对齐；带动作样张宽 360）。
+ * 出处：规范（宽 240 / 最大 560 / 最小高 52 / r8 / 1px 描边 / 内距 10 16 10 24 / 图标 18 圆 /
+ * 图标与文字间距 12 / 投影 `0 2 12` 黑 10% / 正文 15；loading 样张 240x93 且图标顶对齐；带动作样张宽 360）。
+ * ⚠️ **与规范的一处有意偏差**：loading 那张是「多行加载文案」的尺寸，照搬成最小高会让单行提示撑出一张
+ * 上挤下空的空卡 —— 故本档高度回归常态（52 起、内容多时自然撑高），只保留图标差异（透明底 + 主色转圈）。
  *
- * **与规范的一处有意偏差**：loading 那张 240x93 的样张是「多行加载文案」的尺寸，照搬成最小高后，
- * 单行提示会撑出一张上挤下空的空卡 —— 故本档高度回归常态（与其它档同为 52 起，内容多时自然撑高），
- * 只保留图标差异（透明底 + 主色转圈）。
+ * 三件事必须与规范一致（容易做错）：① **图标是「圆形色底 + 白色字形」**，不是一个字形图标
+ * （只有 loading 例外：透明底 + 2px 主色描边、**上边留缺口**造成转圈感）；② **动作按钮靠
+ * `margin-left: auto` 顶到最右**，不是跟在文字后面；③ **转圈动画的键名归本族**（`mh-toast-spin`）——
+ * 动画名是全局标识，加 `mh-` 前缀以免与页面上别的库撞名。
  *
- * 三件事必须与规范一致（容易做错）：
- *
- * 1. **图标是「圆形色底 + 白色字形」**，不是一个字形图标 —— 只有 loading 例外（透明底 + 2px 主色描边，
- *    **上边留缺口**造成转圈感）；
- * 2. **动作按钮靠 `margin-left: auto` 顶到最右**，不是跟在文字后面；
- * 3. **转圈动画的键名归本族**（`mh-toast-spin`）：动画名是全局标识，加 `mh-` 前缀避免与页面上别的库撞名。
- *
- * 零 JS 能表达的：全部静态形态 + 转圈。**必须 JS**：自动消失计时、多条的出队、以及把 loading 换成结果态
- * （那三件都在组件层，本面不预设）。
- *
- * 堆叠容器（`.mh-toast-stack`）是随本族给的一层薄皮：定在视口顶部居中、纵向 8 间距 —— 位置与堆叠是
+ * 零 JS 能表达全部静态形态 + 转圈；**必须 JS**：自动消失计时、多条出队、loading 换结果态（都在组件层）。
+ * 堆叠容器（`.mh-toast-stack`）是随本族给的薄皮：定在视口顶部居中、纵向 8 间距 —— 位置与堆叠是
  * 「一族怎么摆」的事，做成类比让每个应用各写一份靠谱。
  */
 .mh-toast {
@@ -34,7 +27,7 @@
   min-width: var(--ui-toast-width);
   max-width: var(--ui-toast-width-max);
   min-height: var(--ui-toast-min-height);
-  padding: var(--ui-space-3) var(--ui-space-4) var(--ui-space-3) var(--ui-space-6);
+  padding: var(--ui-toast-padding);
   border: 1px solid var(--ui-toast-border);
   border-radius: var(--ui-toast-radius);
   background: var(--ui-base-100);