@manohub/ui 1.0.4 → 1.0.5

package/dist/components/card/index.d.ts

@@ -9,18 +9,17 @@ export type CardHeaderIcon = string | (() => VNodeChild);
 /**
  * 卡片容器：**卡片外观的唯一实现**（底 / 弱描边 / 圆角 / 内距 / 悬浮与选中反馈）。
  *
- * 消费方（含 `ListView.CardItem`）不得再自绘卡片外观（描边 / 圆角 / 阴影 / 底色），
- * 也不得在应用侧写这四类属性 —— 需要不同形态就用本件的维度（`variant` / `interactive` /
- * `selected` / `disabled`），或提为骨架层待建件。
+ * 消费方（含 `ListView.CardItem`）不得再自绘卡片外观（描边 / 圆角 / 阴影 / 底色），也不得在应用侧写这四类
+ * 属性 —— 需要不同形态就用本件的维度（`variant` / `interactive` / `selected` / `disabled`），或提为骨架层待建件。
  *
  * ## 几何来源（技能市场卡片实测，逐项落 `--ui-*` 令牌）
  *
- * - 圆角 8（`--ui-radius-md`）、内距 20（`--mh-card-padding`，原型 `p-5`）
- * - 底 `--ui-base-100`、弱描边 `--ui-base-300`（原型 `border-border`）
- * - 悬浮：描边转 `--ui-primary` + 主色 12% 阴影（`--ui-shadow-card-hover`）
+ * 圆角 8（`--ui-radius-md`）、内距 20（`--mh-card-padding`，原型 `p-5`）、底 `--ui-base-100`、弱描边
+ * `--ui-base-300`（原型 `border-border`）、悬浮转 `--ui-primary` 描边 + 主色 12% 阴影
+ * （`--ui-shadow-card-hover`）。
  *
- * 列表卡片项那套几何（最小高 144、状态胶囊、标签片…）属 `ListView.CardItem`，**不在本件** ——
- * 通用卡片不该被一条「只在列表里成立」的最小高绑住（**头部四件两处一致**，见下）。
+ * 列表卡片项那套几何（最小高 144、状态胶囊、标签片…）属 `ListView.CardItem`，**不在本件** —— 通用卡片不该被
+ * 一条「只在列表里成立」的最小高绑住（**头部四件两处一致**，见下）。
  *
  * ## Header 区域（四件；`Card.Header` 是完整入口，`Card` 上的同名 props 是它的简写）
  *

package/dist/components/dialog/index.d.ts

@@ -1,5 +1,5 @@
 import { type PropType, type SlotsType, type VNodeChild } from 'vue';
-export type DialogWidth = 'md' | 'lg';
+export type DialogWidth = 'sm' | 'md' | 'lg';
 /** 语义档：决定标题左侧图标的图形与颜色（缺省不渲染图标） */
 export type DialogTone = 'info' | 'success' | 'warning' | 'error';
 /**
@@ -56,7 +56,7 @@ export declare const Dialog: import("vue").DefineComponent<import("vue").Extract
         type: PropType<DialogTone>;
         default: undefined;
     };
-    /** 宽度：尺寸档 `md` 520 / `lg` 760，或直接给像素数 */
+    /** 宽度：尺寸档 `sm` 400 / `md` 520 / `lg` 760，或直接给像素数 */
     width: {
         type: PropType<DialogWidth | number>;
         default: string;
@@ -163,7 +163,7 @@ export declare const Dialog: import("vue").DefineComponent<import("vue").Extract
         type: PropType<DialogTone>;
         default: undefined;
     };
