react-intlayer 8.12.5-canary.0 → 9.0.0-canary.10

package/dist/cjs/client/index.cjs

@@ -11,6 +11,7 @@ const require_client_useIntlayer = require('./useIntlayer.cjs');
 const require_client_useLocale = require('./useLocale.cjs');
 const require_client_useLocaleBase = require('./useLocaleBase.cjs');
 const require_client_useRewriteURL = require('./useRewriteURL.cjs');
+const require_client_usePathname = require('./usePathname.cjs');
 
 exports.IntlayerClientContext = require_client_IntlayerProvider.IntlayerClientContext;
 exports.IntlayerProvider = require_client_IntlayerProvider.IntlayerProvider;
@@ -31,4 +32,5 @@ exports.useLocale = require_client_useLocale.useLocale;
 exports.useLocaleBase = require_client_useLocaleBase.useLocaleBase;
 exports.useLocaleCookie = require_client_useLocaleStorage.useLocaleCookie;
 exports.useLocaleStorage = require_client_useLocaleStorage.useLocaleStorage;
+exports.usePathname = require_client_usePathname.usePathname;
 exports.useRewriteURL = require_client_useRewriteURL.useRewriteURL;

package/dist/cjs/client/useDictionary.cjs

@@ -5,21 +5,30 @@ const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_getDictionary = require('../getDictionary.cjs');
 const require_client_IntlayerProvider = require('./IntlayerProvider.cjs');
 let react = require("react");
+let _intlayer_core_dictionaryManipulator = require("@intlayer/core/dictionaryManipulator");
 
 //#region src/client/useDictionary.ts
 /**
-* On the server side, Hook that transform a dictionary and return the content
+* Client-side hook that transforms a dictionary (or qualified dictionary
+* group) and returns the content.
 *
-* If the locale is not provided, it will use the locale from the client context
+* If the locale is not provided (directly or through the selector), it will
+* use the locale from the client context.
 */
