@pawover/kit 0.0.0-beta.5 → 0.0.0-beta.50

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "@pawover/kit",
-  "author": "pawover<pawover@outlook.com>",
-  "description": "pawover's kit",
+  "author": {
+    "name": "pawover",
+    "email": "pawover@outlook.com",
+    "url": "https://github.com/pawover"
+  },
+  "description": "一个基于 TypeScript 的开发工具包",
   "license": "MIT",
   "type": "module",
-  "version": "0.0.0-beta.5",
-  "packageManager": "pnpm@10.20.0",
+  "version": "0.0.0-beta.50",
+  "packageManager": "pnpm@10.28.2",
   "engines": {
     "node": ">=22.20.0"
   },
@@ -16,95 +20,72 @@
   "homepage": "https://github.com/pawover/pawover-kit#readme",
   "repository": {
     "type": "git",
-    "url": "https://github.com/pawover/pawover-kit.git"
+    "url": "git+https://github.com/pawover/pawover-kit.git"
   },
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./packages/utils/dist/index.js",
+  "module": "./packages/utils/dist/index.js",
+  "types": "./packages/utils/dist/index.d.ts",
   "files": [
-    "dist",
-    "metadata.json"
+    "packages/utils/dist",
+    "packages/hooks/dist",
+    "packages/zod/dist"
   ],
   "exports": {
-    ".": "./dist/index.js",
-    "./enums": "./dist/enums.js",
-    "./vite": "./dist/vite.js",
-    "./zod": "./dist/zod.js",
-    "./hooks-alova": "./dist/hooks-alova.js",
-    "./hooks-react": "./dist/hooks-react.js",
-    "./patches-fetchEventSource": "./dist/patches-fetchEventSource.js",
-    "./metadata.json": "./metadata.json",
-    "./package.json": "./package.json"
+    ".": "./packages/utils/dist/index.js",
+    "./math": "./packages/utils/dist/math.js",
+    "./vite": "./packages/utils/dist/vite.js",
+    "./metadata.json": "./packages/utils/dist/metadata.json",
+    "./utils": "./packages/utils/dist/index.js",
+    "./utils/math": "./packages/utils/dist/math.js",
+    "./utils/vite": "./packages/utils/dist/vite.js",
+    "./utils/*": "./packages/utils/dist/*",
+    "./hooks/alova": "./packages/hooks/dist/alova.js",
+    "./hooks/react": "./packages/hooks/dist/react.js",
+    "./hooks/*": "./packages/hooks/dist/*",
+    "./zod": "./packages/zod/dist/index.js",
+    "./zod/*": "./packages/zod/dist/*"
   },
   "scripts": {
-    "build": "tsdown && pnpm build:metadata",
-    "build:metadata": "node scripts/metadata.ts",
-    "public": "pnpm build && npm publish --access public",
+    "test": "vitest",
+    "build": "turbo build-all",
+    "build:force": "turbo build-all --force",
+    "public": "turbo build-all && npm publish --access public --tag bate",
     "check": "pnpm check:types & pnpm check:eslint & pnpm check:format",
     "check:types": "tsc --noEmit",
     "check:eslint": "eslint --fix \"**/*.{js,cjs,mjs,ts,cts,mts,jsx,tsx,vue}\" --cache-location=.cache/eslint.cache.json --cache",
-    "check:format": "prettier --write \"**/*.{html,json}\" !.vscode/settings.json --cache-location=.cache/prettier.cache.json --cache",
+    "check:format": "prettier --write \"**/*.{html,json}\" --cache-location=.cache/prettier.cache.json --cache",
     "check:pack": "attw --pack .",
-    "clean": "pnpm clean:cache & pnpm clean:lib & pnpm clean:output",
-    "clean:cache": "rimraf -g **/.cache",
-    "clean:lib": "rimraf -g **/node_modules",
-    "clean:output": "rimraf dist",
+    "clean": "turbo clean & rimraf .cache node_modules dist",
+    "clean:turbo": "rimraf -g **/.turbo",
+    "clean:cache": "rimraf .cache",
+    "clean:lib": "turbo clean:lib",
+    "clean:output": "turbo clean:output",
     "lib:up": "taze -I -r --exclude pnpm"
   },
