@squadbase/vantage 0.6.2-dev1.0017a4d → 0.6.2-dev1.02aab78

package/docs/index.json

@@ -1035,13 +1035,13 @@
       "order": 1
     },
     {
-      "slug": "slide/slide-exec-summary",
+      "slug": "slide/slide-section",
       "lang": "ja",
       "section": "components/slide",
       "sectionTitle": "@squadbase/vantage/slide",
-      "title": "SlideExecSummary",
-      "description": "結論を先に伝える 1 枚。アクションタイトルと 3〜5 個の要点。",
-      "file": "ja/slide/slide-exec-summary.md",
+      "title": "SlideSection",
+      "description": "章の区切りの 1 枚。章タイトルと、任意で目次。",
+      "file": "ja/slide/slide-section.md",
       "order": 1
     },
     {
@@ -1065,13 +1065,13 @@
       "order": 2
     },
     {
-      "slug": "slide/slide-kpi-hero",
+      "slug": "slide/slide-exec-summary",
       "lang": "ja",
       "section": "components/slide",
       "sectionTitle": "@squadbase/vantage/slide",
-      "title": "SlideKpiHero",
-      "description": "1 つの数字を主役にする 1 枚。値・増減・推移の線。",
-      "file": "ja/slide/slide-kpi-hero.md",
+      "title": "SlideExecSummary",
+      "description": "結論を先に伝える 1 枚。アクションタイトルと 3〜5 個の要点。",
+      "file": "ja/slide/slide-exec-summary.md",
       "order": 2
     },
     {
@@ -1095,13 +1095,13 @@
       "order": 3
     },
     {
-      "slug": "slide/slide-kpi-grid",
+      "slug": "slide/slide-kpi-hero",
       "lang": "ja",
       "section": "components/slide",
       "sectionTitle": "@squadbase/vantage/slide",
-      "title": "SlideKpiGrid",
-      "description": "2〜4 個の KPI を並べるスコアボード。値・増減・目標。",
-      "file": "ja/slide/slide-kpi-grid.md",
+      "title": "SlideKpiHero",
+      "description": "1 つの数字を主役にする 1 枚。値・増減・推移の線。",
+      "file": "ja/slide/slide-kpi-hero.md",
       "order": 3
     },
     {
@@ -1115,13 +1115,13 @@
       "order": 4
     },
     {
-      "slug": "slide/slide-chart-insight",
+      "slug": "slide/slide-kpi-grid",
       "lang": "ja",
       "section": "components/slide",
       "sectionTitle": "@squadbase/vantage/slide",
-      "title": "SlideChartInsight",
-      "description": "グラフ 1 つと、その読み解き。レポートでいちばん多い 1 枚。",
-      "file": "ja/slide/slide-chart-insight.md",
+      "title": "SlideKpiGrid",
+      "description": "2〜4 個の KPI を並べるスコアボード。値・増減・目標。",
+      "file": "ja/slide/slide-kpi-grid.md",
       "order": 4
     },
     {
@@ -1135,13 +1135,13 @@
       "order": 5
     },
     {
-      "slug": "slide/slide-scorecard-table",
+      "slug": "slide/slide-comparison",
       "lang": "ja",
       "section": "components/slide",
       "sectionTitle": "@squadbase/vantage/slide",
-      "title": "SlideScorecardTable",
-      "description": "指標ごとの目標と実績、状態を並べるスコアカード表。",
-      "file": "ja/slide/slide-scorecard-table.md",
+      "title": "SlideComparison",
+      "description": "A と B、施策の前と後を 2〜3 列で並べる 1 枚。",
+      "file": "ja/slide/slide-comparison.md",
       "order": 5
     },
     {
@@ -1155,13 +1155,13 @@
       "order": 6
     },
     {
-      "slug": "slide/slide-next-actions",
+      "slug": "slide/slide-chart-insight",
       "lang": "ja",
       "section": "components/slide",
       "sectionTitle": "@squadbase/vantage/slide",
-      "title": "SlideNextActions",
-      "description": "次の打ち手。担当・期限・確認する指標つきで 3〜5 件。",
-      "file": "ja/slide/slide-next-actions.md",
+      "title": "SlideChartInsight",
+      "description": "グラフ 1 つと、その読み解き。レポートでいちばん多い 1 枚。",
+      "file": "ja/slide/slide-chart-insight.md",
       "order": 6
     },
     {
@@ -1174,6 +1174,86 @@
       "file": "ja/doc/doc-action-items.md",
       "order": 7
     },
