@djangocfg/nextjs 2.1.626 → 2.1.627

package/README.md

@@ -304,6 +304,16 @@ function MyComponent() {
 }
 ```
 
+#### Shared locale cookie (several hosts, one family)
+
+`NEXT_LOCALE` is written by the **proxy** (`createProxy` → `shareLocaleCookie`) and by `useChangeLocale` in the browser, never during render. Server components read the locale from the URL segment, so the cookie cannot change what SSR renders; it only decides where a bare `/` redirects. With `Domain=<registrable domain>` every host of the family sends the same value; the host-only twin is expired so it cannot shadow it. Override the domain guess with `NEXT_PUBLIC_COOKIE_DOMAIN`.
+
+What it costs, and the rules that keep SSR intact:
+- A response that sets a cookie is not cached by a CDN by default. The proxy sets it only when next-intl wrote one (a bare-path visit or a switch), not on every page view; keep it that way and do not add `Set-Cookie` to static pages.
+- Never read `NEXT_LOCALE` in a server component (`cookies()` makes the route dynamic). Take `locale` from `params`.
+- SEO sites (one language per host, indexed) keep `localeCookie: false`; sharing applies only to app families behind a login.
+- If this ever causes trouble, the fallback is no cookie at all: the locale lives in the URL, and the family switcher links to the sibling host with the same locale prefix.
+
 #### Locale Switcher
 
 Smart wrapper around `@djangocfg/layouts` LocaleSwitcher with automatic next-intl hooks:

package/dist/i18n/client.mjs

@@ -95,6 +95,49 @@ function NextIntlProvider({
   );
 }
 
+// src/i18n/shared-locale.ts
+var LOCALE_COOKIE = "NEXT_LOCALE";
+var LOCALE_COOKIE_MAX_AGE = 60 * 60 * 24 * 365;
+var TWO_LABEL_SUFFIXES = /* @__PURE__ */ new Set([
+  "co.uk",
+  "org.uk",
+  "ac.uk",
+  "com.au",
+  "net.au",
+  "co.nz",
+  "co.jp",
+  "co.kr",
+  "or.kr",
+  "com.br",
+  "com.tr",
+  "com.cn",
+  "com.mx",
+  "co.in",
+  "co.za",
+  "com.sg",
+  "com.hk",
+  "com.tw",
+  "com.ar",
+  "com.ua",
+  "co.il"
+]);
+function sharedCookieDomain(hostname, override) {
+  const forced = override?.trim().replace(/^\./, "");
+  if (forced) return forced;
+  const host = hostname.split(":")[0].toLowerCase();
+  if (!host || /^\d+(\.\d+){3}$/.test(host) || host.includes(":")) return null;
+  const labels = host.split(".");
+  if (labels.length < 2) return null;
+  const keep = TWO_LABEL_SUFFIXES.has(labels.slice(-2).join(".")) ? 3 : 2;
+  return labels.slice(-keep).join(".");
+}
+function localeCookieHeader(locale, domain, secure) {
+  return `${LOCALE_COOKIE}=${encodeURIComponent(locale)}; Path=/; Max-Age=${LOCALE_COOKIE_MAX_AGE}; SameSite=Lax${domain ? `; Domain=${domain}` : ""}${secure ? "; Secure" : ""}`;
+}
+function expireHostOnlyLocaleCookie(secure) {
+  return `${LOCALE_COOKIE}=; Path=/; Max-Age=0; SameSite=Lax${secure ? "; Secure" : ""}`;
+}
+
 // src/i18n/client.ts
 function useTranslations(namespace) {
   return useNextIntlTranslations(namespace);
@@ -128,9 +171,10 @@ function useDefaultLocale() {
 function useChangeLocale() {
   const pathname = usePathname();
   return (locale) => {
-    const date = /* @__PURE__ */ new Date();
-    date.setFullYear(date.getFullYear() + 1);
-    document.cookie = `NEXT_LOCALE=${locale}; expires=${date.toUTCString()}; path=/`;
+    const secure = window.location.protocol === "https:";
+    const domain = sharedCookieDomain(window.location.hostname, process.env.NEXT_PUBLIC_COOKIE_DOMAIN);
+    document.cookie = localeCookieHeader(locale, domain, secure);
+    if (domain) document.cookie = expireHostOnlyLocaleCookie(secure);
     window.location.href = `/${locale}${pathname}`;
   };
 }

package/dist/i18n/client.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/i18n/client.ts","../../src/i18n/navigation.ts","../../src/i18n/routing.ts","../../src/i18n/provider.tsx"],"sourcesContent":["/**\n * Client-side i18n Hooks\n *\n * For use in Client Components ('use client')\n *\n * @example\n * ```tsx\n * 'use client';\n *\n * import { useTranslations, useLocale } from '@djangocfg/nextjs/i18n/client';\n *\n * export function MyComponent() {\n *   const t = useTranslations('HomePage');\n *   const locale = useLocale();\n *\n *   return <h1>{t('title')}</h1>;\n * }\n * ```\n */\n\n'use client';\n\nimport {\n    useFormatter, useLocale as useNextIntlLocale, useMessages, useNow, useTimeZone,\n    useTranslations as useNextIntlTranslations\n} from 'next-intl';\n\nimport { usePathname } from './navigation';\nimport { I18nProvider, NextIntlProvider, useDeclaredLocales } from './provider';\nimport { routing } from './routing';\n\n// Re-export providers\nexport { I18nProvider, NextIntlProvider };\n\nimport type { LocaleCode } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Core Client Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get translations in Client Components\n *\n * @example\n * ```tsx\n * const t = useTranslations('HomePage');\n * return <h1>{t('title')}</h1>;\n *\n * // With interpolation\n * return <p>{t('greeting', { name: 'John' })}</p>;\n * ```\n */\nexport function useTranslations<Namespace extends string = never>(\n  namespace?: Namespace\n) {\n  return useNextIntlTranslations(namespace);\n}\n\n/**\n * Get current locale in Client Components\n */\nexport function useLocale(): LocaleCode {\n  return useNextIntlLocale() as LocaleCode;\n}\n\n/**\n * Get all messages\n * Useful for passing to child providers\n */\nexport { useMessages };\n\n/**\n * Get current time\n */\nexport { useNow };\n\n/**\n * Get timezone\n */\nexport { useTimeZone };\n\n/**\n * Get formatter for dates, numbers, etc.\n */\nexport { useFormatter };\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Convenience Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Shorthand for useTranslations\n * Alias for compatibility with @djangocfg/i18n\n */\nexport const useT = useTranslations;\n\n/**\n * Get namespaced translations\n *\n * @example\n * ```tsx\n * const pt = useNamespacedTranslations('payments');\n * return <span>{pt('balance.available')}</span>;\n * ```\n */\nexport function useNamespacedTranslations(namespace: string) {\n  return useNextIntlTranslations(namespace);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Formatting Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Format a date according to locale\n *\n * @example\n * ```tsx\n * const formatDate = useDateFormatter();\n * return <span>{formatDate(new Date())}</span>;\n * ```\n */\nexport function useDateFormatter() {\n  const formatter = useFormatter();\n  return (date: Date | number, options?: Parameters<typeof formatter.dateTime>[1]) =>\n    formatter.dateTime(date, options);\n}\n\n/**\n * Format a number according to locale\n *\n * @example\n * ```tsx\n * const formatNumber = useNumberFormatter();\n * return <span>{formatNumber(1234.56)}</span>;\n * ```\n */\nexport function useNumberFormatter() {\n  const formatter = useFormatter();\n  return (number: number, options?: Parameters<typeof formatter.number>[1]) =>\n    formatter.number(number, options);\n}\n\n/**\n * Format relative time\n *\n * @example\n * ```tsx\n * const formatRelative = useRelativeTimeFormatter();\n * return <span>{formatRelative(new Date())}</span>;\n * ```\n */\nexport function useRelativeTimeFormatter() {\n  const formatter = useFormatter();\n  return (date: Date | number, options?: Parameters<typeof formatter.relativeTime>[1]) =>\n    formatter.relativeTime(date, options);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Locale Switching Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Locales the app declared on `I18nProvider`; the built-in routing list only\n * when it declared none.\n *\n * @example\n * ```tsx\n * const locales = useLocales();\n * // ['en', 'ru', 'ko']\n * ```\n */\nexport function useLocales(): LocaleCode[] {\n  const declared = useDeclaredLocales();\n  return declared ?? (routing.locales as LocaleCode[]);\n}\n\n/**\n * Get default locale from routing config\n */\nexport function useDefaultLocale(): LocaleCode {\n  return routing.defaultLocale as LocaleCode;\n}\n\n/**\n * Hook to change current locale\n *\n * @example\n * ```tsx\n * const changeLocale = useChangeLocale();\n *\n * <button onClick={() => changeLocale('ru')}>\n *   Switch to Russian\n * </button>\n * ```\n */\nexport function useChangeLocale() {\n  const pathname = usePathname();\n\n  return (locale: LocaleCode) => {\n    // Set NEXT_LOCALE cookie so middleware remembers the choice\n    const date = new Date();\n    date.setFullYear(date.getFullYear() + 1);\n    document.cookie = `NEXT_LOCALE=${locale}; expires=${date.toUTCString()}; path=/`;\n\n    // Hard navigation to force full page reload with new locale\n    // (ensures server components re-render with updated translations)\n    window.location.href = `/${locale}${pathname}`;\n  };\n}\n\n/**\n * Combined hook for locale switching\n * Returns current locale, available locales, and change function\n *\n * @example\n * ```tsx\n * const { locale, locales, changeLocale } = useLocaleSwitcher();\n *\n * <select value={locale} onChange={(e) => changeLocale(e.target.value)}>\n *   {locales.map(l => <option key={l} value={l}>{l}</option>)}\n * </select>\n * ```\n */\nexport function useLocaleSwitcher() {\n  const locale = useLocale();\n  const locales = useLocales();\n  const changeLocale = useChangeLocale();\n\n  return { locale, locales, changeLocale };\n}\n","/**\n * i18n Navigation Utilities\n *\n * Provides locale-aware navigation components and functions\n *\n * @example\n * ```ts\n * // In your app's i18n/navigation.ts\n * import { createNavigation } from '@djangocfg/nextjs/i18n';\n * import { routing } from './routing';\n *\n * export const { Link, redirect, usePathname, useRouter } = createNavigation(routing);\n * ```\n *\n * @example\n * ```tsx\n * // Using in components\n * import { Link, usePathname } from '@/i18n/navigation';\n *\n * function Nav() {\n *   const pathname = usePathname();\n *   return <Link href=\"/about\">About</Link>;\n * }\n * ```\n */\n\nimport { createNavigation as createNextIntlNavigation } from 'next-intl/navigation';\n\nimport { createRouting, routing } from './routing';\n\nimport type { I18nConfig } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Navigation Factory\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Create navigation utilities with custom routing\n *\n * Returns locale-aware versions of:\n * - Link: Locale-prefixed links\n * - redirect: Server-side redirect with locale\n * - usePathname: Current pathname without locale prefix\n * - useRouter: Router with locale-aware navigation\n * - getPathname: Get pathname for a route\n */\nexport function createNavigation(routingConfig?: ReturnType<typeof createRouting>) {\n  const config = routingConfig ?? routing;\n  return createNextIntlNavigation(config);\n}\n\n/**\n * Create navigation from config options\n */\nexport function createNavigationFromConfig(config: Partial<I18nConfig>) {\n  const routingConfig = createRouting(config);\n  return createNextIntlNavigation(routingConfig);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Default Navigation (using default routing)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Default navigation utilities\n * Use these directly or create custom ones with createNavigation()\n */\nexport const {\n  Link,\n  redirect,\n  usePathname,\n  useRouter,\n  getPathname,\n} = createNavigation();\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Props for locale-aware Link component\n */\nexport interface LinkProps {\n  /** Target href */\n  href: string;\n  /** Target locale (optional, defaults to current) */\n  locale?: string;\n  /** Children */\n  children?: React.ReactNode;\n  /** Additional props passed to Next.js Link */\n  [key: string]: unknown;\n}\n","/**\n * i18n Routing Configuration\n *\n * Creates routing configuration for next-intl\n * Used by proxy and navigation components\n */\n\nimport { defineRouting } from 'next-intl/routing';\n\nimport type { I18nConfig, LocaleCode } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Default Configuration\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport const DEFAULT_LOCALES: LocaleCode[] = ['en', 'ru', 'ko', 'ja', 'de', 'fr', 'zh', 'it', 'es', 'nl', 'ar', 'tr', 'pt-BR', 'pl', 'sv', 'no', 'da'];\nexport const DEFAULT_LOCALE: LocaleCode = 'en';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Routing Factory\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Create routing configuration for next-intl\n *\n * @example\n * ```ts\n * // i18n/routing.ts\n * import { createRouting } from '@djangocfg/nextjs/i18n';\n *\n * export const routing = createRouting({\n *   locales: ['en', 'ru', 'ko'],\n *   defaultLocale: 'en',\n * });\n * ```\n */\nexport function createRouting(config?: Partial<I18nConfig>) {\n  const locales = config?.locales ?? DEFAULT_LOCALES;\n  const defaultLocale = config?.defaultLocale ?? DEFAULT_LOCALE;\n  const localePrefix = config?.localePrefix ?? 'as-needed';\n\n  return defineRouting({\n    locales,\n    defaultLocale,\n    localePrefix,\n  });\n}\n\n/**\n * Default routing configuration\n * Can be overridden by app-specific configuration\n */\nexport const routing = createRouting();\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Locale Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Check if a locale is supported\n */\nexport function isValidLocale(\n  locale: string,\n  supportedLocales: readonly string[] = DEFAULT_LOCALES\n): locale is LocaleCode {\n  return supportedLocales.includes(locale as LocaleCode);\n}\n\n/**\n * Get locale from params (handles async params in Next.js 15+)\n */\nexport async function getLocaleFromParams(\n  params: Promise<{ locale: string }> | { locale: string }\n): Promise<LocaleCode> {\n  const resolved = await params;\n  return resolved.locale as LocaleCode;\n}\n\n/**\n * Generate static params for all locales\n * Use in generateStaticParams for locale pages\n */\nexport function generateLocaleParams(locales: readonly string[] = DEFAULT_LOCALES) {\n  return locales.map((locale) => ({ locale }));\n}\n","/**\n * i18n Provider for Next.js App Router\n *\n * Bridges next-intl with @djangocfg/i18n\n * Provides translations to both Server and Client components\n *\n * @example\n * ```tsx\n * // app/[locale]/layout.tsx\n * import { I18nProvider } from '@djangocfg/nextjs/i18n';\n * import { getMessages, getLocale } from '@djangocfg/nextjs/i18n/server';\n *\n * export default async function LocaleLayout({ children, params }) {\n *   const locale = await getLocale(params);\n *   const messages = await getMessages();\n *\n *   return (\n *     <I18nProvider locale={locale} messages={messages}>\n *       {children}\n *     </I18nProvider>\n *   );\n * }\n * ```\n */\n\n'use client';\n\nimport { createContext, useContext } from 'react';\nimport { NextIntlClientProvider } from 'next-intl';\nimport { I18nProvider as DjangoCfgI18nProvider } from '@djangocfg/i18n';\nimport type { I18nProviderProps, LocaleCode } from './types';\n\nconst DeclaredLocalesContext = createContext<LocaleCode[] | null>(null);\n\n/** Locales the app passed to its provider, or null when it passed none. */\nexport const useDeclaredLocales = (): LocaleCode[] | null => useContext(DeclaredLocalesContext);\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Provider Component\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Unified i18n Provider\n *\n * Wraps both NextIntlClientProvider and @djangocfg/i18n's I18nProvider\n * This ensures both next-intl hooks and @djangocfg/i18n hooks work correctly\n */\nexport function I18nProvider({\n  locale,\n  messages,\n  locales,\n  timeZone = 'UTC',\n  now,\n  children,\n}: I18nProviderProps) {\n  return (\n    <NextIntlClientProvider\n      locale={locale}\n      messages={messages}\n      timeZone={timeZone}\n      now={now}\n    >\n      <DjangoCfgI18nProvider\n        locale={locale as LocaleCode}\n        translations={messages}\n      >\n        <DeclaredLocalesContext.Provider value={locales ?? null}>\n          {children}\n        </DeclaredLocalesContext.Provider>\n      </DjangoCfgI18nProvider>\n    </NextIntlClientProvider>\n  );\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Lightweight Provider (next-intl only)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Next-intl only provider (without @djangocfg/i18n context)\n * Use if you only need next-intl hooks\n */\nexport function NextIntlProvider({\n  locale,\n  messages,\n  locales,\n  timeZone = 'UTC',\n  now,\n  children,\n}: I18nProviderProps) {\n  return (\n    <NextIntlClientProvider\n      locale={locale}\n      messages={messages}\n      timeZone={timeZone}\n      now={now}\n    >\n      <DeclaredLocalesContext.Provider value={locales ?? null}>\n        {children}\n      </DeclaredLocalesContext.Provider>\n    </NextIntlClientProvider>\n  );\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/i18n/client.ts","../../src/i18n/navigation.ts","../../src/i18n/routing.ts","../../src/i18n/provider.tsx","../../src/i18n/shared-locale.ts"],"sourcesContent":["/**\n * Client-side i18n Hooks\n *\n * For use in Client Components ('use client')\n *\n * @example\n * ```tsx\n * 'use client';\n *\n * import { useTranslations, useLocale } from '@djangocfg/nextjs/i18n/client';\n *\n * export function MyComponent() {\n *   const t = useTranslations('HomePage');\n *   const locale = useLocale();\n *\n *   return <h1>{t('title')}</h1>;\n * }\n * ```\n */\n\n'use client';\n\nimport {\n    useFormatter, useLocale as useNextIntlLocale, useMessages, useNow, useTimeZone,\n    useTranslations as useNextIntlTranslations\n} from 'next-intl';\n\nimport { usePathname } from './navigation';\nimport { I18nProvider, NextIntlProvider, useDeclaredLocales } from './provider';\nimport { routing } from './routing';\nimport { expireHostOnlyLocaleCookie, localeCookieHeader, sharedCookieDomain } from './shared-locale';\n\n// Re-export providers\nexport { I18nProvider, NextIntlProvider };\n\nimport type { LocaleCode } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Core Client Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get translations in Client Components\n *\n * @example\n * ```tsx\n * const t = useTranslations('HomePage');\n * return <h1>{t('title')}</h1>;\n *\n * // With interpolation\n * return <p>{t('greeting', { name: 'John' })}</p>;\n * ```\n */\nexport function useTranslations<Namespace extends string = never>(\n  namespace?: Namespace\n) {\n  return useNextIntlTranslations(namespace);\n}\n\n/**\n * Get current locale in Client Components\n */\nexport function useLocale(): LocaleCode {\n  return useNextIntlLocale() as LocaleCode;\n}\n\n/**\n * Get all messages\n * Useful for passing to child providers\n */\nexport { useMessages };\n\n/**\n * Get current time\n */\nexport { useNow };\n\n/**\n * Get timezone\n */\nexport { useTimeZone };\n\n/**\n * Get formatter for dates, numbers, etc.\n */\nexport { useFormatter };\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Convenience Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Shorthand for useTranslations\n * Alias for compatibility with @djangocfg/i18n\n */\nexport const useT = useTranslations;\n\n/**\n * Get namespaced translations\n *\n * @example\n * ```tsx\n * const pt = useNamespacedTranslations('payments');\n * return <span>{pt('balance.available')}</span>;\n * ```\n */\nexport function useNamespacedTranslations(namespace: string) {\n  return useNextIntlTranslations(namespace);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Formatting Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Format a date according to locale\n *\n * @example\n * ```tsx\n * const formatDate = useDateFormatter();\n * return <span>{formatDate(new Date())}</span>;\n * ```\n */\nexport function useDateFormatter() {\n  const formatter = useFormatter();\n  return (date: Date | number, options?: Parameters<typeof formatter.dateTime>[1]) =>\n    formatter.dateTime(date, options);\n}\n\n/**\n * Format a number according to locale\n *\n * @example\n * ```tsx\n * const formatNumber = useNumberFormatter();\n * return <span>{formatNumber(1234.56)}</span>;\n * ```\n */\nexport function useNumberFormatter() {\n  const formatter = useFormatter();\n  return (number: number, options?: Parameters<typeof formatter.number>[1]) =>\n    formatter.number(number, options);\n}\n\n/**\n * Format relative time\n *\n * @example\n * ```tsx\n * const formatRelative = useRelativeTimeFormatter();\n * return <span>{formatRelative(new Date())}</span>;\n * ```\n */\nexport function useRelativeTimeFormatter() {\n  const formatter = useFormatter();\n  return (date: Date | number, options?: Parameters<typeof formatter.relativeTime>[1]) =>\n    formatter.relativeTime(date, options);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Locale Switching Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Locales the app declared on `I18nProvider`; the built-in routing list only\n * when it declared none.\n *\n * @example\n * ```tsx\n * const locales = useLocales();\n * // ['en', 'ru', 'ko']\n * ```\n */\nexport function useLocales(): LocaleCode[] {\n  const declared = useDeclaredLocales();\n  return declared ?? (routing.locales as LocaleCode[]);\n}\n\n/**\n * Get default locale from routing config\n */\nexport function useDefaultLocale(): LocaleCode {\n  return routing.defaultLocale as LocaleCode;\n}\n\n/**\n * Hook to change current locale\n *\n * @example\n * ```tsx\n * const changeLocale = useChangeLocale();\n *\n * <button onClick={() => changeLocale('ru')}>\n *   Switch to Russian\n * </button>\n * ```\n */\nexport function useChangeLocale() {\n  const pathname = usePathname();\n\n  return (locale: LocaleCode) => {\n    // Set NEXT_LOCALE so middleware remembers the choice, on the registrable domain so every host of the family\n    // reads it (see ./shared-locale); the host-only twin is expired so it cannot shadow the shared one.\n    const secure = window.location.protocol === 'https:';\n    const domain = sharedCookieDomain(window.location.hostname, process.env.NEXT_PUBLIC_COOKIE_DOMAIN);\n    document.cookie = localeCookieHeader(locale, domain, secure);\n    if (domain) document.cookie = expireHostOnlyLocaleCookie(secure);\n\n    // Hard navigation to force full page reload with new locale\n    // (ensures server components re-render with updated translations)\n    window.location.href = `/${locale}${pathname}`;\n  };\n}\n\n/**\n * Combined hook for locale switching\n * Returns current locale, available locales, and change function\n *\n * @example\n * ```tsx\n * const { locale, locales, changeLocale } = useLocaleSwitcher();\n *\n * <select value={locale} onChange={(e) => changeLocale(e.target.value)}>\n *   {locales.map(l => <option key={l} value={l}>{l}</option>)}\n * </select>\n * ```\n */\nexport function useLocaleSwitcher() {\n  const locale = useLocale();\n  const locales = useLocales();\n  const changeLocale = useChangeLocale();\n\n  return { locale, locales, changeLocale };\n}\n","/**\n * i18n Navigation Utilities\n *\n * Provides locale-aware navigation components and functions\n *\n * @example\n * ```ts\n * // In your app's i18n/navigation.ts\n * import { createNavigation } from '@djangocfg/nextjs/i18n';\n * import { routing } from './routing';\n *\n * export const { Link, redirect, usePathname, useRouter } = createNavigation(routing);\n * ```\n *\n * @example\n * ```tsx\n * // Using in components\n * import { Link, usePathname } from '@/i18n/navigation';\n *\n * function Nav() {\n *   const pathname = usePathname();\n *   return <Link href=\"/about\">About</Link>;\n * }\n * ```\n */\n\nimport { createNavigation as createNextIntlNavigation } from 'next-intl/navigation';\n\nimport { createRouting, routing } from './routing';\n\nimport type { I18nConfig } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Navigation Factory\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Create navigation utilities with custom routing\n *\n * Returns locale-aware versions of:\n * - Link: Locale-prefixed links\n * - redirect: Server-side redirect with locale\n * - usePathname: Current pathname without locale prefix\n * - useRouter: Router with locale-aware navigation\n * - getPathname: Get pathname for a route\n */\nexport function createNavigation(routingConfig?: ReturnType<typeof createRouting>) {\n  const config = routingConfig ?? routing;\n  return createNextIntlNavigation(config);\n}\n\n/**\n * Create navigation from config options\n */\nexport function createNavigationFromConfig(config: Partial<I18nConfig>) {\n  const routingConfig = createRouting(config);\n  return createNextIntlNavigation(routingConfig);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Default Navigation (using default routing)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Default navigation utilities\n * Use these directly or create custom ones with createNavigation()\n */\nexport const {\n  Link,\n  redirect,\n  usePathname,\n  useRouter,\n  getPathname,\n} = createNavigation();\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Props for locale-aware Link component\n */\nexport interface LinkProps {\n  /** Target href */\n  href: string;\n  /** Target locale (optional, defaults to current) */\n  locale?: string;\n  /** Children */\n  children?: React.ReactNode;\n  /** Additional props passed to Next.js Link */\n  [key: string]: unknown;\n}\n","/**\n * i18n Routing Configuration\n *\n * Creates routing configuration for next-intl\n * Used by proxy and navigation components\n */\n\nimport { defineRouting } from 'next-intl/routing';\n\nimport type { I18nConfig, LocaleCode } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Default Configuration\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport const DEFAULT_LOCALES: LocaleCode[] = ['en', 'ru', 'ko', 'ja', 'de', 'fr', 'zh', 'it', 'es', 'nl', 'ar', 'tr', 'pt-BR', 'pl', 'sv', 'no', 'da'];\nexport const DEFAULT_LOCALE: LocaleCode = 'en';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Routing Factory\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Create routing configuration for next-intl\n *\n * @example\n * ```ts\n * // i18n/routing.ts\n * import { createRouting } from '@djangocfg/nextjs/i18n';\n *\n * export const routing = createRouting({\n *   locales: ['en', 'ru', 'ko'],\n *   defaultLocale: 'en',\n * });\n * ```\n */\nexport function createRouting(config?: Partial<I18nConfig>) {\n  const locales = config?.locales ?? DEFAULT_LOCALES;\n  const defaultLocale = config?.defaultLocale ?? DEFAULT_LOCALE;\n  const localePrefix = config?.localePrefix ?? 'as-needed';\n\n  return defineRouting({\n    locales,\n    defaultLocale,\n    localePrefix,\n  });\n}\n\n/**\n * Default routing configuration\n * Can be overridden by app-specific configuration\n */\nexport const routing = createRouting();\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Locale Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Check if a locale is supported\n */\nexport function isValidLocale(\n  locale: string,\n  supportedLocales: readonly string[] = DEFAULT_LOCALES\n): locale is LocaleCode {\n  return supportedLocales.includes(locale as LocaleCode);\n}\n\n/**\n * Get locale from params (handles async params in Next.js 15+)\n */\nexport async function getLocaleFromParams(\n  params: Promise<{ locale: string }> | { locale: string }\n): Promise<LocaleCode> {\n  const resolved = await params;\n  return resolved.locale as LocaleCode;\n}\n\n/**\n * Generate static params for all locales\n * Use in generateStaticParams for locale pages\n */\nexport function generateLocaleParams(locales: readonly string[] = DEFAULT_LOCALES) {\n  return locales.map((locale) => ({ locale }));\n}\n","/**\n * i18n Provider for Next.js App Router\n *\n * Bridges next-intl with @djangocfg/i18n\n * Provides translations to both Server and Client components\n *\n * @example\n * ```tsx\n * // app/[locale]/layout.tsx\n * import { I18nProvider } from '@djangocfg/nextjs/i18n';\n * import { getMessages, getLocale } from '@djangocfg/nextjs/i18n/server';\n *\n * export default async function LocaleLayout({ children, params }) {\n *   const locale = await getLocale(params);\n *   const messages = await getMessages();\n *\n *   return (\n *     <I18nProvider locale={locale} messages={messages}>\n *       {children}\n *     </I18nProvider>\n *   );\n * }\n * ```\n */\n\n'use client';\n\nimport { createContext, useContext } from 'react';\nimport { NextIntlClientProvider } from 'next-intl';\nimport { I18nProvider as DjangoCfgI18nProvider } from '@djangocfg/i18n';\nimport type { I18nProviderProps, LocaleCode } from './types';\n\nconst DeclaredLocalesContext = createContext<LocaleCode[] | null>(null);\n\n/** Locales the app passed to its provider, or null when it passed none. */\nexport const useDeclaredLocales = (): LocaleCode[] | null => useContext(DeclaredLocalesContext);\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Provider Component\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Unified i18n Provider\n *\n * Wraps both NextIntlClientProvider and @djangocfg/i18n's I18nProvider\n * This ensures both next-intl hooks and @djangocfg/i18n hooks work correctly\n */\nexport function I18nProvider({\n  locale,\n  messages,\n  locales,\n  timeZone = 'UTC',\n  now,\n  children,\n}: I18nProviderProps) {\n  return (\n    <NextIntlClientProvider\n      locale={locale}\n      messages={messages}\n      timeZone={timeZone}\n      now={now}\n    >\n      <DjangoCfgI18nProvider\n        locale={locale as LocaleCode}\n        translations={messages}\n      >\n        <DeclaredLocalesContext.Provider value={locales ?? null}>\n          {children}\n        </DeclaredLocalesContext.Provider>\n      </DjangoCfgI18nProvider>\n    </NextIntlClientProvider>\n  );\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Lightweight Provider (next-intl only)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Next-intl only provider (without @djangocfg/i18n context)\n * Use if you only need next-intl hooks\n */\nexport function NextIntlProvider({\n  locale,\n  messages,\n  locales,\n  timeZone = 'UTC',\n  now,\n  children,\n}: I18nProviderProps) {\n  return (\n    <NextIntlClientProvider\n      locale={locale}\n      messages={messages}\n      timeZone={timeZone}\n      now={now}\n    >\n      <DeclaredLocalesContext.Provider value={locales ?? null}>\n        {children}\n      </DeclaredLocalesContext.Provider>\n    </NextIntlClientProvider>\n  );\n}\n","/**\n * One locale across every host of one product family.\n *\n * `NEXT_LOCALE` is written host-only by default, so a reader who picked Russian on `hub.example.com` meets English on\n * `team.example.com`. The session tokens already live on the registrable domain (`@djangocfg/api` `createStorage`,\n * `cookieDomain: 'auto'`); the locale follows the same rule: the cookie gets `Domain=` the registrable domain, and the\n * host-only twin is expired so it cannot shadow the shared one.\n *\n * Pure and framework-free, so the proxy (server) and `useChangeLocale` (browser) agree on the domain.\n */\n\nexport const LOCALE_COOKIE = 'NEXT_LOCALE';\nexport const LOCALE_COOKIE_MAX_AGE = 60 * 60 * 24 * 365;\n\n// Second-level public suffixes whose registrable domain has three labels. Not the whole Public Suffix List: the common\n// ones; anything else sets NEXT_PUBLIC_COOKIE_DOMAIN.\nconst TWO_LABEL_SUFFIXES = new Set([\n  'co.uk', 'org.uk', 'ac.uk', 'com.au', 'net.au', 'co.nz', 'co.jp', 'co.kr', 'or.kr', 'com.br', 'com.tr', 'com.cn', 'com.mx',\n  'co.in', 'co.za', 'com.sg', 'com.hk', 'com.tw', 'com.ar', 'com.ua', 'co.il',\n]);\n\n/**\n * The domain a cookie must carry to be sent to every subdomain, or `null` for a host that cannot share (an IP, a bare\n * label such as `localhost`, or an apex with no subdomain in use: a host-only cookie already covers it).\n * `override` (`NEXT_PUBLIC_COOKIE_DOMAIN`) wins when set.\n */\nexport function sharedCookieDomain(hostname: string, override?: string | null): string | null {\n  const forced = override?.trim().replace(/^\\./, '');\n  if (forced) return forced;\n  const host = hostname.split(':')[0]!.toLowerCase();\n  if (!host || /^\\d+(\\.\\d+){3}$/.test(host) || host.includes(':')) return null;\n  const labels = host.split('.');\n  if (labels.length < 2) return null;\n  const keep = TWO_LABEL_SUFFIXES.has(labels.slice(-2).join('.')) ? 3 : 2;\n  return labels.slice(-keep).join('.');\n}\n\n/** The `Set-Cookie` value that writes the shared locale cookie. */\nexport function localeCookieHeader(locale: string, domain: string | null, secure: boolean): string {\n  return `${LOCALE_COOKIE}=${encodeURIComponent(locale)}; Path=/; Max-Age=${LOCALE_COOKIE_MAX_AGE}; SameSite=Lax${domain ? `; Domain=${domain}` : ''}${secure ? '; Secure' : ''}`;\n}\n\n/** Expires the host-only twin of the cookie (a cookie is identified by name and Domain). */\nexport function expireHostOnlyLocaleCookie(secure: boolean): string {\n  return `${LOCALE_COOKIE}=; Path=/; Max-Age=0; SameSite=Lax${secure ? '; Secure' : ''}`;\n}\n"],"mappings":"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","names":[]}

