@origen-ui/admin-cli 1.0.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 (430) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +17 -0
  3. package/bin/og-admin.mjs +131 -0
  4. package/package.json +28 -0
  5. package/templates/current/clean/.codebuddy/AGENTS.md +18 -0
  6. package/templates/current/clean/.codebuddy/rules/01-feature-architecture.md +12 -0
  7. package/templates/current/clean/.codebuddy/rules/02-vue-typescript.md +12 -0
  8. package/templates/current/clean/.codebuddy/rules/03-component-policy.md +30 -0
  9. package/templates/current/clean/.codebuddy/rules/04-api-auth-router.md +12 -0
  10. package/templates/current/clean/.codebuddy/rules/05-style.md +12 -0
  11. package/templates/current/clean/.codebuddy/rules/06-quality.md +12 -0
  12. package/templates/current/clean/.codebuddy/skills/build-admin-feature/SKILL.md +17 -0
  13. package/templates/current/clean/.codebuddy/skills/style-og-origen-ui/SKILL.md +14 -0
  14. package/templates/current/clean/.codebuddy/skills/use-og-dialog/SKILL.md +15 -0
  15. package/templates/current/clean/.codebuddy/skills/use-og-editor/SKILL.md +28 -0
  16. package/templates/current/clean/.codebuddy/skills/use-og-form/SKILL.md +15 -0
  17. package/templates/current/clean/.codebuddy/skills/use-og-form-table/SKILL.md +28 -0
  18. package/templates/current/clean/.codebuddy/skills/use-og-http/SKILL.md +16 -0
  19. package/templates/current/clean/.codebuddy/skills/use-og-router-tabs/SKILL.md +14 -0
  20. package/templates/current/clean/.codebuddy/skills/use-og-search/SKILL.md +17 -0
  21. package/templates/current/clean/.codebuddy/skills/use-og-table/SKILL.md +19 -0
  22. package/templates/current/clean/.codebuddy/skills/use-og-upload/SKILL.md +28 -0
  23. package/templates/current/clean/.codex/AGENTS.md +15 -0
  24. package/templates/current/clean/.codex/rules/01-feature-architecture.md +6 -0
  25. package/templates/current/clean/.codex/rules/02-vue-typescript.md +6 -0
  26. package/templates/current/clean/.codex/rules/03-component-policy.md +24 -0
  27. package/templates/current/clean/.codex/rules/04-api-auth-router.md +6 -0
  28. package/templates/current/clean/.codex/rules/05-style.md +6 -0
  29. package/templates/current/clean/.codex/rules/06-quality.md +6 -0
  30. package/templates/current/clean/.codex/skills/build-admin-feature/SKILL.md +14 -0
  31. package/templates/current/clean/.codex/skills/build-admin-feature/references/component-selection.md +25 -0
  32. package/templates/current/clean/.codex/skills/style-og-origen-ui/SKILL.md +11 -0
  33. package/templates/current/clean/.codex/skills/style-og-origen-ui/agents/openai.yaml +4 -0
  34. package/templates/current/clean/.codex/skills/use-og-dialog/SKILL.md +12 -0
  35. package/templates/current/clean/.codex/skills/use-og-dialog/agents/openai.yaml +4 -0
  36. package/templates/current/clean/.codex/skills/use-og-editor/SKILL.md +25 -0
  37. package/templates/current/clean/.codex/skills/use-og-form/SKILL.md +12 -0
  38. package/templates/current/clean/.codex/skills/use-og-form-table/SKILL.md +25 -0
  39. package/templates/current/clean/.codex/skills/use-og-http/SKILL.md +13 -0
  40. package/templates/current/clean/.codex/skills/use-og-http/agents/openai.yaml +4 -0
  41. package/templates/current/clean/.codex/skills/use-og-router-tabs/SKILL.md +11 -0
  42. package/templates/current/clean/.codex/skills/use-og-search/SKILL.md +14 -0
  43. package/templates/current/clean/.codex/skills/use-og-table/SKILL.md +16 -0
  44. package/templates/current/clean/.codex/skills/use-og-upload/SKILL.md +25 -0
  45. package/templates/current/clean/.cursor/AGENTS.md +18 -0
  46. package/templates/current/clean/.cursor/rules/01-feature-architecture.mdc +12 -0
  47. package/templates/current/clean/.cursor/rules/02-vue-typescript.mdc +12 -0
  48. package/templates/current/clean/.cursor/rules/03-component-policy.mdc +30 -0
  49. package/templates/current/clean/.cursor/rules/04-api-auth-router.mdc +12 -0
  50. package/templates/current/clean/.cursor/rules/05-style.mdc +12 -0
  51. package/templates/current/clean/.cursor/rules/06-quality.mdc +12 -0
  52. package/templates/current/clean/.cursor/skills/build-admin-feature/SKILL.md +14 -0
  53. package/templates/current/clean/.cursor/skills/style-og-origen-ui/SKILL.md +11 -0
  54. package/templates/current/clean/.cursor/skills/use-og-dialog/SKILL.md +12 -0
  55. package/templates/current/clean/.cursor/skills/use-og-editor/SKILL.md +25 -0
  56. package/templates/current/clean/.cursor/skills/use-og-form/SKILL.md +12 -0
  57. package/templates/current/clean/.cursor/skills/use-og-form-table/SKILL.md +25 -0
  58. package/templates/current/clean/.cursor/skills/use-og-http/SKILL.md +13 -0
  59. package/templates/current/clean/.cursor/skills/use-og-router-tabs/SKILL.md +11 -0
  60. package/templates/current/clean/.cursor/skills/use-og-search/SKILL.md +14 -0
  61. package/templates/current/clean/.cursor/skills/use-og-table/SKILL.md +16 -0
  62. package/templates/current/clean/.cursor/skills/use-og-upload/SKILL.md +25 -0
  63. package/templates/current/clean/.env.example +7 -0
  64. package/templates/current/clean/.env.production.example +31 -0
  65. package/templates/current/clean/.qoder/AGENTS.md +15 -0
  66. package/templates/current/clean/.qoder/rules/01-feature-architecture.md +12 -0
  67. package/templates/current/clean/.qoder/rules/02-vue-typescript.md +12 -0
  68. package/templates/current/clean/.qoder/rules/03-component-policy.md +30 -0
  69. package/templates/current/clean/.qoder/rules/04-api-auth-router.md +12 -0
  70. package/templates/current/clean/.qoder/rules/05-style.md +12 -0
  71. package/templates/current/clean/.qoder/rules/06-quality.md +12 -0
  72. package/templates/current/clean/.qoder/skills/build-admin-feature/SKILL.md +14 -0
  73. package/templates/current/clean/.qoder/skills/style-og-origen-ui/SKILL.md +11 -0
  74. package/templates/current/clean/.qoder/skills/use-og-dialog/SKILL.md +12 -0
  75. package/templates/current/clean/.qoder/skills/use-og-editor/SKILL.md +25 -0
  76. package/templates/current/clean/.qoder/skills/use-og-form/SKILL.md +12 -0
  77. package/templates/current/clean/.qoder/skills/use-og-form-table/SKILL.md +25 -0
  78. package/templates/current/clean/.qoder/skills/use-og-http/SKILL.md +13 -0
  79. package/templates/current/clean/.qoder/skills/use-og-router-tabs/SKILL.md +11 -0
  80. package/templates/current/clean/.qoder/skills/use-og-search/SKILL.md +14 -0
  81. package/templates/current/clean/.qoder/skills/use-og-table/SKILL.md +16 -0
  82. package/templates/current/clean/.qoder/skills/use-og-upload/SKILL.md +25 -0
  83. package/templates/current/clean/AGENTS.md +16 -0
  84. package/templates/current/clean/README.md +116 -0
  85. package/templates/current/clean/component-catalog.json +765 -0
  86. package/templates/current/clean/e2e/admin-shell.spec.ts +150 -0
  87. package/templates/current/clean/e2e/demo-shell.spec.ts +328 -0
  88. package/templates/current/clean/evals/component-selection.json +29 -0
  89. package/templates/current/clean/gitignore +3 -0
  90. package/templates/current/clean/index.html +13 -0
  91. package/templates/current/clean/openapi.json +1623 -0
  92. package/templates/current/clean/package.json +65 -0
  93. package/templates/current/clean/playwright.config.ts +31 -0
  94. package/templates/current/clean/playwright.demo.config.ts +25 -0
  95. package/templates/current/clean/recipes/README.md +7 -0
  96. package/templates/current/clean/recipes/remote-crud-dialog-form.json +15 -0
  97. package/templates/current/clean/recipes/remote-crud-dialog-form.vue +66 -0
  98. package/templates/current/clean/scaffold.lock.json +12 -0
  99. package/templates/current/clean/scripts/check-admin-bundle.mjs +214 -0
  100. package/templates/current/clean/scripts/check-admin-scaffold.mjs +168 -0
  101. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/Forbidden.vue +26 -0
  102. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/NotFound.vue +26 -0
  103. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/ServerError.vue +26 -0
  104. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/error-pages.spec.ts +32 -0
  105. package/templates/current/clean/scripts/clean-overlay/src/main.ts +91 -0
  106. package/templates/current/clean/scripts/clean-overlay/src/router/componentRegistry.ts +25 -0
  107. package/templates/current/clean/scripts/clean-overlay/src/router/dynamicRoutes.spec.ts +47 -0
  108. package/templates/current/clean/scripts/clean-overlay/src/router/staticRoutes.ts +63 -0
  109. package/templates/current/clean/scripts/demo-api.ts +797 -0
  110. package/templates/current/clean/scripts/generate-api.ts +27 -0
  111. package/templates/current/clean/scripts/performance/baselines/bundle-gzip-v2-pre-entry-unification.json +38 -0
  112. package/templates/current/clean/scripts/remove-examples.mjs +54 -0
  113. package/templates/current/clean/src/App.vue +67 -0
  114. package/templates/current/clean/src/api/client.spec.ts +66 -0
  115. package/templates/current/clean/src/api/client.ts +72 -0
  116. package/templates/current/clean/src/api/generated/data-contracts.ts +268 -0
  117. package/templates/current/clean/src/api/generated/http-client.ts +266 -0
  118. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/345/206/205/345/256/271/346/226/207/347/253/240.ts +147 -0
  119. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/345/256/241/350/256/241.ts +53 -0
  120. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/346/226/207/344/273/266/344/270/212/344/274/240.ts +66 -0
  121. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/347/224/250/346/210/267.ts +171 -0
  122. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/217/234/345/215/225.ts +181 -0
  123. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/247/222/350/211/262.ts +169 -0
  124. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/256/242/345/215/225/350/215/211/347/250/277.ts +170 -0
  125. package/templates/current/clean/src/api/generated//350/256/244/350/257/201.ts +98 -0
  126. package/templates/current/clean/src/api/http-adapter.spec.ts +33 -0
  127. package/templates/current/clean/src/api/http-adapter.ts +83 -0
  128. package/templates/current/clean/src/api/index.ts +41 -0
  129. package/templates/current/clean/src/app/createAdminUi.spec.ts +110 -0
  130. package/templates/current/clean/src/app/createAdminUi.ts +78 -0
  131. package/templates/current/clean/src/app/menu.spec.ts +255 -0
  132. package/templates/current/clean/src/app/menu.ts +268 -0
  133. package/templates/current/clean/src/app/menuTypes.ts +17 -0
  134. package/templates/current/clean/src/app/origenUiLocale.spec.ts +14 -0
  135. package/templates/current/clean/src/app/origenUiLocale.ts +65 -0
  136. package/templates/current/clean/src/app/permission.ts +9 -0
  137. package/templates/current/clean/src/app/runtimeConfig.ts +77 -0
  138. package/templates/current/clean/src/demo-api.spec.ts +167 -0
  139. package/templates/current/clean/src/env.d.ts +14 -0
  140. package/templates/current/clean/src/features/appearance/components/ThemePanel.vue +200 -0
  141. package/templates/current/clean/src/features/appearance/composables/useTheme.ts +17 -0
  142. package/templates/current/clean/src/features/appearance/store/theme.ts +140 -0
  143. package/templates/current/clean/src/features/auth/pages/Login.vue +159 -0
  144. package/templates/current/clean/src/features/auth/store/auth.spec.ts +131 -0
  145. package/templates/current/clean/src/features/auth/store/auth.ts +210 -0
  146. package/templates/current/clean/src/features/errors/pages/Forbidden.vue +26 -0
  147. package/templates/current/clean/src/features/errors/pages/NotFound.vue +26 -0
  148. package/templates/current/clean/src/features/errors/pages/ServerError.vue +26 -0
  149. package/templates/current/clean/src/features/errors/pages/error-pages.spec.ts +32 -0
  150. package/templates/current/clean/src/features/security/components/DevtoolsProtectionOverlay.vue +56 -0
  151. package/templates/current/clean/src/features/security/devtoolsProtection.spec.ts +211 -0
  152. package/templates/current/clean/src/features/security/devtoolsProtection.ts +242 -0
  153. package/templates/current/clean/src/features/shell/components/AdminWatermark.spec.ts +90 -0
  154. package/templates/current/clean/src/features/shell/components/AdminWatermark.vue +47 -0
  155. package/templates/current/clean/src/features/shell/components/RouteProgress.vue +68 -0
  156. package/templates/current/clean/src/features/shell/composables/useRouteProgress.spec.ts +95 -0
  157. package/templates/current/clean/src/features/shell/composables/useRouteProgress.ts +52 -0
  158. package/templates/current/clean/src/features/shell/store/sidebar.ts +55 -0
  159. package/templates/current/clean/src/features/system/access/api/admin-repository.ts +279 -0
  160. package/templates/current/clean/src/features/system/access/api/rbac.spec.ts +72 -0
  161. package/templates/current/clean/src/features/system/access/api/rbac.ts +272 -0
  162. package/templates/current/clean/src/features/system/access/composables/useAuthorizationRefresh.ts +15 -0
  163. package/templates/current/clean/src/features/workspace/pages/Empty.vue +18 -0
  164. package/templates/current/clean/src/features/workspace/pages/Profile.vue +183 -0
  165. package/templates/current/clean/src/layouts/AdminLayout.vue +61 -0
  166. package/templates/current/clean/src/layouts/BreadcrumbBar.vue +27 -0
  167. package/templates/current/clean/src/layouts/SideMenu.vue +119 -0
  168. package/templates/current/clean/src/layouts/TopBar.vue +301 -0
  169. package/templates/current/clean/src/layouts/WorkspaceTabs.vue +44 -0
  170. package/templates/current/clean/src/layouts/topBarMenuSearch.spec.ts +31 -0
  171. package/templates/current/clean/src/layouts/topBarMenuSearch.ts +21 -0
  172. package/templates/current/clean/src/locales/en-US.ts +55 -0
  173. package/templates/current/clean/src/locales/index.ts +119 -0
  174. package/templates/current/clean/src/locales/messages.spec.ts +23 -0
  175. package/templates/current/clean/src/locales/zh-CN.ts +55 -0
  176. package/templates/current/clean/src/locales/zh-TW.ts +44 -0
  177. package/templates/current/clean/src/main.ts +91 -0
  178. package/templates/current/clean/src/router/bootstrap.ts +76 -0
  179. package/templates/current/clean/src/router/componentRegistry.ts +25 -0
  180. package/templates/current/clean/src/router/dynamicRoutes.spec.ts +47 -0
  181. package/templates/current/clean/src/router/dynamicRoutes.ts +162 -0
  182. package/templates/current/clean/src/router/guards.ts +5 -0
  183. package/templates/current/clean/src/router/queryEncryption.spec.ts +82 -0
  184. package/templates/current/clean/src/router/queryEncryption.ts +133 -0
  185. package/templates/current/clean/src/router/routeQuery.spec.ts +11 -0
  186. package/templates/current/clean/src/router/routeQuery.ts +3 -0
  187. package/templates/current/clean/src/router/runtimeErrorRecovery.spec.ts +161 -0
  188. package/templates/current/clean/src/router/runtimeErrorRecovery.ts +108 -0
  189. package/templates/current/clean/src/router/staticRoutes.ts +63 -0
  190. package/templates/current/clean/src/router/useRouteQueryDefaults.spec.ts +90 -0
  191. package/templates/current/clean/src/router/useRouteQueryDefaults.ts +51 -0
  192. package/templates/current/clean/src/router/useRouteQueryDefaults.types.ts +19 -0
  193. package/templates/current/clean/src/store/index.ts +3 -0
  194. package/templates/current/clean/src/styles/element/index.scss +33 -0
  195. package/templates/current/clean/src/styles/index.css +39 -0
  196. package/templates/current/clean/src/styles/layout.css +115 -0
  197. package/templates/current/clean/src/styles/shell.css +196 -0
  198. package/templates/current/clean/src/styles/source-package-style-compat.css +1 -0
  199. package/templates/current/clean/src/templates/og-form.ts +48 -0
  200. package/templates/current/clean/src/templates/og-table.ts +212 -0
  201. package/templates/current/clean/src/templates/router.ts +51 -0
  202. package/templates/current/clean/src/templates/templates.spec.ts +90 -0
  203. package/templates/current/clean/src/theme/index.ts +7 -0
  204. package/templates/current/clean/src/utils/__tests__/color-mix.spec.ts +39 -0
  205. package/templates/current/clean/src/utils/color-mix.ts +76 -0
  206. package/templates/current/clean/src/utils/permissions.ts +6 -0
  207. package/templates/current/clean/tsconfig.json +40 -0
  208. package/templates/current/clean/tsconfig.node.json +9 -0
  209. package/templates/current/clean/vite.build-policy.ts +405 -0
  210. package/templates/current/clean/vite.config.ts +37 -0
  211. package/templates/current/examples/.codebuddy/AGENTS.md +18 -0
  212. package/templates/current/examples/.codebuddy/rules/01-feature-architecture.md +12 -0
  213. package/templates/current/examples/.codebuddy/rules/02-vue-typescript.md +12 -0
  214. package/templates/current/examples/.codebuddy/rules/03-component-policy.md +30 -0
  215. package/templates/current/examples/.codebuddy/rules/04-api-auth-router.md +12 -0
  216. package/templates/current/examples/.codebuddy/rules/05-style.md +12 -0
  217. package/templates/current/examples/.codebuddy/rules/06-quality.md +12 -0
  218. package/templates/current/examples/.codebuddy/skills/build-admin-feature/SKILL.md +17 -0
  219. package/templates/current/examples/.codebuddy/skills/style-og-origen-ui/SKILL.md +14 -0
  220. package/templates/current/examples/.codebuddy/skills/use-og-dialog/SKILL.md +15 -0
  221. package/templates/current/examples/.codebuddy/skills/use-og-editor/SKILL.md +28 -0
  222. package/templates/current/examples/.codebuddy/skills/use-og-form/SKILL.md +15 -0
  223. package/templates/current/examples/.codebuddy/skills/use-og-form-table/SKILL.md +28 -0
  224. package/templates/current/examples/.codebuddy/skills/use-og-http/SKILL.md +16 -0
  225. package/templates/current/examples/.codebuddy/skills/use-og-router-tabs/SKILL.md +14 -0
  226. package/templates/current/examples/.codebuddy/skills/use-og-search/SKILL.md +17 -0
  227. package/templates/current/examples/.codebuddy/skills/use-og-table/SKILL.md +19 -0
  228. package/templates/current/examples/.codebuddy/skills/use-og-upload/SKILL.md +28 -0
  229. package/templates/current/examples/.codex/AGENTS.md +15 -0
  230. package/templates/current/examples/.codex/rules/01-feature-architecture.md +6 -0
  231. package/templates/current/examples/.codex/rules/02-vue-typescript.md +6 -0
  232. package/templates/current/examples/.codex/rules/03-component-policy.md +24 -0
  233. package/templates/current/examples/.codex/rules/04-api-auth-router.md +6 -0
  234. package/templates/current/examples/.codex/rules/05-style.md +6 -0
  235. package/templates/current/examples/.codex/rules/06-quality.md +6 -0
  236. package/templates/current/examples/.codex/skills/build-admin-feature/SKILL.md +14 -0
  237. package/templates/current/examples/.codex/skills/build-admin-feature/references/component-selection.md +25 -0
  238. package/templates/current/examples/.codex/skills/style-og-origen-ui/SKILL.md +11 -0
  239. package/templates/current/examples/.codex/skills/style-og-origen-ui/agents/openai.yaml +4 -0
  240. package/templates/current/examples/.codex/skills/use-og-dialog/SKILL.md +12 -0
  241. package/templates/current/examples/.codex/skills/use-og-dialog/agents/openai.yaml +4 -0
  242. package/templates/current/examples/.codex/skills/use-og-editor/SKILL.md +25 -0
  243. package/templates/current/examples/.codex/skills/use-og-form/SKILL.md +12 -0
  244. package/templates/current/examples/.codex/skills/use-og-form-table/SKILL.md +25 -0
  245. package/templates/current/examples/.codex/skills/use-og-http/SKILL.md +13 -0
  246. package/templates/current/examples/.codex/skills/use-og-http/agents/openai.yaml +4 -0
  247. package/templates/current/examples/.codex/skills/use-og-router-tabs/SKILL.md +11 -0
  248. package/templates/current/examples/.codex/skills/use-og-search/SKILL.md +14 -0
  249. package/templates/current/examples/.codex/skills/use-og-table/SKILL.md +16 -0
  250. package/templates/current/examples/.codex/skills/use-og-upload/SKILL.md +25 -0
  251. package/templates/current/examples/.cursor/AGENTS.md +18 -0
  252. package/templates/current/examples/.cursor/rules/01-feature-architecture.mdc +12 -0
  253. package/templates/current/examples/.cursor/rules/02-vue-typescript.mdc +12 -0
  254. package/templates/current/examples/.cursor/rules/03-component-policy.mdc +30 -0
  255. package/templates/current/examples/.cursor/rules/04-api-auth-router.mdc +12 -0
  256. package/templates/current/examples/.cursor/rules/05-style.mdc +12 -0
  257. package/templates/current/examples/.cursor/rules/06-quality.mdc +12 -0
  258. package/templates/current/examples/.cursor/skills/build-admin-feature/SKILL.md +14 -0
  259. package/templates/current/examples/.cursor/skills/style-og-origen-ui/SKILL.md +11 -0
  260. package/templates/current/examples/.cursor/skills/use-og-dialog/SKILL.md +12 -0
  261. package/templates/current/examples/.cursor/skills/use-og-editor/SKILL.md +25 -0
  262. package/templates/current/examples/.cursor/skills/use-og-form/SKILL.md +12 -0
  263. package/templates/current/examples/.cursor/skills/use-og-form-table/SKILL.md +25 -0
  264. package/templates/current/examples/.cursor/skills/use-og-http/SKILL.md +13 -0
  265. package/templates/current/examples/.cursor/skills/use-og-router-tabs/SKILL.md +11 -0
  266. package/templates/current/examples/.cursor/skills/use-og-search/SKILL.md +14 -0
  267. package/templates/current/examples/.cursor/skills/use-og-table/SKILL.md +16 -0
  268. package/templates/current/examples/.cursor/skills/use-og-upload/SKILL.md +25 -0
  269. package/templates/current/examples/.env.example +7 -0
  270. package/templates/current/examples/.env.production.example +31 -0
  271. package/templates/current/examples/.qoder/AGENTS.md +15 -0
  272. package/templates/current/examples/.qoder/rules/01-feature-architecture.md +12 -0
  273. package/templates/current/examples/.qoder/rules/02-vue-typescript.md +12 -0
  274. package/templates/current/examples/.qoder/rules/03-component-policy.md +30 -0
  275. package/templates/current/examples/.qoder/rules/04-api-auth-router.md +12 -0
  276. package/templates/current/examples/.qoder/rules/05-style.md +12 -0
  277. package/templates/current/examples/.qoder/rules/06-quality.md +12 -0
  278. package/templates/current/examples/.qoder/skills/build-admin-feature/SKILL.md +14 -0
  279. package/templates/current/examples/.qoder/skills/style-og-origen-ui/SKILL.md +11 -0
  280. package/templates/current/examples/.qoder/skills/use-og-dialog/SKILL.md +12 -0
  281. package/templates/current/examples/.qoder/skills/use-og-editor/SKILL.md +25 -0
  282. package/templates/current/examples/.qoder/skills/use-og-form/SKILL.md +12 -0
  283. package/templates/current/examples/.qoder/skills/use-og-form-table/SKILL.md +25 -0
  284. package/templates/current/examples/.qoder/skills/use-og-http/SKILL.md +13 -0
  285. package/templates/current/examples/.qoder/skills/use-og-router-tabs/SKILL.md +11 -0
  286. package/templates/current/examples/.qoder/skills/use-og-search/SKILL.md +14 -0
  287. package/templates/current/examples/.qoder/skills/use-og-table/SKILL.md +16 -0
  288. package/templates/current/examples/.qoder/skills/use-og-upload/SKILL.md +25 -0
  289. package/templates/current/examples/AGENTS.md +16 -0
  290. package/templates/current/examples/README.md +116 -0
  291. package/templates/current/examples/component-catalog.json +765 -0
  292. package/templates/current/examples/e2e/admin-shell.spec.ts +150 -0
  293. package/templates/current/examples/e2e/demo-shell.spec.ts +328 -0
  294. package/templates/current/examples/evals/component-selection.json +29 -0
  295. package/templates/current/examples/gitignore +3 -0
  296. package/templates/current/examples/index.html +13 -0
  297. package/templates/current/examples/openapi.json +1623 -0
  298. package/templates/current/examples/package.json +65 -0
  299. package/templates/current/examples/playwright.config.ts +31 -0
  300. package/templates/current/examples/playwright.demo.config.ts +25 -0
  301. package/templates/current/examples/recipes/README.md +7 -0
  302. package/templates/current/examples/recipes/remote-crud-dialog-form.json +15 -0
  303. package/templates/current/examples/recipes/remote-crud-dialog-form.vue +66 -0
  304. package/templates/current/examples/scaffold.lock.json +12 -0
  305. package/templates/current/examples/scripts/check-admin-bundle.mjs +214 -0
  306. package/templates/current/examples/scripts/check-admin-scaffold.mjs +168 -0
  307. package/templates/current/examples/scripts/clean-overlay/src/features/errors/pages/Forbidden.vue +26 -0
  308. package/templates/current/examples/scripts/clean-overlay/src/features/errors/pages/NotFound.vue +26 -0
  309. package/templates/current/examples/scripts/clean-overlay/src/features/errors/pages/ServerError.vue +26 -0
  310. package/templates/current/examples/scripts/clean-overlay/src/features/errors/pages/error-pages.spec.ts +32 -0
  311. package/templates/current/examples/scripts/clean-overlay/src/main.ts +91 -0
  312. package/templates/current/examples/scripts/clean-overlay/src/router/componentRegistry.ts +25 -0
  313. package/templates/current/examples/scripts/clean-overlay/src/router/dynamicRoutes.spec.ts +47 -0
  314. package/templates/current/examples/scripts/clean-overlay/src/router/staticRoutes.ts +63 -0
  315. package/templates/current/examples/scripts/demo-api.ts +797 -0
  316. package/templates/current/examples/scripts/generate-api.ts +27 -0
  317. package/templates/current/examples/scripts/performance/baselines/bundle-gzip-v2-pre-entry-unification.json +38 -0
  318. package/templates/current/examples/scripts/remove-examples.mjs +54 -0
  319. package/templates/current/examples/src/App.vue +67 -0
  320. package/templates/current/examples/src/api/client.spec.ts +66 -0
  321. package/templates/current/examples/src/api/client.ts +72 -0
  322. package/templates/current/examples/src/api/generated/data-contracts.ts +268 -0
  323. package/templates/current/examples/src/api/generated/http-client.ts +266 -0
  324. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/345/206/205/345/256/271/346/226/207/347/253/240.ts +147 -0
  325. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/345/256/241/350/256/241.ts +53 -0
  326. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/346/226/207/344/273/266/344/270/212/344/274/240.ts +66 -0
  327. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/347/224/250/346/210/267.ts +171 -0
  328. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/217/234/345/215/225.ts +181 -0
  329. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/247/222/350/211/262.ts +169 -0
  330. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/256/242/345/215/225/350/215/211/347/250/277.ts +170 -0
  331. package/templates/current/examples/src/api/generated//350/256/244/350/257/201.ts +98 -0
  332. package/templates/current/examples/src/api/http-adapter.spec.ts +33 -0
  333. package/templates/current/examples/src/api/http-adapter.ts +83 -0
  334. package/templates/current/examples/src/api/index.ts +41 -0
  335. package/templates/current/examples/src/app/createAdminUi.spec.ts +110 -0
  336. package/templates/current/examples/src/app/createAdminUi.ts +78 -0
  337. package/templates/current/examples/src/app/menu.spec.ts +255 -0
  338. package/templates/current/examples/src/app/menu.ts +268 -0
  339. package/templates/current/examples/src/app/menuTypes.ts +17 -0
  340. package/templates/current/examples/src/app/origenUiLocale.spec.ts +14 -0
  341. package/templates/current/examples/src/app/origenUiLocale.ts +65 -0
  342. package/templates/current/examples/src/app/permission.ts +9 -0
  343. package/templates/current/examples/src/app/runtimeConfig.ts +77 -0
  344. package/templates/current/examples/src/demo-api.spec.ts +167 -0
  345. package/templates/current/examples/src/env.d.ts +14 -0
  346. package/templates/current/examples/src/features/appearance/components/ThemePanel.vue +200 -0
  347. package/templates/current/examples/src/features/appearance/composables/useTheme.ts +17 -0
  348. package/templates/current/examples/src/features/appearance/store/theme.ts +140 -0
  349. package/templates/current/examples/src/features/auth/pages/Login.vue +159 -0
  350. package/templates/current/examples/src/features/auth/store/auth.spec.ts +131 -0
  351. package/templates/current/examples/src/features/auth/store/auth.ts +210 -0
  352. package/templates/current/examples/src/features/errors/pages/Forbidden.vue +26 -0
  353. package/templates/current/examples/src/features/errors/pages/NotFound.vue +26 -0
  354. package/templates/current/examples/src/features/errors/pages/ServerError.vue +26 -0
  355. package/templates/current/examples/src/features/errors/pages/error-pages.spec.ts +32 -0
  356. package/templates/current/examples/src/features/feature-composables.spec.ts +208 -0
  357. package/templates/current/examples/src/features/security/components/DevtoolsProtectionOverlay.vue +56 -0
  358. package/templates/current/examples/src/features/security/devtoolsProtection.spec.ts +211 -0
  359. package/templates/current/examples/src/features/security/devtoolsProtection.ts +242 -0
  360. package/templates/current/examples/src/features/shell/components/AdminWatermark.spec.ts +90 -0
  361. package/templates/current/examples/src/features/shell/components/AdminWatermark.vue +47 -0
  362. package/templates/current/examples/src/features/shell/components/RouteProgress.vue +68 -0
  363. package/templates/current/examples/src/features/shell/composables/useRouteProgress.spec.ts +95 -0
  364. package/templates/current/examples/src/features/shell/composables/useRouteProgress.ts +52 -0
  365. package/templates/current/examples/src/features/shell/store/sidebar.ts +55 -0
  366. package/templates/current/examples/src/features/system/access/api/admin-repository.ts +279 -0
  367. package/templates/current/examples/src/features/system/access/api/rbac.spec.ts +72 -0
  368. package/templates/current/examples/src/features/system/access/api/rbac.ts +272 -0
  369. package/templates/current/examples/src/features/system/access/composables/useAuthorizationRefresh.ts +15 -0
  370. package/templates/current/examples/src/features/system/audit/composables/useAuditManagement.ts +117 -0
  371. package/templates/current/examples/src/features/system/audit/pages/AuditList.vue +20 -0
  372. package/templates/current/examples/src/features/system/menus/components/MenuEditorForm.vue +189 -0
  373. package/templates/current/examples/src/features/system/menus/composables/useMenuManagement.ts +327 -0
  374. package/templates/current/examples/src/features/system/menus/pages/MenuList.vue +49 -0
  375. package/templates/current/examples/src/features/system/roles/components/RoleEditorForm.vue +112 -0
  376. package/templates/current/examples/src/features/system/roles/composables/useRoleManagement.ts +198 -0
  377. package/templates/current/examples/src/features/system/roles/pages/RoleList.vue +45 -0
  378. package/templates/current/examples/src/features/system/users/components/UserEditorForm.vue +101 -0
  379. package/templates/current/examples/src/features/system/users/composables/useUserManagement.ts +233 -0
  380. package/templates/current/examples/src/features/system/users/pages/UserList.vue +49 -0
  381. package/templates/current/examples/src/features/workspace/pages/Dashboard.spec.ts +32 -0
  382. package/templates/current/examples/src/features/workspace/pages/Dashboard.vue +297 -0
  383. package/templates/current/examples/src/features/workspace/pages/Empty.vue +18 -0
  384. package/templates/current/examples/src/features/workspace/pages/Profile.vue +183 -0
  385. package/templates/current/examples/src/layouts/AdminLayout.vue +61 -0
  386. package/templates/current/examples/src/layouts/BreadcrumbBar.vue +27 -0
  387. package/templates/current/examples/src/layouts/SideMenu.vue +119 -0
  388. package/templates/current/examples/src/layouts/TopBar.vue +301 -0
  389. package/templates/current/examples/src/layouts/WorkspaceTabs.vue +44 -0
  390. package/templates/current/examples/src/layouts/topBarMenuSearch.spec.ts +31 -0
  391. package/templates/current/examples/src/layouts/topBarMenuSearch.ts +21 -0
  392. package/templates/current/examples/src/locales/en-US.ts +55 -0
  393. package/templates/current/examples/src/locales/index.ts +119 -0
  394. package/templates/current/examples/src/locales/messages.spec.ts +23 -0
  395. package/templates/current/examples/src/locales/zh-CN.ts +55 -0
  396. package/templates/current/examples/src/locales/zh-TW.ts +44 -0
  397. package/templates/current/examples/src/main.ts +91 -0
  398. package/templates/current/examples/src/router/bootstrap.ts +76 -0
  399. package/templates/current/examples/src/router/componentRegistry.ts +83 -0
  400. package/templates/current/examples/src/router/dynamicRoutes.spec.ts +109 -0
  401. package/templates/current/examples/src/router/dynamicRoutes.ts +162 -0
  402. package/templates/current/examples/src/router/guards.ts +5 -0
  403. package/templates/current/examples/src/router/queryEncryption.spec.ts +82 -0
  404. package/templates/current/examples/src/router/queryEncryption.ts +133 -0
  405. package/templates/current/examples/src/router/routeQuery.spec.ts +11 -0
  406. package/templates/current/examples/src/router/routeQuery.ts +3 -0
  407. package/templates/current/examples/src/router/runtimeErrorRecovery.spec.ts +161 -0
  408. package/templates/current/examples/src/router/runtimeErrorRecovery.ts +108 -0
  409. package/templates/current/examples/src/router/staticRoutes.ts +63 -0
  410. package/templates/current/examples/src/router/useRouteQueryDefaults.spec.ts +90 -0
  411. package/templates/current/examples/src/router/useRouteQueryDefaults.ts +51 -0
  412. package/templates/current/examples/src/router/useRouteQueryDefaults.types.ts +19 -0
  413. package/templates/current/examples/src/store/index.ts +3 -0
  414. package/templates/current/examples/src/styles/element/index.scss +33 -0
  415. package/templates/current/examples/src/styles/index.css +39 -0
  416. package/templates/current/examples/src/styles/layout.css +115 -0
  417. package/templates/current/examples/src/styles/shell.css +196 -0
  418. package/templates/current/examples/src/styles/source-package-style-compat.css +1 -0
  419. package/templates/current/examples/src/templates/og-form.ts +48 -0
  420. package/templates/current/examples/src/templates/og-table.ts +212 -0
  421. package/templates/current/examples/src/templates/router.ts +51 -0
  422. package/templates/current/examples/src/templates/templates.spec.ts +90 -0
  423. package/templates/current/examples/src/theme/index.ts +7 -0
  424. package/templates/current/examples/src/utils/__tests__/color-mix.spec.ts +39 -0
  425. package/templates/current/examples/src/utils/color-mix.ts +76 -0
  426. package/templates/current/examples/src/utils/permissions.ts +6 -0
  427. package/templates/current/examples/tsconfig.json +40 -0
  428. package/templates/current/examples/tsconfig.node.json +9 -0
  429. package/templates/current/examples/vite.build-policy.ts +405 -0
  430. package/templates/current/examples/vite.config.ts +37 -0
