@squadbase/vantage 0.6.2-dev1.b332e5a → 0.6.2-dev1.d7c0911

package/docs/index.json

@@ -28,7 +28,7 @@
       "section": "guide",
       "sectionTitle": "ガイド",
       "title": "ファイルベースルーティング",
-      "description": "ファイルを置くだけでルートが生まれる。ページ・レイアウト・動的パラメータ・404/error の規約と、tsx 以外のページ（csv / xlsx / スライド / ドキュメント）。",
+      "description": "ファイルを置くだけでルートが生まれる。ページ・レイアウト・動的パラメータ・404/error の規約。",
       "file": "ja/routing.md",
       "order": 1
     },
@@ -50,7 +50,7 @@
       "title": "データ取得",
       "description": "管理された TanStack Query（useQuery）でサーバー状態を扱う。",
       "file": "ja/data-fetching.md",
-      "order": 3
+      "order": 4
     },
     {
       "slug": "api-and-server",
@@ -60,7 +60,7 @@
       "title": "API とサーバー",
       "description": "server/ を足すと API が有効になる。ApiContext・HttpError・HTTP メソッドの規約。",
       "file": "ja/api-and-server.md",
-      "order": 4
+      "order": 5
     },
     {
       "slug": "environment-variables",
@@ -70,7 +70,7 @@
       "title": "環境変数",
       "description": "PUBLIC_ 接頭辞の env だけがクライアントに届く。シークレットはサーバーの env から読む。",
       "file": "ja/environment-variables.md",
-      "order": 5
+      "order": 6
     },
     {
       "slug": "ui-and-theming",
@@ -80,7 +80,7 @@
       "title": "UI とテーマ",
       "description": "組み込み UI キットを import する。styles.css でテーマトークンを上書きする。add でソースをコピーする。",
       "file": "ja/ui-and-theming.md",
-      "order": 6
+      "order": 7
     },
     {
       "slug": "build-and-deploy",
@@ -90,7 +90,7 @@
       "title": "ビルドとデプロイ",
       "description": "dist/ の中身と vantage-manifest.json。同一オリジン配信と、フロント/サーバーを別オリジンに分けるデプロイ(S3+CloudFront ⇄ Lambda など)。",
       "file": "ja/build-and-deploy.md",
-      "order": 7
+      "order": 8
     },
     {
       "slug": "cli-reference",
@@ -100,7 +100,7 @@
       "title": "CLI リファレンス",
       "description": "vantage の全コマンド。dev・build・preview・check・routes・add・docs・search・doctor・upgrade。",
       "file": "ja/cli-reference.md",
-      "order": 8
+      "order": 9
     },
     {
       "slug": "agent-skills",
@@ -110,7 +110,7 @@
       "title": "エージェントと Skills",
       "description": "Vantage に同梱された Claude Code の Agent Skills。vantage add skill でアプリに配置し（既定はルート直下、--dir で .claude/skills などに変更）、エージェントに手順を伴うワークフローを教える。",
       "file": "ja/agent-skills.md",
-      "order": 9
+      "order": 10
     },
     {
       "slug": "changelog",
@@ -120,7 +120,7 @@
       "title": "変更履歴",
       "description": "Vantage のリリースごとの変更点。新しいものが上。まだプロトタイプ(0.x)のため、リリース間で API が変わることがあります。",
       "file": "ja/changelog.md",
-      "order": 10,
+      "order": 11,
       "searchable": false
     },
     {
@@ -131,7 +131,7 @@
       "title": "ロードマップ",
       "description": "Vantage がこれから向かう方向。エージェントに「目」と「記憶」を与えるための検討中のアイデアと、意図的にやらないこと。",
       "file": "ja/roadmap.md",
-      "order": 11,
+      "order": 12,
       "searchable": false
     },
     {
@@ -164,6 +164,26 @@
       "file": "ja/ui/alert.md",
       "order": 1
     },
