@intlayer/i18next 8.12.5-canary.0

package/dist/esm/index.mjs

@@ -0,0 +1,41 @@
+import { getInterpolationValues, resolveTranslation } from "./resolveTranslation.mjs";
+import { createInstance } from "./createInstance.mjs";
+import { initReactI18next } from "react-i18next";
+
+//#region src/index.ts
+const i18next = createInstance();
+const dir = i18next.dir.bind(i18next);
+const init = i18next.init.bind(i18next);
+const loadResources = i18next.loadResources.bind(i18next);
+const reloadResources = i18next.reloadResources.bind(i18next);
+const use = i18next.use.bind(i18next);
+const changeLanguage = i18next.changeLanguage.bind(i18next);
+/**
+* Returns a `t()` function bound to a fixed locale and namespace.
+* When `ns` matches a registered intlayer dictionary key, the returned
+* function's `key` parameter is typed to only accept valid dot-notation
+* paths for that dictionary.
+*
+* @example
+* ```ts
+* const tAbout = getFixedT(null, 'about');
+* tAbout('counter.label'); // ✓ typed
+* ```
+*/
+const getFixedT = i18next.getFixedT.bind(i18next);
+const t = i18next.t.bind(i18next);
+const exists = i18next.exists.bind(i18next);
+const setDefaultNamespace = i18next.setDefaultNamespace.bind(i18next);
+const hasLoadedNamespace = i18next.hasLoadedNamespace.bind(i18next);
+const loadNamespaces = i18next.loadNamespaces.bind(i18next);
+const loadLanguages = i18next.loadLanguages.bind(i18next);
+/**
+* No-op shim for i18next's `keyFromSelector`. This helper is not exposed by
+* every supported i18next version, so a permissive identity function is
+* provided to keep `.keyFromSelector(...)` call-sites working.
+*/
+const keyFromSelector = (selector) => selector;
+
+//#endregion
+export { changeLanguage, createInstance, i18next as default, i18next, dir, exists, getFixedT, getInterpolationValues, hasLoadedNamespace, init, initReactI18next, keyFromSelector, loadLanguages, loadNamespaces, loadResources, reloadResources, resolveTranslation, setDefaultNamespace, t, use };
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/index.ts"],"sourcesContent":["import type {\n  changeLanguage as _changeLanguage,\n  dir as _dir,\n  exists as _exists,\n  hasLoadedNamespace as _hasLoadedNamespace,\n  init as _init,\n  loadLanguages as _loadLanguages,\n  loadNamespaces as _loadNamespaces,\n  loadResources as _loadResources,\n  reloadResources as _reloadResources,\n  setDefaultNamespace as _setDefaultNamespace,\n  t as _t,\n  use as _use,\n  i18n,\n} from 'i18next';\nimport { createInstance, type TypedGetFixedT } from './createInstance';\n\nexport {\n  getInterpolationValues,\n  type ResolveTranslationParams,\n  resolveTranslation,\n} from './resolveTranslation';\n\nconst i18next: i18n = createInstance();\n\nexport { createInstance };\nexport default i18next;\nexport { i18next };\n\nexport const dir: typeof _dir = i18next.dir.bind(i18next);\nexport const init: typeof _init = i18next.init.bind(i18next);\nexport const loadResources: typeof _loadResources =\n  i18next.loadResources.bind(i18next);\nexport const reloadResources: typeof _reloadResources =\n  i18next.reloadResources.bind(i18next);\nexport const use: typeof _use = i18next.use.bind(i18next);\nexport const changeLanguage: typeof _changeLanguage =\n  i18next.changeLanguage.bind(i18next);\n\n/**\n * Returns a `t()` function bound to a fixed locale and namespace.\n * When `ns` matches a registered intlayer dictionary key, the returned\n * function's `key` parameter is typed to only accept valid dot-notation\n * paths for that dictionary.\n *\n * @example\n * ```ts\n * const tAbout = getFixedT(null, 'about');\n * tAbout('counter.label'); // ✓ typed\n * ```\n */\nexport const getFixedT: TypedGetFixedT = i18next.getFixedT.bind(\n  i18next\n) as TypedGetFixedT;\n\nexport const t: typeof _t = i18next.t.bind(i18next);\nexport const exists: typeof _exists = i18next.exists.bind(i18next);\nexport const setDefaultNamespace: typeof _setDefaultNamespace =\n  i18next.setDefaultNamespace.bind(i18next);\nexport const hasLoadedNamespace: typeof _hasLoadedNamespace =\n  i18next.hasLoadedNamespace.bind(i18next);\nexport const loadNamespaces: typeof _loadNamespaces =\n  i18next.loadNamespaces.bind(i18next);\nexport const loadLanguages: typeof _loadLanguages =\n  i18next.loadLanguages.bind(i18next);\n\n/**\n * No-op shim for i18next's `keyFromSelector`. This helper is not exposed by\n * every supported i18next version, so a permissive identity function is\n * provided to keep `.keyFromSelector(...)` call-sites working.\n */\nexport const keyFromSelector = (selector: unknown): unknown => selector;\n\nexport type { InitOptions, i18n, TFunction, TOptions } from 'i18next';\nexport { initReactI18next } from 'react-i18next';\n"],"mappings":";;;;;AAuBA,MAAM,UAAgB,eAAe;AAMrC,MAAa,MAAmB,QAAQ,IAAI,KAAK,OAAO;AACxD,MAAa,OAAqB,QAAQ,KAAK,KAAK,OAAO;AAC3D,MAAa,gBACX,QAAQ,cAAc,KAAK,OAAO;AACpC,MAAa,kBACX,QAAQ,gBAAgB,KAAK,OAAO;AACtC,MAAa,MAAmB,QAAQ,IAAI,KAAK,OAAO;AACxD,MAAa,iBACX,QAAQ,eAAe,KAAK,OAAO;;;;;;;;;;;;;AAcrC,MAAa,YAA4B,QAAQ,UAAU,KACzD,OACF;AAEA,MAAa,IAAe,QAAQ,EAAE,KAAK,OAAO;AAClD,MAAa,SAAyB,QAAQ,OAAO,KAAK,OAAO;AACjE,MAAa,sBACX,QAAQ,oBAAoB,KAAK,OAAO;AAC1C,MAAa,qBACX,QAAQ,mBAAmB,KAAK,OAAO;AACzC,MAAa,iBACX,QAAQ,eAAe,KAAK,OAAO;AACrC,MAAa,gBACX,QAAQ,cAAc,KAAK,OAAO;;;;;;AAOpC,MAAa,mBAAmB,aAA+B"}