@@ -0,0 +1,133 @@
1
+ import type { LocationQuery, LocationQueryRaw } from 'vue-router'
2
+ import AES from 'crypto-js/aes'
3
+ import CryptoJS from 'crypto-js/core'
4
+ import Base64 from 'crypto-js/enc-base64'
5
+ import HmacSHA256 from 'crypto-js/hmac-sha256'
6
+
7
+ const QUERY_PARAMETER = '_q'
8
+ const VERSION = 'v1'
9
+ const HEX_KEY = /^[\dA-F]{64}$/i
10
+ const URL_SAFE_BASE64 = /^[\w-]+$/
11
+
12
+ type QueryValue = string | null | string[] | (string | null)[]
13
+ type EncodedQuery = Record<string, QueryValue>
14
+
15
+ export interface RouteQueryEncryptionOptions {
16
+ enabled?: boolean
17
+ key?: string
18
+ }
19
+
20
+ export interface RouteQueryEncryption {
21
+ parseQuery: (search: string) => LocationQuery
22
+ stringifyQuery: (query: LocationQueryRaw | undefined) => string
23
+ }
24
+
25
+ function toUrlSafeBase64(value: CryptoJS.lib.WordArray): string {
26
+ return Base64.stringify(value).replaceAll('+', '-').replaceAll('/', '_').replace(/=+$/u, '')
27
+ }
28
+
29
+ function fromUrlSafeBase64(value: string): CryptoJS.lib.WordArray | undefined {
30
+ if (!URL_SAFE_BASE64.test(value)) return undefined
31
+ const padded = `${value.replaceAll('-', '+').replaceAll('_', '/')}${'='.repeat((4 - (value.length % 4)) % 4)}`
32
+ return Base64.parse(padded)
33
+ }
34
+
35
+ function equalsMac(left: string, right: string): boolean {
36
+ if (left.length !== right.length) return false
37
+ let difference = 0
38
+ for (let index = 0; index < left.length; index += 1)
39
+ difference |= left.charCodeAt(index) ^ right.charCodeAt(index)
40
+ return difference === 0
41
+ }
42
+
43
+ function normalizeQuery(query: LocationQueryRaw | undefined): EncodedQuery {
44
+ const normalized: EncodedQuery = {}
45
+ if (!query) return normalized
46
+ for (const [key, value] of Object.entries(query)) {
47
+ if (value === undefined) continue
48
+ if (Array.isArray(value)) {
49
+ normalized[key] = value
50
+ .filter((item): item is string | null => item !== undefined)
51
+ .map((item) => (item === null ? null : String(item)))
52
+ } else {
53
+ normalized[key] = value === null ? null : String(value)
54
+ }
55
+ }
56
+ return normalized
57
+ }
58
+
59
+ function isEncodedQuery(value: unknown): value is EncodedQuery {
60
+ if (!value || typeof value !== 'object' || Array.isArray(value)) return false
61
+ return Object.values(value).every(
62
+ (item) =>
63
+ item === null ||
64
+ typeof item === 'string' ||
65
+ (Array.isArray(item) && item.every((entry) => entry === null || typeof entry === 'string')),
66
+ )
67
+ }
68
+
69
+ function readCiphertext(search: string): string | undefined {
70
+ const parameters = new URLSearchParams(search.startsWith('?') ? search.slice(1) : search)
71
+ const values = parameters.getAll(QUERY_PARAMETER)
72
+ return values.length === 1 ? values[0] : undefined
73
+ }
74
+
75
+ export function createRouteQueryEncryption(
76
+ options: RouteQueryEncryptionOptions = {},
77
+ ): RouteQueryEncryption | undefined {
78
+ if (!options.enabled) return undefined
79
+ if (!options.key || !HEX_KEY.test(options.key)) {
80
+ throw new Error(
81
+ 'VITE_ROUTE_QUERY_KEY must be a 64-character hexadecimal key when route query encryption is enabled.',
82
+ )
83
+ }
84
+
85
+ const encryptionKey = CryptoJS.enc.Hex.parse(options.key)
86
+ const authenticationKey = HmacSHA256('route-query-authentication', encryptionKey)
87
+
88
+ function mac(value: string): string {
89
+ return HmacSHA256(value, authenticationKey).toString(CryptoJS.enc.Hex)
90
+ }
91
+
92
+ return {
93
+ stringifyQuery(query) {
94
+ const normalized = normalizeQuery(query)
95
+ if (Object.keys(normalized).length === 0) return ''
96
+ const iv = CryptoJS.lib.WordArray.random(16)
97
+ const ciphertext = AES.encrypt(JSON.stringify(normalized), encryptionKey, { iv }).ciphertext
98
+ const payload = `${VERSION}.${toUrlSafeBase64(iv)}.${toUrlSafeBase64(ciphertext)}`
99
+ return `${QUERY_PARAMETER}=${encodeURIComponent(`${payload}.${mac(payload)}`)}`
100
+ },
101
+ parseQuery(search) {
102
+ const value = readCiphertext(search)
103
+ if (!value) return {}
104
+ try {
105
+ const [version, ivValue, ciphertextValue, suppliedMac, ...extra] = value.split('.')
106
+ if (
107
+ version !== VERSION ||
108
+ !ivValue ||
109
+ !ciphertextValue ||
110
+ !suppliedMac ||
111
+ extra.length > 0 ||
112
+ !/^[\dA-F]{64}$/i.test(suppliedMac)
113
+ ) {
114
+ return {}
115
+ }
116
+ const payload = `${version}.${ivValue}.${ciphertextValue}`
117
+ if (!equalsMac(suppliedMac, mac(payload))) return {}
118
+ const iv = fromUrlSafeBase64(ivValue)
119
+ const ciphertext = fromUrlSafeBase64(ciphertextValue)
120
+ if (!iv || !ciphertext) return {}
121
+ const plaintext = AES.decrypt(
122
+ CryptoJS.lib.CipherParams.create({ ciphertext }),
123
+ encryptionKey,
124
+ { iv },
125
+ ).toString(CryptoJS.enc.Utf8)
126
+ const query: unknown = JSON.parse(plaintext)
127
+ return isEncodedQuery(query) ? (query as LocationQuery) : {}
128
+ } catch {
129
+ return {}
130
+ }
131
+ },
132
+ }
133
+ }
@@ -0,0 +1,11 @@
1
+ import { describe, expect, it } from 'vitest'
2
+ import { routeStatus } from './routeQuery'
3
+
4
+ describe('route query helpers', () => {
5
+ it('accepts only supported status values', () => {
6
+ expect(routeStatus('active')).toBe('active')
7
+ expect(routeStatus('suspended')).toBe('suspended')
8
+ expect(routeStatus(['suspended'])).toBeUndefined()
9
+ expect(routeStatus('unknown')).toBeUndefined()
10
+ })
11
+ })
@@ -0,0 +1,3 @@
1
+ export function routeStatus(value: unknown): 'active' | 'suspended' | undefined {
2
+ return value === 'active' || value === 'suspended' ? value : undefined
3
+ }
@@ -0,0 +1,161 @@
1
+ import { beforeEach, describe, expect, it, vi } from 'vitest'
2
+ import { ref } from 'vue'
3
+ import {
4
+ createRuntimeErrorRecovery,
5
+ createStaleAssetRecovery,
6
+ isStaleAssetLoadError,
7
+ staleAssetRecoveryStorageKey,
8
+ } from './runtimeErrorRecovery'
9
+
10
+ describe('createRuntimeErrorRecovery', () => {
11
+ const currentRoute = ref({ path: '/dashboard' })
12
+ const push = vi.fn()
13
+
14
+ beforeEach(() => {
15
+ currentRoute.value = { path: '/dashboard' }
16
+ push.mockReset()
17
+ })
18
+
19
+ it('redirects an unexpected runtime error to the static 500 route', async () => {
20
+ push.mockResolvedValue(undefined)
21
+ const recover = createRuntimeErrorRecovery({ currentRoute, push } as never)
22
+
23
+ recover()
24
+ await Promise.resolve()
25
+
26
+ expect(push).toHaveBeenCalledOnce()
27
+ expect(push).toHaveBeenCalledWith({ name: '500' })
28
+ })
29
+
30
+ it('does not redirect again when the server-error page itself fails', () => {
31
+ currentRoute.value = { path: '/500' }
32
+ const recover = createRuntimeErrorRecovery({ currentRoute, push } as never)
33
+
34
+ recover()
35
+
36
+ expect(push).not.toHaveBeenCalled()
37
+ })
38
+
39
+ it('keeps only one redirect active until navigation settles', async () => {
40
+ let resolveNavigation!: () => void
41
+ push.mockReturnValue(
42
+ new Promise<void>((resolve) => {
43
+ resolveNavigation = resolve
44
+ }),
45
+ )
46
+ const recover = createRuntimeErrorRecovery({ currentRoute, push } as never)
47
+
48
+ recover()
49
+ recover()
50
+ expect(push).toHaveBeenCalledOnce()
51
+
52
+ resolveNavigation()
53
+ await Promise.resolve()
54
+ await Promise.resolve()
55
+ recover()
56
+
57
+ expect(push).toHaveBeenCalledTimes(2)
58
+ })
59
+
60
+ it('allows a later recovery when the redirect cannot be completed', async () => {
61
+ push.mockRejectedValueOnce(new Error('navigation failed')).mockResolvedValueOnce(undefined)
62
+ const recover = createRuntimeErrorRecovery({ currentRoute, push } as never)
63
+
64
+ recover()
65
+ await Promise.resolve()
66
+ await Promise.resolve()
67
+ recover()
68
+
69
+ expect(push).toHaveBeenCalledTimes(2)
70
+ })
71
+ })
72
+
73
+ describe('createStaleAssetRecovery', () => {
74
+ const currentRoute = ref({ path: '/dashboard' })
75
+ const push = vi.fn()
76
+ const onError = vi.fn()
77
+ const addEventListener = vi.fn()
78
+ const removeEventListener = vi.fn()
79
+ const reload = vi.fn()
80
+ const storage = new Map<string, string>()
81
+ const sessionStorage = {
82
+ getItem: (key: string) => storage.get(key) ?? null,
83
+ setItem: (key: string, value: string) => storage.set(key, value),
84
+ removeItem: (key: string) => storage.delete(key),
85
+ }
86
+
87
+ beforeEach(() => {
88
+ currentRoute.value = { path: '/dashboard' }
89
+ push.mockReset()
90
+ onError.mockReset()
91
+ addEventListener.mockReset()
92
+ removeEventListener.mockReset()
93
+ reload.mockReset()
94
+ storage.clear()
95
+ })
96
+
97
+ function createRecovery(recoverRuntimeError = vi.fn()) {
98
+ const recovery = createStaleAssetRecovery({
99
+ router: { currentRoute, push, onError } as never,
100
+ window: { addEventListener, location: { reload }, removeEventListener, sessionStorage },
101
+ recoverRuntimeError,
102
+ })
103
+ return { recovery, recoverRuntimeError }
104
+ }
105
+
106
+ it.each([
107
+ 'ChunkLoadError: Loading chunk 17 failed',
108
+ 'Failed to fetch dynamically imported module',
109
+ 'Importing a module script failed',
110
+ 'Failed to preload CSS: /assets/page.css',
111
+ ])('recognizes stale Vite assets: %s', (message) => {
112
+ expect(isStaleAssetLoadError(new Error(message))).toBe(true)
113
+ })
114
+
115
+ it('ignores unrelated errors', () => {
116
+ expect(isStaleAssetLoadError(new Error('Request failed with status code 500'))).toBe(false)
117
+ })
118
+
119
+ it('refreshes once for a stale asset error and clears the marker after mounting', () => {
120
+ const { recovery, recoverRuntimeError } = createRecovery()
121
+
122
+ expect(recovery.handle(new Error('Failed to fetch dynamically imported module'))).toBe(true)
123
+ expect(sessionStorage.getItem(staleAssetRecoveryStorageKey)).toBe('1')
124
+ expect(reload).toHaveBeenCalledOnce()
125
+ expect(recoverRuntimeError).not.toHaveBeenCalled()
126
+
127
+ recovery.clear()
128
+ expect(sessionStorage.getItem(staleAssetRecoveryStorageKey)).toBeNull()
129
+ })
130
+
131
+ it('falls back instead of refreshing repeatedly after a stale asset error', () => {
132
+ storage.set(staleAssetRecoveryStorageKey, '1')
133
+ const { recovery, recoverRuntimeError } = createRecovery()
134
+
135
+ expect(recovery.handle(new Error('Failed to preload CSS: /assets/page.css'))).toBe(true)
136
+ expect(reload).not.toHaveBeenCalled()
137
+ expect(recoverRuntimeError).toHaveBeenCalledOnce()
138
+ })
139
+
140
+ it('registers Vite preload and router error handlers before route loading', () => {
141
+ const { recovery, recoverRuntimeError } = createRecovery()
142
+ expect(addEventListener).toHaveBeenCalledWith('vite:preloadError', expect.any(Function))
143
+ expect(onError).toHaveBeenCalledOnce()
144
+
145
+ const preloadHandler = addEventListener.mock.calls[0]?.[1] as EventListener
146
+ const preventDefault = vi.fn()
147
+ preloadHandler({
148
+ payload: new Error('Failed to preload CSS: /assets/page.css'),
149
+ preventDefault,
150
+ } as unknown as Event)
151
+ expect(reload).toHaveBeenCalledOnce()
152
+ expect(preventDefault).toHaveBeenCalledOnce()
153
+
154
+ const routerHandler = onError.mock.calls[0]?.[0] as (error: unknown) => void
155
+ routerHandler(new Error('ordinary route failure'))
156
+ expect(recoverRuntimeError).toHaveBeenCalledOnce()
157
+
158
+ recovery.dispose()
159
+ expect(removeEventListener).toHaveBeenCalledWith('vite:preloadError', preloadHandler)
160
+ })
161
+ })
@@ -0,0 +1,108 @@
1
+ import type { Router } from 'vue-router'
2
+
3
+ type ErrorRecoveryRouter = Pick<Router, 'currentRoute' | 'push'>
4
+ type StaleAssetRouter = ErrorRecoveryRouter & Pick<Router, 'onError'>
5
+
6
+ export const staleAssetRecoveryStorageKey = 'og-admin-stale-asset-recovery'
7
+
8
+ interface StaleAssetRecoveryWindow {
9
+ addEventListener: (type: string, listener: EventListener) => void
10
+ removeEventListener: (type: string, listener: EventListener) => void
11
+ location: Pick<Location, 'reload'>
12
+ sessionStorage: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>
13
+ }
14
+
15
+ interface StaleAssetRecoveryOptions {
16
+ router: StaleAssetRouter
17
+ window: StaleAssetRecoveryWindow
18
+ recoverRuntimeError: () => void
19
+ }
20
+
21
+ function errorMessage(error: unknown): string {
22
+ if (error instanceof Error) return error.message
23
+ if (typeof error === 'string') return error
24
+ if (
25
+ typeof error === 'object' &&
26
+ error !== null &&
27
+ 'message' in error &&
28
+ typeof error.message === 'string'
29
+ ) {
30
+ return error.message
31
+ }
32
+ return ''
33
+ }
34
+
35
+ /** Detects Vite's missing hashed chunks, dynamic module imports, and CSS preload failures. */
36
+ export function isStaleAssetLoadError(error: unknown): boolean {
37
+ const message = errorMessage(error).toLowerCase()
38
+ return [
39
+ 'chunkloaderror',
40
+ 'failed to fetch dynamically imported module',
41
+ 'error loading dynamically imported module',
42
+ 'importing a module script failed',
43
+ 'failed to load module script',
44
+ 'failed to fetch module script',
45
+ 'failed to preload css',
46
+ 'loading chunk',
47
+ 'unable to preload css',
48
+ ].some((fragment) => message.includes(fragment))
49
+ }
50
+
51
+ /** Installs one-shot stale-build recovery before dynamic route loading begins. */
52
+ export function createStaleAssetRecovery(options: StaleAssetRecoveryOptions): {
53
+ dispose: () => void
54
+ handle: (error: unknown) => boolean
55
+ clear: () => void
56
+ } {
57
+ function clear(): void {
58
+ options.window.sessionStorage.removeItem(staleAssetRecoveryStorageKey)
59
+ }
60
+
61
+ function handle(error: unknown): boolean {
62
+ if (!isStaleAssetLoadError(error)) return false
63
+ if (options.window.sessionStorage.getItem(staleAssetRecoveryStorageKey)) {
64
+ options.recoverRuntimeError()
65
+ return true
66
+ }
67
+ options.window.sessionStorage.setItem(staleAssetRecoveryStorageKey, '1')
68
+ options.window.location.reload()
69
+ return true
70
+ }
71
+
72
+ const onPreloadError: EventListener = (event) => {
73
+ const preloadEvent = event as Event & { payload?: unknown }
74
+ if (!handle(preloadEvent.payload)) return
75
+ event.preventDefault()
76
+ }
77
+ options.window.addEventListener('vite:preloadError', onPreloadError)
78
+ options.router.onError((error) => {
79
+ if (!handle(error)) options.recoverRuntimeError()
80
+ })
81
+
82
+ return {
83
+ clear,
84
+ handle,
85
+ dispose: () => options.window.removeEventListener('vite:preloadError', onPreloadError),
86
+ }
87
+ }
88
+
89
+ /** Creates a single-flight redirect to the static server-error route. */
90
+ export function createRuntimeErrorRecovery(router: ErrorRecoveryRouter): () => void {
91
+ let isRecovering = false
92
+
93
+ return () => {
94
+ if (isRecovering || router.currentRoute.value.path === '/500') return
95
+
96
+ isRecovering = true
97
+ try {
98
+ void router
99
+ .push({ name: '500' })
100
+ .catch(() => undefined)
101
+ .finally(() => {
102
+ isRecovering = false
103
+ })
104
+ } catch {
105
+ isRecovering = false
106
+ }
107
+ }
108
+ }
@@ -0,0 +1,63 @@
1
+ import type { RouteRecordRaw } from 'vue-router'
2
+
3
+ const Forbidden = () => import('../features/errors/pages/Forbidden.vue')
4
+ const NotFound = () => import('../features/errors/pages/NotFound.vue')
5
+ const ServerError = () => import('../features/errors/pages/ServerError.vue')
6
+ const Login = () => import('../features/auth/pages/Login.vue')
7
+ const Profile = () => import('../features/workspace/pages/Profile.vue')
8
+
9
+ const hiddenPublic = {
10
+ public: true,
11
+ menu: { hidden: true },
12
+ breadcrumb: { hidden: true },
13
+ tab: { hidden: true },
14
+ }
15
+
16
+ export const staticRoutes: RouteRecordRaw[] = [
17
+ {
18
+ path: '/',
19
+ name: 'root',
20
+ redirect: '/dashboard',
21
+ meta: {
22
+ adapter: { menu: { hidden: true }, breadcrumb: { hidden: true }, tab: { hidden: true } },
23
+ },
24
+ },
25
+ {
26
+ path: '/login',
27
+ name: 'login',
28
+ component: Login,
29
+ meta: { adapter: { titleKey: 'auth.login', ...hiddenPublic } },
30
+ },
31
+ {
32
+ path: '/profile',
33
+ name: 'profile',
34
+ component: Profile,
35
+ meta: {
36
+ adapter: {
37
+ titleKey: 'menu.profile',
38
+ icon: 'profile',
39
+ menu: { order: 20 },
40
+ breadcrumb: { label: '个人资料' },
41
+ cache: { enabled: true, name: 'ProfilePage' },
42
+ },
43
+ },
44
+ },
45
+ {
46
+ path: '/403',
47
+ name: '403',
48
+ component: Forbidden,
49
+ meta: { adapter: { titleKey: 'errors.forbidden', ...hiddenPublic } },
50
+ },
51
+ {
52
+ path: '/404',
53
+ name: '404',
54
+ component: NotFound,
55
+ meta: { adapter: { titleKey: 'errors.notFound', ...hiddenPublic } },
56
+ },
57
+ {
58
+ path: '/500',
59
+ name: '500',
60
+ component: ServerError,
61
+ meta: { adapter: { titleKey: 'errors.server', ...hiddenPublic } },
62
+ },
63
+ ]
@@ -0,0 +1,90 @@
1
+ import { mount } from '@vue/test-utils'
2
+ import { describe, expect, it } from 'vitest'
3
+ import { defineComponent, h, KeepAlive, nextTick, type VNode } from 'vue'
4
+ import { createMemoryHistory, createRouter, RouterView } from 'vue-router'
5
+ import { routeStatus } from './routeQuery'
6
+ import { useRouteQueryDefaults } from './useRouteQueryDefaults'
7
+
8
+ interface Query {
9
+ status?: 'active' | 'suspended'
10
+ team?: string
11
+ }
12
+
13
+ function routeTeam(value: unknown): string | undefined {
14
+ return typeof value === 'string' && value.length > 0 ? value : undefined
15
+ }
16
+
17
+ const Harness = defineComponent({
18
+ name: 'Harness',
19
+ setup() {
20
+ return useRouteQueryDefaults<Query>({ status: routeStatus, team: routeTeam })
21
+ },
22
+ render() {
23
+ return h('output', { 'data-defaults': JSON.stringify(this.queryDefaults) })
24
+ },
25
+ })
26
+
27
+ const Other = defineComponent({
28
+ name: 'Other',
29
+ render: () => h('output', { 'data-page': 'other' }),
30
+ })
31
+
32
+ describe('useRouteQueryDefaults', () => {
33
+ it('snapshots defaults on mount and does not follow later route.query changes', async () => {
34
+ const router = createRouter({
35
+ history: createMemoryHistory(),
36
+ routes: [{ path: '/users', component: Harness }],
37
+ })
38
+ await router.push({ path: '/users', query: { status: 'active', team: 'growth' } })
39
+ await router.isReady()
40
+ const wrapper = mount(RouterView, { global: { plugins: [router] } })
41
+
42
+ expect(wrapper.get('output').attributes('data-defaults')).toBe(
43
+ JSON.stringify({ status: 'active', team: 'growth' }),
44
+ )
45
+
46
+ // 挂载后 route.query 变化(页签切换的等价场景)不应更新快照,避免触发 OgTable 重置
47
+ await router.push({ path: '/users', query: { status: 'suspended' } })
48
+ await nextTick()
49
+ expect(wrapper.get('output').attributes('data-defaults')).toBe(
50
+ JSON.stringify({ status: 'active', team: 'growth' }),
51
+ )
52
+ })
53
+
54
+ it('re-snapshots the current route query when the page is reactivated', async () => {
55
+ const Host = defineComponent({
56
+ name: 'Host',
57
+ setup: () => () =>
58
+ h(RouterView, null, {
59
+ default: ({ Component }: { Component: VNode }) =>
60
+ h(KeepAlive, { include: ['Harness'] }, [h(Component)]),
61
+ }),
62
+ })
63
+ const router = createRouter({
64
+ history: createMemoryHistory(),
65
+ routes: [
66
+ { path: '/users', component: Harness },
67
+ { path: '/other', component: Other },
68
+ ],
69
+ })
70
+ await router.push({ path: '/users', query: { status: 'active' } })
71
+ await router.isReady()
72
+ const wrapper = mount(Host, { global: { plugins: [router] } })
73
+
74
+ expect(wrapper.get('output').attributes('data-defaults')).toBe(
75
+ JSON.stringify({ status: 'active' }),
76
+ )
77
+
78
+ // 切到其他页签:Harness 被 KeepAlive 缓存,快照保持不变
79
+ await router.push('/other')
80
+ await nextTick()
81
+ expect(wrapper.get('output').attributes('data-page')).toBe('other')
82
+
83
+ // 切回并携带新的 URL query:onActivated 重新取快照
84
+ await router.push({ path: '/users', query: { status: 'suspended', team: 'growth' } })
85
+ await nextTick()
86
+ expect(wrapper.get('output').attributes('data-defaults')).toBe(
87
+ JSON.stringify({ status: 'suspended', team: 'growth' }),
88
+ )
89
+ })
90
+ })
@@ -0,0 +1,51 @@
1
+ import { onActivated, onMounted, ref } from 'vue'
2
+ import { useRoute } from 'vue-router'
3
+
4
+ type RouteQueryKey<TQuery extends object> = Extract<keyof TQuery, string>
5
+
6
+ export type RouteQueryParser<TValue> = (value: unknown) => TValue | undefined
7
+
8
+ export type RouteQueryParsers<TQuery extends object> = Partial<{
9
+ [TKey in RouteQueryKey<TQuery>]: RouteQueryParser<Exclude<TQuery[TKey], undefined>>
10
+ }>
11
+
12
+ function resolveRouteDefaults<TQuery extends object>(
13
+ query: Record<string, unknown>,
14
+ parsers: RouteQueryParsers<TQuery>,
15
+ ): Partial<TQuery> {
16
+ const defaults: Partial<TQuery> = {}
17
+
18
+ for (const key of Object.keys(parsers) as RouteQueryKey<TQuery>[]) {
19
+ const parser = parsers[key]
20
+ if (!parser) continue
21
+
22
+ const value = parser(query[key])
23
+ if (value !== undefined) Object.assign(defaults, { [key]: value })
24
+ }
25
+
26
+ return defaults
27
+ }
28
+
29
+ /**
30
+ * Parses allowlisted route values into table query defaults.
31
+ *
32
+ * The defaults are snapshotted when the page is entered (mount or KeepAlive
33
+ * reactivation), not reactively bound to `route.query`. While a cached tab is
34
+ * deactivated, `route.query` changes (e.g. switching to another tab) must not
35
+ * trigger `OgTable`'s `queryDefaults` watcher and wipe the search state.
36
+ * Re-entering the page (fresh navigation, e.g. from the menu) re-snapshots the
37
+ * current URL query so deep links still work.
38
+ */
39
+ export function useRouteQueryDefaults<TQuery extends object>(parsers: RouteQueryParsers<TQuery>) {
40
+ const route = useRoute()
41
+ const queryDefaults = ref<Partial<TQuery>>(resolveRouteDefaults(route.query, parsers))
42
+
43
+ function sync(): void {
44
+ queryDefaults.value = resolveRouteDefaults(route.query, parsers)
45
+ }
46
+
47
+ onMounted(sync)
48
+ onActivated(sync)
49
+
50
+ return { queryDefaults }
51
+ }
@@ -0,0 +1,19 @@
1
+ import { routeStatus } from './routeQuery'
2
+ import { type RouteQueryParsers, useRouteQueryDefaults } from './useRouteQueryDefaults'
3
+
4
+ interface Query {
5
+ status?: 'active' | 'suspended'
6
+ team?: string
7
+ }
8
+
9
+ const parsers: RouteQueryParsers<Query> = {
10
+ status: routeStatus,
11
+ team: (value) => (typeof value === 'string' ? value : undefined),
12
+ }
13
+ useRouteQueryDefaults(parsers)
14
+
15
+ // @ts-expect-error route mappings must target a declared query field
16
+ useRouteQueryDefaults<Query>({ missing: routeStatus })
17
+
18
+ // @ts-expect-error parser output must match its query field type
19
+ useRouteQueryDefaults<Query>({ status: (value) => (value === 'pending' ? 'pending' : undefined) })
@@ -0,0 +1,3 @@
1
+ import { createPinia } from 'pinia'
2
+
3
+ export const pinia = createPinia()
@@ -0,0 +1,33 @@
1
+ // apps/admin/src/styles/element/index.scss
2
+ // 风格 A(Linear/Vercel)Element Plus 主题入口
3
+ // 只覆盖 @forward 公开变量,派生色由 SCSS mix-color 自动算
4
+ // 注:Element Plus 变量是 $border-color,不是 $border
5
+ @forward 'element-plus/theme-chalk/src/common/var.scss' with (
6
+ $colors: (
7
+ 'primary': (
8
+ 'base': #5e6ad2,
9
+ ),
10
+ ),
11
+ $border-color: (
12
+ '': #e2e8f0,
13
+ 'light': #f1f5f9,
14
+ 'lighter': #f8fafc,
15
+ 'extra-light': #ffffff,
16
+ 'dark': #cbd5e1,
17
+ 'darker': #475569,
18
+ ),
19
+ $border-radius: (
20
+ 'base': 8px,
21
+ 'small': 4px,
22
+ 'round': 9999px,
23
+ ),
24
+ $font-family: (
25
+ '': (
26
+ 'Inter',
27
+ 'PingFang SC',
28
+ 'Microsoft YaHei',
29
+ system-ui,
30
+ sans-serif,
31
+ ),
32
+ )
33
+ );