@mmstack/translate 21.1.14 → 21.1.15

package/package.json

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

package/types/mmstack-translate.d.ts

@@ -157,7 +157,7 @@ type FormatDateOptions = {
     locale: string;
 };
 /**
- * @deprecated UNSAFE FOR SSR/EDGE. Omiting the locale property forces a fallback to a process-level global singleton.
+ * @deprecated UNSAFE FOR SSR/EDGE. Omitting the locale property forces a fallback to a process-level global singleton.
  */
 type UnsafeFormatDateOptions = Omit<FormatDateOptions, 'locale'> & {
     /** Optional locale string falling back to the legacy global signal */
@@ -203,7 +203,7 @@ type FormatDisplayNameOptions = {
     locale: string;
 };
 /**
- * @deprecated UNSAFE FOR SSR/EDGE. Omiting the locale property forces a fallback to a process-level global singleton.
+ * @deprecated UNSAFE FOR SSR/EDGE. Omitting the locale property forces a fallback to a process-level global singleton.
  */
 type UnsafeFormatDisplayNameOptions = Omit<FormatDisplayNameOptions, 'locale'> & {
     /** Optional locale string falling back to the legacy global signal */
@@ -258,7 +258,7 @@ type FormatListOptions = {
     locale: string;
 };
 /**
- * @deprecated UNSAFE FOR SSR/EDGE. Omiting the locale property forces a fallback to a process-level global singleton.
+ * @deprecated UNSAFE FOR SSR/EDGE. Omitting the locale property forces a fallback to a process-level global singleton.
  */
 type UnsafeFormatListOptions = Omit<FormatListOptions, 'locale'> & {
     /** Optional locale string falling back to the legacy global signal */
@@ -324,7 +324,7 @@ type FormatNumberOptions = {
     locale: string;
 };
 /**
- * @deprecated UNSAFE FOR SSR/EDGE. Omiting the locale property forces a fallback to a process-level global singleton.
+ * @deprecated UNSAFE FOR SSR/EDGE. Omitting the locale property forces a fallback to a process-level global singleton.
  */
 type UnsafeFormatNumberOptions = Omit<FormatNumberOptions, 'locale'> & {
     /** Optional locale string falling back to the legacy global signal */
@@ -377,7 +377,7 @@ type FormatPercentOptions = {
     locale: string;
 };
 /**
- * @deprecated UNSAFE FOR SSR/EDGE. Omiting the locale property forces a fallback to a process-level global singleton.
+ * @deprecated UNSAFE FOR SSR/EDGE. Omitting the locale property forces a fallback to a process-level global singleton.
  */
 type UnsafeFormatPercentOptions = Omit<FormatPercentOptions, 'locale'> & {
     /** Optional locale string falling back to the legacy global signal */
@@ -425,7 +425,7 @@ type FormatCurrencyOptions = {
     locale: string;
 };
 /**
- * @deprecated UNSAFE FOR SSR/EDGE. Omiting the locale property forces a fallback to a process-level global singleton.
+ * @deprecated UNSAFE FOR SSR/EDGE. Omitting the locale property forces a fallback to a process-level global singleton.
  */
 type UnsafeFormatCurrencyOptions = Omit<FormatCurrencyOptions, 'locale'> & {
     /** Optional locale string falling back to the legacy global signal */
@@ -478,7 +478,7 @@ type FormatRelativeTimeOptions = {
     locale: string;
 };
 /**
- * @deprecated UNSAFE FOR SSR/EDGE. Omiting the locale property forces a fallback to a process-level global singleton.
+ * @deprecated UNSAFE FOR SSR/EDGE. Omitting the locale property forces a fallback to a process-level global singleton.
  */
 type UnsafeFormatRelativeTimeOptions = Omit<FormatRelativeTimeOptions, 'locale'> & {
     /** Optional locale string falling back to the legacy global signal */
@@ -555,6 +555,7 @@ type DynamicConfig = BaseConfig & {
 };
 type Config = RouteBasedConfig | DynamicConfig;
 declare function provideIntlConfig(config: Config): Provider[];
+declare function injectDefaultLocale(): string;
 declare function injectSupportedLocales(): string[];
 declare function injectIntl(): Signal<_formatjs_intl.IntlShape<string>>;
 /**
@@ -603,7 +604,18 @@ type SignalTFunction<TMap extends AnyStringRecord> = <TKey extends keyof TMap &
 type TFunctionWithSignalConstructor<TMap extends AnyStringRecord, TFN extends TFunction<TMap>> = TFN & {
     asSignal: SignalTFunction<TMap>;
 };
-declare function registerNamespace<TDefault extends CompiledTranslation<UnknownStringKeyObject, string>>(defaultTranslation: () => Promise<TDefault>, other: Record<string, () => Promise<CompiledTranslation<UnknownStringKeyObject, inferCompiledTranslationNamespace<TDefault>, string>>>): {
+/**
+ * Shape accepted by a namespace loader: a direct `CompiledTranslation`, or an
+ * ES-module-style object exposing one as `default` or `translation`. Lets
+ * callers write `() => import('./quote.namespace')` instead of the more
+ * verbose `() => import('./quote.namespace').then((m) => m.default)`.
+ */
+type LoadedTranslation<T extends CompiledTranslation<UnknownStringKeyObject, string>> = T | {
+    default: T;
+} | {
+    translation: T;
+};
+declare function registerNamespace<TDefault extends CompiledTranslation<UnknownStringKeyObject, string>>(defaultTranslation: () => Promise<LoadedTranslation<TDefault>>, other: Record<string, () => Promise<LoadedTranslation<CompiledTranslation<UnknownStringKeyObject, inferCompiledTranslationNamespace<TDefault>, string>>>>): {
     injectNamespaceT: () => TFunctionWithSignalConstructor<inferCompiledTranslationMap<TDefault>, TFunction<inferCompiledTranslationMap<TDefault>>>;
     resolveNamespaceTranslation: ResolveFn<void>;
 };
@@ -637,6 +649,9 @@ declare function injectUnsafeT(): {
     asSignal(key: string, params?: () => Record<string, string | number>): Signal<string>;
 };
 
+/**
+ * @internal
+ */
 declare function injectResolveParamLocale(snapshot: ActivatedRouteSnapshot): string;
 
 /**
@@ -751,5 +766,5 @@ declare abstract class Translator<T extends CompiledTranslation<UnknownStringKey
  */
 declare function withParams<const P extends Record<string, unknown>, const S extends string = string>(message: S): WithParams<P, S>;
 
-export { Translate, Translator, canMatchLocale, compileTranslation, createNamespace, formatCurrency, formatDate, formatDisplayName, formatList, formatNumber, formatPercent, formatRelativeTime, injectAddTranslations, injectDynamicLocale, injectFormatCurrency, injectFormatDate, injectFormatDisplayName, injectFormatList, injectFormatNumber, injectFormatPercent, injectFormatRelativeTime, injectFormatters, injectIntl, injectResolveParamLocale, injectSupportedLocales, injectUnsafeT, provideFormatCurrencyDefaults, provideFormatDateDefaults, provideFormatDefaults, provideFormatDisplayNameDefaults, provideFormatListDefaults, provideFormatNumberDefaults, provideFormatPercentDefaults, provideFormatRelativeTimeDefaults, provideIntlConfig, provideMockTranslations, registerNamespace, registerRemoteNamespace, withParams };
+export { Translate, Translator, canMatchLocale, compileTranslation, createNamespace, formatCurrency, formatDate, formatDisplayName, formatList, formatNumber, formatPercent, formatRelativeTime, injectAddTranslations, injectDefaultLocale, injectDynamicLocale, injectFormatCurrency, injectFormatDate, injectFormatDisplayName, injectFormatList, injectFormatNumber, injectFormatPercent, injectFormatRelativeTime, injectFormatters, injectIntl, injectResolveParamLocale, injectSupportedLocales, injectUnsafeT, provideFormatCurrencyDefaults, provideFormatDateDefaults, provideFormatDefaults, provideFormatDisplayNameDefaults, provideFormatListDefaults, provideFormatNumberDefaults, provideFormatPercentDefaults, provideFormatRelativeTimeDefaults, provideIntlConfig, provideMockTranslations, registerNamespace, registerRemoteNamespace, withParams };
 export type { CompiledTranslation, FormatCurrencyOptions, FormatDateOptions, FormatDisplayNameOptions, FormatListOptions, FormatNumberOptions, FormatPercentOptions, FormatRelativeTimeOptions, RelativeTimeUnit, SupportedDateInput, SupportedListInput, UnsafeFormatCurrencyOptions, UnsafeFormatDateOptions, UnsafeFormatDisplayNameOptions, UnsafeFormatListOptions, UnsafeFormatNumberOptions, UnsafeFormatPercentOptions, UnsafeFormatRelativeTimeOptions, inferCompiledTranslationMap, inferCompiledTranslationNamespace, inferCompiledTranslationShape, mergeTranslationMaps };