package/dist/esm/plugin/index.mjs

@@ -0,0 +1,70 @@
+import * as ANSIColors from "@intlayer/config/colors";
+import { colorize, getAppLogger } from "@intlayer/config/logger";
+import { join } from "node:path";
+import { runOnce } from "@intlayer/chokidar/utils";
+import { getConfiguration } from "@intlayer/config/node";
+import { intlayer } from "vite-intlayer";
+
+//#region src/plugin/index.ts
+/**
+* A Vite plugin for the i18next compat adapter that wraps `vite-intlayer`
+* and registers a resolve alias mapping `i18next` to `@intlayer/i18next`.
+*
+* This lets an existing i18next codebase migrate to intlayer without
+* rewriting any `import ... from 'i18next'` statements — they are
+* transparently redirected to the compat adapter at build time.
+*
+* @example
+* ```ts
+* // vite.config.ts
+* import i18nextVitePlugin from '@intlayer/i18next/plugin';
+*
+* export default defineConfig({
+*   plugins: [i18nextVitePlugin()],
+* });
+* ```
+*/
+/**
+* Caller configurations for i18next's `getFixedT` method.
+*
+* Tells the intlayer field-usage analyser how to extract the dictionary key
+* (namespace) and optional key prefix from `i18n.getFixedT(lng, ns, prefix)`
+* call sites, enabling accurate dictionary pruning for projects using
+* `@intlayer/i18next`.
+*/
+const I18NEXT_COMPAT_CALLERS = [{
+	callerName: "getFixedT",
+	importSources: ["i18next", "@intlayer/i18next"],
+	matchAsMethod: true,
+	namespace: {
+		from: "argument",
+		index: 1
+	},
+	keyPrefix: {
+		from: "argument",
+		index: 2
+	},
+	translationFunction: "return-value"
+}];
+const i18nextVitePlugin = (options) => {
+	const intlayerConfig = getConfiguration();
+	const appLogger = getAppLogger(intlayerConfig);
+	runOnce(join(intlayerConfig.system.baseDir, ".intlayer", "cache", "intlayer-issues-invitation.lock"), () => {
+		appLogger([colorize("Please report any issues you met on GitHub:", ANSIColors.GREY), colorize("https://github.com/aymericzip/intlayer/issues", ANSIColors.GREY_LIGHT)]);
+	}, { cacheTimeoutMs: 1e3 * 60 * 60 });
+	const basePlugins = intlayer({
+		...options,
+		compatCallers: [...options?.compatCallers ?? [], ...I18NEXT_COMPAT_CALLERS]
+	});
+	const compatPlugin = {
+		name: "vite-i18next-compat-plugin",
+		config: () => {
+			return { resolve: { alias: { i18next: "@intlayer/i18next" } } };
+		}
+	};
+	return [...Array.isArray(basePlugins) ? basePlugins : [basePlugins], compatPlugin];
+};
+
+//#endregion
+export { i18nextVitePlugin as default, i18nextVitePlugin };
+//# sourceMappingURL=index.mjs.map

