モノレポで使う
groups オプションがないとき、svelte-zukan は次の順にカタログファイルを探します。
- Vite の root にあるパッケージ(カタログ用のアプリ自身)の
src - そのアプリが依存しているワークスペースパッケージの
src(アプリのpackage.jsonのdependencies、devDependenciesの順)
グループ名はパッケージの package.json の name です。name がなければディレクトリ名です。カタログファイルがないパッケージはグループになりません。
依存パッケージの見つけ方
依存パッケージはカタログ用のアプリ自身の node_modules/<依存名>(pnpm)か、ワークスペースのルートの node_modules/<依存名>(npm、yarn、bun)にあるリンクから探します。
- Yarn の Plug’n’Play には
node_modulesがないので見つかりません。その場合はgroupsで指定してください - 推移的な依存は探しません。アプリの依存に宣言していないアプリやパッケージは、
groupsで指定します
各パッケージにインストールする
カタログファイルは svelte-zukan から Section を import します。そのため、カタログファイルを置くパッケージにはそれぞれ、カタログ用のアプリと同じバージョンの svelte-zukan を devDependencies に入れます。pnpm では、パッケージは自分が宣言したものしか import できません。入れないと、dev サーバーではそのパッケージのカタログファイルが表示されることがあっても、build: true での vite build は svelte-zukan を解決できずに失敗します。
groups でディレクトリを選ぶ
groups を書くと自動探索はせず、書いたディレクトリだけを探します。たとえば、カタログ用のアプリ apps/catalog から、別のアプリ apps/web のコンポーネントを見せたいときは次のようにします。
// apps/catalog/vite.config.ts
zukan({
groups: {
web: '../web/src',
ui: '../../packages/ui/src'
}
});
パスは Vite の root からの相対パスです。1 つのグループに複数のディレクトリを並べることもできます({ examples: ['src/examples', 'src/demo'] })。