+    {
+      "slug": "slide/slide-chart-full",
+      "lang": "ja",
+      "section": "components/slide",
+      "sectionTitle": "@squadbase/vantage/slide",
+      "title": "SlideChartFull",
+      "description": "グラフ 1 つを 12 カラム全幅で見せる 1 枚。下に 1 行の注記。",
+      "file": "ja/slide/slide-chart-full.md",
+      "order": 7
+    },
+    {
+      "slug": "doc/doc-notes-and-sources",
+      "lang": "ja",
+      "section": "components/doc",
+      "sectionTitle": "@squadbase/vantage/doc",
+      "title": "DocNotesAndSources",
+      "description": "ドキュメント末尾の注記・用語の定義・出典。",
+      "file": "ja/doc/doc-notes-and-sources.md",
+      "order": 8
+    },
+    {
+      "slug": "slide/slide-scorecard-table",
+      "lang": "ja",
+      "section": "components/slide",
+      "sectionTitle": "@squadbase/vantage/slide",
+      "title": "SlideScorecardTable",
+      "description": "指標ごとの目標と実績、状態を並べるスコアカード表。",
+      "file": "ja/slide/slide-scorecard-table.md",
+      "order": 8
+    },
+    {
+      "slug": "doc/delta-text",
+      "lang": "ja",
+      "section": "components/doc",
+      "sectionTitle": "@squadbase/vantage/doc",
+      "title": "DeltaText",
+      "description": "[部品] 文中に置く増減。▲ ▼ と符号つきの値。ドキュメントでもスライドでも。",
+      "file": "ja/doc/delta-text.md",
+      "order": 9
+    },
+    {
+      "slug": "slide/slide-next-actions",
+      "lang": "ja",
+      "section": "components/slide",
+      "sectionTitle": "@squadbase/vantage/slide",
+      "title": "SlideNextActions",
+      "description": "次の打ち手。担当・期限・確認する指標つきで 3〜5 件。",
+      "file": "ja/slide/slide-next-actions.md",
+      "order": 9
+    },
+    {
+      "slug": "slide/slide-heading",
+      "lang": "ja",
+      "section": "components/slide",
+      "sectionTitle": "@squadbase/vantage/slide",
+      "title": "SlideHeading",
+      "description": "[部品] スライド 1 枚の見出し。アクションタイトルと任意のアイブロウ。",
+      "file": "ja/slide/slide-heading.md",
+      "order": 10
+    },
+    {
+      "slug": "slide/slide-source-line",
+      "lang": "ja",
+      "section": "components/slide",
+      "sectionTitle": "@squadbase/vantage/slide",
+      "title": "SlideSourceLine",
+      "description": "[部品] スライド 1 枚の足元の 1 行。時点・出典・ページ番号。",
+      "file": "ja/slide/slide-source-line.md",
+      "order": 11
+    },
+    {
+      "slug": "slide/slide-columns",
+      "lang": "ja",
+      "section": "components/slide",
+      "sectionTitle": "@squadbase/vantage/slide",
+      "title": "SlideColumns",
+      "description": "[部品] スライド本文の 12 カラム配置。SlideColumns と SlideColumn。",
+      "file": "ja/slide/slide-columns.md",
+      "order": 12
+    },
     {
       "slug": "index",
       "lang": "en",
@@ -2177,13 +2257,13 @@
       "order": 1
     },
     {
-      "slug": "slide/slide-exec-summary",
+      "slug": "slide/slide-section",
       "lang": "en",
       "section": "components/slide",
       "sectionTitle": "@squadbase/vantage/slide",
-      "title": "SlideExecSummary",
-      "description": "The conclusion-first slide — an action title and 3–5 points.",
-      "file": "en/slide/slide-exec-summary.md",
+      "title": "SlideSection",
+      "description": "A chapter divider — the chapter title, optionally with an agenda.",
+      "file": "en/slide/slide-section.md",
       "order": 1
     },
     {
@@ -2197,13 +2277,13 @@
       "order": 2
     },
     {
-      "slug": "slide/slide-kpi-hero",
+      "slug": "slide/slide-exec-summary",
       "lang": "en",
       "section": "components/slide",
       "sectionTitle": "@squadbase/vantage/slide",
-      "title": "SlideKpiHero",
-      "description": "One number as the hero — value, change and a trend line.",
-      "file": "en/slide/slide-kpi-hero.md",
+      "title": "SlideExecSummary",
+      "description": "The conclusion-first slide — an action title and 3–5 points.",
+      "file": "en/slide/slide-exec-summary.md",
       "order": 2
     },
     {
@@ -2217,13 +2297,13 @@
       "order": 3
     },
     {
-      "slug": "slide/slide-kpi-grid",
+      "slug": "slide/slide-kpi-hero",
       "lang": "en",
       "section": "components/slide",
       "sectionTitle": "@squadbase/vantage/slide",
-      "title": "SlideKpiGrid",
-      "description": "A scoreboard of 2–4 KPIs — value, change and target.",
-      "file": "en/slide/slide-kpi-grid.md",
+      "title": "SlideKpiHero",
+      "description": "One number as the hero — value, change and a trend line.",
+      "file": "en/slide/slide-kpi-hero.md",
       "order": 3
     },
     {
@@ -2237,13 +2317,13 @@
       "order": 4
     },
     {
-      "slug": "slide/slide-chart-insight",
+      "slug": "slide/slide-kpi-grid",
       "lang": "en",
       "section": "components/slide",
       "sectionTitle": "@squadbase/vantage/slide",
-      "title": "SlideChartInsight",
-      "description": "One chart and its reading — the most common slide in a report.",
-      "file": "en/slide/slide-chart-insight.md",
+      "title": "SlideKpiGrid",
+      "description": "A scoreboard of 2–4 KPIs — value, change and target.",
+      "file": "en/slide/slide-kpi-grid.md",
       "order": 4
     },
     {
@@ -2257,13 +2337,13 @@
       "order": 5
     },
     {
-      "slug": "slide/slide-scorecard-table",
+      "slug": "slide/slide-comparison",
       "lang": "en",
       "section": "components/slide",
       "sectionTitle": "@squadbase/vantage/slide",
-      "title": "SlideScorecardTable",
-      "description": "A scorecard table — target vs actual per metric, with a status.",
-      "file": "en/slide/slide-scorecard-table.md",
+      "title": "SlideComparison",
+      "description": "A vs B, or before and after — 2 to 3 columns side by side.",
+      "file": "en/slide/slide-comparison.md",
       "order": 5
     },
     {
@@ -2277,13 +2357,13 @@
       "order": 6
     },
     {
-      "slug": "slide/slide-next-actions",
+      "slug": "slide/slide-chart-insight",
       "lang": "en",
       "section": "components/slide",
       "sectionTitle": "@squadbase/vantage/slide",
-      "title": "SlideNextActions",
-      "description": "What happens next — 3–5 actions with owner, due date and the metric to check.",
-      "file": "en/slide/slide-next-actions.md",
+      "title": "SlideChartInsight",
+      "description": "One chart and its reading — the most common slide in a report.",
+      "file": "en/slide/slide-chart-insight.md",
       "order": 6
     },
     {
@@ -2295,6 +2375,86 @@
       "description": "What to do next — action, owner, due date, expected effect and priority.",
       "file": "en/doc/doc-action-items.md",
       "order": 7
+    },
+    {
+      "slug": "slide/slide-chart-full",
+      "lang": "en",
+      "section": "components/slide",
+      "sectionTitle": "@squadbase/vantage/slide",
+      "title": "SlideChartFull",
+      "description": "One chart across all 12 columns, with a one-line note under it.",
+      "file": "en/slide/slide-chart-full.md",
+      "order": 7
+    },
+    {
+      "slug": "doc/doc-notes-and-sources",
+      "lang": "en",
+      "section": "components/doc",
+      "sectionTitle": "@squadbase/vantage/doc",
+      "title": "DocNotesAndSources",
+      "description": "The end matter of a document — notes, definitions of terms and data sources.",
+      "file": "en/doc/doc-notes-and-sources.md",
+      "order": 8
+    },
+    {
+      "slug": "slide/slide-scorecard-table",
+      "lang": "en",
+      "section": "components/slide",
+      "sectionTitle": "@squadbase/vantage/slide",
+      "title": "SlideScorecardTable",
+      "description": "A scorecard table — target vs actual per metric, with a status.",
+      "file": "en/slide/slide-scorecard-table.md",
+      "order": 8
+    },
+    {
+      "slug": "doc/delta-text",
+      "lang": "en",
+      "section": "components/doc",
+      "sectionTitle": "@squadbase/vantage/doc",
+      "title": "DeltaText",
+      "description": "[Part] An inline change — ▲ ▼ and a signed value — for documents and slides.",
+      "file": "en/doc/delta-text.md",
+      "order": 9
+    },
+    {
+      "slug": "slide/slide-next-actions",
+      "lang": "en",
+      "section": "components/slide",
+      "sectionTitle": "@squadbase/vantage/slide",
+      "title": "SlideNextActions",
+      "description": "What happens next — 3–5 actions with owner, due date and the metric to check.",
+      "file": "en/slide/slide-next-actions.md",
+      "order": 9
+    },
+    {
+      "slug": "slide/slide-heading",
+      "lang": "en",
+      "section": "components/slide",
+      "sectionTitle": "@squadbase/vantage/slide",
+      "title": "SlideHeading",
+      "description": "[Part] The title of one slide — an action title with an optional eyebrow.",
+      "file": "en/slide/slide-heading.md",
+      "order": 10
+    },
+    {
+      "slug": "slide/slide-source-line",
+      "lang": "en",
+      "section": "components/slide",
+      "sectionTitle": "@squadbase/vantage/slide",
+      "title": "SlideSourceLine",
+      "description": "[Part] The footer line of one slide — as-of date, source and page number.",
+      "file": "en/slide/slide-source-line.md",
+      "order": 11
+    },
+    {
+      "slug": "slide/slide-columns",
+      "lang": "en",
+      "section": "components/slide",
+      "sectionTitle": "@squadbase/vantage/slide",
+      "title": "SlideColumns",
+      "description": "[Part] The 12-column layout of a slide's body — SlideColumns and SlideColumn.",
+      "file": "en/slide/slide-columns.md",
+      "order": 12
     }
   ]
 }

