@mmstack/translate 0.0.1 → 19.1.0

package/README.md

@@ -1,3 +1,284 @@
 # @mmstack/translate
 
-Still in progress, published for testing purposes
+**Type-Safe & modular localization for Modern Angular.**
+
+[![npm version](https://badge.fury.io/js/%40mmstack%2Ftranslate.svg)](https://badge.fury.io/js/%40mmstack%2Ftranslate)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/mihajm/mmstack/blob/master/LICENSE)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](CONTRIBUTING.md)
+
+`@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.
+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.
+
+## Features
+
+- ✅ **End-to-End Type Safety:** Compile-time checks for:
+  - Translation key existence (within a namespace).
+  - 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.
+- 📦 **Namespacing:** Organize translations by feature/library (e.g., 'quotes', 'userProfile', 'common').
+- ⏳ **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.)
+- 🔗 **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 `BaseTranslatePipe` and `BaseTranslateDirective` 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.
+
+| 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           |
+| **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**     |      🔄 Page Refresh Required       | 🔄 Page Refresh Required |     ✅ Dynamic (Runtime)      |    ✅ Dynamic (Runtime)    |
+| **Lazy Loading**         | ✅ Built-in (Namespaces/Resolvers)  |    N/A (Compile Time)    |     ✅ Built-in (Scopes)      |  ✅ Yes (Custom Loaders)   |
+| **Namespacing/Scopes**   |             ✅ Built-in             |         ❌ None          |     ✅ Built-in (Scopes)      | 🟡 Manual (File Structure) |
+| **ICU Support**          |  ✅ Subset (via FormatJS Runtime)   |  ✅ Yes (Compile Time)   | ✅ Yes (Runtime Intl/Plugins) |     🟡 Via Extensions      |
+| **Signal Integration**   |      ✅ Good (`t.asSignal()`)       |           N/A            | ✅ Good (`translateSignal()`) |      ❌ Minimal/None       |
+| **Maturity / Community** |               ✨ New                |       Core Angular       |      ✅ Mature / Active       |         ✅ Mature          |
+
+## Installation & Configuration
+
+Install the library & its peer dependency, `@formatjs/intl`.
+
+```bash
+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.
+
+```typescript
+import { provideIntlConfig } from '@mmstack/translate';
+
+const appConfig: Providers = [
+  provideIntlConfig({
+    defaultLocale: 'fr-FR', // defaults to 'en-US' if nothing is provided
+  }),
+];
+```
+
+```typescript
+import { Component, LOCALE_ID } from '@angular/core';
+import { ActivatedRoute } from '@angular/router';
+
+const KNOWN_LOCALES = ['en-US', 'sl-SI'];
+
+@Component({
+  selector: 'app-locale-shell',
+  providers: [
+    {
+      provide: LOCALE_ID,
+      useFactory: (route: ActivatedRoute) => {
+        const locale = route.snapshot.paramMap.get('locale') || 'en-US';
+        if (KNOWN_LOCALES.includes(locale)) return locale;
+        return 'en-US';
+      },
+      deps: [ActivatedRoute],
+    },
+  ],
+  template: `<ng-content />`,
+})
+export class LocaleShellComponent {}
+```
+
+_Note:_ `@mmstack/translate` relies on Angular's `LOCALE_ID` provider. You must 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. The library assumes this `LOCALE_ID` is static for the duration of the application session and requires a page refresh to change.
+
+## Usage
+
+The core workflow involves defining namespaces, registering them (often via lazy loading), and then using the injected translation function (t), pipe, or directive.
+
+### 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.
+
+```typescript
+// Example: packages/quote/src/lib/quote.namespace.ts
+import { createNamespace } from '@mmstack/translate';
+
+// Create the namespace definition object
+const ns = createNamespace('quote', {
+  pageTitle: 'Famous Quotes',
+  greeting: 'Hello {name}!',
+  detail: {
+    authorLabel: 'Author',
+  },
+  errors: {
+    minLength: 'Quote must be at least {min} characters long.',
+  },
+  stats: '{count, plural, one {# quote} other {# quotes}} available',
+} as const); // Note the as const, without it variable inference won't work correctly
+
+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
+
+import { createQuoteTranslation } from './quote.namespace';
+
+// shape is typesafe (errors if you have missing or additional keys)
+export default createQuoteTranslation({
+  pageTitle: 'Znani Citati',
+  greeting: 'Zdravo {name}!',
+  detail: {
+    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)
+  },
+  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
+});
+```
+
+### 2. Register the namespace & load
+
+Use registerNamespace to prepare your namespace definition and obtain the injectNamespaceT function and the resolveNamespaceTranslation resolver function. Use the resolver in your Angular routes.
+
+```typescript
+import q from './quote.namespace';
+
+// Register the namespace
+// Example: packages/quote/src/lib/quote.t.ts
+const r = registerNamespace(
+  q, // Default locale's compiled translation (functions as fallback if no locale of type provided)
+  {
+    // Map other locales to promise factories (dynamic imports)
+    'sl-SI': () => import('./quote-sl.translation.ts').then((m) => m.default),
+  },
+);
+
+export const injectQuoteT = r.injectNamespaceT;
+export const resolveQuoteTranslations = r.resolveNamespaceTranslation;
+
+// in the main quote route add the provided resolver
+
+import { type Routes } from '@angular/router';
+import { resolveQuoteTranslations } from './quote.t';
+
+export const MODULE_ROUTES: Routes = [
+  // ...
+  {
+    // ...
+    resolve: {
+      resolveQuoteTranslations,
+    },
+  },
+];
+```
+
+#### 2b. [OPTIONAL] Configure the translation pipe and/or directive
+
+```typescript
+import { Pipe, Directive } from '@angular/core';
+import { BaseTranslatePipe, BaseTranslateDirective } from '@mmstack/translate';
+import { type QuoteLocale } from './quote.namespace';
+
+@Pipe({
+  name: 'translate',
+})
+export class QuoteTranslatePipe extends BaseTranslatePipe<QuoteLocale> {}
+
+@Directive({
+  selector: '[translate]', // input in BaseTranslateDirective is named 'translate'
+})
+// TInput is necessary to correctly infer the variables to the key
+export class QuoteTranslateDirective<TInput extends string> extends BaseTranslateDirective<TInput, QuoteLocale> {}
+```
+
+### 3. Have fun :)
+
+```typescript
+@Component({
+  selector: 'app-quote',
+  imports: [QuoteTranslatePipe, QuoteTranslateDirective],
+  template: `
+    <!-- Pipe validates key & variables match -->
+    <h1>{{ 'quote.pageTitle' | translate }}</h1>
+    <!-- Non pluralized params must be string -->
+    <span>{{ 'quote.errors.minLength' | translate: { min: '5' } }}</span>
+
+    <!-- Directive replaces innerHTML of el -->
+    <h1 translate="quote.pageTitle"></h1>
+    <span [translate]="['quote.errors.minLength', { min: '5' }]"></span>
+  `,
+})
+export class QuoteComponent {
+  protected readonly count = signal(0);
+  private readonly t = injectQuoteT();
+
+  private readonly author = this.t('quote.detail.authorLabel'); // static translation
+
+  private readonly stats = this.t.asSignal('quote.stats', () => ({
+    count: this.count(), // must be object with count parameter & type number
+  }));
+}
+```
+
+### 4. [OPTIONAL] - Creating a shared/common namespace
+
+_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.
+
+#### 4a. Define a shared namespace
+
+Same as quote example, but this time also export the `createMergedNamespace` function. This will be your new factory for other namespaces.
+
+```typescript
+// Example: packages/common-locales/src/lib/common.namespace.ts
+import { createNamespace } from '@mmstack/translate';
+
+const ns = createNamespace('common', {
+  yes: 'Yes',
+  no: 'No',
+} as const);
+
+// ... rest
+
+export const createAppNamespace = ns.createMergedNamespace;
+```
+
+### 4b. Use the common namespace factory instead of the library one
+
+```typescript
+// Example: packages/quote/src/lib/quote.namespace.ts
+import { createAppNamespace } from '@org/common/locale'; // replace with your library import path
+
+// Create the namespace definition object
+const ns = createAppNamespace('quote', {
+  pageTitle: 'Famous Quotes',
+} as const);
+
+// registration & other stuff remains the same
+```
+
+### 4c. Have even more fun!
+
+```typescript
+@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');
+
+  // quote translations also work the same
+  private readonly author = this.t('quote.detail.authorLabel');
+}
+```
+
+## Contributing
+
+Contributions, issues, and feature requests are welcome!

package/fesm2022/mmstack-translate.mjs

@@ -1,10 +1,257 @@
-function test(locale) {
-    return locale;
+import * as i0 from '@angular/core';
+import { InjectionToken, inject, LOCALE_ID, signal, computed, Injectable, isSignal, isDevMode, input, Renderer2, ElementRef, effect, Directive } from '@angular/core';
+import { createIntlCache, createIntl } from '@formatjs/intl';
+
+const KEY_DELIM = '::MMT_DELIM::';
+function prependDelim(prefix, key) {
+    return `${prefix}${KEY_DELIM}${key}`;
+}
+function replaceWithDelim(str, repl = '.') {
+    return str.replaceAll(KEY_DELIM, repl);
+}
+
+const INTERNAL_SYMBOL = Symbol.for('mmstack-translate-internal');
+function isTranslationObject(t) {
+    return typeof t === 'object' && t !== null;
+}
+function flattenTranslation(obj) {
+    return Object.entries(obj).reduce((acc, [key, value]) => {
+        if (typeof value === 'string') {
+            acc[key] = value;
+        }
+        else if (isTranslationObject(value)) {
+            Object.entries(flattenTranslation(value)).forEach(([nestedKey, nestedValue]) => {
+                acc[prependDelim(key, nestedKey)] = nestedValue;
+            });
+        }
+        return acc;
+    }, {});
+}
+function compileTranslation(translation, ns, locale) {
+    return {
+        locale,
+        flat: flattenTranslation(translation),
+        namespace: ns,
+        [INTERNAL_SYMBOL]: {
+            shape: {},
+            map: {},
+        },
+    };
+}
+
+function createNamespace(ns, translation) {
+    const compiled = compileTranslation(translation, ns);
+    const namespace = {
+        translation: compileTranslation(translation, ns),
+        createTranslation: (locale, translation) => {
+            return compileTranslation(translation, ns, locale);
+        },
+        createMergedNamespace: (otherNs, otherTranslation) => {
+            return createNamespace(otherNs, otherTranslation);
+        },
+    };
+    return namespace;
+}
+
+const CONFIG_TOKEN = new InjectionToken('mmstack-intl-config');
+function provideIntlConfig(config) {
+    return {
+        useValue: config,
+        provide: CONFIG_TOKEN,
+    };
+}
+function injectIntlConfig() {
+    return inject(CONFIG_TOKEN, { optional: true }) ?? undefined;
+}
+function injectDefaultLocale() {
+    return injectIntlConfig()?.defaultLocale ?? 'en-US';
+}
+class TranslationStore {
+    cache = createIntlCache();
+    config = injectIntlConfig();
+    locale = inject(LOCALE_ID);
+    defaultLocale = injectDefaultLocale();
+    translations = signal({
+        [this.defaultLocale]: {},
+    });
+    nonMessageConfig = computed(() => ({
+        ...this.config,
+        locale: this.locale,
+    }));
+    messages = computed(() => this.translations()[this.locale] ??
+        this.translations()[this.defaultLocale] ??
+        {});
+    intl = computed(() => createIntl({
+        ...this.nonMessageConfig(),
+        messages: this.messages(),
+    }, this.cache));
+    formatMessage(key, values) {
+        const message = this.translations()[this.locale]?.[key] ?? '';
+        if (!message)
+            return '';
+        return this.intl().formatMessage({ id: key, defaultMessage: message }, values);
+    }
+    register(namespace, flat) {
+        this.translations.update((cur) => {
+            return Object.entries(flat).reduce((acc, [locale, translation]) => {
+                const localeTranslation = acc[locale] ?? {};
+                const withNS = Object.entries(translation ?? {}).reduce((acc, [key, value]) => {
+                    acc[prependDelim(namespace, key)] = value;
+                    return acc;
+                }, {});
+                acc[locale] = {
+                    ...localeTranslation,
+                    ...withNS,
+                };
+                return acc;
+            }, { ...cur });
+        });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.3", ngImport: i0, type: TranslationStore, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.2.3", ngImport: i0, type: TranslationStore, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.3", ngImport: i0, type: TranslationStore, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }] });
+function injectIntl() {
+    return inject(TranslationStore).intl;
+}
+
+function createEqualsRecord(keys = []) {
+    let keyMatcher;
+    if (keys.length === 0) {
+        keyMatcher = () => true;
+    }
+    else if (keys.length === 1) {
+        const key = keys[0];
+        keyMatcher = (a, b) => a[key] === b[key];
+    }
+    else {
+        keyMatcher = (a, b) => {
+            return keys.every((k) => a[k] === b[k]);
+        };
+    }
+    return (a, b) => {
+        if (!a && !b)
+            return true;
+        if (!a || !b)
+            return false;
+        return keyMatcher(a, b);
+    };
+}
+function addSignalFn(fn, store) {
+    const withSig = fn;
+    const asSignal = (key, ...args) => {
+        const variables = args[0];
+        const stringKey = key;
+        const flatPath = replaceWithDelim(stringKey);
+        const varsFn = variables === undefined ? () => undefined : variables;
+        const varsSignal = isSignal(varsFn)
+            ? varsFn
+            : computed(varsFn, {
+                equal: createEqualsRecord(Object.keys(varsFn())),
+            });
+        return computed(() => store.formatMessage(flatPath, varsSignal()));
+    };
+    withSig.asSignal = asSignal;
+    return withSig;
+}
+function createT(store) {
+    return (key, ...args) => {
+        const variables = args[0];
+        const stringKey = key;
+        return store.formatMessage(replaceWithDelim(stringKey), variables);
+    };
+}
+function registerNamespace({ namespace: ns, flat: defaultTranslation }, other) {
+    const injectT = () => {
+        const store = inject(TranslationStore);
+        return addSignalFn(createT(store), store);
+    };
+    const resolver = async () => {
+        const locale = inject(LOCALE_ID);
+        const store = inject(TranslationStore);
+        const defaultLocale = injectDefaultLocale();
+        store.register(ns, {
+            [defaultLocale]: defaultTranslation,
+        });
+        if (locale === defaultLocale)
+            return;
+        const promise = other[locale];
+        if (!promise && isDevMode()) {
+            return console.warn(`No translation found for locale: ${locale}`);
+        }
+        try {
+            const translation = await promise();
+            if (translation.locale !== locale && isDevMode()) {
+                return console.warn(`Expected locale to be ${locale} but got ${translation.locale}`);
+            }
+            store.register(ns, {
+                [locale]: translation.flat,
+            });
+        }
+        catch {
+            if (isDevMode()) {
+                console.warn(`Failed to load translation for locale: ${locale}`);
+            }
+        }
+    };
+    return {
+        injectNamespaceT: injectT,
+        resolveNamespaceTranslation: resolver,
+    };
+}
+
+class BaseTranslateDirective {
+    t = createT(inject(TranslationStore));
+    translate = input.required();
+    constructor() {
+        const key = computed(() => {
+            const vars = this.translate();
+            return (Array.isArray(vars) ? vars[0] : vars);
+        });
+        const args = computed(() => {
+            const vars = this.translate();
+            return (Array.isArray(vars) ? vars[1] : undefined);
+        }, {
+            equal: (a, b) => {
+                if (a === undefined && b === undefined)
+                    return true;
+                if (a === undefined || b === undefined)
+                    return false;
+                const aObj = a;
+                const keys = Object.keys(aObj);
+                const bObj = b;
+                if (!keys.length)
+                    return !Object.keys(bObj).length;
+                return keys.every((key) => aObj[key] === bObj[key]);
+            },
+        });
+        const translation = computed(() => this.t(key(), args()));
+        const renderer = inject(Renderer2);
+        const el = inject(ElementRef);
+        effect(() => renderer.setProperty(el.nativeElement, 'textContent', translation()));
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.3", ngImport: i0, type: BaseTranslateDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "19.2.3", type: BaseTranslateDirective, isStandalone: true, inputs: { translate: { classPropertyName: "translate", publicName: "translate", isSignal: true, isRequired: true, transformFunction: null } }, ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.3", ngImport: i0, type: BaseTranslateDirective, decorators: [{
+            type: Directive
+        }], ctorParameters: () => [] });
+
+class BaseTranslatePipe {
+    t = createT(inject(TranslationStore));
+    transform(key, ...args) {
+        return this.t(key, ...args);
+    }
 }
 
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { test };
+export { BaseTranslateDirective, BaseTranslatePipe, createNamespace, injectIntl, 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/test.ts","../../../../packages/translate/src/mmstack-translate.ts"],"sourcesContent":["import { Locale } from './supported-locales.type';\n\nexport function test(locale: Locale) {\n  return locale;\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"AAEM,SAAU,IAAI,CAAC,MAAc,EAAA;AACjC,IAAA,OAAO,MAAM;AACf;;ACJA;;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/translation.store.ts","../../../../packages/translate/src/lib/register-namespace.ts","../../../../packages/translate/src/lib/translate.directive.ts","../../../../packages/translate/src/lib/translate.pipe.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(KEY_DELIM, repl);\n}\n","import { prependDelim } from './delim';\nimport {\n  inferTranslationParamMap,\n  inferTranslationShape,\n} from './parameterize.type';\nimport { 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    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  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  inject,\n  Injectable,\n  InjectionToken,\n  LOCALE_ID,\n  Provider,\n  signal,\n} from '@angular/core';\nimport { createIntl, createIntlCache, IntlConfig } from '@formatjs/intl';\nimport { prependDelim } from './delim';\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  private readonly locale = 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 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 intl = computed(() =>\n    createIntl(\n      {\n        ...this.nonMessageConfig(),\n        messages: this.messages(),\n      },\n      this.cache,\n    ),\n  );\n\n  formatMessage(key: string, values?: Record<string, string | number>) {\n    const message = this.translations()[this.locale]?.[key] ?? '';\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\nexport function injectIntl() {\n  return inject(TranslationStore).intl;\n}\n","import {\n  computed,\n  inject,\n  isDevMode,\n  isSignal,\n  LOCALE_ID,\n  Signal,\n} from '@angular/core';\nimport {\n  CompiledTranslation,\n  inferCompiledTranslationMap,\n  inferCompiledTranslationShape,\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 ? () => undefined : variables;\n    const varsSignal = isSignal(varsFn)\n      ? varsFn\n      : computed(varsFn, {\n          equal: createEqualsRecord(Object.keys(varsFn() as object)),\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  TOther extends CompiledTranslation<\n    inferCompiledTranslationShape<TDefault>,\n    string\n  >,\n>(\n  { namespace: ns, flat: defaultTranslation }: TDefault,\n  other: Record<string, () => Promise<TOther>>,\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  const resolver = async () => {\n    const locale = inject(LOCALE_ID);\n    const store = inject(TranslationStore);\n    const defaultLocale = injectDefaultLocale();\n\n    store.register(ns, {\n      [defaultLocale]: defaultTranslation,\n    });\n\n    if (locale === defaultLocale) return;\n\n    const promise = other[locale] as () => Promise<TOther>;\n\n    if (!promise && isDevMode()) {\n      return console.warn(`No translation found for locale: ${locale}`);\n    }\n\n    try {\n      const translation = await promise();\n\n      if (translation.locale !== locale && isDevMode()) {\n        return console.warn(\n          `Expected locale to be ${locale} but got ${translation.locale}`,\n        );\n      }\n\n      store.register(ns, {\n        [locale]: translation.flat,\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  computed,\n  Directive,\n  effect,\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 BaseTranslateDirective<\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    effect(() =>\n      renderer.setProperty(el.nativeElement, 'textContent', translation()),\n    );\n  }\n}\n","import { 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 BaseTranslatePipe<\n  T extends CompiledTranslation<UnknownStringKeyObject, string>,\n  TMap extends inferCompiledTranslationMap<T> = inferCompiledTranslationMap<T>,\n> {\n  private readonly t = createT<TMap>(inject(TranslationStore));\n\n  transform<K extends keyof TMap & string>(\n    key: K,\n    ...args: TMap[K] extends void ? [] : [TMap[K]]\n  ): string {\n    return this.t(key, ...args);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -1,2 +1,5 @@
-export { SupportedLocales } from './lib/supported-locales.type';
-export * from './lib/test';
+export { createNamespace } from './lib/create-namespace';
+export { registerNamespace } from './lib/register-namespace';
+export { BaseTranslateDirective } from './lib/translate.directive';
+export { BaseTranslatePipe } from './lib/translate.pipe';
+export { injectIntl, provideIntlConfig } from './lib/translation.store';

package/lib/compile.d.ts

@@ -0,0 +1,24 @@
+import { inferTranslationParamMap, inferTranslationShape } from './parameterize.type';
+import { UnknownStringKeyObject } from './string-key-object.type';
+declare const INTERNAL_SYMBOL: unique symbol;
+type InternalSymbol = typeof INTERNAL_SYMBOL;
+export type CompiledTranslation<T extends UnknownStringKeyObject, TNS extends string, TLocale extends string = string> = {
+    flat: Record<string, string>;
+    locale?: TLocale;
+    namespace: TNS;
+    [INTERNAL_SYMBOL]: {
+        shape: inferTranslationShape<T>;
+        map: inferTranslationParamMap<TNS, T>;
+    };
+};
+export type mergeTranslationMaps<TMain extends CompiledTranslation<UnknownStringKeyObject, string>, TOther extends CompiledTranslation<UnknownStringKeyObject, string>> = Omit<TMain, InternalSymbol> & {
+    [INTERNAL_SYMBOL]: {
+        shape: inferCompiledTranslationShape<TMain>;
+        map: inferCompiledTranslationMap<TOther> & inferCompiledTranslationMap<TMain>;
+    };
+};
+export type inferCompiledTranslationNamespace<T extends CompiledTranslation<UnknownStringKeyObject, string>> = T['namespace'];
+export type inferCompiledTranslationShape<T extends CompiledTranslation<UnknownStringKeyObject, string>> = T[InternalSymbol]['shape'];
+export type inferCompiledTranslationMap<T extends CompiledTranslation<UnknownStringKeyObject, string>> = T[InternalSymbol]['map'];
+export declare function compileTranslation<T extends UnknownStringKeyObject, TNS extends string, TLocale extends string = string>(translation: T, ns: TNS, locale?: TLocale): CompiledTranslation<T, TNS, TLocale>;
+export {};

package/lib/create-namespace.d.ts

@@ -0,0 +1,9 @@
+import { CompiledTranslation, inferCompiledTranslationShape, mergeTranslationMaps } from './compile';
+import { UnknownStringKeyObject } from './string-key-object.type';
+type TranslationNamespace<TNS extends string, T extends CompiledTranslation<UnknownStringKeyObject, TNS>, TShape extends UnknownStringKeyObject> = {
+    translation: T;
+    createTranslation: <TLocale extends string>(locale: TLocale, translation: TShape) => CompiledTranslation<TShape, TNS, TLocale>;
+    createMergedNamespace: <TOtherNS extends string, TOther extends UnknownStringKeyObject, TOtherCompiled extends CompiledTranslation<TOther, TOtherNS>>(ns: TOtherNS, translation: TOther) => TranslationNamespace<TOtherNS, mergeTranslationMaps<TOtherCompiled, T>, inferCompiledTranslationShape<TOtherCompiled>>;
+};
+export declare function createNamespace<T extends UnknownStringKeyObject, TNS extends string>(ns: TNS, translation: T): TranslationNamespace<TNS, CompiledTranslation<T, TNS, string>, import("./parameterize.type").inferTranslationShape<T>>;
+export {};

package/lib/delim.d.ts

@@ -0,0 +1,2 @@
+export declare function prependDelim(prefix: string, key: string): string;
+export declare function replaceWithDelim(str: string, repl?: string): string;

package/lib/parameterize.type.d.ts

@@ -0,0 +1,30 @@
+import { UnknownStringKeyObject } from './string-key-object.type';
+type Simplify<T> = T extends infer U ? {
+    [K in keyof U]: Simplify<U[K]>;
+} : never;
+type Autocomplete<T extends string> = T | Omit<string, T>;
+type extractSelectOptions<TOpt extends string> = TOpt extends `${infer Option}{${infer _}} ${infer Rest}` ? Option | extractSelectOptions<Rest> : TOpt extends `${infer Option}{${infer _}}` ? Option : never;
+type extractSelectParam<TName extends string, TOpt extends string> = [
+    TName,
+    Autocomplete<Exclude<extractSelectOptions<TOpt>, 'other'>>
+];
+type extractComplexParam<T extends string> = T extends `{${infer VarName}, plural, ${infer _}}}${infer REST}` | `{${infer VarName}, selectordinal, ${infer _}}}${infer REST}` ? [VarName, number] | extractParams<REST> : T extends `{${infer VarName}, select, ${infer SelectOptions}}}${infer REST}` ? extractSelectParam<VarName, `${SelectOptions}}`> | extractParams<REST> : never;
+export type extractParams<T extends string> = T extends `${infer _Start}{${infer Var}}${infer End}` ? Var extends `${infer _}, ${infer __}` ? extractComplexParam<`{${Var}}${End}`> : [Var, string] | extractParams<End> : never;
+type mergeParams<TExtracted extends [string, any]> = {
+    [K in TExtracted[0]]: TExtracted[1];
+};
+type flattenParams<TKey extends string, TVal> = TVal extends UnknownStringKeyObject ? inferParamTupples<TVal, `${TKey}.`> : TVal extends string ? extractParams<TVal> extends never ? [TKey] : [TKey, mergeParams<extractParams<TVal>>] : never;
+type inferParamTupples<T extends UnknownStringKeyObject, TPrefix extends string = ''> = Simplify<{
+    [K in keyof T]: K extends string ? flattenParams<`${TPrefix}${K}`, T[K]> : never;
+}[keyof T]>;
+export type inferTranslationParamMap<TNS extends string, T extends UnknownStringKeyObject> = Simplify<{
+    [Tuple in inferParamTupples<T> as Tuple[0] extends string ? `${TNS}.${Tuple[0]}` : never]: Tuple extends [string, infer Vars] ? Vars : void;
+}>;
+type StringContaining<Placeholder extends string> = `${string}${Placeholder}${string}`;
+type TypeEnsuringAllPlaceholders<PlaceholdersUnion extends string> = StringContaining<PlaceholdersUnion>;
+export type extractParamString<T extends string> = T extends `${infer _Start}{${infer Var}}${infer End}` ? Var extends `${infer VarName},${string}` ? `{${VarName}}` | extractParamString<End> : `{${Var}}` | extractParamString<End> : never;
+type inferParamsFromValue<V extends string> = extractParamString<V> extends never ? string : TypeEnsuringAllPlaceholders<extractParamString<V>>;
+export type inferTranslationShape<T extends UnknownStringKeyObject> = {
+    [K in keyof T]: T[K] extends UnknownStringKeyObject ? inferTranslationShape<T[K]> : T[K] extends string ? inferParamsFromValue<T[K]> : never;
+};
+export {};

package/lib/register-namespace.d.ts

@@ -0,0 +1,16 @@
+import { Signal } from '@angular/core';
+import { CompiledTranslation, inferCompiledTranslationMap, inferCompiledTranslationShape } from './compile';
+import { UnknownStringKeyObject } from './string-key-object.type';
+import { TranslationStore } from './translation.store';
+type AnyStringRecord = Record<string, any>;
+type TFunction<TMap extends AnyStringRecord> = <TKey extends keyof TMap & string>(key: TKey, ...args: TMap[TKey] extends void ? [] : [TMap[TKey]]) => string;
+type SignalTFunction<TMap extends AnyStringRecord> = <TKey extends keyof TMap & string>(key: TKey, ...args: TMap[TKey] extends void ? [] : [() => TMap[TKey]]) => Signal<string>;
+type TFunctionWithSignalConstructor<TMap extends AnyStringRecord, TFN extends TFunction<TMap>> = TFN & {
+    asSignal: SignalTFunction<TMap>;
+};
+export declare function createT<TMap extends AnyStringRecord>(store: TranslationStore): TFunction<TMap>;
+export declare function registerNamespace<TDefault extends CompiledTranslation<UnknownStringKeyObject, string>, TOther extends CompiledTranslation<inferCompiledTranslationShape<TDefault>, string>>({ namespace: ns, flat: defaultTranslation }: TDefault, other: Record<string, () => Promise<TOther>>): {
+    injectNamespaceT: () => TFunctionWithSignalConstructor<inferCompiledTranslationMap<TDefault>, TFunction<inferCompiledTranslationMap<TDefault>>>;
+    resolveNamespaceTranslation: () => Promise<void>;
+};
+export {};

package/lib/string-key-object.type.d.ts

@@ -0,0 +1 @@
+export type UnknownStringKeyObject = Record<string, unknown>;

package/lib/translate.directive.d.ts

@@ -0,0 +1,10 @@
+import { CompiledTranslation, inferCompiledTranslationMap } from './compile';
+import { UnknownStringKeyObject } from './string-key-object.type';
+import * as i0 from "@angular/core";
+export declare abstract class BaseTranslateDirective<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: import("@angular/core").InputSignal<TMap[TKey] extends void ? TKey | [key: TKey] : [key: TKey, vars: TMap[TKey]]>;
+    constructor();
+    static ɵfac: i0.ɵɵFactoryDeclaration<BaseTranslateDirective<any, any, any, any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<BaseTranslateDirective<any, any, any, any>, never, never, { "translate": { "alias": "translate"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/lib/translate.pipe.d.ts

@@ -0,0 +1,6 @@
+import { CompiledTranslation, inferCompiledTranslationMap } from './compile';
+import { UnknownStringKeyObject } from './string-key-object.type';
+export declare abstract class BaseTranslatePipe<T extends CompiledTranslation<UnknownStringKeyObject, string>, TMap extends inferCompiledTranslationMap<T> = inferCompiledTranslationMap<T>> {
+    private readonly t;
+    transform<K extends keyof TMap & string>(key: K, ...args: TMap[K] extends void ? [] : [TMap[K]]): string;
+}

package/lib/translation.store.d.ts

@@ -0,0 +1,21 @@
+import { Provider } from '@angular/core';
+import { IntlConfig } from '@formatjs/intl';
+import * as i0 from "@angular/core";
+export declare function provideIntlConfig(config: Omit<IntlConfig, 'locale' | 'messages'>): Provider;
+export declare function injectIntlConfig(): Omit<IntlConfig, "locale" | "messages"> | undefined;
+export declare function injectDefaultLocale(): string;
+export declare class TranslationStore {
+    private readonly cache;
+    private readonly config;
+    private readonly locale;
+    private readonly defaultLocale;
+    private readonly translations;
+    private readonly nonMessageConfig;
+    private readonly messages;
+    readonly intl: import("@angular/core").Signal<import("@formatjs/intl").IntlShape<string>>;
+    formatMessage(key: string, values?: Record<string, string | number>): string;
+    register(namespace: string, flat: Partial<Record<string, Record<string, string>>>): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TranslationStore, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<TranslationStore>;
+}
+export declare function injectIntl(): import("@angular/core").Signal<import("@formatjs/intl").IntlShape<string>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmstack/translate",
-  "version": "0.0.1",
+  "version": "19.1.0",
   "keywords": [
     "angular",
     "localize",
@@ -13,6 +13,10 @@
     "type": "git",
     "url": "https://github.com/mihajm/mmstack"
   },
+  "peerDependencies": {
+    "@angular/core": "~19.2.3",
+    "@formatjs/intl": "~3.1.6"
+  },
   "homepage": "https://github.com/mihajm/mmstack/blob/master/packages/translate",
   "sideEffects": false,
   "module": "fesm2022/mmstack-translate.mjs",

package/lib/supported-locales.type.d.ts

@@ -1,22 +0,0 @@
-/**
- * Represents the known locales for the application.
- * Library consumers should augment this interface in their own projects
- * to add their specific locales using declaration merging.
- * Value types don't really matter, only the keys are used.
- *
- * @example
- * // In your's project (e.g., src/app/types/locale.d.ts)
- * declare module '@mmstack/translate' {
- * interface SupportedLocales {
- *    'en-US': string;
- *    'de-DE': string;
- *    'fr-CA': string;
- *   }
- * }
- */
-export interface SupportedLocales {
-    'en-US': string;
-}
-type AssertStringKey<T> = T extends string ? T : never;
-export type Locale = AssertStringKey<keyof SupportedLocales>;
-export {};

package/lib/test.d.ts

@@ -1,2 +0,0 @@
-import { Locale } from './supported-locales.type';
-export declare function test(locale: Locale): "en-US";