@h-ai/ui 1.0.0-beta.1 → 1.0.0-beta.11

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 (48) hide show
  1. package/README.en.md +30 -4
  2. package/README.ja.md +30 -4
  3. package/README.md +30 -4
  4. package/auto-import.d.ts +4 -0
  5. package/auto-import.js +5 -0
  6. package/dist/components/compounds/ToastContainer.svelte +14 -3
  7. package/dist/components/scenes/ai/document-download.js +4 -2
  8. package/dist/components/scenes/ai/editor-markdown-extensions.js +3 -2
  9. package/dist/components/scenes/ai/highlight.js +15 -0
  10. package/dist/components/scenes/ai/markdown-parse.js +50 -23
  11. package/dist/components/scenes/app/ThemeSelector.svelte +1 -1
  12. package/dist/components/scenes/charts/Chart.svelte +43 -20
  13. package/dist/components/scenes/charts/Chart.svelte.d.ts +0 -1
  14. package/dist/components/scenes/charts/ChartLoadError.svelte +13 -0
  15. package/dist/components/scenes/charts/ChartLoadError.svelte.d.ts +6 -0
  16. package/dist/components/scenes/charts/DashboardGrid.svelte +34 -0
  17. package/dist/components/scenes/charts/DashboardGrid.svelte.d.ts +15 -0
  18. package/dist/components/scenes/charts/MetricCard.svelte +52 -0
  19. package/dist/components/scenes/charts/MetricCard.svelte.d.ts +15 -0
  20. package/dist/components/scenes/charts/ReportCard.svelte +48 -0
  21. package/dist/components/scenes/charts/ReportCard.svelte.d.ts +15 -0
  22. package/dist/components/scenes/charts/chart-presets.d.ts +15 -0
  23. package/dist/components/scenes/charts/chart-presets.js +19 -0
  24. package/dist/components/scenes/charts/chart-types.d.ts +13 -2
  25. package/dist/components/scenes/charts/dashboard-types.d.ts +79 -0
  26. package/dist/components/scenes/charts/dashboard-types.js +1 -0
  27. package/dist/components/scenes/charts/index.d.ts +6 -2
  28. package/dist/components/scenes/charts/index.js +4 -1
  29. package/dist/components/scenes/charts/renderers/AreaChart.svelte +1 -0
  30. package/dist/components/scenes/charts/renderers/AreaChart.svelte.d.ts +1 -0
  31. package/dist/components/scenes/charts/renderers/BarChart.svelte +1 -0
  32. package/dist/components/scenes/charts/renderers/BarChart.svelte.d.ts +1 -0
  33. package/dist/components/scenes/charts/renderers/LineChart.svelte +1 -0
  34. package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +1 -0
  35. package/dist/components/scenes/charts/renderers/PieChart.svelte +1 -0
  36. package/dist/components/scenes/charts/renderers/PieChart.svelte.d.ts +1 -0
  37. package/dist/components/scenes/charts/renderers/ScatterChart.svelte +1 -0
  38. package/dist/components/scenes/charts/renderers/ScatterChart.svelte.d.ts +1 -0
  39. package/dist/messages/en-US.json +7 -1
  40. package/dist/messages/ja-JP.json +7 -1
  41. package/dist/messages/zh-CN.json +7 -1
  42. package/dist/styles/eye-care.css +55 -0
  43. package/dist/styles/theme.css +1 -0
  44. package/dist/theme-config.d.ts +1 -1
  45. package/dist/theme-config.js +2 -1
  46. package/dist/toast.svelte.js +13 -4
  47. package/dist/types.d.ts +1 -1
  48. package/package.json +2 -2
package/README.en.md CHANGED
@@ -8,7 +8,7 @@
8
8
 
9
9
  Built-in messages support `zh-CN`, `en-US` and `ja-JP`; the language selector offers all three by default.
10
10
 
11
- A cross-platform Svelte 5 Runes component library with DaisyUI v5 + Tailwind CSS v4 styling and Bits UI v2 headless interactions. Includes built-in i18n (zh-CN / en-US / ja-JP) and 15 curated DaisyUI themes plus high contrast and square business themes.
11
+ A cross-platform Svelte 5 Runes component library with DaisyUI v5 + Tailwind CSS v4 styling and Bits UI v2 headless interactions. Includes built-in i18n (zh-CN / en-US / ja-JP) and 15 curated DaisyUI themes plus high contrast, square business and eye-care themes.
12
12
 
13
13
  ## Core features
14
14
 
@@ -16,6 +16,8 @@ A cross-platform Svelte 5 Runes component library with DaisyUI v5 + Tailwind CSS
16
16
  - Authentication, CRUD, AI content, onboarding and a help center.
17
17
  - Svelte 5, themes, responsive layouts and Chinese/English/Japanese component messages.
18
18
 
19
+ Markdown underline and highlight markers support escaping; unclosed markers remain text. Toasts and document downloads handle unusually long text without repeated scanning, while trace identifiers remain hidden by default.
20
+
19
21
  ## Getting started
20
22
 
21
23
  ### Installation
@@ -297,7 +299,7 @@ Text controls validate on blur after input and update errors as input is correct
297
299
  | ------------ | ----------- | ----------------------------------------------- |
298
300
  | `PageHeader` | Page header | `title`, `description`; supports `actions` slot |
299
301
 
300
- #### Scenes (43)
302
+ #### Scenes (47)
301
303
 
302
304
  ##### Guide (2)
303
305
 
@@ -387,6 +389,7 @@ Defaults match `@h-ai/crypto`: `SM4` for encrypted inputs, `SM3` for hashes, and
387
389
  > - `fontSize` accepts a `number` in px or any CSS length such as `1.125rem`.
388
390
  > - `allowHtmlTags` is off by default; when enabled, tags such as `<b>` / `<i>` / `<u>` / `<mark>` use a safe allowlist, with dangerous tags/attributes still sanitized.