package/docs/ja/changelog.md

@@ -14,6 +14,8 @@ Vantage のリリースごとの変更点です。新しいものが上に来ま
 
 ### 追加
 
+- **アプリの表示言語 `lang`。** ルート `_layout.tsx` の `export const lang = "ja"`（リテラル）が `<html lang>` になります。
+  日本語のスライド・doc が文節の途中で折れなくなり、スライドのツールバーも日本語になります。未指定は従来どおり `"en"` です。
 - **`--host [addr]` と `--allowed-hosts <list|true>`** を `vantage dev` / `vantage preview`(SPA)に
   追加しました。Vite は `Host` ヘッダが `localhost` 以外のリクエストを 403 で拒否するため、
   サンドボックスのプレビュープロキシやトンネルなど**別のホスト名で前に立つもの**があると

package/docs/ja/components.md

@@ -97,8 +97,10 @@ Markdown 描画は Shiki の全言語文法を抱えており、`components` の
 
 [スライド](page-types/slide)と[ドキュメント](page-types/doc)のページに置く block です。`/components` とは別のサブパスで、`vantage add` のコピー対象にもなりません（import して使います）。
 
-- **slide**: 1 枚の `<Slide>` の中身（`<Slide>` 自体は持ちません）。[`SlideCover`](slide/slide-cover) / [`SlideExecSummary`](slide/slide-exec-summary) / [`SlideKpiHero`](slide/slide-kpi-hero) / [`SlideKpiGrid`](slide/slide-kpi-grid) / [`SlideChartInsight`](slide/slide-chart-insight) / [`SlideScorecardTable`](slide/slide-scorecard-table) / [`SlideNextActions`](slide/slide-next-actions)
-- **doc**: `<Document>` の中に並べる節や部品（`DocFigure` / `DocDataTable` / `DocCallout` は節の中に置く部品）。[`DocReportHeader`](doc/doc-report-header) / [`DocExecutiveSummary`](doc/doc-executive-summary) / [`DocKpiScorecard`](doc/doc-kpi-scorecard) / [`DocFigure`](doc/doc-figure) / [`DocDataTable`](doc/doc-data-table) / [`DocCallout`](doc/doc-callout) / [`DocKeyFindings`](doc/doc-key-findings) / [`DocActionItems`](doc/doc-action-items)
+- **slide**: 1 枚の `<Slide>` の中身（`<Slide>` 自体は持ちません）。[`SlideCover`](slide/slide-cover) / [`SlideExecSummary`](slide/slide-exec-summary) / [`SlideKpiHero`](slide/slide-kpi-hero) / [`SlideKpiGrid`](slide/slide-kpi-grid) / [`SlideChartInsight`](slide/slide-chart-insight) / [`SlideScorecardTable`](slide/slide-scorecard-table) / [`SlideNextActions`](slide/slide-next-actions) / [`SlideSection`](slide/slide-section) / [`SlideComparison`](slide/slide-comparison) / [`SlideChartFull`](slide/slide-chart-full)
+- **slide parts**: 1 枚の中で使う部品（1 枚まるごとではありません）。[`SlideHeading`](slide/slide-heading) / [`SlideSourceLine`](slide/slide-source-line) / [`SlideColumns`, `SlideColumn`](slide/slide-columns)
+- **doc**: `<Document>` の中に並べる節や部品（`DocFigure` / `DocDataTable` / `DocCallout` は節の中に置く部品）。[`DocReportHeader`](doc/doc-report-header) / [`DocExecutiveSummary`](doc/doc-executive-summary) / [`DocKpiScorecard`](doc/doc-kpi-scorecard) / [`DocFigure`](doc/doc-figure) / [`DocDataTable`](doc/doc-data-table) / [`DocCallout`](doc/doc-callout) / [`DocKeyFindings`](doc/doc-key-findings) / [`DocActionItems`](doc/doc-action-items) / [`DocNotesAndSources`](doc/doc-notes-and-sources)
+- **doc parts**: 文中に置く部品（slide でも使えます）。[`DeltaText`](doc/delta-text)
 
 ## 組み合わせる
 

