@squadbase/vantage-template 0.1.0-dev.c40b771 → 0.1.0-dev2.12326b6

package/base-template/agents/csv.md

@@ -0,0 +1,32 @@
+# csv ページ
+
+フレームワーク所有の知識ファイルで、`vantage upgrade` で再同期されます。`.csv` を
+ページとして置くときに読んでください。不変条件・ディレクトリ構造は `AGENTS.md` を
+先に読んでいる想定です。
+
+## `.csv` を置くだけでページになる
+
+**`.csv` を `src/` に置くだけで、他のページと同格のルートになります。** URL の作り方は
+`.tsx` と同じ(`src/sales-export.csv` → `/sales-export`、`index.csv` はそのディレクトリ)で、
+ナビにも `vantage routes` にも並びます。開くとフレームワーク同梱の表ビューアが描き、
+元ファイルをダウンロードできます。ビューアは**表計算ソフトの見た目**です —— 列は A / B / C、
+左に行番号、ファイルの 1 行目はヘッダとして固定。読み取り専用で、編集もソートもできません
+(セルを選んで `Cmd/Ctrl+C` でコピーは可)。
+
+- **タイトルはファイル名から導かれる**(`sales-export.csv` → 「Sales Export」)。データファイルに
+  `definePage` は書けません。名前を変えたいときはファイルをリネームします
+- **ページにしたくないファイルは `_` を前置する**(`_sales-export.csv`)。`components/`・`hooks/`・
+  `lib/` に置いたものも同じくページになりません
+- **既定はファイルをそのまま置く(tsx を書かない)。** 自分でタイトルや説明を付けたいときだけ、`_` を
+  前置してルート化を止め、tsx から描きます:
+  ```tsx
+  import { FilePageView } from "@squadbase/vantage/table"
+  import src from "./_sales-export.csv?url&no-inline"
+  export const page = definePage({ title: "売上エクスポート" })
+  export default () => <FilePageView src={src} kind="csv" fileName="sales-export.csv" />
+  ```
+- 数式・グラフ・セル書式といった概念は csv には無いので、値がそのまま読めます。ブラウザで
+  パースするので 25MB を超えるファイルはそのページにエラーが出ます —— 大きいデータは
+  `server/api/` から配って `DataTable` で描いてください
+- **ビューアの無い拡張子(`.tsv` など)はルートになりません。** `vantage check` の
+  `UNSUPPORTED_PAGE_FILE` 警告が知らせます

package/base-template/agents/doc.md

