@bleedingdev/modern-js-plugin-i18n 3.5.0-ultramodern.36 → 3.5.0-ultramodern.37

package/dist/types/runtime/i18n/instance.d.ts

@@ -1,46 +1,48 @@
 import type { BaseBackendOptions } from '../../shared/type';
-export interface I18nResourceStore {
+interface I18nResourceStore {
     data?: {
         [language: string]: {
-            [namespace: string]: string | {
-                [key: string]: any;
-            };
+            [namespace: string]: ResourceValue;
         };
     };
     addResourceBundle?: (language: string, namespace: string, resources: Record<string, string>, deep?: boolean, overwrite?: boolean) => void;
 }
-export declare function isI18nWrapperInstance(obj: any): boolean;
-export declare function getI18nWrapperI18nextInstance(wrapperInstance: any): any;
-export declare function getActualI18nextInstance(instance: I18nInstance | any): any;
+type I18nWrapperInstance = I18nInstance & {
+    i18nInstance: {
+        instance: I18nInstance;
+    };
+};
+export declare function isI18nWrapperInstance(obj: unknown): obj is I18nWrapperInstance;
+export declare function getActualI18nextInstance(instance: I18nInstance): I18nInstance;
 export interface I18nInstance {
     language: string;
     isInitialized?: boolean;
     init: {
-        (callback?: (error: any, t: any) => void): Promise<any>;
-        (options: I18nInitOptions, callback?: (error: any, t: any) => void): Promise<any>;
+        (callback?: (error: unknown, t: unknown) => void): Promise<unknown>;
+        (options: I18nInitOptions, callback?: (error: unknown, t: unknown) => void): Promise<unknown>;
     };
-    changeLanguage?: (lng?: string, callback?: (error: any, t: any) => void) => Promise<any>;
+    changeLanguage?: (lng?: string, callback?: (error: unknown, t: unknown) => void) => Promise<unknown>;
     setLang?: (lang: string) => void | Promise<void>;
-    use: (plugin: any) => void;
+    use: (plugin: unknown) => void;
     createInstance?: (options?: I18nInitOptions) => I18nInstance;
     cloneInstance?: () => I18nInstance;
     store?: I18nResourceStore;
-    emit?: (event: string, ...args: any[]) => void;
+    emit?: (event: string, ...args: unknown[]) => void;
     reloadResources?: (language?: string, namespace?: string) => Promise<void>;
     services?: {
         languageDetector?: {
-            detect: (request?: any, options?: any) => string | string[] | undefined;
-            [key: string]: any;
+            detect: (request?: unknown, options?: unknown) => string | string[] | undefined;
+            [key: string]: unknown;
         };
         resourceStore?: I18nResourceStore;
-        backend?: any;
-        [key: string]: any;
+        backend?: unknown;
+        [key: string]: unknown;
     };
     options?: {
         backend?: BackendOptions;
-        [key: string]: any;
+        [key: string]: unknown;
     };
-    [key: string]: any;
+    [key: string]: unknown;
 }
 type LanguageDetectorOrder = string[];
 type LanguageDetectorCaches = boolean | string[];
@@ -57,11 +59,11 @@ export interface LanguageDetectorOptions {
     lookupHeader?: string;
 }
 export interface BackendOptions extends Omit<BaseBackendOptions, 'enabled'> {
-    parse?: (data: string) => any;
-    stringify?: (data: any) => string;
+    parse?: (data: string) => unknown;
+    stringify?: (data: unknown) => string;
     [key: string]: any;
 }
-export type ResourceValue = string | {
+type ResourceValue = string | {
     [key: string]: ResourceValue;
 };
 export interface Resources {
@@ -81,14 +83,14 @@ export type I18nInitOptions = {
     defaultNS?: string | string[];
     interpolation?: {
         escapeValue?: boolean;
-        [key: string]: any;
+        [key: string]: unknown;
     };
     react?: {
         useSuspense?: boolean;
-        [key: string]: any;
+        [key: string]: unknown;
     };
 };
-export declare function isI18nInstance(obj: any): obj is I18nInstance;
-export declare function getI18nextInstanceForProvider(instance: I18nInstance | any): any;
-export declare function getI18nInstance(userInstance?: I18nInstance | any): Promise<I18nInstance>;
+export declare function isI18nInstance(obj: unknown): obj is I18nInstance;
+export declare function getI18nextInstanceForProvider(instance: I18nInstance): I18nInstance;
+export declare function getI18nInstance(userInstance?: unknown): Promise<I18nInstance>;
 export {};

package/dist/types/runtime/i18n/utils.d.ts

@@ -1,10 +1,18 @@
 import type { BaseBackendOptions } from '../../shared/type';
 import type { I18nInitOptions, I18nInstance } from './instance';
-export declare function assertI18nInstance(obj: any): asserts obj is I18nInstance;
+type MergedBackendOptions = NonNullable<I18nInitOptions['backend']> & {
+    _useChainedBackend?: boolean;
+    _chainedBackendConfig?: {
+        backendOptions: Array<Record<string, unknown>>;
+    };
+    backends?: unknown[];
+    backendOptions?: unknown;
+};
+export declare function assertI18nInstance(obj: unknown): asserts obj is I18nInstance;
 /**
  * Build initialization options for i18n instance
  */
-export declare const buildInitOptions: (finalLanguage: string, fallbackLanguage: string, languages: string[], mergedDetection: any, mergedBackend: any, userInitOptions?: I18nInitOptions, useSuspense?: boolean, i18nInstance?: I18nInstance) => Promise<I18nInitOptions>;
+export declare const buildInitOptions: (finalLanguage: string, fallbackLanguage: string, languages: string[], mergedDetection: I18nInitOptions['detection'], mergedBackend: MergedBackendOptions | undefined, userInitOptions?: I18nInitOptions, useSuspense?: boolean, i18nInstance?: I18nInstance) => Promise<I18nInitOptions>;
 /**
  * Ensure i18n instance language matches the final detected language
  */
@@ -17,13 +25,14 @@ export declare const ensureLanguageMatch: (i18nInstance: I18nInstance, finalLang
  * @param options - Optional configuration
  */
 export declare const changeI18nLanguage: (i18nInstance: I18nInstance, newLang: string, options?: {
-    detectionOptions?: any;
+    detectionOptions?: I18nInitOptions['detection'];
 }) => Promise<void>;
 /**
  * Initialize i18n instance if not already initialized
  */
-export declare const initializeI18nInstance: (i18nInstance: I18nInstance, finalLanguage: string, fallbackLanguage: string, languages: string[], mergedDetection: any, mergedBackend: any, userInitOptions?: I18nInitOptions, useSuspense?: boolean) => Promise<void>;
+export declare const initializeI18nInstance: (i18nInstance: I18nInstance, finalLanguage: string, fallbackLanguage: string, languages: string[], mergedDetection: I18nInitOptions['detection'], mergedBackend: MergedBackendOptions | undefined, userInitOptions?: I18nInitOptions, useSuspense?: boolean) => Promise<void>;
 /**
  * Setup cloned instance for SSR with backend support
  */
-export declare const setupClonedInstance: (i18nInstance: I18nInstance, finalLanguage: string, fallbackLanguage: string, languages: string[], backendEnabled: boolean, backend: BaseBackendOptions | undefined, i18nextDetector: boolean, detection: any, localePathRedirect: boolean, userInitOptions: I18nInitOptions | undefined) => Promise<void>;
+export declare const setupClonedInstance: (i18nInstance: I18nInstance, finalLanguage: string, fallbackLanguage: string, languages: string[], backendEnabled: boolean, backend: BaseBackendOptions | undefined, i18nextDetector: boolean, detection: I18nInitOptions['detection'], localePathRedirect: boolean, userInitOptions: I18nInitOptions | undefined) => Promise<void>;
+export {};

package/dist/types/runtime/pluginSetup.d.ts

@@ -14,7 +14,7 @@ export interface RuntimeContextWithI18n extends TInternalRuntimeContext {
     i18nInstance?: I18nInstance;
     changeLanguage?: (lang: string) => Promise<void>;
 }
-export interface SetupI18nBeforeRenderOptions {
+interface SetupI18nBeforeRenderOptions {
     api: I18nRuntimeApi;
     userI18nInstance?: I18nInstance;
     initOptions?: I18nInitOptions;

package/dist/types/runtime/providerComposition.d.ts

@@ -1,7 +1,7 @@
 import type React from 'react';
 import type { BaseLocaleDetectionOptions } from '../shared/type';
 import type { I18nInstance } from './i18n';
-export interface I18nRootWrapperOptions {
+interface I18nRootWrapperOptions {
     entryName?: string;
     htmlLangAttr: boolean;
     localePathRedirect: boolean;
@@ -13,3 +13,4 @@ export interface I18nRootWrapperOptions {
     getI18nextProvider: () => React.ComponentType<any> | null | undefined;
 }
 export declare const createI18nRootWrapper: (options: I18nRootWrapperOptions) => (App: React.ComponentType<any>) => (props: Record<string, unknown>) => React.JSX.Element;
+export {};

package/dist/types/runtime/routerAdapter.d.ts

@@ -1,21 +1,21 @@
 import type React from 'react';
-export type I18nRouterFramework = 'react-router' | 'tanstack' | string;
-export interface I18nRouterLocation {
+type I18nRouterFramework = 'react-router' | 'tanstack' | string;
+interface I18nRouterLocation {
     pathname: string;
     search: string;
     hash: string;
 }
-export interface I18nRouterNavigateOptions {
+interface I18nRouterNavigateOptions {
     replace?: boolean;
     state?: unknown;
 }
-export type I18nRouterNavigate = (href: string, options?: I18nRouterNavigateOptions) => void | Promise<void>;
-export type I18nRouterLink = React.ComponentType<{
+type I18nRouterNavigate = (href: string, options?: I18nRouterNavigateOptions) => void | Promise<void>;
+type I18nRouterLink = React.ComponentType<{
     to: string;
     children?: React.ReactNode;
     [key: string]: unknown;
 }>;
-export interface I18nRouterAdapter {
+interface I18nRouterAdapter {
     framework?: I18nRouterFramework;
     hasRouter: boolean;
     location: I18nRouterLocation | null;
@@ -24,3 +24,4 @@ export interface I18nRouterAdapter {
     params: Record<string, string>;
 }
 export declare const useI18nRouterAdapter: () => I18nRouterAdapter;
+export {};

package/dist/types/server/redirectPolicy.d.ts

@@ -1,16 +1,22 @@
 import type { LocaleDetectionOptions } from '../shared/type';
+interface LocaleRedirectRequest {
+    url: string;
+    header: () => {
+        host?: string;
+    };
+}
 /**
- * Check if the given pathname should ignore automatic locale redirect
+ * Check if pathname should ignore automatic locale redirect.
  */
 export declare const shouldIgnoreRedirect: (pathname: string, urlPath: string, ignoreRedirectRoutes?: string[] | ((pathname: string) => boolean)) => boolean;
 /**
- * Check if the given pathname is a static resource request
- * This includes:
- * 1. Paths matching staticRoutePrefixes (from public directories)
- * 2. Standard static resource paths like /static/, /upload/
- * 3. Paths with language prefix like /en/static/, /zh/static/
+ * Check if pathname is a static or federation resource request.
+ *
+ * This includes configured staticRoutePrefixes, the shared default skip policy
+ * from ADR-0002, and language-prefixed variants such as /en/static/app.js.
  */
 export declare const isStaticResourceRequest: (pathname: string, staticRoutePrefixes: string[], languages?: string[]) => boolean;
-export declare const getLanguageFromPath: (req: any, urlPath: string, languages: string[]) => string | null;
-export declare const buildLocalizedUrl: (req: any, urlPath: string, language: string, languages: string[], localisedUrls?: LocaleDetectionOptions['localisedUrls']) => string;
+export declare const getLanguageFromPath: (req: LocaleRedirectRequest, urlPath: string, languages: string[]) => string | null;
+export declare const buildLocalizedUrl: (req: LocaleRedirectRequest, urlPath: string, language: string, languages: string[], localisedUrls?: LocaleDetectionOptions['localisedUrls']) => string;
 export declare const createLocaleRedirectResponse: (location: string) => Response;
+export {};

package/dist/types/shared/detection.d.ts

@@ -1,11 +1 @@
-import type { LanguageDetectorOptions } from '../runtime/i18n/instance';
-/**
- * Detect language from request using the same detection logic as i18next
- * This ensures consistency between server-side and client-side detection
- */
-export declare function detectLanguageFromRequest(req: {
-    url: string;
-    headers: {
-        get: (name: string) => string | null;
-    } | Headers;
-}, languages: string[], detectionOptions?: LanguageDetectorOptions): string | null;
+export {};

package/dist/types/shared/localisedUrls/index.d.ts

@@ -1,7 +1,9 @@
 export { resolveLocalisedUrlsConfig } from './config';
 export { normalisePathname, normalisePathPattern } from './normalise';
-export { canonicalTargetPathname, localiseTargetPathname } from './pathname';
+export { canonicalTargetPathname, localiseTargetPathname, stripLanguagePrefix, } from './pathname';
 export { buildPathFromPattern, matchPathPattern } from './patterns';
+export type { LocaleRedirectSkipRule } from './redirect';
+export { DEFAULT_LOCALE_REDIRECT_SKIP_RULES, isDefaultLocaleRedirectSkipPath, matchesPathPrefix, shouldSkipLocaleRedirect, } from './redirect';
 export { resolveCanonicalLocalisedPath, resolveLocalisedPath } from './resolve';
 export { applyLocalisedUrlsToRoutes, validateLocalisedUrls } from './routes';
 export type { LocalisedRoute, LocalisedUrlPathMap, LocalisedUrlsMap, LocalisedUrlsOption, ResolvedLocalisedUrlsConfig, } from './types';

package/dist/types/shared/localisedUrls/pathname.d.ts

@@ -1,3 +1,4 @@
 import type { LocalisedUrlsOption } from './types';
+export declare const stripLanguagePrefix: (pathname: string, languages: string[]) => string;
 export declare const localiseTargetPathname: (pathname: string, language: string, languages: string[], localisedUrls?: LocalisedUrlsOption) => string;
 export declare const canonicalTargetPathname: (pathname: string, languages: string[], localisedUrls?: LocalisedUrlsOption) => string;

package/dist/types/shared/localisedUrls/redirect.d.ts

@@ -0,0 +1,11 @@
+export type LocaleRedirectSkipRule = {
+    type: 'exact';
+    path: string;
+} | {
+    type: 'prefix';
+    path: string;
+};
+export declare const DEFAULT_LOCALE_REDIRECT_SKIP_RULES: readonly LocaleRedirectSkipRule[];
+export declare const matchesPathPrefix: (pathname: string, prefix: string) => boolean;
+export declare const isDefaultLocaleRedirectSkipPath: (pathname: string, languages?: string[]) => boolean;
+export declare const shouldSkipLocaleRedirect: (pathname: string, languages?: string[], ignoreRedirectRoutes?: string[] | ((pathname: string) => boolean)) => boolean;

package/dist/types/shared/localisedUrls/resolve.d.ts

@@ -1,8 +1,7 @@
 import type { LocalisedUrlsMap } from './types';
 export declare const resolveLocalisedPath: (pathname: string, targetLanguage: string, languages: string[], localisedUrls: LocalisedUrlsMap) => string;
 /**
- * Reverse-map a language-specific pathname (without language prefix) back to
- * the canonical, language-agnostic path: localized slug patterns are matched
- * against every language variant and rebuilt from the canonical map key.
+ * Reverse-map language-specific pathnames back to language-agnostic
+ * LocalisedUrlsMap keys.
  */
 export declare const resolveCanonicalLocalisedPath: (pathname: string, languages: string[], localisedUrls: LocalisedUrlsMap) => string;

package/dist/types/shared/localisedUrls.d.ts

@@ -1,2 +1,2 @@
-export type { LocalisedRoute, LocalisedUrlPathMap, LocalisedUrlsMap, LocalisedUrlsOption, ResolvedLocalisedUrlsConfig, } from './localisedUrls/index';
-export { applyLocalisedUrlsToRoutes, buildPathFromPattern, canonicalTargetPathname, localiseTargetPathname, matchPathPattern, normalisePathname, normalisePathPattern, resolveCanonicalLocalisedPath, resolveLocalisedPath, resolveLocalisedUrlsConfig, validateLocalisedUrls, } from './localisedUrls/index';
+export type { LocaleRedirectSkipRule, LocalisedRoute, LocalisedUrlPathMap, LocalisedUrlsMap, LocalisedUrlsOption, ResolvedLocalisedUrlsConfig, } from './localisedUrls/index';
+export { applyLocalisedUrlsToRoutes, buildPathFromPattern, canonicalTargetPathname, DEFAULT_LOCALE_REDIRECT_SKIP_RULES, isDefaultLocaleRedirectSkipPath, localiseTargetPathname, matchesPathPrefix, matchPathPattern, normalisePathname, normalisePathPattern, resolveCanonicalLocalisedPath, resolveLocalisedPath, resolveLocalisedUrlsConfig, shouldSkipLocaleRedirect, stripLanguagePrefix, validateLocalisedUrls, } from './localisedUrls/index';

package/dist/types/shared/utils.d.ts

@@ -1,5 +1,3 @@
 import type { BaseBackendOptions, BaseLocaleDetectionOptions } from './type';
-export declare function getEntryConfig<T extends Record<string, any>>(entryName: string, config: T, entryKey: string): T | undefined;
-export declare function removeEntryConfigKey<T extends Record<string, any>>(config: T, entryKey: string): Omit<T, typeof entryKey>;
 export declare function getLocaleDetectionOptions(entryName: string, localeDetection: BaseLocaleDetectionOptions): BaseLocaleDetectionOptions;
 export declare function getBackendOptions(entryName: string, backend: BaseBackendOptions): BaseBackendOptions;

package/package.json

@@ -17,7 +17,7 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.5.0-ultramodern.36",
+  "version": "3.5.0-ultramodern.37",
   "engines": {
     "node": ">=20"
   },
@@ -97,19 +97,18 @@
     "i18next-fs-backend": "^2.6.6",
     "i18next-http-backend": "^4.0.0",
     "i18next-http-middleware": "^3.9.7",
-    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.5.0-ultramodern.36",
-    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.5.0-ultramodern.36",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.5.0-ultramodern.36",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.5.0-ultramodern.36",
-    "@modern-js/server-runtime": "npm:@bleedingdev/modern-js-server-runtime@3.5.0-ultramodern.36",
-    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.5.0-ultramodern.36"
+    "@modern-js/plugin": "npm:@bleedingdev/modern-js-plugin@3.5.0-ultramodern.37",
+    "@modern-js/server-runtime": "npm:@bleedingdev/modern-js-server-runtime@3.5.0-ultramodern.37",
+    "@modern-js/runtime-utils": "npm:@bleedingdev/modern-js-runtime-utils@3.5.0-ultramodern.37",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.5.0-ultramodern.37",
+    "@modern-js/server-core": "npm:@bleedingdev/modern-js-server-core@3.5.0-ultramodern.37"
   },
   "peerDependencies": {
-    "@modern-js/runtime": "3.5.0-ultramodern.36",
+    "@modern-js/runtime": "3.5.0-ultramodern.37",
     "i18next": ">=26.3.1",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
-    "react-i18next": "^17.0.8"
+    "react-i18next": "^17.0.9"
   },
   "peerDependenciesMeta": {
     "i18next": {
@@ -120,17 +119,16 @@
     }
   },
   "devDependencies": {
-    "@rslib/core": "0.23.1",
-    "@types/node": "^26.0.1",
-    "@typescript/native-preview": "7.0.0-dev.20260628.1",
-    "i18next": "26.3.3",
+    "@rslib/core": "0.23.2",
+    "@types/node": "^26.1.1",
+    "@typescript/native-preview": "7.0.0-dev.20260707.2",
+    "i18next": "26.3.6",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
-    "react-i18next": "17.0.8",
-    "ts-node": "^10.9.2",
-    "typescript": "^6.0.3",
-    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.5.0-ultramodern.36",
-    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.5.0-ultramodern.36"
+    "react-i18next": "17.0.9",
+    "typescript": "^7.0.2",
+    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.5.0-ultramodern.37",
+    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.5.0-ultramodern.37"
   },
   "sideEffects": false,
   "publishConfig": {

package/src/cli/index.ts

@@ -1,3 +1,5 @@
+import fs from 'node:fs';
+import path from 'node:path';
 import type { AppTools, CliPlugin } from '@modern-js/app-tools';
 import { getPublicDirRoutePrefixes } from '@modern-js/server-core';
 import type {
@@ -5,8 +7,6 @@ import type {
   NestedRouteForCli,
   PageRoute,
 } from '@modern-js/types';
-import fs from 'fs';
-import path from 'path';
 import {
   applyLocalisedUrlsToRoutes,
   resolveLocalisedUrlsConfig,

package/src/cli/locales.ts

@@ -1,10 +1,10 @@
+import fs from 'node:fs';
+import path from 'node:path';
 import {
   getPublicDirRoutePrefixes,
   normalizePublicDir,
   normalizePublicDirPath,
 } from '@modern-js/server-core';
-import fs from 'fs';
-import path from 'path';
 import type { BackendOptions } from '../shared/type';
 
 interface NormalizedConfigForLocales {
@@ -13,7 +13,7 @@ interface NormalizedConfigForLocales {
   };
 }
 
-export interface DetectedLocalesDirectory {
+interface DetectedLocalesDirectory {
   loadPath: string;
   addPath: string;
   serverLoadPath: string;

package/src/runtime/context.tsx

@@ -18,7 +18,7 @@ import {
 import type { I18nInstance } from './i18n';
 import { useI18nRouterAdapter } from './routerAdapter';
 
-export interface ModernI18nContextValue {
+interface ModernI18nContextValue {
   language: string;
   i18nInstance: I18nInstance;
   // Plugin configuration for useModernI18n hook
@@ -50,7 +50,7 @@ const getModernI18nContext = () => {
 
 const ModernI18nContext = getModernI18nContext();
 
-export interface ModernI18nProviderProps {
+interface ModernI18nProviderProps {
   children: ReactNode;
   value: ModernI18nContextValue;
 }
@@ -66,7 +66,7 @@ export const ModernI18nProvider: FC<ModernI18nProviderProps> = ({
   );
 };
 
-export interface UseModernI18nReturn {
+interface UseModernI18nReturn {
   language: string;
   changeLanguage: (newLang: string) => Promise<void>;
   t: (key: string | string[], ...args: any[]) => string;

package/src/runtime/contextHelpers.ts

@@ -50,7 +50,7 @@ export function cacheI18nLanguage(
   }
 }
 
-export interface ChangeModernI18nLanguageOptions {
+interface ChangeModernI18nLanguageOptions {
   i18nInstance: I18nInstance;
   updateLanguage?: (newLang: string) => void;
   localePathRedirect?: boolean;
@@ -172,7 +172,7 @@ export async function changeModernI18nLanguage(
 export function translateI18n(
   i18nInstance: I18nInstance,
   key: string | string[],
-  ...args: any[]
+  ...args: unknown[]
 ): string {
   if (typeof i18nInstance.t !== 'function') {
     throw new Error('i18nInstance.t required');
@@ -207,7 +207,7 @@ export function isI18nResourcesReady(
     }
   }
 
-  const store = (i18nInstance as any).store;
+  const store = i18nInstance.store;
   if (!store?.data) {
     return false;
   }

package/src/runtime/hooks.ts

@@ -26,6 +26,14 @@ interface RuntimeContextWithI18n extends TRuntimeContext {
   ssrContext?: { request?: { pathname?: string } };
 }
 
+type WindowWithSSRData = Window & {
+  _SSR_DATA?: unknown;
+};
+
+type ResourceStoreWithEvents = NonNullable<I18nInstance['store']> & {
+  emit?: (event: string, ...args: unknown[]) => void;
+};
+
 function createMinimalI18nInstance(language: string): I18nInstance {
   const minimalInstance: I18nInstance = {
     language,
@@ -97,7 +105,7 @@ export function useSdkResourcesLoader(
       }
 
       const triggerUpdate = (retryCount = 0) => {
-        const store = (i18nInstance as any).store;
+        const store = i18nInstance.store as ResourceStoreWithEvents | undefined;
         const hasResource = store?.data?.[language]?.[namespace];
 
         if (hasResource || retryCount >= 10) {
@@ -182,7 +190,7 @@ export function useClientSideRedirect(
     }
 
     try {
-      const ssrData = (window as any)._SSR_DATA;
+      const ssrData = (window as WindowWithSSRData)._SSR_DATA;
       if (ssrData) {
         return;
       }

package/src/runtime/i18n/backend/defaults.node.ts

@@ -1,5 +1,5 @@
-import fs from 'fs';
-import nodePath from 'path';
+import fs from 'node:fs';
+import nodePath from 'node:path';
 
 /**
  * Conventional locales roots, in the same priority order as the CLI plugin's

package/src/runtime/i18n/backend/middleware.common.ts

@@ -9,6 +9,7 @@ import { SdkBackend } from './sdk-backend';
 
 type BackendConfigWithChained = BaseBackendOptions &
   Partial<ChainedBackendConfig>;
+type BackendConstructor = new (...args: never[]) => unknown;
 
 function checkBackendConfig(backend?: BackendConfigWithChained) {
   const hasSdk = backend?.sdk && typeof backend.sdk === 'function';
@@ -20,7 +21,7 @@ function checkBackendConfig(backend?: BackendConfigWithChained) {
 
 function buildChainedBackendConfig(
   backend: BackendConfigWithChained,
-  BackendWithSave: new (...args: any[]) => any,
+  BackendWithSave: BackendConstructor,
 ) {
   const cacheHitMode = backend.cacheHitMode || 'refreshAndUpdateStore';
 
@@ -51,7 +52,7 @@ function buildChainedBackendConfig(
 function setupChainedBackend(
   i18nInstance: I18nInstance,
   backend: BackendConfigWithChained,
-  BackendWithSave: new (...args: any[]) => any,
+  BackendWithSave: BackendConstructor,
 ) {
   i18nInstance.use(ChainedBackend);
   const actualInstance = getActualI18nextInstance(i18nInstance);
@@ -86,8 +87,8 @@ function cleanBackendConfig(backend: BackendConfigWithChained) {
  */
 export function useI18nextBackendCommon(
   i18nInstance: I18nInstance,
-  BackendWithSave: new (...args: any[]) => any,
-  BackendBase: new (...args: any[]) => any,
+  BackendWithSave: BackendConstructor,
+  BackendBase: BackendConstructor,
   backend?: BackendConfigWithChained,
 ) {
   if (!backend) {

package/src/runtime/i18n/detection/cache.ts

@@ -10,6 +10,19 @@ interface DetectorCacheEntry {
   configKey: string;
 }
 
+type DetectorCleanupInstance = I18nInstance & {
+  removeAllListeners?: () => void;
+  off?: (event: string) => void;
+  services?: I18nInstance['services'] & {
+    backendConnector?: {
+      backend?: {
+        stop?: () => void;
+        close?: () => void;
+      };
+    };
+  };
+};
+
 export const detectorInstanceCache = new WeakMap<
   I18nInstance,
   DetectorCacheEntry
@@ -38,7 +51,7 @@ const DETECTOR_SAFE_OPTION_KEYS: string[] = [
  * Stable stringify that sorts object keys to ensure consistent output
  * regardless of property order
  */
-const stableStringify = (value: any): string => {
+const stableStringify = (value: unknown): string => {
   if (value === null || value === undefined) {
     return JSON.stringify(value);
   }
@@ -53,9 +66,10 @@ const stableStringify = (value: any): string => {
   }
 
   // For objects, sort keys and recursively stringify values
-  const sortedKeys = Object.keys(value).sort();
+  const record = value as Record<string, unknown>;
+  const sortedKeys = Object.keys(record).sort();
   const sortedEntries = sortedKeys.map(key => {
-    const stringifiedValue = stableStringify(value[key]);
+    const stringifiedValue = stableStringify(record[key]);
     return `${JSON.stringify(key)}:${stringifiedValue}`;
   });
 
@@ -76,19 +90,19 @@ export const buildDetectorConfigKey = (
 
 export const pickSafeDetectionOptions = (
   userInitOptions?: I18nInitOptions,
-): Partial<I18nInitOptions> & Record<string, any> => {
+): Partial<I18nInitOptions> & Record<string, unknown> => {
   if (!userInitOptions) {
     return {};
   }
-  const safeOptions: Partial<I18nInitOptions> & Record<string, any> = {};
+  const safeOptions: Partial<I18nInitOptions> & Record<string, unknown> = {};
   for (const key of DETECTOR_SAFE_OPTION_KEYS) {
-    const value = (userInitOptions as any)[key];
+    const value = (userInitOptions as Record<string, unknown>)[key];
     if (value !== undefined) {
       safeOptions[key] = value;
     }
   }
-  if ((userInitOptions as any).interpolation) {
-    safeOptions.interpolation = { ...(userInitOptions as any).interpolation };
+  if (userInitOptions.interpolation) {
+    safeOptions.interpolation = { ...userInitOptions.interpolation };
   }
   return safeOptions;
 };
@@ -97,7 +111,7 @@ const cleanupDetectorCacheEntry = (entry?: DetectorCacheEntry) => {
   if (!entry || !entry.isTemporary) {
     return;
   }
-  const instance = entry.instance as any;
+  const instance = entry.instance as DetectorCleanupInstance;
   try {
     instance?.removeAllListeners?.();
   } catch (error) {