package/dist/esm/plugin/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/plugin/index.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { runOnce } from '@intlayer/chokidar/utils';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport { getConfiguration } from '@intlayer/config/node';\nimport type { PluginOption } from 'vite';\nimport { type CompatCallerConfig, intlayer } from 'vite-intlayer';\n\n/**\n * A Vite plugin for the i18next compat adapter that wraps `vite-intlayer`\n * and registers a resolve alias mapping `i18next` to `@intlayer/i18next`.\n *\n * This lets an existing i18next codebase migrate to intlayer without\n * rewriting any `import ... from 'i18next'` statements — they are\n * transparently redirected to the compat adapter at build time.\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import i18nextVitePlugin from '@intlayer/i18next/plugin';\n *\n * export default defineConfig({\n *   plugins: [i18nextVitePlugin()],\n * });\n * ```\n */\n\n/**\n * Caller configurations for i18next's `getFixedT` method.\n *\n * Tells the intlayer field-usage analyser how to extract the dictionary key\n * (namespace) and optional key prefix from `i18n.getFixedT(lng, ns, prefix)`\n * call sites, enabling accurate dictionary pruning for projects using\n * `@intlayer/i18next`.\n */\nconst I18NEXT_COMPAT_CALLERS: CompatCallerConfig[] = [\n  {\n    callerName: 'getFixedT',\n    importSources: ['i18next', '@intlayer/i18next'],\n    matchAsMethod: true,\n    namespace: { from: 'argument', index: 1 },\n    keyPrefix: { from: 'argument', index: 2 },\n    translationFunction: 'return-value',\n  },\n];\n\nexport const i18nextVitePlugin = (\n  options?: Parameters<typeof intlayer>[0]\n): PluginOption[] => {\n  const intlayerConfig = getConfiguration();\n  const appLogger = getAppLogger(intlayerConfig);\n\n  runOnce(\n    join(\n      intlayerConfig.system.baseDir,\n      '.intlayer',\n      'cache',\n      'intlayer-issues-invitation.lock'\n    ),\n    () => {\n      appLogger([\n        colorize(\n          'Please report any issues you met on GitHub:',\n          ANSIColors.GREY\n        ),\n        colorize(\n          'https://github.com/aymericzip/intlayer/issues',\n          ANSIColors.GREY_LIGHT\n        ),\n      ]);\n    },\n    {\n      cacheTimeoutMs: 1000 * 60 * 60, // 1 hour\n    }\n  );\n\n  const basePlugins = intlayer({\n    ...options,\n    compatCallers: [\n      ...(options?.compatCallers ?? []),\n      ...I18NEXT_COMPAT_CALLERS,\n    ],\n  });\n\n  const compatPlugin: PluginOption = {\n    name: 'vite-i18next-compat-plugin',\n    config: () => {\n      return {\n        resolve: {\n          alias: {\n            i18next: '@intlayer/i18next',\n          },\n        },\n      };\n    },\n  };\n\n  return [\n    ...(Array.isArray(basePlugins) ? basePlugins : [basePlugins]),\n    compatPlugin,\n  ];\n};\n\nexport default i18nextVitePlugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,MAAM,yBAA+C,CACnD;CACE,YAAY;CACZ,eAAe,CAAC,WAAW,mBAAmB;CAC9C,eAAe;CACf,WAAW;EAAE,MAAM;EAAY,OAAO;CAAE;CACxC,WAAW;EAAE,MAAM;EAAY,OAAO;CAAE;CACxC,qBAAqB;AACvB,CACF;AAEA,MAAa,qBACX,YACmB;CACnB,MAAM,iBAAiB,iBAAiB;CACxC,MAAM,YAAY,aAAa,cAAc;CAE7C,QACE,KACE,eAAe,OAAO,SACtB,aACA,SACA,iCACF,SACM;EACJ,UAAU,CACR,SACE,+CACA,WAAW,IACb,GACA,SACE,iDACA,WAAW,UACb,CACF,CAAC;CACH,GACA,EACE,gBAAgB,MAAO,KAAK,GAC9B,CACF;CAEA,MAAM,cAAc,SAAS;EAC3B,GAAG;EACH,eAAe,CACb,GAAI,SAAS,iBAAiB,CAAC,GAC/B,GAAG,sBACL;CACF,CAAC;CAED,MAAM,eAA6B;EACjC,MAAM;EACN,cAAc;GACZ,OAAO,EACL,SAAS,EACP,OAAO,EACL,SAAS,oBACX,EACF,EACF;EACF;CACF;CAEA,OAAO,CACL,GAAI,MAAM,QAAQ,WAAW,IAAI,cAAc,CAAC,WAAW,GAC3D,YACF;AACF"}

package/dist/esm/resolveTranslation.mjs

@@ -0,0 +1,140 @@
+import { getIntlayer } from "@intlayer/core/interpreter";
+import { resolveMessage } from "@intlayer/core/messageFormat";
+
+//#region src/resolveTranslation.ts
+/**
+* Shared i18next-dialect translation resolution.
+*
+* Implements the i18next lookup pipeline on top of intlayer dictionaries:
+* namespace prefix (`ns:key`), `ns` option override, plural suffixes
+* (`key_one`, `key_other`, …) via `Intl.PluralRules`, context suffixes
+* (`key_male`), `$t()` nesting, `defaultValue` and `{{var}}` interpolation.
+*
+* Used by `@intlayer/i18next` (instance `t`) and `@intlayer/react-i18next`
+* (`useTranslation`, `<Trans>`).
+*/
+/** Option keys that are control flags, never interpolation values. */
+const CONTROL_OPTION_KEYS = new Set([
+	"defaultValue",
+	"ns",
+	"lng",
+	"lngs",
+	"fallbackLng",
+	"returnObjects",
+	"returnDetails",
+	"keySeparator",
+	"nsSeparator",
+	"ordinal",
+	"postProcess",
+	"postProcessPassResolved",
+	"interpolation",
+	"replace",
+	"joinArrays",
+	"nsMode",
+	"keyPrefix"
+]);
+/** Maximum `$t()` nesting recursion depth. */
+const MAX_NESTING_DEPTH = 5;
+const navigatePath = (objectValue, path, keySeparator = ".") => {
+	if (!path) return objectValue;
+	const parts = keySeparator === false ? [path] : path.split(keySeparator);
+	let current = objectValue;
+	for (const part of parts) {
+		if (current === null || current === void 0 || typeof current !== "object") return;
+		current = current[part];
+	}
+	return current;
+};
+/**
+* Builds the ordered list of key candidates following i18next's resolution
+* order: context + plural → context → plural → exact key.
+*/
+const buildKeyCandidates = (path, locale, count, context, ordinal) => {
+	const candidates = [];
+	const pluralCategory = count === void 0 ? void 0 : new Intl.PluralRules(locale, { type: ordinal ? "ordinal" : "cardinal" }).select(count);
+	if (context) {
+		if (pluralCategory) {
+			if (ordinal) candidates.push(`${path}_${context}_ordinal_${pluralCategory}`);
+			candidates.push(`${path}_${context}_${pluralCategory}`);
+			if (count !== 1) candidates.push(`${path}_${context}_plural`);
+		}
+		candidates.push(`${path}_${context}`);
+	}
+	if (pluralCategory) {
+		if (ordinal) candidates.push(`${path}_ordinal_${pluralCategory}`);
+		candidates.push(`${path}_${pluralCategory}`);
+		if (count !== 1) candidates.push(`${path}_plural`);
+	}
+	candidates.push(path);
+	return candidates;
+};
+/** Extracts interpolation values from i18next `t()` options. */
+const getInterpolationValues = (options) => {
+	if (!options || typeof options !== "object") return {};
+	const replace = options.replace;
+	if (replace) {
+		const values = { ...replace };
+		if (options.count !== void 0) values.count ??= options.count;
+		if (options.context !== void 0) values.context ??= options.context;
+		return values;
+	}
+	const values = {};
+	for (const [optionKey, optionValue] of Object.entries(options)) if (!CONTROL_OPTION_KEYS.has(optionKey)) values[optionKey] = optionValue;
+	return values;
+};
+/**
+* Resolves a single translation key the i18next way against intlayer
+* dictionaries.
+*
+* Returns the resolved value: a string in the common case, or an
+* object/array when `returnObjects: true`. Returns `undefined` when the key
+* cannot be resolved (caller decides between `defaultValue`, fallback keys
+* and key echo).
+*/
+const resolveTranslation = ({ locale, namespace, key, options, keySeparator = ".", nsSeparator = ":", depth = 0 }) => {
+	let targetNamespace = namespace;
+	let path = key;
+	if (nsSeparator !== false && key.includes(nsSeparator)) {
+		const separatorIndex = key.indexOf(nsSeparator);
+		targetNamespace = key.slice(0, separatorIndex);
+		path = key.slice(separatorIndex + nsSeparator.length);
+	} else if (options?.ns) targetNamespace = Array.isArray(options.ns) ? options.ns[0] : options.ns;
+	const count = typeof options?.count === "number" ? options.count : void 0;
+	const context = options?.context !== void 0 ? String(options.context) : void 0;
+	const ordinal = options?.ordinal === true;
+	let dictionary;
+	try {
+		dictionary = getIntlayer(targetNamespace, options?.lng ?? locale);
+	} catch {
+		return;
+	}
+	let resolvedValue;
+	for (const candidate of buildKeyCandidates(path, options?.lng ?? locale, count, context, ordinal)) {
+		const value = navigatePath(dictionary, candidate, keySeparator);
+		if (value !== null && value !== void 0) {
+			resolvedValue = value;
+			break;
+		}
+	}
+	if (resolvedValue === null || resolvedValue === void 0) return void 0;
+	if (options?.returnObjects && typeof resolvedValue === "object" && resolvedValue !== null) return resolvedValue;
+	const values = getInterpolationValues(options);
+	let resolved = resolveMessage(resolvedValue, values, options?.lng ?? locale, "i18next");
+	if (depth < MAX_NESTING_DEPTH && resolved.includes("$t(")) resolved = resolved.replace(/\$t\(\s*([^),]+?)\s*(?:,[^)]*)?\)/g, (match, nestedKey) => {
+		const nestedValue = resolveTranslation({
+			locale,
+			namespace: targetNamespace,
+			key: nestedKey.trim(),
+			options,
+			keySeparator,
+			nsSeparator,
+			depth: depth + 1
+		});
+		return typeof nestedValue === "string" ? nestedValue : match;
+	});
+	return resolved;
+};
+
+//#endregion
+export { getInterpolationValues, resolveTranslation };
+//# sourceMappingURL=resolveTranslation.mjs.map

package/dist/esm/resolveTranslation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveTranslation.mjs","names":[],"sources":["../../src/resolveTranslation.ts"],"sourcesContent":["import { getIntlayer } from '@intlayer/core/interpreter';\nimport {\n  type MessageValues,\n  resolveMessage,\n} from '@intlayer/core/messageFormat';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type { TOptions } from 'i18next';\n\n/**\n * Shared i18next-dialect translation resolution.\n *\n * Implements the i18next lookup pipeline on top of intlayer dictionaries:\n * namespace prefix (`ns:key`), `ns` option override, plural suffixes\n * (`key_one`, `key_other`, …) via `Intl.PluralRules`, context suffixes\n * (`key_male`), `$t()` nesting, `defaultValue` and `{{var}}` interpolation.\n *\n * Used by `@intlayer/i18next` (instance `t`) and `@intlayer/react-i18next`\n * (`useTranslation`, `<Trans>`).\n */\n\n/** Option keys that are control flags, never interpolation values. */\nconst CONTROL_OPTION_KEYS = new Set([\n  'defaultValue',\n  'ns',\n  'lng',\n  'lngs',\n  'fallbackLng',\n  'returnObjects',\n  'returnDetails',\n  'keySeparator',\n  'nsSeparator',\n  'ordinal',\n  'postProcess',\n  'postProcessPassResolved',\n  'interpolation',\n  'replace',\n  'joinArrays',\n  'nsMode',\n  'keyPrefix',\n]);\n\n/** Maximum `$t()` nesting recursion depth. */\nconst MAX_NESTING_DEPTH = 5;\n\nconst navigatePath = (\n  objectValue: unknown,\n  path: string,\n  keySeparator: string | false = '.'\n): unknown => {\n  if (!path) return objectValue;\n\n  const parts = keySeparator === false ? [path] : path.split(keySeparator);\n\n  let current: unknown = objectValue;\n  for (const part of parts) {\n    if (\n      current === null ||\n      current === undefined ||\n      typeof current !== 'object'\n    ) {\n      return undefined;\n    }\n    current = (current as Record<string, unknown>)[part];\n  }\n  return current;\n};\n\n/**\n * Builds the ordered list of key candidates following i18next's resolution\n * order: context + plural → context → plural → exact key.\n */\nconst buildKeyCandidates = (\n  path: string,\n  locale: string,\n  count: number | undefined,\n  context: string | undefined,\n  ordinal: boolean\n): string[] => {\n  const candidates: string[] = [];\n\n  const pluralCategory =\n    count === undefined\n      ? undefined\n      : new Intl.PluralRules(locale, {\n          type: ordinal ? 'ordinal' : 'cardinal',\n        }).select(count);\n\n  if (context) {\n    if (pluralCategory) {\n      if (ordinal) {\n        candidates.push(`${path}_${context}_ordinal_${pluralCategory}`);\n      }\n      candidates.push(`${path}_${context}_${pluralCategory}`);\n      if (count !== 1) candidates.push(`${path}_${context}_plural`);\n    }\n    candidates.push(`${path}_${context}`);\n  }\n\n  if (pluralCategory) {\n    if (ordinal) candidates.push(`${path}_ordinal_${pluralCategory}`);\n    candidates.push(`${path}_${pluralCategory}`);\n    // Legacy i18next v3 JSON suffix\n    if (count !== 1) candidates.push(`${path}_plural`);\n  }\n\n  candidates.push(path);\n\n  return candidates;\n};\n\n/** Extracts interpolation values from i18next `t()` options. */\nexport const getInterpolationValues = (options?: TOptions): MessageValues => {\n  if (!options || typeof options !== 'object') return {};\n\n  const replace = (options as { replace?: MessageValues }).replace;\n  if (replace) {\n    // `count` and `context` are always interpolatable, even with `replace`\n    const values: MessageValues = { ...replace };\n    if (options.count !== undefined) values.count ??= options.count;\n    if (options.context !== undefined) values.context ??= options.context;\n    return values;\n  }\n\n  const values: MessageValues = {};\n  for (const [optionKey, optionValue] of Object.entries(options)) {\n    if (!CONTROL_OPTION_KEYS.has(optionKey)) values[optionKey] = optionValue;\n  }\n  return values;\n};\n\nexport type ResolveTranslationParams = {\n  /** Locale to resolve against. */\n  locale: LocalesValues;\n  /** Default namespace (dictionary key) when the key has no `ns:` prefix. */\n  namespace: string;\n  /** The translation key, possibly `ns:path.to.key`. */\n  key: string;\n  /** i18next `t()` options (interpolation values, count, context, …). */\n  options?: TOptions;\n  /** Custom key separator (`init({ keySeparator })`). */\n  keySeparator?: string | false;\n  /** Custom namespace separator (`init({ nsSeparator })`). */\n  nsSeparator?: string | false;\n  /** Internal `$t()` nesting recursion depth. */\n  depth?: number;\n};\n\n/**\n * Resolves a single translation key the i18next way against intlayer\n * dictionaries.\n *\n * Returns the resolved value: a string in the common case, or an\n * object/array when `returnObjects: true`. Returns `undefined` when the key\n * cannot be resolved (caller decides between `defaultValue`, fallback keys\n * and key echo).\n */\nexport const resolveTranslation = ({\n  locale,\n  namespace,\n  key,\n  options,\n  keySeparator = '.',\n  nsSeparator = ':',\n  depth = 0,\n}: ResolveTranslationParams): unknown => {\n  // Namespace resolution: `ns:` prefix > `ns` option > default namespace\n  let targetNamespace = namespace;\n  let path = key;\n\n  if (nsSeparator !== false && key.includes(nsSeparator)) {\n    const separatorIndex = key.indexOf(nsSeparator);\n    targetNamespace = key.slice(0, separatorIndex);\n    path = key.slice(separatorIndex + nsSeparator.length);\n  } else if (options?.ns) {\n    targetNamespace = Array.isArray(options.ns)\n      ? (options.ns[0] as string)\n      : (options.ns as string);\n  }\n\n  const count = typeof options?.count === 'number' ? options.count : undefined;\n  const context =\n    options?.context !== undefined ? String(options.context) : undefined;\n  const ordinal = options?.ordinal === true;\n\n  let dictionary: unknown;\n  try {\n    dictionary = getIntlayer(\n      targetNamespace as DictionaryKeys,\n      ((options?.lng as string) ?? locale) as LocalesValues\n    );\n  } catch {\n    return undefined;\n  }\n\n  let resolvedValue: unknown;\n  for (const candidate of buildKeyCandidates(\n    path,\n    (options?.lng as string) ?? (locale as string),\n    count,\n    context,\n    ordinal\n  )) {\n    const value = navigatePath(dictionary, candidate, keySeparator);\n    if (value !== null && value !== undefined) {\n      resolvedValue = value;\n      break;\n    }\n  }\n\n  if (resolvedValue === null || resolvedValue === undefined) return undefined;\n\n  // `returnObjects: true` — return the raw subtree\n  if (\n    options?.returnObjects &&\n    typeof resolvedValue === 'object' &&\n    resolvedValue !== null\n  ) {\n    return resolvedValue;\n  }\n\n  const values = getInterpolationValues(options);\n\n  let resolved = resolveMessage(\n    resolvedValue,\n    values,\n    ((options?.lng as string) ?? locale) as LocalesValues,\n    'i18next'\n  );\n\n  // `$t(key)` nesting\n  if (depth < MAX_NESTING_DEPTH && resolved.includes('$t(')) {\n    resolved = resolved.replace(\n      /\\$t\\(\\s*([^),]+?)\\s*(?:,[^)]*)?\\)/g,\n      (match, nestedKey: string) => {\n        const nestedValue = resolveTranslation({\n          locale,\n          namespace: targetNamespace,\n          key: nestedKey.trim(),\n          options,\n          keySeparator,\n          nsSeparator,\n          depth: depth + 1,\n        });\n        return typeof nestedValue === 'string' ? nestedValue : match;\n      }\n    );\n  }\n\n  return resolved;\n};\n"],"mappings":"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"}

package/dist/types/createInstance.d.ts

@@ -0,0 +1,11 @@
+import { ValidDotPathsFor } from "@intlayer/core/transpiler";
+import { DictionaryKeys } from "@intlayer/types/module_augmentation";
+import { TOptions, createInstance as createInstance$1 } from "i18next";
+
+//#region src/createInstance.d.ts
+declare const createInstance: typeof createInstance$1;
+/** Typed variant of i18next's `getFixedT`, scoped to an intlayer dictionary namespace. */
+type TypedGetFixedT = <N extends DictionaryKeys>(lng: string | readonly string[] | null, ns?: N | null, keyPrefix?: string) => <P extends ValidDotPathsFor<N>>(key: P, opts?: TOptions) => string;
+//#endregion
+export { TypedGetFixedT, createInstance };
+//# sourceMappingURL=createInstance.d.ts.map

package/dist/types/createInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createInstance.d.ts","names":[],"sources":["../../src/createInstance.ts"],"mappings":";;;;;cA8Ca,cAAA,SAAuB,gBAyTnC;;KAGW,cAAA,cAA4B,cAAA,EACtC,GAAA,qCACA,EAAA,GAAK,CAAA,SACL,SAAA,yBACc,gBAAA,CAAiB,CAAA,GAAI,GAAA,EAAK,CAAA,EAAG,IAAA,GAAO,QAAA"}

package/dist/types/index.d.ts

@@ -0,0 +1,41 @@
+import { TypedGetFixedT, createInstance } from "./createInstance.js";
+import { ResolveTranslationParams, getInterpolationValues, resolveTranslation } from "./resolveTranslation.js";
+import { InitOptions, TFunction, TOptions, changeLanguage as changeLanguage$1, dir as dir$1, exists as exists$1, hasLoadedNamespace as hasLoadedNamespace$1, i18n, i18n as i18n$1, init as init$1, loadLanguages as loadLanguages$1, loadNamespaces as loadNamespaces$1, loadResources as loadResources$1, reloadResources as reloadResources$1, setDefaultNamespace as setDefaultNamespace$1, t as t$1, use as use$1 } from "i18next";
+import { initReactI18next } from "react-i18next";
+
+//#region src/index.d.ts
+declare const i18next: i18n$1;
+declare const dir: typeof dir$1;
+declare const init: typeof init$1;
+declare const loadResources: typeof loadResources$1;
+declare const reloadResources: typeof reloadResources$1;
+declare const use: typeof use$1;
+declare const changeLanguage: typeof changeLanguage$1;
+/**
+ * Returns a `t()` function bound to a fixed locale and namespace.
+ * When `ns` matches a registered intlayer dictionary key, the returned
+ * function's `key` parameter is typed to only accept valid dot-notation
+ * paths for that dictionary.
+ *
+ * @example
+ * ```ts
+ * const tAbout = getFixedT(null, 'about');
+ * tAbout('counter.label'); // ✓ typed
+ * ```
+ */
+declare const getFixedT: TypedGetFixedT;
+declare const t: typeof t$1;
+declare const exists: typeof exists$1;
+declare const setDefaultNamespace: typeof setDefaultNamespace$1;
+declare const hasLoadedNamespace: typeof hasLoadedNamespace$1;
+declare const loadNamespaces: typeof loadNamespaces$1;
+declare const loadLanguages: typeof loadLanguages$1;
+/**
+ * No-op shim for i18next's `keyFromSelector`. This helper is not exposed by
+ * every supported i18next version, so a permissive identity function is
+ * provided to keep `.keyFromSelector(...)` call-sites working.
+ */
+declare const keyFromSelector: (selector: unknown) => unknown;
+//#endregion
+export { type InitOptions, type ResolveTranslationParams, type TFunction, type TOptions, changeLanguage, createInstance, i18next as default, i18next, dir, exists, getFixedT, getInterpolationValues, hasLoadedNamespace, type i18n, init, initReactI18next, keyFromSelector, loadLanguages, loadNamespaces, loadResources, reloadResources, resolveTranslation, setDefaultNamespace, t, use };
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/index.ts"],"mappings":";;;;;;cAuBM,OAAA,EAAS,MAAuB;AAAA,cAMzB,GAAA,SAAY,KAAgC;AAAA,cAC5C,IAAA,SAAa,MAAkC;AAAA,cAC/C,aAAA,SAAsB,eACE;AAAA,cACxB,eAAA,SAAwB,iBACE;AAAA,cAC1B,GAAA,SAAY,KAAgC;AAAA,cAC5C,cAAA,SAAuB,gBACE;;;AARmB;AACzD;;;;AAA4D;AAC5D;;;;cAoBa,SAAA,EAAW,cAEL;AAAA,cAEN,CAAA,SAAU,GAA4B;AAAA,cACtC,MAAA,SAAe,QAAsC;AAAA,cACrD,mBAAA,SAA4B,qBACE;AAAA,cAC9B,kBAAA,SAA2B,oBACE;AAAA,cAC7B,cAAA,SAAuB,gBACE;AAAA,cACzB,aAAA,SAAsB,eACE;;;;AA7BoB;AACzD;cAmCa,eAAA,GAAmB,QAAiB"}

package/dist/types/plugin/index.d.ts

@@ -0,0 +1,8 @@
+import { PluginOption } from "vite";
+import { intlayer } from "vite-intlayer";
+
+//#region src/plugin/index.d.ts
+declare const i18nextVitePlugin: (options?: Parameters<typeof intlayer>[0]) => PluginOption[];
+//#endregion
+export { i18nextVitePlugin as default, i18nextVitePlugin };
+//# sourceMappingURL=index.d.ts.map

package/dist/types/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/plugin/index.ts"],"mappings":";;;;cA8Ca,iBAAA,GACX,OAAA,GAAU,UAAA,QAAkB,QAAA,SAC3B,YAAA"}

package/dist/types/resolveTranslation.d.ts

@@ -0,0 +1,37 @@
+import { LocalesValues } from "@intlayer/types/module_augmentation";
+import { TOptions } from "i18next";
+import { MessageValues } from "@intlayer/core/messageFormat";
+
+//#region src/resolveTranslation.d.ts
+/** Extracts interpolation values from i18next `t()` options. */
+declare const getInterpolationValues: (options?: TOptions) => MessageValues;
+type ResolveTranslationParams = {
+  /** Locale to resolve against. */locale: LocalesValues; /** Default namespace (dictionary key) when the key has no `ns:` prefix. */
+  namespace: string; /** The translation key, possibly `ns:path.to.key`. */
+  key: string; /** i18next `t()` options (interpolation values, count, context, …). */
+  options?: TOptions; /** Custom key separator (`init({ keySeparator })`). */
+  keySeparator?: string | false; /** Custom namespace separator (`init({ nsSeparator })`). */
+  nsSeparator?: string | false; /** Internal `$t()` nesting recursion depth. */
+  depth?: number;
+};
+/**
+ * Resolves a single translation key the i18next way against intlayer
+ * dictionaries.
+ *
+ * Returns the resolved value: a string in the common case, or an
+ * object/array when `returnObjects: true`. Returns `undefined` when the key
+ * cannot be resolved (caller decides between `defaultValue`, fallback keys
+ * and key echo).
+ */
+declare const resolveTranslation: ({
+  locale,
+  namespace,
+  key,
+  options,
+  keySeparator,
+  nsSeparator,
+  depth
+}: ResolveTranslationParams) => unknown;
+//#endregion
+export { ResolveTranslationParams, getInterpolationValues, resolveTranslation };
+//# sourceMappingURL=resolveTranslation.d.ts.map

package/dist/types/resolveTranslation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveTranslation.d.ts","names":[],"sources":["../../src/resolveTranslation.ts"],"mappings":";;;;;;cAkHa,sBAAA,GAA0B,OAAA,GAAU,QAAA,KAAW,aAiB3D;AAAA,KAEW,wBAAA;EAFX,iCAIC,MAAA,EAAQ,aAAA,EAJT;EAMC,SAAA,UAvBqC;EAyBrC,GAAA,UARD;EAUC,OAAA,GAAU,QAAQ,EARR;EAUV,YAAA;EAEA,WAAA,mBAVA;EAYA,KAAA;AAAA;;;;;;;;AAAK;AAYP;cAAa,kBAAA;EAAsB,MAAA;EAAA,SAAA;EAAA,GAAA;EAAA,OAAA;EAAA,YAAA;EAAA,WAAA;EAAA;AAAA,GAQhC,wBAAA"}

package/package.json

@@ -0,0 +1,111 @@
+{
+  "name": "@intlayer/i18next",
+  "version": "8.12.5-canary.0",
+  "private": false,
+  "description": "i18next API adapter for intlayer — drop-in compatibility layer that exposes the i18next interface while using @intlayer/core under the hood",
+  "keywords": [
+    "intlayer",
+    "i18next",
+    "i18n",
+    "adapter",
+    "compatibility"
+  ],
+  "homepage": "https://intlayer.org",
+  "bugs": {
+    "url": "https://github.com/aymericzip/intlayer/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aymericzip/intlayer.git"
+  },
+  "license": "Apache-2.0",
+  "author": {
+    "name": "Aymeric PINEAU",
+    "url": "https://github.com/aymericzip"
+  },
+  "contributors": [
+    {
+      "name": "Aymeric Pineau",
+      "email": "ay.pineau@gmail.com",
+      "url": "https://github.com/aymericzip"
+    }
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "require": "./dist/cjs/index.cjs",
+      "import": "./dist/esm/index.mjs"
+    },
+    "./plugin": {
+      "types": "./dist/types/plugin/index.d.ts",
+      "require": "./dist/cjs/plugin/index.cjs",
+      "import": "./dist/esm/plugin/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/cjs/index.cjs",
+  "module": "dist/esm/index.mjs",
+  "types": "dist/types/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "plugin": [
+        "./dist/types/plugin/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "./dist",
+    "./package.json"
+  ],
+  "scripts": {
+    "build": "bun --bun tsdown --config tsdown.config.ts",
+    "build:ci": "bun --bun tsdown --config tsdown.config.ts",
+    "clean": "bun --bun rimraf ./dist .turbo",
+    "dev": "bun --bun tsdown --config tsdown.config.ts --watch",
+    "format": "bun --bun biome format . --check",
+    "format:fix": "bun --bun biome format --write .",
+    "lint": "bun --bun biome lint .",
+    "lint:fix": "bun --bun biome lint --write .",
+    "prepublish": "cp -f ../../README.md ./README.md",
+    "publish": "bun publish || true",
+    "publish:canary": "bun publish --access public --tag canary || true",
+    "publish:latest": "bun publish --access public --tag latest || true",
+    "test": "bun --bun vitest run",
+    "test:watch": "bun --bun vitest",
+    "typecheck": "tsc --noEmit --project tsconfig.types.json"
+  },
+  "dependencies": {
+    "@intlayer/chokidar": "9.0.0-canary.1",
+    "@intlayer/config": "9.0.0-canary.1",
+    "@intlayer/core": "9.0.0-canary.1",
+    "@intlayer/dictionaries-entry": "9.0.0-canary.1",
+    "@intlayer/types": "9.0.0-canary.1",
+    "vite-intlayer": "9.0.0-canary.1"
+  },
+  "devDependencies": {
+    "@types/node": "25.9.3",
+    "@utils/ts-config": "1.0.4",
+    "@utils/ts-config-types": "1.0.4",
+    "@utils/tsdown-config": "1.0.4",
+    "i18next": "26.3.1",
+    "rimraf": "6.1.3",
+    "tsdown": "0.22.2",
+    "typescript": "6.0.3",
+    "vite": "8.0.16",
+    "vitest": "4.1.9"
+  },
+  "peerDependencies": {
+    "i18next": ">=20.0.0",
+    "react-i18next": ">=11.0.0",
+    "vite": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=14.18"
+  }
+}