@h-ai/ui 1.0.0-beta.3 → 1.0.0-beta.30

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 (169) hide show
  1. package/README.en.md +251 -71
  2. package/README.ja.md +250 -70
  3. package/README.md +252 -73
  4. package/auto-import.d.ts +5 -0
  5. package/auto-import.js +242 -65
  6. package/dist/components/compounds/Accordion.svelte +6 -2
  7. package/dist/components/compounds/BottomNav.svelte +14 -2
  8. package/dist/components/compounds/Card.svelte +3 -1
  9. package/dist/components/compounds/Combobox.svelte +41 -5
  10. package/dist/components/compounds/DataTable.svelte +28 -8
  11. package/dist/components/compounds/DatePicker.svelte +6 -1
  12. package/dist/components/compounds/Drawer.svelte +12 -4
  13. package/dist/components/compounds/Dropdown.svelte +135 -59
  14. package/dist/components/compounds/Empty.svelte +10 -2
  15. package/dist/components/compounds/FormField.svelte +10 -2
  16. package/dist/components/compounds/JsonViewer.svelte +18 -6
  17. package/dist/components/compounds/Modal.svelte +8 -2
  18. package/dist/components/compounds/Pagination.svelte +22 -7
  19. package/dist/components/compounds/Popover.svelte +93 -12
  20. package/dist/components/compounds/Steps.svelte +24 -8
  21. package/dist/components/compounds/SwipeCell.svelte +3 -1
  22. package/dist/components/compounds/TableToolbar.svelte +32 -9
  23. package/dist/components/compounds/Tabs.svelte +25 -5
  24. package/dist/components/compounds/TagInput.svelte +2 -0
  25. package/dist/components/compounds/Timeline.svelte +6 -2
  26. package/dist/components/compounds/ToastContainer.svelte +41 -10
  27. package/dist/components/compounds/Tooltip.svelte +1 -1
  28. package/dist/components/compounds/Tooltip.svelte.d.ts +1 -1
  29. package/dist/components/control-size.js +48 -8
  30. package/dist/components/primitives/Avatar.svelte +9 -3
  31. package/dist/components/primitives/BareInput.svelte +3 -1
  32. package/dist/components/primitives/Button.svelte +6 -2
  33. package/dist/components/primitives/Checkbox.svelte +5 -0
  34. package/dist/components/primitives/IconButton.svelte +3 -1
  35. package/dist/components/primitives/Input.svelte +19 -3
  36. package/dist/components/primitives/Radio.svelte +4 -1
  37. package/dist/components/primitives/Range.svelte +3 -1
  38. package/dist/components/primitives/Rating.svelte +9 -3
  39. package/dist/components/primitives/Select.svelte +21 -5
  40. package/dist/components/primitives/Tag.svelte +6 -10
  41. package/dist/components/primitives/Textarea.svelte +14 -2
  42. package/dist/components/scenes/ai/AiDocumentEditor.svelte +45 -69
  43. package/dist/components/scenes/ai/document-download.js +6 -2
  44. package/dist/components/scenes/ai/document-parse.js +24 -8
  45. package/dist/components/scenes/ai/document-types.d.ts +0 -12
  46. package/dist/components/scenes/ai/editor-markdown-extensions.js +9 -3
  47. package/dist/components/scenes/ai/highlight.js +3 -1
  48. package/dist/components/scenes/ai/index.d.ts +1 -1
  49. package/dist/components/scenes/ai/markdown-parse.js +36 -10
  50. package/dist/components/scenes/ai/mermaid-render.js +13 -1
  51. package/dist/components/scenes/ai/safe-html.js +9 -3
  52. package/dist/components/scenes/ai/table/AiTableEditor.svelte +28 -16
  53. package/dist/components/scenes/app/FeedbackDetail.svelte +102 -24
  54. package/dist/components/scenes/app/FeedbackForm.svelte +70 -16
  55. package/dist/components/scenes/app/FeedbackList.svelte +138 -21
  56. package/dist/components/scenes/app/FeedbackRecorder.svelte +18 -5
  57. package/dist/components/scenes/app/FeedbackReplay.svelte +15 -3
  58. package/dist/components/scenes/app/FeedbackScreenshot.svelte +64 -13
  59. package/dist/components/scenes/app/LanguageSwitch.svelte +6 -2
  60. package/dist/components/scenes/app/SettingsLayout.svelte +3 -1
  61. package/dist/components/scenes/app/ThemeSelector.svelte +29 -5
  62. package/dist/components/scenes/app/ThemeToggle.svelte +6 -2
  63. package/dist/components/scenes/app/WorkspaceLayout.svelte +1 -1
  64. package/dist/components/scenes/app/feedback-functions.js +6 -2
  65. package/dist/components/scenes/charts/Chart.svelte +55 -21
  66. package/dist/components/scenes/charts/Chart.svelte.d.ts +0 -1
  67. package/dist/components/scenes/charts/ChartLoadError.svelte +13 -0
  68. package/dist/components/scenes/charts/ChartLoadError.svelte.d.ts +6 -0
  69. package/dist/components/scenes/charts/DashboardGrid.svelte +34 -0
  70. package/dist/components/scenes/charts/DashboardGrid.svelte.d.ts +15 -0
  71. package/dist/components/scenes/charts/MetricCard.svelte +69 -0
  72. package/dist/components/scenes/charts/MetricCard.svelte.d.ts +15 -0
  73. package/dist/components/scenes/charts/ReportCard.svelte +48 -0
  74. package/dist/components/scenes/charts/ReportCard.svelte.d.ts +15 -0
  75. package/dist/components/scenes/charts/chart-presets.d.ts +15 -0
  76. package/dist/components/scenes/charts/chart-presets.js +56 -0
  77. package/dist/components/scenes/charts/chart-types.d.ts +13 -2
  78. package/dist/components/scenes/charts/dashboard-types.d.ts +79 -0
  79. package/dist/components/scenes/charts/dashboard-types.js +1 -0
  80. package/dist/components/scenes/charts/index.d.ts +6 -2
  81. package/dist/components/scenes/charts/index.js +4 -1
  82. package/dist/components/scenes/charts/renderers/AreaChart.svelte +1 -0
  83. package/dist/components/scenes/charts/renderers/AreaChart.svelte.d.ts +1 -0
  84. package/dist/components/scenes/charts/renderers/BarChart.svelte +1 -0
  85. package/dist/components/scenes/charts/renderers/BarChart.svelte.d.ts +1 -0
  86. package/dist/components/scenes/charts/renderers/LineChart.svelte +39 -12
  87. package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +1 -0
  88. package/dist/components/scenes/charts/renderers/PieChart.svelte +1 -0
  89. package/dist/components/scenes/charts/renderers/PieChart.svelte.d.ts +1 -0
  90. package/dist/components/scenes/charts/renderers/ScatterChart.svelte +1 -0
  91. package/dist/components/scenes/charts/renderers/ScatterChart.svelte.d.ts +1 -0
  92. package/dist/components/scenes/code/CodeWorkspace.svelte +946 -0
  93. package/dist/components/scenes/code/CodeWorkspace.svelte.d.ts +21 -0
  94. package/dist/components/scenes/code/CodeWorkspaceEditor.svelte +737 -0
  95. package/dist/components/scenes/code/CodeWorkspaceEditor.svelte.d.ts +37 -0
  96. package/dist/components/scenes/code/CodeWorkspaceGutter.svelte +246 -0
  97. package/dist/components/scenes/code/CodeWorkspaceGutter.svelte.d.ts +23 -0
  98. package/dist/components/scenes/code/CodeWorkspaceSearch.svelte +234 -0
  99. package/dist/components/scenes/code/CodeWorkspaceSearch.svelte.d.ts +23 -0
  100. package/dist/components/scenes/code/CodeWorkspaceTree.svelte +519 -0
  101. package/dist/components/scenes/code/CodeWorkspaceTree.svelte.d.ts +26 -0
  102. package/dist/components/scenes/code/code-editor.d.ts +12 -0
  103. package/dist/components/scenes/code/code-editor.js +93 -0
  104. package/dist/components/scenes/code/code-types.d.ts +346 -0
  105. package/dist/components/scenes/code/code-types.js +1 -0
  106. package/dist/components/scenes/code/index.d.ts +2 -0
  107. package/dist/components/scenes/code/index.js +1 -0
  108. package/dist/components/scenes/code/workers/css.worker.d.ts +1 -0
  109. package/dist/components/scenes/code/workers/css.worker.js +1 -0
  110. package/dist/components/scenes/code/workers/editor.worker.d.ts +1 -0
  111. package/dist/components/scenes/code/workers/editor.worker.js +1 -0
  112. package/dist/components/scenes/code/workers/html.worker.d.ts +1 -0
  113. package/dist/components/scenes/code/workers/html.worker.js +1 -0
  114. package/dist/components/scenes/code/workers/json.worker.d.ts +1 -0
  115. package/dist/components/scenes/code/workers/json.worker.js +1 -0
  116. package/dist/components/scenes/code/workers/ts.worker.d.ts +1 -0
  117. package/dist/components/scenes/code/workers/ts.worker.js +1 -0
  118. package/dist/components/scenes/crud/CrudDetailDrawer.svelte +6 -2
  119. package/dist/components/scenes/crud/CrudDetailPanel.svelte +6 -2
  120. package/dist/components/scenes/crud/CrudEditPanel.svelte +41 -12
  121. package/dist/components/scenes/crud/CrudPage.svelte +34 -9
  122. package/dist/components/scenes/crud/crud-controller.svelte.js +23 -8
  123. package/dist/components/scenes/crud/crud-form-validation.js +27 -9
  124. package/dist/components/scenes/crypto/EncryptedInput.svelte +9 -3
  125. package/dist/components/scenes/error/error-presets.js +30 -5
  126. package/dist/components/scenes/guide/GuideHostContent.svelte +7 -1
  127. package/dist/components/scenes/guide/HelpCenter.svelte +23 -4
  128. package/dist/components/scenes/iam/AgreementNotice.svelte +9 -3
  129. package/dist/components/scenes/iam/AuthPanel.svelte +74 -16
  130. package/dist/components/scenes/iam/ChangePasswordForm.svelte +6 -2
  131. package/dist/components/scenes/iam/ForgotPasswordForm.svelte +9 -3
  132. package/dist/components/scenes/iam/LoginForm.svelte +32 -8
  133. package/dist/components/scenes/iam/PasswordInput.svelte +50 -12
  134. package/dist/components/scenes/iam/RegisterForm.svelte +11 -3
  135. package/dist/components/scenes/iam/ResetPasswordForm.svelte +6 -2
  136. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte +3 -1
  137. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte +4 -1
  138. package/dist/components/scenes/iam/UserProfile.svelte +41 -14
  139. package/dist/components/scenes/iam/auth-captcha.js +9 -2
  140. package/dist/components/scenes/iam/auth-error-message.d.ts +2 -2
  141. package/dist/components/scenes/iam/auth-error-message.js +16 -3
  142. package/dist/components/scenes/iam/password-utils.js +9 -2
  143. package/dist/components/scenes/iam/sensitive-actions.svelte.js +4 -1
  144. package/dist/components/scenes/index.d.ts +1 -0
  145. package/dist/components/scenes/index.js +2 -0
  146. package/dist/components/scenes/storage/FileList.svelte +3 -1
  147. package/dist/components/scenes/storage/FileUpload.svelte +7 -2
  148. package/dist/components/scenes/types.d.ts +2 -2
  149. package/dist/guide-storage.js +12 -4
  150. package/dist/guide.svelte.js +59 -16
  151. package/dist/i18n.svelte.js +9 -3
  152. package/dist/internal/dialog-focus.d.ts +19 -0
  153. package/dist/internal/dialog-focus.js +104 -4
  154. package/dist/internal/form-validation.svelte.js +46 -15
  155. package/dist/internal/icon-safety.js +6 -2
  156. package/dist/message.svelte.js +6 -2
  157. package/dist/messagebox.svelte.js +6 -2
  158. package/dist/messages/en-US.json +60 -2
  159. package/dist/messages/ja-JP.json +60 -2
  160. package/dist/messages/zh-CN.json +60 -2
  161. package/dist/styles/eye-care.css +55 -0
  162. package/dist/styles/global.css +16 -0
  163. package/dist/styles/theme.css +1 -0
  164. package/dist/theme-config.d.ts +1 -3
  165. package/dist/theme-config.js +137 -22
  166. package/dist/toast.svelte.js +27 -7
  167. package/dist/types.d.ts +3 -3
  168. package/dist/utils.js +6 -2
  169. package/package.json +25 -19
