@manohub/ui 0.8.2 → 0.10.0

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

@@ -35,8 +35,9 @@ export interface TextareaAutoSize {
  * <Textarea modelValue={note} autoSize={{ minRows: 2, maxRows: 6 }} maxlength={500} showCount onChange={setNote} />
  *
  * @example 触发器形态（复合件用：控件换成 `<button>`，表壳 / 清除位 / 右侧图标位全部复用）
- * <Input as="button" clearable hasValue={!!value} controlClass="my-picker" controlAttrs={{ popovertarget: id }}>
- *   {{ default: () => value ?? '请选择', suffix: () => <Icon name="chevron-down" /> }}
+ * <Input as="button" clearable hasValue={!!value} placeholder="请选择" controlClass="my-picker"
+ *   controlAttrs={{ popovertarget: id }}>
+ *   {{ default: () => value, suffix: () => <Icon name="chevron-down" /> }}
  * </Input>
  */
 export declare const Input: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
@@ -50,6 +51,13 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
         type: StringConstructor;
         default: string;
     };
+    /**
+     * 占位文案。两种形态都消费它：
+     * - 缺省（`as="input"`）走原生 `::placeholder` 伪元素；
+     * - 触发器形态（`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载
+     *   （`.mh-input__placeholder`）—— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，
+     *   并**取代** `default` 插槽（见上面触发器一节）。没传 `hasValue` 的调用方行为不变。
+     */
     placeholder: {
         type: StringConstructor;
         default: undefined;
@@ -142,7 +150,8 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
         type: PropType<Record<string, unknown>>;
         default: undefined;
     };
-    /** 显式覆盖清除位显隐；不给时仍按「有内容」判定（多选类复合件没有单值可判） */
+    /** 显式覆盖清除位显隐；不给时仍按「有内容」判定（多选类复合件没有单值可判）。
+     *  同时是触发器形态「显示值还是显示占位」的判据（仅当它为 `false` 且传了 `placeholder` 时接管） */
     hasValue: {
         type: BooleanConstructor;
         default: undefined;
@@ -160,6 +169,13 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
         type: StringConstructor;
         default: string;
     };
+    /**
+     * 占位文案。两种形态都消费它：
+     * - 缺省（`as="input"`）走原生 `::placeholder` 伪元素；
+     * - 触发器形态（`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载
+     *   （`.mh-input__placeholder`）—— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，
+     *   并**取代** `default` 插槽（见上面触发器一节）。没传 `hasValue` 的调用方行为不变。
+     */
     placeholder: {
         type: StringConstructor;
         default: undefined;
@@ -252,7 +268,8 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
         type: PropType<Record<string, unknown>>;
         default: undefined;
     };