389
391
  > - Text entities in safe HTML retain one level of meaning, so quotes, comparison operators and `&` in configuration snippets remain readable. Encoded tags remain text and are never reparsed as markup.
392
+ > - HTML code blocks such as `<pre><code class="language-yaml">` also receive safely rebuilt highlighting and copy buttons. Input styles and events are discarded. Supported languages include YAML, TypeScript, Shell, PowerShell, dotenv, Nginx, Dockerfile and Svelte.
390
393
  > - Raw `<img>` tags retain `width` / `height` as positive integer pixel values from 1 to 99999. These reserve space before lazy images load and keep document layout and anchor positions stable. Percentages, negatives, decimals, events, and arbitrary `style` are removed.
391
394
 
392
395
  ```svelte
@@ -404,6 +407,27 @@ Defaults match `@h-ai/crypto`: `SM4` for encrypted inputs, `SM3` for hashes, and
404
407
 
405
408
  ##### Charts
406
409
 
410
+ Lightweight dashboards use `MetricCard` (value, unit and percentage change), `ReportCard` (heading, actions, content, loading/empty states), and `DashboardGrid` (one, two or more columns based on container width). MetricCard alone does not load a chart engine. `trend={12.8}` means +12.8%; `trendTone` expresses business meaning independently, so a decrease can be success. Missing and non-finite values show “—”; zero remains visible.
411
+
412
+ `Chart` supports `preset`: `grouped-bar`, `stacked-bar`, `stacked-area`, `donut`, and `sparkline`. Presets supply defaults; explicit `type` and native props take precedence, such as `innerRadius={0.8}` overriding the donut radius. Other LayerChart props and snippets continue to pass through.
413
+
414
+ Renderers load dynamically by type. SSR reserves height and shows a loading placeholder; drawing starts after browser mount. Loading and empty charts do not load renderers. Prefer the public charts entry for dashboard-only consumers. For advanced charts, place native LayerChart components in ReportCard children, beyond Chart's five types. Declare a compatible `layerchart` dependency and use its actual public entries such as `layerchart/svg` or `layerchart/hierarchy`. Load advanced components dynamically when needed; see the admin native ArcChart example.
415
+
416
+ ```svelte
417
+ <script lang="ts">
418
+ import { Chart, DashboardGrid, MetricCard, ReportCard } from '@h-ai/ui/components/scenes/charts/index'
419
+ const data = [{ month: 'Jan', revenue: 42, cost: 24 }, { month: 'Feb', revenue: 58, cost: 31 }]
420
+ </script>
421
+
422
+ <DashboardGrid label="Key metrics" columns={4}>
423
+ <MetricCard title="Revenue" value="128,430" unit="CNY" trend={12.8} trendTone="success" trendLabel="vs previous month" />
424
+ </DashboardGrid>
425
+ <ReportCard title="Revenue and cost">
426
+ <Chart preset="grouped-bar" {data} x="month" y={['revenue', 'cost']} />
427
+ </ReportCard>
428
+ ```
429
+
430
+
407
431
  `Chart type='line'` uses LayerChart's native line chart by default. For monitoring dashboards with segmented lines, points, nearest-point hover, and vertical reference lines, use `lineVariant='segmented-point'`:
408
432
 
409
433
  ```svelte
@@ -715,10 +739,12 @@ npm install -D @iconify/tailwind4 @iconify-json/tabler
715
739
 
716
740
  #### Theme switching
717
741
 
718
- Manage 15 curated DaisyUI themes plus high contrast and square business themes through built-in utilities:
742
+ Manage 15 curated DaisyUI themes plus high contrast, square business and eye-care themes through built-in utilities:
719
743
 
720
744
  `high-contrast` ships in shared theme.css with bright text on dark surfaces, clear borders/focus, and stronger muted text/placeholders. ThemeSelector has localized labels; examples and default generated projects offer it. Explicit fullstack themes lists remain host controlled. Palette checks target 7:1 for normal text; arbitrary application content still needs accessibility review.
721
745
 
746
+ `eye-care` ships in shared theme.css with warm green surfaces, dark text, readable placeholders and clear focus outlines. Select “Eye care” in examples and default templates; the preference survives reloads. Existing default themes and explicit fullstack themes lists are preserved.
747
+
722
748
  `formal` provides square corners for business buttons, fields, cards and dialogs, with localized labels in examples and default templates. Button submitHint displays the native Enter action only for type=submit; it adds no global shortcut. LoginForm focuses its identifier on desktop when ready and no element has focus; autoFocus=false opts out. Search Enter submits immediately while respecting IME composition. Theme choices support arrows/Home/End, Enter/Space and Escape focus restoration. Confirmation dialogs initially focus Cancel and synchronize Escape cancellation.
723
749
 
724
750
  ```ts
@@ -732,7 +758,7 @@ import {
732
758
  normalizeHexColor, // 归一化 #RGB / #RRGGBB 主题色
733
759
  normalizeThemeId, // 校验主题 ID 并自动回退
734
760
  THEME_GROUPS, // 按亮色/暗色分组
735
- THEMES, // ThemeInfo[] — 17 个主题元数据
761
+ THEMES, // ThemeInfo[] — 18 个主题元数据
736
762
  } from '@h-ai/ui/theme'
737
763
  ```
738
764
 
package/README.ja.md CHANGED
@@ -8,7 +8,7 @@
8
8
 
9
9
  内蔵メッセージは `zh-CN`、`en-US`、`ja-JP` に対応し、言語セレクターは既定で3言語を表示します。
10
10
 
11
- Svelte 5 Runes のクロスプラットフォーム UI ライブラリーです。DaisyUI v5 + Tailwind CSS v4 のスタイル、Bits UI v2 のヘッドレス UI、内蔵 i18n(zh-CN / en-US / ja-JP)、15 種類の厳選テーマ、ハイコントラストと直角のビジネステーマを提供します。
11
+ Svelte 5 Runes のクロスプラットフォーム UI ライブラリーです。DaisyUI v5 + Tailwind CSS v4 のスタイル、Bits UI v2 のヘッドレス UI、内蔵 i18n(zh-CN / en-US / ja-JP)、15 種類の厳選テーマ、ハイコントラスト、直角ビジネス、目にやさしいテーマを提供します。
12
12
 
