@h-ai/ui 0.1.0-alpha.67 → 0.1.0-alpha.69

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 (300) hide show
  1. package/README.en.md +39 -7
  2. package/README.ja.md +39 -7
  3. package/README.md +72 -40
  4. package/auto-import.d.ts +3 -0
  5. package/auto-import.js +3 -0
  6. package/dist/components/compounds/Accordion.svelte +24 -0
  7. package/dist/components/compounds/Accordion.svelte.d.ts +34 -0
  8. package/dist/components/compounds/ActionSheet.svelte +24 -0
  9. package/dist/components/compounds/ActionSheet.svelte.d.ts +38 -0
  10. package/dist/components/compounds/Alert.svelte +15 -4
  11. package/dist/components/compounds/Alert.svelte.d.ts +10 -0
  12. package/dist/components/compounds/AppBar.svelte +24 -0
  13. package/dist/components/compounds/AppBar.svelte.d.ts +33 -0
  14. package/dist/components/compounds/BottomNav.svelte +37 -0
  15. package/dist/components/compounds/BottomNav.svelte.d.ts +43 -0
  16. package/dist/components/compounds/Breadcrumb.svelte +11 -0
  17. package/dist/components/compounds/Breadcrumb.svelte.d.ts +20 -0
  18. package/dist/components/compounds/Calendar.svelte +20 -6
  19. package/dist/components/compounds/Calendar.svelte.d.ts +20 -6
  20. package/dist/components/compounds/Card.svelte +10 -0
  21. package/dist/components/compounds/Card.svelte.d.ts +10 -0
  22. package/dist/components/compounds/Combobox.svelte +35 -18
  23. package/dist/components/compounds/Combobox.svelte.d.ts +35 -18
  24. package/dist/components/compounds/Confirm.svelte +11 -0
  25. package/dist/components/compounds/Confirm.svelte.d.ts +21 -0
  26. package/dist/components/compounds/DataTable.svelte +40 -17
  27. package/dist/components/compounds/DataTable.svelte.d.ts +9 -13
  28. package/dist/components/compounds/DatePicker.svelte +20 -6
  29. package/dist/components/compounds/DatePicker.svelte.d.ts +20 -6
  30. package/dist/components/compounds/Drawer.svelte +11 -0
  31. package/dist/components/compounds/Drawer.svelte.d.ts +21 -0
  32. package/dist/components/compounds/Dropdown.svelte +10 -0
  33. package/dist/components/compounds/Dropdown.svelte.d.ts +10 -0
  34. package/dist/components/compounds/Empty.svelte +16 -5
  35. package/dist/components/compounds/Empty.svelte.d.ts +20 -0
  36. package/dist/components/compounds/Form.svelte +37 -2
  37. package/dist/components/compounds/Form.svelte.d.ts +20 -0
  38. package/dist/components/compounds/FormField.svelte +11 -0
  39. package/dist/components/compounds/FormField.svelte.d.ts +20 -0
  40. package/dist/components/compounds/FormLayout.svelte +13 -1
  41. package/dist/components/compounds/FormLayout.svelte.d.ts +13 -0
  42. package/dist/components/compounds/InfiniteScroll.svelte +24 -0
  43. package/dist/components/compounds/InfiniteScroll.svelte.d.ts +34 -0
  44. package/dist/components/compounds/MessageBoxContainer.svelte +11 -0
  45. package/dist/components/compounds/MessageBoxContainer.svelte.d.ts +21 -0
  46. package/dist/components/compounds/MessageBoxDialog.svelte +14 -0
  47. package/dist/components/compounds/MessageBoxDialog.svelte.d.ts +21 -0
  48. package/dist/components/compounds/MessageContainer.svelte +11 -0
  49. package/dist/components/compounds/MessageContainer.svelte.d.ts +21 -0
  50. package/dist/components/compounds/Modal.svelte +10 -0
  51. package/dist/components/compounds/Modal.svelte.d.ts +10 -0
  52. package/dist/components/compounds/PageHeader.svelte +21 -8
  53. package/dist/components/compounds/PageHeader.svelte.d.ts +21 -8
  54. package/dist/components/compounds/Pagination.svelte +34 -8
  55. package/dist/components/compounds/Pagination.svelte.d.ts +20 -0
  56. package/dist/components/compounds/Popover.svelte +11 -0
  57. package/dist/components/compounds/Popover.svelte.d.ts +20 -0
  58. package/dist/components/compounds/PullRefresh.svelte +24 -0
  59. package/dist/components/compounds/PullRefresh.svelte.d.ts +32 -0
  60. package/dist/components/compounds/Result.svelte +11 -0
  61. package/dist/components/compounds/Result.svelte.d.ts +20 -0
  62. package/dist/components/compounds/SafeArea.svelte +24 -0
  63. package/dist/components/compounds/SafeArea.svelte.d.ts +32 -0
  64. package/dist/components/compounds/Skeleton.svelte +10 -0
  65. package/dist/components/compounds/Skeleton.svelte.d.ts +10 -0
  66. package/dist/components/compounds/Steps.svelte +11 -0
  67. package/dist/components/compounds/Steps.svelte.d.ts +20 -0
  68. package/dist/components/compounds/SwipeCell.svelte +24 -0
  69. package/dist/components/compounds/SwipeCell.svelte.d.ts +37 -0
  70. package/dist/components/compounds/TableToolbar.svelte +66 -28
  71. package/dist/components/compounds/TableToolbar.svelte.d.ts +29 -19
  72. package/dist/components/compounds/Tabs.svelte +58 -10
  73. package/dist/components/compounds/Tabs.svelte.d.ts +10 -0
  74. package/dist/components/compounds/TagInput.svelte +11 -0
  75. package/dist/components/compounds/TagInput.svelte.d.ts +20 -0
  76. package/dist/components/compounds/Timeline.svelte +24 -0
  77. package/dist/components/compounds/Timeline.svelte.d.ts +34 -0
  78. package/dist/components/compounds/ToastContainer.svelte +11 -0
  79. package/dist/components/compounds/ToastContainer.svelte.d.ts +26 -0
  80. package/dist/components/compounds/Tooltip.svelte +11 -0
  81. package/dist/components/compounds/Tooltip.svelte.d.ts +22 -0
  82. package/dist/components/compounds/accordion-types.d.ts +10 -1
  83. package/dist/components/compounds/action-sheet-types.d.ts +9 -0
  84. package/dist/components/compounds/bottom-nav-types.d.ts +9 -0
  85. package/dist/components/compounds/swipe-cell-types.d.ts +9 -0
  86. package/dist/components/compounds/timeline-types.d.ts +9 -0
  87. package/dist/components/control-size.d.ts +17 -0
  88. package/dist/components/control-size.js +8 -0
  89. package/dist/components/primitives/Avatar.svelte +10 -0
  90. package/dist/components/primitives/Avatar.svelte.d.ts +10 -0
  91. package/dist/components/primitives/Badge.svelte +10 -0
  92. package/dist/components/primitives/Badge.svelte.d.ts +10 -0
  93. package/dist/components/primitives/BareButton.svelte +11 -0
  94. package/dist/components/primitives/BareButton.svelte.d.ts +20 -0
  95. package/dist/components/primitives/BareInput.svelte +11 -0
  96. package/dist/components/primitives/BareInput.svelte.d.ts +20 -0
  97. package/dist/components/primitives/Button.svelte +10 -0
  98. package/dist/components/primitives/Button.svelte.d.ts +10 -0
  99. package/dist/components/primitives/Checkbox.svelte +11 -0
  100. package/dist/components/primitives/Checkbox.svelte.d.ts +20 -0
  101. package/dist/components/primitives/IconButton.svelte +11 -0
  102. package/dist/components/primitives/IconButton.svelte.d.ts +20 -0
  103. package/dist/components/primitives/Input.svelte +10 -0
  104. package/dist/components/primitives/Input.svelte.d.ts +10 -0
  105. package/dist/components/primitives/Progress.svelte +11 -0
  106. package/dist/components/primitives/Progress.svelte.d.ts +20 -0
  107. package/dist/components/primitives/Radio.svelte +11 -0
  108. package/dist/components/primitives/Radio.svelte.d.ts +20 -0
  109. package/dist/components/primitives/Range.svelte +24 -0
  110. package/dist/components/primitives/Range.svelte.d.ts +34 -0
  111. package/dist/components/primitives/Rating.svelte +24 -0
  112. package/dist/components/primitives/Rating.svelte.d.ts +34 -0
  113. package/dist/components/primitives/Select.svelte +11 -0
  114. package/dist/components/primitives/Select.svelte.d.ts +21 -0
  115. package/dist/components/primitives/Spinner.svelte +11 -0
  116. package/dist/components/primitives/Spinner.svelte.d.ts +20 -0
  117. package/dist/components/primitives/Switch.svelte +11 -0
  118. package/dist/components/primitives/Switch.svelte.d.ts +20 -0
  119. package/dist/components/primitives/Tag.svelte +11 -0
  120. package/dist/components/primitives/Tag.svelte.d.ts +20 -0
  121. package/dist/components/primitives/Textarea.svelte +11 -0
  122. package/dist/components/primitives/Textarea.svelte.d.ts +21 -0
  123. package/dist/components/primitives/ToggleCheckbox.svelte +11 -0
  124. package/dist/components/primitives/ToggleCheckbox.svelte.d.ts +20 -0
  125. package/dist/components/primitives/ToggleInput.svelte +11 -0
  126. package/dist/components/primitives/ToggleInput.svelte.d.ts +20 -0
  127. package/dist/components/primitives/ToggleRadio.svelte +11 -0
  128. package/dist/components/primitives/ToggleRadio.svelte.d.ts +20 -0
  129. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte +27 -0
  130. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte.d.ts +27 -0
  131. package/dist/components/scenes/ai/AiDocumentEditor.svelte +79 -0
  132. package/dist/components/scenes/ai/AiDocumentEditor.svelte.d.ts +23 -0
  133. package/dist/components/scenes/ai/MarkdownRenderer.svelte +11 -0
  134. package/dist/components/scenes/ai/MarkdownRenderer.svelte.d.ts +28 -0
  135. package/dist/components/scenes/ai/code-preview.d.ts +28 -0
  136. package/dist/components/scenes/ai/code-preview.js +20 -0
  137. package/dist/components/scenes/ai/document-download.d.ts +52 -0
  138. package/dist/components/scenes/ai/document-download.js +30 -2
  139. package/dist/components/scenes/ai/document-parse.d.ts +71 -14
  140. package/dist/components/scenes/ai/document-parse.js +19 -9
  141. package/dist/components/scenes/ai/document-types.d.ts +222 -88
  142. package/dist/components/scenes/ai/editor-markdown-extensions.d.ts +16 -0
  143. package/dist/components/scenes/ai/editor-markdown-extensions.js +16 -0
  144. package/dist/components/scenes/ai/highlight.d.ts +11 -0
  145. package/dist/components/scenes/ai/highlight.js +11 -0
  146. package/dist/components/scenes/ai/markdown-parse.d.ts +8 -2
  147. package/dist/components/scenes/ai/markdown-parse.js +2 -2
  148. package/dist/components/scenes/ai/mermaid-host-sync.d.ts +38 -0
  149. package/dist/components/scenes/ai/mermaid-host-sync.js +30 -0
  150. package/dist/components/scenes/ai/mermaid-render.d.ts +23 -0
  151. package/dist/components/scenes/ai/mermaid-render.js +23 -0
  152. package/dist/components/scenes/ai/safe-html.d.ts +54 -6
  153. package/dist/components/scenes/ai/safe-html.js +54 -6
  154. package/dist/components/scenes/ai/table/AiTableEditor.svelte +48 -0
  155. package/dist/components/scenes/ai/table/AiTableEditor.svelte.d.ts +24 -0
  156. package/dist/components/scenes/ai/table/table-types.d.ts +79 -0
  157. package/dist/components/scenes/app/FeedbackDetail.svelte +215 -0
  158. package/dist/components/scenes/app/FeedbackDetail.svelte.d.ts +32 -0
  159. package/dist/components/scenes/app/FeedbackForm.svelte +271 -0
  160. package/dist/components/scenes/app/FeedbackForm.svelte.d.ts +61 -0
  161. package/dist/components/scenes/app/FeedbackList.svelte +147 -0
  162. package/dist/components/scenes/app/FeedbackList.svelte.d.ts +28 -0
  163. package/dist/components/scenes/app/FeedbackModal.svelte +27 -163
  164. package/dist/components/scenes/app/FeedbackModal.svelte.d.ts +13 -41
  165. package/dist/components/scenes/app/FeedbackScreenshot.svelte +106 -0
  166. package/dist/components/scenes/app/FeedbackScreenshot.svelte.d.ts +8 -0
  167. package/dist/components/scenes/app/LanguageSwitch.svelte +29 -19
  168. package/dist/components/scenes/app/LanguageSwitch.svelte.d.ts +28 -19
  169. package/dist/components/scenes/app/SettingsLayout.svelte +21 -9
  170. package/dist/components/scenes/app/SettingsLayout.svelte.d.ts +21 -9
  171. package/dist/components/scenes/app/SettingsModal.svelte +23 -0
  172. package/dist/components/scenes/app/SettingsModal.svelte.d.ts +23 -0
  173. package/dist/components/scenes/app/ThemeColorPicker.svelte +31 -0
  174. package/dist/components/scenes/app/ThemeColorPicker.svelte.d.ts +31 -0
  175. package/dist/components/scenes/app/ThemeSelector.svelte +21 -6
  176. package/dist/components/scenes/app/ThemeSelector.svelte.d.ts +21 -6
  177. package/dist/components/scenes/app/ThemeToggle.svelte +21 -4
  178. package/dist/components/scenes/app/ThemeToggle.svelte.d.ts +21 -4
  179. package/dist/components/scenes/app/feedback-functions.d.ts +41 -0
  180. package/dist/components/scenes/app/feedback-functions.js +75 -0
  181. package/dist/components/scenes/app/feedback-types.d.ts +224 -0
  182. package/dist/components/scenes/app/feedback-types.js +1 -0
  183. package/dist/components/scenes/app/index.d.ts +5 -1
  184. package/dist/components/scenes/app/index.js +4 -1
  185. package/dist/components/scenes/charts/Chart.svelte +11 -0
  186. package/dist/components/scenes/charts/Chart.svelte.d.ts +20 -0
  187. package/dist/components/scenes/charts/chart-theme.d.ts +25 -1
  188. package/dist/components/scenes/charts/chart-theme.js +25 -1
  189. package/dist/components/scenes/charts/chart-types.d.ts +83 -7
  190. package/dist/components/scenes/charts/renderers/LineChart.svelte +53 -0
  191. package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +13 -0
  192. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte +10 -0
  193. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte.d.ts +10 -0
  194. package/dist/components/scenes/crud/CrudDetailDrawer.svelte +8 -0
  195. package/dist/components/scenes/crud/CrudDetailDrawer.svelte.d.ts +8 -0
  196. package/dist/components/scenes/crud/CrudDetailPanel.svelte +18 -0
  197. package/dist/components/scenes/crud/CrudDetailPanel.svelte.d.ts +18 -0
  198. package/dist/components/scenes/crud/CrudEditPanel.svelte +10 -0
  199. package/dist/components/scenes/crud/CrudEditPanel.svelte.d.ts +10 -0
  200. package/dist/components/scenes/crud/CrudFilterBar.svelte +18 -0
  201. package/dist/components/scenes/crud/CrudFilterBar.svelte.d.ts +18 -0
  202. package/dist/components/scenes/crud/CrudPage.svelte +37 -5
  203. package/dist/components/scenes/crud/CrudPage.svelte.d.ts +35 -3
  204. package/dist/components/scenes/crud/crud-controller.svelte.d.ts +142 -23
  205. package/dist/components/scenes/crud/crud-controller.svelte.js +22 -11
  206. package/dist/components/scenes/crud/crud-form-validation.d.ts +12 -0
  207. package/dist/components/scenes/crud/crud-form-validation.js +12 -0
  208. package/dist/components/scenes/crud/crud-types.d.ts +79 -8
  209. package/dist/components/scenes/crud/nav-adapter.d.ts +14 -0
  210. package/dist/components/scenes/crud/nav-adapter.js +8 -0
  211. package/dist/components/scenes/crypto/EncryptedInput.svelte +24 -0
  212. package/dist/components/scenes/crypto/EncryptedInput.svelte.d.ts +34 -0
  213. package/dist/components/scenes/crypto/HashDisplay.svelte +11 -0
  214. package/dist/components/scenes/crypto/HashDisplay.svelte.d.ts +21 -0
  215. package/dist/components/scenes/crypto/SignatureDisplay.svelte +11 -0
  216. package/dist/components/scenes/crypto/SignatureDisplay.svelte.d.ts +21 -0
  217. package/dist/components/scenes/error/ErrorPage.svelte +8 -1
  218. package/dist/components/scenes/error/ErrorPage.svelte.d.ts +8 -1
  219. package/dist/components/scenes/error/error-presets.d.ts +40 -4
  220. package/dist/components/scenes/error/error-presets.js +22 -2
  221. package/dist/components/scenes/guide/GuideHost.svelte +27 -0
  222. package/dist/components/scenes/guide/GuideHost.svelte.d.ts +27 -0
  223. package/dist/components/scenes/guide/HelpCenter.svelte +27 -0
  224. package/dist/components/scenes/guide/HelpCenter.svelte.d.ts +27 -0
  225. package/dist/components/scenes/iam/AuthPanel.svelte +26 -2
  226. package/dist/components/scenes/iam/AuthPanel.svelte.d.ts +25 -0
  227. package/dist/components/scenes/iam/AuthShell.svelte +8 -3
  228. package/dist/components/scenes/iam/AuthShell.svelte.d.ts +8 -3
  229. package/dist/components/scenes/iam/ChangePasswordForm.svelte +10 -0
  230. package/dist/components/scenes/iam/ChangePasswordForm.svelte.d.ts +10 -0
  231. package/dist/components/scenes/iam/ForgotPasswordForm.svelte +11 -0
  232. package/dist/components/scenes/iam/ForgotPasswordForm.svelte.d.ts +21 -0
  233. package/dist/components/scenes/iam/LoginForm.svelte +24 -31
  234. package/dist/components/scenes/iam/LoginForm.svelte.d.ts +10 -0
  235. package/dist/components/scenes/iam/PasswordInput.svelte +23 -0
  236. package/dist/components/scenes/iam/PasswordInput.svelte.d.ts +23 -0
  237. package/dist/components/scenes/iam/PermGuard.svelte +21 -11
  238. package/dist/components/scenes/iam/PermGuard.svelte.d.ts +30 -0
  239. package/dist/components/scenes/iam/RegisterForm.svelte +10 -0
  240. package/dist/components/scenes/iam/RegisterForm.svelte.d.ts +10 -0
  241. package/dist/components/scenes/iam/ResetPasswordForm.svelte +10 -0
  242. package/dist/components/scenes/iam/ResetPasswordForm.svelte.d.ts +10 -0
  243. package/dist/components/scenes/iam/UserProfile.svelte +11 -0
  244. package/dist/components/scenes/iam/UserProfile.svelte.d.ts +21 -0
  245. package/dist/components/scenes/iam/auth-error-message.d.ts +10 -0
  246. package/dist/components/scenes/iam/auth-error-message.js +10 -0
  247. package/dist/components/scenes/iam/password-utils.d.ts +39 -1
  248. package/dist/components/scenes/iam/password-utils.js +39 -1
  249. package/dist/components/scenes/iam/permission-context.svelte.d.ts +33 -23
  250. package/dist/components/scenes/iam/permission-context.svelte.js +20 -22
  251. package/dist/components/scenes/storage/AvatarUpload.svelte +11 -0
  252. package/dist/components/scenes/storage/AvatarUpload.svelte.d.ts +20 -0
  253. package/dist/components/scenes/storage/FileList.svelte +13 -2
  254. package/dist/components/scenes/storage/FileList.svelte.d.ts +20 -0
  255. package/dist/components/scenes/storage/FileUpload.svelte +37 -2
  256. package/dist/components/scenes/storage/FileUpload.svelte.d.ts +21 -0
  257. package/dist/components/scenes/storage/ImageUpload.svelte +11 -0
  258. package/dist/components/scenes/storage/ImageUpload.svelte.d.ts +21 -0
  259. package/dist/components/scenes/types.d.ts +352 -11
  260. package/dist/guide-storage.d.ts +13 -1
  261. package/dist/guide-storage.js +13 -1
  262. package/dist/guide-types.d.ts +67 -2
  263. package/dist/guide.svelte.d.ts +22 -1
  264. package/dist/guide.svelte.js +22 -1
  265. package/dist/i18n.svelte.d.ts +64 -3
  266. package/dist/i18n.svelte.js +99 -18
  267. package/dist/index.d.ts +2 -1
  268. package/dist/index.js +1 -2
  269. package/dist/internal/browser-safety.d.ts +51 -2
  270. package/dist/internal/browser-safety.js +45 -7
  271. package/dist/internal/form-context.d.ts +73 -0
  272. package/dist/internal/form-context.js +57 -0
  273. package/dist/internal/form-validation.svelte.d.ts +42 -0
  274. package/dist/internal/form-validation.svelte.js +26 -0
  275. package/dist/internal/icon-safety.d.ts +7 -0
  276. package/dist/internal/icon-safety.js +7 -0
  277. package/dist/internal/locale.d.ts +19 -0
  278. package/dist/internal/locale.js +21 -0
  279. package/dist/message.svelte.d.ts +90 -0
  280. package/dist/message.svelte.js +84 -0
  281. package/dist/messagebox.svelte.d.ts +61 -13
  282. package/dist/messagebox.svelte.js +55 -13
  283. package/dist/messages/en-US.json +80 -2
  284. package/dist/messages/ja-JP.json +462 -0
  285. package/dist/messages/zh-CN.json +80 -2
  286. package/dist/messages.d.ts +24 -3
  287. package/dist/messages.js +18 -3
  288. package/dist/styles/design-tokens.css +4 -2
  289. package/dist/styles/global.css +28 -8
  290. package/dist/styles/theme.css +2 -0
  291. package/dist/theme-config.d.ts +173 -0
  292. package/dist/theme-config.js +143 -0
  293. package/dist/toast.svelte.d.ts +114 -4
  294. package/dist/toast.svelte.js +108 -4
  295. package/dist/types.d.ts +526 -9
  296. package/dist/utils/platform.svelte.d.ts +28 -15
  297. package/dist/utils/platform.svelte.js +19 -14
  298. package/dist/utils.d.ts +102 -0
  299. package/dist/utils.js +93 -0
  300. package/package.json +67 -7
