@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
package/README.ja.md ADDED
@@ -0,0 +1,1062 @@
1
+ # @h-ai/ui
2
+
3
+ [简体中文](./README.md) | [English](./README.en.md) | [日本語](./README.ja.md)
4
+
5
+ [フレームワークのホーム](../../README.ja.md) · 関連モジュール:[@h-ai/core](../core/README.ja.md)
6
+
7
+ ## 概要
8
+
9
+ 内蔵メッセージは `zh-CN`、`en-US`、`ja-JP` に対応し、言語セレクターは既定で3言語を表示します。
10
+
11
+ Svelte 5 Runes のクロスプラットフォーム UI ライブラリーです。DaisyUI v5 + Tailwind CSS v4 のスタイル、Bits UI v2 のヘッドレス UI、内蔵 i18n(zh-CN / en-US / ja-JP)、15 種類の厳選テーマ、ハイコントラスト、直角ビジネス、目にやさしいテーマを提供します。
12
+
13
+ ## 主な機能
14
+
15
+ - フォーム、テーブル、ダイアログ、ナビゲーション、チャートなどの部品。
16
+ - 認証、CRUD、AI コンテンツ、操作ガイド、ヘルプセンター。
17
+ - Svelte 5、テーマ、レスポンシブ表示、中国語・英語・日本語のコンポーネント文言。
18
+
19
+ Markdown の下線と強調マーカーはエスケープに対応し、閉じていないマーカーはテキストとして扱います。長い異常入力でも Toast と文書出力で反復走査を避け、追跡 ID は既定で折りたたみます。
20
+
21
+ ## 使い始める
22
+
23
+ ### インストール
24
+
25
+ ```bash
26
+ npm install @h-ai/ui @h-ai/core
27
+ ```
28
+
29
+ Node サーバーでは UI と core の両方を本番依存に含め、ログなどのネイティブ依存を通常どおり読み込めるようにします。
30
+
31
+ ### クイックスタート
32
+
33
+ #### 1. svelte.config.js の設定
34
+
35
+ ```js
36
+ import { autoImportHaiUi } from '@h-ai/ui/auto-import'
37
+ import adapter from '@sveltejs/adapter-node'
38
+ import { vitePreprocess } from '@sveltejs/vite-plugin-svelte'
39
+
40
+ /** @type {import('@sveltejs/kit').Config} */
41
+ const config = {
42
+ preprocess: [autoImportHaiUi(), vitePreprocess()],
43
+ compilerOptions: { runes: true },
44
+ kit: { adapter: adapter() },
45
+ }
46
+
47
+ export default config
48
+ ```
49
+
50
+ #### 2. vite.config.ts の設定
51
+
52
+ ```ts
53
+ import { haiOptimizeExclude, haiPrebundledDeps } from '@h-ai/ui/vite'
54
+ import { sveltekit } from '@sveltejs/kit/vite'
55
+ import tailwindcss from '@tailwindcss/vite'
56
+ import { defineConfig } from 'vite'
57
+
58
+ export default defineConfig({
59
+ plugins: [sveltekit(), tailwindcss()],
60
+ optimizeDeps: {
61
+ // bits-ui 含 .svelte 源码须 exclude;@internationalized/date 须与 bits-ui 同为原始副本,
62
+ // 否则日期组件会因双实例 instanceof 失败抛 "Unknown date type"
63
+ exclude: [...haiOptimizeExclude],
64
+ // 预打包 @h-ai/ui 的重型纯 JS 依赖(语法高亮 / Mermaid / PDF 等),
65
+ // 避免首次进入业务路由时触发依赖再优化与整页刷新
66
+ include: [...haiPrebundledDeps],
67
+ },
68
+ ssr: { noExternal: ['@h-ai/ui', '@h-ai/kit'], external: ['@h-ai/core', 'sm-crypto'] },
69
+ })
70
+ ```
71
+
72
+ Crypto または Kit/IAM を使う場合、アプリの本番依存に `sm-crypto@0.5.7` を含めます。CLI 生成済みのプロジェクトでは設定済みです。手動導入は `pnpm add sm-crypto@0.5.7` を実行してください。adapter-node は直接の本番依存も参照するため、external 指定だけでは不十分です。
73
+
74
+ #### 3. src/app.css の設定
75
+
76
+ ```css
77
+ @import 'tailwindcss';
78
+ @import '@h-ai/ui/styles/global.css';
79
+ @import '@h-ai/ui/styles/theme.css';
80
+ @source "../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
81
+ @source "../../../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
82
+
83
+ @plugin "daisyui" {
84
+ themes: light --default, dark --prefersdark, cupcake, emerald, corporate, nord, dracula, night;
85
+ }
86
+
87
+ /* 图标(可选) */
88
+ @plugin "@iconify/tailwind4" {
89
+ prefixes: tabler;
90
+ }
91
+ ```
92
+
93
+ > `@source` で TailwindCSS に `@h-ai/ui` の class を走査させます。ない場合はスタイルが欠落します。monorepo 内のアプリでは依存がルート `node_modules` に置かれる場合があるため、両方のパスを残すことを推奨します。
94
+
95
+ #### 4. コンポーネントの使用
96
+
97
+ ```svelte
98
+ <script>
99
+ import { Button, Input, Card } from '@h-ai/ui'
100
+ </script>
101
+
102
+ <Card title="示例表单">
103
+ <Input placeholder="请输入用户名" />
104
+ <Button variant="primary" onclick={handleSubmit}>提交</Button>
105
+ </Card>
106
+ ```
107
+
108
+ 自動 import を有効にすると、個別の import なしでテンプレートから使えます:
109
+
110
+ ```svelte
111
+ <!-- 无需 import { Button } from '@h-ai/ui' -->
112
+ <Button variant="primary">提交</Button>
113
+ ```
114
+
115
+ > `toast`・型 import・DOM の `Range` と衝突する `Range` を除き、公開 Svelte コンポーネントは `@h-ai/ui/auto-import` で自動注入できます。
116
+
117
+ 管理画面など一部のコンポーネントを使うページは、公開コンポーネントディレクトリーの入口から直接 import できます。テーマツールは軽量な `@h-ai/ui/theme` から読み込み、テーマの利用だけでルート入口の AI・グラフコンポーネントを読み込まないようにします。ストアの言語ツールは `@h-ai/ui/i18n` から読み込み、コンポーネントやガイド CSS を読み込みません。インストール済みパッケージの exports を確認し、内部 `src/`・`dist/` は import しないでください。
118
+
119
+ 自動 import はセミコロンなし、複数行、別名の import を認識し、既存のローカル名を重複注入しません。型のみの import は実行時コンポーネントの代わりにはなりません。
120
+
121
+ ```ts
122
+ import { Card } from '@h-ai/ui/components/compounds/index'
123
+ import { Button } from '@h-ai/ui/components/primitives/index'
124
+ import { getThemeInfo, THEMES } from '@h-ai/ui/theme'
125
+ ```
126
+
127
+ #### data-\* 属性の転送
128
+
129
+ 公開 Svelte コンポーネントは `data-*` をルート・主操作要素へ転送し、テスト・計測・自動化に使えます。通常の未知属性は転送しません。
130
+
131
+ ```svelte
132
+ <Button data-testid='save-button' data-analytics-id='settings.save'>保存</Button>
133
+ <Input data-testid='username-input' bind:value={username} />
134
+ <Modal data-testid='confirm-modal' bind:open={open}>...</Modal>
135
+ ```
136
+
137
+ `data-testid` のためだけにボタン・入力・ポップアップをラップする必要はありません。
138
+
139
+ ### コンポーネント構成
140
+
141
+ 3 層で構成します(primitives → compounds → scenes):
142
+
143
+ ```
144
+ components/
145
+ ├── primitives/ # 分割できない基本 UI 部品
146
+ ├── compounds/ # 基本部品 + Bits UI の組み合わせ
147
+ └── scenes/ # 業務用途の完全な UI フロー
148
+ ├── ai/ # AI 文書 / 表計算 / Markdown プレビュー
149
+ ├── app/ # 設定 / フィードバック / テーマ / 言語
150
+ ├── crud/ # CRUD ページ / ドロワー / 絞り込み / 削除確認
151
+ ├── iam/ # 認証
152
+ ├── storage/ # ストレージ管理
153
+ └── crypto/ # 暗号表示
154
+ ```
155
+
156
+ ### コンポーネント一覧
157
+
158
+ #### Primitives:基本コンポーネント(20)
159
+
160
+ | コンポーネント | 説明 | 主なプロパティ |
161
+ | ---------------- | ---------------------- | ------------------------------------------------------------------------------ |
162
+ | `Button` | ボタン | `variant`, `size`, `loading`, `disabled`, `outline`, `circle` |
163
+ | `IconButton` | アイコンボタン | `icon: trusted SVG string \| Snippet`, `variant`, `size`, `tooltip`, `loading` |
164
+ | `BareButton` | スタイルなしボタン | `class`, `ariaLabel`, `role`, `tabindex` |
165
+ | `Input` | 入力欄 | `type`, `value`, `size`, `error`, `validationMessage` |
166
+ | `BareInput` | スタイルなし入力欄 | `type`, `class`, `accept`, `multiple` |
167
+ | `Textarea` | テキストエリア | `value`, `rows`, `size`, `autoResize`, `error` |
168
+ | `Select` | 選択リスト | `options`, `value`, `placeholder`, `size`, `clearable`, `filterable` |
169
+ | `Checkbox` | チェックボックス | `checked`, `label`, `size`, `indeterminate` |
170
+ | `Switch` | スイッチ | `checked`, `label`, `size` |
171
+ | `Radio` | ラジオグループ | `options`, `value`, `direction`, `size` |
172
+ | `ToggleCheckbox` | ネイティブスイッチ入力 | `checked`, `name`, `onchange` |
173
+ | `ToggleInput` | ネイティブトグル入力 | `checked`, `name` |
174
+ | `ToggleRadio` | ネイティブラジオ入力 | `checked`, `name`, `onchange` |
175
+ | `Range` | スライダー | `value`, `min`, `max`, `step` |
176
+ | `Rating` | 評価 | `value`, `max` |
177
+ | `Badge` | バッジ | `variant`, `size`, `outline` |
178
+ | `Avatar` | アバター | `src`, `name`, `size`, `shape`, `ring` |
179
+ | `Tag` | タグ | `text`, `variant`, `size`, `closable` |
180
+ | `Spinner` | 読み込み表示 | `size`, `variant` |
181
+ | `Progress` | プログレスバー | `value`, `max`, `variant`, `striped`, `animated` |
182
+
183
+ `BareInput` の `type="file"` では `onchange` の `event.currentTarget.files` を読み取り、ファイルパスの `value` はバインドしません。他の入力型では `bind:value` を使用できます。
184
+
185
+ #### Compounds:複合コンポーネント(37)
186
+
187
+ ##### フォーム
188
+
189
+ | コンポーネント | 説明 | 主なプロパティ |
190
+ | -------------- | ------------------ | -------------------------------------------- |
191
+ | `Form` | フォームコンテナー | `columns`, `labelPosition`, `labelWidth`, `loading`, `disabled`, `onsubmit` |
192
+ | `FormField` | フォーム項目 | `label`, `for`, `colSpan`, `labelPosition`, `error`, `hint`, `required` |
193
+ | `FormLayout` | フォーム配置 | `columns`, `labelPosition`, `labelWidth` |
194
+ | `TagInput` | タグ入力 | `tags`, `maxTags`, `allowDuplicates`, `size` |
195
+
196
+ ##### フォームのレイアウトと検証
197
+
198
+ `Form` とネイティブ `<form>` 内で使う `FormLayout` は、`columns={1 | 2}`、`labelPosition="top" | "left"`、`labelWidth`(既定 `8rem`)を共有します。既定は1列・ラベルを上に配置します。コンテナー幅が `36rem` 未満では1列、`28rem` 未満では横並びラベルも縦並びになります。
199
+
200
+ `FormField.colSpan` の既定は `'auto'`。Textarea、ファイル・画像アップロード、TagInput、複数選択 Combobox は2列を占めます。`1` / `2` で指定でき、独自の幅広コントロールには `data-form-wide` を付けます。見出し、エラー概要、操作ボタンなどの非 FormField 要素は行全体を使用します。項目ごとに `labelPosition` / `labelWidth` を上書きできます。
201
+
202
+ ラベルは内部 UI コントロールに自動で関連付けられます。明示 ID やネイティブ要素は `<FormField for="control-id">` を使います。エラーとヒントは `aria-describedby`、無効な要素は `aria-invalid` で通知し、エラーは重複表示しません。`label` / `error` / `hint` は文字列または翻訳関数を受け取ります。
203
+
204
+ `Input`、`Textarea`、`Select`、`PasswordInput` のネイティブ検証は中国語・英語・日本語に対応します。`validationMessage` は失敗時だけ適用され、有効な入力を無効にし続けません。UI の `setGlobalLocale` / `createLocaleStore` で言語を同期すると表示中のエラーも更新されます。`Textarea` は `minlength` / `maxlength`、`Select` は `name`・必須検証・FormData に対応します。
205
+
206
+ 項目のエラーは Toast で表示します。前の通知を閉じた場合や表示時間が過ぎた場合も、同じ無効な入力で再送信すると再び通知します。入力を修正すると古い通知を消去します。エラー枠、`aria-invalid`、スクリーンリーダー用の関連説明は項目に保持します。
207
+
208
+ テキスト入力後のフォーカス離脱時に検証し、修正中も更新します。未入力の空欄は送信時に検証し、初期フォーカスの移動で操作を押し下げません。CRUD も入力後のフォーカス離脱時または送信時に検証し、カスタムメッセージに対応して再表示時に検証状態をリセットします。`Select` はトリガーと選択肢の両方からフォーカスが離れた時に検証します。`PasswordInput.minLength` は長さ制約と強度計算に使い、省略時はログイン用の長さ制限を設けず、強度のみ8文字を基準にします。
209
+
210
+ `UserProfile.fieldConstraints` は項目別に `required`、`minlength`、`maxlength`、`pattern`、`validationMessage` を受け取り、ユーザー名などの業務ルールをフォーカス離脱時に検証します。`pattern` は単一行の入力に適用し、`validationMessage` は翻訳関数にも対応します。
211
+
212
+ `CrudEditPanel.onsubmit` はフォームに宣言された書き込み可能な項目だけを受け取ります。`readonly` の項目は編集時に除外し、新規作成時には入力できます。主キー、関連データの表示値、監査日時を行全体から自動送信しません。空値、`false`、`0` は保持します。サーバーでは引き続き厳密なスキーマ検証を行ってください。
213
+
214
+ `LoginForm`、`RegisterForm`、`ChangePasswordForm`、`ForgotPasswordForm`、`ResetPasswordForm`、`AuthPanel`、`UserProfile`、`FeedbackModal` は同じレイアウト設定に対応します。`CrudPage.form` または `CrudEditPanel` に渡します。CRUD 項目は `colSpan` と翻訳関数の `validation.message` に対応し、ボタンと Enter のどちらも送信前に検証します。入力修正でエラーが消えます。サーバー側の検証も必要です。
215
+
216
+ ```svelte
217
+ <!-- m、save、name、notes 为应用自己的翻译、提交回调和状态 -->
218
+ <Form columns={2} labelPosition="left" labelWidth="6rem" onsubmit={save}>
219
+ <FormField label={() => m.name()} required>
220
+ <Input name="name" bind:value={name} required />
221
+ </FormField>
222
+ <FormField label={() => m.notes()}>
223
+ <Textarea name="notes" bind:value={notes} />
224
+ </FormField>
225
+ <Button type="submit">{m.save()}</Button>
226
+ </Form>
227
+ ```
228
+
229
+ ##### フィードバック
230
+
231
+ | コンポーネント | 説明 | 主なプロパティ |
232
+ | ---------------- | -------------- | ---------------------------------------- |
233
+ | `Alert` | アラート | `variant`, `title`, `dismissible` |
234
+ | `ToastContainer` | 通知コンテナー | 全体に配置し、`toast` シングルトンと併用 |
235
+
236
+ ##### オーバーレイ
237
+
238
+ | コンポーネント | 説明 | 主なプロパティ |
239
+ | -------------- | -------------- | ---------------------------------------------------------------------------- |
240
+ | `Modal` | モーダル(ダイアログ属性・フォーカス制御と復元) | `open`, `title`, `size`, `radius`, `bodyOverflow`, `showClose` |
241
+ | `Drawer` | ドロワー | `open`, `position`, `title`, `size`, `width`, `resizable`, `widthStorageKey` |
242
+ | `Confirm` | 確認ダイアログ | `open`, `title`, `message`, `variant`, `onconfirm` |
243
+ | `Popover` | ポップオーバー | `open`, `position`, `trigger`, `offset`, `portal` |
244
+
245
+ ##### データ表示
246
+
247
+ | コンポーネント | 説明 | 主なプロパティ |
248
+ | -------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
249
+ | `Card` | カードコンテナー | `title`, `bordered`, `shadow`, `padding` |
250
+ | `JsonViewer` | JSON ツリービューアー | `value`, `defaultExpandedDepth`, `maxScalarLength`, `showCopy`, `onCopy`;循環参照はプレースホルダーに置換 |
251
+ | `DataTable` | データテーブル | `data`, `columns`, `keyField`, `loading`, `sortKey`, `sortDir`, `onsort`、`cell` スロット、`onrowclick`(列の `sortable` で並び替え) |
252
+ | `Accordion` | アコーディオン | `items: AccordionItem[]` |
253
+ | `Timeline` | タイムライン | `items: TimelineItem[]` |
254
+
255
+ ##### Bits UI によるヘッドレス UI
256
+
257
+ | コンポーネント | 説明 | 主なプロパティ |
258
+ | -------------- | -------------------------- | ----------------------------------------------------------- |
259
+ | `Combobox` | 検索付き選択(単一・複数) | `options`, `value`, `multiple`, `placeholder`, `size` |
260
+ | `Calendar` | 独立カレンダー | `value: DateValue`, `minValue`, `maxValue` |
261
+ | `DatePicker` | ポップアップ付き日付入力 | `value: DateValue`, `minValue`, `maxValue`, `error`, `size` |
262
+
263
+ > 日付値には `@internationalized/date` の `DateValue` / `CalendarDate` を使います。
264
+
265
+ ##### モバイル・拡張操作
266
+
267
+ | コンポーネント | 説明 | 主なプロパティ |
268
+ | ---------------- | ---------------------- | ------------------------------------------------------ |
269
+ | `ActionSheet` | 下部アクションシート | `open`, `title`, `items`, `cancelText`, `onselect` |
270
+ | `AppBar` | 上部ナビゲーション | `title`, `backHref`, `onback`, `fixed`, `safeArea` |
271
+ | `BottomNav` | 下部ナビゲーション | `items`, `active`, `centered`, `maxWidth` |
272
+ | `InfiniteScroll` | 無限スクロール | `loading`, `finished`, `threshold`, `onload` |
273
+ | `PullRefresh` | プル更新 | `refreshing`, `threshold`, `onrefresh` |
274
+ | `SafeArea` | セーフエリアコンテナー | `top`, `bottom`, `left`, `right` |
275
+ | `SwipeCell` | スワイプ操作 | `leftActions`, `rightActions`, `threshold`, `onaction` |
276
+
277
+ ##### ナビゲーション
278
+
279
+ | コンポーネント | 説明 | 主なプロパティ |
280
+ | -------------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------- |
281
+ | `Tabs` | タブ | `items`, `active`, `type`, `size`, `lazy`, `onactivate` |
282
+ | `Pagination` | ページ分割(共通 table スタイル) | `page`, `total`, `pageSize`, `showTotal`, `showJumper`, `showSizeChanger`, `showPageInfo`, `showFirstLast` |
283
+ | `Breadcrumb` | パンくず | `items`, `separator` |
284
+ | `Steps` | ステップ | `items`, `current`, `direction`, `clickable` |
285
+ | `Dropdown` | ドロップダウンメニュー | `items`, `trigger`, `triggerClass`, `position` |
286
+ | `Tooltip` | ツールチップ | `content`, `position`, `delay` |
287
+
288
+ ##### 状態表示
289
+
290
+ | コンポーネント | 説明 | 主なプロパティ |
291
+ | -------------- | ---------- | ------------------------------------- |
292
+ | `Skeleton` | スケルトン | `variant`, `width`, `height`, `count` |
293
+ | `Empty` | 空状態 | `title`, `description`, `icon` |
294
+ | `Result` | 結果ページ | `status`, `title`, `description` |
295
+
296
+ ##### ページ単位
297
+
298
+ | コンポーネント | 説明 | 主なプロパティ |
299
+ | -------------- | -------------- | ---------------------------------------------- |
300
+ | `PageHeader` | ページヘッダー | `title`, `description`、`actions` スロット対応 |
301
+
302
+ #### Scenes:用途別コンポーネント(47)
303
+
304
+ ##### Guide:案内・ヘルプ(2)
305
+
306
+ | コンポーネント | 説明 | 主なプロパティ |
307
+ | --- | --- | --- |
308
+ | `GuideHost` | 初回案内・ガイド・ヘルプダイアログ | `guide`, `locale`, `scope`, `autoStart` |
309
+ | `HelpCenter` | 独立して使える検索付きヘルプ | `articles`, `tours`, `locale`, `selectedId`, `onstart` |
310
+
311
+ ##### App:アプリ全体(13)
312
+
313
+ | コンポーネント | 説明 | 主なプロパティ |
314
+ | ------------------ | ------------------------------------------- | -------------------------------------------------------- |
315
+ | `FeedbackModal` | フィードバックモーダル | `open`, `onsubmit` |
316
+ | `FeedbackForm` | 独立したフィードバックフォーム | `attachments`, `evidenceSummary`, `onsubmit`, `onfileschange` |
317
+ | `FeedbackList` | サーバー側ページング・絞り込み・処理操作 | `data`, `query`, `permissions`, `onquerychange`, `onstatus` |
318
+ | `FeedbackDetail` | 診断情報・処理履歴・エクスポート | `report`, `evidence`, `attachments`, `history`, `webhook`, `onretry`, `onexport` |
319
+ | `FeedbackScreenshot` | 画像のプレビュー・強調・マスキング | `attachment`, `onannotate` |
320
+ | `SettingsModal` | 設定モーダル | `open`, `onclose` |
321
+ | `SettingsLayout` | 設定レイアウト(区分ナビゲーション + 本文) | `title`, `description`, `sections`, `active`, `onselect` |
322
+ | `LanguageSwitch` | 言語切り替え | プロパティ不要 |
323
+ | `ThemeColorPicker` | テーマカラー選択 | `value`, `presets`, `onchange` |
324
+ | `ThemeSelector` | テーマ選択パネル | プロパティ不要 |
325
+ | `ThemeToggle` | ライト・ダーク切り替え | プロパティ不要 |
326
+
327
+ 詳細 jobs の type: webhook を FeedbackDetail.webhook に渡すと状態・試行回数・安全なエラーコードを表示し、onretry から認可付き retry API を呼びます。「業務情報」タブは kind: business をページ取得し、圧縮添付は操作現場からダウンロードします。
328
+
329
+ 説明は任意です。モーダルを開く前に `@h-ai/feedback/client` の `prepare()` で現場を固定します。`onfileschange` で添付を準備し、`onannotate` で注釈を画像のピクセルに反映します。送信失敗時は入力を保持し、ローカルに出力できます。一覧は説明またはサーバーの要約を表示し、`onquerychange` でページを取得します。UI の権限表示とは別にサーバーの認可が必要です。接続方法とオフラインツールは [feedback モジュール](../feedback/README.ja.md) を参照してください。
330
+
331
+ ##### IAM:認証(13)
332
+
333
+ | コンポーネント | 説明 | 主なプロパティ |
334
+ | -------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------ |
335
+ | `AuthPanel` | 設定による認証画面 | `config`, `actions`, `loginHeader/loginFields/loginFooter`, `registerHeader/registerFields/registerFooter` |
336
+ | `AuthShell` | 認証ページ配置(中央カード / 左右分割) | `variant`, `title`, `subtitle`, `brandTitle`, `brandText`, `illustration`, `description`, `highlights` |
337
+ | `LoginForm` | ログインフォーム | `loading`, `errors`, `showForgotPassword`, `onsubmit` |
338
+ | `RegisterForm` | 登録フォーム | `loading`, `errors`, `fields`, `onsubmit` |
339
+ | `ForgotPasswordForm` | パスワード忘れ | `mode`, `loading`, `errors`, `onsubmit` |
340
+ | `ResetPasswordForm` | パスワードリセット | `loading`, `errors`, `showCode`, `onsubmit` |
341
+ | `ChangePasswordForm` | パスワード変更 | `loading`, `errors`, `requireOldPassword`, `onsubmit` |
342
+ | `PasswordInput` | パスワード入力 | `value`, `showToggle`, `showStrength`, `minLength` |
343
+ | `ReauthenticationDialog` | 機密操作の確認 | `open`, `loading`, `error`, `onsubmit`, `onclose` |
344
+ | `PermGuard` | 権限ガード | `permissions`, `mode`, `fallback` |
345
+ | `UserProfile` | ユーザープロフィール | `user`, `editable`, `fields`, `avatarAccept`, `avatarHint`, `onsubmit` |
346
+ | `SessionRecoveryDialog` | 画面内のセッション復帰 | `recovery`, `actions` |
347
+ | `SensitiveOperationsForm` | 権限の重要操作編集 | `operations`, `onsubmit`, `ondone` |
348
+
349
+ ##### Storage:ストレージ(4)
350
+
351
+ | コンポーネント | 説明 | 主なプロパティ |
352
+ | -------------- | -------------------- | ------------------------------------------------------------ |
353
+ | `FileUpload` | ファイルアップロード | `accept`, `maxSize`, `maxFiles`, `multiple`, `uploadHandler` |
354
+ | `ImageUpload` | 画像アップロード | `value`, `accept`, `maxSize`, `aspectRatio`, `uploadHandler` |
355
+ | `AvatarUpload` | アバターアップロード | `value`, `size`, `maxSize`, `fallback`, `uploadHandler` |
356
+ | `FileList` | ファイル一覧 | `files`, `layout`, `showDelete`, `showDownload` |
357
+
358
+ アップロード部品は presign・ヘッダー・PUT/POST を内蔵しません。アプリは `uploadHandler(file, { signal, onProgress })` からサービスを呼び、`{ url?, response? }` を返します。画像・アバターには表示可能な `url` が必要です。handler がなければ `FileUpload` は選択のみ、画像・アバターはローカルのプレビューのみを作成します。
359
+
360
+ ##### Crypto:暗号表示(3)
361
+
362
+ 入力変更で `encryptedValue` を即座に消去し、現在の入力の成功結果のみを反映します。消去・コールバック置換・破棄で旧リクエストを無効化します。失敗時は組み込みエラーを表示し暗号文は空です。暗号化対象の送信は現在の暗号文が空でない場合に限ってください。
363
+
364
+ `EncryptedInput` は `onencrypt` で実際の暗号サービスに接続する必要があり、`algorithm` はその方式の説明のみです。未設定なら利用不可を示し、暗号文を生成せず、Base64 などへの代替もありません。
365
+
366
+ | コンポーネント | 説明 | 主なプロパティ |
367
+ | ------------------ | ------------ | ------------------------------------------------------- |
368
+ | `EncryptedInput` | 暗号化入力 | `value`, `encryptedValue`, `algorithm`, `showEncrypted` |
369
+ | `HashDisplay` | ハッシュ表示 | `value`, `algorithm`, `copyable`, `truncate` |
370
+ | `SignatureDisplay` | 署名表示 | `signature`, `publicKey`, `algorithm`, `verified` |
371
+
372
+ 既定は `@h-ai/crypto` と共通で、暗号化入力は `SM4`、ハッシュは `SM3`、署名は `SM2` です。
373
+
374
+ ##### AI:文書・表計算(4)
375
+
376
+ | コンポーネント | 説明 | 主なプロパティ・機能 |
377
+ | ------------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------- |
378
+ | `MarkdownRenderer` | Markdown レンダラー | `content`, `fontSize`, `allowHtmlTags`, `showCopyButton`, `enableHighlight` |
379
+ | `AiDocumentDownloadMenu` | 文書ダウンロードメニュー | `actions`, `ondownload` |
380
+ | `AiDocumentEditor` | AI 文書エディター | `content`, `fontSize`, `allowHtmlTags`, `showRunButton`, `showCodePreviewToggle`, `allowUnsafeCodePreview` |
381
+ | `AiTableEditor` | AI 表計算エディター | `columns`, `rows`, `editable`, `ondownload` |
382
+
383
+ > `AiDocumentEditor` は既定で Markdown の内蔵プレビューのみを許可します。HTML / JS / CSS などには明示的な `allowUnsafeCodePreview`、または `oncoderun` による制御済み結果が必要です。
384
+ >
385
+ > Mermaid は追加設定不要です。文書(`sourceKind='document'`)の ` ```mermaid ` を閲覧時に自動描画し、code モード(`sourceKind='code'` + `showCodePreviewToggle`)ではコード・プレビューを切り替えます。`securityLevel: 'strict'` と消毒済み SVG を使い、`allowUnsafeCodePreview` は不要です。
386
+ >
387
+ > `MarkdownRenderer` と `AiDocumentEditor` には表示設定もあります:
388
+ >
389
+ > - `fontSize` は px の `number`、または `1.125rem` などの CSS 長さ。
390
+ > - `allowHtmlTags` は既定で無効です。有効化すると `<b>` / `<i>` / `<u>` / `<mark>` などを安全な許可リストで解析し、危険なタグ・属性は除去します。
391
+ > - 安全な HTML テキストの実体参照は一段だけ解釈し、設定例の引用符、比較記号、`&` を読みやすく表示します。符号化されたタグはテキストのまま保持し、タグとして再解析しません。
392
+ > - `<pre><code class="language-yaml">` などの HTML コードブロックも、安全に再構築した構文色とコピーボタンで表示します。入力の任意スタイルやイベントは保持しません。YAML、TypeScript、Shell、PowerShell、dotenv、Nginx、Dockerfile、Svelte などに対応します。
393
+ > - 生の `<img>` では、1~99999 の正整数ピクセル値の `width` / `height` を保持します。遅延読み込み前に領域を確保し、文書のレイアウトとアンカー位置のずれを減らします。割合、負数、小数、イベント属性、任意の `style` は保持しません。
394
+
395
+ ```svelte
396
+ <MarkdownRenderer content={markdown} fontSize='1.125rem' allowHtmlTags />
397
+
398
+ <AiDocumentEditor
399
+ title='方案文档'
400
+ content={documentMarkdown}
401
+ fontSize={18}
402
+ allowHtmlTags
403
+ showToolbar
404
+ showOutline={false}
405
+ />
406
+ ```
407
+
408
+ ##### Charts:グラフ
409
+
410
+ 軽量ダッシュボードには `MetricCard`(値・単位・変化率)、`ReportCard`(見出し・操作・内容・読み込み/空状態)、`DashboardGrid`(コンテナー幅に応じた一列・二列・複数列)を使います。指標カードだけではグラフエンジンを読み込みません。`trend={12.8}` は +12.8% を意味します。`trendTone` は業務上の意味を別に表すため、減少も success にできます。欠損値・非有限数は「—」、ゼロはそのまま表示します。
411
+
412
+ `Chart` の `preset` は `grouped-bar`、`stacked-bar`、`stacked-area`、`donut`、`sparkline` です。明示的な `type` とネイティブ属性が既定値より優先されます。例として `innerRadius={0.8}` でドーナツの内径を変更できます。他の LayerChart 属性と snippet も引き続き転送されます。
413
+
414
+ レンダラーは種類別に動的読み込みします。SSR は高さを確保してプレースホルダーを表示し、ブラウザのマウント後に描画します。読み込み中・空データではレンダラーを取得しません。看板だけを使う場合は公開 charts エントリを推奨します。高度な図形は ReportCard の children にネイティブ LayerChart 部品を置けます。Chart の五種類に制限されません。互換性のある `layerchart` を明示的依存に追加し、`layerchart/svg` や `layerchart/hierarchy` など実際の公開エントリを使います。高度な部品も必要時に動的読み込みできます。admin の ArcChart 例を参照してください。
415
+
416
+ ```svelte
417
+ <script lang="ts">
418
+ import { Chart, DashboardGrid, MetricCard, ReportCard } from '@h-ai/ui/components/scenes/charts/index'
419
+ const data = [{ month: 'Jan', revenue: 42, cost: 24 }, { month: 'Feb', revenue: 58, cost: 31 }]
420
+ </script>
421
+
422
+ <DashboardGrid label="Key metrics" columns={4}>
423
+ <MetricCard title="Revenue" value="128,430" unit="CNY" trend={12.8} trendTone="success" trendLabel="vs previous month" />
424
+ </DashboardGrid>
425
+ <ReportCard title="Revenue and cost">
426
+ <Chart preset="grouped-bar" {data} x="month" y={['revenue', 'cost']} />
427
+ </ReportCard>
428
+ ```
429
+
430
+
431
+ `Chart type='line'` は既定で LayerChart の折れ線を使います。監視画面で分割線・点・最寄りの点への hover・縦基準線が必要な場合は `lineVariant='segmented-point'` を使います:
432
+
433
+ ```svelte
434
+ <Chart
435
+ type='line'
436
+ data={trendData}
437
+ x='label'
438
+ y={['rateLimit', 'circuitBreak']}
439
+ series={trendSeries}
440
+ lineVariant='segmented-point'
441
+ tooltipMode='nearest'
442
+ showCrosshair
443
+ legend
444
+ grid
445
+ />
446
+ ```
447
+
448
+ ##### CRUD:一覧操作(5)
449
+
450
+ | コンポーネント | 説明 | 主なプロパティ・機能 |
451
+ | ------------------- | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
452
+ | `CrudPage` | CRUD ページ | `crud`, `data`, `permissions`, `form`, `pagination`, `density`, `detailColumns`, `showHeader`, `toolbarLeading`, `toolbarActions`, `card`, `tableCell`, `onrowclick`, `sortableColumns`, `nav`, `loading`, `loaded`, `error`, `onRetry`, `keepPreviousData` |
453
+ | `CrudFilterBar` | 絞り込みツールバー(検索 + 各種フィルター + リセット) | `filterFields`, `searchValue`, `onsearch`, `onfilterchange`, `onreset` |
454
+ | `CrudDetailPanel` | 詳細パネル(ドロワー・モーダル) | `open`, `item`, `fields`, `variant`, `drawerWidth`, `modalSize` |
455
+ | `CrudEditPanel` | 編集パネル(ドロワー・モーダル) | `open`, `fields`, `variant`, `drawerWidth`, `modalSize`, `onsubmit` |
456
+ | `CrudDeleteConfirm` | 削除確認 | `open`, `loading`, `onconfirm` |
457
+
458
+ > `CrudPage` と `FeedbackList` はカード内の検索欄、独立してスクロールする表、下端のページ切り替えを共有します。検索・実行・リセットは常に表示し、追加条件は入力を保持して折りたたみます。検索ボタンまたは Enter で全条件を一度だけ送信し、編集中は検索しません。ページ移動と並べ替えは適用済み条件を使用します。リセットは検索・条件・並べ替えを初期化して先頭ページに戻します。並べ替えボタンは列見出しに表示し、`sortableColumns` にはサーバーが対応する列だけを指定します。`detailColumns` は詳細入口、`toolbarLeading` / `toolbarActions` はカード上の説明・操作、`card` / `tableCell` は独自内容に利用します。条件は `select`、`boolean`、`number`、`date`、`date-range`、`text` に対応します。 `sortableColumns` を省略すると並べ替えボタンは表示せず、サーバー対応列を明示します。
459
+ >
460
+ > ページは親の利用可能な高さを満たします。データの有無にかかわらずテーブルが残りの領域を使い、データ部分のみがスクロールします。見出しはデータ領域の上、ページ分割は一覧カードの下に固定します。
461
+ > ビューポートの外枠からコンテンツまで、各親要素に `flex flex-1 min-h-0 flex-col` などで残りの高さを渡します。中間のラッパーを内容だけの高さにしないでください。空・少数・スクロールする一覧でもページ分割は下部に配置されます。
462
+ >
463
+ > 列は先に 7rem まで縮小し長文を切り詰め、総幅が容器を超える場合のみ横スクロールを出します。操作列は右に固定し、横スクロール中も表示します。
464
+
465
+ ##### エラーページ(1)
466
+
467
+ | コンポーネント | 説明 | 主なプロパティ・機能 |
468
+ | -------------- | -------------------------------------------------- | ----------------------------------------------------------------------- |
469
+ | `ErrorPage` | 401/403/404/500/503 の既定表示付き汎用エラーページ | `status`, `code`, `title`, `description`, `homeUrl`, `onhome`, `onback` |
470
+
471
+ > `CrudPage` の作成・編集の表示は `form` で設定します: `sortableColumns` を省略すると並べ替えボタンは表示せず、サーバー対応列を明示します。
472
+ >
473
+ > - `form.variant`:`'drawer'`(既定)または `'modal'`。
474
+ > - ドロワー:`form.drawerSize` は既定サイズ、`form.drawerWidth` は任意の CSS 幅で優先されます。既定で左端をドラッグでき、リソースごとに幅を記憶します。`form.drawerResizable=false` で無効化。
475
+ > - モーダル:`form.modalSize` は既定サイズ、`form.modalWidth` / `form.modalHeight` は任意の CSS サイズ。
476
+ >
477
+ > `pagination` は常時表示するページ分割欄を設定します。`showSizeChanger`、`pageSizeOptions`、`showJumper`、`showTotal` は既定で有効です。コンパクト表示では `showPageInfo` でページ文言、`showFirstLast` で先頭・末尾ボタンを非表示にできます。
478
+ >
479
+ > `density` は `'normal'`(既定)または `'compact'`。一覧の行・操作・ページ分割・作成/編集/詳細フォームに適用し、ヘッダー・フィルターには影響しません。
480
+ >
481
+ > 読み込み状態は `loading` / `loaded` / `error` / `onRetry` / `keepPreviousData` で制御します。空状態は `loaded && total === 0` の場合のみで、初回応答前の誤表示を防ぎます。初回は検索中、利用可能なデータがない失敗はエラー・再試行(`onRetry`)を表示します。`keepPreviousData`(既定 true)は更新・失敗時に旧データを保持します。
482
+ >
483
+ > SvelteKit SSR を使わないクライアントは、`defineCrud` + `createCrudController` で `data` と `nav` を管理できます。最新リクエスト優先(seq + AbortSignal)、失敗時の旧データ保持、遅延読み込み、並行呼び出しの重複排除を備えます:
484
+ >
485
+ > ```svelte
486
+ > <script>
487
+ > import { CrudPage, createCrudController, defineCrud } from '@h-ai/ui'
488
+ > const crud = defineCrud({ name: 'user', label: '用户', fields: [/* ... */], api: { list: params => listUsers(params) } })
489
+ > const c = createCrudController(crud) // 惰性页签传 { autoLoad: false },首次激活时 c.load()
490
+ > </script>
491
+ > <CrudPage {crud} data={c.data} nav={c.nav} loading={c.loading} loaded={c.loaded} error={c.error} onRetry={c.reload} />
492
+ > ```
493
+ >
494
+ > `Tabs` は遅延表示に対応し、`lazy` では未使用タブの内容を描画しません(`children` の `isActivated(key)` で判定)。`onactivate(key)` は初回のみ実行し、`createCrudController({ autoLoad: false })` と組み合わせて最初に表示されたときに読み込めます。
495
+
496
+ ### 使用例
497
+
498
+ #### Toast 通知
499
+
500
+ ```svelte
501
+ <script>
502
+ import { toast, ToastContainer } from '@h-ai/ui'
503
+
504
+ function notify() {
505
+ toast.success('操作成功')
506
+ toast.error('操作失败')
507
+ toast.warning('请注意')
508
+ toast.info('提示信息', 5000) // 自定义持续时间
509
+ }
510
+ </script>
511
+
512
+ <button onclick={notify}>通知</button>
513
+ <ToastContainer />
514
+ ```
515
+
516
+ 通知は既定で右下に浮かび、ページのレイアウトを変えません。UI モジュールのテーマ色でお知らせ・成功・警告・エラーを区別し、淡い背景、細い色枠、種類別アイコンと控えめな影を使用し、手動で閉じられます。複数の通知は共通の FIFO キューから 1 件ずつ表示され、表示開始から計時します(既定 3 秒、`duration: 0` は手動で閉じるまで保持)。ルートに `<ToastContainer />` を 1 回だけ配置します。`toast.add({ message: m.saved(), variant: 'success', position: 'bottom-center' })` で位置を指定できます。`m.saved()` はアプリの翻訳関数です。位置は `bottom-right`(既定)、`top-right`、`bottom-center`、`top-center`、`bottom-left`、`top-left`。ログイン・保存などの結果と、項目検証を含むすべての警告・エラーは ToastContainer に表示します。項目のエラー表示・読み上げとの関連、継続的な状態と復旧操作は維持します。`Alert` は info/success のみ対応します。
517
+
518
+ F8 で現在の通知にフォーカスし、再度 F8 で元の操作に戻ります。Escape は閉じられる通知だけを閉じ、Enter は閉じるボタンを実行します。Modal 内でも利用でき、通知を閉じてもダイアログは閉じません。閉じられない通知も読み上げ用にフォーカスでき、自動終了時も元の操作に戻ります。
519
+
520
+ > `notifySuccess` / `notifyError` / `notifyInfo` / `notifyWarning` を内蔵しています。`notifyError(err, fallback?)` は通常の Error の内部文言を隠し、代替文言を表示し、traceId は調査情報から確認できます。文字列は翻訳済みの安全な文言のみ渡し、不明な `err.message` を直接渡さないでください。既定は成功 3 秒・失敗 5 秒です。
521
+
522
+ Promise を使うコンポーネントに例外を渡す場合は、`throw new Error(result.error.message, { cause: result.error })` で元のエラーを保持します。`errorMessage` / `notifyError` は深さ制限と循環検出のある Error.cause チェーンから、安全な業務メッセージと traceId を取得します。5xx や不明な例外には安全な代替文言を使用し、内部の例外本文は表示しません。
523
+
524
+ コンポーネントの初期化時に `useToastFeedback(() => error)` へ安全に翻訳された操作メッセージを渡せます。同じ種類・内容の通知はキュー内で統合され、コンポーネントを破棄しても通知は表示されます。元のメッセージの更新・クリア時はその通知を置き換え・削除し、重複判定には traceId も含めます。`message` API も同じキュー・外観・閉じる動作を共有します。`MessageContainer` は `ToastContainer` を表示するため、ルートには片方だけ配置します。
525
+
526
+ 状態層は軽量な `@h-ai/ui/toast` から `toast`、`useToastFeedback`、`notifySuccess` / `notifyError` / `notifyInfo` / `notifyWarning`、`errorMessage` を読み込めます。コンポーネントやガイド CSS は読み込みません。`ToastContainer` はコンポーネントの入口から読み込み、ルートに配置します。
527
+
528
+ traceId は既定で非表示です。`toast.add({ message: m.retry(), variant: 'warning', traceId })` を使用でき、既存の安全な文言の `(traceId: …)` も自動で分離されます。小さなアイコンを開くと、問題の追跡番号、コピーボタン、サポート担当者や開発担当者へ番号を伝える案内が表示されます。コピーできない場合は番号を選択して手動でコピーできます。ホバー・フォーカス・詳細表示中はタイマーが停止し、操作後は残り時間から再開します。`toast.pause(id)` / `toast.resume(id)` も利用できます。旧 Alert の warning/error は Toast に移行し、項目の aria-invalid、読み上げ用説明、復旧操作は維持してください。
529
+
530
+ #### 通知の位置を指定する
531
+
532
+ 以下の `m.saved()` はアプリの翻訳関数です。異なる位置の通知も共通のキューから順番に表示されます。
533
+
534
+ ```ts
535
+ import { toast } from '@h-ai/ui/toast'
536
+
537
+ toast.add({ message: m.saved(), variant: 'success', position: 'top-right' })
538
+ toast.add({ message: m.saved(), position: 'bottom-center' })
539
+ ```
540
+
541
+ #### 標準的な CRUD ページ
542
+
543
+ ```svelte
544
+ <script>
545
+ import {
546
+ PageHeader, Card, DataTable, Button,
547
+ Modal, Input, Select, toast, ToastContainer,
548
+ } from '@h-ai/ui'
549
+
550
+ let items = $state([])
551
+ let showModal = $state(false)
552
+ let loading = $state(false)
553
+ let formData = $state({ name: '', type: '' })
554
+
555
+ const columns = [
556
+ { key: 'name', label: '名称' },
557
+ { key: 'type', label: '类型' },
558
+ { key: 'createdAt', label: '创建时间' },
559
+ ]
560
+
561
+ async function handleCreate() {
562
+ loading = true
563
+ try {
564
+ await fetch('/api/items', { method: 'POST', body: JSON.stringify(formData) })
565
+ showModal = false
566
+ toast.success('创建成功')
567
+ } finally {
568
+ loading = false
569
+ }
570
+ }
571
+ </script>
572
+
573
+ <PageHeader title="项目管理" description="管理所有项目">
574
+ {#snippet actions()}
575
+ <Button onclick={() => showModal = true}>新建</Button>
576
+ {/snippet}
577
+ </PageHeader>
578
+
579
+ <Card>
580
+ <DataTable data={items} {columns} keyField="id" {loading}>
581
+ {#snippet actions(item)}
582
+ <Button size="xs">编辑</Button>
583
+ <Button size="xs" variant="error">删除</Button>
584
+ {/snippet}
585
+ </DataTable>
586
+ </Card>
587
+
588
+ <Modal bind:open={showModal} title="新建项目">
589
+ <form onsubmit={(e) => { e.preventDefault(); handleCreate() }} class="space-y-4">
590
+ <Input placeholder="名称" bind:value={formData.name} required />
591
+ <Select
592
+ placeholder="选择类型"
593
+ bind:value={formData.type}
594
+ options={[
595
+ { value: 'a', label: '类型 A' },
596
+ { value: 'b', label: '类型 B' },
597
+ ]}
598
+ />
599
+ </form>
600
+ {#snippet footer()}
601
+ <Button variant="ghost" onclick={() => showModal = false}>取消</Button>
602
+ <Button {loading} onclick={handleCreate}>创建</Button>
603
+ {/snippet}
604
+ </Modal>
605
+
606
+ <ToastContainer />
607
+ ```
608
+
609
+ `Modal` は `title` / `header` がなくても右上の閉じるボタンを表示し、ヘッダー全体は追加しません。角丸は `radius="1.4rem"`、内部ドロップダウンなどを外に表示する場合は `bodyOverflow="visible"` を指定できます。
610
+
611
+ #### 宣言的な CRUD ページ(CrudPage)
612
+
613
+ ```svelte
614
+ <script lang='ts'>
615
+ import { createSvelteKitNavAdapter } from '@h-ai/kit/client'
616
+ import { CrudPage } from '@h-ai/ui'
617
+
618
+ let { data } = $props()
619
+ const nav = createSvelteKitNavAdapter()
620
+ </script>
621
+
622
+ <CrudPage
623
+ crud={roleCrud}
624
+ {data}
625
+ permissions={{ create: true, update: true, delete: true }}
626
+ form={{ variant: 'modal', modalSize: '3xl', columns: 2, labelPosition: 'top' }}
627
+ pagination={{ showSizeChanger: true, showJumper: true, pageSizeOptions: [10, 20, 50] }}
628
+ density='compact'
629
+ detailColumns={['name']}
630
+ sortableColumns={[{ key: 'createdAt', label: '创建时间' }]}
631
+ {nav}
632
+ />
633
+ ```
634
+
635
+ > ドロワーは `form={{ variant: 'drawer', drawerWidth: '40rem' }}` に変更できます。ユーザーが変更した幅が初期幅より優先され、リソースごとに記憶されます。
636
+
637
+ #### ログインページ
638
+
639
+ ```svelte
640
+ <script>
641
+ import { LoginForm } from '@h-ai/ui'
642
+
643
+ let loading = $state(false)
644
+ let errors = $state({})
645
+
646
+ async function handleLogin(data) {
647
+ loading = true
648
+ errors = {}
649
+ try {
650
+ await fetch('/api/login', { method: 'POST', body: JSON.stringify(data) })
651
+ } catch {
652
+ errors = { general: '登录失败,请检查用户名和密码' }
653
+ } finally {
654
+ loading = false
655
+ }
656
+ }
657
+ </script>
658
+
659
+ <!-- 场景组件内置 i18n,无需传入翻译 props -->
660
+ <LoginForm {loading} {errors} onsubmit={handleLogin} showRegisterLink />
661
+ ```
662
+
663
+ #### PasswordInput の制御モード
664
+
665
+ ```svelte
666
+ <script>
667
+ import { PasswordInput } from '@h-ai/ui'
668
+
669
+ let password = $state('')
670
+ </script>
671
+
672
+ <PasswordInput
673
+ value={password}
674
+ oninput={(e) => { password = e.currentTarget.value }}
675
+ placeholder="请输入密码"
676
+ showStrength
677
+ />
678
+ ```
679
+
680
+ ### フィードバック収集と配布確認
681
+
682
+ フィードバックの `evidence` は脱敏済み資料の内容を表示します。`oncapture(id?)` はページ移動中に画面を閉じ、画像を追加・置換します。`onfileschange` 接続時はブラウザーの無音録画をWebM/MP4添付として確認・削除できます(最大60秒 / 5 MiB、動画は自動マスクされません)。`FeedbackDetail.onreplay` で完全な操作記録を必要時に取得して再生・移動し、ログと環境はページングで取得します。
683
+
684
+ フィードバックの資料部分は独立してスクロールし、操作ボタンを常に表示して展開内容との重なりを防ぎます。`FeedbackList` はアクセシブル名を保持し、ページ見出しはホストが表示して重複を避けます。
685
+
686
+ ### スタイルの依存関係
687
+
688
+ コンポーネントは TailwindCSS v4 + DaisyUI を使います。アプリの `app.css` に次を設定します:
689
+
690
+ ```css
691
+ /* 必须 */
692
+ @import 'tailwindcss';
693
+ @import '@h-ai/ui/styles/global.css'; /* 基础重置、滚动条、焦点样式 */
694
+ @import '@h-ai/ui/styles/theme.css'; /* Tailwind v4 @theme Token(品牌色/阴影/动效) */
695
+ @source "../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
696
+ @source "../../../node_modules/@h-ai/ui/dist/**/*.{svelte,js,ts}";
697
+
698
+ /* 移动端项目追加(可选) */
699
+ @import '@h-ai/ui/styles/design-tokens.css'; /* CSS 自定义属性 */
700
+ @import '@h-ai/ui/styles/mobile.css'; /* 安全区域/触摸优化 */
701
+
702
+ /* DaisyUI 主题 */
703
+ @plugin "daisyui" {
704
+ themes: light --default, dark --prefersdark, cupcake, emerald, corporate, nord, dracula, night;
705
+ }
706
+ ```
707
+
708
+ - `global.css`:HTML リセット、スクロールバー、フォームのフォーカスリング。
709
+ - `theme.css`:ブランドカラー・影・アニメーション曲線・フォント機能を含む Tailwind v4 `@theme`。
710
+ - `design-tokens.css`:余白・角丸・z-index・遷移の CSS 変数。モバイル推奨。
711
+ - `mobile.css`:セーフエリア、慣性スクロール、仮想キーボード対応、モバイルシェル(`hai-mobile-viewport` / `hai-mobile-shell` / `hai-mobile-main`)。
712
+
713
+ モバイルページは `BottomNav` の幅をページシェルに合わせ、デスクトッププレビューで画面全幅になるのを防ぎます:
714
+
715
+ ```svelte
716
+ <div class="hai-mobile-viewport">
717
+ <div class="hai-mobile-shell max-w-lg">
718
+ <AppBar title="Home" fixed={false} safeArea />
719
+ <main class="hai-mobile-main">...</main>
720
+ <BottomNav items={items} active="home" centered maxWidth="lg" safeArea />
721
+ </div>
722
+ </div>
723
+ ```
724
+
725
+ #### アイコン
726
+
727
+ Iconify(Tabler Icons)を使用します:
728
+
729
+ ```bash
730
+ npm install -D @iconify/tailwind4 @iconify-json/tabler
731
+ ```
732
+
733
+ ```css
734
+ /* app.css 中追加 */
735
+ @plugin "@iconify/tailwind4" {
736
+ prefixes: tabler;
737
+ }
738
+ ```
739
+
740
+ #### テーマ切り替え
741
+
742
+ 内蔵ツールで 15 種類の厳選 DaisyUI テーマ、ハイコントラスト、直角ビジネス、目にやさしいテーマを管理します:
743
+
744
+ `high-contrast` は共有 theme.css に含まれます。暗い背景と明るい文字、明確な境界線・フォーカス、補助文字とプレースホルダーの強いコントラストを提供します。ThemeSelector は3言語に対応し、サンプルと既定の生成プロジェクトで選択できます。fullstack の明示的な themes はホスト設定を尊重します。通常文字の配色目標は7:1ですが、各業務コンテンツは別途アクセシビリティ確認が必要です。
745
+
746
+ `eye-care` は共有 theme.css に含まれ、暖かい緑の背景、濃い文字、読みやすいプレースホルダーと明確なフォーカスを提供します。サンプルと既定テンプレートで「目にやさしい」を選択でき、再読み込み後も保持します。既存の既定テーマと fullstack の明示的な themes は維持します。
747
+
748
+ `formal` はボタン・入力欄・カード・ダイアログを直角にし、サンプルと既定テンプレートで選択できます。Button の submitHint は type=submit のネイティブ Enter 操作だけを表示します。LoginForm はデスクトップで準備完了時に既存のフォーカスがなければ識別子へ移動し、autoFocus=false で無効化できます。検索の Enter は IME 確定を除いて即時実行します。テーマは方向キー/Home/End、Enter/Space、Esc とフォーカス復帰に対応し、確認画面は取消を初期選択して Esc の状態を同期します。
749
+
750
+ ```ts
751
+ import {
752
+ applyTheme, // 应用主题(自动持久化到 localStorage)
753
+ createThemeBootstrapScript, // 生成可注入 app.html 的首屏主题恢复脚本
754
+ getCurrentTheme, // 获取当前主题
755
+ getSavedTheme, // 保存済みテーマ。アプリ既定値を指定可能
756
+ getThemeInitScript, // 返回可注入到 HTML shell 的防闪烁脚本文本
757
+ isDarkTheme, // 检查是否暗色主题
758
+ normalizeHexColor, // 归一化 #RGB / #RRGGBB 主题色
759
+ normalizeThemeId, // 校验主题 ID 并自动回退
760
+ THEME_GROUPS, // 按亮色/暗色分组
761
+ THEMES, // ThemeInfo[] — 18 个主题元数据
762
+ } from '@h-ai/ui/theme'
763
+ ```
764
+
765
+ 単純な場合は `getThemeInitScript()` を使えます。独自ストレージ key・テーマカラーの CSS 変数・言語設定がある場合、サーバーの `createThemeBootstrapScript()` で生成して `app.html` に注入することを推奨します。
766
+
767
+ SvelteKit の `app.html` にプレースホルダーを置きます:
768
+
769
+ ```html
770
+ <head>
771
+ <script>%theme_bootstrap%</script>
772
+ </head>
773
+ ```
774
+
775
+ 次に `hooks.server.ts` で注入します:
776
+
777
+ ```ts
778
+ import { createThemeBootstrapScript, DEFAULT_THEME_COLOR_CSS_VAR } from '@h-ai/ui/theme'
779
+
780
+ const themeBootstrapScript = createThemeBootstrapScript({
781
+ storageKey: 'hai-demo-preferences',
782
+ legacyThemeStorageKey: 'hai-demo-theme',
783
+ defaultThemeColor: '#5765f0',
784
+ colorCssVar: DEFAULT_THEME_COLOR_CSS_VAR,
785
+ })
786
+
787
+ transformPageChunk: ({ html }) => html.replace('%theme_bootstrap%', themeBootstrapScript)
788
+ ```
789
+
790
+ ### 国際化(i18n)
791
+
792
+ @h-ai/ui は**コンポーネント内蔵翻訳**を使います:
793
+
794
+ - 用途別コンポーネント(`scenes/`)は中国語・英語・日本語(zh-CN / en-US / ja-JP)を内蔵し、そのまま使えます。
795
+ - `@h-ai/core` と同期した全体 locale の変更へ自動応答します。
796
+ - アプリは**ページ単位の文言**のみを扱い、内部テキストは @h-ai/ui が管理します。
797
+ - 個別文言の変更は `submitText`・`labels` などの props で指定。
798
+
799
+ #### createLocaleStore
800
+
801
+ クライアントの locale 状態を管理し、`@h-ai/core` の全体管理器へ自動同期します:
802
+
803
+ ```svelte
804
+ <script>
805
+ import { createLocaleStore, setGlobalLocale } from '@h-ai/ui/i18n'
806
+ import { setLocale } from '$lib/paraglide/runtime'
807
+
808
+ const localeStore = createLocaleStore()
809
+
810
+ function changeLocale(code) {
811
+ localeStore.set(code) // 更新 UI store + 同步到 @h-ai/core
812
+ setLocale(code) // 同步到 Paraglide(应用层)
813
+ }
814
+ </script>
815
+
816
+ <select value={localeStore.current} onchange={(e) => changeLocale(e.currentTarget.value)}>
817
+ {#each localeStore.supported as l}
818
+ <option value={l.code}>{l.label}</option>
819
+ {/each}
820
+ </select>
821
+ ```
822
+
823
+ `@h-ai/ui/i18n` の createLocaleStore は、解決できる保存値、navigator.languages 全体(その後 navigator.language)、defaultLocale、対応一覧の先頭の順で選択します。未対応の最初の候補で既定値に戻しません。大小文字、言語略称、地域・スクリプトの段階的フォールバックを照合し、設定済みのコードを返します。同じ言語の複数候補は supportedLocales 順です。実際の一致がなければ detectBrowserLocale は null、空の対応一覧では最終的に呼出側の既定値を返します。SSR はブラウザー候補を読まず全体の言語を変更しません。Paraglide アプリは独自の setLocale 同期が必要で、対応一覧の追加だけでは UI 内蔵辞書は増えません。
824
+
825
+ #### エクスポートされる i18n ツール
826
+
827
+ ```ts
828
+ import {
829
+ createLocaleStore, // Svelte 响应式 locale store
830
+ DEFAULT_LOCALE, // 默认 locale: 'zh-CN'
831
+ DEFAULT_LOCALES, // 支持的 locale 列表
832
+ detectBrowserLocale, // 检测浏览器语言
833
+ getGlobalLocale, // 获取当前全局 locale
834
+ interpolate, // 字符串插值(如 "Hello {name}")
835
+ isLocaleSupported, // 检查 locale 是否支持
836
+ resolveLocale, // 解析 locale(支持回退)
837
+ setGlobalLocale, // 设置全局 locale(同步 @h-ai/core)
838
+ } from '@h-ai/ui/i18n'
839
+ ```
840
+
841
+ ### 設定による認証画面
842
+
843
+ 状態層では軽量入口 `@h-ai/ui/i18n` から `authErrorMessage` を読み込み、シーンコンポーネントを読み込まず同じ案内を使えます。管理台の個人パスワード変更、モバイル・デスクトップ例、生成テンプレートで共用します。
844
+
845
+ パスワードログインの送信項目は `identifier` と `password` のみです。`AuthPanel` は `LoginForm` の `username` を `identifier` に変換します。有効期間はサーバーの `session.maxAge` / `session.refreshTokenMaxAge` で設定し、フォームにログインごとの永続セッション選択肢はありません。
846
+
847
+ YAML の `|` で `agreements.userAgreementMarkdown` と `privacyPolicyMarkdown` を設定できます。Modal は本文を安全に描画し、同じ規約の URL より本文を優先します。URL のみの場合は隔離 iframe を使用します。
848
+
849
+ ```yaml
850
+ agreements:
851
+ showOnRegister: true
852
+ showOnLogin: false
853
+ userAgreementMarkdown: |
854
+ # 用户协议
855
+
856
+ **账户使用条款**
857
+
858
+ - 请妥善保管账户凭据。
859
+ privacyPolicyMarkdown: |
860
+ # 隐私政策
861
+
862
+ 注册资料用于账户管理,会话信息用于身份认证。
863
+ # 可选 URL;同主题同时配置 Markdown 和 URL 时,弹窗优先显示 Markdown。
864
+ # userAgreementUrl: https://example.com/terms
865
+ # privacyPolicyUrl: https://example.com/privacy
866
+ ```
867
+
868
+
869
+
870
+ AuthPanel に IAM 公開設定と actions を渡すと、複数方式のログイン、登録、復旧、規約を利用できます。config.ui でレイアウトとブランド画像を指定し、パスワードフォームは passwordPolicy を受け取ります。通信と Token 保存は actions の責務です。
871
+
872
+ 認証エラーには `@h-ai/ui/components/scenes/iam/index` の `authErrorMessage(error)` を使用します。公開コードを現在の UI 言語に変換し、ユーザー名とパスワードの誤りを区別せず、未知・サーバーエラーの原文を隠し、有効な `traceId` を保持します。AuthPanel、OTP 送信、重要操作の再認証、fullstack のパスワード変更で共用します。初期・期限切れパスワード、現在のパスワードの再使用(`hai:iam:034`)、セッション数上限には操作案内を表示します。認証エラーと操作成功は統一 Toast を使用します。確認パスワードはサーバーと同じく Unicode 正規化や空白除去をせず厳密に比較し、不一致をフィールドに表示します。
873
+
874
+ AuthPanel は SSR 中のフォーム操作を無効にし、クライアントのマウントとイベント登録が完了してから入力を有効にします。ハイドレーションによる入力の消失を防ぎ、アプリ側の追加の準備処理は不要です。E2E では入力可能な状態を待ち、クライアントスクリプトの読み込みが遅れる場合も検証します。
875
+
876
+ 認証リンクが現在の完全な URL を指す場合、AuthPanel は再ナビゲーションせずに画面だけを切り替え、ログインに戻った直後の入力を保持します。パス、クエリー、hash が異なる場合はアプリのルーターに任せます。Ctrl/Cmd などの修飾キーを使ったクリックはブラウザーの動作を維持します。
877
+
878
+ `createSensitiveActions` は標準 actions の `publicConfig()` で操作前に DB 規則を更新できます。`SensitiveOperationsForm` は行入力・重複除去・検証・エラー表示を共通化します。`operations` と HaiResult を返す非同期 `onsubmit(operations)` を渡し、成功時のみ `ondone` を呼びます。DB の追加を空にしてもファイルの規則は解除しません。
879
+
880
+ 期限切れの画面内復帰は `createSessionRecovery()` と `SessionRecoveryDialog` を使います。公開設定と元の `{ id, username }` を configure し、`recovery.recover` を Kit/API client の `recoverSession` に渡します。ダイアログに同じ controller と標準 actions を渡し、破棄時に `cancel()` します。UI にパスワードや業務要求を保存しません。`expectedUserId` は発行前に元の本人を検証し、通常の CAPTCHA・ロック・アクセス・改密方針を適用します。取消は入力を保持し、結果不明の通信障害では書込を再送しません。再読込や終了で失われたメモリの入力は復元できません。
881
+
882
+ `createSensitiveActions(actions)` はKit/API clientの認証アクションを受け取り、ログイン済み利用者の確認・取消・再試行・重複送信・遅延応答を共通処理します。アプリのルートレイアウトごとに生成し、`configure(公開設定)` で更新、破棄時は `cancel()` を呼びます。`authorize(operation)` は確認不要ならundefined、取消/処理中ならnull、成功なら当該操作の証明を返します。取消時は業務リクエストを送らず、証明は対象リクエストにのみ渡します。共有ヘッダーや永続ストレージには保存しません。`ReauthenticationDialog` に `open/loading/error/submit/cancel` を接続します。確認は権限を増やしません。`Input` の `datetime-local` はブラウザーのローカル時刻のため、サービスで明確なタイムスタンプへ変換して送信します。
883
+
884
+ ```svelte
885
+ <!-- actionsはKit/API clientの認証アクション、policyはIAMの公開再認証設定です。 -->
886
+ <script lang='ts'>
887
+ import type { SensitiveActionsOptions } from '@h-ai/ui'
888
+ import { createSensitiveActions, ReauthenticationDialog } from '@h-ai/ui'
889
+
890
+ const { actions, policy }: { actions: SensitiveActionsOptions, policy: { enabled: boolean, operations: string[] } } = $props()
891
+ const confirmation = createSensitiveActions(actions)
892
+ $effect(() => {
893
+ confirmation.configure(policy)
894
+ return () => confirmation.cancel()
895
+ })
896
+ // 業務操作でconfirmation.authorize(operation)を待ち、nullなら中止します。
897
+ </script>
898
+ <ReauthenticationDialog
899
+ open={confirmation.open}
900
+ loading={confirmation.loading}
901
+ error={confirmation.error}
902
+ onsubmit={password => confirmation.submit(password)}
903
+ onclose={() => confirmation.cancel()}
904
+ />
905
+ ```
906
+
907
+ [完整 IAM 配置 / IAM configuration](../iam/README.ja.md)
908
+
909
+ ### 初回ガイドとヘルプセンター
910
+
911
+ `@h-ai/ui/guide` から `createGuide`、`GuideHost`、`HelpCenter` をインポートします。init/close は不要です。ガイド開始時にエンジンを読み込み、既存テーマと中国語・英語・日本語の共通文言を使用します。業務内容はアプリの翻訳関数を使います。
912
+
913
+ 同じ入口の `resolveGuideText(text?)` は文字列や i18n コールバックを評価します。ホストコンポーネントは文言を自動で解析します。
914
+
915
+ レイアウト内でコントローラーを作成し、id/title/steps と任意の route/version を登録します。`<GuideHost {guide} {locale} scope={user.id} autoStart='overview' />` を配置し、対象コンポーネントに data-guide を付けます。SPA は既存の NavAdapter を提供してください。
916
+
917
+ ```svelte
918
+ <script lang='ts'>
919
+ import { createGuide, GuideHost } from '@h-ai/ui/guide'
920
+
921
+ const guide = createGuide({
922
+ nav,
923
+ persistKey: 'my-app-guide',
924
+ tours: [{
925
+ id: 'users',
926
+ version: 1,
927
+ route: '/users',
928
+ title: () => m.guide_users_title(),
929
+ description: () => m.guide_users_description(),
930
+ steps: [{
931
+ target: 'users-create',
932
+ title: () => m.guide_create_title(),
933
+ description: () => m.guide_create_description(),
934
+ }],
935
+ }],
936
+ articles: [{
937
+ id: 'users-help',
938
+ title: () => m.guide_users_title(),
939
+ content: () => m.guide_users_markdown(),
940
+ tourId: 'users',
941
+ }],
942
+ })
943
+ </script>
944
+
945
+ <GuideHost {guide} {locale} scope={user.id} autoStart='users' />
946
+ <Button onclick={() => guide.openHelp()}>{m.help()}</Button>
947
+ <!-- 在目标页面为现有按钮添加锚点,无需额外包装。 -->
948
+ <Button data-guide='users-create' onclick={createUser}>{m.create_user()}</Button>
949
+ ```
950
+
951
+ start(id) は Promise<boolean> を返し、手動で再表示できます。失敗時は false と error を設定します。startIfNeeded(id) は初回案内の有無を boolean で返します。openHelp(articleId?) は検索付き Markdown ヘルプを開き、stop() は完了として記録せず終了し、reset(id) は現在のユーザーの状態を削除します。
952
+
953
+ 閉じるボタン、Escape、オーバーレイのクリックは、最初の位置決めフレームが完了する前でも待機と `busy` 状態を解除します。開始中の `start()` は false を返し、完了として記録しません。
954
+
955
+ 保存先は cookie(既定)、localStorage、memory です。保存が制限された環境ではインスタンス内のメモリーに戻ります。ユーザーとバージョンごとに状態を分け、後で表示は一日延期、Cookie は一年保存します。既定のページ遷移は短期 sessionStorage 記録で移動先から開始します。
956
+
957
+ 文言は `() => m.key()` で遅延評価し、現在の locale を渡します。説明はプレーンテキスト、ヘルプは安全な MarkdownRenderer を使用し、生 HTML を無効にします。要素の待機は既定で 3000ms。before(signal) でタブ等を準備し、optional の要素のみ省略できます。必要な要素がなければ終了し、アンマウント時に処理を解除します。SSR ユーザー間でコントローラーを共有しないでください。
958
+
959
+ HelpCenter は articles、任意の tours、locale、selectedId、onstart で独立ページにも配置できます。admin-console と CLI fullstack Web/App/Desktop は初回案内、ヘルプ、プロフィールガイドを標準搭載します。[詳細ガイド](../cli/templates/skills/hai-ui/guide.md)を参照してください。
960
+
961
+ ### その他のエクスポート
962
+
963
+ ```ts
964
+ // 类型
965
+ import type { ButtonProps, InputProps, ModalProps } from '@h-ai/ui'
966
+ ```
967
+
968
+ ```ts
969
+ // 样式工具
970
+ import { cn, generateId, getSizeClass, getVariantClass } from '@h-ai/ui'
971
+ ```
972
+
973
+ ```ts
974
+ // Toast 单例
975
+ import { toast } from '@h-ai/ui'
976
+ ```
977
+
978
+ 規約は入力を保持したまま Modal で表示します。ページは iframe 埋め込みを許可し、スクリプトを無効化して別ウィンドウ表示も用意します。LoginForm/RegisterForm は `header/extraFields/footer`、AuthPanel は `loginHeader/loginFields/loginFooter` と `registerHeader/registerFields/registerFooter` を提供し、既定ナビゲーションを保持します。追加フィールドはアプリ状態と独自 actions で処理し、IAM に自動送信しません。拡張ボタンは `type="button"` を指定します。
979
+
980
+ ```svelte
981
+ <!-- config 来自 IAM 公开配置,actions 来自 Kit/API client;m 为应用翻译。 -->
982
+ <AuthPanel {config} {actions}>
983
+ {#snippet loginHeader()}
984
+ <p>{m.loginHelp()}</p>
985
+ {/snippet}
986
+ {#snippet registerFields()}
987
+ <label><input type='checkbox' bind:checked={subscribe} />{m.subscribe()}</label>
988
+ {/snippet}
989
+ </AuthPanel>
990
+ ```
991
+
992
+
993
+ コンポーネントのサブパスは package.exports に明記した barrel(例: `@h-ai/ui/components/primitives/index`)に限定します。内部実装やストレージ補助関数は非公開で、ホストのクリップボード登録は引き続き公開します。
994
+
995
+ ### リクエスト言語の分離
996
+
997
+ Node リクエストと SSR は `core.i18n.runWithLocale(locale, () => handleRequest())` で囲みます。SvelteKit は `kit.i18n.runWithLocale(locale, () => resolve(event))` を使えます。serv はリクエストヘッダーから自動設定します。非同期の子処理も言語を継承し、明示的な `MessageOptions.locale`、リクエスト言語、起動時の既定値の順で優先します。コンテキスト内の `setGlobalLocale` はそのリクエストだけを変更します。コンテキスト外の設定は起動時に限定し、リクエスト hook から呼びません。
998
+
999
+ ブラウザーはアプリ全体の `setGlobalLocale` / `createLocaleStore` を使います。SSR の UI store 初期化と setter は自身の状態のみ変更し、メッセージはリクエストコンテキストを参照します。`runWithLocale` は Node 入口専用です。
1000
+
1001
+ ## 入力制約と HTTP 機能
1002
+
1003
+ キーは UTF-8 で最大 1024 バイトで、絶対パス、バックスラッシュ、制御文字、ドットセグメントを拒否します。公開 HTTP 一括削除は一度に 1–1000 件です。共通規則はブラウザー対応の `@h-ai/storage/schemas` から参照できます。署名有効期限は整数 1–604800 秒(Node 既定 3600、HTTP 既定 900)。アップロード署名の入力は key/contentType/expiresIn のみで、contentLength/maxSize/metadata/checksum は未対応です。不正入力は HTTP 400、typed client では VALIDATION_FAILED です。FileUpload の制限は選択時の補助であり、実際のオブジェクトはサーバーで検証してください。Node のストリーム/checksum/条件付き書き込みには既定の HTTP エンドポイントがありません。[機能と認可の対応表(中国語)](../storage/README.md#存储输入约束与跨端能力)を参照してください。
1004
+
1005
+ ## コンパクトな作業領域と折りたたみ式の絞り込み
1006
+
1007
+ `WorkspaceLayout` はコンパクトなナビゲーション、12/16px の余白を持つ本文、任意のフッターを統一します。フッターを省略すると高さを確保しません。title はナビゲーションのページ名、leading/actions/footer は snippet です。data-* は本文の main に渡します。親レイアウトから残りの高さと min-height: 0 を引き継いでください。
1008
+
1009
+ 同名の `PageHeader` は重複する見出しを省略し、説明と操作を保持します。`SettingsLayout` も同じ動作です。作業領域内の `CrudPage` は既定でナビゲーションの見出しだけを表示し、操作をツールバーに残します。単独利用時は見出しを表示し、showHeader で明示的に変更できます。
1010
+
1011
+ `FilterBar` は leading と actions を常に表示し、children を既定で折りたたみます。bind:expanded は開閉、activeCount は適用中の件数、onreset は3言語対応のリセットボタンです。折りたたんでも入力を保持し、条件の初期化と問い合わせは業務側のコールバックが担当します。`TableToolbar` は同じレイアウトとネイティブ検索フォームを提供し、`CrudFilterBar` もその実装を共有します。`onsearch` は現在の検索・条件を送信し、`onfilterchange` は編集中の変更だけを通知します。`onreset`(TableToolbar は `onclearfilters`)で適用済み条件を初期化して再検索します。旧 `toolbarStyle` と並べ替えポップアップ・属性は削除され、DataTable の `sortKey`、`sortDir`、`onsort` を使用します。 展開した条件はコンテナ幅に応じて1/2/4/6列となり、横20px・縦16pxの間隔でラベルと同じ高さの入力欄を揃えます。日付範囲は2列を占め、狭い画面では行全体に配置します。
1012
+
1013
+ 例の m、statusOptions、clearFilters、loadRows は業務アプリが提供します。リセット時は検索語と全条件を初期化してください。
1014
+
1015
+ ```svelte
1016
+ <script lang="ts">
1017
+ import { Button, FilterBar, Input, Select, WorkspaceLayout } from '@h-ai/ui'
1018
+ let search = $state('')
1019
+ let status = $state('')
1020
+ </script>
1021
+
1022
+ <div class="flex h-dvh min-h-0">
1023
+ <WorkspaceLayout title={m.page_title()}>
1024
+ <FilterBar activeCount={status ? 1 : 0} onreset={clearFilters}>
1025
+ {#snippet leading()}<Input size="sm" bind:value={search} placeholder={m.search()} />{/snippet}
1026
+ {#snippet actions()}<Button size="sm" onclick={loadRows}>{m.search()}</Button>{/snippet}
1027
+ <div class="w-40"><Select size="sm" bind:value={status} options={statusOptions} /></div>
1028
+ </FilterBar>
1029
+ </WorkspaceLayout>
1030
+ </div>
1031
+ ```
1032
+
1033
+ ## デザインと操作の検証
1034
+
1035
+ 画面設計は [hai-ui-design](../cli/templates/skills/hai-ui-design/SKILL.md)、実装は [hai-ui](../cli/templates/skills/hai-ui/SKILL.md)、実画面の確認は [hai-ui-review](../cli/templates/skills/hai-ui-review/SKILL.md) を参照してください。[共通設計指針](../../.agents/instructions/ui-design.md) も利用できます。
1036
+
1037
+ Tabs は方向キー・Home/End、無効項目のスキップと単一の Tab 入口に対応します。表は並べ替え・読み込み状態と行のキーボード操作を提供します。ページ切り替えのラベルは言語に従い、外部ページ変更を入力欄に同期します。展開した条件は文書のフォーカス順序に従い、表示切り替えの選択状態を提供します。Empty/Alert は長文を折り返します。theme.css は共通 tokens を読み込み、global.css は動きを減らす設定に対応します。業務側で検索、並べ替え、ページ切り替えと復旧処理を接続してください。
1038
+
1039
+ ## エラー表示とログの関連付け
1040
+
1041
+ HTTP エラーには安全な翻訳文と追跡番号を含めます。ToastContainer の本文には番号を表示せず、調査情報のアイコンから表示・コピーできます。同じ ID を error.traceId と X-Trace-Id に返します。requestId を traceId として共有し、ブラウザーとサーバーのログを関連付けます。脱機密化した例外・スタック・操作情報はログに残し、内部 cause/ext は公開しません。項目検証は翻訳済みの項目名とメッセージだけを返します。
1042
+
1043
+ HTTP/UI 境界には core.error.toPublic(error, traceId?)、再翻訳後の表示には core.error.formatMessage(error) を使い、ID を重複追加しません。ログには完全な Error を渡してください。DB ログにはドライバーコード、脱機密化したメッセージ・スタック、表・列を残し、SQL 本文、バインド値と接続認証情報を記録しません。
1044
+
1045
+ ## 任意の対話チャレンジ
1046
+
1047
+ AuthPanel は config.captcha.enabled の場合 actions.createCaptcha で自己ホスト ALTCHA を自動生成・非同期求解し、login/register/sendOtp/passwordReset/renewPassword 用の単用証明を送信します。無効時は求解器を読み込みません。createAuthActions は対応済みで、独自動作は captcha を保持し、不足時は通過しません。証明は現在のメモリ内だけに保持し、サーバーで必ず検証・消費します。
1048
+
1049
+ 方針・既定値・復旧範囲は次を参照: [IAM](../iam/README.ja.md)。
1050
+
1051
+ ## 開発とテスト
1052
+
1053
+ ```sh
1054
+ pnpm --filter @h-ai/ui typecheck
1055
+ pnpm --filter @h-ai/ui lint
1056
+ pnpm --filter @h-ai/ui build
1057
+ pnpm --filter @h-ai/ui test
1058
+ ```
1059
+
1060
+ ## ライセンス
1061
+
1062
+ Apache-2.0