@intlayer/use-intl 9.0.0-canary.8 → 9.0.0

package/dist/esm/client/IntlProvider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"IntlProvider.mjs","names":[],"sources":["../../../src/client/IntlProvider.tsx"],"sourcesContent":["'use client';\n\nimport { log } from '@intlayer/config/built';\nimport { CYAN } from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport type { ComponentProps } from 'react';\nimport { IntlayerProvider } from 'react-intlayer';\nimport type { IntlProvider as _IntlProvider } from 'use-intl';\n\n/**\n * Drop-in for use-intl's `IntlProvider`.\n *\n * Wraps Intlayer's `IntlayerProvider`, seeding the client locale from the\n * `locale` prop. `messages`, `formats`, `now`, `timeZone`, `onError`, and\n * `getMessageFallback` are accepted for API compatibility but have no effect —\n * Intlayer uses its own compiled dictionaries.\n */\nexport const IntlProvider: typeof _IntlProvider = ({\n  locale,\n  children,\n  messages: _messages,\n  formats: _formats,\n  now: _now,\n  timeZone: _timeZone,\n  onError: _onError,\n  getMessageFallback: _getMessageFallback,\n}) => {\n  if (\n    process.env.NODE_ENV === 'development' &&\n    typeof _messages !== 'undefined'\n  ) {\n    const appLogger = getAppLogger({ log });\n    appLogger(\n      `${colorize('IntlProvider', CYAN)} do not pass the messages prop with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`\n    );\n  }\n\n  // `key={locale}` re-seeds the client locale context when the locale changes,\n  // so consumers re-render in the new language.\n  return (\n    <IntlayerProvider key={String(locale)} locale={locale as LocalesValues}>\n      {children}\n    </IntlayerProvider>\n  );\n};\n\n/**\n * Props accepted by {@link IntlProvider}. `messages` is deprecated — Intlayer\n * loads content from compiled dictionaries automatically.\n */\nexport type IntlProviderProps = Omit<\n  ComponentProps<typeof _IntlProvider>,\n  'messages' | 'locale'\n> & {\n  /**\n   * @deprecated has no use case with intlayer. Messages are loaded\n   * automatically under the hood for bundle optimization reason.\n   */\n  messages?: never;\n  /** The active locale. */\n  locale: LocalesValues;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAkBA,MAAa,gBAAsC,EACjD,QACA,UACA,UAAU,WACV,SAAS,UACT,KAAK,MACL,UAAU,WACV,SAAS,UACT,oBAAoB,0BAChB;AACJ,KAEE,OAAO,cAAc,YAGrB,CADkB,aAAa,EAAE,KAAK,CAC7B,CACP,GAAG,SAAS,gBAAgB,KAAK,CAAC,+HACnC;AAKH,QACE,oBAAC,kBAAD;EAA+C;EAC5C;EACgB,EAFI,OAAO,OAAO,CAElB"}
+{"version":3,"file":"IntlProvider.mjs","names":[],"sources":["../../../src/client/IntlProvider.tsx"],"sourcesContent":["'use client';\n\nimport { log } from '@intlayer/config/built';\nimport { CYAN } from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport type { ComponentProps } from 'react';\nimport { IntlayerProvider } from 'react-intlayer';\nimport type { IntlProvider as _IntlProvider } from 'use-intl';\n\n/**\n * Drop-in for use-intl's `IntlProvider`.\n *\n * Wraps Intlayer's `IntlayerProvider`, seeding the client locale from the\n * `locale` prop. `messages`, `formats`, `now`, `timeZone`, `onError`, and\n * `getMessageFallback` are accepted for API compatibility but have no effect —\n * Intlayer uses its own compiled dictionaries.\n */\nexport const IntlProvider: typeof _IntlProvider = ({\n  locale,\n  children,\n  messages: _messages,\n  formats: _formats,\n  now: _now,\n  timeZone: _timeZone,\n  onError: _onError,\n  getMessageFallback: _getMessageFallback,\n}) => {\n  if (\n    process.env.NODE_ENV === 'development' &&\n    typeof _messages !== 'undefined'\n  ) {\n    const appLogger = getAppLogger({ log });\n    appLogger(\n      `${colorize('IntlProvider', CYAN)} do not pass the messages prop with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`\n    );\n  }\n\n  // `key={locale}` re-seeds the client locale context when the locale changes,\n  // so consumers re-render in the new language.\n  return (\n    <IntlayerProvider key={String(locale)} locale={locale as LocalesValues}>\n      {children}\n    </IntlayerProvider>\n  );\n};\n\n/**\n * Props accepted by {@link IntlProvider}. `messages` is deprecated — Intlayer\n * loads content from compiled dictionaries automatically.\n */\nexport type IntlProviderProps = Omit<\n  ComponentProps<typeof _IntlProvider>,\n  'messages' | 'locale'\n> & {\n  /**\n   * @deprecated has no use case with intlayer. Messages are loaded\n   * automatically under the hood for bundle optimization reason.\n   */\n  messages?: never;\n  /** The active locale. */\n  locale: LocalesValues;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAkBA,MAAa,gBAAsC,EACjD,QACA,UACA,UAAU,WACV,SAAS,UACT,KAAK,MACL,UAAU,WACV,SAAS,UACT,oBAAoB,0BAChB;CACJ,IAEE,OAAO,cAAc,aAGrB,AADkB,aAAa,EAAE,IAAI,CAC7B,CAAC,CACP,GAAG,SAAS,gBAAgB,IAAI,EAAE,8HACpC;CAKF,OACE,oBAAC,kBAAD;EAA+C;EAC5C;CACe,GAFK,OAAO,MAAM,CAElB;AAEtB"}

package/dist/esm/client/helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.mjs","names":["useLocaleIntlayer"],"sources":["../../../src/client/helpers.ts"],"sourcesContent":["'use client';\n\nimport { log } from '@intlayer/config/built';\nimport { CYAN } from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport { useLocale as useLocaleIntlayer } from 'react-intlayer';\nimport type {\n  useFormatter as _useFormatter,\n  useMessages as _useMessages,\n  useNow as _useNow,\n  useTimeZone as _useTimeZone,\n} from 'use-intl';\nimport { buildIntlFormatter } from '../shared/intlFormatter';\n\n/**\n * Drop-in for use-intl's `useNow`.\n * Returns the current `Date`. The `updateInterval` option is ignored.\n */\nexport const useNow: typeof _useNow = () => new Date();\n\n/**\n * Drop-in for use-intl's `useTimeZone`.\n * Returns the system time zone resolved from `Intl.DateTimeFormat`.\n */\nexport const useTimeZone: typeof _useTimeZone = () =>\n  Intl.DateTimeFormat().resolvedOptions().timeZone;\n\n/**\n * Drop-in for use-intl's `useMessages`.\n *\n * @deprecated useMessages has no use case with intlayer.\n * Messages are loaded automatically under the hood.\n * @returns An empty object.\n */\nexport const useMessages: typeof _useMessages = () => {\n  if (process.env.NODE_ENV === 'development') {\n    const appLogger = getAppLogger({ log });\n    appLogger(\n      `${colorize('useMessages', CYAN)} has no use case with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`\n    );\n  }\n\n  return {} as ReturnType<typeof _useMessages>;\n};\n\n/**\n * Drop-in for use-intl's `useFormatter`.\n * Returns locale-aware formatters backed by the native `Intl.*` APIs:\n * `dateTime`, `number`, `dateTimeRange`, `relativeTime`, `list`, and\n * `displayName`.\n */\nexport const useFormatter: typeof _useFormatter = () => {\n  const { locale } = useLocaleIntlayer();\n  return buildIntlFormatter((locale as string) ?? 'en');\n};\n"],"mappings":";;;;;;;;;;;;;AAkBA,MAAa,+BAA+B,IAAI,MAAM;;;;;AAMtD,MAAa,oBACX,KAAK,gBAAgB,CAAC,iBAAiB,CAAC;;;;;;;;AAS1C,MAAa,oBAAyC;AAGlD,CADkB,aAAa,EAAE,KAAK,CAC7B,CACP,GAAG,SAAS,eAAe,KAAK,CAAC,iHAClC;AAGH,QAAO,EAAE;;;;;;;;AASX,MAAa,qBAA2C;CACtD,MAAM,EAAE,WAAWA,WAAmB;AACtC,QAAO,mBAAoB,UAAqB,KAAK"}
+{"version":3,"file":"helpers.mjs","names":["useLocaleIntlayer"],"sources":["../../../src/client/helpers.ts"],"sourcesContent":["'use client';\n\nimport { log } from '@intlayer/config/built';\nimport { CYAN } from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport { useLocale as useLocaleIntlayer } from 'react-intlayer';\nimport type {\n  useFormatter as _useFormatter,\n  useMessages as _useMessages,\n  useNow as _useNow,\n  useTimeZone as _useTimeZone,\n} from 'use-intl';\nimport { buildIntlFormatter } from '../shared/intlFormatter';\n\n/**\n * Drop-in for use-intl's `useNow`.\n * Returns the current `Date`. The `updateInterval` option is ignored.\n */\nexport const useNow: typeof _useNow = () => new Date();\n\n/**\n * Drop-in for use-intl's `useTimeZone`.\n * Returns the system time zone resolved from `Intl.DateTimeFormat`.\n */\nexport const useTimeZone: typeof _useTimeZone = () =>\n  Intl.DateTimeFormat().resolvedOptions().timeZone;\n\n/**\n * Drop-in for use-intl's `useMessages`.\n *\n * @deprecated useMessages has no use case with intlayer.\n * Messages are loaded automatically under the hood.\n * @returns An empty object.\n */\nexport const useMessages: typeof _useMessages = () => {\n  if (process.env.NODE_ENV === 'development') {\n    const appLogger = getAppLogger({ log });\n    appLogger(\n      `${colorize('useMessages', CYAN)} has no use case with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`\n    );\n  }\n\n  return {} as ReturnType<typeof _useMessages>;\n};\n\n/**\n * Drop-in for use-intl's `useFormatter`.\n * Returns locale-aware formatters backed by the native `Intl.*` APIs:\n * `dateTime`, `number`, `dateTimeRange`, `relativeTime`, `list`, and\n * `displayName`.\n */\nexport const useFormatter: typeof _useFormatter = () => {\n  const { locale } = useLocaleIntlayer();\n  return buildIntlFormatter((locale as string) ?? 'en');\n};\n"],"mappings":";;;;;;;;;;;;;AAkBA,MAAa,+BAA+B,IAAI,KAAK;;;;;AAMrD,MAAa,oBACX,KAAK,eAAe,CAAC,CAAC,gBAAgB,CAAC,CAAC;;;;;;;;AAS1C,MAAa,oBAAyC;CAGlD,AADkB,aAAa,EAAE,IAAI,CAC7B,CAAC,CACP,GAAG,SAAS,eAAe,IAAI,EAAE,gHACnC;CAGF,OAAO,CAAC;AACV;;;;;;;AAQA,MAAa,qBAA2C;CACtD,MAAM,EAAE,WAAWA,UAAkB;CACrC,OAAO,mBAAoB,UAAqB,IAAI;AACtD"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/client/index.ts"],"sourcesContent":["export { useDictionary } from '../useDictionary';\nexport { useDictionaryDynamic } from '../useDictionaryDynamic';\nexport { useFormatter, useMessages, useNow, useTimeZone } from './helpers';\nexport { IntlProvider, type IntlProviderProps } from './IntlProvider';\nexport { useLocale } from './useLocale';\nexport { useTranslations } from './useTranslations';\n\n/**\n * @internal Private use-intl export, kept so aliased `_useExtracted` imports\n * resolve. Not part of the supported public surface.\n */\nexport const _useExtracted = (): Record<string, never> => ({});\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,uBAA8C,EAAE"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/client/index.ts"],"sourcesContent":["export { useDictionary } from '../useDictionary';\nexport { useDictionaryDynamic } from '../useDictionaryDynamic';\nexport { useFormatter, useMessages, useNow, useTimeZone } from './helpers';\nexport { IntlProvider, type IntlProviderProps } from './IntlProvider';\nexport { useLocale } from './useLocale';\nexport { useTranslations } from './useTranslations';\n\n/**\n * @internal Private use-intl export, kept so aliased `_useExtracted` imports\n * resolve. Not part of the supported public surface.\n */\nexport const _useExtracted = (): Record<string, never> => ({});\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,uBAA8C,CAAC"}

package/dist/esm/client/useLocale.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useLocale.mjs","names":["useLocaleIntlayer"],"sources":["../../../src/client/useLocale.ts"],"sourcesContent":["'use client';\n\nimport { useLocale as useLocaleIntlayer } from 'react-intlayer';\nimport type { useLocale as _useLocale } from 'use-intl';\n\n/**\n * Drop-in for use-intl's `useLocale`.\n *\n * Returns the active locale string from Intlayer's client context.\n */\nexport const useLocale: typeof _useLocale = () => {\n  const { locale } = useLocaleIntlayer();\n  return locale as ReturnType<typeof _useLocale>;\n};\n"],"mappings":";;;;;;;;;;AAUA,MAAa,kBAAqC;CAChD,MAAM,EAAE,WAAWA,aAAmB;AACtC,QAAO"}
+{"version":3,"file":"useLocale.mjs","names":["useLocaleIntlayer"],"sources":["../../../src/client/useLocale.ts"],"sourcesContent":["'use client';\n\nimport { useLocale as useLocaleIntlayer } from 'react-intlayer';\nimport type { useLocale as _useLocale } from 'use-intl';\n\n/**\n * Drop-in for use-intl's `useLocale`.\n *\n * Returns the active locale string from Intlayer's client context.\n */\nexport const useLocale: typeof _useLocale = () => {\n  const { locale } = useLocaleIntlayer();\n  return locale as ReturnType<typeof _useLocale>;\n};\n"],"mappings":";;;;;;;;;;AAUA,MAAa,kBAAqC;CAChD,MAAM,EAAE,WAAWA,YAAkB;CACrC,OAAO;AACT"}

package/dist/esm/client/useTranslations.mjs

@@ -1,8 +1,8 @@
 'use client';
 
 import { createNamespaceTranslator } from "../shared/namespaceTranslator.mjs";
-import { IntlayerClientContext } from "react-intlayer";
 import { useContext, useMemo } from "react";
+import { IntlayerClientContext } from "react-intlayer";
 
 //#region src/client/useTranslations.ts
 /**

package/dist/esm/client/useTranslations.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useTranslations.mjs","names":[],"sources":["../../../src/client/useTranslations.ts"],"sourcesContent":["'use client';\n\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { useContext, useMemo } from 'react';\nimport { IntlayerClientContext } from 'react-intlayer';\nimport { createNamespaceTranslator } from '../shared/namespaceTranslator';\nimport type {\n  LooseTranslateFunction,\n  TranslateFunction,\n} from '../shared/translateFunctionTypes';\n\n/**\n * Overload set for {@link useTranslations}:\n *\n * 1. A bare dictionary key → fully-typed `t()` (autocompleted dot-paths).\n * 2. A nested namespace `'dictionary.sub.scope'` → `t()` accepts relative\n *    `string` paths, matching use-intl's scoped-namespace behaviour.\n * 3. No namespace → root scope; the first segment of each key designates\n *    the dictionary (`t('about.title')`).\n */\ntype UseTranslations = {\n  <N extends DictionaryKeys>(namespace: N): TranslateFunction<N>;\n  (namespace: `${string}.${string}`): LooseTranslateFunction;\n  (): LooseTranslateFunction;\n};\n\n/**\n * Drop-in for use-intl's `useTranslations`.\n *\n * Messages support ICU MessageFormat syntax: simple arguments (`{name}`),\n * plural (`{count, plural, one {…} other {…}}`, `#`), select, and formatted\n * arguments (`{value, number}`). Rich text is available through `t.rich()`\n * and `t.markup()`.\n *\n * @example\n * ```tsx\n * const t = useTranslations('about');\n * t('counter.label'); // ✓ typed\n * t('items', { count: 3 }); // ICU plural\n *\n * // Scoped to a nested object (use-intl idiom)\n * const t = useTranslations('about.counter');\n * t('label'); // resolves about → counter.label\n *\n * // Rich text\n * t.rich('terms', { link: (chunks) => <a href=\"/terms\">{chunks}</a> });\n * ```\n */\nexport const useTranslations = ((namespace?: string) => {\n  const { locale: currentLocale } = useContext(IntlayerClientContext) ?? {};\n\n  return useMemo(\n    () => createNamespaceTranslator(currentLocale as LocalesValues, namespace),\n    [currentLocale, namespace]\n  );\n}) as UseTranslations;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,MAAa,oBAAoB,cAAuB;CACtD,MAAM,EAAE,QAAQ,kBAAkB,WAAW,sBAAsB,IAAI,EAAE;AAEzE,QAAO,cACC,0BAA0B,eAAgC,UAAU,EAC1E,CAAC,eAAe,UAAU,CAC3B"}
+{"version":3,"file":"useTranslations.mjs","names":[],"sources":["../../../src/client/useTranslations.ts"],"sourcesContent":["'use client';\n\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { useContext, useMemo } from 'react';\nimport { IntlayerClientContext } from 'react-intlayer';\nimport { createNamespaceTranslator } from '../shared/namespaceTranslator';\nimport type {\n  LooseTranslateFunction,\n  TranslateFunction,\n  TranslateFunctionForNamespace,\n} from '../shared/translateFunctionTypes';\n\n/**\n * Overload set for {@link useTranslations}:\n *\n * 1. A bare dictionary key → fully-typed `t()` (autocompleted dot-paths).\n * 2. A nested namespace `'dictionary.sub.scope'` → `t()` accepts relative\n *    dot-paths under the scope, typed against the dictionary, matching\n *    use-intl's scoped-namespace behaviour.\n * 3. No namespace → root scope; the first segment of each key designates\n *    the dictionary (`t('about.title')`).\n */\ntype UseTranslations = {\n  <N extends DictionaryKeys>(namespace: N): TranslateFunction<N>;\n  <N extends `${string}.${string}`>(\n    namespace: N\n  ): TranslateFunctionForNamespace<N>;\n  (): LooseTranslateFunction;\n};\n\n/**\n * Drop-in for use-intl's `useTranslations`.\n *\n * Messages support ICU MessageFormat syntax: simple arguments (`{name}`),\n * plural (`{count, plural, one {…} other {…}}`, `#`), select, and formatted\n * arguments (`{value, number}`). Rich text is available through `t.rich()`\n * and `t.markup()`.\n *\n * @example\n * ```tsx\n * const t = useTranslations('about');\n * t('counter.label'); // ✓ typed\n * t('items', { count: 3 }); // ICU plural\n *\n * // Scoped to a nested object (use-intl idiom)\n * const t = useTranslations('about.counter');\n * t('label'); // resolves about → counter.label\n *\n * // Rich text\n * t.rich('terms', { link: (chunks) => <a href=\"/terms\">{chunks}</a> });\n * ```\n */\nexport const useTranslations = ((namespace?: string) => {\n  const { locale: currentLocale } = useContext(IntlayerClientContext) ?? {};\n\n  return useMemo(\n    () => createNamespaceTranslator(currentLocale as LocalesValues, namespace),\n    [currentLocale, namespace]\n  );\n}) as UseTranslations;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDA,MAAa,oBAAoB,cAAuB;CACtD,MAAM,EAAE,QAAQ,kBAAkB,WAAW,qBAAqB,KAAK,CAAC;CAExE,OAAO,cACC,0BAA0B,eAAgC,SAAS,GACzE,CAAC,eAAe,SAAS,CAC3B;AACF"}

package/dist/esm/core/createFormatter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createFormatter.mjs","names":[],"sources":["../../../src/core/createFormatter.ts"],"sourcesContent":["import type { createFormatter as _createFormatter } from 'use-intl';\nimport { buildIntlFormatter } from '../shared/intlFormatter';\n\n/**\n * Drop-in for use-intl's `createFormatter`.\n *\n * Returns locale-aware formatters backed by the native `Intl.*` APIs:\n * `dateTime`, `number`, `dateTimeRange`, `relativeTime`, `list`, and\n * `displayName`. `now`, `timeZone`, `formats`, and `onError` are accepted for\n * API compatibility but only `locale` influences the output.\n *\n * @example\n * ```ts\n * const format = createFormatter({ locale: 'en' });\n * format.number(1234.5, { style: 'currency', currency: 'USD' });\n * ```\n */\nexport const createFormatter: typeof _createFormatter = ({ locale }) =>\n  buildIntlFormatter(locale);\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,MAAa,mBAA4C,EAAE,aACzD,mBAAmB,OAAO"}
+{"version":3,"file":"createFormatter.mjs","names":[],"sources":["../../../src/core/createFormatter.ts"],"sourcesContent":["import type { createFormatter as _createFormatter } from 'use-intl';\nimport { buildIntlFormatter } from '../shared/intlFormatter';\n\n/**\n * Drop-in for use-intl's `createFormatter`.\n *\n * Returns locale-aware formatters backed by the native `Intl.*` APIs:\n * `dateTime`, `number`, `dateTimeRange`, `relativeTime`, `list`, and\n * `displayName`. `now`, `timeZone`, `formats`, and `onError` are accepted for\n * API compatibility but only `locale` influences the output.\n *\n * @example\n * ```ts\n * const format = createFormatter({ locale: 'en' });\n * format.number(1234.5, { style: 'currency', currency: 'USD' });\n * ```\n */\nexport const createFormatter: typeof _createFormatter = ({ locale }) =>\n  buildIntlFormatter(locale);\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,MAAa,mBAA4C,EAAE,aACzD,mBAAmB,MAAM"}

package/dist/esm/core/createTranslator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createTranslator.mjs","names":[],"sources":["../../../src/core/createTranslator.ts"],"sourcesContent":["import { log } from '@intlayer/config/built';\nimport { CYAN } from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { createNamespaceTranslator } from '../shared/namespaceTranslator';\nimport type {\n  LooseTranslateFunction,\n  TranslateFunction,\n} from '../shared/translateFunctionTypes';\n\n/**\n * Configuration accepted by {@link createTranslator}.\n *\n * Mirrors use-intl's `IntlConfig`, but `messages`, `formats`, `now`,\n * `timeZone`, `onError`, and `getMessageFallback` have no effect — Intlayer\n * resolves content from its own compiled dictionaries.\n */\nexport type CreateTranslatorConfig<N extends DictionaryKeys> = {\n  /** The locale dictionaries are resolved for. */\n  locale: LocalesValues;\n  /** A bare dictionary key, or a nested `'dictionary.scope'` namespace. */\n  namespace?: N | (string & {});\n  /**\n   * @deprecated has no use case with intlayer. Messages are loaded\n   * automatically under the hood for bundle optimization reason.\n   */\n  messages?: never;\n} & Record<string, unknown>;\n\n/**\n * Overload set for {@link createTranslator}:\n *\n * 1. A bare dictionary key → fully-typed `t()` (autocompleted dot-paths).\n * 2. A nested namespace `'dictionary.sub.scope'` → `t()` accepts relative\n *    `string` paths, matching use-intl's scoped-namespace behaviour.\n * 3. No namespace → root scope; the first segment of each key designates\n *    the dictionary (`t('about.title')`).\n */\ntype CreateTranslator = {\n  <N extends DictionaryKeys>(\n    config: CreateTranslatorConfig<N> & { namespace: N }\n  ): TranslateFunction<N>;\n  (\n    config: CreateTranslatorConfig<DictionaryKeys> & {\n      namespace: `${string}.${string}`;\n    }\n  ): LooseTranslateFunction;\n  (config: CreateTranslatorConfig<DictionaryKeys>): LooseTranslateFunction;\n};\n\n/**\n * Drop-in for use-intl's `createTranslator`.\n *\n * Returns a translate function (with `rich`, `markup`, `raw`, `has`) that\n * resolves messages from Intlayer's compiled dictionaries for the given\n * `locale`. Messages support ICU MessageFormat syntax.\n *\n * @example\n * ```ts\n * const t = createTranslator({ locale: 'en', namespace: 'about' });\n * t('counter.label'); // ✓ typed\n * t('items', { count: 3 }); // ICU plural\n * ```\n */\nexport const createTranslator = (({\n  locale,\n  namespace,\n  messages: _messages,\n}: CreateTranslatorConfig<DictionaryKeys>) => {\n  if (process.env.NODE_ENV === 'development' && _messages !== undefined) {\n    const appLogger = getAppLogger({ log });\n    appLogger(\n      `${colorize('createTranslator', CYAN)} do not pass the messages option with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`\n    );\n  }\n\n  return createNamespaceTranslator(locale, namespace);\n}) as CreateTranslator;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmEA,MAAa,qBAAqB,EAChC,QACA,WACA,UAAU,gBACkC;AAC5C,KAA8C,cAAc,OAE1D,CADkB,aAAa,EAAE,KAAK,CAC7B,CACP,GAAG,SAAS,oBAAoB,KAAK,CAAC,iIACvC;AAGH,QAAO,0BAA0B,QAAQ,UAAU"}
+{"version":3,"file":"createTranslator.mjs","names":[],"sources":["../../../src/core/createTranslator.ts"],"sourcesContent":["import { log } from '@intlayer/config/built';\nimport { CYAN } from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { createNamespaceTranslator } from '../shared/namespaceTranslator';\nimport type {\n  LooseTranslateFunction,\n  TranslateFunction,\n  TranslateFunctionForNamespace,\n} from '../shared/translateFunctionTypes';\n\n/**\n * Configuration accepted by {@link createTranslator}.\n *\n * Mirrors use-intl's `IntlConfig`, but `messages`, `formats`, `now`,\n * `timeZone`, `onError`, and `getMessageFallback` have no effect — Intlayer\n * resolves content from its own compiled dictionaries.\n */\nexport type CreateTranslatorConfig<N extends DictionaryKeys> = {\n  /** The locale dictionaries are resolved for. */\n  locale: LocalesValues;\n  /** A bare dictionary key, or a nested `'dictionary.scope'` namespace. */\n  namespace?: N | (string & {});\n  /**\n   * @deprecated has no use case with intlayer. Messages are loaded\n   * automatically under the hood for bundle optimization reason.\n   */\n  messages?: never;\n} & Record<string, unknown>;\n\n/**\n * Overload set for {@link createTranslator}:\n *\n * 1. A bare dictionary key → fully-typed `t()` (autocompleted dot-paths).\n * 2. A nested namespace `'dictionary.sub.scope'` → `t()` accepts relative\n *    dot-paths under the scope, typed against the dictionary, matching\n *    use-intl's scoped-namespace behaviour.\n * 3. No namespace → root scope; the first segment of each key designates\n *    the dictionary (`t('about.title')`).\n */\ntype CreateTranslator = {\n  <N extends DictionaryKeys>(\n    config: CreateTranslatorConfig<N> & { namespace: N }\n  ): TranslateFunction<N>;\n  <N extends `${string}.${string}`>(\n    config: CreateTranslatorConfig<DictionaryKeys> & { namespace: N }\n  ): TranslateFunctionForNamespace<N>;\n  (config: CreateTranslatorConfig<DictionaryKeys>): LooseTranslateFunction;\n};\n\n/**\n * Drop-in for use-intl's `createTranslator`.\n *\n * Returns a translate function (with `rich`, `markup`, `raw`, `has`) that\n * resolves messages from Intlayer's compiled dictionaries for the given\n * `locale`. Messages support ICU MessageFormat syntax.\n *\n * @example\n * ```ts\n * const t = createTranslator({ locale: 'en', namespace: 'about' });\n * t('counter.label'); // ✓ typed\n * t('items', { count: 3 }); // ICU plural\n * ```\n */\nexport const createTranslator = (({\n  locale,\n  namespace,\n  messages: _messages,\n}: CreateTranslatorConfig<DictionaryKeys>) => {\n  if (process.env.NODE_ENV === 'development' && _messages !== undefined) {\n    const appLogger = getAppLogger({ log });\n    appLogger(\n      `${colorize('createTranslator', CYAN)} do not pass the messages option with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`\n    );\n  }\n\n  return createNamespaceTranslator(locale, namespace);\n}) as CreateTranslator;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmEA,MAAa,qBAAqB,EAChC,QACA,WACA,UAAU,gBACkC;CAC5C,IAA8C,cAAc,QAE1D,AADkB,aAAa,EAAE,IAAI,CAC7B,CAAC,CACP,GAAG,SAAS,oBAAoB,IAAI,EAAE,gIACxC;CAGF,OAAO,0BAA0B,QAAQ,SAAS;AACpD"}

package/dist/esm/core/errors.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../../../src/core/errors.ts"],"sourcesContent":["/**\n * Drop-in for use-intl's `IntlErrorCode` enum.\n *\n * Re-implemented locally (rather than re-exported) because `use-intl` is\n * aliased to this package at build time, so importing its runtime value would\n * be circular.\n */\nexport enum IntlErrorCode {\n  MISSING_MESSAGE = 'MISSING_MESSAGE',\n  MISSING_FORMAT = 'MISSING_FORMAT',\n  ENVIRONMENT_FALLBACK = 'ENVIRONMENT_FALLBACK',\n  INSUFFICIENT_PATH = 'INSUFFICIENT_PATH',\n  INVALID_MESSAGE = 'INVALID_MESSAGE',\n  INVALID_KEY = 'INVALID_KEY',\n  FORMATTING_ERROR = 'FORMATTING_ERROR',\n}\n\n/**\n * Drop-in for use-intl's `IntlError`.\n *\n * Carries the {@link IntlErrorCode} and the original message, matching\n * use-intl's error shape so consumer `onError` handlers keep working.\n */\nexport class IntlError extends Error {\n  public readonly code: IntlErrorCode;\n  public readonly originalMessage: string | undefined;\n\n  constructor(code: IntlErrorCode, originalMessage?: string) {\n    let message: string = code;\n    if (originalMessage) {\n      message += `: ${originalMessage}`;\n    }\n    super(message);\n\n    this.code = code;\n    if (originalMessage) {\n      this.originalMessage = originalMessage;\n    }\n  }\n}\n"],"mappings":";;;;;;;;AAOA,IAAY,gBAAL;AACL;AACA;AACA;AACA;AACA;AACA;AACA;;KACD;;;;;;;AAQD,IAAa,YAAb,cAA+B,MAAM;CACnC,AAAgB;CAChB,AAAgB;CAEhB,YAAY,MAAqB,iBAA0B;EACzD,IAAI,UAAkB;AACtB,MAAI,gBACF,YAAW,KAAK;AAElB,QAAM,QAAQ;AAEd,OAAK,OAAO;AACZ,MAAI,gBACF,MAAK,kBAAkB"}
+{"version":3,"file":"errors.mjs","names":[],"sources":["../../../src/core/errors.ts"],"sourcesContent":["/**\n * Drop-in for use-intl's `IntlErrorCode` enum.\n *\n * Re-implemented locally (rather than re-exported) because `use-intl` is\n * aliased to this package at build time, so importing its runtime value would\n * be circular.\n */\nexport enum IntlErrorCode {\n  MISSING_MESSAGE = 'MISSING_MESSAGE',\n  MISSING_FORMAT = 'MISSING_FORMAT',\n  ENVIRONMENT_FALLBACK = 'ENVIRONMENT_FALLBACK',\n  INSUFFICIENT_PATH = 'INSUFFICIENT_PATH',\n  INVALID_MESSAGE = 'INVALID_MESSAGE',\n  INVALID_KEY = 'INVALID_KEY',\n  FORMATTING_ERROR = 'FORMATTING_ERROR',\n}\n\n/**\n * Drop-in for use-intl's `IntlError`.\n *\n * Carries the {@link IntlErrorCode} and the original message, matching\n * use-intl's error shape so consumer `onError` handlers keep working.\n */\nexport class IntlError extends Error {\n  public readonly code: IntlErrorCode;\n  public readonly originalMessage: string | undefined;\n\n  constructor(code: IntlErrorCode, originalMessage?: string) {\n    let message: string = code;\n    if (originalMessage) {\n      message += `: ${originalMessage}`;\n    }\n    super(message);\n\n    this.code = code;\n    if (originalMessage) {\n      this.originalMessage = originalMessage;\n    }\n  }\n}\n"],"mappings":";;;;;;;;AAOA,IAAY,gBAAL;CACL;CACA;CACA;CACA;CACA;CACA;CACA;;AACF;;;;;;;AAQA,IAAa,YAAb,cAA+B,MAAM;CACnC,AAAgB;CAChB,AAAgB;CAEhB,YAAY,MAAqB,iBAA0B;EACzD,IAAI,UAAkB;EACtB,IAAI,iBACF,WAAW,KAAK;EAElB,MAAM,OAAO;EAEb,KAAK,OAAO;EACZ,IAAI,iBACF,KAAK,kBAAkB;CAE3B;AACF"}

package/dist/esm/core/hasLocale.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"hasLocale.mjs","names":[],"sources":["../../../src/core/hasLocale.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport type { hasLocale as _hasLocale } from 'use-intl';\n\n/**\n * Drop-in for use-intl's `hasLocale`.\n *\n * Narrows a locale candidate to the given locales list. When the list is\n * omitted, the locales configured in intlayer are used.\n *\n * @example\n * ```ts\n * if (hasLocale(['en', 'fr'], requested)) { … }\n * ```\n */\nexport const hasLocale: typeof _hasLocale = ((\n  locales: readonly string[],\n  candidate: unknown\n): boolean => {\n  const availableLocales =\n    locales ?? internationalization?.locales?.map(String) ?? [];\n  return availableLocales.includes(candidate as string);\n}) as typeof _hasLocale;\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAa,cACX,SACA,cACY;AAGZ,SADE,WAAW,sBAAsB,SAAS,IAAI,OAAO,IAAI,EAAE,EACrC,SAAS,UAAoB"}
+{"version":3,"file":"hasLocale.mjs","names":[],"sources":["../../../src/core/hasLocale.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport type { hasLocale as _hasLocale } from 'use-intl';\n\n/**\n * Drop-in for use-intl's `hasLocale`.\n *\n * Narrows a locale candidate to the given locales list. When the list is\n * omitted, the locales configured in intlayer are used.\n *\n * @example\n * ```ts\n * if (hasLocale(['en', 'fr'], requested)) { … }\n * ```\n */\nexport const hasLocale: typeof _hasLocale = ((\n  locales: readonly string[],\n  candidate: unknown\n): boolean => {\n  const availableLocales =\n    locales ?? internationalization?.locales?.map(String) ?? [];\n  return availableLocales.includes(candidate as string);\n}) as typeof _hasLocale;\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAa,cACX,SACA,cACY;CAGZ,QADE,WAAW,sBAAsB,SAAS,IAAI,MAAM,KAAK,CAAC,EACrC,CAAC,SAAS,SAAmB;AACtD"}

package/dist/esm/core/initializeConfig.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"initializeConfig.mjs","names":[],"sources":["../../../src/core/initializeConfig.ts"],"sourcesContent":["import type { initializeConfig as _initializeConfig } from 'use-intl';\n\n/**\n * Drop-in for use-intl's `initializeConfig`.\n *\n * Enhances an incoming config with defaults. With intlayer, `messages` and\n * `formats` are not consumed at runtime (content comes from compiled\n * dictionaries) but the shape is preserved so callers keep type-checking.\n */\nexport const initializeConfig: typeof _initializeConfig = ({\n  formats,\n  getMessageFallback,\n  messages,\n  onError,\n  ...rest\n}) => {\n  const finalOnError = onError ?? ((error) => error);\n  const finalGetMessageFallback =\n    getMessageFallback ??\n    (({ key, namespace }) => [namespace, key].filter(Boolean).join('.'));\n\n  return {\n    ...rest,\n    formats: formats || undefined,\n    messages: messages || undefined,\n    onError: finalOnError,\n    getMessageFallback: finalGetMessageFallback,\n  };\n};\n"],"mappings":";;;;;;;;AASA,MAAa,oBAA8C,EACzD,SACA,oBACA,UACA,SACA,GAAG,WACC;CACJ,MAAM,eAAe,aAAa,UAAU;CAC5C,MAAM,0BACJ,wBACE,EAAE,KAAK,gBAAgB,CAAC,WAAW,IAAI,CAAC,OAAO,QAAQ,CAAC,KAAK,IAAI;AAErE,QAAO;EACL,GAAG;EACH,SAAS,WAAW;EACpB,UAAU,YAAY;EACtB,SAAS;EACT,oBAAoB;EACrB"}
+{"version":3,"file":"initializeConfig.mjs","names":[],"sources":["../../../src/core/initializeConfig.ts"],"sourcesContent":["import type { initializeConfig as _initializeConfig } from 'use-intl';\n\n/**\n * Drop-in for use-intl's `initializeConfig`.\n *\n * Enhances an incoming config with defaults. With intlayer, `messages` and\n * `formats` are not consumed at runtime (content comes from compiled\n * dictionaries) but the shape is preserved so callers keep type-checking.\n */\nexport const initializeConfig: typeof _initializeConfig = ({\n  formats,\n  getMessageFallback,\n  messages,\n  onError,\n  ...rest\n}) => {\n  const finalOnError = onError ?? ((error) => error);\n  const finalGetMessageFallback =\n    getMessageFallback ??\n    (({ key, namespace }) => [namespace, key].filter(Boolean).join('.'));\n\n  return {\n    ...rest,\n    formats: formats || undefined,\n    messages: messages || undefined,\n    onError: finalOnError,\n    getMessageFallback: finalGetMessageFallback,\n  };\n};\n"],"mappings":";;;;;;;;AASA,MAAa,oBAA8C,EACzD,SACA,oBACA,UACA,SACA,GAAG,WACC;CACJ,MAAM,eAAe,aAAa,UAAU;CAC5C,MAAM,0BACJ,wBACE,EAAE,KAAK,gBAAgB,CAAC,WAAW,GAAG,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;CAEpE,OAAO;EACL,GAAG;EACH,SAAS,WAAW;EACpB,UAAU,YAAY;EACtB,SAAS;EACT,oBAAoB;CACtB;AACF"}

package/dist/esm/index.mjs

@@ -1,3 +1,4 @@
+import { createDictionaryTranslator } from "./shared/namespaceTranslator.mjs";
 import { useDictionaryDynamic } from "./useDictionaryDynamic.mjs";
 import { useDictionary } from "./useDictionary.mjs";
 import { useFormatter, useMessages, useNow, useTimeZone } from "./client/helpers.mjs";
@@ -11,4 +12,4 @@ import { IntlError, IntlErrorCode } from "./core/errors.mjs";
 import { hasLocale } from "./core/hasLocale.mjs";
 import { initializeConfig } from "./core/initializeConfig.mjs";
 
-export { IntlError, IntlErrorCode, IntlProvider, _useExtracted, createFormatter, createTranslator, hasLocale, initializeConfig, useDictionary, useDictionaryDynamic, useFormatter, useLocale, useMessages, useNow, useTimeZone, useTranslations };
+export { IntlError, IntlErrorCode, IntlProvider, _useExtracted, createDictionaryTranslator, createFormatter, createTranslator, hasLocale, initializeConfig, useDictionary, useDictionaryDynamic, useFormatter, useLocale, useMessages, useNow, useTimeZone, useTranslations };

package/dist/esm/plugin/index.mjs

@@ -1,46 +1,13 @@
 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 { USE_INTL_CALLERS } from "@intlayer/config/callers";
 import { getConfiguration } from "@intlayer/config/node";
+import { runOnce } from "@intlayer/engine/utils";
 import { intlayer } from "vite-intlayer";
 
 //#region src/plugin/index.ts
 /**
-* Caller configurations for use-intl's translation entry points.
-*
-* Tells the intlayer field-usage analyser how to extract the dictionary key
-* (namespace) and consumed fields from `useTranslations` / `createTranslator`
-* call sites, enabling accurate dictionary pruning for projects using
-* `@intlayer/use-intl`.
-*/
-const USE_INTL_COMPAT_CALLERS = [{
-	callerName: "useTranslations",
-	importSources: [
-		"use-intl",
-		"use-intl/react",
-		"@intlayer/use-intl"
-	],
-	namespace: {
-		from: "argument",
-		index: 0
-	},
-	translationFunction: "return-value"
-}, {
-	callerName: "createTranslator",
-	importSources: [
-		"use-intl",
-		"use-intl/core",
-		"@intlayer/use-intl"
-	],
-	namespace: {
-		from: "option",
-		argumentIndex: 0,
-		property: "namespace"
-	},
-	translationFunction: "return-value"
-}];
-/**
 * A Vite plugin for use-intl compat that wraps vite-intlayer and configures
 * resolve aliases so `use-intl` imports are served by `@intlayer/use-intl`.
 *
@@ -62,7 +29,7 @@ const useIntlVitePlugin = (options) => {
 	}, { cacheTimeoutMs: 1e3 * 60 * 60 });
 	const basePlugins = intlayer({
 		...options,
-		compatCallers: [...options?.compatCallers ?? [], ...USE_INTL_COMPAT_CALLERS]
+		compatCallers: [...options?.compatCallers ?? [], ...USE_INTL_CALLERS]
 	});
 	const compatPlugin = {
 		name: "vite-use-intl-compat-plugin",

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

@@ -1 +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 use-intl's translation entry points.\n *\n * Tells the intlayer field-usage analyser how to extract the dictionary key\n * (namespace) and consumed fields from `useTranslations` / `createTranslator`\n * call sites, enabling accurate dictionary pruning for projects using\n * `@intlayer/use-intl`.\n */\nconst USE_INTL_COMPAT_CALLERS: CompatCallerConfig[] = [\n  {\n    callerName: 'useTranslations',\n    importSources: ['use-intl', 'use-intl/react', '@intlayer/use-intl'],\n    namespace: { from: 'argument', index: 0 },\n    translationFunction: 'return-value',\n  },\n  {\n    callerName: 'createTranslator',\n    importSources: ['use-intl', 'use-intl/core', '@intlayer/use-intl'],\n    namespace: { from: 'option', argumentIndex: 0, property: 'namespace' },\n    translationFunction: 'return-value',\n  },\n];\n\n/**\n * A Vite plugin for use-intl compat that wraps vite-intlayer and configures\n * resolve aliases so `use-intl` imports are served by `@intlayer/use-intl`.\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import useIntlVitePlugin from '@intlayer/use-intl/plugin';\n *\n * export default defineConfig({\n *   plugins: [useIntlVitePlugin()],\n * });\n * ```\n */\nexport const useIntlVitePlugin = (\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      ...USE_INTL_COMPAT_CALLERS,\n    ],\n  });\n\n  const compatPlugin: PluginOption = {\n    name: 'vite-use-intl-compat-plugin',\n    config: () => ({\n      resolve: {\n        alias: {\n          'use-intl': '@intlayer/use-intl',\n        },\n      },\n    }),\n  };\n\n  return [\n    ...(Array.isArray(basePlugins) ? basePlugins : [basePlugins]),\n    compatPlugin,\n  ];\n};\n\nexport default useIntlVitePlugin;\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,MAAM,0BAAgD,CACpD;CACE,YAAY;CACZ,eAAe;EAAC;EAAY;EAAkB;EAAqB;CACnE,WAAW;EAAE,MAAM;EAAY,OAAO;EAAG;CACzC,qBAAqB;CACtB,EACD;CACE,YAAY;CACZ,eAAe;EAAC;EAAY;EAAiB;EAAqB;CAClE,WAAW;EAAE,MAAM;EAAU,eAAe;EAAG,UAAU;EAAa;CACtE,qBAAqB;CACtB,CACF;;;;;;;;;;;;;;;AAgBD,MAAa,qBACX,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,wBACJ;EACF,CAAC;CAEF,MAAM,eAA6B;EACjC,MAAM;EACN,eAAe,EACb,SAAS,EACP,OAAO,EACL,YAAY,sBACb,EACF,EACF;EACF;AAED,QAAO,CACL,GAAI,MAAM,QAAQ,YAAY,GAAG,cAAc,CAAC,YAAY,EAC5D,aACD"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/plugin/index.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { USE_INTL_CALLERS } from '@intlayer/config/callers';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport { getConfiguration } from '@intlayer/config/node';\nimport { runOnce } from '@intlayer/engine/utils';\nimport type { PluginOption } from 'vite';\nimport { intlayer } from 'vite-intlayer';\n\n/**\n * A Vite plugin for use-intl compat that wraps vite-intlayer and configures\n * resolve aliases so `use-intl` imports are served by `@intlayer/use-intl`.\n *\n * @example\n * ```ts\n * // vite.config.ts\n * import useIntlVitePlugin from '@intlayer/use-intl/plugin';\n *\n * export default defineConfig({\n *   plugins: [useIntlVitePlugin()],\n * });\n * ```\n */\nexport const useIntlVitePlugin = (\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: [...(options?.compatCallers ?? []), ...USE_INTL_CALLERS],\n  });\n\n  const compatPlugin: PluginOption = {\n    name: 'vite-use-intl-compat-plugin',\n    config: () => ({\n      resolve: {\n        alias: {\n          'use-intl': '@intlayer/use-intl',\n        },\n      },\n    }),\n  };\n\n  return [\n    ...(Array.isArray(basePlugins) ? basePlugins : [basePlugins]),\n    compatPlugin,\n  ];\n};\n\nexport default useIntlVitePlugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,qBACX,YACmB;CACnB,MAAM,iBAAiB,iBAAiB;CACxC,MAAM,YAAY,aAAa,cAAc;CAE7C,QACE,KACE,eAAe,OAAO,SACtB,aACA,SACA,iCACF,SACM;EACJ,UAAU,CACR,SACE,+CACA,WAAW,IACb,GACA,SACE,iDACA,WAAW,UACb,CACF,CAAC;CACH,GACA,EACE,gBAAgB,MAAO,KAAK,GAC9B,CACF;CAEA,MAAM,cAAc,SAAS;EAC3B,GAAG;EACH,eAAe,CAAC,GAAI,SAAS,iBAAiB,CAAC,GAAI,GAAG,gBAAgB;CACxE,CAAC;CAED,MAAM,eAA6B;EACjC,MAAM;EACN,eAAe,EACb,SAAS,EACP,OAAO,EACL,YAAY,qBACd,EACF,EACF;CACF;CAEA,OAAO,CACL,GAAI,MAAM,QAAQ,WAAW,IAAI,cAAc,CAAC,WAAW,GAC3D,YACF;AACF"}

