@origen-ui/admin-cli 2.0.1 → 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 (892) hide show
  1. package/README.md +50 -11
  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 +28 -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/.node-version +1 -0
  65. package/templates/current/clean/.prettierignore +17 -0
  66. package/templates/current/clean/.prettierrc +8 -0
  67. package/templates/current/clean/.qoder/rules/01-feature-architecture.md +3 -4
  68. package/templates/current/clean/.qoder/rules/02-vue-typescript.md +1 -2
  69. package/templates/current/clean/.qoder/rules/03-component-policy.md +5 -3
  70. package/templates/current/clean/.qoder/rules/04-api-auth-router.md +1 -2
  71. package/templates/current/clean/.qoder/rules/05-style.md +1 -2
  72. package/templates/current/clean/.qoder/rules/06-quality.md +1 -2
  73. package/templates/current/clean/.qoder/skills/admin-component-usage/SKILL.md +28 -0
  74. package/templates/current/clean/.qoder/skills/admin-component-usage/references/component-directory.md +270 -0
  75. package/templates/current/clean/.qoder/skills/build-admin-feature/SKILL.md +11 -5
  76. package/templates/current/clean/.qoder/skills/build-admin-feature/references/component-selection.md +38 -0
  77. package/templates/current/clean/.qoder/skills/use-og-form/SKILL.md +1 -1
  78. package/templates/current/clean/.qoder/skills/use-og-form-table/SKILL.md +4 -3
  79. package/templates/current/clean/.qoder/skills/use-og-search/SKILL.md +3 -3
  80. package/templates/current/clean/.qoder/skills/use-og-table/SKILL.md +16 -10
  81. package/templates/current/clean/.qoder/skills/use-og-upload/SKILL.md +6 -5
  82. package/templates/current/clean/.zcode/skills/admin-component-usage/SKILL.md +28 -0
  83. package/templates/current/clean/.zcode/skills/admin-component-usage/references/component-directory.md +270 -0
  84. package/templates/current/clean/.zcode/skills/build-admin-feature/SKILL.md +20 -0
  85. package/templates/current/clean/.zcode/skills/build-admin-feature/references/component-selection.md +38 -0
  86. package/templates/current/clean/.zcode/skills/style-og-origen-ui/SKILL.md +11 -0
  87. package/templates/current/clean/.zcode/skills/use-og-dialog/SKILL.md +12 -0
  88. package/templates/current/clean/.zcode/skills/use-og-editor/SKILL.md +25 -0
  89. package/templates/current/clean/.zcode/skills/use-og-form/SKILL.md +12 -0
  90. package/templates/current/clean/.zcode/skills/use-og-form-table/SKILL.md +26 -0
  91. package/templates/current/clean/.zcode/skills/use-og-http/SKILL.md +13 -0
  92. package/templates/current/clean/.zcode/skills/use-og-router-tabs/SKILL.md +11 -0
  93. package/templates/current/clean/.zcode/skills/use-og-search/SKILL.md +14 -0
  94. package/templates/current/clean/.zcode/skills/use-og-table/SKILL.md +22 -0
  95. package/templates/current/clean/.zcode/skills/use-og-upload/SKILL.md +26 -0
  96. package/templates/current/clean/AGENTS.md +55 -9
  97. package/templates/current/clean/CHANGELOG.md +129 -0
  98. package/templates/current/clean/CLAUDE.md +3 -0
  99. package/templates/current/clean/README.md +58 -87
  100. package/templates/current/clean/component-catalog.json +766 -348
  101. package/templates/current/clean/component-catalog.v2.json +2040 -0
  102. package/templates/current/clean/docs/components/dialog.md +405 -0
  103. package/templates/current/clean/docs/components/editor-viewer.md +87 -0
  104. package/templates/current/clean/docs/components/editor.md +275 -0
  105. package/templates/current/clean/docs/components/form-table.md +222 -0
  106. package/templates/current/clean/docs/components/form.md +750 -0
  107. package/templates/current/clean/docs/components/index.md +44 -0
  108. package/templates/current/clean/docs/components/router.md +452 -0
  109. package/templates/current/clean/docs/components/search.md +1205 -0
  110. package/templates/current/clean/docs/components/svg-icon.md +124 -0
  111. package/templates/current/clean/docs/components/table-local.md +176 -0
  112. package/templates/current/clean/docs/components/table-with-search.md +207 -0
  113. package/templates/current/clean/docs/components/table.md +813 -0
  114. package/templates/current/clean/docs/components/tabs.md +440 -0
  115. package/templates/current/clean/docs/components/upload.md +349 -0
  116. package/templates/current/clean/eslint.config.js +89 -0
  117. package/templates/current/clean/index.html +1 -1
  118. package/templates/current/clean/openapi.json +10048 -999
  119. package/templates/current/clean/package.json +51 -39
  120. package/templates/current/clean/playwright.config.ts +20 -6
  121. package/templates/current/clean/playwright.mock.config.ts +42 -0
  122. package/templates/current/clean/pnpm-workspace.yaml +34 -0
  123. package/templates/current/clean/recipes/remote-crud-dialog-form.vue +15 -13
  124. package/templates/current/clean/scaffold.lock.json +164 -4
  125. package/templates/current/clean/scripts/api-codegen.config.ts +35 -0
  126. package/templates/current/clean/scripts/api-codegen.ts +2015 -0
  127. package/templates/current/clean/scripts/api-templates/http-client.ejs +359 -0
  128. package/templates/current/clean/scripts/check-admin-scaffold.mjs +316 -18
  129. package/templates/current/clean/scripts/generate-api.ts +290 -85
  130. package/templates/current/clean/scripts/lib/admin-component-catalog.mjs +515 -0
  131. package/templates/current/clean/scripts/lib/repository-root.mjs +9 -0
  132. package/templates/current/clean/scripts/mock-api.ts +1356 -0
  133. package/templates/current/clean/scripts/remove-examples.mjs +10 -35
  134. package/templates/current/clean/src/App.vue +9 -18
  135. package/templates/current/clean/src/api/generated/data-contracts.ts +23 -265
  136. package/templates/current/clean/src/api/generated/http-client.ts +351 -180
  137. package/templates/current/clean/src/api/generated/index.ts +22 -0
  138. package/templates/current/clean/src/api/generated/services/auth.ts +123 -0
  139. package/templates/current/clean/src/api/generated/services/common/files.ts +111 -0
  140. package/templates/current/clean/src/api/generated/services/monitor/cache.ts +164 -0
  141. package/templates/current/clean/src/api/generated/services/monitor/job.ts +195 -0
  142. package/templates/current/clean/src/api/generated/services/monitor/jobLog.ts +126 -0
  143. package/templates/current/clean/src/api/generated/services/monitor/logininfor.ts +126 -0
  144. package/templates/current/clean/src/api/generated/services/monitor/online.ts +66 -0
  145. package/templates/current/clean/src/api/generated/services/monitor/operlog.ts +106 -0
  146. package/templates/current/clean/src/api/generated/services/monitor/server.ts +41 -0
  147. package/templates/current/clean/src/api/generated/services/system/configs.ts +190 -0
  148. package/templates/current/clean/src/api/generated/services/system/departments.ts +173 -0
  149. package/templates/current/clean/src/api/generated/services/system/dictionaries/data.ts +169 -0
  150. package/templates/current/clean/src/api/generated/services/system/dictionaries/types.ts +187 -0
  151. package/templates/current/clean/src/api/generated/services/system/index.ts +158 -0
  152. package/templates/current/clean/src/api/generated/services/system/menus.ts +193 -0
  153. package/templates/current/clean/src/api/generated/services/system/notices.ts +221 -0
  154. package/templates/current/clean/src/api/generated/services/system/posts.ts +168 -0
  155. package/templates/current/clean/src/api/generated/services/system/roles.ts +354 -0
  156. package/templates/current/clean/src/api/generated/services/system/users.ts +425 -0
  157. package/templates/current/clean/src/api/generated/services/tool/code-generator.ts +304 -0
  158. package/templates/current/clean/src/api/generated/types/auth.types.ts +132 -0
  159. package/templates/current/clean/src/api/generated/types/common/files.types.ts +57 -0
  160. package/templates/current/clean/src/api/generated/types/common.ts +174 -0
  161. package/templates/current/clean/src/api/generated/types/enum-dict.ts +94 -0
  162. package/templates/current/clean/src/api/generated/types/enums.ts +155 -0
  163. package/templates/current/clean/src/api/generated/types/monitor/cache.types.ts +149 -0
  164. package/templates/current/clean/src/api/generated/types/monitor/job.types.ts +207 -0
  165. package/templates/current/clean/src/api/generated/types/monitor/jobLog.types.ts +134 -0
  166. package/templates/current/clean/src/api/generated/types/monitor/logininfor.types.ts +135 -0
  167. package/templates/current/clean/src/api/generated/types/monitor/online.types.ts +80 -0
  168. package/templates/current/clean/src/api/generated/types/monitor/operlog.types.ts +126 -0
  169. package/templates/current/clean/src/api/generated/types/monitor/server.types.ts +205 -0
  170. package/templates/current/clean/src/api/generated/types/system/configs.types.ts +200 -0
  171. package/templates/current/clean/src/api/generated/types/system/departments.types.ts +145 -0
  172. package/templates/current/clean/src/api/generated/types/system/dictionaries/data.types.ts +210 -0
  173. package/templates/current/clean/src/api/generated/types/system/dictionaries/types.types.ts +221 -0
  174. package/templates/current/clean/src/api/generated/types/system/index.types.ts +19 -0
  175. package/templates/current/clean/src/api/generated/types/system/menus.types.ts +234 -0
  176. package/templates/current/clean/src/api/generated/types/system/notices.types.ts +270 -0
  177. package/templates/current/clean/src/api/generated/types/system/posts.types.ts +198 -0
  178. package/templates/current/clean/src/api/generated/types/system/roles.types.ts +410 -0
  179. package/templates/current/clean/src/api/generated/types/system/users.types.ts +413 -0
  180. package/templates/current/clean/src/api/generated/types/tool/code-generator.types.ts +388 -0
  181. package/templates/current/clean/src/api/index.ts +44 -39
  182. package/templates/current/clean/src/app/__tests__/api-generated.types.ts +24 -0
  183. package/templates/current/clean/src/app/api.ts +6 -0
  184. package/templates/current/clean/src/app/authorization/permission.ts +9 -0
  185. package/templates/current/{examples/src/app → clean/src/app/config}/runtimeConfig.ts +44 -12
  186. package/templates/current/clean/src/app/errors/errorMessage.ts +80 -0
  187. package/templates/current/clean/src/app/http/client.ts +141 -0
  188. package/templates/current/clean/src/app/http/http-adapter.ts +71 -0
  189. package/templates/current/{examples/src/app → clean/src/app/i18n}/adminLocale.ts +25 -19
  190. package/templates/current/clean/src/app/{localeFormat.ts → i18n/localeFormat.ts} +29 -6
  191. package/templates/current/clean/src/app/i18n/origenUiLocale.ts +15 -0
  192. package/templates/current/clean/src/app/menu/menu.ts +175 -0
  193. package/templates/current/clean/src/app/menu/menuTypes.ts +20 -0
  194. package/templates/current/clean/src/{features → app}/security/devtoolsProtection.ts +8 -7
  195. package/templates/current/clean/src/app/ui/createAdminUi.ts +31 -0
  196. package/templates/current/clean/src/app/ui/iconCatalog.ts +71 -0
  197. package/templates/current/clean/src/assets/icons/appearance.svg +1 -0
  198. package/templates/current/clean/src/assets/icons/arrow-right.svg +1 -0
  199. package/templates/current/clean/src/assets/icons/check.svg +1 -0
  200. package/templates/current/clean/src/assets/icons/circle-check.svg +1 -0
  201. package/templates/current/clean/src/assets/icons/default.svg +4 -0
  202. package/templates/current/clean/src/assets/icons/directory/setting.svg +1 -0
  203. package/templates/current/clean/src/assets/icons/expand.svg +1 -0
  204. package/templates/current/clean/src/assets/icons/fold.svg +1 -0
  205. package/templates/current/clean/src/assets/icons/key.svg +1 -0
  206. package/templates/current/clean/src/assets/icons/lock.svg +1 -0
  207. package/templates/current/clean/src/assets/icons/monitor.svg +1 -0
  208. package/templates/current/clean/src/assets/icons/moon.svg +11 -0
  209. package/templates/current/clean/src/assets/icons/page/department.svg +1 -0
  210. package/templates/current/clean/src/assets/icons/page/dictionary.svg +1 -0
  211. package/templates/current/clean/src/assets/icons/page/menus.svg +1 -0
  212. package/templates/current/clean/src/assets/icons/page/user.svg +1 -0
  213. package/templates/current/clean/src/assets/icons/page/users.svg +1 -0
  214. package/templates/current/clean/src/assets/icons/plus.svg +1 -0
  215. package/templates/current/clean/src/assets/icons/profile.svg +1 -0
  216. package/templates/current/clean/src/assets/icons/refresh.svg +1 -0
  217. package/templates/current/clean/src/assets/icons/roles.svg +1 -0
  218. package/templates/current/clean/src/assets/icons/search.svg +1 -0
  219. package/templates/current/clean/src/assets/icons/sunny.svg +1 -0
  220. package/templates/current/clean/src/assets/icons/system.svg +1 -0
  221. package/templates/current/clean/src/assets/icons/theme-auto.svg +14 -0
  222. package/templates/current/clean/src/assets/icons/tune.svg +13 -0
  223. package/templates/current/clean/src/{features/shell/components → components}/RouteProgress.vue +2 -2
  224. package/templates/current/{examples/src/features/system/access → clean/src}/composables/useAuthorizationRefresh.ts +6 -1
  225. package/templates/current/clean/src/composables/useSystemTableSearchVisibility.ts +33 -0
  226. package/templates/current/clean/src/{features/appearance/composables → composables}/useTheme.ts +1 -1
  227. package/templates/current/clean/src/env.d.ts +6 -19
  228. package/templates/current/clean/src/layouts/AdminLayout.vue +7 -9
  229. package/templates/current/clean/src/{features/shell/components → layouts}/AdminWatermark.vue +2 -2
  230. package/templates/current/clean/src/layouts/BreadcrumbBar.vue +9 -1
  231. package/templates/current/clean/src/layouts/SideMenu.vue +7 -15
  232. package/templates/current/clean/src/{features/appearance/components → layouts}/ThemePanel.vue +39 -11
  233. package/templates/current/clean/src/layouts/TopBar.vue +60 -28
  234. package/templates/current/clean/src/layouts/WorkspaceTabs.vue +10 -1
  235. package/templates/current/clean/src/layouts/topBarMenuSearch.ts +25 -4
  236. package/templates/current/clean/src/locales/en-US.json +227 -219
  237. package/templates/current/clean/src/locales/index.ts +72 -32
  238. package/templates/current/clean/src/locales/messages-types.ts +15 -10
  239. package/templates/current/clean/src/locales/vue-i18n.d.ts +1 -1
  240. package/templates/current/clean/src/locales/zh-CN.json +226 -218
  241. package/templates/current/clean/src/locales/zh-TW.json +222 -214
  242. package/templates/current/clean/src/main.ts +59 -30
  243. package/templates/current/clean/src/router/bootstrap.ts +69 -24
  244. package/templates/current/clean/src/router/dynamic/componentLoader.ts +150 -0
  245. package/templates/current/clean/src/router/{dynamicMenuRefresh.ts → dynamic/dynamicMenuRefresh.ts} +6 -2
  246. package/templates/current/clean/src/router/dynamic/dynamicRoutes.ts +247 -0
  247. package/templates/current/clean/src/router/navigation/guards.ts +12 -0
  248. package/templates/current/clean/src/router/navigation/paths.ts +28 -0
  249. package/templates/current/clean/src/router/navigation/staticRoutes.ts +109 -0
  250. package/templates/current/clean/src/router/{queryEncryption.ts → query/queryEncryption.ts} +29 -12
  251. package/templates/current/clean/src/router/query/routeQuery.ts +29 -0
  252. package/templates/current/clean/src/router/{useRouteQueryDefaults.ts → query/useRouteQueryDefaults.ts} +9 -8
  253. package/templates/current/clean/src/router/query/useRouteQueryDefaults.types.ts +28 -0
  254. package/templates/current/clean/src/router/{runtimeErrorRecovery.ts → recovery/runtimeErrorRecovery.ts} +21 -3
  255. package/templates/current/clean/src/{features/auth/store → store}/auth.ts +96 -61
  256. package/templates/current/clean/src/store/dictionaries.ts +86 -0
  257. package/templates/current/clean/src/{features/shell/store → store}/sidebar.ts +9 -2
  258. package/templates/current/{examples/src/features/appearance → clean/src}/store/theme.ts +8 -4
  259. package/templates/current/clean/src/styles/layout.css +51 -0
  260. package/templates/current/clean/src/templates/og-form.ts +7 -2
  261. package/templates/current/clean/src/templates/og-table.ts +88 -20
  262. package/templates/current/clean/src/templates/router.ts +11 -2
  263. package/templates/current/clean/src/utils/color-mix.ts +6 -2
  264. package/templates/current/clean/src/utils/download.ts +11 -0
  265. package/templates/current/clean/src/utils/permissions.ts +1 -1
  266. package/templates/current/clean/src/utils/retryableDialog.ts +46 -0
  267. package/templates/current/clean/src/{features → views}/errors/pages/Forbidden.vue +6 -2
  268. package/templates/current/clean/src/views/errors/pages/MethodNotAllowed.vue +34 -0
  269. package/templates/current/clean/src/{features → views}/errors/pages/NotFound.vue +6 -2
  270. package/templates/current/clean/src/{features → views}/errors/pages/ServerError.vue +6 -2
  271. package/templates/current/clean/src/{features/auth/pages/Login.vue → views/login/pages/index.vue} +101 -11
  272. package/templates/current/clean/src/views/system/access/services/admin-repository.ts +489 -0
  273. package/templates/current/clean/src/views/system/access/services/rbac.ts +317 -0
  274. package/templates/current/clean/src/views/system/dept/components/DepartmentEditorForm.vue +87 -0
  275. package/templates/current/clean/src/views/system/dept/composables/useDepartmentManagement.ts +314 -0
  276. package/templates/current/clean/src/views/system/dept/pages/index.vue +44 -0
  277. package/templates/current/clean/src/views/system/dept/services/departments.ts +168 -0
  278. package/templates/current/clean/src/views/system/dict/components/DictionaryDataEditorForm.vue +98 -0
  279. package/templates/current/clean/src/views/system/dict/components/DictionaryDataPreview.vue +233 -0
  280. package/templates/current/clean/src/views/system/dict/components/DictionaryTypeEditorForm.vue +66 -0
  281. package/templates/current/clean/src/views/system/dict/composables/useDictionaryDataManagement.ts +406 -0
  282. package/templates/current/clean/src/views/system/dict/composables/useDictionaryTypeManagement.ts +329 -0
  283. package/templates/current/clean/src/views/system/dict/data/pages/index.vue +134 -0
  284. package/templates/current/clean/src/views/system/dict/pages/index.vue +113 -0
  285. package/templates/current/clean/src/views/system/dict/services/dictionaries.ts +239 -0
  286. package/templates/current/clean/src/views/system/menu/components/MenuEditorForm.vue +252 -0
  287. package/templates/current/clean/src/views/system/menu/composables/useMenuManagement.ts +357 -0
  288. package/templates/current/clean/src/views/system/menu/menuDraft.ts +45 -0
  289. package/templates/current/clean/src/views/system/menu/pages/ExternalLink.vue +37 -0
  290. package/templates/current/clean/src/views/system/menu/pages/index.vue +75 -0
  291. package/templates/current/clean/src/views/system/post/components/PostEditorForm.vue +69 -0
  292. package/templates/current/clean/src/views/system/post/composables/usePostManagement.ts +245 -0
  293. package/templates/current/clean/src/views/system/post/pages/index.vue +92 -0
  294. package/templates/current/clean/src/views/system/post/services/posts.ts +100 -0
  295. package/templates/current/clean/src/views/system/role/auth-users/pages/index.vue +100 -0
  296. package/templates/current/clean/src/views/system/role/components/RoleDataScopeForm.vue +167 -0
  297. package/templates/current/clean/src/views/system/role/components/RoleEditorForm.vue +165 -0
  298. package/templates/current/clean/src/views/system/role/components/RoleUserSelectForm.vue +129 -0
  299. package/templates/current/clean/src/views/system/role/composables/useRoleManagement.ts +422 -0
  300. package/templates/current/clean/src/views/system/role/composables/useRoleUserManagement.ts +233 -0
  301. package/templates/current/clean/src/views/system/role/pages/index.vue +110 -0
  302. package/templates/current/clean/src/views/system/role/services/roleAccess.ts +162 -0
  303. package/templates/current/clean/src/views/system/user/auth-roles/pages/index.vue +209 -0
  304. package/templates/current/clean/src/views/system/user/components/UserDetailsForm.vue +108 -0
  305. package/templates/current/clean/src/views/system/user/components/UserEditorForm.vue +207 -0
  306. package/templates/current/clean/src/views/system/user/components/UserImportDialog.vue +80 -0
  307. package/templates/current/clean/src/views/system/user/components/UserResetPasswordForm.vue +56 -0
  308. package/templates/current/clean/src/views/system/user/composables/useUserManagement.ts +502 -0
  309. package/templates/current/clean/src/views/system/user/pages/index.vue +459 -0
  310. package/templates/current/clean/tests/e2e/admin-access-business.spec.ts +33 -0
  311. package/templates/current/clean/tests/e2e/admin-shell.spec.ts +50 -0
  312. package/templates/current/clean/tests/e2e/fixtures/adminMockBackend.ts +95 -0
  313. package/templates/current/clean/tests/e2e/fixtures/labelGeometry.ts +52 -0
  314. package/templates/current/clean/tests/e2e/mock-api-generation.spec.ts +27 -0
  315. package/templates/current/clean/tests/e2e/mock-business.spec.ts +555 -0
  316. package/templates/current/clean/tests/e2e/mock-menu-retry-form-label.spec.ts +100 -0
  317. package/templates/current/clean/tests/e2e/mock-shell.spec.ts +25 -0
  318. package/templates/current/clean/tests/e2e/mock-tree-selection-layout.spec.ts +113 -0
  319. package/templates/current/clean/tests/unit/api/api-codegen.spec.ts +893 -0
  320. package/templates/current/clean/tests/unit/api/client.spec.ts +145 -0
  321. package/templates/current/clean/tests/unit/api/generated-http-client.spec.ts +290 -0
  322. package/templates/current/{examples/src → clean/tests/unit}/api/http-adapter.spec.ts +3 -3
  323. package/templates/current/clean/tests/unit/api/system-apis.spec.ts +118 -0
  324. package/templates/current/clean/tests/unit/app/createAdminUi.spec.ts +79 -0
  325. package/templates/current/clean/{src → tests/unit}/app/errorMessage.spec.ts +1 -1
  326. package/templates/current/clean/tests/unit/app/iconCatalog.spec.ts +12 -0
  327. package/templates/current/clean/tests/unit/app/menu.spec.ts +215 -0
  328. package/templates/current/{examples/src → clean/tests/unit}/app/origenUiLocale.spec.ts +1 -1
  329. package/templates/current/{examples/src → clean/tests/unit}/app/permission.spec.ts +4 -5
  330. package/templates/current/clean/tests/unit/app/runtimeConfig.spec.ts +36 -0
  331. package/templates/current/{examples/src/features → clean/tests/unit/app}/security/devtoolsProtection.spec.ts +17 -7
  332. package/templates/current/{examples/src/features/shell → clean/tests/unit}/composables/useRouteProgress.spec.ts +1 -1
  333. package/templates/current/{examples/src/features/shell/components → clean/tests/unit/layouts}/AdminWatermark.spec.ts +5 -7
  334. package/templates/current/{examples/src → clean/tests/unit}/layouts/topBarMenuSearch.spec.ts +25 -8
  335. package/templates/current/clean/{src → tests/unit}/locales/messages.spec.ts +43 -17
  336. package/templates/current/clean/tests/unit/router/dynamicMenuRefresh.spec.ts +151 -0
  337. package/templates/current/clean/tests/unit/router/dynamicRoutes.spec.ts +374 -0
  338. package/templates/current/clean/tests/unit/router/paths.spec.ts +103 -0
  339. package/templates/current/clean/{src → tests/unit}/router/queryEncryption.spec.ts +56 -10
  340. package/templates/current/clean/tests/unit/router/routeQuery.spec.ts +19 -0
  341. package/templates/current/clean/{src → tests/unit}/router/runtimeErrorRecovery.spec.ts +11 -6
  342. package/templates/current/{examples/src → clean/tests/unit}/router/useRouteQueryDefaults.spec.ts +46 -12
  343. package/templates/current/clean/tests/unit/scripts/mock-api.spec.ts +440 -0
  344. package/templates/current/clean/{scripts → tests/unit/scripts}/vite-build-policy.spec.ts +35 -6
  345. package/templates/current/clean/{src/features/auth → tests/unit}/store/auth.spec.ts +68 -15
  346. package/templates/current/clean/tests/unit/store/dictionaries.spec.ts +106 -0
  347. package/templates/current/{examples/src → clean/tests/unit}/templates/templates.spec.ts +60 -16
  348. package/templates/current/clean/{src/utils/__tests__ → tests/unit/utils}/color-mix.spec.ts +1 -1
  349. package/templates/current/clean/tests/unit/utils/retryableDialog.spec.ts +61 -0
  350. package/templates/current/{examples/src/features/errors/pages → clean/tests/unit/views/errors}/error-pages.spec.ts +11 -7
  351. package/templates/current/clean/tests/unit/views/feature-composables.spec.ts +233 -0
  352. package/templates/current/clean/tests/unit/views/system/access/admin-repository.spec.ts +353 -0
  353. package/templates/current/clean/tests/unit/views/system/access/rbac.spec.ts +329 -0
  354. package/templates/current/clean/tests/unit/views/system/dept/departments.spec.ts +104 -0
  355. package/templates/current/clean/tests/unit/views/system/dict/dictionaries.spec.ts +234 -0
  356. package/templates/current/clean/tests/unit/views/system/menu/menuDraft.spec.ts +77 -0
  357. package/templates/current/clean/tests/unit/views/system/menu/useMenuManagement.spec.ts +339 -0
  358. package/templates/current/clean/tests/unit/views/system/user/searchControl.spec.ts +128 -0
  359. package/templates/current/clean/tsconfig.json +4 -19
  360. package/templates/current/clean/vite.build-policy.ts +97 -22
  361. package/templates/current/clean/vite.config.ts +50 -7
  362. package/templates/current/examples/.agents/skills/admin-component-usage/SKILL.md +28 -0
  363. package/templates/current/examples/.agents/skills/admin-component-usage/references/component-directory.md +270 -0
  364. package/templates/current/examples/.agents/skills/build-admin-feature/SKILL.md +20 -0
  365. package/templates/current/examples/.agents/skills/build-admin-feature/references/component-selection.md +38 -0
  366. package/templates/current/examples/.agents/skills/style-og-origen-ui/SKILL.md +11 -0
  367. package/templates/current/examples/.agents/skills/use-og-dialog/SKILL.md +12 -0
  368. package/templates/current/examples/.agents/skills/use-og-editor/SKILL.md +25 -0
  369. package/templates/current/examples/.agents/skills/use-og-form/SKILL.md +12 -0
  370. package/templates/current/examples/.agents/skills/use-og-form-table/SKILL.md +26 -0
  371. package/templates/current/examples/.agents/skills/use-og-http/SKILL.md +13 -0
  372. package/templates/current/examples/.agents/skills/use-og-router-tabs/SKILL.md +11 -0
  373. package/templates/current/examples/.agents/skills/use-og-search/SKILL.md +14 -0
  374. package/templates/current/examples/.agents/skills/use-og-table/SKILL.md +22 -0
  375. package/templates/current/examples/.agents/skills/use-og-upload/SKILL.md +26 -0
  376. package/templates/current/examples/.api-client-e2e.config.ts +13 -0
  377. package/templates/current/examples/.claude/rules/01-feature-architecture.md +10 -0
  378. package/templates/current/examples/.claude/rules/02-vue-typescript.md +10 -0
  379. package/templates/current/examples/.claude/rules/03-component-policy.md +31 -0
  380. package/templates/current/examples/.claude/rules/04-api-auth-router.md +10 -0
  381. package/templates/current/examples/.claude/rules/05-style.md +10 -0
  382. package/templates/current/examples/.claude/rules/06-quality.md +10 -0
  383. package/templates/current/examples/.claude/skills/admin-component-usage/SKILL.md +28 -0
  384. package/templates/current/examples/.claude/skills/admin-component-usage/references/component-directory.md +270 -0
  385. package/templates/current/examples/.claude/skills/build-admin-feature/SKILL.md +20 -0
  386. package/templates/current/examples/.claude/skills/build-admin-feature/references/component-selection.md +38 -0
  387. package/templates/current/examples/.claude/skills/style-og-origen-ui/SKILL.md +11 -0
  388. package/templates/current/examples/.claude/skills/use-og-dialog/SKILL.md +12 -0
  389. package/templates/current/examples/.claude/skills/use-og-editor/SKILL.md +25 -0
  390. package/templates/current/examples/.claude/skills/use-og-form/SKILL.md +12 -0
  391. package/templates/current/examples/.claude/skills/use-og-form-table/SKILL.md +26 -0
  392. package/templates/current/examples/.claude/skills/use-og-http/SKILL.md +13 -0
  393. package/templates/current/examples/.claude/skills/use-og-router-tabs/SKILL.md +11 -0
  394. package/templates/current/examples/.claude/skills/use-og-search/SKILL.md +14 -0
  395. package/templates/current/examples/.claude/skills/use-og-table/SKILL.md +22 -0
  396. package/templates/current/examples/.claude/skills/use-og-upload/SKILL.md +26 -0
  397. package/templates/current/examples/.codebuddy/rules/01-feature-architecture.md +2 -2
  398. package/templates/current/examples/.codebuddy/rules/03-component-policy.md +4 -1
  399. package/templates/current/examples/.codebuddy/skills/admin-component-usage/SKILL.md +31 -0
  400. package/templates/current/examples/.codebuddy/skills/admin-component-usage/references/component-directory.md +270 -0
  401. package/templates/current/examples/.codebuddy/skills/build-admin-feature/SKILL.md +11 -5
  402. package/templates/current/examples/.codebuddy/skills/build-admin-feature/references/component-selection.md +38 -0
  403. package/templates/current/examples/.codebuddy/skills/use-og-form/SKILL.md +1 -1
  404. package/templates/current/examples/.codebuddy/skills/use-og-form-table/SKILL.md +4 -3
  405. package/templates/current/examples/.codebuddy/skills/use-og-search/SKILL.md +3 -3
  406. package/templates/current/examples/.codebuddy/skills/use-og-table/SKILL.md +16 -10
  407. package/templates/current/examples/.codebuddy/skills/use-og-upload/SKILL.md +6 -5
  408. package/templates/current/examples/.codex/AGENTS.md +55 -8
  409. package/templates/current/examples/.codex/rules/01-feature-architecture.md +2 -2
  410. package/templates/current/examples/.codex/rules/03-component-policy.md +4 -1
  411. package/templates/current/examples/.cursor/rules/.generated +5 -0
  412. package/templates/current/examples/.cursor/rules/01-feature-architecture.mdc +2 -2
  413. package/templates/current/examples/.cursor/rules/03-component-policy.mdc +4 -1
  414. package/templates/current/examples/.cursor/skills/admin-component-usage/SKILL.md +28 -0
  415. package/templates/current/examples/.cursor/skills/admin-component-usage/references/component-directory.md +270 -0
  416. package/templates/current/examples/.cursor/skills/build-admin-feature/SKILL.md +11 -5
  417. package/templates/current/examples/.cursor/skills/build-admin-feature/references/component-selection.md +38 -0
  418. package/templates/current/examples/.cursor/skills/use-og-form/SKILL.md +1 -1
  419. package/templates/current/examples/.cursor/skills/use-og-form-table/SKILL.md +4 -3
  420. package/templates/current/examples/.cursor/skills/use-og-search/SKILL.md +3 -3
  421. package/templates/current/examples/.cursor/skills/use-og-table/SKILL.md +16 -10
  422. package/templates/current/examples/.cursor/skills/use-og-upload/SKILL.md +6 -5
  423. package/templates/current/examples/{.env.example → .env.dev} +3 -2
  424. package/templates/current/examples/.env.mock +4 -0
  425. package/templates/current/examples/.env.production +5 -0
  426. package/templates/current/examples/.env.test +4 -0
  427. package/templates/current/examples/.node-version +1 -0
  428. package/templates/current/examples/.prettierignore +17 -0
  429. package/templates/current/examples/.prettierrc +8 -0
  430. package/templates/current/examples/.qoder/rules/01-feature-architecture.md +3 -4
  431. package/templates/current/examples/.qoder/rules/02-vue-typescript.md +1 -2
  432. package/templates/current/examples/.qoder/rules/03-component-policy.md +5 -3
  433. package/templates/current/examples/.qoder/rules/04-api-auth-router.md +1 -2
  434. package/templates/current/examples/.qoder/rules/05-style.md +1 -2
  435. package/templates/current/examples/.qoder/rules/06-quality.md +1 -2
  436. package/templates/current/examples/.qoder/skills/admin-component-usage/SKILL.md +28 -0
  437. package/templates/current/examples/.qoder/skills/admin-component-usage/references/component-directory.md +270 -0
  438. package/templates/current/examples/.qoder/skills/build-admin-feature/SKILL.md +11 -5
  439. package/templates/current/examples/.qoder/skills/build-admin-feature/references/component-selection.md +38 -0
  440. package/templates/current/examples/.qoder/skills/use-og-form/SKILL.md +1 -1
  441. package/templates/current/examples/.qoder/skills/use-og-form-table/SKILL.md +4 -3
  442. package/templates/current/examples/.qoder/skills/use-og-search/SKILL.md +3 -3
  443. package/templates/current/examples/.qoder/skills/use-og-table/SKILL.md +16 -10
  444. package/templates/current/examples/.qoder/skills/use-og-upload/SKILL.md +6 -5
  445. package/templates/current/examples/.zcode/skills/admin-component-usage/SKILL.md +28 -0
  446. package/templates/current/examples/.zcode/skills/admin-component-usage/references/component-directory.md +270 -0
  447. package/templates/current/examples/.zcode/skills/build-admin-feature/SKILL.md +20 -0
  448. package/templates/current/examples/.zcode/skills/build-admin-feature/references/component-selection.md +38 -0
  449. package/templates/current/examples/.zcode/skills/style-og-origen-ui/SKILL.md +11 -0
  450. package/templates/current/examples/.zcode/skills/use-og-dialog/SKILL.md +12 -0
  451. package/templates/current/examples/.zcode/skills/use-og-editor/SKILL.md +25 -0
  452. package/templates/current/examples/.zcode/skills/use-og-form/SKILL.md +12 -0
  453. package/templates/current/examples/.zcode/skills/use-og-form-table/SKILL.md +26 -0
  454. package/templates/current/examples/.zcode/skills/use-og-http/SKILL.md +13 -0
  455. package/templates/current/examples/.zcode/skills/use-og-router-tabs/SKILL.md +11 -0
  456. package/templates/current/examples/.zcode/skills/use-og-search/SKILL.md +14 -0
  457. package/templates/current/examples/.zcode/skills/use-og-table/SKILL.md +22 -0
  458. package/templates/current/examples/.zcode/skills/use-og-upload/SKILL.md +26 -0
  459. package/templates/current/examples/AGENTS.md +55 -9
  460. package/templates/current/examples/CHANGELOG.md +129 -0
  461. package/templates/current/examples/CLAUDE.md +3 -0
  462. package/templates/current/examples/README.md +58 -87
  463. package/templates/current/examples/component-catalog.json +766 -348
  464. package/templates/current/examples/component-catalog.v2.json +2040 -0
  465. package/templates/current/examples/docs/components/dialog.md +405 -0
  466. package/templates/current/examples/docs/components/editor-viewer.md +87 -0
  467. package/templates/current/examples/docs/components/editor.md +275 -0
  468. package/templates/current/examples/docs/components/form-table.md +222 -0
  469. package/templates/current/examples/docs/components/form.md +750 -0
  470. package/templates/current/examples/docs/components/index.md +44 -0
  471. package/templates/current/examples/docs/components/router.md +452 -0
  472. package/templates/current/examples/docs/components/search.md +1205 -0
  473. package/templates/current/examples/docs/components/svg-icon.md +124 -0
  474. package/templates/current/examples/docs/components/table-local.md +176 -0
  475. package/templates/current/examples/docs/components/table-with-search.md +207 -0
  476. package/templates/current/examples/docs/components/table.md +813 -0
  477. package/templates/current/examples/docs/components/tabs.md +440 -0
  478. package/templates/current/examples/docs/components/upload.md +349 -0
  479. package/templates/current/examples/eslint.config.js +89 -0
  480. package/templates/current/examples/index.html +1 -1
  481. package/templates/current/examples/openapi.json +10048 -999
  482. package/templates/current/examples/package.json +51 -39
  483. package/templates/current/examples/playwright.config.ts +20 -6
  484. package/templates/current/examples/playwright.mock.config.ts +42 -0
  485. package/templates/current/examples/pnpm-workspace.yaml +34 -0
  486. package/templates/current/examples/recipes/remote-crud-dialog-form.vue +15 -13
  487. package/templates/current/examples/scaffold.lock.json +164 -4
  488. package/templates/current/examples/scripts/api-codegen.config.ts +35 -0
  489. package/templates/current/examples/scripts/api-codegen.ts +2015 -0
  490. package/templates/current/examples/scripts/api-templates/http-client.ejs +359 -0
  491. package/templates/current/examples/scripts/check-admin-scaffold.mjs +316 -18
  492. package/templates/current/examples/scripts/generate-api.ts +290 -85
  493. package/templates/current/examples/scripts/lib/admin-component-catalog.mjs +515 -0
  494. package/templates/current/examples/scripts/lib/repository-root.mjs +9 -0
  495. package/templates/current/examples/scripts/mock-api.ts +1356 -0
  496. package/templates/current/examples/scripts/remove-examples.mjs +10 -35
  497. package/templates/current/examples/src/App.vue +9 -18
  498. package/templates/current/examples/src/api/generated/data-contracts.ts +23 -265
  499. package/templates/current/examples/src/api/generated/http-client.ts +351 -180
  500. package/templates/current/examples/src/api/generated/index.ts +22 -0
  501. package/templates/current/examples/src/api/generated/services/auth.ts +123 -0
  502. package/templates/current/examples/src/api/generated/services/common/files.ts +111 -0
  503. package/templates/current/examples/src/api/generated/services/monitor/cache.ts +164 -0
  504. package/templates/current/examples/src/api/generated/services/monitor/job.ts +195 -0
  505. package/templates/current/examples/src/api/generated/services/monitor/jobLog.ts +126 -0
  506. package/templates/current/examples/src/api/generated/services/monitor/logininfor.ts +126 -0
  507. package/templates/current/examples/src/api/generated/services/monitor/online.ts +66 -0
  508. package/templates/current/examples/src/api/generated/services/monitor/operlog.ts +106 -0
  509. package/templates/current/examples/src/api/generated/services/monitor/server.ts +41 -0
  510. package/templates/current/examples/src/api/generated/services/system/configs.ts +190 -0
  511. package/templates/current/examples/src/api/generated/services/system/departments.ts +173 -0
  512. package/templates/current/examples/src/api/generated/services/system/dictionaries/data.ts +169 -0
  513. package/templates/current/examples/src/api/generated/services/system/dictionaries/types.ts +187 -0
  514. package/templates/current/examples/src/api/generated/services/system/index.ts +158 -0
  515. package/templates/current/examples/src/api/generated/services/system/menus.ts +193 -0
  516. package/templates/current/examples/src/api/generated/services/system/notices.ts +221 -0
  517. package/templates/current/examples/src/api/generated/services/system/posts.ts +168 -0
  518. package/templates/current/examples/src/api/generated/services/system/roles.ts +354 -0
  519. package/templates/current/examples/src/api/generated/services/system/users.ts +425 -0
  520. package/templates/current/examples/src/api/generated/services/tool/code-generator.ts +304 -0
  521. package/templates/current/examples/src/api/generated/types/auth.types.ts +132 -0
  522. package/templates/current/examples/src/api/generated/types/common/files.types.ts +57 -0
  523. package/templates/current/examples/src/api/generated/types/common.ts +174 -0
  524. package/templates/current/examples/src/api/generated/types/enum-dict.ts +94 -0
  525. package/templates/current/examples/src/api/generated/types/enums.ts +155 -0
  526. package/templates/current/examples/src/api/generated/types/monitor/cache.types.ts +149 -0
  527. package/templates/current/examples/src/api/generated/types/monitor/job.types.ts +207 -0
  528. package/templates/current/examples/src/api/generated/types/monitor/jobLog.types.ts +134 -0
  529. package/templates/current/examples/src/api/generated/types/monitor/logininfor.types.ts +135 -0
  530. package/templates/current/examples/src/api/generated/types/monitor/online.types.ts +80 -0
  531. package/templates/current/examples/src/api/generated/types/monitor/operlog.types.ts +126 -0
  532. package/templates/current/examples/src/api/generated/types/monitor/server.types.ts +205 -0
  533. package/templates/current/examples/src/api/generated/types/system/configs.types.ts +200 -0
  534. package/templates/current/examples/src/api/generated/types/system/departments.types.ts +145 -0
  535. package/templates/current/examples/src/api/generated/types/system/dictionaries/data.types.ts +210 -0
  536. package/templates/current/examples/src/api/generated/types/system/dictionaries/types.types.ts +221 -0
  537. package/templates/current/examples/src/api/generated/types/system/index.types.ts +19 -0
  538. package/templates/current/examples/src/api/generated/types/system/menus.types.ts +234 -0
  539. package/templates/current/examples/src/api/generated/types/system/notices.types.ts +270 -0
  540. package/templates/current/examples/src/api/generated/types/system/posts.types.ts +198 -0
  541. package/templates/current/examples/src/api/generated/types/system/roles.types.ts +410 -0
  542. package/templates/current/examples/src/api/generated/types/system/users.types.ts +413 -0
  543. package/templates/current/examples/src/api/generated/types/tool/code-generator.types.ts +388 -0
  544. package/templates/current/examples/src/api/index.ts +44 -39
  545. package/templates/current/examples/src/app/__tests__/api-generated.types.ts +24 -0
  546. package/templates/current/examples/src/app/api.ts +6 -0
  547. package/templates/current/examples/src/app/authorization/permission.ts +9 -0
  548. package/templates/current/{clean/src/app → examples/src/app/config}/runtimeConfig.ts +44 -12
  549. package/templates/current/examples/src/app/errors/errorMessage.ts +80 -0
  550. package/templates/current/examples/src/app/http/client.ts +141 -0
  551. package/templates/current/examples/src/app/http/http-adapter.ts +71 -0
  552. package/templates/current/{clean/src/app → examples/src/app/i18n}/adminLocale.ts +25 -19
  553. package/templates/current/examples/src/app/{localeFormat.ts → i18n/localeFormat.ts} +29 -6
  554. package/templates/current/examples/src/app/i18n/origenUiLocale.ts +15 -0
  555. package/templates/current/examples/src/app/menu/menu.ts +175 -0
  556. package/templates/current/examples/src/app/menu/menuTypes.ts +20 -0
  557. package/templates/current/examples/src/{features → app}/security/devtoolsProtection.ts +8 -7
  558. package/templates/current/examples/src/app/ui/createAdminUi.ts +31 -0
  559. package/templates/current/examples/src/app/ui/iconCatalog.ts +71 -0
  560. package/templates/current/examples/src/assets/icons/appearance.svg +1 -0
  561. package/templates/current/examples/src/assets/icons/arrow-right.svg +1 -0
  562. package/templates/current/examples/src/assets/icons/check.svg +1 -0
  563. package/templates/current/examples/src/assets/icons/circle-check.svg +1 -0
  564. package/templates/current/examples/src/assets/icons/default.svg +4 -0
  565. package/templates/current/examples/src/assets/icons/directory/setting.svg +1 -0
  566. package/templates/current/examples/src/assets/icons/expand.svg +1 -0
  567. package/templates/current/examples/src/assets/icons/fold.svg +1 -0
  568. package/templates/current/examples/src/assets/icons/key.svg +1 -0
  569. package/templates/current/examples/src/assets/icons/lock.svg +1 -0
  570. package/templates/current/examples/src/assets/icons/monitor.svg +1 -0
  571. package/templates/current/examples/src/assets/icons/moon.svg +11 -0
  572. package/templates/current/examples/src/assets/icons/page/department.svg +1 -0
  573. package/templates/current/examples/src/assets/icons/page/dictionary.svg +1 -0
  574. package/templates/current/examples/src/assets/icons/page/menus.svg +1 -0
  575. package/templates/current/examples/src/assets/icons/page/user.svg +1 -0
  576. package/templates/current/examples/src/assets/icons/page/users.svg +1 -0
  577. package/templates/current/examples/src/assets/icons/plus.svg +1 -0
  578. package/templates/current/examples/src/assets/icons/profile.svg +1 -0
  579. package/templates/current/examples/src/assets/icons/refresh.svg +1 -0
  580. package/templates/current/examples/src/assets/icons/roles.svg +1 -0
  581. package/templates/current/examples/src/assets/icons/search.svg +1 -0
  582. package/templates/current/examples/src/assets/icons/sunny.svg +1 -0
  583. package/templates/current/examples/src/assets/icons/system.svg +1 -0
  584. package/templates/current/examples/src/assets/icons/theme-auto.svg +14 -0
  585. package/templates/current/examples/src/assets/icons/tune.svg +13 -0
  586. package/templates/current/examples/src/{features/shell/components → components}/RouteProgress.vue +2 -2
  587. package/templates/current/{clean/src/features/system/access → examples/src}/composables/useAuthorizationRefresh.ts +6 -1
  588. package/templates/current/examples/src/composables/useSystemTableSearchVisibility.ts +33 -0
  589. package/templates/current/examples/src/{features/appearance/composables → composables}/useTheme.ts +1 -1
  590. package/templates/current/examples/src/env.d.ts +6 -19
  591. package/templates/current/examples/src/layouts/AdminLayout.vue +7 -9
  592. package/templates/current/examples/src/{features/shell/components → layouts}/AdminWatermark.vue +2 -2
  593. package/templates/current/examples/src/layouts/BreadcrumbBar.vue +9 -1
  594. package/templates/current/examples/src/layouts/SideMenu.vue +7 -15
  595. package/templates/current/examples/src/{features/appearance/components → layouts}/ThemePanel.vue +39 -11
  596. package/templates/current/examples/src/layouts/TopBar.vue +60 -28
  597. package/templates/current/examples/src/layouts/WorkspaceTabs.vue +10 -1
  598. package/templates/current/examples/src/layouts/topBarMenuSearch.ts +25 -4
  599. package/templates/current/examples/src/locales/en-US.json +227 -219
  600. package/templates/current/examples/src/locales/index.ts +72 -32
  601. package/templates/current/examples/src/locales/messages-types.ts +15 -10
  602. package/templates/current/examples/src/locales/vue-i18n.d.ts +1 -1
  603. package/templates/current/examples/src/locales/zh-CN.json +226 -218
  604. package/templates/current/examples/src/locales/zh-TW.json +222 -214
  605. package/templates/current/examples/src/main.ts +50 -40
  606. package/templates/current/examples/src/router/bootstrap.ts +69 -24
  607. package/templates/current/examples/src/router/dynamic/componentLoader.ts +150 -0
  608. package/templates/current/examples/src/router/{dynamicMenuRefresh.ts → dynamic/dynamicMenuRefresh.ts} +6 -2
  609. package/templates/current/examples/src/router/dynamic/dynamicRoutes.ts +247 -0
  610. package/templates/current/examples/src/router/navigation/guards.ts +12 -0
  611. package/templates/current/examples/src/router/navigation/paths.ts +28 -0
  612. package/templates/current/examples/src/router/navigation/staticRoutes.ts +109 -0
  613. package/templates/current/examples/src/router/{queryEncryption.ts → query/queryEncryption.ts} +29 -12
  614. package/templates/current/examples/src/router/query/routeQuery.ts +29 -0
  615. package/templates/current/examples/src/router/{useRouteQueryDefaults.ts → query/useRouteQueryDefaults.ts} +9 -8
  616. package/templates/current/examples/src/router/query/useRouteQueryDefaults.types.ts +28 -0
  617. package/templates/current/examples/src/router/{runtimeErrorRecovery.ts → recovery/runtimeErrorRecovery.ts} +21 -3
  618. package/templates/current/examples/src/{features/auth/store → store}/auth.ts +96 -61
  619. package/templates/current/examples/src/store/dictionaries.ts +86 -0
  620. package/templates/current/examples/src/{features/shell/store → store}/sidebar.ts +9 -2
  621. package/templates/current/{clean/src/features/appearance → examples/src}/store/theme.ts +8 -4
  622. package/templates/current/examples/src/styles/layout.css +51 -0
  623. package/templates/current/examples/src/templates/og-form.ts +7 -2
  624. package/templates/current/examples/src/templates/og-table.ts +88 -20
  625. package/templates/current/examples/src/templates/router.ts +11 -2
  626. package/templates/current/examples/src/utils/color-mix.ts +6 -2
  627. package/templates/current/examples/src/utils/download.ts +11 -0
  628. package/templates/current/examples/src/utils/permissions.ts +1 -1
  629. package/templates/current/examples/src/utils/retryableDialog.ts +46 -0
  630. package/templates/current/{clean/scripts/clean-overlay/src/features → examples/src/views}/errors/pages/Forbidden.vue +6 -2
  631. package/templates/current/examples/src/views/errors/pages/MethodNotAllowed.vue +34 -0
  632. package/templates/current/examples/{scripts/clean-overlay/src/features → src/views}/errors/pages/NotFound.vue +6 -2
  633. package/templates/current/examples/{scripts/clean-overlay/src/features → src/views}/errors/pages/ServerError.vue +6 -2
  634. package/templates/current/examples/src/{features/auth/pages/Login.vue → views/login/pages/index.vue} +101 -11
  635. package/templates/current/examples/src/views/system/access/services/admin-repository.ts +489 -0
  636. package/templates/current/examples/src/views/system/access/services/rbac.ts +317 -0
  637. package/templates/current/examples/src/views/system/dept/components/DepartmentEditorForm.vue +87 -0
  638. package/templates/current/examples/src/views/system/dept/composables/useDepartmentManagement.ts +314 -0
  639. package/templates/current/examples/src/views/system/dept/pages/index.vue +44 -0
  640. package/templates/current/examples/src/views/system/dept/services/departments.ts +168 -0
  641. package/templates/current/examples/src/views/system/dict/components/DictionaryDataEditorForm.vue +98 -0
  642. package/templates/current/examples/src/views/system/dict/components/DictionaryDataPreview.vue +233 -0
  643. package/templates/current/examples/src/views/system/dict/components/DictionaryTypeEditorForm.vue +66 -0
  644. package/templates/current/examples/src/views/system/dict/composables/useDictionaryDataManagement.ts +406 -0
  645. package/templates/current/examples/src/views/system/dict/composables/useDictionaryTypeManagement.ts +329 -0
  646. package/templates/current/examples/src/views/system/dict/data/pages/index.vue +134 -0
  647. package/templates/current/examples/src/views/system/dict/pages/index.vue +113 -0
  648. package/templates/current/examples/src/views/system/dict/services/dictionaries.ts +239 -0
  649. package/templates/current/examples/src/views/system/menu/components/MenuEditorForm.vue +252 -0
  650. package/templates/current/examples/src/views/system/menu/composables/useMenuManagement.ts +357 -0
  651. package/templates/current/examples/src/views/system/menu/menuDraft.ts +45 -0
  652. package/templates/current/examples/src/views/system/menu/pages/ExternalLink.vue +37 -0
  653. package/templates/current/examples/src/views/system/menu/pages/index.vue +75 -0
  654. package/templates/current/examples/src/views/system/post/components/PostEditorForm.vue +69 -0
  655. package/templates/current/examples/src/views/system/post/composables/usePostManagement.ts +245 -0
  656. package/templates/current/examples/src/views/system/post/pages/index.vue +92 -0
  657. package/templates/current/examples/src/views/system/post/services/posts.ts +100 -0
  658. package/templates/current/examples/src/views/system/role/auth-users/pages/index.vue +100 -0
  659. package/templates/current/examples/src/views/system/role/components/RoleDataScopeForm.vue +167 -0
  660. package/templates/current/examples/src/views/system/role/components/RoleEditorForm.vue +165 -0
  661. package/templates/current/examples/src/views/system/role/components/RoleUserSelectForm.vue +129 -0
  662. package/templates/current/examples/src/views/system/role/composables/useRoleManagement.ts +422 -0
  663. package/templates/current/examples/src/views/system/role/composables/useRoleUserManagement.ts +233 -0
  664. package/templates/current/examples/src/views/system/role/pages/index.vue +110 -0
  665. package/templates/current/examples/src/views/system/role/services/roleAccess.ts +162 -0
  666. package/templates/current/examples/src/views/system/user/auth-roles/pages/index.vue +209 -0
  667. package/templates/current/examples/src/views/system/user/components/UserDetailsForm.vue +108 -0
  668. package/templates/current/examples/src/views/system/user/components/UserEditorForm.vue +207 -0
  669. package/templates/current/examples/src/views/system/user/components/UserImportDialog.vue +80 -0
  670. package/templates/current/examples/src/views/system/user/components/UserResetPasswordForm.vue +56 -0
  671. package/templates/current/examples/src/views/system/user/composables/useUserManagement.ts +502 -0
  672. package/templates/current/examples/src/views/system/user/pages/index.vue +459 -0
  673. package/templates/current/examples/tests/e2e/admin-access-business.spec.ts +33 -0
  674. package/templates/current/examples/tests/e2e/admin-shell.spec.ts +50 -0
  675. package/templates/current/examples/tests/e2e/fixtures/adminMockBackend.ts +95 -0
  676. package/templates/current/examples/tests/e2e/fixtures/labelGeometry.ts +52 -0
  677. package/templates/current/examples/tests/e2e/mock-api-generation.spec.ts +27 -0
  678. package/templates/current/examples/tests/e2e/mock-business.spec.ts +555 -0
  679. package/templates/current/examples/tests/e2e/mock-menu-retry-form-label.spec.ts +100 -0
  680. package/templates/current/examples/tests/e2e/mock-shell.spec.ts +25 -0
  681. package/templates/current/examples/tests/e2e/mock-tree-selection-layout.spec.ts +113 -0
  682. package/templates/current/examples/tests/unit/api/api-codegen.spec.ts +893 -0
  683. package/templates/current/examples/tests/unit/api/client.spec.ts +145 -0
  684. package/templates/current/examples/tests/unit/api/generated-http-client.spec.ts +290 -0
  685. package/templates/current/{clean/src → examples/tests/unit}/api/http-adapter.spec.ts +3 -3
  686. package/templates/current/examples/tests/unit/api/system-apis.spec.ts +118 -0
  687. package/templates/current/examples/tests/unit/app/createAdminUi.spec.ts +79 -0
  688. package/templates/current/examples/{src → tests/unit}/app/errorMessage.spec.ts +1 -1
  689. package/templates/current/examples/tests/unit/app/iconCatalog.spec.ts +12 -0
  690. package/templates/current/examples/tests/unit/app/menu.spec.ts +215 -0
  691. package/templates/current/{clean/src → examples/tests/unit}/app/origenUiLocale.spec.ts +1 -1
  692. package/templates/current/{clean/src → examples/tests/unit}/app/permission.spec.ts +4 -5
  693. package/templates/current/examples/tests/unit/app/runtimeConfig.spec.ts +36 -0
  694. package/templates/current/{clean/src/features → examples/tests/unit/app}/security/devtoolsProtection.spec.ts +17 -7
  695. package/templates/current/{clean/src/features/shell → examples/tests/unit}/composables/useRouteProgress.spec.ts +1 -1
  696. package/templates/current/{clean/src/features/shell/components → examples/tests/unit/layouts}/AdminWatermark.spec.ts +5 -7
  697. package/templates/current/{clean/src → examples/tests/unit}/layouts/topBarMenuSearch.spec.ts +25 -8
  698. package/templates/current/examples/{src → tests/unit}/locales/messages.spec.ts +43 -17
  699. package/templates/current/examples/tests/unit/router/dynamicMenuRefresh.spec.ts +151 -0
  700. package/templates/current/examples/tests/unit/router/dynamicRoutes.spec.ts +374 -0
  701. package/templates/current/examples/tests/unit/router/paths.spec.ts +103 -0
  702. package/templates/current/examples/{src → tests/unit}/router/queryEncryption.spec.ts +56 -10
  703. package/templates/current/examples/tests/unit/router/routeQuery.spec.ts +19 -0
  704. package/templates/current/examples/{src → tests/unit}/router/runtimeErrorRecovery.spec.ts +11 -6
  705. package/templates/current/{clean/src → examples/tests/unit}/router/useRouteQueryDefaults.spec.ts +46 -12
  706. package/templates/current/examples/tests/unit/scripts/mock-api.spec.ts +440 -0
  707. package/templates/current/examples/{scripts → tests/unit/scripts}/vite-build-policy.spec.ts +35 -6
  708. package/templates/current/examples/{src/features/auth → tests/unit}/store/auth.spec.ts +68 -15
  709. package/templates/current/examples/tests/unit/store/dictionaries.spec.ts +106 -0
  710. package/templates/current/{clean/src → examples/tests/unit}/templates/templates.spec.ts +60 -16
  711. package/templates/current/examples/{src/utils/__tests__ → tests/unit/utils}/color-mix.spec.ts +1 -1
  712. package/templates/current/examples/tests/unit/utils/retryableDialog.spec.ts +61 -0
  713. package/templates/current/examples/{scripts/clean-overlay/src/features/errors/pages → tests/unit/views/errors}/error-pages.spec.ts +12 -9
  714. package/templates/current/examples/tests/unit/views/feature-composables.spec.ts +233 -0
  715. package/templates/current/examples/tests/unit/views/system/access/admin-repository.spec.ts +353 -0
  716. package/templates/current/examples/tests/unit/views/system/access/rbac.spec.ts +329 -0
  717. package/templates/current/examples/tests/unit/views/system/dept/departments.spec.ts +104 -0
  718. package/templates/current/examples/tests/unit/views/system/dict/dictionaries.spec.ts +234 -0
  719. package/templates/current/examples/tests/unit/views/system/menu/menuDraft.spec.ts +77 -0
  720. package/templates/current/examples/tests/unit/views/system/menu/useMenuManagement.spec.ts +339 -0
  721. package/templates/current/examples/tests/unit/views/system/user/searchControl.spec.ts +128 -0
  722. package/templates/current/examples/tsconfig.json +4 -19
  723. package/templates/current/examples/vite.build-policy.ts +97 -22
  724. package/templates/current/examples/vite.config.ts +50 -7
  725. package/templates/current/clean/.codebuddy/AGENTS.md +0 -18
  726. package/templates/current/clean/.codex/skills/build-admin-feature/SKILL.md +0 -14
  727. package/templates/current/clean/.codex/skills/build-admin-feature/references/component-selection.md +0 -25
  728. package/templates/current/clean/.codex/skills/use-og-table/SKILL.md +0 -16
  729. package/templates/current/clean/.cursor/AGENTS.md +0 -18
  730. package/templates/current/clean/.env.production.example +0 -31
  731. package/templates/current/clean/.qoder/AGENTS.md +0 -15
  732. package/templates/current/clean/e2e/admin-shell.spec.ts +0 -156
  733. package/templates/current/clean/e2e/demo-shell.spec.ts +0 -372
  734. package/templates/current/clean/playwright.demo.config.ts +0 -25
  735. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/NotFound.vue +0 -31
  736. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/ServerError.vue +0 -31
  737. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/error-pages.spec.ts +0 -41
  738. package/templates/current/clean/scripts/clean-overlay/src/main.ts +0 -100
  739. package/templates/current/clean/scripts/clean-overlay/src/router/componentCache.ts +0 -12
  740. package/templates/current/clean/scripts/clean-overlay/src/router/componentRegistry.ts +0 -14
  741. package/templates/current/clean/scripts/clean-overlay/src/router/dynamicRoutes.spec.ts +0 -77
  742. package/templates/current/clean/scripts/clean-overlay/src/router/paths.ts +0 -21
  743. package/templates/current/clean/scripts/clean-overlay/src/router/staticRoutes.ts +0 -63
  744. package/templates/current/clean/scripts/demo-api.ts +0 -873
  745. package/templates/current/clean/src/api/client.spec.ts +0 -66
  746. package/templates/current/clean/src/api/client.ts +0 -152
  747. 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
  748. 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
  749. 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
  750. 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
  751. 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
  752. 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
  753. 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
  754. package/templates/current/clean/src/api/generated//350/256/244/350/257/201.ts +0 -95
  755. package/templates/current/clean/src/api/http-adapter.ts +0 -83
  756. package/templates/current/clean/src/app/createAdminUi.spec.ts +0 -166
  757. package/templates/current/clean/src/app/createAdminUi.ts +0 -63
  758. package/templates/current/clean/src/app/embedded-token.spec.ts +0 -40
  759. package/templates/current/clean/src/app/embedded.spec.ts +0 -135
  760. package/templates/current/clean/src/app/embedded.ts +0 -255
  761. package/templates/current/clean/src/app/errorMessage.ts +0 -53
  762. package/templates/current/clean/src/app/menu-host.spec.ts +0 -77
  763. package/templates/current/clean/src/app/menu.spec.ts +0 -320
  764. package/templates/current/clean/src/app/menu.ts +0 -308
  765. package/templates/current/clean/src/app/menuTypes.ts +0 -18
  766. package/templates/current/clean/src/app/origenUiLocale.ts +0 -10
  767. package/templates/current/clean/src/app/permission.ts +0 -9
  768. package/templates/current/clean/src/demo-api.spec.ts +0 -478
  769. package/templates/current/clean/src/features/errors/pages/error-pages.spec.ts +0 -41
  770. package/templates/current/clean/src/features/system/access/api/admin-repository.spec.ts +0 -14
  771. package/templates/current/clean/src/features/system/access/api/admin-repository.ts +0 -298
  772. package/templates/current/clean/src/features/system/access/api/rbac.spec.ts +0 -72
  773. package/templates/current/clean/src/features/system/access/api/rbac.ts +0 -292
  774. package/templates/current/clean/src/features/system/access/composables/useAuthorizationPolling.spec.ts +0 -134
  775. package/templates/current/clean/src/features/system/access/composables/useAuthorizationPolling.ts +0 -96
  776. package/templates/current/clean/src/features/workspace/pages/Profile.vue +0 -185
  777. package/templates/current/clean/src/router/componentCache.ts +0 -12
  778. package/templates/current/clean/src/router/componentRegistry.ts +0 -14
  779. package/templates/current/clean/src/router/dynamicMenuRefresh.spec.ts +0 -101
  780. package/templates/current/clean/src/router/dynamicRoutes.spec.ts +0 -77
  781. package/templates/current/clean/src/router/dynamicRoutes.ts +0 -177
  782. package/templates/current/clean/src/router/guards.ts +0 -5
  783. package/templates/current/clean/src/router/paths.spec.ts +0 -50
  784. package/templates/current/clean/src/router/paths.ts +0 -21
  785. package/templates/current/clean/src/router/routeQuery.spec.ts +0 -11
  786. package/templates/current/clean/src/router/routeQuery.ts +0 -3
  787. package/templates/current/clean/src/router/staticRoutes.ts +0 -63
  788. package/templates/current/clean/src/router/useRouteQueryDefaults.types.ts +0 -20
  789. package/templates/current/examples/.codebuddy/AGENTS.md +0 -18
  790. package/templates/current/examples/.codex/skills/build-admin-feature/SKILL.md +0 -14
  791. package/templates/current/examples/.codex/skills/build-admin-feature/references/component-selection.md +0 -25
  792. package/templates/current/examples/.codex/skills/use-og-table/SKILL.md +0 -16
  793. package/templates/current/examples/.cursor/AGENTS.md +0 -18
  794. package/templates/current/examples/.env.production.example +0 -31
  795. package/templates/current/examples/.qoder/AGENTS.md +0 -15
  796. package/templates/current/examples/e2e/admin-shell.spec.ts +0 -156
  797. package/templates/current/examples/e2e/demo-shell.spec.ts +0 -372
  798. package/templates/current/examples/playwright.demo.config.ts +0 -25
  799. package/templates/current/examples/scripts/clean-overlay/src/features/errors/pages/Forbidden.vue +0 -31
  800. package/templates/current/examples/scripts/clean-overlay/src/main.ts +0 -100
  801. package/templates/current/examples/scripts/clean-overlay/src/router/componentCache.ts +0 -12
  802. package/templates/current/examples/scripts/clean-overlay/src/router/componentRegistry.ts +0 -14
  803. package/templates/current/examples/scripts/clean-overlay/src/router/dynamicRoutes.spec.ts +0 -77
  804. package/templates/current/examples/scripts/clean-overlay/src/router/paths.ts +0 -21
  805. package/templates/current/examples/scripts/clean-overlay/src/router/staticRoutes.ts +0 -63
  806. package/templates/current/examples/scripts/demo-api.ts +0 -873
  807. package/templates/current/examples/src/api/client.spec.ts +0 -66
  808. package/templates/current/examples/src/api/client.ts +0 -152
  809. 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
  810. 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
  811. 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
  812. 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
  813. 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
  814. 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
  815. 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
  816. package/templates/current/examples/src/api/generated//350/256/244/350/257/201.ts +0 -95
  817. package/templates/current/examples/src/api/http-adapter.ts +0 -83
  818. package/templates/current/examples/src/app/createAdminUi.spec.ts +0 -166
  819. package/templates/current/examples/src/app/createAdminUi.ts +0 -63
  820. package/templates/current/examples/src/app/embedded-token.spec.ts +0 -40
  821. package/templates/current/examples/src/app/embedded.spec.ts +0 -135
  822. package/templates/current/examples/src/app/embedded.ts +0 -255
  823. package/templates/current/examples/src/app/errorMessage.ts +0 -53
  824. package/templates/current/examples/src/app/menu-host.spec.ts +0 -77
  825. package/templates/current/examples/src/app/menu.spec.ts +0 -320
  826. package/templates/current/examples/src/app/menu.ts +0 -308
  827. package/templates/current/examples/src/app/menuTypes.ts +0 -18
  828. package/templates/current/examples/src/app/origenUiLocale.ts +0 -10
  829. package/templates/current/examples/src/app/permission.ts +0 -9
  830. package/templates/current/examples/src/demo-api.spec.ts +0 -478
  831. package/templates/current/examples/src/features/errors/pages/Forbidden.vue +0 -31
  832. package/templates/current/examples/src/features/errors/pages/NotFound.vue +0 -31
  833. package/templates/current/examples/src/features/errors/pages/ServerError.vue +0 -31
  834. package/templates/current/examples/src/features/feature-composables.spec.ts +0 -245
  835. package/templates/current/examples/src/features/system/access/api/admin-repository.spec.ts +0 -14
  836. package/templates/current/examples/src/features/system/access/api/admin-repository.ts +0 -298
  837. package/templates/current/examples/src/features/system/access/api/rbac.spec.ts +0 -72
  838. package/templates/current/examples/src/features/system/access/api/rbac.ts +0 -292
  839. package/templates/current/examples/src/features/system/access/composables/useAuthorizationPolling.spec.ts +0 -134
  840. package/templates/current/examples/src/features/system/access/composables/useAuthorizationPolling.ts +0 -96
  841. package/templates/current/examples/src/features/system/audit/composables/useAuditManagement.ts +0 -122
  842. package/templates/current/examples/src/features/system/audit/pages/AuditList.vue +0 -20
  843. package/templates/current/examples/src/features/system/menus/components/MenuEditorForm.vue +0 -279
  844. package/templates/current/examples/src/features/system/menus/composables/useMenuManagement.ts +0 -435
  845. package/templates/current/examples/src/features/system/menus/menuDraft.spec.ts +0 -204
  846. package/templates/current/examples/src/features/system/menus/menuDraft.ts +0 -116
  847. package/templates/current/examples/src/features/system/menus/menuTreePrecheck.spec.ts +0 -268
  848. package/templates/current/examples/src/features/system/menus/menuTreePrecheck.ts +0 -317
  849. package/templates/current/examples/src/features/system/menus/pages/MenuList.vue +0 -51
  850. package/templates/current/examples/src/features/system/roles/components/RoleEditorForm.vue +0 -116
  851. package/templates/current/examples/src/features/system/roles/composables/useRoleManagement.ts +0 -194
  852. package/templates/current/examples/src/features/system/roles/pages/RoleList.vue +0 -47
  853. package/templates/current/examples/src/features/system/users/components/UserEditorForm.vue +0 -104
  854. package/templates/current/examples/src/features/system/users/composables/useUserManagement.ts +0 -228
  855. package/templates/current/examples/src/features/system/users/pages/UserList.vue +0 -51
  856. package/templates/current/examples/src/features/workspace/pages/Dashboard.spec.ts +0 -41
  857. package/templates/current/examples/src/features/workspace/pages/Dashboard.vue +0 -325
  858. package/templates/current/examples/src/features/workspace/pages/Profile.vue +0 -185
  859. package/templates/current/examples/src/router/componentCache.ts +0 -18
  860. package/templates/current/examples/src/router/componentRegistry.ts +0 -66
  861. package/templates/current/examples/src/router/dynamicMenuRefresh.spec.ts +0 -101
  862. package/templates/current/examples/src/router/dynamicRoutes.spec.ts +0 -144
  863. package/templates/current/examples/src/router/dynamicRoutes.ts +0 -177
  864. package/templates/current/examples/src/router/guards.ts +0 -5
  865. package/templates/current/examples/src/router/paths.spec.ts +0 -50
  866. package/templates/current/examples/src/router/paths.ts +0 -21
  867. package/templates/current/examples/src/router/routeQuery.spec.ts +0 -11
  868. package/templates/current/examples/src/router/routeQuery.ts +0 -3
  869. package/templates/current/examples/src/router/staticRoutes.ts +0 -63
  870. package/templates/current/examples/src/router/useRouteQueryDefaults.types.ts +0 -20
  871. /package/templates/current/clean/{.codex → .agents}/skills/style-og-origen-ui/SKILL.md +0 -0
  872. /package/templates/current/clean/{.codex → .agents}/skills/style-og-origen-ui/agents/openai.yaml +0 -0
  873. /package/templates/current/clean/{.codex → .agents}/skills/use-og-dialog/SKILL.md +0 -0
  874. /package/templates/current/clean/{.codex → .agents}/skills/use-og-dialog/agents/openai.yaml +0 -0
  875. /package/templates/current/clean/{.codex → .agents}/skills/use-og-editor/SKILL.md +0 -0
  876. /package/templates/current/clean/{.codex → .agents}/skills/use-og-http/SKILL.md +0 -0
  877. /package/templates/current/clean/{.codex → .agents}/skills/use-og-http/agents/openai.yaml +0 -0
  878. /package/templates/current/clean/{.codex → .agents}/skills/use-og-router-tabs/SKILL.md +0 -0
  879. /package/templates/current/{examples/.codex → clean/.claude}/skills/style-og-origen-ui/SKILL.md +0 -0
  880. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-dialog/SKILL.md +0 -0
  881. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-editor/SKILL.md +0 -0
  882. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-http/SKILL.md +0 -0
  883. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-router-tabs/SKILL.md +0 -0
  884. /package/templates/current/clean/src/{features/security/components → components}/DevtoolsProtectionOverlay.vue +0 -0
  885. /package/templates/current/clean/src/{features/shell/composables → composables}/useRouteProgress.ts +0 -0
  886. /package/templates/current/clean/src/{features/workspace → views/fallback}/pages/Empty.vue +0 -0
  887. /package/templates/current/examples/{.codex → .agents}/skills/style-og-origen-ui/agents/openai.yaml +0 -0
  888. /package/templates/current/examples/{.codex → .agents}/skills/use-og-dialog/agents/openai.yaml +0 -0
  889. /package/templates/current/examples/{.codex → .agents}/skills/use-og-http/agents/openai.yaml +0 -0
  890. /package/templates/current/examples/src/{features/security/components → components}/DevtoolsProtectionOverlay.vue +0 -0
  891. /package/templates/current/examples/src/{features/shell/composables → composables}/useRouteProgress.ts +0 -0
  892. /package/templates/current/examples/src/{features/workspace → views/fallback}/pages/Empty.vue +0 -0