+    {
+      "slug": "ui/alert-dialog",
+      "lang": "ja",
+      "section": "components/ui",
+      "sectionTitle": "@squadbase/vantage/ui",
+      "title": "Alert Dialog",
+      "description": "取り消せない操作の前に確認するモーダル。",
+      "file": "ja/ui/alert-dialog.md",
+      "order": 2
+    },
+    {
+      "slug": "ui/avatar",
+      "lang": "ja",
+      "section": "components/ui",
+      "sectionTitle": "@squadbase/vantage/ui",
+      "title": "Avatar",
+      "description": "ユーザーの顔写真またはイニシャル。",
+      "file": "ja/ui/avatar.md",
+      "order": 3
+    },
     {
       "slug": "ui/badge",
       "lang": "ja",
@@ -172,7 +192,7 @@
       "title": "Badge",
       "description": "小さなラベル。件数・状態・タグに。",
       "file": "ja/ui/badge.md",
-      "order": 2
+      "order": 4
     },
     {
       "slug": "ui/breadcrumb",
@@ -182,7 +202,7 @@
       "title": "Breadcrumb",
       "description": "階層を示すパンくずリスト。",
       "file": "ja/ui/breadcrumb.md",
-      "order": 3
+      "order": 5
     },
     {
       "slug": "ui/button",
@@ -192,7 +212,7 @@
       "title": "Button",
       "description": "6 つの variant と 8 つの size を持つボタン。",
       "file": "ja/ui/button.md",
-      "order": 4
+      "order": 6
     },
     {
       "slug": "ui/calendar",
@@ -202,7 +222,7 @@
       "title": "Calendar",
       "description": "react-day-picker ベースの日付カレンダー。",
       "file": "ja/ui/calendar.md",
-      "order": 5
+      "order": 7
     },
     {
       "slug": "ui/card",
@@ -212,7 +232,7 @@
       "title": "Card",
       "description": "汎用のカード。ダッシュボードのタイルには DashboardCard を。",
       "file": "ja/ui/card.md",
-      "order": 6
+      "order": 8
     },
     {
       "slug": "ui/checkbox",
@@ -222,7 +242,7 @@
       "title": "Checkbox",
       "description": "チェックボックス。中間状態は indeterminate プロップで。",
       "file": "ja/ui/checkbox.md",
-      "order": 7
+      "order": 9
     },
     {
       "slug": "ui/collapsible",
@@ -232,7 +252,17 @@
       "title": "Collapsible",
       "description": "単独の折りたたみ。スタイルは付かない。",
       "file": "ja/ui/collapsible.md",
-      "order": 8
+      "order": 10
+    },
+    {
+      "slug": "ui/combobox",
+      "lang": "ja",
+      "section": "components/ui",
+      "sectionTitle": "@squadbase/vantage/ui",
+      "title": "Combobox",
+      "description": "入力して候補を絞り込むセレクト。",
+      "file": "ja/ui/combobox.md",
+      "order": 11
     },
     {
       "slug": "ui/command",
@@ -242,7 +272,7 @@
       "title": "Command",
       "description": "絞り込み付きのコマンドリスト。⌘K パレットの土台。",
       "file": "ja/ui/command.md",
-      "order": 9
+      "order": 12
     },
     {
       "slug": "ui/dialog",
@@ -252,7 +282,17 @@
       "title": "Dialog",
       "description": "モーダルダイアログ。",
       "file": "ja/ui/dialog.md",
-      "order": 10
+      "order": 13
+    },
+    {
+      "slug": "ui/drawer",
+      "lang": "ja",
+      "section": "components/ui",
+      "sectionTitle": "@squadbase/vantage/ui",
+      "title": "Drawer",
+      "description": "画面の端からスワイプで出し入れするパネル。",
+      "file": "ja/ui/drawer.md",
+      "order": 14
     },
     {
       "slug": "ui/dropdown-menu",
@@ -262,7 +302,7 @@
       "title": "DropdownMenu",
       "description": "ボタンから開くメニュー。チェック項目・ラジオ・サブメニュー対応。",
       "file": "ja/ui/dropdown-menu.md",
-      "order": 11
+      "order": 15
     },
     {
       "slug": "ui/empty",
@@ -272,7 +312,7 @@
       "title": "Empty",
       "description": "データが 0 件のときの表示。",
       "file": "ja/ui/empty.md",
-      "order": 12
+      "order": 16
     },
     {
       "slug": "ui/error-state",
@@ -282,7 +322,27 @@
       "title": "ErrorState",
       "description": "失敗したときの表示。",
       "file": "ja/ui/error-state.md",
-      "order": 13
+      "order": 17
+    },
+    {
+      "slug": "ui/field",
+      "lang": "ja",
+      "section": "components/ui",
+      "sectionTitle": "@squadbase/vantage/ui",
+      "title": "Field",
+      "description": "ラベル・説明・エラーを入力と束ねるフォームのレイアウト部品。",
+      "file": "ja/ui/field.md",
+      "order": 18
+    },
+    {
+      "slug": "ui/hover-card",
+      "lang": "ja",
+      "section": "components/ui",
+      "sectionTitle": "@squadbase/vantage/ui",
+      "title": "Hover Card",
+      "description": "リンクにホバーすると出るプレビューカード。",
+      "file": "ja/ui/hover-card.md",
+      "order": 19
     },
     {
       "slug": "ui/input",
@@ -292,7 +352,7 @@
       "title": "Input",
       "description": "1 行のテキスト入力。",
       "file": "ja/ui/input.md",
-      "order": 14
+      "order": 20
     },
     {
       "slug": "ui/input-group",
@@ -302,7 +362,17 @@
       "title": "InputGroup",
       "description": "入力欄の前後にアイコン・テキスト・ボタンを添える。",
       "file": "ja/ui/input-group.md",
-      "order": 15
+      "order": 21
+    },
+    {
+      "slug": "ui/kbd",
+      "lang": "ja",
+      "section": "components/ui",
+      "sectionTitle": "@squadbase/vantage/ui",
+      "title": "Kbd",
+      "description": "キーボードのキー表示。",
+      "file": "ja/ui/kbd.md",
+      "order": 22
     },
     {
       "slug": "ui/label",
@@ -312,7 +382,7 @@
       "title": "Label",
       "description": "フォーム項目のラベル。",
       "file": "ja/ui/label.md",
-      "order": 16
+      "order": 23
     },
     {
       "slug": "ui/loading",
@@ -322,7 +392,17 @@
       "title": "Loading",
       "description": "ラベル付きの中央寄せスピナー。",
       "file": "ja/ui/loading.md",
-      "order": 17
+      "order": 24
+    },
+    {
+      "slug": "ui/pagination",
+      "lang": "ja",
+      "section": "components/ui",
+      "sectionTitle": "@squadbase/vantage/ui",
+      "title": "Pagination",
+      "description": "ページ送りのリンク列。",
+      "file": "ja/ui/pagination.md",
+      "order": 25
     },
     {
       "slug": "ui/popover",
@@ -332,7 +412,7 @@
       "title": "Popover",
       "description": "トリガーに寄り添う吹き出し。",
       "file": "ja/ui/popover.md",
-      "order": 18
+      "order": 26
     },
     {
       "slug": "ui/progress",
@@ -342,7 +422,17 @@
       "title": "Progress",
       "description": "進捗バー。ラベルと値の表示を組める。",
       "file": "ja/ui/progress.md",
-      "order": 19
+      "order": 27
+    },
+    {
+      "slug": "ui/radio-group",
+      "lang": "ja",
+      "section": "components/ui",
+      "sectionTitle": "@squadbase/vantage/ui",
+      "title": "Radio Group",
+      "description": "少数の選択肢から 1 つを選ぶラジオボタン。",
+      "file": "ja/ui/radio-group.md",
+      "order": 28
     },
     {
       "slug": "ui/scroll-area",
@@ -352,7 +442,7 @@
       "title": "ScrollArea",
       "description": "OS 依存しないスクロールバーを持つ領域。",
       "file": "ja/ui/scroll-area.md",
-      "order": 20
+      "order": 29
     },
     {
       "slug": "ui/select",
@@ -362,7 +452,7 @@
       "title": "Select",
       "description": "単一選択のセレクト。onValueChange は null を渡しうる。",
       "file": "ja/ui/select.md",
-      "order": 21
+      "order": 30
     },
     {
       "slug": "ui/separator",
@@ -372,7 +462,7 @@
       "title": "Separator",
       "description": "1 本の区切り線。",
       "file": "ja/ui/separator.md",
-      "order": 22
+      "order": 31
     },
     {
       "slug": "ui/sheet",
@@ -382,7 +472,7 @@
       "title": "Sheet",
       "description": "画面の端から出るパネル。",
       "file": "ja/ui/sheet.md",
-      "order": 23
+      "order": 32
     },
     {
       "slug": "ui/sidebar",
@@ -392,7 +482,7 @@
       "title": "Sidebar",
       "description": "折りたためるアプリのサイドバー一式。",
       "file": "ja/ui/sidebar.md",
-      "order": 24
+      "order": 33
     },
     {
       "slug": "ui/skeleton",
@@ -402,7 +492,7 @@
       "title": "Skeleton",
       "description": "中身と同じ形をした読み込み中の箱。",
       "file": "ja/ui/skeleton.md",
-      "order": 25
+      "order": 34
     },
     {
       "slug": "ui/slider",
@@ -412,7 +502,7 @@
       "title": "Slider",
       "description": "つまみで数値を選ぶ。範囲指定にも対応。",
       "file": "ja/ui/slider.md",
-      "order": 26
+      "order": 35
     },
     {
       "slug": "ui/spinner",
@@ -422,7 +512,7 @@
       "title": "Spinner",
       "description": "いちばん小さい待機表示。",
       "file": "ja/ui/spinner.md",
-      "order": 27
+      "order": 36
     },
     {
       "slug": "ui/switch",
@@ -432,7 +522,7 @@
       "title": "Switch",
       "description": "即時に効く設定のトグル。",
       "file": "ja/ui/switch.md",
-      "order": 28
+      "order": 37
     },
     {
       "slug": "ui/table",
@@ -442,7 +532,7 @@
       "title": "Table",
       "description": "素の表プリミティブ。並べ替えや検索が要るなら DataTable を。",
       "file": "ja/ui/table.md",
-      "order": 29
+      "order": 38
     },
     {
       "slug": "ui/tabs",
@@ -452,7 +542,7 @@
       "title": "Tabs",
       "description": "表示を切り替えるタブ。",
       "file": "ja/ui/tabs.md",
-      "order": 30
+      "order": 39
     },
     {
       "slug": "ui/textarea",
@@ -462,7 +552,17 @@
       "title": "Textarea",
       "description": "複数行のテキスト入力。",
       "file": "ja/ui/textarea.md",
-      "order": 31
+      "order": 40
+    },
+    {
+      "slug": "ui/toast",
+      "lang": "ja",
+      "section": "components/ui",
+      "sectionTitle": "@squadbase/vantage/ui",
+      "title": "Toast",
+      "description": "画面の隅に一時的に出る通知。",
+      "file": "ja/ui/toast.md",
+      "order": 41
     },
     {
       "slug": "ui/toggle",
@@ -472,7 +572,7 @@
       "title": "Toggle",
       "description": "押した状態を保つボタン。",
       "file": "ja/ui/toggle.md",
-      "order": 32
+      "order": 42
     },
     {
       "slug": "ui/toggle-group",
@@ -482,7 +582,7 @@
       "title": "ToggleGroup",
       "description": "トグルの束。value は常に配列。",
       "file": "ja/ui/toggle-group.md",
-      "order": 33
+      "order": 43
     },
     {
       "slug": "ui/tooltip",
@@ -492,7 +592,7 @@
       "title": "Tooltip",
       "description": "ホバーで出る短い説明。",
       "file": "ja/ui/tooltip.md",
-      "order": 34
+      "order": 44
     },
     {
       "slug": "ui/cn",
@@ -502,7 +602,7 @@
       "title": "cn()",
       "description": "条件付きでクラスを組み立て、競合を解決するヘルパー。",
       "file": "ja/ui/cn.md",
-      "order": 35
+      "order": 45
     },
     {
       "slug": "ui/use-is-mobile",
@@ -512,7 +612,7 @@
       "title": "useIsMobile()",
       "description": "画面幅が狭いかどうかを返すフック。",
       "file": "ja/ui/use-is-mobile.md",
-      "order": 36
+      "order": 46
     },
     {
       "slug": "parts/app-shell",
@@ -524,6 +624,46 @@
       "file": "ja/parts/app-shell.md",
       "order": 0
     },
