@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,349 @@
1
+ ---
2
+ title: OgUpload
3
+ description: 基于适配器的企业级上传组件,支持校验、重试、文件操作与稳定的值模型。
4
+ ---
5
+
6
+ # OgUpload
7
+
8
+ `OgUpload` 是为业务应用设计的适配器优先(adapter-first)上传组件。它将传输细节隔离在组件之外,同时提供校验、并发控制、重试、进度、取消、移除、预览与下载能力。
9
+
10
+ ## 基础用法
11
+
12
+ ```bash
13
+ pnpm add @origen-ui/upload element-plus
14
+ ```
15
+
16
+ ```ts
17
+ import { OgUpload } from '@origen-ui/upload'
18
+ import '@origen-ui/upload/style.css'
19
+ ```
20
+
21
+ 应用已使用 `origen-ui` 聚合包时,可从中引入:
22
+
23
+ ```ts
24
+ import { OgUpload } from 'origen-ui'
25
+ import 'origen-ui/upload.css'
26
+ ```
27
+
28
+ ## 传输适配器
29
+
30
+ `adapter` 是唯一的传输边界。`upload` 接收文件、`AbortSignal`、尝试次数与 `onProgress`。请求特有的元数据应放在适配器实现内部。它可与 fetch、Axios、OSS SDK、预签名上传或 multipart 协议配合使用。
31
+
32
+ ```ts
33
+ import type { OgUploadAdapter } from '@origen-ui/upload'
34
+
35
+ interface UploadResponse {
36
+ data: { url: string }
37
+ }
38
+
39
+ const adapter: OgUploadAdapter<UploadResponse> = {
40
+ upload: async ({ file, signal, onProgress }) => {
41
+ const response = await uploadToOss(file, { signal, onProgress })
42
+ return { data: { url: response.url } }
43
+ },
44
+ remove: ({ file, signal }) => deleteStoredFile(file.url!, { signal }),
45
+ }
46
+
47
+ const resolveResponse = ({ response }: { response: UploadResponse }) => ({
48
+ url: response.data.url,
49
+ })
50
+ ```
51
+
52
+ 对于常规 HTTP 端点,可显式使用 `createXhrUploadAdapter(options)` 构建同样的适配器。该工厂把 XHR 专属细节隔离在组件之外,同时保留原生进度上报。
53
+
54
+ 组件卸载时会通过各操作已接收的 `AbortSignal` 中止其拥有的所有进行中的操作(包括适配器的 `preview` 与 `download`),适配器可据此取消底层任务;此前卸载仅会中止移除操作。
55
+
56
+ ## 典型用法
57
+
58
+ <div id="upload-adapter"></div>
59
+ ### 适配器上传
60
+
61
+ 演示适配器模拟上传进度,并返回持久的文件 URL。
62
+
63
+ <div id="upload-manual-response"></div>
64
+ <div id="upload-manual-queue"></div>
65
+ <div id="upload-response-map"></div>
66
+ ### 手动队列与服务端响应映射
67
+
68
+ 合并手动提交、文件校验和服务端响应映射,覆盖失败、重试和移除。
69
+
70
+ ## 高级能力
71
+
72
+ ## 值模型
73
+
74
+ | `ogValueType` | `v-model` 值 | 使用场景 |
75
+ | ------------- | ---------------- | ------------------------------ |
76
+ | `fileList` | `OgUploadFile[]` | 保留状态、响应与自定义元数据。 |
77
+ | `url` | `string` | 单个持久化文件 URL。 |
78
+ | `urls` | `string[]` | 多个持久化文件 URL。 |
79
+
80
+ 对于业务后端值(例如 `BackendFile[]`),使用 `ogValueCodec` 集中完成业务值与
81
+ `OgUploadFile[]` 的双向映射。`decode` 必须能处理初始的 `undefined` 值;
82
+ `ogValueType` 与 `ogValueCodec` 互斥,不能同时提供。
83
+
84
+ `ogValueCodec` 只负责业务值与文件记录的结构归一化:成功文件可以没有
85
+ `url`,自定义协议 URL 也会原样交给 `adapter.preview` / `adapter.download`。
86
+ 没有适配器时,组件的浏览器 fallback 仅允许 `http`、`https` 与 `blob` URL;
87
+ 缺失或不安全的 URL 会触发 `operationError`,不会执行导航。
88
+
89
+ ```ts
90
+ import { defineOgUploadValueCodec } from '@origen-ui/upload'
91
+
92
+ const attachmentCodec = defineOgUploadValueCodec<BackendFile[]>({
93
+ decode: (value) =>
94
+ (value ?? []).map((file) => ({
95
+ uid: file.id,
96
+ name: file.name,
97
+ status: 'success',
98
+ url: file.url,
99
+ })),
100
+ encode: (files) =>
101
+ files.map((file) => ({
102
+ id: file.uid,
103
+ name: file.name,
104
+ url: file.url ?? '',
105
+ })),
106
+ })
107
+ ```
108
+
109
+ `createOgUpload({ valueCodec })` 可安装应用级默认 codec。组件 `ogValueCodec`
110
+ 优先;显式传入 `ogValueType` 会选择内置值模型并忽略应用级 codec,因此单个 URL
111
+ 字段不会被全局业务映射意外影响。
112
+
113
+ ## 关键 props
114
+
115
+ | Prop | 说明 |
116
+ | -------------------------------- | --------------------------------------------------- |
117
+ | `ogVariant` | `button`、`drag` 或 `picture-card`。 |
118
+ | `accept` / `ogMaxSize` / `limit` | 官方文件类型过滤与数量上限、业务字节大小上限。 |
119
+ | `ogBeforeUpload` | 入队前校验或替换所选 `File`。 |
120
+ | `ogConcurrency` | 最大并发传输数,默认 `3`。 |
121
+ | `ogRetry` | `false` 或 `{ maxAttempts, delay, backoff }`。 |
122
+ | `ogAutoUpload` | 设为 `false` 可将文件入队并以命令式方式提交。 |
123
+ | `ogConfirmRemove` | 确认服务端删除,默认 `true`。 |
124
+ | `directory` / `name` | Element Plus 文件选择属性,直接放在 OgUpload 顶层。 |
125
+
126
+ `ogVariant="button"` 适合紧凑表单和普通文件选择;按钮文字可通过 `ogText` 覆盖。
127
+ `ogVariant="drag"` 适合大面积拖放,整个拖拽面负责点击、Tab 聚焦、Enter/Space 选择和文件放置;
128
+ 拖入文件时会同步显示边框、背景、图标和文字高亮,禁用后不会响应这些操作。内置入口由外层
129
+ `.el-upload` 提供唯一的键盘目标,避免交互元素嵌套;使用自定义 `default` slot 时也应保持这一约束。
130
+ `ogVariant="picture-card"` 适合图片或附件缩略图场景,入口、文件卡片和缩略图默认保持 `96px`
131
+ 方形尺寸。选择本地图片后会立即使用组件内部的临时 `blob:` 地址预览,上传成功后自动优先切换为
132
+ 安全的服务端 URL;入口和卡片在桌面端同排展示,窄屏空间不足时自动换行。无法识别为图片、缺少
133
+ `raw` 文件时显示文档图标;不安全的服务端 URL 不会直接渲染,若仍有本地图片则继续使用本地预览,
134
+ 临时预览地址不会写入 `v-model` 或事件负载。点击图片缩略图会在当前页面打开可缩放的大图查看器,
135
+ 支持多图切换、Enter/Space、Escape 和遮罩关闭;禁用状态不会打开查看器。缩略图查看器不调用
136
+ `adapter.preview`,文件操作区的“预览”按钮仍按原有规则调用 `adapter.preview` 或安全 URL fallback,
137
+ 适合需要服务端或自定义预览处理的场景。
138
+
139
+ 组件事件契约由导出的静态 `OgUploadEmits` 类型声明:语义事件 `change`、`progress`、`upload-success` 与 `remove-success`;操作失败触发 `operation-error`;选择校验触发 `validation-error`;`update:modelValue` 同步受控值,`exceed` 报告超限。事件名称与负载结构保持稳定,所有事件负载均为浅冻结的不可变快照(嵌套的 `raw`/`response`/`meta` 等引用与适配器或域对象共享;codec 编码产生的 `update:modelValue` 值按 codec 原样透传)。`update:modelValue` 与 `change` 仅在受控列表的提交转移(新增、状态转移、移除、清空)时触发;传输进度只通过 `progress` 事件与渲染中的文件列表流动,不会在进度tick之间重写受控模型。相应地,`getFiles()` 与 `change` 快照在传输期间携带已提交的百分比(传输中为 0,成功后为 100),传输期间的实时值请监听 `progress`。模板 ref 暴露 `submit`、`abort`、`retry`、`remove`、`clearFiles`、`getFiles` 与 `validate` 方法;暴露的 `getFiles()`/`submit()` 结果与传给适配器 `remove`/`preview`/`download` 上下文的文件对象均为冻结快照。
140
+
141
+ `OgUploadFile` 继续作为受控输入记录使用;事件、插槽、适配器操作上下文以及 `getFiles()`/`submit()` 返回值仍使用 `OgUploadFile`,运行时会提供浅冻结副本。嵌套的 `raw`、`response`、`meta`、`error` 与 `cause` 引用保持现有共享语义。
142
+
143
+ `ogBeforeUpload` 接收的 `files` 同样是浅冻结的数组和记录副本;修改这些记录不会改变组件内部状态。嵌套的文件和业务数据引用保持共享且不会被冻结。
144
+
145
+ 手动队列示例保留原生文件选择,因此类型、大小、数量和重复选择都由真实 `File` 与 `validation-error` / `exceed` 事件驱动。选择同一文件且 `ogDuplicate="reject"` 时得到 `duplicate` 错误;官方 `limit` 是数量上限,不能用不存在的 `maxCount` Prop 替代。响应映射示例则由父组件提供已成功的受控文件记录,实际调用 adapter 的 `preview`、`download`、`remove`:任一拒绝都会以对应操作和稳定错误码进入 `operation-error`,去掉失败开关后可重新执行。组件卸载会中止上传和所有进行中的文件操作;适配器须监听自己的 `signal`,重新挂载后是一个可操作的新实例。
146
+
147
+ 删除确认由发起操作的 `OgUpload` 实例管理;同一时刻最多显示一个 OgUpload 删除确认。取消、清空或卸载会关闭所属确认并释放该限制,不会关闭应用中的其他 Element Plus MessageBox。
148
+
149
+ ## API
150
+
151
+ ## 完整 API 参考
152
+
153
+ ### 官方 Upload 事件类型:`OgUploadNativeEvents`
154
+
155
+ `ogUploadEvents` 只接受文件选择阶段可触发的 Element Plus `change` 回调;上传、移除、预览和超限流程由适配器与队列工作流管理。该回调签名参考 Element Plus 官方文档,普通官方属性直接放在根层;传输请求和文件列表由组件工作流接管,不能通过原生属性透传入口覆盖。
156
+
157
+ ### 根入口公开导出
158
+
159
+ | 分类 | 导出 |
160
+ | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
161
+ | 组件/工厂 | `OgUpload`、`createOgUpload`、`createXhrUploadAdapter`、`defineOgUploadValueCodec` |
162
+ | locale | `OG_UPLOAD_LOCALE_EN_US`、`OG_UPLOAD_LOCALE_ZH_CN`、`OG_UPLOAD_LOCALE_ZH_TW` |
163
+ | 核心类型 | `OgUploadProps`、`OgUploadRuntimeProps`、`OgUploadExpose`、`OgUploadEmits`、`OgUploadSlots`、`OgUploadStatus`、`OgUploadVariant` |
164
+ | 文件与操作 | `OgUploadFile`、`OgUploadFileActionContext`、`OgUploadBatchResult`、`OgUploadOperationError`、`OgUploadError`、`OgUploadErrorCode` |
165
+ | 适配器与上下文 | `OgUploadAdapter`、`OgUploadUploadContext`、`OgUploadValidationContext`、`OgUploadResponseContext`、`OgUploadResponseMapper`、`XhrUploadAdapterOptions` |
166
+ | 值模型与配置 | `OgUploadValueType`、`OgUploadValueCodec`、`OgUploadValueFor`、`OgUploadGlobalConfig`、`OgUploadLocale`、`OgUploadLocaleOverrides`、`OgUploadRetryOptions`、`OgUploadBeforeUpload`、`OgUploadBusinessProps`、`OgUploadManagedNativeProps`、`OgUploadOwnedNativeProps` |
167
+
168
+ `OgUploadErrorCode` 是业务处理错误的稳定判别值;展示文案应使用 `error.message` 或 locale,不要依赖内部异常文本。`OgUploadExpose` 的方法和返回值见下方 Expose 表,`XhrUploadAdapterOptions` 仅在使用 XHR 工厂时适用。
169
+
170
+ ### 状态、错误码与 XHR 工厂
171
+
172
+ `OgUploadStatus` 为 `ready`、`uploading`、`success` 或 `fail`。`ogValueType` 与
173
+ `ogValueCodec` 互斥:前者在内置 `fileList`、`url`、`urls` 投影间选择,后者为自定义业务值
174
+ 提供双向编解码;公开 TypeScript Props 以判别联合拒绝两者同时传入。
175
+
176
+ | `OgUploadErrorCode` | 触发场景 |
177
+ | ------------------------------ | --------------------------------------------------- |
178
+ | `aborted` | 上传被 `abort`、文件移除或组件卸载取消。 |
179
+ | `duplicate` / `limit` | 所选文件重复,或会超出 `limit`。 |
180
+ | `missing-adapter` | 原始文件进入上传队列但未提供 `adapter`。 |
181
+ | `missing-url` | `url`/`urls` 值模型或浏览器预览、下载缺少可用 URL。 |
182
+ | `preview` | 预览适配器失败;原始异常保留在 `error.cause`。 |
183
+ | `download` | 下载适配器失败;原始异常保留在 `error.cause`。 |
184
+ | `remove` | 适配器的服务端删除操作失败。 |
185
+ | `size` / `type` / `validation` | 文件大小、MIME 接受规则或 `beforeUpload` 校验失败。 |
186
+ | `upload` | 适配器上传请求失败。 |
187
+
188
+ 预览和下载优先调用 `adapter.preview` / `adapter.download`。适配器拒绝时,
189
+ `operation-error` 的 `error.code` 分别为 `preview` 或 `download`,原始异常保留在
190
+ `error.cause`;组件自身执行浏览器 fallback 时,如果缺少 URL 或 URL 协议不安全,才使用
191
+ `missing-url`,不会执行导航或下载。
192
+
193
+ ```vue
194
+ <OgUpload @operation-error="handleOperationError" />
195
+ ```
196
+
197
+ ```ts
198
+ import type { OgUploadOperationError } from '@origen-ui/upload'
199
+
200
+ function handleOperationError({ operation, file, error }: OgUploadOperationError): void {
201
+ if (error.code === 'preview' || error.code === 'download') {
202
+ reportOperationFailure(operation, file.uid, error.cause)
203
+ return
204
+ }
205
+ if (error.code === 'missing-url') {
206
+ showMessage(`${file.name} 没有可用的安全 URL`)
207
+ }
208
+ }
209
+ ```
210
+
211
+ `operation-error` 的事件名称、`operation`、`file` 和 `error` 结构保持不变;展示文案应使用
212
+ `error.message`,业务分支使用稳定的 `error.code`。
213
+
214
+ `createXhrUploadAdapter(options)` 的 `action` 必填;其余选项是 `method`(默认
215
+ `POST`)、`headers`、`data`(`string`、`Blob` 或 `File` 的表单字段)、`fieldName`
216
+ (默认 `file`)和 `withCredentials`(默认 `false`)。成功响应在 `Content-Type` 含
217
+ `json` 时尝试解析 JSON,否则返回响应文本;上传进度最高上报为 99,成功后由组件提交为 100。
218
+
219
+ ### Props
220
+
221
+ | Prop | Type | Default | Description |
222
+ | --------------------------------- | --------------------------------------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
223
+ | `modelValue` / `ogValueType` | `OgUploadValueFor<...>` / `'fileList' \| 'url' \| 'urls'` | `fileList` | 受控值及其投影模式;自定义 codec 使用 `ogValueCodec`。 |
224
+ | `ogVariant` | `'button' \| 'drag' \| 'picture-card'` | `'button'` | 上传触发器呈现形式。 |
225
+ | `ogAdapter` / `ogResolveResponse` | `OgUploadAdapter` / `OgUploadResponseMapper` | - | 自定义上传传输与响应映射。`ogAdapter` 类型上可选;原始文件需要传输时必须提供,否则触发 `missing-adapter`。XHR 场景使用 `createXhrUploadAdapter`。 |
226
+ | `accept` / `ogMaxSize` / `limit` | `string` / `number` | - | Element Plus 文件类型/数量属性与业务字节大小上限。 |
227
+ | `ogAutoUpload` / `ogConcurrency` | `boolean` / `number` | `true` / `3` | 选择后自动开始上传,并限制并行传输数量。 |
228
+ | `ogBeforeUpload` | `OgUploadBeforeUpload` | - | 校验、拒绝或替换所选文件。 |
229
+ | `ogConfirmRemove` / `disabled` | `boolean` | `true` / `false` | 确认移除并禁用全部交互;`disabled` 保留 Element Plus 官方名称。 |
230
+ | `ogDuplicate` | `'allow' \| 'reject'` | `'reject'` | 重复文件策略。 |
231
+ | `multiple` / `showFileList` | `boolean` | `false` / `true` | Element Plus 官方属性:支持多选并渲染内置文件列表。 |
232
+ | `ogRetry` | `false \| OgUploadRetryOptions` | `false` | 重试失败的上传。 |
233
+ | `directory` / `name` | Element Plus `UploadProps` | - | 直接放在组件顶层的官方文件选择属性。 |
234
+ | `ogUploadEvents` | `OgUploadNativeEvents` | - | 提供文件选择阶段可达的官方 `change` 回调;回调参数参考官方文档。 |
235
+ | `ogLocale` / `ogText` / `ogTip` | display options | locale default / - | 覆盖文案、触发器文本与辅助文本。 |
236
+
237
+ 除由 OgUpload 工作流接管的官方属性外,Element Plus 普通 `UploadProps` 直接放在组件顶层;`directory`、`name`、`accept`、`disabled`、`multiple`、`limit`、`showFileList` 等均保留官方名称。`ogUploadEvents` 只开放选择阶段可达的官方 `change` 回调。OgUpload 的传输、队列及文件列表由 adapter 和组件自身管理,对应行为请使用 `ogBeforeUpload`、`exceed`、`progress`、`uploadSuccess`、`removeSuccess` 和 `operationError`。
238
+
239
+ ### 兼容边界
240
+
241
+ 已移除的 `getNativeUpload()` 暴露、`uploadProps`/`uploadEvents` 属性包,以及组件级未加 `og` 前缀的业务属性(如 `adapter`、`valueType`、`valueCodec`)不会重新启用。`createOgUpload()` 的应用级配置键(包括 `adapter`、`valueCodec`、`retry` 等默认配置)继续支持;`fileList`/`url`/`urls`、XHR 常见响应映射、adapter 预览/下载、安全浏览器 URL fallback、原生 `directory`/`name`/`accept`/`limit`/`multiple` 转发,以及 `button`/`drag`/`picture-card` 三种正式 variant 保持有效。
242
+
243
+ ### 事件
244
+
245
+ | Event | Payload | Description |
246
+ | ------------------- | ------------------------------- | -------------------------------------------------------------- |
247
+ | `update:modelValue` | `OgUploadValueFor<...>` | 受控值更新。 |
248
+ | `change` | `readonly OgUploadFile[]` | 任意文件列表变化。 |
249
+ | `exceed` | `{ files, limit }` | 添加文件将超过 `limit`。 |
250
+ | `progress` | `{ file, percentage }` | 传输上报进度。 |
251
+ | `uploadSuccess` | `OgUploadFile` | 文件上传成功。模板中使用 `@upload-success` 监听。 |
252
+ | `removeSuccess` | `OgUploadFile` | 文件移除成功。使用 `@remove-success` 监听。 |
253
+ | `validationError` | `{ file: OgUploadFile, error }` | 文件选择校验失败。使用 `@validation-error` 监听。 |
254
+ | `operationError` | `OgUploadOperationError` | 上传、移除、预览或下载操作失败。使用 `@operation-error` 监听。 |
255
+
256
+ ### 插槽与暴露
257
+
258
+ | Slot | Scope | Description |
259
+ | --------------- | ----------------------------------------------------------- | ------------------ |
260
+ | `default` | `{ disabled }` | 自定义上传触发器。 |
261
+ | `file` | `{ file, submit, retry, abort, remove, preview, download }` | 自定义文件列表项。 |
262
+ | `empty` / `tip` | - | 空列表与辅助内容。 |
263
+
264
+ | Method | Return | Description |
265
+ | ----------------------------- | ---------------------------------- | ----------------------------------------------------------------- |
266
+ | `submit()` | `Promise<OgUploadBatchResult>` | 上传所有已入队文件。 |
267
+ | `abort(uid?)` | `void` | 中止指定文件;省略 `uid` 时中止所有进行中、排队或等待重试的文件。 |
268
+ | `retry(uid)` | `void` | 重新排队指定的非上传中文件;`uid` 必填。 |
269
+ | `remove(uid)` | `Promise<boolean>` | 移除单个文件,遵循确认与适配器钩子。 |
270
+ | `clearFiles()` / `getFiles()` | `void` / `readonly OgUploadFile[]` | 清空或读取文件列表。 |
271
+ | `validate()` | `boolean` | 校验当前文件列表。 |
272
+
273
+ `OgUpload` 不暴露 Element Plus Upload 原生实例;需要编排上传流程时使用上表中
274
+ typed 的 `submit`、`abort`、`retry`、`remove`、`clearFiles`、`getFiles` 与
275
+ `validate` 方法。
276
+
277
+ ## OgForm 字段
278
+
279
+ OgForm 使用相同的判别式控件入口。上传的值模式、适配器、响应映射器与全部上传专属选项放在 `field.ogControl` 中;字段层继续负责标签、校验、权限与布局。
280
+
281
+ ```ts
282
+ const fields = [
283
+ {
284
+ prop: 'attachments',
285
+ label: '附件',
286
+ ogControl: {
287
+ ogType: 'upload',
288
+ ogValueType: 'urls',
289
+ ogAdapter: adapter,
290
+ ogResolveResponse: resolveResponse,
291
+ multiple: true,
292
+ ogRetry: { maxAttempts: 2 },
293
+ ogVariant: 'drag',
294
+ },
295
+ },
296
+ ]
297
+ ```
298
+
299
+ ## Locale 子路径
300
+
301
+ `@origen-ui/upload/locale` 提供根入口相同的三份 locale 常量与 `OgUploadLocaleOverrides` 类型,以及以下合并函数:
302
+
303
+ | 导出 | 签名 | 行为 |
304
+ | --------------------- | ----------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
305
+ | `mergeOgUploadLocale` | `(base: OgUploadLocale, ...overrides: Array<OgUploadLocaleOverrides \| undefined>) => OgUploadLocale` | 按参数顺序合并文案,后面的覆盖值优先;递归复制普通对象并保留函数文案,不修改传入对象。 |
306
+
307
+ ## 相关组合示例
308
+
309
+ 在 Schema 表单中使用上传字段时,查看 [OgForm](./form.md);页面级队列组合见[表单与输入场景](../../.agents/skills/admin-component-usage/references/component-directory.md)。
310
+
311
+ <!-- component-contract:start -->
312
+
313
+ ## 公共契约
314
+
315
+ > 由组件目录生成;每条记录对应可公开导入的组件及其消费者 API 摘要。
316
+
317
+ ### Imports
318
+
319
+ - `upload`: `import { OgUpload, createXhrUploadAdapter } from '@origen-ui/upload'`
320
+
321
+ ### Props
322
+
323
+ - `upload`: `modelValue`, `ogAdapter`, `ogValueType`, `ogValueCodec`, `accept`, `limit`, `ogAutoUpload`, `ogBeforeUpload`, `ogConcurrency`, `ogConfirmRemove`, `ogDuplicate`, `ogLocale`, `ogMaxSize`, `ogResolveResponse`, `ogRetry`, `ogText`, `ogTip`, `ogUploadEvents`, `ogVariant`
324
+
325
+ ### Events
326
+
327
+ - `upload`: `operationError`, `uploadSuccess`, `update:modelValue`, `change`, `exceed`, `progress`, `removeSuccess`, `validationError`
328
+
329
+ ### Slots
330
+
331
+ - `upload`: `default`, `empty`, `file`, `tip`
332
+
333
+ ### Exposes
334
+
335
+ - `upload`: `submit`, `clearFiles`, `abort`, `getFiles`, `remove`, `retry`, `validate`
336
+
337
+ ### Types
338
+
339
+ - `upload`:属性类型:`OgUploadProps`;公开方法类型:`OgUploadExpose`
340
+
341
+ <!-- component-contract:end -->
342
+
343
+ ## 应用默认配置的快照与迁移
344
+
345
+ `createOgUpload(config)` 每次安装时复制并冻结根配置、locale、locale.errors 和 retry 配置。adapter、valueCodec、resolveResponse、localeSource 及文案函数保留身份;不会冻结适配器或代理其内部状态,上传、进度、取消、重试和编解码流程保持原契约。
346
+
347
+ 这是 major 语义变化:安装后修改原始对象或注入配置,不再更新上述静态默认值。工厂创建后、安装前的修改仍会进入该次安装的快照;重复安装同一插件到不同应用会生成不同配置容器。调用者原对象保持可变。公开读取类型与实际冻结层级一致;保留身份的运行时对象及第三方嵌套值不承诺深层不可变。
348
+
349
+ 动态展示/行为改为绑定实例 props;动态语言通过原有语言源的 `.value` 更新。显式静态 locale 覆盖相应语言源文案、实例配置继续按组件既有优先级覆盖应用默认值。无需兼容别名、双写或重复安装插件。
@@ -0,0 +1,89 @@
1
+ import antfu from '@antfu/eslint-config'
2
+
3
+ const maxStatementsPerLineOptions = { max: 2 }
4
+ const braceStyleOptions = { allowSingleLine: true }
5
+
6
+ export default antfu(
7
+ {
8
+ vue: true,
9
+ markdown: false,
10
+ rules: {
11
+ 'no-console': 'error',
12
+ 'style/max-statements-per-line': ['error', maxStatementsPerLineOptions],
13
+ 'antfu/if-newline': 'off',
14
+ 'style/arrow-parens': ['error', 'always'],
15
+ 'style/brace-style': ['error', '1tbs', braceStyleOptions],
16
+ 'style/operator-linebreak': [
17
+ 'error',
18
+ 'after',
19
+ {
20
+ overrides: { '?': 'before', ':': 'before' },
21
+ },
22
+ ],
23
+ 'vue/singleline-html-element-content-newline': 'off',
24
+ },
25
+ },
26
+ {
27
+ ignores: [
28
+ 'src/api/generated/**',
29
+ 'dist/**',
30
+ 'coverage/**',
31
+ 'playwright-report/**',
32
+ 'test-results/**',
33
+ 'scaffold/agent-contracts/**',
34
+ ],
35
+ },
36
+ {
37
+ files: ['scripts/**/*.{js,mjs,cjs,ts}', 'e2e/**/*.{js,mjs,cjs,ts}'],
38
+ rules: {
39
+ 'no-console': 'off',
40
+ },
41
+ },
42
+ {
43
+ files: ['pnpm-workspace.yaml'],
44
+ rules: {
45
+ 'pnpm/yaml-enforce-settings': 'off',
46
+ 'yaml/plain-scalar': 'off',
47
+ 'yaml/quotes': 'off',
48
+ 'yaml/sort-keys': 'off',
49
+ },
50
+ },
51
+ {
52
+ // Prettier owns complete Vue SFC formatting; keep ESLint diagnostics without a competing fixer.
53
+ files: ['**/*.vue'],
54
+ rules: {
55
+ 'antfu/consistent-list-newline': 'off',
56
+ 'antfu/reasonable-newline': 'off',
57
+ 'import/newline-after-import': 'off',
58
+ 'object-shorthand': 'off',
59
+ 'style/arrow-parens': 'off',
60
+ 'style/brace-style': 'off',
61
+ 'style/indent': 'off',
62
+ 'style/indent-binary-ops': 'off',
63
+ 'style/max-statements-per-line': 'off',
64
+ 'style/member-delimiter-style': 'off',
65
+ 'style/operator-linebreak': 'off',
66
+ 'style/quote-props': 'off',
67
+ 'vue/html-closing-bracket-newline': 'off',
68
+ 'vue/html-indent': 'off',
69
+ 'vue/html-self-closing': 'off',
70
+ 'vue/multiline-html-element-content-newline': 'off',
71
+ 'vue/operator-linebreak': 'off',
72
+ 'vue/padding-line-between-blocks': 'off',
73
+ 'vue/singleline-html-element-content-newline': 'off',
74
+ },
75
+ },
76
+ {
77
+ // JSONC permits trailing commas, which Prettier keeps according to the shared trailingComma setting.
78
+ files: ['**/*.json', '**/*.jsonc'],
79
+ rules: {
80
+ 'jsonc/comma-dangle': 'off',
81
+ },
82
+ },
83
+ {
84
+ files: ['package.json'],
85
+ rules: {
86
+ 'pnpm/json-enforce-catalog': 'off',
87
+ },
88
+ },
89
+ )
@@ -4,7 +4,7 @@
4
4
  <meta charset="UTF-8" />
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
6
6
  <meta name="theme-color" content="#f5f7fb" />
7
- <title>@origen-ui/admin</title>
7
+ <title><!-- ADMIN_APP_TITLE --></title>
8
8
  </head>
9
9
  <body>
10
10
  <div id="app"></div>