package/dist/esm/shared/intlFormatter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"intlFormatter.mjs","names":[],"sources":["../../../src/shared/intlFormatter.ts"],"sourcesContent":["import type { createFormatter as _createFormatter } from 'use-intl';\n\n/** The formatter object shape exposed by use-intl. */\nexport type Formatter = ReturnType<typeof _createFormatter>;\n\n/** Time units orderable by their duration in seconds. */\nconst RELATIVE_TIME_UNITS: [Intl.RelativeTimeFormatUnit, number][] = [\n  ['year', 31536000],\n  ['month', 2628000],\n  ['week', 604800],\n  ['day', 86400],\n  ['hour', 3600],\n  ['minute', 60],\n  ['second', 1],\n];\n\nconst toDate = (value: Date | number | string): Date =>\n  value instanceof Date ? value : new Date(value);\n\n/**\n * Builds a use-intl compatible formatter backed by the native `Intl.*` APIs\n * for the given locale.\n *\n * Shared by `useFormatter` (React hook) and `createFormatter` (non-React core).\n *\n * @param locale - The locale used by every `Intl.*` formatter instance.\n * @returns A formatter exposing `dateTime`, `number`, `dateTimeRange`,\n *   `relativeTime`, `list`, and `displayName`.\n */\nexport const buildIntlFormatter = (locale: string): Formatter =>\n  ({\n    dateTime: (value: Date | number, options?: Intl.DateTimeFormatOptions) =>\n      new Intl.DateTimeFormat(locale, options).format(value),\n\n    number: (value: number | bigint, options?: Intl.NumberFormatOptions) =>\n      new Intl.NumberFormat(locale, options).format(value),\n\n    /** Formats a date range with `Intl.DateTimeFormat#formatRange`. */\n    dateTimeRange: (\n      start: Date | number,\n      end: Date | number,\n      options?: Intl.DateTimeFormatOptions\n    ) =>\n      new Intl.DateTimeFormat(locale, options).formatRange(\n        toDate(start),\n        toDate(end)\n      ),\n\n    /**\n     * Formats a date relative to now (or a reference date), automatically\n     * selecting the largest fitting unit.\n     */\n    relativeTime: (\n      date: Date | number | string,\n      nowOrOptions?:\n        | Date\n        | number\n        | {\n            now?: Date | number;\n            unit?: Intl.RelativeTimeFormatUnit;\n            style?: Intl.RelativeTimeFormatStyle;\n            numberingSystem?: string;\n          }\n    ) => {\n      const options =\n        nowOrOptions instanceof Date || typeof nowOrOptions === 'number'\n          ? { now: nowOrOptions }\n          : (nowOrOptions ?? {});\n\n      const nowDate =\n        options.now !== undefined ? toDate(options.now) : new Date();\n      const diffInSeconds = (toDate(date).getTime() - nowDate.getTime()) / 1000;\n\n      let unit = options.unit;\n      if (!unit) {\n        const absoluteDiff = Math.abs(diffInSeconds);\n        unit =\n          RELATIVE_TIME_UNITS.find(\n            ([, unitSeconds]) => absoluteDiff >= unitSeconds\n          )?.[0] ?? 'second';\n      }\n\n      const unitSeconds =\n        RELATIVE_TIME_UNITS.find(([unitName]) => unitName === unit)?.[1] ?? 1;\n\n      return new Intl.RelativeTimeFormat(locale, {\n        numeric: 'auto',\n        style: options.style,\n      }).format(Math.round(diffInSeconds / unitSeconds), unit);\n    },\n\n    /** Formats a list with `Intl.ListFormat`. */\n    list: (value: Iterable<string>, options?: Intl.ListFormatOptions): string =>\n      new Intl.ListFormat(locale, options).format(value),\n\n    displayName: (\n      value: string,\n      optionsOrFormat?: Intl.DisplayNamesOptions | string,\n      extraOptions?: Intl.DisplayNamesOptions\n    ): string => {\n      const resolvedOptions =\n        typeof optionsOrFormat === 'string' ? extraOptions : optionsOrFormat;\n      try {\n        return (\n          new Intl.DisplayNames(\n            [locale],\n            resolvedOptions ?? { type: 'language' }\n          ).of(value) ?? value\n        );\n      } catch {\n        return value;\n      }\n    },\n  }) as unknown as Formatter;\n"],"mappings":";;AAMA,MAAM,sBAA+D;CACnE,CAAC,QAAQ,QAAS;CAClB,CAAC,SAAS,OAAQ;CAClB,CAAC,QAAQ,OAAO;CAChB,CAAC,OAAO,MAAM;CACd,CAAC,QAAQ,KAAK;CACd,CAAC,UAAU,GAAG;CACd,CAAC,UAAU,EAAE;CACd;AAED,MAAM,UAAU,UACd,iBAAiB,OAAO,QAAQ,IAAI,KAAK,MAAM;;;;;;;;;;;AAYjD,MAAa,sBAAsB,YAChC;CACC,WAAW,OAAsB,YAC/B,IAAI,KAAK,eAAe,QAAQ,QAAQ,CAAC,OAAO,MAAM;CAExD,SAAS,OAAwB,YAC/B,IAAI,KAAK,aAAa,QAAQ,QAAQ,CAAC,OAAO,MAAM;;CAGtD,gBACE,OACA,KACA,YAEA,IAAI,KAAK,eAAe,QAAQ,QAAQ,CAAC,YACvC,OAAO,MAAM,EACb,OAAO,IAAI,CACZ;;;;;CAMH,eACE,MACA,iBASG;EACH,MAAM,UACJ,wBAAwB,QAAQ,OAAO,iBAAiB,WACpD,EAAE,KAAK,cAAc,GACpB,gBAAgB,EAAE;EAEzB,MAAM,UACJ,QAAQ,QAAQ,SAAY,OAAO,QAAQ,IAAI,mBAAG,IAAI,MAAM;EAC9D,MAAM,iBAAiB,OAAO,KAAK,CAAC,SAAS,GAAG,QAAQ,SAAS,IAAI;EAErE,IAAI,OAAO,QAAQ;AACnB,MAAI,CAAC,MAAM;GACT,MAAM,eAAe,KAAK,IAAI,cAAc;AAC5C,UACE,oBAAoB,MACjB,GAAG,iBAAiB,gBAAgB,YACtC,GAAG,MAAM;;EAGd,MAAM,cACJ,oBAAoB,MAAM,CAAC,cAAc,aAAa,KAAK,GAAG,MAAM;AAEtE,SAAO,IAAI,KAAK,mBAAmB,QAAQ;GACzC,SAAS;GACT,OAAO,QAAQ;GAChB,CAAC,CAAC,OAAO,KAAK,MAAM,gBAAgB,YAAY,EAAE,KAAK;;;CAI1D,OAAO,OAAyB,YAC9B,IAAI,KAAK,WAAW,QAAQ,QAAQ,CAAC,OAAO,MAAM;CAEpD,cACE,OACA,iBACA,iBACW;EACX,MAAM,kBACJ,OAAO,oBAAoB,WAAW,eAAe;AACvD,MAAI;AACF,UACE,IAAI,KAAK,aACP,CAAC,OAAO,EACR,mBAAmB,EAAE,MAAM,YAAY,CACxC,CAAC,GAAG,MAAM,IAAI;UAEX;AACN,UAAO;;;CAGZ"}
+{"version":3,"file":"intlFormatter.mjs","names":[],"sources":["../../../src/shared/intlFormatter.ts"],"sourcesContent":["import type { createFormatter as _createFormatter } from 'use-intl';\n\n/** The formatter object shape exposed by use-intl. */\nexport type Formatter = ReturnType<typeof _createFormatter>;\n\n/** Time units orderable by their duration in seconds. */\nconst RELATIVE_TIME_UNITS: [Intl.RelativeTimeFormatUnit, number][] = [\n  ['year', 31536000],\n  ['month', 2628000],\n  ['week', 604800],\n  ['day', 86400],\n  ['hour', 3600],\n  ['minute', 60],\n  ['second', 1],\n];\n\nconst toDate = (value: Date | number | string): Date =>\n  value instanceof Date ? value : new Date(value);\n\n/**\n * Builds a use-intl compatible formatter backed by the native `Intl.*` APIs\n * for the given locale.\n *\n * Shared by `useFormatter` (React hook) and `createFormatter` (non-React core).\n *\n * @param locale - The locale used by every `Intl.*` formatter instance.\n * @returns A formatter exposing `dateTime`, `number`, `dateTimeRange`,\n *   `relativeTime`, `list`, and `displayName`.\n */\nexport const buildIntlFormatter = (locale: string): Formatter =>\n  ({\n    dateTime: (value: Date | number, options?: Intl.DateTimeFormatOptions) =>\n      new Intl.DateTimeFormat(locale, options).format(value),\n\n    number: (value: number | bigint, options?: Intl.NumberFormatOptions) =>\n      new Intl.NumberFormat(locale, options).format(value),\n\n    /** Formats a date range with `Intl.DateTimeFormat#formatRange`. */\n    dateTimeRange: (\n      start: Date | number,\n      end: Date | number,\n      options?: Intl.DateTimeFormatOptions\n    ) =>\n      new Intl.DateTimeFormat(locale, options).formatRange(\n        toDate(start),\n        toDate(end)\n      ),\n\n    /**\n     * Formats a date relative to now (or a reference date), automatically\n     * selecting the largest fitting unit.\n     */\n    relativeTime: (\n      date: Date | number | string,\n      nowOrOptions?:\n        | Date\n        | number\n        | {\n            now?: Date | number;\n            unit?: Intl.RelativeTimeFormatUnit;\n            style?: Intl.RelativeTimeFormatStyle;\n            numberingSystem?: string;\n          }\n    ) => {\n      const options =\n        nowOrOptions instanceof Date || typeof nowOrOptions === 'number'\n          ? { now: nowOrOptions }\n          : (nowOrOptions ?? {});\n\n      const nowDate =\n        options.now !== undefined ? toDate(options.now) : new Date();\n      const diffInSeconds = (toDate(date).getTime() - nowDate.getTime()) / 1000;\n\n      let unit = options.unit;\n      if (!unit) {\n        const absoluteDiff = Math.abs(diffInSeconds);\n        unit =\n          RELATIVE_TIME_UNITS.find(\n            ([, unitSeconds]) => absoluteDiff >= unitSeconds\n          )?.[0] ?? 'second';\n      }\n\n      const unitSeconds =\n        RELATIVE_TIME_UNITS.find(([unitName]) => unitName === unit)?.[1] ?? 1;\n\n      return new Intl.RelativeTimeFormat(locale, {\n        numeric: 'auto',\n        style: options.style,\n      }).format(Math.round(diffInSeconds / unitSeconds), unit);\n    },\n\n    /** Formats a list with `Intl.ListFormat`. */\n    list: (value: Iterable<string>, options?: Intl.ListFormatOptions): string =>\n      new Intl.ListFormat(locale, options).format(value),\n\n    displayName: (\n      value: string,\n      optionsOrFormat?: Intl.DisplayNamesOptions | string,\n      extraOptions?: Intl.DisplayNamesOptions\n    ): string => {\n      const resolvedOptions =\n        typeof optionsOrFormat === 'string' ? extraOptions : optionsOrFormat;\n      try {\n        return (\n          new Intl.DisplayNames(\n            [locale],\n            resolvedOptions ?? { type: 'language' }\n          ).of(value) ?? value\n        );\n      } catch {\n        return value;\n      }\n    },\n  }) as unknown as Formatter;\n"],"mappings":";;AAMA,MAAM,sBAA+D;CACnE,CAAC,QAAQ,OAAQ;CACjB,CAAC,SAAS,MAAO;CACjB,CAAC,QAAQ,MAAM;CACf,CAAC,OAAO,KAAK;CACb,CAAC,QAAQ,IAAI;CACb,CAAC,UAAU,EAAE;CACb,CAAC,UAAU,CAAC;AACd;AAEA,MAAM,UAAU,UACd,iBAAiB,OAAO,QAAQ,IAAI,KAAK,KAAK;;;;;;;;;;;AAYhD,MAAa,sBAAsB,YAChC;CACC,WAAW,OAAsB,YAC/B,IAAI,KAAK,eAAe,QAAQ,OAAO,CAAC,CAAC,OAAO,KAAK;CAEvD,SAAS,OAAwB,YAC/B,IAAI,KAAK,aAAa,QAAQ,OAAO,CAAC,CAAC,OAAO,KAAK;;CAGrD,gBACE,OACA,KACA,YAEA,IAAI,KAAK,eAAe,QAAQ,OAAO,CAAC,CAAC,YACvC,OAAO,KAAK,GACZ,OAAO,GAAG,CACZ;;;;;CAMF,eACE,MACA,iBASG;EACH,MAAM,UACJ,wBAAwB,QAAQ,OAAO,iBAAiB,WACpD,EAAE,KAAK,aAAa,IACnB,gBAAgB,CAAC;EAExB,MAAM,UACJ,QAAQ,QAAQ,SAAY,OAAO,QAAQ,GAAG,oBAAI,IAAI,KAAK;EAC7D,MAAM,iBAAiB,OAAO,IAAI,CAAC,CAAC,QAAQ,IAAI,QAAQ,QAAQ,KAAK;EAErE,IAAI,OAAO,QAAQ;EACnB,IAAI,CAAC,MAAM;GACT,MAAM,eAAe,KAAK,IAAI,aAAa;GAC3C,OACE,oBAAoB,MACjB,GAAG,iBAAiB,gBAAgB,WACvC,CAAC,GAAG,MAAM;EACd;EAEA,MAAM,cACJ,oBAAoB,MAAM,CAAC,cAAc,aAAa,IAAI,CAAC,GAAG,MAAM;EAEtE,OAAO,IAAI,KAAK,mBAAmB,QAAQ;GACzC,SAAS;GACT,OAAO,QAAQ;EACjB,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,gBAAgB,WAAW,GAAG,IAAI;CACzD;;CAGA,OAAO,OAAyB,YAC9B,IAAI,KAAK,WAAW,QAAQ,OAAO,CAAC,CAAC,OAAO,KAAK;CAEnD,cACE,OACA,iBACA,iBACW;EACX,MAAM,kBACJ,OAAO,oBAAoB,WAAW,eAAe;EACvD,IAAI;GACF,OACE,IAAI,KAAK,aACP,CAAC,MAAM,GACP,mBAAmB,EAAE,MAAM,WAAW,CACxC,CAAC,CAAC,GAAG,KAAK,KAAK;EAEnB,QAAQ;GACN,OAAO;EACT;CACF;AACF"}