package/README.ja.md CHANGED
@@ -4,21 +4,13 @@
4
4
 
5
5
  [フレームワークのホーム](../../README.ja.md) · 関連モジュール:[@h-ai/core](../core/README.ja.md)
6
6
 
7
- ## 概要
8
-
9
7
  内蔵メッセージは `zh-CN`、`en-US`、`ja-JP` に対応し、言語セレクターは既定で3言語を表示します。
10
8
 
11
- Svelte 5 Runes のクロスプラットフォーム UI ライブラリーです。DaisyUI v5 + Tailwind CSS v4 のスタイル、Bits UI v2 のヘッドレス UI、内蔵 i18n(zh-CN / en-US / ja-JP)、15 種類の厳選テーマ、ハイコントラストと直角のビジネステーマを提供します。
9
+ Svelte 5 Runes のクロスプラットフォーム UI ライブラリーです。DaisyUI v5 + Tailwind CSS v4 のスタイル、Bits UI v2 のヘッドレス UI、内蔵 i18n(zh-CN / en-US / ja-JP)、15 種類の厳選テーマ、ハイコントラスト、直角ビジネス、目にやさしいテーマを提供します。
12
10
 
13
- ## 主な機能
11
+ HTTP/UI 境界で業務メッセージを公開するのは、明示された有効な4xx状態のみです。`httpStatus` が未指定または不正な場合は500として安全なメッセージを返します。独自の業務エラーには完全なエラー定義または明示的な状態を指定してください。
14
12
 
15
- - フォーム、テーブル、ダイアログ、ナビゲーション、チャートなどの部品。
16
- - 認証、CRUD、AI コンテンツ、操作ガイド、ヘルプセンター。
17
- - Svelte 5、テーマ、レスポンシブ表示、中国語・英語・日本語のコンポーネント文言。
18
-
19
- Markdown の下線と強調マーカーはエスケープに対応し、閉じていないマーカーはテキストとして扱います。長い異常入力でも Toast と文書出力で反復走査を避け、追跡 ID は既定で折りたたみます。
20
-
21
- ## 使い始める
13
+ ## クイックスタート
22
14
 
23
15
  ### インストール
24
16
 
@@ -28,50 +20,45 @@ npm install @h-ai/ui @h-ai/core
28
20
 
29
21
  Node サーバーでは UI と core の両方を本番依存に含め、ログなどのネイティブ依存を通常どおり読み込めるようにします。
30
22
 
31
- ### クイックスタート
23
+ ### 1. package.json のアプリ内インポートを設定
32
24
 
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'
25
+ ```json
26
+ { "imports": { "#lib/*": "./src/lib/*" } }
27
+ ```
39
28
 
40
- /** @type {import('@sveltejs/kit').Config} */
41
- const config = {
42
- preprocess: [autoImportHaiUi(), vitePreprocess()],
43
- compilerOptions: { runes: true },
44
- kit: { adapter: adapter() },
45
- }
29
+ ### 2. vite.config.ts を設定
46
30
 
47
- export default config
48
- ```
31
+ SvelteKit 3 の前処理、コンパイラー、アダプターは Vite プラグインで設定します。通常の Svelte/Vite プロジェクトのみ svelte.config.js を保持します。
49
32
 
50
- #### 2. vite.config.ts の設定
33
+ `vitePreprocess()` などのスタイル・テンプレート言語変換を先に、`autoImportHaiUi()` を後に実行してください。自動 import は Svelte 全体の AST を読み取るため、変換前の SCSS・Pug などの非標準構文は受け付けません。直接の markup API は同期のままです。
51
34
 
52
35
  ```ts
36
+ import { autoImportHaiUi } from '@h-ai/ui/auto-import'
53
37
  import { haiOptimizeExclude, haiPrebundledDeps } from '@h-ai/ui/vite'
38
+ import adapter from '@sveltejs/adapter-node'
54
39
  import { sveltekit } from '@sveltejs/kit/vite'
40
+ import { vitePreprocess } from '@sveltejs/vite-plugin-svelte'
55
41
  import tailwindcss from '@tailwindcss/vite'
56
42
  import { defineConfig } from 'vite'
57
43
 
58
44
  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
- },
45
+ plugins: [
46
+ sveltekit({
47
+ preprocess: [vitePreprocess(), autoImportHaiUi()],
48
+ compilerOptions: { runes: true },
49
+ adapter: adapter(),
50
+ paths: { relative: false },
51
+ }),
52
+ tailwindcss(),
53
+ ],
54
+ optimizeDeps: { exclude: [...haiOptimizeExclude], include: [...haiPrebundledDeps] },
68
55
  ssr: { noExternal: ['@h-ai/ui', '@h-ai/kit'], external: ['@h-ai/core', 'sm-crypto'] },
