@origen-ui/admin-cli 2.0.2 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (888) hide show
  1. package/README.md +20 -9
  2. package/bin/contract-sync.mjs +112 -0
  3. package/bin/lib/errors.mjs +8 -0
  4. package/bin/lib/fs-json.mjs +18 -0
  5. package/bin/lib/hash.mjs +9 -0
  6. package/bin/og-admin.mjs +165 -35
  7. package/bin/sync-project.mjs +717 -0
  8. package/package.json +20 -17
  9. package/templates/current/clean/.agents/skills/admin-component-usage/SKILL.md +28 -0
  10. package/templates/current/clean/.agents/skills/admin-component-usage/references/component-directory.md +270 -0
  11. package/templates/current/clean/.agents/skills/build-admin-feature/SKILL.md +20 -0
  12. package/templates/current/clean/.agents/skills/build-admin-feature/references/component-selection.md +38 -0
  13. package/templates/current/{examples/.codex → clean/.agents}/skills/use-og-form/SKILL.md +1 -1
  14. package/templates/current/{examples/.codex → clean/.agents}/skills/use-og-form-table/SKILL.md +4 -3
  15. package/templates/current/clean/{.codex → .agents}/skills/use-og-search/SKILL.md +3 -3
  16. package/templates/current/clean/.agents/skills/use-og-table/SKILL.md +22 -0
  17. package/templates/current/{examples/.codex → clean/.agents}/skills/use-og-upload/SKILL.md +6 -5
  18. package/templates/current/clean/.api-client-e2e.config.ts +13 -0
  19. package/templates/current/clean/.claude/rules/01-feature-architecture.md +10 -0
  20. package/templates/current/clean/.claude/rules/02-vue-typescript.md +10 -0
  21. package/templates/current/clean/.claude/rules/03-component-policy.md +31 -0
  22. package/templates/current/clean/.claude/rules/04-api-auth-router.md +10 -0
  23. package/templates/current/clean/.claude/rules/05-style.md +10 -0
  24. package/templates/current/clean/.claude/rules/06-quality.md +10 -0
  25. package/templates/current/clean/.claude/skills/admin-component-usage/SKILL.md +28 -0
  26. package/templates/current/clean/.claude/skills/admin-component-usage/references/component-directory.md +270 -0
  27. package/templates/current/clean/.claude/skills/build-admin-feature/SKILL.md +20 -0
  28. package/templates/current/clean/.claude/skills/build-admin-feature/references/component-selection.md +38 -0
  29. package/templates/current/clean/{.codex → .claude}/skills/use-og-form/SKILL.md +1 -1
  30. package/templates/current/clean/{.codex → .claude}/skills/use-og-form-table/SKILL.md +4 -3
  31. package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-search/SKILL.md +3 -3
  32. package/templates/current/clean/.claude/skills/use-og-table/SKILL.md +22 -0
  33. package/templates/current/clean/{.codex → .claude}/skills/use-og-upload/SKILL.md +6 -5
  34. package/templates/current/clean/.codebuddy/rules/01-feature-architecture.md +2 -2
  35. package/templates/current/clean/.codebuddy/rules/03-component-policy.md +4 -1
  36. package/templates/current/clean/.codebuddy/skills/admin-component-usage/SKILL.md +31 -0
  37. package/templates/current/clean/.codebuddy/skills/admin-component-usage/references/component-directory.md +270 -0
  38. package/templates/current/clean/.codebuddy/skills/build-admin-feature/SKILL.md +11 -5
  39. package/templates/current/clean/.codebuddy/skills/build-admin-feature/references/component-selection.md +38 -0
  40. package/templates/current/clean/.codebuddy/skills/use-og-form/SKILL.md +1 -1
  41. package/templates/current/clean/.codebuddy/skills/use-og-form-table/SKILL.md +4 -3
  42. package/templates/current/clean/.codebuddy/skills/use-og-search/SKILL.md +3 -3
  43. package/templates/current/clean/.codebuddy/skills/use-og-table/SKILL.md +16 -10
  44. package/templates/current/clean/.codebuddy/skills/use-og-upload/SKILL.md +6 -5
  45. package/templates/current/clean/.codex/AGENTS.md +55 -8
  46. package/templates/current/clean/.codex/rules/01-feature-architecture.md +2 -2
  47. package/templates/current/clean/.codex/rules/03-component-policy.md +4 -1
  48. package/templates/current/clean/.cursor/rules/.generated +5 -0
  49. package/templates/current/clean/.cursor/rules/01-feature-architecture.mdc +2 -2
  50. package/templates/current/clean/.cursor/rules/03-component-policy.mdc +4 -1
  51. package/templates/current/clean/.cursor/skills/admin-component-usage/SKILL.md +28 -0
  52. package/templates/current/clean/.cursor/skills/admin-component-usage/references/component-directory.md +270 -0
  53. package/templates/current/clean/.cursor/skills/build-admin-feature/SKILL.md +11 -5
  54. package/templates/current/clean/.cursor/skills/build-admin-feature/references/component-selection.md +38 -0
  55. package/templates/current/clean/.cursor/skills/use-og-form/SKILL.md +1 -1
  56. package/templates/current/clean/.cursor/skills/use-og-form-table/SKILL.md +4 -3
  57. package/templates/current/clean/.cursor/skills/use-og-search/SKILL.md +3 -3
  58. package/templates/current/clean/.cursor/skills/use-og-table/SKILL.md +16 -10
  59. package/templates/current/clean/.cursor/skills/use-og-upload/SKILL.md +6 -5
  60. package/templates/current/clean/{.env.example → .env.dev} +3 -2
  61. package/templates/current/clean/.env.mock +4 -0
  62. package/templates/current/clean/.env.production +5 -0
  63. package/templates/current/clean/.env.test +4 -0
  64. package/templates/current/clean/.prettierignore +17 -0
  65. package/templates/current/clean/.prettierrc +8 -0
  66. package/templates/current/clean/.qoder/rules/01-feature-architecture.md +3 -4
  67. package/templates/current/clean/.qoder/rules/02-vue-typescript.md +1 -2
  68. package/templates/current/clean/.qoder/rules/03-component-policy.md +5 -3
  69. package/templates/current/clean/.qoder/rules/04-api-auth-router.md +1 -2
  70. package/templates/current/clean/.qoder/rules/05-style.md +1 -2
  71. package/templates/current/clean/.qoder/rules/06-quality.md +1 -2
  72. package/templates/current/clean/.qoder/skills/admin-component-usage/SKILL.md +28 -0
  73. package/templates/current/clean/.qoder/skills/admin-component-usage/references/component-directory.md +270 -0
  74. package/templates/current/clean/.qoder/skills/build-admin-feature/SKILL.md +11 -5
  75. package/templates/current/clean/.qoder/skills/build-admin-feature/references/component-selection.md +38 -0
  76. package/templates/current/clean/.qoder/skills/use-og-form/SKILL.md +1 -1
  77. package/templates/current/clean/.qoder/skills/use-og-form-table/SKILL.md +4 -3
  78. package/templates/current/clean/.qoder/skills/use-og-search/SKILL.md +3 -3
  79. package/templates/current/clean/.qoder/skills/use-og-table/SKILL.md +16 -10
  80. package/templates/current/clean/.qoder/skills/use-og-upload/SKILL.md +6 -5
  81. package/templates/current/clean/.zcode/skills/admin-component-usage/SKILL.md +28 -0
  82. package/templates/current/clean/.zcode/skills/admin-component-usage/references/component-directory.md +270 -0
  83. package/templates/current/clean/.zcode/skills/build-admin-feature/SKILL.md +20 -0
  84. package/templates/current/clean/.zcode/skills/build-admin-feature/references/component-selection.md +38 -0
  85. package/templates/current/clean/.zcode/skills/style-og-origen-ui/SKILL.md +11 -0
  86. package/templates/current/clean/.zcode/skills/use-og-dialog/SKILL.md +12 -0
  87. package/templates/current/clean/.zcode/skills/use-og-editor/SKILL.md +25 -0
  88. package/templates/current/clean/.zcode/skills/use-og-form/SKILL.md +12 -0
  89. package/templates/current/clean/.zcode/skills/use-og-form-table/SKILL.md +26 -0
  90. package/templates/current/clean/.zcode/skills/use-og-http/SKILL.md +13 -0
  91. package/templates/current/clean/.zcode/skills/use-og-router-tabs/SKILL.md +11 -0
  92. package/templates/current/clean/.zcode/skills/use-og-search/SKILL.md +14 -0
  93. package/templates/current/clean/.zcode/skills/use-og-table/SKILL.md +22 -0
  94. package/templates/current/clean/.zcode/skills/use-og-upload/SKILL.md +26 -0
  95. package/templates/current/clean/AGENTS.md +55 -9
  96. package/templates/current/clean/CHANGELOG.md +107 -0
  97. package/templates/current/clean/CLAUDE.md +3 -0
  98. package/templates/current/clean/README.md +58 -88
  99. package/templates/current/clean/component-catalog.json +766 -348
  100. package/templates/current/clean/component-catalog.v2.json +2040 -0
  101. package/templates/current/clean/docs/components/dialog.md +405 -0
  102. package/templates/current/clean/docs/components/editor-viewer.md +87 -0
  103. package/templates/current/clean/docs/components/editor.md +275 -0
  104. package/templates/current/clean/docs/components/form-table.md +222 -0
  105. package/templates/current/clean/docs/components/form.md +750 -0
  106. package/templates/current/clean/docs/components/index.md +44 -0
  107. package/templates/current/clean/docs/components/router.md +452 -0
  108. package/templates/current/clean/docs/components/search.md +1205 -0
  109. package/templates/current/clean/docs/components/svg-icon.md +124 -0
  110. package/templates/current/clean/docs/components/table-local.md +176 -0
  111. package/templates/current/clean/docs/components/table-with-search.md +207 -0
  112. package/templates/current/clean/docs/components/table.md +813 -0
  113. package/templates/current/clean/docs/components/tabs.md +440 -0
  114. package/templates/current/clean/docs/components/upload.md +349 -0
  115. package/templates/current/clean/eslint.config.js +89 -0
  116. package/templates/current/clean/index.html +1 -1
  117. package/templates/current/clean/openapi.json +10048 -999
  118. package/templates/current/clean/package.json +45 -33
  119. package/templates/current/clean/playwright.config.ts +20 -6
  120. package/templates/current/clean/playwright.mock.config.ts +42 -0
  121. package/templates/current/clean/pnpm-workspace.yaml +19 -3
  122. package/templates/current/clean/recipes/remote-crud-dialog-form.vue +15 -13
  123. package/templates/current/clean/scaffold.lock.json +164 -4
  124. package/templates/current/clean/scripts/api-codegen.config.ts +35 -0
  125. package/templates/current/clean/scripts/api-codegen.ts +2015 -0
  126. package/templates/current/clean/scripts/api-templates/http-client.ejs +359 -0
  127. package/templates/current/clean/scripts/check-admin-scaffold.mjs +311 -17
  128. package/templates/current/clean/scripts/generate-api.ts +290 -85
  129. package/templates/current/clean/scripts/lib/admin-component-catalog.mjs +515 -0
  130. package/templates/current/clean/scripts/lib/repository-root.mjs +9 -0
  131. package/templates/current/clean/scripts/mock-api.ts +1356 -0
  132. package/templates/current/clean/scripts/remove-examples.mjs +9 -34
  133. package/templates/current/clean/src/App.vue +9 -18
  134. package/templates/current/clean/src/api/generated/data-contracts.ts +23 -265
  135. package/templates/current/clean/src/api/generated/http-client.ts +351 -180
  136. package/templates/current/clean/src/api/generated/index.ts +22 -0
  137. package/templates/current/clean/src/api/generated/services/auth.ts +123 -0
  138. package/templates/current/clean/src/api/generated/services/common/files.ts +111 -0
  139. package/templates/current/clean/src/api/generated/services/monitor/cache.ts +164 -0
  140. package/templates/current/clean/src/api/generated/services/monitor/job.ts +195 -0
  141. package/templates/current/clean/src/api/generated/services/monitor/jobLog.ts +126 -0
  142. package/templates/current/clean/src/api/generated/services/monitor/logininfor.ts +126 -0
  143. package/templates/current/clean/src/api/generated/services/monitor/online.ts +66 -0
  144. package/templates/current/clean/src/api/generated/services/monitor/operlog.ts +106 -0
  145. package/templates/current/clean/src/api/generated/services/monitor/server.ts +41 -0
  146. package/templates/current/clean/src/api/generated/services/system/configs.ts +190 -0
  147. package/templates/current/clean/src/api/generated/services/system/departments.ts +173 -0
  148. package/templates/current/clean/src/api/generated/services/system/dictionaries/data.ts +169 -0
  149. package/templates/current/clean/src/api/generated/services/system/dictionaries/types.ts +187 -0
  150. package/templates/current/clean/src/api/generated/services/system/index.ts +158 -0
  151. package/templates/current/clean/src/api/generated/services/system/menus.ts +193 -0
  152. package/templates/current/clean/src/api/generated/services/system/notices.ts +221 -0
  153. package/templates/current/clean/src/api/generated/services/system/posts.ts +168 -0
  154. package/templates/current/clean/src/api/generated/services/system/roles.ts +354 -0
  155. package/templates/current/clean/src/api/generated/services/system/users.ts +425 -0
  156. package/templates/current/clean/src/api/generated/services/tool/code-generator.ts +304 -0
  157. package/templates/current/clean/src/api/generated/types/auth.types.ts +132 -0
  158. package/templates/current/clean/src/api/generated/types/common/files.types.ts +57 -0
  159. package/templates/current/clean/src/api/generated/types/common.ts +174 -0
  160. package/templates/current/clean/src/api/generated/types/enum-dict.ts +94 -0
  161. package/templates/current/clean/src/api/generated/types/enums.ts +155 -0
  162. package/templates/current/clean/src/api/generated/types/monitor/cache.types.ts +149 -0
  163. package/templates/current/clean/src/api/generated/types/monitor/job.types.ts +207 -0
  164. package/templates/current/clean/src/api/generated/types/monitor/jobLog.types.ts +134 -0
  165. package/templates/current/clean/src/api/generated/types/monitor/logininfor.types.ts +135 -0
  166. package/templates/current/clean/src/api/generated/types/monitor/online.types.ts +80 -0
  167. package/templates/current/clean/src/api/generated/types/monitor/operlog.types.ts +126 -0
  168. package/templates/current/clean/src/api/generated/types/monitor/server.types.ts +205 -0
  169. package/templates/current/clean/src/api/generated/types/system/configs.types.ts +200 -0
  170. package/templates/current/clean/src/api/generated/types/system/departments.types.ts +145 -0
  171. package/templates/current/clean/src/api/generated/types/system/dictionaries/data.types.ts +210 -0
  172. package/templates/current/clean/src/api/generated/types/system/dictionaries/types.types.ts +221 -0
  173. package/templates/current/clean/src/api/generated/types/system/index.types.ts +19 -0
  174. package/templates/current/clean/src/api/generated/types/system/menus.types.ts +234 -0
  175. package/templates/current/clean/src/api/generated/types/system/notices.types.ts +270 -0
  176. package/templates/current/clean/src/api/generated/types/system/posts.types.ts +198 -0
  177. package/templates/current/clean/src/api/generated/types/system/roles.types.ts +410 -0
  178. package/templates/current/clean/src/api/generated/types/system/users.types.ts +413 -0
  179. package/templates/current/clean/src/api/generated/types/tool/code-generator.types.ts +388 -0
  180. package/templates/current/clean/src/api/index.ts +44 -39
  181. package/templates/current/clean/src/app/__tests__/api-generated.types.ts +24 -0
  182. package/templates/current/clean/src/app/api.ts +6 -0
  183. package/templates/current/clean/src/app/authorization/permission.ts +9 -0
  184. package/templates/current/{examples/src/app → clean/src/app/config}/runtimeConfig.ts +44 -12
  185. package/templates/current/clean/src/app/errors/errorMessage.ts +80 -0
  186. package/templates/current/clean/src/app/http/client.ts +141 -0
  187. package/templates/current/clean/src/app/http/http-adapter.ts +71 -0
  188. package/templates/current/{examples/src/app → clean/src/app/i18n}/adminLocale.ts +25 -19
  189. package/templates/current/clean/src/app/{localeFormat.ts → i18n/localeFormat.ts} +29 -6
  190. package/templates/current/clean/src/app/i18n/origenUiLocale.ts +15 -0
  191. package/templates/current/clean/src/app/menu/menu.ts +175 -0
  192. package/templates/current/clean/src/app/menu/menuTypes.ts +20 -0
  193. package/templates/current/clean/src/{features → app}/security/devtoolsProtection.ts +8 -7
  194. package/templates/current/clean/src/app/ui/createAdminUi.ts +31 -0
  195. package/templates/current/clean/src/app/ui/iconCatalog.ts +71 -0
  196. package/templates/current/clean/src/assets/icons/appearance.svg +1 -0
  197. package/templates/current/clean/src/assets/icons/arrow-right.svg +1 -0
  198. package/templates/current/clean/src/assets/icons/check.svg +1 -0
  199. package/templates/current/clean/src/assets/icons/circle-check.svg +1 -0
  200. package/templates/current/clean/src/assets/icons/default.svg +4 -0
  201. package/templates/current/clean/src/assets/icons/directory/setting.svg +1 -0
  202. package/templates/current/clean/src/assets/icons/expand.svg +1 -0
  203. package/templates/current/clean/src/assets/icons/fold.svg +1 -0
  204. package/templates/current/clean/src/assets/icons/key.svg +1 -0
  205. package/templates/current/clean/src/assets/icons/lock.svg +1 -0
  206. package/templates/current/clean/src/assets/icons/monitor.svg +1 -0
  207. package/templates/current/clean/src/assets/icons/moon.svg +11 -0
  208. package/templates/current/clean/src/assets/icons/page/department.svg +1 -0
  209. package/templates/current/clean/src/assets/icons/page/dictionary.svg +1 -0
  210. package/templates/current/clean/src/assets/icons/page/menus.svg +1 -0
  211. package/templates/current/clean/src/assets/icons/page/user.svg +1 -0
  212. package/templates/current/clean/src/assets/icons/page/users.svg +1 -0
  213. package/templates/current/clean/src/assets/icons/plus.svg +1 -0
  214. package/templates/current/clean/src/assets/icons/profile.svg +1 -0
  215. package/templates/current/clean/src/assets/icons/refresh.svg +1 -0
  216. package/templates/current/clean/src/assets/icons/roles.svg +1 -0
  217. package/templates/current/clean/src/assets/icons/search.svg +1 -0
  218. package/templates/current/clean/src/assets/icons/sunny.svg +1 -0
  219. package/templates/current/clean/src/assets/icons/system.svg +1 -0
  220. package/templates/current/clean/src/assets/icons/theme-auto.svg +14 -0
  221. package/templates/current/clean/src/assets/icons/tune.svg +13 -0
  222. package/templates/current/clean/src/{features/shell/components → components}/RouteProgress.vue +2 -2
  223. package/templates/current/{examples/src/features/system/access → clean/src}/composables/useAuthorizationRefresh.ts +6 -1
  224. package/templates/current/clean/src/composables/useSystemTableSearchVisibility.ts +33 -0
  225. package/templates/current/clean/src/{features/appearance/composables → composables}/useTheme.ts +1 -1
  226. package/templates/current/clean/src/env.d.ts +6 -19
  227. package/templates/current/clean/src/layouts/AdminLayout.vue +7 -9
  228. package/templates/current/clean/src/{features/shell/components → layouts}/AdminWatermark.vue +2 -2
  229. package/templates/current/clean/src/layouts/BreadcrumbBar.vue +9 -1
  230. package/templates/current/clean/src/layouts/SideMenu.vue +7 -15
  231. package/templates/current/clean/src/{features/appearance/components → layouts}/ThemePanel.vue +39 -11
  232. package/templates/current/clean/src/layouts/TopBar.vue +60 -28
  233. package/templates/current/clean/src/layouts/WorkspaceTabs.vue +10 -1
  234. package/templates/current/clean/src/layouts/topBarMenuSearch.ts +25 -4
  235. package/templates/current/clean/src/locales/en-US.json +227 -219
  236. package/templates/current/clean/src/locales/index.ts +72 -32
  237. package/templates/current/clean/src/locales/messages-types.ts +15 -10
  238. package/templates/current/clean/src/locales/vue-i18n.d.ts +1 -1
  239. package/templates/current/clean/src/locales/zh-CN.json +226 -218
  240. package/templates/current/clean/src/locales/zh-TW.json +222 -214
  241. package/templates/current/clean/src/main.ts +59 -30
  242. package/templates/current/clean/src/router/bootstrap.ts +69 -24
  243. package/templates/current/clean/src/router/dynamic/componentLoader.ts +150 -0
  244. package/templates/current/clean/src/router/{dynamicMenuRefresh.ts → dynamic/dynamicMenuRefresh.ts} +6 -2
  245. package/templates/current/clean/src/router/dynamic/dynamicRoutes.ts +247 -0
  246. package/templates/current/clean/src/router/navigation/guards.ts +12 -0
  247. package/templates/current/clean/src/router/navigation/paths.ts +28 -0
  248. package/templates/current/clean/src/router/navigation/staticRoutes.ts +109 -0
  249. package/templates/current/clean/src/router/{queryEncryption.ts → query/queryEncryption.ts} +29 -12
  250. package/templates/current/clean/src/router/query/routeQuery.ts +29 -0
  251. package/templates/current/clean/src/router/{useRouteQueryDefaults.ts → query/useRouteQueryDefaults.ts} +9 -8
  252. package/templates/current/clean/src/router/query/useRouteQueryDefaults.types.ts +28 -0
  253. package/templates/current/clean/src/router/{runtimeErrorRecovery.ts → recovery/runtimeErrorRecovery.ts} +21 -3
  254. package/templates/current/clean/src/{features/auth/store → store}/auth.ts +96 -61
  255. package/templates/current/clean/src/store/dictionaries.ts +86 -0
  256. package/templates/current/clean/src/{features/shell/store → store}/sidebar.ts +9 -2
  257. package/templates/current/{examples/src/features/appearance → clean/src}/store/theme.ts +8 -4
  258. package/templates/current/clean/src/styles/layout.css +51 -0
  259. package/templates/current/clean/src/templates/og-form.ts +7 -2
  260. package/templates/current/clean/src/templates/og-table.ts +88 -20
  261. package/templates/current/clean/src/templates/router.ts +11 -2
  262. package/templates/current/clean/src/utils/color-mix.ts +6 -2
  263. package/templates/current/clean/src/utils/download.ts +11 -0
  264. package/templates/current/clean/src/utils/permissions.ts +1 -1
  265. package/templates/current/clean/src/utils/retryableDialog.ts +46 -0
  266. package/templates/current/clean/src/{features → views}/errors/pages/Forbidden.vue +6 -2
  267. package/templates/current/clean/src/views/errors/pages/MethodNotAllowed.vue +34 -0
  268. package/templates/current/clean/src/{features → views}/errors/pages/NotFound.vue +6 -2
  269. package/templates/current/clean/src/{features → views}/errors/pages/ServerError.vue +6 -2
  270. package/templates/current/clean/src/{features/auth/pages/Login.vue → views/login/pages/index.vue} +99 -10
  271. package/templates/current/clean/src/views/system/access/services/admin-repository.ts +489 -0
  272. package/templates/current/clean/src/views/system/access/services/rbac.ts +317 -0
  273. package/templates/current/clean/src/views/system/dept/components/DepartmentEditorForm.vue +87 -0
  274. package/templates/current/clean/src/views/system/dept/composables/useDepartmentManagement.ts +314 -0
  275. package/templates/current/clean/src/views/system/dept/pages/index.vue +44 -0
  276. package/templates/current/clean/src/views/system/dept/services/departments.ts +168 -0
  277. package/templates/current/clean/src/views/system/dict/components/DictionaryDataEditorForm.vue +98 -0
  278. package/templates/current/clean/src/views/system/dict/components/DictionaryDataPreview.vue +233 -0
  279. package/templates/current/clean/src/views/system/dict/components/DictionaryTypeEditorForm.vue +66 -0
  280. package/templates/current/clean/src/views/system/dict/composables/useDictionaryDataManagement.ts +406 -0
  281. package/templates/current/clean/src/views/system/dict/composables/useDictionaryTypeManagement.ts +329 -0
  282. package/templates/current/clean/src/views/system/dict/data/pages/index.vue +134 -0
  283. package/templates/current/clean/src/views/system/dict/pages/index.vue +113 -0
  284. package/templates/current/clean/src/views/system/dict/services/dictionaries.ts +239 -0
  285. package/templates/current/clean/src/views/system/menu/components/MenuEditorForm.vue +252 -0
  286. package/templates/current/clean/src/views/system/menu/composables/useMenuManagement.ts +357 -0
  287. package/templates/current/clean/src/views/system/menu/menuDraft.ts +45 -0
  288. package/templates/current/clean/src/views/system/menu/pages/ExternalLink.vue +37 -0
  289. package/templates/current/clean/src/views/system/menu/pages/index.vue +75 -0
  290. package/templates/current/clean/src/views/system/post/components/PostEditorForm.vue +69 -0
  291. package/templates/current/clean/src/views/system/post/composables/usePostManagement.ts +245 -0
  292. package/templates/current/clean/src/views/system/post/pages/index.vue +92 -0
  293. package/templates/current/clean/src/views/system/post/services/posts.ts +100 -0
  294. package/templates/current/clean/src/views/system/role/auth-users/pages/index.vue +100 -0
  295. package/templates/current/clean/src/views/system/role/components/RoleDataScopeForm.vue +167 -0
  296. package/templates/current/clean/src/views/system/role/components/RoleEditorForm.vue +165 -0
  297. package/templates/current/clean/src/views/system/role/components/RoleUserSelectForm.vue +129 -0
  298. package/templates/current/clean/src/views/system/role/composables/useRoleManagement.ts +422 -0
  299. package/templates/current/clean/src/views/system/role/composables/useRoleUserManagement.ts +233 -0
  300. package/templates/current/clean/src/views/system/role/pages/index.vue +110 -0
  301. package/templates/current/clean/src/views/system/role/services/roleAccess.ts +162 -0
  302. package/templates/current/clean/src/views/system/user/auth-roles/pages/index.vue +209 -0
  303. package/templates/current/clean/src/views/system/user/components/UserDetailsForm.vue +108 -0
  304. package/templates/current/clean/src/views/system/user/components/UserEditorForm.vue +207 -0
  305. package/templates/current/clean/src/views/system/user/components/UserImportDialog.vue +80 -0
  306. package/templates/current/clean/src/views/system/user/components/UserResetPasswordForm.vue +56 -0
  307. package/templates/current/clean/src/views/system/user/composables/useUserManagement.ts +502 -0
  308. package/templates/current/clean/src/views/system/user/pages/index.vue +459 -0
  309. package/templates/current/clean/tests/e2e/admin-access-business.spec.ts +33 -0
  310. package/templates/current/clean/tests/e2e/admin-shell.spec.ts +50 -0
  311. package/templates/current/clean/tests/e2e/fixtures/adminMockBackend.ts +95 -0
  312. package/templates/current/clean/tests/e2e/fixtures/labelGeometry.ts +52 -0
  313. package/templates/current/clean/tests/e2e/mock-api-generation.spec.ts +27 -0
  314. package/templates/current/clean/tests/e2e/mock-business.spec.ts +555 -0
  315. package/templates/current/clean/tests/e2e/mock-menu-retry-form-label.spec.ts +100 -0
  316. package/templates/current/clean/tests/e2e/mock-shell.spec.ts +25 -0
  317. package/templates/current/clean/tests/e2e/mock-tree-selection-layout.spec.ts +113 -0
  318. package/templates/current/clean/tests/unit/api/api-codegen.spec.ts +893 -0
  319. package/templates/current/clean/tests/unit/api/client.spec.ts +145 -0
  320. package/templates/current/clean/tests/unit/api/generated-http-client.spec.ts +290 -0
  321. package/templates/current/{examples/src → clean/tests/unit}/api/http-adapter.spec.ts +3 -3
  322. package/templates/current/clean/tests/unit/api/system-apis.spec.ts +118 -0
  323. package/templates/current/clean/tests/unit/app/createAdminUi.spec.ts +79 -0
  324. package/templates/current/clean/{src → tests/unit}/app/errorMessage.spec.ts +1 -1
  325. package/templates/current/clean/tests/unit/app/iconCatalog.spec.ts +12 -0
  326. package/templates/current/clean/tests/unit/app/menu.spec.ts +215 -0
  327. package/templates/current/{examples/src → clean/tests/unit}/app/origenUiLocale.spec.ts +1 -1
  328. package/templates/current/{examples/src → clean/tests/unit}/app/permission.spec.ts +4 -5
  329. package/templates/current/clean/tests/unit/app/runtimeConfig.spec.ts +36 -0
  330. package/templates/current/{examples/src/features → clean/tests/unit/app}/security/devtoolsProtection.spec.ts +17 -7
  331. package/templates/current/{examples/src/features/shell → clean/tests/unit}/composables/useRouteProgress.spec.ts +1 -1
  332. package/templates/current/{examples/src/features/shell/components → clean/tests/unit/layouts}/AdminWatermark.spec.ts +5 -7
  333. package/templates/current/{examples/src → clean/tests/unit}/layouts/topBarMenuSearch.spec.ts +25 -8
  334. package/templates/current/clean/{src → tests/unit}/locales/messages.spec.ts +43 -17
  335. package/templates/current/clean/tests/unit/router/dynamicMenuRefresh.spec.ts +151 -0
  336. package/templates/current/clean/tests/unit/router/dynamicRoutes.spec.ts +374 -0
  337. package/templates/current/clean/tests/unit/router/paths.spec.ts +103 -0
  338. package/templates/current/clean/{src → tests/unit}/router/queryEncryption.spec.ts +49 -12
  339. package/templates/current/{examples/src → clean/tests/unit}/router/routeQuery.spec.ts +8 -1
  340. package/templates/current/clean/{src → tests/unit}/router/runtimeErrorRecovery.spec.ts +11 -6
  341. package/templates/current/{examples/src → clean/tests/unit}/router/useRouteQueryDefaults.spec.ts +46 -12
  342. package/templates/current/clean/tests/unit/scripts/mock-api.spec.ts +440 -0
  343. package/templates/current/clean/{scripts → tests/unit/scripts}/vite-build-policy.spec.ts +35 -6
  344. package/templates/current/clean/{src/features/auth → tests/unit}/store/auth.spec.ts +68 -15
  345. package/templates/current/clean/tests/unit/store/dictionaries.spec.ts +106 -0
  346. package/templates/current/{examples/src → clean/tests/unit}/templates/templates.spec.ts +60 -16
  347. package/templates/current/clean/{src/utils/__tests__ → tests/unit/utils}/color-mix.spec.ts +1 -1
  348. package/templates/current/clean/tests/unit/utils/retryableDialog.spec.ts +61 -0
  349. package/templates/current/{examples/src/features/errors/pages → clean/tests/unit/views/errors}/error-pages.spec.ts +11 -7
  350. package/templates/current/clean/tests/unit/views/feature-composables.spec.ts +233 -0
  351. package/templates/current/clean/tests/unit/views/system/access/admin-repository.spec.ts +353 -0
  352. package/templates/current/clean/tests/unit/views/system/access/rbac.spec.ts +329 -0
  353. package/templates/current/clean/tests/unit/views/system/dept/departments.spec.ts +104 -0
  354. package/templates/current/clean/tests/unit/views/system/dict/dictionaries.spec.ts +234 -0
  355. package/templates/current/clean/tests/unit/views/system/menu/menuDraft.spec.ts +77 -0
  356. package/templates/current/clean/tests/unit/views/system/menu/useMenuManagement.spec.ts +339 -0
  357. package/templates/current/clean/tests/unit/views/system/user/searchControl.spec.ts +128 -0
  358. package/templates/current/clean/tsconfig.json +4 -19
  359. package/templates/current/clean/vite.build-policy.ts +97 -22
  360. package/templates/current/clean/vite.config.ts +50 -7
  361. package/templates/current/examples/.agents/skills/admin-component-usage/SKILL.md +28 -0
  362. package/templates/current/examples/.agents/skills/admin-component-usage/references/component-directory.md +270 -0
  363. package/templates/current/examples/.agents/skills/build-admin-feature/SKILL.md +20 -0
  364. package/templates/current/examples/.agents/skills/build-admin-feature/references/component-selection.md +38 -0
  365. package/templates/current/examples/.agents/skills/style-og-origen-ui/SKILL.md +11 -0
  366. package/templates/current/examples/.agents/skills/use-og-dialog/SKILL.md +12 -0
  367. package/templates/current/examples/.agents/skills/use-og-editor/SKILL.md +25 -0
  368. package/templates/current/examples/.agents/skills/use-og-form/SKILL.md +12 -0
  369. package/templates/current/examples/.agents/skills/use-og-form-table/SKILL.md +26 -0
  370. package/templates/current/examples/.agents/skills/use-og-http/SKILL.md +13 -0
  371. package/templates/current/examples/.agents/skills/use-og-router-tabs/SKILL.md +11 -0
  372. package/templates/current/examples/.agents/skills/use-og-search/SKILL.md +14 -0
  373. package/templates/current/examples/.agents/skills/use-og-table/SKILL.md +22 -0
  374. package/templates/current/examples/.agents/skills/use-og-upload/SKILL.md +26 -0
  375. package/templates/current/examples/.api-client-e2e.config.ts +13 -0
  376. package/templates/current/examples/.claude/rules/01-feature-architecture.md +10 -0
  377. package/templates/current/examples/.claude/rules/02-vue-typescript.md +10 -0
  378. package/templates/current/examples/.claude/rules/03-component-policy.md +31 -0
  379. package/templates/current/examples/.claude/rules/04-api-auth-router.md +10 -0
  380. package/templates/current/examples/.claude/rules/05-style.md +10 -0
  381. package/templates/current/examples/.claude/rules/06-quality.md +10 -0
  382. package/templates/current/examples/.claude/skills/admin-component-usage/SKILL.md +28 -0
  383. package/templates/current/examples/.claude/skills/admin-component-usage/references/component-directory.md +270 -0
  384. package/templates/current/examples/.claude/skills/build-admin-feature/SKILL.md +20 -0
  385. package/templates/current/examples/.claude/skills/build-admin-feature/references/component-selection.md +38 -0
  386. package/templates/current/examples/.claude/skills/style-og-origen-ui/SKILL.md +11 -0
  387. package/templates/current/examples/.claude/skills/use-og-dialog/SKILL.md +12 -0
  388. package/templates/current/examples/.claude/skills/use-og-editor/SKILL.md +25 -0
  389. package/templates/current/examples/.claude/skills/use-og-form/SKILL.md +12 -0
  390. package/templates/current/examples/.claude/skills/use-og-form-table/SKILL.md +26 -0
  391. package/templates/current/examples/.claude/skills/use-og-http/SKILL.md +13 -0
  392. package/templates/current/examples/.claude/skills/use-og-router-tabs/SKILL.md +11 -0
  393. package/templates/current/examples/.claude/skills/use-og-search/SKILL.md +14 -0
  394. package/templates/current/examples/.claude/skills/use-og-table/SKILL.md +22 -0
  395. package/templates/current/examples/.claude/skills/use-og-upload/SKILL.md +26 -0
  396. package/templates/current/examples/.codebuddy/rules/01-feature-architecture.md +2 -2
  397. package/templates/current/examples/.codebuddy/rules/03-component-policy.md +4 -1
  398. package/templates/current/examples/.codebuddy/skills/admin-component-usage/SKILL.md +31 -0
  399. package/templates/current/examples/.codebuddy/skills/admin-component-usage/references/component-directory.md +270 -0
  400. package/templates/current/examples/.codebuddy/skills/build-admin-feature/SKILL.md +11 -5
  401. package/templates/current/examples/.codebuddy/skills/build-admin-feature/references/component-selection.md +38 -0
  402. package/templates/current/examples/.codebuddy/skills/use-og-form/SKILL.md +1 -1
  403. package/templates/current/examples/.codebuddy/skills/use-og-form-table/SKILL.md +4 -3
  404. package/templates/current/examples/.codebuddy/skills/use-og-search/SKILL.md +3 -3
  405. package/templates/current/examples/.codebuddy/skills/use-og-table/SKILL.md +16 -10
  406. package/templates/current/examples/.codebuddy/skills/use-og-upload/SKILL.md +6 -5
  407. package/templates/current/examples/.codex/AGENTS.md +55 -8
  408. package/templates/current/examples/.codex/rules/01-feature-architecture.md +2 -2
  409. package/templates/current/examples/.codex/rules/03-component-policy.md +4 -1
  410. package/templates/current/examples/.cursor/rules/.generated +5 -0
  411. package/templates/current/examples/.cursor/rules/01-feature-architecture.mdc +2 -2
  412. package/templates/current/examples/.cursor/rules/03-component-policy.mdc +4 -1
  413. package/templates/current/examples/.cursor/skills/admin-component-usage/SKILL.md +28 -0
  414. package/templates/current/examples/.cursor/skills/admin-component-usage/references/component-directory.md +270 -0
  415. package/templates/current/examples/.cursor/skills/build-admin-feature/SKILL.md +11 -5
  416. package/templates/current/examples/.cursor/skills/build-admin-feature/references/component-selection.md +38 -0
  417. package/templates/current/examples/.cursor/skills/use-og-form/SKILL.md +1 -1
  418. package/templates/current/examples/.cursor/skills/use-og-form-table/SKILL.md +4 -3
  419. package/templates/current/examples/.cursor/skills/use-og-search/SKILL.md +3 -3
  420. package/templates/current/examples/.cursor/skills/use-og-table/SKILL.md +16 -10
  421. package/templates/current/examples/.cursor/skills/use-og-upload/SKILL.md +6 -5
  422. package/templates/current/examples/{.env.example → .env.dev} +3 -2
  423. package/templates/current/examples/.env.mock +4 -0
  424. package/templates/current/examples/.env.production +5 -0
  425. package/templates/current/examples/.env.test +4 -0
  426. package/templates/current/examples/.prettierignore +17 -0
  427. package/templates/current/examples/.prettierrc +8 -0
  428. package/templates/current/examples/.qoder/rules/01-feature-architecture.md +3 -4
  429. package/templates/current/examples/.qoder/rules/02-vue-typescript.md +1 -2
  430. package/templates/current/examples/.qoder/rules/03-component-policy.md +5 -3
  431. package/templates/current/examples/.qoder/rules/04-api-auth-router.md +1 -2
  432. package/templates/current/examples/.qoder/rules/05-style.md +1 -2
  433. package/templates/current/examples/.qoder/rules/06-quality.md +1 -2
  434. package/templates/current/examples/.qoder/skills/admin-component-usage/SKILL.md +28 -0
  435. package/templates/current/examples/.qoder/skills/admin-component-usage/references/component-directory.md +270 -0
  436. package/templates/current/examples/.qoder/skills/build-admin-feature/SKILL.md +11 -5
  437. package/templates/current/examples/.qoder/skills/build-admin-feature/references/component-selection.md +38 -0
  438. package/templates/current/examples/.qoder/skills/use-og-form/SKILL.md +1 -1
  439. package/templates/current/examples/.qoder/skills/use-og-form-table/SKILL.md +4 -3
  440. package/templates/current/examples/.qoder/skills/use-og-search/SKILL.md +3 -3
  441. package/templates/current/examples/.qoder/skills/use-og-table/SKILL.md +16 -10
  442. package/templates/current/examples/.qoder/skills/use-og-upload/SKILL.md +6 -5
  443. package/templates/current/examples/.zcode/skills/admin-component-usage/SKILL.md +28 -0
  444. package/templates/current/examples/.zcode/skills/admin-component-usage/references/component-directory.md +270 -0
  445. package/templates/current/examples/.zcode/skills/build-admin-feature/SKILL.md +20 -0
  446. package/templates/current/examples/.zcode/skills/build-admin-feature/references/component-selection.md +38 -0
  447. package/templates/current/examples/.zcode/skills/style-og-origen-ui/SKILL.md +11 -0
  448. package/templates/current/examples/.zcode/skills/use-og-dialog/SKILL.md +12 -0
  449. package/templates/current/examples/.zcode/skills/use-og-editor/SKILL.md +25 -0
  450. package/templates/current/examples/.zcode/skills/use-og-form/SKILL.md +12 -0
  451. package/templates/current/examples/.zcode/skills/use-og-form-table/SKILL.md +26 -0
  452. package/templates/current/examples/.zcode/skills/use-og-http/SKILL.md +13 -0
  453. package/templates/current/examples/.zcode/skills/use-og-router-tabs/SKILL.md +11 -0
  454. package/templates/current/examples/.zcode/skills/use-og-search/SKILL.md +14 -0
  455. package/templates/current/examples/.zcode/skills/use-og-table/SKILL.md +22 -0
  456. package/templates/current/examples/.zcode/skills/use-og-upload/SKILL.md +26 -0
  457. package/templates/current/examples/AGENTS.md +55 -9
  458. package/templates/current/examples/CHANGELOG.md +107 -0
  459. package/templates/current/examples/CLAUDE.md +3 -0
  460. package/templates/current/examples/README.md +58 -88
  461. package/templates/current/examples/component-catalog.json +766 -348
  462. package/templates/current/examples/component-catalog.v2.json +2040 -0
  463. package/templates/current/examples/docs/components/dialog.md +405 -0
  464. package/templates/current/examples/docs/components/editor-viewer.md +87 -0
  465. package/templates/current/examples/docs/components/editor.md +275 -0
  466. package/templates/current/examples/docs/components/form-table.md +222 -0
  467. package/templates/current/examples/docs/components/form.md +750 -0
  468. package/templates/current/examples/docs/components/index.md +44 -0
  469. package/templates/current/examples/docs/components/router.md +452 -0
  470. package/templates/current/examples/docs/components/search.md +1205 -0
  471. package/templates/current/examples/docs/components/svg-icon.md +124 -0
  472. package/templates/current/examples/docs/components/table-local.md +176 -0
  473. package/templates/current/examples/docs/components/table-with-search.md +207 -0
  474. package/templates/current/examples/docs/components/table.md +813 -0
  475. package/templates/current/examples/docs/components/tabs.md +440 -0
  476. package/templates/current/examples/docs/components/upload.md +349 -0
  477. package/templates/current/examples/eslint.config.js +89 -0
  478. package/templates/current/examples/index.html +1 -1
  479. package/templates/current/examples/openapi.json +10048 -999
  480. package/templates/current/examples/package.json +45 -33
  481. package/templates/current/examples/playwright.config.ts +20 -6
  482. package/templates/current/examples/playwright.mock.config.ts +42 -0
  483. package/templates/current/examples/pnpm-workspace.yaml +19 -3
  484. package/templates/current/examples/recipes/remote-crud-dialog-form.vue +15 -13
  485. package/templates/current/examples/scaffold.lock.json +164 -4
  486. package/templates/current/examples/scripts/api-codegen.config.ts +35 -0
  487. package/templates/current/examples/scripts/api-codegen.ts +2015 -0
  488. package/templates/current/examples/scripts/api-templates/http-client.ejs +359 -0
  489. package/templates/current/examples/scripts/check-admin-scaffold.mjs +311 -17
  490. package/templates/current/examples/scripts/generate-api.ts +290 -85
  491. package/templates/current/examples/scripts/lib/admin-component-catalog.mjs +515 -0
  492. package/templates/current/examples/scripts/lib/repository-root.mjs +9 -0
  493. package/templates/current/examples/scripts/mock-api.ts +1356 -0
  494. package/templates/current/examples/scripts/remove-examples.mjs +9 -34
  495. package/templates/current/examples/src/App.vue +9 -18
  496. package/templates/current/examples/src/api/generated/data-contracts.ts +23 -265
  497. package/templates/current/examples/src/api/generated/http-client.ts +351 -180
  498. package/templates/current/examples/src/api/generated/index.ts +22 -0
  499. package/templates/current/examples/src/api/generated/services/auth.ts +123 -0
  500. package/templates/current/examples/src/api/generated/services/common/files.ts +111 -0
  501. package/templates/current/examples/src/api/generated/services/monitor/cache.ts +164 -0
  502. package/templates/current/examples/src/api/generated/services/monitor/job.ts +195 -0
  503. package/templates/current/examples/src/api/generated/services/monitor/jobLog.ts +126 -0
  504. package/templates/current/examples/src/api/generated/services/monitor/logininfor.ts +126 -0
  505. package/templates/current/examples/src/api/generated/services/monitor/online.ts +66 -0
  506. package/templates/current/examples/src/api/generated/services/monitor/operlog.ts +106 -0
  507. package/templates/current/examples/src/api/generated/services/monitor/server.ts +41 -0
  508. package/templates/current/examples/src/api/generated/services/system/configs.ts +190 -0
  509. package/templates/current/examples/src/api/generated/services/system/departments.ts +173 -0
  510. package/templates/current/examples/src/api/generated/services/system/dictionaries/data.ts +169 -0
  511. package/templates/current/examples/src/api/generated/services/system/dictionaries/types.ts +187 -0
  512. package/templates/current/examples/src/api/generated/services/system/index.ts +158 -0
  513. package/templates/current/examples/src/api/generated/services/system/menus.ts +193 -0
  514. package/templates/current/examples/src/api/generated/services/system/notices.ts +221 -0
  515. package/templates/current/examples/src/api/generated/services/system/posts.ts +168 -0
  516. package/templates/current/examples/src/api/generated/services/system/roles.ts +354 -0
  517. package/templates/current/examples/src/api/generated/services/system/users.ts +425 -0
  518. package/templates/current/examples/src/api/generated/services/tool/code-generator.ts +304 -0
  519. package/templates/current/examples/src/api/generated/types/auth.types.ts +132 -0
  520. package/templates/current/examples/src/api/generated/types/common/files.types.ts +57 -0
  521. package/templates/current/examples/src/api/generated/types/common.ts +174 -0
  522. package/templates/current/examples/src/api/generated/types/enum-dict.ts +94 -0
  523. package/templates/current/examples/src/api/generated/types/enums.ts +155 -0
  524. package/templates/current/examples/src/api/generated/types/monitor/cache.types.ts +149 -0
  525. package/templates/current/examples/src/api/generated/types/monitor/job.types.ts +207 -0
  526. package/templates/current/examples/src/api/generated/types/monitor/jobLog.types.ts +134 -0
  527. package/templates/current/examples/src/api/generated/types/monitor/logininfor.types.ts +135 -0
  528. package/templates/current/examples/src/api/generated/types/monitor/online.types.ts +80 -0
  529. package/templates/current/examples/src/api/generated/types/monitor/operlog.types.ts +126 -0
  530. package/templates/current/examples/src/api/generated/types/monitor/server.types.ts +205 -0
  531. package/templates/current/examples/src/api/generated/types/system/configs.types.ts +200 -0
  532. package/templates/current/examples/src/api/generated/types/system/departments.types.ts +145 -0
  533. package/templates/current/examples/src/api/generated/types/system/dictionaries/data.types.ts +210 -0
  534. package/templates/current/examples/src/api/generated/types/system/dictionaries/types.types.ts +221 -0
  535. package/templates/current/examples/src/api/generated/types/system/index.types.ts +19 -0
  536. package/templates/current/examples/src/api/generated/types/system/menus.types.ts +234 -0
  537. package/templates/current/examples/src/api/generated/types/system/notices.types.ts +270 -0
  538. package/templates/current/examples/src/api/generated/types/system/posts.types.ts +198 -0
  539. package/templates/current/examples/src/api/generated/types/system/roles.types.ts +410 -0
  540. package/templates/current/examples/src/api/generated/types/system/users.types.ts +413 -0
  541. package/templates/current/examples/src/api/generated/types/tool/code-generator.types.ts +388 -0
  542. package/templates/current/examples/src/api/index.ts +44 -39
  543. package/templates/current/examples/src/app/__tests__/api-generated.types.ts +24 -0
  544. package/templates/current/examples/src/app/api.ts +6 -0
  545. package/templates/current/examples/src/app/authorization/permission.ts +9 -0
  546. package/templates/current/{clean/src/app → examples/src/app/config}/runtimeConfig.ts +44 -12
  547. package/templates/current/examples/src/app/errors/errorMessage.ts +80 -0
  548. package/templates/current/examples/src/app/http/client.ts +141 -0
  549. package/templates/current/examples/src/app/http/http-adapter.ts +71 -0
  550. package/templates/current/{clean/src/app → examples/src/app/i18n}/adminLocale.ts +25 -19
  551. package/templates/current/examples/src/app/{localeFormat.ts → i18n/localeFormat.ts} +29 -6
  552. package/templates/current/examples/src/app/i18n/origenUiLocale.ts +15 -0
  553. package/templates/current/examples/src/app/menu/menu.ts +175 -0
  554. package/templates/current/examples/src/app/menu/menuTypes.ts +20 -0
  555. package/templates/current/examples/src/{features → app}/security/devtoolsProtection.ts +8 -7
  556. package/templates/current/examples/src/app/ui/createAdminUi.ts +31 -0
  557. package/templates/current/examples/src/app/ui/iconCatalog.ts +71 -0
  558. package/templates/current/examples/src/assets/icons/appearance.svg +1 -0
  559. package/templates/current/examples/src/assets/icons/arrow-right.svg +1 -0
  560. package/templates/current/examples/src/assets/icons/check.svg +1 -0
  561. package/templates/current/examples/src/assets/icons/circle-check.svg +1 -0
  562. package/templates/current/examples/src/assets/icons/default.svg +4 -0
  563. package/templates/current/examples/src/assets/icons/directory/setting.svg +1 -0
  564. package/templates/current/examples/src/assets/icons/expand.svg +1 -0
  565. package/templates/current/examples/src/assets/icons/fold.svg +1 -0
  566. package/templates/current/examples/src/assets/icons/key.svg +1 -0
  567. package/templates/current/examples/src/assets/icons/lock.svg +1 -0
  568. package/templates/current/examples/src/assets/icons/monitor.svg +1 -0
  569. package/templates/current/examples/src/assets/icons/moon.svg +11 -0
  570. package/templates/current/examples/src/assets/icons/page/department.svg +1 -0
  571. package/templates/current/examples/src/assets/icons/page/dictionary.svg +1 -0
  572. package/templates/current/examples/src/assets/icons/page/menus.svg +1 -0
  573. package/templates/current/examples/src/assets/icons/page/user.svg +1 -0
  574. package/templates/current/examples/src/assets/icons/page/users.svg +1 -0
  575. package/templates/current/examples/src/assets/icons/plus.svg +1 -0
  576. package/templates/current/examples/src/assets/icons/profile.svg +1 -0
  577. package/templates/current/examples/src/assets/icons/refresh.svg +1 -0
  578. package/templates/current/examples/src/assets/icons/roles.svg +1 -0
  579. package/templates/current/examples/src/assets/icons/search.svg +1 -0
  580. package/templates/current/examples/src/assets/icons/sunny.svg +1 -0
  581. package/templates/current/examples/src/assets/icons/system.svg +1 -0
  582. package/templates/current/examples/src/assets/icons/theme-auto.svg +14 -0
  583. package/templates/current/examples/src/assets/icons/tune.svg +13 -0
  584. package/templates/current/examples/src/{features/shell/components → components}/RouteProgress.vue +2 -2
  585. package/templates/current/{clean/src/features/system/access → examples/src}/composables/useAuthorizationRefresh.ts +6 -1
  586. package/templates/current/examples/src/composables/useSystemTableSearchVisibility.ts +33 -0
  587. package/templates/current/examples/src/{features/appearance/composables → composables}/useTheme.ts +1 -1
  588. package/templates/current/examples/src/env.d.ts +6 -19
  589. package/templates/current/examples/src/layouts/AdminLayout.vue +7 -9
  590. package/templates/current/examples/src/{features/shell/components → layouts}/AdminWatermark.vue +2 -2
  591. package/templates/current/examples/src/layouts/BreadcrumbBar.vue +9 -1
  592. package/templates/current/examples/src/layouts/SideMenu.vue +7 -15
  593. package/templates/current/examples/src/{features/appearance/components → layouts}/ThemePanel.vue +39 -11
  594. package/templates/current/examples/src/layouts/TopBar.vue +60 -28
  595. package/templates/current/examples/src/layouts/WorkspaceTabs.vue +10 -1
  596. package/templates/current/examples/src/layouts/topBarMenuSearch.ts +25 -4
  597. package/templates/current/examples/src/locales/en-US.json +227 -219
  598. package/templates/current/examples/src/locales/index.ts +72 -32
  599. package/templates/current/examples/src/locales/messages-types.ts +15 -10
  600. package/templates/current/examples/src/locales/vue-i18n.d.ts +1 -1
  601. package/templates/current/examples/src/locales/zh-CN.json +226 -218
  602. package/templates/current/examples/src/locales/zh-TW.json +222 -214
  603. package/templates/current/examples/src/main.ts +50 -40
  604. package/templates/current/examples/src/router/bootstrap.ts +69 -24
  605. package/templates/current/examples/src/router/dynamic/componentLoader.ts +150 -0
  606. package/templates/current/examples/src/router/{dynamicMenuRefresh.ts → dynamic/dynamicMenuRefresh.ts} +6 -2
  607. package/templates/current/examples/src/router/dynamic/dynamicRoutes.ts +247 -0
  608. package/templates/current/examples/src/router/navigation/guards.ts +12 -0
  609. package/templates/current/examples/src/router/navigation/paths.ts +28 -0
  610. package/templates/current/examples/src/router/navigation/staticRoutes.ts +109 -0
  611. package/templates/current/examples/src/router/{queryEncryption.ts → query/queryEncryption.ts} +29 -12
  612. package/templates/current/examples/src/router/query/routeQuery.ts +29 -0
  613. package/templates/current/examples/src/router/{useRouteQueryDefaults.ts → query/useRouteQueryDefaults.ts} +9 -8
  614. package/templates/current/examples/src/router/query/useRouteQueryDefaults.types.ts +28 -0
  615. package/templates/current/examples/src/router/{runtimeErrorRecovery.ts → recovery/runtimeErrorRecovery.ts} +21 -3
  616. package/templates/current/examples/src/{features/auth/store → store}/auth.ts +96 -61
  617. package/templates/current/examples/src/store/dictionaries.ts +86 -0
  618. package/templates/current/examples/src/{features/shell/store → store}/sidebar.ts +9 -2
  619. package/templates/current/{clean/src/features/appearance → examples/src}/store/theme.ts +8 -4
  620. package/templates/current/examples/src/styles/layout.css +51 -0
  621. package/templates/current/examples/src/templates/og-form.ts +7 -2
  622. package/templates/current/examples/src/templates/og-table.ts +88 -20
  623. package/templates/current/examples/src/templates/router.ts +11 -2
  624. package/templates/current/examples/src/utils/color-mix.ts +6 -2
  625. package/templates/current/examples/src/utils/download.ts +11 -0
  626. package/templates/current/examples/src/utils/permissions.ts +1 -1
  627. package/templates/current/examples/src/utils/retryableDialog.ts +46 -0
  628. package/templates/current/{clean/scripts/clean-overlay/src/features → examples/src/views}/errors/pages/Forbidden.vue +6 -2
  629. package/templates/current/examples/src/views/errors/pages/MethodNotAllowed.vue +34 -0
  630. package/templates/current/examples/{scripts/clean-overlay/src/features → src/views}/errors/pages/NotFound.vue +6 -2
  631. package/templates/current/examples/{scripts/clean-overlay/src/features → src/views}/errors/pages/ServerError.vue +6 -2
  632. package/templates/current/examples/src/{features/auth/pages/Login.vue → views/login/pages/index.vue} +99 -10
  633. package/templates/current/examples/src/views/system/access/services/admin-repository.ts +489 -0
  634. package/templates/current/examples/src/views/system/access/services/rbac.ts +317 -0
  635. package/templates/current/examples/src/views/system/dept/components/DepartmentEditorForm.vue +87 -0
  636. package/templates/current/examples/src/views/system/dept/composables/useDepartmentManagement.ts +314 -0
  637. package/templates/current/examples/src/views/system/dept/pages/index.vue +44 -0
  638. package/templates/current/examples/src/views/system/dept/services/departments.ts +168 -0
  639. package/templates/current/examples/src/views/system/dict/components/DictionaryDataEditorForm.vue +98 -0
  640. package/templates/current/examples/src/views/system/dict/components/DictionaryDataPreview.vue +233 -0
  641. package/templates/current/examples/src/views/system/dict/components/DictionaryTypeEditorForm.vue +66 -0
  642. package/templates/current/examples/src/views/system/dict/composables/useDictionaryDataManagement.ts +406 -0
  643. package/templates/current/examples/src/views/system/dict/composables/useDictionaryTypeManagement.ts +329 -0
  644. package/templates/current/examples/src/views/system/dict/data/pages/index.vue +134 -0
  645. package/templates/current/examples/src/views/system/dict/pages/index.vue +113 -0
  646. package/templates/current/examples/src/views/system/dict/services/dictionaries.ts +239 -0
  647. package/templates/current/examples/src/views/system/menu/components/MenuEditorForm.vue +252 -0
  648. package/templates/current/examples/src/views/system/menu/composables/useMenuManagement.ts +357 -0
  649. package/templates/current/examples/src/views/system/menu/menuDraft.ts +45 -0
  650. package/templates/current/examples/src/views/system/menu/pages/ExternalLink.vue +37 -0
  651. package/templates/current/examples/src/views/system/menu/pages/index.vue +75 -0
  652. package/templates/current/examples/src/views/system/post/components/PostEditorForm.vue +69 -0
  653. package/templates/current/examples/src/views/system/post/composables/usePostManagement.ts +245 -0
  654. package/templates/current/examples/src/views/system/post/pages/index.vue +92 -0
  655. package/templates/current/examples/src/views/system/post/services/posts.ts +100 -0
  656. package/templates/current/examples/src/views/system/role/auth-users/pages/index.vue +100 -0
  657. package/templates/current/examples/src/views/system/role/components/RoleDataScopeForm.vue +167 -0
  658. package/templates/current/examples/src/views/system/role/components/RoleEditorForm.vue +165 -0
  659. package/templates/current/examples/src/views/system/role/components/RoleUserSelectForm.vue +129 -0
  660. package/templates/current/examples/src/views/system/role/composables/useRoleManagement.ts +422 -0
  661. package/templates/current/examples/src/views/system/role/composables/useRoleUserManagement.ts +233 -0
  662. package/templates/current/examples/src/views/system/role/pages/index.vue +110 -0
  663. package/templates/current/examples/src/views/system/role/services/roleAccess.ts +162 -0
  664. package/templates/current/examples/src/views/system/user/auth-roles/pages/index.vue +209 -0
  665. package/templates/current/examples/src/views/system/user/components/UserDetailsForm.vue +108 -0
  666. package/templates/current/examples/src/views/system/user/components/UserEditorForm.vue +207 -0
  667. package/templates/current/examples/src/views/system/user/components/UserImportDialog.vue +80 -0
  668. package/templates/current/examples/src/views/system/user/components/UserResetPasswordForm.vue +56 -0
  669. package/templates/current/examples/src/views/system/user/composables/useUserManagement.ts +502 -0
  670. package/templates/current/examples/src/views/system/user/pages/index.vue +459 -0
  671. package/templates/current/examples/tests/e2e/admin-access-business.spec.ts +33 -0
  672. package/templates/current/examples/tests/e2e/admin-shell.spec.ts +50 -0
  673. package/templates/current/examples/tests/e2e/fixtures/adminMockBackend.ts +95 -0
  674. package/templates/current/examples/tests/e2e/fixtures/labelGeometry.ts +52 -0
  675. package/templates/current/examples/tests/e2e/mock-api-generation.spec.ts +27 -0
  676. package/templates/current/examples/tests/e2e/mock-business.spec.ts +555 -0
  677. package/templates/current/examples/tests/e2e/mock-menu-retry-form-label.spec.ts +100 -0
  678. package/templates/current/examples/tests/e2e/mock-shell.spec.ts +25 -0
  679. package/templates/current/examples/tests/e2e/mock-tree-selection-layout.spec.ts +113 -0
  680. package/templates/current/examples/tests/unit/api/api-codegen.spec.ts +893 -0
  681. package/templates/current/examples/tests/unit/api/client.spec.ts +145 -0
  682. package/templates/current/examples/tests/unit/api/generated-http-client.spec.ts +290 -0
  683. package/templates/current/{clean/src → examples/tests/unit}/api/http-adapter.spec.ts +3 -3
  684. package/templates/current/examples/tests/unit/api/system-apis.spec.ts +118 -0
  685. package/templates/current/examples/tests/unit/app/createAdminUi.spec.ts +79 -0
  686. package/templates/current/examples/{src → tests/unit}/app/errorMessage.spec.ts +1 -1
  687. package/templates/current/examples/tests/unit/app/iconCatalog.spec.ts +12 -0
  688. package/templates/current/examples/tests/unit/app/menu.spec.ts +215 -0
  689. package/templates/current/{clean/src → examples/tests/unit}/app/origenUiLocale.spec.ts +1 -1
  690. package/templates/current/{clean/src → examples/tests/unit}/app/permission.spec.ts +4 -5
  691. package/templates/current/examples/tests/unit/app/runtimeConfig.spec.ts +36 -0
  692. package/templates/current/{clean/src/features → examples/tests/unit/app}/security/devtoolsProtection.spec.ts +17 -7
  693. package/templates/current/{clean/src/features/shell → examples/tests/unit}/composables/useRouteProgress.spec.ts +1 -1
  694. package/templates/current/{clean/src/features/shell/components → examples/tests/unit/layouts}/AdminWatermark.spec.ts +5 -7
  695. package/templates/current/{clean/src → examples/tests/unit}/layouts/topBarMenuSearch.spec.ts +25 -8
  696. package/templates/current/examples/{src → tests/unit}/locales/messages.spec.ts +43 -17
  697. package/templates/current/examples/tests/unit/router/dynamicMenuRefresh.spec.ts +151 -0
  698. package/templates/current/examples/tests/unit/router/dynamicRoutes.spec.ts +374 -0
  699. package/templates/current/examples/tests/unit/router/paths.spec.ts +103 -0
  700. package/templates/current/examples/{src → tests/unit}/router/queryEncryption.spec.ts +49 -12
  701. package/templates/current/{clean/src → examples/tests/unit}/router/routeQuery.spec.ts +8 -1
  702. package/templates/current/examples/{src → tests/unit}/router/runtimeErrorRecovery.spec.ts +11 -6
  703. package/templates/current/{clean/src → examples/tests/unit}/router/useRouteQueryDefaults.spec.ts +46 -12
  704. package/templates/current/examples/tests/unit/scripts/mock-api.spec.ts +440 -0
  705. package/templates/current/examples/{scripts → tests/unit/scripts}/vite-build-policy.spec.ts +35 -6
  706. package/templates/current/examples/{src/features/auth → tests/unit}/store/auth.spec.ts +68 -15
  707. package/templates/current/examples/tests/unit/store/dictionaries.spec.ts +106 -0
  708. package/templates/current/{clean/src → examples/tests/unit}/templates/templates.spec.ts +60 -16
  709. package/templates/current/examples/{src/utils/__tests__ → tests/unit/utils}/color-mix.spec.ts +1 -1
  710. package/templates/current/examples/tests/unit/utils/retryableDialog.spec.ts +61 -0
  711. package/templates/current/examples/{scripts/clean-overlay/src/features/errors/pages → tests/unit/views/errors}/error-pages.spec.ts +12 -9
  712. package/templates/current/examples/tests/unit/views/feature-composables.spec.ts +233 -0
  713. package/templates/current/examples/tests/unit/views/system/access/admin-repository.spec.ts +353 -0
  714. package/templates/current/examples/tests/unit/views/system/access/rbac.spec.ts +329 -0
  715. package/templates/current/examples/tests/unit/views/system/dept/departments.spec.ts +104 -0
  716. package/templates/current/examples/tests/unit/views/system/dict/dictionaries.spec.ts +234 -0
  717. package/templates/current/examples/tests/unit/views/system/menu/menuDraft.spec.ts +77 -0
  718. package/templates/current/examples/tests/unit/views/system/menu/useMenuManagement.spec.ts +339 -0
  719. package/templates/current/examples/tests/unit/views/system/user/searchControl.spec.ts +128 -0
  720. package/templates/current/examples/tsconfig.json +4 -19
  721. package/templates/current/examples/vite.build-policy.ts +97 -22
  722. package/templates/current/examples/vite.config.ts +50 -7
  723. package/templates/current/clean/.codebuddy/AGENTS.md +0 -18
  724. package/templates/current/clean/.codex/skills/build-admin-feature/SKILL.md +0 -14
  725. package/templates/current/clean/.codex/skills/build-admin-feature/references/component-selection.md +0 -25
  726. package/templates/current/clean/.codex/skills/use-og-table/SKILL.md +0 -16
  727. package/templates/current/clean/.cursor/AGENTS.md +0 -18
  728. package/templates/current/clean/.env.production.example +0 -31
  729. package/templates/current/clean/.qoder/AGENTS.md +0 -15
  730. package/templates/current/clean/e2e/admin-shell.spec.ts +0 -156
  731. package/templates/current/clean/e2e/demo-shell.spec.ts +0 -372
  732. package/templates/current/clean/playwright.demo.config.ts +0 -25
  733. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/NotFound.vue +0 -31
  734. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/ServerError.vue +0 -31
  735. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/error-pages.spec.ts +0 -41
  736. package/templates/current/clean/scripts/clean-overlay/src/main.ts +0 -100
  737. package/templates/current/clean/scripts/clean-overlay/src/router/componentCache.ts +0 -12
  738. package/templates/current/clean/scripts/clean-overlay/src/router/componentRegistry.ts +0 -14
  739. package/templates/current/clean/scripts/clean-overlay/src/router/dynamicRoutes.spec.ts +0 -77
  740. package/templates/current/clean/scripts/clean-overlay/src/router/paths.ts +0 -21
  741. package/templates/current/clean/scripts/clean-overlay/src/router/staticRoutes.ts +0 -63
  742. package/templates/current/clean/scripts/demo-api.ts +0 -873
  743. package/templates/current/clean/src/api/client.spec.ts +0 -66
  744. package/templates/current/clean/src/api/client.ts +0 -152
  745. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/345/206/205/345/256/271/346/226/207/347/253/240.ts +0 -144
  746. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/345/256/241/350/256/241.ts +0 -50
  747. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/346/226/207/344/273/266/344/270/212/344/274/240.ts +0 -63
  748. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/347/224/250/346/210/267.ts +0 -169
  749. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/217/234/345/215/225.ts +0 -180
  750. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/247/222/350/211/262.ts +0 -167
  751. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/256/242/345/215/225/350/215/211/347/250/277.ts +0 -168
  752. package/templates/current/clean/src/api/generated//350/256/244/350/257/201.ts +0 -95
  753. package/templates/current/clean/src/api/http-adapter.ts +0 -83
  754. package/templates/current/clean/src/app/createAdminUi.spec.ts +0 -166
  755. package/templates/current/clean/src/app/createAdminUi.ts +0 -63
  756. package/templates/current/clean/src/app/embedded-token.spec.ts +0 -40
  757. package/templates/current/clean/src/app/embedded.spec.ts +0 -135
  758. package/templates/current/clean/src/app/embedded.ts +0 -255
  759. package/templates/current/clean/src/app/errorMessage.ts +0 -53
  760. package/templates/current/clean/src/app/menu-host.spec.ts +0 -77
  761. package/templates/current/clean/src/app/menu.spec.ts +0 -320
  762. package/templates/current/clean/src/app/menu.ts +0 -308
  763. package/templates/current/clean/src/app/menuTypes.ts +0 -18
  764. package/templates/current/clean/src/app/origenUiLocale.ts +0 -10
  765. package/templates/current/clean/src/app/permission.ts +0 -9
  766. package/templates/current/clean/src/demo-api.spec.ts +0 -478
  767. package/templates/current/clean/src/features/errors/pages/error-pages.spec.ts +0 -41
  768. package/templates/current/clean/src/features/system/access/api/admin-repository.spec.ts +0 -14
  769. package/templates/current/clean/src/features/system/access/api/admin-repository.ts +0 -298
  770. package/templates/current/clean/src/features/system/access/api/rbac.spec.ts +0 -72
  771. package/templates/current/clean/src/features/system/access/api/rbac.ts +0 -292
  772. package/templates/current/clean/src/features/system/access/composables/useAuthorizationPolling.spec.ts +0 -134
  773. package/templates/current/clean/src/features/system/access/composables/useAuthorizationPolling.ts +0 -96
  774. package/templates/current/clean/src/features/workspace/pages/Profile.vue +0 -185
  775. package/templates/current/clean/src/router/componentCache.ts +0 -12
  776. package/templates/current/clean/src/router/componentRegistry.ts +0 -14
  777. package/templates/current/clean/src/router/dynamicMenuRefresh.spec.ts +0 -101
  778. package/templates/current/clean/src/router/dynamicRoutes.spec.ts +0 -77
  779. package/templates/current/clean/src/router/dynamicRoutes.ts +0 -177
  780. package/templates/current/clean/src/router/guards.ts +0 -5
  781. package/templates/current/clean/src/router/paths.spec.ts +0 -50
  782. package/templates/current/clean/src/router/paths.ts +0 -21
  783. package/templates/current/clean/src/router/routeQuery.ts +0 -6
  784. package/templates/current/clean/src/router/staticRoutes.ts +0 -63
  785. package/templates/current/clean/src/router/useRouteQueryDefaults.types.ts +0 -20
  786. package/templates/current/examples/.codebuddy/AGENTS.md +0 -18
  787. package/templates/current/examples/.codex/skills/build-admin-feature/SKILL.md +0 -14
  788. package/templates/current/examples/.codex/skills/build-admin-feature/references/component-selection.md +0 -25
  789. package/templates/current/examples/.codex/skills/use-og-table/SKILL.md +0 -16
  790. package/templates/current/examples/.cursor/AGENTS.md +0 -18
  791. package/templates/current/examples/.env.production.example +0 -31
  792. package/templates/current/examples/.qoder/AGENTS.md +0 -15
  793. package/templates/current/examples/e2e/admin-shell.spec.ts +0 -156
  794. package/templates/current/examples/e2e/demo-shell.spec.ts +0 -372
  795. package/templates/current/examples/playwright.demo.config.ts +0 -25
  796. package/templates/current/examples/scripts/clean-overlay/src/features/errors/pages/Forbidden.vue +0 -31
  797. package/templates/current/examples/scripts/clean-overlay/src/main.ts +0 -100
  798. package/templates/current/examples/scripts/clean-overlay/src/router/componentCache.ts +0 -12
  799. package/templates/current/examples/scripts/clean-overlay/src/router/componentRegistry.ts +0 -14
  800. package/templates/current/examples/scripts/clean-overlay/src/router/dynamicRoutes.spec.ts +0 -77
  801. package/templates/current/examples/scripts/clean-overlay/src/router/paths.ts +0 -21
  802. package/templates/current/examples/scripts/clean-overlay/src/router/staticRoutes.ts +0 -63
  803. package/templates/current/examples/scripts/demo-api.ts +0 -873
  804. package/templates/current/examples/src/api/client.spec.ts +0 -66
  805. package/templates/current/examples/src/api/client.ts +0 -152
  806. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/345/206/205/345/256/271/346/226/207/347/253/240.ts +0 -144
  807. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/345/256/241/350/256/241.ts +0 -50
  808. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/346/226/207/344/273/266/344/270/212/344/274/240.ts +0 -63
  809. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/347/224/250/346/210/267.ts +0 -169
  810. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/217/234/345/215/225.ts +0 -180
  811. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/247/222/350/211/262.ts +0 -167
  812. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/256/242/345/215/225/350/215/211/347/250/277.ts +0 -168
  813. package/templates/current/examples/src/api/generated//350/256/244/350/257/201.ts +0 -95
  814. package/templates/current/examples/src/api/http-adapter.ts +0 -83
  815. package/templates/current/examples/src/app/createAdminUi.spec.ts +0 -166
  816. package/templates/current/examples/src/app/createAdminUi.ts +0 -63
  817. package/templates/current/examples/src/app/embedded-token.spec.ts +0 -40
  818. package/templates/current/examples/src/app/embedded.spec.ts +0 -135
  819. package/templates/current/examples/src/app/embedded.ts +0 -255
  820. package/templates/current/examples/src/app/errorMessage.ts +0 -53
  821. package/templates/current/examples/src/app/menu-host.spec.ts +0 -77
  822. package/templates/current/examples/src/app/menu.spec.ts +0 -320
  823. package/templates/current/examples/src/app/menu.ts +0 -308
  824. package/templates/current/examples/src/app/menuTypes.ts +0 -18
  825. package/templates/current/examples/src/app/origenUiLocale.ts +0 -10
  826. package/templates/current/examples/src/app/permission.ts +0 -9
  827. package/templates/current/examples/src/demo-api.spec.ts +0 -478
  828. package/templates/current/examples/src/features/errors/pages/Forbidden.vue +0 -31
  829. package/templates/current/examples/src/features/errors/pages/NotFound.vue +0 -31
  830. package/templates/current/examples/src/features/errors/pages/ServerError.vue +0 -31
  831. package/templates/current/examples/src/features/feature-composables.spec.ts +0 -245
  832. package/templates/current/examples/src/features/system/access/api/admin-repository.spec.ts +0 -14
  833. package/templates/current/examples/src/features/system/access/api/admin-repository.ts +0 -298
  834. package/templates/current/examples/src/features/system/access/api/rbac.spec.ts +0 -72
  835. package/templates/current/examples/src/features/system/access/api/rbac.ts +0 -292
  836. package/templates/current/examples/src/features/system/access/composables/useAuthorizationPolling.spec.ts +0 -134
  837. package/templates/current/examples/src/features/system/access/composables/useAuthorizationPolling.ts +0 -96
  838. package/templates/current/examples/src/features/system/audit/composables/useAuditManagement.ts +0 -122
  839. package/templates/current/examples/src/features/system/audit/pages/AuditList.vue +0 -20
  840. package/templates/current/examples/src/features/system/menus/components/MenuEditorForm.vue +0 -279
  841. package/templates/current/examples/src/features/system/menus/composables/useMenuManagement.ts +0 -435
  842. package/templates/current/examples/src/features/system/menus/menuDraft.spec.ts +0 -204
  843. package/templates/current/examples/src/features/system/menus/menuDraft.ts +0 -116
  844. package/templates/current/examples/src/features/system/menus/menuTreePrecheck.spec.ts +0 -268
  845. package/templates/current/examples/src/features/system/menus/menuTreePrecheck.ts +0 -317
  846. package/templates/current/examples/src/features/system/menus/pages/MenuList.vue +0 -51
  847. package/templates/current/examples/src/features/system/roles/components/RoleEditorForm.vue +0 -116
  848. package/templates/current/examples/src/features/system/roles/composables/useRoleManagement.ts +0 -194
  849. package/templates/current/examples/src/features/system/roles/pages/RoleList.vue +0 -47
  850. package/templates/current/examples/src/features/system/users/components/UserEditorForm.vue +0 -104
  851. package/templates/current/examples/src/features/system/users/composables/useUserManagement.ts +0 -228
  852. package/templates/current/examples/src/features/system/users/pages/UserList.vue +0 -51
  853. package/templates/current/examples/src/features/workspace/pages/Dashboard.spec.ts +0 -41
  854. package/templates/current/examples/src/features/workspace/pages/Dashboard.vue +0 -325
  855. package/templates/current/examples/src/features/workspace/pages/Profile.vue +0 -185
  856. package/templates/current/examples/src/router/componentCache.ts +0 -18
  857. package/templates/current/examples/src/router/componentRegistry.ts +0 -66
  858. package/templates/current/examples/src/router/dynamicMenuRefresh.spec.ts +0 -101
  859. package/templates/current/examples/src/router/dynamicRoutes.spec.ts +0 -144
  860. package/templates/current/examples/src/router/dynamicRoutes.ts +0 -177
  861. package/templates/current/examples/src/router/guards.ts +0 -5
  862. package/templates/current/examples/src/router/paths.spec.ts +0 -50
  863. package/templates/current/examples/src/router/paths.ts +0 -21
  864. package/templates/current/examples/src/router/routeQuery.ts +0 -6
  865. package/templates/current/examples/src/router/staticRoutes.ts +0 -63
  866. package/templates/current/examples/src/router/useRouteQueryDefaults.types.ts +0 -20
  867. /package/templates/current/clean/{.codex → .agents}/skills/style-og-origen-ui/SKILL.md +0 -0
  868. /package/templates/current/clean/{.codex → .agents}/skills/style-og-origen-ui/agents/openai.yaml +0 -0
  869. /package/templates/current/clean/{.codex → .agents}/skills/use-og-dialog/SKILL.md +0 -0
  870. /package/templates/current/clean/{.codex → .agents}/skills/use-og-dialog/agents/openai.yaml +0 -0
  871. /package/templates/current/clean/{.codex → .agents}/skills/use-og-editor/SKILL.md +0 -0
  872. /package/templates/current/clean/{.codex → .agents}/skills/use-og-http/SKILL.md +0 -0
  873. /package/templates/current/clean/{.codex → .agents}/skills/use-og-http/agents/openai.yaml +0 -0
  874. /package/templates/current/clean/{.codex → .agents}/skills/use-og-router-tabs/SKILL.md +0 -0
  875. /package/templates/current/{examples/.codex → clean/.claude}/skills/style-og-origen-ui/SKILL.md +0 -0
  876. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-dialog/SKILL.md +0 -0
  877. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-editor/SKILL.md +0 -0
  878. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-http/SKILL.md +0 -0
  879. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-router-tabs/SKILL.md +0 -0
  880. /package/templates/current/clean/src/{features/security/components → components}/DevtoolsProtectionOverlay.vue +0 -0
  881. /package/templates/current/clean/src/{features/shell/composables → composables}/useRouteProgress.ts +0 -0
  882. /package/templates/current/clean/src/{features/workspace → views/fallback}/pages/Empty.vue +0 -0
  883. /package/templates/current/examples/{.codex → .agents}/skills/style-og-origen-ui/agents/openai.yaml +0 -0
  884. /package/templates/current/examples/{.codex → .agents}/skills/use-og-dialog/agents/openai.yaml +0 -0
  885. /package/templates/current/examples/{.codex → .agents}/skills/use-og-http/agents/openai.yaml +0 -0
  886. /package/templates/current/examples/src/{features/security/components → components}/DevtoolsProtectionOverlay.vue +0 -0
  887. /package/templates/current/examples/src/{features/shell/composables → composables}/useRouteProgress.ts +0 -0
  888. /package/templates/current/examples/src/{features/workspace → views/fallback}/pages/Empty.vue +0 -0