package/dist/i18n/components.mjs

@@ -54,6 +54,49 @@ import { jsx } from "react/jsx-runtime";
 var DeclaredLocalesContext = createContext(null);
 var useDeclaredLocales = () => useContext(DeclaredLocalesContext);
 
+// src/i18n/shared-locale.ts
+var LOCALE_COOKIE = "NEXT_LOCALE";
+var LOCALE_COOKIE_MAX_AGE = 60 * 60 * 24 * 365;
+var TWO_LABEL_SUFFIXES = /* @__PURE__ */ new Set([
+  "co.uk",
+  "org.uk",
+  "ac.uk",
+  "com.au",
+  "net.au",
+  "co.nz",
+  "co.jp",
+  "co.kr",
+  "or.kr",
+  "com.br",
+  "com.tr",
+  "com.cn",
+  "com.mx",
+  "co.in",
+  "co.za",
+  "com.sg",
+  "com.hk",
+  "com.tw",
+  "com.ar",
+  "com.ua",
+  "co.il"
+]);
+function sharedCookieDomain(hostname, override) {
+  const forced = override?.trim().replace(/^\./, "");
+  if (forced) return forced;
+  const host = hostname.split(":")[0].toLowerCase();
+  if (!host || /^\d+(\.\d+){3}$/.test(host) || host.includes(":")) return null;
+  const labels = host.split(".");
+  if (labels.length < 2) return null;
+  const keep = TWO_LABEL_SUFFIXES.has(labels.slice(-2).join(".")) ? 3 : 2;
+  return labels.slice(-keep).join(".");
+}
+function localeCookieHeader(locale, domain, secure) {
+  return `${LOCALE_COOKIE}=${encodeURIComponent(locale)}; Path=/; Max-Age=${LOCALE_COOKIE_MAX_AGE}; SameSite=Lax${domain ? `; Domain=${domain}` : ""}${secure ? "; Secure" : ""}`;
+}
+function expireHostOnlyLocaleCookie(secure) {
+  return `${LOCALE_COOKIE}=; Path=/; Max-Age=0; SameSite=Lax${secure ? "; Secure" : ""}`;
+}
+
 // src/i18n/client.ts
 function useLocale() {
   return useNextIntlLocale();
@@ -65,9 +108,10 @@ function useLocales() {
 function useChangeLocale() {
   const pathname = usePathname();
   return (locale) => {
-    const date = /* @__PURE__ */ new Date();
-    date.setFullYear(date.getFullYear() + 1);
-    document.cookie = `NEXT_LOCALE=${locale}; expires=${date.toUTCString()}; path=/`;
+    const secure = window.location.protocol === "https:";
+    const domain = sharedCookieDomain(window.location.hostname, process.env.NEXT_PUBLIC_COOKIE_DOMAIN);
+    document.cookie = localeCookieHeader(locale, domain, secure);
+    if (domain) document.cookie = expireHostOnlyLocaleCookie(secure);
     window.location.href = `/${locale}${pathname}`;
   };
 }

package/dist/i18n/components.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/i18n/components/LocaleSwitcher.tsx","../../src/i18n/client.ts","../../src/i18n/navigation.ts","../../src/i18n/routing.ts","../../src/i18n/provider.tsx"],"sourcesContent":["/**\n * LocaleSwitcher Component (Smart)\n *\n * Wrapper around `@djangocfg/layouts` LocaleSwitcher with next-intl plumbing.\n * Mounts its own `LayoutI18nProvider` so the switcher works standalone — no\n * need to wrap the page in `<AppLayout i18n={...}>` just to render it.\n *\n * @example\n * ```tsx\n * import { LocaleSwitcher } from '@djangocfg/nextjs/i18n/components';\n *\n * <LocaleSwitcher />\n * <LocaleSwitcher locales={['en', 'ru']} />\n * <LocaleSwitcher labels={{ en: 'English', ru: 'Русский' }} />\n * ```\n */\n\n'use client';\n\nimport {\n  LayoutI18nProvider,\n  LocaleSwitcher as BaseLocaleSwitcher,\n  type LocaleSwitcherProps as BaseLocaleSwitcherProps,\n} from '@djangocfg/layouts';\n\nimport { useLocaleSwitcher } from '../client';\nimport type { LocaleCode } from '../types';\n\nexport interface LocaleSwitcherProps extends BaseLocaleSwitcherProps {\n  /** Available locales (defaults to all from routing config) */\n  locales?: LocaleCode[];\n}\n\nexport function LocaleSwitcher({ locales: customLocales, ...props }: LocaleSwitcherProps) {\n  const { locale, locales: routingLocales, changeLocale } = useLocaleSwitcher();\n\n  const availableLocales = customLocales || routingLocales;\n\n  return (\n    <LayoutI18nProvider\n      value={{\n        locale,\n        locales: availableLocales,\n        onLocaleChange: changeLocale,\n      }}\n    >\n      <BaseLocaleSwitcher {...props} />\n    </LayoutI18nProvider>\n  );\n}\n","/**\n * Client-side i18n Hooks\n *\n * For use in Client Components ('use client')\n *\n * @example\n * ```tsx\n * 'use client';\n *\n * import { useTranslations, useLocale } from '@djangocfg/nextjs/i18n/client';\n *\n * export function MyComponent() {\n *   const t = useTranslations('HomePage');\n *   const locale = useLocale();\n *\n *   return <h1>{t('title')}</h1>;\n * }\n * ```\n */\n\n'use client';\n\nimport {\n    useFormatter, useLocale as useNextIntlLocale, useMessages, useNow, useTimeZone,\n    useTranslations as useNextIntlTranslations\n} from 'next-intl';\n\nimport { usePathname } from './navigation';\nimport { I18nProvider, NextIntlProvider, useDeclaredLocales } from './provider';\nimport { routing } from './routing';\n\n// Re-export providers\nexport { I18nProvider, NextIntlProvider };\n\nimport type { LocaleCode } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Core Client Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get translations in Client Components\n *\n * @example\n * ```tsx\n * const t = useTranslations('HomePage');\n * return <h1>{t('title')}</h1>;\n *\n * // With interpolation\n * return <p>{t('greeting', { name: 'John' })}</p>;\n * ```\n */\nexport function useTranslations<Namespace extends string = never>(\n  namespace?: Namespace\n) {\n  return useNextIntlTranslations(namespace);\n}\n\n/**\n * Get current locale in Client Components\n */\nexport function useLocale(): LocaleCode {\n  return useNextIntlLocale() as LocaleCode;\n}\n\n/**\n * Get all messages\n * Useful for passing to child providers\n */\nexport { useMessages };\n\n/**\n * Get current time\n */\nexport { useNow };\n\n/**\n * Get timezone\n */\nexport { useTimeZone };\n\n/**\n * Get formatter for dates, numbers, etc.\n */\nexport { useFormatter };\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Convenience Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Shorthand for useTranslations\n * Alias for compatibility with @djangocfg/i18n\n */\nexport const useT = useTranslations;\n\n/**\n * Get namespaced translations\n *\n * @example\n * ```tsx\n * const pt = useNamespacedTranslations('payments');\n * return <span>{pt('balance.available')}</span>;\n * ```\n */\nexport function useNamespacedTranslations(namespace: string) {\n  return useNextIntlTranslations(namespace);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Formatting Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Format a date according to locale\n *\n * @example\n * ```tsx\n * const formatDate = useDateFormatter();\n * return <span>{formatDate(new Date())}</span>;\n * ```\n */\nexport function useDateFormatter() {\n  const formatter = useFormatter();\n  return (date: Date | number, options?: Parameters<typeof formatter.dateTime>[1]) =>\n    formatter.dateTime(date, options);\n}\n\n/**\n * Format a number according to locale\n *\n * @example\n * ```tsx\n * const formatNumber = useNumberFormatter();\n * return <span>{formatNumber(1234.56)}</span>;\n * ```\n */\nexport function useNumberFormatter() {\n  const formatter = useFormatter();\n  return (number: number, options?: Parameters<typeof formatter.number>[1]) =>\n    formatter.number(number, options);\n}\n\n/**\n * Format relative time\n *\n * @example\n * ```tsx\n * const formatRelative = useRelativeTimeFormatter();\n * return <span>{formatRelative(new Date())}</span>;\n * ```\n */\nexport function useRelativeTimeFormatter() {\n  const formatter = useFormatter();\n  return (date: Date | number, options?: Parameters<typeof formatter.relativeTime>[1]) =>\n    formatter.relativeTime(date, options);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Locale Switching Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Locales the app declared on `I18nProvider`; the built-in routing list only\n * when it declared none.\n *\n * @example\n * ```tsx\n * const locales = useLocales();\n * // ['en', 'ru', 'ko']\n * ```\n */\nexport function useLocales(): LocaleCode[] {\n  const declared = useDeclaredLocales();\n  return declared ?? (routing.locales as LocaleCode[]);\n}\n\n/**\n * Get default locale from routing config\n */\nexport function useDefaultLocale(): LocaleCode {\n  return routing.defaultLocale as LocaleCode;\n}\n\n/**\n * Hook to change current locale\n *\n * @example\n * ```tsx\n * const changeLocale = useChangeLocale();\n *\n * <button onClick={() => changeLocale('ru')}>\n *   Switch to Russian\n * </button>\n * ```\n */\nexport function useChangeLocale() {\n  const pathname = usePathname();\n\n  return (locale: LocaleCode) => {\n    // Set NEXT_LOCALE cookie so middleware remembers the choice\n    const date = new Date();\n    date.setFullYear(date.getFullYear() + 1);\n    document.cookie = `NEXT_LOCALE=${locale}; expires=${date.toUTCString()}; path=/`;\n\n    // Hard navigation to force full page reload with new locale\n    // (ensures server components re-render with updated translations)\n    window.location.href = `/${locale}${pathname}`;\n  };\n}\n\n/**\n * Combined hook for locale switching\n * Returns current locale, available locales, and change function\n *\n * @example\n * ```tsx\n * const { locale, locales, changeLocale } = useLocaleSwitcher();\n *\n * <select value={locale} onChange={(e) => changeLocale(e.target.value)}>\n *   {locales.map(l => <option key={l} value={l}>{l}</option>)}\n * </select>\n * ```\n */\nexport function useLocaleSwitcher() {\n  const locale = useLocale();\n  const locales = useLocales();\n  const changeLocale = useChangeLocale();\n\n  return { locale, locales, changeLocale };\n}\n","/**\n * i18n Navigation Utilities\n *\n * Provides locale-aware navigation components and functions\n *\n * @example\n * ```ts\n * // In your app's i18n/navigation.ts\n * import { createNavigation } from '@djangocfg/nextjs/i18n';\n * import { routing } from './routing';\n *\n * export const { Link, redirect, usePathname, useRouter } = createNavigation(routing);\n * ```\n *\n * @example\n * ```tsx\n * // Using in components\n * import { Link, usePathname } from '@/i18n/navigation';\n *\n * function Nav() {\n *   const pathname = usePathname();\n *   return <Link href=\"/about\">About</Link>;\n * }\n * ```\n */\n\nimport { createNavigation as createNextIntlNavigation } from 'next-intl/navigation';\n\nimport { createRouting, routing } from './routing';\n\nimport type { I18nConfig } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Navigation Factory\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Create navigation utilities with custom routing\n *\n * Returns locale-aware versions of:\n * - Link: Locale-prefixed links\n * - redirect: Server-side redirect with locale\n * - usePathname: Current pathname without locale prefix\n * - useRouter: Router with locale-aware navigation\n * - getPathname: Get pathname for a route\n */\nexport function createNavigation(routingConfig?: ReturnType<typeof createRouting>) {\n  const config = routingConfig ?? routing;\n  return createNextIntlNavigation(config);\n}\n\n/**\n * Create navigation from config options\n */\nexport function createNavigationFromConfig(config: Partial<I18nConfig>) {\n  const routingConfig = createRouting(config);\n  return createNextIntlNavigation(routingConfig);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Default Navigation (using default routing)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Default navigation utilities\n * Use these directly or create custom ones with createNavigation()\n */\nexport const {\n  Link,\n  redirect,\n  usePathname,\n  useRouter,\n  getPathname,\n} = createNavigation();\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Props for locale-aware Link component\n */\nexport interface LinkProps {\n  /** Target href */\n  href: string;\n  /** Target locale (optional, defaults to current) */\n  locale?: string;\n  /** Children */\n  children?: React.ReactNode;\n  /** Additional props passed to Next.js Link */\n  [key: string]: unknown;\n}\n","/**\n * i18n Routing Configuration\n *\n * Creates routing configuration for next-intl\n * Used by proxy and navigation components\n */\n\nimport { defineRouting } from 'next-intl/routing';\n\nimport type { I18nConfig, LocaleCode } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Default Configuration\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport const DEFAULT_LOCALES: LocaleCode[] = ['en', 'ru', 'ko', 'ja', 'de', 'fr', 'zh', 'it', 'es', 'nl', 'ar', 'tr', 'pt-BR', 'pl', 'sv', 'no', 'da'];\nexport const DEFAULT_LOCALE: LocaleCode = 'en';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Routing Factory\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Create routing configuration for next-intl\n *\n * @example\n * ```ts\n * // i18n/routing.ts\n * import { createRouting } from '@djangocfg/nextjs/i18n';\n *\n * export const routing = createRouting({\n *   locales: ['en', 'ru', 'ko'],\n *   defaultLocale: 'en',\n * });\n * ```\n */\nexport function createRouting(config?: Partial<I18nConfig>) {\n  const locales = config?.locales ?? DEFAULT_LOCALES;\n  const defaultLocale = config?.defaultLocale ?? DEFAULT_LOCALE;\n  const localePrefix = config?.localePrefix ?? 'as-needed';\n\n  return defineRouting({\n    locales,\n    defaultLocale,\n    localePrefix,\n  });\n}\n\n/**\n * Default routing configuration\n * Can be overridden by app-specific configuration\n */\nexport const routing = createRouting();\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Locale Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Check if a locale is supported\n */\nexport function isValidLocale(\n  locale: string,\n  supportedLocales: readonly string[] = DEFAULT_LOCALES\n): locale is LocaleCode {\n  return supportedLocales.includes(locale as LocaleCode);\n}\n\n/**\n * Get locale from params (handles async params in Next.js 15+)\n */\nexport async function getLocaleFromParams(\n  params: Promise<{ locale: string }> | { locale: string }\n): Promise<LocaleCode> {\n  const resolved = await params;\n  return resolved.locale as LocaleCode;\n}\n\n/**\n * Generate static params for all locales\n * Use in generateStaticParams for locale pages\n */\nexport function generateLocaleParams(locales: readonly string[] = DEFAULT_LOCALES) {\n  return locales.map((locale) => ({ locale }));\n}\n","/**\n * i18n Provider for Next.js App Router\n *\n * Bridges next-intl with @djangocfg/i18n\n * Provides translations to both Server and Client components\n *\n * @example\n * ```tsx\n * // app/[locale]/layout.tsx\n * import { I18nProvider } from '@djangocfg/nextjs/i18n';\n * import { getMessages, getLocale } from '@djangocfg/nextjs/i18n/server';\n *\n * export default async function LocaleLayout({ children, params }) {\n *   const locale = await getLocale(params);\n *   const messages = await getMessages();\n *\n *   return (\n *     <I18nProvider locale={locale} messages={messages}>\n *       {children}\n *     </I18nProvider>\n *   );\n * }\n * ```\n */\n\n'use client';\n\nimport { createContext, useContext } from 'react';\nimport { NextIntlClientProvider } from 'next-intl';\nimport { I18nProvider as DjangoCfgI18nProvider } from '@djangocfg/i18n';\nimport type { I18nProviderProps, LocaleCode } from './types';\n\nconst DeclaredLocalesContext = createContext<LocaleCode[] | null>(null);\n\n/** Locales the app passed to its provider, or null when it passed none. */\nexport const useDeclaredLocales = (): LocaleCode[] | null => useContext(DeclaredLocalesContext);\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Provider Component\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Unified i18n Provider\n *\n * Wraps both NextIntlClientProvider and @djangocfg/i18n's I18nProvider\n * This ensures both next-intl hooks and @djangocfg/i18n hooks work correctly\n */\nexport function I18nProvider({\n  locale,\n  messages,\n  locales,\n  timeZone = 'UTC',\n  now,\n  children,\n}: I18nProviderProps) {\n  return (\n    <NextIntlClientProvider\n      locale={locale}\n      messages={messages}\n      timeZone={timeZone}\n      now={now}\n    >\n      <DjangoCfgI18nProvider\n        locale={locale as LocaleCode}\n        translations={messages}\n      >\n        <DeclaredLocalesContext.Provider value={locales ?? null}>\n          {children}\n        </DeclaredLocalesContext.Provider>\n      </DjangoCfgI18nProvider>\n    </NextIntlClientProvider>\n  );\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Lightweight Provider (next-intl only)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Next-intl only provider (without @djangocfg/i18n context)\n * Use if you only need next-intl hooks\n */\nexport function NextIntlProvider({\n  locale,\n  messages,\n  locales,\n  timeZone = 'UTC',\n  now,\n  children,\n}: I18nProviderProps) {\n  return (\n    <NextIntlClientProvider\n      locale={locale}\n      messages={messages}\n      timeZone={timeZone}\n      now={now}\n    >\n      <DeclaredLocalesContext.Provider value={locales ?? null}>\n        {children}\n      </DeclaredLocalesContext.Provider>\n    </NextIntlClientProvider>\n  );\n}\n"],"mappings":";AAmBA;AAAA,EACE;AAAA,EACA,kBAAkB;AAAA,OAEb;;;ACDP;AAAA,EACI;AAAA,EAAc,aAAa;AAAA,EAAmB;AAAA,EAAa;AAAA,EAAQ;AAAA,EACnE,mBAAmB;AAAA,OAChB;;;ACCP,SAAS,oBAAoB,gCAAgC;;;ACnB7D,SAAS,qBAAqB;AAQvB,IAAM,kBAAgC,CAAC,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,SAAS,MAAM,MAAM,MAAM,IAAI;AAC9I,IAAM,iBAA6B;AAoBnC,SAAS,cAAc,QAA8B;AAC1D,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,gBAAgB,QAAQ,iBAAiB;AAC/C,QAAM,eAAe,QAAQ,gBAAgB;AAE7C,SAAO,cAAc;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAMO,IAAM,UAAU,cAAc;;;ADN9B,SAAS,iBAAiB,eAAkD;AACjF,QAAM,SAAS,iBAAiB;AAChC,SAAO,yBAAyB,MAAM;AACxC;AAkBO,IAAM;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,IAAI,iBAAiB;;;AE9CrB,SAAS,eAAe,kBAAkB;AAC1C,SAAS,8BAA8B;AACvC,SAAS,gBAAgB,6BAA6B;AAqC9C;AAlCR,IAAM,yBAAyB,cAAmC,IAAI;AAG/D,IAAM,qBAAqB,MAA2B,WAAW,sBAAsB;;;AH0BvF,SAAS,YAAwB;AACtC,SAAO,kBAAkB;AAC3B;AA6GO,SAAS,aAA2B;AACzC,QAAM,WAAW,mBAAmB;AACpC,SAAO,YAAa,QAAQ;AAC9B;AAqBO,SAAS,kBAAkB;AAChC,QAAM,WAAW,YAAY;AAE7B,SAAO,CAAC,WAAuB;AAE7B,UAAM,OAAO,oBAAI,KAAK;AACtB,SAAK,YAAY,KAAK,YAAY,IAAI,CAAC;AACvC,aAAS,SAAS,eAAe,MAAM,aAAa,KAAK,YAAY,CAAC;AAItE,WAAO,SAAS,OAAO,IAAI,MAAM,GAAG,QAAQ;AAAA,EAC9C;AACF;AAeO,SAAS,oBAAoB;AAClC,QAAM,SAAS,UAAU;AACzB,QAAM,UAAU,WAAW;AAC3B,QAAM,eAAe,gBAAgB;AAErC,SAAO,EAAE,QAAQ,SAAS,aAAa;AACzC;;;ADxLM,gBAAAA,YAAA;AAbC,SAAS,eAAe,EAAE,SAAS,eAAe,GAAG,MAAM,GAAwB;AACxF,QAAM,EAAE,QAAQ,SAAS,gBAAgB,aAAa,IAAI,kBAAkB;AAE5E,QAAM,mBAAmB,iBAAiB;AAE1C,SACE,gBAAAA;AAAA,IAAC;AAAA;AAAA,MACC,OAAO;AAAA,QACL;AAAA,QACA,SAAS;AAAA,QACT,gBAAgB;AAAA,MAClB;AAAA,MAEA,0BAAAA,KAAC,sBAAoB,GAAG,OAAO;AAAA;AAAA,EACjC;AAEJ;","names":["jsx"]}
+{"version":3,"sources":["../../src/i18n/components/LocaleSwitcher.tsx","../../src/i18n/client.ts","../../src/i18n/navigation.ts","../../src/i18n/routing.ts","../../src/i18n/provider.tsx","../../src/i18n/shared-locale.ts"],"sourcesContent":["/**\n * LocaleSwitcher Component (Smart)\n *\n * Wrapper around `@djangocfg/layouts` LocaleSwitcher with next-intl plumbing.\n * Mounts its own `LayoutI18nProvider` so the switcher works standalone — no\n * need to wrap the page in `<AppLayout i18n={...}>` just to render it.\n *\n * @example\n * ```tsx\n * import { LocaleSwitcher } from '@djangocfg/nextjs/i18n/components';\n *\n * <LocaleSwitcher />\n * <LocaleSwitcher locales={['en', 'ru']} />\n * <LocaleSwitcher labels={{ en: 'English', ru: 'Русский' }} />\n * ```\n */\n\n'use client';\n\nimport {\n  LayoutI18nProvider,\n  LocaleSwitcher as BaseLocaleSwitcher,\n  type LocaleSwitcherProps as BaseLocaleSwitcherProps,\n} from '@djangocfg/layouts';\n\nimport { useLocaleSwitcher } from '../client';\nimport type { LocaleCode } from '../types';\n\nexport interface LocaleSwitcherProps extends BaseLocaleSwitcherProps {\n  /** Available locales (defaults to all from routing config) */\n  locales?: LocaleCode[];\n}\n\nexport function LocaleSwitcher({ locales: customLocales, ...props }: LocaleSwitcherProps) {\n  const { locale, locales: routingLocales, changeLocale } = useLocaleSwitcher();\n\n  const availableLocales = customLocales || routingLocales;\n\n  return (\n    <LayoutI18nProvider\n      value={{\n        locale,\n        locales: availableLocales,\n        onLocaleChange: changeLocale,\n      }}\n    >\n      <BaseLocaleSwitcher {...props} />\n    </LayoutI18nProvider>\n  );\n}\n","/**\n * Client-side i18n Hooks\n *\n * For use in Client Components ('use client')\n *\n * @example\n * ```tsx\n * 'use client';\n *\n * import { useTranslations, useLocale } from '@djangocfg/nextjs/i18n/client';\n *\n * export function MyComponent() {\n *   const t = useTranslations('HomePage');\n *   const locale = useLocale();\n *\n *   return <h1>{t('title')}</h1>;\n * }\n * ```\n */\n\n'use client';\n\nimport {\n    useFormatter, useLocale as useNextIntlLocale, useMessages, useNow, useTimeZone,\n    useTranslations as useNextIntlTranslations\n} from 'next-intl';\n\nimport { usePathname } from './navigation';\nimport { I18nProvider, NextIntlProvider, useDeclaredLocales } from './provider';\nimport { routing } from './routing';\nimport { expireHostOnlyLocaleCookie, localeCookieHeader, sharedCookieDomain } from './shared-locale';\n\n// Re-export providers\nexport { I18nProvider, NextIntlProvider };\n\nimport type { LocaleCode } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Core Client Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Get translations in Client Components\n *\n * @example\n * ```tsx\n * const t = useTranslations('HomePage');\n * return <h1>{t('title')}</h1>;\n *\n * // With interpolation\n * return <p>{t('greeting', { name: 'John' })}</p>;\n * ```\n */\nexport function useTranslations<Namespace extends string = never>(\n  namespace?: Namespace\n) {\n  return useNextIntlTranslations(namespace);\n}\n\n/**\n * Get current locale in Client Components\n */\nexport function useLocale(): LocaleCode {\n  return useNextIntlLocale() as LocaleCode;\n}\n\n/**\n * Get all messages\n * Useful for passing to child providers\n */\nexport { useMessages };\n\n/**\n * Get current time\n */\nexport { useNow };\n\n/**\n * Get timezone\n */\nexport { useTimeZone };\n\n/**\n * Get formatter for dates, numbers, etc.\n */\nexport { useFormatter };\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Convenience Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Shorthand for useTranslations\n * Alias for compatibility with @djangocfg/i18n\n */\nexport const useT = useTranslations;\n\n/**\n * Get namespaced translations\n *\n * @example\n * ```tsx\n * const pt = useNamespacedTranslations('payments');\n * return <span>{pt('balance.available')}</span>;\n * ```\n */\nexport function useNamespacedTranslations(namespace: string) {\n  return useNextIntlTranslations(namespace);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Formatting Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Format a date according to locale\n *\n * @example\n * ```tsx\n * const formatDate = useDateFormatter();\n * return <span>{formatDate(new Date())}</span>;\n * ```\n */\nexport function useDateFormatter() {\n  const formatter = useFormatter();\n  return (date: Date | number, options?: Parameters<typeof formatter.dateTime>[1]) =>\n    formatter.dateTime(date, options);\n}\n\n/**\n * Format a number according to locale\n *\n * @example\n * ```tsx\n * const formatNumber = useNumberFormatter();\n * return <span>{formatNumber(1234.56)}</span>;\n * ```\n */\nexport function useNumberFormatter() {\n  const formatter = useFormatter();\n  return (number: number, options?: Parameters<typeof formatter.number>[1]) =>\n    formatter.number(number, options);\n}\n\n/**\n * Format relative time\n *\n * @example\n * ```tsx\n * const formatRelative = useRelativeTimeFormatter();\n * return <span>{formatRelative(new Date())}</span>;\n * ```\n */\nexport function useRelativeTimeFormatter() {\n  const formatter = useFormatter();\n  return (date: Date | number, options?: Parameters<typeof formatter.relativeTime>[1]) =>\n    formatter.relativeTime(date, options);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Locale Switching Hooks\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Locales the app declared on `I18nProvider`; the built-in routing list only\n * when it declared none.\n *\n * @example\n * ```tsx\n * const locales = useLocales();\n * // ['en', 'ru', 'ko']\n * ```\n */\nexport function useLocales(): LocaleCode[] {\n  const declared = useDeclaredLocales();\n  return declared ?? (routing.locales as LocaleCode[]);\n}\n\n/**\n * Get default locale from routing config\n */\nexport function useDefaultLocale(): LocaleCode {\n  return routing.defaultLocale as LocaleCode;\n}\n\n/**\n * Hook to change current locale\n *\n * @example\n * ```tsx\n * const changeLocale = useChangeLocale();\n *\n * <button onClick={() => changeLocale('ru')}>\n *   Switch to Russian\n * </button>\n * ```\n */\nexport function useChangeLocale() {\n  const pathname = usePathname();\n\n  return (locale: LocaleCode) => {\n    // Set NEXT_LOCALE so middleware remembers the choice, on the registrable domain so every host of the family\n    // reads it (see ./shared-locale); the host-only twin is expired so it cannot shadow the shared one.\n    const secure = window.location.protocol === 'https:';\n    const domain = sharedCookieDomain(window.location.hostname, process.env.NEXT_PUBLIC_COOKIE_DOMAIN);\n    document.cookie = localeCookieHeader(locale, domain, secure);\n    if (domain) document.cookie = expireHostOnlyLocaleCookie(secure);\n\n    // Hard navigation to force full page reload with new locale\n    // (ensures server components re-render with updated translations)\n    window.location.href = `/${locale}${pathname}`;\n  };\n}\n\n/**\n * Combined hook for locale switching\n * Returns current locale, available locales, and change function\n *\n * @example\n * ```tsx\n * const { locale, locales, changeLocale } = useLocaleSwitcher();\n *\n * <select value={locale} onChange={(e) => changeLocale(e.target.value)}>\n *   {locales.map(l => <option key={l} value={l}>{l}</option>)}\n * </select>\n * ```\n */\nexport function useLocaleSwitcher() {\n  const locale = useLocale();\n  const locales = useLocales();\n  const changeLocale = useChangeLocale();\n\n  return { locale, locales, changeLocale };\n}\n","/**\n * i18n Navigation Utilities\n *\n * Provides locale-aware navigation components and functions\n *\n * @example\n * ```ts\n * // In your app's i18n/navigation.ts\n * import { createNavigation } from '@djangocfg/nextjs/i18n';\n * import { routing } from './routing';\n *\n * export const { Link, redirect, usePathname, useRouter } = createNavigation(routing);\n * ```\n *\n * @example\n * ```tsx\n * // Using in components\n * import { Link, usePathname } from '@/i18n/navigation';\n *\n * function Nav() {\n *   const pathname = usePathname();\n *   return <Link href=\"/about\">About</Link>;\n * }\n * ```\n */\n\nimport { createNavigation as createNextIntlNavigation } from 'next-intl/navigation';\n\nimport { createRouting, routing } from './routing';\n\nimport type { I18nConfig } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Navigation Factory\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Create navigation utilities with custom routing\n *\n * Returns locale-aware versions of:\n * - Link: Locale-prefixed links\n * - redirect: Server-side redirect with locale\n * - usePathname: Current pathname without locale prefix\n * - useRouter: Router with locale-aware navigation\n * - getPathname: Get pathname for a route\n */\nexport function createNavigation(routingConfig?: ReturnType<typeof createRouting>) {\n  const config = routingConfig ?? routing;\n  return createNextIntlNavigation(config);\n}\n\n/**\n * Create navigation from config options\n */\nexport function createNavigationFromConfig(config: Partial<I18nConfig>) {\n  const routingConfig = createRouting(config);\n  return createNextIntlNavigation(routingConfig);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Default Navigation (using default routing)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Default navigation utilities\n * Use these directly or create custom ones with createNavigation()\n */\nexport const {\n  Link,\n  redirect,\n  usePathname,\n  useRouter,\n  getPathname,\n} = createNavigation();\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Props for locale-aware Link component\n */\nexport interface LinkProps {\n  /** Target href */\n  href: string;\n  /** Target locale (optional, defaults to current) */\n  locale?: string;\n  /** Children */\n  children?: React.ReactNode;\n  /** Additional props passed to Next.js Link */\n  [key: string]: unknown;\n}\n","/**\n * i18n Routing Configuration\n *\n * Creates routing configuration for next-intl\n * Used by proxy and navigation components\n */\n\nimport { defineRouting } from 'next-intl/routing';\n\nimport type { I18nConfig, LocaleCode } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Default Configuration\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport const DEFAULT_LOCALES: LocaleCode[] = ['en', 'ru', 'ko', 'ja', 'de', 'fr', 'zh', 'it', 'es', 'nl', 'ar', 'tr', 'pt-BR', 'pl', 'sv', 'no', 'da'];\nexport const DEFAULT_LOCALE: LocaleCode = 'en';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Routing Factory\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Create routing configuration for next-intl\n *\n * @example\n * ```ts\n * // i18n/routing.ts\n * import { createRouting } from '@djangocfg/nextjs/i18n';\n *\n * export const routing = createRouting({\n *   locales: ['en', 'ru', 'ko'],\n *   defaultLocale: 'en',\n * });\n * ```\n */\nexport function createRouting(config?: Partial<I18nConfig>) {\n  const locales = config?.locales ?? DEFAULT_LOCALES;\n  const defaultLocale = config?.defaultLocale ?? DEFAULT_LOCALE;\n  const localePrefix = config?.localePrefix ?? 'as-needed';\n\n  return defineRouting({\n    locales,\n    defaultLocale,\n    localePrefix,\n  });\n}\n\n/**\n * Default routing configuration\n * Can be overridden by app-specific configuration\n */\nexport const routing = createRouting();\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Locale Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Check if a locale is supported\n */\nexport function isValidLocale(\n  locale: string,\n  supportedLocales: readonly string[] = DEFAULT_LOCALES\n): locale is LocaleCode {\n  return supportedLocales.includes(locale as LocaleCode);\n}\n\n/**\n * Get locale from params (handles async params in Next.js 15+)\n */\nexport async function getLocaleFromParams(\n  params: Promise<{ locale: string }> | { locale: string }\n): Promise<LocaleCode> {\n  const resolved = await params;\n  return resolved.locale as LocaleCode;\n}\n\n/**\n * Generate static params for all locales\n * Use in generateStaticParams for locale pages\n */\nexport function generateLocaleParams(locales: readonly string[] = DEFAULT_LOCALES) {\n  return locales.map((locale) => ({ locale }));\n}\n","/**\n * i18n Provider for Next.js App Router\n *\n * Bridges next-intl with @djangocfg/i18n\n * Provides translations to both Server and Client components\n *\n * @example\n * ```tsx\n * // app/[locale]/layout.tsx\n * import { I18nProvider } from '@djangocfg/nextjs/i18n';\n * import { getMessages, getLocale } from '@djangocfg/nextjs/i18n/server';\n *\n * export default async function LocaleLayout({ children, params }) {\n *   const locale = await getLocale(params);\n *   const messages = await getMessages();\n *\n *   return (\n *     <I18nProvider locale={locale} messages={messages}>\n *       {children}\n *     </I18nProvider>\n *   );\n * }\n * ```\n */\n\n'use client';\n\nimport { createContext, useContext } from 'react';\nimport { NextIntlClientProvider } from 'next-intl';\nimport { I18nProvider as DjangoCfgI18nProvider } from '@djangocfg/i18n';\nimport type { I18nProviderProps, LocaleCode } from './types';\n\nconst DeclaredLocalesContext = createContext<LocaleCode[] | null>(null);\n\n/** Locales the app passed to its provider, or null when it passed none. */\nexport const useDeclaredLocales = (): LocaleCode[] | null => useContext(DeclaredLocalesContext);\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Provider Component\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Unified i18n Provider\n *\n * Wraps both NextIntlClientProvider and @djangocfg/i18n's I18nProvider\n * This ensures both next-intl hooks and @djangocfg/i18n hooks work correctly\n */\nexport function I18nProvider({\n  locale,\n  messages,\n  locales,\n  timeZone = 'UTC',\n  now,\n  children,\n}: I18nProviderProps) {\n  return (\n    <NextIntlClientProvider\n      locale={locale}\n      messages={messages}\n      timeZone={timeZone}\n      now={now}\n    >\n      <DjangoCfgI18nProvider\n        locale={locale as LocaleCode}\n        translations={messages}\n      >\n        <DeclaredLocalesContext.Provider value={locales ?? null}>\n          {children}\n        </DeclaredLocalesContext.Provider>\n      </DjangoCfgI18nProvider>\n    </NextIntlClientProvider>\n  );\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Lightweight Provider (next-intl only)\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Next-intl only provider (without @djangocfg/i18n context)\n * Use if you only need next-intl hooks\n */\nexport function NextIntlProvider({\n  locale,\n  messages,\n  locales,\n  timeZone = 'UTC',\n  now,\n  children,\n}: I18nProviderProps) {\n  return (\n    <NextIntlClientProvider\n      locale={locale}\n      messages={messages}\n      timeZone={timeZone}\n      now={now}\n    >\n      <DeclaredLocalesContext.Provider value={locales ?? null}>\n        {children}\n      </DeclaredLocalesContext.Provider>\n    </NextIntlClientProvider>\n  );\n}\n","/**\n * One locale across every host of one product family.\n *\n * `NEXT_LOCALE` is written host-only by default, so a reader who picked Russian on `hub.example.com` meets English on\n * `team.example.com`. The session tokens already live on the registrable domain (`@djangocfg/api` `createStorage`,\n * `cookieDomain: 'auto'`); the locale follows the same rule: the cookie gets `Domain=` the registrable domain, and the\n * host-only twin is expired so it cannot shadow the shared one.\n *\n * Pure and framework-free, so the proxy (server) and `useChangeLocale` (browser) agree on the domain.\n */\n\nexport const LOCALE_COOKIE = 'NEXT_LOCALE';\nexport const LOCALE_COOKIE_MAX_AGE = 60 * 60 * 24 * 365;\n\n// Second-level public suffixes whose registrable domain has three labels. Not the whole Public Suffix List: the common\n// ones; anything else sets NEXT_PUBLIC_COOKIE_DOMAIN.\nconst TWO_LABEL_SUFFIXES = new Set([\n  'co.uk', 'org.uk', 'ac.uk', 'com.au', 'net.au', 'co.nz', 'co.jp', 'co.kr', 'or.kr', 'com.br', 'com.tr', 'com.cn', 'com.mx',\n  'co.in', 'co.za', 'com.sg', 'com.hk', 'com.tw', 'com.ar', 'com.ua', 'co.il',\n]);\n\n/**\n * The domain a cookie must carry to be sent to every subdomain, or `null` for a host that cannot share (an IP, a bare\n * label such as `localhost`, or an apex with no subdomain in use: a host-only cookie already covers it).\n * `override` (`NEXT_PUBLIC_COOKIE_DOMAIN`) wins when set.\n */\nexport function sharedCookieDomain(hostname: string, override?: string | null): string | null {\n  const forced = override?.trim().replace(/^\\./, '');\n  if (forced) return forced;\n  const host = hostname.split(':')[0]!.toLowerCase();\n  if (!host || /^\\d+(\\.\\d+){3}$/.test(host) || host.includes(':')) return null;\n  const labels = host.split('.');\n  if (labels.length < 2) return null;\n  const keep = TWO_LABEL_SUFFIXES.has(labels.slice(-2).join('.')) ? 3 : 2;\n  return labels.slice(-keep).join('.');\n}\n\n/** The `Set-Cookie` value that writes the shared locale cookie. */\nexport function localeCookieHeader(locale: string, domain: string | null, secure: boolean): string {\n  return `${LOCALE_COOKIE}=${encodeURIComponent(locale)}; Path=/; Max-Age=${LOCALE_COOKIE_MAX_AGE}; SameSite=Lax${domain ? `; Domain=${domain}` : ''}${secure ? '; Secure' : ''}`;\n}\n\n/** Expires the host-only twin of the cookie (a cookie is identified by name and Domain). */\nexport function expireHostOnlyLocaleCookie(secure: boolean): string {\n  return `${LOCALE_COOKIE}=; Path=/; Max-Age=0; SameSite=Lax${secure ? '; Secure' : ''}`;\n}\n"],"mappings":"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","names":["jsx"]}

package/dist/i18n/index.d.mts

@@ -13,3 +13,27 @@ import './routing.mjs';
 import 'next-intl/routing';
 import 'next-intl/server';
 import '@djangocfg/layouts';
+
+/**
+ * One locale across every host of one product family.
+ *
+ * `NEXT_LOCALE` is written host-only by default, so a reader who picked Russian on `hub.example.com` meets English on
+ * `team.example.com`. The session tokens already live on the registrable domain (`@djangocfg/api` `createStorage`,
+ * `cookieDomain: 'auto'`); the locale follows the same rule: the cookie gets `Domain=` the registrable domain, and the
+ * host-only twin is expired so it cannot shadow the shared one.
+ *
+ * Pure and framework-free, so the proxy (server) and `useChangeLocale` (browser) agree on the domain.
+ */
+declare const LOCALE_COOKIE = "NEXT_LOCALE";
+/**
+ * The domain a cookie must carry to be sent to every subdomain, or `null` for a host that cannot share (an IP, a bare
+ * label such as `localhost`, or an apex with no subdomain in use: a host-only cookie already covers it).
+ * `override` (`NEXT_PUBLIC_COOKIE_DOMAIN`) wins when set.
+ */
+declare function sharedCookieDomain(hostname: string, override?: string | null): string | null;
+/** The `Set-Cookie` value that writes the shared locale cookie. */
+declare function localeCookieHeader(locale: string, domain: string | null, secure: boolean): string;
+/** Expires the host-only twin of the cookie (a cookie is identified by name and Domain). */
+declare function expireHostOnlyLocaleCookie(secure: boolean): string;
+
+export { LOCALE_COOKIE, expireHostOnlyLocaleCookie, localeCookieHeader, sharedCookieDomain };

package/dist/i18n/index.mjs

@@ -1 +1,49 @@
+// src/i18n/shared-locale.ts
+var LOCALE_COOKIE = "NEXT_LOCALE";
+var LOCALE_COOKIE_MAX_AGE = 60 * 60 * 24 * 365;
+var TWO_LABEL_SUFFIXES = /* @__PURE__ */ new Set([
+  "co.uk",
+  "org.uk",
+  "ac.uk",
+  "com.au",
+  "net.au",
+  "co.nz",
+  "co.jp",
+  "co.kr",
+  "or.kr",
+  "com.br",
+  "com.tr",
+  "com.cn",
+  "com.mx",
+  "co.in",
+  "co.za",
+  "com.sg",
+  "com.hk",
+  "com.tw",
+  "com.ar",
+  "com.ua",
+  "co.il"
+]);
+function sharedCookieDomain(hostname, override) {
+  const forced = override?.trim().replace(/^\./, "");
+  if (forced) return forced;
+  const host = hostname.split(":")[0].toLowerCase();
+  if (!host || /^\d+(\.\d+){3}$/.test(host) || host.includes(":")) return null;
+  const labels = host.split(".");
+  if (labels.length < 2) return null;
+  const keep = TWO_LABEL_SUFFIXES.has(labels.slice(-2).join(".")) ? 3 : 2;
+  return labels.slice(-keep).join(".");
+}
+function localeCookieHeader(locale, domain, secure) {
+  return `${LOCALE_COOKIE}=${encodeURIComponent(locale)}; Path=/; Max-Age=${LOCALE_COOKIE_MAX_AGE}; SameSite=Lax${domain ? `; Domain=${domain}` : ""}${secure ? "; Secure" : ""}`;
+}
+function expireHostOnlyLocaleCookie(secure) {
+  return `${LOCALE_COOKIE}=; Path=/; Max-Age=0; SameSite=Lax${secure ? "; Secure" : ""}`;
+}
+export {
+  LOCALE_COOKIE,
+  expireHostOnlyLocaleCookie,
+  localeCookieHeader,
+  sharedCookieDomain
+};
 //# sourceMappingURL=index.mjs.map

package/dist/i18n/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../../src/i18n/shared-locale.ts"],"sourcesContent":["/**\n * One locale across every host of one product family.\n *\n * `NEXT_LOCALE` is written host-only by default, so a reader who picked Russian on `hub.example.com` meets English on\n * `team.example.com`. The session tokens already live on the registrable domain (`@djangocfg/api` `createStorage`,\n * `cookieDomain: 'auto'`); the locale follows the same rule: the cookie gets `Domain=` the registrable domain, and the\n * host-only twin is expired so it cannot shadow the shared one.\n *\n * Pure and framework-free, so the proxy (server) and `useChangeLocale` (browser) agree on the domain.\n */\n\nexport const LOCALE_COOKIE = 'NEXT_LOCALE';\nexport const LOCALE_COOKIE_MAX_AGE = 60 * 60 * 24 * 365;\n\n// Second-level public suffixes whose registrable domain has three labels. Not the whole Public Suffix List: the common\n// ones; anything else sets NEXT_PUBLIC_COOKIE_DOMAIN.\nconst TWO_LABEL_SUFFIXES = new Set([\n  'co.uk', 'org.uk', 'ac.uk', 'com.au', 'net.au', 'co.nz', 'co.jp', 'co.kr', 'or.kr', 'com.br', 'com.tr', 'com.cn', 'com.mx',\n  'co.in', 'co.za', 'com.sg', 'com.hk', 'com.tw', 'com.ar', 'com.ua', 'co.il',\n]);\n\n/**\n * The domain a cookie must carry to be sent to every subdomain, or `null` for a host that cannot share (an IP, a bare\n * label such as `localhost`, or an apex with no subdomain in use: a host-only cookie already covers it).\n * `override` (`NEXT_PUBLIC_COOKIE_DOMAIN`) wins when set.\n */\nexport function sharedCookieDomain(hostname: string, override?: string | null): string | null {\n  const forced = override?.trim().replace(/^\\./, '');\n  if (forced) return forced;\n  const host = hostname.split(':')[0]!.toLowerCase();\n  if (!host || /^\\d+(\\.\\d+){3}$/.test(host) || host.includes(':')) return null;\n  const labels = host.split('.');\n  if (labels.length < 2) return null;\n  const keep = TWO_LABEL_SUFFIXES.has(labels.slice(-2).join('.')) ? 3 : 2;\n  return labels.slice(-keep).join('.');\n}\n\n/** The `Set-Cookie` value that writes the shared locale cookie. */\nexport function localeCookieHeader(locale: string, domain: string | null, secure: boolean): string {\n  return `${LOCALE_COOKIE}=${encodeURIComponent(locale)}; Path=/; Max-Age=${LOCALE_COOKIE_MAX_AGE}; SameSite=Lax${domain ? `; Domain=${domain}` : ''}${secure ? '; Secure' : ''}`;\n}\n\n/** Expires the host-only twin of the cookie (a cookie is identified by name and Domain). */\nexport function expireHostOnlyLocaleCookie(secure: boolean): string {\n  return `${LOCALE_COOKIE}=; Path=/; Max-Age=0; SameSite=Lax${secure ? '; Secure' : ''}`;\n}\n"],"mappings":";AAWO,IAAM,gBAAgB;AACtB,IAAM,wBAAwB,KAAK,KAAK,KAAK;AAIpD,IAAM,qBAAqB,oBAAI,IAAI;AAAA,EACjC;AAAA,EAAS;AAAA,EAAU;AAAA,EAAS;AAAA,EAAU;AAAA,EAAU;AAAA,EAAS;AAAA,EAAS;AAAA,EAAS;AAAA,EAAS;AAAA,EAAU;AAAA,EAAU;AAAA,EAAU;AAAA,EAClH;AAAA,EAAS;AAAA,EAAS;AAAA,EAAU;AAAA,EAAU;AAAA,EAAU;AAAA,EAAU;AAAA,EAAU;AACtE,CAAC;AAOM,SAAS,mBAAmB,UAAkB,UAAyC;AAC5F,QAAM,SAAS,UAAU,KAAK,EAAE,QAAQ,OAAO,EAAE;AACjD,MAAI,OAAQ,QAAO;AACnB,QAAM,OAAO,SAAS,MAAM,GAAG,EAAE,CAAC,EAAG,YAAY;AACjD,MAAI,CAAC,QAAQ,kBAAkB,KAAK,IAAI,KAAK,KAAK,SAAS,GAAG,EAAG,QAAO;AACxE,QAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,MAAI,OAAO,SAAS,EAAG,QAAO;AAC9B,QAAM,OAAO,mBAAmB,IAAI,OAAO,MAAM,EAAE,EAAE,KAAK,GAAG,CAAC,IAAI,IAAI;AACtE,SAAO,OAAO,MAAM,CAAC,IAAI,EAAE,KAAK,GAAG;AACrC;AAGO,SAAS,mBAAmB,QAAgB,QAAuB,QAAyB;AACjG,SAAO,GAAG,aAAa,IAAI,mBAAmB,MAAM,CAAC,qBAAqB,qBAAqB,iBAAiB,SAAS,YAAY,MAAM,KAAK,EAAE,GAAG,SAAS,aAAa,EAAE;AAC/K;AAGO,SAAS,2BAA2B,QAAyB;AAClE,SAAO,GAAG,aAAa,qCAAqC,SAAS,aAAa,EAAE;AACtF;","names":[]}

package/dist/i18n/proxy.d.mts

@@ -1,18 +1,42 @@
-import * as next_server from 'next/server';
-import { NextRequest } from 'next/server';
 import { createRouting } from './routing.mjs';
+import { NextRequest, NextResponse } from 'next/server';
 import { I18nConfig } from './index.mjs';
 import 'next-intl/routing';
 import '@djangocfg/i18n';
 
+/**
+ * i18n Proxy for Next.js App Router (Next.js 16+)
+ *
+ * Handles locale detection and routing
+ *
+ * @example
+ * ```ts
+ * // proxy.ts
+ * export { proxy as default, config } from '@djangocfg/nextjs/i18n';
+ *
+ * // Or with custom routing:
+ * import { createProxy } from '@djangocfg/nextjs/i18n';
+ * import { routing } from './i18n/routing';
+ *
+ * export default createProxy(routing);
+ * export const config = { matcher: [...] };
+ * ```
+ */
+
+/**
+ * next-intl writes `NEXT_LOCALE` host-only. Rewrite it onto the registrable domain, so the locale a reader chose on one host
+ * of the family is the locale on all of them, and expire the host-only twin that would shadow it. A host that cannot share
+ * (localhost, an IP) is left as next-intl wrote it. `NEXT_PUBLIC_COOKIE_DOMAIN` overrides the guess.
+ */
+declare function shareLocaleCookie(request: NextRequest, response: NextResponse): NextResponse;
 /**
  * Create i18n proxy handler with custom routing configuration
  */
-declare function createProxy(routingConfig?: ReturnType<typeof createRouting>): (request: NextRequest) => next_server.NextResponse<unknown>;
+declare function createProxy(routingConfig?: ReturnType<typeof createRouting>): (request: NextRequest) => NextResponse<unknown>;
 /**
  * Create i18n proxy from config options
  */
-declare function createProxyFromConfig(config: Partial<I18nConfig>): (request: NextRequest) => next_server.NextResponse<unknown>;
+declare function createProxyFromConfig(config: Partial<I18nConfig>): (request: NextRequest) => NextResponse<unknown>;
 /**
  * Default proxy function using default routing
  *
@@ -22,7 +46,7 @@ declare function createProxyFromConfig(config: Partial<I18nConfig>): (request: N
  * export { proxy as default, config } from '@djangocfg/nextjs/i18n';
  * ```
  */
-declare function proxy(request: NextRequest): next_server.NextResponse<unknown>;
+declare function proxy(request: NextRequest): NextResponse<unknown>;
 /**
  * Default proxy config
  * Matches all paths except static files, API routes, and Next.js internals
@@ -39,4 +63,4 @@ declare const config: {
     matcher: string[];
 };
 
-export { config, createProxy, createProxyFromConfig, proxy };
+export { config, createProxy, createProxyFromConfig, proxy, shareLocaleCookie };

package/dist/i18n/proxy.mjs

@@ -17,14 +17,65 @@ function createRouting(config2) {
 }
 var routing = createRouting();
 
+// src/i18n/shared-locale.ts
+var LOCALE_COOKIE = "NEXT_LOCALE";
+var LOCALE_COOKIE_MAX_AGE = 60 * 60 * 24 * 365;
+var TWO_LABEL_SUFFIXES = /* @__PURE__ */ new Set([
+  "co.uk",
+  "org.uk",
+  "ac.uk",
+  "com.au",
+  "net.au",
+  "co.nz",
+  "co.jp",
+  "co.kr",
+  "or.kr",
+  "com.br",
+  "com.tr",
+  "com.cn",
+  "com.mx",
+  "co.in",
+  "co.za",
+  "com.sg",
+  "com.hk",
+  "com.tw",
+  "com.ar",
+  "com.ua",
+  "co.il"
+]);
+function sharedCookieDomain(hostname, override) {
+  const forced = override?.trim().replace(/^\./, "");
+  if (forced) return forced;
+  const host = hostname.split(":")[0].toLowerCase();
+  if (!host || /^\d+(\.\d+){3}$/.test(host) || host.includes(":")) return null;
+  const labels = host.split(".");
+  if (labels.length < 2) return null;
+  const keep = TWO_LABEL_SUFFIXES.has(labels.slice(-2).join(".")) ? 3 : 2;
+  return labels.slice(-keep).join(".");
+}
+function expireHostOnlyLocaleCookie(secure) {
+  return `${LOCALE_COOKIE}=; Path=/; Max-Age=0; SameSite=Lax${secure ? "; Secure" : ""}`;
+}
+
 // src/i18n/proxy.ts
+function shareLocaleCookie(request, response) {
+  const written = response.cookies.get(LOCALE_COOKIE);
+  if (!written) return response;
+  const host = request.headers.get("x-forwarded-host") ?? request.headers.get("host") ?? request.nextUrl.hostname;
+  const domain = sharedCookieDomain(host, process.env.NEXT_PUBLIC_COOKIE_DOMAIN);
+  if (!domain) return response;
+  const secure = (request.headers.get("x-forwarded-proto") ?? request.nextUrl.protocol.replace(":", "")) === "https";
+  response.cookies.set({ name: LOCALE_COOKIE, value: written.value, domain, path: "/", maxAge: LOCALE_COOKIE_MAX_AGE, sameSite: "lax", secure });
+  response.headers.append("set-cookie", expireHostOnlyLocaleCookie(secure));
+  return response;
+}
 function createProxy(routingConfig) {
   const config2 = routingConfig ?? routing;
-  return createIntlMiddleware(config2);
+  const intl = createIntlMiddleware(config2);
+  return (request) => shareLocaleCookie(request, intl(request));
 }
 function createProxyFromConfig(config2) {
-  const routingConfig = createRouting(config2);
-  return createIntlMiddleware(routingConfig);
+  return createProxy(createRouting(config2));
 }
 var handleI18nRouting = createProxy();
 function proxy(request) {
@@ -39,6 +90,7 @@ export {
   config,
   createProxy,
   createProxyFromConfig,
-  proxy
+  proxy,
+  shareLocaleCookie
 };
 //# sourceMappingURL=proxy.mjs.map

package/dist/i18n/proxy.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/i18n/proxy.ts","../../src/i18n/routing.ts"],"sourcesContent":["/**\n * i18n Proxy for Next.js App Router (Next.js 16+)\n *\n * Handles locale detection and routing\n *\n * @example\n * ```ts\n * // proxy.ts\n * export { proxy as default, config } from '@djangocfg/nextjs/i18n';\n *\n * // Or with custom routing:\n * import { createProxy } from '@djangocfg/nextjs/i18n';\n * import { routing } from './i18n/routing';\n *\n * export default createProxy(routing);\n * export const config = { matcher: [...] };\n * ```\n */\n\nimport createIntlMiddleware from 'next-intl/middleware';\n\nimport { createRouting, routing } from './routing';\n\nimport type { NextRequest } from 'next/server';\n\nimport type { I18nConfig } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Proxy Factory\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Create i18n proxy handler with custom routing configuration\n */\nexport function createProxy(routingConfig?: ReturnType<typeof createRouting>) {\n  const config = routingConfig ?? routing;\n  return createIntlMiddleware(config);\n}\n\n/**\n * Create i18n proxy from config options\n */\nexport function createProxyFromConfig(config: Partial<I18nConfig>) {\n  const routingConfig = createRouting(config);\n  return createIntlMiddleware(routingConfig);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Default Proxy\n// ─────────────────────────────────────────────────────────────────────────────\n\nconst handleI18nRouting = createProxy();\n\n/**\n * Default proxy function using default routing\n *\n * @example\n * ```ts\n * // proxy.ts\n * export { proxy as default, config } from '@djangocfg/nextjs/i18n';\n * ```\n */\nexport function proxy(request: NextRequest) {\n  return handleI18nRouting(request);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Config\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Default proxy config\n * Matches all paths except static files, API routes, and Next.js internals\n *\n * Uses explicit _next/static and _next/image exclusions (required for Next.js 16 / Turbopack)\n *\n * @example\n * ```ts\n * // proxy.ts\n * export { proxy as default, config } from '@djangocfg/nextjs/i18n';\n * ```\n */\nexport const config = {\n  matcher: [\n    '/((?!api|_next/static|_next/image|favicon.ico|sitemap.xml|robots.txt).*)',\n  ],\n};\n","/**\n * i18n Routing Configuration\n *\n * Creates routing configuration for next-intl\n * Used by proxy and navigation components\n */\n\nimport { defineRouting } from 'next-intl/routing';\n\nimport type { I18nConfig, LocaleCode } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Default Configuration\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport const DEFAULT_LOCALES: LocaleCode[] = ['en', 'ru', 'ko', 'ja', 'de', 'fr', 'zh', 'it', 'es', 'nl', 'ar', 'tr', 'pt-BR', 'pl', 'sv', 'no', 'da'];\nexport const DEFAULT_LOCALE: LocaleCode = 'en';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Routing Factory\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Create routing configuration for next-intl\n *\n * @example\n * ```ts\n * // i18n/routing.ts\n * import { createRouting } from '@djangocfg/nextjs/i18n';\n *\n * export const routing = createRouting({\n *   locales: ['en', 'ru', 'ko'],\n *   defaultLocale: 'en',\n * });\n * ```\n */\nexport function createRouting(config?: Partial<I18nConfig>) {\n  const locales = config?.locales ?? DEFAULT_LOCALES;\n  const defaultLocale = config?.defaultLocale ?? DEFAULT_LOCALE;\n  const localePrefix = config?.localePrefix ?? 'as-needed';\n\n  return defineRouting({\n    locales,\n    defaultLocale,\n    localePrefix,\n  });\n}\n\n/**\n * Default routing configuration\n * Can be overridden by app-specific configuration\n */\nexport const routing = createRouting();\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Locale Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Check if a locale is supported\n */\nexport function isValidLocale(\n  locale: string,\n  supportedLocales: readonly string[] = DEFAULT_LOCALES\n): locale is LocaleCode {\n  return supportedLocales.includes(locale as LocaleCode);\n}\n\n/**\n * Get locale from params (handles async params in Next.js 15+)\n */\nexport async function getLocaleFromParams(\n  params: Promise<{ locale: string }> | { locale: string }\n): Promise<LocaleCode> {\n  const resolved = await params;\n  return resolved.locale as LocaleCode;\n}\n\n/**\n * Generate static params for all locales\n * Use in generateStaticParams for locale pages\n */\nexport function generateLocaleParams(locales: readonly string[] = DEFAULT_LOCALES) {\n  return locales.map((locale) => ({ locale }));\n}\n"],"mappings":";AAmBA,OAAO,0BAA0B;;;ACZjC,SAAS,qBAAqB;AAQvB,IAAM,kBAAgC,CAAC,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,SAAS,MAAM,MAAM,MAAM,IAAI;AAC9I,IAAM,iBAA6B;AAoBnC,SAAS,cAAcA,SAA8B;AAC1D,QAAM,UAAUA,SAAQ,WAAW;AACnC,QAAM,gBAAgBA,SAAQ,iBAAiB;AAC/C,QAAM,eAAeA,SAAQ,gBAAgB;AAE7C,SAAO,cAAc;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAMO,IAAM,UAAU,cAAc;;;ADlB9B,SAAS,YAAY,eAAkD;AAC5E,QAAMC,UAAS,iBAAiB;AAChC,SAAO,qBAAqBA,OAAM;AACpC;AAKO,SAAS,sBAAsBA,SAA6B;AACjE,QAAM,gBAAgB,cAAcA,OAAM;AAC1C,SAAO,qBAAqB,aAAa;AAC3C;AAMA,IAAM,oBAAoB,YAAY;AAW/B,SAAS,MAAM,SAAsB;AAC1C,SAAO,kBAAkB,OAAO;AAClC;AAkBO,IAAM,SAAS;AAAA,EACpB,SAAS;AAAA,IACP;AAAA,EACF;AACF;","names":["config","config"]}
+{"version":3,"sources":["../../src/i18n/proxy.ts","../../src/i18n/routing.ts","../../src/i18n/shared-locale.ts"],"sourcesContent":["/**\n * i18n Proxy for Next.js App Router (Next.js 16+)\n *\n * Handles locale detection and routing\n *\n * @example\n * ```ts\n * // proxy.ts\n * export { proxy as default, config } from '@djangocfg/nextjs/i18n';\n *\n * // Or with custom routing:\n * import { createProxy } from '@djangocfg/nextjs/i18n';\n * import { routing } from './i18n/routing';\n *\n * export default createProxy(routing);\n * export const config = { matcher: [...] };\n * ```\n */\n\nimport createIntlMiddleware from 'next-intl/middleware';\n\nimport { createRouting, routing } from './routing';\nimport { expireHostOnlyLocaleCookie, LOCALE_COOKIE, LOCALE_COOKIE_MAX_AGE, sharedCookieDomain } from './shared-locale';\n\nimport type { NextRequest, NextResponse } from 'next/server';\n\nimport type { I18nConfig } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Proxy Factory\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * next-intl writes `NEXT_LOCALE` host-only. Rewrite it onto the registrable domain, so the locale a reader chose on one host\n * of the family is the locale on all of them, and expire the host-only twin that would shadow it. A host that cannot share\n * (localhost, an IP) is left as next-intl wrote it. `NEXT_PUBLIC_COOKIE_DOMAIN` overrides the guess.\n */\nexport function shareLocaleCookie(request: NextRequest, response: NextResponse): NextResponse {\n  const written = response.cookies.get(LOCALE_COOKIE);\n  if (!written) return response;\n  const host = request.headers.get('x-forwarded-host') ?? request.headers.get('host') ?? request.nextUrl.hostname;\n  const domain = sharedCookieDomain(host, process.env.NEXT_PUBLIC_COOKIE_DOMAIN);\n  if (!domain) return response;\n  const secure = (request.headers.get('x-forwarded-proto') ?? request.nextUrl.protocol.replace(':', '')) === 'https';\n  response.cookies.set({ name: LOCALE_COOKIE, value: written.value, domain, path: '/', maxAge: LOCALE_COOKIE_MAX_AGE, sameSite: 'lax', secure });\n  response.headers.append('set-cookie', expireHostOnlyLocaleCookie(secure));\n  return response;\n}\n\n/**\n * Create i18n proxy handler with custom routing configuration\n */\nexport function createProxy(routingConfig?: ReturnType<typeof createRouting>) {\n  const config = routingConfig ?? routing;\n  const intl = createIntlMiddleware(config);\n  return (request: NextRequest) => shareLocaleCookie(request, intl(request) as NextResponse);\n}\n\n/**\n * Create i18n proxy from config options\n */\nexport function createProxyFromConfig(config: Partial<I18nConfig>) {\n  return createProxy(createRouting(config));\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Default Proxy\n// ─────────────────────────────────────────────────────────────────────────────\n\nconst handleI18nRouting = createProxy();\n\n/**\n * Default proxy function using default routing\n *\n * @example\n * ```ts\n * // proxy.ts\n * export { proxy as default, config } from '@djangocfg/nextjs/i18n';\n * ```\n */\nexport function proxy(request: NextRequest) {\n  return handleI18nRouting(request);\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Config\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Default proxy config\n * Matches all paths except static files, API routes, and Next.js internals\n *\n * Uses explicit _next/static and _next/image exclusions (required for Next.js 16 / Turbopack)\n *\n * @example\n * ```ts\n * // proxy.ts\n * export { proxy as default, config } from '@djangocfg/nextjs/i18n';\n * ```\n */\nexport const config = {\n  matcher: [\n    '/((?!api|_next/static|_next/image|favicon.ico|sitemap.xml|robots.txt).*)',\n  ],\n};\n","/**\n * i18n Routing Configuration\n *\n * Creates routing configuration for next-intl\n * Used by proxy and navigation components\n */\n\nimport { defineRouting } from 'next-intl/routing';\n\nimport type { I18nConfig, LocaleCode } from './types';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Default Configuration\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport const DEFAULT_LOCALES: LocaleCode[] = ['en', 'ru', 'ko', 'ja', 'de', 'fr', 'zh', 'it', 'es', 'nl', 'ar', 'tr', 'pt-BR', 'pl', 'sv', 'no', 'da'];\nexport const DEFAULT_LOCALE: LocaleCode = 'en';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Routing Factory\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Create routing configuration for next-intl\n *\n * @example\n * ```ts\n * // i18n/routing.ts\n * import { createRouting } from '@djangocfg/nextjs/i18n';\n *\n * export const routing = createRouting({\n *   locales: ['en', 'ru', 'ko'],\n *   defaultLocale: 'en',\n * });\n * ```\n */\nexport function createRouting(config?: Partial<I18nConfig>) {\n  const locales = config?.locales ?? DEFAULT_LOCALES;\n  const defaultLocale = config?.defaultLocale ?? DEFAULT_LOCALE;\n  const localePrefix = config?.localePrefix ?? 'as-needed';\n\n  return defineRouting({\n    locales,\n    defaultLocale,\n    localePrefix,\n  });\n}\n\n/**\n * Default routing configuration\n * Can be overridden by app-specific configuration\n */\nexport const routing = createRouting();\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Locale Utilities\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Check if a locale is supported\n */\nexport function isValidLocale(\n  locale: string,\n  supportedLocales: readonly string[] = DEFAULT_LOCALES\n): locale is LocaleCode {\n  return supportedLocales.includes(locale as LocaleCode);\n}\n\n/**\n * Get locale from params (handles async params in Next.js 15+)\n */\nexport async function getLocaleFromParams(\n  params: Promise<{ locale: string }> | { locale: string }\n): Promise<LocaleCode> {\n  const resolved = await params;\n  return resolved.locale as LocaleCode;\n}\n\n/**\n * Generate static params for all locales\n * Use in generateStaticParams for locale pages\n */\nexport function generateLocaleParams(locales: readonly string[] = DEFAULT_LOCALES) {\n  return locales.map((locale) => ({ locale }));\n}\n","/**\n * One locale across every host of one product family.\n *\n * `NEXT_LOCALE` is written host-only by default, so a reader who picked Russian on `hub.example.com` meets English on\n * `team.example.com`. The session tokens already live on the registrable domain (`@djangocfg/api` `createStorage`,\n * `cookieDomain: 'auto'`); the locale follows the same rule: the cookie gets `Domain=` the registrable domain, and the\n * host-only twin is expired so it cannot shadow the shared one.\n *\n * Pure and framework-free, so the proxy (server) and `useChangeLocale` (browser) agree on the domain.\n */\n\nexport const LOCALE_COOKIE = 'NEXT_LOCALE';\nexport const LOCALE_COOKIE_MAX_AGE = 60 * 60 * 24 * 365;\n\n// Second-level public suffixes whose registrable domain has three labels. Not the whole Public Suffix List: the common\n// ones; anything else sets NEXT_PUBLIC_COOKIE_DOMAIN.\nconst TWO_LABEL_SUFFIXES = new Set([\n  'co.uk', 'org.uk', 'ac.uk', 'com.au', 'net.au', 'co.nz', 'co.jp', 'co.kr', 'or.kr', 'com.br', 'com.tr', 'com.cn', 'com.mx',\n  'co.in', 'co.za', 'com.sg', 'com.hk', 'com.tw', 'com.ar', 'com.ua', 'co.il',\n]);\n\n/**\n * The domain a cookie must carry to be sent to every subdomain, or `null` for a host that cannot share (an IP, a bare\n * label such as `localhost`, or an apex with no subdomain in use: a host-only cookie already covers it).\n * `override` (`NEXT_PUBLIC_COOKIE_DOMAIN`) wins when set.\n */\nexport function sharedCookieDomain(hostname: string, override?: string | null): string | null {\n  const forced = override?.trim().replace(/^\\./, '');\n  if (forced) return forced;\n  const host = hostname.split(':')[0]!.toLowerCase();\n  if (!host || /^\\d+(\\.\\d+){3}$/.test(host) || host.includes(':')) return null;\n  const labels = host.split('.');\n  if (labels.length < 2) return null;\n  const keep = TWO_LABEL_SUFFIXES.has(labels.slice(-2).join('.')) ? 3 : 2;\n  return labels.slice(-keep).join('.');\n}\n\n/** The `Set-Cookie` value that writes the shared locale cookie. */\nexport function localeCookieHeader(locale: string, domain: string | null, secure: boolean): string {\n  return `${LOCALE_COOKIE}=${encodeURIComponent(locale)}; Path=/; Max-Age=${LOCALE_COOKIE_MAX_AGE}; SameSite=Lax${domain ? `; Domain=${domain}` : ''}${secure ? '; Secure' : ''}`;\n}\n\n/** Expires the host-only twin of the cookie (a cookie is identified by name and Domain). */\nexport function expireHostOnlyLocaleCookie(secure: boolean): string {\n  return `${LOCALE_COOKIE}=; Path=/; Max-Age=0; SameSite=Lax${secure ? '; Secure' : ''}`;\n}\n"],"mappings":";AAmBA,OAAO,0BAA0B;;;ACZjC,SAAS,qBAAqB;AAQvB,IAAM,kBAAgC,CAAC,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,MAAM,SAAS,MAAM,MAAM,MAAM,IAAI;AAC9I,IAAM,iBAA6B;AAoBnC,SAAS,cAAcA,SAA8B;AAC1D,QAAM,UAAUA,SAAQ,WAAW;AACnC,QAAM,gBAAgBA,SAAQ,iBAAiB;AAC/C,QAAM,eAAeA,SAAQ,gBAAgB;AAE7C,SAAO,cAAc;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAMO,IAAM,UAAU,cAAc;;;ACzC9B,IAAM,gBAAgB;AACtB,IAAM,wBAAwB,KAAK,KAAK,KAAK;AAIpD,IAAM,qBAAqB,oBAAI,IAAI;AAAA,EACjC;AAAA,EAAS;AAAA,EAAU;AAAA,EAAS;AAAA,EAAU;AAAA,EAAU;AAAA,EAAS;AAAA,EAAS;AAAA,EAAS;AAAA,EAAS;AAAA,EAAU;AAAA,EAAU;AAAA,EAAU;AAAA,EAClH;AAAA,EAAS;AAAA,EAAS;AAAA,EAAU;AAAA,EAAU;AAAA,EAAU;AAAA,EAAU;AAAA,EAAU;AACtE,CAAC;AAOM,SAAS,mBAAmB,UAAkB,UAAyC;AAC5F,QAAM,SAAS,UAAU,KAAK,EAAE,QAAQ,OAAO,EAAE;AACjD,MAAI,OAAQ,QAAO;AACnB,QAAM,OAAO,SAAS,MAAM,GAAG,EAAE,CAAC,EAAG,YAAY;AACjD,MAAI,CAAC,QAAQ,kBAAkB,KAAK,IAAI,KAAK,KAAK,SAAS,GAAG,EAAG,QAAO;AACxE,QAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,MAAI,OAAO,SAAS,EAAG,QAAO;AAC9B,QAAM,OAAO,mBAAmB,IAAI,OAAO,MAAM,EAAE,EAAE,KAAK,GAAG,CAAC,IAAI,IAAI;AACtE,SAAO,OAAO,MAAM,CAAC,IAAI,EAAE,KAAK,GAAG;AACrC;AAQO,SAAS,2BAA2B,QAAyB;AAClE,SAAO,GAAG,aAAa,qCAAqC,SAAS,aAAa,EAAE;AACtF;;;AFRO,SAAS,kBAAkB,SAAsB,UAAsC;AAC5F,QAAM,UAAU,SAAS,QAAQ,IAAI,aAAa;AAClD,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,OAAO,QAAQ,QAAQ,IAAI,kBAAkB,KAAK,QAAQ,QAAQ,IAAI,MAAM,KAAK,QAAQ,QAAQ;AACvG,QAAM,SAAS,mBAAmB,MAAM,QAAQ,IAAI,yBAAyB;AAC7E,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,UAAU,QAAQ,QAAQ,IAAI,mBAAmB,KAAK,QAAQ,QAAQ,SAAS,QAAQ,KAAK,EAAE,OAAO;AAC3G,WAAS,QAAQ,IAAI,EAAE,MAAM,eAAe,OAAO,QAAQ,OAAO,QAAQ,MAAM,KAAK,QAAQ,uBAAuB,UAAU,OAAO,OAAO,CAAC;AAC7I,WAAS,QAAQ,OAAO,cAAc,2BAA2B,MAAM,CAAC;AACxE,SAAO;AACT;AAKO,SAAS,YAAY,eAAkD;AAC5E,QAAMC,UAAS,iBAAiB;AAChC,QAAM,OAAO,qBAAqBA,OAAM;AACxC,SAAO,CAAC,YAAyB,kBAAkB,SAAS,KAAK,OAAO,CAAiB;AAC3F;AAKO,SAAS,sBAAsBA,SAA6B;AACjE,SAAO,YAAY,cAAcA,OAAM,CAAC;AAC1C;AAMA,IAAM,oBAAoB,YAAY;AAW/B,SAAS,MAAM,SAAsB;AAC1C,SAAO,kBAAkB,OAAO;AAClC;AAkBO,IAAM,SAAS;AAAA,EACpB,SAAS;AAAA,IACP;AAAA,EACF;AACF;","names":["config","config"]}

package/dist/i18n/routing.d.mts

@@ -24,7 +24,6 @@ declare function createRouting(config?: Partial<I18nConfig>): {
     localePrefix?: next_intl_routing.LocalePrefix<string[], "always" | "as-needed" | "never"> | undefined;
     domains?: undefined;
     localeCookie?: boolean | {
-        name?: string | undefined;
         maxAge?: number | undefined | undefined;
         priority?: "low" | "medium" | "high" | undefined | undefined;
         domain?: string | undefined | undefined;
@@ -32,6 +31,7 @@ declare function createRouting(config?: Partial<I18nConfig>): {
         secure?: boolean | undefined | undefined;
         sameSite?: true | false | "lax" | "strict" | "none" | undefined | undefined;
         partitioned?: boolean | undefined | undefined;
+        name?: string | undefined;
     };
     alternateLinks?: boolean;
     localeDetection?: boolean;
@@ -46,7 +46,6 @@ declare const routing: {
     localePrefix?: next_intl_routing.LocalePrefix<string[], "always" | "as-needed" | "never"> | undefined;
     domains?: undefined;
     localeCookie?: boolean | {
-        name?: string | undefined;
         maxAge?: number | undefined | undefined;
         priority?: "low" | "medium" | "high" | undefined | undefined;
         domain?: string | undefined | undefined;
@@ -54,6 +53,7 @@ declare const routing: {
         secure?: boolean | undefined | undefined;
         sameSite?: true | false | "lax" | "strict" | "none" | undefined | undefined;
         partitioned?: boolean | undefined | undefined;
+        name?: string | undefined;
     };
     alternateLinks?: boolean;
     localeDetection?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/nextjs",
-  "version": "2.1.626",
+  "version": "2.1.627",
   "description": "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
   "keywords": [
     "nextjs",
@@ -162,10 +162,10 @@
     "ai-docs": "tsx src/ai/cli.ts"
   },
   "peerDependencies": {
-    "@djangocfg/api": "^2.1.626",
-    "@djangocfg/devtools": "^2.1.626",
-    "@djangocfg/i18n": "^2.1.626",
-    "@djangocfg/ui-core": "^2.1.626",
+    "@djangocfg/api": "^2.1.627",
+    "@djangocfg/devtools": "^2.1.627",
+    "@djangocfg/i18n": "^2.1.627",
+    "@djangocfg/ui-core": "^2.1.627",
     "next": "^16.4.5",
     "next-intl": "^4.9.1"
   },
@@ -187,12 +187,12 @@
     "semver": "^7.8.6"
   },
   "devDependencies": {
-    "@djangocfg/api": "^2.1.626",
-    "@djangocfg/devtools": "^2.1.626",
-    "@djangocfg/i18n": "^2.1.626",
-    "@djangocfg/layouts": "^2.1.626",
-    "@djangocfg/typescript-config": "^2.1.626",
-    "@djangocfg/ui-core": "^2.1.626",
+    "@djangocfg/api": "^2.1.627",
+    "@djangocfg/devtools": "^2.1.627",
+    "@djangocfg/i18n": "^2.1.627",
+    "@djangocfg/layouts": "^2.1.627",
+    "@djangocfg/typescript-config": "^2.1.627",
+    "@djangocfg/ui-core": "^2.1.627",
     "@types/node": "^25.9.5",
     "@types/react": "19.3.0",
     "@types/react-dom": "19.3.0",

package/src/i18n/client.ts

@@ -28,6 +28,7 @@ import {
 import { usePathname } from './navigation';
 import { I18nProvider, NextIntlProvider, useDeclaredLocales } from './provider';
 import { routing } from './routing';
+import { expireHostOnlyLocaleCookie, localeCookieHeader, sharedCookieDomain } from './shared-locale';
 
 // Re-export providers
 export { I18nProvider, NextIntlProvider };
@@ -198,10 +199,12 @@ export function useChangeLocale() {
   const pathname = usePathname();
 
   return (locale: LocaleCode) => {
-    // Set NEXT_LOCALE cookie so middleware remembers the choice
-    const date = new Date();
-    date.setFullYear(date.getFullYear() + 1);
-    document.cookie = `NEXT_LOCALE=${locale}; expires=${date.toUTCString()}; path=/`;
+    // Set NEXT_LOCALE so middleware remembers the choice, on the registrable domain so every host of the family
+    // reads it (see ./shared-locale); the host-only twin is expired so it cannot shadow the shared one.
+    const secure = window.location.protocol === 'https:';
+    const domain = sharedCookieDomain(window.location.hostname, process.env.NEXT_PUBLIC_COOKIE_DOMAIN);
+    document.cookie = localeCookieHeader(locale, domain, secure);
+    if (domain) document.cookie = expireHostOnlyLocaleCookie(secure);
 
     // Hard navigation to force full page reload with new locale
     // (ensures server components re-render with updated translations)

package/src/i18n/index.ts

@@ -48,3 +48,5 @@ export type {
 export type { LinkProps } from './navigation';
 export type { RequestConfigOptions } from './request';
 export type { LocaleSwitcherProps } from './components';
+
+export { sharedCookieDomain, localeCookieHeader, expireHostOnlyLocaleCookie, LOCALE_COOKIE } from './shared-locale';

package/src/i18n/proxy.test.ts

@@ -0,0 +1,22 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { NextRequest, NextResponse } from 'next/server';
+import { shareLocaleCookie } from './proxy';
+
+test('rewrites the cookie onto the registrable domain', () => {
+  const request = new NextRequest('https://hub.example.com/ru', { headers: { 'x-forwarded-proto': 'https' } });
+  const response = NextResponse.next();
+  response.cookies.set('NEXT_LOCALE', 'ru', { path: '/' });
+  const out = shareLocaleCookie(request, response);
+  const lines = out.headers.getSetCookie();
+  assert.ok(lines.some((l) => l.startsWith('NEXT_LOCALE=ru') && l.includes('Domain=example.com')));
+  assert.ok(lines.some((l) => l.startsWith('NEXT_LOCALE=;') && l.includes('Max-Age=0') && !l.includes('Domain')));
+});
+
+test('localhost is left alone', () => {
+  const request = new NextRequest('http://localhost:3211/ru');
+  const response = NextResponse.next();
+  response.cookies.set('NEXT_LOCALE', 'ru', { path: '/' });
+  const out = shareLocaleCookie(request, response);
+  assert.equal(out.headers.getSetCookie().length, 1);
+});

package/src/i18n/proxy.ts

@@ -20,8 +20,9 @@
 import createIntlMiddleware from 'next-intl/middleware';
 
 import { createRouting, routing } from './routing';
+import { expireHostOnlyLocaleCookie, LOCALE_COOKIE, LOCALE_COOKIE_MAX_AGE, sharedCookieDomain } from './shared-locale';
 
-import type { NextRequest } from 'next/server';
+import type { NextRequest, NextResponse } from 'next/server';
 
 import type { I18nConfig } from './types';
 
@@ -29,20 +30,37 @@ import type { I18nConfig } from './types';
 // Proxy Factory
 // ─────────────────────────────────────────────────────────────────────────────
 
+/**
+ * next-intl writes `NEXT_LOCALE` host-only. Rewrite it onto the registrable domain, so the locale a reader chose on one host
+ * of the family is the locale on all of them, and expire the host-only twin that would shadow it. A host that cannot share
+ * (localhost, an IP) is left as next-intl wrote it. `NEXT_PUBLIC_COOKIE_DOMAIN` overrides the guess.
+ */
+export function shareLocaleCookie(request: NextRequest, response: NextResponse): NextResponse {
+  const written = response.cookies.get(LOCALE_COOKIE);
+  if (!written) return response;
+  const host = request.headers.get('x-forwarded-host') ?? request.headers.get('host') ?? request.nextUrl.hostname;
+  const domain = sharedCookieDomain(host, process.env.NEXT_PUBLIC_COOKIE_DOMAIN);
+  if (!domain) return response;
+  const secure = (request.headers.get('x-forwarded-proto') ?? request.nextUrl.protocol.replace(':', '')) === 'https';
+  response.cookies.set({ name: LOCALE_COOKIE, value: written.value, domain, path: '/', maxAge: LOCALE_COOKIE_MAX_AGE, sameSite: 'lax', secure });
+  response.headers.append('set-cookie', expireHostOnlyLocaleCookie(secure));
+  return response;
+}
+
 /**
  * Create i18n proxy handler with custom routing configuration
  */
 export function createProxy(routingConfig?: ReturnType<typeof createRouting>) {
   const config = routingConfig ?? routing;
-  return createIntlMiddleware(config);
+  const intl = createIntlMiddleware(config);
+  return (request: NextRequest) => shareLocaleCookie(request, intl(request) as NextResponse);
 }
 
 /**
  * Create i18n proxy from config options
  */
 export function createProxyFromConfig(config: Partial<I18nConfig>) {
-  const routingConfig = createRouting(config);
-  return createIntlMiddleware(routingConfig);
+  return createProxy(createRouting(config));
 }
 
 // ─────────────────────────────────────────────────────────────────────────────

package/src/i18n/shared-locale.test.ts

@@ -0,0 +1,34 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+
+import { expireHostOnlyLocaleCookie, localeCookieHeader, sharedCookieDomain } from './shared-locale';
+
+test('the registrable domain of a subdomain host', () => {
+  assert.equal(sharedCookieDomain('hub.example.com'), 'example.com');
+  assert.equal(sharedCookieDomain('team.hub.example.com:3000'), 'example.com');
+  assert.equal(sharedCookieDomain('example.com'), 'example.com');
+});
+
+test('two-label public suffixes keep three labels', () => {
+  assert.equal(sharedCookieDomain('hub.example.co.uk'), 'example.co.uk');
+});
+
+test('hosts that cannot share get no domain', () => {
+  assert.equal(sharedCookieDomain('localhost:3211'), null);
+  assert.equal(sharedCookieDomain('127.0.0.1'), null);
+  assert.equal(sharedCookieDomain('[::1]'), null);
+});
+
+test('the override wins', () => {
+  assert.equal(sharedCookieDomain('hub.example.org', '.corp.example.org'), 'corp.example.org');
+  assert.equal(sharedCookieDomain('localhost', 'dev.test'), 'dev.test');
+});
+
+test('cookie headers', () => {
+  assert.equal(
+    localeCookieHeader('ru', 'example.com', true),
+    'NEXT_LOCALE=ru; Path=/; Max-Age=31536000; SameSite=Lax; Domain=example.com; Secure',
+  );
+  assert.equal(localeCookieHeader('ru', null, false), 'NEXT_LOCALE=ru; Path=/; Max-Age=31536000; SameSite=Lax');
+  assert.equal(expireHostOnlyLocaleCookie(false), 'NEXT_LOCALE=; Path=/; Max-Age=0; SameSite=Lax');
+});

package/src/i18n/shared-locale.ts

@@ -0,0 +1,46 @@
+/**
+ * One locale across every host of one product family.
+ *
+ * `NEXT_LOCALE` is written host-only by default, so a reader who picked Russian on `hub.example.com` meets English on
+ * `team.example.com`. The session tokens already live on the registrable domain (`@djangocfg/api` `createStorage`,
+ * `cookieDomain: 'auto'`); the locale follows the same rule: the cookie gets `Domain=` the registrable domain, and the
+ * host-only twin is expired so it cannot shadow the shared one.
+ *
+ * Pure and framework-free, so the proxy (server) and `useChangeLocale` (browser) agree on the domain.
+ */
+
+export const LOCALE_COOKIE = 'NEXT_LOCALE';
+export const LOCALE_COOKIE_MAX_AGE = 60 * 60 * 24 * 365;
+
+// Second-level public suffixes whose registrable domain has three labels. Not the whole Public Suffix List: the common
+// ones; anything else sets NEXT_PUBLIC_COOKIE_DOMAIN.
+const TWO_LABEL_SUFFIXES = new Set([
+  'co.uk', 'org.uk', 'ac.uk', 'com.au', 'net.au', 'co.nz', 'co.jp', 'co.kr', 'or.kr', 'com.br', 'com.tr', 'com.cn', 'com.mx',
+  'co.in', 'co.za', 'com.sg', 'com.hk', 'com.tw', 'com.ar', 'com.ua', 'co.il',
+]);
+
+/**
+ * The domain a cookie must carry to be sent to every subdomain, or `null` for a host that cannot share (an IP, a bare
+ * label such as `localhost`, or an apex with no subdomain in use: a host-only cookie already covers it).
+ * `override` (`NEXT_PUBLIC_COOKIE_DOMAIN`) wins when set.
+ */
+export function sharedCookieDomain(hostname: string, override?: string | null): string | null {
+  const forced = override?.trim().replace(/^\./, '');
+  if (forced) return forced;
+  const host = hostname.split(':')[0]!.toLowerCase();
+  if (!host || /^\d+(\.\d+){3}$/.test(host) || host.includes(':')) return null;
+  const labels = host.split('.');
+  if (labels.length < 2) return null;
+  const keep = TWO_LABEL_SUFFIXES.has(labels.slice(-2).join('.')) ? 3 : 2;
+  return labels.slice(-keep).join('.');
+}
+
+/** The `Set-Cookie` value that writes the shared locale cookie. */
+export function localeCookieHeader(locale: string, domain: string | null, secure: boolean): string {
+  return `${LOCALE_COOKIE}=${encodeURIComponent(locale)}; Path=/; Max-Age=${LOCALE_COOKIE_MAX_AGE}; SameSite=Lax${domain ? `; Domain=${domain}` : ''}${secure ? '; Secure' : ''}`;
+}
+
+/** Expires the host-only twin of the cookie (a cookie is identified by name and Domain). */
+export function expireHostOnlyLocaleCookie(secure: boolean): string {
+  return `${LOCALE_COOKIE}=; Path=/; Max-Age=0; SameSite=Lax${secure ? '; Secure' : ''}`;
+}