@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,506 @@
|
|
|
1
|
+
import { tick } from 'svelte';
|
|
2
|
+
import { SvelteSet } from 'svelte/reactivity';
|
|
3
|
+
import { createBrowserNavAdapter } from './components/scenes/crud/nav-adapter.js';
|
|
4
|
+
import { createGuideStorage } from './guide-storage.js';
|
|
5
|
+
import { getUILocale, uiM } from './messages.js';
|
|
6
|
+
/** 同一浏览器页面只允许一个导览拥有遮罩和键盘监听。 */
|
|
7
|
+
let stopActiveGuide;
|
|
8
|
+
/**
|
|
9
|
+
* 解析业务文案;既支持普通字符串,也支持应用 i18n 函数。
|
|
10
|
+
* @param text - 待处理文本。
|
|
11
|
+
* @returns 业务字符串或延迟翻译函数的当前文本;空输入为空字符串。
|
|
12
|
+
*
|
|
13
|
+
* @example
|
|
14
|
+
* ```ts
|
|
15
|
+
* import { resolveGuideText } from '@h-ai/ui'
|
|
16
|
+
* const title = resolveGuideText(() => '操作说明')
|
|
17
|
+
* ```
|
|
18
|
+
*/
|
|
19
|
+
export function resolveGuideText(text) {
|
|
20
|
+
return typeof text === 'function' ? text() : text ?? '';
|
|
21
|
+
}
|
|
22
|
+
function escapeGuideText(text) {
|
|
23
|
+
return resolveGuideText(text).replace(/[&<>"']/g, character => ({
|
|
24
|
+
'&': '&',
|
|
25
|
+
'<': '<',
|
|
26
|
+
'>': '>',
|
|
27
|
+
'"': '"',
|
|
28
|
+
'\'': ''',
|
|
29
|
+
})[character]);
|
|
30
|
+
}
|
|
31
|
+
function findTarget(step) {
|
|
32
|
+
try {
|
|
33
|
+
const element = typeof step.target === 'function'
|
|
34
|
+
? step.target()
|
|
35
|
+
: [...document.querySelectorAll('[data-guide]')].find(item => item.getAttribute('data-guide') === step.target);
|
|
36
|
+
if (!element?.isConnected || !element.getClientRects().length || element.closest('[hidden], [aria-hidden="true"]'))
|
|
37
|
+
return null;
|
|
38
|
+
const style = getComputedStyle(element);
|
|
39
|
+
return style.visibility === 'hidden' || style.display === 'none' ? null : element;
|
|
40
|
+
}
|
|
41
|
+
catch {
|
|
42
|
+
return null;
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
/** 等待异步渲染、页签展开或布局变化,所有退出路径均清理监听和计时器。 */
|
|
46
|
+
function waitForTarget(step, signal, timeout, ready) {
|
|
47
|
+
return new Promise((resolve) => {
|
|
48
|
+
let observer;
|
|
49
|
+
let timer;
|
|
50
|
+
let poll;
|
|
51
|
+
const finish = (element) => {
|
|
52
|
+
observer?.disconnect();
|
|
53
|
+
clearTimeout(timer);
|
|
54
|
+
clearInterval(poll);
|
|
55
|
+
signal.removeEventListener('abort', aborted);
|
|
56
|
+
resolve(element);
|
|
57
|
+
};
|
|
58
|
+
function aborted() {
|
|
59
|
+
finish(null);
|
|
60
|
+
}
|
|
61
|
+
const check = () => {
|
|
62
|
+
if (signal.aborted) {
|
|
63
|
+
finish(null);
|
|
64
|
+
return;
|
|
65
|
+
}
|
|
66
|
+
try {
|
|
67
|
+
const element = ready() ? findTarget(step) : null;
|
|
68
|
+
if (element)
|
|
69
|
+
finish(element);
|
|
70
|
+
}
|
|
71
|
+
catch {
|
|
72
|
+
finish(null);
|
|
73
|
+
}
|
|
74
|
+
};
|
|
75
|
+
if (signal.aborted) {
|
|
76
|
+
finish(null);
|
|
77
|
+
return;
|
|
78
|
+
}
|
|
79
|
+
try {
|
|
80
|
+
const initial = ready() ? findTarget(step) : null;
|
|
81
|
+
if (initial) {
|
|
82
|
+
finish(initial);
|
|
83
|
+
return;
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
catch {
|
|
87
|
+
finish(null);
|
|
88
|
+
return;
|
|
89
|
+
}
|
|
90
|
+
observer = new MutationObserver(check);
|
|
91
|
+
observer.observe(document.documentElement, { childList: true, subtree: true, attributes: true });
|
|
92
|
+
signal.addEventListener('abort', aborted, { once: true });
|
|
93
|
+
timer = setTimeout(finish, timeout, null);
|
|
94
|
+
poll = setInterval(check, 50);
|
|
95
|
+
});
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* 创建应用独享的新手引导控制器。SSR 可创建,DOM 操作只在客户端启动时发生。
|
|
99
|
+
* 配置和控制器应在布局组件内创建,避免在 SSR 模块级共享用户状态。
|
|
100
|
+
* @param options - 本次操作的行为与显示选项。
|
|
101
|
+
* @returns 导览与帮助中心控制器;交互失败使用 false/error 表达。
|
|
102
|
+
*
|
|
103
|
+
* @example
|
|
104
|
+
* ```ts
|
|
105
|
+
* import { createGuide } from '@h-ai/ui'
|
|
106
|
+
* const guide = createGuide({ tours: [{ id: 'intro', title: '入门', steps: [{ target: 'save', title: '保存', description: '提交当前资料' }] }], persistence: 'memory' })
|
|
107
|
+
* const offered = guide.startIfNeeded('intro')
|
|
108
|
+
* if (offered) guide.openHelp()
|
|
109
|
+
* guide.stop()
|
|
110
|
+
* ```
|
|
111
|
+
*/
|
|
112
|
+
export function createGuide(options) {
|
|
113
|
+
const storage = createGuideStorage(options);
|
|
114
|
+
const nav = options.nav ?? createBrowserNavAdapter();
|
|
115
|
+
const persistKey = options.persistKey ?? 'hai-guide';
|
|
116
|
+
const pendingKey = `${persistKey}-pending`;
|
|
117
|
+
let scope = 'anonymous';
|
|
118
|
+
let locale = $state(getUILocale());
|
|
119
|
+
let offeredId = $state(null);
|
|
120
|
+
let activeTourId = $state(null);
|
|
121
|
+
let busy = $state(false);
|
|
122
|
+
let error = $state('');
|
|
123
|
+
let helpOpen = $state(false);
|
|
124
|
+
let articleId = $state(null);
|
|
125
|
+
let driver;
|
|
126
|
+
let abort;
|
|
127
|
+
let generation = 0;
|
|
128
|
+
let expectedPath;
|
|
129
|
+
let navigating = false;
|
|
130
|
+
let focusBefore = null;
|
|
131
|
+
let activeElement = null;
|
|
132
|
+
let targetObserver;
|
|
133
|
+
const msg = (key) => uiM(key, undefined, locale);
|
|
134
|
+
const progressKey = (id) => `${persistKey}:${scope}:${id}`;
|
|
135
|
+
const tourFor = (id) => {
|
|
136
|
+
try {
|
|
137
|
+
return options.tours.find(tour => tour.id === id && (!tour.enabled || tour.enabled()));
|
|
138
|
+
}
|
|
139
|
+
catch {
|
|
140
|
+
return undefined;
|
|
141
|
+
}
|
|
142
|
+
};
|
|
143
|
+
function clearPending() {
|
|
144
|
+
try {
|
|
145
|
+
sessionStorage.removeItem(pendingKey);
|
|
146
|
+
}
|
|
147
|
+
catch {
|
|
148
|
+
// 存储受限时仅支持宿主客户端导航。
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
function stop() {
|
|
152
|
+
generation++;
|
|
153
|
+
abort?.abort();
|
|
154
|
+
abort = undefined;
|
|
155
|
+
targetObserver?.disconnect();
|
|
156
|
+
targetObserver = undefined;
|
|
157
|
+
const previousDriver = driver;
|
|
158
|
+
driver = undefined;
|
|
159
|
+
previousDriver?.destroy();
|
|
160
|
+
activeTourId = null;
|
|
161
|
+
activeElement = null;
|
|
162
|
+
busy = false;
|
|
163
|
+
expectedPath = undefined;
|
|
164
|
+
if (!navigating)
|
|
165
|
+
clearPending();
|
|
166
|
+
if (stopActiveGuide === stop)
|
|
167
|
+
stopActiveGuide = undefined;
|
|
168
|
+
if (focusBefore?.isConnected)
|
|
169
|
+
focusBefore.focus();
|
|
170
|
+
focusBefore = null;
|
|
171
|
+
}
|
|
172
|
+
function mark(tour, status) {
|
|
173
|
+
storage.set(progressKey(tour.id), { version: tour.version ?? 1, status, updatedAt: Date.now() });
|
|
174
|
+
}
|
|
175
|
+
function getProgress(id) {
|
|
176
|
+
return storage.get(progressKey(id));
|
|
177
|
+
}
|
|
178
|
+
function driverSteps(tour) {
|
|
179
|
+
return tour.steps.map(step => ({
|
|
180
|
+
element: () => findTarget(step) ?? document.body,
|
|
181
|
+
popover: {
|
|
182
|
+
title: escapeGuideText(step.title),
|
|
183
|
+
description: escapeGuideText(step.description),
|
|
184
|
+
side: step.side ?? 'bottom',
|
|
185
|
+
},
|
|
186
|
+
}));
|
|
187
|
+
}
|
|
188
|
+
function translatedConfig(tour) {
|
|
189
|
+
return {
|
|
190
|
+
steps: driverSteps(tour),
|
|
191
|
+
nextBtnText: msg('guide_next'),
|
|
192
|
+
prevBtnText: msg('guide_previous'),
|
|
193
|
+
doneBtnText: msg('guide_done'),
|
|
194
|
+
closeBtnLabel: msg('guide_close'),
|
|
195
|
+
progressText: uiM('guide_progress', { current: '{{current}}', total: '{{total}}' }, locale),
|
|
196
|
+
};
|
|
197
|
+
}
|
|
198
|
+
async function start(id) {
|
|
199
|
+
if (typeof document === 'undefined')
|
|
200
|
+
return false;
|
|
201
|
+
stopActiveGuide?.();
|
|
202
|
+
stop();
|
|
203
|
+
navigating = false;
|
|
204
|
+
error = '';
|
|
205
|
+
offeredId = null;
|
|
206
|
+
helpOpen = false;
|
|
207
|
+
const tour = tourFor(id);
|
|
208
|
+
if (!tour?.steps.length) {
|
|
209
|
+
error ||= 'guide_unavailable';
|
|
210
|
+
return false;
|
|
211
|
+
}
|
|
212
|
+
const run = generation;
|
|
213
|
+
const signal = new AbortController();
|
|
214
|
+
abort = signal;
|
|
215
|
+
activeTourId = id;
|
|
216
|
+
busy = true;
|
|
217
|
+
stopActiveGuide = stop;
|
|
218
|
+
focusBefore = document.activeElement instanceof HTMLElement ? document.activeElement : null;
|
|
219
|
+
const requiredSeen = new SvelteSet();
|
|
220
|
+
let finishHighlight;
|
|
221
|
+
function hasPreviousStep(index = driver?.getActiveIndex() ?? 0) {
|
|
222
|
+
return [...requiredSeen].some(stepIndex => stepIndex < index);
|
|
223
|
+
}
|
|
224
|
+
function disableNavigation(disabled) {
|
|
225
|
+
const popover = driver?.getState().popover;
|
|
226
|
+
if (popover) {
|
|
227
|
+
popover.nextButton.disabled = disabled;
|
|
228
|
+
popover.previousButton.disabled = disabled || !hasPreviousStep();
|
|
229
|
+
}
|
|
230
|
+
}
|
|
231
|
+
async function showStep(index, direction = 1) {
|
|
232
|
+
if (signal.signal.aborted || run !== generation)
|
|
233
|
+
return false;
|
|
234
|
+
busy = true;
|
|
235
|
+
disableNavigation(true);
|
|
236
|
+
try {
|
|
237
|
+
while (index >= 0 && index < tour.steps.length) {
|
|
238
|
+
const step = tour.steps[index];
|
|
239
|
+
await step.before?.(signal.signal);
|
|
240
|
+
await tick();
|
|
241
|
+
if (signal.signal.aborted || run !== generation)
|
|
242
|
+
return false;
|
|
243
|
+
const element = await waitForTarget(step, signal.signal, options.waitTimeout ?? 3000, () => !expectedPath || nav.pathname === expectedPath);
|
|
244
|
+
if (signal.signal.aborted || run !== generation)
|
|
245
|
+
return false;
|
|
246
|
+
if (!element) {
|
|
247
|
+
if (step.optional) {
|
|
248
|
+
index += direction;
|
|
249
|
+
continue;
|
|
250
|
+
}
|
|
251
|
+
error = 'guide_targetMissing';
|
|
252
|
+
stop();
|
|
253
|
+
return false;
|
|
254
|
+
}
|
|
255
|
+
requiredSeen.add(index);
|
|
256
|
+
activeElement = element;
|
|
257
|
+
driver?.setConfig({ ...driver.getConfig(), ...translatedConfig(tour) });
|
|
258
|
+
// 等到引擎完成首帧定位后再报告启动成功,键盘此时已可操作。
|
|
259
|
+
await new Promise((resolve) => {
|
|
260
|
+
const finished = () => {
|
|
261
|
+
signal.signal.removeEventListener('abort', finished);
|
|
262
|
+
if (finishHighlight === finished)
|
|
263
|
+
finishHighlight = undefined;
|
|
264
|
+
resolve();
|
|
265
|
+
};
|
|
266
|
+
finishHighlight = finished;
|
|
267
|
+
signal.signal.addEventListener('abort', finished, { once: true });
|
|
268
|
+
driver?.drive(index);
|
|
269
|
+
});
|
|
270
|
+
if (!signal.signal.aborted && run === generation && !findTarget(step)) {
|
|
271
|
+
error = 'guide_targetMissing';
|
|
272
|
+
stop();
|
|
273
|
+
return false;
|
|
274
|
+
}
|
|
275
|
+
return !signal.signal.aborted && run === generation;
|
|
276
|
+
}
|
|
277
|
+
if (direction > 0 && tour.steps.every((step, stepIndex) => step.optional || requiredSeen.has(stepIndex)) && requiredSeen.size) {
|
|
278
|
+
// 完成点击与 DOM 卸载可能发生在同一帧,不能把已消失的目标误记为完成。
|
|
279
|
+
const currentStep = tour.steps[driver?.getActiveIndex() ?? 0];
|
|
280
|
+
if (!currentStep || !findTarget(currentStep)) {
|
|
281
|
+
error = 'guide_targetMissing';
|
|
282
|
+
stop();
|
|
283
|
+
return false;
|
|
284
|
+
}
|
|
285
|
+
mark(tour, 'completed');
|
|
286
|
+
stop();
|
|
287
|
+
return true;
|
|
288
|
+
}
|
|
289
|
+
error = 'guide_targetMissing';
|
|
290
|
+
stop();
|
|
291
|
+
return false;
|
|
292
|
+
}
|
|
293
|
+
catch {
|
|
294
|
+
if (!signal.signal.aborted && run === generation) {
|
|
295
|
+
error = 'guide_startFailed';
|
|
296
|
+
stop();
|
|
297
|
+
}
|
|
298
|
+
return false;
|
|
299
|
+
}
|
|
300
|
+
finally {
|
|
301
|
+
if (run === generation) {
|
|
302
|
+
busy = false;
|
|
303
|
+
disableNavigation(false);
|
|
304
|
+
}
|
|
305
|
+
}
|
|
306
|
+
}
|
|
307
|
+
try {
|
|
308
|
+
// 动态导入引擎,只有开始导览时才加载定位和遮罩实现。
|
|
309
|
+
const { driver: createDriver } = await import('driver.js');
|
|
310
|
+
if (signal.signal.aborted || run !== generation)
|
|
311
|
+
return false;
|
|
312
|
+
if (tour.route && nav.pathname !== tour.route.split('?')[0]) {
|
|
313
|
+
expectedPath = tour.route.split('?')[0];
|
|
314
|
+
navigating = true;
|
|
315
|
+
try {
|
|
316
|
+
sessionStorage.setItem(pendingKey, JSON.stringify({ id, scope, route: expectedPath, createdAt: Date.now() }));
|
|
317
|
+
}
|
|
318
|
+
catch {
|
|
319
|
+
// Cookie 或 WebView 存储限制不阻止客户端导航。
|
|
320
|
+
}
|
|
321
|
+
await nav.navigate(tour.route);
|
|
322
|
+
if (signal.signal.aborted || run !== generation)
|
|
323
|
+
return false;
|
|
324
|
+
if (!options.nav) {
|
|
325
|
+
// 默认导航会完整加载新页面;保留待启动记录,由目标页宿主恢复。
|
|
326
|
+
stop();
|
|
327
|
+
return true;
|
|
328
|
+
}
|
|
329
|
+
navigating = false;
|
|
330
|
+
}
|
|
331
|
+
expectedPath ??= nav.pathname;
|
|
332
|
+
driver = createDriver({
|
|
333
|
+
...translatedConfig(tour),
|
|
334
|
+
popoverClass: 'hai-guide-popover',
|
|
335
|
+
showProgress: true,
|
|
336
|
+
animate: !globalThis.matchMedia?.('(prefers-reduced-motion: reduce)').matches,
|
|
337
|
+
duration: 200,
|
|
338
|
+
stageRadius: 10,
|
|
339
|
+
stagePadding: 8,
|
|
340
|
+
overlayOpacity: 0.45,
|
|
341
|
+
allowKeyboardControl: true,
|
|
342
|
+
overlayClickBehavior: 'close',
|
|
343
|
+
onNextClick: () => {
|
|
344
|
+
if (!busy)
|
|
345
|
+
void showStep((driver?.getActiveIndex() ?? 0) + 1);
|
|
346
|
+
},
|
|
347
|
+
onPrevClick: () => {
|
|
348
|
+
if (!busy && hasPreviousStep())
|
|
349
|
+
void showStep((driver?.getActiveIndex() ?? 0) - 1, -1);
|
|
350
|
+
},
|
|
351
|
+
onDoneClick: () => {
|
|
352
|
+
if (!busy)
|
|
353
|
+
void showStep(tour.steps.length);
|
|
354
|
+
},
|
|
355
|
+
onHighlighted: () => finishHighlight?.(),
|
|
356
|
+
// 引擎首帧未完成时不会触发 onDestroyed;从关闭开始时统一取消等待。
|
|
357
|
+
onDestroyStarted: stop,
|
|
358
|
+
onDestroyed: () => {
|
|
359
|
+
if (driver) {
|
|
360
|
+
driver = undefined;
|
|
361
|
+
stop();
|
|
362
|
+
}
|
|
363
|
+
},
|
|
364
|
+
onPopoverRender: (popover) => {
|
|
365
|
+
try {
|
|
366
|
+
// 第三方默认支持 HTML;业务翻译和插值统一按纯文本写入。
|
|
367
|
+
const index = driver?.getActiveIndex() ?? 0;
|
|
368
|
+
const step = tour.steps[index];
|
|
369
|
+
popover.title.textContent = resolveGuideText(step?.title);
|
|
370
|
+
popover.description.textContent = resolveGuideText(step?.description);
|
|
371
|
+
popover.nextButton.textContent = msg(index === tour.steps.length - 1 ? 'guide_done' : 'guide_next');
|
|
372
|
+
popover.previousButton.textContent = msg('guide_previous');
|
|
373
|
+
popover.progress.textContent = uiM('guide_progress', { current: index + 1, total: tour.steps.length }, locale);
|
|
374
|
+
popover.nextButton.disabled = busy;
|
|
375
|
+
popover.previousButton.disabled = busy || !hasPreviousStep(index);
|
|
376
|
+
}
|
|
377
|
+
catch {
|
|
378
|
+
error = 'guide_startFailed';
|
|
379
|
+
stop();
|
|
380
|
+
}
|
|
381
|
+
},
|
|
382
|
+
});
|
|
383
|
+
const started = await showStep(0);
|
|
384
|
+
if (started && !signal.signal.aborted) {
|
|
385
|
+
clearPending();
|
|
386
|
+
targetObserver = new MutationObserver(() => {
|
|
387
|
+
if (!busy && activeElement && !findTarget(tour.steps[driver?.getActiveIndex() ?? 0])) {
|
|
388
|
+
error = 'guide_targetMissing';
|
|
389
|
+
stop();
|
|
390
|
+
}
|
|
391
|
+
});
|
|
392
|
+
targetObserver.observe(document.documentElement, { subtree: true, childList: true, attributes: true });
|
|
393
|
+
}
|
|
394
|
+
return started;
|
|
395
|
+
}
|
|
396
|
+
catch {
|
|
397
|
+
if (!signal.signal.aborted && run === generation) {
|
|
398
|
+
navigating = false;
|
|
399
|
+
error = 'guide_startFailed';
|
|
400
|
+
stop();
|
|
401
|
+
}
|
|
402
|
+
return false;
|
|
403
|
+
}
|
|
404
|
+
}
|
|
405
|
+
return {
|
|
406
|
+
get tours() { return options.tours.filter(tour => !tour.enabled || tour.enabled()); },
|
|
407
|
+
get articles() { return (options.articles ?? []).filter(article => !article.enabled || article.enabled()); },
|
|
408
|
+
get offeredTour() { return offeredId ? tourFor(offeredId) : undefined; },
|
|
409
|
+
get activeTourId() { return activeTourId; },
|
|
410
|
+
get busy() { return busy; },
|
|
411
|
+
get error() { return error ? msg(error) : ''; },
|
|
412
|
+
get locale() { return locale; },
|
|
413
|
+
get pathname() { return nav.pathname; },
|
|
414
|
+
get helpOpen() { return helpOpen; },
|
|
415
|
+
get articleId() { return articleId; },
|
|
416
|
+
start,
|
|
417
|
+
startIfNeeded(id) {
|
|
418
|
+
const tour = tourFor(id);
|
|
419
|
+
if (!tour || activeTourId || offeredId || typeof document === 'undefined')
|
|
420
|
+
return false;
|
|
421
|
+
const progress = getProgress(id);
|
|
422
|
+
if (progress?.version === (tour.version ?? 1)
|
|
423
|
+
&& (progress.status !== 'deferred' || Date.now() - progress.updatedAt < 86400000)) {
|
|
424
|
+
return false;
|
|
425
|
+
}
|
|
426
|
+
offeredId = id;
|
|
427
|
+
return true;
|
|
428
|
+
},
|
|
429
|
+
defer() {
|
|
430
|
+
const tour = offeredId ? tourFor(offeredId) : undefined;
|
|
431
|
+
if (tour)
|
|
432
|
+
mark(tour, 'deferred');
|
|
433
|
+
offeredId = null;
|
|
434
|
+
},
|
|
435
|
+
dismiss() {
|
|
436
|
+
const tour = offeredId ? tourFor(offeredId) : undefined;
|
|
437
|
+
if (tour)
|
|
438
|
+
mark(tour, 'dismissed');
|
|
439
|
+
offeredId = null;
|
|
440
|
+
},
|
|
441
|
+
stop,
|
|
442
|
+
reset(id) { storage.set(progressKey(id), null); },
|
|
443
|
+
getProgress,
|
|
444
|
+
openHelp(id) {
|
|
445
|
+
stop();
|
|
446
|
+
offeredId = null;
|
|
447
|
+
error = '';
|
|
448
|
+
articleId = id ?? null;
|
|
449
|
+
helpOpen = true;
|
|
450
|
+
},
|
|
451
|
+
closeHelp() { helpOpen = false; },
|
|
452
|
+
clearError() { error = ''; },
|
|
453
|
+
setLocale(value) {
|
|
454
|
+
locale = value;
|
|
455
|
+
const tour = activeTourId ? tourFor(activeTourId) : undefined;
|
|
456
|
+
if (driver && tour) {
|
|
457
|
+
try {
|
|
458
|
+
driver.setConfig({ ...driver.getConfig(), ...translatedConfig(tour) });
|
|
459
|
+
driver.drive(driver.getActiveIndex() ?? 0);
|
|
460
|
+
}
|
|
461
|
+
catch {
|
|
462
|
+
error = 'guide_startFailed';
|
|
463
|
+
stop();
|
|
464
|
+
}
|
|
465
|
+
}
|
|
466
|
+
},
|
|
467
|
+
setScope(value) {
|
|
468
|
+
if (scope !== value) {
|
|
469
|
+
// 首次装配 scope 时保留上一页面的待启动记录,账号切换才取消当前交互。
|
|
470
|
+
if (activeTourId || offeredId || helpOpen) {
|
|
471
|
+
navigating = false;
|
|
472
|
+
stop();
|
|
473
|
+
}
|
|
474
|
+
scope = value;
|
|
475
|
+
offeredId = null;
|
|
476
|
+
helpOpen = false;
|
|
477
|
+
error = '';
|
|
478
|
+
}
|
|
479
|
+
},
|
|
480
|
+
handleNavigation(pathname) {
|
|
481
|
+
if (!navigating && activeTourId && expectedPath && pathname !== expectedPath)
|
|
482
|
+
stop();
|
|
483
|
+
},
|
|
484
|
+
async resume() {
|
|
485
|
+
try {
|
|
486
|
+
const raw = sessionStorage.getItem(pendingKey);
|
|
487
|
+
if (!raw)
|
|
488
|
+
return false;
|
|
489
|
+
clearPending();
|
|
490
|
+
const pending = JSON.parse(raw);
|
|
491
|
+
if (pending && typeof pending === 'object'
|
|
492
|
+
&& 'id' in pending && typeof pending.id === 'string'
|
|
493
|
+
&& 'scope' in pending && pending.scope === scope
|
|
494
|
+
&& 'route' in pending && pending.route === nav.pathname
|
|
495
|
+
&& 'createdAt' in pending && typeof pending.createdAt === 'number'
|
|
496
|
+
&& Date.now() - pending.createdAt < 300000) {
|
|
497
|
+
return await start(pending.id);
|
|
498
|
+
}
|
|
499
|
+
}
|
|
500
|
+
catch {
|
|
501
|
+
// 过期或损坏的导航记录不阻止页面使用。
|
|
502
|
+
}
|
|
503
|
+
return false;
|
|
504
|
+
},
|
|
505
|
+
};
|
|
506
|
+
}
|
package/dist/i18n.svelte.d.ts
CHANGED
|
@@ -5,20 +5,74 @@
|
|
|
5
5
|
* @module i18n.svelte
|
|
6
6
|
*/
|
|
7
7
|
import type { Locale, LocaleInfo } from '@h-ai/core';
|
|
8
|
-
|
|
8
|
+
import { changeUILocale as setGlobalLocale } from './internal/locale.js';
|
|
9
|
+
export { authErrorMessage } from './components/scenes/iam/auth-error-message.js';
|
|
10
|
+
declare const DEFAULT_LOCALE: string, DEFAULT_LOCALES: LocaleInfo[];
|
|
11
|
+
/**
|
|
12
|
+
* 检查语言是否匹配应用支持列表,允许区域回退,不把默认值计作命中。
|
|
13
|
+
* @param locale - 显式语言代码;省略时使用当前上下文。
|
|
14
|
+
* @param supportedLocales - 应用支持的语言列表。
|
|
15
|
+
* @returns 是否存在真实支持项。
|
|
16
|
+
* @example
|
|
17
|
+
* ```ts
|
|
18
|
+
* import { isLocaleSupported } from '@h-ai/ui/i18n'
|
|
19
|
+
* const supported = isLocaleSupported('en-GB')
|
|
20
|
+
* ```
|
|
21
|
+
*/
|
|
9
22
|
declare function isLocaleSupported(locale: Locale, supportedLocales?: LocaleInfo[]): boolean;
|
|
23
|
+
/**
|
|
24
|
+
* 将候选语言归一化为支持列表中的实际代码,无命中时使用默认值。
|
|
25
|
+
* @param locale - 显式语言代码;省略时使用当前上下文。
|
|
26
|
+
* @param supportedLocales - 应用支持的语言列表。
|
|
27
|
+
* @param defaultLocale - 无候选命中时的默认语言。
|
|
28
|
+
* @returns 归一化后的文本。
|
|
29
|
+
* @example
|
|
30
|
+
* ```ts
|
|
31
|
+
* import { resolveLocale } from '@h-ai/ui/i18n'
|
|
32
|
+
* const locale = resolveLocale('unsupported', undefined, 'zh-CN')
|
|
33
|
+
* ```
|
|
34
|
+
*/
|
|
10
35
|
declare function resolveLocale(locale: Locale, supportedLocales?: LocaleInfo[], defaultLocale?: Locale): Locale;
|
|
36
|
+
/**
|
|
37
|
+
* 依浏览器语言顺序选择实际支持项;SSR 或无匹配项返回 null。
|
|
38
|
+
* @param supportedLocales - 应用支持的语言列表。
|
|
39
|
+
* @returns 规范的语言代码或 null。
|
|
40
|
+
* @example
|
|
41
|
+
* ```ts
|
|
42
|
+
* import { detectBrowserLocale } from '@h-ai/ui/i18n'
|
|
43
|
+
* const locale = detectBrowserLocale()
|
|
44
|
+
* ```
|
|
45
|
+
*/
|
|
11
46
|
declare function detectBrowserLocale(supportedLocales?: LocaleInfo[]): Locale | null;
|
|
47
|
+
/**
|
|
48
|
+
* 替换消息模板中的命名参数;缺少的参数保留原占位符。
|
|
49
|
+
* @param template - 包含命名占位符的消息模板。
|
|
50
|
+
* @param params - 消息插值参数。
|
|
51
|
+
* @returns 归一化后的文本。
|
|
52
|
+
* @example
|
|
53
|
+
* ```ts
|
|
54
|
+
* import { interpolate } from '@h-ai/ui/i18n'
|
|
55
|
+
* const message = interpolate('你好,{name}', { name: 'Ada' })
|
|
56
|
+
* ```
|
|
57
|
+
*/
|
|
12
58
|
declare function interpolate(template: string, params?: Record<string, string | number | boolean>): string;
|
|
13
59
|
/**
|
|
14
60
|
* 创建 locale 状态管理器
|
|
15
61
|
*
|
|
16
62
|
* @param options - 配置选项
|
|
17
|
-
* @param options.defaultLocale -
|
|
63
|
+
* @param options.defaultLocale - 全部候选不支持后的默认 locale;不在列表时使用首个支持项。
|
|
18
64
|
* @param options.supportedLocales - 支持的 locale 列表
|
|
19
|
-
* @param options.detectBrowser -
|
|
65
|
+
* @param options.detectBrowser - 是否按完整 navigator.languages 顺序匹配;全部失败才回退默认值。
|
|
20
66
|
* @param options.persistKey - localStorage key
|
|
21
67
|
* @returns locale 状态对象
|
|
68
|
+
*
|
|
69
|
+
* @example
|
|
70
|
+
* ```ts
|
|
71
|
+
* import { createLocaleStore } from '@h-ai/ui'
|
|
72
|
+
* const locale = createLocaleStore({ defaultLocale: 'zh-CN', detectBrowser: false, persistKey: 'demo-locale' })
|
|
73
|
+
* locale.set('en-US')
|
|
74
|
+
* const selected = locale.current
|
|
75
|
+
* ```
|
|
22
76
|
*/
|
|
23
77
|
export declare function createLocaleStore(options?: {
|
|
24
78
|
defaultLocale?: Locale;
|
|
@@ -32,7 +86,7 @@ export declare function createLocaleStore(options?: {
|
|
|
32
86
|
readonly supported: LocaleInfo[];
|
|
33
87
|
/**
|
|
34
88
|
* 设置当前语言
|
|
35
|
-
*
|
|
89
|
+
* 浏览器同步到 @h-ai/core;SSR 仅改变当前 store,消息语言由 runWithLocale 绑定。
|
|
36
90
|
* 注意:你还需要调用 Paraglide 的 setLocale 来更新 UI 翻译
|
|
37
91
|
*/
|
|
38
92
|
set(locale: Locale): void;
|
|
@@ -41,4 +95,13 @@ export declare function createLocaleStore(options?: {
|
|
|
41
95
|
};
|
|
42
96
|
export type { InterpolationParams, Locale, LocaleInfo } from '@h-ai/core';
|
|
43
97
|
export { DEFAULT_LOCALE, DEFAULT_LOCALES, detectBrowserLocale, interpolate, isLocaleSupported, resolveLocale, setGlobalLocale, };
|
|
98
|
+
/**
|
|
99
|
+
* 读取 core 当前请求或浏览器上下文的语言,不由 UI store 隐式改写服务端默认值。
|
|
100
|
+
*
|
|
101
|
+
* @example
|
|
102
|
+
* ```ts
|
|
103
|
+
* import { getGlobalLocale } from '@h-ai/ui'
|
|
104
|
+
* const currentLocale = getGlobalLocale()
|
|
105
|
+
* ```
|
|
106
|
+
*/
|
|
44
107
|
export declare const getGlobalLocale: () => Locale;
|