@squadbase/vantage-template 0.1.1-dev1.a9ae1fa → 0.1.1-dev1.a9fd8f6

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 (17) hide show
  1. package/README.md +1 -1
  2. package/base-template/.squadbase/skills/vantage-add-feature/SKILL.md +5 -0
  3. package/base-template/.squadbase/skills/vantage-design/SKILL.md +25 -27
  4. package/base-template/.squadbase/skills/vantage-design/references/extract.md +10 -13
  5. package/base-template/.squadbase/skills/vantage-design/references/format.md +12 -173
  6. package/base-template/.squadbase/skills/vantage-design/references/presets.md +0 -10
  7. package/base-template/AGENTS.md +29 -15
  8. package/base-template/agents/api.md +7 -0
  9. package/base-template/agents/page.md +37 -1
  10. package/base-template/agents/slide.md +7 -1
  11. package/base-template/bun.lock +25 -25
  12. package/base-template/package.json +2 -2
  13. package/base-template/src/components/user-card.tsx +1 -1
  14. package/base-template/src/index.tsx +1 -1
  15. package/dist/index.js +14 -14
  16. package/package.json +2 -2
  17. package/base-template/DESIGN.md +0 -109
package/README.md CHANGED
@@ -14,7 +14,7 @@ npx @squadbase/vantage-template <command> [options]
14
14
 
15
15
  #### `init`
16
16
 
17
- Initialize a new Vantage project in the current directory. Copies the base template — `src/index.tsx`, `src/_layout.tsx`, `src/_404.tsx`, `src/_error.tsx`, `src/styles.css`, `server/api/`, `tsconfig.json`, `squadbase.yml`, a starter `DESIGN.md` (the design intent, by token name — user-owned; the `vantage-design` skill keeps it in step with `src/styles.css`), plus the agent guidance in `AGENTS.md` (and `agents/`, when the framework ships per-type knowledge files) and `.squadbase/skills/` — and installs dependencies.
17
+ Initialize a new Vantage project in the current directory. Copies the base template — `src/index.tsx`, `src/_layout.tsx`, `src/_404.tsx`, `src/_error.tsx`, `src/styles.css`, `server/api/`, `tsconfig.json`, `squadbase.yml`, plus the agent guidance in `AGENTS.md` (and `agents/`, when the framework ships per-type knowledge files) and `.squadbase/skills/` — and installs dependencies.
18
18
 
19
19
  ```bash
20
20
  npx @squadbase/vantage-template init
package/base-template/.squadbase/skills/vantage-add-feature/SKILL.md CHANGED
@@ -112,6 +112,11 @@ if (q.isError) return <ErrorState message={q.error.message} /> // HttpError の
112
112
  const rows = useApiQuery<Row[]>("/api/customers", { search: { segment } })
113
113
  ```
114
114
 
115
+ 絞り込み(期間・セグメント)を持つページでは、この `ErrorState` の早期 return をデータを描く
116
+ 子コンポーネントの中に置く。ページの先頭に置くと、失敗したときに絞り込みの欄ごと消えて条件を
117
+ 直せなくなる。期間は `DateRangePicker` で選ばせる(→ `agents/page.md` の「絞り込みの欄は、
118
+ 読み込み中も失敗したときも出し続ける」)。
119
+
115
120
  書き込みは `useApiMutation(path, { method: "POST" })` — 変数がそのまま JSON ボディになる。
116
121
 
117
122
  ## UI コンポーネント / ブロックを追加する
package/base-template/.squadbase/skills/vantage-design/SKILL.md CHANGED
@@ -1,28 +1,31 @@
1
1
  ---
2
2
  name: vantage-design
3
- description: Vantage(@squadbase/vantage)アプリの見た目の意図 `DESIGN.md` と、実際の値を持つ `styles.css` をまとめて作る / 更新する手順。配色・ブランドカラー・テーマ・チャートの色・フォント・角丸・トーンを変えたいとき、既存サイトやロゴ・資料・外部の DESIGN.md に合わせたいとき、プロジェクト作成時の初期デザイン(テーマ neutral / ocean / forest / sunset / violet / rose / mono)を決めるときに使う。「色を変えて」「ブランドに合わせて」「このサイトに合わせて」「落ち着いた感じに」「フォントを変えて」「テーマを作って」「DESIGN.md を作って」、"change the colors", "match our brand", "match this website", "theme", "color palette", "font", "design system", "DESIGN.md" で起動。
3
+ description: Vantage(@squadbase/vantage)アプリのテーマ(色・チャートの色・書体・角丸)を、`styles.css` とテーマコマンドで作る / 更新する手順。配色・ブランドカラー・テーマ・チャートの色・フォント・角丸・トーンを変えたいとき、既存サイトやロゴ・資料に合わせたいとき、プロジェクト作成時の初期デザイン(テーマ neutral / ocean / forest / sunset / violet / rose / mono)を決めるときに使う。「色を変えて」「ブランドに合わせて」「このサイトに合わせて」「落ち着いた感じに」「フォントを変えて」「テーマを作って」、"change the colors", "match our brand", "match this website", "theme", "color palette", "font", "design system" で起動。
4
4
  ---
5
5
 
6
- # DESIGN.md と styles.css をまとめて更新する
6
+ # テーマと styles.css を更新する
7
7
 
8
- Vantage アプリの見た目は 2 つのファイルで決まる。
8
+ Vantage アプリの色・書体・角丸の値と色の割り当ては、SquadKit のテーマだけが持つ。
9
9
 
10
- | ファイル | 持つもの | 所有者 |
11
- | --- | --- | --- |
12
- | `DESIGN.md`(プロジェクトルート) | 意図とルール。**トークン名だけ**を書き、色コードは書かない(150 行以内) | ユーザー |
13
- | `styles.css`(ページと同じ側。通常 `src/styles.css`) | トークンの実際の値(`:root` と `.dark`) | ユーザー |
10
+ | 手段 | 何を決めるか |
11
+ | --- | --- |
12
+ | ThemeDialog / `theme <id>` / `chart <preset>`(CLI) | 出発点のテーマとチャートの配色 |
13
+ | `styles.css`(ページと同じ側。通常 `src/styles.css`)の `/* squadkit-theme:end */` より後ろ | ブランド色・書体など、テーマに無い値の上書き |
14
14
 
15
- **2 つは必ず同じステップで更新する。** 片方だけ直すと、次にページを書くエージェントが古い意図に
16
- 従ってしまう。デザイン変更の依頼をページ単位の `className` 修正で済ませない。
15
+ デザイン変更の依頼(「もっと落ち着いた色に」など)は、**テーマの切り替えかスタイルシートの上書きで完結させる。**
16
+ `DESIGN.md` へは記録しない。今のテーマ名は `styles.css` の `/* theme: <name> */` マーカーから読む。
17
+ ページ単位の `className` 修正で済ませない。
17
18
 
18
- 一般規約(トークンで色を書く・設定ファイルを作らない)は `AGENTS.md` が正本。ここでは手順だけを扱う。
19
+ 見た目の規則(意味トークンの使い分け・カードで包む・KPI → チャート → 表など)は `AGENTS.md` の
20
+ 「見た目の規約」節が正本。ここでは手順だけを扱い、規則は重複させない。
21
+ 任意の `DESIGN.md`(ユーザー固有の意図を書くファイル)は、ユーザーが望んだときだけ扱う(`references/format.md`)。
19
22
 
20
23
  ## リファレンス
21
24
 
22
25
  | ファイル | 読む場面 |
23
26
  | --- | --- |
24
- | `references/format.md` | `DESIGN.md` を書く / 直すとき(書式・節の順番・雛形) |
25
- | `references/extract.md` | URL・画像・pptx/pdf・言葉・外部 DESIGN.md から色と書体を取り出すとき |
27
+ | `references/format.md` | ユーザーが任意の `DESIGN.md` を望んだとき(位置づけと優先順位) |
28
+ | `references/extract.md` | URL・画像・pptx/pdf・言葉から色と書体を取り出すとき |
26
29
  | `references/presets.md` | テーマ(`neutral` / `ocean` / `forest` / `sunset` / `violet` / `rose` / `mono`)の選び方と `theme` コマンド。旧プリセット id の読み替え |
27
30
  | `scripts/contrast.mjs` | 文字色と背景色のコントラスト比を確かめるとき |
28
31
 
@@ -30,24 +33,23 @@ Vantage アプリの見た目は 2 つのファイルで決まる。
30
33
 
31
34
  ### 1. 入力を集める
32
35
 
33
- - 何に合わせるのか(URL・ロゴ画像・資料・言葉・外部の `DESIGN.md`)を確認し、
36
+ - 何に合わせるのか(URL・ロゴ画像・資料・言葉)を確認し、
34
37
  `references/extract.md` の該当する節の手順で色・書体・トーンを取り出す。
35
- - 既存の `DESIGN.md` と `styles.css` を読む。既にあるルールで今回触らないものは残す。
38
+ - 既存の `styles.css` を読み、マーカーから今のテーマ名を確かめる。今回触らない上書きは残す。
39
+ - プロジェクトルートに `DESIGN.md` があれば読む(ユーザー所有。書き換えない)。色の割り当てはテーマが優先。
36
40
  - スライド(`*.slide.tsx`)があるかを `ls` / `vantage routes` で確認しておく。
37
41
 
38
42
  ### 2. 提案して確認を取る
39
43
 
40
44
  書き込む前に、次の 2 つをユーザーに見せて確認を取る。
41
45
 
42
- - **役割 → トークンの対応表**(主色・強調・良い/悪い/注意・背景の段階・文字・チャート 5 色・書体)。
46
+ - **役割 → トークンの対応表**(主色・背景の段階・文字・チャート 5 色・書体。良い/悪い/注意/情報/中立はテーマの意味トークンに任せる)。
43
47
  各行に「何に合わせてその色にしたか」を 1 語添える。
44
- - **トーンの説明**(2〜3 行。`DESIGN.md` の「全体のトーン」にそのまま入る文)。
48
+ - **トーンの説明**(2〜3 行)。
45
49
 
46
50
  テーマで足りる場合はテーマ id(`references/presets.md`)で提案してよい。旧プリセット id(`default` / `calm` / `vivid` / `mono`)で頼まれたら新 id に読み替える。
47
51
 
48
- ### 3. styles.css と DESIGN.md を同じステップで書く
49
-
50
- `styles.css`:
52
+ ### 3. テーマを当て、styles.css を書く
51
53
 
52
54
  - **テーマ範囲・チャート範囲のマーカーの中は手で編集しない。** 色・角丸・書体の出発点は 7 テーマ
53
55
  (`neutral` / `ocean` / `forest` / `sunset` / `violet` / `rose` / `mono`)から選び、コマンドで当てる:
@@ -100,10 +102,6 @@ Vantage アプリの見た目は 2 つのファイルで決まる。
100
102
  長い表(ダッシュボード): カードに `max-h-*` + `overflow-y-auto` の縦スクロール領域を作らず、
101
103
  ページング付きの `DataTablePreset`(`enablePagination`)にする(ホイールや End キーがページに届かなくなるため)。
102
104
 
103
- `DESIGN.md`: `references/format.md` の書式で書く。**色コードを書かない**(トークン名だけ)。
104
- 150 行を超えない(超えると `vantage check` が `DESIGN_MD_TOO_LONG` を出す)。ロゴなどの素材は
105
- `public/brand/logo.svg` のように `public/` 配下のパスで「ブランド素材」行に書く。
106
-
107
105
  ### 4. コントラストを確かめる
108
106
 
109
107
  主な文字色 / 背景色の組を、**ライトとダークの両方で**確かめる。
@@ -133,11 +131,11 @@ node <このスキルの場所>/scripts/contrast.mjs '<文字色>' '<背景色>'
133
131
  npx vantage check