13
13
  ## 主な機能
14
14
 
@@ -16,6 +16,8 @@ Svelte 5 Runes のクロスプラットフォーム UI ライブラリーです
16
16
  - 認証、CRUD、AI コンテンツ、操作ガイド、ヘルプセンター。
17
17
  - Svelte 5、テーマ、レスポンシブ表示、中国語・英語・日本語のコンポーネント文言。
18
18
 
19
+ Markdown の下線と強調マーカーはエスケープに対応し、閉じていないマーカーはテキストとして扱います。長い異常入力でも Toast と文書出力で反復走査を避け、追跡 ID は既定で折りたたみます。
20
+
19
21
  ## 使い始める
20
22
 
21
23
  ### インストール
@@ -297,7 +299,7 @@ components/
297
299
  | -------------- | -------------- | ---------------------------------------------- |
298
300
  | `PageHeader` | ページヘッダー | `title`, `description`、`actions` スロット対応 |
299
301
 
300
- #### Scenes:用途別コンポーネント(41)
302
+ #### Scenes:用途別コンポーネント(47)
301
303
 
302
304
  ##### Guide:案内・ヘルプ(2)
303
305
 
@@ -387,6 +389,7 @@ components/
387
389
  > - `fontSize` は px の `number`、または `1.125rem` などの CSS 長さ。
388
390
  > - `allowHtmlTags` は既定で無効です。有効化すると `<b>` / `<i>` / `<u>` / `<mark>` などを安全な許可リストで解析し、危険なタグ・属性は除去します。
389
391
  > - 安全な HTML テキストの実体参照は一段だけ解釈し、設定例の引用符、比較記号、`&` を読みやすく表示します。符号化されたタグはテキストのまま保持し、タグとして再解析しません。
392
+ > - `<pre><code class="language-yaml">` などの HTML コードブロックも、安全に再構築した構文色とコピーボタンで表示します。入力の任意スタイルやイベントは保持しません。YAML、TypeScript、Shell、PowerShell、dotenv、Nginx、Dockerfile、Svelte などに対応します。
390
393
  > - 生の `<img>` では、1~99999 の正整数ピクセル値の `width` / `height` を保持します。遅延読み込み前に領域を確保し、文書のレイアウトとアンカー位置のずれを減らします。割合、負数、小数、イベント属性、任意の `style` は保持しません。
391
394
 
392
395
  ```svelte
@@ -404,6 +407,27 @@ components/
404
407
 
405
408
  ##### Charts:グラフ
406
409
 
410
+ 軽量ダッシュボードには `MetricCard`(値・単位・変化率)、`ReportCard`(見出し・操作・内容・読み込み/空状態)、`DashboardGrid`(コンテナー幅に応じた一列・二列・複数列)を使います。指標カードだけではグラフエンジンを読み込みません。`trend={12.8}` は +12.8% を意味します。`trendTone` は業務上の意味を別に表すため、減少も success にできます。欠損値・非有限数は「—」、ゼロはそのまま表示します。
411
+
412
+ `Chart` の `preset` は `grouped-bar`、`stacked-bar`、`stacked-area`、`donut`、`sparkline` です。明示的な `type` とネイティブ属性が既定値より優先されます。例として `innerRadius={0.8}` でドーナツの内径を変更できます。他の LayerChart 属性と snippet も引き続き転送されます。
413
+
414
+ レンダラーは種類別に動的読み込みします。SSR は高さを確保してプレースホルダーを表示し、ブラウザのマウント後に描画します。読み込み中・空データではレンダラーを取得しません。看板だけを使う場合は公開 charts エントリを推奨します。高度な図形は ReportCard の children にネイティブ LayerChart 部品を置けます。Chart の五種類に制限されません。互換性のある `layerchart` を明示的依存に追加し、`layerchart/svg` や `layerchart/hierarchy` など実際の公開エントリを使います。高度な部品も必要時に動的読み込みできます。admin の ArcChart 例を参照してください。
415
+
416
+ ```svelte
417
+ <script lang="ts">
418
+ import { Chart, DashboardGrid, MetricCard, ReportCard } from '@h-ai/ui/components/scenes/charts/index'
419
+ const data = [{ month: 'Jan', revenue: 42, cost: 24 }, { month: 'Feb', revenue: 58, cost: 31 }]
420
+ </script>
421
+
422
+ <DashboardGrid label="Key metrics" columns={4}>
423
+ <MetricCard title="Revenue" value="128,430" unit="CNY" trend={12.8} trendTone="success" trendLabel="vs previous month" />
424
+ </DashboardGrid>
425
+ <ReportCard title="Revenue and cost">
426
+ <Chart preset="grouped-bar" {data} x="month" y={['revenue', 'cost']} />
427
+ </ReportCard>
428
+ ```
429
+
430
+
407
431
  `Chart type='line'` は既定で LayerChart の折れ線を使います。監視画面で分割線・点・最寄りの点への hover・縦基準線が必要な場合は `lineVariant='segmented-point'` を使います:
408
432
 
409
433
  ```svelte
@@ -715,10 +739,12 @@ npm install -D @iconify/tailwind4 @iconify-json/tabler
715
739
 
716
740
  #### テーマ切り替え
717
741
 
718
- 内蔵ツールで 15 種類の厳選 DaisyUI テーマ、ハイコントラストと直角のビジネステーマを管理します:
742
+ 内蔵ツールで 15 種類の厳選 DaisyUI テーマ、ハイコントラスト、直角ビジネス、目にやさしいテーマを管理します:
719
743
 
