@origen-ui/admin-cli 2.0.2 → 3.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +20 -9
- package/bin/contract-sync.mjs +112 -0
- package/bin/lib/errors.mjs +8 -0
- package/bin/lib/fs-json.mjs +18 -0
- package/bin/lib/hash.mjs +9 -0
- package/bin/og-admin.mjs +165 -35
- package/bin/sync-project.mjs +717 -0
- package/package.json +20 -17
- package/templates/current/clean/.agents/skills/admin-component-usage/SKILL.md +28 -0
- package/templates/current/clean/.agents/skills/admin-component-usage/references/component-directory.md +270 -0
- package/templates/current/clean/.agents/skills/build-admin-feature/SKILL.md +20 -0
- package/templates/current/clean/.agents/skills/build-admin-feature/references/component-selection.md +38 -0
- package/templates/current/{examples/.codex → clean/.agents}/skills/use-og-form/SKILL.md +1 -1
- package/templates/current/{examples/.codex → clean/.agents}/skills/use-og-form-table/SKILL.md +4 -3
- package/templates/current/clean/{.codex → .agents}/skills/use-og-search/SKILL.md +3 -3
- package/templates/current/clean/.agents/skills/use-og-table/SKILL.md +22 -0
- package/templates/current/{examples/.codex → clean/.agents}/skills/use-og-upload/SKILL.md +6 -5
- package/templates/current/clean/.api-client-e2e.config.ts +13 -0
- package/templates/current/clean/.claude/rules/01-feature-architecture.md +10 -0
- package/templates/current/clean/.claude/rules/02-vue-typescript.md +10 -0
- package/templates/current/clean/.claude/rules/03-component-policy.md +31 -0
- package/templates/current/clean/.claude/rules/04-api-auth-router.md +10 -0
- package/templates/current/clean/.claude/rules/05-style.md +10 -0
- package/templates/current/clean/.claude/rules/06-quality.md +10 -0
- package/templates/current/clean/.claude/skills/admin-component-usage/SKILL.md +28 -0
- package/templates/current/clean/.claude/skills/admin-component-usage/references/component-directory.md +270 -0
- package/templates/current/clean/.claude/skills/build-admin-feature/SKILL.md +20 -0
- package/templates/current/clean/.claude/skills/build-admin-feature/references/component-selection.md +38 -0
- package/templates/current/clean/{.codex → .claude}/skills/use-og-form/SKILL.md +1 -1
- package/templates/current/clean/{.codex → .claude}/skills/use-og-form-table/SKILL.md +4 -3
- package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-search/SKILL.md +3 -3
- package/templates/current/clean/.claude/skills/use-og-table/SKILL.md +22 -0
- package/templates/current/clean/{.codex → .claude}/skills/use-og-upload/SKILL.md +6 -5
- package/templates/current/clean/.codebuddy/rules/01-feature-architecture.md +2 -2
- package/templates/current/clean/.codebuddy/rules/03-component-policy.md +4 -1
- package/templates/current/clean/.codebuddy/skills/admin-component-usage/SKILL.md +31 -0
- package/templates/current/clean/.codebuddy/skills/admin-component-usage/references/component-directory.md +270 -0
- package/templates/current/clean/.codebuddy/skills/build-admin-feature/SKILL.md +11 -5
- package/templates/current/clean/.codebuddy/skills/build-admin-feature/references/component-selection.md +38 -0
- package/templates/current/clean/.codebuddy/skills/use-og-form/SKILL.md +1 -1
- package/templates/current/clean/.codebuddy/skills/use-og-form-table/SKILL.md +4 -3
- package/templates/current/clean/.codebuddy/skills/use-og-search/SKILL.md +3 -3
- package/templates/current/clean/.codebuddy/skills/use-og-table/SKILL.md +16 -10
- package/templates/current/clean/.codebuddy/skills/use-og-upload/SKILL.md +6 -5
- package/templates/current/clean/.codex/AGENTS.md +55 -8
- package/templates/current/clean/.codex/rules/01-feature-architecture.md +2 -2
- package/templates/current/clean/.codex/rules/03-component-policy.md +4 -1
- package/templates/current/clean/.cursor/rules/.generated +5 -0
- package/templates/current/clean/.cursor/rules/01-feature-architecture.mdc +2 -2
- package/templates/current/clean/.cursor/rules/03-component-policy.mdc +4 -1
- package/templates/current/clean/.cursor/skills/admin-component-usage/SKILL.md +28 -0
- package/templates/current/clean/.cursor/skills/admin-component-usage/references/component-directory.md +270 -0
- package/templates/current/clean/.cursor/skills/build-admin-feature/SKILL.md +11 -5
- package/templates/current/clean/.cursor/skills/build-admin-feature/references/component-selection.md +38 -0
- package/templates/current/clean/.cursor/skills/use-og-form/SKILL.md +1 -1
- package/templates/current/clean/.cursor/skills/use-og-form-table/SKILL.md +4 -3
- package/templates/current/clean/.cursor/skills/use-og-search/SKILL.md +3 -3
- package/templates/current/clean/.cursor/skills/use-og-table/SKILL.md +16 -10
- package/templates/current/clean/.cursor/skills/use-og-upload/SKILL.md +6 -5
- package/templates/current/clean/{.env.example → .env.dev} +3 -2
- package/templates/current/clean/.env.mock +4 -0
- package/templates/current/clean/.env.production +5 -0
- package/templates/current/clean/.env.test +4 -0
- package/templates/current/clean/.prettierignore +17 -0
- package/templates/current/clean/.prettierrc +8 -0
- package/templates/current/clean/.qoder/rules/01-feature-architecture.md +3 -4
- package/templates/current/clean/.qoder/rules/02-vue-typescript.md +1 -2
- package/templates/current/clean/.qoder/rules/03-component-policy.md +5 -3
- package/templates/current/clean/.qoder/rules/04-api-auth-router.md +1 -2
- package/templates/current/clean/.qoder/rules/05-style.md +1 -2
- package/templates/current/clean/.qoder/rules/06-quality.md +1 -2
- package/templates/current/clean/.qoder/skills/admin-component-usage/SKILL.md +28 -0
- package/templates/current/clean/.qoder/skills/admin-component-usage/references/component-directory.md +270 -0
- package/templates/current/clean/.qoder/skills/build-admin-feature/SKILL.md +11 -5
- package/templates/current/clean/.qoder/skills/build-admin-feature/references/component-selection.md +38 -0
- package/templates/current/clean/.qoder/skills/use-og-form/SKILL.md +1 -1
- package/templates/current/clean/.qoder/skills/use-og-form-table/SKILL.md +4 -3
- package/templates/current/clean/.qoder/skills/use-og-search/SKILL.md +3 -3
- package/templates/current/clean/.qoder/skills/use-og-table/SKILL.md +16 -10
- package/templates/current/clean/.qoder/skills/use-og-upload/SKILL.md +6 -5
- package/templates/current/clean/.zcode/skills/admin-component-usage/SKILL.md +28 -0
- package/templates/current/clean/.zcode/skills/admin-component-usage/references/component-directory.md +270 -0
- package/templates/current/clean/.zcode/skills/build-admin-feature/SKILL.md +20 -0
- package/templates/current/clean/.zcode/skills/build-admin-feature/references/component-selection.md +38 -0
- package/templates/current/clean/.zcode/skills/style-og-origen-ui/SKILL.md +11 -0
- package/templates/current/clean/.zcode/skills/use-og-dialog/SKILL.md +12 -0
- package/templates/current/clean/.zcode/skills/use-og-editor/SKILL.md +25 -0
- package/templates/current/clean/.zcode/skills/use-og-form/SKILL.md +12 -0
- package/templates/current/clean/.zcode/skills/use-og-form-table/SKILL.md +26 -0
- package/templates/current/clean/.zcode/skills/use-og-http/SKILL.md +13 -0
- package/templates/current/clean/.zcode/skills/use-og-router-tabs/SKILL.md +11 -0
- package/templates/current/clean/.zcode/skills/use-og-search/SKILL.md +14 -0
- package/templates/current/clean/.zcode/skills/use-og-table/SKILL.md +22 -0
- package/templates/current/clean/.zcode/skills/use-og-upload/SKILL.md +26 -0
- package/templates/current/clean/AGENTS.md +55 -9
- package/templates/current/clean/CHANGELOG.md +107 -0
- package/templates/current/clean/CLAUDE.md +3 -0
- package/templates/current/clean/README.md +58 -88
- package/templates/current/clean/component-catalog.json +766 -348
- package/templates/current/clean/component-catalog.v2.json +2040 -0
- package/templates/current/clean/docs/components/dialog.md +405 -0
- package/templates/current/clean/docs/components/editor-viewer.md +87 -0
- package/templates/current/clean/docs/components/editor.md +275 -0
- package/templates/current/clean/docs/components/form-table.md +222 -0
- package/templates/current/clean/docs/components/form.md +750 -0
- package/templates/current/clean/docs/components/index.md +44 -0
- package/templates/current/clean/docs/components/router.md +452 -0
- package/templates/current/clean/docs/components/search.md +1205 -0
- package/templates/current/clean/docs/components/svg-icon.md +124 -0
- package/templates/current/clean/docs/components/table-local.md +176 -0
- package/templates/current/clean/docs/components/table-with-search.md +207 -0
- package/templates/current/clean/docs/components/table.md +813 -0
- package/templates/current/clean/docs/components/tabs.md +440 -0
- package/templates/current/clean/docs/components/upload.md +349 -0
- package/templates/current/clean/eslint.config.js +89 -0
- package/templates/current/clean/index.html +1 -1
- package/templates/current/clean/openapi.json +10048 -999
- package/templates/current/clean/package.json +45 -33
- package/templates/current/clean/playwright.config.ts +20 -6
- package/templates/current/clean/playwright.mock.config.ts +42 -0
- package/templates/current/clean/pnpm-workspace.yaml +19 -3
- package/templates/current/clean/recipes/remote-crud-dialog-form.vue +15 -13
- package/templates/current/clean/scaffold.lock.json +164 -4
- package/templates/current/clean/scripts/api-codegen.config.ts +35 -0
- package/templates/current/clean/scripts/api-codegen.ts +2015 -0
- package/templates/current/clean/scripts/api-templates/http-client.ejs +359 -0
- package/templates/current/clean/scripts/check-admin-scaffold.mjs +311 -17
- package/templates/current/clean/scripts/generate-api.ts +290 -85
- package/templates/current/clean/scripts/lib/admin-component-catalog.mjs +515 -0
- package/templates/current/clean/scripts/lib/repository-root.mjs +9 -0
- package/templates/current/clean/scripts/mock-api.ts +1356 -0
- package/templates/current/clean/scripts/remove-examples.mjs +9 -34
- package/templates/current/clean/src/App.vue +9 -18
- package/templates/current/clean/src/api/generated/data-contracts.ts +23 -265
- package/templates/current/clean/src/api/generated/http-client.ts +351 -180
- package/templates/current/clean/src/api/generated/index.ts +22 -0
- package/templates/current/clean/src/api/generated/services/auth.ts +123 -0
- package/templates/current/clean/src/api/generated/services/common/files.ts +111 -0
- package/templates/current/clean/src/api/generated/services/monitor/cache.ts +164 -0
- package/templates/current/clean/src/api/generated/services/monitor/job.ts +195 -0
- package/templates/current/clean/src/api/generated/services/monitor/jobLog.ts +126 -0
- package/templates/current/clean/src/api/generated/services/monitor/logininfor.ts +126 -0
- package/templates/current/clean/src/api/generated/services/monitor/online.ts +66 -0
- package/templates/current/clean/src/api/generated/services/monitor/operlog.ts +106 -0
- package/templates/current/clean/src/api/generated/services/monitor/server.ts +41 -0
- package/templates/current/clean/src/api/generated/services/system/configs.ts +190 -0
- package/templates/current/clean/src/api/generated/services/system/departments.ts +173 -0
- package/templates/current/clean/src/api/generated/services/system/dictionaries/data.ts +169 -0
- package/templates/current/clean/src/api/generated/services/system/dictionaries/types.ts +187 -0
- package/templates/current/clean/src/api/generated/services/system/index.ts +158 -0
- package/templates/current/clean/src/api/generated/services/system/menus.ts +193 -0
- package/templates/current/clean/src/api/generated/services/system/notices.ts +221 -0
- package/templates/current/clean/src/api/generated/services/system/posts.ts +168 -0
- package/templates/current/clean/src/api/generated/services/system/roles.ts +354 -0
- package/templates/current/clean/src/api/generated/services/system/users.ts +425 -0
- package/templates/current/clean/src/api/generated/services/tool/code-generator.ts +304 -0
- package/templates/current/clean/src/api/generated/types/auth.types.ts +132 -0
- package/templates/current/clean/src/api/generated/types/common/files.types.ts +57 -0
- package/templates/current/clean/src/api/generated/types/common.ts +174 -0
- package/templates/current/clean/src/api/generated/types/enum-dict.ts +94 -0
- package/templates/current/clean/src/api/generated/types/enums.ts +155 -0
- package/templates/current/clean/src/api/generated/types/monitor/cache.types.ts +149 -0
- package/templates/current/clean/src/api/generated/types/monitor/job.types.ts +207 -0
- package/templates/current/clean/src/api/generated/types/monitor/jobLog.types.ts +134 -0
- package/templates/current/clean/src/api/generated/types/monitor/logininfor.types.ts +135 -0
- package/templates/current/clean/src/api/generated/types/monitor/online.types.ts +80 -0
- package/templates/current/clean/src/api/generated/types/monitor/operlog.types.ts +126 -0
- package/templates/current/clean/src/api/generated/types/monitor/server.types.ts +205 -0
- package/templates/current/clean/src/api/generated/types/system/configs.types.ts +200 -0
- package/templates/current/clean/src/api/generated/types/system/departments.types.ts +145 -0
- package/templates/current/clean/src/api/generated/types/system/dictionaries/data.types.ts +210 -0
- package/templates/current/clean/src/api/generated/types/system/dictionaries/types.types.ts +221 -0
- package/templates/current/clean/src/api/generated/types/system/index.types.ts +19 -0
- package/templates/current/clean/src/api/generated/types/system/menus.types.ts +234 -0
- package/templates/current/clean/src/api/generated/types/system/notices.types.ts +270 -0
- package/templates/current/clean/src/api/generated/types/system/posts.types.ts +198 -0
- package/templates/current/clean/src/api/generated/types/system/roles.types.ts +410 -0
- package/templates/current/clean/src/api/generated/types/system/users.types.ts +413 -0
- package/templates/current/clean/src/api/generated/types/tool/code-generator.types.ts +388 -0
- package/templates/current/clean/src/api/index.ts +44 -39
- package/templates/current/clean/src/app/__tests__/api-generated.types.ts +24 -0
- package/templates/current/clean/src/app/api.ts +6 -0
- package/templates/current/clean/src/app/authorization/permission.ts +9 -0
- package/templates/current/{examples/src/app → clean/src/app/config}/runtimeConfig.ts +44 -12
- package/templates/current/clean/src/app/errors/errorMessage.ts +80 -0
- package/templates/current/clean/src/app/http/client.ts +141 -0
- package/templates/current/clean/src/app/http/http-adapter.ts +71 -0
- package/templates/current/{examples/src/app → clean/src/app/i18n}/adminLocale.ts +25 -19
- package/templates/current/clean/src/app/{localeFormat.ts → i18n/localeFormat.ts} +29 -6
- package/templates/current/clean/src/app/i18n/origenUiLocale.ts +15 -0
- package/templates/current/clean/src/app/menu/menu.ts +175 -0
- package/templates/current/clean/src/app/menu/menuTypes.ts +20 -0
- package/templates/current/clean/src/{features → app}/security/devtoolsProtection.ts +8 -7
- package/templates/current/clean/src/app/ui/createAdminUi.ts +31 -0
- package/templates/current/clean/src/app/ui/iconCatalog.ts +71 -0
- package/templates/current/clean/src/assets/icons/appearance.svg +1 -0
- package/templates/current/clean/src/assets/icons/arrow-right.svg +1 -0
- package/templates/current/clean/src/assets/icons/check.svg +1 -0
- package/templates/current/clean/src/assets/icons/circle-check.svg +1 -0
- package/templates/current/clean/src/assets/icons/default.svg +4 -0
- package/templates/current/clean/src/assets/icons/directory/setting.svg +1 -0
- package/templates/current/clean/src/assets/icons/expand.svg +1 -0
- package/templates/current/clean/src/assets/icons/fold.svg +1 -0
- package/templates/current/clean/src/assets/icons/key.svg +1 -0
- package/templates/current/clean/src/assets/icons/lock.svg +1 -0
- package/templates/current/clean/src/assets/icons/monitor.svg +1 -0
- package/templates/current/clean/src/assets/icons/moon.svg +11 -0
- package/templates/current/clean/src/assets/icons/page/department.svg +1 -0
- package/templates/current/clean/src/assets/icons/page/dictionary.svg +1 -0
- package/templates/current/clean/src/assets/icons/page/menus.svg +1 -0
- package/templates/current/clean/src/assets/icons/page/user.svg +1 -0
- package/templates/current/clean/src/assets/icons/page/users.svg +1 -0
- package/templates/current/clean/src/assets/icons/plus.svg +1 -0
- package/templates/current/clean/src/assets/icons/profile.svg +1 -0
- package/templates/current/clean/src/assets/icons/refresh.svg +1 -0
- package/templates/current/clean/src/assets/icons/roles.svg +1 -0
- package/templates/current/clean/src/assets/icons/search.svg +1 -0
- package/templates/current/clean/src/assets/icons/sunny.svg +1 -0
- package/templates/current/clean/src/assets/icons/system.svg +1 -0
- package/templates/current/clean/src/assets/icons/theme-auto.svg +14 -0
- package/templates/current/clean/src/assets/icons/tune.svg +13 -0
- package/templates/current/clean/src/{features/shell/components → components}/RouteProgress.vue +2 -2
- package/templates/current/{examples/src/features/system/access → clean/src}/composables/useAuthorizationRefresh.ts +6 -1
- package/templates/current/clean/src/composables/useSystemTableSearchVisibility.ts +33 -0
- package/templates/current/clean/src/{features/appearance/composables → composables}/useTheme.ts +1 -1
- package/templates/current/clean/src/env.d.ts +6 -19
- package/templates/current/clean/src/layouts/AdminLayout.vue +7 -9
- package/templates/current/clean/src/{features/shell/components → layouts}/AdminWatermark.vue +2 -2
- package/templates/current/clean/src/layouts/BreadcrumbBar.vue +9 -1
- package/templates/current/clean/src/layouts/SideMenu.vue +7 -15
- package/templates/current/clean/src/{features/appearance/components → layouts}/ThemePanel.vue +39 -11
- package/templates/current/clean/src/layouts/TopBar.vue +60 -28
- package/templates/current/clean/src/layouts/WorkspaceTabs.vue +10 -1
- package/templates/current/clean/src/layouts/topBarMenuSearch.ts +25 -4
- package/templates/current/clean/src/locales/en-US.json +227 -219
- package/templates/current/clean/src/locales/index.ts +72 -32
- package/templates/current/clean/src/locales/messages-types.ts +15 -10
- package/templates/current/clean/src/locales/vue-i18n.d.ts +1 -1
- package/templates/current/clean/src/locales/zh-CN.json +226 -218
- package/templates/current/clean/src/locales/zh-TW.json +222 -214
- package/templates/current/clean/src/main.ts +59 -30
- package/templates/current/clean/src/router/bootstrap.ts +69 -24
- package/templates/current/clean/src/router/dynamic/componentLoader.ts +150 -0
- package/templates/current/clean/src/router/{dynamicMenuRefresh.ts → dynamic/dynamicMenuRefresh.ts} +6 -2
- package/templates/current/clean/src/router/dynamic/dynamicRoutes.ts +247 -0
- package/templates/current/clean/src/router/navigation/guards.ts +12 -0
- package/templates/current/clean/src/router/navigation/paths.ts +28 -0
- package/templates/current/clean/src/router/navigation/staticRoutes.ts +109 -0
- package/templates/current/clean/src/router/{queryEncryption.ts → query/queryEncryption.ts} +29 -12
- package/templates/current/clean/src/router/query/routeQuery.ts +29 -0
- package/templates/current/clean/src/router/{useRouteQueryDefaults.ts → query/useRouteQueryDefaults.ts} +9 -8
- package/templates/current/clean/src/router/query/useRouteQueryDefaults.types.ts +28 -0
- package/templates/current/clean/src/router/{runtimeErrorRecovery.ts → recovery/runtimeErrorRecovery.ts} +21 -3
- package/templates/current/clean/src/{features/auth/store → store}/auth.ts +96 -61
- package/templates/current/clean/src/store/dictionaries.ts +86 -0
- package/templates/current/clean/src/{features/shell/store → store}/sidebar.ts +9 -2
- package/templates/current/{examples/src/features/appearance → clean/src}/store/theme.ts +8 -4
- package/templates/current/clean/src/styles/layout.css +51 -0
- package/templates/current/clean/src/templates/og-form.ts +7 -2
- package/templates/current/clean/src/templates/og-table.ts +88 -20
- package/templates/current/clean/src/templates/router.ts +11 -2
- package/templates/current/clean/src/utils/color-mix.ts +6 -2
- package/templates/current/clean/src/utils/download.ts +11 -0
- package/templates/current/clean/src/utils/permissions.ts +1 -1
- package/templates/current/clean/src/utils/retryableDialog.ts +46 -0
- package/templates/current/clean/src/{features → views}/errors/pages/Forbidden.vue +6 -2
- package/templates/current/clean/src/views/errors/pages/MethodNotAllowed.vue +34 -0
- package/templates/current/clean/src/{features → views}/errors/pages/NotFound.vue +6 -2
- package/templates/current/clean/src/{features → views}/errors/pages/ServerError.vue +6 -2
- package/templates/current/clean/src/{features/auth/pages/Login.vue → views/login/pages/index.vue} +99 -10
- package/templates/current/clean/src/views/system/access/services/admin-repository.ts +489 -0
- package/templates/current/clean/src/views/system/access/services/rbac.ts +317 -0
- package/templates/current/clean/src/views/system/dept/components/DepartmentEditorForm.vue +87 -0
- package/templates/current/clean/src/views/system/dept/composables/useDepartmentManagement.ts +314 -0
- package/templates/current/clean/src/views/system/dept/pages/index.vue +44 -0
- package/templates/current/clean/src/views/system/dept/services/departments.ts +168 -0
- package/templates/current/clean/src/views/system/dict/components/DictionaryDataEditorForm.vue +98 -0
- package/templates/current/clean/src/views/system/dict/components/DictionaryDataPreview.vue +233 -0
- package/templates/current/clean/src/views/system/dict/components/DictionaryTypeEditorForm.vue +66 -0
- package/templates/current/clean/src/views/system/dict/composables/useDictionaryDataManagement.ts +406 -0
- package/templates/current/clean/src/views/system/dict/composables/useDictionaryTypeManagement.ts +329 -0
- package/templates/current/clean/src/views/system/dict/data/pages/index.vue +134 -0
- package/templates/current/clean/src/views/system/dict/pages/index.vue +113 -0
- package/templates/current/clean/src/views/system/dict/services/dictionaries.ts +239 -0
- package/templates/current/clean/src/views/system/menu/components/MenuEditorForm.vue +252 -0
- package/templates/current/clean/src/views/system/menu/composables/useMenuManagement.ts +357 -0
- package/templates/current/clean/src/views/system/menu/menuDraft.ts +45 -0
- package/templates/current/clean/src/views/system/menu/pages/ExternalLink.vue +37 -0
- package/templates/current/clean/src/views/system/menu/pages/index.vue +75 -0
- package/templates/current/clean/src/views/system/post/components/PostEditorForm.vue +69 -0
- package/templates/current/clean/src/views/system/post/composables/usePostManagement.ts +245 -0
- package/templates/current/clean/src/views/system/post/pages/index.vue +92 -0
- package/templates/current/clean/src/views/system/post/services/posts.ts +100 -0
- package/templates/current/clean/src/views/system/role/auth-users/pages/index.vue +100 -0
- package/templates/current/clean/src/views/system/role/components/RoleDataScopeForm.vue +167 -0
- package/templates/current/clean/src/views/system/role/components/RoleEditorForm.vue +165 -0
- package/templates/current/clean/src/views/system/role/components/RoleUserSelectForm.vue +129 -0
- package/templates/current/clean/src/views/system/role/composables/useRoleManagement.ts +422 -0
- package/templates/current/clean/src/views/system/role/composables/useRoleUserManagement.ts +233 -0
- package/templates/current/clean/src/views/system/role/pages/index.vue +110 -0
- package/templates/current/clean/src/views/system/role/services/roleAccess.ts +162 -0
- package/templates/current/clean/src/views/system/user/auth-roles/pages/index.vue +209 -0
- package/templates/current/clean/src/views/system/user/components/UserDetailsForm.vue +108 -0
- package/templates/current/clean/src/views/system/user/components/UserEditorForm.vue +207 -0
- package/templates/current/clean/src/views/system/user/components/UserImportDialog.vue +80 -0
- package/templates/current/clean/src/views/system/user/components/UserResetPasswordForm.vue +56 -0
- package/templates/current/clean/src/views/system/user/composables/useUserManagement.ts +502 -0
- package/templates/current/clean/src/views/system/user/pages/index.vue +459 -0
- package/templates/current/clean/tests/e2e/admin-access-business.spec.ts +33 -0
- package/templates/current/clean/tests/e2e/admin-shell.spec.ts +50 -0
- package/templates/current/clean/tests/e2e/fixtures/adminMockBackend.ts +95 -0
- package/templates/current/clean/tests/e2e/fixtures/labelGeometry.ts +52 -0
- package/templates/current/clean/tests/e2e/mock-api-generation.spec.ts +27 -0
- package/templates/current/clean/tests/e2e/mock-business.spec.ts +555 -0
- package/templates/current/clean/tests/e2e/mock-menu-retry-form-label.spec.ts +100 -0
- package/templates/current/clean/tests/e2e/mock-shell.spec.ts +25 -0
- package/templates/current/clean/tests/e2e/mock-tree-selection-layout.spec.ts +113 -0
- package/templates/current/clean/tests/unit/api/api-codegen.spec.ts +893 -0
- package/templates/current/clean/tests/unit/api/client.spec.ts +145 -0
- package/templates/current/clean/tests/unit/api/generated-http-client.spec.ts +290 -0
- package/templates/current/{examples/src → clean/tests/unit}/api/http-adapter.spec.ts +3 -3
- package/templates/current/clean/tests/unit/api/system-apis.spec.ts +118 -0
- package/templates/current/clean/tests/unit/app/createAdminUi.spec.ts +79 -0
- package/templates/current/clean/{src → tests/unit}/app/errorMessage.spec.ts +1 -1
- package/templates/current/clean/tests/unit/app/iconCatalog.spec.ts +12 -0
- package/templates/current/clean/tests/unit/app/menu.spec.ts +215 -0
- package/templates/current/{examples/src → clean/tests/unit}/app/origenUiLocale.spec.ts +1 -1
- package/templates/current/{examples/src → clean/tests/unit}/app/permission.spec.ts +4 -5
- package/templates/current/clean/tests/unit/app/runtimeConfig.spec.ts +36 -0
- package/templates/current/{examples/src/features → clean/tests/unit/app}/security/devtoolsProtection.spec.ts +17 -7
- package/templates/current/{examples/src/features/shell → clean/tests/unit}/composables/useRouteProgress.spec.ts +1 -1
- package/templates/current/{examples/src/features/shell/components → clean/tests/unit/layouts}/AdminWatermark.spec.ts +5 -7
- package/templates/current/{examples/src → clean/tests/unit}/layouts/topBarMenuSearch.spec.ts +25 -8
- package/templates/current/clean/{src → tests/unit}/locales/messages.spec.ts +43 -17
- package/templates/current/clean/tests/unit/router/dynamicMenuRefresh.spec.ts +151 -0
- package/templates/current/clean/tests/unit/router/dynamicRoutes.spec.ts +374 -0
- package/templates/current/clean/tests/unit/router/paths.spec.ts +103 -0
- package/templates/current/clean/{src → tests/unit}/router/queryEncryption.spec.ts +49 -12
- package/templates/current/{examples/src → clean/tests/unit}/router/routeQuery.spec.ts +8 -1
- package/templates/current/clean/{src → tests/unit}/router/runtimeErrorRecovery.spec.ts +11 -6
- package/templates/current/{examples/src → clean/tests/unit}/router/useRouteQueryDefaults.spec.ts +46 -12
- package/templates/current/clean/tests/unit/scripts/mock-api.spec.ts +440 -0
- package/templates/current/clean/{scripts → tests/unit/scripts}/vite-build-policy.spec.ts +35 -6
- package/templates/current/clean/{src/features/auth → tests/unit}/store/auth.spec.ts +68 -15
- package/templates/current/clean/tests/unit/store/dictionaries.spec.ts +106 -0
- package/templates/current/{examples/src → clean/tests/unit}/templates/templates.spec.ts +60 -16
- package/templates/current/clean/{src/utils/__tests__ → tests/unit/utils}/color-mix.spec.ts +1 -1
- package/templates/current/clean/tests/unit/utils/retryableDialog.spec.ts +61 -0
- package/templates/current/{examples/src/features/errors/pages → clean/tests/unit/views/errors}/error-pages.spec.ts +11 -7
- package/templates/current/clean/tests/unit/views/feature-composables.spec.ts +233 -0
- package/templates/current/clean/tests/unit/views/system/access/admin-repository.spec.ts +353 -0
- package/templates/current/clean/tests/unit/views/system/access/rbac.spec.ts +329 -0
- package/templates/current/clean/tests/unit/views/system/dept/departments.spec.ts +104 -0
- package/templates/current/clean/tests/unit/views/system/dict/dictionaries.spec.ts +234 -0
- package/templates/current/clean/tests/unit/views/system/menu/menuDraft.spec.ts +77 -0
- package/templates/current/clean/tests/unit/views/system/menu/useMenuManagement.spec.ts +339 -0
- package/templates/current/clean/tests/unit/views/system/user/searchControl.spec.ts +128 -0
- package/templates/current/clean/tsconfig.json +4 -19
- package/templates/current/clean/vite.build-policy.ts +97 -22
- package/templates/current/clean/vite.config.ts +50 -7
- package/templates/current/examples/.agents/skills/admin-component-usage/SKILL.md +28 -0
- package/templates/current/examples/.agents/skills/admin-component-usage/references/component-directory.md +270 -0
- package/templates/current/examples/.agents/skills/build-admin-feature/SKILL.md +20 -0
- package/templates/current/examples/.agents/skills/build-admin-feature/references/component-selection.md +38 -0
- package/templates/current/examples/.agents/skills/style-og-origen-ui/SKILL.md +11 -0
- package/templates/current/examples/.agents/skills/use-og-dialog/SKILL.md +12 -0
- package/templates/current/examples/.agents/skills/use-og-editor/SKILL.md +25 -0
- package/templates/current/examples/.agents/skills/use-og-form/SKILL.md +12 -0
- package/templates/current/examples/.agents/skills/use-og-form-table/SKILL.md +26 -0
- package/templates/current/examples/.agents/skills/use-og-http/SKILL.md +13 -0
- package/templates/current/examples/.agents/skills/use-og-router-tabs/SKILL.md +11 -0
- package/templates/current/examples/.agents/skills/use-og-search/SKILL.md +14 -0
- package/templates/current/examples/.agents/skills/use-og-table/SKILL.md +22 -0
- package/templates/current/examples/.agents/skills/use-og-upload/SKILL.md +26 -0
- package/templates/current/examples/.api-client-e2e.config.ts +13 -0
- package/templates/current/examples/.claude/rules/01-feature-architecture.md +10 -0
- package/templates/current/examples/.claude/rules/02-vue-typescript.md +10 -0
- package/templates/current/examples/.claude/rules/03-component-policy.md +31 -0
- package/templates/current/examples/.claude/rules/04-api-auth-router.md +10 -0
- package/templates/current/examples/.claude/rules/05-style.md +10 -0
- package/templates/current/examples/.claude/rules/06-quality.md +10 -0
- package/templates/current/examples/.claude/skills/admin-component-usage/SKILL.md +28 -0
- package/templates/current/examples/.claude/skills/admin-component-usage/references/component-directory.md +270 -0
- package/templates/current/examples/.claude/skills/build-admin-feature/SKILL.md +20 -0
- package/templates/current/examples/.claude/skills/build-admin-feature/references/component-selection.md +38 -0
- package/templates/current/examples/.claude/skills/style-og-origen-ui/SKILL.md +11 -0
- package/templates/current/examples/.claude/skills/use-og-dialog/SKILL.md +12 -0
- package/templates/current/examples/.claude/skills/use-og-editor/SKILL.md +25 -0
- package/templates/current/examples/.claude/skills/use-og-form/SKILL.md +12 -0
- package/templates/current/examples/.claude/skills/use-og-form-table/SKILL.md +26 -0
- package/templates/current/examples/.claude/skills/use-og-http/SKILL.md +13 -0
- package/templates/current/examples/.claude/skills/use-og-router-tabs/SKILL.md +11 -0
- package/templates/current/examples/.claude/skills/use-og-search/SKILL.md +14 -0
- package/templates/current/examples/.claude/skills/use-og-table/SKILL.md +22 -0
- package/templates/current/examples/.claude/skills/use-og-upload/SKILL.md +26 -0
- package/templates/current/examples/.codebuddy/rules/01-feature-architecture.md +2 -2
- package/templates/current/examples/.codebuddy/rules/03-component-policy.md +4 -1
- package/templates/current/examples/.codebuddy/skills/admin-component-usage/SKILL.md +31 -0
- package/templates/current/examples/.codebuddy/skills/admin-component-usage/references/component-directory.md +270 -0
- package/templates/current/examples/.codebuddy/skills/build-admin-feature/SKILL.md +11 -5
- package/templates/current/examples/.codebuddy/skills/build-admin-feature/references/component-selection.md +38 -0
- package/templates/current/examples/.codebuddy/skills/use-og-form/SKILL.md +1 -1
- package/templates/current/examples/.codebuddy/skills/use-og-form-table/SKILL.md +4 -3
- package/templates/current/examples/.codebuddy/skills/use-og-search/SKILL.md +3 -3
- package/templates/current/examples/.codebuddy/skills/use-og-table/SKILL.md +16 -10
- package/templates/current/examples/.codebuddy/skills/use-og-upload/SKILL.md +6 -5
- package/templates/current/examples/.codex/AGENTS.md +55 -8
- package/templates/current/examples/.codex/rules/01-feature-architecture.md +2 -2
- package/templates/current/examples/.codex/rules/03-component-policy.md +4 -1
- package/templates/current/examples/.cursor/rules/.generated +5 -0
- package/templates/current/examples/.cursor/rules/01-feature-architecture.mdc +2 -2
- package/templates/current/examples/.cursor/rules/03-component-policy.mdc +4 -1
- package/templates/current/examples/.cursor/skills/admin-component-usage/SKILL.md +28 -0
- package/templates/current/examples/.cursor/skills/admin-component-usage/references/component-directory.md +270 -0
- package/templates/current/examples/.cursor/skills/build-admin-feature/SKILL.md +11 -5
- package/templates/current/examples/.cursor/skills/build-admin-feature/references/component-selection.md +38 -0
- package/templates/current/examples/.cursor/skills/use-og-form/SKILL.md +1 -1
- package/templates/current/examples/.cursor/skills/use-og-form-table/SKILL.md +4 -3
- package/templates/current/examples/.cursor/skills/use-og-search/SKILL.md +3 -3
- package/templates/current/examples/.cursor/skills/use-og-table/SKILL.md +16 -10
- package/templates/current/examples/.cursor/skills/use-og-upload/SKILL.md +6 -5
- package/templates/current/examples/{.env.example → .env.dev} +3 -2
- package/templates/current/examples/.env.mock +4 -0
- package/templates/current/examples/.env.production +5 -0
- package/templates/current/examples/.env.test +4 -0
- package/templates/current/examples/.prettierignore +17 -0
- package/templates/current/examples/.prettierrc +8 -0
- package/templates/current/examples/.qoder/rules/01-feature-architecture.md +3 -4
- package/templates/current/examples/.qoder/rules/02-vue-typescript.md +1 -2
- package/templates/current/examples/.qoder/rules/03-component-policy.md +5 -3
- package/templates/current/examples/.qoder/rules/04-api-auth-router.md +1 -2
- package/templates/current/examples/.qoder/rules/05-style.md +1 -2
- package/templates/current/examples/.qoder/rules/06-quality.md +1 -2
- package/templates/current/examples/.qoder/skills/admin-component-usage/SKILL.md +28 -0
- package/templates/current/examples/.qoder/skills/admin-component-usage/references/component-directory.md +270 -0
- package/templates/current/examples/.qoder/skills/build-admin-feature/SKILL.md +11 -5
- package/templates/current/examples/.qoder/skills/build-admin-feature/references/component-selection.md +38 -0
- package/templates/current/examples/.qoder/skills/use-og-form/SKILL.md +1 -1
- package/templates/current/examples/.qoder/skills/use-og-form-table/SKILL.md +4 -3
- package/templates/current/examples/.qoder/skills/use-og-search/SKILL.md +3 -3
- package/templates/current/examples/.qoder/skills/use-og-table/SKILL.md +16 -10
- package/templates/current/examples/.qoder/skills/use-og-upload/SKILL.md +6 -5
- package/templates/current/examples/.zcode/skills/admin-component-usage/SKILL.md +28 -0
- package/templates/current/examples/.zcode/skills/admin-component-usage/references/component-directory.md +270 -0
- package/templates/current/examples/.zcode/skills/build-admin-feature/SKILL.md +20 -0
- package/templates/current/examples/.zcode/skills/build-admin-feature/references/component-selection.md +38 -0
- package/templates/current/examples/.zcode/skills/style-og-origen-ui/SKILL.md +11 -0
- package/templates/current/examples/.zcode/skills/use-og-dialog/SKILL.md +12 -0
- package/templates/current/examples/.zcode/skills/use-og-editor/SKILL.md +25 -0
- package/templates/current/examples/.zcode/skills/use-og-form/SKILL.md +12 -0
- package/templates/current/examples/.zcode/skills/use-og-form-table/SKILL.md +26 -0
- package/templates/current/examples/.zcode/skills/use-og-http/SKILL.md +13 -0
- package/templates/current/examples/.zcode/skills/use-og-router-tabs/SKILL.md +11 -0
- package/templates/current/examples/.zcode/skills/use-og-search/SKILL.md +14 -0
- package/templates/current/examples/.zcode/skills/use-og-table/SKILL.md +22 -0
- package/templates/current/examples/.zcode/skills/use-og-upload/SKILL.md +26 -0
- package/templates/current/examples/AGENTS.md +55 -9
- package/templates/current/examples/CHANGELOG.md +107 -0
- package/templates/current/examples/CLAUDE.md +3 -0
- package/templates/current/examples/README.md +58 -88
- package/templates/current/examples/component-catalog.json +766 -348
- package/templates/current/examples/component-catalog.v2.json +2040 -0
- package/templates/current/examples/docs/components/dialog.md +405 -0
- package/templates/current/examples/docs/components/editor-viewer.md +87 -0
- package/templates/current/examples/docs/components/editor.md +275 -0
- package/templates/current/examples/docs/components/form-table.md +222 -0
- package/templates/current/examples/docs/components/form.md +750 -0
- package/templates/current/examples/docs/components/index.md +44 -0
- package/templates/current/examples/docs/components/router.md +452 -0
- package/templates/current/examples/docs/components/search.md +1205 -0
- package/templates/current/examples/docs/components/svg-icon.md +124 -0
- package/templates/current/examples/docs/components/table-local.md +176 -0
- package/templates/current/examples/docs/components/table-with-search.md +207 -0
- package/templates/current/examples/docs/components/table.md +813 -0
- package/templates/current/examples/docs/components/tabs.md +440 -0
- package/templates/current/examples/docs/components/upload.md +349 -0
- package/templates/current/examples/eslint.config.js +89 -0
- package/templates/current/examples/index.html +1 -1
- package/templates/current/examples/openapi.json +10048 -999
- package/templates/current/examples/package.json +45 -33
- package/templates/current/examples/playwright.config.ts +20 -6
- package/templates/current/examples/playwright.mock.config.ts +42 -0
- package/templates/current/examples/pnpm-workspace.yaml +19 -3
- package/templates/current/examples/recipes/remote-crud-dialog-form.vue +15 -13
- package/templates/current/examples/scaffold.lock.json +164 -4
- package/templates/current/examples/scripts/api-codegen.config.ts +35 -0
- package/templates/current/examples/scripts/api-codegen.ts +2015 -0
- package/templates/current/examples/scripts/api-templates/http-client.ejs +359 -0
- package/templates/current/examples/scripts/check-admin-scaffold.mjs +311 -17
- package/templates/current/examples/scripts/generate-api.ts +290 -85
- package/templates/current/examples/scripts/lib/admin-component-catalog.mjs +515 -0
- package/templates/current/examples/scripts/lib/repository-root.mjs +9 -0
- package/templates/current/examples/scripts/mock-api.ts +1356 -0
- package/templates/current/examples/scripts/remove-examples.mjs +9 -34
- package/templates/current/examples/src/App.vue +9 -18
- package/templates/current/examples/src/api/generated/data-contracts.ts +23 -265
- package/templates/current/examples/src/api/generated/http-client.ts +351 -180
- package/templates/current/examples/src/api/generated/index.ts +22 -0
- package/templates/current/examples/src/api/generated/services/auth.ts +123 -0
- package/templates/current/examples/src/api/generated/services/common/files.ts +111 -0
- package/templates/current/examples/src/api/generated/services/monitor/cache.ts +164 -0
- package/templates/current/examples/src/api/generated/services/monitor/job.ts +195 -0
- package/templates/current/examples/src/api/generated/services/monitor/jobLog.ts +126 -0
- package/templates/current/examples/src/api/generated/services/monitor/logininfor.ts +126 -0
- package/templates/current/examples/src/api/generated/services/monitor/online.ts +66 -0
- package/templates/current/examples/src/api/generated/services/monitor/operlog.ts +106 -0
- package/templates/current/examples/src/api/generated/services/monitor/server.ts +41 -0
- package/templates/current/examples/src/api/generated/services/system/configs.ts +190 -0
- package/templates/current/examples/src/api/generated/services/system/departments.ts +173 -0
- package/templates/current/examples/src/api/generated/services/system/dictionaries/data.ts +169 -0
- package/templates/current/examples/src/api/generated/services/system/dictionaries/types.ts +187 -0
- package/templates/current/examples/src/api/generated/services/system/index.ts +158 -0
- package/templates/current/examples/src/api/generated/services/system/menus.ts +193 -0
- package/templates/current/examples/src/api/generated/services/system/notices.ts +221 -0
- package/templates/current/examples/src/api/generated/services/system/posts.ts +168 -0
- package/templates/current/examples/src/api/generated/services/system/roles.ts +354 -0
- package/templates/current/examples/src/api/generated/services/system/users.ts +425 -0
- package/templates/current/examples/src/api/generated/services/tool/code-generator.ts +304 -0
- package/templates/current/examples/src/api/generated/types/auth.types.ts +132 -0
- package/templates/current/examples/src/api/generated/types/common/files.types.ts +57 -0
- package/templates/current/examples/src/api/generated/types/common.ts +174 -0
- package/templates/current/examples/src/api/generated/types/enum-dict.ts +94 -0
- package/templates/current/examples/src/api/generated/types/enums.ts +155 -0
- package/templates/current/examples/src/api/generated/types/monitor/cache.types.ts +149 -0
- package/templates/current/examples/src/api/generated/types/monitor/job.types.ts +207 -0
- package/templates/current/examples/src/api/generated/types/monitor/jobLog.types.ts +134 -0
- package/templates/current/examples/src/api/generated/types/monitor/logininfor.types.ts +135 -0
- package/templates/current/examples/src/api/generated/types/monitor/online.types.ts +80 -0
- package/templates/current/examples/src/api/generated/types/monitor/operlog.types.ts +126 -0
- package/templates/current/examples/src/api/generated/types/monitor/server.types.ts +205 -0
- package/templates/current/examples/src/api/generated/types/system/configs.types.ts +200 -0
- package/templates/current/examples/src/api/generated/types/system/departments.types.ts +145 -0
- package/templates/current/examples/src/api/generated/types/system/dictionaries/data.types.ts +210 -0
- package/templates/current/examples/src/api/generated/types/system/dictionaries/types.types.ts +221 -0
- package/templates/current/examples/src/api/generated/types/system/index.types.ts +19 -0
- package/templates/current/examples/src/api/generated/types/system/menus.types.ts +234 -0
- package/templates/current/examples/src/api/generated/types/system/notices.types.ts +270 -0
- package/templates/current/examples/src/api/generated/types/system/posts.types.ts +198 -0
- package/templates/current/examples/src/api/generated/types/system/roles.types.ts +410 -0
- package/templates/current/examples/src/api/generated/types/system/users.types.ts +413 -0
- package/templates/current/examples/src/api/generated/types/tool/code-generator.types.ts +388 -0
- package/templates/current/examples/src/api/index.ts +44 -39
- package/templates/current/examples/src/app/__tests__/api-generated.types.ts +24 -0
- package/templates/current/examples/src/app/api.ts +6 -0
- package/templates/current/examples/src/app/authorization/permission.ts +9 -0
- package/templates/current/{clean/src/app → examples/src/app/config}/runtimeConfig.ts +44 -12
- package/templates/current/examples/src/app/errors/errorMessage.ts +80 -0
- package/templates/current/examples/src/app/http/client.ts +141 -0
- package/templates/current/examples/src/app/http/http-adapter.ts +71 -0
- package/templates/current/{clean/src/app → examples/src/app/i18n}/adminLocale.ts +25 -19
- package/templates/current/examples/src/app/{localeFormat.ts → i18n/localeFormat.ts} +29 -6
- package/templates/current/examples/src/app/i18n/origenUiLocale.ts +15 -0
- package/templates/current/examples/src/app/menu/menu.ts +175 -0
- package/templates/current/examples/src/app/menu/menuTypes.ts +20 -0
- package/templates/current/examples/src/{features → app}/security/devtoolsProtection.ts +8 -7
- package/templates/current/examples/src/app/ui/createAdminUi.ts +31 -0
- package/templates/current/examples/src/app/ui/iconCatalog.ts +71 -0
- package/templates/current/examples/src/assets/icons/appearance.svg +1 -0
- package/templates/current/examples/src/assets/icons/arrow-right.svg +1 -0
- package/templates/current/examples/src/assets/icons/check.svg +1 -0
- package/templates/current/examples/src/assets/icons/circle-check.svg +1 -0
- package/templates/current/examples/src/assets/icons/default.svg +4 -0
- package/templates/current/examples/src/assets/icons/directory/setting.svg +1 -0
- package/templates/current/examples/src/assets/icons/expand.svg +1 -0
- package/templates/current/examples/src/assets/icons/fold.svg +1 -0
- package/templates/current/examples/src/assets/icons/key.svg +1 -0
- package/templates/current/examples/src/assets/icons/lock.svg +1 -0
- package/templates/current/examples/src/assets/icons/monitor.svg +1 -0
- package/templates/current/examples/src/assets/icons/moon.svg +11 -0
- package/templates/current/examples/src/assets/icons/page/department.svg +1 -0
- package/templates/current/examples/src/assets/icons/page/dictionary.svg +1 -0
- package/templates/current/examples/src/assets/icons/page/menus.svg +1 -0
- package/templates/current/examples/src/assets/icons/page/user.svg +1 -0
- package/templates/current/examples/src/assets/icons/page/users.svg +1 -0
- package/templates/current/examples/src/assets/icons/plus.svg +1 -0
- package/templates/current/examples/src/assets/icons/profile.svg +1 -0
- package/templates/current/examples/src/assets/icons/refresh.svg +1 -0
- package/templates/current/examples/src/assets/icons/roles.svg +1 -0
- package/templates/current/examples/src/assets/icons/search.svg +1 -0
- package/templates/current/examples/src/assets/icons/sunny.svg +1 -0
- package/templates/current/examples/src/assets/icons/system.svg +1 -0
- package/templates/current/examples/src/assets/icons/theme-auto.svg +14 -0
- package/templates/current/examples/src/assets/icons/tune.svg +13 -0
- package/templates/current/examples/src/{features/shell/components → components}/RouteProgress.vue +2 -2
- package/templates/current/{clean/src/features/system/access → examples/src}/composables/useAuthorizationRefresh.ts +6 -1
- package/templates/current/examples/src/composables/useSystemTableSearchVisibility.ts +33 -0
- package/templates/current/examples/src/{features/appearance/composables → composables}/useTheme.ts +1 -1
- package/templates/current/examples/src/env.d.ts +6 -19
- package/templates/current/examples/src/layouts/AdminLayout.vue +7 -9
- package/templates/current/examples/src/{features/shell/components → layouts}/AdminWatermark.vue +2 -2
- package/templates/current/examples/src/layouts/BreadcrumbBar.vue +9 -1
- package/templates/current/examples/src/layouts/SideMenu.vue +7 -15
- package/templates/current/examples/src/{features/appearance/components → layouts}/ThemePanel.vue +39 -11
- package/templates/current/examples/src/layouts/TopBar.vue +60 -28
- package/templates/current/examples/src/layouts/WorkspaceTabs.vue +10 -1
- package/templates/current/examples/src/layouts/topBarMenuSearch.ts +25 -4
- package/templates/current/examples/src/locales/en-US.json +227 -219
- package/templates/current/examples/src/locales/index.ts +72 -32
- package/templates/current/examples/src/locales/messages-types.ts +15 -10
- package/templates/current/examples/src/locales/vue-i18n.d.ts +1 -1
- package/templates/current/examples/src/locales/zh-CN.json +226 -218
- package/templates/current/examples/src/locales/zh-TW.json +222 -214
- package/templates/current/examples/src/main.ts +50 -40
- package/templates/current/examples/src/router/bootstrap.ts +69 -24
- package/templates/current/examples/src/router/dynamic/componentLoader.ts +150 -0
- package/templates/current/examples/src/router/{dynamicMenuRefresh.ts → dynamic/dynamicMenuRefresh.ts} +6 -2
- package/templates/current/examples/src/router/dynamic/dynamicRoutes.ts +247 -0
- package/templates/current/examples/src/router/navigation/guards.ts +12 -0
- package/templates/current/examples/src/router/navigation/paths.ts +28 -0
- package/templates/current/examples/src/router/navigation/staticRoutes.ts +109 -0
- package/templates/current/examples/src/router/{queryEncryption.ts → query/queryEncryption.ts} +29 -12
- package/templates/current/examples/src/router/query/routeQuery.ts +29 -0
- package/templates/current/examples/src/router/{useRouteQueryDefaults.ts → query/useRouteQueryDefaults.ts} +9 -8
- package/templates/current/examples/src/router/query/useRouteQueryDefaults.types.ts +28 -0
- package/templates/current/examples/src/router/{runtimeErrorRecovery.ts → recovery/runtimeErrorRecovery.ts} +21 -3
- package/templates/current/examples/src/{features/auth/store → store}/auth.ts +96 -61
- package/templates/current/examples/src/store/dictionaries.ts +86 -0
- package/templates/current/examples/src/{features/shell/store → store}/sidebar.ts +9 -2
- package/templates/current/{clean/src/features/appearance → examples/src}/store/theme.ts +8 -4
- package/templates/current/examples/src/styles/layout.css +51 -0
- package/templates/current/examples/src/templates/og-form.ts +7 -2
- package/templates/current/examples/src/templates/og-table.ts +88 -20
- package/templates/current/examples/src/templates/router.ts +11 -2
- package/templates/current/examples/src/utils/color-mix.ts +6 -2
- package/templates/current/examples/src/utils/download.ts +11 -0
- package/templates/current/examples/src/utils/permissions.ts +1 -1
- package/templates/current/examples/src/utils/retryableDialog.ts +46 -0
- package/templates/current/{clean/scripts/clean-overlay/src/features → examples/src/views}/errors/pages/Forbidden.vue +6 -2
- package/templates/current/examples/src/views/errors/pages/MethodNotAllowed.vue +34 -0
- package/templates/current/examples/{scripts/clean-overlay/src/features → src/views}/errors/pages/NotFound.vue +6 -2
- package/templates/current/examples/{scripts/clean-overlay/src/features → src/views}/errors/pages/ServerError.vue +6 -2
- package/templates/current/examples/src/{features/auth/pages/Login.vue → views/login/pages/index.vue} +99 -10
- package/templates/current/examples/src/views/system/access/services/admin-repository.ts +489 -0
- package/templates/current/examples/src/views/system/access/services/rbac.ts +317 -0
- package/templates/current/examples/src/views/system/dept/components/DepartmentEditorForm.vue +87 -0
- package/templates/current/examples/src/views/system/dept/composables/useDepartmentManagement.ts +314 -0
- package/templates/current/examples/src/views/system/dept/pages/index.vue +44 -0
- package/templates/current/examples/src/views/system/dept/services/departments.ts +168 -0
- package/templates/current/examples/src/views/system/dict/components/DictionaryDataEditorForm.vue +98 -0
- package/templates/current/examples/src/views/system/dict/components/DictionaryDataPreview.vue +233 -0
- package/templates/current/examples/src/views/system/dict/components/DictionaryTypeEditorForm.vue +66 -0
- package/templates/current/examples/src/views/system/dict/composables/useDictionaryDataManagement.ts +406 -0
- package/templates/current/examples/src/views/system/dict/composables/useDictionaryTypeManagement.ts +329 -0
- package/templates/current/examples/src/views/system/dict/data/pages/index.vue +134 -0
- package/templates/current/examples/src/views/system/dict/pages/index.vue +113 -0
- package/templates/current/examples/src/views/system/dict/services/dictionaries.ts +239 -0
- package/templates/current/examples/src/views/system/menu/components/MenuEditorForm.vue +252 -0
- package/templates/current/examples/src/views/system/menu/composables/useMenuManagement.ts +357 -0
- package/templates/current/examples/src/views/system/menu/menuDraft.ts +45 -0
- package/templates/current/examples/src/views/system/menu/pages/ExternalLink.vue +37 -0
- package/templates/current/examples/src/views/system/menu/pages/index.vue +75 -0
- package/templates/current/examples/src/views/system/post/components/PostEditorForm.vue +69 -0
- package/templates/current/examples/src/views/system/post/composables/usePostManagement.ts +245 -0
- package/templates/current/examples/src/views/system/post/pages/index.vue +92 -0
- package/templates/current/examples/src/views/system/post/services/posts.ts +100 -0
- package/templates/current/examples/src/views/system/role/auth-users/pages/index.vue +100 -0
- package/templates/current/examples/src/views/system/role/components/RoleDataScopeForm.vue +167 -0
- package/templates/current/examples/src/views/system/role/components/RoleEditorForm.vue +165 -0
- package/templates/current/examples/src/views/system/role/components/RoleUserSelectForm.vue +129 -0
- package/templates/current/examples/src/views/system/role/composables/useRoleManagement.ts +422 -0
- package/templates/current/examples/src/views/system/role/composables/useRoleUserManagement.ts +233 -0
- package/templates/current/examples/src/views/system/role/pages/index.vue +110 -0
- package/templates/current/examples/src/views/system/role/services/roleAccess.ts +162 -0
- package/templates/current/examples/src/views/system/user/auth-roles/pages/index.vue +209 -0
- package/templates/current/examples/src/views/system/user/components/UserDetailsForm.vue +108 -0
- package/templates/current/examples/src/views/system/user/components/UserEditorForm.vue +207 -0
- package/templates/current/examples/src/views/system/user/components/UserImportDialog.vue +80 -0
- package/templates/current/examples/src/views/system/user/components/UserResetPasswordForm.vue +56 -0
- package/templates/current/examples/src/views/system/user/composables/useUserManagement.ts +502 -0
- package/templates/current/examples/src/views/system/user/pages/index.vue +459 -0
- package/templates/current/examples/tests/e2e/admin-access-business.spec.ts +33 -0
- package/templates/current/examples/tests/e2e/admin-shell.spec.ts +50 -0
- package/templates/current/examples/tests/e2e/fixtures/adminMockBackend.ts +95 -0
- package/templates/current/examples/tests/e2e/fixtures/labelGeometry.ts +52 -0
- package/templates/current/examples/tests/e2e/mock-api-generation.spec.ts +27 -0
- package/templates/current/examples/tests/e2e/mock-business.spec.ts +555 -0
- package/templates/current/examples/tests/e2e/mock-menu-retry-form-label.spec.ts +100 -0
- package/templates/current/examples/tests/e2e/mock-shell.spec.ts +25 -0
- package/templates/current/examples/tests/e2e/mock-tree-selection-layout.spec.ts +113 -0
- package/templates/current/examples/tests/unit/api/api-codegen.spec.ts +893 -0
- package/templates/current/examples/tests/unit/api/client.spec.ts +145 -0
- package/templates/current/examples/tests/unit/api/generated-http-client.spec.ts +290 -0
- package/templates/current/{clean/src → examples/tests/unit}/api/http-adapter.spec.ts +3 -3
- package/templates/current/examples/tests/unit/api/system-apis.spec.ts +118 -0
- package/templates/current/examples/tests/unit/app/createAdminUi.spec.ts +79 -0
- package/templates/current/examples/{src → tests/unit}/app/errorMessage.spec.ts +1 -1
- package/templates/current/examples/tests/unit/app/iconCatalog.spec.ts +12 -0
- package/templates/current/examples/tests/unit/app/menu.spec.ts +215 -0
- package/templates/current/{clean/src → examples/tests/unit}/app/origenUiLocale.spec.ts +1 -1
- package/templates/current/{clean/src → examples/tests/unit}/app/permission.spec.ts +4 -5
- package/templates/current/examples/tests/unit/app/runtimeConfig.spec.ts +36 -0
- package/templates/current/{clean/src/features → examples/tests/unit/app}/security/devtoolsProtection.spec.ts +17 -7
- package/templates/current/{clean/src/features/shell → examples/tests/unit}/composables/useRouteProgress.spec.ts +1 -1
- package/templates/current/{clean/src/features/shell/components → examples/tests/unit/layouts}/AdminWatermark.spec.ts +5 -7
- package/templates/current/{clean/src → examples/tests/unit}/layouts/topBarMenuSearch.spec.ts +25 -8
- package/templates/current/examples/{src → tests/unit}/locales/messages.spec.ts +43 -17
- package/templates/current/examples/tests/unit/router/dynamicMenuRefresh.spec.ts +151 -0
- package/templates/current/examples/tests/unit/router/dynamicRoutes.spec.ts +374 -0
- package/templates/current/examples/tests/unit/router/paths.spec.ts +103 -0
- package/templates/current/examples/{src → tests/unit}/router/queryEncryption.spec.ts +49 -12
- package/templates/current/{clean/src → examples/tests/unit}/router/routeQuery.spec.ts +8 -1
- package/templates/current/examples/{src → tests/unit}/router/runtimeErrorRecovery.spec.ts +11 -6
- package/templates/current/{clean/src → examples/tests/unit}/router/useRouteQueryDefaults.spec.ts +46 -12
- package/templates/current/examples/tests/unit/scripts/mock-api.spec.ts +440 -0
- package/templates/current/examples/{scripts → tests/unit/scripts}/vite-build-policy.spec.ts +35 -6
- package/templates/current/examples/{src/features/auth → tests/unit}/store/auth.spec.ts +68 -15
- package/templates/current/examples/tests/unit/store/dictionaries.spec.ts +106 -0
- package/templates/current/{clean/src → examples/tests/unit}/templates/templates.spec.ts +60 -16
- package/templates/current/examples/{src/utils/__tests__ → tests/unit/utils}/color-mix.spec.ts +1 -1
- package/templates/current/examples/tests/unit/utils/retryableDialog.spec.ts +61 -0
- package/templates/current/examples/{scripts/clean-overlay/src/features/errors/pages → tests/unit/views/errors}/error-pages.spec.ts +12 -9
- package/templates/current/examples/tests/unit/views/feature-composables.spec.ts +233 -0
- package/templates/current/examples/tests/unit/views/system/access/admin-repository.spec.ts +353 -0
- package/templates/current/examples/tests/unit/views/system/access/rbac.spec.ts +329 -0
- package/templates/current/examples/tests/unit/views/system/dept/departments.spec.ts +104 -0
- package/templates/current/examples/tests/unit/views/system/dict/dictionaries.spec.ts +234 -0
- package/templates/current/examples/tests/unit/views/system/menu/menuDraft.spec.ts +77 -0
- package/templates/current/examples/tests/unit/views/system/menu/useMenuManagement.spec.ts +339 -0
- package/templates/current/examples/tests/unit/views/system/user/searchControl.spec.ts +128 -0
- package/templates/current/examples/tsconfig.json +4 -19
- package/templates/current/examples/vite.build-policy.ts +97 -22
- package/templates/current/examples/vite.config.ts +50 -7
- package/templates/current/clean/.codebuddy/AGENTS.md +0 -18
- package/templates/current/clean/.codex/skills/build-admin-feature/SKILL.md +0 -14
- package/templates/current/clean/.codex/skills/build-admin-feature/references/component-selection.md +0 -25
- package/templates/current/clean/.codex/skills/use-og-table/SKILL.md +0 -16
- package/templates/current/clean/.cursor/AGENTS.md +0 -18
- package/templates/current/clean/.env.production.example +0 -31
- package/templates/current/clean/.qoder/AGENTS.md +0 -15
- package/templates/current/clean/e2e/admin-shell.spec.ts +0 -156
- package/templates/current/clean/e2e/demo-shell.spec.ts +0 -372
- package/templates/current/clean/playwright.demo.config.ts +0 -25
- package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/NotFound.vue +0 -31
- package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/ServerError.vue +0 -31
- package/templates/current/clean/scripts/clean-overlay/src/features/errors/pages/error-pages.spec.ts +0 -41
- package/templates/current/clean/scripts/clean-overlay/src/main.ts +0 -100
- package/templates/current/clean/scripts/clean-overlay/src/router/componentCache.ts +0 -12
- package/templates/current/clean/scripts/clean-overlay/src/router/componentRegistry.ts +0 -14
- package/templates/current/clean/scripts/clean-overlay/src/router/dynamicRoutes.spec.ts +0 -77
- package/templates/current/clean/scripts/clean-overlay/src/router/paths.ts +0 -21
- package/templates/current/clean/scripts/clean-overlay/src/router/staticRoutes.ts +0 -63
- package/templates/current/clean/scripts/demo-api.ts +0 -873
- package/templates/current/clean/src/api/client.spec.ts +0 -66
- package/templates/current/clean/src/api/client.ts +0 -152
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/templates/current/clean/src/api/generated//350/256/244/350/257/201.ts +0 -95
- package/templates/current/clean/src/api/http-adapter.ts +0 -83
- package/templates/current/clean/src/app/createAdminUi.spec.ts +0 -166
- package/templates/current/clean/src/app/createAdminUi.ts +0 -63
- package/templates/current/clean/src/app/embedded-token.spec.ts +0 -40
- package/templates/current/clean/src/app/embedded.spec.ts +0 -135
- package/templates/current/clean/src/app/embedded.ts +0 -255
- package/templates/current/clean/src/app/errorMessage.ts +0 -53
- package/templates/current/clean/src/app/menu-host.spec.ts +0 -77
- package/templates/current/clean/src/app/menu.spec.ts +0 -320
- package/templates/current/clean/src/app/menu.ts +0 -308
- package/templates/current/clean/src/app/menuTypes.ts +0 -18
- package/templates/current/clean/src/app/origenUiLocale.ts +0 -10
- package/templates/current/clean/src/app/permission.ts +0 -9
- package/templates/current/clean/src/demo-api.spec.ts +0 -478
- package/templates/current/clean/src/features/errors/pages/error-pages.spec.ts +0 -41
- package/templates/current/clean/src/features/system/access/api/admin-repository.spec.ts +0 -14
- package/templates/current/clean/src/features/system/access/api/admin-repository.ts +0 -298
- package/templates/current/clean/src/features/system/access/api/rbac.spec.ts +0 -72
- package/templates/current/clean/src/features/system/access/api/rbac.ts +0 -292
- package/templates/current/clean/src/features/system/access/composables/useAuthorizationPolling.spec.ts +0 -134
- package/templates/current/clean/src/features/system/access/composables/useAuthorizationPolling.ts +0 -96
- package/templates/current/clean/src/features/workspace/pages/Profile.vue +0 -185
- package/templates/current/clean/src/router/componentCache.ts +0 -12
- package/templates/current/clean/src/router/componentRegistry.ts +0 -14
- package/templates/current/clean/src/router/dynamicMenuRefresh.spec.ts +0 -101
- package/templates/current/clean/src/router/dynamicRoutes.spec.ts +0 -77
- package/templates/current/clean/src/router/dynamicRoutes.ts +0 -177
- package/templates/current/clean/src/router/guards.ts +0 -5
- package/templates/current/clean/src/router/paths.spec.ts +0 -50
- package/templates/current/clean/src/router/paths.ts +0 -21
- package/templates/current/clean/src/router/routeQuery.ts +0 -6
- package/templates/current/clean/src/router/staticRoutes.ts +0 -63
- package/templates/current/clean/src/router/useRouteQueryDefaults.types.ts +0 -20
- package/templates/current/examples/.codebuddy/AGENTS.md +0 -18
- package/templates/current/examples/.codex/skills/build-admin-feature/SKILL.md +0 -14
- package/templates/current/examples/.codex/skills/build-admin-feature/references/component-selection.md +0 -25
- package/templates/current/examples/.codex/skills/use-og-table/SKILL.md +0 -16
- package/templates/current/examples/.cursor/AGENTS.md +0 -18
- package/templates/current/examples/.env.production.example +0 -31
- package/templates/current/examples/.qoder/AGENTS.md +0 -15
- package/templates/current/examples/e2e/admin-shell.spec.ts +0 -156
- package/templates/current/examples/e2e/demo-shell.spec.ts +0 -372
- package/templates/current/examples/playwright.demo.config.ts +0 -25
- package/templates/current/examples/scripts/clean-overlay/src/features/errors/pages/Forbidden.vue +0 -31
- package/templates/current/examples/scripts/clean-overlay/src/main.ts +0 -100
- package/templates/current/examples/scripts/clean-overlay/src/router/componentCache.ts +0 -12
- package/templates/current/examples/scripts/clean-overlay/src/router/componentRegistry.ts +0 -14
- package/templates/current/examples/scripts/clean-overlay/src/router/dynamicRoutes.spec.ts +0 -77
- package/templates/current/examples/scripts/clean-overlay/src/router/paths.ts +0 -21
- package/templates/current/examples/scripts/clean-overlay/src/router/staticRoutes.ts +0 -63
- package/templates/current/examples/scripts/demo-api.ts +0 -873
- package/templates/current/examples/src/api/client.spec.ts +0 -66
- package/templates/current/examples/src/api/client.ts +0 -152
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/templates/current/examples/src/api/generated//350/256/244/350/257/201.ts +0 -95
- package/templates/current/examples/src/api/http-adapter.ts +0 -83
- package/templates/current/examples/src/app/createAdminUi.spec.ts +0 -166
- package/templates/current/examples/src/app/createAdminUi.ts +0 -63
- package/templates/current/examples/src/app/embedded-token.spec.ts +0 -40
- package/templates/current/examples/src/app/embedded.spec.ts +0 -135
- package/templates/current/examples/src/app/embedded.ts +0 -255
- package/templates/current/examples/src/app/errorMessage.ts +0 -53
- package/templates/current/examples/src/app/menu-host.spec.ts +0 -77
- package/templates/current/examples/src/app/menu.spec.ts +0 -320
- package/templates/current/examples/src/app/menu.ts +0 -308
- package/templates/current/examples/src/app/menuTypes.ts +0 -18
- package/templates/current/examples/src/app/origenUiLocale.ts +0 -10
- package/templates/current/examples/src/app/permission.ts +0 -9
- package/templates/current/examples/src/demo-api.spec.ts +0 -478
- package/templates/current/examples/src/features/errors/pages/Forbidden.vue +0 -31
- package/templates/current/examples/src/features/errors/pages/NotFound.vue +0 -31
- package/templates/current/examples/src/features/errors/pages/ServerError.vue +0 -31
- package/templates/current/examples/src/features/feature-composables.spec.ts +0 -245
- package/templates/current/examples/src/features/system/access/api/admin-repository.spec.ts +0 -14
- package/templates/current/examples/src/features/system/access/api/admin-repository.ts +0 -298
- package/templates/current/examples/src/features/system/access/api/rbac.spec.ts +0 -72
- package/templates/current/examples/src/features/system/access/api/rbac.ts +0 -292
- package/templates/current/examples/src/features/system/access/composables/useAuthorizationPolling.spec.ts +0 -134
- package/templates/current/examples/src/features/system/access/composables/useAuthorizationPolling.ts +0 -96
- package/templates/current/examples/src/features/system/audit/composables/useAuditManagement.ts +0 -122
- package/templates/current/examples/src/features/system/audit/pages/AuditList.vue +0 -20
- package/templates/current/examples/src/features/system/menus/components/MenuEditorForm.vue +0 -279
- package/templates/current/examples/src/features/system/menus/composables/useMenuManagement.ts +0 -435
- package/templates/current/examples/src/features/system/menus/menuDraft.spec.ts +0 -204
- package/templates/current/examples/src/features/system/menus/menuDraft.ts +0 -116
- package/templates/current/examples/src/features/system/menus/menuTreePrecheck.spec.ts +0 -268
- package/templates/current/examples/src/features/system/menus/menuTreePrecheck.ts +0 -317
- package/templates/current/examples/src/features/system/menus/pages/MenuList.vue +0 -51
- package/templates/current/examples/src/features/system/roles/components/RoleEditorForm.vue +0 -116
- package/templates/current/examples/src/features/system/roles/composables/useRoleManagement.ts +0 -194
- package/templates/current/examples/src/features/system/roles/pages/RoleList.vue +0 -47
- package/templates/current/examples/src/features/system/users/components/UserEditorForm.vue +0 -104
- package/templates/current/examples/src/features/system/users/composables/useUserManagement.ts +0 -228
- package/templates/current/examples/src/features/system/users/pages/UserList.vue +0 -51
- package/templates/current/examples/src/features/workspace/pages/Dashboard.spec.ts +0 -41
- package/templates/current/examples/src/features/workspace/pages/Dashboard.vue +0 -325
- package/templates/current/examples/src/features/workspace/pages/Profile.vue +0 -185
- package/templates/current/examples/src/router/componentCache.ts +0 -18
- package/templates/current/examples/src/router/componentRegistry.ts +0 -66
- package/templates/current/examples/src/router/dynamicMenuRefresh.spec.ts +0 -101
- package/templates/current/examples/src/router/dynamicRoutes.spec.ts +0 -144
- package/templates/current/examples/src/router/dynamicRoutes.ts +0 -177
- package/templates/current/examples/src/router/guards.ts +0 -5
- package/templates/current/examples/src/router/paths.spec.ts +0 -50
- package/templates/current/examples/src/router/paths.ts +0 -21
- package/templates/current/examples/src/router/routeQuery.ts +0 -6
- package/templates/current/examples/src/router/staticRoutes.ts +0 -63
- package/templates/current/examples/src/router/useRouteQueryDefaults.types.ts +0 -20
- /package/templates/current/clean/{.codex → .agents}/skills/style-og-origen-ui/SKILL.md +0 -0
- /package/templates/current/clean/{.codex → .agents}/skills/style-og-origen-ui/agents/openai.yaml +0 -0
- /package/templates/current/clean/{.codex → .agents}/skills/use-og-dialog/SKILL.md +0 -0
- /package/templates/current/clean/{.codex → .agents}/skills/use-og-dialog/agents/openai.yaml +0 -0
- /package/templates/current/clean/{.codex → .agents}/skills/use-og-editor/SKILL.md +0 -0
- /package/templates/current/clean/{.codex → .agents}/skills/use-og-http/SKILL.md +0 -0
- /package/templates/current/clean/{.codex → .agents}/skills/use-og-http/agents/openai.yaml +0 -0
- /package/templates/current/clean/{.codex → .agents}/skills/use-og-router-tabs/SKILL.md +0 -0
- /package/templates/current/{examples/.codex → clean/.claude}/skills/style-og-origen-ui/SKILL.md +0 -0
- /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-dialog/SKILL.md +0 -0
- /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-editor/SKILL.md +0 -0
- /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-http/SKILL.md +0 -0
- /package/templates/current/{examples/.codex → clean/.claude}/skills/use-og-router-tabs/SKILL.md +0 -0
- /package/templates/current/clean/src/{features/security/components → components}/DevtoolsProtectionOverlay.vue +0 -0
- /package/templates/current/clean/src/{features/shell/composables → composables}/useRouteProgress.ts +0 -0
- /package/templates/current/clean/src/{features/workspace → views/fallback}/pages/Empty.vue +0 -0
- /package/templates/current/examples/{.codex → .agents}/skills/style-og-origen-ui/agents/openai.yaml +0 -0
- /package/templates/current/examples/{.codex → .agents}/skills/use-og-dialog/agents/openai.yaml +0 -0
- /package/templates/current/examples/{.codex → .agents}/skills/use-og-http/agents/openai.yaml +0 -0
- /package/templates/current/examples/src/{features/security/components → components}/DevtoolsProtectionOverlay.vue +0 -0
- /package/templates/current/examples/src/{features/shell/composables → composables}/useRouteProgress.ts +0 -0
- /package/templates/current/examples/src/{features/workspace → views/fallback}/pages/Empty.vue +0 -0
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: 组件目录
|
|
3
|
+
description: 按任务场景检索 origen-ui 的公开 Vue 组件、调用参数和使用约束。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# 组件目录
|
|
7
|
+
|
|
8
|
+
本目录是 Admin 可消费公开 Vue 组件的统一清单。可按组件名、包名、场景和检索词搜索;每条记录包含公开导入入口、参数摘要、使用约束、版本状态、API 详页和示例入口。完整 API、默认值和调用细节以组件详页为准。
|
|
9
|
+
|
|
10
|
+
组件清单范围为 Admin 直接依赖包所公开导出的 Vue 组件。runtime、locale、工具函数及其他非 UI 导出属于配套能力,按对应组件文档说明,不单独列为 UI 组件。
|
|
11
|
+
|
|
12
|
+
<!-- component-catalog:start -->
|
|
13
|
+
|
|
14
|
+
| 组件 | 场景、用途与检索词 | 包 | 公开导入入口 | 参数 / API 摘要 | 使用约束 | 状态 / 包版本 | API 与示例 |
|
|
15
|
+
| ----------------- | ----------------------------------------------------- | ----------------------- | ------------------------------ | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------ |
|
|
16
|
+
| OgTable | 数据列表、远程 CRUD、分页、排序、权限、编辑、虚拟滚动 | @origen-ui/table | @origen-ui/table | OgTableProps:rowKey(按行级能力要求)、ogColumns、ogDataSource、ogConfig | 实例身份自动管理;仅远程纯展示且无行级能力时可省略 rowKey。 | 当前 · 3.0.1 | [API](./table.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
17
|
+
| OgTableLocal | 本地数据、草稿行、表单明细、小规模客户端编辑 | @origen-ui/table | @origen-ui/table | OgTableLocalProps:modelValue、rowKey、ogColumns | 父组件持有行数组;本地行操作需要 rowKey;不接收远程 ogDataSource。 | 当前 · 3.0.1 | [API](./table-local.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
18
|
+
| OgTableWithSearch | 表格加条件搜索、查询提交、搜索失败恢复 | @origen-ui/table-search | @origen-ui/table-search | OgTableWithSearchProps:OgTable 属性及 ogConfig.search.fields | 搜索字段使用 ogControl.ogType;其余表格请求、列和样式契约见 OgTable。 | 当前 · 3.0.1 | [API](./table-with-search.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
19
|
+
| OgSearch | 独立查询表单、筛选字段、关键字搜索、校验与重置 | @origen-ui/search | @origen-ui/search | OgSearchProps:modelValue、ogKeyword、ogConfig、search 事件 | 应用负责持有查询状态并处理提交后的请求;自定义控件需提供有效的 ogType。 | 当前 · 3.0.1 | [API](./search.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
20
|
+
| OgForm | Schema 表单、字段联动、校验、只读与动态配置 | @origen-ui/form | @origen-ui/form | OgFormProps:modelValue、ogSchema、ogColumns | 应用持有业务数据、提交与请求职责;字段渲染遵循表单上下文和公开 renderer 配置。 | 当前 · 3.0.1 | [API](./form.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
21
|
+
| FieldRenderer | 表单字段渲染、注册 renderer、扩展字段控件 | @origen-ui/form | @origen-ui/form | `ogField`(必填)、`ogReadonly`(默认 false)、`ogA11y` 可选。 | 仅在 OgForm 上下文中使用;一般页面优先通过 schema 配置字段。 | 当前 · 3.0.1 | [API](./form.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
22
|
+
| OgFormItem | 表单项布局、标签、校验与插槽组合 | @origen-ui/form | @origen-ui/form | `ogName`(必填)、`ogField`、`ogReadonly`(默认 false)、`ogLabelTip`;支持 FormItem 属性。 | 仅在 OgForm 上下文中使用;`ogName` 指定字段,错误与表单状态由 OgForm 控制。 | 当前 · 3.0.1 | [API](./form.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
23
|
+
| OgFormTable | 表单内可编辑明细表、网格编辑、单元格 schema | @origen-ui/form-table | @origen-ui/form-table | OgFormTableProps:modelValue、ogColumns、ogConfig | 通过公开表单字段适配器接入 OgForm;编辑和提交遵循表格与表单各自的数据所有权。 | 当前 · 3.0.1 | [API](./form-table.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
24
|
+
| OgUpload | 受控文件值、上传进度、失败恢复与文件列表 | @origen-ui/upload | @origen-ui/upload | OgUploadPropsDocumentation:modelValue、上传配置、值编解码与事件 | 应用提供上传适配器并定义业务文件值;组件不决定业务请求地址或权限。 | 当前 · 3.0.1 | [API](./upload.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
25
|
+
| SvgIcon | SVG 图标、图标尺寸与颜色、应用本地资源 | @origen-ui/icons | @origen-ui/icons | SvgIconProps:图标标识、尺寸、颜色及 SVG 属性 | 图标资源按项目图标注册和构建约定提供;完整样式入口见样式与主题文档。 | 当前 · 3.0.1 | [API](./svg-icon.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
26
|
+
| OgEditor | 富文本编辑、媒体上传、HTML 内容处理 | @origen-ui/editor | @origen-ui/editor | OgEditorProps:受控内容、编辑能力配置、上传与事件 | 应用负责配置媒体上传适配器及业务内容边界;展示已有内容时选用 OgEditorViewer。 | 当前 · 3.0.1 | [API](./editor.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
27
|
+
| OgEditorViewer | 富文本只读展示、空态与媒体布局 | @origen-ui/editor | @origen-ui/editor | OgEditorViewerProps:待展示内容及查看器配置 | 只读展示使用该组件;内容安全处理按组件详页和应用内容边界配置。 | 当前 · 3.0.1 | [API](./editor-viewer.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
28
|
+
| OgDialog | 对话框或抽屉、确认、编辑、关闭保护 | @origen-ui/dialog | @origen-ui/dialog | OgDialogProps:受控显示、展示配置、确认与关闭回调 | 应用决定业务提交和异步操作;命令式弹窗还需安装 manager 并挂载 OgDialogHost。 | 当前 · 3.0.1 | [API](./dialog.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
29
|
+
| OgDialogHost | 命令式弹窗宿主、DialogManager 挂载 | @origen-ui/dialog | @origen-ui/dialog | manager 可选;默认使用应用注入的 manager。 | 在应用根级挂载;使用前安装 createOgDialog(),或显式传入 DialogManager。 | 当前 · 3.0.1 | [API](./dialog.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
30
|
+
| OgTabs | 工作区标签、受控导航、关闭守卫与标签操作 | @origen-ui/tabs | @origen-ui/tabs | OgTabsProps:ogItems、modelValue、ogBeforeAction、actionRequest | 父组件决定是否接受标签和激活项变更;路由工作区集成可使用 RouterTabs。 | 当前 · 3.0.1 | [API](./tabs.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
31
|
+
| RouterViewHost | 路由视图、动态路由组件挂载、缓存视图 | @origen-ui/router | @origen-ui/router | cacheMax 可选,默认 10;限制 KeepAlive 缓存数量。 | 依赖 Vue Router 和应用提供的 router adapter;路由数据及后端 DTO 映射由应用负责。 | 当前 · 3.0.1 | [API](./router.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
32
|
+
| RouterBreadcrumb | Element Plus 面包屑、当前路由导航层级 | @origen-ui/router | @origen-ui/router/element-plus | RouterBreadcrumbProps:面包屑显示和 Element Plus 属性 | 需使用 Element Plus 预设子路径;菜单和路由元数据由 router adapter 提供。 | 当前 · 3.0.1 | [API](./router.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
33
|
+
| RouterMenu | Element Plus 菜单、路由菜单选择与导航 | @origen-ui/router | @origen-ui/router/element-plus | RouterMenuProps:菜单显示、路由选择及 Element Plus 属性 | 需使用 Element Plus 预设子路径;应用仍负责菜单 API、授权和业务 DTO 转换。 | 当前 · 3.0.1 | [API](./router.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
34
|
+
| RouterTabs | 路由工作区标签、页面缓存与路由联动 | @origen-ui/router | @origen-ui/router/tabs | RouterTabsProps:标签外观和导航展示配置 | 需使用 tabs 子路径并满足其 peer dependency;应用负责路由和工作区状态策略。 | 当前 · 3.0.1 | [API](./router.md#api) · [示例](../../.agents/skills/admin-component-usage/references/component-directory.md) |
|
|
35
|
+
|
|
36
|
+
<!-- component-catalog:end -->
|
|
37
|
+
|
|
38
|
+
## 配套能力
|
|
39
|
+
|
|
40
|
+
@origen-ui/http、@origen-ui/permission、@origen-ui/shared、@origen-ui/admin-cli 和 origen-ui 提供请求、权限、共享类型、脚手架或聚合资源等配套能力,不作为独立 UI 组件列入上表。配套能力与 Admin 消费边界见项目根目录的 `component-catalog.v2.json` 和组件使用技能。
|
|
41
|
+
|
|
42
|
+
## Admin 现有用法
|
|
43
|
+
|
|
44
|
+
Admin 系统管理页使用 `OgTableWithSearch`、`OgTable` 和 `OgForm` 实现列表、树形数据及编辑表单,可在 `apps/admin/src/views/system/` 下核对具体用法。
|
|
@@ -0,0 +1,452 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Router 适配器
|
|
3
|
+
description: 面向动态路由、访问策略、工作区页签与缓存视图的 headless Vue Router 5 适配器。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Router 适配器
|
|
7
|
+
|
|
8
|
+
## 基础用法
|
|
9
|
+
|
|
10
|
+
`@origen-ui/router` 将 Vue Router 创建、后端路由转换、访问校验、路由菜单、面包屑、工作区页签与视图缓存元数据整合在一起,不依赖应用级 store 或请求客户端。
|
|
11
|
+
|
|
12
|
+
<div id="router-workspace"></div>
|
|
13
|
+
### 隔离工作区路由
|
|
14
|
+
|
|
15
|
+
该示例使用内存历史,不影响文档站路由;通过菜单切换视图,再重置工作区观察状态回收。
|
|
16
|
+
|
|
17
|
+
## 安装
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
pnpm add @origen-ui/router vue-router
|
|
21
|
+
|
|
22
|
+
# 可选预设
|
|
23
|
+
pnpm add element-plus @origen-ui/tabs
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## 典型用法
|
|
27
|
+
|
|
28
|
+
## Query 单值归一化
|
|
29
|
+
|
|
30
|
+
Vue Router 会把重复的 query 参数表示为数组。应用需要把 query 值作为一个
|
|
31
|
+
字符串读取时,使用根入口导出的 `getRouteQueryString`:
|
|
32
|
+
|
|
33
|
+
```ts
|
|
34
|
+
import { getRouteQueryString } from '@origen-ui/router'
|
|
35
|
+
|
|
36
|
+
const redirect = getRouteQueryString(route.query.redirect)
|
|
37
|
+
// '/dashboard' 和 ['/dashboard'] 返回 '/dashboard'
|
|
38
|
+
// ['/a', '/b']、[]、null 或非字符串值返回 undefined
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
该 helper 只处理值形状,不会 trim、解码、修改原始 query 或执行 redirect 安全校验。
|
|
42
|
+
站内路径校验仍由应用自己的 sanitizer 负责。
|
|
43
|
+
|
|
44
|
+
## 应用初始化
|
|
45
|
+
|
|
46
|
+
需显式引入样式。预设的 JavaScript 入口不会在运行时注入抽取出的 CSS;聚合包、按需包和暗色主题的统一接入方式见[样式与主题](../../.codex/rules/05-style.md)。
|
|
47
|
+
|
|
48
|
+
```ts
|
|
49
|
+
import '@origen-ui/router/style.css'
|
|
50
|
+
import '@origen-ui/tabs/style.css' // 仅当渲染 RouterTabs 时需要
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
应用层持有静态路由、会话查找与后端 DTO 映射。后端数据提供稳定的视图 key;注册表将这些 key 解析到本地组件。
|
|
54
|
+
|
|
55
|
+
```ts
|
|
56
|
+
import { createAccessPolicy, createRouterAdapter } from '@origen-ui/router'
|
|
57
|
+
import { createWebHistory } from 'vue-router'
|
|
58
|
+
|
|
59
|
+
const routing = createRouterAdapter({
|
|
60
|
+
history: createWebHistory(),
|
|
61
|
+
staticRoutes: [
|
|
62
|
+
{ path: '/login', name: 'login', component: LoginPage, meta: { adapter: { public: true } } },
|
|
63
|
+
{ path: '/403', name: '403', component: ForbiddenPage, meta: { adapter: { public: true } } },
|
|
64
|
+
{ path: '/404', name: '404', component: NotFoundPage, meta: { adapter: { public: true } } },
|
|
65
|
+
],
|
|
66
|
+
dynamic: {
|
|
67
|
+
load: ({ signal }) => api.fetchRoutes({ signal }),
|
|
68
|
+
transform: (routes) => routes.map(toRouteSourceNode),
|
|
69
|
+
resolveComponent: (key) => viewRegistry[key],
|
|
70
|
+
},
|
|
71
|
+
access: createAccessPolicy({
|
|
72
|
+
getSession: () => sessionStore.current(),
|
|
73
|
+
canAccess: (_to, session, meta) =>
|
|
74
|
+
(meta.permissions ?? []).every((item) => session.permissions.includes(item)),
|
|
75
|
+
loginRoute: { name: 'login' },
|
|
76
|
+
forbiddenRoute: { name: '403' },
|
|
77
|
+
}),
|
|
78
|
+
fallbacks: { notFound: { name: '404' }, error: { name: '500' } },
|
|
79
|
+
})
|
|
80
|
+
|
|
81
|
+
app.use(routing)
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## 高级能力
|
|
85
|
+
|
|
86
|
+
## 后端路由映射
|
|
87
|
+
|
|
88
|
+
使用消费方自有的 DTO 转换器。不要直接导入后端返回的路径。
|
|
89
|
+
|
|
90
|
+
```ts
|
|
91
|
+
function toRouteSourceNode(route: BackendRoute) {
|
|
92
|
+
return {
|
|
93
|
+
name: route.code,
|
|
94
|
+
path: route.path,
|
|
95
|
+
componentKey: route.viewKey,
|
|
96
|
+
meta: {
|
|
97
|
+
title: route.title,
|
|
98
|
+
permissions: route.permissions,
|
|
99
|
+
menu: { hidden: !route.showInMenu },
|
|
100
|
+
cache: route.cache ? { enabled: true, name: route.cacheName } : undefined,
|
|
101
|
+
},
|
|
102
|
+
children: route.children?.map(toRouteSourceNode),
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
动态叶子路由需要 `componentKey` 或重定向。无组件的分组路由会获得一个 `RouterView` 出口。动态名称不能替换静态路由保留的名称。
|
|
108
|
+
|
|
109
|
+
## 布局预设
|
|
110
|
+
|
|
111
|
+
基础包导出 `RouterViewHost`。Element Plus 与 OgTabs 集成为独立的入口点。
|
|
112
|
+
|
|
113
|
+
```vue
|
|
114
|
+
<script setup lang="ts">
|
|
115
|
+
import { RouterViewHost } from '@origen-ui/router'
|
|
116
|
+
import { RouterBreadcrumb, RouterMenu } from '@origen-ui/router/element-plus'
|
|
117
|
+
import { RouterTabs } from '@origen-ui/router/tabs'
|
|
118
|
+
</script>
|
|
119
|
+
|
|
120
|
+
<template>
|
|
121
|
+
<aside><RouterMenu /></aside>
|
|
122
|
+
<main>
|
|
123
|
+
<RouterBreadcrumb />
|
|
124
|
+
<RouterTabs />
|
|
125
|
+
<RouterViewHost :cache-max="10" />
|
|
126
|
+
</main>
|
|
127
|
+
</template>
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
缓存视图需要与 `meta.adapter.cache.name` 匹配的稳定组件名。`RouterViewHost` 只负责
|
|
131
|
+
`RouterView`、深度对齐与 `KeepAlive` 渲染;缓存 include 列表和带工作区 revision 的
|
|
132
|
+
key 由 Router adapter 统一解析。组件不会合成匿名 `route` key,因此启用缓存的视图
|
|
133
|
+
必须暴露显式组件名,或在 `meta.adapter.cache.name` 中配置名称。嵌套缓存路由必须在
|
|
134
|
+
每个自定义布局中渲染 `<RouterViewHost />`;自动生成的动态分组已自动处理。工作区
|
|
135
|
+
持久化为可选,应使用用户或租户特定的作用域。
|
|
136
|
+
|
|
137
|
+
`cacheMax` 必须是正整数,默认值为 `10`;零、负数、小数和非有限值会立即抛出配置错误。
|
|
138
|
+
|
|
139
|
+
## 会话变更
|
|
140
|
+
|
|
141
|
+
在登出或切换租户/角色后调用 `reset()`。它会中止进行中的动态加载、移除注入的路由、清空工作区页签,并可选跳转到公开路由。
|
|
142
|
+
`reset()` 也会使所有尚未完成的加载结果和路由重放失效,旧结果不会重新安装动态路由。
|
|
143
|
+
|
|
144
|
+
```ts
|
|
145
|
+
await routing.reset({ name: 'login' })
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
使用 `reload(tabKey)` 强制某个工作区页面重新挂载。不传 key 时刷新当前激活页签。
|
|
149
|
+
|
|
150
|
+
## 动态路由恢复
|
|
151
|
+
|
|
152
|
+
当动态路由加载失败时,适配器会将原始目标记录在 `state.lastError` 中,并重定向到必需的公开错误路由。错误页可重试加载并返回原始目标;重试会等待最终导航结果,取消、404/500 fallback 或其他 Navigation Failure 都返回 `false`,正常业务重定向使用最终 route 更新工作区。显式 `replaceDynamicRoutes(source, options)` 失败后,重试复用已提供的 source 与 fallback/回放目标;省略 source 时重新调用 `dynamic.load()`。重试仍失败会保留上下文,新的 replace、`reset()`、`dispose()` 或 generation 会使旧上下文失效。
|
|
153
|
+
|
|
154
|
+
```ts
|
|
155
|
+
import { useRouterAdapter } from '@origen-ui/router'
|
|
156
|
+
|
|
157
|
+
const adapter = useRouterAdapter()
|
|
158
|
+
const restored = await adapter.retryDynamicRoutes()
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
## Adapter 运行时状态
|
|
162
|
+
|
|
163
|
+
`useRouterAdapter()` 返回的 `RouterAdapterRuntime` 提供以下只读属性与方法:
|
|
164
|
+
|
|
165
|
+
| 成员 | 类型 | 说明 |
|
|
166
|
+
| ---------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------------- |
|
|
167
|
+
| `router` | `Router` | 底层 Vue Router 实例 |
|
|
168
|
+
| `menu` | `ComputedRef<RouteMenuItem[]>` | 当前动态路由计算出的菜单树 |
|
|
169
|
+
| `workspace` | `RouteWorkspace` | 工作区标签页管理(详见下方) |
|
|
170
|
+
| `state` | `ComputedRef<RouterAdapterState>` | 适配器运行时状态,包含 `navigation`、`dynamicRoutes` 和 `lastError` |
|
|
171
|
+
| `ready()` | `() => Promise<void>` | 等待动态路由首次加载完成;可在挂载布局组件前调用以确保路由就绪 |
|
|
172
|
+
| `retryDynamicRoutes()` | `() => Promise<boolean>` | 动态路由加载失败后重试并返回原始目标 |
|
|
173
|
+
| `reset()` | `(redirect?) => Promise<void>` | 登出或切换租户后重置:中止请求、移除路由、清空标签页,可选跳转 |
|
|
174
|
+
| `reload()` | `(key?) => Promise<void>` | 强制指定标签页(或当前标签页)重新挂载 |
|
|
175
|
+
| `getMeta()` | `(route) => AdapterRouteMeta` | 获取合并后的路由适配器元数据 |
|
|
176
|
+
| `getBreadcrumbs()` | `(route) => BreadcrumbItem[]` | 获取当前路由的面包屑项 |
|
|
177
|
+
| `getViewCache()` | `(route, depth) => RouterViewCache` | 解析指定 RouterView 深度的 KeepAlive include 列表和 revision-aware key;无默认组件时不返回 key |
|
|
178
|
+
|
|
179
|
+
### RouterAdapterState
|
|
180
|
+
|
|
181
|
+
`state` 是一个 `ComputedRef`,包含以下字段:
|
|
182
|
+
|
|
183
|
+
| 字段 | 类型 | 说明 |
|
|
184
|
+
| --------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
|
|
185
|
+
| `navigation` | `'idle' \| 'navigating'` | 当前是否正在导航中 |
|
|
186
|
+
| `dynamicRoutes` | `'idle' \| 'loading' \| 'ready' \| 'error' \| 'degraded'` | 动态路由的加载状态;`degraded` 表示已降级为静态路由,需显式 retry 或 replace 才会恢复 |
|
|
187
|
+
| `lastError` | `RouterAdapterError \| undefined` | 最近一次错误,包含 `cause`、`phase`、`to`、`from`;动态恢复错误还提供 `generation`、`restored`、`recoveryCause` 和 `failure` |
|
|
188
|
+
|
|
189
|
+
### replaceDynamicRoutes
|
|
190
|
+
|
|
191
|
+
`RouterAdapter`(继承自 `RouterAdapterRuntime`)额外暴露 `replaceDynamicRoutes`,用于在运行时替换整份动态路由(如切换租户后重新拉取):
|
|
192
|
+
|
|
193
|
+
```ts
|
|
194
|
+
await routing.replaceDynamicRoutes(newSourceRoutes)
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
替换不承诺 Vue Router 内部 matcher 的原子交换。适配器会先完成转换、静态名称
|
|
198
|
+
和路径(包括父级 alias 的子路径)冲突校验,再通过公开 `addRoute`、disposer、`removeRoute`、
|
|
199
|
+
`hasRoute`、`resolve` 和 `getRoutes` 完成安装与对账;失败时恢复旧路由,恢复失败则降级为静态路由。
|
|
200
|
+
运行时已使用导航屏障和 generation 校验,连续替换时只有当前操作可以提交结果。只有最终导航
|
|
201
|
+
有效后才会过滤不可达页签、更新标题和缓存并写入工作区;Vue Router 本身没有公开的 matcher 事务,
|
|
202
|
+
因此这里承诺的是外部可观察一致性和失败恢复,而不是内部路由树原子交换。
|
|
203
|
+
|
|
204
|
+
如果公开删除 API 仍无法清除某条动态记录,adapter 会保留 residual snapshot 供后续清理,并进入 `degraded-static`;菜单只显示静态路由,守卫会拦截仍留在 matcher 中的动态残留,即使其标记为 public。若 dispose 清理失败,原 Router 保留只拦截 residual 动态路由的 fail-closed 守卫,静态路由仍可导航;业务方必须卸载旧应用并丢弃该 Router 与 history 后重新创建。因为 dispose 不会导航,当前已经渲染的 residual 动态页面可能继续挂载到应用卸载或 RouterView 切换。
|
|
205
|
+
|
|
206
|
+
动态源加载可通过 `dynamic.timeoutMs` 设置超时,默认值为 30 秒。超时会取消请求并保留上一份动态路由快照。
|
|
207
|
+
`retryDynamicRoutes()` 会校验最终导航结果:重定向到正常业务路由返回 `true`,导航失败或进入 404/500
|
|
208
|
+
fallback 返回 `false`,并且不会用失败结果更新工作区。
|
|
209
|
+
|
|
210
|
+
动态转换结果不包含 `componentKey` 时可以省略 `dynamic.resolveComponent`,适配器会为分组路由创建默认
|
|
211
|
+
`RouterView` outlet;只要任一节点包含 `componentKey`,就必须提供 resolver,否则会在物化阶段 fail-closed 并进入错误处理链。
|
|
212
|
+
|
|
213
|
+
完整的状态机、错误契约、恢复流程和验收矩阵见仓库文档 `docs/dynamic-route-contract.md`。
|
|
214
|
+
|
|
215
|
+
## 工作区标签页
|
|
216
|
+
|
|
217
|
+
`useRouteWorkspace()` 是获取当前工作区状态的便捷 composable,等价于 `useRouterAdapter().workspace`。
|
|
218
|
+
|
|
219
|
+
```ts
|
|
220
|
+
import { useRouteWorkspace } from '@origen-ui/router'
|
|
221
|
+
|
|
222
|
+
const workspace = useRouteWorkspace()
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
### RouteWorkspace 成员
|
|
226
|
+
|
|
227
|
+
| 成员 | 类型 | 说明 |
|
|
228
|
+
| ---------------------- | ----------------------------------------------------- | ---------------------------------------------------------- |
|
|
229
|
+
| `tabs` | `Ref<readonly WorkspaceTab[]>` | 当前打开的标签页列表 |
|
|
230
|
+
| `activeKey` | `Ref<string \| undefined>` | 当前激活标签页的 key |
|
|
231
|
+
| `visit()` | `(route) => void` | 记录路由访问,自动创建或激活标签页 |
|
|
232
|
+
| `close()` | `(key) => WorkspaceTab \| undefined` | 关闭指定标签页并返回关闭后的当前激活标签 |
|
|
233
|
+
| `closeMany()` | `(keys, nextActiveKey?) => WorkspaceTab \| undefined` | 一次关闭多个标签并只提交一次状态与持久化 |
|
|
234
|
+
| `setPinned()` | `(key, pinned) => void` | 切换标签页固定状态 |
|
|
235
|
+
| `replace()` | `(tabs) => void` | 替换整个标签页列表(用于从持久化恢复) |
|
|
236
|
+
| `replaceAndVisit()` | `(tabs, route) => void` | 必需的事务 API,一次替换标签列表并提交最终路由访问 |
|
|
237
|
+
| `replaceAndActivate()` | `(tabs, activeKey?) => void` | 必需的事务 API,一次替换标签列表并设置激活项,避免中间快照 |
|
|
238
|
+
| `clear()` | `() => void` | 清空所有标签页 |
|
|
239
|
+
| `refresh()` | `(key?) => void` | 强制指定标签页(或不传则当前标签页)重新挂载 |
|
|
240
|
+
|
|
241
|
+
默认 Tab key 使用规范化后的 `route.fullPath`,因此同名参数路由会形成独立页签;需要按业务合并时可通过 `WorkspaceOptions.keyOf` 自定义。切换旧版按路由名生成的持久化数据时,请提升 `workspace.persistence.version`。
|
|
242
|
+
|
|
243
|
+
恢复持久化数据时会校验每个页签的字段、非空 key 和 key 唯一性。发现非法或重复数据时会
|
|
244
|
+
清除整个存储项并从空工作区开始,不会尝试修复部分页签。
|
|
245
|
+
|
|
246
|
+
### WorkspaceTab 缓存链
|
|
247
|
+
|
|
248
|
+
每个 `WorkspaceTab` 携带可选的 `cacheChain` 字段(`readonly (string | undefined)[]`):
|
|
249
|
+
按路由匹配链深度记录需要缓存的组件名,未命名的 outlet 记录对应位置为 `undefined`。
|
|
250
|
+
`refresh()` 递增该标签页的 revision,解析出的缓存 key 只在激活路由对应的深度生效,
|
|
251
|
+
使 `KeepAlive` 重新挂载该层组件。持久化 schema 的失效完全由配置的 `version` 决定:
|
|
252
|
+
版本或 scope 不匹配的存量数据在恢复时整体清除;携带 schema 之外字段的标签页会被
|
|
253
|
+
正常恢复,额外字段仅被忽略、不被解读。JSON 持久化恢复时会保留 `undefined` 对应的
|
|
254
|
+
未命名 outlet 位置。缓存组件必须暴露显式名称或在
|
|
255
|
+
`meta.adapter.cache.name` 中配置(见上文)。
|
|
256
|
+
|
|
257
|
+
## 持久化适配器
|
|
258
|
+
|
|
259
|
+
`createWebStorageAdapter` 将浏览器原生 `Storage`(`localStorage` / `sessionStorage`)包装为 `StorageAdapter` 接口,用于工作区标签页的持久化。内部自动处理 JSON 序列化与反序列化,读取失败时清除损坏数据并返回 `undefined`。
|
|
260
|
+
|
|
261
|
+
```ts
|
|
262
|
+
import { createWebStorageAdapter } from '@origen-ui/router'
|
|
263
|
+
|
|
264
|
+
const storage = createWebStorageAdapter(localStorage)
|
|
265
|
+
|
|
266
|
+
// 在 workspace 配置中使用
|
|
267
|
+
const routing = createRouterAdapter({
|
|
268
|
+
// ...
|
|
269
|
+
workspace: {
|
|
270
|
+
enabled: true,
|
|
271
|
+
persistence: {
|
|
272
|
+
storage,
|
|
273
|
+
key: 'workspace',
|
|
274
|
+
version: 2,
|
|
275
|
+
scope: `user:${userId}`,
|
|
276
|
+
},
|
|
277
|
+
},
|
|
278
|
+
})
|
|
279
|
+
```
|
|
280
|
+
|
|
281
|
+
## 辅助函数
|
|
282
|
+
|
|
283
|
+
以下函数由 `@origen-ui/router` 直接导出,可在应用层独立使用:
|
|
284
|
+
|
|
285
|
+
| 函数 | 签名 | 说明 |
|
|
286
|
+
| ------------------- | ----------------------------- | ----------------------------------------------------------------------------------------------- |
|
|
287
|
+
| `getAdapterMeta` | `(route) => AdapterRouteMeta` | 沿 `route.matched` 向上合并所有层级的 `meta.adapter`,返回完整的路由适配器元数据 |
|
|
288
|
+
| `createBreadcrumbs` | `(route) => BreadcrumbItem[]` | 从当前路由匹配链生成面包屑项列表,自动过滤 `breadcrumb.hidden` 的层级,最后一项不带链接 |
|
|
289
|
+
| `createMenu` | `(routes) => RouteMenuItem[]` | 从 Vue Router 路由记录生成菜单树,过滤 `menu.hidden` 路由,按 `menu.order` 排序,递归处理子路由 |
|
|
290
|
+
| `resolveActiveMenu` | `(route) => string` | 解析当前路由对应的菜单激活项:优先使用 `meta.menu.activeMenu`,否则回退为路由 `name` 或 `path` |
|
|
291
|
+
|
|
292
|
+
```ts
|
|
293
|
+
import { createBreadcrumbs, createMenu, resolveActiveMenu, getAdapterMeta } from '@origen-ui/router'
|
|
294
|
+
|
|
295
|
+
// 从路由记录构建菜单
|
|
296
|
+
const menuItems = createMenu(router.getRoutes())
|
|
297
|
+
|
|
298
|
+
// 从当前路由生成面包屑
|
|
299
|
+
const crumbs = createBreadcrumbs(route)
|
|
300
|
+
|
|
301
|
+
// 解析菜单高亮项
|
|
302
|
+
const activeId = resolveActiveMenu(route)
|
|
303
|
+
```
|
|
304
|
+
|
|
305
|
+
## API
|
|
306
|
+
|
|
307
|
+
### 导航决策与生命周期
|
|
308
|
+
|
|
309
|
+
`RouterPolicy.before` 返回显式的 `NavigationDecision`:
|
|
310
|
+
|
|
311
|
+
```ts
|
|
312
|
+
const policy = {
|
|
313
|
+
name: 'feature-gate',
|
|
314
|
+
before: ({ to }) =>
|
|
315
|
+
to.name === 'reports'
|
|
316
|
+
? { type: 'continue' }
|
|
317
|
+
: { type: 'redirect', to: { name: '403' }, replace: true },
|
|
318
|
+
}
|
|
319
|
+
```
|
|
320
|
+
|
|
321
|
+
使用 `{ type: 'cancel', reason }` 取消导航。`RouteTarget` 必须提供非空 `name` 或非空
|
|
322
|
+
`path`,不能同时提供两者;`path` 目标不能携带 `params`。策略与 fallback 的路由身份比较使用解析后的 name、path 和 params
|
|
323
|
+
并忽略 query/hash;workspace 精确匹配则保留 query 与 hash。
|
|
324
|
+
|
|
325
|
+
适配器拥有者卸载时调用 `routing.dispose()`。该方法幂等,会取消动态任务、尝试移除动态路由,
|
|
326
|
+
并保留持久化工作区数据。若 Vue Router 官方 disposer 或 `removeRoute()` 清理失败,`dispose()`
|
|
327
|
+
会抛出恢复错误并记录 `lastError.phase === 'dispose'`;适配器进入终态,业务方应记录错误。为防止残留动态路由被访问,清理失败时原 Router 会保留只拦截 residual snapshot 的 fail-closed 守卫,静态路由仍可导航;此时必须卸载旧应用并丢弃原 Router 与 history,重新创建二者和适配器,不能只在同一个 Router 上新建适配器。若失败来自其他 disposer 且无动态残留,守卫会移除。正常清理成功时该守卫也会移除。由于 dispose 不会导航,已经渲染的 residual 动态页面可能继续挂载到应用卸载或 RouterView 切换。dispose 后继续调用适配器操作
|
|
328
|
+
会抛出明确的生命周期错误。`routing.router` 是原始 Vue Router 实例,适配器不会包装或拦截它的
|
|
329
|
+
`push`、`replace`、`addRoute` 和 `removeRoute`;调用方必须在 dispose 后停止通过该实例发起新的导航或路由变更。
|
|
330
|
+
多个功能共享同一个 Router 时,由应用负责协调 Router 的总体生命周期。
|
|
331
|
+
|
|
332
|
+
## 布局组件 Props
|
|
333
|
+
|
|
334
|
+
### 官方透传类型:`RouterBreadcrumbProps`、`RouterBreadcrumbSlots`、`RouterMenuEvents`、`RouterMenuNodeEvents`、`RouterMenuNodeProps`、`RouterMenuNodePropsResolver`、`RouterMenuProps`、`RouterMenuSlots`、`RouterTabsProps`
|
|
335
|
+
|
|
336
|
+
| 组件 | 属性 | 类型 | 默认值 | 说明 |
|
|
337
|
+
| ------------------ | ------------------------------ | ------------------------------------------------------------------------------ | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
|
|
338
|
+
| `RouterViewHost` | `cacheMax` | `number` | `10` | KeepAlive 缓存的最大路由组件数量,必须为正整数。嵌套路由布局中应分别渲染该组件。 |
|
|
339
|
+
| `RouterMenu` | `ogResolveIcon` | `(icon: string) => Component \| undefined` | - | 将路由菜单的图标标识解析为 Vue 组件。 |
|
|
340
|
+
| `RouterMenu` | 顶层官方属性 / `ogMenuEvents` | `RouterMenuProps` 根属性 | - | Element Plus Menu 官方属性直接放在根层,事件使用显式桥接。 |
|
|
341
|
+
| `RouterMenu` | `ogNodeProps` / `ogNodeEvents` | `RouterMenuNodeProps` / `RouterMenuNodeEvents` | - | 递归 SubMenu/MenuItem 的官方属性和事件,参考 Element Plus 官方文档;支持静态对象或按菜单节点返回对象。 |
|
|
342
|
+
| `RouterTabs` | `ogFeatures` | `OgTabsFeatures` | `{ close: true, pin: true, drag: true }` | 覆盖路由工作区标签页的功能开关。`add` 只有在同时提供 `ogAddTab` 时才显示;右键菜单由组件单独启用。 |
|
|
343
|
+
| `RouterTabs` | `ogLocale` | `RouterTabsProps['ogLocale']` | `undefined` | 覆盖工作区标签页的本地化文案。 |
|
|
344
|
+
| `RouterTabs` | `ogAddTab` | `(context) => WorkspaceTab \| undefined \| Promise<WorkspaceTab \| undefined>` | - | 与 `ogFeatures.add: true` 配合使用。回调返回的工作区页签必须使用唯一 key;导航成功后 RouterTabs 写入 workspace 并激活该路由。 |
|
|
345
|
+
| `RouterBreadcrumb` | 顶层官方属性 | `RouterBreadcrumbProps` 根属性 | - | Element Plus Breadcrumb 官方属性直接放在根层。 |
|
|
346
|
+
| `RouterMenu` | `default` 插槽 | `RouterMenuSlots['default']` | - | 提供时替换按路由生成的菜单节点;插槽内容直接作为 Element Plus Menu 子节点渲染。 |
|
|
347
|
+
| `RouterBreadcrumb` | `default` 插槽 | `RouterBreadcrumbSlots['default']` | - | 提供时替换按路由生成的面包屑项;插槽内容直接作为 Element Plus Breadcrumb 子节点渲染。 |
|
|
348
|
+
|
|
349
|
+
`RouterTabs` 不接受 `modelValue` 作为外部受控值。活动标签由路由工作区状态决定,应用应通过路由与工作区适配器管理它,而不是传入 `modelValue`。
|
|
350
|
+
|
|
351
|
+
`RouterViewHost` 从 `@origen-ui/router` 导入,`RouterMenu` 和 `RouterBreadcrumb` 从 `@origen-ui/router/element-plus` 导入,`RouterTabs` 从 `@origen-ui/router/tabs` 导入。它们依赖同一 `createRouterAdapter()` 上下文,不能脱离 Adapter 单独使用。
|
|
352
|
+
|
|
353
|
+
`RouterMenu` 的 Element Plus Menu 官方属性直接放在组件根层;`ogResolveIcon` 解析菜单图标,`ogMenuEvents` 桥接 Menu / MenuItem 事件,`ogNodeProps` / `ogNodeEvents` 负责递归节点级 SubMenu/MenuItem 配置。`RouterBreadcrumb` 的 Element Plus Breadcrumb 官方属性也直接放在根层;它没有额外的业务事件配置。以上原生属性和节点属性类型均以 Element Plus 官方文档为准。
|
|
354
|
+
|
|
355
|
+
`RouterMenu` 与 `RouterBreadcrumb` 的 `default` 插槽是完整替换点,不会把自动生成的路由节点与自定义节点混合。插槽不接收参数;需要路由树数据时可通过 `useRouteMenu()` 或 `useBreadcrumbs()` 读取适配器状态。
|
|
356
|
+
|
|
357
|
+
当顶层 `router` 属性为 `true` 时,组件使用 Element Plus Menu 的官方路由模式,并将生成的菜单项索引解析为路由路径;适配器不会再次执行同一导航。
|
|
358
|
+
|
|
359
|
+
## 组合式函数(Composables)
|
|
360
|
+
|
|
361
|
+
| Composable | 返回值 | 说明 |
|
|
362
|
+
| ------------------- | ------------------------------- | ---------------------------- |
|
|
363
|
+
| `useRouterAdapter` | `RouterAdapterRuntime` | 获取适配器运行时实例 |
|
|
364
|
+
| `useRouteMenu` | `ComputedRef<RouteMenuItem[]>` | 当前路由菜单树的便捷访问 |
|
|
365
|
+
| `useBreadcrumbs` | `ComputedRef<BreadcrumbItem[]>` | 当前路由面包屑列表(响应式) |
|
|
366
|
+
| `useRouteWorkspace` | `RouteWorkspace` | 当前工作区标签页管理 |
|
|
367
|
+
|
|
368
|
+
## 子路径入口
|
|
369
|
+
|
|
370
|
+
`@origen-ui/router` 提供以下子路径入口,均为可选预设:
|
|
371
|
+
|
|
372
|
+
| 入口 | 说明 |
|
|
373
|
+
| -------------------------------- | -------------------------------------------------------------- |
|
|
374
|
+
| `@origen-ui/router` | 核心包:适配器、composables、辅助函数 |
|
|
375
|
+
| `@origen-ui/router/element-plus` | Element Plus 预设:`RouterBreadcrumb`、`RouterMenu` 等布局组件 |
|
|
376
|
+
| `@origen-ui/router/tabs` | OgTabs 预设:`RouterTabs` 工作区标签页组件 |
|
|
377
|
+
| `@origen-ui/router/style.css` | 核心样式 |
|
|
378
|
+
|
|
379
|
+
## 根入口公开导出
|
|
380
|
+
|
|
381
|
+
除 `RouterViewHost` 外,`@origen-ui/router` 根入口导出以下工厂、组合式函数和辅助函数:
|
|
382
|
+
|
|
383
|
+
| 分类 | 导出 |
|
|
384
|
+
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
385
|
+
| 工厂 | `createRouterAdapter`、`createAccessPolicy`、`createWebStorageAdapter` |
|
|
386
|
+
| Composables | `useRouterAdapter`、`useRouteMenu`、`useBreadcrumbs`、`useRouteWorkspace` |
|
|
387
|
+
| selectors/meta | `createBreadcrumbs`、`createMenu`、`resolveActiveMenu`、`getAdapterMeta`、`isUnmatchedRoute`、`getRouteQueryString`、`matchesWorkspaceRoute` |
|
|
388
|
+
| route targets/runtime | `matchesRoute`、`normalizeRouteTarget`、`routeTargetFromRoute`、`RouteTarget`、`NamedRouteTarget`、`PathRouteTarget`、`createRouteTreeIndex`、`RouteTreeError`、`RouteTreeIndex`、`RouteTreeIndexNode`、`DynamicRouteManager`、`DynamicRouteLoadTimeoutError`、`DynamicRouteApplied`、`DynamicRouteAppliedValue`、`DynamicRouteFailed`、`DynamicRouteLoadOutcome`、`DynamicRouteLoadOperationResult`、`DynamicRouteOperationResult`、`DynamicRouteSkipped`、`DynamicRouteStatus`、`DynamicRouteSuperseded`、`DynamicRouteReplacementError`、`DynamicRouteReplacementTransaction`、`DynamicRouteReplacementResult`、`DynamicRouteReplacementTransactionOptions`、`DynamicRouteSnapshot`、`navigateAndValidateRoute`、`RouteTabActionExecutor`、`RouteWorkspaceNavigationRecoveryError`、`RouteNavigationValidatorOptions`、`CancelNavigationDecision`、`ContinueNavigationDecision`、`NavigationDecision`、`RedirectNavigationDecision`、`RouterPolicyResult`、`DynamicRouteFailure`、`DynamicRouteFailurePhase`、`ROUTER_WORKSPACE_SCHEMA_VERSION` |
|
|
389
|
+
| 组件 | `RouterViewHost`(Element Plus/Tabs 布局组件见子路径入口) |
|
|
390
|
+
| 路由与适配器配置 | `AccessPolicyOptions`、`AdapterBreadcrumbMeta`、`AdapterCacheMeta`、`AdapterMenuMeta`、`AdapterRouteMeta`、`AdapterTabMeta`、`DynamicRouteOptions`、`DynamicRouteReplacementOptions`、`DynamicRouterAdapterOptions`、`DynamicRouterFallbacks`、`StaticRouterAdapterOptions`、`RouterAdapterOptions` |
|
|
391
|
+
| 运行时与导航 | `NavigationContext`、`RouteSourceNode`、`RouterAdapter`、`RouterAdapterError`、`RouterAdapterRuntime`、`RouterAdapterState`、`RouterFallbacks`、`RouterPolicy`、`RouterViewCache` |
|
|
392
|
+
| 菜单与工作区 | `BreadcrumbItem`、`RouteMenuItem`、`RouteWorkspace`、`StorageAdapter`、`WorkspaceOptions`、`WorkspacePersistenceOptions`、`WorkspaceTab` |
|
|
393
|
+
|
|
394
|
+
核心类型包括 `AccessPolicyOptions`、`AdapterBreadcrumbMeta`、`AdapterCacheMeta`、`AdapterMenuMeta`、`AdapterRouteMeta`、`AdapterTabMeta`、`BreadcrumbItem`、`DynamicRouteOptions`、`DynamicRouteReplacementOptions`、`DynamicRouterAdapterOptions`、`DynamicRouterFallbacks`、`NavigationContext`、`RouteMenuItem`、`RouteSourceNode`、`RouteWorkspace`、`RouterAdapter`、`RouterAdapterError`、`RouterAdapterOptions`、`RouterAdapterRuntime`、`RouterAdapterState`、`RouterFallbacks`、`RouterPolicy`、`RouterViewCache`、`StaticRouterAdapterOptions`、`StorageAdapter`、`WorkspaceOptions`、`WorkspacePersistenceOptions` 和 `WorkspaceTab`。字段级说明以初始化、动态路由、工作区和持久化章节为准。
|
|
395
|
+
|
|
396
|
+
动态路由结果类型包括 `DynamicRouteOperationResult`(`committed-new`、`restored-previous`、`degraded-static`、`superseded`、`disposed`)、`DynamicRouteReplacementResult`、`DynamicRouteFailure`、`DynamicRouteLoadTimeoutError`、`DynamicRouteLoadOperationResult`、`DynamicRouteLoadOutcome` 和 `DynamicRouteStatus`;策略与导航类型包括 `RouteTarget`、`NavigationDecision` 及其 continue/cancel/redirect 变体。
|
|
397
|
+
|
|
398
|
+
### 布局透传类型:`RouterBreadcrumbProps`、`RouterBreadcrumbSlots`、`RouterMenuEvents`、`RouterMenuNodeEvents`、`RouterMenuNodeProps`、`RouterMenuNodePropsResolver`、`RouterMenuProps`、`RouterMenuSlots`
|
|
399
|
+
|
|
400
|
+
## 相关组合示例
|
|
401
|
+
|
|
402
|
+
工作区页签和路由恢复的运行时组合见[工作区与路由示例](../../.agents/skills/admin-component-usage/references/component-directory.md);页面级表格与搜索组合见 [OgTableWithSearch](./table-with-search.md)。
|
|
403
|
+
|
|
404
|
+
<!-- component-contract:start -->
|
|
405
|
+
|
|
406
|
+
## 公共契约
|
|
407
|
+
|
|
408
|
+
> 由组件目录生成;每条记录对应可公开导入的组件及其消费者 API 摘要。
|
|
409
|
+
|
|
410
|
+
### Imports
|
|
411
|
+
|
|
412
|
+
- `router-view-host`: `import { RouterViewHost } from '@origen-ui/router'`
|
|
413
|
+
- `router-breadcrumb`: `import { RouterBreadcrumb } from '@origen-ui/router/element-plus'`
|
|
414
|
+
- `router-menu`: `import { RouterMenu } from '@origen-ui/router/element-plus'`
|
|
415
|
+
- `router-tabs`: `import { RouterTabs } from '@origen-ui/router/tabs'`
|
|
416
|
+
|
|
417
|
+
### Props
|
|
418
|
+
|
|
419
|
+
- `router-view-host`: `cacheMax`
|
|
420
|
+
- `router-breadcrumb`: 无
|
|
421
|
+
- `router-menu`: `ogResolveIcon`, `ogMenuEvents`, `ogNodeProps`, `ogNodeEvents`
|
|
422
|
+
- `router-tabs`: `ogFeatures`, `ogLocale`, `ogAddTab`
|
|
423
|
+
|
|
424
|
+
### Events
|
|
425
|
+
|
|
426
|
+
- `router-view-host`: 无
|
|
427
|
+
- `router-breadcrumb`: 无
|
|
428
|
+
- `router-menu`: 无
|
|
429
|
+
- `router-tabs`: 无
|
|
430
|
+
|
|
431
|
+
### Slots
|
|
432
|
+
|
|
433
|
+
- `router-view-host`: 无
|
|
434
|
+
- `router-breadcrumb`: `default`
|
|
435
|
+
- `router-menu`: `default`
|
|
436
|
+
- `router-tabs`: 无
|
|
437
|
+
|
|
438
|
+
### Exposes
|
|
439
|
+
|
|
440
|
+
- `router-view-host`: 无
|
|
441
|
+
- `router-breadcrumb`: 无
|
|
442
|
+
- `router-menu`: 无
|
|
443
|
+
- `router-tabs`: 无
|
|
444
|
+
|
|
445
|
+
### Types
|
|
446
|
+
|
|
447
|
+
- `router-view-host`:属性类型:由公开 Vue 组件推断,未单独导出属性类型;公开方法类型:无
|
|
448
|
+
- `router-breadcrumb`:属性类型:`RouterBreadcrumbProps`;公开方法类型:无
|
|
449
|
+
- `router-menu`:属性类型:`RouterMenuProps`;公开方法类型:无
|
|
450
|
+
- `router-tabs`:属性类型:`RouterTabsProps`;公开方法类型:无
|
|
451
|
+
|
|
452
|
+
<!-- component-contract:end -->
|