134
132
  ```
135
133
 
136
- `HARDCODED_COLOR`(ページ内の色コード)や `DESIGN_MD_TOO_LONG` が出たらその場で直す。
134
+ `HARDCODED_COLOR`(ページ内の色コード)などが出たらその場で直す。
137
135
 
138
136
  ### 7. 完了を報告する
139
137
 
140
- 報告には、更新したファイル(`DESIGN.md` / `styles.css`)に加えて次を**必ず**入れる。
138
+ 報告には、更新したファイル(`styles.css` など)と当てたテーマ名に加えて次を**必ず**入れる。
141
139
 
142
140
  - プレビューページのパスと URL(`src/design-preview.tsx` → `/design-preview`)。
143
141
  - 「ホームなど既存の画面は一部の色しか使っていないので、変更が見えないことがある。配色はプレビュー
@@ -145,5 +143,5 @@ npx vantage check
145
143
 
146
144
  ## 会話中の指示との関係
147
145
 
148
- - 会話中の個別の指示(「このグラフだけ赤で」)は `DESIGN.md` より優先する。そのページだけ直せばよい。
149
- - 同じ指示が 2 回以上出たら、`DESIGN.md` への反映を提案する(反映するときはこの手順の 2 から)。
146
+ - 会話中の個別の指示(「このグラフだけ赤で」)はテーマより優先する。そのページだけ直せばよい。
147
+ - 同じ指示が 2 回以上出たら、`styles.css` の上書きへ反映することを提案する(この手順の 2 から)。
package/base-template/.squadbase/skills/vantage-design/references/extract.md CHANGED
@@ -44,7 +44,7 @@ grep -oE 'font-family:[^;]+' /tmp/site.css | sort | uniq -c | sort -rn | head
44
44
  - SPA で HTML がほぼ空のときは、`<script>` より先に CSS の `<link>` を探す。それも無ければ
45
45
  ユーザーにスクリーンショットかブランドカラーを聞く(推測で埋めない)。
46
46
  - 取得できない(認証・ボット対策)ときは、その旨を伝えてスクリーンショットをもらう。
47
- - ロゴを使うなら `public/brand/` に保存し、`DESIGN.md` の「ブランド素材」行にパスを書く。
47
+ - ロゴを使うなら `public/brand/` に保存する。
48
48
 
49
49
  ## 画像・ロゴ
50
50
 
@@ -83,12 +83,10 @@ grep -oE 'font-family:[^;]+' /tmp/site.css | sort | uniq -c | sort -rn | head
83
83
 
84
84
  ## 外部の DESIGN.md(Stitch などが書いたもの)
85
85
 
86
- 外部の DESIGN.md は YAML frontmatter や本文に**値**(hex・px・フォント名)を持っていることが多い。
87
- Vantage の `DESIGN.md` は値を持たないので、**値を `styles.css` へ移し、`DESIGN.md` をトークン参照に
88
- 書き直す**。
86
+ 外部の DESIGN.md が値(hex・px・フォント名)を持っているときは、値だけを拾って**テーマ側**へ移す。
87
+ Vantage に `DESIGN.md` は作らない。
89
88
 
90
- 1. 値を拾う: primary / secondary / surface / background / on-* / error / success / warning、
91
- フォント、角丸。
89
+ 1. 値を拾う: primary / secondary / surface / background / on-* / error、フォント、角丸。
92
90
  2. 対応づける:
93
91
 
94
92
  | 外部の名前 | Vantage のトークン |
@@ -98,15 +96,14 @@ Vantage の `DESIGN.md` は値を持たないので、**値を `styles.css` へ
98
96
  | background / surface / surface-container | `--background` / `--card` / `--muted` |
99
97
  | on-background / on-surface / on-surface-variant | `--foreground` / `--card-foreground` / `--muted-foreground` |
100
98
  | outline | `--border` |
101
- | error | `--destructive` |
102
- | success / warning | 専用トークンなし → `--chart-*` のどれかに割り当てて `DESIGN.md` に書く |
99
+ | error | `--destructive`(意味トークンの negative) |
100
+ | success / warning | テーマの意味トークン(positive / warning)に任せる。チャートの色には割り当てない |
103
101
  | radius / corner | `--radius` |
104
102
  | display / headline font | `--slide-font-display`(+ ページの見出しなら `--font-sans`) |
105
103
  | body font | `--font-sans`(ページ本文)と `--slide-font-body` |
106
104
 
107
105
  3. `styles.css` のマーカーブロックの外に、`:root` と `.dark, [data-theme="dark"]` の両方で書く
108
- (チャート色・書体の書き方は SKILL.md の手順 3)。外部の DESIGN.md に
109
- ダークの値が無ければ、ライトの色相を保って明度だけ反転した値を作り、コントラストを確かめる。
110
- 4. `DESIGN.md` を `format.md` の節の順番で書き直す。外部の文章(トーン・Do/Don't・コンポーネントの
111
- ルール)は活かし、値だけをトークン名に置き換える。150 行に収まらない分は要約する。
112
- 5. 元のファイルは消さずに残すか(例: `docs/design-source.md`)、ユーザーに確認して削除する。
106
+ (チャート色・書体の書き方は SKILL.md の手順 3)。外部にダークの値が無ければ、ライトの色相を保って
107
+ 明度だけ反転した値を作り、コントラストを確かめる。
108
+ 4. 外部のトーン・Do/Don't・コンポーネントのルールは、ユーザーが望んだときだけ任意の `DESIGN.md`
109
+ (`format.md`)に要約して残す。値は書かない。
package/base-template/.squadbase/skills/vantage-design/references/format.md CHANGED
@@ -1,173 +1,12 @@
1
- # DESIGN.md の書式
2
-
3
- `DESIGN.md` はプロジェクトルートに置く、**ユーザーが所有する**ファイル。アプリの見た目の意図と
4
- 使い分けのルールを、エージェントが UI を書く前に読める形で残す。`vantage upgrade` も
5
- `vantage add agents` も書き換えない。
6
-
7
- ## 原則
8
-
9
- - **値を書かない。トークン名だけを書く。** 色コード(`#…`・`oklch(…)`・`rgb(…)`・`hsl(…)`)や
10
- px 値の色・書体の実値は `styles.css` の持ち物。`DESIGN.md` には `--primary` のようなトークン名と、
11
- Tailwind のセマンティッククラス(`text-muted-foreground`)・サイズの段階(`text-2xl`)だけを書く。
12
- パレット名で色味を説明するのは可(「青 → ティール → …」)。
13
- - **150 行以内。** 超えると `vantage check` が `DESIGN_MD_TOO_LONG` を警告する。エージェントが
14
- 毎回全文を読むファイルなので、網羅より判断に効くルールを優先する。
15
- - **YAML frontmatter は付けない。** 先頭は下の「冒頭のコメント」から始める。
16
- - **会話中の指示が優先。** `DESIGN.md` は既定値であって、個別の依頼を拒む根拠にしない。
17
- - ロゴ・画像は `public/` 配下のパスで参照する(`public/brand/logo.svg`)。画像を埋め込まない。
18
-
19
- ## 節の順番と見出し
20
-
21
- 見出しは日本語 + 英語の括弧書き(外部の DESIGN.md — Stitch など — の節と対応づけやすくするため)。
22
- この順番を崩さない。無い情報の節は消さずに「特になし」と書く。
23
-
24
- | # | 見出し | 書くこと |
25
- | --- | --- | --- |
26
- | 0 | 冒頭のコメント(`<!-- … -->`) | 何のファイルか / 値は styles.css / 会話の指示が優先 / 「このサイトに合わせて」で更新できること / upgrade が触らないこと |
27
- | 1 | `## 全体のトーン (Overview)` | 2〜4 行のトーン。最後に「ブランド素材:」行(任意。`public/` のパス) |
28
- | 2 | `## 色 (Colors)` | 役割 → トークンの表。行は **主色 / 強調 / 良い / 悪い / 注意 / 背景の段階 / 境界 / 文字**。専用トークンが無い役割は「専用トークンなし」+ 代替 |
29
- | 3 | `## チャート (Charts)` | 系列の順番(`--chart-1..5` とその色味)、1 系列だけ強調するときの色、良い / 悪いの色、禁止の組み合わせ、プリセット名 |
30
- | 4 | `## 書体 (Typography)` | 見出し / 本文 / 数字 / スライドの書体(`--slide-font-display` / `--slide-font-body`)と、サイズの段階(Tailwind クラス・`--slide-size-*`) |
31
- | 5 | `## レイアウトと密度 (Layout)` | カード・余白(`gap-*`)・`--radius`・並べ方・密度 |
32
- | 6 | `## 成果物の種類ごとの規則 (Per-artifact)` | `### ダッシュボード` と `### スライド` の小節(他の種類があれば小節を足す) |
33
- | 7 | `## Do / Don't` | 3 つずつ程度 |
34
-
35
- 外部の DESIGN.md の対応: Overview / Colors / Typography / Layout(Spacing・Elevation 含む)/
36
- Components → 「成果物の種類ごとの規則」/ Do's and Don'ts。値は `styles.css` へ移す
37
- (→ `extract.md` の「外部の DESIGN.md」)。
38
-
39
- ## 使えるトークン
40
-
41
- | 系統 | トークン |
42
- | --- | --- |
43
- | 面と文字 | `--background` `--foreground` `--card` `--card-foreground` `--popover` `--popover-foreground` |
44
- | 主色など | `--primary` `--primary-foreground` `--secondary` `--secondary-foreground` `--accent` `--accent-foreground` `--muted` `--muted-foreground` `--destructive` `--destructive-foreground` |
45
- | 境界 | `--border` `--input` `--ring` |
46
- | チャート | `--chart-1` 〜 `--chart-5` |
47
- | 形 | `--radius` |
48
- | サイドバー | `--sidebar` `--sidebar-foreground` `--sidebar-primary` … |
49
- | スライド | `--slide-bg` `--slide-fg` `--slide-accent` `--slide-muted` `--slide-radius` `--slide-font-display` `--slide-font-body` `--slide-size-hero` `--slide-size-body` |
50
-
51
- - `--muted` `--accent` `--secondary` `--border` は背景・境界用。文字色の役割に割り当てない。
52
- - 良い / 注意の専用トークンは無い。`--chart-*` の中から割り当てるか、「専用トークンなし」と書く。
53
- - ページ本文の書体は `--font-sans`(`styles.css` の `body` が `font-family: var(--font-sans)` で参照する。
54
- テーマを当てると `--font-sans` もテーマの値になる。変えるときはテーマ範囲のマーカーの後ろで上書きする)。
55
- - `--slide-bg` などは既定で `--background` などの別名。`.dark` に書き直す必要は無い。
56
-
57
- ## 雛形(中立の既定テーマ)
58
-
59
- ベーステンプレート(`packages/vantage-template/template/DESIGN.md`)と**同じ内容**。どちらかを
60
- 直したらもう片方も合わせること。既定テーマ(無彩色の `--primary`、チャートは `blue` プリセット)を
61
- そのまま説明しているので、新規に作るときはこれを写して、変えた役割の行だけを書き換える。
62
-
63
- ````markdown
64
- <!--
65
- DESIGN.md — このアプリの「見た目の意図」を書くファイルです。
66
-
67
- - 実際の色・角丸・書体の値は src/styles.css にあります。ここにはトークン名(--primary など)と
68
- 使い分けのルールだけを書き、色コードは書きません。
69
- - エージェントはページ・スライド・コンポーネントを書く前にこのファイルを読みます。
70
- 会話の中での指示はこのファイルより優先されます。
71
- - 「このサイトに合わせて」「色を落ち着いた感じに」と頼めば、このファイルと styles.css を
72
- まとめて更新します。
73
- - このファイルはあなたのものです。`vantage upgrade` が書き換えることはありません。
74
- -->
75
-
76
- # デザイン
77
-
78
- ## 全体のトーン (Overview)
79
-
80
- - 落ち着いた無彩色のベースに、データだけが色を持つ業務ダッシュボード。
81
- - 装飾より読みやすさを優先する。影・グラデーション・アニメーションは最小限。
82
- - 数字が主役。1 画面で伝えたいことを 1 つに絞り、補足は小さく添える。
83
- - ブランド素材: なし(ロゴを使う場合は `public/brand/logo.svg` のように `public/` 配下のパスで書く)
84
-
85
- ## 色 (Colors)
86
-
87
- 色は必ずトークン(Tailwind のセマンティッククラス)で指定する。素のパレット(`bg-blue-600` など)や
88
- 色コードを直接書かない。
89
-
90
- | 役割 | トークン | 使う場所 |
91
- | --- | --- | --- |
92
- | 主色 (Primary) | `--primary` / `--primary-foreground` | 主要ボタン、選択中の状態。既定は無彩色 |
93
- | 強調 (Accent) | `--chart-1` | 1 つだけ目立たせたい数値・系列・リンク的な強調 |
94
- | 良い (Positive) | `--chart-2` | 前期比のプラスなど、良い変化の小さな印 |
95
- | 悪い (Negative) | `--destructive` | 前期比のマイナス、エラー、削除操作 |
96
- | 注意 (Warning) | 専用トークンなし | 文言とアイコンで示し、色は `--muted-foreground` |
97
- | 背景の段階 | `--background` → `--card` → `--muted` | ページ → カード → カード内の区画・ホバー |
98
- | 境界 | `--border` / `--input` / `--ring` | 罫線、入力欄、フォーカス |
99
- | 文字 | `--foreground` / `--muted-foreground` | 本文 / 補足・ラベル・単位 |
100
-
101
- - `--muted`・`--accent`・`--secondary`・`--border` は背景・境界用。文字色に使わない。
102
- - 増減(▲▼・前期比)は向きで色を分ける: 増加・プラスは `--chart-2`(または `--primary`)、
103
- 減少・マイナスは `--destructive`。下向きの矢印やマイナスを `--primary` で塗らない。
104
- - ライトとダークの両方がトークンで決まるので `dark:` を並べない。
105
-
106
- ## チャート (Charts)
107
-
108
- - 系列の順番は `--chart-1` → `--chart-2` → `--chart-3` → `--chart-4` → `--chart-5`
109
- (現在はプリセット `blue`: 青 → ティール → フクシア → バイオレット → グレー)。
110
- - 1 系列だけを目立たせるときは、その系列を `--chart-1`、残りをすべて `--chart-5`(グレー)にする。
111
- - 良い / 悪いを色で塗り分けるときは `--chart-2` / `--destructive`。色だけに頼らず ▲▼ や符号も添える。
112
- - 系列は 5 つまで。それ以上はグループ化するか「その他」にまとめる。
113
- - 禁止: 同じチャートで `--destructive` を普通の系列色として使う(悪い値に見える)。
114
- - 禁止: 隣り合う系列に `--chart-3` と `--chart-4` を並べて細い線で描く(見分けにくい)。
115
- - 配色を丸ごと変えるときは `npx @squadbase/vantage-template theme <id>` を使う
116
- (`neutral` / `ocean` / `forest` / `sunset` / `violet` / `rose` / `mono`)。チャートだけ別の配色にするときは
117
- `chart <preset>`(`blue` / `ocean` / `sunset` / `forest` / `berry` / `mono`)。
118
-
119
- ## 書体 (Typography)
120
-
121
- | 用途 | 指定 | 備考 |
122
- | --- | --- | --- |
123
- | 見出し・本文 | 日本語を含むシステムフォント(`--font-sans`) | Web フォントは使わない |
124
- | 数字 | 同上 + `tabular-nums` | 桁がそろうように必ず付ける |
125
- | スライドの見出し | `--slide-font-display` | 既定は日本語を含むシステムフォント |
126
- | スライドの本文 | `--slide-font-body` | 既定は見出しと同じ |
127
-
128
- サイズの段階(ダッシュボード):
129
-
130
- - ページ見出し: `text-2xl font-bold`
131
- - カード見出し・ラベル: `text-sm font-medium text-muted-foreground`
132
- - KPI の数値: `text-3xl font-semibold tabular-nums`
133
- - 本文・表: `text-sm`
134
- - 注釈・出典: `text-xs text-muted-foreground`
135
-
136
- スライドのサイズは `--slide-size-hero`(表紙・大きな数字)と `--slide-size-body`(本文)を基準にする。
137
-
138
- ## レイアウトと密度 (Layout)
139
-
140
- - 情報はカード(`bg-card` + `border-border`)で区切る。角丸は `--radius` に従う(個別に変えない)。
141
- - グリッドの間隔は `gap-4`。セクション間は `gap-6` 程度。
142
- - KPI は 1 行に 2〜4 枚。その下にチャート、最後に明細の表。
143
- - 密度は「中」。余白を削って詰め込むより、ページを分ける。
144
-
145
- ## 成果物の種類ごとの規則 (Per-artifact)
146
-
147
- ### ダッシュボード
148
-
149
- - 先頭に KPI カード、次にトレンドのチャート、最後に明細の表。
150
- - 各 KPI には比較対象(前月比・目標比など)を 1 つ添える。
151
- - チャートのタイトルは結論を書く(「売上推移」より「売上は 3 か月連続で増加」)。
152
-
153
- ### スライド
154
-
155
- - 1 枚に 1 メッセージ。見出しに結論を書く。
156
- - 色は `--slide-bg` / `--slide-fg` / `--slide-accent` / `--slide-muted` を使う
157
- (既定では `--background` / `--foreground` / `--primary` / `--muted-foreground` に連動)。
158
- - 強調色は 1 枚につき 1 か所まで。
159
-
160
- ## Do / Don't
161
-
162
- Do:
163
-
164
- - トークンと Tailwind のセマンティッククラスで色を指定する。
165
- - 数値には単位と比較対象を付ける。
166
- - 色の意味(良い / 悪い / 強調)をアプリ全体でそろえる。
167
-
168
- Don't:
169
-
170
- - 色コードや素のパレットクラスを直接書く。
171
- - 1 画面で強調色を何か所にも使う。
172
- - 3D チャート・円グラフの多用・装飾目的のグラデーション。
173
- ````
1
+ # 任意の DESIGN.md
2
+
3
+ `DESIGN.md` は、プロジェクトルートに置く**ユーザー所有の任意のファイル**。新規プロジェクトには作らない。
4
+ ユーザーが望んだときだけ、ユーザー固有の意図(密度・スライドの見出し方針・ブランド素材など)を書く。
5
+
6
+ - 色・書体・角丸の値と色の割り当ては書かない。テーマ(`styles.css`、ThemeDialog、CLI の `theme` / `chart`)が持つ。
7
+ デザイン変更の依頼を `DESIGN.md` に記録しない。
8
+ - 見た目の規則は `AGENTS.md` の「見た目の規約」節が正本。`DESIGN.md` はそれに**加えて**従われる。
9
+ 色の割り当てが食い違うときはテーマを優先する。
10
+ - 既存の `DESIGN.md` は消さない。`vantage upgrade` も `vantage add agents` も書き換えない。
11
+ - 150 行以内(超えると `vantage check` が `DESIGN_MD_TOO_LONG` を警告する)。YAML frontmatter は付けない。
12
+ - ロゴ・画像は `public/` 配下のパスで参照する(`public/brand/logo.svg`)。
package/base-template/.squadbase/skills/vantage-design/references/presets.md CHANGED
@@ -48,13 +48,3 @@ npx @squadbase/vantage-template theme ocean --reset-chart # chart コマンド
48
48
  **`/* squadkit-theme:end */`(チャート範囲があればその終端)より後ろ**に、変えたいトークンだけ