@@ -0,0 +1,73 @@
+# ドキュメント(.doc.tsx)
+
+フレームワーク所有の知識ファイルで、`vantage upgrade` で再同期されます。`.doc.tsx` で
+ドキュメントを書くときに読んでください。不変条件・ディレクトリ構造は `AGENTS.md` を
+先に読んでいる想定です。
+
+## ドキュメントは `.doc.tsx` で書く
+
+`src/june-summary.doc.tsx` → `/june-summary`。上から下へ読む文章のページで、表やチャートを
+文中に置けます。中身は `<Document>` を返す普通の React コンポーネントで、`definePage` もナビも
+通常のページと同じように効きます。
+
+```tsx
+import { definePage } from "@squadbase/vantage"
+import { EChart } from "@squadbase/vantage/components"
+import { Document } from "@squadbase/vantage/doc"
+
+export const page = definePage({ title: "6月度サマリー", navLabel: "6月度サマリー" })
+export default function JuneSummary() {
+  return (
+    <Document>
+      <h1>6月度サマリー</h1>
+      <p>6月の売上は <strong>5,250 万円</strong>で、目標を 5% 上回りました。</p>
+      <h2>週次の売上</h2>
+      <figure>
+        <EChart option={option} height={280} ariaLabel="6月の週次売上" />
+        <figcaption>第4週はキャンペーン初週</figcaption>
+      </figure>
+      <table>…</table>
+    </Document>
+  )
+}
+```
+
+## 書き方
+
+- **素の HTML 要素で書く。** `<Document>` の中の `h1`〜`h4`・`p`・`ul`/`ol`/`li`・`table`・
+  `blockquote`・`pre`/`code`・`hr`・`a`・`figure`/`figcaption`・`img` には、見出しの大きさ・余白・
+  罫線などが最初から当たっています。クラスは要りません。
+- **Tailwind のユーティリティは、その要素だけ見た目を変えたいときに使う。** 要素の既定の
+  スタイルはユーティリティより弱いので、`className` を付ければそちらが勝ちます。ドキュメント全体の
+  見た目を変えたいときはユーティリティを並べず、下の `--doc-*` を変えます。
+- **数値はコードに直接書く。** ドキュメントは書いた時点の内容を残すページです。
+  `useApiQuery` などで読み込むと、開くたびに値が変わります。
+- **チャートは `EChart`(`@squadbase/vantage/components`)を文中に置く。** `figure` で囲めば
+  `figcaption` がキャプションになります。
+- **ページ全体を包むのは `<Document>` だけ。** `PageShell` などのダッシュボード用の枠で包まない
+  (本文の幅と余白は `<Document>` が決めます)。
+
+## 見た目を変える
+
+配色・書体・本文の幅は `--doc-*` の CSS 変数です。既定値はアプリのトークンへの別名なので、
+ダークモードにもそのまま追従します。
+
+| 変数 | 既定値 | 何に効くか |
+| --- | --- | --- |
+| `--doc-fg` | `var(--foreground)` | 本文の文字色 |
+| `--doc-muted` | `var(--muted-foreground)` | 引用・キャプション |
+| `--doc-accent` | `var(--primary)` | リンク |
+| `--doc-border` | `var(--border)` | 表・`h2` の下線・引用・`hr` |
+| `--doc-subtle` | `var(--muted)` | コード・表の見出し行の背景 |
+| `--doc-font-body` / `--doc-font-heading` / `--doc-font-mono` | アプリの書体 | 本文 / 見出し / コード |
+| `--doc-size-body` | `1rem` | 本文の文字サイズ(見出しはこれに比例) |
+| `--doc-line-height` | `1.8` | 本文の行間 |
+| `--doc-max-width` | `48rem` | 本文の幅 |
+
+アプリのすべてのドキュメントに効かせるなら `styles.css` の `:root` で定義し直します。1 つの
+ドキュメントだけなら `<Document theme={{ accent: "#2563eb", maxWidth: "56rem" }}>` のように
+`theme` で渡します(`theme` のキーは変数名から `--doc-` を外してキャメルケースにしたもの)。
+
+`.doc` を付けられるのはルートになるページモジュールだけで、`_layout.doc.tsx` などは
+`INVALID_PAGE_VARIANT` エラーになります。`june.doc.tsx` と `june.tsx` は同じ URL に解決するので
+`ROUTE_CONFLICT` です。

package/base-template/agents/page.md