-  "dependencies": {
-    "alova": "^3.4.1",
-    "mathjs": "^15.1.0",
-    "react": "^19.2.3",
-    "vite": "^7.3.0",
-    "vue": "^3.5.26",
-    "zod": "^4.2.1"
-  },
   "devDependencies": {
-    "@pawover/eslint-rules": "^0.0.0-alpha.24",
-    "@pawover/types": "^0.0.0-alpha.8",
-    "@stylistic/eslint-plugin": "^5.6.1",
+    "@eslint-react/eslint-plugin": "^4.2.3",
+    "@pawover/eslint-rules": "^0.0.2",
+    "@playwright/test": "^1.59.1",
+    "@stylistic/eslint-plugin": "^5.10.0",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^25.0.3",
-    "@types/react": "^19.2.7",
-    "eslint": "^9.39.2",
-    "eslint-plugin-antfu": "^3.1.1",
-    "fs-extra": "^11.3.3",
-    "prettier": "^3.7.4",
-    "radashi": "^12.7.1",
-    "rimraf": "^6.1.2",
-    "taze": "^19.9.2",
-    "tsdown": "^0.17.4",
-    "type-fest": "^5.3.1",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.50.1",
-    "vue-tsc": "^3.2.1"
-  },
-  "peerDependencies": {
-    "alova": ">=3.3.0",
-    "mathjs": ">=15.0.0",
-    "react": ">=19.2.0",
-    "vite": ">=4.0",
-    "vue": ">=3.5.0",
-    "zod": ">=4.1.0"
-  },
-  "peerDependenciesMeta": {
-    "alova": {
-      "optional": true
-    },
-    "mathjs": {
-      "optional": true
-    },
-    "react": {
-      "optional": true
-    },
-    "vite": {
-      "optional": true
-    },
-    "vue": {
-      "optional": true
-    },
-    "zod": {
-      "optional": true
-    }
+    "@types/node": "^25.6.0",
+    "@vitejs/plugin-react": "^5.2.0",
+    "@vitest/browser-playwright": "^4.1.5",
+    "eslint": "^10.2.1",
+    "eslint-plugin-antfu": "^3.2.2",
+    "eslint-plugin-import-lite": "^0.6.0",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-simple-import-sort": "^13.0.0",
+    "fs-extra": "^11.3.4",
+    "jsdom": "^29.0.2",
+    "prettier": "^3.8.3",
+    "rimraf": "^6.1.3",
+    "taze": "^19.11.0",
+    "tsdown": "^0.21.10",
+    "turbo": "^2.9.6",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.0",
+    "vitest": "^4.1.5",
+    "vitest-browser-react": "^2.2.0"
   }
 }

package/packages/hooks/dist/alova.d.ts