720
744
  `high-contrast` は共有 theme.css に含まれます。暗い背景と明るい文字、明確な境界線・フォーカス、補助文字とプレースホルダーの強いコントラストを提供します。ThemeSelector は3言語に対応し、サンプルと既定の生成プロジェクトで選択できます。fullstack の明示的な themes はホスト設定を尊重します。通常文字の配色目標は7:1ですが、各業務コンテンツは別途アクセシビリティ確認が必要です。
721
745
 
746
+ `eye-care` は共有 theme.css に含まれ、暖かい緑の背景、濃い文字、読みやすいプレースホルダーと明確なフォーカスを提供します。サンプルと既定テンプレートで「目にやさしい」を選択でき、再読み込み後も保持します。既存の既定テーマと fullstack の明示的な themes は維持します。
747
+
722
748
  `formal` はボタン・入力欄・カード・ダイアログを直角にし、サンプルと既定テンプレートで選択できます。Button の submitHint は type=submit のネイティブ Enter 操作だけを表示します。LoginForm はデスクトップで準備完了時に既存のフォーカスがなければ識別子へ移動し、autoFocus=false で無効化できます。検索の Enter は IME 確定を除いて即時実行します。テーマは方向キー/Home/End、Enter/Space、Esc とフォーカス復帰に対応し、確認画面は取消を初期選択して Esc の状態を同期します。
723
749
 
724
750
  ```ts
@@ -732,7 +758,7 @@ import {
732
758
  normalizeHexColor, // 归一化 #RGB / #RRGGBB 主题色
733
759
  normalizeThemeId, // 校验主题 ID 并自动回退
734
760
  THEME_GROUPS, // 按亮色/暗色分组
735
- THEMES, // ThemeInfo[] — 17 个主题元数据
761
+ THEMES, // ThemeInfo[] — 18 个主题元数据
736
762
  } from '@h-ai/ui/theme'
737
763
  ```
738
764
 
package/README.md CHANGED
@@ -8,7 +8,7 @@
8
8
 
9
9
  内置中英日文消息(`zh-CN` / `en-US` / `ja-JP`),语言选择器默认提供三种语言。
10
10
 
11
- 基于 Svelte 5 Runes 的多端 UI 组件库,采用 DaisyUI v5 + Tailwind CSS v4 样式 + Bits UI v2 headless 交互,内置 i18n(zh-CN / en-US / ja-JP),内置 15 个精选 DaisyUI 主题、高对比及直角商务主题。
11
+ 基于 Svelte 5 Runes 的多端 UI 组件库,采用 DaisyUI v5 + Tailwind CSS v4 样式 + Bits UI v2 headless 交互,内置 i18n(zh-CN / en-US / ja-JP),内置 15 个精选 DaisyUI 主题、高对比、直角商务及护眼主题。
12
12
 
13
13
  ## 核心功能清单
14
14
 
@@ -16,6 +16,8 @@
16
16
  - 认证、CRUD、AI 内容展示、新手引导和帮助中心。
17
17
  - Svelte 5、主题切换、响应式布局及中英日文组件文案。
18
18
 
19
+ Markdown 下划线与高亮支持转义,未闭合标记按文本处理;Toast 和文档下载在异常长文本输入下保持可用,追踪编号仍默认收起。
20
+
19
21
  ## 使用入门
20
22
 
21
23
  ### 安装
@@ -297,7 +299,7 @@ components/
297
299
  | ------------ | -------- | ------------------------------------------- |
298
300
  | `PageHeader` | 页面头部 | `title`, `description`,支持 `actions` 插槽 |
299
301
 
300
- #### 场景组件 Scenes(43 个)
302
+ #### 场景组件 Scenes(47 个)
301
303
 
302
304
  ##### Guide 引导与帮助(2 个)
303
305
 
@@ -386,6 +388,7 @@ components/
386
388
  > - `fontSize` 支持 `number`(按 px 解释)或任意 CSS 长度字符串(如 `1.125rem`)
387
389
  > - `allowHtmlTags` 默认关闭;开启后会按安全白名单解析 `<b>` / `<i>` / `<u>` / `<mark>` 等 HTML 标签,危险标签与属性仍会被消毒
388
390
  > - 安全 HTML 文本中的引号、比较符和 `&` 实体只保留一层含义,配置代码不会显示为实体编号;编码后的标签保持文字,不会重新作为标签执行。
391
+ > - HTML 中的 `<pre><code class="language-yaml">` 等代码块也会安全重建高亮和复制按钮,不保留输入的任意样式或事件。支持 YAML、TypeScript、Shell、PowerShell、dotenv、Nginx、Dockerfile 和 Svelte 等常用语言。
389
392
  > - 原始 `<img>` 可保留 `width` / `height`(1–99999 的正整数像素值),用于在图片延迟加载前预留空间,减少文档布局和锚点位置跳变;百分比、负数、小数、事件及任意 `style` 不保留。
390
393
 