@@ -0,0 +1,187 @@
+# ダッシュボード / 通常ページ(.tsx)
+
+フレームワーク所有の知識ファイルで、`vantage upgrade` で再同期されます。`.tsx` の通常ページ
+(ダッシュボード)を書くときに読んでください。前提となる不変条件・ディレクトリ構造は
+`AGENTS.md` を先に読んでいる想定です。
+
+プロジェクトルートに `DESIGN.md` があれば、書き始める前に読んで配色・書体・レイアウトの規則に従う。
+
+## 最小アプリ(2 ファイル)
+
+`package.json` と `index.tsx` の 2 ファイルだけで動く。
+
+`package.json`:
+
+```json
+{
+  "name": "my-dashboard",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vantage dev",
+    "build": "vantage build",
+    "preview": "vantage preview",
+    "check": "vantage check",
+    "routes": "vantage routes"
+  },
+  "dependencies": {
+    "@squadbase/vantage": "^0.5.0",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7"
+  }
+}
+```
+
+`index.tsx`(ルートのデフォルトエクスポートが `/` ページになる):
+
+```tsx
+export default function Dashboard() {
+  return (
+    <main className="p-6">
+      <h1 className="text-2xl font-semibold">Dashboard</h1>
+    </main>
+  )
+}
+```
+
+```bash
+pnpm install
+pnpm dev      # → http://localhost:5173(HMR)
+pnpm check    # 静的診断(エラーがあれば exit 1)
+pnpm routes   # ページ/API の URL マップ
+```
+
+`server/` ディレクトリが無いので、この構成は **SPA モード**。ページを直下に置く形だが、
+`src/` を作ってその中に集めてもよい(テンプレートから始めた場合は最初から `src/` がある)。
+どちらか一方に寄せること(→ `AGENTS.md` の「ディレクトリ構造」)。
+
+## ルーティング規約(ファイル名 → ルート)
+
+ページルート(`src/` があればその中、無ければプロジェクトルート)からの相対パスが、そのまま
+URL になる。各ページは**デフォルトエクスポートの React コンポーネントが必須**(無いと
+`MISSING_DEFAULT_EXPORT`)。以下の「ファイル」列はページルートからの相対パス。
+
+| ファイル | ルート |
+| --- | --- |
+| `index.tsx` | `/` |
+| `monthly-analysis.tsx` | `/monthly-analysis` |
+| `sales/index.tsx` | `/sales` |
+| `sales/[customerId].tsx` | `/sales/:customerId`(動的パラメータ) |
+| `_layout.tsx` | そのディレクトリ配下を包むネストレイアウト(`Outlet` で子を描く) |
+| `_404.tsx` | Not Found ページ |
+| `_error.tsx` | ルートが throw したときのエラーページ |
+| `monthly-report.slide.tsx` | `/monthly-report`(スライドデッキ。詳しくは `agents/slide.md`) |
+| `sales-export.csv` | `/sales-export`(詳しくは `agents/csv.md`) |
+| `data/june.xlsx` | `/data/june`(詳しくは `agents/xlsx.md`) |
+
+`components/`・`hooks/`・`lib/`・`server/`・`public/` はどの階層でもルート走査の対象外
+(ページにならない)。それ以外のディレクトリ名は URL のセグメントになる(→ `AGENTS.md` の
+「ディレクトリ構造」)。
+
+```tsx
+import { definePage } from "@squadbase/vantage"
+
+// title は document.title、navLabel は useRoutes() で組むナビの表示名(既定は title)
+export const page = definePage({ title: "Monthly Analysis · Acme", navLabel: "Monthly" })
+
+export default function MonthlyAnalysis() {
+  return <main className="p-6">…</main>
+}
+```
+
+### ナビはルート一覧から組む
+
+`useRoutes()` がページルート一覧(スキャン順)を返すので、リンク配列を手で持たない。
+`useCurrentRoute()` は現在のルート(404 なら `undefined`)。
+
+```tsx
+import { Link, useCurrentRoute, useRoutes } from "@squadbase/vantage/router"
+
+// 動的ルートは URL が定まらないので外す。label は navLabel → title → path の順
+const routes = useRoutes().filter((r) => !r.dynamic)
+const current = useCurrentRoute()
+
+routes.map((r) => (
+  <Link key={r.path} to={r.to} activeClassName="font-semibold">
+    {r.label}
+  </Link>
+))
+```
+
+`RouteInfo`: `path`(`/sales/:id`)・`to`(`/sales/$id`)・`params`・`dynamic`・`index`・`label`・
+`title`・`description`・`navLabel`・`kind`(`"module"` | `"file"`)・`variant`(`"slide"`)。
+後ろの 2 つで、ナビをダッシュボード / スライド / データに分けたりアイコンを変えたりできます。
+
+### フィルタ状態は URL に置く
+
+リロードで消えず、URL をそのまま共有できる。`useState` と同じ形。
+
+```tsx
+import { useSearchParam, useSearchState } from "@squadbase/vantage/router"
+
+const [region, setRegion] = useSearchParam("region", "all")   // 常に string
+const [segments, setSegments] = useSearchState<string[]>("segments", []) // JSON になる値
+```
+
+デフォルト値(または `null`)を書くとキーは URL から消える。履歴は既定で `replace`
+(`{ replace: false }` で push)。
+
+### 動的パラメータの「3 つの綴り」を同期させる
+
+崩すと静かにマッチしなくなる不変条件:
+
+- ファイル名 `sales/[customerId].tsx`
+- 表示ルート `/sales/:customerId`
+- リンクトークン `to="/sales/$customerId"` + `params={{ customerId }}`
+
+```tsx
+import { Link, useParams } from "@squadbase/vantage/router"
+
+<Link to="/sales/$customerId" params={{ customerId: row.id }}>{row.name}</Link>
+
+// 詳細ページ側で取り出す
+const { customerId } = useParams()
+```
+
+## データ取得(server を持たない fetch)
+
+外部 API を叩くだけなら `server/` は不要。`@squadbase/vantage/query` の `useQuery` を使う:
+
+```tsx
+import { useQuery } from "@squadbase/vantage/query"
+import { Loading, ErrorState } from "@squadbase/vantage/ui"
+
+const q = useQuery({ queryKey: ["stats"], queryFn: () => fetch("/…").then((r) => r.json()) })
+if (q.isPending) return <Loading />
+if (q.isError) return <ErrorState message={(q.error as Error).message} />
+```
+
+`QueryClient` は Vantage が 1 つだけ管理する(staleTime 30s・retry 1・
+refetchOnWindowFocus false・networkMode "always")。挙動を変えたいときはクエリ側のオプションで
+上書きする。
+自分の `server/api` を叩くときは `useQuery` ではなく `useApiQuery`(→ `agents/api.md`)。
+
+## 組み込み UI / コンポーネントの入口
+
+- **プリミティブ**は `@squadbase/vantage/ui` から import する(`Button`・`Loading`・
+  `ErrorState`・`Empty`・`Select`・`Checkbox` ほか)。
+- **複合パーツ**は `@squadbase/vantage/components` から(`PageShell`・`DashboardCardPreset`・
+  `DataTablePreset`・`EChart` ほか)。
+- **どの名前が import 可能か / props の詳細は `vantage docs` で引く。** ガイドとコンポーネント
+  リファレンスはパッケージに同梱されていて、オフラインでも読める(→ `AGENTS.md` の
+  「ドキュメントを引く」)。**名前が分からないとき**はやりたいことで `vantage search` する
+  (→ 同節)。
+- **UI は import して使うのが既定。取り出す(eject)必要はない。** `vantage add ui|block` は
+  ソースを手元にコピーして**改造したいとき専用**のコマンドで、取り出せるのは
+  `ui: data-table` と `block: sales-overview` の 2 つだけ。それ以外の名前は import 専用で
+  `add` の対象ではない(未知名で実行すると候補が一覧表示される)。
+
+### ダークモードは opt-in
+
+ダークのトークンが効くのは、祖先に `.dark` か `[data-theme="dark"]` が付いているときだけ。
+**OS / ブラウザの設定(`prefers-color-scheme`)は見ない。** `dark:` ユーティリティも同じ
+スイッチに繋いであるので(`theme.css` の `@custom-variant dark`)、自分でクラスを付けない限り
+アプリは常にライトで描かれる ― `dark:` を書いてもそこだけダークになることはない。
+
+明暗を切り替えたいときは、レイアウトのルート要素などに `.dark` / `data-theme="dark"` を
+自分で付ける。

