@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/i18n.svelte.js
CHANGED
|
@@ -5,32 +5,97 @@
|
|
|
5
5
|
* @module i18n.svelte
|
|
6
6
|
*/
|
|
7
7
|
import { core } from '@h-ai/core';
|
|
8
|
+
import { readStoredValue, writeStoredValue } from './internal/browser-safety.js';
|
|
9
|
+
import { changeUILocale as setGlobalLocale } from './internal/locale.js';
|
|
10
|
+
// 状态层可格式化安全认证提示,无需加载场景组件。
|
|
11
|
+
export { authErrorMessage } from './components/scenes/iam/auth-error-message.js';
|
|
8
12
|
// 从 core.i18n 解构常用函数
|
|
9
|
-
const { DEFAULT_LOCALE, DEFAULT_LOCALES,
|
|
13
|
+
const { DEFAULT_LOCALE, DEFAULT_LOCALES, } = core.i18n;
|
|
14
|
+
/** 匹配实际支持项;区域/脚本逐级回退,始终返回列表中的原始代码,不执行默认回退。 */
|
|
15
|
+
function matchSupportedLocale(locale, supportedLocales) {
|
|
16
|
+
const normalize = (value) => value.trim().replaceAll('_', '-').toLowerCase();
|
|
17
|
+
let candidate = normalize(locale);
|
|
18
|
+
while (candidate) {
|
|
19
|
+
const exact = supportedLocales.find(item => normalize(item.code) === candidate);
|
|
20
|
+
if (exact)
|
|
21
|
+
return exact.code;
|
|
22
|
+
const variant = supportedLocales.find(item => normalize(item.code).startsWith(`${candidate}-`));
|
|
23
|
+
if (variant)
|
|
24
|
+
return variant.code;
|
|
25
|
+
const separator = candidate.lastIndexOf('-');
|
|
26
|
+
candidate = separator < 0 ? '' : candidate.slice(0, separator);
|
|
27
|
+
}
|
|
28
|
+
return null;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* 检查语言是否匹配应用支持列表,允许区域回退,不把默认值计作命中。
|
|
32
|
+
* @param locale - 显式语言代码;省略时使用当前上下文。
|
|
33
|
+
* @param supportedLocales - 应用支持的语言列表。
|
|
34
|
+
* @returns 是否存在真实支持项。
|
|
35
|
+
* @example
|
|
36
|
+
* ```ts
|
|
37
|
+
* import { isLocaleSupported } from '@h-ai/ui/i18n'
|
|
38
|
+
* const supported = isLocaleSupported('en-GB')
|
|
39
|
+
* ```
|
|
40
|
+
*/
|
|
10
41
|
function isLocaleSupported(locale, supportedLocales = DEFAULT_LOCALES) {
|
|
11
|
-
|
|
12
|
-
return supportedLocales.some(item => item.code === normalized);
|
|
42
|
+
return matchSupportedLocale(locale, supportedLocales) !== null;
|
|
13
43
|
}
|
|
44
|
+
/**
|
|
45
|
+
* 将候选语言归一化为支持列表中的实际代码,无命中时使用默认值。
|
|
46
|
+
* @param locale - 显式语言代码;省略时使用当前上下文。
|
|
47
|
+
* @param supportedLocales - 应用支持的语言列表。
|
|
48
|
+
* @param defaultLocale - 无候选命中时的默认语言。
|
|
49
|
+
* @returns 归一化后的文本。
|
|
50
|
+
* @example
|
|
51
|
+
* ```ts
|
|
52
|
+
* import { resolveLocale } from '@h-ai/ui/i18n'
|
|
53
|
+
* const locale = resolveLocale('unsupported', undefined, 'zh-CN')
|
|
54
|
+
* ```
|
|
55
|
+
*/
|
|
14
56
|
function resolveLocale(locale, supportedLocales = DEFAULT_LOCALES, defaultLocale = DEFAULT_LOCALE) {
|
|
15
|
-
|
|
16
|
-
|
|
57
|
+
return matchSupportedLocale(locale, supportedLocales)
|
|
58
|
+
?? matchSupportedLocale(defaultLocale, supportedLocales)
|
|
59
|
+
?? supportedLocales[0]?.code
|
|
60
|
+
?? defaultLocale;
|
|
17
61
|
}
|
|
62
|
+
/**
|
|
63
|
+
* 依浏览器语言顺序选择实际支持项;SSR 或无匹配项返回 null。
|
|
64
|
+
* @param supportedLocales - 应用支持的语言列表。
|
|
65
|
+
* @returns 规范的语言代码或 null。
|
|
66
|
+
* @example
|
|
67
|
+
* ```ts
|
|
68
|
+
* import { detectBrowserLocale } from '@h-ai/ui/i18n'
|
|
69
|
+
* const locale = detectBrowserLocale()
|
|
70
|
+
* ```
|
|
71
|
+
*/
|
|
18
72
|
function detectBrowserLocale(supportedLocales = DEFAULT_LOCALES) {
|
|
19
|
-
if (typeof navigator === 'undefined') {
|
|
73
|
+
if (typeof window === 'undefined' || typeof navigator === 'undefined') {
|
|
20
74
|
return null;
|
|
21
75
|
}
|
|
22
76
|
const browserCandidates = [
|
|
23
|
-
navigator.language,
|
|
24
77
|
...(navigator.languages ?? []),
|
|
78
|
+
navigator.language,
|
|
25
79
|
];
|
|
26
80
|
for (const candidate of browserCandidates) {
|
|
27
|
-
const resolved =
|
|
28
|
-
if (
|
|
81
|
+
const resolved = matchSupportedLocale(candidate, supportedLocales);
|
|
82
|
+
if (resolved) {
|
|
29
83
|
return resolved;
|
|
30
84
|
}
|
|
31
85
|
}
|
|
32
86
|
return null;
|
|
33
87
|
}
|
|
88
|
+
/**
|
|
89
|
+
* 替换消息模板中的命名参数;缺少的参数保留原占位符。
|
|
90
|
+
* @param template - 包含命名占位符的消息模板。
|
|
91
|
+
* @param params - 消息插值参数。
|
|
92
|
+
* @returns 归一化后的文本。
|
|
93
|
+
* @example
|
|
94
|
+
* ```ts
|
|
95
|
+
* import { interpolate } from '@h-ai/ui/i18n'
|
|
96
|
+
* const message = interpolate('你好,{name}', { name: 'Ada' })
|
|
97
|
+
* ```
|
|
98
|
+
*/
|
|
34
99
|
function interpolate(template, params = {}) {
|
|
35
100
|
return template.replace(/\{(\w+)\}/g, (_, key) => {
|
|
36
101
|
const value = params[key];
|
|
@@ -44,21 +109,30 @@ const LOCALE_STORAGE_KEY = 'hai-locale';
|
|
|
44
109
|
* 创建 locale 状态管理器
|
|
45
110
|
*
|
|
46
111
|
* @param options - 配置选项
|
|
47
|
-
* @param options.defaultLocale -
|
|
112
|
+
* @param options.defaultLocale - 全部候选不支持后的默认 locale;不在列表时使用首个支持项。
|
|
48
113
|
* @param options.supportedLocales - 支持的 locale 列表
|
|
49
|
-
* @param options.detectBrowser -
|
|
114
|
+
* @param options.detectBrowser - 是否按完整 navigator.languages 顺序匹配;全部失败才回退默认值。
|
|
50
115
|
* @param options.persistKey - localStorage key
|
|
51
116
|
* @returns locale 状态对象
|
|
117
|
+
*
|
|
118
|
+
* @example
|
|
119
|
+
* ```ts
|
|
120
|
+
* import { createLocaleStore } from '@h-ai/ui'
|
|
121
|
+
* const locale = createLocaleStore({ defaultLocale: 'zh-CN', detectBrowser: false, persistKey: 'demo-locale' })
|
|
122
|
+
* locale.set('en-US')
|
|
123
|
+
* const selected = locale.current
|
|
124
|
+
* ```
|
|
52
125
|
*/
|
|
53
126
|
export function createLocaleStore(options = {}) {
|
|
54
127
|
const { defaultLocale = DEFAULT_LOCALE, supportedLocales = DEFAULT_LOCALES, detectBrowser = true, persistKey = LOCALE_STORAGE_KEY, } = options;
|
|
55
128
|
// 初始化 locale
|
|
56
|
-
let initialLocale = defaultLocale;
|
|
129
|
+
let initialLocale = resolveLocale(defaultLocale, supportedLocales, defaultLocale);
|
|
57
130
|
if (typeof window !== 'undefined') {
|
|
58
131
|
// 1. 优先从 localStorage 读取
|
|
59
|
-
const savedLocale =
|
|
60
|
-
|
|
61
|
-
|
|
132
|
+
const savedLocale = readStoredValue(persistKey);
|
|
133
|
+
const supportedSavedLocale = savedLocale ? matchSupportedLocale(savedLocale, supportedLocales) : null;
|
|
134
|
+
if (supportedSavedLocale) {
|
|
135
|
+
initialLocale = supportedSavedLocale;
|
|
62
136
|
}
|
|
63
137
|
// 2. 其次检测浏览器语言
|
|
64
138
|
else if (detectBrowser) {
|
|
@@ -68,8 +142,9 @@ export function createLocaleStore(options = {}) {
|
|
|
68
142
|
}
|
|
69
143
|
}
|
|
70
144
|
}
|
|
71
|
-
//
|
|
72
|
-
|
|
145
|
+
// SSR store 属于当前组件树,不能修改另一个请求的默认语言。
|
|
146
|
+
if (typeof window !== 'undefined')
|
|
147
|
+
setGlobalLocale(initialLocale);
|
|
73
148
|
// 使用 Svelte 5 runes 创建响应式状态
|
|
74
149
|
let currentLocale = $state(initialLocale);
|
|
75
150
|
return {
|
|
@@ -83,17 +158,18 @@ export function createLocaleStore(options = {}) {
|
|
|
83
158
|
},
|
|
84
159
|
/**
|
|
85
160
|
* 设置当前语言
|
|
86
|
-
*
|
|
161
|
+
* 浏览器同步到 @h-ai/core;SSR 仅改变当前 store,消息语言由 runWithLocale 绑定。
|
|
87
162
|
* 注意:你还需要调用 Paraglide 的 setLocale 来更新 UI 翻译
|
|
88
163
|
*/
|
|
89
164
|
set(locale) {
|
|
90
165
|
const resolved = resolveLocale(locale, supportedLocales, defaultLocale);
|
|
91
166
|
currentLocale = resolved;
|
|
92
|
-
//
|
|
93
|
-
|
|
167
|
+
// 服务端语言由外层 runWithLocale 明确绑定,store 只在浏览器同步应用状态。
|
|
168
|
+
if (typeof window !== 'undefined')
|
|
169
|
+
setGlobalLocale(resolved);
|
|
94
170
|
// 持久化到 localStorage
|
|
95
171
|
if (typeof window !== 'undefined') {
|
|
96
|
-
|
|
172
|
+
writeStoredValue(persistKey, resolved);
|
|
97
173
|
}
|
|
98
174
|
},
|
|
99
175
|
/** 检查语言是否支持 */
|
|
@@ -105,4 +181,13 @@ export function createLocaleStore(options = {}) {
|
|
|
105
181
|
// 重导出常用常量和函数(便于应用层使用)
|
|
106
182
|
export { DEFAULT_LOCALE, DEFAULT_LOCALES, detectBrowserLocale, interpolate, isLocaleSupported, resolveLocale, setGlobalLocale, };
|
|
107
183
|
// 导出额外的便捷函数
|
|
184
|
+
/**
|
|
185
|
+
* 读取 core 当前请求或浏览器上下文的语言,不由 UI store 隐式改写服务端默认值。
|
|
186
|
+
*
|
|
187
|
+
* @example
|
|
188
|
+
* ```ts
|
|
189
|
+
* import { getGlobalLocale } from '@h-ai/ui'
|
|
190
|
+
* const currentLocale = getGlobalLocale()
|
|
191
|
+
* ```
|
|
192
|
+
*/
|
|
108
193
|
export const getGlobalLocale = core.i18n.getGlobalLocale;
|
package/dist/index.d.ts
CHANGED
|
@@ -5,7 +5,13 @@
|
|
|
5
5
|
* @module index
|
|
6
6
|
*/
|
|
7
7
|
export * from './components/index.js';
|
|
8
|
+
export * from './guide-types.js';
|
|
9
|
+
export * from './guide.svelte.js';
|
|
8
10
|
export * from './i18n.svelte.js';
|
|
11
|
+
export type { ClipboardHostWriter } from './internal/browser-safety.js';
|
|
12
|
+
export { registerClipboardHostWriter, writeTextToClipboard } from './internal/browser-safety.js';
|
|
13
|
+
export * from './message.svelte.js';
|
|
14
|
+
export * from './messagebox.svelte.js';
|
|
9
15
|
export * from './theme-config.js';
|
|
10
16
|
export * from './toast.svelte.js';
|
|
11
17
|
export * from './types.js';
|
package/dist/index.js
CHANGED
|
@@ -6,8 +6,15 @@
|
|
|
6
6
|
*/
|
|
7
7
|
// ─── 组件导出(从 components/ 统一导出所有三层组件及其类型) ───
|
|
8
8
|
export * from './components/index.js';
|
|
9
|
+
export * from './guide-types.js';
|
|
10
|
+
export * from './guide.svelte.js';
|
|
9
11
|
// ─── i18n 国际化(Paraglide 辅助工具) ───
|
|
10
12
|
export * from './i18n.svelte.js';
|
|
13
|
+
export { registerClipboardHostWriter, writeTextToClipboard } from './internal/browser-safety.js';
|
|
14
|
+
// ─── Message 轻量消息提示(类似 ElementUI Message) ───
|
|
15
|
+
export * from './message.svelte.js';
|
|
16
|
+
// ─── MessageBox 命令式弹框(类似 ElementUI MessageBox) ───
|
|
17
|
+
export * from './messagebox.svelte.js';
|
|
11
18
|
// ─── 主题配置 ───
|
|
12
19
|
export * from './theme-config.js';
|
|
13
20
|
// ─── Toast 状态管理 ───
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @h-ai/ui — 浏览器能力安全辅助
|
|
3
|
+
*
|
|
4
|
+
* 统一封装容易在受限 WebView、隐私模式或不安全上下文中失败的浏览器 API,
|
|
5
|
+
* 让组件在能力缺失时优雅降级而不是抛出运行时错误。
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
* 宿主页面剪贴板写入器(跨域 iframe 场景由嵌入方注入)。
|
|
9
|
+
*
|
|
10
|
+
* @example
|
|
11
|
+
* ```ts
|
|
12
|
+
* import type { ClipboardHostWriter } from '@h-ai/ui'
|
|
13
|
+
* const writer: ClipboardHostWriter = async text => {
|
|
14
|
+
* try { await navigator.clipboard.writeText(text); return true }
|
|
15
|
+
* catch { return false }
|
|
16
|
+
* }
|
|
17
|
+
* ```
|
|
18
|
+
*/
|
|
19
|
+
export type ClipboardHostWriter = (text: string) => Promise<boolean>;
|
|
20
|
+
/**
|
|
21
|
+
* 注册宿主页面剪贴板写入器。
|
|
22
|
+
*
|
|
23
|
+
* 当 iframe 内 Clipboard API 与 execCommand 都不可用时,把文本交给宿主页面写入。
|
|
24
|
+
* 宿主仍须满足自身权限、焦点与用户激活要求;返回 false 表示实际写入未成功,不能保证兜底一定可用。
|
|
25
|
+
*
|
|
26
|
+
* @param writer - 宿主写入器;传入 null 注销
|
|
27
|
+
* @returns {void} 无返回值;替换宿主写入器,null 用于注销。
|
|
28
|
+
*
|
|
29
|
+
* @example
|
|
30
|
+
* ```ts
|
|
31
|
+
* import { registerClipboardHostWriter } from '@h-ai/ui'
|
|
32
|
+
* registerClipboardHostWriter(async text => {
|
|
33
|
+
* try { await navigator.clipboard.writeText(text); return true }
|
|
34
|
+
* catch { return false }
|
|
35
|
+
* })
|
|
36
|
+
* // 宿主销毁时注销,避免保留过期窗口闭包。
|
|
37
|
+
* registerClipboardHostWriter(null)
|
|
38
|
+
* ```
|
|
39
|
+
*/
|
|
40
|
+
export declare function registerClipboardHostWriter(writer: ClipboardHostWriter | null): void;
|
|
41
|
+
/**
|
|
42
|
+
* 安全读取 localStorage。
|
|
43
|
+
*
|
|
44
|
+
* 某些浏览器隐私模式或嵌入式 WebView 会在访问 localStorage 时直接抛出 SecurityError,
|
|
45
|
+
* 这里统一吞掉异常并回退为 null。
|
|
46
|
+
* @param key - 要读取的条目或消息键。
|
|
47
|
+
* @returns 偏好值;未保存、SSR 或读取失败时返回 null。
|
|
48
|
+
*
|
|
49
|
+
* @example 模块内部上下文
|
|
50
|
+
* ```ts
|
|
51
|
+
* const savedTheme = readStoredValue('demo-theme')
|
|
52
|
+
* // 只保存非敏感偏好;不可用于认证 Token。
|
|
53
|
+
* ```
|
|
54
|
+
*/
|
|
55
|
+
export declare function readStoredValue(key: string): string | null;
|
|
56
|
+
/**
|
|
57
|
+
* 安全写入 localStorage。
|
|
58
|
+
*
|
|
59
|
+
* 返回值显式告诉调用方持久化是否成功,方便调用方在失败时继续使用内存态而不必中断交互。
|
|
60
|
+
* @param key - 要读取的条目或消息键。
|
|
61
|
+
* @param value - 待处理或校验的值。
|
|
62
|
+
* @returns 持久化是否成功;失败时调用方可继续保留非敏感内存偏好。
|
|
63
|
+
*
|
|
64
|
+
* @example 模块内部上下文
|
|
65
|
+
* ```ts
|
|
66
|
+
* const persisted = writeStoredValue('demo-theme', 'dark')
|
|
67
|
+
* if (!persisted) { const memoryTheme = 'dark' }
|
|
68
|
+
* ```
|
|
69
|
+
*/
|
|
70
|
+
export declare function writeStoredValue(key: string, value: string): boolean;
|
|
71
|
+
/**
|
|
72
|
+
* 安全写入剪贴板。
|
|
73
|
+
*
|
|
74
|
+
* 优先使用现代 Clipboard API;在不安全上下文(HTTP)、旧 WebView
|
|
75
|
+
* 或浏览器策略禁用时回退到 `document.execCommand('copy')`;
|
|
76
|
+
* 跨域 iframe 中上述两种方式都可能被权限/聚焦策略拒绝时,再回退到宿主页面写入器,
|
|
77
|
+
* 确保尽可能多的环境下复制操作可用。
|
|
78
|
+
* @param text - 待处理文本。
|
|
79
|
+
* @returns 任一实际写入路径是否成功。
|
|
80
|
+
*
|
|
81
|
+
* @example
|
|
82
|
+
* ```ts
|
|
83
|
+
* import { writeTextToClipboard } from '@h-ai/ui'
|
|
84
|
+
* const copied = await writeTextToClipboard('https://example.com/help')
|
|
85
|
+
* if (!copied) throw new Error('Clipboard is unavailable')
|
|
86
|
+
* ```
|
|
87
|
+
*/
|
|
88
|
+
export declare function writeTextToClipboard(text: string): Promise<boolean>;
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @h-ai/ui — 浏览器能力安全辅助
|
|
3
|
+
*
|
|
4
|
+
* 统一封装容易在受限 WebView、隐私模式或不安全上下文中失败的浏览器 API,
|
|
5
|
+
* 让组件在能力缺失时优雅降级而不是抛出运行时错误。
|
|
6
|
+
*/
|
|
7
|
+
let clipboardHostWriter = null;
|
|
8
|
+
/**
|
|
9
|
+
* 注册宿主页面剪贴板写入器。
|
|
10
|
+
*
|
|
11
|
+
* 当 iframe 内 Clipboard API 与 execCommand 都不可用时,把文本交给宿主页面写入。
|
|
12
|
+
* 宿主仍须满足自身权限、焦点与用户激活要求;返回 false 表示实际写入未成功,不能保证兜底一定可用。
|
|
13
|
+
*
|
|
14
|
+
* @param writer - 宿主写入器;传入 null 注销
|
|
15
|
+
* @returns {void} 无返回值;替换宿主写入器,null 用于注销。
|
|
16
|
+
*
|
|
17
|
+
* @example
|
|
18
|
+
* ```ts
|
|
19
|
+
* import { registerClipboardHostWriter } from '@h-ai/ui'
|
|
20
|
+
* registerClipboardHostWriter(async text => {
|
|
21
|
+
* try { await navigator.clipboard.writeText(text); return true }
|
|
22
|
+
* catch { return false }
|
|
23
|
+
* })
|
|
24
|
+
* // 宿主销毁时注销,避免保留过期窗口闭包。
|
|
25
|
+
* registerClipboardHostWriter(null)
|
|
26
|
+
* ```
|
|
27
|
+
*/
|
|
28
|
+
export function registerClipboardHostWriter(writer) {
|
|
29
|
+
clipboardHostWriter = writer;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* 安全读取 localStorage。
|
|
33
|
+
*
|
|
34
|
+
* 某些浏览器隐私模式或嵌入式 WebView 会在访问 localStorage 时直接抛出 SecurityError,
|
|
35
|
+
* 这里统一吞掉异常并回退为 null。
|
|
36
|
+
* @param key - 要读取的条目或消息键。
|
|
37
|
+
* @returns 偏好值;未保存、SSR 或读取失败时返回 null。
|
|
38
|
+
*
|
|
39
|
+
* @example 模块内部上下文
|
|
40
|
+
* ```ts
|
|
41
|
+
* const savedTheme = readStoredValue('demo-theme')
|
|
42
|
+
* // 只保存非敏感偏好;不可用于认证 Token。
|
|
43
|
+
* ```
|
|
44
|
+
*/
|
|
45
|
+
export function readStoredValue(key) {
|
|
46
|
+
try {
|
|
47
|
+
if (typeof localStorage === 'undefined') {
|
|
48
|
+
return null;
|
|
49
|
+
}
|
|
50
|
+
return localStorage.getItem(key);
|
|
51
|
+
}
|
|
52
|
+
catch {
|
|
53
|
+
return null;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* 安全写入 localStorage。
|
|
58
|
+
*
|
|
59
|
+
* 返回值显式告诉调用方持久化是否成功,方便调用方在失败时继续使用内存态而不必中断交互。
|
|
60
|
+
* @param key - 要读取的条目或消息键。
|
|
61
|
+
* @param value - 待处理或校验的值。
|
|
62
|
+
* @returns 持久化是否成功;失败时调用方可继续保留非敏感内存偏好。
|
|
63
|
+
*
|
|
64
|
+
* @example 模块内部上下文
|
|
65
|
+
* ```ts
|
|
66
|
+
* const persisted = writeStoredValue('demo-theme', 'dark')
|
|
67
|
+
* if (!persisted) { const memoryTheme = 'dark' }
|
|
68
|
+
* ```
|
|
69
|
+
*/
|
|
70
|
+
export function writeStoredValue(key, value) {
|
|
71
|
+
try {
|
|
72
|
+
if (typeof localStorage === 'undefined') {
|
|
73
|
+
return false;
|
|
74
|
+
}
|
|
75
|
+
localStorage.setItem(key, value);
|
|
76
|
+
return true;
|
|
77
|
+
}
|
|
78
|
+
catch {
|
|
79
|
+
return false;
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* 安全写入剪贴板。
|
|
84
|
+
*
|
|
85
|
+
* 优先使用现代 Clipboard API;在不安全上下文(HTTP)、旧 WebView
|
|
86
|
+
* 或浏览器策略禁用时回退到 `document.execCommand('copy')`;
|
|
87
|
+
* 跨域 iframe 中上述两种方式都可能被权限/聚焦策略拒绝时,再回退到宿主页面写入器,
|
|
88
|
+
* 确保尽可能多的环境下复制操作可用。
|
|
89
|
+
* @param text - 待处理文本。
|
|
90
|
+
* @returns 任一实际写入路径是否成功。
|
|
91
|
+
*
|
|
92
|
+
* @example
|
|
93
|
+
* ```ts
|
|
94
|
+
* import { writeTextToClipboard } from '@h-ai/ui'
|
|
95
|
+
* const copied = await writeTextToClipboard('https://example.com/help')
|
|
96
|
+
* if (!copied) throw new Error('Clipboard is unavailable')
|
|
97
|
+
* ```
|
|
98
|
+
*/
|
|
99
|
+
export async function writeTextToClipboard(text) {
|
|
100
|
+
// 现代 Clipboard API(仅安全上下文可用)
|
|
101
|
+
if (typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {
|
|
102
|
+
try {
|
|
103
|
+
await navigator.clipboard.writeText(text);
|
|
104
|
+
return true;
|
|
105
|
+
}
|
|
106
|
+
catch {
|
|
107
|
+
// Clipboard API 失败时继续尝试 fallback
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
// fallback:textarea + execCommand(兼容 HTTP、旧浏览器)
|
|
111
|
+
if (typeof document !== 'undefined') {
|
|
112
|
+
try {
|
|
113
|
+
const textarea = document.createElement('textarea');
|
|
114
|
+
textarea.value = text;
|
|
115
|
+
textarea.style.cssText = 'position:fixed;left:-9999px;top:-9999px;opacity:0';
|
|
116
|
+
document.body.appendChild(textarea);
|
|
117
|
+
try {
|
|
118
|
+
textarea.select();
|
|
119
|
+
if (document.execCommand('copy'))
|
|
120
|
+
return true;
|
|
121
|
+
}
|
|
122
|
+
finally {
|
|
123
|
+
document.body.removeChild(textarea);
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
catch {
|
|
127
|
+
// 继续尝试宿主写入器
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
// 最终兜底:跨域 iframe 场景由宿主页面写入
|
|
131
|
+
if (clipboardHostWriter) {
|
|
132
|
+
try {
|
|
133
|
+
return await clipboardHostWriter(text);
|
|
134
|
+
}
|
|
135
|
+
catch {
|
|
136
|
+
return false;
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
return false;
|
|
140
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 打开后优先聚焦可编辑字段,清理时取消首帧校准并恢复触发控件。
|
|
3
|
+
* @example 模块内部上下文
|
|
4
|
+
* ```ts
|
|
5
|
+
* function example(panel: HTMLElement) {
|
|
6
|
+
* const restore = focusDialog(panel)
|
|
7
|
+
* return restore
|
|
8
|
+
* }
|
|
9
|
+
* ```
|
|
10
|
+
*/
|
|
11
|
+
export declare function focusDialog(panel: HTMLElement): () => void;
|
|
12
|
+
/**
|
|
13
|
+
* 原生 Tab 顺序只在边缘循环;嵌套弹层已处理的键盘事件不再拦截。
|
|
14
|
+
* @example 模块内部上下文
|
|
15
|
+
* ```ts
|
|
16
|
+
* function example(event: KeyboardEvent, panel: HTMLElement) {
|
|
17
|
+
* handleDialogKeydown(event, panel, () => {})
|
|
18
|
+
* }
|
|
19
|
+
* ```
|
|
20
|
+
*/
|
|
21
|
+
export declare function handleDialogKeydown(event: KeyboardEvent, panel: HTMLElement, close?: () => void): void;
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/** 弹窗和抽屉共享可见、可操作的焦点边界。 */
|
|
2
|
+
function focusable(panel) {
|
|
3
|
+
return [...panel.querySelectorAll('button, a[href], input:not([type="hidden"]), select, textarea, [tabindex]')]
|
|
4
|
+
.filter(element => element.tabIndex >= 0 && !element.matches(':disabled') && element.getClientRects().length > 0);
|
|
5
|
+
}
|
|
6
|
+
/**
|
|
7
|
+
* 打开后优先聚焦可编辑字段,清理时取消首帧校准并恢复触发控件。
|
|
8
|
+
* @example 模块内部上下文
|
|
9
|
+
* ```ts
|
|
10
|
+
* function example(panel: HTMLElement) {
|
|
11
|
+
* const restore = focusDialog(panel)
|
|
12
|
+
* return restore
|
|
13
|
+
* }
|
|
14
|
+
* ```
|
|
15
|
+
*/
|
|
16
|
+
export function focusDialog(panel) {
|
|
17
|
+
const previous = document.activeElement instanceof HTMLElement ? document.activeElement : null;
|
|
18
|
+
function preferred() {
|
|
19
|
+
const elements = focusable(panel);
|
|
20
|
+
return elements.find(element => element.matches('input:not([readonly]), textarea, select, [role="combobox"]')) ?? elements[0] ?? panel;
|
|
21
|
+
}
|
|
22
|
+
const initial = preferred();
|
|
23
|
+
initial.focus({ preventScroll: true });
|
|
24
|
+
function alignFocus() {
|
|
25
|
+
const active = document.activeElement;
|
|
26
|
+
if (panel.isConnected && (active === previous || active === initial || active === panel || active === document.body))
|
|
27
|
+
preferred().focus({ preventScroll: true });
|
|
28
|
+
}
|
|
29
|
+
function onTransition(event) {
|
|
30
|
+
if (event.target === panel)
|
|
31
|
+
alignFocus();
|
|
32
|
+
}
|
|
33
|
+
panel.addEventListener('transitionend', onTransition);
|
|
34
|
+
const frame = typeof requestAnimationFrame === 'function' ? requestAnimationFrame(alignFocus) : undefined;
|
|
35
|
+
return () => {
|
|
36
|
+
panel.removeEventListener('transitionend', onTransition);
|
|
37
|
+
if (frame !== undefined)
|
|
38
|
+
cancelAnimationFrame(frame);
|
|
39
|
+
if (previous?.isConnected && !previous.matches(':disabled'))
|
|
40
|
+
previous.focus();
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* 原生 Tab 顺序只在边缘循环;嵌套弹层已处理的键盘事件不再拦截。
|
|
45
|
+
* @example 模块内部上下文
|
|
46
|
+
* ```ts
|
|
47
|
+
* function example(event: KeyboardEvent, panel: HTMLElement) {
|
|
48
|
+
* handleDialogKeydown(event, panel, () => {})
|
|
49
|
+
* }
|
|
50
|
+
* ```
|
|
51
|
+
*/
|
|
52
|
+
export function handleDialogKeydown(event, panel, close) {
|
|
53
|
+
if (event.defaultPrevented)
|
|
54
|
+
return;
|
|
55
|
+
if (event.key === 'Escape' && close) {
|
|
56
|
+
event.preventDefault();
|
|
57
|
+
event.stopPropagation();
|
|
58
|
+
close();
|
|
59
|
+
}
|
|
60
|
+
else if (event.key === 'Tab') {
|
|
61
|
+
const elements = focusable(panel);
|
|
62
|
+
const first = elements[0];
|
|
63
|
+
const last = elements.at(-1);
|
|
64
|
+
if (!first) {
|
|
65
|
+
event.preventDefault();
|
|
66
|
+
panel.focus();
|
|
67
|
+
}
|
|
68
|
+
else if (event.shiftKey && (document.activeElement === first || document.activeElement === panel)) {
|
|
69
|
+
event.preventDefault();
|
|
70
|
+
last?.focus();
|
|
71
|
+
}
|
|
72
|
+
else if (!event.shiftKey && document.activeElement === last) {
|
|
73
|
+
event.preventDefault();
|
|
74
|
+
first.focus();
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
}
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
/** 表单布局和字段提示的内部上下文,不要求应用转发控件属性。 */
|
|
2
|
+
import type { FormLayoutOptions } from '../types.js';
|
|
3
|
+
/**
|
|
4
|
+
* 表单布局的私有 Svelte Context 键;应用通过 FormLayout 使用。
|
|
5
|
+
*
|
|
6
|
+
* @example 模块内部上下文
|
|
7
|
+
* ```ts
|
|
8
|
+
* const context = getContext<FormLayoutOptions | undefined>(FORM_LAYOUT_CONTEXT)
|
|
9
|
+
* const columns = context?.columns
|
|
10
|
+
* ```
|
|
11
|
+
*/
|
|
12
|
+
export declare const FORM_LAYOUT_CONTEXT: unique symbol;
|
|
13
|
+
/**
|
|
14
|
+
* 字段标签、错误与主控件关联的私有 Context 键。
|
|
15
|
+
*
|
|
16
|
+
* @example 模块内部上下文
|
|
17
|
+
* ```ts
|
|
18
|
+
* const field = getContext<FormFieldContext | undefined>(FORM_FIELD_CONTEXT)
|
|
19
|
+
* const controlId = field?.controlId
|
|
20
|
+
* ```
|
|
21
|
+
*/
|
|
22
|
+
export declare const FORM_FIELD_CONTEXT: unique symbol;
|
|
23
|
+
/**
|
|
24
|
+
* Modal/Drawer 向内部表单同步可见性的私有 Context 键。
|
|
25
|
+
*
|
|
26
|
+
* @example 模块内部上下文
|
|
27
|
+
* ```ts
|
|
28
|
+
* const visibility = getContext<FormVisibilityContext | undefined>(FORM_VISIBILITY_CONTEXT)
|
|
29
|
+
* const open = visibility?.open
|
|
30
|
+
* ```
|
|
31
|
+
*/
|
|
32
|
+
export declare const FORM_VISIBILITY_CONTEXT: unique symbol;
|
|
33
|
+
/**
|
|
34
|
+
* 表单宿主的响应式可见状态,用于关闭时重置触碰校验。
|
|
35
|
+
*
|
|
36
|
+
* @example 模块内部上下文
|
|
37
|
+
* ```ts
|
|
38
|
+
* const example: FormVisibilityContext = { open: true }
|
|
39
|
+
* ```
|
|
40
|
+
*/
|
|
41
|
+
interface FormVisibilityContext {
|
|
42
|
+
readonly open: boolean;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* 组件初始化阶段读取可见性;没有宿主时返回 undefined。
|
|
46
|
+
* @returns 最近宿主的可见状态;无宿主时为 undefined。
|
|
47
|
+
*
|
|
48
|
+
* @example 模块内部上下文
|
|
49
|
+
* ```ts
|
|
50
|
+
* const visibility = getFormVisibilityContext()
|
|
51
|
+
* const open = visibility?.open ?? true
|
|
52
|
+
* ```
|
|
53
|
+
*/
|
|
54
|
+
export declare function getFormVisibilityContext(): FormVisibilityContext | undefined;
|
|
55
|
+
/**
|
|
56
|
+
* 标签、消息和主控件的关联状态,只在当前组件树中使用。
|
|
57
|
+
*
|
|
58
|
+
* @example 模块内部上下文
|
|
59
|
+
* ```ts
|
|
60
|
+
* const example: FormFieldContext = { controlId: 'email', labelId: 'email-label', messageId: 'email-error', error: '邮箱不能为空' }
|
|
61
|
+
* ```
|
|
62
|
+
*/
|
|
63
|
+
export interface FormFieldContext {
|
|
64
|
+
readonly label?: string;
|
|
65
|
+
readonly controlId: string;
|
|
66
|
+
readonly labelId: string;
|
|
67
|
+
readonly messageId: string | undefined;
|
|
68
|
+
readonly error: string;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* 组件初始化阶段读取祖先布局;没有祖先时使用控件默认布局。
|
|
72
|
+
* @returns 最近表单布局;无祖先时为 undefined。
|
|
73
|
+
*
|
|
74
|
+
* @example 模块内部上下文
|
|
75
|
+
* ```ts
|
|
76
|
+
* const layout = getFormLayoutContext()
|
|
77
|
+
* const columns = layout?.columns ?? 1
|
|
78
|
+
* ```
|
|
79
|
+
*/
|
|
80
|
+
export declare function getFormLayoutContext(): FormLayoutOptions | undefined;
|
|
81
|
+
/**
|
|
82
|
+
* 组件初始化阶段读取最近字段的无障碍关联和校验消息。
|
|
83
|
+
* @returns 最近字段的标签、控件和校验消息关联;无字段时为 undefined。
|
|
84
|
+
*
|
|
85
|
+
* @example 模块内部上下文
|
|
86
|
+
* ```ts
|
|
87
|
+
* const field = getFormFieldContext()
|
|
88
|
+
* const descriptionId = field?.messageId
|
|
89
|
+
* ```
|
|
90
|
+
*/
|
|
91
|
+
export declare function getFormFieldContext(): FormFieldContext | undefined;
|
|
92
|
+
export {};
|