69
56
  })
70
57
  ```
71
58
 
72
- Crypto または Kit/IAM を使う場合、アプリの本番依存に `sm-crypto@0.5.7` を含めます。CLI 生成済みのプロジェクトでは設定済みです。手動導入は `pnpm add sm-crypto@0.5.7` を実行してください。adapter-node は直接の本番依存も参照するため、external 指定だけでは不十分です。
59
+ ### 3. src/app.css の設定
73
60
 
74
- #### 3. src/app.css の設定
61
+ Crypto または Kit/IAM を使うアプリでは `sm-crypto@0.5.8` を本番依存に追加します。CLI は設定済みです。手動導入では `pnpm add sm-crypto@0.5.8` を実行してください。external だけでは不十分で、adapter-node がネイティブ解決を維持するには直接の本番依存が必要です。
75
62
 
76
63
  ```css
77
64
  @import 'tailwindcss';
@@ -92,7 +79,7 @@ Crypto または Kit/IAM を使う場合、アプリの本番依存に `sm-crypt
92
79
 
93
80
  > `@source` で TailwindCSS に `@h-ai/ui` の class を走査させます。ない場合はスタイルが欠落します。monorepo 内のアプリでは依存がルート `node_modules` に置かれる場合があるため、両方のパスを残すことを推奨します。
94
81
 
95
- #### 4. コンポーネントの使用
82
+ ### 4. コンポーネントの使用
96
83
 
97
84
  ```svelte
98
85
  <script>
@@ -116,7 +103,7 @@ Crypto または Kit/IAM を使う場合、アプリの本番依存に `sm-crypt
116
103
 
117
104
  管理画面など一部のコンポーネントを使うページは、公開コンポーネントディレクトリーの入口から直接 import できます。テーマツールは軽量な `@h-ai/ui/theme` から読み込み、テーマの利用だけでルート入口の AI・グラフコンポーネントを読み込まないようにします。ストアの言語ツールは `@h-ai/ui/i18n` から読み込み、コンポーネントやガイド CSS を読み込みません。インストール済みパッケージの exports を確認し、内部 `src/`・`dist/` は import しないでください。
118
105
 
119
- 自動 import はセミコロンなし、複数行、別名の import を認識し、既存のローカル名を重複注入しません。型のみの import は実行時コンポーネントの代わりにはなりません。
106
+ 自動 import はテンプレート AST で実際に使用するコンポーネントだけを対象とし、コメント、textarea、スクリプト文字列内の例では import しません。スクリプトの宣言と each・await・snippet の局所バインドを優先します。セミコロンなし、複数行、別名の実際の import を構文木で認識し、既存の実行時バインドを重複させません。ルート入口 `@h-ai/ui` の型のみのコンポーネントは必要時に値へ昇格します。他モジュールの同名の型を安全に統合できない場合、ファイル名とコンポーネント名を含むビルドエラーになります。型に別名を付けるか、コンポーネントを別のローカル名で明示的に import してください。
120
107
 
121
108
  ```ts
122
109
  import { Card } from '@h-ai/ui/components/compounds/index'
@@ -124,7 +111,99 @@ import { Button } from '@h-ai/ui/components/primitives/index'
124
111
  import { getThemeInfo, THEMES } from '@h-ai/ui/theme'