package/base-template/agents/slide.md

@@ -0,0 +1,41 @@
+# スライド(.slide.tsx)
+
+フレームワーク所有の知識ファイルで、`vantage upgrade` で再同期されます。`.slide.tsx` で
+スライドデッキを書くときに読んでください。不変条件・ディレクトリ構造は `AGENTS.md` を
+先に読んでいる想定です。
+
+プロジェクトルートに `DESIGN.md` があれば、書き始める前に読んで「スライド」の節と配色・書体の規則に従う。
+
+## スライドは `.slide.tsx` で書く
+
+`src/monthly-report.slide.tsx` → `/monthly-report`。中身は `<SlideDeck>` を返す普通の React
+コンポーネントで、`definePage` もナビも通常のページと同じように効きます。
+
+```tsx
+import { Slide, SlideDeck } from "@squadbase/vantage/slide"
+
+export const page = definePage({ title: "6月度レビュー", navLabel: "6月度" })
+export default function Deck() {
+  return (
+    <SlideDeck>
+      <Slide>…</Slide>
+      <Slide>…</Slide>
+    </SlideDeck>
+  )
+}
+```
+
+**`<Slide>` は `<SlideDeck>` の直接の子に書く。** `SlideDeck` は直下の `<Slide>` 要素だけを数えるので、
+`<Slide>` を自作コンポーネント(`<Slide1 />` など)や Fragment で包むと 1 枚も数えられず「1 / 0」に
+なります(`{items.map((x) => <Slide key={x.id}>…</Slide>)}` のような配列は可)。共通の部品は
+`<Slide>` の**中**に置くコンポーネントとして切り出します(`<Slide><CoverPage /></Slide>`)。
+
+1920×1080 の固定キャンバスに絶対 px で書き、画面サイズに合わせて縮小されます。キー / クリックで
+送れ、左のスライド一覧(サムネイル列)は `L` で開閉、`F` で全画面、ツールバーから pptx を
+書き出せます。**書き方の作法は同梱 Skill の
+`vantage-slide`** にあります(キャンバスの縦方向の予算、段階表示、トランジション、モーフ、
+pptx が壊れる条件)。
+
+`.slide` を付けられるのはルートになるページモジュールだけで、`_layout.slide.tsx` などは
+`INVALID_PAGE_VARIANT` エラーになります。`june.slide.tsx` と `june.tsx` は同じ URL に解決するので
+`ROUTE_CONFLICT` です。

