設定

Vite ルートの tsconfig.json にある vueCompilerOptions.plugins、もしくはViteプラグイン関数（vueInternationalization()）の引数で設定します。

VS Codeやvue-tscで型を取得するために、Viteルートtsconfig.jsonでの設定をおすすめします。

json

{
  "vueCompilerOptions": {
    "plugins": [
      {
        "name": "vite-vue-internationalization/volar",
        "primaryLocale": "ja-JP",
        "messageSyntax": "vue",
        "buildStrategy": "virtual",
        "sfcTransform": "locale-sources",
        "scan": {
          "include": "src/**/*.vue",
          "exclude": ["src/legacy/**"]
        },
        "global": {
          "ja-JP": "./src/locales/ja-JP/**/*.yaml",
          "en-US": "./src/locales/en-US/**/*.yaml"
        }
      }
    ]
  }
}

項目	初期値	説明
`primaryLocale`	必須	型生成の基準になるロケールです。
`global`	`undefined`	ロケールごとのグローバル辞書の入力元です。
`buildStrategy`	`virtual`	`virtual` または `inline-chunks` を指定します。
`scan.include`	`*/.vue`	起動時に収集する Vue ファイルを絞ります。
`scan.exclude`	`[]`	収集対象から外す Vue ファイルです。
`messageSyntax`	`vue`	`vue` または `icu` をプロジェクト全体で選びます。
`sfcTransform`	`locale-sources`	`$locale`/`$l` を注入する SFC の範囲です。`locale-sources` は `<locale>` または `defineInternationalization()` がある SFC だけ、`all` はすべての SFC を変換します。
`globalType`	`detailed`	Volar での `$locale.env` / `$l.env` の型を制御します。巨大なグローバル辞書で `vue-tsc` の型展開を避ける場合は `runtime` を指定します。
`localizerDocumentation`	`true`	Volar のホバー表示に出す `$l` 用 JSDoc 生成を制御します。

Vite の変換結果では、巨大なグローバル辞書型を各 SFC に重複して展開しないように、$locale.env / $l.env は広い runtime 型になります。Vue Language Tools / Volar では標準で詳細なグローバル辞書型を使いますが、辞書が大きすぎて型検査が重くなる場合は globalType: "runtime" を指定します。

現在の Vite プラグインは tsconfig.app.json など別名の設定ファイルを自動探索しません。別名の tsconfig に設定を置く場合は、ルートの tsconfig.json にも vueCompilerOptions.plugins を置くか、vueInternationalization({ primaryLocale, global, messageSyntax }) に明示してください。

設定 ​

設定