@pawover/kit 0.4.2 → 0.6.0

package/packages/eslint-rules/dist/preset-CQJST7pW.js

@@ -0,0 +1,102 @@
+//#region src/preset.ts
+/**
+* 预设配置
+*
+* 供各规则组共享的基础预设：缩进大小与 TypeScript 类成员排序规则。
+*
+* @example
+* ```ts
+* import preset from "@pawover/kit-eslint-rules/src/preset";
+*
+* console.log(preset.indent); // 2
+* ```
+*/
+var preset_default = {
+	/** 缩进大小 */
+	indent: 2,
+	/** TypeScript 类成员排序 */
+	tsMemberOrder: [
+		"signature",
+		"call-signature",
+		"static-initialization",
+		"#private-static-field",
+		"private-static-field",
+		"protected-static-field",
+		"public-static-field",
+		"static-field",
+		"#private-instance-field",
+		"private-instance-field",
+		"protected-instance-field",
+		"public-instance-field",
+		"instance-field",
+		"#private-field",
+		"private-field",
+		"protected-field",
+		"public-field",
+		"field",
+		"private-constructor",
+		"protected-constructor",
+		"public-constructor",
+		"#private-static-get",
+		"#private-static-set",
+		"private-static-get",
+		"private-static-set",
+		"protected-static-get",
+		"protected-static-set",
+		"public-static-get",
+		"public-static-set",
+		"static-get",
+		"static-set",
+		"protected-abstract-get",
+		"protected-abstract-set",
+		"public-abstract-get",
+		"public-abstract-set",
+		"abstract-get",
+		"abstract-set",
+		"#private-instance-get",
+		"#private-instance-set",
+		"private-instance-get",
+		"private-instance-set",
+		"protected-instance-get",
+		"protected-instance-set",
+		"public-instance-get",
+		"public-instance-set",
+		"instance-get",
+		"instance-set",
+		"private-decorated-get",
+		"private-decorated-set",
+		"protected-decorated-get",
+		"protected-decorated-set",
+		"public-decorated-get",
+		"public-decorated-set",
+		"decorated-get",
+		"decorated-set",
+		"#private-get",
+		"#private-set",
+		"private-get",
+		"private-set",
+		"protected-get",
+		"protected-set",
+		"public-get",
+		"public-set",
+		"get",
+		"set",
+		"#private-static-method",
+		"private-static-method",
+		"protected-static-method",
+		"public-static-method",
+		"static-method",
+		"#private-instance-method",
+		"private-instance-method",
+		"protected-instance-method",
+		"public-instance-method",
+		"instance-method",
+		"private-method",
+		"protected-method",
+		"public-method",
+		"#private-method",
+		"method"
+	]
+};
+//#endregion
+export { preset_default as t };

package/packages/hooks/dist/alova.cjs

