パッケージリファレンス

サポート対象バージョン

互換性マトリクスでは、現在 Lingui 5 と Lingui 6 の両方で次のフレームワーク / バンドラ世代を確認しています。

パッケージ	テスト対象のフレームワーク / バンドラ組み合わせ
lingui-for-svelte	Svelte 5 + Vite 6、Svelte 5 + Vite 7、Svelte 5 + Vite 8
lingui-for-astro	Astro 5 + Vite 6、Astro 6 + Vite 7、Astro 7 + Vite 8
unplugin-lingui-macro	素の Vite 6、Vite 7、Vite 8

Astro 7 対応は正式版のリリース系列に追従しています。

lingui-for-svelte

エクスポート	内容	利用者向け
lingui-for-svelte	setLinguiContext, getLinguiContext	✓
lingui-for-svelte/macro	t, plural, select, selectOrdinal, Trans, Plural, Select, SelectOrdinal, msg, defineMessage, ph	✓
lingui-for-svelte/config	framework.svelte 対応の defineConfig ヘルパー	✓
lingui-for-svelte/extractor	lingui.config.ts 用の svelteExtractor。明示的な設定元を使う場合は svelteExtractor({ config }) を使います	✓
lingui-for-svelte/unplugin/*	Vite、Rollup、Rolldown 用プラグイン	✓
lingui-for-svelte/runtime	コンパイル済みマクロ出力から呼ばれる内部実行時	✗

lingui-for-astro

エクスポート	内容	利用者向け
lingui-for-astro	setLinguiContext, getLinguiContext	✓
lingui-for-astro/macro	t, plural, select, selectOrdinal, Trans, Plural, Select, SelectOrdinal, msg, defineMessage, ph	✓
lingui-for-astro/config	framework.astro 対応の defineConfig ヘルパー	✓
lingui-for-astro/extractor	lingui.config.ts 用の astroExtractor。明示的な設定元を使う場合は astroExtractor({ config }) を使います	✓
lingui-for-astro/integration	astro.config.ts 用の Astro 統合	✓
lingui-for-astro/unplugin/*	Vite、Rollup、Rolldown 用プラグイン	✓
lingui-for-astro/runtime	コンパイル済みマクロ出力から呼ばれる内部実行時	✗

補足

*/runtime は公開 API ではない

lingui-for-svelte/runtime と lingui-for-astro/runtime には、コンパイル済みマクロ出力が実行時に呼び出す低レベルの補助関数が入っています。 これらの API はメジャーバージョンを上げずに変更される可能性があります。 これらのパスを直接インポートしないでください。

フレームワーク設定は lingui.config.ts に置く

whitespace、packages、runtimeWarnings などのフレームワーク固有のオプションが必要な場合は、lingui-for-svelte/config または lingui-for-astro/config の defineConfig を使います。 フレームワークのビルド変換とエクストラクタは同じ設定を読み込み、対応する framework.svelte または framework.astro セクションを参照します。 単一フレームワークのプロジェクトと複数フレームワークのプロジェクトでの動きについては、フレームワーク設定 を参照してください。

素の JS / TS では別パッケージを使う

素の .js と .ts ファイルでは、公式 Lingui の @lingui/core/macro を使い、ビルド変換には unplugin-lingui-macro、抽出には @lingui/cli/api/extractors/babel を使います。 これらは lingui-for-* には含まれません。 詳しくは プレーンな JS/TS でのセットアップ を参照してください。