@manohub/ui 1.0.0 → 1.0.1

package/dist/components/input/number-input.js

@@ -0,0 +1,240 @@
+import { defineComponent, ref, computed, watch, createVNode, mergeProps } from "vue";
+import { Icon } from "@manohub/icon";
+import { borderedClassOf } from "./bordered.js";
+const NumberInput = /* @__PURE__ */ defineComponent({
+  name: "NumberInput",
+  inheritAttrs: false,
+  props: {
+    modelValue: {
+      type: Number,
+      default: void 0
+    },
+    defaultValue: {
+      type: Number,
+      default: null
+    },
+    min: {
+      type: Number,
+      default: void 0
+    },
+    max: {
+      type: Number,
+      default: void 0
+    },
+    step: {
+      type: Number,
+      default: void 0
+    },
+    precision: {
+      type: Number,
+      default: void 0
+    },
+    placeholder: {
+      type: String,
+      default: void 0
+    },
+    size: {
+      type: String,
+      default: "md"
+    },
+    disabled: {
+      type: Boolean,
+      default: false
+    },
+    readonly: {
+      type: Boolean,
+      default: false
+    },
+    invalid: {
+      type: Boolean,
+      default: false
+    },
+    status: {
+      type: String,
+      default: void 0
+    },
+    /** 是否带边框（三档口径见 `Input` 的同名 prop：`true` 常有框 / `false` 无框 / `'focus'` 聚焦才显框） */
+    bordered: {
+      type: [Boolean, String],
+      default: true
+    },
+    controls: {
+      type: Boolean,
+      default: true
+    },
+    clampOnBlur: {
+      type: Boolean,
+      default: true
+    },
+    onChange: {
+      type: Function,
+      default: void 0
+    },
+    onEnter: {
+      type: Function,
+      default: void 0
+    }
+  },
+  emits: {
+    "update:modelValue": (v) => true
+  },
+  slots: Object,
+  setup(props, {
+    emit,
+    slots,
+    attrs
+  }) {
+    const inner = ref(props.defaultValue ?? null);
+    const current = computed(() => props.modelValue === void 0 ? inner.value : props.modelValue);
+    const focused = ref(false);
+    const resolvedStep = computed(() => props.step !== void 0 && props.step > 0 ? props.step : 1);
+    const resolvedPrecision = computed(() => {
+      if (props.precision !== void 0 && props.precision >= 0) return Math.floor(props.precision);
+      const text = String(resolvedStep.value);
+      const dot = text.indexOf(".");
+      return dot < 0 ? 0 : text.length - dot - 1;
+    });
+    const roundTo = (value, precision) => {
+      const factor = 10 ** precision;
+      return Math.round(value * factor) / factor;
+    };
+    const clampValue = (value) => {
+      let next = value;
+      if (props.min !== void 0 && next < props.min) next = props.min;
+      if (props.max !== void 0 && next > props.max) next = props.max;
+      return next;
+    };
+    const normalize = (value) => clampValue(roundTo(value, resolvedPrecision.value));
+    const textOf = (value) => value === null || value === void 0 ? "" : String(roundTo(value, resolvedPrecision.value));
+    const parseInput = (raw) => {
+      const text = raw.trim();
+      if (!text) return null;
+      if (!/^[+-]?(\d+\.?\d*|\.\d+)$/.test(text)) return "invalid";
+      const value = Number(text);
+      return Number.isFinite(value) ? value : "invalid";
+    };
+    const draft = ref(textOf(current.value));
+    const display = computed(() => props.modelValue === void 0 ? draft.value : textOf(props.modelValue));
+    const inputRef = ref(null);
+    const syncDom = () => {
+      const el = inputRef.value;
+      if (el && el.value !== display.value) el.value = display.value;
+    };
+    const setModel = (value) => {
+      if (props.modelValue === void 0) inner.value = value;
+      emit("update:modelValue", value);
+      props.onChange?.(value);
+    };
+    const commit = (value) => {
+      setModel(value);
+      draft.value = textOf(value);
+      syncDom();
+    };
+    watch(current, (value) => {
+      if (!focused.value) draft.value = textOf(value);
+    });
+    watch(() => [props.min, props.max, props.precision, props.step], () => {
+      if (current.value === null) return;
+      const next = normalize(current.value);
+      if (next !== current.value) commit(next);
+    });
+    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 onInput = (event) => {
+      const el = event.target;
+      draft.value = el.value;
+      const parsed = parseInput(el.value);
+      if (parsed === "invalid") return;
+      setModel(parsed);
+      if (props.modelValue !== void 0 && props.modelValue !== parsed) syncDom();
+    };
+    const settle = () => {
+      const parsed = parseInput(draft.value);
+      if (parsed === "invalid") {
+        draft.value = textOf(current.value);
+        syncDom();
+        return current.value;
+      }
+      if (parsed === null) {
+        commit(null);
+        return null;
+      }
+      const next = props.clampOnBlur ? normalize(parsed) : roundTo(parsed, resolvedPrecision.value);
+      commit(next);
+      return next;
+    };
+    const onFocus = () => {
+      focused.value = true;
+    };
+    const onBlur = () => {
+      focused.value = false;
+      settle();
+    };
+    const onKeydown = (event) => {
+      if (event.isComposing) return;
+      if (event.key === "Enter") {
+        const value = settle();
+        props.onEnter?.(value);
+        return;
+      }
+      if (event.key === "ArrowUp" || event.key === "ArrowDown") {
+        if (props.disabled || props.readonly) return;
+        event.preventDefault();
+        stepBy(event.key === "ArrowUp" ? 1 : -1);
+      }
+    };
+    const stepBy = (direction) => {
+      if (props.disabled || props.readonly) return;
+      const base = current.value ?? (props.min !== void 0 ? props.min : 0);
+      commit(normalize(base + direction * resolvedStep.value));
+    };
+    const atMax = computed(() => props.max !== void 0 && current.value !== null && current.value >= props.max);
+    const atMin = computed(() => props.min !== void 0 && current.value !== null && current.value <= props.min);
+    const showControls = computed(() => props.controls && !props.disabled && !props.readonly);
+    const controlClasses = computed(() => ["mh-input", "mh-input--number", props.size === "md" ? "" : `mh-input--${props.size}`, borderedClassOf(props.bordered), visualStatus.value ? `is-${visualStatus.value}` : "", props.disabled ? "is-disabled" : ""].filter(Boolean).join(" "));
+    const stepButton = (direction) => createVNode("button", {
+      "type": "button",
+      "class": "mh-input__step-btn",
+      "aria-label": direction === 1 ? "增加" : "减少",
+      "tabindex": -1,
+      "disabled": direction === 1 ? atMax.value : atMin.value,
+      "onClick": () => stepBy(direction)
+    }, [createVNode(Icon, {
+      "name": direction === 1 ? "chevron-up" : "chevron-down"
+    }, null)]);
+    return () => createVNode("div", {
+      "class": ["mh-input__wrap", attrs.class].filter(Boolean).join(" "),
+      "style": attrs.style
+    }, [slots.prefix ? createVNode("span", {
+      "class": "mh-input__prefix"
+    }, [slots.prefix()]) : null, createVNode("input", mergeProps(forwardAttrs.value, {
+      "ref": inputRef,
+      "class": controlClasses.value,
+      "type": "text",
+      "inputmode": "decimal",
+      "value": display.value,
+      "placeholder": props.placeholder,
+      "disabled": props.disabled,
+      "readonly": props.readonly,
+      "aria-invalid": isInvalid.value ? "true" : void 0,
+      "onInput": onInput,
+      "onKeydown": onKeydown,
+      "onFocus": onFocus,
+      "onBlur": onBlur
+    }), null), showControls.value ? createVNode("span", {
+      "class": "mh-input__step"
+    }, [stepButton(1), stepButton(-1)]) : null, slots.suffix ? createVNode("span", {
+      "class": "mh-input__suffix"
+    }, [slots.suffix()]) : null]);
+  }
+});
+export {
+  NumberInput
+};

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

