@djangocfg/nextjs 2.1.626 → 2.1.628

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":";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;;;ACxBvF,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;;;AJiBO,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;AAG7B,UAAM,SAAS,OAAO,SAAS,aAAa;AAC5C,UAAM,SAAS,mBAAmB,OAAO,SAAS,UAAU,QAAQ,IAAI,yBAAyB;AACjG,aAAS,SAAS,mBAAmB,QAAQ,QAAQ,MAAM;AAC3D,QAAI,OAAQ,UAAS,SAAS,2BAA2B,MAAM;AAI/D,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;;;AD3LM,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"]}

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.628",
   "description": "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
   "keywords": [
     "nextjs",
@@ -92,6 +92,16 @@
       "import": "./dist/pwa/worker/index.mjs",
       "default": "./dist/pwa/worker/index.mjs"
     },
+    "./app-icon": {
+      "types": "./dist/app-icon/index.d.mts",
+      "import": "./dist/app-icon/index.mjs",
+      "default": "./dist/app-icon/index.mjs"
+    },
+    "./app-icon/next": {
+      "types": "./dist/app-icon/next.d.mts",
+      "import": "./dist/app-icon/next.mjs",
+      "default": "./dist/app-icon/next.mjs"
+    },
     "./og-image": {
       "types": "./dist/og-image/index.d.mts",
       "import": "./dist/og-image/index.mjs",
@@ -162,10 +172,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.628",
+    "@djangocfg/devtools": "^2.1.628",
+    "@djangocfg/i18n": "^2.1.628",
+    "@djangocfg/ui-core": "^2.1.628",
     "next": "^16.4.5",
     "next-intl": "^4.9.1"
   },
@@ -187,12 +197,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.628",
+    "@djangocfg/devtools": "^2.1.628",
+    "@djangocfg/i18n": "^2.1.628",
+    "@djangocfg/layouts": "^2.1.628",
+    "@djangocfg/typescript-config": "^2.1.628",
+    "@djangocfg/ui-core": "^2.1.628",
     "@types/node": "^25.9.5",
     "@types/react": "19.3.0",
     "@types/react-dom": "19.3.0",

package/src/app-icon/element.test.ts

