@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
@@ -12,11 +12,12 @@ request mapping in the application service. For conventional XHR endpoints,
12
12
  create the same transport explicitly with `createXhrUploadAdapter(options)` and
13
13
  pass the returned adapter; response mapping remains in `resolveResponse`.
14
14
 
15
- Choose `valueType` intentionally: `fileList` exposes `OgUploadFile[]`, `url`
16
- projects one URL, and `urls` projects a URL list. Set `accept`, `maxSize`,
17
- `limit`, `multiple`, `duplicate`, and `beforeUpload` for validation. Use
18
- `variant="drag"` or `"picture-card"` for the selection surface and keep
19
- `showFileList` and labels accessible.
15
+ Choose `ogValueType` intentionally: `fileList` exposes `OgUploadFile[]`, `url`
16
+ projects one URL, and `urls` projects a URL list. Pass adapters through
17
+ `ogAdapter`; set the native `accept`, `limit`, `multiple`, `duplicate`, and
18
+ `showFileList` props directly, and use `ogMaxSize` and `ogBeforeUpload` for
19
+ wrapper validation. Use `ogVariant="drag"` or `"picture-card"` for the selection
20
+ surface and keep labels accessible.
20
21
 
21
22
  Leave `autoUpload` enabled unless a parent workflow needs an explicit submit;
22
23
  then call the typed `submit()` expose and inspect its `successful`, `failed`, and