391
394
  ```svelte
@@ -403,6 +406,27 @@ components/
403
406
 
404
407
  ##### Charts 图表
405
408
 
409
+ 轻量看板由 `MetricCard`(数值、单位、百分比变化)、`ReportCard`(标题、操作、内容、加载/空态)和 `DashboardGrid`(按容器宽度收拢为一/二/多列)组成。指标卡自身不加载图形引擎;`trend={12.8}` 表示 +12.8%,`trendTone` 独立表达业务好坏,下降也可以是 success。缺失或非有限数显示“—”,零值正常显示。
410
+
411
+ `Chart` 新增 `preset`:`grouped-bar`、`stacked-bar`、`stacked-area`、`donut`、`sparkline`。预设补默认图形类型和配置,显式 `type` 及原生属性优先;例如 `innerRadius={0.8}` 覆盖环形默认半径。其他 LayerChart 属性与 snippet 继续透传。
412
+
413
+ 按类型动态加载渲染器;SSR 保留高度并显示加载占位,浏览器挂载后绘制。加载态和空数据不加载渲染器。只需要看板组件时优先使用公开 charts 入口。高级图形通过 `ReportCard` 的 children 使用原生 LayerChart,不受 Chart 的五种类型限制;应用需显式依赖兼容的 `layerchart`,按需使用 `layerchart/svg`、`layerchart/hierarchy` 等实际公开入口。用动态组件加载控制高级图形的加载时机,见 admin 的原生 ArcChart 示例。
414
+
415
+ ```svelte
416
+ <script lang="ts">
417
+ import { Chart, DashboardGrid, MetricCard, ReportCard } from '@h-ai/ui/components/scenes/charts/index'
418
+ const data = [{ month: 'Jan', revenue: 42, cost: 24 }, { month: 'Feb', revenue: 58, cost: 31 }]
419
+ </script>
420
+
421
+ <DashboardGrid label="Key metrics" columns={4}>
422
+ <MetricCard title="Revenue" value="128,430" unit="CNY" trend={12.8} trendTone="success" trendLabel="vs previous month" />
423
+ </DashboardGrid>
424
+ <ReportCard title="Revenue and cost">
425
+ <Chart preset="grouped-bar" {data} x="month" y={['revenue', 'cost']} />
426
+ </ReportCard>
427
+ ```
428
+
429
+
406
430
  `Chart type='line'` 默认透传 LayerChart 原生折线图;需要监控看板常见的“分段线 + 圆点 + 最近点 hover + 竖向参考线”时,使用 `lineVariant='segmented-point'`:
407
431
 
408
432
  ```svelte
@@ -714,10 +738,12 @@ npm install -D @iconify/tailwind4 @iconify-json/tabler
714
738
 
715
739
  #### 主题切换
716
740
 
717
- 使用内置的主题工具函数管理 15 个精选 DaisyUI 主题、高对比及直角商务主题:
741
+ 使用内置的主题工具函数管理 15 个精选 DaisyUI 主题、高对比、直角商务及护眼主题:
718
742
 
719
743
  `high-contrast` 随共享 theme.css 提供:黑底亮字、清晰边框/焦点、增强次要文字及占位符对比度。ThemeSelector 提供三语名称;示例与默认生成工程可选择,fullstack 的显式 themes 列表仍由宿主决定。配色按普通文字 7:1 的目标验收,不代表任意业务内容已通过整站无障碍认证。
720
744
 
745
+ `eye-care` 随共享 theme.css 提供暖绿色背景、深色正文、可读占位符与清晰焦点。主题选择器显示“护眼”,示例及默认模板可直接选择,刷新后保留偏好;现有默认主题及 fullstack 显式 themes 白名单不变。
746
+
721
747
  `formal` 提供直角的商务外观,按钮、输入框、卡片与弹窗不使用装饰性圆角;主题选择器提供三语名称,示例和默认模板可选择。Button 的 submitHint 仅在 type=submit 时显示原生 Enter 提示,不绑定全局快捷键;LoginForm 默认在桌面首次就绪且页面无焦点时聚焦标识,autoFocus=false 可关闭。筛选 Enter 即时查询且忽略输入法确认;主题菜单支持方向键/Home/End、Enter/Space 及 Esc 恢复焦点;确认框默认聚焦取消,Esc 同步取消状态。
722
748
 
723
749
  ```ts
@@ -731,7 +757,7 @@ import {
731
757
  normalizeHexColor, // 归一化 #RGB / #RRGGBB 主题色
732
758
  normalizeThemeId, // 校验主题 ID 并自动回退
733
759
  THEME_GROUPS, // 按亮色/暗色分组
734
- THEMES, // ThemeInfo[] — 17 个主题元数据
760
+ THEMES, // ThemeInfo[] — 18 个主题元数据
735
761
  } from '@h-ai/ui/theme'
736
762
  ```
737
763
 