-const useDictionary = (dictionary, locale) => {
+const useDictionary = (dictionary, localeOrSelector) => {
 	const { locale: currentLocale } = (0, react.useContext)(require_client_IntlayerProvider.IntlayerClientContext) ?? {};
+	const isSelector = process.env.INTLAYER_DICTIONARY_SELECTOR !== "false" && typeof localeOrSelector === "object" && localeOrSelector !== null;
+	const localeOrSelectorIdentity = isSelector ? `${localeOrSelector.locale ?? ""}|${(0, _intlayer_core_dictionaryManipulator.getDictionarySelectorCacheKey)(localeOrSelector)}` : localeOrSelector;
 	return (0, react.useMemo)(() => {
-		return require_getDictionary.getDictionary(dictionary, locale ?? currentLocale);
+		if (isSelector) return require_getDictionary.getDictionary(dictionary, {
+			...localeOrSelector,
+			locale: localeOrSelector.locale ?? currentLocale
+		});
+		return require_getDictionary.getDictionary(dictionary, localeOrSelector ?? currentLocale);
 	}, [
 		dictionary.key,
 		currentLocale,
-		locale
+		localeOrSelectorIdentity
 	]);
 };
 

package/dist/cjs/client/useDictionary.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useDictionary.cjs","names":["IntlayerClientContext","getDictionary"],"sources":["../../../src/client/useDictionary.ts"],"sourcesContent":["'use client';\n\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { useContext, useMemo } from 'react';\nimport { getDictionary } from '../getDictionary';\nimport { IntlayerClientContext } from './IntlayerProvider';\n\n/**\n * On the server side, Hook that transform a dictionary and return the content\n *\n * If the locale is not provided, it will use the locale from the client context\n */\nexport const useDictionary = <\n  const T extends Dictionary,\n  const L extends LocalesValues = DeclaredLocales,\n>(\n  dictionary: T,\n  locale?: L\n) => {\n  const { locale: currentLocale } = useContext(IntlayerClientContext) ?? {};\n\n  return useMemo(() => {\n    const localeTarget = locale ?? currentLocale;\n\n    return getDictionary<T, L>(dictionary, localeTarget as L);\n  }, [dictionary.key, currentLocale, locale]);\n};\n"],"mappings":";;;;;;;;;;;;;;AAgBA,MAAa,iBAIX,YACA,WACG;CACH,MAAM,EAAE,QAAQ,wCAA6BA,sDAAsB,IAAI,EAAE;AAEzE,iCAAqB;AAGnB,SAAOC,oCAAoB,YAFN,UAAU,cAE0B;IACxD;EAAC,WAAW;EAAK;EAAe;EAAO,CAAC"}
+{"version":3,"file":"useDictionary.cjs","names":["IntlayerClientContext","getDictionary"],"sources":["../../../src/client/useDictionary.ts"],"sourcesContent":["'use client';\n\nimport { getDictionarySelectorCacheKey } from '@intlayer/core/dictionaryManipulator';\nimport type {\n  Dictionary,\n  DictionarySelectorForGroup,\n  QualifiedDictionaryGroup,\n} from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { useContext, useMemo } from 'react';\nimport { getDictionary } from '../getDictionary';\nimport { IntlayerClientContext } from './IntlayerProvider';\n\n/**\n * Client-side hook that transforms a dictionary (or qualified dictionary\n * group) and returns the content.\n *\n * If the locale is not provided (directly or through the selector), it will\n * use the locale from the client context.\n */\nexport const useDictionary = <\n  const T extends Dictionary | QualifiedDictionaryGroup,\n  const A extends\n    | LocalesValues\n    | DictionarySelectorForGroup<T> = DeclaredLocales,\n>(\n  dictionary: T,\n  localeOrSelector?: A\n) => {\n  const { locale: currentLocale } = useContext(IntlayerClientContext) ?? {};\n\n  const isSelector =\n    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    typeof localeOrSelector === 'object' &&\n    localeOrSelector !== null;\n\n  // Stable identity of the second argument for memoization\n  const localeOrSelectorIdentity = isSelector\n    ? `${localeOrSelector.locale ?? ''}|${getDictionarySelectorCacheKey(localeOrSelector)}`\n    : localeOrSelector;\n\n  return useMemo(() => {\n    if (isSelector) {\n      return getDictionary(dictionary, {\n        ...localeOrSelector,\n        locale: localeOrSelector.locale ?? currentLocale,\n      } as A);\n    }\n\n    const localeTarget = (localeOrSelector ?? currentLocale) as A;\n\n    return getDictionary<T, A>(dictionary, localeTarget);\n  }, [dictionary.key, currentLocale, localeOrSelectorIdentity]);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAuBA,MAAa,iBAMX,YACA,qBACG;CACH,MAAM,EAAE,QAAQ,wCAA6BA,sDAAsB,IAAI,EAAE;CAEzE,MAAM,aACJ,QAAQ,IAAI,iCAAiC,WAC7C,OAAO,qBAAqB,YAC5B,qBAAqB;CAGvB,MAAM,2BAA2B,aAC7B,GAAG,iBAAiB,UAAU,GAAG,2EAAiC,iBAAiB,KACnF;AAEJ,iCAAqB;AACnB,MAAI,WACF,QAAOC,oCAAc,YAAY;GAC/B,GAAG;GACH,QAAQ,iBAAiB,UAAU;GACpC,CAAM;AAKT,SAAOA,oCAAoB,YAFL,oBAAoB,cAEU;IACnD;EAAC,WAAW;EAAK;EAAe;EAAyB,CAAC"}

package/dist/cjs/client/useDictionaryDynamic.cjs

@@ -3,21 +3,41 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_client_useLoadDynamic = require('./useLoadDynamic.cjs');
+const require_getDictionary = require('../getDictionary.cjs');
 const require_client_IntlayerProvider = require('./IntlayerProvider.cjs');
-const require_client_useDictionary = require('./useDictionary.cjs');
 let _intlayer_config_built = require("@intlayer/config/built");
 let react = require("react");
+let _intlayer_core_dictionaryManipulator = require("@intlayer/core/dictionaryManipulator");
 
 //#region src/client/useDictionaryDynamic.ts
 /**
-* On the server side, Hook that transform a dictionary and return the content
+* Client-side hook that lazily loads a dictionary and returns its content.
 *
-* If the locale is not provided, it will use the locale from the client context
+* The dictionary entry is either a plain dynamic loader map
+* (`locale → loader`) or a qualified one (`locale → qualifierId → loader`,
+* tagged with the qualifier dimension). For qualified maps, only the chunk(s)
+* the selector targets are loaded; the resolution mirrors static mode.
+*
+* If the locale is not provided (directly or through the selector), the client
+* context locale is used.
 */
-const useDictionaryDynamic = (dictionaryPromise, key, locale) => {
+const useDictionaryDynamic = (dictionaryPromise, key, localeOrSelector) => {
 	const { locale: currentLocale } = (0, react.useContext)(require_client_IntlayerProvider.IntlayerClientContext) ?? {};
-	const localeTarget = (0, react.useMemo)(() => locale ?? currentLocale ?? _intlayer_config_built.internationalization.defaultLocale, [currentLocale, locale]);
-	return require_client_useDictionary.useDictionary(require_client_useLoadDynamic.useLoadDynamic(`${String(key)}.${localeTarget}`, dictionaryPromise[localeTarget]?.()), localeTarget);
+	const { locale: selectorLocale, selector } = process.env.INTLAYER_DICTIONARY_SELECTOR !== "false" ? (0, _intlayer_core_dictionaryManipulator.parseDictionarySelector)(localeOrSelector) : {
+		locale: localeOrSelector,
+		selector: void 0
+	};
+	const localeTarget = selectorLocale ?? currentLocale ?? _intlayer_config_built.internationalization.defaultLocale;
+	if (process.env.INTLAYER_DICTIONARY_SELECTOR !== "false" && (0, _intlayer_core_dictionaryManipulator.isQualifiedDynamicLoaderMap)(dictionaryPromise)) return (0, _intlayer_core_dictionaryManipulator.resolveQualifiedDynamicContent)({
+		loaderMap: dictionaryPromise,
+		key: String(key),
+		locale: localeTarget,
+		selector,
+		loadChunk: (cacheKey, promise) => require_client_useLoadDynamic.useLoadDynamic(cacheKey, promise),
+		transform: (dictionary) => require_getDictionary.getDictionary(dictionary, localeTarget)
+	});
+	const plainLoaders = dictionaryPromise;
+	return require_getDictionary.getDictionary(require_client_useLoadDynamic.useLoadDynamic(`${String(key)}.${localeTarget}`, plainLoaders[localeTarget]?.()), localeTarget);
 };
 
 //#endregion

package/dist/cjs/client/useDictionaryDynamic.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useDictionaryDynamic.cjs","names":["IntlayerClientContext","internationalization","useDictionary","useLoadDynamic"],"sources":["../../../src/client/useDictionaryDynamic.ts"],"sourcesContent":["'use client';\n\nimport { internationalization } from '@intlayer/config/built';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { useContext, useMemo } from 'react';\nimport { IntlayerClientContext } from './IntlayerProvider';\nimport { useDictionary } from './useDictionary';\nimport { useLoadDynamic } from './useLoadDynamic';\n\n/**\n * On the server side, Hook that transform a dictionary and return the content\n *\n * If the locale is not provided, it will use the locale from the client context\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const K extends DictionaryKeys,\n>(\n  dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>,\n  key: K,\n  locale?: LocalesValues\n) => {\n  const { locale: currentLocale } = useContext(IntlayerClientContext) ?? {};\n  const localeTarget = useMemo(\n    () => locale ?? currentLocale ?? internationalization.defaultLocale,\n    [currentLocale, locale]\n  );\n\n  const dictionary = useLoadDynamic<T>(\n    `${String(key)}.${localeTarget}`,\n    (dictionaryPromise as any)[localeTarget]?.()\n  ) as T;\n\n  return useDictionary(dictionary, localeTarget);\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAmBA,MAAa,wBAIX,mBACA,KACA,WACG;CACH,MAAM,EAAE,QAAQ,wCAA6BA,sDAAsB,IAAI,EAAE;CACzE,MAAM,wCACE,UAAU,iBAAiBC,4CAAqB,eACtD,CAAC,eAAe,OAAO,CACxB;AAOD,QAAOC,2CALYC,6CACjB,GAAG,OAAO,IAAI,CAAC,GAAG,gBACjB,kBAA0B,iBAAiB,CAGf,EAAE,aAAa"}
+{"version":3,"file":"useDictionaryDynamic.cjs","names":["IntlayerClientContext","internationalization","loadDynamicChunk","getDictionary"],"sources":["../../../src/client/useDictionaryDynamic.ts"],"sourcesContent":["'use client';\n\nimport { internationalization } from '@intlayer/config/built';\nimport {\n  isQualifiedDynamicLoaderMap,\n  parseDictionarySelector,\n  type QualifiedDynamicLoaderMap,\n  resolveQualifiedDynamicContent,\n} from '@intlayer/core/dictionaryManipulator';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DictionaryKeys,\n  DictionarySelectorForKey,\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { useContext } from 'react';\nimport { getDictionary } from '../getDictionary';\nimport { IntlayerClientContext } from './IntlayerProvider';\n// `useLoadDynamic` is a suspender cache, not a React hook — aliased to a\n// non-hook name so it can be invoked in loops / conditionally (e.g. when a\n// collection loads several chunks at once).\nimport { useLoadDynamic as loadDynamicChunk } from './useLoadDynamic';\n\n/**\n * Client-side hook that lazily loads a dictionary and returns its content.\n *\n * The dictionary entry is either a plain dynamic loader map\n * (`locale → loader`) or a qualified one (`locale → qualifierId → loader`,\n * tagged with the qualifier dimension). For qualified maps, only the chunk(s)\n * the selector targets are loaded; the resolution mirrors static mode.\n *\n * If the locale is not provided (directly or through the selector), the client\n * context locale is used.\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const K extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<K> = LocalesValues,\n>(\n  dictionaryPromise:\n    | StrictModeLocaleMap<() => Promise<T>>\n    | QualifiedDynamicLoaderMap,\n  key: K,\n  localeOrSelector?: A\n) => {\n  const { locale: currentLocale } = useContext(IntlayerClientContext) ?? {};\n\n  const { locale: selectorLocale, selector } =\n    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false'\n      ? parseDictionarySelector<LocalesValues>(localeOrSelector)\n      : {\n          locale: localeOrSelector as LocalesValues | undefined,\n          selector: undefined,\n        };\n\n  const localeTarget =\n    selectorLocale ?? currentLocale ?? internationalization.defaultLocale;\n\n  if (\n    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    isQualifiedDynamicLoaderMap(dictionaryPromise)\n  ) {\n    return resolveQualifiedDynamicContent({\n      loaderMap: dictionaryPromise,\n      key: String(key),\n      locale: localeTarget,\n      selector,\n      loadChunk: (cacheKey, promise) => loadDynamicChunk(cacheKey, promise),\n      transform: (dictionary) => getDictionary(dictionary, localeTarget),\n    });\n  }\n\n  const plainLoaders = dictionaryPromise as StrictModeLocaleMap<\n    () => Promise<T>\n  >;\n\n  const dictionary = loadDynamicChunk<T>(\n    `${String(key)}.${localeTarget}`,\n    plainLoaders[localeTarget as keyof typeof plainLoaders]?.() as Promise<T>\n  );\n\n  return getDictionary(dictionary, localeTarget);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAmCA,MAAa,wBAKX,mBAGA,KACA,qBACG;CACH,MAAM,EAAE,QAAQ,wCAA6BA,sDAAsB,IAAI,EAAE;CAEzE,MAAM,EAAE,QAAQ,gBAAgB,aAC9B,QAAQ,IAAI,iCAAiC,4EACF,iBAAiB,GACxD;EACE,QAAQ;EACR,UAAU;EACX;CAEP,MAAM,eACJ,kBAAkB,iBAAiBC,4CAAqB;AAE1D,KACE,QAAQ,IAAI,iCAAiC,iFACjB,kBAAkB,CAE9C,iFAAsC;EACpC,WAAW;EACX,KAAK,OAAO,IAAI;EAChB,QAAQ;EACR;EACA,YAAY,UAAU,YAAYC,6CAAiB,UAAU,QAAQ;EACrE,YAAY,eAAeC,oCAAc,YAAY,aAAa;EACnE,CAAC;CAGJ,MAAM,eAAe;AASrB,QAAOA,oCALYD,6CACjB,GAAG,OAAO,IAAI,CAAC,GAAG,gBAClB,aAAa,iBAA8C,CAG9B,EAAE,aAAa"}

package/dist/cjs/client/useIntlayer.cjs

@@ -5,16 +5,20 @@ const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_getIntlayer = require('../getIntlayer.cjs');
 const require_client_IntlayerProvider = require('./IntlayerProvider.cjs');
 let react = require("react");
+let _intlayer_core_dictionaryManipulator = require("@intlayer/core/dictionaryManipulator");
 
 //#region src/client/useIntlayer.ts
 /**
 * Client-side hook that picks one dictionary by its key and returns its content.
 *
-* If the locale is not provided, it will use the locale from the client context.
+* The second argument is either a locale or a selector object:
+* - `{ item: 2 }` — collection item (omit `item` to get every item as array)
+* - `{ variant: 'black-friday' }` — named variant (omit for the `default` one)
+* - `locale` composes with any selector and overrides the context locale
 *
 * @param key - The unique key of the dictionary to retrieve.
-* @param locale - Optional locale to override the current context locale.
-* @returns The dictionary content for the specified locale.
+* @param localeOrSelector - Optional locale or selector.
+* @returns The dictionary content for the resolved entry and locale.
 *
 * @example
 * ```tsx
@@ -22,19 +26,25 @@ let react = require("react");
 *
 * const MyComponent = () => {
 *   const content = useIntlayer('my-dictionary-key');
+*   const faq2 = useIntlayer('faq', { item: 2 });
 *
 *   return <div>{content.myField.value}</div>;
 * };
 * ```
 */
-const useIntlayer = (key, locale) => {
+const useIntlayer = (key, localeOrSelector) => {
 	const { locale: currentLocale } = (0, react.useContext)(require_client_IntlayerProvider.IntlayerClientContext) ?? {};
+	const isSelector = process.env.INTLAYER_DICTIONARY_SELECTOR !== "false" && typeof localeOrSelector === "object" && localeOrSelector !== null;
 	return (0, react.useMemo)(() => {
-		return require_getIntlayer.getIntlayer(key, locale ?? currentLocale);
+		if (isSelector) return require_getIntlayer.getIntlayer(key, {
+			...localeOrSelector,
+			locale: localeOrSelector.locale ?? currentLocale
+		});
+		return require_getIntlayer.getIntlayer(key, localeOrSelector ?? currentLocale);
 	}, [
 		key,
 		currentLocale,
-		locale
+		isSelector ? `${localeOrSelector.locale ?? ""}|${(0, _intlayer_core_dictionaryManipulator.getDictionarySelectorCacheKey)(localeOrSelector)}` : localeOrSelector
 	]);
 };
 

package/dist/cjs/client/useIntlayer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useIntlayer.cjs","names":["IntlayerClientContext","getIntlayer"],"sources":["../../../src/client/useIntlayer.ts"],"sourcesContent":["'use client';\n\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { useContext, useMemo } from 'react';\nimport { getIntlayer } from '../getIntlayer';\nimport { IntlayerClientContext } from './IntlayerProvider';\n\n/**\n * Client-side hook that picks one dictionary by its key and returns its content.\n *\n * If the locale is not provided, it will use the locale from the client context.\n *\n * @param key - The unique key of the dictionary to retrieve.\n * @param locale - Optional locale to override the current context locale.\n * @returns The dictionary content for the specified locale.\n *\n * @example\n * ```tsx\n * import { useIntlayer } from 'react-intlayer';\n *\n * const MyComponent = () => {\n *   const content = useIntlayer('my-dictionary-key');\n *\n *   return <div>{content.myField.value}</div>;\n * };\n * ```\n */\nexport const useIntlayer = <\n  const T extends DictionaryKeys,\n  const L extends LocalesValues = DeclaredLocales,\n>(\n  key: T,\n  locale?: L\n) => {\n  const { locale: currentLocale } = useContext(IntlayerClientContext) ?? {};\n\n  return useMemo(() => {\n    const localeTarget = locale ?? (currentLocale as L);\n\n    return getIntlayer<T, L>(key, localeTarget);\n  }, [key, currentLocale, locale]);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,eAIX,KACA,WACG;CACH,MAAM,EAAE,QAAQ,wCAA6BA,sDAAsB,IAAI,EAAE;AAEzE,iCAAqB;AAGnB,SAAOC,gCAAkB,KAFJ,UAAW,cAEW;IAC1C;EAAC;EAAK;EAAe;EAAO,CAAC"}
+{"version":3,"file":"useIntlayer.cjs","names":["IntlayerClientContext","getIntlayer"],"sources":["../../../src/client/useIntlayer.ts"],"sourcesContent":["'use client';\n\nimport { getDictionarySelectorCacheKey } from '@intlayer/core/dictionaryManipulator';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionarySelectorForKey,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { useContext, useMemo } from 'react';\nimport { getIntlayer } from '../getIntlayer';\nimport { IntlayerClientContext } from './IntlayerProvider';\n\n/**\n * Client-side hook that picks one dictionary by its key and returns its content.\n *\n * The second argument is either a locale or a selector object:\n * - `{ item: 2 }` — collection item (omit `item` to get every item as array)\n * - `{ variant: 'black-friday' }` — named variant (omit for the `default` one)\n * - `locale` composes with any selector and overrides the context locale\n *\n * @param key - The unique key of the dictionary to retrieve.\n * @param localeOrSelector - Optional locale or selector.\n * @returns The dictionary content for the resolved entry and locale.\n *\n * @example\n * ```tsx\n * import { useIntlayer } from 'react-intlayer';\n *\n * const MyComponent = () => {\n *   const content = useIntlayer('my-dictionary-key');\n *   const faq2 = useIntlayer('faq', { item: 2 });\n *\n *   return <div>{content.myField.value}</div>;\n * };\n * ```\n */\nexport const useIntlayer = <\n  const T extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<T> = DeclaredLocales,\n>(\n  key: T,\n  localeOrSelector?: A\n) => {\n  const { locale: currentLocale } = useContext(IntlayerClientContext) ?? {};\n\n  const isSelector =\n    process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false' &&\n    typeof localeOrSelector === 'object' &&\n    localeOrSelector !== null;\n\n  // Stable identity of the second argument for memoization\n  const localeOrSelectorIdentity = isSelector\n    ? `${localeOrSelector.locale ?? ''}|${getDictionarySelectorCacheKey(localeOrSelector)}`\n    : localeOrSelector;\n\n  return useMemo(() => {\n    if (isSelector) {\n      return getIntlayer(key, {\n        ...localeOrSelector,\n        locale: localeOrSelector.locale ?? currentLocale,\n      } as A);\n    }\n\n    const localeTarget = (localeOrSelector ?? currentLocale) as A;\n\n    return getIntlayer<T, A>(key, localeTarget);\n  }, [key, currentLocale, localeOrSelectorIdentity]);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAa,eAIX,KACA,qBACG;CACH,MAAM,EAAE,QAAQ,wCAA6BA,sDAAsB,IAAI,EAAE;CAEzE,MAAM,aACJ,QAAQ,IAAI,iCAAiC,WAC7C,OAAO,qBAAqB,YAC5B,qBAAqB;AAOvB,iCAAqB;AACnB,MAAI,WACF,QAAOC,gCAAY,KAAK;GACtB,GAAG;GACH,QAAQ,iBAAiB,UAAU;GACpC,CAAM;AAKT,SAAOA,gCAAkB,KAFH,oBAAoB,cAEC;IAC1C;EAAC;EAAK;EAfwB,aAC7B,GAAG,iBAAiB,UAAU,GAAG,2EAAiC,iBAAiB,KACnF;EAa6C,CAAC"}

package/dist/cjs/client/usePathname.cjs

@@ -0,0 +1,41 @@
+'use client';
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let react = require("react");
+let _intlayer_core_localization = require("@intlayer/core/localization");
+
+//#region src/client/usePathname.ts
+/**
+* React hook that returns the current pathname with the locale segment removed.
+*
+* Reacts to browser back/forward navigation via the `popstate` event.
+* Falls back to an empty string during server-side rendering.
+*
+* @returns The current pathname without the locale prefix.
+*
+* @example
+* ```tsx
+* import { usePathname } from 'react-intlayer';
+*
+* const NavItem = ({ href }: { href: string }) => {
+*   const pathname = usePathname();
+*   return <a className={pathname === href ? 'active' : ''}>{href}</a>;
+* };
+* ```
+*/
+const usePathname = () => {
+	const [rawPathname, setRawPathname] = (0, react.useState)(typeof window !== "undefined" ? window.location.pathname : "");
+	(0, react.useEffect)(() => {
+		const handleLocationChange = () => {
+			setRawPathname(window.location.pathname);
+		};
+		window.addEventListener("popstate", handleLocationChange);
+		return () => window.removeEventListener("popstate", handleLocationChange);
+	}, []);
+	return (0, react.useMemo)(() => (0, _intlayer_core_localization.getPathWithoutLocale)(rawPathname), [rawPathname]);
+};
+
+//#endregion
+exports.usePathname = usePathname;
+//# sourceMappingURL=usePathname.cjs.map

package/dist/cjs/client/usePathname.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePathname.cjs","names":[],"sources":["../../../src/client/usePathname.ts"],"sourcesContent":["'use client';\n\nimport { getPathWithoutLocale } from '@intlayer/core/localization';\nimport { useEffect, useMemo, useState } from 'react';\n\n/**\n * React hook that returns the current pathname with the locale segment removed.\n *\n * Reacts to browser back/forward navigation via the `popstate` event.\n * Falls back to an empty string during server-side rendering.\n *\n * @returns The current pathname without the locale prefix.\n *\n * @example\n * ```tsx\n * import { usePathname } from 'react-intlayer';\n *\n * const NavItem = ({ href }: { href: string }) => {\n *   const pathname = usePathname();\n *   return <a className={pathname === href ? 'active' : ''}>{href}</a>;\n * };\n * ```\n */\nexport const usePathname = (): string => {\n  const [rawPathname, setRawPathname] = useState<string>(\n    typeof window !== 'undefined' ? window.location.pathname : ''\n  );\n\n  useEffect(() => {\n    const handleLocationChange = (): void => {\n      setRawPathname(window.location.pathname);\n    };\n\n    window.addEventListener('popstate', handleLocationChange);\n    return () => window.removeEventListener('popstate', handleLocationChange);\n  }, []);\n\n  return useMemo(() => getPathWithoutLocale(rawPathname), [rawPathname]);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,oBAA4B;CACvC,MAAM,CAAC,aAAa,sCAClB,OAAO,WAAW,cAAc,OAAO,SAAS,WAAW,GAC5D;AAED,4BAAgB;EACd,MAAM,6BAAmC;AACvC,kBAAe,OAAO,SAAS,SAAS;;AAG1C,SAAO,iBAAiB,YAAY,qBAAqB;AACzD,eAAa,OAAO,oBAAoB,YAAY,qBAAqB;IACxE,EAAE,CAAC;AAEN,uFAA0C,YAAY,EAAE,CAAC,YAAY,CAAC"}

package/dist/cjs/editor/ContentSelector.cjs

@@ -7,7 +7,7 @@ let _intlayer_editor_isEnabled = require("@intlayer/editor/isEnabled");
 
 //#region src/editor/ContentSelector.tsx
 const ContentSelector = ({ children, dictionaryKey, keyPath }) => {
-	if (process.env["INTLAYER_EDITOR_ENABLED"] === "false" || !_intlayer_editor_isEnabled.isEnabled) return children;
+	if (process.env.INTLAYER_EDITOR_ENABLED === "false" || !_intlayer_editor_isEnabled.isEnabled) return children;
 	return (0, react.createElement)("intlayer-content-selector-wrapper", {
 		"key-path": JSON.stringify(keyPath),
 		"dictionary-key": dictionaryKey

package/dist/cjs/editor/ContentSelector.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ContentSelector.cjs","names":["isEnabled"],"sources":["../../../src/editor/ContentSelector.tsx"],"sourcesContent":["'use client';\n\nimport type { NodeProps } from '@intlayer/core/interpreter';\nimport { isEnabled } from '@intlayer/editor/isEnabled';\nimport { createElement, type FC, type HTMLAttributes } from 'react';\n\nexport type ContentSelectorProps = NodeProps &\n  Omit<HTMLAttributes<HTMLDivElement>, 'children'>;\n\nexport const ContentSelector: FC<ContentSelectorProps> = ({\n  children,\n  dictionaryKey,\n  keyPath,\n}) => {\n  if (process.env['INTLAYER_EDITOR_ENABLED'] === 'false' || !isEnabled) {\n    return children;\n  }\n\n  return createElement(\n    'intlayer-content-selector-wrapper',\n    {\n      'key-path': JSON.stringify(keyPath),\n      'dictionary-key': dictionaryKey,\n    },\n    children\n  );\n};\n"],"mappings":";;;;;;;;AASA,MAAa,mBAA6C,EACxD,UACA,eACA,cACI;AACJ,KAAI,QAAQ,IAAI,+BAA+B,WAAW,CAACA,qCACzD,QAAO;AAGT,iCACE,qCACA;EACE,YAAY,KAAK,UAAU,QAAQ;EACnC,kBAAkB;EACnB,EACD,SACD"}
+{"version":3,"file":"ContentSelector.cjs","names":["isEnabled"],"sources":["../../../src/editor/ContentSelector.tsx"],"sourcesContent":["'use client';\n\nimport type { NodeProps } from '@intlayer/core/interpreter';\nimport { isEnabled } from '@intlayer/editor/isEnabled';\nimport { createElement, type FC, type HTMLAttributes } from 'react';\n\nexport type ContentSelectorProps = NodeProps &\n  Omit<HTMLAttributes<HTMLDivElement>, 'children'>;\n\nexport const ContentSelector: FC<ContentSelectorProps> = ({\n  children,\n  dictionaryKey,\n  keyPath,\n}) => {\n  if (process.env.INTLAYER_EDITOR_ENABLED === 'false' || !isEnabled) {\n    return children;\n  }\n\n  return createElement(\n    'intlayer-content-selector-wrapper',\n    {\n      'key-path': JSON.stringify(keyPath),\n      'dictionary-key': dictionaryKey,\n    },\n    children\n  );\n};\n"],"mappings":";;;;;;;;AASA,MAAa,mBAA6C,EACxD,UACA,eACA,cACI;AACJ,KAAI,QAAQ,IAAI,4BAA4B,WAAW,CAACA,qCACtD,QAAO;AAGT,iCACE,qCACA;EACE,YAAY,KAAK,UAAU,QAAQ;EACnC,kBAAkB;EACnB,EACD,SACD"}

package/dist/cjs/editor/useEditor.cjs

@@ -16,7 +16,7 @@ const useEditor = () => {
 	const { locale } = (0, react.useContext)(require_client_IntlayerProvider.IntlayerClientContext) ?? {};
 	const managerRef = (0, react.useRef)(null);
 	(0, react.useEffect)(() => {
-		if (process.env["INTLAYER_EDITOR_ENABLED"] === "false" || !_intlayer_editor_isEnabled.isEnabled) return;
+		if (process.env.INTLAYER_EDITOR_ENABLED === "false" || !_intlayer_editor_isEnabled.isEnabled) return;
 		import("@intlayer/editor").then(({ initEditorClient }) => {
 			const manager = initEditorClient();
 			managerRef.current = manager;

package/dist/cjs/editor/useEditor.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useEditor.cjs","names":["IntlayerClientContext","isEnabled"],"sources":["../../../src/editor/useEditor.tsx"],"sourcesContent":["'use client';\n\nimport type { EditorStateManager } from '@intlayer/editor';\nimport { isEnabled } from '@intlayer/editor/isEnabled';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { useContext, useEffect, useRef } from 'react';\nimport { IntlayerClientContext } from '../client/IntlayerProvider';\n\n/**\n * Initializes the Intlayer editor client singleton when the editor is enabled.\n * Syncs the current locale from the Intlayer context into the editor manager so\n * the editor always knows which locale the app is displaying.\n */\nexport const useEditor = () => {\n  const { locale } = useContext(IntlayerClientContext) ?? {};\n  const managerRef = useRef<EditorStateManager | null>(null);\n\n  useEffect(() => {\n    if (process.env['INTLAYER_EDITOR_ENABLED'] === 'false' || !isEnabled)\n      return;\n\n    import('@intlayer/editor').then(({ initEditorClient }) => {\n      const manager = initEditorClient();\n      managerRef.current = manager;\n\n      if (locale) manager.currentLocale.set(locale as Locale);\n    });\n\n    return () => {\n      managerRef.current = null;\n      import('@intlayer/editor').then(({ stopEditorClient }) => {\n        stopEditorClient();\n      });\n    };\n  }, []);\n\n  useEffect(() => {\n    if (!locale || !managerRef.current) return;\n\n    managerRef.current.currentLocale.set(locale as Locale);\n  }, [locale]);\n};\n"],"mappings":";;;;;;;;;;;;;;AAaA,MAAa,kBAAkB;CAC7B,MAAM,EAAE,iCAAsBA,sDAAsB,IAAI,EAAE;CAC1D,MAAM,+BAA+C,KAAK;AAE1D,4BAAgB;AACd,MAAI,QAAQ,IAAI,+BAA+B,WAAW,CAACC,qCACzD;AAEF,SAAO,oBAAoB,MAAM,EAAE,uBAAuB;GACxD,MAAM,UAAU,kBAAkB;AAClC,cAAW,UAAU;AAErB,OAAI,OAAQ,SAAQ,cAAc,IAAI,OAAiB;IACvD;AAEF,eAAa;AACX,cAAW,UAAU;AACrB,UAAO,oBAAoB,MAAM,EAAE,uBAAuB;AACxD,sBAAkB;KAClB;;IAEH,EAAE,CAAC;AAEN,4BAAgB;AACd,MAAI,CAAC,UAAU,CAAC,WAAW,QAAS;AAEpC,aAAW,QAAQ,cAAc,IAAI,OAAiB;IACrD,CAAC,OAAO,CAAC"}
+{"version":3,"file":"useEditor.cjs","names":["IntlayerClientContext","isEnabled"],"sources":["../../../src/editor/useEditor.tsx"],"sourcesContent":["'use client';\n\nimport type { EditorStateManager } from '@intlayer/editor';\nimport { isEnabled } from '@intlayer/editor/isEnabled';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport { useContext, useEffect, useRef } from 'react';\nimport { IntlayerClientContext } from '../client/IntlayerProvider';\n\n/**\n * Initializes the Intlayer editor client singleton when the editor is enabled.\n * Syncs the current locale from the Intlayer context into the editor manager so\n * the editor always knows which locale the app is displaying.\n */\nexport const useEditor = () => {\n  const { locale } = useContext(IntlayerClientContext) ?? {};\n  const managerRef = useRef<EditorStateManager | null>(null);\n\n  useEffect(() => {\n    if (process.env.INTLAYER_EDITOR_ENABLED === 'false' || !isEnabled) return;\n\n    import('@intlayer/editor').then(({ initEditorClient }) => {\n      const manager = initEditorClient();\n      managerRef.current = manager;\n\n      if (locale) manager.currentLocale.set(locale as Locale);\n    });\n\n    return () => {\n      managerRef.current = null;\n      import('@intlayer/editor').then(({ stopEditorClient }) => {\n        stopEditorClient();\n      });\n    };\n  }, []);\n\n  useEffect(() => {\n    if (!locale || !managerRef.current) return;\n\n    managerRef.current.currentLocale.set(locale as Locale);\n  }, [locale]);\n};\n"],"mappings":";;;;;;;;;;;;;;AAaA,MAAa,kBAAkB;CAC7B,MAAM,EAAE,iCAAsBA,sDAAsB,IAAI,EAAE;CAC1D,MAAM,+BAA+C,KAAK;AAE1D,4BAAgB;AACd,MAAI,QAAQ,IAAI,4BAA4B,WAAW,CAACC,qCAAW;AAEnE,SAAO,oBAAoB,MAAM,EAAE,uBAAuB;GACxD,MAAM,UAAU,kBAAkB;AAClC,cAAW,UAAU;AAErB,OAAI,OAAQ,SAAQ,cAAc,IAAI,OAAiB;IACvD;AAEF,eAAa;AACX,cAAW,UAAU;AACrB,UAAO,oBAAoB,MAAM,EAAE,uBAAuB;AACxD,sBAAkB;KAClB;;IAEH,EAAE,CAAC;AAEN,4BAAgB;AACd,MAAI,CAAC,UAAU,CAAC,WAAW,QAAS;AAEpC,aAAW,QAAQ,cAAc,IAAI,OAAiB;IACrD,CAAC,OAAO,CAAC"}

package/dist/cjs/getDictionary.cjs

@@ -4,7 +4,14 @@ const require_plugins = require('./plugins.cjs');
 let _intlayer_core_interpreter = require("@intlayer/core/interpreter");
 
 //#region src/getDictionary.ts
-const getDictionary = (dictionary, locale) => (0, _intlayer_core_interpreter.getDictionary)(dictionary, locale, require_plugins.getPlugins(locale));
+/**
+* Transforms a dictionary (or qualified dictionary group) and returns its
+* content for the given locale or selector (`{ item }`, `{ variant }`,
+* optionally combined with `locale`).
+*/
+const getDictionary = (dictionary, localeOrSelector) => {
+	return (0, _intlayer_core_interpreter.getDictionary)(dictionary, localeOrSelector, require_plugins.getPlugins(typeof localeOrSelector === "object" && localeOrSelector !== null ? localeOrSelector.locale : localeOrSelector));
+};
 
 //#endregion
 exports.getDictionary = getDictionary;

package/dist/cjs/getDictionary.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getDictionary.cjs","names":["getPlugins"],"sources":["../../src/getDictionary.ts"],"sourcesContent":["import { getDictionary as getDictionaryCore } from '@intlayer/core/interpreter';\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { type DeepTransformContent, getPlugins } from './plugins';\n\nexport const getDictionary = <\n  const T extends Dictionary,\n  const L extends LocalesValues = DeclaredLocales,\n>(\n  dictionary: T,\n  locale?: L\n): DeepTransformContent<T['content'], L> =>\n  getDictionaryCore(dictionary, locale, getPlugins(locale)) as any;\n"],"mappings":";;;;;;AAQA,MAAa,iBAIX,YACA,yDAEkB,YAAY,QAAQA,2BAAW,OAAO,CAAC"}
+{"version":3,"file":"getDictionary.cjs","names":["getPlugins"],"sources":["../../src/getDictionary.ts"],"sourcesContent":["import { getDictionary as getDictionaryCore } from '@intlayer/core/interpreter';\nimport type {\n  Dictionary,\n  DictionarySelectorForGroup,\n  QualifiedDictionaryGroup,\n  ResolveQualifiedDictionaryContent,\n} from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  ExtractSelectorLocale,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { type DeepTransformContent, getPlugins } from './plugins';\n\n/**\n * Transforms a dictionary (or qualified dictionary group) and returns its\n * content for the given locale or selector (`{ item }`, `{ variant }`,\n * optionally combined with `locale`).\n */\nexport const getDictionary = <\n  const T extends Dictionary | QualifiedDictionaryGroup,\n  const A extends\n    | LocalesValues\n    | DictionarySelectorForGroup<T> = DeclaredLocales,\n>(\n  dictionary: T,\n  localeOrSelector?: A\n): DeepTransformContent<\n  ResolveQualifiedDictionaryContent<T, A>,\n  ExtractSelectorLocale<A>\n> => {\n  const locale = (\n    typeof localeOrSelector === 'object' && localeOrSelector !== null\n      ? localeOrSelector.locale\n      : localeOrSelector\n  ) as LocalesValues | undefined;\n\n  return getDictionaryCore(\n    dictionary,\n    localeOrSelector,\n    getPlugins(locale)\n  ) as any;\n};\n"],"mappings":";;;;;;;;;;;AAmBA,MAAa,iBAMX,YACA,qBAIG;AAOH,sDACE,YACA,kBACAA,2BARA,OAAO,qBAAqB,YAAY,qBAAqB,OACzD,iBAAiB,SACjB,iBAMc,CACnB"}

package/dist/cjs/getIntlayer.cjs

@@ -4,7 +4,14 @@ const require_plugins = require('./plugins.cjs');
 let _intlayer_core_interpreter = require("@intlayer/core/interpreter");
 
 //#region src/getIntlayer.ts
-const getIntlayer = (key, locale) => (0, _intlayer_core_interpreter.getIntlayer)(key, locale, require_plugins.getPlugins(locale));
+/**
+* Picks one dictionary by its key and returns its content for the given
+* locale or selector (`{ item }`, `{ variant }`,
+* optionally combined with `locale`).
+*/
+const getIntlayer = (key, localeOrSelector) => {
+	return (0, _intlayer_core_interpreter.getIntlayer)(key, localeOrSelector, require_plugins.getPlugins(typeof localeOrSelector === "object" && localeOrSelector !== null ? localeOrSelector.locale : localeOrSelector));
+};
 
 //#endregion
 exports.getIntlayer = getIntlayer;

package/dist/cjs/getIntlayer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getIntlayer.cjs","names":["getPlugins"],"sources":["../../src/getIntlayer.ts"],"sourcesContent":["import { getIntlayer as getIntlayerCore } from '@intlayer/core/interpreter';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryContent,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { type DeepTransformContent, getPlugins } from './plugins';\n\nexport const getIntlayer = <\n  const T extends DictionaryKeys,\n  const L extends LocalesValues = DeclaredLocales,\n>(\n  key: T,\n  locale?: L\n): DeepTransformContent<DictionaryRegistryContent<T>, L> =>\n  getIntlayerCore(key, locale, getPlugins(locale)) as any;\n"],"mappings":";;;;;;AASA,MAAa,eAIX,KACA,uDAEgB,KAAK,QAAQA,2BAAW,OAAO,CAAC"}
+{"version":3,"file":"getIntlayer.cjs","names":["getPlugins"],"sources":["../../src/getIntlayer.ts"],"sourcesContent":["import { getIntlayer as getIntlayerCore } from '@intlayer/core/interpreter';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryResult,\n  DictionarySelectorForKey,\n  ExtractSelectorLocale,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { type DeepTransformContent, getPlugins } from './plugins';\n\n/**\n * Picks one dictionary by its key and returns its content for the given\n * locale or selector (`{ item }`, `{ variant }`,\n * optionally combined with `locale`).\n */\nexport const getIntlayer = <\n  const T extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelectorForKey<T> = DeclaredLocales,\n>(\n  key: T,\n  localeOrSelector?: A\n): DeepTransformContent<\n  DictionaryRegistryResult<T, A>,\n  ExtractSelectorLocale<A>\n> => {\n  const locale = (\n    typeof localeOrSelector === 'object' && localeOrSelector !== null\n      ? localeOrSelector.locale\n      : localeOrSelector\n  ) as LocalesValues | undefined;\n\n  return getIntlayerCore(key, localeOrSelector, getPlugins(locale)) as any;\n};\n"],"mappings":";;;;;;;;;;;AAgBA,MAAa,eAIX,KACA,qBAIG;AAOH,oDAAuB,KAAK,kBAAkBA,2BAL5C,OAAO,qBAAqB,YAAY,qBAAqB,OACzD,iBAAiB,SACjB,iBAG0D,CAAC"}

package/dist/cjs/plugins.cjs

@@ -13,8 +13,8 @@ let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 
 //#region src/plugins.tsx
-const markdownRendererModulePromise = process.env["INTLAYER_NODE_TYPE_MARKDOWN"] !== "false" ? Promise.resolve().then(() => require("./markdown/MarkdownRendererPlugin.cjs")).then((m) => m.MarkdownRendererPlugin) : null;
-const htmlRendererModulePromise = process.env["INTLAYER_NODE_TYPE_HTML"] !== "false" ? Promise.resolve().then(() => require("./html/HTMLRendererPlugin.cjs")).then((m) => m.HTMLRendererPlugin) : null;
+const markdownRendererModulePromise = process.env.INTLAYER_NODE_TYPE_MARKDOWN !== "false" ? Promise.resolve().then(() => require("./markdown/MarkdownRendererPlugin.cjs")).then((m) => m.MarkdownRendererPlugin) : null;
+const htmlRendererModulePromise = process.env.INTLAYER_NODE_TYPE_HTML !== "false" ? Promise.resolve().then(() => require("./html/HTMLRendererPlugin.cjs")).then((m) => m.HTMLRendererPlugin) : null;
 /** Translation plugin. Replaces node with a locale string if nodeType = Translation. */
 const intlayerNodePlugins = {
 	id: "intlayer-node-plugin",
@@ -22,20 +22,20 @@ const intlayerNodePlugins = {
 	transform: (_node, { plugins, ...rest }) => require_IntlayerNode.renderIntlayerNode({
 		...rest,
 		value: rest.children,
-		children: process.env["INTLAYER_EDITOR_ENABLED"] !== "false" && _intlayer_config_built.editor.enabled ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_editor_ContentSelector.ContentSelector, {
+		children: process.env.INTLAYER_EDITOR_ENABLED !== "false" && _intlayer_config_built.editor.enabled ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_editor_ContentSelector.ContentSelector, {
 			...rest,
 			children: rest.children
 		}) : rest.children
 	})
 };
 /** Translation plugin. Replaces node with a locale string if nodeType = Translation. */
-const reactNodePlugins = process.env["INTLAYER_NODE_TYPE_REACT_NODE"] === "false" ? _intlayer_core_interpreter.fallbackPlugin : {
+const reactNodePlugins = process.env.INTLAYER_NODE_TYPE_REACT_NODE === "false" ? _intlayer_core_interpreter.fallbackPlugin : {
 	id: "react-node-plugin",
 	canHandle: (node) => typeof node === "object" && typeof node?.props !== "undefined" && typeof node.key !== "undefined",
 	transform: (node, { plugins, ...rest }) => require_IntlayerNode.renderIntlayerNode({
 		...rest,
 		value: "[[react-element]]",
-		children: process.env["INTLAYER_EDITOR_ENABLED"] !== "false" && _intlayer_config_built.editor.enabled ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_editor_ContentSelector.ContentSelector, {
+		children: process.env.INTLAYER_EDITOR_ENABLED !== "false" && _intlayer_config_built.editor.enabled ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_editor_ContentSelector.ContentSelector, {
 			...rest,
 			children: require_reactElement_renderReactElement.renderReactElement(node)
 		}) : require_reactElement_renderReactElement.renderReactElement(node)
@@ -50,7 +50,7 @@ const splitAndJoinInsertion = (template, values) => {
 	return (0, react.createElement)(react.Fragment, null, ...result.parts.map((part, index) => (0, react.createElement)(react.Fragment, { key: index }, part)));
 };
 /** Insertion plugin for React. Handles component/node insertion. */
-const insertionPlugin = process.env["INTLAYER_NODE_TYPE_INSERTION"] === "false" ? _intlayer_core_interpreter.fallbackPlugin : {
+const insertionPlugin = process.env.INTLAYER_NODE_TYPE_INSERTION === "false" ? _intlayer_core_interpreter.fallbackPlugin : {
 	id: "insertion-plugin",
 	canHandle: (node) => typeof node === "object" && node?.nodeType === _intlayer_types_nodeType.INSERTION,
 	transform: (node, props, deepTransformNode) => {
@@ -97,7 +97,7 @@ const MarkdownSuspenseRenderer = ({ children, ...props }) => {
 	});
 };
 /** Markdown string plugin. Replaces string node with a component that render the markdown. */
-const markdownStringPlugin = process.env["INTLAYER_NODE_TYPE_MARKDOWN"] === "false" ? _intlayer_core_interpreter.fallbackPlugin : {
+const markdownStringPlugin = process.env.INTLAYER_NODE_TYPE_MARKDOWN === "false" ? _intlayer_core_interpreter.fallbackPlugin : {
 	id: "markdown-string-plugin",
 	canHandle: (node) => typeof node === "string",
 	transform: (node, props, deepTransformNode) => {
@@ -109,7 +109,7 @@ const markdownStringPlugin = process.env["INTLAYER_NODE_TYPE_MARKDOWN"] === "fal
 				transform: (metadataNode, props) => require_IntlayerNode.renderIntlayerNode({
 					...props,
 					value: metadataNode,
-					children: process.env["INTLAYER_EDITOR_ENABLED"] !== "false" && _intlayer_config_built.editor.enabled ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_editor_ContentSelector.ContentSelector, {
+					children: process.env.INTLAYER_EDITOR_ENABLED !== "false" && _intlayer_config_built.editor.enabled ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_editor_ContentSelector.ContentSelector, {
 						...rest,
 						children: node
 					}) : node
@@ -121,7 +121,7 @@ const markdownStringPlugin = process.env["INTLAYER_NODE_TYPE_MARKDOWN"] === "fal
 		const render = (components) => require_IntlayerNode.renderIntlayerNode({
 			...props,
 			value: node,
-			children: process.env["INTLAYER_EDITOR_ENABLED"] !== "false" && _intlayer_config_built.editor.enabled ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_editor_ContentSelector.ContentSelector, {
+			children: process.env.INTLAYER_EDITOR_ENABLED !== "false" && _intlayer_config_built.editor.enabled ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_editor_ContentSelector.ContentSelector, {
 				...rest,
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MarkdownSuspenseRenderer, {
 					...rest,
@@ -151,7 +151,7 @@ const markdownStringPlugin = process.env["INTLAYER_NODE_TYPE_MARKDOWN"] === "fal
 		} });
 	}
 };
-const markdownPlugin = process.env["INTLAYER_NODE_TYPE_MARKDOWN"] === "false" ? _intlayer_core_interpreter.fallbackPlugin : {
+const markdownPlugin = process.env.INTLAYER_NODE_TYPE_MARKDOWN === "false" ? _intlayer_core_interpreter.fallbackPlugin : {
 	id: "markdown-plugin",
 	canHandle: (node) => typeof node === "object" && node?.nodeType === _intlayer_types_nodeType.MARKDOWN,
 	transform: (node, props, deepTransformNode) => {
@@ -169,7 +169,7 @@ const HTMLSuspenseRenderer = (props) => {
 	return (0, react.createElement)(require_client_useLoadDynamic.useLoadDynamic("html-renderer-plugin", htmlRendererModulePromise), props);
 };
 /** HTML plugin. Replaces node with a function that takes components => ReactNode. */
-const htmlPlugin = process.env["INTLAYER_NODE_TYPE_HTML"] === "false" ? _intlayer_core_interpreter.fallbackPlugin : {
+const htmlPlugin = process.env.INTLAYER_NODE_TYPE_HTML === "false" ? _intlayer_core_interpreter.fallbackPlugin : {
 	id: "html-plugin",
 	canHandle: (node) => typeof node === "object" && node?.nodeType === _intlayer_types_nodeType.HTML,
 	transform: (node, props) => {
@@ -178,7 +178,7 @@ const htmlPlugin = process.env["INTLAYER_NODE_TYPE_HTML"] === "false" ? _intlaye
 		const render = (userComponents) => require_IntlayerNode.renderIntlayerNode({
 			...rest,
 			value: html,
-			children: process.env["INTLAYER_EDITOR_ENABLED"] !== "false" && _intlayer_config_built.editor.enabled ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_editor_ContentSelector.ContentSelector, {
+			children: process.env.INTLAYER_EDITOR_ENABLED !== "false" && _intlayer_config_built.editor.enabled ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_editor_ContentSelector.ContentSelector, {
 				...rest,
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HTMLSuspenseRenderer, {
 					...rest,

package/dist/cjs/plugins.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.cjs","names":["renderIntlayerNode","editor","ContentSelector","fallbackPlugin","renderReactElement","Fragment","NodeTypes","func","useLoadDynamic","internationalization","enumerationPlugin","conditionPlugin","filePlugin","genderPlugin"],"sources":["../../src/plugins.tsx"],"sourcesContent":["import { editor, internationalization } from '@intlayer/config/built';\nimport {\n  conditionPlugin,\n  type DeepTransformContent as DeepTransformContentCore,\n  enumerationPlugin,\n  fallbackPlugin,\n  filePlugin,\n  genderPlugin,\n  type IInterpreterPluginState as IInterpreterPluginStateCore,\n  nestedPlugin,\n  type Plugins,\n  pluralPlugin,\n  splitInsertionTemplate,\n  translationPlugin,\n} from '@intlayer/core/interpreter';\nimport { getMarkdownMetadata } from '@intlayer/core/markdown';\nimport type {\n  HTMLContent,\n  InsertionContent,\n  MarkdownContent,\n} from '@intlayer/core/transpiler';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport {\n  createElement,\n  type FC,\n  Fragment,\n  type ReactElement,\n  type ReactNode,\n} from 'react';\nimport { useLoadDynamic } from './client/useLoadDynamic';\nimport { ContentSelector } from './editor/ContentSelector';\nimport type { HTMLComponents } from './html/HTMLComponentTypes';\nimport { type IntlayerNode, renderIntlayerNode } from './IntlayerNode';\nimport { renderReactElement } from './reactElement/renderReactElement';\n\nconst markdownRendererModulePromise =\n  process.env['INTLAYER_NODE_TYPE_MARKDOWN'] !== 'false'\n    ? import('./markdown/MarkdownRendererPlugin').then(\n        (m) => m.MarkdownRendererPlugin\n      )\n    : null;\n\nconst htmlRendererModulePromise =\n  process.env['INTLAYER_NODE_TYPE_HTML'] !== 'false'\n    ? import('./html/HTMLRendererPlugin').then((m) => m.HTMLRendererPlugin)\n    : null;\n\n/** ---------------------------------------------\n *  INTLAYER NODE PLUGIN\n *  --------------------------------------------- */\n\nexport type IntlayerNodeCond<T> = T extends number | string\n  ? IntlayerNode<T>\n  : never;\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const intlayerNodePlugins: Plugins = {\n  id: 'intlayer-node-plugin',\n  canHandle: (node) =>\n    typeof node === 'bigint' ||\n    typeof node === 'string' ||\n    typeof node === 'number',\n  transform: (\n    _node,\n    {\n      plugins, // Removed to avoid next error - Functions cannot be passed directly to Client Components\n      ...rest\n    }\n  ) =>\n    renderIntlayerNode({\n      ...rest,\n      value: rest.children,\n      children:\n        process.env['INTLAYER_EDITOR_ENABLED'] !== 'false' && editor.enabled ? (\n          <ContentSelector {...rest}>{rest.children}</ContentSelector>\n        ) : (\n          rest.children\n        ),\n    }),\n};\n\n/** ---------------------------------------------\n *  REACT NODE PLUGIN\n *  --------------------------------------------- */\n\nexport type ReactNodeCond<T> = T extends {\n  props: any;\n  key: any;\n}\n  ? ReactNode\n  : never;\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const reactNodePlugins: Plugins =\n  process.env['INTLAYER_NODE_TYPE_REACT_NODE'] === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'react-node-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' &&\n          typeof node?.props !== 'undefined' &&\n          typeof node.key !== 'undefined',\n\n        transform: (\n          node,\n          {\n            plugins, // Removed to avoid next error - Functions cannot be passed directly to Client Components\n            ...rest\n          }\n        ) =>\n          renderIntlayerNode({\n            ...rest,\n            value: '[[react-element]]',\n            children:\n              process.env['INTLAYER_EDITOR_ENABLED'] !== 'false' &&\n              editor.enabled ? (\n                <ContentSelector {...rest}>\n                  {renderReactElement(node)}\n                </ContentSelector>\n              ) : (\n                renderReactElement(node)\n              ),\n          }),\n      };\n\n/** ---------------------------------------------\n *  INSERTION PLUGIN\n *  --------------------------------------------- */\n\nexport type InsertionCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.INSERTION]: infer I;\n  fields: readonly string[];\n}\n  ? <V extends { [K in T['fields'][number]]: ReactNode }>(\n      values: V\n    ) => I extends string\n      ? V[keyof V] extends string | number\n        ? IntlayerNode<string>\n        : IntlayerNode<ReactNode>\n      : DeepTransformContent<I>\n  : never;\n\n/**\n * Split insertion string and join with React nodes using shared core logic\n */\nconst splitAndJoinInsertion = (\n  template: string,\n  values: Record<string, string | number | ReactNode>\n): ReactNode => {\n  const result = splitInsertionTemplate(template, values);\n\n  if (result.isSimple) {\n    // Simple string replacement\n    return result.parts as string;\n  }\n\n  // Return as Fragment with proper keys\n  return createElement(\n    Fragment,\n    null,\n    ...(result.parts as any[]).map((part, index) =>\n      createElement(Fragment, { key: index }, part)\n    )\n  );\n};\n\n/** Insertion plugin for React. Handles component/node insertion. */\nexport const insertionPlugin: Plugins =\n  process.env['INTLAYER_NODE_TYPE_INSERTION'] === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'insertion-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.INSERTION,\n        transform: (node: InsertionContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            {\n              type: NodeTypes.INSERTION,\n            },\n          ];\n\n          const children = node[NodeTypes.INSERTION];\n\n          /** Insertion string plugin. Replaces string node with a component that render the insertion. */\n          const insertionStringPlugin: Plugins = {\n            id: 'insertion-string-plugin',\n            canHandle: (node) => typeof node === 'string',\n            transform: (node: string, subProps, deepTransformNode) => {\n              const transformedResult = deepTransformNode(node, {\n                ...subProps,\n                children: node,\n                plugins: [\n                  ...(props.plugins ?? ([] as Plugins[])).filter(\n                    (plugin) => plugin.id !== 'intlayer-node-plugin'\n                  ),\n                ],\n              });\n\n              return (\n                values: {\n                  [K in InsertionContent['fields'][number]]:\n                    | string\n                    | number\n                    | ReactNode;\n                }\n              ) => {\n                const result = splitAndJoinInsertion(transformedResult, values);\n\n                return deepTransformNode(result, {\n                  ...subProps,\n                  plugins: props.plugins,\n                  children: result,\n                });\n              };\n            },\n          };\n\n          const result = deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [insertionStringPlugin, ...(props.plugins ?? [])],\n          });\n\n          if (\n            typeof children === 'object' &&\n            children !== null &&\n            'nodeType' in children &&\n            [NodeTypes.ENUMERATION, NodeTypes.CONDITION].includes(\n              children.nodeType as\n                | typeof NodeTypes.ENUMERATION\n                | typeof NodeTypes.CONDITION\n            )\n          ) {\n            return (values: any) => (arg: any) => {\n              const func = result as Function;\n              const inner = func(arg);\n\n              if (typeof inner === 'function') {\n                return inner(values);\n              }\n              return inner;\n            };\n          }\n\n          return result;\n        },\n      };\n\n/**\n * MARKDOWN PLUGIN\n */\n\nexport type MarkdownStringCond<T> = T extends string\n  ? IntlayerNode<\n      string,\n      {\n        metadata: DeepTransformContent<string>;\n        use: (components: HTMLComponents<'permissive', {}>) => ReactNode;\n      }\n    >\n  : never;\n\nconst MarkdownSuspenseRenderer: FC<Record<string, any>> = ({\n  children,\n  ...props\n}) => {\n  const MarkdownRendererPlugin = useLoadDynamic(\n    'markdown-renderer-plugin',\n    markdownRendererModulePromise!\n  );\n  return createElement(MarkdownRendererPlugin as any, { ...props, children });\n};\n\n/** Markdown string plugin. Replaces string node with a component that render the markdown. */\nexport const markdownStringPlugin: Plugins =\n  process.env['INTLAYER_NODE_TYPE_MARKDOWN'] === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-string-plugin',\n        canHandle: (node) => typeof node === 'string',\n        transform: (node: string, props, deepTransformNode) => {\n          const {\n            plugins, // Removed to avoid next error - Functions cannot be passed directly to Client Components\n            ...rest\n          } = props;\n\n          const metadata = getMarkdownMetadata(node) ?? {};\n\n          const metadataPlugins: Plugins = {\n            id: 'markdown-metadata-plugin',\n            canHandle: (metadataNode) =>\n              typeof metadataNode === 'string' ||\n              typeof metadataNode === 'number' ||\n              typeof metadataNode === 'boolean' ||\n              !metadataNode,\n            transform: (metadataNode, props) =>\n              renderIntlayerNode({\n                ...props,\n                value: metadataNode,\n                children:\n                  process.env['INTLAYER_EDITOR_ENABLED'] !== 'false' &&\n                  editor.enabled ? (\n                    <ContentSelector {...rest}>{node}</ContentSelector>\n                  ) : (\n                    node\n                  ),\n              }),\n          };\n\n          // Transform metadata while keeping the same structure\n          const metadataNodes = deepTransformNode(metadata, {\n            plugins: [metadataPlugins],\n            dictionaryKey: rest.dictionaryKey,\n            keyPath: [],\n          });\n\n          const render = (components?: HTMLComponents) =>\n            renderIntlayerNode({\n              ...props,\n              value: node,\n              children:\n                process.env['INTLAYER_EDITOR_ENABLED'] !== 'false' &&\n                editor.enabled ? (\n                  <ContentSelector {...rest}>\n                    <MarkdownSuspenseRenderer {...rest} components={components}>\n                      {node}\n                    </MarkdownSuspenseRenderer>\n                  </ContentSelector>\n                ) : (\n                  <MarkdownSuspenseRenderer {...rest} components={components}>\n                    {node}\n                  </MarkdownSuspenseRenderer>\n                ),\n              additionalProps: {\n                metadata: metadataNodes,\n              },\n            });\n\n          const element = render() as unknown as ReactElement;\n\n          return new Proxy(element, {\n            get(target, prop, receiver) {\n              if (prop === 'value') return node;\n              if (prop === Symbol.toPrimitive) return () => node;\n              if (prop === 'toString') return () => node;\n              if (prop === 'valueOf') return () => node;\n              if (typeof prop === 'string' && prop !== 'constructor') {\n                const method = (String.prototype as any)[prop];\n                if (typeof method === 'function') return method.bind(node);\n              }\n              if (prop === 'metadata') return metadataNodes;\n              if (prop === 'use')\n                return (components?: HTMLComponents) => render(components);\n              return Reflect.get(target, prop, receiver);\n            },\n          }) as any;\n        },\n      };\n\nexport type MarkdownCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.MARKDOWN]: infer M;\n  tags?: infer U;\n  metadata?: infer V;\n}\n  ? IntlayerNode<\n      M,\n      {\n        use: (components?: HTMLComponents<'permissive', U>) => ReactNode;\n        metadata: DeepTransformContent<V>;\n      }\n    >\n  : never;\n\nexport const markdownPlugin: Plugins =\n  process.env['INTLAYER_NODE_TYPE_MARKDOWN'] === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.MARKDOWN,\n        transform: (node: MarkdownContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            {\n              type: NodeTypes.MARKDOWN,\n            },\n          ];\n\n          const children = node[NodeTypes.MARKDOWN];\n\n          return deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [markdownStringPlugin, ...(props.plugins ?? [])],\n          });\n        },\n      };\n\n/** ---------------------------------------------\n *  HTML PLUGIN\n *  --------------------------------------------- */\n\n/**\n * HTML conditional type that enforces:\n * - All components (Standard or Custom) are OPTIONAL in the `use()` method.\n * - Custom components props are strictly inferred from the dictionary definition.\n *\n * This ensures type safety:\n * - `html('<div>Hello <CustomComponent /></div>').use({ CustomComponent: ... })` - optional but typed\n */\nexport type HTMLPluginCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.HTML]: infer I;\n  tags?: infer U;\n}\n  ? IntlayerNode<\n      I,\n      {\n        use: (components?: HTMLComponents<'permissive', U>) => ReactNode;\n      }\n    >\n  : never;\n\nconst HTMLSuspenseRenderer: FC<Record<string, any>> = (props) => {\n  const HTMLRendererPlugin = useLoadDynamic(\n    'html-renderer-plugin',\n    htmlRendererModulePromise!\n  );\n  return createElement(HTMLRendererPlugin as any, props);\n};\n\n/** HTML plugin. Replaces node with a function that takes components => ReactNode. */\nexport const htmlPlugin: Plugins =\n  process.env['INTLAYER_NODE_TYPE_HTML'] === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'html-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.HTML,\n\n        transform: (node: HTMLContent<string>, props) => {\n          const html = node[NodeTypes.HTML];\n          const { plugins, ...rest } = props;\n\n          // Type-safe render function that accepts properly typed components\n          const render = (userComponents?: HTMLComponents): ReactNode =>\n            renderIntlayerNode({\n              ...rest,\n              value: html,\n              children:\n                process.env['INTLAYER_EDITOR_ENABLED'] !== 'false' &&\n                editor.enabled ? (\n                  <ContentSelector {...rest}>\n                    <HTMLSuspenseRenderer\n                      {...rest}\n                      html={html}\n                      userComponents={userComponents}\n                    />\n                  </ContentSelector>\n                ) : (\n                  <HTMLSuspenseRenderer\n                    {...rest}\n                    html={html}\n                    userComponents={userComponents}\n                  />\n                ),\n            });\n\n          const element = render() as unknown as ReactElement;\n\n          return new Proxy(element, {\n            get(target, prop, receiver) {\n              if (prop === 'value') return html;\n              if (prop === Symbol.toPrimitive) return () => html;\n              if (prop === 'toString') return () => html;\n              if (prop === 'valueOf') return () => html;\n              if (typeof prop === 'string' && prop !== 'constructor') {\n                const method = (String.prototype as any)[prop];\n                if (typeof method === 'function') return method.bind(html);\n              }\n              if (prop === 'use')\n                return (userComponents?: HTMLComponents) =>\n                  render(userComponents);\n              return Reflect.get(target, prop, receiver);\n            },\n          }) as any;\n        },\n      };\n\n/** ---------------------------------------------\n *  PLUGINS RESULT\n *  --------------------------------------------- */\n\nexport type IInterpreterPluginReact<T, _S, _L extends LocalesValues> = {\n  reactNode: ReactNodeCond<T>;\n  reactIntlayerNode: IntlayerNodeCond<T>;\n  reactInsertion: InsertionCond<T>;\n  reactMarkdown: MarkdownCond<T>;\n  reactHtml: HTMLPluginCond<T>;\n};\n\n/**\n * Insert this type as param of `DeepTransformContent` to avoid `intlayer` package pollution.\n *\n * Otherwise the the `react-intlayer` plugins will override the types of `intlayer` functions.\n */\nexport type IInterpreterPluginState = Omit<\n  IInterpreterPluginStateCore,\n  'insertion' // Remove insertion type from core package\n> & {\n  reactNode: true;\n  reactIntlayerNode: true;\n  reactMarkdown: true;\n  reactHtml: true;\n  reactInsertion: true;\n};\n\nexport type DeepTransformContent<\n  T,\n  L extends LocalesValues = DeclaredLocales,\n> = DeepTransformContentCore<T, IInterpreterPluginState, L>;\n\nconst pluginsCache = new Map<string, Plugins[]>();\n\n/**\n * Get the plugins array for React content transformation.\n * This function is used by both getIntlayer and getDictionary to ensure consistent plugin configuration.\n */\nexport const getPlugins = (\n  locale?: LocalesValues,\n  fallback: boolean = true\n): Plugins[] => {\n  const currentLocale = locale ?? internationalization.defaultLocale;\n  const cacheKey = `${currentLocale}_${fallback}`;\n\n  if (pluginsCache.has(cacheKey)) {\n    return pluginsCache.get(cacheKey)!;\n  }\n\n  const plugins = [\n    // Env var allows the bundler to to remove the plugin if not used to make the bundle smaller\n    translationPlugin(\n      locale ?? internationalization.defaultLocale,\n      fallback ? internationalization.defaultLocale : undefined\n    ),\n    enumerationPlugin,\n    pluralPlugin(locale ?? internationalization.defaultLocale),\n    conditionPlugin,\n    nestedPlugin(locale ?? internationalization.defaultLocale),\n\n    filePlugin,\n    genderPlugin,\n    // Always include: handle plain strings/numbers and React elements\n    intlayerNodePlugins,\n    reactNodePlugins,\n    insertionPlugin,\n    markdownPlugin,\n    htmlPlugin,\n  ] as Plugins[];\n\n  pluginsCache.set(cacheKey, plugins);\n\n  return plugins;\n};\n"],"mappings":"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"}
+{"version":3,"file":"plugins.cjs","names":["renderIntlayerNode","editor","ContentSelector","fallbackPlugin","renderReactElement","Fragment","NodeTypes","func","useLoadDynamic","internationalization","enumerationPlugin","conditionPlugin","filePlugin","genderPlugin"],"sources":["../../src/plugins.tsx"],"sourcesContent":["import { editor, internationalization } from '@intlayer/config/built';\nimport {\n  conditionPlugin,\n  type DeepTransformContent as DeepTransformContentCore,\n  enumerationPlugin,\n  fallbackPlugin,\n  filePlugin,\n  genderPlugin,\n  type IInterpreterPluginState as IInterpreterPluginStateCore,\n  nestedPlugin,\n  type Plugins,\n  pluralPlugin,\n  splitInsertionTemplate,\n  translationPlugin,\n} from '@intlayer/core/interpreter';\nimport { getMarkdownMetadata } from '@intlayer/core/markdown';\nimport type {\n  HTMLContent,\n  InsertionContent,\n  MarkdownContent,\n} from '@intlayer/core/transpiler';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport {\n  createElement,\n  type FC,\n  Fragment,\n  type ReactElement,\n  type ReactNode,\n} from 'react';\nimport { useLoadDynamic } from './client/useLoadDynamic';\nimport { ContentSelector } from './editor/ContentSelector';\nimport type { HTMLComponents } from './html/HTMLComponentTypes';\nimport { type IntlayerNode, renderIntlayerNode } from './IntlayerNode';\nimport { renderReactElement } from './reactElement/renderReactElement';\n\nconst markdownRendererModulePromise =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN !== 'false'\n    ? import('./markdown/MarkdownRendererPlugin').then(\n        (m) => m.MarkdownRendererPlugin\n      )\n    : null;\n\nconst htmlRendererModulePromise =\n  process.env.INTLAYER_NODE_TYPE_HTML !== 'false'\n    ? import('./html/HTMLRendererPlugin').then((m) => m.HTMLRendererPlugin)\n    : null;\n\n/** ---------------------------------------------\n *  INTLAYER NODE PLUGIN\n *  --------------------------------------------- */\n\nexport type IntlayerNodeCond<T> = T extends number | string\n  ? IntlayerNode<T>\n  : never;\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const intlayerNodePlugins: Plugins = {\n  id: 'intlayer-node-plugin',\n  canHandle: (node) =>\n    typeof node === 'bigint' ||\n    typeof node === 'string' ||\n    typeof node === 'number',\n  transform: (\n    _node,\n    {\n      plugins, // Removed to avoid next error - Functions cannot be passed directly to Client Components\n      ...rest\n    }\n  ) =>\n    renderIntlayerNode({\n      ...rest,\n      value: rest.children,\n      children:\n        process.env.INTLAYER_EDITOR_ENABLED !== 'false' && editor.enabled ? (\n          <ContentSelector {...rest}>{rest.children}</ContentSelector>\n        ) : (\n          rest.children\n        ),\n    }),\n};\n\n/** ---------------------------------------------\n *  REACT NODE PLUGIN\n *  --------------------------------------------- */\n\nexport type ReactNodeCond<T> = T extends {\n  props: any;\n  key: any;\n}\n  ? ReactNode\n  : never;\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const reactNodePlugins: Plugins =\n  process.env.INTLAYER_NODE_TYPE_REACT_NODE === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'react-node-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' &&\n          typeof node?.props !== 'undefined' &&\n          typeof node.key !== 'undefined',\n\n        transform: (\n          node,\n          {\n            plugins, // Removed to avoid next error - Functions cannot be passed directly to Client Components\n            ...rest\n          }\n        ) =>\n          renderIntlayerNode({\n            ...rest,\n            value: '[[react-element]]',\n            children:\n              process.env.INTLAYER_EDITOR_ENABLED !== 'false' &&\n              editor.enabled ? (\n                <ContentSelector {...rest}>\n                  {renderReactElement(node)}\n                </ContentSelector>\n              ) : (\n                renderReactElement(node)\n              ),\n          }),\n      };\n\n/** ---------------------------------------------\n *  INSERTION PLUGIN\n *  --------------------------------------------- */\n\nexport type InsertionCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.INSERTION]: infer I;\n  fields: readonly string[];\n}\n  ? <V extends { [K in T['fields'][number]]: ReactNode }>(\n      values: V\n    ) => I extends string\n      ? V[keyof V] extends string | number\n        ? IntlayerNode<string>\n        : IntlayerNode<ReactNode>\n      : DeepTransformContent<I>\n  : never;\n\n/**\n * Split insertion string and join with React nodes using shared core logic\n */\nconst splitAndJoinInsertion = (\n  template: string,\n  values: Record<string, string | number | ReactNode>\n): ReactNode => {\n  const result = splitInsertionTemplate(template, values);\n\n  if (result.isSimple) {\n    // Simple string replacement\n    return result.parts as string;\n  }\n\n  // Return as Fragment with proper keys\n  return createElement(\n    Fragment,\n    null,\n    ...(result.parts as any[]).map((part, index) =>\n      createElement(Fragment, { key: index }, part)\n    )\n  );\n};\n\n/** Insertion plugin for React. Handles component/node insertion. */\nexport const insertionPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_INSERTION === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'insertion-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.INSERTION,\n        transform: (node: InsertionContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            {\n              type: NodeTypes.INSERTION,\n            },\n          ];\n\n          const children = node[NodeTypes.INSERTION];\n\n          /** Insertion string plugin. Replaces string node with a component that render the insertion. */\n          const insertionStringPlugin: Plugins = {\n            id: 'insertion-string-plugin',\n            canHandle: (node) => typeof node === 'string',\n            transform: (node: string, subProps, deepTransformNode) => {\n              const transformedResult = deepTransformNode(node, {\n                ...subProps,\n                children: node,\n                plugins: [\n                  ...(props.plugins ?? ([] as Plugins[])).filter(\n                    (plugin) => plugin.id !== 'intlayer-node-plugin'\n                  ),\n                ],\n              });\n\n              return (\n                values: {\n                  [K in InsertionContent['fields'][number]]:\n                    | string\n                    | number\n                    | ReactNode;\n                }\n              ) => {\n                const result = splitAndJoinInsertion(transformedResult, values);\n\n                return deepTransformNode(result, {\n                  ...subProps,\n                  plugins: props.plugins,\n                  children: result,\n                });\n              };\n            },\n          };\n\n          const result = deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [insertionStringPlugin, ...(props.plugins ?? [])],\n          });\n\n          if (\n            typeof children === 'object' &&\n            children !== null &&\n            'nodeType' in children &&\n            [NodeTypes.ENUMERATION, NodeTypes.CONDITION].includes(\n              children.nodeType as\n                | typeof NodeTypes.ENUMERATION\n                | typeof NodeTypes.CONDITION\n            )\n          ) {\n            return (values: any) => (arg: any) => {\n              const func = result as Function;\n              const inner = func(arg);\n\n              if (typeof inner === 'function') {\n                return inner(values);\n              }\n              return inner;\n            };\n          }\n\n          return result;\n        },\n      };\n\n/**\n * MARKDOWN PLUGIN\n */\n\nexport type MarkdownStringCond<T> = T extends string\n  ? IntlayerNode<\n      string,\n      {\n        metadata: DeepTransformContent<string>;\n        use: (components: HTMLComponents<'permissive', {}>) => ReactNode;\n      }\n    >\n  : never;\n\nconst MarkdownSuspenseRenderer: FC<Record<string, any>> = ({\n  children,\n  ...props\n}) => {\n  const MarkdownRendererPlugin = useLoadDynamic(\n    'markdown-renderer-plugin',\n    markdownRendererModulePromise!\n  );\n  return createElement(MarkdownRendererPlugin as any, { ...props, children });\n};\n\n/** Markdown string plugin. Replaces string node with a component that render the markdown. */\nexport const markdownStringPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-string-plugin',\n        canHandle: (node) => typeof node === 'string',\n        transform: (node: string, props, deepTransformNode) => {\n          const {\n            plugins, // Removed to avoid next error - Functions cannot be passed directly to Client Components\n            ...rest\n          } = props;\n\n          const metadata = getMarkdownMetadata(node) ?? {};\n\n          const metadataPlugins: Plugins = {\n            id: 'markdown-metadata-plugin',\n            canHandle: (metadataNode) =>\n              typeof metadataNode === 'string' ||\n              typeof metadataNode === 'number' ||\n              typeof metadataNode === 'boolean' ||\n              !metadataNode,\n            transform: (metadataNode, props) =>\n              renderIntlayerNode({\n                ...props,\n                value: metadataNode,\n                children:\n                  process.env.INTLAYER_EDITOR_ENABLED !== 'false' &&\n                  editor.enabled ? (\n                    <ContentSelector {...rest}>{node}</ContentSelector>\n                  ) : (\n                    node\n                  ),\n              }),\n          };\n\n          // Transform metadata while keeping the same structure\n          const metadataNodes = deepTransformNode(metadata, {\n            plugins: [metadataPlugins],\n            dictionaryKey: rest.dictionaryKey,\n            keyPath: [],\n          });\n\n          const render = (components?: HTMLComponents) =>\n            renderIntlayerNode({\n              ...props,\n              value: node,\n              children:\n                process.env.INTLAYER_EDITOR_ENABLED !== 'false' &&\n                editor.enabled ? (\n                  <ContentSelector {...rest}>\n                    <MarkdownSuspenseRenderer {...rest} components={components}>\n                      {node}\n                    </MarkdownSuspenseRenderer>\n                  </ContentSelector>\n                ) : (\n                  <MarkdownSuspenseRenderer {...rest} components={components}>\n                    {node}\n                  </MarkdownSuspenseRenderer>\n                ),\n              additionalProps: {\n                metadata: metadataNodes,\n              },\n            });\n\n          const element = render() as unknown as ReactElement;\n\n          return new Proxy(element, {\n            get(target, prop, receiver) {\n              if (prop === 'value') return node;\n              if (prop === Symbol.toPrimitive) return () => node;\n              if (prop === 'toString') return () => node;\n              if (prop === 'valueOf') return () => node;\n              if (typeof prop === 'string' && prop !== 'constructor') {\n                const method = (String.prototype as any)[prop];\n                if (typeof method === 'function') return method.bind(node);\n              }\n              if (prop === 'metadata') return metadataNodes;\n              if (prop === 'use')\n                return (components?: HTMLComponents) => render(components);\n              return Reflect.get(target, prop, receiver);\n            },\n          }) as any;\n        },\n      };\n\nexport type MarkdownCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.MARKDOWN]: infer M;\n  tags?: infer U;\n  metadata?: infer V;\n}\n  ? IntlayerNode<\n      M,\n      {\n        use: (components?: HTMLComponents<'permissive', U>) => ReactNode;\n        metadata: DeepTransformContent<V>;\n      }\n    >\n  : never;\n\nexport const markdownPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_MARKDOWN === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'markdown-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.MARKDOWN,\n        transform: (node: MarkdownContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            {\n              type: NodeTypes.MARKDOWN,\n            },\n          ];\n\n          const children = node[NodeTypes.MARKDOWN];\n\n          return deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [markdownStringPlugin, ...(props.plugins ?? [])],\n          });\n        },\n      };\n\n/** ---------------------------------------------\n *  HTML PLUGIN\n *  --------------------------------------------- */\n\n/**\n * HTML conditional type that enforces:\n * - All components (Standard or Custom) are OPTIONAL in the `use()` method.\n * - Custom components props are strictly inferred from the dictionary definition.\n *\n * This ensures type safety:\n * - `html('<div>Hello <CustomComponent /></div>').use({ CustomComponent: ... })` - optional but typed\n */\nexport type HTMLPluginCond<T> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.HTML]: infer I;\n  tags?: infer U;\n}\n  ? IntlayerNode<\n      I,\n      {\n        use: (components?: HTMLComponents<'permissive', U>) => ReactNode;\n      }\n    >\n  : never;\n\nconst HTMLSuspenseRenderer: FC<Record<string, any>> = (props) => {\n  const HTMLRendererPlugin = useLoadDynamic(\n    'html-renderer-plugin',\n    htmlRendererModulePromise!\n  );\n  return createElement(HTMLRendererPlugin as any, props);\n};\n\n/** HTML plugin. Replaces node with a function that takes components => ReactNode. */\nexport const htmlPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_HTML === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'html-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.HTML,\n\n        transform: (node: HTMLContent<string>, props) => {\n          const html = node[NodeTypes.HTML];\n          const { plugins, ...rest } = props;\n\n          // Type-safe render function that accepts properly typed components\n          const render = (userComponents?: HTMLComponents): ReactNode =>\n            renderIntlayerNode({\n              ...rest,\n              value: html,\n              children:\n                process.env.INTLAYER_EDITOR_ENABLED !== 'false' &&\n                editor.enabled ? (\n                  <ContentSelector {...rest}>\n                    <HTMLSuspenseRenderer\n                      {...rest}\n                      html={html}\n                      userComponents={userComponents}\n                    />\n                  </ContentSelector>\n                ) : (\n                  <HTMLSuspenseRenderer\n                    {...rest}\n                    html={html}\n                    userComponents={userComponents}\n                  />\n                ),\n            });\n\n          const element = render() as unknown as ReactElement;\n\n          return new Proxy(element, {\n            get(target, prop, receiver) {\n              if (prop === 'value') return html;\n              if (prop === Symbol.toPrimitive) return () => html;\n              if (prop === 'toString') return () => html;\n              if (prop === 'valueOf') return () => html;\n              if (typeof prop === 'string' && prop !== 'constructor') {\n                const method = (String.prototype as any)[prop];\n                if (typeof method === 'function') return method.bind(html);\n              }\n              if (prop === 'use')\n                return (userComponents?: HTMLComponents) =>\n                  render(userComponents);\n              return Reflect.get(target, prop, receiver);\n            },\n          }) as any;\n        },\n      };\n\n/** ---------------------------------------------\n *  PLUGINS RESULT\n *  --------------------------------------------- */\n\nexport type IInterpreterPluginReact<T, _S, _L extends LocalesValues> = {\n  reactNode: ReactNodeCond<T>;\n  reactIntlayerNode: IntlayerNodeCond<T>;\n  reactInsertion: InsertionCond<T>;\n  reactMarkdown: MarkdownCond<T>;\n  reactHtml: HTMLPluginCond<T>;\n};\n\n/**\n * Insert this type as param of `DeepTransformContent` to avoid `intlayer` package pollution.\n *\n * Otherwise the the `react-intlayer` plugins will override the types of `intlayer` functions.\n */\nexport type IInterpreterPluginState = Omit<\n  IInterpreterPluginStateCore,\n  'insertion' // Remove insertion type from core package\n> & {\n  reactNode: true;\n  reactIntlayerNode: true;\n  reactMarkdown: true;\n  reactHtml: true;\n  reactInsertion: true;\n};\n\nexport type DeepTransformContent<\n  T,\n  L extends LocalesValues = DeclaredLocales,\n> = DeepTransformContentCore<T, IInterpreterPluginState, L>;\n\nconst pluginsCache = new Map<string, Plugins[]>();\n\n/**\n * Get the plugins array for React content transformation.\n * This function is used by both getIntlayer and getDictionary to ensure consistent plugin configuration.\n */\nexport const getPlugins = (\n  locale?: LocalesValues,\n  fallback: boolean = true\n): Plugins[] => {\n  const currentLocale = locale ?? internationalization.defaultLocale;\n  const cacheKey = `${currentLocale}_${fallback}`;\n\n  if (pluginsCache.has(cacheKey)) {\n    return pluginsCache.get(cacheKey)!;\n  }\n\n  const plugins = [\n    // Env var allows the bundler to to remove the plugin if not used to make the bundle smaller\n    translationPlugin(\n      locale ?? internationalization.defaultLocale,\n      fallback ? internationalization.defaultLocale : undefined\n    ),\n    enumerationPlugin,\n    pluralPlugin(locale ?? internationalization.defaultLocale),\n    conditionPlugin,\n    nestedPlugin(locale ?? internationalization.defaultLocale),\n\n    filePlugin,\n    genderPlugin,\n    // Always include: handle plain strings/numbers and React elements\n    intlayerNodePlugins,\n    reactNodePlugins,\n    insertionPlugin,\n    markdownPlugin,\n    htmlPlugin,\n  ] as Plugins[];\n\n  pluginsCache.set(cacheKey, plugins);\n\n  return plugins;\n};\n"],"mappings":";;;;;;;;;;;;;;;AAyCA,MAAM,gCACJ,QAAQ,IAAI,gCAAgC,+CACxC,0CAA4C,MACzC,MAAM,EAAE,uBACV,GACD;AAEN,MAAM,4BACJ,QAAQ,IAAI,4BAA4B,+CACpC,kCAAoC,MAAM,MAAM,EAAE,mBAAmB,GACrE;;AAWN,MAAa,sBAA+B;CAC1C,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAChB,OAAO,SAAS,YAChB,OAAO,SAAS;CAClB,YACE,OACA,EACE,SACA,GAAG,WAGLA,wCAAmB;EACjB,GAAG;EACH,OAAO,KAAK;EACZ,UACE,QAAQ,IAAI,4BAA4B,WAAWC,8BAAO,UACxD,2CAACC,gDAAD;GAAiB,GAAI;aAAO,KAAK;GAA2B,IAE5D,KAAK;EAEV,CAAC;CACL;;AAcD,MAAa,mBACX,QAAQ,IAAI,kCAAkC,UAC1CC,4CACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAChB,OAAO,MAAM,UAAU,eACvB,OAAO,KAAK,QAAQ;CAEtB,YACE,MACA,EACE,SACA,GAAG,WAGLH,wCAAmB;EACjB,GAAG;EACH,OAAO;EACP,UACE,QAAQ,IAAI,4BAA4B,WACxCC,8BAAO,UACL,2CAACC,gDAAD;GAAiB,GAAI;aAClBE,2DAAmB,KAAK;GACT,IAElBA,2DAAmB,KAAK;EAE7B,CAAC;CACL;;;;AAuBP,MAAM,yBACJ,UACA,WACc;CACd,MAAM,gEAAgC,UAAU,OAAO;AAEvD,KAAI,OAAO,SAET,QAAO,OAAO;AAIhB,iCACEC,gBACA,MACA,GAAI,OAAO,MAAgB,KAAK,MAAM,mCACtBA,gBAAU,EAAE,KAAK,OAAO,EAAE,KAAK,CAC9C,CACF;;;AAIH,MAAa,kBACX,QAAQ,IAAI,iCAAiC,UACzCF,4CACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAaG,yBAAU;CAC3D,YAAY,MAAwB,OAAO,sBAAsB;EAC/D,MAAM,aAAwB,CAC5B,GAAG,MAAM,SACT,EACE,MAAMA,yBAAU,WACjB,CACF;EAED,MAAM,WAAW,KAAKA,yBAAU;;EAGhC,MAAM,wBAAiC;GACrC,IAAI;GACJ,YAAY,SAAS,OAAO,SAAS;GACrC,YAAY,MAAc,UAAU,sBAAsB;IACxD,MAAM,oBAAoB,kBAAkB,MAAM;KAChD,GAAG;KACH,UAAU;KACV,SAAS,CACP,IAAI,MAAM,WAAY,EAAE,EAAgB,QACrC,WAAW,OAAO,OAAO,uBAC3B,CACF;KACF,CAAC;AAEF,YACE,WAMG;KACH,MAAM,SAAS,sBAAsB,mBAAmB,OAAO;AAE/D,YAAO,kBAAkB,QAAQ;MAC/B,GAAG;MACH,SAAS,MAAM;MACf,UAAU;MACX,CAAC;;;GAGP;EAED,MAAM,SAAS,kBAAkB,UAAU;GACzC,GAAG;GACH;GACA,SAAS;GACT,SAAS,CAAC,uBAAuB,GAAI,MAAM,WAAW,EAAE,CAAE;GAC3D,CAAC;AAEF,MACE,OAAO,aAAa,YACpB,aAAa,QACb,cAAc,YACd,CAACA,yBAAU,aAAaA,yBAAU,UAAU,CAAC,SAC3C,SAAS,SAGV,CAED,SAAQ,YAAiB,QAAa;GAEpC,MAAM,QAAQC,OAAK,IAAI;AAEvB,OAAI,OAAO,UAAU,WACnB,QAAO,MAAM,OAAO;AAEtB,UAAO;;AAIX,SAAO;;CAEV;AAgBP,MAAM,4BAAqD,EACzD,UACA,GAAG,YACC;AAKJ,iCAJ+BC,6CAC7B,4BACA,8BAEyC,EAAS;EAAE,GAAG;EAAO;EAAU,CAAC;;;AAI7E,MAAa,uBACX,QAAQ,IAAI,gCAAgC,UACxCL,4CACA;CACE,IAAI;CACJ,YAAY,SAAS,OAAO,SAAS;CACrC,YAAY,MAAc,OAAO,sBAAsB;EACrD,MAAM,EACJ,SACA,GAAG,SACD;EA0BJ,MAAM,gBAAgB,mEAxBe,KAAK,IAAI,EAAE,EAwBE;GAChD,SAAS,CAAC;IAtBV,IAAI;IACJ,YAAY,iBACV,OAAO,iBAAiB,YACxB,OAAO,iBAAiB,YACxB,OAAO,iBAAiB,aACxB,CAAC;IACH,YAAY,cAAc,UACxBH,wCAAmB;KACjB,GAAG;KACH,OAAO;KACP,UACE,QAAQ,IAAI,4BAA4B,WACxCC,8BAAO,UACL,2CAACC,gDAAD;MAAiB,GAAI;gBAAO;MAAuB,IAEnD;KAEL,CAAC;IAKqB,CAAC;GAC1B,eAAe,KAAK;GACpB,SAAS,EAAE;GACZ,CAAC;EAEF,MAAM,UAAU,eACdF,wCAAmB;GACjB,GAAG;GACH,OAAO;GACP,UACE,QAAQ,IAAI,4BAA4B,WACxCC,8BAAO,UACL,2CAACC,gDAAD;IAAiB,GAAI;cACnB,2CAAC,0BAAD;KAA0B,GAAI;KAAkB;eAC7C;KACwB;IACX,IAElB,2CAAC,0BAAD;IAA0B,GAAI;IAAkB;cAC7C;IACwB;GAE/B,iBAAiB,EACf,UAAU,eACX;GACF,CAAC;EAEJ,MAAM,UAAU,QAAQ;AAExB,SAAO,IAAI,MAAM,SAAS,EACxB,IAAI,QAAQ,MAAM,UAAU;AAC1B,OAAI,SAAS,QAAS,QAAO;AAC7B,OAAI,SAAS,OAAO,YAAa,cAAa;AAC9C,OAAI,SAAS,WAAY,cAAa;AACtC,OAAI,SAAS,UAAW,cAAa;AACrC,OAAI,OAAO,SAAS,YAAY,SAAS,eAAe;IACtD,MAAM,SAAU,OAAO,UAAkB;AACzC,QAAI,OAAO,WAAW,WAAY,QAAO,OAAO,KAAK,KAAK;;AAE5D,OAAI,SAAS,WAAY,QAAO;AAChC,OAAI,SAAS,MACX,SAAQ,eAAgC,OAAO,WAAW;AAC5D,UAAO,QAAQ,IAAI,QAAQ,MAAM,SAAS;KAE7C,CAAC;;CAEL;AAiBP,MAAa,iBACX,QAAQ,IAAI,gCAAgC,UACxCC,4CACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAaG,yBAAU;CAC3D,YAAY,MAAuB,OAAO,sBAAsB;EAC9D,MAAM,aAAwB,CAC5B,GAAG,MAAM,SACT,EACE,MAAMA,yBAAU,UACjB,CACF;EAED,MAAM,WAAW,KAAKA,yBAAU;AAEhC,SAAO,kBAAkB,UAAU;GACjC,GAAG;GACH;GACA,SAAS;GACT,SAAS,CAAC,sBAAsB,GAAI,MAAM,WAAW,EAAE,CAAE;GAC1D,CAAC;;CAEL;AA2BP,MAAM,wBAAiD,UAAU;AAK/D,iCAJ2BE,6CACzB,wBACA,0BAEqC,EAAS,MAAM;;;AAIxD,MAAa,aACX,QAAQ,IAAI,4BAA4B,UACpCL,4CACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAaG,yBAAU;CAE3D,YAAY,MAA2B,UAAU;EAC/C,MAAM,OAAO,KAAKA,yBAAU;EAC5B,MAAM,EAAE,SAAS,GAAG,SAAS;EAG7B,MAAM,UAAU,mBACdN,wCAAmB;GACjB,GAAG;GACH,OAAO;GACP,UACE,QAAQ,IAAI,4BAA4B,WACxCC,8BAAO,UACL,2CAACC,gDAAD;IAAiB,GAAI;cACnB,2CAAC,sBAAD;KACE,GAAI;KACE;KACU;KAChB;IACc,IAElB,2CAAC,sBAAD;IACE,GAAI;IACE;IACU;IAChB;GAEP,CAAC;EAEJ,MAAM,UAAU,QAAQ;AAExB,SAAO,IAAI,MAAM,SAAS,EACxB,IAAI,QAAQ,MAAM,UAAU;AAC1B,OAAI,SAAS,QAAS,QAAO;AAC7B,OAAI,SAAS,OAAO,YAAa,cAAa;AAC9C,OAAI,SAAS,WAAY,cAAa;AACtC,OAAI,SAAS,UAAW,cAAa;AACrC,OAAI,OAAO,SAAS,YAAY,SAAS,eAAe;IACtD,MAAM,SAAU,OAAO,UAAkB;AACzC,QAAI,OAAO,WAAW,WAAY,QAAO,OAAO,KAAK,KAAK;;AAE5D,OAAI,SAAS,MACX,SAAQ,mBACN,OAAO,eAAe;AAC1B,UAAO,QAAQ,IAAI,QAAQ,MAAM,SAAS;KAE7C,CAAC;;CAEL;AAmCP,MAAM,+BAAe,IAAI,KAAwB;;;;;AAMjD,MAAa,cACX,QACA,WAAoB,SACN;CAEd,MAAM,WAAW,GADK,UAAUO,4CAAqB,cACnB,GAAG;AAErC,KAAI,aAAa,IAAI,SAAS,CAC5B,QAAO,aAAa,IAAI,SAAS;CAGnC,MAAM,UAAU;oDAGZ,UAAUA,4CAAqB,eAC/B,WAAWA,4CAAqB,gBAAgB,OACjD;EACDC;+CACa,UAAUD,4CAAqB,cAAc;EAC1DE;+CACa,UAAUF,4CAAqB,cAAc;EAE1DG;EACAC;EAEA;EACA;EACA;EACA;EACA;EACD;AAED,cAAa,IAAI,UAAU,QAAQ;AAEnC,QAAO"}

package/dist/cjs/server/useDictionary.cjs

@@ -5,12 +5,19 @@ const require_server_IntlayerServerProvider = require('./IntlayerServerProvider.
 
 //#region src/server/useDictionary.ts
 /**
-* On the server side, Hook that transform a dictionary and return the content
+* On the server side, Hook that transform a dictionary (or qualified
+* dictionary group) and return the content
 *
-* If the locale is not provided, it will use the locale from the server context
+* If the locale is not provided (directly or through the selector), it will
+* use the locale from the server context
 */
-const useDictionary = (dictionary, locale, fallbackLocale) => {
-	return require_getDictionary.getDictionary(dictionary, locale ?? require_server_serverContext.getServerContext(require_server_IntlayerServerProvider.IntlayerServerContext) ?? fallbackLocale);
+const useDictionary = (dictionary, localeOrSelector, fallbackLocale) => {
+	const contextLocale = require_server_serverContext.getServerContext(require_server_IntlayerServerProvider.IntlayerServerContext) ?? fallbackLocale;
+	if (process.env.INTLAYER_DICTIONARY_SELECTOR !== "false" && typeof localeOrSelector === "object" && localeOrSelector !== null) return require_getDictionary.getDictionary(dictionary, {
+		...localeOrSelector,
+		locale: localeOrSelector.locale ?? contextLocale
+	});
+	return require_getDictionary.getDictionary(dictionary, localeOrSelector ?? contextLocale);
 };
 
 //#endregion