@intlayer/next-intl 9.0.0-canary.2 → 9.0.0-canary.21

package/dist/esm/index.mjs

@@ -1,10 +1,7 @@
 import { defineRouting } from "./routing.mjs";
-import { hasLocale } from "./hasLocale.mjs";
-import { useDictionaryDynamic } from "./useDictionaryDynamic.mjs";
-import { useDictionary } from "./useDictionary.mjs";
-import { IntlProvider, useExtracted, useFormatter, useMessages, useNow, useTimeZone } from "./client/helpers.mjs";
 import { NextIntlClientProvider } from "./client/NextIntlClientProvider.mjs";
 import { useLocale } from "./client/useLocale.mjs";
-import { useTranslations } from "./client/useTranslations.mjs";
+import { IntlProvider, useDictionary, useDictionaryDynamic, useExtracted, useFormatter, useMessages, useNow, useTimeZone, useTranslations } from "./client/index.mjs";
+import { IntlError, IntlErrorCode, createFormatter, createTranslator, hasLocale, initializeConfig } from "@intlayer/use-intl";
 
-export { IntlProvider, NextIntlClientProvider, defineRouting, hasLocale, useDictionary, useDictionaryDynamic, useExtracted, useFormatter, useLocale, useMessages, useNow, useTimeZone, useTranslations };
+export { IntlError, IntlErrorCode, IntlProvider, NextIntlClientProvider, createFormatter, createTranslator, defineRouting, hasLocale, initializeConfig, useDictionary, useDictionaryDynamic, useExtracted, useFormatter, useLocale, useMessages, useNow, useTimeZone, useTranslations };

