@intlayer/react-i18next 8.12.5-canary.0

package/dist/esm/helpers.mjs

@@ -0,0 +1,54 @@
+import { useTranslation } from "./useTranslation.mjs";
+import * as React from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/helpers.tsx
+const I18nContext = React.createContext({ i18n: null });
+const Translation = ({ children, ns, keyPrefix }) => {
+	const { t, i18n } = useTranslation(ns, { keyPrefix });
+	return children(t, {
+		i18n,
+		lng: i18n.language
+	}, true);
+};
+const nodesToString = (children, _i18nOptions, _i18n, _i18nKey) => {
+	if (typeof children === "string" || typeof children === "number") return String(children);
+	if (!children) return "";
+	if (Array.isArray(children)) return children.map((c) => nodesToString(c)).join("");
+	const childElement = children;
+	if (childElement.props?.children) return nodesToString(childElement.props.children);
+	return "";
+};
+let globalI18n = null;
+let globalDefaults = {};
+const setI18n = (instance) => {
+	globalI18n = instance;
+};
+const getI18n = () => {
+	return globalI18n;
+};
+const setDefaults = (options) => {
+	globalDefaults = options;
+};
+const getDefaults = () => {
+	return globalDefaults;
+};
+const useSSR = (_initialI18nStore, _initialLanguage) => {};
+const withSSR = () => {
+	const Hoc = (WrappedComponent) => {
+		const Component = (props) => /* @__PURE__ */ jsx(WrappedComponent, { ...props });
+		const ExtendedComponent = Component;
+		ExtendedComponent.getInitialProps = async (_ctx) => ({});
+		return ExtendedComponent;
+	};
+	return Hoc;
+};
+const composeInitialProps = (_ForComponent) => async (_ctx) => ({});
+const getInitialProps = () => ({
+	initialI18nStore: {},
+	initialLanguage: "en"
+});
+
+//#endregion
+export { I18nContext, Translation, composeInitialProps, getDefaults, getI18n, getInitialProps, nodesToString, setDefaults, setI18n, useSSR, withSSR };
+//# sourceMappingURL=helpers.mjs.map

package/dist/esm/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../../src/helpers.tsx"],"sourcesContent":["import type { i18n, TFunction } from 'i18next';\nimport * as React from 'react';\nimport { useTranslation } from './useTranslation';\n\n// Context\nexport const I18nContext = React.createContext<{ i18n: i18n }>({\n  i18n: null as unknown as i18n,\n});\n\nexport interface TranslationProps {\n  children: (\n    t: TFunction,\n    options: { i18n: i18n; lng: string },\n    ready: boolean\n  ) => React.ReactNode;\n  ns?: string | string[];\n  keyPrefix?: string;\n}\n\n// Translation Render-Prop Component\nexport const Translation = ({\n  children,\n  ns,\n  keyPrefix,\n}: TranslationProps): React.ReactElement => {\n  const { t, i18n } = useTranslation(ns, { keyPrefix });\n  return children(\n    t as unknown as TFunction,\n    { i18n: i18n as unknown as i18n, lng: i18n.language },\n    true\n  ) as React.ReactElement;\n};\n\n// nodesToString implementation\nexport const nodesToString = (\n  children: React.ReactNode,\n  _i18nOptions?: unknown,\n  _i18n?: unknown,\n  _i18nKey?: string\n): string => {\n  if (typeof children === 'string' || typeof children === 'number') {\n    return String(children);\n  }\n  if (!children) return '';\n  if (Array.isArray(children)) {\n    return children.map((c) => nodesToString(c)).join('');\n  }\n  const childElement = children as React.ReactElement<{\n    children?: React.ReactNode;\n  }>;\n\n  if (childElement.props?.children) {\n    return nodesToString(childElement.props.children);\n  }\n\n  return '';\n};\n\n// Global Instance Getters/Setters\nlet globalI18n: i18n | null = null;\nlet globalDefaults: unknown = {};\n\nexport const setI18n = (instance: i18n): void => {\n  globalI18n = instance;\n};\n\nexport const getI18n = (): i18n => {\n  return globalI18n as i18n;\n};\n\nexport const setDefaults = (options: unknown): void => {\n  globalDefaults = options;\n};\n\nexport const getDefaults = (): unknown => {\n  return globalDefaults;\n};\n\n// SSR Stubs\nexport const useSSR = (\n  _initialI18nStore: unknown,\n  _initialLanguage: string\n): void => {};\n\nexport const withSSR = () => {\n  const Hoc = <P extends object>(\n    WrappedComponent: React.ComponentType<P>\n  ): React.ComponentType<P> => {\n    const Component = (props: P) => <WrappedComponent {...props} />;\n    const ExtendedComponent = Component as typeof Component & {\n      getInitialProps: (ctx: unknown) => Promise<Record<string, unknown>>;\n    };\n    ExtendedComponent.getInitialProps = async (_ctx: unknown) => ({});\n    return ExtendedComponent;\n  };\n  return Hoc;\n};\n\nexport const composeInitialProps =\n  (_ForComponent: unknown) => async (_ctx: unknown) => ({});\n\nexport const getInitialProps = () => ({\n  initialI18nStore: {},\n  initialLanguage: 'en',\n});\n"],"mappings":";;;;;AAKA,MAAa,cAAc,MAAM,cAA8B,EAC7D,MAAM,MACP,CAAC;AAaF,MAAa,eAAe,EAC1B,UACA,IACA,gBAC0C;CAC1C,MAAM,EAAE,GAAG,SAAS,eAAe,IAAI,EAAE,WAAW,CAAC;AACrD,QAAO,SACL,GACA;EAAQ;EAAyB,KAAK,KAAK;EAAU,EACrD,KACD;;AAIH,MAAa,iBACX,UACA,cACA,OACA,aACW;AACX,KAAI,OAAO,aAAa,YAAY,OAAO,aAAa,SACtD,QAAO,OAAO,SAAS;AAEzB,KAAI,CAAC,SAAU,QAAO;AACtB,KAAI,MAAM,QAAQ,SAAS,CACzB,QAAO,SAAS,KAAK,MAAM,cAAc,EAAE,CAAC,CAAC,KAAK,GAAG;CAEvD,MAAM,eAAe;AAIrB,KAAI,aAAa,OAAO,SACtB,QAAO,cAAc,aAAa,MAAM,SAAS;AAGnD,QAAO;;AAIT,IAAI,aAA0B;AAC9B,IAAI,iBAA0B,EAAE;AAEhC,MAAa,WAAW,aAAyB;AAC/C,cAAa;;AAGf,MAAa,gBAAsB;AACjC,QAAO;;AAGT,MAAa,eAAe,YAA2B;AACrD,kBAAiB;;AAGnB,MAAa,oBAA6B;AACxC,QAAO;;AAIT,MAAa,UACX,mBACA,qBACS;AAEX,MAAa,gBAAgB;CAC3B,MAAM,OACJ,qBAC2B;EAC3B,MAAM,aAAa,UAAa,oBAAC,kBAAD,EAAkB,GAAI,OAAS;EAC/D,MAAM,oBAAoB;AAG1B,oBAAkB,kBAAkB,OAAO,UAAmB,EAAE;AAChE,SAAO;;AAET,QAAO;;AAGT,MAAa,uBACV,kBAA2B,OAAO,UAAmB,EAAE;AAE1D,MAAa,yBAAyB;CACpC,kBAAkB,EAAE;CACpB,iBAAiB;CAClB"}

package/dist/esm/index.mjs

