@mmstack/translate 19.2.8 → 19.3.1

package/lib/translation-store.d.ts

@@ -0,0 +1,69 @@
+import { type Provider, type Signal, type WritableSignal } from '@angular/core';
+import { type IntlConfig } from '@formatjs/intl';
+import * as i0 from "@angular/core";
+export 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[];
+export declare function injectIntlConfig(): (Omit<IntlConfig, "messages" | "locale"> & {
+    supportedLocales?: string[];
+    preloadDefaultLocale?: boolean;
+    localeParamName?: string;
+}) | undefined;
+export declare function injectDefaultLocale(): string;
+export declare function injectSupportedLocales(): string[];
+export declare function injectLocaleInternal(): WritableSignal<string>;
+export declare class TranslationStore {
+    private readonly cache;
+    private readonly config;
+    readonly loadQueue: WritableSignal<string[]>;
+    readonly locale: WritableSignal<string>;
+    private readonly defaultLocale;
+    private readonly translations;
+    private attemptedFallbackLoad;
+    private readonly onDemandLoaders;
+    private readonly nonMessageConfig;
+    private readonly messages;
+    readonly dynamicLocaleLoader: import("@angular/core").ResourceRef<{
+        locales: {
+            namespace: string;
+            flat: Record<string, string>;
+        }[];
+        locale: string;
+    } | undefined>;
+    readonly intl: Signal<import("@formatjs/intl").IntlShape<string>>;
+    constructor();
+    formatMessage(key: string, values?: Record<string, string | number>): string;
+    register(namespace: string, flat: Partial<Record<string, Record<string, string>>>): void;
+    registerOnDemandLoaders(namespace: string, loaders: Record<string, () => Promise<any>>): void;
+    hasLocaleLoaders(locale: string): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TranslationStore, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<TranslationStore>;
+}
+export declare function injectIntl(): Signal<import("@formatjs/intl").IntlShape<string>>;
+/**
+ * Inject a dynamic locale signal that supports runtime language switching.
+ *
+ * @returns A writable signal with the current locale and loading state.
+ * Only allows switching to locales that have registered loaders.
+ *
+ * @example
+ * ```typescript
+ * const locale = injectDynamicLocale();
+ *
+ * // Switch language (triggers automatic translation loading)
+ * locale.set('sl-SI');
+ *
+ * // Check loading state
+ * if (locale.isLoading()) {
+ *   // Show spinner
+ * }
+ * ```
+ */
+export declare function injectDynamicLocale(): WritableSignal<string> & {
+    isLoading: Signal<boolean>;
+};

package/lib/translator.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmstack/translate",
-  "version": "19.2.8",
+  "version": "19.3.1",
   "keywords": [
     "angular",
     "localize",
@@ -14,8 +14,9 @@
     "url": "https://github.com/mihajm/mmstack"
   },
   "peerDependencies": {
-    "@angular/core": "~19.2.3",
-    "@formatjs/intl": "~3.1.6"
+    "@angular/core": ">=19 <20",
+    "@angular/router": ">=19 <20",
+    "@formatjs/intl": "~3.1.8 || ^4.0.0"
   },
   "homepage": "https://github.com/mihajm/mmstack/blob/master/packages/translate",
   "sideEffects": false,

package/lib/translate.directive.d.ts

@@ -1,10 +0,0 @@
-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

@@ -1,6 +0,0 @@
-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

@@ -1,21 +0,0 @@
-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, "messages" | "locale"> | 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>>>, locale: 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>>;