49
49
  `:root` と `.dark, [data-theme="dark"]` の**両方**に書く。前に書くとテーマに負ける。
50
50
  `scripts/contrast.mjs` で `--primary-foreground` / `--primary` をライトとダークで確かめる。
51
-
52
- ## DESIGN.md
53
-
54
- `format.md` の雛形から作り、選んだテーマに合わせて次の行だけ書き換える。
55
-
56
- - 「全体のトーン」: 上の表のトーンを 2〜3 行に。
57
- - 主色の行: テーマの主色の色味(「青」「橙」など。**色コードは書かない**)。
58
- - チャートの色味: テーマの `--chart-1..5` の並び(適用後の `styles.css` を見る)。
59
- - 良い / 悪い / 注意: 専用トークンは無い。`--chart-*` から割り当てるか「専用トークンなし」と書く。
60
- `--destructive` を普通の系列色に使わない。
package/base-template/AGENTS.md CHANGED
@@ -7,8 +7,8 @@
7
7
  > このファイルと `agents/*.md` は、いずれも **Vantage フレームワークが所有する正本**の
8
8
  > コピーです。手で書き換えても、`vantage upgrade` を実行するとフレームワーク同梱の正本から
9
9
  > 再同期されて上書きされます。アプリ固有のメモは別ファイル(例: `README.md`)に書いてください。
10
- > 例外はプロジェクトルートの `DESIGN.md` で、これは**ユーザーが所有**します(`vantage upgrade` も
11
- > `vantage add agents` も触らない。→「デザインの意図(DESIGN.md)」)。
10
+ > 例外はプロジェクトルートの任意の `DESIGN.md` で、これは**ユーザーが所有**します(`vantage upgrade` も
11
+ > `vantage add agents` も触らない。→「見た目の規約」)。
12
12
  >
13
13
  > 手順を伴う踏み込んだワークフローは、同梱の Claude Code Skill に分かれています。このファイルは
14
14
  > 「地図」、`agents/*.md` は「種類ごとの静的リファレンス」、Skill は「手順書」という役割分担です。
@@ -47,8 +47,9 @@ UI キット・開発サーバー・API サーバー・ビルドはすべて Van
47
47
  - **`definePage` の値はリテラルで書く。** title/description/navLabel はビルド時に静的抽出される
48
48
  ため、変数・関数呼び出し・テンプレート補間は使わない。`page` エクスポートはランタイムでは
49
49
  読まれない。
50
- - **アプリの表示言語は、ルート `_layout.tsx` の `export const lang = "ja"`(リテラル)で指定する。**
50
+ - **アプリの表示言語は、ルート `_layout.tsx` の `export const lang = "en"`(リテラル。BCP 47)で指定する。**
51
51
  `<html lang>` になり、日本語の文節改行とスライドの文言切り替えに効く。未指定は `"en"`。
52
+ 画面の文言・docs・コメントは、ユーザーが使う言語に合わせる(`lang` もその言語にする)。
52
53
 
53
54
  ## ディレクトリ構造(ページをどこに置くか)
54
55
 
@@ -102,7 +103,7 @@ root/
102
103
  | `@squadbase/vantage/markdown` | `MarkdownRenderer`(Shiki を隔離するための専用サブパス) |
103
104
  | `@squadbase/vantage/server` | `ApiContext`・`ApiHandler`・`HttpError`・`isHttpError`・`json`(server/ 側でのみ使う) |
104
105
 
105
- **KPI は `KpiCard`、増減は `Delta`(`comparison` と `polarity` を渡す)。** 向き・率・色は値から計算
106
+ **KPI は `KpiCard`、増減は `Delta`(`comparison` を渡し、下がって良い指標は `betterWhen="down"`)。** 向き・率・色は値から計算
106
107
  されるので手で渡さない。`TrendIndicator` は非推奨(`direction` を手で渡すので値と食い違いうる)。props は
