@origen-ui/admin-cli 2.0.1 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (892) hide show
  1. package/README.md +50 -11
  2. package/bin/contract-sync.mjs +112 -0
  3. package/bin/lib/errors.mjs +8 -0
  4. package/bin/lib/fs-json.mjs +18 -0
  5. package/bin/lib/hash.mjs +9 -0
  6. package/bin/og-admin.mjs +165 -35
  7. package/bin/sync-project.mjs +717 -0
  8. package/package.json +28 -17
  9. package/templates/current/clean/.agents/skills/admin-component-usage/SKILL.md +28 -0
  10. package/templates/current/clean/.agents/skills/admin-component-usage/references/component-directory.md +270 -0
  11. package/templates/current/clean/.agents/skills/build-admin-feature/SKILL.md +20 -0
  12. package/templates/current/clean/.agents/skills/build-admin-feature/references/component-selection.md +38 -0
  13. package/templates/current/{examples/.codex → clean/.agents}/skills/use-og-form/SKILL.md +1 -1
  14. package/templates/current/{examples/.codex → clean/.agents}/skills/use-og-form-table/SKILL.md +4 -3
  15. package/templates/current/clean/{.codex → .agents}/skills/use-og-search/SKILL.md +3 -3
  16. package/templates/current/clean/.agents/skills/use-og-table/SKILL.md +22 -0
  17. package/templates/current/{examples/.codex → clean/.agents}/skills/use-og-upload/SKILL.md +6 -5
  18. package/templates/current/clean/.api-client-e2e.config.ts +13 -0
  19. package/templates/current/clean/.claude/rules/01-feature-architecture.md +10 -0
  20. package/templates/current/clean/.claude/rules/02-vue-typescript.md +10 -0
  21. package/templates/current/clean/.claude/rules/03-component-policy.md +31 -0
  22. package/templates/current/clean/.claude/rules/04-api-auth-router.md +10 -0
  23. package/templates/current/clean/.claude/rules/05-style.md +10 -0
  24. package/templates/current/clean/.claude/rules/06-quality.md +10 -0
  25. package/templates/current/clean/.claude/skills/admin-component-usage/SKILL.md +28 -0
  26. package/templates/current/clean/.claude/skills/admin-component-usage/references/component-directory.md +270 -0
  27. package/templates/current/clean/.claude/skills/build-admin-feature/SKILL.md +20 -0
  28. package/templates/current/clean/.claude/skills/build-admin-feature/references/component-selection.md +38 -0
  29. package/templates/current/clean/{.codex → .claude}/skills/use-og-form/SKILL.md +1 -1
  30. package/templates/current/clean/{.codex → .claude}/skills/use-og-form-table/SKILL.md +4 -3
  31. package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-search/SKILL.md +3 -3
  32. package/templates/current/clean/.claude/skills/use-og-table/SKILL.md +22 -0
  33. package/templates/current/clean/{.codex → .claude}/skills/use-og-upload/SKILL.md +6 -5
  34. package/templates/current/clean/.codebuddy/rules/01-feature-architecture.md +2 -2
  35. package/templates/current/clean/.codebuddy/rules/03-component-policy.md +4 -1
  36. package/templates/current/clean/.codebuddy/skills/admin-component-usage/SKILL.md +31 -0
  37. package/templates/current/clean/.codebuddy/skills/admin-component-usage/references/component-directory.md +270 -0
  38. package/templates/current/clean/.codebuddy/skills/build-admin-feature/SKILL.md +11 -5
  39. package/templates/current/clean/.codebuddy/skills/build-admin-feature/references/component-selection.md +38 -0
  40. package/templates/current/clean/.codebuddy/skills/use-og-form/SKILL.md +1 -1
  41. package/templates/current/clean/.codebuddy/skills/use-og-form-table/SKILL.md +4 -3
  42. package/templates/current/clean/.codebuddy/skills/use-og-search/SKILL.md +3 -3
  43. package/templates/current/clean/.codebuddy/skills/use-og-table/SKILL.md +16 -10
  44. package/templates/current/clean/.codebuddy/skills/use-og-upload/SKILL.md +6 -5
  45. package/templates/current/clean/.codex/AGENTS.md +55 -8
  46. package/templates/current/clean/.codex/rules/01-feature-architecture.md +2 -2
  47. package/templates/current/clean/.codex/rules/03-component-policy.md +4 -1
  48. package/templates/current/clean/.cursor/rules/.generated +5 -0
  49. package/templates/current/clean/.cursor/rules/01-feature-architecture.mdc +2 -2
  50. package/templates/current/clean/.cursor/rules/03-component-policy.mdc +4 -1
  51. package/templates/current/clean/.cursor/skills/admin-component-usage/SKILL.md +28 -0
  52. package/templates/current/clean/.cursor/skills/admin-component-usage/references/component-directory.md +270 -0
  53. package/templates/current/clean/.cursor/skills/build-admin-feature/SKILL.md +11 -5
  54. package/templates/current/clean/.cursor/skills/build-admin-feature/references/component-selection.md +38 -0
  55. package/templates/current/clean/.cursor/skills/use-og-form/SKILL.md +1 -1
  56. package/templates/current/clean/.cursor/skills/use-og-form-table/SKILL.md +4 -3
  57. package/templates/current/clean/.cursor/skills/use-og-search/SKILL.md +3 -3
  58. package/templates/current/clean/.cursor/skills/use-og-table/SKILL.md +16 -10
  59. package/templates/current/clean/.cursor/skills/use-og-upload/SKILL.md +6 -5
  60. package/templates/current/clean/{.env.example → .env.dev} +3 -2
  61. package/templates/current/clean/.env.mock +4 -0
  62. package/templates/current/clean/.env.production +5 -0
  63. package/templates/current/clean/.env.test +4 -0
  64. package/templates/current/clean/.node-version +1 -0
  65. package/templates/current/clean/.prettierignore +17 -0
  66. package/templates/current/clean/.prettierrc +8 -0
  67. package/templates/current/clean/.qoder/rules/01-feature-architecture.md +3 -4
  68. package/templates/current/clean/.qoder/rules/02-vue-typescript.md +1 -2
  69. package/templates/current/clean/.qoder/rules/03-component-policy.md +5 -3
  70. package/templates/current/clean/.qoder/rules/04-api-auth-router.md +1 -2
  71. package/templates/current/clean/.qoder/rules/05-style.md +1 -2
  72. package/templates/current/clean/.qoder/rules/06-quality.md +1 -2
  73. package/templates/current/clean/.qoder/skills/admin-component-usage/SKILL.md +28 -0
  74. package/templates/current/clean/.qoder/skills/admin-component-usage/references/component-directory.md +270 -0
  75. package/templates/current/clean/.qoder/skills/build-admin-feature/SKILL.md +11 -5
  76. package/templates/current/clean/.qoder/skills/build-admin-feature/references/component-selection.md +38 -0
  77. package/templates/current/clean/.qoder/skills/use-og-form/SKILL.md +1 -1
  78. package/templates/current/clean/.qoder/skills/use-og-form-table/SKILL.md +4 -3
  79. package/templates/current/clean/.qoder/skills/use-og-search/SKILL.md +3 -3
  80. package/templates/current/clean/.qoder/skills/use-og-table/SKILL.md +16 -10
  81. package/templates/current/clean/.qoder/skills/use-og-upload/SKILL.md +6 -5
  82. package/templates/current/clean/.zcode/skills/admin-component-usage/SKILL.md +28 -0
  83. package/templates/current/clean/.zcode/skills/admin-component-usage/references/component-directory.md +270 -0
  84. package/templates/current/clean/.zcode/skills/build-admin-feature/SKILL.md +20 -0
  85. package/templates/current/clean/.zcode/skills/build-admin-feature/references/component-selection.md +38 -0
  86. package/templates/current/clean/.zcode/skills/style-og-origen-ui/SKILL.md +11 -0
  87. package/templates/current/clean/.zcode/skills/use-og-dialog/SKILL.md +12 -0
  88. package/templates/current/clean/.zcode/skills/use-og-editor/SKILL.md +25 -0
  89. package/templates/current/clean/.zcode/skills/use-og-form/SKILL.md +12 -0
  90. package/templates/current/clean/.zcode/skills/use-og-form-table/SKILL.md +26 -0
  91. package/templates/current/clean/.zcode/skills/use-og-http/SKILL.md +13 -0
  92. package/templates/current/clean/.zcode/skills/use-og-router-tabs/SKILL.md +11 -0
  93. package/templates/current/clean/.zcode/skills/use-og-search/SKILL.md +14 -0
  94. package/templates/current/clean/.zcode/skills/use-og-table/SKILL.md +22 -0
  95. package/templates/current/clean/.zcode/skills/use-og-upload/SKILL.md +26 -0
  96. package/templates/current/clean/AGENTS.md +55 -9
  97. package/templates/current/clean/CHANGELOG.md +129 -0
  98. package/templates/current/clean/CLAUDE.md +3 -0
  99. package/templates/current/clean/README.md +58 -87
  100. package/templates/current/clean/component-catalog.json +766 -348
  101. package/templates/current/clean/component-catalog.v2.json +2040 -0
  102. package/templates/current/clean/docs/components/dialog.md +405 -0
  103. package/templates/current/clean/docs/components/editor-viewer.md +87 -0
  104. package/templates/current/clean/docs/components/editor.md +275 -0
  105. package/templates/current/clean/docs/components/form-table.md +222 -0
  106. package/templates/current/clean/docs/components/form.md +750 -0
  107. package/templates/current/clean/docs/components/index.md +44 -0
  108. package/templates/current/clean/docs/components/router.md +452 -0
  109. package/templates/current/clean/docs/components/search.md +1205 -0
  110. package/templates/current/clean/docs/components/svg-icon.md +124 -0
  111. package/templates/current/clean/docs/components/table-local.md +176 -0
  112. package/templates/current/clean/docs/components/table-with-search.md +207 -0
  113. package/templates/current/clean/docs/components/table.md +813 -0
  114. package/templates/current/clean/docs/components/tabs.md +440 -0
  115. package/templates/current/clean/docs/components/upload.md +349 -0
  116. package/templates/current/clean/eslint.config.js +89 -0
  117. package/templates/current/clean/index.html +1 -1
  118. package/templates/current/clean/openapi.json +10048 -999
  119. package/templates/current/clean/package.json +51 -39
  120. package/templates/current/clean/playwright.config.ts +20 -6
  121. package/templates/current/clean/playwright.mock.config.ts +42 -0
  122. package/templates/current/clean/pnpm-workspace.yaml +34 -0
  123. package/templates/current/clean/recipes/remote-crud-dialog-form.vue +15 -13
  124. package/templates/current/clean/scaffold.lock.json +164 -4
  125. package/templates/current/clean/scripts/api-codegen.config.ts +35 -0
  126. package/templates/current/clean/scripts/api-codegen.ts +2015 -0
  127. package/templates/current/clean/scripts/api-templates/http-client.ejs +359 -0
  128. package/templates/current/clean/scripts/check-admin-scaffold.mjs +316 -18
  129. package/templates/current/clean/scripts/generate-api.ts +290 -85
  130. package/templates/current/clean/scripts/lib/admin-component-catalog.mjs +515 -0
  131. package/templates/current/clean/scripts/lib/repository-root.mjs +9 -0
  132. package/templates/current/clean/scripts/mock-api.ts +1356 -0
  133. package/templates/current/clean/scripts/remove-examples.mjs +10 -35
  134. package/templates/current/clean/src/App.vue +9 -18
  135. package/templates/current/clean/src/api/generated/data-contracts.ts +23 -265
  136. package/templates/current/clean/src/api/generated/http-client.ts +351 -180
  137. package/templates/current/clean/src/api/generated/index.ts +22 -0
  138. package/templates/current/clean/src/api/generated/services/auth.ts +123 -0
  139. package/templates/current/clean/src/api/generated/services/common/files.ts +111 -0
  140. package/templates/current/clean/src/api/generated/services/monitor/cache.ts +164 -0
  141. package/templates/current/clean/src/api/generated/services/monitor/job.ts +195 -0
  142. package/templates/current/clean/src/api/generated/services/monitor/jobLog.ts +126 -0
  143. package/templates/current/clean/src/api/generated/services/monitor/logininfor.ts +126 -0
  144. package/templates/current/clean/src/api/generated/services/monitor/online.ts +66 -0
  145. package/templates/current/clean/src/api/generated/services/monitor/operlog.ts +106 -0
  146. package/templates/current/clean/src/api/generated/services/monitor/server.ts +41 -0
  147. package/templates/current/clean/src/api/generated/services/system/configs.ts +190 -0
  148. package/templates/current/clean/src/api/generated/services/system/departments.ts +173 -0
  149. package/templates/current/clean/src/api/generated/services/system/dictionaries/data.ts +169 -0
  150. package/templates/current/clean/src/api/generated/services/system/dictionaries/types.ts +187 -0
  151. package/templates/current/clean/src/api/generated/services/system/index.ts +158 -0
  152. package/templates/current/clean/src/api/generated/services/system/menus.ts +193 -0
  153. package/templates/current/clean/src/api/generated/services/system/notices.ts +221 -0
  154. package/templates/current/clean/src/api/generated/services/system/posts.ts +168 -0
  155. package/templates/current/clean/src/api/generated/services/system/roles.ts +354 -0
  156. package/templates/current/clean/src/api/generated/services/system/users.ts +425 -0
  157. package/templates/current/clean/src/api/generated/services/tool/code-generator.ts +304 -0
  158. package/templates/current/clean/src/api/generated/types/auth.types.ts +132 -0
  159. package/templates/current/clean/src/api/generated/types/common/files.types.ts +57 -0
  160. package/templates/current/clean/src/api/generated/types/common.ts +174 -0
  161. package/templates/current/clean/src/api/generated/types/enum-dict.ts +94 -0
  162. package/templates/current/clean/src/api/generated/types/enums.ts +155 -0
  163. package/templates/current/clean/src/api/generated/types/monitor/cache.types.ts +149 -0
  164. package/templates/current/clean/src/api/generated/types/monitor/job.types.ts +207 -0
  165. package/templates/current/clean/src/api/generated/types/monitor/jobLog.types.ts +134 -0
  166. package/templates/current/clean/src/api/generated/types/monitor/logininfor.types.ts +135 -0
  167. package/templates/current/clean/src/api/generated/types/monitor/online.types.ts +80 -0
  168. package/templates/current/clean/src/api/generated/types/monitor/operlog.types.ts +126 -0
  169. package/templates/current/clean/src/api/generated/types/monitor/server.types.ts +205 -0
  170. package/templates/current/clean/src/api/generated/types/system/configs.types.ts +200 -0
  171. package/templates/current/clean/src/api/generated/types/system/departments.types.ts +145 -0
  172. package/templates/current/clean/src/api/generated/types/system/dictionaries/data.types.ts +210 -0
  173. package/templates/current/clean/src/api/generated/types/system/dictionaries/types.types.ts +221 -0
  174. package/templates/current/clean/src/api/generated/types/system/index.types.ts +19 -0
  175. package/templates/current/clean/src/api/generated/types/system/menus.types.ts +234 -0
  176. package/templates/current/clean/src/api/generated/types/system/notices.types.ts +270 -0
  177. package/templates/current/clean/src/api/generated/types/system/posts.types.ts +198 -0
  178. package/templates/current/clean/src/api/generated/types/system/roles.types.ts +410 -0
  179. package/templates/current/clean/src/api/generated/types/system/users.types.ts +413 -0
  180. package/templates/current/clean/src/api/generated/types/tool/code-generator.types.ts +388 -0
  181. package/templates/current/clean/src/api/index.ts +44 -39
  182. package/templates/current/clean/src/app/__tests__/api-generated.types.ts +24 -0
  183. package/templates/current/clean/src/app/api.ts +6 -0
  184. package/templates/current/clean/src/app/authorization/permission.ts +9 -0
  185. package/templates/current/{examples/src/app → clean/src/app/config}/runtimeConfig.ts +44 -12
  186. package/templates/current/clean/src/app/errors/errorMessage.ts +80 -0
  187. package/templates/current/clean/src/app/http/client.ts +141 -0
  188. package/templates/current/clean/src/app/http/http-adapter.ts +71 -0
  189. package/templates/current/{examples/src/app → clean/src/app/i18n}/adminLocale.ts +25 -19
  190. package/templates/current/clean/src/app/{localeFormat.ts → i18n/localeFormat.ts} +29 -6
  191. package/templates/current/clean/src/app/i18n/origenUiLocale.ts +15 -0
  192. package/templates/current/clean/src/app/menu/menu.ts +175 -0
  193. package/templates/current/clean/src/app/menu/menuTypes.ts +20 -0
  194. package/templates/current/clean/src/{features → app}/security/devtoolsProtection.ts +8 -7
  195. package/templates/current/clean/src/app/ui/createAdminUi.ts +31 -0
  196. package/templates/current/clean/src/app/ui/iconCatalog.ts +71 -0
  197. package/templates/current/clean/src/assets/icons/appearance.svg +1 -0
  198. package/templates/current/clean/src/assets/icons/arrow-right.svg +1 -0
  199. package/templates/current/clean/src/assets/icons/check.svg +1 -0
  200. package/templates/current/clean/src/assets/icons/circle-check.svg +1 -0
  201. package/templates/current/clean/src/assets/icons/default.svg +4 -0
  202. package/templates/current/clean/src/assets/icons/directory/setting.svg +1 -0
  203. package/templates/current/clean/src/assets/icons/expand.svg +1 -0
  204. package/templates/current/clean/src/assets/icons/fold.svg +1 -0
  205. package/templates/current/clean/src/assets/icons/key.svg +1 -0
  206. package/templates/current/clean/src/assets/icons/lock.svg +1 -0
  207. package/templates/current/clean/src/assets/icons/monitor.svg +1 -0
  208. package/templates/current/clean/src/assets/icons/moon.svg +11 -0
  209. package/templates/current/clean/src/assets/icons/page/department.svg +1 -0
  210. package/templates/current/clean/src/assets/icons/page/dictionary.svg +1 -0
  211. package/templates/current/clean/src/assets/icons/page/menus.svg +1 -0
  212. package/templates/current/clean/src/assets/icons/page/user.svg +1 -0
  213. package/templates/current/clean/src/assets/icons/page/users.svg +1 -0
  214. package/templates/current/clean/src/assets/icons/plus.svg +1 -0
  215. package/templates/current/clean/src/assets/icons/profile.svg +1 -0
  216. package/templates/current/clean/src/assets/icons/refresh.svg +1 -0
  217. package/templates/current/clean/src/assets/icons/roles.svg +1 -0
  218. package/templates/current/clean/src/assets/icons/search.svg +1 -0
  219. package/templates/current/clean/src/assets/icons/sunny.svg +1 -0
  220. package/templates/current/clean/src/assets/icons/system.svg +1 -0
  221. package/templates/current/clean/src/assets/icons/theme-auto.svg +14 -0
  222. package/templates/current/clean/src/assets/icons/tune.svg +13 -0
  223. package/templates/current/clean/src/{features/shell/components → components}/RouteProgress.vue +2 -2
  224. package/templates/current/{examples/src/features/system/access → clean/src}/composables/useAuthorizationRefresh.ts +6 -1
  225. package/templates/current/clean/src/composables/useSystemTableSearchVisibility.ts +33 -0
  226. package/templates/current/clean/src/{features/appearance/composables → composables}/useTheme.ts +1 -1
  227. package/templates/current/clean/src/env.d.ts +6 -19
  228. package/templates/current/clean/src/layouts/AdminLayout.vue +7 -9
  229. package/templates/current/clean/src/{features/shell/components → layouts}/AdminWatermark.vue +2 -2
  230. package/templates/current/clean/src/layouts/BreadcrumbBar.vue +9 -1
  231. package/templates/current/clean/src/layouts/SideMenu.vue +7 -15
  232. package/templates/current/clean/src/{features/appearance/components → layouts}/ThemePanel.vue +39 -11
  233. package/templates/current/clean/src/layouts/TopBar.vue +60 -28
  234. package/templates/current/clean/src/layouts/WorkspaceTabs.vue +10 -1
  235. package/templates/current/clean/src/layouts/topBarMenuSearch.ts +25 -4
  236. package/templates/current/clean/src/locales/en-US.json +227 -219
  237. package/templates/current/clean/src/locales/index.ts +72 -32
  238. package/templates/current/clean/src/locales/messages-types.ts +15 -10
  239. package/templates/current/clean/src/locales/vue-i18n.d.ts +1 -1
  240. package/templates/current/clean/src/locales/zh-CN.json +226 -218
  241. package/templates/current/clean/src/locales/zh-TW.json +222 -214
  242. package/templates/current/clean/src/main.ts +59 -30
  243. package/templates/current/clean/src/router/bootstrap.ts +69 -24
  244. package/templates/current/clean/src/router/dynamic/componentLoader.ts +150 -0
  245. package/templates/current/clean/src/router/{dynamicMenuRefresh.ts → dynamic/dynamicMenuRefresh.ts} +6 -2
  246. package/templates/current/clean/src/router/dynamic/dynamicRoutes.ts +247 -0
  247. package/templates/current/clean/src/router/navigation/guards.ts +12 -0
  248. package/templates/current/clean/src/router/navigation/paths.ts +28 -0
  249. package/templates/current/clean/src/router/navigation/staticRoutes.ts +109 -0
  250. package/templates/current/clean/src/router/{queryEncryption.ts → query/queryEncryption.ts} +29 -12
  251. package/templates/current/clean/src/router/query/routeQuery.ts +29 -0
  252. package/templates/current/clean/src/router/{useRouteQueryDefaults.ts → query/useRouteQueryDefaults.ts} +9 -8
  253. package/templates/current/clean/src/router/query/useRouteQueryDefaults.types.ts +28 -0
  254. package/templates/current/clean/src/router/{runtimeErrorRecovery.ts → recovery/runtimeErrorRecovery.ts} +21 -3
  255. package/templates/current/clean/src/{features/auth/store → store}/auth.ts +96 -61
  256. package/templates/current/clean/src/store/dictionaries.ts +86 -0
  257. package/templates/current/clean/src/{features/shell/store → store}/sidebar.ts +9 -2
  258. package/templates/current/{examples/src/features/appearance → clean/src}/store/theme.ts +8 -4
  259. package/templates/current/clean/src/styles/layout.css +51 -0
  260. package/templates/current/clean/src/templates/og-form.ts +7 -2
  261. package/templates/current/clean/src/templates/og-table.ts +88 -20
  262. package/templates/current/clean/src/templates/router.ts +11 -2
  263. package/templates/current/clean/src/utils/color-mix.ts +6 -2
  264. package/templates/current/clean/src/utils/download.ts +11 -0
  265. package/templates/current/clean/src/utils/permissions.ts +1 -1
  266. package/templates/current/clean/src/utils/retryableDialog.ts +46 -0
  267. package/templates/current/clean/src/{features → views}/errors/pages/Forbidden.vue +6 -2
  268. package/templates/current/clean/src/views/errors/pages/MethodNotAllowed.vue +34 -0
  269. package/templates/current/clean/src/{features → views}/errors/pages/NotFound.vue +6 -2
  270. package/templates/current/clean/src/{features → views}/errors/pages/ServerError.vue +6 -2
  271. package/templates/current/clean/src/{features/auth/pages/Login.vue → views/login/pages/index.vue} +101 -11
  272. package/templates/current/clean/src/views/system/access/services/admin-repository.ts +489 -0
  273. package/templates/current/clean/src/views/system/access/services/rbac.ts +317 -0
  274. package/templates/current/clean/src/views/system/dept/components/DepartmentEditorForm.vue +87 -0
  275. package/templates/current/clean/src/views/system/dept/composables/useDepartmentManagement.ts +314 -0
  276. package/templates/current/clean/src/views/system/dept/pages/index.vue +44 -0
  277. package/templates/current/clean/src/views/system/dept/services/departments.ts +168 -0
  278. package/templates/current/clean/src/views/system/dict/components/DictionaryDataEditorForm.vue +98 -0
  279. package/templates/current/clean/src/views/system/dict/components/DictionaryDataPreview.vue +233 -0
  280. package/templates/current/clean/src/views/system/dict/components/DictionaryTypeEditorForm.vue +66 -0
  281. package/templates/current/clean/src/views/system/dict/composables/useDictionaryDataManagement.ts +406 -0
  282. package/templates/current/clean/src/views/system/dict/composables/useDictionaryTypeManagement.ts +329 -0
  283. package/templates/current/clean/src/views/system/dict/data/pages/index.vue +134 -0
  284. package/templates/current/clean/src/views/system/dict/pages/index.vue +113 -0
  285. package/templates/current/clean/src/views/system/dict/services/dictionaries.ts +239 -0
  286. package/templates/current/clean/src/views/system/menu/components/MenuEditorForm.vue +252 -0
  287. package/templates/current/clean/src/views/system/menu/composables/useMenuManagement.ts +357 -0
  288. package/templates/current/clean/src/views/system/menu/menuDraft.ts +45 -0
  289. package/templates/current/clean/src/views/system/menu/pages/ExternalLink.vue +37 -0
  290. package/templates/current/clean/src/views/system/menu/pages/index.vue +75 -0
  291. package/templates/current/clean/src/views/system/post/components/PostEditorForm.vue +69 -0
  292. package/templates/current/clean/src/views/system/post/composables/usePostManagement.ts +245 -0
  293. package/templates/current/clean/src/views/system/post/pages/index.vue +92 -0
  294. package/templates/current/clean/src/views/system/post/services/posts.ts +100 -0
  295. package/templates/current/clean/src/views/system/role/auth-users/pages/index.vue +100 -0
  296. package/templates/current/clean/src/views/system/role/components/RoleDataScopeForm.vue +167 -0
  297. package/templates/current/clean/src/views/system/role/components/RoleEditorForm.vue +165 -0
  298. package/templates/current/clean/src/views/system/role/components/RoleUserSelectForm.vue +129 -0
  299. package/templates/current/clean/src/views/system/role/composables/useRoleManagement.ts +422 -0
  300. package/templates/current/clean/src/views/system/role/composables/useRoleUserManagement.ts +233 -0
  301. package/templates/current/clean/src/views/system/role/pages/index.vue +110 -0
  302. package/templates/current/clean/src/views/system/role/services/roleAccess.ts +162 -0
  303. package/templates/current/clean/src/views/system/user/auth-roles/pages/index.vue +209 -0
  304. package/templates/current/clean/src/views/system/user/components/UserDetailsForm.vue +108 -0
  305. package/templates/current/clean/src/views/system/user/components/UserEditorForm.vue +207 -0
  306. package/templates/current/clean/src/views/system/user/components/UserImportDialog.vue +80 -0
  307. package/templates/current/clean/src/views/system/user/components/UserResetPasswordForm.vue +56 -0
  308. package/templates/current/clean/src/views/system/user/composables/useUserManagement.ts +502 -0
  309. package/templates/current/clean/src/views/system/user/pages/index.vue +459 -0
  310. package/templates/current/clean/tests/e2e/admin-access-business.spec.ts +33 -0
  311. package/templates/current/clean/tests/e2e/admin-shell.spec.ts +50 -0
  312. package/templates/current/clean/tests/e2e/fixtures/adminMockBackend.ts +95 -0
  313. package/templates/current/clean/tests/e2e/fixtures/labelGeometry.ts +52 -0
  314. package/templates/current/clean/tests/e2e/mock-api-generation.spec.ts +27 -0
  315. package/templates/current/clean/tests/e2e/mock-business.spec.ts +555 -0
  316. package/templates/current/clean/tests/e2e/mock-menu-retry-form-label.spec.ts +100 -0
  317. package/templates/current/clean/tests/e2e/mock-shell.spec.ts +25 -0
  318. package/templates/current/clean/tests/e2e/mock-tree-selection-layout.spec.ts +113 -0
  319. package/templates/current/clean/tests/unit/api/api-codegen.spec.ts +893 -0
  320. package/templates/current/clean/tests/unit/api/client.spec.ts +145 -0
  321. package/templates/current/clean/tests/unit/api/generated-http-client.spec.ts +290 -0
  322. package/templates/current/{examples/src → clean/tests/unit}/api/http-adapter.spec.ts +3 -3
  323. package/templates/current/clean/tests/unit/api/system-apis.spec.ts +118 -0
  324. package/templates/current/clean/tests/unit/app/createAdminUi.spec.ts +79 -0
  325. package/templates/current/clean/{src → tests/unit}/app/errorMessage.spec.ts +1 -1
  326. package/templates/current/clean/tests/unit/app/iconCatalog.spec.ts +12 -0
  327. package/templates/current/clean/tests/unit/app/menu.spec.ts +215 -0
  328. package/templates/current/{examples/src → clean/tests/unit}/app/origenUiLocale.spec.ts +1 -1
  329. package/templates/current/{examples/src → clean/tests/unit}/app/permission.spec.ts +4 -5
  330. package/templates/current/clean/tests/unit/app/runtimeConfig.spec.ts +36 -0
  331. package/templates/current/{examples/src/features → clean/tests/unit/app}/security/devtoolsProtection.spec.ts +17 -7
  332. package/templates/current/{examples/src/features/shell → clean/tests/unit}/composables/useRouteProgress.spec.ts +1 -1
  333. package/templates/current/{examples/src/features/shell/components → clean/tests/unit/layouts}/AdminWatermark.spec.ts +5 -7
  334. package/templates/current/{examples/src → clean/tests/unit}/layouts/topBarMenuSearch.spec.ts +25 -8
  335. package/templates/current/clean/{src → tests/unit}/locales/messages.spec.ts +43 -17
  336. package/templates/current/clean/tests/unit/router/dynamicMenuRefresh.spec.ts +151 -0
  337. package/templates/current/clean/tests/unit/router/dynamicRoutes.spec.ts +374 -0
  338. package/templates/current/clean/tests/unit/router/paths.spec.ts +103 -0
  339. package/templates/current/clean/{src → tests/unit}/router/queryEncryption.spec.ts +56 -10
  340. package/templates/current/clean/tests/unit/router/routeQuery.spec.ts +19 -0
  341. package/templates/current/clean/{src → tests/unit}/router/runtimeErrorRecovery.spec.ts +11 -6
  342. package/templates/current/{examples/src → clean/tests/unit}/router/useRouteQueryDefaults.spec.ts +46 -12
  343. package/templates/current/clean/tests/unit/scripts/mock-api.spec.ts +440 -0
  344. package/templates/current/clean/{scripts → tests/unit/scripts}/vite-build-policy.spec.ts +35 -6
  345. package/templates/current/clean/{src/features/auth → tests/unit}/store/auth.spec.ts +68 -15
  346. package/templates/current/clean/tests/unit/store/dictionaries.spec.ts +106 -0
  347. package/templates/current/{examples/src → clean/tests/unit}/templates/templates.spec.ts +60 -16
  348. package/templates/current/clean/{src/utils/__tests__ → tests/unit/utils}/color-mix.spec.ts +1 -1
  349. package/templates/current/clean/tests/unit/utils/retryableDialog.spec.ts +61 -0
  350. package/templates/current/{examples/src/features/errors/pages → clean/tests/unit/views/errors}/error-pages.spec.ts +11 -7
  351. package/templates/current/clean/tests/unit/views/feature-composables.spec.ts +233 -0
  352. package/templates/current/clean/tests/unit/views/system/access/admin-repository.spec.ts +353 -0
  353. package/templates/current/clean/tests/unit/views/system/access/rbac.spec.ts +329 -0
  354. package/templates/current/clean/tests/unit/views/system/dept/departments.spec.ts +104 -0
  355. package/templates/current/clean/tests/unit/views/system/dict/dictionaries.spec.ts +234 -0
  356. package/templates/current/clean/tests/unit/views/system/menu/menuDraft.spec.ts +77 -0
  357. package/templates/current/clean/tests/unit/views/system/menu/useMenuManagement.spec.ts +339 -0
  358. package/templates/current/clean/tests/unit/views/system/user/searchControl.spec.ts +128 -0
  359. package/templates/current/clean/tsconfig.json +4 -19
  360. package/templates/current/clean/vite.build-policy.ts +97 -22
  361. package/templates/current/clean/vite.config.ts +50 -7
  362. package/templates/current/examples/.agents/skills/admin-component-usage/SKILL.md +28 -0
  363. package/templates/current/examples/.agents/skills/admin-component-usage/references/component-directory.md +270 -0
  364. package/templates/current/examples/.agents/skills/build-admin-feature/SKILL.md +20 -0
  365. package/templates/current/examples/.agents/skills/build-admin-feature/references/component-selection.md +38 -0
  366. package/templates/current/examples/.agents/skills/style-og-origen-ui/SKILL.md +11 -0
  367. package/templates/current/examples/.agents/skills/use-og-dialog/SKILL.md +12 -0
  368. package/templates/current/examples/.agents/skills/use-og-editor/SKILL.md +25 -0
  369. package/templates/current/examples/.agents/skills/use-og-form/SKILL.md +12 -0
  370. package/templates/current/examples/.agents/skills/use-og-form-table/SKILL.md +26 -0
  371. package/templates/current/examples/.agents/skills/use-og-http/SKILL.md +13 -0
  372. package/templates/current/examples/.agents/skills/use-og-router-tabs/SKILL.md +11 -0
  373. package/templates/current/examples/.agents/skills/use-og-search/SKILL.md +14 -0
  374. package/templates/current/examples/.agents/skills/use-og-table/SKILL.md +22 -0
  375. package/templates/current/examples/.agents/skills/use-og-upload/SKILL.md +26 -0
  376. package/templates/current/examples/.api-client-e2e.config.ts +13 -0
  377. package/templates/current/examples/.claude/rules/01-feature-architecture.md +10 -0
  378. package/templates/current/examples/.claude/rules/02-vue-typescript.md +10 -0
  379. package/templates/current/examples/.claude/rules/03-component-policy.md +31 -0
  380. package/templates/current/examples/.claude/rules/04-api-auth-router.md +10 -0
  381. package/templates/current/examples/.claude/rules/05-style.md +10 -0
  382. package/templates/current/examples/.claude/rules/06-quality.md +10 -0
  383. package/templates/current/examples/.claude/skills/admin-component-usage/SKILL.md +28 -0
  384. package/templates/current/examples/.claude/skills/admin-component-usage/references/component-directory.md +270 -0
  385. package/templates/current/examples/.claude/skills/build-admin-feature/SKILL.md +20 -0
  386. package/templates/current/examples/.claude/skills/build-admin-feature/references/component-selection.md +38 -0
  387. package/templates/current/examples/.claude/skills/style-og-origen-ui/SKILL.md +11 -0
  388. package/templates/current/examples/.claude/skills/use-og-dialog/SKILL.md +12 -0
  389. package/templates/current/examples/.claude/skills/use-og-editor/SKILL.md +25 -0
  390. package/templates/current/examples/.claude/skills/use-og-form/SKILL.md +12 -0
  391. package/templates/current/examples/.claude/skills/use-og-form-table/SKILL.md +26 -0
  392. package/templates/current/examples/.claude/skills/use-og-http/SKILL.md +13 -0
  393. package/templates/current/examples/.claude/skills/use-og-router-tabs/SKILL.md +11 -0
  394. package/templates/current/examples/.claude/skills/use-og-search/SKILL.md +14 -0
  395. package/templates/current/examples/.claude/skills/use-og-table/SKILL.md +22 -0
  396. package/templates/current/examples/.claude/skills/use-og-upload/SKILL.md +26 -0
  397. package/templates/current/examples/.codebuddy/rules/01-feature-architecture.md +2 -2
  398. package/templates/current/examples/.codebuddy/rules/03-component-policy.md +4 -1
  399. package/templates/current/examples/.codebuddy/skills/admin-component-usage/SKILL.md +31 -0
  400. package/templates/current/examples/.codebuddy/skills/admin-component-usage/references/component-directory.md +270 -0
  401. package/templates/current/examples/.codebuddy/skills/build-admin-feature/SKILL.md +11 -5
  402. package/templates/current/examples/.codebuddy/skills/build-admin-feature/references/component-selection.md +38 -0
  403. package/templates/current/examples/.codebuddy/skills/use-og-form/SKILL.md +1 -1
  404. package/templates/current/examples/.codebuddy/skills/use-og-form-table/SKILL.md +4 -3
  405. package/templates/current/examples/.codebuddy/skills/use-og-search/SKILL.md +3 -3
  406. package/templates/current/examples/.codebuddy/skills/use-og-table/SKILL.md +16 -10
  407. package/templates/current/examples/.codebuddy/skills/use-og-upload/SKILL.md +6 -5
  408. package/templates/current/examples/.codex/AGENTS.md +55 -8
  409. package/templates/current/examples/.codex/rules/01-feature-architecture.md +2 -2
  410. package/templates/current/examples/.codex/rules/03-component-policy.md +4 -1
  411. package/templates/current/examples/.cursor/rules/.generated +5 -0
  412. package/templates/current/examples/.cursor/rules/01-feature-architecture.mdc +2 -2
  413. package/templates/current/examples/.cursor/rules/03-component-policy.mdc +4 -1
  414. package/templates/current/examples/.cursor/skills/admin-component-usage/SKILL.md +28 -0
  415. package/templates/current/examples/.cursor/skills/admin-component-usage/references/component-directory.md +270 -0
  416. package/templates/current/examples/.cursor/skills/build-admin-feature/SKILL.md +11 -5
  417. package/templates/current/examples/.cursor/skills/build-admin-feature/references/component-selection.md +38 -0
  418. package/templates/current/examples/.cursor/skills/use-og-form/SKILL.md +1 -1
  419. package/templates/current/examples/.cursor/skills/use-og-form-table/SKILL.md +4 -3
  420. package/templates/current/examples/.cursor/skills/use-og-search/SKILL.md +3 -3
  421. package/templates/current/examples/.cursor/skills/use-og-table/SKILL.md +16 -10
  422. package/templates/current/examples/.cursor/skills/use-og-upload/SKILL.md +6 -5
  423. package/templates/current/examples/{.env.example → .env.dev} +3 -2
  424. package/templates/current/examples/.env.mock +4 -0
  425. package/templates/current/examples/.env.production +5 -0
  426. package/templates/current/examples/.env.test +4 -0
  427. package/templates/current/examples/.node-version +1 -0
  428. package/templates/current/examples/.prettierignore +17 -0
  429. package/templates/current/examples/.prettierrc +8 -0
  430. package/templates/current/examples/.qoder/rules/01-feature-architecture.md +3 -4
  431. package/templates/current/examples/.qoder/rules/02-vue-typescript.md +1 -2
  432. package/templates/current/examples/.qoder/rules/03-component-policy.md +5 -3
  433. package/templates/current/examples/.qoder/rules/04-api-auth-router.md +1 -2
  434. package/templates/current/examples/.qoder/rules/05-style.md +1 -2
  435. package/templates/current/examples/.qoder/rules/06-quality.md +1 -2
  436. package/templates/current/examples/.qoder/skills/admin-component-usage/SKILL.md +28 -0
  437. package/templates/current/examples/.qoder/skills/admin-component-usage/references/component-directory.md +270 -0
  438. package/templates/current/examples/.qoder/skills/build-admin-feature/SKILL.md +11 -5
  439. package/templates/current/examples/.qoder/skills/build-admin-feature/references/component-selection.md +38 -0
  440. package/templates/current/examples/.qoder/skills/use-og-form/SKILL.md +1 -1
  441. package/templates/current/examples/.qoder/skills/use-og-form-table/SKILL.md +4 -3
  442. package/templates/current/examples/.qoder/skills/use-og-search/SKILL.md +3 -3
  443. package/templates/current/examples/.qoder/skills/use-og-table/SKILL.md +16 -10
  444. package/templates/current/examples/.qoder/skills/use-og-upload/SKILL.md +6 -5
  445. package/templates/current/examples/.zcode/skills/admin-component-usage/SKILL.md +28 -0
  446. package/templates/current/examples/.zcode/skills/admin-component-usage/references/component-directory.md +270 -0
  447. package/templates/current/examples/.zcode/skills/build-admin-feature/SKILL.md +20 -0
  448. package/templates/current/examples/.zcode/skills/build-admin-feature/references/component-selection.md +38 -0
  449. package/templates/current/examples/.zcode/skills/style-og-origen-ui/SKILL.md +11 -0
  450. package/templates/current/examples/.zcode/skills/use-og-dialog/SKILL.md +12 -0
  451. package/templates/current/examples/.zcode/skills/use-og-editor/SKILL.md +25 -0
  452. package/templates/current/examples/.zcode/skills/use-og-form/SKILL.md +12 -0
  453. package/templates/current/examples/.zcode/skills/use-og-form-table/SKILL.md +26 -0
  454. package/templates/current/examples/.zcode/skills/use-og-http/SKILL.md +13 -0
  455. package/templates/current/examples/.zcode/skills/use-og-router-tabs/SKILL.md +11 -0
  456. package/templates/current/examples/.zcode/skills/use-og-search/SKILL.md +14 -0
  457. package/templates/current/examples/.zcode/skills/use-og-table/SKILL.md +22 -0
  458. package/templates/current/examples/.zcode/skills/use-og-upload/SKILL.md +26 -0
  459. package/templates/current/examples/AGENTS.md +55 -9
  460. package/templates/current/examples/CHANGELOG.md +129 -0
  461. package/templates/current/examples/CLAUDE.md +3 -0
  462. package/templates/current/examples/README.md +58 -87
  463. package/templates/current/examples/component-catalog.json +766 -348
  464. package/templates/current/examples/component-catalog.v2.json +2040 -0
  465. package/templates/current/examples/docs/components/dialog.md +405 -0
  466. package/templates/current/examples/docs/components/editor-viewer.md +87 -0
  467. package/templates/current/examples/docs/components/editor.md +275 -0
  468. package/templates/current/examples/docs/components/form-table.md +222 -0
  469. package/templates/current/examples/docs/components/form.md +750 -0
  470. package/templates/current/examples/docs/components/index.md +44 -0
  471. package/templates/current/examples/docs/components/router.md +452 -0
  472. package/templates/current/examples/docs/components/search.md +1205 -0
  473. package/templates/current/examples/docs/components/svg-icon.md +124 -0
  474. package/templates/current/examples/docs/components/table-local.md +176 -0
  475. package/templates/current/examples/docs/components/table-with-search.md +207 -0
  476. package/templates/current/examples/docs/components/table.md +813 -0
  477. package/templates/current/examples/docs/components/tabs.md +440 -0
  478. package/templates/current/examples/docs/components/upload.md +349 -0
  479. package/templates/current/examples/eslint.config.js +89 -0
  480. package/templates/current/examples/index.html +1 -1
  481. package/templates/current/examples/openapi.json +10048 -999
  482. package/templates/current/examples/package.json +51 -39
  483. package/templates/current/examples/playwright.config.ts +20 -6
  484. package/templates/current/examples/playwright.mock.config.ts +42 -0
  485. package/templates/current/examples/pnpm-workspace.yaml +34 -0
  486. package/templates/current/examples/recipes/remote-crud-dialog-form.vue +15 -13
  487. package/templates/current/examples/scaffold.lock.json +164 -4
  488. package/templates/current/examples/scripts/api-codegen.config.ts +35 -0
  489. package/templates/current/examples/scripts/api-codegen.ts +2015 -0
  490. package/templates/current/examples/scripts/api-templates/http-client.ejs +359 -0
  491. package/templates/current/examples/scripts/check-admin-scaffold.mjs +316 -18
  492. package/templates/current/examples/scripts/generate-api.ts +290 -85
  493. package/templates/current/examples/scripts/lib/admin-component-catalog.mjs +515 -0
  494. package/templates/current/examples/scripts/lib/repository-root.mjs +9 -0
  495. package/templates/current/examples/scripts/mock-api.ts +1356 -0
  496. package/templates/current/examples/scripts/remove-examples.mjs +10 -35
  497. package/templates/current/examples/src/App.vue +9 -18
  498. package/templates/current/examples/src/api/generated/data-contracts.ts +23 -265
  499. package/templates/current/examples/src/api/generated/http-client.ts +351 -180
  500. package/templates/current/examples/src/api/generated/index.ts +22 -0
  501. package/templates/current/examples/src/api/generated/services/auth.ts +123 -0
  502. package/templates/current/examples/src/api/generated/services/common/files.ts +111 -0
  503. package/templates/current/examples/src/api/generated/services/monitor/cache.ts +164 -0
  504. package/templates/current/examples/src/api/generated/services/monitor/job.ts +195 -0
  505. package/templates/current/examples/src/api/generated/services/monitor/jobLog.ts +126 -0
  506. package/templates/current/examples/src/api/generated/services/monitor/logininfor.ts +126 -0
  507. package/templates/current/examples/src/api/generated/services/monitor/online.ts +66 -0
  508. package/templates/current/examples/src/api/generated/services/monitor/operlog.ts +106 -0
  509. package/templates/current/examples/src/api/generated/services/monitor/server.ts +41 -0
  510. package/templates/current/examples/src/api/generated/services/system/configs.ts +190 -0
  511. package/templates/current/examples/src/api/generated/services/system/departments.ts +173 -0
  512. package/templates/current/examples/src/api/generated/services/system/dictionaries/data.ts +169 -0
  513. package/templates/current/examples/src/api/generated/services/system/dictionaries/types.ts +187 -0
  514. package/templates/current/examples/src/api/generated/services/system/index.ts +158 -0
  515. package/templates/current/examples/src/api/generated/services/system/menus.ts +193 -0
  516. package/templates/current/examples/src/api/generated/services/system/notices.ts +221 -0
  517. package/templates/current/examples/src/api/generated/services/system/posts.ts +168 -0
  518. package/templates/current/examples/src/api/generated/services/system/roles.ts +354 -0
  519. package/templates/current/examples/src/api/generated/services/system/users.ts +425 -0
  520. package/templates/current/examples/src/api/generated/services/tool/code-generator.ts +304 -0
  521. package/templates/current/examples/src/api/generated/types/auth.types.ts +132 -0
  522. package/templates/current/examples/src/api/generated/types/common/files.types.ts +57 -0
  523. package/templates/current/examples/src/api/generated/types/common.ts +174 -0
  524. package/templates/current/examples/src/api/generated/types/enum-dict.ts +94 -0
  525. package/templates/current/examples/src/api/generated/types/enums.ts +155 -0
  526. package/templates/current/examples/src/api/generated/types/monitor/cache.types.ts +149 -0
  527. package/templates/current/examples/src/api/generated/types/monitor/job.types.ts +207 -0
  528. package/templates/current/examples/src/api/generated/types/monitor/jobLog.types.ts +134 -0
  529. package/templates/current/examples/src/api/generated/types/monitor/logininfor.types.ts +135 -0
  530. package/templates/current/examples/src/api/generated/types/monitor/online.types.ts +80 -0
  531. package/templates/current/examples/src/api/generated/types/monitor/operlog.types.ts +126 -0
  532. package/templates/current/examples/src/api/generated/types/monitor/server.types.ts +205 -0
  533. package/templates/current/examples/src/api/generated/types/system/configs.types.ts +200 -0
  534. package/templates/current/examples/src/api/generated/types/system/departments.types.ts +145 -0
  535. package/templates/current/examples/src/api/generated/types/system/dictionaries/data.types.ts +210 -0
  536. package/templates/current/examples/src/api/generated/types/system/dictionaries/types.types.ts +221 -0
  537. package/templates/current/examples/src/api/generated/types/system/index.types.ts +19 -0
  538. package/templates/current/examples/src/api/generated/types/system/menus.types.ts +234 -0
  539. package/templates/current/examples/src/api/generated/types/system/notices.types.ts +270 -0
  540. package/templates/current/examples/src/api/generated/types/system/posts.types.ts +198 -0
  541. package/templates/current/examples/src/api/generated/types/system/roles.types.ts +410 -0
  542. package/templates/current/examples/src/api/generated/types/system/users.types.ts +413 -0
  543. package/templates/current/examples/src/api/generated/types/tool/code-generator.types.ts +388 -0
  544. package/templates/current/examples/src/api/index.ts +44 -39
  545. package/templates/current/examples/src/app/__tests__/api-generated.types.ts +24 -0
  546. package/templates/current/examples/src/app/api.ts +6 -0
  547. package/templates/current/examples/src/app/authorization/permission.ts +9 -0
  548. package/templates/current/{clean/src/app → examples/src/app/config}/runtimeConfig.ts +44 -12
  549. package/templates/current/examples/src/app/errors/errorMessage.ts +80 -0
  550. package/templates/current/examples/src/app/http/client.ts +141 -0
  551. package/templates/current/examples/src/app/http/http-adapter.ts +71 -0
  552. package/templates/current/{clean/src/app → examples/src/app/i18n}/adminLocale.ts +25 -19
  553. package/templates/current/examples/src/app/{localeFormat.ts → i18n/localeFormat.ts} +29 -6
  554. package/templates/current/examples/src/app/i18n/origenUiLocale.ts +15 -0
  555. package/templates/current/examples/src/app/menu/menu.ts +175 -0
  556. package/templates/current/examples/src/app/menu/menuTypes.ts +20 -0
  557. package/templates/current/examples/src/{features → app}/security/devtoolsProtection.ts +8 -7
  558. package/templates/current/examples/src/app/ui/createAdminUi.ts +31 -0
  559. package/templates/current/examples/src/app/ui/iconCatalog.ts +71 -0
  560. package/templates/current/examples/src/assets/icons/appearance.svg +1 -0
  561. package/templates/current/examples/src/assets/icons/arrow-right.svg +1 -0
  562. package/templates/current/examples/src/assets/icons/check.svg +1 -0
  563. package/templates/current/examples/src/assets/icons/circle-check.svg +1 -0
  564. package/templates/current/examples/src/assets/icons/default.svg +4 -0
  565. package/templates/current/examples/src/assets/icons/directory/setting.svg +1 -0
  566. package/templates/current/examples/src/assets/icons/expand.svg +1 -0
  567. package/templates/current/examples/src/assets/icons/fold.svg +1 -0
  568. package/templates/current/examples/src/assets/icons/key.svg +1 -0
  569. package/templates/current/examples/src/assets/icons/lock.svg +1 -0
  570. package/templates/current/examples/src/assets/icons/monitor.svg +1 -0
  571. package/templates/current/examples/src/assets/icons/moon.svg +11 -0
  572. package/templates/current/examples/src/assets/icons/page/department.svg +1 -0
  573. package/templates/current/examples/src/assets/icons/page/dictionary.svg +1 -0
  574. package/templates/current/examples/src/assets/icons/page/menus.svg +1 -0
  575. package/templates/current/examples/src/assets/icons/page/user.svg +1 -0
  576. package/templates/current/examples/src/assets/icons/page/users.svg +1 -0
  577. package/templates/current/examples/src/assets/icons/plus.svg +1 -0
  578. package/templates/current/examples/src/assets/icons/profile.svg +1 -0
  579. package/templates/current/examples/src/assets/icons/refresh.svg +1 -0
  580. package/templates/current/examples/src/assets/icons/roles.svg +1 -0
  581. package/templates/current/examples/src/assets/icons/search.svg +1 -0
  582. package/templates/current/examples/src/assets/icons/sunny.svg +1 -0
  583. package/templates/current/examples/src/assets/icons/system.svg +1 -0
  584. package/templates/current/examples/src/assets/icons/theme-auto.svg +14 -0
  585. package/templates/current/examples/src/assets/icons/tune.svg +13 -0
  586. package/templates/current/examples/src/{features/shell/components → components}/RouteProgress.vue +2 -2
  587. package/templates/current/{clean/src/features/system/access → examples/src}/composables/useAuthorizationRefresh.ts +6 -1
  588. package/templates/current/examples/src/composables/useSystemTableSearchVisibility.ts +33 -0
  589. package/templates/current/examples/src/{features/appearance/composables → composables}/useTheme.ts +1 -1
  590. package/templates/current/examples/src/env.d.ts +6 -19
  591. package/templates/current/examples/src/layouts/AdminLayout.vue +7 -9
  592. package/templates/current/examples/src/{features/shell/components → layouts}/AdminWatermark.vue +2 -2
  593. package/templates/current/examples/src/layouts/BreadcrumbBar.vue +9 -1
  594. package/templates/current/examples/src/layouts/SideMenu.vue +7 -15
  595. package/templates/current/examples/src/{features/appearance/components → layouts}/ThemePanel.vue +39 -11
  596. package/templates/current/examples/src/layouts/TopBar.vue +60 -28
  597. package/templates/current/examples/src/layouts/WorkspaceTabs.vue +10 -1
  598. package/templates/current/examples/src/layouts/topBarMenuSearch.ts +25 -4
  599. package/templates/current/examples/src/locales/en-US.json +227 -219
  600. package/templates/current/examples/src/locales/index.ts +72 -32
  601. package/templates/current/examples/src/locales/messages-types.ts +15 -10
  602. package/templates/current/examples/src/locales/vue-i18n.d.ts +1 -1
  603. package/templates/current/examples/src/locales/zh-CN.json +226 -218
  604. package/templates/current/examples/src/locales/zh-TW.json +222 -214
  605. package/templates/current/examples/src/main.ts +50 -40
  606. package/templates/current/examples/src/router/bootstrap.ts +69 -24
  607. package/templates/current/examples/src/router/dynamic/componentLoader.ts +150 -0
  608. package/templates/current/examples/src/router/{dynamicMenuRefresh.ts → dynamic/dynamicMenuRefresh.ts} +6 -2
  609. package/templates/current/examples/src/router/dynamic/dynamicRoutes.ts +247 -0
  610. package/templates/current/examples/src/router/navigation/guards.ts +12 -0
  611. package/templates/current/examples/src/router/navigation/paths.ts +28 -0
  612. package/templates/current/examples/src/router/navigation/staticRoutes.ts +109 -0
  613. package/templates/current/examples/src/router/{queryEncryption.ts → query/queryEncryption.ts} +29 -12
  614. package/templates/current/examples/src/router/query/routeQuery.ts +29 -0
  615. package/templates/current/examples/src/router/{useRouteQueryDefaults.ts → query/useRouteQueryDefaults.ts} +9 -8
  616. package/templates/current/examples/src/router/query/useRouteQueryDefaults.types.ts +28 -0
  617. package/templates/current/examples/src/router/{runtimeErrorRecovery.ts → recovery/runtimeErrorRecovery.ts} +21 -3
  618. package/templates/current/examples/src/{features/auth/store → store}/auth.ts +96 -61
  619. package/templates/current/examples/src/store/dictionaries.ts +86 -0
  620. package/templates/current/examples/src/{features/shell/store → store}/sidebar.ts +9 -2
  621. package/templates/current/{clean/src/features/appearance → examples/src}/store/theme.ts +8 -4
  622. package/templates/current/examples/src/styles/layout.css +51 -0
  623. package/templates/current/examples/src/templates/og-form.ts +7 -2
  624. package/templates/current/examples/src/templates/og-table.ts +88 -20
  625. package/templates/current/examples/src/templates/router.ts +11 -2
  626. package/templates/current/examples/src/utils/color-mix.ts +6 -2
  627. package/templates/current/examples/src/utils/download.ts +11 -0
  628. package/templates/current/examples/src/utils/permissions.ts +1 -1
  629. package/templates/current/examples/src/utils/retryableDialog.ts +46 -0
  630. package/templates/current/{clean/scripts/clean-overlay/src/features → examples/src/views}/errors/pages/Forbidden.vue +6 -2
  631. package/templates/current/examples/src/views/errors/pages/MethodNotAllowed.vue +34 -0
  632. package/templates/current/examples/{scripts/clean-overlay/src/features → src/views}/errors/pages/NotFound.vue +6 -2
  633. package/templates/current/examples/{scripts/clean-overlay/src/features → src/views}/errors/pages/ServerError.vue +6 -2
  634. package/templates/current/examples/src/{features/auth/pages/Login.vue → views/login/pages/index.vue} +101 -11
  635. package/templates/current/examples/src/views/system/access/services/admin-repository.ts +489 -0
  636. package/templates/current/examples/src/views/system/access/services/rbac.ts +317 -0
  637. package/templates/current/examples/src/views/system/dept/components/DepartmentEditorForm.vue +87 -0
  638. package/templates/current/examples/src/views/system/dept/composables/useDepartmentManagement.ts +314 -0
  639. package/templates/current/examples/src/views/system/dept/pages/index.vue +44 -0
  640. package/templates/current/examples/src/views/system/dept/services/departments.ts +168 -0
  641. package/templates/current/examples/src/views/system/dict/components/DictionaryDataEditorForm.vue +98 -0
  642. package/templates/current/examples/src/views/system/dict/components/DictionaryDataPreview.vue +233 -0
  643. package/templates/current/examples/src/views/system/dict/components/DictionaryTypeEditorForm.vue +66 -0
  644. package/templates/current/examples/src/views/system/dict/composables/useDictionaryDataManagement.ts +406 -0
  645. package/templates/current/examples/src/views/system/dict/composables/useDictionaryTypeManagement.ts +329 -0
  646. package/templates/current/examples/src/views/system/dict/data/pages/index.vue +134 -0
  647. package/templates/current/examples/src/views/system/dict/pages/index.vue +113 -0
  648. package/templates/current/examples/src/views/system/dict/services/dictionaries.ts +239 -0
  649. package/templates/current/examples/src/views/system/menu/components/MenuEditorForm.vue +252 -0
  650. package/templates/current/examples/src/views/system/menu/composables/useMenuManagement.ts +357 -0
  651. package/templates/current/examples/src/views/system/menu/menuDraft.ts +45 -0
  652. package/templates/current/examples/src/views/system/menu/pages/ExternalLink.vue +37 -0
  653. package/templates/current/examples/src/views/system/menu/pages/index.vue +75 -0
  654. package/templates/current/examples/src/views/system/post/components/PostEditorForm.vue +69 -0
  655. package/templates/current/examples/src/views/system/post/composables/usePostManagement.ts +245 -0
  656. package/templates/current/examples/src/views/system/post/pages/index.vue +92 -0
  657. package/templates/current/examples/src/views/system/post/services/posts.ts +100 -0
  658. package/templates/current/examples/src/views/system/role/auth-users/pages/index.vue +100 -0
  659. package/templates/current/examples/src/views/system/role/components/RoleDataScopeForm.vue +167 -0
  660. package/templates/current/examples/src/views/system/role/components/RoleEditorForm.vue +165 -0
  661. package/templates/current/examples/src/views/system/role/components/RoleUserSelectForm.vue +129 -0
  662. package/templates/current/examples/src/views/system/role/composables/useRoleManagement.ts +422 -0
  663. package/templates/current/examples/src/views/system/role/composables/useRoleUserManagement.ts +233 -0
  664. package/templates/current/examples/src/views/system/role/pages/index.vue +110 -0
  665. package/templates/current/examples/src/views/system/role/services/roleAccess.ts +162 -0
  666. package/templates/current/examples/src/views/system/user/auth-roles/pages/index.vue +209 -0
  667. package/templates/current/examples/src/views/system/user/components/UserDetailsForm.vue +108 -0
  668. package/templates/current/examples/src/views/system/user/components/UserEditorForm.vue +207 -0
  669. package/templates/current/examples/src/views/system/user/components/UserImportDialog.vue +80 -0
  670. package/templates/current/examples/src/views/system/user/components/UserResetPasswordForm.vue +56 -0
  671. package/templates/current/examples/src/views/system/user/composables/useUserManagement.ts +502 -0
  672. package/templates/current/examples/src/views/system/user/pages/index.vue +459 -0
  673. package/templates/current/examples/tests/e2e/admin-access-business.spec.ts +33 -0
  674. package/templates/current/examples/tests/e2e/admin-shell.spec.ts +50 -0
  675. package/templates/current/examples/tests/e2e/fixtures/adminMockBackend.ts +95 -0
  676. package/templates/current/examples/tests/e2e/fixtures/labelGeometry.ts +52 -0
  677. package/templates/current/examples/tests/e2e/mock-api-generation.spec.ts +27 -0
  678. package/templates/current/examples/tests/e2e/mock-business.spec.ts +555 -0
  679. package/templates/current/examples/tests/e2e/mock-menu-retry-form-label.spec.ts +100 -0
  680. package/templates/current/examples/tests/e2e/mock-shell.spec.ts +25 -0
  681. package/templates/current/examples/tests/e2e/mock-tree-selection-layout.spec.ts +113 -0
  682. package/templates/current/examples/tests/unit/api/api-codegen.spec.ts +893 -0
  683. package/templates/current/examples/tests/unit/api/client.spec.ts +145 -0
  684. package/templates/current/examples/tests/unit/api/generated-http-client.spec.ts +290 -0
  685. package/templates/current/{clean/src → examples/tests/unit}/api/http-adapter.spec.ts +3 -3
  686. package/templates/current/examples/tests/unit/api/system-apis.spec.ts +118 -0
  687. package/templates/current/examples/tests/unit/app/createAdminUi.spec.ts +79 -0
  688. package/templates/current/examples/{src → tests/unit}/app/errorMessage.spec.ts +1 -1
  689. package/templates/current/examples/tests/unit/app/iconCatalog.spec.ts +12 -0
  690. package/templates/current/examples/tests/unit/app/menu.spec.ts +215 -0
  691. package/templates/current/{clean/src → examples/tests/unit}/app/origenUiLocale.spec.ts +1 -1
  692. package/templates/current/{clean/src → examples/tests/unit}/app/permission.spec.ts +4 -5
  693. package/templates/current/examples/tests/unit/app/runtimeConfig.spec.ts +36 -0
  694. package/templates/current/{clean/src/features → examples/tests/unit/app}/security/devtoolsProtection.spec.ts +17 -7
  695. package/templates/current/{clean/src/features/shell → examples/tests/unit}/composables/useRouteProgress.spec.ts +1 -1
  696. package/templates/current/{clean/src/features/shell/components → examples/tests/unit/layouts}/AdminWatermark.spec.ts +5 -7
  697. package/templates/current/{clean/src → examples/tests/unit}/layouts/topBarMenuSearch.spec.ts +25 -8
  698. package/templates/current/examples/{src → tests/unit}/locales/messages.spec.ts +43 -17
  699. package/templates/current/examples/tests/unit/router/dynamicMenuRefresh.spec.ts +151 -0
  700. package/templates/current/examples/tests/unit/router/dynamicRoutes.spec.ts +374 -0
  701. package/templates/current/examples/tests/unit/router/paths.spec.ts +103 -0
  702. package/templates/current/examples/{src → tests/unit}/router/queryEncryption.spec.ts +56 -10
  703. package/templates/current/examples/tests/unit/router/routeQuery.spec.ts +19 -0
  704. package/templates/current/examples/{src → tests/unit}/router/runtimeErrorRecovery.spec.ts +11 -6
  705. package/templates/current/{clean/src → examples/tests/unit}/router/useRouteQueryDefaults.spec.ts +46 -12
  706. package/templates/current/examples/tests/unit/scripts/mock-api.spec.ts +440 -0
  707. package/templates/current/examples/{scripts → tests/unit/scripts}/vite-build-policy.spec.ts +35 -6
  708. package/templates/current/examples/{src/features/auth → tests/unit}/store/auth.spec.ts +68 -15
  709. package/templates/current/examples/tests/unit/store/dictionaries.spec.ts +106 -0
  710. package/templates/current/{clean/src → examples/tests/unit}/templates/templates.spec.ts +60 -16
  711. package/templates/current/examples/{src/utils/__tests__ → tests/unit/utils}/color-mix.spec.ts +1 -1
  712. package/templates/current/examples/tests/unit/utils/retryableDialog.spec.ts +61 -0
  713. package/templates/current/examples/{scripts/clean-overlay/src/features/errors/pages → tests/unit/views/errors}/error-pages.spec.ts +12 -9
  714. package/templates/current/examples/tests/unit/views/feature-composables.spec.ts +233 -0
  715. package/templates/current/examples/tests/unit/views/system/access/admin-repository.spec.ts +353 -0
  716. package/templates/current/examples/tests/unit/views/system/access/rbac.spec.ts +329 -0
  717. package/templates/current/examples/tests/unit/views/system/dept/departments.spec.ts +104 -0
  718. package/templates/current/examples/tests/unit/views/system/dict/dictionaries.spec.ts +234 -0
  719. package/templates/current/examples/tests/unit/views/system/menu/menuDraft.spec.ts +77 -0
  720. package/templates/current/examples/tests/unit/views/system/menu/useMenuManagement.spec.ts +339 -0
  721. package/templates/current/examples/tests/unit/views/system/user/searchControl.spec.ts +128 -0
  722. package/templates/current/examples/tsconfig.json +4 -19
  723. package/templates/current/examples/vite.build-policy.ts +97 -22
  724. package/templates/current/examples/vite.config.ts +50 -7
  725. package/templates/current/clean/.codebuddy/AGENTS.md +0 -18
  726. package/templates/current/clean/.codex/skills/build-admin-feature/SKILL.md +0 -14
  727. package/templates/current/clean/.codex/skills/build-admin-feature/references/component-selection.md +0 -25
  728. package/templates/current/clean/.codex/skills/use-og-table/SKILL.md +0 -16
  729. package/templates/current/clean/.cursor/AGENTS.md +0 -18
  730. package/templates/current/clean/.env.production.example +0 -31
  731. package/templates/current/clean/.qoder/AGENTS.md +0 -15
  732. package/templates/current/clean/e2e/admin-shell.spec.ts +0 -156
  733. package/templates/current/clean/e2e/demo-shell.spec.ts +0 -372
  734. package/templates/current/clean/playwright.demo.config.ts +0 -25
  735. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/NotFound.vue +0 -31
  736. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/ServerError.vue +0 -31
  737. package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/error-pages.spec.ts +0 -41
  738. package/templates/current/clean/scripts/clean-overlay/src/main.ts +0 -100
  739. package/templates/current/clean/scripts/clean-overlay/src/router/componentCache.ts +0 -12
  740. package/templates/current/clean/scripts/clean-overlay/src/router/componentRegistry.ts +0 -14
  741. package/templates/current/clean/scripts/clean-overlay/src/router/dynamicRoutes.spec.ts +0 -77
  742. package/templates/current/clean/scripts/clean-overlay/src/router/paths.ts +0 -21
  743. package/templates/current/clean/scripts/clean-overlay/src/router/staticRoutes.ts +0 -63
  744. package/templates/current/clean/scripts/demo-api.ts +0 -873
  745. package/templates/current/clean/src/api/client.spec.ts +0 -66
  746. package/templates/current/clean/src/api/client.ts +0 -152
  747. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/345/206/205/345/256/271/346/226/207/347/253/240.ts +0 -144
  748. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/345/256/241/350/256/241.ts +0 -50
  749. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/346/226/207/344/273/266/344/270/212/344/274/240.ts +0 -63
  750. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/347/224/250/346/210/267.ts +0 -169
  751. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/217/234/345/215/225.ts +0 -180
  752. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/247/222/350/211/262.ts +0 -167
  753. package/templates/current/clean/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/256/242/345/215/225/350/215/211/347/250/277.ts +0 -168
  754. package/templates/current/clean/src/api/generated//350/256/244/350/257/201.ts +0 -95
  755. package/templates/current/clean/src/api/http-adapter.ts +0 -83
  756. package/templates/current/clean/src/app/createAdminUi.spec.ts +0 -166
  757. package/templates/current/clean/src/app/createAdminUi.ts +0 -63
  758. package/templates/current/clean/src/app/embedded-token.spec.ts +0 -40
  759. package/templates/current/clean/src/app/embedded.spec.ts +0 -135
  760. package/templates/current/clean/src/app/embedded.ts +0 -255
  761. package/templates/current/clean/src/app/errorMessage.ts +0 -53
  762. package/templates/current/clean/src/app/menu-host.spec.ts +0 -77
  763. package/templates/current/clean/src/app/menu.spec.ts +0 -320
  764. package/templates/current/clean/src/app/menu.ts +0 -308
  765. package/templates/current/clean/src/app/menuTypes.ts +0 -18
  766. package/templates/current/clean/src/app/origenUiLocale.ts +0 -10
  767. package/templates/current/clean/src/app/permission.ts +0 -9
  768. package/templates/current/clean/src/demo-api.spec.ts +0 -478
  769. package/templates/current/clean/src/features/errors/pages/error-pages.spec.ts +0 -41
  770. package/templates/current/clean/src/features/system/access/api/admin-repository.spec.ts +0 -14
  771. package/templates/current/clean/src/features/system/access/api/admin-repository.ts +0 -298
  772. package/templates/current/clean/src/features/system/access/api/rbac.spec.ts +0 -72
  773. package/templates/current/clean/src/features/system/access/api/rbac.ts +0 -292
  774. package/templates/current/clean/src/features/system/access/composables/useAuthorizationPolling.spec.ts +0 -134
  775. package/templates/current/clean/src/features/system/access/composables/useAuthorizationPolling.ts +0 -96
  776. package/templates/current/clean/src/features/workspace/pages/Profile.vue +0 -185
  777. package/templates/current/clean/src/router/componentCache.ts +0 -12
  778. package/templates/current/clean/src/router/componentRegistry.ts +0 -14
  779. package/templates/current/clean/src/router/dynamicMenuRefresh.spec.ts +0 -101
  780. package/templates/current/clean/src/router/dynamicRoutes.spec.ts +0 -77
  781. package/templates/current/clean/src/router/dynamicRoutes.ts +0 -177
  782. package/templates/current/clean/src/router/guards.ts +0 -5
  783. package/templates/current/clean/src/router/paths.spec.ts +0 -50
  784. package/templates/current/clean/src/router/paths.ts +0 -21
  785. package/templates/current/clean/src/router/routeQuery.spec.ts +0 -11
  786. package/templates/current/clean/src/router/routeQuery.ts +0 -3
  787. package/templates/current/clean/src/router/staticRoutes.ts +0 -63
  788. package/templates/current/clean/src/router/useRouteQueryDefaults.types.ts +0 -20
  789. package/templates/current/examples/.codebuddy/AGENTS.md +0 -18
  790. package/templates/current/examples/.codex/skills/build-admin-feature/SKILL.md +0 -14
  791. package/templates/current/examples/.codex/skills/build-admin-feature/references/component-selection.md +0 -25
  792. package/templates/current/examples/.codex/skills/use-og-table/SKILL.md +0 -16
  793. package/templates/current/examples/.cursor/AGENTS.md +0 -18
  794. package/templates/current/examples/.env.production.example +0 -31
  795. package/templates/current/examples/.qoder/AGENTS.md +0 -15
  796. package/templates/current/examples/e2e/admin-shell.spec.ts +0 -156
  797. package/templates/current/examples/e2e/demo-shell.spec.ts +0 -372
  798. package/templates/current/examples/playwright.demo.config.ts +0 -25
  799. package/templates/current/examples/scripts/clean-overlay/src/features/errors/pages/Forbidden.vue +0 -31
  800. package/templates/current/examples/scripts/clean-overlay/src/main.ts +0 -100
  801. package/templates/current/examples/scripts/clean-overlay/src/router/componentCache.ts +0 -12
  802. package/templates/current/examples/scripts/clean-overlay/src/router/componentRegistry.ts +0 -14
  803. package/templates/current/examples/scripts/clean-overlay/src/router/dynamicRoutes.spec.ts +0 -77
  804. package/templates/current/examples/scripts/clean-overlay/src/router/paths.ts +0 -21
  805. package/templates/current/examples/scripts/clean-overlay/src/router/staticRoutes.ts +0 -63
  806. package/templates/current/examples/scripts/demo-api.ts +0 -873
  807. package/templates/current/examples/src/api/client.spec.ts +0 -66
  808. package/templates/current/examples/src/api/client.ts +0 -152
  809. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/345/206/205/345/256/271/346/226/207/347/253/240.ts +0 -144
  810. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/345/256/241/350/256/241.ts +0 -50
  811. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/346/226/207/344/273/266/344/270/212/344/274/240.ts +0 -63
  812. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/347/224/250/346/210/267.ts +0 -169
  813. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/217/234/345/215/225.ts +0 -180
  814. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/247/222/350/211/262.ts +0 -167
  815. package/templates/current/examples/src/api/generated//347/263/273/347/273/237/347/256/241/347/220/206/350/256/242/345/215/225/350/215/211/347/250/277.ts +0 -168
  816. package/templates/current/examples/src/api/generated//350/256/244/350/257/201.ts +0 -95
  817. package/templates/current/examples/src/api/http-adapter.ts +0 -83
  818. package/templates/current/examples/src/app/createAdminUi.spec.ts +0 -166
  819. package/templates/current/examples/src/app/createAdminUi.ts +0 -63
  820. package/templates/current/examples/src/app/embedded-token.spec.ts +0 -40
  821. package/templates/current/examples/src/app/embedded.spec.ts +0 -135
  822. package/templates/current/examples/src/app/embedded.ts +0 -255
  823. package/templates/current/examples/src/app/errorMessage.ts +0 -53
  824. package/templates/current/examples/src/app/menu-host.spec.ts +0 -77
  825. package/templates/current/examples/src/app/menu.spec.ts +0 -320
  826. package/templates/current/examples/src/app/menu.ts +0 -308
  827. package/templates/current/examples/src/app/menuTypes.ts +0 -18
  828. package/templates/current/examples/src/app/origenUiLocale.ts +0 -10
  829. package/templates/current/examples/src/app/permission.ts +0 -9
  830. package/templates/current/examples/src/demo-api.spec.ts +0 -478
  831. package/templates/current/examples/src/features/errors/pages/Forbidden.vue +0 -31
  832. package/templates/current/examples/src/features/errors/pages/NotFound.vue +0 -31
  833. package/templates/current/examples/src/features/errors/pages/ServerError.vue +0 -31
  834. package/templates/current/examples/src/features/feature-composables.spec.ts +0 -245
  835. package/templates/current/examples/src/features/system/access/api/admin-repository.spec.ts +0 -14
  836. package/templates/current/examples/src/features/system/access/api/admin-repository.ts +0 -298
  837. package/templates/current/examples/src/features/system/access/api/rbac.spec.ts +0 -72
  838. package/templates/current/examples/src/features/system/access/api/rbac.ts +0 -292
  839. package/templates/current/examples/src/features/system/access/composables/useAuthorizationPolling.spec.ts +0 -134
  840. package/templates/current/examples/src/features/system/access/composables/useAuthorizationPolling.ts +0 -96
  841. package/templates/current/examples/src/features/system/audit/composables/useAuditManagement.ts +0 -122
  842. package/templates/current/examples/src/features/system/audit/pages/AuditList.vue +0 -20
  843. package/templates/current/examples/src/features/system/menus/components/MenuEditorForm.vue +0 -279
  844. package/templates/current/examples/src/features/system/menus/composables/useMenuManagement.ts +0 -435
  845. package/templates/current/examples/src/features/system/menus/menuDraft.spec.ts +0 -204
  846. package/templates/current/examples/src/features/system/menus/menuDraft.ts +0 -116
  847. package/templates/current/examples/src/features/system/menus/menuTreePrecheck.spec.ts +0 -268
  848. package/templates/current/examples/src/features/system/menus/menuTreePrecheck.ts +0 -317
  849. package/templates/current/examples/src/features/system/menus/pages/MenuList.vue +0 -51
  850. package/templates/current/examples/src/features/system/roles/components/RoleEditorForm.vue +0 -116
  851. package/templates/current/examples/src/features/system/roles/composables/useRoleManagement.ts +0 -194
  852. package/templates/current/examples/src/features/system/roles/pages/RoleList.vue +0 -47
  853. package/templates/current/examples/src/features/system/users/components/UserEditorForm.vue +0 -104
  854. package/templates/current/examples/src/features/system/users/composables/useUserManagement.ts +0 -228
  855. package/templates/current/examples/src/features/system/users/pages/UserList.vue +0 -51
  856. package/templates/current/examples/src/features/workspace/pages/Dashboard.spec.ts +0 -41
  857. package/templates/current/examples/src/features/workspace/pages/Dashboard.vue +0 -325
  858. package/templates/current/examples/src/features/workspace/pages/Profile.vue +0 -185
  859. package/templates/current/examples/src/router/componentCache.ts +0 -18
  860. package/templates/current/examples/src/router/componentRegistry.ts +0 -66
  861. package/templates/current/examples/src/router/dynamicMenuRefresh.spec.ts +0 -101
  862. package/templates/current/examples/src/router/dynamicRoutes.spec.ts +0 -144
  863. package/templates/current/examples/src/router/dynamicRoutes.ts +0 -177
  864. package/templates/current/examples/src/router/guards.ts +0 -5
  865. package/templates/current/examples/src/router/paths.spec.ts +0 -50
  866. package/templates/current/examples/src/router/paths.ts +0 -21
  867. package/templates/current/examples/src/router/routeQuery.spec.ts +0 -11
  868. package/templates/current/examples/src/router/routeQuery.ts +0 -3
  869. package/templates/current/examples/src/router/staticRoutes.ts +0 -63
  870. package/templates/current/examples/src/router/useRouteQueryDefaults.types.ts +0 -20
  871. /package/templates/current/clean/{.codex → .agents}/skills/style-og-origen-ui/SKILL.md +0 -0
  872. /package/templates/current/clean/{.codex → .agents}/skills/style-og-origen-ui/agents/openai.yaml +0 -0
  873. /package/templates/current/clean/{.codex → .agents}/skills/use-og-dialog/SKILL.md +0 -0
  874. /package/templates/current/clean/{.codex → .agents}/skills/use-og-dialog/agents/openai.yaml +0 -0
  875. /package/templates/current/clean/{.codex → .agents}/skills/use-og-editor/SKILL.md +0 -0
  876. /package/templates/current/clean/{.codex → .agents}/skills/use-og-http/SKILL.md +0 -0
  877. /package/templates/current/clean/{.codex → .agents}/skills/use-og-http/agents/openai.yaml +0 -0
  878. /package/templates/current/clean/{.codex → .agents}/skills/use-og-router-tabs/SKILL.md +0 -0
  879. /package/templates/current/{examples/.codex → clean/.claude}/skills/style-og-origen-ui/SKILL.md +0 -0
  880. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-dialog/SKILL.md +0 -0
  881. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-editor/SKILL.md +0 -0
  882. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-http/SKILL.md +0 -0
  883. /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-router-tabs/SKILL.md +0 -0
  884. /package/templates/current/clean/src/{features/security/components → components}/DevtoolsProtectionOverlay.vue +0 -0
  885. /package/templates/current/clean/src/{features/shell/composables → composables}/useRouteProgress.ts +0 -0
  886. /package/templates/current/clean/src/{features/workspace → views/fallback}/pages/Empty.vue +0 -0
  887. /package/templates/current/examples/{.codex → .agents}/skills/style-og-origen-ui/agents/openai.yaml +0 -0
  888. /package/templates/current/examples/{.codex → .agents}/skills/use-og-dialog/agents/openai.yaml +0 -0
  889. /package/templates/current/examples/{.codex → .agents}/skills/use-og-http/agents/openai.yaml +0 -0
  890. /package/templates/current/examples/src/{features/security/components → components}/DevtoolsProtectionOverlay.vue +0 -0
  891. /package/templates/current/examples/src/{features/shell/composables → composables}/useRouteProgress.ts +0 -0
  892. /package/templates/current/examples/src/{features/workspace → views/fallback}/pages/Empty.vue +0 -0
@@ -0,0 +1,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
+ }