@mmstack/translate 21.0.2 → 21.1.0

package/README.md

@@ -9,7 +9,7 @@
 `@mmstack/translate` is an opinionated internationalization (i18n) library for Angular applications built with three core priorities:
 
 1.  **Maximum Type Safety:** Catch errors related to missing keys or incorrect/missing parameters at compile time.
-2.  **Simplified Build Process:** Lazily load translations at runtime, requiring only a **single application build** regardless of the number of supported locales.
+2.  **Flexible Build Process:** Works as a traditional multi-build solution (like `@angular/localize`) **OR** as a single-build runtime solution.
 3.  **Scalable Modularity:** Organize translations into **namespaces** (typically aligned with feature libraries) and load them on demand.
 
 It uses the robust **FormatJS** Intl runtime (`@formatjs/intl`) for ICU message formatting, and integrates with Angular's dependency injection and routing.
@@ -21,23 +21,24 @@ It uses the robust **FormatJS** Intl runtime (`@formatjs/intl`) for ICU message
   - Correct parameter names and types.
   - Required vs. optional parameters based on ICU message.
   - Structural consistency check when defining non-default locales.
-- 🚀 **Single Build Artifact:** Runtime translation loading.
+- 🚀 **Flexible Deployment:** Support both multi-build (traditional) and single-build (runtime) scenarios.
 - 📦 **Namespacing:** Organize translations by feature/library (e.g., 'quotes', 'userProfile', 'common').
-- 🔄 **Dynamic Language Switching:** Change locales at runtime with automatic translation loading.
+- 🔄 **Dynamic Language Switching (Optional):** Change locales at runtime with automatic translation loading.
+- 🛣️ **Route-Based Locale Support (Optional):** Automatic locale detection and switching based on route parameters.
 - ⏳ **Lazy Loading:** Load namespaced translations on demand using Route Resolvers.
 - ✨ **Reactive API:** Includes `t.asSignal()` for creating computed translation signals based on signal parameters.
-- 🌍 **ICU Message Syntax:** Uses FormatJS runtime for robust support of variables (`{name}`), `plural`, `select`, and `selectordinal`. (Note: Complex inline date/number formats are not the focus; use Angular's built in Pipes/format functions & use the result as variables in your translation.)
+- 🌍 **ICU Message Syntax:** Uses FormatJS runtime for robust support of variables (`{name}`), `plural`, `select`, and `selectordinal`. (Note: Complex inline date/number formats are not the focus; use Angular's built-in Pipes/format functions & use the result as variables in your translation.)
 - 🔗 **Shared Namespace Support:** Define common translations (e.g., 'Save', 'Cancel') in one namespace and make them type-safely accessible from others.
 - 🛠️ **Template Helpers:** Includes abstract `Translator` pipe and `Translate` directive for easy, type-safe templating.
 
 ### Comparison
 
-While Angular offers excellent i18n solutions like `@angular/localize` and `transloco`, `@mmstack/translate` aims to fill a specific niche.
+While Angular offers excellent i18n solutions like `@angular/localize` and `transloco`, `@mmstack/translate` aims to fill a specific niche by supporting **both** traditional multi-build and modern single-build approaches.
 
 | Feature                  |         `@mmstack/translate`         |   `@angular/localize`    |          `transloco`          |      `ngx-translate`       |
 | :----------------------- | :----------------------------------: | :----------------------: | :---------------------------: | :------------------------: |
-| **Build Process**        |           ✅ Single Build            | ❌ Multi-Build (Typical) |        ✅ Single Build        |      ✅ Single Build       |
-| **Translation Timing**   |               Runtime                |       Compile Time       |            Runtime            |          Runtime           |
+| **Build Process**        |       ✅ Single or Multi-Build       | ❌ Multi-Build (Typical) |        ✅ Single Build        |      ✅ Single Build       |
+| **Translation Timing**   |        Runtime or Build Time         |       Compile Time       |            Runtime            |          Runtime           |
 | **Type Safety (Keys)**   | ✅ Strong (Inferred from structure)  |    🟡 via extraction     |      🟡 Tooling/TS Files      |    🟡 OK Manual/Tooling    |
 | **Type Safety (Params)** |    ✅ Strong (Inferred from ICU)     |         ❌ None          |           🟡 Manual           |         🟡 Manual          |
 | **Locale Switching**     | ✅ Dynamic (Runtime) or Page refresh | 🔄 Page Refresh Required |     ✅ Dynamic (Runtime)      |    ✅ Dynamic (Runtime)    |
@@ -47,7 +48,7 @@ While Angular offers excellent i18n solutions like `@angular/localize` and `tran
 | **Signal Integration**   |       ✅ Good (`t.asSignal()`)       |           N/A            | ✅ Good (`translateSignal()`) |      ❌ Minimal/None       |
 | **Maturity / Community** |                ✨ New                |       Core Angular       |      ✅ Mature / Active       |         ✅ Mature          |
 
-## Installation & Configuration
+## Installation
 
 Install the library & its peer dependency, `@formatjs/intl`.
 
@@ -55,69 +56,63 @@ Install the library & its peer dependency, `@formatjs/intl`.
 npm install @mmstack/translate @formatjs/intl
 ```
 
-If you'd like to setup @formatjs with custom properties & setup a different default locale then 'en-US' you can define these options at the root of your application.
+## Configuration
 
-```typescript
-import { provideIntlConfig } from '@mmstack/translate';
+### Default: Multi-Build Scenario (like @angular/localize)
 
-const appConfig: Providers = [
-  provideIntlConfig({
-    defaultLocale: 'en-US', // defaults to 'en-US' if nothing is provided
-  }),
-];
-```
+By default, `@mmstack/translate` works like `@angular/localize` - it uses Angular's `LOCALE_ID` token and expects a page refresh for locale changes. This is ideal for traditional multi-build deployments where each locale has its own build artifact.
 
-```typescript
-// DEMO impl, how you actually provide LOCALE_ID & what it's based on is up to you, it just has to be available when the resolvers are called
+**No special configuration needed!** Just provide `LOCALE_ID`:
 
-import { Component, LOCALE_ID } from '@angular/core';
+```typescript
+// app.config.ts
+import { ApplicationConfig, LOCALE_ID } from '@angular/core';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    { provide: LOCALE_ID, useValue: 'en-US' }, // Set your locale
+    // ... other providers
+  ],
+};
+```
 
-@Component({
-  selector: 'app-locale-shell',
-  template: `<router-outlet />`,
-})
-export class LocaleShellComponent {}
+The library will use this `LOCALE_ID` value and work exactly like `@angular/localize` - requiring a full page refresh to change locales.
 
-// app.routes.ts
-import { Routes, ActivatedRouteSnapshot } from '@angular/router';
-import { Injectable, LOCALE_ID } from '@angular/core';
-import { QuoteComponent } from './quote.component';
+### Single-Build with Runtime Translation Loading
 
-@Injectable({
-  providedIn: 'root',
-})
-export class LocaleStore {
-  locale = 'en-US';
-}
+If you want a **single build** that loads translations at runtime, use `provideIntlConfig()`:
 
-export const routes: Routes = [
-  {
-    path: ':locale',
-    component: LocaleShellComponent,
-    resolve: {
-      localeId: (route: ActivatedRouteSnapshot) => {
-        const locale = route.params['locale'] || 'en-US';
+```typescript
+// app.config.ts
+import { ApplicationConfig, LOCALE_ID } from '@angular/core';
+import { provideIntlConfig } from '@mmstack/translate';
 
-        return route.params['locale'] || 'en-US';
-      },
-    },
-    providers: [
-      {
-        provide: LOCALE_ID,
-        useFactory: (store: LocaleStore) => {
-          return store.locale;
-        },
-        deps: [LocaleStore],
-      },
-    ],
-    loadChildren: () => import('./quote.routes').then((m) => m.QUOTE_ROUTES),
-  },
-];
+export const appConfig: ApplicationConfig = {
+  providers: [
+    { provide: LOCALE_ID, useValue: 'en-US' }, // Initial/fallback locale
+    provideIntlConfig({
+      defaultLocale: 'en-US',
+      supportedLocales: ['en-US', 'sl-SI', 'de-DE', 'fr-FR'], // Validates locale switches
+    }),
+    // ... other providers
+  ],
+};
 ```
 
-_Note:_ `@mmstack/translate` relies on Angular's `LOCALE_ID` provider for its default. You should provide a value for it. How you determine this value (e.g., hardcoded, from server config, from URL segment via a factory provider) is up to your application's architecture.
+**Optional Configuration:**
 
-By default the library assumes this `LOCALE_ID` is static for the duration of the application session and requires a page refresh to change. You can however opt in to dynamic locale switching via `injectDynamicLocale`. see usage note 5 for details :)
+```typescript
+provideIntlConfig({
+  defaultLocale: 'en-US',
+  supportedLocales: ['en-US', 'sl-SI', 'de-DE'],
+
+  // Automatically detect and respond to locale route parameter changes, should correspond with actual param name example bellow
+  localeParamName: 'locale',
+
+  // Preload default locale for synchronous fallback (rarely needed)
+  preloadDefaultLocale: true,
+});
+```
 
 ## Usage
 
@@ -125,7 +120,7 @@ The core workflow involves defining namespaces, registering them (often via lazy
 
 ### 1. Define Namespace & Translations
 
-Define your default locale translations (e.g., 'en-US') as a `const` TypeScript object. Use createNamespace to process it and generate helpers.
+Define your default locale translations (e.g., 'en-US') as a `const` TypeScript object. Use `createNamespace` to process it and generate helpers.
 
 ```typescript
 // Example: packages/quote/src/lib/quote.namespace.ts
@@ -149,13 +144,15 @@ export default ns.translation;
 export type QuoteLocale = (typeof ns)['translation'];
 
 export const createQuoteTranslation = ns.createTranslation;
+```
 
-// Note the translations should be in separate files, if you are using import() to lazy load them.
-// packages/quote/src/lib/quote-sl.translation.ts
+**Define other locales in separate files** (for lazy loading):
 
+```typescript
+// packages/quote/src/lib/quote-sl.translation.ts
 import { createQuoteTranslation } from './quote.namespace';
 