@@ -0,0 +1,31 @@
+import * as _$alova_client0 from "alova/client";
+import { AlovaFrontMiddlewareContext, AlovaMethodHandler, CompleteHandler, ErrorHandler, PaginationHookConfig, RequestHookConfig, SuccessHandler, WatcherHookConfig } from "alova/client";
+import { AlovaGenerics, Method } from "alova";
+
+//#region src/alova/useAlovaPagination.d.ts
+interface HookOptions$2<AG extends AlovaGenerics, L extends any[], Args extends any[]> extends PaginationHookConfig<AG, L> {
+  onBeforeRequest?: ((context: AlovaFrontMiddlewareContext<AG, any[]>) => void) | undefined;
+  onSuccess?: SuccessHandler<AG, Args> | undefined;
+  onError?: ErrorHandler<AG, Args> | undefined;
+  onComplete?: CompleteHandler<AG, Args> | undefined;
+}
+declare function useAlovaPagination<AG extends AlovaGenerics, L extends any[], Args extends any[]>(methodHandler: (page: number, pageSize: number, ...args: Args) => Method<AG>, hookOptions?: HookOptions$2<AG, L, Args> | undefined): _$alova_client0.UsePaginationExposure<AG, L, Args>;
+//#endregion
+//#region src/alova/useAlovaRequest.d.ts
+interface HookOptions$1<AG extends AlovaGenerics, Args extends any[]> extends RequestHookConfig<AG, Args> {
+  onBeforeRequest?: ((context: AlovaFrontMiddlewareContext<AG, Args>) => void) | undefined;
+  onSuccess?: SuccessHandler<AG, Args> | undefined;
+  onError?: ErrorHandler<AG, Args> | undefined;
+  onComplete?: CompleteHandler<AG, Args> | undefined;
+}
+declare function useAlovaRequest<AG extends AlovaGenerics, Args extends any[] = any[]>(methodHandler: Method<AG> | AlovaMethodHandler<AG, Args>, hookOptions?: HookOptions$1<AG, Args> | undefined): _$alova_client0.UseHookExposure<AG, Args, unknown>;
+//#endregion
+//#region src/alova/useAlovaWatcher.d.ts
+interface HookOptions<AG extends AlovaGenerics, Args extends any[]> extends WatcherHookConfig<AG, Args> {
+  onSuccess?: SuccessHandler<AG, Args> | undefined;
+  onError?: ErrorHandler<AG, Args> | undefined;
+  onComplete?: CompleteHandler<AG, Args> | undefined;
+}
+declare function useAlovaWatcher<AG extends AlovaGenerics, Args extends any[] = any[]>(methodHandler: Method<AG> | AlovaMethodHandler<AG, Args>, watchingStates: AG["StatesExport"]["Watched"][], hookOptions?: HookOptions<AG, Args>): _$alova_client0.UseHookExposure<AG, Args, unknown>;
+//#endregion
+export { useAlovaPagination, useAlovaRequest, useAlovaWatcher };

package/packages/hooks/dist/alova.js

@@ -0,0 +1,64 @@
+import { usePagination, useRequest, useWatcher } from "alova/client";
+//#region src/alova/useAlovaPagination.ts
+function useAlovaPagination(methodHandler, hookOptions) {
+	const options = {
+		...hookOptions,
+		immediate: hookOptions?.immediate ?? true
+	};
+	let isBeforeExecuted = false;
+	let isMiddlewareExecuted = false;
+	if (options.onBeforeRequest) {
+		const middleware = options.middleware;
+		options.middleware = async (context, next) => {
+			!isBeforeExecuted && options.onBeforeRequest?.(context);
+			isBeforeExecuted = true;
+			if (middleware && !isMiddlewareExecuted) {
+				isMiddlewareExecuted = true;
+				await middleware?.(context, next);
+			} else await next();
+		};
+	}
+	const exposure = usePagination(methodHandler, options);
+	if (options.onSuccess) exposure.onSuccess(options.onSuccess);
+	if (options.onError) exposure.onError(options.onError);
+	if (options.onComplete) exposure.onComplete(options.onComplete);
+	return exposure;
+}
+//#endregion
+//#region src/alova/useAlovaRequest.ts
+function useAlovaRequest(methodHandler, hookOptions) {
+	const options = {
+		...hookOptions,
+		immediate: hookOptions?.immediate ?? true
+	};
+	let isBeforeExecuted = false;
+	let isMiddlewareExecuted = false;
+	if (options.onBeforeRequest) {
+		const middleware = options.middleware;
+		options.middleware = async (context, next) => {
+			!isBeforeExecuted && options.onBeforeRequest?.(context);
+			isBeforeExecuted = true;
+			if (middleware && !isMiddlewareExecuted) {
+				isMiddlewareExecuted = true;
+				await middleware?.(context, next);
+			} else await next();
+		};
+	}
+	const exposure = useRequest(methodHandler, options);
+	if (options.onSuccess) exposure.onSuccess(options.onSuccess);
+	if (options.onError) exposure.onError(options.onError);
+	if (options.onComplete) exposure.onComplete(options.onComplete);
+	return exposure;
+}
+//#endregion
+//#region src/alova/useAlovaWatcher.ts
+function useAlovaWatcher(methodHandler, watchingStates, hookOptions = {}) {
+	const options = hookOptions || {};
+	const exposure = useWatcher(methodHandler, watchingStates, options);
+	if (options.onSuccess) exposure.onSuccess(options.onSuccess);
+	if (options.onError) exposure.onError(options.onError);
+	if (options.onComplete) exposure.onComplete(options.onComplete);
+	return exposure;
+}
+//#endregion
+export { useAlovaPagination, useAlovaRequest, useAlovaWatcher };