package/dist/esm/middleware.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.mjs","names":[],"sources":["../../src/middleware.ts"],"sourcesContent":["import type { NextFetchEvent, NextRequest } from 'next/server';\nimport type _createMiddleware from 'next-intl/middleware';\nimport { intlayerMiddleware } from 'next-intlayer/middleware';\n\n/**\n * Drop-in replacement for next-intl's `createMiddleware`.\n *\n * Returns Intlayer's proxy/middleware, which handles locale detection and\n * routing from the Intlayer configuration. The `routing` argument is accepted\n * for API compatibility but ignored — locales come from `intlayer.config`.\n *\n * @example\n * ```ts\n * // proxy.ts (or middleware.ts on Next <= 15)\n * import createMiddleware from 'next-intl/middleware';\n * export default createMiddleware(routing);\n * export const config = { matcher: ['/((?!api|_next|.*\\\\..*).*)'] };\n * ```\n */\nexport const createMiddleware: typeof _createMiddleware =\n  (_routing?: unknown) => (request: NextRequest, event?: NextFetchEvent) => {\n    const response = intlayerMiddleware(request, event);\n\n    if (response) {\n      // Intlayer middleware writes the resolved locale to the x-intlayer-locale header\n      // We read it and explicitly set the NEXT_LOCALE cookie to maintain compatibility with next-intl\n      const resolvedLocale = response.headers.get('x-intlayer-locale');\n      if (resolvedLocale) {\n        response.cookies.set('NEXT_LOCALE', resolvedLocale, {\n          path: '/',\n          sameSite: 'lax',\n          maxAge: 60 * 60 * 24 * 365,\n        });\n      }\n    }\n\n    return response;\n  };\n\nexport default createMiddleware;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAmBA,MAAa,oBACV,cAAwB,SAAsB,UAA2B;CACxE,MAAM,WAAW,mBAAmB,SAAS,MAAM;AAEnD,KAAI,UAAU;EAGZ,MAAM,iBAAiB,SAAS,QAAQ,IAAI,oBAAoB;AAChE,MAAI,eACF,UAAS,QAAQ,IAAI,eAAe,gBAAgB;GAClD,MAAM;GACN,UAAU;GACV,QAAQ,OAAU,KAAK;GACxB,CAAC;;AAIN,QAAO"}
+{"version":3,"file":"middleware.mjs","names":[],"sources":["../../src/middleware.ts"],"sourcesContent":["import type { NextFetchEvent, NextRequest } from 'next/server';\nimport type _createMiddleware from 'next-intl/middleware';\nimport { intlayerMiddleware } from 'next-intlayer/middleware';\n\n/**\n * Drop-in replacement for next-intl's `createMiddleware`.\n *\n * Returns Intlayer's proxy/middleware, which handles locale detection and\n * routing from the Intlayer configuration. The `routing` argument is accepted\n * for API compatibility but ignored — locales come from `intlayer.config`.\n *\n * @example\n * ```ts\n * // proxy.ts (or middleware.ts on Next <= 15)\n * import createMiddleware from 'next-intl/middleware';\n * export default createMiddleware(routing);\n * export const config = { matcher: ['/((?!api|_next|.*\\\\..*).*)'] };\n * ```\n */\nexport const createMiddleware: typeof _createMiddleware =\n  (_routing?: unknown) => (request: NextRequest, event?: NextFetchEvent) => {\n    const response = intlayerMiddleware(request, event);\n\n    if (response) {\n      // Intlayer middleware writes the resolved locale to the x-intlayer-locale header\n      // We read it and explicitly set the NEXT_LOCALE cookie to maintain compatibility with next-intl\n      const resolvedLocale = response.headers.get('x-intlayer-locale');\n      if (resolvedLocale) {\n        response.cookies.set('NEXT_LOCALE', resolvedLocale, {\n          path: '/',\n          sameSite: 'lax',\n          maxAge: 60 * 60 * 24 * 365,\n        });\n      }\n    }\n\n    return response;\n  };\n\nexport default createMiddleware;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAmBA,MAAa,oBACV,cAAwB,SAAsB,UAA2B;CACxE,MAAM,WAAW,mBAAmB,SAAS,KAAK;CAElD,IAAI,UAAU;EAGZ,MAAM,iBAAiB,SAAS,QAAQ,IAAI,mBAAmB;EAC/D,IAAI,gBACF,SAAS,QAAQ,IAAI,eAAe,gBAAgB;GAClD,MAAM;GACN,UAAU;GACV,QAAQ,OAAU,KAAK;EACzB,CAAC;CAEL;CAEA,OAAO;AACT"}

package/dist/esm/navigation/Link.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Link.mjs","names":[],"sources":["../../../src/navigation/Link.tsx"],"sourcesContent":["'use client';\n\nimport NextLink from 'next/link';\nimport { useLocale } from 'next-intlayer';\nimport { type ComponentPropsWithoutRef, forwardRef, type Ref } from 'react';\nimport { localizeHref, type NextIntlHref } from './localizeHref';\n\n/**\n * Props for the compat `Link`: identical to `next/link` except `href` accepts a\n * `next-intl` href and an optional `locale` overrides the current one.\n */\nexport type LinkProps = Omit<\n  ComponentPropsWithoutRef<typeof NextLink>,\n  'href' | 'locale'\n> & {\n  href: NextIntlHref;\n  locale?: string;\n};\n\n/**\n * Drop-in for the `Link` returned by next-intl's `createNavigation`. Prefixes\n * `href` with the active locale (or the `locale` prop) before delegating to\n * `next/link`.\n */\nexport const Link = forwardRef(\n  ({ href, locale, ...rest }: LinkProps, ref: Ref<HTMLAnchorElement>) => {\n    const { locale: currentLocale } = useLocale();\n    const targetLocale = locale ?? (currentLocale as string);\n\n    return (\n      <NextLink ref={ref} href={localizeHref(href, targetLocale)} {...rest} />\n    );\n  }\n);\n\nLink.displayName = 'Link';\n"],"mappings":";;;;;;;;;;;;;;AAwBA,MAAa,OAAO,YACjB,EAAE,MAAM,QAAQ,GAAG,QAAmB,QAAgC;CACrE,MAAM,EAAE,QAAQ,kBAAkB,WAAW;AAG7C,QACE,oBAAC,UAAD;EAAe;EAAK,MAAM,aAAa,MAHpB,UAAW,cAG4B;EAAE,GAAI;EAAQ;EAG7E;AAED,KAAK,cAAc"}
+{"version":3,"file":"Link.mjs","names":[],"sources":["../../../src/navigation/Link.tsx"],"sourcesContent":["'use client';\n\nimport NextLink from 'next/link';\nimport { useLocale } from 'next-intlayer';\nimport { type ComponentPropsWithoutRef, forwardRef, type Ref } from 'react';\nimport { localizeHref, type NextIntlHref } from './localizeHref';\n\n/**\n * Props for the compat `Link`: identical to `next/link` except `href` accepts a\n * `next-intl` href and an optional `locale` overrides the current one.\n */\nexport type LinkProps = Omit<\n  ComponentPropsWithoutRef<typeof NextLink>,\n  'href' | 'locale'\n> & {\n  href: NextIntlHref;\n  locale?: string;\n};\n\n/**\n * Drop-in for the `Link` returned by next-intl's `createNavigation`. Prefixes\n * `href` with the active locale (or the `locale` prop) before delegating to\n * `next/link`.\n */\nexport const Link = forwardRef(\n  ({ href, locale, ...rest }: LinkProps, ref: Ref<HTMLAnchorElement>) => {\n    const { locale: currentLocale } = useLocale();\n    const targetLocale = locale ?? (currentLocale as string);\n\n    return (\n      <NextLink ref={ref} href={localizeHref(href, targetLocale)} {...rest} />\n    );\n  }\n);\n\nLink.displayName = 'Link';\n"],"mappings":";;;;;;;;;;;;;;AAwBA,MAAa,OAAO,YACjB,EAAE,MAAM,QAAQ,GAAG,QAAmB,QAAgC;CACrE,MAAM,EAAE,QAAQ,kBAAkB,UAAU;CAG5C,OACE,oBAAC,UAAD;EAAe;EAAK,MAAM,aAAa,MAHpB,UAAW,aAG2B;EAAG,GAAI;CAAO;AAE3E,CACF;AAEA,KAAK,cAAc"}

package/dist/esm/navigation/createNavigation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"createNavigation.mjs","names":["redirect","nextRedirect","permanentRedirect","nextPermanentRedirect"],"sources":["../../../src/navigation/createNavigation.ts"],"sourcesContent":["import {\n  permanentRedirect as nextPermanentRedirect,\n  redirect as nextRedirect,\n} from 'next/navigation';\nimport type { createNavigation as _createNavigation } from 'next-intl/navigation';\nimport { usePathname, useRouter } from './hooks';\nimport { Link } from './Link';\nimport { localizeHref, type NextIntlHref } from './localizeHref';\n\n/** Arguments shared by `getPathname`, `redirect` and `permanentRedirect`. */\ntype LocalizedHrefArgs = { href: NextIntlHref; locale: string };\n\n/** The optional `RedirectType` accepted by `next/navigation`'s redirect APIs. */\ntype RedirectTypeArg = Parameters<typeof nextRedirect>[1];\n\n/**\n * Drop-in replacement for next-intl's `createNavigation`.\n *\n * Returns locale-aware navigation APIs (`Link`, `usePathname`, `useRouter`,\n * `getPathname`, `redirect`, `permanentRedirect`) backed by Intlayer's routing\n * configuration. The `routing` argument is accepted for API compatibility;\n * locales come from the Intlayer configuration.\n *\n * @example\n * ```ts\n * export const { Link, redirect, usePathname, useRouter, getPathname } =\n *   createNavigation();\n * ```\n */\nexport const createNavigation: typeof _createNavigation = (\n  _routing?: unknown\n) => {\n  const getPathname = ({ href, locale }: LocalizedHrefArgs): string =>\n    localizeHref(href, locale);\n\n  const redirect = (\n    { href, locale }: LocalizedHrefArgs,\n    type?: RedirectTypeArg\n  ) => nextRedirect(localizeHref(href, locale), type);\n\n  const permanentRedirect = (\n    { href, locale }: LocalizedHrefArgs,\n    type?: RedirectTypeArg\n  ) => nextPermanentRedirect(localizeHref(href, locale), type);\n\n  return {\n    Link: Link as ReturnType<typeof _createNavigation>['Link'],\n    usePathname,\n    useRouter,\n    getPathname,\n    redirect,\n    permanentRedirect,\n  } as ReturnType<typeof _createNavigation>;\n};\n\nexport default createNavigation;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,oBACX,aACG;CACH,MAAM,eAAe,EAAE,MAAM,aAC3B,aAAa,MAAM,OAAO;CAE5B,MAAMA,cACJ,EAAE,MAAM,UACR,SACGC,SAAa,aAAa,MAAM,OAAO,EAAE,KAAK;CAEnD,MAAMC,uBACJ,EAAE,MAAM,UACR,SACGC,kBAAsB,aAAa,MAAM,OAAO,EAAE,KAAK;AAE5D,QAAO;EACC;EACN;EACA;EACA;EACA;EACA;EACD"}
+{"version":3,"file":"createNavigation.mjs","names":["redirect","nextRedirect","permanentRedirect","nextPermanentRedirect"],"sources":["../../../src/navigation/createNavigation.ts"],"sourcesContent":["import {\n  permanentRedirect as nextPermanentRedirect,\n  redirect as nextRedirect,\n} from 'next/navigation';\nimport type { createNavigation as _createNavigation } from 'next-intl/navigation';\nimport { usePathname, useRouter } from './hooks';\nimport { Link } from './Link';\nimport { localizeHref, type NextIntlHref } from './localizeHref';\n\n/** Arguments shared by `getPathname`, `redirect` and `permanentRedirect`. */\ntype LocalizedHrefArgs = { href: NextIntlHref; locale: string };\n\n/** The optional `RedirectType` accepted by `next/navigation`'s redirect APIs. */\ntype RedirectTypeArg = Parameters<typeof nextRedirect>[1];\n\n/**\n * Drop-in replacement for next-intl's `createNavigation`.\n *\n * Returns locale-aware navigation APIs (`Link`, `usePathname`, `useRouter`,\n * `getPathname`, `redirect`, `permanentRedirect`) backed by Intlayer's routing\n * configuration. The `routing` argument is accepted for API compatibility;\n * locales come from the Intlayer configuration.\n *\n * @example\n * ```ts\n * export const { Link, redirect, usePathname, useRouter, getPathname } =\n *   createNavigation();\n * ```\n */\nexport const createNavigation: typeof _createNavigation = (\n  _routing?: unknown\n) => {\n  const getPathname = ({ href, locale }: LocalizedHrefArgs): string =>\n    localizeHref(href, locale);\n\n  const redirect = (\n    { href, locale }: LocalizedHrefArgs,\n    type?: RedirectTypeArg\n  ) => nextRedirect(localizeHref(href, locale), type);\n\n  const permanentRedirect = (\n    { href, locale }: LocalizedHrefArgs,\n    type?: RedirectTypeArg\n  ) => nextPermanentRedirect(localizeHref(href, locale), type);\n\n  return {\n    Link: Link as ReturnType<typeof _createNavigation>['Link'],\n    usePathname,\n    useRouter,\n    getPathname,\n    redirect,\n    permanentRedirect,\n  } as ReturnType<typeof _createNavigation>;\n};\n\nexport default createNavigation;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,oBACX,aACG;CACH,MAAM,eAAe,EAAE,MAAM,aAC3B,aAAa,MAAM,MAAM;CAE3B,MAAMA,cACJ,EAAE,MAAM,UACR,SACGC,SAAa,aAAa,MAAM,MAAM,GAAG,IAAI;CAElD,MAAMC,uBACJ,EAAE,MAAM,UACR,SACGC,kBAAsB,aAAa,MAAM,MAAM,GAAG,IAAI;CAE3D,OAAO;EACC;EACN;EACA;EACA;EACA;EACA;CACF;AACF"}

package/dist/esm/navigation/hooks.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.mjs","names":["useNextPathname","useNextRouter"],"sources":["../../../src/navigation/hooks.ts"],"sourcesContent":["'use client';\n\nimport {\n  usePathname as useNextPathname,\n  useRouter as useNextRouter,\n} from 'next/navigation';\nimport { useLocale } from 'next-intlayer';\nimport { localizeHref, type NextIntlHref } from './localizeHref';\n\n/**\n * Options accepted by the locale-aware router methods: the standard Next.js\n * navigate options plus an optional target `locale`.\n */\ntype NavigateOptions = { locale?: string } & Record<string, unknown>;\n\n/**\n * Drop-in for the `usePathname` returned by next-intl's `createNavigation`.\n * Returns the current pathname with the locale prefix stripped.\n */\nexport const usePathname = (): string => {\n  const pathname = useNextPathname();\n  const { locale } = useLocale();\n  const prefix = `/${locale}`;\n\n  if (pathname === prefix) return '/';\n  if (pathname.startsWith(`${prefix}/`)) return pathname.slice(prefix.length);\n  return pathname;\n};\n\n/**\n * Drop-in for the `useRouter` returned by next-intl's `createNavigation`.\n * Wraps the Next.js router so `push`/`replace`/`prefetch` localize their href\n * (honouring an optional `locale` option) before navigating.\n */\nexport const useRouter = () => {\n  const router = useNextRouter();\n  const { locale: currentLocale } = useLocale();\n\n  const localize = (href: NextIntlHref, locale?: string): string =>\n    localizeHref(href, locale ?? (currentLocale as string));\n\n  return {\n    ...router,\n    push: (href: NextIntlHref, options?: NavigateOptions) =>\n      router.push(\n        localize(href, options?.locale),\n        options as Parameters<typeof router.push>[1]\n      ),\n    replace: (href: NextIntlHref, options?: NavigateOptions) =>\n      router.replace(\n        localize(href, options?.locale),\n        options as Parameters<typeof router.replace>[1]\n      ),\n    prefetch: (href: NextIntlHref, options?: NavigateOptions) =>\n      router.prefetch(localize(href, options?.locale)),\n  };\n};\n"],"mappings":";;;;;;;;;;;AAmBA,MAAa,oBAA4B;CACvC,MAAM,WAAWA,eAAiB;CAClC,MAAM,EAAE,WAAW,WAAW;CAC9B,MAAM,SAAS,IAAI;AAEnB,KAAI,aAAa,OAAQ,QAAO;AAChC,KAAI,SAAS,WAAW,GAAG,OAAO,GAAG,CAAE,QAAO,SAAS,MAAM,OAAO,OAAO;AAC3E,QAAO;;;;;;;AAQT,MAAa,kBAAkB;CAC7B,MAAM,SAASC,aAAe;CAC9B,MAAM,EAAE,QAAQ,kBAAkB,WAAW;CAE7C,MAAM,YAAY,MAAoB,WACpC,aAAa,MAAM,UAAW,cAAyB;AAEzD,QAAO;EACL,GAAG;EACH,OAAO,MAAoB,YACzB,OAAO,KACL,SAAS,MAAM,SAAS,OAAO,EAC/B,QACD;EACH,UAAU,MAAoB,YAC5B,OAAO,QACL,SAAS,MAAM,SAAS,OAAO,EAC/B,QACD;EACH,WAAW,MAAoB,YAC7B,OAAO,SAAS,SAAS,MAAM,SAAS,OAAO,CAAC;EACnD"}
+{"version":3,"file":"hooks.mjs","names":["useNextPathname","useNextRouter"],"sources":["../../../src/navigation/hooks.ts"],"sourcesContent":["'use client';\n\nimport {\n  usePathname as useNextPathname,\n  useRouter as useNextRouter,\n} from 'next/navigation';\nimport { useLocale } from 'next-intlayer';\nimport { localizeHref, type NextIntlHref } from './localizeHref';\n\n/**\n * Options accepted by the locale-aware router methods: the standard Next.js\n * navigate options plus an optional target `locale`.\n */\ntype NavigateOptions = { locale?: string } & Record<string, unknown>;\n\n/**\n * Drop-in for the `usePathname` returned by next-intl's `createNavigation`.\n * Returns the current pathname with the locale prefix stripped.\n */\nexport const usePathname = (): string => {\n  const pathname = useNextPathname();\n  const { locale } = useLocale();\n  const prefix = `/${locale}`;\n\n  if (pathname === prefix) return '/';\n  if (pathname.startsWith(`${prefix}/`)) return pathname.slice(prefix.length);\n  return pathname;\n};\n\n/**\n * Drop-in for the `useRouter` returned by next-intl's `createNavigation`.\n * Wraps the Next.js router so `push`/`replace`/`prefetch` localize their href\n * (honouring an optional `locale` option) before navigating.\n */\nexport const useRouter = () => {\n  const router = useNextRouter();\n  const { locale: currentLocale } = useLocale();\n\n  const localize = (href: NextIntlHref, locale?: string): string =>\n    localizeHref(href, locale ?? (currentLocale as string));\n\n  return {\n    ...router,\n    push: (href: NextIntlHref, options?: NavigateOptions) =>\n      router.push(\n        localize(href, options?.locale),\n        options as Parameters<typeof router.push>[1]\n      ),\n    replace: (href: NextIntlHref, options?: NavigateOptions) =>\n      router.replace(\n        localize(href, options?.locale),\n        options as Parameters<typeof router.replace>[1]\n      ),\n    prefetch: (href: NextIntlHref, options?: NavigateOptions) =>\n      router.prefetch(localize(href, options?.locale)),\n  };\n};\n"],"mappings":";;;;;;;;;;;AAmBA,MAAa,oBAA4B;CACvC,MAAM,WAAWA,cAAgB;CACjC,MAAM,EAAE,WAAW,UAAU;CAC7B,MAAM,SAAS,IAAI;CAEnB,IAAI,aAAa,QAAQ,OAAO;CAChC,IAAI,SAAS,WAAW,GAAG,OAAO,EAAE,GAAG,OAAO,SAAS,MAAM,OAAO,MAAM;CAC1E,OAAO;AACT;;;;;;AAOA,MAAa,kBAAkB;CAC7B,MAAM,SAASC,YAAc;CAC7B,MAAM,EAAE,QAAQ,kBAAkB,UAAU;CAE5C,MAAM,YAAY,MAAoB,WACpC,aAAa,MAAM,UAAW,aAAwB;CAExD,OAAO;EACL,GAAG;EACH,OAAO,MAAoB,YACzB,OAAO,KACL,SAAS,MAAM,SAAS,MAAM,GAC9B,OACF;EACF,UAAU,MAAoB,YAC5B,OAAO,QACL,SAAS,MAAM,SAAS,MAAM,GAC9B,OACF;EACF,WAAW,MAAoB,YAC7B,OAAO,SAAS,SAAS,MAAM,SAAS,MAAM,CAAC;CACnD;AACF"}

package/dist/esm/navigation/localizeHref.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"localizeHref.mjs","names":[],"sources":["../../../src/navigation/localizeHref.ts"],"sourcesContent":["import { getLocalizedUrl } from '@intlayer/core/localization';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\n/**\n * A `next-intl` navigation href: either a pathname string or an object with a\n * `pathname` and optional `query`. The `pathnames` (typed routes) feature is\n * accepted for API compatibility but not interpolated.\n */\nexport type NextIntlHref =\n  | string\n  | {\n      pathname: string;\n      query?: Record<string, string | number | (string | number)[]>;\n      params?: Record<string, string | number | (string | number)[]>;\n    };\n\n/**\n * Prefix a `next-intl` href with the given locale using Intlayer's\n * `getLocalizedUrl`, preserving any query parameters.\n *\n * @param href - The target href (string or `{ pathname, query }`).\n * @param locale - The locale to localize the href for.\n * @returns The localized URL string.\n */\nexport const localizeHref = (href: NextIntlHref, locale: string): string => {\n  const pathname = typeof href === 'string' ? href : href.pathname;\n  const localizedPathname = getLocalizedUrl(pathname, locale as LocalesValues);\n\n  if (typeof href === 'string' || !href.query) {\n    return localizedPathname;\n  }\n\n  const searchParams = new URLSearchParams();\n  for (const [key, value] of Object.entries(href.query)) {\n    if (Array.isArray(value)) {\n      for (const entry of value) {\n        searchParams.append(key, String(entry));\n      }\n    } else {\n      searchParams.append(key, String(value));\n    }\n  }\n\n  const queryString = searchParams.toString();\n  return queryString\n    ? `${localizedPathname}?${queryString}`\n    : localizedPathname;\n};\n"],"mappings":";;;;;;;;;;;AAwBA,MAAa,gBAAgB,MAAoB,WAA2B;CAE1E,MAAM,oBAAoB,gBADT,OAAO,SAAS,WAAW,OAAO,KAAK,UACJ,OAAwB;AAE5E,KAAI,OAAO,SAAS,YAAY,CAAC,KAAK,MACpC,QAAO;CAGT,MAAM,eAAe,IAAI,iBAAiB;AAC1C,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,MAAM,CACnD,KAAI,MAAM,QAAQ,MAAM,CACtB,MAAK,MAAM,SAAS,MAClB,cAAa,OAAO,KAAK,OAAO,MAAM,CAAC;KAGzC,cAAa,OAAO,KAAK,OAAO,MAAM,CAAC;CAI3C,MAAM,cAAc,aAAa,UAAU;AAC3C,QAAO,cACH,GAAG,kBAAkB,GAAG,gBACxB"}
+{"version":3,"file":"localizeHref.mjs","names":[],"sources":["../../../src/navigation/localizeHref.ts"],"sourcesContent":["import { getLocalizedUrl } from '@intlayer/core/localization';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\n/**\n * A `next-intl` navigation href: either a pathname string or an object with a\n * `pathname` and optional `query`. The `pathnames` (typed routes) feature is\n * accepted for API compatibility but not interpolated.\n */\nexport type NextIntlHref =\n  | string\n  | {\n      pathname: string;\n      query?: Record<string, string | number | (string | number)[]>;\n      params?: Record<string, string | number | (string | number)[]>;\n    };\n\n/**\n * Prefix a `next-intl` href with the given locale using Intlayer's\n * `getLocalizedUrl`, preserving any query parameters.\n *\n * @param href - The target href (string or `{ pathname, query }`).\n * @param locale - The locale to localize the href for.\n * @returns The localized URL string.\n */\nexport const localizeHref = (href: NextIntlHref, locale: string): string => {\n  const pathname = typeof href === 'string' ? href : href.pathname;\n  const localizedPathname = getLocalizedUrl(pathname, locale as LocalesValues);\n\n  if (typeof href === 'string' || !href.query) {\n    return localizedPathname;\n  }\n\n  const searchParams = new URLSearchParams();\n  for (const [key, value] of Object.entries(href.query)) {\n    if (Array.isArray(value)) {\n      for (const entry of value) {\n        searchParams.append(key, String(entry));\n      }\n    } else {\n      searchParams.append(key, String(value));\n    }\n  }\n\n  const queryString = searchParams.toString();\n  return queryString\n    ? `${localizedPathname}?${queryString}`\n    : localizedPathname;\n};\n"],"mappings":";;;;;;;;;;;AAwBA,MAAa,gBAAgB,MAAoB,WAA2B;CAE1E,MAAM,oBAAoB,gBADT,OAAO,SAAS,WAAW,OAAO,KAAK,UACJ,MAAuB;CAE3E,IAAI,OAAO,SAAS,YAAY,CAAC,KAAK,OACpC,OAAO;CAGT,MAAM,eAAe,IAAI,gBAAgB;CACzC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,KAAK,GAClD,IAAI,MAAM,QAAQ,KAAK,GACrB,KAAK,MAAM,SAAS,OAClB,aAAa,OAAO,KAAK,OAAO,KAAK,CAAC;MAGxC,aAAa,OAAO,KAAK,OAAO,KAAK,CAAC;CAI1C,MAAM,cAAc,aAAa,SAAS;CAC1C,OAAO,cACH,GAAG,kBAAkB,GAAG,gBACxB;AACN"}

package/dist/esm/plugin/index.mjs

@@ -3,8 +3,9 @@ import * as ANSIColors from "@intlayer/config/colors";
 import { colorize, getAppLogger } from "@intlayer/config/logger";
 import { createRequire } from "node:module";
 import { dirname, join, relative, resolve, sep } from "node:path";
-import { runOnce } from "@intlayer/chokidar/utils";
+import { NEXT_INTL_CALLERS, toSwcExtraCallers } from "@intlayer/config/callers";
 import { getConfiguration } from "@intlayer/config/node";
+import { runOnce } from "@intlayer/engine/utils";
 
 //#region src/plugin/index.ts
 /**
@@ -86,19 +87,12 @@ const resolveEsmPath = (specifier) => {
 * @returns Relative specifier such as `./node_modules/@intlayer/next-intl/...`.
 */
 const toTurbopackAlias = (absolutePath) => `./${relative(process.cwd(), absolutePath).split(sep).join("/")}`;
-const NEXT_INTL_SWC_CALLERS = [{
-	callerName: "useTranslations",
-	importSources: ["next-intl", "@intlayer/next-intl"],
-	namespaceArgIndex: 0,
-	staticReplacement: "useDictionary",
-	dynamicReplacement: "useDictionaryDynamic"
-}, {
-	callerName: "getTranslations",
-	importSources: ["next-intl/server", "@intlayer/next-intl/server"],
-	namespaceArgIndex: 0,
-	staticReplacement: "getDictionary",
-	dynamicReplacement: "getDictionaryDynamic"
-}];
+/**
+* SWC extra-caller configs derived from the shared caller registry
+* (`@intlayer/config/callers`) — the single source of truth also consumed by
+* the babel analyzer/optimizer and the LSP.
+*/
+const NEXT_INTL_SWC_CALLERS = toSwcExtraCallers(NEXT_INTL_CALLERS);
 /**
 * A Next.js plugin for next-intl compat that wraps next-intlayer's plugin
 * and configures resolve aliases so `next-intl` imports are served by

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/plugin/index.ts"],"sourcesContent":["import { createRequire } from 'node:module';\nimport { dirname, join, relative, resolve, sep } 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 { NextConfig } from 'next';\nimport { withIntlayer } from 'next-intlayer/server';\n\n/**\n * `require` that works in both the CJS and ESM builds of this plugin.\n * `import.meta.url` is rewritten to the module path in the CJS output by the\n * bundler, so `createRequire` resolves correctly in either format.\n */\nconst compatRequire = createRequire(import.meta.url);\n\n/**\n * Maps each original `next-intl` import specifier to the `@intlayer/next-intl`\n * specifier that should serve it instead.\n */\nconst ALIAS_ENTRIES: { request: string; replacement: string }[] = [\n  { request: 'next-intl/server', replacement: '@intlayer/next-intl/server' },\n  { request: 'next-intl/routing', replacement: '@intlayer/next-intl/routing' },\n  {\n    request: 'next-intl/navigation',\n    replacement: '@intlayer/next-intl/navigation',\n  },\n  {\n    request: 'next-intl/middleware',\n    replacement: '@intlayer/next-intl/middleware',\n  },\n  { request: 'next-intl', replacement: '@intlayer/next-intl' },\n];\n\n/**\n * Split a package specifier into its package name and export subpath.\n *\n * @param specifier - e.g. `@intlayer/next-intl/server` or `next-intl`.\n * @returns `{ packageName, exportKey }` where `exportKey` is the `exports` map\n * key (`.` for the package root).\n */\nconst splitSpecifier = (\n  specifier: string\n): { packageName: string; exportKey: string } => {\n  const segments = specifier.split('/');\n  const packageName = specifier.startsWith('@')\n    ? segments.slice(0, 2).join('/')\n    : (segments[0] ?? specifier);\n  const subpath = specifier.slice(packageName?.length);\n  return { packageName, exportKey: subpath === '' ? '.' : `.${subpath}` };\n};\n\n/**\n * Resolve the absolute path of a package export, preferring the ESM (`import`)\n * condition so Turbopack and modern bundlers load the `.mjs` build (which keeps\n * the `\"use client\"` directives) rather than the CommonJS fallback.\n *\n * Both Turbopack and webpack ignore alias values that are bare package\n * specifiers, so the aliases must point at real files.\n *\n * @param specifier - Package specifier, e.g. `@intlayer/next-intl/server`.\n * @returns Absolute path to the resolved module file.\n */\nconst resolveEsmPath = (specifier: string): string => {\n  const { packageName, exportKey } = splitSpecifier(specifier);\n  const packageJson = compatRequire(`${packageName}/package.json`) as {\n    exports?: Record<\n      string,\n      string | { import?: string; require?: string; default?: string }\n    >;\n  };\n  const packageDir = dirname(\n    compatRequire.resolve(`${packageName}/package.json`)\n  );\n\n  const exportEntry = packageJson.exports?.[exportKey];\n  const relativeFile =\n    typeof exportEntry === 'string'\n      ? exportEntry\n      : (exportEntry?.import ?? exportEntry?.require ?? exportEntry?.default);\n\n  // Fall back to Node resolution if the exports map is unexpected.\n  if (!relativeFile) return compatRequire.resolve(specifier);\n\n  return resolve(packageDir, relativeFile);\n};\n\n/**\n * Format an absolute path as a project-root-relative specifier (prefixed with\n * `./` and using forward slashes). Turbopack only honours `resolveAlias` values\n * that are project-root-relative paths — bare specifiers are ignored and\n * absolute paths are misread as root-relative. Mirrors `withIntlayer`'s\n * Turbopack alias formatter.\n *\n * @param absolutePath - Absolute path to the target module file.\n * @returns Relative specifier such as `./node_modules/@intlayer/next-intl/...`.\n */\nconst toTurbopackAlias = (absolutePath: string): string =>\n  `./${relative(process.cwd(), absolutePath).split(sep).join('/')}`;\n\nconst NEXT_INTL_SWC_CALLERS = [\n  {\n    callerName: 'useTranslations',\n    importSources: ['next-intl', '@intlayer/next-intl'],\n    namespaceArgIndex: 0,\n    staticReplacement: 'useDictionary',\n    dynamicReplacement: 'useDictionaryDynamic',\n  },\n  {\n    callerName: 'getTranslations',\n    importSources: ['next-intl/server', '@intlayer/next-intl/server'],\n    namespaceArgIndex: 0,\n    staticReplacement: 'getDictionary',\n    dynamicReplacement: 'getDictionaryDynamic',\n  },\n];\n\n/**\n * A Next.js plugin for next-intl compat that wraps next-intlayer's plugin\n * and configures resolve aliases so `next-intl` imports are served by\n * `@intlayer/next-intl`.\n */\nexport const createNextIntlPlugin = (_i18nPath?: string) => {\n  return async (nextConfig: NextConfig = {}): Promise<NextConfig> => {\n    const intlayerConfig = getConfiguration();\n    const appLogger = getAppLogger(intlayerConfig);\n\n    runOnce(\n      join(\n        intlayerConfig?.system?.baseDir ?? process.cwd(),\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 customWebpack = nextConfig.webpack;\n\n    const resolvedTargets = ALIAS_ENTRIES.map(({ request, replacement }) => ({\n      request,\n      absolutePath: resolveEsmPath(replacement),\n    }));\n\n    // Webpack resolves aliases from absolute paths.\n    const webpackAlias = Object.fromEntries(\n      resolvedTargets.map(({ request, absolutePath }) => [\n        request,\n        absolutePath,\n      ])\n    );\n\n    // Turbopack only honours project-root-relative `./` paths.\n    const turboAlias = Object.fromEntries(\n      resolvedTargets.map(({ request, absolutePath }) => [\n        request,\n        toTurbopackAlias(absolutePath),\n      ])\n    );\n\n    const aliasConfig = {\n      webpack: (config: any, options: any) => {\n        config.resolve.alias = {\n          ...config.resolve.alias,\n          ...webpackAlias,\n        };\n\n        if (typeof customWebpack === 'function') {\n          return customWebpack(config, options);\n        }\n        return config;\n      },\n    };\n\n    const mergedConfig: NextConfig = {\n      ...nextConfig,\n      ...aliasConfig,\n      turbopack: {\n        ...(nextConfig.turbopack ?? {}),\n        resolveAlias: {\n          ...(nextConfig.turbopack?.resolveAlias ?? {}),\n          ...turboAlias,\n        },\n      },\n    };\n\n    // Only inject the NEXT_LOCALE cookie default when the user has not\n    // configured their own routing.storage in intlayer.config.ts.\n    // This lets users override via intlayer.config.ts while keeping\n    // next-intl compatibility (NEXT_LOCALE) as the default.\n    let hasUserDefinedStorage = false;\n    try {\n      hasUserDefinedStorage = !!(\n        intlayerConfig?.routing &&\n        'storage' in intlayerConfig.routing &&\n        intlayerConfig.routing.storage !== undefined\n      );\n    } catch {\n      // If the config file cannot be read, fall back to the NEXT_LOCALE default.\n    }\n\n    const configOptions = hasUserDefinedStorage\n      ? { swcExtraCallers: NEXT_INTL_SWC_CALLERS }\n      : {\n          override: {\n            routing: {\n              storage: [\n                { type: 'cookie' as const, name: 'NEXT_LOCALE' },\n                { type: 'header' as const, name: 'x-intlayer-locale' },\n              ],\n            },\n          },\n          swcExtraCallers: NEXT_INTL_SWC_CALLERS,\n        };\n\n    return withIntlayer(mergedConfig, configOptions);\n  };\n};\n\nexport default createNextIntlPlugin;\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/plugin/index.ts"],"sourcesContent":["import { createRequire } from 'node:module';\nimport { dirname, join, relative, resolve, sep } from 'node:path';\nimport { NEXT_INTL_CALLERS, toSwcExtraCallers } 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 { NextConfig } from 'next';\nimport { withIntlayer } from 'next-intlayer/server';\n\n/**\n * `require` that works in both the CJS and ESM builds of this plugin.\n * `import.meta.url` is rewritten to the module path in the CJS output by the\n * bundler, so `createRequire` resolves correctly in either format.\n */\nconst compatRequire = createRequire(import.meta.url);\n\n/**\n * Maps each original `next-intl` import specifier to the `@intlayer/next-intl`\n * specifier that should serve it instead.\n */\nconst ALIAS_ENTRIES: { request: string; replacement: string }[] = [\n  { request: 'next-intl/server', replacement: '@intlayer/next-intl/server' },\n  { request: 'next-intl/routing', replacement: '@intlayer/next-intl/routing' },\n  {\n    request: 'next-intl/navigation',\n    replacement: '@intlayer/next-intl/navigation',\n  },\n  {\n    request: 'next-intl/middleware',\n    replacement: '@intlayer/next-intl/middleware',\n  },\n  { request: 'next-intl', replacement: '@intlayer/next-intl' },\n];\n\n/**\n * Split a package specifier into its package name and export subpath.\n *\n * @param specifier - e.g. `@intlayer/next-intl/server` or `next-intl`.\n * @returns `{ packageName, exportKey }` where `exportKey` is the `exports` map\n * key (`.` for the package root).\n */\nconst splitSpecifier = (\n  specifier: string\n): { packageName: string; exportKey: string } => {\n  const segments = specifier.split('/');\n  const packageName = specifier.startsWith('@')\n    ? segments.slice(0, 2).join('/')\n    : (segments[0] ?? specifier);\n  const subpath = specifier.slice(packageName?.length);\n  return { packageName, exportKey: subpath === '' ? '.' : `.${subpath}` };\n};\n\n/**\n * Resolve the absolute path of a package export, preferring the ESM (`import`)\n * condition so Turbopack and modern bundlers load the `.mjs` build (which keeps\n * the `\"use client\"` directives) rather than the CommonJS fallback.\n *\n * Both Turbopack and webpack ignore alias values that are bare package\n * specifiers, so the aliases must point at real files.\n *\n * @param specifier - Package specifier, e.g. `@intlayer/next-intl/server`.\n * @returns Absolute path to the resolved module file.\n */\nconst resolveEsmPath = (specifier: string): string => {\n  const { packageName, exportKey } = splitSpecifier(specifier);\n  const packageJson = compatRequire(`${packageName}/package.json`) as {\n    exports?: Record<\n      string,\n      string | { import?: string; require?: string; default?: string }\n    >;\n  };\n  const packageDir = dirname(\n    compatRequire.resolve(`${packageName}/package.json`)\n  );\n\n  const exportEntry = packageJson.exports?.[exportKey];\n  const relativeFile =\n    typeof exportEntry === 'string'\n      ? exportEntry\n      : (exportEntry?.import ?? exportEntry?.require ?? exportEntry?.default);\n\n  // Fall back to Node resolution if the exports map is unexpected.\n  if (!relativeFile) return compatRequire.resolve(specifier);\n\n  return resolve(packageDir, relativeFile);\n};\n\n/**\n * Format an absolute path as a project-root-relative specifier (prefixed with\n * `./` and using forward slashes). Turbopack only honours `resolveAlias` values\n * that are project-root-relative paths — bare specifiers are ignored and\n * absolute paths are misread as root-relative. Mirrors `withIntlayer`'s\n * Turbopack alias formatter.\n *\n * @param absolutePath - Absolute path to the target module file.\n * @returns Relative specifier such as `./node_modules/@intlayer/next-intl/...`.\n */\nconst toTurbopackAlias = (absolutePath: string): string =>\n  `./${relative(process.cwd(), absolutePath).split(sep).join('/')}`;\n\n/**\n * SWC extra-caller configs derived from the shared caller registry\n * (`@intlayer/config/callers`) — the single source of truth also consumed by\n * the babel analyzer/optimizer and the LSP.\n */\nconst NEXT_INTL_SWC_CALLERS = toSwcExtraCallers(NEXT_INTL_CALLERS);\n\n/**\n * A Next.js plugin for next-intl compat that wraps next-intlayer's plugin\n * and configures resolve aliases so `next-intl` imports are served by\n * `@intlayer/next-intl`.\n */\nexport const createNextIntlPlugin = (_i18nPath?: string) => {\n  return async (nextConfig: NextConfig = {}): Promise<NextConfig> => {\n    const intlayerConfig = getConfiguration();\n    const appLogger = getAppLogger(intlayerConfig);\n\n    runOnce(\n      join(\n        intlayerConfig?.system?.baseDir ?? process.cwd(),\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 customWebpack = nextConfig.webpack;\n\n    const resolvedTargets = ALIAS_ENTRIES.map(({ request, replacement }) => ({\n      request,\n      absolutePath: resolveEsmPath(replacement),\n    }));\n\n    // Webpack resolves aliases from absolute paths.\n    const webpackAlias = Object.fromEntries(\n      resolvedTargets.map(({ request, absolutePath }) => [\n        request,\n        absolutePath,\n      ])\n    );\n\n    // Turbopack only honours project-root-relative `./` paths.\n    const turboAlias = Object.fromEntries(\n      resolvedTargets.map(({ request, absolutePath }) => [\n        request,\n        toTurbopackAlias(absolutePath),\n      ])\n    );\n\n    const aliasConfig = {\n      webpack: (config: any, options: any) => {\n        config.resolve.alias = {\n          ...config.resolve.alias,\n          ...webpackAlias,\n        };\n\n        if (typeof customWebpack === 'function') {\n          return customWebpack(config, options);\n        }\n        return config;\n      },\n    };\n\n    const mergedConfig: NextConfig = {\n      ...nextConfig,\n      ...aliasConfig,\n      turbopack: {\n        ...(nextConfig.turbopack ?? {}),\n        resolveAlias: {\n          ...(nextConfig.turbopack?.resolveAlias ?? {}),\n          ...turboAlias,\n        },\n      },\n    };\n\n    // Only inject the NEXT_LOCALE cookie default when the user has not\n    // configured their own routing.storage in intlayer.config.ts.\n    // This lets users override via intlayer.config.ts while keeping\n    // next-intl compatibility (NEXT_LOCALE) as the default.\n    let hasUserDefinedStorage = false;\n    try {\n      hasUserDefinedStorage = !!(\n        intlayerConfig?.routing &&\n        'storage' in intlayerConfig.routing &&\n        intlayerConfig.routing.storage !== undefined\n      );\n    } catch {\n      // If the config file cannot be read, fall back to the NEXT_LOCALE default.\n    }\n\n    const configOptions = hasUserDefinedStorage\n      ? { swcExtraCallers: NEXT_INTL_SWC_CALLERS }\n      : {\n          override: {\n            routing: {\n              storage: [\n                { type: 'cookie' as const, name: 'NEXT_LOCALE' },\n                { type: 'header' as const, name: 'x-intlayer-locale' },\n              ],\n            },\n          },\n          swcExtraCallers: NEXT_INTL_SWC_CALLERS,\n        };\n\n    return withIntlayer(mergedConfig, configOptions);\n  };\n};\n\nexport default createNextIntlPlugin;\n"],"mappings":"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"}

package/dist/esm/routing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"routing.mjs","names":[],"sources":["../../src/routing.ts"],"sourcesContent":["import { internationalization, routing } from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\nexport type Routing = {\n  locales: LocalesValues[];\n  defaultLocale: LocalesValues;\n  localePrefix?: 'always' | 'as-needed' | 'never';\n  pathnames?: Record<string, string | Record<string, string>>;\n};\n\n/**\n * Drop-in replacement for next-intl's `defineRouting()`.\n *\n * Merges the provided config with Intlayer's own routing / internationalization\n * configuration so you don't have to repeat locale lists. All fields are\n * optional — omitted values are read from the Intlayer config at runtime.\n *\n * @example\n * ```ts\n * export default defineRouting({\n *   locales: ['en', 'fr'],\n *   defaultLocale: 'en',\n * });\n * ```\n */\nexport const defineRouting: (config?: Partial<Routing>) => Routing = (\n  config?: Partial<Routing>\n): Routing => ({\n  locales:\n    config?.locales ??\n    ((internationalization?.locales ?? []) as LocalesValues[]),\n  defaultLocale:\n    config?.defaultLocale ??\n    (internationalization?.defaultLocale as LocalesValues),\n  localePrefix:\n    config?.localePrefix ?? (routing?.prefixDefault ? 'always' : 'as-needed'),\n  ...config,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;AAyBA,MAAa,iBACX,YACa;CACb,SACE,QAAQ,WACN,sBAAsB,WAAW,EAAE;CACvC,eACE,QAAQ,iBACP,sBAAsB;CACzB,cACE,QAAQ,iBAAiB,SAAS,gBAAgB,WAAW;CAC/D,GAAG;CACJ"}
+{"version":3,"file":"routing.mjs","names":[],"sources":["../../src/routing.ts"],"sourcesContent":["import { internationalization, routing } from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\nexport type Routing = {\n  locales: LocalesValues[];\n  defaultLocale: LocalesValues;\n  localePrefix?: 'always' | 'as-needed' | 'never';\n  pathnames?: Record<string, string | Record<string, string>>;\n};\n\n/**\n * Drop-in replacement for next-intl's `defineRouting()`.\n *\n * Merges the provided config with Intlayer's own routing / internationalization\n * configuration so you don't have to repeat locale lists. All fields are\n * optional — omitted values are read from the Intlayer config at runtime.\n *\n * @example\n * ```ts\n * export default defineRouting({\n *   locales: ['en', 'fr'],\n *   defaultLocale: 'en',\n * });\n * ```\n */\nexport const defineRouting: (config?: Partial<Routing>) => Routing = (\n  config?: Partial<Routing>\n): Routing => ({\n  locales:\n    config?.locales ??\n    ((internationalization?.locales ?? []) as LocalesValues[]),\n  defaultLocale:\n    config?.defaultLocale ??\n    (internationalization?.defaultLocale as LocalesValues),\n  localePrefix:\n    config?.localePrefix ?? (routing?.prefixDefault ? 'always' : 'as-needed'),\n  ...config,\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;AAyBA,MAAa,iBACX,YACa;CACb,SACE,QAAQ,WACN,sBAAsB,WAAW,CAAC;CACtC,eACE,QAAQ,iBACP,sBAAsB;CACzB,cACE,QAAQ,iBAAiB,SAAS,gBAAgB,WAAW;CAC/D,GAAG;AACL"}

package/dist/esm/server/getLocale.mjs

@@ -1,10 +1,24 @@
+import { getCachedRequestLocale } from "./requestLocaleCache.mjs";
 import { getLocale as getLocale$1 } from "next-intlayer/server";
 
 //#region src/server/getLocale.ts
 /**
 * Drop-in for next-intl's `getLocale()` server function.
+*
+* Resolution order mirrors next-intl's per-request model:
+*
+* 1. The locale forwarded through `setRequestLocale(locale)` (the `[locale]`
+*    route segment) — the source of truth for URL-driven routing. This is what
+*    keeps server-rendered content and the locale switcher in sync with the URL
+*    instead of a stale cookie.
+* 2. Otherwise Intlayer's own resolution (cookie / header / Accept-Language),
+*    for apps that drive the locale from storage rather than the route.
 */
-const getLocale = async () => await getLocale$1();
+const getLocale = async () => {
+	const requestLocale = getCachedRequestLocale();
+	if (requestLocale) return requestLocale;
+	return await getLocale$1();
+};
 
 //#endregion
 export { getLocale };

package/dist/esm/server/getLocale.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getLocale.mjs","names":["getLocaleIntlayer"],"sources":["../../../src/server/getLocale.ts"],"sourcesContent":["import type { getLocale as _getLocale } from 'next-intl/server';\nimport { getLocale as getLocaleIntlayer } from 'next-intlayer/server';\n\n/**\n * Drop-in for next-intl's `getLocale()` server function.\n */\nexport const getLocale: typeof _getLocale = async (): Promise<string> =>\n  (await getLocaleIntlayer()) as string;\n"],"mappings":";;;;;;AAMA,MAAa,YAA+B,YACzC,MAAMA,aAAmB"}
+{"version":3,"file":"getLocale.mjs","names":["getLocaleIntlayer"],"sources":["../../../src/server/getLocale.ts"],"sourcesContent":["import type { getLocale as _getLocale } from 'next-intl/server';\nimport { getLocale as getLocaleIntlayer } from 'next-intlayer/server';\nimport { getCachedRequestLocale } from './requestLocaleCache';\n\n/**\n * Drop-in for next-intl's `getLocale()` server function.\n *\n * Resolution order mirrors next-intl's per-request model:\n *\n * 1. The locale forwarded through `setRequestLocale(locale)` (the `[locale]`\n *    route segment) — the source of truth for URL-driven routing. This is what\n *    keeps server-rendered content and the locale switcher in sync with the URL\n *    instead of a stale cookie.\n * 2. Otherwise Intlayer's own resolution (cookie / header / Accept-Language),\n *    for apps that drive the locale from storage rather than the route.\n */\nexport const getLocale: typeof _getLocale = async (): Promise<string> => {\n  const requestLocale = getCachedRequestLocale();\n  if (requestLocale) return requestLocale as string;\n\n  return (await getLocaleIntlayer()) as string;\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,MAAa,YAA+B,YAA6B;CACvE,MAAM,gBAAgB,uBAAuB;CAC7C,IAAI,eAAe,OAAO;CAE1B,OAAQ,MAAMA,YAAkB;AAClC"}

package/dist/esm/server/getMessages.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getMessages.mjs","names":[],"sources":["../../../src/server/getMessages.ts"],"sourcesContent":["import { log } from '@intlayer/config/built';\nimport { CYAN } from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport type { getMessages as _getMessages } from 'next-intl/server';\n\n/**\n * Drop-in replacement for next-intl's `getMessages()` server function.\n *\n * Returns all compiled dictionary content for the current locale as a flat\n * record keyed by dictionary name. Useful when you need to pass messages\n * to a `NextIntlClientProvider`.\n *\n * @example\n * ```ts\n * const messages = await getMessages();\n * ```\n *\n * @deprecated getMessages has no use case with intlayer.\n * Messages are loaded automatically under the hood\n */\nexport const getMessages: typeof _getMessages = async () => {\n  if (process.env.NODE_ENV === 'development') {\n    const appLogger = getAppLogger({ log });\n    appLogger(\n      `${colorize('getMessages', CYAN)} has no use case with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`\n    );\n  }\n\n  return {};\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,cAAmC,YAAY;AAGxD,CADkB,aAAa,EAAE,KAAK,CAC7B,CACP,GAAG,SAAS,eAAe,KAAK,CAAC,iHAClC;AAGH,QAAO,EAAE"}
+{"version":3,"file":"getMessages.mjs","names":[],"sources":["../../../src/server/getMessages.ts"],"sourcesContent":["import { log } from '@intlayer/config/built';\nimport { CYAN } from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport type { getMessages as _getMessages } from 'next-intl/server';\n\n/**\n * Drop-in replacement for next-intl's `getMessages()` server function.\n *\n * Returns all compiled dictionary content for the current locale as a flat\n * record keyed by dictionary name. Useful when you need to pass messages\n * to a `NextIntlClientProvider`.\n *\n * @example\n * ```ts\n * const messages = await getMessages();\n * ```\n *\n * @deprecated getMessages has no use case with intlayer.\n * Messages are loaded automatically under the hood\n */\nexport const getMessages: typeof _getMessages = async () => {\n  if (process.env.NODE_ENV === 'development') {\n    const appLogger = getAppLogger({ log });\n    appLogger(\n      `${colorize('getMessages', CYAN)} has no use case with intlayer. Messages are loaded automatically under the hood for bundle optimization reason`\n    );\n  }\n\n  return {};\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,cAAmC,YAAY;CAGxD,AADkB,aAAa,EAAE,IAAI,CAC7B,CAAC,CACP,GAAG,SAAS,eAAe,IAAI,EAAE,gHACnC;CAGF,OAAO,CAAC;AACV"}

package/dist/esm/server/getRequestConfig.mjs

@@ -0,0 +1,25 @@
+import { log } from "@intlayer/config/built";
+import { CYAN } from "@intlayer/config/colors";
+import { colorize, getAppLogger } from "@intlayer/config/logger";
+
+//#region src/server/getRequestConfig.ts
+/**
+* Drop-in for next-intl's `getRequestConfig`.
+*
+* In next-intl this registers the per-request config (locale + messages) read
+* by its own plugin. With intlayer the locale is resolved from routing /
+* storage and messages come from compiled dictionaries, so the returned config
+* is never consumed — this is an identity passthrough kept so existing
+* `i18n/request.ts` files keep resolving and type-checking.
+*
+* @deprecated getRequestConfig has no use case with intlayer. The locale and
+* messages are resolved automatically; the file can be removed.
+*/
+const getRequestConfig = (createRequestConfig) => {
+	getAppLogger({ log })(`${colorize("getRequestConfig", CYAN)} has no use case with intlayer. The locale and messages are resolved automatically; the i18n/request.ts file can be removed`);
+	return createRequestConfig;
+};
+
+//#endregion
+export { getRequestConfig as default, getRequestConfig };
+//# sourceMappingURL=getRequestConfig.mjs.map

package/dist/esm/server/getRequestConfig.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRequestConfig.mjs","names":[],"sources":["../../../src/server/getRequestConfig.ts"],"sourcesContent":["import { log } from '@intlayer/config/built';\nimport { CYAN } from '@intlayer/config/colors';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport type { getRequestConfig as _getRequestConfig } from 'next-intl/server';\n\n/**\n * Drop-in for next-intl's `getRequestConfig`.\n *\n * In next-intl this registers the per-request config (locale + messages) read\n * by its own plugin. With intlayer the locale is resolved from routing /\n * storage and messages come from compiled dictionaries, so the returned config\n * is never consumed — this is an identity passthrough kept so existing\n * `i18n/request.ts` files keep resolving and type-checking.\n *\n * @deprecated getRequestConfig has no use case with intlayer. The locale and\n * messages are resolved automatically; the file can be removed.\n */\nexport const getRequestConfig: typeof _getRequestConfig = (\n  createRequestConfig\n) => {\n  if (process.env.NODE_ENV === 'development') {\n    const appLogger = getAppLogger({ log });\n    appLogger(\n      `${colorize('getRequestConfig', CYAN)} has no use case with intlayer. The locale and messages are resolved automatically; the i18n/request.ts file can be removed`\n    );\n  }\n\n  return createRequestConfig;\n};\n\nexport default getRequestConfig;\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,MAAa,oBACX,wBACG;CAGD,AADkB,aAAa,EAAE,IAAI,CAC7B,CAAC,CACP,GAAG,SAAS,oBAAoB,IAAI,EAAE,4HACxC;CAGF,OAAO;AACT"}

package/dist/esm/server/getTranslations.mjs

@@ -1,5 +1,5 @@
 import { getLocale } from "./getLocale.mjs";
-import { createTranslator } from "../createTranslator.mjs";
+import { createTranslator } from "@intlayer/use-intl";
 
 //#region src/server/getTranslations.ts
 /**
@@ -10,8 +10,9 @@ import { createTranslator } from "../createTranslator.mjs";
 * arguments (`{value, number}`). Rich text is available through `t.rich()`
 * and `t.markup()`.
 *
-* Also accepts an options object `{ namespace, locale }` to match next-intl's
-* full server API surface.
+* Resolves the active locale from the current request (or the `locale` option)
+* and delegates to `@intlayer/use-intl`'s `createTranslator`, the same runtime
+* that backs the client `useTranslations`.
 *
 * @example
 * ```ts
@@ -36,7 +37,10 @@ const getTranslations = (async (namespaceOrOptions) => {
 		namespace = namespaceOrOptions.namespace;
 		localeOverride = namespaceOrOptions.locale;
 	} else namespace = namespaceOrOptions;
-	return createTranslator(localeOverride ?? await getLocale(), namespace);
+	return createTranslator({
+		locale: localeOverride ?? await getLocale(),
+		namespace
+	});
 });
 
 //#endregion

package/dist/esm/server/getTranslations.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getTranslations.mjs","names":[],"sources":["../../../src/server/getTranslations.ts"],"sourcesContent":["import type { ValidDotPathsFor } from '@intlayer/core/transpiler';\nimport type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type { ReactNode } from 'react';\nimport {\n  createTranslator,\n  type MarkupChunkRenderer,\n  type RichChunkRenderer,\n} from '../createTranslator';\nimport { getLocale } from './getLocale';\n\n/**\n * Options accepted by the options-object overload of {@link getTranslations}.\n */\ntype GetTranslationsOptions<N extends DictionaryKeys> = {\n  /** The dictionary namespace to scope translations to. */\n  namespace?: N;\n  /** Override the locale instead of reading it from the current request. */\n  locale?: LocalesValues;\n};\n\n/**\n * The translation function returned by {@link getTranslations}.\n *\n * Beyond the plain call signature, the function exposes:\n * - `has(key)` — returns `true` when the key exists in the namespace.\n * - `raw(key)` — returns the unprocessed message value.\n * - `rich(key, values)` — resolves `<tag>chunks</tag>` markup to React nodes.\n * - `markup(key, values)` — resolves `<tag>chunks</tag>` markup to a string.\n */\ntype TranslateFunction<N extends DictionaryKeys> = {\n  /** Translate a key to a string, with optional ICU interpolation params. */\n  <P extends ValidDotPathsFor<N>>(\n    key: P,\n    params?: Record<string, unknown>\n  ): string;\n  /** Returns `true` if the given key exists in the namespace. */\n  has<P extends ValidDotPathsFor<N>>(key: P): boolean;\n  /** Returns the raw unprocessed message for the given key. */\n  raw<P extends ValidDotPathsFor<N>>(key: P): unknown;\n  /** Resolves rich-text markup, mapping tags through React renderers. */\n  rich<P extends ValidDotPathsFor<N>>(\n    key: P,\n    values?: Record<string, RichChunkRenderer | ReactNode>\n  ): ReactNode;\n  /** Resolves rich-text markup, mapping tags through string renderers. */\n  markup<P extends ValidDotPathsFor<N>>(\n    key: P,\n    values?: Record<string, MarkupChunkRenderer | string | number>\n  ): string;\n};\n\n/** Loosely-typed function returned for nested `'dict.scope'` namespaces. */\ntype LooseTranslateFunction = {\n  (key: string, params?: Record<string, unknown>): string;\n  has(key: string): boolean;\n  raw(key: string): unknown;\n  rich(\n    key: string,\n    values?: Record<string, RichChunkRenderer | ReactNode>\n  ): ReactNode;\n  markup(\n    key: string,\n    values?: Record<string, MarkupChunkRenderer | string | number>\n  ): string;\n};\n\n/**\n * Overload set for {@link getTranslations}:\n *\n * 1. A bare dictionary key → fully-typed `t()` (autocompleted dot-paths).\n * 2. An options object `{ namespace?, locale? }` → typed when namespace is\n *    a known `DictionaryKeys` value.\n * 3. A nested namespace `'dictionary.sub.scope'` → `t()` accepts relative\n *    `string` paths, matching next-intl's scoped-namespace behaviour.\n * 4. No namespace → root scope; the first segment of each key designates\n *    the dictionary (`t('about.title')`).\n */\ntype GetTranslations = {\n  <N extends DictionaryKeys>(namespace: N): Promise<TranslateFunction<N>>;\n  <N extends DictionaryKeys>(\n    options: GetTranslationsOptions<N>\n  ): Promise<TranslateFunction<N>>;\n  (namespace: `${string}.${string}`): Promise<LooseTranslateFunction>;\n  (): Promise<LooseTranslateFunction>;\n};\n\n/**\n * Drop-in for next-intl's server `getTranslations()`.\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 * Also accepts an options object `{ namespace, locale }` to match next-intl's\n * full server API surface.\n *\n * @example\n * ```ts\n * // Bare namespace — fully typed dot-paths\n * const t = await getTranslations('about');\n * return <h1>{t('counter.label')}</h1>;\n *\n * // ICU plural\n * t('items', { count: 3 });\n *\n * // Options object with locale override\n * const t = await getTranslations({ namespace: 'about', locale: 'fr' });\n *\n * // Rich text\n * t.rich('terms', { link: (chunks) => <a href=\"/terms\">{chunks}</a> });\n * ```\n */\nexport const getTranslations: GetTranslations = (async (\n  namespaceOrOptions?: string | GetTranslationsOptions<DictionaryKeys>\n) => {\n  let namespace: string | undefined;\n  let localeOverride: LocalesValues | undefined;\n\n  if (typeof namespaceOrOptions === 'object' && namespaceOrOptions !== null) {\n    namespace = namespaceOrOptions.namespace;\n    localeOverride = namespaceOrOptions.locale;\n  } else {\n    namespace = namespaceOrOptions as string | undefined;\n  }\n\n  const locale = localeOverride ?? (await getLocale());\n\n  return createTranslator(locale as LocalesValues, namespace);\n}) as GetTranslations;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoHA,MAAa,mBAAoC,OAC/C,uBACG;CACH,IAAI;CACJ,IAAI;AAEJ,KAAI,OAAO,uBAAuB,YAAY,uBAAuB,MAAM;AACzE,cAAY,mBAAmB;AAC/B,mBAAiB,mBAAmB;OAEpC,aAAY;AAKd,QAAO,iBAFQ,kBAAmB,MAAM,WAAW,EAEF,UAAU"}
+{"version":3,"file":"getTranslations.mjs","names":[],"sources":["../../../src/server/getTranslations.ts"],"sourcesContent":["import type {\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport {\n  createTranslator,\n  type LooseTranslateFunction,\n  type TranslateFunction,\n  type TranslateFunctionForNamespace,\n} from '@intlayer/use-intl';\nimport { getLocale } from './getLocale';\n\n/**\n * Options accepted by the options-object overload of {@link getTranslations}.\n */\ntype GetTranslationsOptions<N extends DictionaryKeys> = {\n  /** The dictionary namespace to scope translations to. */\n  namespace?: N;\n  /** Override the locale instead of reading it from the current request. */\n  locale?: LocalesValues;\n};\n\n/**\n * Overload set for {@link getTranslations}:\n *\n * 1. A bare dictionary key → fully-typed `t()` (autocompleted dot-paths).\n * 2. An options object `{ namespace?, locale? }` → typed when namespace is\n *    a known `DictionaryKeys` value.\n * 3. A nested namespace `'dictionary.sub.scope'` → `t()` accepts relative\n *    dot-paths under the scope, typed against the dictionary, matching\n *    next-intl's scoped-namespace behaviour.\n * 4. No namespace → root scope; the first segment of each key designates\n *    the dictionary (`t('about.title')`).\n *\n * The translate function shape (`t`, `t.rich`, `t.markup`, `t.raw`, `t.has`)\n * is shared with `@intlayer/use-intl`.\n */\ntype GetTranslations = {\n  <N extends DictionaryKeys>(namespace: N): Promise<TranslateFunction<N>>;\n  <N extends DictionaryKeys>(\n    options: GetTranslationsOptions<N>\n  ): Promise<TranslateFunction<N>>;\n  <N extends `${string}.${string}`>(\n    namespace: N\n  ): Promise<TranslateFunctionForNamespace<N>>;\n  (): Promise<LooseTranslateFunction>;\n};\n\n/**\n * Drop-in for next-intl's server `getTranslations()`.\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 * Resolves the active locale from the current request (or the `locale` option)\n * and delegates to `@intlayer/use-intl`'s `createTranslator`, the same runtime\n * that backs the client `useTranslations`.\n *\n * @example\n * ```ts\n * // Bare namespace — fully typed dot-paths\n * const t = await getTranslations('about');\n * return <h1>{t('counter.label')}</h1>;\n *\n * // ICU plural\n * t('items', { count: 3 });\n *\n * // Options object with locale override\n * const t = await getTranslations({ namespace: 'about', locale: 'fr' });\n *\n * // Rich text\n * t.rich('terms', { link: (chunks) => <a href=\"/terms\">{chunks}</a> });\n * ```\n */\nexport const getTranslations: GetTranslations = (async (\n  namespaceOrOptions?: string | GetTranslationsOptions<DictionaryKeys>\n) => {\n  let namespace: string | undefined;\n  let localeOverride: LocalesValues | undefined;\n\n  if (typeof namespaceOrOptions === 'object' && namespaceOrOptions !== null) {\n    namespace = namespaceOrOptions.namespace;\n    localeOverride = namespaceOrOptions.locale;\n  } else {\n    namespace = namespaceOrOptions as string | undefined;\n  }\n\n  const locale = localeOverride ?? (await getLocale());\n\n  return createTranslator({ locale: locale as LocalesValues, namespace });\n}) as GetTranslations;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4EA,MAAa,mBAAoC,OAC/C,uBACG;CACH,IAAI;CACJ,IAAI;CAEJ,IAAI,OAAO,uBAAuB,YAAY,uBAAuB,MAAM;EACzE,YAAY,mBAAmB;EAC/B,iBAAiB,mBAAmB;CACtC,OACE,YAAY;CAKd,OAAO,iBAAiB;EAAE,QAFX,kBAAmB,MAAM,UAAU;EAES;CAAU,CAAC;AACxE"}

package/dist/esm/server/helpers.mjs

@@ -1,13 +1,14 @@
-import { createFormatter } from "../createFormatter.mjs";
 import { getLocale } from "./getLocale.mjs";
+import { createFormatter } from "@intlayer/use-intl";
 
 //#region src/server/helpers.ts
 /**
 * Drop-in for next-intl's server `getFormatter()`.
-* Returns locale-aware formatters backed by the native `Intl.*` APIs.
+* Returns locale-aware formatters backed by the native `Intl.*` APIs,
+* built by `@intlayer/use-intl`'s `createFormatter`.
 */
 const getFormatter = (async (options) => {
-	return createFormatter(options?.locale ?? await getLocale());
+	return createFormatter({ locale: options?.locale ?? await getLocale() });
 });
 /**
 * Drop-in for next-intl's server `getNow()`.

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.mjs","names":[],"sources":["../../../src/server/helpers.ts"],"sourcesContent":["import type {\n  getFormatter as _getFormatter,\n  getNow as _getNow,\n  getTimeZone as _getTimeZone,\n} from 'next-intl/server';\nimport { createFormatter } from '../createFormatter';\nimport { getLocale } from './getLocale';\n\n/**\n * Drop-in for next-intl's server `getFormatter()`.\n * Returns locale-aware formatters backed by the native `Intl.*` APIs.\n */\nexport const getFormatter: typeof _getFormatter = (async (options?: {\n  locale?: string;\n}) => {\n  const locale = options?.locale ?? (await getLocale());\n  return createFormatter(locale as string);\n}) as typeof _getFormatter;\n\n/**\n * Drop-in for next-intl's server `getNow()`.\n * Returns the current `Date`.\n */\nexport const getNow: typeof _getNow = (async () =>\n  new Date()) as typeof _getNow;\n\n/**\n * Drop-in for next-intl's server `getTimeZone()`.\n * Returns the system time zone resolved from `Intl.DateTimeFormat`.\n */\nexport const getTimeZone: typeof _getTimeZone = (async () =>\n  Intl.DateTimeFormat().resolvedOptions().timeZone) as typeof _getTimeZone;\n"],"mappings":";;;;;;;;AAYA,MAAa,gBAAsC,OAAO,YAEpD;AAEJ,QAAO,gBADQ,SAAS,UAAW,MAAM,WAAW,CACZ;;;;;;AAO1C,MAAa,UAA0B,4BACrC,IAAI,MAAM;;;;;AAMZ,MAAa,eAAoC,YAC/C,KAAK,gBAAgB,CAAC,iBAAiB,CAAC"}
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../../../src/server/helpers.ts"],"sourcesContent":["import { createFormatter } from '@intlayer/use-intl';\nimport type {\n  getFormatter as _getFormatter,\n  getNow as _getNow,\n  getTimeZone as _getTimeZone,\n} from 'next-intl/server';\nimport { getLocale } from './getLocale';\n\n/**\n * Drop-in for next-intl's server `getFormatter()`.\n * Returns locale-aware formatters backed by the native `Intl.*` APIs,\n * built by `@intlayer/use-intl`'s `createFormatter`.\n */\nexport const getFormatter: typeof _getFormatter = (async (options?: {\n  locale?: string;\n}) => {\n  const locale = options?.locale ?? (await getLocale());\n  return createFormatter({ locale: locale as string });\n}) as typeof _getFormatter;\n\n/**\n * Drop-in for next-intl's server `getNow()`.\n * Returns the current `Date`.\n */\nexport const getNow: typeof _getNow = (async () =>\n  new Date()) as typeof _getNow;\n\n/**\n * Drop-in for next-intl's server `getTimeZone()`.\n * Returns the system time zone resolved from `Intl.DateTimeFormat`.\n */\nexport const getTimeZone: typeof _getTimeZone = (async () =>\n  Intl.DateTimeFormat().resolvedOptions().timeZone) as typeof _getTimeZone;\n"],"mappings":";;;;;;;;;AAaA,MAAa,gBAAsC,OAAO,YAEpD;CAEJ,OAAO,gBAAgB,EAAE,QADV,SAAS,UAAW,MAAM,UAAU,EACD,CAAC;AACrD;;;;;AAMA,MAAa,UAA0B,4BACrC,IAAI,KAAK;;;;;AAMX,MAAa,eAAoC,YAC/C,KAAK,eAAe,CAAC,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/esm/server/index.mjs

@@ -2,8 +2,10 @@ import { getLocale } from "./getLocale.mjs";
 import { getDictionary } from "../getDictionary.mjs";
 import { getDictionaryDynamic } from "../getDictionaryDynamic.mjs";
 import { getFormatter, getNow, getTimeZone } from "./helpers.mjs";
+import getRequestConfig from "./getRequestConfig.mjs";
+import { setRequestLocale } from "./setRequestLocale.mjs";
 import { setLocale } from "./setLocale.mjs";
 import { getTranslations } from "./getTranslations.mjs";
 import { getMessages } from "./getMessages.mjs";
 
-export { getDictionary, getDictionaryDynamic, getFormatter, getLocale, getMessages, getNow, getTimeZone, getTranslations, setLocale };
+export { getDictionary, getDictionaryDynamic, getFormatter, getLocale, getMessages, getNow, getRequestConfig, getTimeZone, getTranslations, setLocale, setRequestLocale };

package/dist/esm/server/requestLocaleCache.mjs

@@ -0,0 +1,33 @@
+import { cache } from "react";
+
+//#region src/server/requestLocaleCache.ts
+/**
+* Request-scoped holder for the locale provided through {@link setRequestLocale}.
+*
+* next-intl resolves the active locale per request from the `[locale]` route
+* segment, which the app forwards via `setRequestLocale(locale)`. React's
+* `cache()` gives a per-request singleton (the same trick next-intl uses in its
+* own `RequestLocaleCache`), so the value set in the layout/page is readable by
+* the other server APIs (`getLocale`, `getTranslations`, …) during the same
+* render.
+*
+* @see https://github.com/vercel/next.js/discussions/58862
+*/
+const getRequestLocaleHolder = cache(() => ({ locale: void 0 }));
+/**
+* Read the locale stored for the current request, or `undefined` when
+* `setRequestLocale` has not been called.
+*/
+const getCachedRequestLocale = () => getRequestLocaleHolder().locale;
+/**
+* Store the locale for the current request. Called by `setRequestLocale`.
+*
+* @param locale - The locale resolved from the `[locale]` route segment.
+*/
+const setCachedRequestLocale = (locale) => {
+	getRequestLocaleHolder().locale = locale;
+};
+
+//#endregion
+export { getCachedRequestLocale, setCachedRequestLocale };
+//# sourceMappingURL=requestLocaleCache.mjs.map

package/dist/esm/server/requestLocaleCache.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestLocaleCache.mjs","names":[],"sources":["../../../src/server/requestLocaleCache.ts"],"sourcesContent":["import type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { cache } from 'react';\n\n/**\n * Request-scoped holder for the locale provided through {@link setRequestLocale}.\n *\n * next-intl resolves the active locale per request from the `[locale]` route\n * segment, which the app forwards via `setRequestLocale(locale)`. React's\n * `cache()` gives a per-request singleton (the same trick next-intl uses in its\n * own `RequestLocaleCache`), so the value set in the layout/page is readable by\n * the other server APIs (`getLocale`, `getTranslations`, …) during the same\n * render.\n *\n * @see https://github.com/vercel/next.js/discussions/58862\n */\nconst getRequestLocaleHolder = cache((): { locale?: LocalesValues } => ({\n  locale: undefined,\n}));\n\n/**\n * Read the locale stored for the current request, or `undefined` when\n * `setRequestLocale` has not been called.\n */\nexport const getCachedRequestLocale = (): LocalesValues | undefined =>\n  getRequestLocaleHolder().locale;\n\n/**\n * Store the locale for the current request. Called by `setRequestLocale`.\n *\n * @param locale - The locale resolved from the `[locale]` route segment.\n */\nexport const setCachedRequestLocale = (locale: LocalesValues): void => {\n  getRequestLocaleHolder().locale = locale;\n};\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAM,yBAAyB,aAAyC,EACtE,QAAQ,OACV,EAAE;;;;;AAMF,MAAa,+BACX,uBAAuB,CAAC,CAAC;;;;;;AAO3B,MAAa,0BAA0B,WAAgC;CACrE,uBAAuB,CAAC,CAAC,SAAS;AACpC"}

package/dist/esm/server/setLocale.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"setLocale.mjs","names":[],"sources":["../../../src/server/setLocale.ts"],"sourcesContent":["import { setLocaleInStorageServer } from '@intlayer/core/utils';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { cookies } from 'next/headers.js';\n\n/**\n * Drop-in replacement for next-intl's `setLocale()` server action.\n *\n * Writes the locale to whichever cookie(s) the active `routing.storage`\n * configuration specifies. When `createNextIntlPlugin` is used (the default),\n * this is `NEXT_LOCALE`; when the user has configured a custom storage in\n * `intlayer.config.ts`, that name is used instead.\n *\n * Must be called inside a Server Action.\n *\n * @example\n * ```ts\n * 'use server';\n * await setLocale('fr');\n * ```\n */\nexport const setLocale = async (locale: string): Promise<void> => {\n  const cookieStore = await cookies();\n\n  setLocaleInStorageServer(locale as LocalesValues, {\n    setCookieStore: (name, value, attributes) => {\n      cookieStore.set(name, value, {\n        ...(attributes ?? {}),\n        path: attributes?.path ?? '/',\n        sameSite: (attributes?.sameSite as 'lax') ?? 'lax',\n        httpOnly: attributes?.httpOnly ?? false,\n        secure: attributes?.secure ?? process.env.NODE_ENV === 'production',\n      });\n    },\n  });\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,YAAY,OAAO,WAAkC;CAChE,MAAM,cAAc,MAAM,SAAS;AAEnC,0BAAyB,QAAyB,EAChD,iBAAiB,MAAM,OAAO,eAAe;AAC3C,cAAY,IAAI,MAAM,OAAO;GAC3B,GAAI,cAAc,EAAE;GACpB,MAAM,YAAY,QAAQ;GAC1B,UAAW,YAAY,YAAsB;GAC7C,UAAU,YAAY,YAAY;GAClC,QAAQ,YAAY,UAAU;GAC/B,CAAC;IAEL,CAAC"}
+{"version":3,"file":"setLocale.mjs","names":[],"sources":["../../../src/server/setLocale.ts"],"sourcesContent":["import { setLocaleInStorageServer } from '@intlayer/core/utils';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { cookies } from 'next/headers.js';\n\n/**\n * Drop-in replacement for next-intl's `setLocale()` server action.\n *\n * Writes the locale to whichever cookie(s) the active `routing.storage`\n * configuration specifies. When `createNextIntlPlugin` is used (the default),\n * this is `NEXT_LOCALE`; when the user has configured a custom storage in\n * `intlayer.config.ts`, that name is used instead.\n *\n * Must be called inside a Server Action.\n *\n * @example\n * ```ts\n * 'use server';\n * await setLocale('fr');\n * ```\n */\nexport const setLocale = async (locale: string): Promise<void> => {\n  const cookieStore = await cookies();\n\n  setLocaleInStorageServer(locale as LocalesValues, {\n    setCookieStore: (name, value, attributes) => {\n      cookieStore.set(name, value, {\n        ...(attributes ?? {}),\n        path: attributes?.path ?? '/',\n        sameSite: (attributes?.sameSite as 'lax') ?? 'lax',\n        httpOnly: attributes?.httpOnly ?? false,\n        secure: attributes?.secure ?? process.env.NODE_ENV === 'production',\n      });\n    },\n  });\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,YAAY,OAAO,WAAkC;CAChE,MAAM,cAAc,MAAM,QAAQ;CAElC,yBAAyB,QAAyB,EAChD,iBAAiB,MAAM,OAAO,eAAe;EAC3C,YAAY,IAAI,MAAM,OAAO;GAC3B,GAAI,cAAc,CAAC;GACnB,MAAM,YAAY,QAAQ;GAC1B,UAAW,YAAY,YAAsB;GAC7C,UAAU,YAAY,YAAY;GAClC,QAAQ,YAAY,UAAU;EAChC,CAAC;CACH,EACF,CAAC;AACH"}

package/dist/esm/server/setRequestLocale.mjs

@@ -0,0 +1,32 @@
+import { setCachedRequestLocale } from "./requestLocaleCache.mjs";
+
+//#region src/server/setRequestLocale.ts
+/**
+* Drop-in for next-intl's `setRequestLocale`.
+*
+* In next-intl this stores the locale (typically the `[locale]` route segment)
+* in a request-scoped cache so the rest of the request can render in that
+* locale and opt into static rendering. The compat keeps the same contract:
+* the locale is stored per-request and read back by `getLocale()` (and, through
+* it, `getTranslations` / `getDictionary` / metadata). This is what makes the
+* per-request locale — and therefore the locale switcher — work without relying
+* on a cookie.
+*
+* @param locale - The locale resolved from the `[locale]` route segment.
+*
+* @example
+* ```ts
+* export default async function LocaleLayout({ params }) {
+*   const { locale } = await params;
+*   setRequestLocale(locale);
+*   // …
+* }
+* ```
+*/
+const setRequestLocale = (locale) => {
+	setCachedRequestLocale(locale);
+};
+
+//#endregion
+export { setRequestLocale };
+//# sourceMappingURL=setRequestLocale.mjs.map

package/dist/esm/server/setRequestLocale.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"setRequestLocale.mjs","names":[],"sources":["../../../src/server/setRequestLocale.ts"],"sourcesContent":["import type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport type { setRequestLocale as _setRequestLocale } from 'next-intl/server';\nimport { setCachedRequestLocale } from './requestLocaleCache';\n\n/**\n * Drop-in for next-intl's `setRequestLocale`.\n *\n * In next-intl this stores the locale (typically the `[locale]` route segment)\n * in a request-scoped cache so the rest of the request can render in that\n * locale and opt into static rendering. The compat keeps the same contract:\n * the locale is stored per-request and read back by `getLocale()` (and, through\n * it, `getTranslations` / `getDictionary` / metadata). This is what makes the\n * per-request locale — and therefore the locale switcher — work without relying\n * on a cookie.\n *\n * @param locale - The locale resolved from the `[locale]` route segment.\n *\n * @example\n * ```ts\n * export default async function LocaleLayout({ params }) {\n *   const { locale } = await params;\n *   setRequestLocale(locale);\n *   // …\n * }\n * ```\n */\nexport const setRequestLocale: typeof _setRequestLocale = (locale): void => {\n  setCachedRequestLocale(locale as LocalesValues);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAa,oBAA8C,WAAiB;CAC1E,uBAAuB,MAAuB;AAChD"}

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

@@ -1,7 +1,6 @@
 import { LocalesValues } from "@intlayer/types/module_augmentation";
 import { NextIntlClientProvider as NextIntlClientProvider$1 } from "next-intl";
 import { ComponentProps } from "react";
-
 //#region src/client/NextIntlClientProvider.d.ts
 /**
  * Drop-in for next-intl's `NextIntlClientProvider`.

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

@@ -1 +1 @@
-{"version":3,"file":"NextIntlClientProvider.d.ts","names":[],"sources":["../../../src/client/NextIntlClientProvider.tsx"],"mappings":";;;;;;;AAeA;;;cAAa,sBAAA,SAA+B,wBAAA;;AAgC5C;;KAAY,2BAAA,GAA8B,IAAA,CACxC,cAAA,QAAsB,wBAAA;EAAA;;;;EAOtB,QAAA;EAIqB;;;EAArB,MAAA,EAAQ,aAAA;AAAA"}
+{"version":3,"file":"NextIntlClientProvider.d.ts","names":[],"sources":["../../../src/client/NextIntlClientProvider.tsx"],"mappings":";;;;;;;;;cAiBa,+BAA+B;;;;KAsDhC,8BAA8B,KACxC,sBAAsB;;;;;EAOtB;;;;EAIA,QAAQ"}

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

@@ -1,7 +1,4 @@
 import { NextIntlClientProvider, NextIntlClientProviderProps } from "./NextIntlClientProvider.js";
-import { IntlProvider, useExtracted, useFormatter, useMessages, useNow, useTimeZone } from "./helpers.js";
-import { useDictionary } from "../useDictionary.js";
-import { useDictionaryDynamic } from "../useDictionaryDynamic.js";
 import { useLocale } from "./useLocale.js";
-import { useTranslations } from "./useTranslations.js";
+import { IntlProvider, _useExtracted as useExtracted, useDictionary, useDictionaryDynamic, useFormatter, useMessages, useNow, useTimeZone, useTranslations } from "@intlayer/use-intl";
 export { IntlProvider, NextIntlClientProvider, type NextIntlClientProviderProps, useDictionary, useDictionaryDynamic, useExtracted, useFormatter, useLocale, useMessages, useNow, useTimeZone, useTranslations };

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

@@ -1,5 +1,4 @@
 import { useLocale as useLocale$1 } from "next-intl";
-
 //#region src/client/useLocale.d.ts
 /**
  * Drop-in for next-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":";;;;;AAQA;cAAa,SAAA,SAAkB,WAAA"}
+{"version":3,"file":"useLocale.d.ts","names":[],"sources":["../../../src/client/useLocale.ts"],"mappings":";;;;;cAQa,kBAAkB"}

package/dist/types/getDictionary.d.ts

@@ -1,23 +1,35 @@
-import { ValidDotPathsFor } from "@intlayer/core/transpiler";
+import { DictionaryKeys, LocalesValues } from "@intlayer/types/module_augmentation";
+import { ScopedTranslateFunction, TranslateFunction } from "@intlayer/use-intl";
 import { Dictionary } from "@intlayer/types/dictionary";
-
 //#region src/getDictionary.d.ts
+/**
+ * Overload set for {@link getDictionary}: a string rest argument is the
+ * key-prefix remainder of a nested namespace (relative dot-paths under the
+ * scope); otherwise the translator is typed against the dictionary's
+ * dot-paths.
+ */
+type GetDictionary = {
+  <T extends Dictionary, Prefix extends string>(dictionary: T, namespacePrefix: Prefix): Promise<ScopedTranslateFunction<T['key'] & DictionaryKeys, Prefix>>;
+  <T extends Dictionary>(dictionary: T, options?: {
+    locale?: LocalesValues;
+  }): Promise<TranslateFunction<T['key'] & DictionaryKeys>>;
+};
 /**
  * Dictionary-accepting variant of `getTranslations`.
  *
- * Used internally by the SWC optimization: instead of looking up the dictionary
- * at runtime by key, the SWC plugin pre-imports the dictionary JSON at build time
- * and passes it directly here. This enables tree-shaking of unused locale content.
+ * Used internally by the build-time optimization: instead of looking up the
+ * dictionary at runtime by key, the babel/swc plugin pre-imports the dictionary
+ * JSON at build time and passes it directly here. This enables tree-shaking of
+ * unused locale content.
  *
- * Runs on the server, where next-intl apps do not mount an `IntlayerServerProvider`.
- * The request locale therefore cannot be read from a server context and is resolved
- * asynchronously from the cookie/header via `getLocale()`. `getTranslations` is always
- * awaited, so an async resolver is a drop-in replacement.
+ * Runs on the server, where next-intl apps do not mount an
+ * `IntlayerServerProvider`. The request locale therefore cannot be read from a
+ * server context and is resolved asynchronously from the cookie/header via
+ * `getLocale()` (or the explicit `{ locale }` of the object overload).
+ * `getTranslations` is always awaited, so an async resolver is a drop-in
+ * replacement.
  */
-declare const getDictionary: <T extends Dictionary>(dictionary: T, namespacePrefix?: string) => Promise<(<P extends ValidDotPathsFor<any>>(lookup: P, params?: Record<string, unknown>) => string) & {
-  has: <P extends ValidDotPathsFor<any>>(lookup: P) => boolean;
-  raw: <P extends ValidDotPathsFor<any>>(lookup: P) => unknown;
-}>;
+declare const getDictionary: GetDictionary;
 //#endregion
 export { getDictionary };
 //# sourceMappingURL=getDictionary.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getDictionary.d.ts","names":[],"sources":["../../src/getDictionary.ts"],"mappings":";;;;;;AAmCA;;;;;;;;;;cAAa,aAAA,aAAiC,UAAA,EAC5C,UAAA,EAAY,CAAA,EACZ,eAAA,cAAwB,OAAA,aASX,gBAAA,OAAqB,MAAA,EACtB,CAAA,EAAC,MAAA,GACA,MAAA;kBAUO,gBAAA,OAAqB,MAAA,EAAU,CAAA;kBAE/B,gBAAA,OAAqB,MAAA,EAAU,CAAA;AAAA"}
+{"version":3,"file":"getDictionary.d.ts","names":[],"sources":["../../src/getDictionary.ts"],"mappings":";;;;;;;;;;KAkCK;GACF,UAAU,YAAY,uBACrB,YAAY,GACZ,iBAAiB,SAChB,QAAQ,wBAAwB,WAAW,gBAAgB;GAC7D,UAAU,YACT,YAAY,GACZ;IAAY,SAAS;MACpB,QAAQ,kBAAkB,WAAW;;;;;;;;;;;;;;;;;cAkB7B,eASP"}

package/dist/types/getDictionaryDynamic.d.ts

@@ -1,15 +1,23 @@
-import { StrictModeLocaleMap } from "@intlayer/types/module_augmentation";
-import { ValidDotPathsFor } from "@intlayer/core/transpiler";
+import { DictionaryKeys, StrictModeLocaleMap } from "@intlayer/types/module_augmentation";
+import { ScopedTranslateFunction, TranslateFunction } from "@intlayer/use-intl";
 import { Dictionary } from "@intlayer/types/dictionary";
-
 //#region src/getDictionaryDynamic.d.ts
+/**
+ * Overload set for {@link getDictionaryDynamic}: 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 GetDictionaryDynamic = {
+  <T extends Dictionary, K extends DictionaryKeys>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>, key: K): Promise<TranslateFunction<K>>;
+  <T extends Dictionary, K extends DictionaryKeys, Prefix extends string>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>, key: K, namespacePrefix: Prefix): Promise<ScopedTranslateFunction<K, Prefix>>;
+};
 /**
  * Dynamic dictionary-accepting variant of `getTranslations`.
+ *
+ * Counterpart to {@link getDictionary} for dictionaries imported lazily per
+ * locale. Used internally by the build-time optimization.
  */
-declare const getDictionaryDynamic: <const T extends Dictionary, const K extends string>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>, key: K, namespacePrefix?: string) => Promise<(<P extends ValidDotPathsFor<any>>(lookup: P, params?: Record<string, unknown>) => string) & {
-  has: <P extends ValidDotPathsFor<any>>(lookup: P) => boolean;
-  raw: <P extends ValidDotPathsFor<any>>(lookup: P) => unknown;
-}>;
+declare const getDictionaryDynamic: GetDictionaryDynamic;
 //#endregion
 export { getDictionaryDynamic };
 //# sourceMappingURL=getDictionaryDynamic.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"getDictionaryDynamic.d.ts","names":[],"sources":["../../src/getDictionaryDynamic.ts"],"mappings":";;;;;;;AAyBA;cAAa,oBAAA,mBACK,UAAA,0BAGhB,iBAAA,EAAmB,mBAAA,OAA0B,OAAA,CAAQ,CAAA,IACrD,GAAA,EAAK,CAAA,EACL,eAAA,cAAwB,OAAA,aAWX,gBAAA,OAAqB,MAAA,EACtB,CAAA,EAAC,MAAA,GACA,MAAA;kBAUO,gBAAA,OAAqB,MAAA,EAAU,CAAA;kBAE/B,gBAAA,OAAqB,MAAA,EAAU,CAAA;AAAA"}
+{"version":3,"file":"getDictionaryDynamic.d.ts","names":[],"sources":["../../src/getDictionaryDynamic.ts"],"mappings":";;;;;;;;;KAmBK;GACF,UAAU,YAAY,UAAU,gBAC/B,mBAAmB,0BAA0B,QAAQ,KACrD,KAAK,IACJ,QAAQ,kBAAkB;GAC5B,UAAU,YAAY,UAAU,gBAAgB,uBAC/C,mBAAmB,0BAA0B,QAAQ,KACrD,KAAK,GACL,iBAAiB,SAChB,QAAQ,wBAAwB,GAAG;;;;;;;;cAS3B,sBAYP"}