-// shape is typesafe (errors if you have missing or additional keys)
+// Shape is type-safe (errors if you have missing or additional keys)
 export default createQuoteTranslation('sl-SI', {
   pageTitle: 'Znani Citati',
   greeting: 'Zdravo {name}!',
@@ -163,50 +160,53 @@ export default createQuoteTranslation('sl-SI', {
     authorLabel: 'Avtor',
   },
   errors: {
-    minLength: 'Citat mora imeti vsaj {min} znakov.', // If original has variables, the translation must contain a subset of used variables (min 1)
+    minLength: 'Citat mora imeti vsaj {min} znakov.', // Variables must match original
   },
-  stats: '{count, plural, =1 {# citat} =2 {# citata} few {# citati} other {# citatov}} na voljo', // also guarenteed for "complex" variables, so {count} must be used in this translation
+  stats: '{count, plural, =1 {# citat} =2 {# citata} few {# citati} other {# citatov}} na voljo',
 });
 ```
 
-### 2. Register the namespace & load
+### 2. Register the Namespace & Load Translations
 
-Use registerNamespace to prepare your namespace definition and obtain the injectNamespaceT function and the resolveNamespaceTranslation resolver function. Use the resolver in your Angular routes.
+Use `registerNamespace` to prepare your namespace definition and obtain the `injectNamespaceT` function and the `resolveNamespaceTranslation` resolver function.
 
 ```typescript
+// Example: packages/quote/src/lib/quote.t.ts
 import { registerNamespace } from '@mmstack/translate';
 
-// Register the namespace
-// Example: packages/quote/src/lib/quote.t.ts
 const r = registerNamespace(
-  // you can also fetch from a server if you prefer, as long as the shape is the same
-  () => import('./quote.namespace').then((m) => m.default), // Default locale's compiled translation (functions as fallback if no locale of type provided)
+  // Default locale's compiled translation (functions as fallback)
+  () => import('./quote.namespace').then((m) => m.default),
   {
     // Map other locales to promise factories (dynamic imports)
     'sl-SI': () => import('./quote-sl.translation').then((m) => m.default),
+    // Add more locales as needed...
   },
 );
 
 export const injectQuoteT = r.injectNamespaceT;
 export const resolveQuoteTranslations = r.resolveNamespaceTranslation;
+```
 
-// in the main quote route add the provided resolver
+**Add the resolver to your routes:**
 
+```typescript
+// quote.routes.ts
 import { type Routes } from '@angular/router';
 import { resolveQuoteTranslations } from './quote.t';
 
-// quote.routes.ts
 export const QUOTE_ROUTES: Routes = [
   {
-    // ... component at or above where the translations need to be available
+    path: '',
+    component: QuoteComponent,
     resolve: {
-      resolveQuoteTranslations,
+      translations: resolveQuoteTranslations, // Loads translations before component
     },
   },
 ];
 ```
 
-#### 2b. [OPTIONAL] Configure the translation pipe and/or directive
+#### 2b. [OPTIONAL] Configure Type-Safe Pipe and/or Directive
 
 ```typescript
 import { Pipe, Directive } from '@angular/core';
@@ -215,29 +215,35 @@ import { type QuoteLocale } from './quote.namespace';
 
 @Pipe({
   name: 'translate',
+  standalone: true,
 })
 export class QuoteTranslator extends Translator<QuoteLocale> {}
 
 @Directive({
-  selector: '[translate]', // input in Translate is named 'translate'
+  selector: '[translate]', // Input in Translate is named 'translate'
+  standalone: true,
 })
-// TInput is necessary to correctly infer the variables to the key
 export class QuoteTranslate<TInput extends string> extends Translate<TInput, QuoteLocale> {}
 ```
 
-### 3. Have fun :)
+### 3. Use Translations in Components
 
 ```typescript
+import { Component, signal } from '@angular/core';
+import { injectQuoteT } from './quote.t';
+import { QuoteTranslator, QuoteTranslate } from './quote.helpers';
+
 @Component({
   selector: 'app-quote',
+  standalone: true,
   imports: [QuoteTranslator, QuoteTranslate],
   template: `
     <!-- Pipe validates key & variables match -->
     <h1>{{ 'quote.pageTitle' | translate }}</h1>
-    <!-- Non pluralized params must be string -->
+    <!-- Non-pluralized params must be string -->
     <span>{{ 'quote.errors.minLength' | translate: { min: '5' } }}</span>
 
-    <!-- Directive replaces innerHTML of el -->
+    <!-- Directive replaces textContent of element -->
     <h1 translate="quote.pageTitle"></h1>
     <span [translate]="['quote.errors.minLength', { min: '5' }]"></span>
   `,
@@ -246,104 +252,296 @@ export class QuoteComponent {
   protected readonly count = signal(0);
   private readonly t = injectQuoteT();
 
-  private readonly author = this.t('quote.detail.authorLabel'); // static translation
+  // Static translation
+  private readonly author = this.t('quote.detail.authorLabel');
 
+  // Reactive translation with signal parameters
   private readonly stats = this.t.asSignal('quote.stats', () => ({
-    count: this.count(), // must be object with count parameter & type number
+    count: this.count(), // Must match ICU parameter (type: number)
   }));
 }
 ```
 
-### 4. [OPTIONAL] - Creating a shared/common namespace
+### 4. [OPTIONAL] Route-Based Locale Detection
+
+For applications with locale-based routing (e.g., `/en-US/quotes`, `/sl-SI/quotes`), the library can automatically detect and switch locales.
+
+**Step 1: Configure locale parameter name**
+
+```typescript
+// app.config.ts
+import { provideIntlConfig } from '@mmstack/translate';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideIntlConfig({
+      defaultLocale: 'en-US',
+      supportedLocales: ['en-US', 'sl-SI', 'de-DE'],
+      localeParamName: 'locale', // Track this route parameter automatically
+    }),
+  ],
+};
+```
+
+**Step 2: Add route guard for validation**
+
+```typescript
+// app.routes.ts
+import { Routes } from '@angular/router';
+import { canMatchLocale } from '@mmstack/translate';
+
+export const routes: Routes = [
+  {
+    path: ':locale',
+    canMatch: [canMatchLocale()], // Validates & redirects invalid locales
+    children: [
+      {
+        path: 'quotes',
+        loadChildren: () => import('./quote/quote.routes').then((m) => m.QUOTE_ROUTES),
+      },
+      // ... other routes
+    ],
+  },
+];
+```
+
+**That's it!** The library will:
+
+- Detect locale changes from route parameters
+- Load translations on demand for the new locale
+- Update all translation outputs reactively
+- Redirect invalid locales to the default
+
+**With prefix segments:**
+
+If your locale parameter isn't the first segment (e.g., `/app/:locale/...`):
+
+```typescript
+{
+  path: 'app/:locale',
+  canMatch: [canMatchLocale(['app'])], // Validates second segment
+  children: [...]
+}
+```
+
+### 5. [OPTIONAL] Dynamic Language Switching
+
+For applications that need runtime language switching without page refreshes (e.g., language selector in header), use `injectDynamicLocale()`:
+
+```typescript
+import { Component } from '@angular/core';
+import { injectDynamicLocale } from '@mmstack/translate';
+
+@Component({
+  selector: 'app-language-switcher',
+  template: `
+    <select [value]="locale()" (change)="changeLanguage($event)">
+      <option value="en-US">English</option>
+      <option value="sl-SI">Slovenščina</option>
+      <option value="de-DE">Deutsch</option>
+    </select>
+
+    @if (locale.isLoading()) {
+      <div class="spinner">Loading translations...</div>
+    }
+  `,
+})
+export class LanguageSwitcherComponent {
+  protected readonly locale = injectDynamicLocale();
+
+  changeLanguage(event: Event) {
+    const target = event.target as HTMLSelectElement;
+    this.locale.set(target.value); // Automatically loads missing translations
+  }
+}
+```
+
+**Features:**
+
+- Validates against `supportedLocales` (if configured)
+- Automatically loads missing namespace translations
+- Provides `isLoading()` signal for UI feedback
+- Works with route-based locales
+
+**Important Note for Pure Pipes:**
+
+Due to Angular's memoization, pure pipes don't automatically react to locale changes. Solutions:
+
+```typescript
+// Option 1: Pass locale as parameter (recommended)
+{{ 'common.yes' | translate : locale() }}
+
+// Option 2: Make pipe impure (not recommended for performance)
+@Pipe({
+  name: 'translate',
+  pure: false,
+})
+export class QuoteTranslator extends Translator<QuoteLocale> {}
+```
 
-_Note:_ A shared namespace allows you to use it within other `t` functions. You are however responsible for loading it before those `t` functions initialize, usually for a shared namespace that would be at the top route.
+### 6. [OPTIONAL] Creating a Shared/Common Namespace
 
-#### 4a. Define a shared namespace
+A shared namespace allows you to define common translations (e.g., 'Save', 'Cancel', 'Yes', 'No') once and use them type-safely across all other namespaces.
 
-Same as quote example, but this time also export the `createMergedNamespace` function. This will be your new factory for other namespaces.
+**Step 1: Define a shared namespace**
 
 ```typescript
-// Example: packages/common-locales/src/lib/common.namespace.ts
+// packages/common/src/lib/common.namespace.ts
 import { createNamespace } from '@mmstack/translate';
 
 const ns = createNamespace('common', {
   yes: 'Yes',
   no: 'No',
+  save: 'Save',
+  cancel: 'Cancel',
+  delete: 'Delete',
 });
 
-// ... rest
+export default ns.translation;
+export type CommonLocale = (typeof ns)['translation'];
+export const createCommonTranslation = ns.createTranslation;
 
+// Export this for other namespaces to use
 export const createAppNamespace = ns.createMergedNamespace;
 ```
 
-### 4b. Use the common namespace factory instead of the library one
+**Step 2: Register the common namespace at the top level**
 
 ```typescript
-// Example: packages/quote/src/lib/quote.namespace.ts
-import { createAppNamespace } from '@org/common/locale'; // replace with your library import path
+// common.t.ts
+import { registerNamespace } from '@mmstack/translate';
+
+const r = registerNamespace(() => import('./common.namespace').then((m) => m.default), {
+  'sl-SI': () => import('./common-sl.translation').then((m) => m.default),
+});
+
+export const injectCommonT = r.injectNamespaceT;
+export const resolveCommonTranslations = r.resolveNamespaceTranslation;
+```
+
+```typescript
+// app.routes.ts - resolve at top level
+export const routes: Routes = [
+  {
+    path: '',
+    resolve: {
+      common: resolveCommonTranslations, // Load common translations first
+    },
+    children: [
+      // ... other routes
+    ],
+  },
+];
+```
+
+**Step 3: Use the shared namespace factory in other namespaces**
+
+```typescript
+// packages/quote/src/lib/quote.namespace.ts
+import { createAppNamespace } from '@org/common'; // Your import path
 
-// Create the namespace definition object
 const ns = createAppNamespace('quote', {
   pageTitle: 'Famous Quotes',
+  // ... other translations
 });
 
-// registration & other stuff remains the same
+export default ns.translation;
+// ... rest remains the same
 ```
 
-### 4c. Have even more fun!
+**Step 4: Access both namespaces in components**
 
 ```typescript
-@Component({
-  //...
-})
+@Component({...})
 export class QuoteComponent {
   private readonly t = injectQuoteT();
 
-  // t function is now 'aware' of the common namespace & its translations
-  private readonly yes = this.t('common.yes');
+  // Access common namespace translations
+  private readonly yesLabel = this.t('common.yes');
+  private readonly saveLabel = this.t('common.save');
 
-  // quote translations also work the same
-  private readonly author = this.t('quote.detail.authorLabel');
+  // Access quote namespace translations
+  private readonly title = this.t('quote.pageTitle');
 }
 ```
 
-### 5 [OPTIONAl] - Add dynamic language switching
+## Helper Functions
 
-`LOCALE_ID` is always used as the initial value, but you can dynamically switch that & `@mmstack/translate` will load the new translations on demand, updating as necessary.
+### Core Injection Functions
 
-```typescript
-import { injectDynamicLocale } from '@mmstack/translate';
+**`injectDefaultLocale(): string`**  
+Returns the configured default locale or falls back to `LOCALE_ID`.
 
-@Component({...})
-export class LanguageSwitcher {
-  private readonly locale = injectDynamicLocale();
+**`injectSupportedLocales(): string[]`**  
+Returns the array of supported locales or defaults to `[defaultLocale]`.
 
-  switchToSlovene() {
-    this.locale.set('sl-SI'); // Automatically loads missing translations
-  }
+**`injectIntl(): Signal<IntlShape>`**  
+Directly access the FormatJS `Intl` instance for advanced formatting needs.
 
-  // Template can react to loading state
-  @if (locale.isLoading()) {
-    <div>Loading translations...</div>
-  }
-}
+```typescript
+import { injectIntl } from '@mmstack/translate';
+
+const intl = injectIntl();
+const formatted = intl().formatNumber(1234.56, {
+  style: 'currency',
+  currency: 'EUR',
+});
 ```
 
-_Note:_ Due to Angular memo-izing the transform function, custom Pipe's used will not update on dynamic local switches automatically. To resolve this you can:
+**`injectDynamicLocale(): WritableSignal<string> & { isLoading: Signal<boolean> }`**  
+Inject a dynamic locale signal for runtime language switching.
 
-```typescript
+### Route Utilities
 
-// Add the locale as the last parameter when calling the pipe
-{{'common.yes' | translate : locale()}}
+**`canMatchLocale(prefixSegments?: string[]): CanMatchFn`**  
+Route guard that validates locale parameters against `supportedLocales` and redirects invalid locales to the default.
 
-// or set pure to false (not recommended)
-@Pipe({
-  name: 'translate',
-  pure: false
-})
-export class QuoteTranslator extends Translator<QuoteLocale> {}
-```
+## Advanced: Architecture & Performance
+
+### Resource-Based Translation Loading
+
+The library uses Angular's `resource()` API for efficient, reactive translation loading:
+
+- Automatic request deduplication
+- Built-in loading states
+- Cancellation support via `AbortSignal`
+- Better error handling
+
+### On-Demand Translation Loading
+
+When switching locales dynamically, the library:
+
+1. Checks which namespaces need translations for the new locale
+2. Loads only the missing translations in parallel
+3. Updates all reactive outputs automatically
+4. Falls back to the default locale if unavailable
+
+## Migration from Other Libraries
+
+### From @angular/localize
+
+`@mmstack/translate` can work exactly like `@angular/localize` by default - no migration needed for the build process! Simply:
+
+1. Define your translations using `createNamespace`
+2. Register namespaces with resolvers
+3. Use the translation functions/pipes/directives
+
+The main difference is the namespace organization and type safety.
+
+### From transloco/ngx-translate
+
+If you're migrating from a runtime-only solution:
+
+1. Configure `provideIntlConfig()` with your supported locales
+2. Use `localeParamName` if you have route-based locales
+3. Use `injectDynamicLocale()` for programmatic locale switching
+4. Convert your translation JSON files to TypeScript using `createNamespace`
+5. Update component/template usage to use the type-safe APIs
 
 ## Contributing
 
-Contributions, issues, and feature requests are welcome!
+Contributions, issues, and feature requests are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+## License
+
+MIT © [Mihael Mulec](https://github.com/mihajm)

package/fesm2022/mmstack-translate.mjs

@@ -1,6 +1,8 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, inject, signal, LOCALE_ID, computed, resource, untracked, isDevMode, effect, Injectable, isSignal, input, Renderer2, ElementRef, afterRenderEffect, Directive, ChangeDetectorRef } from '@angular/core';
+import { inject, computed, InjectionToken, LOCALE_ID, signal, resource, untracked, isDevMode, effect, Injectable, isSignal, input, Renderer2, ElementRef, afterRenderEffect, Directive, ChangeDetectorRef } from '@angular/core';
+import { Router, ActivatedRoute } from '@angular/router';
 import { createIntlCache, createIntl } from '@formatjs/intl';
+import { toSignal } from '@angular/core/rxjs-interop';
 
 const KEY_DELIM = '::MMT_DELIM::';
 function prependDelim(prefix, key) {
@@ -53,28 +55,88 @@ function createNamespace(ns, translation) {
     return namespace;
 }
 
+function pathParam(key, route = inject(ActivatedRoute)) {
+    const keySignal = typeof key === 'string' ? computed(() => key) : computed(key);
+    const routerOptions = inject(Router)['options'];
+    if (routerOptions &&
+        typeof routerOptions === 'object' &&
+        routerOptions.paramsInheritanceStrategy === 'always') {
+        const params = toSignal(route.paramMap, {
+            initialValue: route.snapshot.paramMap,
+        });
+        return computed(() => params().get(keySignal()));
+    }
+    const paramMapSignals = [];
+    let currentRoute = route;
+    const isStatic = typeof key === 'string';
+    while (currentRoute) {
+        const initial = currentRoute.snapshot.paramMap;
+        paramMapSignals.push(toSignal(currentRoute.paramMap, {
+            initialValue: initial,
+        }));
+        // For static keys, stop once we find the param, will find first in computed for loop already so basically noop for for loop
+        if (isStatic && initial.has(key))
+            break;
+        currentRoute = currentRoute.parent;
+    }
+    return computed(() => {
+        const paramKey = keySignal();
+        for (const map of paramMapSignals) {
+            const v = map().get(paramKey);
+            if (v)
+                return v;
+        }
+        return null;
+    });
+}
+
 const CONFIG_TOKEN = new InjectionToken('mmstack-intl-config');
 function provideIntlConfig(config) {
-    return {
-        useValue: config,
-        provide: CONFIG_TOKEN,
-    };
+    const providers = [
+        {
+            useFactory: (localeId) => {
+                const next = {
+                    ...config,
+                };
+                const defaultLocale = config.defaultLocale ?? config.supportedLocales?.at(0) ?? localeId;
+                if (next.supportedLocales &&
+                    !next.supportedLocales.includes(defaultLocale)) {
+                    next.supportedLocales = [...next.supportedLocales, defaultLocale];
+                }
+                return next;
+            },
+            deps: [LOCALE_ID],
+            provide: CONFIG_TOKEN,
+        },
+    ];
+    const defaultLocale = config.defaultLocale ?? config.supportedLocales?.at(0);
+    if (!defaultLocale)
+        return providers;
+    providers.push({
+        provide: LOCALE_ID,
+        useValue: defaultLocale,
+    });
+    return providers;
 }
 function injectIntlConfig() {
     return inject(CONFIG_TOKEN, { optional: true }) ?? undefined;
 }
 function injectDefaultLocale() {
-    return injectIntlConfig()?.defaultLocale ?? 'en-US';
+    return injectIntlConfig()?.defaultLocale ?? inject(LOCALE_ID) ?? 'en-US';
+}
+function injectSupportedLocales() {
+    return injectIntlConfig()?.supportedLocales ?? [injectDefaultLocale()];
 }
 class TranslationStore {
     cache = createIntlCache();
     config = injectIntlConfig();
     loadQueue = signal([], ...(ngDevMode ? [{ debugName: "loadQueue" }] : []));
-    locale = signal(inject(LOCALE_ID), ...(ngDevMode ? [{ debugName: "locale" }] : []));
+    locale = signal(injectDefaultLocale(), ...(ngDevMode ? [{ debugName: "locale" }] : []));
     defaultLocale = injectDefaultLocale();
     translations = signal({
         [this.defaultLocale]: {},
     }, ...(ngDevMode ? [{ debugName: "translations" }] : []));
+    attemptedFallbackLoad = false;
     onDemandLoaders = new Map();
     nonMessageConfig = computed(() => ({
         ...this.config,
@@ -125,6 +187,21 @@ class TranslationStore {
         messages: this.messages(),
     }, this.cache), ...(ngDevMode ? [{ debugName: "intl" }] : []));
     constructor() {
+        const paramName = this.config?.localeParamName;
+        if (paramName) {
+            const param = pathParam(paramName);
+            effect(() => {
+                const loc = param();
+                if (!loc ||
+                    loc === untracked(this.locale) ||
+                    untracked(this.loadQueue).includes(loc))
+                    return;
+                if (this.hasLocaleLoaders(loc))
+                    this.locale.set(loc);
+                else
+                    this.loadQueue.update((q) => [...q, loc]);
+            });
+        }
         effect(() => {
             if (
             // should never be in error state, but best to check in case something throws
@@ -134,19 +211,34 @@ class TranslationStore {
             const dynamicLocales = this.dynamicLocaleLoader.value();
             if (!dynamicLocales)
                 return;
+            // Register loaded translations
             for (const locale of dynamicLocales.locales) {
                 this.register(locale.namespace, {
                     [dynamicLocales.locale]: locale.flat,
                 });
             }
-            this.loadQueue.update((q) => q.filter((l) => l !== dynamicLocales.locale));
-            this.locale.set(dynamicLocales.locale);
+            const hasTranslations = dynamicLocales.locales.length > 0 ||
+                this.translations()[dynamicLocales.locale];
+            if (hasTranslations) {
+                this.loadQueue.update((q) => q.filter((l) => l !== dynamicLocales.locale));
+                this.locale.set(dynamicLocales.locale);
+            }
         });
     }
     formatMessage(key, values) {
-        const message = this.translations()[this.locale()]?.[key] ?? '';
-        if (!message)
+        const message = this.translations()[this.locale()]?.[key] ??
+            this.translations()[this.defaultLocale]?.[key] ??
+            '';
+        if (!message) {
+            if (this.attemptedFallbackLoad)
+                return '';
+            this.attemptedFallbackLoad = true;
+            untracked(() => {
+                if (!this.loadQueue().includes(this.defaultLocale))
+                    this.loadQueue.update((q) => [...q, this.defaultLocale]);
+            });
             return '';
+        }
         return this.intl().formatMessage({ id: key, defaultMessage: message }, values);
     }
     register(namespace, flat) {
@@ -204,12 +296,22 @@ function injectIntl() {
  */
 function injectDynamicLocale() {
     const store = inject(TranslationStore);
+    const supportedLocales = injectIntlConfig()?.supportedLocales;
     const source = computed(() => store.locale());
+    const inSupportedLocales = supportedLocales === undefined
+        ? () => true
+        : (locale) => supportedLocales.includes(locale);
     const set = (value) => {
         if (value === untracked(source) ||
-            !store.hasLocaleLoaders(value) ||
             untracked(store.loadQueue).includes(value))
             return;
+        if (!inSupportedLocales(value)) {
+            if (isDevMode())
+                console.warn(`[Translate] Locale "${value}" is not in supportedLocales, switch prevented. Available options are:`, supportedLocales);
+            return;
+        }
+        if (isDevMode() && !store.hasLocaleLoaders(value))
+            console.warn(`[Translate] No loaders registered for locale "${value}". Switching to this locale will have no effect.`);
         store.loadQueue.update((q) => [...q, value]);
     };
     source.set = set;
@@ -274,10 +376,29 @@ function registerNamespace(defaultTranslation, other) {
         return addSignalFn(createT(store), store);
     };
     let defaultTranslationLoaded = false;
-    const resolver = async () => {
+    const resolver = async (snapshot) => {
         const store = inject(TranslationStore);
-        const locale = untracked(store.locale);
+        let locale = null;
+        const paramName = injectIntlConfig()?.localeParamName;
+        const routerConfig = inject(Router)['options'];
+        const alwaysInheritParams = typeof routerConfig === 'object' &&
+            !!routerConfig &&
+            routerConfig.paramsInheritanceStrategy === 'always';
+        if (paramName) {
+            locale = snapshot.paramMap.get(paramName);
+            if (!locale && !alwaysInheritParams) {
+                let currentRoute = snapshot;
+                while (currentRoute && !locale) {
+                    locale = currentRoute.paramMap.get('locale');
+                    currentRoute = currentRoute.parent;
+                }
+            }
+        }
+        if (!locale) {
+            locale = untracked(store.locale);
+        }
         const defaultLocale = injectDefaultLocale();
+        const shouldPreloadDefault = injectIntlConfig()?.preloadDefaultLocale ?? false;
         const tPromise = other[locale];
         const promise = tPromise ?? defaultTranslation;
         if (!promise && isDevMode()) {
@@ -286,28 +407,43 @@ function registerNamespace(defaultTranslation, other) {
         if (promise === defaultTranslation && defaultTranslationLoaded)
             return;
         try {
-            const translation = await promise();
-            if (promise !== defaultTranslation &&
-                translation.locale !== locale &&
-                isDevMode()) {
-                return console.warn(`Expected locale to be ${locale} but got ${translation.locale}`);
-            }
-            store.registerOnDemandLoaders(translation.namespace, {
+            const promises = [promise()];
+            if (shouldPreloadDefault &&
+                !defaultTranslationLoaded &&
+                promise !== defaultTranslation)
+                promises.push(defaultTranslation());
+            const translations = await Promise.allSettled(promises);
+            const fullfilled = translations.map((t) => t.status === 'fulfilled' ? t.value : null);
+            if (fullfilled.at(0) === null && fullfilled.at(1) === null)
+                throw new Error('Failed to load translations');
+            const [t, defaultT] = fullfilled;
+            const ns = t?.namespace ?? defaultT?.namespace;
+            if (!ns)
+                throw new Error('No namespace found in translation');
+            if (isDevMode() && t && t.locale !== locale && t.locale !== defaultLocale)
+                console.warn(`Expected locale to be ${locale} but got ${t.locale}`);
+            store.registerOnDemandLoaders(ns, {
                 ...other,
                 [defaultLocale]: defaultTranslation,
             });
-            store.register(translation.namespace, {
-                [locale]: translation.flat,
-            });
-            if (promise === defaultTranslation) {
+            const toRegister = {};
+            if (t)
+                toRegister[locale] = t.flat;
+            if (defaultT)
+                toRegister[defaultLocale] = defaultT.flat;
+            store.register(ns, toRegister);
+            if (promise === defaultTranslation || defaultT)
                 defaultTranslationLoaded = true;
-            }
         }
         catch {
             if (isDevMode()) {
                 console.warn(`Failed to load translation for locale: ${locale}`);
             }
         }
+        finally {
+            if (locale !== untracked(store.locale))
+                store.locale.set(locale);
+        }
     };
     return {
         injectNamespaceT: injectT,
@@ -315,6 +451,35 @@ function registerNamespace(defaultTranslation, other) {
     };
 }
 
+/**
+ * Guard that validates the locale parameter against supported locales.
+ * Redirects to default locale if the locale is invalid.
+ *
+ * @param prefixSegments Optional array of path segments preceding the locale segment.
+ * if (you wanted to match /app/:locale/... you would pass ['app'] here) & the function would match the second parameter + redirect accordingly
+ *
+ * @example
+ * ```typescript
+ * {
+ *   path: ':locale',
+ *   canMatch: [canMatchLocale()],
+ *   children: [...]
+ * }
+ * ```
+ */
+function canMatchLocale(prefixSegments = []) {
+    return (_route, segments) => {
+        const supportedLocales = injectSupportedLocales();
+        const locale = segments.at(prefixSegments.length)?.path;
+        if (!locale || !supportedLocales.includes(locale))
+            return inject(Router).createUrlTree([
+                ...prefixSegments,
+                injectDefaultLocale(),
+            ]);
+        return true;
+    };
+}
+
 class Translate {
     t = createT(inject(TranslationStore));
     translate = input.required(...(ngDevMode ? [{ debugName: "translate" }] : []));
@@ -374,5 +539,5 @@ class Translator {
  * Generated bundle index. Do not edit.
  */
 
-export { Translate, Translator, compileTranslation, createNamespace, injectDynamicLocale, injectIntl, provideIntlConfig, registerNamespace };
+export { Translate, Translator, canMatchLocale, compileTranslation, createNamespace, injectDynamicLocale, injectIntl, injectSupportedLocales, provideIntlConfig, registerNamespace };
 //# sourceMappingURL=mmstack-translate.mjs.map

package/fesm2022/mmstack-translate.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mmstack-translate.mjs","sources":["../../../../packages/translate/src/lib/delim.ts","../../../../packages/translate/src/lib/compile.ts","../../../../packages/translate/src/lib/create-namespace.ts","../../../../packages/translate/src/lib/translation-store.ts","../../../../packages/translate/src/lib/register-namespace.ts","../../../../packages/translate/src/lib/translate.ts","../../../../packages/translate/src/lib/translator.ts","../../../../packages/translate/src/mmstack-translate.ts"],"sourcesContent":["const KEY_DELIM = '::MMT_DELIM::';\n\nexport function prependDelim(prefix: string, key: string): string {\n  return `${prefix}${KEY_DELIM}${key}`;\n}\n\nexport function replaceWithDelim(str: string, repl = '.'): string {\n  return str.replaceAll(repl, KEY_DELIM);\n}\n","import { prependDelim } from './delim';\nimport type {\n  inferTranslationParamMap,\n  inferTranslationShape,\n} from './parameterize.type';\nimport type { UnknownStringKeyObject } from './string-key-object.type';\n\nconst INTERNAL_SYMBOL = Symbol.for('mmstack-translate-internal');\n\ntype InternalSymbol = typeof INTERNAL_SYMBOL;\n\nexport type CompiledTranslation<\n  T extends UnknownStringKeyObject,\n  TNS extends string,\n  TLocale extends string = string,\n> = {\n  flat: Record<string, string>;\n  locale?: TLocale;\n  namespace: TNS;\n  [INTERNAL_SYMBOL]: {\n    shape: inferTranslationShape<T>;\n    map: inferTranslationParamMap<TNS, T>;\n  };\n};\n\nexport type mergeTranslationMaps<\n  TMain extends CompiledTranslation<UnknownStringKeyObject, string>,\n  TOther extends CompiledTranslation<UnknownStringKeyObject, string>,\n> = Omit<TMain, InternalSymbol> & {\n  [INTERNAL_SYMBOL]: {\n    shape: inferCompiledTranslationShape<TMain>;\n    map: inferCompiledTranslationMap<TOther> &\n      inferCompiledTranslationMap<TMain>;\n  };\n};\n\nexport type inferCompiledTranslationNamespace<\n  T extends CompiledTranslation<UnknownStringKeyObject, string>,\n> = T['namespace'];\n\nexport type inferCompiledTranslationShape<\n  T extends CompiledTranslation<UnknownStringKeyObject, string>,\n> = T[InternalSymbol]['shape'];\n\nexport type inferCompiledTranslationMap<\n  T extends CompiledTranslation<UnknownStringKeyObject, string>,\n> = T[InternalSymbol]['map'];\n\nfunction isTranslationObject(t: unknown): t is UnknownStringKeyObject {\n  return typeof t === 'object' && t !== null;\n}\n\nfunction flattenTranslation<T extends UnknownStringKeyObject>(obj: T) {\n  return Object.entries(obj).reduce(\n    (acc, [key, value]) => {\n      if (typeof value === 'string') {\n        acc[key] = value;\n      } else if (isTranslationObject(value)) {\n        Object.entries(flattenTranslation(value)).forEach(\n          ([nestedKey, nestedValue]) => {\n            acc[prependDelim(key, nestedKey)] = nestedValue;\n          },\n        );\n      }\n\n      return acc;\n    },\n    {} as Record<string, string>,\n  );\n}\n\nexport function compileTranslation<\n  T extends UnknownStringKeyObject,\n  TNS extends string,\n  TLocale extends string = string,\n>(\n  translation: T,\n  ns: TNS,\n  locale?: TLocale,\n): CompiledTranslation<T, TNS, TLocale> {\n  type $Shape = inferTranslationShape<T>;\n  type $Map = inferTranslationParamMap<TNS, T>;\n\n  return {\n    locale,\n    flat: flattenTranslation(translation),\n    namespace: ns,\n    [INTERNAL_SYMBOL]: {\n      shape: {} as $Shape,\n      map: {} as $Map,\n    },\n  };\n}\n","import {\n  CompiledTranslation,\n  compileTranslation,\n  inferCompiledTranslationShape,\n  mergeTranslationMaps,\n} from './compile';\nimport { UnknownStringKeyObject } from './string-key-object.type';\n\ntype TranslationNamespace<\n  TNS extends string,\n  T extends CompiledTranslation<UnknownStringKeyObject, TNS>,\n  TShape extends UnknownStringKeyObject,\n> = {\n  translation: T;\n  createTranslation: <TLocale extends string>(\n    locale: TLocale,\n    translation: TShape,\n  ) => CompiledTranslation<TShape, TNS, TLocale>;\n  createMergedNamespace: <\n    TOtherNS extends string,\n    const TOther extends UnknownStringKeyObject,\n    TOtherCompiled extends CompiledTranslation<TOther, TOtherNS>,\n  >(\n    ns: TOtherNS,\n    translation: TOther,\n  ) => TranslationNamespace<\n    TOtherNS,\n    mergeTranslationMaps<TOtherCompiled, T>,\n    inferCompiledTranslationShape<TOtherCompiled>\n  >;\n};\n\nexport function createNamespace<\n  const T extends UnknownStringKeyObject,\n  TNS extends string,\n>(ns: TNS, translation: T) {\n  const compiled = compileTranslation<T, TNS>(translation, ns);\n\n  type TCompiled = typeof compiled;\n  type TShape = inferCompiledTranslationShape<typeof compiled>;\n\n  const namespace: TranslationNamespace<TNS, TCompiled, TShape> = {\n    translation: compileTranslation(translation, ns),\n    createTranslation: <TLocale extends string>(\n      locale: TLocale,\n      translation: TShape,\n    ) => {\n      return compileTranslation(translation, ns, locale);\n    },\n    createMergedNamespace: <\n      TOther extends UnknownStringKeyObject,\n      TOtherNS extends string,\n      TOtherCompiled extends CompiledTranslation<\n        TOther,\n        TOtherNS\n      > = CompiledTranslation<TOther, TOtherNS>,\n    >(\n      otherNs: TOtherNS,\n      otherTranslation: TOther,\n    ) => {\n      return createNamespace(otherNs, otherTranslation) as TranslationNamespace<\n        TOtherNS,\n        mergeTranslationMaps<TOtherCompiled, TCompiled>,\n        inferCompiledTranslationShape<TOtherCompiled>\n      > as unknown as any;\n    },\n  };\n\n  return namespace;\n}\n","import {\n  computed,\n  effect,\n  inject,\n  Injectable,\n  InjectionToken,\n  isDevMode,\n  LOCALE_ID,\n  Provider,\n  resource,\n  Signal,\n  signal,\n  untracked,\n  WritableSignal,\n} from '@angular/core';\nimport { createIntl, createIntlCache, type IntlConfig } from '@formatjs/intl';\nimport { CompiledTranslation } from './compile';\nimport { prependDelim } from './delim';\nimport { UnknownStringKeyObject } from './string-key-object.type';\n\nconst CONFIG_TOKEN = new InjectionToken<\n  Omit<IntlConfig, 'locale' | 'messages'>\n>('mmstack-intl-config');\n\nexport function provideIntlConfig(\n  config: Omit<IntlConfig, 'locale' | 'messages'>,\n): Provider {\n  return {\n    useValue: config,\n    provide: CONFIG_TOKEN,\n  };\n}\n\nexport function injectIntlConfig() {\n  return inject(CONFIG_TOKEN, { optional: true }) ?? undefined;\n}\n\nexport function injectDefaultLocale() {\n  return injectIntlConfig()?.defaultLocale ?? 'en-US';\n}\n\n@Injectable({\n  providedIn: 'root',\n})\nexport class TranslationStore {\n  private readonly cache = createIntlCache();\n  private readonly config = injectIntlConfig();\n  readonly loadQueue = signal<string[]>([]);\n  readonly locale = signal(inject(LOCALE_ID));\n  private readonly defaultLocale = injectDefaultLocale();\n  private readonly translations = signal<\n    Record<string, Record<string, string>>\n  >({\n    [this.defaultLocale]: {},\n  });\n\n  private readonly onDemandLoaders = new Map<\n    string,\n    Record<\n      string,\n      () => Promise<CompiledTranslation<UnknownStringKeyObject, string>>\n    >\n  >();\n\n  private readonly nonMessageConfig = computed(() => ({\n    ...this.config,\n    locale: this.locale(),\n  }));\n\n  private readonly messages = computed(\n    () =>\n      this.translations()[this.locale()] ??\n      this.translations()[this.defaultLocale] ??\n      {},\n  );\n\n  readonly dynamicLocaleLoader = resource({\n    params: computed(() => this.loadQueue().at(0) ?? null),\n    loader: async ({ params: newLocale, abortSignal }) => {\n      if (!newLocale) return;\n\n      const currentTranslations = untracked(this.translations);\n\n      const loadPromises: Promise<{\n        namespace: string;\n        flat: Record<string, string>;\n      } | null>[] = [];\n\n      for (const [namespace, loaders] of this.onDemandLoaders.entries()) {\n        const loader = loaders[newLocale];\n        if (loader) {\n          const hasNamespaceForLocale =\n            currentTranslations[newLocale] &&\n            Object.keys(currentTranslations[newLocale]).some((key) =>\n              key.startsWith(`${prependDelim(namespace, '').slice(0, -1)}`),\n            );\n\n          if (!hasNamespaceForLocale) {\n            loadPromises.push(\n              loader()\n                .then((translation) => {\n                  if (abortSignal.aborted) return null;\n                  return {\n                    namespace: translation.namespace,\n                    flat: translation.flat,\n                  };\n                })\n                .catch((err) => {\n                  if (isDevMode()) {\n                    console.error(\n                      '[Translate] Failed to load',\n                      namespace,\n                      newLocale,\n                      err,\n                    );\n                  }\n\n                  return null;\n                }),\n            );\n          }\n        }\n      }\n\n      return Promise.all(loadPromises)\n        .then((res) => res.filter((r) => r !== null))\n        .then((res) => ({\n          locales: res,\n          locale: newLocale,\n        }));\n    },\n  });\n\n  readonly intl = computed(() =>\n    createIntl(\n      {\n        ...this.nonMessageConfig(),\n        messages: this.messages(),\n      },\n      this.cache,\n    ),\n  );\n\n  constructor() {\n    effect(() => {\n      if (\n        // should never be in error state, but best to check in case something throws\n        this.dynamicLocaleLoader.error() ||\n        this.dynamicLocaleLoader.isLoading()\n      )\n        return;\n      const dynamicLocales = this.dynamicLocaleLoader.value();\n\n      if (!dynamicLocales) return;\n      for (const locale of dynamicLocales.locales) {\n        this.register(locale.namespace, {\n          [dynamicLocales.locale]: locale.flat,\n        });\n      }\n      this.loadQueue.update((q) =>\n        q.filter((l) => l !== dynamicLocales.locale),\n      );\n      this.locale.set(dynamicLocales.locale);\n    });\n  }\n\n  formatMessage(key: string, values?: Record<string, string | number>) {\n    const message = this.translations()[this.locale()]?.[key] ?? '';\n\n    if (!message) return '';\n\n    return this.intl().formatMessage(\n      { id: key, defaultMessage: message },\n      values,\n    );\n  }\n\n  register(\n    namespace: string,\n    flat: Partial<Record<string, Record<string, string>>>,\n  ) {\n    this.translations.update((cur) => {\n      return Object.entries(flat).reduce(\n        (acc, [locale, translation]) => {\n          const localeTranslation = acc[locale] ?? {};\n\n          const withNS = Object.entries(translation ?? {}).reduce(\n            (acc, [key, value]) => {\n              acc[prependDelim(namespace, key)] = value;\n              return acc;\n            },\n            {} as Record<string, string>,\n          );\n\n          acc[locale] = {\n            ...localeTranslation,\n            ...withNS,\n          };\n\n          return acc;\n        },\n        { ...cur },\n      );\n    });\n  }\n\n  registerOnDemandLoaders(\n    namespace: string,\n    loaders: Record<string, () => Promise<any>>,\n  ) {\n    this.onDemandLoaders.set(namespace, loaders);\n  }\n\n  hasLocaleLoaders(locale: string): boolean {\n    return Array.from(this.onDemandLoaders.values()).some(\n      (loaders) => loaders[locale],\n    );\n  }\n}\n\nexport function injectIntl() {\n  return inject(TranslationStore).intl;\n}\n\n/**\n * Inject a dynamic locale signal that supports runtime language switching.\n *\n * @returns A writable signal with the current locale and loading state.\n * Only allows switching to locales that have registered loaders.\n *\n * @example\n * ```typescript\n * const locale = injectDynamicLocale();\n *\n * // Switch language (triggers automatic translation loading)\n * locale.set('sl-SI');\n *\n * // Check loading state\n * if (locale.isLoading()) {\n *   // Show spinner\n * }\n * ```\n */\nexport function injectDynamicLocale(): WritableSignal<string> & {\n  isLoading: Signal<boolean>;\n} {\n  const store = inject(TranslationStore);\n\n  const source = computed(() => store.locale()) as WritableSignal<string> & {\n    isLoading: Signal<boolean>;\n  };\n\n  const set = (value: string) => {\n    if (\n      value === untracked(source) ||\n      !store.hasLocaleLoaders(value) ||\n      untracked(store.loadQueue).includes(value)\n    )\n      return;\n    store.loadQueue.update((q) => [...q, value]);\n  };\n  source.set = set;\n  source.update = (updater: (value: string) => string) => {\n    const next = updater(untracked(source));\n    source.set(next);\n  };\n  source.asReadonly = () => source;\n\n  source.isLoading = store.dynamicLocaleLoader.isLoading;\n\n  return source;\n}\n","import {\n  computed,\n  inject,\n  isDevMode,\n  isSignal,\n  Signal,\n  untracked,\n} from '@angular/core';\nimport {\n  CompiledTranslation,\n  inferCompiledTranslationMap,\n  inferCompiledTranslationNamespace,\n} from './compile';\nimport { replaceWithDelim } from './delim';\nimport { UnknownStringKeyObject } from './string-key-object.type';\nimport { injectDefaultLocale, TranslationStore } from './translation-store';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyStringRecord = Record<string, any>;\n\nfunction createEqualsRecord<T extends AnyStringRecord>(keys: (keyof T)[] = []) {\n  let keyMatcher: (a: T, b: T) => boolean;\n\n  if (keys.length === 0) {\n    keyMatcher = () => true;\n  } else if (keys.length === 1) {\n    const key = keys[0];\n    keyMatcher = (a, b) => a[key] === b[key];\n  } else {\n    keyMatcher = (a, b) => {\n      return keys.every((k) => a[k] === b[k]);\n    };\n  }\n\n  return (a?: T, b?: T): boolean => {\n    if (!a && !b) return true;\n    if (!a || !b) return false;\n    return keyMatcher(a, b);\n  };\n}\n\ntype TFunction<TMap extends AnyStringRecord> = <\n  TKey extends keyof TMap & string,\n>(\n  key: TKey,\n  ...args: TMap[TKey] extends void ? [] : [TMap[TKey]]\n) => string;\n\ntype SignalTFunction<TMap extends AnyStringRecord> = <\n  TKey extends keyof TMap & string,\n>(\n  key: TKey,\n  ...args: TMap[TKey] extends void ? [] : [() => TMap[TKey]]\n) => Signal<string>;\n\ntype TFunctionWithSignalConstructor<\n  TMap extends AnyStringRecord,\n  TFN extends TFunction<TMap>,\n> = TFN & {\n  asSignal: SignalTFunction<TMap>;\n};\n\nfunction addSignalFn<TMap extends AnyStringRecord, TFn extends TFunction<TMap>>(\n  fn: TFn,\n  store: TranslationStore,\n): TFunctionWithSignalConstructor<TMap, TFn> {\n  const withSig = fn as TFunctionWithSignalConstructor<TMap, TFn>;\n\n  const asSignal = <TKey extends keyof TMap & string>(\n    key: TKey,\n    ...args: TMap[TKey] extends void ? [] : [() => TMap[TKey]]\n  ): Signal<string> => {\n    const variables = args[0] as () => AnyStringRecord | undefined;\n    const stringKey = key as string;\n\n    const flatPath = replaceWithDelim(stringKey);\n\n    const varsFn = variables ?? (() => undefined);\n    const varsSignal = isSignal(varsFn)\n      ? varsFn\n      : computed(varsFn, {\n          equal: createEqualsRecord(Object.keys(varsFn() ?? {})),\n        });\n\n    return computed(() => store.formatMessage(flatPath, varsSignal()));\n  };\n\n  withSig.asSignal = asSignal;\n\n  return withSig;\n}\n\nexport function createT<TMap extends AnyStringRecord>(\n  store: TranslationStore,\n): TFunction<TMap> {\n  return <TKey extends keyof TMap & string>(\n    key: TKey,\n    ...args: TMap[TKey] extends void ? [] : [TMap[TKey]]\n  ): string => {\n    const variables = args[0] as AnyStringRecord | undefined;\n    const stringKey = key as string;\n\n    return store.formatMessage(replaceWithDelim(stringKey), variables);\n  };\n}\n\nexport function registerNamespace<\n  TDefault extends CompiledTranslation<UnknownStringKeyObject, string>,\n>(\n  defaultTranslation: () => Promise<TDefault>,\n  other: Record<\n    string,\n    () => Promise<\n      CompiledTranslation<\n        UnknownStringKeyObject,\n        inferCompiledTranslationNamespace<TDefault>,\n        string\n      >\n    >\n  >,\n) {\n  type $Map = inferCompiledTranslationMap<TDefault>;\n  type $BaseTFN = TFunction<$Map>;\n  type $TFN = TFunctionWithSignalConstructor<$Map, $BaseTFN>;\n\n  const injectT = (): $TFN => {\n    const store = inject(TranslationStore);\n\n    return addSignalFn(createT(store), store);\n  };\n\n  let defaultTranslationLoaded = false;\n  const resolver = async () => {\n    const store = inject(TranslationStore);\n    const locale = untracked(store.locale);\n    const defaultLocale = injectDefaultLocale();\n    const tPromise = other[locale] as (typeof other)[string] | undefined;\n\n    const promise = tPromise ?? defaultTranslation;\n    if (!promise && isDevMode()) {\n      return console.warn(`No translation found for locale: ${locale}`);\n    }\n\n    if (promise === defaultTranslation && defaultTranslationLoaded) return;\n\n    try {\n      const translation = await promise();\n\n      if (\n        promise !== defaultTranslation &&\n        translation.locale !== locale &&\n        isDevMode()\n      ) {\n        return console.warn(\n          `Expected locale to be ${locale} but got ${translation.locale}`,\n        );\n      }\n\n      store.registerOnDemandLoaders(translation.namespace, {\n        ...other,\n        [defaultLocale]: defaultTranslation,\n      });\n\n      store.register(translation.namespace, {\n        [locale]: translation.flat,\n      });\n      if (promise === defaultTranslation) {\n        defaultTranslationLoaded = true;\n      }\n    } catch {\n      if (isDevMode()) {\n        console.warn(`Failed to load translation for locale: ${locale}`);\n      }\n    }\n  };\n\n  return {\n    injectNamespaceT: injectT,\n    resolveNamespaceTranslation: resolver,\n  };\n}\n","import {\n  afterRenderEffect,\n  computed,\n  Directive,\n  ElementRef,\n  inject,\n  input,\n  Renderer2,\n} from '@angular/core';\nimport { CompiledTranslation, inferCompiledTranslationMap } from './compile';\nimport { createT } from './register-namespace';\nimport { UnknownStringKeyObject } from './string-key-object.type';\nimport { TranslationStore } from './translation-store';\n\n@Directive()\nexport abstract class Translate<\n  TInput extends string,\n  T extends CompiledTranslation<UnknownStringKeyObject, string>,\n  TMap extends inferCompiledTranslationMap<T> = inferCompiledTranslationMap<T>,\n  TKey extends TInput & keyof TMap & string = TInput & keyof TMap & string,\n> {\n  private readonly t = createT(inject(TranslationStore));\n\n  readonly translate =\n    input.required<\n      TMap[TKey] extends void\n        ? TKey | [key: TKey]\n        : [key: TKey, vars: TMap[TKey]]\n    >();\n\n  constructor() {\n    const key = computed(() => {\n      const vars = this.translate();\n      return (Array.isArray(vars) ? vars[0] : vars) as TKey;\n    });\n\n    const args = computed(\n      () => {\n        const vars = this.translate();\n        return (Array.isArray(vars) ? vars[1] : undefined) as TMap[TKey];\n      },\n      {\n        equal: (a, b) => {\n          if (a === undefined && b === undefined) return true;\n          if (a === undefined || b === undefined) return false;\n\n          const aObj = a as Record<string, string>;\n          const keys = Object.keys(aObj);\n          const bObj = b as Record<string, string>;\n\n          if (!keys.length) return !Object.keys(bObj).length;\n\n          return keys.every((key) => aObj[key] === bObj[key]);\n        },\n      },\n    );\n\n    const translation = computed(() => this.t(key(), args()));\n\n    const renderer = inject(Renderer2);\n    const el = inject<ElementRef<HTMLElement>>(ElementRef);\n\n    afterRenderEffect({\n      write: () => {\n        renderer.setProperty(el.nativeElement, 'textContent', translation());\n      },\n    });\n  }\n}\n","import { ChangeDetectorRef, effect, inject } from '@angular/core';\nimport { CompiledTranslation, inferCompiledTranslationMap } from './compile';\nimport { createT } from './register-namespace';\nimport { UnknownStringKeyObject } from './string-key-object.type';\nimport { TranslationStore } from './translation-store';\n\nexport abstract class Translator<\n  T extends CompiledTranslation<UnknownStringKeyObject, string>,\n  TMap extends inferCompiledTranslationMap<T> = inferCompiledTranslationMap<T>,\n> {\n  private readonly store = inject(TranslationStore);\n  private readonly t = createT<TMap>(this.store);\n\n  constructor() {\n    const cdr = inject(ChangeDetectorRef);\n\n    effect(() => {\n      this.store.locale();\n      cdr.markForCheck();\n    });\n  }\n\n  transform<K extends keyof TMap & string>(\n    key: K,\n    ...args: TMap[K] extends void\n      ? [locale?: string]\n      : [TMap[K], locale?: string]\n  ): string {\n    const actualArgs = args.filter(\n      (a) => typeof a === 'object',\n    ) as TMap[K] extends void ? [] : [TMap[K]];\n\n    return this.t(key, ...actualArgs);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAAA,MAAM,SAAS,GAAG,eAAe;AAE3B,SAAU,YAAY,CAAC,MAAc,EAAE,GAAW,EAAA;AACtD,IAAA,OAAO,GAAG,MAAM,CAAA,EAAG,SAAS,CAAA,EAAG,GAAG,EAAE;AACtC;SAEgB,gBAAgB,CAAC,GAAW,EAAE,IAAI,GAAG,GAAG,EAAA;IACtD,OAAO,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC;AACxC;;ACDA,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC;AAyChE,SAAS,mBAAmB,CAAC,CAAU,EAAA;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;AAC5C;AAEA,SAAS,kBAAkB,CAAmC,GAAM,EAAA;AAClE,IAAA,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAC/B,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,KAAI;AACpB,QAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AAC7B,YAAA,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK;QAClB;AAAO,aAAA,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE;AACrC,YAAA,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAC/C,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,KAAI;gBAC3B,GAAG,CAAC,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,GAAG,WAAW;AACjD,YAAA,CAAC,CACF;QACH;AAEA,QAAA,OAAO,GAAG;IACZ,CAAC,EACD,EAA4B,CAC7B;AACH;SAEgB,kBAAkB,CAKhC,WAAc,EACd,EAAO,EACP,MAAgB,EAAA;IAKhB,OAAO;QACL,MAAM;AACN,QAAA,IAAI,EAAE,kBAAkB,CAAC,WAAW,CAAC;AACrC,QAAA,SAAS,EAAE,EAAE;QACb,CAAC,eAAe,GAAG;AACjB,YAAA,KAAK,EAAE,EAAY;AACnB,YAAA,GAAG,EAAE,EAAU;AAChB,SAAA;KACF;AACH;;AC5DM,SAAU,eAAe,CAG7B,EAAO,EAAE,WAAc,EAAA;IACvB,MAAM,QAAQ,GAAG,kBAAkB,CAAS,WAAW,EAAE,EAAE,CAAC;AAK5D,IAAA,MAAM,SAAS,GAAiD;AAC9D,QAAA,WAAW,EAAE,kBAAkB,CAAC,WAAW,EAAE,EAAE,CAAC;AAChD,QAAA,iBAAiB,EAAE,CACjB,MAAe,EACf,WAAmB,KACjB;YACF,OAAO,kBAAkB,CAAC,WAAW,EAAE,EAAE,EAAE,MAAM,CAAC;QACpD,CAAC;AACD,QAAA,qBAAqB,EAAE,CAQrB,OAAiB,EACjB,gBAAwB,KACtB;AACF,YAAA,OAAO,eAAe,CAAC,OAAO,EAAE,gBAAgB,CAI7B;QACrB,CAAC;KACF;AAED,IAAA,OAAO,SAAS;AAClB;;ACjDA,MAAM,YAAY,GAAG,IAAI,cAAc,CAErC,qBAAqB,CAAC;AAElB,SAAU,iBAAiB,CAC/B,MAA+C,EAAA;IAE/C,OAAO;AACL,QAAA,QAAQ,EAAE,MAAM;AAChB,QAAA,OAAO,EAAE,YAAY;KACtB;AACH;SAEgB,gBAAgB,GAAA;AAC9B,IAAA,OAAO,MAAM,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,SAAS;AAC9D;SAEgB,mBAAmB,GAAA;AACjC,IAAA,OAAO,gBAAgB,EAAE,EAAE,aAAa,IAAI,OAAO;AACrD;MAKa,gBAAgB,CAAA;IACV,KAAK,GAAG,eAAe,EAAE;IACzB,MAAM,GAAG,gBAAgB,EAAE;AACnC,IAAA,SAAS,GAAG,MAAM,CAAW,EAAE,qDAAC;IAChC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,kDAAC;IAC1B,aAAa,GAAG,mBAAmB,EAAE;IACrC,YAAY,GAAG,MAAM,CAEpC;AACA,QAAA,CAAC,IAAI,CAAC,aAAa,GAAG,EAAE;AACzB,KAAA,EAAA,IAAA,SAAA,GAAA,CAAA,EAAA,SAAA,EAAA,cAAA,EAAA,CAAA,GAAA,EAAA,CAAA,CAAC;AAEe,IAAA,eAAe,GAAG,IAAI,GAAG,EAMvC;AAEc,IAAA,gBAAgB,GAAG,QAAQ,CAAC,OAAO;QAClD,GAAG,IAAI,CAAC,MAAM;AACd,QAAA,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;AACtB,KAAA,CAAC,4DAAC;AAEc,IAAA,QAAQ,GAAG,QAAQ,CAClC,MACE,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;AAClC,QAAA,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC;AACvC,QAAA,EAAE,oDACL;IAEQ,mBAAmB,GAAG,QAAQ,CAAA,EAAA,IAAA,SAAA,GAAA,EAAA,SAAA,EAAA,qBAAA,EAAA,GAAA,EAAA,CAAA,EACrC,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACtD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,KAAI;AACnD,YAAA,IAAI,CAAC,SAAS;gBAAE;YAEhB,MAAM,mBAAmB,GAAG,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC;YAExD,MAAM,YAAY,GAGJ,EAAE;AAEhB,YAAA,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,EAAE;AACjE,gBAAA,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;gBACjC,IAAI,MAAM,EAAE;AACV,oBAAA,MAAM,qBAAqB,GACzB,mBAAmB,CAAC,SAAS,CAAC;AAC9B,wBAAA,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,KACnD,GAAG,CAAC,UAAU,CAAC,CAAA,EAAG,YAAY,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA,CAAE,CAAC,CAC9D;oBAEH,IAAI,CAAC,qBAAqB,EAAE;AAC1B,wBAAA,YAAY,CAAC,IAAI,CACf,MAAM;AACH,6BAAA,IAAI,CAAC,CAAC,WAAW,KAAI;4BACpB,IAAI,WAAW,CAAC,OAAO;AAAE,gCAAA,OAAO,IAAI;4BACpC,OAAO;gCACL,SAAS,EAAE,WAAW,CAAC,SAAS;gCAChC,IAAI,EAAE,WAAW,CAAC,IAAI;6BACvB;AACH,wBAAA,CAAC;AACA,6BAAA,KAAK,CAAC,CAAC,GAAG,KAAI;4BACb,IAAI,SAAS,EAAE,EAAE;gCACf,OAAO,CAAC,KAAK,CACX,4BAA4B,EAC5B,SAAS,EACT,SAAS,EACT,GAAG,CACJ;4BACH;AAEA,4BAAA,OAAO,IAAI;wBACb,CAAC,CAAC,CACL;oBACH;gBACF;YACF;AAEA,YAAA,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY;AAC5B,iBAAA,IAAI,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;AAC3C,iBAAA,IAAI,CAAC,CAAC,GAAG,MAAM;AACd,gBAAA,OAAO,EAAE,GAAG;AACZ,gBAAA,MAAM,EAAE,SAAS;AAClB,aAAA,CAAC,CAAC;AACP,QAAA,CAAC,GACD;AAEO,IAAA,IAAI,GAAG,QAAQ,CAAC,MACvB,UAAU,CACR;QACE,GAAG,IAAI,CAAC,gBAAgB,EAAE;AAC1B,QAAA,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;AAC1B,KAAA,EACD,IAAI,CAAC,KAAK,CACX,gDACF;AAED,IAAA,WAAA,GAAA;QACE,MAAM,CAAC,MAAK;AACV,YAAA;;AAEE,YAAA,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE;AAChC,gBAAA,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE;gBAEpC;YACF,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE;AAEvD,YAAA,IAAI,CAAC,cAAc;gBAAE;AACrB,YAAA,KAAK,MAAM,MAAM,IAAI,cAAc,CAAC,OAAO,EAAE;AAC3C,gBAAA,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE;AAC9B,oBAAA,CAAC,cAAc,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI;AACrC,iBAAA,CAAC;YACJ;YACA,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,KACtB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,cAAc,CAAC,MAAM,CAAC,CAC7C;YACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC;AACxC,QAAA,CAAC,CAAC;IACJ;IAEA,aAAa,CAAC,GAAW,EAAE,MAAwC,EAAA;AACjE,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE;AAE/D,QAAA,IAAI,CAAC,OAAO;AAAE,YAAA,OAAO,EAAE;AAEvB,QAAA,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,aAAa,CAC9B,EAAE,EAAE,EAAE,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,EACpC,MAAM,CACP;IACH;IAEA,QAAQ,CACN,SAAiB,EACjB,IAAqD,EAAA;QAErD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,KAAI;AAC/B,YAAA,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAChC,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,KAAI;gBAC7B,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;gBAE3C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CACrD,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,KAAI;oBACpB,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK;AACzC,oBAAA,OAAO,GAAG;gBACZ,CAAC,EACD,EAA4B,CAC7B;gBAED,GAAG,CAAC,MAAM,CAAC,GAAG;AACZ,oBAAA,GAAG,iBAAiB;AACpB,oBAAA,GAAG,MAAM;iBACV;AAED,gBAAA,OAAO,GAAG;AACZ,YAAA,CAAC,EACD,EAAE,GAAG,GAAG,EAAE,CACX;AACH,QAAA,CAAC,CAAC;IACJ;IAEA,uBAAuB,CACrB,SAAiB,EACjB,OAA2C,EAAA;QAE3C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC;IAC9C;AAEA,IAAA,gBAAgB,CAAC,MAAc,EAAA;QAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACnD,CAAC,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAC7B;IACH;uGA7KW,gBAAgB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,UAAA,EAAA,CAAA;AAAhB,IAAA,OAAA,KAAA,GAAA,EAAA,CAAA,qBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,QAAA,EAAA,EAAA,EAAA,IAAA,EAAA,gBAAgB,cAFf,MAAM,EAAA,CAAA;;2FAEP,gBAAgB,EAAA,UAAA,EAAA,CAAA;kBAH5B,UAAU;AAAC,YAAA,IAAA,EAAA,CAAA;AACV,oBAAA,UAAU,EAAE,MAAM;AACnB,iBAAA;;SAiLe,UAAU,GAAA;AACxB,IAAA,OAAO,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI;AACtC;AAEA;;;;;;;;;;;;;;;;;;AAkBG;SACa,mBAAmB,GAAA;AAGjC,IAAA,MAAM,KAAK,GAAG,MAAM,CAAC,gBAAgB,CAAC;AAEtC,IAAA,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,MAAM,EAAE,CAE3C;AAED,IAAA,MAAM,GAAG,GAAG,CAAC,KAAa,KAAI;AAC5B,QAAA,IACE,KAAK,KAAK,SAAS,CAAC,MAAM,CAAC;AAC3B,YAAA,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC;YAC9B,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;YAE1C;AACF,QAAA,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;AAC9C,IAAA,CAAC;AACD,IAAA,MAAM,CAAC,GAAG,GAAG,GAAG;AAChB,IAAA,MAAM,CAAC,MAAM,GAAG,CAAC,OAAkC,KAAI;QACrD,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACvC,QAAA,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;AAClB,IAAA,CAAC;AACD,IAAA,MAAM,CAAC,UAAU,GAAG,MAAM,MAAM;IAEhC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,mBAAmB,CAAC,SAAS;AAEtD,IAAA,OAAO,MAAM;AACf;;AC3PA,SAAS,kBAAkB,CAA4B,IAAA,GAAoB,EAAE,EAAA;AAC3E,IAAA,IAAI,UAAmC;AAEvC,IAAA,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AACrB,QAAA,UAAU,GAAG,MAAM,IAAI;IACzB;AAAO,SAAA,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AAC5B,QAAA,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC;AACnB,QAAA,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;IAC1C;SAAO;AACL,QAAA,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,KAAI;AACpB,YAAA,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACzC,QAAA,CAAC;IACH;AAEA,IAAA,OAAO,CAAC,CAAK,EAAE,CAAK,KAAa;AAC/B,QAAA,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;AAAE,YAAA,OAAO,IAAI;AACzB,QAAA,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;AAAE,YAAA,OAAO,KAAK;AAC1B,QAAA,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC;AACzB,IAAA,CAAC;AACH;AAuBA,SAAS,WAAW,CAClB,EAAO,EACP,KAAuB,EAAA;IAEvB,MAAM,OAAO,GAAG,EAA+C;IAE/D,MAAM,QAAQ,GAAG,CACf,GAAS,EACT,GAAG,IAAuD,KACxC;AAClB,QAAA,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAsC;QAC9D,MAAM,SAAS,GAAG,GAAa;AAE/B,QAAA,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,CAAC;QAE5C,MAAM,MAAM,GAAG,SAAS,KAAK,MAAM,SAAS,CAAC;AAC7C,QAAA,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM;AAChC,cAAE;AACF,cAAE,QAAQ,CAAC,MAAM,EAAE;AACf,gBAAA,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACvD,aAAA,CAAC;AAEN,QAAA,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;AACpE,IAAA,CAAC;AAED,IAAA,OAAO,CAAC,QAAQ,GAAG,QAAQ;AAE3B,IAAA,OAAO,OAAO;AAChB;AAEM,SAAU,OAAO,CACrB,KAAuB,EAAA;AAEvB,IAAA,OAAO,CACL,GAAS,EACT,GAAG,IAAiD,KAC1C;AACV,QAAA,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAgC;QACxD,MAAM,SAAS,GAAG,GAAa;QAE/B,OAAO,KAAK,CAAC,aAAa,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;AACpE,IAAA,CAAC;AACH;AAEM,SAAU,iBAAiB,CAG/B,kBAA2C,EAC3C,KASC,EAAA;IAMD,MAAM,OAAO,GAAG,MAAW;AACzB,QAAA,MAAM,KAAK,GAAG,MAAM,CAAC,gBAAgB,CAAC;QAEtC,OAAO,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;AAC3C,IAAA,CAAC;IAED,IAAI,wBAAwB,GAAG,KAAK;AACpC,IAAA,MAAM,QAAQ,GAAG,YAAW;AAC1B,QAAA,MAAM,KAAK,GAAG,MAAM,CAAC,gBAAgB,CAAC;QACtC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;AACtC,QAAA,MAAM,aAAa,GAAG,mBAAmB,EAAE;AAC3C,QAAA,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAuC;AAEpE,QAAA,MAAM,OAAO,GAAG,QAAQ,IAAI,kBAAkB;AAC9C,QAAA,IAAI,CAAC,OAAO,IAAI,SAAS,EAAE,EAAE;YAC3B,OAAO,OAAO,CAAC,IAAI,CAAC,oCAAoC,MAAM,CAAA,CAAE,CAAC;QACnE;AAEA,QAAA,IAAI,OAAO,KAAK,kBAAkB,IAAI,wBAAwB;YAAE;AAEhE,QAAA,IAAI;AACF,YAAA,MAAM,WAAW,GAAG,MAAM,OAAO,EAAE;YAEnC,IACE,OAAO,KAAK,kBAAkB;gBAC9B,WAAW,CAAC,MAAM,KAAK,MAAM;gBAC7B,SAAS,EAAE,EACX;AACA,gBAAA,OAAO,OAAO,CAAC,IAAI,CACjB,CAAA,sBAAA,EAAyB,MAAM,CAAA,SAAA,EAAY,WAAW,CAAC,MAAM,CAAA,CAAE,CAChE;YACH;AAEA,YAAA,KAAK,CAAC,uBAAuB,CAAC,WAAW,CAAC,SAAS,EAAE;AACnD,gBAAA,GAAG,KAAK;gBACR,CAAC,aAAa,GAAG,kBAAkB;AACpC,aAAA,CAAC;AAEF,YAAA,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,SAAS,EAAE;AACpC,gBAAA,CAAC,MAAM,GAAG,WAAW,CAAC,IAAI;AAC3B,aAAA,CAAC;AACF,YAAA,IAAI,OAAO,KAAK,kBAAkB,EAAE;gBAClC,wBAAwB,GAAG,IAAI;YACjC;QACF;AAAE,QAAA,MAAM;YACN,IAAI,SAAS,EAAE,EAAE;AACf,gBAAA,OAAO,CAAC,IAAI,CAAC,0CAA0C,MAAM,CAAA,CAAE,CAAC;YAClE;QACF;AACF,IAAA,CAAC;IAED,OAAO;AACL,QAAA,gBAAgB,EAAE,OAAO;AACzB,QAAA,2BAA2B,EAAE,QAAQ;KACtC;AACH;;MCrKsB,SAAS,CAAA;IAMZ,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAE7C,IAAA,SAAS,GAChB,KAAK,CAAC,QAAQ,oDAIX;AAEL,IAAA,WAAA,GAAA;AACE,QAAA,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAK;AACxB,YAAA,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE;AAC7B,YAAA,QAAQ,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI;AAC9C,QAAA,CAAC,+CAAC;AAEF,QAAA,MAAM,IAAI,GAAG,QAAQ,CACnB,MAAK;AACH,YAAA,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE;AAC7B,YAAA,QAAQ,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS;QACnD,CAAC,EAAA,EAAA,IAAA,SAAA,GAAA,EAAA,SAAA,EAAA,MAAA,EAAA,GAAA,EAAA,CAAA,EAEC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,KAAI;AACd,gBAAA,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;AAAE,oBAAA,OAAO,IAAI;AACnD,gBAAA,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;AAAE,oBAAA,OAAO,KAAK;gBAEpD,MAAM,IAAI,GAAG,CAA2B;gBACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC9B,MAAM,IAAI,GAAG,CAA2B;gBAExC,IAAI,CAAC,IAAI,CAAC,MAAM;oBAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM;AAElD,gBAAA,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC;AACrD,YAAA,CAAC,GAEJ;AAED,QAAA,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,uDAAC;AAEzD,QAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC;AAClC,QAAA,MAAM,EAAE,GAAG,MAAM,CAA0B,UAAU,CAAC;AAEtD,QAAA,iBAAiB,CAAC;YAChB,KAAK,EAAE,MAAK;AACV,gBAAA,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;YACtE,CAAC;AACF,SAAA,CAAC;IACJ;uGApDoB,SAAS,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,SAAA,EAAA,CAAA;2FAAT,SAAS,EAAA,YAAA,EAAA,IAAA,EAAA,MAAA,EAAA,EAAA,SAAA,EAAA,EAAA,iBAAA,EAAA,WAAA,EAAA,UAAA,EAAA,WAAA,EAAA,QAAA,EAAA,IAAA,EAAA,UAAA,EAAA,IAAA,EAAA,iBAAA,EAAA,IAAA,EAAA,EAAA,EAAA,QAAA,EAAA,EAAA,EAAA,CAAA;;2FAAT,SAAS,EAAA,UAAA,EAAA,CAAA;kBAD9B;;;MCRqB,UAAU,CAAA;AAIb,IAAA,KAAK,GAAG,MAAM,CAAC,gBAAgB,CAAC;AAChC,IAAA,CAAC,GAAG,OAAO,CAAO,IAAI,CAAC,KAAK,CAAC;AAE9C,IAAA,WAAA,GAAA;AACE,QAAA,MAAM,GAAG,GAAG,MAAM,CAAC,iBAAiB,CAAC;QAErC,MAAM,CAAC,MAAK;AACV,YAAA,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YACnB,GAAG,CAAC,YAAY,EAAE;AACpB,QAAA,CAAC,CAAC;IACJ;AAEA,IAAA,SAAS,CACP,GAAM,EACN,GAAG,IAE2B,EAAA;AAE9B,QAAA,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAC5B,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,QAAQ,CACY;QAE1C,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC;IACnC;AACD;;AClCD;;AAEG;;;;"}
+{"version":3,"file":"mmstack-translate.mjs","sources":["../../../../packages/translate/src/lib/delim.ts","../../../../packages/translate/src/lib/compile.ts","../../../../packages/translate/src/lib/create-namespace.ts","../../../../packages/translate/src/lib/path-param.ts","../../../../packages/translate/src/lib/translation-store.ts","../../../../packages/translate/src/lib/register-namespace.ts","../../../../packages/translate/src/lib/route-helpers.ts","../../../../packages/translate/src/lib/translate.ts","../../../../packages/translate/src/lib/translator.ts","../../../../packages/translate/src/mmstack-translate.ts"],"sourcesContent":["const KEY_DELIM = '::MMT_DELIM::';\n\nexport function prependDelim(prefix: string, key: string): string {\n  return `${prefix}${KEY_DELIM}${key}`;\n}\n\nexport function replaceWithDelim(str: string, repl = '.'): string {\n  return str.replaceAll(repl, KEY_DELIM);\n}\n","import { prependDelim } from './delim';\nimport type {\n  inferTranslationParamMap,\n  inferTranslationShape,\n} from './parameterize.type';\nimport type { UnknownStringKeyObject } from './string-key-object.type';\n\nconst INTERNAL_SYMBOL = Symbol.for('mmstack-translate-internal');\n\ntype InternalSymbol = typeof INTERNAL_SYMBOL;\n\nexport type CompiledTranslation<\n  T extends UnknownStringKeyObject,\n  TNS extends string,\n  TLocale extends string = string,\n> = {\n  flat: Record<string, string>;\n  locale?: TLocale;\n  namespace: TNS;\n  [INTERNAL_SYMBOL]: {\n    shape: inferTranslationShape<T>;\n    map: inferTranslationParamMap<TNS, T>;\n  };\n};\n\nexport type mergeTranslationMaps<\n  TMain extends CompiledTranslation<UnknownStringKeyObject, string>,\n  TOther extends CompiledTranslation<UnknownStringKeyObject, string>,\n> = Omit<TMain, InternalSymbol> & {\n  [INTERNAL_SYMBOL]: {\n    shape: inferCompiledTranslationShape<TMain>;\n    map: inferCompiledTranslationMap<TOther> &\n      inferCompiledTranslationMap<TMain>;\n  };\n};\n\nexport type inferCompiledTranslationNamespace<\n  T extends CompiledTranslation<UnknownStringKeyObject, string>,\n> = T['namespace'];\n\nexport type inferCompiledTranslationShape<\n  T extends CompiledTranslation<UnknownStringKeyObject, string>,\n> = T[InternalSymbol]['shape'];\n\nexport type inferCompiledTranslationMap<\n  T extends CompiledTranslation<UnknownStringKeyObject, string>,\n> = T[InternalSymbol]['map'];\n\nfunction isTranslationObject(t: unknown): t is UnknownStringKeyObject {\n  return typeof t === 'object' && t !== null;\n}\n\nfunction flattenTranslation<T extends UnknownStringKeyObject>(obj: T) {\n  return Object.entries(obj).reduce(\n    (acc, [key, value]) => {\n      if (typeof value === 'string') {\n        acc[key] = value;\n      } else if (isTranslationObject(value)) {\n        Object.entries(flattenTranslation(value)).forEach(\n          ([nestedKey, nestedValue]) => {\n            acc[prependDelim(key, nestedKey)] = nestedValue;\n          },\n        );\n      }\n\n      return acc;\n    },\n    {} as Record<string, string>,\n  );\n}\n\nexport function compileTranslation<\n  T extends UnknownStringKeyObject,\n  TNS extends string,\n  TLocale extends string = string,\n>(\n  translation: T,\n  ns: TNS,\n  locale?: TLocale,\n): CompiledTranslation<T, TNS, TLocale> {\n  type $Shape = inferTranslationShape<T>;\n  type $Map = inferTranslationParamMap<TNS, T>;\n\n  return {\n    locale,\n    flat: flattenTranslation(translation),\n    namespace: ns,\n    [INTERNAL_SYMBOL]: {\n      shape: {} as $Shape,\n      map: {} as $Map,\n    },\n  };\n}\n","import {\n  CompiledTranslation,\n  compileTranslation,\n  inferCompiledTranslationShape,\n  mergeTranslationMaps,\n} from './compile';\nimport { UnknownStringKeyObject } from './string-key-object.type';\n\ntype TranslationNamespace<\n  TNS extends string,\n  T extends CompiledTranslation<UnknownStringKeyObject, TNS>,\n  TShape extends UnknownStringKeyObject,\n> = {\n  translation: T;\n  createTranslation: <TLocale extends string>(\n    locale: TLocale,\n    translation: TShape,\n  ) => CompiledTranslation<TShape, TNS, TLocale>;\n  createMergedNamespace: <\n    TOtherNS extends string,\n    const TOther extends UnknownStringKeyObject,\n    TOtherCompiled extends CompiledTranslation<TOther, TOtherNS>,\n  >(\n    ns: TOtherNS,\n    translation: TOther,\n  ) => TranslationNamespace<\n    TOtherNS,\n    mergeTranslationMaps<TOtherCompiled, T>,\n    inferCompiledTranslationShape<TOtherCompiled>\n  >;\n};\n\nexport function createNamespace<\n  const T extends UnknownStringKeyObject,\n  TNS extends string,\n>(ns: TNS, translation: T) {\n  const compiled = compileTranslation<T, TNS>(translation, ns);\n\n  type TCompiled = typeof compiled;\n  type TShape = inferCompiledTranslationShape<typeof compiled>;\n\n  const namespace: TranslationNamespace<TNS, TCompiled, TShape> = {\n    translation: compileTranslation(translation, ns),\n    createTranslation: <TLocale extends string>(\n      locale: TLocale,\n      translation: TShape,\n    ) => {\n      return compileTranslation(translation, ns, locale);\n    },\n    createMergedNamespace: <\n      TOther extends UnknownStringKeyObject,\n      TOtherNS extends string,\n      TOtherCompiled extends CompiledTranslation<\n        TOther,\n        TOtherNS\n      > = CompiledTranslation<TOther, TOtherNS>,\n    >(\n      otherNs: TOtherNS,\n      otherTranslation: TOther,\n    ) => {\n      return createNamespace(otherNs, otherTranslation) as TranslationNamespace<\n        TOtherNS,\n        mergeTranslationMaps<TOtherCompiled, TCompiled>,\n        inferCompiledTranslationShape<TOtherCompiled>\n      > as unknown as any;\n    },\n  };\n\n  return namespace;\n}\n","import { computed, inject, type Signal } from '@angular/core';\nimport { toSignal } from '@angular/core/rxjs-interop';\nimport { ActivatedRoute, type ParamMap, Router } from '@angular/router';\n\nexport function pathParam(\n  key: string | (() => string),\n  route = inject(ActivatedRoute),\n): Signal<string | null> {\n  const keySignal =\n    typeof key === 'string' ? computed(() => key) : computed(key);\n\n  const routerOptions = inject(Router)['options'];\n\n  if (\n    routerOptions &&\n    typeof routerOptions === 'object' &&\n    routerOptions.paramsInheritanceStrategy === 'always'\n  ) {\n    const params = toSignal(route.paramMap, {\n      initialValue: route.snapshot.paramMap,\n    });\n\n    return computed(() => params().get(keySignal()));\n  }\n\n  const paramMapSignals: Signal<ParamMap>[] = [];\n  let currentRoute: ActivatedRoute | null = route;\n\n  const isStatic = typeof key === 'string';\n\n  while (currentRoute) {\n    const initial = currentRoute.snapshot.paramMap;\n    paramMapSignals.push(\n      toSignal(currentRoute.paramMap, {\n        initialValue: initial,\n      }),\n    );\n\n    // For static keys, stop once we find the param, will find first in computed for loop already so basically noop for for loop\n    if (isStatic && initial.has(key as string)) break;\n\n    currentRoute = currentRoute.parent;\n  }\n\n  return computed(() => {\n    const paramKey = keySignal();\n\n    for (const map of paramMapSignals) {\n      const v = map().get(paramKey);\n      if (v) return v;\n    }\n\n    return null;\n  });\n}\n","import {\n  computed,\n  effect,\n  inject,\n  Injectable,\n  InjectionToken,\n  isDevMode,\n  LOCALE_ID,\n  type Provider,\n  resource,\n  type Signal,\n  signal,\n  untracked,\n  type WritableSignal,\n} from '@angular/core';\nimport { createIntl, createIntlCache, type IntlConfig } from '@formatjs/intl';\nimport { type CompiledTranslation } from './compile';\nimport { prependDelim } from './delim';\nimport { pathParam } from './path-param';\nimport { type UnknownStringKeyObject } from './string-key-object.type';\n\nconst CONFIG_TOKEN = new InjectionToken<\n  Omit<IntlConfig, 'locale' | 'messages'> & {\n    supportedLocales?: string[];\n    preloadDefaultLocale?: boolean;\n    localeParamName?: string;\n  }\n>('mmstack-intl-config');\n\nexport function provideIntlConfig(\n  config: Omit<IntlConfig, 'locale' | 'messages'> & {\n    /** Checks next locale is in provided array before switching locales */\n    supportedLocales?: string[];\n    /** Preloads the default locale ensuring sync fallback, not necessary for most cases as it will lazily load automatically when needed */\n    preloadDefaultLocale?: boolean;\n    /** Auto-resolution when using a locale parameter via angular router */\n    localeParamName?: string;\n  },\n): Provider[] {\n  const providers: Provider[] = [\n    {\n      useFactory: (localeId: string) => {\n        const next = {\n          ...config,\n        };\n\n        const defaultLocale =\n          config.defaultLocale ?? config.supportedLocales?.at(0) ?? localeId;\n\n        if (\n          next.supportedLocales &&\n          !next.supportedLocales.includes(defaultLocale)\n        ) {\n          next.supportedLocales = [...next.supportedLocales, defaultLocale];\n        }\n\n        return next;\n      },\n      deps: [LOCALE_ID],\n      provide: CONFIG_TOKEN,\n    },\n  ];\n\n  const defaultLocale = config.defaultLocale ?? config.supportedLocales?.at(0);\n\n  if (!defaultLocale) return providers;\n\n  providers.push({\n    provide: LOCALE_ID,\n    useValue: defaultLocale,\n  });\n\n  return providers;\n}\n\nexport function injectIntlConfig() {\n  return inject(CONFIG_TOKEN, { optional: true }) ?? undefined;\n}\n\nexport function injectDefaultLocale() {\n  return injectIntlConfig()?.defaultLocale ?? inject(LOCALE_ID) ?? 'en-US';\n}\n\nexport function injectSupportedLocales() {\n  return injectIntlConfig()?.supportedLocales ?? [injectDefaultLocale()];\n}\n\n@Injectable({\n  providedIn: 'root',\n})\nexport class TranslationStore {\n  private readonly cache = createIntlCache();\n  private readonly config = injectIntlConfig();\n  readonly loadQueue = signal<string[]>([]);\n  readonly locale = signal(injectDefaultLocale());\n  private readonly defaultLocale = injectDefaultLocale();\n  private readonly translations = signal<\n    Record<string, Record<string, string>>\n  >({\n    [this.defaultLocale]: {},\n  });\n  private attemptedFallbackLoad = false;\n\n  private readonly onDemandLoaders = new Map<\n    string,\n    Record<\n      string,\n      () => Promise<CompiledTranslation<UnknownStringKeyObject, string>>\n    >\n  >();\n\n  private readonly nonMessageConfig = computed(() => ({\n    ...this.config,\n    locale: this.locale(),\n  }));\n\n  private readonly messages = computed(\n    () =>\n      this.translations()[this.locale()] ??\n      this.translations()[this.defaultLocale] ??\n      {},\n  );\n\n  readonly dynamicLocaleLoader = resource({\n    params: computed(() => this.loadQueue().at(0) ?? null),\n    loader: async ({ params: newLocale, abortSignal }) => {\n      if (!newLocale) return;\n\n      const currentTranslations = untracked(this.translations);\n\n      const loadPromises: Promise<{\n        namespace: string;\n        flat: Record<string, string>;\n      } | null>[] = [];\n\n      for (const [namespace, loaders] of this.onDemandLoaders.entries()) {\n        const loader = loaders[newLocale];\n        if (loader) {\n          const hasNamespaceForLocale =\n            currentTranslations[newLocale] &&\n            Object.keys(currentTranslations[newLocale]).some((key) =>\n              key.startsWith(`${prependDelim(namespace, '').slice(0, -1)}`),\n            );\n\n          if (!hasNamespaceForLocale) {\n            loadPromises.push(\n              loader()\n                .then((translation) => {\n                  if (abortSignal.aborted) return null;\n                  return {\n                    namespace: translation.namespace,\n                    flat: translation.flat,\n                  };\n                })\n                .catch((err) => {\n                  if (isDevMode()) {\n                    console.error(\n                      '[Translate] Failed to load',\n                      namespace,\n                      newLocale,\n                      err,\n                    );\n                  }\n\n                  return null;\n                }),\n            );\n          }\n        }\n      }\n\n      return Promise.all(loadPromises)\n        .then((res) => res.filter((r) => r !== null))\n        .then((res) => ({\n          locales: res,\n          locale: newLocale,\n        }));\n    },\n  });\n\n  readonly intl = computed(() =>\n    createIntl(\n      {\n        ...this.nonMessageConfig(),\n        messages: this.messages(),\n      },\n      this.cache,\n    ),\n  );\n\n  constructor() {\n    const paramName = this.config?.localeParamName;\n    if (paramName) {\n      const param = pathParam(paramName);\n\n      effect(() => {\n        const loc = param();\n        if (\n          !loc ||\n          loc === untracked(this.locale) ||\n          untracked(this.loadQueue).includes(loc)\n        )\n          return;\n        if (this.hasLocaleLoaders(loc)) this.locale.set(loc);\n        else this.loadQueue.update((q) => [...q, loc]);\n      });\n    }\n\n    effect(() => {\n      if (\n        // should never be in error state, but best to check in case something throws\n        this.dynamicLocaleLoader.error() ||\n        this.dynamicLocaleLoader.isLoading()\n      )\n        return;\n      const dynamicLocales = this.dynamicLocaleLoader.value();\n\n      if (!dynamicLocales) return;\n\n      // Register loaded translations\n      for (const locale of dynamicLocales.locales) {\n        this.register(locale.namespace, {\n          [dynamicLocales.locale]: locale.flat,\n        });\n      }\n\n      const hasTranslations =\n        dynamicLocales.locales.length > 0 ||\n        this.translations()[dynamicLocales.locale];\n\n      if (hasTranslations) {\n        this.loadQueue.update((q) =>\n          q.filter((l) => l !== dynamicLocales.locale),\n        );\n        this.locale.set(dynamicLocales.locale);\n      }\n    });\n  }\n\n  formatMessage(key: string, values?: Record<string, string | number>) {\n    const message =\n      this.translations()[this.locale()]?.[key] ??\n      this.translations()[this.defaultLocale]?.[key] ??\n      '';\n\n    if (!message) {\n      if (this.attemptedFallbackLoad) return '';\n\n      this.attemptedFallbackLoad = true;\n      untracked(() => {\n        if (!this.loadQueue().includes(this.defaultLocale))\n          this.loadQueue.update((q) => [...q, this.defaultLocale]);\n      });\n      return '';\n    }\n\n    return this.intl().formatMessage(\n      { id: key, defaultMessage: message },\n      values,\n    );\n  }\n\n  register(\n    namespace: string,\n    flat: Partial<Record<string, Record<string, string>>>,\n  ) {\n    this.translations.update((cur) => {\n      return Object.entries(flat).reduce(\n        (acc, [locale, translation]) => {\n          const localeTranslation = acc[locale] ?? {};\n\n          const withNS = Object.entries(translation ?? {}).reduce(\n            (acc, [key, value]) => {\n              acc[prependDelim(namespace, key)] = value;\n              return acc;\n            },\n            {} as Record<string, string>,\n          );\n\n          acc[locale] = {\n            ...localeTranslation,\n            ...withNS,\n          };\n\n          return acc;\n        },\n        { ...cur },\n      );\n    });\n  }\n\n  registerOnDemandLoaders(\n    namespace: string,\n    loaders: Record<string, () => Promise<any>>,\n  ) {\n    this.onDemandLoaders.set(namespace, loaders);\n  }\n\n  hasLocaleLoaders(locale: string): boolean {\n    return Array.from(this.onDemandLoaders.values()).some(\n      (loaders) => loaders[locale],\n    );\n  }\n}\n\nexport function injectIntl() {\n  return inject(TranslationStore).intl;\n}\n\n/**\n * Inject a dynamic locale signal that supports runtime language switching.\n *\n * @returns A writable signal with the current locale and loading state.\n * Only allows switching to locales that have registered loaders.\n *\n * @example\n * ```typescript\n * const locale = injectDynamicLocale();\n *\n * // Switch language (triggers automatic translation loading)\n * locale.set('sl-SI');\n *\n * // Check loading state\n * if (locale.isLoading()) {\n *   // Show spinner\n * }\n * ```\n */\nexport function injectDynamicLocale(): WritableSignal<string> & {\n  isLoading: Signal<boolean>;\n} {\n  const store = inject(TranslationStore);\n  const supportedLocales = injectIntlConfig()?.supportedLocales;\n\n  const source = computed(() => store.locale()) as WritableSignal<string> & {\n    isLoading: Signal<boolean>;\n  };\n\n  const inSupportedLocales =\n    supportedLocales === undefined\n      ? () => true\n      : (locale: string) => supportedLocales.includes(locale);\n\n  const set = (value: string) => {\n    if (\n      value === untracked(source) ||\n      untracked(store.loadQueue).includes(value)\n    )\n      return;\n\n    if (!inSupportedLocales(value)) {\n      if (isDevMode())\n        console.warn(\n          `[Translate] Locale \"${value}\" is not in supportedLocales, switch prevented. Available options are:`,\n          supportedLocales,\n        );\n\n      return;\n    }\n\n    if (isDevMode() && !store.hasLocaleLoaders(value))\n      console.warn(\n        `[Translate] No loaders registered for locale \"${value}\". Switching to this locale will have no effect.`,\n      );\n\n    store.loadQueue.update((q) => [...q, value]);\n  };\n\n  source.set = set;\n  source.update = (updater: (value: string) => string) => {\n    const next = updater(untracked(source));\n    source.set(next);\n  };\n  source.asReadonly = () => source;\n\n  source.isLoading = store.dynamicLocaleLoader.isLoading;\n\n  return source;\n}\n","import {\n  computed,\n  inject,\n  isDevMode,\n  isSignal,\n  type Signal,\n  untracked,\n} from '@angular/core';\nimport {\n  type ActivatedRouteSnapshot,\n  ResolveFn,\n  Router,\n} from '@angular/router';\nimport {\n  type CompiledTranslation,\n  type inferCompiledTranslationMap,\n  type inferCompiledTranslationNamespace,\n} from './compile';\nimport { replaceWithDelim } from './delim';\nimport { type UnknownStringKeyObject } from './string-key-object.type';\nimport {\n  injectDefaultLocale,\n  injectIntlConfig,\n  TranslationStore,\n} from './translation-store';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyStringRecord = Record<string, any>;\n\nfunction createEqualsRecord<T extends AnyStringRecord>(keys: (keyof T)[] = []) {\n  let keyMatcher: (a: T, b: T) => boolean;\n\n  if (keys.length === 0) {\n    keyMatcher = () => true;\n  } else if (keys.length === 1) {\n    const key = keys[0];\n    keyMatcher = (a, b) => a[key] === b[key];\n  } else {\n    keyMatcher = (a, b) => {\n      return keys.every((k) => a[k] === b[k]);\n    };\n  }\n\n  return (a?: T, b?: T): boolean => {\n    if (!a && !b) return true;\n    if (!a || !b) return false;\n    return keyMatcher(a, b);\n  };\n}\n\ntype TFunction<TMap extends AnyStringRecord> = <\n  TKey extends keyof TMap & string,\n>(\n  key: TKey,\n  ...args: TMap[TKey] extends void ? [] : [TMap[TKey]]\n) => string;\n\ntype SignalTFunction<TMap extends AnyStringRecord> = <\n  TKey extends keyof TMap & string,\n>(\n  key: TKey,\n  ...args: TMap[TKey] extends void ? [] : [() => TMap[TKey]]\n) => Signal<string>;\n\ntype TFunctionWithSignalConstructor<\n  TMap extends AnyStringRecord,\n  TFN extends TFunction<TMap>,\n> = TFN & {\n  asSignal: SignalTFunction<TMap>;\n};\n\nfunction addSignalFn<TMap extends AnyStringRecord, TFn extends TFunction<TMap>>(\n  fn: TFn,\n  store: TranslationStore,\n): TFunctionWithSignalConstructor<TMap, TFn> {\n  const withSig = fn as TFunctionWithSignalConstructor<TMap, TFn>;\n\n  const asSignal = <TKey extends keyof TMap & string>(\n    key: TKey,\n    ...args: TMap[TKey] extends void ? [] : [() => TMap[TKey]]\n  ): Signal<string> => {\n    const variables = args[0] as () => AnyStringRecord | undefined;\n    const stringKey = key as string;\n\n    const flatPath = replaceWithDelim(stringKey);\n\n    const varsFn = variables ?? (() => undefined);\n    const varsSignal = isSignal(varsFn)\n      ? varsFn\n      : computed(varsFn, {\n          equal: createEqualsRecord(Object.keys(varsFn() ?? {})),\n        });\n\n    return computed(() => store.formatMessage(flatPath, varsSignal()));\n  };\n\n  withSig.asSignal = asSignal;\n\n  return withSig;\n}\n\nexport function createT<TMap extends AnyStringRecord>(\n  store: TranslationStore,\n): TFunction<TMap> {\n  return <TKey extends keyof TMap & string>(\n    key: TKey,\n    ...args: TMap[TKey] extends void ? [] : [TMap[TKey]]\n  ): string => {\n    const variables = args[0] as AnyStringRecord | undefined;\n    const stringKey = key as string;\n\n    return store.formatMessage(replaceWithDelim(stringKey), variables);\n  };\n}\n\nexport function registerNamespace<\n  TDefault extends CompiledTranslation<UnknownStringKeyObject, string>,\n>(\n  defaultTranslation: () => Promise<TDefault>,\n  other: Record<\n    string,\n    () => Promise<\n      CompiledTranslation<\n        UnknownStringKeyObject,\n        inferCompiledTranslationNamespace<TDefault>,\n        string\n      >\n    >\n  >,\n) {\n  type $Map = inferCompiledTranslationMap<TDefault>;\n  type $BaseTFN = TFunction<$Map>;\n  type $TFN = TFunctionWithSignalConstructor<$Map, $BaseTFN>;\n\n  const injectT = (): $TFN => {\n    const store = inject(TranslationStore);\n\n    return addSignalFn(createT(store), store);\n  };\n\n  let defaultTranslationLoaded = false;\n  const resolver: ResolveFn<void> = async (snapshot) => {\n    const store = inject(TranslationStore);\n\n    let locale: string | null = null;\n\n    const paramName = injectIntlConfig()?.localeParamName;\n\n    const routerConfig = inject(Router)['options'];\n    const alwaysInheritParams =\n      typeof routerConfig === 'object' &&\n      !!routerConfig &&\n      routerConfig.paramsInheritanceStrategy === 'always';\n\n    if (paramName) {\n      locale = snapshot.paramMap.get(paramName);\n\n      if (!locale && !alwaysInheritParams) {\n        let currentRoute: ActivatedRouteSnapshot | null = snapshot;\n        while (currentRoute && !locale) {\n          locale = currentRoute.paramMap.get('locale');\n          currentRoute = currentRoute.parent;\n        }\n      }\n    }\n\n    if (!locale) {\n      locale = untracked(store.locale);\n    }\n\n    const defaultLocale = injectDefaultLocale();\n    const shouldPreloadDefault =\n      injectIntlConfig()?.preloadDefaultLocale ?? false;\n\n    const tPromise = other[locale] as (typeof other)[string] | undefined;\n\n    const promise = tPromise ?? defaultTranslation;\n    if (!promise && isDevMode()) {\n      return console.warn(`No translation found for locale: ${locale}`);\n    }\n\n    if (promise === defaultTranslation && defaultTranslationLoaded) return;\n\n    try {\n      const promises = [promise()];\n\n      if (\n        shouldPreloadDefault &&\n        !defaultTranslationLoaded &&\n        promise !== defaultTranslation\n      )\n        promises.push(defaultTranslation());\n\n      const translations = await Promise.allSettled(promises);\n\n      const fullfilled = translations.map((t) =>\n        t.status === 'fulfilled' ? t.value : null,\n      );\n\n      if (fullfilled.at(0) === null && fullfilled.at(1) === null)\n        throw new Error('Failed to load translations');\n\n      const [t, defaultT] = fullfilled;\n\n      const ns = t?.namespace ?? defaultT?.namespace;\n      if (!ns) throw new Error('No namespace found in translation');\n\n      if (isDevMode() && t && t.locale !== locale && t.locale !== defaultLocale)\n        console.warn(`Expected locale to be ${locale} but got ${t.locale}`);\n\n      store.registerOnDemandLoaders(ns, {\n        ...other,\n        [defaultLocale]: defaultTranslation,\n      });\n\n      const toRegister: Record<string, Record<string, string>> = {};\n      if (t) toRegister[locale] = t.flat;\n      if (defaultT) toRegister[defaultLocale] = defaultT.flat;\n\n      store.register(ns, toRegister);\n\n      if (promise === defaultTranslation || defaultT)\n        defaultTranslationLoaded = true;\n    } catch {\n      if (isDevMode()) {\n        console.warn(`Failed to load translation for locale: ${locale}`);\n      }\n    } finally {\n      if (locale !== untracked(store.locale)) store.locale.set(locale);\n    }\n  };\n\n  return {\n    injectNamespaceT: injectT,\n    resolveNamespaceTranslation: resolver,\n  };\n}\n","import { inject } from '@angular/core';\nimport {\n  Router,\n  type CanMatchFn,\n  type Route,\n  type UrlSegment,\n} from '@angular/router';\nimport {\n  injectDefaultLocale,\n  injectSupportedLocales,\n} from './translation-store';\n\n/**\n * Guard that validates the locale parameter against supported locales.\n * Redirects to default locale if the locale is invalid.\n *\n * @param prefixSegments Optional array of path segments preceding the locale segment.\n * if (you wanted to match /app/:locale/... you would pass ['app'] here) & the function would match the second parameter + redirect accordingly\n *\n * @example\n * ```typescript\n * {\n *   path: ':locale',\n *   canMatch: [canMatchLocale()],\n *   children: [...]\n * }\n * ```\n */\nexport function canMatchLocale(prefixSegments: string[] = []): CanMatchFn {\n  return (_route: Route, segments: UrlSegment[]) => {\n    const supportedLocales = injectSupportedLocales();\n\n    const locale = segments.at(prefixSegments.length)?.path;\n\n    if (!locale || !supportedLocales.includes(locale))\n      return inject(Router).createUrlTree([\n        ...prefixSegments,\n        injectDefaultLocale(),\n      ]);\n\n    return true;\n  };\n}\n","import {\n  afterRenderEffect,\n  computed,\n  Directive,\n  ElementRef,\n  inject,\n  input,\n  Renderer2,\n} from '@angular/core';\nimport {\n  type CompiledTranslation,\n  type inferCompiledTranslationMap,\n} from './compile';\nimport { createT } from './register-namespace';\nimport { type UnknownStringKeyObject } from './string-key-object.type';\nimport { TranslationStore } from './translation-store';\n\n@Directive()\nexport abstract class Translate<\n  TInput extends string,\n  T extends CompiledTranslation<UnknownStringKeyObject, string>,\n  TMap extends inferCompiledTranslationMap<T> = inferCompiledTranslationMap<T>,\n  TKey extends TInput & keyof TMap & string = TInput & keyof TMap & string,\n> {\n  private readonly t = createT(inject(TranslationStore));\n\n  readonly translate =\n    input.required<\n      TMap[TKey] extends void\n        ? TKey | [key: TKey]\n        : [key: TKey, vars: TMap[TKey]]\n    >();\n\n  constructor() {\n    const key = computed(() => {\n      const vars = this.translate();\n      return (Array.isArray(vars) ? vars[0] : vars) as TKey;\n    });\n\n    const args = computed(\n      () => {\n        const vars = this.translate();\n        return (Array.isArray(vars) ? vars[1] : undefined) as TMap[TKey];\n      },\n      {\n        equal: (a, b) => {\n          if (a === undefined && b === undefined) return true;\n          if (a === undefined || b === undefined) return false;\n\n          const aObj = a as Record<string, string>;\n          const keys = Object.keys(aObj);\n          const bObj = b as Record<string, string>;\n\n          if (!keys.length) return !Object.keys(bObj).length;\n\n          return keys.every((key) => aObj[key] === bObj[key]);\n        },\n      },\n    );\n\n    const translation = computed(() => this.t(key(), args()));\n\n    const renderer = inject(Renderer2);\n    const el = inject<ElementRef<HTMLElement>>(ElementRef);\n\n    afterRenderEffect({\n      write: () => {\n        renderer.setProperty(el.nativeElement, 'textContent', translation());\n      },\n    });\n  }\n}\n","import { ChangeDetectorRef, effect, inject } from '@angular/core';\nimport { CompiledTranslation, inferCompiledTranslationMap } from './compile';\nimport { createT } from './register-namespace';\nimport { UnknownStringKeyObject } from './string-key-object.type';\nimport { TranslationStore } from './translation-store';\n\nexport abstract class Translator<\n  T extends CompiledTranslation<UnknownStringKeyObject, string>,\n  TMap extends inferCompiledTranslationMap<T> = inferCompiledTranslationMap<T>,\n> {\n  private readonly store = inject(TranslationStore);\n  private readonly t = createT<TMap>(this.store);\n\n  constructor() {\n    const cdr = inject(ChangeDetectorRef);\n\n    effect(() => {\n      this.store.locale();\n      cdr.markForCheck();\n    });\n  }\n\n  transform<K extends keyof TMap & string>(\n    key: K,\n    ...args: TMap[K] extends void\n      ? [locale?: string]\n      : [TMap[K], locale?: string]\n  ): string {\n    const actualArgs = args.filter(\n      (a) => typeof a === 'object',\n    ) as TMap[K] extends void ? [] : [TMap[K]];\n\n    return this.t(key, ...actualArgs);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmstack/translate",
-  "version": "21.0.2",
+  "version": "21.1.0",
   "keywords": [
     "angular",
     "localize",

package/types/mmstack-translate.d.ts

@@ -1,5 +1,6 @@
 import * as i0 from '@angular/core';
 import { WritableSignal, Signal, Provider } from '@angular/core';
+import { ResolveFn, CanMatchFn } from '@angular/router';
 import * as _formatjs_intl from '@formatjs/intl';
 import { IntlConfig } from '@formatjs/intl';
 
@@ -64,7 +65,15 @@ type TranslationNamespace<TNS extends string, T extends CompiledTranslation<Unkn
 };
 declare function createNamespace<const T extends UnknownStringKeyObject, TNS extends string>(ns: TNS, translation: T): TranslationNamespace<TNS, CompiledTranslation<T, TNS, string>, inferTranslationShape<T>>;
 
-declare function provideIntlConfig(config: Omit<IntlConfig, 'locale' | 'messages'>): Provider;
+declare function provideIntlConfig(config: Omit<IntlConfig, 'locale' | 'messages'> & {
+    /** Checks next locale is in provided array before switching locales */
+    supportedLocales?: string[];
+    /** Preloads the default locale ensuring sync fallback, not necessary for most cases as it will lazily load automatically when needed */
+    preloadDefaultLocale?: boolean;
+    /** Auto-resolution when using a locale parameter via angular router */
+    localeParamName?: string;
+}): Provider[];
+declare function injectSupportedLocales(): string[];
 declare function injectIntl(): Signal<_formatjs_intl.IntlShape<string>>;
 /**
  * Inject a dynamic locale signal that supports runtime language switching.
@@ -97,9 +106,27 @@ type TFunctionWithSignalConstructor<TMap extends AnyStringRecord, TFN extends TF
 };
 declare function registerNamespace<TDefault extends CompiledTranslation<UnknownStringKeyObject, string>>(defaultTranslation: () => Promise<TDefault>, other: Record<string, () => Promise<CompiledTranslation<UnknownStringKeyObject, inferCompiledTranslationNamespace<TDefault>, string>>>): {
     injectNamespaceT: () => TFunctionWithSignalConstructor<inferCompiledTranslationMap<TDefault>, TFunction<inferCompiledTranslationMap<TDefault>>>;
-    resolveNamespaceTranslation: () => Promise<void>;
+    resolveNamespaceTranslation: ResolveFn<void>;
 };
 
+/**
+ * Guard that validates the locale parameter against supported locales.
+ * Redirects to default locale if the locale is invalid.
+ *
+ * @param prefixSegments Optional array of path segments preceding the locale segment.
+ * if (you wanted to match /app/:locale/... you would pass ['app'] here) & the function would match the second parameter + redirect accordingly
+ *
+ * @example
+ * ```typescript
+ * {
+ *   path: ':locale',
+ *   canMatch: [canMatchLocale()],
+ *   children: [...]
+ * }
+ * ```
+ */
+declare function canMatchLocale(prefixSegments?: string[]): CanMatchFn;
+
 declare abstract class Translate<TInput extends string, T extends CompiledTranslation<UnknownStringKeyObject, string>, TMap extends inferCompiledTranslationMap<T> = inferCompiledTranslationMap<T>, TKey extends TInput & keyof TMap & string = TInput & keyof TMap & string> {
     private readonly t;
     readonly translate: i0.InputSignal<TMap[TKey] extends void ? TKey | [key: TKey] : [key: TKey, vars: TMap[TKey]]>;
@@ -115,5 +142,5 @@ declare abstract class Translator<T extends CompiledTranslation<UnknownStringKey
     transform<K extends keyof TMap & string>(key: K, ...args: TMap[K] extends void ? [locale?: string] : [TMap[K], locale?: string]): string;
 }
 
-export { Translate, Translator, compileTranslation, createNamespace, injectDynamicLocale, injectIntl, provideIntlConfig, registerNamespace };
+export { Translate, Translator, canMatchLocale, compileTranslation, createNamespace, injectDynamicLocale, injectIntl, injectSupportedLocales, provideIntlConfig, registerNamespace };
 export type { CompiledTranslation, inferCompiledTranslationMap, inferCompiledTranslationNamespace, inferCompiledTranslationShape, mergeTranslationMaps };