@@ -0,0 +1,440 @@
1
+ ---
2
+ title: OgTabs
3
+ description: 受控企业工作区页签。
4
+ ---
5
+
6
+ # OgTabs
7
+
8
+ `OgTabs` 是面向 Vue 3 应用的受控工作区原语。其唯一导航路径为 Element Plus 的 `ElTabs` 与 `ElTabPane`;路由、缓存、持久化、权限与业务状态均由应用层持有。组件的 fallthrough 属性与监听器落在原生 `ElTabs` 表面,包装层只保留自身布局属性,避免同一标识或 DOM 事件在两层重复生效。
9
+
10
+ ## 基础用法
11
+
12
+ 父组件持有 `ogItems` 与 `modelValue`。OgTabs 发出建议的更新并请求操作,但不会自行提交任一值。这让应用可以一致地应用路由守卫、未保存变更策略与持久化。
13
+
14
+ <div id="tabs-controlled-workspace"></div>
15
+ ### 受控工作区
16
+
17
+ 父组件接受或拒绝建议的激活值与标签列表。
18
+
19
+ ## 典型用法
20
+
21
+ <div id="tabs-navigation-state"></div>
22
+ <div id="tabs-appearance"></div>
23
+ <div id="tabs-navigation"></div>
24
+ ### 外观、状态与受控导航
25
+
26
+ 合并密度、繁忙、固定和受控导航,观察标签栏与内容面板同步。
27
+
28
+ ## 高级能力
29
+
30
+ <div id="tabs-policy-guards"></div>
31
+ <div id="tabs-policy"></div>
32
+ <div id="tabs-guarded-actions"></div>
33
+ ### 权限策略与守卫操作
34
+
35
+ 合并操作许可策略与异步守卫,记录接受、拒绝和失败载荷。
36
+
37
+ ## API
38
+
39
+ ## 操作与命令
40
+
41
+ 关闭、固钉、刷新、拖拽、右键菜单、标签查找与键盘操作均为可选。所有被接受的操作都会经过 `ogBeforeAction`,随后发出 `actionRequest`;由父组件决定是否将建议的 `nextItems` 与 `nextActiveKey` 写回自身状态。
42
+
43
+ 组件默认使用中文的操作、查找、状态和无障碍文案;通过 `ogLocale` 传入 `Partial<OgTabsLocale>` 可按需覆盖其他语言。
44
+
45
+ ## 仅导航
46
+
47
+ 当应用自行渲染内容(如路由视图或 keep-alive 边界)时,将 `og-render-content` 设为 `false`。
48
+
49
+ ## 核心契约
50
+
51
+ | 能力 | 契约 |
52
+ | -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
53
+ | 标签集合 | `ogItems` 为必填。建议的不可变值通过 `update:ogItems` 发出。 |
54
+ | 激活标签 | `modelValue` 通过 `update:modelValue` 受控;父组件状态不变时原生选择保持不变。 |
55
+ | 操作 | 被接受的操作会发出 `actionRequest`。可监听 `closeRequest`、`refreshRequest`、`pinChangeRequest` 或 `reorderRequest` 做针对性处理。 |
56
+ | 守卫 | `ogBeforeAction(context)` 可异步。返回 `false` 拒绝操作;抛出错误则发出 `operationError`。 |
57
+ | 查找器 | 启用 `ogFeatures.finder`。当标签溢出或达到 `ogFinderThreshold`(默认 `8`)时自动出现,导航同一条 Element Plus 标签条。 |
58
+ | 外观 | `default` 为下划线导航,`workspace` 为卡片页签;`dirty` 标记未保存工作,紧凑密度适合密集操作界面。 |
59
+ | 可访问性 | 组件保留原生 tab 语义,有可见焦点处理,启用键盘操作时支持 Delete、Home、End 与 Shift+F10/ContextMenu,并在键盘关闭后恢复焦点。 |
60
+
61
+ 外观方面,`ogVariant="default"` 使用轻量下划线导航,`ogVariant="workspace"` 使用独立卡片页签;窄容器下操作区移至标签栏下方。
62
+
63
+ 受控更新不是乐观本地写入:`actionRequest` 先给出 `nextItems` 与 `nextActiveKey`,随后才分别发出更新建议;父组件不写回时,标签顺序和激活状态保持原样。空 `ogItems` 是合法受控状态并显示空文案。每个 `OgTabItem.key` 必须唯一,重复 key 会在渲染前抛出 `TypeError`,因此不能把它当作会被组件自动去重的用户输入。
64
+
65
+ `ogBeforeAction` 返回 `false` 时操作被拒绝且没有请求事件;抛错时发出 `operationError(context, error)`,两项参数分别为 `OgTabsActionContext` 和原始错误。启用 `ogFeatures.keyboard` 后,实际标签可用 Delete、Home、End、Shift+F10/ContextMenu 操作;拖拽排序仍需父组件接受 `update:ogItems` 才会生效,固定标签始终留在非固定标签前。
66
+
67
+ ## 路由工作区
68
+
69
+ 将路由保留在应用层。从路由工作区状态派生 items,响应 `activate` 进行导航,并在路由导航成功后才更新工作区。
70
+
71
+ ```vue
72
+ <script setup lang="ts">
73
+ import { computed, ref } from 'vue'
74
+ import { useRoute, useRouter } from 'vue-router'
75
+ import { OgTabs, type OgTabsActionContext, type OgTabItem } from 'origen-ui'
76
+
77
+ const router = useRouter()
78
+ const route = useRoute()
79
+ const busy = ref(false)
80
+ const tabs = ref<OgTabItem<string>[]>([{ key: '/home', label: 'Home', pinned: true }])
81
+ const activeKey = computed(() => route.fullPath)
82
+
83
+ async function beforeAction(context: OgTabsActionContext<string>) {
84
+ if (!context.operation.startsWith('close')) return true
85
+ return (
86
+ !context.targets?.some((tab) => tab.dirty) ||
87
+ window.confirm('Some pages have unsaved changes. Close them?')
88
+ )
89
+ }
90
+
91
+ async function applyRequest(context: OgTabsActionContext<string>) {
92
+ if (context.operation === 'activate' && context.nextActiveKey) {
93
+ busy.value = true
94
+ try {
95
+ await router.push(context.nextActiveKey)
96
+ } finally {
97
+ busy.value = false
98
+ }
99
+ return
100
+ }
101
+ if (context.operation.startsWith('close') && context.nextItems) {
102
+ tabs.value = [...context.nextItems]
103
+ if (context.nextActiveKey) await router.push(context.nextActiveKey)
104
+ }
105
+ }
106
+ </script>
107
+
108
+ <template>
109
+ <OgTabs
110
+ :og-items="tabs"
111
+ :model-value="activeKey"
112
+ :og-busy="busy"
113
+ og-variant="workspace"
114
+ :og-features="{ pin: true, finder: true }"
115
+ :og-context-menu="{ enabled: true }"
116
+ :og-before-action="beforeAction"
117
+ @action-request="applyRequest"
118
+ />
119
+ </template>
120
+ ```
121
+
122
+ 应用侧的路由监听器可将新访问的路由加入工作区。KeepAlive、路由守卫、持久化、未保存表单状态与鉴权均保留在 OgTabs 之外。
123
+
124
+ ## 操作策略:ogActionPolicy
125
+
126
+ `ogActionPolicy` 使用一个判别式对象选择允许或禁止模式,因此不存在两个列表同时配置时的优先级问题。
127
+
128
+ | Prop | 类型 | 默认值 | 说明 |
129
+ | ---------------- | ------------------------------------------------------------------ | ------ | -------------- |
130
+ | `ogActionPolicy` | `{ mode: 'allow' \| 'deny', actions: readonly OgTabsOperation[] }` | - | 单一操作策略。 |
131
+
132
+ 被策略拒绝的操作会触发 `operationDenied` 事件,原因为 `'policy'`。
133
+
134
+ `OgTabsOperation` 可选值:
135
+
136
+ ```ts
137
+ type OgTabsOperation =
138
+ | 'activate'
139
+ | 'add'
140
+ | 'close'
141
+ | 'close-others'
142
+ | 'close-left'
143
+ | 'close-right'
144
+ | 'close-all'
145
+ | 'refresh'
146
+ | 'pin'
147
+ | 'unpin'
148
+ | 'move'
149
+ | 'move-top'
150
+ | 'move-bottom'
151
+ ```
152
+
153
+ ### Controlled add flow
154
+
155
+ 将 `ogFeatures.add` 设为 `true` 可启用 Element Plus 原生新增入口。该入口本身不会创建标签。OgTabs 会在守卫通过后发出一次
156
+ `actionRequest`,其中 `operation: 'add'`、`source: 'native'`,且
157
+ `tab: undefined`;不会设置 `nextItems` 与 `nextActiveKey`。父组件需要分配唯一 key,将新的
158
+ `OgTabItem` 追加到 `ogItems`,并在需要激活新标签时设置
159
+ `modelValue`。调用暴露的 `requestAdd(source?)` 方法时,复用相同的守卫和事件链路,适合自定义按钮。
160
+
161
+ 用法示例:
162
+
163
+ ```vue
164
+ <!-- 仅允许激活和关闭操作 -->
165
+ <OgTabs :og-items="tabs" :og-action-policy="{ mode: 'allow', actions: ['activate', 'close'] }" />
166
+
167
+ <!-- 禁止固定和刷新操作 -->
168
+ <OgTabs
169
+ :og-items="tabs"
170
+ :og-action-policy="{ mode: 'deny', actions: ['pin', 'unpin', 'refresh'] }"
171
+ />
172
+ ```
173
+
174
+ ## 右键菜单配置:ogContextMenu
175
+
176
+ `ogContextMenu` 是 `OgTabsContextMenuOptions` 对象;省略时使用默认菜单,`enabled: false` 可禁用全部菜单触发:
177
+
178
+ ```ts
179
+ interface OgTabsContextMenuOptions {
180
+ enabled?: boolean
181
+ /** 需要从右键菜单中隐藏的操作列表 */
182
+ hiddenActions?: readonly OgTabsOperation[]
183
+ }
184
+ ```
185
+
186
+ 用法示例:
187
+
188
+ ```vue
189
+ <!-- 启用右键菜单但隐藏"关闭所有"和"关闭左侧" -->
190
+ <OgTabs :og-items="tabs" :og-context-menu="{ hiddenActions: ['close-all', 'close-left'] }" />
191
+ ```
192
+
193
+ ## 外观配置
194
+
195
+ | Prop | 类型 | 默认值 | 说明 |
196
+ | ------------------- | ------------------- | ------- | -------------------------------------------------------------------- |
197
+ | `ogSticky` | `boolean \| number` | `false` | 是否固定标签栏头部。传数字时指定固定偏移量(px)。 |
198
+ | `ogFinderThreshold` | `number` | `8` | 标签查找器自动显示的标签数量阈值。达到此数量或标签溢出时显示查找器。 |
199
+ | `ogThemeColor` | `string` | — | 自定义主题色,影响激活标签和交互元素的高亮颜色。 |
200
+ | `ogMinTabWidth` | `string \| number` | — | 单个标签页的最小宽度。 |
201
+ | `ogMaxTabWidth` | `string \| number` | — | 单个标签页的最大宽度。 |
202
+
203
+ ## OgTabItem 完整属性
204
+
205
+ | 属性 | 类型 | 默认值 | 说明 |
206
+ | ------------ | ------------------ | ------- | ----------------------------------------------------------------- |
207
+ | `key` | `string \| number` | — | **必填**。标签的唯一标识。 |
208
+ | `label` | `string` | — | **必填**。标签显示文本。 |
209
+ | `icon` | `Component` | — | 标签图标组件。 |
210
+ | `badge` | `string \| number` | — | 标签徽标,显示在标签文本旁。 |
211
+ | `status` | `OgTabsStatus` | — | 标签状态,可选 `'loading' \| 'success' \| 'warning' \| 'error'`。 |
212
+ | `statusIcon` | `Component` | — | 自定义状态图标组件。 |
213
+ | `remark` | `string` | — | 标签备注信息。 |
214
+ | `dirty` | `boolean` | `false` | 标记标签对应内容存在未保存更改。 |
215
+ | `disabled` | `boolean` | `false` | 禁用标签,不可激活或操作。 |
216
+ | `readonly` | `boolean` | `false` | 只读标签,不可关闭或移动。 |
217
+ | `closable` | `boolean` | `true` | 是否可关闭。 |
218
+ | `pinned` | `boolean` | `false` | 是否固定。固定标签始终显示在非固定标签之前。 |
219
+ | `pinnable` | `boolean` | `true` | 是否允许固定/取消固定操作。 |
220
+ | `draggable` | `boolean` | `true` | 是否允许拖拽移动。 |
221
+ | `lazy` | `boolean` | `false` | 延迟渲染标签内容,仅在标签首次激活时渲染。 |
222
+ | `data` | `TData` | — | 附加的业务数据,可在插槽和事件回调中访问。 |
223
+
224
+ ## Props
225
+
226
+ | 属性 | 类型 | 默认值 | 说明 |
227
+ | --------------------------------- | ----------------------------------------------------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------- |
228
+ | `v-model` | `TabKey \| undefined` | - | 当前激活标签。 |
229
+ | `ogItems` | `readonly OgTabItem[]` | - | 必填。受控标签列表。 |
230
+ | `ogVariant` / `ogDensity` | `'default' \| 'workspace'` / `'compact' \| 'default'` | `'default'` | 展示模式和密度。 |
231
+ | `ogRenderContent` | `boolean` | `true` | 是否渲染默认内容面板。 |
232
+ | `ogFeatures` | `OgTabsFeatures` | `{}` | 启用关闭、固定、拖拽、查找器等功能。 |
233
+ | `ogReadonly` / `ogBusy` | `boolean` | `false` | 禁止变更,或标记当前操作中。 |
234
+ | `ogTabsEvents` | `OgTabsNativeEvents<TKey>` | `{}` | 注册底层 Element Plus Tabs 事件回调;pane 名映射为公开 tab key。 |
235
+ | `ogLocale` | `Partial<OgTabsLocale>` | 中文预设 | 覆盖内置操作文案。 |
236
+ | `ogMinTabWidth` / `ogMaxTabWidth` | `string \| number` | - | 单个标签宽度约束。 |
237
+ | `ogThemeColor` | `string` | - | 工作区强调色。 |
238
+ | `ogSticky` | `boolean \| number` | - | 固定标签栏;数值为顶部偏移。 |
239
+ | `ogFinderThreshold` | `number` | `8` | 达到此数量时启用标签查找器。 |
240
+ | `ogContextMenu` | `OgTabsContextMenuOptions` | - | 右键菜单配置;省略时使用默认菜单,传 `{ enabled: false }` 禁用。 |
241
+ | `ogActionPolicy` | `OgTabsActionPolicy` | - | 显式的允许或拒绝操作策略。 |
242
+ | `ogBeforeAction` | `(context) => MaybePromise<boolean \| void>` | - | 操作前异步守卫;返回 `false` 取消操作。 |
243
+ | `ogActionHandler` | `(context: OgTabsActionContext<TKey, TData>) => MaybePromise<void \| OgTabsActionResult>` | - | 可选的异步操作执行器;受控集成用它提交 action,完成前标签保持 pending。详见[异步操作处理](#异步操作处理)。 |
244
+ | Element Plus props | `TabsProps` | - | `ElTabs` 官方普通属性直接放在组件顶层;`modelValue`、`beforeLeave`、`closable`、`editable`、`addable` 均由 OgTabs 状态工作流接管。 |
245
+
246
+ ## Expose API
247
+
248
+ `ogFeatures.add` 默认关闭。启用后,原生新增入口与
249
+ `requestAdd(source?)` 都会发出上文描述的受控 `add` action;父组件负责分配唯一
250
+ key,并更新 `ogItems` 与 `modelValue`。
251
+
252
+ 通过 `ref` 获取组件实例后,可调用以下方法:
253
+
254
+ | 方法 | 参数 | 返回值 | 说明 |
255
+ | ------------ | --------------------------- | ---------------------- | ------------------------------------------------------------------------------------ |
256
+ | `activate` | `(key, source?)` | `Promise<boolean>` | 激活指定标签。`source` 默认为 `'api'`。 |
257
+ | `close` | `(key, source?)` | `Promise<boolean>` | 关闭指定标签。会自动计算下一个激活标签。 |
258
+ | `closeScope` | `(scope, source?)` | `Promise<boolean>` | 按范围关闭标签。`scope` 可选 `'current' \| 'others' \| 'left' \| 'right' \| 'all'`。 |
259
+ | `pin` | `(key, source?)` | `Promise<boolean>` | 固定指定标签。 |
260
+ | `unpin` | `(key, source?)` | `Promise<boolean>` | 取消固定指定标签。 |
261
+ | `move` | `(key, targetKey, source?)` | `Promise<boolean>` | 将指定标签移动到目标标签位置。 |
262
+ | `moveTop` | `(key, source?)` | `Promise<boolean>` | 将指定标签移动到最顶部(非固定标签区域的起始位置)。 |
263
+ | `moveBottom` | `(key, source?)` | `Promise<boolean>` | 将指定标签移动到最底部。 |
264
+ | `refresh` | `(source?)` | `Promise<boolean>` | 刷新当前激活标签。 |
265
+ | `requestAdd` | `(source?)` | `Promise<boolean>` | 发出经过守卫的受控新增请求,不会在组件内部擅自生成标签状态。 |
266
+ | `scrollTo` | `(key)` | `void` | 将标签栏滚动到指定标签位置。 |
267
+ | `getItems` | `()` | `readonly OgTabItem[]` | 返回当前标签列表的只读副本。 |
268
+
269
+ 用法示例:
270
+
271
+ ```vue
272
+ <script setup lang="ts">
273
+ import { ref } from 'vue'
274
+ import { OgTabs, type OgTabsExpose } from '@origen-ui/tabs'
275
+
276
+ const tabsRef = ref<InstanceType<typeof OgTabs>>()
277
+
278
+ // 通过 Expose 调用方法
279
+ tabsRef.value?.activate('/settings')
280
+ tabsRef.value?.close('/old-page')
281
+ tabsRef.value?.closeScope('others')
282
+ tabsRef.value?.pin('/home')
283
+ ```
284
+
285
+ ## 事件
286
+
287
+ | 事件名 | 类型 | 说明 |
288
+ | ------------------- | ----------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
289
+ | `update:modelValue` | `(key: TKey \| undefined) => void` | 建议激活标签变更;空工作区时 key 为 `undefined`。父组件决定是否写回。 |
290
+ | `update:ogItems` | `(items: readonly OgTabItem<TKey, TData>[]) => void` | 建议不可变的标签列表变更。父组件决定是否写回。 |
291
+ | `actionRequest` | `(context: OgTabsActionContext) => void` | 操作被 `ogBeforeAction` 接受后发出。包含完整操作上下文。 |
292
+ | `closeRequest` | `(context: OgTabsActionContext) => void` | 关闭操作被接受后发出。 |
293
+ | `refreshRequest` | `(context: OgTabsActionContext) => void` | 刷新操作被接受后发出。 |
294
+ | `pinChangeRequest` | `(context: OgTabsActionContext) => void` | 固定/取消固定操作被接受后发出。 |
295
+ | `reorderRequest` | `(context: OgTabsActionContext) => void` | 拖拽排序操作被接受后发出。 |
296
+ | `tabClick` | `(pane: OgTabsPaneContext<TKey>, event: Event) => void` | 用户点击标签页时触发;pane 上的名称字段映射为公开 tab key。 |
297
+ | `tabChange` | `(key: TKey \| undefined) => void` | 激活标签切换时触发;pane 名映射为公开 key,未知名称为 `undefined`。 |
298
+ | `tabRemove` | `(key: TKey \| undefined) => void` | 标签移除时触发;pane 名映射为公开 key,未知名称为 `undefined`。 |
299
+ | `operationDenied` | `(operation: OgTabsOperation, tab: OgTabItem \| undefined, reason: OgTabsDeniedReason) => void` | 操作被拒绝时触发。`reason` 可选 `'busy' \| 'disabled' \| 'readonly' \| 'pinned' \| 'policy' \| 'boundary' \| 'not-found'`。 |
300
+ | `operationError` | `(context: OgTabsActionContext, error: unknown) => void` | `ogBeforeAction` 抛出错误时触发。 |
301
+
302
+ ## 插槽
303
+
304
+ | 插槽名 | 作用域参数 | 说明 |
305
+ | ------------------- | ------------------------------------- | --------------------------------------------------- |
306
+ | `default` | `{ tab: OgTabItem, active: boolean }` | 标签面板内容。`active` 表示当前标签是否为激活状态。 |
307
+ | `label` | `{ tab: OgTabItem, active: boolean }` | 自定义标签页标题内容。 |
308
+ | `tabBefore` | `{ tab: OgTabItem }` | 在标签标题之前(标签页内部右侧)插入自定义内容。 |
309
+ | `tabAfter` | `{ tab: OgTabItem }` | 在标签标题之后(标签页外部右侧)插入自定义内容。 |
310
+ | `status` | `{ tab: OgTabItem }` | 自定义标签状态图标。 |
311
+ | `contextMenuTop` | `OgTabsActionContext` | 在右键菜单顶部插入自定义内容。 |
312
+ | `contextMenuBottom` | `OgTabsActionContext` | 在右键菜单底部插入自定义内容。 |
313
+ | `header` | — | 在标签栏头部区域插入自定义内容。 |
314
+ | `extra` | — | 在标签栏额外区域插入自定义内容。 |
315
+ | `empty` | — | 当标签列表为空时显示的自定义内容。 |
316
+
317
+ ## 辅助工具函数
318
+
319
+ ## 全局配置与完整导出
320
+
321
+ ### 官方 Tabs 事件类型:`OgTabsNativeEvents`
322
+
323
+ 官方属性与业务属性类型:`OgTabsBusinessProps`、`OgTabsOwnedNativeProps`。
324
+
325
+ `ogTabsEvents` 用于传入 Element Plus Tabs 的官方事件回调;普通官方属性直接放在 OgTabs 顶层。官方属性和事件详情参考 Element Plus 官方文档。
326
+
327
+ `ogTabsEvents.tabClick` 收到的 pane context 中,`paneName`、`props.name` 与 `getVnode().props.name` 都映射为 `OgTabItem.key`。`tabChange`、`tabRemove` 和 `edit` 的 pane name 也映射为公开 key;无法匹配当前 `ogItems` 的原生名称映射为 `undefined`。`edit` 仅转发 `remove` action;开启 `ogFeatures.add` 后,原生新增入口通过 `actionRequest` 的 `operation: 'add'` 交给父组件受控处理。组件同时发出的 `tabClick`、`tabChange` 和 `tabRemove` 事件使用相同的公开 key 语义。
328
+
329
+ 官方事件 pane context 的类型为 `OgTabsPaneContext<TKey>`。
330
+
331
+ | 分类 | 导出 |
332
+ | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
333
+ | 组件与应用配置 | `OgTabs`、`createOgTabs`、`useOgTabsGlobalConfig`、`OgTabsGlobalConfig` |
334
+ | locale | `OG_TABS_LOCALE_EN_US`、`OG_TABS_LOCALE_ZH_CN`、`OG_TABS_LOCALE_ZH_TW` |
335
+ | 标签、动作与策略 | `OgTabItem`、`TabKey`、`OgTabsActionContext`、`OgTabsActionResult`、`OgTabsActionPolicy`、`OgTabsActionSource`、`OgTabsCloseScope`、`OgTabsDeniedReason`、`OgTabsOperation`、`OgTabsPaneContext` |
336
+ | 组件配置与实例 | `OgTabsContextMenuOptions`、`OgTabsDensity`、`OgTabsBusinessProps`、`OgTabsExpose`、`OgTabsFeatures`、`OgTabsInlineStyle`、`OgTabsLocale`、`OgTabsNativeEvents`、`OgTabsOwnedNativeProps`、`OgTabsProps`、`OgTabsSlots`、`OgTabsStatus`、`OgTabsVariant` |
337
+ | 控制器 | `OgTabsController`、`UseTabsControllerOptions` |
338
+
339
+ `createOgTabs(options?)` 安装应用级默认配置,`useOgTabsGlobalConfig()` 读取解析后的配置;精确根入口符号为 `createOgTabs`、`useOgTabsGlobalConfig` 和 `OgTabsGlobalConfig`。实例 Props 和 `locale` 的显式值优先于全局配置。根入口同时导出 `OG_TABS_LOCALE_EN_US`、`OG_TABS_LOCALE_ZH_CN`、`OG_TABS_LOCALE_ZH_TW`。
340
+
341
+ 根组件 `OgTabs` 的用法、Props、事件、插槽与 Expose 以本页前述章节为准。
342
+
343
+ 公开类型还包括 `OgTabItem`、`OgTabsActionContext`、`OgTabsActionResult`、`OgTabsActionPolicy`、`OgTabsActionSource`、`OgTabsCloseScope`、`OgTabsContextMenuOptions`、`OgTabsDeniedReason`、`OgTabsDensity`、`OgTabsExpose`、`OgTabsFeatures`、`OgTabsInlineStyle`、`OgTabsLocale`、`OgTabsNativeEvents`、`OgTabsOperation`、`OgTabsOwnedNativeProps`、`OgTabsProps`、`OgTabsSlots`、`OgTabsStatus`、`OgTabsVariant`、`TabKey`、`OgTabsController`、`TabsControllerPorts` 和 `UseTabsControllerOptions`。本页上方的 Props、事件、插槽、Expose 和辅助函数表是这些类型的使用入口。
344
+
345
+ 以下工具函数从 `@origen-ui/tabs` 导出,可在应用层直接使用:
346
+
347
+ ### 查询与过滤
348
+
349
+ | 函数 | 签名 | 说明 |
350
+ | ------------------------ | ---------------------------------------- | ------------------------------------------------------------- |
351
+ | `findTab` | `(items, key) => OgTabItem \| undefined` | 根据 `key` 查找单个标签。 |
352
+ | `filterTabs` | `(items, query?) => OgTabItem[]` | 按关键词过滤标签,结果自动排序(固定标签在前)。 |
353
+ | `orderTabs` | `(items) => OgTabItem[]` | 对标签排序,固定标签在前、非固定标签在后。 |
354
+ | `hasDuplicateKeys` | `(items) => boolean` | 检查标签列表中是否存在重复的 `key`。 |
355
+ | `createTabStateRevision` | `(items, activeKey) => string` | Builds a stable revision for async action stale-state checks. |
356
+
357
+ ### 操作判断
358
+
359
+ | 函数 | 签名 | 说明 |
360
+ | ------------- | ------------------ | --------------------------------------------------------- |
361
+ | `canCloseTab` | `(tab) => boolean` | 判断标签是否可关闭(非禁用、非只读、非固定、closable)。 |
362
+ | `canPinTab` | `(tab) => boolean` | 判断标签是否可固定(非禁用、非只读、pinnable)。 |
363
+ | `canMoveTab` | `(tab) => boolean` | 判断标签是否可移动(非禁用、非只读、非固定、draggable)。 |
364
+
365
+ ### 状态变更
366
+
367
+ | 函数 | 签名 | 说明 |
368
+ | ------------------------ | ------------------------------------------------------ | ------------------------------------------------------------ |
369
+ | `moveTab` | `(items, key, targetKey) => OgTabItem[]` | 将 `key` 标签移动到 `targetKey` 标签位置,返回新数组。 |
370
+ | `moveTabToEdge` | `(items, key, edge: 'top' \| 'bottom') => OgTabItem[]` | 将标签移动到最顶部或最底部。 |
371
+ | `setTabPinned` | `(items, key, pinned) => OgTabItem[]` | 设置标签固定状态,自动调整位置,返回新数组。 |
372
+ | `removeTabs` | `(items, keys: Set) => OgTabItem[]` | 批量移除指定 `key` 的标签,返回新数组。 |
373
+ | `getCloseScopeTabs` | `(items, key, scope) => OgTabItem[]` | 获取指定关闭范围内的可关闭标签列表。 |
374
+ | `resolveNextActive` | `(items, remaining, closedKey) => TabKey \| undefined` | 关闭标签后计算下一个应激活的标签。优先向右查找,再向左查找。 |
375
+ | `operationForCloseScope` | `(scope) => OgTabsOperation` | 将关闭范围映射为对应的操作名称。 |
376
+
377
+ ### 组合式函数
378
+
379
+ | 函数 | 签名 | 说明 |
380
+ | ------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
381
+ | `useTabsController` | `(options: UseTabsControllerOptions) => OgTabsController` | 内部组合式函数,封装完整的标签操作控制逻辑,包括 `dispatch`、`closeScopeAt`、`refreshAt`、`moveBefore` 等扩展方法。 |
382
+
383
+ ### Tabs controller contract
384
+
385
+ | 类型 | 说明 |
386
+ | --------------------- | --------------------------------------- |
387
+ | `TabsControllerPorts` | 控制器读取受控 Tab 状态的最小端口集合。 |
388
+
389
+ 原始事件名与 TypeScript 监听使用 camelCase(如 `actionRequest`、`operationError`、`tabChange`);Vue 模板继续使用 `@action-request`、`@operation-error`、`@tab-change`。原始 emit 键仅发出 camelCase 一次,无旧名别名;`update:modelValue` / `update:ogItems`、操作标识及载荷不变。`operationError` 始终传递 `(context, error)` 两项参数。
390
+
391
+ ## 相关组合示例
392
+
393
+ 将标签状态接入动态路由、菜单和缓存时,查看 [Router 适配器](./router.md)与[工作区场景](../../.agents/skills/admin-component-usage/references/component-directory.md)。
394
+
395
+ <!-- component-contract:start -->
396
+
397
+ ## 公共契约
398
+
399
+ > 由组件目录生成;每条记录对应可公开导入的组件及其消费者 API 摘要。
400
+
401
+ ### Imports
402
+
403
+ - `tabs`: `import { OgTabs } from '@origen-ui/tabs'`
404
+
405
+ ### Props
406
+
407
+ - `tabs`: `modelValue`, `ogItems`, `ogVariant`, `ogFeatures`, `ogContextMenu`, `ogActionPolicy`, `ogDensity`, `ogRenderContent`, `ogReadonly`, `ogBusy`, `ogTabsEvents`, `ogLocale`, `ogMinTabWidth`, `ogMaxTabWidth`, `ogThemeColor`, `ogSticky`, `ogFinderThreshold`, `ogBeforeAction`, `ogActionHandler`
408
+
409
+ ### Events
410
+
411
+ - `tabs`: `update:modelValue`, `update:ogItems`, `actionRequest`, `closeRequest`, `refreshRequest`, `pinChangeRequest`, `reorderRequest`, `operationDenied`, `operationError`, `tabClick`, `tabChange`, `tabRemove`
412
+
413
+ ### Slots
414
+
415
+ - `tabs`: `default`, `label`, `tabBefore`, `tabAfter`, `status`, `contextMenuTop`, `contextMenuBottom`, `header`, `extra`, `empty`
416
+
417
+ ### Exposes
418
+
419
+ - `tabs`: `getNativeTabs`, `requestAdd`, `close`, `activate`, `closeScope`, `pin`, `unpin`, `move`, `moveTop`, `moveBottom`, `refresh`, `scrollTo`, `getItems`
420
+
421
+ ### Types
422
+
423
+ - `tabs`:属性类型:`OgTabsProps`;公开方法类型:无
424
+
425
+ <!-- component-contract:end -->
426
+
427
+ ### 异步操作处理
428
+
429
+ `ogActionHandler` 在 `actionRequest` 之后运行,并且可以返回 Promise。Promise 完成前,
430
+ `pending` 和 `aria-busy` 会保持激活;此期间再次操作会以 `busy` 原因拒绝。如果处理函数等待
431
+ 期间受控的 `ogItems` 或 `modelValue` 发生变化,过期的更新提议会被丢弃。路由集成应在此处理函数
432
+ 中执行导航和工作区写入,避免失败的路由创建标签页。
433
+
434
+ ## 应用默认配置的快照与迁移
435
+
436
+ `createOgTabs(config)` 每次安装时复制并冻结根配置、features、nativeProps、locale、contextMenu 及 hiddenActions 数组。`localeSource` 保持原对象;nativeProps 内的回调及原生嵌套值保持原值。
437
+
438
+ 这是 major 语义变化:安装后修改原始对象或注入配置,不再更新上述静态默认值。工厂创建后、安装前的修改仍会进入该次安装的快照;重复安装同一插件到不同应用会生成不同配置容器。调用者原对象保持可变。公开读取类型与实际冻结层级一致;保留身份的运行时对象及第三方嵌套值不承诺深层不可变。
439
+
440
+ 动态展示/行为改为绑定实例 props;动态语言通过原有语言源的 `.value` 更新。显式静态 locale 覆盖相应语言源文案、实例配置继续按组件既有优先级覆盖应用默认值。无需兼容别名、双写或重复安装插件。