@djangocfg/nextjs 2.1.579 → 2.1.581

package/dist/{types-DZTgCl85.d.mts → types-C77BSPye.d.mts}

@@ -38,6 +38,11 @@ interface I18nProviderProps {
     locale: LocaleCode;
     /** Translation messages */
     messages: Messages;
+    /**
+     * Locales the app ships. `useLocales()` / `useLocaleSwitcher()` report these;
+     * without it they fall back to the package's built-in list.
+     */
+    locales?: LocaleCode[];
     /** Time zone for date/time formatting */
     timeZone?: string;
     /** Now value for relative time */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/nextjs",
-  "version": "2.1.579",
+  "version": "2.1.581",
   "description": "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
   "keywords": [
     "nextjs",
@@ -149,9 +149,9 @@
     "ai-docs": "tsx src/ai/cli.ts"
   },
   "peerDependencies": {
-    "@djangocfg/devtools": "^2.1.579",
-    "@djangocfg/i18n": "^2.1.579",
-    "@djangocfg/ui-core": "^2.1.579",
+    "@djangocfg/devtools": "^2.1.581",
+    "@djangocfg/i18n": "^2.1.581",
+    "@djangocfg/ui-core": "^2.1.581",
     "next": "^16.2.2"
   },
   "peerDependenciesMeta": {
@@ -170,11 +170,11 @@
     "semver": "^7.8.5"
   },
   "devDependencies": {
-    "@djangocfg/devtools": "^2.1.579",
-    "@djangocfg/i18n": "^2.1.579",
-    "@djangocfg/layouts": "^2.1.579",
-    "@djangocfg/typescript-config": "^2.1.579",
-    "@djangocfg/ui-core": "^2.1.579",
+    "@djangocfg/devtools": "^2.1.581",
+    "@djangocfg/i18n": "^2.1.581",
+    "@djangocfg/layouts": "^2.1.581",
+    "@djangocfg/typescript-config": "^2.1.581",
+    "@djangocfg/ui-core": "^2.1.581",
     "@types/node": "^25.9.5",
     "@types/react": "19.2.15",
     "@types/react-dom": "19.2.3",

package/src/config/constants.ts

@@ -53,6 +53,7 @@ export const DEFAULT_TRANSPILE_PACKAGES = [
   '@djangocfg/widget-forms',
   '@djangocfg/widget-kit',
   '@djangocfg/widget-map',
+  '@djangocfg/widget-mcp',
   '@djangocfg/widget-media',
   '@djangocfg/widget-ogimage',
   '@djangocfg/widget-overlay',

package/src/i18n/client.ts

@@ -26,7 +26,7 @@ import {
 } from 'next-intl';
 
 import { usePathname } from './navigation';
-import { I18nProvider, NextIntlProvider } from './provider';
+import { I18nProvider, NextIntlProvider, useDeclaredLocales } from './provider';
 import { routing } from './routing';
 
 // Re-export providers
@@ -161,7 +161,8 @@ export function useRelativeTimeFormatter() {
 // ─────────────────────────────────────────────────────────────────────────────
 
 /**
- * Get list of available locales from routing config
+ * Locales the app declared on `I18nProvider`; the built-in routing list only
+ * when it declared none.
  *
  * @example
  * ```tsx
@@ -170,7 +171,8 @@ export function useRelativeTimeFormatter() {
  * ```
  */
 export function useLocales(): LocaleCode[] {
-  return routing.locales as LocaleCode[];
+  const declared = useDeclaredLocales();
+  return declared ?? (routing.locales as LocaleCode[]);
 }
 
 /**

package/src/i18n/provider.tsx

@@ -25,10 +25,16 @@
 
 'use client';
 
+import { createContext, useContext } from 'react';
 import { NextIntlClientProvider } from 'next-intl';
 import { I18nProvider as DjangoCfgI18nProvider } from '@djangocfg/i18n';
 import type { I18nProviderProps, LocaleCode } from './types';
 
+const DeclaredLocalesContext = createContext<LocaleCode[] | null>(null);
+
+/** Locales the app passed to its provider, or null when it passed none. */
+export const useDeclaredLocales = (): LocaleCode[] | null => useContext(DeclaredLocalesContext);
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Provider Component
 // ─────────────────────────────────────────────────────────────────────────────
@@ -42,6 +48,7 @@ import type { I18nProviderProps, LocaleCode } from './types';
 export function I18nProvider({
   locale,
   messages,
+  locales,
   timeZone = 'UTC',
   now,
   children,
@@ -57,7 +64,9 @@ export function I18nProvider({
         locale={locale as LocaleCode}
         translations={messages}
       >
-        {children}
+        <DeclaredLocalesContext.Provider value={locales ?? null}>
+          {children}
+        </DeclaredLocalesContext.Provider>
       </DjangoCfgI18nProvider>
     </NextIntlClientProvider>
   );
@@ -74,6 +83,7 @@ export function I18nProvider({
 export function NextIntlProvider({
   locale,
   messages,
+  locales,
   timeZone = 'UTC',
   now,
   children,
@@ -85,7 +95,9 @@ export function NextIntlProvider({
       timeZone={timeZone}
       now={now}
     >
-      {children}
+      <DeclaredLocalesContext.Provider value={locales ?? null}>
+        {children}
+      </DeclaredLocalesContext.Provider>
     </NextIntlClientProvider>
   );
 }

package/src/i18n/types.ts

@@ -55,6 +55,11 @@ export interface I18nProviderProps {
   locale: LocaleCode;
   /** Translation messages */
   messages: Messages;
+  /**
+   * Locales the app ships. `useLocales()` / `useLocaleSwitcher()` report these;
+   * without it they fall back to the package's built-in list.
+   */
+  locales?: LocaleCode[];
   /** Time zone for date/time formatting */
   timeZone?: string;
   /** Now value for relative time */