@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,90 @@
1
+ /**
2
+ * 路由注册核心类
3
+ *
4
+ * 负责动态路由的注册、验证和管理
5
+ *
6
+ * @module router/core/RouteRegistry
7
+ * @author Art Design Pro Team
8
+ */
9
+
10
+ import type { Router, RouteRecordRaw } from 'vue-router'
11
+ import type { AppRouteRecord } from '@/types/router'
12
+ import { ComponentLoader } from './ComponentLoader'
13
+ import { RouteValidator } from './RouteValidator'
14
+ import { RouteTransformer } from './RouteTransformer'
15
+
16
+ export class RouteRegistry {
17
+ private router: Router
18
+ private componentLoader: ComponentLoader
19
+ private validator: RouteValidator
20
+ private transformer: RouteTransformer
21
+ private removeRouteFns: (() => void)[] = []
22
+ private registered = false
23
+
24
+ constructor(router: Router) {
25
+ this.router = router
26
+ this.componentLoader = new ComponentLoader()
27
+ this.validator = new RouteValidator()
28
+ this.transformer = new RouteTransformer(this.componentLoader)
29
+ }
30
+
31
+ /**
32
+ * 注册动态路由
33
+ */
34
+ register(menuList: AppRouteRecord[]): void {
35
+ if (this.registered) {
36
+ console.warn('[RouteRegistry] 路由已注册,跳过重复注册')
37
+ return
38
+ }
39
+
40
+ // 验证路由配置
41
+ const validationResult = this.validator.validate(menuList)
42
+ if (!validationResult.valid) {
43
+ throw new Error(`路由配置验证失败: ${validationResult.errors.join(', ')}`)
44
+ }
45
+
46
+ // 转换并注册路由
47
+ const removeRouteFns: (() => void)[] = []
48
+
49
+ menuList.forEach((route) => {
50
+ if (route.name && !this.router.hasRoute(route.name)) {
51
+ const routeConfig = this.transformer.transform(route)
52
+ const removeRouteFn = this.router.addRoute(routeConfig as RouteRecordRaw)
53
+ removeRouteFns.push(removeRouteFn)
54
+ }
55
+ })
56
+
57
+ this.removeRouteFns = removeRouteFns
58
+ this.registered = true
59
+ }
60
+
61
+ /**
62
+ * 移除所有动态路由
63
+ */
64
+ unregister(): void {
65
+ this.removeRouteFns.forEach((fn) => fn())
66
+ this.removeRouteFns = []
67
+ this.registered = false
68
+ }
69
+
70
+ /**
71
+ * 检查是否已注册
72
+ */
73
+ isRegistered(): boolean {
74
+ return this.registered
75
+ }
76
+
77
+ /**
78
+ * 获取移除函数列表(用于 store 管理)
79
+ */
80
+ getRemoveRouteFns(): (() => void)[] {
81
+ return this.removeRouteFns
82
+ }
83
+
84
+ /**
85
+ * 标记为已注册(用于错误处理场景,避免重复请求)
86
+ */
87
+ markAsRegistered(): void {
88
+ this.registered = true
89
+ }
90
+ }
@@ -0,0 +1,132 @@
1
+ /**
2
+ * 路由转换器
3
+ *
4
+ * 负责将菜单数据转换为 Vue Router 路由配置
5
+ *
6
+ * @module router/core/RouteTransformer
7
+ * @author Art Design Pro Team
8
+ */
9
+
10
+ import type { RouteRecordRaw } from 'vue-router'
11
+ import type { AppRouteRecord } from '@/types/router'
12
+ import { ComponentLoader } from './ComponentLoader'
13
+ import { IframeRouteManager } from './IframeRouteManager'
14
+
15
+ interface ConvertedRoute extends Omit<RouteRecordRaw, 'children'> {
16
+ id?: number
17
+ children?: ConvertedRoute[]
18
+ component?: RouteRecordRaw['component'] | (() => Promise<any>)
19
+ }
20
+
21
+ export class RouteTransformer {
22
+ private componentLoader: ComponentLoader
23
+ private iframeManager: IframeRouteManager
24
+
25
+ constructor(componentLoader: ComponentLoader) {
26
+ this.componentLoader = componentLoader
27
+ this.iframeManager = IframeRouteManager.getInstance()
28
+ }
29
+
30
+ /**
31
+ * 转换路由配置
32
+ */
33
+ transform(route: AppRouteRecord, depth = 0): ConvertedRoute {
34
+ const { component, children, ...routeConfig } = route
35
+
36
+ // 基础路由配置
37
+ const converted: ConvertedRoute = {
38
+ ...routeConfig,
39
+ component: undefined
40
+ }
41
+
42
+ // 处理不同类型的路由
43
+ if (route.meta.isIframe) {
44
+ this.handleIframeRoute(converted, route, depth)
45
+ } else if (this.isFirstLevelRoute(route, depth)) {
46
+ this.handleFirstLevelRoute(converted, route, component as string)
47
+ } else {
48
+ this.handleNormalRoute(converted, component as string)
49
+ }
50
+
51
+ // 递归处理子路由
52
+ if (children?.length) {
53
+ converted.children = children.map((child) => this.transform(child, depth + 1))
54
+ }
55
+
56
+ return converted
57
+ }
58
+
59
+ /**
60
+ * 判断是否为一级路由(需要 Layout 包裹)
61
+ */
62
+ private isFirstLevelRoute(route: AppRouteRecord, depth: number): boolean {
63
+ return depth === 0 && (!route.children || route.children.length === 0)
64
+ }
65
+
66
+ /**
67
+ * 处理 iframe 类型路由
68
+ */
69
+ private handleIframeRoute(
70
+ targetRoute: ConvertedRoute,
71
+ sourceRoute: AppRouteRecord,
72
+ depth: number
73
+ ): void {
74
+ if (depth === 0) {
75
+ // 顶级 iframe:用 Layout 包裹
76
+ targetRoute.component = this.componentLoader.loadLayout()
77
+ targetRoute.path = this.extractFirstSegment(sourceRoute.path || '')
78
+ targetRoute.name = ''
79
+
80
+ targetRoute.children = [
81
+ {
82
+ ...sourceRoute,
83
+ component: this.componentLoader.loadIframe()
84
+ } as ConvertedRoute
85
+ ]
86
+ } else {
87
+ // 非顶级(嵌套)iframe:直接使用 Iframe.vue
88
+ targetRoute.component = this.componentLoader.loadIframe()
89
+ }
90
+
91
+ // 记录 iframe 路由
92
+ this.iframeManager.add(sourceRoute)
93
+ }
94
+
95
+ /**
96
+ * 处理一级菜单路由
97
+ */
98
+ private handleFirstLevelRoute(
99
+ converted: ConvertedRoute,
100
+ route: AppRouteRecord,
101
+ component: string | undefined
102
+ ): void {
103
+ converted.component = this.componentLoader.loadLayout()
104
+ converted.path = this.extractFirstSegment(route.path || '')
105
+ converted.name = ''
106
+ route.meta.isFirstLevel = true
107
+
108
+ converted.children = [
109
+ {
110
+ ...route,
111
+ component: component ? this.componentLoader.load(component) : undefined
112
+ } as ConvertedRoute
113
+ ]
114
+ }
115
+
116
+ /**
117
+ * 处理普通路由
118
+ */
119
+ private handleNormalRoute(converted: ConvertedRoute, component: string | undefined): void {
120
+ if (component) {
121
+ converted.component = this.componentLoader.load(component)
122
+ }
123
+ }
124
+
125
+ /**
126
+ * 提取路径的第一段
127
+ */
128
+ private extractFirstSegment(path: string): string {
129
+ const segments = path.split('/').filter(Boolean)
130
+ return segments.length > 0 ? `/${segments[0]}` : '/'
131
+ }
132
+ }
@@ -0,0 +1,187 @@
1
+ /**
2
+ * 路由验证器
3
+ *
4
+ * 负责验证路由配置的合法性
5
+ *
6
+ * @module router/core/RouteValidator
7
+ * @author Art Design Pro Team
8
+ */
9
+
10
+ import type { AppRouteRecord } from '@/types/router'
11
+ import { RoutesAlias } from '../routesAlias'
12
+
13
+ export interface ValidationResult {
14
+ valid: boolean
15
+ errors: string[]
16
+ warnings: string[]
17
+ }
18
+
19
+ export class RouteValidator {
20
+ // 用于记录已经提示过的路由,避免重复提示
21
+ private warnedRoutes = new Set<string>()
22
+
23
+ /**
24
+ * 验证路由配置
25
+ */
26
+ validate(routes: AppRouteRecord[]): ValidationResult {
27
+ const errors: string[] = []
28
+ const warnings: string[] = []
29
+
30
+ // 检测重复路由
31
+ this.checkDuplicates(routes, errors, warnings)
32
+
33
+ // 检测组件配置
34
+ this.checkComponents(routes, errors, warnings)
35
+
36
+ // 检测嵌套菜单的 /index/index 配置
37
+ this.checkNestedIndexComponent(routes)
38
+
39
+ return {
40
+ valid: errors.length === 0,
41
+ errors,
42
+ warnings
43
+ }
44
+ }
45
+
46
+ /**
47
+ * 检测重复路由
48
+ */
49
+ private checkDuplicates(
50
+ routes: AppRouteRecord[],
51
+ errors: string[],
52
+ warnings: string[],
53
+ parentPath = ''
54
+ ): void {
55
+ const routeNameMap = new Map<string, string>()
56
+ const componentPathMap = new Map<string, string>()
57
+
58
+ const checkRoutes = (routes: AppRouteRecord[], parentPath = '') => {
59
+ routes.forEach((route) => {
60
+ const currentPath = route.path || ''
61
+ const fullPath = this.resolvePath(parentPath, currentPath)
62
+
63
+ // 名称重复检测
64
+ if (route.name) {
65
+ const routeName = String(route.name)
66
+ if (routeNameMap.has(routeName)) {
67
+ warnings.push(`路由名称重复: "${routeName}" (${fullPath})`)
68
+ } else {
69
+ routeNameMap.set(routeName, fullPath)
70
+ }
71
+ }
72
+
73
+ // 组件路径重复检测
74
+ if (route.component && typeof route.component === 'string') {
75
+ const componentPath = route.component
76
+ if (componentPath !== RoutesAlias.Layout) {
77
+ const componentKey = `${parentPath}:${componentPath}`
78
+ if (componentPathMap.has(componentKey)) {
79
+ warnings.push(`组件路径重复: "${componentPath}" (${fullPath})`)
80
+ } else {
81
+ componentPathMap.set(componentKey, fullPath)
82
+ }
83
+ }
84
+ }
85
+
86
+ // 递归处理子路由
87
+ if (route.children?.length) {
88
+ checkRoutes(route.children, fullPath)
89
+ }
90
+ })
91
+ }
92
+
93
+ checkRoutes(routes, parentPath)
94
+ }
95
+
96
+ /**
97
+ * 检测组件配置
98
+ */
99
+ private checkComponents(
100
+ routes: AppRouteRecord[],
101
+ errors: string[],
102
+ warnings: string[],
103
+ parentPath = ''
104
+ ): void {
105
+ routes.forEach((route) => {
106
+ const hasExternalLink = !!route.meta?.link?.trim()
107
+ const hasChildren = Array.isArray(route.children) && route.children.length > 0
108
+ const routePath = route.path || '[未定义路径]'
109
+ const isIframe = route.meta?.isIframe
110
+
111
+ // 如果配置了 component,则无需校验
112
+ if (route.component) {
113
+ // 递归检查子路由
114
+ if (route.children?.length) {
115
+ const fullPath = this.resolvePath(parentPath, route.path || '')
116
+ this.checkComponents(route.children, errors, warnings, fullPath)
117
+ }
118
+ return
119
+ }
120
+
121
+ // 一级菜单:必须指定 Layout,除非是外链或 iframe
122
+ if (parentPath === '' && !hasExternalLink && !isIframe) {
123
+ errors.push(`一级菜单(${routePath}) 缺少 component,必须指向 ${RoutesAlias.Layout}`)
124
+ return
125
+ }
126
+
127
+ // 非一级菜单:如果既不是外链、iframe,也没有子路由,则必须配置 component
128
+ if (!hasExternalLink && !isIframe && !hasChildren) {
129
+ errors.push(`路由(${routePath}) 缺少 component 配置`)
130
+ }
131
+
132
+ // 递归检查子路由
133
+ if (route.children?.length) {
134
+ const fullPath = this.resolvePath(parentPath, route.path || '')
135
+ this.checkComponents(route.children, errors, warnings, fullPath)
136
+ }
137
+ })
138
+ }
139
+
140
+ /**
141
+ * 检测嵌套菜单的 Layout 组件配置
142
+ * 只有一级菜单才能使用 Layout,二级及以下菜单不能使用
143
+ */
144
+ private checkNestedIndexComponent(routes: AppRouteRecord[], level = 1): void {
145
+ routes.forEach((route) => {
146
+ // 检查二级及以下菜单是否错误使用了 Layout
147
+ if (level > 1 && route.component === RoutesAlias.Layout) {
148
+ this.logLayoutError(route, level)
149
+ }
150
+
151
+ // 递归检查子路由
152
+ if (route.children?.length) {
153
+ this.checkNestedIndexComponent(route.children, level + 1)
154
+ }
155
+ })
156
+ }
157
+
158
+ /**
159
+ * 输出 Layout 组件配置错误日志
160
+ */
161
+ private logLayoutError(route: AppRouteRecord, level: number): void {
162
+ const routeName = String(route.name || route.path || '未知路由')
163
+ const routeKey = `${routeName}_${route.path}`
164
+
165
+ // 避免重复提示
166
+ if (this.warnedRoutes.has(routeKey)) return
167
+ this.warnedRoutes.add(routeKey)
168
+
169
+ const menuTitle = route.meta?.title || routeName
170
+ const routePath = route.path || '/'
171
+
172
+ console.error(
173
+ `[路由配置错误] 菜单 "${menuTitle}" (name: ${routeName}, path: ${routePath}) 配置错误\n` +
174
+ ` 问题: ${level}级菜单不能使用 ${RoutesAlias.Layout} 作为 component\n` +
175
+ ` 说明: 只有一级菜单才能使用 ${RoutesAlias.Layout},二级及以下菜单应该指向具体的组件路径\n` +
176
+ ` 当前配置: component: '${RoutesAlias.Layout}'\n` +
177
+ ` 应该改为: component: '/your/component/path' 或留空 ''(如果是目录菜单)`
178
+ )
179
+ }
180
+
181
+ /**
182
+ * 路径解析
183
+ */
184
+ private resolvePath(parent: string, child: string): string {
185
+ return [parent.replace(/\/$/, ''), child.replace(/^\//, '')].filter(Boolean).join('/')
186
+ }
187
+ }
@@ -0,0 +1,14 @@
1
+ /**
2
+ * 路由核心模块导出
3
+ *
4
+ * @module router/core
5
+ * @author Art Design Pro Team
6
+ */
7
+
8
+ export { RouteRegistry } from './RouteRegistry'
9
+ export { ComponentLoader } from './ComponentLoader'
10
+ export { RouteValidator } from './RouteValidator'
11
+ export { RouteTransformer } from './RouteTransformer'
12
+ export { IframeRouteManager } from './IframeRouteManager'
13
+ export { MenuProcessor } from './MenuProcessor'
14
+ export { RoutePermissionValidator } from './RoutePermissionValidator'
@@ -0,0 +1,34 @@
1
+ import { nextTick } from 'vue'
2
+ import { useSettingStore } from '@/store/modules/setting'
3
+ import { Router } from 'vue-router'
4
+ import NProgress from 'nprogress'
5
+ import { useCommon } from '@/hooks/core/useCommon'
6
+ import { loadingService } from '@/utils/ui'
7
+ import { getPendingLoading, resetPendingLoading } from './beforeEach'
8
+
9
+ /** 路由全局后置守卫 */
10
+ export function setupAfterEachGuard(router: Router) {
11
+ const { scrollToTop } = useCommon()
12
+
13
+ router.afterEach(() => {
14
+ scrollToTop()
15
+
16
+ // 关闭进度条
17
+ const settingStore = useSettingStore()
18
+ if (settingStore.showNprogress) {
19
+ NProgress.done()
20
+ // 确保进度条完全移除,避免残影
21
+ setTimeout(() => {
22
+ NProgress.remove()
23
+ }, 600)
24
+ }
25
+
26
+ // 关闭 loading 效果
27
+ if (getPendingLoading()) {
28
+ nextTick(() => {
29
+ loadingService.hideLoading()
30
+ resetPendingLoading()
31
+ })
32
+ }
33
+ })
34
+ }