feat: failOnMissing & failOnCompileError for loaders + compiler

[timofei-iatsenko]

Description

fixes: #2193 #2192

This PR adds two new features for all places (except of Metro transformer, i later desribe way) where catalogs are compiled. Including:

• lingui compile command
• vite plugin
• webpack loader

Metro tranformer doesn't have a way to pass options for now, so these flags couldn't be implemented now FYI @vonovak

failOnMissing

Will fail build if there are missing translations. Useful to ensure production builds doesn't have missing translations

For vite & webpack this option should be passed directly to theirs config.
lingui compile will perform this check when --strict flag is passed

failOnCompileError

Will fail build if there are compilation errors for messages. For example, syntax issues in the ICU expressions.

When this flag is false it will still report these errors but as warnings.

For vite & webpack this option should be passed directly to theirs config.
lingui compile will perform this check when --strict flag is passed

Other Changes

This PR might introduce some slight breaking changes for those who uses Lingui API directly.
I would prefer not to rise major version, because this should not affect users who just using lingui as usual.

• createCompiledCatalog returns {source: string, errors: MessageCompilationError[]} instead of string
• catalog.getTranslations returns {messages: Messages, missing: TranslationMissingEvent[]} instead of Messages

Types of changes

• Bugfix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Examples update

Fixes # (issue)

Checklist

• I have read the CONTRIBUTING and CODE_OF_CONDUCT docs
• I have added tests that prove my fix is effective or that my feature works
• I have added the necessary documentation (if appropriate)

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
js-lingui	✅ Ready (Inspect)	Visit Preview	Mar 19, 2025 10:28am

[github-actions]

size-limit report 📦

Path	Size
packages/core/dist/index.mjs	2.91 KB (0%)
packages/detect-locale/dist/index.mjs	618 B (0%)
packages/react/dist/index.mjs	1.35 KB (0%)

[andrii-bodnar]

@timofei-iatsenko @hahn-kev thank you!