@@ -0,0 +1,28 @@
+import { useTranslation } from "./useTranslation.mjs";
+import { withTranslation } from "./withTranslation.mjs";
+import { Trans } from "./Trans.mjs";
+import { useDictionaryDynamic } from "./useDictionaryDynamic.mjs";
+import { I18nextProvider } from "./I18nextProvider.mjs";
+import { I18nContext as I18nContext$1, Translation as Translation$1, composeInitialProps as composeInitialProps$1, getDefaults as getDefaults$1, getI18n as getI18n$1, getInitialProps as getInitialProps$1, nodesToString as nodesToString$1, setDefaults as setDefaults$1, setI18n as setI18n$1, useSSR as useSSR$1, withSSR as withSSR$1 } from "./helpers.mjs";
+import { initReactI18next } from "./initReactI18next.mjs";
+import { useDictionary } from "./useDictionary.mjs";
+
+//#region src/index.ts
+const nodesToString = nodesToString$1;
+const setDefaults = setDefaults$1;
+const getDefaults = getDefaults$1;
+const setI18n = setI18n$1;
+const getI18n = getI18n$1;
+const composeInitialProps = composeInitialProps$1;
+const getInitialProps = getInitialProps$1;
+const useSSR = useSSR$1;
+const withSSR = withSSR$1;
+const Translation = Translation$1;
+const I18nContext = I18nContext$1;
+const TransWithoutContext = Trans;
+const IcuTrans = Trans;
+const IcuTransWithoutContext = Trans;
+
+//#endregion
+export { I18nContext, I18nextProvider, IcuTrans, IcuTransWithoutContext, Trans, TransWithoutContext, Translation, composeInitialProps, getDefaults, getI18n, getInitialProps, initReactI18next, nodesToString, setDefaults, setI18n, useDictionary, useDictionaryDynamic, useSSR, useTranslation, withSSR, withTranslation };
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["nodesToStringImpl","setDefaultsImpl","getDefaultsImpl","setI18nImpl","getI18nImpl","composeInitialPropsImpl","getInitialPropsImpl","useSSRImpl","withSSRImpl","TranslationImpl","I18nContextImpl"],"sources":["../../src/index.ts"],"sourcesContent":["import type {\n  composeInitialProps as _composeInitialProps,\n  getDefaults as _getDefaults,\n  getI18n as _getI18n,\n  getInitialProps as _getInitialProps,\n  I18nContext as _I18nContext,\n  setDefaults as _setDefaults,\n  setI18n as _setI18n,\n  Trans as _Trans,\n  Translation as _Translation,\n  TransWithoutContext as _TransWithoutContext,\n  useSSR as _useSSR,\n  withSSR as _withSSR,\n} from 'react-i18next';\n\nimport {\n  composeInitialProps as composeInitialPropsImpl,\n  getDefaults as getDefaultsImpl,\n  getI18n as getI18nImpl,\n  getInitialProps as getInitialPropsImpl,\n  I18nContext as I18nContextImpl,\n  nodesToString as nodesToStringImpl,\n  setDefaults as setDefaultsImpl,\n  setI18n as setI18nImpl,\n  Translation as TranslationImpl,\n  useSSR as useSSRImpl,\n  withSSR as withSSRImpl,\n} from './helpers';\n\nimport { Trans } from './Trans';\n\n// Re-export common types from react-i18next so consumers don't need both packages\nexport type {\n  I18nextProviderProps,\n  TransProps,\n  UseTranslationOptions,\n  UseTranslationResponse,\n  WithTranslation,\n  WithTranslationProps,\n} from 'react-i18next';\nexport { I18nextProvider } from './I18nextProvider';\nexport { initReactI18next } from './initReactI18next';\nexport { useDictionary } from './useDictionary';\nexport { useDictionaryDynamic } from './useDictionaryDynamic';\nexport { useTranslation } from './useTranslation';\nexport { withTranslation } from './withTranslation';\nexport { Trans };\n\n// Wrap and export all implementation functions.\n// `nodesToString` is not part of react-i18next's public type surface in all\n// supported versions, so the local implementation's inferred type is exposed.\nexport const nodesToString = nodesToStringImpl;\nexport const setDefaults = setDefaultsImpl as typeof _setDefaults;\nexport const getDefaults = getDefaultsImpl as typeof _getDefaults;\nexport const setI18n = setI18nImpl as typeof _setI18n;\nexport const getI18n = getI18nImpl as typeof _getI18n;\nexport const composeInitialProps =\n  composeInitialPropsImpl as typeof _composeInitialProps;\nexport const getInitialProps = getInitialPropsImpl as typeof _getInitialProps;\nexport const useSSR = useSSRImpl as typeof _useSSR;\nexport const withSSR = withSSRImpl as typeof _withSSR;\nexport const Translation = TranslationImpl as typeof _Translation;\nexport const I18nContext = I18nContextImpl as typeof _I18nContext;\n\nexport const TransWithoutContext = Trans as typeof _TransWithoutContext;\n// `IcuTrans` / `IcuTransWithoutContext` are aliases for the standard `Trans`\n// component (they only differ by interpolation engine, which the compat shim\n// does not distinguish). They are typed against `Trans` for broad version\n// compatibility, since the dedicated ICU exports are not present in every\n// supported react-i18next release.\nexport const IcuTrans = Trans as typeof _Trans;\nexport const IcuTransWithoutContext = Trans as typeof _Trans;\n"],"mappings":";;;;;;;;;;AAmDA,MAAa,gBAAgBA;AAC7B,MAAa,cAAcC;AAC3B,MAAa,cAAcC;AAC3B,MAAa,UAAUC;AACvB,MAAa,UAAUC;AACvB,MAAa,sBACXC;AACF,MAAa,kBAAkBC;AAC/B,MAAa,SAASC;AACtB,MAAa,UAAUC;AACvB,MAAa,cAAcC;AAC3B,MAAa,cAAcC;AAE3B,MAAa,sBAAsB;AAMnC,MAAa,WAAW;AACxB,MAAa,yBAAyB"}

package/dist/esm/initReactI18next.mjs

@@ -0,0 +1,23 @@
+import { setDefaults, setI18n } from "./helpers.mjs";
+
+//#region src/initReactI18next.ts
+/**
+* Drop-in for react-i18next's `initReactI18next` plugin.
+*
+* Implemented locally rather than re-exported from `react-i18next`: when the
+* compat alias plugin is enabled, `react-i18next` resolves back to this package,
+* so a re-export would be self-referential (resolving to `undefined`). The
+* plugin records the i18n instance via the compat `setI18n`/`setDefaults`
+* helpers; actual translation is served by Intlayer.
+*/
+const initReactI18next = {
+	type: "3rdParty",
+	init: (instance) => {
+		setI18n(instance);
+		setDefaults({});
+	}
+};
+
+//#endregion
+export { initReactI18next };
+//# sourceMappingURL=initReactI18next.mjs.map

package/dist/esm/initReactI18next.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"initReactI18next.mjs","names":[],"sources":["../../src/initReactI18next.ts"],"sourcesContent":["import type { initReactI18next as _initReactI18next } from 'react-i18next';\nimport { setDefaults, setI18n } from './helpers';\n\n/**\n * Drop-in for react-i18next's `initReactI18next` plugin.\n *\n * Implemented locally rather than re-exported from `react-i18next`: when the\n * compat alias plugin is enabled, `react-i18next` resolves back to this package,\n * so a re-export would be self-referential (resolving to `undefined`). The\n * plugin records the i18n instance via the compat `setI18n`/`setDefaults`\n * helpers; actual translation is served by Intlayer.\n */\nexport const initReactI18next: typeof _initReactI18next = {\n  type: '3rdParty' as const,\n  init: (instance) => {\n    setI18n(instance as never);\n    setDefaults({});\n  },\n};\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,mBAA6C;CACxD,MAAM;CACN,OAAO,aAAa;AAClB,UAAQ,SAAkB;AAC1B,cAAY,EAAE,CAAC;;CAElB"}

