@origen-ui/admin-cli 2.0.2 → 3.0.4
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 +25 -12
- 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 +21 -18
- package/templates/current/clean/.agents/skills/admin-component-usage/SKILL.md +27 -0
- package/templates/current/clean/.agents/skills/admin-component-usage/references/component-directory.md +232 -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 +42 -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 +27 -0
- package/templates/current/clean/.claude/skills/admin-component-usage/references/component-directory.md +232 -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 +42 -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 +30 -0
- package/templates/current/clean/.codebuddy/skills/admin-component-usage/references/component-directory.md +232 -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 +42 -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 +27 -0
- package/templates/current/clean/.cursor/skills/admin-component-usage/references/component-directory.md +232 -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 +42 -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 +28 -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 +27 -0
- package/templates/current/clean/.qoder/skills/admin-component-usage/references/component-directory.md +232 -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 +42 -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 +27 -0
- package/templates/current/clean/.zcode/skills/admin-component-usage/references/component-directory.md +232 -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 +42 -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 +128 -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 +47 -35
- 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 +315 -30
- package/templates/current/clean/scripts/generate-api.ts +290 -85
- package/templates/current/clean/scripts/lib/admin-component-catalog.mjs +514 -0
- package/templates/current/clean/scripts/lib/admin-skill-inventory.mjs +18 -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 +97 -62
- 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 +86 -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 +100 -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 +58 -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 +27 -0
- package/templates/current/examples/.agents/skills/admin-component-usage/references/component-directory.md +232 -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 +42 -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 +27 -0
- package/templates/current/examples/.claude/skills/admin-component-usage/references/component-directory.md +232 -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 +42 -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 +30 -0
- package/templates/current/examples/.codebuddy/skills/admin-component-usage/references/component-directory.md +232 -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 +42 -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 +27 -0
- package/templates/current/examples/.cursor/skills/admin-component-usage/references/component-directory.md +232 -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 +42 -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 +28 -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 +27 -0
- package/templates/current/examples/.qoder/skills/admin-component-usage/references/component-directory.md +232 -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 +42 -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 +27 -0
- package/templates/current/examples/.zcode/skills/admin-component-usage/references/component-directory.md +232 -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 +42 -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 +128 -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 +47 -35
- 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 +315 -30
- package/templates/current/examples/scripts/generate-api.ts +290 -85
- package/templates/current/examples/scripts/lib/admin-component-catalog.mjs +514 -0
- package/templates/current/examples/scripts/lib/admin-skill-inventory.mjs +18 -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 +97 -62
- 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 +86 -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 +100 -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 +58 -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/clean/tsconfig.node.json +0 -9
- 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/examples/tsconfig.node.json +0 -9
- /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,405 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: OgDialog
|
|
3
|
+
description: 同时支持组件式与命令式动态内容的通用弹窗。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# OgDialog
|
|
7
|
+
|
|
8
|
+
在 767px 及以下的屏幕上,通过 Teleport 渲染的弹窗与抽屉表面使用相对容器的全屏尺寸(`width: 100%` 且 `max-width: 100%`),因此浏览器滚动条宽度不会造成水平溢出。
|
|
9
|
+
|
|
10
|
+
同时支持组件式插槽与命令式动态内容的通用弹窗。确认流程可以等待异步任务、调用表单协议,并通过关闭守卫保护未完成的编辑。
|
|
11
|
+
|
|
12
|
+
`modal` 与 `lockScroll` 省略时沿用 Element Plus 的默认值(均为 `true`);显式传入 `false` 可分别关闭遮罩或页面滚动锁定。组件式 Dialog、Drawer 以及命令式 Host 使用相同的透传规则。
|
|
13
|
+
|
|
14
|
+
## 何时使用
|
|
15
|
+
|
|
16
|
+
- 用户需要在当前上下文完成确认、编辑或详情查看。
|
|
17
|
+
- 弹窗内容是已有 Vue 组件或 OgForm,且确认后需要统一校验与提交。
|
|
18
|
+
- 业务服务需要在已安装 `createOgDialog()` 的应用内通过 `useDialog().open()` 打开多个独立弹窗。
|
|
19
|
+
|
|
20
|
+
## 基础用法
|
|
21
|
+
|
|
22
|
+
组件式 API 使用 `v-model` 控制可见性。确认回调返回 `true` 才关闭,返回 `false` 或抛出异常则保持打开状态。
|
|
23
|
+
|
|
24
|
+
```vue
|
|
25
|
+
<script setup lang="ts">
|
|
26
|
+
import { shallowRef } from 'vue'
|
|
27
|
+
import { OgDialog } from 'origen-ui'
|
|
28
|
+
|
|
29
|
+
const visible = shallowRef(false)
|
|
30
|
+
|
|
31
|
+
async function submit(): Promise<boolean> {
|
|
32
|
+
await save()
|
|
33
|
+
return true
|
|
34
|
+
}
|
|
35
|
+
</script>
|
|
36
|
+
|
|
37
|
+
<template>
|
|
38
|
+
<OgDialog v-model="visible" title="编辑" :og-confirm-handler="submit">
|
|
39
|
+
<p>弹窗内容</p>
|
|
40
|
+
</OgDialog>
|
|
41
|
+
</template>
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## 与 OgForm 集成
|
|
45
|
+
|
|
46
|
+
当内容组件实现 `validate()` 与 `getSubmitModel()` 时,OgDialog 会在确认前自动校验并读取提交模型。`ogCloseGuard` 可以拦截遮罩、Escape、父级隐藏、编程关闭以及确认/完成流程;用户明确点击默认取消按钮、右上角关闭图标、header 插槽的 `close()`、footer 插槽的 `cancel()` 或调用 `requestClose('cancelled')` 时会绕过该守卫,但仍受 `ogCancelable` 和未保存内容保护控制。右上角图标与 header `close()` 和显式取消按钮保持同一语义。
|
|
47
|
+
|
|
48
|
+
### 泛型 SFC
|
|
49
|
+
|
|
50
|
+
`OgDialog` 使用 Vue 3.5 泛型 SFC。通过 `@vue-generic` 指定 payload 和动态内容组件
|
|
51
|
+
props 后,`ogConfirmHandler`、`ogCloseGuard`、`ogFooter` 及 `complete()` 会共享这两个类型参数:
|
|
52
|
+
|
|
53
|
+
```vue
|
|
54
|
+
<script setup lang="ts">
|
|
55
|
+
import type { DialogAction } from '@origen-ui/dialog'
|
|
56
|
+
import { shallowRef } from 'vue'
|
|
57
|
+
|
|
58
|
+
interface EditorPayload {
|
|
59
|
+
saved: boolean
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
interface EditorProps extends Record<string, unknown> {
|
|
63
|
+
recordId: string
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
const visible = shallowRef(true)
|
|
67
|
+
const editorProps: EditorProps = { recordId: '42' }
|
|
68
|
+
const footer: DialogAction<EditorPayload>[] = [
|
|
69
|
+
{
|
|
70
|
+
text: '保存草稿',
|
|
71
|
+
onClick: async ({ complete, getPayload }) => {
|
|
72
|
+
await complete('save-draft', getPayload())
|
|
73
|
+
},
|
|
74
|
+
},
|
|
75
|
+
]
|
|
76
|
+
</script>
|
|
77
|
+
|
|
78
|
+
<template>
|
|
79
|
+
<!-- @vue-generic {EditorPayload, EditorProps} -->
|
|
80
|
+
<OgDialog v-model="visible" :og-component-props="editorProps" :og-footer="footer" />
|
|
81
|
+
</template>
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## 典型用法
|
|
85
|
+
|
|
86
|
+
<div id="dialog-form-guard"></div>
|
|
87
|
+
### 表单 payload 与关闭守卫
|
|
88
|
+
|
|
89
|
+
OgDialog 调用真实 OgForm 的校验与提交模型;取消按钮始终可用,未开启许可时遮罩和 Escape 关闭会被阻止。
|
|
90
|
+
|
|
91
|
+
## 高级能力
|
|
92
|
+
|
|
93
|
+
<div id="dialog-confirm-feedback"></div>
|
|
94
|
+
<div id="dialog-async-confirm"></div>
|
|
95
|
+
<div id="dialog-presentation"></div>
|
|
96
|
+
<div id="dialog-feedback"></div>
|
|
97
|
+
### 展示配置、确认加载与失败反馈
|
|
98
|
+
|
|
99
|
+
合并 Dialog/Drawer 展示配置、异步确认和失败反馈,覆盖关闭与加载状态。
|
|
100
|
+
|
|
101
|
+
## API
|
|
102
|
+
|
|
103
|
+
## 命令式弹窗
|
|
104
|
+
|
|
105
|
+
应用通过 `app.use(createOgDialog())` 安装 manager,并在根部放置一个 `<OgDialogHost />` 后,可通过 `useDialog().open()` 在当前应用上下文中挂载内容组件。每次调用返回独立的 `{ close, update, result }` 句柄,支持多个弹窗同时存在。`result` 是可等待的 `Promise<DialogOutcome>`;确认或 action 抛错时弹窗保持打开,并通过 `confirmError` / `actionError` 回调报告异常,不会伪造一个错误 outcome。
|
|
106
|
+
|
|
107
|
+
需要显式管理多个应用上下文时,可从根入口或 runtime 入口创建 manager,并传给 Host:
|
|
108
|
+
|
|
109
|
+
```ts
|
|
110
|
+
import { createDialogManager } from '@origen-ui/dialog'
|
|
111
|
+
|
|
112
|
+
const manager = createDialogManager({
|
|
113
|
+
defaults: { protectUnsaved: true },
|
|
114
|
+
feedback: {},
|
|
115
|
+
locale: { cancelText: '取消', confirmText: '保存' },
|
|
116
|
+
})
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
```vue
|
|
120
|
+
<OgDialogHost :manager="manager" />
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
显式 manager 与 `useDialog()` 使用同一套 `DialogService` 契约;Host 仍必须挂在目标
|
|
124
|
+
Vue 应用树中,才能保留动态内容的依赖注入上下文。Host 会在内部解析与该 manager 关联的
|
|
125
|
+
运行时配置,并将 locale、feedback 和 defaults 提供给所有子 `OgDialog`,因此显式 manager
|
|
126
|
+
与插件安装路径保持一致;动态内容中的 `useDialog()` 也使用该显式 manager,单次 dialog
|
|
127
|
+
props 仍拥有更高优先级。`actionSignal`、`closeRequest`、`scopeId` 和 `sessionId` 是 Host
|
|
128
|
+
通过内部 session context 传递的字段,不属于公开 `OgDialog` props。
|
|
129
|
+
|
|
130
|
+
### OgDialogHost Props
|
|
131
|
+
|
|
132
|
+
| 属性 | 类型 | 默认值 | 说明 |
|
|
133
|
+
| --------- | --------------- | -------------- | --------------------------------------------------------------------------- |
|
|
134
|
+
| `manager` | `DialogManager` | 注入的 manager | 可选地显式指定命令式弹窗管理器;未传入时要求应用已安装 `createOgDialog()`。 |
|
|
135
|
+
|
|
136
|
+
同一 manager 的第一个已挂载 Host 是活动 Host,后续 Host 待命且不重复渲染会话。活动 Host
|
|
137
|
+
卸载时最早注册的待命 Host 接管;最后一个 Host 卸载会以 `host-disposed` 结束尚未完成的句柄。
|
|
138
|
+
`DialogHandle.close()` 是幂等的关闭请求:同一会话的并发重复调用不会产生额外 outcome,调用方应
|
|
139
|
+
读取每次返回的 `boolean`,而不是假定第二次关闭成功。
|
|
140
|
+
|
|
141
|
+
```vue
|
|
142
|
+
<script setup lang="ts">
|
|
143
|
+
import { OgForm, useDialog } from 'origen-ui'
|
|
144
|
+
|
|
145
|
+
function handleOpen(): void {
|
|
146
|
+
const dialog = useDialog().open({
|
|
147
|
+
title: '编辑',
|
|
148
|
+
component: OgForm,
|
|
149
|
+
props: { fields: [] },
|
|
150
|
+
onConfirm: async (model) => {
|
|
151
|
+
await save(model)
|
|
152
|
+
return true
|
|
153
|
+
},
|
|
154
|
+
})
|
|
155
|
+
|
|
156
|
+
dialog.update({ presentation: { type: 'dialog', width: 720 } })
|
|
157
|
+
}
|
|
158
|
+
</script>
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
### 命令式补充
|
|
162
|
+
|
|
163
|
+
- `dialogKey`、`scopeId` 与 `duplicatePolicy` 属于会话身份,只能在 `open()` 时指定;`DialogHandle.update()` 的类型不接受这些字段,运行时也不会迁移身份。空字符串是合法的 key 或 scope 值。
|
|
164
|
+
- manager 会复制 `ogFooter` 数组及其 action 对象,并复制 `ogMetadata`、`ogPresentation` 配置对象。修改传入对象不会直接改变现有会话;请用 `handle.update()` 更新投影。动态内容 `props` 保留原引用,因此调用方传入的 reactive props 仍保持响应性。
|
|
165
|
+
|
|
166
|
+
- `dialogKey`:相同 key 重复打开时默认保留已有会话,新句柄以 `{ status: 'cancelled', reason: 'duplicate' }` 结束。传入 `duplicatePolicy: 'replace'` 可中止并替换旧会话。
|
|
167
|
+
- 自定义 action 的 `onClick` 收到 `{ signal, close, confirm, complete, getPayload }`。调用 `complete('save-draft')` 会以 `{ status: 'completed', action: 'save-draft', payload }` 完成;`complete('save-draft', payload, { validate: true })` 可在完成前强制校验。
|
|
168
|
+
- `complete` 既可用于 Expose 实例方法,也可在命令式 action 上下文中调用。
|
|
169
|
+
- `complete` 的 action 不能为空。空 action 会以 `A completed close requires an action name.` reject,不会触发 `confirmError` 或关闭请求;若它发生在 footer action 内,则由外层流程报告 `actionError` 并保持弹窗打开。
|
|
170
|
+
|
|
171
|
+
## 常用操作导航
|
|
172
|
+
|
|
173
|
+
本节只帮助按场景定位能力,不重复定义参数、默认值和结果结构;根入口符号、命令式结果与组件事件以[完整公开导出](#完整公开导出)、[事件表](#事件表)和[Expose API](#expose-api)为准。
|
|
174
|
+
|
|
175
|
+
| 类别 | 可用能力 |
|
|
176
|
+
| ---------- | ----------------------------------------------------------------------------- |
|
|
177
|
+
| 受控显示 | `v-model`、`title`、`ogPresentation`、`ogShowFooter`、`destroyOnClose` |
|
|
178
|
+
| 确认与关闭 | `ogConfirmHandler`、`ogCloseGuard`、`confirm`、`close` |
|
|
179
|
+
| 内容协议 | `contentApi` 或实现 `validate` / `getSubmitModel` 的内容组件 |
|
|
180
|
+
| 命令式 | `createOgDialog`、`useDialog().open`、`OgDialogHost`、句柄 `update`、`result` |
|
|
181
|
+
|
|
182
|
+
## 完整公开导出
|
|
183
|
+
|
|
184
|
+
### 官方表面事件类型:`OgDialogElementEvents`、`OgDrawerElementEvents`
|
|
185
|
+
|
|
186
|
+
`OgDialogComponentPresentation` 用于区分 OgDialog 与 OgDrawer 的封装层展示选项。
|
|
187
|
+
|
|
188
|
+
`ogDialogEvents` 与 `ogDrawerEvents` 是官方 Dialog/Drawer 生命周期回调入口。Element Plus 普通属性直接放在组件顶层,按 `ogPresentation.type` 选择的 Dialog 或 Drawer 表面定型;`modelValue` 与 `beforeClose` 由 OgDialog 工作流接管。官方属性和事件详情参考 Element Plus 官方文档。
|
|
189
|
+
|
|
190
|
+
以下清单对应 `@origen-ui/dialog` 的根入口 `src/index.ts`。类型导出不会自动生成运行时对象,但它们是组件配置、事件载荷和命令句柄的公共契约。
|
|
191
|
+
|
|
192
|
+
| 分类 | 导出 |
|
|
193
|
+
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
194
|
+
| 工厂与注入 | `createOgDialog`、`createDialogManager`、`useDialog`、`useOgDialogRuntimeConfig` |
|
|
195
|
+
| 组件 | `OgDialog`、`OgDialogHost` |
|
|
196
|
+
| locale 常量 | `OG_DIALOG_LOCALE_EN_US`、`OG_DIALOG_LOCALE_ZH_CN`、`OG_DIALOG_LOCALE_ZH_TW` |
|
|
197
|
+
| 服务与模型 | `DialogManager`、`DialogService`、`DialogScope`、`DialogModel`、`DialogHandle`、`DialogOutcome`、`OpenDialogOptions`、`DialogUpdateOptions`、`CreateOgDialogOptions`、`OgDialogPlugin` |
|
|
198
|
+
| 生命周期与动作 | `DialogAction`、`DialogActionContext`、`DialogCancelContext`、`DialogCloseContext`、`DialogCloseGuard`、`DialogCloseReason`、`DialogRequestCloseReason`、`DialogTerminalCloseReason`、`DialogCompleteOptions`、`DialogConfirmHandler`、`DialogDiscardContext`、`DialogErrorContext`、`DialogErrorPhase`、`DialogLifecycleEvent`、`DialogLifecycleEventType` |
|
|
199
|
+
| 配置与展示 | `OgDialogProps`、`OgDialogExpose`、`OgDialogDefaults`、`OgDialogFeedback`、`OgDialogLocale`、`OgDialogPresentation`、`OgDialogComponentPresentation`、`OgDialogRuntimeConfig`、`DialogPresentationOptions`、`DrawerPresentationOptions`、`DrawerDirection` |
|
|
200
|
+
| 内容与范围 | `DialogContentRef`、`DialogMetadata`、`DialogCloseAllOptions`、`DialogCloseAllResult` |
|
|
201
|
+
|
|
202
|
+
`useOgDialogRuntimeConfig()` 返回应用级解析配置;实例 Props 的显式值优先于运行时默认值。`DialogService` 仅在安装 `createOgDialog()` 后可用,不能通过隐式全局单例取得。
|
|
203
|
+
|
|
204
|
+
### 打开、更新与结果
|
|
205
|
+
|
|
206
|
+
`DialogService.open(options)` 要求传入动态 `component`,可选 `props`、`dialogKey`、`duplicatePolicy`、`scopeId`、`onConfirm`、`onCancel`、`onClosed` 和错误回调。返回的 `DialogHandle` 同时是 `PromiseLike<DialogOutcome>`,并提供 `close()`、`update(options)` 与 `result`:
|
|
207
|
+
|
|
208
|
+
```ts
|
|
209
|
+
const handle = dialog.open({
|
|
210
|
+
component: EditorForm,
|
|
211
|
+
dialogKey: 'editor',
|
|
212
|
+
duplicatePolicy: 'preserve',
|
|
213
|
+
props: { modelValue: draft },
|
|
214
|
+
onClosed: (outcome) => console.log(outcome),
|
|
215
|
+
})
|
|
216
|
+
|
|
217
|
+
handle.update({ title: '编辑草稿', presentation: { type: 'dialog', width: 720 } })
|
|
218
|
+
const outcome = await handle.result
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
`DialogOutcome` 只有三种形态:`{ status: 'confirmed', payload }` 表示确认完成,`{ status: 'completed', action, payload }` 表示自定义 action 完成,`{ status: 'cancelled', reason }` 表示用户请求或会话终止。`reason` 可以是 `cancelled`、`dismissed`、`programmatic`、`duplicate`、`replaced` 或 `host-disposed`;重复 key 默认产生 `duplicate`,`duplicatePolicy: 'replace'` 会让旧句柄收到 `replaced`。
|
|
222
|
+
|
|
223
|
+
`confirmHandler`、内容校验、关闭守卫或自定义 action 抛出的异常不会解析为 `DialogOutcome`,而是触发对应的 `confirmError`、`closeError` 或 `actionError` 回调并保持会话可恢复。非法 `complete` action 属于调用契约错误,会直接 reject,不归类为 `confirmError`。`onConfirmError`、`onCloseError` 和 `onActionError` 是命令式打开选项中的错误回调;需要展示通用错误提示时启用 `errorFeedback`。
|
|
224
|
+
|
|
225
|
+
::: tip 设计原则
|
|
226
|
+
|
|
227
|
+
业务状态与保存逻辑留在调用方;弹窗只负责打开、校验、确认与关闭生命周期。这样同一个内容组件既能嵌入页面,也能被命令式弹窗复用。
|
|
228
|
+
|
|
229
|
+
:::
|
|
230
|
+
|
|
231
|
+
manager 遇到动态内容 setup/render 或 footer action `show()` 的致命生命周期异常时,会触发一次 lifecycle `error`,中止并移除该会话,并以 `{ status: 'cancelled', reason: 'dismissed' }` 结算结果;动态渲染异常也会继续传递到 Vue 应用的 `errorHandler`。runtime `onError` 回调收到 `phase: 'lifecycle'` 和原始异常。`onOpened`、`onClosed` 等观察回调抛错也会报告 lifecycle `error`,但不会重复结算会话。confirm、action、closeGuard 等可恢复错误继续通过 `confirmError`、`actionError`、`closeError` 对应路径报告,不会改成致命终结。
|
|
232
|
+
|
|
233
|
+
## 事件表
|
|
234
|
+
|
|
235
|
+
| 名称 | 类型 | 说明 |
|
|
236
|
+
| ------------------- | ---------------------------------------- | -------------------------------------------------------------------- |
|
|
237
|
+
| `update:modelValue` | `(value: boolean) => void` | `v-model` 绑定,弹窗可见性变化时触发 |
|
|
238
|
+
| `open` | `() => void` | 弹窗开始打开时触发 |
|
|
239
|
+
| `opened` | `() => void` | 弹窗打开动画结束后触发 |
|
|
240
|
+
| `closed` | `() => void` | 弹窗关闭动画结束后触发 |
|
|
241
|
+
| `confirm` | `(model: DialogModel) => void` | 确认操作成功时触发,携带当前 payload |
|
|
242
|
+
| `cancel` | `(context: DialogCancelContext) => void` | 用户取消或关闭弹窗时触发,携带取消原因与 payload |
|
|
243
|
+
| `close` | `(context: DialogCloseContext) => void` | 每次关闭请求被接受时触发,携带完整关闭上下文(含 reason 与 payload) |
|
|
244
|
+
| `actionError` | `(error: unknown) => void` | 自定义 action 的 `onClick` 抛出异常时触发 |
|
|
245
|
+
| `confirmError` | `(error: unknown) => void` | 确认流程(`confirmHandler` 或内容校验)抛出异常时触发 |
|
|
246
|
+
| `closeError` | `(error: unknown) => void` | 关闭守卫或脏检查流程抛出异常时触发 |
|
|
247
|
+
|
|
248
|
+
## Expose API
|
|
249
|
+
|
|
250
|
+
通过 `ref` 获取组件实例后,可调用以下方法:
|
|
251
|
+
|
|
252
|
+
| 名称 | 参数 | 返回值 | 说明 |
|
|
253
|
+
| -------------------- | -------------------------------------------------------------------------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------- |
|
|
254
|
+
| `open` | 无 | `void` | 手动打开弹窗 |
|
|
255
|
+
| `close` | 无 | `Promise<boolean>` | 以 `programmatic` 原因请求关闭,返回是否成功关闭 |
|
|
256
|
+
| `confirm` | 无 | `Promise<boolean>` | 手动触发确认流程(校验 + `confirmHandler`),返回是否成功 |
|
|
257
|
+
| `complete` | `(action: string, payload?: DialogModel, options?: DialogCompleteOptions)` | `Promise<boolean>` | 以指定 action 完成弹窗,可用于自定义动作(如 `save-draft`);`options.validate` 控制是否校验 |
|
|
258
|
+
| `getPayload` | 无 | `DialogModel \| undefined` | 获取当前内容组件的提交模型 |
|
|
259
|
+
| `registerContent` | `(content: FormActionExpose \| null)` | `void` | 手动注册内容组件的表单协议引用(通常由内部自动调用) |
|
|
260
|
+
| `requestClose` | `(reason: DialogRequestCloseReason)` | `Promise<boolean>` | 以指定原因(`cancelled` / `dismissed` / `programmatic`)请求关闭,返回是否成功 |
|
|
261
|
+
| `setLoading` | `(value: boolean)` | `void` | 手动设置弹窗 loading 状态 |
|
|
262
|
+
| `getSurfaceInstance` | 无 | `DialogInstance \| DrawerInstance \| undefined` | 获取当前实际挂载的 Element Plus Dialog 或 Drawer 实例。 |
|
|
263
|
+
|
|
264
|
+
## Props 补充
|
|
265
|
+
|
|
266
|
+
### `ogPresentation` 与官方表面属性
|
|
267
|
+
|
|
268
|
+
`ogPresentation.type` 是表面判别值。省略或设为 `'dialog'` 时使用居中弹窗;设为 `'drawer'` 时使用方向抽屉。Element Plus 官方属性直接放在 OgDialog 顶层:Dialog 使用 `width`、`top`、`fullscreen`、`draggable` 等;Drawer 使用 `size`、`direction`。两种形态共享表单校验、异步确认、未保存保护和关闭结果。
|
|
269
|
+
|
|
270
|
+
```vue
|
|
271
|
+
<OgDialog
|
|
272
|
+
v-model="visible"
|
|
273
|
+
title="编辑用户"
|
|
274
|
+
:og-presentation="{ type: 'drawer' }"
|
|
275
|
+
direction="rtl"
|
|
276
|
+
size="480px"
|
|
277
|
+
>
|
|
278
|
+
<UserForm />
|
|
279
|
+
</OgDialog>
|
|
280
|
+
```
|
|
281
|
+
|
|
282
|
+
| 形态 | 可用配置 | 默认值 |
|
|
283
|
+
| ------ | --------------------------------------------------------------------------------------------------- | ---------------------------------------- |
|
|
284
|
+
| Dialog | 顶层 `width`、`top`、`fullscreen`、`draggable`;`ogPresentation.resizable`、`minWidth`、`minHeight` | `width: '520px'`,缩放最小值 `320 × 180` |
|
|
285
|
+
| Drawer | 顶层 `size`、`direction` | `size: '520px'`,`direction: 'rtl'` |
|
|
286
|
+
|
|
287
|
+
桌面端仅 Dialog 支持拖拽缩放;Dialog 与 Drawer 的宽度会自动限制在视口内,避免传入过大的 `width` 或 `size` 时产生水平溢出;小于 768px 时两者均占满视口。`DialogHandle.update()` 更新 `ogPresentation` 时必须传入完整对象,组件不会深合并旧配置。
|
|
288
|
+
|
|
289
|
+
桌面端 Dialog 可通过 `ogPresentation.resizable` 启用键盘和指针缩放。最大宽度按视口宽度减去两侧间距计算,最大高度同时受视口高度、表面实际 `top` 和底部间距约束。若可用空间小于 `minWidth` 或 `minHeight`,会优先满足视口边界,实际尺寸允许低于配置的最小值;可用空间为零时尺寸为零。缩放从实际 surface 尺寸开始,`%`、`vw`、`rem`、`calc()` 等 CSS 宽度不会被直接当作像素解析。
|
|
290
|
+
|
|
291
|
+
### 无障碍名称
|
|
292
|
+
|
|
293
|
+
默认标题会作为 **Dialog 表面**的弹层名称。当前 Element Plus Drawer 会在 `role="dialog"` 节点上用非空 `title` 设置 `aria-label`;`title` 为空时会将 `aria-labelledby` 指向内部标题节点。需要覆盖非空标题对应的名称时,可以显式传入 `aria-label`。省略 Drawer 的 `title` 时,应提供指向有效名称元素的 `aria-labelledby`;它优先于 `aria-label`,因此不能让它继续指向空标题节点。
|
|
294
|
+
|
|
295
|
+
### errorFeedback
|
|
296
|
+
|
|
297
|
+
| 属性名 | 类型 | 默认值 | 说明 |
|
|
298
|
+
| ----------------- | --------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
299
|
+
| `ogErrorFeedback` | `boolean` | `true` | 控制是否在 `actionError`、`confirmError`、`closeError` 事件触发时,额外通过 `ElMessage.error` 显示通用错误提示。关闭后仅保留事件通知,不弹出消息 |
|
|
300
|
+
|
|
301
|
+
### protectUnsaved
|
|
302
|
+
|
|
303
|
+
| 属性名 | 类型 | 默认值 | 说明 |
|
|
304
|
+
| ------------------ | --------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
305
|
+
| `ogProtectUnsaved` | `boolean` | `true` | 在非确认类关闭(取消、遮罩点击等)时,若内容组件实现了 `isDirty()` 方法,会弹出二次确认对话框提示用户是否放弃未保存的修改。确认和完成动作不受此检查影响 |
|
|
306
|
+
|
|
307
|
+
## 完整 Props 与插槽
|
|
308
|
+
|
|
309
|
+
| 属性 | 类型 | 默认值 | 说明 |
|
|
310
|
+
| ------------------------------------------ | ----------------------------------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
311
|
+
| `v-model` | `boolean` | - | 必填。控制可见性。 |
|
|
312
|
+
| `title` | `string` | `''` | 标题和默认无障碍名称。 |
|
|
313
|
+
| `ogPresentation` | `OgDialogComponentPresentation` | Dialog | 选择 Dialog/Drawer 表面,并配置 OgDialog 的可调整尺寸选项;官方尺寸属性直接放根层。 |
|
|
314
|
+
| `ogMetadata` | `Record<string, string \| number \| boolean \| null>` | - | 生命周期观测使用的安全标量上下文。 |
|
|
315
|
+
| `ogComponent` / `ogComponentProps` | `Component` / `Record<string, unknown>` | - | 动态内容组件及其 Props。命令式 `open()` 使用 `component` / `props` 选项。 |
|
|
316
|
+
| `ogContentApi` | `MaybeRefOrGetter<DialogContentRef>` | - | 注册插槽内容的表单式命令接口。 |
|
|
317
|
+
| `ogLocale` | `Partial<OgDialogLocale>` | 中文预设 | 覆盖操作和错误文案。 |
|
|
318
|
+
| `ogConfirmHandler` | `DialogConfirmHandler` | - | 确认回调;返回 `false` 时保持打开。 |
|
|
319
|
+
| `ogConfirmLoading` / `ogLoading` | `boolean` | `false` | 分别控制确认按钮和内容区域 loading。 |
|
|
320
|
+
| `ogProtectUnsaved` / `ogErrorFeedback` | `boolean` | 运行时默认值 | 启用未保存保护或通用错误反馈。 |
|
|
321
|
+
| `destroyOnClose` | `boolean` | 运行时默认值 | 关闭后销毁内容。 |
|
|
322
|
+
| `ogCancelable` | `boolean` | `true` | 统一的用户取消策略。`false` 时隐藏默认取消按钮和原生关闭图标,禁用遮罩与 Escape,并拒绝 `cancelled` / `dismissed` 关闭请求。 |
|
|
323
|
+
| `ogShowFooter` / `showClose` | `boolean` | 运行时默认值 | 显示默认底栏或关闭按钮;`ogCancelable=false` 时不能重新显示原生关闭按钮。 |
|
|
324
|
+
| `closeOnClickModal` / `closeOnPressEscape` | `boolean` | 运行时默认值 | 允许遮罩点击或 Escape 请求关闭;`cancelable=false` 时不能重新启用。 |
|
|
325
|
+
| `appendToBody` | `boolean` | 运行时默认值 | 将浮层挂载到 `body`。 |
|
|
326
|
+
| `class` | `string` | - | 透传到当前 Dialog 或 Drawer 表面的 CSS class。 |
|
|
327
|
+
| `ogFooter` | `DialogAction[]` | - | 默认底栏中的自定义操作。 |
|
|
328
|
+
| `ogCloseGuard` | `DialogCloseGuard` | - | 遮罩、Escape、父级隐藏、编程及确认/完成关闭请求的异步守卫;默认取消、右上角关闭图标、header `close()`、`cancel()` 和 `requestClose('cancelled')` 会绕过它。 |
|
|
329
|
+
| Element Plus props | 当前表面的 `DialogProps` 或 `DrawerProps` | 依 Element Plus | 官方普通属性直接放在根层;`modelValue`、`beforeClose` 由 OgDialog 工作流接管。 |
|
|
330
|
+
| `ogDialogEvents` | `OgDialogElementEvents` | - | `dialog` 表面的 Element Plus 生命周期与焦点事件回调;与 `ogPresentation.type: 'dialog'` 配合使用。 |
|
|
331
|
+
| `ogDrawerEvents` | `OgDrawerElementEvents` | - | `drawer` 表面的 Element Plus 生命周期、焦点及 resize 事件回调;与 `ogPresentation.type: 'drawer'` 配合使用。 |
|
|
332
|
+
|
|
333
|
+
`sessionId`、`scopeId`、`closeRequest` 与 `actionSignal` 是 DialogManager 桥接字段,业务组件不应直接传入。
|
|
334
|
+
|
|
335
|
+
`ogCancelable=false` 只管理 OgDialog 提供的默认取消入口。自定义 `header` 或 `footer` 中的按钮由调用方决定是否渲染;即使自定义按钮调用 `close` 或 `cancel`,请求也会返回 `false`,不会关闭弹窗。
|
|
336
|
+
|
|
337
|
+
| 插槽 | 作用域参数 | 说明 |
|
|
338
|
+
| --------- | ------------------------------------------- | --------------------------------------------------------- |
|
|
339
|
+
| `default` | `{ confirming, registerContent }` | 弹窗正文;表单式内容通过 `registerContent` 接入确认流程。 |
|
|
340
|
+
| `header` | `{ close, title, titleClass, titleId }` | 自定义标题区域。 |
|
|
341
|
+
| `footer` | `{ cancel, confirm, complete, confirming }` | 自定义底栏操作。 |
|
|
342
|
+
|
|
343
|
+
## 批量关闭与作用域
|
|
344
|
+
|
|
345
|
+
`useDialog()` 返回的公共服务提供 `closeAll(options?)` 和 `createScope(id)`。`closeAll()` 会按正常关闭流程依次请求关闭,`mode: 'force'` 会直接结束匹配的会话;两者都会返回可等待的关闭结果。
|
|
346
|
+
|
|
347
|
+
```ts
|
|
348
|
+
import { useDialog } from 'origen-ui'
|
|
349
|
+
|
|
350
|
+
const dialog = useDialog()
|
|
351
|
+
|
|
352
|
+
// 依次请求关闭所有弹窗,并等待结果
|
|
353
|
+
const result = await dialog.closeAll()
|
|
354
|
+
|
|
355
|
+
// 将路由或功能区的弹窗限制在独立作用域
|
|
356
|
+
const editorDialogs = dialog.createScope('route-editor')
|
|
357
|
+
editorDialogs.open({ component: EditorForm })
|
|
358
|
+
|
|
359
|
+
// 强制结束该作用域内的全部弹窗
|
|
360
|
+
await editorDialogs.closeAll({ mode: 'force' })
|
|
361
|
+
```
|
|
362
|
+
|
|
363
|
+
常规 `closeAll()` 被守卫阻止时会返回 `{ blocked: true, closed }`;强制模式返回 `{ blocked: false, closed }`。每个句柄的 `result` 和 `onClosed` 仍会收到对应的关闭结果。
|
|
364
|
+
|
|
365
|
+
## 相关组合示例
|
|
366
|
+
|
|
367
|
+
命令式 Host、替换和作用域销毁流程见[内容与弹窗场景](../../.agents/skills/admin-component-usage/references/component-directory.md);表单确认入口保留在本页典型用法中。
|
|
368
|
+
|
|
369
|
+
<!-- component-contract:start -->
|
|
370
|
+
|
|
371
|
+
## 公共契约
|
|
372
|
+
|
|
373
|
+
> 由组件目录生成;每条记录对应可公开导入的组件及其消费者 API 摘要。
|
|
374
|
+
|
|
375
|
+
### Imports
|
|
376
|
+
|
|
377
|
+
- `dialog`: `import { OgDialog } from '@origen-ui/dialog'`
|
|
378
|
+
- `dialog-host`: `import { OgDialogHost } from '@origen-ui/dialog'`
|
|
379
|
+
|
|
380
|
+
### Props
|
|
381
|
+
|
|
382
|
+
- `dialog`: `modelValue`, `ogCloseGuard`, `ogPresentation`, `ogMetadata`, `ogComponent`, `ogComponentProps`, `ogContentApi`, `ogLocale`, `ogConfirmHandler`, `ogConfirmLoading`, `ogLoading`, `ogProtectUnsaved`, `ogCancelable`, `ogErrorFeedback`, `ogShowFooter`, `ogFooter`, `ogDialogEvents`, `ogDrawerEvents`
|
|
383
|
+
- `dialog-host`: `manager`
|
|
384
|
+
|
|
385
|
+
### Events
|
|
386
|
+
|
|
387
|
+
- `dialog`: `update:modelValue`, `confirm`, `cancel`, `actionError`, `close`, `closeError`, `closeResult`, `closed`, `confirmError`, `open`, `opened`
|
|
388
|
+
- `dialog-host`: 无
|
|
389
|
+
|
|
390
|
+
### Slots
|
|
391
|
+
|
|
392
|
+
- `dialog`: `default`, `header`, `footer`
|
|
393
|
+
- `dialog-host`: 无
|
|
394
|
+
|
|
395
|
+
### Exposes
|
|
396
|
+
|
|
397
|
+
- `dialog`: `open`, `close`, `confirm`, `complete`, `getPayload`, `registerContent`, `requestClose`, `setLoading`, `getSurfaceInstance`
|
|
398
|
+
- `dialog-host`: 无
|
|
399
|
+
|
|
400
|
+
### Types
|
|
401
|
+
|
|
402
|
+
- `dialog`:属性类型:`OgDialogProps`;公开方法类型:无
|
|
403
|
+
- `dialog-host`:属性类型:由公开 Vue 组件推断,未单独导出属性类型;公开方法类型:无
|
|
404
|
+
|
|
405
|
+
<!-- component-contract:end -->
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: OgEditorViewer
|
|
3
|
+
description: 安全展示 OgEditor HTML 内容的只读组件。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# OgEditorViewer
|
|
7
|
+
|
|
8
|
+
## 基础用法
|
|
9
|
+
|
|
10
|
+
`OgEditorViewer` 用于展示 `OgEditor` 生成的 HTML。组件在挂载后清洗内容,只保留编辑器允许的标签、属性和安全 URL;服务端在入库与输出时仍应执行自己的 HTML 清洗策略。
|
|
11
|
+
|
|
12
|
+
<div id="viewer-security"></div>
|
|
13
|
+
### 安全内容展示
|
|
14
|
+
|
|
15
|
+
逐项对照输入 HTML 与内置清洗输出,核对判空结果与空态文案优先级,并在宽媒体样例上观察桌面与窄屏的实际布局。
|
|
16
|
+
|
|
17
|
+
## 典型用法
|
|
18
|
+
|
|
19
|
+
```vue
|
|
20
|
+
<script setup lang="ts">
|
|
21
|
+
import { OgEditorViewer } from '@origen-ui/editor'
|
|
22
|
+
</script>
|
|
23
|
+
|
|
24
|
+
<template>
|
|
25
|
+
<OgEditorViewer :og-content="article.content" og-empty-text="暂无内容" />
|
|
26
|
+
</template>
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## API
|
|
30
|
+
|
|
31
|
+
### Attributes
|
|
32
|
+
|
|
33
|
+
| 属性 | 类型 | 默认值 | 说明 |
|
|
34
|
+
| ------------------ | ----------------------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
|
|
35
|
+
| `ogSsrMode` | `'text' \| 'html'` | `'text'` | SSR 输出纯文本或显式 HTML 模式。 |
|
|
36
|
+
| `ogServerSanitize` | `(html: string) => string` | - | `ogSsrMode="html"` 时使用的服务端净化函数。 |
|
|
37
|
+
| `ogContent` | `string` | `''` | 要展示的 HTML 内容。 |
|
|
38
|
+
| `ogEmptyText` | `string` | 当前 locale 的空内容文案 | 内容被判空、或清洗结果为空字符串时展示的文本。判空作用于**原始 `ogContent`**,与清洗结果无关。 |
|
|
39
|
+
| `ogLocale` | `DeepPartial<OgEditorLocale>` | 继承应用级 locale | 覆盖空内容等查看器文案;局部值优先于全局值。 |
|
|
40
|
+
| `ogSanitize` | `(html: string) => string` | 无(回退应用级 `createOgEditor({ ogSanitize })`,再回退内置清洗) | 覆盖默认清洗函数。仅传入可信且经过审查的实现。 |
|
|
41
|
+
|
|
42
|
+
组件不暴露事件、插槽或实例方法。
|
|
43
|
+
|
|
44
|
+
SSR 默认使用 `ogSsrMode="text"` 输出安全纯文本。需要服务端 HTML 时,显式设置 `ogSsrMode="html"` 并提供 `ogServerSanitize`;浏览器端 `ogSanitize` 不承担无 DOM 的服务端净化职责。
|
|
45
|
+
|
|
46
|
+
## 高级能力
|
|
47
|
+
|
|
48
|
+
## 公开导出与安全边界
|
|
49
|
+
|
|
50
|
+
`OgEditorViewer` 直接使用包内导出的 `isEditorHtmlEmpty` 与 `sanitizeEditorHtml`,并在内部使用未公开导出的 `extractEditorText`。URL 安全判定发生在 `sanitizeEditorHtml` 的 URI 白名单内,`isSafeUrl` / `isSafeMediaUrl` 是编辑器侧的导出工具,`OgEditorViewer` 本身不调用它们。完整导出清单见 [OgEditor 安全 API](./editor.md#完整公开导出)。
|
|
51
|
+
|
|
52
|
+
组件在服务端/挂载前输出可安全插入的纯文本占位;挂载后才调用清洗器并渲染 HTML。
|
|
53
|
+
|
|
54
|
+
### 自定义 sanitizer 信任边界
|
|
55
|
+
|
|
56
|
+
- 清洗函数按 `props.ogSanitize?.(ogContent) ?? globalConfig?.ogSanitize?.(ogContent) ?? sanitizeEditorHtml(ogContent)` 解析。只要回调返回非空字符串,应用级与内置清洗都不会被调用。这里的回退是 `??` 的**运行时**语义:`ogSanitize` 的类型是 `(html: string) => string`,返回 `null`/`undefined` 在 TypeScript 下已是类型错误,但运行时仍会回退到应用级 `ogSanitize`、再回退到内置 `sanitizeEditorHtml`。因此它是**替换**而不是“额外加固”选项。
|
|
57
|
+
- 回调返回值会被直接交给 `v-html`,因此回调**必须返回已经安全的 HTML**。若回调原样返回输入,`OgEditorViewer` 会失去全部清洗能力。
|
|
58
|
+
- 回调返回 `''` 会把非空内容静默变成空态(见下面的分支表),这也是信任边界的一部分。
|
|
59
|
+
- 回调在服务端不会被调用:`safeHtml` 依赖 `mounted`,服务端只走纯文本分支。SSR 输出不依赖 sanitizer 在无 DOM 环境下的行为。
|
|
60
|
+
- 内置 `sanitizeEditorHtml` 在 `typeof window === 'undefined'` 时返回 `''`;`profile: 'trusted'` 会在严格白名单上追加 `iframe` 与 `style`,只能用于已由应用校验过的内容。
|
|
61
|
+
- Demo 中的自定义 sanitizer 把内容压成纯文本(`sanitizeToText`),用于验证“渲染结果等于回调返回值”,它本身不是推荐的安全策略。它在“危险 HTML”样例上会把 `<script>` 的**文本内容**保留为可见文本(内置清洗会整段删除),这正是自定义回调必须逐字审查的原因:文本虽被转义、不会执行,但暴露面已经改变。
|
|
62
|
+
|
|
63
|
+
## 渲染阶段与 SSR 证据
|
|
64
|
+
|
|
65
|
+
模板的判据是 `v-if="safeHtml"`。`safeHtml` 在以下三种情况下都是 `''`:尚未挂载、`isEditorHtmlEmpty(ogContent)` 为真、清洗结果为空字符串。因此“判空函数为 false”**并不足以**进入 `v-html` 分支。
|
|
66
|
+
|
|
67
|
+
| 阶段 | 条件 | 输出 |
|
|
68
|
+
| --------------------------------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
|
|
69
|
+
| 服务端 / 挂载前,内容含可见文本 | `!mounted && ssrText` | `extractEditorText` 抽取的纯文本(经插值转义;不含标签元素,文本里的字面 `<` 同样被转义) |
|
|
70
|
+
| 服务端 / 挂载前,内容为空 | `!mounted && isEditorHtmlEmpty(ogContent)` | 空态文案 |
|
|
71
|
+
| 服务端 / 挂载前,只有媒体或清洗后无文本 | `!mounted && !ssrText` | 空态文案,避免输出空的正文 `<article>` |
|
|
72
|
+
| 挂载后,可渲染 | `mounted && !isEditorHtmlEmpty(ogContent)` 且清洗结果非空字符串 | 清洗结果经 `v-html` 渲染 |
|
|
73
|
+
| 挂载后,其余情况 | `mounted` 且(`isEditorHtmlEmpty(ogContent)` 或清洗结果为 `''`) | 空态文案 |
|
|
74
|
+
|
|
75
|
+
**边界:判空为 `false` 但没有可渲染内容。** SSR 会额外检查抽取后的文本,因此纯媒体内容直接进入空态。客户端仍以清洗结果作为渲染判据:
|
|
76
|
+
|
|
77
|
+
- 客户端:若自定义 `sanitize` 返回只含注释或其他不可见内容的非空字符串,`safeHtml` 仍会渲染出空的 `<article>`;自定义 sanitizer 必须自行保证返回可见且安全的 HTML。
|
|
78
|
+
|
|
79
|
+
对应证据:
|
|
80
|
+
|
|
81
|
+
| 分支 | 证据位置 |
|
|
82
|
+
| ------------------ | -------------------------------------------- |
|
|
83
|
+
| SSR 有内容 | The project test suite covers this behavior. |
|
|
84
|
+
| SSR 无内容 | The project test suite covers this behavior. |
|
|
85
|
+
| CSR 有内容(清洗) | The project test suite covers this behavior. |
|
|
86
|
+
| CSR 有内容(Docs) | The project test suite covers this behavior. |
|
|
87
|
+
| CSR 无内容 | 同上 Docs 浏览器用例 |
|