@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,717 @@
1
+ import { Buffer } from 'node:buffer'
2
+ import { randomUUID } from 'node:crypto'
3
+ import { existsSync, constants as fsConstants } from 'node:fs'
4
+ import { link, lstat, mkdir, open, readdir, readFile, rm, rmdir, writeFile } from 'node:fs/promises'
5
+ import { hostname } from 'node:os'
6
+ import { dirname, join, relative, resolve, sep } from 'node:path'
7
+ import process from 'node:process'
8
+ import {
9
+ collectManagedContractFiles,
10
+ isManagedContractPath,
11
+ validateManagedContractHashes,
12
+ } from './contract-sync.mjs'
13
+ import { hasErrorCode } from './lib/errors.mjs'
14
+ import { readJson } from './lib/fs-json.mjs'
15
+ import { sha256 } from './lib/hash.mjs'
16
+
17
+ const lockName = '.og-admin-sync.lock'
18
+ const transactionName = '.og-admin-sync.transaction.json'
19
+
20
+ /**
21
+ * @param {{ cwd: string, packageRoot: string }} options
22
+ */
23
+ export async function syncProject({ cwd, packageRoot }) {
24
+ const root = resolve(cwd)
25
+ const resolvedPackageRoot = resolve(packageRoot)
26
+ const lockPath = join(root, lockName)
27
+ const owner = await acquireLock(lockPath)
28
+ try {
29
+ await recoverPendingTransaction(root)
30
+ const projectState = await readProjectContractState(root, resolvedPackageRoot)
31
+ const inputs = await readTemplateContractState(root, projectState)
32
+ const currentFiles = await readCurrentManagedFiles(root, inputs)
33
+ const nextFiles = await readNextTemplateFiles(inputs)
34
+ const allPaths = currentFiles.allPaths
35
+ const plan = { allPaths, actualCurrentFiles: currentFiles.actualCurrentFiles, nextFiles }
36
+ return await commitContractSync(root, inputs, plan)
37
+ } finally {
38
+ await releaseLock(lockPath, owner)
39
+ }
40
+ }
41
+
42
+ /**
43
+ * 阶段一(前半):读取项目锁与依赖声明,校验当前项目契约和已装 CLI 版本。
44
+ * @param {string} root
45
+ * @param {string} packageRoot
46
+ */
47
+ async function readProjectContractState(root, packageRoot) {
48
+ const projectManifest = await readJson(join(root, 'package.json'), 'Admin package.json')
49
+ const currentLock = await readJson(join(root, 'scaffold.lock.json'), 'Admin scaffold lock')
50
+ const currentContract = currentLock.componentContractSync
51
+ if (
52
+ currentLock.schemaVersion !== 1 ||
53
+ !currentContract ||
54
+ currentContract.schemaVersion !== 1 ||
55
+ !['clean', 'examples'].includes(currentLock.variant)
56
+ ) {
57
+ throw new Error(
58
+ 'This Admin project does not contain the current component-contract sync marker. Upgrade sync is supported only for projects created by a current Admin CLI template.',
59
+ )
60
+ }
61
+
62
+ const cliManifest = await readJson(join(packageRoot, 'package.json'), 'Admin CLI package')
63
+ const declaredCli =
64
+ projectManifest.dependencies?.['@origen-ui/admin-cli'] ??
65
+ projectManifest.devDependencies?.['@origen-ui/admin-cli']
66
+ if (typeof declaredCli !== 'string') {
67
+ throw new TypeError(
68
+ 'Admin package.json must declare @origen-ui/admin-cli before syncing component guidance.',
69
+ )
70
+ }
71
+ const installedCli = await readJson(
72
+ join(root, 'node_modules', '@origen-ui', 'admin-cli', 'package.json'),
73
+ 'installed @origen-ui/admin-cli package',
74
+ )
75
+ if (installedCli.version !== cliManifest.version) {
76
+ throw new Error(
77
+ `Installed @origen-ui/admin-cli is ${installedCli.version}; this command is ${cliManifest.version}. Update the project CLI dependency before syncing component guidance.`,
78
+ )
79
+ }
80
+
81
+ return {
82
+ projectManifest,
83
+ currentLock,
84
+ currentContract,
85
+ cliManifest,
86
+ packageRoot,
87
+ }
88
+ }
89
+
90
+ /**
91
+ * 阶段一(后半):读取模板锁、hash 与 catalog,校验模板契约和已装组件包版本。
92
+ * @param {string} root
93
+ * @param {Awaited<ReturnType<typeof readProjectContractState>>} projectState
94
+ */
95
+ async function readTemplateContractState(root, projectState) {
96
+ const { projectManifest, currentLock, currentContract, cliManifest, packageRoot } = projectState
97
+ const template = join(packageRoot, 'templates', 'current', currentLock.variant)
98
+ const nextLock = await readJson(join(template, 'scaffold.lock.json'), 'Admin CLI template lock')
99
+ const nextContract = nextLock.componentContractSync
100
+ if (nextContract?.schemaVersion !== 1 || nextContract.sourceVersion !== cliManifest.version) {
101
+ throw new Error(
102
+ 'The installed Admin CLI template has an invalid component-contract sync marker.',
103
+ )
104
+ }
105
+
106
+ const currentHashes = validateManagedContractHashes(currentContract.managedFiles)
107
+ const nextHashes = validateManagedContractHashes(nextContract.managedFiles)
108
+ const actualTemplateFiles = await collectManagedContractFiles(template)
109
+ if (!sameStrings(actualTemplateFiles, Object.keys(nextHashes).sort())) {
110
+ throw new Error('The Admin CLI template and its component-contract lock are out of sync.')
111
+ }
112
+
113
+ const catalog = await readJson(join(template, 'component-catalog.v2.json'), 'component catalog')
114
+ if (
115
+ catalog.schemaVersion !== 2 ||
116
+ catalog.kind !== 'component-catalog' ||
117
+ !catalog.packageVersions ||
118
+ !sameJson(catalog.packageVersions, nextContract.packageVersions)
119
+ ) {
120
+ throw new Error('The Admin CLI component catalog and sync lock are out of sync.')
121
+ }
122
+ await verifyInstalledPackageVersions(root, projectManifest, catalog.packageVersions)
123
+
124
+ return {
125
+ currentLock,
126
+ currentHashes,
127
+ nextLock,
128
+ nextContract,
129
+ nextHashes,
130
+ template,
131
+ }
132
+ }
133
+
134
+ /**
135
+ * 阶段二(前半):校验当前托管文件状态,收集实际内容。
136
+ * @param {string} root
137
+ * @param {Awaited<ReturnType<typeof readTemplateContractState>>} inputs
138
+ */
139
+ async function readCurrentManagedFiles(root, inputs) {
140
+ const { currentHashes, nextHashes } = inputs
141
+ const actualCurrentFiles = new Map()
142
+ const pathSet = new Set(Object.keys(currentHashes))
143
+ for (const path of Object.keys(nextHashes)) pathSet.add(path)
144
+ const allPaths = [...pathSet].sort()
145
+ for (const path of allPaths) {
146
+ await assertSafeManagedPath(root, path)
147
+ const actual = await readManagedFile(root, path)
148
+ const oldHash = currentHashes[path]
149
+ const nextHash = nextHashes[path]
150
+ if (oldHash) {
151
+ if (!actual || sha256(actual) !== oldHash) {
152
+ throw new Error(
153
+ `Managed component guidance was changed or removed: ${path}. Preserve your edits, restore the generated file, then run sync again.`,
154
+ )
155
+ }
156
+ } else if (actual && sha256(actual) !== nextHash) {
157
+ throw new Error(
158
+ `A new managed component-guidance path already exists with custom content: ${path}. Move or reconcile it before syncing.`,
159
+ )
160
+ }
161
+ if (actual) actualCurrentFiles.set(path, actual)
162
+ }
163
+ return { allPaths, actualCurrentFiles }
164
+ }
165
+
166
+ /**
167
+ * 阶段二(后半):读取模板目标内容并校验其 hash。
168
+ * @param {Awaited<ReturnType<typeof readTemplateContractState>>} inputs
169
+ */
170
+ async function readNextTemplateFiles(inputs) {
171
+ const { nextHashes, template } = inputs
172
+ const nextFiles = new Map()
173
+ for (const path of Object.keys(nextHashes)) {
174
+ const content = await readManagedFile(template, path)
175
+ if (!content || sha256(content) !== nextHashes[path]) {
176
+ throw new Error(
177
+ `Admin CLI template content does not match its component-contract lock: ${path}.`,
178
+ )
179
+ }
180
+ nextFiles.set(path, content)
181
+ }
182
+ return nextFiles
183
+ }
184
+
185
+ /**
186
+ * 阶段三:组装新 lock,判断是否需要写入并提交事务。
187
+ * @param {string} root
188
+ * @param {Awaited<ReturnType<typeof readTemplateContractState>>} inputs
189
+ * @param {{ allPaths: string[], actualCurrentFiles: Map<string, Buffer>, nextFiles: Map<string, Buffer> }} plan
190
+ */
191
+ async function commitContractSync(root, inputs, plan) {
192
+ const { currentLock, nextLock, nextContract } = inputs
193
+ const { allPaths, actualCurrentFiles, nextFiles } = plan
194
+ const updatedLock = {
195
+ ...currentLock,
196
+ agentContractsVersion: nextLock.agentContractsVersion,
197
+ managedFiles: {
198
+ ...currentLock.managedFiles,
199
+ ...nextLock.managedFiles,
200
+ },
201
+ componentContractSync: nextContract,
202
+ }
203
+ const lockContent = Buffer.from(`${JSON.stringify(updatedLock, null, 2)}\n`)
204
+ const changedPaths = allPaths.filter((path) => {
205
+ const next = nextFiles.get(path)
206
+ const current = actualCurrentFiles.get(path)
207
+ if (next) return !current || !current.equals(next)
208
+ return Boolean(current)
209
+ })
210
+ const existingLock = await readManagedFile(root, 'scaffold.lock.json')
211
+ if (!changedPaths.length && existingLock?.equals(lockContent)) {
212
+ return { updatedFiles: 0, sourceVersion: nextContract.sourceVersion }
213
+ }
214
+
215
+ await applyContractTransaction(root, changedPaths, nextFiles, lockContent)
216
+ return { updatedFiles: changedPaths.length, sourceVersion: nextContract.sourceVersion }
217
+ }
218
+
219
+ /**
220
+ * @param {string} root
221
+ * @param {any} projectManifest
222
+ * @param {Record<string, string>} packageVersions
223
+ */
224
+ async function verifyInstalledPackageVersions(root, projectManifest, packageVersions) {
225
+ for (const [packageName, expectedVersion] of Object.entries(packageVersions)) {
226
+ const declared =
227
+ projectManifest.dependencies?.[packageName] ?? projectManifest.devDependencies?.[packageName]
228
+ if (typeof declared !== 'string') {
229
+ throw new TypeError(
230
+ `Admin package.json does not declare ${packageName}; sync stopped without changes.`,
231
+ )
232
+ }
233
+ const installed = await readJson(
234
+ join(root, 'node_modules', ...packageName.split('/'), 'package.json'),
235
+ `installed ${packageName} package`,
236
+ )
237
+ if (installed.name !== packageName || installed.version !== expectedVersion) {
238
+ throw new Error(
239
+ `${packageName} is installed at ${installed.version ?? 'an unknown version'}, while the Admin CLI guidance describes ${expectedVersion}. Update the component packages and @origen-ui/admin-cli together, then run sync again.`,
240
+ )
241
+ }
242
+ }
243
+ }
244
+
245
+ /**
246
+ * 写入事务:先原子安装恢复 journal,再写目标文件与 lock,失败时按 journal 回滚。
247
+ * @param {string} root
248
+ * @param {string[]} paths
249
+ * @param {Map<string, Buffer>} nextFiles
250
+ * @param {Buffer} lockContent
251
+ */
252
+ async function applyContractTransaction(root, paths, nextFiles, lockContent) {
253
+ const state = {
254
+ temporaryJournalPath: /** @type {string | undefined} */ (undefined),
255
+ temporaryJournalCreated: false,
256
+ journalCreated: false,
257
+ }
258
+ try {
259
+ await prepareTransactionJournal(root, paths, state)
260
+ await writeTransactionTargets(root, paths, nextFiles, lockContent)
261
+ } catch (error) {
262
+ if (state.temporaryJournalCreated && state.temporaryJournalPath)
263
+ await rm(state.temporaryJournalPath, { force: true })
264
+ if (!state.journalCreated) throw error
265
+ try {
266
+ await recoverPendingTransaction(root)
267
+ } catch (rollbackError) {
268
+ let rollbackMessage = String(rollbackError)
269
+ if (rollbackError instanceof Error) rollbackMessage = rollbackError.message
270
+ throw new Error(
271
+ `Admin component guidance sync failed and rollback also failed: ${rollbackMessage}`,
272
+ {
273
+ cause: error,
274
+ },
275
+ )
276
+ }
277
+ throw error
278
+ }
279
+ }
280
+
281
+ /**
282
+ * 阶段一:读取现有托管文件、构造并原子安装恢复 journal。
283
+ * @param {string} root
284
+ * @param {string[]} paths
285
+ * @param {{ temporaryJournalPath: string | undefined, temporaryJournalCreated: boolean, journalCreated: boolean }} state
286
+ */
287
+ async function prepareTransactionJournal(root, paths, state) {
288
+ const lockPath = 'scaffold.lock.json'
289
+ const operations = [...paths, lockPath]
290
+ const existed = /** @type {Record<string, boolean>} */ ({})
291
+ const backups = /** @type {Record<string, string>} */ ({})
292
+ const transactionPath = join(root, transactionName)
293
+ for (const path of operations) {
294
+ await assertSafeManagedPath(root, path)
295
+ const current = await readManagedFile(root, path)
296
+ existed[path] = Boolean(current)
297
+ if (current) backups[path] = current.toString('base64')
298
+ }
299
+
300
+ const journalContent = Buffer.from(
301
+ `${JSON.stringify(
302
+ {
303
+ schemaVersion: 2,
304
+ paths: operations,
305
+ existed,
306
+ backups,
307
+ },
308
+ null,
309
+ 2,
310
+ )}\n`,
311
+ )
312
+ const journalTempPath = join(root, `${transactionName}.${randomUUID()}.tmp`)
313
+ state.temporaryJournalPath = journalTempPath
314
+ const journalHandle = await open(journalTempPath, 'wx')
315
+ state.temporaryJournalCreated = true
316
+ try {
317
+ await journalHandle.writeFile(journalContent)
318
+ await journalHandle.sync()
319
+ } finally {
320
+ await journalHandle.close()
321
+ }
322
+ // Linking installs the complete journal atomically without replacing an existing one.
323
+ await link(journalTempPath, transactionPath)
324
+ state.journalCreated = true
325
+ await rm(journalTempPath)
326
+ state.temporaryJournalCreated = false
327
+ }
328
+
329
+ /**
330
+ * 阶段二:按事务计划写目标文件、写 lock、移除 journal。
331
+ * @param {string} root
332
+ * @param {string[]} paths
333
+ * @param {Map<string, Buffer>} nextFiles
334
+ * @param {Buffer} lockContent
335
+ */
336
+ async function writeTransactionTargets(root, paths, nextFiles, lockContent) {
337
+ const lockPath = 'scaffold.lock.json'
338
+ const transactionPath = join(root, transactionName)
339
+ for (const path of paths) {
340
+ const target = join(root, path)
341
+ if (existsSync(target)) await rm(target)
342
+ if (nextFiles.has(path)) {
343
+ const nextContent = nextFiles.get(path)
344
+ if (!nextContent) throw new Error(`Admin sync is missing next content for ${path}.`)
345
+ await mkdir(dirname(target), { recursive: true })
346
+ await writeFile(target, nextContent)
347
+ } else {
348
+ await removeEmptyParents(root, dirname(target))
349
+ }
350
+ }
351
+ const targetLock = join(root, lockPath)
352
+ await rm(targetLock)
353
+ await writeFile(targetLock, lockContent)
354
+ await rm(transactionPath, { force: true })
355
+ }
356
+
357
+ /**
358
+ * 恢复未完成事务:先完整校验 journal,再执行任何写操作。
359
+ * @param {string} root
360
+ */
361
+ async function recoverPendingTransaction(root) {
362
+ const transactionPath = join(root, transactionName)
363
+ const journal = await readRecoveryJournal(transactionPath)
364
+ if (journal === undefined) return
365
+ const transaction = assertJournalBasicShape(journal.value)
366
+ assertJournalCollections(transaction)
367
+ const recoveryBackups = parseRecoveryPaths(transaction)
368
+ for (const path of transaction.paths) await assertSafeManagedPath(root, path)
369
+ await restoreRecoveryPaths(root, transaction, recoveryBackups)
370
+ await removeTemporaryJournalLinks(root, journal.identity)
371
+ await rm(transactionPath, { force: true })
372
+ }
373
+
374
+ /**
375
+ * 阶段一(前半):校验事务对象类型、schema 版本与顶层键白名单。
376
+ * @param {any} value
377
+ */
378
+ function assertJournalBasicShape(value) {
379
+ const transaction = value
380
+ if (!transaction || typeof transaction !== 'object' || Array.isArray(transaction)) {
381
+ throw new Error('An incomplete Admin sync transaction has an invalid recovery journal.')
382
+ }
383
+ if (transaction.schemaVersion === 1) {
384
+ throw new Error(
385
+ 'An incomplete Admin sync transaction uses unsupported schema version 1; automatic recovery is unavailable.',
386
+ )
387
+ }
388
+ if (
389
+ transaction.schemaVersion !== 2 ||
390
+ !sameStrings(Object.keys(transaction).sort(), [
391
+ 'backups',
392
+ 'existed',
393
+ 'paths',
394
+ 'schemaVersion',
395
+ ])
396
+ ) {
397
+ throw new Error('An incomplete Admin sync transaction has an invalid recovery journal.')
398
+ }
399
+ return transaction
400
+ }
401
+
402
+ /**
403
+ * 阶段一(后半):校验 paths / existed / backups 三个集合的形状。
404
+ * @param {any} transaction
405
+ */
406
+ function assertJournalCollections(transaction) {
407
+ if (!Array.isArray(transaction.paths) || transaction.paths.length === 0) {
408
+ throw new Error('An incomplete Admin sync transaction has an invalid recovery journal.')
409
+ }
410
+ if (
411
+ !transaction.existed ||
412
+ typeof transaction.existed !== 'object' ||
413
+ Array.isArray(transaction.existed)
414
+ ) {
415
+ throw new Error('An incomplete Admin sync transaction has an invalid recovery journal.')
416
+ }
417
+ if (
418
+ !transaction.backups ||
419
+ typeof transaction.backups !== 'object' ||
420
+ Array.isArray(transaction.backups)
421
+ ) {
422
+ throw new Error('An incomplete Admin sync transaction has an invalid recovery journal.')
423
+ }
424
+ }
425
+
426
+ /**
427
+ * 阶段二:逐条校验恢复路径并收集备份内容,校验全部通过前不写文件。
428
+ * @param {any} transaction
429
+ */
430
+ function parseRecoveryPaths(transaction) {
431
+ const pathSet = new Set()
432
+ const recoveryBackups = parseJournalPathEntries(transaction, pathSet)
433
+ assertJournalConsistency(transaction, pathSet)
434
+ return recoveryBackups
435
+ }
436
+
437
+ /**
438
+ * 阶段二(前半):逐条校验路径并收集 base64 备份内容。
439
+ * @param {any} transaction
440
+ * @param {Set<any>} pathSet
441
+ */
442
+ function parseJournalPathEntries(transaction, pathSet) {
443
+ const recoveryBackups = new Map()
444
+ for (const path of transaction.paths) {
445
+ if (typeof path !== 'string')
446
+ throw new TypeError('An incomplete Admin sync transaction has an invalid recovery journal.')
447
+ if (path !== 'scaffold.lock.json' && !isManagedContractPath(path))
448
+ throw new Error(`Admin sync recovery journal contains an invalid path: ${path}.`)
449
+ if (pathSet.has(path)) {
450
+ throw new Error('An incomplete Admin sync transaction has a duplicate recovery path.')
451
+ }
452
+ pathSet.add(path)
453
+ if (
454
+ !Object.hasOwn(transaction.existed, path) ||
455
+ typeof transaction.existed[path] !== 'boolean'
456
+ ) {
457
+ throw new Error('An incomplete Admin sync transaction has an invalid recovery journal.')
458
+ }
459
+ if (transaction.existed[path]) {
460
+ const encodedBackup = transaction.backups[path]
461
+ if (
462
+ typeof encodedBackup !== 'string' ||
463
+ Buffer.from(encodedBackup, 'base64').toString('base64') !== encodedBackup
464
+ ) {
465
+ throw new Error(
466
+ `An incomplete Admin sync transaction has invalid recovery backup data for ${path}.`,
467
+ )
468
+ }
469
+ recoveryBackups.set(path, Buffer.from(encodedBackup, 'base64'))
470
+ } else if (Object.hasOwn(transaction.backups, path)) {
471
+ throw new Error('An incomplete Admin sync transaction has an invalid recovery journal.')
472
+ }
473
+ }
474
+ return recoveryBackups
475
+ }
476
+
477
+ /**
478
+ * 阶段二(后半):校验 existed / backups 键集与路径集一致,且 lock 必须存在。
479
+ * @param {any} transaction
480
+ * @param {Set<any>} pathSet
481
+ */
482
+ function assertJournalConsistency(transaction, pathSet) {
483
+ if (Object.keys(transaction.existed).some((path) => !pathSet.has(path))) {
484
+ throw new Error('An incomplete Admin sync transaction has an invalid recovery journal.')
485
+ }
486
+ if (
487
+ Object.keys(transaction.backups).some(
488
+ (path) => !pathSet.has(path) || transaction.existed[path] !== true,
489
+ )
490
+ ) {
491
+ throw new Error('An incomplete Admin sync transaction has an invalid recovery journal.')
492
+ }
493
+ if (!pathSet.has('scaffold.lock.json') || transaction.existed['scaffold.lock.json'] !== true) {
494
+ throw new Error('An incomplete Admin sync transaction has an invalid recovery journal.')
495
+ }
496
+ }
497
+
498
+ /**
499
+ * 阶段三:按已校验的事务恢复各托管路径。
500
+ * @param {string} root
501
+ * @param {any} transaction
502
+ * @param {Map<any, any>} recoveryBackups
503
+ */
504
+ async function restoreRecoveryPaths(root, transaction, recoveryBackups) {
505
+ for (const path of transaction.paths) {
506
+ const target = join(root, path)
507
+ if (transaction.existed[path]) {
508
+ await rm(target, { force: true, recursive: true })
509
+ await mkdir(dirname(target), { recursive: true })
510
+ await writeFile(target, recoveryBackups.get(path))
511
+ } else {
512
+ await rm(target, { force: true, recursive: true })
513
+ }
514
+ }
515
+ }
516
+
517
+ /** @param {string} path */
518
+ async function readRecoveryJournal(path) {
519
+ let originalDetails
520
+ try {
521
+ originalDetails = await lstat(path)
522
+ } catch (error) {
523
+ if (hasErrorCode(error, 'ENOENT')) return undefined
524
+ throw error
525
+ }
526
+ if (originalDetails.isSymbolicLink() || !originalDetails.isFile()) {
527
+ throw new Error('An incomplete Admin sync transaction journal is not a regular file.')
528
+ }
529
+
530
+ const flags = fsConstants.O_RDONLY | (fsConstants.O_NOFOLLOW ?? 0)
531
+ const handle = await open(path, flags)
532
+ try {
533
+ const openedDetails = await handle.stat()
534
+ if (
535
+ !openedDetails.isFile() ||
536
+ openedDetails.dev !== originalDetails.dev ||
537
+ openedDetails.ino !== originalDetails.ino
538
+ ) {
539
+ throw new Error('An incomplete Admin sync transaction journal changed while opening.')
540
+ }
541
+
542
+ const content = await handle.readFile('utf8')
543
+ try {
544
+ return {
545
+ value: JSON.parse(content),
546
+ identity: { dev: openedDetails.dev, ino: openedDetails.ino },
547
+ }
548
+ } catch {
549
+ throw new Error('Admin sync transaction is not valid JSON.')
550
+ }
551
+ } finally {
552
+ await handle.close()
553
+ }
554
+ }
555
+
556
+ /** @param {string} root @param {string} path */
557
+ async function assertSafeManagedPath(root, path) {
558
+ if (path !== 'scaffold.lock.json' && !isManagedContractPath(path))
559
+ throw new Error(`Refusing to sync an unmanaged Admin path: ${path}.`)
560
+ const segments = path.split('/')
561
+ let current = root
562
+ for (let index = 0; index < segments.length; index += 1) {
563
+ current = join(current, segments[index])
564
+ let details
565
+ try {
566
+ details = await lstat(current)
567
+ } catch (error) {
568
+ if (hasErrorCode(error, 'ENOENT')) continue
569
+ throw error
570
+ }
571
+ if (details.isSymbolicLink())
572
+ throw new Error(`Refusing to sync through a symlinked Admin path: ${path}.`)
573
+ const isLeaf = index === segments.length - 1
574
+ if (!isLeaf && !details.isDirectory())
575
+ throw new Error(`Admin managed path has a non-directory parent: ${path}.`)
576
+ if (isLeaf && !details.isFile())
577
+ throw new Error(`Admin managed path is not a regular file: ${path}.`)
578
+ }
579
+ }
580
+
581
+ /** @param {string} root @param {string} path */
582
+ async function readManagedFile(root, path) {
583
+ if (path !== 'scaffold.lock.json' && !isManagedContractPath(path))
584
+ throw new Error(`Refusing to read an unmanaged Admin path: ${path}.`)
585
+ try {
586
+ const details = await lstat(join(root, path))
587
+ if (details.isSymbolicLink() || !details.isFile())
588
+ throw new Error(`Managed Admin path is not a regular file: ${path}.`)
589
+ return await readFile(join(root, path))
590
+ } catch (error) {
591
+ if (hasErrorCode(error, 'ENOENT')) return null
592
+ throw error
593
+ }
594
+ }
595
+
596
+ /** @param {string} path */
597
+ async function acquireLock(path) {
598
+ const owner = {
599
+ token: randomUUID(),
600
+ pid: process.pid,
601
+ hostname: hostname(),
602
+ createdAt: new Date().toISOString(),
603
+ }
604
+ try {
605
+ await writeFile(path, `${JSON.stringify(owner, null, 2)}\n`, { flag: 'wx' })
606
+ return owner
607
+ } catch (error) {
608
+ if (!hasErrorCode(error, 'EEXIST')) throw error
609
+ let current
610
+ try {
611
+ current = JSON.parse(await readFile(path, 'utf8'))
612
+ } catch {
613
+ throw new Error(`Another Admin component guidance sync may be running; inspect ${path}.`)
614
+ }
615
+ if (!hasValidLockOwnerMetadata(current)) {
616
+ throw new Error(`Another Admin component guidance sync may be running; inspect ${path}.`)
617
+ }
618
+ throw new Error(
619
+ `Another Admin component guidance sync lock exists; verify its owner has stopped before removing ${path}.`,
620
+ )
621
+ }
622
+ }
623
+
624
+ /** @param {unknown} value */
625
+ function hasValidLockOwnerMetadata(value) {
626
+ if (!value || typeof value !== 'object' || Array.isArray(value)) return false
627
+ const owner = /** @type {Record<string, unknown>} */ (value)
628
+ const createdAt = owner.createdAt
629
+ let createdAtMilliseconds = Number.NaN
630
+ if (typeof createdAt === 'string') createdAtMilliseconds = Date.parse(createdAt)
631
+ return (
632
+ typeof owner.token === 'string' &&
633
+ owner.token.length > 0 &&
634
+ typeof owner.pid === 'number' &&
635
+ Number.isSafeInteger(owner.pid) &&
636
+ owner.pid > 0 &&
637
+ typeof owner.hostname === 'string' &&
638
+ owner.hostname.length > 0 &&
639
+ Number.isFinite(createdAtMilliseconds) &&
640
+ new Date(createdAtMilliseconds).toISOString() === createdAt
641
+ )
642
+ }
643
+
644
+ /** @param {string} path @param {{ token: string }} owner */
645
+ async function releaseLock(path, owner) {
646
+ if (!existsSync(path)) return
647
+ const current = await readJson(path, 'Admin sync lock')
648
+ if (current.token !== owner.token)
649
+ throw new Error('Refusing to release an Admin sync lock owned by another process.')
650
+ await rm(path, { force: true })
651
+ }
652
+
653
+ /**
654
+ * Remove only temporary hard links that still refer to the validated recovery journal.
655
+ * @param {string} root
656
+ * @param {{ dev: number, ino: number }} identity
657
+ */
658
+ async function removeTemporaryJournalLinks(root, identity) {
659
+ const prefix = `${transactionName}.`
660
+ const names = await readdir(root)
661
+ for (const name of names) {
662
+ if (!name.startsWith(prefix) || !name.endsWith('.tmp')) continue
663
+ const token = name.slice(prefix.length, -'.tmp'.length)
664
+ if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu.test(token))
665
+ continue
666
+ const candidatePath = join(root, name)
667
+ let candidate
668
+ try {
669
+ candidate = await lstat(candidatePath)
670
+ } catch (error) {
671
+ if (hasErrorCode(error, 'ENOENT')) continue
672
+ throw error
673
+ }
674
+ if (
675
+ candidate.isFile() &&
676
+ !candidate.isSymbolicLink() &&
677
+ candidate.dev === identity.dev &&
678
+ candidate.ino === identity.ino
679
+ ) {
680
+ await rm(candidatePath)
681
+ }
682
+ }
683
+ }
684
+
685
+ /** @param {string} root @param {string} directory */
686
+ async function removeEmptyParents(root, directory) {
687
+ let current = directory
688
+ while (current !== root && isInside(root, current)) {
689
+ try {
690
+ await rmdir(current)
691
+ } catch (error) {
692
+ if (hasErrorCode(error, 'ENOENT')) {
693
+ current = dirname(current)
694
+ continue
695
+ }
696
+ if (hasErrorCode(error, 'ENOTEMPTY') || hasErrorCode(error, 'EEXIST')) return
697
+ throw error
698
+ }
699
+ current = dirname(current)
700
+ }
701
+ }
702
+
703
+ /** @param {string[]} left @param {string[]} right */
704
+ function sameStrings(left, right) {
705
+ return left.length === right.length && left.every((value, index) => value === right[index])
706
+ }
707
+
708
+ /** @param {unknown} left @param {unknown} right */
709
+ function sameJson(left, right) {
710
+ return JSON.stringify(left) === JSON.stringify(right)
711
+ }
712
+
713
+ /** @param {string} parent @param {string} path */
714
+ function isInside(parent, path) {
715
+ const relativePath = relative(resolve(parent), resolve(path))
716
+ return Boolean(relativePath) && !relativePath.startsWith(`..${sep}`) && relativePath !== '..'
717
+ }