@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.
Files changed (380) hide show
  1. package/README.en.md +1062 -0
  2. package/README.ja.md +1062 -0
  3. package/README.md +696 -119
  4. package/auto-import.d.ts +49 -0
  5. package/auto-import.js +51 -69
  6. package/dist/components/compounds/Accordion.svelte +30 -3
  7. package/dist/components/compounds/Accordion.svelte.d.ts +37 -1
  8. package/dist/components/compounds/ActionSheet.svelte +35 -8
  9. package/dist/components/compounds/ActionSheet.svelte.d.ts +41 -1
  10. package/dist/components/compounds/Alert.svelte +24 -15
  11. package/dist/components/compounds/Alert.svelte.d.ts +14 -3
  12. package/dist/components/compounds/AppBar.svelte +37 -9
  13. package/dist/components/compounds/AppBar.svelte.d.ts +36 -1
  14. package/dist/components/compounds/BottomNav.svelte +68 -8
  15. package/dist/components/compounds/BottomNav.svelte.d.ts +51 -1
  16. package/dist/components/compounds/Breadcrumb.svelte +18 -5
  17. package/dist/components/compounds/Breadcrumb.svelte.d.ts +23 -2
  18. package/dist/components/compounds/Calendar.svelte +31 -12
  19. package/dist/components/compounds/Calendar.svelte.d.ts +23 -7
  20. package/dist/components/compounds/Card.svelte +17 -5
  21. package/dist/components/compounds/Card.svelte.d.ts +13 -2
  22. package/dist/components/compounds/Combobox.svelte +124 -42
  23. package/dist/components/compounds/Combobox.svelte.d.ts +42 -20
  24. package/dist/components/compounds/Confirm.svelte +32 -9
  25. package/dist/components/compounds/Confirm.svelte.d.ts +24 -2
  26. package/dist/components/compounds/DataTable.svelte +317 -33
  27. package/dist/components/compounds/DataTable.svelte.d.ts +28 -14
  28. package/dist/components/compounds/DatePicker.svelte +62 -18
  29. package/dist/components/compounds/DatePicker.svelte.d.ts +27 -8
  30. package/dist/components/compounds/Drawer.svelte +179 -22
  31. package/dist/components/compounds/Drawer.svelte.d.ts +24 -2
  32. package/dist/components/compounds/Dropdown.svelte +19 -5
  33. package/dist/components/compounds/Dropdown.svelte.d.ts +13 -2
  34. package/dist/components/compounds/Empty.svelte +22 -9
  35. package/dist/components/compounds/Empty.svelte.d.ts +23 -2
  36. package/dist/components/compounds/FilterBar.svelte +82 -0
  37. package/dist/components/compounds/FilterBar.svelte.d.ts +39 -0
  38. package/dist/components/compounds/Form.svelte +59 -16
  39. package/dist/components/compounds/Form.svelte.d.ts +23 -2
  40. package/dist/components/compounds/FormField.svelte +99 -16
  41. package/dist/components/compounds/FormField.svelte.d.ts +23 -2
  42. package/dist/components/compounds/FormLayout.svelte +71 -0
  43. package/dist/components/compounds/FormLayout.svelte.d.ts +17 -0
  44. package/dist/components/compounds/InfiniteScroll.svelte +34 -7
  45. package/dist/components/compounds/InfiniteScroll.svelte.d.ts +37 -1
  46. package/dist/components/compounds/JsonViewer.svelte +214 -0
  47. package/dist/components/compounds/JsonViewer.svelte.d.ts +26 -0
  48. package/dist/components/compounds/MessageBoxContainer.svelte +34 -0
  49. package/dist/components/compounds/MessageBoxContainer.svelte.d.ts +25 -0
  50. package/dist/components/compounds/MessageBoxDialog.svelte +209 -0
  51. package/dist/components/compounds/MessageBoxDialog.svelte.d.ts +29 -0
  52. package/dist/components/compounds/MessageContainer.svelte +24 -0
  53. package/dist/components/compounds/MessageContainer.svelte.d.ts +18 -0
  54. package/dist/components/compounds/Modal.svelte +348 -73
  55. package/dist/components/compounds/Modal.svelte.d.ts +13 -2
  56. package/dist/components/compounds/PageHeader.svelte +44 -20
  57. package/dist/components/compounds/PageHeader.svelte.d.ts +24 -9
  58. package/dist/components/compounds/Pagination.svelte +139 -105
  59. package/dist/components/compounds/Pagination.svelte.d.ts +23 -2
  60. package/dist/components/compounds/Popover.svelte +124 -25
  61. package/dist/components/compounds/Popover.svelte.d.ts +23 -2
  62. package/dist/components/compounds/PullRefresh.svelte +35 -8
  63. package/dist/components/compounds/PullRefresh.svelte.d.ts +35 -1
  64. package/dist/components/compounds/Result.svelte +17 -4
  65. package/dist/components/compounds/Result.svelte.d.ts +23 -2
  66. package/dist/components/compounds/SafeArea.svelte +30 -3
  67. package/dist/components/compounds/SafeArea.svelte.d.ts +35 -1
  68. package/dist/components/compounds/Skeleton.svelte +19 -7
  69. package/dist/components/compounds/Skeleton.svelte.d.ts +13 -2
  70. package/dist/components/compounds/Steps.svelte +17 -4
  71. package/dist/components/compounds/Steps.svelte.d.ts +23 -2
  72. package/dist/components/compounds/SwipeCell.svelte +30 -3
  73. package/dist/components/compounds/SwipeCell.svelte.d.ts +40 -1
  74. package/dist/components/compounds/TableToolbar.svelte +289 -0
  75. package/dist/components/compounds/TableToolbar.svelte.d.ts +69 -0
  76. package/dist/components/compounds/Tabs.svelte +84 -14
  77. package/dist/components/compounds/Tabs.svelte.d.ts +13 -2
  78. package/dist/components/compounds/TagInput.svelte +51 -33
  79. package/dist/components/compounds/TagInput.svelte.d.ts +23 -2
  80. package/dist/components/compounds/Timeline.svelte +30 -3
  81. package/dist/components/compounds/Timeline.svelte.d.ts +37 -1
  82. package/dist/components/compounds/ToastContainer.svelte +397 -28
  83. package/dist/components/compounds/ToastContainer.svelte.d.ts +27 -1
  84. package/dist/components/compounds/Tooltip.svelte +143 -9
  85. package/dist/components/compounds/Tooltip.svelte.d.ts +25 -2
  86. package/dist/components/compounds/accordion-types.d.ts +10 -1
  87. package/dist/components/compounds/action-sheet-types.d.ts +9 -0
  88. package/dist/components/compounds/bottom-nav-types.d.ts +9 -0
  89. package/dist/components/compounds/index.d.ts +7 -0
  90. package/dist/components/compounds/index.js +11 -0
  91. package/dist/components/compounds/swipe-cell-types.d.ts +9 -0
  92. package/dist/components/compounds/timeline-types.d.ts +9 -0
  93. package/dist/components/control-size.d.ts +35 -0
  94. package/dist/components/control-size.js +26 -0
  95. package/dist/components/primitives/Avatar.svelte +19 -5
  96. package/dist/components/primitives/Avatar.svelte.d.ts +13 -2
  97. package/dist/components/primitives/Badge.svelte +16 -4
  98. package/dist/components/primitives/Badge.svelte.d.ts +13 -2
  99. package/dist/components/primitives/BareButton.svelte +26 -12
  100. package/dist/components/primitives/BareButton.svelte.d.ts +23 -2
  101. package/dist/components/primitives/BareInput.svelte +57 -35
  102. package/dist/components/primitives/BareInput.svelte.d.ts +23 -2
  103. package/dist/components/primitives/Button.svelte +30 -9
  104. package/dist/components/primitives/Button.svelte.d.ts +13 -2
  105. package/dist/components/primitives/Checkbox.svelte +24 -5
  106. package/dist/components/primitives/Checkbox.svelte.d.ts +23 -2
  107. package/dist/components/primitives/IconButton.svelte +35 -10
  108. package/dist/components/primitives/IconButton.svelte.d.ts +23 -2
  109. package/dist/components/primitives/Input.svelte +56 -26
  110. package/dist/components/primitives/Input.svelte.d.ts +13 -2
  111. package/dist/components/primitives/Progress.svelte +17 -4
  112. package/dist/components/primitives/Progress.svelte.d.ts +23 -2
  113. package/dist/components/primitives/Radio.svelte +17 -4
  114. package/dist/components/primitives/Radio.svelte.d.ts +22 -2
  115. package/dist/components/primitives/Range.svelte +31 -4
  116. package/dist/components/primitives/Range.svelte.d.ts +37 -1
  117. package/dist/components/primitives/Rating.svelte +32 -5
  118. package/dist/components/primitives/Rating.svelte.d.ts +37 -1
  119. package/dist/components/primitives/Select.svelte +404 -47
  120. package/dist/components/primitives/Select.svelte.d.ts +23 -2
  121. package/dist/components/primitives/Spinner.svelte +17 -4
  122. package/dist/components/primitives/Spinner.svelte.d.ts +23 -2
  123. package/dist/components/primitives/Switch.svelte +22 -4
  124. package/dist/components/primitives/Switch.svelte.d.ts +23 -2
  125. package/dist/components/primitives/Tag.svelte +17 -4
  126. package/dist/components/primitives/Tag.svelte.d.ts +23 -2
  127. package/dist/components/primitives/Textarea.svelte +75 -30
  128. package/dist/components/primitives/Textarea.svelte.d.ts +24 -2
  129. package/dist/components/primitives/ToggleCheckbox.svelte +24 -10
  130. package/dist/components/primitives/ToggleCheckbox.svelte.d.ts +23 -2
  131. package/dist/components/primitives/ToggleInput.svelte +24 -10
  132. package/dist/components/primitives/ToggleInput.svelte.d.ts +23 -2
  133. package/dist/components/primitives/ToggleRadio.svelte +24 -10
  134. package/dist/components/primitives/ToggleRadio.svelte.d.ts +23 -2
  135. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte +54 -23
  136. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte.d.ts +30 -1
  137. package/dist/components/scenes/ai/AiDocumentEditor.svelte +3428 -693
  138. package/dist/components/scenes/ai/AiDocumentEditor.svelte.d.ts +26 -1
  139. package/dist/components/scenes/ai/MarkdownRenderer.svelte +119 -116
  140. package/dist/components/scenes/ai/MarkdownRenderer.svelte.d.ts +31 -1
  141. package/dist/components/scenes/ai/code-preview.d.ts +46 -0
  142. package/dist/components/scenes/ai/code-preview.js +141 -0
  143. package/dist/components/scenes/ai/document-download.d.ts +52 -0
  144. package/dist/components/scenes/ai/document-download.js +300 -79
  145. package/dist/components/scenes/ai/document-parse.d.ts +101 -11
  146. package/dist/components/scenes/ai/document-parse.js +212 -48
  147. package/dist/components/scenes/ai/document-types.d.ts +292 -75
  148. package/dist/components/scenes/ai/editor-markdown-extensions.d.ts +27 -0
  149. package/dist/components/scenes/ai/editor-markdown-extensions.js +216 -0
  150. package/dist/components/scenes/ai/highlight.d.ts +37 -0
  151. package/dist/components/scenes/ai/highlight.js +177 -0
  152. package/dist/components/scenes/ai/index.d.ts +5 -2
  153. package/dist/components/scenes/ai/index.js +3 -0
  154. package/dist/components/scenes/ai/markdown-parse.d.ts +11 -3
  155. package/dist/components/scenes/ai/markdown-parse.js +85 -47
  156. package/dist/components/scenes/ai/mermaid-host-sync.d.ts +72 -0
  157. package/dist/components/scenes/ai/mermaid-host-sync.js +65 -0
  158. package/dist/components/scenes/ai/mermaid-render.d.ts +30 -0
  159. package/dist/components/scenes/ai/mermaid-render.js +61 -0
  160. package/dist/components/scenes/ai/safe-html.d.ts +64 -0
  161. package/dist/components/scenes/ai/safe-html.js +345 -0
  162. package/dist/components/scenes/ai/table/AiTableEditor.svelte +1692 -0
  163. package/dist/components/scenes/ai/table/AiTableEditor.svelte.d.ts +32 -0
  164. package/dist/components/scenes/ai/table/table-types.d.ts +181 -0
  165. package/dist/components/scenes/ai/table/table-types.js +1 -0
  166. package/dist/components/scenes/app/FeedbackDetail.svelte +236 -0
  167. package/dist/components/scenes/app/FeedbackDetail.svelte.d.ts +40 -0
  168. package/dist/components/scenes/app/FeedbackForm.svelte +337 -0
  169. package/dist/components/scenes/app/FeedbackForm.svelte.d.ts +72 -0
  170. package/dist/components/scenes/app/FeedbackList.svelte +150 -0
  171. package/dist/components/scenes/app/FeedbackList.svelte.d.ts +28 -0
  172. package/dist/components/scenes/app/FeedbackModal.svelte +65 -139
  173. package/dist/components/scenes/app/FeedbackModal.svelte.d.ts +14 -39
  174. package/dist/components/scenes/app/FeedbackRecorder.svelte +154 -0
  175. package/dist/components/scenes/app/FeedbackRecorder.svelte.d.ts +9 -0
  176. package/dist/components/scenes/app/FeedbackReplay.svelte +142 -0
  177. package/dist/components/scenes/app/FeedbackReplay.svelte.d.ts +7 -0
  178. package/dist/components/scenes/app/FeedbackScreenshot.svelte +120 -0
  179. package/dist/components/scenes/app/FeedbackScreenshot.svelte.d.ts +8 -0
  180. package/dist/components/scenes/app/LanguageSwitch.svelte +38 -21
  181. package/dist/components/scenes/app/LanguageSwitch.svelte.d.ts +33 -20
  182. package/dist/components/scenes/app/SettingsLayout.svelte +115 -0
  183. package/dist/components/scenes/app/SettingsLayout.svelte.d.ts +54 -0
  184. package/dist/components/scenes/app/SettingsModal.svelte +33 -7
  185. package/dist/components/scenes/app/SettingsModal.svelte.d.ts +27 -1
  186. package/dist/components/scenes/app/ThemeColorPicker.svelte +240 -0
  187. package/dist/components/scenes/app/ThemeColorPicker.svelte.d.ts +57 -0
  188. package/dist/components/scenes/app/ThemeSelector.svelte +87 -26
  189. package/dist/components/scenes/app/ThemeSelector.svelte.d.ts +26 -7
  190. package/dist/components/scenes/app/ThemeToggle.svelte +27 -6
  191. package/dist/components/scenes/app/ThemeToggle.svelte.d.ts +24 -5
  192. package/dist/components/scenes/app/WorkspaceLayout.svelte +64 -0
  193. package/dist/components/scenes/app/WorkspaceLayout.svelte.d.ts +36 -0
  194. package/dist/components/scenes/app/feedback-functions.d.ts +57 -0
  195. package/dist/components/scenes/app/feedback-functions.js +107 -0
  196. package/dist/components/scenes/app/feedback-types.d.ts +224 -0
  197. package/dist/components/scenes/app/feedback-types.js +1 -0
  198. package/dist/components/scenes/app/index.d.ts +8 -1
  199. package/dist/components/scenes/app/index.js +7 -1
  200. package/dist/components/scenes/charts/Chart.svelte +186 -0
  201. package/dist/components/scenes/charts/Chart.svelte.d.ts +24 -0
  202. package/dist/components/scenes/charts/ChartLoadError.svelte +13 -0
  203. package/dist/components/scenes/charts/ChartLoadError.svelte.d.ts +6 -0
  204. package/dist/components/scenes/charts/DashboardGrid.svelte +34 -0
  205. package/dist/components/scenes/charts/DashboardGrid.svelte.d.ts +15 -0
  206. package/dist/components/scenes/charts/MetricCard.svelte +52 -0
  207. package/dist/components/scenes/charts/MetricCard.svelte.d.ts +15 -0
  208. package/dist/components/scenes/charts/ReportCard.svelte +48 -0
  209. package/dist/components/scenes/charts/ReportCard.svelte.d.ts +15 -0
  210. package/dist/components/scenes/charts/chart-presets.d.ts +15 -0
  211. package/dist/components/scenes/charts/chart-presets.js +19 -0
  212. package/dist/components/scenes/charts/chart-theme.d.ts +47 -0
  213. package/dist/components/scenes/charts/chart-theme.js +68 -0
  214. package/dist/components/scenes/charts/chart-types.d.ts +164 -0
  215. package/dist/components/scenes/charts/chart-types.js +7 -0
  216. package/dist/components/scenes/charts/dashboard-types.d.ts +79 -0
  217. package/dist/components/scenes/charts/dashboard-types.js +1 -0
  218. package/dist/components/scenes/charts/index.d.ts +12 -0
  219. package/dist/components/scenes/charts/index.js +10 -0
  220. package/dist/components/scenes/charts/renderers/AreaChart.svelte +19 -0
  221. package/dist/components/scenes/charts/renderers/AreaChart.svelte.d.ts +6 -0
  222. package/dist/components/scenes/charts/renderers/BarChart.svelte +19 -0
  223. package/dist/components/scenes/charts/renderers/BarChart.svelte.d.ts +6 -0
  224. package/dist/components/scenes/charts/renderers/LineChart.svelte +625 -0
  225. package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +33 -0
  226. package/dist/components/scenes/charts/renderers/PieChart.svelte +19 -0
  227. package/dist/components/scenes/charts/renderers/PieChart.svelte.d.ts +6 -0
  228. package/dist/components/scenes/charts/renderers/ScatterChart.svelte +19 -0
  229. package/dist/components/scenes/charts/renderers/ScatterChart.svelte.d.ts +6 -0
  230. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte +29 -11
  231. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte.d.ts +13 -1
  232. package/dist/components/scenes/crud/CrudDetailDrawer.svelte +77 -22
  233. package/dist/components/scenes/crud/CrudDetailDrawer.svelte.d.ts +19 -4
  234. package/dist/components/scenes/crud/CrudDetailPanel.svelte +242 -0
  235. package/dist/components/scenes/crud/CrudDetailPanel.svelte.d.ts +66 -0
  236. package/dist/components/scenes/crud/CrudEditPanel.svelte +365 -0
  237. package/dist/components/scenes/crud/CrudEditPanel.svelte.d.ts +48 -0
  238. package/dist/components/scenes/crud/CrudFilterBar.svelte +17 -85
  239. package/dist/components/scenes/crud/CrudFilterBar.svelte.d.ts +13 -25
  240. package/dist/components/scenes/crud/CrudPage.svelte +564 -185
  241. package/dist/components/scenes/crud/CrudPage.svelte.d.ts +137 -51
  242. package/dist/components/scenes/crud/crud-controller.svelte.d.ts +335 -0
  243. package/dist/components/scenes/crud/crud-controller.svelte.js +276 -0
  244. package/dist/components/scenes/crud/crud-form-validation.d.ts +16 -0
  245. package/dist/components/scenes/crud/crud-form-validation.js +51 -0
  246. package/dist/components/scenes/crud/crud-types.d.ts +136 -43
  247. package/dist/components/scenes/crud/index.d.ts +9 -3
  248. package/dist/components/scenes/crud/index.js +8 -3
  249. package/dist/components/scenes/crud/nav-adapter.d.ts +50 -0
  250. package/dist/components/scenes/crud/nav-adapter.js +39 -0
  251. package/dist/components/scenes/crypto/EncryptedInput.svelte +63 -28
  252. package/dist/components/scenes/crypto/EncryptedInput.svelte.d.ts +38 -3
  253. package/dist/components/scenes/crypto/HashDisplay.svelte +30 -22
  254. package/dist/components/scenes/crypto/HashDisplay.svelte.d.ts +24 -1
  255. package/dist/components/scenes/crypto/SignatureDisplay.svelte +41 -40
  256. package/dist/components/scenes/crypto/SignatureDisplay.svelte.d.ts +24 -1
  257. package/dist/components/scenes/error/ErrorPage.svelte +135 -0
  258. package/dist/components/scenes/error/ErrorPage.svelte.d.ts +50 -0
  259. package/dist/components/scenes/error/error-presets.d.ts +60 -0
  260. package/dist/components/scenes/error/error-presets.js +51 -0
  261. package/dist/components/scenes/error/index.d.ts +8 -0
  262. package/dist/components/scenes/error/index.js +8 -0
  263. package/dist/components/scenes/guide/GuideHost.svelte +56 -0
  264. package/dist/components/scenes/guide/GuideHost.svelte.d.ts +35 -0
  265. package/dist/components/scenes/guide/GuideHostContent.svelte +136 -0
  266. package/dist/components/scenes/guide/GuideHostContent.svelte.d.ts +43 -0
  267. package/dist/components/scenes/guide/HelpCenter.svelte +135 -0
  268. package/dist/components/scenes/guide/HelpCenter.svelte.d.ts +40 -0
  269. package/dist/components/scenes/guide/index.d.ts +2 -0
  270. package/dist/components/scenes/guide/index.js +2 -0
  271. package/dist/components/scenes/iam/AgreementNotice.svelte +48 -0
  272. package/dist/components/scenes/iam/AgreementNotice.svelte.d.ts +7 -0
  273. package/dist/components/scenes/iam/AuthPanel.svelte +226 -0
  274. package/dist/components/scenes/iam/AuthPanel.svelte.d.ts +29 -0
  275. package/dist/components/scenes/iam/AuthShell.svelte +160 -0
  276. package/dist/components/scenes/iam/AuthShell.svelte.d.ts +56 -0
  277. package/dist/components/scenes/iam/ChangePasswordForm.svelte +84 -63
  278. package/dist/components/scenes/iam/ChangePasswordForm.svelte.d.ts +13 -1
  279. package/dist/components/scenes/iam/ForgotPasswordForm.svelte +113 -89
  280. package/dist/components/scenes/iam/ForgotPasswordForm.svelte.d.ts +24 -1
  281. package/dist/components/scenes/iam/LoginForm.svelte +215 -117
  282. package/dist/components/scenes/iam/LoginForm.svelte.d.ts +13 -1
  283. package/dist/components/scenes/iam/PasswordInput.svelte +79 -32
  284. package/dist/components/scenes/iam/PasswordInput.svelte.d.ts +30 -4
  285. package/dist/components/scenes/iam/PermGuard.svelte +21 -11
  286. package/dist/components/scenes/iam/PermGuard.svelte.d.ts +30 -0
  287. package/dist/components/scenes/iam/ReauthenticationDialog.svelte +68 -0
  288. package/dist/components/scenes/iam/ReauthenticationDialog.svelte.d.ts +17 -0
  289. package/dist/components/scenes/iam/RegisterForm.svelte +129 -116
  290. package/dist/components/scenes/iam/RegisterForm.svelte.d.ts +13 -1
  291. package/dist/components/scenes/iam/ResetPasswordForm.svelte +101 -88
  292. package/dist/components/scenes/iam/ResetPasswordForm.svelte.d.ts +13 -1
  293. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte +76 -0
  294. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte.d.ts +21 -0
  295. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte +64 -0
  296. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte.d.ts +22 -0
  297. package/dist/components/scenes/iam/UserProfile.svelte +47 -21
  298. package/dist/components/scenes/iam/UserProfile.svelte.d.ts +24 -1
  299. package/dist/components/scenes/iam/auth-captcha.d.ts +21 -0
  300. package/dist/components/scenes/iam/auth-captcha.js +23 -0
  301. package/dist/components/scenes/iam/auth-error-message.d.ts +13 -0
  302. package/dist/components/scenes/iam/auth-error-message.js +65 -0
  303. package/dist/components/scenes/iam/index.d.ts +10 -0
  304. package/dist/components/scenes/iam/index.js +9 -1
  305. package/dist/components/scenes/iam/password-utils.d.ts +33 -6
  306. package/dist/components/scenes/iam/password-utils.js +61 -8
  307. package/dist/components/scenes/iam/permission-context.svelte.d.ts +33 -23
  308. package/dist/components/scenes/iam/permission-context.svelte.js +20 -22
  309. package/dist/components/scenes/iam/sensitive-actions.svelte.d.ts +68 -0
  310. package/dist/components/scenes/iam/sensitive-actions.svelte.js +101 -0
  311. package/dist/components/scenes/iam/session-recovery.svelte.d.ts +44 -0
  312. package/dist/components/scenes/iam/session-recovery.svelte.js +57 -0
  313. package/dist/components/scenes/index.d.ts +3 -0
  314. package/dist/components/scenes/index.js +5 -0
  315. package/dist/components/scenes/storage/AvatarUpload.svelte +82 -68
  316. package/dist/components/scenes/storage/AvatarUpload.svelte.d.ts +23 -1
  317. package/dist/components/scenes/storage/FileList.svelte +19 -5
  318. package/dist/components/scenes/storage/FileList.svelte.d.ts +23 -1
  319. package/dist/components/scenes/storage/FileUpload.svelte +151 -96
  320. package/dist/components/scenes/storage/FileUpload.svelte.d.ts +24 -1
  321. package/dist/components/scenes/storage/ImageUpload.svelte +93 -94
  322. package/dist/components/scenes/storage/ImageUpload.svelte.d.ts +24 -1
  323. package/dist/components/scenes/types.d.ts +574 -42
  324. package/dist/guide-storage.d.ts +18 -0
  325. package/dist/guide-storage.js +79 -0
  326. package/dist/guide-types.d.ts +143 -0
  327. package/dist/guide-types.js +1 -0
  328. package/dist/guide.d.ts +3 -0
  329. package/dist/guide.js +3 -0
  330. package/dist/guide.svelte.d.ts +29 -0
  331. package/dist/guide.svelte.js +506 -0
  332. package/dist/i18n.svelte.d.ts +67 -4
  333. package/dist/i18n.svelte.js +106 -21
  334. package/dist/index.d.ts +6 -0
  335. package/dist/index.js +7 -0
  336. package/dist/internal/browser-safety.d.ts +88 -0
  337. package/dist/internal/browser-safety.js +140 -0
  338. package/dist/internal/dialog-focus.d.ts +21 -0
  339. package/dist/internal/dialog-focus.js +77 -0
  340. package/dist/internal/form-context.d.ts +92 -0
  341. package/dist/internal/form-context.js +70 -0
  342. package/dist/internal/form-validation.svelte.d.ts +70 -0
  343. package/dist/internal/form-validation.svelte.js +142 -0
  344. package/dist/internal/icon-safety.d.ts +14 -0
  345. package/dist/internal/icon-safety.js +40 -0
  346. package/dist/internal/locale.d.ts +21 -0
  347. package/dist/internal/locale.js +43 -0
  348. package/dist/message.svelte.d.ts +138 -0
  349. package/dist/message.svelte.js +149 -0
  350. package/dist/messagebox.svelte.d.ts +130 -0
  351. package/dist/messagebox.svelte.js +171 -0
  352. package/dist/messages/en-US.json +303 -16
  353. package/dist/messages/ja-JP.json +529 -0
  354. package/dist/messages/zh-CN.json +303 -16
  355. package/dist/messages.d.ts +25 -3
  356. package/dist/messages.js +23 -6
  357. package/dist/styles/design-tokens.css +4 -2
  358. package/dist/styles/eye-care.css +55 -0
  359. package/dist/styles/formal.css +55 -0
  360. package/dist/styles/global.css +86 -18
  361. package/dist/styles/guide.css +88 -0
  362. package/dist/styles/high-contrast.css +64 -0
  363. package/dist/styles/mobile.css +28 -0
  364. package/dist/styles/theme.css +43 -0
  365. package/dist/theme-config.d.ts +263 -10
  366. package/dist/theme-config.js +253 -17
  367. package/dist/toast.svelte.d.ts +210 -2
  368. package/dist/toast.svelte.js +305 -19
  369. package/dist/types.d.ts +787 -63
  370. package/dist/utils/platform.svelte.d.ts +28 -15
  371. package/dist/utils/platform.svelte.js +23 -16
  372. package/dist/utils.d.ts +121 -1
  373. package/dist/utils.js +208 -13
  374. package/dist/workspace-context.d.ts +20 -0
  375. package/dist/workspace-context.js +9 -0
  376. package/package.json +120 -24
  377. package/vite.d.ts +13 -0
  378. package/vite.js +96 -0
  379. package/dist/components/scenes/crud/CrudEditDrawer.svelte +0 -225
  380. package/dist/components/scenes/crud/CrudEditDrawer.svelte.d.ts +0 -48