107
108
  `vantage docs kpi-card` / `vantage docs delta` を引く。
108
109
 
@@ -125,17 +126,30 @@ import { KpiCard, Delta } from "@squadbase/vantage/components";
125
126
  - `server/` が**無い** → 外部 API を直接叩くなら `useQuery`(→ `agents/page.md`)。自前の API が
126
127
  要るようになったら `server/api/*.ts` を足すだけでよい(設定変更は不要)。
127
128
 
128
- ## デザインの意図(DESIGN.md)
129
+ ## 見た目の規約
129
130
 
130
- プロジェクトルートに `DESIGN.md` があれば、**UI(ページ・スライド・コンポーネント)を書く前に
131
- 読む。** 色・チャート・書体・レイアウトの使い分けがトークン名で書いてあるので、それに従って
132
- トークンで書く(値は `styles.css` にあり、`DESIGN.md` には色コードを書かない)。
131
+ 色・書体・角丸などの**値と色の割り当ては、テーマ(`styles.css` の `/* theme: <name> */` マーカー以降の
132
+ 上書き)だけが持つ。** ここには値を書かず、使い分けの規則だけを置く。UI(ページ・スライド・
133
+ コンポーネント)はこの規則に従い、色は必ずトークンで指定する(色コード・素のパレットクラスは書かない)。
133
134
 
134
- - **会話中の指示は `DESIGN.md` より優先する。** 同じ指示が繰り返されたら、`DESIGN.md` への
135
- 反映をユーザーに提案する。
136
- - **「色を変えて」「ブランドに合わせて」などデザイン全体の変更は、ファイルごとに直さない。**
137
- Skill `vantage-design` の手順で `DESIGN.md` と `styles.css` をまとめて更新する。
138
- - `DESIGN.md` はユーザーの持ち物。`vantage upgrade` は書き換えない。
135
+ - **意味トークン:** 良い = `positive`、悪い = `negative`、注意 = `warning`、情報 = `info`、
136
+ 中立 = `neutral`。系列色は `chart-1`〜`chart-5` を番号順に使う(5 系列まで。超えるなら「その他」に
137
+ まとめる)。増減の良否は指標の性質(コスト減・解約率減は良い)で決めて
138
+ positive / negative に分け(`KpiCard` / `Delta` の `betterWhen`。下がって良い指標は `betterWhen="down"`)、向きは ▲▼ や符号で表す。
139
+ - **レイアウト:** 内容はカードで包む。順序は KPI → チャート → 表。値が 1 つなら KPI にする
140
+ (1 本の棒グラフにしない)。強調は 1 画面(スライドは 1 枚)に 1 か所。数値には単位と比較対象を添える。
141
+ - **Do:** トークンで色を指定する / 色の意味をアプリ全体でそろえる / チャートのタイトルに結論を書く。
142
+ - **Don't:** 色コードや素のパレットクラスを書く / `dark:` を並べる / 3D・装飾目的のグラデーション・
143
+ 円グラフの多用 / 同じチャートで `negative` を普通の系列色に使う。
144
+ - スライド固有の規則は `agents/slide.md`。
145
+
146
+ **任意の `DESIGN.md`:** プロジェクトルートにあれば読んで従う(密度・スライドの見出し方針・
147
+ ブランド素材などユーザー固有の意図)。AGENTS.md の規則に加えて従うが、**色の割り当てはテーマを優先**
148
+ する。新規には作らない。ユーザーの持ち物で、`vantage upgrade` は書き換えも削除もしない。
149
+
150
+ **デザイン変更の依頼**(「もっと落ち着いた色に」「ブランドに合わせて」など)は、ファイルごとに
151
+ 直さず、テーマの切り替えかスタイルシートの上書きで完結させる。`DESIGN.md` には記録しない。今のテーマ名は
152
+ `styles.css` の `/* theme: <name> */` マーカーから読む。手順は Skill `vantage-design`。
139
153
 
140
154
  ## 何を書くか → どのファイルを読むか
141
155
 
@@ -174,7 +188,7 @@ vantage docs button # 1 ページ表示(短縮名。ui/button に解
174
188
  vantage docs parts/data-table # 完全な slug でも引ける
175
189
  vantage docs data-table --json # { slug, title, description, section, content }
176
190
  vantage docs --all # 全ページを連結(まとめて読み込む用)