+    {
+      "slug": "parts/area-chart",
+      "lang": "ja",
+      "section": "components/parts",
+      "sectionTitle": "@squadbase/vantage/components",
+      "title": "AreaChart",
+      "description": "推移を面で見せる型付きグラフ。行・x 軸の列・系列の列を渡すだけ。",
+      "file": "ja/parts/area-chart.md",
+      "order": 1
+    },
+    {
+      "slug": "parts/bar-chart",
+      "lang": "ja",
+      "section": "components/parts",
+      "sectionTitle": "@squadbase/vantage/components",
+      "title": "BarChart",
+      "description": "比較を棒で見せる型付きグラフ。横並び・積み上げ・横棒に切り替えられる。",
+      "file": "ja/parts/bar-chart.md",
+      "order": 2
+    },
+    {
+      "slug": "parts/bar-list",
+      "lang": "ja",
+      "section": "components/parts",
+      "sectionTitle": "@squadbase/vantage/components",
+      "title": "BarList",
+      "description": "名前と値を横棒で並べるランキング。軸なしで、カードに収まる軽さ。",
+      "file": "ja/parts/bar-list.md",
+      "order": 3
+    },
+    {
+      "slug": "parts/category-bar",
+      "lang": "ja",
+      "section": "components/parts",
+      "sectionTitle": "@squadbase/vantage/components",
+      "title": "CategoryBar",
+      "description": "1 本の棒を区間に色分けし、現在値をマーカーで示す。",
+      "file": "ja/parts/category-bar.md",
+      "order": 4
+    },
     {
       "slug": "parts/dashboard-card",
       "lang": "ja",
@@ -532,7 +672,7 @@
       "title": "DashboardCard",
       "description": "ダッシュボードのタイル。プリセットとスケルトン付き。",
       "file": "ja/parts/dashboard-card.md",
-      "order": 1
+      "order": 5
     },
     {
       "slug": "parts/data-table",
@@ -542,7 +682,7 @@
       "title": "DataTable",
       "description": "TanStack Table ベースの表。並べ替え・検索・ページング・選択。",
       "file": "ja/parts/data-table.md",
-      "order": 2
+      "order": 6
     },
     {
       "slug": "parts/date-range-picker",
@@ -552,7 +692,27 @@
       "title": "DateRangePicker",
       "description": "プリセット付きの期間選択。",
       "file": "ja/parts/date-range-picker.md",
-      "order": 3
+      "order": 7
+    },
+    {
+      "slug": "parts/delta",
+      "lang": "ja",
+      "section": "components/parts",
+      "sectionTitle": "@squadbase/vantage/components",
+      "title": "Delta",
+      "description": "比較相手に対する増減。矢印・符号付きの率・比較ラベルを値から導く。",
+      "file": "ja/parts/delta.md",
+      "order": 8
+    },
+    {
+      "slug": "parts/donut-chart",
+      "lang": "ja",
+      "section": "components/parts",
+      "sectionTitle": "@squadbase/vantage/components",
+      "title": "DonutChart",
+      "description": "構成比を見せる型付きのドーナツ / 円グラフ。中央に合計を出す。",
+      "file": "ja/parts/donut-chart.md",
+      "order": 9
     },
     {
       "slug": "parts/echart",
@@ -562,7 +722,7 @@
       "title": "EChart",
       "description": "Apache ECharts の薄いラッパー。配色はテーマトークンに追従する。",
       "file": "ja/parts/echart.md",
-      "order": 4
+      "order": 10
     },
     {
       "slug": "parts/filter-bar",
@@ -572,7 +732,17 @@
       "title": "FilterBar",
       "description": "フィルタ一式を 1 つの値オブジェクトで扱う行。",
       "file": "ja/parts/filter-bar.md",
-      "order": 5
+      "order": 11
+    },
+    {
+      "slug": "parts/format",
+      "lang": "ja",
+      "section": "components/parts",
+      "sectionTitle": "@squadbase/vantage/components",
+      "title": "format / comparison",
+      "description": "KPI・表・グラフで共有する数値の書式（formatValue）と、増減の計算（computeComparison）。",
+      "file": "ja/parts/format.md",
+      "order": 12
     },
     {
       "slug": "parts/funnel-steps",
@@ -582,7 +752,27 @@
       "title": "FunnelSteps",
       "description": "ファネルの各段を棒で示す。転換率も出せる。",
       "file": "ja/parts/funnel-steps.md",
-      "order": 6
+      "order": 13
+    },
+    {
+      "slug": "parts/kpi-card",
+      "lang": "ja",
+      "section": "components/parts",
+      "sectionTitle": "@squadbase/vantage/components",
+      "title": "KpiCard",
+      "description": "KPI 1 つ分のカード。値・増減・前期実績・結論の 1 文までを数値から組み立てる。",
+      "file": "ja/parts/kpi-card.md",
+      "order": 14
+    },
+    {
+      "slug": "parts/line-chart",
+      "lang": "ja",
+      "section": "components/parts",
+      "sectionTitle": "@squadbase/vantage/components",
+      "title": "LineChart",
+      "description": "推移を線で見せる型付きグラフ。行・x 軸の列・系列の列を渡すだけ。",
+      "file": "ja/parts/line-chart.md",
+      "order": 15
     },
     {
       "slug": "parts/metric-value",
@@ -592,7 +782,7 @@
       "title": "MetricValue",
       "description": "KPI の数値。単位は MetricUnit で。",
       "file": "ja/parts/metric-value.md",
-      "order": 7
+      "order": 16
     },
     {
       "slug": "parts/multi-select",
@@ -602,7 +792,7 @@
       "title": "MultiSelect",
       "description": "検索できる複数選択。選択はチップで表示。",
       "file": "ja/parts/multi-select.md",
-      "order": 8
+      "order": 17
     },
     {
       "slug": "parts/page-shell",
@@ -612,7 +802,7 @@
       "title": "PageShell",
       "description": "ヘッダー帯・サマリー・本文からなるページ枠。",
       "file": "ja/parts/page-shell.md",
-      "order": 9
+      "order": 18
     },
     {
       "slug": "parts/placeholder",
@@ -622,7 +812,17 @@
       "title": "Placeholder",
       "description": "仮データであることを示す、インラインの目印。",
       "file": "ja/parts/placeholder.md",
-      "order": 10
+      "order": 19
+    },
+    {
+      "slug": "parts/progress-circle",
+      "lang": "ja",
+      "section": "components/parts",
+      "sectionTitle": "@squadbase/vantage/components",
+      "title": "ProgressCircle",
+      "description": "目標に対する達成率をリングで示す。中央に任意の内容を置ける。",
+      "file": "ja/parts/progress-circle.md",
+      "order": 20
     },
     {
       "slug": "parts/searchable-select",
@@ -632,7 +832,7 @@
       "title": "SearchableSelect",
       "description": "検索できる単一選択。候補が多いときに。",
       "file": "ja/parts/searchable-select.md",
-      "order": 11
+      "order": 21
     },
     {
       "slug": "parts/section-header",
@@ -642,7 +842,7 @@
       "title": "SectionHeader",
       "description": "セクションの見出しとアクション。",
       "file": "ja/parts/section-header.md",
-      "order": 12
+      "order": 22
     },
     {
       "slug": "parts/segmented-control",
@@ -652,7 +852,7 @@
       "title": "SegmentedControl",
       "description": "単一選択のセグメント。ToggleGroup の配列を隠す。",
       "file": "ja/parts/segmented-control.md",
-      "order": 13
+      "order": 23
     },
     {
       "slug": "parts/sparkline",
@@ -662,7 +862,7 @@
       "title": "Sparkline",
       "description": "表のセルや KPI タイルに置く、インラインの推移グラフ。",
       "file": "ja/parts/sparkline.md",
-      "order": 14
+      "order": 24
     },
     {
       "slug": "parts/status-badge",
@@ -672,7 +872,17 @@
       "title": "StatusBadge",
       "description": "ドット付きのステータスバッジ。色は名前で決まる。",
       "file": "ja/parts/status-badge.md",
-      "order": 15
+      "order": 25
+    },
+    {
+      "slug": "parts/tracker",
+      "lang": "ja",
+      "section": "components/parts",
+      "sectionTitle": "@squadbase/vantage/components",
+      "title": "Tracker",
+      "description": "期間ごとの状態を小さなブロックの列で示す。稼働状況やバッチの結果に。",
+      "file": "ja/parts/tracker.md",
+      "order": 26
     },
     {
       "slug": "parts/trend-indicator",
@@ -680,9 +890,9 @@
       "section": "components/parts",
       "sectionTitle": "@squadbase/vantage/components",
       "title": "TrendIndicator",
-      "description": "増減の矢印と変化率。良し悪しは positiveIsGood で決まる。",
+      "description": "非推奨。新規は Delta を使う。増減の矢印と変化率。",
       "file": "ja/parts/trend-indicator.md",
-      "order": 16
+      "order": 27
     },
     {
       "slug": "markdown/markdown-renderer",
@@ -694,6 +904,56 @@
       "file": "ja/markdown/markdown-renderer.md",
       "order": 0
     },
