@manohub/ui 0.9.0 → 0.10.1

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
@@ -71,7 +78,7 @@ const Input = /* @__PURE__ */ defineComponent({
       type: Number,
       default: void 0
     },
-    /** 右侧字数统计（单行须给 `maxlength` 才有意义） */
+    /** 右侧字数统计（**须给 `maxlength` 才渲染**：没有分母的 `n/0` 是坏值） */
     showCount: {
       type: Boolean,
       default: false
@@ -95,7 +102,17 @@ const Input = /* @__PURE__ */ defineComponent({
      * 整件的**表壳、附加位与状态规则一并复用**，只把「控件元素」从 `<input>` 换成 `<button>`：
      * 于是 `Select` 这类件能拿到输入框的框与内距、内建清除位、右侧图标位与三态反馈，同时保留
      * 原生 `<button>` 才有的语义（如 `popovertarget` 触发 popover —— 该属性只认 button）。
-     * 缺省 `as="input"` 的渲染路径除本组 prop 外零变化。 */
+     * 缺省 `as="input"` 的渲染路径除本组 prop 外零变化。
+     *
+     * **单行契约（与输入框同源，面层承担）**：控件是单行盒，值再长也不换行（超出走省略号）
+     * —— 见 `styles/components/input.css` 的 `.mh-input--trigger`。故 `default` 插槽里给**裸文本**
+     * 也安全，不需要自己再包一层截断 span。
+     *
+     * **无值时的占位**：`<button>` 没有 `::placeholder` 伪元素可用，故 `placeholder` 在这个形态下
+     * 由本件渲染成一个 span（`.mh-input__placeholder`，色档与原生占位一致）；判据是
+     * `hasValue === false && placeholder` **同时**成立 —— 两者缺一即沿用消费方给的 `default` 插槽。
+     * 这样「有值渲染值、无值渲染占位」这件例行事的文案与切换都由输入面统一，复合件不必各画一遍
+     * （`Select` 早期为自己的值区单画过一份，见 `select-trigger.tsx`）。 */
     /** 控件元素形态：`input` 文本输入（缺省）/ `button` 触发器 */
     as: {
       type: String,
@@ -106,12 +123,14 @@ const Input = /* @__PURE__ */ defineComponent({
       type: String,
       default: void 0
     },
-    /** 展开到**控件元素**上的属性（触发器形态要 `popovertarget` / `aria-*` / `onKeydown` 落到控件上） */
+    /** 展开到**控件元素**上的属性（触发器形态要 `popovertarget` / `aria-*` / `onKeydown` 落到控件上）;
+     *  与透传的 attrs 撞名时以本 prop 为准 */
     controlAttrs: {
       type: Object,
       default: void 0
     },
-    /** 显式覆盖清除位显隐；不给时仍按「有内容」判定（多选类复合件没有单值可判） */
+    /** 显式覆盖清除位显隐；不给时仍按「有内容」判定（多选类复合件没有单值可判）。
+     *  同时是触发器形态「显示值还是显示占位」的判据（仅当它为 `false` 且传了 `placeholder` 时接管） */
     hasValue: {
       type: Boolean,
       default: void 0
@@ -129,6 +148,13 @@ const Input = /* @__PURE__ */ defineComponent({
     const inner = ref(props.defaultValue);
     const current = computed(() => props.modelValue ?? inner.value);
     const revealed = ref(false);
+    const forwardAttrs = computed(() => {
+      const rest = {};
+      for (const [key, value] of Object.entries(attrs)) {
+        if (key !== "class" && key !== "style") rest[key] = value;
+      }
+      return rest;
+    });
     const visualStatus = computed(() => props.status ?? (props.invalid ? "error" : void 0));
     const isInvalid = computed(() => visualStatus.value === "error");
     const commit = (value) => {
@@ -149,6 +175,8 @@ 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 showCounter = computed(() => !isTrigger.value && props.showCount && props.maxlength !== void 0);
+    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
@@ -160,12 +188,17 @@ const Input = /* @__PURE__ */ defineComponent({
          本件的 Enter / Delete 是**输入框**语义，触发器有自己的一套（如 `↓` 开面板），不在此套用。 */
       createVNode("button", mergeProps({
         "type": "button"
-      }, props.controlAttrs, {
+      }, forwardAttrs.value, props.controlAttrs, {
         "class": controlClasses.value,
         "disabled": props.disabled,
         "aria-invalid": isInvalid.value ? "true" : void 0
-      }), [slots.default ? slots.default() : null])
-    ) : createVNode("input", {
+      }), [showPlaceholder.value ? (
+        /* 触发器没有 `::placeholder`，占位文案由本件渲染（色见 `.mh-input__placeholder`） */
+        createVNode("span", {
+          "class": "mh-input__placeholder"
+        }, [props.placeholder])
+      ) : slots.default ? slots.default() : null])
+    ) : createVNode("input", mergeProps(forwardAttrs.value, {
       "class": controlClasses.value,
       "type": inputType.value,
       "value": current.value,
@@ -177,7 +210,7 @@ const Input = /* @__PURE__ */ defineComponent({
       "aria-invalid": isInvalid.value ? "true" : void 0,
       "onInput": onInput,
       "onKeydown": onKeydown
-    }, null), showClear.value ? createVNode("button", {
+    }), null), showClear.value ? createVNode("button", {
       "type": "button",
       "class": "mh-input__clear",
       "aria-label": "清除",
@@ -199,9 +232,9 @@ const Input = /* @__PURE__ */ defineComponent({
       "class": "mh-input__eye-icon"
     }, null)]) : null, slots.suffix ? createVNode("span", {
       "class": "mh-input__suffix"
-    }, [slots.suffix()]) : null, !isTrigger.value && props.showCount ? createVNode("span", {
+    }, [slots.suffix()]) : null, showCounter.value ? createVNode("span", {
       "class": "mh-input__counter"
-    }, [current.value?.length ?? 0, createTextVNode("/"), props.maxlength ?? 0]) : null]);
+    }, [current.value?.length ?? 0, createTextVNode("/"), props.maxlength]) : null]);
   }
 });
 const Textarea = /* @__PURE__ */ defineComponent({
@@ -257,6 +290,7 @@ const Textarea = /* @__PURE__ */ defineComponent({
       type: Number,
       default: void 0
     },
+    /** 右下角字数统计（**须给 `maxlength` 才渲染**：没有分母的 `n/0` 是坏值） */
     showCount: {
       type: Boolean,
       default: false
@@ -279,6 +313,14 @@ const Textarea = /* @__PURE__ */ defineComponent({
   }) {
     const inner = ref(props.defaultValue);
     const current = computed(() => props.modelValue ?? inner.value);
+    const forwardAttrs = computed(() => {
+      const rest = {};
+      for (const [key, value] of Object.entries(attrs)) {
+        if (key !== "class" && key !== "style") rest[key] = value;
+      }
+      return rest;
+    });
+    const showCounter = computed(() => props.showCount && props.maxlength !== void 0);
     const visualStatus = computed(() => props.status ?? (props.invalid ? "error" : void 0));
     const isInvalid = computed(() => visualStatus.value === "error");
     const autoRows = computed(() => {
@@ -300,7 +342,7 @@ const Textarea = /* @__PURE__ */ defineComponent({
     return () => createVNode("div", {
       "class": ["mh-input__wrap", attrs.class].filter(Boolean).join(" "),
       "style": attrs.style
-    }, [createVNode("textarea", {
+    }, [createVNode("textarea", mergeProps(forwardAttrs.value, {
       "class": ["mh-input", "mh-input--textarea", props.size === "md" ? "" : `mh-input--${props.size}`, props.bordered ? "" : "mh-input--borderless", visualStatus.value ? `is-${visualStatus.value}` : "", props.disabled ? "is-disabled" : ""].filter(Boolean).join(" "),
       "rows": autoRows.value,
       "value": current.value,
@@ -311,9 +353,9 @@ const Textarea = /* @__PURE__ */ defineComponent({
       "autofocus": props.autofocus,
       "aria-invalid": isInvalid.value ? "true" : void 0,
       "onInput": onInput
-    }, null), props.showCount ? createVNode("span", {
+    }), null), showCounter.value ? createVNode("span", {
       "class": "mh-input__counter"
-    }, [current.value?.length ?? 0, createTextVNode("/"), props.maxlength ?? 0]) : null]);
+    }, [current.value?.length ?? 0, createTextVNode("/"), props.maxlength]) : null]);
   }
 });
 const InputDisplay = /* @__PURE__ */ defineComponent({
@@ -330,10 +372,17 @@ const InputDisplay = /* @__PURE__ */ defineComponent({
     slots,
     attrs
   }) {
-    return () => createVNode("span", {
+    const forwardAttrs = computed(() => {
+      const rest = {};
+      for (const [key, value] of Object.entries(attrs)) {
+        if (key !== "class" && key !== "style") rest[key] = value;
+      }
+      return rest;
+    });
+    return () => createVNode("span", mergeProps(forwardAttrs.value, {
       "class": ["mh-input--display", attrs.class].filter(Boolean).join(" "),
       "style": attrs.style
-    }, [slots.default ? slots.default() : props.value]);
+    }), [slots.default ? slots.default() : props.value]);
   }
 });
 Object.assign(Input, {

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.d.ts

@@ -32,6 +32,9 @@
  * （不做 JS 定位、不做 resize 监听）。本件只补原生做不到的：选中值回填、多选数组的增删与收纳、
  * 搜索过滤与「创建」项、以及键盘的下拉导航（↑↓ 移动高亮行）。
  *
+ * **面板有高度上限**：`--ui-select-panel-max-height`（默认 320px，钉在 `select.css` 的面板根上）——
+ * 超出即面板内容区（`.mh-select__body`）滚动、搜索行常驻；列表与 `SelectTree` 两形态共用这一份。
+ *
  * ## 状态三源等价
  *
  * 选中行 = `[data-state='selected']`（组件下发）/ 原生 `input:checked`（静态页零 JS 路径）/
@@ -87,7 +90,7 @@ export declare const Select: import("vue").DefineComponent<import("vue").Extract
         type: StringConstructor;
         default: undefined;
     };
-    /** 搜索：`true` 强制开；不给时选项多于 8 条自动开 */
+    /** 搜索行是否出现（**只认显式开启**；缺省不出 —— 不在面板里凭空多出一行） */
     searchable: {
         type: BooleanConstructor;
         default: boolean;
@@ -176,7 +179,7 @@ export declare const Select: import("vue").DefineComponent<import("vue").Extract
         type: StringConstructor;
         default: undefined;
     };
-    /** 搜索：`true` 强制开；不给时选项多于 8 条自动开 */
+    /** 搜索行是否出现（**只认显式开启**；缺省不出 —— 不在面板里凭空多出一行） */
     searchable: {
         type: BooleanConstructor;
         default: boolean;

package/dist/components/select/index.js

@@ -41,7 +41,7 @@ const Select = /* @__PURE__ */ defineComponent({
       type: String,
       default: void 0
     },
-    /** 搜索：`true` 强制开；不给时选项多于 8 条自动开 */
+    /** 搜索行是否出现（**只认显式开启**；缺省不出 —— 不在面板里凭空多出一行） */
     searchable: {
       type: Boolean,
       default: false
@@ -122,7 +122,6 @@ const Select = /* @__PURE__ */ defineComponent({
       return list;
     });
     const selectedOptions = computed(() => flatOptions.value.filter((option) => selectedValues.value.includes(option.value)));
-    const showSearch = computed(() => props.searchable || flatOptions.value.length > 8);
     const matched = (option, kw) => props.filterOption ? props.filterOption(option, kw) : option.label.includes(kw);
     const visibleOptions = computed(() => {
       const kw = keyword.value;
@@ -211,13 +210,11 @@ 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,
-        "searchable": showSearch.value,
+        "searchable": props.searchable,
         "keyword": keyword.value,
         "onKeyword": (value) => {
           keyword.value = value;

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

@@ -4,6 +4,8 @@
  * 它拥有「面板里那一撮选项」的全部形态与状态行：平铺选项 / 分组（组标题不可点）/ 「创建」行 /
  * 空态行 / 加载行。**不含面板壳与搜索行**（那是 `SelectPanel` 的事），也不持有任何状态 ——
  * 过滤结果、选中值、是否可创建统统由消费方算好喂进来，本件只渲染。
+ * 行由面板壳装在**内容区**（`.mh-select__body`，面板里唯一的滚动容器）里，限高与滚动都归面层，
+ * 本件不写第二个滚动容器。
  *
  * 选项是真实 `<button role="option">`（不是 div + JS 高亮）：键盘可达、`:focus-visible` 可直接
  * 承载「高亮行」这层语义，于是不需要再维护一份 JS 高亮下标 —— **焦点即高亮**，

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

@@ -1,10 +1,15 @@
 /**
  * SelectPanel —— 选择器族的**面板壳内件**（`Select` 与 `SelectTree` 共用，不对外导出）。
  *
- * 它只拥有三样东西：**原生 popover 元素**（开合 / Esc / 点外部关闭 / 顶层渲染 / 定位全归浏览器）、
- * **搜索行**（面板顶部那一个输入框）、以及**内容槽**（列表体或树体）。
+ * 它只拥有四样东西：**原生 popover 元素**（开合 / Esc / 点外部关闭 / 顶层渲染 / 定位全归浏览器）、
+ * **搜索行**（面板顶部那一个输入框）、**内容区**（`.mh-select__body`，面板里唯一的滚动容器）
+ * 与**内容槽**（列表体或树体）。
  * 「面板里装什么」不在本件 —— 这正是让列表与树共用同一份面板皮肤的原因。
  *
+ * **限高在面层**：面板根上钉着 `--ui-select-panel-max-height`（`select.css`），超出即内容区滚动、
+ * 搜索行常驻不滚。内容区这一层因此是**结构性的**（不是可有可无的包裹）：少了它，长列表 / 长树
+ * 会把面板一路撑高（实测 60 条选项 2212px），搜索行也会跟着滚走。本件只负责把它渲染出来。
+ *
  * 组合类名与服务端三条属性都是**操作层的组合**，不是本件新造的浮层：
  * `class="mh-popup mh-select__panel mh-popup--anchored"`（状态根 + 本族皮肤 + 显式锚档）、
  * `data-side` / `data-align`（`popup.css` 的定位档）、`popover="auto"`（原生轻 dismiss）。
@@ -27,7 +32,7 @@ export declare const SelectPanel: import("vue").DefineComponent<import("vue").Ex
         type: PropType<ElementRef>;
         default: undefined;
     };
-    /** 是否渲染搜索行（列表形态：`searchable` 或选项多于 8 条；树形态同口径） */
+    /** 是否渲染搜索行（**只认消费方显式开启**：列表形态与树形态同口径，件不按数据量自动决断） */
     searchable: {
         type: BooleanConstructor;
         default: boolean;
@@ -66,7 +71,7 @@ export declare const SelectPanel: import("vue").DefineComponent<import("vue").Ex
         type: PropType<ElementRef>;
         default: undefined;
     };
-    /** 是否渲染搜索行（列表形态：`searchable` 或选项多于 8 条；树形态同口径） */
+    /** 是否渲染搜索行（**只认消费方显式开启**：列表形态与树形态同口径，件不按数据量自动决断） */
     searchable: {
         type: BooleanConstructor;
         default: boolean;

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

@@ -13,7 +13,7 @@ const SelectPanel = /* @__PURE__ */ defineComponent({
       type: Object,
       default: void 0
     },
-    /** 是否渲染搜索行（列表形态：`searchable` 或选项多于 8 条；树形态同口径） */
+    /** 是否渲染搜索行（**只认消费方显式开启**：列表形态与树形态同口径，件不按数据量自动决断） */
     searchable: {
       type: Boolean,
       default: false
@@ -64,7 +64,9 @@ const SelectPanel = /* @__PURE__ */ defineComponent({
       "value": props.keyword,
       "placeholder": props.searchPlaceholder,
       "onInput": (event) => props.onKeyword?.(event.target.value)
-    }, null)]) : null, slots.default?.()]);
+    }, null)]) : null, createVNode("div", {
+      "class": "mh-select__body"
+    }, [slots.default?.()])]);
   }
 });
 export {

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

@@ -10,7 +10,9 @@
  * 2. **本地过滤树**：搜索行在场时按关键词过滤，命中节点的**祖先链保留**、父节点自身命中则
  *    **整支保留**，并强制全展到命中层（算法与切分都是纯函数，见 `select-tree-filter.ts`）；
  *    命中文本按面层的 `.mh-select__hit` 高亮（靠 `Tree` 的可选 `renderLabel` 钩子落进标签槽）。
- * 3. **面板内限高滚动**：树体包在 `.mh-select__tree` 里（内距 + 限高 + 溢出滚动），长树不撑破面板。
+ * 3. **面板内限高滚动**：限高归面板（`.mh-select__panel` 的 `--ui-select-panel-max-height`）、
+ *    溢出由面板内容区（`.mh-select__body`）承担；本件只把树包在 `.mh-select__tree` 里给内距
+ *    —— 限高不由形态自持，列表形态共用同一份。
  *
  * ## 与 `Select` 的三处有意差异（都是「树不是列表」决定的）
  *
@@ -65,7 +67,7 @@ export declare const SelectTree: import("vue").DefineComponent<import("vue").Ext
         type: StringConstructor;
         default: string;
     };
-    /** 搜索：`true` 强制开；不给时节点总数多于 8 自动开（与 `Select` 同口径） */
+    /** 搜索行是否出现（**只认显式开启**；缺省不出 —— 不在面板里凭空多出一行） */
     searchable: {
         type: BooleanConstructor;
         default: boolean;
@@ -174,7 +176,7 @@ export declare const SelectTree: import("vue").DefineComponent<import("vue").Ext
         type: StringConstructor;
         default: string;
     };
-    /** 搜索：`true` 强制开；不给时节点总数多于 8 自动开（与 `Select` 同口径） */
+    /** 搜索行是否出现（**只认显式开启**；缺省不出 —— 不在面板里凭空多出一行） */
     searchable: {
         type: BooleanConstructor;
         default: boolean;

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

@@ -3,7 +3,7 @@ import { Tree } from "../tree/index.js";
 import { SelectPanel } from "./select-panel.js";
 import { SelectTrigger } from "./select-trigger.js";
 import { createSelectPanelId, createTriggerKeydown, showPanel, hidePanel } from "./select-shared.js";
-import { filterTreeNodes, findTreeNode, treeLabel, splitHighlight, treeChildren, treeNodeKey } from "./select-tree-filter.js";
+import { filterTreeNodes, findTreeNode, treeLabel, splitHighlight, treeNodeKey, treeChildren } from "./select-tree-filter.js";
 const SelectTree = /* @__PURE__ */ defineComponent({
   name: "SelectTree",
   inheritAttrs: false,
@@ -42,7 +42,7 @@ const SelectTree = /* @__PURE__ */ defineComponent({
       type: String,
       default: "请选择"
     },
-    /** 搜索：`true` 强制开；不给时节点总数多于 8 自动开（与 `Select` 同口径） */
+    /** 搜索行是否出现（**只认显式开启**；缺省不出 —— 不在面板里凭空多出一行） */
     searchable: {
       type: Boolean,
       default: false
@@ -132,18 +132,6 @@ const SelectTree = /* @__PURE__ */ defineComponent({
     const childrenOf = (node) => treeChildren(node, props.childrenKey);
     const current = computed(() => props.modelValue ?? inner.value);
     const hasValue = computed(() => current.value !== void 0 && current.value !== "");
-    const nodeCount = computed(() => {
-      let count = 0;
-      const walk = (list) => {
-        for (const node of list) {
-          count += 1;
-          walk(childrenOf(node));
-        }
-      };
-      walk(props.nodes);
-      return count;
-    });
-    const showSearch = computed(() => props.searchable || nodeCount.value > 8);
     const collectKeys = (list) => list.flatMap((node) => [keyOf(node), ...collectKeys(childrenOf(node))]);
     const innerExpanded = ref(props.defaultExpandAll ? collectKeys(props.nodes) : [...props.defaultExpandedKeys]);
     watch(() => props.defaultExpandedKeys, (next) => {
@@ -221,7 +209,7 @@ const SelectTree = /* @__PURE__ */ defineComponent({
       }, null), createVNode(SelectPanel, {
         "id": panelId,
         "elementRef": panelRef,
-        "searchable": showSearch.value,
+        "searchable": props.searchable,
         "keyword": keyword.value,
         "onKeyword": (value) => {
           keyword.value = value;

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, {