@origen-ui/admin-cli 2.0.2 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (888) hide show
  1. package/README.md +20 -9
  2. package/bin/contract-sync.mjs +112 -0
  3. package/bin/lib/errors.mjs +8 -0
  4. package/bin/lib/fs-json.mjs +18 -0
  5. package/bin/lib/hash.mjs +9 -0
  6. package/bin/og-admin.mjs +165 -35
  7. package/bin/sync-project.mjs +717 -0
  8. package/package.json +20 -17
  9. package/templates/current/clean/.agents/skills/admin-component-usage/SKILL.md +28 -0
  10. package/templates/current/clean/.agents/skills/admin-component-usage/references/component-directory.md +270 -0
  11. package/templates/current/clean/.agents/skills/build-admin-feature/SKILL.md +20 -0
  12. package/templates/current/clean/.agents/skills/build-admin-feature/references/component-selection.md +38 -0
  13. package/templates/current/{examples/.codex → clean/.agents}/skills/use-og-form/SKILL.md +1 -1
  14. package/templates/current/{examples/.codex → clean/.agents}/skills/use-og-form-table/SKILL.md +4 -3
  15. package/templates/current/clean/{.codex → .agents}/skills/use-og-search/SKILL.md +3 -3
  16. package/templates/current/clean/.agents/skills/use-og-table/SKILL.md +22 -0
  17. package/templates/current/{examples/.codex → clean/.agents}/skills/use-og-upload/SKILL.md +6 -5
  18. package/templates/current/clean/.api-client-e2e.config.ts +13 -0
  19. package/templates/current/clean/.claude/rules/01-feature-architecture.md +10 -0
  20. package/templates/current/clean/.claude/rules/02-vue-typescript.md +10 -0
  21. package/templates/current/clean/.claude/rules/03-component-policy.md +31 -0
  22. package/templates/current/clean/.claude/rules/04-api-auth-router.md +10 -0
  23. package/templates/current/clean/.claude/rules/05-style.md +10 -0
  24. package/templates/current/clean/.claude/rules/06-quality.md +10 -0
  25. package/templates/current/clean/.claude/skills/admin-component-usage/SKILL.md +28 -0
  26. package/templates/current/clean/.claude/skills/admin-component-usage/references/component-directory.md +270 -0
  27. package/templates/current/clean/.claude/skills/build-admin-feature/SKILL.md +20 -0
  28. package/templates/current/clean/.claude/skills/build-admin-feature/references/component-selection.md +38 -0
  29. package/templates/current/clean/{.codex → .claude}/skills/use-og-form/SKILL.md +1 -1
  30. package/templates/current/clean/{.codex → .claude}/skills/use-og-form-table/SKILL.md +4 -3
  31. package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-search/SKILL.md +3 -3
  32. package/templates/current/clean/.claude/skills/use-og-table/SKILL.md +22 -0
  33. package/templates/current/clean/{.codex → .claude}/skills/use-og-upload/SKILL.md +6 -5
  34. package/templates/current/clean/.codebuddy/rules/01-feature-architecture.md +2 -2
  35. package/templates/current/clean/.codebuddy/rules/03-component-policy.md +4 -1
  36. package/templates/current/clean/.codebuddy/skills/admin-component-usage/SKILL.md +31 -0
  37. package/templates/current/clean/.codebuddy/skills/admin-component-usage/references/component-directory.md +270 -0
  38. package/templates/current/clean/.codebuddy/skills/build-admin-feature/SKILL.md +11 -5
  39. package/templates/current/clean/.codebuddy/skills/build-admin-feature/references/component-selection.md +38 -0
  40. package/templates/current/clean/.codebuddy/skills/use-og-form/SKILL.md +1 -1
  41. package/templates/current/clean/.codebuddy/skills/use-og-form-table/SKILL.md +4 -3
  42. package/templates/current/clean/.codebuddy/skills/use-og-search/SKILL.md +3 -3
  43. package/templates/current/clean/.codebuddy/skills/use-og-table/SKILL.md +16 -10
  44. package/templates/current/clean/.codebuddy/skills/use-og-upload/SKILL.md +6 -5
  45. package/templates/current/clean/.codex/AGENTS.md +55 -8
  46. package/templates/current/clean/.codex/rules/01-feature-architecture.md +2 -2
  47. package/templates/current/clean/.codex/rules/03-component-policy.md +4 -1
  48. package/templates/current/clean/.cursor/rules/.generated +5 -0
  49. package/templates/current/clean/.cursor/rules/01-feature-architecture.mdc +2 -2
  50. package/templates/current/clean/.cursor/rules/03-component-policy.mdc +4 -1
  51. package/templates/current/clean/.cursor/skills/admin-component-usage/SKILL.md +28 -0
  52. package/templates/current/clean/.cursor/skills/admin-component-usage/references/component-directory.md +270 -0
  53. package/templates/current/clean/.cursor/skills/build-admin-feature/SKILL.md +11 -5
  54. package/templates/current/clean/.cursor/skills/build-admin-feature/references/component-selection.md +38 -0
  55. package/templates/current/clean/.cursor/skills/use-og-form/SKILL.md +1 -1
  56. package/templates/current/clean/.cursor/skills/use-og-form-table/SKILL.md +4 -3
  57. package/templates/current/clean/.cursor/skills/use-og-search/SKILL.md +3 -3
  58. package/templates/current/clean/.cursor/skills/use-og-table/SKILL.md +16 -10
  59. package/templates/current/clean/.cursor/skills/use-og-upload/SKILL.md +6 -5
  60. package/templates/current/clean/{.env.example → .env.dev} +3 -2
  61. package/templates/current/clean/.env.mock +4 -0
  62. package/templates/current/clean/.env.production +5 -0
  63. package/templates/current/clean/.env.test +4 -0
  64. package/templates/current/clean/.prettierignore +17 -0
  65. package/templates/current/clean/.prettierrc +8 -0
  66. package/templates/current/clean/.qoder/rules/01-feature-architecture.md +3 -4
  67. package/templates/current/clean/.qoder/rules/02-vue-typescript.md +1 -2
  68. package/templates/current/clean/.qoder/rules/03-component-policy.md +5 -3
  69. package/templates/current/clean/.qoder/rules/04-api-auth-router.md +1 -2
  70. package/templates/current/clean/.qoder/rules/05-style.md +1 -2
  71. package/templates/current/clean/.qoder/rules/06-quality.md +1 -2
  72. package/templates/current/clean/.qoder/skills/admin-component-usage/SKILL.md +28 -0
  73. package/templates/current/clean/.qoder/skills/admin-component-usage/references/component-directory.md +270 -0
  74. package/templates/current/clean/.qoder/skills/build-admin-feature/SKILL.md +11 -5
  75. package/templates/current/clean/.qoder/skills/build-admin-feature/references/component-selection.md +38 -0
  76. package/templates/current/clean/.qoder/skills/use-og-form/SKILL.md +1 -1
  77. package/templates/current/clean/.qoder/skills/use-og-form-table/SKILL.md +4 -3
  78. package/templates/current/clean/.qoder/skills/use-og-search/SKILL.md +3 -3
  79. package/templates/current/clean/.qoder/skills/use-og-table/SKILL.md +16 -10
  80. package/templates/current/clean/.qoder/skills/use-og-upload/SKILL.md +6 -5
  81. package/templates/current/clean/.zcode/skills/admin-component-usage/SKILL.md +28 -0
  82. package/templates/current/clean/.zcode/skills/admin-component-usage/references/component-directory.md +270 -0
  83. package/templates/current/clean/.zcode/skills/build-admin-feature/SKILL.md +20 -0
  84. package/templates/current/clean/.zcode/skills/build-admin-feature/references/component-selection.md +38 -0
  85. package/templates/current/clean/.zcode/skills/style-og-origen-ui/SKILL.md +11 -0
  86. package/templates/current/clean/.zcode/skills/use-og-dialog/SKILL.md +12 -0
  87. package/templates/current/clean/.zcode/skills/use-og-editor/SKILL.md +25 -0
  88. package/templates/current/clean/.zcode/skills/use-og-form/SKILL.md +12 -0
  89. package/templates/current/clean/.zcode/skills/use-og-form-table/SKILL.md +26 -0
  90. package/templates/current/clean/.zcode/skills/use-og-http/SKILL.md +13 -0
  91. package/templates/current/clean/.zcode/skills/use-og-router-tabs/SKILL.md +11 -0
  92. package/templates/current/clean/.zcode/skills/use-og-search/SKILL.md +14 -0
  93. package/templates/current/clean/.zcode/skills/use-og-table/SKILL.md +22 -0
  94. package/templates/current/clean/.zcode/skills/use-og-upload/SKILL.md +26 -0
  95. package/templates/current/clean/AGENTS.md +55 -9
  96. package/templates/current/clean/CHANGELOG.md +107 -0
  97. package/templates/current/clean/CLAUDE.md +3 -0
  98. package/templates/current/clean/README.md +58 -88
  99. package/templates/current/clean/component-catalog.json +766 -348
  100. package/templates/current/clean/component-catalog.v2.json +2040 -0
  101. package/templates/current/clean/docs/components/dialog.md +405 -0
  102. package/templates/current/clean/docs/components/editor-viewer.md +87 -0
  103. package/templates/current/clean/docs/components/editor.md +275 -0
  104. package/templates/current/clean/docs/components/form-table.md +222 -0
  105. package/templates/current/clean/docs/components/form.md +750 -0
  106. package/templates/current/clean/docs/components/index.md +44 -0
  107. package/templates/current/clean/docs/components/router.md +452 -0
  108. package/templates/current/clean/docs/components/search.md +1205 -0
  109. package/templates/current/clean/docs/components/svg-icon.md +124 -0
  110. package/templates/current/clean/docs/components/table-local.md +176 -0
  111. package/templates/current/clean/docs/components/table-with-search.md +207 -0
  112. package/templates/current/clean/docs/components/table.md +813 -0
  113. package/templates/current/clean/docs/components/tabs.md +440 -0
  114. package/templates/current/clean/docs/components/upload.md +349 -0
  115. package/templates/current/clean/eslint.config.js +89 -0
  116. package/templates/current/clean/index.html +1 -1
  117. package/templates/current/clean/openapi.json +10048 -999
  118. package/templates/current/clean/package.json +45 -33
  119. package/templates/current/clean/playwright.config.ts +20 -6
  120. package/templates/current/clean/playwright.mock.config.ts +42 -0
  121. package/templates/current/clean/pnpm-workspace.yaml +19 -3
  122. package/templates/current/clean/recipes/remote-crud-dialog-form.vue +15 -13
  123. package/templates/current/clean/scaffold.lock.json +164 -4
  124. package/templates/current/clean/scripts/api-codegen.config.ts +35 -0
  125. package/templates/current/clean/scripts/api-codegen.ts +2015 -0
  126. package/templates/current/clean/scripts/api-templates/http-client.ejs +359 -0
  127. package/templates/current/clean/scripts/check-admin-scaffold.mjs +311 -17
  128. package/templates/current/clean/scripts/generate-api.ts +290 -85
  129. package/templates/current/clean/scripts/lib/admin-component-catalog.mjs +515 -0
  130. package/templates/current/clean/scripts/lib/repository-root.mjs +9 -0
  131. package/templates/current/clean/scripts/mock-api.ts +1356 -0
  132. package/templates/current/clean/scripts/remove-examples.mjs +9 -34
  133. package/templates/current/clean/src/App.vue +9 -18
  134. package/templates/current/clean/src/api/generated/data-contracts.ts +23 -265
  135. package/templates/current/clean/src/api/generated/http-client.ts +351 -180
  136. package/templates/current/clean/src/api/generated/index.ts +22 -0
  137. package/templates/current/clean/src/api/generated/services/auth.ts +123 -0
  138. package/templates/current/clean/src/api/generated/services/common/files.ts +111 -0
  139. package/templates/current/clean/src/api/generated/services/monitor/cache.ts +164 -0
  140. package/templates/current/clean/src/api/generated/services/monitor/job.ts +195 -0
  141. package/templates/current/clean/src/api/generated/services/monitor/jobLog.ts +126 -0
  142. package/templates/current/clean/src/api/generated/services/monitor/logininfor.ts +126 -0
  143. package/templates/current/clean/src/api/generated/services/monitor/online.ts +66 -0
  144. package/templates/current/clean/src/api/generated/services/monitor/operlog.ts +106 -0
  145. package/templates/current/clean/src/api/generated/services/monitor/server.ts +41 -0
  146. package/templates/current/clean/src/api/generated/services/system/configs.ts +190 -0
  147. package/templates/current/clean/src/api/generated/services/system/departments.ts +173 -0
  148. package/templates/current/clean/src/api/generated/services/system/dictionaries/data.ts +169 -0
  149. package/templates/current/clean/src/api/generated/services/system/dictionaries/types.ts +187 -0
  150. package/templates/current/clean/src/api/generated/services/system/index.ts +158 -0
  151. package/templates/current/clean/src/api/generated/services/system/menus.ts +193 -0
  152. package/templates/current/clean/src/api/generated/services/system/notices.ts +221 -0
  153. package/templates/current/clean/src/api/generated/services/system/posts.ts +168 -0
  154. package/templates/current/clean/src/api/generated/services/system/roles.ts +354 -0
  155. package/templates/current/clean/src/api/generated/services/system/users.ts +425 -0
  156. package/templates/current/clean/src/api/generated/services/tool/code-generator.ts +304 -0
  157. package/templates/current/clean/src/api/generated/types/auth.types.ts +132 -0
  158. package/templates/current/clean/src/api/generated/types/common/files.types.ts +57 -0
  159. package/templates/current/clean/src/api/generated/types/common.ts +174 -0
  160. package/templates/current/clean/src/api/generated/types/enum-dict.ts +94 -0
  161. package/templates/current/clean/src/api/generated/types/enums.ts +155 -0
  162. package/templates/current/clean/src/api/generated/types/monitor/cache.types.ts +149 -0
  163. package/templates/current/clean/src/api/generated/types/monitor/job.types.ts +207 -0
  164. package/templates/current/clean/src/api/generated/types/monitor/jobLog.types.ts +134 -0
  165. package/templates/current/clean/src/api/generated/types/monitor/logininfor.types.ts +135 -0
  166. package/templates/current/clean/src/api/generated/types/monitor/online.types.ts +80 -0
  167. package/templates/current/clean/src/api/generated/types/monitor/operlog.types.ts +126 -0
  168. package/templates/current/clean/src/api/generated/types/monitor/server.types.ts +205 -0
  169. package/templates/current/clean/src/api/generated/types/system/configs.types.ts +200 -0
  170. package/templates/current/clean/src/api/generated/types/system/departments.types.ts +145 -0
  171. package/templates/current/clean/src/api/generated/types/system/dictionaries/data.types.ts +210 -0
  172. package/templates/current/clean/src/api/generated/types/system/dictionaries/types.types.ts +221 -0
  173. package/templates/current/clean/src/api/generated/types/system/index.types.ts +19 -0
  174. package/templates/current/clean/src/api/generated/types/system/menus.types.ts +234 -0
  175. package/templates/current/clean/src/api/generated/types/system/notices.types.ts +270 -0
  176. package/templates/current/clean/src/api/generated/types/system/posts.types.ts +198 -0
  177. package/templates/current/clean/src/api/generated/types/system/roles.types.ts +410 -0
  178. package/templates/current/clean/src/api/generated/types/system/users.types.ts +413 -0
  179. package/templates/current/clean/src/api/generated/types/tool/code-generator.types.ts +388 -0
  180. package/templates/current/clean/src/api/index.ts +44 -39
  181. package/templates/current/clean/src/app/__tests__/api-generated.types.ts +24 -0
  182. package/templates/current/clean/src/app/api.ts +6 -0
  183. package/templates/current/clean/src/app/authorization/permission.ts +9 -0
  184. package/templates/current/{examples/src/app → clean/src/app/config}/runtimeConfig.ts +44 -12
  185. package/templates/current/clean/src/app/errors/errorMessage.ts +80 -0
  186. package/templates/current/clean/src/app/http/client.ts +141 -0
  187. package/templates/current/clean/src/app/http/http-adapter.ts +71 -0
  188. package/templates/current/{examples/src/app → clean/src/app/i18n}/adminLocale.ts +25 -19
  189. package/templates/current/clean/src/app/{localeFormat.ts → i18n/localeFormat.ts} +29 -6
  190. package/templates/current/clean/src/app/i18n/origenUiLocale.ts +15 -0
  191. package/templates/current/clean/src/app/menu/menu.ts +175 -0
  192. package/templates/current/clean/src/app/menu/menuTypes.ts +20 -0
  193. package/templates/current/clean/src/{features → app}/security/devtoolsProtection.ts +8 -7
  194. package/templates/current/clean/src/app/ui/createAdminUi.ts +31 -0
  195. package/templates/current/clean/src/app/ui/iconCatalog.ts +71 -0
  196. package/templates/current/clean/src/assets/icons/appearance.svg +1 -0
  197. package/templates/current/clean/src/assets/icons/arrow-right.svg +1 -0
  198. package/templates/current/clean/src/assets/icons/check.svg +1 -0
  199. package/templates/current/clean/src/assets/icons/circle-check.svg +1 -0
  200. package/templates/current/clean/src/assets/icons/default.svg +4 -0
  201. package/templates/current/clean/src/assets/icons/directory/setting.svg +1 -0
  202. package/templates/current/clean/src/assets/icons/expand.svg +1 -0
  203. package/templates/current/clean/src/assets/icons/fold.svg +1 -0
  204. package/templates/current/clean/src/assets/icons/key.svg +1 -0
  205. package/templates/current/clean/src/assets/icons/lock.svg +1 -0
  206. package/templates/current/clean/src/assets/icons/monitor.svg +1 -0
  207. package/templates/current/clean/src/assets/icons/moon.svg +11 -0
  208. package/templates/current/clean/src/assets/icons/page/department.svg +1 -0
  209. package/templates/current/clean/src/assets/icons/page/dictionary.svg +1 -0
  210. package/templates/current/clean/src/assets/icons/page/menus.svg +1 -0
  211. package/templates/current/clean/src/assets/icons/page/user.svg +1 -0
  212. package/templates/current/clean/src/assets/icons/page/users.svg +1 -0
  213. package/templates/current/clean/src/assets/icons/plus.svg +1 -0
  214. package/templates/current/clean/src/assets/icons/profile.svg +1 -0
  215. package/templates/current/clean/src/assets/icons/refresh.svg +1 -0
  216. package/templates/current/clean/src/assets/icons/roles.svg +1 -0
  217. package/templates/current/clean/src/assets/icons/search.svg +1 -0
  218. package/templates/current/clean/src/assets/icons/sunny.svg +1 -0
  219. package/templates/current/clean/src/assets/icons/system.svg +1 -0
  220. package/templates/current/clean/src/assets/icons/theme-auto.svg +14 -0
  221. package/templates/current/clean/src/assets/icons/tune.svg +13 -0
  222. package/templates/current/clean/src/{features/shell/components → components}/RouteProgress.vue +2 -2
  223. package/templates/current/{examples/src/features/system/access → clean/src}/composables/useAuthorizationRefresh.ts +6 -1
  224. package/templates/current/clean/src/composables/useSystemTableSearchVisibility.ts +33 -0
  225. package/templates/current/clean/src/{features/appearance/composables → composables}/useTheme.ts +1 -1
  226. package/templates/current/clean/src/env.d.ts +6 -19
  227. package/templates/current/clean/src/layouts/AdminLayout.vue +7 -9
  228. package/templates/current/clean/src/{features/shell/components → layouts}/AdminWatermark.vue +2 -2
  229. package/templates/current/clean/src/layouts/BreadcrumbBar.vue +9 -1
  230. package/templates/current/clean/src/layouts/SideMenu.vue +7 -15
  231. package/templates/current/clean/src/{features/appearance/components → layouts}/ThemePanel.vue +39 -11
  232. package/templates/current/clean/src/layouts/TopBar.vue +60 -28
  233. package/templates/current/clean/src/layouts/WorkspaceTabs.vue +10 -1
  234. package/templates/current/clean/src/layouts/topBarMenuSearch.ts +25 -4
  235. package/templates/current/clean/src/locales/en-US.json +227 -219
  236. package/templates/current/clean/src/locales/index.ts +72 -32
  237. package/templates/current/clean/src/locales/messages-types.ts +15 -10
  238. package/templates/current/clean/src/locales/vue-i18n.d.ts +1 -1
  239. package/templates/current/clean/src/locales/zh-CN.json +226 -218
  240. package/templates/current/clean/src/locales/zh-TW.json +222 -214
  241. package/templates/current/clean/src/main.ts +59 -30
  242. package/templates/current/clean/src/router/bootstrap.ts +69 -24
  243. package/templates/current/clean/src/router/dynamic/componentLoader.ts +150 -0
  244. package/templates/current/clean/src/router/{dynamicMenuRefresh.ts → dynamic/dynamicMenuRefresh.ts} +6 -2
  245. package/templates/current/clean/src/router/dynamic/dynamicRoutes.ts +247 -0
  246. package/templates/current/clean/src/router/navigation/guards.ts +12 -0
  247. package/templates/current/clean/src/router/navigation/paths.ts +28 -0
  248. package/templates/current/clean/src/router/navigation/staticRoutes.ts +109 -0
  249. package/templates/current/clean/src/router/{queryEncryption.ts → query/queryEncryption.ts} +29 -12
  250. package/templates/current/clean/src/router/query/routeQuery.ts +29 -0
  251. package/templates/current/clean/src/router/{useRouteQueryDefaults.ts → query/useRouteQueryDefaults.ts} +9 -8
  252. package/templates/current/clean/src/router/query/useRouteQueryDefaults.types.ts +28 -0
  253. package/templates/current/clean/src/router/{runtimeErrorRecovery.ts → recovery/runtimeErrorRecovery.ts} +21 -3
  254. package/templates/current/clean/src/{features/auth/store → store}/auth.ts +96 -61
  255. package/templates/current/clean/src/store/dictionaries.ts +86 -0
  256. package/templates/current/clean/src/{features/shell/store → store}/sidebar.ts +9 -2
  257. package/templates/current/{examples/src/features/appearance → clean/src}/store/theme.ts +8 -4
  258. package/templates/current/clean/src/styles/layout.css +51 -0
  259. package/templates/current/clean/src/templates/og-form.ts +7 -2
  260. package/templates/current/clean/src/templates/og-table.ts +88 -20
  261. package/templates/current/clean/src/templates/router.ts +11 -2
  262. package/templates/current/clean/src/utils/color-mix.ts +6 -2
  263. package/templates/current/clean/src/utils/download.ts +11 -0
  264. package/templates/current/clean/src/utils/permissions.ts +1 -1
  265. package/templates/current/clean/src/utils/retryableDialog.ts +46 -0
  266. package/templates/current/clean/src/{features → views}/errors/pages/Forbidden.vue +6 -2
  267. package/templates/current/clean/src/views/errors/pages/MethodNotAllowed.vue +34 -0
  268. package/templates/current/clean/src/{features → views}/errors/pages/NotFound.vue +6 -2
  269. package/templates/current/clean/src/{features → views}/errors/pages/ServerError.vue +6 -2
  270. package/templates/current/clean/src/{features/auth/pages/Login.vue → views/login/pages/index.vue} +99 -10
  271. package/templates/current/clean/src/views/system/access/services/admin-repository.ts +489 -0
  272. package/templates/current/clean/src/views/system/access/services/rbac.ts +317 -0
  273. package/templates/current/clean/src/views/system/dept/components/DepartmentEditorForm.vue +87 -0
  274. package/templates/current/clean/src/views/system/dept/composables/useDepartmentManagement.ts +314 -0
  275. package/templates/current/clean/src/views/system/dept/pages/index.vue +44 -0
  276. package/templates/current/clean/src/views/system/dept/services/departments.ts +168 -0
  277. package/templates/current/clean/src/views/system/dict/components/DictionaryDataEditorForm.vue +98 -0
  278. package/templates/current/clean/src/views/system/dict/components/DictionaryDataPreview.vue +233 -0
  279. package/templates/current/clean/src/views/system/dict/components/DictionaryTypeEditorForm.vue +66 -0
  280. package/templates/current/clean/src/views/system/dict/composables/useDictionaryDataManagement.ts +406 -0
  281. package/templates/current/clean/src/views/system/dict/composables/useDictionaryTypeManagement.ts +329 -0
  282. package/templates/current/clean/src/views/system/dict/data/pages/index.vue +134 -0
  283. package/templates/current/clean/src/views/system/dict/pages/index.vue +113 -0
  284. package/templates/current/clean/src/views/system/dict/services/dictionaries.ts +239 -0
  285. package/templates/current/clean/src/views/system/menu/components/MenuEditorForm.vue +252 -0
  286. package/templates/current/clean/src/views/system/menu/composables/useMenuManagement.ts +357 -0
  287. package/templates/current/clean/src/views/system/menu/menuDraft.ts +45 -0
  288. package/templates/current/clean/src/views/system/menu/pages/ExternalLink.vue +37 -0
  289. package/templates/current/clean/src/views/system/menu/pages/index.vue +75 -0
  290. package/templates/current/clean/src/views/system/post/components/PostEditorForm.vue +69 -0
  291. package/templates/current/clean/src/views/system/post/composables/usePostManagement.ts +245 -0
  292. package/templates/current/clean/src/views/system/post/pages/index.vue +92 -0
  293. package/templates/current/clean/src/views/system/post/services/posts.ts +100 -0
  294. package/templates/current/clean/src/views/system/role/auth-users/pages/index.vue +100 -0
  295. package/templates/current/clean/src/views/system/role/components/RoleDataScopeForm.vue +167 -0
  296. package/templates/current/clean/src/views/system/role/components/RoleEditorForm.vue +165 -0
  297. package/templates/current/clean/src/views/system/role/components/RoleUserSelectForm.vue +129 -0
  298. package/templates/current/clean/src/views/system/role/composables/useRoleManagement.ts +422 -0
  299. package/templates/current/clean/src/views/system/role/composables/useRoleUserManagement.ts +233 -0
  300. package/templates/current/clean/src/views/system/role/pages/index.vue +110 -0
  301. package/templates/current/clean/src/views/system/role/services/roleAccess.ts +162 -0
  302. package/templates/current/clean/src/views/system/user/auth-roles/pages/index.vue +209 -0
  303. package/templates/current/clean/src/views/system/user/components/UserDetailsForm.vue +108 -0
  304. package/templates/current/clean/src/views/system/user/components/UserEditorForm.vue +207 -0
  305. package/templates/current/clean/src/views/system/user/components/UserImportDialog.vue +80 -0
  306. package/templates/current/clean/src/views/system/user/components/UserResetPasswordForm.vue +56 -0
  307. package/templates/current/clean/src/views/system/user/composables/useUserManagement.ts +502 -0
  308. package/templates/current/clean/src/views/system/user/pages/index.vue +459 -0
  309. package/templates/current/clean/tests/e2e/admin-access-business.spec.ts +33 -0
  310. package/templates/current/clean/tests/e2e/admin-shell.spec.ts +50 -0
  311. package/templates/current/clean/tests/e2e/fixtures/adminMockBackend.ts +95 -0
  312. package/templates/current/clean/tests/e2e/fixtures/labelGeometry.ts +52 -0
  313. package/templates/current/clean/tests/e2e/mock-api-generation.spec.ts +27 -0
  314. package/templates/current/clean/tests/e2e/mock-business.spec.ts +555 -0
  315. package/templates/current/clean/tests/e2e/mock-menu-retry-form-label.spec.ts +100 -0
  316. package/templates/current/clean/tests/e2e/mock-shell.spec.ts +25 -0
  317. package/templates/current/clean/tests/e2e/mock-tree-selection-layout.spec.ts +113 -0
  318. package/templates/current/clean/tests/unit/api/api-codegen.spec.ts +893 -0
  319. package/templates/current/clean/tests/unit/api/client.spec.ts +145 -0
  320. package/templates/current/clean/tests/unit/api/generated-http-client.spec.ts +290 -0
  321. package/templates/current/{examples/src → clean/tests/unit}/api/http-adapter.spec.ts +3 -3
  322. package/templates/current/clean/tests/unit/api/system-apis.spec.ts +118 -0
  323. package/templates/current/clean/tests/unit/app/createAdminUi.spec.ts +79 -0
  324. package/templates/current/clean/{src → tests/unit}/app/errorMessage.spec.ts +1 -1
  325. package/templates/current/clean/tests/unit/app/iconCatalog.spec.ts +12 -0
  326. package/templates/current/clean/tests/unit/app/menu.spec.ts +215 -0
  327. package/templates/current/{examples/src → clean/tests/unit}/app/origenUiLocale.spec.ts +1 -1
  328. package/templates/current/{examples/src → clean/tests/unit}/app/permission.spec.ts +4 -5
  329. package/templates/current/clean/tests/unit/app/runtimeConfig.spec.ts +36 -0
  330. package/templates/current/{examples/src/features → clean/tests/unit/app}/security/devtoolsProtection.spec.ts +17 -7
  331. package/templates/current/{examples/src/features/shell → clean/tests/unit}/composables/useRouteProgress.spec.ts +1 -1
  332. package/templates/current/{examples/src/features/shell/components → clean/tests/unit/layouts}/AdminWatermark.spec.ts +5 -7
  333. package/templates/current/{examples/src → clean/tests/unit}/layouts/topBarMenuSearch.spec.ts +25 -8
  334. package/templates/current/clean/{src → tests/unit}/locales/messages.spec.ts +43 -17
  335. package/templates/current/clean/tests/unit/router/dynamicMenuRefresh.spec.ts +151 -0
  336. package/templates/current/clean/tests/unit/router/dynamicRoutes.spec.ts +374 -0
  337. package/templates/current/clean/tests/unit/router/paths.spec.ts +103 -0
  338. package/templates/current/clean/{src → tests/unit}/router/queryEncryption.spec.ts +49 -12
  339. package/templates/current/{examples/src → clean/tests/unit}/router/routeQuery.spec.ts +8 -1
  340. package/templates/current/clean/{src → tests/unit}/router/runtimeErrorRecovery.spec.ts +11 -6
  341. package/templates/current/{examples/src → clean/tests/unit}/router/useRouteQueryDefaults.spec.ts +46 -12
  342. package/templates/current/clean/tests/unit/scripts/mock-api.spec.ts +440 -0
  343. package/templates/current/clean/{scripts → tests/unit/scripts}/vite-build-policy.spec.ts +35 -6
  344. package/templates/current/clean/{src/features/auth → tests/unit}/store/auth.spec.ts +68 -15
  345. package/templates/current/clean/tests/unit/store/dictionaries.spec.ts +106 -0
  346. package/templates/current/{examples/src → clean/tests/unit}/templates/templates.spec.ts +60 -16
  347. package/templates/current/clean/{src/utils/__tests__ → tests/unit/utils}/color-mix.spec.ts +1 -1
  348. package/templates/current/clean/tests/unit/utils/retryableDialog.spec.ts +61 -0
  349. package/templates/current/{examples/src/features/errors/pages → clean/tests/unit/views/errors}/error-pages.spec.ts +11 -7
  350. package/templates/current/clean/tests/unit/views/feature-composables.spec.ts +233 -0
  351. package/templates/current/clean/tests/unit/views/system/access/admin-repository.spec.ts +353 -0
  352. package/templates/current/clean/tests/unit/views/system/access/rbac.spec.ts +329 -0
  353. package/templates/current/clean/tests/unit/views/system/dept/departments.spec.ts +104 -0
  354. package/templates/current/clean/tests/unit/views/system/dict/dictionaries.spec.ts +234 -0
  355. package/templates/current/clean/tests/unit/views/system/menu/menuDraft.spec.ts +77 -0
  356. package/templates/current/clean/tests/unit/views/system/menu/useMenuManagement.spec.ts +339 -0
  357. package/templates/current/clean/tests/unit/views/system/user/searchControl.spec.ts +128 -0
  358. package/templates/current/clean/tsconfig.json +4 -19
  359. package/templates/current/clean/vite.build-policy.ts +97 -22
  360. package/templates/current/clean/vite.config.ts +50 -7
  361. package/templates/current/examples/.agents/skills/admin-component-usage/SKILL.md +28 -0
  362. package/templates/current/examples/.agents/skills/admin-component-usage/references/component-directory.md +270 -0
  363. package/templates/current/examples/.agents/skills/build-admin-feature/SKILL.md +20 -0
  364. package/templates/current/examples/.agents/skills/build-admin-feature/references/component-selection.md +38 -0
  365. package/templates/current/examples/.agents/skills/style-og-origen-ui/SKILL.md +11 -0
  366. package/templates/current/examples/.agents/skills/use-og-dialog/SKILL.md +12 -0
  367. package/templates/current/examples/.agents/skills/use-og-editor/SKILL.md +25 -0
  368. package/templates/current/examples/.agents/skills/use-og-form/SKILL.md +12 -0
  369. package/templates/current/examples/.agents/skills/use-og-form-table/SKILL.md +26 -0
  370. package/templates/current/examples/.agents/skills/use-og-http/SKILL.md +13 -0
  371. package/templates/current/examples/.agents/skills/use-og-router-tabs/SKILL.md +11 -0
  372. package/templates/current/examples/.agents/skills/use-og-search/SKILL.md +14 -0
  373. package/templates/current/examples/.agents/skills/use-og-table/SKILL.md +22 -0
  374. package/templates/current/examples/.agents/skills/use-og-upload/SKILL.md +26 -0
  375. package/templates/current/examples/.api-client-e2e.config.ts +13 -0
  376. package/templates/current/examples/.claude/rules/01-feature-architecture.md +10 -0
  377. package/templates/current/examples/.claude/rules/02-vue-typescript.md +10 -0
  378. package/templates/current/examples/.claude/rules/03-component-policy.md +31 -0
  379. package/templates/current/examples/.claude/rules/04-api-auth-router.md +10 -0
  380. package/templates/current/examples/.claude/rules/05-style.md +10 -0
  381. package/templates/current/examples/.claude/rules/06-quality.md +10 -0
  382. package/templates/current/examples/.claude/skills/admin-component-usage/SKILL.md +28 -0
  383. package/templates/current/examples/.claude/skills/admin-component-usage/references/component-directory.md +270 -0
  384. package/templates/current/examples/.claude/skills/build-admin-feature/SKILL.md +20 -0
  385. package/templates/current/examples/.claude/skills/build-admin-feature/references/component-selection.md +38 -0
  386. package/templates/current/examples/.claude/skills/style-og-origen-ui/SKILL.md +11 -0
  387. package/templates/current/examples/.claude/skills/use-og-dialog/SKILL.md +12 -0
  388. package/templates/current/examples/.claude/skills/use-og-editor/SKILL.md +25 -0
  389. package/templates/current/examples/.claude/skills/use-og-form/SKILL.md +12 -0
  390. package/templates/current/examples/.claude/skills/use-og-form-table/SKILL.md +26 -0
  391. package/templates/current/examples/.claude/skills/use-og-http/SKILL.md +13 -0
  392. package/templates/current/examples/.claude/skills/use-og-router-tabs/SKILL.md +11 -0
  393. package/templates/current/examples/.claude/skills/use-og-search/SKILL.md +14 -0
  394. package/templates/current/examples/.claude/skills/use-og-table/SKILL.md +22 -0
  395. package/templates/current/examples/.claude/skills/use-og-upload/SKILL.md +26 -0
  396. package/templates/current/examples/.codebuddy/rules/01-feature-architecture.md +2 -2
  397. package/templates/current/examples/.codebuddy/rules/03-component-policy.md +4 -1
  398. package/templates/current/examples/.codebuddy/skills/admin-component-usage/SKILL.md +31 -0
  399. package/templates/current/examples/.codebuddy/skills/admin-component-usage/references/component-directory.md +270 -0
  400. package/templates/current/examples/.codebuddy/skills/build-admin-feature/SKILL.md +11 -5
  401. package/templates/current/examples/.codebuddy/skills/build-admin-feature/references/component-selection.md +38 -0
  402. package/templates/current/examples/.codebuddy/skills/use-og-form/SKILL.md +1 -1
  403. package/templates/current/examples/.codebuddy/skills/use-og-form-table/SKILL.md +4 -3
  404. package/templates/current/examples/.codebuddy/skills/use-og-search/SKILL.md +3 -3
  405. package/templates/current/examples/.codebuddy/skills/use-og-table/SKILL.md +16 -10
  406. package/templates/current/examples/.codebuddy/skills/use-og-upload/SKILL.md +6 -5
  407. package/templates/current/examples/.codex/AGENTS.md +55 -8
  408. package/templates/current/examples/.codex/rules/01-feature-architecture.md +2 -2
  409. package/templates/current/examples/.codex/rules/03-component-policy.md +4 -1
  410. package/templates/current/examples/.cursor/rules/.generated +5 -0
  411. package/templates/current/examples/.cursor/rules/01-feature-architecture.mdc +2 -2
  412. package/templates/current/examples/.cursor/rules/03-component-policy.mdc +4 -1
  413. package/templates/current/examples/.cursor/skills/admin-component-usage/SKILL.md +28 -0
  414. package/templates/current/examples/.cursor/skills/admin-component-usage/references/component-directory.md +270 -0
  415. package/templates/current/examples/.cursor/skills/build-admin-feature/SKILL.md +11 -5
  416. package/templates/current/examples/.cursor/skills/build-admin-feature/references/component-selection.md +38 -0
  417. package/templates/current/examples/.cursor/skills/use-og-form/SKILL.md +1 -1
  418. package/templates/current/examples/.cursor/skills/use-og-form-table/SKILL.md +4 -3
  419. package/templates/current/examples/.cursor/skills/use-og-search/SKILL.md +3 -3
  420. package/templates/current/examples/.cursor/skills/use-og-table/SKILL.md +16 -10
  421. package/templates/current/examples/.cursor/skills/use-og-upload/SKILL.md +6 -5
  422. package/templates/current/examples/{.env.example → .env.dev} +3 -2
  423. package/templates/current/examples/.env.mock +4 -0
  424. package/templates/current/examples/.env.production +5 -0
  425. package/templates/current/examples/.env.test +4 -0
  426. package/templates/current/examples/.prettierignore +17 -0
  427. package/templates/current/examples/.prettierrc +8 -0
  428. package/templates/current/examples/.qoder/rules/01-feature-architecture.md +3 -4
  429. package/templates/current/examples/.qoder/rules/02-vue-typescript.md +1 -2
  430. package/templates/current/examples/.qoder/rules/03-component-policy.md +5 -3
  431. package/templates/current/examples/.qoder/rules/04-api-auth-router.md +1 -2
  432. package/templates/current/examples/.qoder/rules/05-style.md +1 -2
  433. package/templates/current/examples/.qoder/rules/06-quality.md +1 -2
  434. package/templates/current/examples/.qoder/skills/admin-component-usage/SKILL.md +28 -0
  435. package/templates/current/examples/.qoder/skills/admin-component-usage/references/component-directory.md +270 -0
  436. package/templates/current/examples/.qoder/skills/build-admin-feature/SKILL.md +11 -5
  437. package/templates/current/examples/.qoder/skills/build-admin-feature/references/component-selection.md +38 -0
  438. package/templates/current/examples/.qoder/skills/use-og-form/SKILL.md +1 -1
  439. package/templates/current/examples/.qoder/skills/use-og-form-table/SKILL.md +4 -3
  440. package/templates/current/examples/.qoder/skills/use-og-search/SKILL.md +3 -3
  441. package/templates/current/examples/.qoder/skills/use-og-table/SKILL.md +16 -10
  442. package/templates/current/examples/.qoder/skills/use-og-upload/SKILL.md +6 -5
  443. package/templates/current/examples/.zcode/skills/admin-component-usage/SKILL.md +28 -0
  444. package/templates/current/examples/.zcode/skills/admin-component-usage/references/component-directory.md +270 -0
  445. package/templates/current/examples/.zcode/skills/build-admin-feature/SKILL.md +20 -0
  446. package/templates/current/examples/.zcode/skills/build-admin-feature/references/component-selection.md +38 -0
  447. package/templates/current/examples/.zcode/skills/style-og-origen-ui/SKILL.md +11 -0
  448. package/templates/current/examples/.zcode/skills/use-og-dialog/SKILL.md +12 -0
  449. package/templates/current/examples/.zcode/skills/use-og-editor/SKILL.md +25 -0
  450. package/templates/current/examples/.zcode/skills/use-og-form/SKILL.md +12 -0
  451. package/templates/current/examples/.zcode/skills/use-og-form-table/SKILL.md +26 -0
  452. package/templates/current/examples/.zcode/skills/use-og-http/SKILL.md +13 -0
  453. package/templates/current/examples/.zcode/skills/use-og-router-tabs/SKILL.md +11 -0
  454. package/templates/current/examples/.zcode/skills/use-og-search/SKILL.md +14 -0
  455. package/templates/current/examples/.zcode/skills/use-og-table/SKILL.md +22 -0
  456. package/templates/current/examples/.zcode/skills/use-og-upload/SKILL.md +26 -0
  457. package/templates/current/examples/AGENTS.md +55 -9
  458. package/templates/current/examples/CHANGELOG.md +107 -0
  459. package/templates/current/examples/CLAUDE.md +3 -0
  460. package/templates/current/examples/README.md +58 -88
  461. package/templates/current/examples/component-catalog.json +766 -348
  462. package/templates/current/examples/component-catalog.v2.json +2040 -0
  463. package/templates/current/examples/docs/components/dialog.md +405 -0
  464. package/templates/current/examples/docs/components/editor-viewer.md +87 -0
  465. package/templates/current/examples/docs/components/editor.md +275 -0
  466. package/templates/current/examples/docs/components/form-table.md +222 -0
  467. package/templates/current/examples/docs/components/form.md +750 -0
  468. package/templates/current/examples/docs/components/index.md +44 -0
  469. package/templates/current/examples/docs/components/router.md +452 -0
  470. package/templates/current/examples/docs/components/search.md +1205 -0
  471. package/templates/current/examples/docs/components/svg-icon.md +124 -0
  472. package/templates/current/examples/docs/components/table-local.md +176 -0
  473. package/templates/current/examples/docs/components/table-with-search.md +207 -0
  474. package/templates/current/examples/docs/components/table.md +813 -0
  475. package/templates/current/examples/docs/components/tabs.md +440 -0
  476. package/templates/current/examples/docs/components/upload.md +349 -0
  477. package/templates/current/examples/eslint.config.js +89 -0
  478. package/templates/current/examples/index.html +1 -1
  479. package/templates/current/examples/openapi.json +10048 -999
  480. package/templates/current/examples/package.json +45 -33
  481. package/templates/current/examples/playwright.config.ts +20 -6
  482. package/templates/current/examples/playwright.mock.config.ts +42 -0
  483. package/templates/current/examples/pnpm-workspace.yaml +19 -3
  484. package/templates/current/examples/recipes/remote-crud-dialog-form.vue +15 -13
  485. package/templates/current/examples/scaffold.lock.json +164 -4
  486. package/templates/current/examples/scripts/api-codegen.config.ts +35 -0
  487. package/templates/current/examples/scripts/api-codegen.ts +2015 -0
  488. package/templates/current/examples/scripts/api-templates/http-client.ejs +359 -0
  489. package/templates/current/examples/scripts/check-admin-scaffold.mjs +311 -17
  490. package/templates/current/examples/scripts/generate-api.ts +290 -85
  491. package/templates/current/examples/scripts/lib/admin-component-catalog.mjs +515 -0
  492. package/templates/current/examples/scripts/lib/repository-root.mjs +9 -0
  493. package/templates/current/examples/scripts/mock-api.ts +1356 -0
  494. package/templates/current/examples/scripts/remove-examples.mjs +9 -34
  495. package/templates/current/examples/src/App.vue +9 -18
  496. package/templates/current/examples/src/api/generated/data-contracts.ts +23 -265
  497. package/templates/current/examples/src/api/generated/http-client.ts +351 -180
  498. package/templates/current/examples/src/api/generated/index.ts +22 -0
  499. package/templates/current/examples/src/api/generated/services/auth.ts +123 -0
  500. package/templates/current/examples/src/api/generated/services/common/files.ts +111 -0
  501. package/templates/current/examples/src/api/generated/services/monitor/cache.ts +164 -0
  502. package/templates/current/examples/src/api/generated/services/monitor/job.ts +195 -0
  503. package/templates/current/examples/src/api/generated/services/monitor/jobLog.ts +126 -0
  504. package/templates/current/examples/src/api/generated/services/monitor/logininfor.ts +126 -0
  505. package/templates/current/examples/src/api/generated/services/monitor/online.ts +66 -0
  506. package/templates/current/examples/src/api/generated/services/monitor/operlog.ts +106 -0
  507. package/templates/current/examples/src/api/generated/services/monitor/server.ts +41 -0
  508. package/templates/current/examples/src/api/generated/services/system/configs.ts +190 -0
  509. package/templates/current/examples/src/api/generated/services/system/departments.ts +173 -0
  510. package/templates/current/examples/src/api/generated/services/system/dictionaries/data.ts +169 -0
  511. package/templates/current/examples/src/api/generated/services/system/dictionaries/types.ts +187 -0
  512. package/templates/current/examples/src/api/generated/services/system/index.ts +158 -0
  513. package/templates/current/examples/src/api/generated/services/system/menus.ts +193 -0
  514. package/templates/current/examples/src/api/generated/services/system/notices.ts +221 -0
  515. package/templates/current/examples/src/api/generated/services/system/posts.ts +168 -0
  516. package/templates/current/examples/src/api/generated/services/system/roles.ts +354 -0
  517. package/templates/current/examples/src/api/generated/services/system/users.ts +425 -0
  518. package/templates/current/examples/src/api/generated/services/tool/code-generator.ts +304 -0
  519. package/templates/current/examples/src/api/generated/types/auth.types.ts +132 -0
  520. package/templates/current/examples/src/api/generated/types/common/files.types.ts +57 -0
  521. package/templates/current/examples/src/api/generated/types/common.ts +174 -0
  522. package/templates/current/examples/src/api/generated/types/enum-dict.ts +94 -0
  523. package/templates/current/examples/src/api/generated/types/enums.ts +155 -0
  524. package/templates/current/examples/src/api/generated/types/monitor/cache.types.ts +149 -0
  525. package/templates/current/examples/src/api/generated/types/monitor/job.types.ts +207 -0
  526. package/templates/current/examples/src/api/generated/types/monitor/jobLog.types.ts +134 -0
  527. package/templates/current/examples/src/api/generated/types/monitor/logininfor.types.ts +135 -0
  528. package/templates/current/examples/src/api/generated/types/monitor/online.types.ts +80 -0
  529. package/templates/current/examples/src/api/generated/types/monitor/operlog.types.ts +126 -0
  530. package/templates/current/examples/src/api/generated/types/monitor/server.types.ts +205 -0
  531. package/templates/current/examples/src/api/generated/types/system/configs.types.ts +200 -0
  532. package/templates/current/examples/src/api/generated/types/system/departments.types.ts +145 -0
  533. package/templates/current/examples/src/api/generated/types/system/dictionaries/data.types.ts +210 -0
  534. package/templates/current/examples/src/api/generated/types/system/dictionaries/types.types.ts +221 -0
  535. package/templates/current/examples/src/api/generated/types/system/index.types.ts +19 -0
  536. package/templates/current/examples/src/api/generated/types/system/menus.types.ts +234 -0
  537. package/templates/current/examples/src/api/generated/types/system/notices.types.ts +270 -0
  538. package/templates/current/examples/src/api/generated/types/system/posts.types.ts +198 -0
  539. package/templates/current/examples/src/api/generated/types/system/roles.types.ts +410 -0
  540. package/templates/current/examples/src/api/generated/types/system/users.types.ts +413 -0
  541. package/templates/current/examples/src/api/generated/types/tool/code-generator.types.ts +388 -0
  542. package/templates/current/examples/src/api/index.ts +44 -39
  543. package/templates/current/examples/src/app/__tests__/api-generated.types.ts +24 -0
  544. package/templates/current/examples/src/app/api.ts +6 -0
  545. package/templates/current/examples/src/app/authorization/permission.ts +9 -0
  546. package/templates/current/{clean/src/app → examples/src/app/config}/runtimeConfig.ts +44 -12
  547. package/templates/current/examples/src/app/errors/errorMessage.ts +80 -0
  548. package/templates/current/examples/src/app/http/client.ts +141 -0
  549. package/templates/current/examples/src/app/http/http-adapter.ts +71 -0
  550. package/templates/current/{clean/src/app → examples/src/app/i18n}/adminLocale.ts +25 -19
  551. package/templates/current/examples/src/app/{localeFormat.ts → i18n/localeFormat.ts} +29 -6
  552. package/templates/current/examples/src/app/i18n/origenUiLocale.ts +15 -0
  553. package/templates/current/examples/src/app/menu/menu.ts +175 -0
  554. package/templates/current/examples/src/app/menu/menuTypes.ts +20 -0
  555. package/templates/current/examples/src/{features → app}/security/devtoolsProtection.ts +8 -7
  556. package/templates/current/examples/src/app/ui/createAdminUi.ts +31 -0
  557. package/templates/current/examples/src/app/ui/iconCatalog.ts +71 -0
  558. package/templates/current/examples/src/assets/icons/appearance.svg +1 -0
  559. package/templates/current/examples/src/assets/icons/arrow-right.svg +1 -0
  560. package/templates/current/examples/src/assets/icons/check.svg +1 -0
  561. package/templates/current/examples/src/assets/icons/circle-check.svg +1 -0
  562. package/templates/current/examples/src/assets/icons/default.svg +4 -0
  563. package/templates/current/examples/src/assets/icons/directory/setting.svg +1 -0
  564. package/templates/current/examples/src/assets/icons/expand.svg +1 -0
  565. package/templates/current/examples/src/assets/icons/fold.svg +1 -0
  566. package/templates/current/examples/src/assets/icons/key.svg +1 -0
  567. package/templates/current/examples/src/assets/icons/lock.svg +1 -0
  568. package/templates/current/examples/src/assets/icons/monitor.svg +1 -0
  569. package/templates/current/examples/src/assets/icons/moon.svg +11 -0
  570. package/templates/current/examples/src/assets/icons/page/department.svg +1 -0
  571. package/templates/current/examples/src/assets/icons/page/dictionary.svg +1 -0
  572. package/templates/current/examples/src/assets/icons/page/menus.svg +1 -0
  573. package/templates/current/examples/src/assets/icons/page/user.svg +1 -0
  574. package/templates/current/examples/src/assets/icons/page/users.svg +1 -0
  575. package/templates/current/examples/src/assets/icons/plus.svg +1 -0
  576. package/templates/current/examples/src/assets/icons/profile.svg +1 -0
  577. package/templates/current/examples/src/assets/icons/refresh.svg +1 -0
  578. package/templates/current/examples/src/assets/icons/roles.svg +1 -0
  579. package/templates/current/examples/src/assets/icons/search.svg +1 -0
  580. package/templates/current/examples/src/assets/icons/sunny.svg +1 -0
  581. package/templates/current/examples/src/assets/icons/system.svg +1 -0
  582. package/templates/current/examples/src/assets/icons/theme-auto.svg +14 -0
  583. package/templates/current/examples/src/assets/icons/tune.svg +13 -0
  584. package/templates/current/examples/src/{features/shell/components → components}/RouteProgress.vue +2 -2
  585. package/templates/current/{clean/src/features/system/access → examples/src}/composables/useAuthorizationRefresh.ts +6 -1
  586. package/templates/current/examples/src/composables/useSystemTableSearchVisibility.ts +33 -0
  587. package/templates/current/examples/src/{features/appearance/composables → composables}/useTheme.ts +1 -1
  588. package/templates/current/examples/src/env.d.ts +6 -19
  589. package/templates/current/examples/src/layouts/AdminLayout.vue +7 -9
  590. package/templates/current/examples/src/{features/shell/components → layouts}/AdminWatermark.vue +2 -2
  591. package/templates/current/examples/src/layouts/BreadcrumbBar.vue +9 -1
  592. package/templates/current/examples/src/layouts/SideMenu.vue +7 -15
  593. package/templates/current/examples/src/{features/appearance/components → layouts}/ThemePanel.vue +39 -11
  594. package/templates/current/examples/src/layouts/TopBar.vue +60 -28
  595. package/templates/current/examples/src/layouts/WorkspaceTabs.vue +10 -1
  596. package/templates/current/examples/src/layouts/topBarMenuSearch.ts +25 -4
  597. package/templates/current/examples/src/locales/en-US.json +227 -219
  598. package/templates/current/examples/src/locales/index.ts +72 -32
  599. package/templates/current/examples/src/locales/messages-types.ts +15 -10
  600. package/templates/current/examples/src/locales/vue-i18n.d.ts +1 -1
  601. package/templates/current/examples/src/locales/zh-CN.json +226 -218
  602. package/templates/current/examples/src/locales/zh-TW.json +222 -214
  603. package/templates/current/examples/src/main.ts +50 -40
  604. package/templates/current/examples/src/router/bootstrap.ts +69 -24
  605. package/templates/current/examples/src/router/dynamic/componentLoader.ts +150 -0
  606. package/templates/current/examples/src/router/{dynamicMenuRefresh.ts → dynamic/dynamicMenuRefresh.ts} +6 -2
  607. package/templates/current/examples/src/router/dynamic/dynamicRoutes.ts +247 -0
  608. package/templates/current/examples/src/router/navigation/guards.ts +12 -0
  609. package/templates/current/examples/src/router/navigation/paths.ts +28 -0
  610. package/templates/current/examples/src/router/navigation/staticRoutes.ts +109 -0
  611. package/templates/current/examples/src/router/{queryEncryption.ts → query/queryEncryption.ts} +29 -12
  612. package/templates/current/examples/src/router/query/routeQuery.ts +29 -0
  613. package/templates/current/examples/src/router/{useRouteQueryDefaults.ts → query/useRouteQueryDefaults.ts} +9 -8
  614. package/templates/current/examples/src/router/query/useRouteQueryDefaults.types.ts +28 -0
  615. package/templates/current/examples/src/router/{runtimeErrorRecovery.ts → recovery/runtimeErrorRecovery.ts} +21 -3
  616. package/templates/current/examples/src/{features/auth/store → store}/auth.ts +96 -61
  617. package/templates/current/examples/src/store/dictionaries.ts +86 -0
  618. package/templates/current/examples/src/{features/shell/store → store}/sidebar.ts +9 -2
  619. package/templates/current/{clean/src/features/appearance → examples/src}/store/theme.ts +8 -4
  620. package/templates/current/examples/src/styles/layout.css +51 -0
  621. package/templates/current/examples/src/templates/og-form.ts +7 -2
  622. package/templates/current/examples/src/templates/og-table.ts +88 -20
  623. package/templates/current/examples/src/templates/router.ts +11 -2
  624. package/templates/current/examples/src/utils/color-mix.ts +6 -2
  625. package/templates/current/examples/src/utils/download.ts +11 -0
  626. package/templates/current/examples/src/utils/permissions.ts +1 -1
  627. package/templates/current/examples/src/utils/retryableDialog.ts +46 -0
  628. package/templates/current/{clean/scripts/clean-overlay/src/features → examples/src/views}/errors/pages/Forbidden.vue +6 -2
  629. package/templates/current/examples/src/views/errors/pages/MethodNotAllowed.vue +34 -0
  630. package/templates/current/examples/{scripts/clean-overlay/src/features → src/views}/errors/pages/NotFound.vue +6 -2
  631. package/templates/current/examples/{scripts/clean-overlay/src/features → src/views}/errors/pages/ServerError.vue +6 -2
  632. package/templates/current/examples/src/{features/auth/pages/Login.vue → views/login/pages/index.vue} +99 -10
  633. package/templates/current/examples/src/views/system/access/services/admin-repository.ts +489 -0
  634. package/templates/current/examples/src/views/system/access/services/rbac.ts +317 -0
  635. package/templates/current/examples/src/views/system/dept/components/DepartmentEditorForm.vue +87 -0
  636. package/templates/current/examples/src/views/system/dept/composables/useDepartmentManagement.ts +314 -0
  637. package/templates/current/examples/src/views/system/dept/pages/index.vue +44 -0
  638. package/templates/current/examples/src/views/system/dept/services/departments.ts +168 -0
  639. package/templates/current/examples/src/views/system/dict/components/DictionaryDataEditorForm.vue +98 -0
  640. package/templates/current/examples/src/views/system/dict/components/DictionaryDataPreview.vue +233 -0
  641. package/templates/current/examples/src/views/system/dict/components/DictionaryTypeEditorForm.vue +66 -0
  642. package/templates/current/examples/src/views/system/dict/composables/useDictionaryDataManagement.ts +406 -0
  643. package/templates/current/examples/src/views/system/dict/composables/useDictionaryTypeManagement.ts +329 -0
  644. package/templates/current/examples/src/views/system/dict/data/pages/index.vue +134 -0
  645. package/templates/current/examples/src/views/system/dict/pages/index.vue +113 -0
  646. package/templates/current/examples/src/views/system/dict/services/dictionaries.ts +239 -0
  647. package/templates/current/examples/src/views/system/menu/components/MenuEditorForm.vue +252 -0
  648. package/templates/current/examples/src/views/system/menu/composables/useMenuManagement.ts +357 -0
  649. package/templates/current/examples/src/views/system/menu/menuDraft.ts +45 -0
  650. package/templates/current/examples/src/views/system/menu/pages/ExternalLink.vue +37 -0
  651. package/templates/current/examples/src/views/system/menu/pages/index.vue +75 -0
  652. package/templates/current/examples/src/views/system/post/components/PostEditorForm.vue +69 -0
  653. package/templates/current/examples/src/views/system/post/composables/usePostManagement.ts +245 -0
  654. package/templates/current/examples/src/views/system/post/pages/index.vue +92 -0
  655. package/templates/current/examples/src/views/system/post/services/posts.ts +100 -0
  656. package/templates/current/examples/src/views/system/role/auth-users/pages/index.vue +100 -0
  657. package/templates/current/examples/src/views/system/role/components/RoleDataScopeForm.vue +167 -0
  658. package/templates/current/examples/src/views/system/role/components/RoleEditorForm.vue +165 -0
  659. package/templates/current/examples/src/views/system/role/components/RoleUserSelectForm.vue +129 -0
  660. package/templates/current/examples/src/views/system/role/composables/useRoleManagement.ts +422 -0
  661. package/templates/current/examples/src/views/system/role/composables/useRoleUserManagement.ts +233 -0
  662. package/templates/current/examples/src/views/system/role/pages/index.vue +110 -0
  663. package/templates/current/examples/src/views/system/role/services/roleAccess.ts +162 -0
  664. package/templates/current/examples/src/views/system/user/auth-roles/pages/index.vue +209 -0
  665. package/templates/current/examples/src/views/system/user/components/UserDetailsForm.vue +108 -0
  666. package/templates/current/examples/src/views/system/user/components/UserEditorForm.vue +207 -0
  667. package/templates/current/examples/src/views/system/user/components/UserImportDialog.vue +80 -0
  668. package/templates/current/examples/src/views/system/user/components/UserResetPasswordForm.vue +56 -0
  669. package/templates/current/examples/src/views/system/user/composables/useUserManagement.ts +502 -0
  670. package/templates/current/examples/src/views/system/user/pages/index.vue +459 -0
  671. package/templates/current/examples/tests/e2e/admin-access-business.spec.ts +33 -0
  672. package/templates/current/examples/tests/e2e/admin-shell.spec.ts +50 -0
  673. package/templates/current/examples/tests/e2e/fixtures/adminMockBackend.ts +95 -0
  674. package/templates/current/examples/tests/e2e/fixtures/labelGeometry.ts +52 -0
  675. package/templates/current/examples/tests/e2e/mock-api-generation.spec.ts +27 -0
  676. package/templates/current/examples/tests/e2e/mock-business.spec.ts +555 -0
  677. package/templates/current/examples/tests/e2e/mock-menu-retry-form-label.spec.ts +100 -0
  678. package/templates/current/examples/tests/e2e/mock-shell.spec.ts +25 -0
  679. package/templates/current/examples/tests/e2e/mock-tree-selection-layout.spec.ts +113 -0
  680. package/templates/current/examples/tests/unit/api/api-codegen.spec.ts +893 -0
  681. package/templates/current/examples/tests/unit/api/client.spec.ts +145 -0
  682. package/templates/current/examples/tests/unit/api/generated-http-client.spec.ts +290 -0
  683. package/templates/current/{clean/src → examples/tests/unit}/api/http-adapter.spec.ts +3 -3
  684. package/templates/current/examples/tests/unit/api/system-apis.spec.ts +118 -0
  685. package/templates/current/examples/tests/unit/app/createAdminUi.spec.ts +79 -0
  686. package/templates/current/examples/{src → tests/unit}/app/errorMessage.spec.ts +1 -1
  687. package/templates/current/examples/tests/unit/app/iconCatalog.spec.ts +12 -0
  688. package/templates/current/examples/tests/unit/app/menu.spec.ts +215 -0
  689. package/templates/current/{clean/src → examples/tests/unit}/app/origenUiLocale.spec.ts +1 -1
  690. package/templates/current/{clean/src → examples/tests/unit}/app/permission.spec.ts +4 -5
  691. package/templates/current/examples/tests/unit/app/runtimeConfig.spec.ts +36 -0
  692. package/templates/current/{clean/src/features → examples/tests/unit/app}/security/devtoolsProtection.spec.ts +17 -7
  693. package/templates/current/{clean/src/features/shell → examples/tests/unit}/composables/useRouteProgress.spec.ts +1 -1
  694. package/templates/current/{clean/src/features/shell/components → examples/tests/unit/layouts}/AdminWatermark.spec.ts +5 -7
  695. package/templates/current/{clean/src → examples/tests/unit}/layouts/topBarMenuSearch.spec.ts +25 -8
  696. package/templates/current/examples/{src → tests/unit}/locales/messages.spec.ts +43 -17
  697. package/templates/current/examples/tests/unit/router/dynamicMenuRefresh.spec.ts +151 -0
  698. package/templates/current/examples/tests/unit/router/dynamicRoutes.spec.ts +374 -0
  699. package/templates/current/examples/tests/unit/router/paths.spec.ts +103 -0
  700. package/templates/current/examples/{src → tests/unit}/router/queryEncryption.spec.ts +49 -12
  701. package/templates/current/{clean/src → examples/tests/unit}/router/routeQuery.spec.ts +8 -1
  702. package/templates/current/examples/{src → tests/unit}/router/runtimeErrorRecovery.spec.ts +11 -6
  703. package/templates/current/{clean/src → examples/tests/unit}/router/useRouteQueryDefaults.spec.ts +46 -12
  704. package/templates/current/examples/tests/unit/scripts/mock-api.spec.ts +440 -0
  705. package/templates/current/examples/{scripts → tests/unit/scripts}/vite-build-policy.spec.ts +35 -6
  706. package/templates/current/examples/{src/features/auth → tests/unit}/store/auth.spec.ts +68 -15
  707. package/templates/current/examples/tests/unit/store/dictionaries.spec.ts +106 -0
  708. package/templates/current/{clean/src → examples/tests/unit}/templates/templates.spec.ts +60 -16
  709. package/templates/current/examples/{src/utils/__tests__ → tests/unit/utils}/color-mix.spec.ts +1 -1
  710. package/templates/current/examples/tests/unit/utils/retryableDialog.spec.ts +61 -0
  711. package/templates/current/examples/{scripts/clean-overlay/src/features/errors/pages → tests/unit/views/errors}/error-pages.spec.ts +12 -9
  712. package/templates/current/examples/tests/unit/views/feature-composables.spec.ts +233 -0
  713. package/templates/current/examples/tests/unit/views/system/access/admin-repository.spec.ts +353 -0
  714. package/templates/current/examples/tests/unit/views/system/access/rbac.spec.ts +329 -0
  715. package/templates/current/examples/tests/unit/views/system/dept/departments.spec.ts +104 -0
  716. package/templates/current/examples/tests/unit/views/system/dict/dictionaries.spec.ts +234 -0
  717. package/templates/current/examples/tests/unit/views/system/menu/menuDraft.spec.ts +77 -0
  718. package/templates/current/examples/tests/unit/views/system/menu/useMenuManagement.spec.ts +339 -0
  719. package/templates/current/examples/tests/unit/views/system/user/searchControl.spec.ts +128 -0
  720. package/templates/current/examples/tsconfig.json +4 -19
  721. package/templates/current/examples/vite.build-policy.ts +97 -22
  722. package/templates/current/examples/vite.config.ts +50 -7
  723. package/templates/current/clean/.codebuddy/AGENTS.md +0 -18
  724. package/templates/current/clean/.codex/skills/build-admin-feature/SKILL.md +0 -14
  725. package/templates/current/clean/.codex/skills/build-admin-feature/references/component-selection.md +0 -25
  726. package/templates/current/clean/.codex/skills/use-og-table/SKILL.md +0 -16
  727. package/templates/current/clean/.cursor/AGENTS.md +0 -18
  728. package/templates/current/clean/.env.production.example +0 -31
  729. package/templates/current/clean/.qoder/AGENTS.md +0 -15
  730. package/templates/current/clean/e2e/admin-shell.spec.ts +0 -156
  731. package/templates/current/clean/e2e/demo-shell.spec.ts +0 -372
  732. package/templates/current/clean/playwright.demo.config.ts +0 -25
  733. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/NotFound.vue +0 -31
  734. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/ServerError.vue +0 -31
  735. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/error-pages.spec.ts +0 -41
  736. package/templates/current/clean/scripts/clean-overlay/src/main.ts +0 -100
  737. package/templates/current/clean/scripts/clean-overlay/src/router/componentCache.ts +0 -12
  738. package/templates/current/clean/scripts/clean-overlay/src/router/componentRegistry.ts +0 -14
  739. package/templates/current/clean/scripts/clean-overlay/src/router/dynamicRoutes.spec.ts +0 -77
  740. package/templates/current/clean/scripts/clean-overlay/src/router/paths.ts +0 -21
  741. package/templates/current/clean/scripts/clean-overlay/src/router/staticRoutes.ts +0 -63
  742. package/templates/current/clean/scripts/demo-api.ts +0 -873
  743. package/templates/current/clean/src/api/client.spec.ts +0 -66
  744. package/templates/current/clean/src/api/client.ts +0 -152
  745. 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 +0 -144
  746. 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 +0 -50
  747. 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 +0 -63
  748. 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 +0 -169
  749. 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 +0 -180
  750. 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 +0 -167
  751. 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 +0 -168
  752. package/templates/current/clean/src/api/generated//350/256/244/350/257/201.ts +0 -95
  753. package/templates/current/clean/src/api/http-adapter.ts +0 -83
  754. package/templates/current/clean/src/app/createAdminUi.spec.ts +0 -166
  755. package/templates/current/clean/src/app/createAdminUi.ts +0 -63
  756. package/templates/current/clean/src/app/embedded-token.spec.ts +0 -40
  757. package/templates/current/clean/src/app/embedded.spec.ts +0 -135
  758. package/templates/current/clean/src/app/embedded.ts +0 -255
  759. package/templates/current/clean/src/app/errorMessage.ts +0 -53
  760. package/templates/current/clean/src/app/menu-host.spec.ts +0 -77
  761. package/templates/current/clean/src/app/menu.spec.ts +0 -320
  762. package/templates/current/clean/src/app/menu.ts +0 -308
  763. package/templates/current/clean/src/app/menuTypes.ts +0 -18
  764. package/templates/current/clean/src/app/origenUiLocale.ts +0 -10
  765. package/templates/current/clean/src/app/permission.ts +0 -9
  766. package/templates/current/clean/src/demo-api.spec.ts +0 -478
  767. package/templates/current/clean/src/features/errors/pages/error-pages.spec.ts +0 -41
  768. package/templates/current/clean/src/features/system/access/api/admin-repository.spec.ts +0 -14
  769. package/templates/current/clean/src/features/system/access/api/admin-repository.ts +0 -298
  770. package/templates/current/clean/src/features/system/access/api/rbac.spec.ts +0 -72
  771. package/templates/current/clean/src/features/system/access/api/rbac.ts +0 -292
  772. package/templates/current/clean/src/features/system/access/composables/useAuthorizationPolling.spec.ts +0 -134
  773. package/templates/current/clean/src/features/system/access/composables/useAuthorizationPolling.ts +0 -96
  774. package/templates/current/clean/src/features/workspace/pages/Profile.vue +0 -185
  775. package/templates/current/clean/src/router/componentCache.ts +0 -12
  776. package/templates/current/clean/src/router/componentRegistry.ts +0 -14
  777. package/templates/current/clean/src/router/dynamicMenuRefresh.spec.ts +0 -101
  778. package/templates/current/clean/src/router/dynamicRoutes.spec.ts +0 -77
  779. package/templates/current/clean/src/router/dynamicRoutes.ts +0 -177
  780. package/templates/current/clean/src/router/guards.ts +0 -5
  781. package/templates/current/clean/src/router/paths.spec.ts +0 -50
  782. package/templates/current/clean/src/router/paths.ts +0 -21
  783. package/templates/current/clean/src/router/routeQuery.ts +0 -6
  784. package/templates/current/clean/src/router/staticRoutes.ts +0 -63
  785. package/templates/current/clean/src/router/useRouteQueryDefaults.types.ts +0 -20
  786. package/templates/current/examples/.codebuddy/AGENTS.md +0 -18
  787. package/templates/current/examples/.codex/skills/build-admin-feature/SKILL.md +0 -14
  788. package/templates/current/examples/.codex/skills/build-admin-feature/references/component-selection.md +0 -25
  789. package/templates/current/examples/.codex/skills/use-og-table/SKILL.md +0 -16
  790. package/templates/current/examples/.cursor/AGENTS.md +0 -18
  791. package/templates/current/examples/.env.production.example +0 -31
  792. package/templates/current/examples/.qoder/AGENTS.md +0 -15
  793. package/templates/current/examples/e2e/admin-shell.spec.ts +0 -156
  794. package/templates/current/examples/e2e/demo-shell.spec.ts +0 -372
  795. package/templates/current/examples/playwright.demo.config.ts +0 -25
  796. package/templates/current/examples/scripts/clean-overlay/src/features/errors/pages/Forbidden.vue +0 -31
  797. package/templates/current/examples/scripts/clean-overlay/src/main.ts +0 -100
  798. package/templates/current/examples/scripts/clean-overlay/src/router/componentCache.ts +0 -12
  799. package/templates/current/examples/scripts/clean-overlay/src/router/componentRegistry.ts +0 -14
  800. package/templates/current/examples/scripts/clean-overlay/src/router/dynamicRoutes.spec.ts +0 -77
  801. package/templates/current/examples/scripts/clean-overlay/src/router/paths.ts +0 -21
  802. package/templates/current/examples/scripts/clean-overlay/src/router/staticRoutes.ts +0 -63
  803. package/templates/current/examples/scripts/demo-api.ts +0 -873
  804. package/templates/current/examples/src/api/client.spec.ts +0 -66
  805. package/templates/current/examples/src/api/client.ts +0 -152
  806. 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 +0 -144
  807. 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 +0 -50
  808. 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 +0 -63
  809. 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 +0 -169
  810. 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 +0 -180
  811. 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 +0 -167
  812. 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 +0 -168
  813. package/templates/current/examples/src/api/generated//350/256/244/350/257/201.ts +0 -95
  814. package/templates/current/examples/src/api/http-adapter.ts +0 -83
  815. package/templates/current/examples/src/app/createAdminUi.spec.ts +0 -166
  816. package/templates/current/examples/src/app/createAdminUi.ts +0 -63
  817. package/templates/current/examples/src/app/embedded-token.spec.ts +0 -40
  818. package/templates/current/examples/src/app/embedded.spec.ts +0 -135
  819. package/templates/current/examples/src/app/embedded.ts +0 -255
  820. package/templates/current/examples/src/app/errorMessage.ts +0 -53
  821. package/templates/current/examples/src/app/menu-host.spec.ts +0 -77
  822. package/templates/current/examples/src/app/menu.spec.ts +0 -320
  823. package/templates/current/examples/src/app/menu.ts +0 -308
  824. package/templates/current/examples/src/app/menuTypes.ts +0 -18
  825. package/templates/current/examples/src/app/origenUiLocale.ts +0 -10
  826. package/templates/current/examples/src/app/permission.ts +0 -9
  827. package/templates/current/examples/src/demo-api.spec.ts +0 -478
  828. package/templates/current/examples/src/features/errors/pages/Forbidden.vue +0 -31
  829. package/templates/current/examples/src/features/errors/pages/NotFound.vue +0 -31
  830. package/templates/current/examples/src/features/errors/pages/ServerError.vue +0 -31
  831. package/templates/current/examples/src/features/feature-composables.spec.ts +0 -245
  832. package/templates/current/examples/src/features/system/access/api/admin-repository.spec.ts +0 -14
  833. package/templates/current/examples/src/features/system/access/api/admin-repository.ts +0 -298
  834. package/templates/current/examples/src/features/system/access/api/rbac.spec.ts +0 -72
  835. package/templates/current/examples/src/features/system/access/api/rbac.ts +0 -292
  836. package/templates/current/examples/src/features/system/access/composables/useAuthorizationPolling.spec.ts +0 -134
  837. package/templates/current/examples/src/features/system/access/composables/useAuthorizationPolling.ts +0 -96
  838. package/templates/current/examples/src/features/system/audit/composables/useAuditManagement.ts +0 -122
  839. package/templates/current/examples/src/features/system/audit/pages/AuditList.vue +0 -20
  840. package/templates/current/examples/src/features/system/menus/components/MenuEditorForm.vue +0 -279
  841. package/templates/current/examples/src/features/system/menus/composables/useMenuManagement.ts +0 -435
  842. package/templates/current/examples/src/features/system/menus/menuDraft.spec.ts +0 -204
  843. package/templates/current/examples/src/features/system/menus/menuDraft.ts +0 -116
  844. package/templates/current/examples/src/features/system/menus/menuTreePrecheck.spec.ts +0 -268
  845. package/templates/current/examples/src/features/system/menus/menuTreePrecheck.ts +0 -317
  846. package/templates/current/examples/src/features/system/menus/pages/MenuList.vue +0 -51
  847. package/templates/current/examples/src/features/system/roles/components/RoleEditorForm.vue +0 -116
  848. package/templates/current/examples/src/features/system/roles/composables/useRoleManagement.ts +0 -194
  849. package/templates/current/examples/src/features/system/roles/pages/RoleList.vue +0 -47
  850. package/templates/current/examples/src/features/system/users/components/UserEditorForm.vue +0 -104
  851. package/templates/current/examples/src/features/system/users/composables/useUserManagement.ts +0 -228
  852. package/templates/current/examples/src/features/system/users/pages/UserList.vue +0 -51
  853. package/templates/current/examples/src/features/workspace/pages/Dashboard.spec.ts +0 -41
  854. package/templates/current/examples/src/features/workspace/pages/Dashboard.vue +0 -325
  855. package/templates/current/examples/src/features/workspace/pages/Profile.vue +0 -185
  856. package/templates/current/examples/src/router/componentCache.ts +0 -18
  857. package/templates/current/examples/src/router/componentRegistry.ts +0 -66
  858. package/templates/current/examples/src/router/dynamicMenuRefresh.spec.ts +0 -101
  859. package/templates/current/examples/src/router/dynamicRoutes.spec.ts +0 -144
  860. package/templates/current/examples/src/router/dynamicRoutes.ts +0 -177
  861. package/templates/current/examples/src/router/guards.ts +0 -5
  862. package/templates/current/examples/src/router/paths.spec.ts +0 -50
  863. package/templates/current/examples/src/router/paths.ts +0 -21
  864. package/templates/current/examples/src/router/routeQuery.ts +0 -6
  865. package/templates/current/examples/src/router/staticRoutes.ts +0 -63
  866. package/templates/current/examples/src/router/useRouteQueryDefaults.types.ts +0 -20
  867. /package/templates/current/clean/{.codex → .agents}/skills/style-og-origen-ui/SKILL.md +0 -0
  868. /package/templates/current/clean/{.codex → .agents}/skills/style-og-origen-ui/agents/openai.yaml +0 -0
  869. /package/templates/current/clean/{.codex → .agents}/skills/use-og-dialog/SKILL.md +0 -0
  870. /package/templates/current/clean/{.codex → .agents}/skills/use-og-dialog/agents/openai.yaml +0 -0
  871. /package/templates/current/clean/{.codex → .agents}/skills/use-og-editor/SKILL.md +0 -0
  872. /package/templates/current/clean/{.codex → .agents}/skills/use-og-http/SKILL.md +0 -0
  873. /package/templates/current/clean/{.codex → .agents}/skills/use-og-http/agents/openai.yaml +0 -0
  874. /package/templates/current/clean/{.codex → .agents}/skills/use-og-router-tabs/SKILL.md +0 -0
  875. /package/templates/current/{examples/.codex → clean/.claude}/skills/style-og-origen-ui/SKILL.md +0 -0
  876. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-dialog/SKILL.md +0 -0
  877. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-editor/SKILL.md +0 -0
  878. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-http/SKILL.md +0 -0
  879. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-router-tabs/SKILL.md +0 -0
  880. /package/templates/current/clean/src/{features/security/components → components}/DevtoolsProtectionOverlay.vue +0 -0
  881. /package/templates/current/clean/src/{features/shell/composables → composables}/useRouteProgress.ts +0 -0
  882. /package/templates/current/clean/src/{features/workspace → views/fallback}/pages/Empty.vue +0 -0
  883. /package/templates/current/examples/{.codex → .agents}/skills/style-og-origen-ui/agents/openai.yaml +0 -0
  884. /package/templates/current/examples/{.codex → .agents}/skills/use-og-dialog/agents/openai.yaml +0 -0
  885. /package/templates/current/examples/{.codex → .agents}/skills/use-og-http/agents/openai.yaml +0 -0
  886. /package/templates/current/examples/src/{features/security/components → components}/DevtoolsProtectionOverlay.vue +0 -0
  887. /package/templates/current/examples/src/{features/shell/composables → composables}/useRouteProgress.ts +0 -0
  888. /package/templates/current/examples/src/{features/workspace → views/fallback}/pages/Empty.vue +0 -0