@@ -0,0 +1,53 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let alova_client = require("alova/client");
+//#region src/alova/createBeforeRequestMiddleware.ts
+function createBeforeRequestMiddleware(middleware, onBeforeRequest) {
+	return async (context, next) => {
+		onBeforeRequest?.(context);
+		if (middleware) return middleware(context, next);
+		return next();
+	};
+}
+//#endregion
+//#region src/alova/useAlovaPagination.ts
+function useAlovaPagination(methodHandler, hookOptions) {
+	const options = {
+		...hookOptions,
+		immediate: hookOptions?.immediate ?? true
+	};
+	if (options.onBeforeRequest) options.middleware = createBeforeRequestMiddleware(options.middleware, options.onBeforeRequest);
+	const exposure = (0, alova_client.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
+	};
+	if (options.onBeforeRequest) options.middleware = createBeforeRequestMiddleware(options.middleware, options.onBeforeRequest);
+	const exposure = (0, alova_client.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 };
+	if (options.onBeforeRequest) options.middleware = createBeforeRequestMiddleware(options.middleware, options.onBeforeRequest);
+	const exposure = (0, alova_client.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
+exports.useAlovaPagination = useAlovaPagination;
+exports.useAlovaRequest = useAlovaRequest;
+exports.useAlovaWatcher = useAlovaWatcher;

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

@@ -0,0 +1 @@
+export type * from './alova.d.ts'

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

@@ -0,0 +1 @@
+export type * from './index.d.ts'

package/packages/hooks/dist/react.cjs

@@ -0,0 +1,169 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let react = require("react");
+let _pawover_kit_utils = require("@pawover/kit-utils");
+let es_toolkit = require("es-toolkit");
+//#region src/react/useLatest.ts
+/**
+* 返回当前最新值的 Hook
+*
+* @param value
+*/
+function useLatest(value) {
+	const ref = (0, react.useRef)(value);
+	ref.current = value;
+	return ref;
+}
+//#endregion
+//#region src/react/useMount.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，无法作为清理函数）
+* });
+*/
+function useMount(effect) {
+	const isMountedRef = (0, react.useRef)(false);
+	const effectRef = useLatest(effect);
+	(0, react.useEffect)(() => {
+		if (!_pawover_kit_utils.TypeUtil.isFunction(effectRef.current)) {
+			console.error(`hook [useMount] Expected parameter to be a function, but got ${typeof effectRef.current}. This effect will not execute.`);
+			return;
+		}
+		if (isMountedRef.current) return;
+		isMountedRef.current = true;
+		const cleanup = effectRef.current?.();
+		return _pawover_kit_utils.TypeUtil.isFunction(cleanup) && !_pawover_kit_utils.TypeUtil.isPromise(cleanup) ? cleanup : void 0;
+	}, [effectRef]);
+}
+//#endregion
+//#region src/react/useResponsive.ts
+/** 屏幕响应断点 token 配置 */
+const BREAK_POINT_TOKEN = {
+	XS: 480,
+	XSMax: 575,
+	XSMin: 480,
+	SM: 576,
+	SMMax: 767,
+	SMMin: 576,
+	MD: 768,
+	MDMax: 991,
+	MDMin: 768,
+	LG: 992,
+	LGMax: 1199,
+	LGMin: 992,
+	XL: 1200,
+	XLMax: 1599,
+	XLMin: 1200,
+	XXL: 1600,
+	XXLMax: 1919,
+	XXLMin: 1600,
+	XXXL: 1920,
+	XXXLMin: 1920
+};
+const SUBSCRIBER_SET = /* @__PURE__ */ new Set();
+const BREAK_POINTS = [
+	"xxxl",
+	"xxl",
+	"xl",
+	"lg",
+	"md",
+	"sm",
+	"xs"
+];
+const DEFAULT_VALUES = Object.freeze(_pawover_kit_utils.ArrayUtil.zipToObject(BREAK_POINTS, false));
+let responsiveValues = { ...DEFAULT_VALUES };
+let responsiveTokens = (0, es_toolkit.clone)(BREAK_POINT_TOKEN);
+function useResponsive(options) {
+	const { breakPointTokens = {} } = options || {};
+	const tokens = (0, react.useMemo)(() => Object.assign(BREAK_POINT_TOKEN, breakPointTokens), [breakPointTokens]);
+	const [responsive, setResponsive] = (0, react.useState)(() => calculateResponsive(tokens));
+	const current = _pawover_kit_utils.ObjectUtil.keys(DEFAULT_VALUES).find((key) => responsive[key] === true) || "xs";
+	(0, react.useLayoutEffect)(() => {
+		responsiveTokens = tokens;
+		window.addEventListener("resize", resizeListener);
+		const subscriber = () => {
+			setResponsive(responsiveValues);
+		};
+		SUBSCRIBER_SET.add(subscriber);
+		return () => {
+			SUBSCRIBER_SET.delete(subscriber);
+			if (!SUBSCRIBER_SET.size) window.removeEventListener("resize", resizeListener);
+		};
+	}, [tokens]);
+	return {
+		responsive,
+		current,
+		breakPointTokens: tokens
+	};
+}
+function resizeListener() {
+	const newValues = calculateResponsive(responsiveTokens);
+	if (!(0, es_toolkit.isEqual)(responsiveValues, newValues)) {
+		responsiveValues = newValues;
+		for (const subscriber of SUBSCRIBER_SET) subscriber();
+	}
+}
+function calculateResponsive(tokens) {
+	const config = _pawover_kit_utils.ArrayUtil.zipToObject(BREAK_POINTS, BREAK_POINTS.map((t) => tokens[_pawover_kit_utils.StringUtil.toUpperCase(t)]));
+	return _pawover_kit_utils.ObjectUtil.entriesMap(DEFAULT_VALUES, (key) => [key, window.innerWidth >= config[key]]);
+}
+//#endregion
+//#region src/react/useUnmount.ts
+/**
+* 在组件卸载时执行的 Hook
+*
+* @param effect 副作用函数
+*/
+function useUnmount(effect) {
+	const effectRef = useLatest(effect);
+	(0, react.useEffect)(() => () => {
+		if (!_pawover_kit_utils.TypeUtil.isFunction(effectRef.current)) {
+			console.error(`hook [useUnmount] Expected parameter to be a function, but got ${typeof effectRef.current}. This effect will not execute.`);
+			return;
+		}
+		effectRef.current?.();
+	}, [effectRef]);
+}
+//#endregion
+//#region src/react/useTitle.ts
+/**
+* 设置页面标题
+* - 轻量级，适用于无路由库时设置页面标题
+* - 多个 `useTitle` 实例会互相干扰，需在顶层组件使用
+* - 无法处理 `document.title` 固有的竞态问题
+*
+* @param title 页面标题
+* @param options 配置选项
+*/
+function useTitle(title, options) {
+	const titleRef = (0, react.useRef)(_pawover_kit_utils.EnvUtil.isBrowser() ? document.title : "");
+	(0, react.useEffect)(() => {
+		if (!_pawover_kit_utils.TypeUtil.isString(title)) {
+			console.error(`hook [useTitle] Expected parameter to be a string, but got ${typeof title}. This effect will not execute.`);
+			return;
+		}
+		if (_pawover_kit_utils.EnvUtil.isBrowser()) document.title = title;
+	}, [title]);
+	useUnmount(() => {
+		if (_pawover_kit_utils.EnvUtil.isBrowser() && options?.isRestoreOnUnmount) document.title = titleRef.current;
+	});
+}
+//#endregion
+exports.BREAK_POINT_TOKEN = BREAK_POINT_TOKEN;
+exports.useLatest = useLatest;
+exports.useMount = useMount;
+exports.useResponsive = useResponsive;
+exports.useTitle = useTitle;
+exports.useUnmount = useUnmount;

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

@@ -0,0 +1 @@
+export type * from './react.d.ts'

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

@@ -1,4 +1,6 @@
 import { EffectCallback, RefObject } from "react";
+import { AnyAsyncFunction, AnyFunction } from "@pawover/kit-types";
+import { TupleToUnion } from "type-fest";
 //#region src/react/useLatest.d.ts
 /**
  * 返回当前最新值的 Hook
@@ -7,12 +9,6 @@ import { EffectCallback, RefObject } from "react";
  */
 declare function useLatest<T>(value: T): RefObject<T>;
 //#endregion
-//#region ../../node_modules/.pnpm/@pawover+types@0.0.4_@types+react@19.2.15_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
@@ -34,60 +30,6 @@ type AnyAsyncFunction<P extends any[] = any[], R = any> = (...args: P) => Promis
  */
 declare function useMount(effect: EffectCallback | AnyAsyncFunction): void;
 //#endregion
-//#region ../../node_modules/.pnpm/type-fest@5.8.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>;