i18next 25.10.3 → 25.10.5

package/dist/esm/package.json

@@ -1 +1 @@
-{"type":"module","version":"25.10.3"}
+{"type":"module","version":"25.10.5"}

package/index.d.ts

@@ -11,8 +11,15 @@ import type {
   ResourceKey,
   ResourceLanguage,
   TOptions,
+  TypeOptions,
 } from './typescript/options.js';
-import type { KeyPrefix, TFunction, KeyFromSelectorFn } from './typescript/t.js';
+import type {
+  KeyPrefix,
+  KeyPrefixSelector,
+  TFunction,
+  KeyFromSelectorFn,
+  SelectorKey,
+} from './typescript/t.js';
 
 export interface WithT<Ns extends Namespace = DefaultNamespace> {
   // Expose parameterized t in the i18next interface hierarchy
@@ -200,11 +207,13 @@ 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()`.
  */
 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;
 }
 
@@ -286,6 +295,18 @@ export interface i18n extends CustomInstanceExtensions {
    *
    * Accepts optional keyPrefix that will be automatically applied to returned t function.
    */
+  getFixedT<
+    Ns extends Namespace | null,
+    const TKPrefixFn extends TypeOptions['enableSelector'] extends true | 'optimize'
+      ? KeyPrefixSelector<ActualNs>
+      : never,
+    ActualNs extends Namespace = Ns extends null ? DefaultNamespace : Ns,
+  >(
+    lng: string | readonly string[] | null,
+    ns: Ns,
+    keyPrefix: TKPrefixFn,
+  ): TFunction<ActualNs, TKPrefixFn>;
+
   getFixedT<
     Ns extends Namespace | null = DefaultNamespace,
     TKPrefix extends KeyPrefix<ActualNs> = undefined,
@@ -560,6 +581,8 @@ export type {
   TFunctionReturn,
   TFunctionDetailedResult,
   KeyPrefix,
+  KeyPrefixSelector,
+  NsResource,
   InterpolationMap,
   SelectorKey,
 } from './typescript/t.js';

package/jsr.json

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

package/package.json

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

package/typescript/t.d.ts

@@ -464,6 +464,14 @@ export interface TFunction<
 
 export type KeyPrefix<Ns extends Namespace> = ResourceKeys<true>[$FirstNamespace<Ns>] | undefined;
 
+/** The raw (unfiltered) resource object for a given namespace. */
+export type NsResource<Ns extends Namespace> = Ns extends readonly [keyof Resources, any, ...any]
+  ? Resources[Ns[0]] & PickNamespaces<Resources, Ns[number]>
+  : Resources[$FirstNamespace<Ns>];
+
+/** 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;
+
 /// ////////////// ///
 ///  ↆ selector ↆ  ///
 /// ////////////// ///
@@ -644,17 +652,22 @@ type PickNamespaces<T, K extends keyof any> = {
   [P in K as P extends keyof T ? P : never]: T[P & keyof T];
 };
 
-type GetSource<
-  Ns extends Namespace,
-  KPrefix,
-  Res = Ns extends readonly [keyof Resources, any, ...any]
-    ? Resources[Ns[0]] & PickNamespaces<Resources, Ns[number]>
-    : Resources[$FirstNamespace<Ns>],
-> = KPrefix extends keyof Res
-  ? Res[KPrefix]
-  : undefined extends KPrefix
-    ? Res
-    : ApplyKeyPrefix<[Res], KPrefix>;
+/** Extracts the sub-tree returned by a selector function used as keyPrefix. */
+type SelectorReturnSource<KPrefix, Fallback> = KPrefix extends (...args: any[]) => infer R
+  ? R extends object
+    ? R
+    : Fallback
+  : Fallback;
+
+type GetSource<Ns extends Namespace, KPrefix, Res = NsResource<Ns>> = KPrefix extends (
+  ...args: any[]
+) => any
+  ? SelectorReturnSource<KPrefix, Res>
+  : KPrefix extends keyof Res
+    ? Res[KPrefix]
+    : undefined extends KPrefix
+      ? Res
+      : ApplyKeyPrefix<[Res], KPrefix>;
 
 type Select<T, Context> = $IsResourcesDefined extends false
   ? $Turtles