@@ -1,9 +1,30 @@
1
1
  import type { DataAttributes } from '../../../types.js';
2
+ /**
3
+ * 语言选择器候选项;value 使用应用实际支持的 locale 代码。
4
+ *
5
+ * @example 模块内部上下文
6
+ * ```ts
7
+ * const example: Language = { value: 'zh-CN', label: '中文' }
8
+ * ```
9
+ */
2
10
  interface Language {
3
11
  value: string;
4
12
  label: string;
5
13
  flag?: string;
6
14
  }
15
+ /**
16
+ * LanguageSwitch 组件的属性契约;通过公开组件配置使用。
17
+ *
18
+ * @example
19
+ * ```ts
20
+ * import { mount, unmount } from 'svelte'
21
+ * import type { ComponentProps } from 'svelte'
22
+ * import { LanguageSwitch } from '@h-ai/ui'
23
+ * const props: ComponentProps<typeof LanguageSwitch> = { currentLanguage: 'zh-CN', languages: [{ value: 'zh-CN', label: '中文' }, { value: 'en-US', label: 'English' }] }
24
+ * const component = mount(LanguageSwitch, { target: document.body, props })
25
+ * await unmount(component)
26
+ * ```
27
+ */
7
28
  interface Props {
8
29
  /** 当前语言代码(BCP 47 格式) */
9
30
  currentLanguage?: string;
@@ -28,25 +49,13 @@ type $$ComponentProps = Props & DataAttributes;
28
49
  * @prop {function} onchange - 语言变更回调,传入选中的语言代码
29
50
  *
30
51
  * @example
31
- * ```svelte
32
- * <script>
33
- * import { LanguageSwitch, createLocaleStore, setGlobalLocale } from '@h-ai/ui'
34
- * import { setLocale, getLocale } from '$lib/paraglide/runtime.js'
35
- *
36
- * const localeStore = createLocaleStore()
37
- * </script>
38
- *
39
- * <LanguageSwitch
40
- * currentLanguage={localeStore.current}
41
- * languages={[
42
- * { value: 'zh-CN', label: '简体中文' },
43
- * { value: 'en-US', label: 'English' }
44
- * ]}
45
- * onchange={(lang) => {
46
- * localeStore.set(lang) // 同步到 @h-ai/core 全局 locale
47
- * setLocale(lang) // 同步到 Paraglide
48
- * }}
49
- * />
52
+ * ```ts
53
+ * import { mount, unmount } from 'svelte'
54
+ * import type { ComponentProps } from 'svelte'
55
+ * import { LanguageSwitch } from '@h-ai/ui'
56
+ * const props: ComponentProps<typeof LanguageSwitch> = { currentLanguage: 'zh-CN', languages: [{ value: 'zh-CN', label: '中文' }, { value: 'en-US', label: 'English' }] }
57
+ * const component = mount(LanguageSwitch, { target: document.body, props })
58
+ * await unmount(component)
50
59
  * ```
51
60
  */
52
61
  declare const LanguageSwitch: import("svelte").Component<$$ComponentProps, {}, "">;
@@ -8,15 +8,14 @@
8
8
  使用 Svelte 5 Runes ($props, $derived)
9
9
 
10
10
  @example
11
- <SettingsLayout
12
- title="设置"
13
- description="管理你的账户与偏好"
14
- sections={[{ id: 'appearance', label: '外观', icon: 'icon-[tabler--palette]' }]}
15
- active={active}
16
- onselect={(id) => active = id}
17
- >
18
- {#if active === 'appearance'}<AppearanceSection />{/if}
19
- </SettingsLayout>
11
+ ```ts
12
+ import { mount, unmount, createRawSnippet } from 'svelte'
13
+ import type { ComponentProps } from 'svelte'
14
+ import { SettingsLayout } from '@h-ai/ui'
15
+ const props: ComponentProps<typeof SettingsLayout> = { title: '设置', sections: [{ id: 'profile', label: '资料', href: '/settings/profile' }], active: 'profile', children: createRawSnippet(() => ({ render: () => "<p>个人资料设置</p>" })) }
16
+ const component = mount(SettingsLayout, { target: document.body, props })
17
+ await unmount(component)
18
+ ```
20
19
  -->
21
20
  <script lang='ts'>
22
21
  import type { Snippet } from 'svelte'
@@ -24,6 +23,19 @@
24
23
  import { cn, getDataAttributes } from '../../../utils.js'
25
24
  import BareButton from '../../primitives/BareButton.svelte'
26
25
 
26
+ /**
27
+ * 设置页分区导航项;href 直接渲染链接,否则由宿主处理选中事件。
28
+ *
29
+ * @example
30
+ * ```ts
31
+ * import { mount, unmount, createRawSnippet } from 'svelte'
32
+ * import type { ComponentProps } from 'svelte'
33
+ * import { SettingsLayout } from '@h-ai/ui'
34
+ * const props: ComponentProps<typeof SettingsLayout> = { title: '设置', sections: [{ id: 'profile', label: '资料', href: '/settings/profile' }], active: 'profile', children: createRawSnippet(() => ({ render: () => "<p>个人资料设置</p>" })) }
35
+ * const component = mount(SettingsLayout, { target: document.body, props })
36
+ * await unmount(component)
37
+ * ```
38
+ */
27
39
  type SettingsSection = {
28
40
  id: string
29
41
  label: string
@@ -1,5 +1,18 @@
1
1
  import type { Snippet } from 'svelte';
2
2
  import type { DataAttributes } from '../../../types.js';
3
+ /**
4
+ * 设置页分区导航项;href 直接渲染链接,否则由宿主处理选中事件。
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * import { mount, unmount, createRawSnippet } from 'svelte'
9
+ * import type { ComponentProps } from 'svelte'
10
+ * import { SettingsLayout } from '@h-ai/ui'
11
+ * const props: ComponentProps<typeof SettingsLayout> = { title: '设置', sections: [{ id: 'profile', label: '资料', href: '/settings/profile' }], active: 'profile', children: createRawSnippet(() => ({ render: () => "<p>个人资料设置</p>" })) }
12
+ * const component = mount(SettingsLayout, { target: document.body, props })
13
+ * await unmount(component)
14
+ * ```
15
+ */
3
16
  type SettingsSection = {
4
17
  id: string;
5
18
  label: string;
@@ -27,15 +40,14 @@ type $$ComponentProps = {
27
40
  * 使用 Svelte 5 Runes ($props, $derived)
28
41
  *
29
42
  * @example
30
- * <SettingsLayout
31
- * title="设置"
32
- * description="管理你的账户与偏好"
33
- * sections={[{ id: 'appearance', label: '外观', icon: 'icon-[tabler--palette]' }]}
34
- * active={active}
35
- * onselect={(id) => active = id}
36
- * >
37
- * {#if active === 'appearance'}<AppearanceSection />{/if}
38
- * </SettingsLayout>
43
+ * ```ts
44
+ * import { mount, unmount, createRawSnippet } from 'svelte'
45
+ * import type { ComponentProps } from 'svelte'
46
+ * import { SettingsLayout } from '@h-ai/ui'
47
+ * const props: ComponentProps<typeof SettingsLayout> = { title: '设置', sections: [{ id: 'profile', label: '资料', href: '/settings/profile' }], active: 'profile', children: createRawSnippet(() => ({ render: () => "<p>个人资料设置</p>" })) }
48
+ * const component = mount(SettingsLayout, { target: document.body, props })
49
+ * await unmount(component)
50
+ * ```
39
51
  */
40
52
  declare const SettingsLayout: import("svelte").Component<$$ComponentProps, {}, "">;
41
53
  type SettingsLayout = ReturnType<typeof SettingsLayout>;
@@ -8,6 +8,16 @@
8
8
  @prop {string} currentTheme - 当前主题
9
9
  @prop {function} onlanguagechange - 语言变更回调
10
10
  @prop {function} onthemechange - 主题变更回调
11
+
12
+ @example
13
+ ```ts
14
+ import { mount, unmount } from 'svelte'
15
+ import type { ComponentProps } from 'svelte'
16
+ import { SettingsModal } from '@h-ai/ui'
17
+ const props: ComponentProps<typeof SettingsModal> = { open: true, currentLanguage: 'zh-CN', currentTheme: 'light' }
18
+ const component = mount(SettingsModal, { target: document.body, props })
19
+ await unmount(component)
20
+ ```
11
21
  -->
12
22
  <script lang='ts'>
13
23
  import type { DataAttributes } from '../../../types.js'
@@ -16,6 +26,19 @@
16
26
  import BareButton from '../../primitives/BareButton.svelte'
17
27
  import IconButton from '../../primitives/IconButton.svelte'
18
28
 
29
+ /**
30
+ * SettingsModal 组件的属性契约;通过公开组件配置使用。
31
+ *
32
+ * @example
33
+ * ```ts
34
+ * import { mount, unmount } from 'svelte'
35
+ * import type { ComponentProps } from 'svelte'
36
+ * import { SettingsModal } from '@h-ai/ui'
37
+ * const props: ComponentProps<typeof SettingsModal> = { open: true, currentLanguage: 'zh-CN', currentTheme: 'light' }
38
+ * const component = mount(SettingsModal, { target: document.body, props })
39
+ * await unmount(component)
40
+ * ```
41
+ */
19
42
  interface Props {
20
43
  open?: boolean
21
44
  currentLanguage?: string
@@ -1,4 +1,17 @@
1
1
  import type { DataAttributes } from '../../../types.js';
2
+ /**
3
+ * SettingsModal 组件的属性契约;通过公开组件配置使用。
4
+ *
5
+ * @example
6
+ * ```ts
7
+ * import { mount, unmount } from 'svelte'
8
+ * import type { ComponentProps } from 'svelte'
9
+ * import { SettingsModal } from '@h-ai/ui'
10
+ * const props: ComponentProps<typeof SettingsModal> = { open: true, currentLanguage: 'zh-CN', currentTheme: 'light' }
11
+ * const component = mount(SettingsModal, { target: document.body, props })
12
+ * await unmount(component)
13
+ * ```
14
+ */
2
15
  interface Props {
3
16
  open?: boolean;
4
17
  currentLanguage?: string;
@@ -28,6 +41,16 @@ type $$ComponentProps = Props & DataAttributes;
28
41
  * @prop {string} currentTheme - 当前主题
29
42
  * @prop {function} onlanguagechange - 语言变更回调
30
43
  * @prop {function} onthemechange - 主题变更回调
44
+ *
45
+ * @example
46
+ * ```ts
47
+ * import { mount, unmount } from 'svelte'
48
+ * import type { ComponentProps } from 'svelte'
49
+ * import { SettingsModal } from '@h-ai/ui'
50
+ * const props: ComponentProps<typeof SettingsModal> = { open: true, currentLanguage: 'zh-CN', currentTheme: 'light' }
51
+ * const component = mount(SettingsModal, { target: document.body, props })
52
+ * await unmount(component)
53
+ * ```
31
54
  */
32
55
  declare const SettingsModal: import("svelte").Component<$$ComponentProps, {}, "open">;
33
56
  type SettingsModal = ReturnType<typeof SettingsModal>;
@@ -5,6 +5,16 @@
5
5
  @prop {string} value - 当前选中的颜色值(Hex)
6
6
  @prop {Array<{ value: string, label: string }>} presets - 预置主题色列表
7
7
  @prop {function} onchange - 颜色变更回调
8
+
9
+ @example
10
+ ```ts
11
+ import { mount, unmount } from 'svelte'
12
+ import type { ComponentProps } from 'svelte'
13
+ import { ThemeColorPicker } from '@h-ai/ui'
14
+ const props: ComponentProps<typeof ThemeColorPicker> = { value: '#2563eb', presets: [{ value: '#2563eb', label: '蓝色' }] }
15
+ const component = mount(ThemeColorPicker, { target: document.body, props })
16
+ await unmount(component)
17
+ ```
8
18
  -->
9
19
  <script lang='ts'>
10
20
  import type { DataAttributes } from '../../../types.js'
@@ -15,11 +25,32 @@
15
25
  const HEX_COLOR_REGEX = /^#[0-9a-f]{6}$/
16
26
  const SHORT_HEX_COLOR_REGEX = /^#[0-9a-f]{3}$/
17
27
 
28
+ /**
29
+ * 主题色选择器的显示名称与 Hex 值。
30
+ *
31
+ * @example 模块内部上下文
32
+ * ```ts
33
+ * const example: ThemeColorPreset = { value: '#2563eb', label: '蓝色' }
34
+ * ```
35
+ */
18
36
  interface ThemeColorPreset {
19
37
  value: string
20
38
  label: string
21
39
  }
22
40
 
41
+ /**
42
+ * ThemeColorPicker 组件的属性契约;通过公开组件配置使用。
43
+ *
44
+ * @example
45
+ * ```ts
46
+ * import { mount, unmount } from 'svelte'
47
+ * import type { ComponentProps } from 'svelte'
48
+ * import { ThemeColorPicker } from '@h-ai/ui'
49
+ * const props: ComponentProps<typeof ThemeColorPicker> = { value: '#2563eb', presets: [{ value: '#2563eb', label: '蓝色' }] }
50
+ * const component = mount(ThemeColorPicker, { target: document.body, props })
51
+ * await unmount(component)
52
+ * ```
53
+ */
23
54
  interface Props {
24
55
  value?: string
25
56
  presets?: ThemeColorPreset[]
@@ -1,8 +1,29 @@
1
1
  import type { DataAttributes } from '../../../types.js';
2
+ /**
3
+ * 主题色选择器的显示名称与 Hex 值。
4
+ *
5
+ * @example 模块内部上下文
6
+ * ```ts
7
+ * const example: ThemeColorPreset = { value: '#2563eb', label: '蓝色' }
8
+ * ```
9
+ */
2
10
  interface ThemeColorPreset {
3
11
  value: string;
4
12
  label: string;
5
13
  }
14
+ /**
15
+ * ThemeColorPicker 组件的属性契约;通过公开组件配置使用。
16
+ *
17
+ * @example
18
+ * ```ts
19
+ * import { mount, unmount } from 'svelte'
20
+ * import type { ComponentProps } from 'svelte'
21
+ * import { ThemeColorPicker } from '@h-ai/ui'
22
+ * const props: ComponentProps<typeof ThemeColorPicker> = { value: '#2563eb', presets: [{ value: '#2563eb', label: '蓝色' }] }
23
+ * const component = mount(ThemeColorPicker, { target: document.body, props })
24
+ * await unmount(component)
25
+ * ```
26
+ */
6
27
  interface Props {
7
28
  value?: string;
8
29
  presets?: ThemeColorPreset[];
@@ -20,6 +41,16 @@ type $$ComponentProps = Props & DataAttributes;
20
41
  * @prop {string} value - 当前选中的颜色值(Hex)
21
42
  * @prop {Array<{ value: string, label: string }>} presets - 预置主题色列表
22
43
  * @prop {function} onchange - 颜色变更回调
44
+ *
45
+ * @example
46
+ * ```ts
47
+ * import { mount, unmount } from 'svelte'
48
+ * import type { ComponentProps } from 'svelte'
49
+ * import { ThemeColorPicker } from '@h-ai/ui'
50
+ * const props: ComponentProps<typeof ThemeColorPicker> = { value: '#2563eb', presets: [{ value: '#2563eb', label: '蓝色' }] }
51
+ * const component = mount(ThemeColorPicker, { target: document.body, props })
52
+ * await unmount(component)
53
+ * ```
23
54
  */
24
55
  declare const ThemeColorPicker: import("svelte").Component<$$ComponentProps, {}, "">;
25
56
  type ThemeColorPicker = ReturnType<typeof ThemeColorPicker>;
@@ -8,12 +8,14 @@
8
8
  @prop {boolean} grouped - 是否按分组显示
9
9
 
10
10
  @example
11
- <ThemeSelector
12
- currentTheme={$theme}
13
- onchange={(theme) => setTheme(theme)}
14
- showPreview
15
- grouped
16
- />
11
+ ```ts
12
+ import { mount, unmount } from 'svelte'
13
+ import type { ComponentProps } from 'svelte'
14
+ import { ThemeSelector } from '@h-ai/ui'
15
+ const props: ComponentProps<typeof ThemeSelector> = { currentTheme: 'light', grouped: true }
16
+ const component = mount(ThemeSelector, { target: document.body, props })
17
+ await unmount(component)
18
+ ```
17
19
  -->
18
20
  <script lang='ts'>
19
21
  import type { ThemeInfo } from '../../../theme-config.js'
@@ -23,6 +25,19 @@
23
25
  import { cn, getDataAttributes } from '../../../utils.js'
24
26
  import BareButton from '../../primitives/BareButton.svelte'
25
27
 
28
+ /**
29
+ * ThemeSelector 组件的属性契约;通过公开组件配置使用。
30
+ *
31
+ * @example
32
+ * ```ts
33
+ * import { mount, unmount } from 'svelte'
34
+ * import type { ComponentProps } from 'svelte'
35
+ * import { ThemeSelector } from '@h-ai/ui'
36
+ * const props: ComponentProps<typeof ThemeSelector> = { currentTheme: 'light', grouped: true }
37
+ * const component = mount(ThemeSelector, { target: document.body, props })
38
+ * await unmount(component)
39
+ * ```
40
+ */
26
41
  interface Props {
27
42
  currentTheme?: string
28
43
  /** 选择主题按钮的 aria-label */
@@ -1,4 +1,17 @@
1
1
  import type { DataAttributes } from '../../../types.js';
2
+ /**
3
+ * ThemeSelector 组件的属性契约;通过公开组件配置使用。
4
+ *
5
+ * @example
6
+ * ```ts
7
+ * import { mount, unmount } from 'svelte'
8
+ * import type { ComponentProps } from 'svelte'
9
+ * import { ThemeSelector } from '@h-ai/ui'
10
+ * const props: ComponentProps<typeof ThemeSelector> = { currentTheme: 'light', grouped: true }
11
+ * const component = mount(ThemeSelector, { target: document.body, props })
12
+ * await unmount(component)
13
+ * ```
14
+ */
2
15
  interface Props {
3
16
  currentTheme?: string;
4
17
  /** 选择主题按钮的 aria-label */
@@ -23,12 +36,14 @@ type $$ComponentProps = Props & DataAttributes;
23
36
  * @prop {boolean} grouped - 是否按分组显示
24
37
  *
25
38
  * @example
26
- * <ThemeSelector
27
- * currentTheme={$theme}
28
- * onchange={(theme) => setTheme(theme)}
29
- * showPreview
30
- * grouped
31
- * />
39
+ * ```ts
40
+ * import { mount, unmount } from 'svelte'
41
+ * import type { ComponentProps } from 'svelte'
42
+ * import { ThemeSelector } from '@h-ai/ui'
43
+ * const props: ComponentProps<typeof ThemeSelector> = { currentTheme: 'light', grouped: true }
44
+ * const component = mount(ThemeSelector, { target: document.body, props })
45
+ * await unmount(component)
46
+ * ```
32
47
  */
33
48
  declare const ThemeSelector: import("svelte").Component<$$ComponentProps, {}, "">;
34
49
  type ThemeSelector = ReturnType<typeof ThemeSelector>;
@@ -8,10 +8,14 @@
8
8
  @prop {string} darkTheme - 暗色主题名称
9
9
 
10
10
  @example
11
- <ThemeToggle
12
- currentTheme={$theme}
13
- onchange={(theme) => themeStore.set(theme)}
14
- />
11
+ ```ts
12
+ import { mount, unmount } from 'svelte'
13
+ import type { ComponentProps } from 'svelte'
14
+ import { ThemeToggle } from '@h-ai/ui'
15
+ const props: ComponentProps<typeof ThemeToggle> = { currentTheme: 'light', lightTheme: 'light', darkTheme: 'dark' }
16
+ const component = mount(ThemeToggle, { target: document.body, props })
17
+ await unmount(component)
18
+ ```
15
19
  -->
16
20
  <script lang='ts'>
17
21
  import type { DataAttributes } from '../../../types.js'
@@ -20,6 +24,19 @@
20
24
  import { getDataAttributes } from '../../../utils.js'
21
25
  import IconButton from '../../primitives/IconButton.svelte'
22
26
 
27
+ /**
28
+ * ThemeToggle 组件的属性契约;通过公开组件配置使用。
29
+ *
30
+ * @example
31
+ * ```ts
32
+ * import { mount, unmount } from 'svelte'
33
+ * import type { ComponentProps } from 'svelte'
34
+ * import { ThemeToggle } from '@h-ai/ui'
35
+ * const props: ComponentProps<typeof ThemeToggle> = { currentTheme: 'light', lightTheme: 'light', darkTheme: 'dark' }
36
+ * const component = mount(ThemeToggle, { target: document.body, props })
37
+ * await unmount(component)
38
+ * ```
39
+ */
23
40
  interface Props {
24
41
  currentTheme?: string
25
42
  onchange?: (theme: string) => void
@@ -1,4 +1,17 @@
1
1
  import type { DataAttributes } from '../../../types.js';
2
+ /**
3
+ * ThemeToggle 组件的属性契约;通过公开组件配置使用。
4
+ *
5
+ * @example
6
+ * ```ts
7
+ * import { mount, unmount } from 'svelte'
8
+ * import type { ComponentProps } from 'svelte'
9
+ * import { ThemeToggle } from '@h-ai/ui'
10
+ * const props: ComponentProps<typeof ThemeToggle> = { currentTheme: 'light', lightTheme: 'light', darkTheme: 'dark' }
11
+ * const component = mount(ThemeToggle, { target: document.body, props })
12
+ * await unmount(component)
13
+ * ```
14
+ */
2
15
  interface Props {
3
16
  currentTheme?: string;
4
17
  onchange?: (theme: string) => void;
@@ -21,10 +34,14 @@ type $$ComponentProps = Props & DataAttributes;
21
34
  * @prop {string} darkTheme - 暗色主题名称
22
35
  *
23
36
  * @example
24
- * <ThemeToggle
25
- * currentTheme={$theme}
26
- * onchange={(theme) => themeStore.set(theme)}
27
- * />
37
+ * ```ts
38
+ * import { mount, unmount } from 'svelte'
39
+ * import type { ComponentProps } from 'svelte'
40
+ * import { ThemeToggle } from '@h-ai/ui'
41
+ * const props: ComponentProps<typeof ThemeToggle> = { currentTheme: 'light', lightTheme: 'light', darkTheme: 'dark' }
42
+ * const component = mount(ThemeToggle, { target: document.body, props })
43
+ * await unmount(component)
44
+ * ```
28
45
  */
29
46
  declare const ThemeToggle: import("svelte").Component<$$ComponentProps, {}, "">;
30
47
  type ThemeToggle = ReturnType<typeof ThemeToggle>;
@@ -0,0 +1,41 @@
1
+ import type { FeedbackReportView } from './feedback-types.js';
2
+ /**
3
+ * 解析材料状态,不把受理或邮件服务受理误作最终完成。
4
+ * @example 模块内部上下文
5
+ * ```ts
6
+ * const label = collectionLabel('collecting')
7
+ * ```
8
+ */
9
+ export declare function collectionLabel(status: FeedbackReportView['collectionStatus']): string;
10
+ /**
11
+ * 解析通知状态。
12
+ * @example 模块内部上下文
13
+ * ```ts
14
+ * const label = notificationLabel('pending')
15
+ * ```
16
+ */
17
+ export declare function notificationLabel(status: FeedbackReportView['notificationStatus']): string;
18
+ /**
19
+ * 按当前语言显示时间,不改变原始时间戳。
20
+ * @example 模块内部上下文
21
+ * ```ts
22
+ * const time = feedbackTime(1_730_000_000_000)
23
+ * ```
24
+ */
25
+ export declare function feedbackTime(timestamp: number): string;
26
+ /**
27
+ * 以文本显示 JSON,不将诊断材料解释为 HTML。
28
+ * @example 模块内部上下文
29
+ * ```ts
30
+ * const text = evidenceText({ kind: 'log', message: '<script>' })
31
+ * ```
32
+ */
33
+ export declare function evidenceText(value: Record<string, unknown>): string;
34
+ /**
35
+ * 预览只允许图片 URL 使用的安全协议;宿主仍负责取得授权。
36
+ * @example 模块内部上下文
37
+ * ```ts
38
+ * const preview = imagePreviewUrl('/api/feedback/reports/f1/attachments/a1')
39
+ * ```
40
+ */
41
+ export declare function imagePreviewUrl(url?: string): string | undefined;
@@ -0,0 +1,75 @@
1
+ import { getUILocale, uiM } from '../../../messages.js';
2
+ const collectionKeys = {
3
+ collecting: 'feedback_collecting',
4
+ complete: 'feedback_complete',
5
+ partial: 'feedback_partial',
6
+ failed: 'feedback_failed',
7
+ };
8
+ const notificationKeys = {
9
+ pending: 'feedback_notification_pending',
10
+ sending: 'feedback_notification_sending',
11
+ sent: 'feedback_notification_sent',
12
+ deferred: 'feedback_notification_deferred',
13
+ failed: 'feedback_notification_failed',
14
+ };
15
+ /**
16
+ * 解析材料状态,不把受理或邮件服务受理误作最终完成。
17
+ * @example 模块内部上下文
18
+ * ```ts
19
+ * const label = collectionLabel('collecting')
20
+ * ```
21
+ */
22
+ export function collectionLabel(status) {
23
+ return uiM(collectionKeys[status]);
24
+ }
25
+ /**
26
+ * 解析通知状态。
27
+ * @example 模块内部上下文
28
+ * ```ts
29
+ * const label = notificationLabel('pending')
30
+ * ```
31
+ */
32
+ export function notificationLabel(status) {
33
+ return uiM(notificationKeys[status]);
34
+ }
35
+ /**
36
+ * 按当前语言显示时间,不改变原始时间戳。
37
+ * @example 模块内部上下文
38
+ * ```ts
39
+ * const time = feedbackTime(1_730_000_000_000)
40
+ * ```
41
+ */
42
+ export function feedbackTime(timestamp) {
43
+ return Number.isFinite(timestamp) ? new Date(timestamp).toLocaleString(getUILocale()) : '—';
44
+ }
45
+ /**
46
+ * 以文本显示 JSON,不将诊断材料解释为 HTML。
47
+ * @example 模块内部上下文
48
+ * ```ts
49
+ * const text = evidenceText({ kind: 'log', message: '<script>' })
50
+ * ```
51
+ */
52
+ export function evidenceText(value) {
53
+ try {
54
+ return JSON.stringify(value, null, 2);
55
+ }
56
+ catch {
57
+ return uiM('feedback_missing');
58
+ }
59
+ }
60
+ /**
61
+ * 预览只允许图片 URL 使用的安全协议;宿主仍负责取得授权。
62
+ * @example 模块内部上下文
63
+ * ```ts
64
+ * const preview = imagePreviewUrl('/api/feedback/reports/f1/attachments/a1')
65
+ * ```
66
+ */
67
+ export function imagePreviewUrl(url) {
68
+ if (!url)
69
+ return undefined;
70
+ if (url.startsWith('/') && !url.startsWith('//'))
71
+ return url;
72
+ if (/^(?:blob:|https?:\/\/)/i.test(url))
73
+ return url;
74
+ return undefined;
75
+ }