@kine-design/core 0.0.1-beta.4 → 0.0.1-beta.6

package/dist/components/base/slider/useSlider.d.ts

@@ -1,5 +1,6 @@
 import { SliderProps } from './props';
-export declare function useSlider(props: Required<SliderProps>, ctx: any): {
+import { HookContext } from '../../types/hook';
+export declare function useSlider(props: Required<SliderProps>, ctx: HookContext): {
     btnRef: import('vue').Ref<HTMLElement | null | undefined, HTMLElement | null | undefined>;
     sliderRef: import('vue').Ref<HTMLElement | null, HTMLElement | null>;
     perRef: import('vue').Ref<number, number>;

package/dist/components/base/steps/__tests__/useSteps.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/base/switch/useSwitch.d.ts

@@ -1,7 +1,8 @@
 import { SwitchProps } from './props';
+import { HookContext } from '../../types/hook';
 export declare const switchIsBoolean: (value: SwitchProps["modelValue"]) => value is boolean;
 export declare const getIsActive: (value: SwitchProps["modelValue"], activeValue: SwitchProps["activeValue"]) => boolean;
-export declare function useSwitch<Props extends Record<string, any>>(props: Props, ctx: any): {
+export declare function useSwitch<Props extends Record<string, any>>(props: Props, ctx: HookContext): {
     getInfo: (key: keyof Pick<SwitchProps, "activeInfo" | "inactiveInfo">) => any;
     changeSwitch: () => void;
     switchClass: import('vue').ComputedRef<(string | {

package/dist/components/base/tabs/useTabs.d.ts

@@ -1,4 +1,5 @@
-export declare function useTabs<Props extends Record<string, unknown>>(props: Props, ctx: any): {
+import { HookContext } from '../../types/hook';
+export declare function useTabs<Props extends Record<string, unknown>>(props: Props, ctx: HookContext): {
     activeTab: import('vue').ComputedRef<string | number>;
     isActive: (name: string | number) => boolean;
     switchTab: (name: string | number, disabled?: boolean) => void;

package/dist/components/base/timePicker/__tests__/useTimePicker.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/base/transfer/useTransfer.d.ts

@@ -1,5 +1,6 @@
 import { TransferItem, TransferProps } from './props';
-export declare function useTransfer(props: TransferProps, ctx: any): {
+import { HookContext } from '../../types/hook';
+export declare function useTransfer(props: TransferProps, ctx: HookContext): {
     leftSearch: import('vue').Ref<string, string>;
     rightSearch: import('vue').Ref<string, string>;
     leftData: import('vue').ComputedRef<TransferItem[]>;

package/dist/components/base/tree/__tests__/tree.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/message/notification/__tests__/useNotification.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/message/popover/usePopover.d.ts

@@ -50,7 +50,7 @@ export declare function usePopover(options: Options<{
     style: Ref<any, any>;
     arrowStyle: Ref<any, any>;
     lifecycle: {
-        onBeforeDestroyEvents: Function[];
+        onBeforeUnmountEvents: Function[];
     };
 };
 export {};

package/dist/components/other/darkMode/useDarkMode.d.ts

@@ -1,9 +1,8 @@
+import { HookContext } from '../../types/hook';
 import { DarkModeProps } from './props';
 /** 将暗色状态同步到 html[dark] attribute */
 declare function applyDarkAttr(isDark: boolean): void;
-export declare function useDarkMode(props: DarkModeProps, ctx: {
-    emit: (event: string, ...args: any[]) => void;
-}): {
+export declare function useDarkMode(props: DarkModeProps, ctx: Pick<HookContext, 'emit'>): {
     isDark: import('vue').Ref<boolean, boolean>;
     toggle: () => void;
     applyDarkAttr: typeof applyDarkAttr;

package/dist/components/template/menu/__tests__/useMenu.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/template/pagination/__tests__/usePagination.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/template/table/__tests__/useTable.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/compositions/common/__tests__/useDebounceFn.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/compositions/common/__tests__/useEventListener.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/compositions/common/__tests__/usePopover.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/compositions/common/__tests__/useTeleport.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/compositions/common/useComponentSize.d.ts

@@ -0,0 +1,6 @@
+import { InjectionKey, Ref } from 'vue';
+import { KineSize } from '../../components/types/props';
+export declare const KINE_SIZE_KEY: InjectionKey<Ref<KineSize>>;
+export declare function useComponentSize(props: {
+    size?: KineSize;
+}): Ref<KineSize>;

package/dist/compositions/common/useEventListener.d.ts

@@ -7,7 +7,7 @@
  * 江湖的业务千篇一律，复杂的代码好几百行。
  */
 export type EventListenerOptions = {
-    target: any;
+    target: EventTarget | (() => EventTarget);
     event: string;
     handler: EventListenerOrEventListenerObject;
 };
@@ -15,5 +15,5 @@ export default function useEventListener(options: EventListenerOptions): {
     add: () => void;
     remove: () => void;
     onMounted: () => void;
-    onBeforeDestroy: () => void;
+    onBeforeUnmount: () => void;
 };

package/dist/compositions/input/__tests__/useBooleanInput.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/compositions/modal/__tests__/useModal.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/compositions/modal/useModal.d.ts

@@ -1,9 +1,10 @@
+import { HookContext } from '../../components/types/hook';
 import { ModelMask } from '../../types/common/model';
 export interface UseModalProps {
     visible?: boolean;
     mask?: ModelMask;
 }
-export declare function useModal(props: UseModalProps, emit: (...args: any[]) => void): {
+export declare function useModal(props: UseModalProps, emit: HookContext['emit']): {
     visible: import('vue').Ref<boolean, boolean>;
     open: () => void;
     close: () => void;

package/dist/compositions/popper/useClickAway.d.ts

@@ -1,9 +1,9 @@
 export default function useClickAway(options: {
-    target: any;
-    handler: (event: any) => void;
+    target: EventTarget | (() => EventTarget | null | undefined);
+    handler: (event: PointerEvent) => void;
 }): {
     add: () => void;
     remove: () => void;
     onMounted: () => void;
-    onBeforeDestroy: () => void;
+    onBeforeUnmount: () => void;
 } | undefined;

package/dist/compositions/utils/__tests__/filters.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/compositions/virtualList/__tests__/useHeightCache.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core.js

@@ -56,6 +56,22 @@ var props$49 = {
 	autofocus: {
 		type: Boolean,
 		default: false
+	},
+	clearable: {
+		type: Boolean,
+		default: false
+	},
+	size: {
+		type: String,
+		default: void 0
+	},
+	maxlength: {
+		type: Number,
+		default: void 0
+	},
+	showWordLimit: {
+		type: Boolean,
+		default: false
 	}
 };
 //#endregion
@@ -71,7 +87,8 @@ function useInput(props, ctx) {
 		placeholder: props.placeholder,
 		disabled: props.disabled,
 		type: props.type,
-		readOnly: props.readonly
+		readOnly: props.readonly,
+		maxLength: props.maxlength
 	};
 	const onInput = (e) => {
 		ctx.emit("update:modelValue", e.target.value);
@@ -83,6 +100,11 @@ function useInput(props, ctx) {
 	const onBlur = (e) => {
 		ctx.emit("blur", e);
 	};
+	const onClear = () => {
+		ctx.emit("update:modelValue", "");
+		ctx.emit("input", "");
+		ctx.emit("clear");
+	};
 	return {
 		baseProps,
 		inputType,
@@ -90,7 +112,8 @@ function useInput(props, ctx) {
 		rowInfo,
 		onInput,
 		onFocus,
-		onBlur
+		onBlur,
+		onClear
 	};
 }
 //#endregion
@@ -144,7 +167,7 @@ var props$48 = {
 	},
 	size: {
 		type: String,
-		default: "medium",
+		default: void 0,
 		enum: [
 			"large",
 			"medium",
@@ -255,6 +278,18 @@ var props$47 = {
 	fetch: {
 		type: Function,
 		default: void 0
+	},
+	clearable: {
+		type: Boolean,
+		default: false
+	},
+	size: {
+		type: String,
+		default: void 0
+	},
+	loading: {
+		type: Boolean,
+		default: false
 	}
 };
 //#endregion
@@ -799,7 +834,7 @@ var TagCore = { props: {
 	},
 	size: {
 		type: String,
-		default: "medium"
+		default: void 0
 	},
 	closable: {
 		type: Boolean,
@@ -813,6 +848,10 @@ var TagCore = { props: {
 //#endregion
 //#region components/base/progress/api.ts
 var props$43 = {
+	type: {
+		type: String,
+		default: "line"
+	},
 	value: {
 		type: Number,
 		default: 0
@@ -832,6 +871,10 @@ var props$43 = {
 	strokeWidth: {
 		type: Number,
 		default: 4
+	},
+	width: {
+		type: Number,
+		default: 80
 	}
 };
 //#endregion
@@ -1036,6 +1079,10 @@ var props$39 = {
 	controls: {
 		type: Boolean,
 		default: true
+	},
+	size: {
+		type: String,
+		default: void 0
 	}
 };
 //#endregion
@@ -1044,20 +1091,58 @@ var props$39 = {
 * @description inputNumber composable
 * @author 阿怪
 * @date 2026/2/25 00:00
-* @version v1.1.0
+* @version v1.2.0
 *
 * 江湖的业务千篇一律，复杂的代码好几百行。
+*
+* v1.2.0 changelog:
+* - emit 类型保真：string 入 string 出，number 入 number 出；空值一律 emit null
+* - 内部 currentValue 保留中间态（'-' / '0.' / ''），仅在 emit 时归一
+*/
+/** 用户输入中间态：不构成可 emit 的数字，emit null */
+var MID_STATES = new Set([
+	"",
+	"-",
+	".",
+	"-."
+]);
+/**
+* 把任意内部值归一为 number | null。
+* 规则：
+* - null/undefined/中间态 → null
+* - 末尾小数点去掉（'1.' → '1'）
+* - 非法 NaN → null
+* - 其他 → Number(v)
 */
+var normalize = (v) => {
+	if (v === null || v === void 0) return null;
+	const s = String(v);
+	if (MID_STATES.has(s)) return null;
+	const cleaned = s.endsWith(".") ? s.slice(0, -1) : s;
+	const n = Number(cleaned);
+	return Number.isNaN(n) ? null : n;
+};
 function useInputNumber(props, ctx) {
 	const currentValue = ref(props.modelValue ?? "");
+	/**
+	* 按外部 modelValue 的当前 typeof 决定出参类型，保真 v-model 声明。
+	* - null/undefined → null
+	* - 外部当前是 string → emit String(n)
+	* - 否则 → emit n（默认 number）
+	*/
+	const toEmitValue = (n) => {
+		if (n === null) return null;
+		return typeof props.modelValue === "string" ? String(n) : n;
+	};
 	const updateInput = (oldVal) => {
-		ctx.emit("update:modelValue", currentValue.value);
-		ctx.emit("change", currentValue.value, oldVal);
+		const out = toEmitValue(normalize(currentValue.value));
+		ctx.emit("update:modelValue", out);
+		ctx.emit("change", out, oldVal);
 	};
 	const setCurrentValue = (newVal, e) => {
 		const oldVal = currentValue.value;
 		const { min, max, precision } = props;
-		if (oldVal === newVal) return;
+		if (String(oldVal) === String(newVal)) return;
 		else if (+newVal >= +max) newVal = max;
 		else if (+newVal <= +min) newVal = min;
 		else if (precision !== 0 && String(newVal).includes(".") && `${newVal}`.length - (`${newVal}`.indexOf(".") + 1) >= precision) newVal = Number(`${newVal}`.substring(0, `${newVal}`.indexOf(".") + (precision + 1)));
@@ -1085,11 +1170,15 @@ function useInputNumber(props, ctx) {
 		validate(val, e);
 	};
 	const handleInputBlur = () => {
+		const oldVal = currentValue.value;
 		if (currentValue.value === "-") currentValue.value = "";
 		else if (currentValue.value === "-0") currentValue.value = 0;
-		const oldVal = currentValue.value;
-		const str = String(currentValue.value);
-		currentValue.value = str.indexOf(".") === str.length - 1 ? str.replace(/\.$/g, "") : currentValue.value;
+		else {
+			const str = String(currentValue.value);
+			if (str.indexOf(".") === str.length - 1 && str.length > 0) currentValue.value = str.replace(/\.$/g, "");
+		}
+		const n = normalize(currentValue.value);
+		currentValue.value = n === null ? "" : n;
 		updateInput(oldVal);
 	};
 	/**
@@ -1175,6 +1264,14 @@ var props$38 = {
 	showStops: {
 		type: Boolean,
 		default: false
+	},
+	readonly: {
+		type: Boolean,
+		default: false
+	},
+	size: {
+		type: String,
+		default: void 0
 	}
 };
 //#endregion
@@ -1197,13 +1294,17 @@ function useResizeObserver(target, callback, options = {}) {
 			observer = void 0;
 		}
 	};
-	watch(target, () => {
+	const stopWatch = watch(target, () => {
 		if (target.value) {
 			cleanup();
 			observer = new ResizeObserver(callback);
 			observer.observe(target.value, options);
 		}
 	});
+	onBeforeUnmount(() => {
+		cleanup();
+		stopWatch();
+	});
 	return { cleanup };
 }
 //#endregion
@@ -1297,6 +1398,7 @@ function useSlider(props, ctx) {
 	const btnW = 20;
 	const sub = props.max - props.min;
 	const movePositionHandler = (event, position) => {
+		if (props.readonly) return position;
 		const totalW = sliderSize.w.value - btnW;
 		let positionX = position.x + event.dx;
 		if (positionX > totalW) positionX = totalW;
@@ -1586,14 +1688,14 @@ function useEventListener(options) {
 	const onMounted = () => {
 		add();
 	};
-	const onBeforeDestroy = () => {
+	const onBeforeUnmount = () => {
 		remove();
 	};
 	return {
 		add,
 		remove,
 		onMounted,
-		onBeforeDestroy
+		onBeforeUnmount
 	};
 }
 //#endregion
@@ -1751,8 +1853,8 @@ function usePopover$1(props, ctx) {
 	});
 	onBeforeUnmount(() => {
 		if (clickAwayInstance) {
-			const { onBeforeDestroy } = clickAwayInstance;
-			onBeforeDestroy();
+			const { onBeforeUnmount } = clickAwayInstance;
+			onBeforeUnmount();
 		}
 		instance?.destroy();
 	});
@@ -1796,6 +1898,10 @@ var props$36 = {
 	disabled: {
 		type: Boolean,
 		default: false
+	},
+	maxWidth: {
+		type: String,
+		default: void 0
 	}
 };
 //#endregion
@@ -1917,7 +2023,7 @@ var LoadingCore = { props: {
 	},
 	size: {
 		type: String,
-		default: "medium"
+		default: void 0
 	},
 	mask: {
 		type: Boolean,
@@ -1965,6 +2071,10 @@ var DialogCore = { props: {
 	width: {
 		type: String,
 		default: void 0
+	},
+	beforeClose: {
+		type: Function,
+		default: void 0
 	}
 } };
 //#endregion
@@ -2012,6 +2122,10 @@ var DrawerCore = { props: {
 	height: {
 		type: String,
 		default: void 0
+	},
+	beforeClose: {
+		type: Function,
+		default: void 0
 	}
 } };
 //#endregion
@@ -2602,6 +2716,22 @@ var props$25 = {
 	disabled: {
 		type: Boolean,
 		default: false
+	},
+	readonly: {
+		type: Boolean,
+		default: false
+	},
+	clearable: {
+		type: Boolean,
+		default: false
+	},
+	size: {
+		type: String,
+		default: void 0
+	},
+	disabledDate: {
+		type: Function,
+		default: void 0
 	}
 };
 //#endregion
@@ -3334,8 +3464,8 @@ function useTable() {
 		});
 		/** 从 data[i] 中安全取值 */
 		const getData = (i, param) => {
-			if (data[i] && data[i][param]) return data[i][param];
-			return "";
+			if (data[i] == null) return "";
+			return data[i][param] ?? "";
 		};
 		/** 向每行的 td 列表中追加一列 */
 		const pushTd = (param, bodySlot, style) => {
@@ -3925,7 +4055,7 @@ function usePopover(options, lifecycle) {
 	const popoverLeave = () => {
 		if (props.hover) instance?.hide();
 	};
-	const onBeforeDestroyEvents = [];
+	const onBeforeUnmountEvents = [];
 	onMounted(() => {
 		if (!popoverRef.value || !contentRef.value) return;
 		popperInstance.value = createPopover(popoverRef.value, contentRef.value, arrowRef.value, {
@@ -3942,8 +4072,8 @@ function usePopover(options, lifecycle) {
 	});
 	onBeforeUnmount(() => {
 		if (clickAwayInstance) {
-			const { onBeforeDestroy } = clickAwayInstance;
-			onBeforeDestroy();
+			const { onBeforeUnmount } = clickAwayInstance;
+			onBeforeUnmount();
 		}
 		instance?.destroy();
 	});
@@ -3969,7 +4099,7 @@ function usePopover(options, lifecycle) {
 		popperInstance,
 		style,
 		arrowStyle,
-		lifecycle: { onBeforeDestroyEvents }
+		lifecycle: { onBeforeUnmountEvents }
 	};
 }
 //#endregion

package/dist/tools/__tests__/empty.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/empty.d.ts

@@ -10,9 +10,9 @@
  * 支持稍多类型的判断非空的方法
  * @param value
  */
-export declare const notEmpty: (value: any) => number | boolean | undefined;
+export declare const notEmpty: (value: unknown) => number | boolean | undefined;
 /**
  * 判断为空的方法，即notEmpty的取反
  * @param value
  */
-export declare const isEmpty: (value: any) => boolean;
+export declare const isEmpty: (value: unknown) => boolean;

package/dist/tools/types.d.ts

@@ -6,4 +6,4 @@
  *
  * 江湖的业务千篇一律，复杂的代码好几百行。
  */
-export declare const isBoolean: (val: any) => val is boolean;
+export declare const isBoolean: (val: unknown) => val is boolean;

package/dist/vitest.config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @description @kine-design/core 单元测试配置
+ * @author 阿怪
+ * @date 2026/3/23
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+declare const _default: import('vite').UserConfig;
+export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kine-design/core",
-  "version": "0.0.1-beta.4",
+  "version": "0.0.1-beta.6",
   "description": "",
   "type": "module",
   "main": "./dist/core.js",
@@ -19,8 +19,12 @@
       "dist"
     ]
   },
+  "devDependencies": {
+    "vitest": "^4.1.0"
+  },
   "scripts": {
-    "build": "vite build --config vite.config.build.ts"
+    "build": "vite build --config vite.config.build.ts",
+    "test": "vitest --config vitest.config.ts --run"
   },
   "module": "./dist/core.js",
   "exports": {

package/tools/__tests__/empty.test.ts

@@ -0,0 +1,72 @@
+/**
+ * @description notEmpty / isEmpty 工具函数测试
+ * @author 阿怪
+ * @date 2026/3/23
+ * @version v1.0.0
+ *
+ * 江湖的业务千篇一律，复杂的代码好几百行。
+ */
+import { describe, expect, it } from 'vitest';
+import { notEmpty, isEmpty } from '../empty';
+
+describe('notEmpty', () => {
+  // 基本空值
+  it('null 为空', () => expect(notEmpty(null)).toBe(false));
+  it('undefined 为空', () => expect(notEmpty(undefined)).toBe(false));
+
+  // 字符串
+  it('空字符串为空', () => expect(notEmpty('')).toBe(false));
+  it('非空字符串非空', () => expect(notEmpty('hello')).toBe(true));
+
+  // 数字
+  it('0 非空', () => expect(notEmpty(0)).toBe(true));
+  it('正数非空', () => expect(notEmpty(42)).toBe(true));
+  it('NaN 非空（数字类型）', () => expect(notEmpty(NaN)).toBe(true));
+
+  // 布尔
+  it('false 非空', () => expect(notEmpty(false)).toBe(true));
+  it('true 非空', () => expect(notEmpty(true)).toBe(true));
+
+  // 函数
+  it('函数非空', () => expect(notEmpty(() => {})).toBe(true));
+
+  // Symbol
+  it('空 Symbol 为空', () => expect(notEmpty(Symbol())).toBe(false));
+  it('有描述的 Symbol 非空', () => expect(notEmpty(Symbol('desc'))).toBe(true));
+
+  // 数组
+  it('空数组为空', () => expect(notEmpty([])).toBe(false));
+  it('非空数组非空', () => expect(notEmpty([1])).toBe(true));
+
+  // 对象
+  it('空对象为空', () => expect(notEmpty({})).toBe(false));
+  it('非空对象非空', () => expect(notEmpty({ a: 1 })).toBe(true));
+
+  // Map / Set
+  it('空 Map 为空', () => expect(notEmpty(new Map())).toBe(false));
+  it('非空 Map 非空', () => expect(notEmpty(new Map([['a', 1]]))).toBe(true));
+  it('空 Set 为空', () => expect(notEmpty(new Set())).toBe(false));
+  it('非空 Set 非空', () => expect(notEmpty(new Set([1]))).toBe(true));
+
+  // Date
+  it('有效 Date 非空', () => expect(notEmpty(new Date())).toBe(true));
+  it('Invalid Date 为空', () => expect(notEmpty(new Date('invalid'))).toBe(false));
+
+  // RegExp
+  it('空正则为空', () => expect(notEmpty(new RegExp(''))).toBe(false));
+  it('非空正则非空', () => expect(notEmpty(/abc/)).toBe(true));
+
+  // TypedArray
+  it('空 Uint8Array 为空', () => expect(notEmpty(new Uint8Array(0))).toBe(0));
+  it('非空 Float64Array 非空', () => expect(notEmpty(new Float64Array([1.5]))).toBe(1));
+});
+
+describe('isEmpty', () => {
+  it('是 notEmpty 的取反', () => {
+    expect(isEmpty(null)).toBe(true);
+    expect(isEmpty('hello')).toBe(false);
+    expect(isEmpty(0)).toBe(false);
+    expect(isEmpty([])).toBe(true);
+    expect(isEmpty({})).toBe(true);
+  });
+});