+    {
+      "slug": "page-types",
+      "lang": "ja",
+      "section": "page-types",
+      "sectionTitle": "ページの種類",
+      "title": "ページの種類",
+      "description": "通常ページ・スライド・ドキュメント・CSV・Excel の 5 種類。それぞれの置き方とできること、ページにならないファイル。",
+      "file": "ja/page-types.md",
+      "order": -1
+    },
+    {
+      "slug": "page-types/slide",
+      "lang": "ja",
+      "section": "page-types",
+      "sectionTitle": "ページの種類",
+      "title": "スライド",
+      "description": "<name>.slide.tsx を置くとスライドデッキのページになる。1920×1080 のキャンバス、段階表示、トランジション、pptx 書き出し。",
+      "file": "ja/page-types/slide.md",
+      "order": 0
+    },
+    {
+      "slug": "page-types/doc",
+      "lang": "ja",
+      "section": "page-types",
+      "sectionTitle": "ページの種類",
+      "title": "ドキュメント",
+      "description": "<name>.doc.tsx を置くと上から読む文章のページになる。クラス無しで組版され、「PDF として保存」で印刷できる。",
+      "file": "ja/page-types/doc.md",
+      "order": 1
+    },
+    {
+      "slug": "page-types/csv",
+      "lang": "ja",
+      "section": "page-types",
+      "sectionTitle": "ページの種類",
+      "title": "CSV",
+      "description": ".csv を置くだけで表として読めるページになる。列の型の推定、ファイル名からのタイトル、25MB / 20 万行の上限。",
+      "file": "ja/page-types/csv.md",
+      "order": 2
+    },
+    {
+      "slug": "page-types/excel",
+      "lang": "ja",
+      "section": "page-types",
+      "sectionTitle": "ページの種類",
+      "title": "Excel",
+      "description": ".xlsx を置くだけで表として読めるページになる。シートの切り替えと元ファイルのダウンロード付き。",
+      "file": "ja/page-types/excel.md",
+      "order": 3
+    },
     {
       "slug": "index",
       "lang": "en",
@@ -1246,6 +1506,16 @@
       "file": "en/parts/date-range-picker.md",
       "order": 3
     },
