@h-ai/ui 0.1.0-alpha9 → 1.0.0-beta.10
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.en.md +1062 -0
- package/README.ja.md +1062 -0
- package/README.md +696 -119
- package/auto-import.d.ts +49 -0
- package/auto-import.js +51 -69
- package/dist/components/compounds/Accordion.svelte +30 -3
- package/dist/components/compounds/Accordion.svelte.d.ts +37 -1
- package/dist/components/compounds/ActionSheet.svelte +35 -8
- package/dist/components/compounds/ActionSheet.svelte.d.ts +41 -1
- package/dist/components/compounds/Alert.svelte +24 -15
- package/dist/components/compounds/Alert.svelte.d.ts +14 -3
- package/dist/components/compounds/AppBar.svelte +37 -9
- package/dist/components/compounds/AppBar.svelte.d.ts +36 -1
- package/dist/components/compounds/BottomNav.svelte +68 -8
- package/dist/components/compounds/BottomNav.svelte.d.ts +51 -1
- package/dist/components/compounds/Breadcrumb.svelte +18 -5
- package/dist/components/compounds/Breadcrumb.svelte.d.ts +23 -2
- package/dist/components/compounds/Calendar.svelte +31 -12
- package/dist/components/compounds/Calendar.svelte.d.ts +23 -7
- package/dist/components/compounds/Card.svelte +17 -5
- package/dist/components/compounds/Card.svelte.d.ts +13 -2
- package/dist/components/compounds/Combobox.svelte +124 -42
- package/dist/components/compounds/Combobox.svelte.d.ts +42 -20
- package/dist/components/compounds/Confirm.svelte +32 -9
- package/dist/components/compounds/Confirm.svelte.d.ts +24 -2
- package/dist/components/compounds/DataTable.svelte +317 -33
- package/dist/components/compounds/DataTable.svelte.d.ts +28 -14
- package/dist/components/compounds/DatePicker.svelte +62 -18
- package/dist/components/compounds/DatePicker.svelte.d.ts +27 -8
- package/dist/components/compounds/Drawer.svelte +179 -22
- package/dist/components/compounds/Drawer.svelte.d.ts +24 -2
- package/dist/components/compounds/Dropdown.svelte +19 -5
- package/dist/components/compounds/Dropdown.svelte.d.ts +13 -2
- package/dist/components/compounds/Empty.svelte +22 -9
- package/dist/components/compounds/Empty.svelte.d.ts +23 -2
- package/dist/components/compounds/FilterBar.svelte +82 -0
- package/dist/components/compounds/FilterBar.svelte.d.ts +39 -0
- package/dist/components/compounds/Form.svelte +59 -16
- package/dist/components/compounds/Form.svelte.d.ts +23 -2
- package/dist/components/compounds/FormField.svelte +99 -16
- package/dist/components/compounds/FormField.svelte.d.ts +23 -2
- package/dist/components/compounds/FormLayout.svelte +71 -0
- package/dist/components/compounds/FormLayout.svelte.d.ts +17 -0
- package/dist/components/compounds/InfiniteScroll.svelte +34 -7
- package/dist/components/compounds/InfiniteScroll.svelte.d.ts +37 -1
- package/dist/components/compounds/JsonViewer.svelte +214 -0
- package/dist/components/compounds/JsonViewer.svelte.d.ts +26 -0
- package/dist/components/compounds/MessageBoxContainer.svelte +34 -0
- package/dist/components/compounds/MessageBoxContainer.svelte.d.ts +25 -0
- package/dist/components/compounds/MessageBoxDialog.svelte +209 -0
- package/dist/components/compounds/MessageBoxDialog.svelte.d.ts +29 -0
- package/dist/components/compounds/MessageContainer.svelte +24 -0
- package/dist/components/compounds/MessageContainer.svelte.d.ts +18 -0
- package/dist/components/compounds/Modal.svelte +348 -73
- package/dist/components/compounds/Modal.svelte.d.ts +13 -2
- package/dist/components/compounds/PageHeader.svelte +44 -20
- package/dist/components/compounds/PageHeader.svelte.d.ts +24 -9
- package/dist/components/compounds/Pagination.svelte +139 -105
- package/dist/components/compounds/Pagination.svelte.d.ts +23 -2
- package/dist/components/compounds/Popover.svelte +124 -25
- package/dist/components/compounds/Popover.svelte.d.ts +23 -2
- package/dist/components/compounds/PullRefresh.svelte +35 -8
- package/dist/components/compounds/PullRefresh.svelte.d.ts +35 -1
- package/dist/components/compounds/Result.svelte +17 -4
- package/dist/components/compounds/Result.svelte.d.ts +23 -2
- package/dist/components/compounds/SafeArea.svelte +30 -3
- package/dist/components/compounds/SafeArea.svelte.d.ts +35 -1
- package/dist/components/compounds/Skeleton.svelte +19 -7
- package/dist/components/compounds/Skeleton.svelte.d.ts +13 -2
- package/dist/components/compounds/Steps.svelte +17 -4
- package/dist/components/compounds/Steps.svelte.d.ts +23 -2
- package/dist/components/compounds/SwipeCell.svelte +30 -3
- package/dist/components/compounds/SwipeCell.svelte.d.ts +40 -1
- package/dist/components/compounds/TableToolbar.svelte +289 -0
- package/dist/components/compounds/TableToolbar.svelte.d.ts +69 -0
- package/dist/components/compounds/Tabs.svelte +84 -14
- package/dist/components/compounds/Tabs.svelte.d.ts +13 -2
- package/dist/components/compounds/TagInput.svelte +51 -33
- package/dist/components/compounds/TagInput.svelte.d.ts +23 -2
- package/dist/components/compounds/Timeline.svelte +30 -3
- package/dist/components/compounds/Timeline.svelte.d.ts +37 -1
- package/dist/components/compounds/ToastContainer.svelte +397 -28
- package/dist/components/compounds/ToastContainer.svelte.d.ts +27 -1
- package/dist/components/compounds/Tooltip.svelte +143 -9
- package/dist/components/compounds/Tooltip.svelte.d.ts +25 -2
- package/dist/components/compounds/accordion-types.d.ts +10 -1
- package/dist/components/compounds/action-sheet-types.d.ts +9 -0
- package/dist/components/compounds/bottom-nav-types.d.ts +9 -0
- package/dist/components/compounds/index.d.ts +7 -0
- package/dist/components/compounds/index.js +11 -0
- package/dist/components/compounds/swipe-cell-types.d.ts +9 -0
- package/dist/components/compounds/timeline-types.d.ts +9 -0
- package/dist/components/control-size.d.ts +35 -0
- package/dist/components/control-size.js +26 -0
- package/dist/components/primitives/Avatar.svelte +19 -5
- package/dist/components/primitives/Avatar.svelte.d.ts +13 -2
- package/dist/components/primitives/Badge.svelte +16 -4
- package/dist/components/primitives/Badge.svelte.d.ts +13 -2
- package/dist/components/primitives/BareButton.svelte +26 -12
- package/dist/components/primitives/BareButton.svelte.d.ts +23 -2
- package/dist/components/primitives/BareInput.svelte +57 -35
- package/dist/components/primitives/BareInput.svelte.d.ts +23 -2
- package/dist/components/primitives/Button.svelte +30 -9
- package/dist/components/primitives/Button.svelte.d.ts +13 -2
- package/dist/components/primitives/Checkbox.svelte +24 -5
- package/dist/components/primitives/Checkbox.svelte.d.ts +23 -2
- package/dist/components/primitives/IconButton.svelte +35 -10
- package/dist/components/primitives/IconButton.svelte.d.ts +23 -2
- package/dist/components/primitives/Input.svelte +56 -26
- package/dist/components/primitives/Input.svelte.d.ts +13 -2
- package/dist/components/primitives/Progress.svelte +17 -4
- package/dist/components/primitives/Progress.svelte.d.ts +23 -2
- package/dist/components/primitives/Radio.svelte +17 -4
- package/dist/components/primitives/Radio.svelte.d.ts +22 -2
- package/dist/components/primitives/Range.svelte +31 -4
- package/dist/components/primitives/Range.svelte.d.ts +37 -1
- package/dist/components/primitives/Rating.svelte +32 -5
- package/dist/components/primitives/Rating.svelte.d.ts +37 -1
- package/dist/components/primitives/Select.svelte +404 -47
- package/dist/components/primitives/Select.svelte.d.ts +23 -2
- package/dist/components/primitives/Spinner.svelte +17 -4
- package/dist/components/primitives/Spinner.svelte.d.ts +23 -2
- package/dist/components/primitives/Switch.svelte +22 -4
- package/dist/components/primitives/Switch.svelte.d.ts +23 -2
- package/dist/components/primitives/Tag.svelte +17 -4
- package/dist/components/primitives/Tag.svelte.d.ts +23 -2
- package/dist/components/primitives/Textarea.svelte +75 -30
- package/dist/components/primitives/Textarea.svelte.d.ts +24 -2
- package/dist/components/primitives/ToggleCheckbox.svelte +24 -10
- package/dist/components/primitives/ToggleCheckbox.svelte.d.ts +23 -2
- package/dist/components/primitives/ToggleInput.svelte +24 -10
- package/dist/components/primitives/ToggleInput.svelte.d.ts +23 -2
- package/dist/components/primitives/ToggleRadio.svelte +24 -10
- package/dist/components/primitives/ToggleRadio.svelte.d.ts +23 -2
- package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte +54 -23
- package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte.d.ts +30 -1
- package/dist/components/scenes/ai/AiDocumentEditor.svelte +3428 -693
- package/dist/components/scenes/ai/AiDocumentEditor.svelte.d.ts +26 -1
- package/dist/components/scenes/ai/MarkdownRenderer.svelte +119 -116
- package/dist/components/scenes/ai/MarkdownRenderer.svelte.d.ts +31 -1
- package/dist/components/scenes/ai/code-preview.d.ts +46 -0
- package/dist/components/scenes/ai/code-preview.js +141 -0
- package/dist/components/scenes/ai/document-download.d.ts +52 -0
- package/dist/components/scenes/ai/document-download.js +300 -79
- package/dist/components/scenes/ai/document-parse.d.ts +101 -11
- package/dist/components/scenes/ai/document-parse.js +212 -48
- package/dist/components/scenes/ai/document-types.d.ts +292 -75
- package/dist/components/scenes/ai/editor-markdown-extensions.d.ts +27 -0
- package/dist/components/scenes/ai/editor-markdown-extensions.js +216 -0
- package/dist/components/scenes/ai/highlight.d.ts +37 -0
- package/dist/components/scenes/ai/highlight.js +177 -0
- package/dist/components/scenes/ai/index.d.ts +5 -2
- package/dist/components/scenes/ai/index.js +3 -0
- package/dist/components/scenes/ai/markdown-parse.d.ts +11 -3
- package/dist/components/scenes/ai/markdown-parse.js +85 -47
- package/dist/components/scenes/ai/mermaid-host-sync.d.ts +72 -0
- package/dist/components/scenes/ai/mermaid-host-sync.js +65 -0
- package/dist/components/scenes/ai/mermaid-render.d.ts +30 -0
- package/dist/components/scenes/ai/mermaid-render.js +61 -0
- package/dist/components/scenes/ai/safe-html.d.ts +64 -0
- package/dist/components/scenes/ai/safe-html.js +345 -0
- package/dist/components/scenes/ai/table/AiTableEditor.svelte +1692 -0
- package/dist/components/scenes/ai/table/AiTableEditor.svelte.d.ts +32 -0
- package/dist/components/scenes/ai/table/table-types.d.ts +181 -0
- package/dist/components/scenes/ai/table/table-types.js +1 -0
- package/dist/components/scenes/app/FeedbackDetail.svelte +236 -0
- package/dist/components/scenes/app/FeedbackDetail.svelte.d.ts +40 -0
- package/dist/components/scenes/app/FeedbackForm.svelte +337 -0
- package/dist/components/scenes/app/FeedbackForm.svelte.d.ts +72 -0
- package/dist/components/scenes/app/FeedbackList.svelte +150 -0
- package/dist/components/scenes/app/FeedbackList.svelte.d.ts +28 -0
- package/dist/components/scenes/app/FeedbackModal.svelte +65 -139
- package/dist/components/scenes/app/FeedbackModal.svelte.d.ts +14 -39
- package/dist/components/scenes/app/FeedbackRecorder.svelte +154 -0
- package/dist/components/scenes/app/FeedbackRecorder.svelte.d.ts +9 -0
- package/dist/components/scenes/app/FeedbackReplay.svelte +142 -0
- package/dist/components/scenes/app/FeedbackReplay.svelte.d.ts +7 -0
- package/dist/components/scenes/app/FeedbackScreenshot.svelte +120 -0
- package/dist/components/scenes/app/FeedbackScreenshot.svelte.d.ts +8 -0
- package/dist/components/scenes/app/LanguageSwitch.svelte +38 -21
- package/dist/components/scenes/app/LanguageSwitch.svelte.d.ts +33 -20
- package/dist/components/scenes/app/SettingsLayout.svelte +115 -0
- package/dist/components/scenes/app/SettingsLayout.svelte.d.ts +54 -0
- package/dist/components/scenes/app/SettingsModal.svelte +33 -7
- package/dist/components/scenes/app/SettingsModal.svelte.d.ts +27 -1
- package/dist/components/scenes/app/ThemeColorPicker.svelte +240 -0
- package/dist/components/scenes/app/ThemeColorPicker.svelte.d.ts +57 -0
- package/dist/components/scenes/app/ThemeSelector.svelte +87 -26
- package/dist/components/scenes/app/ThemeSelector.svelte.d.ts +26 -7
- package/dist/components/scenes/app/ThemeToggle.svelte +27 -6
- package/dist/components/scenes/app/ThemeToggle.svelte.d.ts +24 -5
- package/dist/components/scenes/app/WorkspaceLayout.svelte +64 -0
- package/dist/components/scenes/app/WorkspaceLayout.svelte.d.ts +36 -0
- package/dist/components/scenes/app/feedback-functions.d.ts +57 -0
- package/dist/components/scenes/app/feedback-functions.js +107 -0
- package/dist/components/scenes/app/feedback-types.d.ts +224 -0
- package/dist/components/scenes/app/feedback-types.js +1 -0
- package/dist/components/scenes/app/index.d.ts +8 -1
- package/dist/components/scenes/app/index.js +7 -1
- package/dist/components/scenes/charts/Chart.svelte +186 -0
- package/dist/components/scenes/charts/Chart.svelte.d.ts +24 -0
- package/dist/components/scenes/charts/ChartLoadError.svelte +13 -0
- package/dist/components/scenes/charts/ChartLoadError.svelte.d.ts +6 -0
- package/dist/components/scenes/charts/DashboardGrid.svelte +34 -0
- package/dist/components/scenes/charts/DashboardGrid.svelte.d.ts +15 -0
- package/dist/components/scenes/charts/MetricCard.svelte +52 -0
- package/dist/components/scenes/charts/MetricCard.svelte.d.ts +15 -0
- package/dist/components/scenes/charts/ReportCard.svelte +48 -0
- package/dist/components/scenes/charts/ReportCard.svelte.d.ts +15 -0
- package/dist/components/scenes/charts/chart-presets.d.ts +15 -0
- package/dist/components/scenes/charts/chart-presets.js +19 -0
- package/dist/components/scenes/charts/chart-theme.d.ts +47 -0
- package/dist/components/scenes/charts/chart-theme.js +68 -0
- package/dist/components/scenes/charts/chart-types.d.ts +164 -0
- package/dist/components/scenes/charts/chart-types.js +7 -0
- package/dist/components/scenes/charts/dashboard-types.d.ts +79 -0
- package/dist/components/scenes/charts/dashboard-types.js +1 -0
- package/dist/components/scenes/charts/index.d.ts +12 -0
- package/dist/components/scenes/charts/index.js +10 -0
- package/dist/components/scenes/charts/renderers/AreaChart.svelte +19 -0
- package/dist/components/scenes/charts/renderers/AreaChart.svelte.d.ts +6 -0
- package/dist/components/scenes/charts/renderers/BarChart.svelte +19 -0
- package/dist/components/scenes/charts/renderers/BarChart.svelte.d.ts +6 -0
- package/dist/components/scenes/charts/renderers/LineChart.svelte +625 -0
- package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +33 -0
- package/dist/components/scenes/charts/renderers/PieChart.svelte +19 -0
- package/dist/components/scenes/charts/renderers/PieChart.svelte.d.ts +6 -0
- package/dist/components/scenes/charts/renderers/ScatterChart.svelte +19 -0
- package/dist/components/scenes/charts/renderers/ScatterChart.svelte.d.ts +6 -0
- package/dist/components/scenes/crud/CrudDeleteConfirm.svelte +29 -11
- package/dist/components/scenes/crud/CrudDeleteConfirm.svelte.d.ts +13 -1
- package/dist/components/scenes/crud/CrudDetailDrawer.svelte +77 -22
- package/dist/components/scenes/crud/CrudDetailDrawer.svelte.d.ts +19 -4
- package/dist/components/scenes/crud/CrudDetailPanel.svelte +242 -0
- package/dist/components/scenes/crud/CrudDetailPanel.svelte.d.ts +66 -0
- package/dist/components/scenes/crud/CrudEditPanel.svelte +365 -0
- package/dist/components/scenes/crud/CrudEditPanel.svelte.d.ts +48 -0
- package/dist/components/scenes/crud/CrudFilterBar.svelte +17 -85
- package/dist/components/scenes/crud/CrudFilterBar.svelte.d.ts +13 -25
- package/dist/components/scenes/crud/CrudPage.svelte +564 -185
- package/dist/components/scenes/crud/CrudPage.svelte.d.ts +137 -51
- package/dist/components/scenes/crud/crud-controller.svelte.d.ts +335 -0
- package/dist/components/scenes/crud/crud-controller.svelte.js +276 -0
- package/dist/components/scenes/crud/crud-form-validation.d.ts +16 -0
- package/dist/components/scenes/crud/crud-form-validation.js +51 -0
- package/dist/components/scenes/crud/crud-types.d.ts +136 -43
- package/dist/components/scenes/crud/index.d.ts +9 -3
- package/dist/components/scenes/crud/index.js +8 -3
- package/dist/components/scenes/crud/nav-adapter.d.ts +50 -0
- package/dist/components/scenes/crud/nav-adapter.js +39 -0
- package/dist/components/scenes/crypto/EncryptedInput.svelte +63 -28
- package/dist/components/scenes/crypto/EncryptedInput.svelte.d.ts +38 -3
- package/dist/components/scenes/crypto/HashDisplay.svelte +30 -22
- package/dist/components/scenes/crypto/HashDisplay.svelte.d.ts +24 -1
- package/dist/components/scenes/crypto/SignatureDisplay.svelte +41 -40
- package/dist/components/scenes/crypto/SignatureDisplay.svelte.d.ts +24 -1
- package/dist/components/scenes/error/ErrorPage.svelte +135 -0
- package/dist/components/scenes/error/ErrorPage.svelte.d.ts +50 -0
- package/dist/components/scenes/error/error-presets.d.ts +60 -0
- package/dist/components/scenes/error/error-presets.js +51 -0
- package/dist/components/scenes/error/index.d.ts +8 -0
- package/dist/components/scenes/error/index.js +8 -0
- package/dist/components/scenes/guide/GuideHost.svelte +56 -0
- package/dist/components/scenes/guide/GuideHost.svelte.d.ts +35 -0
- package/dist/components/scenes/guide/GuideHostContent.svelte +136 -0
- package/dist/components/scenes/guide/GuideHostContent.svelte.d.ts +43 -0
- package/dist/components/scenes/guide/HelpCenter.svelte +135 -0
- package/dist/components/scenes/guide/HelpCenter.svelte.d.ts +40 -0
- package/dist/components/scenes/guide/index.d.ts +2 -0
- package/dist/components/scenes/guide/index.js +2 -0
- package/dist/components/scenes/iam/AgreementNotice.svelte +48 -0
- package/dist/components/scenes/iam/AgreementNotice.svelte.d.ts +7 -0
- package/dist/components/scenes/iam/AuthPanel.svelte +226 -0
- package/dist/components/scenes/iam/AuthPanel.svelte.d.ts +29 -0
- package/dist/components/scenes/iam/AuthShell.svelte +160 -0
- package/dist/components/scenes/iam/AuthShell.svelte.d.ts +56 -0
- package/dist/components/scenes/iam/ChangePasswordForm.svelte +84 -63
- package/dist/components/scenes/iam/ChangePasswordForm.svelte.d.ts +13 -1
- package/dist/components/scenes/iam/ForgotPasswordForm.svelte +113 -89
- package/dist/components/scenes/iam/ForgotPasswordForm.svelte.d.ts +24 -1
- package/dist/components/scenes/iam/LoginForm.svelte +215 -117
- package/dist/components/scenes/iam/LoginForm.svelte.d.ts +13 -1
- package/dist/components/scenes/iam/PasswordInput.svelte +79 -32
- package/dist/components/scenes/iam/PasswordInput.svelte.d.ts +30 -4
- package/dist/components/scenes/iam/PermGuard.svelte +21 -11
- package/dist/components/scenes/iam/PermGuard.svelte.d.ts +30 -0
- package/dist/components/scenes/iam/ReauthenticationDialog.svelte +68 -0
- package/dist/components/scenes/iam/ReauthenticationDialog.svelte.d.ts +17 -0
- package/dist/components/scenes/iam/RegisterForm.svelte +129 -116
- package/dist/components/scenes/iam/RegisterForm.svelte.d.ts +13 -1
- package/dist/components/scenes/iam/ResetPasswordForm.svelte +101 -88
- package/dist/components/scenes/iam/ResetPasswordForm.svelte.d.ts +13 -1
- package/dist/components/scenes/iam/SensitiveOperationsForm.svelte +76 -0
- package/dist/components/scenes/iam/SensitiveOperationsForm.svelte.d.ts +21 -0
- package/dist/components/scenes/iam/SessionRecoveryDialog.svelte +64 -0
- package/dist/components/scenes/iam/SessionRecoveryDialog.svelte.d.ts +22 -0
- package/dist/components/scenes/iam/UserProfile.svelte +47 -21
- package/dist/components/scenes/iam/UserProfile.svelte.d.ts +24 -1
- package/dist/components/scenes/iam/auth-captcha.d.ts +21 -0
- package/dist/components/scenes/iam/auth-captcha.js +23 -0
- package/dist/components/scenes/iam/auth-error-message.d.ts +13 -0
- package/dist/components/scenes/iam/auth-error-message.js +65 -0
- package/dist/components/scenes/iam/index.d.ts +10 -0
- package/dist/components/scenes/iam/index.js +9 -1
- package/dist/components/scenes/iam/password-utils.d.ts +33 -6
- package/dist/components/scenes/iam/password-utils.js +61 -8
- package/dist/components/scenes/iam/permission-context.svelte.d.ts +33 -23
- package/dist/components/scenes/iam/permission-context.svelte.js +20 -22
- package/dist/components/scenes/iam/sensitive-actions.svelte.d.ts +68 -0
- package/dist/components/scenes/iam/sensitive-actions.svelte.js +101 -0
- package/dist/components/scenes/iam/session-recovery.svelte.d.ts +44 -0
- package/dist/components/scenes/iam/session-recovery.svelte.js +57 -0
- package/dist/components/scenes/index.d.ts +3 -0
- package/dist/components/scenes/index.js +5 -0
- package/dist/components/scenes/storage/AvatarUpload.svelte +82 -68
- package/dist/components/scenes/storage/AvatarUpload.svelte.d.ts +23 -1
- package/dist/components/scenes/storage/FileList.svelte +19 -5
- package/dist/components/scenes/storage/FileList.svelte.d.ts +23 -1
- package/dist/components/scenes/storage/FileUpload.svelte +151 -96
- package/dist/components/scenes/storage/FileUpload.svelte.d.ts +24 -1
- package/dist/components/scenes/storage/ImageUpload.svelte +93 -94
- package/dist/components/scenes/storage/ImageUpload.svelte.d.ts +24 -1
- package/dist/components/scenes/types.d.ts +574 -42
- package/dist/guide-storage.d.ts +18 -0
- package/dist/guide-storage.js +79 -0
- package/dist/guide-types.d.ts +143 -0
- package/dist/guide-types.js +1 -0
- package/dist/guide.d.ts +3 -0
- package/dist/guide.js +3 -0
- package/dist/guide.svelte.d.ts +29 -0
- package/dist/guide.svelte.js +506 -0
- package/dist/i18n.svelte.d.ts +67 -4
- package/dist/i18n.svelte.js +106 -21
- package/dist/index.d.ts +6 -0
- package/dist/index.js +7 -0
- package/dist/internal/browser-safety.d.ts +88 -0
- package/dist/internal/browser-safety.js +140 -0
- package/dist/internal/dialog-focus.d.ts +21 -0
- package/dist/internal/dialog-focus.js +77 -0
- package/dist/internal/form-context.d.ts +92 -0
- package/dist/internal/form-context.js +70 -0
- package/dist/internal/form-validation.svelte.d.ts +70 -0
- package/dist/internal/form-validation.svelte.js +142 -0
- package/dist/internal/icon-safety.d.ts +14 -0
- package/dist/internal/icon-safety.js +40 -0
- package/dist/internal/locale.d.ts +21 -0
- package/dist/internal/locale.js +43 -0
- package/dist/message.svelte.d.ts +138 -0
- package/dist/message.svelte.js +149 -0
- package/dist/messagebox.svelte.d.ts +130 -0
- package/dist/messagebox.svelte.js +171 -0
- package/dist/messages/en-US.json +303 -16
- package/dist/messages/ja-JP.json +529 -0
- package/dist/messages/zh-CN.json +303 -16
- package/dist/messages.d.ts +25 -3
- package/dist/messages.js +23 -6
- package/dist/styles/design-tokens.css +4 -2
- package/dist/styles/eye-care.css +55 -0
- package/dist/styles/formal.css +55 -0
- package/dist/styles/global.css +86 -18
- package/dist/styles/guide.css +88 -0
- package/dist/styles/high-contrast.css +64 -0
- package/dist/styles/mobile.css +28 -0
- package/dist/styles/theme.css +43 -0
- package/dist/theme-config.d.ts +263 -10
- package/dist/theme-config.js +253 -17
- package/dist/toast.svelte.d.ts +210 -2
- package/dist/toast.svelte.js +305 -19
- package/dist/types.d.ts +787 -63
- package/dist/utils/platform.svelte.d.ts +28 -15
- package/dist/utils/platform.svelte.js +23 -16
- package/dist/utils.d.ts +121 -1
- package/dist/utils.js +208 -13
- package/dist/workspace-context.d.ts +20 -0
- package/dist/workspace-context.js +9 -0
- package/package.json +120 -24
- package/vite.d.ts +13 -0
- package/vite.js +96 -0
- package/dist/components/scenes/crud/CrudEditDrawer.svelte +0 -225
- package/dist/components/scenes/crud/CrudEditDrawer.svelte.d.ts +0 -48
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
<!--
|
|
2
|
+
@component ErrorPage
|
|
3
|
+
通用错误页场景组件
|
|
4
|
+
|
|
5
|
+
展示大号状态码 + 标题 + 描述 + 操作按钮,内置 401/403/404/500/503 预设。
|
|
6
|
+
借鉴 shadcn-admin 错误页布局,复用现有主题 token。
|
|
7
|
+
|
|
8
|
+
使用 Svelte 5 Runes ($props, $derived)
|
|
9
|
+
|
|
10
|
+
@example
|
|
11
|
+
```ts
|
|
12
|
+
import { mount, unmount } from 'svelte'
|
|
13
|
+
import type { ComponentProps } from 'svelte'
|
|
14
|
+
import { ErrorPage } from '@h-ai/ui'
|
|
15
|
+
const props: ComponentProps<typeof ErrorPage> = { status: 403, homeUrl: '/' }
|
|
16
|
+
const component = mount(ErrorPage, { target: document.body, props })
|
|
17
|
+
await unmount(component)
|
|
18
|
+
```
|
|
19
|
+
-->
|
|
20
|
+
<script lang='ts'>
|
|
21
|
+
import type { Snippet } from 'svelte'
|
|
22
|
+
import type { DataAttributes } from '../../../types.js'
|
|
23
|
+
import type { ErrorPreset } from './error-presets.js'
|
|
24
|
+
import { uiM } from '../../../messages.js'
|
|
25
|
+
import { cn, getDataAttributes } from '../../../utils.js'
|
|
26
|
+
import Button from '../../primitives/Button.svelte'
|
|
27
|
+
import { ERROR_PRESETS, resolveErrorPreset } from './error-presets.js'
|
|
28
|
+
|
|
29
|
+
const {
|
|
30
|
+
status = 404,
|
|
31
|
+
code,
|
|
32
|
+
title,
|
|
33
|
+
description,
|
|
34
|
+
showHome = true,
|
|
35
|
+
showBack = true,
|
|
36
|
+
homeUrl = '/',
|
|
37
|
+
onhome,
|
|
38
|
+
onback,
|
|
39
|
+
icon,
|
|
40
|
+
actions,
|
|
41
|
+
class: className = '',
|
|
42
|
+
...restProps
|
|
43
|
+
}: {
|
|
44
|
+
/** HTTP 状态码或预设标识;未命中预设时回退到最接近的预设 */
|
|
45
|
+
status?: number | string | ErrorPreset
|
|
46
|
+
/** 自定义大号展示码(覆盖预设) */
|
|
47
|
+
code?: string
|
|
48
|
+
/** 自定义标题(覆盖预设文案) */
|
|
49
|
+
title?: string
|
|
50
|
+
/** 自定义描述(覆盖预设文案) */
|
|
51
|
+
description?: string
|
|
52
|
+
/** 是否显示「返回首页」按钮 */
|
|
53
|
+
showHome?: boolean
|
|
54
|
+
/** 是否显示「返回上一页」按钮 */
|
|
55
|
+
showBack?: boolean
|
|
56
|
+
/** 首页地址(未提供 onhome 时作为链接跳转) */
|
|
57
|
+
homeUrl?: string
|
|
58
|
+
/** 自定义「返回首页」处理(优先于 homeUrl 链接) */
|
|
59
|
+
onhome?: () => void
|
|
60
|
+
/** 自定义「返回上一页」处理(默认 history.back()) */
|
|
61
|
+
onback?: () => void
|
|
62
|
+
/** 自定义图标插槽 */
|
|
63
|
+
icon?: Snippet
|
|
64
|
+
/** 自定义操作区插槽(提供时覆盖默认按钮) */
|
|
65
|
+
actions?: Snippet
|
|
66
|
+
class?: string
|
|
67
|
+
} & DataAttributes = $props()
|
|
68
|
+
|
|
69
|
+
const dataAttributes = $derived(getDataAttributes(restProps))
|
|
70
|
+
const preset = $derived(ERROR_PRESETS[resolveErrorPreset(status)])
|
|
71
|
+
const displayCode = $derived(code ?? preset.code)
|
|
72
|
+
const displayTitle = $derived(title ?? uiM(preset.titleKey))
|
|
73
|
+
const displayDesc = $derived(description ?? uiM(preset.descKey))
|
|
74
|
+
|
|
75
|
+
function handleBack() {
|
|
76
|
+
if (onback) {
|
|
77
|
+
onback()
|
|
78
|
+
return
|
|
79
|
+
}
|
|
80
|
+
if (typeof history !== 'undefined') {
|
|
81
|
+
history.back()
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
function handleHome() {
|
|
86
|
+
onhome?.()
|
|
87
|
+
}
|
|
88
|
+
</script>
|
|
89
|
+
|
|
90
|
+
<div {...dataAttributes} class={cn('flex min-h-[60vh] w-full flex-col items-center justify-center px-6 py-12 text-center', className)}>
|
|
91
|
+
<!-- 图标 -->
|
|
92
|
+
<div class='mb-6 flex size-16 items-center justify-center rounded-2xl bg-base-content/5 text-base-content/40'>
|
|
93
|
+
{#if icon}
|
|
94
|
+
{@render icon()}
|
|
95
|
+
{:else}
|
|
96
|
+
<span class='{preset.icon} size-8'></span>
|
|
97
|
+
{/if}
|
|
98
|
+
</div>
|
|
99
|
+
|
|
100
|
+
<!-- 大号状态码 -->
|
|
101
|
+
<p class='text-6xl font-bold tracking-tight text-base-content/85 sm:text-7xl'>{displayCode}</p>
|
|
102
|
+
|
|
103
|
+
<!-- 标题 -->
|
|
104
|
+
<h1 class='mt-4 text-xl font-semibold text-base-content sm:text-2xl'>{displayTitle}</h1>
|
|
105
|
+
|
|
106
|
+
<!-- 描述 -->
|
|
107
|
+
<p class='mt-2 max-w-md text-sm text-base-content/55'>{displayDesc}</p>
|
|
108
|
+
|
|
109
|
+
<!-- 操作区 -->
|
|
110
|
+
<div class='mt-8 flex flex-wrap items-center justify-center gap-3'>
|
|
111
|
+
{#if actions}
|
|
112
|
+
{@render actions()}
|
|
113
|
+
{:else}
|
|
114
|
+
{#if showBack}
|
|
115
|
+
<Button variant='outline' size='sm' onclick={handleBack}>
|
|
116
|
+
<span class='icon-[tabler--arrow-left] mr-1.5 size-4'></span>
|
|
117
|
+
{uiM('error_go_back')}
|
|
118
|
+
</Button>
|
|
119
|
+
{/if}
|
|
120
|
+
{#if showHome}
|
|
121
|
+
{#if onhome}
|
|
122
|
+
<Button variant='primary' size='sm' onclick={handleHome}>
|
|
123
|
+
<span class='icon-[tabler--home] mr-1.5 size-4'></span>
|
|
124
|
+
{uiM('error_back_home')}
|
|
125
|
+
</Button>
|
|
126
|
+
{:else}
|
|
127
|
+
<a href={homeUrl} class='btn btn-primary btn-sm'>
|
|
128
|
+
<span class='icon-[tabler--home] mr-1.5 size-4'></span>
|
|
129
|
+
{uiM('error_back_home')}
|
|
130
|
+
</a>
|
|
131
|
+
{/if}
|
|
132
|
+
{/if}
|
|
133
|
+
{/if}
|
|
134
|
+
</div>
|
|
135
|
+
</div>
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import type { Snippet } from 'svelte';
|
|
2
|
+
import type { DataAttributes } from '../../../types.js';
|
|
3
|
+
import type { ErrorPreset } from './error-presets.js';
|
|
4
|
+
type $$ComponentProps = {
|
|
5
|
+
/** HTTP 状态码或预设标识;未命中预设时回退到最接近的预设 */
|
|
6
|
+
status?: number | string | ErrorPreset;
|
|
7
|
+
/** 自定义大号展示码(覆盖预设) */
|
|
8
|
+
code?: string;
|
|
9
|
+
/** 自定义标题(覆盖预设文案) */
|
|
10
|
+
title?: string;
|
|
11
|
+
/** 自定义描述(覆盖预设文案) */
|
|
12
|
+
description?: string;
|
|
13
|
+
/** 是否显示「返回首页」按钮 */
|
|
14
|
+
showHome?: boolean;
|
|
15
|
+
/** 是否显示「返回上一页」按钮 */
|
|
16
|
+
showBack?: boolean;
|
|
17
|
+
/** 首页地址(未提供 onhome 时作为链接跳转) */
|
|
18
|
+
homeUrl?: string;
|
|
19
|
+
/** 自定义「返回首页」处理(优先于 homeUrl 链接) */
|
|
20
|
+
onhome?: () => void;
|
|
21
|
+
/** 自定义「返回上一页」处理(默认 history.back()) */
|
|
22
|
+
onback?: () => void;
|
|
23
|
+
/** 自定义图标插槽 */
|
|
24
|
+
icon?: Snippet;
|
|
25
|
+
/** 自定义操作区插槽(提供时覆盖默认按钮) */
|
|
26
|
+
actions?: Snippet;
|
|
27
|
+
class?: string;
|
|
28
|
+
} & DataAttributes;
|
|
29
|
+
/**
|
|
30
|
+
* ErrorPage
|
|
31
|
+
* 通用错误页场景组件
|
|
32
|
+
*
|
|
33
|
+
* 展示大号状态码 + 标题 + 描述 + 操作按钮,内置 401/403/404/500/503 预设。
|
|
34
|
+
* 借鉴 shadcn-admin 错误页布局,复用现有主题 token。
|
|
35
|
+
*
|
|
36
|
+
* 使用 Svelte 5 Runes ($props, $derived)
|
|
37
|
+
*
|
|
38
|
+
* @example
|
|
39
|
+
* ```ts
|
|
40
|
+
* import { mount, unmount } from 'svelte'
|
|
41
|
+
* import type { ComponentProps } from 'svelte'
|
|
42
|
+
* import { ErrorPage } from '@h-ai/ui'
|
|
43
|
+
* const props: ComponentProps<typeof ErrorPage> = { status: 403, homeUrl: '/' }
|
|
44
|
+
* const component = mount(ErrorPage, { target: document.body, props })
|
|
45
|
+
* await unmount(component)
|
|
46
|
+
* ```
|
|
47
|
+
*/
|
|
48
|
+
declare const ErrorPage: import("svelte").Component<$$ComponentProps, {}, "">;
|
|
49
|
+
type ErrorPage = ReturnType<typeof ErrorPage>;
|
|
50
|
+
export default ErrorPage;
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @h-ai/ui — 错误页预设
|
|
3
|
+
*
|
|
4
|
+
* 为 ErrorPage 提供常见 HTTP 错误的内置文案 key 与图标。
|
|
5
|
+
* @module error-presets
|
|
6
|
+
*/
|
|
7
|
+
import type { UIMessageKey } from '../../../messages.js';
|
|
8
|
+
/**
|
|
9
|
+
* 内置错误预设标识
|
|
10
|
+
*
|
|
11
|
+
* @example
|
|
12
|
+
* ```ts
|
|
13
|
+
* import type { ErrorPreset } from '@h-ai/ui'
|
|
14
|
+
* const example: ErrorPreset = '404'
|
|
15
|
+
* ```
|
|
16
|
+
*/
|
|
17
|
+
export type ErrorPreset = '401' | '403' | '404' | '500' | '503';
|
|
18
|
+
/**
|
|
19
|
+
* 单个错误预设的展示信息
|
|
20
|
+
*
|
|
21
|
+
* @example
|
|
22
|
+
* ```ts
|
|
23
|
+
* import type { ErrorPresetInfo } from '@h-ai/ui'
|
|
24
|
+
* const example: ErrorPresetInfo = { code: '404', titleKey: 'error_404_title', descKey: 'error_404_desc', icon: 'icon-[tabler--map-search]' }
|
|
25
|
+
* ```
|
|
26
|
+
*/
|
|
27
|
+
export interface ErrorPresetInfo {
|
|
28
|
+
/** HTTP 状态码(用于大号展示) */
|
|
29
|
+
code: string;
|
|
30
|
+
/** 标题文案 key */
|
|
31
|
+
titleKey: UIMessageKey;
|
|
32
|
+
/** 描述文案 key */
|
|
33
|
+
descKey: UIMessageKey;
|
|
34
|
+
/** Tabler 图标类名 */
|
|
35
|
+
icon: string;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* 错误预设映射表
|
|
39
|
+
*
|
|
40
|
+
* @example
|
|
41
|
+
* ```ts
|
|
42
|
+
* import { ERROR_PRESETS } from '@h-ai/ui'
|
|
43
|
+
* const missing = ERROR_PRESETS['404']
|
|
44
|
+
* const titleKey = missing.titleKey
|
|
45
|
+
* ```
|
|
46
|
+
*/
|
|
47
|
+
export declare const ERROR_PRESETS: Record<ErrorPreset, ErrorPresetInfo>;
|
|
48
|
+
/**
|
|
49
|
+
* 根据 HTTP 状态码解析到最接近的预设
|
|
50
|
+
* @param status - HTTP 状态码或文本形式。
|
|
51
|
+
* @returns 最接近输入状态的内置错误页标识。
|
|
52
|
+
*
|
|
53
|
+
* @example
|
|
54
|
+
* ```ts
|
|
55
|
+
* import { resolveErrorPreset } from '@h-ai/ui'
|
|
56
|
+
* const unavailable = resolveErrorPreset(503)
|
|
57
|
+
* const fallback = resolveErrorPreset(418)
|
|
58
|
+
* ```
|
|
59
|
+
*/
|
|
60
|
+
export declare function resolveErrorPreset(status: number | string | undefined): ErrorPreset;
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @h-ai/ui — 错误页预设
|
|
3
|
+
*
|
|
4
|
+
* 为 ErrorPage 提供常见 HTTP 错误的内置文案 key 与图标。
|
|
5
|
+
* @module error-presets
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
* 错误预设映射表
|
|
9
|
+
*
|
|
10
|
+
* @example
|
|
11
|
+
* ```ts
|
|
12
|
+
* import { ERROR_PRESETS } from '@h-ai/ui'
|
|
13
|
+
* const missing = ERROR_PRESETS['404']
|
|
14
|
+
* const titleKey = missing.titleKey
|
|
15
|
+
* ```
|
|
16
|
+
*/
|
|
17
|
+
export const ERROR_PRESETS = {
|
|
18
|
+
401: { code: '401', titleKey: 'error_401_title', descKey: 'error_401_desc', icon: 'icon-[tabler--lock]' },
|
|
19
|
+
403: { code: '403', titleKey: 'error_403_title', descKey: 'error_403_desc', icon: 'icon-[tabler--shield-lock]' },
|
|
20
|
+
404: { code: '404', titleKey: 'error_404_title', descKey: 'error_404_desc', icon: 'icon-[tabler--map-search]' },
|
|
21
|
+
500: { code: '500', titleKey: 'error_500_title', descKey: 'error_500_desc', icon: 'icon-[tabler--server-off]' },
|
|
22
|
+
503: { code: '503', titleKey: 'error_503_title', descKey: 'error_503_desc', icon: 'icon-[tabler--tool]' },
|
|
23
|
+
};
|
|
24
|
+
/**
|
|
25
|
+
* 根据 HTTP 状态码解析到最接近的预设
|
|
26
|
+
* @param status - HTTP 状态码或文本形式。
|
|
27
|
+
* @returns 最接近输入状态的内置错误页标识。
|
|
28
|
+
*
|
|
29
|
+
* @example
|
|
30
|
+
* ```ts
|
|
31
|
+
* import { resolveErrorPreset } from '@h-ai/ui'
|
|
32
|
+
* const unavailable = resolveErrorPreset(503)
|
|
33
|
+
* const fallback = resolveErrorPreset(418)
|
|
34
|
+
* ```
|
|
35
|
+
*/
|
|
36
|
+
export function resolveErrorPreset(status) {
|
|
37
|
+
const code = String(status ?? '');
|
|
38
|
+
if (code in ERROR_PRESETS) {
|
|
39
|
+
return code;
|
|
40
|
+
}
|
|
41
|
+
const num = Number(code);
|
|
42
|
+
if (num === 401)
|
|
43
|
+
return '401';
|
|
44
|
+
if (num === 403)
|
|
45
|
+
return '403';
|
|
46
|
+
if (num === 503)
|
|
47
|
+
return '503';
|
|
48
|
+
if (num >= 500)
|
|
49
|
+
return '500';
|
|
50
|
+
return '404';
|
|
51
|
+
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
<!--
|
|
2
|
+
@component GuideHost
|
|
3
|
+
GuideHost 组件的公开使用示例。
|
|
4
|
+
|
|
5
|
+
@example
|
|
6
|
+
```ts
|
|
7
|
+
import { mount, unmount } from 'svelte'
|
|
8
|
+
import { GuideHost, createGuide } from '@h-ai/ui'
|
|
9
|
+
const guide = createGuide({ tours: [], persistence: 'memory' })
|
|
10
|
+
const host = mount(GuideHost, { target: document.body, props: { guide, locale: 'zh-CN', scope: 'demo' } })
|
|
11
|
+
await unmount(host)
|
|
12
|
+
guide.stop()
|
|
13
|
+
```
|
|
14
|
+
-->
|
|
15
|
+
<script lang='ts'>
|
|
16
|
+
import type { GuideController } from '../../../guide-types.js'
|
|
17
|
+
import type { DataAttributes } from '../../../types.js'
|
|
18
|
+
import { getUILocale, uiM } from '../../../messages.js'
|
|
19
|
+
import { toast } from '../../../toast.svelte.js'
|
|
20
|
+
import Button from '../../primitives/Button.svelte'
|
|
21
|
+
import GuideHostContent from './GuideHostContent.svelte'
|
|
22
|
+
|
|
23
|
+
/** GuideHost 组件的属性契约。
|
|
24
|
+
* @example
|
|
25
|
+
* ```ts
|
|
26
|
+
* import type { ComponentProps } from 'svelte'
|
|
27
|
+
* import { GuideHost } from '@h-ai/ui'
|
|
28
|
+
* const props: Partial<ComponentProps<typeof GuideHost>> = {}
|
|
29
|
+
* void props
|
|
30
|
+
* ```
|
|
31
|
+
*/
|
|
32
|
+
interface Props {
|
|
33
|
+
guide: GuideController
|
|
34
|
+
locale?: string
|
|
35
|
+
scope?: string
|
|
36
|
+
autoStart?: string
|
|
37
|
+
}
|
|
38
|
+
const { guide, locale = getUILocale(), ...rest }: Props & DataAttributes = $props()
|
|
39
|
+
function release() {
|
|
40
|
+
guide.stop()
|
|
41
|
+
guide.closeHelp()
|
|
42
|
+
toast.warning(uiM('guide_startFailed', undefined, locale))
|
|
43
|
+
}
|
|
44
|
+
</script>
|
|
45
|
+
|
|
46
|
+
<svelte:boundary onerror={release}>
|
|
47
|
+
<GuideHostContent {guide} {locale} {...rest} />
|
|
48
|
+
{#snippet failed(_error, reset)}
|
|
49
|
+
<div class='fixed bottom-4 right-4 z-[1150] max-w-[calc(100vw-2rem)]' data-testid='guide-error'>
|
|
50
|
+
<Button variant='ghost' size='sm' onclick={() => {
|
|
51
|
+
guide.defer()
|
|
52
|
+
reset()
|
|
53
|
+
}}>{uiM('guide_close', undefined, locale)}</Button>
|
|
54
|
+
</div>
|
|
55
|
+
{/snippet}
|
|
56
|
+
</svelte:boundary>
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { GuideController } from '../../../guide-types.js';
|
|
2
|
+
import type { DataAttributes } from '../../../types.js';
|
|
3
|
+
/** GuideHost 组件的属性契约。
|
|
4
|
+
* @example
|
|
5
|
+
* ```ts
|
|
6
|
+
* import type { ComponentProps } from 'svelte'
|
|
7
|
+
* import { GuideHost } from '@h-ai/ui'
|
|
8
|
+
* const props: Partial<ComponentProps<typeof GuideHost>> = {}
|
|
9
|
+
* void props
|
|
10
|
+
* ```
|
|
11
|
+
*/
|
|
12
|
+
interface Props {
|
|
13
|
+
guide: GuideController;
|
|
14
|
+
locale?: string;
|
|
15
|
+
scope?: string;
|
|
16
|
+
autoStart?: string;
|
|
17
|
+
}
|
|
18
|
+
type $$ComponentProps = Props & DataAttributes;
|
|
19
|
+
/**
|
|
20
|
+
* GuideHost
|
|
21
|
+
* GuideHost 组件的公开使用示例。
|
|
22
|
+
*
|
|
23
|
+
* @example
|
|
24
|
+
* ```ts
|
|
25
|
+
* import { mount, unmount } from 'svelte'
|
|
26
|
+
* import { GuideHost, createGuide } from '@h-ai/ui'
|
|
27
|
+
* const guide = createGuide({ tours: [], persistence: 'memory' })
|
|
28
|
+
* const host = mount(GuideHost, { target: document.body, props: { guide, locale: 'zh-CN', scope: 'demo' } })
|
|
29
|
+
* await unmount(host)
|
|
30
|
+
* guide.stop()
|
|
31
|
+
* ```
|
|
32
|
+
*/
|
|
33
|
+
declare const GuideHost: import("svelte").Component<$$ComponentProps, {}, "">;
|
|
34
|
+
type GuideHost = ReturnType<typeof GuideHost>;
|
|
35
|
+
export default GuideHost;
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
<!--
|
|
2
|
+
@component GuideHost
|
|
3
|
+
GuideHost 组件的公开使用示例。
|
|
4
|
+
|
|
5
|
+
@example
|
|
6
|
+
```ts
|
|
7
|
+
import { mount, unmount } from 'svelte'
|
|
8
|
+
import { GuideHost, createGuide } from '@h-ai/ui'
|
|
9
|
+
const guide = createGuide({ tours: [], persistence: 'memory' })
|
|
10
|
+
const host = mount(GuideHost, { target: document.body, props: { guide, locale: 'zh-CN', scope: 'demo' } })
|
|
11
|
+
await unmount(host)
|
|
12
|
+
guide.stop()
|
|
13
|
+
```
|
|
14
|
+
-->
|
|
15
|
+
<script lang='ts'>
|
|
16
|
+
import type { GuideController } from '../../../guide-types.js'
|
|
17
|
+
import type { DataAttributes } from '../../../types.js'
|
|
18
|
+
import { onMount, untrack } from 'svelte'
|
|
19
|
+
import { resolveGuideText } from '../../../guide.svelte.js'
|
|
20
|
+
import { getUILocale, uiM } from '../../../messages.js'
|
|
21
|
+
import { useToastFeedback } from '../../../toast.svelte.js'
|
|
22
|
+
import { getDataAttributes } from '../../../utils.js'
|
|
23
|
+
import Modal from '../../compounds/Modal.svelte'
|
|
24
|
+
import Button from '../../primitives/Button.svelte'
|
|
25
|
+
import HelpCenter from './HelpCenter.svelte'
|
|
26
|
+
import 'driver.js/dist/driver.css'
|
|
27
|
+
import '../../../styles/guide.css'
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* 导览宿主属性;绑定应用语言、非敏感身份范围和控制器。
|
|
31
|
+
*
|
|
32
|
+
* @example
|
|
33
|
+
* ```ts
|
|
34
|
+
* import { mount, unmount } from 'svelte'
|
|
35
|
+
* import { GuideHost, createGuide } from '@h-ai/ui'
|
|
36
|
+
* const guide = createGuide({ tours: [], persistence: 'memory' })
|
|
37
|
+
* const host = mount(GuideHost, { target: document.body, props: { guide, locale: 'zh-CN', scope: 'demo' } })
|
|
38
|
+
* await unmount(host)
|
|
39
|
+
* guide.stop()
|
|
40
|
+
* ```
|
|
41
|
+
*/
|
|
42
|
+
interface Props {
|
|
43
|
+
guide: GuideController
|
|
44
|
+
locale?: string
|
|
45
|
+
/** 非敏感的用户标识,账号切换后独立记录引导偏好。 */
|
|
46
|
+
scope?: string
|
|
47
|
+
/** 挂载后提示首次使用者,不会直接打断操作或自动跳转。 */
|
|
48
|
+
autoStart?: string
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
const { guide, locale = getUILocale(), scope = 'anonymous', autoStart, ...restProps }: Props & DataAttributes = $props()
|
|
52
|
+
const dataAttributes = $derived(getDataAttributes(restProps))
|
|
53
|
+
let ready = $state(false)
|
|
54
|
+
const offered = $derived.by(() => {
|
|
55
|
+
void locale
|
|
56
|
+
const tour = guide.offeredTour
|
|
57
|
+
return tour ? { id: tour.id, title: resolveGuideText(tour.title), description: resolveGuideText(tour.description) } : null
|
|
58
|
+
})
|
|
59
|
+
const text = $derived.by(() => ({
|
|
60
|
+
welcome: uiM('guide_welcome', undefined, locale),
|
|
61
|
+
start: uiM('guide_start', undefined, locale),
|
|
62
|
+
later: uiM('guide_later', undefined, locale),
|
|
63
|
+
dismiss: uiM('guide_dismiss', undefined, locale),
|
|
64
|
+
help: uiM('guide_help', undefined, locale),
|
|
65
|
+
close: uiM('guide_close', undefined, locale),
|
|
66
|
+
loading: uiM('guide_loading', undefined, locale),
|
|
67
|
+
}))
|
|
68
|
+
|
|
69
|
+
$effect(() => {
|
|
70
|
+
const currentLocale = locale
|
|
71
|
+
untrack(() => guide.setLocale(currentLocale))
|
|
72
|
+
})
|
|
73
|
+
$effect(() => {
|
|
74
|
+
const currentScope = scope
|
|
75
|
+
const tourId = autoStart
|
|
76
|
+
if (ready) {
|
|
77
|
+
untrack(() => {
|
|
78
|
+
guide.setScope(currentScope)
|
|
79
|
+
if (tourId)
|
|
80
|
+
guide.startIfNeeded(tourId)
|
|
81
|
+
})
|
|
82
|
+
}
|
|
83
|
+
})
|
|
84
|
+
$effect(() => {
|
|
85
|
+
const pathname = guide.pathname
|
|
86
|
+
untrack(() => guide.handleNavigation(pathname))
|
|
87
|
+
})
|
|
88
|
+
onMount(() => {
|
|
89
|
+
let alive = true
|
|
90
|
+
guide.setScope(scope)
|
|
91
|
+
guide.setLocale(locale)
|
|
92
|
+
void guide.resume().then(() => {
|
|
93
|
+
if (alive)
|
|
94
|
+
ready = true
|
|
95
|
+
}).catch(() => {
|
|
96
|
+
if (alive) {
|
|
97
|
+
guide.stop()
|
|
98
|
+
guide.closeHelp()
|
|
99
|
+
}
|
|
100
|
+
})
|
|
101
|
+
return () => {
|
|
102
|
+
alive = false
|
|
103
|
+
guide.stop()
|
|
104
|
+
}
|
|
105
|
+
})
|
|
106
|
+
useToastFeedback(() => guide.error, 'warning')
|
|
107
|
+
</script>
|
|
108
|
+
|
|
109
|
+
<div {...dataAttributes} class='contents'>
|
|
110
|
+
|
|
111
|
+
{#if offered}
|
|
112
|
+
<aside class='hai-guide-offer fixed bottom-4 right-4 z-[1150] w-96 max-w-[calc(100vw-2rem)] rounded-2xl border border-base-content/10 bg-base-100 p-5 text-base-content shadow-(--shadow-overlay)' aria-label={text.welcome} data-testid='guide-offer'>
|
|
113
|
+
<p class='text-xs font-medium text-primary'>{text.welcome}</p>
|
|
114
|
+
<h2 class='mt-2 text-base font-semibold'>{offered.title}</h2>
|
|
115
|
+
<p class='mt-2 text-sm leading-6 text-base-content/65'>{offered.description}</p>
|
|
116
|
+
<div class='mt-4 flex flex-wrap gap-2'>
|
|
117
|
+
<Button variant='primary' size='sm' onclick={() => offered && void guide.start(offered.id)} data-testid='guide-start'>{text.start}</Button>
|
|
118
|
+
<Button variant='ghost' size='sm' onclick={() => guide.defer()} data-testid='guide-later'>{text.later}</Button>
|
|
119
|
+
<Button variant='ghost' size='sm' onclick={() => guide.dismiss()} data-testid='guide-dismiss'>{text.dismiss}</Button>
|
|
120
|
+
</div>
|
|
121
|
+
</aside>
|
|
122
|
+
{/if}
|
|
123
|
+
|
|
124
|
+
{#if guide.busy}
|
|
125
|
+
<div class='hai-guide-loading fixed bottom-4 left-1/2 z-[1000000001] flex max-w-[calc(100vw-2rem)] -translate-x-1/2 items-center gap-3 rounded-xl border border-base-content/10 bg-base-100 px-4 py-2 text-sm text-base-content shadow-lg' role='status' data-testid='guide-loading'>
|
|
126
|
+
<span class='loading loading-spinner loading-xs'></span>{text.loading}
|
|
127
|
+
<Button size='sm' variant='ghost' onclick={() => guide.stop()} data-testid='guide-cancel'>{text.close}</Button>
|
|
128
|
+
</div>
|
|
129
|
+
{/if}
|
|
130
|
+
|
|
131
|
+
{#if guide.helpOpen}
|
|
132
|
+
<Modal open title={text.help} size='4xl' height='min(80dvh, 48rem)' bodyClass='p-0' onclose={() => guide.closeHelp()} data-testid='guide-help'>
|
|
133
|
+
<HelpCenter articles={guide.articles} tours={guide.tours} selectedId={guide.articleId} {locale} onstart={id => void guide.start(id)} />
|
|
134
|
+
</Modal>
|
|
135
|
+
{/if}
|
|
136
|
+
</div>
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import type { GuideController } from '../../../guide-types.js';
|
|
2
|
+
import type { DataAttributes } from '../../../types.js';
|
|
3
|
+
import 'driver.js/dist/driver.css';
|
|
4
|
+
import '../../../styles/guide.css';
|
|
5
|
+
/**
|
|
6
|
+
* 导览宿主属性;绑定应用语言、非敏感身份范围和控制器。
|
|
7
|
+
*
|
|
8
|
+
* @example
|
|
9
|
+
* ```ts
|
|
10
|
+
* import { mount, unmount } from 'svelte'
|
|
11
|
+
* import { GuideHost, createGuide } from '@h-ai/ui'
|
|
12
|
+
* const guide = createGuide({ tours: [], persistence: 'memory' })
|
|
13
|
+
* const host = mount(GuideHost, { target: document.body, props: { guide, locale: 'zh-CN', scope: 'demo' } })
|
|
14
|
+
* await unmount(host)
|
|
15
|
+
* guide.stop()
|
|
16
|
+
* ```
|
|
17
|
+
*/
|
|
18
|
+
interface Props {
|
|
19
|
+
guide: GuideController;
|
|
20
|
+
locale?: string;
|
|
21
|
+
/** 非敏感的用户标识,账号切换后独立记录引导偏好。 */
|
|
22
|
+
scope?: string;
|
|
23
|
+
/** 挂载后提示首次使用者,不会直接打断操作或自动跳转。 */
|
|
24
|
+
autoStart?: string;
|
|
25
|
+
}
|
|
26
|
+
type $$ComponentProps = Props & DataAttributes;
|
|
27
|
+
/**
|
|
28
|
+
* GuideHost
|
|
29
|
+
* GuideHost 组件的公开使用示例。
|
|
30
|
+
*
|
|
31
|
+
* @example
|
|
32
|
+
* ```ts
|
|
33
|
+
* import { mount, unmount } from 'svelte'
|
|
34
|
+
* import { GuideHost, createGuide } from '@h-ai/ui'
|
|
35
|
+
* const guide = createGuide({ tours: [], persistence: 'memory' })
|
|
36
|
+
* const host = mount(GuideHost, { target: document.body, props: { guide, locale: 'zh-CN', scope: 'demo' } })
|
|
37
|
+
* await unmount(host)
|
|
38
|
+
* guide.stop()
|
|
39
|
+
* ```
|
|
40
|
+
*/
|
|
41
|
+
declare const GuideHostContent: import("svelte").Component<$$ComponentProps, {}, "">;
|
|
42
|
+
type GuideHostContent = ReturnType<typeof GuideHostContent>;
|
|
43
|
+
export default GuideHostContent;
|