177
- vantage docs routing --lang en # 英語版(既定は ja)
191
+ vantage docs routing --lang en # 英語版(`--lang` 省略時は ja。アプリの文言の言語とは無関係)
178
192
  ```
179
193
 
180
194
  props の表・使用例・落とし穴はコンポーネントのページに載っている。**推測で props を書く前に
@@ -212,7 +226,7 @@ body・レスポンスの status と形)まで出る。`vantage check --json` /
212
226
  - **`vantage-app`** — アプリを一から作る / 構成を広げるときの進め方と検証の順序
213
227
  - **`vantage-add-feature`** — 既存アプリに page / api / ui を 1 つ足す定型
214
228
  - **`vantage-slide`** — `.slide.tsx` でスライドデッキを書く(キャンバスの予算・段階表示・pptx 書き出し)
215
- - **`vantage-design`** — `DESIGN.md` と `styles.css` をまとめて作る / 直す(配色・書体・ブランド合わせ)
229
+ - **`vantage-design`** — テーマの切り替え・`styles.css` の上書きで見た目を直す(配色・書体・ブランド合わせ)
216
230
  - **`vantage-pitfalls`** — Base UI(≠ Radix)の癖など、静かに壊れる落とし穴のリファレンス
217
231
  - **`project-storage`** — Squadbase の Project Storage(アップロード済みファイル)をブラウザから読み書きする
218
232
 
package/base-template/agents/api.md CHANGED
@@ -32,6 +32,9 @@ export async function GET({ params, env }: ApiContext) {
32
32
  (`!` で黙らせない)。
33
33
  - **クライアントに見せたいエラーは `HttpError(status, msg)` を throw する。** それ以外の throw は
34
34
  ログに記録され汎用の 500 に丸められる。
35
+ - **入力の誤りは 400 で返し、`msg` には何がどう誤りかを書く。** `msg` はそのまま `ErrorState` に
36
+ 出る。「開始日(10/20)が終了日(10/01)より後です」のように、利用者が条件を直せる文にする。
37
+ 許す範囲だけを並べた文(「最大366日で指定」)では、どこを直せばよいか伝わらない。
35
38
  - **シークレットは `ApiContext.env` にだけ届く**(クライアントには決して届かない)。
36
39
 
37
40
  クライアント側からは `useApiQuery` で `/api/*` を叩く。ベース URL の解決・JSON パース・
@@ -74,5 +77,9 @@ return <Chart sessions={sessions.data} metrics={metrics.data} />
74
77
  カードごとに別々に読み込み中・エラーを出すなら、`data` を渡す側で `q.data ?? []` にするか、
75
78
  カードのコンポーネントの中で上と同じ判定をする。
76
79
 
80
+ 期間などの絞り込みを持つページでは、上の早期 return をページの先頭に置かない。失敗したときに
81
+ 絞り込みの欄まで消え、条件を直せなくなる。判定はデータを描く子コンポーネントの中で行う
82
+ (→ `agents/page.md` の「絞り込みの欄は、読み込み中も失敗したときも出し続ける」)。
83
+
77
84
  `ApiError` は `message`・`status`・`body`・`requestId` を持つ。hook が使えない場所では
78
85
  `apiJson(path, init)`、生の `Response` が要るときは `apiFetch`。
package/base-template/agents/page.md CHANGED
@@ -4,7 +4,7 @@
4
4
  (ダッシュボード)を書くときに読んでください。前提となる不変条件・ディレクトリ構造は
5
5
  `AGENTS.md` を先に読んでいる想定です。
6
6
 
7
- プロジェクトルートに `DESIGN.md` があれば、書き始める前に読んで配色・書体・レイアウトの規則に従う。
7
+ 書き始める前に `AGENTS.md` の「見た目の規約」(と、あればプロジェクトルートの `DESIGN.md`)に従う。
8
8
 
9
9
  ## 最小アプリ(2 ファイル)
10
10
 
@@ -147,6 +147,42 @@ const [segments, setSegments] = useSearchState<string[]>("segments", []) // JSON
147
147
  デフォルト値(または `null`)を書くとキーは URL から消える。履歴は既定で `replace`
148
148
  (`{ replace: false }` で push)。
149
149
 
150
+ ### 絞り込みの欄は、読み込み中も失敗したときも出し続ける
151
+
152
+ ページの先頭で `if (q.isError) return <ErrorState …/>` と書くと、取得に失敗したときに
153
+ 期間などの絞り込みの欄まで消える。利用者は条件を直せず、初期値に戻すしかなくなる。
154
+ 絞り込みの欄はページに置いたままにし、取得と `Loading` / `ErrorState` はデータを描く
155
+ 子コンポーネントに入れる:
156
+
157
+ ```tsx
158
+ export default function Traffic() {
159
+ const [from, setFrom] = useSearchParam("from", DEFAULT_FROM)
160
+ const [to, setTo] = useSearchParam("to", DEFAULT_TO)
161
+ return (
162
+ <>
163
+ {/* 失敗しても消えない。ここから条件を直せる */}
164
+ <PeriodFilter from={from} to={to} onChange={…} />
165
+ <TrafficBody from={from} to={to} />
166
+ </>
167
+ )
168
+ }
169
+
170
+ function TrafficBody({ from, to }: { from: string; to: string }) {
171
+ const q = useApiQuery<Row[]>("/api/traffic", { search: { from, to } })
172
+ if (q.isPending) return <Loading />
173
+ if (q.isError) return <ErrorState message={q.error.message} />
174
+ return <BarChart data={q.data} index="channel" categories={["sessions"]} />
175
+ }
176
+ ```
177
+
178
+ - **期間は `DateRangePicker`(`@squadbase/vantage/components`)で選ばせる。** カレンダーで
179
+ 範囲を選ぶので開始と終了が逆にならず、選べる日を `minDate` / `maxDate` で絞れる。
180
+ `<input type="date">` を 2 つ並べて自前で組まない。
181
+ - 値をそのまま打ち込める欄を置くなら、開始が終了より後・選べる範囲の外といった誤りは、
182
+ API へ送る前に欄のそばで理由を出す。誤りがあるあいだはデータの子コンポーネントを描かない
183
+ (送れば失敗するだけで、`ErrorState` には直し方が出ない)。
184
+ - サーバー側の検証で弾くときも、`HttpError(400, …)` の文で何がどう誤りかを言う(→ `agents/api.md`)。
185
+
150
186
  ### 動的パラメータの「3 つの綴り」を同期させる
151
187
 
152
188
  崩すと静かにマッチしなくなる不変条件:
package/base-template/agents/slide.md CHANGED
@@ -4,7 +4,13 @@
4
4
  スライドデッキを書くときに読んでください。不変条件・ディレクトリ構造は `AGENTS.md` を
5
5
  先に読んでいる想定です。
6
6
 
7
- プロジェクトルートに `DESIGN.md` があれば、書き始める前に読んで「スライド」の節と配色・書体の規則に従う。
7
+ 書き始める前に `AGENTS.md` の「見た目の規約」(と、あればプロジェクトルートの `DESIGN.md`)に従う。
8
+ スライド固有の規則:
9
+
10
+ - 1 枚に 1 メッセージ。見出しに結論を書く。
11
+ - 色は `--slide-bg` / `--slide-fg` / `--slide-accent` / `--slide-muted` を使う(既定では
12
+ `--background` / `--foreground` / `--primary` / `--muted-foreground` に連動)。
13
+ - 強調色は 1 枚につき 1 か所まで。
8
14
 
9
15
  ## スライドは `.slide.tsx` で書く
10
16
 
package/base-template/bun.lock CHANGED
@@ -6,8 +6,8 @@
6
6
  "name": "vibe-app",
7
7
  "dependencies": {
8
8
  "@squadbase/react": "^0.1.0",
9
- "@squadbase/vantage": "0.6.2-dev1.54bde93",
10
- "@squadbase/vantage-sdk": "0.1.1-dev1.fae2870",
9
+ "@squadbase/vantage": "0.6.2-dev1.56da87f",
10
+ "@squadbase/vantage-sdk": "0.1.1-dev1.2bfcfab",
11
11
  "date-fns": "^4.1.0",
12
12
  "lucide-react": "^0.468.0",
13
13
  "react": "^19.3.1",
@@ -114,7 +114,7 @@
114
114
 
115
115
  "@mermaid-js/parser": ["@mermaid-js/parser@1.2.1", "", { "dependencies": { "@chevrotain/types": "~11.1.2" } }, "sha512-n12NohV3mrUyUL2o93IgG/ifeW9FTyeJn3zDxkhwa8MJ9Fxg3HQMlA3RiGmD/3UnJvheztkjjQAjA2T4LmUcpw=="],
116
116
 
117
- "@oxc-project/types": ["@oxc-project/types@0.155.0", "", {}, "sha512-SeE8JPwW1xs1tHeNycjUtUBdhorRa8o4jlvjwk49R7/Z291i+4DQa7JJIgOm/TaYQZx+QrPQbVJ/9c8dMIZN8Q=="],
117
+ "@oxc-project/types": ["@oxc-project/types@0.156.0", "", {}, "sha512-1Duyg48TdJNdyhEB8Xn1L36bT9Pv6GUtlKjHxOys8xkaF/rQq3XJE+bAurSK/AgIz5mGFsb77cn9Pb20+WCScw=="],
118
118
 
119
119
  "@radix-ui/primitive": ["@radix-ui/primitive@1.1.7", "", {}, "sha512-rqWnm76nYT8HoNNqEjpgJ7Pw/DrBj5iBTrmEPo6HTX5+VJyBNOqTdv4g89G63HuR5g0AaENoAcH7Is5fF2kZ8Q=="],
120
120
 
@@ -148,35 +148,35 @@
148
148
 
149
149
  "@radix-ui/react-use-layout-effect": ["@radix-ui/react-use-layout-effect@1.1.3", "", { "peerDependencies": { "@types/react": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-rDiah9wvtqihWtWz02XreeRKIxt2EJF8y5D9rtY9l5A2zxePAtcPiOMpDugNRw5bFHz+1/8viVoc7ZVKiJknCw=="],
150
150
 
151
- "@rolldown/binding-android-arm-eabi": ["@rolldown/binding-android-arm-eabi@1.2.15", "", { "os": "android", "cpu": "arm" }, "sha512-aLcgK9gIJ3YRvrrtfSBbRa27F5WrpiTaPulnFpsHPxpUHgFlSgnU4854MHwoRGEBhfRJDWCS2WQ7lIjskE9Olw=="],
151
+ "@rolldown/binding-android-arm-eabi": ["@rolldown/binding-android-arm-eabi@1.2.16", "", { "os": "android", "cpu": "arm" }, "sha512-ia3DwAs0OsMGS7+IConptSiyk9pEXkOx/AbJ2n/lAGxH3QkWQus1t8d7gnAT38FCU2sQu8lUbeR6AiZFv4JxaA=="],
152
152
 
153
- "@rolldown/binding-android-arm64": ["@rolldown/binding-android-arm64@1.2.15", "", { "os": "android", "cpu": "arm64" }, "sha512-xD7DdZCrbThKuxNg7ooQmvp07ys4J/pnSEMTG3/OdOWl6daC67m/Q4fL78sRHMxTH/N4fGUbYhcPM0MF5WFHkg=="],
153
+ "@rolldown/binding-android-arm64": ["@rolldown/binding-android-arm64@1.2.16", "", { "os": "android", "cpu": "arm64" }, "sha512-kx5wBiMB6E7TEvpl2B9gjLU004BkvEm2Dr941BFjx/SontPwSzNuQUIoVKxHHoSjpFIfHMmcguyLOtyn0hObRg=="],
154
154
 
155
- "@rolldown/binding-darwin-arm64": ["@rolldown/binding-darwin-arm64@1.2.15", "", { "os": "darwin", "cpu": "arm64" }, "sha512-m2WuQ6r0B4OTYxyPpNLtXaMRbRDUbG8YQV2Q3KTdSSK8Th6KHCnC8jVCJt8bvYeSB5WivkkNbc85mKadaSdOxA=="],
155
+ "@rolldown/binding-darwin-arm64": ["@rolldown/binding-darwin-arm64@1.2.16", "", { "os": "darwin", "cpu": "arm64" }, "sha512-qslZrXnKJU4cUpjoAmtAo/KQM9e2IRMlmpig6Zpwj+8KWxW8v+nkAf9216Bsek9lOC1jvg2yCjygCFo2f83msQ=="],
156
156
 
157
- "@rolldown/binding-darwin-x64": ["@rolldown/binding-darwin-x64@1.2.15", "", { "os": "darwin", "cpu": "x64" }, "sha512-5RtnsHM36nodM9WbMy+zip0LGS/G+y5wro5RHrpOlr4ac24+1zSi9kiV2MP1myZeZ/ifEHfulQcWjnAXzc2C2A=="],
157
+ "@rolldown/binding-darwin-x64": ["@rolldown/binding-darwin-x64@1.2.16", "", { "os": "darwin", "cpu": "x64" }, "sha512-FdF+y48ND13eAyM2mQn+85kvAqNlvRWROy2rhgA463X/0Gv4vGtazZtfaF1mRBLscYvtOlh4QnLjOWiFzX69OQ=="],
158
158
 
159
- "@rolldown/binding-freebsd-x64": ["@rolldown/binding-freebsd-x64@1.2.15", "", { "os": "freebsd", "cpu": "x64" }, "sha512-g3l09pyFqhu+135JKkbkwiKGQmwU5hUMUPJ4VdBADvuqR8d33L6H578rh8m7rtxbdp+VmX/+nzI7nvhSZlzpUQ=="],
159
+ "@rolldown/binding-freebsd-x64": ["@rolldown/binding-freebsd-x64@1.2.16", "", { "os": "freebsd", "cpu": "x64" }, "sha512-ddjqFM5e95AgLbUPtKIS7V1KTVlA0RUgCVr5mn+/IEhsdy3pr+Vuj/HZ7nlMN2FyxIwUktOH1LEPIQXO1v9y1Q=="],
160
160
 
161
- "@rolldown/binding-linux-arm-gnueabihf": ["@rolldown/binding-linux-arm-gnueabihf@1.2.15", "", { "os": "linux", "cpu": "arm" }, "sha512-nIe3VugI97nGQtspPxDqA4sXMUpeiocKIP/CqpY/u/vgbT+alX+cVxu1C/oVBPKg4feNTmYovE91v4DgXvXNwQ=="],
161
+ "@rolldown/binding-linux-arm-gnueabihf": ["@rolldown/binding-linux-arm-gnueabihf@1.2.16", "", { "os": "linux", "cpu": "arm" }, "sha512-tHdKWbFkFBI687iim3LIyIvyL7j66VvQYkDPss5Stn/qyE2tWkR1YD0dXmXPFKKqT/o5ZEJVsaRsWS2meQwGOA=="],
162
162
 
163
- "@rolldown/binding-linux-arm64-gnu": ["@rolldown/binding-linux-arm64-gnu@1.2.15", "", { "os": "linux", "cpu": "arm64" }, "sha512-iTBjXx+B5QSvgI89lJfmqh4wTh8NabR1YZIIN3hNx4zSG0EVfVqkOvLulNpG4251pbd6/IAmZ/LefVk1Y4rPhw=="],
163
+ "@rolldown/binding-linux-arm64-gnu": ["@rolldown/binding-linux-arm64-gnu@1.2.16", "", { "os": "linux", "cpu": "arm64" }, "sha512-FJiLGAblPBMlBEdbOqw6kW6QcXDWAf/oJu7gYs9ZJZwmg+K+/zjFLxPTIY9izJUzxzc24FHvmseyA0IvJSl17w=="],
164
164
 
165
- "@rolldown/binding-linux-arm64-musl": ["@rolldown/binding-linux-arm64-musl@1.2.15", "", { "os": "linux", "cpu": "arm64" }, "sha512-uN26XOnVR7rqQupG3V9oAG2EGGatWjcJHOeDOHUFCh4TBWmP2tHTFoVN13aYbwfm0aHqJAEmcwhAu6sooIjfqQ=="],
165
+ "@rolldown/binding-linux-arm64-musl": ["@rolldown/binding-linux-arm64-musl@1.2.16", "", { "os": "linux", "cpu": "arm64" }, "sha512-hrJpblMsrQ58U9veWpbXzkhV5zStunds6HWLprqq1qauvgBr1E6P+24kLj6lSLI9vjRn/RYpjprhkHQPKGWpNg=="],
166
166
 
167
- "@rolldown/binding-linux-ppc64-gnu": ["@rolldown/binding-linux-ppc64-gnu@1.2.15", "", { "os": "linux", "cpu": "ppc64" }, "sha512-9nWkcdd+H+XhaA3fQIwpHnKIrfx/PQ6rO0pivr78Og07tXlUlctBBJoEYLPfhTmCR/QxEVdn6uPjHV5SymPhdw=="],
167
+ "@rolldown/binding-linux-ppc64-gnu": ["@rolldown/binding-linux-ppc64-gnu@1.2.16", "", { "os": "linux", "cpu": "ppc64" }, "sha512-qJd/dC6j6CwLG9/s/RP2nb1RZ0GIgj7Ioj7x/SYa3RzjVrlzrmH0fhIOpfvqQDeIsdP0loi+kHaMhJzY1PBIaA=="],
168
168
 
169
- "@rolldown/binding-linux-s390x-gnu": ["@rolldown/binding-linux-s390x-gnu@1.2.15", "", { "os": "linux", "cpu": "s390x" }, "sha512-Ggh0ciFjLwIusLSLz7LZYEaGdxOAUJXI+Qu5JCbhPJJHEt8vP+IjRATTJheiJsdzzTYgUiHUiw3X1Ea3ZpMBdA=="],
169
+ "@rolldown/binding-linux-s390x-gnu": ["@rolldown/binding-linux-s390x-gnu@1.2.16", "", { "os": "linux", "cpu": "s390x" }, "sha512-Vx7Xg5uUJuNcujJjI70OICaH0EYj80BtOLZTSN7uOYg8QOLlyKnaG0IW7Fn/J0IpJsaKzmDKMhOQv1JBM9m9vg=="],
170
170
 
171
- "@rolldown/binding-linux-x64-gnu": ["@rolldown/binding-linux-x64-gnu@1.2.15", "", { "os": "linux", "cpu": "x64" }, "sha512-FHg60rS6DBePAYZ9X9F67x+JObFdmgn6tupA1C/a3B+CufFmTD4mX+e8M75tCiAO3foR/6xwVBI0KQiI7sn/rw=="],
171
+ "@rolldown/binding-linux-x64-gnu": ["@rolldown/binding-linux-x64-gnu@1.2.16", "", { "os": "linux", "cpu": "x64" }, "sha512-TNKhgE3uJTsTzatUSSYt0Kgo+Oa2uSlSjz4r1aEIea7HX6ULBym4fAlYUhG1i6pjNf2njfCUAfKwr6C3E9Xg1w=="],
172
172
 
173
- "@rolldown/binding-linux-x64-musl": ["@rolldown/binding-linux-x64-musl@1.2.15", "", { "os": "linux", "cpu": "x64" }, "sha512-/cvV/7v5VGz/moiz0XKRj2dE8DzsKyhIu1KpOvJGPjRywg3yscON889UGvAe8zfiJLHup7VLjBduoGWi3HusWQ=="],
173
+ "@rolldown/binding-linux-x64-musl": ["@rolldown/binding-linux-x64-musl@1.2.16", "", { "os": "linux", "cpu": "x64" }, "sha512-7chXdpjXZ8qG0+mIxECN3cT9kvhZ3/oZhMX6Pp876P7CDrIy8nJswva6Mq357JR7eYXfuskwZxMeV1SzoZdHrA=="],
174
174
 
175
- "@rolldown/binding-openharmony-arm64": ["@rolldown/binding-openharmony-arm64@1.2.15", "", { "os": "none", "cpu": "arm64" }, "sha512-MyzC5Hrv/sm+Z7TSGKP/j8001RO2xQm1zOpCNVL4j0cY/VhBZviludA2YFQ7i4lH6ZAXxQm0lcMdBzM+99mE7w=="],
175
+ "@rolldown/binding-openharmony-arm64": ["@rolldown/binding-openharmony-arm64@1.2.16", "", { "os": "none", "cpu": "arm64" }, "sha512-Kwjt+7uNTJK5/MDkGWGVO2KQPnj8yAV75dMpfwyHZrJSXWHrniOB0aUEWlVYf3H1hOqFLIStLdM5QXq6bnKmOQ=="],
176
176
 
177
- "@rolldown/binding-win32-arm64-msvc": ["@rolldown/binding-win32-arm64-msvc@1.2.15", "", { "os": "win32", "cpu": "arm64" }, "sha512-+PgYiS+AH5omy6L45ZLxybasauJaj3M8buoT83D+nzPmCayXlxUV9hydhciCKVyIg0B/v0BtXPDE1uGqNwCPpg=="],
177
+ "@rolldown/binding-win32-arm64-msvc": ["@rolldown/binding-win32-arm64-msvc@1.2.16", "", { "os": "win32", "cpu": "arm64" }, "sha512-/LH6WfjDRXXJz/p5xl4TmU+jpcnwcxbKEQBW/GZE0JHfN0lGIyTtsUEGaQ/q/GikkGJ2yLKe6pwm7AnEWO8pdw=="],
178
178
 
179
- "@rolldown/binding-win32-x64-msvc": ["@rolldown/binding-win32-x64-msvc@1.2.15", "", { "os": "win32", "cpu": "x64" }, "sha512-HFZd2QNQYn1JbIi+Hpd7H+r/lkWxcfIu28nirZ6eCn2LafuvmExMlb/P96Sfx5tf7pPArw39IdhmCF8vmV+NhQ=="],
179
+ "@rolldown/binding-win32-x64-msvc": ["@rolldown/binding-win32-x64-msvc@1.2.16", "", { "os": "win32", "cpu": "x64" }, "sha512-1lv1KvX0Z871zfk7vw+dnXMMnHNyDwMzWG8Kv3HxDXMOhzCX4SHc7HK319fInP0i+0p9D8brkfzL7pJOaGl+tw=="],
180
180
 
181
181
  "@rolldown/pluginutils": ["@rolldown/pluginutils@1.0.1", "", {}, "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw=="],
182
182
 
@@ -196,9 +196,9 @@
196
196
 
197
197
  "@squadbase/react": ["@squadbase/react@0.1.0", "", { "dependencies": { "zod": "^4.3.6" }, "peerDependencies": { "@types/react": "17.x || 18.x || 19.x", "react": "17.x || 18.x || 19.x" }, "optionalPeers": ["@types/react"] }, "sha512-k+Dpyj7eH+Yjydw54iEluCjYDae086d12hWgBjNMpw4wLbQGz3CrJ6Yipodg8n1cKUt7zvwddlcTHd79bgKsXg=="],
198
198
 
199
- "@squadbase/vantage": ["@squadbase/vantage@0.6.2-dev1.54bde93", "", { "dependencies": { "@base-ui/react": "^1.6.0", "@hono/node-server": "^2.1.5", "@streamdown/code": "^1.1.1", "@tailwindcss/vite": "^4.3.3", "@tanstack/react-query": "^5.101.2", "@tanstack/react-router": "^1.170.17", "@tanstack/react-table": "^8.21.3", "@vitejs/plugin-react": "^6.1.2", "class-variance-authority": "^0.7.1", "clsx": "^2.1.1", "cmdk": "^1.1.1", "date-fns": "^4.1.0", "echarts": "^6.0.0", "esbuild": "0.28.1", "fflate": "^0.8.3", "hono": "^4.13.13", "html-to-image": "^1.11.13", "lucide-react": "^0.468.0", "papaparse": "^5.7.0", "picocolors": "^1.1.1", "react-day-picker": "^10.0.1", "read-excel-file": "^9.3.10", "shiki": "3.23.0", "streamdown": "^2.5.0", "tailwind-merge": "3.6.0", "tailwindcss": "^4.3.3", "tw-animate-css": "^1.0.0", "vite": "^8.3.4" }, "peerDependencies": { "react": ">=18.2.0", "react-dom": ">=18.2.0", "typescript": ">=5.0.0" }, "optionalPeers": ["typescript"], "bin": { "vantage": "dist/cli.js" } }, "sha512-SdKYzwfYmB6wnYZB3E2sMEFAJPNKs8+n665ag1aJKIQUgauM6SgRwtPWVUqvbDtYJhJDW/bSEslZkZhnHLCRgg=="],
199
+ "@squadbase/vantage": ["@squadbase/vantage@0.6.2-dev1.56da87f", "", { "dependencies": { "@base-ui/react": "^1.6.0", "@hono/node-server": "^2.1.5", "@streamdown/code": "^1.1.1", "@tailwindcss/vite": "^4.3.3", "@tanstack/react-query": "^5.101.2", "@tanstack/react-router": "^1.170.17", "@tanstack/react-table": "^8.21.3", "@vitejs/plugin-react": "^6.1.2", "class-variance-authority": "^0.7.1", "clsx": "^2.1.1", "cmdk": "^1.1.1", "date-fns": "^4.1.0", "echarts": "^6.0.0", "esbuild": "0.28.1", "fflate": "^0.8.3", "hono": "^4.13.13", "html-to-image": "^1.11.13", "lucide-react": "^0.468.0", "papaparse": "^5.7.0", "picocolors": "^1.1.1", "react-day-picker": "^10.0.1", "read-excel-file": "^9.3.10", "shiki": "3.23.0", "streamdown": "^2.5.0", "tailwind-merge": "3.6.0", "tailwindcss": "^4.3.3", "tw-animate-css": "^1.0.0", "vite": "^8.3.4" }, "peerDependencies": { "react": ">=18.2.0", "react-dom": ">=18.2.0", "typescript": ">=5.0.0" }, "optionalPeers": ["typescript"], "bin": { "vantage": "dist/cli.js" } }, "sha512-74eDmo67JnvAsdb/++5hh3xYbOO8DwpzSF4ouw+12DmDkxInnEr12ElCtOJuzdlDfa6x99LN/rjNDdC9xZifrQ=="],
200
200
 
201
- "@squadbase/vantage-sdk": ["@squadbase/vantage-sdk@0.1.1-dev1.fae2870", "", {}, "sha512-2f0UjNsMum6wvQXWOzmUJ4gPzv5Zzv7O14p+G5l1OMvDVyUvwSSMBzRAeS9KFPJJjpsPCV9OUbm6r/zgdI0Uow=="],
201
+ "@squadbase/vantage-sdk": ["@squadbase/vantage-sdk@0.1.1-dev1.2bfcfab", "", {}, "sha512-FO8AFtS+qhnVaMDEDh8z7J9AFfDhkyytzQUUDV5ZJvI9rKtbaDR/Tq9IX9m3R2USml61u66oIuLG2CNg0KiwMw=="],
202
202
 
203
203
  "@streamdown/code": ["@streamdown/code@1.1.1", "", { "dependencies": { "shiki": "^3.19.0" }, "peerDependencies": { "react": "^18.0.0 || ^19.0.0" } }, "sha512-i7HTNuDgZWb+VdrNVOam9gQhIc5MSSDXKWXgbUrn/4vSRaSMM+Rtl10MQj4wLWPNpF7p80waJsAqFP8HZfb0Jg=="],
204
204
 
@@ -512,7 +512,7 @@
512
512
 
513
513
  "hastscript": ["hastscript@9.0.1", "", { "dependencies": { "@types/hast": "^3.0.0", "comma-separated-tokens": "^2.0.0", "hast-util-parse-selector": "^4.0.0", "property-information": "^7.0.0", "space-separated-tokens": "^2.0.0" } }, "sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w=="],
514
514
 
515
- "hono": ["hono@4.13.13", "", {}, "sha512-CQ46U0ZkAGmbT/4UxdzzGJpacP2IeKgY4a5/tOI9AABbpOMfK739wfDXmv1usCk+3RkKj1hQy4/fjhiwa2xlrA=="],
515
+ "hono": ["hono@4.13.14", "", {}, "sha512-yhRLQ21U6qa9Hsu2N7Qcbh8tE+WKEcoErjIo56LeSGiGXGp9sA7UpE86Ui9uexb61KakiGwuHMn2QdV7w6i6kQ=="],
516
516
 
517
517
  "html-to-image": ["html-to-image@1.11.13", "", {}, "sha512-cuOPoI7WApyhBElTTb9oqsawRvZ0rHhaHwghRLlTuffoD1B2aDemlCruLeZrUIIdvG7gs9xeELEPm6PhuASqrg=="],
518
518
 
@@ -700,7 +700,7 @@
700
700
 
701
701
  "points-on-path": ["points-on-path@0.2.1", "", { "dependencies": { "path-data-parser": "0.1.0", "points-on-curve": "0.2.0" } }, "sha512-25ClnWWuw7JbWZcgqY/gJ4FQWadKxGWk+3kR/7kD0tCaDtPPMj7oHu2ToLaVhfpnHrZzYby2w6tUA0eOIuUg8g=="],
702
702
 
703
- "postcss": ["postcss@8.5.31", "", { "dependencies": { "nanoid": "^3.3.20", "picocolors": "^1.1.1", "source-map-js": "^1.2.2" } }, "sha512-YUbWYCgErwnMAVkjUnYa+KlMBzGpHwiIt/DE7f0G33AuX2LH9UcTk6KgWxd3zRU+pN3u/C+Xl3EnMLM4Hea7Sg=="],
703
+ "postcss": ["postcss@8.5.32", "", { "dependencies": { "nanoid": "^3.3.20", "picocolors": "^1.1.1", "source-map-js": "^1.2.2" } }, "sha512-LJlKCCAUFKOuZxipUdYw1NzIITEsPcgyOG9LkvRJvuKj/bRzbuRY0ARXvL0pWGpsZvn8jku+LMep2eU0seHp8g=="],
704
704
 
705
705
  "property-information": ["property-information@7.2.0", "", {}, "sha512-IAtzIB6sUiWaJYrX9smp3V46pBGbBeLFRGdh25kg1334VcBlD8HzhPeNIWQH9zhGmo2itIe25EHt9dQP7G5hmg=="],
706
706
 
@@ -716,7 +716,7 @@
716
716
 
717
717
  "react-style-singleton": ["react-style-singleton@2.2.3", "", { "dependencies": { "get-nonce": "^1.0.0", "tslib": "^2.0.0" }, "peerDependencies": { "@types/react": "*", "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react"] }, "sha512-b6jSvxvVnyptAiLjbkWLE/lOnR4lfTtDAl+eUC7RZy+QQWc6wRzIV2CE6xBuMmDxc2qIihtDCZD5NPOFl7fRBQ=="],
718
718
 
719
- "read-excel-file": ["read-excel-file@9.3.12", "", { "dependencies": { "fflate": "^0.8.3", "saxen": "^11.1.0", "unzipper-esm": "^0.13.3", "worker-f": "^0.1.12" } }, "sha512-benNAoQbe5HqoTi3qrQkR8wMeHq0gVWLt2Br73hVvmBPGdzMf9OLGsps/812AfZ+bvzVYsUyhF77Y3o4B51yCA=="],
719
+ "read-excel-file": ["read-excel-file@9.3.14", "", { "dependencies": { "fflate": "^0.8.3", "saxen": "^11.1.0", "unzipper-esm": "^0.13.3", "worker-f": "^0.1.12" } }, "sha512-rfEpNMthm/REIpSCLnGTrQD5aW+U9rrhFuGYF+XRO8Soz+7b+rAOW1z2vJbNiEINbFPbjRW16vz0KnX41Si9qw=="],
720
720
 
721
721
  "regex": ["regex@6.1.0", "", { "dependencies": { "regex-utilities": "^2.3.0" } }, "sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg=="],
722
722
 
@@ -744,7 +744,7 @@
744
744
 
745
745
  "robust-predicates": ["robust-predicates@3.0.3", "", {}, "sha512-NS3levdsRIUOmiJ8FZWCP7LG3QpJyrs/TE0Zpf1yvZu8cAJJ6QMW92H1c7kWpdIHo8RvmLxN/o2JXTKHp74lUA=="],
746
746
 
747
- "rolldown": ["rolldown@1.2.15", "", { "dependencies": { "@oxc-project/types": "=0.155.0", "@rolldown/pluginutils": "^1.0.0" }, "optionalDependencies": { "@rolldown/binding-android-arm-eabi": "1.2.15", "@rolldown/binding-android-arm64": "1.2.15", "@rolldown/binding-darwin-arm64": "1.2.15", "@rolldown/binding-darwin-x64": "1.2.15", "@rolldown/binding-freebsd-x64": "1.2.15", "@rolldown/binding-linux-arm-gnueabihf": "1.2.15", "@rolldown/binding-linux-arm64-gnu": "1.2.15", "@rolldown/binding-linux-arm64-musl": "1.2.15", "@rolldown/binding-linux-ppc64-gnu": "1.2.15", "@rolldown/binding-linux-s390x-gnu": "1.2.15", "@rolldown/binding-linux-x64-gnu": "1.2.15", "@rolldown/binding-linux-x64-musl": "1.2.15", "@rolldown/binding-openharmony-arm64": "1.2.15", "@rolldown/binding-win32-arm64-msvc": "1.2.15", "@rolldown/binding-win32-x64-msvc": "1.2.15" }, "bin": { "rolldown": "./bin/cli.mjs" } }, "sha512-6odND+fel5zVw3I4Yc2e69gvguDnX0CAAGiNDZSq4ik5WUcaLrkD2GLuog0XcODbor31hZ5ayEMgVDno+KPV5g=="],
747
+ "rolldown": ["rolldown@1.2.16", "", { "dependencies": { "@oxc-project/types": "=0.156.0", "@rolldown/pluginutils": "^1.0.0" }, "optionalDependencies": { "@rolldown/binding-android-arm-eabi": "1.2.16", "@rolldown/binding-android-arm64": "1.2.16", "@rolldown/binding-darwin-arm64": "1.2.16", "@rolldown/binding-darwin-x64": "1.2.16", "@rolldown/binding-freebsd-x64": "1.2.16", "@rolldown/binding-linux-arm-gnueabihf": "1.2.16", "@rolldown/binding-linux-arm64-gnu": "1.2.16", "@rolldown/binding-linux-arm64-musl": "1.2.16", "@rolldown/binding-linux-ppc64-gnu": "1.2.16", "@rolldown/binding-linux-s390x-gnu": "1.2.16", "@rolldown/binding-linux-x64-gnu": "1.2.16", "@rolldown/binding-linux-x64-musl": "1.2.16", "@rolldown/binding-openharmony-arm64": "1.2.16", "@rolldown/binding-win32-arm64-msvc": "1.2.16", "@rolldown/binding-win32-x64-msvc": "1.2.16" }, "bin": { "rolldown": "./bin/cli.mjs" } }, "sha512-bWvlMpFKiTfDKfnK7FC2MPgPeWCf/Kpwsq49ApdW+FQaBZb6O6dZ4MAPbPUjp7hYQrw/RobqCzn64BRrQecGHw=="],
748
748
 
749
749
  "roughjs": ["roughjs@4.6.6", "", { "dependencies": { "hachure-fill": "^0.5.2", "path-data-parser": "^0.1.0", "points-on-curve": "^0.2.0", "points-on-path": "^0.2.1" } }, "sha512-ZUz/69+SYpFN/g/lUlo2FXcIjRkSu3nDarreVdGGndHEBJ6cXPdKguS8JGxwj5HA5xIbVKSmLgr5b3AWxtRfvQ=="],
750
750
 
@@ -834,7 +834,7 @@
834
834
 
835
835
  "web-namespaces": ["web-namespaces@2.0.1", "", {}, "sha512-bKr1DkiNa2krS7qxNtdrtHAmzuYGFQLiQ13TsorsdT6ULTkPLKuu5+GsFpDlg6JFjUTwX2DyhMPG2be8uPrqsQ=="],
836
836
 
837
- "worker-f": ["worker-f@0.1.20", "", {}, "sha512-7z5K5z4x++FykhpDTfriT/dOu7CmSap9BBv38DVFU3CD38obopq+DoFH75yBV3butpGm+OeqR9BKdSvYJSnUfQ=="],
837
+ "worker-f": ["worker-f@0.1.21", "", {}, "sha512-pMi7wCz3uZVxRvRSphyaIYoN7rm9bV0usifTib7u01kKU+hOo+/hFwhajYnpOCHyr0Xp3/2ulc4F+Jm2a3YIfg=="],
838
838
 
839
839
  "zod": ["zod@4.4.3", "", {}, "sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ=="],
840
840
 
package/base-template/package.json CHANGED
@@ -12,8 +12,8 @@
12
12
  },
13
13
  "dependencies": {
14
14
  "@squadbase/react": "^0.1.0",
15
- "@squadbase/vantage": "0.6.2-dev1.54bde93",
16
- "@squadbase/vantage-sdk": "0.1.1-dev1.fae2870",
15
+ "@squadbase/vantage": "0.6.2-dev1.56da87f",
16
+ "@squadbase/vantage-sdk": "0.1.1-dev1.2bfcfab",
17
17
  "date-fns": "^4.1.0",
18
18
  "lucide-react": "^0.468.0",
19
19
  "react": "^19.3.1",
package/base-template/src/components/user-card.tsx CHANGED
@@ -57,7 +57,7 @@ function DetailRow({ label, children }: { label: string; children: React.ReactNo
57
57
 
58
58
  function UserInfo({ user }: { user: User }) {
59
59
  const fullName = `${user.firstName} ${user.lastName}`
60
- const rolesHref = navigator.language.startsWith("ja")
60
+ const rolesHref = document.documentElement.lang.startsWith("ja")
61
61
  ? "https://www.squadbase.dev/ja/docs/access-control#プロジェクトロール"
62
62
  : "https://www.squadbase.dev/docs/access-control#project-roles"
63
63
 
package/base-template/src/index.tsx CHANGED
@@ -68,7 +68,7 @@ const CHARTS = [
68
68
  export default function HomePage() {
69
69
  // `data-vantage-sample` marks this page as the untouched template sample (the coding
70
70
  // agent looks for it). Remove it together with the sample content.
71
- const sampleNote = navigator.language.startsWith("ja")
71
+ const sampleNote = document.documentElement.lang.startsWith("ja")
72
72
  ? "サンプルデータです。お手元のデータに置き換えて始めましょう。"
73
73
  : "Sample data — replace with your own to get started."
74
74
 
package/dist/index.js CHANGED
@@ -1146,8 +1146,8 @@ var buildThemeCss = (cssVars) => [
1146
1146
  var THEME_PRESETS_DATA = [
1147
1147
  {
1148
1148
  "id": "neutral",
1149
- "title": "\u30CB\u30E5\u30FC\u30C8\u30E9\u30EB",
1150
- "description": "\u65E2\u5B9A\u306E\u30CB\u30E5\u30FC\u30C8\u30E9\u30EB\u306B\u623B\u3059\u30D7\u30EA\u30BB\u30C3\u30C8\u3002\u57FA\u5E95\u306E theme \u3068\u540C\u3058\u5024\u3067\u3001\u30D7\u30EA\u30BB\u30C3\u30C8\u3092\u5207\u308A\u66FF\u3048\u308B\u3068\u304D\u306E\u8D77\u70B9\u306B\u3059\u308B\u3002",
1149
+ "title": "Neutral",
1150
+ "description": "A preset that restores the default neutral theme. It has the same values as the base theme and is the starting point when switching presets.",
1151
1151
  "cssVars": {
1152
1152
  "light": {
1153
1153
  "radius": "0.5rem",
@@ -1253,8 +1253,8 @@ var THEME_PRESETS_DATA = [
1253
1253
  },
1254
1254
  {
1255
1255
  "id": "ocean",
1256
- "title": "\u30AA\u30FC\u30B7\u30E3\u30F3",
1257
- "description": "\u9752\u3092\u57FA\u8ABF\u306B\u3057\u305F\u30D7\u30EA\u30BB\u30C3\u30C8\u3002\u843D\u3061\u7740\u3044\u305F\u4FE1\u983C\u611F\u306E\u3042\u308B\u914D\u8272\u3067\u3001\u89D2\u4E38\u306F\u6A19\u6E96\u3088\u308A\u5C0F\u3055\u3081\u306E\u3084\u3084\u89D2\u3070\u3063\u305F\u5370\u8C61\u3002",
1256
+ "title": "Ocean",
1257
+ "description": "A blue preset with a calm, trustworthy palette and slightly smaller, squarer corners than the default.",
1258
1258
  "cssVars": {
1259
1259
  "light": {
1260
1260
  "radius": "0.375rem",
@@ -1360,8 +1360,8 @@ var THEME_PRESETS_DATA = [
1360
1360
  },
1361
1361
  {
1362
1362
  "id": "forest",
1363
- "title": "\u30D5\u30A9\u30EC\u30B9\u30C8",
1364
- "description": "\u7DD1\u3092\u57FA\u8ABF\u306B\u3057\u305F\u30D7\u30EA\u30BB\u30C3\u30C8\u3002\u89D2\u4E38\u306F\u3084\u3084\u5C0F\u3055\u3081\u3002\u66F8\u4F53\u306F\u4E38\u30B4\u30B7\u30C3\u30AF\u7CFB\uFF08Safari \u306E ui-rounded\u3001macOS / iOS \u306E\u30D2\u30E9\u30AE\u30CE\u4E38\u30B4\u3002\u307B\u304B\u306E\u74B0\u5883\u306F\u6A19\u6E96\u306E\u66F8\u4F53\uFF09\u3002",
1363
+ "title": "Forest",
1364
+ "description": "A green preset with slightly smaller corners. The font is a rounded sans-serif (ui-rounded in Safari, Hiragino Maru Gothic on macOS and iOS, the default font elsewhere).",
1365
1365
  "cssVars": {
1366
1366
  "light": {
1367
1367
  "radius": "0.5rem",
@@ -1467,8 +1467,8 @@ var THEME_PRESETS_DATA = [
1467
1467
  },
1468
1468
  {
1469
1469
  "id": "sunset",
1470
- "title": "\u30B5\u30F3\u30BB\u30C3\u30C8",
1471
- "description": "\u6A59\u3092\u57FA\u8ABF\u306B\u3057\u305F\u30D7\u30EA\u30BB\u30C3\u30C8\u3002\u6E29\u304B\u307F\u306E\u3042\u308B\u914D\u8272\u3067\u3001\u89D2\u4E38\u306F\u3084\u3084\u5927\u304D\u3081\u3002",
1470
+ "title": "Sunset",
1471
+ "description": "An orange preset with a warm palette and slightly larger corners.",
1472
1472
  "cssVars": {
1473
1473
  "light": {
1474
1474
  "radius": "0.75rem",
@@ -1574,8 +1574,8 @@ var THEME_PRESETS_DATA = [
1574
1574
  },
1575
1575
  {
1576
1576
  "id": "violet",
1577
- "title": "\u30D0\u30A4\u30AA\u30EC\u30C3\u30C8",
1578
- "description": "\u7D2B\u3092\u57FA\u8ABF\u306B\u3057\u305F\u30D7\u30EA\u30BB\u30C3\u30C8\u3002\u89D2\u4E38\u306F\u5927\u304D\u3081\u3067\u3084\u308F\u3089\u304B\u3044\u5370\u8C61\u3002",
1577
+ "title": "Violet",
1578
+ "description": "A purple preset with large, soft corners.",
1579
1579
  "cssVars": {
1580
1580
  "light": {
1581
1581
  "radius": "0.875rem",
@@ -1681,8 +1681,8 @@ var THEME_PRESETS_DATA = [
1681
1681
  },
1682
1682
  {
1683
1683
  "id": "rose",
1684
- "title": "\u30ED\u30FC\u30BA",
1685
- "description": "\u8D64\u7D2B\u304B\u3089\u30D4\u30F3\u30AF\u3092\u57FA\u8ABF\u306B\u3057\u305F\u30D7\u30EA\u30BB\u30C3\u30C8\u3002destructive \u306E\u8D64\u3068\u6DF7\u540C\u3057\u306A\u3044\u843D\u3061\u7740\u3044\u305F\u8272\u3067\u3001\u89D2\u4E38\u306F\u5927\u304D\u3081\u3002",
1684
+ "title": "Rose",
1685
+ "description": "A magenta-to-pink preset in muted tones that don't read as the destructive red, with large corners.",
1686
1686
  "cssVars": {
1687
1687
  "light": {
1688
1688
  "radius": "1rem",
@@ -1788,8 +1788,8 @@ var THEME_PRESETS_DATA = [
1788
1788
  },
1789
1789
  {
1790
1790
  "id": "mono",
1791
- "title": "\u30E2\u30CE",
1792
- "description": "\u7121\u5F69\u8272\u5BC4\u308A\u306E\u30D7\u30EA\u30BB\u30C3\u30C8\u3002\u30C1\u30E3\u30FC\u30C8\u3082\u5F69\u5EA6\u3092\u6291\u3048\u3001\u89D2\u4E38\u306F\u6700\u5C0F\u3002\u66F8\u4F53\u306F\u7B49\u5E45\uFF08\u30B7\u30B9\u30C6\u30E0\u306E\u7B49\u5E45\u30D5\u30A9\u30F3\u30C8\uFF09\u3002",
1791
+ "title": "Mono",
1792
+ "description": "A near-grayscale preset with muted chart colors, the smallest corners and a monospace font (the system monospace font).",
1793
1793
  "cssVars": {
1794
1794
  "light": {
1795
1795
  "radius": "0.25rem",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@squadbase/vantage-template",
3
- "version": "0.1.1-dev1.a9ae1fa",
3
+ "version": "0.1.1-dev1.a9fd8f6",
4
4
  "description": "CLI tool for initializing and customizing Squadbase Vantage projects.",
5
5
  "keywords": [
6
6
  "squadbase",
@@ -50,7 +50,7 @@
50
50
  "@ai-sdk/openai": "2.0.122",
51
51
  "ai": "^5.0.52"
52
52
  },
53
- "gitHead": "a9ae1fa8b13ee4771359594a6477b8b19c4ae66d",
53
+ "gitHead": "a9fd8f61191ebc423d58cd1537d3f5c1fd6f8f23",
54
54
  "scripts": {
55
55
  "sync-base": "rsync -a --delete --exclude='node_modules' --exclude='dist' --exclude='.vantage' --exclude='*.tsbuildinfo' --exclude='*.log' template/ base-template/ && mv base-template/.gitignore base-template/_gitignore",
56
56
  "build": "pnpm run sync-base && tsup",
package/base-template/DESIGN.md DELETED
@@ -1,109 +0,0 @@
1
- <!--
2
- DESIGN.md — このアプリの「見た目の意図」を書くファイルです。
3
-
4
- - 実際の色・角丸・書体の値は src/styles.css にあります。ここにはトークン名(--primary など)と
5
- 使い分けのルールだけを書き、色コードは書きません。
6
- - エージェントはページ・スライド・コンポーネントを書く前にこのファイルを読みます。
7
- 会話の中での指示はこのファイルより優先されます。
8
- - 「このサイトに合わせて」「色を落ち着いた感じに」と頼めば、このファイルと styles.css を
9
- まとめて更新します。
10
- - このファイルはあなたのものです。`vantage upgrade` が書き換えることはありません。
11
- -->
12
-
13
- # デザイン
14
-
15
- ## 全体のトーン (Overview)
16
-
17
- - 落ち着いた無彩色のベースに、データだけが色を持つ業務ダッシュボード。
18
- - 装飾より読みやすさを優先する。影・グラデーション・アニメーションは最小限。
19
- - 数字が主役。1 画面で伝えたいことを 1 つに絞り、補足は小さく添える。
20
- - ブランド素材: なし(ロゴを使う場合は `public/brand/logo.svg` のように `public/` 配下のパスで書く)
21
-
22
- ## 色 (Colors)
23
-
24
- 色は必ずトークン(Tailwind のセマンティッククラス)で指定する。素のパレット(`bg-blue-600` など)や
25
- 色コードを直接書かない。
26
-
27
- | 役割 | トークン | 使う場所 |
28
- | --- | --- | --- |
29
- | 主色 (Primary) | `--primary` / `--primary-foreground` | 主要ボタン、選択中の状態。既定(テーマ `neutral`)は青 |
30
- | 強調 (Accent) | `--chart-1` | 1 つだけ目立たせたい数値・系列・リンク的な強調 |
31
- | 良い (Positive) | `--chart-2` | 前期比のプラスなど、良い変化の小さな印 |
32
- | 悪い (Negative) | `--destructive` | 前期比のマイナス、エラー、削除操作 |
33
- | 注意 (Warning) | 専用トークンなし | 文言とアイコンで示し、色は `--muted-foreground` |
34
- | 背景の段階 | `--background` → `--card` → `--muted` | ページ → カード → カード内の区画・ホバー |
35
- | 境界 | `--border` / `--input` / `--ring` | 罫線、入力欄、フォーカス |
36
- | 文字 | `--foreground` / `--muted-foreground` | 本文 / 補足・ラベル・単位 |
37
-
38
- - `--muted`・`--accent`・`--secondary`・`--border` は背景・境界用。文字色に使わない。
39
- - 増減(▲▼・前期比)は向きで色を分ける: 増加・プラスは `--chart-2`(または `--primary`)、
40
- 減少・マイナスは `--destructive`。下向きの矢印やマイナスを `--primary` で塗らない。
41
- - ライトとダークの両方がトークンで決まるので `dark:` を並べない。
42
-
43
- ## チャート (Charts)
44
-
45
- - 系列の順番は `--chart-1` → `--chart-2` → `--chart-3` → `--chart-4` → `--chart-5`
46
- (現在はテーマ `neutral`: 青 → 黄緑 → 赤紫 → ティール → 紫)。
47
- - 1 系列だけを目立たせるときは、その系列を `--chart-1`、残りをすべて `--chart-5` にする。
48
- - 良い / 悪いを色で塗り分けるときは `--chart-2` / `--destructive`。色だけに頼らず ▲▼ や符号も添える。
49
- - 系列は 5 つまで。それ以上はグループ化するか「その他」にまとめる。
50
- - 禁止: 同じチャートで `--destructive` を普通の系列色として使う(悪い値に見える)。
51
- - 禁止: 隣り合う系列に `--chart-3` と `--chart-4` を並べて細い線で描く(見分けにくい)。
52
- - 配色を丸ごと変えるときは `npx @squadbase/vantage-template theme <id>` を使う
53
- (`neutral` / `ocean` / `forest` / `sunset` / `violet` / `rose` / `mono`)。チャートだけ別の配色にするときは
54
- `chart <preset>`(`blue` / `ocean` / `sunset` / `forest` / `berry` / `mono`)。
55
-
56
- ## 書体 (Typography)
57
-
58
- | 用途 | 指定 | 備考 |
59
- | --- | --- | --- |
60
- | 見出し・本文 | 日本語を含むシステムフォント(`--font-sans`) | Web フォントは使わない |
61
- | 数字 | 同上 + `tabular-nums` | 桁がそろうように必ず付ける |
62
- | スライドの見出し | `--slide-font-display` | 既定は日本語を含むシステムフォント |
63
- | スライドの本文 | `--slide-font-body` | 既定は見出しと同じ |
64
-
65
- サイズの段階(ダッシュボード):
66
-
67
- - ページ見出し: `text-2xl font-bold`
68
- - カード見出し・ラベル: `text-sm font-medium text-muted-foreground`
69
- - KPI の数値: `text-3xl font-semibold tabular-nums`
70
- - 本文・表: `text-sm`
71
- - 注釈・出典: `text-xs text-muted-foreground`
72
-
73
- スライドのサイズは `--slide-size-hero`(表紙・大きな数字)と `--slide-size-body`(本文)を基準にする。
74
-
75
- ## レイアウトと密度 (Layout)
76
-
77
- - 情報はカード(`bg-card` + `border-border`)で区切る。角丸は `--radius` に従う(個別に変えない)。
78
- - グリッドの間隔は `gap-4`。セクション間は `gap-6` 程度。
79
- - KPI は 1 行に 2〜4 枚。その下にチャート、最後に明細の表。
80
- - 密度は「中」。余白を削って詰め込むより、ページを分ける。
81
-
82
- ## 成果物の種類ごとの規則 (Per-artifact)
83
-
84
- ### ダッシュボード
85
-
86
- - 先頭に KPI カード、次にトレンドのチャート、最後に明細の表。
87
- - 各 KPI には比較対象(前月比・目標比など)を 1 つ添える。
88
- - チャートのタイトルは結論を書く(「売上推移」より「売上は 3 か月連続で増加」)。
89
-
90
- ### スライド
91
-
92
- - 1 枚に 1 メッセージ。見出しに結論を書く。
93
- - 色は `--slide-bg` / `--slide-fg` / `--slide-accent` / `--slide-muted` を使う
94
- (既定では `--background` / `--foreground` / `--primary` / `--muted-foreground` に連動)。
95
- - 強調色は 1 枚につき 1 か所まで。
96
-
97
- ## Do / Don't
98
-
99
- Do:
100
-
101
- - トークンと Tailwind のセマンティッククラスで色を指定する。
102
- - 数値には単位と比較対象を付ける。
103
- - 色の意味(良い / 悪い / 強調)をアプリ全体でそろえる。
104
-
105
- Don't:
106
-
107
- - 色コードや素のパレットクラスを直接書く。
108
- - 1 画面で強調色を何か所にも使う。
109
- - 3D チャート・円グラフの多用・装飾目的のグラデーション。