@pawover/kit 0.0.0-beta.1 → 0.0.0-beta.3

package/dist/hooks-react.js

@@ -47,8 +47,8 @@ function isBoolean(value) {
 * 判断是否为对象类型
 * - 可选是否检查原型为 `Object.prototype`，防止原型链污染
 *
-* @param value - 待检查值
-* @param prototypeCheck - 是否进行原型检查，默认 `true`
+* @param value 待检查值
+* @param prototypeCheck 是否进行原型检查，默认 `true`
 */
 function isObject(value, prototypeCheck = true) {
 	const check = resolvePrototypeString(value) === PROTOTYPE_TAGS.object;
@@ -119,8 +119,14 @@ function isRegExp(value) {
 
 //#endregion
 //#region src/utils/typeof/isString.ts
-function isString(value) {
-	return typeof value === "string";
+/**
+* 检查 value 是否为 string 类型
+*
+* @param value 待检查值
+* @param checkEmpty 是否排除空字符串
+*/
+function isString(value, checkEmpty = false) {
+	return typeof value === "string" && (!checkEmpty || !!value.length);
 }
 
 //#endregion

package/dist/hooks-react.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-react.js","names":["defaultResponsiveValues: ResponsiveValues","responsiveConfig: ResponsiveConfig","responsiveValues: ResponsiveValues","tokens: BREAK_POINT_TOKEN_TYPE"],"sources":["../src/utils/typeof/types.ts","../src/utils/typeof/isBoolean.ts","../src/utils/typeof/isObject.ts","../src/utils/typeof/isDate.ts","../src/utils/typeof/isEqual.ts","../src/utils/typeof/isFunction.ts","../src/utils/typeof/isPromise.ts","../src/utils/typeof/isRegExp.ts","../src/utils/typeof/isString.ts","../src/utils/object/objectKeys.ts","../src/utils/object/objectAssign.ts","../src/hooks/react/useCreation.ts","../src/hooks/react/useLatest.ts","../src/hooks/react/useMount.ts","../src/enums/grid.ts","../src/hooks/react/useResponsive.ts","../src/hooks/react/useUnmount.ts"],"sourcesContent":["export const PROTOTYPE_TAGS = {\n  abortSignal: \"[object AbortSignal]\",\n  array: \"[object Array]\",\n  asyncFunction: \"[object AsyncFunction]\",\n  asyncGeneratorFunction: \"[object AsyncGeneratorFunction]\",\n  bigInt: \"[object BigInt]\",\n  blob: \"[object Blob]\",\n  boolean: \"[object Boolean]\",\n  date: \"[object Date]\",\n  error: \"[object Error]\",\n  file: \"[object File]\",\n  function: \"[object Function]\",\n  generatorFunction: \"[object GeneratorFunction]\",\n  map: \"[object Map]\",\n  null: \"[object Null]\",\n  number: \"[object Number]\",\n  object: \"[object Object]\",\n  promise: \"[object Promise]\",\n  readableStream: \"[object ReadableStream]\",\n  regExp: \"[object RegExp]\",\n  set: \"[object Set]\",\n  string: \"[object String]\",\n  symbol: \"[object Symbol]\",\n  undefined: \"[object Undefined]\",\n  URLSearchParams: \"[object URLSearchParams]\",\n  weakMap: \"[object WeakMap]\",\n  weakSet: \"[object WeakSet]\",\n  webSocket: \"[object WebSocket]\",\n  window: \"[object Window]\",\n} as const;\n\nexport const TYPED_ARRAY_TAGS = new Set([\n  \"[object Int8Array]\",\n  \"[object Uint8Array]\",\n  \"[object Uint8ClampedArray]\",\n  \"[object Int16Array]\",\n  \"[object Uint16Array]\",\n  \"[object Int32Array]\",\n  \"[object Uint32Array]\",\n  \"[object Float32Array]\",\n  \"[object Float64Array]\",\n  \"[object BigInt64Array]\",\n  \"[object BigUint64Array]\",\n]);\n\nexport function resolvePrototypeString(value: unknown) {\n  return Object.prototype.toString.call(value);\n}\n","export function isBoolean(value: unknown): value is boolean {\n  return typeof value === \"boolean\";\n}\n","import { PROTOTYPE_TAGS, resolvePrototypeString } from \"./types\";\n\n/**\n * 判断是否为对象类型\n * - 可选是否检查原型为 `Object.prototype`，防止原型链污染\n *\n * @param value - 待检查值\n * @param prototypeCheck - 是否进行原型检查，默认 `true`\n */\nexport function isObject(value: unknown, prototypeCheck = true): value is Record<PropertyKey, unknown> {\n  const check = resolvePrototypeString(value) === PROTOTYPE_TAGS.object;\n\n  return prototypeCheck ? check && Object.getPrototypeOf(value) === Object.prototype : check;\n}\n","import { isObject } from \"./isObject\";\nimport { PROTOTYPE_TAGS, resolvePrototypeString } from \"./types\";\n\nexport function isDate(value: unknown): value is Date {\n  if (!isObject(value)) {\n    return false;\n  }\n\n  try {\n    return resolvePrototypeString(value) === PROTOTYPE_TAGS.date && typeof (value)[\"getTime\"] === \"function\";\n  } catch (error) {\n    return false;\n  }\n}\n","import { isDate, isRegExp } from \".\";\n\n/**\n * 检查给定的值是否相等\n * @reference https://github.com/radashi-org/radashi/blob/main/src/typed/isEqual.ts\n *\n * @param {T} x\n * @param {T} y\n */\nexport function isEqual<T>(x: T, y: T): boolean {\n  if (Object.is(x, y)) {\n    return true;\n  }\n  if (isDate(x) && isDate(y)) {\n    return x.getTime() === y.getTime();\n  }\n  if (isRegExp(x) && isRegExp(y)) {\n    return x.toString() === y.toString();\n  }\n  if (typeof x !== \"object\" || x === null || typeof y !== \"object\" || y === null) {\n    return false;\n  }\n\n  const keysX = Reflect.ownKeys(x) as (keyof typeof x)[];\n  const keysY = Reflect.ownKeys(y);\n  if (keysX.length !== keysY.length) {\n    return false;\n  }\n\n  for (const key of keysX) {\n    if (!Reflect.has(y, key)) {\n      return false;\n    }\n    if (!isEqual(x[key], y[key])) {\n      return false;\n    }\n  }\n\n  return true;\n}\n","import { PROTOTYPE_TAGS, resolvePrototypeString } from \"./types\";\n\nexport function isFunction(value: unknown): value is AnyFunction {\n  return typeof value === \"function\";\n}\n\nexport function isAsyncFunction(value: unknown): value is AnyAsyncFunction {\n  return isFunction(value) && resolvePrototypeString(value) === PROTOTYPE_TAGS.asyncFunction;\n}\n\nexport function isGeneratorFunction(value: unknown): value is AnyGeneratorFunction {\n  return isFunction(value) && resolvePrototypeString(value) === PROTOTYPE_TAGS.generatorFunction;\n}\n\nexport function isAsyncGeneratorFunction(value: unknown): value is AnyAsyncGeneratorFunction {\n  return isFunction(value) && resolvePrototypeString(value) === PROTOTYPE_TAGS.asyncGeneratorFunction;\n}\n","import { isFunction } from \"./isFunction\";\nimport { isObject } from \"./isObject\";\nimport { PROTOTYPE_TAGS, resolvePrototypeString } from \"./types\";\n\nexport function isPromise(value: unknown): value is Promise<unknown> {\n  return resolvePrototypeString(value) === PROTOTYPE_TAGS.promise;\n}\n\nexport function isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return isPromise(value) || (isObject(value) && isFunction(value[\"then\"]));\n}\n","import { isBoolean, isFunction, isObject, isString } from \".\";\nimport { PROTOTYPE_TAGS, resolvePrototypeString } from \"./types\";\n\nexport function isRegExp(value: unknown): value is RegExp {\n  if (!isObject(value)) {\n    return false;\n  }\n\n  try {\n    const regex = value as unknown as RegExp;\n\n    return (\n      resolvePrototypeString(value) === PROTOTYPE_TAGS.regExp &&\n      isString(regex.source) &&\n      isString(regex.flags) &&\n      isBoolean(regex.global) &&\n      isFunction(regex.test)\n    );\n  } catch (error) {\n    return false;\n  }\n}\n","export function isString(value: unknown): value is string {\n  return typeof value === \"string\";\n}\n","/**\n * 返回对象的可枚举属性和方法的名称\n * - `Object.keys` 始终返回 `string[]` 类型，此函数可以返回具体类型\n *\n * @param obj 对象\n */\nexport function objectKeys<O extends AnyObject>(obj: O): (keyof O)[] {\n  return Object.keys(obj);\n}\n","import type { Assign } from \"radashi\";\nimport { isObject } from \"../typeof\";\n\n/**\n * 递归地将第二个对象合并到第一个对象的副本中\n * - 只有普通对象才会递归合并\n *\n * @param initial 初始对象\n * @param override 待合并对象\n */\nexport function objectAssign<I extends PlainObject, O extends PlainObject>(initial: I, override: O): Assign<I, O> {\n  if (!isObject(initial) || !isObject(override)) {\n    return (initial ?? override ?? {}) as Assign<I, O>;\n  }\n\n  const proto = Object.getPrototypeOf(initial);\n  const assigned = proto ? { ...initial } : Object.assign(Object.create(proto), initial);\n\n  for (const key of Object.keys(override)) {\n    assigned[key] = isObject(initial[key]) && isObject(override[key]) ? objectAssign(initial[key], override[key]) : override[key];\n  }\n\n  return assigned;\n}\n","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 * @template T\n * @param {() => T} factory\n * @param {DependencyList} 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\n","import { useRef, type RefObject } from \"react\";\n\n/**\n * 返回当前最新值的 Hook\n * @reference https://ahooks.js.org/zh-CN/hooks/use-latest\n *\n * @template T\n * @param {T} value\n */\nexport function useLatest<T>(value: T): RefObject<T> {\n  const ref = useRef(value);\n  ref.current = value;\n\n  return ref;\n}\n\n","import { 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 * @reference https://ahooks.js.org/hooks/use-mount\n *\n * @param {MountCallback} effect 副作用函数\n */\nexport function useMount(effect: MountCallback) {\n  if (!isFunction(effect)) {\n    console.error(`useMount expected parameter is a function, but got ${typeof effect}`);\n  }\n\n  const isMountedRef = useRef(false);\n  const effectRef = useLatest(effect);\n\n  useEffect(() => {\n    if (isMountedRef.current) {\n      return;\n    }\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 as ReturnType<EffectCallback>;\n  }, []);\n}\n\n","export type BREAK_POINT_TOKEN_TYPE = Record<keyof typeof BREAK_POINT_TOKEN_ENUM, number>;\n/** 屏幕响应断点 token 配置 */\nexport const BREAK_POINT_TOKEN_ENUM = {\n  XS: 576,\n  XSMin: 576,\n  XSMax: 767,\n  SM: 768,\n  SMMin: 768,\n  SMMax: 991,\n  MD: 992,\n  MDMin: 992,\n  MDMax: 1199,\n  LG: 1200,\n  LGMin: 1200,\n  LGMax: 1599,\n  XL: 1600,\n  XLMin: 1600,\n  XLMax: 1919,\n  XXL: 1920,\n  XXLMin: 1920,\n} as const;\n","import { useEffect, useState } from \"react\";\nimport { BREAK_POINT_TOKEN_ENUM, type BREAK_POINT_TOKEN_TYPE } from \"src/enums\";\nimport { objectAssign, objectKeys } from \"src/utils\";\n\ntype Breakpoint = \"xxl\" | \"xl\" | \"lg\" | \"md\" | \"sm\" | \"xs\";\ntype Subscriber = () => void;\ntype ResponsiveConfig = Record<Breakpoint, number>;\ntype ResponsiveValues = Record<Breakpoint, boolean>;\n\nconst subscriberList = new Set<Subscriber>();\nconst { XS, SM, MD, LG, XL, XXL } = BREAK_POINT_TOKEN_ENUM;\nconst defaultResponsiveValues: ResponsiveValues = { xxl: false, xl: false, lg: false, md: false, sm: false, xs: false };\nlet responsiveConfig: ResponsiveConfig = { xxl: XXL, xl: XL, lg: LG, md: MD, sm: SM, xs: XS };\nlet responsiveValues: ResponsiveValues = { ...defaultResponsiveValues };\n\nexport interface ResponsiveHookOptions {\n  /**\n   * 紧凑布局断点\n   * - 低于此断点时使用紧凑布局\n   * @default \"xl\"\n   */\n  compactBreakPoint?: Breakpoint;\n  /** 屏幕响应断点 token 配置 */\n  breakPointTokens?: BREAK_POINT_TOKEN_TYPE;\n}\nexport function useResponsive(options?: ResponsiveHookOptions) {\n  const { compactBreakPoint = \"xl\", breakPointTokens = {} } = options || {};\n  const tokens: BREAK_POINT_TOKEN_TYPE = objectAssign(BREAK_POINT_TOKEN_ENUM, breakPointTokens);\n  responsiveConfig = { xxl: tokens.XXL, xl: tokens.XL, lg: tokens.LG, md: tokens.MD, sm: tokens.SM, xs: tokens.XS };\n\n  calculate();\n\n  const [responsive, setResponsive] = useState<ResponsiveValues>(responsiveValues);\n  const isCompact = !responsive[compactBreakPoint];\n  const current = objectKeys(defaultResponsiveValues).find((key) => responsive[key] === true) || \"xs\";\n\n  useEffect(() => {\n    addListener();\n\n    const subscriber = () => {\n      setResponsive(responsiveValues);\n    };\n\n    subscriberList.add(subscriber);\n\n    return () => {\n      subscriberList.delete(subscriber);\n\n      if (subscriberList.size === 0) {\n        removeListener();\n      }\n    };\n  }, []);\n\n  return { responsive, current, isCompact, breakPointTokens: tokens };\n}\n\nfunction resizeListener() {\n  const oldInfo = responsiveValues;\n  calculate();\n\n  if (oldInfo === responsiveValues) {\n    return;\n  }\n\n  for (const subscriber of subscriberList) {\n    subscriber();\n  }\n}\nfunction addListener() {\n  window.addEventListener(\"resize\", resizeListener);\n}\nfunction removeListener() {\n  window.removeEventListener(\"resize\", resizeListener);\n}\nfunction calculate() {\n  const width = window.innerWidth;\n  const newValues = { ...defaultResponsiveValues };\n  let shouldUpdate = false;\n\n  for (const key of objectKeys(responsiveConfig)) {\n    newValues[key] = width >= responsiveConfig[key];\n    if (newValues[key] !== responsiveValues[key]) {\n      shouldUpdate = true;\n    }\n  }\n  if (shouldUpdate) {\n    responsiveValues = newValues;\n  }\n}\n\n","import { 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 {AnyFunction} effect 副作用函数\n */\nexport function useUnmount(effect: AnyFunction) {\n  if (!isFunction(effect)) {\n    console.error(`useUnmount expected parameter is a function, got ${typeof effect}`);\n  }\n\n  const effectRef = useLatest(effect);\n\n  useEffect(\n    () => () => {\n      effectRef.current?.();\n    },\n    [],\n  );\n}\n\n"],"mappings":"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"}
+{"version":3,"file":"hooks-react.js","names":["defaultResponsiveValues: ResponsiveValues","responsiveConfig: ResponsiveConfig","responsiveValues: ResponsiveValues","tokens: BREAK_POINT_TOKEN_TYPE"],"sources":["../src/utils/typeof/types.ts","../src/utils/typeof/isBoolean.ts","../src/utils/typeof/isObject.ts","../src/utils/typeof/isDate.ts","../src/utils/typeof/isEqual.ts","../src/utils/typeof/isFunction.ts","../src/utils/typeof/isPromise.ts","../src/utils/typeof/isRegExp.ts","../src/utils/typeof/isString.ts","../src/utils/object/objectKeys.ts","../src/utils/object/objectAssign.ts","../src/hooks/react/useCreation.ts","../src/hooks/react/useLatest.ts","../src/hooks/react/useMount.ts","../src/enums/grid.ts","../src/hooks/react/useResponsive.ts","../src/hooks/react/useUnmount.ts"],"sourcesContent":["export const PROTOTYPE_TAGS = {\n  abortSignal: \"[object AbortSignal]\",\n  array: \"[object Array]\",\n  asyncFunction: \"[object AsyncFunction]\",\n  asyncGeneratorFunction: \"[object AsyncGeneratorFunction]\",\n  bigInt: \"[object BigInt]\",\n  blob: \"[object Blob]\",\n  boolean: \"[object Boolean]\",\n  date: \"[object Date]\",\n  error: \"[object Error]\",\n  file: \"[object File]\",\n  function: \"[object Function]\",\n  generatorFunction: \"[object GeneratorFunction]\",\n  map: \"[object Map]\",\n  null: \"[object Null]\",\n  number: \"[object Number]\",\n  object: \"[object Object]\",\n  promise: \"[object Promise]\",\n  readableStream: \"[object ReadableStream]\",\n  regExp: \"[object RegExp]\",\n  set: \"[object Set]\",\n  string: \"[object String]\",\n  symbol: \"[object Symbol]\",\n  undefined: \"[object Undefined]\",\n  URLSearchParams: \"[object URLSearchParams]\",\n  weakMap: \"[object WeakMap]\",\n  weakSet: \"[object WeakSet]\",\n  webSocket: \"[object WebSocket]\",\n  window: \"[object Window]\",\n} as const;\n\nexport const TYPED_ARRAY_TAGS = new Set([\n  \"[object Int8Array]\",\n  \"[object Uint8Array]\",\n  \"[object Uint8ClampedArray]\",\n  \"[object Int16Array]\",\n  \"[object Uint16Array]\",\n  \"[object Int32Array]\",\n  \"[object Uint32Array]\",\n  \"[object Float32Array]\",\n  \"[object Float64Array]\",\n  \"[object BigInt64Array]\",\n  \"[object BigUint64Array]\",\n]);\n\nexport function resolvePrototypeString(value: unknown) {\n  return Object.prototype.toString.call(value);\n}\n","export function isBoolean(value: unknown): value is boolean {\n  return typeof value === \"boolean\";\n}\n","import { PROTOTYPE_TAGS, resolvePrototypeString } from \"./types\";\n\n/**\n * 判断是否为对象类型\n * - 可选是否检查原型为 `Object.prototype`，防止原型链污染\n *\n * @param value 待检查值\n * @param prototypeCheck 是否进行原型检查，默认 `true`\n */\nexport function isObject(value: unknown, prototypeCheck = true): value is Record<PropertyKey, unknown> {\n  const check = resolvePrototypeString(value) === PROTOTYPE_TAGS.object;\n\n  return prototypeCheck ? check && Object.getPrototypeOf(value) === Object.prototype : check;\n}\n","import { isObject } from \"./isObject\";\nimport { PROTOTYPE_TAGS, resolvePrototypeString } from \"./types\";\n\nexport function isDate(value: unknown): value is Date {\n  if (!isObject(value)) {\n    return false;\n  }\n\n  try {\n    return resolvePrototypeString(value) === PROTOTYPE_TAGS.date && typeof (value)[\"getTime\"] === \"function\";\n  } catch (error) {\n    return false;\n  }\n}\n","import { isDate, isRegExp } from \".\";\n\n/**\n * 检查给定的值是否相等\n * @reference https://github.com/radashi-org/radashi/blob/main/src/typed/isEqual.ts\n *\n * @param {T} x\n * @param {T} y\n */\nexport function isEqual<T>(x: T, y: T): boolean {\n  if (Object.is(x, y)) {\n    return true;\n  }\n  if (isDate(x) && isDate(y)) {\n    return x.getTime() === y.getTime();\n  }\n  if (isRegExp(x) && isRegExp(y)) {\n    return x.toString() === y.toString();\n  }\n  if (typeof x !== \"object\" || x === null || typeof y !== \"object\" || y === null) {\n    return false;\n  }\n\n  const keysX = Reflect.ownKeys(x) as (keyof typeof x)[];\n  const keysY = Reflect.ownKeys(y);\n  if (keysX.length !== keysY.length) {\n    return false;\n  }\n\n  for (const key of keysX) {\n    if (!Reflect.has(y, key)) {\n      return false;\n    }\n    if (!isEqual(x[key], y[key])) {\n      return false;\n    }\n  }\n\n  return true;\n}\n","import { PROTOTYPE_TAGS, resolvePrototypeString } from \"./types\";\n\nexport function isFunction(value: unknown): value is AnyFunction {\n  return typeof value === \"function\";\n}\n\nexport function isAsyncFunction(value: unknown): value is AnyAsyncFunction {\n  return isFunction(value) && resolvePrototypeString(value) === PROTOTYPE_TAGS.asyncFunction;\n}\n\nexport function isGeneratorFunction(value: unknown): value is AnyGeneratorFunction {\n  return isFunction(value) && resolvePrototypeString(value) === PROTOTYPE_TAGS.generatorFunction;\n}\n\nexport function isAsyncGeneratorFunction(value: unknown): value is AnyAsyncGeneratorFunction {\n  return isFunction(value) && resolvePrototypeString(value) === PROTOTYPE_TAGS.asyncGeneratorFunction;\n}\n","import { isFunction } from \"./isFunction\";\nimport { isObject } from \"./isObject\";\nimport { PROTOTYPE_TAGS, resolvePrototypeString } from \"./types\";\n\nexport function isPromise(value: unknown): value is Promise<unknown> {\n  return resolvePrototypeString(value) === PROTOTYPE_TAGS.promise;\n}\n\nexport function isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return isPromise(value) || (isObject(value) && isFunction(value[\"then\"]));\n}\n","import { isBoolean, isFunction, isObject, isString } from \".\";\nimport { PROTOTYPE_TAGS, resolvePrototypeString } from \"./types\";\n\nexport function isRegExp(value: unknown): value is RegExp {\n  if (!isObject(value)) {\n    return false;\n  }\n\n  try {\n    const regex = value as unknown as RegExp;\n\n    return (\n      resolvePrototypeString(value) === PROTOTYPE_TAGS.regExp &&\n      isString(regex.source) &&\n      isString(regex.flags) &&\n      isBoolean(regex.global) &&\n      isFunction(regex.test)\n    );\n  } catch (error) {\n    return false;\n  }\n}\n","/**\n * 检查 value 是否为 string 类型\n *\n * @param value 待检查值\n * @param checkEmpty 是否排除空字符串\n */\nexport function isString(value: unknown, checkEmpty = false): value is string {\n  return typeof value === \"string\" && (!checkEmpty || !!value.length);\n}\n","/**\n * 返回对象的可枚举属性和方法的名称\n * - `Object.keys` 始终返回 `string[]` 类型，此函数可以返回具体类型\n *\n * @param obj 对象\n */\nexport function objectKeys<O extends AnyObject>(obj: O): (keyof O)[] {\n  return Object.keys(obj);\n}\n","import type { Assign } from \"radashi\";\nimport { isObject } from \"../typeof\";\n\n/**\n * 递归地将第二个对象合并到第一个对象的副本中\n * - 只有普通对象才会递归合并\n *\n * @param initial 初始对象\n * @param override 待合并对象\n */\nexport function objectAssign<I extends PlainObject, O extends PlainObject>(initial: I, override: O): Assign<I, O> {\n  if (!isObject(initial) || !isObject(override)) {\n    return (initial ?? override ?? {}) as Assign<I, O>;\n  }\n\n  const proto = Object.getPrototypeOf(initial);\n  const assigned = proto ? { ...initial } : Object.assign(Object.create(proto), initial);\n\n  for (const key of Object.keys(override)) {\n    assigned[key] = isObject(initial[key]) && isObject(override[key]) ? objectAssign(initial[key], override[key]) : override[key];\n  }\n\n  return assigned;\n}\n","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 * @template T\n * @param {() => T} factory\n * @param {DependencyList} 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\n","import { useRef, type RefObject } from \"react\";\n\n/**\n * 返回当前最新值的 Hook\n * @reference https://ahooks.js.org/zh-CN/hooks/use-latest\n *\n * @template T\n * @param {T} value\n */\nexport function useLatest<T>(value: T): RefObject<T> {\n  const ref = useRef(value);\n  ref.current = value;\n\n  return ref;\n}\n\n","import { 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 * @reference https://ahooks.js.org/hooks/use-mount\n *\n * @param {MountCallback} effect 副作用函数\n */\nexport function useMount(effect: MountCallback) {\n  if (!isFunction(effect)) {\n    console.error(`useMount expected parameter is a function, but got ${typeof effect}`);\n  }\n\n  const isMountedRef = useRef(false);\n  const effectRef = useLatest(effect);\n\n  useEffect(() => {\n    if (isMountedRef.current) {\n      return;\n    }\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 as ReturnType<EffectCallback>;\n  }, []);\n}\n\n","export type BREAK_POINT_TOKEN_TYPE = Record<keyof typeof BREAK_POINT_TOKEN_ENUM, number>;\n/** 屏幕响应断点 token 配置 */\nexport const BREAK_POINT_TOKEN_ENUM = {\n  XS: 576,\n  XSMin: 576,\n  XSMax: 767,\n  SM: 768,\n  SMMin: 768,\n  SMMax: 991,\n  MD: 992,\n  MDMin: 992,\n  MDMax: 1199,\n  LG: 1200,\n  LGMin: 1200,\n  LGMax: 1599,\n  XL: 1600,\n  XLMin: 1600,\n  XLMax: 1919,\n  XXL: 1920,\n  XXLMin: 1920,\n} as const;\n","import { useEffect, useState } from \"react\";\nimport { BREAK_POINT_TOKEN_ENUM, type BREAK_POINT_TOKEN_TYPE } from \"src/enums\";\nimport { objectAssign, objectKeys } from \"src/utils\";\n\ntype Breakpoint = \"xxl\" | \"xl\" | \"lg\" | \"md\" | \"sm\" | \"xs\";\ntype Subscriber = () => void;\ntype ResponsiveConfig = Record<Breakpoint, number>;\ntype ResponsiveValues = Record<Breakpoint, boolean>;\n\nconst subscriberList = new Set<Subscriber>();\nconst { XS, SM, MD, LG, XL, XXL } = BREAK_POINT_TOKEN_ENUM;\nconst defaultResponsiveValues: ResponsiveValues = { xxl: false, xl: false, lg: false, md: false, sm: false, xs: false };\nlet responsiveConfig: ResponsiveConfig = { xxl: XXL, xl: XL, lg: LG, md: MD, sm: SM, xs: XS };\nlet responsiveValues: ResponsiveValues = { ...defaultResponsiveValues };\n\nexport interface ResponsiveHookOptions {\n  /**\n   * 紧凑布局断点\n   * - 低于此断点时使用紧凑布局\n   * @default \"xl\"\n   */\n  compactBreakPoint?: Breakpoint;\n  /** 屏幕响应断点 token 配置 */\n  breakPointTokens?: BREAK_POINT_TOKEN_TYPE;\n}\nexport function useResponsive(options?: ResponsiveHookOptions) {\n  const { compactBreakPoint = \"xl\", breakPointTokens = {} } = options || {};\n  const tokens: BREAK_POINT_TOKEN_TYPE = objectAssign(BREAK_POINT_TOKEN_ENUM, breakPointTokens);\n  responsiveConfig = { xxl: tokens.XXL, xl: tokens.XL, lg: tokens.LG, md: tokens.MD, sm: tokens.SM, xs: tokens.XS };\n\n  calculate();\n\n  const [responsive, setResponsive] = useState<ResponsiveValues>(responsiveValues);\n  const isCompact = !responsive[compactBreakPoint];\n  const current = objectKeys(defaultResponsiveValues).find((key) => responsive[key] === true) || \"xs\";\n\n  useEffect(() => {\n    addListener();\n\n    const subscriber = () => {\n      setResponsive(responsiveValues);\n    };\n\n    subscriberList.add(subscriber);\n\n    return () => {\n      subscriberList.delete(subscriber);\n\n      if (subscriberList.size === 0) {\n        removeListener();\n      }\n    };\n  }, []);\n\n  return { responsive, current, isCompact, breakPointTokens: tokens };\n}\n\nfunction resizeListener() {\n  const oldInfo = responsiveValues;\n  calculate();\n\n  if (oldInfo === responsiveValues) {\n    return;\n  }\n\n  for (const subscriber of subscriberList) {\n    subscriber();\n  }\n}\nfunction addListener() {\n  window.addEventListener(\"resize\", resizeListener);\n}\nfunction removeListener() {\n  window.removeEventListener(\"resize\", resizeListener);\n}\nfunction calculate() {\n  const width = window.innerWidth;\n  const newValues = { ...defaultResponsiveValues };\n  let shouldUpdate = false;\n\n  for (const key of objectKeys(responsiveConfig)) {\n    newValues[key] = width >= responsiveConfig[key];\n    if (newValues[key] !== responsiveValues[key]) {\n      shouldUpdate = true;\n    }\n  }\n  if (shouldUpdate) {\n    responsiveValues = newValues;\n  }\n}\n\n","import { 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 {AnyFunction} effect 副作用函数\n */\nexport function useUnmount(effect: AnyFunction) {\n  if (!isFunction(effect)) {\n    console.error(`useUnmount expected parameter is a function, got ${typeof effect}`);\n  }\n\n  const effectRef = useLatest(effect);\n\n  useEffect(\n    () => () => {\n      effectRef.current?.();\n    },\n    [],\n  );\n}\n\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -125,7 +125,7 @@ declare function arraySplit<T>(initialList: readonly T[], size?: number): T[][];
 //#region src/utils/function/to.d.ts
 /**
  * @param promise
- * @param errorExt - 可以传递给err对象的其他信息
+ * @param errorExt 可以传递给err对象的其他信息
  */
 declare function to<T, U$1 = Error>(promise: Readonly<Promise<T>>, errorExt?: PlainObject): Promise<[U$1, undefined] | [null, T]>;
 //#endregion
@@ -2174,6 +2174,15 @@ declare function stringToJson<R$1 extends AnyObject = AnyObject, D extends R$1 =
  */
 declare function stringToNumber(input: string): string;
 //#endregion
+//#region src/utils/string/stringToPosix.d.ts
+/**
+ * 将路径转换为 POSIX 风格
+ *
+ * @param input 待处理字符串
+ * @param removeLeadingSlash 是否移除开头斜杠，默认为 `false`
+ */
+declare function stringToPosix(input: string | null | undefined, removeLeadingSlash?: boolean): string;
+//#endregion
 //#region src/utils/string/stringToValues.d.ts
 /**
  * 字符串分割为数组
@@ -2185,6 +2194,26 @@ declare function stringToNumber(input: string): string;
 declare function stringToValues(input: string | null | undefined, valueType?: "number" | undefined, splitSymbol?: string | undefined): number[];
 declare function stringToValues(input: string | null | undefined, valueType: "string", splitSymbol?: string | undefined): string[];
 //#endregion
+//#region src/utils/string/stringTrim.d.ts
+/**
+ * 从字符串中裁切掉所有的前缀和后缀字符
+ *
+ * @param input 待处理字符串
+ * @param charsToTrim 裁切字符，默认为 `" "`
+ */
+declare function stringTrim(input: string | null | undefined, charsToTrim?: string): string;
+//#endregion
+//#region src/utils/string/stringTruncate.d.ts
+/**
+ * 截取字符串
+ * - 支持中英文混排，不会在汉字中间截断
+ *
+ * @param input 待处理字符串
+ * @param maxLength 最大长度
+ * @param ellipsis 省略符，默认为 `...`
+ */
+declare function stringTruncate(input: string, maxLength: number, ellipsis?: string): string;
+//#endregion
 //#region src/utils/tree/types.d.ts
 type RowKey = "id";
 type ParentIdKey = "parentId";
@@ -2308,51 +2337,51 @@ declare function isNull(value: unknown): value is null;
 /**
  * 检查 value 是否为 number 类型
  *
- * @param value - 待检查值
- * @param checkNaN - 是否排除 `NaN`，默认为 `true`
+ * @param value 待检查值
+ * @param checkNaN 是否排除 `NaN`，默认为 `true`
  */
 declare function isNumber(value: unknown, checkNaN?: boolean): value is number;
 /**
  * 检查 value 是否为 NaN
  *
- * @param value - 待检查值
+ * @param value 待检查值
  */
 declare function isNaN(value: unknown): value is number;
 /**
  * 检查 value 是否为整数
  *
- * @param value - 待检查值
- * @param safeCheck - 是否附加安全数检查
+ * @param value 待检查值
+ * @param safeCheck 是否附加安全数检查
  */
 declare function isInteger(value: unknown, safeCheck?: boolean): value is number;
 /**
  * 检查 value 是否为正整数
  * - 此函数中 `0` 不被视为正整数
  *
- * @param value - 待检查值
- * @param safeCheck - 是否附加安全数检查
+ * @param value 待检查值
+ * @param safeCheck 是否附加安全数检查
  */
 declare function isPositiveInteger(value: unknown, safeCheck?: boolean): value is number;
 /**
  * 检查 value 是否为负整数
  * - 此函数中 `0` 不被视为负整数
  *
- * @param value - 待检查值
- * @param safeCheck - 是否附加安全数检查
+ * @param value 待检查值
+ * @param safeCheck 是否附加安全数检查
  */
 declare function isNegativeInteger(value: unknown, safeCheck?: boolean): value is number;
 /**
  * 检查 value 是否为 Infinity
  * - 排除 `NaN`
  *
- * @param value - 待检查值
+ * @param value 待检查值
  */
 declare function isInfinity(value: unknown): value is number;
 /**
  * 检查 value 是否类似 Infinity
  * - 排除 `NaN`
  *
- * @param value - 待检查值
+ * @param value 待检查值
  */
 declare function isInfinityLike(value: unknown): boolean;
 //#endregion
@@ -2361,8 +2390,8 @@ declare function isInfinityLike(value: unknown): boolean;
  * 判断是否为对象类型
  * - 可选是否检查原型为 `Object.prototype`，防止原型链污染
  *
- * @param value - 待检查值
- * @param prototypeCheck - 是否进行原型检查，默认 `true`
+ * @param value 待检查值
+ * @param prototypeCheck 是否进行原型检查，默认 `true`
  */
 declare function isObject(value: unknown, prototypeCheck?: boolean): value is Record<PropertyKey, unknown>;
 //#endregion
@@ -2390,7 +2419,13 @@ declare function isSet(value: unknown): value is Set<unknown>;
 declare function isWeakSet(value: unknown): value is WeakSet<AnyObject>;
 //#endregion
 //#region src/utils/typeof/isString.d.ts
-declare function isString(value: unknown): value is string;
+/**
+ * 检查 value 是否为 string 类型
+ *
+ * @param value 待检查值
+ * @param checkEmpty 是否排除空字符串
+ */
+declare function isString(value: unknown, checkEmpty?: boolean): value is string;
 //#endregion
 //#region src/utils/typeof/isSymbol.d.ts
 declare function isSymbol(value: unknown): value is symbol;
@@ -2407,5 +2442,5 @@ declare function isWebSocket(value: unknown): value is WebSocket;
 //#region src/utils/typeof/isWindow.d.ts
 declare function isWindow(value: unknown): value is Window;
 //#endregion
-export { arrayCast, arrayCompete, arrayCounting, arrayDifference, arrayFirst, arrayFork, arrayIntersection, arrayLast, arrayMerge, arrayPick, arrayReplace, arraySplit, cloneDeep, enumEntries, enumKeys, enumTypeCheck, enumValues, isAbortSignal, isArray, isAsyncFunction, isAsyncGeneratorFunction, isBigInt, isBlob, isBoolean, isClass, isDate, isEqual, isError, isFalsy, isFalsyLike, isFile, isFunction, isGeneratorFunction, isInfinity, isInfinityLike, isInteger, isIterable, isMap, isNaN, isNegativeInteger, isNull, isNumber, isObject, isPositiveInteger, isPromise, isPromiseLike, isReadableStream, isRegExp, isSet, isString, isSymbol, isTypedArray, isURLSearchParams, isUndefined, isWeakMap, isWeakSet, isWebSocket, isWindow, mapEntries, objectAssign, objectCrush, objectEntries, objectKeys, objectPick, objectSwitch, objectValues, rowsToTree, stringInitialCase, stringReplace, stringTemplate, stringToJson, stringToNumber, stringToValues, to, toMathBignumber, toMathDecimal, toMathEvaluate, treeFilter, treeFind, treeForEach, treeMap, treeToRows };
+export { arrayCast, arrayCompete, arrayCounting, arrayDifference, arrayFirst, arrayFork, arrayIntersection, arrayLast, arrayMerge, arrayPick, arrayReplace, arraySplit, cloneDeep, enumEntries, enumKeys, enumTypeCheck, enumValues, isAbortSignal, isArray, isAsyncFunction, isAsyncGeneratorFunction, isBigInt, isBlob, isBoolean, isClass, isDate, isEqual, isError, isFalsy, isFalsyLike, isFile, isFunction, isGeneratorFunction, isInfinity, isInfinityLike, isInteger, isIterable, isMap, isNaN, isNegativeInteger, isNull, isNumber, isObject, isPositiveInteger, isPromise, isPromiseLike, isReadableStream, isRegExp, isSet, isString, isSymbol, isTypedArray, isURLSearchParams, isUndefined, isWeakMap, isWeakSet, isWebSocket, isWindow, mapEntries, objectAssign, objectCrush, objectEntries, objectKeys, objectPick, objectSwitch, objectValues, rowsToTree, stringInitialCase, stringReplace, stringTemplate, stringToJson, stringToNumber, stringToPosix, stringToValues, stringTrim, stringTruncate, to, toMathBignumber, toMathDecimal, toMathEvaluate, treeFilter, treeFind, treeForEach, treeMap, treeToRows };
 //# sourceMappingURL=index.d.ts.map