@@ -132,6 +132,15 @@ export declare const Select: import("vue").DefineComponent<import("vue").Extract
         type: PropType<InputStatus>;
         default: undefined;
     };
+    /**
+     * 有无边框（框由触发器 `<Input as="button">` 带，三档口径与 `Input` 的同名 prop 完全一致）：
+     * `true`（缺省）常有框 / `false` 无框（常态、悬停、聚焦都不显）/ `'focus'` 聚焦（与悬停）才显框。
+     * 表格单元格里想要「常态像值、点进去才亮框」就用 `'focus'`。
+     */
+    bordered: {
+        type: PropType<boolean | "focus">;
+        default: boolean;
+    };
     /** 加载中（面板里出一行提示，不渲染选项） */
     loading: {
         type: BooleanConstructor;
@@ -221,6 +230,15 @@ export declare const Select: import("vue").DefineComponent<import("vue").Extract
         type: PropType<InputStatus>;
         default: undefined;
     };
+    /**
+     * 有无边框（框由触发器 `<Input as="button">` 带，三档口径与 `Input` 的同名 prop 完全一致）：
+     * `true`（缺省）常有框 / `false` 无框（常态、悬停、聚焦都不显）/ `'focus'` 聚焦（与悬停）才显框。
+     * 表格单元格里想要「常态像值、点进去才亮框」就用 `'focus'`。
+     */
+    bordered: {
+        type: PropType<boolean | "focus">;
+        default: boolean;
+    };
     /** 加载中（面板里出一行提示，不渲染选项） */
     loading: {
         type: BooleanConstructor;
@@ -248,6 +266,7 @@ export declare const Select: import("vue").DefineComponent<import("vue").Extract
     disabled: boolean;
     onChange: (v: SelectValue) => void;
     loading: boolean;
+    bordered: boolean | "focus";
     options: SelectItem[];
     defaultValue: SelectValue | undefined;
     placeholder: string;

package/dist/components/select/index.js

@@ -74,6 +74,15 @@ const Select = /* @__PURE__ */ defineComponent({
       type: String,
       default: void 0
     },
+    /**
+     * 有无边框（框由触发器 `<Input as="button">` 带，三档口径与 `Input` 的同名 prop 完全一致）：
+     * `true`（缺省）常有框 / `false` 无框（常态、悬停、聚焦都不显）/ `'focus'` 聚焦（与悬停）才显框。
+     * 表格单元格里想要「常态像值、点进去才亮框」就用 `'focus'`。
+     */
+    bordered: {
+      type: [Boolean, String],
+      default: true
+    },
     /** 加载中（面板里出一行提示，不渲染选项） */
     loading: {
       type: Boolean,
@@ -239,6 +248,7 @@ const Select = /* @__PURE__ */ defineComponent({
         "size": props.size,
         "status": props.status,
         "disabled": props.disabled,
+        "bordered": props.bordered,
         "clearable": props.clearable,
         "hasValue": hasValue,
         "multiple": props.multiple,

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

@@ -129,6 +129,11 @@ export declare const SelectTree: import("vue").DefineComponent<import("vue").Ext
         type: PropType<InputStatus>;
         default: undefined;
     };
+    /** 有无边框（框由触发器 `<Input as="button">` 带，三档口径与 `Input` 的同名 prop 一致） */
+    bordered: {
+        type: PropType<boolean | "focus">;
+        default: boolean;
+    };
     /** 值变更回调（选中叶子的主键） */
     onChange: {
         type: PropType<(v: string) => void>;
@@ -248,6 +253,11 @@ export declare const SelectTree: import("vue").DefineComponent<import("vue").Ext
         type: PropType<InputStatus>;
         default: undefined;
     };
+    /** 有无边框（框由触发器 `<Input as="button">` 带，三档口径与 `Input` 的同名 prop 一致） */
+    bordered: {
+        type: PropType<boolean | "focus">;
+        default: boolean;
+    };
     /** 值变更回调（选中叶子的主键） */
     onChange: {
         type: PropType<(v: string) => void>;
@@ -283,6 +293,7 @@ export declare const SelectTree: import("vue").DefineComponent<import("vue").Ext
     defaultExpandedKeys: string[];
     defaultExpandAll: boolean;
     onExpandChange: (keys: string[]) => void;
+    bordered: boolean | "focus";
     defaultValue: string;
     placeholder: string;
     modelValue: string;

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

@@ -104,6 +104,11 @@ const SelectTree = /* @__PURE__ */ defineComponent({
       type: String,
       default: void 0
     },
+    /** 有无边框（框由触发器 `<Input as="button">` 带，三档口径与 `Input` 的同名 prop 一致） */
+    bordered: {
+      type: [Boolean, String],
+      default: true
+    },
     /** 值变更回调（选中叶子的主键） */
     onChange: {
       type: Function,
@@ -211,6 +216,7 @@ const SelectTree = /* @__PURE__ */ defineComponent({
         "size": props.size,
         "status": props.status,
         "disabled": props.disabled,
+        "bordered": props.bordered,
         "clearable": props.clearable,
         "hasValue": hasValue.value,
         "placeholder": props.placeholder,

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

@@ -21,6 +21,14 @@ export declare const SelectTrigger: import("vue").DefineComponent<import("vue").
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * 有无边框（**直接透传给输入面**，三档口径与 `Input` 的同名 prop 完全一致）：
+     * `true` 常有框 / `false` 无框（任何状态都不显）/ `'focus'` 聚焦（与悬停）才显框。
+     */
+    bordered: {
+        type: PropType<boolean | "focus">;
+        default: boolean;
+    };
     clearable: {
         type: BooleanConstructor;
         default: boolean;
@@ -90,6 +98,14 @@ export declare const SelectTrigger: import("vue").DefineComponent<import("vue").
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * 有无边框（**直接透传给输入面**，三档口径与 `Input` 的同名 prop 完全一致）：
+     * `true` 常有框 / `false` 无框（任何状态都不显）/ `'focus'` 聚焦（与悬停）才显框。
+     */
+    bordered: {
+        type: PropType<boolean | "focus">;
+        default: boolean;
+    };
     clearable: {
         type: BooleanConstructor;
         default: boolean;
@@ -145,6 +161,7 @@ export declare const SelectTrigger: import("vue").DefineComponent<import("vue").
     disabled: boolean;
     label: string;
     onKeydown: (event: KeyboardEvent) => void;
+    bordered: boolean | "focus";
     placeholder: string;
     status: InputStatus;
     clearable: boolean;

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

@@ -24,6 +24,14 @@ const SelectTrigger = /* @__PURE__ */ defineComponent({
       type: Boolean,
       default: false
     },
+    /**
+     * 有无边框（**直接透传给输入面**，三档口径与 `Input` 的同名 prop 完全一致）：
+     * `true` 常有框 / `false` 无框（任何状态都不显）/ `'focus'` 聚焦（与悬停）才显框。
+     */
+    bordered: {
+      type: [Boolean, String],
+      default: true
+    },
     clearable: {
       type: Boolean,
       default: false
@@ -81,6 +89,7 @@ const SelectTrigger = /* @__PURE__ */ defineComponent({
       "size": props.size,
       "status": props.status,
       "disabled": props.disabled,
+      "bordered": props.bordered,
       "clearable": props.clearable,
       "hasValue": props.hasValue,
       "placeholder": props.placeholder,

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

@@ -50,6 +50,36 @@ export interface TableRowProps {
     class?: string;
     onClick?: (row: TableRow, index: number, event: MouseEvent) => void;
 }
+/**
+ * `#cell` 插槽的作用域 —— **单元格编辑走这条**。
+ *
+ * 表格**不替调用方渲染控件**：编辑格要摆什么（`Input` / `Select` / `NumberInput`、外层要不要套
+ * `Form.Item` 拿 label 位与错误文案位、只读态摆什么）全由调用方在插槽里决定。口径与 `Form.Item`
+ * 同款 —— 它的默认插槽也是「你自己放控件」；骨架层因此不必猜每种业务格子的排版，
+ * 也不会把「哪一格长什么样」的开关堆成一张越来越长的 prop 表。
+ *
+ * **回写是受控的**：`setValue(next)` 只把「这一格变成了什么」上报出去
+ * （= 发一次 `onCellChange(row, column.key, next, index)`）。本件**从不改 `data`** ——
+ * 新数组与「这次改动该不该被接受」都由调用方决定，与行选中同一套受控口径。
+ *
+ * @example 编辑格：套 `Form.Item` 拿错误位，控件自己绑值、回写走 `setValue`
+ * <Table :columns="columns" :data="rows" row-key="id" layout="fixed" :on-cell-change="write">
+ *   <template #cell="{ row, column, value, index, setValue }">
+ *     <!-- 格子里的框由控件自己带：默认有框 / `:bordered="false"` 无框 / `bordered="focus"` 聚焦才显框 -->
+ *     <Input v-if="column.key === 'name'" :model-value="String(value ?? '')" @change="setValue" />
+ *     <template v-else>{{ value }}</template>
+ *   </template>
+ * </Table>
+ */
+export interface TableCellSlotScope {
+    row: TableRow;
+    column: TableColumn;
+    /** 该格当前值（`row[column.key]` 的原值；表格不改写它，也不做任何格式化） */
+    value: unknown;
+    index: number;
+    /** 上报该格的新值（= 发一次 `onCellChange`）；调用方没接 `onCellChange` 时是空操作 */
+    setValue: (next: unknown) => void;
+}
 /**
  * 行级可勾选判定（`selectable` 的函数形态）：返回 `false` 的行渲染**禁用态**勾选框，
  * 且不进表头全选的增删范围。签名与 `onRow` / `rowClass` 一致（都给 `index`）。
@@ -150,6 +180,17 @@ export declare const Table: import("vue").DefineComponent<import("vue").ExtractP
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * 单元格值变更 —— 由 `#cell` 插槽里的 `setValue` 触发，是**唯一的回写通道**。
+     *
+     * 本件**不改 `data`**（与本仓表格一贯的克制口径一致：全受控、只发事件、不排序、不切片）；
+     * 要不要接受、以及新数组怎么产生，都由调用方决定。
+     * 没接这个回调时 `setValue` 是空操作（插槽里的控件照旧可绑，不会报错）。
+     */
+    onCellChange: {
+        type: PropType<(row: TableRow, key: string, value: unknown, index: number) => void>;
+        default: undefined;
+    };
     /** 尺寸档：`sm` 紧凑（表格嵌在卡片里）/ `md` 标准 / `lg` 宽松（详情页） */
     size: {
         type: PropType<ControlSize>;
@@ -160,7 +201,18 @@ export declare const Table: import("vue").DefineComponent<import("vue").ExtractP
         type: BooleanConstructor;
         default: boolean;
     };
-    borderless: {
+    /**
+     * 有无外框（缺省**有**框）：去外框写 `:bordered="false"`。
+     *
+     * **极性口径**：本库的「有无外框」一律用**肯定式** `bordered`（`Input` / `Textarea` /
+     * `NumberInput` / `Nav` 同款，见 `docs/guide/naming-and-defaults.md` §2.1）。本件原名
+     * `borderless`（否定式、默认 `false`），2026-10 按同名同义统一改成 `bordered` —— 默认行为不变
+     * （都是「缺省有框」），只是名字的极性换到与其余件一致，调用方不必再记「哪件用否定式」。
+     *
+     * 类名仍是 `.mh-table--borderless`：面层词根**统一为否定式**（输入族关框时也输出它），
+     * 与 prop 的极性相反 —— 两套各自内部一致，`Input` 的文档页记着同一处口径。
+     */
+    bordered: {
         type: BooleanConstructor;
         default: boolean;
     };
@@ -297,6 +349,17 @@ export declare const Table: import("vue").DefineComponent<import("vue").ExtractP
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * 单元格值变更 —— 由 `#cell` 插槽里的 `setValue` 触发，是**唯一的回写通道**。
+     *
+     * 本件**不改 `data`**（与本仓表格一贯的克制口径一致：全受控、只发事件、不排序、不切片）；
+     * 要不要接受、以及新数组怎么产生，都由调用方决定。
+     * 没接这个回调时 `setValue` 是空操作（插槽里的控件照旧可绑，不会报错）。
+     */
+    onCellChange: {
+        type: PropType<(row: TableRow, key: string, value: unknown, index: number) => void>;
+        default: undefined;
+    };
     /** 尺寸档：`sm` 紧凑（表格嵌在卡片里）/ `md` 标准 / `lg` 宽松（详情页） */
     size: {
         type: PropType<ControlSize>;
@@ -307,7 +370,18 @@ export declare const Table: import("vue").DefineComponent<import("vue").ExtractP
         type: BooleanConstructor;
         default: boolean;
     };
-    borderless: {
+    /**
+     * 有无外框（缺省**有**框）：去外框写 `:bordered="false"`。
+     *
+     * **极性口径**：本库的「有无外框」一律用**肯定式** `bordered`（`Input` / `Textarea` /
+     * `NumberInput` / `Nav` 同款，见 `docs/guide/naming-and-defaults.md` §2.1）。本件原名
+     * `borderless`（否定式、默认 `false`），2026-10 按同名同义统一改成 `bordered` —— 默认行为不变
+     * （都是「缺省有框」），只是名字的极性换到与其余件一致，调用方不必再记「哪件用否定式」。
+     *
+     * 类名仍是 `.mh-table--borderless`：面层词根**统一为否定式**（输入族关框时也输出它），
+     * 与 prop 的极性相反 —— 两套各自内部一致，`Input` 的文档页记着同一处口径。
+     */
+    bordered: {
         type: BooleanConstructor;
         default: boolean;
     };
@@ -414,11 +488,12 @@ export declare const Table: import("vue").DefineComponent<import("vue").ExtractP
     expandedKeys: (string | number)[];
     defaultExpandedKeys: (string | number)[];
     onExpandChange: (keys: Array<string | number>) => void;
+    bordered: boolean;
     modelValue: (string | number)[];
     emptyText: string;
     selectable: boolean | TableRowSelectable;
     striped: boolean;
-    borderless: boolean;
+    onCellChange: (row: TableRow, key: string, value: unknown, index: number) => void;
     stickyHead: boolean;
     stickyCol: boolean;
     showHeader: boolean;
@@ -429,13 +504,13 @@ export declare const Table: import("vue").DefineComponent<import("vue").ExtractP
     expandable: (row: TableRow, index: number) => VNodeChild;
     pagination: false | TablePagination;
 }, SlotsType<{
-    /** 单元格：`{ row, column, value, index }`（不给则直接输出原值） */
-    cell?: (context: {
-        row: TableRow;
-        column: TableColumn;
-        value: unknown;
-        index: number;
-    }) => VNodeChild;
+    /**
+     * 单元格：`{ row, column, value, index, setValue }`（不给则直接输出原值）。
+     *
+     * **编辑格也走这里**（见 `TableCellSlotScope` 的说明）：本件不替调用方渲染控件，
+     * 只给值、给位置、给一个受控的回写口 `setValue`。
+     */
+    cell?: (context: TableCellSlotScope) => VNodeChild;
     /** 行尾操作区：`{ row, index }`（面里用 `align: 'right'` 的列承载） */
     actions?: (context: {
         row: TableRow;

package/dist/components/table/index.js

@@ -43,6 +43,17 @@ const Table = /* @__PURE__ */ defineComponent({
       type: Boolean,
       default: false
     },
+    /**
+     * 单元格值变更 —— 由 `#cell` 插槽里的 `setValue` 触发，是**唯一的回写通道**。
+     *
+     * 本件**不改 `data`**（与本仓表格一贯的克制口径一致：全受控、只发事件、不排序、不切片）；
+     * 要不要接受、以及新数组怎么产生，都由调用方决定。
+     * 没接这个回调时 `setValue` 是空操作（插槽里的控件照旧可绑，不会报错）。
+     */
+    onCellChange: {
+      type: Function,
+      default: void 0
+    },
     /** 尺寸档：`sm` 紧凑（表格嵌在卡片里）/ `md` 标准 / `lg` 宽松（详情页） */
     size: {
       type: String,
@@ -53,9 +64,20 @@ const Table = /* @__PURE__ */ defineComponent({
       type: Boolean,
       default: false
     },
-    borderless: {
+    /**
+     * 有无外框（缺省**有**框）：去外框写 `:bordered="false"`。
+     *
+     * **极性口径**：本库的「有无外框」一律用**肯定式** `bordered`（`Input` / `Textarea` /
+     * `NumberInput` / `Nav` 同款，见 `docs/guide/naming-and-defaults.md` §2.1）。本件原名
+     * `borderless`（否定式、默认 `false`），2026-10 按同名同义统一改成 `bordered` —— 默认行为不变
+     * （都是「缺省有框」），只是名字的极性换到与其余件一致，调用方不必再记「哪件用否定式」。
+     *
+     * 类名仍是 `.mh-table--borderless`：面层词根**统一为否定式**（输入族关框时也输出它），
+     * 与 prop 的极性相反 —— 两套各自内部一致，`Input` 的文档页记着同一处口径。
+     */
+    bordered: {
       type: Boolean,
-      default: false
+      default: true
     },
     /** 外框交给包裹层（满高表格用） */
     fill: {
@@ -178,6 +200,9 @@ const Table = /* @__PURE__ */ defineComponent({
     const columnCount = computed(() => leadColumns.value + props.columns.length);
     const isEmpty = computed(() => props.data.length === 0);
     const cellClass = (column) => [column.align === "center" ? "mh-table__cell-center" : "", column.align === "right" ? "mh-table__cell-amount" : "", column.wrap ? "mh-table__cell-wrap" : ""].filter(Boolean);
+    const cellSetValue = (row, column, index) => (next) => {
+      props.onCellChange?.(row, column.key, next, index);
+    };
     const colStyles = computed(() => {
       const weightSum = props.columns.reduce((sum, item) => typeof item.width === "number" ? sum + item.width : sum, 0);
       return props.columns.map((column) => {
@@ -221,7 +246,7 @@ const Table = /* @__PURE__ */ defineComponent({
     };
     const sortGlyph = (key) => props.sortKey === key && props.sortOrder === "asc" ? "chevron-up" : "chevron-down";
     return () => {
-      const tableClass = ["mh-table", resolvedSize.value === "sm" ? "mh-table--xs" : "", resolvedSize.value === "lg" ? "mh-table--lg" : "", props.borderless ? "mh-table--borderless" : "", props.fill ? "mh-table--fill" : "", props.layout === "fixed" ? "mh-table--fixed" : "", props.stickyHead ? "mh-table--sticky-head" : "", props.stickyCol ? "mh-table--sticky-col" : "", attrs.class].filter(Boolean).join(" ");
+      const tableClass = ["mh-table", resolvedSize.value === "sm" ? "mh-table--xs" : "", resolvedSize.value === "lg" ? "mh-table--lg" : "", props.bordered ? "" : "mh-table--borderless", props.fill ? "mh-table--fill" : "", props.layout === "fixed" ? "mh-table--fixed" : "", props.stickyHead ? "mh-table--sticky-head" : "", props.stickyCol ? "mh-table--sticky-col" : "", attrs.class].filter(Boolean).join(" ");
       const pager = typeof props.pagination === "object" ? props.pagination : null;
       return createVNode("div", {
         "class": "mh-table-wrapper",
@@ -303,12 +328,16 @@ const Table = /* @__PURE__ */ defineComponent({
         ) : null, props.columns.map((column) => createVNode("td", {
           "key": column.key,
           "class": cellClass(column).join(" ")
-        }, [slots.cell ? slots.cell({
-          row,
-          column,
-          value: row[column.key],
-          index
-        }) : slots.actions && column.align === "right" ? slots.actions({
+        }, [slots.cell ? (
+          /* 编辑格与展示格都走这条：值、位置、回写口一并交给调用方 */
+          slots.cell({
+            row,
+            column,
+            value: row[column.key],
+            index,
+            setValue: cellSetValue(row, column, index)
+          })
+        ) : slots.actions && column.align === "right" ? slots.actions({
           row,
           index
         }) : String(row[column.key] ?? "")]))]), isExpanded ? createVNode("tr", {

package/dist/index.d.ts

@@ -32,7 +32,7 @@ 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';
 export { Button, type ButtonVariant, type ButtonCompound, type ButtonCompoundType, } from './components/button';
-export { Input, Textarea, type TextareaProps, type InputCompound, type InputCompoundType, } from './components/input';
+export { Input, Textarea, NumberInput, type TextareaProps, type NumberInputProps, type InputCompound, type InputCompoundType, } from './components/input';
 export { Search, type SearchProps } from './components/search';
 export { Select, SelectTree, type SelectOption, type SelectValue } from './components/select';
 export { Switch } from './components/switch';
@@ -45,7 +45,7 @@ export { Notification, type NotificationTone, } from './components/notification'
 export { Dialog, type DialogWidth } from './components/dialog';
 export { Drawer, type DrawerSide } from './components/drawer';
 export { Tooltip, type TooltipSide, type TooltipAlign, } from './components/tooltip';
-export { Table, type TableColumn, type TableRow, type TableRowSelectable, type TableSortOrder, } from './components/table';
+export { Table, type TableColumn, type TableCellSlotScope, type TableRow, type TableRowSelectable, type TableSortOrder, } from './components/table';
 export { Pagination, type PaginationPageItem } from './components/pagination';
 export { TabBar, type TabBarOption, type TabBarValue } from './components/tabbar';
 export { Steps, type CanJump, type StepsItem, type StepsVariant, type StepsCompound, type StepsCompoundType, } from './components/steps';