コンテンツにスキップ
svelte-zukan
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

モノレポで使う

groups オプションがないとき、svelte-zukan は次の順にカタログファイルを探します。

  1. Vite の root にあるパッケージ(カタログ用のアプリ自身)の src
  2. そのアプリが依存しているワークスペースパッケージの 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'] })。