@ug666/ui-react 0.2.0 → 0.3.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (250) hide show
  1. package/dist/aliases.d.ts +59 -0
  2. package/dist/aliases.d.ts.map +1 -0
  3. package/dist/blocks/feature-grid.d.ts +40 -0
  4. package/dist/blocks/feature-grid.d.ts.map +1 -0
  5. package/dist/blocks/index.cjs +293 -64
  6. package/dist/blocks/index.cjs.map +1 -1
  7. package/dist/blocks/index.d.ts +6 -84
  8. package/dist/blocks/index.d.ts.map +1 -0
  9. package/dist/blocks/index.js +80 -39
  10. package/dist/blocks/index.js.map +1 -1
  11. package/dist/blocks/landing-hero.d.ts +55 -0
  12. package/dist/blocks/landing-hero.d.ts.map +1 -0
  13. package/dist/chunk-AKWJMDCW.js +467 -0
  14. package/dist/chunk-AKWJMDCW.js.map +1 -0
  15. package/dist/chunk-F23X4N6B.js +11 -0
  16. package/dist/chunk-F23X4N6B.js.map +1 -0
  17. package/dist/chunk-HGO3GZ56.js +1777 -0
  18. package/dist/chunk-HGO3GZ56.js.map +1 -0
  19. package/dist/chunk-HXIWD5LQ.js +319 -0
  20. package/dist/chunk-HXIWD5LQ.js.map +1 -0
  21. package/dist/chunk-M6J4PLF4.js +521 -0
  22. package/dist/chunk-M6J4PLF4.js.map +1 -0
  23. package/dist/chunk-N3Z7R6GG.js +139 -0
  24. package/dist/chunk-N3Z7R6GG.js.map +1 -0
  25. package/dist/chunk-UXWCK6M7.js +5757 -0
  26. package/dist/chunk-UXWCK6M7.js.map +1 -0
  27. package/dist/components/accordion.d.ts +59 -0
  28. package/dist/components/accordion.d.ts.map +1 -0
  29. package/dist/components/alert.d.ts +23 -0
  30. package/dist/components/alert.d.ts.map +1 -0
  31. package/dist/components/avatar-group.d.ts +20 -0
  32. package/dist/components/avatar-group.d.ts.map +1 -0
  33. package/dist/components/avatar.d.ts +34 -0
  34. package/dist/components/avatar.d.ts.map +1 -0
  35. package/dist/components/badge.d.ts +17 -0
  36. package/dist/components/badge.d.ts.map +1 -0
  37. package/dist/components/breadcrumb.d.ts +33 -0
  38. package/dist/components/breadcrumb.d.ts.map +1 -0
  39. package/dist/components/button-group.d.ts +26 -0
  40. package/dist/components/button-group.d.ts.map +1 -0
  41. package/dist/components/button.d.ts +43 -0
  42. package/dist/components/button.d.ts.map +1 -0
  43. package/dist/components/card.d.ts +26 -0
  44. package/dist/components/card.d.ts.map +1 -0
  45. package/dist/components/checkbox-group-context.d.ts +14 -0
  46. package/dist/components/checkbox-group-context.d.ts.map +1 -0
  47. package/dist/components/checkbox-group.d.ts +18 -0
  48. package/dist/components/checkbox-group.d.ts.map +1 -0
  49. package/dist/components/checkbox.d.ts +32 -0
  50. package/dist/components/checkbox.d.ts.map +1 -0
  51. package/dist/components/config-provider.d.ts +29 -0
  52. package/dist/components/config-provider.d.ts.map +1 -0
  53. package/dist/components/container.d.ts +27 -0
  54. package/dist/components/container.d.ts.map +1 -0
  55. package/dist/components/context/form-context.d.ts +41 -0
  56. package/dist/components/context/form-context.d.ts.map +1 -0
  57. package/dist/components/context-menu.d.ts +39 -0
  58. package/dist/components/context-menu.d.ts.map +1 -0
  59. package/dist/components/descriptions.d.ts +40 -0
  60. package/dist/components/descriptions.d.ts.map +1 -0
  61. package/dist/components/dialog.d.ts +55 -0
  62. package/dist/components/dialog.d.ts.map +1 -0
  63. package/dist/components/drawer.d.ts +38 -0
  64. package/dist/components/drawer.d.ts.map +1 -0
  65. package/dist/components/dropdown.d.ts +42 -0
  66. package/dist/components/dropdown.d.ts.map +1 -0
  67. package/dist/components/empty-state.d.ts +24 -0
  68. package/dist/components/empty-state.d.ts.map +1 -0
  69. package/dist/components/form.d.ts +127 -0
  70. package/dist/components/form.d.ts.map +1 -0
  71. package/dist/components/icon.d.ts +16 -0
  72. package/dist/components/icon.d.ts.map +1 -0
  73. package/dist/components/index.cjs +6173 -1482
  74. package/dist/components/index.cjs.map +1 -1
  75. package/dist/components/index.d.ts +59 -1096
  76. package/dist/components/index.d.ts.map +1 -0
  77. package/dist/components/index.js +67 -6
  78. package/dist/components/input.d.ts +28 -0
  79. package/dist/components/input.d.ts.map +1 -0
  80. package/dist/components/label.d.ts +18 -0
  81. package/dist/components/label.d.ts.map +1 -0
  82. package/dist/components/layout.d.ts +34 -0
  83. package/dist/components/layout.d.ts.map +1 -0
  84. package/dist/components/link.d.ts +18 -0
  85. package/dist/components/link.d.ts.map +1 -0
  86. package/dist/components/modal.d.ts +46 -0
  87. package/dist/components/modal.d.ts.map +1 -0
  88. package/dist/components/navigation-menu.d.ts +39 -0
  89. package/dist/components/navigation-menu.d.ts.map +1 -0
  90. package/dist/components/number-input.d.ts +35 -0
  91. package/dist/components/number-input.d.ts.map +1 -0
  92. package/dist/components/otp-input.d.ts +35 -0
  93. package/dist/components/otp-input.d.ts.map +1 -0
  94. package/dist/components/pagination.d.ts +16 -0
  95. package/dist/components/pagination.d.ts.map +1 -0
  96. package/dist/components/popover.d.ts +36 -0
  97. package/dist/components/popover.d.ts.map +1 -0
  98. package/dist/components/progress.d.ts +21 -0
  99. package/dist/components/progress.d.ts.map +1 -0
  100. package/dist/components/radio.d.ts +68 -0
  101. package/dist/components/radio.d.ts.map +1 -0
  102. package/dist/components/scrollbar.d.ts +29 -0
  103. package/dist/components/scrollbar.d.ts.map +1 -0
  104. package/dist/components/select.d.ts +48 -0
  105. package/dist/components/select.d.ts.map +1 -0
  106. package/dist/components/separator.d.ts +28 -0
  107. package/dist/components/separator.d.ts.map +1 -0
  108. package/dist/components/sheet.d.ts +24 -0
  109. package/dist/components/sheet.d.ts.map +1 -0
  110. package/dist/components/sidebar.d.ts +48 -0
  111. package/dist/components/sidebar.d.ts.map +1 -0
  112. package/dist/components/skeleton.d.ts +16 -0
  113. package/dist/components/skeleton.d.ts.map +1 -0
  114. package/dist/components/slider.d.ts +44 -0
  115. package/dist/components/slider.d.ts.map +1 -0
  116. package/dist/components/space.d.ts +19 -0
  117. package/dist/components/space.d.ts.map +1 -0
  118. package/dist/components/spinner.d.ts +18 -0
  119. package/dist/components/spinner.d.ts.map +1 -0
  120. package/dist/components/splitter.d.ts +51 -0
  121. package/dist/components/splitter.d.ts.map +1 -0
  122. package/dist/components/statistic.d.ts +30 -0
  123. package/dist/components/statistic.d.ts.map +1 -0
  124. package/dist/components/steps.d.ts +33 -0
  125. package/dist/components/steps.d.ts.map +1 -0
  126. package/dist/components/switch.d.ts +49 -0
  127. package/dist/components/switch.d.ts.map +1 -0
  128. package/dist/components/table.d.ts +32 -0
  129. package/dist/components/table.d.ts.map +1 -0
  130. package/dist/components/tabs.d.ts +27 -0
  131. package/dist/components/tabs.d.ts.map +1 -0
  132. package/dist/components/tag.d.ts +27 -0
  133. package/dist/components/tag.d.ts.map +1 -0
  134. package/dist/components/text.d.ts +16 -0
  135. package/dist/components/text.d.ts.map +1 -0
  136. package/dist/components/textarea.d.ts +26 -0
  137. package/dist/components/textarea.d.ts.map +1 -0
  138. package/dist/components/toast.d.ts +26 -0
  139. package/dist/components/toast.d.ts.map +1 -0
  140. package/dist/components/tooltip.d.ts +29 -0
  141. package/dist/components/tooltip.d.ts.map +1 -0
  142. package/dist/hooks/index.cjs +228 -27
  143. package/dist/hooks/index.cjs.map +1 -1
  144. package/dist/hooks/index.d.ts +19 -231
  145. package/dist/hooks/index.d.ts.map +1 -0
  146. package/dist/hooks/index.js +1 -1
  147. package/dist/hooks/use-click-outside.d.ts +9 -0
  148. package/dist/hooks/use-click-outside.d.ts.map +1 -0
  149. package/dist/hooks/use-copy-to-clipboard.d.ts +12 -0
  150. package/dist/hooks/use-copy-to-clipboard.d.ts.map +1 -0
  151. package/dist/hooks/use-debounce.d.ts +7 -0
  152. package/dist/hooks/use-debounce.d.ts.map +1 -0
  153. package/dist/hooks/use-escape-key.d.ts +10 -0
  154. package/dist/hooks/use-escape-key.d.ts.map +1 -0
  155. package/dist/hooks/use-event-listener.d.ts +28 -0
  156. package/dist/hooks/use-event-listener.d.ts.map +1 -0
  157. package/dist/hooks/use-form.d.ts +48 -0
  158. package/dist/hooks/use-form.d.ts.map +1 -0
  159. package/dist/hooks/use-hotkeys.d.ts +30 -0
  160. package/dist/hooks/use-hotkeys.d.ts.map +1 -0
  161. package/dist/hooks/use-interval.d.ts +19 -0
  162. package/dist/hooks/use-interval.d.ts.map +1 -0
  163. package/dist/hooks/use-local-storage.d.ts +9 -0
  164. package/dist/hooks/use-local-storage.d.ts.map +1 -0
  165. package/dist/hooks/use-media-query.d.ts +8 -0
  166. package/dist/hooks/use-media-query.d.ts.map +1 -0
  167. package/dist/hooks/use-mounted.d.ts +18 -0
  168. package/dist/hooks/use-mounted.d.ts.map +1 -0
  169. package/dist/hooks/use-pagination.d.ts +36 -0
  170. package/dist/hooks/use-pagination.d.ts.map +1 -0
  171. package/dist/hooks/use-timeout.d.ts +19 -0
  172. package/dist/hooks/use-timeout.d.ts.map +1 -0
  173. package/dist/hooks/use-toggle.d.ts +9 -0
  174. package/dist/hooks/use-toggle.d.ts.map +1 -0
  175. package/dist/index.cjs +6475 -1768
  176. package/dist/index.cjs.map +1 -1
  177. package/dist/index.d.ts +73 -294
  178. package/dist/index.d.ts.map +1 -0
  179. package/dist/index.js +64 -184
  180. package/dist/index.js.map +1 -1
  181. package/dist/internal/button-group-context.d.ts +11 -0
  182. package/dist/internal/button-group-context.d.ts.map +1 -0
  183. package/dist/internal/cn.d.ts +8 -0
  184. package/dist/internal/cn.d.ts.map +1 -0
  185. package/dist/internal/use-overlay-focus.d.ts +8 -0
  186. package/dist/internal/use-overlay-focus.d.ts.map +1 -0
  187. package/dist/internal/use-portal-container.d.ts +2 -0
  188. package/dist/internal/use-portal-container.d.ts.map +1 -0
  189. package/dist/labs/file-preview.d.ts +44 -0
  190. package/dist/labs/file-preview.d.ts.map +1 -0
  191. package/dist/labs/index.cjs +191 -1
  192. package/dist/labs/index.cjs.map +1 -1
  193. package/dist/labs/index.d.ts +8 -6
  194. package/dist/labs/index.d.ts.map +1 -0
  195. package/dist/labs/index.js +180 -1
  196. package/dist/labs/index.js.map +1 -1
  197. package/dist/labs/model-card.d.ts +50 -0
  198. package/dist/labs/model-card.d.ts.map +1 -0
  199. package/dist/patterns/admin-shell.d.ts +52 -0
  200. package/dist/patterns/admin-shell.d.ts.map +1 -0
  201. package/dist/patterns/confirm-dialog.d.ts +50 -0
  202. package/dist/patterns/confirm-dialog.d.ts.map +1 -0
  203. package/dist/patterns/copy-field.d.ts +29 -0
  204. package/dist/patterns/copy-field.d.ts.map +1 -0
  205. package/dist/patterns/index.cjs +699 -251
  206. package/dist/patterns/index.cjs.map +1 -1
  207. package/dist/patterns/index.d.ts +5 -158
  208. package/dist/patterns/index.d.ts.map +1 -0
  209. package/dist/patterns/index.js +137 -82
  210. package/dist/patterns/index.js.map +1 -1
  211. package/dist/patterns/page-header.d.ts +37 -0
  212. package/dist/patterns/page-header.d.ts.map +1 -0
  213. package/dist/primitives/index.cjs +1889 -112
  214. package/dist/primitives/index.cjs.map +1 -1
  215. package/dist/primitives/index.d.ts +22 -135
  216. package/dist/primitives/index.d.ts.map +1 -0
  217. package/dist/primitives/index.js +55 -4
  218. package/dist/styles.css +2819 -953
  219. package/dist/theme.cjs +161 -0
  220. package/dist/theme.cjs.map +1 -0
  221. package/dist/theme.d.ts +39 -0
  222. package/dist/theme.d.ts.map +1 -0
  223. package/dist/theme.js +19 -0
  224. package/dist/theme.js.map +1 -0
  225. package/dist/themes/default.css +80 -0
  226. package/dist/themes/mecha.css +195 -0
  227. package/dist/themes/minimal.css +160 -0
  228. package/dist/tokens.css +1173 -18
  229. package/package.json +22 -12
  230. package/dist/blocks/index.d.cts +0 -86
  231. package/dist/button-CaLZig8j.d.cts +0 -22
  232. package/dist/button-CaLZig8j.d.ts +0 -22
  233. package/dist/chunk-2IVRUJKO.js +0 -377
  234. package/dist/chunk-2IVRUJKO.js.map +0 -1
  235. package/dist/chunk-73WQAE3E.js +0 -3003
  236. package/dist/chunk-73WQAE3E.js.map +0 -1
  237. package/dist/chunk-MGXIF756.js +0 -313
  238. package/dist/chunk-MGXIF756.js.map +0 -1
  239. package/dist/chunk-RUDEZA5Q.js +0 -62
  240. package/dist/chunk-RUDEZA5Q.js.map +0 -1
  241. package/dist/chunk-S45GP6IB.js +0 -254
  242. package/dist/chunk-S45GP6IB.js.map +0 -1
  243. package/dist/components/index.d.cts +0 -1097
  244. package/dist/hooks/index.d.cts +0 -232
  245. package/dist/index.d.cts +0 -297
  246. package/dist/labs/index.d.cts +0 -12
  247. package/dist/patterns/index.d.cts +0 -158
  248. package/dist/primitives/index.d.cts +0 -137
  249. package/dist/sidebar-vl00Z2o-.d.cts +0 -93
  250. package/dist/sidebar-vl00Z2o-.d.ts +0 -93
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/hooks/index.ts","../../src/hooks/use-debounce.ts","../../src/hooks/use-local-storage.ts","../../src/hooks/use-media-query.ts","../../src/hooks/use-click-outside.ts","../../src/hooks/use-copy-to-clipboard.ts","../../src/hooks/use-toggle.ts","../../src/hooks/use-pagination.ts","../../src/hooks/use-form.ts","../../src/hooks/use-mounted.ts","../../src/hooks/use-interval.ts","../../src/hooks/use-timeout.ts","../../src/hooks/use-hotkeys.ts","../../src/hooks/use-event-listener.ts"],"sourcesContent":["\"use client\"\n\n/**\n * @description: @ug666/ui-react/hooks 子入口 — 所有 Hooks 统一导出\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-17\n */\nexport { useDebounce } from './use-debounce'\nexport {\n useLocalStorage,\n type UseLocalStorageReturn,\n type SetLocalStorageValue,\n} from './use-local-storage'\nexport { useMediaQuery } from './use-media-query'\nexport { useClickOutside } from './use-click-outside'\nexport { useCopyToClipboard, type UseCopyToClipboardReturn } from './use-copy-to-clipboard'\nexport { useToggle, type UseToggleReturn } from './use-toggle'\nexport {\n usePagination,\n type UsePaginationOptions,\n type UsePaginationReturn,\n} from './use-pagination'\nexport { useForm, type UseFormErrors, type UseFormReturn } from './use-form'\nexport { useMounted } from './use-mounted'\nexport { useInterval } from './use-interval'\nexport { useTimeout } from './use-timeout'\nexport { useHotkeys, type UseHotkeysOptions } from './use-hotkeys'\nexport { useEventListener } from './use-event-listener'\n","/**\n * @description: 防抖 hook\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useState, useEffect } from 'react'\n\n/**\n * 防抖值,延迟 delay 毫秒后才更新\n * @example\n * const keyword = useDebounce(inputValue, 300)\n */\nexport function useDebounce<T>(value: T, delay = 300): T {\n const [debounced, setDebounced] = useState(value)\n\n useEffect(() => {\n const timer = setTimeout(() => setDebounced(value), delay)\n return () => clearTimeout(timer)\n }, [value, delay])\n\n return debounced\n}\n","/**\n * @description: localStorage 持久化 hook\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useState, useCallback } from 'react'\n\nexport type SetLocalStorageValue<T> = (value: T | ((prev: T) => T)) => void\nexport type UseLocalStorageReturn<T> = [T, SetLocalStorageValue<T>, () => void]\n\n/**\n * 自动读写 localStorage 的 useState\n * @example\n * const [token, setToken, removeToken] = useLocalStorage('token', '')\n */\nexport function useLocalStorage<T>(key: string, initialValue: T): UseLocalStorageReturn<T> {\n const [storedValue, setStoredValue] = useState<T>(() => {\n if (typeof window === 'undefined') return initialValue\n try {\n const item = window.localStorage.getItem(key)\n return item ? (JSON.parse(item) as T) : initialValue\n } catch {\n return initialValue\n }\n })\n\n const setValue = useCallback((value: T | ((prev: T) => T)) => {\n setStoredValue(prev => {\n const next = value instanceof Function ? value(prev) : value\n if (typeof window !== 'undefined') {\n window.localStorage.setItem(key, JSON.stringify(next))\n }\n return next\n })\n }, [key])\n\n const removeValue = useCallback(() => {\n setStoredValue(initialValue)\n if (typeof window !== 'undefined') {\n window.localStorage.removeItem(key)\n }\n }, [key, initialValue])\n\n return [storedValue, setValue, removeValue]\n}\n","/**\n * @description: CSS media query 监听 hook\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useState, useEffect } from 'react'\n\n/**\n * 监听 CSS media query 变化,返回当前是否匹配\n * @example\n * const isMobile = useMediaQuery('(max-width: 768px)')\n * const prefersDark = useMediaQuery('(prefers-color-scheme: dark)')\n */\nexport function useMediaQuery(query: string): boolean {\n const [matches, setMatches] = useState<boolean>(() => {\n if (typeof window === 'undefined') return false\n return window.matchMedia(query).matches\n })\n\n useEffect(() => {\n if (typeof window === 'undefined') return\n\n const mediaQueryList = window.matchMedia(query)\n setMatches(mediaQueryList.matches)\n\n const handleChange = (event: MediaQueryListEvent) => {\n setMatches(event.matches)\n }\n\n mediaQueryList.addEventListener('change', handleChange)\n return () => mediaQueryList.removeEventListener('change', handleChange)\n }, [query])\n\n return matches\n}\n","/**\n * @description: 点击元素外部触发回调的 hook\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useEffect } from 'react'\nimport type { RefObject } from 'react'\n\n/**\n * 点击 ref 元素外部时触发 handler\n * @example\n * const ref = useRef<HTMLDivElement>(null)\n * useClickOutside(ref, () => setOpen(false))\n */\nexport function useClickOutside<T extends HTMLElement>(\n ref: RefObject<T | null>,\n handler: () => void,\n): void {\n useEffect(() => {\n const handleMouseDown = (event: MouseEvent) => {\n if (ref.current && !ref.current.contains(event.target as Node)) {\n handler()\n }\n }\n\n const handleTouchStart = (event: TouchEvent) => {\n if (ref.current && !ref.current.contains(event.target as Node)) {\n handler()\n }\n }\n\n document.addEventListener('mousedown', handleMouseDown)\n document.addEventListener('touchstart', handleTouchStart)\n\n return () => {\n document.removeEventListener('mousedown', handleMouseDown)\n document.removeEventListener('touchstart', handleTouchStart)\n }\n }, [ref, handler])\n}\n","/**\n * @description: 复制文本到剪贴板的 hook\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useCallback, useEffect, useRef, useState } from 'react'\n\nexport interface UseCopyToClipboardReturn {\n copied: boolean\n copy: (text: string) => Promise<void>\n}\n\n/**\n * 复制文本到剪贴板,copied 状态 2 秒后自动重置\n * @example\n * const { copied, copy } = useCopyToClipboard()\n * <button onClick={() => copy('hello')}>{copied ? '已复制' : '复制'}</button>\n */\nexport function useCopyToClipboard(): UseCopyToClipboardReturn {\n const [copied, setCopied] = useState(false)\n const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null)\n\n useEffect(() => {\n return () => {\n if (timerRef.current) {\n clearTimeout(timerRef.current)\n }\n }\n }, [])\n\n const copy = useCallback(async (text: string) => {\n if (typeof navigator === 'undefined' || !navigator.clipboard) {\n console.error('剪贴板 API 不可用')\n return\n }\n\n try {\n await navigator.clipboard.writeText(text)\n setCopied(true)\n if (timerRef.current) {\n clearTimeout(timerRef.current)\n }\n // 2 秒后自动重置状态\n timerRef.current = setTimeout(() => setCopied(false), 2000)\n } catch (error) {\n console.error('复制到剪贴板失败:', error)\n }\n }, [])\n\n return { copied, copy }\n}\n","/**\n * @description: 布尔值切换 hook\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useState, useCallback } from 'react'\n\nexport type UseToggleReturn = [boolean, () => void, (value: boolean) => void]\n\n/**\n * 简单的布尔值切换,返回 [value, toggle, setValue]\n * @example\n * const [isOpen, toggleOpen, setIsOpen] = useToggle(false)\n * <button onClick={toggleOpen}>切换</button>\n */\nexport function useToggle(\n initial = false,\n): UseToggleReturn {\n const [value, setValue] = useState(initial)\n\n const toggle = useCallback(() => {\n setValue(prev => !prev)\n }, [])\n\n return [value, toggle, setValue]\n}\n","/**\n * @description: 分页状态管理 hook\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useCallback, useEffect, useMemo, useState } from 'react'\n\nexport interface UsePaginationOptions {\n /** 数据总条数 */\n total: number\n /** 每页条数,默认 10 */\n pageSize?: number\n /** 初始页码,默认 1 */\n initialPage?: number\n}\n\nexport interface UsePaginationReturn {\n /** 当前页码 (从 1 开始) */\n page: number\n /** 总页数 */\n totalPages: number\n /** 跳转到指定页 */\n setPage: (p: number) => void\n /** 下一页 */\n nextPage: () => void\n /** 上一页 */\n prevPage: () => void\n /** 是否有下一页 */\n hasNext: boolean\n /** 是否有上一页 */\n hasPrev: boolean\n /** 当前页起始索引 (0-based,用于切片) */\n startIndex: number\n /** 当前页结束索引 (exclusive,用于切片) */\n endIndex: number\n}\n\n/**\n * 分页状态管理,提供页码、边界判断和数据切片索引\n * @example\n * const { page, totalPages, nextPage, prevPage, startIndex, endIndex } = usePagination({ total: 100, pageSize: 10 })\n * const pageData = data.slice(startIndex, endIndex)\n */\nexport function usePagination({\n total,\n pageSize = 10,\n initialPage = 1,\n}: UsePaginationOptions): UsePaginationReturn {\n const totalPages = useMemo(\n () => Math.max(1, Math.ceil(total / pageSize)),\n [total, pageSize],\n )\n\n const [page, setPageState] = useState(() =>\n Math.min(Math.max(1, initialPage), Math.max(1, Math.ceil(total / pageSize))),\n )\n\n useEffect(() => {\n setPageState(prev => Math.min(prev, totalPages))\n }, [totalPages])\n\n const setPage = useCallback(\n (p: number) => {\n setPageState(Math.min(Math.max(1, p), totalPages))\n },\n [totalPages],\n )\n\n const nextPage = useCallback(() => {\n setPageState(prev => Math.min(prev + 1, totalPages))\n }, [totalPages])\n\n const prevPage = useCallback(() => {\n setPageState(prev => Math.max(prev - 1, 1))\n }, [])\n\n const startIndex = (page - 1) * pageSize\n const endIndex = Math.min(startIndex + pageSize, total)\n\n return {\n page,\n totalPages,\n setPage,\n nextPage,\n prevPage,\n hasNext: page < totalPages,\n hasPrev: page > 1,\n startIndex,\n endIndex,\n }\n}\n","/**\n * @description: 极简表单状态管理 hook,不依赖第三方库\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useState, useCallback, useMemo } from 'react'\n\nexport type UseFormErrors<T extends Record<string, unknown>> = Partial<Record<keyof T, string>>\n\nexport interface UseFormReturn<T extends Record<string, unknown>> {\n /** 当前表单值 */\n values: T\n /** 字段错误信息 */\n errors: UseFormErrors<T>\n /** 更新单个字段值 */\n handleChange: <K extends keyof T>(name: K, value: T[K]) => void\n /** 设置字段错误 */\n setError: (name: keyof T, message: string) => void\n /** 清除所有错误 */\n clearErrors: () => void\n /** 重置表单到初始值 */\n reset: () => void\n /** 表单是否被修改过 */\n isDirty: boolean\n}\n\n/**\n * 极简表单状态管理,提供值管理、错误处理和脏状态检测\n * @example\n * const form = useForm({ username: '', password: '' })\n * <input value={form.values.username} onChange={e => form.handleChange('username', e.target.value)} />\n * {form.errors.username && <span>{form.errors.username}</span>}\n */\nexport function useForm<T extends Record<string, unknown>>(\n initialValues: T,\n): UseFormReturn<T> {\n const [values, setValues] = useState<T>(initialValues)\n const [errors, setErrors] = useState<UseFormErrors<T>>({})\n\n const isDirty = useMemo(\n () =>\n (Object.keys(initialValues) as (keyof T)[]).some(\n key => values[key] !== initialValues[key],\n ),\n [values, initialValues],\n )\n\n const handleChange = useCallback(<K extends keyof T>(name: K, value: T[K]) => {\n setValues(prev => ({ ...prev, [name]: value }))\n // 修改字段时清除该字段的错误\n setErrors(prev => {\n if (!prev[name]) return prev\n const next = { ...prev }\n delete next[name]\n return next\n })\n }, [])\n\n const setError = useCallback((name: keyof T, message: string) => {\n setErrors(prev => ({ ...prev, [name]: message }))\n }, [])\n\n const clearErrors = useCallback(() => {\n setErrors({})\n }, [])\n\n const reset = useCallback(() => {\n setValues(initialValues)\n setErrors({})\n }, [initialValues])\n\n return { values, errors, handleChange, setError, clearErrors, reset, isDirty }\n}\n","/**\n * @description: 组件挂载状态 hook — 用于避免 SSR 环境下的 hydration 报错\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-17\n */\nimport { useState, useEffect } from 'react'\n\n/**\n * 返回组件是否已在客户端挂载完成。\n *\n * 在 SSR 场景中,服务端渲染时始终返回 false,\n * 客户端 hydration 完成后变为 true,可用于条件渲染仅客户端内容。\n *\n * @returns 组件是否已挂载\n *\n * @example\n * ```tsx\n * const isMounted = useMounted()\n *\n * if (!isMounted) return null // 服务端不渲染\n * return <ClientOnlyComponent />\n * ```\n */\nexport function useMounted(): boolean {\n const [mounted, setMounted] = useState(false)\n\n useEffect(() => {\n setMounted(true)\n }, [])\n\n return mounted\n}\n","/**\n * @description: 定时间隔 hook — delay 为 null 时暂停,支持动态调整间隔\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-17\n */\nimport { useEffect, useRef } from 'react'\n\n/**\n * 以指定间隔重复调用回调函数。\n *\n * 当 delay 为 null 时定时器自动暂停,可动态修改 delay 或 callback。\n * 参考 Dan Abramov 的 useInterval 实现,使用 ref 保持 callback 最新引用。\n *\n * @param callback 每次触发时调用的函数\n * @param delay 间隔毫秒数;传入 null 则暂停定时器\n *\n * @example\n * ```tsx\n * const [count, setCount] = useState(0)\n * const [running, setRunning] = useState(true)\n *\n * useInterval(() => setCount(c => c + 1), running ? 1000 : null)\n * ```\n */\nexport function useInterval(callback: () => void, delay: number | null): void {\n const savedCallback = useRef<() => void>(callback)\n\n // 每次渲染都更新 ref,确保 callback 始终最新\n useEffect(() => {\n savedCallback.current = callback\n }, [callback])\n\n useEffect(() => {\n if (delay === null) return\n const id = setInterval(() => savedCallback.current(), delay)\n return () => clearInterval(id)\n }, [delay])\n}\n","/**\n * @description: 延迟执行 hook — delay 为 null 时暂停,组件卸载自动清理\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-17\n */\nimport { useEffect, useRef } from 'react'\n\n/**\n * 在指定延迟后执行一次回调函数。\n *\n * 当 delay 为 null 时定时器不启动(暂停模式)。\n * 每次 delay 变化都会重置定时器;组件卸载时自动清理。\n *\n * @param callback 延迟结束后调用的函数\n * @param delay 延迟毫秒数;传入 null 则不执行\n *\n * @example\n * ```tsx\n * const [show, setShow] = useState(true)\n *\n * // 3 秒后自动隐藏提示\n * useTimeout(() => setShow(false), show ? 3000 : null)\n * ```\n */\nexport function useTimeout(callback: () => void, delay: number | null): void {\n const savedCallback = useRef<() => void>(callback)\n\n // 每次渲染都更新 ref,确保 callback 始终最新\n useEffect(() => {\n savedCallback.current = callback\n }, [callback])\n\n useEffect(() => {\n if (delay === null) return\n const id = setTimeout(() => savedCallback.current(), delay)\n return () => clearTimeout(id)\n }, [delay])\n}\n","/**\n * @description: 快捷键绑定 hook — 支持 \"ctrl+k\"、\"cmd+s\"、\"escape\" 等组合键\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-17\n */\nimport { useEffect, useRef } from 'react'\n\nexport interface UseHotkeysOptions {\n /** 是否阻止默认浏览器行为,默认 false */\n preventDefault?: boolean\n /** 监听目标,默认 window */\n target?: HTMLElement | null\n}\n\n/**\n * 解析快捷键字符串,返回规范化的修饰键 + 主键结构。\n * 支持 ctrl/cmd/alt/shift + 任意按键,键名不区分大小写。\n * \"cmd\" 在 Mac 映射为 Meta,Windows 同样可响应 Meta 键。\n */\nfunction parseHotkey(keys: string): {\n ctrl: boolean\n meta: boolean\n alt: boolean\n shift: boolean\n key: string\n} {\n const parts = keys.toLowerCase().split('+').map((s) => s.trim())\n const ctrl = parts.includes('ctrl')\n const meta = parts.includes('cmd') || parts.includes('meta')\n const alt = parts.includes('alt')\n const shift = parts.includes('shift')\n const key = parts.find(\n (p) => !['ctrl', 'cmd', 'meta', 'alt', 'shift'].includes(p),\n ) ?? ''\n\n return { ctrl, meta, alt, shift, key }\n}\n\n/**\n * 将快捷键字符串绑定到回调函数。\n *\n * 支持修饰键组合:ctrl、cmd(Meta)、alt、shift,加主键(不区分大小写)。\n * 组件卸载时自动解绑。\n *\n * @param keys 快捷键字符串,如 \"ctrl+k\"、\"cmd+s\"、\"escape\"\n * @param callback 触发时调用的函数\n * @param options 额外配置项\n *\n * @example\n * ```tsx\n * // 全局搜索快捷键\n * useHotkeys('ctrl+k', () => setSearchOpen(true), { preventDefault: true })\n *\n * // ESC 关闭弹窗\n * useHotkeys('escape', () => setOpen(false))\n *\n * // 仅在特定元素内响应\n * useHotkeys('ctrl+enter', handleSubmit, { target: formRef.current })\n * ```\n */\nexport function useHotkeys(\n keys: string,\n callback: (event: KeyboardEvent) => void,\n options: UseHotkeysOptions = {},\n): void {\n const { preventDefault = false, target = null } = options\n const savedCallback = useRef<(event: KeyboardEvent) => void>(callback)\n\n useEffect(() => {\n savedCallback.current = callback\n }, [callback])\n\n useEffect(() => {\n const parsed = parseHotkey(keys)\n const eventTarget: EventTarget = target ?? window\n\n function handler(event: KeyboardEvent): void {\n const eventKey = event.key.toLowerCase()\n const match =\n eventKey === parsed.key &&\n event.ctrlKey === parsed.ctrl &&\n event.metaKey === parsed.meta &&\n event.altKey === parsed.alt &&\n event.shiftKey === parsed.shift\n\n if (match) {\n if (preventDefault) event.preventDefault()\n savedCallback.current(event)\n }\n }\n\n eventTarget.addEventListener('keydown', handler as EventListener)\n return () => {\n eventTarget.removeEventListener('keydown', handler as EventListener)\n }\n }, [keys, preventDefault, target])\n}\n","/**\n * @description: 事件监听 hook — 自动管理事件绑定与清理,支持 Window/Document/HTMLElement\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-17\n */\nimport { useEffect, useRef } from 'react'\n\n/**\n * 在指定目标上绑定事件监听器,组件卸载时自动清理。\n *\n * 支持三种目标类型:\n * - 不传 target → 默认监听 window\n * - 传入 HTMLElement → 监听该元素\n * - 传入 null → 跳过绑定(适合 ref 未初始化的场景)\n *\n * @typeParam K WindowEventMap 中的事件名称\n * @param event 事件名称,如 \"scroll\"、\"resize\"、\"click\"\n * @param handler 事件处理函数\n * @param target 监听目标;默认 window;传 null 跳过绑定\n *\n * @example\n * ```tsx\n * // 监听全局滚动\n * useEventListener('scroll', () => setScrollY(window.scrollY))\n *\n * // 监听特定元素的点击\n * const divRef = useRef<HTMLDivElement>(null)\n * useEventListener('click', handleClick, divRef.current)\n *\n * // 传入 null 跳过(ref 尚未挂载时)\n * useEventListener('mouseenter', onEnter, ref.current)\n * ```\n */\nexport function useEventListener<K extends keyof WindowEventMap>(\n event: K,\n handler: (event: WindowEventMap[K]) => void,\n target?: EventTarget | null,\n): void {\n const savedHandler = useRef<(event: WindowEventMap[K]) => void>(handler)\n\n useEffect(() => {\n savedHandler.current = handler\n }, [handler])\n\n useEffect(() => {\n // target 显式传入 null 时跳过绑定\n if (target === null) return\n const eventTarget: EventTarget = target ?? window\n\n function listener(event: Event): void {\n savedHandler.current(event as WindowEventMap[K])\n }\n\n eventTarget.addEventListener(event, listener)\n return () => {\n eventTarget.removeEventListener(event, listener)\n }\n }, [event, target])\n}\n"],"mappings":"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","names":["import_react","import_react","import_react","import_react","import_react","import_react","import_react","import_react","import_react","import_react","import_react","import_react","event"]}
1
+ {"version":3,"sources":["../../src/hooks/index.ts","../../src/hooks/use-debounce.ts","../../src/hooks/use-local-storage.ts","../../src/hooks/use-media-query.ts","../../src/hooks/use-click-outside.ts","../../src/hooks/use-copy-to-clipboard.ts","../../src/hooks/use-toggle.ts","../../src/hooks/use-pagination.ts","../../src/hooks/use-form.ts","../../src/hooks/use-mounted.ts","../../src/hooks/use-interval.ts","../../src/hooks/use-timeout.ts","../../src/hooks/use-hotkeys.ts","../../src/hooks/use-event-listener.ts"],"sourcesContent":["\"use client\"\n\n/**\n * @description: @ug666/ui-react/hooks 子入口 — 所有 Hooks 统一导出\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-17\n */\nexport { useDebounce } from './use-debounce'\nexport {\n useLocalStorage,\n type UseLocalStorageReturn,\n type SetLocalStorageValue,\n} from './use-local-storage'\nexport { useMediaQuery } from './use-media-query'\nexport { useClickOutside } from './use-click-outside'\nexport { useCopyToClipboard, type UseCopyToClipboardReturn } from './use-copy-to-clipboard'\nexport { useToggle, type UseToggleReturn } from './use-toggle'\nexport {\n usePagination,\n type UsePaginationOptions,\n type UsePaginationReturn,\n} from './use-pagination'\nexport {\n useForm,\n type UseFormErrors,\n type UseFormOptions,\n type UseFormReturn,\n type UseFormTouched,\n} from './use-form'\nexport type {\n FormFieldRules,\n FormRule,\n FormRules,\n FormValidationTrigger,\n FormValueType,\n} from '@ug666/ui-core'\nexport { useMounted } from './use-mounted'\nexport { useInterval } from './use-interval'\nexport { useTimeout } from './use-timeout'\nexport { useHotkeys, type UseHotkeysOptions } from './use-hotkeys'\nexport { useEventListener } from './use-event-listener'\n","/**\n * @description: 防抖 hook\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useState, useEffect } from 'react'\n\n/**\n * 防抖值,延迟 delay 毫秒后才更新\n * @example\n * const keyword = useDebounce(inputValue, 300)\n */\nexport function useDebounce<T>(value: T, delay = 300): T {\n const [debounced, setDebounced] = useState(value)\n\n useEffect(() => {\n const timer = setTimeout(() => setDebounced(value), delay)\n return () => clearTimeout(timer)\n }, [value, delay])\n\n return debounced\n}\n","/**\n * @description: localStorage 持久化 hook\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useState, useCallback } from 'react'\n\nexport type SetLocalStorageValue<T> = (value: T | ((prev: T) => T)) => void\nexport type UseLocalStorageReturn<T> = [T, SetLocalStorageValue<T>, () => void]\n\n/**\n * 自动读写 localStorage 的 useState\n * @example\n * const [token, setToken, removeToken] = useLocalStorage('token', '')\n */\nexport function useLocalStorage<T>(key: string, initialValue: T): UseLocalStorageReturn<T> {\n const [storedValue, setStoredValue] = useState<T>(() => {\n if (typeof window === 'undefined') return initialValue\n try {\n const item = window.localStorage.getItem(key)\n return item ? (JSON.parse(item) as T) : initialValue\n } catch {\n return initialValue\n }\n })\n\n const setValue = useCallback((value: T | ((prev: T) => T)) => {\n setStoredValue(prev => {\n const next = value instanceof Function ? value(prev) : value\n if (typeof window !== 'undefined') {\n try {\n window.localStorage.setItem(key, JSON.stringify(next))\n } catch {\n // 存储不可用时仍保留当前会话内的 React 状态。\n }\n }\n return next\n })\n }, [key])\n\n const removeValue = useCallback(() => {\n setStoredValue(initialValue)\n if (typeof window !== 'undefined') {\n try {\n window.localStorage.removeItem(key)\n } catch {\n // 存储不可用时仍完成当前会话内的状态重置。\n }\n }\n }, [key, initialValue])\n\n return [storedValue, setValue, removeValue]\n}\n","/**\n * @description: CSS media query 监听 hook\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useState, useEffect } from 'react'\n\n/**\n * 监听 CSS media query 变化,返回当前是否匹配\n * @example\n * const isMobile = useMediaQuery('(max-width: 768px)')\n * const prefersDark = useMediaQuery('(prefers-color-scheme: dark)')\n */\nexport function useMediaQuery(query: string): boolean {\n const [matches, setMatches] = useState<boolean>(() => {\n if (typeof window === 'undefined') return false\n return window.matchMedia(query).matches\n })\n\n useEffect(() => {\n if (typeof window === 'undefined') return\n\n const mediaQueryList = window.matchMedia(query)\n setMatches(mediaQueryList.matches)\n\n const handleChange = (event: MediaQueryListEvent) => {\n setMatches(event.matches)\n }\n\n mediaQueryList.addEventListener('change', handleChange)\n return () => mediaQueryList.removeEventListener('change', handleChange)\n }, [query])\n\n return matches\n}\n","/**\n * @description: 点击元素外部触发回调的 hook\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useEffect } from 'react'\nimport type { RefObject } from 'react'\n\n/**\n * 点击 ref 元素外部时触发 handler\n * @example\n * const ref = useRef<HTMLDivElement>(null)\n * useClickOutside(ref, () => setOpen(false))\n */\nexport function useClickOutside<T extends HTMLElement>(\n ref: RefObject<T | null>,\n handler: () => void,\n): void {\n useEffect(() => {\n const handleMouseDown = (event: MouseEvent) => {\n if (ref.current && !ref.current.contains(event.target as Node)) {\n handler()\n }\n }\n\n const handleTouchStart = (event: TouchEvent) => {\n if (ref.current && !ref.current.contains(event.target as Node)) {\n handler()\n }\n }\n\n document.addEventListener('mousedown', handleMouseDown)\n document.addEventListener('touchstart', handleTouchStart)\n\n return () => {\n document.removeEventListener('mousedown', handleMouseDown)\n document.removeEventListener('touchstart', handleTouchStart)\n }\n }, [ref, handler])\n}\n","/**\n * @description: 复制文本到剪贴板的 hook\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useCallback, useEffect, useRef, useState } from 'react'\n\nexport interface UseCopyToClipboardReturn {\n copied: boolean\n copy: (text: string) => Promise<void>\n}\n\n/**\n * 复制文本到剪贴板,copied 状态 2 秒后自动重置\n * @example\n * const { copied, copy } = useCopyToClipboard()\n * <button onClick={() => copy('hello')}>{copied ? '已复制' : '复制'}</button>\n */\nexport function useCopyToClipboard(): UseCopyToClipboardReturn {\n const [copied, setCopied] = useState(false)\n const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null)\n\n useEffect(() => {\n return () => {\n if (timerRef.current) {\n clearTimeout(timerRef.current)\n }\n }\n }, [])\n\n const copy = useCallback(async (text: string) => {\n if (typeof navigator === 'undefined' || !navigator.clipboard) {\n return\n }\n\n try {\n await navigator.clipboard.writeText(text)\n setCopied(true)\n if (timerRef.current) {\n clearTimeout(timerRef.current)\n }\n // 2 秒后自动重置状态\n timerRef.current = setTimeout(() => setCopied(false), 2000)\n } catch {\n setCopied(false)\n }\n }, [])\n\n return { copied, copy }\n}\n","/**\n * @description: 布尔值切换 hook\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useState, useCallback } from 'react'\n\nexport type UseToggleReturn = [boolean, () => void, (value: boolean) => void]\n\n/**\n * 简单的布尔值切换,返回 [value, toggle, setValue]\n * @example\n * const [isOpen, toggleOpen, setIsOpen] = useToggle(false)\n * <button onClick={toggleOpen}>切换</button>\n */\nexport function useToggle(\n initial = false,\n): UseToggleReturn {\n const [value, setValue] = useState(initial)\n\n const toggle = useCallback(() => {\n setValue(prev => !prev)\n }, [])\n\n return [value, toggle, setValue]\n}\n","/**\n * @description: 分页状态管理 hook\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-15\n */\nimport { useCallback, useEffect, useMemo, useState } from 'react'\n\nexport interface UsePaginationOptions {\n /** 数据总条数 */\n total: number\n /** 每页条数,默认 10 */\n pageSize?: number\n /** 初始页码,默认 1 */\n initialPage?: number\n}\n\nexport interface UsePaginationReturn {\n /** 当前页码 (从 1 开始) */\n page: number\n /** 总页数 */\n totalPages: number\n /** 跳转到指定页 */\n setPage: (p: number) => void\n /** 下一页 */\n nextPage: () => void\n /** 上一页 */\n prevPage: () => void\n /** 是否有下一页 */\n hasNext: boolean\n /** 是否有上一页 */\n hasPrev: boolean\n /** 当前页起始索引 (0-based,用于切片) */\n startIndex: number\n /** 当前页结束索引 (exclusive,用于切片) */\n endIndex: number\n}\n\n/**\n * 分页状态管理,提供页码、边界判断和数据切片索引\n * @example\n * const { page, totalPages, nextPage, prevPage, startIndex, endIndex } = usePagination({ total: 100, pageSize: 10 })\n * const pageData = data.slice(startIndex, endIndex)\n */\nexport function usePagination({\n total,\n pageSize = 10,\n initialPage = 1,\n}: UsePaginationOptions): UsePaginationReturn {\n const totalPages = useMemo(\n () => Math.max(1, Math.ceil(total / pageSize)),\n [total, pageSize],\n )\n\n const [page, setPageState] = useState(() =>\n Math.min(Math.max(1, initialPage), Math.max(1, Math.ceil(total / pageSize))),\n )\n\n useEffect(() => {\n setPageState(prev => Math.min(prev, totalPages))\n }, [totalPages])\n\n const setPage = useCallback(\n (p: number) => {\n setPageState(Math.min(Math.max(1, p), totalPages))\n },\n [totalPages],\n )\n\n const nextPage = useCallback(() => {\n setPageState(prev => Math.min(prev + 1, totalPages))\n }, [totalPages])\n\n const prevPage = useCallback(() => {\n setPageState(prev => Math.max(prev - 1, 1))\n }, [])\n\n const startIndex = (page - 1) * pageSize\n const endIndex = Math.min(startIndex + pageSize, total)\n\n return {\n page,\n totalPages,\n setPage,\n nextPage,\n prevPage,\n hasNext: page < totalPages,\n hasPrev: page > 1,\n startIndex,\n endIndex,\n }\n}\n","/**\n * @description: React 表单状态、校验与提交流程管理\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-07-27\n */\nimport {\n useCallback,\n useMemo,\n useRef,\n useState,\n type FormEvent,\n type SetStateAction,\n} from 'react'\nimport {\n validateFormValue,\n type FormRules,\n type FormValidationTrigger,\n} from '@ug666/ui-core'\n\ntype FormFieldName<T extends Record<string, unknown>> = Extract<keyof T, string>\n\nexport type UseFormErrors<T extends Record<string, unknown>> = Partial<Record<keyof T, string>>\nexport type UseFormTouched<T extends Record<string, unknown>> = Partial<Record<keyof T, boolean>>\n\nexport interface UseFormOptions<T extends Record<string, unknown>> {\n rules?: FormRules<T>\n validateOnChange?: boolean\n validateOnBlur?: boolean\n initialErrors?: UseFormErrors<T>\n scrollToError?: boolean\n scrollIntoViewOptions?: ScrollIntoViewOptions\n onValidate?: (name: keyof T, valid: boolean, message?: string) => void\n}\n\nexport interface UseFormReturn<T extends Record<string, unknown>> {\n values: T\n rules: FormRules<T> | undefined\n errors: UseFormErrors<T>\n touched: UseFormTouched<T>\n dirtyFields: UseFormTouched<T>\n validatingFields: UseFormTouched<T>\n isDirty: boolean\n isValid: boolean\n isValidating: boolean\n handleChange: <Key extends keyof T>(name: Key, value: T[Key]) => void\n handleBlur: (name: keyof T) => void\n setFieldValue: <Key extends keyof T>(name: Key, value: T[Key]) => void\n setValues: (values: SetStateAction<T>) => void\n setError: (name: keyof T, message: string) => void\n clearErrors: (names?: keyof T | (keyof T)[]) => void\n clearValidate: (names?: keyof T | (keyof T)[]) => void\n validateField: (name: keyof T, trigger?: FormValidationTrigger) => Promise<boolean>\n validate: (names?: keyof T | (keyof T)[]) => Promise<boolean>\n handleSubmit: (\n callback: (values: T, event: FormEvent<HTMLFormElement>) => void | Promise<void>,\n ) => (event: FormEvent<HTMLFormElement>) => Promise<void>\n reset: (nextValues?: T) => void\n resetFields: (names?: keyof T | (keyof T)[]) => void\n setInitialValues: (values: T) => void\n registerField: (name: keyof T, element: HTMLElement | null) => void\n getField: (name: keyof T) => HTMLElement | undefined\n scrollToField: (name: keyof T, options?: ScrollIntoViewOptions) => void\n scrollToError: (options?: ScrollIntoViewOptions) => void\n}\n\nfunction normalizeFields<T extends Record<string, unknown>>(\n names: keyof T | (keyof T)[] | undefined,\n values: T,\n): (keyof T)[] {\n if (names === undefined) return Object.keys(values) as FormFieldName<T>[]\n return Array.isArray(names) ? names : [names]\n}\n\nexport function useForm<T extends Record<string, unknown>>(\n initialValues: T,\n options: UseFormOptions<T> = {},\n): UseFormReturn<T> {\n const initialValuesRef = useRef<T>({ ...initialValues })\n const [values, setValuesState] = useState<T>(() => ({ ...initialValues }))\n const [errors, setErrors] = useState<UseFormErrors<T>>(options.initialErrors ?? {})\n const [touched, setTouched] = useState<UseFormTouched<T>>({})\n const [validatingFields, setValidatingFields] = useState<UseFormTouched<T>>({})\n const [isValidating, setIsValidating] = useState(false)\n const validationCountRef = useRef(0)\n const validationGenerationRef = useRef(0)\n const validationRunRef = useRef<Partial<Record<keyof T, number>>>({})\n const fieldElementsRef = useRef(new Map<keyof T, HTMLElement>())\n\n const dirtyFields = useMemo(() => {\n const next: UseFormTouched<T> = {}\n for (const name of Object.keys(values) as FormFieldName<T>[]) {\n if (!Object.is(values[name], initialValuesRef.current[name])) next[name] = true\n }\n return next\n }, [values])\n\n const isDirty = Object.keys(dirtyFields).length > 0\n const isValid = Object.keys(errors).length === 0\n\n const beginValidation = useCallback(() => {\n const generation = validationGenerationRef.current\n validationCountRef.current += 1\n setIsValidating(true)\n return generation\n }, [])\n\n const endValidation = useCallback((generation: number) => {\n if (generation !== validationGenerationRef.current) return\n validationCountRef.current = Math.max(0, validationCountRef.current - 1)\n if (validationCountRef.current === 0) setIsValidating(false)\n }, [])\n\n const runFieldValidation = useCallback(async (\n name: keyof T,\n trigger: FormValidationTrigger,\n currentValues: T,\n ): Promise<boolean> => {\n const run = (validationRunRef.current[name] ?? 0) + 1\n validationRunRef.current[name] = run\n setValidatingFields((current) => ({ ...current, [name]: true }))\n const generation = beginValidation()\n\n const message = await validateFormValue(\n currentValues[name],\n options.rules?.[name],\n currentValues,\n trigger,\n )\n\n const isCurrentRun = validationRunRef.current[name] === run\n if (isCurrentRun) {\n setErrors((current) => {\n if (message) return { ...current, [name]: message }\n if (current[name] === undefined) return current\n const next = { ...current }\n delete next[name]\n return next\n })\n setValidatingFields((current) => {\n const next = { ...current }\n delete next[name]\n return next\n })\n options.onValidate?.(name, !message, message)\n }\n\n endValidation(generation)\n return isCurrentRun ? !message : true\n }, [beginValidation, endValidation, options.onValidate, options.rules])\n\n const setFieldValue = useCallback(<Key extends keyof T>(name: Key, value: T[Key]) => {\n setValuesState((current) => {\n const next = { ...current, [name]: value }\n if (options.validateOnChange) void runFieldValidation(name, 'change', next)\n return next\n })\n }, [options.validateOnChange, runFieldValidation])\n\n const handleChange = setFieldValue\n\n const handleBlur = useCallback((name: keyof T) => {\n setTouched((current) => ({ ...current, [name]: true }))\n if (options.validateOnBlur) void runFieldValidation(name, 'blur', values)\n }, [options.validateOnBlur, runFieldValidation, values])\n\n const setValues = useCallback((nextValue: SetStateAction<T>) => {\n setValuesState((current) => (\n typeof nextValue === 'function'\n ? (nextValue as (previous: T) => T)(current)\n : nextValue\n ))\n }, [])\n\n const setError = useCallback((name: keyof T, message: string) => {\n setErrors((current) => ({ ...current, [name]: message }))\n }, [])\n\n const clearErrors = useCallback((names?: keyof T | (keyof T)[]) => {\n if (names === undefined) {\n setErrors({})\n return\n }\n const fields = Array.isArray(names) ? names : [names]\n setErrors((current) => {\n const next = { ...current }\n for (const name of fields) delete next[name]\n return next\n })\n }, [])\n const clearValidate = useCallback((names?: keyof T | (keyof T)[]) => {\n clearErrors(names)\n const fields = names === undefined\n ? Object.keys(validationRunRef.current) as (keyof T)[]\n : Array.isArray(names) ? names : [names]\n for (const name of fields) {\n validationRunRef.current[name] = (validationRunRef.current[name] ?? 0) + 1\n }\n setValidatingFields((current) => {\n if (names === undefined) return {}\n const next = { ...current }\n for (const name of fields) delete next[name]\n return next\n })\n }, [clearErrors])\n\n const registerField = useCallback((name: keyof T, element: HTMLElement | null) => {\n if (element) fieldElementsRef.current.set(name, element)\n else fieldElementsRef.current.delete(name)\n }, [])\n\n const getField = useCallback(\n (name: keyof T) => fieldElementsRef.current.get(name),\n [],\n )\n\n const scrollToField = useCallback((\n name: keyof T,\n scrollOptions: ScrollIntoViewOptions = options.scrollIntoViewOptions ?? {\n behavior: 'smooth',\n block: 'center',\n },\n ) => {\n fieldElementsRef.current.get(name)?.scrollIntoView(scrollOptions)\n }, [options.scrollIntoViewOptions])\n\n const scrollToError = useCallback((\n scrollOptions?: ScrollIntoViewOptions,\n ) => {\n const firstInvalidField = (Object.keys(errors) as FormFieldName<T>[])[0]\n if (firstInvalidField !== undefined) scrollToField(firstInvalidField, scrollOptions)\n }, [errors, scrollToField])\n\n const validateField = useCallback((\n name: keyof T,\n trigger: FormValidationTrigger = 'submit',\n ) => runFieldValidation(name, trigger, values), [runFieldValidation, values])\n\n const validate = useCallback(async (names?: keyof T | (keyof T)[]) => {\n const fields = normalizeFields(names, values)\n const results = await Promise.all(\n fields.map((name) => runFieldValidation(name, 'submit', values)),\n )\n return results.every(Boolean)\n }, [runFieldValidation, values])\n\n const handleSubmit = useCallback((\n callback: (values: T, event: FormEvent<HTMLFormElement>) => void | Promise<void>,\n ) => async (event: FormEvent<HTMLFormElement>) => {\n event.preventDefault()\n setTouched(Object.fromEntries(\n (Object.keys(values) as FormFieldName<T>[]).map((name) => [name, true]),\n ) as UseFormTouched<T>)\n if (await validate()) {\n await callback(values, event)\n return\n }\n if (options.scrollToError) {\n requestAnimationFrame(() => {\n const firstInvalidEntry = [...fieldElementsRef.current.entries()]\n .find(([, element]) => element.dataset.state === 'invalid')\n if (firstInvalidEntry) scrollToField(firstInvalidEntry[0])\n })\n }\n }, [options.scrollToError, scrollToField, validate, values])\n\n const reset = useCallback((nextValues?: T) => {\n if (nextValues) initialValuesRef.current = { ...nextValues }\n setValuesState({ ...(nextValues ?? initialValuesRef.current) })\n setErrors({})\n setTouched({})\n setValidatingFields({})\n for (const name of Object.keys(validationRunRef.current) as (keyof T)[]) {\n validationRunRef.current[name] = (validationRunRef.current[name] ?? 0) + 1\n }\n validationGenerationRef.current += 1\n validationCountRef.current = 0\n setIsValidating(false)\n }, [])\n\n const resetFields = useCallback((names?: keyof T | (keyof T)[]) => {\n if (names === undefined) {\n reset()\n return\n }\n const fields = Array.isArray(names) ? names : [names]\n for (const name of fields) {\n validationRunRef.current[name] = (validationRunRef.current[name] ?? 0) + 1\n }\n setValuesState((current) => {\n const next = { ...current }\n for (const name of fields) next[name] = initialValuesRef.current[name]\n return next\n })\n setErrors((current) => {\n const next = { ...current }\n for (const name of fields) delete next[name]\n return next\n })\n setTouched((current) => {\n const next = { ...current }\n for (const name of fields) delete next[name]\n return next\n })\n setValidatingFields((current) => {\n const next = { ...current }\n for (const name of fields) delete next[name]\n return next\n })\n }, [reset])\n\n const setInitialValues = useCallback((nextValues: T) => {\n initialValuesRef.current = { ...nextValues }\n }, [])\n\n return {\n values,\n rules: options.rules,\n errors,\n touched,\n dirtyFields,\n validatingFields,\n isDirty,\n isValid,\n isValidating,\n handleChange,\n handleBlur,\n setFieldValue,\n setValues,\n setError,\n clearErrors,\n clearValidate,\n validateField,\n validate,\n handleSubmit,\n reset,\n resetFields,\n setInitialValues,\n registerField,\n getField,\n scrollToField,\n scrollToError,\n }\n}\n","/**\n * @description: 组件挂载状态 hook — 用于避免 SSR 环境下的 hydration 报错\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-17\n */\nimport { useState, useEffect } from 'react'\n\n/**\n * 返回组件是否已在客户端挂载完成。\n *\n * 在 SSR 场景中,服务端渲染时始终返回 false,\n * 客户端 hydration 完成后变为 true,可用于条件渲染仅客户端内容。\n *\n * @returns 组件是否已挂载\n *\n * @example\n * ```tsx\n * const isMounted = useMounted()\n *\n * if (!isMounted) return null // 服务端不渲染\n * return <ClientOnlyComponent />\n * ```\n */\nexport function useMounted(): boolean {\n const [mounted, setMounted] = useState(false)\n\n useEffect(() => {\n setMounted(true)\n }, [])\n\n return mounted\n}\n","/**\n * @description: 定时间隔 hook — delay 为 null 时暂停,支持动态调整间隔\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-17\n */\nimport { useEffect, useRef } from 'react'\n\n/**\n * 以指定间隔重复调用回调函数。\n *\n * 当 delay 为 null 时定时器自动暂停,可动态修改 delay 或 callback。\n * 参考 Dan Abramov 的 useInterval 实现,使用 ref 保持 callback 最新引用。\n *\n * @param callback 每次触发时调用的函数\n * @param delay 间隔毫秒数;传入 null 则暂停定时器\n *\n * @example\n * ```tsx\n * const [count, setCount] = useState(0)\n * const [running, setRunning] = useState(true)\n *\n * useInterval(() => setCount(c => c + 1), running ? 1000 : null)\n * ```\n */\nexport function useInterval(callback: () => void, delay: number | null): void {\n const savedCallback = useRef<() => void>(callback)\n\n // 每次渲染都更新 ref,确保 callback 始终最新\n useEffect(() => {\n savedCallback.current = callback\n }, [callback])\n\n useEffect(() => {\n if (delay === null) return\n const id = setInterval(() => savedCallback.current(), delay)\n return () => clearInterval(id)\n }, [delay])\n}\n","/**\n * @description: 延迟执行 hook — delay 为 null 时暂停,组件卸载自动清理\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-17\n */\nimport { useEffect, useRef } from 'react'\n\n/**\n * 在指定延迟后执行一次回调函数。\n *\n * 当 delay 为 null 时定时器不启动(暂停模式)。\n * 每次 delay 变化都会重置定时器;组件卸载时自动清理。\n *\n * @param callback 延迟结束后调用的函数\n * @param delay 延迟毫秒数;传入 null 则不执行\n *\n * @example\n * ```tsx\n * const [show, setShow] = useState(true)\n *\n * // 3 秒后自动隐藏提示\n * useTimeout(() => setShow(false), show ? 3000 : null)\n * ```\n */\nexport function useTimeout(callback: () => void, delay: number | null): void {\n const savedCallback = useRef<() => void>(callback)\n\n // 每次渲染都更新 ref,确保 callback 始终最新\n useEffect(() => {\n savedCallback.current = callback\n }, [callback])\n\n useEffect(() => {\n if (delay === null) return\n const id = setTimeout(() => savedCallback.current(), delay)\n return () => clearTimeout(id)\n }, [delay])\n}\n","/**\n * @description: 快捷键绑定 hook — 支持 \"ctrl+k\"、\"cmd+s\"、\"escape\" 等组合键\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-17\n */\nimport { useEffect, useRef } from 'react'\n\nexport interface UseHotkeysOptions {\n /** 是否阻止默认浏览器行为,默认 false */\n preventDefault?: boolean\n /** 监听目标,默认 window */\n target?: HTMLElement | null\n}\n\n/**\n * 解析快捷键字符串,返回规范化的修饰键 + 主键结构。\n * 支持 ctrl/cmd/alt/shift + 任意按键,键名不区分大小写。\n * \"cmd\" 在 Mac 映射为 Meta,Windows 同样可响应 Meta 键。\n */\nfunction parseHotkey(keys: string): {\n ctrl: boolean\n meta: boolean\n alt: boolean\n shift: boolean\n key: string\n} {\n const parts = keys.toLowerCase().split('+').map((s) => s.trim())\n const ctrl = parts.includes('ctrl')\n const meta = parts.includes('cmd') || parts.includes('meta')\n const alt = parts.includes('alt')\n const shift = parts.includes('shift')\n const key = parts.find(\n (p) => !['ctrl', 'cmd', 'meta', 'alt', 'shift'].includes(p),\n ) ?? ''\n\n return { ctrl, meta, alt, shift, key }\n}\n\n/**\n * 将快捷键字符串绑定到回调函数。\n *\n * 支持修饰键组合:ctrl、cmd(Meta)、alt、shift,加主键(不区分大小写)。\n * 组件卸载时自动解绑。\n *\n * @param keys 快捷键字符串,如 \"ctrl+k\"、\"cmd+s\"、\"escape\"\n * @param callback 触发时调用的函数\n * @param options 额外配置项\n *\n * @example\n * ```tsx\n * // 全局搜索快捷键\n * useHotkeys('ctrl+k', () => setSearchOpen(true), { preventDefault: true })\n *\n * // ESC 关闭弹窗\n * useHotkeys('escape', () => setOpen(false))\n *\n * // 仅在特定元素内响应\n * useHotkeys('ctrl+enter', handleSubmit, { target: formRef.current })\n * ```\n */\nexport function useHotkeys(\n keys: string,\n callback: (event: KeyboardEvent) => void,\n options: UseHotkeysOptions = {},\n): void {\n const { preventDefault = false, target = null } = options\n const savedCallback = useRef<(event: KeyboardEvent) => void>(callback)\n\n useEffect(() => {\n savedCallback.current = callback\n }, [callback])\n\n useEffect(() => {\n const parsed = parseHotkey(keys)\n const eventTarget: EventTarget = target ?? window\n\n function handler(event: KeyboardEvent): void {\n const eventKey = event.key.toLowerCase()\n const match =\n eventKey === parsed.key &&\n event.ctrlKey === parsed.ctrl &&\n event.metaKey === parsed.meta &&\n event.altKey === parsed.alt &&\n event.shiftKey === parsed.shift\n\n if (match) {\n if (preventDefault) event.preventDefault()\n savedCallback.current(event)\n }\n }\n\n eventTarget.addEventListener('keydown', handler as EventListener)\n return () => {\n eventTarget.removeEventListener('keydown', handler as EventListener)\n }\n }, [keys, preventDefault, target])\n}\n","/**\n * @description: 事件监听 hook — 自动管理事件绑定与清理,支持 Window/Document/HTMLElement\n * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。\n * @date: 2026-04-17\n */\nimport { useEffect, useRef } from 'react'\n\n/**\n * 在指定目标上绑定事件监听器,组件卸载时自动清理。\n *\n * 支持三种目标类型:\n * - 不传 target → 默认监听 window\n * - 传入 HTMLElement → 监听该元素\n * - 传入 null → 跳过绑定(适合 ref 未初始化的场景)\n *\n * @typeParam K WindowEventMap 中的事件名称\n * @param event 事件名称,如 \"scroll\"、\"resize\"、\"click\"\n * @param handler 事件处理函数\n * @param target 监听目标;默认 window;传 null 跳过绑定\n *\n * @example\n * ```tsx\n * // 监听全局滚动\n * useEventListener('scroll', () => setScrollY(window.scrollY))\n *\n * // 监听特定元素的点击\n * const divRef = useRef<HTMLDivElement>(null)\n * useEventListener('click', handleClick, divRef.current)\n *\n * // 传入 null 跳过(ref 尚未挂载时)\n * useEventListener('mouseenter', onEnter, ref.current)\n * ```\n */\nexport function useEventListener<K extends keyof WindowEventMap>(\n event: K,\n handler: (event: WindowEventMap[K]) => void,\n target?: EventTarget | null,\n): void {\n const savedHandler = useRef<(event: WindowEventMap[K]) => void>(handler)\n\n useEffect(() => {\n savedHandler.current = handler\n }, [handler])\n\n useEffect(() => {\n // target 显式传入 null 时跳过绑定\n if (target === null) return\n const eventTarget: EventTarget = target ?? window\n\n function listener(event: Event): void {\n savedHandler.current(event as WindowEventMap[K])\n }\n\n eventTarget.addEventListener(event, listener)\n return () => {\n eventTarget.removeEventListener(event, listener)\n }\n }, [event, target])\n}\n"],"mappings":"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","names":["import_react","import_react","import_react","import_react","import_react","import_react","import_react","import_react","import_react","import_react","import_react","import_react","event"]}
@@ -1,232 +1,20 @@
1
- import { RefObject } from 'react';
2
-
3
1
  /**
4
- * 防抖值,延迟 delay 毫秒后才更新
5
- * @example
6
- * const keyword = useDebounce(inputValue, 300)
7
- */
8
- declare function useDebounce<T>(value: T, delay?: number): T;
9
-
10
- type SetLocalStorageValue<T> = (value: T | ((prev: T) => T)) => void;
11
- type UseLocalStorageReturn<T> = [T, SetLocalStorageValue<T>, () => void];
12
- /**
13
- * 自动读写 localStorage 的 useState
14
- * @example
15
- * const [token, setToken, removeToken] = useLocalStorage('token', '')
16
- */
17
- declare function useLocalStorage<T>(key: string, initialValue: T): UseLocalStorageReturn<T>;
18
-
19
- /**
20
- * 监听 CSS media query 变化,返回当前是否匹配
21
- * @example
22
- * const isMobile = useMediaQuery('(max-width: 768px)')
23
- * const prefersDark = useMediaQuery('(prefers-color-scheme: dark)')
24
- */
25
- declare function useMediaQuery(query: string): boolean;
26
-
27
- /**
28
- * 点击 ref 元素外部时触发 handler
29
- * @example
30
- * const ref = useRef<HTMLDivElement>(null)
31
- * useClickOutside(ref, () => setOpen(false))
32
- */
33
- declare function useClickOutside<T extends HTMLElement>(ref: RefObject<T | null>, handler: () => void): void;
34
-
35
- interface UseCopyToClipboardReturn {
36
- copied: boolean;
37
- copy: (text: string) => Promise<void>;
38
- }
39
- /**
40
- * 复制文本到剪贴板,copied 状态 2 秒后自动重置
41
- * @example
42
- * const { copied, copy } = useCopyToClipboard()
43
- * <button onClick={() => copy('hello')}>{copied ? '已复制' : '复制'}</button>
44
- */
45
- declare function useCopyToClipboard(): UseCopyToClipboardReturn;
46
-
47
- type UseToggleReturn = [boolean, () => void, (value: boolean) => void];
48
- /**
49
- * 简单的布尔值切换,返回 [value, toggle, setValue]
50
- * @example
51
- * const [isOpen, toggleOpen, setIsOpen] = useToggle(false)
52
- * <button onClick={toggleOpen}>切换</button>
53
- */
54
- declare function useToggle(initial?: boolean): UseToggleReturn;
55
-
56
- interface UsePaginationOptions {
57
- /** 数据总条数 */
58
- total: number;
59
- /** 每页条数,默认 10 */
60
- pageSize?: number;
61
- /** 初始页码,默认 1 */
62
- initialPage?: number;
63
- }
64
- interface UsePaginationReturn {
65
- /** 当前页码 (从 1 开始) */
66
- page: number;
67
- /** 总页数 */
68
- totalPages: number;
69
- /** 跳转到指定页 */
70
- setPage: (p: number) => void;
71
- /** 下一页 */
72
- nextPage: () => void;
73
- /** 上一页 */
74
- prevPage: () => void;
75
- /** 是否有下一页 */
76
- hasNext: boolean;
77
- /** 是否有上一页 */
78
- hasPrev: boolean;
79
- /** 当前页起始索引 (0-based,用于切片) */
80
- startIndex: number;
81
- /** 当前页结束索引 (exclusive,用于切片) */
82
- endIndex: number;
83
- }
84
- /**
85
- * 分页状态管理,提供页码、边界判断和数据切片索引
86
- * @example
87
- * const { page, totalPages, nextPage, prevPage, startIndex, endIndex } = usePagination({ total: 100, pageSize: 10 })
88
- * const pageData = data.slice(startIndex, endIndex)
89
- */
90
- declare function usePagination({ total, pageSize, initialPage, }: UsePaginationOptions): UsePaginationReturn;
91
-
92
- type UseFormErrors<T extends Record<string, unknown>> = Partial<Record<keyof T, string>>;
93
- interface UseFormReturn<T extends Record<string, unknown>> {
94
- /** 当前表单值 */
95
- values: T;
96
- /** 字段错误信息 */
97
- errors: UseFormErrors<T>;
98
- /** 更新单个字段值 */
99
- handleChange: <K extends keyof T>(name: K, value: T[K]) => void;
100
- /** 设置字段错误 */
101
- setError: (name: keyof T, message: string) => void;
102
- /** 清除所有错误 */
103
- clearErrors: () => void;
104
- /** 重置表单到初始值 */
105
- reset: () => void;
106
- /** 表单是否被修改过 */
107
- isDirty: boolean;
108
- }
109
- /**
110
- * 极简表单状态管理,提供值管理、错误处理和脏状态检测
111
- * @example
112
- * const form = useForm({ username: '', password: '' })
113
- * <input value={form.values.username} onChange={e => form.handleChange('username', e.target.value)} />
114
- * {form.errors.username && <span>{form.errors.username}</span>}
115
- */
116
- declare function useForm<T extends Record<string, unknown>>(initialValues: T): UseFormReturn<T>;
117
-
118
- /**
119
- * 返回组件是否已在客户端挂载完成。
120
- *
121
- * 在 SSR 场景中,服务端渲染时始终返回 false,
122
- * 客户端 hydration 完成后变为 true,可用于条件渲染仅客户端内容。
123
- *
124
- * @returns 组件是否已挂载
125
- *
126
- * @example
127
- * ```tsx
128
- * const isMounted = useMounted()
129
- *
130
- * if (!isMounted) return null // 服务端不渲染
131
- * return <ClientOnlyComponent />
132
- * ```
133
- */
134
- declare function useMounted(): boolean;
135
-
136
- /**
137
- * 以指定间隔重复调用回调函数。
138
- *
139
- * 当 delay 为 null 时定时器自动暂停,可动态修改 delay 或 callback。
140
- * 参考 Dan Abramov 的 useInterval 实现,使用 ref 保持 callback 最新引用。
141
- *
142
- * @param callback 每次触发时调用的函数
143
- * @param delay 间隔毫秒数;传入 null 则暂停定时器
144
- *
145
- * @example
146
- * ```tsx
147
- * const [count, setCount] = useState(0)
148
- * const [running, setRunning] = useState(true)
149
- *
150
- * useInterval(() => setCount(c => c + 1), running ? 1000 : null)
151
- * ```
152
- */
153
- declare function useInterval(callback: () => void, delay: number | null): void;
154
-
155
- /**
156
- * 在指定延迟后执行一次回调函数。
157
- *
158
- * 当 delay 为 null 时定时器不启动(暂停模式)。
159
- * 每次 delay 变化都会重置定时器;组件卸载时自动清理。
160
- *
161
- * @param callback 延迟结束后调用的函数
162
- * @param delay 延迟毫秒数;传入 null 则不执行
163
- *
164
- * @example
165
- * ```tsx
166
- * const [show, setShow] = useState(true)
167
- *
168
- * // 3 秒后自动隐藏提示
169
- * useTimeout(() => setShow(false), show ? 3000 : null)
170
- * ```
171
- */
172
- declare function useTimeout(callback: () => void, delay: number | null): void;
173
-
174
- interface UseHotkeysOptions {
175
- /** 是否阻止默认浏览器行为,默认 false */
176
- preventDefault?: boolean;
177
- /** 监听目标,默认 window */
178
- target?: HTMLElement | null;
179
- }
180
- /**
181
- * 将快捷键字符串绑定到回调函数。
182
- *
183
- * 支持修饰键组合:ctrl、cmd(Meta)、alt、shift,加主键(不区分大小写)。
184
- * 组件卸载时自动解绑。
185
- *
186
- * @param keys 快捷键字符串,如 "ctrl+k"、"cmd+s"、"escape"
187
- * @param callback 触发时调用的函数
188
- * @param options 额外配置项
189
- *
190
- * @example
191
- * ```tsx
192
- * // 全局搜索快捷键
193
- * useHotkeys('ctrl+k', () => setSearchOpen(true), { preventDefault: true })
194
- *
195
- * // ESC 关闭弹窗
196
- * useHotkeys('escape', () => setOpen(false))
197
- *
198
- * // 仅在特定元素内响应
199
- * useHotkeys('ctrl+enter', handleSubmit, { target: formRef.current })
200
- * ```
201
- */
202
- declare function useHotkeys(keys: string, callback: (event: KeyboardEvent) => void, options?: UseHotkeysOptions): void;
203
-
204
- /**
205
- * 在指定目标上绑定事件监听器,组件卸载时自动清理。
206
- *
207
- * 支持三种目标类型:
208
- * - 不传 target → 默认监听 window
209
- * - 传入 HTMLElement → 监听该元素
210
- * - 传入 null → 跳过绑定(适合 ref 未初始化的场景)
211
- *
212
- * @typeParam K WindowEventMap 中的事件名称
213
- * @param event 事件名称,如 "scroll"、"resize"、"click"
214
- * @param handler 事件处理函数
215
- * @param target 监听目标;默认 window;传 null 跳过绑定
216
- *
217
- * @example
218
- * ```tsx
219
- * // 监听全局滚动
220
- * useEventListener('scroll', () => setScrollY(window.scrollY))
221
- *
222
- * // 监听特定元素的点击
223
- * const divRef = useRef<HTMLDivElement>(null)
224
- * useEventListener('click', handleClick, divRef.current)
225
- *
226
- * // 传入 null 跳过(ref 尚未挂载时)
227
- * useEventListener('mouseenter', onEnter, ref.current)
228
- * ```
229
- */
230
- declare function useEventListener<K extends keyof WindowEventMap>(event: K, handler: (event: WindowEventMap[K]) => void, target?: EventTarget | null): void;
231
-
232
- export { type SetLocalStorageValue, type UseCopyToClipboardReturn, type UseFormErrors, type UseFormReturn, type UseHotkeysOptions, type UseLocalStorageReturn, type UsePaginationOptions, type UsePaginationReturn, type UseToggleReturn, useClickOutside, useCopyToClipboard, useDebounce, useEventListener, useForm, useHotkeys, useInterval, useLocalStorage, useMediaQuery, useMounted, usePagination, useTimeout, useToggle };
2
+ * @description: @ug666/ui-react/hooks 子入口 — 所有 Hooks 统一导出
3
+ * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。
4
+ * @date: 2026-04-17
5
+ */
6
+ export { useDebounce } from './use-debounce';
7
+ export { useLocalStorage, type UseLocalStorageReturn, type SetLocalStorageValue, } from './use-local-storage';
8
+ export { useMediaQuery } from './use-media-query';
9
+ export { useClickOutside } from './use-click-outside';
10
+ export { useCopyToClipboard, type UseCopyToClipboardReturn } from './use-copy-to-clipboard';
11
+ export { useToggle, type UseToggleReturn } from './use-toggle';
12
+ export { usePagination, type UsePaginationOptions, type UsePaginationReturn, } from './use-pagination';
13
+ export { useForm, type UseFormErrors, type UseFormOptions, type UseFormReturn, type UseFormTouched, } from './use-form';
14
+ export type { FormFieldRules, FormRule, FormRules, FormValidationTrigger, FormValueType, } from '@ug666/ui-core';
15
+ export { useMounted } from './use-mounted';
16
+ export { useInterval } from './use-interval';
17
+ export { useTimeout } from './use-timeout';
18
+ export { useHotkeys, type UseHotkeysOptions } from './use-hotkeys';
19
+ export { useEventListener } from './use-event-listener';
20
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,kBAAkB,EAAE,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAC3F,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,OAAO,EACP,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,cAAc,EACd,QAAQ,EACR,SAAS,EACT,qBAAqB,EACrB,aAAa,GACd,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA"}
@@ -13,7 +13,7 @@ import {
13
13
  usePagination,
14
14
  useTimeout,
15
15
  useToggle
16
- } from "../chunk-MGXIF756.js";
16
+ } from "../chunk-M6J4PLF4.js";
17
17
  export {
18
18
  useClickOutside,
19
19
  useCopyToClipboard,
@@ -0,0 +1,9 @@
1
+ import type { RefObject } from 'react';
2
+ /**
3
+ * 点击 ref 元素外部时触发 handler
4
+ * @example
5
+ * const ref = useRef<HTMLDivElement>(null)
6
+ * useClickOutside(ref, () => setOpen(false))
7
+ */
8
+ export declare function useClickOutside<T extends HTMLElement>(ref: RefObject<T | null>, handler: () => void): void;
9
+ //# sourceMappingURL=use-click-outside.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-click-outside.d.ts","sourceRoot":"","sources":["../../src/hooks/use-click-outside.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,EACnD,GAAG,EAAE,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC,EACxB,OAAO,EAAE,MAAM,IAAI,GAClB,IAAI,CAsBN"}
@@ -0,0 +1,12 @@
1
+ export interface UseCopyToClipboardReturn {
2
+ copied: boolean;
3
+ copy: (text: string) => Promise<void>;
4
+ }
5
+ /**
6
+ * 复制文本到剪贴板,copied 状态 2 秒后自动重置
7
+ * @example
8
+ * const { copied, copy } = useCopyToClipboard()
9
+ * <button onClick={() => copy('hello')}>{copied ? '已复制' : '复制'}</button>
10
+ */
11
+ export declare function useCopyToClipboard(): UseCopyToClipboardReturn;
12
+ //# sourceMappingURL=use-copy-to-clipboard.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-copy-to-clipboard.d.ts","sourceRoot":"","sources":["../../src/hooks/use-copy-to-clipboard.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,wBAAwB,CA+B7D"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * 防抖值,延迟 delay 毫秒后才更新
3
+ * @example
4
+ * const keyword = useDebounce(inputValue, 300)
5
+ */
6
+ export declare function useDebounce<T>(value: T, delay?: number): T;
7
+ //# sourceMappingURL=use-debounce.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-debounce.d.ts","sourceRoot":"","sources":["../../src/hooks/use-debounce.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,SAAM,GAAG,CAAC,CASvD"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * 叠加层组件(Modal / Sheet / Drawer / Dialog)公共行为:
3
+ * - open 为 true 时:注册 keydown 监听,锁定 body 滚动
4
+ * - open 为 false 或卸载时:移除监听,解锁 body 滚动
5
+ *
6
+ * @param open - 组件是否处于展开状态
7
+ * @param onEscape - 按下 Escape 时的回调
8
+ */
9
+ export declare function useEscapeKey(open: boolean, onEscape: () => void): void;
10
+ //# sourceMappingURL=use-escape-key.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-escape-key.d.ts","sourceRoot":"","sources":["../../src/hooks/use-escape-key.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAiBtE"}
@@ -0,0 +1,28 @@
1
+ /**
2
+ * 在指定目标上绑定事件监听器,组件卸载时自动清理。
3
+ *
4
+ * 支持三种目标类型:
5
+ * - 不传 target → 默认监听 window
6
+ * - 传入 HTMLElement → 监听该元素
7
+ * - 传入 null → 跳过绑定(适合 ref 未初始化的场景)
8
+ *
9
+ * @typeParam K WindowEventMap 中的事件名称
10
+ * @param event 事件名称,如 "scroll"、"resize"、"click"
11
+ * @param handler 事件处理函数
12
+ * @param target 监听目标;默认 window;传 null 跳过绑定
13
+ *
14
+ * @example
15
+ * ```tsx
16
+ * // 监听全局滚动
17
+ * useEventListener('scroll', () => setScrollY(window.scrollY))
18
+ *
19
+ * // 监听特定元素的点击
20
+ * const divRef = useRef<HTMLDivElement>(null)
21
+ * useEventListener('click', handleClick, divRef.current)
22
+ *
23
+ * // 传入 null 跳过(ref 尚未挂载时)
24
+ * useEventListener('mouseenter', onEnter, ref.current)
25
+ * ```
26
+ */
27
+ export declare function useEventListener<K extends keyof WindowEventMap>(event: K, handler: (event: WindowEventMap[K]) => void, target?: EventTarget | null): void;
28
+ //# sourceMappingURL=use-event-listener.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-event-listener.d.ts","sourceRoot":"","sources":["../../src/hooks/use-event-listener.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,cAAc,EAC7D,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,EAC3C,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAC1B,IAAI,CAqBN"}
@@ -0,0 +1,48 @@
1
+ /**
2
+ * @description: React 表单状态、校验与提交流程管理
3
+ * @author: UG - 一个斗码大陆苦逼的三段码之气的少年,并没有神秘戒指中码老的帮助,但总有一天,我会成为斗码大陆中码帝一样的存在。三十年河东,三十年河西,莫欺少年穷。
4
+ * @date: 2026-07-27
5
+ */
6
+ import { type FormEvent, type SetStateAction } from 'react';
7
+ import { type FormRules, type FormValidationTrigger } from '@ug666/ui-core';
8
+ export type UseFormErrors<T extends Record<string, unknown>> = Partial<Record<keyof T, string>>;
9
+ export type UseFormTouched<T extends Record<string, unknown>> = Partial<Record<keyof T, boolean>>;
10
+ export interface UseFormOptions<T extends Record<string, unknown>> {
11
+ rules?: FormRules<T>;
12
+ validateOnChange?: boolean;
13
+ validateOnBlur?: boolean;
14
+ initialErrors?: UseFormErrors<T>;
15
+ scrollToError?: boolean;
16
+ scrollIntoViewOptions?: ScrollIntoViewOptions;
17
+ onValidate?: (name: keyof T, valid: boolean, message?: string) => void;
18
+ }
19
+ export interface UseFormReturn<T extends Record<string, unknown>> {
20
+ values: T;
21
+ rules: FormRules<T> | undefined;
22
+ errors: UseFormErrors<T>;
23
+ touched: UseFormTouched<T>;
24
+ dirtyFields: UseFormTouched<T>;
25
+ validatingFields: UseFormTouched<T>;
26
+ isDirty: boolean;
27
+ isValid: boolean;
28
+ isValidating: boolean;
29
+ handleChange: <Key extends keyof T>(name: Key, value: T[Key]) => void;
30
+ handleBlur: (name: keyof T) => void;
31
+ setFieldValue: <Key extends keyof T>(name: Key, value: T[Key]) => void;
32
+ setValues: (values: SetStateAction<T>) => void;
33
+ setError: (name: keyof T, message: string) => void;
34
+ clearErrors: (names?: keyof T | (keyof T)[]) => void;
35
+ clearValidate: (names?: keyof T | (keyof T)[]) => void;
36
+ validateField: (name: keyof T, trigger?: FormValidationTrigger) => Promise<boolean>;
37
+ validate: (names?: keyof T | (keyof T)[]) => Promise<boolean>;
38
+ handleSubmit: (callback: (values: T, event: FormEvent<HTMLFormElement>) => void | Promise<void>) => (event: FormEvent<HTMLFormElement>) => Promise<void>;
39
+ reset: (nextValues?: T) => void;
40
+ resetFields: (names?: keyof T | (keyof T)[]) => void;
41
+ setInitialValues: (values: T) => void;
42
+ registerField: (name: keyof T, element: HTMLElement | null) => void;
43
+ getField: (name: keyof T) => HTMLElement | undefined;
44
+ scrollToField: (name: keyof T, options?: ScrollIntoViewOptions) => void;
45
+ scrollToError: (options?: ScrollIntoViewOptions) => void;
46
+ }
47
+ export declare function useForm<T extends Record<string, unknown>>(initialValues: T, options?: UseFormOptions<T>): UseFormReturn<T>;
48
+ //# sourceMappingURL=use-form.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-form.d.ts","sourceRoot":"","sources":["../../src/hooks/use-form.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,OAAO,CAAA;AACd,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAA;AAIvB,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;AAC/F,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;AAEjG,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,aAAa,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAChC,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;IAC7C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACvE;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9D,MAAM,EAAE,CAAC,CAAA;IACT,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;IAC/B,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IACxB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;IAC1B,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;IAC9B,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,EAAE,OAAO,CAAA;IACrB,YAAY,EAAE,CAAC,GAAG,SAAS,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAA;IACrE,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,CAAA;IACnC,aAAa,EAAE,CAAC,GAAG,SAAS,MAAM,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAA;IACtE,SAAS,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IAC9C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAClD,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,IAAI,CAAA;IACpD,aAAa,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,IAAI,CAAA;IACtD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACnF,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7D,YAAY,EAAE,CACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,eAAe,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAC7E,CAAC,KAAK,EAAE,SAAS,CAAC,eAAe,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,KAAK,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,IAAI,CAAA;IAC/B,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,IAAI,CAAA;IACpD,gBAAgB,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAA;IACrC,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;IACnE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,WAAW,GAAG,SAAS,CAAA;IACpD,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAA;IACvE,aAAa,EAAE,CAAC,OAAO,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAA;CACzD;AAUD,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,aAAa,EAAE,CAAC,EAChB,OAAO,GAAE,cAAc,CAAC,CAAC,CAAM,GAC9B,aAAa,CAAC,CAAC,CAAC,CA0QlB"}