package/docs/ja/doc/delta-text.md

@@ -0,0 +1,40 @@
+# DeltaText
+
+> [部品] 文中に置く増減。▲ ▼ と符号つきの値。ドキュメントでもスライドでも。
+
+増減を文中に置くインラインの `span` です。印や符号（「▲ +3.2%」）で向きが分かるので、印刷や色覚の違いでも読めます。色は良い・悪いを足すだけです。文字サイズは指定せず、置いた行に従います。ドキュメントとスライドのどちらでも使える**部品**で、1 節や 1 枚の block ではありません。
+
+```tsx
+import { DeltaText } from "@squadbase/vantage/doc";
+import type { DeltaTextProps } from "@squadbase/vantage/doc";
+// スライドでも同じものを使える
+// import { DeltaText } from "@squadbase/vantage/slide";
+```
+
+> [!NOTE]
+> これは **文中に置く部品**です。自分では寸法も文字サイズも持たず、置いた行の大きさに従います。ダッシュボード用の `Delta` とは別物です。
+
+## props
+
+| Prop | Type | Default | 説明 |
+| --- | --- | --- | --- |
+| `value` | `number \| null` |  | 増減そのもの。向きは符号で決まる。`null` は「—」。**必須**。 |
+| `format` | `ValueFormat` |  | 値の整形（`"percent"` / `"currency"` など）。符号つきで出る。 |
+| `betterWhen` | `"up" \| "down"` | `"up"` | どちらの向きが良いか。色が決まる。解約率・コストは `"down"`。 |
+| `comparisonLabel` | `string` |  | 比較相手の名前（「前月比」）。増減の前に薄く出る。 |
+
+## 使い方
+
+```tsx
+import { DeltaText } from "@squadbase/vantage/doc";
+
+<p>
+  9 月の売上は 5.4 億円でした（<DeltaText value={0.074} format="percent" comparisonLabel="前月比" />）。
+  解約率は 1.8% です（<DeltaText value={-0.006} format="percent" betterWhen="down" comparisonLabel="前月比" />）。
+</p>
+```
+
+## 注意
+
+- 0 は「→」で薄い色になります。
+- 読み上げ用の語（「増」「減」「横ばい」「改善」「悪化」）は固定の日本語です。