package/packages/hooks/dist/index.d.ts

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

package/packages/hooks/dist/metadata.json

@@ -0,0 +1,16 @@
+{
+  "alova": [
+    "useAlovaPagination",
+    "useAlovaRequest",
+    "useAlovaWatcher"
+  ],
+  "react": [
+    "BREAK_POINT_TOKEN",
+    "useCreation",
+    "useLatest",
+    "useMount",
+    "useResponsive",
+    "useTitle",
+    "useUnmount"
+  ]
+}

package/packages/hooks/dist/react.d.ts

@@ -0,0 +1,164 @@
+import { DependencyList, EffectCallback, RefObject } from "react";
+
+//#region src/react/useCreation.d.ts
+/**
+ * 确保实例不会被重复创建
+ *
+ * @param factory
+ * @param deps
+ */
+declare function useCreation<T>(factory: () => T, deps: DependencyList): T;
+//#endregion
+//#region src/react/useLatest.d.ts
+/**
+ * 返回当前最新值的 Hook
+ *
+ * @param value
+ */
+declare function useLatest<T>(value: T): RefObject<T>;
+//#endregion
+//#region ../../node_modules/.pnpm/@pawover+types@0.0.1_@types+react@19.2.14_typescript@6.0.3/node_modules/@pawover/types/dist/index.d.ts
+/** 描述函数类型 */
+type AnyFunction<P extends any[] = any[], R = any> = (...arg: P) => R;
+/** 描述异步函数类型 */
+type AnyAsyncFunction<P extends any[] = any[], R = any> = (...args: P) => Promise<R>;
+/** 描述生成器函数类型 */
+//#endregion
+//#region src/react/useMount.d.ts
+/**
+ * 在组件初始化时执行的 Hook
+ * - 即使在严格模式（React StrictMode）也只执行一次
+ * - 自动使用最新版 effect 函数
+ *
+ * @param effect 副作用函数（必须为同步函数；若为异步函数，清理逻辑需自行处理）
+ * @example
+ * useMount(() => {
+ *   console.log('组件挂载');
+ *   return () => console.log('组件卸载');
+ * });
+ *
+ * useMount(async () => {
+ *   const data = await fetchData();
+ *   // 清理逻辑需通过 ref/AbortController 自行管理
+ *   // ❌ 不要 return cleanupFn（async 函数返回 Promise，无法作为清理函数）
+ * });
+ */
+declare function useMount(effect: EffectCallback | AnyAsyncFunction): void;
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/tuple-to-union.d.ts
+/**
+Convert a tuple/array into a union type of its elements.
+
+This can be useful when you have a fixed set of allowed values and want a type defining only the allowed values, but do not want to repeat yourself.
+
+@example
+```
+import type {TupleToUnion} from 'type-fest';
+
+const destinations = ['a', 'b', 'c'] as const;
+
+type Destination = TupleToUnion<typeof destinations>;
+//=> 'a' | 'b' | 'c'
+
+function verifyDestination(destination: unknown): destination is Destination {
+	return destinations.includes(destination as any);
+}
+
+type RequestBody = {
+	deliverTo: Destination;
+};
+
+function verifyRequestBody(body: unknown): body is RequestBody {
+	const {deliverTo} = (body as any);
+	return typeof body === 'object' && body !== null && verifyDestination(deliverTo);
+}
+```
+
+Alternatively, you may use `typeof destinations[number]`. If `destinations` is a tuple, there is no difference. However if `destinations` is a string, the resulting type will the union of the characters in the string. Other types of `destinations` may result in a compile error. In comparison, TupleToUnion will return `never` if a tuple is not provided.
+
+@example
+```
+const destinations = ['a', 'b', 'c'] as const;
+
+type Destination = typeof destinations[number];
+//=> 'a' | 'b' | 'c'
+
+const erroringType = new Set(['a', 'b', 'c']);
+
+// @ts-expect-error
+type ErroringType = typeof erroringType[number];
+// Error: Type 'Set<string>' has no matching index signature for type 'number'. ts(2537)
+
+const numberBool: {[n: number]: boolean} = {1: true};
+
+type NumberBool = typeof numberBool[number];
+//=> boolean
+```
+
+@category Array
+*/
+type TupleToUnion<ArrayType> = ArrayType extends readonly unknown[] ? ArrayType[number] : never;
+//#endregion
+//#region src/react/useResponsive.d.ts
+type Breakpoint = TupleToUnion<typeof BREAK_POINTS>;
+type ResponsiveValues = Record<Breakpoint, boolean>;
+type BreakPointTokens = Record<keyof typeof BREAK_POINT_TOKEN, number>;
+/** 屏幕响应断点 token 配置 */
+declare const BREAK_POINT_TOKEN: {
+  readonly XS: 480;
+  readonly XSMax: 575;
+  readonly XSMin: 480;
+  readonly SM: 576;
+  readonly SMMax: 767;
+  readonly SMMin: 576;
+  readonly MD: 768;
+  readonly MDMax: 991;
+  readonly MDMin: 768;
+  readonly LG: 992;
+  readonly LGMax: 1199;
+  readonly LGMin: 992;
+  readonly XL: 1200;
+  readonly XLMax: 1599;
+  readonly XLMin: 1200;
+  readonly XXL: 1600;
+  readonly XXLMax: 1919;
+  readonly XXLMin: 1600;
+  readonly XXXL: 1920;
+  readonly XXXLMin: 1920;
+};
+declare const BREAK_POINTS: readonly ["xxxl", "xxl", "xl", "lg", "md", "sm", "xs"];
+interface ResponsiveHookOptions {
+  /** 屏幕响应断点 token 配置 */
+  breakPointTokens?: BreakPointTokens;
+}
+declare function useResponsive(options?: ResponsiveHookOptions | undefined): {
+  responsive: ResponsiveValues;
+  current: "xxxl" | "xxl" | "xl" | "lg" | "md" | "sm" | "xs";
+  breakPointTokens: BreakPointTokens;
+};
+//#endregion
+//#region src/react/useTitle.d.ts
+interface TitleHookOptions {
+  /** 件卸载时是否恢复原始标题 */
+  isRestoreOnUnmount?: boolean;
+}
+/**
+ * 设置页面标题
+ * - 轻量级，适用于无路由库时设置页面标题
+ * - 多个 `useTitle` 实例会互相干扰，需在顶层组件使用
+ * - 无法处理 `document.title` 固有的竞态问题
+ *
+ * @param title 页面标题
+ * @param options 配置选项
+ */
+declare function useTitle(title: string, options?: TitleHookOptions | undefined): void;
+//#endregion
+//#region src/react/useUnmount.d.ts
+/**
+ * 在组件卸载时执行的 Hook
+ *
+ * @param effect 副作用函数
+ */
+declare function useUnmount(effect: AnyFunction): void;
+//#endregion
+export { BREAK_POINT_TOKEN, BreakPointTokens, ResponsiveHookOptions, useCreation, useLatest, useMount, useResponsive, useTitle, useUnmount };