+    {
+      "slug": "parts/delta",
+      "lang": "en",
+      "section": "components/parts",
+      "sectionTitle": "@squadbase/vantage/components",
+      "title": "Delta",
+      "description": "The change against a comparison — arrow, signed rate and label, all derived from the values.",
+      "file": "en/parts/delta.md",
+      "order": 4
+    },
     {
       "slug": "parts/echart",
       "lang": "en",
@@ -1254,7 +1524,7 @@
       "title": "EChart",
       "description": "A thin Apache ECharts wrapper whose colours follow the theme tokens.",
       "file": "en/parts/echart.md",
-      "order": 4
+      "order": 5
     },
     {
       "slug": "parts/filter-bar",
@@ -1264,7 +1534,17 @@
       "title": "FilterBar",
       "description": "A row of filters driven by one value object.",
       "file": "en/parts/filter-bar.md",
-      "order": 5
+      "order": 6
+    },
+    {
+      "slug": "parts/format",
+      "lang": "en",
+      "section": "components/parts",
+      "sectionTitle": "@squadbase/vantage/components",
+      "title": "format / comparison",
+      "description": "The number formatting (formatValue) and change calculation (computeComparison) shared by KPIs, tables and charts.",
+      "file": "en/parts/format.md",
+      "order": 7
     },
     {
       "slug": "parts/funnel-steps",
@@ -1274,7 +1554,17 @@
       "title": "FunnelSteps",
       "description": "A funnel drawn as bars, with conversion rates.",
       "file": "en/parts/funnel-steps.md",
-      "order": 6
+      "order": 8
+    },
+    {
+      "slug": "parts/kpi-card",
+      "lang": "en",
+      "section": "components/parts",
+      "sectionTitle": "@squadbase/vantage/components",
+      "title": "KpiCard",
+      "description": "One KPI as a card — value, change, previous actual and a one-line conclusion, all derived from numbers.",
+      "file": "en/parts/kpi-card.md",
+      "order": 9
     },
     {
       "slug": "parts/metric-value",
@@ -1284,7 +1574,7 @@
       "title": "MetricValue",
       "description": "The KPI number, with MetricUnit for the unit.",
       "file": "en/parts/metric-value.md",
-      "order": 7
+      "order": 10
     },
     {
       "slug": "parts/multi-select",
@@ -1294,7 +1584,7 @@
       "title": "MultiSelect",
       "description": "Multiple choice with search; selections show as chips.",
       "file": "en/parts/multi-select.md",
-      "order": 8
+      "order": 11
     },
     {
       "slug": "parts/page-shell",
@@ -1304,7 +1594,7 @@
       "title": "PageShell",
       "description": "The page frame: header band, summary row, content.",
       "file": "en/parts/page-shell.md",
-      "order": 9
+      "order": 12
     },
     {
       "slug": "parts/placeholder",
@@ -1314,7 +1604,7 @@
       "title": "Placeholder",
       "description": "An inline marker for sample, not-yet-real data.",
       "file": "en/parts/placeholder.md",
-      "order": 10
+      "order": 13
     },
     {
       "slug": "parts/searchable-select",
@@ -1324,7 +1614,7 @@
       "title": "SearchableSelect",
       "description": "Single choice with search, for long option lists.",
       "file": "en/parts/searchable-select.md",
-      "order": 11
+      "order": 14
     },
     {
       "slug": "parts/section-header",
@@ -1334,7 +1624,7 @@
       "title": "SectionHeader",
       "description": "A section heading with its actions.",
       "file": "en/parts/section-header.md",
-      "order": 12
+      "order": 15
     },
     {
       "slug": "parts/segmented-control",
@@ -1344,7 +1634,7 @@
       "title": "SegmentedControl",
       "description": "Single-choice segments — it hides ToggleGroup's array.",
       "file": "en/parts/segmented-control.md",
-      "order": 13
+      "order": 16
     },
     {
       "slug": "parts/sparkline",
@@ -1354,7 +1644,7 @@
       "title": "Sparkline",
       "description": "An inline trend chart for table cells and KPI tiles.",
       "file": "en/parts/sparkline.md",
-      "order": 14
+      "order": 17
     },
     {
       "slug": "parts/status-badge",
@@ -1364,7 +1654,7 @@
       "title": "StatusBadge",
       "description": "A dot-and-label status badge, coloured by name.",
       "file": "en/parts/status-badge.md",
-      "order": 15
+      "order": 18
     },
     {
       "slug": "parts/trend-indicator",
@@ -1372,9 +1662,9 @@
       "section": "components/parts",
       "sectionTitle": "@squadbase/vantage/components",
       "title": "TrendIndicator",
-      "description": "An arrow and a percentage; positiveIsGood decides the colour.",
+      "description": "Deprecated — use Delta for new code. An arrow and a percentage.",
       "file": "en/parts/trend-indicator.md",
-      "order": 16
+      "order": 19
     },
     {
       "slug": "markdown/markdown-renderer",