@@ -1,25 +1,80 @@
1
1
  /**
2
2
  * @h-ai/ui — Markdown 解析工具
3
3
  *
4
- * 基于 marked + highlight.js 的 Markdown 解析引擎。
4
+ * 基于 marked + Shiki 的 Markdown 解析引擎。
5
5
  * 支持 GFM(GitHub Flavored Markdown),包含代码高亮、表格、任务列表等。
6
6
  * @module markdown-parse
7
7
  */
8
- import hljs from 'highlight.js/lib/common';
9
8
  import { Marked } from 'marked';
10
- /**
11
- * 对 HTML 特殊字符进行转义
12
- *
13
- * @param text - 原始文本
14
- * @returns 转义后的安全文本
15
- */
16
- function escapeHtml(text) {
17
- return text
18
- .replace(/&/g, '&')
19
- .replace(/</g, '&lt;')
20
- .replace(/>/g, '&gt;')
21
- .replace(/"/g, '&quot;')
22
- .replace(/'/g, '&#39;');
9
+ import { uiM } from '../../../messages.js';
10
+ import { createEditorMarkdownExtensions } from './editor-markdown-extensions.js';
11
+ import { highlightCode, isLanguageSupported } from './highlight.js';
12
+ import { escapeHtml, isExternalLinkHref, sanitizeImageSrc, sanitizeLinkHref, sanitizeMarkdownHtml, } from './safe-html.js';
13
+ function readHtmlTokenSource(token) {
14
+ if ('raw' in token && typeof token.raw === 'string') {
15
+ return token.raw;
16
+ }
17
+ return 'text' in token && typeof token.text === 'string'
18
+ ? token.text
19
+ : '';
20
+ }
21
+ function createTableCellAttrs(cell) {
22
+ const attrs = [];
23
+ if (cell.align) {
24
+ attrs.push(`style="text-align:${cell.align}"`);
25
+ }
26
+ if (cell.text.trim()) {
27
+ attrs.push(`title="${escapeHtml(cell.text)}"`);
28
+ }
29
+ return attrs.length > 0 ? ` ${attrs.join(' ')}` : '';
30
+ }
31
+ /** 围栏代码和 HTML 代码共用渲染,颜色与复制控件始终由框架生成。 */
32
+ function renderCodeBlock(text, lang, options) {
33
+ const language = lang && isLanguageSupported(lang) ? lang : '';
34
+ let highlighted;
35
+ if (options.enableHighlight && language) {
36
+ highlighted = highlightCode(text, language);
37
+ }
38
+ else if (options.enableHighlight) {
39
+ // 未指定语言时不做自动检测,直接转义
40
+ highlighted = escapeHtml(text);
41
+ }
42
+ else {
43
+ highlighted = escapeHtml(text);
44
+ }
45
+ const langLabel = language
46
+ ? `<span class="hai-md-code-lang">${escapeHtml(language)}</span>`
47
+ : '';
48
+ const copyBtn = options.showCopyButton
49
+ ? `<button type="button" class="hai-md-copy-btn" data-copy-code aria-label="${escapeHtml(uiM('markdown_copy_code'))}"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg></button>`
50
+ : '';
51
+ return `<div class="hai-md-code-block">`
52
+ + `<div class="hai-md-code-header">${langLabel}${copyBtn}</div>`
53
+ + `<pre><code class="hai-hl${language ? ` language-${escapeHtml(language)}` : ''}">${highlighted}</code></pre>`
54
+ + `</div>`;
55
+ }
56
+ /** 仅还原代码文本的实体;随后仍按普通代码转义,绝不把代码中的标签作为 HTML 执行。 */
57
+ function decodeCodeText(text) {
58
+ const named = { amp: '&', lt: '<', gt: '>', quot: '"', apos: '\'', nbsp: '\u00A0' };
59
+ return text.replace(/&(#(?:[xX][\da-fA-F]+|\d+)|amp|lt|gt|quot|apos|nbsp);/g, (entity, key) => {
60
+ if (!key.startsWith('#'))
61
+ return named[key] ?? entity;
62
+ const code = key[1]?.toLowerCase() === 'x' ? Number.parseInt(key.slice(2), 16) : Number(key.slice(1));
63
+ return code > 0 && code <= 0x10FFFF && !(code >= 0xD800 && code <= 0xDFFF) ? String.fromCodePoint(code) : entity;
64
+ });
65
+ }
66
+ /** 重建 pre/code,不保留输入的 style、事件或任意 class;其余 HTML 继续通过原有白名单。 */
67
+ function renderHtmlWithCode(source, options) {
68
+ let html = '';
69
+ let offset = 0;
70
+ for (const match of source.matchAll(/<pre\b[^>]*>\s*<code\b([^>]*)>([\s\S]*?)<\/code>\s*<\/pre>/gi)) {
71
+ html += sanitizeMarkdownHtml(source.slice(offset, match.index));
72
+ const classes = /\bclass\s*=\s*(?:"([^"]*)"|'([^']*)')/i.exec(match[1]);
73
+ const language = /(?:^|\s)language-([a-z\d#+.-]+)(?:\s|$)/i.exec(classes?.[1] ?? classes?.[2] ?? '')?.[1];
74
+ html += renderCodeBlock(decodeCodeText(match[2]), language, options);
75
+ offset = match.index + match[0].length;
76
+ }
77
+ return html + sanitizeMarkdownHtml(source.slice(offset));
23
78
  }
24
79
  /**
25
80
  * 创建自定义渲染器对象
@@ -31,38 +86,21 @@ function createRendererObject(options) {
31
86
  return {
32
87
  // 代码块:语法高亮 + 语言标签 + 复制按钮
33
88
  code({ text, lang }) {
34
- const language = lang && hljs.getLanguage(lang) ? lang : '';
35
- let highlighted;
36
- if (options.enableHighlight && language) {
37
- highlighted = hljs.highlight(text, { language }).value;
38
- }
39
- else if (options.enableHighlight) {
40
- highlighted = hljs.highlightAuto(text).value;
41
- }
42
- else {
43
- highlighted = escapeHtml(text);
44
- }
45
- const langLabel = language
46
- ? `<span class="hai-md-code-lang">${escapeHtml(language)}</span>`
47
- : '';
48
- const copyBtn = options.showCopyButton
49
- ? `<button type="button" class="hai-md-copy-btn" data-copy-code aria-label="Copy code"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg></button>`
50
- : '';
51
- return `<div class="hai-md-code-block">`
52
- + `<div class="hai-md-code-header">${langLabel}${copyBtn}</div>`
53
- + `<pre><code class="hljs${language ? ` language-${escapeHtml(language)}` : ''}">${highlighted}</code></pre>`
54
- + `</div>`;
89
+ return renderCodeBlock(text, lang, options);
55
90
  },
56
91
  // 原始 HTML 块:转义以防止 XSS
57
92
  html(token) {
58
- return escapeHtml('text' in token ? token.text : '');
93
+ const source = readHtmlTokenSource(token);
94
+ return options.allowHtmlTags
95
+ ? renderHtmlWithCode(source, options)
96
+ : escapeHtml(source);
59
97
  },
60
98
  // 链接:外部链接自动添加 target="_blank",阻止危险协议
61
99
  link({ href, title, tokens }) {
62
100
  const text = this.parser.parseInline(tokens);
63
101
  // 安全检查:仅允许安全协议
64
- const safeHref = href && /^(?:https?:\/\/|\/|#|mailto:)/i.test(href) ? href : '';
65
- const isExternal = safeHref && (safeHref.startsWith('http://') || safeHref.startsWith('https://'));
102
+ const safeHref = sanitizeLinkHref(href);
103
+ const isExternal = safeHref && isExternalLinkHref(safeHref);
66
104
  const attrs = [
67
105
  `href="${escapeHtml(safeHref)}"`,
68
106
  title ? `title="${escapeHtml(title)}"` : '',
@@ -73,7 +111,7 @@ function createRendererObject(options) {
73
111
  // 图片:添加 loading="lazy",验证 src 协议
74
112
  image({ href, title, text }) {
75
113
  // 安全检查:仅允许安全协议
76
- const safeSrc = href && /^(?:https?:\/\/|\/|data:image\/)/i.test(href) ? href : '';
114
+ const safeSrc = sanitizeImageSrc(href);
77
115
  const attrs = [
78
116
  `src="${escapeHtml(safeSrc)}"`,
79
117
  `alt="${escapeHtml(text || '')}"`,
@@ -87,15 +125,13 @@ function createRendererObject(options) {
87
125
  table(token) {
88
126
  let headerHtml = '';
89
127
  for (const cell of token.header) {
90
- const align = cell.align ? ` style="text-align:${cell.align}"` : '';
91
- headerHtml += `<th${align}>${this.parser.parseInline(cell.tokens)}</th>`;
128
+ headerHtml += `<th${createTableCellAttrs(cell)}>${this.parser.parseInline(cell.tokens)}</th>`;
92
129
  }
93
130
  let bodyHtml = '';
94
131
  for (const row of token.rows) {
95
132
  let rowHtml = '';
96
133
  for (const cell of row) {
97
- const align = cell.align ? ` style="text-align:${cell.align}"` : '';
98
- rowHtml += `<td${align}>${this.parser.parseInline(cell.tokens)}</td>`;
134
+ rowHtml += `<td${createTableCellAttrs(cell)}>${this.parser.parseInline(cell.tokens)}</td>`;
99
135
  }
100
136
  bodyHtml += `<tr>${rowHtml}</tr>`;
101
137
  }
@@ -114,6 +150,7 @@ function createRendererObject(options) {
114
150
  function createMarkedInstance(options) {
115
151
  return new Marked({
116
152
  renderer: createRendererObject(options),
153
+ extensions: createEditorMarkdownExtensions(),
117
154
  gfm: true,
118
155
  breaks: options.breaks,
119
156
  });
@@ -123,6 +160,7 @@ const DEFAULT_OPTIONS = {
123
160
  enableHighlight: true,
124
161
  showCopyButton: true,
125
162
  breaks: true,
163
+ allowHtmlTags: false,
126
164
  };
127
165
  /** 缓存 Marked 实例,避免重复创建 */
128
166
  let cachedInstance = null;
@@ -131,7 +169,7 @@ let cachedOptionsKey = '';
131
169
  * 获取配置签名,用于实例缓存比较
132
170
  */
133
171
  function getOptionsKey(options) {
134
- return `${options.enableHighlight}-${options.showCopyButton}-${options.breaks}`;
172
+ return `${options.enableHighlight}-${options.showCopyButton}-${options.breaks}-${options.allowHtmlTags}`;
135
173
  }
136
174
  /**
137
175
  * 将 Markdown 文本解析为 HTML
@@ -142,8 +180,8 @@ function getOptionsKey(options) {
142
180
  *
143
181
  * @example
144
182
  * ```ts
145
- * const html = parseMarkdown('# Hello\n\nWorld')
146
- * // => '<h1>Hello</h1>\n<p>World</p>\n'
183
+ * import { parseMarkdown } from '@h-ai/ui'
184
+ * const html = parseMarkdown('# 简介\n**重点**', { allowHtmlTags: false })
147
185
  * ```
148
186
  */
149
187
  export function parseMarkdown(content, options) {
@@ -0,0 +1,72 @@
1
+ /**
2
+ * Mermaid host 同步状态工具。
3
+ *
4
+ * Mermaid 图表通过 {@html} 插入占位节点后异步渲染。流式输出时,HTML 占位可能不变,
5
+ * 但源码正文会持续变化,因此必须用源码签名判断是否需要重渲染。
6
+ *
7
+ * @example 模块内部上下文
8
+ * ```ts
9
+ * const example: MermaidHostRenderActionInput = { status: 'ready', renderedSignature: 'old-source', nextSignature: 'new-source' }
10
+ * ```
11
+ */
12
+ export interface MermaidHostRenderActionInput {
13
+ /** 当前 host 上记录的渲染状态。 */
14
+ status?: string;
15
+ /** 当前 host 上一次渲染使用的源码签名。 */
16
+ renderedSignature?: string;
17
+ /** 本次 Markdown 解析得到的最新源码签名。 */
18
+ nextSignature: string;
19
+ }
20
+ /**
21
+ * 异步 Mermaid 渲染决策;仅 shouldRender=true 时携带提交 token。
22
+ *
23
+ * @example 模块内部上下文
24
+ * ```ts
25
+ * const example: MermaidHostRenderAction = { shouldRender: true, token: 'diagram-1-source' }
26
+ * ```
27
+ */
28
+ export type MermaidHostRenderAction = {
29
+ shouldRender: false;
30
+ } | {
31
+ shouldRender: true;
32
+ token: string;
33
+ };
34
+ /**
35
+ * 为 Mermaid block 生成稳定签名。
36
+ *
37
+ * 签名同时包含 block id 与源码正文,避免流式阶段占位 HTML 未变化时漏掉源码更新。
38
+ * @param blockId - 当前代码块的稳定 ID。
39
+ * @param code - Mermaid 或待渲染的代码源码。
40
+ * @returns 绑定块 id 和完整源码的稳定签名。
41
+ *
42
+ * @example 模块内部上下文
43
+ * ```ts
44
+ * const signature = createMermaidSourceSignature('diagram-1', 'graph TD; A-->B')
45
+ * ```
46
+ */
47
+ export declare function createMermaidSourceSignature(blockId: string, code: string): string;
48
+ /**
49
+ * 判断 Mermaid host 是否需要发起一次新的异步渲染。
50
+ * @param input - 当前状态及目标源码签名。
51
+ * @returns 是否重渲染的决策,需要时携带提交 token。
52
+ *
53
+ * @example 模块内部上下文
54
+ * ```ts
55
+ * const action = getMermaidHostRenderAction({ status: 'ready', renderedSignature: 'old', nextSignature: 'new' })
56
+ * if (action.shouldRender) { const token = action.token }
57
+ * ```
58
+ */
59
+ export declare function getMermaidHostRenderAction(input: MermaidHostRenderActionInput): MermaidHostRenderAction;
60
+ /**
61
+ * 判断异步 Mermaid 渲染结果是否仍对应当前 host 源码。
62
+ * @param renderToken - 异步渲染启动时捕获的 token。
63
+ * @param currentSignature - 宿主当前源码签名。
64
+ * @returns 渲染 token 是否仍匹配当前源码签名。
65
+ *
66
+ * @example 模块内部上下文
67
+ * ```ts
68
+ * const accepted = isCurrentMermaidRenderToken('current-source', 'current-source')
69
+ * const stale = isCurrentMermaidRenderToken('old-source', 'current-source')
70
+ * ```
71
+ */
72
+ export declare function isCurrentMermaidRenderToken(renderToken: string, currentSignature: string | undefined): boolean;
@@ -0,0 +1,65 @@
1
+ /**
2
+ * Mermaid host 同步状态工具。
3
+ *
4
+ * Mermaid 图表通过 {@html} 插入占位节点后异步渲染。流式输出时,HTML 占位可能不变,
5
+ * 但源码正文会持续变化,因此必须用源码签名判断是否需要重渲染。
6
+ *
7
+ * @example 模块内部上下文
8
+ * ```ts
9
+ * const example: MermaidHostRenderActionInput = { status: 'ready', renderedSignature: 'old-source', nextSignature: 'new-source' }
10
+ * ```
11
+ */
12
+ /**
13
+ * 为 Mermaid block 生成稳定签名。
14
+ *
15
+ * 签名同时包含 block id 与源码正文,避免流式阶段占位 HTML 未变化时漏掉源码更新。
16
+ * @param blockId - 当前代码块的稳定 ID。
17
+ * @param code - Mermaid 或待渲染的代码源码。
18
+ * @returns 绑定块 id 和完整源码的稳定签名。
19
+ *
20
+ * @example 模块内部上下文
21
+ * ```ts
22
+ * const signature = createMermaidSourceSignature('diagram-1', 'graph TD; A-->B')
23
+ * ```
24
+ */
25
+ export function createMermaidSourceSignature(blockId, code) {
26
+ return JSON.stringify([blockId, code]);
27
+ }
28
+ /**
29
+ * 判断 Mermaid host 是否需要发起一次新的异步渲染。
30
+ * @param input - 当前状态及目标源码签名。
31
+ * @returns 是否重渲染的决策,需要时携带提交 token。
32
+ *
33
+ * @example 模块内部上下文
34
+ * ```ts
35
+ * const action = getMermaidHostRenderAction({ status: 'ready', renderedSignature: 'old', nextSignature: 'new' })
36
+ * if (action.shouldRender) { const token = action.token }
37
+ * ```
38
+ */
39
+ export function getMermaidHostRenderAction(input) {
40
+ const status = input.status?.trim();
41
+ const renderedSignature = input.renderedSignature?.trim();
42
+ if ((status === 'ready' || status === 'rendering' || status === 'error')
43
+ && renderedSignature === input.nextSignature) {
44
+ return { shouldRender: false };
45
+ }
46
+ return {
47
+ shouldRender: true,
48
+ token: input.nextSignature,
49
+ };
50
+ }
51
+ /**
52
+ * 判断异步 Mermaid 渲染结果是否仍对应当前 host 源码。
53
+ * @param renderToken - 异步渲染启动时捕获的 token。
54
+ * @param currentSignature - 宿主当前源码签名。
55
+ * @returns 渲染 token 是否仍匹配当前源码签名。
56
+ *
57
+ * @example 模块内部上下文
58
+ * ```ts
59
+ * const accepted = isCurrentMermaidRenderToken('current-source', 'current-source')
60
+ * const stale = isCurrentMermaidRenderToken('old-source', 'current-source')
61
+ * ```
62
+ */
63
+ export function isCurrentMermaidRenderToken(renderToken, currentSignature) {
64
+ return renderToken === currentSignature;
65
+ }
@@ -0,0 +1,30 @@
1
+ /**
2
+ * @h-ai/ui — Mermaid 图表渲染助手
3
+ *
4
+ * 以懒加载方式引入 mermaid,把图表源码渲染为安全的 SVG。
5
+ * 使用 `securityLevel: 'strict'`,由 mermaid 自身完成消毒,避免 {@html} 注入风险。
6
+ */
7
+ /**
8
+ * 判断 fence 语言是否为 mermaid。
9
+ * @param language - 待识别的语言标记。
10
+ * @returns 语言标记是否属于 Mermaid。
11
+ *
12
+ * @example 模块内部上下文
13
+ * ```ts
14
+ * const supported = isMermaidLanguage('mermaid')
15
+ * ```
16
+ */
17
+ export declare function isMermaidLanguage(language: string | undefined | null): boolean;
18
+ /**
19
+ * 把 mermaid 源码渲染为 SVG 字符串;语法错误时抛出由调用方兜底展示。
20
+ * @param code - Mermaid 或待渲染的代码源码。
21
+ * @returns 严格模式渲染的 SVG;保留节点、连线和文字所需的样式。
22
+ * @throws 浏览器渲染、第三方解析或下载失败时抛出异常,由交互边界显示错误。
23
+ *
24
+ * @example 模块内部上下文
25
+ * ```ts
26
+ * const svg = await renderMermaidDiagram('graph TD; A-->B')
27
+ * // 在浏览器异步渲染,失败由调用交互边界处理。
28
+ * ```
29
+ */
30
+ export declare function renderMermaidDiagram(code: string): Promise<string>;
@@ -0,0 +1,61 @@
1
+ /**
2
+ * @h-ai/ui — Mermaid 图表渲染助手
3
+ *
4
+ * 以懒加载方式引入 mermaid,把图表源码渲染为安全的 SVG。
5
+ * 使用 `securityLevel: 'strict'`,由 mermaid 自身完成消毒,避免 {@html} 注入风险。
6
+ */
7
+ /** mermaid 模块只在首次渲染时动态加载,并缓存初始化后的实例。 */
8
+ let mermaidLoader = null;
9
+ /** render id 需要在页面内唯一,递增计数器即可保证不冲突。 */
10
+ let renderSeq = 0;
11
+ /**
12
+ * 判断 fence 语言是否为 mermaid。
13
+ * @param language - 待识别的语言标记。
14
+ * @returns 语言标记是否属于 Mermaid。
15
+ *
16
+ * @example 模块内部上下文
17
+ * ```ts
18
+ * const supported = isMermaidLanguage('mermaid')
19
+ * ```
20
+ */
21
+ export function isMermaidLanguage(language) {
22
+ return (language ?? '').trim().toLowerCase() === 'mermaid';
23
+ }
24
+ /**
25
+ * 懒加载并初始化 mermaid,多次调用复用同一实例。
26
+ */
27
+ async function loadMermaid() {
28
+ if (!mermaidLoader) {
29
+ mermaidLoader = import('mermaid').then((module) => {
30
+ const mermaid = module.default;
31
+ mermaid.initialize({
32
+ startOnLoad: false,
33
+ securityLevel: 'strict',
34
+ theme: 'default',
35
+ // 不允许文档指令修改安全策略、消毒规则或注入页面级 CSS。
36
+ secure: ['secure', 'securityLevel', 'startOnLoad', 'maxTextSize', 'suppressErrorRendering', 'maxEdges', 'themeCSS', 'themeVariables', 'fontFamily', 'altFontFamily', 'dompurifyConfig'],
37
+ });
38
+ return mermaid;
39
+ });
40
+ }
41
+ return mermaidLoader;
42
+ }
43
+ /**
44
+ * 把 mermaid 源码渲染为 SVG 字符串;语法错误时抛出由调用方兜底展示。
45
+ * @param code - Mermaid 或待渲染的代码源码。
46
+ * @returns 严格模式渲染的 SVG;保留节点、连线和文字所需的样式。
47
+ * @throws 浏览器渲染、第三方解析或下载失败时抛出异常,由交互边界显示错误。
48
+ *
49
+ * @example 模块内部上下文
50
+ * ```ts
51
+ * const svg = await renderMermaidDiagram('graph TD; A-->B')
52
+ * // 在浏览器异步渲染,失败由调用交互边界处理。
53
+ * ```
54
+ */
55
+ export async function renderMermaidDiagram(code) {
56
+ const mermaid = await loadMermaid();
57
+ const renderId = `hai-mermaid-${Date.now()}-${renderSeq++}`;
58
+ const { svg } = await mermaid.render(renderId, code);
59
+ // 编辑预览中隐藏样式节点自身,但保留其 CSS 规则;删除规则会使节点成为黑色实心块。
60
+ return svg.replace(/<style>/gi, '<style style="display:none">');
61
+ }
@@ -0,0 +1,64 @@
1
+ /**
2
+ * @h-ai/ui — Markdown 渲染的安全 HTML 工具。
3
+ *
4
+ * Markdown 默认将原始 HTML 当作纯文本转义。
5
+ * 显式允许 HTML 后,也只重建白名单中的安全标签与
6
+ * 属性;不支持或危险的标记仍按文字转义。
7
+ */
8
+ /**
9
+ * 将候选文本中的 HTML 特殊字符转义为可安全展示的纯文本。
10
+ * @param text - 待处理文本。
11
+ * @returns HTML 特殊字符被转义的字符串。
12
+ *
13
+ * @example 模块内部上下文
14
+ * ```ts
15
+ * const escaped = escapeHtml('<b>文本</b>')
16
+ * ```
17
+ */
18
+ export declare function escapeHtml(text: string): string;
19
+ /**
20
+ * 拒绝脚本等危险协议,只输出允许的链接地址。
21
+ * @param href - 待验证的链接候选地址。
22
+ * @returns 允许的链接地址,不安全或空输入返回空字符串。
23
+ *
24
+ * @example 模块内部上下文
25
+ * ```ts
26
+ * const safe = sanitizeLinkHref('javascript:alert(1)')
27
+ * // 不安全协议变为空字符串,不能直接渲染原始 href。
28
+ * ```
29
+ */
30
+ export declare function sanitizeLinkHref(href: string | null | undefined): string;
31
+ /**
32
+ * 识别外部链接,供渲染器添加相应的 rel/target 安全属性。
33
+ * @param href - 待验证的链接候选地址。
34
+ * @returns 地址是否为需要外链安全属性的外部链接。
35
+ *
36
+ * @example 模块内部上下文
37
+ * ```ts
38
+ * const external = isExternalLinkHref('https://example.com/help')
39
+ * ```
40
+ */
41
+ export declare function isExternalLinkHref(href: string): boolean;
42
+ /**
43
+ * 拒绝危险图片来源,保留允许的远程、相对或受控数据地址。
44
+ * @param src - 待验证的图片候选地址。
45
+ * @returns 允许的图片地址,不安全或空输入返回空字符串。
46
+ *
47
+ * @example 模块内部上下文
48
+ * ```ts
49
+ * const safe = sanitizeImageSrc('https://example.com/image.png')
50
+ * ```
51
+ */
52
+ export declare function sanitizeImageSrc(src: string | null | undefined): string;
53
+ /**
54
+ * 消毒 Markdown 中嵌入的原始 HTML 片段。
55
+ * 只重建白名单标签,其余内容保持转义。
56
+ * @param fragment - 待消毒的 HTML 片段。
57
+ * @returns 仅保留白名单标签和安全属性的 HTML。
58
+ *
59
+ * @example 模块内部上下文
60
+ * ```ts
61
+ * const safe = sanitizeMarkdownHtml('<p onclick="alert(1)">正文</p>')
62
+ * ```
63
+ */
64
+ export declare function sanitizeMarkdownHtml(fragment: string): string;