@@ -0,0 +1,35 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+
+import type { ReactElement } from 'react';
+
+import { appIconElement, appIconGradient, oklchToHex } from './element';
+
+const GOLDEN = '#3f93f7';
+
+type Tile = ReactElement<{ style: Record<string, unknown>; children: ReactElement<{ width: number }> }>;
+
+describe('app-icon', () => {
+  it('converts oklch to a stable hex (golden)', () => {
+    assert.equal(oklchToHex(0.66, 0.17, 255), GOLDEN);
+    assert.equal(oklchToHex(1, 0, 0), '#ffffff');
+  });
+
+  it('builds the gradient from two hex stops', () => {
+    assert.match(appIconGradient(55), /^linear-gradient\(150deg, #[0-9a-f]{6}, #[0-9a-f]{6}\)$/);
+  });
+
+  it('draws a full-bleed tile with no border and a smaller glyph on a square', () => {
+    const rounded = appIconElement({ glyph: [['path', { key: 'a', d: 'M0 0' }]], hue: 55, size: 100 }) as Tile;
+    const square = appIconElement({ glyph: [['path', { key: 'a', d: 'M0 0' }]], hue: 55, size: 100, shape: 'square' }) as Tile;
+    assert.equal(rounded.props.style.border, undefined);
+    assert.equal(rounded.props.style.borderRadius, 23);
+    assert.equal(square.props.style.borderRadius, 0);
+    assert.equal(rounded.props.children.props.width, 58);
+    assert.equal(square.props.children.props.width, 46);
+  });
+
+  it('refuses a glyph that is not a lucide module', () => {
+    assert.throws(() => appIconElement({ glyph: {}, hue: 0, size: 10 }), /lucide/);
+  });
+});

package/src/app-icon/element.ts

@@ -0,0 +1,91 @@
+/**
+ * App icon: ONE definition of the picture an app shows in a tab, on a home screen and as a PWA icon.
+ *
+ * House style: a full-bleed tile in the product's hue (a two-stop gradient), a white lucide glyph in the inner ~46-58%,
+ * and NO border near the edge. The OS cuts its own corner (iOS ~22%, Android a mask); anything drawn at the edge never
+ * matches that curve.
+ *
+ * Pure: plain host elements only (`next/og` renders nothing else) and no `next/og` import, so a client bundle can use
+ * the same gradient for an in-app tile. The route factory lives in `./next`.
+ */
+
+import { createElement, type ReactElement } from 'react';
+
+/** What lucide stores for an icon: `[tag, attrs][]`; `attrs.key` is React's key. */
+export type IconNode = [tag: string, attrs: Record<string, string>][];
+
+/**
+ * A glyph is a lucide icon MODULE, `import * as workflow from 'lucide-react/icons/workflow'` (a lucide component is a
+ * client component and `next/og` cannot render it, so its drawing data is read from the module), or the node list itself.
+ */
+export type AppIconGlyph = object | IconNode;
+
+export type AppIconShape = 'rounded' | 'square';
+
+export interface AppIconOptions {
+  glyph: AppIconGlyph;
+  /** OKLCH hue, 0-360. The switcher tile should use `appIconGradient(hue)` so both agree. */
+  hue: number;
+  /** Side in px. */
+  size: number;
+  /** `rounded`: transparent corners (browser tab). `square`: full-bleed for iOS and maskable PWA icons. @default 'rounded' */
+  shape?: AppIconShape;
+}
+
+/** OKLCH to sRGB hex. `next/og` does not parse `oklch()`; CSS does, and the two must show the same colour. */
+export function oklchToHex(l: number, c: number, h: number): string {
+  const a = c * Math.cos((h * Math.PI) / 180);
+  const b = c * Math.sin((h * Math.PI) / 180);
+  const l_ = (l + 0.3963377774 * a + 0.2158037573 * b) ** 3;
+  const m_ = (l - 0.1055613458 * a - 0.0638541728 * b) ** 3;
+  const s_ = (l - 0.0894841775 * a - 1.291485548 * b) ** 3;
+  const lin = [
+    4.0767416621 * l_ - 3.3077115913 * m_ + 0.2309699292 * s_,
+    -1.2684380046 * l_ + 2.6097574011 * m_ - 0.3413193965 * s_,
+    -0.0041960863 * l_ - 0.7034186147 * m_ + 1.707614701 * s_,
+  ];
+  const hex = lin.map((v) => {
+    const g = v <= 0.0031308 ? 12.92 * v : 1.055 * v ** (1 / 2.4) - 0.055;
+    return Math.round(Math.min(1, Math.max(0, g)) * 255).toString(16).padStart(2, '0');
+  });
+  return `#${hex.join('')}`;
+}
+
+/** The gradient behind a glyph, two hex stops from one hue. */
+export function appIconGradient(hue: number): string {
+  return `linear-gradient(150deg, ${oklchToHex(0.66, 0.17, hue)}, ${oklchToHex(0.47, 0.18, hue + 22)})`;
+}
+
+function nodesOf(glyph: AppIconGlyph): IconNode {
+  if (Array.isArray(glyph)) return glyph as IconNode;
+  const node = (glyph as { __iconData?: { node?: IconNode } }).__iconData?.node;
+  if (!node) throw new Error("app-icon: glyph is not a lucide icon module (expected `import * as x from 'lucide-react/icons/<name>'`)");
+  return node;
+}
+
+/** The picture as plain JSX, for `new ImageResponse(...)`. */
+export function appIconElement({ glyph, hue, size, shape = 'rounded' }: AppIconOptions): ReactElement {
+  const square = shape === 'square';
+  // A square icon is cropped by the OS: keep the glyph inside the maskable safe zone (the inner 60%).
+  const side = Math.round(size * (square ? 0.46 : 0.58));
+  const glyphSvg = createElement(
+    'svg',
+    { width: side, height: side, viewBox: '0 0 24 24', fill: 'none', stroke: '#ffffff', strokeWidth: 2.1, strokeLinecap: 'round', strokeLinejoin: 'round' },
+    ...nodesOf(glyph).map(([tag, { key, ...attrs }]) => createElement(tag, { key, ...attrs })),
+  );
+  return createElement(
+    'div',
+    {
+      style: {
+        width: size,
+        height: size,
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        backgroundImage: appIconGradient(hue),
+        borderRadius: square ? 0 : Math.round(size * 0.225),
+      },
+    },
+    glyphSvg,
+  );
+}

package/src/app-icon/index.ts

@@ -0,0 +1,3 @@
+export { appIconElement, appIconGradient, oklchToHex } from './element';
+export type { AppIconGlyph, AppIconOptions, AppIconShape, IconNode } from './element';
+export { appIconPaths } from './paths';