package/dist/esm/shared/namespaceTranslator.mjs

@@ -1,26 +1,10 @@
-import { getIntlayer } from "@intlayer/core/interpreter";
-import { parseTaggedMessage, resolveMessage } from "@intlayer/core/messageFormat";
 import { Fragment } from "react";
+import { getIntlayer } from "@intlayer/core/interpreter";
+import { navigatePath, navigatePath as navigatePath$1, parseTaggedMessage, resolveMessage } from "@intlayer/core/messageFormat";
+import { getDictionaries } from "@intlayer/dictionaries-entry";
 import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 
 //#region src/shared/namespaceTranslator.tsx
-/**
-* Reads a dotted `path` (e.g. `counter.label`) out of a nested object value.
-*
-* @param objectValue - The object to read from.
-* @param path - Dot-separated path. An empty path returns `objectValue`.
-* @returns The value found at `path`, or `undefined` when any segment is absent.
-*/
-const navigatePath = (objectValue, path) => {
-	if (!path) return objectValue;
-	const parts = path.split(".");
-	let current = objectValue;
-	for (const part of parts) {
-		if (current === null || current === void 0 || typeof current !== "object") return;
-		current = current[part];
-	}
-	return current;
-};
 /** Splits rich values into scalar interpolation values and tag renderers. */
 const splitRichValues = (values = {}) => {
 	const scalarValues = {};
@@ -65,26 +49,63 @@ const renderMarkupTokens = (tokens, renderers) => tokens.map((token) => {
 const createNamespaceTranslator = (locale, namespace) => {
 	const [dictionaryKey, ...prefixSegments] = (namespace ?? "").split(".");
 	const keyPrefix = prefixSegments.join(".");
-	const lookup = (key) => {
-		let targetDictionaryKey = dictionaryKey;
-		let path = keyPrefix ? `${keyPrefix}.${key}` : key;
-		if (!targetDictionaryKey) {
-			const [firstSegment, ...restSegments] = key.split(".");
-			targetDictionaryKey = firstSegment;
-			path = restSegments.join(".");
-		}
-		try {
-			return navigatePath(getIntlayer(targetDictionaryKey, locale), path);
-		} catch {
-			return;
-		}
-	};
+	const lookup = (lookupKey) => lookupNamespaceKey(locale, dictionaryKey ?? "", keyPrefix, lookupKey);
+	return createLookupTranslator(locale, lookup, (key) => namespace ? `${namespace}.${key}` : key);
+};
+/**
+* Key-based lookup used by {@link createNamespaceTranslator}: resolves the
+* dictionary through the runtime registry (`getIntlayer`).
+*/
+const lookupNamespaceKey = (locale, dictionaryKey, keyPrefix, key) => {
+	let targetDictionaryKey = dictionaryKey;
+	let path = keyPrefix ? `${keyPrefix}.${key}` : key;
+	const dictionaries = getDictionaries();
+	if (!targetDictionaryKey) {
+		const [firstSegment, ...restSegments] = key.split(".");
+		targetDictionaryKey = firstSegment ?? key;
+		path = restSegments.join(".");
+		if (!dictionaries[targetDictionaryKey]) for (const dictKey of Object.keys(dictionaries)) try {
+			const result = navigatePath$1(getIntlayer(dictKey, locale), key);
+			if (result !== void 0) return result;
+		} catch {}
+	}
+	try {
+		return navigatePath$1(getIntlayer(targetDictionaryKey, locale), path);
+	} catch {
+		return;
+	}
+};
+/**
+* Dictionary-bound translator used by the build-optimized `useDictionary` /
+* `getDictionary` variants: instead of resolving the dictionary by key at
+* runtime, the pre-resolved content is supplied directly (the babel/swc
+* optimize pass imports the dictionary JSON at build time).
+*
+* @param locale - The locale messages are resolved for.
+* @param content - The dictionary content, already resolved for `locale`.
+* @param namespacePrefix - Optional key prefix for nested namespaces
+*   (`useTranslations('about.counter')` → content of `about`, prefix `counter`).
+* @returns A translate function augmented with `has`, `raw`, `rich`, `markup`.
+*/
+const createDictionaryTranslator = (locale, content, namespacePrefix) => {
+	const resolveKey = (key) => namespacePrefix ? `${namespacePrefix}.${key}` : key;
+	return createLookupTranslator(locale, (key) => navigatePath$1(content, resolveKey(key)), resolveKey);
+};
+/**
+* The untyped runtime translator core shared by every factory above:
+* ICU message resolution plus the `has` / `raw` / `rich` / `markup` helpers.
+*
+* @param locale - The locale messages are resolved for.
+* @param lookup - Reads the raw content value for a message key.
+* @param missingKeyFallback - Builds the echoed key on lookup miss
+*   (use-intl convention: `namespace.key`).
+*/
+const createLookupTranslator = (locale, lookup, missingKeyFallback) => {
 	const resolveToString = (key, values = {}) => {
 		const rawValue = lookup(key);
 		if (rawValue === null || rawValue === void 0) return void 0;
 		return resolveMessage(rawValue, values, locale, "icu");
 	};
-	const missingKeyFallback = (key) => namespace ? `${namespace}.${key}` : key;
 	const translate = (key, values) => resolveToString(key, values) ?? missingKeyFallback(key);
 	return Object.assign(translate, {
 		/** Returns `true` if the given key exists in the namespace. */
@@ -115,5 +136,5 @@ const createNamespaceTranslator = (locale, namespace) => {
 };
 
 //#endregion
-export { createNamespaceTranslator, navigatePath };
+export { createDictionaryTranslator, createNamespaceTranslator, navigatePath };
 //# sourceMappingURL=namespaceTranslator.mjs.map

package/dist/esm/shared/namespaceTranslator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"namespaceTranslator.mjs","names":[],"sources":["../../../src/shared/namespaceTranslator.tsx"],"sourcesContent":["import { getIntlayer } from '@intlayer/core/interpreter';\nimport {\n  type MessageValues,\n  parseTaggedMessage,\n  resolveMessage,\n  type TaggedMessageToken,\n} from '@intlayer/core/messageFormat';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { Fragment, type ReactNode } from 'react';\n\n/** Chunk renderer used by `t.rich()` — maps tag children to a React node. */\nexport type RichChunkRenderer = (chunks: ReactNode) => ReactNode;\n\n/** Chunk renderer used by `t.markup()` — maps tag children to a string. */\nexport type MarkupChunkRenderer = (chunks: string) => string;\n\n/**\n * Reads a dotted `path` (e.g. `counter.label`) out of a nested object value.\n *\n * @param objectValue - The object to read from.\n * @param path - Dot-separated path. An empty path returns `objectValue`.\n * @returns The value found at `path`, or `undefined` when any segment is absent.\n */\nexport const navigatePath = (objectValue: unknown, path: string): unknown => {\n  if (!path) return objectValue;\n  const parts = path.split('.');\n  let current: unknown = objectValue;\n  for (const part of parts) {\n    if (\n      current === null ||\n      current === undefined ||\n      typeof current !== 'object'\n    ) {\n      return undefined;\n    }\n    current = (current as Record<string, unknown>)[part];\n  }\n  return current;\n};\n\n/** Splits rich values into scalar interpolation values and tag renderers. */\nconst splitRichValues = (\n  values: Record<string, unknown> = {}\n): { scalarValues: MessageValues; renderers: Record<string, unknown> } => {\n  const scalarValues: MessageValues = {};\n  const renderers: Record<string, unknown> = {};\n\n  for (const [valueKey, value] of Object.entries(values)) {\n    if (typeof value === 'function') renderers[valueKey] = value;\n    else scalarValues[valueKey] = value;\n  }\n\n  return { scalarValues, renderers };\n};\n\nconst renderRichTokens = (\n  tokens: TaggedMessageToken[],\n  renderers: Record<string, unknown>\n): ReactNode[] =>\n  tokens.map((token, tokenIndex) => {\n    if (typeof token === 'string') return token;\n\n    const children = renderRichTokens(token.children, renderers);\n    const renderer = renderers[token.tag];\n\n    if (typeof renderer === 'function') {\n      return (\n        <Fragment key={tokenIndex}>\n          {(renderer as RichChunkRenderer)(children)}\n        </Fragment>\n      );\n    }\n\n    // No renderer provided for the tag — render its children unwrapped\n    return <Fragment key={tokenIndex}>{children}</Fragment>;\n  });\n\nconst renderMarkupTokens = (\n  tokens: TaggedMessageToken[],\n  renderers: Record<string, unknown>\n): string =>\n  tokens\n    .map((token) => {\n      if (typeof token === 'string') return token;\n\n      const children = renderMarkupTokens(token.children, renderers);\n      const renderer = renderers[token.tag];\n\n      if (typeof renderer === 'function') {\n        return (renderer as MarkupChunkRenderer)(children);\n      }\n\n      return children;\n    })\n    .join('');\n\n/**\n * The untyped runtime translator shared by `useTranslations` (React hook) and\n * `createTranslator` (non-React core).\n *\n * Behaviour matches use-intl / next-intl:\n * - namespace `'about'` → keys resolved inside the `about` dictionary\n * - namespace `'about.counter'` → dictionary `about`, key prefix `counter`\n * - no namespace → the first segment of each key is the dictionary key\n * - messages support ICU syntax (plural, select, `#`, formatted arguments)\n * - `t.rich` / `t.markup` map `<tag>chunks</tag>` through the provided\n *   renderers; `t.raw` returns the raw value; `t.has` checks existence\n *\n * @param locale - The locale dictionaries are resolved for.\n * @param namespace - Optional dictionary key, optionally with a nested scope.\n * @returns A translate function augmented with `has`, `raw`, `rich`, `markup`.\n */\nexport const createNamespaceTranslator = (\n  locale: LocalesValues,\n  namespace?: string\n) => {\n  const [dictionaryKey, ...prefixSegments] = (namespace ?? '').split('.');\n  const keyPrefix = prefixSegments.join('.');\n\n  const lookup = (key: string): unknown => {\n    let targetDictionaryKey = dictionaryKey;\n    let path = keyPrefix ? `${keyPrefix}.${key}` : key;\n\n    if (!targetDictionaryKey) {\n      // Root scope — the first key segment designates the dictionary\n      const [firstSegment, ...restSegments] = key.split('.');\n      targetDictionaryKey = firstSegment;\n      path = restSegments.join('.');\n    }\n\n    try {\n      const dictionary = getIntlayer(\n        targetDictionaryKey as DictionaryKeys,\n        locale\n      );\n      return navigatePath(dictionary, path);\n    } catch {\n      return undefined;\n    }\n  };\n\n  const resolveToString = (\n    key: string,\n    values: MessageValues = {}\n  ): string | undefined => {\n    const rawValue = lookup(key);\n    if (rawValue === null || rawValue === undefined) return undefined;\n    return resolveMessage(rawValue, values, locale, 'icu');\n  };\n\n  const missingKeyFallback = (key: string): string =>\n    namespace ? `${namespace}.${key}` : key;\n\n  const translate = (key: string, values?: MessageValues): string =>\n    resolveToString(key, values) ?? missingKeyFallback(key);\n\n  return Object.assign(translate, {\n    /** Returns `true` if the given key exists in the namespace. */\n    has: (key: string): boolean => lookup(key) !== undefined,\n\n    /** Returns the raw unprocessed content for the given key. */\n    raw: (key: string): unknown => lookup(key),\n\n    /**\n     * Resolves a message containing `<tag>chunks</tag>` markup, mapping each\n     * tag through the matching renderer in `values`.\n     */\n    rich: (key: string, values?: Record<string, unknown>): ReactNode => {\n      const { scalarValues, renderers } = splitRichValues(values);\n      const message = resolveToString(key, scalarValues);\n      if (message === undefined) return missingKeyFallback(key);\n      return <>{renderRichTokens(parseTaggedMessage(message), renderers)}</>;\n    },\n\n    /**\n     * Resolves a message containing `<tag>chunks</tag>` markup into a string,\n     * mapping each tag through the matching string renderer in `values`.\n     */\n    markup: (key: string, values?: Record<string, unknown>): string => {\n      const { scalarValues, renderers } = splitRichValues(values);\n      const message = resolveToString(key, scalarValues);\n      if (message === undefined) return missingKeyFallback(key);\n      return renderMarkupTokens(parseTaggedMessage(message), renderers);\n    },\n  });\n};\n\nexport type CompatTranslator = ReturnType<typeof createNamespaceTranslator>;\n"],"mappings":";;;;;;;;;;;;;AA0BA,MAAa,gBAAgB,aAAsB,SAA0B;AAC3E,KAAI,CAAC,KAAM,QAAO;CAClB,MAAM,QAAQ,KAAK,MAAM,IAAI;CAC7B,IAAI,UAAmB;AACvB,MAAK,MAAM,QAAQ,OAAO;AACxB,MACE,YAAY,QACZ,YAAY,UACZ,OAAO,YAAY,SAEnB;AAEF,YAAW,QAAoC;;AAEjD,QAAO;;;AAIT,MAAM,mBACJ,SAAkC,EAAE,KACoC;CACxE,MAAM,eAA8B,EAAE;CACtC,MAAM,YAAqC,EAAE;AAE7C,MAAK,MAAM,CAAC,UAAU,UAAU,OAAO,QAAQ,OAAO,CACpD,KAAI,OAAO,UAAU,WAAY,WAAU,YAAY;KAClD,cAAa,YAAY;AAGhC,QAAO;EAAE;EAAc;EAAW;;AAGpC,MAAM,oBACJ,QACA,cAEA,OAAO,KAAK,OAAO,eAAe;AAChC,KAAI,OAAO,UAAU,SAAU,QAAO;CAEtC,MAAM,WAAW,iBAAiB,MAAM,UAAU,UAAU;CAC5D,MAAM,WAAW,UAAU,MAAM;AAEjC,KAAI,OAAO,aAAa,WACtB,QACE,oBAAC,UAAD,YACI,SAA+B,SAAS,EACjC,EAFI,WAEJ;AAKf,QAAO,oBAAC,UAAD,EAA4B,UAAoB,EAAjC,WAAiC;EACvD;AAEJ,MAAM,sBACJ,QACA,cAEA,OACG,KAAK,UAAU;AACd,KAAI,OAAO,UAAU,SAAU,QAAO;CAEtC,MAAM,WAAW,mBAAmB,MAAM,UAAU,UAAU;CAC9D,MAAM,WAAW,UAAU,MAAM;AAEjC,KAAI,OAAO,aAAa,WACtB,QAAQ,SAAiC,SAAS;AAGpD,QAAO;EACP,CACD,KAAK,GAAG;;;;;;;;;;;;;;;;;AAkBb,MAAa,6BACX,QACA,cACG;CACH,MAAM,CAAC,eAAe,GAAG,mBAAmB,aAAa,IAAI,MAAM,IAAI;CACvE,MAAM,YAAY,eAAe,KAAK,IAAI;CAE1C,MAAM,UAAU,QAAyB;EACvC,IAAI,sBAAsB;EAC1B,IAAI,OAAO,YAAY,GAAG,UAAU,GAAG,QAAQ;AAE/C,MAAI,CAAC,qBAAqB;GAExB,MAAM,CAAC,cAAc,GAAG,gBAAgB,IAAI,MAAM,IAAI;AACtD,yBAAsB;AACtB,UAAO,aAAa,KAAK,IAAI;;AAG/B,MAAI;AAKF,UAAO,aAJY,YACjB,qBACA,OAE4B,EAAE,KAAK;UAC/B;AACN;;;CAIJ,MAAM,mBACJ,KACA,SAAwB,EAAE,KACH;EACvB,MAAM,WAAW,OAAO,IAAI;AAC5B,MAAI,aAAa,QAAQ,aAAa,OAAW,QAAO;AACxD,SAAO,eAAe,UAAU,QAAQ,QAAQ,MAAM;;CAGxD,MAAM,sBAAsB,QAC1B,YAAY,GAAG,UAAU,GAAG,QAAQ;CAEtC,MAAM,aAAa,KAAa,WAC9B,gBAAgB,KAAK,OAAO,IAAI,mBAAmB,IAAI;AAEzD,QAAO,OAAO,OAAO,WAAW;;EAE9B,MAAM,QAAyB,OAAO,IAAI,KAAK;;EAG/C,MAAM,QAAyB,OAAO,IAAI;;;;;EAM1C,OAAO,KAAa,WAAgD;GAClE,MAAM,EAAE,cAAc,cAAc,gBAAgB,OAAO;GAC3D,MAAM,UAAU,gBAAgB,KAAK,aAAa;AAClD,OAAI,YAAY,OAAW,QAAO,mBAAmB,IAAI;AACzD,UAAO,4CAAG,iBAAiB,mBAAmB,QAAQ,EAAE,UAAU,EAAI;;;;;;EAOxE,SAAS,KAAa,WAA6C;GACjE,MAAM,EAAE,cAAc,cAAc,gBAAgB,OAAO;GAC3D,MAAM,UAAU,gBAAgB,KAAK,aAAa;AAClD,OAAI,YAAY,OAAW,QAAO,mBAAmB,IAAI;AACzD,UAAO,mBAAmB,mBAAmB,QAAQ,EAAE,UAAU;;EAEpE,CAAC"}
+{"version":3,"file":"namespaceTranslator.mjs","names":["navigatePath"],"sources":["../../../src/shared/namespaceTranslator.tsx"],"sourcesContent":["import { getIntlayer } from '@intlayer/core/interpreter';\nimport {\n  type MessageValues,\n  navigatePath,\n  parseTaggedMessage,\n  resolveMessage,\n  type TaggedMessageToken,\n} from '@intlayer/core/messageFormat';\nimport { getDictionaries } from '@intlayer/dictionaries-entry';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { Fragment, type ReactNode } from 'react';\n\nexport { navigatePath } from '@intlayer/core/messageFormat';\n\n/** Chunk renderer used by `t.rich()` — maps tag children to a React node. */\nexport type RichChunkRenderer = (chunks: ReactNode) => ReactNode;\n\n/** Chunk renderer used by `t.markup()` — maps tag children to a string. */\nexport type MarkupChunkRenderer = (chunks: string) => string;\n\n/** Splits rich values into scalar interpolation values and tag renderers. */\nconst splitRichValues = (\n  values: Record<string, unknown> = {}\n): { scalarValues: MessageValues; renderers: Record<string, unknown> } => {\n  const scalarValues: MessageValues = {};\n  const renderers: Record<string, unknown> = {};\n\n  for (const [valueKey, value] of Object.entries(values)) {\n    if (typeof value === 'function') renderers[valueKey] = value;\n    else scalarValues[valueKey] = value;\n  }\n\n  return { scalarValues, renderers };\n};\n\nconst renderRichTokens = (\n  tokens: TaggedMessageToken[],\n  renderers: Record<string, unknown>\n): ReactNode[] =>\n  tokens.map((token, tokenIndex) => {\n    if (typeof token === 'string') return token;\n\n    const children = renderRichTokens(token.children, renderers);\n    const renderer = renderers[token.tag];\n\n    if (typeof renderer === 'function') {\n      return (\n        <Fragment key={tokenIndex}>\n          {(renderer as RichChunkRenderer)(children)}\n        </Fragment>\n      );\n    }\n\n    // No renderer provided for the tag — render its children unwrapped\n    return <Fragment key={tokenIndex}>{children}</Fragment>;\n  });\n\nconst renderMarkupTokens = (\n  tokens: TaggedMessageToken[],\n  renderers: Record<string, unknown>\n): string =>\n  tokens\n    .map((token) => {\n      if (typeof token === 'string') return token;\n\n      const children = renderMarkupTokens(token.children, renderers);\n      const renderer = renderers[token.tag];\n\n      if (typeof renderer === 'function') {\n        return (renderer as MarkupChunkRenderer)(children);\n      }\n\n      return children;\n    })\n    .join('');\n\n/**\n * The untyped runtime translator shared by `useTranslations` (React hook) and\n * `createTranslator` (non-React core).\n *\n * Behaviour matches use-intl / next-intl:\n * - namespace `'about'` → keys resolved inside the `about` dictionary\n * - namespace `'about.counter'` → dictionary `about`, key prefix `counter`\n * - no namespace → the first segment of each key is the dictionary key\n * - messages support ICU syntax (plural, select, `#`, formatted arguments)\n * - `t.rich` / `t.markup` map `<tag>chunks</tag>` through the provided\n *   renderers; `t.raw` returns the raw value; `t.has` checks existence\n *\n * @param locale - The locale dictionaries are resolved for.\n * @param namespace - Optional dictionary key, optionally with a nested scope.\n * @returns A translate function augmented with `has`, `raw`, `rich`, `markup`.\n */\nexport const createNamespaceTranslator = (\n  locale: LocalesValues,\n  namespace?: string\n) => {\n  const [dictionaryKey, ...prefixSegments] = (namespace ?? '').split('.');\n  const keyPrefix = prefixSegments.join('.');\n\n  const lookup = (lookupKey: string): unknown =>\n    lookupNamespaceKey(locale, dictionaryKey ?? '', keyPrefix, lookupKey);\n\n  return createLookupTranslator(locale, lookup, (key) =>\n    namespace ? `${namespace}.${key}` : key\n  );\n};\n\n/**\n * Key-based lookup used by {@link createNamespaceTranslator}: resolves the\n * dictionary through the runtime registry (`getIntlayer`).\n */\nconst lookupNamespaceKey = (\n  locale: LocalesValues,\n  dictionaryKey: string,\n  keyPrefix: string,\n  key: string\n): unknown => {\n  let targetDictionaryKey = dictionaryKey;\n  let path = keyPrefix ? `${keyPrefix}.${key}` : key;\n\n  const dictionaries = getDictionaries();\n\n  if (!targetDictionaryKey) {\n    // Root scope — the first key segment usually designates the dictionary\n    const [firstSegment, ...restSegments] = key.split('.');\n    targetDictionaryKey = firstSegment ?? key;\n    path = restSegments.join('.');\n\n    // If the assumed dictionary doesn't exist, we must fall back to searching all dictionaries.\n    // This supports apps migrating from standard next-intl where all messages were grouped together.\n    if (!dictionaries[targetDictionaryKey as DictionaryKeys]) {\n      for (const dictKey of Object.keys(dictionaries)) {\n        try {\n          const dictionary = getIntlayer(dictKey as DictionaryKeys, locale);\n          const result = navigatePath(dictionary, key);\n          if (result !== undefined) {\n            return result;\n          }\n        } catch {\n          // Ignore if getIntlayer throws\n        }\n      }\n    }\n  }\n\n  try {\n    const dictionary = getIntlayer(\n      targetDictionaryKey as DictionaryKeys,\n      locale\n    );\n    return navigatePath(dictionary, path);\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * Dictionary-bound translator used by the build-optimized `useDictionary` /\n * `getDictionary` variants: instead of resolving the dictionary by key at\n * runtime, the pre-resolved content is supplied directly (the babel/swc\n * optimize pass imports the dictionary JSON at build time).\n *\n * @param locale - The locale messages are resolved for.\n * @param content - The dictionary content, already resolved for `locale`.\n * @param namespacePrefix - Optional key prefix for nested namespaces\n *   (`useTranslations('about.counter')` → content of `about`, prefix `counter`).\n * @returns A translate function augmented with `has`, `raw`, `rich`, `markup`.\n */\nexport const createDictionaryTranslator = (\n  locale: LocalesValues,\n  content: unknown,\n  namespacePrefix?: string\n) => {\n  const resolveKey = (key: string): string =>\n    namespacePrefix ? `${namespacePrefix}.${key}` : key;\n\n  return createLookupTranslator(\n    locale,\n    (key) => navigatePath(content, resolveKey(key)),\n    resolveKey\n  );\n};\n\n/**\n * The untyped runtime translator core shared by every factory above:\n * ICU message resolution plus the `has` / `raw` / `rich` / `markup` helpers.\n *\n * @param locale - The locale messages are resolved for.\n * @param lookup - Reads the raw content value for a message key.\n * @param missingKeyFallback - Builds the echoed key on lookup miss\n *   (use-intl convention: `namespace.key`).\n */\nconst createLookupTranslator = (\n  locale: LocalesValues,\n  lookup: (key: string) => unknown,\n  missingKeyFallback: (key: string) => string\n) => {\n  const resolveToString = (\n    key: string,\n    values: MessageValues = {}\n  ): string | undefined => {\n    const rawValue = lookup(key);\n    if (rawValue === null || rawValue === undefined) return undefined;\n    return resolveMessage(rawValue, values, locale, 'icu');\n  };\n\n  const translate = (key: string, values?: MessageValues): string =>\n    resolveToString(key, values) ?? missingKeyFallback(key);\n\n  return Object.assign(translate, {\n    /** Returns `true` if the given key exists in the namespace. */\n    has: (key: string): boolean => lookup(key) !== undefined,\n\n    /** Returns the raw unprocessed content for the given key. */\n    raw: (key: string): unknown => lookup(key),\n\n    /**\n     * Resolves a message containing `<tag>chunks</tag>` markup, mapping each\n     * tag through the matching renderer in `values`.\n     */\n    rich: (key: string, values?: Record<string, unknown>): ReactNode => {\n      const { scalarValues, renderers } = splitRichValues(values);\n      const message = resolveToString(key, scalarValues);\n      if (message === undefined) return missingKeyFallback(key);\n      return <>{renderRichTokens(parseTaggedMessage(message), renderers)}</>;\n    },\n\n    /**\n     * Resolves a message containing `<tag>chunks</tag>` markup into a string,\n     * mapping each tag through the matching string renderer in `values`.\n     */\n    markup: (key: string, values?: Record<string, unknown>): string => {\n      const { scalarValues, renderers } = splitRichValues(values);\n      const message = resolveToString(key, scalarValues);\n      if (message === undefined) return missingKeyFallback(key);\n      return renderMarkupTokens(parseTaggedMessage(message), renderers);\n    },\n  });\n};\n\nexport type CompatTranslator = ReturnType<typeof createNamespaceTranslator>;\n"],"mappings":";;;;;;;;AAwBA,MAAM,mBACJ,SAAkC,CAAC,MACqC;CACxE,MAAM,eAA8B,CAAC;CACrC,MAAM,YAAqC,CAAC;CAE5C,KAAK,MAAM,CAAC,UAAU,UAAU,OAAO,QAAQ,MAAM,GACnD,IAAI,OAAO,UAAU,YAAY,UAAU,YAAY;MAClD,aAAa,YAAY;CAGhC,OAAO;EAAE;EAAc;CAAU;AACnC;AAEA,MAAM,oBACJ,QACA,cAEA,OAAO,KAAK,OAAO,eAAe;CAChC,IAAI,OAAO,UAAU,UAAU,OAAO;CAEtC,MAAM,WAAW,iBAAiB,MAAM,UAAU,SAAS;CAC3D,MAAM,WAAW,UAAU,MAAM;CAEjC,IAAI,OAAO,aAAa,YACtB,OACE,oBAAC,UAAD,YACI,SAA+B,QAAQ,EACjC,GAFK,UAEL;CAKd,OAAO,oBAAC,UAAD,EAA4B,SAAmB,GAAhC,UAAgC;AACxD,CAAC;AAEH,MAAM,sBACJ,QACA,cAEA,OACG,KAAK,UAAU;CACd,IAAI,OAAO,UAAU,UAAU,OAAO;CAEtC,MAAM,WAAW,mBAAmB,MAAM,UAAU,SAAS;CAC7D,MAAM,WAAW,UAAU,MAAM;CAEjC,IAAI,OAAO,aAAa,YACtB,OAAQ,SAAiC,QAAQ;CAGnD,OAAO;AACT,CAAC,CAAC,CACD,KAAK,EAAE;;;;;;;;;;;;;;;;;AAkBZ,MAAa,6BACX,QACA,cACG;CACH,MAAM,CAAC,eAAe,GAAG,mBAAmB,aAAa,GAAE,CAAE,MAAM,GAAG;CACtE,MAAM,YAAY,eAAe,KAAK,GAAG;CAEzC,MAAM,UAAU,cACd,mBAAmB,QAAQ,iBAAiB,IAAI,WAAW,SAAS;CAEtE,OAAO,uBAAuB,QAAQ,SAAS,QAC7C,YAAY,GAAG,UAAU,GAAG,QAAQ,GACtC;AACF;;;;;AAMA,MAAM,sBACJ,QACA,eACA,WACA,QACY;CACZ,IAAI,sBAAsB;CAC1B,IAAI,OAAO,YAAY,GAAG,UAAU,GAAG,QAAQ;CAE/C,MAAM,eAAe,gBAAgB;CAErC,IAAI,CAAC,qBAAqB;EAExB,MAAM,CAAC,cAAc,GAAG,gBAAgB,IAAI,MAAM,GAAG;EACrD,sBAAsB,gBAAgB;EACtC,OAAO,aAAa,KAAK,GAAG;EAI5B,IAAI,CAAC,aAAa,sBAChB,KAAK,MAAM,WAAW,OAAO,KAAK,YAAY,GAC5C,IAAI;GAEF,MAAM,SAASA,eADI,YAAY,SAA2B,MACrB,GAAG,GAAG;GAC3C,IAAI,WAAW,QACb,OAAO;EAEX,QAAQ,CAER;CAGN;CAEA,IAAI;EAKF,OAAOA,eAJY,YACjB,qBACA,MAE2B,GAAG,IAAI;CACtC,QAAQ;EACN;CACF;AACF;;;;;;;;;;;;;AAcA,MAAa,8BACX,QACA,SACA,oBACG;CACH,MAAM,cAAc,QAClB,kBAAkB,GAAG,gBAAgB,GAAG,QAAQ;CAElD,OAAO,uBACL,SACC,QAAQA,eAAa,SAAS,WAAW,GAAG,CAAC,GAC9C,UACF;AACF;;;;;;;;;;AAWA,MAAM,0BACJ,QACA,QACA,uBACG;CACH,MAAM,mBACJ,KACA,SAAwB,CAAC,MACF;EACvB,MAAM,WAAW,OAAO,GAAG;EAC3B,IAAI,aAAa,QAAQ,aAAa,QAAW,OAAO;EACxD,OAAO,eAAe,UAAU,QAAQ,QAAQ,KAAK;CACvD;CAEA,MAAM,aAAa,KAAa,WAC9B,gBAAgB,KAAK,MAAM,KAAK,mBAAmB,GAAG;CAExD,OAAO,OAAO,OAAO,WAAW;;EAE9B,MAAM,QAAyB,OAAO,GAAG,MAAM;;EAG/C,MAAM,QAAyB,OAAO,GAAG;;;;;EAMzC,OAAO,KAAa,WAAgD;GAClE,MAAM,EAAE,cAAc,cAAc,gBAAgB,MAAM;GAC1D,MAAM,UAAU,gBAAgB,KAAK,YAAY;GACjD,IAAI,YAAY,QAAW,OAAO,mBAAmB,GAAG;GACxD,OAAO,4CAAG,iBAAiB,mBAAmB,OAAO,GAAG,SAAS,EAAI;EACvE;;;;;EAMA,SAAS,KAAa,WAA6C;GACjE,MAAM,EAAE,cAAc,cAAc,gBAAgB,MAAM;GAC1D,MAAM,UAAU,gBAAgB,KAAK,YAAY;GACjD,IAAI,YAAY,QAAW,OAAO,mBAAmB,GAAG;GACxD,OAAO,mBAAmB,mBAAmB,OAAO,GAAG,SAAS;EAClE;CACF,CAAC;AACH"}

package/dist/esm/useDictionary.mjs

@@ -1,7 +1,8 @@
 'use client';
 
-import { navigatePath } from "./shared/namespaceTranslator.mjs";
-import { useDictionary as useDictionary$1 } from "react-intlayer";
+import { createDictionaryTranslator } from "./shared/namespaceTranslator.mjs";
+import { useContext } from "react";
+import { IntlayerClientContext, useDictionary as useDictionary$1 } from "react-intlayer";
 
 //#region src/useDictionary.ts
 /**
@@ -12,23 +13,17 @@ import { useDictionary as useDictionary$1 } from "react-intlayer";
 * JSON at build time and passes it directly here. This enables tree-shaking of
 * unused locale content.
 *
+* The returned translator matches `useTranslations` exactly (ICU messages,
+* `has`, `raw`, `rich`, `markup`).
+*
 * @example (generated by the plugin, not written manually)
 * import _abc from '.intlayer/dictionaries/about.json' with { type: 'json' };
 * const t = useDictionary(_abc);
 */
-const useDictionary = (dictionary, namespacePrefix) => {
-	const content = useDictionary$1(dictionary);
-	const resolveKey = (key) => namespacePrefix ? `${namespacePrefix}.${key}` : key;
-	return Object.assign((lookup, params) => {
-		const rawValue = navigatePath(content, resolveKey(String(lookup)));
-		const text = String(rawValue ?? resolveKey(String(lookup)));
-		if (!params) return text;
-		return text.replace(/\{(\w+)\}/g, (_match, key) => params[key] != null ? String(params[key]) : `{${key}}`);
-	}, {
-		has: (lookup) => navigatePath(content, resolveKey(String(lookup))) != null,
-		raw: (lookup) => navigatePath(content, resolveKey(String(lookup)))
-	});
-};
+const useDictionary = ((dictionary, namespacePrefix) => {
+	const { locale } = useContext(IntlayerClientContext) ?? {};
+	return createDictionaryTranslator(locale, useDictionary$1(dictionary), namespacePrefix);
+});
 
 //#endregion
 export { useDictionary };

package/dist/esm/useDictionary.mjs.map

@@ -1 +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 { useDictionary as useDictionaryBase } from 'react-intlayer';\nimport { navigatePath } from './shared/namespaceTranslator';\n\n/**\n * Dictionary-accepting variant of `useTranslations`.\n *\n * Used internally by the build-time optimization: instead of looking up the\n * dictionary at runtime by key, the babel/swc plugin pre-imports the dictionary\n * JSON at build time and passes it directly here. This enables tree-shaking of\n * unused locale content.\n *\n * @example (generated by the plugin, 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  namespacePrefix?: string\n) => {\n  const content = useDictionaryBase(dictionary);\n\n  const resolveKey = (key: string): string =>\n    namespacePrefix ? `${namespacePrefix}.${key}` : key;\n\n  return Object.assign(\n    <P extends ValidDotPathsFor<string>>(\n      lookup: P,\n      params?: Record<string, unknown>\n    ): string => {\n      const rawValue = navigatePath(content, resolveKey(String(lookup)));\n      const text = String(rawValue ?? resolveKey(String(lookup)));\n      if (!params) return text;\n      return text.replace(/\\{(\\w+)\\}/g, (_match, key) =>\n        params[key] != null ? String(params[key]) : `{${key}}`\n      );\n    },\n    {\n      has: <P extends ValidDotPathsFor<string>>(lookup: P): boolean =>\n        navigatePath(content, resolveKey(String(lookup))) != null,\n      raw: <P extends ValidDotPathsFor<string>>(lookup: P): unknown =>\n        navigatePath(content, resolveKey(String(lookup))),\n    }\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAmBA,MAAa,iBACX,YACA,oBACG;CACH,MAAM,UAAUA,gBAAkB,WAAW;CAE7C,MAAM,cAAc,QAClB,kBAAkB,GAAG,gBAAgB,GAAG,QAAQ;AAElD,QAAO,OAAO,QAEV,QACA,WACW;EACX,MAAM,WAAW,aAAa,SAAS,WAAW,OAAO,OAAO,CAAC,CAAC;EAClE,MAAM,OAAO,OAAO,YAAY,WAAW,OAAO,OAAO,CAAC,CAAC;AAC3D,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,KAAK,QAAQ,eAAe,QAAQ,QACzC,OAAO,QAAQ,OAAO,OAAO,OAAO,KAAK,GAAG,IAAI,IAAI,GACrD;IAEH;EACE,MAA0C,WACxC,aAAa,SAAS,WAAW,OAAO,OAAO,CAAC,CAAC,IAAI;EACvD,MAA0C,WACxC,aAAa,SAAS,WAAW,OAAO,OAAO,CAAC,CAAC;EACpD,CACF"}
+{"version":3,"file":"useDictionary.mjs","names":["useDictionaryBase"],"sources":["../../src/useDictionary.ts"],"sourcesContent":["'use client';\n\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { useContext } from 'react';\nimport {\n  IntlayerClientContext,\n  useDictionary as useDictionaryBase,\n} from 'react-intlayer';\nimport { createDictionaryTranslator } from './shared/namespaceTranslator';\nimport type {\n  ScopedTranslateFunction,\n  TranslateFunction,\n} from './shared/translateFunctionTypes';\n\n/**\n * Overload set for {@link useDictionary}: without a prefix the translator is\n * typed against the dictionary's dot-paths; with a prefix the keys are\n * relative dot-paths under that scope.\n */\ntype UseDictionary = {\n  <T extends Dictionary>(\n    dictionary: T\n  ): TranslateFunction<T['key'] & DictionaryKeys>;\n  <T extends Dictionary, Prefix extends string>(\n    dictionary: T,\n    namespacePrefix: Prefix\n  ): ScopedTranslateFunction<T['key'] & DictionaryKeys, Prefix>;\n};\n\n/**\n * Dictionary-accepting variant of `useTranslations`.\n *\n * Used internally by the build-time optimization: instead of looking up the\n * dictionary at runtime by key, the babel/swc plugin pre-imports the dictionary\n * JSON at build time and passes it directly here. This enables tree-shaking of\n * unused locale content.\n *\n * The returned translator matches `useTranslations` exactly (ICU messages,\n * `has`, `raw`, `rich`, `markup`).\n *\n * @example (generated by the plugin, 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  namespacePrefix?: string\n) => {\n  const { locale } = useContext(IntlayerClientContext) ?? {};\n  const content = useDictionaryBase(dictionary);\n\n  return createDictionaryTranslator(\n    locale as LocalesValues,\n    content,\n    namespacePrefix\n  );\n}) as UseDictionary;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAgDA,MAAa,kBACX,YACA,oBACG;CACH,MAAM,EAAE,WAAW,WAAW,qBAAqB,KAAK,CAAC;CAGzD,OAAO,2BACL,QAHcA,gBAAkB,UAI1B,GACN,eACF;AACF"}

package/dist/esm/useDictionaryDynamic.mjs

@@ -1,7 +1,8 @@
 'use client';
 
-import { navigatePath } from "./shared/namespaceTranslator.mjs";
-import { useDictionaryDynamic as useDictionaryDynamic$1 } from "react-intlayer";
+import { createDictionaryTranslator } from "./shared/namespaceTranslator.mjs";
+import { useContext } from "react";
+import { IntlayerClientContext, useDictionaryDynamic as useDictionaryDynamic$1 } from "react-intlayer";
 
 //#region src/useDictionaryDynamic.ts
 /**
@@ -10,19 +11,10 @@ import { useDictionaryDynamic as useDictionaryDynamic$1 } from "react-intlayer";
 * Counterpart to {@link useDictionary} for dictionaries imported lazily per
 * locale. Used internally by the build-time optimization.
 */
-const useDictionaryDynamic = (dictionaryPromise, key, namespacePrefix) => {
-	const content = useDictionaryDynamic$1(dictionaryPromise, key);
-	const resolveKey = (lookupKey) => namespacePrefix ? `${namespacePrefix}.${lookupKey}` : lookupKey;
-	return Object.assign((lookup, params) => {
-		const rawValue = navigatePath(content, resolveKey(String(lookup)));
-		const text = String(rawValue ?? resolveKey(String(lookup)));
-		if (!params) return text;
-		return text.replace(/\{(\w+)\}/g, (_match, key) => params[key] != null ? String(params[key]) : `{${key}}`);
-	}, {
-		has: (lookup) => navigatePath(content, resolveKey(String(lookup))) != null,
-		raw: (lookup) => navigatePath(content, resolveKey(String(lookup)))
-	});
-};
+const useDictionaryDynamic = ((dictionaryPromise, key, namespacePrefix) => {
+	const { locale } = useContext(IntlayerClientContext) ?? {};
+	return createDictionaryTranslator(locale, useDictionaryDynamic$1(dictionaryPromise, key), namespacePrefix);
+});
 
 //#endregion
 export { useDictionaryDynamic };

package/dist/esm/useDictionaryDynamic.mjs.map

@@ -1 +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 { useDictionaryDynamic as useDictionaryDynamicBase } from 'react-intlayer';\nimport { navigatePath } from './shared/namespaceTranslator';\n\n/**\n * Dynamic dictionary-accepting variant of `useTranslations`.\n *\n * Counterpart to {@link useDictionary} for dictionaries imported lazily per\n * locale. Used internally by the build-time optimization.\n */\nexport const useDictionaryDynamic = <\n  const T extends Dictionary,\n  const K extends string,\n>(\n  dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>,\n  key: K,\n  namespacePrefix?: string\n) => {\n  const content = useDictionaryDynamicBase<T, K>(dictionaryPromise, key);\n\n  const resolveKey = (lookupKey: string): string =>\n    namespacePrefix ? `${namespacePrefix}.${lookupKey}` : lookupKey;\n\n  return Object.assign(\n    <P extends ValidDotPathsFor<string>>(\n      lookup: P,\n      params?: Record<string, unknown>\n    ): string => {\n      const rawValue = navigatePath(content, resolveKey(String(lookup)));\n      const text = String(rawValue ?? resolveKey(String(lookup)));\n      if (!params) return text;\n      return text.replace(/\\{(\\w+)\\}/g, (_match, key) =>\n        params[key] != null ? String(params[key]) : `{${key}}`\n      );\n    },\n    {\n      has: <P extends ValidDotPathsFor<string>>(lookup: P): boolean =>\n        navigatePath(content, resolveKey(String(lookup))) != null,\n      raw: <P extends ValidDotPathsFor<string>>(lookup: P): unknown =>\n        navigatePath(content, resolveKey(String(lookup))),\n    }\n  );\n};\n"],"mappings":";;;;;;;;;;;;AAcA,MAAa,wBAIX,mBACA,KACA,oBACG;CACH,MAAM,UAAUA,uBAA+B,mBAAmB,IAAI;CAEtE,MAAM,cAAc,cAClB,kBAAkB,GAAG,gBAAgB,GAAG,cAAc;AAExD,QAAO,OAAO,QAEV,QACA,WACW;EACX,MAAM,WAAW,aAAa,SAAS,WAAW,OAAO,OAAO,CAAC,CAAC;EAClE,MAAM,OAAO,OAAO,YAAY,WAAW,OAAO,OAAO,CAAC,CAAC;AAC3D,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,KAAK,QAAQ,eAAe,QAAQ,QACzC,OAAO,QAAQ,OAAO,OAAO,OAAO,KAAK,GAAG,IAAI,IAAI,GACrD;IAEH;EACE,MAA0C,WACxC,aAAa,SAAS,WAAW,OAAO,OAAO,CAAC,CAAC,IAAI;EACvD,MAA0C,WACxC,aAAa,SAAS,WAAW,OAAO,OAAO,CAAC,CAAC;EACpD,CACF"}
+{"version":3,"file":"useDictionaryDynamic.mjs","names":["useDictionaryDynamicBase"],"sources":["../../src/useDictionaryDynamic.ts"],"sourcesContent":["'use client';\n\nimport type { Dictionary } from '@intlayer/types/dictionary';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\nimport { useContext } from 'react';\nimport {\n  IntlayerClientContext,\n  useDictionaryDynamic as useDictionaryDynamicBase,\n} from 'react-intlayer';\nimport { createDictionaryTranslator } from './shared/namespaceTranslator';\nimport type {\n  ScopedTranslateFunction,\n  TranslateFunction,\n} from './shared/translateFunctionTypes';\n\n/**\n * Overload set for {@link useDictionaryDynamic}: without a prefix the\n * translator is typed against the dictionary's dot-paths; with a prefix the\n * keys are relative dot-paths under that scope.\n */\ntype UseDictionaryDynamic = {\n  <T extends Dictionary, K extends DictionaryKeys>(\n    dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>,\n    key: K\n  ): TranslateFunction<K>;\n  <T extends Dictionary, K extends DictionaryKeys, Prefix extends string>(\n    dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>,\n    key: K,\n    namespacePrefix: Prefix\n  ): ScopedTranslateFunction<K, Prefix>;\n};\n\n/**\n * Dynamic dictionary-accepting variant of `useTranslations`.\n *\n * Counterpart to {@link useDictionary} for dictionaries imported lazily per\n * locale. Used internally by the build-time optimization.\n */\nexport const useDictionaryDynamic = (<\n  const T extends Dictionary,\n  const K extends DictionaryKeys,\n>(\n  dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>,\n  key: K,\n  namespacePrefix?: string\n) => {\n  const { locale } = useContext(IntlayerClientContext) ?? {};\n  const content = useDictionaryDynamicBase<T, K>(dictionaryPromise, key);\n\n  return createDictionaryTranslator(\n    locale as LocalesValues,\n    content,\n    namespacePrefix\n  );\n}) as UseDictionaryDynamic;\n"],"mappings":";;;;;;;;;;;;;AA0CA,MAAa,yBAIX,mBACA,KACA,oBACG;CACH,MAAM,EAAE,WAAW,WAAW,qBAAqB,KAAK,CAAC;CAGzD,OAAO,2BACL,QAHcA,uBAA+B,mBAAmB,GAI1D,GACN,eACF;AACF"}

package/dist/types/client/IntlProvider.d.ts

@@ -1,7 +1,6 @@
 import { LocalesValues } from "@intlayer/types/module_augmentation";
 import { ComponentProps } from "react";
 import { IntlProvider as IntlProvider$1 } from "use-intl";
-
 //#region src/client/IntlProvider.d.ts
 /**
  * Drop-in for use-intl's `IntlProvider`.
@@ -21,7 +20,8 @@ type IntlProviderProps = Omit<ComponentProps<typeof IntlProvider$1>, 'messages'
    * @deprecated has no use case with intlayer. Messages are loaded
    * automatically under the hood for bundle optimization reason.
    */
-  messages?: never; /** The active locale. */
+  messages?: never;
+  /** The active locale. */
   locale: LocalesValues;
 };
 //#endregion

package/dist/types/client/IntlProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IntlProvider.d.ts","names":[],"sources":["../../../src/client/IntlProvider.tsx"],"mappings":";;;;;;;AAkBA;;;;;AAiCA;cAjCa,YAAA,SAAqB,cAAA;;;;;KAiCtB,iBAAA,GAAoB,IAAA,CAC9B,cAAA,QAAsB,cAAA;EASD;;;;EAFrB,QAAA;EAEA,MAAA,EAAQ,aAAA;AAAA"}
+{"version":3,"file":"IntlProvider.d.ts","names":[],"sources":["../../../src/client/IntlProvider.tsx"],"mappings":";;;;;;;;;;;;cAkBa,qBAAqB;;;;;KAiCtB,oBAAoB,KAC9B,sBAAsB;;;;;EAOtB;;EAEA,QAAQ"}

package/dist/types/client/helpers.d.ts

@@ -1,5 +1,4 @@
 import { useFormatter as useFormatter$1, useMessages as useMessages$1, useNow as useNow$1, useTimeZone as useTimeZone$1 } from "use-intl";
-
 //#region src/client/helpers.d.ts
 /**
  * Drop-in for use-intl's `useNow`.

package/dist/types/client/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","names":[],"sources":["../../../src/client/helpers.ts"],"mappings":";;;;;AAkBA;;cAAa,MAAA,SAAe,QAAA;;;AAM5B;;cAAa,WAAA,SAAoB,aAAA;;;AAUjC;;;;;cAAa,WAAA,SAAoB,aAAA;;;;;;;cAiBpB,YAAA,SAAqB,cAAA"}
+{"version":3,"file":"helpers.d.ts","names":[],"sources":["../../../src/client/helpers.ts"],"mappings":";;;;;;cAkBa,eAAe;;;;;cAMf,oBAAoB;;;;;;;;cAUpB,oBAAoB;;;;;;;cAiBpB,qBAAqB"}

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

@@ -4,7 +4,6 @@ import { useDictionary } from "../useDictionary.js";
 import { useDictionaryDynamic } from "../useDictionaryDynamic.js";
 import { useLocale } from "./useLocale.js";
 import { useTranslations } from "./useTranslations.js";
-
 //#region src/client/index.d.ts
 /**
  * @internal Private use-intl export, kept so aliased `_useExtracted` imports

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/client/index.ts"],"mappings":";;;;;;;;;;AAWA;;cAAa,aAAA,QAAoB,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/client/index.ts"],"mappings":";;;;;;;;;;;cAWa,qBAAoB"}

package/dist/types/client/useLocale.d.ts

@@ -1,5 +1,4 @@
 import { useLocale as useLocale$1 } from "use-intl";
-
 //#region src/client/useLocale.d.ts
 /**
  * Drop-in for use-intl's `useLocale`.

package/dist/types/client/useLocale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLocale.d.ts","names":[],"sources":["../../../src/client/useLocale.ts"],"mappings":";;;;;AAUA;;;cAAa,SAAA,SAAkB,WAAA"}
+{"version":3,"file":"useLocale.d.ts","names":[],"sources":["../../../src/client/useLocale.ts"],"mappings":";;;;;;;cAUa,kBAAkB"}

package/dist/types/client/useTranslations.d.ts

@@ -1,19 +1,19 @@
-import { LooseTranslateFunction, TranslateFunction } from "../shared/translateFunctionTypes.js";
+import { LooseTranslateFunction, TranslateFunction, TranslateFunctionForNamespace } from "../shared/translateFunctionTypes.js";
 import { DictionaryKeys } from "@intlayer/types/module_augmentation";
-
 //#region src/client/useTranslations.d.ts
 /**
  * Overload set for {@link useTranslations}:
  *
  * 1. A bare dictionary key → fully-typed `t()` (autocompleted dot-paths).
  * 2. A nested namespace `'dictionary.sub.scope'` → `t()` accepts relative
- *    `string` paths, matching use-intl's scoped-namespace behaviour.
+ *    dot-paths under the scope, typed against the dictionary, matching
+ *    use-intl's scoped-namespace behaviour.
  * 3. No namespace → root scope; the first segment of each key designates
  *    the dictionary (`t('about.title')`).
  */
 type UseTranslations = {
   <N extends DictionaryKeys>(namespace: N): TranslateFunction<N>;
-  (namespace: `${string}.${string}`): LooseTranslateFunction;
+  <N extends `${string}.${string}`>(namespace: N): TranslateFunctionForNamespace<N>;
   (): LooseTranslateFunction;
 };
 /**

package/dist/types/client/useTranslations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTranslations.d.ts","names":[],"sources":["../../../src/client/useTranslations.ts"],"mappings":";;;;;;AAY0C;;;;;;;KAWrC,eAAA;EAAA,WACQ,cAAA,EAAgB,SAAA,EAAW,CAAA,GAAI,iBAAA,CAAkB,CAAA;EAAA,CAC3D,SAAA,0BAAmC,sBAAA;EAAA,IAChC,sBAAA;AAAA;;;;;;;;;;;AAyBN;;;;;;;;;;;;cAAa,eAAA,EAOP,eAAA"}
+{"version":3,"file":"useTranslations.d.ts","names":[],"sources":["../../../src/client/useTranslations.ts"],"mappings":";;;;;;;;;;;;;KAyBK;GACF,UAAU,gBAAgB,WAAW,IAAI,kBAAkB;GAC3D,iCACC,WAAW,IACV,8BAA8B;MAC7B;;;;;;;;;;;;;;;;;;;;;;;;cAyBO,iBAOP"}

package/dist/types/core/createFormatter.d.ts

@@ -1,5 +1,4 @@
 import { createFormatter as createFormatter$1 } from "use-intl";
-
 //#region src/core/createFormatter.d.ts
 /**
  * Drop-in for use-intl's `createFormatter`.

package/dist/types/core/createFormatter.d.ts.map

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

package/dist/types/core/createTranslator.d.ts

@@ -1,6 +1,5 @@
-import { LooseTranslateFunction, TranslateFunction } from "../shared/translateFunctionTypes.js";
+import { LooseTranslateFunction, TranslateFunction, TranslateFunctionForNamespace } from "../shared/translateFunctionTypes.js";
 import { DictionaryKeys, LocalesValues } from "@intlayer/types/module_augmentation";
-
 //#region src/core/createTranslator.d.ts
 /**
  * Configuration accepted by {@link createTranslator}.
@@ -10,7 +9,9 @@ import { DictionaryKeys, LocalesValues } from "@intlayer/types/module_augmentati
  * resolves content from its own compiled dictionaries.
  */
 type CreateTranslatorConfig<N extends DictionaryKeys> = {
-  /** The locale dictionaries are resolved for. */locale: LocalesValues; /** A bare dictionary key, or a nested `'dictionary.scope'` namespace. */
+  /** The locale dictionaries are resolved for. */
+  locale: LocalesValues;
+  /** A bare dictionary key, or a nested `'dictionary.scope'` namespace. */
   namespace?: N | (string & {});
   /**
    * @deprecated has no use case with intlayer. Messages are loaded
@@ -23,7 +24,8 @@ type CreateTranslatorConfig<N extends DictionaryKeys> = {
  *
  * 1. A bare dictionary key → fully-typed `t()` (autocompleted dot-paths).
  * 2. A nested namespace `'dictionary.sub.scope'` → `t()` accepts relative
- *    `string` paths, matching use-intl's scoped-namespace behaviour.
+ *    dot-paths under the scope, typed against the dictionary, matching
+ *    use-intl's scoped-namespace behaviour.
  * 3. No namespace → root scope; the first segment of each key designates
  *    the dictionary (`t('about.title')`).
  */
@@ -31,9 +33,9 @@ type CreateTranslator = {
   <N extends DictionaryKeys>(config: CreateTranslatorConfig<N> & {
     namespace: N;
   }): TranslateFunction<N>;
-  (config: CreateTranslatorConfig<DictionaryKeys> & {
-    namespace: `${string}.${string}`;
-  }): LooseTranslateFunction;
+  <N extends `${string}.${string}`>(config: CreateTranslatorConfig<DictionaryKeys> & {
+    namespace: N;
+  }): TranslateFunctionForNamespace<N>;
   (config: CreateTranslatorConfig<DictionaryKeys>): LooseTranslateFunction;
 };
 /**

package/dist/types/core/createTranslator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createTranslator.d.ts","names":[],"sources":["../../../src/core/createTranslator.ts"],"mappings":";;;;;;AAoBA;;;;;KAAY,sBAAA,WAAiC,cAAA;EAUzC,gDARF,MAAA,EAAQ,aAAA,EAQA;EANR,SAAA,GAAY,CAAA;EAJ+B;;;;EAS3C,QAAA;AAAA,IACE,MAAA;;;;AAAwB;;;;;;KAWvB,gBAAA;EAAA,WACQ,cAAA,EACT,MAAA,EAAQ,sBAAA,CAAuB,CAAA;IAAO,SAAA,EAAW,CAAA;EAAA,IAChD,iBAAA,CAAkB,CAAA;EAAA,CAEnB,MAAA,EAAQ,sBAAA,CAAuB,cAAA;IAC7B,SAAA;EAAA,IAED,sBAAA;EAAA,CACF,MAAA,EAAQ,sBAAA,CAAuB,cAAA,IAAkB,sBAAA;AAAA;;;;;;;;;;;;;;;cAiBvC,gBAAA,EAaP,gBAAA"}
+{"version":3,"file":"createTranslator.d.ts","names":[],"sources":["../../../src/core/createTranslator.ts"],"mappings":";;;;;;;;;;KAqBY,uBAAuB,UAAU;;EAE3C,QAAQ;;EAER,YAAY;;;;;EAKZ;IACE;;;;;;;;;;;KAYC;GACF,UAAU,gBACT,QAAQ,uBAAuB;IAAO,WAAW;MAChD,kBAAkB;GACpB,iCACC,QAAQ,uBAAuB;IAAoB,WAAW;MAC7D,8BAA8B;GAChC,QAAQ,uBAAuB,kBAAkB;;;;;;;;;;;;;;;;cAiBvC,kBAaP"}

package/dist/types/core/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","names":[],"sources":["../../../src/core/errors.ts"],"mappings":";;AAOA;;;;;;aAAY,aAAA;EACV,eAAA;EACA,cAAA;EACA,oBAAA;EACA,iBAAA;EACA,eAAA;EACA,WAAA;EACA,gBAAA;AAAA;;;;;;;cASW,SAAA,SAAkB,KAAA;EAAA,SACb,IAAA,EAAM,aAAA;EAAA,SACN,eAAA;cAEJ,IAAA,EAAM,aAAA,EAAe,eAAA;AAAA"}
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../../../src/core/errors.ts"],"mappings":";;;;;;;;aAOY;EACV;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;;cASW,kBAAkB;WACb,MAAM;WACN;EAEhB,YAAY,MAAM,eAAe"}

package/dist/types/core/hasLocale.d.ts

@@ -1,5 +1,4 @@
 import { hasLocale as hasLocale$1 } from "use-intl";
-
 //#region src/core/hasLocale.d.ts
 /**
  * Drop-in for use-intl's `hasLocale`.

package/dist/types/core/hasLocale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hasLocale.d.ts","names":[],"sources":["../../../src/core/hasLocale.ts"],"mappings":";;;;;AAcA;;;;;;;;;cAAa,SAAA,SAAkB,WAAA"}
+{"version":3,"file":"hasLocale.d.ts","names":[],"sources":["../../../src/core/hasLocale.ts"],"mappings":";;;;;;;;;;;;;cAca,kBAAkB"}

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

@@ -4,4 +4,4 @@ import { IntlError, IntlErrorCode } from "./errors.js";
 import { hasLocale } from "./hasLocale.js";
 import { initializeConfig } from "./initializeConfig.js";
 import { AbstractIntlMessages, AppConfig, DateTimeFormatOptions, Formats, ICUArgs, ICUTags, IntlConfig, Locale, MarkupTagsFunction, MarkupTranslationValues, MessageKeys, Messages, NamespaceKeys, NestedKeyOf, NestedValueOf, NumberFormatOptions, RelativeTimeFormatOptions, RichTagsFunction, RichTranslationValues, Timezone, TranslationValues } from "./types.js";
-export { AbstractIntlMessages, AppConfig, type CreateTranslatorConfig, DateTimeFormatOptions, Formats, ICUArgs, ICUTags, IntlConfig, IntlError, IntlErrorCode, Locale, MarkupTagsFunction, MarkupTranslationValues, MessageKeys, Messages, NamespaceKeys, NestedKeyOf, NestedValueOf, NumberFormatOptions, RelativeTimeFormatOptions, RichTagsFunction, RichTranslationValues, Timezone, TranslationValues, createFormatter, createTranslator, hasLocale, initializeConfig };
+export { type AbstractIntlMessages, type AppConfig, type CreateTranslatorConfig, type DateTimeFormatOptions, type Formats, type ICUArgs, type ICUTags, type IntlConfig, IntlError, IntlErrorCode, type Locale, type MarkupTagsFunction, type MarkupTranslationValues, type MessageKeys, type Messages, type NamespaceKeys, type NestedKeyOf, type NestedValueOf, type NumberFormatOptions, type RelativeTimeFormatOptions, type RichTagsFunction, type RichTranslationValues, type Timezone, type TranslationValues, createFormatter, createTranslator, hasLocale, initializeConfig };

package/dist/types/core/initializeConfig.d.ts

@@ -1,5 +1,4 @@
 import { initializeConfig as initializeConfig$1 } from "use-intl";
-
 //#region src/core/initializeConfig.d.ts
 /**
  * Drop-in for use-intl's `initializeConfig`.

package/dist/types/core/initializeConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initializeConfig.d.ts","names":[],"sources":["../../../src/core/initializeConfig.ts"],"mappings":";;;;;AASA;;;;;cAAa,gBAAA,SAAyB,kBAAA"}
+{"version":3,"file":"initializeConfig.d.ts","names":[],"sources":["../../../src/core/initializeConfig.ts"],"mappings":";;;;;;;;;cASa,yBAAyB"}

package/dist/types/core/types.d.ts

@@ -1,2 +1,2 @@
 import { AbstractIntlMessages, AppConfig, DateTimeFormatOptions, Formats, ICUArgs, ICUTags, IntlConfig, Locale, MarkupTagsFunction, MarkupTranslationValues, MessageKeys, Messages, NamespaceKeys, NestedKeyOf, NestedValueOf, NumberFormatOptions, RelativeTimeFormatOptions, RichTagsFunction, RichTranslationValues, Timezone, TranslationValues } from "use-intl";
-export { type AbstractIntlMessages, type AppConfig, type DateTimeFormatOptions, type Formats, type ICUArgs, type ICUTags, type IntlConfig, type Locale, type MarkupTagsFunction, type MarkupTranslationValues, type MessageKeys, type Messages, type NamespaceKeys, type NestedKeyOf, type NestedValueOf, type NumberFormatOptions, type RelativeTimeFormatOptions, type RichTagsFunction, type RichTranslationValues, type Timezone, type TranslationValues };
+export type { AbstractIntlMessages, AppConfig, DateTimeFormatOptions, Formats, ICUArgs, ICUTags, IntlConfig, Locale, MarkupTagsFunction, MarkupTranslationValues, MessageKeys, Messages, NamespaceKeys, NestedKeyOf, NestedValueOf, NumberFormatOptions, RelativeTimeFormatOptions, RichTagsFunction, RichTranslationValues, Timezone, TranslationValues };

package/dist/types/index.d.ts

@@ -1,10 +1,10 @@
 import { IntlProvider, IntlProviderProps } from "./client/IntlProvider.js";
 import { useFormatter, useMessages, useNow, useTimeZone } from "./client/helpers.js";
+import { MarkupChunkRenderer, RichChunkRenderer, createDictionaryTranslator } from "./shared/namespaceTranslator.js";
+import { ContentAtPath, LooseTranslateFunction, ScopedDotPaths, ScopedTranslateFunction, TranslateFunction, TranslateFunctionForNamespace, TranslatedValue } from "./shared/translateFunctionTypes.js";
 import { useDictionary } from "./useDictionary.js";
 import { useDictionaryDynamic } from "./useDictionaryDynamic.js";
 import { useLocale } from "./client/useLocale.js";
-import { MarkupChunkRenderer, RichChunkRenderer } from "./shared/namespaceTranslator.js";
-import { LooseTranslateFunction, TranslateFunction } from "./shared/translateFunctionTypes.js";
 import { useTranslations } from "./client/useTranslations.js";
 import { _useExtracted } from "./client/index.js";
 import { createFormatter } from "./core/createFormatter.js";
@@ -13,4 +13,5 @@ import { IntlError, IntlErrorCode } from "./core/errors.js";
 import { hasLocale } from "./core/hasLocale.js";
 import { initializeConfig } from "./core/initializeConfig.js";
 import { AbstractIntlMessages, AppConfig, DateTimeFormatOptions, Formats, ICUArgs, ICUTags, IntlConfig, Locale, MarkupTagsFunction, MarkupTranslationValues, MessageKeys, Messages, NamespaceKeys, NestedKeyOf, NestedValueOf, NumberFormatOptions, RelativeTimeFormatOptions, RichTagsFunction, RichTranslationValues, Timezone, TranslationValues } from "./core/types.js";
-export { AbstractIntlMessages, AppConfig, CreateTranslatorConfig, DateTimeFormatOptions, Formats, ICUArgs, ICUTags, IntlConfig, IntlError, IntlErrorCode, IntlProvider, IntlProviderProps, Locale, type LooseTranslateFunction, type MarkupChunkRenderer, MarkupTagsFunction, MarkupTranslationValues, MessageKeys, Messages, NamespaceKeys, NestedKeyOf, NestedValueOf, NumberFormatOptions, RelativeTimeFormatOptions, type RichChunkRenderer, RichTagsFunction, RichTranslationValues, Timezone, type TranslateFunction, TranslationValues, _useExtracted, createFormatter, createTranslator, hasLocale, initializeConfig, useDictionary, useDictionaryDynamic, useFormatter, useLocale, useMessages, useNow, useTimeZone, useTranslations };
+import "./core/index.js";
+export { type AbstractIntlMessages, type AppConfig, type ContentAtPath, type CreateTranslatorConfig, type DateTimeFormatOptions, type Formats, type ICUArgs, type ICUTags, type IntlConfig, IntlError, IntlErrorCode, IntlProvider, type IntlProviderProps, type Locale, type LooseTranslateFunction, type MarkupChunkRenderer, type MarkupTagsFunction, type MarkupTranslationValues, type MessageKeys, type Messages, type NamespaceKeys, type NestedKeyOf, type NestedValueOf, type NumberFormatOptions, type RelativeTimeFormatOptions, type RichChunkRenderer, type RichTagsFunction, type RichTranslationValues, type ScopedDotPaths, type ScopedTranslateFunction, type Timezone, type TranslateFunction, type TranslateFunctionForNamespace, type TranslatedValue, type TranslationValues, _useExtracted, createDictionaryTranslator, createFormatter, createTranslator, hasLocale, initializeConfig, useDictionary, useDictionaryDynamic, useFormatter, useLocale, useMessages, useNow, useTimeZone, useTranslations };

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

@@ -1,6 +1,5 @@
 import { PluginOption } from "vite";
 import { intlayer } from "vite-intlayer";
-
 //#region src/plugin/index.d.ts
 /**
  * A Vite plugin for use-intl compat that wraps vite-intlayer and configures

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/plugin/index.ts"],"mappings":";;;;;;AA6CA;;;;;;;;;;;;cAAa,iBAAA,GACX,OAAA,GAAU,UAAA,QAAkB,QAAA,SAC3B,YAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/plugin/index.ts"],"mappings":";;;;;;;;;;;;;;;;;cAuBa,oBAAiB,UAClB,kBAAkB,iBAC3B"}

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

@@ -1,5 +1,4 @@
 import { createFormatter } from "use-intl";
-
 //#region src/shared/intlFormatter.d.ts
 /** The formatter object shape exposed by use-intl. */
 type Formatter = ReturnType<typeof createFormatter>;

package/dist/types/shared/intlFormatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intlFormatter.d.ts","names":[],"sources":["../../../src/shared/intlFormatter.ts"],"mappings":";;;;KAGY,SAAA,GAAY,UAAA,QAAkB,eAAA;AAA1C;;;;;AA0BA;;;;;AA1BA,cA0Ba,kBAAA,GAAsB,MAAA,aAAiB,SAAA"}
+{"version":3,"file":"intlFormatter.d.ts","names":[],"sources":["../../../src/shared/intlFormatter.ts"],"mappings":";;;KAGY,YAAY,kBAAkB;;;;;;;;;;;cA0B7B,qBAAkB,mBAAqB"}

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

@@ -1,20 +1,11 @@
 import { LocalesValues } from "@intlayer/types/module_augmentation";
 import { ReactNode } from "react";
-import { MessageValues } from "@intlayer/core/messageFormat";
-
+import { MessageValues, navigatePath } from "@intlayer/core/messageFormat";
 //#region src/shared/namespaceTranslator.d.ts
 /** Chunk renderer used by `t.rich()` — maps tag children to a React node. */
 type RichChunkRenderer = (chunks: ReactNode) => ReactNode;
 /** Chunk renderer used by `t.markup()` — maps tag children to a string. */
 type MarkupChunkRenderer = (chunks: string) => string;
-/**
- * Reads a dotted `path` (e.g. `counter.label`) out of a nested object value.
- *
- * @param objectValue - The object to read from.
- * @param path - Dot-separated path. An empty path returns `objectValue`.
- * @returns The value found at `path`, or `undefined` when any segment is absent.
- */
-declare const navigatePath: (objectValue: unknown, path: string) => unknown;
 /**
  * The untyped runtime translator shared by `useTranslations` (React hook) and
  * `createTranslator` (non-React core).
@@ -32,7 +23,37 @@ declare const navigatePath: (objectValue: unknown, path: string) => unknown;
  * @returns A translate function augmented with `has`, `raw`, `rich`, `markup`.
  */
 declare const createNamespaceTranslator: (locale: LocalesValues, namespace?: string) => ((key: string, values?: MessageValues) => string) & {
-  /** Returns `true` if the given key exists in the namespace. */has: (key: string) => boolean; /** Returns the raw unprocessed content for the given key. */
+  /** Returns `true` if the given key exists in the namespace. */
+  has: (key: string) => boolean;
+  /** Returns the raw unprocessed content for the given key. */
+  raw: (key: string) => unknown;
+  /**
+   * Resolves a message containing `<tag>chunks</tag>` markup, mapping each
+   * tag through the matching renderer in `values`.
+   */
+  rich: (key: string, values?: Record<string, unknown>) => ReactNode;
+  /**
+   * Resolves a message containing `<tag>chunks</tag>` markup into a string,
+   * mapping each tag through the matching string renderer in `values`.
+   */
+  markup: (key: string, values?: Record<string, unknown>) => string;
+};
+/**
+ * Dictionary-bound translator used by the build-optimized `useDictionary` /
+ * `getDictionary` variants: instead of resolving the dictionary by key at
+ * runtime, the pre-resolved content is supplied directly (the babel/swc
+ * optimize pass imports the dictionary JSON at build time).
+ *
+ * @param locale - The locale messages are resolved for.
+ * @param content - The dictionary content, already resolved for `locale`.
+ * @param namespacePrefix - Optional key prefix for nested namespaces
+ *   (`useTranslations('about.counter')` → content of `about`, prefix `counter`).
+ * @returns A translate function augmented with `has`, `raw`, `rich`, `markup`.
+ */
+declare const createDictionaryTranslator: (locale: LocalesValues, content: unknown, namespacePrefix?: string) => ((key: string, values?: MessageValues) => string) & {
+  /** Returns `true` if the given key exists in the namespace. */
+  has: (key: string) => boolean;
+  /** Returns the raw unprocessed content for the given key. */
   raw: (key: string) => unknown;
   /**
    * Resolves a message containing `<tag>chunks</tag>` markup, mapping each
@@ -47,5 +68,5 @@ declare const createNamespaceTranslator: (locale: LocalesValues, namespace?: str
 };
 type CompatTranslator = ReturnType<typeof createNamespaceTranslator>;
 //#endregion
-export { CompatTranslator, MarkupChunkRenderer, RichChunkRenderer, createNamespaceTranslator, navigatePath };
+export { CompatTranslator, MarkupChunkRenderer, RichChunkRenderer, createDictionaryTranslator, createNamespaceTranslator, navigatePath };
 //# sourceMappingURL=namespaceTranslator.d.ts.map

package/dist/types/shared/namespaceTranslator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"namespaceTranslator.d.ts","names":[],"sources":["../../../src/shared/namespaceTranslator.tsx"],"mappings":";;;;;;KAcY,iBAAA,IAAqB,MAAA,EAAQ,SAAA,KAAc,SAAA;AAAvD;AAAA,KAGY,mBAAA,IAAuB,MAAA;;;;;;;;cAStB,YAAA,GAAgB,WAAA,WAAsB,IAAA;;;;;AAAnD;;;;;AAyFA;;;;;;;cAAa,yBAAA,GACX,MAAA,EAAQ,aAAA,EACR,SAAA,gBAAkB,GAAA,UAuCY,MAAA,GAAW,aAAA;EAyBF,8FAjE/B;;EACR;;;;sBAqDoB,MAAA,GAAW,MAAA,sBAA0B,SAAA;;;;;wBAWnC,MAAA,GAAW,MAAA;AAAA;AAAA,KASvB,gBAAA,GAAmB,UAAA,QAAkB,yBAAA"}
+{"version":3,"file":"namespaceTranslator.d.ts","names":[],"sources":["../../../src/shared/namespaceTranslator.tsx"],"mappings":";;;;;KAkBY,qBAAqB,QAAQ,cAAc;;KAG3C,uBAAuB;;;;;;;;;;;;;;;;;cA0EtB,4BAAyB,QAC5B,eAAa,yBACH,aAgHY,SAAW;;EAK5B,MAAA;;EAGA,MAAA;;;;;EAMC,OAAA,aAAM,SAAW,4BAA0B;;;;;EAWzC,SAAA,aAAM,SAAW;;;;;;;;;;;;;;cA/DtB,6BAA0B,QAC7B,eAAa,kBACL,+BACQ,aAmCM,SAAW;;EAK5B,MAAA;;EAGA,MAAA;;;;;EAMC,OAAA,aAAM,SAAW,4BAA0B;;;;;EAWzC,SAAA,aAAM,SAAW;;KASvB,mBAAmB,kBAAkB"}

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

@@ -1,9 +1,25 @@
 import { MarkupChunkRenderer, RichChunkRenderer } from "./namespaceTranslator.js";
 import { DictionaryKeys } from "@intlayer/types/module_augmentation";
 import { ReactNode } from "react";
+import { GetNestingResult } from "@intlayer/core/interpreter";
 import { ValidDotPathsFor } from "@intlayer/core/transpiler";
-
 //#region src/shared/translateFunctionTypes.d.ts
+/**
+ * The interpreter-resolved content type at dot-path `P` of dictionary `N` —
+ * the same type strength as the base `useIntlayer` hook.
+ */
+type ContentAtPath<N extends DictionaryKeys, P> = GetNestingResult<N, P>;
+/**
+ * The value returned by `t()` for key `P` of dictionary `N`: string literals
+ * declared in the dictionary keep their literal type (matching the strength of
+ * `useIntlayer`), every other node resolves to `string` at runtime.
+ */
+type TranslatedValue<N extends DictionaryKeys, P> = ContentAtPath<N, P> extends string ? ContentAtPath<N, P> : string;
+/**
+ * The dot-paths of dictionary `D` relative to the nested namespace scope
+ * `Prefix` (`useTranslations('about.counter')` → paths under `about.counter`).
+ */
+type ScopedDotPaths<D extends DictionaryKeys, Prefix extends string> = ValidDotPathsFor<D> extends (infer AllPaths) ? AllPaths extends `${Prefix}.${infer RelativePath}` ? RelativePath : never : never;
 /**
  * The translation function returned for a bare dictionary key namespace.
  *
@@ -15,13 +31,42 @@ import { ValidDotPathsFor } from "@intlayer/core/transpiler";
  * - `markup(key, values)` — resolves `<tag>chunks</tag>` markup to a string.
  */
 type TranslateFunction<N extends DictionaryKeys> = {
-  /** Translate a key to a string, with optional ICU interpolation params. */<P extends ValidDotPathsFor<N>>(key: P, params?: Record<string, unknown>): string; /** Returns `true` if the given key exists in the namespace. */
-  has<P extends ValidDotPathsFor<N>>(key: P): boolean; /** Returns the raw unprocessed content for the given key. */
-  raw<P extends ValidDotPathsFor<N>>(key: P): unknown; /** Resolves rich-text markup, mapping tags through React renderers. */
-  rich<P extends ValidDotPathsFor<N>>(key: P, values?: Record<string, RichChunkRenderer | ReactNode>): ReactNode; /** Resolves rich-text markup, mapping tags through string renderers. */
+  /** Translate a key to a string, with optional ICU interpolation params. */
+  <P extends ValidDotPathsFor<N>>(key: P, params?: Record<string, unknown>): TranslatedValue<N, P>;
+  /** Returns `true` if the given key exists in the namespace. */
+  has<P extends ValidDotPathsFor<N>>(key: P): boolean;
+  /** Returns the raw unprocessed content for the given key. */
+  raw<P extends ValidDotPathsFor<N>>(key: P): ContentAtPath<N, P>;
+  /** Resolves rich-text markup, mapping tags through React renderers. */
+  rich<P extends ValidDotPathsFor<N>>(key: P, values?: Record<string, RichChunkRenderer | ReactNode>): ReactNode;
+  /** Resolves rich-text markup, mapping tags through string renderers. */
   markup<P extends ValidDotPathsFor<N>>(key: P, values?: Record<string, MarkupChunkRenderer | string | number>): string;
 };
-/** Loosely-typed function returned for nested `'dict.scope'` namespaces. */
+/**
+ * The translation function returned for a nested `'dictionary.scope'`
+ * namespace: keys are relative dot-paths under the scope, and return types are
+ * resolved against the absolute path in the dictionary.
+ */
+type ScopedTranslateFunction<D extends DictionaryKeys, Prefix extends string> = {
+  /** Translate a scoped key to a string, with optional ICU interpolation params. */
+  <P extends ScopedDotPaths<D, Prefix>>(key: P, params?: Record<string, unknown>): TranslatedValue<D, `${Prefix}.${P}`>;
+  /** Returns `true` if the given key exists in the scoped namespace. */
+  has<P extends ScopedDotPaths<D, Prefix>>(key: P): boolean;
+  /** Returns the raw unprocessed content for the given scoped key. */
+  raw<P extends ScopedDotPaths<D, Prefix>>(key: P): ContentAtPath<D, `${Prefix}.${P}`>;
+  /** Resolves rich-text markup, mapping tags through React renderers. */
+  rich<P extends ScopedDotPaths<D, Prefix>>(key: P, values?: Record<string, RichChunkRenderer | ReactNode>): ReactNode;
+  /** Resolves rich-text markup, mapping tags through string renderers. */
+  markup<P extends ScopedDotPaths<D, Prefix>>(key: P, values?: Record<string, MarkupChunkRenderer | string | number>): string;
+};
+/**
+ * Resolves the translation function type for a namespace argument: a bare
+ * dictionary key keeps the fully-typed dot-paths, a nested
+ * `'dictionary.scope'` namespace is split at the first dot and typed
+ * relative to the scope, anything else falls back to loose typing.
+ */
+type TranslateFunctionForNamespace<N extends string> = N extends DictionaryKeys ? TranslateFunction<N> : N extends `${infer D extends DictionaryKeys & string}.${infer Prefix}` ? ScopedTranslateFunction<D, Prefix> : LooseTranslateFunction;
+/** Loosely-typed function returned for untyped namespaces (root scope). */
 type LooseTranslateFunction = {
   (key: string, params?: Record<string, unknown>): string;
   has(key: string): boolean;
@@ -30,5 +75,5 @@ type LooseTranslateFunction = {
   markup(key: string, values?: Record<string, MarkupChunkRenderer | string | number>): string;
 };
 //#endregion
-export { LooseTranslateFunction, TranslateFunction };
+export { ContentAtPath, LooseTranslateFunction, ScopedDotPaths, ScopedTranslateFunction, TranslateFunction, TranslateFunctionForNamespace, TranslatedValue };
 //# sourceMappingURL=translateFunctionTypes.d.ts.map

package/dist/types/shared/translateFunctionTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translateFunctionTypes.d.ts","names":[],"sources":["../../../src/shared/translateFunctionTypes.ts"],"mappings":";;;;;;;;AAkBA;;;;;;;;KAAY,iBAAA,WAA4B,cAAA;EAOxB,sFALH,gBAAA,CAAiB,CAAA,GAC1B,GAAA,EAAK,CAAA,EACL,MAAA,GAAS,MAAA,4BAKoB;EAF/B,GAAA,WAAc,gBAAA,CAAiB,CAAA,GAAI,GAAA,EAAK,CAAA,YAEA;EAAxC,GAAA,WAAc,gBAAA,CAAiB,CAAA,GAAI,GAAA,EAAK,CAAA,YAEzB;EAAf,IAAA,WAAe,gBAAA,CAAiB,CAAA,GAC9B,GAAA,EAAK,CAAA,EACL,MAAA,GAAS,MAAA,SAAe,iBAAA,GAAoB,SAAA,IAC3C,SAAA,EADuB;EAG1B,MAAA,WAAiB,gBAAA,CAAiB,CAAA,GAChC,GAAA,EAAK,CAAA,EACL,MAAA,GAAS,MAAA,SAAe,mBAAA;AAAA;;KAKhB,sBAAA;EAAA,CACT,GAAA,UAAa,MAAA,GAAS,MAAA;EACvB,GAAA,CAAI,GAAA;EACJ,GAAA,CAAI,GAAA;EACJ,IAAA,CACE,GAAA,UACA,MAAA,GAAS,MAAA,SAAe,iBAAA,GAAoB,SAAA,IAC3C,SAAA;EACH,MAAA,CACE,GAAA,UACA,MAAA,GAAS,MAAA,SAAe,mBAAA;AAAA"}
+{"version":3,"file":"translateFunctionTypes.d.ts","names":[],"sources":["../../../src/shared/translateFunctionTypes.ts"],"mappings":";;;;;;;;;;KAaY,cAAc,UAAU,gBAAgB,KAAK,iBAAiB,GAAG;;;;;;KAOjE,gBAAgB,UAAU,gBAAgB,KACpD,cAAc,GAAG,oBAAoB,cAAc,GAAG;;;;;KAM5C,eAAe,UAAU,gBAAgB,yBACnD,iBAAiB,kBAAiB,YAC9B,oBAAoB,gBAAgB,iBAClC;;;;;;;;;;;KAcI,kBAAkB,UAAU;;GAErC,UAAU,iBAAiB,IAC1B,KAAK,GACL,SAAS,0BACR,gBAAgB,GAAG;;EAEtB,IAAI,UAAU,iBAAiB,IAAI,KAAK;;EAExC,IAAI,UAAU,iBAAiB,IAAI,KAAK,IAAI,cAAc,GAAG;;EAE7D,KAAK,UAAU,iBAAiB,IAC9B,KAAK,GACL,SAAS,eAAe,oBAAoB,aAC3C;;EAEH,OAAO,UAAU,iBAAiB,IAChC,KAAK,GACL,SAAS,eAAe;;;;;;;KAShB,wBACV,UAAU,gBACV;;GAGC,UAAU,eAAe,GAAG,SAC3B,KAAK,GACL,SAAS,0BACR,gBAAgB,MAAM,UAAU;;EAEnC,IAAI,UAAU,eAAe,GAAG,SAAS,KAAK;;EAE9C,IAAI,UAAU,eAAe,GAAG,SAC9B,KAAK,IACJ,cAAc,MAAM,UAAU;;EAEjC,KAAK,UAAU,eAAe,GAAG,SAC/B,KAAK,GACL,SAAS,eAAe,oBAAoB,aAC3C;;EAEH,OAAO,UAAU,eAAe,GAAG,SACjC,KAAK,GACL,SAAS,eAAe;;;;;;;;KAUhB,8BAA8B,oBACxC,UAAU,iBACN,kBAAkB,KAClB,mBAAmB,UAAU,iCAAiC,WAC5D,wBAAwB,GAAG,UAC3B;;KAGI;GACT,aAAa,SAAS;EACvB,IAAI;EACJ,IAAI;EACJ,KACE,aACA,SAAS,eAAe,oBAAoB,aAC3C;EACH,OACE,aACA,SAAS,eAAe"}

package/dist/types/useDictionary.d.ts

@@ -1,7 +1,16 @@
-import { ValidDotPathsFor } from "@intlayer/core/transpiler";
+import { ScopedTranslateFunction, TranslateFunction } from "./shared/translateFunctionTypes.js";
+import { DictionaryKeys } from "@intlayer/types/module_augmentation";
 import { Dictionary } from "@intlayer/types/dictionary";
-
 //#region src/useDictionary.d.ts
+/**
+ * Overload set for {@link useDictionary}: without a prefix the translator is
+ * typed against the dictionary's dot-paths; with a prefix the keys are
+ * relative dot-paths under that scope.
+ */
+type UseDictionary = {
+  <T extends Dictionary>(dictionary: T): TranslateFunction<T['key'] & DictionaryKeys>;
+  <T extends Dictionary, Prefix extends string>(dictionary: T, namespacePrefix: Prefix): ScopedTranslateFunction<T['key'] & DictionaryKeys, Prefix>;
+};
 /**
  * Dictionary-accepting variant of `useTranslations`.
  *
@@ -10,14 +19,14 @@ import { Dictionary } from "@intlayer/types/dictionary";
  * JSON at build time and passes it directly here. This enables tree-shaking of
  * unused locale content.
  *
+ * The returned translator matches `useTranslations` exactly (ICU messages,
+ * `has`, `raw`, `rich`, `markup`).
+ *
  * @example (generated by the plugin, not written manually)
  * import _abc from '.intlayer/dictionaries/about.json' with { type: 'json' };
  * const t = useDictionary(_abc);
  */
-declare const useDictionary: <T extends Dictionary>(dictionary: T, namespacePrefix?: string) => (<P extends ValidDotPathsFor<string>>(lookup: P, params?: Record<string, unknown>) => string) & {
-  has: <P extends ValidDotPathsFor<string>>(lookup: P) => boolean;
-  raw: <P extends ValidDotPathsFor<string>>(lookup: P) => unknown;
-};
+declare const useDictionary: UseDictionary;
 //#endregion
 export { useDictionary };
 //# sourceMappingURL=useDictionary.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useDictionary.d.ts","names":[],"sources":["../../src/useDictionary.ts"],"mappings":";;;;;;AAmBA;;;;;;;;;;cAAa,aAAA,aAA2B,UAAA,EACtC,UAAA,EAAY,CAAA,EACZ,eAAA,0BAQa,gBAAA,UAAwB,MAAA,EACzB,CAAA,EAAC,MAAA,GACA,MAAA;kBAUO,gBAAA,UAAwB,MAAA,EAAU,CAAA;kBAElC,gBAAA,UAAwB,MAAA,EAAU,CAAA;AAAA"}
+{"version":3,"file":"useDictionary.d.ts","names":[],"sources":["../../src/useDictionary.ts"],"mappings":";;;;;;;;;KAuBK;GACF,UAAU,YACT,YAAY,IACX,kBAAkB,WAAW;GAC/B,UAAU,YAAY,uBACrB,YAAY,GACZ,iBAAiB,SAChB,wBAAwB,WAAW,gBAAgB;;;;;;;;;;;;;;;;;cAkB3C,eAYP"}

package/dist/types/useDictionaryDynamic.d.ts

@@ -1,18 +1,23 @@
-import { StrictModeLocaleMap } from "@intlayer/types/module_augmentation";
-import { ValidDotPathsFor } from "@intlayer/core/transpiler";
+import { ScopedTranslateFunction, TranslateFunction } from "./shared/translateFunctionTypes.js";
+import { DictionaryKeys, StrictModeLocaleMap } from "@intlayer/types/module_augmentation";
 import { Dictionary } from "@intlayer/types/dictionary";
-
 //#region src/useDictionaryDynamic.d.ts
+/**
+ * Overload set for {@link useDictionaryDynamic}: without a prefix the
+ * translator is typed against the dictionary's dot-paths; with a prefix the
+ * keys are relative dot-paths under that scope.
+ */
+type UseDictionaryDynamic = {
+  <T extends Dictionary, K extends DictionaryKeys>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>, key: K): TranslateFunction<K>;
+  <T extends Dictionary, K extends DictionaryKeys, Prefix extends string>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>, key: K, namespacePrefix: Prefix): ScopedTranslateFunction<K, Prefix>;
+};
 /**
  * Dynamic dictionary-accepting variant of `useTranslations`.
  *
  * Counterpart to {@link useDictionary} for dictionaries imported lazily per
  * locale. Used internally by the build-time optimization.
  */
-declare const useDictionaryDynamic: <const T extends Dictionary, const K extends string>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>, key: K, namespacePrefix?: string) => (<P extends ValidDotPathsFor<string>>(lookup: P, params?: Record<string, unknown>) => string) & {
-  has: <P extends ValidDotPathsFor<string>>(lookup: P) => boolean;
-  raw: <P extends ValidDotPathsFor<string>>(lookup: P) => unknown;
-};
+declare const useDictionaryDynamic: UseDictionaryDynamic;
 //#endregion
 export { useDictionaryDynamic };
 //# sourceMappingURL=useDictionaryDynamic.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useDictionaryDynamic.d.ts","names":[],"sources":["../../src/useDictionaryDynamic.ts"],"mappings":";;;;;;;AAcA;;;;cAAa,oBAAA,mBACK,UAAA,0BAGhB,iBAAA,EAAmB,mBAAA,OAA0B,OAAA,CAAQ,CAAA,IACrD,GAAA,EAAK,CAAA,EACL,eAAA,0BAQa,gBAAA,UAAwB,MAAA,EACzB,CAAA,EAAC,MAAA,GACA,MAAA;kBAUO,gBAAA,UAAwB,MAAA,EAAU,CAAA;kBAElC,gBAAA,UAAwB,MAAA,EAAU,CAAA;AAAA"}
+{"version":3,"file":"useDictionaryDynamic.d.ts","names":[],"sources":["../../src/useDictionaryDynamic.ts"],"mappings":";;;;;;;;;KAwBK;GACF,UAAU,YAAY,UAAU,gBAC/B,mBAAmB,0BAA0B,QAAQ,KACrD,KAAK,IACJ,kBAAkB;GACpB,UAAU,YAAY,UAAU,gBAAgB,uBAC/C,mBAAmB,0BAA0B,QAAQ,KACrD,KAAK,GACL,iBAAiB,SAChB,wBAAwB,GAAG;;;;;;;;cASnB,sBAgBP"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/use-intl",
-  "version": "9.0.0-canary.8",
+  "version": "9.0.0",
   "private": false,
   "description": "use-intl API adapter for intlayer — useTranslations, useLocale, useFormatter, IntlProvider, createTranslator backed by react-intlayer",
   "keywords": [
@@ -89,26 +89,26 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/chokidar": "9.0.0-canary.8",
-    "@intlayer/config": "9.0.0-canary.8",
-    "@intlayer/core": "9.0.0-canary.8",
-    "@intlayer/dictionaries-entry": "9.0.0-canary.8",
-    "@intlayer/types": "9.0.0-canary.8",
-    "react-intlayer": "9.0.0-canary.8",
-    "vite-intlayer": "9.0.0-canary.8"
+    "@intlayer/config": "9.0.0",
+    "@intlayer/core": "9.0.0",
+    "@intlayer/dictionaries-entry": "9.0.0",
+    "@intlayer/engine": "9.0.0",
+    "@intlayer/types": "9.0.0",
+    "react-intlayer": "9.0.0",
+    "vite-intlayer": "9.0.0"
   },
   "devDependencies": {
-    "@types/node": "25.9.4",
+    "@types/node": "26.1.1",
     "@types/react": "19.2.17",
     "@utils/ts-config": "1.0.4",
     "@utils/ts-config-types": "1.0.4",
     "@utils/tsdown-config": "1.0.4",
     "rimraf": "6.1.3",
-    "tsdown": "0.21.10",
-    "typescript": "6.0.3",
-    "use-intl": "4.13.0",
-    "vite": "8.1.0",
-    "vitest": "4.1.9"
+    "tsdown": "0.22.13",
+    "typescript": "7.0.2",
+    "use-intl": "4.13.2",
+    "vite": "8.1.5",
+    "vitest": "4.1.10"
   },
   "peerDependencies": {
     "react": ">=16.0.0",