@h-ai/ui 0.1.0-alpha.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.
Files changed (237) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +500 -0
  3. package/auto-import.d.ts +96 -0
  4. package/auto-import.js +263 -0
  5. package/dist/components/compounds/Accordion.svelte +142 -0
  6. package/dist/components/compounds/Accordion.svelte.d.ts +25 -0
  7. package/dist/components/compounds/ActionSheet.svelte +116 -0
  8. package/dist/components/compounds/ActionSheet.svelte.d.ts +22 -0
  9. package/dist/components/compounds/Alert.svelte +67 -0
  10. package/dist/components/compounds/Alert.svelte.d.ts +8 -0
  11. package/dist/components/compounds/AppBar.svelte +77 -0
  12. package/dist/components/compounds/AppBar.svelte.d.ts +20 -0
  13. package/dist/components/compounds/BottomNav.svelte +75 -0
  14. package/dist/components/compounds/BottomNav.svelte.d.ts +18 -0
  15. package/dist/components/compounds/Breadcrumb.svelte +49 -0
  16. package/dist/components/compounds/Breadcrumb.svelte.d.ts +4 -0
  17. package/dist/components/compounds/Calendar.svelte +116 -0
  18. package/dist/components/compounds/Calendar.svelte.d.ts +47 -0
  19. package/dist/components/compounds/Card.svelte +77 -0
  20. package/dist/components/compounds/Card.svelte.d.ts +8 -0
  21. package/dist/components/compounds/Combobox.svelte +327 -0
  22. package/dist/components/compounds/Combobox.svelte.d.ts +69 -0
  23. package/dist/components/compounds/Confirm.svelte +90 -0
  24. package/dist/components/compounds/Confirm.svelte.d.ts +4 -0
  25. package/dist/components/compounds/DataTable.svelte +133 -0
  26. package/dist/components/compounds/DataTable.svelte.d.ts +69 -0
  27. package/dist/components/compounds/DatePicker.svelte +135 -0
  28. package/dist/components/compounds/DatePicker.svelte.d.ts +46 -0
  29. package/dist/components/compounds/Drawer.svelte +113 -0
  30. package/dist/components/compounds/Drawer.svelte.d.ts +4 -0
  31. package/dist/components/compounds/Dropdown.svelte +91 -0
  32. package/dist/components/compounds/Dropdown.svelte.d.ts +8 -0
  33. package/dist/components/compounds/Empty.svelte +83 -0
  34. package/dist/components/compounds/Empty.svelte.d.ts +4 -0
  35. package/dist/components/compounds/Form.svelte +96 -0
  36. package/dist/components/compounds/Form.svelte.d.ts +7 -0
  37. package/dist/components/compounds/FormField.svelte +56 -0
  38. package/dist/components/compounds/FormField.svelte.d.ts +4 -0
  39. package/dist/components/compounds/InfiniteScroll.svelte +82 -0
  40. package/dist/components/compounds/InfiniteScroll.svelte.d.ts +22 -0
  41. package/dist/components/compounds/Modal.svelte +123 -0
  42. package/dist/components/compounds/Modal.svelte.d.ts +8 -0
  43. package/dist/components/compounds/PageHeader.svelte +44 -0
  44. package/dist/components/compounds/PageHeader.svelte.d.ts +28 -0
  45. package/dist/components/compounds/Pagination.svelte +157 -0
  46. package/dist/components/compounds/Pagination.svelte.d.ts +4 -0
  47. package/dist/components/compounds/Popover.svelte +137 -0
  48. package/dist/components/compounds/Popover.svelte.d.ts +4 -0
  49. package/dist/components/compounds/PullRefresh.svelte +98 -0
  50. package/dist/components/compounds/PullRefresh.svelte.d.ts +16 -0
  51. package/dist/components/compounds/Result.svelte +84 -0
  52. package/dist/components/compounds/Result.svelte.d.ts +4 -0
  53. package/dist/components/compounds/SafeArea.svelte +37 -0
  54. package/dist/components/compounds/SafeArea.svelte.d.ts +12 -0
  55. package/dist/components/compounds/Skeleton.svelte +75 -0
  56. package/dist/components/compounds/Skeleton.svelte.d.ts +8 -0
  57. package/dist/components/compounds/Steps.svelte +111 -0
  58. package/dist/components/compounds/Steps.svelte.d.ts +4 -0
  59. package/dist/components/compounds/SwipeCell.svelte +115 -0
  60. package/dist/components/compounds/SwipeCell.svelte.d.ts +19 -0
  61. package/dist/components/compounds/Tabs.svelte +79 -0
  62. package/dist/components/compounds/Tabs.svelte.d.ts +8 -0
  63. package/dist/components/compounds/TagInput.svelte +108 -0
  64. package/dist/components/compounds/TagInput.svelte.d.ts +4 -0
  65. package/dist/components/compounds/Timeline.svelte +167 -0
  66. package/dist/components/compounds/Timeline.svelte.d.ts +25 -0
  67. package/dist/components/compounds/ToastContainer.svelte +59 -0
  68. package/dist/components/compounds/ToastContainer.svelte.d.ts +3 -0
  69. package/dist/components/compounds/Tooltip.svelte +41 -0
  70. package/dist/components/compounds/Tooltip.svelte.d.ts +4 -0
  71. package/dist/components/compounds/accordion-types.d.ts +16 -0
  72. package/dist/components/compounds/accordion-types.js +5 -0
  73. package/dist/components/compounds/action-sheet-types.d.ts +14 -0
  74. package/dist/components/compounds/action-sheet-types.js +5 -0
  75. package/dist/components/compounds/bottom-nav-types.d.ts +17 -0
  76. package/dist/components/compounds/bottom-nav-types.js +5 -0
  77. package/dist/components/compounds/index.d.ts +44 -0
  78. package/dist/components/compounds/index.js +54 -0
  79. package/dist/components/compounds/swipe-cell-types.d.ts +14 -0
  80. package/dist/components/compounds/swipe-cell-types.js +5 -0
  81. package/dist/components/compounds/timeline-types.d.ts +20 -0
  82. package/dist/components/compounds/timeline-types.js +5 -0
  83. package/dist/components/index.d.ts +9 -0
  84. package/dist/components/index.js +12 -0
  85. package/dist/components/primitives/Avatar.svelte +104 -0
  86. package/dist/components/primitives/Avatar.svelte.d.ts +8 -0
  87. package/dist/components/primitives/Badge.svelte +33 -0
  88. package/dist/components/primitives/Badge.svelte.d.ts +8 -0
  89. package/dist/components/primitives/BareButton.svelte +45 -0
  90. package/dist/components/primitives/BareButton.svelte.d.ts +4 -0
  91. package/dist/components/primitives/BareInput.svelte +101 -0
  92. package/dist/components/primitives/BareInput.svelte.d.ts +4 -0
  93. package/dist/components/primitives/Button.svelte +60 -0
  94. package/dist/components/primitives/Button.svelte.d.ts +8 -0
  95. package/dist/components/primitives/Checkbox.svelte +58 -0
  96. package/dist/components/primitives/Checkbox.svelte.d.ts +4 -0
  97. package/dist/components/primitives/IconButton.svelte +105 -0
  98. package/dist/components/primitives/IconButton.svelte.d.ts +4 -0
  99. package/dist/components/primitives/Input.svelte +130 -0
  100. package/dist/components/primitives/Input.svelte.d.ts +8 -0
  101. package/dist/components/primitives/Progress.svelte +58 -0
  102. package/dist/components/primitives/Progress.svelte.d.ts +4 -0
  103. package/dist/components/primitives/Radio.svelte +60 -0
  104. package/dist/components/primitives/Radio.svelte.d.ts +25 -0
  105. package/dist/components/primitives/Range.svelte +117 -0
  106. package/dist/components/primitives/Range.svelte.d.ts +27 -0
  107. package/dist/components/primitives/Rating.svelte +148 -0
  108. package/dist/components/primitives/Rating.svelte.d.ts +27 -0
  109. package/dist/components/primitives/Select.svelte +95 -0
  110. package/dist/components/primitives/Select.svelte.d.ts +25 -0
  111. package/dist/components/primitives/Spinner.svelte +54 -0
  112. package/dist/components/primitives/Spinner.svelte.d.ts +4 -0
  113. package/dist/components/primitives/Switch.svelte +53 -0
  114. package/dist/components/primitives/Switch.svelte.d.ts +4 -0
  115. package/dist/components/primitives/Tag.svelte +64 -0
  116. package/dist/components/primitives/Tag.svelte.d.ts +4 -0
  117. package/dist/components/primitives/Textarea.svelte +92 -0
  118. package/dist/components/primitives/Textarea.svelte.d.ts +4 -0
  119. package/dist/components/primitives/ToggleCheckbox.svelte +36 -0
  120. package/dist/components/primitives/ToggleCheckbox.svelte.d.ts +4 -0
  121. package/dist/components/primitives/ToggleInput.svelte +36 -0
  122. package/dist/components/primitives/ToggleInput.svelte.d.ts +4 -0
  123. package/dist/components/primitives/ToggleRadio.svelte +36 -0
  124. package/dist/components/primitives/ToggleRadio.svelte.d.ts +4 -0
  125. package/dist/components/primitives/index.d.ts +26 -0
  126. package/dist/components/primitives/index.js +30 -0
  127. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte +387 -0
  128. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte.d.ts +38 -0
  129. package/dist/components/scenes/ai/AiDocumentEditor.svelte +2209 -0
  130. package/dist/components/scenes/ai/AiDocumentEditor.svelte.d.ts +4 -0
  131. package/dist/components/scenes/ai/MarkdownRenderer.svelte +412 -0
  132. package/dist/components/scenes/ai/MarkdownRenderer.svelte.d.ts +4 -0
  133. package/dist/components/scenes/ai/document-download.d.ts +40 -0
  134. package/dist/components/scenes/ai/document-download.js +300 -0
  135. package/dist/components/scenes/ai/document-parse.d.ts +28 -0
  136. package/dist/components/scenes/ai/document-parse.js +243 -0
  137. package/dist/components/scenes/ai/document-types.d.ts +164 -0
  138. package/dist/components/scenes/ai/document-types.js +1 -0
  139. package/dist/components/scenes/ai/highlight.d.ts +26 -0
  140. package/dist/components/scenes/ai/highlight.js +151 -0
  141. package/dist/components/scenes/ai/index.d.ts +17 -0
  142. package/dist/components/scenes/ai/index.js +13 -0
  143. package/dist/components/scenes/ai/markdown-parse.d.ts +32 -0
  144. package/dist/components/scenes/ai/markdown-parse.js +164 -0
  145. package/dist/components/scenes/app/FeedbackModal.svelte +160 -0
  146. package/dist/components/scenes/app/FeedbackModal.svelte.d.ts +47 -0
  147. package/dist/components/scenes/app/LanguageSwitch.svelte +136 -0
  148. package/dist/components/scenes/app/LanguageSwitch.svelte.d.ts +50 -0
  149. package/dist/components/scenes/app/SettingsModal.svelte +174 -0
  150. package/dist/components/scenes/app/SettingsModal.svelte.d.ts +31 -0
  151. package/dist/components/scenes/app/ThemeSelector.svelte +176 -0
  152. package/dist/components/scenes/app/ThemeSelector.svelte.d.ts +31 -0
  153. package/dist/components/scenes/app/ThemeToggle.svelte +76 -0
  154. package/dist/components/scenes/app/ThemeToggle.svelte.d.ts +29 -0
  155. package/dist/components/scenes/app/index.d.ts +11 -0
  156. package/dist/components/scenes/app/index.js +11 -0
  157. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte +39 -0
  158. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte.d.ts +18 -0
  159. package/dist/components/scenes/crud/CrudDetailDrawer.svelte +155 -0
  160. package/dist/components/scenes/crud/CrudDetailDrawer.svelte.d.ts +38 -0
  161. package/dist/components/scenes/crud/CrudEditDrawer.svelte +225 -0
  162. package/dist/components/scenes/crud/CrudEditDrawer.svelte.d.ts +48 -0
  163. package/dist/components/scenes/crud/CrudFilterBar.svelte +96 -0
  164. package/dist/components/scenes/crud/CrudFilterBar.svelte.d.ts +31 -0
  165. package/dist/components/scenes/crud/CrudPage.svelte +499 -0
  166. package/dist/components/scenes/crud/CrudPage.svelte.d.ts +114 -0
  167. package/dist/components/scenes/crud/crud-types.d.ts +135 -0
  168. package/dist/components/scenes/crud/crud-types.js +7 -0
  169. package/dist/components/scenes/crud/index.d.ts +12 -0
  170. package/dist/components/scenes/crud/index.js +11 -0
  171. package/dist/components/scenes/crypto/EncryptedInput.svelte +156 -0
  172. package/dist/components/scenes/crypto/EncryptedInput.svelte.d.ts +32 -0
  173. package/dist/components/scenes/crypto/HashDisplay.svelte +97 -0
  174. package/dist/components/scenes/crypto/HashDisplay.svelte.d.ts +4 -0
  175. package/dist/components/scenes/crypto/SignatureDisplay.svelte +161 -0
  176. package/dist/components/scenes/crypto/SignatureDisplay.svelte.d.ts +4 -0
  177. package/dist/components/scenes/crypto/index.d.ts +9 -0
  178. package/dist/components/scenes/crypto/index.js +11 -0
  179. package/dist/components/scenes/iam/ChangePasswordForm.svelte +134 -0
  180. package/dist/components/scenes/iam/ChangePasswordForm.svelte.d.ts +8 -0
  181. package/dist/components/scenes/iam/ForgotPasswordForm.svelte +147 -0
  182. package/dist/components/scenes/iam/ForgotPasswordForm.svelte.d.ts +4 -0
  183. package/dist/components/scenes/iam/LoginForm.svelte +191 -0
  184. package/dist/components/scenes/iam/LoginForm.svelte.d.ts +8 -0
  185. package/dist/components/scenes/iam/PasswordInput.svelte +208 -0
  186. package/dist/components/scenes/iam/PasswordInput.svelte.d.ts +49 -0
  187. package/dist/components/scenes/iam/PermGuard.svelte +69 -0
  188. package/dist/components/scenes/iam/PermGuard.svelte.d.ts +16 -0
  189. package/dist/components/scenes/iam/RegisterForm.svelte +269 -0
  190. package/dist/components/scenes/iam/RegisterForm.svelte.d.ts +8 -0
  191. package/dist/components/scenes/iam/ResetPasswordForm.svelte +153 -0
  192. package/dist/components/scenes/iam/ResetPasswordForm.svelte.d.ts +8 -0
  193. package/dist/components/scenes/iam/UserProfile.svelte +251 -0
  194. package/dist/components/scenes/iam/UserProfile.svelte.d.ts +4 -0
  195. package/dist/components/scenes/iam/index.d.ts +16 -0
  196. package/dist/components/scenes/iam/index.js +18 -0
  197. package/dist/components/scenes/iam/password-utils.d.ts +15 -0
  198. package/dist/components/scenes/iam/password-utils.js +19 -0
  199. package/dist/components/scenes/iam/permission-context.svelte.d.ts +90 -0
  200. package/dist/components/scenes/iam/permission-context.svelte.js +114 -0
  201. package/dist/components/scenes/index.d.ts +13 -0
  202. package/dist/components/scenes/index.js +20 -0
  203. package/dist/components/scenes/storage/AvatarUpload.svelte +218 -0
  204. package/dist/components/scenes/storage/AvatarUpload.svelte.d.ts +4 -0
  205. package/dist/components/scenes/storage/FileList.svelte +260 -0
  206. package/dist/components/scenes/storage/FileList.svelte.d.ts +4 -0
  207. package/dist/components/scenes/storage/FileUpload.svelte +402 -0
  208. package/dist/components/scenes/storage/FileUpload.svelte.d.ts +7 -0
  209. package/dist/components/scenes/storage/ImageUpload.svelte +287 -0
  210. package/dist/components/scenes/storage/ImageUpload.svelte.d.ts +4 -0
  211. package/dist/components/scenes/storage/index.d.ts +10 -0
  212. package/dist/components/scenes/storage/index.js +12 -0
  213. package/dist/components/scenes/types.d.ts +583 -0
  214. package/dist/components/scenes/types.js +7 -0
  215. package/dist/i18n.svelte.d.ts +44 -0
  216. package/dist/i18n.svelte.js +108 -0
  217. package/dist/index.d.ts +13 -0
  218. package/dist/index.js +19 -0
  219. package/dist/messages/en-US.json +242 -0
  220. package/dist/messages/zh-CN.json +242 -0
  221. package/dist/messages.d.ts +29 -0
  222. package/dist/messages.js +42 -0
  223. package/dist/styles/design-tokens.css +58 -0
  224. package/dist/styles/global.css +258 -0
  225. package/dist/styles/mobile.css +105 -0
  226. package/dist/styles/theme.css +31 -0
  227. package/dist/theme-config.d.ts +92 -0
  228. package/dist/theme-config.js +122 -0
  229. package/dist/toast.svelte.d.ts +45 -0
  230. package/dist/toast.svelte.js +77 -0
  231. package/dist/types.d.ts +944 -0
  232. package/dist/types.js +7 -0
  233. package/dist/utils/platform.svelte.d.ts +54 -0
  234. package/dist/utils/platform.svelte.js +89 -0
  235. package/dist/utils.d.ts +46 -0
  236. package/dist/utils.js +163 -0
  237. package/package.json +70 -0