@@ -0,0 +1,405 @@
1
+ ---
2
+ title: OgDialog
3
+ description: 同时支持组件式与命令式动态内容的通用弹窗。
4
+ ---
5
+
6
+ # OgDialog
7
+
8
+ 在 767px 及以下的屏幕上,通过 Teleport 渲染的弹窗与抽屉表面使用相对容器的全屏尺寸(`width: 100%` 且 `max-width: 100%`),因此浏览器滚动条宽度不会造成水平溢出。
9
+
10
+ 同时支持组件式插槽与命令式动态内容的通用弹窗。确认流程可以等待异步任务、调用表单协议,并通过关闭守卫保护未完成的编辑。
11
+
12
+ `modal` 与 `lockScroll` 省略时沿用 Element Plus 的默认值(均为 `true`);显式传入 `false` 可分别关闭遮罩或页面滚动锁定。组件式 Dialog、Drawer 以及命令式 Host 使用相同的透传规则。
13
+
14
+ ## 何时使用
15
+
16
+ - 用户需要在当前上下文完成确认、编辑或详情查看。
17
+ - 弹窗内容是已有 Vue 组件或 OgForm,且确认后需要统一校验与提交。
18
+ - 业务服务需要在已安装 `createOgDialog()` 的应用内通过 `useDialog().open()` 打开多个独立弹窗。
19
+
20
+ ## 基础用法
21
+
22
+ 组件式 API 使用 `v-model` 控制可见性。确认回调返回 `true` 才关闭,返回 `false` 或抛出异常则保持打开状态。
23
+
24
+ ```vue
25
+ <script setup lang="ts">
26
+ import { shallowRef } from 'vue'
27
+ import { OgDialog } from 'origen-ui'
28
+
29
+ const visible = shallowRef(false)
30
+
31
+ async function submit(): Promise<boolean> {
32
+ await save()
33
+ return true
34
+ }
35
+ </script>
36
+
37
+ <template>
38
+ <OgDialog v-model="visible" title="编辑" :og-confirm-handler="submit">
39
+ <p>弹窗内容</p>
40
+ </OgDialog>
41
+ </template>
42
+ ```
43
+
44
+ ## 与 OgForm 集成
45
+
46
+ 当内容组件实现 `validate()` 与 `getSubmitModel()` 时,OgDialog 会在确认前自动校验并读取提交模型。`ogCloseGuard` 可以拦截遮罩、Escape、父级隐藏、编程关闭以及确认/完成流程;用户明确点击默认取消按钮、右上角关闭图标、header 插槽的 `close()`、footer 插槽的 `cancel()` 或调用 `requestClose('cancelled')` 时会绕过该守卫,但仍受 `ogCancelable` 和未保存内容保护控制。右上角图标与 header `close()` 和显式取消按钮保持同一语义。
47
+
48
+ ### 泛型 SFC
49
+
50
+ `OgDialog` 使用 Vue 3.5 泛型 SFC。通过 `@vue-generic` 指定 payload 和动态内容组件
51
+ props 后,`ogConfirmHandler`、`ogCloseGuard`、`ogFooter` 及 `complete()` 会共享这两个类型参数:
52
+
53
+ ```vue
54
+ <script setup lang="ts">
55
+ import type { DialogAction } from '@origen-ui/dialog'
56
+ import { shallowRef } from 'vue'
57
+
58
+ interface EditorPayload {
59
+ saved: boolean
60
+ }
61
+
62
+ interface EditorProps extends Record<string, unknown> {
63
+ recordId: string
64
+ }
65
+
66
+ const visible = shallowRef(true)
67
+ const editorProps: EditorProps = { recordId: '42' }
68
+ const footer: DialogAction<EditorPayload>[] = [
69
+ {
70
+ text: '保存草稿',
71
+ onClick: async ({ complete, getPayload }) => {
72
+ await complete('save-draft', getPayload())
73
+ },
74
+ },
75
+ ]
76
+ </script>
77
+
78
+ <template>
79
+ <!-- @vue-generic {EditorPayload, EditorProps} -->
80
+ <OgDialog v-model="visible" :og-component-props="editorProps" :og-footer="footer" />
81
+ </template>
82
+ ```
83
+
84
+ ## 典型用法
85
+
86
+ <div id="dialog-form-guard"></div>
87
+ ### 表单 payload 与关闭守卫
88
+
89
+ OgDialog 调用真实 OgForm 的校验与提交模型;取消按钮始终可用,未开启许可时遮罩和 Escape 关闭会被阻止。
90
+
91
+ ## 高级能力
92
+
93
+ <div id="dialog-confirm-feedback"></div>
94
+ <div id="dialog-async-confirm"></div>
95
+ <div id="dialog-presentation"></div>
96
+ <div id="dialog-feedback"></div>
97
+ ### 展示配置、确认加载与失败反馈
98
+
99
+ 合并 Dialog/Drawer 展示配置、异步确认和失败反馈,覆盖关闭与加载状态。
100
+
101
+ ## API
102
+
103
+ ## 命令式弹窗
104
+
105
+ 应用通过 `app.use(createOgDialog())` 安装 manager,并在根部放置一个 `<OgDialogHost />` 后,可通过 `useDialog().open()` 在当前应用上下文中挂载内容组件。每次调用返回独立的 `{ close, update, result }` 句柄,支持多个弹窗同时存在。`result` 是可等待的 `Promise<DialogOutcome>`;确认或 action 抛错时弹窗保持打开,并通过 `confirmError` / `actionError` 回调报告异常,不会伪造一个错误 outcome。
106
+
107
+ 需要显式管理多个应用上下文时,可从根入口或 runtime 入口创建 manager,并传给 Host:
108
+
109
+ ```ts
110
+ import { createDialogManager } from '@origen-ui/dialog'
111
+
112
+ const manager = createDialogManager({
113
+ defaults: { protectUnsaved: true },
114
+ feedback: {},
115
+ locale: { cancelText: '取消', confirmText: '保存' },
116
+ })
117
+ ```
118
+
119
+ ```vue
120
+ <OgDialogHost :manager="manager" />
121
+ ```
122
+
123
+ 显式 manager 与 `useDialog()` 使用同一套 `DialogService` 契约;Host 仍必须挂在目标
124
+ Vue 应用树中,才能保留动态内容的依赖注入上下文。Host 会在内部解析与该 manager 关联的
125
+ 运行时配置,并将 locale、feedback 和 defaults 提供给所有子 `OgDialog`,因此显式 manager
126
+ 与插件安装路径保持一致;动态内容中的 `useDialog()` 也使用该显式 manager,单次 dialog
127
+ props 仍拥有更高优先级。`actionSignal`、`closeRequest`、`scopeId` 和 `sessionId` 是 Host
128
+ 通过内部 session context 传递的字段,不属于公开 `OgDialog` props。
129
+
130
+ ### OgDialogHost Props
131
+
132
+ | 属性 | 类型 | 默认值 | 说明 |
133
+ | --------- | --------------- | -------------- | --------------------------------------------------------------------------- |
134
+ | `manager` | `DialogManager` | 注入的 manager | 可选地显式指定命令式弹窗管理器;未传入时要求应用已安装 `createOgDialog()`。 |
135
+
136
+ 同一 manager 的第一个已挂载 Host 是活动 Host,后续 Host 待命且不重复渲染会话。活动 Host
137
+ 卸载时最早注册的待命 Host 接管;最后一个 Host 卸载会以 `host-disposed` 结束尚未完成的句柄。
138
+ `DialogHandle.close()` 是幂等的关闭请求:同一会话的并发重复调用不会产生额外 outcome,调用方应
139
+ 读取每次返回的 `boolean`,而不是假定第二次关闭成功。
140
+
141
+ ```vue
142
+ <script setup lang="ts">
143
+ import { OgForm, useDialog } from 'origen-ui'
144
+
145
+ function handleOpen(): void {
146
+ const dialog = useDialog().open({
147
+ title: '编辑',
148
+ component: OgForm,
149
+ props: { fields: [] },
150
+ onConfirm: async (model) => {
151
+ await save(model)
152
+ return true
153
+ },
154
+ })
155
+
156
+ dialog.update({ presentation: { type: 'dialog', width: 720 } })
157
+ }
158
+ </script>
159
+ ```
160
+
161
+ ### 命令式补充
162
+
163
+ - `dialogKey`、`scopeId` 与 `duplicatePolicy` 属于会话身份,只能在 `open()` 时指定;`DialogHandle.update()` 的类型不接受这些字段,运行时也不会迁移身份。空字符串是合法的 key 或 scope 值。
164
+ - manager 会复制 `ogFooter` 数组及其 action 对象,并复制 `ogMetadata`、`ogPresentation` 配置对象。修改传入对象不会直接改变现有会话;请用 `handle.update()` 更新投影。动态内容 `props` 保留原引用,因此调用方传入的 reactive props 仍保持响应性。
165
+
166
+ - `dialogKey`:相同 key 重复打开时默认保留已有会话,新句柄以 `{ status: 'cancelled', reason: 'duplicate' }` 结束。传入 `duplicatePolicy: 'replace'` 可中止并替换旧会话。
167
+ - 自定义 action 的 `onClick` 收到 `{ signal, close, confirm, complete, getPayload }`。调用 `complete('save-draft')` 会以 `{ status: 'completed', action: 'save-draft', payload }` 完成;`complete('save-draft', payload, { validate: true })` 可在完成前强制校验。
168
+ - `complete` 既可用于 Expose 实例方法,也可在命令式 action 上下文中调用。
169
+ - `complete` 的 action 不能为空。空 action 会以 `A completed close requires an action name.` reject,不会触发 `confirmError` 或关闭请求;若它发生在 footer action 内,则由外层流程报告 `actionError` 并保持弹窗打开。
170
+
171
+ ## 常用操作导航
172
+
173
+ 本节只帮助按场景定位能力,不重复定义参数、默认值和结果结构;根入口符号、命令式结果与组件事件以[完整公开导出](#完整公开导出)、[事件表](#事件表)和[Expose API](#expose-api)为准。
174
+
175
+ | 类别 | 可用能力 |
176
+ | ---------- | ----------------------------------------------------------------------------- |
177
+ | 受控显示 | `v-model`、`title`、`ogPresentation`、`ogShowFooter`、`destroyOnClose` |
178
+ | 确认与关闭 | `ogConfirmHandler`、`ogCloseGuard`、`confirm`、`close` |
179
+ | 内容协议 | `contentApi` 或实现 `validate` / `getSubmitModel` 的内容组件 |
180
+ | 命令式 | `createOgDialog`、`useDialog().open`、`OgDialogHost`、句柄 `update`、`result` |
181
+
182
+ ## 完整公开导出
183
+
184
+ ### 官方表面事件类型:`OgDialogElementEvents`、`OgDrawerElementEvents`
185
+
186
+ `OgDialogComponentPresentation` 用于区分 OgDialog 与 OgDrawer 的封装层展示选项。
187
+
188
+ `ogDialogEvents` 与 `ogDrawerEvents` 是官方 Dialog/Drawer 生命周期回调入口。Element Plus 普通属性直接放在组件顶层,按 `ogPresentation.type` 选择的 Dialog 或 Drawer 表面定型;`modelValue` 与 `beforeClose` 由 OgDialog 工作流接管。官方属性和事件详情参考 Element Plus 官方文档。
189
+
190
+ 以下清单对应 `@origen-ui/dialog` 的根入口 `src/index.ts`。类型导出不会自动生成运行时对象,但它们是组件配置、事件载荷和命令句柄的公共契约。
191
+
192
+ | 分类 | 导出 |
193
+ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
194
+ | 工厂与注入 | `createOgDialog`、`createDialogManager`、`useDialog`、`useOgDialogRuntimeConfig` |
195
+ | 组件 | `OgDialog`、`OgDialogHost` |
196
+ | locale 常量 | `OG_DIALOG_LOCALE_EN_US`、`OG_DIALOG_LOCALE_ZH_CN`、`OG_DIALOG_LOCALE_ZH_TW` |
197
+ | 服务与模型 | `DialogManager`、`DialogService`、`DialogScope`、`DialogModel`、`DialogHandle`、`DialogOutcome`、`OpenDialogOptions`、`DialogUpdateOptions`、`CreateOgDialogOptions`、`OgDialogPlugin` |
198
+ | 生命周期与动作 | `DialogAction`、`DialogActionContext`、`DialogCancelContext`、`DialogCloseContext`、`DialogCloseGuard`、`DialogCloseReason`、`DialogRequestCloseReason`、`DialogTerminalCloseReason`、`DialogCompleteOptions`、`DialogConfirmHandler`、`DialogDiscardContext`、`DialogErrorContext`、`DialogErrorPhase`、`DialogLifecycleEvent`、`DialogLifecycleEventType` |
199
+ | 配置与展示 | `OgDialogProps`、`OgDialogExpose`、`OgDialogDefaults`、`OgDialogFeedback`、`OgDialogLocale`、`OgDialogPresentation`、`OgDialogComponentPresentation`、`OgDialogRuntimeConfig`、`DialogPresentationOptions`、`DrawerPresentationOptions`、`DrawerDirection` |
200
+ | 内容与范围 | `DialogContentRef`、`DialogMetadata`、`DialogCloseAllOptions`、`DialogCloseAllResult` |
201
+
202
+ `useOgDialogRuntimeConfig()` 返回应用级解析配置;实例 Props 的显式值优先于运行时默认值。`DialogService` 仅在安装 `createOgDialog()` 后可用,不能通过隐式全局单例取得。
203
+
204
+ ### 打开、更新与结果
205
+
206
+ `DialogService.open(options)` 要求传入动态 `component`,可选 `props`、`dialogKey`、`duplicatePolicy`、`scopeId`、`onConfirm`、`onCancel`、`onClosed` 和错误回调。返回的 `DialogHandle` 同时是 `PromiseLike<DialogOutcome>`,并提供 `close()`、`update(options)` 与 `result`:
207
+
208
+ ```ts
209
+ const handle = dialog.open({
210
+ component: EditorForm,
211
+ dialogKey: 'editor',
212
+ duplicatePolicy: 'preserve',
213
+ props: { modelValue: draft },
214
+ onClosed: (outcome) => console.log(outcome),
215
+ })
216
+
217
+ handle.update({ title: '编辑草稿', presentation: { type: 'dialog', width: 720 } })
218
+ const outcome = await handle.result
219
+ ```
220
+
221
+ `DialogOutcome` 只有三种形态:`{ status: 'confirmed', payload }` 表示确认完成,`{ status: 'completed', action, payload }` 表示自定义 action 完成,`{ status: 'cancelled', reason }` 表示用户请求或会话终止。`reason` 可以是 `cancelled`、`dismissed`、`programmatic`、`duplicate`、`replaced` 或 `host-disposed`;重复 key 默认产生 `duplicate`,`duplicatePolicy: 'replace'` 会让旧句柄收到 `replaced`。
222
+
223
+ `confirmHandler`、内容校验、关闭守卫或自定义 action 抛出的异常不会解析为 `DialogOutcome`,而是触发对应的 `confirmError`、`closeError` 或 `actionError` 回调并保持会话可恢复。非法 `complete` action 属于调用契约错误,会直接 reject,不归类为 `confirmError`。`onConfirmError`、`onCloseError` 和 `onActionError` 是命令式打开选项中的错误回调;需要展示通用错误提示时启用 `errorFeedback`。
224
+
225
+ ::: tip 设计原则
226
+
227
+ 业务状态与保存逻辑留在调用方;弹窗只负责打开、校验、确认与关闭生命周期。这样同一个内容组件既能嵌入页面,也能被命令式弹窗复用。
228
+
229
+ :::
230
+
231
+ manager 遇到动态内容 setup/render 或 footer action `show()` 的致命生命周期异常时,会触发一次 lifecycle `error`,中止并移除该会话,并以 `{ status: 'cancelled', reason: 'dismissed' }` 结算结果;动态渲染异常也会继续传递到 Vue 应用的 `errorHandler`。runtime `onError` 回调收到 `phase: 'lifecycle'` 和原始异常。`onOpened`、`onClosed` 等观察回调抛错也会报告 lifecycle `error`,但不会重复结算会话。confirm、action、closeGuard 等可恢复错误继续通过 `confirmError`、`actionError`、`closeError` 对应路径报告,不会改成致命终结。
232
+
233
+ ## 事件表
234
+
235
+ | 名称 | 类型 | 说明 |
236
+ | ------------------- | ---------------------------------------- | -------------------------------------------------------------------- |
237
+ | `update:modelValue` | `(value: boolean) => void` | `v-model` 绑定,弹窗可见性变化时触发 |
238
+ | `open` | `() => void` | 弹窗开始打开时触发 |
239
+ | `opened` | `() => void` | 弹窗打开动画结束后触发 |
240
+ | `closed` | `() => void` | 弹窗关闭动画结束后触发 |
241
+ | `confirm` | `(model: DialogModel) => void` | 确认操作成功时触发,携带当前 payload |
242
+ | `cancel` | `(context: DialogCancelContext) => void` | 用户取消或关闭弹窗时触发,携带取消原因与 payload |
243
+ | `close` | `(context: DialogCloseContext) => void` | 每次关闭请求被接受时触发,携带完整关闭上下文(含 reason 与 payload) |
244
+ | `actionError` | `(error: unknown) => void` | 自定义 action 的 `onClick` 抛出异常时触发 |
245
+ | `confirmError` | `(error: unknown) => void` | 确认流程(`confirmHandler` 或内容校验)抛出异常时触发 |
246
+ | `closeError` | `(error: unknown) => void` | 关闭守卫或脏检查流程抛出异常时触发 |
247
+
248
+ ## Expose API
249
+
250
+ 通过 `ref` 获取组件实例后,可调用以下方法:
251
+
252
+ | 名称 | 参数 | 返回值 | 说明 |
253
+ | -------------------- | -------------------------------------------------------------------------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------- |
254
+ | `open` | 无 | `void` | 手动打开弹窗 |
255
+ | `close` | 无 | `Promise<boolean>` | 以 `programmatic` 原因请求关闭,返回是否成功关闭 |
256
+ | `confirm` | 无 | `Promise<boolean>` | 手动触发确认流程(校验 + `confirmHandler`),返回是否成功 |
257
+ | `complete` | `(action: string, payload?: DialogModel, options?: DialogCompleteOptions)` | `Promise<boolean>` | 以指定 action 完成弹窗,可用于自定义动作(如 `save-draft`);`options.validate` 控制是否校验 |
258
+ | `getPayload` | 无 | `DialogModel \| undefined` | 获取当前内容组件的提交模型 |
259
+ | `registerContent` | `(content: FormActionExpose \| null)` | `void` | 手动注册内容组件的表单协议引用(通常由内部自动调用) |
260
+ | `requestClose` | `(reason: DialogRequestCloseReason)` | `Promise<boolean>` | 以指定原因(`cancelled` / `dismissed` / `programmatic`)请求关闭,返回是否成功 |
261
+ | `setLoading` | `(value: boolean)` | `void` | 手动设置弹窗 loading 状态 |
262
+ | `getSurfaceInstance` | 无 | `DialogInstance \| DrawerInstance \| undefined` | 获取当前实际挂载的 Element Plus Dialog 或 Drawer 实例。 |
263
+
264
+ ## Props 补充
265
+
266
+ ### `ogPresentation` 与官方表面属性
267
+
268
+ `ogPresentation.type` 是表面判别值。省略或设为 `'dialog'` 时使用居中弹窗;设为 `'drawer'` 时使用方向抽屉。Element Plus 官方属性直接放在 OgDialog 顶层:Dialog 使用 `width`、`top`、`fullscreen`、`draggable` 等;Drawer 使用 `size`、`direction`。两种形态共享表单校验、异步确认、未保存保护和关闭结果。
269
+
270
+ ```vue
271
+ <OgDialog
272
+ v-model="visible"
273
+ title="编辑用户"
274
+ :og-presentation="{ type: 'drawer' }"
275
+ direction="rtl"
276
+ size="480px"
277
+ >
278
+ <UserForm />
279
+ </OgDialog>
280
+ ```
281
+
282
+ | 形态 | 可用配置 | 默认值 |
283
+ | ------ | --------------------------------------------------------------------------------------------------- | ---------------------------------------- |
284
+ | Dialog | 顶层 `width`、`top`、`fullscreen`、`draggable`;`ogPresentation.resizable`、`minWidth`、`minHeight` | `width: '520px'`,缩放最小值 `320 × 180` |
285
+ | Drawer | 顶层 `size`、`direction` | `size: '520px'`,`direction: 'rtl'` |
286
+
287
+ 桌面端仅 Dialog 支持拖拽缩放;Dialog 与 Drawer 的宽度会自动限制在视口内,避免传入过大的 `width` 或 `size` 时产生水平溢出;小于 768px 时两者均占满视口。`DialogHandle.update()` 更新 `ogPresentation` 时必须传入完整对象,组件不会深合并旧配置。
288
+
289
+ 桌面端 Dialog 可通过 `ogPresentation.resizable` 启用键盘和指针缩放。最大宽度按视口宽度减去两侧间距计算,最大高度同时受视口高度、表面实际 `top` 和底部间距约束。若可用空间小于 `minWidth` 或 `minHeight`,会优先满足视口边界,实际尺寸允许低于配置的最小值;可用空间为零时尺寸为零。缩放从实际 surface 尺寸开始,`%`、`vw`、`rem`、`calc()` 等 CSS 宽度不会被直接当作像素解析。
290
+
291
+ ### 无障碍名称
292
+
293
+ 默认标题会作为 **Dialog 表面**的弹层名称。当前 Element Plus Drawer 会在 `role="dialog"` 节点上用非空 `title` 设置 `aria-label`;`title` 为空时会将 `aria-labelledby` 指向内部标题节点。需要覆盖非空标题对应的名称时,可以显式传入 `aria-label`。省略 Drawer 的 `title` 时,应提供指向有效名称元素的 `aria-labelledby`;它优先于 `aria-label`,因此不能让它继续指向空标题节点。
294
+
295
+ ### errorFeedback
296
+
297
+ | 属性名 | 类型 | 默认值 | 说明 |
298
+ | ----------------- | --------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
299
+ | `ogErrorFeedback` | `boolean` | `true` | 控制是否在 `actionError`、`confirmError`、`closeError` 事件触发时,额外通过 `ElMessage.error` 显示通用错误提示。关闭后仅保留事件通知,不弹出消息 |
300
+
301
+ ### protectUnsaved
302
+
303
+ | 属性名 | 类型 | 默认值 | 说明 |
304
+ | ------------------ | --------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
305
+ | `ogProtectUnsaved` | `boolean` | `true` | 在非确认类关闭(取消、遮罩点击等)时,若内容组件实现了 `isDirty()` 方法,会弹出二次确认对话框提示用户是否放弃未保存的修改。确认和完成动作不受此检查影响 |
306
+
307
+ ## 完整 Props 与插槽
308
+
309
+ | 属性 | 类型 | 默认值 | 说明 |
310
+ | ------------------------------------------ | ----------------------------------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
311
+ | `v-model` | `boolean` | - | 必填。控制可见性。 |
312
+ | `title` | `string` | `''` | 标题和默认无障碍名称。 |
313
+ | `ogPresentation` | `OgDialogComponentPresentation` | Dialog | 选择 Dialog/Drawer 表面,并配置 OgDialog 的可调整尺寸选项;官方尺寸属性直接放根层。 |
314
+ | `ogMetadata` | `Record<string, string \| number \| boolean \| null>` | - | 生命周期观测使用的安全标量上下文。 |
315
+ | `ogComponent` / `ogComponentProps` | `Component` / `Record<string, unknown>` | - | 动态内容组件及其 Props。命令式 `open()` 使用 `component` / `props` 选项。 |
316
+ | `ogContentApi` | `MaybeRefOrGetter<DialogContentRef>` | - | 注册插槽内容的表单式命令接口。 |
317
+ | `ogLocale` | `Partial<OgDialogLocale>` | 中文预设 | 覆盖操作和错误文案。 |
318
+ | `ogConfirmHandler` | `DialogConfirmHandler` | - | 确认回调;返回 `false` 时保持打开。 |
319
+ | `ogConfirmLoading` / `ogLoading` | `boolean` | `false` | 分别控制确认按钮和内容区域 loading。 |
320
+ | `ogProtectUnsaved` / `ogErrorFeedback` | `boolean` | 运行时默认值 | 启用未保存保护或通用错误反馈。 |
321
+ | `destroyOnClose` | `boolean` | 运行时默认值 | 关闭后销毁内容。 |
322
+ | `ogCancelable` | `boolean` | `true` | 统一的用户取消策略。`false` 时隐藏默认取消按钮和原生关闭图标,禁用遮罩与 Escape,并拒绝 `cancelled` / `dismissed` 关闭请求。 |
323
+ | `ogShowFooter` / `showClose` | `boolean` | 运行时默认值 | 显示默认底栏或关闭按钮;`ogCancelable=false` 时不能重新显示原生关闭按钮。 |
324
+ | `closeOnClickModal` / `closeOnPressEscape` | `boolean` | 运行时默认值 | 允许遮罩点击或 Escape 请求关闭;`cancelable=false` 时不能重新启用。 |
325
+ | `appendToBody` | `boolean` | 运行时默认值 | 将浮层挂载到 `body`。 |
326
+ | `class` | `string` | - | 透传到当前 Dialog 或 Drawer 表面的 CSS class。 |
327
+ | `ogFooter` | `DialogAction[]` | - | 默认底栏中的自定义操作。 |
328
+ | `ogCloseGuard` | `DialogCloseGuard` | - | 遮罩、Escape、父级隐藏、编程及确认/完成关闭请求的异步守卫;默认取消、右上角关闭图标、header `close()`、`cancel()` 和 `requestClose('cancelled')` 会绕过它。 |
329
+ | Element Plus props | 当前表面的 `DialogProps` 或 `DrawerProps` | 依 Element Plus | 官方普通属性直接放在根层;`modelValue`、`beforeClose` 由 OgDialog 工作流接管。 |
330
+ | `ogDialogEvents` | `OgDialogElementEvents` | - | `dialog` 表面的 Element Plus 生命周期与焦点事件回调;与 `ogPresentation.type: 'dialog'` 配合使用。 |
331
+ | `ogDrawerEvents` | `OgDrawerElementEvents` | - | `drawer` 表面的 Element Plus 生命周期、焦点及 resize 事件回调;与 `ogPresentation.type: 'drawer'` 配合使用。 |
332
+
333
+ `sessionId`、`scopeId`、`closeRequest` 与 `actionSignal` 是 DialogManager 桥接字段,业务组件不应直接传入。
334
+
335
+ `ogCancelable=false` 只管理 OgDialog 提供的默认取消入口。自定义 `header` 或 `footer` 中的按钮由调用方决定是否渲染;即使自定义按钮调用 `close` 或 `cancel`,请求也会返回 `false`,不会关闭弹窗。
336
+
337
+ | 插槽 | 作用域参数 | 说明 |
338
+ | --------- | ------------------------------------------- | --------------------------------------------------------- |
339
+ | `default` | `{ confirming, registerContent }` | 弹窗正文;表单式内容通过 `registerContent` 接入确认流程。 |
340
+ | `header` | `{ close, title, titleClass, titleId }` | 自定义标题区域。 |
341
+ | `footer` | `{ cancel, confirm, complete, confirming }` | 自定义底栏操作。 |
342
+
343
+ ## 批量关闭与作用域
344
+
345
+ `useDialog()` 返回的公共服务提供 `closeAll(options?)` 和 `createScope(id)`。`closeAll()` 会按正常关闭流程依次请求关闭,`mode: 'force'` 会直接结束匹配的会话;两者都会返回可等待的关闭结果。
346
+
347
+ ```ts
348
+ import { useDialog } from 'origen-ui'
349
+
350
+ const dialog = useDialog()
351
+
352
+ // 依次请求关闭所有弹窗,并等待结果
353
+ const result = await dialog.closeAll()
354
+
355
+ // 将路由或功能区的弹窗限制在独立作用域
356
+ const editorDialogs = dialog.createScope('route-editor')
357
+ editorDialogs.open({ component: EditorForm })
358
+
359
+ // 强制结束该作用域内的全部弹窗
360
+ await editorDialogs.closeAll({ mode: 'force' })
361
+ ```
362
+
363
+ 常规 `closeAll()` 被守卫阻止时会返回 `{ blocked: true, closed }`;强制模式返回 `{ blocked: false, closed }`。每个句柄的 `result` 和 `onClosed` 仍会收到对应的关闭结果。
364
+
365
+ ## 相关组合示例
366
+
367
+ 命令式 Host、替换和作用域销毁流程见[内容与弹窗场景](../../.agents/skills/admin-component-usage/references/component-directory.md);表单确认入口保留在本页典型用法中。
368
+
369
+ <!-- component-contract:start -->
370
+
371
+ ## 公共契约
372
+
373
+ > 由组件目录生成;每条记录对应可公开导入的组件及其消费者 API 摘要。
374
+
375
+ ### Imports
376
+
377
+ - `dialog`: `import { OgDialog } from '@origen-ui/dialog'`
378
+ - `dialog-host`: `import { OgDialogHost } from '@origen-ui/dialog'`
379
+
380
+ ### Props
381
+
382
+ - `dialog`: `modelValue`, `ogCloseGuard`, `ogPresentation`, `ogMetadata`, `ogComponent`, `ogComponentProps`, `ogContentApi`, `ogLocale`, `ogConfirmHandler`, `ogConfirmLoading`, `ogLoading`, `ogProtectUnsaved`, `ogCancelable`, `ogErrorFeedback`, `ogShowFooter`, `ogFooter`, `ogDialogEvents`, `ogDrawerEvents`
383
+ - `dialog-host`: `manager`
384
+
385
+ ### Events
386
+
387
+ - `dialog`: `update:modelValue`, `confirm`, `cancel`, `actionError`, `close`, `closeError`, `closeResult`, `closed`, `confirmError`, `open`, `opened`
388
+ - `dialog-host`: 无
389
+
390
+ ### Slots
391
+
392
+ - `dialog`: `default`, `header`, `footer`
393
+ - `dialog-host`: 无
394
+
395
+ ### Exposes
396
+
397
+ - `dialog`: `open`, `close`, `confirm`, `complete`, `getPayload`, `registerContent`, `requestClose`, `setLoading`, `getSurfaceInstance`
398
+ - `dialog-host`: 无
399
+
400
+ ### Types
401
+
402
+ - `dialog`:属性类型:`OgDialogProps`;公开方法类型:无
403
+ - `dialog-host`:属性类型:由公开 Vue 组件推断,未单独导出属性类型;公开方法类型:无
404
+
405
+ <!-- component-contract:end -->
@@ -0,0 +1,87 @@
1
+ ---
2
+ title: OgEditorViewer
3
+ description: 安全展示 OgEditor HTML 内容的只读组件。
4
+ ---
5
+
6
+ # OgEditorViewer
7
+
8
+ ## 基础用法
9
+
10
+ `OgEditorViewer` 用于展示 `OgEditor` 生成的 HTML。组件在挂载后清洗内容,只保留编辑器允许的标签、属性和安全 URL;服务端在入库与输出时仍应执行自己的 HTML 清洗策略。
11
+
12
+ <div id="viewer-security"></div>
13
+ ### 安全内容展示
14
+
15
+ 逐项对照输入 HTML 与内置清洗输出,核对判空结果与空态文案优先级,并在宽媒体样例上观察桌面与窄屏的实际布局。
16
+
17
+ ## 典型用法
18
+
19
+ ```vue
20
+ <script setup lang="ts">
21
+ import { OgEditorViewer } from '@origen-ui/editor'
22
+ </script>
23
+
24
+ <template>
25
+ <OgEditorViewer :og-content="article.content" og-empty-text="暂无内容" />
26
+ </template>
27
+ ```
28
+
29
+ ## API
30
+
31
+ ### Attributes
32
+
33
+ | 属性 | 类型 | 默认值 | 说明 |
34
+ | ------------------ | ----------------------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
35
+ | `ogSsrMode` | `'text' \| 'html'` | `'text'` | SSR 输出纯文本或显式 HTML 模式。 |
36
+ | `ogServerSanitize` | `(html: string) => string` | - | `ogSsrMode="html"` 时使用的服务端净化函数。 |
37
+ | `ogContent` | `string` | `''` | 要展示的 HTML 内容。 |
38
+ | `ogEmptyText` | `string` | 当前 locale 的空内容文案 | 内容被判空、或清洗结果为空字符串时展示的文本。判空作用于**原始 `ogContent`**,与清洗结果无关。 |
39
+ | `ogLocale` | `DeepPartial<OgEditorLocale>` | 继承应用级 locale | 覆盖空内容等查看器文案;局部值优先于全局值。 |
40
+ | `ogSanitize` | `(html: string) => string` | 无(回退应用级 `createOgEditor({ ogSanitize })`,再回退内置清洗) | 覆盖默认清洗函数。仅传入可信且经过审查的实现。 |
41
+
42
+ 组件不暴露事件、插槽或实例方法。
43
+
44
+ SSR 默认使用 `ogSsrMode="text"` 输出安全纯文本。需要服务端 HTML 时,显式设置 `ogSsrMode="html"` 并提供 `ogServerSanitize`;浏览器端 `ogSanitize` 不承担无 DOM 的服务端净化职责。
45
+
46
+ ## 高级能力
47
+
48
+ ## 公开导出与安全边界
49
+
50
+ `OgEditorViewer` 直接使用包内导出的 `isEditorHtmlEmpty` 与 `sanitizeEditorHtml`,并在内部使用未公开导出的 `extractEditorText`。URL 安全判定发生在 `sanitizeEditorHtml` 的 URI 白名单内,`isSafeUrl` / `isSafeMediaUrl` 是编辑器侧的导出工具,`OgEditorViewer` 本身不调用它们。完整导出清单见 [OgEditor 安全 API](./editor.md#完整公开导出)。
51
+
52
+ 组件在服务端/挂载前输出可安全插入的纯文本占位;挂载后才调用清洗器并渲染 HTML。
53
+
54
+ ### 自定义 sanitizer 信任边界
55
+
56
+ - 清洗函数按 `props.ogSanitize?.(ogContent) ?? globalConfig?.ogSanitize?.(ogContent) ?? sanitizeEditorHtml(ogContent)` 解析。只要回调返回非空字符串,应用级与内置清洗都不会被调用。这里的回退是 `??` 的**运行时**语义:`ogSanitize` 的类型是 `(html: string) => string`,返回 `null`/`undefined` 在 TypeScript 下已是类型错误,但运行时仍会回退到应用级 `ogSanitize`、再回退到内置 `sanitizeEditorHtml`。因此它是**替换**而不是“额外加固”选项。
57
+ - 回调返回值会被直接交给 `v-html`,因此回调**必须返回已经安全的 HTML**。若回调原样返回输入,`OgEditorViewer` 会失去全部清洗能力。
58
+ - 回调返回 `''` 会把非空内容静默变成空态(见下面的分支表),这也是信任边界的一部分。
59
+ - 回调在服务端不会被调用:`safeHtml` 依赖 `mounted`,服务端只走纯文本分支。SSR 输出不依赖 sanitizer 在无 DOM 环境下的行为。
60
+ - 内置 `sanitizeEditorHtml` 在 `typeof window === 'undefined'` 时返回 `''`;`profile: 'trusted'` 会在严格白名单上追加 `iframe` 与 `style`,只能用于已由应用校验过的内容。
61
+ - Demo 中的自定义 sanitizer 把内容压成纯文本(`sanitizeToText`),用于验证“渲染结果等于回调返回值”,它本身不是推荐的安全策略。它在“危险 HTML”样例上会把 `<script>` 的**文本内容**保留为可见文本(内置清洗会整段删除),这正是自定义回调必须逐字审查的原因:文本虽被转义、不会执行,但暴露面已经改变。
62
+
63
+ ## 渲染阶段与 SSR 证据
64
+
65
+ 模板的判据是 `v-if="safeHtml"`。`safeHtml` 在以下三种情况下都是 `''`:尚未挂载、`isEditorHtmlEmpty(ogContent)` 为真、清洗结果为空字符串。因此“判空函数为 false”**并不足以**进入 `v-html` 分支。
66
+
67
+ | 阶段 | 条件 | 输出 |
68
+ | --------------------------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
69
+ | 服务端 / 挂载前,内容含可见文本 | `!mounted && ssrText` | `extractEditorText` 抽取的纯文本(经插值转义;不含标签元素,文本里的字面 `<` 同样被转义) |
70
+ | 服务端 / 挂载前,内容为空 | `!mounted && isEditorHtmlEmpty(ogContent)` | 空态文案 |
71
+ | 服务端 / 挂载前,只有媒体或清洗后无文本 | `!mounted && !ssrText` | 空态文案,避免输出空的正文 `<article>` |
72
+ | 挂载后,可渲染 | `mounted && !isEditorHtmlEmpty(ogContent)` 且清洗结果非空字符串 | 清洗结果经 `v-html` 渲染 |
73
+ | 挂载后,其余情况 | `mounted` 且(`isEditorHtmlEmpty(ogContent)` 或清洗结果为 `''`) | 空态文案 |
74
+
75
+ **边界:判空为 `false` 但没有可渲染内容。** SSR 会额外检查抽取后的文本,因此纯媒体内容直接进入空态。客户端仍以清洗结果作为渲染判据:
76
+
77
+ - 客户端:若自定义 `sanitize` 返回只含注释或其他不可见内容的非空字符串,`safeHtml` 仍会渲染出空的 `<article>`;自定义 sanitizer 必须自行保证返回可见且安全的 HTML。
78
+
79
+ 对应证据:
80
+
81
+ | 分支 | 证据位置 |
82
+ | ------------------ | -------------------------------------------- |
83
+ | SSR 有内容 | The project test suite covers this behavior. |
84
+ | SSR 无内容 | The project test suite covers this behavior. |
85
+ | CSR 有内容(清洗) | The project test suite covers this behavior. |
86
+ | CSR 有内容(Docs) | The project test suite covers this behavior. |
87
+ | CSR 无内容 | 同上 Docs 浏览器用例 |