@kevairy/template 0.1.0

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 (293) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +14 -0
  3. package/package.json +37 -0
  4. package/template/.env +22 -0
  5. package/template/.env.development +13 -0
  6. package/template/.env.production +10 -0
  7. package/template/.prettierignore +3 -0
  8. package/template/.prettierrc +20 -0
  9. package/template/.stylelintignore +9 -0
  10. package/template/.stylelintrc.cjs +84 -0
  11. package/template/LICENSE +21 -0
  12. package/template/README.md +22 -0
  13. package/template/_gitignore +19 -0
  14. package/template/eslint-auto-import.json +324 -0
  15. package/template/eslint.config.mjs +83 -0
  16. package/template/index.html +25 -0
  17. package/template/package.json +79 -0
  18. package/template/playwright.config.ts +25 -0
  19. package/template/public/favicon.ico +0 -0
  20. package/template/src/App.vue +39 -0
  21. package/template/src/adapters/auth/index.ts +9 -0
  22. package/template/src/adapters/auth/mock.ts +10 -0
  23. package/template/src/adapters/auth/types.ts +11 -0
  24. package/template/src/adapters/navigation/index.ts +13 -0
  25. package/template/src/adapters/navigation/types.ts +6 -0
  26. package/template/src/api/auth.ts +23 -0
  27. package/template/src/assets/images/avatar/avatar.webp +0 -0
  28. package/template/src/assets/images/avatar/avatar1.webp +0 -0
  29. package/template/src/assets/images/avatar/avatar10.webp +0 -0
  30. package/template/src/assets/images/avatar/avatar2.webp +0 -0
  31. package/template/src/assets/images/avatar/avatar3.webp +0 -0
  32. package/template/src/assets/images/avatar/avatar4.webp +0 -0
  33. package/template/src/assets/images/avatar/avatar5.webp +0 -0
  34. package/template/src/assets/images/avatar/avatar6.webp +0 -0
  35. package/template/src/assets/images/avatar/avatar7.webp +0 -0
  36. package/template/src/assets/images/avatar/avatar8.webp +0 -0
  37. package/template/src/assets/images/avatar/avatar9.webp +0 -0
  38. package/template/src/assets/images/ceremony/hb.png +0 -0
  39. package/template/src/assets/images/ceremony/sd.png +0 -0
  40. package/template/src/assets/images/ceremony/xc.png +0 -0
  41. package/template/src/assets/images/ceremony/yd.png +0 -0
  42. package/template/src/assets/images/common/logo.webp +0 -0
  43. package/template/src/assets/images/draw/draw1.png +0 -0
  44. package/template/src/assets/images/favicon.ico +0 -0
  45. package/template/src/assets/images/lock/bg_dark.webp +0 -0
  46. package/template/src/assets/images/lock/bg_light.webp +0 -0
  47. package/template/src/assets/images/login/kylin-hero-source.png +0 -0
  48. package/template/src/assets/images/login/lf_icon2.webp +0 -0
  49. package/template/src/assets/images/settings/menu_layouts/dual_column.png +0 -0
  50. package/template/src/assets/images/settings/menu_layouts/horizontal.png +0 -0
  51. package/template/src/assets/images/settings/menu_layouts/mixed.png +0 -0
  52. package/template/src/assets/images/settings/menu_layouts/vertical.png +0 -0
  53. package/template/src/assets/images/settings/menu_styles/dark.png +0 -0
  54. package/template/src/assets/images/settings/menu_styles/design.png +0 -0
  55. package/template/src/assets/images/settings/menu_styles/light.png +0 -0
  56. package/template/src/assets/images/settings/theme_styles/dark.png +0 -0
  57. package/template/src/assets/images/settings/theme_styles/light.png +0 -0
  58. package/template/src/assets/images/settings/theme_styles/system.png +0 -0
  59. package/template/src/assets/images/svg/403.svg +1 -0
  60. package/template/src/assets/images/svg/404.svg +1 -0
  61. package/template/src/assets/images/svg/500.svg +5 -0
  62. package/template/src/assets/images/svg/login_icon.svg +1 -0
  63. package/template/src/assets/images/user/avatar.webp +0 -0
  64. package/template/src/assets/images/user/bg.webp +0 -0
  65. package/template/src/assets/styles/core/app.scss +227 -0
  66. package/template/src/assets/styles/core/dark.scss +93 -0
  67. package/template/src/assets/styles/core/el-dark.scss +2 -0
  68. package/template/src/assets/styles/core/el-light.scss +34 -0
  69. package/template/src/assets/styles/core/el-ui.scss +519 -0
  70. package/template/src/assets/styles/core/md.scss +1036 -0
  71. package/template/src/assets/styles/core/mixin.scss +157 -0
  72. package/template/src/assets/styles/core/reset.scss +41 -0
  73. package/template/src/assets/styles/core/router-transition.scss +104 -0
  74. package/template/src/assets/styles/core/tailwind.css +219 -0
  75. package/template/src/assets/styles/core/theme-animation.scss +63 -0
  76. package/template/src/assets/styles/core/theme-change.scss +11 -0
  77. package/template/src/assets/styles/custom/one-dark-pro.scss +98 -0
  78. package/template/src/assets/styles/index.scss +23 -0
  79. package/template/src/assets/svg/loading.ts +32 -0
  80. package/template/src/bootstrap/initializeApp.ts +30 -0
  81. package/template/src/components/core/banners/art-basic-banner/index.vue +343 -0
  82. package/template/src/components/core/banners/art-card-banner/index.vue +114 -0
  83. package/template/src/components/core/base/art-back-to-top/index.vue +40 -0
  84. package/template/src/components/core/base/art-logo/index.vue +34 -0
  85. package/template/src/components/core/base/art-svg-icon/index.vue +24 -0
  86. package/template/src/components/core/cards/art-bar-chart-card/index.vue +103 -0
  87. package/template/src/components/core/cards/art-data-list-card/index.vue +74 -0
  88. package/template/src/components/core/cards/art-donut-chart-card/index.vue +124 -0
  89. package/template/src/components/core/cards/art-image-card/index.vue +89 -0
  90. package/template/src/components/core/cards/art-line-chart-card/index.vue +126 -0
  91. package/template/src/components/core/cards/art-progress-card/index.vue +86 -0
  92. package/template/src/components/core/cards/art-stats-card/index.vue +67 -0
  93. package/template/src/components/core/cards/art-timeline-list-card/index.vue +69 -0
  94. package/template/src/components/core/charts/art-bar-chart/index.vue +203 -0
  95. package/template/src/components/core/charts/art-dual-bar-compare-chart/index.vue +195 -0
  96. package/template/src/components/core/charts/art-h-bar-chart/index.vue +208 -0
  97. package/template/src/components/core/charts/art-k-line-chart/index.vue +152 -0
  98. package/template/src/components/core/charts/art-line-chart/index.vue +371 -0
  99. package/template/src/components/core/charts/art-radar-chart/index.vue +105 -0
  100. package/template/src/components/core/charts/art-ring-chart/index.vue +133 -0
  101. package/template/src/components/core/charts/art-scatter-chart/index.vue +115 -0
  102. package/template/src/components/core/feedback/art-page-loading/index.vue +281 -0
  103. package/template/src/components/core/forms/art-button-more/index.vue +71 -0
  104. package/template/src/components/core/forms/art-button-table/index.vue +59 -0
  105. package/template/src/components/core/forms/art-drag-verify/index.vue +430 -0
  106. package/template/src/components/core/forms/art-excel-export/index.vue +390 -0
  107. package/template/src/components/core/forms/art-excel-import/index.vue +62 -0
  108. package/template/src/components/core/forms/art-form/index.vue +507 -0
  109. package/template/src/components/core/forms/art-wang-editor/index.vue +261 -0
  110. package/template/src/components/core/forms/art-wang-editor/style.scss +273 -0
  111. package/template/src/components/core/layouts/art-breadcrumb/index.vue +142 -0
  112. package/template/src/components/core/layouts/art-chat-window/index.vue +262 -0
  113. package/template/src/components/core/layouts/art-fast-enter/index.vue +113 -0
  114. package/template/src/components/core/layouts/art-fireworks-effect/index.vue +633 -0
  115. package/template/src/components/core/layouts/art-global-component/index.vue +14 -0
  116. package/template/src/components/core/layouts/art-global-search/index.vue +431 -0
  117. package/template/src/components/core/layouts/art-header-bar/index.vue +485 -0
  118. package/template/src/components/core/layouts/art-header-bar/widget/ArtUserMenu.vue +118 -0
  119. package/template/src/components/core/layouts/art-menus/art-horizontal-menu/index.vue +110 -0
  120. package/template/src/components/core/layouts/art-menus/art-horizontal-menu/widget/HorizontalSubmenu.vue +106 -0
  121. package/template/src/components/core/layouts/art-menus/art-mixed-menu/index.vue +279 -0
  122. package/template/src/components/core/layouts/art-menus/art-sidebar-menu/index.vue +354 -0
  123. package/template/src/components/core/layouts/art-menus/art-sidebar-menu/style.scss +251 -0
  124. package/template/src/components/core/layouts/art-menus/art-sidebar-menu/theme.scss +258 -0
  125. package/template/src/components/core/layouts/art-menus/art-sidebar-menu/widget/SidebarSubmenu.vue +190 -0
  126. package/template/src/components/core/layouts/art-notification/index.vue +456 -0
  127. package/template/src/components/core/layouts/art-page-content/index.vue +137 -0
  128. package/template/src/components/core/layouts/art-settings-panel/composables/useSettingsConfig.ts +248 -0
  129. package/template/src/components/core/layouts/art-settings-panel/composables/useSettingsHandlers.ts +167 -0
  130. package/template/src/components/core/layouts/art-settings-panel/composables/useSettingsPanel.ts +233 -0
  131. package/template/src/components/core/layouts/art-settings-panel/composables/useSettingsState.ts +37 -0
  132. package/template/src/components/core/layouts/art-settings-panel/index.vue +72 -0
  133. package/template/src/components/core/layouts/art-settings-panel/style.scss +92 -0
  134. package/template/src/components/core/layouts/art-settings-panel/widget/BasicSettings.vue +77 -0
  135. package/template/src/components/core/layouts/art-settings-panel/widget/BoxStyleSettings.vue +38 -0
  136. package/template/src/components/core/layouts/art-settings-panel/widget/ColorSettings.vue +35 -0
  137. package/template/src/components/core/layouts/art-settings-panel/widget/ContainerSettings.vue +33 -0
  138. package/template/src/components/core/layouts/art-settings-panel/widget/MenuLayoutSettings.vue +31 -0
  139. package/template/src/components/core/layouts/art-settings-panel/widget/MenuStyleSettings.vue +44 -0
  140. package/template/src/components/core/layouts/art-settings-panel/widget/SectionTitle.vue +17 -0
  141. package/template/src/components/core/layouts/art-settings-panel/widget/SettingActions.vue +236 -0
  142. package/template/src/components/core/layouts/art-settings-panel/widget/SettingDrawer.vue +51 -0
  143. package/template/src/components/core/layouts/art-settings-panel/widget/SettingHeader.vue +18 -0
  144. package/template/src/components/core/layouts/art-settings-panel/widget/SettingItem.vue +101 -0
  145. package/template/src/components/core/layouts/art-settings-panel/widget/ThemeSettings.vue +28 -0
  146. package/template/src/components/core/layouts/art-work-tab/index.vue +584 -0
  147. package/template/src/components/core/media/art-cutter-img/index.vue +350 -0
  148. package/template/src/components/core/media/art-video-player/index.vue +111 -0
  149. package/template/src/components/core/others/art-menu-right/index.vue +415 -0
  150. package/template/src/components/core/others/art-watermark/index.vue +64 -0
  151. package/template/src/components/core/text-effect/art-count-to/index.vue +310 -0
  152. package/template/src/components/core/text-effect/art-festival-text-scroll/index.vue +32 -0
  153. package/template/src/components/core/text-effect/art-text-scroll/index.vue +285 -0
  154. package/template/src/components/core/theme/theme-svg/index.vue +100 -0
  155. package/template/src/components/core/views/exception/ArtException.vue +55 -0
  156. package/template/src/components/core/views/login/AuthTopBar.vue +149 -0
  157. package/template/src/components/core/views/login/LoginLeftView.vue +602 -0
  158. package/template/src/components/core/views/result/ArtResultPage.vue +43 -0
  159. package/template/src/components/core/widget/art-icon-button/index.vue +23 -0
  160. package/template/src/config/assets/images.ts +61 -0
  161. package/template/src/config/index.ts +170 -0
  162. package/template/src/config/modules/component.ts +98 -0
  163. package/template/src/config/modules/fastEnter.ts +16 -0
  164. package/template/src/config/modules/festival.ts +51 -0
  165. package/template/src/config/modules/headerBar.ts +64 -0
  166. package/template/src/config/setting.ts +109 -0
  167. package/template/src/directives/core/auth.ts +66 -0
  168. package/template/src/directives/core/highlight-loader.ts +37 -0
  169. package/template/src/directives/core/highlight.ts +253 -0
  170. package/template/src/directives/core/ripple.ts +116 -0
  171. package/template/src/directives/core/roles.ts +87 -0
  172. package/template/src/directives/index.ts +14 -0
  173. package/template/src/enums/appEnum.ts +81 -0
  174. package/template/src/enums/formEnum.ts +17 -0
  175. package/template/src/env.d.ts +32 -0
  176. package/template/src/hooks/core/useAppMode.ts +45 -0
  177. package/template/src/hooks/core/useAuth.ts +74 -0
  178. package/template/src/hooks/core/useCeremony.ts +184 -0
  179. package/template/src/hooks/core/useChart.ts +745 -0
  180. package/template/src/hooks/core/useCommon.ts +87 -0
  181. package/template/src/hooks/core/useFastEnter.ts +55 -0
  182. package/template/src/hooks/core/useHeaderBar.ts +201 -0
  183. package/template/src/hooks/core/useLayoutHeight.ts +148 -0
  184. package/template/src/hooks/core/useTableColumns.ts +313 -0
  185. package/template/src/hooks/core/useTheme.ts +174 -0
  186. package/template/src/hooks/index.ts +29 -0
  187. package/template/src/locales/index.ts +123 -0
  188. package/template/src/locales/langs/en.json +283 -0
  189. package/template/src/locales/langs/zh.json +283 -0
  190. package/template/src/main.ts +29 -0
  191. package/template/src/mock/auth.ts +46 -0
  192. package/template/src/plugins/echarts.ts +76 -0
  193. package/template/src/plugins/index.ts +6 -0
  194. package/template/src/router/core/ComponentLoader.ts +82 -0
  195. package/template/src/router/core/IframeRouteManager.ts +78 -0
  196. package/template/src/router/core/MenuProcessor.ts +280 -0
  197. package/template/src/router/core/RoutePermissionValidator.ts +161 -0
  198. package/template/src/router/core/RouteRegistry.ts +90 -0
  199. package/template/src/router/core/RouteTransformer.ts +132 -0
  200. package/template/src/router/core/RouteValidator.ts +187 -0
  201. package/template/src/router/core/index.ts +14 -0
  202. package/template/src/router/guards/afterEach.ts +34 -0
  203. package/template/src/router/guards/beforeEach.ts +442 -0
  204. package/template/src/router/index.ts +24 -0
  205. package/template/src/router/modules/dashboard.ts +23 -0
  206. package/template/src/router/modules/examples.ts +109 -0
  207. package/template/src/router/modules/exception.ts +46 -0
  208. package/template/src/router/modules/index.ts +12 -0
  209. package/template/src/router/modules/result.ts +32 -0
  210. package/template/src/router/routes/asyncRoutes.ts +9 -0
  211. package/template/src/router/routes/staticRoutes.ts +60 -0
  212. package/template/src/router/routesAlias.ts +8 -0
  213. package/template/src/services/auth.ts +15 -0
  214. package/template/src/store/index.ts +52 -0
  215. package/template/src/store/modules/menu.ts +109 -0
  216. package/template/src/store/modules/setting.ts +450 -0
  217. package/template/src/store/modules/user.ts +218 -0
  218. package/template/src/store/modules/worktab.ts +568 -0
  219. package/template/src/types/api/api.d.ts +86 -0
  220. package/template/src/types/common/index.ts +95 -0
  221. package/template/src/types/common/response.ts +32 -0
  222. package/template/src/types/component/chart.ts +324 -0
  223. package/template/src/types/component/index.ts +86 -0
  224. package/template/src/types/config/index.ts +253 -0
  225. package/template/src/types/directive/directive.d.ts +15 -0
  226. package/template/src/types/import/auto-imports.d.ts +319 -0
  227. package/template/src/types/import/components.d.ts +126 -0
  228. package/template/src/types/index.ts +22 -0
  229. package/template/src/types/router/index.ts +80 -0
  230. package/template/src/types/store/index.ts +157 -0
  231. package/template/src/utils/form/index.ts +9 -0
  232. package/template/src/utils/form/validator.ts +316 -0
  233. package/template/src/utils/http/contract.ts +39 -0
  234. package/template/src/utils/http/error.ts +182 -0
  235. package/template/src/utils/http/index.ts +226 -0
  236. package/template/src/utils/http/status.ts +18 -0
  237. package/template/src/utils/index.ts +31 -0
  238. package/template/src/utils/navigation/index.ts +10 -0
  239. package/template/src/utils/navigation/jump.ts +68 -0
  240. package/template/src/utils/navigation/route.ts +85 -0
  241. package/template/src/utils/navigation/worktab.ts +67 -0
  242. package/template/src/utils/router.ts +63 -0
  243. package/template/src/utils/socket/index.ts +423 -0
  244. package/template/src/utils/storage/index.ts +7 -0
  245. package/template/src/utils/storage/storage-config.ts +127 -0
  246. package/template/src/utils/storage/storage-key-manager.ts +97 -0
  247. package/template/src/utils/storage/storage.ts +250 -0
  248. package/template/src/utils/sys/console.ts +9 -0
  249. package/template/src/utils/sys/error-handle.ts +143 -0
  250. package/template/src/utils/sys/index.ts +2 -0
  251. package/template/src/utils/sys/mittBus.ts +61 -0
  252. package/template/src/utils/ui/animation.ts +80 -0
  253. package/template/src/utils/ui/colors.ts +273 -0
  254. package/template/src/utils/ui/emojo.ts +24 -0
  255. package/template/src/utils/ui/iconify-loader.ts +31 -0
  256. package/template/src/utils/ui/index.ts +11 -0
  257. package/template/src/utils/ui/loading.ts +158 -0
  258. package/template/src/utils/ui/tabs.ts +60 -0
  259. package/template/src/views/auth/forget-password/index.vue +62 -0
  260. package/template/src/views/auth/login/index.vue +166 -0
  261. package/template/src/views/auth/login/style.css +38 -0
  262. package/template/src/views/auth/register/index.vue +240 -0
  263. package/template/src/views/dashboard/console/index.vue +173 -0
  264. package/template/src/views/examples/analytics/index.vue +389 -0
  265. package/template/src/views/examples/complex-form/index.vue +395 -0
  266. package/template/src/views/examples/crud-workspace/index.vue +412 -0
  267. package/template/src/views/examples/navigation/detail/index.vue +151 -0
  268. package/template/src/views/examples/navigation/state/index.vue +226 -0
  269. package/template/src/views/examples/overview/index.vue +309 -0
  270. package/template/src/views/examples/permissions/index.vue +303 -0
  271. package/template/src/views/examples/search-table/index.vue +182 -0
  272. package/template/src/views/examples/search-table/search.config.ts +81 -0
  273. package/template/src/views/examples/search-table/service.ts +116 -0
  274. package/template/src/views/examples/search-table/table.config.ts +37 -0
  275. package/template/src/views/exception/403/index.vue +16 -0
  276. package/template/src/views/exception/404/index.vue +16 -0
  277. package/template/src/views/exception/500/index.vue +16 -0
  278. package/template/src/views/index/index.vue +29 -0
  279. package/template/src/views/index/style.scss +93 -0
  280. package/template/src/views/outside/Iframe.vue +42 -0
  281. package/template/src/views/result/fail/index.vue +28 -0
  282. package/template/src/views/result/success/index.vue +21 -0
  283. package/template/tests/e2e/auth.spec.ts +14 -0
  284. package/template/tests/e2e/search-table.spec.ts +154 -0
  285. package/template/tests/unit/adapters/auth.spec.ts +38 -0
  286. package/template/tests/unit/config/app-config.spec.ts +17 -0
  287. package/template/tests/unit/directives/highlight.spec.ts +20 -0
  288. package/template/tests/unit/http/contract.spec.ts +47 -0
  289. package/template/tests/unit/mock/search-table.spec.ts +62 -0
  290. package/template/tests/unit/router/examples.spec.ts +52 -0
  291. package/template/tsconfig.json +28 -0
  292. package/template/vite.config.ts +181 -0
  293. package/template/vitest.config.ts +27 -0
