i18next 23.1.0 → 23.2.1

package/dist/esm/package.json

@@ -1 +1 @@
-{"type":"module","version":"23.1.0"}
+{"type":"module","version":"23.2.1"}

package/index.d.ts

@@ -75,6 +75,12 @@ export type TypeOptions = $MergeBy<
      */
     defaultNS: 'translation';
 
+    /**
+     * Fallback namespace used if translation not found in given namespace
+     * @default false
+     */
+    fallbackNS: false;
+
     /**
      * Json Format Version - V4 allows plural suffixes
      */
@@ -516,6 +522,7 @@ export interface InitOptions<T = object> extends PluginOptions<T> {
 
   /**
    * Returns an object that includes information about the used language, namespace, key and value
+   * @default false
    */
   returnDetails?: boolean;
 
@@ -740,6 +747,7 @@ type _KeySeparator = TypeOptions['keySeparator'];
 type _NsSeparator = TypeOptions['nsSeparator'];
 type _PluralSeparator = TypeOptions['pluralSeparator'];
 type _DefaultNamespace = TypeOptions['defaultNS'];
+type _FallbackNamespace = TypeOptions['fallbackNS'];
 type _Resources = TypeOptions['resources'];
 type _JSONFormat = TypeOptions['jsonFormat'];
 type _InterpolationPrefix = TypeOptions['interpolationPrefix'];
@@ -833,9 +841,21 @@ export type ParseKeys<
   Keys extends $Dictionary = KeysByTOptions<TOpt>,
   ActualNS extends Namespace = NsByTOptions<Ns, TOpt>,
 > = $IsResourcesDefined extends true
-  ?
-      | ParseKeysByKeyPrefix<Keys[$FirstNamespace<ActualNS>], KPrefix>
-      | ParseKeysByNamespaces<ActualNS, Keys>
+  ? _FallbackNamespace extends Array<infer FallbackNs extends Namespace>
+    ?
+        | ParseKeysByKeyPrefix<Keys[$FirstNamespace<ActualNS>], KPrefix>
+        | ParseKeysByKeyPrefix<Keys[$FirstNamespace<FallbackNs>], KPrefix>
+        | ParseKeysByNamespaces<ActualNS, Keys>
+        | ParseKeysByNamespaces<FallbackNs, Keys>
+    : _FallbackNamespace extends Namespace
+    ?
+        | ParseKeysByKeyPrefix<Keys[$FirstNamespace<ActualNS>], KPrefix>
+        | ParseKeysByKeyPrefix<Keys[$FirstNamespace<_FallbackNamespace>], KPrefix>
+        | ParseKeysByNamespaces<ActualNS, Keys>
+        | ParseKeysByNamespaces<_FallbackNamespace, Keys>
+    :
+        | ParseKeysByKeyPrefix<Keys[$FirstNamespace<ActualNS>], KPrefix>
+        | ParseKeysByNamespaces<ActualNS, Keys>
   : string;
 
 /*********************************************************

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next",
-  "version": "23.1.0",
+  "version": "23.2.1",
   "description": "i18next internationalization framework",
   "main": "./dist/cjs/i18next.js",
   "module": "./dist/esm/i18next.js",
@@ -103,13 +103,14 @@
     "watchify": "4.0.0"
   },
   "scripts": {
-    "pretest": "npm run test:typescript && npm run test:typescript:customtypes && npm run test:typescript:noninterop",
+    "pretest": "npm run test:typescript && npm run test:typescript:customtypes && npm run test:typescript:fallbacktypes && npm run test:typescript:noninterop",
     "lint": "eslint src",
     "test": "npm run lint && npm run test:new && npm run test:compat",
     "test:new": "karma start karma.conf.js --singleRun",
     "test:compat": "karma start karma.backward.conf.js --singleRun",
     "test:typescript": "tslint --project tsconfig.json",
     "test:typescript:customtypes": "tslint --project test/typescript/custom-types/tsconfig.json",
+    "test:typescript:fallbacktypes": "tslint --project test/typescript/fallback-types/tsconfig.json",
     "test:typescript:noninterop": "tslint --project tsconfig.nonEsModuleInterop.json",
     "tdd": "karma start karma.conf.js",
     "tdd:compat": "karma start karma.backward.conf.js",