@@ -0,0 +1,44 @@
1
+ ---
2
+ title: 组件目录
3
+ description: 按任务场景检索 origen-ui 的公开 Vue 组件、调用参数和使用约束。
4
+ ---
5
+
6
+ # 组件目录
7
+
8
+ 本目录是 Admin 可消费公开 Vue 组件的统一清单。可按组件名、包名、场景和检索词搜索;每条记录包含公开导入入口、参数摘要、使用约束、版本状态、API 详页和示例入口。完整 API、默认值和调用细节以组件详页为准。
9
+
10
+ 组件清单范围为 Admin 直接依赖包所公开导出的 Vue 组件。runtime、locale、工具函数及其他非 UI 导出属于配套能力,按对应组件文档说明,不单独列为 UI 组件。
11
+
12
+ <!-- component-catalog:start -->
13
+
14
+ | 组件 | 场景、用途与检索词 | 包 | 公开导入入口 | 参数 / API 摘要 | 使用约束 | 状态 / 包版本 | API 与示例 |
15
+ | ----------------- | ----------------------------------------------------- | ----------------------- | ------------------------------ | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------ |
16
+ | OgTable | 数据列表、远程 CRUD、分页、排序、权限、编辑、虚拟滚动 | @origen-ui/table | @origen-ui/table | OgTableProps:rowKey(按行级能力要求)、ogColumns、ogDataSource、ogConfig | 实例身份自动管理;仅远程纯展示且无行级能力时可省略 rowKey。 | 当前 · 3.0.1 | [API](./table.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
17
+ | OgTableLocal | 本地数据、草稿行、表单明细、小规模客户端编辑 | @origen-ui/table | @origen-ui/table | OgTableLocalProps:modelValue、rowKey、ogColumns | 父组件持有行数组;本地行操作需要 rowKey;不接收远程 ogDataSource。 | 当前 · 3.0.1 | [API](./table-local.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
18
+ | OgTableWithSearch | 表格加条件搜索、查询提交、搜索失败恢复 | @origen-ui/table-search | @origen-ui/table-search | OgTableWithSearchProps:OgTable 属性及 ogConfig.search.fields | 搜索字段使用 ogControl.ogType;其余表格请求、列和样式契约见 OgTable。 | 当前 · 3.0.1 | [API](./table-with-search.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
19
+ | OgSearch | 独立查询表单、筛选字段、关键字搜索、校验与重置 | @origen-ui/search | @origen-ui/search | OgSearchProps:modelValue、ogKeyword、ogConfig、search 事件 | 应用负责持有查询状态并处理提交后的请求;自定义控件需提供有效的 ogType。 | 当前 · 3.0.1 | [API](./search.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
20
+ | OgForm | Schema 表单、字段联动、校验、只读与动态配置 | @origen-ui/form | @origen-ui/form | OgFormProps:modelValue、ogSchema、ogColumns | 应用持有业务数据、提交与请求职责;字段渲染遵循表单上下文和公开 renderer 配置。 | 当前 · 3.0.1 | [API](./form.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
21
+ | FieldRenderer | 表单字段渲染、注册 renderer、扩展字段控件 | @origen-ui/form | @origen-ui/form | `ogField`(必填)、`ogReadonly`(默认 false)、`ogA11y` 可选。 | 仅在 OgForm 上下文中使用;一般页面优先通过 schema 配置字段。 | 当前 · 3.0.1 | [API](./form.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
22
+ | OgFormItem | 表单项布局、标签、校验与插槽组合 | @origen-ui/form | @origen-ui/form | `ogName`(必填)、`ogField`、`ogReadonly`(默认 false)、`ogLabelTip`;支持 FormItem 属性。 | 仅在 OgForm 上下文中使用;`ogName` 指定字段,错误与表单状态由 OgForm 控制。 | 当前 · 3.0.1 | [API](./form.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
23
+ | OgFormTable | 表单内可编辑明细表、网格编辑、单元格 schema | @origen-ui/form-table | @origen-ui/form-table | OgFormTableProps:modelValue、ogColumns、ogConfig | 通过公开表单字段适配器接入 OgForm;编辑和提交遵循表格与表单各自的数据所有权。 | 当前 · 3.0.1 | [API](./form-table.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
24
+ | OgUpload | 受控文件值、上传进度、失败恢复与文件列表 | @origen-ui/upload | @origen-ui/upload | OgUploadPropsDocumentation:modelValue、上传配置、值编解码与事件 | 应用提供上传适配器并定义业务文件值;组件不决定业务请求地址或权限。 | 当前 · 3.0.1 | [API](./upload.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
25
+ | SvgIcon | SVG 图标、图标尺寸与颜色、应用本地资源 | @origen-ui/icons | @origen-ui/icons | SvgIconProps:图标标识、尺寸、颜色及 SVG 属性 | 图标资源按项目图标注册和构建约定提供;完整样式入口见样式与主题文档。 | 当前 · 3.0.1 | [API](./svg-icon.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
26
+ | OgEditor | 富文本编辑、媒体上传、HTML 内容处理 | @origen-ui/editor | @origen-ui/editor | OgEditorProps:受控内容、编辑能力配置、上传与事件 | 应用负责配置媒体上传适配器及业务内容边界;展示已有内容时选用 OgEditorViewer。 | 当前 · 3.0.1 | [API](./editor.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
27
+ | OgEditorViewer | 富文本只读展示、空态与媒体布局 | @origen-ui/editor | @origen-ui/editor | OgEditorViewerProps:待展示内容及查看器配置 | 只读展示使用该组件;内容安全处理按组件详页和应用内容边界配置。 | 当前 · 3.0.1 | [API](./editor-viewer.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
28
+ | OgDialog | 对话框或抽屉、确认、编辑、关闭保护 | @origen-ui/dialog | @origen-ui/dialog | OgDialogProps:受控显示、展示配置、确认与关闭回调 | 应用决定业务提交和异步操作;命令式弹窗还需安装 manager 并挂载 OgDialogHost。 | 当前 · 3.0.1 | [API](./dialog.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
29
+ | OgDialogHost | 命令式弹窗宿主、DialogManager 挂载 | @origen-ui/dialog | @origen-ui/dialog | manager 可选;默认使用应用注入的 manager。 | 在应用根级挂载;使用前安装 createOgDialog(),或显式传入 DialogManager。 | 当前 · 3.0.1 | [API](./dialog.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
30
+ | OgTabs | 工作区标签、受控导航、关闭守卫与标签操作 | @origen-ui/tabs | @origen-ui/tabs | OgTabsProps:ogItems、modelValue、ogBeforeAction、actionRequest | 父组件决定是否接受标签和激活项变更;路由工作区集成可使用 RouterTabs。 | 当前 · 3.0.1 | [API](./tabs.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
31
+ | RouterViewHost | 路由视图、动态路由组件挂载、缓存视图 | @origen-ui/router | @origen-ui/router | cacheMax 可选,默认 10;限制 KeepAlive 缓存数量。 | 依赖 Vue Router 和应用提供的 router adapter;路由数据及后端 DTO 映射由应用负责。 | 当前 · 3.0.1 | [API](./router.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
32
+ | RouterBreadcrumb | Element Plus 面包屑、当前路由导航层级 | @origen-ui/router | @origen-ui/router/element-plus | RouterBreadcrumbProps:面包屑显示和 Element Plus 属性 | 需使用 Element Plus 预设子路径;菜单和路由元数据由 router adapter 提供。 | 当前 · 3.0.1 | [API](./router.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
33
+ | RouterMenu | Element Plus 菜单、路由菜单选择与导航 | @origen-ui/router | @origen-ui/router/element-plus | RouterMenuProps:菜单显示、路由选择及 Element Plus 属性 | 需使用 Element Plus 预设子路径;应用仍负责菜单 API、授权和业务 DTO 转换。 | 当前 · 3.0.1 | [API](./router.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
34
+ | RouterTabs | 路由工作区标签、页面缓存与路由联动 | @origen-ui/router | @origen-ui/router/tabs | RouterTabsProps:标签外观和导航展示配置 | 需使用 tabs 子路径并满足其 peer dependency;应用负责路由和工作区状态策略。 | 当前 · 3.0.1 | [API](./router.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
35
+
36
+ <!-- component-catalog:end -->
37
+
38
+ ## 配套能力
39
+
40
+ @origen-ui/http、@origen-ui/permission、@origen-ui/shared、@origen-ui/admin-cli 和 origen-ui 提供请求、权限、共享类型、脚手架或聚合资源等配套能力,不作为独立 UI 组件列入上表。配套能力与 Admin 消费边界见项目根目录的 `component-catalog.v2.json` 和组件使用技能。
41
+
42
+ ## Admin 现有用法
43
+
44
+ Admin 系统管理页使用 `OgTableWithSearch`、`OgTable` 和 `OgForm` 实现列表、树形数据及编辑表单,可在 `apps/admin/src/views/system/` 下核对具体用法。
@@ -0,0 +1,452 @@
1
+ ---
2
+ title: Router 适配器
3
+ description: 面向动态路由、访问策略、工作区页签与缓存视图的 headless Vue Router 5 适配器。
4
+ ---
5
+
6
+ # Router 适配器
7
+
8
+ ## 基础用法
9
+
10
+ `@origen-ui/router` 将 Vue Router 创建、后端路由转换、访问校验、路由菜单、面包屑、工作区页签与视图缓存元数据整合在一起,不依赖应用级 store 或请求客户端。
11
+
12
+ <div id="router-workspace"></div>
13
+ ### 隔离工作区路由
14
+
15
+ 该示例使用内存历史,不影响文档站路由;通过菜单切换视图,再重置工作区观察状态回收。
16
+
17
+ ## 安装
18
+
19
+ ```bash
20
+ pnpm add @origen-ui/router vue-router
21
+
22
+ # 可选预设
23
+ pnpm add element-plus @origen-ui/tabs
24
+ ```
25
+
26
+ ## 典型用法
27
+
28
+ ## Query 单值归一化
29
+
30
+ Vue Router 会把重复的 query 参数表示为数组。应用需要把 query 值作为一个
31
+ 字符串读取时,使用根入口导出的 `getRouteQueryString`:
32
+
33
+ ```ts
34
+ import { getRouteQueryString } from '@origen-ui/router'
35
+
36
+ const redirect = getRouteQueryString(route.query.redirect)
37
+ // '/dashboard' 和 ['/dashboard'] 返回 '/dashboard'
38
+ // ['/a', '/b']、[]、null 或非字符串值返回 undefined
39
+ ```
40
+
41
+ 该 helper 只处理值形状,不会 trim、解码、修改原始 query 或执行 redirect 安全校验。
42
+ 站内路径校验仍由应用自己的 sanitizer 负责。
43
+
44
+ ## 应用初始化
45
+
46
+ 需显式引入样式。预设的 JavaScript 入口不会在运行时注入抽取出的 CSS;聚合包、按需包和暗色主题的统一接入方式见[样式与主题](../../.codex/rules/05-style.md)。
47
+
48
+ ```ts
49
+ import '@origen-ui/router/style.css'
50
+ import '@origen-ui/tabs/style.css' // 仅当渲染 RouterTabs 时需要
51
+ ```
52
+
53
+ 应用层持有静态路由、会话查找与后端 DTO 映射。后端数据提供稳定的视图 key;注册表将这些 key 解析到本地组件。
54
+
55
+ ```ts
56
+ import { createAccessPolicy, createRouterAdapter } from '@origen-ui/router'
57
+ import { createWebHistory } from 'vue-router'
58
+
59
+ const routing = createRouterAdapter({
60
+ history: createWebHistory(),
61
+ staticRoutes: [
62
+ { path: '/login', name: 'login', component: LoginPage, meta: { adapter: { public: true } } },
63
+ { path: '/403', name: '403', component: ForbiddenPage, meta: { adapter: { public: true } } },
64
+ { path: '/404', name: '404', component: NotFoundPage, meta: { adapter: { public: true } } },
65
+ ],
66
+ dynamic: {
67
+ load: ({ signal }) => api.fetchRoutes({ signal }),
68
+ transform: (routes) => routes.map(toRouteSourceNode),
69
+ resolveComponent: (key) => viewRegistry[key],
70
+ },
71
+ access: createAccessPolicy({
72
+ getSession: () => sessionStore.current(),
73
+ canAccess: (_to, session, meta) =>
74
+ (meta.permissions ?? []).every((item) => session.permissions.includes(item)),
75
+ loginRoute: { name: 'login' },
76
+ forbiddenRoute: { name: '403' },
77
+ }),
78
+ fallbacks: { notFound: { name: '404' }, error: { name: '500' } },
79
+ })
80
+
81
+ app.use(routing)
82
+ ```
83
+
84
+ ## 高级能力
85
+
86
+ ## 后端路由映射
87
+
88
+ 使用消费方自有的 DTO 转换器。不要直接导入后端返回的路径。
89
+
90
+ ```ts
91
+ function toRouteSourceNode(route: BackendRoute) {
92
+ return {
93
+ name: route.code,
94
+ path: route.path,
95
+ componentKey: route.viewKey,
96
+ meta: {
97
+ title: route.title,
98
+ permissions: route.permissions,
99
+ menu: { hidden: !route.showInMenu },
100
+ cache: route.cache ? { enabled: true, name: route.cacheName } : undefined,
101
+ },
102
+ children: route.children?.map(toRouteSourceNode),
103
+ }
104
+ }
105
+ ```
106
+
107
+ 动态叶子路由需要 `componentKey` 或重定向。无组件的分组路由会获得一个 `RouterView` 出口。动态名称不能替换静态路由保留的名称。
108
+
109
+ ## 布局预设
110
+
111
+ 基础包导出 `RouterViewHost`。Element Plus 与 OgTabs 集成为独立的入口点。
112
+
113
+ ```vue
114
+ <script setup lang="ts">
115
+ import { RouterViewHost } from '@origen-ui/router'
116
+ import { RouterBreadcrumb, RouterMenu } from '@origen-ui/router/element-plus'
117
+ import { RouterTabs } from '@origen-ui/router/tabs'
118
+ </script>
119
+
120
+ <template>
121
+ <aside><RouterMenu /></aside>
122
+ <main>
123
+ <RouterBreadcrumb />
124
+ <RouterTabs />
125
+ <RouterViewHost :cache-max="10" />
126
+ </main>
127
+ </template>
128
+ ```
129
+
130
+ 缓存视图需要与 `meta.adapter.cache.name` 匹配的稳定组件名。`RouterViewHost` 只负责
131
+ `RouterView`、深度对齐与 `KeepAlive` 渲染;缓存 include 列表和带工作区 revision 的
132
+ key 由 Router adapter 统一解析。组件不会合成匿名 `route` key,因此启用缓存的视图
133
+ 必须暴露显式组件名,或在 `meta.adapter.cache.name` 中配置名称。嵌套缓存路由必须在
134
+ 每个自定义布局中渲染 `<RouterViewHost />`;自动生成的动态分组已自动处理。工作区
135
+ 持久化为可选,应使用用户或租户特定的作用域。
136
+
137
+ `cacheMax` 必须是正整数,默认值为 `10`;零、负数、小数和非有限值会立即抛出配置错误。
138
+
139
+ ## 会话变更
140
+
141
+ 在登出或切换租户/角色后调用 `reset()`。它会中止进行中的动态加载、移除注入的路由、清空工作区页签,并可选跳转到公开路由。
142
+ `reset()` 也会使所有尚未完成的加载结果和路由重放失效,旧结果不会重新安装动态路由。
143
+
144
+ ```ts
145
+ await routing.reset({ name: 'login' })
146
+ ```
147
+
148
+ 使用 `reload(tabKey)` 强制某个工作区页面重新挂载。不传 key 时刷新当前激活页签。
149
+
150
+ ## 动态路由恢复
151
+
152
+ 当动态路由加载失败时,适配器会将原始目标记录在 `state.lastError` 中,并重定向到必需的公开错误路由。错误页可重试加载并返回原始目标;重试会等待最终导航结果,取消、404/500 fallback 或其他 Navigation Failure 都返回 `false`,正常业务重定向使用最终 route 更新工作区。显式 `replaceDynamicRoutes(source, options)` 失败后,重试复用已提供的 source 与 fallback/回放目标;省略 source 时重新调用 `dynamic.load()`。重试仍失败会保留上下文,新的 replace、`reset()`、`dispose()` 或 generation 会使旧上下文失效。
153
+
154
+ ```ts
155
+ import { useRouterAdapter } from '@origen-ui/router'
156
+
157
+ const adapter = useRouterAdapter()
158
+ const restored = await adapter.retryDynamicRoutes()
159
+ ```
160
+
161
+ ## Adapter 运行时状态
162
+
163
+ `useRouterAdapter()` 返回的 `RouterAdapterRuntime` 提供以下只读属性与方法:
164
+
165
+ | 成员 | 类型 | 说明 |
166
+ | ---------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------------- |
167
+ | `router` | `Router` | 底层 Vue Router 实例 |
168
+ | `menu` | `ComputedRef<RouteMenuItem[]>` | 当前动态路由计算出的菜单树 |
169
+ | `workspace` | `RouteWorkspace` | 工作区标签页管理(详见下方) |
170
+ | `state` | `ComputedRef<RouterAdapterState>` | 适配器运行时状态,包含 `navigation`、`dynamicRoutes` 和 `lastError` |
171
+ | `ready()` | `() => Promise<void>` | 等待动态路由首次加载完成;可在挂载布局组件前调用以确保路由就绪 |
172
+ | `retryDynamicRoutes()` | `() => Promise<boolean>` | 动态路由加载失败后重试并返回原始目标 |
173
+ | `reset()` | `(redirect?) => Promise<void>` | 登出或切换租户后重置:中止请求、移除路由、清空标签页,可选跳转 |
174
+ | `reload()` | `(key?) => Promise<void>` | 强制指定标签页(或当前标签页)重新挂载 |
175
+ | `getMeta()` | `(route) => AdapterRouteMeta` | 获取合并后的路由适配器元数据 |
176
+ | `getBreadcrumbs()` | `(route) => BreadcrumbItem[]` | 获取当前路由的面包屑项 |
177
+ | `getViewCache()` | `(route, depth) => RouterViewCache` | 解析指定 RouterView 深度的 KeepAlive include 列表和 revision-aware key;无默认组件时不返回 key |
178
+
179
+ ### RouterAdapterState
180
+
181
+ `state` 是一个 `ComputedRef`,包含以下字段:
182
+
183
+ | 字段 | 类型 | 说明 |
184
+ | --------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
185
+ | `navigation` | `'idle' \| 'navigating'` | 当前是否正在导航中 |
186
+ | `dynamicRoutes` | `'idle' \| 'loading' \| 'ready' \| 'error' \| 'degraded'` | 动态路由的加载状态;`degraded` 表示已降级为静态路由,需显式 retry 或 replace 才会恢复 |
187
+ | `lastError` | `RouterAdapterError \| undefined` | 最近一次错误,包含 `cause`、`phase`、`to`、`from`;动态恢复错误还提供 `generation`、`restored`、`recoveryCause` 和 `failure` |
188
+
189
+ ### replaceDynamicRoutes
190
+
191
+ `RouterAdapter`(继承自 `RouterAdapterRuntime`)额外暴露 `replaceDynamicRoutes`,用于在运行时替换整份动态路由(如切换租户后重新拉取):
192
+
193
+ ```ts
194
+ await routing.replaceDynamicRoutes(newSourceRoutes)
195
+ ```
196
+
197
+ 替换不承诺 Vue Router 内部 matcher 的原子交换。适配器会先完成转换、静态名称
198
+ 和路径(包括父级 alias 的子路径)冲突校验,再通过公开 `addRoute`、disposer、`removeRoute`、
199
+ `hasRoute`、`resolve` 和 `getRoutes` 完成安装与对账;失败时恢复旧路由,恢复失败则降级为静态路由。
200
+ 运行时已使用导航屏障和 generation 校验,连续替换时只有当前操作可以提交结果。只有最终导航
201
+ 有效后才会过滤不可达页签、更新标题和缓存并写入工作区;Vue Router 本身没有公开的 matcher 事务,
202
+ 因此这里承诺的是外部可观察一致性和失败恢复,而不是内部路由树原子交换。
203
+
204
+ 如果公开删除 API 仍无法清除某条动态记录,adapter 会保留 residual snapshot 供后续清理,并进入 `degraded-static`;菜单只显示静态路由,守卫会拦截仍留在 matcher 中的动态残留,即使其标记为 public。若 dispose 清理失败,原 Router 保留只拦截 residual 动态路由的 fail-closed 守卫,静态路由仍可导航;业务方必须卸载旧应用并丢弃该 Router 与 history 后重新创建。因为 dispose 不会导航,当前已经渲染的 residual 动态页面可能继续挂载到应用卸载或 RouterView 切换。
205
+
206
+ 动态源加载可通过 `dynamic.timeoutMs` 设置超时,默认值为 30 秒。超时会取消请求并保留上一份动态路由快照。
207
+ `retryDynamicRoutes()` 会校验最终导航结果:重定向到正常业务路由返回 `true`,导航失败或进入 404/500
208
+ fallback 返回 `false`,并且不会用失败结果更新工作区。
209
+
210
+ 动态转换结果不包含 `componentKey` 时可以省略 `dynamic.resolveComponent`,适配器会为分组路由创建默认
211
+ `RouterView` outlet;只要任一节点包含 `componentKey`,就必须提供 resolver,否则会在物化阶段 fail-closed 并进入错误处理链。
212
+
213
+ 完整的状态机、错误契约、恢复流程和验收矩阵见仓库文档 `docs/dynamic-route-contract.md`。
214
+
215
+ ## 工作区标签页
216
+
217
+ `useRouteWorkspace()` 是获取当前工作区状态的便捷 composable,等价于 `useRouterAdapter().workspace`。
218
+
219
+ ```ts
220
+ import { useRouteWorkspace } from '@origen-ui/router'
221
+
222
+ const workspace = useRouteWorkspace()
223
+ ```
224
+
225
+ ### RouteWorkspace 成员
226
+
227
+ | 成员 | 类型 | 说明 |
228
+ | ---------------------- | ----------------------------------------------------- | ---------------------------------------------------------- |
229
+ | `tabs` | `Ref<readonly WorkspaceTab[]>` | 当前打开的标签页列表 |
230
+ | `activeKey` | `Ref<string \| undefined>` | 当前激活标签页的 key |
231
+ | `visit()` | `(route) => void` | 记录路由访问,自动创建或激活标签页 |
232
+ | `close()` | `(key) => WorkspaceTab \| undefined` | 关闭指定标签页并返回关闭后的当前激活标签 |
233
+ | `closeMany()` | `(keys, nextActiveKey?) => WorkspaceTab \| undefined` | 一次关闭多个标签并只提交一次状态与持久化 |
234
+ | `setPinned()` | `(key, pinned) => void` | 切换标签页固定状态 |
235
+ | `replace()` | `(tabs) => void` | 替换整个标签页列表(用于从持久化恢复) |
236
+ | `replaceAndVisit()` | `(tabs, route) => void` | 必需的事务 API,一次替换标签列表并提交最终路由访问 |
237
+ | `replaceAndActivate()` | `(tabs, activeKey?) => void` | 必需的事务 API,一次替换标签列表并设置激活项,避免中间快照 |
238
+ | `clear()` | `() => void` | 清空所有标签页 |
239
+ | `refresh()` | `(key?) => void` | 强制指定标签页(或不传则当前标签页)重新挂载 |
240
+
241
+ 默认 Tab key 使用规范化后的 `route.fullPath`,因此同名参数路由会形成独立页签;需要按业务合并时可通过 `WorkspaceOptions.keyOf` 自定义。切换旧版按路由名生成的持久化数据时,请提升 `workspace.persistence.version`。
242
+
243
+ 恢复持久化数据时会校验每个页签的字段、非空 key 和 key 唯一性。发现非法或重复数据时会
244
+ 清除整个存储项并从空工作区开始,不会尝试修复部分页签。
245
+
246
+ ### WorkspaceTab 缓存链
247
+
248
+ 每个 `WorkspaceTab` 携带可选的 `cacheChain` 字段(`readonly (string | undefined)[]`):
249
+ 按路由匹配链深度记录需要缓存的组件名,未命名的 outlet 记录对应位置为 `undefined`。
250
+ `refresh()` 递增该标签页的 revision,解析出的缓存 key 只在激活路由对应的深度生效,
251
+ 使 `KeepAlive` 重新挂载该层组件。持久化 schema 的失效完全由配置的 `version` 决定:
252
+ 版本或 scope 不匹配的存量数据在恢复时整体清除;携带 schema 之外字段的标签页会被
253
+ 正常恢复,额外字段仅被忽略、不被解读。JSON 持久化恢复时会保留 `undefined` 对应的
254
+ 未命名 outlet 位置。缓存组件必须暴露显式名称或在
255
+ `meta.adapter.cache.name` 中配置(见上文)。
256
+
257
+ ## 持久化适配器
258
+
259
+ `createWebStorageAdapter` 将浏览器原生 `Storage`(`localStorage` / `sessionStorage`)包装为 `StorageAdapter` 接口,用于工作区标签页的持久化。内部自动处理 JSON 序列化与反序列化,读取失败时清除损坏数据并返回 `undefined`。
260
+
261
+ ```ts
262
+ import { createWebStorageAdapter } from '@origen-ui/router'
263
+
264
+ const storage = createWebStorageAdapter(localStorage)
265
+
266
+ // 在 workspace 配置中使用
267
+ const routing = createRouterAdapter({
268
+ // ...
269
+ workspace: {
270
+ enabled: true,
271
+ persistence: {
272
+ storage,
273
+ key: 'workspace',
274
+ version: 2,
275
+ scope: `user:${userId}`,
276
+ },
277
+ },
278
+ })
279
+ ```
280
+
281
+ ## 辅助函数
282
+
283
+ 以下函数由 `@origen-ui/router` 直接导出,可在应用层独立使用:
284
+
285
+ | 函数 | 签名 | 说明 |
286
+ | ------------------- | ----------------------------- | ----------------------------------------------------------------------------------------------- |
287
+ | `getAdapterMeta` | `(route) => AdapterRouteMeta` | 沿 `route.matched` 向上合并所有层级的 `meta.adapter`,返回完整的路由适配器元数据 |
288
+ | `createBreadcrumbs` | `(route) => BreadcrumbItem[]` | 从当前路由匹配链生成面包屑项列表,自动过滤 `breadcrumb.hidden` 的层级,最后一项不带链接 |
289
+ | `createMenu` | `(routes) => RouteMenuItem[]` | 从 Vue Router 路由记录生成菜单树,过滤 `menu.hidden` 路由,按 `menu.order` 排序,递归处理子路由 |
290
+ | `resolveActiveMenu` | `(route) => string` | 解析当前路由对应的菜单激活项:优先使用 `meta.menu.activeMenu`,否则回退为路由 `name` 或 `path` |
291
+
292
+ ```ts
293
+ import { createBreadcrumbs, createMenu, resolveActiveMenu, getAdapterMeta } from '@origen-ui/router'
294
+
295
+ // 从路由记录构建菜单
296
+ const menuItems = createMenu(router.getRoutes())
297
+
298
+ // 从当前路由生成面包屑
299
+ const crumbs = createBreadcrumbs(route)
300
+
301
+ // 解析菜单高亮项
302
+ const activeId = resolveActiveMenu(route)
303
+ ```
304
+
305
+ ## API
306
+
307
+ ### 导航决策与生命周期
308
+
309
+ `RouterPolicy.before` 返回显式的 `NavigationDecision`:
310
+
311
+ ```ts
312
+ const policy = {
313
+ name: 'feature-gate',
314
+ before: ({ to }) =>
315
+ to.name === 'reports'
316
+ ? { type: 'continue' }
317
+ : { type: 'redirect', to: { name: '403' }, replace: true },
318
+ }
319
+ ```
320
+
321
+ 使用 `{ type: 'cancel', reason }` 取消导航。`RouteTarget` 必须提供非空 `name` 或非空
322
+ `path`,不能同时提供两者;`path` 目标不能携带 `params`。策略与 fallback 的路由身份比较使用解析后的 name、path 和 params
323
+ 并忽略 query/hash;workspace 精确匹配则保留 query 与 hash。
324
+
325
+ 适配器拥有者卸载时调用 `routing.dispose()`。该方法幂等,会取消动态任务、尝试移除动态路由,
326
+ 并保留持久化工作区数据。若 Vue Router 官方 disposer 或 `removeRoute()` 清理失败,`dispose()`
327
+ 会抛出恢复错误并记录 `lastError.phase === 'dispose'`;适配器进入终态,业务方应记录错误。为防止残留动态路由被访问,清理失败时原 Router 会保留只拦截 residual snapshot 的 fail-closed 守卫,静态路由仍可导航;此时必须卸载旧应用并丢弃原 Router 与 history,重新创建二者和适配器,不能只在同一个 Router 上新建适配器。若失败来自其他 disposer 且无动态残留,守卫会移除。正常清理成功时该守卫也会移除。由于 dispose 不会导航,已经渲染的 residual 动态页面可能继续挂载到应用卸载或 RouterView 切换。dispose 后继续调用适配器操作
328
+ 会抛出明确的生命周期错误。`routing.router` 是原始 Vue Router 实例,适配器不会包装或拦截它的
329
+ `push`、`replace`、`addRoute` 和 `removeRoute`;调用方必须在 dispose 后停止通过该实例发起新的导航或路由变更。
330
+ 多个功能共享同一个 Router 时,由应用负责协调 Router 的总体生命周期。
331
+
332
+ ## 布局组件 Props
333
+
334
+ ### 官方透传类型:`RouterBreadcrumbProps`、`RouterBreadcrumbSlots`、`RouterMenuEvents`、`RouterMenuNodeEvents`、`RouterMenuNodeProps`、`RouterMenuNodePropsResolver`、`RouterMenuProps`、`RouterMenuSlots`、`RouterTabsProps`
335
+
336
+ | 组件 | 属性 | 类型 | 默认值 | 说明 |
337
+ | ------------------ | ------------------------------ | ------------------------------------------------------------------------------ | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
338
+ | `RouterViewHost` | `cacheMax` | `number` | `10` | KeepAlive 缓存的最大路由组件数量,必须为正整数。嵌套路由布局中应分别渲染该组件。 |
339
+ | `RouterMenu` | `ogResolveIcon` | `(icon: string) => Component \| undefined` | - | 将路由菜单的图标标识解析为 Vue 组件。 |
340
+ | `RouterMenu` | 顶层官方属性 / `ogMenuEvents` | `RouterMenuProps` 根属性 | - | Element Plus Menu 官方属性直接放在根层,事件使用显式桥接。 |
341
+ | `RouterMenu` | `ogNodeProps` / `ogNodeEvents` | `RouterMenuNodeProps` / `RouterMenuNodeEvents` | - | 递归 SubMenu/MenuItem 的官方属性和事件,参考 Element Plus 官方文档;支持静态对象或按菜单节点返回对象。 |
342
+ | `RouterTabs` | `ogFeatures` | `OgTabsFeatures` | `{ close: true, pin: true, drag: true }` | 覆盖路由工作区标签页的功能开关。`add` 只有在同时提供 `ogAddTab` 时才显示;右键菜单由组件单独启用。 |
343
+ | `RouterTabs` | `ogLocale` | `RouterTabsProps['ogLocale']` | `undefined` | 覆盖工作区标签页的本地化文案。 |
344
+ | `RouterTabs` | `ogAddTab` | `(context) => WorkspaceTab \| undefined \| Promise<WorkspaceTab \| undefined>` | - | 与 `ogFeatures.add: true` 配合使用。回调返回的工作区页签必须使用唯一 key;导航成功后 RouterTabs 写入 workspace 并激活该路由。 |
345
+ | `RouterBreadcrumb` | 顶层官方属性 | `RouterBreadcrumbProps` 根属性 | - | Element Plus Breadcrumb 官方属性直接放在根层。 |
346
+ | `RouterMenu` | `default` 插槽 | `RouterMenuSlots['default']` | - | 提供时替换按路由生成的菜单节点;插槽内容直接作为 Element Plus Menu 子节点渲染。 |
347
+ | `RouterBreadcrumb` | `default` 插槽 | `RouterBreadcrumbSlots['default']` | - | 提供时替换按路由生成的面包屑项;插槽内容直接作为 Element Plus Breadcrumb 子节点渲染。 |
348
+
349
+ `RouterTabs` 不接受 `modelValue` 作为外部受控值。活动标签由路由工作区状态决定,应用应通过路由与工作区适配器管理它,而不是传入 `modelValue`。
350
+
351
+ `RouterViewHost` 从 `@origen-ui/router` 导入,`RouterMenu` 和 `RouterBreadcrumb` 从 `@origen-ui/router/element-plus` 导入,`RouterTabs` 从 `@origen-ui/router/tabs` 导入。它们依赖同一 `createRouterAdapter()` 上下文,不能脱离 Adapter 单独使用。
352
+
353
+ `RouterMenu` 的 Element Plus Menu 官方属性直接放在组件根层;`ogResolveIcon` 解析菜单图标,`ogMenuEvents` 桥接 Menu / MenuItem 事件,`ogNodeProps` / `ogNodeEvents` 负责递归节点级 SubMenu/MenuItem 配置。`RouterBreadcrumb` 的 Element Plus Breadcrumb 官方属性也直接放在根层;它没有额外的业务事件配置。以上原生属性和节点属性类型均以 Element Plus 官方文档为准。
354
+
355
+ `RouterMenu` 与 `RouterBreadcrumb` 的 `default` 插槽是完整替换点,不会把自动生成的路由节点与自定义节点混合。插槽不接收参数;需要路由树数据时可通过 `useRouteMenu()` 或 `useBreadcrumbs()` 读取适配器状态。
356
+
357
+ 当顶层 `router` 属性为 `true` 时,组件使用 Element Plus Menu 的官方路由模式,并将生成的菜单项索引解析为路由路径;适配器不会再次执行同一导航。
358
+
359
+ ## 组合式函数(Composables)
360
+
361
+ | Composable | 返回值 | 说明 |
362
+ | ------------------- | ------------------------------- | ---------------------------- |
363
+ | `useRouterAdapter` | `RouterAdapterRuntime` | 获取适配器运行时实例 |
364
+ | `useRouteMenu` | `ComputedRef<RouteMenuItem[]>` | 当前路由菜单树的便捷访问 |
365
+ | `useBreadcrumbs` | `ComputedRef<BreadcrumbItem[]>` | 当前路由面包屑列表(响应式) |
366
+ | `useRouteWorkspace` | `RouteWorkspace` | 当前工作区标签页管理 |
367
+
368
+ ## 子路径入口
369
+
370
+ `@origen-ui/router` 提供以下子路径入口,均为可选预设:
371
+
372
+ | 入口 | 说明 |
373
+ | -------------------------------- | -------------------------------------------------------------- |
374
+ | `@origen-ui/router` | 核心包:适配器、composables、辅助函数 |
375
+ | `@origen-ui/router/element-plus` | Element Plus 预设:`RouterBreadcrumb`、`RouterMenu` 等布局组件 |
376
+ | `@origen-ui/router/tabs` | OgTabs 预设:`RouterTabs` 工作区标签页组件 |
377
+ | `@origen-ui/router/style.css` | 核心样式 |
378
+
379
+ ## 根入口公开导出
380
+
381
+ 除 `RouterViewHost` 外,`@origen-ui/router` 根入口导出以下工厂、组合式函数和辅助函数:
382
+
383
+ | 分类 | 导出 |
384
+ | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
385
+ | 工厂 | `createRouterAdapter`、`createAccessPolicy`、`createWebStorageAdapter` |
386
+ | Composables | `useRouterAdapter`、`useRouteMenu`、`useBreadcrumbs`、`useRouteWorkspace` |
387
+ | selectors/meta | `createBreadcrumbs`、`createMenu`、`resolveActiveMenu`、`getAdapterMeta`、`isUnmatchedRoute`、`getRouteQueryString`、`matchesWorkspaceRoute` |
388
+ | route targets/runtime | `matchesRoute`、`normalizeRouteTarget`、`routeTargetFromRoute`、`RouteTarget`、`NamedRouteTarget`、`PathRouteTarget`、`createRouteTreeIndex`、`RouteTreeError`、`RouteTreeIndex`、`RouteTreeIndexNode`、`DynamicRouteManager`、`DynamicRouteLoadTimeoutError`、`DynamicRouteApplied`、`DynamicRouteAppliedValue`、`DynamicRouteFailed`、`DynamicRouteLoadOutcome`、`DynamicRouteLoadOperationResult`、`DynamicRouteOperationResult`、`DynamicRouteSkipped`、`DynamicRouteStatus`、`DynamicRouteSuperseded`、`DynamicRouteReplacementError`、`DynamicRouteReplacementTransaction`、`DynamicRouteReplacementResult`、`DynamicRouteReplacementTransactionOptions`、`DynamicRouteSnapshot`、`navigateAndValidateRoute`、`RouteTabActionExecutor`、`RouteWorkspaceNavigationRecoveryError`、`RouteNavigationValidatorOptions`、`CancelNavigationDecision`、`ContinueNavigationDecision`、`NavigationDecision`、`RedirectNavigationDecision`、`RouterPolicyResult`、`DynamicRouteFailure`、`DynamicRouteFailurePhase`、`ROUTER_WORKSPACE_SCHEMA_VERSION` |
389
+ | 组件 | `RouterViewHost`(Element Plus/Tabs 布局组件见子路径入口) |
390
+ | 路由与适配器配置 | `AccessPolicyOptions`、`AdapterBreadcrumbMeta`、`AdapterCacheMeta`、`AdapterMenuMeta`、`AdapterRouteMeta`、`AdapterTabMeta`、`DynamicRouteOptions`、`DynamicRouteReplacementOptions`、`DynamicRouterAdapterOptions`、`DynamicRouterFallbacks`、`StaticRouterAdapterOptions`、`RouterAdapterOptions` |
391
+ | 运行时与导航 | `NavigationContext`、`RouteSourceNode`、`RouterAdapter`、`RouterAdapterError`、`RouterAdapterRuntime`、`RouterAdapterState`、`RouterFallbacks`、`RouterPolicy`、`RouterViewCache` |
392
+ | 菜单与工作区 | `BreadcrumbItem`、`RouteMenuItem`、`RouteWorkspace`、`StorageAdapter`、`WorkspaceOptions`、`WorkspacePersistenceOptions`、`WorkspaceTab` |
393
+
394
+ 核心类型包括 `AccessPolicyOptions`、`AdapterBreadcrumbMeta`、`AdapterCacheMeta`、`AdapterMenuMeta`、`AdapterRouteMeta`、`AdapterTabMeta`、`BreadcrumbItem`、`DynamicRouteOptions`、`DynamicRouteReplacementOptions`、`DynamicRouterAdapterOptions`、`DynamicRouterFallbacks`、`NavigationContext`、`RouteMenuItem`、`RouteSourceNode`、`RouteWorkspace`、`RouterAdapter`、`RouterAdapterError`、`RouterAdapterOptions`、`RouterAdapterRuntime`、`RouterAdapterState`、`RouterFallbacks`、`RouterPolicy`、`RouterViewCache`、`StaticRouterAdapterOptions`、`StorageAdapter`、`WorkspaceOptions`、`WorkspacePersistenceOptions` 和 `WorkspaceTab`。字段级说明以初始化、动态路由、工作区和持久化章节为准。
395
+
396
+ 动态路由结果类型包括 `DynamicRouteOperationResult`(`committed-new`、`restored-previous`、`degraded-static`、`superseded`、`disposed`)、`DynamicRouteReplacementResult`、`DynamicRouteFailure`、`DynamicRouteLoadTimeoutError`、`DynamicRouteLoadOperationResult`、`DynamicRouteLoadOutcome` 和 `DynamicRouteStatus`;策略与导航类型包括 `RouteTarget`、`NavigationDecision` 及其 continue/cancel/redirect 变体。
397
+
398
+ ### 布局透传类型:`RouterBreadcrumbProps`、`RouterBreadcrumbSlots`、`RouterMenuEvents`、`RouterMenuNodeEvents`、`RouterMenuNodeProps`、`RouterMenuNodePropsResolver`、`RouterMenuProps`、`RouterMenuSlots`
399
+
400
+ ## 相关组合示例
401
+
402
+ 工作区页签和路由恢复的运行时组合见[工作区与路由示例](../../.agents/skills/admin-component-usage/references/component-directory.md);页面级表格与搜索组合见 [OgTableWithSearch](./table-with-search.md)。
403
+
404
+ <!-- component-contract:start -->
405
+
406
+ ## 公共契约
407
+
408
+ > 由组件目录生成;每条记录对应可公开导入的组件及其消费者 API 摘要。
409
+
410
+ ### Imports
411
+
412
+ - `router-view-host`: `import { RouterViewHost } from '@origen-ui/router'`
413
+ - `router-breadcrumb`: `import { RouterBreadcrumb } from '@origen-ui/router/element-plus'`
414
+ - `router-menu`: `import { RouterMenu } from '@origen-ui/router/element-plus'`
415
+ - `router-tabs`: `import { RouterTabs } from '@origen-ui/router/tabs'`
416
+
417
+ ### Props
418
+
419
+ - `router-view-host`: `cacheMax`
420
+ - `router-breadcrumb`: 无
421
+ - `router-menu`: `ogResolveIcon`, `ogMenuEvents`, `ogNodeProps`, `ogNodeEvents`
422
+ - `router-tabs`: `ogFeatures`, `ogLocale`, `ogAddTab`
423
+
424
+ ### Events
425
+
426
+ - `router-view-host`: 无
427
+ - `router-breadcrumb`: 无
428
+ - `router-menu`: 无
429
+ - `router-tabs`: 无
430
+
431
+ ### Slots
432
+
433
+ - `router-view-host`: 无
434
+ - `router-breadcrumb`: `default`
435
+ - `router-menu`: `default`
436
+ - `router-tabs`: 无
437
+
438
+ ### Exposes
439
+
440
+ - `router-view-host`: 无
441
+ - `router-breadcrumb`: 无
442
+ - `router-menu`: 无
443
+ - `router-tabs`: 无
444
+
445
+ ### Types
446
+
447
+ - `router-view-host`:属性类型:由公开 Vue 组件推断,未单独导出属性类型;公开方法类型:无
448
+ - `router-breadcrumb`:属性类型:`RouterBreadcrumbProps`;公开方法类型:无
449
+ - `router-menu`:属性类型:`RouterMenuProps`;公开方法类型:无
450
+ - `router-tabs`:属性类型:`RouterTabsProps`;公开方法类型:无
451
+
452
+ <!-- component-contract:end -->