package/dist/esm/plugin/index.mjs

@@ -0,0 +1,58 @@
+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
+/**
+* Caller configurations for `react-i18next`'s `useTranslation` hook.
+*
+* Tells the intlayer field-usage analyser how to extract the dictionary key
+* (namespace) and consumed fields from `useTranslation` call sites, enabling
+* accurate dictionary pruning for projects using `@intlayer/react-i18next`.
+*/
+const REACT_I18NEXT_COMPAT_CALLERS = [{
+	callerName: "useTranslation",
+	importSources: ["react-i18next", "@intlayer/react-i18next"],
+	namespace: {
+		from: "argument",
+		index: 0
+	},
+	keyPrefix: {
+		from: "option",
+		argumentIndex: 1,
+		property: "keyPrefix"
+	},
+	translationFunction: "destructured-t"
+}];
+/**
+* A Vite plugin for react-i18next compat that wraps vite-intlayer
+* and configures resolve aliases for react-i18next and i18next.
+*/
+const reactI18nextVitePlugin = (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 ?? [], ...REACT_I18NEXT_COMPAT_CALLERS]
+	});
+	const compatPlugin = {
+		name: "vite-react-i18next-compat-plugin",
+		config: () => {
+			return { resolve: { alias: {
+				"react-i18next": "@intlayer/react-i18next",
+				i18next: "@intlayer/i18next"
+			} } };
+		}
+	};
+	return [...Array.isArray(basePlugins) ? basePlugins : [basePlugins], compatPlugin];
+};
+
+//#endregion
+export { reactI18nextVitePlugin as default, reactI18nextVitePlugin };
+//# 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 * Caller configurations for `react-i18next`'s `useTranslation` hook.\n *\n * Tells the intlayer field-usage analyser how to extract the dictionary key\n * (namespace) and consumed fields from `useTranslation` call sites, enabling\n * accurate dictionary pruning for projects using `@intlayer/react-i18next`.\n */\nconst REACT_I18NEXT_COMPAT_CALLERS: CompatCallerConfig[] = [\n  {\n    callerName: 'useTranslation',\n    importSources: ['react-i18next', '@intlayer/react-i18next'],\n    namespace: { from: 'argument', index: 0 },\n    keyPrefix: { from: 'option', argumentIndex: 1, property: 'keyPrefix' },\n    translationFunction: 'destructured-t',\n  },\n];\n\n/**\n * A Vite plugin for react-i18next compat that wraps vite-intlayer\n * and configures resolve aliases for react-i18next and i18next.\n */\nexport const reactI18nextVitePlugin = (\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      ...REACT_I18NEXT_COMPAT_CALLERS,\n    ],\n  });\n\n  const compatPlugin: PluginOption = {\n    name: 'vite-react-i18next-compat-plugin',\n    config: () => {\n      return {\n        resolve: {\n          alias: {\n            'react-i18next': '@intlayer/react-i18next',\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 reactI18nextVitePlugin;\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAM,+BAAqD,CACzD;CACE,YAAY;CACZ,eAAe,CAAC,iBAAiB,0BAA0B;CAC3D,WAAW;EAAE,MAAM;EAAY,OAAO;EAAG;CACzC,WAAW;EAAE,MAAM;EAAU,eAAe;EAAG,UAAU;EAAa;CACtE,qBAAqB;CACtB,CACF;;;;;AAMD,MAAa,0BACX,YACmB;CACnB,MAAM,iBAAiB,kBAAkB;CACzC,MAAM,YAAY,aAAa,eAAe;AAE9C,SACE,KACE,eAAe,OAAO,SACtB,aACA,SACA,kCACD,QACK;AACJ,YAAU,CACR,SACE,+CACA,WAAW,KACZ,EACD,SACE,iDACA,WAAW,WACZ,CACF,CAAC;IAEJ,EACE,gBAAgB,MAAO,KAAK,IAC7B,CACF;CAED,MAAM,cAAc,SAAS;EAC3B,GAAG;EACH,eAAe,CACb,GAAI,SAAS,iBAAiB,EAAE,EAChC,GAAG,6BACJ;EACF,CAAC;CAEF,MAAM,eAA6B;EACjC,MAAM;EACN,cAAc;AACZ,UAAO,EACL,SAAS,EACP,OAAO;IACL,iBAAiB;IACjB,SAAS;IACV,EACF,EACF;;EAEJ;AAED,QAAO,CACL,GAAI,MAAM,QAAQ,YAAY,GAAG,cAAc,CAAC,YAAY,EAC5D,aACD"}

package/dist/esm/useDictionary.mjs

@@ -0,0 +1,62 @@
+'use client';
+
+import { useMemo } from "react";
+import { useDictionary as useDictionary$1, useLocale } from "react-intlayer";
+
+//#region src/useDictionary.ts
+const navigatePath = (objectValue, path) => {
+	if (!path) return objectValue;
+	let current = objectValue;
+	for (const part of path.split(".")) {
+		if (current === null || current === void 0 || typeof current !== "object") return;
+		current = current[part];
+	}
+	return current;
+};
+/**
+* Dictionary-accepting variant of `useTranslation`.
+*
+* Used internally by the SWC optimization: instead of looking up the dictionary
+* at runtime by key, the SWC plugin pre-imports the dictionary JSON at build time
+* and passes it directly here. This enables tree-shaking of unused locale content.
+*
+* For a nested namespace (`useTranslation('about.counter')`), the SWC passes the
+* key prefix (`'counter'`) as the second argument.
+*
+* @example (generated by SWC, not written manually)
+* import _abc from '.intlayer/dictionaries/about.json' with { type: 'json' };
+* const { t } = useDictionary(_abc);
+*/
+const useDictionary = (dictionary, keyPrefix, options) => {
+	const content = useDictionary$1(dictionary);
+	const { locale, setLocale, availableLocales } = useLocale();
+	const i18n = useMemo(() => ({
+		language: locale,
+		languages: availableLocales ?? [],
+		changeLanguage: async (lng) => {
+			setLocale(lng);
+		},
+		isInitialized: true
+	}), [
+		locale,
+		availableLocales,
+		setLocale
+	]);
+	const prefix = (typeof keyPrefix === "object" ? keyPrefix : options)?.keyPrefix ?? (typeof keyPrefix === "string" ? keyPrefix : void 0);
+	const t = (key, params) => {
+		const lookupKey = prefix ? `${prefix}.${String(key)}` : String(key);
+		const rawValue = navigatePath(content, lookupKey);
+		const str = String(rawValue ?? lookupKey);
+		if (!params) return str;
+		return str.replace(/\{\{(\w+)\}\}/g, (_, name) => params[name] != null ? String(params[name]) : `{{${name}}}`);
+	};
+	return {
+		t,
+		i18n,
+		ready: true
+	};
+};
+
+//#endregion
+export { useDictionary };
+//# sourceMappingURL=useDictionary.mjs.map