125
112
  ```
126
113
 
127
- #### data-\* 属性の転送
114
+ ## 機能
115
+
116
+ ### 用途・入力・出力
117
+
118
+ UI に init/close はありません。アプリのコンポーネントまたはブラウザー操作の文脈で使います。変数はアプリ側で用意する要求・Schema・リソース定義・設定を表します。初期化と失敗処理は各機能の例を参照し、HaiResult.success の確認と非同期処理の await を行ってください。
119
+
120
+ | 入口 | 用途 | 入力 | 出力 | 呼出し断片 |
121
+ | --- | --- | --- | --- | --- |
122
+ | `autoImportHaiUi` | 自動 import | `preprocessed Svelte source and filename through markup` | `PreprocessorGroup; synchronous { code }` | `autoImportHaiUi()` |
123
+ | `parseMarkdown` | 安全な Markdown | `Markdown source, MarkdownParseOptions?` | `HTML string; raw HTML escaped or allowlisted` | `parseMarkdown("# Hello", { allowHtmlTags: false })` |
124
+ | `renderMarkdownDocument` | 編集文書モデル | `Markdown source, MarkdownDocumentParseOptions?` | `MarkdownRenderResult with outline/codeBlocks/blocks` | `renderMarkdownDocument("# Report", { allowHtmlTags: false })` |
125
+ | `isLanguageSupported` | 強調言語確認 | `language name` | `boolean` | `isLanguageSupported("typescript")` |
126
+ | `highlightCode` | コード強調 | `code text, supported language` | `escaped/highlighted HTML string` | `highlightCode("const total = 1", "typescript")` |
127
+ | `resolveDocumentMarkdownContent` | コードを囲む | `text, sourceKind?, language?` | `Markdown string with a safe fence length` | `resolveDocumentMarkdownContent("const x = 1", "code", "ts")` |
128
+ | `resolveDocumentDownloadActions` | ダウンロード一覧 | `MarkdownToolbarDownloadAction[]?` | `AiDocumentResolvedDownloadAction[]` | `resolveDocumentDownloadActions([{ id: "markdown", label: "Markdown" }])` |
129
+ | `downloadAiDocument` | 選択形式を取得 | `AiDocumentDownloadRequest` | `Promise<void>; browser failure rejects, SSR does nothing` | `downloadAiDocument({ actionId: "markdown", content: "# Report", filename: "report.md" })` |
130
+ | `createLocaleStore` | 画面言語の状態 | `{ defaultLocale?, supportedLocales?, detectBrowser?, persistKey? }` | `locale store with current/set/isSupported` | `createLocaleStore({ defaultLocale: "zh-CN", detectBrowser: false })` |
131
+ | `getGlobalLocale` | 現在言語の参照 | `none` | `locale string from current context` | `getGlobalLocale()` |
132
+ | `setGlobalLocale` | ブラウザー・起動言語の設定 | `locale` | `void; use request context for SSR` | `setGlobalLocale("en-US")` |
133
+ | `detectBrowserLocale` | ブラウザー言語検出 | `supportedLocales?` | `supported locale or null` | `detectBrowserLocale()` |
134
+ | `isLocaleSupported` | 対応言語検査 | `locale, supportedLocales?` | `boolean` | `isLocaleSupported("ja-JP")` |
135
+ | `resolveLocale` | 言語の正規化 | `locale, supportedLocales?, fallback?` | `supported locale` | `resolveLocale("en")` |
136
+ | `interpolate` | 文言パラメーター | `template string, InterpolationParams` | `string` | `interpolate("Hello {name}", { name: "Ada" })` |
137
+ | `getThemeInfo` | テーマの情報 | `theme ID` | `ThemeInfo or undefined` | `getThemeInfo("light")` |
138
+ | `isDarkTheme` | 暗色テーマ検査 | `theme ID` | `boolean` | `isDarkTheme("dark")` |
139
+ | `normalizeThemeId` | テーマの正規化 | `candidate theme ID, fallback?` | `supported theme ID` | `normalizeThemeId("unknown", "light")` |
140
+ | `normalizeHexColor` | 色の正規化 | `string or null/undefined` | `six-digit lowercase hex string or null` | `normalizeHexColor("#5765F0")` |
141
+ | `resolveThemeTone` | テーマの明暗 | `theme ID` | `light or dark` | `resolveThemeTone("light")` |
142
+ | `createThemeBootstrapScript` | 初期テーマ設定 | `ThemeBootstrapScriptOptions from trusted host config` | `script string for the application HTML shell` | `createThemeBootstrapScript({ storageKey: "theme", defaultThemeId: "light" })` |
143
+ | `getThemeInitScript` | 既定テーマ起動 | `none` | `script string` | `getThemeInitScript()` |
144
+ | `applyTheme` | ページテーマ変更 | `theme ID, persist? (default true)` | `void; updates DOM/browser preference` | `applyTheme("dark")` |
145
+ | `getCurrentTheme` | 現在テーマ | `none` | `theme ID string` | `getCurrentTheme()` |
146
+ | `getSavedTheme` | 保存テーマ | `fallback theme ID?` | `theme ID string` | `getSavedTheme("light")` |
147
+ | `createGuide` | ガイド制御 | `GuideOptions: tours, articles?, nav?, persistence?, persistKey?` | `GuideController; no init/close` | `createGuide({ tours: [], persistence: "memory" })` |
148
+ | `resolveGuideText` | ガイド文言の解決 | `string or translation callback?` | `string` | `resolveGuideText(() => m.help())` |
149
+ | `matchPermission` | 権限表示 | `required permission, userPermissions[]` | `boolean; not server authorization` | `matchPermission("orders:read", ["orders:*"])` |
150
+ | `setPermissionContext` | 権限文脈を提供 | `() => current permissions; component initialization only` | `void` | `setPermissionContext(() => user.permissions)` |
151
+ | `usePermission` | 権限文脈を利用 | `none; component initialization only` | `PermissionContext with hasPerm/hasAnyPerm/hasAllPerms` | `usePermission()` |
152
+ | `createSensitiveActions` | 重要操作確認 | `standard auth actions providing reauthenticate/publicConfig?` | `SensitiveActions: configure/authorize/submit/cancel` | `createSensitiveActions(actions)` |
153
+ | `createSessionRecovery` | 画面内会話復帰 | `none; configure public config and current user afterward` | `SessionRecovery controller` | `createSessionRecovery()` |
154
+ | `defineCrud` | CRUD 定義 | `CrudResource with fields/API callbacks` | `CrudDef for CrudPage` | `defineCrud(resourceDefinition)` |
155
+ | `createCrudController` | 一覧状態を管理 | `CrudDef, { autoLoad? }?` | `controller data/nav/loading/loaded/error/load/reload` | `createCrudController(crud, { autoLoad: false })` |
156
+ | `mapPaginated` | ページ項目を変換 | `PaginatedResult<T>, (item,index) => R` | `PaginatedResult<R> retaining total/page/pageSize` | `mapPaginated(page, item => ({ ...item, selected: false }))` |
157
+ | `createBrowserNavAdapter` | ブラウザー移動 | `none` | `NavAdapter` | `createBrowserNavAdapter()` |
158
+ | `registerClipboardHostWriter` | ホストのクリップボード登録 | `async text => boolean or null to unregister` | `void` | `registerClipboardHostWriter(null)` |
159
+ | `writeTextToClipboard` | コピー結果を確認 | `text: string` | `Promise<boolean>; true only when write succeeds` | `writeTextToClipboard("trace-001")` |
160
+ | `cn` | クラス結合 | `...string\|boolean\|null\|undefined values` | `string` | `cn("flex", active && "text-primary")` |
161
+ | `getDataAttributes` | data 属性だけ転送 | `props record` | `ForwardedDataAttributes` | `getDataAttributes({ "data-testid": "save" })` |
162
+ | `generateId` | UI 識別子 | `prefix?; not a security token generator` | `string` | `generateId("field")` |
163
+ | `portal` | ノードをホストへ配置 | `HTMLElement, target HTMLElement or selector?` | `Svelte action result with cleanup` | `portal(node, document.body)` |
164
+ | `detectPlatform` | 実行環境検出 | `none` | `Platform` | `detectPlatform()` |
165
+ | `isMobile` | モバイル判定 | `none` | `boolean` | `isMobile()` |
166
+ | `isNativeApp` | 原生シェル判定 | `none` | `boolean` | `isNativeApp()` |
167
+ | `usePlatform` | 反応的な環境状態 | `none; component initialization` | `{ current, isMobile, isApp }` | `usePlatform()` |
168
+ | `getVariantClass` | テーマクラス変換 | `Variant, prefix?` | `string class name` | `getVariantClass("primary", "btn")` |
169
+ | `getSizeClass` | テーマクラス変換 | `Size, prefix?` | `string class name` | `getSizeClass("sm", "btn")` |
170
+ | `getInputSizeClass` | テーマクラス変換 | `Size` | `string class name` | `getInputSizeClass("sm")` |
171
+ | `getBadgeVariantClass` | テーマクラス変換 | `Variant` | `string class name` | `getBadgeVariantClass("info")` |
172
+ | `getBadgeSizeClass` | テーマクラス変換 | `Size` | `string class name` | `getBadgeSizeClass("sm")` |
173
+ | `getAlertVariantClass` | テーマクラス変換 | `Variant` | `string class name` | `getAlertVariantClass("info")` |
174
+ | `getProgressVariantClass` | テーマクラス変換 | `Variant` | `string class name` | `getProgressVariantClass("primary")` |
175
+ | `useToastFeedback` | 操作結果通知 | `() => safely localized message, variant?` | `void; source-owned toast lifecycle` | `useToastFeedback(() => errorMessage(error))` |
176
+ | `notifySuccess` | 操作結果通知 | `localized message, duration?` | `toast ID string` | `notifySuccess(m.saved())` |
177
+ | `notifyInfo` | 操作結果通知 | `localized message, duration?` | `toast ID string` | `notifyInfo(m.loading())` |
178
+ | `notifyWarning` | 操作結果通知 | `localized message, duration?` | `toast ID string` | `notifyWarning(m.warning())` |
179
+ | `notifyError` | 操作結果通知 | `unknown error, safe fallback?, duration?` | `toast ID string; internal exception text hidden` | `notifyError(error, m.retry())` |
180
+ | `errorMessage` | 操作結果通知 | `unknown error, safe fallback?` | `safe localized string` | `errorMessage(error, m.retry())` |
181
+ | `toast.add` | 共用通知キュー | `localized options/message` | `string item ID` | `toast.add({ message: m.saved(), variant: "success" })` |
182
+ | `toast.success` | 共用通知キュー | `localized safe message, duration?` | `string item ID` | `toast.success(m.result())` |
183
+ | `toast.info` | 共用通知キュー | `localized safe message, duration?` | `string item ID` | `toast.info(m.result())` |
184
+ | `toast.warning` | 共用通知キュー | `localized safe message, duration?` | `string item ID` | `toast.warning(m.result())` |
185
+ | `toast.error` | 共用通知キュー | `localized safe message, duration?` | `string item ID` | `toast.error(m.result())` |
186
+ | `toast.remove` | 共用通知キュー | `item ID` | `void` | `toast.remove(id)` |
187
+ | `toast.clear` | 共用通知キュー | `none` | `void` | `toast.clear()` |
188
+ | `message.add` | 共用通知キュー | `localized options/message` | `string item ID` | `message.add({ message: m.saved(), type: "success" })` |
189
+ | `message.success` | 共用通知キュー | `localized safe message, duration?` | `string item ID` | `message.success(m.result())` |
190
+ | `message.info` | 共用通知キュー | `localized safe message, duration?` | `string item ID` | `message.info(m.result())` |
191
+ | `message.warning` | 共用通知キュー | `localized safe message, duration?` | `string item ID` | `message.warning(m.result())` |
192
+ | `message.error` | 共用通知キュー | `localized safe message, duration?` | `string item ID` | `message.error(m.result())` |
193
+ | `message.remove` | 共用通知キュー | `item ID` | `void` | `message.remove(id)` |
194
+ | `message.clear` | 共用通知キュー | `none` | `void` | `message.clear()` |
195
+ | `toast.pause` | 通知タイマー | `toast ID` | `void` | `toast.pause(id)` |
196
+ | `toast.resume` | 通知タイマー | `toast ID` | `void` | `toast.resume(id)` |
197
+ | `messageBox.confirm` | 非同期確認 | `localized string or MessageBoxOptions` | `Promise<boolean>; host handles confirmation/cancellation` | `messageBox.confirm({ message: m.confirm() })` |
198
+ | `messageBox.alert` | 非同期確認 | `localized string or MessageBoxOptions` | `Promise<boolean>; host handles confirmation/cancellation` | `messageBox.alert({ message: m.confirm() })` |
199
+
200
+ - フォーム、テーブル、ダイアログ、ナビゲーション、チャートなどの部品。
201
+ - 認証、CRUD、AI コンテンツ、操作ガイド、ヘルプセンター。
202
+ - Svelte 5、テーマ、レスポンシブ表示、中国語・英語・日本語のコンポーネント文言。
203
+
204
+ Markdown の下線と強調マーカーはエスケープに対応し、閉じていないマーカーはテキストとして扱います。長い異常入力でも Toast と文書出力で反復走査を避け、追跡 ID は既定で折りたたみます。
205
+
206
+ ### data-\* 属性の転送
128
207
 
129
208
  公開 Svelte コンポーネントは `data-*` をルート・主操作要素へ転送し、テスト・計測・自動化に使えます。通常の未知属性は転送しません。
130
209
 
@@ -136,6 +215,32 @@ import { getThemeInfo, THEMES } from '@h-ai/ui/theme'
136
215
 
137
216
  `data-testid` のためだけにボタン・入力・ポップアップをラップする必要はありません。
138
217
 
218
+ ### コンポーネント群の入力・イベント・出力
219
+
220
+ 一覧の操作分類を下表にまとめます。m・rows・user・controller・コールバックは業務アプリが用意します。表示部品は DOM、操作部品はバインドとイベントを出力し、サーバー認可は行いません。完全な組合せは使用例・部品一覧・UI skill を参照し、追加項目は公開 Props 型に従ってください。
221
+
222
+ | コンポーネント群 | 入力 | 出力/イベント | 使用断片 |
223
+ | --- | --- | --- | --- |
224
+ | Button / IconButton / BareButton | variant, size, loading, disabled; icon/snippet; onclick | click event; loading/disabled block repeated action | `<Button loading={saving} onclick={save}>{m.save()}</Button>` |
225
+ | Input / BareInput / Textarea / PasswordInput | type, value, label/validation props | bind:value; input/change/focus events; file input exposes FileList | `<Input bind:value={draft} required />` |
226
+ | Select / Radio / Range / Rating / Combobox | options or min/max/step, current value | bound selected value and selection callbacks | `<Select options={options} bind:value={selected} />` |
227
+ | Checkbox / Switch / ToggleCheckbox / ToggleInput / ToggleRadio | checked/name/label, disabled | bind:checked and change events | `<Checkbox bind:checked={enabled} label={m.enabled()} />` |
228
+ | Form / FormLayout / FormField / TagInput | columns, labels, error/hint, tags, submit callback | validated submit event, tag changes, accessible field association | `<Form onsubmit={save}><FormField label={m.name()}><Input bind:value={name} /></FormField></Form>` |
229
+ | Modal / Drawer / Popover / Dropdown / Tooltip / Calendar | open, trigger/content snippets, dimensions, selected value | bound open/selection; focus handling and close actions | `<Modal bind:open={open} title={m.details()}>{m.content()}</Modal>` |
230
+ | DataTable / TableToolbar / Pagination / FilterBar | rows, columns, total/page, draft search/filter, loading | row/sort/page/query callbacks; host performs the request | `<DataTable {columns} data={rows} sortKey={sortKey} sortDir={sortDir} onsort={sortRows} />` |
231
+ | Tabs / Breadcrumb / Steps / BottomNav / AppBar | items/current key, links, titles and action snippets | selected key/navigation callbacks; host owns routing | `<Tabs {items} bind:active={activeTab} />` |
232
+ | Alert / Badge / Avatar / Tag / Spinner / Progress / Skeleton / Empty / Result | status/variant/value/text/image and state props | presentational DOM; tag/alert close callbacks when enabled | `<Progress value={completed} max={total} />` |
233
+ | WorkspaceLayout / PageHeader / SettingsLayout / SettingsModal | title, sections, active key, leading/actions/footer/children | layout DOM; selection/open callbacks; no business writes | `<WorkspaceLayout title={m.title()}>{m.content()}</WorkspaceLayout>` |
234
+ | FileUpload / ImageUpload / AvatarUpload / FileList | accept/size limits, File values, uploadHandler, files | selected files/progress/result URL and delete/download callbacks | `<ImageUpload bind:value={imageUrl} uploadHandler={uploadImage} />` |
235
+ | AuthPanel / AuthShell / LoginForm / RegisterForm / password forms / PermGuard | public IAM config, standard actions, errors, permission context | authenticated/submit/reset callbacks; server still authorizes | `<AuthPanel {config} {actions} />` |
236
+ | UserProfile / SensitiveOperationsForm / ReauthenticationDialog / SessionRecoveryDialog | profile or operations, async submit, current controller/state | UserProfile closes only on true; other confirmations report explicit completion | `<UserProfile {user} editable onsubmit={saveProfile} />` |
237
+ | CrudPage / CrudFilterBar / CrudEditPanel / CrudDetailPanel / CrudDeleteConfirm | CrudDef, data/nav, loading/error/permissions, API callbacks | resource-bound query/edit/delete callbacks; server enforces resource access | `<CrudPage {crud} data={controller.data} nav={controller.nav} />` |
238
+ | MarkdownRenderer / AiDocumentEditor / AiTableEditor / AiDocumentDownloadMenu | content or columns/rows, action callbacks, safe HTML options | Markdown HTML, content/cell changes and explicit download/run requests | `<MarkdownRenderer content={markdown} allowHtmlTags={false} />` |
239
+ | EncryptedInput / HashDisplay / SignatureDisplay | plaintext/hash/signature, algorithm label, real onencrypt callback | display DOM; bound encryptedValue only after current request succeeds | `<EncryptedInput bind:value={plain} bind:encryptedValue={cipher} onencrypt={encrypt} />` |
240
+ | FeedbackModal / FeedbackForm / FeedbackList / FeedbackDetail / FeedbackScreenshot | prepared evidence, attachments, rows/report, permissions and actions | submission/query/status/export/retry/annotation callbacks | `<FeedbackForm attachments={attachments} onsubmit={submitFeedback} />` |
241
+ | Chart / DashboardGrid / MetricCard / ReportCard | chart data/preset and raw chart props; metrics and loading state | rendered chart/dashboard; native chart callbacks pass through | `<MetricCard title={m.revenue()} value={revenue} trend={growth} />` |
242
+ | GuideHost / HelpCenter | GuideController, locale/scope, articles/tours | onboarding/help UI; start/close callbacks and nonsensitive preferences | `<GuideHost {guide} scope={user.id} locale={locale} />` |
243
+
139
244
  ### コンポーネント構成
140
245
 
141
246
  3 層で構成します(primitives → compounds → scenes):
@@ -155,7 +260,7 @@ components/
155
260
 
156
261
  ### コンポーネント一覧
157
262
 
158
- #### Primitives:基本コンポーネント(20)
263
+ #### Primitives:基本コンポーネント
159
264
 
160
265
  | コンポーネント | 説明 | 主なプロパティ |
161
266
  | ---------------- | ---------------------- | ------------------------------------------------------------------------------ |
@@ -180,9 +285,11 @@ components/
180
285
  | `Spinner` | 読み込み表示 | `size`, `variant` |
181
286
  | `Progress` | プログレスバー | `value`, `max`, `variant`, `striped`, `animated` |
182
287
 
288
+ `Checkbox`・`Switch`・`Radio` は既定でテーマの primary 色を使用し、選択状態は現在の DaisyUI テーマに追従します。`Checkbox` は `checkbox-*` クラスで色を上書きできます。
289
+
183
290
  `BareInput` の `type="file"` では `onchange` の `event.currentTarget.files` を読み取り、ファイルパスの `value` はバインドしません。他の入力型では `bind:value` を使用できます。
184
291
 
185
- #### Compounds:複合コンポーネント(37)
292
+ #### Compounds:複合コンポーネント
186
293
 
187
294
  ##### フォーム
188
295
 
@@ -209,6 +316,8 @@ components/
209
316
 
210
317
  `UserProfile.fieldConstraints` は項目別に `required`、`minlength`、`maxlength`、`pattern`、`validationMessage` を受け取り、ユーザー名などの業務ルールをフォーカス離脱時に検証します。`pattern` は単一行の入力に適用し、`validationMessage` は翻訳関数にも対応します。
211
318
 
319
+ `UserProfile.onsubmit` は保存成功時に `true`、編集と下書きを保持する場合は `false` を必ず返します。例外時も編集を閉じず、共通の Toast で通知します。キャンセルすると `user` の保存済み値に戻ります。
320
+
212
321
  `CrudEditPanel.onsubmit` はフォームに宣言された書き込み可能な項目だけを受け取ります。`readonly` の項目は編集時に除外し、新規作成時には入力できます。主キー、関連データの表示値、監査日時を行全体から自動送信しません。空値、`false`、`0` は保持します。サーバーでは引き続き厳密なスキーマ検証を行ってください。
213
322
 
214
323
  `LoginForm`、`RegisterForm`、`ChangePasswordForm`、`ForgotPasswordForm`、`ResetPasswordForm`、`AuthPanel`、`UserProfile`、`FeedbackModal` は同じレイアウト設定に対応します。`CrudPage.form` または `CrudEditPanel` に渡します。CRUD 項目は `colSpan` と翻訳関数の `validation.message` に対応し、ボタンと Enter のどちらも送信前に検証します。入力修正でエラーが消えます。サーバー側の検証も必要です。
@@ -242,6 +351,10 @@ components/
242
351
  | `Confirm` | 確認ダイアログ | `open`, `title`, `message`, `variant`, `onconfirm` |
243
352
  | `Popover` | ポップオーバー | `open`, `position`, `trigger`, `offset`, `portal` |
244
353
 
354
+ `Popover` は既定で `body` に描画されます。`click` モードでは Enter または Space で開くとパネルにフォーカスが移り、Escape で閉じるとトリガーに戻ります。インラインで描画する場合は `portal={false}` を指定します。
355
+
356
+ Modal または Drawer 内では、portal の操作要素も所属ダイアログの Tab/Shift+Tab 順序に含まれます。閉じると登録を解除してトリガーにフォーカスを戻します。
357
+
245
358
  ##### データ表示
246
359
 
247
360
  | コンポーネント | 説明 | 主なプロパティ |
@@ -283,7 +396,9 @@ components/
283
396
  | `Breadcrumb` | パンくず | `items`, `separator` |
284
397
  | `Steps` | ステップ | `items`, `current`, `direction`, `clickable` |
285
398
  | `Dropdown` | ドロップダウンメニュー | `items`, `trigger`, `triggerClass`, `position` |
286
- | `Tooltip` | ツールチップ | `content`, `position`, `delay` |
399
+ | `Tooltip` | ツールチップ | `content`, `position`, `delay`, `portal`(クリップされるコンテナ内で使用) |
400
+
401
+ `Dropdown` の `click` と `hover` モードではメニューが `body` に描画されます。`manual` モードでは `class` の `dropdown-open` を切り替えてインラインメニューの開閉を制御します。
287
402
 
288
403
  ##### 状態表示
289
404
 
@@ -299,16 +414,40 @@ components/
299
414
  | -------------- | -------------- | ---------------------------------------------- |
300
415
  | `PageHeader` | ページヘッダー | `title`, `description`、`actions` スロット対応 |
301
416
 
302
- #### Scenes:用途別コンポーネント(41)
417
+ #### Scenes:用途別コンポーネント
418
+
419
+ ##### コードワークスペース
420
+
421
+ `CodeWorkspace` は読み取り専用のソース閲覧コンポーネントです。ディレクトリ一覧とファイル内容を返すコールバックだけで利用できます。ルートの一覧を取得する際は、ディレクトリのコールバックに `null` が渡ります。タブはファイル ID とバージョンで識別されます。タブを切り替えると、最近表示したファイルのカーソル位置とスクロール位置が復元されます。
422
+
423
+ ```svelte
424
+ <script lang="ts">
425
+ import type { CodeWorkspaceSource } from '@h-ai/ui/components/scenes/code/index'
426
+ import { CodeWorkspace } from '@h-ai/ui/components/scenes/code/index'
427
+
428
+ const source: CodeWorkspaceSource = {
429
+ listChildren: () => [{ kind: 'file', id: 'readme', name: 'README.md' }],
430
+ readFile: () => ({ text: '# Hello', language: 'markdown' }),
431
+ }
432
+ </script>
433
+
434
+ <CodeWorkspace {source} />
435
+ ```
436
+
437
+ `source.search` を指定するとファイル名とワークスペース全体の内容を検索できます。続きがある場合は `nextCursor` を返します。ファイルやフォルダーの `markers` でリスクや Git の状態を表示し、`readFile` が返す `annotations` で行や範囲をマークできます。右側のパネルと選択範囲の操作には `inspector` と `selectionActions` の snippet を指定します。[コードワークスペース利用ガイド](../../docs/usage/development/ui.md#代码工作区)を参照してください。
303
438
 
304
- ##### Guide:案内・ヘルプ(2)
439
+ Monaco と同一オリジンの worker は、Vite がブラウザーで必要に応じて読み込みます。エディターは既定で Hai のテーマに従い、プリセットとカスタム配色にも対応します。同じページ内の Monaco エディターはテーマを共有します。モバイル端末とエディターの読み込みに失敗した場合は、プレーンテキストで閲覧できます。
440
+
441
+ `annotationIcon` スニペットで行頭アイコンを描画できます。ホバー時は `hoverText` のテキストを優先し、省略時は `annotationHover` で操作可能なコンポーネントを表示できます。Enter でポップアップに移動し、Escape で閉じます。
442
+
443
+ ##### Guide:案内・ヘルプ
305
444
 
306
445
  | コンポーネント | 説明 | 主なプロパティ |
307
446
  | --- | --- | --- |
308
447
  | `GuideHost` | 初回案内・ガイド・ヘルプダイアログ | `guide`, `locale`, `scope`, `autoStart` |
309
448
  | `HelpCenter` | 独立して使える検索付きヘルプ | `articles`, `tours`, `locale`, `selectedId`, `onstart` |
310
449
 
311
- ##### App:アプリ全体(13)
450
+ ##### App:アプリ全体
312
451
 
313
452
  | コンポーネント | 説明 | 主なプロパティ |
314
453
  | ------------------ | ------------------------------------------- | -------------------------------------------------------- |
@@ -328,7 +467,7 @@ components/
328
467
 
329
468
  説明は任意です。モーダルを開く前に `@h-ai/feedback/client` の `prepare()` で現場を固定します。`onfileschange` で添付を準備し、`onannotate` で注釈を画像のピクセルに反映します。送信失敗時は入力を保持し、ローカルに出力できます。一覧は説明またはサーバーの要約を表示し、`onquerychange` でページを取得します。UI の権限表示とは別にサーバーの認可が必要です。接続方法とオフラインツールは [feedback モジュール](../feedback/README.ja.md) を参照してください。
330
469
 
331
- ##### IAM:認証(13)
470
+ ##### IAM:認証
332
471
 
333
472
  | コンポーネント | 説明 | 主なプロパティ |
334
473
  | -------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------ |
@@ -346,7 +485,7 @@ components/
346
485
  | `SessionRecoveryDialog` | 画面内のセッション復帰 | `recovery`, `actions` |
347
486
  | `SensitiveOperationsForm` | 権限の重要操作編集 | `operations`, `onsubmit`, `ondone` |
348
487
 
349
- ##### Storage:ストレージ(4)
488
+ ##### Storage:ストレージ
350
489
 
351
490
  | コンポーネント | 説明 | 主なプロパティ |
352
491
  | -------------- | -------------------- | ------------------------------------------------------------ |
@@ -357,7 +496,7 @@ components/
357
496
 
358
497
  アップロード部品は presign・ヘッダー・PUT/POST を内蔵しません。アプリは `uploadHandler(file, { signal, onProgress })` からサービスを呼び、`{ url?, response? }` を返します。画像・アバターには表示可能な `url` が必要です。handler がなければ `FileUpload` は選択のみ、画像・アバターはローカルのプレビューのみを作成します。
359
498
 
360
- ##### Crypto:暗号表示(3)
499
+ ##### Crypto:暗号表示
361
500
 
362
501
  入力変更で `encryptedValue` を即座に消去し、現在の入力の成功結果のみを反映します。消去・コールバック置換・破棄で旧リクエストを無効化します。失敗時は組み込みエラーを表示し暗号文は空です。暗号化対象の送信は現在の暗号文が空でない場合に限ってください。
363
502
 
@@ -371,7 +510,7 @@ components/
371
510
 
372
511
  既定は `@h-ai/crypto` と共通で、暗号化入力は `SM4`、ハッシュは `SM3`、署名は `SM2` です。
373
512
 
374
- ##### AI:文書・表計算(4)
513
+ ##### AI:文書・表計算
375
514
 
376
515
  | コンポーネント | 説明 | 主なプロパティ・機能 |
377
516
  | ------------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------- |
@@ -407,6 +546,26 @@ components/
407
546
 
408
547
  ##### Charts:グラフ
409
548
 
549
+ 軽量ダッシュボードには `MetricCard`(値・単位・変化率)、`ReportCard`(見出し・操作・内容・読み込み/空状態)、`DashboardGrid`(コンテナー幅に応じた一列・二列・複数列)を使います。指標カードだけではグラフエンジンを読み込みません。`trend={12.8}` は +12.8% を意味します。`trendTone` は業務上の意味を別に表すため、減少も success にできます。欠損値・非有限数は「—」、ゼロはそのまま表示します。
550
+
551
+ `Chart` の `preset` は `grouped-bar`、`stacked-bar`、`stacked-area`、`donut`、`sparkline` です。明示的な `type` とネイティブ属性が既定値より優先されます。例として `innerRadius={0.8}` でドーナツの内径を変更できます。他の LayerChart 属性と snippet も引き続き転送されます。
552
+
553
+ レンダラーは種類別に動的読み込みします。SSR は高さを確保してプレースホルダーを表示し、ブラウザのマウント後に描画します。読み込み中・空データではレンダラーを取得しません。看板だけを使う場合は公開 charts エントリを推奨します。高度な図形は ReportCard の children にネイティブ LayerChart 部品を置けます。Chart の五種類に制限されません。互換性のある `layerchart` を明示的依存に追加し、`layerchart/svg` や `layerchart/hierarchy` など実際の公開エントリを使います。高度な部品も必要時に動的読み込みできます。admin の ArcChart 例を参照してください。
554
+
555
+ ```svelte
556
+ <script lang="ts">
557
+ import { Chart, DashboardGrid, MetricCard, ReportCard } from '@h-ai/ui/components/scenes/charts/index'
558
+ const data = [{ month: 'Jan', revenue: 42, cost: 24 }, { month: 'Feb', revenue: 58, cost: 31 }]
559
+ </script>
560
+
561
+ <DashboardGrid label="Key metrics" columns={4}>
562
+ <MetricCard title="Revenue" value="128,430" unit="CNY" trend={12.8} trendTone="success" trendLabel="vs previous month" />
563
+ </DashboardGrid>
564
+ <ReportCard title="Revenue and cost">
565
+ <Chart preset="grouped-bar" {data} x="month" y={['revenue', 'cost']} />
566
+ </ReportCard>
567
+ ```
568
+
410
569
  `Chart type='line'` は既定で LayerChart の折れ線を使います。監視画面で分割線・点・最寄りの点への hover・縦基準線が必要な場合は `lineVariant='segmented-point'` を使います:
411
570
 
412
571
  ```svelte
