@manohub/ui 1.0.4 → 1.0.6

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';
 /**
@@ -7,14 +7,14 @@ export type DialogTone = 'info' | 'success' | 'warning' | 'error';
  *
  * ## JS 只做「原生做不到的那两件」
  *
- * 模态语义、Esc、焦点陷阱、`::backdrop` 遮罩、top layer 渲染 —— 都是浏览器给 `<dialog>` 的原生能力，
- * 本件**不自建浮层**（不做定位计算、不做 focus trap、不写遮罩层），只做：
- * ① 把**受控的 `open` 同步到原生 API**（`open` 变真 → `showModal()`，变假 → `close()`）；
- * ② 内建底栏的「确定」在 `onOk` 返回 Promise 时自动进加载态并吞重复点击。
+ * 模态语义、Esc、焦点陷阱、`::backdrop` 遮罩、top layer 渲染都是浏览器给 `<dialog>` 的原生能力，本件
+ * **不自建浮层**（不做定位计算、不做 focus trap、不写遮罩层），只做：① 把**受控的 `open` 同步到原生 API**
+ * （`open` 变真 → `showModal()`，变假 → `close()`）；② 内建底栏的「确定」在 `onOk` 返回 Promise 时自动进
+ * 加载态并吞重复点击。
  *
  * ## 关闭是受控的
  *
- * 关闭位、Esc（原生 `cancel` 事件）与点遮罩都只回调：`update:open(false)` + `onClose()` / `onCancel()`。
+ * 关闭位、Esc（原生 `cancel` 事件）与点遮罩都只回调（`update:open(false)` + `onClose()` / `onCancel()`）；
  * 可见性归消费方 —— 避免「组件自己消失、业务状态还以为开着」两套口径。
  *
  * ## 底栏三态（**由消费方按需选一**，不要混着用）
@@ -25,16 +25,7 @@ export type DialogTone = 'info' | 'success' | 'warning' | 'error';
  * | 给 `okText` / `onOk` | 内建底栏：`[取消] [确定]`，按钮就是本包 `Button` |
  * | `:show-footer="false"` | 不渲染底栏（纯提示 / 只有关闭位） |
  *
- * @example 内建底栏（最常用）
- * <Dialog v-model:open="visible" title="删除确认" ok-text="删除" :on-ok="remove" :on-cancel="() => (visible = false)">
- *   删除后不可恢复，确认继续？
- * </Dialog>
- *
- * @example 自绘底栏
- * <Dialog v-model:open="visible" title="详情">
- *   正文
- *   <template #footer><Button variant="text" @click="visible = false">关闭</Button></template>
- * </Dialog>
+ * 用法见 `docs/demos/dialog/`（每个维度一份可运行样例；文档页 `docs/components/dialog.md`）。
  */
 export declare const Dialog: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     /** 受控开合 */
@@ -56,7 +47,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 +154,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/divider/index.d.ts

