@manohub/ui 0.7.0 → 0.8.0

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

@@ -68,6 +68,14 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * **只读**：值可选中 / 复制，但不能改。
+     *
+     * 与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显业务值，也是 `Form.Item`
+     * 的 `readonly` 行推荐的写法）：几何与可编辑输入框**完全一致**（同高、同内距、值文字同左缘），
+     * 但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
+     * 只读 ≠ 禁用：它照旧可聚焦、可选中复制，也不变灰。
+     */
     readonly: {
         type: BooleanConstructor;
         default: boolean;
@@ -87,7 +95,10 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
         type: BooleanConstructor;
         default: boolean;
     };
-    /** 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底） */
+    /**
+     * 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底，靠悬停与聚焦给反馈）。
+     * 配 `readonly` 即**只读值档**：连悬停底与聚焦框环都退掉（见 `readonly`）。
+     */
     bordered: {
         type: BooleanConstructor;
         default: boolean;
@@ -167,6 +178,14 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * **只读**：值可选中 / 复制，但不能改。
+     *
+     * 与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显业务值，也是 `Form.Item`
+     * 的 `readonly` 行推荐的写法）：几何与可编辑输入框**完全一致**（同高、同内距、值文字同左缘），
+     * 但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
+     * 只读 ≠ 禁用：它照旧可聚焦、可选中复制，也不变灰。
+     */
     readonly: {
         type: BooleanConstructor;
         default: boolean;
@@ -186,7 +205,10 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
         type: BooleanConstructor;
         default: boolean;
     };
-    /** 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底） */
+    /**
+     * 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底，靠悬停与聚焦给反馈）。
+     * 配 `readonly` 即**只读值档**：连悬停底与聚焦框环都退掉（见 `readonly`）。
+     */
     bordered: {
         type: BooleanConstructor;
         default: boolean;
@@ -276,6 +298,7 @@ export interface TextareaProps {
     /** 尺寸档 */
     size?: ControlSize;
     disabled?: boolean;
+    /** 只读（配 `bordered={false}` 即只读值档，口径见 `Input` 的同名 prop） */
     readonly?: boolean;
     /** 校验态（下发 `aria-invalid`） */
     invalid?: boolean;
@@ -289,7 +312,15 @@ export interface TextareaProps {
     autofocus?: boolean;
     onChange?: (v: string) => void;
 }
-/** 多行输入（同一份面；结构与单行不同，故单列一个件） */
+/**
+ * 多行输入（同一份面；结构与单行不同，故单列一个件）。
+ *
+ * ⚠️ 本件**没有** `mono` 档（`Input` 有）。要等宽的输入框别拿 `Text mono` 去包 —— 那会丢掉输入能力；
+ * 该写法目前只能保留一条带 `font-family: var(--ui-font-mono)` 的应用侧样式登记（缺口见包内 `docs/kit-gaps.md`）。
+ *
+ * @example 备注框：自适应 2~6 行 + 限长计数
+ * <Textarea modelValue={note} autoSize={{ minRows: 2, maxRows: 6 }} maxlength={500} showCount onChange={setNote} />
+ */
 export declare const Textarea: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     modelValue: {
         type: StringConstructor;
@@ -319,6 +350,7 @@ export declare const Textarea: import("vue").DefineComponent<import("vue").Extra
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 只读：值可选中 / 复制；配 `bordered={false}` 即只读值档（口径见 `Input` 的同名 prop） */
     readonly: {
         type: BooleanConstructor;
         default: boolean;
@@ -382,6 +414,7 @@ export declare const Textarea: import("vue").DefineComponent<import("vue").Extra
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 只读：值可选中 / 复制；配 `bordered={false}` 即只读值档（口径见 `Input` 的同名 prop） */
     readonly: {
         type: BooleanConstructor;
         default: boolean;
@@ -463,6 +496,14 @@ export declare const InputCompound: {
             type: BooleanConstructor;
             default: boolean;
         };
+        /**
+         * **只读**：值可选中 / 复制，但不能改。
+         *
+         * 与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显业务值，也是 `Form.Item`
+         * 的 `readonly` 行推荐的写法）：几何与可编辑输入框**完全一致**（同高、同内距、值文字同左缘），
+         * 但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
+         * 只读 ≠ 禁用：它照旧可聚焦、可选中复制，也不变灰。
+         */
         readonly: {
             type: BooleanConstructor;
             default: boolean;
@@ -482,7 +523,10 @@ export declare const InputCompound: {
             type: BooleanConstructor;
             default: boolean;
         };
-        /** 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底） */
+        /**
+         * 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底，靠悬停与聚焦给反馈）。
+         * 配 `readonly` 即**只读值档**：连悬停底与聚焦框环都退掉（见 `readonly`）。
+         */
         bordered: {
             type: BooleanConstructor;
             default: boolean;
@@ -596,6 +640,14 @@ export declare const InputCompound: {
             type: BooleanConstructor;
             default: boolean;
         };
+        /**
+         * **只读**：值可选中 / 复制，但不能改。
+         *
+         * 与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显业务值，也是 `Form.Item`
+         * 的 `readonly` 行推荐的写法）：几何与可编辑输入框**完全一致**（同高、同内距、值文字同左缘），
+         * 但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
+         * 只读 ≠ 禁用：它照旧可聚焦、可选中复制，也不变灰。
+         */
         readonly: {
             type: BooleanConstructor;
             default: boolean;
@@ -615,7 +667,10 @@ export declare const InputCompound: {
             type: BooleanConstructor;
             default: boolean;
         };
-        /** 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底） */
+        /**
+         * 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底，靠悬停与聚焦给反馈）。
+         * 配 `readonly` 即**只读值档**：连悬停底与聚焦框环都退掉（见 `readonly`）。
+         */
         bordered: {
             type: BooleanConstructor;
             default: boolean;
@@ -720,6 +775,14 @@ export declare const InputCompound: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * **只读**：值可选中 / 复制，但不能改。
+     *
+     * 与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显业务值，也是 `Form.Item`
+     * 的 `readonly` 行推荐的写法）：几何与可编辑输入框**完全一致**（同高、同内距、值文字同左缘），
+     * 但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
+     * 只读 ≠ 禁用：它照旧可聚焦、可选中复制，也不变灰。
+     */
     readonly: {
         type: BooleanConstructor;
         default: boolean;
@@ -739,7 +802,10 @@ export declare const InputCompound: {
         type: BooleanConstructor;
         default: boolean;
     };
-    /** 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底） */
+    /**
+     * 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底，靠悬停与聚焦给反馈）。
+     * 配 `readonly` 即**只读值档**：连悬停底与聚焦框环都退掉（见 `readonly`）。
+     */
     bordered: {
         type: BooleanConstructor;
         default: boolean;
@@ -847,6 +913,7 @@ export declare const InputCompound: {
             type: BooleanConstructor;
             default: boolean;
         };
+        /** 只读：值可选中 / 复制；配 `bordered={false}` 即只读值档（口径见 `Input` 的同名 prop） */
         readonly: {
             type: BooleanConstructor;
             default: boolean;
@@ -910,6 +977,7 @@ export declare const InputCompound: {
             type: BooleanConstructor;
             default: boolean;
         };
+        /** 只读：值可选中 / 复制；配 `bordered={false}` 即只读值档（口径见 `Input` 的同名 prop） */
         readonly: {
             type: BooleanConstructor;
             default: boolean;

package/dist/components/input/index.js

@@ -32,6 +32,14 @@ const Input = /* @__PURE__ */ defineComponent({
       type: Boolean,
       default: false
     },
+    /**
+     * **只读**：值可选中 / 复制，但不能改。
+     *
+     * 与 `bordered={false}` 组合即**只读值档**（摘要 / 详情里回显业务值，也是 `Form.Item`
+     * 的 `readonly` 行推荐的写法）：几何与可编辑输入框**完全一致**（同高、同内距、值文字同左缘），
+     * 但滑过不亮浅底、聚焦不给边框与主色环 —— 一眼看去是「值」而不是「输入位」。
+     * 只读 ≠ 禁用：它照旧可聚焦、可选中复制，也不变灰。
+     */
     readonly: {
       type: Boolean,
       default: false
@@ -51,7 +59,10 @@ const Input = /* @__PURE__ */ defineComponent({
       type: Boolean,
       default: false
     },
-    /** 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底） */
+    /**
+     * 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底，靠悬停与聚焦给反馈）。
+     * 配 `readonly` 即**只读值档**：连悬停底与聚焦框环都退掉（见 `readonly`）。
+     */
     bordered: {
       type: Boolean,
       default: true
@@ -225,6 +236,7 @@ const Textarea = /* @__PURE__ */ defineComponent({
       type: Boolean,
       default: false
     },
+    /** 只读：值可选中 / 复制；配 `bordered={false}` 即只读值档（口径见 `Input` 的同名 prop） */
     readonly: {
       type: Boolean,
       default: false

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

@@ -1,4 +1,5 @@
 import { type PropType, type SlotsType, type VNodeChild } from 'vue';
+import { type Padding } from '../part-padding';
 /**
  * 布局间距档：**只开放令牌档位，不开放任意 px**（`none/sm/md/lg/xl` → `0 / --ui-space-1/2/3/4`）。
  *
@@ -32,7 +33,8 @@ export type LayoutSpan = 1 | 2 | 3 | 4;
  *
  * ## 与其它件的边界
  *
- * - 表单里并排字段用 `Form columns={2}`（它管 label 列与行距），不要用本族拼表单；
+ * - 表单里并排字段用 `Form` 的 `columns`（它管 label 列、行距与**回落**），不要用本族拼表单
+ *   —— 本族的列数是**恒定**的，窄了只等分收窄，表单会被压出不可用的窄控件；
  * - 页面级两栏（各自滚动）用 `Page.Split`；
  * - 只有「块与块怎么摆」这一件事归本族，滚动 / 工具位 / 卡片外观都不归它。
  */
@@ -63,6 +65,20 @@ export declare const Layout: {
             type: NumberConstructor;
             default: undefined;
         };
+        /**
+         * 内距：**走骨架件共享口径**（`Padding`，同 `Card` / `Form` / `Page` / `Panel`）——
+         * `number` 四边同值、`{ y, x }` 分上下 / 左右、`string` 原样下发（CSS 简写，**逃生舱**）。
+         * 口径与理由见 `part-padding.ts`。
+         *
+         * ⚠️ 与 `gap` 不同口径：`gap` 只开放令牌档（防间距分叉），`padding` 接具体值 ——
+         * 内距在设计稿里常是**确定坐标**，令牌梯度（最大 24px）表达不了。
+         * ⚠️ 用它之前先想一次：这个数真是「内距」吗？若是「与某个内容列对齐」这类**布局坐标**，
+         * 优先改由结构表达（同轴容器 / `columns` / `minColumnWidth`）。
+         */
+        padding: {
+            type: PropType<Padding>;
+            default: undefined;
+        };
     }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
         /** 行间距档（默认 `md` 8px；要贴紧写 `none`） */
         gap: {
@@ -89,7 +105,22 @@ export declare const Layout: {
             type: NumberConstructor;
             default: undefined;
         };
+        /**
+         * 内距：**走骨架件共享口径**（`Padding`，同 `Card` / `Form` / `Page` / `Panel`）——
+         * `number` 四边同值、`{ y, x }` 分上下 / 左右、`string` 原样下发（CSS 简写，**逃生舱**）。
+         * 口径与理由见 `part-padding.ts`。
+         *
+         * ⚠️ 与 `gap` 不同口径：`gap` 只开放令牌档（防间距分叉），`padding` 接具体值 ——
+         * 内距在设计稿里常是**确定坐标**，令牌梯度（最大 24px）表达不了。
+         * ⚠️ 用它之前先想一次：这个数真是「内距」吗？若是「与某个内容列对齐」这类**布局坐标**，
+         * 优先改由结构表达（同轴容器 / `columns` / `minColumnWidth`）。
+         */
+        padding: {
+            type: PropType<Padding>;
+            default: undefined;
+        };
     }>> & Readonly<{}>, {
+        padding: Padding;
         justify: LayoutJustify;
         gap: LayoutGap;
         align: LayoutAlign;
@@ -124,6 +155,11 @@ export declare const Layout: {
             type: PropType<LayoutSpan>;
             default: number;
         };
+        /** 内距：口径同 `Layout.Row`（共享 `Padding`，复用 `mergePartStyle`） */
+        padding: {
+            type: PropType<Padding>;
+            default: undefined;
+        };
     }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
         /** 单元内间距档（默认 `md` 8px；要贴紧写 `none`） */
         gap: {
@@ -150,7 +186,13 @@ export declare const Layout: {
             type: PropType<LayoutSpan>;
             default: number;
         };
+        /** 内距：口径同 `Layout.Row`（共享 `Padding`，复用 `mergePartStyle`） */
+        padding: {
+            type: PropType<Padding>;
+            default: undefined;
+        };
     }>> & Readonly<{}>, {
+        padding: Padding;
         wrap: boolean;
         justify: LayoutJustify;
         span: LayoutSpan;

package/dist/components/layout/index.js

@@ -1,4 +1,5 @@
 import { defineComponent, createVNode } from "vue";
+import { mergePartStyle } from "../part-padding.js";
 function modifier(base, name, value) {
   return value === void 0 || value === "" ? "" : `${base}--${name}-${value}`;
 }
@@ -30,6 +31,11 @@ const LayoutColumn = /* @__PURE__ */ defineComponent({
     span: {
       type: Number,
       default: 1
+    },
+    /** 内距：口径同 `Layout.Row`（共享 `Padding`，复用 `mergePartStyle`） */
+    padding: {
+      type: [Number, Object, String],
+      default: void 0
     }
   },
   slots: Object,
@@ -39,7 +45,7 @@ const LayoutColumn = /* @__PURE__ */ defineComponent({
   }) {
     return () => createVNode("div", {
       "class": ["mh-layout-column", modifier("mh-layout-column", "gap", props.gap), modifier("mh-layout-column", "align", props.align), props.justify && props.justify !== "start" ? modifier("mh-layout-column", "justify", props.justify) : "", props.wrap ? "mh-layout-column--wrap" : "", props.span > 1 ? `mh-layout-column--span-${props.span}` : "", attrs.class].filter(Boolean).join(" "),
-      "style": attrs.style
+      "style": mergePartStyle(attrs.style, props.padding)
     }, [slots.default?.()]);
   }
 });
@@ -71,6 +77,20 @@ const LayoutRow = /* @__PURE__ */ defineComponent({
     minColumnWidth: {
       type: Number,
       default: void 0
+    },
+    /**
+     * 内距：**走骨架件共享口径**（`Padding`，同 `Card` / `Form` / `Page` / `Panel`）——
+     * `number` 四边同值、`{ y, x }` 分上下 / 左右、`string` 原样下发（CSS 简写，**逃生舱**）。
+     * 口径与理由见 `part-padding.ts`。
+     *
+     * ⚠️ 与 `gap` 不同口径：`gap` 只开放令牌档（防间距分叉），`padding` 接具体值 ——
+     * 内距在设计稿里常是**确定坐标**，令牌梯度（最大 24px）表达不了。
+     * ⚠️ 用它之前先想一次：这个数真是「内距」吗？若是「与某个内容列对齐」这类**布局坐标**，
+     * 优先改由结构表达（同轴容器 / `columns` / `minColumnWidth`）。
+     */
+    padding: {
+      type: [Number, Object, String],
+      default: void 0
     }
   },
   slots: Object,
@@ -86,7 +106,7 @@ const LayoutRow = /* @__PURE__ */ defineComponent({
       if (props.minColumnWidth) style["--mh-layout-row-min"] = `${props.minColumnWidth}px`;
       return createVNode("div", {
         "class": ["mh-layout-row", modifier("mh-layout-row", "gap", props.gap), modifier("mh-layout-row", "align", props.align), props.justify && props.justify !== "start" ? modifier("mh-layout-row", "justify", props.justify) : "", isGrid ? "mh-layout-row--grid" : "", isGrid ? modifier("mh-layout-row", "columns", props.columns) : "", attrs.class].filter(Boolean).join(" "),
-        "style": style
+        "style": mergePartStyle(style, props.padding)
       }, [slots.default?.()]);
     };
   }

package/dist/components/list-view/index.d.ts

@@ -84,7 +84,7 @@ export interface ListViewProps {
  *
  * 以 `Card interactive` 为壳，卡片外观与悬浮反馈都来自它；本件只管卡片**内部**的排版与几何
  * （最小高 144、图标 36、标题 16/600、描述两行截断、尾部贴底、胶囊与标签片），
- * 几何来源同 `Card`（portal 技能市场卡片实测）。
+ * 几何来源同 `Card`（技能市场卡片实测）。
  *
  * 三处「有意为之」：
  * 1. **操作位默认隐藏**（`opacity: 0`），卡片悬浮或卡内获得焦点时显形；触屏（无 hover 能力）恒显形 ——

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

@@ -136,11 +136,11 @@ export declare const Notice: import("vue").DefineComponent<import("vue").Extract
         default: undefined;
     };
 }>> & Readonly<{}>, {
-    icon: boolean | "filter" | "copy" | "help" | "table" | "menu" | "search" | "link" | "delete" | "image" | "close" | "key" | "page-title" | "loading" | "info" | "alert" | "chevron-left" | "chevron-right" | "chevron-down" | "chevron-up" | "check" | "user" | "download" | "back" | "folder" | "folder-open" | "file" | "file-code" | "file-json" | "file-text" | "terminal" | "shield" | "tool" | "plus" | "notification" | "settings" | "logout" | "home" | "workbench" | "apps" | "favorite" | "favorite-filled" | "drag-handle" | "edit" | "refresh" | "upload" | "save" | "more" | "preview" | "external-link" | "minus" | "plus-circle" | "close-circle" | "list" | "calendar" | "clock" | "lock" | "unlock" | "users" | "archive" | "package" | "plug" | "branch" | "tag" | "ai" | "shield-check" | "shield-alert" | "history";
+    icon: boolean | "search" | "link" | "filter" | "copy" | "help" | "table" | "menu" | "delete" | "image" | "close" | "key" | "page-title" | "loading" | "info" | "alert" | "chevron-left" | "chevron-right" | "chevron-down" | "chevron-up" | "check" | "user" | "download" | "back" | "folder" | "folder-open" | "file" | "file-code" | "file-json" | "file-text" | "terminal" | "shield" | "tool" | "plus" | "notification" | "settings" | "logout" | "home" | "workbench" | "apps" | "favorite" | "favorite-filled" | "drag-handle" | "edit" | "refresh" | "upload" | "save" | "more" | "preview" | "external-link" | "minus" | "plus-circle" | "close-circle" | "list" | "calendar" | "clock" | "lock" | "unlock" | "users" | "archive" | "package" | "plug" | "branch" | "tag" | "ai" | "shield-check" | "shield-alert" | "history";
     onClose: () => void;
     message: string;
-    tone: NoticeTone;
     closable: boolean;
+    tone: NoticeTone;
     description: string;
     action: string;
     closeText: string;

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

@@ -102,11 +102,11 @@ export declare const Notification: import("vue").DefineComponent<import("vue").E
         default: undefined;
     };
 }>> & Readonly<{}>, {
-    icon: boolean | "filter" | "copy" | "help" | "table" | "menu" | "search" | "link" | "delete" | "image" | "close" | "key" | "page-title" | "loading" | "info" | "alert" | "chevron-left" | "chevron-right" | "chevron-down" | "chevron-up" | "check" | "user" | "download" | "back" | "folder" | "folder-open" | "file" | "file-code" | "file-json" | "file-text" | "terminal" | "shield" | "tool" | "plus" | "notification" | "settings" | "logout" | "home" | "workbench" | "apps" | "favorite" | "favorite-filled" | "drag-handle" | "edit" | "refresh" | "upload" | "save" | "more" | "preview" | "external-link" | "minus" | "plus-circle" | "close-circle" | "list" | "calendar" | "clock" | "lock" | "unlock" | "users" | "archive" | "package" | "plug" | "branch" | "tag" | "ai" | "shield-check" | "shield-alert" | "history";
+    icon: boolean | "search" | "link" | "filter" | "copy" | "help" | "table" | "menu" | "delete" | "image" | "close" | "key" | "page-title" | "loading" | "info" | "alert" | "chevron-left" | "chevron-right" | "chevron-down" | "chevron-up" | "check" | "user" | "download" | "back" | "folder" | "folder-open" | "file" | "file-code" | "file-json" | "file-text" | "terminal" | "shield" | "tool" | "plus" | "notification" | "settings" | "logout" | "home" | "workbench" | "apps" | "favorite" | "favorite-filled" | "drag-handle" | "edit" | "refresh" | "upload" | "save" | "more" | "preview" | "external-link" | "minus" | "plus-circle" | "close-circle" | "list" | "calendar" | "clock" | "lock" | "unlock" | "users" | "archive" | "package" | "plug" | "branch" | "tag" | "ai" | "shield-check" | "shield-alert" | "history";
     title: string;
     onClose: () => void;
-    tone: NotificationTone;
     closable: boolean;
+    tone: NotificationTone;
     avatar: string;
     duration: number;
 }, SlotsType<{

package/dist/components/page/index.js

@@ -12,7 +12,7 @@ const PageFilter = /* @__PURE__ */ defineComponent({
   props: {
     /** 内距（px 数字 = 四边同值；`{ y, x }` 分别给）；缺省不落行内样式，沿用 CSS 默认（`14px 20px 0`） */
     padding: {
-      type: [Number, Object],
+      type: [Number, Object, String],
       default: void 0
     }
   },
@@ -49,7 +49,7 @@ const PageHeader = /* @__PURE__ */ defineComponent({
     },
     /** 内距（px 数字 = 四边同值；`{ y, x }` 分别给）；缺省不落行内样式，沿用 CSS 默认（`14px 20px 13px`） */
     padding: {
-      type: [Number, Object],
+      type: [Number, Object, String],
       default: void 0
     }
   },
@@ -107,7 +107,7 @@ const PageBody = /* @__PURE__ */ defineComponent({
       default: "plain"
     },
     padding: {
-      type: [Number, Object],
+      type: [Number, Object, String],
       default: void 0
     }
   },
@@ -128,7 +128,7 @@ const PageFooter = /* @__PURE__ */ defineComponent({
   props: {
     /** 内距（px 数字 = 四边同值；`{ y, x }` 分别给）；缺省不落行内样式，沿用 CSS 默认（`12px 20px`） */
     padding: {
-      type: [Number, Object],
+      type: [Number, Object, String],
       default: void 0
     }
   },

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

@@ -34,7 +34,7 @@ export declare const Pagination: import("vue").DefineComponent<import("vue").Ext
         type: NumberConstructor;
         default: number;
     };
-    /** 当前页（**1 起**） */
+    /** 当前页（**1 起**；接口用 0 基的话在调用方 ±1 换算，别把 0 基值直接接进来） */
     modelValue: {
         type: NumberConstructor;
         default: number;
@@ -96,7 +96,7 @@ export declare const Pagination: import("vue").DefineComponent<import("vue").Ext
         type: NumberConstructor;
         default: number;
     };
-    /** 当前页（**1 起**） */
+    /** 当前页（**1 起**；接口用 0 基的话在调用方 ±1 换算，别把 0 基值直接接进来） */
     modelValue: {
         type: NumberConstructor;
         default: number;

package/dist/components/pagination/index.js

@@ -9,7 +9,7 @@ const Pagination = /* @__PURE__ */ defineComponent({
       type: Number,
       default: 0
     },
-    /** 当前页（**1 起**） */
+    /** 当前页（**1 起**；接口用 0 基的话在调用方 ±1 换算，别把 0 基值直接接进来） */
     modelValue: {
       type: Number,
       default: 1

package/dist/components/panel/index.js

@@ -24,7 +24,7 @@ const PanelHeader = /* @__PURE__ */ defineComponent({
     },
     /** 头这一行的内距（与根件同一口径）；内建头自带 `0 8px` 的内距，本项按需覆盖 */
     padding: {
-      type: [Number, Object],
+      type: [Number, Object, String],
       default: void 0
     }
   },
@@ -70,7 +70,7 @@ const PanelBody = /* @__PURE__ */ defineComponent({
   props: {
     /** 内容区内距（与根件同一口径）；缺省 0 = 内容贴面板边（页面里的区域通常如此） */
     padding: {
-      type: [Number, Object],
+      type: [Number, Object, String],
       default: void 0
     }
   },
@@ -91,7 +91,7 @@ const PanelFooter = /* @__PURE__ */ defineComponent({
   props: {
     /** 页脚内距（与根件同一口径）；缺省 0 = 贴面板边 */
     padding: {
-      type: [Number, Object],
+      type: [Number, Object, String],
       default: void 0
     }
   },
@@ -145,7 +145,7 @@ const PanelRoot = /* @__PURE__ */ defineComponent({
     },
     /** 面板内距（px 数字，或 `{ y, x }`）；缺省 0 = 贴容器边 */
     padding: {
-      type: [Number, Object],
+      type: [Number, Object, String],
       default: void 0
     }
   },

package/dist/components/part-padding.d.ts

@@ -1,20 +1,23 @@
 import type { StyleValue } from 'vue';
 /**
- * 骨架件的**内距**口径（`Panel` 及其三件、`Form` 共用同一套）。
+ * 骨架件的**内距**口径（`Card` / `Form` / `Page` / `Panel` / `Layout` 共用同一套）。
  *
  * - `number` → 四边同值（`padding={16}`）；
  * - `{ y, x }` → 上下 / 左右分别给（`{ y: 12, x: 20 }`，弹窗里的容器常用 —— 与 `Page` 的页面左右内距同档），
- *   **缺哪边就不落哪边的声明**（只给 `y` 时不覆盖消费方在 `style` 里写的左右内距）。
+ *   **缺哪边就不落哪边的声明**（只给 `y` 时不覆盖消费方在 `style` 里写的左右内距）；
+ * - `string` → **原样下发**（CSS 简写，可非对称，如 `'40px 0 0 140px'`）—— **逃生舱**。
  *
- * 为什么是 px 数字而不是 CSS 字符串：几何值在本仓是**设计基准**，不跟根字号
- * （与 `Form.labelWidth` / `表格.rowHeight` 同口径）；要写自适应内距的场合请走 `class`。
+ * 常规用 `number` / `{ y, x }`：几何值在本仓是**设计基准**，不跟根字号
+ * （与 `Form.labelWidth` / `表格.rowHeight` 同口径）。
+ * `string` 只为「令牌梯度与 `{ y, x }` 都表达不了的设计要求」留口（典型：**只给一侧**的非对称坐标）——
+ * 写它等于自己写 CSS，所以**优先级最低**，能不用就不用。
  */
 export type Padding = number | {
     y?: number;
     x?: number;
-};
+} | string;
 /**
- * 内距 → 行内样式。缺省（`undefined`）时返回 `undefined`：**不额外产生 style 属性**，
+ * 内距 → 行内样式。缺省（`undefined` / 空串）时返回 `undefined`：**不额外产生 style 属性**，
  * DOM 与「没有这个维度」时完全一致。
  */
 export declare function partPaddingStyle(padding: Padding | undefined): StyleValue | undefined;

package/dist/components/part-padding.js

@@ -1,6 +1,7 @@
 function partPaddingStyle(padding) {
-  if (padding === void 0) return void 0;
+  if (padding === void 0 || padding === "") return void 0;
   if (typeof padding === "number") return { padding: `${padding}px` };
+  if (typeof padding === "string") return { padding };
   const style = {};
   if (padding.y !== void 0) {
     style.paddingTop = `${padding.y}px`;

package/dist/components/query-state/index.d.ts

@@ -45,13 +45,29 @@ export interface QueryStateProps {
  *
  * 文案 props 可覆盖（i18n 由消费方传 t() 结果；本包不内置文案）。
  *
- * @example 空态带 CTA、错误态带重试
+ * ## 两个容易拿不准的点
+ *
+ * - `empty` 是**触发位**，不是「文案 prop」：`true` 触发并用默认文案；给字符串则**既触发、
+ *   又当空态标题**（副文案仍走 `emptyDescription`）；
+ * - **本件不自带数据源**：`loading` / `error` / `empty` 都由调用方按自己的请求结果给。
+ *   `Table` 自带加载与空两态却**没有错误态** —— 要么只把 error 交给本件，要么整块三态由本件在外层表达：
+ *
+ * @example 列表页：三态在外层，表格只管数据（经典写法）
+ * <QueryState
+ *   loading={isLoading}
+ *   error={loadError}
+ *   :empty="rows.length === 0"
+ *   :error-action-text="t('common.retry')"
+ *   onErrorAction={() => refetch()}>
+ *   <Table :columns="columns" :data="rows" row-key="id" />
+ * </QueryState>
+ *
+ * @example 三态齐备（空态带 CTA、错误态带重试）
  * <QueryState
  *   loading={isLoading}
  *   error={loadError.value}
  *   errorActionText={t('common.retry')}
  *   onErrorAction={() => reload()}
- *   empty={topics.length === 0}
  *   empty={t('topic.empty')}
  *   emptyDescription={t('topic.emptyDescription')}
  *   emptyActionText={t('topic.create')}

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

@@ -15,7 +15,7 @@ import type { ControlSize } from '../control-size';
  * `Checkbox.Group` 同一份口径，故 `v-model` 是本族的推荐写法。
  *
  * **单选组必须有值**：`modelValue` 与非受控初值都没给时，落到**第一个可选项**（跳过禁用项）——
- * 单选语义就是必选其一，与 `Tabset` 的「缺省第一项」同口径；没有可选项（表为空或全禁用）才是空值。
+ * 单选语义就是必选其一，与 `Tabs` 的「缺省第一项」同口径；没有可选项（表为空或全禁用）才是空值。
  * 自排插槽（`Radio.Group` 不给 `options`）时组件无从推断有哪些值，缺省值由消费方自定。
  *
  * 状态表达不统一是**有意的**（各自贴着自己的面）：`Radio` 走原生 `input:checked + .mh-radio__box`

package/dist/components/radio/index.js

@@ -44,6 +44,7 @@ const Radio = /* @__PURE__ */ defineComponent({
   }) {
     return () => createVNode("label", {
       "class": ["mh-radio", props.size === "md" ? "" : `mh-radio--${props.size}`, props.disabled ? "is-disabled" : void 0, attrs.class].filter(Boolean).join(" "),
+      "data-inline-control": "true",
       "style": attrs.style
     }, [createVNode("input", {
       "class": "mh-radio__input",