@@ -424,7 +583,7 @@ components/
424
583
  />
425
584
  ```
426
585
 
427
- ##### CRUD:一覧操作(5)
586
+ ##### CRUD:一覧操作
428
587
 
429
588
  | コンポーネント | 説明 | 主なプロパティ・機能 |
430
589
  | ------------------- | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -441,7 +600,7 @@ components/
441
600
  >
442
601
  > 列は先に 7rem まで縮小し長文を切り詰め、総幅が容器を超える場合のみ横スクロールを出します。操作列は右に固定し、横スクロール中も表示します。
443
602
 
444
- ##### エラーページ(1)
603
+ ##### エラーページ
445
604
 
446
605
  | コンポーネント | 説明 | 主なプロパティ・機能 |
447
606
  | -------------- | -------------------------------------------------- | ----------------------------------------------------------------------- |
@@ -701,6 +860,8 @@ toast.add({ message: m.saved(), position: 'bottom-center' })
701
860
  </div>
702
861
  ```
703
862
 
863
+ `BottomNav` と `ThemeSelector` のボタンは、クライアントでのマウントが完了し、イベントを処理できる状態になってから有効になります。
864
+
704
865
  #### アイコン
705
866
 
706
867
  Iconify(Tabler Icons)を使用します:
@@ -718,10 +879,12 @@ npm install -D @iconify/tailwind4 @iconify-json/tabler
718
879
 