@@ -16,18 +16,7 @@ export interface DividerProps {
  * `vertical` 档的高度走 `align-self: stretch`：父级是 flex 行时自动占满整行高；
  * 父级没有确定高度时退到 `1em`（不会塌成 0）。
  *
- * @example 水平分隔（筛选区与内容之间）
- * <Divider />
- *
- * @example 带中段文字
- * <Divider label="高级筛选" />
- *
- * @example 左侧树栏与主栏之间的一条竖线
- * <div style="display:flex">
- *   <aside>…</aside>
- *   <Divider direction="vertical" />
- *   <main>…</main>
- * </div>
+ * 用法见 `docs/demos/divider/`（每个维度一份可运行样例；文档页 `docs/components/divider.md`）。
  */
 export declare const Divider: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     direction: {

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

@@ -6,18 +6,16 @@ export type DrawerSide = 'left' | 'right';
  *
  * ## 与 `Dialog` 的关系：同一套行为，只换落位
  *
- * 模态语义、Esc、焦点陷阱、`::backdrop` 遮罩、top layer 渲染都是**原生 `<dialog>`** 给的，
- * 本件因此与 `Dialog` 共用同一条「JS 只做原生做不到的那两件」的取舍：
- * ① 把受控的 `open` 同步到原生 API（`open` 变真 → `showModal()`，变假 → `close()`）；
- * ② 内建底栏的「确定」在 `onOk` 返回 Promise 时自动进加载态并吞重复点击。
+ * 模态语义、Esc、焦点陷阱、`::backdrop` 遮罩、top layer 渲染都是**原生 `<dialog>`** 给的，本件因此与
+ * `Dialog` 共用同一条「JS 只做原生做不到的那两件」的取舍：① 把受控的 `open` 同步到原生 API（真 →
+ * `showModal()`，假 → `close()`）；② 内建底栏的「确定」在 `onOk` 返回 Promise 时自动进加载态并吞重复点击。
  * 差异只有一条：本件贴屏幕某一侧、**整屏高**，而不是视口居中。
- *
- * **不另开一套浮层机制**：抽屉不是「新的定位体系」，是同一张面板换个落位 ——
- * 所以类名同样并列 `.mh-popup`（操作层状态根）+ 本族皮肤，开合、遮罩、UA 装饰归零全部免费继承。
+ * **不另开一套浮层机制**：抽屉不是「新的定位体系」，是同一张面板换个落位 —— 故类名同样并列 `.mh-popup`
+ * （操作层状态根）+ 本族皮肤，开合 / 遮罩 / UA 装饰归零全部免费继承。
  *
  * ## 关闭是受控的
  *
- * 关闭位、Esc（原生 `cancel` 事件）与点遮罩都只回调：`update:open(false)` + `onClose()` / `onCancel()`。
+ * 关闭位、Esc（原生 `cancel` 事件）与点遮罩都只回调（`update:open(false)` + `onClose()` / `onCancel()`）；
  * 可见性归消费方 —— 避免「组件自己消失、业务状态还以为开着」两套口径。
  *
  * ## 底栏三态（**由消费方按需选一**，不要混着用）
@@ -28,13 +26,7 @@ export type DrawerSide = 'left' | 'right';
  * | 给 `okText` / `onOk` | 内建底栏：`[取消] [确定]`，按钮就是本包 `Button` |
  * | `:show-footer="false"` | 不渲染底栏（纯展示抽屉） |
  *
- * @example 内建底栏
- * <Drawer v-model:open="visible" title="MCP 配置" width={640} :on-ok="save" :on-cancel="() => (visible = false)">
- *   …抽屉内容…
- * </Drawer>
- *
- * @example 右侧属性面板（窄、无底栏、自绘关闭位）
- * <Drawer v-model:open="visible" title="属性" :width="320" :show-footer="false">…</Drawer>
+ * 用法见 `docs/demos/drawer/`（每个维度一份可运行样例；文档页 `docs/components/drawer.md`）。
  */
 export declare const Drawer: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     /** 受控开合 */

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

@@ -1,36 +1,29 @@
 import { type PropType, type SlotsType, type VNodeChild } from 'vue';
 /**
  * 条件值：单值（文本 / 单选）或数组（多选）。数字与字符串同等对待（取值原样透传）。
+ *
+ * 用法见 `docs/demos/filter/`（每个维度一份可运行样例；文档页 `docs/components/filter.md`）。
  */
 export type FilterValue = string | number | Array<string | number>;
 /** 条件快照：`条件名 → 值`（未选条件的值为空串，语义是「不过滤」） */
 export type FilterValues = Record<string, FilterValue>;
 /**
- * 「全部」哨兵：选项值等于它即「不过滤」。
- *
- * 与既有查询方案（骨架层的筛选适配件）同词，便于迁移时**选项表原样搬运**；
- * 自绘场景更推荐直接用 `placeholder="全部"` 表达未选（本包 `Select` 把空串视为未选中，
- * 会显示占位文案）—— 两条路子的最终视觉一致，见 `docs/components/filter.md`。
+ * 「全部」哨兵：选项值等于它即「不过滤」。与既有查询方案（骨架层的筛选适配件）同词，便于迁移时**选项表原样搬运**；
+ * 自绘场景更推荐直接用 `placeholder="全部"` 表达未选（本包 `Select` 把空串视为未选中 → 显示占位文案）—— 两条路子
+ * 的最终视觉一致，见 `docs/components/filter.md`。
  */
 export declare const FILTER_ALL = "all";
 /**
- * 筛选时机：
- *
- * - `manual`（缺省）：值变化只回写快照（`onChange`），查询由**回车 / 「筛选」按钮**显式触发
- *   （`onQuery`）—— 适合「几个字段填完再查」的条件区；
- * - `auto`：值变化即查询（发 `onQuery`）—— 适合「改即查」的轻量条件区。
- *   此时**同一次变化不再发 `onChange`**（一个变化只对应一个事件，消费方两处都接也不会查两遍），
- *   且操作区默认不渲染（见 `showReset`）。
- *
- * 两种时机下**值变化都会发 `update:modelValue`**（`v-model` 落地不受时机影响）。
+ * 筛选时机：`manual`（缺省）—— 值变化只回写快照（`onChange`），查询由**回车 / 「筛选」按钮**显式触发
+ * （`onQuery`），适合「几个字段填完再查」的条件区；`auto` —— 值变化即查询（发 `onQuery`），适合「改即查」的轻量
+ * 条件区，此时**同一次变化不再发 `onChange`**（一个变化只对应一个事件，消费方两处都接也不会查两遍），且操作区
+ * 默认不渲染（见 `showReset`）。两种时机下**值变化都会发 `update:modelValue`**（`v-model` 落地不受时机影响）。
  */
 export type FilterTrigger = 'manual' | 'auto';
 /**
- * 筛选字段的作用域插槽：控件由消费方渲染，本件交出**归一后**的当前值。
- *
- * 与 `Form.Item` 的作用域同形，差别只在归一：筛选语义里「未选」一律是空串
- * （`'all'` 哨兵 / `null` / 空数组都归到空串），于是消费方直接把 `value` 绑给控件即可，
- * 不必自己处理哨兵——这是 `Filter.Item` 相对 `Form.Item` 唯一的增量。
+ * 筛选字段的作用域插槽：控件由消费方渲染，本件交出**归一后**的当前值。与 `Form.Item` 的作用域同形，差别只在归一：
+ * 筛选语义里「未选」一律是空串（`'all'` 哨兵 / `null` / 空数组都归到空串），故消费方直接把 `value` 绑给控件即可
+ * —— 这是 `Filter.Item` 相对 `Form.Item` 唯一的增量。
  */
 export interface FilterItemSlotScope {
     /** 当前条件值（已归一：空串 = 未选） */
@@ -41,11 +34,9 @@ export interface FilterItemSlotScope {
     clear: () => void;
 }
 /**
- * 归一（读与写**同一份实现**，两处不各写一套）：
- * - `'all'`（哨兵）/ `''` / `null` / `undefined` → `''`（= 不过滤）；
- * - 数组逐项归一后去空，全空 → `''`；**只剩一项仍是数组**（多选值的类型不降级成标量）；
- * - 数字原样（`0` 是有效值，不是「空」）；
- * - 其余原样（不做 trim：归一不负责改写用户输入）。
+ * 归一（读与写**同一份实现**，两处不各写一套）：`'all'`（哨兵）/ `''` / `null` / `undefined` → `''`（= 不过滤）；
+ * 数组逐项归一后去空、全空 → `''`（**只剩一项仍是数组**，多选值的类型不降级成标量）；数字原样（`0` 是有效值，
+ * 不是「空」）；其余原样（不做 trim：归一不负责改写用户输入）。
  */
 export declare function normalizeFilterValue(value: FilterValue | null | undefined): FilterValue;
 export interface FilterProps {
@@ -53,12 +44,7 @@ export interface FilterProps {
     title?: string;
     /** 标题下的说明小字（透传给 `Form.Header`） */
     description?: string;
-    /**
-     * label 列宽（px），透传给 `Form`。
-     *
-     * **缺省不设**：不传即与 `Form` 一致（取令牌 `--ui-form-label-width`，120）。
-     * 想收窄（筛选条的标签多为四字）就显式传，例如 `labelWidth={68}`。
-     */
+    /** label 列宽（px），透传给 `Form`；**缺省不设**（不传即与 `Form` 一致，取令牌 `--ui-form-label-width` = 120）。想收窄（筛选条标签多为四字）就显式传，如 `labelWidth={68}`。 */
     labelWidth?: number;
     /** 受控条件快照（`条件名 → 值`）；不传即非受控（由 `defaultValue` 起） */
     modelValue?: FilterValues;
@@ -68,15 +54,9 @@ export interface FilterProps {
     queryText?: string;
     /** 「重置」按钮文案 */
     resetText?: string;
-    /**
-     * 是否渲染「重置」按钮 —— **两档的缺省口径不同**（故本项缺省是 `undefined` 而非 `true`）：
-     * `manual` 缺省渲染（`:show-reset="false"` 才隐藏）；`auto` 缺省**不**渲染（显式传 `true` 才留一颗）。
-     */
+    /** 是否渲染「重置」按钮 —— **两档缺省口径不同**（故缺省是 `undefined` 而非 `true`）：`manual` 缺省渲染，`auto` 缺省**不**渲染（显式 `true` 才留一颗）。 */
     showReset?: boolean;
-    /**
-     * 筛选时机：`manual`（缺省）值变化只回写、查询靠「筛选」按钮 / 字段区回车；
-     * `auto` 值变化**即**查询，且操作区默认不渲染（详见组件说明「筛选时机」一节）。
-     */
+    /** 筛选时机：`manual`（缺省）值变化只回写、查询靠「筛选」按钮 / 字段区回车；`auto` 值变化**即**查询，且操作区默认不渲染（详见组件说明「筛选时机」）。 */
     trigger?: FilterTrigger;
     /** 条件值变化（快照已归一）。**`auto` 下不发** —— 同一次变化改走 `onQuery` */
     onChange?: (values: FilterValues) => void;
@@ -106,13 +86,6 @@ export interface FilterItemProps {
  *
  * 字段宽**自适应**：字段区是 `Form` 的多列动态档（`Filter` 传 `columns="auto"`），
  * 故本件只输出 `Form.Item` 自己的类 —— 列宽由那条网格轨道算，换行下来的字段与上一行逐列对齐。
- *
- * @example
- * <Filter.Item code="status" label="授权状态">
- *   {{ default: ({ value, setValue }) => (
- *       <Select options={statusOptions} modelValue={String(value)} placeholder="全部" onChange={setValue} />
- *     ) }}
- * </Filter.Item>
  */
 export declare const FilterItem: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     code: {
@@ -196,14 +169,9 @@ export declare const Filter: {
             default: string;
         };
         /**
-         * 是否渲染「重置」按钮。**缺省值随时机而变**（故本 prop 缺省是 `undefined`，不是 `true`）：
-         *
-         * - `trigger="manual"`（缺省）：缺省**渲染**（只有显式 `:show-reset="false"` 才隐藏）；
-         * - `trigger="auto"`：缺省**不渲染** —— 自动模式下操作区整块让位给字段，
-         *   要留一颗重置按钮就得**显式**写 `show-reset`。
-         *
-         * 自动模式下一键清空的另一条路是各字段自带的清除位（控件自己的 `clearable`），
-         * 或页面级入口（`Form.Header` 的 `extra` 一侧）。
+         * 是否渲染「重置」按钮。**缺省值随时机而变**（故本 prop 缺省是 `undefined`、不是 `true`）：`manual` 缺省**渲染**
+         * （只有显式 `:show-reset="false"` 才隐藏）；`auto` 缺省**不渲染**（操作区整块让位给字段，要留一颗就得**显式**写
+         * `show-reset`）。自动模式下一键清空的另一条路是各字段自带的清除位，或页面级入口。
          */
         showReset: {
             type: BooleanConstructor;
@@ -282,14 +250,9 @@ export declare const Filter: {
             default: string;
         };
         /**
-         * 是否渲染「重置」按钮。**缺省值随时机而变**（故本 prop 缺省是 `undefined`，不是 `true`）：
-         *
-         * - `trigger="manual"`（缺省）：缺省**渲染**（只有显式 `:show-reset="false"` 才隐藏）；
-         * - `trigger="auto"`：缺省**不渲染** —— 自动模式下操作区整块让位给字段，
-         *   要留一颗重置按钮就得**显式**写 `show-reset`。
-         *
-         * 自动模式下一键清空的另一条路是各字段自带的清除位（控件自己的 `clearable`），
-         * 或页面级入口（`Form.Header` 的 `extra` 一侧）。
+         * 是否渲染「重置」按钮。**缺省值随时机而变**（故本 prop 缺省是 `undefined`、不是 `true`）：`manual` 缺省**渲染**
+         * （只有显式 `:show-reset="false"` 才隐藏）；`auto` 缺省**不渲染**（操作区整块让位给字段，要留一颗就得**显式**写
+         * `show-reset`）。自动模式下一键清空的另一条路是各字段自带的清除位，或页面级入口。
          */
         showReset: {
             type: BooleanConstructor;
@@ -361,14 +324,9 @@ export declare const Filter: {
         default: string;
     };
     /**
-     * 是否渲染「重置」按钮。**缺省值随时机而变**（故本 prop 缺省是 `undefined`，不是 `true`）：
-     *
-     * - `trigger="manual"`（缺省）：缺省**渲染**（只有显式 `:show-reset="false"` 才隐藏）；
-     * - `trigger="auto"`：缺省**不渲染** —— 自动模式下操作区整块让位给字段，
-     *   要留一颗重置按钮就得**显式**写 `show-reset`。
-     *
-     * 自动模式下一键清空的另一条路是各字段自带的清除位（控件自己的 `clearable`），
-     * 或页面级入口（`Form.Header` 的 `extra` 一侧）。
+     * 是否渲染「重置」按钮。**缺省值随时机而变**（故本 prop 缺省是 `undefined`、不是 `true`）：`manual` 缺省**渲染**
+     * （只有显式 `:show-reset="false"` 才隐藏）；`auto` 缺省**不渲染**（操作区整块让位给字段，要留一颗就得**显式**写
+     * `show-reset`）。自动模式下一键清空的另一条路是各字段自带的清除位，或页面级入口。
      */
     showReset: {
         type: BooleanConstructor;

package/dist/components/filter/index.js

@@ -51,14 +51,9 @@ const FilterRoot = /* @__PURE__ */ defineComponent({
       default: "重置"
     },
     /**
-     * 是否渲染「重置」按钮。**缺省值随时机而变**（故本 prop 缺省是 `undefined`，不是 `true`）：
-     *
-     * - `trigger="manual"`（缺省）：缺省**渲染**（只有显式 `:show-reset="false"` 才隐藏）；
-     * - `trigger="auto"`：缺省**不渲染** —— 自动模式下操作区整块让位给字段，
-     *   要留一颗重置按钮就得**显式**写 `show-reset`。
-     *
-     * 自动模式下一键清空的另一条路是各字段自带的清除位（控件自己的 `clearable`），
-     * 或页面级入口（`Form.Header` 的 `extra` 一侧）。
+     * 是否渲染「重置」按钮。**缺省值随时机而变**（故本 prop 缺省是 `undefined`、不是 `true`）：`manual` 缺省**渲染**
+     * （只有显式 `:show-reset="false"` 才隐藏）；`auto` 缺省**不渲染**（操作区整块让位给字段，要留一颗就得**显式**写
+     * `show-reset`）。自动模式下一键清空的另一条路是各字段自带的清除位，或页面级入口。
      */
     showReset: {
       type: Boolean,