package/docs/ja/doc/doc-notes-and-sources.md

@@ -0,0 +1,43 @@
+# DocNotesAndSources
+
+> ドキュメント末尾の注記・用語の定義・出典。
+
+ドキュメントの最後に置く節です。注記（番号つき）、用語の定義、出典（データ時点つき）をまとめて出します。中身のない部分は描かれず、3 つとも空なら何も出ません。
+
+```tsx
+import { DocNotesAndSources } from "@squadbase/vantage/doc";
+import type { DocNotesAndSourcesProps, DocDefinition, DocSource } from "@squadbase/vantage/doc";
+```
+
+> [!NOTE]
+> これは **`<Document>` 直下に置く 1 セクション**です。見出し・本文の大きさや幅は `<Document>` が決めるので、ここでは寸法を指定しません。Markdown 文字列は解釈されません。ページ全体の組み方は [ドキュメント](page-types/doc) を参照してください。
+
+## props
+
+| Prop | Type | Default | 説明 |
+| --- | --- | --- | --- |
+| `title` | `string` | `"注記・出典"` | 節の見出し。 |
+| `headingLevel` | `2 \| 3` | `2` | 見出しの階層。`<Document>` 直下なら `2`、別の節の中なら `3`。小見出しは 1 つ下がる。 |
+| `notes` | `ReactNode[]` |  | 注記。番号つきの一覧で出る（速報値・除外条件など）。 |
+| `definitions` | `DocDefinition[]` |  | 用語の定義。`{ term: string; description: ReactNode }`。 |
+| `sources` | `DocSource[]` |  | 出典。`{ name: string; asOf?: string }`。`asOf` は日付のみ（例: `"2026-10-03"`）で、「（データ時点 2026-10-03）」と出る。 |
+
+## 使い方
+
+```tsx
+import { Document, DocNotesAndSources } from "@squadbase/vantage/doc";
+
+<Document>
+  {/* …本文の節… */}
+  <DocNotesAndSources
+    notes={["9 月の数値は速報値です。確定値は 10 月 10 日に更新します。", "返金分は売上から除いています。"]}
+    definitions={[{ term: "解約率", description: "月初契約数に対する、当月に解約した契約数の割合。" }]}
+    sources={[{ name: "契約管理 DB", asOf: "2026-10-03" }, { name: "会計システム" }]}
+  />
+</Document>
+```
+
+## 注意
+
+- 小見出し「注記」「用語の定義」「出典」と「（データ時点 …）」は固定の日本語です。
+- 各部分は印刷時に途中で改ページされないようにまとまります。

