@manohub/ui 1.0.4 → 1.0.6

package/dist/styles/components/table.css

@@ -1,48 +1,31 @@
 /**
  * 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` 也不动，理由同此。
- *
- * 行态：表头底 `--ui-base-200` + 字 `--ui-base-content-muted` + 中粗 / 外框 1px `--ui-base-300` /
- * 斑马与禁用 `--ui-base-200` / 滑过 `--ui-primary-weak` / 选中 `--ui-primary-subtle`（**只底色**）。
+ * 出处（两套来源在关键几何上一致，故没有取舍余地）：设计稿《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` 并去掉外框。
- *    **三条线之外的边一律显式清零**（`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">`，
- *    于是「启用」这类**功能值**会把整行点亮。功能值与行选择语义不同，视觉必须分开（否则一张表里
- *    开关一开就整行变色，且用户无从判断那到底表示什么）。
+ * 1. **边框模型**：默认是外框 + 表头下分割线 + 每行底线（末行去线）⇒ `border-collapse: separate` +
+ *    `border-spacing: 0`（圆角只在 separate 下渲染得出来）；`--borderless` 才切回 `collapse` 并去外框。
+ *    **三条线之外的边一律显式清零**（`border: 0` 写在 `th` / `td` / `tr` 上，不是冗余）：特异性只在**同一
+ *    属性**上分胜负，宿主给单元格 / 行下的整圈边框（典型 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 +73,22 @@
 }
 
 /* ===== 固定布局档（`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`）。
+ * ⚠️ **只在本档翻默认**：`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 +96,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 +113,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 +131,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 +151,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 +179,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 +190,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 +199,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`（组头居中）那条既有先例。 */
+/* ⚠️ **表头要把对齐重声明一遍**：下面几条与 `--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;
@@ -255,11 +222,9 @@
   z-index: 2; /* 表头既钉顶又钉左，压住表头其余列 */
   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 复核仍在）。
- * `sticky` 同样是定位元素，照样给表头里的拖拽线当包含块，故加 `tr` 不损失原能力。 */
+/* `--sticky-head`：表头钉顶。⚠️ 选择器必须带 `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;
   top: 0;
@@ -283,10 +248,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 +276,9 @@
   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 +318,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);

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

@@ -3,16 +3,11 @@
  *
  * 本件自己的几何 / 尺寸 / 色彩槽位；只服务本件，故不随主题进 `@manohub/theme`。
  *
- * ## 抽出说明
- * 本文件从面文件里抽出（原先混写在 `toast.css` 顶部）：这些是**基础值**，锚在
- * `[data-manohub-ui]` —— 跨包唯一作用域锚，由入口层无条件写在应用容器上，因此**任何落在
- * 容器里的分件都取得到值**，不再依赖「声明在某个组件根类上」这条脆弱假设
- * （历史症状：跨件消费的 `--ui-*-group-*` 取不到值，组内间距变 0）。
  *
- * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里 —— 它们靠「同一元素上两个
- * 选择器改写同一个令牌」生效，搬到本文件会让档位失效。
- * ⚠️ 新增组件要登记两处：本文件 + `src/styles/index.css`（见其文件头「五处齐备」）。
- */
+ * 令牌锚 `[data-manohub-ui]`（容器是每个分件的祖先 ⇒ 落在容器里的分件都取得到值）。
+ * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里（搬走会让档位失效）；
+ * 新增组件要登记两处：本文件 + `src/styles/index.css`（见其文件头「五处齐备」）。
+*/
 [data-manohub-ui] {
   /* 单件令牌 */
   --ui-toast-width: 240px;
@@ -21,6 +16,8 @@
   --ui-toast-radius: var(--ui-radius-md); /* 规范 r8 */
   --ui-toast-border: var(--ui-base-300); /* 规范 #d8dce6 */
   --ui-toast-gap: var(--ui-space-3); /* 图标与文字间距 12 */
+  /* 四边内距（规范 10 / 16 / 10 / 24：左宽一档是给图标位留的）—— 一枚令牌即整个简写 */
+  --ui-toast-padding: var(--ui-space-3) var(--ui-space-4) var(--ui-space-3) var(--ui-space-6);
   --ui-toast-icon-size: 18px;
   --ui-toast-text-size: 15px; /* 规范实测（本仓字阶无 15，按实测值给） */
 }