package/dist/esm/useDictionary.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDictionary.mjs","names":["useDictionaryBase"],"sources":["../../src/useDictionary.ts"],"sourcesContent":["'use client';\n\nimport type { ValidDotPathsFor } from '@intlayer/core/transpiler';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { useMemo } from 'react';\nimport type { UseTranslationOptions } from 'react-i18next';\nimport { useDictionary as useDictionaryBase, useLocale } from 'react-intlayer';\n\nconst navigatePath = (objectValue: unknown, path: string): unknown => {\n  if (!path) return objectValue;\n  let current: unknown = objectValue;\n  for (const part of path.split('.')) {\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 * Dictionary-accepting variant of `useTranslation`.\n *\n * Used internally by the SWC optimization: instead of looking up the dictionary\n * at runtime by key, the SWC plugin pre-imports the dictionary JSON at build time\n * and passes it directly here. This enables tree-shaking of unused locale content.\n *\n * For a nested namespace (`useTranslation('about.counter')`), the SWC passes the\n * key prefix (`'counter'`) as the second argument.\n *\n * @example (generated by SWC, not written manually)\n * import _abc from '.intlayer/dictionaries/about.json' with { type: 'json' };\n * const { t } = useDictionary(_abc);\n */\nexport const useDictionary = <T extends Dictionary>(\n  dictionary: T,\n  keyPrefix?: string | UseTranslationOptions<string>,\n  options?: UseTranslationOptions<string>\n) => {\n  const content = useDictionaryBase(dictionary);\n  const { locale, setLocale, availableLocales } = useLocale();\n\n  const i18n = useMemo(\n    () => ({\n      language: locale as string,\n      languages: (availableLocales ?? []) as string[],\n      changeLanguage: async (lng: string) => {\n        setLocale(lng as LocalesValues);\n      },\n      isInitialized: true,\n    }),\n    [locale, availableLocales, setLocale]\n  );\n\n  const resolvedOptions = typeof keyPrefix === 'object' ? keyPrefix : options;\n  const prefix =\n    resolvedOptions?.keyPrefix ??\n    (typeof keyPrefix === 'string' ? keyPrefix : undefined);\n\n  const t = <P extends ValidDotPathsFor<any>>(\n    key: P,\n    params?: Record<string, unknown>\n  ): string => {\n    const lookupKey = prefix ? `${prefix}.${String(key)}` : String(key);\n    const rawValue = navigatePath(content, lookupKey);\n    const str = String(rawValue ?? lookupKey);\n\n    if (!params) return str;\n\n    return str.replace(/\\{\\{(\\w+)\\}\\}/g, (_, name) =>\n      params[name] != null ? String(params[name]) : `{{${name}}}`\n    );\n  };\n\n  return { t, i18n, ready: true };\n};\n"],"mappings":";;;;;;AASA,MAAM,gBAAgB,aAAsB,SAA0B;AACpE,KAAI,CAAC,KAAM,QAAO;CAClB,IAAI,UAAmB;AACvB,MAAK,MAAM,QAAQ,KAAK,MAAM,IAAI,EAAE;AAClC,MACE,YAAY,QACZ,YAAY,UACZ,OAAO,YAAY,SAEnB;AAEF,YAAW,QAAoC;;AAEjD,QAAO;;;;;;;;;;;;;;;;AAiBT,MAAa,iBACX,YACA,WACA,YACG;CACH,MAAM,UAAUA,gBAAkB,WAAW;CAC7C,MAAM,EAAE,QAAQ,WAAW,qBAAqB,WAAW;CAE3D,MAAM,OAAO,eACJ;EACL,UAAU;EACV,WAAY,oBAAoB,EAAE;EAClC,gBAAgB,OAAO,QAAgB;AACrC,aAAU,IAAqB;;EAEjC,eAAe;EAChB,GACD;EAAC;EAAQ;EAAkB;EAAU,CACtC;CAGD,MAAM,UADkB,OAAO,cAAc,WAAW,YAAY,UAEjD,cAChB,OAAO,cAAc,WAAW,YAAY;CAE/C,MAAM,KACJ,KACA,WACW;EACX,MAAM,YAAY,SAAS,GAAG,OAAO,GAAG,OAAO,IAAI,KAAK,OAAO,IAAI;EACnE,MAAM,WAAW,aAAa,SAAS,UAAU;EACjD,MAAM,MAAM,OAAO,YAAY,UAAU;AAEzC,MAAI,CAAC,OAAQ,QAAO;AAEpB,SAAO,IAAI,QAAQ,mBAAmB,GAAG,SACvC,OAAO,SAAS,OAAO,OAAO,OAAO,MAAM,GAAG,KAAK,KAAK,IACzD;;AAGH,QAAO;EAAE;EAAG;EAAM,OAAO;EAAM"}

package/dist/esm/useDictionaryDynamic.mjs

@@ -0,0 +1,47 @@
+'use client';
+
+import { useMemo } from "react";
+import { useDictionaryDynamic as useDictionaryDynamic$1, useLocale } from "react-intlayer";
+
+//#region src/useDictionaryDynamic.ts
+/**
+* Dynamic dictionary-accepting variant of `useTranslation`.
+*/
+const useDictionaryDynamic = (dictionaryPromise, key, options) => {
+	const content = useDictionaryDynamic$1(dictionaryPromise, key);
+	const { locale, setLocale, availableLocales } = useLocale();
+	const i18n = useMemo(() => ({
+		language: locale,
+		languages: availableLocales ?? [],
+		changeLanguage: async (lng) => {
+			setLocale(lng);
+		},
+		isInitialized: true
+	}), [
+		locale,
+		availableLocales,
+		setLocale
+	]);
+	const prefix = options?.keyPrefix;
+	const t = (lookup, params) => {
+		const lookupKey = prefix ? `${prefix}.${String(lookup)}` : String(lookup);
+		const parts = lookupKey.split(".");
+		let current = content;
+		for (const part of parts) {
+			if (current == null) break;
+			current = current[part];
+		}
+		const str = String(current ?? lookupKey);
+		if (!params) return str;
+		return str.replace(/\{\{(\w+)\}\}/g, (_, k) => params[k] != null ? String(params[k]) : `{{${k}}}`);
+	};
+	return {
+		t,
+		i18n,
+		ready: true
+	};
+};
+
+//#endregion
+export { useDictionaryDynamic };
+//# sourceMappingURL=useDictionaryDynamic.mjs.map

package/dist/esm/useDictionaryDynamic.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDictionaryDynamic.mjs","names":["useDictionaryDynamicBase"],"sources":["../../src/useDictionaryDynamic.ts"],"sourcesContent":["'use client';\n\nimport type { ValidDotPathsFor } from '@intlayer/core/transpiler';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type { StrictModeLocaleMap } from '@intlayer/types/module_augmentation';\nimport { useMemo } from 'react';\nimport type { UseTranslationOptions } from 'react-i18next';\nimport {\n  useDictionaryDynamic as useDictionaryDynamicBase,\n  useLocale,\n} from 'react-intlayer';\n\n/**\n * Dynamic dictionary-accepting variant of `useTranslation`.\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const K extends string,\n>(\n  dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>,\n  key: K,\n  options?: UseTranslationOptions<string>\n) => {\n  const content = useDictionaryDynamicBase<T, any>(\n    dictionaryPromise,\n    key as any\n  );\n  const { locale, setLocale, availableLocales } = useLocale();\n\n  const i18n = useMemo(\n    () => ({\n      language: locale as string,\n      languages: (availableLocales ?? []) as string[],\n      changeLanguage: async (lng: string) => {\n        setLocale(lng as any);\n      },\n      isInitialized: true,\n    }),\n    [locale, availableLocales, setLocale]\n  );\n\n  const prefix = options?.keyPrefix;\n\n  const t = <P extends ValidDotPathsFor<any>>(\n    lookup: P,\n    params?: Record<string, unknown>\n  ): string => {\n    const lookupKey = prefix ? `${prefix}.${String(lookup)}` : String(lookup);\n    const parts = lookupKey.split('.');\n    let current: any = content;\n\n    for (const part of parts) {\n      if (current == null) break;\n      current = current[part];\n    }\n\n    const str = String(current ?? lookupKey);\n\n    if (!params) return str;\n\n    return str.replace(/\\{\\{(\\w+)\\}\\}/g, (_, k) =>\n      params[k] != null ? String(params[k]) : `{{${k}}}`\n    );\n  };\n\n  return { t, i18n, ready: true };\n};\n"],"mappings":";;;;;;;;;AAeA,MAAa,wBAIX,mBACA,KACA,YACG;CACH,MAAM,UAAUA,uBACd,mBACA,IACD;CACD,MAAM,EAAE,QAAQ,WAAW,qBAAqB,WAAW;CAE3D,MAAM,OAAO,eACJ;EACL,UAAU;EACV,WAAY,oBAAoB,EAAE;EAClC,gBAAgB,OAAO,QAAgB;AACrC,aAAU,IAAW;;EAEvB,eAAe;EAChB,GACD;EAAC;EAAQ;EAAkB;EAAU,CACtC;CAED,MAAM,SAAS,SAAS;CAExB,MAAM,KACJ,QACA,WACW;EACX,MAAM,YAAY,SAAS,GAAG,OAAO,GAAG,OAAO,OAAO,KAAK,OAAO,OAAO;EACzE,MAAM,QAAQ,UAAU,MAAM,IAAI;EAClC,IAAI,UAAe;AAEnB,OAAK,MAAM,QAAQ,OAAO;AACxB,OAAI,WAAW,KAAM;AACrB,aAAU,QAAQ;;EAGpB,MAAM,MAAM,OAAO,WAAW,UAAU;AAExC,MAAI,CAAC,OAAQ,QAAO;AAEpB,SAAO,IAAI,QAAQ,mBAAmB,GAAG,MACvC,OAAO,MAAM,OAAO,OAAO,OAAO,GAAG,GAAG,KAAK,EAAE,IAChD;;AAGH,QAAO;EAAE;EAAG;EAAM,OAAO;EAAM"}

package/dist/esm/useTranslation.mjs

@@ -0,0 +1,107 @@
+'use client';
+
+import { getHTMLTextDir } from "@intlayer/core/localization";
+import { resolveMessage } from "@intlayer/core/messageFormat";
+import { getInterpolationValues, resolveTranslation } from "@intlayer/i18next";
+import { useMemo } from "react";
+import { useLocale } from "react-intlayer";
+
+//#region src/useTranslation.ts
+/**
+* Drop-in for react-i18next's `useTranslation`.
+*
+* Translation lookup goes through the shared i18next-dialect resolver:
+* namespace prefixes (`ns:key`), the `ns` option, plural suffixes
+* (`key_one`/`key_other` via `Intl.PluralRules`), context suffixes
+* (`key_male`), `$t()` nesting, `defaultValue` and `{{var}}` interpolation
+* are all supported.
+*
+* The returned `t()` is typed against the intlayer dictionary for namespace N:
+* keys are autocompleted and dot-paths are validated at compile time.
+*
+* @example
+* ```tsx
+* const { t } = useTranslation('about');
+* t('counter.label'); // ✓ typed; compile error if key doesn't exist
+* t('items', { count: 3 }); // plural suffix resolution
+* ```
+*/
+const useTranslation = (ns, options) => {
+	const namespace = Array.isArray(ns) ? ns[0] ?? "translation" : ns ?? "translation";
+	const { locale, setLocale, availableLocales } = useLocale();
+	const keyPrefix = options?.keyPrefix;
+	/**
+	* @param key - A valid dot-notation path within the namespace N dictionary.
+	* @param optionsOrDefaultValue - i18next `t()` options (interpolation
+	*   values, `count`, `context`, `ns`, `defaultValue`, …) or a default
+	*   value string.
+	*/
+	const translate = useMemo(() => {
+		const resolveSingleKey = (key, translateOptions) => resolveTranslation({
+			locale,
+			namespace,
+			key: keyPrefix ? `${keyPrefix}.${key}` : key,
+			options: translateOptions
+		});
+		return (key, optionsOrDefaultValue, extraOptions) => {
+			const translateOptions = typeof optionsOrDefaultValue === "string" ? {
+				defaultValue: optionsOrDefaultValue,
+				...extraOptions
+			} : optionsOrDefaultValue ?? {};
+			const keys = Array.isArray(key) ? key : [key];
+			for (const candidateKey of keys) {
+				const resolved = resolveSingleKey(candidateKey, translateOptions);
+				if (resolved !== void 0) return resolved;
+			}
+			const defaultValue = translateOptions.defaultValue;
+			if (typeof defaultValue === "string") return resolveMessage(defaultValue, getInterpolationValues(translateOptions), locale, "i18next");
+			return keys[keys.length - 1];
+		};
+	}, [
+		locale,
+		namespace,
+		keyPrefix
+	]);
+	return {
+		t: translate,
+		i18n: useMemo(() => ({
+			language: locale,
+			languages: availableLocales ?? [],
+			resolvedLanguage: locale,
+			isInitialized: true,
+			changeLanguage: async (newLanguage) => {
+				setLocale(newLanguage);
+			},
+			dir: (language) => {
+				return getHTMLTextDir(language ?? locale) === "rtl" ? "rtl" : "ltr";
+			},
+			exists: (key, existsOptions) => resolveTranslation({
+				locale,
+				namespace,
+				key,
+				options: existsOptions
+			}) !== void 0,
+			t: translate,
+			getFixedT: (language, fixedNamespace) => (key, fixedOptions) => {
+				const resolved = resolveTranslation({
+					locale: language ?? locale,
+					namespace: fixedNamespace ?? namespace,
+					key,
+					options: fixedOptions
+				});
+				return resolved !== void 0 ? resolved : key;
+			}
+		}), [
+			locale,
+			availableLocales,
+			setLocale,
+			namespace,
+			translate
+		]),
+		ready: true
+	};
+};
+
+//#endregion
+export { useTranslation };
+//# sourceMappingURL=useTranslation.mjs.map

package/dist/esm/useTranslation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranslation.mjs","names":[],"sources":["../../src/useTranslation.ts"],"sourcesContent":["'use client';\n\nimport { getHTMLTextDir } from '@intlayer/core/localization';\nimport { resolveMessage } from '@intlayer/core/messageFormat';\nimport type { ValidDotPathsFor } from '@intlayer/core/transpiler';\nimport { getInterpolationValues, resolveTranslation } from '@intlayer/i18next';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type { TOptions } from 'i18next';\nimport { useMemo } from 'react';\nimport type { UseTranslationOptions } from 'react-i18next';\nimport { useLocale } from 'react-intlayer';\n\n/**\n * Drop-in for react-i18next's `useTranslation`.\n *\n * Translation lookup goes through the shared i18next-dialect resolver:\n * namespace prefixes (`ns:key`), the `ns` option, plural suffixes\n * (`key_one`/`key_other` via `Intl.PluralRules`), context suffixes\n * (`key_male`), `$t()` nesting, `defaultValue` and `{{var}}` interpolation\n * are all supported.\n *\n * The returned `t()` is typed against the intlayer dictionary for namespace N:\n * keys are autocompleted and dot-paths are validated at compile time.\n *\n * @example\n * ```tsx\n * const { t } = useTranslation('about');\n * t('counter.label'); // ✓ typed; compile error if key doesn't exist\n * t('items', { count: 3 }); // plural suffix resolution\n * ```\n */\nexport const useTranslation = <N extends DictionaryKeys>(\n  ns?: N | N[],\n  options?: UseTranslationOptions<string>\n) => {\n  const namespace = (\n    Array.isArray(ns) ? (ns[0] ?? 'translation') : (ns ?? 'translation')\n  ) as N;\n\n  const { locale, setLocale, availableLocales } = useLocale();\n\n  const keyPrefix = options?.keyPrefix;\n\n  /**\n   * @param key - A valid dot-notation path within the namespace N dictionary.\n   * @param optionsOrDefaultValue - i18next `t()` options (interpolation\n   *   values, `count`, `context`, `ns`, `defaultValue`, …) or a default\n   *   value string.\n   */\n  const translate = useMemo(() => {\n    const resolveSingleKey = (\n      key: string,\n      translateOptions?: TOptions\n    ): unknown =>\n      resolveTranslation({\n        locale: locale as LocalesValues,\n        namespace,\n        key: keyPrefix ? `${keyPrefix}.${key}` : key,\n        options: translateOptions,\n      });\n\n    return (\n      key: string | string[],\n      optionsOrDefaultValue?: TOptions | string,\n      extraOptions?: TOptions\n    ): string => {\n      const translateOptions: TOptions =\n        typeof optionsOrDefaultValue === 'string'\n          ? { defaultValue: optionsOrDefaultValue, ...extraOptions }\n          : (optionsOrDefaultValue ?? {});\n\n      const keys = Array.isArray(key) ? key : [key];\n\n      for (const candidateKey of keys) {\n        const resolved = resolveSingleKey(candidateKey, translateOptions);\n        if (resolved !== undefined) return resolved as string;\n      }\n\n      const defaultValue = translateOptions.defaultValue;\n      if (typeof defaultValue === 'string') {\n        return resolveMessage(\n          defaultValue,\n          getInterpolationValues(translateOptions),\n          locale as LocalesValues,\n          'i18next'\n        );\n      }\n\n      return keys[keys.length - 1];\n    };\n  }, [locale, namespace, keyPrefix]);\n\n  const i18n = useMemo(\n    () => ({\n      language: locale as string,\n      languages: (availableLocales ?? []) as string[],\n      resolvedLanguage: locale as string,\n      isInitialized: true,\n      changeLanguage: async (newLanguage: string) => {\n        setLocale(newLanguage as LocalesValues);\n      },\n      dir: (language?: string): 'ltr' | 'rtl' => {\n        const direction = getHTMLTextDir((language ?? locale) as LocalesValues);\n        return direction === 'rtl' ? 'rtl' : 'ltr';\n      },\n      exists: (key: string, existsOptions?: TOptions): boolean =>\n        resolveTranslation({\n          locale: locale as LocalesValues,\n          namespace,\n          key,\n          options: existsOptions,\n        }) !== undefined,\n      t: translate,\n      getFixedT:\n        (language?: string | null, fixedNamespace?: string | null) =>\n        (key: string, fixedOptions?: TOptions): string => {\n          const resolved = resolveTranslation({\n            locale: (language ?? locale) as LocalesValues,\n            namespace: fixedNamespace ?? namespace,\n            key,\n            options: fixedOptions,\n          });\n          return resolved !== undefined ? (resolved as string) : key;\n        },\n    }),\n    [locale, availableLocales, setLocale, namespace, translate]\n  );\n\n  /** Typed facade over the untyped runtime translate function. */\n  const t = translate as <P extends ValidDotPathsFor<N>>(\n    key: P | P[],\n    optionsOrDefaultValue?: TOptions | string,\n    extraOptions?: TOptions\n  ) => string;\n\n  return { t, i18n, ready: true };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,MAAa,kBACX,IACA,YACG;CACH,MAAM,YACJ,MAAM,QAAQ,GAAG,GAAI,GAAG,MAAM,gBAAkB,MAAM;CAGxD,MAAM,EAAE,QAAQ,WAAW,qBAAqB,WAAW;CAE3D,MAAM,YAAY,SAAS;;;;;;;CAQ3B,MAAM,YAAY,cAAc;EAC9B,MAAM,oBACJ,KACA,qBAEA,mBAAmB;GACT;GACR;GACA,KAAK,YAAY,GAAG,UAAU,GAAG,QAAQ;GACzC,SAAS;GACV,CAAC;AAEJ,UACE,KACA,uBACA,iBACW;GACX,MAAM,mBACJ,OAAO,0BAA0B,WAC7B;IAAE,cAAc;IAAuB,GAAG;IAAc,GACvD,yBAAyB,EAAE;GAElC,MAAM,OAAO,MAAM,QAAQ,IAAI,GAAG,MAAM,CAAC,IAAI;AAE7C,QAAK,MAAM,gBAAgB,MAAM;IAC/B,MAAM,WAAW,iBAAiB,cAAc,iBAAiB;AACjE,QAAI,aAAa,OAAW,QAAO;;GAGrC,MAAM,eAAe,iBAAiB;AACtC,OAAI,OAAO,iBAAiB,SAC1B,QAAO,eACL,cACA,uBAAuB,iBAAiB,EACxC,QACA,UACD;AAGH,UAAO,KAAK,KAAK,SAAS;;IAE3B;EAAC;EAAQ;EAAW;EAAU,CAAC;AA6ClC,QAAO;EAAE;EAAG,MA3CC,eACJ;GACL,UAAU;GACV,WAAY,oBAAoB,EAAE;GAClC,kBAAkB;GAClB,eAAe;GACf,gBAAgB,OAAO,gBAAwB;AAC7C,cAAU,YAA6B;;GAEzC,MAAM,aAAqC;AAEzC,WADkB,eAAgB,YAAY,OAC9B,KAAK,QAAQ,QAAQ;;GAEvC,SAAS,KAAa,kBACpB,mBAAmB;IACT;IACR;IACA;IACA,SAAS;IACV,CAAC,KAAK;GACT,GAAG;GACH,YACG,UAA0B,oBAC1B,KAAa,iBAAoC;IAChD,MAAM,WAAW,mBAAmB;KAClC,QAAS,YAAY;KACrB,WAAW,kBAAkB;KAC7B;KACA,SAAS;KACV,CAAC;AACF,WAAO,aAAa,SAAa,WAAsB;;GAE5D,GACD;GAAC;GAAQ;GAAkB;GAAW;GAAW;GAAU,CAU7C;EAAE,OAAO;EAAM"}

package/dist/esm/useTranslationDictionary.mjs

@@ -0,0 +1,55 @@
+'use client';
+
+import { useMemo } from "react";
+import { useDictionary, useLocale } from "react-intlayer";
+
+//#region src/useTranslationDictionary.ts
+/**
+* Dictionary-accepting variant of `useTranslation`.
+*
+* Used internally by the SWC optimization: instead of looking up the dictionary
+* at runtime by key, the SWC plugin pre-imports the dictionary JSON at build time
+* and passes it directly here. This enables tree-shaking of unused locale content.
+*
+* @example (generated by SWC, not written manually)
+* import _abc from '.intlayer/dictionaries/about.json' with { type: 'json' };
+* const { t } = useTranslationDictionary(_abc);
+*/
+const useTranslationDictionary = (dictionary, keyPrefix, options) => {
+	const content = useDictionary(dictionary);
+	const { locale, setLocale, availableLocales } = useLocale();
+	const i18n = useMemo(() => ({
+		language: locale,
+		languages: availableLocales ?? [],
+		changeLanguage: async (lng) => {
+			setLocale(lng);
+		},
+		isInitialized: true
+	}), [
+		locale,
+		availableLocales,
+		setLocale
+	]);
+	const prefix = options?.keyPrefix ?? keyPrefix;
+	const t = (key, params) => {
+		const lookupKey = prefix ? `${prefix}.${String(key)}` : String(key);
+		const parts = lookupKey.split(".");
+		let current = content;
+		for (const part of parts) {
+			if (current == null) break;
+			current = current[part];
+		}
+		const str = String(current ?? lookupKey);
+		if (!params) return str;
+		return str.replace(/\{\{(\w+)\}\}/g, (_, k) => params[k] != null ? String(params[k]) : `{{${k}}}`);
+	};
+	return {
+		t,
+		i18n,
+		ready: true
+	};
+};
+
+//#endregion
+export { useTranslationDictionary };
+//# sourceMappingURL=useTranslationDictionary.mjs.map

package/dist/esm/useTranslationDictionary.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranslationDictionary.mjs","names":[],"sources":["../../src/useTranslationDictionary.ts"],"sourcesContent":["'use client';\n\nimport type { ValidDotPathsFor } from '@intlayer/core/transpiler';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type { UseTranslationOptions } from 'i18next';\nimport { useMemo } from 'react';\nimport { useDictionary, useLocale } from 'react-intlayer';\n\n/**\n * Dictionary-accepting variant of `useTranslation`.\n *\n * Used internally by the SWC optimization: instead of looking up the dictionary\n * at runtime by key, the SWC plugin pre-imports the dictionary JSON at build time\n * and passes it directly here. This enables tree-shaking of unused locale content.\n *\n * @example (generated by SWC, not written manually)\n * import _abc from '.intlayer/dictionaries/about.json' with { type: 'json' };\n * const { t } = useTranslationDictionary(_abc);\n */\nexport const useTranslationDictionary = <T extends Dictionary>(\n  dictionary: T,\n  keyPrefix?: string,\n  options?: UseTranslationOptions<string>\n) => {\n  // reuse useDictionary which handles locale + getDictionary\n  const content = useDictionary(dictionary);\n  const { locale, setLocale, availableLocales } = useLocale();\n\n  const i18n = useMemo(\n    () => ({\n      language: locale as string,\n      languages: (availableLocales ?? []) as string[],\n      changeLanguage: async (lng: string) => {\n        setLocale(lng as any);\n      },\n      isInitialized: true,\n    }),\n    [locale, availableLocales, setLocale]\n  );\n\n  const prefix = options?.keyPrefix ?? keyPrefix;\n\n  const t = <P extends ValidDotPathsFor<any>>(\n    key: P,\n    params?: Record<string, unknown>\n  ): string => {\n    const lookupKey = prefix ? `${prefix}.${String(key)}` : String(key);\n    const parts = lookupKey.split('.');\n    let current: any = content;\n    for (const part of parts) {\n      if (current == null) break;\n      current = current[part];\n    }\n    const str = String(current ?? lookupKey);\n    if (!params) return str;\n    return str.replace(/\\{\\{(\\w+)\\}\\}/g, (_, k) =>\n      params[k] != null ? String(params[k]) : `{{${k}}}`\n    );\n  };\n\n  return { t, i18n, ready: true };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAmBA,MAAa,4BACX,YACA,WACA,YACG;CAEH,MAAM,UAAU,cAAc,WAAW;CACzC,MAAM,EAAE,QAAQ,WAAW,qBAAqB,WAAW;CAE3D,MAAM,OAAO,eACJ;EACL,UAAU;EACV,WAAY,oBAAoB,EAAE;EAClC,gBAAgB,OAAO,QAAgB;AACrC,aAAU,IAAW;;EAEvB,eAAe;EAChB,GACD;EAAC;EAAQ;EAAkB;EAAU,CACtC;CAED,MAAM,SAAS,SAAS,aAAa;CAErC,MAAM,KACJ,KACA,WACW;EACX,MAAM,YAAY,SAAS,GAAG,OAAO,GAAG,OAAO,IAAI,KAAK,OAAO,IAAI;EACnE,MAAM,QAAQ,UAAU,MAAM,IAAI;EAClC,IAAI,UAAe;AACnB,OAAK,MAAM,QAAQ,OAAO;AACxB,OAAI,WAAW,KAAM;AACrB,aAAU,QAAQ;;EAEpB,MAAM,MAAM,OAAO,WAAW,UAAU;AACxC,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,IAAI,QAAQ,mBAAmB,GAAG,MACvC,OAAO,MAAM,OAAO,OAAO,OAAO,GAAG,GAAG,KAAK,EAAE,IAChD;;AAGH,QAAO;EAAE;EAAG;EAAM,OAAO;EAAM"}

package/dist/esm/useTranslationDictionaryDynamic.mjs

@@ -0,0 +1,47 @@
+'use client';
+
+import { useMemo } from "react";
+import { useDictionaryDynamic, useLocale } from "react-intlayer";
+
+//#region src/useTranslationDictionaryDynamic.ts
+/**
+* Dynamic dictionary-accepting variant of `useTranslation`.
+*/
+const useTranslationDictionaryDynamic = (dictionaryPromise, key, keyPrefix, options) => {
+	const content = useDictionaryDynamic(dictionaryPromise, key);
+	const { locale, setLocale, availableLocales } = useLocale();
+	const i18n = useMemo(() => ({
+		language: locale,
+		languages: availableLocales ?? [],
+		changeLanguage: async (lng) => {
+			setLocale(lng);
+		},
+		isInitialized: true
+	}), [
+		locale,
+		availableLocales,
+		setLocale
+	]);
+	const prefix = options?.keyPrefix ?? keyPrefix;
+	const t = (lookup, params) => {
+		const lookupKey = prefix ? `${prefix}.${String(lookup)}` : String(lookup);
+		const parts = lookupKey.split(".");
+		let current = content;
+		for (const part of parts) {
+			if (current == null) break;
+			current = current[part];
+		}
+		const str = String(current ?? lookupKey);
+		if (!params) return str;
+		return str.replace(/\{\{(\w+)\}\}/g, (_, k) => params[k] != null ? String(params[k]) : `{{${k}}}`);
+	};
+	return {
+		t,
+		i18n,
+		ready: true
+	};
+};
+
+//#endregion
+export { useTranslationDictionaryDynamic };
+//# sourceMappingURL=useTranslationDictionaryDynamic.mjs.map

package/dist/esm/useTranslationDictionaryDynamic.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranslationDictionaryDynamic.mjs","names":[],"sources":["../../src/useTranslationDictionaryDynamic.ts"],"sourcesContent":["'use client';\n\nimport type { ValidDotPathsFor } from '@intlayer/core/transpiler';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type { StrictModeLocaleMap } from '@intlayer/types/module_augmentation';\nimport type { UseTranslationOptions } from 'i18next';\nimport { useMemo } from 'react';\nimport { useDictionaryDynamic, useLocale } from 'react-intlayer';\n\n/**\n * Dynamic dictionary-accepting variant of `useTranslation`.\n */\nexport const useTranslationDictionaryDynamic = <\n  const T extends Dictionary,\n  const K extends string,\n>(\n  dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>,\n  key: K,\n  keyPrefix?: string,\n  options?: UseTranslationOptions<string>\n) => {\n  const content = useDictionaryDynamic<T, any>(dictionaryPromise, key as any);\n  const { locale, setLocale, availableLocales } = useLocale();\n\n  const i18n = useMemo(\n    () => ({\n      language: locale as string,\n      languages: (availableLocales ?? []) as string[],\n      changeLanguage: async (lng: string) => {\n        setLocale(lng as any);\n      },\n      isInitialized: true,\n    }),\n    [locale, availableLocales, setLocale]\n  );\n\n  const prefix = options?.keyPrefix ?? keyPrefix;\n\n  const t = <P extends ValidDotPathsFor<any>>(\n    lookup: P,\n    params?: Record<string, unknown>\n  ): string => {\n    const lookupKey = prefix ? `${prefix}.${String(lookup)}` : String(lookup);\n    const parts = lookupKey.split('.');\n    let current: any = content;\n    for (const part of parts) {\n      if (current == null) break;\n      current = current[part];\n    }\n    const str = String(current ?? lookupKey);\n    if (!params) return str;\n    return str.replace(/\\{\\{(\\w+)\\}\\}/g, (_, k) =>\n      params[k] != null ? String(params[k]) : `{{${k}}}`\n    );\n  };\n\n  return { t, i18n, ready: true };\n};\n"],"mappings":";;;;;;;;;AAYA,MAAa,mCAIX,mBACA,KACA,WACA,YACG;CACH,MAAM,UAAU,qBAA6B,mBAAmB,IAAW;CAC3E,MAAM,EAAE,QAAQ,WAAW,qBAAqB,WAAW;CAE3D,MAAM,OAAO,eACJ;EACL,UAAU;EACV,WAAY,oBAAoB,EAAE;EAClC,gBAAgB,OAAO,QAAgB;AACrC,aAAU,IAAW;;EAEvB,eAAe;EAChB,GACD;EAAC;EAAQ;EAAkB;EAAU,CACtC;CAED,MAAM,SAAS,SAAS,aAAa;CAErC,MAAM,KACJ,QACA,WACW;EACX,MAAM,YAAY,SAAS,GAAG,OAAO,GAAG,OAAO,OAAO,KAAK,OAAO,OAAO;EACzE,MAAM,QAAQ,UAAU,MAAM,IAAI;EAClC,IAAI,UAAe;AACnB,OAAK,MAAM,QAAQ,OAAO;AACxB,OAAI,WAAW,KAAM;AACrB,aAAU,QAAQ;;EAEpB,MAAM,MAAM,OAAO,WAAW,UAAU;AACxC,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,IAAI,QAAQ,mBAAmB,GAAG,MACvC,OAAO,MAAM,OAAO,OAAO,OAAO,GAAG,GAAG,KAAK,EAAE,IAChD;;AAGH,QAAO;EAAE;EAAG;EAAM,OAAO;EAAM"}

package/dist/esm/withTranslation.mjs

@@ -0,0 +1,26 @@
+'use client';
+
+import { useTranslation } from "./useTranslation.mjs";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/withTranslation.tsx
+/**
+* Drop-in for react-i18next's `withTranslation` HOC.
+*/
+const withTranslation = ((ns, options) => (WrappedComponent) => {
+	const WithTranslation = (props) => {
+		const { t, i18n } = useTranslation(ns, options);
+		return /* @__PURE__ */ jsx(WrappedComponent, {
+			...props,
+			t,
+			i18n,
+			tReady: true
+		});
+	};
+	WithTranslation.displayName = `withTranslation(${WrappedComponent.displayName ?? WrappedComponent.name ?? "Component"})`;
+	return WithTranslation;
+});
+
+//#endregion
+export { withTranslation };
+//# sourceMappingURL=withTranslation.mjs.map

package/dist/esm/withTranslation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"withTranslation.mjs","names":[],"sources":["../../src/withTranslation.tsx"],"sourcesContent":["'use client';\n\nimport type * as React from 'react';\nimport type {\n  withTranslation as _withTranslation,\n  UseTranslationOptions,\n} from 'react-i18next';\nimport { useTranslation } from './useTranslation';\n\n/**\n * Drop-in for react-i18next's `withTranslation` HOC.\n */\nexport const withTranslation: typeof _withTranslation = ((\n  ns?: string | string[],\n  options?: UseTranslationOptions<string>\n) =>\n  <P extends { t: unknown; i18n: unknown; tReady: boolean }>(\n    WrappedComponent: React.ComponentType<P>\n  ) => {\n    const WithTranslation = (props: Omit<P, 't' | 'i18n' | 'tReady'>) => {\n      const { t, i18n } = useTranslation(ns, options);\n      return (\n        <WrappedComponent\n          {...(props as unknown as P)}\n          t={t}\n          i18n={i18n}\n          tReady\n        />\n      );\n    };\n    WithTranslation.displayName = `withTranslation(${\n      WrappedComponent.displayName ?? WrappedComponent.name ?? 'Component'\n    })`;\n    return WithTranslation as unknown as React.ComponentType<\n      Omit<P, 't' | 'i18n' | 'tReady'>\n    >;\n  }) as typeof _withTranslation;\n"],"mappings":";;;;;;;;;AAYA,MAAa,oBACX,IACA,aAGE,qBACG;CACH,MAAM,mBAAmB,UAA4C;EACnE,MAAM,EAAE,GAAG,SAAS,eAAe,IAAI,QAAQ;AAC/C,SACE,oBAAC,kBAAD;GACE,GAAK;GACF;GACG;GACN;GACA;;AAGN,iBAAgB,cAAc,mBAC5B,iBAAiB,eAAe,iBAAiB,QAAQ,YAC1D;AACD,QAAO"}

package/dist/types/I18nextProvider.d.ts

@@ -0,0 +1,13 @@
+import { I18nextProvider as I18nextProvider$1 } from "react-i18next";
+
+//#region src/I18nextProvider.d.ts
+/**
+ * Drop-in for react-i18next's `I18nextProvider`.
+ * The `i18n` prop is accepted for API compatibility but has no effect —
+ * Intlayer uses its own instance. A development warning is emitted when
+ * the `i18n` prop is provided so consumers know to remove it.
+ */
+declare const I18nextProvider: typeof I18nextProvider$1;
+//#endregion
+export { I18nextProvider };
+//# sourceMappingURL=I18nextProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"I18nextProvider.d.ts","names":[],"sources":["../../src/I18nextProvider.tsx"],"mappings":";;;;;AAiBA;;;;cAAa,eAAA,SAAwB,iBAAA"}

package/dist/types/Trans.d.ts

@@ -0,0 +1,22 @@
+import { Trans as Trans$1 } from "react-i18next";
+
+//#region src/Trans.d.ts
+/**
+ * Drop-in for react-i18next's `<Trans>`.
+ *
+ * Supports `values` interpolation, `count` plural resolution, `context`,
+ * `defaults` fallback, and component interpolation through the `components`
+ * prop (object or array form) or numbered tags mapped onto JSX children.
+ *
+ * @example
+ * ```tsx
+ * <Trans i18nKey="richText" components={{ bold: <strong /> }} />
+ * <Trans i18nKey="hello" count={2} values={{ name: 'John' }}>
+ *   Hello <b>{'{{name}}'}</b>
+ * </Trans>
+ * ```
+ */
+declare const Trans: typeof Trans$1;
+//#endregion
+export { Trans };
+//# sourceMappingURL=Trans.d.ts.map