@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
|
@@ -1,59 +1,83 @@
|
|
|
1
1
|
import type { Snippet } from 'svelte';
|
|
2
|
-
import type {
|
|
3
|
-
type
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
2
|
+
import type { DataAttributes } from '../../../types.js';
|
|
3
|
+
import type { CrudFieldDef } from './crud-controller.svelte.js';
|
|
4
|
+
import type { CrudDensity, CrudFormConfig, CrudPaginationConfig } from './crud-types.js';
|
|
5
|
+
import type { NavAdapter } from './nav-adapter.js';
|
|
6
|
+
/**
|
|
7
|
+
* 详情/列表对字段定义的局部视图,不是独立的公开资源模型。
|
|
8
|
+
*
|
|
9
|
+
* @example 模块内部上下文
|
|
10
|
+
* ```ts
|
|
11
|
+
* const example: FieldDef = { id: 'email', label: '邮箱', type: 'email', inDetail: true }
|
|
12
|
+
* ```
|
|
13
|
+
*/
|
|
14
|
+
type FieldDef = CrudFieldDef;
|
|
15
|
+
/**
|
|
16
|
+
* CrudPage 使用的异步资源操作集合。
|
|
17
|
+
*
|
|
18
|
+
* @example 模块内部上下文
|
|
19
|
+
* ```ts
|
|
20
|
+
* const api: CrudApi = { list: async () => ({ items: [{ id: 'u1' }], total: 1, page: 1, pageSize: 20 }) }
|
|
21
|
+
* const page = await api.list({ page: 1 })
|
|
22
|
+
* ```
|
|
23
|
+
*/
|
|
24
|
+
type CrudApi = {
|
|
25
|
+
/** 获取当前分页、筛选和排序结果。 */
|
|
26
|
+
list(params: Record<string, unknown>): Promise<{
|
|
27
|
+
items: Record<string, unknown>[];
|
|
28
|
+
total: number;
|
|
29
|
+
page: number;
|
|
30
|
+
pageSize: number;
|
|
31
|
+
}>;
|
|
32
|
+
/** 按主键获取一条记录。 */
|
|
33
|
+
get?(id: string): Promise<Record<string, unknown> | null>;
|
|
34
|
+
/** 创建一条记录。 */
|
|
35
|
+
create?(data: Record<string, unknown>): Promise<Record<string, unknown>>;
|
|
36
|
+
/** 更新一条记录。 */
|
|
37
|
+
update?(id: string, data: Record<string, unknown>): Promise<Record<string, unknown>>;
|
|
38
|
+
/** 删除一条记录。 */
|
|
39
|
+
remove?(id: string): Promise<void>;
|
|
33
40
|
};
|
|
34
|
-
|
|
41
|
+
/**
|
|
42
|
+
* 声明式 CRUD 资源及字段转换能力。
|
|
43
|
+
*
|
|
44
|
+
* @example 模块内部上下文
|
|
45
|
+
* ```ts
|
|
46
|
+
* const definition: CrudDef = crud
|
|
47
|
+
* const fields = definition.getListFields()
|
|
48
|
+
* ```
|
|
49
|
+
*/
|
|
35
50
|
type CrudDef = {
|
|
51
|
+
/** 资源元信息与后端 API。 */
|
|
36
52
|
resource: {
|
|
53
|
+
/** 资源名称,用于识别当前业务实体。 */
|
|
37
54
|
name: string;
|
|
55
|
+
/** 资源标题文案。 */
|
|
38
56
|
label: string | (() => string);
|
|
57
|
+
/** 记录主键字段,默认使用 id。 */
|
|
39
58
|
keyField?: string;
|
|
59
|
+
/** 资源字段定义。 */
|
|
40
60
|
fields: FieldDef[];
|
|
61
|
+
/** 默认分页条数。 */
|
|
41
62
|
defaultPageSize?: number;
|
|
63
|
+
/** 是否显示搜索框。 */
|
|
42
64
|
searchable?: boolean;
|
|
65
|
+
/** 搜索框占位文案。 */
|
|
43
66
|
searchPlaceholder?: string | (() => string);
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
get?: AnyApiFunc;
|
|
47
|
-
create?: AnyApiFunc;
|
|
48
|
-
update?: AnyApiFunc;
|
|
49
|
-
remove?: AnyApiFunc;
|
|
50
|
-
};
|
|
67
|
+
/** 资源 CRUD API。 */
|
|
68
|
+
api: CrudApi;
|
|
51
69
|
};
|
|
70
|
+
/** 获取列表字段。 */
|
|
52
71
|
getListFields: () => FieldDef[];
|
|
72
|
+
/** 获取筛选字段。 */
|
|
53
73
|
getFilterFields: () => FieldDef[];
|
|
74
|
+
/** 获取新建字段。 */
|
|
54
75
|
getCreateFields: () => FieldDef[];
|
|
76
|
+
/** 获取编辑字段。 */
|
|
55
77
|
getEditFields: () => FieldDef[];
|
|
78
|
+
/** 获取详情字段。 */
|
|
56
79
|
getDetailFields: () => FieldDef[];
|
|
80
|
+
/** 转换为 DataTable 列定义。 */
|
|
57
81
|
toTableColumns: () => Array<{
|
|
58
82
|
key: string;
|
|
59
83
|
label: string;
|
|
@@ -61,17 +85,15 @@ type CrudDef = {
|
|
|
61
85
|
align?: string;
|
|
62
86
|
render?: (item: Record<string, unknown>) => string;
|
|
63
87
|
}>;
|
|
88
|
+
/** 生成新建表单默认值。 */
|
|
64
89
|
getDefaultValues: () => Record<string, unknown>;
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
get?: AnyApiFunc;
|
|
68
|
-
create?: AnyApiFunc;
|
|
69
|
-
update?: AnyApiFunc;
|
|
70
|
-
remove?: AnyApiFunc;
|
|
71
|
-
};
|
|
90
|
+
/** API 操作代理。 */
|
|
91
|
+
api: CrudApi;
|
|
72
92
|
};
|
|
73
93
|
type $$ComponentProps = {
|
|
94
|
+
/** CRUD 资源定义及其 API 操作。 */
|
|
74
95
|
crud: CrudDef;
|
|
96
|
+
/** 当前页数据与服务端分页元数据。 */
|
|
75
97
|
data: {
|
|
76
98
|
items: Record<string, unknown>[];
|
|
77
99
|
total: number;
|
|
@@ -79,35 +101,99 @@ type $$ComponentProps = {
|
|
|
79
101
|
pageSize: number;
|
|
80
102
|
filters?: Record<string, unknown>;
|
|
81
103
|
};
|
|
104
|
+
/** 新建、编辑、删除权限;未设置的权限默认跟随 API 是否存在。 */
|
|
82
105
|
permissions?: {
|
|
83
106
|
create?: boolean;
|
|
84
107
|
update?: boolean;
|
|
85
108
|
delete?: boolean;
|
|
86
109
|
};
|
|
87
|
-
|
|
110
|
+
/** 新建/编辑面板展示配置。 */
|
|
111
|
+
form?: CrudFormConfig;
|
|
112
|
+
/** 分页栏展示配置。 */
|
|
113
|
+
pagination?: CrudPaginationConfig;
|
|
114
|
+
/** 列表密度,影响行高、操作按钮和面板控件尺寸。 */
|
|
115
|
+
density?: CrudDensity;
|
|
116
|
+
/** 点击详情图标是否打开详情面板。 */
|
|
88
117
|
rowClickDetail?: boolean;
|
|
118
|
+
/** 点击后打开详情的列 key。 */
|
|
119
|
+
detailColumns?: string[];
|
|
120
|
+
/** 工作区导航已有标题时默认隐藏;可显式开启,独立使用时默认显示。 */
|
|
121
|
+
showHeader?: boolean;
|
|
122
|
+
/** 每行额外操作按钮插槽。 */
|
|
89
123
|
listItemActions?: Snippet<[Record<string, unknown>]>;
|
|
124
|
+
/** 自定义表格单元格;参数依次为行记录和列 key。 */
|
|
125
|
+
tableCell?: Snippet<[Record<string, unknown>, string]>;
|
|
126
|
+
/** 点击表格行时的回调。 */
|
|
127
|
+
onrowclick?: (item: Record<string, unknown>) => void;
|
|
128
|
+
/** 编辑表单额外字段插槽。 */
|
|
90
129
|
editFormExtra?: Snippet<[Record<string, unknown> | null, 'create' | 'edit']>;
|
|
130
|
+
/** 详情面板额外内容插槽。 */
|
|
91
131
|
detailExtra?: Snippet<[Record<string, unknown>]>;
|
|
132
|
+
/** 页面标题右侧额外操作插槽。 */
|
|
92
133
|
headerActions?: Snippet;
|
|
134
|
+
/** 查询栏上方左侧内容插槽,可用于放置页面标题或说明。 */
|
|
135
|
+
toolbarLeading?: Snippet;
|
|
136
|
+
/** 页面右侧自定义操作插槽。 */
|
|
137
|
+
toolbarActions?: Snippet;
|
|
138
|
+
/** 卡片列表项渲染插槽;存在时替代 DataTable,仍复用工具栏、分页和独立滚动容器。 */
|
|
139
|
+
card?: Snippet<[Record<string, unknown>]>;
|
|
140
|
+
/** 后端支持的可排序列;为空时不显示排序按钮。 */
|
|
141
|
+
sortableColumns?: Array<{
|
|
142
|
+
key: string;
|
|
143
|
+
label: string;
|
|
144
|
+
}>;
|
|
145
|
+
/** 删除前钩子,返回 false 时取消删除。 */
|
|
93
146
|
onbeforedelete?: (item: Record<string, unknown>) => Promise<boolean> | boolean;
|
|
147
|
+
/** 新建或编辑成功后的回调。 */
|
|
94
148
|
onaftersubmit?: (item: Record<string, unknown>, mode: 'create' | 'edit') => void;
|
|
149
|
+
/** 删除成功后的回调。 */
|
|
95
150
|
onafterdelete?: (item: Record<string, unknown>) => void;
|
|
151
|
+
/** 自定义错误回调。 */
|
|
96
152
|
onerror?: (error: string) => void;
|
|
153
|
+
/** 列表路由基础路径。 */
|
|
97
154
|
basePath?: string;
|
|
155
|
+
/**
|
|
156
|
+
* 路由适配器:用于读取当前 pathname、同步过滤参数到 URL、列表刷新。
|
|
157
|
+
* 默认使用 `createBrowserNavAdapter()`(基于 `globalThis.location`)。
|
|
158
|
+
* SvelteKit 应用应传入 `createSvelteKitNavAdapter()`(来自 `@h-ai/kit/client`),
|
|
159
|
+
* 以获得客户端跳转 + invalidateAll 体验。
|
|
160
|
+
*/
|
|
161
|
+
nav?: NavAdapter;
|
|
162
|
+
/** 列表是否正在加载;由外部控制器(`createCrudController`)提供,用于展示查询中占位。 */
|
|
163
|
+
loading?: boolean;
|
|
164
|
+
/**
|
|
165
|
+
* 是否至少成功加载过一次。仅当 `loaded && total === 0` 时展示空状态,
|
|
166
|
+
* 避免首次请求未回时误显示“暂无数据”。默认 true 以兼容 SvelteKit SSR(数据随页面就绪)。
|
|
167
|
+
*/
|
|
168
|
+
loaded?: boolean;
|
|
169
|
+
/** 最新一轮加载错误;无可用数据时展示错误信息与重试按钮。 */
|
|
170
|
+
error?: Error | string;
|
|
171
|
+
/** 点击“重试”回调;通常传入控制器的 `reload`。 */
|
|
172
|
+
onRetry?: () => void;
|
|
173
|
+
/** 失败或刷新时是否保留旧数据(默认 true);为 false 时加载中展示查询中占位而非旧列表。 */
|
|
174
|
+
keepPreviousData?: boolean;
|
|
175
|
+
/** 根节点自定义 class。 */
|
|
98
176
|
class?: string;
|
|
99
|
-
};
|
|
177
|
+
} & DataAttributes;
|
|
100
178
|
/**
|
|
101
179
|
* CrudPage
|
|
102
180
|
* 通用 CRUD 页面组件
|
|
103
181
|
*
|
|
104
|
-
* 基于声明式资源定义,自动生成列表 + 搜索过滤 + 分页 +
|
|
182
|
+
* 基于声明式资源定义,自动生成列表 + 搜索过滤 + 分页 + 详情查看 + 编辑/新建面板 + 删除确认。
|
|
105
183
|
*
|
|
106
184
|
* 使用 Svelte 5 Runes ($props, $state, $derived, $effect)
|
|
107
|
-
* 使用 compounds 组件:Card, DataTable, PageHeader, Pagination, Drawer
|
|
185
|
+
* 使用 compounds 组件:Card, DataTable, PageHeader, Pagination, Drawer, Modal
|
|
108
186
|
*
|
|
109
187
|
* @example
|
|
110
|
-
*
|
|
188
|
+
* ```svelte
|
|
189
|
+
* <script lang="ts">
|
|
190
|
+
* import { CrudPage, defineCrud } from '@h-ai/ui'
|
|
191
|
+
* import type { CrudPageProps } from '@h-ai/ui'
|
|
192
|
+
* const crud = defineCrud({ name: 'users', label: '用户', fields: [{ id: 'email', label: '邮箱', type: 'email', validation: { required: true } }], api: { list: async () => ({ items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }) } })
|
|
193
|
+
* const props: CrudPageProps = { crud, data: { items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }, permissions: { create: true, update: true, delete: false } }
|
|
194
|
+
* </script>
|
|
195
|
+
* <CrudPage {...props} />
|
|
196
|
+
* ```
|
|
111
197
|
*/
|
|
112
198
|
declare const CrudPage: import("svelte").Component<$$ComponentProps, {}, "">;
|
|
113
199
|
type CrudPage = ReturnType<typeof CrudPage>;
|
|
@@ -0,0 +1,335 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @h-ai/ui — CRUD 控制器(SPA 数据 + 导航托管)
|
|
3
|
+
*
|
|
4
|
+
* 为 `CrudPage` 提供两个框架级适配器,业务应用无需在各自项目里重复实现:
|
|
5
|
+
* 1. `defineCrud`:由声明式资源定义生成 `CrudPage` 所需的 `crud` 对象(字段筛选、列映射、默认值),
|
|
6
|
+
* 不依赖 `@h-ai/kit`,纯 SPA / Tauri / Capacitor 均可直接使用。
|
|
7
|
+
* 2. `createCrudController`:在纯客户端(无 SvelteKit SSR)下托管 `CrudPage` 的 `data` 与 `nav`,
|
|
8
|
+
* 把 `CrudPage` 通过 URL query 同步的搜索/过滤/分页参数解析回本地状态并重新拉取列表。
|
|
9
|
+
*
|
|
10
|
+
* 控制器特性:latest-wins(seq + AbortSignal 双保险)、失败保留旧数据、惰性加载、并发去重、
|
|
11
|
+
* 查询串回填地址栏(保留 pathname 与 hash,不整页跳转)。
|
|
12
|
+
*
|
|
13
|
+
* @module crud-controller
|
|
14
|
+
*/
|
|
15
|
+
import type { PaginatedResult } from '@h-ai/core';
|
|
16
|
+
import type { FormColSpan } from '../../../types.js';
|
|
17
|
+
import type { NavAdapter } from './nav-adapter.js';
|
|
18
|
+
/**
|
|
19
|
+
* 字段展示形式;与 `CrudEditPanel` / `CrudFilterBar` 支持的类型对齐,保留 `string` 以兼容 `@h-ai/kit`。
|
|
20
|
+
*
|
|
21
|
+
* @example
|
|
22
|
+
* ```ts
|
|
23
|
+
* import type { CrudFieldType } from '@h-ai/ui'
|
|
24
|
+
* const example: CrudFieldType = 'email'
|
|
25
|
+
* ```
|
|
26
|
+
*/
|
|
27
|
+
export type CrudFieldType = 'text' | 'string' | 'textarea' | 'select' | 'radio' | 'multi-select' | 'boolean' | 'checkbox' | 'email' | 'url' | 'tel' | 'password' | 'number' | 'date' | 'datetime' | 'date-range' | 'custom';
|
|
28
|
+
/**
|
|
29
|
+
* 可解析为字符串的文本值(支持 i18n 函数)。
|
|
30
|
+
*
|
|
31
|
+
* @example
|
|
32
|
+
* ```ts
|
|
33
|
+
* import type { CrudText } from '@h-ai/ui'
|
|
34
|
+
* const example: CrudText = () => '邮箱'
|
|
35
|
+
* ```
|
|
36
|
+
*/
|
|
37
|
+
export type CrudText = string | (() => string);
|
|
38
|
+
/**
|
|
39
|
+
* 选项项(select / radio / multi-select)。
|
|
40
|
+
*
|
|
41
|
+
* @example
|
|
42
|
+
* ```ts
|
|
43
|
+
* import type { CrudOption } from '@h-ai/ui'
|
|
44
|
+
* const example: CrudOption = { label: '启用', value: true }
|
|
45
|
+
* ```
|
|
46
|
+
*/
|
|
47
|
+
export interface CrudOption {
|
|
48
|
+
label: string;
|
|
49
|
+
value: string | number | boolean;
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* 字段定义(与 `CrudPage` 的字段模型对齐)。
|
|
53
|
+
*
|
|
54
|
+
* @example
|
|
55
|
+
* ```ts
|
|
56
|
+
* import type { CrudFieldDef } from '@h-ai/ui'
|
|
57
|
+
* const example: CrudFieldDef = { id: 'email', label: '邮箱', type: 'email', inList: true, validation: { required: true } }
|
|
58
|
+
* ```
|
|
59
|
+
*/
|
|
60
|
+
export interface CrudFieldDef {
|
|
61
|
+
/** 字段 id(对应数据对象的属性名)。 */
|
|
62
|
+
id: string;
|
|
63
|
+
/** 字段标签(支持 i18n 函数)。 */
|
|
64
|
+
label: CrudText;
|
|
65
|
+
/** 字段类型。 */
|
|
66
|
+
type: CrudFieldType;
|
|
67
|
+
/** 是否在列表展示(默认 true)。 */
|
|
68
|
+
inList?: boolean;
|
|
69
|
+
/** 是否可过滤(默认 false)。 */
|
|
70
|
+
filterable?: boolean;
|
|
71
|
+
/** 是否只读(编辑态禁用)。 */
|
|
72
|
+
readonly?: boolean;
|
|
73
|
+
/** 是否在新建表单出现(默认 true)。 */
|
|
74
|
+
inCreate?: boolean;
|
|
75
|
+
/** 是否在编辑表单出现(默认 true)。 */
|
|
76
|
+
inEdit?: boolean;
|
|
77
|
+
/** 是否在详情出现(默认 true)。 */
|
|
78
|
+
inDetail?: boolean;
|
|
79
|
+
/** 选项(select / radio / multi-select),支持工厂函数。 */
|
|
80
|
+
options?: CrudOption[] | (() => CrudOption[]);
|
|
81
|
+
/** 校验规则。 */
|
|
82
|
+
validation?: {
|
|
83
|
+
required?: boolean;
|
|
84
|
+
min?: number;
|
|
85
|
+
max?: number;
|
|
86
|
+
pattern?: string;
|
|
87
|
+
message?: CrudText;
|
|
88
|
+
};
|
|
89
|
+
/** 表单占用列数,默认 auto;多行文本、多选等自动占两列。 */
|
|
90
|
+
colSpan?: FormColSpan;
|
|
91
|
+
/** 列宽(CSS)。 */
|
|
92
|
+
width?: string;
|
|
93
|
+
/** 列对齐。 */
|
|
94
|
+
align?: 'left' | 'center' | 'right';
|
|
95
|
+
/** 列表单元格自定义渲染。 */
|
|
96
|
+
render?: (value: unknown, item: Record<string, unknown>) => string;
|
|
97
|
+
/** 占位文本。 */
|
|
98
|
+
placeholder?: CrudText;
|
|
99
|
+
/** 日期范围起始值 key(仅 date-range,默认 `${id}Start`)。 */
|
|
100
|
+
startKey?: string;
|
|
101
|
+
/** 日期范围结束值 key(仅 date-range,默认 `${id}End`)。 */
|
|
102
|
+
endKey?: string;
|
|
103
|
+
/** 默认值(新建时)。 */
|
|
104
|
+
defaultValue?: unknown;
|
|
105
|
+
/** 排序权重(升序)。 */
|
|
106
|
+
order?: number;
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
* 列表请求附加项;用于 latest-wins 取消旧请求。
|
|
110
|
+
*
|
|
111
|
+
* @example
|
|
112
|
+
* ```ts
|
|
113
|
+
* import type { CrudListOptions } from '@h-ai/ui'
|
|
114
|
+
* const example: CrudListOptions = { signal: new AbortController().signal }
|
|
115
|
+
* ```
|
|
116
|
+
*/
|
|
117
|
+
export interface CrudListOptions {
|
|
118
|
+
/** 取消信号;旧请求被新请求取代时触发 abort。 */
|
|
119
|
+
signal?: AbortSignal;
|
|
120
|
+
}
|
|
121
|
+
/**
|
|
122
|
+
* CRUD API 集合。列表返回标准 `PaginatedResult<T>`,避免各页面重复 page/pageSize/total 映射。
|
|
123
|
+
* @typeParam T - 字段值或资源条目的数据类型。
|
|
124
|
+
*
|
|
125
|
+
* @example
|
|
126
|
+
* ```ts
|
|
127
|
+
* import type { CrudApi } from '@h-ai/ui'
|
|
128
|
+
* const example: CrudApi<Record<string, unknown>> = { list: async () => ({ items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }) }
|
|
129
|
+
* ```
|
|
130
|
+
*/
|
|
131
|
+
export interface CrudApi<T> {
|
|
132
|
+
/** 分页列表;第二参数携带取消信号,实现方可透传给 fetch。 */
|
|
133
|
+
list: (params: Record<string, unknown>, options?: CrudListOptions) => Promise<PaginatedResult<T>>;
|
|
134
|
+
/** 按主键获取单条。 */
|
|
135
|
+
get?: (id: string) => Promise<T | null>;
|
|
136
|
+
/** 创建一条记录。 */
|
|
137
|
+
create?: (data: Partial<T>) => Promise<T>;
|
|
138
|
+
/** 更新一条记录。 */
|
|
139
|
+
update?: (id: string, data: Partial<T>) => Promise<T>;
|
|
140
|
+
/** 删除一条记录。 */
|
|
141
|
+
remove?: (id: string) => Promise<void>;
|
|
142
|
+
}
|
|
143
|
+
/**
|
|
144
|
+
* 资源定义。
|
|
145
|
+
* @typeParam T - 字段值或资源条目的数据类型。
|
|
146
|
+
*
|
|
147
|
+
* @example
|
|
148
|
+
* ```ts
|
|
149
|
+
* import type { CrudResource } from '@h-ai/ui'
|
|
150
|
+
* const example: CrudResource<Record<string, unknown>> = { name: 'users', label: '用户', fields: [{ id: 'email', label: '邮箱', type: 'email', validation: { required: true } }], api: { list: async () => ({ items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }) } }
|
|
151
|
+
* ```
|
|
152
|
+
*/
|
|
153
|
+
export interface CrudResource<T> {
|
|
154
|
+
/** 资源名称(用于识别业务实体)。 */
|
|
155
|
+
name: string;
|
|
156
|
+
/** 资源标题(支持 i18n 函数)。 */
|
|
157
|
+
label: CrudText;
|
|
158
|
+
/** 主键字段(默认 `id`)。 */
|
|
159
|
+
keyField?: string;
|
|
160
|
+
/** 字段定义列表。 */
|
|
161
|
+
fields: CrudFieldDef[];
|
|
162
|
+
/** 默认分页条数(默认 10)。 */
|
|
163
|
+
defaultPageSize?: number;
|
|
164
|
+
/** 是否显示搜索框(默认 true)。 */
|
|
165
|
+
searchable?: boolean;
|
|
166
|
+
/** 搜索框占位文案。 */
|
|
167
|
+
searchPlaceholder?: CrudText;
|
|
168
|
+
/** 资源 CRUD API。 */
|
|
169
|
+
api: CrudApi<T>;
|
|
170
|
+
}
|
|
171
|
+
/**
|
|
172
|
+
* DataTable 列定义(适配 `CrudPage`)。
|
|
173
|
+
*
|
|
174
|
+
* @example
|
|
175
|
+
* ```ts
|
|
176
|
+
* import type { CrudTableColumn } from '@h-ai/ui'
|
|
177
|
+
* const example: CrudTableColumn = { key: 'email', label: '邮箱', width: '16rem' }
|
|
178
|
+
* ```
|
|
179
|
+
*/
|
|
180
|
+
export interface CrudTableColumn {
|
|
181
|
+
key: string;
|
|
182
|
+
label: string;
|
|
183
|
+
width?: string;
|
|
184
|
+
align?: 'left' | 'center' | 'right';
|
|
185
|
+
render?: (item: Record<string, unknown>) => string;
|
|
186
|
+
}
|
|
187
|
+
/**
|
|
188
|
+
* `CrudPage` 所需的 crud 对象形状(`defineCrud` 的返回值)。
|
|
189
|
+
* @typeParam T - 字段值或资源条目的数据类型。
|
|
190
|
+
*
|
|
191
|
+
* @example
|
|
192
|
+
* ```ts
|
|
193
|
+
* import { defineCrud } from '@h-ai/ui'
|
|
194
|
+
* import type { CrudDef } from '@h-ai/ui'
|
|
195
|
+
* const definition: CrudDef<Record<string, unknown>> = defineCrud({ name: 'users', label: '用户', fields: [{ id: 'email', label: '邮箱', type: 'email', validation: { required: true } }], api: { list: async () => ({ items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }) } })
|
|
196
|
+
* const columns = definition.toTableColumns()
|
|
197
|
+
* ```
|
|
198
|
+
*/
|
|
199
|
+
export interface CrudDef<T> {
|
|
200
|
+
resource: CrudResource<T>;
|
|
201
|
+
getListFields: () => CrudFieldDef[];
|
|
202
|
+
getFilterFields: () => CrudFieldDef[];
|
|
203
|
+
getCreateFields: () => CrudFieldDef[];
|
|
204
|
+
getEditFields: () => CrudFieldDef[];
|
|
205
|
+
getDetailFields: () => CrudFieldDef[];
|
|
206
|
+
toTableColumns: () => CrudTableColumn[];
|
|
207
|
+
getDefaultValues: () => Record<string, unknown>;
|
|
208
|
+
api: CrudApi<T>;
|
|
209
|
+
}
|
|
210
|
+
/**
|
|
211
|
+
* `CrudPage` 的 `data` 形状。
|
|
212
|
+
* @typeParam T - 字段值或资源条目的数据类型。
|
|
213
|
+
*
|
|
214
|
+
* @example
|
|
215
|
+
* ```ts
|
|
216
|
+
* import type { CrudData } from '@h-ai/ui'
|
|
217
|
+
* const example: CrudData<Record<string, unknown>> = { items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20, filters: { active: true } }
|
|
218
|
+
* ```
|
|
219
|
+
*/
|
|
220
|
+
export interface CrudData<T> {
|
|
221
|
+
items: T[];
|
|
222
|
+
total: number;
|
|
223
|
+
page: number;
|
|
224
|
+
pageSize: number;
|
|
225
|
+
filters: Record<string, unknown>;
|
|
226
|
+
}
|
|
227
|
+
/**
|
|
228
|
+
* CRUD 控制器:托管列表数据与 SPA 导航适配器。
|
|
229
|
+
* @typeParam T - 字段值或资源条目的数据类型。
|
|
230
|
+
*
|
|
231
|
+
* @example
|
|
232
|
+
* ```ts
|
|
233
|
+
* import { defineCrud, createCrudController } from '@h-ai/ui'
|
|
234
|
+
* import type { CrudController } from '@h-ai/ui'
|
|
235
|
+
* const crud = defineCrud({ name: 'users', label: '用户', fields: [{ id: 'email', label: '邮箱', type: 'email', validation: { required: true } }], api: { list: async () => ({ items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }) } })
|
|
236
|
+
* const controller: CrudController<Record<string, unknown>> = createCrudController(crud, { autoLoad: false, syncUrl: false })
|
|
237
|
+
* await controller.load()
|
|
238
|
+
* if (controller.error) throw controller.error
|
|
239
|
+
* const users = controller.data.items
|
|
240
|
+
* ```
|
|
241
|
+
*/
|
|
242
|
+
export interface CrudController<T> {
|
|
243
|
+
/** 传给 `<CrudPage data={...}>` 的响应式数据对象。 */
|
|
244
|
+
readonly data: CrudData<T>;
|
|
245
|
+
/** 传给 `<CrudPage nav={...}>` 的导航适配器(仅同步 query,不整页跳转)。 */
|
|
246
|
+
readonly nav: NavAdapter;
|
|
247
|
+
/** 首次或按需拉取当前参数;惰性页签用它在首次激活时启动查询。 */
|
|
248
|
+
load: () => Promise<void>;
|
|
249
|
+
/** 主动按当前参数重新拉取(写操作后或重试触发)。 */
|
|
250
|
+
reload: () => Promise<void>;
|
|
251
|
+
/** 当前是否有最新一轮列表请求尚未结束。 */
|
|
252
|
+
readonly loading: boolean;
|
|
253
|
+
/** 是否至少成功取得过一次列表响应。 */
|
|
254
|
+
readonly loaded: boolean;
|
|
255
|
+
/** 最新一轮请求错误;已有成功数据时仍保留原列表。 */
|
|
256
|
+
readonly error: Error | undefined;
|
|
257
|
+
}
|
|
258
|
+
/**
|
|
259
|
+
* CRUD 控制器创建选项。
|
|
260
|
+
*
|
|
261
|
+
* @example
|
|
262
|
+
* ```ts
|
|
263
|
+
* import type { CrudControllerOptions } from '@h-ai/ui'
|
|
264
|
+
* const example: CrudControllerOptions = { autoLoad: false, keepPreviousData: true, syncUrl: true }
|
|
265
|
+
* ```
|
|
266
|
+
*/
|
|
267
|
+
export interface CrudControllerOptions {
|
|
268
|
+
/** 是否在创建后立即加载;不可见 / 惰性页签应设为 false(默认 true)。 */
|
|
269
|
+
autoLoad?: boolean;
|
|
270
|
+
/** 请求失败或重新拉取时是否保留已有数据(默认 true,避免闪现空列表)。 */
|
|
271
|
+
keepPreviousData?: boolean;
|
|
272
|
+
/** 是否把查询串回填浏览器地址栏(保留 pathname 与 hash,默认 true)。 */
|
|
273
|
+
syncUrl?: boolean;
|
|
274
|
+
}
|
|
275
|
+
/**
|
|
276
|
+
* 映射分页结果的 `items`,保留 total / page / pageSize。
|
|
277
|
+
*
|
|
278
|
+
* @description 标准 `PaginatedResult<T>` 适配器:业务页面只需转换条目本身,
|
|
279
|
+
* 无需重复搬运分页元数据,配合 `CrudApi.list` 消除 page/pageSize/total 样板。
|
|
280
|
+
*
|
|
281
|
+
* @param result - 后端返回的分页结果。
|
|
282
|
+
* @param map - 单条映射函数。
|
|
283
|
+
* @returns 条目被映射、分页元数据不变的新分页结果。
|
|
284
|
+
* @typeParam T - 字段值或资源条目的数据类型。
|
|
285
|
+
* @typeParam R - 转换结果的数据类型。
|
|
286
|
+
*
|
|
287
|
+
* @example
|
|
288
|
+
* ```ts
|
|
289
|
+
* import { mapPaginated } from '@h-ai/ui'
|
|
290
|
+
* const page = mapPaginated({ items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }, user => ({ ...user, label: user.email }))
|
|
291
|
+
* const email = page.items[0]?.label
|
|
292
|
+
* ```
|
|
293
|
+
*/
|
|
294
|
+
export declare function mapPaginated<T, R>(result: PaginatedResult<T>, map: (item: T, index: number) => R): PaginatedResult<R>;
|
|
295
|
+
/**
|
|
296
|
+
* 由声明式资源定义生成 `CrudPage` 所需的 `crud` 对象。
|
|
297
|
+
*
|
|
298
|
+
* @description 仅做字段筛选、列映射与默认值收集,不依赖 `@h-ai/kit`,可在纯 SPA 直接使用。
|
|
299
|
+
*
|
|
300
|
+
* @param resource - 资源定义(字段、标签、API)。
|
|
301
|
+
* @returns `CrudPage` 可直接消费的 `crud` 对象。
|
|
302
|
+
* @typeParam T - 字段值或资源条目的数据类型。
|
|
303
|
+
*
|
|
304
|
+
* @example
|
|
305
|
+
* ```ts
|
|
306
|
+
* import { defineCrud } from '@h-ai/ui'
|
|
307
|
+
* const crud = defineCrud({ name: 'users', label: '用户', fields: [{ id: 'email', label: '邮箱', type: 'email', validation: { required: true } }], api: { list: async () => ({ items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }) } })
|
|
308
|
+
* const columns = crud.toTableColumns()
|
|
309
|
+
* ```
|
|
310
|
+
*/
|
|
311
|
+
export declare function defineCrud<T extends Record<string, unknown>>(resource: CrudResource<T>): CrudDef<T>;
|
|
312
|
+
/**
|
|
313
|
+
* 在纯客户端(无 SvelteKit SSR)下为 `CrudPage` 创建数据 + 导航控制器。
|
|
314
|
+
*
|
|
315
|
+
* @description `CrudPage` 通过 `nav.navigate(url)` 把搜索/过滤/分页写进 URL query,再调用 `nav.refresh()`
|
|
316
|
+
* 触发列表刷新。本控制器把 query 解析回参数、调用 `crud.api.list` 更新本地 `data`,并把查询串回填地址栏,
|
|
317
|
+
* 不触发整页跳转(避免刷新与登录态丢失)。连续请求只允许最新一轮更新状态(seq + AbortSignal 双保险),
|
|
318
|
+
* 失败时保留已有数据并暴露错误供页面重试。
|
|
319
|
+
*
|
|
320
|
+
* @param crud - `defineCrud` 的返回值。
|
|
321
|
+
* @param options - 加载策略;默认立即加载、失败保留旧数据、回填地址栏。
|
|
322
|
+
* @returns 含响应式 `data`、`nav` 适配器与 `load` / `reload` 的控制器。
|
|
323
|
+
* @typeParam T - 字段值或资源条目的数据类型。
|
|
324
|
+
*
|
|
325
|
+
* @example
|
|
326
|
+
* ```ts
|
|
327
|
+
* import { defineCrud, createCrudController } from '@h-ai/ui'
|
|
328
|
+
* const crud = defineCrud({ name: 'users', label: '用户', fields: [{ id: 'email', label: '邮箱', type: 'email', validation: { required: true } }], api: { list: async () => ({ items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }) } })
|
|
329
|
+
* const controller = createCrudController(crud, { autoLoad: false, syncUrl: false })
|
|
330
|
+
* await controller.load()
|
|
331
|
+
* if (controller.error) throw controller.error
|
|
332
|
+
* const users = controller.data.items
|
|
333
|
+
* ```
|
|
334
|
+
*/
|
|
335
|
+
export declare function createCrudController<T extends Record<string, unknown>>(crud: CrudDef<T>, options?: CrudControllerOptions): CrudController<T>;
|