package/docs/ja/page-types/slide.md

@@ -45,6 +45,7 @@ export default function Deck() {
 - **3 つの見え方。** 左にスライド一覧（`L` で開閉）、スライドのみ、全画面（`F`）。一覧の開閉と
   今のページは URL（`?rail=` / `?p=`）に入るので、そのまま共有できます。`Esc` でデッキを抜けます。
 - **PowerPoint に書き出す。** ツールバーのボタンで、全スライドを `.pptx` として保存します。
+- **日本語の改行。** ルート `_layout.tsx` に `export const lang = "ja"` を書くと、見出しが文節の途中で折れず、ツールバーも日本語になります（[アプリの表示言語](pages-and-metadata)）。
 - **テーマに追従。** 配色と書体は `--slide-*` トークンで、既定はアプリのトークンを指すので
   ダークモードにも追従します。デッキごとに `theme` で上書きできます。
 

package/docs/ja/pages-and-metadata.md

@@ -60,6 +60,21 @@ export default function MonthlyAnalysis() {
 **ファイルをリネーム**するか、`_` を前置してルート化を止め、tsx から `FilePageView` で描いて
 そこに `definePage` を書きます。
 
+## アプリの表示言語
+
+ルートの `_layout.tsx` で `lang` をリテラルでエクスポートすると、`<html lang>` に入ります。
+
+```tsx
+// src/_layout.tsx
+export const lang = "ja"
+```
+
+- 値は BCP 47 の言語タグ（`"ja"` / `"en"` / `"ja-JP"` など）。変数やテンプレート補間は読まれません。
+- 読まれるのはルートの `_layout.tsx` だけです。入れ子のレイアウトやページに書いても無視されます。
+- 未指定、または形式が不正な値は `"en"` になります（診断で警告します）。何も書かないアプリの出力は従来どおりです。
+- `ja` を指定すると、スライドと doc ページの日本語が文節の途中で折れなくなり（`word-break: auto-phrase`）、スライドのツールバーの文言も日本語になります。
+- dev では `lang` を書き換えると自動で再読み込みされます。
+
 ## Fast Refresh との関係
 
 `page` のような非コンポーネントのエクスポートがあっても、Vantage はそれを内部で扱うため

package/docs/ja/parts/delta.md

@@ -4,8 +4,8 @@
 
 値の変化を「↑ +12.4% 前期比」の 1 行で示します。**向き・率・色・文言はすべて `value` と `comparison`
 から計算**され、外から渡すことはできません — そのため矢印と色が食い違うことがありません。色だけに
-頼らず、矢印と符号が必ず付きます。解約率のように上がると悪い指標は `polarity="lower-is-better"` を
-渡してください。
+頼らず、矢印と符号が必ず付きます。解約率のように上がると悪い指標は `betterWhen="down"` を
+渡してください（古い名前の `polarity` も使えます）。
 
 非推奨の [`TrendIndicator`](parts/trend-indicator) の置き換えです。
 
@@ -18,7 +18,8 @@ import type { DeltaProps, Comparison, Polarity } from "@squadbase/vantage/compon
 | --- | --- | --- | --- |
 | `value` | `number \| null \| undefined` |  | 現在の値。**必須**。前の値は `comparison` から取る。 |
 | `comparison` | `Comparison` |  | 比較の相手。**必須**（増減に必ずラベルが付くように）。下の表を参照。 |
-| `polarity` | `"higher-is-better" \| "lower-is-better"` | `"higher-is-better"` | 上がることが良いか。 |
+| `betterWhen` | `"up" \| "down"` | `"up"` | どちらに動くと良いか。解約率のように下がる方が良い指標は `"down"`。`polarity` より優先される。 |
+| `polarity` | `"higher-is-better" \| "lower-is-better" \| "neutral"` | `"higher-is-better"` | 非推奨。`betterWhen` の古い名前。`"neutral"`（良し悪しの色をつけない）はこちらからだけ渡せる。 |
 | `neutralBand` | `number` | `0.01` | 変化率の絶対値がこれ未満なら横ばい（–）として扱う。既定は 1%。 |
 | `variant` | `"badge" \| "inline"` | `"badge"` | 枠付きのバッジか、文中に置く素の文字か。 |
 | `locale` | `string` | `"ja-JP"` | 率の書式のロケール。 |
@@ -43,7 +44,7 @@ import type { DeltaProps, Comparison, Polarity } from "@squadbase/vantage/compon
 <Delta value={1_240_000} comparison={{ previous: 1_103_000, vs: "prior-period" }} />
 
 // 下がる方が良い指標
-<Delta value={0.021} comparison={{ previous: 0.026, vs: "prior-period" }} polarity="lower-is-better" />
+<Delta value={0.021} comparison={{ previous: 0.026, vs: "prior-period" }} betterWhen="down" />
 ```
 
 色は `--positive` / `--negative` / `--neutral` のトークンで決まります。KPI を 1 枚のカードで見せる

package/docs/ja/parts/kpi-card.md

@@ -19,7 +19,8 @@ import type { KpiCardProps, KpiCardSource, Comparison, Polarity, ValueFormat } f
 | `format` | `ValueFormat` | `"compact"` | 値の書式（→ format / comparison のページ）。前期実績・目標・残りにも同じ書式を使う。 |
 | `locale` | `string` | `"ja-JP"` | 書式のロケール。 |
 | `comparison` | `Comparison` |  | 比較の相手（`{ previous, vs, label? }`）。渡すと増減と前期実績の行が出る。 |
-| `polarity` | `"higher-is-better" \| "lower-is-better"` | `"higher-is-better"` | 上がることが良いか。解約率のように下がる方が良い指標は `"lower-is-better"`。 |
+| `betterWhen` | `"up" \| "down"` | `"up"` | どちらに動くと良いか。解約率のように下がる方が良い指標は `"down"`。`polarity` より優先される。 |
+| `polarity` | `"higher-is-better" \| "lower-is-better" \| "neutral"` | `"higher-is-better"` | 非推奨。`betterWhen` の古い名前。`"neutral"`（良し悪しの色をつけない）はこちらからだけ渡せる。 |
 | `neutralBand` | `number` | `0.01` | 変化率の絶対値がこれ未満なら横ばいとして扱う。 |
 | `showPrevious` | `boolean` | `true` | 前期の実績（「前期 400」）を出すか。`comparison` が要る。 |
 | `summary` | `string` |  | 結論の 1 文の**テンプレート**。下のプレースホルダをカードが埋める。 |

package/docs/ja/slide/slide-chart-full.md

@@ -0,0 +1,48 @@
+# SlideChartFull
+
+> グラフ 1 つを 12 カラム全幅で見せる 1 枚。下に 1 行の注記。
+
+横幅が要るグラフ（カテゴリが多い・系列が長い）を全幅で見せる 1 枚です。グラフの下に、読み方や注目点を 1 行（`note`）で添えられます。
+
+```tsx
+import { SlideChartFull } from "@squadbase/vantage/slide";
+import type { SlideChartFullProps } from "@squadbase/vantage/slide";
+```
+
+> [!NOTE]
+> これは **`<Slide>` 1 枚の中身**です。`<Slide>` 自体は持たないので、`<Slide>` の直下に置いてください。ルートはキャンバス（1920×1080）いっぱい（100%）に広がり、`className` は受けません。余白・文字サイズ・グリッドは block の中で決まっている（1920×1080 の 12 カラム）ので、寸法を足さないでください。デッキの組み方は [スライド](page-types/slide) を参照してください。
+
+## props
+
+| Prop | Type | 説明 |
+| --- | --- | --- |
+| `title` | `string` | 結論を 1 文で書いた見出し（アクションタイトル）。**必須**。 |
+| `chart` | `SlideChartInsightChart` | `{ type: "line" \| "bar" \| "area"; categories: string[]; series: { name: string; data: number[] }[] }`。**必須**。`SlideChartInsight` と同じ形・同じ描画。系列が 2 つ以上なら凡例が出る。 |
+| `note` | `string` | グラフの下の 1 行。読み方や注目点。60 文字ほどまで。 |
+| `asOf` | `string` | 数字を取った日。日付のみ（例: `"2026-10-01"`）。「2026-10-01 時点」と表示される。「時点」は書かない。 |
+| `source` | `string` | 出典（例: `"社内 BI"`）。「出典: 社内 BI」と表示される。 |
+
+## 使い方
+
+```tsx
+import { Slide, SlideChartFull } from "@squadbase/vantage/slide";
+
+<Slide>
+  <SlideChartFull
+    title="売上は 9 月に過去最高を更新した"
+    chart={{
+      type: "line",
+      categories: ["4 月", "5 月", "6 月", "7 月", "8 月", "9 月"],
+      series: [{ name: "売上(百万円)", data: [460, 480, 490, 500, 503, 540] }],
+    }}
+    note="9 月は大型案件 2 件の計上を含む"
+    asOf="2026-10-01"
+    source="社内 BI"
+  />
+</Slide>
+```
+
+## 注意
+
+- グラフは `EChart` でアニメーションなし・ツールチップなし。pptx への書き出しはその描画（`data-waitfor="canvas"`）を待ちます。
+- 読み解きの文を並べたいときは `SlideChartInsight` を使います。