@h-ai/ui 0.1.0-alpha8 → 1.0.0-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.en.md +1036 -0
- package/README.ja.md +1036 -0
- package/README.md +670 -119
- package/auto-import.d.ts +45 -0
- package/auto-import.js +46 -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 +386 -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 +296 -77
- 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 +215 -0
- package/dist/components/scenes/ai/highlight.d.ts +37 -0
- package/dist/components/scenes/ai/highlight.js +162 -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 +42 -31
- 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 +163 -0
- package/dist/components/scenes/charts/Chart.svelte.d.ts +25 -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 +153 -0
- package/dist/components/scenes/charts/chart-types.js +7 -0
- package/dist/components/scenes/charts/index.d.ts +8 -0
- package/dist/components/scenes/charts/index.js +7 -0
- package/dist/components/scenes/charts/renderers/AreaChart.svelte +18 -0
- package/dist/components/scenes/charts/renderers/AreaChart.svelte.d.ts +5 -0
- package/dist/components/scenes/charts/renderers/BarChart.svelte +18 -0
- package/dist/components/scenes/charts/renderers/BarChart.svelte.d.ts +5 -0
- package/dist/components/scenes/charts/renderers/LineChart.svelte +624 -0
- package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +32 -0
- package/dist/components/scenes/charts/renderers/PieChart.svelte +18 -0
- package/dist/components/scenes/charts/renderers/PieChart.svelte.d.ts +5 -0
- package/dist/components/scenes/charts/renderers/ScatterChart.svelte +18 -0
- package/dist/components/scenes/charts/renderers/ScatterChart.svelte.d.ts +5 -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 +297 -16
- package/dist/messages/ja-JP.json +523 -0
- package/dist/messages/zh-CN.json +297 -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/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 +42 -0
- package/dist/theme-config.d.ts +263 -10
- package/dist/theme-config.js +252 -17
- package/dist/toast.svelte.d.ts +210 -2
- package/dist/toast.svelte.js +296 -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
package/dist/theme-config.js
CHANGED
|
@@ -4,8 +4,15 @@
|
|
|
4
4
|
* DaisyUI 主题元数据和配置
|
|
5
5
|
* @module theme-config
|
|
6
6
|
*/
|
|
7
|
+
import { readStoredValue, writeStoredValue } from './internal/browser-safety.js';
|
|
7
8
|
/**
|
|
8
|
-
* DaisyUI
|
|
9
|
+
* 精选 DaisyUI 主题及 UI 共享样式提供的高对比、直角商务主题。
|
|
10
|
+
*
|
|
11
|
+
* @example
|
|
12
|
+
* ```ts
|
|
13
|
+
* import { THEMES } from '@h-ai/ui'
|
|
14
|
+
* const choices = THEMES.map(theme => ({ value: theme.id, label: theme.name }))
|
|
15
|
+
* ```
|
|
9
16
|
*/
|
|
10
17
|
export const THEMES = [
|
|
11
18
|
// 亮色主题
|
|
@@ -16,6 +23,7 @@ export const THEMES = [
|
|
|
16
23
|
{ id: 'lofi', name: 'Lo-Fi', dark: false, primaryColor: '#0d0d0d', bgColor: '#ffffff' },
|
|
17
24
|
{ id: 'winter', name: 'Winter', dark: false, primaryColor: '#047aff', bgColor: '#ffffff' },
|
|
18
25
|
{ id: 'nord', name: 'Nord', dark: false, primaryColor: '#5e81ac', bgColor: '#eceff4' },
|
|
26
|
+
{ id: 'formal', name: 'Formal', dark: false, primaryColor: '#123d70', bgColor: '#ffffff' },
|
|
19
27
|
// 暗色主题
|
|
20
28
|
{ id: 'dark', name: 'Dark', dark: true, primaryColor: '#661ae6', bgColor: '#1d232a' },
|
|
21
29
|
{ id: 'dracula', name: 'Dracula', dark: true, primaryColor: '#ff79c6', bgColor: '#282a36' },
|
|
@@ -25,9 +33,17 @@ export const THEMES = [
|
|
|
25
33
|
{ id: 'sunset', name: 'Sunset', dark: true, primaryColor: '#ff865b', bgColor: '#1a1919' },
|
|
26
34
|
{ id: 'luxury', name: 'Luxury', dark: true, primaryColor: '#c9a53d', bgColor: '#171618' },
|
|
27
35
|
{ id: 'coffee', name: 'Coffee', dark: true, primaryColor: '#db924b', bgColor: '#20161f' },
|
|
36
|
+
{ id: 'high-contrast', name: 'High contrast', dark: true, primaryColor: '#ffe04d', bgColor: '#000000' },
|
|
28
37
|
];
|
|
29
38
|
/**
|
|
30
39
|
* 主题分组配置
|
|
40
|
+
*
|
|
41
|
+
* @example
|
|
42
|
+
* ```ts
|
|
43
|
+
* import { THEME_GROUPS } from '@h-ai/ui'
|
|
44
|
+
* const light = THEME_GROUPS.find(group => group.id === 'light')
|
|
45
|
+
* const choices = light?.themes
|
|
46
|
+
* ```
|
|
31
47
|
*/
|
|
32
48
|
export const THEME_GROUPS = [
|
|
33
49
|
{
|
|
@@ -43,52 +59,257 @@ export const THEME_GROUPS = [
|
|
|
43
59
|
];
|
|
44
60
|
/**
|
|
45
61
|
* 暗色主题列表
|
|
62
|
+
*
|
|
63
|
+
* @example
|
|
64
|
+
* ```ts
|
|
65
|
+
* import { DARK_THEMES } from '@h-ai/ui'
|
|
66
|
+
* const dark = DARK_THEMES.includes('dark')
|
|
67
|
+
* ```
|
|
46
68
|
*/
|
|
47
69
|
export const DARK_THEMES = THEMES.filter(t => t.dark).map(t => t.id);
|
|
70
|
+
/**
|
|
71
|
+
* 支持的主题 ID 列表
|
|
72
|
+
*
|
|
73
|
+
* @example
|
|
74
|
+
* ```ts
|
|
75
|
+
* import { SUPPORTED_THEME_IDS } from '@h-ai/ui'
|
|
76
|
+
* const supported = SUPPORTED_THEME_IDS.includes('light')
|
|
77
|
+
* ```
|
|
78
|
+
*/
|
|
79
|
+
export const SUPPORTED_THEME_IDS = THEMES.map(theme => theme.id);
|
|
80
|
+
/**
|
|
81
|
+
* 默认主题色
|
|
82
|
+
*
|
|
83
|
+
* @example
|
|
84
|
+
* ```ts
|
|
85
|
+
* import { DEFAULT_THEME_COLOR } from '@h-ai/ui'
|
|
86
|
+
* const style = { '--brand-color': DEFAULT_THEME_COLOR }
|
|
87
|
+
* ```
|
|
88
|
+
*/
|
|
89
|
+
export const DEFAULT_THEME_COLOR = '#5765f0';
|
|
90
|
+
/**
|
|
91
|
+
* 主题色 CSS 变量名
|
|
92
|
+
*
|
|
93
|
+
* @example
|
|
94
|
+
* ```ts
|
|
95
|
+
* import { DEFAULT_THEME_COLOR_CSS_VAR } from '@h-ai/ui'
|
|
96
|
+
* document.documentElement.style.setProperty(DEFAULT_THEME_COLOR_CSS_VAR, '#2563eb')
|
|
97
|
+
* ```
|
|
98
|
+
*/
|
|
99
|
+
export const DEFAULT_THEME_COLOR_CSS_VAR = '--hai-theme-color-default';
|
|
100
|
+
/**
|
|
101
|
+
* 内置主题色预设
|
|
102
|
+
*
|
|
103
|
+
* @example
|
|
104
|
+
* ```ts
|
|
105
|
+
* import { THEME_COLOR_PRESETS } from '@h-ai/ui'
|
|
106
|
+
* const options = THEME_COLOR_PRESETS.map(preset => ({ value: preset.value, labelKey: preset.labelKey }))
|
|
107
|
+
* ```
|
|
108
|
+
*/
|
|
109
|
+
export const THEME_COLOR_PRESETS = [
|
|
110
|
+
{ value: DEFAULT_THEME_COLOR, labelKey: 'theme_color_tech_purple' },
|
|
111
|
+
{ value: '#13b981', labelKey: 'theme_color_grid_green' },
|
|
112
|
+
{ value: '#1f5eff', labelKey: 'theme_color_ocean' },
|
|
113
|
+
];
|
|
114
|
+
const HEX_COLOR_REGEX = /^#[0-9a-f]{6}$/i;
|
|
115
|
+
const SHORT_HEX_COLOR_REGEX = /^#[0-9a-f]{3}$/i;
|
|
116
|
+
const SUPPORTED_THEME_ID_SET = new Set(SUPPORTED_THEME_IDS);
|
|
117
|
+
/**
|
|
118
|
+
* 默认主题
|
|
119
|
+
*
|
|
120
|
+
* @example
|
|
121
|
+
* ```ts
|
|
122
|
+
* import { DEFAULT_THEME, applyTheme } from '@h-ai/ui'
|
|
123
|
+
* applyTheme(DEFAULT_THEME, false)
|
|
124
|
+
* ```
|
|
125
|
+
*/
|
|
126
|
+
export const DEFAULT_THEME = 'light';
|
|
127
|
+
/**
|
|
128
|
+
* 主题存储键名
|
|
129
|
+
*
|
|
130
|
+
* @example
|
|
131
|
+
* ```ts
|
|
132
|
+
* import { THEME_STORAGE_KEY, getSavedTheme } from '@h-ai/ui'
|
|
133
|
+
* const preference = { key: THEME_STORAGE_KEY, value: getSavedTheme('light') }
|
|
134
|
+
* // 通过公开安全读取函数消费偏好,不直接访问受限存储。
|
|
135
|
+
* ```
|
|
136
|
+
*/
|
|
137
|
+
export const THEME_STORAGE_KEY = 'theme';
|
|
48
138
|
/**
|
|
49
139
|
* 获取主题信息
|
|
140
|
+
* @param themeId - 主题候选 ID。
|
|
141
|
+
* @returns 匹配的主题元数据,不存在时返回 undefined。
|
|
142
|
+
*
|
|
143
|
+
* @example
|
|
144
|
+
* ```ts
|
|
145
|
+
* import { getThemeInfo } from '@h-ai/ui'
|
|
146
|
+
* const theme = getThemeInfo('light')
|
|
147
|
+
* const background = theme?.bgColor
|
|
148
|
+
* ```
|
|
50
149
|
*/
|
|
51
150
|
export function getThemeInfo(themeId) {
|
|
52
151
|
return THEMES.find(t => t.id === themeId);
|
|
53
152
|
}
|
|
54
153
|
/**
|
|
55
154
|
* 检查是否为暗色主题
|
|
155
|
+
* @param themeId - 主题候选 ID。
|
|
156
|
+
* @returns 是否属于内置暗色主题。
|
|
157
|
+
*
|
|
158
|
+
* @example
|
|
159
|
+
* ```ts
|
|
160
|
+
* import { isDarkTheme } from '@h-ai/ui'
|
|
161
|
+
* const dark = isDarkTheme('dark')
|
|
162
|
+
* ```
|
|
56
163
|
*/
|
|
57
164
|
export function isDarkTheme(themeId) {
|
|
58
165
|
return DARK_THEMES.includes(themeId);
|
|
59
166
|
}
|
|
60
|
-
// ─── 主题初始化工具 ───
|
|
61
167
|
/**
|
|
62
|
-
*
|
|
168
|
+
* 归一化主题 ID,不支持的值回退到默认主题。
|
|
169
|
+
* @param themeId - 主题候选 ID。
|
|
170
|
+
* @param fallbackThemeId - 候选不支持时尝试的主题。
|
|
171
|
+
* @returns 支持的主题 ID;无效输入按候选和默认主题回退。
|
|
172
|
+
*
|
|
173
|
+
* @example
|
|
174
|
+
* ```ts
|
|
175
|
+
* import { normalizeThemeId } from '@h-ai/ui'
|
|
176
|
+
* const theme = normalizeThemeId('unknown-theme', 'light')
|
|
177
|
+
* ```
|
|
63
178
|
*/
|
|
64
|
-
export
|
|
179
|
+
export function normalizeThemeId(themeId, fallbackThemeId = DEFAULT_THEME) {
|
|
180
|
+
const normalized = `${themeId ?? ''}`;
|
|
181
|
+
if (SUPPORTED_THEME_ID_SET.has(normalized)) {
|
|
182
|
+
return normalized;
|
|
183
|
+
}
|
|
184
|
+
return SUPPORTED_THEME_ID_SET.has(fallbackThemeId) ? fallbackThemeId : DEFAULT_THEME;
|
|
185
|
+
}
|
|
65
186
|
/**
|
|
66
|
-
*
|
|
187
|
+
* 归一化 Hex 颜色;无效值返回 null。
|
|
188
|
+
* @param value - 待处理或校验的值。
|
|
189
|
+
* @returns 小写六位 Hex 颜色;无效输入返回 null。
|
|
190
|
+
*
|
|
191
|
+
* @example
|
|
192
|
+
* ```ts
|
|
193
|
+
* import { normalizeHexColor } from '@h-ai/ui'
|
|
194
|
+
* const color = normalizeHexColor('#abc')
|
|
195
|
+
* ```
|
|
67
196
|
*/
|
|
68
|
-
export
|
|
197
|
+
export function normalizeHexColor(value) {
|
|
198
|
+
const normalized = value?.trim().toLowerCase() ?? '';
|
|
199
|
+
if (HEX_COLOR_REGEX.test(normalized)) {
|
|
200
|
+
return normalized;
|
|
201
|
+
}
|
|
202
|
+
if (SHORT_HEX_COLOR_REGEX.test(normalized)) {
|
|
203
|
+
return `#${normalized[1]}${normalized[1]}${normalized[2]}${normalized[2]}${normalized[3]}${normalized[3]}`;
|
|
204
|
+
}
|
|
205
|
+
return null;
|
|
206
|
+
}
|
|
207
|
+
/**
|
|
208
|
+
* 解析主题对应的浏览器色调。
|
|
209
|
+
* @param themeId - 主题候选 ID。
|
|
210
|
+
* @returns 供浏览器控件配色使用的 light/dark 值。
|
|
211
|
+
*
|
|
212
|
+
* @example
|
|
213
|
+
* ```ts
|
|
214
|
+
* import { resolveThemeTone } from '@h-ai/ui'
|
|
215
|
+
* const tone = resolveThemeTone('dark')
|
|
216
|
+
* ```
|
|
217
|
+
*/
|
|
218
|
+
export function resolveThemeTone(themeId) {
|
|
219
|
+
return isDarkTheme(themeId) ? 'dark' : 'light';
|
|
220
|
+
}
|
|
221
|
+
function escapeJsonForScript(value) {
|
|
222
|
+
return JSON.stringify(value)
|
|
223
|
+
.replace(/</g, '\\u003C')
|
|
224
|
+
.replace(/>/g, '\\u003E')
|
|
225
|
+
.replace(/\u2028/g, '\\u2028')
|
|
226
|
+
.replace(/\u2029/g, '\\u2029');
|
|
227
|
+
}
|
|
228
|
+
/**
|
|
229
|
+
* 生成首屏主题恢复脚本,适合注入到 SvelteKit `app.html` 的 `<script>` 中。
|
|
230
|
+
* @param options - 本次操作的行为与显示选项。
|
|
231
|
+
* @returns 可放入受控 HTML shell 的初始化脚本文本。
|
|
232
|
+
*
|
|
233
|
+
* @example
|
|
234
|
+
* ```ts
|
|
235
|
+
* import { createThemeBootstrapScript } from '@h-ai/ui'
|
|
236
|
+
* const script = createThemeBootstrapScript({ storageKey: 'demo-theme', defaultThemeId: 'light' })
|
|
237
|
+
* // 在应用 HTML shell 中作为受控脚本使用,避免首屏主题闪烁。
|
|
238
|
+
* ```
|
|
239
|
+
*/
|
|
240
|
+
export function createThemeBootstrapScript(options) {
|
|
241
|
+
const defaultThemeId = normalizeThemeId(options.defaultThemeId ?? DEFAULT_THEME);
|
|
242
|
+
const defaultThemeColor = options.defaultThemeColor == null
|
|
243
|
+
? null
|
|
244
|
+
: normalizeHexColor(options.defaultThemeColor) ?? DEFAULT_THEME_COLOR;
|
|
245
|
+
const locale = options.locale
|
|
246
|
+
? {
|
|
247
|
+
key: options.locale.key,
|
|
248
|
+
defaultValue: options.locale.defaultValue,
|
|
249
|
+
supportedValues: [...options.locale.supportedValues],
|
|
250
|
+
}
|
|
251
|
+
: null;
|
|
252
|
+
const defaultPreferences = {
|
|
253
|
+
themeId: defaultThemeId,
|
|
254
|
+
};
|
|
255
|
+
if (defaultThemeColor) {
|
|
256
|
+
defaultPreferences.themeColor = defaultThemeColor;
|
|
257
|
+
}
|
|
258
|
+
if (locale) {
|
|
259
|
+
defaultPreferences[locale.key] = locale.defaultValue;
|
|
260
|
+
}
|
|
261
|
+
return `(function(){var d=${escapeJsonForScript(defaultPreferences)};var s=${escapeJsonForScript(options.storageKey)};var l=${escapeJsonForScript(options.legacyThemeStorageKey ?? null)};var u=new Set(${escapeJsonForScript(SUPPORTED_THEME_IDS)});var k=new Set(${escapeJsonForScript(DARK_THEMES)});var c=${escapeJsonForScript(options.colorCssVar ?? null)};var y=${escapeJsonForScript(options.toneDatasetKey ?? null)};var i=${escapeJsonForScript(locale)};function n(e){var r=''+(e??'');return u.has(r)?r:d.themeId}function h(e){var r=(''+(e??'')).trim().toLowerCase();if(/^#[0-9a-f]{6}$/i.test(r))return r;if(/^#[0-9a-f]{3}$/i.test(r))return '#'+r[1]+r[1]+r[2]+r[2]+r[3]+r[3];return Object.prototype.hasOwnProperty.call(d,'themeColor')?d.themeColor:null}function g(e){var r={...d,themeId:n(e?.themeId)};if(Object.prototype.hasOwnProperty.call(d,'themeColor'))r.themeColor=h(e?.themeColor);if(i)r[i.key]=i.supportedValues.includes(e?.[i.key])?e[i.key]:d[i.key];return r}function a(e){var r=document.documentElement;var o=k.has(e.themeId)?'dark':'light';r.setAttribute('data-theme',e.themeId);if(y)r.dataset[y]=o;if(c){if(e.themeColor){r.style.setProperty(c,e.themeColor)}else{r.style.removeProperty(c)}}r.style.setProperty('color-scheme',o)}var p=d;try{var f=window.localStorage.getItem(s);if(f){p=g(JSON.parse(f))}else if(l){p=g({themeId:window.localStorage.getItem(l)})}else{p=g(d)}a(p);window.localStorage.setItem(s,JSON.stringify(p));if(l)window.localStorage.removeItem(l)}catch{a(d)}})()`;
|
|
262
|
+
}
|
|
69
263
|
/**
|
|
70
|
-
* 获取主题初始化脚本(用于
|
|
264
|
+
* 获取主题初始化脚本(用于 HTML shell 防闪烁)
|
|
71
265
|
*
|
|
72
|
-
*
|
|
266
|
+
* 返回值是“脚本标签内的文本内容”,适合宿主在构建阶段或服务端模板中注入。
|
|
267
|
+
* 对于 SvelteKit `app.html`,请直接粘贴这段脚本字符串的内容,不能写 `{@html getThemeInitScript()}`。
|
|
268
|
+
* @returns 使用默认存储约定的主题初始化脚本。
|
|
269
|
+
*
|
|
270
|
+
* @example
|
|
271
|
+
* ```ts
|
|
272
|
+
* import { getThemeInitScript } from '@h-ai/ui'
|
|
273
|
+
* const script = getThemeInitScript()
|
|
274
|
+
* ```
|
|
73
275
|
*/
|
|
74
276
|
export function getThemeInitScript() {
|
|
75
|
-
return
|
|
277
|
+
return createThemeBootstrapScript({
|
|
278
|
+
storageKey: THEME_STORAGE_KEY,
|
|
279
|
+
defaultThemeId: DEFAULT_THEME,
|
|
280
|
+
});
|
|
76
281
|
}
|
|
77
282
|
/**
|
|
78
|
-
*
|
|
283
|
+
* 应用主题,并同步原生表单控件配色;自定义主题由宿主 CSS 决定配色。
|
|
79
284
|
* @param theme - 主题 ID
|
|
80
285
|
* @param persist - 是否持久化到 localStorage
|
|
286
|
+
* @returns {void} 无返回值;更新当前文档,并按 persist 决定是否保存偏好。
|
|
287
|
+
*
|
|
288
|
+
* @example
|
|
289
|
+
* ```ts
|
|
290
|
+
* import { applyTheme } from '@h-ai/ui'
|
|
291
|
+
* applyTheme('dark', false)
|
|
292
|
+
* // false 仅更新当前 DOM,不写入持久化偏好。
|
|
293
|
+
* ```
|
|
81
294
|
*/
|
|
82
295
|
export function applyTheme(theme, persist = true) {
|
|
83
296
|
if (typeof document === 'undefined')
|
|
84
297
|
return;
|
|
85
298
|
document.documentElement.setAttribute('data-theme', theme);
|
|
86
|
-
|
|
87
|
-
|
|
299
|
+
document.documentElement.style.setProperty('color-scheme', getThemeInfo(theme) ? resolveThemeTone(theme) : '');
|
|
300
|
+
if (persist) {
|
|
301
|
+
writeStoredValue(THEME_STORAGE_KEY, theme);
|
|
88
302
|
}
|
|
89
303
|
}
|
|
90
304
|
/**
|
|
91
305
|
* 获取当前主题
|
|
306
|
+
* @returns 当前文档主题;无 DOM 时使用默认值。
|
|
307
|
+
*
|
|
308
|
+
* @example
|
|
309
|
+
* ```ts
|
|
310
|
+
* import { getCurrentTheme } from '@h-ai/ui'
|
|
311
|
+
* const theme = getCurrentTheme()
|
|
312
|
+
* ```
|
|
92
313
|
*/
|
|
93
314
|
export function getCurrentTheme() {
|
|
94
315
|
if (typeof document === 'undefined')
|
|
@@ -96,12 +317,19 @@ export function getCurrentTheme() {
|
|
|
96
317
|
return document.documentElement.getAttribute('data-theme') ?? DEFAULT_THEME;
|
|
97
318
|
}
|
|
98
319
|
/**
|
|
99
|
-
*
|
|
320
|
+
* 获取保存的主题;存储为空或不可用时使用宿主默认主题。
|
|
321
|
+
*
|
|
322
|
+
* @param fallbackTheme - 未保存主题时的默认值,默认 light
|
|
323
|
+
* @returns 安全读取并归一化的主题偏好。
|
|
324
|
+
*
|
|
325
|
+
* @example
|
|
326
|
+
* ```ts
|
|
327
|
+
* import { getSavedTheme } from '@h-ai/ui'
|
|
328
|
+
* const theme = getSavedTheme('light')
|
|
329
|
+
* ```
|
|
100
330
|
*/
|
|
101
|
-
export function getSavedTheme() {
|
|
102
|
-
|
|
103
|
-
return DEFAULT_THEME;
|
|
104
|
-
return localStorage.getItem(THEME_STORAGE_KEY) ?? DEFAULT_THEME;
|
|
331
|
+
export function getSavedTheme(fallbackTheme = DEFAULT_THEME) {
|
|
332
|
+
return readStoredValue(THEME_STORAGE_KEY) ?? fallbackTheme;
|
|
105
333
|
}
|
|
106
334
|
/**
|
|
107
335
|
* DaisyUI 主题配置字符串(用于 app.css)
|
|
@@ -112,6 +340,13 @@ export function getSavedTheme() {
|
|
|
112
340
|
* @plugin "daisyui" {
|
|
113
341
|
* themes: light --default, dark --prefersdark, cupcake, bumblebee, ...
|
|
114
342
|
* }
|
|
343
|
+
*
|
|
344
|
+
* @example
|
|
345
|
+
* ```ts
|
|
346
|
+
* import { DAISYUI_THEMES_CONFIG } from '@h-ai/ui'
|
|
347
|
+
* const css = '@plugin "daisyui" { themes: ' + DAISYUI_THEMES_CONFIG + '; }'
|
|
348
|
+
* // 将生成的配置用于构建时 CSS,不在浏览器动态安装主题。
|
|
349
|
+
* ```
|
|
115
350
|
*/
|
|
116
351
|
export const DAISYUI_THEMES_CONFIG = THEMES.map((t, i) => {
|
|
117
352
|
if (i === 0)
|
package/dist/toast.svelte.d.ts
CHANGED
|
@@ -7,6 +7,12 @@
|
|
|
7
7
|
import type { ToastProps } from './types.js';
|
|
8
8
|
/**
|
|
9
9
|
* Toast 项
|
|
10
|
+
*
|
|
11
|
+
* @example
|
|
12
|
+
* ```ts
|
|
13
|
+
* import type { ToastItem } from '@h-ai/ui'
|
|
14
|
+
* const example: ToastItem = { id: 'toast-1', message: '保存完成', variant: 'success', duration: 3000 }
|
|
15
|
+
* ```
|
|
10
16
|
*/
|
|
11
17
|
export interface ToastItem extends ToastProps {
|
|
12
18
|
id: string;
|
|
@@ -16,30 +22,232 @@ export interface ToastItem extends ToastProps {
|
|
|
16
22
|
*/
|
|
17
23
|
declare class ToastState {
|
|
18
24
|
items: ToastItem[];
|
|
19
|
-
/**
|
|
20
|
-
private
|
|
25
|
+
/** 仅队首计时,等待项在展示后才开始计算停留时间。 */
|
|
26
|
+
private timer;
|
|
27
|
+
private deadline;
|
|
28
|
+
private remaining;
|
|
29
|
+
private paused;
|
|
30
|
+
private startTimer;
|
|
31
|
+
/**
|
|
32
|
+
* 暂停当前提示的自动关闭,供阅读和交互期间使用;等待项不受影响。
|
|
33
|
+
* @param id - 当前提示 ID。
|
|
34
|
+
* @example
|
|
35
|
+
* ```ts
|
|
36
|
+
* const id = toast.info('同步中')
|
|
37
|
+
* toast.pause(id)
|
|
38
|
+
* toast.resume(id)
|
|
39
|
+
* ```
|
|
40
|
+
*/
|
|
41
|
+
pause(id: string): void;
|
|
42
|
+
/**
|
|
43
|
+
* 从剩余时间恢复当前提示的自动关闭;手工关闭或清空后不会恢复旧计时器。
|
|
44
|
+
* @param id - 当前提示 ID。
|
|
45
|
+
* @example
|
|
46
|
+
* ```ts
|
|
47
|
+
* const id = toast.info('同步中')
|
|
48
|
+
* toast.pause(id)
|
|
49
|
+
* toast.resume(id)
|
|
50
|
+
* ```
|
|
51
|
+
*/
|
|
52
|
+
resume(id: string): void;
|
|
21
53
|
/**
|
|
22
54
|
* 添加 Toast
|
|
55
|
+
* @param props - 组件的属性对象。
|
|
56
|
+
* @returns 新条目的 ID,可用于提前移除。
|
|
57
|
+
* @example
|
|
58
|
+
* ```ts
|
|
59
|
+
* import { toast } from '@h-ai/ui'
|
|
60
|
+
* // 布局中需挂载 ToastContainer。
|
|
61
|
+
* const id = toast.add({ message: '保存完成', variant: 'success', duration: 3000 })
|
|
62
|
+
* toast.remove(id)
|
|
63
|
+
* ```
|
|
23
64
|
*/
|
|
24
65
|
add(props: Omit<ToastProps, 'onclose'>): string;
|
|
25
66
|
/**
|
|
26
67
|
* 移除 Toast
|
|
68
|
+
* @param id - 待移除的条目 ID。
|
|
69
|
+
* @returns {void} 无返回值;同时清理对应的自动关闭定时器。
|
|
70
|
+
* @example
|
|
71
|
+
* ```ts
|
|
72
|
+
* import { toast } from '@h-ai/ui'
|
|
73
|
+
* // 布局中需挂载 ToastContainer。
|
|
74
|
+
* const id = toast.info('同步中', 0)
|
|
75
|
+
* toast.remove(id)
|
|
76
|
+
* ```
|
|
27
77
|
*/
|
|
28
78
|
remove(id: string): void;
|
|
29
79
|
/**
|
|
30
80
|
* 清空所有 Toast
|
|
81
|
+
* @returns {void} 无返回值;同时清理对应的自动关闭定时器。
|
|
82
|
+
* @example
|
|
83
|
+
* ```ts
|
|
84
|
+
* import { toast } from '@h-ai/ui'
|
|
85
|
+
* // 布局中需挂载 ToastContainer。
|
|
86
|
+
* toast.info('同步中', 0)
|
|
87
|
+
* toast.clear()
|
|
88
|
+
* ```
|
|
31
89
|
*/
|
|
32
90
|
clear(): void;
|
|
33
91
|
/**
|
|
34
92
|
* 快捷方法
|
|
93
|
+
* @param message - 已经本地化的用户提示。
|
|
94
|
+
* @param duration - 提示持续时间,单位毫秒。
|
|
95
|
+
* @returns 新条目的 ID,可用于提前移除。
|
|
96
|
+
* @example
|
|
97
|
+
* ```ts
|
|
98
|
+
* import { toast } from '@h-ai/ui'
|
|
99
|
+
* // 布局中需挂载 ToastContainer。
|
|
100
|
+
* const id = toast.success('操作结果', 3000)
|
|
101
|
+
* toast.remove(id)
|
|
102
|
+
* ```
|
|
35
103
|
*/
|
|
36
104
|
success(message: string, duration?: number): string;
|
|
105
|
+
/**
|
|
106
|
+
* 处理 error 操作。
|
|
107
|
+
* @param message - 已经本地化的用户提示。
|
|
108
|
+
* @param duration - 提示持续时间,单位毫秒。
|
|
109
|
+
* @returns 新条目的 ID,可用于提前移除。
|
|
110
|
+
* @example
|
|
111
|
+
* ```ts
|
|
112
|
+
* import { toast } from '@h-ai/ui'
|
|
113
|
+
* // 布局中需挂载 ToastContainer。
|
|
114
|
+
* const id = toast.error('操作结果', 3000)
|
|
115
|
+
* toast.remove(id)
|
|
116
|
+
* ```
|
|
117
|
+
*/
|
|
37
118
|
error(message: string, duration?: number): string;
|
|
119
|
+
/**
|
|
120
|
+
* 处理 warning 操作。
|
|
121
|
+
* @param message - 已经本地化的用户提示。
|
|
122
|
+
* @param duration - 提示持续时间,单位毫秒。
|
|
123
|
+
* @returns 新条目的 ID,可用于提前移除。
|
|
124
|
+
* @example
|
|
125
|
+
* ```ts
|
|
126
|
+
* import { toast } from '@h-ai/ui'
|
|
127
|
+
* // 布局中需挂载 ToastContainer。
|
|
128
|
+
* const id = toast.warning('操作结果', 3000)
|
|
129
|
+
* toast.remove(id)
|
|
130
|
+
* ```
|
|
131
|
+
*/
|
|
38
132
|
warning(message: string, duration?: number): string;
|
|
133
|
+
/**
|
|
134
|
+
* 处理 info 操作。
|
|
135
|
+
* @param message - 已经本地化的用户提示。
|
|
136
|
+
* @param duration - 提示持续时间,单位毫秒。
|
|
137
|
+
* @returns 新条目的 ID,可用于提前移除。
|
|
138
|
+
* @example
|
|
139
|
+
* ```ts
|
|
140
|
+
* import { toast } from '@h-ai/ui'
|
|
141
|
+
* // 布局中需挂载 ToastContainer。
|
|
142
|
+
* const id = toast.info('操作结果', 3000)
|
|
143
|
+
* toast.remove(id)
|
|
144
|
+
* ```
|
|
145
|
+
*/
|
|
39
146
|
info(message: string, duration?: number): string;
|
|
40
147
|
}
|
|
41
148
|
/**
|
|
42
149
|
* Toast 单例
|
|
150
|
+
*
|
|
151
|
+
* @example
|
|
152
|
+
* ```ts
|
|
153
|
+
* import { toast } from '@h-ai/ui'
|
|
154
|
+
* // 页面布局需挂载 ToastContainer。
|
|
155
|
+
* const id = toast.success('保存完成', 3000)
|
|
156
|
+
* toast.remove(id)
|
|
157
|
+
* toast.clear()
|
|
158
|
+
* ```
|
|
43
159
|
*/
|
|
44
160
|
export declare const toast: ToastState;
|
|
161
|
+
/**
|
|
162
|
+
* 在组件初始化时订阅操作提示,统一交给根布局的 ToastContainer 展示。
|
|
163
|
+
* 只跟踪消息来源,不订阅 Toast 队列;同一消息已在队列中时合并,避免父子组件重复提示。
|
|
164
|
+
* 字段校验保留控件关联和定位,提示统一由此入口展示;文案应已经完成安全映射和本地化。
|
|
165
|
+
* 订阅随组件销毁结束,已发出的通知继续由根容器管理。
|
|
166
|
+
* @param message - 响应式消息读取函数;空值表示没有待提示的操作结果。
|
|
167
|
+
* @param variant - 通知类型,默认 error。
|
|
168
|
+
* @example
|
|
169
|
+
* ```svelte
|
|
170
|
+
* <script lang="ts">
|
|
171
|
+
* import { useToastFeedback } from '@h-ai/ui/toast'
|
|
172
|
+
* let error = $state('')
|
|
173
|
+
* useToastFeedback(() => error)
|
|
174
|
+
* </script>
|
|
175
|
+
* ```
|
|
176
|
+
*/
|
|
177
|
+
export declare function useToastFeedback(message: () => string | undefined | null, variant?: NonNullable<ToastProps['variant']>): void;
|
|
178
|
+
/**
|
|
179
|
+
* 弹出操作成功提示(默认右下角)。
|
|
180
|
+
*
|
|
181
|
+
* @description 统一封装 toast 单例,业务应用无需自建 toast 工具文件即可获得一致的成功反馈。
|
|
182
|
+
*
|
|
183
|
+
* @param message - 用户可见的成功文案(已本地化)。
|
|
184
|
+
* @param duration - 可选停留时长(毫秒),默认 3000。
|
|
185
|
+
* @returns 新通知的 ID,可交给 toast.remove 提前移除。
|
|
186
|
+
*
|
|
187
|
+
* @example
|
|
188
|
+
* ```ts
|
|
189
|
+
* import { notifySuccess, toast } from '@h-ai/ui'
|
|
190
|
+
* const id = notifySuccess('保存完成', 3000)
|
|
191
|
+
* toast.remove(id)
|
|
192
|
+
* ```
|
|
193
|
+
*/
|
|
194
|
+
export declare function notifySuccess(message: string, duration?: number): string;
|
|
195
|
+
/**
|
|
196
|
+
* 弹出操作失败提示(默认右下角)。
|
|
197
|
+
*
|
|
198
|
+
* @description 接受完整错误对象或已本地化的安全字符串;普通 Error 隐藏原文,
|
|
199
|
+
* 使用 fallback 或通用错误并保留 traceId。不要把未知 Error.message 转成字符串传入。
|
|
200
|
+
*
|
|
201
|
+
* @param error - 错误对象或已本地化的错误文案。
|
|
202
|
+
* @param fallback - 未识别的异常或缺少错误文案时使用的安全兜底说明。
|
|
203
|
+
* @param duration - 可选停留时长(毫秒),默认 5000。
|
|
204
|
+
* @returns 新错误通知的 ID,可交给 toast.remove 提前移除。
|
|
205
|
+
*
|
|
206
|
+
* @example
|
|
207
|
+
* ```ts
|
|
208
|
+
* import { notifyError, toast } from '@h-ai/ui'
|
|
209
|
+
* const id = notifyError(new Error('提交失败'), '请稍后重试', 5000)
|
|
210
|
+
* toast.remove(id)
|
|
211
|
+
* ```
|
|
212
|
+
*/
|
|
213
|
+
export declare function notifyError(error: unknown, fallback?: string, duration?: number): string;
|
|
214
|
+
/**
|
|
215
|
+
* 生成安全错误提示;日志保留脱敏原因,字符串携带追踪编号供 ToastContainer 分离展示。
|
|
216
|
+
* @example
|
|
217
|
+
* ```ts
|
|
218
|
+
* import { errorMessage } from '@h-ai/ui'
|
|
219
|
+
* const text = errorMessage(new Error('Internal detail'), '保存失败')
|
|
220
|
+
* ```
|
|
221
|
+
*/
|
|
222
|
+
export declare function errorMessage(error: unknown, fallback?: string): string;
|
|
223
|
+
/**
|
|
224
|
+
* 弹出信息提示(默认右下角)。
|
|
225
|
+
*
|
|
226
|
+
* @param message - 用户可见文案(已本地化)。
|
|
227
|
+
* @param duration - 可选停留时长(毫秒),默认 3000。
|
|
228
|
+
* @returns 新提示的 ID。
|
|
229
|
+
*
|
|
230
|
+
* @example
|
|
231
|
+
* ```ts
|
|
232
|
+
* import { notifyInfo, toast } from '@h-ai/ui'
|
|
233
|
+
* const id = notifyInfo('正在同步', 3000)
|
|
234
|
+
* toast.remove(id)
|
|
235
|
+
* ```
|
|
236
|
+
*/
|
|
237
|
+
export declare function notifyInfo(message: string, duration?: number): string;
|
|
238
|
+
/**
|
|
239
|
+
* 弹出警告提示(默认右下角)。
|
|
240
|
+
*
|
|
241
|
+
* @param message - 用户可见文案(已本地化)。
|
|
242
|
+
* @param duration - 可选停留时长(毫秒),默认 5000。
|
|
243
|
+
* @returns 新警告的 ID。
|
|
244
|
+
*
|
|
245
|
+
* @example
|
|
246
|
+
* ```ts
|
|
247
|
+
* import { notifyWarning, toast } from '@h-ai/ui'
|
|
248
|
+
* const id = notifyWarning('请先保存修改', 5000)
|
|
249
|
+
* toast.remove(id)
|
|
250
|
+
* ```
|
|
251
|
+
*/
|
|
252
|
+
export declare function notifyWarning(message: string, duration?: number): string;
|
|
45
253
|
export {};
|