package/base-template/agents/xlsx.md

@@ -0,0 +1,33 @@
+# xlsx ページ
+
+フレームワーク所有の知識ファイルで、`vantage upgrade` で再同期されます。`.xlsx` を
+ページとして置くときに読んでください。不変条件・ディレクトリ構造は `AGENTS.md` を
+先に読んでいる想定です。
+
+## `.xlsx` を置くだけでページになる
+
+**`.xlsx` を `src/` に置くだけで、他のページと同格のルートになります。** URL の作り方は
+`.tsx` と同じ(`src/data/june.xlsx` → `/data/june`、`index.xlsx` はそのディレクトリ)で、
+ナビにも `vantage routes` にも並びます。開くとフレームワーク同梱の表ビューアが描き、複数シートを
+切り替えられ、元ファイルをダウンロードできます。ビューアは**表計算ソフトの見た目**です ——
+列は A / B / C、左に行番号、ファイルの 1 行目はヘッダとして固定、シートのタブは下端。
+読み取り専用で、編集もソートもできません(セルを選んで `Cmd/Ctrl+C` でコピーは可)。
+
+- **タイトルはファイル名から導かれる**(`june.xlsx` → 「June」)。データファイルに `definePage` は
+  書けません。名前を変えたいときはファイルをリネームします
+- **ページにしたくないファイルは `_` を前置する**(`_june.xlsx`)。`components/`・`hooks/`・`lib/` に
+  置いたものも同じくページになりません
+- **既定はファイルをそのまま置く(tsx を書かない)。** 自分でタイトルや説明を付けたいときだけ、`_` を
+  前置してルート化を止め、tsx から描きます:
+  ```tsx
+  import { FilePageView } from "@squadbase/vantage/table"
+  import src from "./_june.xlsx?url&no-inline"
+  export const page = definePage({ title: "6月度 売上レポート" })
+  export default () => <FilePageView src={src} kind="xlsx" fileName="june.xlsx" />
+  ```
+- **複数シートに対応**しています。シートのタブは下端に並び、切り替えて閲覧できます。
+- 数式・グラフ・セル書式は再現されません(値として読めれば十分、という設計)。ブラウザでパースするので
+  25MB を超えるファイルはそのページにエラーが出ます —— 大きいデータは `server/api/` から配って
+  `DataTable` で描いてください
+- **ビューアの無い拡張子(`.xls`・`.ods` など)はルートになりません。** `vantage check` の
+  `UNSUPPORTED_PAGE_FILE` 警告が知らせます

package/base-template/package-lock.json