-    /** 宽度：尺寸档 `md` 520 / `lg` 760，或直接给像素数 */
+    /** 宽度：尺寸档 `sm` 400 / `md` 520 / `lg` 760，或直接给像素数 */
     width: {
         type: PropType<DialogWidth | number>;
         default: string;

package/dist/components/dialog/index.js

@@ -30,7 +30,7 @@ const Dialog = /* @__PURE__ */ defineComponent({
       type: String,
       default: void 0
     },
-    /** 宽度：尺寸档 `md` 520 / `lg` 760，或直接给像素数 */
+    /** 宽度：尺寸档 `sm` 400 / `md` 520 / `lg` 760，或直接给像素数 */
     width: {
       type: [String, Number],
       default: "md"
@@ -169,12 +169,13 @@ const Dialog = /* @__PURE__ */ defineComponent({
       };
       return void 0;
     });
+    const widthClass = computed(() => typeof props.width === "string" && props.width !== "md" ? `mh-dialog--${props.width}` : "");
     const heightStyle = computed(() => props.panelHeight ? {
       height: props.panelHeight
     } : void 0);
     return () => createVNode("dialog", {
       "ref": dialogRef,
-      "class": ["mh-popup", "mh-dialog", props.width === "lg" ? "mh-dialog--lg" : "", props.tone ? `mh-dialog--${props.tone}` : "", attrs.class].filter(Boolean).join(" "),
+      "class": ["mh-popup", "mh-dialog", widthClass.value, props.tone ? `mh-dialog--${props.tone}` : "", attrs.class].filter(Boolean).join(" "),
       "style": {
         ...widthStyle.value,
         ...heightStyle.value,

package/dist/components/form/index.d.ts

@@ -5,30 +5,19 @@ export type FormPadding = Padding;
 /** label 列的水平对齐：`right`（默认，与 farris / 主流水平表单一致）或 `left` */
 export type FormLabelAlign = 'left' | 'right';
 /**
- * 字段行的排布档：
+ * 字段行的排布档：`1`（默认，逐行）；`2 ~ 6`（**列数上限** —— 放得下 N 列就并排，放不下少排一列，不会
+ * 把控件压成窄条；5 / 6 是给宽屏展示页的，默认最小宽 320 下要容器 1632 / 1960px）；`'auto'`（**列数随容器
+ * 宽度动态变化**，每列宽由 `columnMinWidth` 决定）。
  *
- * - `1`（默认）：逐行；
- * - `2 ~ 6`：**列数上限** —— 容器放得下 N 列就并排，放不下**少排一列**（不会把控件压成窄条）。
- *   高列数（5 / 6）在默认最小宽 320 下要容器 1632 / 1960px 才排得出来，普通表单页用不到 ——
- *   留着它是给「宽屏展示页 / 大屏看板」这类场景，配 `columnMinWidth` 才好落地；
- * - `'auto'`：**列数随容器宽度动态变化** —— 能排几列排几列，每列宽由 `columnMinWidth` 决定。
- *
- * 两类的差别是**可预期性**（不是能力高低）：
- *
- * - 数字档承诺「最多 N 列」，所以「哪几个字段同排」在够宽的容器里是确定的；
- * - 动态档会一路排下去（默认参数下 1320px 就够 4 列），窄了就减 ——
- *   同一个表单在不同容器里列数不同 ⇒ **字段的相对位置会变**。要「两个字段必须并肩」就别用它。
+ * 两类的差别是**可预期性**（不是能力高低）：数字档承诺「最多 N 列」，够宽的容器里「哪几个字段同排」是
+ * 确定的；动态档会一路排下去、窄了就减，同一个表单在不同容器里列数不同 ⇒ **字段的相对位置会变**
+ * —— 要「两个字段必须并肩」就别用它。
  */
 export type FormColumns = 1 | 2 | 3 | 4 | 5 | 6 | 'auto';
 /**
- * 行内**垂直**对齐（label 与控件在控件行内怎么对齐）：
- *
- * - `center`（默认）：label 文字与控件**中线**对齐 —— 单行控件（输入框 / 选择器 / 开关）用它；
- * - `start`：label 与控件**首行文字**对齐 —— 多行控件（文本域）与整块内容用它，
- *   否则 label 会落到整块高度的中间。
- *
- * 不传即**自动判定**（样式按控件类型切档：文本域行零配置就是顶对齐）；
- * 显式传入优先于自动判定，用于自绘内容（卡片组 / 表格 / 富文本这类样式认不出来的块）。
+ * 行内**垂直**对齐（label 与控件在控件行内怎么对齐）：`center`（默认，与控件**中线**对齐，单行控件用）；
+ * `start`（与控件**首行文字**对齐，多行控件与整块内容用，否则 label 会落到整块高度中间）。
+ * 不传即**自动判定**（样式按控件类型切档）；显式传入优先，用于自绘内容（卡片组 / 表格 / 富文本）。
  */
 export type FormItemAlign = 'center' | 'start';
 /** 表单值：**字段名 → 值**（键就是 `Form.Item` 的 `name`） */
@@ -54,37 +43,27 @@ export interface FormProps {
      */
     labelAlign?: FormLabelAlign;
     /**
-     * 表单级控件列宽上限（px）；缺省**撑满**剩余宽度。
-     *
-     * 宽表单（>600px）里让输入框一路拉到右边缘很难看，两种收法二选一：
-     * ① 收宽度 —— 传 `controlWidth={360}`，控件列封顶、右侧留白；
-     * ② 分列 —— 传 `columns`（`2 | 3 | 4` 上限档，或 `'auto'` 动态），把行并排起来（见下）。
+     * 表单级控件列宽上限（px）；缺省**撑满**剩余宽度。宽表单（>600px）里让输入框一路拉到右边缘很难看，
+     * 两种收法二选一：① 收宽度（`controlWidth={360}`，控件列封顶、右侧留白）；② 分列（`columns`，见下）。
      */
     controlWidth?: number;
     /**
-     * 列数：`1`（默认，逐行）/ `2 ~ 6`（**容器够宽才并排**，窄了按列最小宽度自动回落一列）/
-     * `'auto'`（列数随容器宽度动态变化，取舍见 `FormColumns`）。
-     *
-     * 多列下每一行都要能独立成格，所以「整行内容」（说明行、卡片组、表格、文本域）记得
-     * 在对应 `Form.Item` 上给 `fullWidth`，否则会被压成一格。
+     * 列数：`1`（默认，逐行）/ `2 ~ 6`（**容器够宽才并排**，窄了按列最小宽度自动回落一列）/ `'auto'`
+     * （列数随容器宽度动态变化，取舍见 `FormColumns`）。多列下「整行内容」（说明行 / 卡片组 / 表格 /
+     * 文本域）记得在对应 `Form.Item` 上给 `fullWidth`，否则会被压成一格。
      */
     columns?: FormColumns;
     /**
-     * 一列的**最小宽度**（px）；缺省取令牌 `--ui-form-column-min`（320 = 「label 120 + 一个还能用的
-     * 输入框」的下限）。
-     *
-     * 它同时是**回落阈值**与**动态列数的除数**：数字档下容器窄于
-     * `N × 最小宽 + (N − 1) × 行距` 就少排一列；动态档下列数 =
-     * `floor((容器宽 + 行距) / (最小宽 + 行距))`。抽屉 / 弹窗里嫌字段太窄就调小（如 280），
-     * 宽页面里嫌列太多就调大（如 380）。
+     * 一列的**最小宽度**（px）；缺省取令牌 `--ui-form-column-min`（320 =「label 120 + 一个还能用的输入框」
+     * 的下限）。它同时是**回落阈值**与**动态列数的除数**：数字档下容器窄于
+     * `N × 最小宽 + (N − 1) × 行距` 就少排一列；动态档下列数 = `floor((容器宽 + 行距) / (最小宽 + 行距))`。
+     * 抽屉 / 弹窗里嫌字段太窄就调小（如 280），宽页面里嫌列太多就调大（如 380）。
      */
     columnMinWidth?: number;
     /**
      * 表单内距（**px 数字**，与 `Panel` 同一口径）：`number` = 四边同值；`{ y, x }` = 上下 / 左右分别给。
-     *
-     * **缺省 0**：表单贴容器边，内距由所在容器给（页面里的表单在 `Panel.Body` 里，那块自带内距）。
-     * 弹窗 / 抽屉里没有别的容器给内距时用它自带 —— 如 `padding={{ y: 16, x: 20 }}`，
-     * 这样就不必再给表单挂一个「只写 padding」的应用侧类。
+     * **缺省 0**（表单贴容器边，内距由所在容器给）；弹窗 / 抽屉里没有别的容器给内距时用它自带
+     * （如 `padding={{ y: 16, x: 20 }}`），这样就不必再挂一个「只写 padding」的应用侧类。
      */
     padding?: FormPadding;
     /** 行距（px，字段行之间 / 与 `Form.Header` 之间）；缺省沿用样式里的 8px 档 */
@@ -180,85 +159,54 @@ export interface FormItemProps {
 /**
  * 表单行（**自建**）：`label + 控件 + 错误 + 说明` 四件。
  *
- * 为什么不封装 farris 的 `FDynamicFormGroup`：那是动态表单（元数据驱动）体系里的分组件 ——
- * 控件要经 `editor` 描述对象交给它渲染，label 宽度 / 控件限宽由 farris 表单类写死
- * （inline 6rem 右对齐、字段 max-width 26.625rem），校验信息走**绝对定位的浮层提示条**。
- * 与本仓三条口径冲突：① 控件由消费方直接写（不构造底层配置对象）；② 数据入参只收朴素业务值；
- * ③ 错误与说明按文档流排布（浮层在弹窗里会压住下一行的控件）。故按「缺件处置流程」自建，
- * 必填星号固定在 label 文本**之后**（`服务名称*`，有意偏离 farris 的「星号在左」）；
- * **label 对齐是维度**（`labelAlign`，
- * 默认 `right`（与 farris / 主流水平表单一致），`left` 时所有 label 起点一致）。
+ * 为什么不封装 farris 的 `FDynamicFormGroup`：那是元数据驱动的动态表单分组件（控件经 `editor` 描述对象
+ * 渲染、label 宽度由 farris 表单类写死、校验信息走绝对定位的浮层提示条），与本仓三条口径冲突：控件由
+ * 消费方直接写、数据入参只收朴素业务值、错误与说明按文档流排布（浮层在弹窗里会压住下一行的控件）。故按
+ * 「缺件处置流程」自建；必填星号固定在 label 文本**之后**（`服务名称*`，有意偏离 farris 的「星号在左」）；
+ * label 对齐是维度（`labelAlign`，默认 `right` 与主流水平表单一致，`left` 时所有 label 起点一致）。
  *
  * ## 宽表单怎么处理（两条杠杆，可叠加）
- *
  * - **限宽**：`controlWidth` 封顶控件列（表单级给默认、逐行可覆盖）—— 单列表单不至于把输入框拉成长条；
- * - **分列**：`columns` 让行并排，宽度用得更充分。档位见 `FormColumns`：
- *   `2 ~ 6` 是**列数上限**（宽够就并排、窄了自动少排一列）；`'auto'` 是**列数随宽度动态变化**。
- *   回落阈值与动态列数都由 `columnMinWidth`（缺省令牌 `--ui-form-column-min` = 320）决定，
- *   **不需要消费方写媒体查询**；多列下「整块内容」记得 `fullWidth`。
+ * - **分列**：`columns` 让行并排（`2 ~ 6` 是**列数上限**，宽够才并排；`'auto'` 是列数随宽度动态变化）。
+ *   回落阈值与动态列数都由 `columnMinWidth`（缺省令牌 `--ui-form-column-min` = 320）决定，**不需要消费方
+ *   写媒体查询**；多列下「整块内容」记得 `fullWidth`。
  *
- * `Form.Item` 是唯一入口（`Form` 只承载表单级设置、行间距/列数与容器内距），
- * 控件从默认插槽进，因此输入框 / 下拉 / 文本域 / 自绘分组卡片共用同一个容器。
+ * `Form.Item` 是唯一入口（`Form` 只承载表单级设置、行间距 / 列数与容器内距），控件从默认插槽进。
  *
  * ## 行内垂直对齐（label 与控件怎么对齐）
- *
- * 对齐参照是**控件那一行**，不是整行：控件列与 label 同处第 1 行，错误 / 说明自然落第 2 行起 ——
- * 所以提示文案的有无与长短都不会带动 label 的位置。规则按控件形态自动切档，消费方零配置：
- *
- * - **单行控件**（输入框 / 选择器 / 开关 / 自绘单行内容）：label 与控件**中线**对齐，**与控件高度无关**
- *   —— 档位切 sm/md/lg、换主题、放自绘控件都自动成立；
- * - **多行与整块内容**（文本域这类样式认得出形态的）：label 与控件**首行文字**对齐，不会落到整块中间；
- * - 样式认不出形态的自绘块（卡片组 / 表格 / 富文本）用 `align="start"` 显式声明；要强制居中用 `align="center"`。
- *
- * **本件不再依赖任何「控件高度」常量**：从前用一个外部注入的高度变量把 label 撑到控件高，
- * 而那个变量在骨架层没有任何出处（回退成 `auto`），于是 label 盒退化成一行文字并贴行顶 ——
- * 输入框中线偏高 6px、大号档偏高 10px、文本域偏高 9px，档位越高错得越多。
+ * 对齐参照是**控件那一行**，不是整行：控件列与 label 同处第 1 行、错误 / 说明自然落第 2 行起 —— 提示文案
+ * 的有无与长短都不会带动 label 的位置。规则按控件形态自动切档、消费方零配置：单行控件 → label 与控件
+ * **中线**对齐（**与控件高度无关**，切档 / 换主题 / 放自绘控件都成立）；多行与整块内容（文本域这类样式
+ * 认得出形态的）→ **首行文字**对齐；样式认不出形态的自绘块（卡片组 / 表格 / 富文本）用 `align="start"`，
+ * 要强制居中用 `align="center"`。
+ * **本件不再依赖任何「控件高度」常量**：从前那个外部注入的高度变量在骨架层没有出处（回退成 `auto`），
+ * label 盒因此退化成一行文字并贴行顶 —— 档位越高错得越多。
  *
  * ## 容器内距（`padding`）
- *
- * 与 `Panel` **同一口径同一实现**（`src/components/part-padding.ts`）：`number` 四边同值、
- * `{ y, x }` 上下 / 左右分别给，缺省 0（贴容器边）。页面里的表单在 `Panel.Body` 里、内距由那块给；
- * **弹窗 / 抽屉里没有别的容器**给内距，就用表单自带的 `padding={{ y: 16, x: 20 }}`。
+ * 与 `Panel` **同一口径同一实现**（`src/components/part-padding.ts`）：`number` 四边同值、`{ y, x }` 分别
+ * 给，缺省 0（贴容器边）。页面里的表单在 `Panel.Body` 里、内距由那块给；**弹窗 / 抽屉里没有别的容器**
+ * 给内距，就用表单自带的 `padding={{ y: 16, x: 20 }}`。
  *
  * ## label 提示（`tip`）
- *
- * 字段名（与必填星号）之后挂一枚问号图标，悬停 / 键盘聚焦弹出说明气泡。它是**按需展开**的补充
- * 解释，不占版面；常驻说明仍归 `hint`（排在控件下方）。两者分工不同，也**不互相替代**。
- *
- * - 图标取 `@manohub/icon` 的 `help`（带圈问号），尺寸随主题图标档（`--ui-font-icon`）；
- * - 图标**排在星号之后**（`服务名称*ⓘ`）—— 与「星号跟着字段名走」同一口径；
- * - 只给 `tip`（无 `label`、非必填）时**同样保留 label 列**（与「只给 required」同一判据），
- *   否则图标没有列可落、静默消失；
- * - 气泡用 `Tooltip` 的 **hover 档**（零 JS）：不吃点击、不抢焦点；代价是 hover 档不进浏览器
- *   顶层浮层，会被祖先 `overflow` 裁切（弹窗 / 抽屉里贴着裁剪边的字段可能看不全）。
+ * 字段名（与必填星号）之后挂一枚问号图标，悬停 / 键盘聚焦弹出说明气泡 —— 按需展开的补充解释、不占版面；
+ * 常驻说明仍归 `hint`（排在控件下方），两者不互相替代。图标取 `help`（带圈问号）字形、尺寸随主题图标档、
+ * **排在星号之后**（`服务名称*ⓘ`）；只给 `tip`（无 `label`、非必填）时**同样保留 label 列**，否则图标
+ * 没有列可落、静默消失。气泡用 `Tooltip` 的 **hover 档**（零 JS、不吃点击、不抢焦点），代价是 hover 档
+ * 不进浏览器顶层浮层，会被祖先 `overflow` 裁切（弹窗 / 抽屉里贴着裁剪边的字段可能看不全）。
  *
  * ## 键盘事件（`onKeydown` 转发到根节点）
- *
- * `onKeydown` 是本件的**声明式入口**（缺省不绑）：传进来的处理器绑在根节点上 ——
- * 本件是 `inheritAttrs: false`，根节点只显式绑 `class` / `style`，不声明的监听器会被静默丢掉。
- * 根节点即「全部字段行的容器」，因此它是「字段区层面的委托」的落点：本包 `Filter` 的
- * 「字段区回车 = 查询」就搭在这里，构造 `Filter` 时**不必**再套一层只为挂事件的壳
- * （那会改变 `class` / `style` 的落点）。要不要拦、拦哪些按键由调用方自己判断，本件只转发。
- * **有意只开这一条**：其它监听器不转发，扩张要先当一次公开行为变更裁决。
+ * `onKeydown` 是本件的**声明式入口**（缺省不绑）：本件是 `inheritAttrs: false`，根节点只显式绑
+ * `class` / `style`，不声明的监听器会被静默丢掉。根节点即「全部字段行的容器」，故它是「字段区层面的委托」
+ * 的落点 —— `Filter` 的「字段区回车 = 查询」就搭在这里，构造 `Filter` 时**不必**再套一层只为挂事件的壳
+ * （那会改变 `class` / `style` 的落点）。要不要拦、拦哪些按键由调用方判断，本件只转发；**有意只开这一条**，
+ * 其它监听器不转发，扩张要先当一次公开行为变更裁决。
  *
  * ## 只读值（摘要 / 详情）
- *
- * 「向导最后一步的确认摘要」「详情弹窗」不需要另起一套描述列表件 —— 只用表单行本身，
- * label 列宽、行距、错误与说明全部复用。控件位放**只读 + 无框**的输入框即可（本件不给
- * 「静态文本」形态：那套几何与输入框迟早会漂开 —— 从前它没有高度与内距，值文字既不在
- * 输入框那条竖线上、也不在同一条中线上）：
- *
- * ```tsx
- * <Form.Item label="创建人" readonly>
- *   <Input model-value={row.creator || '—'} readonly bordered={false} />
- * </Form.Item>
- * ```
- *
- * - **几何与可编辑行完全一致**：值文字与输入框内的值同高、同左缘、同中线，混排时节奏整齐；
- * - **没有「可编辑」的线索**：不显悬停底色、不给聚焦边框与主色环，但仍可点进去选中 / 复制；
- * - **空值占位归业务**：组件不再替你把 `''` 显示成 `—`，按上面的写法自己拼；
- * - **label 弱化**：传 `readonly` 把 label 降一档次要色，字段名与取值一眼分得开；
- * - 控件位是徽标 / 链接这类**非文本**只读内容时同样传 `readonly`：内容直接走默认插槽。
+ * 「向导最后一步的确认摘要」「详情弹窗」不需要另起一套描述列表件 —— 只用表单行本身（label 列宽 / 行距 /
+ * 错误与说明全部复用），控件位放**只读 + 无框**的输入框即可（本件不给「静态文本」形态：那套几何与输入框
+ * 迟早会漂开）。几何与可编辑行完全一致；没有「可编辑」的线索（不显悬停底色、不给聚焦框与主色环，仍可点
+ * 进去选中 / 复制）；**空值占位归业务**（组件不替你把 `''` 显示成 `—`）；传 `readonly` 把 label 降一档
+ * 次要色；控件位是徽标 / 链接这类**非文本**只读内容时同样传 `readonly`，内容直接走默认插槽。
  *
  * @example
  * <Form labelWidth={120} columns={2}>

package/dist/components/input/index.d.ts

@@ -57,11 +57,10 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
         default: string;
     };
     /**
-     * 占位文案。两种形态都消费它：
-     * - 缺省（`as="input"`）走原生 `::placeholder` 伪元素；
-     * - 触发器形态（`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载
-     *   （`.mh-input__placeholder`）—— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，
-     *   并**取代** `default` 插槽（见上面触发器一节）。没传 `hasValue` 的调用方行为不变。
+     * 占位文案（两种形态都消费它）：缺省（`as="input"`）走原生 `::placeholder` 伪元素；触发器形态
+     * （`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载（`.mh-input__placeholder`）
+     * —— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，并**取代** `default` 插槽。没传 `hasValue`
+     * 的调用方行为不变。
      */
     placeholder: {
         type: StringConstructor;
@@ -82,11 +81,9 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
         default: boolean;
     };
     /**
-     * **只读**：值可选中 / 复制，但不能改。
-     *
-     * 与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显业务值，也是 `Form.Item`
-     * 的 `readonly` 行推荐的写法）：几何与可编辑输入框**完全一致**（同高、同内距、值文字同左缘），
-     * 但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
+     * **只读**：值可选中 / 复制，但不能改。与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显
+     * 业务值，也是 `Form.Item` 的 `readonly` 行推荐写法）：几何与可编辑输入框**完全一致**（同高 / 同内距 /
+     * 值文字同左缘），但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
      * 只读 ≠ 禁用：它照旧可聚焦、可选中复制，也不变灰。
      */
     readonly: {
@@ -184,11 +181,10 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
         default: string;
     };
     /**
-     * 占位文案。两种形态都消费它：
-     * - 缺省（`as="input"`）走原生 `::placeholder` 伪元素；
-     * - 触发器形态（`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载
-     *   （`.mh-input__placeholder`）—— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，
-     *   并**取代** `default` 插槽（见上面触发器一节）。没传 `hasValue` 的调用方行为不变。
+     * 占位文案（两种形态都消费它）：缺省（`as="input"`）走原生 `::placeholder` 伪元素；触发器形态
+     * （`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载（`.mh-input__placeholder`）
+     * —— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，并**取代** `default` 插槽。没传 `hasValue`
+     * 的调用方行为不变。
      */
     placeholder: {
         type: StringConstructor;
@@ -209,11 +205,9 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
         default: boolean;
     };
     /**
-     * **只读**：值可选中 / 复制，但不能改。
-     *
-     * 与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显业务值，也是 `Form.Item`
-     * 的 `readonly` 行推荐的写法）：几何与可编辑输入框**完全一致**（同高、同内距、值文字同左缘），
-     * 但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
+     * **只读**：值可选中 / 复制，但不能改。与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显
+     * 业务值，也是 `Form.Item` 的 `readonly` 行推荐写法）：几何与可编辑输入框**完全一致**（同高 / 同内距 /
+     * 值文字同左缘），但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
      * 只读 ≠ 禁用：它照旧可聚焦、可选中复制，也不变灰。
      */
     readonly: {
@@ -524,11 +518,10 @@ export declare const InputCompound: {
             default: string;
         };
         /**
-         * 占位文案。两种形态都消费它：
-         * - 缺省（`as="input"`）走原生 `::placeholder` 伪元素；
-         * - 触发器形态（`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载
-         *   （`.mh-input__placeholder`）—— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，
-         *   并**取代** `default` 插槽（见上面触发器一节）。没传 `hasValue` 的调用方行为不变。
+         * 占位文案（两种形态都消费它）：缺省（`as="input"`）走原生 `::placeholder` 伪元素；触发器形态
+         * （`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载（`.mh-input__placeholder`）
+         * —— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，并**取代** `default` 插槽。没传 `hasValue`
+         * 的调用方行为不变。
          */
         placeholder: {
             type: StringConstructor;
@@ -549,11 +542,9 @@ export declare const InputCompound: {
             default: boolean;
         };
         /**
-         * **只读**：值可选中 / 复制，但不能改。
-         *
-         * 与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显业务值，也是 `Form.Item`
-         * 的 `readonly` 行推荐的写法）：几何与可编辑输入框**完全一致**（同高、同内距、值文字同左缘），
-         * 但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
+         * **只读**：值可选中 / 复制，但不能改。与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显
+         * 业务值，也是 `Form.Item` 的 `readonly` 行推荐写法）：几何与可编辑输入框**完全一致**（同高 / 同内距 /
+         * 值文字同左缘），但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
          * 只读 ≠ 禁用：它照旧可聚焦、可选中复制，也不变灰。
          */
         readonly: {
@@ -685,11 +676,10 @@ export declare const InputCompound: {
             default: string;
         };
         /**
-         * 占位文案。两种形态都消费它：
-         * - 缺省（`as="input"`）走原生 `::placeholder` 伪元素；
-         * - 触发器形态（`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载
-         *   （`.mh-input__placeholder`）—— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，
-         *   并**取代** `default` 插槽（见上面触发器一节）。没传 `hasValue` 的调用方行为不变。
+         * 占位文案（两种形态都消费它）：缺省（`as="input"`）走原生 `::placeholder` 伪元素；触发器形态
+         * （`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载（`.mh-input__placeholder`）
+         * —— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，并**取代** `default` 插槽。没传 `hasValue`
+         * 的调用方行为不变。
          */
         placeholder: {
             type: StringConstructor;
@@ -710,11 +700,9 @@ export declare const InputCompound: {
             default: boolean;
         };
         /**
-         * **只读**：值可选中 / 复制，但不能改。
-         *
-         * 与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显业务值，也是 `Form.Item`
-         * 的 `readonly` 行推荐的写法）：几何与可编辑输入框**完全一致**（同高、同内距、值文字同左缘），
-         * 但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
+         * **只读**：值可选中 / 复制，但不能改。与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显
+         * 业务值，也是 `Form.Item` 的 `readonly` 行推荐写法）：几何与可编辑输入框**完全一致**（同高 / 同内距 /
+         * 值文字同左缘），但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
          * 只读 ≠ 禁用：它照旧可聚焦、可选中复制，也不变灰。
          */
         readonly: {
@@ -837,11 +825,10 @@ export declare const InputCompound: {
         default: string;
     };
     /**
-     * 占位文案。两种形态都消费它：
-     * - 缺省（`as="input"`）走原生 `::placeholder` 伪元素；
-     * - 触发器形态（`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载
-     *   （`.mh-input__placeholder`）—— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，
-     *   并**取代** `default` 插槽（见上面触发器一节）。没传 `hasValue` 的调用方行为不变。
+     * 占位文案（两种形态都消费它）：缺省（`as="input"`）走原生 `::placeholder` 伪元素；触发器形态
+     * （`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载（`.mh-input__placeholder`）
+     * —— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，并**取代** `default` 插槽。没传 `hasValue`
+     * 的调用方行为不变。
      */
     placeholder: {
         type: StringConstructor;
@@ -862,11 +849,9 @@ export declare const InputCompound: {
         default: boolean;
     };
     /**
-     * **只读**：值可选中 / 复制，但不能改。
-     *
-     * 与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显业务值，也是 `Form.Item`
-     * 的 `readonly` 行推荐的写法）：几何与可编辑输入框**完全一致**（同高、同内距、值文字同左缘），
-     * 但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
+     * **只读**：值可选中 / 复制，但不能改。与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显
+     * 业务值，也是 `Form.Item` 的 `readonly` 行推荐写法）：几何与可编辑输入框**完全一致**（同高 / 同内距 /
+     * 值文字同左缘），但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
      * 只读 ≠ 禁用：它照旧可聚焦、可选中复制，也不变灰。
      */
     readonly: {

package/dist/components/input/index.js

@@ -16,11 +16,10 @@ const Input = /* @__PURE__ */ defineComponent({
       default: ""
     },
     /**
-     * 占位文案。两种形态都消费它：
-     * - 缺省（`as="input"`）走原生 `::placeholder` 伪元素；
-     * - 触发器形态（`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载
-     *   （`.mh-input__placeholder`）—— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，
-     *   并**取代** `default` 插槽（见上面触发器一节）。没传 `hasValue` 的调用方行为不变。
+     * 占位文案（两种形态都消费它）：缺省（`as="input"`）走原生 `::placeholder` 伪元素；触发器形态
+     * （`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载（`.mh-input__placeholder`）
+     * —— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，并**取代** `default` 插槽。没传 `hasValue`
+     * 的调用方行为不变。
      */
     placeholder: {
       type: String,
@@ -41,11 +40,9 @@ const Input = /* @__PURE__ */ defineComponent({
       default: false
     },
     /**
-     * **只读**：值可选中 / 复制，但不能改。
-     *
-     * 与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显业务值，也是 `Form.Item`
-     * 的 `readonly` 行推荐的写法）：几何与可编辑输入框**完全一致**（同高、同内距、值文字同左缘），
-     * 但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
+     * **只读**：值可选中 / 复制，但不能改。与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显
+     * 业务值，也是 `Form.Item` 的 `readonly` 行推荐写法）：几何与可编辑输入框**完全一致**（同高 / 同内距 /
+     * 值文字同左缘），但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
      * 只读 ≠ 禁用：它照旧可聚焦、可选中复制，也不变灰。
      */
     readonly: {

package/dist/components/page/index.d.ts

@@ -3,40 +3,33 @@ import { type Padding } from '../part-padding';
 /**
  * 页面骨架复合件 —— 页面结构与滚动归属的统一契约。
  *
- * 滚动契约写死在 `.mh-page*` 样式：Header / Filter / Footer 不滚；
- * Body 只管**页面级**滚动归属，只有两档：`mode="scroll"` 自身滚（长内容页）、
- * `mode="plain"`（默认）不滚 —— 滚动下沉到区域内容区或内容件自持的定高容器。
- * **表格不靠 Body 的 mode 表达**：外框由 `Table` 的 `framed` 档给，高度与滚动由
- * 承载它的内容件承担（`Panel.Body`，或表格件自带的定高容器）。
+ * 滚动契约写死在 `.mh-page*` 样式：Header / Filter / Footer 不滚；Body 只管**页面级**滚动归属，只有两档：
+ * `mode="scroll"` 自身滚（长内容页）、`mode="plain"`（默认）不滚（滚动下沉到区域内容区或内容件自持的定高
+ * 容器）。**表格不靠 Body 的 mode 表达**：外框由 `Table` 的 `framed` 档给，高度与滚动由承载它的内容件承担
+ * （`Panel.Body`，或表格件自带的定高容器）。
  *
- * **Split 不滚，栏内滚动由内容承担** —— 双栏内部用 `Panel`
- * （Header 固定 + Body `overflow:auto`）承载各自区域的滚动。
+ * **Split 不滚，栏内滚动由内容承担** —— 双栏内部用 `Panel`（Header 固定 + Body `overflow:auto`）承载各自
+ * 区域的滚动。
  *
- * 与 `Panel` 的分工：本件是**页面级**（唯一），管页头规格、页脚固定、页面级滚动归属；
- * `Panel` 是**区域级**（可多个），只管区域内的三件与区域内滚动。分页归属跟承载表格的容器走。
+ * 与 `Panel` 的分工：本件是**页面级**（唯一），管页头规格 / 页脚固定 / 页面级滚动归属；`Panel` 是**区域级**
+ * （可多个），只管区域内的三件与区域内滚动。分页归属跟承载表格的容器走。
  *
- * **侧栏能力（内建，缺省开启，无需消费方配置）**：
- * - 分隔线即拖拽手柄：按住左右拖即改宽，夹在 `minWidth`（缺省 160）与 `maxWidth`（缺省 480）之间；
- * - 手柄上悬停显形一个箭头按钮，点击收起侧栏；收起后页面边缘常驻 16px 展开把手，点击展开并恢复收起前的宽度
- *   —— 展开按钮**占满整条把手**（全高全宽 + 描边 + 底），收起态里它是整块侧栏唯一看得见的东西；
- * - `width` 只是**初始宽度**：拖拽结果不持久化（刷新 / 重进回到初始宽度），收起也不清拖出的宽度；
- * - **宽度过渡期间内容不重排**：内容按展开时的宽度定宽（组件下发 `--mh-page-split-frozen`），
- *   多出的部分由容器裁掉 —— 栏内滚动容器不会因宽度被压缩而闪出滚动条；
- * - 左侧栏用 `sidebar`、右侧栏用 `rightSidebar`（互为镜像：分隔线在侧栏左侧、拖拽方向相反），
- *   两者可同时存在构成三栏；某侧传 `resizable: false` 时该侧不渲染手柄与把手。
+ * **侧栏能力（内建，缺省开启）**：分隔线即拖拽手柄（按住左右拖即改宽，夹在 `minWidth` 缺省 160 与
+ * `maxWidth` 缺省 480 之间）；手柄悬停显形一个箭头按钮，点击收起侧栏，收起后页面边缘常驻 16px 展开把手
+ * （**占满整条把手**：全高全宽 + 描边 + 底），点击展开并恢复收起前的宽度；`width` 只是**初始宽度**（拖拽
+ * 结果不持久化，收起也不清拖出的宽度）；**宽度过渡期间内容不重排**（内容按展开时的宽度定宽，组件下发
+ * `--mh-page-split-frozen`，多出的部分由容器裁掉，栏内滚动容器不会闪出滚动条）；左侧栏 `sidebar`、右侧栏
+ * `rightSidebar`（互为镜像），两者可同时存在构成三栏，某侧传 `resizable: false` 则不渲染手柄与把手。
  *
- * 两级滚动归属（契约）：
- * - `Page.Body.mode` 管**页面级**（scroll/plain，全页唯一）；
- * - `Panel.Body` 管**区域内**（Header 固定 / 内容滚）。
+ * 两级滚动归属（契约）：`Page.Body.mode` 管**页面级**（scroll / plain，全页唯一）；`Panel.Body` 管**区域内**。
  *
- * **成员位置固定（归位）**：成员不按书写顺序渲染 —— 以本件为根，一律归到固定位置，
- * 于是「读代码的顺序」不必等于「视觉顺序」（页脚写最前面也仍在底部）：
- * - **页面级行**：`Filter → Header → Body → Footer`（与 `Panel` 同款归位法）；
- * - **主体区**：自由内容（含直接写在根下的 `Page.Split`）—— 没写显式 `Page.Body` 时
- *   自动包一层 `Page.Body`（缺省 `mode="plain"`），所以双栏可以只写 `Page.Split`。
+ * **成员位置固定（归位）**：成员不按书写顺序渲染 —— 以本件为根一律归到固定位置，故「读代码的顺序」不必
+ * 等于「视觉顺序」（页脚写最前面也仍在底部）：页面级行 = `Filter → Header → Body → Footer`（与 `Panel`
+ * 同款归位法）；主体区自由内容（含直接写在根下的 `Page.Split`）没写显式 `Page.Body` 时自动包一层
+ * （缺省 `mode="plain"`），所以双栏可以只写 `Page.Split`。
  *
- * 页头右侧的自由位（搜索框 / 按钮 / 等）是 `Page.Header` 的 `extra` 位（属性或插槽），
- * 没有独立的成员件：那个位置只有页头一个承载者，写成成员等于给它加一层没有意义的转发。
+ * 页头右侧的自由位（搜索框 / 按钮 / 等）是 `Page.Header` 的 `extra` 位（属性或插槽），**没有独立的成员件**：
+ * 那个位置只有页头一个承载者，写成成员等于给它加一层没有意义的转发。
  *
  * @example
  * // 模板 A：列表页（页头 + 表格 + 页脚分页）

package/dist/components/panel/index.d.ts

@@ -22,17 +22,15 @@ import { type Padding } from '../part-padding';
  *
  * ## 分页归属（**跟承载表格的容器走**）
  *
- * 分页条不按「页面」决定位置，而按**表格所在容器**：
- * - 表格在 `Panel` 里（区域级列表）→ 放 `Panel.Footer`（面板内表 + 分页是一个整体，面板体滚动、分页常驻）；
- * - 表格直接挂在 页面主体 下（页面级列表）→ 放 页面页脚。
- * 把区域列表的分页提到 页面页脚（或把页面级分页塞进面板）都属于错位。
+ * 分页条不按「页面」决定位置，而按**表格所在容器**：表格在 `Panel` 里（区域级列表）→ 放 `Panel.Footer`
+ * （面板内表 + 分页是一个整体，面板体滚动、分页常驻）；表格直接挂在页面主体下（页面级列表）→ 放页面页脚。
+ * 把区域列表的分页提到页面页脚（或把页面级分页塞进面板）都属于错位。
  *
  * ## 无框契约
  *
- * `Panel` 自身**不加描边、不加圆角、不加阴影、不设独立底色、不加单侧边框** ——
- * 分区感只由 Header 下方的 1px 分隔线提供（与 `.mh-page__header` 同一手法）；
- * 两栏之间的竖直分隔线由 `Page` 提供。
- * 需要卡片外观时由**内容件**承载（表格用 `表格.framed`），业务侧不得给面板补描边/圆角/阴影。
+ * `Panel` 自身**不加描边 / 圆角 / 阴影 / 独立底色 / 单侧边框** —— 分区感只由 Header 下方的 1px 分隔线提供
+ * （与 `.mh-page__header` 同一手法）；两栏之间的竖直分隔线由 `Page` 提供。需要卡片外观时由**内容件**承载
+ * （表格用 `framed`），业务侧不得给面板补描边 / 圆角 / 阴影。
  *
  * ## 内距（`padding`）
  *

package/dist/components/radio/index.d.ts

@@ -1,22 +1,19 @@
 import { type PropType, type SlotsType, type VNodeChild } from 'vue';
 import type { ControlSize } from '../control-size';
 /**
- * 单选族（一个文件三成员，对应面 `styles/components/radio.css` 的两段）：
+ * 单选族（一个文件三成员，对应面 `styles/components/radio.css` 的两段）：`Radio`（单个选项 —— 原生路径的
+ * 受控叶，`checked` 由使用方算）、`Radio.Group`（普通单选组 —— 一行一项，横排 16 / 纵排 12）、
+ * `Radio.Card`（卡片式单选组 —— 一个选项一张卡、整卡可点）。
  *
- * - `Radio`：单个选项（原生路径的受控叶，`checked` 由使用方算）
- * - `Radio.Group`：普通单选组 —— 一行一项，横排 16 / 纵排 12
- * - `Radio.Card`：卡片式单选组 —— 一个选项一张卡、整卡可点
+ * **判据**：选项只有一行文字 → `Radio.Group`；选项要「标题 + 说明」且整卡可点 → `Radio.Card`；要按钮形态的
+ * 分组 → `Capsule`（本族不重复造按钮档）。
  *
- * **判据**：选项只有一行文字 → `Radio.Group`；选项要「标题 + 说明」且整卡可点 → `Radio.Card`；
- * 要按钮形态的分组 → `Capsule`（本族不重复造按钮档）。
- *
- * **受控口径（族内统一）**：两个组都是「受控传 `modelValue`，不传即非受控（由 `defaultValue` 起）」，
- * 选中上报 `emit('update:modelValue')`（`v-model` 落地）+ `onChange` 双走 —— 与 `Capsule` /
- * `Checkbox.Group` 同一份口径，故 `v-model` 是本族的推荐写法。
- *
- * **单选组必须有值**：`modelValue` 与非受控初值都没给时，落到**第一个可选项**（跳过禁用项）——
- * 单选语义就是必选其一，与 `Tabs` 的「缺省第一项」同口径；没有可选项（表为空或全禁用）才是空值。
- * 自排插槽（`Radio.Group` 不给 `options`）时组件无从推断有哪些值，缺省值由消费方自定。
+ * **受控口径（族内统一）**：两个组都是「受控传 `modelValue`，不传即非受控（由 `defaultValue` 起）」，选中
+ * 上报 `emit('update:modelValue')` + `onChange` 双走 —— 与 `Capsule` / `Checkbox.Group` 同一份口径，故
+ * `v-model` 是本族的推荐写法。
+ * **单选组必须有值**：`modelValue` 与非受控初值都没给时落到**第一个可选项**（跳过禁用项）—— 单选语义就是
+ * 必选其一，与 `Tabs` 的「缺省第一项」同口径；没有可选项（表为空或全禁用）才是空值。自排插槽
+ * （`Radio.Group` 不给 `options`）时组件无从推断有哪些值，缺省值由消费方自定。
  *
  * 状态表达不统一是**有意的**（各自贴着自己的面）：`Radio` 走原生 `input:checked + .mh-radio__box`
  * （故 **input 必须紧邻框体之前**），`Radio.Card` 走卡片上的 `data-state`（卡片就是 label，圆点在卡内）。