719
880
  #### テーマ切り替え
720
881
 
721
- 内蔵ツールで 15 種類の厳選 DaisyUI テーマ、ハイコントラストと直角のビジネステーマを管理します:
882
+ 内蔵ツールで 15 種類の厳選 DaisyUI テーマ、ハイコントラスト、直角ビジネス、目にやさしいテーマを管理します:
722
883
 
723
884
  `high-contrast` は共有 theme.css に含まれます。暗い背景と明るい文字、明確な境界線・フォーカス、補助文字とプレースホルダーの強いコントラストを提供します。ThemeSelector は3言語に対応し、サンプルと既定の生成プロジェクトで選択できます。fullstack の明示的な themes はホスト設定を尊重します。通常文字の配色目標は7:1ですが、各業務コンテンツは別途アクセシビリティ確認が必要です。
724
885
 
886
+ `eye-care` は共有 theme.css に含まれ、暖かい緑の背景、濃い文字、読みやすいプレースホルダーと明確なフォーカスを提供します。サンプルと既定テンプレートで「目にやさしい」を選択でき、再読み込み後も保持します。既存の既定テーマと fullstack の明示的な themes は維持します。
887
+
725
888
  `formal` はボタン・入力欄・カード・ダイアログを直角にし、サンプルと既定テンプレートで選択できます。Button の submitHint は type=submit のネイティブ Enter 操作だけを表示します。LoginForm はデスクトップで準備完了時に既存のフォーカスがなければ識別子へ移動し、autoFocus=false で無効化できます。検索の Enter は IME 確定を除いて即時実行します。テーマは方向キー/Home/End、Enter/Space、Esc とフォーカス復帰に対応し、確認画面は取消を初期選択して Esc の状態を同期します。
