@manohub/ui 0.6.1 → 0.7.1

package/dist/components/tabs/index.js

@@ -1,153 +1,129 @@
-import { defineComponent, ref, computed, createVNode, Fragment, mergeProps } from "vue";
-import { Icon } from "@manohub/icon";
+import { defineComponent, ref, createVNode } from "vue";
+import { TabBar } from "../tabbar/index.js";
+const TabPanel = /* @__PURE__ */ defineComponent({
+  name: "TabPanel",
+  /* 渲染的是插槽内容（片段根），属性无处可继承 —— 壳归 `Tabs`，属性由它在渲染期搬过去 */
+  inheritAttrs: false,
+  props: {
+    name: {
+      type: String,
+      required: true
+    },
+    value: {
+      type: [String, Number],
+      default: void 0
+    },
+    disabled: {
+      type: Boolean,
+      default: false
+    },
+    lazy: {
+      type: Boolean,
+      default: false
+    }
+  },
+  slots: Object,
+  setup(_props, {
+    slots
+  }) {
+    return () => slots.default?.() ?? null;
+  }
+});
+const flattenChildren = (raw) => (Array.isArray(raw) ? raw : raw == null ? [] : [raw]).flatMap((child) => Array.isArray(child) ? child : [child]).filter((child) => child !== null && child !== void 0 && child !== false && child !== true && child !== "");
+const isTabPanel = (child) => !!child && typeof child === "object" && child.type === TabPanel;
+const panelPropsOf = (child) => isTabPanel(child) ? child.props ?? {} : null;
 const Tabs = /* @__PURE__ */ defineComponent({
   name: "Tabs",
   inheritAttrs: false,
   props: {
     options: {
       type: Array,
-      required: true
+      default: void 0
     },
-    /** 受控选中值；不传即非受控（由 `defaultValue` 起） */
     value: {
       type: [String, Number],
       default: void 0
     },
-    /** 非受控初始选中值，缺省第一项 */
     defaultValue: {
       type: [String, Number],
       default: void 0
     },
-    /** 选中变化回调（受控与非受控都会调） */
     onChange: {
       type: Function,
       default: void 0
     },
-    /** 形态：`line` 下划线 / `card` 选项卡 */
-    type: {
-      type: String,
-      default: "line"
-    },
-    /** 整体居中（页签少、要撑满整行时用） */
-    centered: {
-      type: Boolean,
-      default: false
-    },
-    /** 尺寸档（24 / 32 / 40，只覆盖令牌） */
-    size: {
-      type: String,
-      default: "md"
-    },
-    /** 每项带关闭位（单项可用 `option.closable` 覆写） */
-    closable: {
-      type: Boolean,
-      default: false
-    },
-    /** 尾部「新增」按钮 */
-    addable: {
+    lazy: {
       type: Boolean,
       default: false
-    },
-    /** 「更多」页签的文字 */
-    moreLabel: {
-      type: String,
-      default: "更多"
-    },
-    /** 关闭某项（只回调，**不从 `options` 里删** —— 数据归调用方） */
-    onClose: {
-      type: Function,
-      default: void 0
-    },
-    /** 点新增（只回调） */
-    onAdd: {
-      type: Function,
-      default: void 0
     }
   },
+  /* 同 `TabBar`：受控值必须 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);
-    const moreId = `mh-tabs-${Math.random().toString(36).slice(2, 10)}`;
+    const innerValue = ref(props.defaultValue);
+    let items = [];
     const select = (value) => {
-      const target = props.options.find((option) => option.value === value);
-      if (target?.disabled) return;
+      if (items.find((option) => option.value === value)?.disabled) return;
       if (props.value === void 0) innerValue.value = value;
+      emit("update:value", value);
       props.onChange?.(value);
     };
-    const isClosable = (option) => option.closable ?? props.closable;
-    return () => createVNode("nav", {
-      "class": [
-        "mh-tabs",
-        /* `mh-popup-host` 是操作层展开转向的**宿主标记**（popup.css 靠它 :has 反推面板开合）：
-           没有它，「更多」的 caret 展开时不会翻向 —— 与 Select / Tooltip 同一分工。 */
-        "mh-popup-host",
-        props.type === "card" ? "mh-tabs--card" : "",
-        props.centered ? "mh-tabs--centered" : "",
-        props.size === "md" ? "" : `mh-tabs--${props.size}`,
-        attrs.class
-      ].filter(Boolean).join(" "),
-      "style": attrs.style,
-      "role": "tablist"
-    }, [props.options.map((option) => {
-      const active = option.value === current.value;
-      return createVNode("button", {
-        "key": option.value,
-        "type": "button",
-        "role": "tab",
-        "class": ["mh-tabs__tab", active ? "is-selected" : "", option.disabled ? "is-disabled" : ""].filter(Boolean).join(" "),
-        "data-state": active ? "active" : "inactive",
-        "aria-selected": active,
-        "disabled": option.disabled,
-        "onClick": () => select(option.value)
-      }, [option.label, isClosable(option) && !option.disabled ? (
-        /* 关闭位不是 `<button>`：页签自己是按钮，按钮里嵌按钮是非法 HTML。
-           用 `role="button"` + `stopPropagation` 表达同样的语义与行为。 */
-        createVNode("span", {
-          "class": "mh-tabs__close",
-          "role": "button",
-          "tabindex": -1,
-          "aria-label": `关闭${option.label}`,
-          "onClick": (event) => {
-            event.stopPropagation();
-            event.preventDefault();
-            props.onClose?.(option.value);
-          }
-        }, [createVNode(Icon, {
-          "name": "close"
-        }, null)])
-      ) : null]);
-    }), props.addable ? createVNode("button", {
-      "type": "button",
-      "class": "mh-tabs__add",
-      "aria-label": "新增页签",
-      "onClick": () => props.onAdd?.()
-    }, [createVNode(Icon, {
-      "name": "plus"
-    }, null)]) : null, slots.more ? createVNode(Fragment, null, [createVNode("button", mergeProps({
-      "type": "button",
-      "class": "mh-tabs__tab mh-tabs__tab--more",
-      "data-state": "inactive"
-    }, {
-      popovertarget: moreId
-    }), [props.moreLabel, createVNode(Icon, {
-      "name": "chevron-down",
-      "class": "mh-popup-caret"
-    }, null)]), createVNode("div", mergeProps({
-      "id": moreId,
-      "class": "mh-popup",
-      "data-side": "bottom",
-      "data-align": "end"
-    }, {
-      popover: "auto"
-    }), [slots.more({
-      options: props.options
-    })])]) : null]);
+    return () => {
+      const nodes = flattenChildren(slots.default?.());
+      const panelMode = nodes.some(isTabPanel);
+      const list = panelMode ? nodes.filter(isTabPanel) : nodes;
+      const blockItems = list.map((node, index) => {
+        const info = panelPropsOf(node);
+        if (info) {
+          return {
+            label: info.name,
+            value: info.value ?? info.name,
+            disabled: info.disabled ?? false
+          };
+        }
+        return props.options?.[index] ?? null;
+      });
+      items = blockItems.filter((item) => item !== null);
+      const current = props.value ?? innerValue.value ?? items[0]?.value;
+      const panels = list.map((node, index) => {
+        const item = blockItems[index];
+        const info = panelPropsOf(node);
+        const active = item !== null && item.value === current;
+        if ((props.lazy || info?.lazy) && !active) return null;
+        const raw = info ? node.props ?? {} : {};
+        return createVNode("div", {
+          "key": String(item?.value ?? index),
+          "class": ["mh-tabs-panel", raw.class].filter(Boolean).join(" "),
+          "style": raw.style,
+          "hidden": !active
+        }, [node]);
+      });
+      return createVNode("div", {
+        "class": ["mh-tabs", attrs.class].filter(Boolean).join(" "),
+        "style": attrs.style
+      }, [slots.selector ? slots.selector({
+        value: current,
+        options: items,
+        select
+      }) : createVNode(TabBar, {
+        "options": items,
+        "value": current,
+        "onChange": select
+      }, null), createVNode("div", {
+        "class": "mh-tabs-panels"
+      }, [panels])]);
+    };
   }
 });
 export {
+  TabPanel,
   Tabs
 };

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: "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";
     disabled: boolean;
     name: string;
     value: string | number;
@@ -196,8 +196,8 @@ export declare const Tag: import("vue").DefineComponent<import("vue").ExtractPro
     selected: boolean;
     lg: boolean;
     shape: "add" | "select" | "chip" | "regular" | "status" | undefined;
-    tone: "error" | "info" | "success" | "warning" | undefined;
     closable: boolean;
+    tone: "error" | "info" | "success" | "warning" | undefined;
 }, SlotsType<{
     default?: () => VNodeChild;
 }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

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,9 +99,9 @@ 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";
-    tone: ToastTone;
+    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";
     closable: boolean;
+    tone: ToastTone;
     action: string;
     onAction: () => void;
     duration: number;
@@ -151,9 +151,9 @@ 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";
-        tone: ToastTone;
+        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";
         closable: boolean;
+        tone: ToastTone;
         action: string;
         onAction: () => void;
         duration: number;
@@ -205,9 +205,9 @@ 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";
-        tone: ToastTone;
+        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";
         closable: boolean;
+        tone: ToastTone;
         action: string;
         onAction: () => void;
         duration: number;
@@ -256,9 +256,9 @@ 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";
-    tone: ToastTone;
+    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";
     closable: boolean;
+    tone: ToastTone;
     action: string;
     onAction: () => void;
     duration: number;

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,