i18next 26.0.7 → 26.0.9

package/README.md

@@ -23,7 +23,7 @@ i18next provides:
 - Extensibility: eg. [sprintf](https://www.i18next.com/overview/plugins-and-utils#post-processors)
 - ...
 
-> **Pro Tip:** Looking for a way to manage your translations? Locize is the official service by i18next's creators and now offers a **[Free plan](https://www.locize.com/pricing)** for small projects.
+> **Pro Tip:** Looking for a way to manage your translations? Locize is the official service by i18next's creators and now offers a **[Free plan](https://www.locize.com/pricing?utm_source=i18next_readme&utm_medium=github&utm_campaign=readme)** for small projects.
 
 For more information visit the website:
 
@@ -44,21 +44,21 @@ The react specific documentation is published on [react.i18next.com](https://rea
 <h3 align="center">Gold Sponsors</h3>
 
 <p align="center">
-  <a href="https://locize.com/" target="_blank">
+  <a href="https://www.locize.com/?utm_source=i18next_readme&utm_medium=github&utm_campaign=readme" target="_blank">
     <img src="https://raw.githubusercontent.com/i18next/i18next/master/assets/locize_sponsor_240.gif" width="240px">
   </a>
 </p>
 
 ---
 
-**From the creators of i18next: localization as a service - [Locize](https://locize.com)**
+**From the creators of i18next: localization as a service - [Locize](https://www.locize.com?utm_source=i18next_readme&utm_medium=github&utm_campaign=readme)**
 
-A translation management system built around the i18next ecosystem - [Locize](https://locize.com).
+A translation management system built around the i18next ecosystem - [Locize](https://www.locize.com?utm_source=i18next_readme&utm_medium=github&utm_campaign=readme).
 
-**Now with a [Free plan](https://locize.com/pricing) for small projects!** Perfect for hobbyists or getting started.
+**Now with a [Free plan](https://www.locize.com/pricing?utm_source=i18next_readme&utm_medium=github&utm_campaign=readme) for small projects!** Perfect for hobbyists or getting started.
 
 ![Locize](https://www.locize.com/img/ads/github_locize.png)
 
-With using [Locize](https://www.locize.com/?utm_source=i18next_readme&utm_medium=github) you directly support the future of i18next.
+With using [Locize](https://www.locize.com/?utm_source=i18next_readme&utm_medium=github&utm_campaign=readme) you directly support the future of i18next.
 
 ---

package/dist/esm/package.json

@@ -1 +1 @@
-{"type":"module","version":"26.0.7"}
+{"type":"module","version":"26.0.9"}

package/index.d.ts

@@ -212,13 +212,17 @@ export type Callback = (error: any, t: TFunction) => void;
 
 /**
  * Uses similar args as the t function and returns true if a key exists.
- * Acts as a type guard, narrowing the key to {@link SelectorKey} so it can be passed to `t()`.
+ *
+ * Note: this shape intentionally does not include a type-guard overload so it
+ * remains easy to assign arrow functions to. The type guard narrowing to
+ * {@link SelectorKey} is declared directly on `i18n.exists` instead.
+ * Users who want narrowing on a custom wrapper can type it as
+ * `typeof i18next.exists`.
  */
 export interface ExistsFunction<
   TKeys extends string = string,
   TInterpolationMap extends object = $Dictionary,
 > {
-  (key: TKeys, options?: TOptions<TInterpolationMap>): key is TKeys & SelectorKey;
   (key: TKeys | TKeys[], options?: TOptions<TInterpolationMap>): boolean;
 }
 
@@ -284,8 +288,13 @@ export interface i18n extends CustomInstanceExtensions {
 
   /**
    * Uses similar args as the t function and returns true if a key exists.
+   * Acts as a type guard on single-key calls, narrowing the key to
+   * {@link SelectorKey} so it can be passed to `t()`.
    */
-  exists: ExistsFunction;
+  exists: {
+    <K extends string>(key: K, options?: TOptions): key is K & SelectorKey;
+    (key: string | string[], options?: TOptions): boolean;
+  };
 
   /**
    * Returns a resource data by language.

package/package.json

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

package/typescript/options.d.ts

@@ -122,7 +122,7 @@ export type TypeOptions = $MergeBy<
      * - `datetime` → `Date`
      * - `relativetime` → `number`
      * - `list` → `readonly string[]`
-     * - No format specifier → `string`
+     * - No format specifier → `string | number` (since i18next stringifies values at runtime)
      *
      * Use this option to add mappings for custom formatters or to override
      * the built-in defaults.

package/typescript/t.d.ts

@@ -196,7 +196,7 @@ type _StripFormatOptions<F> = F extends `${infer Name}(${string})` ? Name : F;
 type _ResolveEntryType<Name extends string, Format> = [Format] extends [never]
   ? Name extends 'count'
     ? number
-    : string
+    : string | number
   : Format extends keyof _InterpolationFormatTypeMap
     ? _InterpolationFormatTypeMap[Format]
     : _StripFormatOptions<Format> extends keyof _InterpolationFormatTypeMap