package/README.md ADDED
@@ -0,0 +1,500 @@
1
+ # @h-ai/ui
2
+
3
+ > 基于 Svelte 5 Runes 的多端 UI 组件库,采用 DaisyUI v5 + Tailwind CSS v4 样式 + Bits UI v2 headless 交互,内置 i18n(zh-CN / en-US),支持 32+ 主题。
4
+
5
+ ## 安装
6
+
7
+ ```bash
8
+ npm install @h-ai/ui
9
+ ```
10
+
11
+ 依赖 `@h-ai/core`(会自动安装)。
12
+
13
+ ## 快速开始
14
+
15
+ ### 1. 配置 svelte.config.js
16
+
17
+ ```js
18
+ import { autoImportHaiUi } from '@h-ai/ui/auto-import'
19
+ import adapter from '@sveltejs/adapter-auto'
20
+ import { vitePreprocess } from '@sveltejs/vite-plugin-svelte'
21
+
22
+ /** @type {import('@sveltejs/kit').Config} */
23
+ const config = {
24
+ preprocess: [autoImportHaiUi(), vitePreprocess()],
25
+ compilerOptions: { runes: true },
26
+ kit: { adapter: adapter() },
27
+ }
28
+
29
+ export default config
30
+ ```
31
+
32
+ ### 2. 配置 vite.config.ts
33
+
34
+ ```ts
35
+ import { sveltekit } from '@sveltejs/kit/vite'
36
+ import tailwindcss from '@tailwindcss/vite'
37
+ import { defineConfig } from 'vite'
38
+
39
+ export default defineConfig({
40
+ plugins: [sveltekit(), tailwindcss()],
41
+ optimizeDeps: { exclude: ['bits-ui'] },
42
+ ssr: { noExternal: [/@h-ai\//] },
43
+ })
44
+ ```
45
+
46
+ ### 3. 配置 src/app.css
47
+
48
+ ```css
49
+ @import 'tailwindcss';
50
+ @import '@h-ai/ui/styles/global.css';
51
+ @import '@h-ai/ui/styles/theme.css';
52
+ @source "../node_modules/@h-ai/ui/dist/**/*.{svelte,ts}";
53
+
54
+ @plugin "daisyui" {
55
+ themes: light --default, dark --prefersdark, cupcake, emerald, corporate, nord, dracula, night;
56
+ }
57
+
58
+ /* 图标(可选) */
59
+ @plugin "@iconify/tailwind4" {
60
+ prefixes: tabler;
61
+ }
62
+ ```
63
+
64
+ > `@source` 让 TailwindCSS 扫描 `@h-ai/ui` 组件中使用的 class 名,否则组件样式会丢失。
65
+
66
+ ### 4. 使用组件
67
+
68
+ ```svelte
69
+ <script>
70
+ import { Button, Input, Card } from '@h-ai/ui'
71
+ </script>
72
+
73
+ <Card title="示例表单">
74
+ <Input placeholder="请输入用户名" />
75
+ <Button variant="primary" onclick={handleSubmit}>提交</Button>
76
+ </Card>
77
+ ```
78
+
79
+ 启用自动导入后可直接在模板中使用,无需逐个 import:
80
+
81
+ ```svelte
82
+ <!-- 无需 import { Button } from '@h-ai/ui' -->
83
+ <Button variant="primary">提交</Button>
84
+ ```
85
+
86
+ ## 组件架构
87
+
88
+ 组件按三层划分(primitives → compounds → scenes):
89
+
90
+ ```
91
+ components/
92
+ ├── primitives/ # 原子组件(不可再分的基础 UI 单元)
93
+ ├── compounds/ # 组合组件(由原子组件 + Bits UI headless 组合而成)
94
+ └── scenes/ # 场景组件(面向具体业务场景的完整 UI 流程)
95
+ ├── app/ # 应用级(设置/反馈/主题/语言切换)
96
+ ├── iam/ # 身份认证
97
+ ├── storage/ # 存储管理
98
+ └── crypto/ # 加密展示
99
+ ```
100
+
101
+ ## 组件清单
102
+
103
+ ### 原子组件 Primitives(21 个)
104
+
105
+ | 组件 | 描述 | 主要属性 |
106
+ | ---------------- | ------------ | ------------------------------------------------------------------ |
107
+ | `Button` | 按钮 | `variant`, `size`, `loading`, `disabled`, `outline`, `circle` |
108
+ | `IconButton` | 图标按钮 | `icon: string \| Snippet`, `variant`, `size`, `tooltip`, `loading` |
109
+ | `BareButton` | 无样式按钮 | `class`, `ariaLabel`, `role`, `tabindex` |
110
+ | `Input` | 输入框 | `type`, `value`, `size`, `error`, `validationMessage` |
111
+ | `BareInput` | 无样式输入框 | `type`, `class`, `accept`, `multiple` |
112
+ | `Textarea` | 文本域 | `value`, `rows`, `size`, `autoResize`, `error` |
113
+ | `Select` | 下拉选择 | `options`, `value`, `placeholder`, `size` |
114
+ | `Checkbox` | 复选框 | `checked`, `label`, `size`, `indeterminate` |
115
+ | `Switch` | 开关 | `checked`, `label`, `size` |
116
+ | `Radio` | 单选组 | `options`, `value`, `direction`, `size` |
117
+ | `ToggleCheckbox` | 原生开关输入 | `checked`, `name`, `onchange` |
118
+ | `ToggleInput` | 原生切换输入 | `checked`, `name` |
119
+ | `ToggleRadio` | 原生单选输入 | `checked`, `name`, `onchange` |
120
+ | `Range` | 滑块 | `value`, `min`, `max`, `step` |
121
+ | `Rating` | 评分 | `value`, `max` |
122
+ | `Badge` | 徽章 | `variant`, `size`, `outline` |
123
+ | `Avatar` | 头像 | `src`, `name`, `size`, `shape`, `ring` |
124
+ | `Tag` | 标签 | `text`, `variant`, `size`, `closable` |
125
+ | `Spinner` | 加载动画 | `size`, `variant` |
126
+ | `Progress` | 进度条 | `value`, `max`, `variant`, `striped`, `animated` |
127
+
128
+ ### 组合组件 Compounds(25 个)
129
+
130
+ #### 表单
131
+
132
+ | 组件 | 描述 | 主要属性 |
133
+ | ----------- | -------- | -------------------------------------------- |
134
+ | `Form` | 表单容器 | `loading`, `disabled`, `onsubmit` |
135
+ | `FormField` | 表单字段 | `label`, `error`, `hint`, `required` |
136
+ | `TagInput` | 标签输入 | `tags`, `maxTags`, `allowDuplicates`, `size` |
137
+
138
+ #### 反馈
139
+
140
+ | 组件 | 描述 | 主要属性 |
141
+ | ---------------- | -------- | --------------------------------- |
142
+ | `Alert` | 警告框 | `variant`, `title`, `dismissible` |
143
+ | `ToastContainer` | 通知容器 | 全局放置,配合 `toast` 单例使用 |
144
+
145
+ #### 弹层
146
+
147
+ | 组件 | 描述 | 主要属性 |
148
+ | --------- | ------ | ------------------------------------------------------- |
149
+ | `Modal` | 模态框 | `open`, `title`, `size`, `closeOnBackdrop`, `showClose` |
150
+ | `Drawer` | 抽屉 | `open`, `position`, `title`, `size` |
151
+ | `Confirm` | 确认框 | `open`, `title`, `message`, `variant`, `onconfirm` |
152
+ | `Popover` | 弹出层 | `open`, `position`, `trigger`, `offset` |
153
+
154
+ #### 数据展示
155
+
156
+ | 组件 | 描述 | 主要属性 |
157
+ | ----------- | -------- | ---------------------------------------- |
158
+ | `Card` | 卡片容器 | `title`, `bordered`, `shadow`, `padding` |
159
+ | `DataTable` | 数据表格 | `data`, `columns`, `keyField`, `loading` |
160
+ | `Accordion` | 手风琴 | `items: AccordionItem[]` |
161
+ | `Timeline` | 时间线 | `items: TimelineItem[]` |
162
+
163
+ #### Bits UI headless 交互
164
+
165
+ | 组件 | 描述 | 主要属性 |
166
+ | ------------ | --------------------------- | --------------------------------------------------- |
167
+ | `Combobox` | 可搜索下拉选择(单选/多选) | `options`, `value`, `multiple`, `placeholder` |
168
+ | `Calendar` | 独立日历 | `value: DateValue`, `minValue`, `maxValue` |
169
+ | `DatePicker` | 日期输入+弹出 | `value: DateValue`, `minValue`, `maxValue`, `error` |
170
+
171
+ > 日期值使用 `@internationalized/date` 的 `DateValue` / `CalendarDate` 类型。
172
+
173
+ #### 导航
174
+
175
+ | 组件 | 描述 | 主要属性 |
176
+ | ------------ | -------- | -------------------------------------------- |
177
+ | `Tabs` | 标签页 | `items`, `active`, `type`, `size` |
178
+ | `Pagination` | 分页 | `page`, `total`, `pageSize`, `showTotal` |
179
+ | `Breadcrumb` | 面包屑 | `items`, `separator` |
180
+ | `Steps` | 步骤条 | `items`, `current`, `direction`, `clickable` |
181
+ | `Dropdown` | 下拉菜单 | `items`, `trigger`, `position` |
182
+ | `Tooltip` | 提示 | `content`, `position`, `delay` |
183
+
184
+ #### 状态占位
185
+
186
+ | 组件 | 描述 | 主要属性 |
187
+ | ---------- | ------ | ------------------------------------- |
188
+ | `Skeleton` | 骨架屏 | `variant`, `width`, `height`, `count` |
189
+ | `Empty` | 空状态 | `title`, `description`, `icon` |
190
+ | `Result` | 结果页 | `status`, `title`, `description` |
191
+
192
+ #### 页面级
193
+
194
+ | 组件 | 描述 | 主要属性 |
195
+ | ------------ | -------- | ------------------------------------------- |
196
+ | `PageHeader` | 页面头部 | `title`, `description`,支持 `actions` 插槽 |
197
+
198
+ ### 场景组件 Scenes(19 个)
199
+
200
+ #### App 应用级(5 个)
201
+
202
+ | 组件 | 描述 | 主要属性 |
203
+ | ---------------- | ---------------- | ------------------ |
204
+ | `FeedbackModal` | 反馈模态框 | `open`, `onsubmit` |
205
+ | `SettingsModal` | 设置模态框 | `open`, `onclose` |
206
+ | `LanguageSwitch` | 语言切换 | 无需 Props |
207
+ | `ThemeSelector` | 完整主题选择面板 | 无需 Props |
208
+ | `ThemeToggle` | 明/暗主题切换 | 无需 Props |
209
+
210
+ #### IAM 身份认证(7 个)
211
+
212
+ | 组件 | 描述 | 主要属性 |
213
+ | -------------------- | ---------- | ----------------------------------------------------- |
214
+ | `LoginForm` | 登录表单 | `loading`, `errors`, `showRememberMe`, `onsubmit` |
215
+ | `RegisterForm` | 注册表单 | `loading`, `errors`, `fields`, `onsubmit` |
216
+ | `ForgotPasswordForm` | 忘记密码 | `mode`, `loading`, `errors`, `onsubmit` |
217
+ | `ResetPasswordForm` | 重置密码 | `loading`, `errors`, `showCode`, `onsubmit` |
218
+ | `ChangePasswordForm` | 修改密码 | `loading`, `errors`, `requireOldPassword`, `onsubmit` |
219
+ | `PasswordInput` | 密码输入框 | `value`, `showToggle`, `showStrength`, `minLength` |
220
+ | `UserProfile` | 用户资料 | `user`, `editable`, `fields`, `onsubmit` |
221
+
222
+ #### Storage 存储(4 个)
223
+
224
+ | 组件 | 描述 | 主要属性 |
225
+ | -------------- | -------- | -------------------------------------------------------- |
226
+ | `FileUpload` | 文件上传 | `accept`, `maxSize`, `maxFiles`, `multiple`, `uploadUrl` |
227
+ | `ImageUpload` | 图片上传 | `value`, `accept`, `maxSize`, `aspectRatio` |
228
+ | `AvatarUpload` | 头像上传 | `value`, `size`, `maxSize`, `fallback` |
229
+ | `FileList` | 文件列表 | `files`, `layout`, `showDelete`, `showDownload` |
230
+
231
+ #### Crypto 加密展示(3 个)
232
+
233
+ | 组件 | 描述 | 主要属性 |
234
+ | ------------------ | -------- | ------------------------------------------------------- |
235
+ | `EncryptedInput` | 加密输入 | `value`, `encryptedValue`, `algorithm`, `showEncrypted` |
236
+ | `HashDisplay` | 哈希展示 | `value`, `algorithm`, `copyable`, `truncate` |
237
+ | `SignatureDisplay` | 签名展示 | `signature`, `publicKey`, `algorithm`, `verified` |
238
+
239
+ ## 使用示例
240
+
241
+ ### Toast 通知
242
+
243
+ ```svelte
244
+ <script>
245
+ import { toast, ToastContainer } from '@h-ai/ui'
246
+
247
+ function notify() {
248
+ toast.success('操作成功')
249
+ toast.error('操作失败')
250
+ toast.warning('请注意')
251
+ toast.info('提示信息', 5000) // 自定义持续时间
252
+ }
253
+ </script>
254
+
255
+ <button onclick={notify}>通知</button>
256
+ <ToastContainer />
257
+ ```
258
+
259
+ ### 典型 CRUD 页面
260
+
261
+ ```svelte
262
+ <script>
263
+ import {
264
+ PageHeader, Card, DataTable, Button,
265
+ Modal, Input, Select, toast, ToastContainer,
266
+ } from '@h-ai/ui'
267
+
268
+ let items = $state([])
269
+ let showModal = $state(false)
270
+ let loading = $state(false)
271
+ let formData = $state({ name: '', type: '' })
272
+
273
+ const columns = [
274
+ { key: 'name', label: '名称' },
275
+ { key: 'type', label: '类型' },
276
+ { key: 'createdAt', label: '创建时间' },
277
+ ]
278
+
279
+ async function handleCreate() {
280
+ loading = true
281
+ try {
282
+ await fetch('/api/items', { method: 'POST', body: JSON.stringify(formData) })
283
+ showModal = false
284
+ toast.success('创建成功')
285
+ } finally {
286
+ loading = false
287
+ }
288
+ }
289
+ </script>
290
+
291
+ <PageHeader title="项目管理" description="管理所有项目">
292
+ {#snippet actions()}
293
+ <Button onclick={() => showModal = true}>新建</Button>
294
+ {/snippet}
295
+ </PageHeader>
296
+
297
+ <Card>
298
+ <DataTable data={items} {columns} keyField="id" {loading}>
299
+ {#snippet actions(item)}
300
+ <Button size="xs">编辑</Button>
301
+ <Button size="xs" variant="error">删除</Button>
302
+ {/snippet}
303
+ </DataTable>
304
+ </Card>
305
+
306
+ <Modal bind:open={showModal} title="新建项目">
307
+ <form onsubmit={(e) => { e.preventDefault(); handleCreate() }} class="space-y-4">
308
+ <Input placeholder="名称" bind:value={formData.name} required />
309
+ <Select
310
+ placeholder="选择类型"
311
+ bind:value={formData.type}
312
+ options={[
313
+ { value: 'a', label: '类型 A' },
314
+ { value: 'b', label: '类型 B' },
315
+ ]}
316
+ />
317
+ </form>
318
+ {#snippet footer()}
319
+ <Button variant="ghost" onclick={() => showModal = false}>取消</Button>
320
+ <Button {loading} onclick={handleCreate}>创建</Button>
321
+ {/snippet}
322
+ </Modal>
323
+
324
+ <ToastContainer />
325
+ ```
326
+
327
+ ### 登录页面
328
+
329
+ ```svelte
330
+ <script>
331
+ import { LoginForm } from '@h-ai/ui'
332
+
333
+ let loading = $state(false)
334
+ let errors = $state({})
335
+
336
+ async function handleLogin(data) {
337
+ loading = true
338
+ errors = {}
339
+ try {
340
+ await fetch('/api/login', { method: 'POST', body: JSON.stringify(data) })
341
+ } catch {
342
+ errors = { general: '登录失败,请检查用户名和密码' }
343
+ } finally {
344
+ loading = false
345
+ }
346
+ }
347
+ </script>
348
+
349
+ <!-- 场景组件内置 i18n,无需传入翻译 props -->
350
+ <LoginForm {loading} {errors} onsubmit={handleLogin} showRegisterLink />
351
+ ```
352
+
353
+ ### PasswordInput 受控模式
354
+
355
+ ```svelte
356
+ <script>
357
+ import { PasswordInput } from '@h-ai/ui'
358
+
359
+ let password = $state('')
360
+ </script>
361
+
362
+ <PasswordInput
363
+ value={password}
364
+ oninput={(e) => { password = e.currentTarget.value }}
365
+ placeholder="请输入密码"
366
+ showStrength
367
+ />
368
+ ```
369
+
370
+ ## 样式依赖
371
+
372
+ 组件基于 TailwindCSS v4 + DaisyUI。应用层 `app.css` 需要以下配置:
373
+
374
+ ```css
375
+ /* 必须 */
376
+ @import 'tailwindcss';
377
+ @import '@h-ai/ui/styles/global.css'; /* 基础重置、滚动条、焦点样式 */
378
+ @import '@h-ai/ui/styles/theme.css'; /* Tailwind v4 @theme Token(品牌色/阴影/动效) */
379
+ @source "../node_modules/@h-ai/ui/dist/**/*.{svelte,ts}";
380
+
381
+ /* 移动端项目追加(可选) */
382
+ @import '@h-ai/ui/styles/design-tokens.css'; /* CSS 自定义属性 */
383
+ @import '@h-ai/ui/styles/mobile.css'; /* 安全区域/触摸优化 */
384
+
385
+ /* DaisyUI 主题 */
386
+ @plugin "daisyui" {
387
+ themes: light --default, dark --prefersdark, cupcake, emerald, corporate, nord, dracula, night;
388
+ }
389
+ ```
390
+
391
+ - `global.css`:基础 HTML 重置、滚动条美化、表单焦点环
392
+ - `theme.css`:Tailwind v4 `@theme` 块,包含品牌色、阴影层级、动效曲线、字体特性
393
+ - `design-tokens.css`:CSS 自定义属性(间距/圆角/z-index/过渡),移动端推荐
394
+ - `mobile.css`:安全区域 padding、momentum 滚动、虚拟键盘适配
395
+
396
+ ### 图标
397
+
398
+ 组件使用 Iconify (Tabler Icons):
399
+
400
+ ```bash
401
+ npm install -D @iconify/tailwind4 @iconify-json/tabler
402
+ ```
403
+
404
+ ```css
405
+ /* app.css 中追加 */
406
+ @plugin "@iconify/tailwind4" {
407
+ prefixes: tabler;
408
+ }
409
+ ```
410
+
411
+ ### 主题切换
412
+
413
+ 使用内置的主题工具函数管理 32 个 DaisyUI 主题:
414
+
415
+ ```ts
416
+ import {
417
+ applyTheme, // 应用主题(自动持久化到 localStorage)
418
+ getCurrentTheme, // 获取当前主题
419
+ getThemeInitScript, // 防闪烁脚本(放在 app.html <head> 中)
420
+ isDarkTheme, // 检查是否暗色主题
421
+ THEME_GROUPS, // 按亮色/暗色分组
422
+ THEMES, // ThemeInfo[] — 全部 32 个主题元数据
423
+ } from '@h-ai/ui'
424
+ ```
425
+
426
+ 在 `app.html` 中添加防闪烁脚本:
427
+
428
+ ```html
429
+ <head>
430
+ <script>
431
+ {@html getThemeInitScript()}
432
+ </script>
433
+ </head>
434
+ ```
435
+
436
+ ## 国际化 (i18n)
437
+
438
+ @h-ai/ui 采用**组件内置翻译**模式:
439
+
440
+ - 场景组件(`scenes/`)内置中英文翻译(zh-CN / en-US),开箱即用
441
+ - 组件自动响应全局 locale 变化(通过 `@h-ai/core` 同步)
442
+ - 应用层只需处理**页面级文本**,组件内部文本由 @h-ai/ui 统一管理
443
+ - 如需覆盖特定文本,通过 `submitText`、`labels` 等 props 传入
444
+
445
+ ### createLocaleStore
446
+
447
+ 用于客户端 locale 状态管理,自动同步到 `@h-ai/core` 全局 locale 管理器:
448
+
449
+ ```svelte
450
+ <script>
451
+ import { createLocaleStore, setGlobalLocale } from '@h-ai/ui'
452
+ import { setLocale } from '$lib/paraglide/runtime'
453
+
454
+ const localeStore = createLocaleStore()
455
+
456
+ function changeLocale(code) {
457
+ localeStore.set(code) // 更新 UI store + 同步到 @h-ai/core
458
+ setLocale(code) // 同步到 Paraglide(应用层)
459
+ }
460
+ </script>
461
+
462
+ <select value={localeStore.current} onchange={(e) => changeLocale(e.currentTarget.value)}>
463
+ {#each localeStore.supported as l}
464
+ <option value={l.code}>{l.label}</option>
465
+ {/each}
466
+ </select>
467
+ ```
468
+
469
+ ### 导出的 i18n 工具
470
+
471
+ ```ts
472
+ import {
473
+ createLocaleStore, // Svelte 响应式 locale store
474
+ DEFAULT_LOCALE, // 默认 locale: 'zh-CN'
475
+ DEFAULT_LOCALES, // 支持的 locale 列表
476
+ detectBrowserLocale, // 检测浏览器语言
477
+ getGlobalLocale, // 获取当前全局 locale
478
+ interpolate, // 字符串插值(如 "Hello {name}")
479
+ isLocaleSupported, // 检查 locale 是否支持
480
+ resolveLocale, // 解析 locale(支持回退)
481
+ setGlobalLocale, // 设置全局 locale(同步 @h-ai/core)
482
+ } from '@h-ai/ui'
483
+ ```
484
+
485
+ ## 其他导出
486
+
487
+ ```ts
488
+ // 类型
489
+ import type { ButtonProps, InputProps, ModalProps } from '@h-ai/ui'
490
+ ```
491
+
492
+ ```ts
493
+ // 样式工具
494
+ import { cn, generateId, getSizeClass, getVariantClass } from '@h-ai/ui'
495
+ ```
496
+
497
+ ```ts
498
+ // Toast 单例
499
+ import { toast } from '@h-ai/ui'
500
+ ```
@@ -0,0 +1,96 @@
1
+ /**
2
+ * =============================================================================
3
+ * @h-ai/ui - 自动导入类型声明
4
+ * =============================================================================
5
+ * 让 Svelte/TS 识别通过预处理器自动注入的组件名称。
6
+ * =============================================================================
7
+ */
8
+
9
+ type AutoImportMarkup = (args: { content: string; filename?: string }) => { code: string }
10
+
11
+ type AutoImportHaiUiPreprocessor = {
12
+ name: string
13
+ markup: AutoImportMarkup
14
+ }
15
+
16
+ export function autoImportHaiUi(): AutoImportHaiUiPreprocessor
17
+
18
+ declare global {
19
+ // primitives
20
+ const Avatar: typeof import('@h-ai/ui')['Avatar']
21
+ const Badge: typeof import('@h-ai/ui')['Badge']
22
+ const BareButton: typeof import('@h-ai/ui')['BareButton']
23
+ const BareInput: typeof import('@h-ai/ui')['BareInput']
24
+ const Button: typeof import('@h-ai/ui')['Button']
25
+ const Checkbox: typeof import('@h-ai/ui')['Checkbox']
26
+ const IconButton: typeof import('@h-ai/ui')['IconButton']
27
+ const Input: typeof import('@h-ai/ui')['Input']
28
+ const Progress: typeof import('@h-ai/ui')['Progress']
29
+ const Radio: typeof import('@h-ai/ui')['Radio']
30
+ const Rating: typeof import('@h-ai/ui')['Rating']
31
+ const Select: typeof import('@h-ai/ui')['Select']
32
+ const Spinner: typeof import('@h-ai/ui')['Spinner']
33
+ const Switch: typeof import('@h-ai/ui')['Switch']
34
+ const Tag: typeof import('@h-ai/ui')['Tag']
35
+ const Textarea: typeof import('@h-ai/ui')['Textarea']
36
+ const ToggleCheckbox: typeof import('@h-ai/ui')['ToggleCheckbox']
37
+ const ToggleInput: typeof import('@h-ai/ui')['ToggleInput']
38
+ const ToggleRadio: typeof import('@h-ai/ui')['ToggleRadio']
39
+
40
+ // compounds
41
+ const Accordion: typeof import('@h-ai/ui')['Accordion']
42
+ const Alert: typeof import('@h-ai/ui')['Alert']
43
+ const Breadcrumb: typeof import('@h-ai/ui')['Breadcrumb']
44
+ const Calendar: typeof import('@h-ai/ui')['Calendar']
45
+ const Card: typeof import('@h-ai/ui')['Card']
46
+ const Combobox: typeof import('@h-ai/ui')['Combobox']
47
+ const Confirm: typeof import('@h-ai/ui')['Confirm']
48
+ const DataTable: typeof import('@h-ai/ui')['DataTable']
49
+ const DatePicker: typeof import('@h-ai/ui')['DatePicker']
50
+ const Drawer: typeof import('@h-ai/ui')['Drawer']
51
+ const Dropdown: typeof import('@h-ai/ui')['Dropdown']
52
+ const Empty: typeof import('@h-ai/ui')['Empty']
53
+ const Form: typeof import('@h-ai/ui')['Form']
54
+ const FormField: typeof import('@h-ai/ui')['FormField']
55
+ const Modal: typeof import('@h-ai/ui')['Modal']
56
+ const PageHeader: typeof import('@h-ai/ui')['PageHeader']
57
+ const Pagination: typeof import('@h-ai/ui')['Pagination']
58
+ const Popover: typeof import('@h-ai/ui')['Popover']
59
+ const Result: typeof import('@h-ai/ui')['Result']
60
+ const Skeleton: typeof import('@h-ai/ui')['Skeleton']
61
+ const Steps: typeof import('@h-ai/ui')['Steps']
62
+ const Tabs: typeof import('@h-ai/ui')['Tabs']
63
+ const TagInput: typeof import('@h-ai/ui')['TagInput']
64
+ const Timeline: typeof import('@h-ai/ui')['Timeline']
65
+ const ToastContainer: typeof import('@h-ai/ui')['ToastContainer']
66
+ const Tooltip: typeof import('@h-ai/ui')['Tooltip']
67
+
68
+ // scenes - app
69
+ const FeedbackModal: typeof import('@h-ai/ui')['FeedbackModal']
70
+ const LanguageSwitch: typeof import('@h-ai/ui')['LanguageSwitch']
71
+ const SettingsModal: typeof import('@h-ai/ui')['SettingsModal']
72
+ const ThemeSelector: typeof import('@h-ai/ui')['ThemeSelector']
73
+ const ThemeToggle: typeof import('@h-ai/ui')['ThemeToggle']
74
+
75
+ // scenes - iam
76
+ const ChangePasswordForm: typeof import('@h-ai/ui')['ChangePasswordForm']
77
+ const ForgotPasswordForm: typeof import('@h-ai/ui')['ForgotPasswordForm']
78
+ const LoginForm: typeof import('@h-ai/ui')['LoginForm']
79
+ const PasswordInput: typeof import('@h-ai/ui')['PasswordInput']
80
+ const RegisterForm: typeof import('@h-ai/ui')['RegisterForm']
81
+ const ResetPasswordForm: typeof import('@h-ai/ui')['ResetPasswordForm']
82
+ const UserProfile: typeof import('@h-ai/ui')['UserProfile']
83
+
84
+ // scenes - storage
85
+ const AvatarUpload: typeof import('@h-ai/ui')['AvatarUpload']
86
+ const FileList: typeof import('@h-ai/ui')['FileList']
87
+ const FileUpload: typeof import('@h-ai/ui')['FileUpload']
88
+ const ImageUpload: typeof import('@h-ai/ui')['ImageUpload']
89
+
90
+ // scenes - crypto
91
+ const EncryptedInput: typeof import('@h-ai/ui')['EncryptedInput']
92
+ const HashDisplay: typeof import('@h-ai/ui')['HashDisplay']
93
+ const SignatureDisplay: typeof import('@h-ai/ui')['SignatureDisplay']
94
+ }
95
+
96
+ export {}