i18next 25.10.0 → 25.10.2

package/dist/esm/package.json

@@ -1 +1 @@
-{"type":"module","version":"25.10.0"}
+{"type":"module","version":"25.10.2"}

package/index.d.mts

@@ -2,7 +2,7 @@ import * as i18nextMod from './index.js';
 import type { $Dictionary } from './typescript/helpers.js';
 
 import type { DefaultNamespace, Namespace } from './typescript/options.js';
-import type { SelectorKey } from './typescript/t.js';
+import type { KeyFromSelectorFn } from './typescript/t.js';
 
 export type WithT<Ns extends Namespace = DefaultNamespace> = i18nextMod.WithT<Ns>;
 export type Interpolator = i18nextMod.Interpolator;
@@ -59,6 +59,4 @@ export const hasLoadedNamespace: i18n['hasLoadedNamespace'];
 export const loadNamespaces: i18n['loadNamespaces'];
 export const loadLanguages: i18n['loadLanguages'];
 
-export declare function keyFromSelector<S = Record<string, any>>(
-  selector: ($: S) => any,
-): SelectorKey;
+export declare const keyFromSelector: KeyFromSelectorFn;

package/index.d.ts

@@ -12,7 +12,7 @@ import type {
   ResourceLanguage,
   TOptions,
 } from './typescript/options.js';
-import type { KeyPrefix, TFunction, SelectorKey } from './typescript/t.js';
+import type { KeyPrefix, TFunction, KeyFromSelectorFn } from './typescript/t.js';
 
 export interface WithT<Ns extends Namespace = DefaultNamespace> {
   // Expose parameterized t in the i18next interface hierarchy
@@ -583,6 +583,4 @@ export const hasLoadedNamespace: i18n['hasLoadedNamespace'];
 export const loadNamespaces: i18n['loadNamespaces'];
 export const loadLanguages: i18n['loadLanguages'];
 
-export declare function keyFromSelector<S = Record<string, any>>(
-  selector: ($: S) => any,
-): SelectorKey;
+export declare const keyFromSelector: KeyFromSelectorFn;

package/jsr.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next",
-  "version": "25.10.0",
+  "version": "25.10.2",
   "description": "i18next internationalization framework",
   "main": "./dist/cjs/i18next.js",
   "module": "./dist/esm/i18next.js",
@@ -49,7 +49,7 @@
     }
   ],
   "dependencies": {
-    "@babel/runtime": "^7.28.6"
+    "@babel/runtime": "^7.29.2"
   },
   "peerDependencies": {
     "typescript": "^5"
@@ -66,16 +66,16 @@
     "@babel/plugin-transform-modules-commonjs": "^7.28.6",
     "@babel/plugin-transform-runtime": "^7.29.0",
     "@babel/polyfill": "^7.12.1",
-    "@babel/preset-env": "^7.29.0",
+    "@babel/preset-env": "^7.29.2",
     "@babel/preset-react": "^7.28.5",
     "@babel/register": "^7.28.6",
     "@rollup/plugin-babel": "^7.0.0",
     "@rollup/plugin-commonjs": "^29.0.2",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-terser": "^1.0.0",
-    "@types/node": "^25.3.5",
-    "@typescript-eslint/eslint-plugin": "^8.57.0",
-    "@typescript-eslint/parser": "^8.57.0",
+    "@types/node": "^25.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.1",
+    "@typescript-eslint/parser": "^8.57.1",
     "@vitest/coverage-v8": "^3.2.4",
     "babelify": "^10.0.0",
     "coveralls": "^3.1.1",
@@ -92,10 +92,10 @@
     "i18next-http-backend": "^3.0.2",
     "i18next-localstorage-cache": "^1.1.1",
     "i18next-sprintf-postprocessor": "^0.2.2",
-    "lint-staged": "^16.3.2",
+    "lint-staged": "^16.4.0",
     "prettier": "^3.8.1",
     "rimraf": "^6.1.3",
-    "rollup": "^4.59.0",
+    "rollup": "^4.59.1",
     "sinon": "^19.0.5",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4"

package/typescript/t.d.ts

@@ -478,6 +478,21 @@ declare const $SelectorKeyBrand: unique symbol;
  * Can be passed directly to `t()` when the selector API is enabled.
  */
 export type SelectorKey = string & { readonly [$SelectorKeyBrand]: typeof $SelectorKeyBrand };
+
+/**
+ * Type-safe signature for {@link keyFromSelector}.
+ * Constrains the selector callback against the default namespace's resources
+ * (same source that `t()` uses for selectors without explicit `ns`).
+ * When resources are not defined, accepts any selector.
+ */
+export type KeyFromSelectorFn = <
+  Ns extends Namespace = DefaultNamespace,
+  KPrefix extends KeyPrefix<Ns> = undefined,
+>(
+  selector: (src: Select<GetSource<Ns, KPrefix>, undefined>) => any,
+  opts?: { ns?: Ns; keyPrefix?: KPrefix },
+) => SelectorKey;
+
 /** Recursively strips the {@link PluralValue} brand from a type (handles nested objects for `returnObjects`). */
 type DeepUnwrapPlural<T> =
   T extends PluralValue<infer U>
@@ -657,6 +672,17 @@ type _HasContextVariant<T, K extends string, Context> = [
   ? false
   : true;
 
+/** Checks whether key K has **any** context variant in T (excluding pure plural suffixes). */
+type _IsContextualKey<T, K extends string> = [
+  Exclude<
+    keyof T & `${K}${_ContextSeparator}${string}`,
+    | `${K}${_PluralSeparator}${PluralSuffix}`
+    | `${K}${_PluralSeparator}ordinal${_PluralSeparator}${PluralSuffix}`
+  >,
+] extends [never]
+  ? false
+  : true;
+
 type FilterKeys<T, Context> = never | T extends readonly any[]
   ? { [I in keyof T]: FilterKeys<T[I], Context> }
   : $Prune<
@@ -674,7 +700,9 @@ type FilterKeys<T, Context> = never | T extends readonly any[]
                 : K extends string
                   ? _HasContextVariant<T, K, Context> extends true
                     ? never // context variant exists, drop base key (type 3 handles it)
-                    : K // no context variant exists, keep base key
+                    : _IsContextualKey<T, K> extends true
+                      ? never // key has context variants but not for this context
+                      : K // no context variants at all, keep base key
                   : K
             : K extends `${string}${_PluralSeparator}${PluralSuffix}`
               ? never