726
889
 
727
890
  ```ts
@@ -735,7 +898,7 @@ import {
735
898
  normalizeHexColor, // 归一化 #RGB / #RRGGBB 主题色
736
899
  normalizeThemeId, // 校验主题 ID 并自动回退
737
900
  THEME_GROUPS, // 按亮色/暗色分组
738
- THEMES, // ThemeInfo[] — 17 个主题元数据
901
+ THEMES, // ThemeInfo[] — 18 个主题元数据
739
902
  } from '@h-ai/ui/theme'
740
903
  ```
741
904
 
@@ -756,7 +919,6 @@ import { createThemeBootstrapScript, DEFAULT_THEME_COLOR_CSS_VAR } from '@h-ai/u
756
919
 
757
920
  const themeBootstrapScript = createThemeBootstrapScript({
758
921
  storageKey: 'hai-demo-preferences',
759
- legacyThemeStorageKey: 'hai-demo-theme',
760
922
  defaultThemeColor: '#5765f0',
761
923
  colorCssVar: DEFAULT_THEME_COLOR_CSS_VAR,
762
924
  })
@@ -780,7 +942,7 @@ transformPageChunk: ({ html }) => html.replace('%theme_bootstrap%', themeBootstr
780
942
  ```svelte
781
943
  <script>
782
944
  import { createLocaleStore, setGlobalLocale } from '@h-ai/ui/i18n'
783
- import { setLocale } from '$lib/paraglide/runtime'
945
+ import { setLocale } from '#lib/paraglide/runtime.js'
784
946
 
785
947
  const localeStore = createLocaleStore()
786
948
 
@@ -842,11 +1004,9 @@ agreements:
842
1004
  # privacyPolicyUrl: https://example.com/privacy
843
1005
  ```
844
1006
 
845
-
846
-
847
1007
  AuthPanel に IAM 公開設定と actions を渡すと、複数方式のログイン、登録、復旧、規約を利用できます。config.ui でレイアウトとブランド画像を指定し、パスワードフォームは passwordPolicy を受け取ります。通信と Token 保存は actions の責務です。
848
1008
 
849
- 認証エラーには `@h-ai/ui/components/scenes/iam/index` の `authErrorMessage(error)` を使用します。公開コードを現在の UI 言語に変換し、ユーザー名とパスワードの誤りを区別せず、未知・サーバーエラーの原文を隠し、有効な `traceId` を保持します。AuthPanel、OTP 送信、重要操作の再認証、fullstack のパスワード変更で共用します。初期・期限切れパスワード、現在のパスワードの再使用(`hai:iam:034`)、セッション数上限には操作案内を表示します。認証エラーと操作成功は統一 Toast を使用します。確認パスワードはサーバーと同じく Unicode 正規化や空白除去をせず厳密に比較し、不一致をフィールドに表示します。
1009
+ 認証エラーには `@h-ai/ui/components/scenes/iam/index` の `authErrorMessage(error)` を使用します。公開コードを現在の UI 言語に変換し、ユーザー名とパスワードの誤りを区別せず、未知・サーバーエラーの原文を隠し、有効な `traceId` を保持します。AuthPanel、OTP 送信、重要操作の再認証、fullstack のパスワード変更で共用します。初期・期限切れパスワード、現在のパスワードの再使用(`hai:iam:034`)、セッション数上限には操作案内を表示します。認証エラーと操作成功は統一 Toast を使用します。確認パスワードはサーバーと同じく Unicode 正規化や空白除去をせず厳密に比較し、不一致をフィールドに表示します。Kit または API Client で検証した時刻エラーでは、AuthPanel がサーバーの UTC 時刻と時刻調整の案内を表示します。
850
1010
 
851
1011
  AuthPanel は SSR 中のフォーム操作を無効にし、クライアントのマウントとイベント登録が完了してから入力を有効にします。ハイドレーションによる入力の消失を防ぎ、アプリ側の追加の準備処理は不要です。E2E では入力可能な状態を待ち、クライアントスクリプトの読み込みが遅れる場合も検証します。
852
1012
 
@@ -966,7 +1126,6 @@ import { toast } from '@h-ai/ui'
966
1126
  </AuthPanel>
967
1127
  ```
968
1128
 
969
-
970
1129
  コンポーネントのサブパスは package.exports に明記した barrel(例: `@h-ai/ui/components/primitives/index`)に限定します。内部実装やストレージ補助関数は非公開で、ホストのクリップボード登録は引き続き公開します。
971
1130
 
972
1131
  ### リクエスト言語の分離
@@ -975,11 +1134,11 @@ Node リクエストと SSR は `core.i18n.runWithLocale(locale, () => handleReq
975
1134
 
976
1135
  ブラウザーはアプリ全体の `setGlobalLocale` / `createLocaleStore` を使います。SSR の UI store 初期化と setter は自身の状態のみ変更し、メッセージはリクエストコンテキストを参照します。`runWithLocale` は Node 入口専用です。
977
1136
 
978
- ## 入力制約と HTTP 機能
1137
+ ### 入力制約と HTTP 機能
979
1138
 
980
1139
  キーは 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#存储输入约束与跨端能力)を参照してください。
981
1140
 
982
- ## コンパクトな作業領域と折りたたみ式の絞り込み
1141
+ ### コンパクトな作業領域と折りたたみ式の絞り込み
983
1142
 
984
1143
  `WorkspaceLayout` はコンパクトなナビゲーション、12/16px の余白を持つ本文、任意のフッターを統一します。フッターを省略すると高さを確保しません。title はナビゲーションのページ名、leading/actions/footer は snippet です。data-* は本文の main に渡します。親レイアウトから残りの高さと min-height: 0 を引き継いでください。
985
1144
 
@@ -1007,23 +1166,44 @@ Node リクエストと SSR は `core.i18n.runWithLocale(locale, () => handleReq
1007
1166
  </div>
1008
1167
  ```
1009
1168
 
1010
- ## デザインと操作の検証
1169
+ ### デザインと操作の検証
1011
1170
 
1012
1171
  画面設計は [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) も利用できます。
1013
1172
 
1014
1173
  Tabs は方向キー・Home/End、無効項目のスキップと単一の Tab 入口に対応します。表は並べ替え・読み込み状態と行のキーボード操作を提供します。ページ切り替えのラベルは言語に従い、外部ページ変更を入力欄に同期します。展開した条件は文書のフォーカス順序に従い、表示切り替えの選択状態を提供します。Empty/Alert は長文を折り返します。theme.css は共通 tokens を読み込み、global.css は動きを減らす設定に対応します。業務側で検索、並べ替え、ページ切り替えと復旧処理を接続してください。
1015
1174
 
1016
- ## エラー表示とログの関連付け
1175
+ ### 任意の対話チャレンジ
1017
1176
 
1018
- HTTP エラーには安全な翻訳文と追跡番号を含めます。ToastContainer の本文には番号を表示せず、調査情報のアイコンから表示・コピーできます。同じ ID を error.traceId と X-Trace-Id に返します。requestId を traceId として共有し、ブラウザーとサーバーのログを関連付けます。脱機密化した例外・スタック・操作情報はログに残し、内部 cause/ext は公開しません。項目検証は翻訳済みの項目名とメッセージだけを返します。
1177
+ AuthPanel は config.captcha.enabled の場合 actions.createCaptcha で自己ホスト ALTCHA を自動生成・非同期求解し、login/register/sendOtp/passwordReset/renewPassword 用の単用証明を送信します。無効時は求解器を読み込みません。createAuthActions は対応済みで、独自動作は captcha を保持し、不足時は通過しません。証明は現在のメモリ内だけに保持し、サーバーで必ず検証・消費します。
1019
1178
 
1020
- HTTP/UI 境界には core.error.toPublic(error, traceId?)、再翻訳後の表示には core.error.formatMessage(error) を使い、ID を重複追加しません。ログには完全な Error を渡してください。DB ログにはドライバーコード、脱機密化したメッセージ・スタック、表・列を残し、SQL 本文、バインド値と接続認証情報を記録しません。
1179
+ 方針・既定値・復旧範囲は次を参照: [IAM](../iam/README.ja.md)。
1021
1180
 
1022
- ## 任意の対話チャレンジ
1181
+ ## 設定
1023
1182
 
1024
- AuthPanel は config.captcha.enabled の場合 actions.createCaptcha で自己ホスト ALTCHA を自動生成・非同期求解し、login/register/sendOtp/passwordReset/renewPassword 用の単用証明を送信します。無効時は求解器を読み込みません。createAuthActions は対応済みで、独自動作は captcha を保持し、不足時は通過しません。証明は現在のメモリ内だけに保持し、サーバーで必ず検証・消費します。
1183
+ ### 用途に応じた設定入口
1025
1184
 
1026
- 方針・既定値・復旧範囲は次を参照: [IAM](../iam/README.ja.md)。
1185
+ | 設定入口 | 用途 | 入力 | 効果 | 例 |
1186
+ | --- | --- | --- | --- | --- |
1187
+ | `Component Props` | 表示と操作 | typed props, bound values, callbacks, children snippets | DOM, bindings and callback events | `<Input bind:value={draft} />` |
1188
+ | `Theme` | テーマと色 | supported theme ID, color values, preference key | DOM theme/CSS variables; nonsensitive browser preference | `applyTheme("light")` |
1189
+ | `Locale` | 画面言語 | supportedLocales, defaultLocale, persistKey, detectBrowser | component-tree locale; isolated SSR state | `createLocaleStore({ defaultLocale: "ja-JP", detectBrowser: false })` |
1190
+ | `Guide` | ヘルプと初回ガイド | tours, articles, nonsecret scope/version, nav adapter | guide/help state and nonsensitive progress | `createGuide({ tours: [], persistence: "memory" })` |
1191
+ | `CRUD` | 資源項目と API | CrudResource fields/API callbacks and controller options | resource view model; API must implement authorization | `createCrudController(crud, { autoLoad: false })` |
1192
+ | `Authentication` | 公開認証方針 | IAM-whitelisted config and standard actions | AuthPanel submits to host actions; no secret persistence | `<AuthPanel {config} {actions} />` |
1193
+
1194
+ pnpm で Svelte アプリを構築する工程では、`patchedDependencies` に `deepmerge@4.3.1` の補丁を登録し、実際の patch ファイルも保持してください。DaisyUI を使う場合はスタイル補丁も必要です。CLI の生成工程には該当項目が含まれます。npm パッケージを導入しても、このリポジトリーの pnpm 補丁設定は自動伝播しません。手動接入では該当する[補丁ファイル](../../patches/)と登録を同期して依存を再インストールしてください。
1195
+
1196
+ 本パッケージは Svelte コンポーネントとツールを提供し、init/close はありません。入力は Props・コールバック・テーマ設定、出力は画面・バインド値・イベントです。クイックスタートに従って Tailwind/DaisyUI と前処理を設定してください。共通の _ui.yml はなく、Props をモジュール環境変数として設定しません。
1197
+
1198
+ ## エラー処理
1199
+
1200
+ loading/error と業務完了状態はホストが提供します。業務の HaiResult.success を適合層で確認し、安全な翻訳済み文言を渡します。UI ツールは上表の直接値を返し、一律の HaiResult 包装ではありません。notifyError/errorMessage は未知の内部例外を隠します。downloadAiDocument などの拒否を操作境界で処理して loading を解除してください。UserProfile.onsubmit は true の時だけ編集を終了します。
1201
+
1202
+ ### エラー表示とログの関連付け
1203
+
1204
+ HTTP エラーには安全な翻訳文と追跡番号を含めます。ToastContainer の本文には番号を表示せず、調査情報のアイコンから表示・コピーできます。同じ ID を error.traceId と X-Trace-Id に返します。requestId を traceId として共有し、ブラウザーとサーバーのログを関連付けます。脱機密化した例外・スタック・操作情報はログに残し、内部 cause/ext は公開しません。項目検証は翻訳済みの項目名とメッセージだけを返します。
1205
+
1206
+ HTTP/UI 境界には core.error.toPublic(error, traceId?)、再翻訳後の表示には core.error.formatMessage(error) を使い、ID を重複追加しません。ログには完全な Error を渡してください。DB ログにはドライバーコード、脱機密化したメッセージ・スタック、表・列を残し、SQL 本文、バインド値と接続認証情報を記録しません。
1027
1207
 
1028
1208
  ## 開発とテスト
1029
1209