@h-ai/ui 1.0.0-beta.2 → 1.0.0-beta.20
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.
- package/README.en.md +228 -70
- package/README.ja.md +227 -69
- package/README.md +229 -72
- package/auto-import.d.ts +4 -0
- package/auto-import.js +241 -65
- package/dist/components/compounds/Accordion.svelte +6 -2
- package/dist/components/compounds/BottomNav.svelte +14 -2
- package/dist/components/compounds/Card.svelte +3 -1
- package/dist/components/compounds/Combobox.svelte +41 -5
- package/dist/components/compounds/DataTable.svelte +28 -8
- package/dist/components/compounds/DatePicker.svelte +6 -1
- package/dist/components/compounds/Drawer.svelte +12 -4
- package/dist/components/compounds/Dropdown.svelte +135 -59
- package/dist/components/compounds/Empty.svelte +10 -2
- package/dist/components/compounds/FormField.svelte +10 -2
- package/dist/components/compounds/JsonViewer.svelte +18 -6
- package/dist/components/compounds/Modal.svelte +8 -2
- package/dist/components/compounds/Pagination.svelte +22 -7
- package/dist/components/compounds/Popover.svelte +93 -12
- package/dist/components/compounds/Steps.svelte +24 -8
- package/dist/components/compounds/SwipeCell.svelte +3 -1
- package/dist/components/compounds/TableToolbar.svelte +32 -9
- package/dist/components/compounds/Tabs.svelte +25 -5
- package/dist/components/compounds/TagInput.svelte +2 -0
- package/dist/components/compounds/Timeline.svelte +6 -2
- package/dist/components/compounds/ToastContainer.svelte +41 -10
- package/dist/components/compounds/Tooltip.svelte +1 -1
- package/dist/components/compounds/Tooltip.svelte.d.ts +1 -1
- package/dist/components/control-size.js +48 -8
- package/dist/components/primitives/Avatar.svelte +9 -3
- package/dist/components/primitives/BareInput.svelte +3 -1
- package/dist/components/primitives/Button.svelte +6 -2
- package/dist/components/primitives/Checkbox.svelte +5 -0
- package/dist/components/primitives/IconButton.svelte +3 -1
- package/dist/components/primitives/Input.svelte +19 -3
- package/dist/components/primitives/Radio.svelte +4 -1
- package/dist/components/primitives/Range.svelte +3 -1
- package/dist/components/primitives/Rating.svelte +9 -3
- package/dist/components/primitives/Select.svelte +21 -5
- package/dist/components/primitives/Tag.svelte +6 -10
- package/dist/components/primitives/Textarea.svelte +14 -2
- package/dist/components/scenes/ai/AiDocumentEditor.svelte +40 -12
- package/dist/components/scenes/ai/document-download.js +6 -2
- package/dist/components/scenes/ai/document-parse.js +24 -8
- package/dist/components/scenes/ai/editor-markdown-extensions.js +9 -3
- package/dist/components/scenes/ai/highlight.js +18 -1
- package/dist/components/scenes/ai/markdown-parse.js +81 -28
- package/dist/components/scenes/ai/mermaid-render.js +13 -1
- package/dist/components/scenes/ai/safe-html.js +9 -3
- package/dist/components/scenes/ai/table/AiTableEditor.svelte +27 -9
- package/dist/components/scenes/app/FeedbackDetail.svelte +102 -24
- package/dist/components/scenes/app/FeedbackForm.svelte +70 -16
- package/dist/components/scenes/app/FeedbackList.svelte +138 -21
- package/dist/components/scenes/app/FeedbackRecorder.svelte +18 -5
- package/dist/components/scenes/app/FeedbackReplay.svelte +15 -3
- package/dist/components/scenes/app/FeedbackScreenshot.svelte +64 -13
- package/dist/components/scenes/app/LanguageSwitch.svelte +6 -2
- package/dist/components/scenes/app/SettingsLayout.svelte +3 -1
- package/dist/components/scenes/app/ThemeSelector.svelte +29 -5
- package/dist/components/scenes/app/ThemeToggle.svelte +6 -2
- package/dist/components/scenes/app/WorkspaceLayout.svelte +1 -1
- package/dist/components/scenes/app/feedback-functions.js +6 -2
- package/dist/components/scenes/charts/Chart.svelte +55 -21
- package/dist/components/scenes/charts/Chart.svelte.d.ts +0 -1
- package/dist/components/scenes/charts/ChartLoadError.svelte +13 -0
- package/dist/components/scenes/charts/ChartLoadError.svelte.d.ts +6 -0
- package/dist/components/scenes/charts/DashboardGrid.svelte +34 -0
- package/dist/components/scenes/charts/DashboardGrid.svelte.d.ts +15 -0
- package/dist/components/scenes/charts/MetricCard.svelte +69 -0
- package/dist/components/scenes/charts/MetricCard.svelte.d.ts +15 -0
- package/dist/components/scenes/charts/ReportCard.svelte +48 -0
- package/dist/components/scenes/charts/ReportCard.svelte.d.ts +15 -0
- package/dist/components/scenes/charts/chart-presets.d.ts +15 -0
- package/dist/components/scenes/charts/chart-presets.js +56 -0
- package/dist/components/scenes/charts/chart-types.d.ts +13 -2
- package/dist/components/scenes/charts/dashboard-types.d.ts +79 -0
- package/dist/components/scenes/charts/dashboard-types.js +1 -0
- package/dist/components/scenes/charts/index.d.ts +6 -2
- package/dist/components/scenes/charts/index.js +4 -1
- package/dist/components/scenes/charts/renderers/AreaChart.svelte +1 -0
- package/dist/components/scenes/charts/renderers/AreaChart.svelte.d.ts +1 -0
- package/dist/components/scenes/charts/renderers/BarChart.svelte +1 -0
- package/dist/components/scenes/charts/renderers/BarChart.svelte.d.ts +1 -0
- package/dist/components/scenes/charts/renderers/LineChart.svelte +39 -12
- package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +1 -0
- package/dist/components/scenes/charts/renderers/PieChart.svelte +1 -0
- package/dist/components/scenes/charts/renderers/PieChart.svelte.d.ts +1 -0
- package/dist/components/scenes/charts/renderers/ScatterChart.svelte +1 -0
- package/dist/components/scenes/charts/renderers/ScatterChart.svelte.d.ts +1 -0
- package/dist/components/scenes/crud/CrudDetailDrawer.svelte +6 -2
- package/dist/components/scenes/crud/CrudDetailPanel.svelte +6 -2
- package/dist/components/scenes/crud/CrudEditPanel.svelte +41 -12
- package/dist/components/scenes/crud/CrudPage.svelte +34 -9
- package/dist/components/scenes/crud/crud-controller.svelte.js +23 -8
- package/dist/components/scenes/crud/crud-form-validation.js +27 -9
- package/dist/components/scenes/crypto/EncryptedInput.svelte +9 -3
- package/dist/components/scenes/error/error-presets.js +30 -5
- package/dist/components/scenes/guide/GuideHostContent.svelte +7 -1
- package/dist/components/scenes/guide/HelpCenter.svelte +23 -4
- package/dist/components/scenes/iam/AgreementNotice.svelte +9 -3
- package/dist/components/scenes/iam/AuthPanel.svelte +74 -16
- package/dist/components/scenes/iam/ChangePasswordForm.svelte +6 -2
- package/dist/components/scenes/iam/ForgotPasswordForm.svelte +9 -3
- package/dist/components/scenes/iam/LoginForm.svelte +32 -8
- package/dist/components/scenes/iam/PasswordInput.svelte +50 -12
- package/dist/components/scenes/iam/RegisterForm.svelte +11 -3
- package/dist/components/scenes/iam/ResetPasswordForm.svelte +6 -2
- package/dist/components/scenes/iam/SensitiveOperationsForm.svelte +3 -1
- package/dist/components/scenes/iam/SessionRecoveryDialog.svelte +4 -1
- package/dist/components/scenes/iam/UserProfile.svelte +41 -14
- package/dist/components/scenes/iam/auth-captcha.js +9 -2
- package/dist/components/scenes/iam/auth-error-message.d.ts +2 -2
- package/dist/components/scenes/iam/auth-error-message.js +16 -3
- package/dist/components/scenes/iam/password-utils.js +9 -2
- package/dist/components/scenes/iam/sensitive-actions.svelte.js +4 -1
- package/dist/components/scenes/storage/FileList.svelte +3 -1
- package/dist/components/scenes/storage/FileUpload.svelte +7 -2
- package/dist/components/scenes/types.d.ts +2 -2
- package/dist/guide-storage.js +12 -4
- package/dist/guide.svelte.js +59 -16
- package/dist/i18n.svelte.js +9 -3
- package/dist/internal/dialog-focus.d.ts +19 -0
- package/dist/internal/dialog-focus.js +104 -4
- package/dist/internal/form-validation.svelte.js +46 -15
- package/dist/internal/icon-safety.js +6 -2
- package/dist/message.svelte.js +6 -2
- package/dist/messagebox.svelte.js +6 -2
- package/dist/messages/en-US.json +7 -1
- package/dist/messages/ja-JP.json +7 -1
- package/dist/messages/zh-CN.json +7 -1
- package/dist/styles/eye-care.css +55 -0
- package/dist/styles/global.css +16 -0
- package/dist/styles/theme.css +1 -0
- package/dist/theme-config.d.ts +1 -1
- package/dist/theme-config.js +136 -21
- package/dist/toast.svelte.js +14 -3
- package/dist/types.d.ts +3 -3
- package/dist/utils.js +6 -2
- package/package.json +19 -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
|
|
12
|
-
|
|
13
|
-
## 主な機能
|
|
14
|
-
|
|
15
|
-
- フォーム、テーブル、ダイアログ、ナビゲーション、チャートなどの部品。
|
|
16
|
-
- 認証、CRUD、AI コンテンツ、操作ガイド、ヘルプセンター。
|
|
17
|
-
- Svelte 5、テーマ、レスポンシブ表示、中国語・英語・日本語のコンポーネント文言。
|
|
9
|
+
Svelte 5 Runes のクロスプラットフォーム UI ライブラリーです。DaisyUI v5 + Tailwind CSS v4 のスタイル、Bits UI v2 のヘッドレス UI、内蔵 i18n(zh-CN / en-US / ja-JP)、15 種類の厳選テーマ、ハイコントラスト、直角ビジネス、目にやさしいテーマを提供します。
|
|
18
10
|
|
|
19
|
-
|
|
11
|
+
HTTP/UI 境界で業務メッセージを公開するのは、明示された有効な4xx状態のみです。`httpStatus` が未指定または不正な場合は500として安全なメッセージを返します。独自の業務エラーには完全なエラー定義または明示的な状態を指定してください。
|
|
20
12
|
|
|
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
|
-
###
|
|
32
|
-
|
|
33
|
-
#### 1. svelte.config.js の設定
|
|
23
|
+
### 1. package.json のアプリ内インポートを設定
|
|
34
24
|
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
import { vitePreprocess } from '@sveltejs/vite-plugin-svelte'
|
|
25
|
+
```json
|
|
26
|
+
{ "imports": { "#lib/*": "./src/lib/*" } }
|
|
27
|
+
```
|
|
39
28
|
|
|
40
|
-
|
|
41
|
-
const config = {
|
|
42
|
-
preprocess: [autoImportHaiUi(), vitePreprocess()],
|
|
43
|
-
compilerOptions: { runes: true },
|
|
44
|
-
kit: { adapter: adapter() },
|
|
45
|
-
}
|
|
29
|
+
### 2. vite.config.ts を設定
|
|
46
30
|
|
|
47
|
-
|
|
48
|
-
```
|
|
31
|
+
SvelteKit 3 の前処理、コンパイラー、アダプターは Vite プラグインで設定します。通常の Svelte/Vite プロジェクトのみ svelte.config.js を保持します。
|
|
49
32
|
|
|
50
|
-
|
|
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: [
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
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
|
-
|
|
59
|
+
### 3. src/app.css の設定
|
|
73
60
|
|
|
74
|
-
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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,16 @@ components/
|
|
|
299
414
|
| -------------- | -------------- | ---------------------------------------------- |
|
|
300
415
|
| `PageHeader` | ページヘッダー | `title`, `description`、`actions` スロット対応 |
|
|
301
416
|
|
|
302
|
-
#### Scenes
|
|
417
|
+
#### Scenes:用途別コンポーネント
|
|
303
418
|
|
|
304
|
-
##### Guide
|
|
419
|
+
##### Guide:案内・ヘルプ
|
|
305
420
|
|
|
306
421
|
| コンポーネント | 説明 | 主なプロパティ |
|
|
307
422
|
| --- | --- | --- |
|
|
308
423
|
| `GuideHost` | 初回案内・ガイド・ヘルプダイアログ | `guide`, `locale`, `scope`, `autoStart` |
|
|
309
424
|
| `HelpCenter` | 独立して使える検索付きヘルプ | `articles`, `tours`, `locale`, `selectedId`, `onstart` |
|
|
310
425
|
|
|
311
|
-
##### App
|
|
426
|
+
##### App:アプリ全体
|
|
312
427
|
|
|
313
428
|
| コンポーネント | 説明 | 主なプロパティ |
|
|
314
429
|
| ------------------ | ------------------------------------------- | -------------------------------------------------------- |
|
|
@@ -328,7 +443,7 @@ components/
|
|
|
328
443
|
|
|
329
444
|
説明は任意です。モーダルを開く前に `@h-ai/feedback/client` の `prepare()` で現場を固定します。`onfileschange` で添付を準備し、`onannotate` で注釈を画像のピクセルに反映します。送信失敗時は入力を保持し、ローカルに出力できます。一覧は説明またはサーバーの要約を表示し、`onquerychange` でページを取得します。UI の権限表示とは別にサーバーの認可が必要です。接続方法とオフラインツールは [feedback モジュール](../feedback/README.ja.md) を参照してください。
|
|
330
445
|
|
|
331
|
-
##### IAM
|
|
446
|
+
##### IAM:認証
|
|
332
447
|
|
|
333
448
|
| コンポーネント | 説明 | 主なプロパティ |
|
|
334
449
|
| -------------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------ |
|
|
@@ -346,7 +461,7 @@ components/
|
|
|
346
461
|
| `SessionRecoveryDialog` | 画面内のセッション復帰 | `recovery`, `actions` |
|
|
347
462
|
| `SensitiveOperationsForm` | 権限の重要操作編集 | `operations`, `onsubmit`, `ondone` |
|
|
348
463
|
|
|
349
|
-
##### Storage
|
|
464
|
+
##### Storage:ストレージ
|
|
350
465
|
|
|
351
466
|
| コンポーネント | 説明 | 主なプロパティ |
|
|
352
467
|
| -------------- | -------------------- | ------------------------------------------------------------ |
|
|
@@ -357,7 +472,7 @@ components/
|
|
|
357
472
|
|
|
358
473
|
アップロード部品は presign・ヘッダー・PUT/POST を内蔵しません。アプリは `uploadHandler(file, { signal, onProgress })` からサービスを呼び、`{ url?, response? }` を返します。画像・アバターには表示可能な `url` が必要です。handler がなければ `FileUpload` は選択のみ、画像・アバターはローカルのプレビューのみを作成します。
|
|
359
474
|
|
|
360
|
-
##### Crypto
|
|
475
|
+
##### Crypto:暗号表示
|
|
361
476
|
|
|
362
477
|
入力変更で `encryptedValue` を即座に消去し、現在の入力の成功結果のみを反映します。消去・コールバック置換・破棄で旧リクエストを無効化します。失敗時は組み込みエラーを表示し暗号文は空です。暗号化対象の送信は現在の暗号文が空でない場合に限ってください。
|
|
363
478
|
|
|
@@ -371,7 +486,7 @@ components/
|
|
|
371
486
|
|
|
372
487
|
既定は `@h-ai/crypto` と共通で、暗号化入力は `SM4`、ハッシュは `SM3`、署名は `SM2` です。
|
|
373
488
|
|
|
374
|
-
##### AI
|
|
489
|
+
##### AI:文書・表計算
|
|
375
490
|
|
|
376
491
|
| コンポーネント | 説明 | 主なプロパティ・機能 |
|
|
377
492
|
| ------------------------ | ------------------------ | ---------------------------------------------------------------------------------------------------------- |
|
|
@@ -389,6 +504,7 @@ components/
|
|
|
389
504
|
> - `fontSize` は px の `number`、または `1.125rem` などの CSS 長さ。
|
|
390
505
|
> - `allowHtmlTags` は既定で無効です。有効化すると `<b>` / `<i>` / `<u>` / `<mark>` などを安全な許可リストで解析し、危険なタグ・属性は除去します。
|
|
391
506
|
> - 安全な HTML テキストの実体参照は一段だけ解釈し、設定例の引用符、比較記号、`&` を読みやすく表示します。符号化されたタグはテキストのまま保持し、タグとして再解析しません。
|
|
507
|
+
> - `<pre><code class="language-yaml">` などの HTML コードブロックも、安全に再構築した構文色とコピーボタンで表示します。入力の任意スタイルやイベントは保持しません。YAML、TypeScript、Shell、PowerShell、dotenv、Nginx、Dockerfile、Svelte などに対応します。
|
|
392
508
|
> - 生の `<img>` では、1~99999 の正整数ピクセル値の `width` / `height` を保持します。遅延読み込み前に領域を確保し、文書のレイアウトとアンカー位置のずれを減らします。割合、負数、小数、イベント属性、任意の `style` は保持しません。
|
|
393
509
|
|
|
394
510
|
```svelte
|
|
@@ -406,6 +522,26 @@ components/
|
|
|
406
522
|
|
|
407
523
|
##### Charts:グラフ
|
|
408
524
|
|
|
525
|
+
軽量ダッシュボードには `MetricCard`(値・単位・変化率)、`ReportCard`(見出し・操作・内容・読み込み/空状態)、`DashboardGrid`(コンテナー幅に応じた一列・二列・複数列)を使います。指標カードだけではグラフエンジンを読み込みません。`trend={12.8}` は +12.8% を意味します。`trendTone` は業務上の意味を別に表すため、減少も success にできます。欠損値・非有限数は「—」、ゼロはそのまま表示します。
|
|
526
|
+
|
|
527
|
+
`Chart` の `preset` は `grouped-bar`、`stacked-bar`、`stacked-area`、`donut`、`sparkline` です。明示的な `type` とネイティブ属性が既定値より優先されます。例として `innerRadius={0.8}` でドーナツの内径を変更できます。他の LayerChart 属性と snippet も引き続き転送されます。
|
|
528
|
+
|
|
529
|
+
レンダラーは種類別に動的読み込みします。SSR は高さを確保してプレースホルダーを表示し、ブラウザのマウント後に描画します。読み込み中・空データではレンダラーを取得しません。看板だけを使う場合は公開 charts エントリを推奨します。高度な図形は ReportCard の children にネイティブ LayerChart 部品を置けます。Chart の五種類に制限されません。互換性のある `layerchart` を明示的依存に追加し、`layerchart/svg` や `layerchart/hierarchy` など実際の公開エントリを使います。高度な部品も必要時に動的読み込みできます。admin の ArcChart 例を参照してください。
|
|
530
|
+
|
|
531
|
+
```svelte
|
|
532
|
+
<script lang="ts">
|
|
533
|
+
import { Chart, DashboardGrid, MetricCard, ReportCard } from '@h-ai/ui/components/scenes/charts/index'
|
|
534
|
+
const data = [{ month: 'Jan', revenue: 42, cost: 24 }, { month: 'Feb', revenue: 58, cost: 31 }]
|
|
535
|
+
</script>
|
|
536
|
+
|
|
537
|
+
<DashboardGrid label="Key metrics" columns={4}>
|
|
538
|
+
<MetricCard title="Revenue" value="128,430" unit="CNY" trend={12.8} trendTone="success" trendLabel="vs previous month" />
|
|
539
|
+
</DashboardGrid>
|
|
540
|
+
<ReportCard title="Revenue and cost">
|
|
541
|
+
<Chart preset="grouped-bar" {data} x="month" y={['revenue', 'cost']} />
|
|
542
|
+
</ReportCard>
|
|
543
|
+
```
|
|
544
|
+
|
|
409
545
|
`Chart type='line'` は既定で LayerChart の折れ線を使います。監視画面で分割線・点・最寄りの点への hover・縦基準線が必要な場合は `lineVariant='segmented-point'` を使います:
|
|
410
546
|
|
|
411
547
|
```svelte
|
|
@@ -423,7 +559,7 @@ components/
|
|
|
423
559
|
/>
|
|
424
560
|
```
|
|
425
561
|
|
|
426
|
-
##### CRUD
|
|
562
|
+
##### CRUD:一覧操作
|
|
427
563
|
|
|
428
564
|
| コンポーネント | 説明 | 主なプロパティ・機能 |
|
|
429
565
|
| ------------------- | ------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
@@ -440,7 +576,7 @@ components/
|
|
|
440
576
|
>
|
|
441
577
|
> 列は先に 7rem まで縮小し長文を切り詰め、総幅が容器を超える場合のみ横スクロールを出します。操作列は右に固定し、横スクロール中も表示します。
|
|
442
578
|
|
|
443
|
-
#####
|
|
579
|
+
##### エラーページ
|
|
444
580
|
|
|
445
581
|
| コンポーネント | 説明 | 主なプロパティ・機能 |
|
|
446
582
|
| -------------- | -------------------------------------------------- | ----------------------------------------------------------------------- |
|
|
@@ -700,6 +836,8 @@ toast.add({ message: m.saved(), position: 'bottom-center' })
|
|
|
700
836
|
</div>
|
|
701
837
|
```
|
|
702
838
|
|
|
839
|
+
`BottomNav` と `ThemeSelector` のボタンは、クライアントでのマウントが完了し、イベントを処理できる状態になってから有効になります。
|
|
840
|
+
|
|
703
841
|
#### アイコン
|
|
704
842
|
|
|
705
843
|
Iconify(Tabler Icons)を使用します:
|
|
@@ -717,10 +855,12 @@ npm install -D @iconify/tailwind4 @iconify-json/tabler
|
|
|
717
855
|
|
|
718
856
|
#### テーマ切り替え
|
|
719
857
|
|
|
720
|
-
内蔵ツールで 15 種類の厳選 DaisyUI
|
|
858
|
+
内蔵ツールで 15 種類の厳選 DaisyUI テーマ、ハイコントラスト、直角ビジネス、目にやさしいテーマを管理します:
|
|
721
859
|
|
|
722
860
|
`high-contrast` は共有 theme.css に含まれます。暗い背景と明るい文字、明確な境界線・フォーカス、補助文字とプレースホルダーの強いコントラストを提供します。ThemeSelector は3言語に対応し、サンプルと既定の生成プロジェクトで選択できます。fullstack の明示的な themes はホスト設定を尊重します。通常文字の配色目標は7:1ですが、各業務コンテンツは別途アクセシビリティ確認が必要です。
|
|
723
861
|
|
|
862
|
+
`eye-care` は共有 theme.css に含まれ、暖かい緑の背景、濃い文字、読みやすいプレースホルダーと明確なフォーカスを提供します。サンプルと既定テンプレートで「目にやさしい」を選択でき、再読み込み後も保持します。既存の既定テーマと fullstack の明示的な themes は維持します。
|
|
863
|
+
|
|
724
864
|
`formal` はボタン・入力欄・カード・ダイアログを直角にし、サンプルと既定テンプレートで選択できます。Button の submitHint は type=submit のネイティブ Enter 操作だけを表示します。LoginForm はデスクトップで準備完了時に既存のフォーカスがなければ識別子へ移動し、autoFocus=false で無効化できます。検索の Enter は IME 確定を除いて即時実行します。テーマは方向キー/Home/End、Enter/Space、Esc とフォーカス復帰に対応し、確認画面は取消を初期選択して Esc の状態を同期します。
|
|
725
865
|
|
|
726
866
|
```ts
|
|
@@ -734,7 +874,7 @@ import {
|
|
|
734
874
|
normalizeHexColor, // 归一化 #RGB / #RRGGBB 主题色
|
|
735
875
|
normalizeThemeId, // 校验主题 ID 并自动回退
|
|
736
876
|
THEME_GROUPS, // 按亮色/暗色分组
|
|
737
|
-
THEMES, // ThemeInfo[] —
|
|
877
|
+
THEMES, // ThemeInfo[] — 18 个主题元数据
|
|
738
878
|
} from '@h-ai/ui/theme'
|
|
739
879
|
```
|
|
740
880
|
|
|
@@ -779,7 +919,7 @@ transformPageChunk: ({ html }) => html.replace('%theme_bootstrap%', themeBootstr
|
|
|
779
919
|
```svelte
|
|
780
920
|
<script>
|
|
781
921
|
import { createLocaleStore, setGlobalLocale } from '@h-ai/ui/i18n'
|
|
782
|
-
import { setLocale } from '
|
|
922
|
+
import { setLocale } from '#lib/paraglide/runtime.js'
|
|
783
923
|
|
|
784
924
|
const localeStore = createLocaleStore()
|
|
785
925
|
|
|
@@ -841,11 +981,9 @@ agreements:
|
|
|
841
981
|
# privacyPolicyUrl: https://example.com/privacy
|
|
842
982
|
```
|
|
843
983
|
|
|
844
|
-
|
|
845
|
-
|
|
846
984
|
AuthPanel に IAM 公開設定と actions を渡すと、複数方式のログイン、登録、復旧、規約を利用できます。config.ui でレイアウトとブランド画像を指定し、パスワードフォームは passwordPolicy を受け取ります。通信と Token 保存は actions の責務です。
|
|
847
985
|
|
|
848
|
-
認証エラーには `@h-ai/ui/components/scenes/iam/index` の `authErrorMessage(error)` を使用します。公開コードを現在の UI 言語に変換し、ユーザー名とパスワードの誤りを区別せず、未知・サーバーエラーの原文を隠し、有効な `traceId` を保持します。AuthPanel、OTP 送信、重要操作の再認証、fullstack のパスワード変更で共用します。初期・期限切れパスワード、現在のパスワードの再使用(`hai:iam:034`)、セッション数上限には操作案内を表示します。認証エラーと操作成功は統一 Toast を使用します。確認パスワードはサーバーと同じく Unicode 正規化や空白除去をせず厳密に比較し、不一致をフィールドに表示します。
|
|
986
|
+
認証エラーには `@h-ai/ui/components/scenes/iam/index` の `authErrorMessage(error)` を使用します。公開コードを現在の UI 言語に変換し、ユーザー名とパスワードの誤りを区別せず、未知・サーバーエラーの原文を隠し、有効な `traceId` を保持します。AuthPanel、OTP 送信、重要操作の再認証、fullstack のパスワード変更で共用します。初期・期限切れパスワード、現在のパスワードの再使用(`hai:iam:034`)、セッション数上限には操作案内を表示します。認証エラーと操作成功は統一 Toast を使用します。確認パスワードはサーバーと同じく Unicode 正規化や空白除去をせず厳密に比較し、不一致をフィールドに表示します。Kit または API Client で検証した時刻エラーでは、AuthPanel がサーバーの UTC 時刻と時刻調整の案内を表示します。
|
|
849
987
|
|
|
850
988
|
AuthPanel は SSR 中のフォーム操作を無効にし、クライアントのマウントとイベント登録が完了してから入力を有効にします。ハイドレーションによる入力の消失を防ぎ、アプリ側の追加の準備処理は不要です。E2E では入力可能な状態を待ち、クライアントスクリプトの読み込みが遅れる場合も検証します。
|
|
851
989
|
|
|
@@ -965,7 +1103,6 @@ import { toast } from '@h-ai/ui'
|
|
|
965
1103
|
</AuthPanel>
|
|
966
1104
|
```
|
|
967
1105
|
|
|
968
|
-
|
|
969
1106
|
コンポーネントのサブパスは package.exports に明記した barrel(例: `@h-ai/ui/components/primitives/index`)に限定します。内部実装やストレージ補助関数は非公開で、ホストのクリップボード登録は引き続き公開します。
|
|
970
1107
|
|
|
971
1108
|
### リクエスト言語の分離
|
|
@@ -974,11 +1111,11 @@ Node リクエストと SSR は `core.i18n.runWithLocale(locale, () => handleReq
|
|
|
974
1111
|
|
|
975
1112
|
ブラウザーはアプリ全体の `setGlobalLocale` / `createLocaleStore` を使います。SSR の UI store 初期化と setter は自身の状態のみ変更し、メッセージはリクエストコンテキストを参照します。`runWithLocale` は Node 入口専用です。
|
|
976
1113
|
|
|
977
|
-
|
|
1114
|
+
### 入力制約と HTTP 機能
|
|
978
1115
|
|
|
979
1116
|
キーは 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#存储输入约束与跨端能力)を参照してください。
|
|
980
1117
|
|
|
981
|
-
|
|
1118
|
+
### コンパクトな作業領域と折りたたみ式の絞り込み
|
|
982
1119
|
|
|
983
1120
|
`WorkspaceLayout` はコンパクトなナビゲーション、12/16px の余白を持つ本文、任意のフッターを統一します。フッターを省略すると高さを確保しません。title はナビゲーションのページ名、leading/actions/footer は snippet です。data-* は本文の main に渡します。親レイアウトから残りの高さと min-height: 0 を引き継いでください。
|
|
984
1121
|
|
|
@@ -1006,23 +1143,44 @@ Node リクエストと SSR は `core.i18n.runWithLocale(locale, () => handleReq
|
|
|
1006
1143
|
</div>
|
|
1007
1144
|
```
|
|
1008
1145
|
|
|
1009
|
-
|
|
1146
|
+
### デザインと操作の検証
|
|
1010
1147
|
|
|
1011
1148
|
画面設計は [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) も利用できます。
|
|
1012
1149
|
|
|
1013
1150
|
Tabs は方向キー・Home/End、無効項目のスキップと単一の Tab 入口に対応します。表は並べ替え・読み込み状態と行のキーボード操作を提供します。ページ切り替えのラベルは言語に従い、外部ページ変更を入力欄に同期します。展開した条件は文書のフォーカス順序に従い、表示切り替えの選択状態を提供します。Empty/Alert は長文を折り返します。theme.css は共通 tokens を読み込み、global.css は動きを減らす設定に対応します。業務側で検索、並べ替え、ページ切り替えと復旧処理を接続してください。
|
|
1014
1151
|
|
|
1015
|
-
|
|
1152
|
+
### 任意の対話チャレンジ
|
|
1016
1153
|
|
|
1017
|
-
|
|
1154
|
+
AuthPanel は config.captcha.enabled の場合 actions.createCaptcha で自己ホスト ALTCHA を自動生成・非同期求解し、login/register/sendOtp/passwordReset/renewPassword 用の単用証明を送信します。無効時は求解器を読み込みません。createAuthActions は対応済みで、独自動作は captcha を保持し、不足時は通過しません。証明は現在のメモリ内だけに保持し、サーバーで必ず検証・消費します。
|
|
1018
1155
|
|
|
1019
|
-
|
|
1156
|
+
方針・既定値・復旧範囲は次を参照: [IAM](../iam/README.ja.md)。
|
|
1020
1157
|
|
|
1021
|
-
##
|
|
1158
|
+
## 設定
|
|
1022
1159
|
|
|
1023
|
-
|
|
1160
|
+
### 用途に応じた設定入口
|
|
1024
1161
|
|
|
1025
|
-
|
|
1162
|
+
| 設定入口 | 用途 | 入力 | 効果 | 例 |
|
|
1163
|
+
| --- | --- | --- | --- | --- |
|
|
1164
|
+
| `Component Props` | 表示と操作 | typed props, bound values, callbacks, children snippets | DOM, bindings and callback events | `<Input bind:value={draft} />` |
|
|
1165
|
+
| `Theme` | テーマと色 | supported theme ID, color values, preference key | DOM theme/CSS variables; nonsensitive browser preference | `applyTheme("light")` |
|
|
1166
|
+
| `Locale` | 画面言語 | supportedLocales, defaultLocale, persistKey, detectBrowser | component-tree locale; isolated SSR state | `createLocaleStore({ defaultLocale: "ja-JP", detectBrowser: false })` |
|
|
1167
|
+
| `Guide` | ヘルプと初回ガイド | tours, articles, nonsecret scope/version, nav adapter | guide/help state and nonsensitive progress | `createGuide({ tours: [], persistence: "memory" })` |
|
|
1168
|
+
| `CRUD` | 資源項目と API | CrudResource fields/API callbacks and controller options | resource view model; API must implement authorization | `createCrudController(crud, { autoLoad: false })` |
|
|
1169
|
+
| `Authentication` | 公開認証方針 | IAM-whitelisted config and standard actions | AuthPanel submits to host actions; no secret persistence | `<AuthPanel {config} {actions} />` |
|
|
1170
|
+
|
|
1171
|
+
pnpm で Svelte アプリを構築する工程では、`patchedDependencies` に `deepmerge@4.3.1` の補丁を登録し、実際の patch ファイルも保持してください。DaisyUI を使う場合はスタイル補丁も必要です。CLI の生成工程には該当項目が含まれます。npm パッケージを導入しても、このリポジトリーの pnpm 補丁設定は自動伝播しません。手動接入では該当する[補丁ファイル](../../patches/)と登録を同期して依存を再インストールしてください。
|
|
1172
|
+
|
|
1173
|
+
本パッケージは Svelte コンポーネントとツールを提供し、init/close はありません。入力は Props・コールバック・テーマ設定、出力は画面・バインド値・イベントです。クイックスタートに従って Tailwind/DaisyUI と前処理を設定してください。共通の _ui.yml はなく、Props をモジュール環境変数として設定しません。
|
|
1174
|
+
|
|
1175
|
+
## エラー処理
|
|
1176
|
+
|
|
1177
|
+
loading/error と業務完了状態はホストが提供します。業務の HaiResult.success を適合層で確認し、安全な翻訳済み文言を渡します。UI ツールは上表の直接値を返し、一律の HaiResult 包装ではありません。notifyError/errorMessage は未知の内部例外を隠します。downloadAiDocument などの拒否を操作境界で処理して loading を解除してください。UserProfile.onsubmit は true の時だけ編集を終了します。
|
|
1178
|
+
|
|
1179
|
+
### エラー表示とログの関連付け
|
|
1180
|
+
|
|
1181
|
+
HTTP エラーには安全な翻訳文と追跡番号を含めます。ToastContainer の本文には番号を表示せず、調査情報のアイコンから表示・コピーできます。同じ ID を error.traceId と X-Trace-Id に返します。requestId を traceId として共有し、ブラウザーとサーバーのログを関連付けます。脱機密化した例外・スタック・操作情報はログに残し、内部 cause/ext は公開しません。項目検証は翻訳済みの項目名とメッセージだけを返します。
|
|
1182
|
+
|
|
1183
|
+
HTTP/UI 境界には core.error.toPublic(error, traceId?)、再翻訳後の表示には core.error.formatMessage(error) を使い、ID を重複追加しません。ログには完全な Error を渡してください。DB ログにはドライバーコード、脱機密化したメッセージ・スタック、表・列を残し、SQL 本文、バインド値と接続認証情報を記録しません。
|
|
1026
1184
|
|
|
1027
1185
|
## 開発とテスト
|
|
1028
1186
|
|