i18next 25.10.7 → 25.10.9

package/dist/esm/package.json

@@ -1 +1 @@
-{"type":"module","version":"25.10.7"}
+{"type":"module","version":"25.10.9"}

package/jsr.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18next/i18next",
-  "version": "25.10.7",
+  "version": "25.10.9",
   "license": "MIT",
   "exports": "./src/index.js",
   "publish": {

package/package.json

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

package/typescript/t.d.ts

@@ -472,6 +472,23 @@ export type NsResource<Ns extends Namespace> = Ns extends readonly [keyof Resour
 /** A selector function that can be used as `keyPrefix` to scope `t()` to a sub-tree of the resource. */
 export type KeyPrefixSelector<Ns extends Namespace> = (src: NsResource<Ns>) => object;
 
+/**
+ * The type of a selector function accepted by `t()` for a given namespace and optional key prefix.
+ * Use this instead of `Parameters<TFunction<Ns>>[0]` for a stable, readable type.
+ *
+ * @example
+ * ```ts
+ * import type { SelectorParam } from 'i18next';
+ *
+ * interface CmpProps {
+ *   i18nKey: SelectorParam<'myNamespace'>;
+ * }
+ * ```
+ */
+export type SelectorParam<Ns extends Namespace = DefaultNamespace, KPrefix = undefined> = (
+  src: Select<GetSource<Ns, KPrefix>, undefined>,
+) => string;
+
 /// ////////////// ///
 ///  ↆ selector ↆ  ///
 /// ////////////// ///
@@ -514,6 +531,16 @@ type DeepUnwrapPlural<T> =
 type NsArg<Ns extends Namespace> = Ns[number] | readonly Ns[number][];
 
 interface TFunctionSelector<Ns extends Namespace, KPrefix, Source> extends Branded<Ns> {
+  // ── Pre-computed key(s) from keyFromSelector ────────────────────────────────
+  // Accepts a branded `SelectorKey` (or array of them) produced by `keyFromSelector`.
+  // Return-type precision is traded for the flexibility of decoupled key creation.
+  // Placed first so that the more general selector overloads (below) are last —
+  // TypeScript's `Parameters<>` utility resolves against the last call signature.
+  <const Opts extends SelectorOptions<Ns[number]> = SelectorOptions<Ns[number]>>(
+    key: SelectorKey | SelectorKey[],
+    ...args: [options?: Opts & $Dictionary]
+  ): DefaultTReturn<Opts>;
+
   // ── Selector(s) with explicit `ns` ───────────────────────────────────────────
   <
     Target extends ConstrainTarget<Opts>,
@@ -593,14 +620,6 @@ interface TFunctionSelector<Ns extends Namespace, KPrefix, Source> extends Brand
       ? [options: Opts & { count: number } & InterpolationMap<DeepUnwrapPlural<ReturnType<Fn>>>]
       : [options?: Opts & InterpolationMap<ReturnType<Fn>>]
   ): SelectorReturn<ReturnType<Fn>, Opts>;
-
-  // ── Pre-computed key(s) from keyFromSelector ────────────────────────────────
-  // Accepts a branded `SelectorKey` (or array of them) produced by `keyFromSelector`.
-  // Return-type precision is traded for the flexibility of decoupled key creation.
-  <const Opts extends SelectorOptions<Ns[number]> = SelectorOptions<Ns[number]>>(
-    key: SelectorKey | SelectorKey[],
-    ...args: [options?: Opts & $Dictionary]
-  ): DefaultTReturn<Opts>;
 }
 
 interface SelectorOptions<Ns = Namespace>