@manohub/ui 1.0.0 → 1.0.2

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

@@ -218,7 +218,7 @@ export declare const Button: import("vue").DefineComponent<import("vue").Extract
 }>> & Readonly<{}>, {
     block: boolean;
     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" | "info-circle" | "check-circle" | "alert-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" | "application" | "client" | "service" | "schema" | "compose" | "log" | "mcp" | "agent" | "server" | "exposure" | "openapi" | "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" | "page-title" | "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";
     menu: boolean;
     caret: boolean;
     disabled: boolean;
@@ -229,7 +229,7 @@ export declare const Button: import("vue").DefineComponent<import("vue").Extract
     variant: ButtonVariant;
     danger: boolean;
     shape: ButtonShape;
-    trailingIcon: "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";
+    trailingIcon: "search" | "link" | "filter" | "copy" | "help" | "table" | "menu" | "delete" | "image" | "close" | "key" | "application" | "client" | "service" | "schema" | "compose" | "log" | "mcp" | "agent" | "server" | "exposure" | "openapi" | "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" | "page-title" | "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";
     href: string;
     target: string;
     popoverTarget: string;
@@ -325,7 +325,7 @@ export declare const ButtonCompound: {
     }>> & Readonly<{}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, import("vue").PublicProps, {
         block: boolean;
         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" | "info-circle" | "check-circle" | "alert-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" | "application" | "client" | "service" | "schema" | "compose" | "log" | "mcp" | "agent" | "server" | "exposure" | "openapi" | "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" | "page-title" | "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";
         menu: boolean;
         caret: boolean;
         disabled: boolean;
@@ -336,7 +336,7 @@ export declare const ButtonCompound: {
         variant: ButtonVariant;
         danger: boolean;
         shape: ButtonShape;
-        trailingIcon: "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";
+        trailingIcon: "search" | "link" | "filter" | "copy" | "help" | "table" | "menu" | "delete" | "image" | "close" | "key" | "application" | "client" | "service" | "schema" | "compose" | "log" | "mcp" | "agent" | "server" | "exposure" | "openapi" | "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" | "page-title" | "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";
         href: string;
         target: string;
         popoverTarget: string;
@@ -437,7 +437,7 @@ export declare const ButtonCompound: {
     }>> & Readonly<{}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, {
         block: boolean;
         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" | "info-circle" | "check-circle" | "alert-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" | "application" | "client" | "service" | "schema" | "compose" | "log" | "mcp" | "agent" | "server" | "exposure" | "openapi" | "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" | "page-title" | "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";
         menu: boolean;
         caret: boolean;
         disabled: boolean;
@@ -448,7 +448,7 @@ export declare const ButtonCompound: {
         variant: ButtonVariant;
         danger: boolean;
         shape: ButtonShape;
-        trailingIcon: "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";
+        trailingIcon: "search" | "link" | "filter" | "copy" | "help" | "table" | "menu" | "delete" | "image" | "close" | "key" | "application" | "client" | "service" | "schema" | "compose" | "log" | "mcp" | "agent" | "server" | "exposure" | "openapi" | "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" | "page-title" | "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";
         href: string;
         target: string;
         popoverTarget: string;
@@ -543,7 +543,7 @@ export declare const ButtonCompound: {
 }>> & Readonly<{}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, {
     block: boolean;
     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" | "info-circle" | "check-circle" | "alert-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" | "application" | "client" | "service" | "schema" | "compose" | "log" | "mcp" | "agent" | "server" | "exposure" | "openapi" | "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" | "page-title" | "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";
     menu: boolean;
     caret: boolean;
     disabled: boolean;
@@ -554,7 +554,7 @@ export declare const ButtonCompound: {
     variant: ButtonVariant;
     danger: boolean;
     shape: ButtonShape;
-    trailingIcon: "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";
+    trailingIcon: "search" | "link" | "filter" | "copy" | "help" | "table" | "menu" | "delete" | "image" | "close" | "key" | "application" | "client" | "service" | "schema" | "compose" | "log" | "mcp" | "agent" | "server" | "exposure" | "openapi" | "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" | "page-title" | "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";
     href: string;
     target: string;
     popoverTarget: string;

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

@@ -0,0 +1,15 @@
+/**
+ * `bordered` 三档 → 控件类名（**唯一来源**）。
+ *
+ * 输入族三个件（`Input` / `Textarea` / `NumberInput`）共用同一份面与同一个 prop，判定表抄三份必然漂，
+ * 故收在这里。类名口径：prop 是**肯定式**（`bordered`）、类名是**否定式**（`--borderless`）——
+ * 那一对的反差是库内既定口径（见 `docs/guide/naming-and-defaults.md` §2.1）；
+ * `'focus'` 档的类名 `--border-on-focus` 是这套口径下的新成员：它说的就是「聚焦时才有框」。
+ *
+ * | `bordered` | 类名 | 常态 | 悬停 | 聚焦 |
+ * | --- | --- | --- | --- | --- |
+ * | `true`（缺省） | （无） | 有框 | 框变色 | 框变色 + 主色环 |
+ * | `'focus'` | `.mh-input--border-on-focus` | 无框无底 | 复用有框档那句 | 显框 + 主色环（复用） |
+ * | `false` | `.mh-input--borderless` | 无框无底 | 无 | 无（本档效果只有一种） |
+ */
+export declare const borderedClassOf: (bordered: boolean | "focus" | undefined) => string;

package/dist/components/input/bordered.js

@@ -0,0 +1,8 @@
+const borderedClassOf = (bordered) => {
+  if (bordered === "focus") return "mh-input--border-on-focus";
+  if (bordered === false) return "mh-input--borderless";
+  return "";
+};
+export {
+  borderedClassOf
+};

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

@@ -109,11 +109,19 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
         default: boolean;
     };
     /**
-     * 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底，靠悬停与聚焦给反馈）。
-     * 配 `readonly` 即**只读值档**：连悬停底与聚焦框环都退掉（见 `readonly`）。
+     * 有无边框，三档（判定表见 `./bordered.ts`，输入族三件共用）：
+     *
+     * - `true`（缺省）**常有框**；
+     * - `false` **无框** —— 常态、悬停、聚焦都不出现（本档的效果只有一种）；
+     * - `'focus'` **聚焦（与悬停）才显出框** —— 行内编辑那档：常态看着像「值」，点进去才亮框；
+     *   悬停 / 聚焦的表现**复用有框档那两条**，不另写一套。
+     *
+     * 配 `readonly` 即**只读值档**（摘要 / 详情里回显业务值的推荐写法，也是 `Form.Item` 的
+     * `readonly` 行配的那一档）：几何与可编辑输入框完全一致，但不给任何「可编辑」线索。
+     * 只读值档请写 `readonly` + `bordered={false}`；`readonly` + `'focus'` 会被中和（兜底，不推荐）。
      */
     bordered: {
-        type: BooleanConstructor;
+        type: PropType<boolean | "focus">;
         default: boolean;
     };
     maxlength: {
@@ -228,11 +236,19 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
         default: boolean;
     };
     /**
-     * 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底，靠悬停与聚焦给反馈）。
-     * 配 `readonly` 即**只读值档**：连悬停底与聚焦框环都退掉（见 `readonly`）。
+     * 有无边框，三档（判定表见 `./bordered.ts`，输入族三件共用）：
+     *
+     * - `true`（缺省）**常有框**；
+     * - `false` **无框** —— 常态、悬停、聚焦都不出现（本档的效果只有一种）；
+     * - `'focus'` **聚焦（与悬停）才显出框** —— 行内编辑那档：常态看着像「值」，点进去才亮框；
+     *   悬停 / 聚焦的表现**复用有框档那两条**，不另写一套。
+     *
+     * 配 `readonly` 即**只读值档**（摘要 / 详情里回显业务值的推荐写法，也是 `Form.Item` 的
+     * `readonly` 行配的那一档）：几何与可编辑输入框完全一致，但不给任何「可编辑」线索。
+     * 只读值档请写 `readonly` + `bordered={false}`；`readonly` + `'focus'` 会被中和（兜底，不推荐）。
      */
     bordered: {
-        type: BooleanConstructor;
+        type: PropType<boolean | "focus">;
         default: boolean;
     };
     maxlength: {
@@ -289,7 +305,7 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
     type: string;
     onChange: (v: string) => void;
     invalid: boolean;
-    bordered: boolean;
+    bordered: boolean | "focus";
     defaultValue: string;
     placeholder: string;
     autofocus: boolean;
@@ -297,10 +313,10 @@ export declare const Input: import("vue").DefineComponent<import("vue").ExtractP
     status: InputStatus;
     as: "button" | "input";
     readonly: boolean;
+    onEnter: (v: string) => void;
     clearable: boolean;
     maxlength: number;
     showCount: boolean;
-    onEnter: (v: string) => void;
     controlClass: string;
     controlAttrs: Record<string, unknown>;
     hasValue: boolean;
@@ -328,8 +344,8 @@ export interface TextareaProps {
     invalid?: boolean;
     /** 校验状态（`invalid` 的显式写法） */
     status?: InputStatus;
-    /** 是否带边框 */
-    bordered?: boolean;
+    /** 是否带边框（三档口径见 `Input` 的同名 prop：`true` / `false` / `'focus'`） */
+    bordered?: boolean | 'focus';
     maxlength?: number;
     /** 右下角字数统计（须给 `maxlength` 才渲染） */
     showCount?: boolean;
@@ -388,8 +404,9 @@ export declare const Textarea: import("vue").DefineComponent<import("vue").Extra
         type: PropType<InputStatus>;
         default: undefined;
     };
+    /** 是否带边框（三档口径见 `Input` 的同名 prop：`true` 常有框 / `false` 无框 / `'focus'` 聚焦才显框） */
     bordered: {
-        type: BooleanConstructor;
+        type: PropType<boolean | "focus">;
         default: boolean;
     };
     maxlength: {
@@ -453,8 +470,9 @@ export declare const Textarea: import("vue").DefineComponent<import("vue").Extra
         type: PropType<InputStatus>;
         default: undefined;
     };
+    /** 是否带边框（三档口径见 `Input` 的同名 prop：`true` 常有框 / `false` 无框 / `'focus'` 聚焦才显框） */
     bordered: {
-        type: BooleanConstructor;
+        type: PropType<boolean | "focus">;
         default: boolean;
     };
     maxlength: {
@@ -481,7 +499,7 @@ export declare const Textarea: import("vue").DefineComponent<import("vue").Extra
     disabled: boolean;
     onChange: (v: string) => void;
     invalid: boolean;
-    bordered: boolean;
+    bordered: boolean | "focus";
     defaultValue: string;
     placeholder: string;
     rows: number;
@@ -558,11 +576,19 @@ export declare const InputCompound: {
             default: boolean;
         };
         /**
-         * 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底，靠悬停与聚焦给反馈）。
-         * 配 `readonly` 即**只读值档**：连悬停底与聚焦框环都退掉（见 `readonly`）。
+         * 有无边框，三档（判定表见 `./bordered.ts`，输入族三件共用）：
+         *
+         * - `true`（缺省）**常有框**；
+         * - `false` **无框** —— 常态、悬停、聚焦都不出现（本档的效果只有一种）；
+         * - `'focus'` **聚焦（与悬停）才显出框** —— 行内编辑那档：常态看着像「值」，点进去才亮框；
+         *   悬停 / 聚焦的表现**复用有框档那两条**，不另写一套。
+         *
+         * 配 `readonly` 即**只读值档**（摘要 / 详情里回显业务值的推荐写法，也是 `Form.Item` 的
+         * `readonly` 行配的那一档）：几何与可编辑输入框完全一致，但不给任何「可编辑」线索。
+         * 只读值档请写 `readonly` + `bordered={false}`；`readonly` + `'focus'` 会被中和（兜底，不推荐）。
          */
         bordered: {
-            type: BooleanConstructor;
+            type: PropType<boolean | "focus">;
             default: boolean;
         };
         maxlength: {
@@ -621,7 +647,7 @@ export declare const InputCompound: {
         type: string;
         onChange: (v: string) => void;
         invalid: boolean;
-        bordered: boolean;
+        bordered: boolean | "focus";
         defaultValue: string;
         placeholder: string;
         autofocus: boolean;
@@ -629,10 +655,10 @@ export declare const InputCompound: {
         status: InputStatus;
         as: "button" | "input";
         readonly: boolean;
+        onEnter: (v: string) => void;
         clearable: boolean;
         maxlength: number;
         showCount: boolean;
-        onEnter: (v: string) => void;
         controlClass: string;
         controlAttrs: Record<string, unknown>;
         hasValue: boolean;
@@ -711,11 +737,19 @@ export declare const InputCompound: {
             default: boolean;
         };
         /**
-         * 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底，靠悬停与聚焦给反馈）。
-         * 配 `readonly` 即**只读值档**：连悬停底与聚焦框环都退掉（见 `readonly`）。
+         * 有无边框，三档（判定表见 `./bordered.ts`，输入族三件共用）：
+         *
+         * - `true`（缺省）**常有框**；
+         * - `false` **无框** —— 常态、悬停、聚焦都不出现（本档的效果只有一种）；
+         * - `'focus'` **聚焦（与悬停）才显出框** —— 行内编辑那档：常态看着像「值」，点进去才亮框；
+         *   悬停 / 聚焦的表现**复用有框档那两条**，不另写一套。
+         *
+         * 配 `readonly` 即**只读值档**（摘要 / 详情里回显业务值的推荐写法，也是 `Form.Item` 的
+         * `readonly` 行配的那一档）：几何与可编辑输入框完全一致，但不给任何「可编辑」线索。
+         * 只读值档请写 `readonly` + `bordered={false}`；`readonly` + `'focus'` 会被中和（兜底，不推荐）。
          */
         bordered: {
-            type: BooleanConstructor;
+            type: PropType<boolean | "focus">;
             default: boolean;
         };
         maxlength: {
@@ -772,7 +806,7 @@ export declare const InputCompound: {
         type: string;
         onChange: (v: string) => void;
         invalid: boolean;
-        bordered: boolean;
+        bordered: boolean | "focus";
         defaultValue: string;
         placeholder: string;
         autofocus: boolean;
@@ -780,10 +814,10 @@ export declare const InputCompound: {
         status: InputStatus;
         as: "button" | "input";
         readonly: boolean;
+        onEnter: (v: string) => void;
         clearable: boolean;
         maxlength: number;
         showCount: boolean;
-        onEnter: (v: string) => void;
         controlClass: string;
         controlAttrs: Record<string, unknown>;
         hasValue: boolean;
@@ -855,11 +889,19 @@ export declare const InputCompound: {
         default: boolean;
     };
     /**
-     * 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底，靠悬停与聚焦给反馈）。
-     * 配 `readonly` 即**只读值档**：连悬停底与聚焦框环都退掉（见 `readonly`）。
+     * 有无边框，三档（判定表见 `./bordered.ts`，输入族三件共用）：
+     *
+     * - `true`（缺省）**常有框**；
+     * - `false` **无框** —— 常态、悬停、聚焦都不出现（本档的效果只有一种）；
+     * - `'focus'` **聚焦（与悬停）才显出框** —— 行内编辑那档：常态看着像「值」，点进去才亮框；
+     *   悬停 / 聚焦的表现**复用有框档那两条**，不另写一套。
+     *
+     * 配 `readonly` 即**只读值档**（摘要 / 详情里回显业务值的推荐写法，也是 `Form.Item` 的
+     * `readonly` 行配的那一档）：几何与可编辑输入框完全一致，但不给任何「可编辑」线索。
+     * 只读值档请写 `readonly` + `bordered={false}`；`readonly` + `'focus'` 会被中和（兜底，不推荐）。
      */
     bordered: {
-        type: BooleanConstructor;
+        type: PropType<boolean | "focus">;
         default: boolean;
     };
     maxlength: {
@@ -918,7 +960,7 @@ export declare const InputCompound: {
     type: string;
     onChange: (v: string) => void;
     invalid: boolean;
-    bordered: boolean;
+    bordered: boolean | "focus";
     defaultValue: string;
     placeholder: string;
     autofocus: boolean;
@@ -926,10 +968,10 @@ export declare const InputCompound: {
     status: InputStatus;
     as: "button" | "input";
     readonly: boolean;
+    onEnter: (v: string) => void;
     clearable: boolean;
     maxlength: number;
     showCount: boolean;
-    onEnter: (v: string) => void;
     controlClass: string;
     controlAttrs: Record<string, unknown>;
     hasValue: boolean;
@@ -980,8 +1022,9 @@ export declare const InputCompound: {
             type: PropType<InputStatus>;
             default: undefined;
         };
+        /** 是否带边框（三档口径见 `Input` 的同名 prop：`true` 常有框 / `false` 无框 / `'focus'` 聚焦才显框） */
         bordered: {
-            type: BooleanConstructor;
+            type: PropType<boolean | "focus">;
             default: boolean;
         };
         maxlength: {
@@ -1045,8 +1088,9 @@ export declare const InputCompound: {
             type: PropType<InputStatus>;
             default: undefined;
         };
+        /** 是否带边框（三档口径见 `Input` 的同名 prop：`true` 常有框 / `false` 无框 / `'focus'` 聚焦才显框） */
         bordered: {
-            type: BooleanConstructor;
+            type: PropType<boolean | "focus">;
             default: boolean;
         };
         maxlength: {
@@ -1073,7 +1117,7 @@ export declare const InputCompound: {
         disabled: boolean;
         onChange: (v: string) => void;
         invalid: boolean;
-        bordered: boolean;
+        bordered: boolean | "focus";
         defaultValue: string;
         placeholder: string;
         rows: number;
@@ -1102,3 +1146,10 @@ export declare const InputCompound: {
     }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 };
 export type InputCompoundType = typeof InputCompound;
+/**
+ * 数字输入与 `Input` **同族**（同一个表壳 / 内距 / 状态协议，同一份面 `input.css`），
+ * 故与 `Textarea` 同款处置：**平级导出、共用本目录**（`AGENTS.md` 硬约束 1）。
+ * 它**不是** `Input` 的点号成员 —— 成员位留给「同一件自己的形态」（`.Textarea` / `.Display`），
+ * 而数字输入是另一件（值模型 `number | null` vs `string`）。
+ */
+export { NumberInput, type NumberInputProps } from './number-input';

package/dist/components/input/index.js

@@ -1,5 +1,6 @@
 import { defineComponent, ref, computed, createVNode, mergeProps, createTextVNode } from "vue";
 import { Icon } from "@manohub/icon";
+import { borderedClassOf } from "./bordered.js";
 const Input = /* @__PURE__ */ defineComponent({
   name: "Input",
   inheritAttrs: false,
@@ -67,11 +68,19 @@ const Input = /* @__PURE__ */ defineComponent({
       default: false
     },
     /**
-     * 是否带边框；`false` 用于表格内编辑 / 行内编辑（无框、无底，靠悬停与聚焦给反馈）。
-     * 配 `readonly` 即**只读值档**：连悬停底与聚焦框环都退掉（见 `readonly`）。
+     * 有无边框，三档（判定表见 `./bordered.ts`，输入族三件共用）：
+     *
+     * - `true`（缺省）**常有框**；
+     * - `false` **无框** —— 常态、悬停、聚焦都不出现（本档的效果只有一种）；
+     * - `'focus'` **聚焦（与悬停）才显出框** —— 行内编辑那档：常态看着像「值」，点进去才亮框；
+     *   悬停 / 聚焦的表现**复用有框档那两条**，不另写一套。
+     *
+     * 配 `readonly` 即**只读值档**（摘要 / 详情里回显业务值的推荐写法，也是 `Form.Item` 的
+     * `readonly` 行配的那一档）：几何与可编辑输入框完全一致，但不给任何「可编辑」线索。
+     * 只读值档请写 `readonly` + `bordered={false}`；`readonly` + `'focus'` 会被中和（兜底，不推荐）。
      */
     bordered: {
-      type: Boolean,
+      type: [Boolean, String],
       default: true
     },
     maxlength: {
@@ -174,7 +183,7 @@ const Input = /* @__PURE__ */ defineComponent({
     };
     const inputType = computed(() => props.type === "password" && revealed.value ? "text" : props.type);
     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 controlClasses = computed(() => ["mh-input", isTrigger.value ? "mh-input--trigger" : "", props.size === "md" ? "" : `mh-input--${props.size}`, borderedClassOf(props.bordered), 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);
@@ -283,8 +292,9 @@ const Textarea = /* @__PURE__ */ defineComponent({
       type: String,
       default: void 0
     },
+    /** 是否带边框（三档口径见 `Input` 的同名 prop：`true` 常有框 / `false` 无框 / `'focus'` 聚焦才显框） */
     bordered: {
-      type: Boolean,
+      type: [Boolean, String],
       default: true
     },
     maxlength: {
@@ -344,7 +354,7 @@ const Textarea = /* @__PURE__ */ defineComponent({
       "class": ["mh-input__wrap", attrs.class].filter(Boolean).join(" "),
       "style": attrs.style
     }, [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(" "),
+      "class": ["mh-input", "mh-input--textarea", props.size === "md" ? "" : `mh-input--${props.size}`, borderedClassOf(props.bordered), visualStatus.value ? `is-${visualStatus.value}` : "", props.disabled ? "is-disabled" : ""].filter(Boolean).join(" "),
       "rows": autoRows.value,
       "value": current.value,
       "placeholder": props.placeholder,