@manohub/theme 0.10.0 → 0.10.2

package/dist/default/colors.css

@@ -5,19 +5,26 @@
  * **四个品牌页**（`00.1 管理员配置` / `01.1 技能权限分配` / `01.2 技能权限分配-初始状态` /
  * `02.1 技能准入列表`）为唯一事实源。
  *
- * **三个向导页（`02.2.1/2/3`）判定为旧稿**：它们用 Farris 规范色（`#2a87ff` 主色、
- * `#5fc875` 成功、`#cdd2de` 连接线、`#a8adb8` 弱字、`#f0f3f7` 面），一律**不予采纳** ——
- * 否则 default 主题会与 farris 主题同值，两套主题失去区分意义。
- *
  * 锚定 `[data-manohub-ui]` 而非 `:root`：micro-app 的 scopecss 不作用域化 `:root`，
  * 定义在 `:root` 的变量会泄漏到宿主全局（多子应用互染、卸载残留）。
- * 局部换主题 = 在更深的容器上重设变量，如 `.role-tree-pane { --ui-primary: #7C3AED; }`。
+ * 局部换主题 = 在更深的容器上重设变量，如 `.demo-panle { --ui-primary: #7C3AED; }`。
  *
  * ## 三条口径（改值前先读，别绕过）
  *
- * 1. **中性阶只有四级面**：`base-100`（内容底）/ `base-200`（中性面）/ `base-300`（线框）/
- *    `base-400`（仅勾选类小控件框体）。设计稿内容区**从未出现 `#F5F7FA`**；实测中性面只有
- *    `#F2F2F2`（中性 hover / 禁用底）与 `#F1F2F5`（表头底），二者差 3/255，故合并为 `base-200`。
+ * 1. **中性阶是五个「槽位」，不是一条刻度**：`base-50`（比内容底更轻一档的底）/
+ *    `base-100`（内容底）/ `base-200`（中性面：表头底 / hover 底 / 禁用底 / 斑马行）/
+ *    `base-300`（线框）/ `base-400`（仅勾选类小控件框体）。
+ *    **数字只是槽位标号**（借 daisyUI 的命名壳），**不承诺等差 / 等比** —— 取值是设计稿的
+ *    **实测采样 + 近似合并**，不是从数列推出来的：别按数字补 `base-500`，也别把数字当
+ *    「浅一档 / 深一档」的通用梯度使（要更轻的底就 `base-50`、要「面」就 `base-200`，语义各归各）。
+ *    实测事实：设计稿内容区**从未出现 `#F5F7FA`**；中性面只有 `#F2F2F2`（中性 hover / 禁用底）
+ *    与 `#F1F2F5`（表头底），二者差 3/255，故合并为 `base-200` —— **合并取的是后者**，
+ *    所以本套的 `base-200` 带一点冷调，而 `base-300` / `base-400` 是纯灰：这是实测取舍，不是刻度走样。
+ *    量级参考（按 L* 估算的相邻差）：`100→200` −4.5 / `200→300` −4.2 / `300→400` −3.5，
+ *    大致是每档 4 上下的**感知步长**；而 `base-50` 只比 `base-100` 低 **1.7**，
+ *    它**不是刻度上的一格**，是「比内容底更轻一档的底」这一语义槽位 —— 但它的可见度本来就不够，
+ *    故**库内已无消费**（`Tag` 悬停底与 `Badge --soft` 默认底 2026-09-30 起改取 `base-200`），
+ *    留着是给应用侧的浅底；**别拿它当「浅灰面」的通用档**。
  * 2. **`base-300` 是全库唯一的「线 / 框」色**：输入框、按钮、表格、分页项、卡片、面板、分隔线
  *    一律取它。`base-400` 只留给 **14×14 这类小尺寸勾选框体**（设计稿让复选框比容器线深一档，
  *    否则小方块在浅底上看不见）。
@@ -41,8 +48,8 @@
      补这一枚是为了让主色族与四个语义族槽位等形（base / content / weak / border）。 */
   --ui-primary-border: #B7CAFF;
 
-  /* ===== 中性阶（四级面 + 三级字；禁止再自由取值） ===== */
-  --ui-base-50: #FAFAFA;
+  /* ===== 中性阶（五个槽位 + 三级字；禁止再自由取值 —— 数字是槽位标号，不是色阶） ===== */
+  --ui-base-50: #FAFAFA; /* 比内容底更轻一档的底；不是刻度上的一格 */
   --ui-base-100: #FFFFFF;
   --ui-base-200: #F1F2F5; /* 中性面：表头底 / hover 底 / 禁用底 / 斑马行 */
   --ui-base-300: #E6E6E6; /* 全库唯一的「线 / 框」色 */

package/dist/default/spacing.css

@@ -28,6 +28,16 @@
   --ui-row-height: 36px;
   --ui-header-height: 48px;
 
