@squadbase/vantage 0.7.1-dev1.5e06644 → 0.7.1-dev1.618b9b9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squadbase/vantage",
-  "version": "0.7.1-dev1.5e06644",
+  "version": "0.7.1-dev1.618b9b9",
   "description": "Data dashboard framework for Squadbase Editor. Vite-powered, config-free, one-file first.",
   "type": "module",
   "license": "MIT",
@@ -152,7 +152,7 @@
     "vitest": "^5.0.5",
     "@squadbase/squadkit": "0.0.0"
   },
-  "gitHead": "5e06644401a5611844db3859456816129dcfcdae",
+  "gitHead": "618b9b95403e96051d98e404b8fa31728b7f5056",
   "scripts": {
     "build": "node scripts/build-docs.mjs && node scripts/build.mjs",
     "build:js": "tsup --no-dts",

package/templates/AGENTS.md

@@ -96,7 +96,7 @@ root/
 | `@squadbase/vantage/router` | `Link`・`Outlet`・`useParams`・`useSearch`・`useNavigate`・`redirect`・`notFound`・`useRoutes`・`useCurrentRoute`・`useSearchParam`・`useSearchState` |
 | `@squadbase/vantage/query` | `useApiQuery`・`useApiMutation`・`apiJson`・`apiFetch`・`apiUrl`・`ApiError`、ほか `useQuery`/`useMutation` など TanStack Query の再エクスポート |
 | `@squadbase/vantage/ui` | shadcn/ui(Base UI バリアント)プリミティブ(`Button`・`Loading`・`ErrorState`・`Empty` ほか) |
-| `@squadbase/vantage/components` | 複合パーツ(`PageShell`・`DashboardCardPreset`・`DataTablePreset`、KPI の `KpiCard`・`Delta`、型付きチャート `LineChart`・`BarChart`・`AreaChart`・`DonutChart`・`BarList` ほか、`EChart`、書式の `formatValue`) |
+| `@squadbase/vantage/components` | 複合パーツ(`PageShell`・`DashboardCardPreset`・`DataTablePreset`、KPI の `KpiCard`・`Delta`、型付きチャート `LineChart`・`BarChart`・`AreaChart`・`ScatterChart`・`Heatmap`・`DonutChart`・`FunnelSteps`・`BarList` ほか、表せないときだけ `EChart`、書式の `formatValue`) |
 | `@squadbase/vantage/table` | `FilePageView`・`TableViewer`(データファイルページの表ビューア) |
 | `@squadbase/vantage/slide` | `SlideDeck`・`Slide`・`Steps`・`Step`・`MorphElement`・`useSlideNumber`・`useIsActiveSlide`、1 枚分の block `SlideCover`・`SlideExecSummary`・`SlideKpiHero`・`SlideKpiGrid`・`SlideChartInsight`・`SlideScorecardTable`・`SlideNextActions`・`SlideSection`・`SlideComparison`・`SlideChartFull`、手書きの 1 枚に使う部品 `SlideHeading`・`SlideSourceLine`・`SlideColumns`・`SlideColumn`・`DeltaText`(スライド専用。1920×1080 の固定キャンバス) |
 | `@squadbase/vantage/doc` | `Document`、ドキュメント用の block `DocReportHeader`・`DocExecutiveSummary`・`DocKpiScorecard`・`DocFigure`・`DocDataTable`・`DocCallout`・`DocKeyFindings`・`DocActionItems`・`DocNotesAndSources`、部品 `DeltaText`(ドキュメント専用。中の素の HTML 要素に見出し・表などのスタイルが当たる) |
@@ -137,7 +137,7 @@ import { KpiCard, Delta } from "@squadbase/vantage/components";
   まとめる)。増減の良否は指標の性質(コスト減・解約率減は良い)で決めて
   positive / negative に分け(`KpiCard` / `Delta` の `betterWhen`。下がって良い指標は `betterWhen="down"`)、向きは ▲▼ や符号で表す。
 - **レイアウト:** 内容はカードで包む(ページのチャートはタイトル付きの `DashboardCardPreset` に入れる。
-  `EChart` は親の幅に追従する)。順序は KPI → チャート → 表。値が 1 つなら KPI にする
+  チャートは親の幅に追従する)。順序は KPI → チャート → 表。値が 1 つなら KPI にする
   (1 本の棒グラフにしない)。強調は 1 画面(スライドは 1 枚)に 1 か所。数値には単位と比較対象を添える。
 - **Do:** トークンで色を指定する / 色の意味をアプリ全体でそろえる / チャートのタイトルに結論を書く。
 - **Don't:** 色コードや素のパレットクラスを書く / `dark:` を並べる / 3D・装飾目的のグラデーション・

package/templates/agents/page.md

@@ -224,7 +224,7 @@ refetchOnWindowFocus false・networkMode "always")。挙動を変えたいとき
   `ErrorState`・`Empty`・`Select`・`Checkbox`・`RadioGroup`・`Field`・`Combobox`・`Pagination`・
   `Avatar`・`Kbd`・`HoverCard`・`AlertDialog`・`Drawer`・`Toaster` + `toast.add()` ほか)。
 - **複合パーツ**は `@squadbase/vantage/components` から(`PageShell`・`DashboardCardPreset`・
-  `DataTablePreset`・型付きチャート(下の「グラフ」)・`EChart` ほか)。
+  `DataTablePreset`・型付きチャート(下の「グラフ」)ほか)。
 - **どの名前が import 可能か / props の詳細は `vantage docs` で引く。** ガイドとコンポーネント
   リファレンスはパッケージに同梱されていて、オフラインでも読める(→ `AGENTS.md` の
   「ドキュメントを引く」)。**名前が分からないとき**はやりたいことで `vantage search` する
@@ -246,13 +246,14 @@ refetchOnWindowFocus false・networkMode "always")。挙動を変えたいとき
 
 ### グラフはまず型付きチャートで描く
 
-- 推移は `LineChart` / `AreaChart`、比較は `BarChart`、構成比は `DonutChart`。`data`(行の配列)・
+- 推移は `LineChart` / `AreaChart`、比較は `BarChart`、相関は `ScatterChart`、2 軸の濃淡は `Heatmap`、
+  構成比は `DonutChart`、段階ごとの減少は `FunnelSteps`。`data`(行の配列)・
   `index`(x 軸の列)・`categories`(系列の列)を渡すだけで、option は書かない
   (`DonutChart` は `category` / `value`)。
 - 上位 N 件は `BarList`、判定帯や予算消化は `CategoryBar`、達成率は `ProgressCircle`、
   日ごとの状態は `Tracker`。
-- `EChart` + `EChartsOption` は、二軸・散布図・ヒートマップ・注釈線など型付きチャートの props で
-  表せないときだけ使う。
+- `EChart` + option 関数は、レーダーなど型付きチャートで表せないときだけ使う。`EChart` で組んだ
+  グラフは、あとから種類もデータも編集で変えられない。
 - 色は省略してテーマトークンに任せる。指定するなら `"chart-1"`〜`"chart-5"` か
   `"var(--destructive)"` などの CSS 色。hex の直書きや Tailwind クラスは使わない。
 - 数値の書式(`¥`・`%`・桁区切り)は `valueFormatter` に渡す。