@pawover/kit 0.0.0-beta.41 → 0.0.0-beta.43

package/dist/hooks-react.js

@@ -1,7 +1,6 @@
-import { Ft as isEqual, H as isBrowser, Vt as isFunction, W as arrayZipToObject, _t as isPromiseLike, mt as isString, w as objectAssign, x as objectKeys } from "./utils-_dtCs-qa.js";
-import { i as BREAK_POINT_TOKEN_ENUM } from "./enums-BL6w5-mS.js";
-import { useEffect, useMemo, useRef, useState } from "react";
-
+import { D as stringToUpperCase, Mt as isEqual, Rt as isFunction, V as arrayZipToObject, ct as isString, d as objectKeys, h as objectMapEntries, m as objectAssign, pt as isPromise, z as isBrowser } from "./utils-DvWLCdYR.js";
+import { BREAK_POINT_TOKEN_ENUM } from "./enums.js";
+import { useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
 //#region src/hooks/react/useCreation.ts
 /**
 * useCreation
@@ -23,7 +22,6 @@ function useCreation(factory, deps) {
 	}
 	return current.result;
 }
-
 //#endregion
 //#region src/hooks/react/useLatest.ts
 /**
@@ -37,31 +35,44 @@ function useLatest(value) {
 	ref.current = value;
 	return ref;
 }
-
 //#endregion
 //#region src/hooks/react/useMount.ts
 /**
 * 在组件初始化时执行的 Hook
-* - 即使在严格模式下也只执行一次
+* - 即使在严格模式（React StrictMode）也只执行一次
+* - 自动使用最新版 effect 函数
 *
-* @param 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 = useRef(false);
 	const effectRef = useLatest(effect);
 	useEffect(() => {
-		if (!isFunction(effectRef.current)) console.error(`useMount expected parameter is a function, but got ${typeof effectRef.current}`);
+		if (!isFunction(effectRef.current)) {
+			console.error(`[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 result = effectRef.current?.();
-		if (isPromiseLike(result)) return;
-		return result;
+		const cleanup = effectRef.current?.();
+		return isFunction(cleanup) && !isPromise(cleanup) ? cleanup : void 0;
 	}, [effectRef]);
 }
-
 //#endregion
 //#region src/hooks/react/useResponsive.ts
-const tuple = [
+const SUBSCRIBER_SET = /* @__PURE__ */ new Set();
+const BREAK_POINTS = [
 	"xxxl",
 	"xxl",
 	"xl",
@@ -70,41 +81,24 @@ const tuple = [
 	"sm",
 	"xs"
 ];
-const TUPLE = [
-	"XXXL",
-	"XXL",
-	"XL",
-	"LG",
-	"MD",
-	"SM",
-	"XS"
-];
-const defaultValues = arrayZipToObject(tuple, tuple.map(() => false));
+const DEFAULT_VALUES = Object.freeze(arrayZipToObject(BREAK_POINTS, false));
+let responsiveValues = { ...DEFAULT_VALUES };
+let responsiveTokens = BREAK_POINT_TOKEN_ENUM;
 function useResponsive(options) {
 	const { breakPointTokens = {} } = options || {};
-	const responsiveValuesRef = useRef({ ...defaultValues });
-	const [responsive, setResponsive] = useState({ ...defaultValues });
 	const tokens = useMemo(() => objectAssign(BREAK_POINT_TOKEN_ENUM, breakPointTokens), [breakPointTokens]);
-	const current = objectKeys(responsive).find((key) => responsive[key] === true) || "xs";
-	useEffect(() => {
-		function calculate() {
-			const newValues = { ...defaultValues };
-			const responsiveConfig = arrayZipToObject(tuple, TUPLE.map((t) => tokens[t]));
-			let shouldUpdate = false;
-			for (const key of tuple) {
-				newValues[key] = window.innerWidth >= responsiveConfig[key];
-				if (newValues[key] !== responsiveValuesRef.current[key]) shouldUpdate = true;
-			}
-			if (shouldUpdate) responsiveValuesRef.current = newValues;
-		}
-		function resizeListener() {
-			const oldInfo = responsiveValuesRef.current;
-			calculate();
-			if (oldInfo !== responsiveValuesRef.current) setResponsive(responsiveValuesRef.current);
-		}
+	const [responsive, setResponsive] = useState(() => calculateResponsive(tokens));
+	const current = objectKeys(DEFAULT_VALUES).find((key) => responsive[key] === true) || "xs";
+	useLayoutEffect(() => {
+		responsiveTokens = tokens;
 		window.addEventListener("resize", resizeListener);
+		const subscriber = () => {
+			setResponsive(responsiveValues);
+		};
+		SUBSCRIBER_SET.add(subscriber);
 		return () => {
-			window.removeEventListener("resize", resizeListener);
+			SUBSCRIBER_SET.delete(subscriber);
+			if (!SUBSCRIBER_SET.size) window.removeEventListener("resize", resizeListener);
 		};
 	}, [tokens]);
 	return {
@@ -113,7 +107,17 @@ function useResponsive(options) {
 		breakPointTokens: tokens
 	};
 }
-
+function resizeListener() {
+	const newValues = calculateResponsive(responsiveTokens);
+	if (!isEqual(responsiveValues, newValues)) {
+		responsiveValues = newValues;
+		for (const subscriber of SUBSCRIBER_SET) subscriber();
+	}
+}
+function calculateResponsive(tokens) {
+	const config = arrayZipToObject(BREAK_POINTS, BREAK_POINTS.map((t) => tokens[stringToUpperCase(t)]));
+	return objectMapEntries(DEFAULT_VALUES, (key) => [key, window.innerWidth >= config[key]]);
+}
 //#endregion
 //#region src/hooks/react/useUnmount.ts
 /**
@@ -126,13 +130,12 @@ function useUnmount(effect) {
 	const effectRef = useLatest(effect);
 	useEffect(() => () => {
 		if (!isFunction(effectRef.current)) {
-			console.error(`useUnmount expected parameter is a function, but got ${typeof effectRef.current}`);
+			console.error(`[useUnmount] Expected parameter to be a function, but got ${typeof effectRef.current}. This effect will not execute.`);
 			return;
 		}
 		effectRef.current?.();
 	}, [effectRef]);
 }
-
 //#endregion
 //#region src/hooks/react/useTitle.ts
 /**
@@ -148,7 +151,7 @@ function useTitle(title, options) {
 	const titleRef = useRef(isBrowser() ? document.title : "");
 	useEffect(() => {
 		if (!isString(title)) {
-			console.error(`useTitle expected title is a string, but got ${typeof title}`);
+			console.error(`[useTitle] Expected parameter to be a string, but got ${typeof title}. This effect will not execute.`);
 			return;
 		}
 		if (isBrowser()) document.title = title;
@@ -157,7 +160,7 @@ function useTitle(title, options) {
 		if (isBrowser() && options?.isRestoreOnUnmount) document.title = titleRef.current;
 	});
 }
-
 //#endregion
 export { useCreation, useLatest, useMount, useResponsive, useTitle, useUnmount };
+
 //# sourceMappingURL=hooks-react.js.map

package/dist/hooks-react.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-react.js","names":["defaultValues: ResponsiveValues","tokens: BREAK_POINT_TOKEN_TYPE"],"sources":["../src/hooks/react/useCreation.ts","../src/hooks/react/useLatest.ts","../src/hooks/react/useMount.ts","../src/hooks/react/useResponsive.ts","../src/hooks/react/useUnmount.ts","../src/hooks/react/useTitle.ts"],"sourcesContent":["import { useRef, type DependencyList } from \"react\";\nimport { isEqual } from \"src/utils\";\n\ninterface RefObject<T> {\n  deps: DependencyList;\n  result: T;\n  isInitialized: boolean;\n}\n\n/**\n * useCreation\n * @reference https://ahooks.js.org/zh-CN/hooks/use-creation\n *\n * @param factory\n * @param deps\n */\nexport function useCreation<T> (factory: () => T, deps: DependencyList) {\n  const { current } = useRef<RefObject<T>>({ deps, result: undefined!, isInitialized: false });\n\n  if (current.isInitialized === false || !isEqual(current.deps, deps)) {\n    current.deps = deps;\n    current.result = factory();\n    current.isInitialized = true;\n  }\n\n  return current.result;\n}\n","import { useRef, type RefObject } from \"react\";\n\n/**\n * 返回当前最新值的 Hook\n * @reference https://ahooks.js.org/zh-CN/hooks/use-latest\n *\n * @param value\n */\nexport function useLatest<T> (value: T): RefObject<T> {\n  const ref = useRef(value);\n  // eslint-disable-next-line react-x/refs\n  ref.current = value;\n\n  return ref;\n}\n","import type { AnyAsyncFunction } from \"@pawover/types\";\nimport { useEffect, useRef, type EffectCallback } from \"react\";\nimport { isFunction, isPromiseLike } from \"src/utils\";\nimport { useLatest } from \"./useLatest\";\n\ntype MountCallback = EffectCallback | AnyAsyncFunction;\n\n/**\n * 在组件初始化时执行的 Hook\n * - 即使在严格模式下也只执行一次\n *\n * @param effect 副作用函数\n */\nexport function useMount (effect: MountCallback) {\n  const isMountedRef = useRef(false);\n  const effectRef = useLatest(effect);\n\n  useEffect(() => {\n    if (!isFunction(effectRef.current)) {\n      console.error(`useMount expected parameter is a function, but got ${typeof effectRef.current}`);\n    }\n    if (isMountedRef.current) {\n      return;\n    }\n    isMountedRef.current = true;\n    const result = effectRef.current?.();\n    // If fn returns a Promise, don't return it as cleanup function\n    if (isPromiseLike(result)) {\n      return;\n    }\n\n    return result;\n  }, [effectRef]);\n}\n","import { useEffect, useMemo, useRef, useState } from \"react\";\nimport { BREAK_POINT_TOKEN_ENUM, type BREAK_POINT_TOKEN_TYPE } from \"src/enums\";\nimport { arrayZipToObject, objectAssign, objectKeys } from \"src/utils\";\nimport type { TupleToUnion } from \"type-fest\";\n\ntype Breakpoint = TupleToUnion<typeof tuple>;\ntype ResponsiveValues = Record<Breakpoint, boolean>;\n\nconst tuple = [\"xxxl\", \"xxl\", \"xl\", \"lg\", \"md\", \"sm\", \"xs\"] as const;\nconst TUPLE = [\"XXXL\", \"XXL\", \"XL\", \"LG\", \"MD\", \"SM\", \"XS\"] as const;\nconst defaultValues: ResponsiveValues = arrayZipToObject(tuple, tuple.map(() => false));\n\nexport interface ResponsiveHookOptions {\n  /** 屏幕响应断点 token 配置 */\n  breakPointTokens?: BREAK_POINT_TOKEN_TYPE;\n}\nexport function useResponsive (options?: ResponsiveHookOptions) {\n  const { breakPointTokens = {} } = options || {};\n  const responsiveValuesRef = useRef({ ...defaultValues });\n  const [responsive, setResponsive] = useState<ResponsiveValues>({ ...defaultValues });\n  const tokens: BREAK_POINT_TOKEN_TYPE = useMemo(() => objectAssign(BREAK_POINT_TOKEN_ENUM, breakPointTokens), [breakPointTokens]);\n  const current = objectKeys(responsive).find((key) => responsive[key] === true) || \"xs\";\n\n  useEffect(() => {\n    function calculate () {\n      const newValues = { ...defaultValues };\n      const responsiveConfig = arrayZipToObject(tuple, TUPLE.map((t) => tokens[t]));\n      let shouldUpdate = false;\n\n      for (const key of tuple) {\n        newValues[key] = window.innerWidth >= responsiveConfig[key];\n        if (newValues[key] !== responsiveValuesRef.current[key]) {\n          shouldUpdate = true;\n        }\n      }\n      if (shouldUpdate) {\n        responsiveValuesRef.current = newValues;\n      }\n    }\n\n    function resizeListener () {\n      const oldInfo = responsiveValuesRef.current;\n      calculate();\n\n      if (oldInfo !== responsiveValuesRef.current) {\n        setResponsive(responsiveValuesRef.current);\n      }\n    }\n\n    window.addEventListener(\"resize\", resizeListener);\n\n    return () => {\n      window.removeEventListener(\"resize\", resizeListener);\n    };\n  }, [tokens]);\n\n  return { responsive, current, breakPointTokens: tokens };\n}\n","import type { AnyFunction } from \"@pawover/types\";\nimport { useEffect } from \"react\";\nimport { isFunction } from \"src/utils\";\nimport { useLatest } from \"./useLatest\";\n\n/**\n * 在组件卸载时执行的 Hook\n * @reference https://ahooks.js.org/zh-CN/hooks/use-unmount\n *\n * @param effect 副作用函数\n */\nexport function useUnmount (effect: AnyFunction) {\n  const effectRef = useLatest(effect);\n\n  useEffect(\n    () => () => {\n      if (!isFunction(effectRef.current)) {\n        console.error(`useUnmount expected parameter is a function, but got ${typeof effectRef.current}`);\n\n        return;\n      }\n      effectRef.current?.();\n    },\n    [effectRef],\n  );\n}\n","import { useEffect, useRef } from \"react\";\nimport { isBrowser, isString } from \"../../utils\";\nimport { useUnmount } from \"./useUnmount\";\n\ninterface TitleHookOptions {\n  /** 件卸载时是否恢复原始标题 */\n  isRestoreOnUnmount?: boolean;\n}\n\n/**\n * 设置页面标题\n * - 轻量级，适用于无路由库时设置页面标题\n * - 多个 `useTitle` 实例会互相干扰，需在顶层组件使用\n * - 无法处理 `document.title` 固有的竞态问题\n *\n * @param title 页面标题\n * @param options 配置选项\n */\nexport function useTitle (title: string, options?: TitleHookOptions | undefined) {\n  const titleRef = useRef(isBrowser() ? document.title : \"\");\n\n  useEffect(() => {\n    if (!isString(title)) {\n      console.error(`useTitle expected title is a string, but got ${typeof title}`);\n\n      return;\n    }\n    if (isBrowser()) {\n      document.title = title;\n    }\n  }, [title]);\n\n  useUnmount(() => {\n    if (isBrowser() && options?.isRestoreOnUnmount) {\n      document.title = titleRef.current;\n    }\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"hooks-react.js","names":[],"sources":["../src/hooks/react/useCreation.ts","../src/hooks/react/useLatest.ts","../src/hooks/react/useMount.ts","../src/hooks/react/useResponsive.ts","../src/hooks/react/useUnmount.ts","../src/hooks/react/useTitle.ts"],"sourcesContent":["import { useRef, type DependencyList } from \"react\";\nimport { isEqual } from \"../../utils\";\n\ninterface RefObject<T> {\n  deps: DependencyList;\n  result: T;\n  isInitialized: boolean;\n}\n\n/**\n * useCreation\n * @reference https://ahooks.js.org/zh-CN/hooks/use-creation\n *\n * @param factory\n * @param deps\n */\nexport function useCreation<T> (factory: () => T, deps: DependencyList) {\n  const { current } = useRef<RefObject<T>>({ deps, result: undefined!, isInitialized: false });\n\n  if (current.isInitialized === false || !isEqual(current.deps, deps)) {\n    current.deps = deps;\n    current.result = factory();\n    current.isInitialized = true;\n  }\n\n  return current.result;\n}\n","import { useRef, type RefObject } from \"react\";\n\n/**\n * 返回当前最新值的 Hook\n * @reference https://ahooks.js.org/zh-CN/hooks/use-latest\n *\n * @param value\n */\nexport function useLatest<T> (value: T): RefObject<T> {\n  const ref = useRef(value);\n  // eslint-disable-next-line react-x/refs\n  ref.current = value;\n\n  return ref;\n}\n","import { useEffect, useRef, type EffectCallback } from \"react\";\nimport { isFunction, isPromise } from \"../../utils\";\nimport { useLatest } from \"./useLatest\";\nimport type { AnyAsyncFunction } from \"@pawover/types\";\n\n/**\n * 在组件初始化时执行的 Hook\n * - 即使在严格模式（React StrictMode）也只执行一次\n * - 自动使用最新版 effect 函数\n *\n * @param effect 副作用函数（必须为同步函数；若为异步函数，清理逻辑需自行处理）\n * @example\n * useMount(() => {\n *   console.log('组件挂载');\n *   return () => console.log('组件卸载');\n * });\n *\n * useMount(async () => {\n *   const data = await fetchData();\n *   // 清理逻辑需通过 ref/AbortController 自行管理\n *   // ❌ 不要 return cleanupFn（async 函数返回 Promise，无法作为清理函数）\n * });\n */\nexport function useMount (effect: EffectCallback | AnyAsyncFunction) {\n  const isMountedRef = useRef(false);\n  const effectRef = useLatest(effect);\n\n  useEffect(() => {\n    if (!isFunction(effectRef.current)) {\n      console.error(`[useMount] Expected parameter to be a function, but got ${typeof effectRef.current}. This effect will not execute.`);\n\n      return;\n    }\n    if (isMountedRef.current) {\n      return;\n    }\n\n    isMountedRef.current = true;\n    const cleanup = effectRef.current?.();\n\n    return isFunction(cleanup) && !isPromise(cleanup) ? cleanup : undefined;\n  }, [effectRef]);\n}\n","import type { AnyFunction } from \"@pawover/types\";\nimport { arrayZipToObject, objectAssign, objectKeys, stringToUpperCase, objectMapEntries, isEqual } from \"../../utils\";\nimport { useMemo, useState, useLayoutEffect } from \"react\";\nimport type { TupleToUnion } from \"type-fest\";\nimport { BREAK_POINT_TOKEN_ENUM, type BREAK_POINT_TOKEN_TYPE } from \"../../enums\";\n\ntype Breakpoint = TupleToUnion<typeof BREAK_POINTS>;\ntype ResponsiveValues = Record<Breakpoint, boolean>;\n\nconst SUBSCRIBER_SET = new Set<AnyFunction>();\nconst BREAK_POINTS = [\"xxxl\", \"xxl\", \"xl\", \"lg\", \"md\", \"sm\", \"xs\"] as const;\nconst DEFAULT_VALUES: ResponsiveValues = Object.freeze(arrayZipToObject(BREAK_POINTS, false));\nlet responsiveValues: ResponsiveValues = { ...DEFAULT_VALUES };\nlet responsiveTokens: BREAK_POINT_TOKEN_TYPE = BREAK_POINT_TOKEN_ENUM;\n\nexport interface ResponsiveHookOptions {\n  /** 屏幕响应断点 token 配置 */\n  breakPointTokens?: BREAK_POINT_TOKEN_TYPE;\n}\nexport function useResponsive (options?: ResponsiveHookOptions | undefined) {\n  const { breakPointTokens = {} } = options || {};\n  const tokens = useMemo(() => objectAssign(BREAK_POINT_TOKEN_ENUM, breakPointTokens), [breakPointTokens]);\n  const [responsive, setResponsive] = useState<ResponsiveValues>(() => calculateResponsive(tokens));\n  const current = objectKeys(DEFAULT_VALUES).find((key) => responsive[key] === true) || \"xs\";\n\n  useLayoutEffect(() => {\n    responsiveTokens = tokens;\n    window.addEventListener(\"resize\", resizeListener);\n\n    const subscriber = () => {\n      setResponsive(responsiveValues);\n    };\n\n    SUBSCRIBER_SET.add(subscriber);\n\n    return () => {\n      SUBSCRIBER_SET.delete(subscriber);\n\n      if (!SUBSCRIBER_SET.size) {\n        window.removeEventListener(\"resize\", resizeListener);\n      }\n    };\n  }, [tokens]);\n\n  return { responsive, current, breakPointTokens: tokens };\n}\n\nfunction resizeListener () {\n  const newValues = calculateResponsive(responsiveTokens);\n\n  if (!isEqual(responsiveValues, newValues)) {\n    responsiveValues = newValues;\n\n    for (const subscriber of SUBSCRIBER_SET) {\n      subscriber();\n    }\n  }\n}\n\nfunction calculateResponsive (tokens: BREAK_POINT_TOKEN_TYPE) {\n  const config = arrayZipToObject(BREAK_POINTS, BREAK_POINTS.map((t) => tokens[stringToUpperCase(t)]));\n\n  return objectMapEntries(DEFAULT_VALUES, (key) => [key, window.innerWidth >= config[key]]);\n}\n","import type { AnyFunction } from \"@pawover/types\";\nimport { useEffect } from \"react\";\nimport { isFunction } from \"../../utils\";\nimport { useLatest } from \"./useLatest\";\n\n/**\n * 在组件卸载时执行的 Hook\n * @reference https://ahooks.js.org/zh-CN/hooks/use-unmount\n *\n * @param effect 副作用函数\n */\nexport function useUnmount (effect: AnyFunction) {\n  const effectRef = useLatest(effect);\n\n  useEffect(\n    () => () => {\n      if (!isFunction(effectRef.current)) {\n        console.error(`[useUnmount] Expected parameter to be a function, but got ${typeof effectRef.current}. This effect will not execute.`);\n\n        return;\n      }\n      effectRef.current?.();\n    },\n    [effectRef],\n  );\n}\n","import { useEffect, useRef } from \"react\";\nimport { isBrowser, isString } from \"../../utils\";\nimport { useUnmount } from \"./useUnmount\";\n\ninterface TitleHookOptions {\n  /** 件卸载时是否恢复原始标题 */\n  isRestoreOnUnmount?: boolean;\n}\n\n/**\n * 设置页面标题\n * - 轻量级，适用于无路由库时设置页面标题\n * - 多个 `useTitle` 实例会互相干扰，需在顶层组件使用\n * - 无法处理 `document.title` 固有的竞态问题\n *\n * @param title 页面标题\n * @param options 配置选项\n */\nexport function useTitle (title: string, options?: TitleHookOptions | undefined) {\n  const titleRef = useRef(isBrowser() ? document.title : \"\");\n\n  useEffect(() => {\n    if (!isString(title)) {\n      console.error(`[useTitle] Expected parameter to be a string, but got ${typeof title}. This effect will not execute.`);\n\n      return;\n    }\n    if (isBrowser()) {\n      document.title = title;\n    }\n  }, [title]);\n\n  useUnmount(() => {\n    if (isBrowser() && options?.isRestoreOnUnmount) {\n      document.title = titleRef.current;\n    }\n  });\n}\n"],"mappings":"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"}

package/dist/{index-DBPmnr4a.d.ts → index-D0_YLsqN.d.ts}

@@ -1,5 +1,4 @@
 //#region node_modules/.pnpm/@pawover+types@0.0.0-alpha._d6a4faea50420a71bc77e0a59520b8b6/node_modules/@pawover/types/dist/index.d.ts
-
 //#endregion
 //#region src/index.d.ts
 /** 任意对象类型 */
@@ -13,9 +12,7 @@ type AnyFunction<P extends any[] = any[], R$1 = any> = (...arg: P) => R$1;
 /** 描述异步函数类型 */
 type AnyAsyncFunction<P extends any[] = any[], R$1 = any> = (...args: P) => Promise<R$1>;
 type AnyGeneratorFunction<P extends any[] = any[], T = any, R$1 = any, N = any> = (...args: P) => Generator<T, R$1, N>;
-type AnyAsyncGeneratorFunction<P extends any[] = any[], T = any, R$1 = any, N = any> = (...args: P) => AsyncGenerator<T, R$1, N>;
-//#endregion
-
+type AnyAsyncGeneratorFunction<P extends any[] = any[], T = any, R$1 = any, N = any> = (...args: P) => AsyncGenerator<T, R$1, N>; //#endregion
 //#endregion
 export { AnyObject as a, AnyGeneratorFunction as i, AnyAsyncGeneratorFunction as n, PlainObject as o, AnyFunction as r, TreeLike as s, AnyAsyncFunction as t };
-//# sourceMappingURL=index-DBPmnr4a.d.ts.map
+//# sourceMappingURL=index-D0_YLsqN.d.ts.map

package/dist/index-D0_YLsqN.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-D0_YLsqN.d.ts","names":["Split","TupleToUnion","ALPHABET","Alphabet","ValidChar","ApiNameCheck","N","P","R","L","S","AdvancedRecordMode","AdvancedRecord","K","A","mode","PropertyKey","W","AnyObject","T","Record","PlainObject","TreeLike","CK","AnyFunction","R$1","arg","AnyAsyncFunction","Promise","args","AnyGeneratorFunction","Generator","AnyAsyncGeneratorFunction","AsyncGenerator"],"sources":["../node_modules/.pnpm/@pawover+types@0.0.0-alpha._d6a4faea50420a71bc77e0a59520b8b6/node_modules/@pawover/types/dist/index.d.ts"],"x_google_ignoreList":[0],"mappings":";;;;KA2BKkB,SAAAA,WAAoBF,WAAAA,GAAcA,WAAAA,aAAwBI,MAAAA,CAAOP,CAAAA,EAAGM,CAAAA;;KAEpEE,WAAAA,WAAsBL,WAAAA,GAAcA,WAAAA,iBAA4BI,MAAAA,CAAOP,CAAAA,EAAGM,CAAAA;;KAE1EG,QAAAA,WAAmBJ,SAAAA,oCAA6CC,CAAAA,GAAIC,MAAAA,CAAOG,EAAAA,EAAID,QAAAA,CAASH,CAAAA,EAAGI,EAAAA;;KAE3FC,WAAAA,2CAAsDE,GAAAA,EAAKnB,CAAAA,KAAMkB,GAAAA;;KAEjEE,gBAAAA,2CAA2DE,IAAAA,EAAMtB,CAAAA,KAAMqB,OAAAA,CAAQH,GAAAA;AAAAA,KAC/EK,oBAAAA,6DAAiFD,IAAAA,EAAMtB,CAAAA,KAAMwB,SAAAA,CAAUZ,CAAAA,EAAGM,GAAAA,EAAKnB,CAAAA;AAAAA,KAC/G0B,yBAAAA,6DAAsFH,IAAAA,EAAMtB,CAAAA,KAAM0B,cAAAA,CAAed,CAAAA,EAAGM,GAAAA,EAAKnB,CAAAA"}

package/dist/index-JKtXbRi8.d.ts

@@ -0,0 +1,149 @@
+import { t as ValueOf } from "./value-of-Dz22arsm.js";
+
+//#region src/enums/date.d.ts
+declare const DATE_FORMAT: {
+  readonly ISO_DATE: "yyyy-MM-dd";
+  readonly ISO_TIME: "HH:mm:ss";
+  readonly ISO_DATE_TIME: "yyyy-MM-dd HH:mm:ss";
+  readonly ISO_DATE_TIME_MS: "yyyy-MM-dd HH:mm:ss.SSS";
+  readonly ISO_DATETIME_TZ: "yyyy-MM-dd'T'HH:mm:ssXXX";
+  readonly ISO_DATETIME_TZ_MS: "yyyy-MM-dd'T'HH:mm:ss.SSSXXX";
+  readonly US_DATE: "MM/dd/yyyy";
+  readonly US_DATE_TIME: "MM/dd/yyyy HH:mm:ss";
+  readonly US_DATE_SHORT_YEAR: "MM/dd/yy";
+  readonly EU_DATE: "dd/MM/yyyy";
+  readonly EU_DATE_TIME: "dd/MM/yyyy HH:mm:ss";
+  readonly CN_DATE: "yyyy年MM月dd日";
+  readonly CN_DATE_TIME: "yyyy年MM月dd日 HH时mm分ss秒";
+  readonly CN_DATE_WEEKDAY: "yyyy年MM月dd日 EEE";
+  readonly CN_WEEKDAY_FULL: "EEEE";
+  readonly SHORT_DATE: "yy-MM-dd";
+  readonly SHORT_DATE_SLASH: "yy/MM/dd";
+  readonly MONTH_DAY: "MM-dd";
+  readonly MONTH_DAY_CN: "MM月dd日";
+  readonly DATE_WITH_WEEKDAY_SHORT: "yyyy-MM-dd (EEE)";
+  readonly DATE_WITH_WEEKDAY_FULL: "yyyy-MM-dd (EEEE)";
+  readonly TIME_24: "HH:mm:ss";
+  readonly TIME_24_NO_SEC: "HH:mm";
+  readonly TIME_12: "hh:mm:ss a";
+  readonly TIME_12_NO_SEC: "hh:mm a";
+  readonly TIMESTAMP: "yyyyMMddHHmmss";
+  readonly TIMESTAMP_MS: "yyyyMMddHHmmssSSS";
+  readonly RFC2822: "EEE, dd MMM yyyy HH:mm:ss xxx";
+  readonly READABLE_DATE: "MMM dd, yyyy";
+  readonly READABLE_DATE_TIME: "MMM dd, yyyy HH:mm";
+  readonly COMPACT_DATETIME: "yyyyMMdd_HHmmss";
+};
+//#endregion
+//#region src/enums/grid.d.ts
+type BREAK_POINT_TOKEN_TYPE = Record<keyof typeof BREAK_POINT_TOKEN_ENUM, number>;
+/** 屏幕响应断点 token 配置 */
+declare const BREAK_POINT_TOKEN_ENUM: {
+  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;
+};
+//#endregion
+//#region src/enums/mime.d.ts
+/**
+ * 标准 MIME 类型常量，用于文件类型标识和 HTTP Content-Type 头部
+ * 基于 IANA 注册标准和浏览器兼容性验证
+ */
+declare const MIME: {
+  /** 普通文本文件 */readonly TEXT: "text/plain"; /** 超文本标记语言文档 */
+  readonly HTML: "text/html"; /** 层叠样式表文件 */
+  readonly CSS: "text/css"; /** 逗号分隔值文件（表格数据） */
+  readonly CSV: "text/csv"; /** 制表符分隔值文件 */
+  readonly TSV: "text/tab-separated-values"; /** XML 文档 */
+  readonly XML: "text/xml"; /** XHTML 文档（XML 严格格式的 HTML） */
+  readonly XHTML: "application/xhtml+xml"; /** JavaScript 脚本文件（标准推荐） */
+  readonly JS: "text/javascript"; /** Markdown 格式文档 */
+  readonly MARKDOWN: "text/markdown"; /** 富文本格式文档（.rtf） */
+  readonly RTF: "application/rtf"; /** iCalendar 日历格式（.ics） */
+  readonly CALENDAR: "text/calendar"; /** JPEG 图像（.jpg/.jpeg） */
+  readonly JPEG: "image/jpeg"; /** PNG 图像（无损压缩，支持透明） */
+  readonly PNG: "image/png"; /** GIF 图像（支持动画） */
+  readonly GIF: "image/gif"; /** Windows 位图（.bmp） */
+  readonly BMP: "image/bmp"; /** SVG 向量图形（.svg） */
+  readonly SVG: "image/svg+xml"; /** APNG 动态图像（.apng） */
+  readonly APNG: "image/apng"; /** AVIF 图像（高效压缩） */
+  readonly AVIF: "image/avif"; /** 图标文件格式（.ico） */
+  readonly ICO: "image/vnd.microsoft.icon"; /** WebP 图像（高效压缩） */
+  readonly WEBP: "image/webp"; /** MP3 音频（.mp3） */
+  readonly MP3: "audio/mpeg"; /** AAC 音频（.aac） */
+  readonly AAC: "audio/aac"; /** MIDI 音乐文件（.mid/.midi） */
+  readonly MIDI: "audio/midi"; /** OGG 音频（.oga） */
+  readonly OGG_AUDIO: "audio/ogg"; /** Opus 音频（.opus） */
+  readonly OPUS: "audio/opus"; /** WAV 音频（.wav） */
+  readonly WAV: "audio/wav"; /** RealAudio 音频（.ra/.ram） */
+  readonly REAL_AUDIO: "audio/x-pn-realaudio"; /** MP4 视频（.mp4） */
+  readonly MP4: "video/mp4"; /** MPEG 视频（.mpeg/.mpg） */
+  readonly MPEG: "video/mpeg"; /** OGG 视频（.ogv） */
+  readonly OGG_VIDEO: "video/ogg"; /** AVI 视频（.avi） */
+  readonly AVI: "video/x-msvideo"; /** 3GPP 视频（.3gp） */
+  readonly THREE_GPP: "video/3gpp"; /** 3GPP2 视频（.3g2） */
+  readonly THREE_GPP2: "video/3gpp2"; /** WebM 视频（.webm） */
+  readonly WEBM: "video/webm"; /** PDF 文档 */
+  readonly PDF: "application/pdf"; /** Word 97-2003 文档（.doc） */
+  readonly DOC: "application/msword"; /** Word 2007+ 文档（.docx） */
+  readonly DOCX: "application/vnd.openxmlformats-officedocument.wordprocessingml.document"; /** Excel 2007+ 工作簿（.xlsx） */
+  readonly XLSX: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"; /** 启用宏的Excel工作簿（.xlsm） */
+  readonly XLSM: "application/vnd.ms-excel.sheet.macroEnabled.12"; /** Excel模板文件（.xltx） */
+  readonly XLTX: "application/vnd.openxmlformats-officedocument.spreadsheetml.template"; /** PowerPoint 2007+ 演示文稿（.pptx） */
+  readonly PPTX: "application/vnd.openxmlformats-officedocument.presentationml.presentation"; /** PowerPoint 97-2003 演示文稿（.ppt） */
+  readonly PPT: "application/vnd.ms-powerpoint"; /** OpenDocument 文本文档（.odt） */
+  readonly ODT: "application/vnd.oasis.opendocument.text"; /** OpenDocument 表格文档（.ods） */
+  readonly ODS: "application/vnd.oasis.opendocument.spreadsheet"; /** OpenDocument 演示文稿（.odp） */
+  readonly ODP: "application/vnd.oasis.opendocument.presentation"; /** EPUB 电子书（.epub） */
+  readonly EPUB: "application/epub+zip"; /** Kindle 电子书（.azw） */
+  readonly AZW: "application/vnd.amazon.ebook"; /** ZIP 压缩文件（.zip） */
+  readonly ZIP: "application/zip"; /** GZIP 压缩文件（.gz） */
+  readonly GZIP: "application/gzip"; /** GZIP 压缩文件（旧格式） */
+  readonly X_GZIP: "application/x-gzip"; /** TAR 归档文件（.tar） */
+  readonly TAR: "application/x-tar"; /** BZip 归档（.bz） */
+  readonly BZIP: "application/x-bzip"; /** BZip2 归档（.bz2） */
+  readonly BZIP2: "application/x-bzip2"; /** 7-Zip 压缩文件（.7z） */
+  readonly SEVEN_Z: "application/x-7z-compressed"; /** 通用二进制数据（默认类型） */
+  readonly OCTET_STREAM: "application/octet-stream"; /** JSON 数据格式（.json） */
+  readonly JSON: "application/json"; /** JSON-LD 格式（.jsonld） */
+  readonly LD_JSON: "application/ld+json"; /** Java 归档文件（.jar） */
+  readonly JAR: "application/java-archive"; /** MS 嵌入式 OpenType 字体（.eot） */
+  readonly EOT: "application/vnd.ms-fontobject"; /** OpenType 字体（.otf） */
+  readonly OTF: "font/otf"; /** Excel 97-2003 工作簿（.xls） */
+  readonly XLS: "application/vnd.ms-excel"; /** Microsoft XPS 文档（.xps） */
+  readonly XPS: "application/vnd.ms-xpsdocument"; /** Word 启用宏文档（.docm） */
+  readonly DOCM: "application/vnd.ms-word.document.macroEnabled.12";
+};
+//#endregion
+//#region src/enums/theme.d.ts
+type THEME_TYPE = ValueOf<typeof THEME_ENUM>;
+declare const THEME_ENUM: {
+  readonly LIGHT: "light";
+  readonly DARK: "dark";
+};
+type THEME_MODE_TYPE = ValueOf<typeof THEME_MODE_ENUM>;
+declare const THEME_MODE_ENUM: {
+  readonly LIGHT: "light";
+  readonly DARK: "dark";
+  readonly SYSTEM: "system";
+};
+//#endregion
+export { MIME as a, DATE_FORMAT as c, THEME_TYPE as i, THEME_MODE_ENUM as n, BREAK_POINT_TOKEN_ENUM as o, THEME_MODE_TYPE as r, BREAK_POINT_TOKEN_TYPE as s, THEME_ENUM as t };
+//# sourceMappingURL=index-JKtXbRi8.d.ts.map

package/dist/index-JKtXbRi8.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-JKtXbRi8.d.ts","names":[],"sources":["../src/enums/date.ts","../src/enums/grid.ts","../src/enums/mime.ts","../src/enums/theme.ts"],"mappings":";;;cAAa,WAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KCAD,sBAAA,GAAyB,MAAA,cAAoB,sBAAA;;cAE5C,sBAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;ADFb;cEIa,IAAA;;;;;;;;;;;;;;;;;;;4CDJD;EAAA;8BAAmE;EAAA,2BA6BrE;EAAA,6BAAA;EAAA;;;;;;;;;;;;sCCzBG;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KCFD,UAAA,GAAa,OAAA,QAAe,UAAA;AAAA,cAC3B,UAAA;EAAA,SAGH,KAAA;EAAA,SAAA,IAAA;AAAA;AAAA,KAEE,eAAA,GAAkB,OAAA,QAAe,eAAA;AAAA,cAChC,eAAA;EAAA"}