+  /* 标记体量档（**标记片**这一族的共用高度）：20 / 24。
+     徽标（`Badge` 的 `sm` / `md`）、标签（`Tag` 的 `sm` / 常规档）、多选标签片（`Select` 的
+     `--ui-select-chip-height`）三处取同一枚令牌 —— 改档只改这里，不再各自写字面量。
+     出处：《Farris Web 基础视觉规范》的「表格内标签」实测 36×20（r3 + 12px 字），20 档是设计稿里
+     唯一有实证的标记尺寸；24 档按体量就近升一档（规范未给，与 `Badge` 面里那条登记同源）。
+     ⚠️ 与 `--ui-control-height-*` 不是一族：控件高描述「可输入控件」的外框，标记片是**贴在内容上
+     的小色片**，两者只是数值上恰好都有 24，语义不同、别互相顶替。 */
+  --ui-mark-height-sm: 20px;
+  --ui-mark-height-md: 24px;
+
   /* 栅格单元最小宽度（Layout.Row 与 ListView 共用）：比表单列宽（--ui-form-column-min，见 form.css）
      窄一档 —— 表单字段要放下「label + 控件」，而栅格单元（卡片/内容块）可以更窄。
      用于「列数上限 N + 最小列宽」公式里 track 的下限（实测：600px 仍排 2 列、500px 折成 1 列）。 */

package/dist/farris/colors.css

@@ -7,6 +7,12 @@
  * 锚 `[data-manohub-ui][data-theme='farris']`：加上属性即整包换皮（见 `default/index.css` 的换主题约定）。
  * **本主题必须全量覆盖 default 的令牌**（否则会与 default 混成半套主题；护栏在
  * `__tests__/contract-tokens.spec.ts` 的「主题覆盖度」用例）。
+ *
+ * **中性阶的语义槽位与 default 逐条对齐**（见 `../default/colors.css` 的「三条口径」）：`base-300`
+ * 是全库唯一的「线 / 框」色 —— 输入框、按钮、表格、分页项、卡片、面板、分隔线一律取它；`base-400`
+ * 只服务小尺寸勾选类框体。本套的值取自规范色板（`Ne08` / `Ne04`），**行尾括注是「值出处」**：
+ * 规范原文把 `Ne04` 记作「输入框默认边框」，本仓按上面的统一口径把它归给 `base-300` ——
+ * 故 `base-400` 的括注不再写「输入框」，否则读者会以为输入框该取它（`Input` 取的是 `base-300`）。
  */
 [data-manohub-ui][data-theme='farris'] {
   /* ===== 品牌主色（科技蓝 Th 族） ===== */
@@ -20,12 +26,15 @@
   /* 浅主色描边：规范 Au01「表格选中行下划线」（规范里唯一一枚浅主色描边档） */
   --ui-primary-border: #c9e0ff;
 
-  /* ===== 中性阶 ===== */
-  --ui-base-50: #fafafc; /* Ne14 表格/树表禁用行 */
+  /* ===== 中性阶 =====
+   * 数字是**槽位标号**（口径见 `../default/colors.css` 的「三条口径」第 1 条），不承诺色阶等差 ——
+   * 本套的五枚值同样取自规范色板，除 `base-100` 为纯白外**都带同向冷调**（B−R 随深度递增：
+   * 2 / 4 / 10 / 14），这是规范色板的事实，不是刻度走样。 */
+  --ui-base-50: #fafafc; /* Ne14 表格/树表禁用行（**库内已无消费**，保留给应用侧；见 default 口径第 1 条） */
   --ui-base-100: #ffffff; /* Ne12 卡片与输入框背景 */
   --ui-base-200: #f5f6f9; /* Ne10 选择器选中行 / 输入框禁用背景 */
-  --ui-base-300: #e8ebf2; /* Ne08 弱边框（卡片描边的主手段） */
-  --ui-base-400: #d9dee7; /* Ne04 复选框 / 输入框 / 筛选项默认边框 */
+  --ui-base-300: #e8ebf2; /* Ne08 弱边框（全库唯一的「线 / 框」色，含输入框描边） */
+  --ui-base-400: #d9dee7; /* Ne04 仅勾选类小控件框体（checkbox / radio / switch 未选） */
   --ui-base-content: #2d2f33; /* Te01/Te02 标题与通用正文 */
   --ui-base-content-muted: #5a5e66; /* Te04 标签文字 / 表头 */
   --ui-base-content-subtle: #747b8b; /* Te06 辅助说明 */

package/dist/farris/spacing.css

@@ -21,9 +21,13 @@
   --ui-control-height-sm: 26px;
   --ui-control-height-md: 26px;
 
-  /* 以下四枚规范未给槽位 → 沿用 default 值 */
+  /* 以下六枚规范未给槽位 → 沿用 default 值。
+     其中标记体量档（20 / 24）：规范只给了「表格内标签 36×20」的实测值，没有把标记片立成档位，
+     故如实沿用 default，不凭空造数（与上一段的控件高不是一族，见 default/spacing.css 的注释）。 */
   --ui-control-height-lg: 40px;
   --ui-row-height: 36px;
   --ui-header-height: 48px;
   --ui-grid-column-min: 260px; /* 栅格水槽 28px 与「单元最小宽度」不是同一件事 */
+  --ui-mark-height-sm: 20px;
+  --ui-mark-height-md: 24px;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manohub/theme",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "private": false,
   "type": "module",
   "description": "AIHub 主题包：纯 CSS 令牌层（全局值），全部锚 [data-manohub-ui] 属性。零运行时依赖、零 JS、零真实样式声明。",