@kine-design/core 0.0.1-beta.5 → 0.0.1-beta.7

package/components/base/affix/useAffix.ts

@@ -7,11 +7,12 @@
  * 江湖的业务千篇一律，复杂的代码好几百行。
  */
 import { ref, onMounted, onUnmounted } from 'vue';
+import { type HookContext } from '../../types/hook';
 import { AffixProps } from './props';
 
 export function useAffix(
   props: Required<AffixProps>,
-  emit: (...args: any[]) => void,
+  emit: HookContext['emit'],
 ) {
   const affixed = ref(false);
   // 固定后占位元素的高度（撑开文档流）

package/components/base/anchor/useAnchor.ts

@@ -7,11 +7,12 @@
  * 江湖的业务千篇一律，复杂的代码好几百行。
  */
 import { ref, onMounted, onUnmounted } from 'vue';
+import { type HookContext } from '../../types/hook';
 import { AnchorProps } from './props';
 
 export function useAnchor(
   props: Required<AnchorProps>,
-  emit: (...args: any[]) => void,
+  emit: HookContext['emit'],
 ) {
   const currentLink = ref('');
   // 由子组件注册的 href 列表（按 DOM 顺序）

package/components/base/autoComplete/useAutoComplete.ts

@@ -14,8 +14,9 @@
  */
 import { ref, toRef, watch, onBeforeUnmount } from 'vue';
 import { AutoCompleteProps, AutoCompleteOption } from './props';
+import { type HookContext } from '../../types/hook';
 
-export function useAutoComplete(props: AutoCompleteProps, ctx: any) {
+export function useAutoComplete(props: AutoCompleteProps, ctx: HookContext) {
   const modelValueRef = toRef(() => props.modelValue ?? '');
 
   // --- 状态 ---

package/components/base/carousel/useCarousel.ts

@@ -7,9 +7,10 @@
  * 江湖的业务千篇一律，复杂的代码好几百行。
  */
 import { ref, computed, onMounted, onUnmounted, watch } from 'vue';
+import { type HookContext } from '../../types/hook';
 import { CarouselProps } from './props';
 
-export function useCarousel(props: Required<CarouselProps>, emit: (event: string, ...args: any[]) => void, count: () => number) {
+export function useCarousel(props: Required<CarouselProps>, emit: HookContext['emit'], count: () => number) {
   // 逻辑索引（0..N-1），用于指示器和 v-model
   const activeIndex = ref(props.modelValue ?? props.initialIndex);
   // track 位置索引（loop 时含克隆偏移）；初始时若 loop 启用则假定有克隆

package/components/base/cascader/useCascader.ts

@@ -14,6 +14,7 @@
  */
 import { computed, ref, toRef, watch } from 'vue';
 import { CascaderOption, CascaderProps } from './props';
+import { type HookContext } from '../../types/hook';
 
 /** 扁平化后的叶子路径，用于搜索 */
 export interface FlatCascaderOption {
@@ -64,7 +65,7 @@ const findPathByValues = (
   return subPath ? [found, ...subPath] : null;
 };
 
-export function useCascader(props: CascaderProps, ctx: any) {
+export function useCascader(props: CascaderProps, ctx: HookContext) {
   const optionsRef = toRef(() => props.options ?? []);
   const modelValueRef = toRef(() => props.modelValue ?? []);
   const multipleRef = toRef(() => props.multiple ?? false);

package/components/base/checkbox/useCheckbox.ts

@@ -9,11 +9,12 @@
 import { ref, watch } from 'vue';
 import { getNewModelValue, initChecked } from '../../../compositions/input/useBooleanInput.ts';
 import { CheckboxProps } from './props';
+import { type HookContext } from '../../types/hook';
 
 
 export function useCheckbox<
   Props extends Required<CheckboxProps>,
->(props: Props, ctx: any) {
+>(props: Props, ctx: HookContext) {
   const checkboxClass = ['m-checkbox', { 'm-disabled': props.disabled, 'm-indeterminate': props.indeterminate }];
 
   const checked = ref(initChecked(props));

package/components/base/collapse/useCollapse.ts

@@ -8,8 +8,9 @@
  */
 import { computed } from 'vue';
 import { CollapseProps } from './props';
+import { type HookContext } from '../../types/hook';
 
-export function useCollapse(props: Required<CollapseProps>, ctx: any) {
+export function useCollapse(props: Required<CollapseProps>, ctx: HookContext) {
   const { emit } = ctx;
 
   /**

package/components/base/datePicker/__tests__/useDatePicker.test.ts

@@ -0,0 +1,239 @@
+/**
+ * @description useDatePicker 测试
+ * @author 阿怪
+ * @date 2026/3/23
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+import { describe, expect, it } from 'vitest';
+import { useDatePicker, generateTimeColumn, toDayjs, BASE_WEEK_NAME, BASE_MONTH_NAME } from '../useDatePicker';
+
+describe('toDayjs', () => {
+  it('字符串转 dayjs', () => {
+    const d = toDayjs('2026-03-15');
+    expect(d.year()).toBe(2026);
+    expect(d.month()).toBe(2); // 0-indexed
+    expect(d.date()).toBe(15);
+  });
+
+  it('Date 对象转 dayjs', () => {
+    const d = toDayjs(new Date(2026, 5, 10));
+    expect(d.year()).toBe(2026);
+    expect(d.month()).toBe(5);
+  });
+
+  it('undefined 返回当前时间', () => {
+    const d = toDayjs(undefined);
+    expect(d.isValid()).toBe(true);
+  });
+});
+
+describe('generateTimeColumn', () => {
+  it('生成 24 小时列', () => {
+    const hours = generateTimeColumn(24, 1);
+    expect(hours).toHaveLength(24);
+    expect(hours[0]).toBe(0);
+    expect(hours[23]).toBe(23);
+  });
+
+  it('步进为 2', () => {
+    const hours = generateTimeColumn(24, 2);
+    expect(hours).toEqual([0, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22]);
+  });
+
+  it('生成 60 分钟列，步进 15', () => {
+    const mins = generateTimeColumn(60, 15);
+    expect(mins).toEqual([0, 15, 30, 45]);
+  });
+});
+
+describe('常量', () => {
+  it('BASE_WEEK_NAME 有 7 天', () => {
+    expect(BASE_WEEK_NAME).toHaveLength(7);
+  });
+
+  it('BASE_MONTH_NAME 有 12 个月', () => {
+    expect(BASE_MONTH_NAME).toHaveLength(12);
+  });
+});
+
+describe('useDatePicker', () => {
+  it('初始化空值显示 placeholder', () => {
+    const dp = useDatePicker({ type: 'date' });
+    expect(dp.displayValue.value).toBe('请选择日期...');
+    expect(dp.spanClass.value).toContain('m-date-picker-placeholder');
+  });
+
+  it('初始化有效日期正确解析', () => {
+    const dp = useDatePicker({ type: 'date', modelValue: '2026-06-15' });
+    expect(dp.displayValue.value).toBe('2026-06-15');
+    expect(dp.dateRef.value.year).toBe(2026);
+    expect(dp.dateRef.value.month).toBe(6);
+    expect(dp.dateRef.value.day).toBe(15);
+  });
+
+  it('自定义 placeholder', () => {
+    const dp = useDatePicker({ type: 'date', placeholder: '选择日期' });
+    expect(dp.displayValue.value).toBe('选择日期');
+  });
+
+  it('updateDateRef 更新状态', () => {
+    const dp = useDatePicker({ type: 'date' });
+    dp.updateDateRef('2025-12-25');
+
+    expect(dp.dateRef.value.year).toBe(2025);
+    expect(dp.dateRef.value.month).toBe(12);
+    expect(dp.dateRef.value.day).toBe(25);
+    expect(dp.displayValue.value).toBe('2025-12-25');
+  });
+
+  it('updateDateRef 空值恢复 placeholder', () => {
+    const dp = useDatePicker({ type: 'date', modelValue: '2026-01-01' });
+    dp.updateDateRef('');
+
+    expect(dp.displayValue.value).toBe('请选择日期...');
+  });
+
+  it('getCalendar 返回 6 行 7 列', () => {
+    const dp = useDatePicker({ type: 'date', modelValue: '2026-03-15' });
+    const calendar = dp.getCalendar(dp.dateRef);
+
+    expect(calendar).toHaveLength(6);
+    calendar.forEach(row => {
+      expect(row).toHaveLength(7);
+    });
+  });
+
+  it('getCalendar 包含当月天数', () => {
+    const dp = useDatePicker({ type: 'date', modelValue: '2026-02-15' });
+    const calendar = dp.getCalendar(dp.dateRef);
+    const allDays = calendar.flat();
+    const currentMonthDays = allDays.filter(d => d.isCurrentMonth);
+
+    // 2026 年 2 月有 28 天
+    expect(currentMonthDays).toHaveLength(28);
+  });
+
+  it('getCalendar 标记当前选中日', () => {
+    const dp = useDatePicker({ type: 'date', modelValue: '2026-03-15' });
+    const calendar = dp.getCalendar(dp.dateRef);
+    const allDays = calendar.flat();
+    const currentDay = allDays.find(d => d.isCurrent);
+
+    expect(currentDay).toBeDefined();
+    expect(currentDay!.day).toBe(15);
+  });
+
+  it('toPrevMonth 切换上月', () => {
+    const dp = useDatePicker({ type: 'date', modelValue: '2026-03-15' });
+    dp.toPrevMonth();
+    expect(dp.dateRef.value.month).toBe(2);
+  });
+
+  it('toPrevMonth 跨年', () => {
+    const dp = useDatePicker({ type: 'date', modelValue: '2026-01-15' });
+    dp.toPrevMonth();
+    expect(dp.dateRef.value.month).toBe(12);
+    expect(dp.dateRef.value.year).toBe(2025);
+  });
+
+  it('toNextMonth 切换下月', () => {
+    const dp = useDatePicker({ type: 'date', modelValue: '2026-03-15' });
+    dp.toNextMonth();
+    expect(dp.dateRef.value.month).toBe(4);
+  });
+
+  it('toNextMonth 跨年', () => {
+    const dp = useDatePicker({ type: 'date', modelValue: '2026-12-15' });
+    dp.toNextMonth();
+    expect(dp.dateRef.value.month).toBe(1);
+    expect(dp.dateRef.value.year).toBe(2027);
+  });
+
+  it('toPrevYear / toNextYear', () => {
+    const dp = useDatePicker({ type: 'date', modelValue: '2026-06-15' });
+    dp.toPrevYear();
+    expect(dp.dateRef.value.year).toBe(2025);
+    dp.toNextYear();
+    dp.toNextYear();
+    expect(dp.dateRef.value.year).toBe(2027);
+  });
+
+  it('getValue 返回格式化日期字符串', () => {
+    const dp = useDatePicker({ type: 'date' });
+    const value = dp.getValue({ day: 20, month: 6, year: 2026, isCurrentMonth: true });
+    expect(value).toBe('2026-06-20');
+  });
+
+  it('month 类型使用 YYYY-MM 格式', () => {
+    const dp = useDatePicker({ type: 'month', modelValue: '2026-03' });
+    expect(dp.displayValue.value).toBe('2026-03');
+  });
+
+  it('自定义 format', () => {
+    const dp = useDatePicker({ type: 'date', format: 'YYYY/MM/DD', modelValue: '2026-03-15' });
+    expect(dp.displayValue.value).toBe('2026/03/15');
+  });
+
+  it('clickCurrentYear 切换到年份选择模式', () => {
+    const dp = useDatePicker({ type: 'date', modelValue: '2026-03-15' });
+    dp.clickCurrentYear(2026);
+    expect(dp.calendarTypeRef.value).toBe('year');
+    expect(dp.yearsRef.value).toHaveLength(12);
+    expect(dp.yearsRef.value).toContain(2026);
+  });
+
+  it('clickYearItem 更新年份并切换回日期模式', () => {
+    const dp = useDatePicker({ type: 'date', modelValue: '2026-03-15' });
+    dp.clickCurrentYear(2026);
+    dp.clickYearItem(2028);
+    expect(dp.dateRef.value.year).toBe(2028);
+    expect(dp.calendarTypeRef.value).toBe('date');
+  });
+
+  it('clickCurrentMonth 切换到月份选择模式', () => {
+    const dp = useDatePicker({ type: 'date', modelValue: '2026-03-15' });
+    dp.clickCurrentMonth(3);
+    expect(dp.calendarTypeRef.value).toBe('month');
+  });
+
+  it('clickMonthItem 更新月份并切换回日期模式', () => {
+    const dp = useDatePicker({ type: 'date', modelValue: '2026-03-15' });
+    dp.clickCurrentMonth(3);
+    dp.clickMonthItem(8);
+    expect(dp.dateRef.value.month).toBe(8);
+    expect(dp.calendarTypeRef.value).toBe('date');
+  });
+
+  // datetime 模式
+  it('datetime 模式初始化包含时间', () => {
+    const dp = useDatePicker({ type: 'datetime', modelValue: '2026-03-15 14:30:45' });
+    expect(dp.timeRef.value.hours).toBe(14);
+    expect(dp.timeRef.value.minutes).toBe(30);
+    expect(dp.timeRef.value.seconds).toBe(45);
+  });
+
+  it('selectHour / selectMinute / selectSecond', () => {
+    const dp = useDatePicker({ type: 'datetime' });
+    dp.selectHour(10);
+    expect(dp.timeRef.value.hours).toBe(10);
+
+    dp.selectMinute(25);
+    expect(dp.timeRef.value.minutes).toBe(25);
+
+    dp.selectSecond(59);
+    expect(dp.timeRef.value.seconds).toBe(59);
+  });
+
+  it('getDateTimeValue 组合日期和时间', () => {
+    const dp = useDatePicker({ type: 'datetime', modelValue: '2026-03-15 00:00:00' });
+    dp.selectHour(8);
+    dp.selectMinute(30);
+    dp.selectSecond(0);
+
+    const value = dp.getDateTimeValue();
+    expect(value).toContain('2026-03-15');
+    expect(value).toContain('08:30:00');
+  });
+});

package/components/base/dropdown/useDropdown.ts

@@ -9,8 +9,9 @@
 import { computed, onBeforeUnmount, onMounted, ref } from 'vue';
 import { DropdownItemProps, DropdownProps } from './props';
 import useClickAway from '../../../compositions/popper/useClickAway';
+import { type HookContext } from '../../types/hook';
 
-export function useDropdown(props: Required<DropdownProps>, ctx: any) {
+export function useDropdown(props: Required<DropdownProps>, ctx: HookContext) {
   const { emit } = ctx;
 
   // 下拉菜单是否展开

package/components/base/image/__tests__/useImage.test.ts

@@ -0,0 +1,174 @@
+/**
+ * @description useImage 测试
+ * @author 阿怪
+ * @date 2026/3/23
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { useImage } from '../useImage';
+
+const defaultProps = {
+  src: 'test.png',
+  alt: '',
+  fit: 'cover' as const,
+  lazy: false,
+  previewSrcList: [] as string[],
+  initialIndex: 0,
+  width: '' as string | number,
+  height: '' as string | number,
+  zIndex: 2000,
+};
+
+describe('useImage', () => {
+  const createEmit = () => vi.fn();
+
+  it('初始状态为 loading', () => {
+    const emit = createEmit();
+    const { status } = useImage(defaultProps, emit);
+    expect(status.value).toBe('loading');
+  });
+
+  it('handleLoad 设置状态为 loaded 并触发 emit', () => {
+    const emit = createEmit();
+    const { status, handleLoad } = useImage(defaultProps, emit);
+    const event = new Event('load');
+
+    handleLoad(event);
+    expect(status.value).toBe('loaded');
+    expect(emit).toHaveBeenCalledWith('load', event);
+  });
+
+  it('handleError 设置状态为 error 并触发 emit', () => {
+    const emit = createEmit();
+    const { status, handleError } = useImage(defaultProps, emit);
+    const event = new Event('error');
+
+    handleError(event);
+    expect(status.value).toBe('error');
+    expect(emit).toHaveBeenCalledWith('error', event);
+  });
+
+  // 预览功能
+  it('openPreview 无 previewSrcList 时不打开', () => {
+    const emit = createEmit();
+    const { previewVisible, openPreview } = useImage(defaultProps, emit);
+
+    openPreview();
+    expect(previewVisible.value).toBe(false);
+  });
+
+  it('openPreview 有 previewSrcList 时打开并定位', () => {
+    const emit = createEmit();
+    const props = { ...defaultProps, previewSrcList: ['a.png', 'test.png', 'c.png'] };
+    const { previewVisible, previewIndex, openPreview } = useImage(props, emit);
+
+    openPreview();
+    expect(previewVisible.value).toBe(true);
+    expect(previewIndex.value).toBe(1); // test.png 在索引 1
+  });
+
+  it('openPreview src 不在列表中时定位到 0', () => {
+    const emit = createEmit();
+    const props = { ...defaultProps, src: 'unknown.png', previewSrcList: ['a.png', 'b.png'] };
+    const { previewIndex, openPreview } = useImage(props, emit);
+
+    openPreview();
+    expect(previewIndex.value).toBe(0);
+  });
+
+  it('closePreview 关闭预览', () => {
+    const emit = createEmit();
+    const props = { ...defaultProps, previewSrcList: ['a.png'] };
+    const { previewVisible, openPreview, closePreview } = useImage(props, emit);
+
+    openPreview();
+    closePreview();
+    expect(previewVisible.value).toBe(false);
+  });
+
+  it('previewNext / previewPrev 循环切换', () => {
+    const emit = createEmit();
+    const props = { ...defaultProps, src: 'a.png', previewSrcList: ['a.png', 'b.png', 'c.png'] };
+    const { previewIndex, openPreview, previewNext, previewPrev } = useImage(props, emit);
+
+    openPreview(); // index = 0
+
+    previewNext(); // index = 1
+    expect(previewIndex.value).toBe(1);
+    expect(emit).toHaveBeenCalledWith('switch', 1);
+
+    previewNext(); // index = 2
+    expect(previewIndex.value).toBe(2);
+
+    previewNext(); // 循环回 0
+    expect(previewIndex.value).toBe(0);
+
+    previewPrev(); // 循环到 2
+    expect(previewIndex.value).toBe(2);
+  });
+
+  it('zoomIn 放大', () => {
+    const emit = createEmit();
+    const props = { ...defaultProps, previewSrcList: ['a.png'] };
+    const { previewScale, openPreview, zoomIn } = useImage(props, emit);
+
+    openPreview();
+    expect(previewScale.value).toBe(1);
+
+    zoomIn();
+    expect(previewScale.value).toBe(1.25);
+
+    // 最大 5
+    for (let i = 0; i < 20; i++) zoomIn();
+    expect(previewScale.value).toBe(5);
+  });
+
+  it('zoomOut 缩小', () => {
+    const emit = createEmit();
+    const props = { ...defaultProps, previewSrcList: ['a.png'] };
+    const { previewScale, openPreview, zoomOut } = useImage(props, emit);
+
+    openPreview();
+    zoomOut();
+    expect(previewScale.value).toBe(0.75);
+
+    // 最小 0.25
+    for (let i = 0; i < 20; i++) zoomOut();
+    expect(previewScale.value).toBe(0.25);
+  });
+
+  it('rotate 旋转 90°', () => {
+    const emit = createEmit();
+    const props = { ...defaultProps, previewSrcList: ['a.png'] };
+    const { previewRotate, openPreview, rotate } = useImage(props, emit);
+
+    openPreview();
+    rotate();
+    expect(previewRotate.value).toBe(90);
+
+    rotate();
+    expect(previewRotate.value).toBe(180);
+
+    rotate();
+    rotate();
+    expect(previewRotate.value).toBe(0); // 360 % 360 = 0
+  });
+
+  it('切换预览图片时重置缩放和旋转', () => {
+    const emit = createEmit();
+    const props = { ...defaultProps, src: 'a.png', previewSrcList: ['a.png', 'b.png'] };
+    const { previewScale, previewRotate, openPreview, zoomIn, rotate, previewNext } = useImage(props, emit);
+
+    openPreview();
+    zoomIn();
+    rotate();
+    expect(previewScale.value).toBe(1.25);
+    expect(previewRotate.value).toBe(90);
+
+    previewNext();
+    expect(previewScale.value).toBe(1);
+    expect(previewRotate.value).toBe(0);
+  });
+});

package/components/base/input/useInput.ts

@@ -6,12 +6,14 @@
  *
  * 江湖的业务千篇一律，复杂的代码好几百行。
  */
+
 import { HTMLElementEvent } from '../../types/template';
+import { type HookContext } from '../../types/hook';
 
 
 export function useInput<
   Props extends Record<string, any>,
->(props: Props, ctx: any) {
+>(props: Props, ctx: HookContext) {
 
   const isInput = props.type !== 'textarea';
   const inputType = isInput ? 'input' : 'textarea';

package/components/base/inputNumber/__tests__/useInputNumber.test.ts

@@ -0,0 +1,153 @@
+/**
+ * @description useInputNumber 归一 / emit 保真单测
+ * @author 阿怪
+ * @date 2026/4/24
+ * @version v1.0.0
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { nextTick, reactive } from 'vue';
+import { useInputNumber } from '../useInputNumber';
+import type { InputNumberProps } from '../props';
+import type { HookContext } from '../../../types/hook';
+
+type PropsShape = Required<InputNumberProps>;
+
+const defaultProps: PropsShape = {
+  modelValue: null,
+  max: Infinity,
+  min: -Infinity,
+  step: 1,
+  precision: 0,
+  disabled: false,
+  readonly: false,
+  placeholder: '',
+  controls: true,
+  size: 'medium' as PropsShape['size'],
+};
+
+function setup(overrides: Partial<PropsShape> = {}) {
+  const props = reactive<PropsShape>({ ...defaultProps, ...overrides }) as PropsShape;
+  const emit = vi.fn();
+  const ctx: HookContext = { emit, slots: {} };
+  const hook = useInputNumber(props, ctx);
+  return { props, emit, ...hook };
+}
+
+const lastUpdate = (emit: ReturnType<typeof vi.fn>) =>
+  emit.mock.calls.filter((c: unknown[]) => c[0] === 'update:modelValue').at(-1)!;
+
+describe('useInputNumber emit 归一', () => {
+  it('number 入 → number 出', () => {
+    const { validate, emit } = setup({ modelValue: 1 });
+    validate(5);
+    const call = lastUpdate(emit);
+    expect(call[1]).toBe(5);
+    expect(typeof call[1]).toBe('number');
+  });
+
+  it('string 入 → string 出', () => {
+    const { validate, emit } = setup({ modelValue: '1' });
+    validate('5');
+    const call = lastUpdate(emit);
+    expect(call[1]).toBe('5');
+    expect(typeof call[1]).toBe('string');
+  });
+
+  it('null 入 → 用户输入整数后默认 number 出', () => {
+    const { validate, emit } = setup({ modelValue: null });
+    validate(3);
+    const call = lastUpdate(emit);
+    expect(call[1]).toBe(3);
+    expect(typeof call[1]).toBe('number');
+  });
+
+  it('空字符串 currentValue → emit null（不是空串）', () => {
+    const { validate, emit } = setup({ modelValue: 5 });
+    validate(null);
+    const call = lastUpdate(emit);
+    expect(call[1]).toBeNull();
+  });
+
+  it('中间态 "-" → emit null（未输完）', () => {
+    const { validate, emit } = setup({ modelValue: null });
+    validate('-');
+    const call = lastUpdate(emit);
+    expect(call[1]).toBeNull();
+  });
+
+  it('输入 "0." → emit 0（末尾小数点归一）', () => {
+    const { validate, emit } = setup({ modelValue: null, precision: 2 });
+    validate('0.');
+    const call = lastUpdate(emit);
+    expect(call[1]).toBe(0);
+  });
+
+  it('非法字符串 → emit 原样不变（validate 不触发 emit）', () => {
+    const { validate, emit } = setup({ modelValue: 5 });
+    emit.mockClear();
+    validate('abc' as unknown as number);
+    // 非法输入不触发 emit
+    expect(emit).not.toHaveBeenCalled();
+  });
+
+  it('跨类型 watch：外部传 1（number）→ 不会重复 emit 成 string', async () => {
+    const { props, emit } = setup({ modelValue: 1 });
+    emit.mockClear();
+    // 模拟外部 bind 把内部 string '1' 回传 number 1：这在真实 v-model 里是 watch 触发的
+    props.modelValue = 1;
+    await nextTick();
+    // 内部 '1' 和外部 1 的 String 归一相等，不该触发 emit
+    expect(emit).not.toHaveBeenCalled();
+  });
+
+  it('blur 末尾小数点归一：内部 "1." → emit 1', () => {
+    const { handleInputChange, handleInputBlur, emit } = setup({ modelValue: null, precision: 2 });
+    handleInputChange({ target: { value: '1.' } } as never);
+    emit.mockClear();
+    handleInputBlur();
+    const call = lastUpdate(emit);
+    expect(call[1]).toBe(1);
+  });
+
+  it('max 截断仍然保真类型', () => {
+    const { validate, emit } = setup({ modelValue: '10', max: 100 });
+    validate(150);
+    const call = lastUpdate(emit);
+    expect(call[1]).toBe('100');
+    expect(typeof call[1]).toBe('string');
+  });
+
+  it('min 截断仍然保真类型', () => {
+    const { validate, emit } = setup({ modelValue: 10, min: 0 });
+    validate(-5);
+    const call = lastUpdate(emit);
+    expect(call[1]).toBe(0);
+    expect(typeof call[1]).toBe('number');
+  });
+});
+
+describe('useInputNumber 输入流程', () => {
+  it('合法数字输入触发 emit', () => {
+    const { handleInputChange, emit } = setup({ modelValue: 0 });
+    emit.mockClear();
+    handleInputChange({ target: { value: '88' } } as never);
+    const call = lastUpdate(emit);
+    expect(call[1]).toBe(88);
+  });
+
+  it('increment 按 step 递增', () => {
+    const { increment, emit } = setup({ modelValue: 5, step: 3 });
+    emit.mockClear();
+    increment();
+    const call = lastUpdate(emit);
+    expect(call[1]).toBe(8);
+  });
+
+  it('decrement 按 step 递减', () => {
+    const { decrement, emit } = setup({ modelValue: 5, step: 2 });
+    emit.mockClear();
+    decrement();
+    const call = lastUpdate(emit);
+    expect(call[1]).toBe(3);
+  });
+});