@@ -0,0 +1,13 @@
1
+ import { defineConfig } from '@playwright/test'
2
+ import baseConfig from './playwright.config'
3
+
4
+ export default defineConfig({
5
+ ...baseConfig,
6
+ webServer: {
7
+ command: 'pnpm exec vite preview --host 127.0.0.1 --port 4175 --strictPort',
8
+ url: 'http://127.0.0.1:4175',
9
+ reuseExistingServer: false,
10
+ timeout: 900_000,
11
+ env: { VITE_DEFAULT_LOCALE: 'zh-CN' },
12
+ },
13
+ })
@@ -0,0 +1,10 @@
1
+ ---
2
+ paths:
3
+ - '**/*'
4
+ ---
5
+ # Feature architecture
6
+
7
+ - Keep route pages thin composition surfaces under `src/views/<feature>/pages`.
8
+ - Put UI sections in `components`, stateful side effects in `composables`, and API adapters in `api`.
9
+ - Keep data flow as props down and typed events up. Do not mutate props.
10
+ - `src/app` owns application integration; `src/views` owns business behavior; examples never become feature dependencies.
@@ -0,0 +1,10 @@
1
+ ---
2
+ paths:
3
+ - '**/*'
4
+ ---
5
+ # Vue and TypeScript
6
+
7
+ - Use Vue 3 `<script setup lang="ts">` and Composition API.
8
+ - Keep source state minimal, derive values with `computed`, and use watchers only for side effects.
9
+ - Type props, emits, exposed APIs, composable inputs, API payloads, and route metadata.
10
+ - Use `useTemplateRef` for imperative component APIs and keep templates declarative.
@@ -0,0 +1,31 @@
1
+ ---
2
+ paths:
3
+ - '**/*'
4
+ ---
5
+ # @origen-ui component policy
6
+
7
+ <!-- component-catalog:start -->
8
+ - `OgDialog` (@origen-ui/dialog): Parent-controlled dialog UI; avoid Element Plus ElDialog in business features.
9
+ - `OgEditor` (@origen-ui/editor): Rich text authoring; avoid Unsanitized HTML persistence or direct DOM insertion.
10
+ - `OgEditorViewer` (@origen-ui/editor): Readonly rich text rendering; avoid Rendering untrusted HTML without server sanitization.
11
+ - `OgForm` (@origen-ui/form): Schema-driven create, edit, or readonly forms; avoid Element Plus ElForm or removed legacy APIs.
12
+ - `OgFormTable` (@origen-ui/form-table): Editable array fields and line-item forms; avoid Mutating parent form arrays or duplicate remote table fetching.
13
+ - `OgSearch` (@origen-ui/search): Standalone query/filter panels; avoid Owning list loading or pagination.
14
+ - `OgTable` (@origen-ui/table): Typed local or remote data tables; avoid Legacy fetch/searchSchema APIs or ElTable.
15
+ - `OgTableLocal` (@origen-ui/table): Editable local tables embedded in a form or workflow; avoid Treating local rows as an implicit remote data source.
16
+ - `OgTableWithSearch` (@origen-ui/table-search): Remote CRUD lists with search and paging; avoid Separate ad-hoc search and table state.
17
+ - `OgTabs` (@origen-ui/tabs): Page-local business tabs; avoid Using page-local tabs for route workspace state.
18
+ - `OgUpload` (@origen-ui/upload): Validated file uploads and URL projection; avoid Package-level transport clients or mutating internal files.
19
+ - `OgFormItem` (@origen-ui/form): A single schema-aware field needs to participate in an existing OgForm context; avoid Using it as a transparent Element Plus ElFormItem replacement.
20
+ - `FieldRenderer` (@origen-ui/form): An advanced integration needs the registered OgForm control renderer; avoid Treating it as a general-purpose Element Plus control wrapper.
21
+ - `SvgIcon` (@origen-ui/icons): Rendering a project SVG sprite icon; avoid Passing untrusted or arbitrary symbol identifiers.
22
+ - `RouterViewHost` (@origen-ui/router): Rendering a route workspace with keep-alive semantics; avoid Using it as a transparent vue-router RouterView replacement.
23
+ - `OgDialogHost` (@origen-ui/dialog): Mounting manager-owned dialogs once in the application tree; avoid Creating a second app or mounting multiple hosts for one manager.
24
+ - `RouterBreadcrumb` (@origen-ui/router): Displaying breadcrumbs derived from the active route; avoid Hard-coding route labels when adapter metadata can provide them.
25
+ - `RouterMenu` (@origen-ui/router): Rendering adapter-backed route menus with active selection and icon resolution; avoid Trusting backend import paths or duplicating menu authorization in the view.
26
+ - `RouterTabs` (@origen-ui/router): Rendering route-backed workspace tabs with route and cache behavior; avoid Using page-local OgTabs for route workspace state.
27
+ <!-- component-catalog:end -->
28
+
29
+ - Route workspace: `@origen-ui/router`; page-local business tabs: `OgTabs`.
30
+ - Use Element Plus only for primitives. Do not add `ElTable`, `ElForm`, `ElDialog`, axios, or raw fetch to a business feature.
31
+ - Pass AbortSignal through every list and async-options implementation. Configure permissions explicitly when a component declares them.
@@ -0,0 +1,10 @@
1
+ ---
2
+ paths:
3
+ - '**/*'
4
+ ---
5
+ # API, authentication, and routing
6
+
7
+ - Create application-owned `ApiClient` instances with explicit response adapters.
8
+ - Keep token, refresh URL, CSRF source, and login navigation in the application adapter.
9
+ - Resolve backend component keys through the local registry; never import a backend-supplied path.
10
+ - Local authentication and menu providers are development-only. Remote failures must reach the caller.
@@ -0,0 +1,10 @@
1
+ ---
2
+ paths:
3
+ - '**/*'
4
+ ---
5
+ # Styling
6
+
7
+ - Use Element Plus CSS variables and the application theme tokens.
8
+ - Keep component styles scoped and use class selectors.
9
+ - Load only required `origen-ui/*.css` entries. `origen-ui/style.css` does not exist.
10
+ - Preserve responsive layouts and avoid hard-coded theme colors outside token definitions.
@@ -0,0 +1,10 @@
1
+ ---
2
+ paths:
3
+ - '**/*'
4
+ ---
5
+ # Quality gates
6
+
7
+ - Run `pnpm type-check`, `pnpm test`, and `pnpm build` for application changes.
8
+ - Run `pnpm agents:check` after changing official rules or Skills.
9
+ - Do not use deprecated component APIs such as `resetFields`, `dependsOn`, global renderer registration, or legacy OgTable read APIs.
10
+ - Add focused unit or browser coverage for user-visible behavior and failed requests.
@@ -0,0 +1,28 @@
1
+ ---
2
+ name: admin-component-usage
3
+ description: Discover @origen-ui components for Admin work, including current Admin usage, import paths, API surfaces, constraints, and supported extension points.
4
+ ---
5
+
6
+ # Admin component usage
7
+
8
+ Use this skill when selecting or integrating an @origen-ui component or
9
+ companion runtime capability in the standalone Admin scaffold. Start with
10
+ `references/component-directory.md` to find the public import, lifecycle state,
11
+ core API, extension boundary, and links to actual Admin usage evidence. UI
12
+ components and non-UI companion capabilities are listed in separate sections.
13
+ Use
14
+ `../build-admin-feature/references/component-selection.md` to compare components
15
+ by task, then read the matching `use-og-*` skill for workflow-specific
16
+ constraints.
17
+
18
+ The project-root `component-catalog.v2.json` is the structured contract source
19
+ shipped with the scaffold. Its `packageVersions` snapshot covers every
20
+ first-party `@origen-ui/*` and `origen-ui` package installed by the scaffold and
21
+ must match the installed packages. The Admin CLI itself is checked against the
22
+ contract source version in the scaffold lock. New standalone projects declare
23
+ published `@origen-ui/*` dependencies as `latest`; the lockfile records the
24
+ resolved versions. The project-root `component-catalog.json` remains a
25
+ compatibility view.
26
+
27
+ These are consumer rules. They do not describe package internals, tests, builds,
28
+ or releases.
@@ -0,0 +1,270 @@
1
+ # Admin component directory
2
+
3
+ Generated from `catalog/components.v2.json` and the current Admin source tree.
4
+ The UI component section contains public Vue components only; non-UI runtime
5
+ APIs appear separately under companion capabilities. Lifecycle status describes
6
+ the published API state, while Admin usage links point to verified source
7
+ evidence. A component with no recorded use is available but not currently used.
8
+
9
+ <!-- component-directory:start -->
10
+
11
+ ## dialog
12
+
13
+ - Package and version: `@origen-ui/dialog` 3.0.1.
14
+ - Public import: `OgDialog` from `@origen-ui/dialog`.
15
+ - Use when: Parent-controlled dialog UI.
16
+ - Lifecycle status: current.
17
+ - API summary: props: modelValue, ogCloseGuard, ogPresentation, ogMetadata, ogComponent, ogComponentProps, ogContentApi, ogLocale, ogConfirmHandler, ogConfirmLoading, ogLoading, ogProtectUnsaved, ogCancelable, ogErrorFeedback, ogShowFooter, ogFooter, ogDialogEvents, ogDrawerEvents; events: update:modelValue, confirm, cancel, actionError, close, closeError, closeResult, closed, confirmError, open, opened; slots: default, header, footer; exposes: open, close, confirm, complete, getPayload, registerContent, requestClose, setLoading, getSurfaceInstance.
18
+ - Admin usage: Available; no recorded use in this Admin project.
19
+ - Extension boundary: owned props: modelValue, ogCloseGuard, ogPresentation, ogMetadata, ogComponent, ogComponentProps, ogContentApi, ogLocale, ogConfirmHandler, ogConfirmLoading, ogLoading, ogProtectUnsaved, ogCancelable, ogErrorFeedback, ogShowFooter, ogFooter, ogDialogEvents, ogDrawerEvents; owned events: confirm, cancel; owned slots: default, header, footer; exposes: open, close, confirm, complete, getPayload, registerContent, requestClose, setLoading, getSurfaceInstance; Direct top-level ElDialog or ElDrawer props selected by ogPresentation.type; ogDialogEvents / ogDrawerEvents bridge non-workflow events; getSurfaceInstance.
20
+ - Avoid: Element Plus ElDialog in business features.
21
+ - Consumer skill and call guidance: [use-og-dialog](../../use-og-dialog/SKILL.md).
22
+ - Detailed API, defaults, constraints, and examples: [dialog](../../../../docs/components/dialog.md).
23
+
24
+ ## editor
25
+
26
+ - Package and version: `@origen-ui/editor` 3.0.1.
27
+ - Public import: `OgEditor, OgEditorSetup` from `@origen-ui/editor`.
28
+ - Use when: Rich text authoring.
29
+ - Lifecycle status: current.
30
+ - API summary: props: modelValue, ogSetup, ogToolbar, ogReadonly, ogDisabled, ogPlaceholder, ogMinHeight, ogMaxHeight, ogMaxLength, ogAutofocus, ogLocale, ogUpload, ogSanitize, ogVideoResolvers, ogLinkDialog, ogMediaDialog, ogSourceDialog; events: update:modelValue, change, ready, focus, blur, limit, uploadStart, uploadProgress, uploadSuccess, uploadError, uploadCancel, mediaRemove; slots: toolbar-prefix, toolbar-suffix, status; exposes: focus, blur, clear, getHTML, getJSON, getText, setContent, insertContent, undo, redo, isEmpty, cancelUpload, retryUpload, removeMedia.
31
+ - Admin usage: Available; no recorded use in this Admin project.
32
+ - Extension boundary: owned props: ogSetup, ogToolbar, ogReadonly, ogDisabled, ogPlaceholder, ogMinHeight, ogMaxHeight, ogMaxLength, ogAutofocus, ogLocale, ogUpload, ogSanitize, ogVideoResolvers, ogLinkDialog, ogMediaDialog, ogSourceDialog, modelValue; owned events: update:modelValue, change, ready, focus, blur, limit, uploadStart, uploadProgress, uploadSuccess, uploadError, uploadCancel, mediaRemove; owned slots: toolbar-prefix, toolbar-suffix, status; exposes: focus, blur, clear, getHTML, getJSON, getText, setContent, insertContent, undo, redo, isEmpty, cancelUpload, retryUpload, removeMedia; No single Element Plus root target. Official Select / Button / Tooltip props live under ogToolbar; Dialog / Input / Checkbox / Button props live in ogLinkDialog, ogMediaDialog, and ogSourceDialog groups; expose uses OgEditorHandle without the raw Tiptap editor.
33
+ - Avoid: Unsanitized HTML persistence or direct DOM insertion.
34
+ - Consumer skill and call guidance: [use-og-editor](../../use-og-editor/SKILL.md).
35
+ - Detailed API, defaults, constraints, and examples: [editor](../../../../docs/components/editor.md).
36
+
37
+ ## editor-viewer
38
+
39
+ - Package and version: `@origen-ui/editor` 3.0.1.
40
+ - Public import: `OgEditorViewer` from `@origen-ui/editor`.
41
+ - Use when: Readonly rich text rendering.
42
+ - Lifecycle status: current.
43
+ - API summary: props: ogContent, ogEmptyText, ogLocale, ogSanitize, ogSsrMode, ogServerSanitize.
44
+ - Admin usage: Available; no recorded use in this Admin project.
45
+ - Extension boundary: owned props: ogContent, ogEmptyText, ogLocale, ogSanitize, ogSsrMode, ogServerSanitize; Use the underlying Tiptap renderer directly when DOM-level rendering control is required.
46
+ - Avoid: Rendering untrusted HTML without server sanitization.
47
+ - Consumer skill and call guidance: [use-og-editor](../../use-og-editor/SKILL.md).
48
+ - Detailed API, defaults, constraints, and examples: [editor-viewer](../../../../docs/components/editor-viewer.md).
49
+
50
+ ## form
51
+
52
+ - Package and version: `@origen-ui/form` 3.0.1.
53
+ - Public import: `OgForm` from `@origen-ui/form`.
54
+ - Use when: Schema-driven create, edit, or readonly forms.
55
+ - Lifecycle status: current.
56
+ - API summary: props: modelValue, ogSchema, ogSectionVariant, ogAnchor, ogScrollToFirstError, ogReadonly, ogColumns, ogResponsiveColumns, ogBaselineKey, ogModelTransform, ogDirtyModelTransform, ogLocale, ogOperationContext, ogOptionsPolicy, ogSubmitOnEnter, ogPermissions, ogRendererRegistry; events: fieldChange, dirtyError, optionsError, operationError, validate, update:modelValue, submit, submitInvalid; slots: actions, *; exposes: validate, validateResult, validateField, clearValidate, focusField, getFieldMeta, getDirtyFields, getModel, getSubmitModel, isDirty, markClean, reset, resetField, clearFields, clearField, setFields, setFieldValue, getFieldValue, refreshOptions, refreshOptionsResult, formRef.
57
+ - Admin usage: direct: [src/views/system/user/components/UserEditorForm.vue](../../../../src/views/system/user/components/UserEditorForm.vue) (OgForm); [src/views/system/menu/components/MenuEditorForm.vue](../../../../src/views/system/menu/components/MenuEditorForm.vue) (OgForm); [src/views/system/dept/components/DepartmentEditorForm.vue](../../../../src/views/system/dept/components/DepartmentEditorForm.vue) (OgForm); [src/views/system/dict/components/DictionaryTypeEditorForm.vue](../../../../src/views/system/dict/components/DictionaryTypeEditorForm.vue) (OgForm); [src/views/system/dict/components/DictionaryDataEditorForm.vue](../../../../src/views/system/dict/components/DictionaryDataEditorForm.vue) (OgForm).
58
+ - Extension boundary: owned props: modelValue, ogSchema, ogSectionVariant, ogAnchor, ogScrollToFirstError, ogReadonly, ogColumns, ogResponsiveColumns, ogBaselineKey, ogModelTransform, ogDirtyModelTransform, ogLocale, ogOperationContext, ogOptionsPolicy, ogSubmitOnEnter, ogPermissions, ogRendererRegistry; owned events: fieldChange, dirtyError, optionsError, operationError, validate, update:modelValue, submit, submitInvalid; owned slots: actions, *; exposes: validate, validateResult, validateField, clearValidate, focusField, getFieldMeta, getDirtyFields, getModel, getSubmitModel, isDirty, markClean, reset, resetField, clearFields, clearField, setFields, setFieldValue, getFieldValue, refreshOptions, refreshOptionsResult; Direct top-level ElForm props; model and rules are bound by OgForm. Field targets use ogControl and ogFormItem groups; formRef exposes the native FormInstance.
59
+ - Avoid: Element Plus ElForm or removed legacy APIs.
60
+ - Consumer skill and call guidance: [use-og-form](../../use-og-form/SKILL.md).
61
+ - Detailed API, defaults, constraints, and examples: [form](../../../../docs/components/form.md).
62
+
63
+ ## form-table
64
+
65
+ - Package and version: `@origen-ui/form-table` 3.0.1.
66
+ - Public import: `OgFormTable, createOgFormTableField` from `@origen-ui/form-table`.
67
+ - Use when: Editable array fields and line-item forms.
68
+ - Lifecycle status: current.
69
+ - API summary: props: modelValue, rowKey, ogColumns, ogConfig, ogEditMode, ogTableEvents, ogTableSlots, ogReadonly, ogRenderDisabledGridCells, ogQueryDefaults, ogLocal, ogEditableHint, ogEditableHintText, ogShowEditModeButton, ogRowDisabled, ogDisabledHintText, ogLocale, ogFormTableLocale, ogRendererRegistry, selectionTooltip; events: update:modelValue, loadSuccess, loadError, pluginError, selectionChange, selectionScopeChange, batchJobChange, transactionConflict, sortChange, search, searchOptionsError, cellChange, filterOptionsError, rowAdd, rowRemove, operationError, update:ogEditMode; slots: search, empty, error, expand, beforeActions, actions, afterActions, overflowActions, beforeToolbar, afterToolbar, beforeTable, tableEmpty, tableAppend; exposes: getElTable, addRow, removeRow, validate, validateRows, refresh, reset, getSelectedRows, clearSelection, toggleRowSelection, toggleRowExpansion, getExpandedRows, resetColumnWidths, scrollTo, getState, applyState.
70
+ - Admin usage: Available; no recorded use in this Admin project.
71
+ - Extension boundary: owned props: modelValue, rowKey, ogColumns, ogConfig, ogEditMode, ogTableEvents, ogTableSlots, ogReadonly, ogRenderDisabledGridCells, ogQueryDefaults, ogLocal, ogEditableHint, ogEditableHintText, ogShowEditModeButton, ogRowDisabled, ogDisabledHintText, ogLocale, ogFormTableLocale, ogRendererRegistry, selectionTooltip; owned events: update:modelValue, loadSuccess, loadError, pluginError, selectionChange, selectionScopeChange, batchJobChange, transactionConflict, sortChange, search, searchOptionsError, cellChange, filterOptionsError, rowAdd, rowRemove, operationError, update:ogEditMode; owned slots: search, empty, error, expand, beforeActions, actions, afterActions, overflowActions, beforeToolbar, afterToolbar, beforeTable, tableEmpty, tableAppend; exposes: addRow, removeRow, validate, validateRows; Direct ElTable or ElTableV2 props filtered by the active ogConfig.virtual surface; ogTableEvents / ogTableSlots bridge supported native events and slots; getElTable.
72
+ - Avoid: Mutating parent form arrays or duplicate remote table fetching.
73
+ - Consumer skill and call guidance: [use-og-form-table](../../use-og-form-table/SKILL.md).
74
+ - Detailed API, defaults, constraints, and examples: [form-table](../../../../docs/components/form-table.md).
75
+
76
+ ## search
77
+
78
+ - Package and version: `@origen-ui/search` 3.0.1.
79
+ - Public import: `OgSearch` from `@origen-ui/search`.
80
+ - Use when: Standalone query/filter panels.
81
+ - Lifecycle status: current.
82
+ - API summary: props: modelValue, ogKeyword, ogExpanded, ogConfig, ogLoading, ogRendererRegistry, ogReset, inline, labelPosition, labelSuffix, showMessage, size, disabled, inlineMessage, statusIcon, ogPermissions, ogSubmitOnEnter, ogShowReset, ogShowToggle, ogLabelPlacement, ogControlLabelWidth, ogControlLabelStyle; events: update:modelValue, update:ogKeyword, update:ogExpanded, search, reset, validate, fieldChange, optionsError; slots: *; exposes: formRef, validate, submit, reset, getModel, getSubmitParams, setFieldValue, setFields, refreshOptions, cancelOptions, focus, getFieldError, clearErrors, isDirty, getDirtyFields.
83
+ - Admin usage: Available; no recorded use in this Admin project.
84
+ - Extension boundary: owned props: modelValue, ogKeyword, ogExpanded, ogConfig, ogRendererRegistry, ogReset, ogLoading, ogPermissions, ogSubmitOnEnter, ogShowReset, ogShowToggle, ogLabelPlacement, ogControlLabelWidth, ogControlLabelStyle; owned events: update:modelValue, update:ogKeyword, update:ogExpanded, search, reset, validate, fieldChange, optionsError; owned slots: *; exposes: submit, validate, reset, getModel, getSubmitParams, setFieldValue, setFields, refreshOptions, cancelOptions, focus, getFieldError, clearErrors, isDirty, getDirtyFields; Direct top-level ElForm props except the model bound by OgSearch; fields use ogControl: { ogType, ...nativeProps, ogEvents, ogSlots }, with field-level ogFormItem and ogFormItemSlots; omit ogControl for input, explicit controls require ogType; instance ogRendererRegistry supports custom:name without widening built-in props; custom remains the field slot; unknown renderers throw; formRef.
85
+ - Avoid: Owning list loading or pagination.
86
+ - Consumer skill and call guidance: [use-og-search](../../use-og-search/SKILL.md).
87
+ - Detailed API, defaults, constraints, and examples: [search](../../../../docs/components/search.md).
88
+
89
+ ## table
90
+
91
+ - Package and version: `@origen-ui/table` 3.0.1.
92
+ - Public import: `OgTable` from `@origen-ui/table`.
93
+ - Use when: Typed local or remote data tables.
94
+ - Lifecycle status: current.
95
+ - API summary: props: rowKey, ogColumns, ogDataSource, ogConfig, ogQueryDefaults, ogTableEvents, ogTableSlots, ogReadonly, ogRenderDisabledGridCells, ogOnVisibleColumnsChange, selectionTooltip; events: selectionChange, loadSuccess, loadError, operationError, pluginError, selectionScopeChange, batchJobChange, transactionConflict, sortChange, search, searchOptionsError, cellChange, filterOptionsError; slots: search, empty, error, expand, editor, beforeActions, actions, afterActions, overflowActions, beforeToolbar, afterToolbar, beforeTable, tableEmpty, tableAppend; exposes: getElTable, refresh, reset, refreshRow, clearFilterMemory, getSelectedRows, getChanges, hasChanges, discardChanges, commitChanges, clearSelection, toggleRowSelection, toggleRowExpansion, getExpandedRows, resetColumnWidths, scrollTo, getState, applyState.
96
+ - Admin usage: direct: [src/views/system/dict/data/pages/index.vue](../../../../src/views/system/dict/data/pages/index.vue) (OgTable).
97
+ - Extension boundary: owned props: rowKey, ogColumns, ogDataSource, ogConfig, ogQueryDefaults, ogTableEvents, ogTableSlots, ogReadonly, ogRenderDisabledGridCells, ogOnVisibleColumnsChange, selectionTooltip; owned events: selectionChange, loadSuccess, loadError, operationError, pluginError, selectionScopeChange, batchJobChange, transactionConflict, sortChange, search, searchOptionsError, cellChange, filterOptionsError; owned slots: search, empty, error, expand, editor, beforeActions, actions, afterActions, overflowActions, beforeToolbar, afterToolbar, beforeTable, tableEmpty, tableAppend; exposes: refresh, reset, refreshRow, clearFilterMemory, getSelectedRows, getChanges, hasChanges, discardChanges, commitChanges, clearSelection, toggleRowSelection, toggleRowExpansion, getExpandedRows, resetColumnWidths, scrollTo, getState, applyState; Direct ElTable or ElTableV2 props filtered by ogConfig.virtual.enabled; ogTableEvents / ogTableSlots bridge supported native events and slots; getElTable.
98
+ - Avoid: Legacy fetch/searchSchema APIs or ElTable.
99
+ - Consumer skill and call guidance: [use-og-table](../../use-og-table/SKILL.md).
100
+ - Detailed API, defaults, constraints, and examples: [table](../../../../docs/components/table.md).
101
+
102
+ ## table-local
103
+
104
+ - Package and version: `@origen-ui/table` 3.0.1.
105
+ - Public import: `OgTableLocal` from `@origen-ui/table`.
106
+ - Use when: Editable local tables embedded in a form or workflow.
107
+ - Lifecycle status: current.
108
+ - API summary: props: modelValue, rowKey, ogColumns, ogConfig, ogLocal, ogReadonly, ogTableEvents, ogTableSlots, ogRenderDisabledGridCells, ogQueryDefaults, ogOnVisibleColumnsChange, selectionTooltip; events: update:modelValue, loadSuccess, loadError, operationError, pluginError, selectionChange, selectionScopeChange, batchJobChange, transactionConflict, sortChange, search, searchOptionsError, cellChange, filterOptionsError, rowAdd, rowRemove; slots: search, empty, error, expand, editor, beforeActions, actions, afterActions, overflowActions, beforeToolbar, afterToolbar, beforeTable, tableEmpty, tableAppend; exposes: getElTable, addRow, removeRow, refresh, reset, getSelectedRows, clearSelection, toggleRowSelection, toggleRowExpansion, getExpandedRows, resetColumnWidths, scrollTo, getState, applyState.
109
+ - Admin usage: Available; no recorded use in this Admin project.
110
+ - Extension boundary: owned props: modelValue, rowKey, ogColumns, ogConfig, ogLocal, ogReadonly, ogTableEvents, ogTableSlots, ogRenderDisabledGridCells, ogQueryDefaults, ogOnVisibleColumnsChange, selectionTooltip; owned events: update:modelValue, loadSuccess, loadError, operationError, pluginError, selectionChange, selectionScopeChange, batchJobChange, transactionConflict, sortChange, search, searchOptionsError, cellChange, filterOptionsError, rowAdd, rowRemove; owned slots: search, empty, error, expand, editor, beforeActions, actions, afterActions, overflowActions, beforeToolbar, afterToolbar, beforeTable, tableEmpty, tableAppend; exposes: addRow, removeRow, refresh, reset, getSelectedRows, clearSelection, toggleRowSelection, toggleRowExpansion, getExpandedRows, resetColumnWidths, scrollTo, getState, applyState; Direct ElTable or ElTableV2 props filtered by the active ogConfig.virtual surface; ogTableEvents / ogTableSlots bridge supported native events and slots; getElTable.
111
+ - Avoid: Treating local rows as an implicit remote data source.
112
+ - Consumer skill and call guidance: [use-og-table](../../use-og-table/SKILL.md).
113
+ - Detailed API, defaults, constraints, and examples: [table-local](../../../../docs/components/table-local.md).
114
+
115
+ ## table-with-search
116
+
117
+ - Package and version: `@origen-ui/table-search` 3.0.1.
118
+ - Public import: `OgTableWithSearch` from `@origen-ui/table-search`.
119
+ - Use when: Remote CRUD lists with search and paging.
120
+ - Lifecycle status: current.
121
+ - API summary: props: rowKey, ogColumns, ogDataSource, ogConfig, ogQueryDefaults, ogSearch, selectionTooltip; slots: search-*, beforeActions, actions, afterActions, overflowActions, beforeToolbar, editor, empty, error, expand, afterToolbar, beforeTable, tableEmpty, tableAppend, search; exposes: getElTable, getSearchInstance, refresh, reset, refreshRow, clearFilterMemory, getSelectedRows, getChanges, hasChanges, discardChanges, commitChanges, clearSelection, toggleRowSelection, toggleRowExpansion, getExpandedRows, resetColumnWidths, scrollTo, getState, applyState.
122
+ - Admin usage: direct: [src/views/system/user/pages/index.vue](../../../../src/views/system/user/pages/index.vue) (OgTableWithSearch); [src/views/system/role/pages/index.vue](../../../../src/views/system/role/pages/index.vue) (OgTableWithSearch); [src/views/system/menu/pages/index.vue](../../../../src/views/system/menu/pages/index.vue) (OgTableWithSearch); [src/views/system/dept/pages/index.vue](../../../../src/views/system/dept/pages/index.vue) (OgTableWithSearch); [src/views/system/dict/pages/index.vue](../../../../src/views/system/dict/pages/index.vue) (OgTableWithSearch).
123
+ - Extension boundary: owned props: rowKey, ogColumns, ogDataSource, ogConfig, ogQueryDefaults, ogSearch, selectionTooltip; owned slots: search-*, beforeActions, actions, afterActions, overflowActions, beforeToolbar, editor, empty, error, expand, afterToolbar, beforeTable, tableEmpty, tableAppend, search; exposes: refresh, reset; Direct ElTable or ElTableV2 props filtered by ogConfig.virtual.enabled; ogTableEvents / ogTableSlots bridge table events and slots; ogSearch groups nested search props and events; getElTable / getSearchInstance.
124
+ - Avoid: Separate ad-hoc search and table state.
125
+ - Consumer skill and call guidance: [use-og-table](../../use-og-table/SKILL.md).
126
+ - Detailed API, defaults, constraints, and examples: [table-with-search](../../../../docs/components/table-with-search.md).
127
+
128
+ ## tabs
129
+
130
+ - Package and version: `@origen-ui/tabs` 3.0.1.
131
+ - Public import: `OgTabs` from `@origen-ui/tabs`.
132
+ - Use when: Page-local business tabs.
133
+ - Lifecycle status: current.
134
+ - API summary: props: modelValue, ogItems, ogVariant, ogFeatures, ogContextMenu, ogActionPolicy, ogDensity, ogRenderContent, ogReadonly, ogBusy, ogTabsEvents, ogLocale, ogMinTabWidth, ogMaxTabWidth, ogThemeColor, ogSticky, ogFinderThreshold, ogBeforeAction, ogActionHandler; events: update:modelValue, update:ogItems, actionRequest, closeRequest, refreshRequest, pinChangeRequest, reorderRequest, operationDenied, operationError, tabClick, tabChange, tabRemove; slots: default, label, tabBefore, tabAfter, status, contextMenuTop, contextMenuBottom, header, extra, empty; exposes: getNativeTabs, requestAdd, close, activate, closeScope, pin, unpin, move, moveTop, moveBottom, refresh, scrollTo, getItems.
135
+ - Admin usage: Available; no recorded use in this Admin project.
136
+ - Extension boundary: owned props: modelValue, ogItems, ogVariant, ogFeatures, ogContextMenu, ogActionPolicy, ogDensity, ogRenderContent, ogReadonly, ogBusy, ogTabsEvents, ogLocale, ogMinTabWidth, ogMaxTabWidth, ogThemeColor, ogSticky, ogFinderThreshold, ogBeforeAction, ogActionHandler; owned events: update:modelValue, update:ogItems, actionRequest, closeRequest, refreshRequest, pinChangeRequest, reorderRequest, operationDenied, operationError, tabClick, tabChange, tabRemove; owned slots: default, label, tabBefore, tabAfter, status, contextMenuTop, contextMenuBottom, header, extra, empty; exposes: close, activate, requestAdd, closeScope, pin, unpin, move, moveTop, moveBottom, refresh, scrollTo, getItems; Direct top-level ElTabs props; Og-owned model and workflow attributes are excluded; ogTabsEvents bridges native callbacks; getNativeTabs.
137
+ - Avoid: Using page-local tabs for route workspace state.
138
+ - Consumer skill and call guidance: [use-og-router-tabs](../../use-og-router-tabs/SKILL.md).
139
+ - Detailed API, defaults, constraints, and examples: [tabs](../../../../docs/components/tabs.md).
140
+
141
+ ## upload
142
+
143
+ - Package and version: `@origen-ui/upload` 3.0.1.
144
+ - Public import: `OgUpload, createXhrUploadAdapter` from `@origen-ui/upload`.
145
+ - Use when: Validated file uploads and URL projection.
146
+ - Lifecycle status: current.
147
+ - API summary: props: modelValue, ogAdapter, ogValueType, ogValueCodec, accept, limit, ogAutoUpload, ogBeforeUpload, ogConcurrency, ogConfirmRemove, ogDuplicate, ogLocale, ogMaxSize, ogResolveResponse, ogRetry, ogText, ogTip, ogUploadEvents, ogVariant; events: operationError, uploadSuccess, update:modelValue, change, exceed, progress, removeSuccess, validationError; slots: default, empty, file, tip; exposes: submit, clearFiles, abort, getFiles, remove, retry, validate.
148
+ - Admin usage: Available; no recorded use in this Admin project.
149
+ - Extension boundary: owned props: modelValue, ogAdapter, ogValueType, ogValueCodec, ogAutoUpload, ogBeforeUpload, ogConcurrency, ogConfirmRemove, ogDuplicate, ogLocale, ogMaxSize, ogResolveResponse, ogRetry, ogText, ogTip, ogUploadEvents, ogVariant; owned events: operationError, uploadSuccess, update:modelValue, change, exceed, progress, removeSuccess, validationError; owned slots: default, empty, file, tip; exposes: submit, clearFiles, abort, getFiles, remove, retry, validate; Allowed Element Plus Upload props use their official names at the root; transport, file-list, and lifecycle props are managed by OgUpload, with limit and showFileList exposed as controlled native options; ogUploadEvents exposes change.
150
+ - Avoid: Package-level transport clients or mutating internal files.
151
+ - Consumer skill and call guidance: [use-og-upload](../../use-og-upload/SKILL.md).
152
+ - Detailed API, defaults, constraints, and examples: [upload](../../../../docs/components/upload.md).
153
+
154
+ ## form-item
155
+
156
+ - Package and version: `@origen-ui/form` 3.0.1.
157
+ - Public import: `OgFormItem` from `@origen-ui/form`.
158
+ - Use when: A single schema-aware field needs to participate in an existing OgForm context.
159
+ - Lifecycle status: current.
160
+ - API summary: props: ogName, ogField, ogReadonly, ogLabelTip; slots: default, *.
161
+ - Admin usage: Available; no recorded use in this Admin project.
162
+ - Extension boundary: owned props: ogName, ogField, ogReadonly, ogLabelTip; owned slots: default, *; Direct top-level ElFormItem props except prop and error, which OgForm owns for field identity and validation.; Use ElFormItem directly for raw Element Plus form-item behavior outside OgForm context.
163
+ - Avoid: Using it as a transparent Element Plus ElFormItem replacement.
164
+ - Consumer skill and call guidance: [use-og-form](../../use-og-form/SKILL.md).
165
+ - Detailed API, defaults, constraints, and examples: [form-item](../../../../docs/components/form.md).
166
+
167
+ ## field-renderer
168
+
169
+ - Package and version: `@origen-ui/form` 3.0.1.
170
+ - Public import: `FieldRenderer` from `@origen-ui/form`.
171
+ - Use when: An advanced integration needs the registered OgForm control renderer.
172
+ - Lifecycle status: current.
173
+ - API summary: props: ogField, ogReadonly, ogA11y; slots: options-error.
174
+ - Admin usage: Available; no recorded use in this Admin project.
175
+ - Extension boundary: owned props: ogField, ogReadonly, ogA11y; owned slots: options-error; Use the required Element Plus control directly when the schema renderer contract is not needed.
176
+ - Avoid: Treating it as a general-purpose Element Plus control wrapper.
177
+ - Consumer skill and call guidance: [use-og-form](../../use-og-form/SKILL.md).
178
+ - Detailed API, defaults, constraints, and examples: [field-renderer](../../../../docs/components/form.md).
179
+
180
+ ## svg-icon
181
+
182
+ - Package and version: `@origen-ui/icons` 3.0.1.
183
+ - Public import: `SvgIcon` from `@origen-ui/icons`.
184
+ - Use when: Rendering a project SVG sprite icon.
185
+ - Lifecycle status: current.
186
+ - API summary: props: name, size, color, label.
187
+ - Admin usage: Available; no recorded use in this Admin project.
188
+ - Extension boundary: owned props: name, size, color, label.
189
+ - Avoid: Passing untrusted or arbitrary symbol identifiers.
190
+ - Consumer skill and call guidance: [style-og-origen-ui](../../style-og-origen-ui/SKILL.md).
191
+ - Detailed API, defaults, constraints, and examples: [svg-icon](../../../../docs/components/svg-icon.md).
192
+
193
+ ## router-view-host
194
+
195
+ - Package and version: `@origen-ui/router` 3.0.1.
196
+ - Public import: `RouterViewHost` from `@origen-ui/router`.
197
+ - Use when: Rendering a route workspace with keep-alive semantics.
198
+ - Lifecycle status: current.
199
+ - API summary: props: cacheMax.
200
+ - Admin usage: direct: [src/layouts/AdminLayout.vue](../../../../src/layouts/AdminLayout.vue) (RouterViewHost).
201
+ - Extension boundary: owned props: cacheMax; Use vue-router RouterView directly for route slots, props, or transition control not owned by the workspace host.
202
+ - Avoid: Using it as a transparent vue-router RouterView replacement.
203
+ - Consumer skill and call guidance: [use-og-router-tabs](../../use-og-router-tabs/SKILL.md).
204
+ - Detailed API, defaults, constraints, and examples: [router-view-host](../../../../docs/components/router.md).
205
+
206
+ ## dialog-host
207
+
208
+ - Package and version: `@origen-ui/dialog` 3.0.1.
209
+ - Public import: `OgDialogHost` from `@origen-ui/dialog`.
210
+ - Use when: Mounting manager-owned dialogs once in the application tree.
211
+ - Lifecycle status: current.
212
+ - API summary: props: manager.
213
+ - Admin usage: direct: [src/layouts/AdminLayout.vue](../../../../src/layouts/AdminLayout.vue) (OgDialogHost).
214
+ - Extension boundary: owned props: manager; Mount one host in the app tree after installing createOgDialog(), or pass a DialogManager explicitly.
215
+ - Avoid: Creating a second app or mounting multiple hosts for one manager.
216
+ - Consumer skill and call guidance: [use-og-dialog](../../use-og-dialog/SKILL.md).
217
+ - Detailed API, defaults, constraints, and examples: [dialog-host](../../../../docs/components/dialog.md).
218
+
219
+ ## router-breadcrumb
220
+
221
+ - Package and version: `@origen-ui/router` 3.0.1.
222
+ - Public import: `RouterBreadcrumb` from `@origen-ui/router/element-plus`.
223
+ - Use when: Displaying breadcrumbs derived from the active route.
224
+ - Lifecycle status: current.
225
+ - API summary: slots: default.
226
+ - Admin usage: direct: [src/layouts/BreadcrumbBar.vue](../../../../src/layouts/BreadcrumbBar.vue) (RouterBreadcrumb).
227
+ - Extension boundary: owned slots: default; Element Plus Breadcrumb props stay at the root; by default labels and links come from the active router adapter.
228
+ - Avoid: Hard-coding route labels when adapter metadata can provide them.
229
+ - Consumer skill and call guidance: [use-og-router-tabs](../../use-og-router-tabs/SKILL.md).
230
+ - Detailed API, defaults, constraints, and examples: [router-breadcrumb](../../../../docs/components/router.md).
231
+
232
+ ## router-menu
233
+
234
+ - Package and version: `@origen-ui/router` 3.0.1.
235
+ - Public import: `RouterMenu` from `@origen-ui/router/element-plus`.
236
+ - Use when: Rendering adapter-backed route menus with active selection and icon resolution.
237
+ - Lifecycle status: current.
238
+ - API summary: props: ogResolveIcon, ogMenuEvents, ogNodeProps, ogNodeEvents; slots: default.
239
+ - Admin usage: direct: [src/layouts/SideMenu.vue](../../../../src/layouts/SideMenu.vue) (RouterMenu).
240
+ - Extension boundary: owned props: ogResolveIcon, ogMenuEvents, ogNodeProps, ogNodeEvents; owned slots: default; Element Plus Menu props stay at the root except adapter-owned defaultActive; native callbacks use ogMenuEvents, and per-node props/events use ogNodeProps and ogNodeEvents.
241
+ - Avoid: Trusting backend import paths or duplicating menu authorization in the view.
242
+ - Consumer skill and call guidance: [use-og-router-tabs](../../use-og-router-tabs/SKILL.md).
243
+ - Detailed API, defaults, constraints, and examples: [router-menu](../../../../docs/components/router.md).
244
+
245
+ ## router-tabs
246
+
247
+ - Package and version: `@origen-ui/router` 3.0.1.
248
+ - Public import: `RouterTabs` from `@origen-ui/router/tabs`.
249
+ - Use when: Rendering route-backed workspace tabs with route and cache behavior.
250
+ - Lifecycle status: current.
251
+ - API summary: props: ogFeatures, ogLocale, ogAddTab.
252
+ - Admin usage: direct: [src/layouts/WorkspaceTabs.vue](../../../../src/layouts/WorkspaceTabs.vue) (RouterTabs).
253
+ - Extension boundary: owned props: ogFeatures, ogLocale, ogAddTab; Element Plus Tabs props stay at the root; RouterTabs owns route-backed tab identity and activation while ogFeatures and ogAddTab configure workspace behavior.; Do not pass modelValue to control the active workspace tab; RouterTabs derives tab identity and activation from the route workspace.
254
+ - Avoid: Using page-local OgTabs for route workspace state.
255
+ - Consumer skill and call guidance: [use-og-router-tabs](../../use-og-router-tabs/SKILL.md).
256
+ - Detailed API, defaults, constraints, and examples: [router-tabs](../../../../docs/components/router.md).
257
+
258
+ ## Companion capabilities
259
+
260
+ ### dialog-manager
261
+
262
+ - Package and version: `@origen-ui/dialog` 3.0.1.
263
+ - Public import: `createOgDialog, useDialog` from `@origen-ui/dialog`.
264
+ - Use when: Awaitable or manager-owned dialog workflows.
265
+ - Lifecycle status: current.
266
+ - Admin usage: direct: [src/views/system/user/composables/useUserManagement.ts](../../../../src/views/system/user/composables/useUserManagement.ts) (useDialog); [src/views/system/menu/composables/useMenuManagement.ts](../../../../src/views/system/menu/composables/useMenuManagement.ts) (useDialog).
267
+ - Avoid: createApp or a global fallback manager.
268
+ - Consumer skill and call guidance: [use-og-dialog](../../use-og-dialog/SKILL.md).
269
+
270
+ <!-- component-directory:end -->
@@ -0,0 +1,20 @@
1
+ ---
2
+ name: build-admin-feature
3
+ description: Build a typed Vue Admin business feature. Use when adding a page, CRUD workflow, feature folder, business API adapter, permissioned menu, or route in the standalone @origen-ui Admin scaffold.
4
+ ---
5
+
6
+ # Build an Admin feature
7
+
8
+ 1. Define the feature model, permissions, API contract, and route before writing a page.
9
+ 2. For each page menu (`menuType: "C"`), create `src/views/<area>/<domain>/pages/index.vue`; the router discovers pages with `import.meta.glob('@/views/**/pages/**/*.vue')`.
10
+ 3. Set the backend menu `component` to `<area>/<domain>/index` without an alias or file extension. For example, `system/user/index` resolves to `src/views/system/user/pages/index.vue`.
11
+ 4. Directory menus (`menuType: "M"`) use layout outlets, and button menus (`menuType: "F"`) contribute permissions without creating page files.
12
+ 5. Create `api`, `composables`, and `components` alongside `pages` only when those responsibilities exist.
13
+ 6. Select the mandatory @origen-ui business component before writing view code.
14
+ 7. Do not add a hand-maintained component registry; keep backend component values aligned with the discovered page path.
15
+ 8. Add a focused test and run application quality gates.
16
+
17
+ Read `admin-component-usage` and `references/component-selection.md` before
18
+ choosing a UI primitive. Read the matching component detail in
19
+ `admin-component-usage/references/component-directory.md` for its API and
20
+ extension boundary.
@@ -0,0 +1,38 @@
1
+ # Component selection
2
+
3
+ <!-- component-catalog:start -->
4
+
5
+ ## UI components
6
+
7
+ | Use case | Public import | Skill | Current Admin use | Extension surface | Avoid | Lifecycle | Package version |
8
+ | ------------------------------------------------------------------------------ | -------------------------------------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------- | --------------- |
9
+ | Parent-controlled dialog UI | `OgDialog` from `@origen-ui/dialog` | [use-og-dialog](../../use-og-dialog/SKILL.md) | Available; no recorded use in this Admin project. | owned props: modelValue, ogCloseGuard, ogPresentation, ogMetadata, ogComponent, ogComponentProps, ogContentApi, ogLocale, ogConfirmHandler, ogConfirmLoading, ogLoading, ogProtectUnsaved, ogCancelable, ogErrorFeedback, ogShowFooter, ogFooter, ogDialogEvents, ogDrawerEvents; owned events: confirm, cancel; owned slots: default, header, footer; exposes: open, close, confirm, complete, getPayload, registerContent, requestClose, setLoading, getSurfaceInstance; Direct top-level ElDialog or ElDrawer props selected by ogPresentation.type; ogDialogEvents / ogDrawerEvents bridge non-workflow events; getSurfaceInstance. | Element Plus ElDialog in business features | current | 3.0.1 |
10
+ | Rich text authoring | `OgEditor`, `OgEditorSetup` from `@origen-ui/editor` | [use-og-editor](../../use-og-editor/SKILL.md) | Available; no recorded use in this Admin project. | owned props: ogSetup, ogToolbar, ogReadonly, ogDisabled, ogPlaceholder, ogMinHeight, ogMaxHeight, ogMaxLength, ogAutofocus, ogLocale, ogUpload, ogSanitize, ogVideoResolvers, ogLinkDialog, ogMediaDialog, ogSourceDialog, modelValue; owned events: update:modelValue, change, ready, focus, blur, limit, uploadStart, uploadProgress, uploadSuccess, uploadError, uploadCancel, mediaRemove; owned slots: toolbar-prefix, toolbar-suffix, status; exposes: focus, blur, clear, getHTML, getJSON, getText, setContent, insertContent, undo, redo, isEmpty, cancelUpload, retryUpload, removeMedia; No single Element Plus root target. Official Select / Button / Tooltip props live under ogToolbar; Dialog / Input / Checkbox / Button props live in ogLinkDialog, ogMediaDialog, and ogSourceDialog groups; expose uses OgEditorHandle without the raw Tiptap editor. | Unsanitized HTML persistence or direct DOM insertion | current | 3.0.1 |
11
+ | Readonly rich text rendering | `OgEditorViewer` from `@origen-ui/editor` | [use-og-editor](../../use-og-editor/SKILL.md) | Available; no recorded use in this Admin project. | owned props: ogContent, ogEmptyText, ogLocale, ogSanitize, ogSsrMode, ogServerSanitize; Use the underlying Tiptap renderer directly when DOM-level rendering control is required. | Rendering untrusted HTML without server sanitization | current | 3.0.1 |
12
+ | Schema-driven create, edit, or readonly forms | `OgForm` from `@origen-ui/form` | [use-og-form](../../use-og-form/SKILL.md) | direct: [src/views/system/user/components/UserEditorForm.vue](../../../../src/views/system/user/components/UserEditorForm.vue) (OgForm); [src/views/system/menu/components/MenuEditorForm.vue](../../../../src/views/system/menu/components/MenuEditorForm.vue) (OgForm); [src/views/system/dept/components/DepartmentEditorForm.vue](../../../../src/views/system/dept/components/DepartmentEditorForm.vue) (OgForm); [src/views/system/dict/components/DictionaryTypeEditorForm.vue](../../../../src/views/system/dict/components/DictionaryTypeEditorForm.vue) (OgForm); [src/views/system/dict/components/DictionaryDataEditorForm.vue](../../../../src/views/system/dict/components/DictionaryDataEditorForm.vue) (OgForm) | owned props: modelValue, ogSchema, ogSectionVariant, ogAnchor, ogScrollToFirstError, ogReadonly, ogColumns, ogResponsiveColumns, ogBaselineKey, ogModelTransform, ogDirtyModelTransform, ogLocale, ogOperationContext, ogOptionsPolicy, ogSubmitOnEnter, ogPermissions, ogRendererRegistry; owned events: fieldChange, dirtyError, optionsError, operationError, validate, update:modelValue, submit, submitInvalid; owned slots: actions, *; exposes: validate, validateResult, validateField, clearValidate, focusField, getFieldMeta, getDirtyFields, getModel, getSubmitModel, isDirty, markClean, reset, resetField, clearFields, clearField, setFields, setFieldValue, getFieldValue, refreshOptions, refreshOptionsResult; Direct top-level ElForm props; model and rules are bound by OgForm. Field targets use ogControl and ogFormItem groups; formRef exposes the native FormInstance. | Element Plus ElForm or removed legacy APIs | current | 3.0.1 |
13
+ | Editable array fields and line-item forms | `OgFormTable`, `createOgFormTableField` from `@origen-ui/form-table` | [use-og-form-table](../../use-og-form-table/SKILL.md) | Available; no recorded use in this Admin project. | owned props: modelValue, rowKey, ogColumns, ogConfig, ogEditMode, ogTableEvents, ogTableSlots, ogReadonly, ogRenderDisabledGridCells, ogQueryDefaults, ogLocal, ogEditableHint, ogEditableHintText, ogShowEditModeButton, ogRowDisabled, ogDisabledHintText, ogLocale, ogFormTableLocale, ogRendererRegistry, selectionTooltip; owned events: update:modelValue, loadSuccess, loadError, pluginError, selectionChange, selectionScopeChange, batchJobChange, transactionConflict, sortChange, search, searchOptionsError, cellChange, filterOptionsError, rowAdd, rowRemove, operationError, update:ogEditMode; owned slots: search, empty, error, expand, beforeActions, actions, afterActions, overflowActions, beforeToolbar, afterToolbar, beforeTable, tableEmpty, tableAppend; exposes: addRow, removeRow, validate, validateRows; Direct ElTable or ElTableV2 props filtered by the active ogConfig.virtual surface; ogTableEvents / ogTableSlots bridge supported native events and slots; getElTable. | Mutating parent form arrays or duplicate remote table fetching | current | 3.0.1 |
14
+ | Standalone query/filter panels | `OgSearch` from `@origen-ui/search` | [use-og-search](../../use-og-search/SKILL.md) | Available; no recorded use in this Admin project. | owned props: modelValue, ogKeyword, ogExpanded, ogConfig, ogRendererRegistry, ogReset, ogLoading, ogPermissions, ogSubmitOnEnter, ogShowReset, ogShowToggle, ogLabelPlacement, ogControlLabelWidth, ogControlLabelStyle; owned events: update:modelValue, update:ogKeyword, update:ogExpanded, search, reset, validate, fieldChange, optionsError; owned slots: *; exposes: submit, validate, reset, getModel, getSubmitParams, setFieldValue, setFields, refreshOptions, cancelOptions, focus, getFieldError, clearErrors, isDirty, getDirtyFields; Direct top-level ElForm props except the model bound by OgSearch; fields use ogControl: { ogType, ...nativeProps, ogEvents, ogSlots }, with field-level ogFormItem and ogFormItemSlots; omit ogControl for input, explicit controls require ogType; instance ogRendererRegistry supports custom:name without widening built-in props; custom remains the field slot; unknown renderers throw; formRef. | Owning list loading or pagination | current | 3.0.1 |
15
+ | Typed local or remote data tables | `OgTable` from `@origen-ui/table` | [use-og-table](../../use-og-table/SKILL.md) | direct: [src/views/system/dict/data/pages/index.vue](../../../../src/views/system/dict/data/pages/index.vue) (OgTable) | owned props: rowKey, ogColumns, ogDataSource, ogConfig, ogQueryDefaults, ogTableEvents, ogTableSlots, ogReadonly, ogRenderDisabledGridCells, ogOnVisibleColumnsChange, selectionTooltip; owned events: selectionChange, loadSuccess, loadError, operationError, pluginError, selectionScopeChange, batchJobChange, transactionConflict, sortChange, search, searchOptionsError, cellChange, filterOptionsError; owned slots: search, empty, error, expand, editor, beforeActions, actions, afterActions, overflowActions, beforeToolbar, afterToolbar, beforeTable, tableEmpty, tableAppend; exposes: refresh, reset, refreshRow, clearFilterMemory, getSelectedRows, getChanges, hasChanges, discardChanges, commitChanges, clearSelection, toggleRowSelection, toggleRowExpansion, getExpandedRows, resetColumnWidths, scrollTo, getState, applyState; Direct ElTable or ElTableV2 props filtered by ogConfig.virtual.enabled; ogTableEvents / ogTableSlots bridge supported native events and slots; getElTable. | Legacy fetch/searchSchema APIs or ElTable | current | 3.0.1 |
16
+ | Editable local tables embedded in a form or workflow | `OgTableLocal` from `@origen-ui/table` | [use-og-table](../../use-og-table/SKILL.md) | Available; no recorded use in this Admin project. | owned props: modelValue, rowKey, ogColumns, ogConfig, ogLocal, ogReadonly, ogTableEvents, ogTableSlots, ogRenderDisabledGridCells, ogQueryDefaults, ogOnVisibleColumnsChange, selectionTooltip; owned events: update:modelValue, loadSuccess, loadError, operationError, pluginError, selectionChange, selectionScopeChange, batchJobChange, transactionConflict, sortChange, search, searchOptionsError, cellChange, filterOptionsError, rowAdd, rowRemove; owned slots: search, empty, error, expand, editor, beforeActions, actions, afterActions, overflowActions, beforeToolbar, afterToolbar, beforeTable, tableEmpty, tableAppend; exposes: addRow, removeRow, refresh, reset, getSelectedRows, clearSelection, toggleRowSelection, toggleRowExpansion, getExpandedRows, resetColumnWidths, scrollTo, getState, applyState; Direct ElTable or ElTableV2 props filtered by the active ogConfig.virtual surface; ogTableEvents / ogTableSlots bridge supported native events and slots; getElTable. | Treating local rows as an implicit remote data source | current | 3.0.1 |
17
+ | Remote CRUD lists with search and paging | `OgTableWithSearch` from `@origen-ui/table-search` | [use-og-table](../../use-og-table/SKILL.md) | direct: [src/views/system/user/pages/index.vue](../../../../src/views/system/user/pages/index.vue) (OgTableWithSearch); [src/views/system/role/pages/index.vue](../../../../src/views/system/role/pages/index.vue) (OgTableWithSearch); [src/views/system/menu/pages/index.vue](../../../../src/views/system/menu/pages/index.vue) (OgTableWithSearch); [src/views/system/dept/pages/index.vue](../../../../src/views/system/dept/pages/index.vue) (OgTableWithSearch); [src/views/system/dict/pages/index.vue](../../../../src/views/system/dict/pages/index.vue) (OgTableWithSearch) | owned props: rowKey, ogColumns, ogDataSource, ogConfig, ogQueryDefaults, ogSearch, selectionTooltip; owned slots: search-*, beforeActions, actions, afterActions, overflowActions, beforeToolbar, editor, empty, error, expand, afterToolbar, beforeTable, tableEmpty, tableAppend, search; exposes: refresh, reset; Direct ElTable or ElTableV2 props filtered by ogConfig.virtual.enabled; ogTableEvents / ogTableSlots bridge table events and slots; ogSearch groups nested search props and events; getElTable / getSearchInstance. | Separate ad-hoc search and table state | current | 3.0.1 |
18
+ | Page-local business tabs | `OgTabs` from `@origen-ui/tabs` | [use-og-router-tabs](../../use-og-router-tabs/SKILL.md) | Available; no recorded use in this Admin project. | owned props: modelValue, ogItems, ogVariant, ogFeatures, ogContextMenu, ogActionPolicy, ogDensity, ogRenderContent, ogReadonly, ogBusy, ogTabsEvents, ogLocale, ogMinTabWidth, ogMaxTabWidth, ogThemeColor, ogSticky, ogFinderThreshold, ogBeforeAction, ogActionHandler; owned events: update:modelValue, update:ogItems, actionRequest, closeRequest, refreshRequest, pinChangeRequest, reorderRequest, operationDenied, operationError, tabClick, tabChange, tabRemove; owned slots: default, label, tabBefore, tabAfter, status, contextMenuTop, contextMenuBottom, header, extra, empty; exposes: close, activate, requestAdd, closeScope, pin, unpin, move, moveTop, moveBottom, refresh, scrollTo, getItems; Direct top-level ElTabs props; Og-owned model and workflow attributes are excluded; ogTabsEvents bridges native callbacks; getNativeTabs. | Using page-local tabs for route workspace state | current | 3.0.1 |
19
+ | Validated file uploads and URL projection | `OgUpload`, `createXhrUploadAdapter` from `@origen-ui/upload` | [use-og-upload](../../use-og-upload/SKILL.md) | Available; no recorded use in this Admin project. | owned props: modelValue, ogAdapter, ogValueType, ogValueCodec, ogAutoUpload, ogBeforeUpload, ogConcurrency, ogConfirmRemove, ogDuplicate, ogLocale, ogMaxSize, ogResolveResponse, ogRetry, ogText, ogTip, ogUploadEvents, ogVariant; owned events: operationError, uploadSuccess, update:modelValue, change, exceed, progress, removeSuccess, validationError; owned slots: default, empty, file, tip; exposes: submit, clearFiles, abort, getFiles, remove, retry, validate; Allowed Element Plus Upload props use their official names at the root; transport, file-list, and lifecycle props are managed by OgUpload, with limit and showFileList exposed as controlled native options; ogUploadEvents exposes change. | Package-level transport clients or mutating internal files | current | 3.0.1 |
20
+ | A single schema-aware field needs to participate in an existing OgForm context | `OgFormItem` from `@origen-ui/form` | [use-og-form](../../use-og-form/SKILL.md) | Available; no recorded use in this Admin project. | owned props: ogName, ogField, ogReadonly, ogLabelTip; owned slots: default, *; Direct top-level ElFormItem props except prop and error, which OgForm owns for field identity and validation.; Use ElFormItem directly for raw Element Plus form-item behavior outside OgForm context. | Using it as a transparent Element Plus ElFormItem replacement | current | 3.0.1 |
21
+ | An advanced integration needs the registered OgForm control renderer | `FieldRenderer` from `@origen-ui/form` | [use-og-form](../../use-og-form/SKILL.md) | Available; no recorded use in this Admin project. | owned props: ogField, ogReadonly, ogA11y; owned slots: options-error; Use the required Element Plus control directly when the schema renderer contract is not needed. | Treating it as a general-purpose Element Plus control wrapper | current | 3.0.1 |
22
+ | Rendering a project SVG sprite icon | `SvgIcon` from `@origen-ui/icons` | [style-og-origen-ui](../../style-og-origen-ui/SKILL.md) | Available; no recorded use in this Admin project. | owned props: name, size, color, label | Passing untrusted or arbitrary symbol identifiers | current | 3.0.1 |
23
+ | Rendering a route workspace with keep-alive semantics | `RouterViewHost` from `@origen-ui/router` | [use-og-router-tabs](../../use-og-router-tabs/SKILL.md) | direct: [src/layouts/AdminLayout.vue](../../../../src/layouts/AdminLayout.vue) (RouterViewHost) | owned props: cacheMax; Use vue-router RouterView directly for route slots, props, or transition control not owned by the workspace host. | Using it as a transparent vue-router RouterView replacement | current | 3.0.1 |
24
+ | Mounting manager-owned dialogs once in the application tree | `OgDialogHost` from `@origen-ui/dialog` | [use-og-dialog](../../use-og-dialog/SKILL.md) | direct: [src/layouts/AdminLayout.vue](../../../../src/layouts/AdminLayout.vue) (OgDialogHost) | owned props: manager; Mount one host in the app tree after installing createOgDialog(), or pass a DialogManager explicitly. | Creating a second app or mounting multiple hosts for one manager | current | 3.0.1 |
25
+ | Displaying breadcrumbs derived from the active route | `RouterBreadcrumb` from `@origen-ui/router/element-plus` | [use-og-router-tabs](../../use-og-router-tabs/SKILL.md) | direct: [src/layouts/BreadcrumbBar.vue](../../../../src/layouts/BreadcrumbBar.vue) (RouterBreadcrumb) | owned slots: default; Element Plus Breadcrumb props stay at the root; by default labels and links come from the active router adapter. | Hard-coding route labels when adapter metadata can provide them | current | 3.0.1 |
26
+ | Rendering adapter-backed route menus with active selection and icon resolution | `RouterMenu` from `@origen-ui/router/element-plus` | [use-og-router-tabs](../../use-og-router-tabs/SKILL.md) | direct: [src/layouts/SideMenu.vue](../../../../src/layouts/SideMenu.vue) (RouterMenu) | owned props: ogResolveIcon, ogMenuEvents, ogNodeProps, ogNodeEvents; owned slots: default; Element Plus Menu props stay at the root except adapter-owned defaultActive; native callbacks use ogMenuEvents, and per-node props/events use ogNodeProps and ogNodeEvents. | Trusting backend import paths or duplicating menu authorization in the view | current | 3.0.1 |
27
+ | Rendering route-backed workspace tabs with route and cache behavior | `RouterTabs` from `@origen-ui/router/tabs` | [use-og-router-tabs](../../use-og-router-tabs/SKILL.md) | direct: [src/layouts/WorkspaceTabs.vue](../../../../src/layouts/WorkspaceTabs.vue) (RouterTabs) | owned props: ogFeatures, ogLocale, ogAddTab; Element Plus Tabs props stay at the root; RouterTabs owns route-backed tab identity and activation while ogFeatures and ogAddTab configure workspace behavior.; Do not pass modelValue to control the active workspace tab; RouterTabs derives tab identity and activation from the route workspace. | Using page-local OgTabs for route workspace state | current | 3.0.1 |
28
+
29
+ ## Companion capabilities
30
+
31
+ | Capability | Public import | Skill | Current Admin use | Avoid | Lifecycle | Package version |
32
+ | ------------------------------------------- | ---------------------------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------- | --------- | --------------- |
33
+ | Awaitable or manager-owned dialog workflows | `createOgDialog, useDialog` from `@origen-ui/dialog` | [use-og-dialog](../../use-og-dialog/SKILL.md) | direct: [src/views/system/user/composables/useUserManagement.ts](../../../../src/views/system/user/composables/useUserManagement.ts) (useDialog); [src/views/system/menu/composables/useMenuManagement.ts](../../../../src/views/system/menu/composables/useMenuManagement.ts) (useDialog) | createApp or a global fallback manager | current | 3.0.1 |
34
+
35
+ <!-- component-catalog:end -->
36
+
37
+ Route menu, breadcrumbs, and workspace tabs use `@origen-ui/router`; application
38
+ HTTP uses `ApiClient` from `@origen-ui/http`.
@@ -7,6 +7,6 @@ description: Build schema-driven create, edit, and readonly business forms with
7
7
 
8
8
  Use `FormField<T>` with `prop: keyof T & string`. Prefer visible, disabled, readonly,
9
9
  dependencies plus linkage, compute, valueChange, or validators for cross-field behavior.
10
- Use `type: 'custom'` with an instance `RendererRegistry`; unknown renderers must fail.
10
+ Use `ogControl: { ogType: 'custom' }` with an instance `RendererRegistry`; unknown renderers must fail.
11
11
  Custom controls must update the supplied model. Do not use removed `resetFields` or
12
12
  `dependsOn` APIs.