@@ -7,8 +7,8 @@
       "name": "vibe-app",
       "dependencies": {
         "@squadbase/react": "^0.1.0",
-        "@squadbase/vantage": "^0.5.3",
-        "@squadbase/vantage-sdk": "^0.1.0",
+        "@squadbase/vantage": "0.6.1-dev2.04fa7f3",
+        "@squadbase/vantage-sdk": "0.1.1-dev2.ebd5413",
         "date-fns": "^4.1.0",
         "lucide-react": "^0.468.0",
         "react": "^19.2.7",
@@ -1396,9 +1396,9 @@
       }
     },
     "node_modules/@squadbase/vantage": {
-      "version": "0.5.3",
-      "resolved": "https://registry.npmjs.org/@squadbase/vantage/-/vantage-0.5.3.tgz",
-      "integrity": "sha512-wu/qY1S1x1+zSlYU53BaLnCQdWSE6lq7Q5plBqJkYF4CR1/Y9zfb4govMmVF6w1s1oDsgWolBUgkDPh17vkHrw==",
+      "version": "0.6.1-dev2.04fa7f3",
+      "resolved": "https://registry.npmjs.org/@squadbase/vantage/-/vantage-0.6.1-dev2.04fa7f3.tgz",
+      "integrity": "sha512-Jxa7bhTCFizsvbCxmO/6dURBYqZIRZADNgiSscs2hLaDPqNlxubx18HcOH6GVQQaWwSG4k8OA4sS/fg/X/3XPg==",
       "license": "MIT",
       "dependencies": {
         "@base-ui/react": "^1.6.0",
@@ -1415,10 +1415,14 @@
         "date-fns": "^4.1.0",
         "echarts": "^6.0.0",
         "esbuild": "^0.28.1",
-        "hono": "^4.12.30",
+        "fflate": "^0.8.3",
+        "hono": "^4.13.5",
+        "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",
         "streamdown": "^2.5.0",
         "tailwind-merge": "^3.0.0",
         "tailwindcss": "^4.3.2",
@@ -1429,7 +1433,7 @@
         "vantage": "dist/cli.js"
       },
       "engines": {
-        "node": ">=20"
+        "node": ">=22"
       },
       "peerDependencies": {
         "react": ">=18.2.0",
@@ -1437,9 +1441,9 @@
       }
     },
     "node_modules/@squadbase/vantage-sdk": {
-      "version": "0.1.0",
-      "resolved": "https://registry.npmjs.org/@squadbase/vantage-sdk/-/vantage-sdk-0.1.0.tgz",
-      "integrity": "sha512-5dknrb6wkFIHeHWf6SsOL0gtcTxr5+WZWgBxGSj3UlEBt2l4JKNZJ7T7DsXE1vUq9WxfLryrfBkEf3sEHGO9yQ==",
+      "version": "0.1.1-dev2.ebd5413",
+      "resolved": "https://registry.npmjs.org/@squadbase/vantage-sdk/-/vantage-sdk-0.1.1-dev2.ebd5413.tgz",
+      "integrity": "sha512-+RGJkHYwKUtbf8sjdmjQ7j3eC0WemcXS3ywXCgLUPn8EGPqkoM0vrkJMshnniiTLN9uiAhKFWT4WgFpR9kwj9g==",
       "license": "MIT"
     },
     "node_modules/@streamdown/code": {
@@ -3151,6 +3155,12 @@
         }
       }
     },
+    "node_modules/fflate": {
+      "version": "0.8.3",
+      "resolved": "https://registry.npmjs.org/fflate/-/fflate-0.8.3.tgz",
+      "integrity": "sha512-tbZNuJrLwGUp3zshBtdy4W+ORxZuIh8a5ilyIEQDC5rY1f3U20JMry0Ll3WBzU58EZKsEuJFXhb5gwv8CsPvgA==",
+      "license": "MIT"
+    },
     "node_modules/fsevents": {
       "version": "2.3.3",
       "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
@@ -3367,6 +3377,12 @@
         "node": ">=16.9.0"
       }
     },
+    "node_modules/html-to-image": {
+      "version": "1.11.13",
+      "resolved": "https://registry.npmjs.org/html-to-image/-/html-to-image-1.11.13.tgz",
+      "integrity": "sha512-cuOPoI7WApyhBElTTb9oqsawRvZ0rHhaHwghRLlTuffoD1B2aDemlCruLeZrUIIdvG7gs9xeELEPm6PhuASqrg==",
+      "license": "MIT"
+    },
     "node_modules/html-url-attributes": {
       "version": "3.0.1",
       "resolved": "https://registry.npmjs.org/html-url-attributes/-/html-url-attributes-3.0.1.tgz",
@@ -4738,6 +4754,12 @@
         "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
       }
     },
+    "node_modules/node-int64": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/node-int64/-/node-int64-0.4.0.tgz",
+      "integrity": "sha512-O5lz91xSOeoXP6DulyHfllpq+Eg00MWitZIbtPfoSEvqIHdl5gfcY6hYzDWnj0qD5tz52PI08u9qUvSVeUBeHw==",
+      "license": "MIT"
+    },
     "node_modules/oniguruma-parser": {
       "version": "0.12.2",
       "resolved": "https://registry.npmjs.org/oniguruma-parser/-/oniguruma-parser-0.12.2.tgz",
@@ -4761,6 +4783,12 @@
       "integrity": "sha512-yQA4H19AmPEoMUeavPMDIe1higySl/gH/yaQrkT/s07Qp+7pp2hYz30N3z2l5BkjVkF9Ow6o0wjJamm2y7Sn0A==",
       "license": "MIT"
     },
