i18next 25.10.1 → 25.10.2

package/dist/esm/package.json

@@ -1 +1 @@
-{"type":"module","version":"25.10.1"}
+{"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.1",
+  "version": "25.10.2",
   "license": "MIT",
   "exports": "./src/index.js",
   "publish": {

package/package.json

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

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>