@@ -0,0 +1,310 @@
1
+ <!-- 数字滚动 -->
2
+ <template>
3
+ <span
4
+ class="text-g-900 tabular-nums"
5
+ :class="isRunning ? 'transition-opacity duration-300 ease-in-out' : ''"
6
+ >
7
+ {{ formattedValue }}
8
+ </span>
9
+ </template>
10
+
11
+ <script setup lang="ts">
12
+ import { computed, watch, nextTick, onUnmounted, shallowRef } from 'vue'
13
+ import { useTransition, TransitionPresets } from '@vueuse/core'
14
+
15
+ // 类型定义
16
+ interface CountToProps {
17
+ /** 目标值 */
18
+ target: number
19
+ /** 动画持续时间(毫秒) */
20
+ duration?: number
21
+ /** 是否自动开始 */
22
+ autoStart?: boolean
23
+ /** 小数位数 */
24
+ decimals?: number
25
+ /** 小数点符号 */
26
+ decimal?: string
27
+ /** 千分位分隔符 */
28
+ separator?: string
29
+ /** 前缀 */
30
+ prefix?: string
31
+ /** 后缀 */
32
+ suffix?: string
33
+ /** 缓动函数 */
34
+ easing?: keyof typeof TransitionPresets
35
+ /** 是否禁用动画 */
36
+ disabled?: boolean
37
+ }
38
+
39
+ interface CountToEmits {
40
+ started: [value: number]
41
+ finished: [value: number]
42
+ paused: [value: number]
43
+ reset: []
44
+ }
45
+
46
+ interface CountToExpose {
47
+ start: (target?: number) => void
48
+ pause: () => void
49
+ reset: (newTarget?: number) => void
50
+ stop: () => void
51
+ setTarget: (target: number) => void
52
+ readonly isRunning: boolean
53
+ readonly isPaused: boolean
54
+ readonly currentValue: number
55
+ readonly targetValue: number
56
+ readonly progress: number
57
+ }
58
+
59
+ // 常量定义
60
+ const EPSILON = Number.EPSILON
61
+ const MIN_DURATION = 100
62
+ const MAX_DURATION = 60000
63
+ const MAX_DECIMALS = 10
64
+ const DEFAULT_EASING = 'easeOutExpo'
65
+ const DEFAULT_DURATION = 2000
66
+
67
+ const props = withDefaults(defineProps<CountToProps>(), {
68
+ target: 0,
69
+ duration: DEFAULT_DURATION,
70
+ autoStart: true,
71
+ decimals: 0,
72
+ decimal: '.',
73
+ separator: '',
74
+ prefix: '',
75
+ suffix: '',
76
+ easing: DEFAULT_EASING,
77
+ disabled: false
78
+ })
79
+
80
+ const emit = defineEmits<CountToEmits>()
81
+
82
+ // 工具函数
83
+ const validateNumber = (value: number, name: string, defaultValue: number): number => {
84
+ if (!Number.isFinite(value)) {
85
+ console.warn(`[CountTo] Invalid ${name} value:`, value)
86
+ return defaultValue
87
+ }
88
+ return value
89
+ }
90
+
91
+ const clamp = (value: number, min: number, max: number): number => {
92
+ return Math.max(min, Math.min(value, max))
93
+ }
94
+
95
+ const formatNumber = (
96
+ value: number,
97
+ decimals: number,
98
+ decimal: string,
99
+ separator: string
100
+ ): string => {
101
+ let result = decimals > 0 ? value.toFixed(decimals) : Math.floor(value).toString()
102
+
103
+ // 处理小数点符号
104
+ if (decimal !== '.' && result.includes('.')) {
105
+ result = result.replace('.', decimal)
106
+ }
107
+
108
+ // 处理千分位分隔符
109
+ if (separator) {
110
+ const parts = result.split(decimal)
111
+ parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, separator)
112
+ result = parts.join(decimal)
113
+ }
114
+
115
+ return result
116
+ }
117
+
118
+ // 安全计算值
119
+ const safeTarget = computed(() => validateNumber(props.target, 'target', 0))
120
+ const safeDuration = computed(() =>
121
+ clamp(validateNumber(props.duration, 'duration', DEFAULT_DURATION), MIN_DURATION, MAX_DURATION)
122
+ )
123
+ const safeDecimals = computed(() =>
124
+ clamp(validateNumber(props.decimals, 'decimals', 0), 0, MAX_DECIMALS)
125
+ )
126
+ const safeEasing = computed(() => {
127
+ const easing = props.easing
128
+ if (!(easing in TransitionPresets)) {
129
+ console.warn('[CountTo] Invalid easing value:', easing)
130
+ return DEFAULT_EASING
131
+ }
132
+ return easing
133
+ })
134
+
135
+ // 状态管理
136
+ const currentValue = shallowRef(0)
137
+ const targetValue = shallowRef(safeTarget.value)
138
+ const isRunning = shallowRef(false)
139
+ const isPaused = shallowRef(false)
140
+ const pausedValue = shallowRef(0)
141
+
142
+ // 动画控制
143
+ const transitionValue = useTransition(currentValue, {
144
+ duration: safeDuration,
145
+ transition: computed(() => TransitionPresets[safeEasing.value]),
146
+ onStarted: () => {
147
+ isRunning.value = true
148
+ isPaused.value = false
149
+ emit('started', targetValue.value)
150
+ },
151
+ onFinished: () => {
152
+ isRunning.value = false
153
+ isPaused.value = false
154
+ emit('finished', targetValue.value)
155
+ }
156
+ })
157
+
158
+ // 格式化显示值
159
+ const formattedValue = computed(() => {
160
+ const value = isPaused.value ? pausedValue.value : transitionValue.value
161
+
162
+ if (!Number.isFinite(value)) {
163
+ return `${props.prefix}0${props.suffix}`
164
+ }
165
+
166
+ const formattedNumber = formatNumber(value, safeDecimals.value, props.decimal, props.separator)
167
+ return `${props.prefix}${formattedNumber}${props.suffix}`
168
+ })
169
+
170
+ // 私有方法
171
+ const shouldSkipAnimation = (target: number): boolean => {
172
+ const current = isPaused.value ? pausedValue.value : transitionValue.value
173
+ return Math.abs(current - target) < EPSILON
174
+ }
175
+
176
+ const resetPauseState = (): void => {
177
+ isPaused.value = false
178
+ pausedValue.value = 0
179
+ }
180
+
181
+ // 公共方法
182
+ const start = (target?: number): void => {
183
+ if (props.disabled) {
184
+ console.warn('[CountTo] Animation is disabled')
185
+ return
186
+ }
187
+
188
+ const finalTarget = target !== undefined ? target : targetValue.value
189
+
190
+ if (!Number.isFinite(finalTarget)) {
191
+ console.warn('[CountTo] Invalid target value for start:', finalTarget)
192
+ return
193
+ }
194
+
195
+ targetValue.value = finalTarget
196
+
197
+ if (shouldSkipAnimation(finalTarget)) {
198
+ return
199
+ }
200
+
201
+ // 从暂停值开始(如果存在)
202
+ if (isPaused.value) {
203
+ currentValue.value = pausedValue.value
204
+ resetPauseState()
205
+ }
206
+
207
+ nextTick(() => {
208
+ currentValue.value = finalTarget
209
+ })
210
+ }
211
+
212
+ const pause = (): void => {
213
+ if (!isRunning.value || isPaused.value) {
214
+ return
215
+ }
216
+
217
+ isPaused.value = true
218
+ pausedValue.value = transitionValue.value
219
+ currentValue.value = pausedValue.value
220
+
221
+ emit('paused', pausedValue.value)
222
+ }
223
+
224
+ const reset = (newTarget = 0): void => {
225
+ const target = validateNumber(newTarget, 'reset target', 0)
226
+
227
+ currentValue.value = target
228
+ targetValue.value = target
229
+ resetPauseState()
230
+
231
+ emit('reset')
232
+ }
233
+
234
+ const setTarget = (target: number): void => {
235
+ if (!Number.isFinite(target)) {
236
+ console.warn('[CountTo] Invalid target value for setTarget:', target)
237
+ return
238
+ }
239
+
240
+ targetValue.value = target
241
+
242
+ if ((isRunning.value || props.autoStart) && !props.disabled) {
243
+ start(target)
244
+ }
245
+ }
246
+
247
+ const stop = (): void => {
248
+ if (isRunning.value || isPaused.value) {
249
+ currentValue.value = 0
250
+ resetPauseState()
251
+ emit('paused', 0)
252
+ }
253
+ }
254
+
255
+ // 监听器
256
+ watch(
257
+ safeTarget,
258
+ (newTarget) => {
259
+ if (props.autoStart && !props.disabled) {
260
+ start(newTarget)
261
+ } else {
262
+ targetValue.value = newTarget
263
+ }
264
+ },
265
+ { immediate: props.autoStart && !props.disabled }
266
+ )
267
+
268
+ watch(
269
+ () => props.disabled,
270
+ (disabled) => {
271
+ if (disabled && isRunning.value) {
272
+ stop()
273
+ }
274
+ }
275
+ )
276
+
277
+ // 清理
278
+ onUnmounted(() => {
279
+ if (isRunning.value) {
280
+ stop()
281
+ }
282
+ })
283
+
284
+ // 暴露 API
285
+ defineExpose<CountToExpose>({
286
+ start,
287
+ pause,
288
+ reset,
289
+ stop,
290
+ setTarget,
291
+ get isRunning() {
292
+ return isRunning.value
293
+ },
294
+ get isPaused() {
295
+ return isPaused.value
296
+ },
297
+ get currentValue() {
298
+ return isPaused.value ? pausedValue.value : transitionValue.value
299
+ },
300
+ get targetValue() {
301
+ return targetValue.value
302
+ },
303
+ get progress() {
304
+ const current = isPaused.value ? pausedValue.value : transitionValue.value
305
+ const target = targetValue.value
306
+ if (target === 0) return current === 0 ? 1 : 0
307
+ return Math.abs(current / target)
308
+ }
309
+ })
310
+ </script>
@@ -0,0 +1,32 @@
1
+ <!-- 节日文本滚动 -->
2
+ <template>
3
+ <div
4
+ class="overflow-hidden transition-[height] duration-600 ease-in-out"
5
+ :style="{
6
+ height: showFestivalText ? '48px' : '0'
7
+ }"
8
+ >
9
+ <ArtTextScroll
10
+ v-if="showFestivalText && currentFestivalData?.scrollText !== ''"
11
+ :text="currentFestivalData?.scrollText || ''"
12
+ style="margin-bottom: 12px"
13
+ showClose
14
+ @close="handleClose"
15
+ />
16
+ </div>
17
+ </template>
18
+
19
+ <script setup lang="ts">
20
+ import { useSettingStore } from '@/store/modules/setting'
21
+ import { useCeremony } from '@/hooks/core/useCeremony'
22
+
23
+ defineOptions({ name: 'ArtFestivalTextScroll' })
24
+
25
+ const settingStore = useSettingStore()
26
+ const { showFestivalText } = storeToRefs(settingStore)
27
+ const { currentFestivalData } = useCeremony()
28
+
29
+ const handleClose = () => {
30
+ settingStore.setShowFestivalText(false)
31
+ }
32
+ </script>
@@ -0,0 +1,285 @@
1
+ <!-- 文字滚动 -->
2
+ <template>
3
+ <div
4
+ ref="containerRef"
5
+ class="relative overflow-hidden rounded-custom-sm border flex-c box-border text-sm"
6
+ :class="themeClasses"
7
+ :style="containerStyle"
8
+ >
9
+ <div class="flex-cc absolute left-0 h-full w-9 z-10" :style="{ backgroundColor: bgColor }">
10
+ <ArtSvgIcon icon="ri:volume-down-line" class="text-lg" />
11
+ </div>
12
+
13
+ <div
14
+ ref="contentRef"
15
+ class="whitespace-nowrap inline-block transition-opacity duration-600 [&_a]:text-danger [&_a:hover]:underline [&_a:hover]:text-danger/80 px-9"
16
+ :class="[contentClass, { 'opacity-0': !isReady, 'opacity-100': isReady }]"
17
+ :style="contentStyle"
18
+ @click="handleContentClick"
19
+ >
20
+ <!-- 原始内容 -->
21
+ <span ref="textRef" class="inline-block">
22
+ <slot>
23
+ <span v-html="text"></span>
24
+ </slot>
25
+ </span>
26
+ <!-- 克隆内容用于无缝循环 -->
27
+ <span v-if="shouldClone" class="inline-block" :style="cloneSpacing">
28
+ <slot>
29
+ <span v-html="text"></span>
30
+ </slot>
31
+ </span>
32
+ </div>
33
+
34
+ <div
35
+ v-if="showClose"
36
+ class="flex-cc absolute right-0 h-full w-9 c-p"
37
+ :style="{ backgroundColor: bgColor }"
38
+ @click="handleClose"
39
+ >
40
+ <ArtSvgIcon icon="ri:close-fill" class="text-lg" />
41
+ </div>
42
+ </div>
43
+ </template>
44
+
45
+ <script setup lang="ts">
46
+ import {
47
+ useElementSize,
48
+ useRafFn,
49
+ useElementHover,
50
+ useDebounceFn,
51
+ useTimeoutFn
52
+ } from '@vueuse/core'
53
+ import { useSettingStore } from '@/store/modules/setting'
54
+
55
+ type ThemeType =
56
+ | 'theme'
57
+ | 'primary'
58
+ | 'secondary'
59
+ | 'error'
60
+ | 'info'
61
+ | 'success'
62
+ | 'warning'
63
+ | 'danger'
64
+
65
+ /**
66
+ * 文本滚动组件属性接口
67
+ */
68
+ export interface TextScrollProps {
69
+ /** 滚动文本内容 */
70
+ text?: string
71
+ /** 主题类型 */
72
+ type?: ThemeType
73
+ /** 滚动方向 */
74
+ direction?: 'left' | 'right' | 'up' | 'down'
75
+ /** 滚动速度,单位:像素/秒 */
76
+ speed?: number
77
+ /** 容器宽度 */
78
+ width?: string
79
+ /** 容器高度 */
80
+ height?: string
81
+ /** 鼠标悬停时是否暂停滚动 */
82
+ pauseOnHover?: boolean
83
+ /** 是否显示关闭按钮 */
84
+ showClose?: boolean
85
+ /** 始终滚动(即使文字未溢出) */
86
+ alwaysScroll?: boolean
87
+ }
88
+
89
+ const props = withDefaults(defineProps<TextScrollProps>(), {
90
+ text: '',
91
+ direction: 'left',
92
+ speed: 80,
93
+ width: '100%',
94
+ height: '36px',
95
+ pauseOnHover: true,
96
+ type: 'theme',
97
+ showClose: false,
98
+ alwaysScroll: true
99
+ })
100
+
101
+ const emit = defineEmits<{
102
+ close: []
103
+ }>()
104
+
105
+ const handleClose = () => {
106
+ emit('close')
107
+ }
108
+
109
+ const settingStore = useSettingStore()
110
+ const { isDark } = storeToRefs(settingStore)
111
+
112
+ const containerRef = ref<HTMLElement>()
113
+ const contentRef = ref<HTMLElement>()
114
+ const textRef = ref<HTMLElement>()
115
+ const isReady = ref(false)
116
+
117
+ const currentPosition = ref(0)
118
+ const textSize = ref(0)
119
+ const containerSize = ref(0)
120
+ const shouldClone = ref(false)
121
+
122
+ const isHorizontal = computed(() => props.direction === 'left' || props.direction === 'right')
123
+ const isReverse = computed(() => props.direction === 'right' || props.direction === 'down')
124
+
125
+ // 使用 VueUse 的 useElementSize 监听容器尺寸变化
126
+ const { width: containerWidth, height: containerHeight } = useElementSize(containerRef)
127
+
128
+ // 使用 VueUse 的 useElementHover 检测鼠标悬停
129
+ const isHovered = useElementHover(containerRef)
130
+
131
+ // 计算是否应该暂停动画
132
+ const isPaused = computed(() => {
133
+ // 如果未启用 alwaysScroll,且文字未超出容器,则暂停滚动
134
+ if (!props.alwaysScroll && textSize.value <= containerSize.value) {
135
+ return true
136
+ }
137
+ return props.pauseOnHover && isHovered.value
138
+ })
139
+
140
+ // 主题样式映射
141
+ const themeClasses = computed(() => {
142
+ const themeMap: Record<ThemeType, string> = {
143
+ theme: 'text-theme/90 !border-theme/50',
144
+ primary: 'text-primary/90 !border-primary/50',
145
+ secondary: 'text-secondary/90 !border-secondary/50',
146
+ error: 'text-error/90 !border-error/50',
147
+ info: 'text-info/90 !border-info/50',
148
+ success: 'text-success/90 !border-success/50',
149
+ warning: 'text-warning/90 !border-warning/50',
150
+ danger: 'text-danger/90 !border-danger/50'
151
+ }
152
+ return themeMap[props.type] || themeMap.theme
153
+ })
154
+
155
+ // 背景色
156
+ const bgColor = computed(
157
+ () =>
158
+ `color-mix(in oklch, var(--color-${props.type}) ${isDark.value ? '25' : '10'}%, var(--art-color))`
159
+ )
160
+
161
+ const containerStyle = computed(() => ({
162
+ width: props.width,
163
+ height: props.height,
164
+ backgroundColor: bgColor.value
165
+ }))
166
+
167
+ const contentClass = computed(() => {
168
+ if (!isHorizontal.value) {
169
+ return 'flex flex-col'
170
+ }
171
+ return ''
172
+ })
173
+
174
+ const contentStyle = computed(() => {
175
+ const transform = isHorizontal.value
176
+ ? `translateX(${currentPosition.value}px)`
177
+ : `translateY(${currentPosition.value}px)`
178
+
179
+ return {
180
+ transform,
181
+ willChange: 'transform'
182
+ }
183
+ })
184
+
185
+ // 克隆元素的间距
186
+ const cloneSpacing = computed(() => {
187
+ const spacing = '2em'
188
+ return isHorizontal.value ? { marginLeft: spacing } : { marginTop: spacing }
189
+ })
190
+
191
+ const measureSizes = () => {
192
+ if (!containerRef.value || !textRef.value) return
193
+
194
+ const text = textRef.value
195
+
196
+ if (isHorizontal.value) {
197
+ containerSize.value = containerWidth.value
198
+ textSize.value = text.offsetWidth
199
+ } else {
200
+ containerSize.value = containerHeight.value
201
+ textSize.value = text.offsetHeight
202
+ }
203
+
204
+ const isOverflow = textSize.value > containerSize.value
205
+ shouldClone.value = isOverflow
206
+
207
+ // 居中显示
208
+ currentPosition.value = (containerSize.value - textSize.value) / 2
209
+
210
+ // 测量完成后才显示内容
211
+ if (!isReady.value) {
212
+ isReady.value = true
213
+ }
214
+ }
215
+
216
+ // 使用 VueUse 的 useDebounceFn 防抖测量
217
+ const debouncedMeasure = useDebounceFn(measureSizes, 150)
218
+
219
+ let lastTimestamp = 0
220
+
221
+ // 使用 VueUse 的 useRafFn 替代手动 requestAnimationFrame
222
+ const { pause, resume } = useRafFn(
223
+ ({ timestamp }) => {
224
+ if (!lastTimestamp) lastTimestamp = timestamp
225
+
226
+ if (!isPaused.value) {
227
+ const delta = (timestamp - lastTimestamp) / 1000
228
+ const distance = props.speed * delta
229
+ const spacing = textSize.value * 0.1
230
+
231
+ currentPosition.value += isReverse.value ? distance : -distance
232
+
233
+ // 循环边界检测
234
+ if (isReverse.value) {
235
+ if (currentPosition.value > containerSize.value) {
236
+ currentPosition.value = -(textSize.value + spacing)
237
+ }
238
+ } else {
239
+ if (currentPosition.value < -(textSize.value + spacing)) {
240
+ currentPosition.value = containerSize.value
241
+ }
242
+ }
243
+ }
244
+
245
+ lastTimestamp = timestamp
246
+ },
247
+ { immediate: false }
248
+ )
249
+
250
+ const handleContentClick = (e: MouseEvent) => {
251
+ const target = e.target as HTMLElement
252
+ if (target.tagName === 'A') {
253
+ e.stopPropagation()
254
+ }
255
+ }
256
+
257
+ // 监听容器尺寸变化
258
+ watch([containerWidth, containerHeight], () => {
259
+ debouncedMeasure()
260
+ })
261
+
262
+ // 监听属性变化
263
+ watch(
264
+ () => [props.direction, props.speed, props.text],
265
+ () => {
266
+ measureSizes()
267
+ lastTimestamp = 0
268
+ }
269
+ )
270
+
271
+ // 使用 VueUse 的 useTimeoutFn 替代 setTimeout
272
+ const { start: startMeasure } = useTimeoutFn(() => {
273
+ measureSizes()
274
+ // 测量完成后立即开始动画
275
+ resume()
276
+ }, 100)
277
+
278
+ onMounted(() => {
279
+ startMeasure()
280
+ })
281
+
282
+ onBeforeUnmount(() => {
283
+ pause()
284
+ })
285
+ </script>