package/auto-import.d.ts CHANGED
@@ -16,6 +16,10 @@ type AutoImportHaiUiPreprocessor = {
16
16
  export function autoImportHaiUi(): AutoImportHaiUiPreprocessor
17
17
 
18
18
  declare global {
19
+ const Chart: typeof import('@h-ai/ui')['Chart']
20
+ const DashboardGrid: typeof import('@h-ai/ui')['DashboardGrid']
21
+ const MetricCard: typeof import('@h-ai/ui')['MetricCard']
22
+ const ReportCard: typeof import('@h-ai/ui')['ReportCard']
19
23
  const GuideHost: typeof import('@h-ai/ui')['GuideHost']
20
24
  const HelpCenter: typeof import('@h-ai/ui')['HelpCenter']
21
25
  // primitives
package/auto-import.js CHANGED
@@ -120,6 +120,11 @@ const UI_COMPONENTS = new Set([
120
120
  'CrudEditPanel',
121
121
  'CrudFilterBar',
122
122
  'CrudPage',
123
+ // scenes - charts
124
+ 'Chart',
125
+ 'DashboardGrid',
126
+ 'MetricCard',
127
+ 'ReportCard',
123
128
  // scenes - error
124
129
  'ErrorPage',
125
130
  ])
@@ -343,9 +343,9 @@
343
343
  .hai-toast-item {
344
344
  --hai-toast-accent: var(--color-info);
345
345
  display: flex;
346
- align-items: flex-start;
346
+ align-items: center;
347
347
  gap: 0.75rem;
348
- padding: 0.75rem 1rem;
348
+ padding: 0.5rem 0.75rem;
349
349
  border-width: 1px;
350
350
  border-style: solid;
351
351
  border-color: color-mix(in oklab, var(--hai-toast-accent) 20%, var(--color-base-100));
@@ -368,6 +368,15 @@
368
368
  flex-shrink: 0;
369
369
  }
370
370
 
371
+ /* 展开排查信息后,图标和操作仍与正文首行对齐。 */
372
+ .hai-toast-item:has(.hai-toast-details) {
373
+ align-items: flex-start;
374
+ }
375
+
376
+ .hai-toast-item:has(.hai-toast-details) > span[aria-hidden='true'] {
377
+ margin-top: 0.375rem;
378
+ }
379
+
371
380
  .hai-toast-details {
372
381
  margin-top: 0.75rem;
373
382
  padding-top: 0.75rem;
@@ -396,7 +405,9 @@
396
405
  }
397
406
 
398
407
  .hai-toast-message {
399
- flex: 1;
408
+ display: flex;
409
+ align-items: safe center;
410
+ min-height: 2rem;
400
411
  min-width: 0;
401
412
  max-height: min(20rem, 60dvh);
402
413
  overflow: auto;
@@ -165,9 +165,11 @@ function resolveDocumentBaseName(title, filename) {
165
165
  const sanitizedName = stripControlCharacters(preferredName)
166
166
  .replace(/[<>:"/\\|?*]+/g, ' ')
167
167
  .replace(/\s+/g, ' ')
168
- .replace(/[. ]+$/g, '')
169
168
  .trim();
170
- return sanitizedName || 'ai-document';
169
+ let end = sanitizedName.length;
170
+ while (end > 0 && (sanitizedName[end - 1] === '.' || sanitizedName[end - 1] === ' '))
171
+ end--;
172
+ return sanitizedName.slice(0, end) || 'ai-document';
171
173
  }
172
174
  function downloadBlob(blob, filename) {
173
175
  const url = URL.createObjectURL(blob);
@@ -9,8 +9,9 @@ const ALIGN_VALUE_REGEX = /^(?:left|center|right|justify)$/i;
9
9
  const HAI_ALIGN_BLOCK_REGEX = /^<hai-align\s+value="(left|center|right|justify)">\n?([\s\S]+?)\n?<\/hai-align>\n{0,2}/i;
10
10
  const HAI_SPAN_INLINE_REGEX = /^<hai-span\b([^>]*)>([\s\S]+?)<\/hai-span>/i;
11
11
  const HAI_SPAN_ATTR_REGEX = /\b(color|bg)="([^"]+)"/gi;
12
- const HAI_UNDERLINE_REGEX = /^\+\+((?:\\.|[\s\S])+?)\+\+/;
13
- const HAI_HIGHLIGHT_REGEX = /^==((?:\\.|[\s\S])+?)==/;
12
+ // 转义分支与普通字符互斥,未闭合标记中的长反斜线不会触发组合回溯。
13
+ const HAI_UNDERLINE_REGEX = /^\+\+((?:\\[\s\S]|[^\\])+?)\+\+/;
14
+ const HAI_HIGHLIGHT_REGEX = /^==((?:\\[\s\S]|[^\\])+?)==/;
14
15
  /**
15
16
  * Markdown heading 提取目录时需要一个“纯文本标题”。
16
17
  * 这里显式递归常见 inline token,保证 `<hai-span>`、链接、强调等都能回落成纯文本。
@@ -13,22 +13,28 @@ import langCpp from '@shikijs/langs/cpp';
13
13
  import langCsharp from '@shikijs/langs/csharp';
14
14
  import langCss from '@shikijs/langs/css';
15
15
  import langDiff from '@shikijs/langs/diff';
16
+ import langDockerfile from '@shikijs/langs/dockerfile';
17
+ import langDotenv from '@shikijs/langs/dotenv';
16
18
  import langGo from '@shikijs/langs/go';
17
19
  import langGraphql from '@shikijs/langs/graphql';
18
20
  import langHtml from '@shikijs/langs/html';
21
+ import langIni from '@shikijs/langs/ini';
19
22
  import langJava from '@shikijs/langs/java';
20
23
  import langJavascript from '@shikijs/langs/javascript';
21
24
  import langJson from '@shikijs/langs/json';
22
25
  import langKotlin from '@shikijs/langs/kotlin';
23
26
  import langLua from '@shikijs/langs/lua';
24
27
  import langMarkdown from '@shikijs/langs/markdown';
28
+ import langNginx from '@shikijs/langs/nginx';
25
29
  import langPhp from '@shikijs/langs/php';
30
+ import langPowershell from '@shikijs/langs/powershell';
26
31
  import langPython from '@shikijs/langs/python';
27
32
  import langRuby from '@shikijs/langs/ruby';
28
33
  import langRust from '@shikijs/langs/rust';
29
34
  import langScss from '@shikijs/langs/scss';
30
35
  import langShell from '@shikijs/langs/shellscript';
31
36
  import langSql from '@shikijs/langs/sql';
37
+ import langSvelte from '@shikijs/langs/svelte';
32
38
  import langSwift from '@shikijs/langs/swift';
33
39
  import langToml from '@shikijs/langs/toml';
34
40
  import langTypescript from '@shikijs/langs/typescript';
@@ -73,6 +79,12 @@ const highlighter = createHighlighterCoreSync({
73
79
  langToml,
74
80
  langMarkdown,
75
81
  langDiff,
82
+ langDockerfile,
83
+ langDotenv,
84
+ langIni,
85
+ langNginx,
86
+ langPowershell,
87
+ langSvelte,
76
88
  langGraphql,
77
89
  langLua,
78
90
  ],
@@ -88,6 +100,9 @@ const LANG_ALIASES = {
88
100
  'sh': 'bash',
89
101
  'shell': 'bash',
90
102
  'zsh': 'bash',
103
+ 'ps1': 'powershell',
104
+ 'pwsh': 'powershell',
105
+ 'env': 'dotenv',
91
106
  'yml': 'yaml',
92
107
  'c++': 'cpp',
93
108
  'c#': 'csharp',
@@ -28,6 +28,54 @@ function createTableCellAttrs(cell) {
28
28
  }
29
29
  return attrs.length > 0 ? ` ${attrs.join(' ')}` : '';
30
30
  }
31
+ /** 围栏代码和 HTML 代码共用渲染,颜色与复制控件始终由框架生成。 */
32
+ function renderCodeBlock(text, lang, options) {
33
+ const language = lang && isLanguageSupported(lang) ? lang : '';
34
+ let highlighted;
35
+ if (options.enableHighlight && language) {
36
+ highlighted = highlightCode(text, language);
37
+ }
38
+ else if (options.enableHighlight) {
39
+ // 未指定语言时不做自动检测,直接转义
40
+ highlighted = escapeHtml(text);
41
+ }
42
+ else {
43
+ highlighted = escapeHtml(text);
44
+ }
45
+ const langLabel = language
46
+ ? `<span class="hai-md-code-lang">${escapeHtml(language)}</span>`
47
+ : '';
48
+ const copyBtn = options.showCopyButton
49
+ ? `<button type="button" class="hai-md-copy-btn" data-copy-code aria-label="${escapeHtml(uiM('markdown_copy_code'))}"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg></button>`
50
+ : '';
51
+ return `<div class="hai-md-code-block">`
52
+ + `<div class="hai-md-code-header">${langLabel}${copyBtn}</div>`
53
+ + `<pre><code class="hai-hl${language ? ` language-${escapeHtml(language)}` : ''}">${highlighted}</code></pre>`
54
+ + `</div>`;
55
+ }
56
+ /** 仅还原代码文本的实体;随后仍按普通代码转义,绝不把代码中的标签作为 HTML 执行。 */
57
+ function decodeCodeText(text) {
58
+ const named = { amp: '&', lt: '<', gt: '>', quot: '"', apos: '\'', nbsp: '\u00A0' };
59
+ return text.replace(/&(#(?:[xX][\da-fA-F]+|\d+)|amp|lt|gt|quot|apos|nbsp);/g, (entity, key) => {
60
+ if (!key.startsWith('#'))
61
+ return named[key] ?? entity;
62
+ const code = key[1]?.toLowerCase() === 'x' ? Number.parseInt(key.slice(2), 16) : Number(key.slice(1));
63
+ return code > 0 && code <= 0x10FFFF && !(code >= 0xD800 && code <= 0xDFFF) ? String.fromCodePoint(code) : entity;
64
+ });
65
+ }
66
+ /** 重建 pre/code,不保留输入的 style、事件或任意 class;其余 HTML 继续通过原有白名单。 */
67
+ function renderHtmlWithCode(source, options) {
68
+ let html = '';
69
+ let offset = 0;
70
+ for (const match of source.matchAll(/<pre\b[^>]*>\s*<code\b([^>]*)>([\s\S]*?)<\/code>\s*<\/pre>/gi)) {
71
+ html += sanitizeMarkdownHtml(source.slice(offset, match.index));
72
+ const classes = /\bclass\s*=\s*(?:"([^"]*)"|'([^']*)')/i.exec(match[1]);
73
+ const language = /(?:^|\s)language-([a-z\d#+.-]+)(?:\s|$)/i.exec(classes?.[1] ?? classes?.[2] ?? '')?.[1];
74
+ html += renderCodeBlock(decodeCodeText(match[2]), language, options);
75
+ offset = match.index + match[0].length;
76
+ }
77
+ return html + sanitizeMarkdownHtml(source.slice(offset));
78
+ }
31
79
  /**
32
80
  * 创建自定义渲染器对象
33
81
  *
@@ -38,34 +86,13 @@ function createRendererObject(options) {
38
86
  return {
39
87
  // 代码块:语法高亮 + 语言标签 + 复制按钮
40
88
  code({ text, lang }) {
41
- const language = lang && isLanguageSupported(lang) ? lang : '';
42
- let highlighted;
43
- if (options.enableHighlight && language) {
44
- highlighted = highlightCode(text, language);
45
- }
46
- else if (options.enableHighlight) {
47
- // 未指定语言时不做自动检测,直接转义
48
- highlighted = escapeHtml(text);
49
- }
50
- else {
51
- highlighted = escapeHtml(text);
52
- }
53
- const langLabel = language
54
- ? `<span class="hai-md-code-lang">${escapeHtml(language)}</span>`
55
- : '';
56
- const copyBtn = options.showCopyButton
57
- ? `<button type="button" class="hai-md-copy-btn" data-copy-code aria-label="${escapeHtml(uiM('markdown_copy_code'))}"><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg></button>`
58
- : '';
59
- return `<div class="hai-md-code-block">`
60
- + `<div class="hai-md-code-header">${langLabel}${copyBtn}</div>`
61
- + `<pre><code class="hai-hl${language ? ` language-${escapeHtml(language)}` : ''}">${highlighted}</code></pre>`
62
- + `</div>`;
89
+ return renderCodeBlock(text, lang, options);
63
90
  },
64
91
  // 原始 HTML 块:转义以防止 XSS
65
92
  html(token) {
66
93
  const source = readHtmlTokenSource(token);
67
94
  return options.allowHtmlTags
68
- ? sanitizeMarkdownHtml(source)
95
+ ? renderHtmlWithCode(source, options)
69
96
  : escapeHtml(source);
70
97
  },
71
98
  // 链接:外部链接自动添加 target="_blank",阻止危险协议
@@ -103,7 +103,7 @@
103
103
  }
104
104
 
105
105
  function themeName(theme: ThemeInfo): string {
106
- return theme.id === 'high-contrast' ? uiM('theme_high_contrast') : theme.id === 'formal' ? uiM('theme_formal') : theme.name
106
+ return theme.id === 'high-contrast' ? uiM('theme_high_contrast') : theme.id === 'formal' ? uiM('theme_formal') : theme.id === 'eye-care' ? uiM('theme_eye_care') : theme.name
107
107
  }
108
108
 
109
109
  function renderThemePreview(theme: ThemeInfo) {
@@ -20,18 +20,16 @@
20
20
  -->
21
21
  <script lang='ts'>
22
22
  import type { ChartProps, ChartSeries, ChartType } from './chart-types.js'
23
+ import { onMount } from 'svelte'
23
24
  import { uiM } from '../../../messages.js'
24
25
  import { cn, getDataAttributes } from '../../../utils.js'
26
+ import { resolveChartPreset } from './chart-presets.js'
25
27
  import { DAISYUI_CHART_COLORS, resolveChartColors } from './chart-theme.js'
26
- import AreaChart from './renderers/AreaChart.svelte'
27
- import BarChart from './renderers/BarChart.svelte'
28
- import LineChart from './renderers/LineChart.svelte'
29
- import PieChart from './renderers/PieChart.svelte'
30
- import ScatterChart from './renderers/ScatterChart.svelte'
31
- import 'layerchart/daisyui-5.css'
28
+ import ChartLoadError from './ChartLoadError.svelte'
32
29
 
33
30
  const {
34
- type,
31
+ type: requestedType,
32
+ preset,
35
33
  data = [],
36
34
  x,
37
35
  y,
@@ -46,8 +44,24 @@
46
44
  ...restProps
47
45
  }: ChartProps = $props()
48
46
 
47
+ const presetConfig = $derived(resolveChartPreset(preset))
48
+ const type = $derived(requestedType ?? presetConfig.type ?? 'line')
49
+ const nativeProps = $derived({ ...presetConfig.props, ...restProps })
49
50
  const dataAttributes = $derived(getDataAttributes(restProps))
50
51
 
52
+ // 仅浏览器挂载且确有数据时加载对应图形;Svelte await 自动丢弃过期 Promise 的结果。
53
+ const renderers = {
54
+ bar: () => import('./renderers/BarChart.svelte'),
55
+ line: () => import('./renderers/LineChart.svelte'),
56
+ area: () => import('./renderers/AreaChart.svelte'),
57
+ pie: () => import('./renderers/PieChart.svelte'),
58
+ scatter: () => import('./renderers/ScatterChart.svelte'),
59
+ }
60
+ let mounted = $state(false)
61
+ onMount(() => {
62
+ mounted = true
63
+ })
64
+
51
65
  const chartSizeHeights: Record<NonNullable<ChartProps['size']>, number> = {
52
66
  sm: 200,
53
67
  md: 300,
@@ -58,10 +72,11 @@
58
72
 
59
73
  /** 图表可视高度优先尊重 LayerChart 原生 height,未传时使用 @h-ai/ui 的 size 预设。 */
60
74
  const chartHeight = $derived(
61
- typeof restProps.height === 'number' ? restProps.height : chartSizeHeights[size],
75
+ typeof nativeProps.height === 'number' ? nativeProps.height : chartSizeHeights[size],
62
76
  )
63
77
 
64
78
  const isEmpty = $derived(empty || data.length === 0)
79
+ const rendererPromise = $derived(mounted && !loading && !isEmpty ? renderers[type]() : undefined)
65
80
  const hasHeader = $derived(Boolean(title || description))
66
81
 
67
82
  const rootClass = $derived(
@@ -112,7 +127,7 @@
112
127
  data,
113
128
  height: chartHeight,
114
129
  cRange: DAISYUI_CHART_COLORS,
115
- ...restProps,
130
+ ...nativeProps,
116
131
  orientation,
117
132
  series: resolvedSeries,
118
133
  x,
@@ -126,7 +141,7 @@
126
141
  label: x,
127
142
  value: pieValue,
128
143
  cRange: DAISYUI_CHART_COLORS,
129
- ...restProps,
144
+ ...nativeProps,
130
145
  series: resolvedSeries,
131
146
  })
132
147
  </script>
@@ -148,16 +163,24 @@
148
163
  <span class='loading loading-spinner loading-md text-primary' aria-label={uiM('chart_loading')}></span>
149
164
  {:else if isEmpty}
150
165
  <p class='text-sm text-base-content/50'>{uiM('chart_empty')}</p>
151
- {:else if type === 'bar'}
152
- <BarChart {...cartesianLayerProps} />
153
- {:else if type === 'line'}
154
- <LineChart {...cartesianLayerProps} />
155
- {:else if type === 'area'}
156
- <AreaChart {...cartesianLayerProps} />
157
- {:else if type === 'pie'}
158
- <PieChart {...pieLayerProps} />
159
- {:else if type === 'scatter'}
160
- <ScatterChart {...cartesianLayerProps} />
166
+ {:else if !mounted}
167
+ <div class='flex h-full items-center justify-center' role='status' aria-label={uiM('chart_loading')}>
168
+ <span class='loading loading-spinner loading-md text-primary'></span>
169
+ </div>
170
+ {:else}
171
+ {#await rendererPromise}
172
+ <div class='flex h-full items-center justify-center' role='status' aria-label={uiM('chart_loading')}>
173
+ <span class='loading loading-spinner loading-md text-primary'></span>
174
+ </div>
175
+ {:then renderer}
176
+ {#if renderer}
177
+ {@const Renderer = renderer.default}
178
+ <Renderer {...(type === 'pie' ? pieLayerProps : cartesianLayerProps)} />
179
+ {/if}
180
+ {:catch}
181
+ <!-- 浏览器可能缓存失败的模块请求;刷新文档后才能可靠重试同一资源。 -->
182
+ <ChartLoadError onretry={() => window.location.reload()} />
183
+ {/await}
161
184
  {/if}
162
185
  </div>
163
186
  </div>
@@ -1,5 +1,4 @@
1
1
  import type { ChartProps } from './chart-types.js';
2
- import 'layerchart/daisyui-5.css';
3
2
  /**
4
3
  * Chart
5
4
  * =============================================================================
@@ -0,0 +1,13 @@
1
+ <!-- 图形模块加载失败时使用统一 Toast,原位保留重试操作。 -->
2
+ <script lang='ts'>
3
+ import { uiM } from '../../../messages.js'
4
+ import { useToastFeedback } from '../../../toast.svelte.js'
5
+ import Button from '../../primitives/Button.svelte'
6
+ /** 重试由 Chart 重新创建本次动态导入。 */
7
+ const { onretry }: { onretry: () => void } = $props()
8
+ useToastFeedback(() => uiM('chart_load_failed'))
9
+ </script>
10
+
11
+ <div class='flex h-full items-center justify-center'>
12
+ <Button onclick={onretry} size='sm'>{uiM('chart_retry')}</Button>
13
+ </div>