-    /** 显式覆盖清除位显隐；不给时仍按「有内容」判定（多选类复合件没有单值可判） */
+    /** 显式覆盖清除位显隐；不给时仍按「有内容」判定（多选类复合件没有单值可判）。
+     *  同时是触发器形态「显示值还是显示占位」的判据（仅当它为 `false` 且传了 `placeholder` 时接管） */
     hasValue: {
         type: BooleanConstructor;
         default: undefined;
@@ -478,6 +495,13 @@ export declare const InputCompound: {
             type: StringConstructor;
             default: string;
         };
+        /**
+         * 占位文案。两种形态都消费它：
+         * - 缺省（`as="input"`）走原生 `::placeholder` 伪元素；
+         * - 触发器形态（`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载
+         *   （`.mh-input__placeholder`）—— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，
+         *   并**取代** `default` 插槽（见上面触发器一节）。没传 `hasValue` 的调用方行为不变。
+         */
         placeholder: {
             type: StringConstructor;
             default: undefined;
@@ -570,7 +594,8 @@ export declare const InputCompound: {
             type: PropType<Record<string, unknown>>;
             default: undefined;
         };
-        /** 显式覆盖清除位显隐；不给时仍按「有内容」判定（多选类复合件没有单值可判） */
+        /** 显式覆盖清除位显隐；不给时仍按「有内容」判定（多选类复合件没有单值可判）。
+         *  同时是触发器形态「显示值还是显示占位」的判据（仅当它为 `false` 且传了 `placeholder` 时接管） */
         hasValue: {
             type: BooleanConstructor;
             default: undefined;
@@ -622,6 +647,13 @@ export declare const InputCompound: {
             type: StringConstructor;
             default: string;
         };
+        /**
+         * 占位文案。两种形态都消费它：
+         * - 缺省（`as="input"`）走原生 `::placeholder` 伪元素；
+         * - 触发器形态（`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载
+         *   （`.mh-input__placeholder`）—— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，
+         *   并**取代** `default` 插槽（见上面触发器一节）。没传 `hasValue` 的调用方行为不变。
+         */
         placeholder: {
             type: StringConstructor;
             default: undefined;
@@ -714,7 +746,8 @@ export declare const InputCompound: {
             type: PropType<Record<string, unknown>>;
             default: undefined;
         };
-        /** 显式覆盖清除位显隐；不给时仍按「有内容」判定（多选类复合件没有单值可判） */
+        /** 显式覆盖清除位显隐；不给时仍按「有内容」判定（多选类复合件没有单值可判）。
+         *  同时是触发器形态「显示值还是显示占位」的判据（仅当它为 `false` 且传了 `placeholder` 时接管） */
         hasValue: {
             type: BooleanConstructor;
             default: undefined;
@@ -757,6 +790,13 @@ export declare const InputCompound: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * 占位文案。两种形态都消费它：
+     * - 缺省（`as="input"`）走原生 `::placeholder` 伪元素；
+     * - 触发器形态（`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载
+     *   （`.mh-input__placeholder`）—— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，
+     *   并**取代** `default` 插槽（见上面触发器一节）。没传 `hasValue` 的调用方行为不变。
+     */
     placeholder: {
         type: StringConstructor;
         default: undefined;
@@ -849,7 +889,8 @@ export declare const InputCompound: {
         type: PropType<Record<string, unknown>>;
         default: undefined;
     };
-    /** 显式覆盖清除位显隐；不给时仍按「有内容」判定（多选类复合件没有单值可判） */
+    /** 显式覆盖清除位显隐；不给时仍按「有内容」判定（多选类复合件没有单值可判）。
+     *  同时是触发器形态「显示值还是显示占位」的判据（仅当它为 `false` 且传了 `placeholder` 时接管） */
     hasValue: {
         type: BooleanConstructor;
         default: undefined;

package/dist/components/input/index.js

@@ -14,6 +14,13 @@ const Input = /* @__PURE__ */ defineComponent({
       type: String,
       default: ""
     },
+    /**
+     * 占位文案。两种形态都消费它：
+     * - 缺省（`as="input"`）走原生 `::placeholder` 伪元素；
+     * - 触发器形态（`as="button"`）**没有 `::placeholder` 可用**，改由一个 span 承载
+     *   （`.mh-input__placeholder`）—— 当且仅当 `hasValue === false` 且本 prop 有值时渲染它，
+     *   并**取代** `default` 插槽（见上面触发器一节）。没传 `hasValue` 的调用方行为不变。
+     */
     placeholder: {
       type: String,
       default: void 0
@@ -95,7 +102,13 @@ const Input = /* @__PURE__ */ defineComponent({
      * 整件的**表壳、附加位与状态规则一并复用**，只把「控件元素」从 `<input>` 换成 `<button>`：
      * 于是 `Select` 这类件能拿到输入框的框与内距、内建清除位、右侧图标位与三态反馈，同时保留
      * 原生 `<button>` 才有的语义（如 `popovertarget` 触发 popover —— 该属性只认 button）。
-     * 缺省 `as="input"` 的渲染路径除本组 prop 外零变化。 */
+     * 缺省 `as="input"` 的渲染路径除本组 prop 外零变化。
+     *
+     * **无值时的占位**：`<button>` 没有 `::placeholder` 伪元素可用，故 `placeholder` 在这个形态下
+     * 由本件渲染成一个 span（`.mh-input__placeholder`，色档与原生占位一致）；判据是
+     * `hasValue === false && placeholder` **同时**成立 —— 两者缺一即沿用消费方给的 `default` 插槽。
+     * 这样「有值渲染值、无值渲染占位」这件例行事的文案与切换都由输入面统一，复合件不必各画一遍
+     * （`Select` 早期为自己的值区单画过一份，见 `select-trigger.tsx`）。 */
     /** 控件元素形态：`input` 文本输入（缺省）/ `button` 触发器 */
     as: {
       type: String,
@@ -111,7 +124,8 @@ const Input = /* @__PURE__ */ defineComponent({
       type: Object,
       default: void 0
     },
-    /** 显式覆盖清除位显隐；不给时仍按「有内容」判定（多选类复合件没有单值可判） */
+    /** 显式覆盖清除位显隐；不给时仍按「有内容」判定（多选类复合件没有单值可判）。
+     *  同时是触发器形态「显示值还是显示占位」的判据（仅当它为 `false` 且传了 `placeholder` 时接管） */
     hasValue: {
       type: Boolean,
       default: void 0
@@ -149,6 +163,7 @@ const Input = /* @__PURE__ */ defineComponent({
     const isTrigger = computed(() => props.as === "button");
     const controlClasses = computed(() => ["mh-input", isTrigger.value ? "mh-input--trigger" : "", props.size === "md" ? "" : `mh-input--${props.size}`, props.bordered ? "" : "mh-input--borderless", visualStatus.value ? `is-${visualStatus.value}` : "", props.disabled ? "is-disabled" : "", props.controlClass].filter(Boolean).join(" "));
     const showClear = computed(() => props.clearable && (props.hasValue ?? !!current.value));
+    const showPlaceholder = computed(() => isTrigger.value && props.hasValue === false && !!props.placeholder);
     return () => createVNode("div", {
       "class": ["mh-input__wrap", attrs.class].filter(Boolean).join(" "),
       "style": attrs.style
@@ -164,7 +179,12 @@ const Input = /* @__PURE__ */ defineComponent({
         "class": controlClasses.value,
         "disabled": props.disabled,
         "aria-invalid": isInvalid.value ? "true" : void 0
-      }), [slots.default ? slots.default() : null])
+      }), [showPlaceholder.value ? (
+        /* 触发器没有 `::placeholder`，占位文案由本件渲染（色见 `.mh-input__placeholder`） */
+        createVNode("span", {
+          "class": "mh-input__placeholder"
+        }, [props.placeholder])
+      ) : slots.default ? slots.default() : null])
     ) : createVNode("input", {
       "class": controlClasses.value,
       "type": inputType.value,

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

@@ -136,7 +136,7 @@ export declare const Notice: import("vue").DefineComponent<import("vue").Extract
         default: undefined;
     };
 }>> & Readonly<{}>, {
-    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";
+    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" | "info-circle" | "check-circle" | "alert-circle" | "list" | "calendar" | "clock" | "lock" | "unlock" | "users" | "archive" | "package" | "plug" | "branch" | "tag" | "ai" | "shield-check" | "shield-alert" | "history";
     onClose: () => void;
     message: string;
     closable: boolean;

package/dist/components/notice/index.js

@@ -1,10 +1,10 @@
 import { defineComponent, createVNode, Fragment, createTextVNode } from "vue";
 import { Icon } from "@manohub/icon";
 const TONE_ICON = {
-  info: "info",
-  success: "check",
-  warning: "alert",
-  error: "close"
+  info: "info-circle",
+  success: "check-circle",
+  warning: "alert-circle",
+  error: "close-circle"
 };
 const Notice = /* @__PURE__ */ defineComponent({
   name: "Notice",

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

@@ -102,7 +102,7 @@ export declare const Notification: import("vue").DefineComponent<import("vue").E
         default: undefined;
     };
 }>> & Readonly<{}>, {
-    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";
+    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" | "info-circle" | "check-circle" | "alert-circle" | "list" | "calendar" | "clock" | "lock" | "unlock" | "users" | "archive" | "package" | "plug" | "branch" | "tag" | "ai" | "shield-check" | "shield-alert" | "history";
     title: string;
     onClose: () => void;
     closable: boolean;

package/dist/components/notification/index.js

@@ -1,11 +1,11 @@
 import { defineComponent, onMounted, onBeforeUnmount, createVNode } from "vue";
 import { Icon } from "@manohub/icon";
 const TONE_ICON = {
-  info: "info",
-  success: "check",
-  warning: "alert",
-  error: "close",
-  submit: "check"
+  info: "info-circle",
+  success: "check-circle",
+  warning: "alert-circle",
+  error: "close-circle",
+  submit: "check-circle"
 };
 const Notification = /* @__PURE__ */ defineComponent({
   name: "Notification",

package/dist/components/radio/index.js

@@ -1,4 +1,4 @@
-import { defineComponent, createVNode, ref, computed } from "vue";
+import { defineComponent, createVNode, ref, nextTick, computed } from "vue";
 const Radio = /* @__PURE__ */ defineComponent({
   name: "Radio",
   inheritAttrs: false,
@@ -136,7 +136,17 @@ const RadioGroup = /* @__PURE__ */ defineComponent({
         props.onChange?.(value);
       }
     );
+    const rootRef = ref(null);
+    const syncNative = () => {
+      const root = rootRef.value;
+      if (!root) return;
+      root.querySelectorAll(".mh-radio__input").forEach((el) => {
+        const want = String(current.value) === el.value;
+        if (el.checked !== want) el.checked = want;
+      });
+    };
     return () => createVNode("div", {
+      "ref": rootRef,
       "class": ["mh-radio-group", props.vertical ? "mh-radio-group--vertical" : void 0, attrs.class].filter(Boolean).join(" "),
       "style": attrs.style
     }, [slots.default ? slots.default({
@@ -150,7 +160,10 @@ const RadioGroup = /* @__PURE__ */ defineComponent({
       "checked": option.value === current.value,
       "disabled": props.disabled || option.disabled,
       "size": props.size,
-      "onChange": select
+      "onChange": (value) => {
+        select(value);
+        void nextTick(syncNative);
+      }
     }, null))]);
   }
 });
@@ -206,7 +219,17 @@ const RadioCard = /* @__PURE__ */ defineComponent({
         props.onChange?.(value);
       }
     );
+    const rootRef = ref(null);
+    const syncNative = () => {
+      const root = rootRef.value;
+      if (!root) return;
+      root.querySelectorAll(".mh-radio-card__input").forEach((el) => {
+        const want = current.value === el.value;
+        if (el.checked !== want) el.checked = want;
+      });
+    };
     return () => createVNode("div", {
+      "ref": rootRef,
       "class": ["mh-radio-card", props.columns > 1 ? "mh-radio-card--grid" : "", attrs.class].filter(Boolean).join(" "),
       "style": props.columns > 1 ? {
         ...attrs.style,
@@ -228,7 +251,10 @@ const RadioCard = /* @__PURE__ */ defineComponent({
         "value": String(item.value),
         "checked": isChecked,
         "disabled": isDisabled,
-        "onChange": () => select(item.value)
+        "onChange": () => {
+          select(item.value);
+          void nextTick(syncNative);
+        }
       }, null), createVNode("span", {
         "class": "mh-radio-card__radio",
         "aria-hidden": "true"

package/dist/components/search/index.js

@@ -76,44 +76,46 @@ const Search = /* @__PURE__ */ defineComponent({
     const iconAction = computed(() => props.action === "icon");
     const showAction = computed(() => iconAction.value || props.searchText !== void 0);
     const actionLabel = computed(() => props.searchText ?? "搜索");
-    return () => createVNode("div", {
-      "class": ["mh-search", attrs.class].filter(Boolean).join(" "),
-      "style": attrs.style
-    }, [createVNode(Input, {
-      "class": "mh-search__input",
-      "modelValue": current.value,
-      "size": props.size,
-      "disabled": props.disabled,
-      "placeholder": props.placeholder,
-      "clearable": props.clearable,
-      "onChange": commit,
-      "onEnter": search
-    }, {
-      default: () => [iconAction.value ? {} : {
+    return () => {
+      const field = {
+        class: "mh-search__input",
+        modelValue: current.value,
+        size: props.size,
+        disabled: props.disabled,
+        placeholder: props.placeholder,
+        clearable: props.clearable,
+        onChange: commit,
+        onEnter: search
+      };
+      const fieldNode = iconAction.value ? createVNode(Input, field, null) : createVNode(Input, field, {
         prefix: () => createVNode(Icon, {
           "name": "search"
         }, null)
-      }]
-    }), showAction.value ? iconAction.value ? createVNode(Button, {
-      "class": "mh-search__btn",
-      "variant": "primary",
-      "size": props.size,
-      "icon": "search",
-      "title": actionLabel.value,
-      "disabled": props.disabled,
-      "loading": props.loading,
-      "onClick": search
-    }, null) : createVNode(Button, {
-      "class": "mh-search__btn",
-      "variant": "primary",
-      "size": props.size,
-      "icon": "search",
-      "disabled": props.disabled,
-      "loading": props.loading,
-      "onClick": search
-    }, {
-      default: () => props.searchText
-    }) : null]);
+      });
+      return createVNode("div", {
+        "class": ["mh-search", attrs.class].filter(Boolean).join(" "),
+        "style": attrs.style
+      }, [fieldNode, showAction.value ? iconAction.value ? createVNode(Button, {
+        "class": "mh-search__btn",
+        "variant": "primary",
+        "size": props.size,
+        "icon": "search",
+        "title": actionLabel.value,
+        "disabled": props.disabled,
+        "loading": props.loading,
+        "onClick": search
+      }, null) : createVNode(Button, {
+        "class": "mh-search__btn",
+        "variant": "primary",
+        "size": props.size,
+        "icon": "search",
+        "disabled": props.disabled,
+        "loading": props.loading,
+        "onClick": search
+      }, {
+        default: () => props.searchText
+      }) : null]);
+    };
   }
 });
 export {

package/dist/components/select/index.js

@@ -211,9 +211,7 @@ const Select = /* @__PURE__ */ defineComponent({
           "class": "mh-select__chip"
         }, [option.label])), foldedCount.value > 0 ? createVNode("span", {
           "class": "mh-select__chip mh-select__chip--fold"
-        }, [foldText.value]) : null, !hasValue ? createVNode("span", {
-          "class": "mh-select__value mh-select__value--placeholder"
-        }, [props.placeholder]) : null]) : void 0
+        }, [foldText.value]) : null]) : void 0
       }, null), createVNode(SelectPanel, {
         "id": panelId,
         "elementRef": panelRef,

package/dist/components/select/select-trigger.d.ts

@@ -35,11 +35,12 @@ export declare const SelectTrigger: import("vue").DefineComponent<import("vue").
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 无值时的占位文案（**透传给输入面**：`hasValue === false` 时由它渲染并取代 `default` 插槽） */
     placeholder: {
         type: StringConstructor;
         default: string;
     };
-    /** 单选显示文本（无值时不渲染它，改渲染 `placeholder`） */
+    /** 单选显示文本（只在**有值**时渲染；无值态由输入面的占位承担） */
     label: {
         type: StringConstructor;
         default: undefined;
@@ -93,11 +94,12 @@ export declare const SelectTrigger: import("vue").DefineComponent<import("vue").
         type: BooleanConstructor;
         default: boolean;
     };
+    /** 无值时的占位文案（**透传给输入面**：`hasValue === false` 时由它渲染并取代 `default` 插槽） */
     placeholder: {
         type: StringConstructor;
         default: string;
     };
-    /** 单选显示文本（无值时不渲染它，改渲染 `placeholder`） */
+    /** 单选显示文本（只在**有值**时渲染；无值态由输入面的占位承担） */
     label: {
         type: StringConstructor;
         default: undefined;

package/dist/components/select/select-trigger.js

@@ -38,11 +38,12 @@ const SelectTrigger = /* @__PURE__ */ defineComponent({
       type: Boolean,
       default: false
     },
+    /** 无值时的占位文案（**透传给输入面**：`hasValue === false` 时由它渲染并取代 `default` 插槽） */
     placeholder: {
       type: String,
       default: "请选择"
     },
-    /** 单选显示文本（无值时不渲染它，改渲染 `placeholder`） */
+    /** 单选显示文本（只在**有值**时渲染；无值态由输入面的占位承担） */
     label: {
       type: String,
       default: void 0
@@ -72,6 +73,7 @@ const SelectTrigger = /* @__PURE__ */ defineComponent({
       "disabled": props.disabled,
       "clearable": props.clearable,
       "hasValue": props.hasValue,
+      "placeholder": props.placeholder,
       "class": "mh-popup-anchor mh-select-host",
       "controlClass": controlClass(),
       "controlAttrs": {
@@ -84,9 +86,12 @@ const SelectTrigger = /* @__PURE__ */ defineComponent({
       },
       "onChange": () => props.onClear?.()
     }, {
-      default: () => props.renderValue ? props.renderValue() : createVNode("span", {
-        "class": ["mh-select__value", props.hasValue ? "" : "mh-select__value--placeholder"].filter(Boolean).join(" ")
-      }, [props.hasValue ? props.label : props.placeholder]),
+      default: () => props.renderValue ? props.renderValue() : (
+        /* 只画**有值**时的那一行；无值态在上面被输入面的占位取代（`default` 不会被调用） */
+        createVNode("span", {
+          "class": "mh-select__value"
+        }, [props.label])
+      ),
       /* 箭头沿用输入框的右侧图标位（槽内尺寸收敛见 `select.css` 的 `.mh-select-host` 一节）；
          展开转向由 `popup.css` 的 `.mh-popup-caret` 承担（含触发器进表壳后的兄弟档） */
       suffix: () => createVNode(Icon, {

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

@@ -16,8 +16,19 @@ export interface TableColumn {
      */
     width?: string | number;
     align?: 'left' | 'center' | 'right';
-    /** 长文本省略（表头仍完整）。`fixed` 下建议给所有长文本列都标上，否则会换行（行高变高） */
-    ellipsis?: boolean;
+    /**
+     * 允许该列**换行**（缺省不换行：`nowrap` + 省略号）。
+     *
+     * <p>缺省不换行是刻意的：换行只会把行高顶高（`td` 的 `height` 只是**下限**），
+     * 而且必然伴随从字符间断字（实测序号列窄到装不下两位数时，`10` 被拆成 `1` / `0` 两行、
+     * 行高 30 → 49）。真要换行的列（描述 / 备注 / 多行摘要）显式打开它。</p>
+     *
+     * <p><b>只影响 `layout="fixed"`</b>：`auto` 档列宽由内容计算，表体本来就换行
+     * （不换行会让长文本列不再收敛、表格更容易撑破容器），故本档给不给都一样。</p>
+     *
+     * <p>只作用于表体 `td`；表头始终 `nowrap`（表头字短，换行只会让表头行变高）。</p>
+     */
+    wrap?: boolean;
     /**
      * 列下限（px）：防止窄容器把该列压没。**给了才下发 `min-width`** ——
      * ⚠️ 它**不是硬下限**：实测（Chrome）`<col>` 上的 `min-width` 会被当成**分配权重**参与按比例
@@ -72,13 +83,13 @@ export interface TablePagination {
  *   组件自己切片会让「服务端分页」与「客户端分页」两套口径藏在同一个 prop 里；
  * - **错误态**：归 `QueryState`（表格只管列数据）。
  *
- * @example 基本列表（表默认满宽；列宽给权重 + `fixed` 才严格按比例，长文本列配 `ellipsis`）
+ * @example 基本列表（表默认满宽；列宽给权重 + `fixed` 才严格按比例）
  * <Table
  *   layout="fixed" striped row-key="id" :data="rows"
  *   :columns="[
  *     { key: 'name', title: '名称', width: 3 },
  *     { key: 'amount', title: '金额', width: 1, align: 'right' },
- *     { key: 'description', title: '描述', width: 4, ellipsis: true },
+ *     { key: 'description', title: '描述', width: 4, wrap: true },
  *   ]"
  *   :pagination="{ total: 120, current: page, onChange: (p) => (page = p) }"
  * />
@@ -164,8 +175,8 @@ export declare const Table: import("vue").DefineComponent<import("vue").ExtractP
      * - `auto`（缺省）—— 列宽随内容自适应。`column.width` 是**建议值**，
      *   长文本（尤其中文长串 / 无空格串）会顶破列宽把表格撑得比容器还宽 ⇒ 包裹层出横向滚动条。
      * - `fixed` —— `table-layout: fixed`：列宽受声明约束、**不再被内容撑破**，
-     *   于是百分比 / 数字权重可以「吃满容器 + 严格按比例」。代价：长文本列要显式 `ellipsis: true`，
-     *   否则会**换行**（行高变高）。
+     *   于是百分比 / 数字权重可以「吃满容器 + 严格按比例」。表体**默认不换行**（`nowrap` + 省略号），
+     *   要换行的列显式 `wrap: true`。
      */
     layout: {
         type: PropType<"auto" | "fixed">;
@@ -311,8 +322,8 @@ export declare const Table: import("vue").DefineComponent<import("vue").ExtractP
      * - `auto`（缺省）—— 列宽随内容自适应。`column.width` 是**建议值**，
      *   长文本（尤其中文长串 / 无空格串）会顶破列宽把表格撑得比容器还宽 ⇒ 包裹层出横向滚动条。
      * - `fixed` —— `table-layout: fixed`：列宽受声明约束、**不再被内容撑破**，
-     *   于是百分比 / 数字权重可以「吃满容器 + 严格按比例」。代价：长文本列要显式 `ellipsis: true`，
-     *   否则会**换行**（行高变高）。
+     *   于是百分比 / 数字权重可以「吃满容器 + 严格按比例」。表体**默认不换行**（`nowrap` + 省略号），
+     *   要换行的列显式 `wrap: true`。
      */
     layout: {
         type: PropType<"auto" | "fixed">;

package/dist/components/table/index.js

@@ -68,8 +68,8 @@ const Table = /* @__PURE__ */ defineComponent({
      * - `auto`（缺省）—— 列宽随内容自适应。`column.width` 是**建议值**，
      *   长文本（尤其中文长串 / 无空格串）会顶破列宽把表格撑得比容器还宽 ⇒ 包裹层出横向滚动条。
      * - `fixed` —— `table-layout: fixed`：列宽受声明约束、**不再被内容撑破**，
-     *   于是百分比 / 数字权重可以「吃满容器 + 严格按比例」。代价：长文本列要显式 `ellipsis: true`，
-     *   否则会**换行**（行高变高）。
+     *   于是百分比 / 数字权重可以「吃满容器 + 严格按比例」。表体**默认不换行**（`nowrap` + 省略号），
+     *   要换行的列显式 `wrap: true`。
      */
     layout: {
       type: String,
@@ -177,7 +177,7 @@ const Table = /* @__PURE__ */ defineComponent({
     const leadColumns = computed(() => (hasSelectColumn.value ? 1 : 0) + (props.expandable ? 1 : 0));
     const columnCount = computed(() => leadColumns.value + props.columns.length);
     const isEmpty = computed(() => props.data.length === 0);
-    const cellClass = (column) => [column.align === "center" ? "mh-table__cell-center" : "", column.align === "right" ? "mh-table__cell-amount" : "", column.ellipsis ? "mh-table__cell-ellipsis" : ""].filter(Boolean);
+    const cellClass = (column) => [column.align === "center" ? "mh-table__cell-center" : "", column.align === "right" ? "mh-table__cell-amount" : "", column.wrap ? "mh-table__cell-wrap" : ""].filter(Boolean);
     const colStyles = computed(() => {
       const weightSum = props.columns.reduce((sum, item) => typeof item.width === "number" ? sum + item.width : sum, 0);
       return props.columns.map((column) => {

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

@@ -185,7 +185,7 @@ export declare const Tag: import("vue").DefineComponent<import("vue").ExtractPro
 }>> & Readonly<{}>, {
     color: string;
     size: ControlSize;
-    icon: "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";
+    icon: "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" | "info-circle" | "check-circle" | "alert-circle" | "list" | "calendar" | "clock" | "lock" | "unlock" | "users" | "archive" | "package" | "plug" | "branch" | "tag" | "ai" | "shield-check" | "shield-alert" | "history";
     disabled: boolean;
     name: string;
     value: string | number;

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

@@ -40,9 +40,10 @@ export interface TextProps {
  *
  * ## 与 `Title` / 平台默认的关系
  *
- * 浏览器给 `h1`-`h6` 的字阶已被 reset 归零（`font-size: inherit` / `font-weight: inherit`），
- * 所以 `as="h2"` 只贡献**语义**，视觉完全由 `size` / `weight` 决定 ——
- * 这与「标题的字阶必须跟设计稿」不冲突：要多大显式给 `size`。
+ * `as="h2"` 只贡献**语义**，视觉完全由 `size` / `weight` 决定：字号由 `size` 档（缺省 `body`）显式给，
+ * 浏览器给 `h1`-`h6` 的那套字阶（`1.5em` + 粗体）由**本件自己的面**归零（`.mh-text:where(h1…h6)`，
+ * 只点名标题标签 —— `strong` 的加粗是它唯一的表达，不归零）。元素级基线**不再**代管这条：
+ * 它在 Tailwind 的层外，会压住消费方的 `text-*` 工具类（理由见 `styles/reset.css` 文件头）。
  *
  * ## 不做什么
  *