package/dist/styles/components/tooltip.css

@@ -1,19 +1,17 @@
 /**
  * Tooltip —— 提示气泡皮肤（与操作层并列组合）。
  *
- * 出处：`@aihub/theme` 的 `playground/components/tooltip.css` 与 `src/components/tooltip.css`
- * （内距 8 / 14、圆角 10、深底反白字、`0 2 8` 黑 15% 投影；引导档另有一套面：蓝渐变底 + 12/14 内距 +
- *  `0 2 14` 投影；标题 medium；动作是白色文本按钮；显隐纯淡入、不位移不缩放）。
+ * 出处：规范（内距 8 / 14、圆角 10、深底反白字、`0 2 8` 黑 15% 投影；引导档另有一套面：蓝渐变底 +
+ * 12/14 内距 + `0 2 14` 投影；标题 medium；动作是白色文本按钮；显隐纯淡入、不位移不缩放）。
  *
- * **类名与面文件名同根**：族名 `tooltip` → 类名 `.mh-tooltip*`（与令牌 `--ui-tooltip-*` 同根），
- * 一律 `mh-` 前缀 —— 本包独立发布，不迁就任何下游的既有类名（有用例盯着这条口径）。
- *
- * 显隐与定位全归操作层：宿主态（`.mh-popup-host:hover` / `:focus-within`）切 display、`data-side` / `data-align`
- * 给定位、`.mh-popup-anchor` / `--anchored` 给锚。本件只给面 + 淡入（进出对称）。
+ * 类名与面文件名同根（`.mh-tooltip*`，与令牌 `--ui-tooltip-*` 同根）—— 本包独立发布，不迁就任何下游的
+ * 既有类名（有用例盯着这条口径）。
+ * 显隐与定位全归操作层：宿主态（`:hover` / `:focus-within`）切 display、`data-side` / `data-align` 给定位、
+ * `.mh-popup-anchor` / `--anchored` 给锚；本件只给面 + 淡入（进出对称）。
  */
 .mh-tooltip {
   display: inline-block;
-  padding: var(--ui-space-2) var(--ui-tooltip-padding-x);
+  padding: var(--ui-tooltip-padding-y) var(--ui-tooltip-padding-x);
   border-radius: var(--ui-tooltip-radius);
   background: var(--ui-tooltip-bg);
   color: var(--ui-tooltip-text);
@@ -22,9 +20,9 @@
   box-shadow: var(--ui-tooltip-shadow);
 }
 
-/* 引导档（自己的面：更亮的内距 + 蓝渐变 + 更大投影） */
+/* 引导档（自己的面：内距上下一档 + 蓝渐变 + 更大投影） */
 .mh-tooltip--guide {
-  padding: var(--ui-space-3) var(--ui-tooltip-padding-x);
+  --ui-tooltip-padding-y: var(--ui-space-3);
   background: var(--ui-tooltip-guide-bg);
   box-shadow: var(--ui-tooltip-guide-shadow);
 }

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

@@ -3,20 +3,16 @@
  *
  * 本件自己的几何 / 尺寸 / 色彩槽位；只服务本件，故不随主题进 `@manohub/theme`。
  *
- * ## 抽出说明
- * 本文件从面文件里抽出（原先混写在 `tooltip.css` 顶部）：这些是**基础值**，锚在
- * `[data-manohub-ui]` —— 跨包唯一作用域锚，由入口层无条件写在应用容器上，因此**任何落在
- * 容器里的分件都取得到值**，不再依赖「声明在某个组件根类上」这条脆弱假设
- * （历史症状：跨件消费的 `--ui-*-group-*` 取不到值，组内间距变 0）。
  *
- * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里 —— 它们靠「同一元素上两个
- * 选择器改写同一个令牌」生效，搬到本文件会让档位失效。
- * ⚠️ 新增组件要登记两处：本文件 + `src/styles/index.css`（见其文件头「五处齐备」）。
- */
+ * 令牌锚 `[data-manohub-ui]`（容器是每个分件的祖先 ⇒ 落在容器里的分件都取得到值）。
+ * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里（搬走会让档位失效）；
+ * 新增组件要登记两处：本文件 + `src/styles/index.css`（见其文件头「五处齐备」）。
+*/
 [data-manohub-ui] {
   /* 单件令牌 */
   --ui-tooltip-radius: 10px; /* 规范 r10（本仓圆角刻度最大 8） */
   --ui-tooltip-padding-x: 14px; /* 规范间距档 5 = 14 */
+  --ui-tooltip-padding-y: var(--ui-space-2); /* 8：引导档在它的修饰符块里改写为 12 */
   --ui-tooltip-bg: var(--ui-base-content); /* 深底：规范用深色蒙层色，本仓无深色面令牌，取正文档（与输入说明气泡同一映射） */
   --ui-tooltip-text: var(--ui-base-100); /* 反白字 */
   --ui-tooltip-shadow: 0 2px 8px rgba(0, 0, 0, 0.15); /* 规范实测值（本仓阴影令牌几何不同族，故按出处给） */

package/dist/styles/components/tree.css

@@ -1,34 +1,21 @@
 /**
- * Tree（自建树：节点行 + 缩进 + 展开箭头 + 计数徽标位）。
+ * Tree（自建树：节点行 + 缩进 + 展开箭头 + 计数徽标位）。几何取自规范 `components/tree.css` 与设计稿
+ * 《MH后台-0911》`0:3921` 组织树实测：
+ * - 行高 34（紧凑档 28）、**行挨行（不加行距，节距 = 行高）**、圆角 6、字号 13；行内 padding 承载缩进
+ *   （**行底满宽、只有内容缩进**）。⚠️ 行距原为 6，2026-09-30 按使用方拍板去掉 —— 树行与选择器面板里的
+ *   选项行是**同一套行**（行高 / 圆角 / 内距 / 字号 / 行态逐项同源），那边是行挨行的平铺列表。
+ * - 缩进 = 基础内距 8 + level × 步进 10，**无上限**（level 由组件在行上下发）。
+ * - 三态：滑过 `--ui-primary-weak`、点击瞬态与选中 `--ui-primary-subtle`（选中另加主色字；
+ *   设计：选中行 = 主色底 10% + 蓝字）。**取色口径与 Table / ListView 统一**，不再出现「树用中性底、
+ *   表格用主色底」的分叉；`:active` 改吃 `--ui-primary-subtle`（改前是硬编码 `#f4f5f9` —— 既是色值
+ *   字面量，换主题也不跟随）。
+ * - 箭头 = 常规图标档（收起态转 −90°），叶子节点用占位保持层级对齐；行内图标位只有两处（箭头、
+ *   标签前的节点图标槽），都取全局图标档、颜色跟随行色。
  *
- * 几何取自 `@aihub/theme` 的 `components/tree.css` 与设计稿《MH后台-0911》的 `0:3921` 组织树，
- * 见下方令牌块与形态注释。
+ * 缩进走 CSS 变量而不是行内 `padding-left`：主题包用 typed `attr(data-level type(<number>))` 一步算出；
+ * 为兼容尚无该能力的引擎，这里由组件同时下发 `--mh-tree-level`，公式仍在 CSS 内（不散落字面量）。
  */
 
-/* ===== Tree（自建树：节点行 + 缩进 + 展开箭头 + 计数徽标位）=====
-   几何与各态对齐 `@aihub/theme` 的 `components/tree.css` 与设计稿 `0:3921` 组织树实测：
-  - 行高 34（紧凑档 28）、**行挨行（不加间距，节距 = 行高）**、圆角 6、字号 13、
-    行内 padding 承载缩进（**行底满宽、只有内容缩进**）
-    ⚠️ 行距原为 6（节距 40，取自设计稿行文本 y 差）：2026-09-30 按使用方拍板去掉 ——
-    树行与选择器面板里的选项行是**同一套行**（行高 / 圆角 / 内距 / 字号 / 行态逐项同源），
-    那边是行挨行的平铺列表，两处当然该同一节距（去掉行距后 select 面板里的树与列表也一致了）。
-   - 缩进 = 基础内距 8 + level × 步进 10，**无上限**；level 由组件在行上下发
-   - 三态：滑过 `--ui-primary-weak`、点击瞬态 `--ui-primary-subtle`、
-     选中 `--ui-primary-subtle` 底 + 主色字（设计：选中行 = `#2660ff` 底 10% + 蓝字）
-   - 箭头 = 常规图标档（`--ui-font-icon`，收起态转 −90°）；叶子节点用占位保持层级对齐
-  - 行内图标位只有两处：箭头（`.mh-tree__caret`，可被 `renderCaret` 替换）与标签前的
-    节点图标槽（`.mh-tree__icon`，`renderIcon` 才会出现）。两者都取全局图标档、颜色跟随行色
-
-   **行态的取色口径与 Table / ListView 统一**：行类表面的「滑过」用 `--ui-primary-weak`（浅主色）、
-   「选中」用 `--ui-primary-subtle`（深一档主色）—— 三者同一套规则，不再出现「树用中性底、
-   表格用主色底」的分叉。
-   点击瞬态（`:active`）改吃 `--ui-primary-subtle`：改前是本件硬编码的 `#f4f5f9`，
-   既是色值字面量（违反「组件 CSS 不得新增色值字面量」），换主题时也不跟随。
-
-   缩进为什么走 CSS 变量而不是行内 paddingLeft：主题包用 typed `attr(data-level type(<number>))`
-   一步算出（`padding-left: calc(8px + attr(...) * 10px)`）；为兼容尚无该能力的引擎，这里由组件
-   同时下发 `--mh-tree-level`，公式仍在 CSS 内（数值只取令牌，不散落字面量）。 */
-
 /* 树是**行挨行**的列容器（不加行距，节距 = 行高 34）：
    行底满宽、只有内容缩进，行态（滑过 / 按下 / 选中）的底因此是连着的 ——
    与选择器面板里的选项行同一节距（见文件头「行距原为 6」那条）。 */

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

@@ -6,12 +6,11 @@
  * 现在同一套行（行高 / 圆角 / 内距 / 字号 / 行态逐项同源），那边是行挨行的平铺列表，
  * 节距就该一样（设计稿的节距 40 因此让位）。**无消费者不预置令牌**，别再把它加回来。
  *
- * ## 抽出说明
- * 本文件从面文件里抽出：这些是**基础值**，锚在 `[data-manohub-ui]`（跨包唯一作用域锚，
- * 由入口层无条件写在应用容器上）—— 任何落在容器里的分件都取得到值，不再依赖
- * 「声明在某个组件根类上」这条脆弱假设。
- * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里（拆开会让档位失效）。
- */
+ *
+ * 令牌锚 `[data-manohub-ui]`（容器是每个分件的祖先 ⇒ 落在容器里的分件都取得到值）。
+ * ⚠️ `.mh-<件>--<档>` 这类**档位改写**留在面文件的修饰符块里（搬走会让档位失效）；
+ * 新增组件要登记两处：本文件 + `src/styles/index.css`（见其文件头「五处齐备」）。
+*/
 [data-manohub-ui] {
   --ui-tree-row-height: 34px;
   --ui-tree-row-height-compact: 28px;