i18next 23.8.3 → 23.9.0

package/dist/esm/package.json

@@ -1 +1 @@
-{"type":"module","version":"23.8.3"}
+{"type":"module","version":"23.9.0"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next",
-  "version": "23.8.3",
+  "version": "23.9.0",
   "description": "i18next internationalization framework",
   "main": "./dist/cjs/i18next.js",
   "module": "./dist/esm/i18next.js",

package/typescript/helpers.d.ts

@@ -12,4 +12,49 @@ export type $OmitArrayKeys<Arr> = Arr extends readonly any[] ? Omit<Arr, keyof a
 
 export type $PreservedValue<Value, Fallback> = [Value] extends [never] ? Fallback : Value;
 
-export type $NormalizeIntoArray<T extends unknown | readonly unknown[]> = T extends readonly unknown[] ? T : [T];
+export type $NormalizeIntoArray<T extends unknown | readonly unknown[]> =
+  T extends readonly unknown[] ? T : [T];
+
+/**
+ * @typeParam T
+ * @example
+ * ```
+ * $UnionToIntersection<{foo: {bar: string} | {asd: boolean}}> = {foo: {bar: string} & {asd: boolean}}
+ * ```
+ *
+ * @see https://stackoverflow.com/questions/50374908/transform-union-type-to-intersection-type
+ */
+type $UnionToIntersection<T> = (T extends unknown ? (k: T) => void : never) extends (
+  k: infer I,
+) => void
+  ? I
+  : never;
+
+/**
+ * @typeParam TPath union of strings
+ * @typeParam TValue value of the record
+ * @example
+ * ```
+ * $StringKeyPathToRecord<'foo.bar' | 'asd'> = {foo: {bar: string} | {asd: boolean}}
+ * ```
+ */
+type $StringKeyPathToRecordUnion<
+  TPath extends string,
+  TValue,
+> = TPath extends `${infer TKey}.${infer Rest}`
+  ? { [Key in TKey]: $StringKeyPathToRecord<Rest, TValue> }
+  : { [Key in TPath]: TValue };
+
+/**
+ * Used to intersect output of {@link $StringKeyPathToRecordUnion}
+ *
+ * @typeParam TPath union of strings
+ * @typeParam TValue value of the record
+ * @example
+ * ```
+ * $StringKeyPathToRecord<'foo.bar' | 'asd'> = {foo: {bar: string} & {asd: boolean}}
+ * ```
+ */
+export type $StringKeyPathToRecord<TPath extends string, TValue> = $UnionToIntersection<
+  $StringKeyPathToRecordUnion<TPath, TValue>
+>;

package/typescript/t.d.ts

@@ -1,4 +1,10 @@
-import type { $OmitArrayKeys, $PreservedValue, $Dictionary, $SpecialObject } from './helpers.js';
+import type {
+  $OmitArrayKeys,
+  $PreservedValue,
+  $Dictionary,
+  $SpecialObject,
+  $StringKeyPathToRecord,
+} from './helpers.js';
 import type {
   TypeOptions,
   Namespace,
@@ -140,9 +146,10 @@ type ParseInterpolationValues<Ret> =
         | (Value extends `${infer ActualValue},${string}` ? ActualValue : Value)
         | ParseInterpolationValues<Rest>
     : never;
-type InterpolationMap<Ret> = Record<
-  $PreservedValue<ParseInterpolationValues<Ret>, string>,
-  unknown
+
+type InterpolationMap<Ret> = $PreservedValue<
+  $StringKeyPathToRecord<ParseInterpolationValues<Ret>, unknown>,
+  Record<string, unknown>
 >;
 
 type ParseTReturnPlural<

package/typescript/t.v4.d.ts

@@ -1,4 +1,10 @@
-import type { $OmitArrayKeys, $PreservedValue, $Dictionary, $SpecialObject } from './helpers.js';
+import type {
+  $OmitArrayKeys,
+  $PreservedValue,
+  $Dictionary,
+  $SpecialObject,
+  $StringKeyPathToRecord,
+} from './helpers.js';
 import type {
   TypeOptions,
   Namespace,
@@ -7,6 +13,9 @@ import type {
   TOptions,
 } from './options.js';
 
+/** @todo consider to replace {} with Record<string, never> */
+/* eslint @typescript-eslint/ban-types: ['error', { types: { "{}": false } }] */
+
 // Type Options
 type _ReturnObjects = TypeOptions['returnObjects'];
 type _ReturnEmptyString = TypeOptions['returnEmptyString'];
@@ -21,9 +30,6 @@ type _JSONFormat = TypeOptions['jsonFormat'];
 type _InterpolationPrefix = TypeOptions['interpolationPrefix'];
 type _InterpolationSuffix = TypeOptions['interpolationSuffix'];
 
-/** @todo consider to replace {} with Record<string, never> */
-/* eslint @typescript-eslint/ban-types: ['error', { types: { "{}": false } }] */
-
 type $IsResourcesDefined = [keyof _Resources] extends [never] ? false : true;
 type $ValueIfResourcesDefined<Value, Fallback> = $IsResourcesDefined extends true
   ? Value
@@ -140,9 +146,10 @@ type ParseInterpolationValues<Ret> =
         | (Value extends `${infer ActualValue},${string}` ? ActualValue : Value)
         | ParseInterpolationValues<Rest>
     : never;
-type InterpolationMap<Ret> = Record<
-  $PreservedValue<ParseInterpolationValues<Ret>, string>,
-  unknown
+
+type InterpolationMap<Ret> = $PreservedValue<
+  $StringKeyPathToRecord<ParseInterpolationValues<Ret>, unknown>,
+  Record<string, unknown>
 >;
 
 type ParseTReturnPlural<