@manohub/ui 0.6.0 → 0.7.0

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 | "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" | "wrench" | "plus" | "bell" | "settings" | "logout" | "home" | "workbench" | "grid-dots" | "heart" | "heart-filled" | "edit" | "refresh" | "upload" | "save" | "more" | "eye" | "external-link" | "minus" | "plus-circle" | "close-circle" | "list" | "calendar" | "clock" | "lock" | "unlock" | "users" | "archive" | "package" | "plug" | "branch" | "tag" | "sparkles" | "shield-check" | "shield-alert" | "history";
+    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";
     title: string;
     onClose: () => void;
     tone: NotificationTone;

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

@@ -1,5 +1,7 @@
 import { type PropType } from 'vue';
 import type { ControlSize } from '../control-size';
+/** 搜索触发位的形态：`text` 主色文案按钮 / `icon` 纯图标按钮 */
+export type SearchAction = 'text' | 'icon';
 export interface SearchProps {
     /** 受控值 */
     modelValue?: string;
@@ -14,8 +16,10 @@ export interface SearchProps {
     clearable?: boolean;
     /** 搜索中：按钮进加载态并吞掉重复点击 */
     loading?: boolean;
-    /** 搜索按钮文案；**不传即纯图标按钮**（窄工具条里的形态） */
+    /** 搜索按钮文案；**不传即不渲染按钮**（只留框内放大镜，提交走回车） */
     searchText?: string;
+    /** 触发位形态（配合 `searchText` 或单独给）：`text` 文案按钮 / `icon` 纯图标按钮 */
+    action?: SearchAction;
     /** 值变更回调（每次输入都调，含清空） */
     onChange?: (value: string) => void;
     /** 搜索触发（点搜索按钮 / 输入框内回车） */
@@ -24,7 +28,20 @@ export interface SearchProps {
     onClear?: () => void;
 }
 /**
- * 搜索框（**自绘**；输入框 + 搜索触发位的组合件）。
+ * 搜索框（**自绘**；输入框 + 可选搜索触发位的组合件）。
+ *
+ * ## 三种形态（**同屏只会出现一个「搜索」字形**）
+ *
+ * | 形态 | 怎么给 | 框内放大镜 | 右侧触发位 |
+ * | --- | --- | --- | --- |
+ * | 只有回车（缺省） | 什么都不给 | ✅ | 无 |
+ * | 图标按钮 | `action="icon"` | ❌（让给按钮） | 主色图标按钮 |
+ * | 文案按钮 | `searchText="搜索"` | ✅ | 主色文案按钮 |
+ *
+ * **框内放大镜与图标按钮不会同时出现** —— 两者是同一个语义的两种画法，
+ * 摆在一起就是「一行里两个放大镜，分不出哪个能点」（0.6.0 的缺陷，0.6.1 靠「不给按钮」绕开，
+ * 0.7.0 起由 `action="icon"` 把「图标按钮」这一档补上，取图标按钮时框内自动不再画装饰）。
+ * 缺省形态的提交走**回车**（`Input` 的 `onEnter` 与 `onSearch` 是同一次语义）。
  *
  * ## 为什么不是 `Input` 的一个档，而是单独一件
  *
@@ -38,14 +55,14 @@ export interface SearchProps {
  * ## 复用而不是重画
  *
  * 输入框那一段**就是本包的 `Input`**（框、内距、清除位、聚焦态、禁用态、`aria-invalid`
- * 全部沿用输入框面），本件只加「一行里怎么摆」与搜索按钮 —— 不另写一份输入框几何
+ * 全部沿用输入框面），本件只加「一行里怎么摆」与（可选的）搜索按钮 —— 不另写一份输入框几何
  * （两份几何必然在改令牌时漂开）。
  *
  * ## 受控口径（与全库同款）
  *
  * 传 `modelValue` 即受控（`update:modelValue` 与 `onChange` 双走），不传即非受控（由 `defaultValue` 起）。
  *
- * @example 最简（图标按钮）
+ * @example 最简（框内放大镜 + 回车触发）
  * <Search modelValue={kw} onChange={setKw} onSearch={apply} />
  *
  * @example 带文案的搜索按钮 + 清空动作
@@ -57,6 +74,9 @@ export interface SearchProps {
  *   onSearch={apply}
  *   onClear={() => apply('')}
  * />
+ *
+ * @example 纯图标按钮（框内不再画装饰放大镜；`searchText` 退化为无障碍名）
+ * <Search modelValue={kw} action="icon" search-text="搜索" onChange={setKw} onSearch={apply} />
  */
 export declare const Search: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     modelValue: {
@@ -91,6 +111,10 @@ export declare const Search: import("vue").DefineComponent<import("vue").Extract
         type: StringConstructor;
         default: undefined;
     };
+    action: {
+        type: PropType<SearchAction>;
+        default: undefined;
+    };
     onChange: {
         type: PropType<(value: string) => void>;
         default: undefined;
@@ -138,6 +162,10 @@ export declare const Search: import("vue").DefineComponent<import("vue").Extract
         type: StringConstructor;
         default: undefined;
     };
+    action: {
+        type: PropType<SearchAction>;
+        default: undefined;
+    };
     onChange: {
         type: PropType<(value: string) => void>;
         default: undefined;
@@ -162,6 +190,7 @@ export declare const Search: import("vue").DefineComponent<import("vue").Extract
     modelValue: string;
     clearable: boolean;
     searchText: string;
+    action: SearchAction;
     onSearch: (value: string) => void;
     onClear: () => void;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/components/search/index.js

@@ -38,6 +38,10 @@ const Search = /* @__PURE__ */ defineComponent({
       type: String,
       default: void 0
     },
+    action: {
+      type: String,
+      default: void 0
+    },
     onChange: {
       type: Function,
       default: void 0
@@ -69,6 +73,9 @@ const Search = /* @__PURE__ */ defineComponent({
       if (cleared) props.onClear?.();
     };
     const search = () => props.onSearch?.(current.value ?? "");
+    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
@@ -82,22 +89,31 @@ const Search = /* @__PURE__ */ defineComponent({
       "onChange": commit,
       "onEnter": search
     }, {
-      prefix: () => createVNode(Icon, {
-        "name": "search"
-      }, null)
-    }), createVNode(Button, {
+      default: () => [iconAction.value ? {} : {
+        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": props.searchText ? "primary" : "icon",
+      "variant": "primary",
       "size": props.size,
       "icon": "search",
       "disabled": props.disabled,
       "loading": props.loading,
-      "title": props.searchText ? void 0 : "搜索",
-      "aria-label": props.searchText ? void 0 : "搜索",
       "onClick": search
     }, {
       default: () => props.searchText
-    })]);
+    }) : null]);
   }
 });
 export {

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

@@ -37,7 +37,8 @@ export interface TablePagination {
  * ## 这个组件负责什么、不负责什么（都是刻意的）
  *
  * **负责**：把 `columns` × `data` 渲成表格；列对齐/宽度/省略/必填；行选中（勾选列复用本包的 `Checkbox`
- * 组件 —— 它内部才是真实 `<input type="checkbox">`，故面上的 `tr:has(input:checked)` 零 JS 路径仍成立）；
+ * 组件 —— 它内部才是真实 `<input type="checkbox">`，故面上的 `tr:has(.mh-table__col-check input:checked)`
+ * 零 JS 路径仍成立；选择器**限定在勾选列内**，否则功能列的 `Switch` 也会把整行点亮）；
  * 展开行；排序按钮的**状态与事件**；加载态与空态；分页条的排布与事件透传；
  * `rowClass` / `onRow` 让调用方标分组行、禁用行与挂行级点击。
  *

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

@@ -100,7 +100,9 @@ export declare const Tabs: import("vue").DefineComponent<import("vue").ExtractPr
         type: PropType<() => void>;
         default: undefined;
     };
-}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    'update:value': (value: TabsValue) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     options: {
         type: PropType<TabsOption[]>;
         required: true;
@@ -160,7 +162,9 @@ export declare const Tabs: import("vue").DefineComponent<import("vue").ExtractPr
         type: PropType<() => void>;
         default: undefined;
     };