+    "node_modules/papaparse": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/papaparse/-/papaparse-5.7.0.tgz",
+      "integrity": "sha512-qBGxg/7Q3Kl9Wfhrz2Z74UnvnHTXLNG6jmKJFeBvP2+y4lV7So+7SR62+Zd47JvdrCkX+nDcnr0ObPzek/+6RA==",
+      "license": "MIT"
+    },
     "node_modules/parse-entities": {
       "version": "4.0.2",
       "resolved": "https://registry.npmjs.org/parse-entities/-/parse-entities-4.0.2.tgz",
@@ -4992,6 +5020,21 @@
         }
       }
     },
+    "node_modules/read-excel-file": {
+      "version": "9.3.10",
+      "resolved": "https://registry.npmjs.org/read-excel-file/-/read-excel-file-9.3.10.tgz",
+      "integrity": "sha512-zFcBdzunLCGBmLRT4Q3mLPJnhKPAXXfGAZ83feODlEqX2aRUbgF1h/n2oY0UF7I8tVwnJNRas6fTRD5veDUs+g==",
+      "license": "MIT",
+      "dependencies": {
+        "fflate": "^0.8.3",
+        "saxen": "^11.1.0",
+        "unzipper-esm": "^0.13.3",
+        "worker-f": "^0.1.12"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/regex": {
       "version": "6.1.0",
       "resolved": "https://registry.npmjs.org/regex/-/regex-6.1.0.tgz",
@@ -5195,6 +5238,15 @@
       "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
       "license": "MIT"
     },
+    "node_modules/saxen": {
+      "version": "11.2.0",
+      "resolved": "https://registry.npmjs.org/saxen/-/saxen-11.2.0.tgz",
+      "integrity": "sha512-2bG564AAJcm/3vyZC0Uhs/mACrH+4AHMaKHKAB2M5xMqomUZa27FQ7MYaQGFKVcJk/MVzSEQ34A8QZWW+eiWEw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 20.12"
+      }
+    },
     "node_modules/scheduler": {
       "version": "0.27.0",
       "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.27.0.tgz",
@@ -5535,6 +5587,19 @@
         "url": "https://opencollective.com/unified"
       }
     },
+    "node_modules/unzipper-esm": {
+      "version": "0.13.3",
+      "resolved": "https://registry.npmjs.org/unzipper-esm/-/unzipper-esm-0.13.3.tgz",
+      "integrity": "sha512-LUO6VZ6fCzkDbdMev0/fOhoIeVGKaOkTIOoYxVLE0SQjfvmAHK+oywl7lfhloSZIsdGJ25mJ18Mtd9CyTASjrA==",
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.2.2",
+        "node-int64": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
     "node_modules/use-callback-ref": {
       "version": "1.3.3",
       "resolved": "https://registry.npmjs.org/use-callback-ref/-/use-callback-ref-1.3.3.tgz",
@@ -5729,6 +5794,15 @@
         "url": "https://github.com/sponsors/wooorm"
       }
     },
+    "node_modules/worker-f": {
+      "version": "0.1.20",
+      "resolved": "https://registry.npmjs.org/worker-f/-/worker-f-0.1.20.tgz",
+      "integrity": "sha512-7z5K5z4x++FykhpDTfriT/dOu7CmSap9BBv38DVFU3CD38obopq+DoFH75yBV3butpGm+OeqR9BKdSvYJSnUfQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      }
+    },
     "node_modules/zod": {
       "version": "4.4.3",
       "resolved": "https://registry.npmjs.org/zod/-/zod-4.4.3.tgz",

package/base-template/package.json

@@ -12,8 +12,8 @@
   },
   "dependencies": {
     "@squadbase/react": "^0.1.0",
-    "@squadbase/vantage": "^0.5.3",
-    "@squadbase/vantage-sdk": "^0.1.0",
+    "@squadbase/vantage": "0.6.1-dev2.04fa7f3",
+    "@squadbase/vantage-sdk": "0.1.1-dev2.ebd5413",
     "date-fns": "^4.1.0",
     "lucide-react": "^0.468.0",
     "react": "^19.2.7",

package/base-template/pipelines/pyproject.toml

@@ -0,0 +1,5 @@
+[project]
+name = "pipelines"
+version = "0.1.0"
+requires-python = ">=3.11"
+dependencies = ["adamas>=0.2.0", "pandas", "requests"]