fix: 🐛 优化 InputNumbe 处理中间状态值的逻辑，支持配置不立即响应输入变化 (#1116)

Author: Moonofweisheng

docs/component/input-number.md

@@ -49,6 +49,17 @@ function handleChange({ value }) {
 <wd-input-number v-model="value" @change="handleChange" disable-input />
 ```
 
+## 禁用按钮
+
+可以单独禁用增加或减少按钮。
+
+```html
+<!-- 禁用减号按钮 -->
+<wd-input-number v-model="value" @change="handleChange" disable-minus />
+
+<!-- 禁用加号按钮 -->
+<wd-input-number v-model="value" @change="handleChange" disable-plus />
+```
 
 ## 无输入框
 
@@ -97,6 +108,49 @@ function handleChange({ value }) {
 }
 ```
 
+## 非立即更新模式
+
+设置 `immediate-change` 为 `false`，输入框内容变化时不会立即触发 `change` 事件，仅在失焦或点击按钮时触发。
+
+```html
+<!-- 立即更新模式（默认） -->
+<wd-input-number v-model="value1" @change="handleChange" :immediate-change="true" />
+
+<!-- 非立即更新模式 -->
+<wd-input-number v-model="value2" @change="handleChange" :immediate-change="false" />
+```
+
+```typescript
+const value1 = ref<number>(1)
+const value2 = ref<number>(1)
+function handleChange({ value }) {
+  console.log(value)
+}
+```
+
+## 初始化时自动更新
+
+设置 `update-on-init` 属性控制是否在初始化时更新 `v-model` 为修正后的值。
+
+- 当 `update-on-init="true"`（默认）时，会将初始值修正到符合 `min`、`max`、`step`、`precision` 等规则的有效值，并同步更新 `v-model`
+- 当 `update-on-init="false"` 时，保持初始值不修正（不改变 `v-model`），但仍会进行显示格式化（如精度处理）
+
+```html
+<!-- 自动更新初始值（默认） -->
+<wd-input-number v-model="value1" @change="handleChange" :update-on-init="true" :min="3" :max="15" :step="2" step-strictly />
+
+<!-- 不更新初始值，保持原始值 -->
+<wd-input-number v-model="value2" @change="handleChange" :update-on-init="false" :min="3" :max="15" :step="2" step-strictly />
+```
+
+```typescript
+const value1 = ref<number>(1) // 会自动修正为4（≥3的最小2的倍数）
+const value2 = ref<number>(1) // 保持为1，不会修正但会格式化显示
+function handleChange({ value }) {
+  console.log(value)
+}
+```
+
 ## 异步变更
 
 通过 `before-change` 可以在输入值变化前进行校验和拦截。
@@ -153,6 +207,9 @@ const beforeChange: InputNumberBeforeChange = (value) => {
 | adjustPosition | 原生属性，键盘弹起时，是否自动上推页面 | boolean | - | true | 1.3.11 |
 | before-change | 输入框值改变前触发，返回 false 会阻止输入框值改变，支持返回 `Promise` | `(value: number \| string) => boolean \| Promise<boolean>` | - | - | 1.6.0 |
 | long-press | 是否允许长按进行加减 | boolean | - | false | 1.8.0 |
+| immediate-change | 是否立即响应输入变化，false 时仅在失焦和按钮点击时更新 | boolean | - | true | $LOWEST_VERSION$ |
+| update-on-init | 是否在初始化时更新 v-model 为修正后的值 | boolean | - | true | $LOWEST_VERSION$ |
+| input-type | 输入框类型 | string | number / digit | digit | $LOWEST_VERSION$ |
 
 
 ## Events

docs/en-US/component/input-number.md

@@ -49,6 +49,18 @@ Set the `disable-input` property.
 <wd-input-number v-model="value" @change="handleChange" disable-input />
 ```
 
+## Disable Buttons
+
+You can disable the increase or decrease buttons individually.
+
+```html
+<!-- Disable minus button -->
+<wd-input-number v-model="value" @change="handleChange" disable-minus />
+
+<!-- Disable plus button -->
+<wd-input-number v-model="value" @change="handleChange" disable-plus />
+```
+
 ## Without Input Box
 
 Set `without-input` to hide the input box.
@@ -96,6 +108,49 @@ function handleChange({ value }) {
 }
 ```
 
+## Non-Immediate Update Mode
+
+Set `immediate-change` to `false`, the `change` event will not be triggered immediately when the input box content changes, only when it loses focus or buttons are clicked.
+
+```html
+<!-- Immediate update mode (default) -->
+<wd-input-number v-model="value1" @change="handleChange" :immediate-change="true" />
+
+<!-- Non-immediate update mode -->
+<wd-input-number v-model="value2" @change="handleChange" :immediate-change="false" />
+```
+
+```typescript
+const value1 = ref<number>(1)
+const value2 = ref<number>(1)
+function handleChange({ value }) {
+  console.log(value)
+}
+```
+
+## Auto-update on Initialization
+
+Set the `update-on-init` property to control whether to update the `v-model` with the corrected value during initialization.
+
+- When `update-on-init="true"` (default), the initial value will be corrected to comply with `min`, `max`, `step`, `precision` and other rules, and the `v-model` will be updated synchronously
+- When `update-on-init="false"`, the initial value will not be corrected (v-model unchanged), but display formatting (such as precision) will still be applied
+
+```html
+<!-- Auto-update initial value (default) -->
+<wd-input-number v-model="value1" @change="handleChange" :update-on-init="true" :min="3" :max="15" :step="2" step-strictly />
+
+<!-- Don't update initial value, keep original value -->
+<wd-input-number v-model="value2" @change="handleChange" :update-on-init="false" :min="3" :max="15" :step="2" step-strictly />
+```
+
+```typescript
+const value1 = ref<number>(1) // Will be auto-corrected to 4 (minimum multiple of 2 that is ≥3)
+const value2 = ref<number>(1) // Remains 1, will not be corrected but will be formatted for display
+function handleChange({ value }) {
+  console.log(value)
+}
+```
+
 ## Asynchronous Change
 
 Through `before-change`, you can validate and intercept before the input value changes.
@@ -152,6 +207,9 @@ Set the `long-press` property to allow long press for increment/decrement.
 | adjustPosition | Native property, whether to automatically push up the page when keyboard pops up | boolean | - | true | 1.3.11 |
 | before-change | Triggered before input box value changes, returning false will prevent input box value from changing, supports returning `Promise` | `(value: number \| string) => boolean \| Promise<boolean>` | - | - | 1.6.0 |
 | long-press | Whether to allow long press for increment/decrement | boolean | - | false | 1.8.0 |
+| immediate-change | Whether to respond to input changes immediately, false will only update on blur and button clicks | boolean | - | true | $LOWEST_VERSION$ |
+| update-on-init | Whether to update v-model with corrected value during initialization | boolean | - | true | $LOWEST_VERSION$ |
+| input-type | Input field type | string | number / digit | digit | $LOWEST_VERSION$ |
 
 ## Events