-}>> & Readonly<{}>, {
+}>> & Readonly<{
+    "onUpdate:value"?: ((value: TabsValue) => any) | undefined;
+}>, {
     size: ControlSize;
     value: TabsValue | undefined;
     type: TabsType;

package/dist/components/tabs/index.js

@@ -64,10 +64,17 @@ const Tabs = /* @__PURE__ */ defineComponent({
       default: void 0
     }
   },
+  /* 受控值必须 emit 回 `update:value`，否则 `v-model:value="x"` 是**静默失效**的：
+     受控时 `props.value !== undefined` ⇒ 内部状态不更新，而外部又收不到新值 ⇒ 点 tab 毫无反应
+     （不报错、不警告）。本件 0.6.x 就漏了这条 —— 文档示例教 `v-model:value` 却点了不动。 */
+  emits: {
+    "update:value": (value) => true
+  },
   slots: Object,
   setup(props, {
     slots,
-    attrs
+    attrs,
+    emit
   }) {
     const innerValue = ref(props.value ?? props.defaultValue ?? props.options[0]?.value);
     const current = computed(() => props.value ?? innerValue.value);
@@ -76,6 +83,7 @@ const Tabs = /* @__PURE__ */ defineComponent({
       const target = props.options.find((option) => option.value === value);
       if (target?.disabled) return;
       if (props.value === void 0) innerValue.value = value;
+      emit("update:value", value);
       props.onChange?.(value);
     };
     const isClosable = (option) => option.closable ?? props.closable;

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

@@ -68,7 +68,9 @@ export declare const Tabset: import("vue").DefineComponent<import("vue").Extract
         type: BooleanConstructor;
         default: boolean;
     };
-}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    'update:value': (value: string | number) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     options: {
         type: PropType<TabsetOption[]>;
         required: true;
@@ -90,7 +92,9 @@ export declare const Tabset: import("vue").DefineComponent<import("vue").Extract
         type: BooleanConstructor;
         default: boolean;
     };
-}>> & Readonly<{}>, {
+}>> & Readonly<{
+    "onUpdate:value"?: ((value: string | number) => any) | undefined;
+}>, {
     value: string | number | undefined;
     onChange: (value: string | number) => void;
     defaultValue: string | number | undefined;

package/dist/components/tabset/index.js

@@ -25,10 +25,16 @@ const Tabset = /* @__PURE__ */ defineComponent({
       default: false
     }
   },
+  /* 同 `Tabs`：受控值必须 emit 回 `update:value`，否则 `v-model:value="current"` 静默失效
+     （受控时内部状态不更新、外部又收不到 ⇒ 点选项毫无反应）。 */
+  emits: {
+    "update:value": (value) => true
+  },
   slots: Object,
   setup(props, {
     slots,
-    attrs
+    attrs,
+    emit
   }) {
     const innerValue = ref(props.value ?? props.defaultValue ?? props.options[0]?.value);
     const current = computed(() => props.value ?? innerValue.value);
@@ -36,6 +42,7 @@ const Tabset = /* @__PURE__ */ defineComponent({
       const target = props.options.find((option) => option.value === value);
       if (target?.disabled) return;
       if (props.value === void 0) innerValue.value = value;
+      emit("update:value", value);
       props.onChange?.(value);
     };
     const panels = () => {

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: "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" | "wrench" | "plus" | "bell" | "settings" | "logout" | "home" | "workbench" | "grid-dots" | "heart" | "heart-filled" | "edit" | "refresh" | "upload" | "save" | "more" | "eye" | "external-link" | "minus" | "plus-circle" | "close-circle" | "list" | "calendar" | "clock" | "lock" | "unlock" | "users" | "archive" | "package" | "plug" | "branch" | "tag" | "sparkles" | "shield-check" | "shield-alert" | "history";
+    icon: "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";
     disabled: boolean;
     name: string;
     value: string | number;

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

@@ -0,0 +1,120 @@
+import { type PropType, type SlotsType, type VNodeChild } from 'vue';
+/** 字号档（每档都有一枚配套的行高令牌，故**不开放**只有字号的 micro / display） */
+export type TextSize = 'caption' | 'body' | 'heading' | 'title';
+/** 语义色档（`success` / `warning` 取 `-strong`，与 `Notice` / `Dialog` 同一张表） */
+export type TextTone = 'default' | 'muted' | 'subtle' | 'primary' | 'success' | 'warning' | 'error';
+/** 字重档（缺省**不设**，即继承上下文 —— 这样「在已加粗的区域里放一段普通文字」不必显式写 regular） */
+export type TextWeight = 'regular' | 'medium' | 'semibold';
+/** 承载标签（只开放语义明确的这几个；`as` 决定语义，`size` 决定视觉，两者**有意解耦**） */
+export type TextTag = 'span' | 'p' | 'div' | 'label' | 'small' | 'strong' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+export interface TextProps {
+    /** 字号档（缺省 `body` = 14/20） */
+    size?: TextSize;
+    /** 语义色档（缺省 `default` = 正文色） */
+    tone?: TextTone;
+    /** 字重档（缺省不设，继承上下文） */
+    weight?: TextWeight;
+    /** 等宽族（代码、路径、ID 一类） */
+    mono?: boolean;
+    /** 截断：`true` 单行省略 / 数字 = 最多 N 行省略 */
+    truncate?: boolean | number;
+    /** 承载标签（缺省 `span`；语义标签如 `h2` / `p` / `label` 用它，视觉仍由 `size` 定） */
+    as?: TextTag;
+}
+/**
+ * 文本排版（**最小排版件**：字号 / 行高 / 字重 / 语义色 / 等宽 / 截断六个维度）。
+ *
+ * ## 为什么需要它
+ *
+ * `theme` 一直有 `--ui-font-{caption,body,heading,title}` 与 `--ui-font-mono` 这套档位令牌，
+ * 但**没有件消费它们**：卡片描述、表单说明、只读值、列表次级信息这些「容器里的文字层级」
+ * 于是无处可归 —— `Card` 只管卡片外壳，`Panel` 只管区域，两者都不管内容里的排版；
+ * 而契约 L1-5 又禁应用侧写 `font-*` / `color`。**令牌有了、路径没有**，
+ * 结果就是每个应用都要为「卡片里的文字」保留一条定版例外登记（本仓 repository 的 31 处里，
+ * 绝大多数属于这一类）。本件把这条路径补上。
+ *
+ * ## 与 `Title` / 平台默认的关系
+ *
+ * 浏览器给 `h1`-`h6` 的字阶已被 reset 归零（`font-size: inherit` / `font-weight: inherit`），
+ * 所以 `as="h2"` 只贡献**语义**，视觉完全由 `size` / `weight` 决定 ——
+ * 这与「标题的字阶必须跟设计稿」不冲突：要多大显式给 `size`。
+ *
+ * ## 不做什么
+ *
+ * - **不做富文本**：不解析 markdown、不认 `**加粗**`（富文本排版的归属见 `@manohub/kit/CONTRACT.md` §10）；
+ * - **不做省略的展开**：截断只表示「显示不下就省略」，需要「展开全文」交互的走业务自己实现；
+ * - **不承载色底 / 描边 / 内距**：那是 `Tag` / `Badge` / `Card` 的事。
+ *
+ * @example 卡片里的三行信息（标题 / 描述 / 元信息）
+ * <Text as="h3" size="heading" weight="semibold">{repo.name}</Text>
+ * <Text tone="muted" truncate>{repo.url}</Text>
+ * <Text as="small" size="caption" tone="subtle">{repo.updatedAt}</Text>
+ *
+ * @example 只读值 + 等宽
+ * <Text mono>{task.id}</Text>
+ *
+ * @example 最多两行，超出省略
+ * <Text :truncate="2">{longDescription}</Text>
+ */
+export declare const Text: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    size: {
+        type: PropType<TextSize>;
+        default: string;
+    };
+    tone: {
+        type: PropType<TextTone>;
+        default: string;
+    };
+    weight: {
+        type: PropType<TextWeight>;
+        default: undefined;
+    };
+    mono: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    truncate: {
+        type: PropType<boolean | number>;
+        default: boolean;
+    };
+    as: {
+        type: PropType<TextTag>;
+        default: string;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    size: {
+        type: PropType<TextSize>;
+        default: string;
+    };
+    tone: {
+        type: PropType<TextTone>;
+        default: string;
+    };
+    weight: {
+        type: PropType<TextWeight>;
+        default: undefined;
+    };
+    mono: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    truncate: {
+        type: PropType<boolean | number>;
+        default: boolean;
+    };
+    as: {
+        type: PropType<TextTag>;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    size: TextSize;
+    weight: TextWeight;
+    tone: TextTone;
+    mono: boolean;
+    truncate: number | boolean;
+    as: TextTag;
+}, SlotsType<{
+    default?: () => VNodeChild;
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/components/text/index.js

@@ -0,0 +1,55 @@
+import { defineComponent, h } from "vue";
+const Text = /* @__PURE__ */ defineComponent({
+  name: "Text",
+  inheritAttrs: false,
+  props: {
+    size: {
+      type: String,
+      default: "body"
+    },
+    tone: {
+      type: String,
+      default: "default"
+    },
+    weight: {
+      type: String,
+      default: void 0
+    },
+    mono: {
+      type: Boolean,
+      default: false
+    },
+    truncate: {
+      type: [Boolean, Number],
+      default: false
+    },
+    as: {
+      type: String,
+      default: "span"
+    }
+  },
+  slots: Object,
+  setup(props, {
+    attrs,
+    slots
+  }) {
+    return () => {
+      const lines = props.truncate === true ? 1 : typeof props.truncate === "number" && props.truncate >= 1 ? Math.floor(props.truncate) : 0;
+      const classes = ["mh-text", `mh-text--${props.size}`, `mh-text--${props.tone}`, props.weight ? `mh-text--${props.weight}` : "", props.mono ? "mh-text--mono" : "", lines === 1 ? "mh-text--truncate" : "", lines > 1 ? "mh-text--clamp" : "", attrs.class].filter(Boolean).join(" ");
+      const style = {
+        ...lines > 1 ? {
+          "--mh-text-lines": String(lines)
+        } : {},
+        ...attrs.style
+      };
+      return h(props.as, {
+        ...attrs,
+        class: classes,
+        style
+      }, [slots.default?.()]);
+    };
+  }
+});
+export {
+  Text
+};

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

@@ -99,7 +99,7 @@ export declare const Toast: import("vue").DefineComponent<import("vue").ExtractP
     onClose?: (() => any) | undefined;
 }>, {
     text: string;
-    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" | "wrench" | "plus" | "bell" | "settings" | "logout" | "home" | "workbench" | "grid-dots" | "heart" | "heart-filled" | "edit" | "refresh" | "upload" | "save" | "more" | "eye" | "external-link" | "minus" | "plus-circle" | "close-circle" | "list" | "calendar" | "clock" | "lock" | "unlock" | "users" | "archive" | "package" | "plug" | "branch" | "tag" | "sparkles" | "shield-check" | "shield-alert" | "history";
+    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";
     tone: ToastTone;
     closable: boolean;
     action: string;
@@ -151,7 +151,7 @@ export declare const ToastCompound: {
         close: () => true;
     }, import("vue").PublicProps, {
         text: string;
-        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" | "wrench" | "plus" | "bell" | "settings" | "logout" | "home" | "workbench" | "grid-dots" | "heart" | "heart-filled" | "edit" | "refresh" | "upload" | "save" | "more" | "eye" | "external-link" | "minus" | "plus-circle" | "close-circle" | "list" | "calendar" | "clock" | "lock" | "unlock" | "users" | "archive" | "package" | "plug" | "branch" | "tag" | "sparkles" | "shield-check" | "shield-alert" | "history";
+        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";
         tone: ToastTone;
         closable: boolean;
         action: string;
@@ -205,7 +205,7 @@ export declare const ToastCompound: {
         onClose?: (() => any) | undefined;
     }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, {
         text: string;
-        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" | "wrench" | "plus" | "bell" | "settings" | "logout" | "home" | "workbench" | "grid-dots" | "heart" | "heart-filled" | "edit" | "refresh" | "upload" | "save" | "more" | "eye" | "external-link" | "minus" | "plus-circle" | "close-circle" | "list" | "calendar" | "clock" | "lock" | "unlock" | "users" | "archive" | "package" | "plug" | "branch" | "tag" | "sparkles" | "shield-check" | "shield-alert" | "history";
+        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";
         tone: ToastTone;
         closable: boolean;
         action: string;
@@ -256,7 +256,7 @@ export declare const ToastCompound: {
     close: () => true;
 }, string, {
     text: string;
-    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" | "wrench" | "plus" | "bell" | "settings" | "logout" | "home" | "workbench" | "grid-dots" | "heart" | "heart-filled" | "edit" | "refresh" | "upload" | "save" | "more" | "eye" | "external-link" | "minus" | "plus-circle" | "close-circle" | "list" | "calendar" | "clock" | "lock" | "unlock" | "users" | "archive" | "package" | "plug" | "branch" | "tag" | "sparkles" | "shield-check" | "shield-alert" | "history";
+    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";
     tone: ToastTone;
     closable: boolean;
     action: string;

package/dist/components/toast/index.js

@@ -67,11 +67,20 @@ const Toast = /* @__PURE__ */ defineComponent({
     return () => {
       const hasAction = Boolean(props.action || slots.action);
       return createVNode("div", {
-        "class": ["mh-toast", props.tone === "loading" ? "mh-toast--loading" : "", hasAction ? "mh-toast--action" : "", attrs.class].filter(Boolean).join(" "),
+        "class": [
+          "mh-toast",
+          /* 语义档一律落在**根修饰符**：`.mh-<件>--<tone>` 是本包 tone 维度的统一落点
+             （`Badge` / `Dialog` / `Notice` / `Notification` / `Tag` / `Text` 同款）。
+             此前本件把 tone 落在 `.mh-toast__icon--<tone>`，是唯一一个落子元素修饰符的 ——
+             消费方按「组件名 → 类名」的直觉拼 `.mh-toast--success` 会落空（缺陷 §3.5）。 */
+          `mh-toast--${props.tone}`,
+          hasAction ? "mh-toast--action" : "",
+          attrs.class
+        ].filter(Boolean).join(" "),
         "style": attrs.style,
         "role": "status"
       }, [props.icon === false ? null : createVNode("span", {
-        "class": ["mh-toast__icon", `mh-toast__icon--${props.tone}`].join(" ")
+        "class": "mh-toast__icon"
       }, [createVNode(Icon, {
         "name": typeof props.icon === "string" ? props.icon : TONE_ICON[props.tone],
         "size": props.tone === "loading" ? 16 : 12

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

@@ -40,6 +40,12 @@ export declare const Upload: import("vue").DefineComponent<import("vue").Extract
         type: StringConstructor;
         default: undefined;
     };
+    /**
+     * 是否允许多选（**默认关**，与主流一致）。
+     *
+     * 0.6.x 默认开 + `maxCount` 默认 0（不限量）⇒ 拖入一堆文件会被**静默全部接收** ——
+     * 单文件场景（换头像、传一份合同）因此多收文件且不报错。要多选请显式 `multiple`。
+     */
     multiple: {
         type: BooleanConstructor;
         default: boolean;
@@ -94,6 +100,12 @@ export declare const Upload: import("vue").DefineComponent<import("vue").Extract
         type: StringConstructor;
         default: undefined;
     };
+    /**
+     * 是否允许多选（**默认关**，与主流一致）。
+     *
+     * 0.6.x 默认开 + `maxCount` 默认 0（不限量）⇒ 拖入一堆文件会被**静默全部接收** ——
+     * 单文件场景（换头像、传一份合同）因此多收文件且不报错。要多选请显式 `multiple`。
+     */
     multiple: {
         type: BooleanConstructor;
         default: boolean;
@@ -164,6 +176,12 @@ export declare const UploadCompound: {
             type: StringConstructor;
             default: undefined;
         };
+        /**
+         * 是否允许多选（**默认关**，与主流一致）。
+         *
+         * 0.6.x 默认开 + `maxCount` 默认 0（不限量）⇒ 拖入一堆文件会被**静默全部接收** ——
+         * 单文件场景（换头像、传一份合同）因此多收文件且不报错。要多选请显式 `multiple`。
+         */
         multiple: {
             type: BooleanConstructor;
             default: boolean;
@@ -239,6 +257,12 @@ export declare const UploadCompound: {
             type: StringConstructor;
             default: undefined;
         };
+        /**
+         * 是否允许多选（**默认关**，与主流一致）。
+         *
+         * 0.6.x 默认开 + `maxCount` 默认 0（不限量）⇒ 拖入一堆文件会被**静默全部接收** ——
+         * 单文件场景（换头像、传一份合同）因此多收文件且不报错。要多选请显式 `multiple`。
+         */
         multiple: {
             type: BooleanConstructor;
             default: boolean;
@@ -309,6 +333,12 @@ export declare const UploadCompound: {
         type: StringConstructor;
         default: undefined;
     };
+    /**
+     * 是否允许多选（**默认关**，与主流一致）。
+     *
+     * 0.6.x 默认开 + `maxCount` 默认 0（不限量）⇒ 拖入一堆文件会被**静默全部接收** ——
+     * 单文件场景（换头像、传一份合同）因此多收文件且不报错。要多选请显式 `multiple`。
+     */
     multiple: {
         type: BooleanConstructor;
         default: boolean;

package/dist/components/upload/index.js

@@ -19,9 +19,15 @@ const Upload = /* @__PURE__ */ defineComponent({
       type: String,
       default: void 0
     },
+    /**
+     * 是否允许多选（**默认关**，与主流一致）。
+     *
+     * 0.6.x 默认开 + `maxCount` 默认 0（不限量）⇒ 拖入一堆文件会被**静默全部接收** ——
+     * 单文件场景（换头像、传一份合同）因此多收文件且不报错。要多选请显式 `multiple`。
+     */
     multiple: {
       type: Boolean,
-      default: true
+      default: false
     },
     disabled: {
       type: Boolean,

package/dist/index.d.ts

@@ -27,6 +27,7 @@ export { Avatar, type AvatarProps, type AvatarSize, type AvatarCompound } from '
 export { Skeleton, type SkeletonProps } from './components/skeleton';
 export { Radio, type RadioProps, type RadioCompound, type RadioCompoundType, type RadioCardItem, type RadioCardValue, } from './components/radio';
 export { Tag, type TagProps } from './components/tag';
+export { Text, type TextProps, type TextSize, type TextTone, type TextWeight, type TextTag, } from './components/text';
 export { Tree, type TreeNode } from './components/tree';
 export { ListView, type ListViewProps, type ListViewStatus, type ListViewStatusTone, type ListViewCardItemProps, type ListViewCompound, } from './components/list-view';
 export { Badge, type BadgeTone, type BadgeShape, type BadgeSize, type BadgeDot, type BadgeStatus, } from './components/badge';