@djangocfg/layouts 2.1.279 → 2.1.281

package/README.md

@@ -87,7 +87,7 @@ Wraps `BaseApp` and picks **admin → private → public** layout by path (`matc
 
 | Component | Use |
 |---|---|
-| **`PublicLayout`** | Marketing / docs. Slots for navbar + footer. **[See PublicLayout README](./src/layouts/PublicLayout/README.md)** for full props, navbar variants (`FloatingNavbar` / `FlushNavbar` / `MinimalNavbar`), `DefaultFooter`, `NavAction`, and hooks. |
+| **`PublicLayout`** | Marketing / docs. Slots for navbar + footer. Supports `LinkComponentProvider` to inject an i18n-aware `Link` (e.g. `next-intl`) so every anchor picks up the locale prefix. All three navbars accept `controls` + `i18n` to show theme / locale switchers next to UserMenu (same shape as `DefaultFooter.controls`). **[See PublicLayout README](./src/layouts/PublicLayout/README.md)** for full props, navbar variants (`FloatingNavbar` / `FlushNavbar` / `MinimalNavbar`), `DefaultFooter`, `NavAction`, `NavControls`, and hooks. |
 | **`PrivateLayout`** | App shell — sidebar + header. |
 | **`AuthLayout`** | Sign-in flows. |
 | **`AdminLayout`** | Admin console. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/layouts",
-  "version": "2.1.279",
+  "version": "2.1.281",
   "description": "Simple, straightforward layout components for Next.js - import and use with props",
   "keywords": [
     "layouts",
@@ -74,14 +74,14 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/api": "^2.1.279",
-    "@djangocfg/centrifugo": "^2.1.279",
-    "@djangocfg/debuger": "^2.1.279",
-    "@djangocfg/i18n": "^2.1.279",
-    "@djangocfg/monitor": "^2.1.279",
-    "@djangocfg/ui-core": "^2.1.279",
-    "@djangocfg/ui-nextjs": "^2.1.279",
-    "@djangocfg/ui-tools": "^2.1.279",
+    "@djangocfg/api": "^2.1.281",
+    "@djangocfg/centrifugo": "^2.1.281",
+    "@djangocfg/debuger": "^2.1.281",
+    "@djangocfg/i18n": "^2.1.281",
+    "@djangocfg/monitor": "^2.1.281",
+    "@djangocfg/ui-core": "^2.1.281",
+    "@djangocfg/ui-nextjs": "^2.1.281",
+    "@djangocfg/ui-tools": "^2.1.281",
     "@hookform/resolvers": "^5.2.2",
     "consola": "^3.4.2",
     "lucide-react": "^0.545.0",
@@ -110,15 +110,15 @@
     "uuid": "^11.1.0"
   },
   "devDependencies": {
-    "@djangocfg/api": "^2.1.279",
-    "@djangocfg/centrifugo": "^2.1.279",
-    "@djangocfg/debuger": "^2.1.279",
-    "@djangocfg/i18n": "^2.1.279",
-    "@djangocfg/monitor": "^2.1.279",
-    "@djangocfg/typescript-config": "^2.1.279",
-    "@djangocfg/ui-core": "^2.1.279",
-    "@djangocfg/ui-nextjs": "^2.1.279",
-    "@djangocfg/ui-tools": "^2.1.279",
+    "@djangocfg/api": "^2.1.281",
+    "@djangocfg/centrifugo": "^2.1.281",
+    "@djangocfg/debuger": "^2.1.281",
+    "@djangocfg/i18n": "^2.1.281",
+    "@djangocfg/monitor": "^2.1.281",
+    "@djangocfg/typescript-config": "^2.1.281",
+    "@djangocfg/ui-core": "^2.1.281",
+    "@djangocfg/ui-nextjs": "^2.1.281",
+    "@djangocfg/ui-tools": "^2.1.281",
     "@types/node": "^24.7.2",
     "@types/react": "^19.1.0",
     "@types/react-dom": "^19.1.0",

package/src/layouts/AppLayout/AppLayout.tsx

@@ -48,7 +48,9 @@ import type {
   SWRConfigOptions,
   PwaInstallConfig,
   DebugConfig,
+  I18nLayoutConfig,
 } from '../types';
+export type { I18nLayoutConfig } from '../types';
 import type { AuthConfig } from '@djangocfg/api/auth';
 import type { MonitorConfig } from '@djangocfg/monitor';
 
@@ -152,16 +154,6 @@ function determineLayoutMode(
   return 'public';
 }
 
-/** i18n configuration for locale switching */
-export interface I18nLayoutConfig {
-  /** Current locale */
-  locale: string;
-  /** Available locales */
-  locales: string[];
-  /** Callback when locale changes */
-  onLocaleChange: (locale: string) => void;
-}
-
 /**
  * Props passed to every layout component (`public` / `private` / `admin`).
  * Use `publicChrome` to pass defaults for `FloatingNavbar` / `DefaultFooter` from `AppLayout`.

package/src/layouts/PrivateLayout/PrivateLayout.tsx

@@ -15,7 +15,8 @@ import { useAuth } from '@djangocfg/api/auth';
 import { Preloader } from '@djangocfg/ui-core/components';
 import { SidebarInset, SidebarProvider } from '@djangocfg/ui-nextjs/components';
 
-import type { AppLayoutPublicChrome, I18nLayoutConfig } from '../AppLayout/AppLayout';
+import type { AppLayoutPublicChrome } from '../AppLayout/AppLayout';
+import type { I18nLayoutConfig } from '../types';
 import { UserMenuConfig } from '../types';
 import { PrivateContent, PrivateSidebar } from './components';
 

package/src/layouts/PrivateLayout/components/PrivateSidebar.tsx

@@ -29,7 +29,7 @@ import { cn } from '@djangocfg/ui-core/lib';
 import { PrivateSidebarAccount } from '../../_components/PrivateSidebarAccount';
 import { LucideIcon } from '../../../components';
 
-import type { I18nLayoutConfig } from '../../AppLayout/AppLayout';
+import type { I18nLayoutConfig } from '../../types';
 import type { HeaderConfig, SidebarItem, SidebarConfig } from '../PrivateLayout';
 
 /** Few items → roomier rows; many items → tighter. Same breakpoints for demo, CarAPIS, etc. */

package/src/layouts/PublicLayout/README.md

@@ -23,6 +23,30 @@ import { PublicLayout, FloatingNavbar, DefaultFooter } from '@djangocfg/layouts'
 | `contentTopSpacing` | `'auto' \| 'none'` | `'auto'` | Auto pads `<main>` based on the navbar variant. |
 | `contentBottomSpacing` | `'auto' \| 'none' \| 'compact'` | `'auto'` | Bottom breathing room before footer. |
 
+## `LinkComponentProvider` — inject a custom Link
+
+All internal anchors (navbar, footer, mobile drawer) render through a single
+injectable `Link` component. Default is plain `next/link`. Wrap the layout in
+`LinkComponentProvider` to swap it — for example to pipe in a locale-aware
+`Link` from `next-intl`:
+
+```tsx
+import { LinkComponentProvider, PublicLayout, FloatingNavbar } from '@djangocfg/layouts';
+import { Link } from '@/i18n/navigation'; // next-intl createNavigation().Link
+
+<LinkComponentProvider value={Link}>
+  <PublicLayout navbar={<FloatingNavbar config={…} />} footer={…}>
+    {children}
+  </PublicLayout>
+</LinkComponentProvider>
+```
+
+Why: with `next-intl`'s `localePrefix: 'as-needed'`, plain `next/link` does
+not prepend the active locale, so every navbar item drops the `/ru/` prefix
+on click. Injecting the i18n-aware `Link` fixes that once for the whole tree.
+
+Monolingual apps don't need the provider — the default `next/link` is fine.
+
 ## Navbar variants
 
 Three variants. All share the same core props (below); only the chrome differs.
@@ -52,6 +76,8 @@ Three variants. All share the same core props (below); only the chrome differs.
 | `transparentThreshold` | `number` | `40` | Px past which the nav becomes opaque. |
 | `desktopMaxPrimaryItems` | `number` | auto | Hard cap for primary items before overflow. |
 | `renderDesktopDropdown` | `(ctx) => ReactNode` | — | Replace default popover per-item. |
+| `controls` | `{ showThemeSwitcher?; showLocaleSwitcher? }` | — | Compact theme + locale pills next to UserMenu. See below. |
+| `i18n` | `{ locale, locales, onLocaleChange }` | — | Required for the locale switcher (same shape as `DefaultFooter.i18n`). |
 
 ### Variant-only
 
@@ -68,6 +94,48 @@ Three variants. All share the same core props (below); only the chrome differs.
 - `centered` — all three groups centered in one row.
 - `split` — brand left, actions right, **no desktop nav** (drawer only).
 
+## Theme + locale controls (navbar)
+
+All three navbars accept an optional `controls` block and `i18n` config that
+mirrors `DefaultFooter`. When enabled, a compact `NavControls` pill is rendered
+on desktop right before `UserMenu`, and an equivalent row appears in the mobile
+drawer footer.
+
+```tsx
+<FloatingNavbar
+  config={{
+    brand: <BrandLogo />,
+    navigation,
+    userMenu: { authPath: '/auth' },
+    controls: { showThemeSwitcher: true, showLocaleSwitcher: true },
+    i18n: { locale, locales, onLocaleChange: changeLocale },
+  }}
+/>
+```
+
+| Control | Required | Notes |
+|---|---|---|
+| `controls.showThemeSwitcher` | — | Light / system / dark pill (uses `useThemeContext`). |
+| `controls.showLocaleSwitcher` | `i18n` | Globe dropdown. Silently hidden when `i18n` is omitted. |
+
+Same shape works for `FlushNavbar` and `MinimalNavbar`. If you build a custom
+navbar with `NavbarShell`, the controls node is pre-built and delivered to
+`renderActions(ctx)` as `ctx.controls`.
+
+Need to render the pills somewhere custom (e.g. your own navbar)? Import
+`NavControls` directly:
+
+```tsx
+import { NavControls } from '@djangocfg/layouts';
+
+<NavControls
+  showThemeSwitcher
+  showLocaleSwitcher
+  i18n={{ locale, locales, onLocaleChange }}
+  size="compact" // 'compact' (navbar) | 'default' (footer)
+/>
+```
+
 ## `NavAction`
 
 Typed pill used by every navbar's `actions`.
@@ -131,7 +199,7 @@ Three variants: `full` (default) with brand column + menus + controls; `compact`
 
 ## Primitives
 
-`NavBrand`, `NavActions`, `NavActionItem`, `NavDesktopItems`, `ThemeBrandMark`, `ThemeBrandMarkImg`, `PublicLayoutProvider`, `usePublicLayout`.
+`NavBrand`, `NavActions`, `NavActionItem`, `NavControls`, `NavDesktopItems`, `ThemeBrandMark`, `ThemeBrandMarkImg`, `LinkComponentProvider`, `useLinkComponent`, `PublicLayoutProvider`, `usePublicLayout`.
 
 ## Context
 

package/src/layouts/PublicLayout/footers/DefaultFooter/DefaultFooter.tsx

@@ -13,7 +13,7 @@ import { Button } from '@djangocfg/ui-core/components';
 import { useThemeContext } from '@djangocfg/ui-nextjs/theme';
 
 import { LocaleSwitcher } from '../../../_components/LocaleSwitcher';
-import { SmartNavLink } from '../../primitives/SmartNavLink';
+import { useLinkComponent } from '../../primitives/LinkComponentContext';
 import { FooterMenuSections } from './FooterMenuSections';
 import { FooterProjectInfo } from './FooterProjectInfo';
 
@@ -69,6 +69,7 @@ function ThemeModeControl() {
 }
 
 export function DefaultFooter({ config }: DefaultFooterProps) {
+  const Link = useLinkComponent();
   const variant = config.variant ?? 'full';
   const shellClass = config.shell?.className;
   const brandSlot = config.brand?.slot;
@@ -132,13 +133,13 @@ export function DefaultFooter({ config }: DefaultFooterProps) {
                       {link.label}
                     </a>
                   ) : (
-                    <SmartNavLink
+                    <Link
                       key={link.path}
                       href={link.path}
                       className="text-sm text-muted-foreground hover:text-foreground transition-colors"
                     >
                       {link.label}
-                    </SmartNavLink>
+                    </Link>
                   )
                 )}
               </div>
@@ -195,13 +196,13 @@ export function DefaultFooter({ config }: DefaultFooterProps) {
                     {link.label}
                   </a>
                 ) : (
-                  <SmartNavLink
+                  <Link
                     key={link.path}
                     href={link.path}
                     className="text-xs text-muted-foreground hover:text-primary transition-colors"
                   >
                     {link.label}
-                  </SmartNavLink>
+                  </Link>
                 )
               )}
             </div>
@@ -302,9 +303,9 @@ export function DefaultFooter({ config }: DefaultFooterProps) {
                     {link.label}
                   </a>
                 ) : (
-                  <SmartNavLink key={link.path} href={link.path} className="hover:text-foreground transition-colors whitespace-nowrap">
+                  <Link key={link.path} href={link.path} className="hover:text-foreground transition-colors whitespace-nowrap">
                     {link.label}
-                  </SmartNavLink>
+                  </Link>
                 )
               )}
             </div>

package/src/layouts/PublicLayout/footers/DefaultFooter/FooterBottom.tsx

@@ -2,7 +2,7 @@
 
 import React from 'react';
 
-import { SmartNavLink } from '../../primitives/SmartNavLink';
+import { useLinkComponent } from '../../primitives/LinkComponentContext';
 import { DjangoCFGLogo } from './DjangoCFGLogo';
 
 import type { FooterLink } from './types';
@@ -23,6 +23,7 @@ export function FooterBottom({
   links = [],
   variant = 'desktop',
 }: FooterBottomProps) {
+  const Link = useLinkComponent();
   const isMobile = variant === 'mobile';
 
   if (isMobile) {
@@ -95,13 +96,13 @@ export function FooterBottom({
                   {link.label}
                 </a>
               ) : (
-                <SmartNavLink
+                <Link
                   key={link.path}
                   href={link.path}
                   className="text-xs text-muted-foreground hover:text-primary transition-colors"
                 >
                   {link.label}
-                </SmartNavLink>
+                </Link>
               )
             )}
           </div>

package/src/layouts/PublicLayout/footers/DefaultFooter/FooterMenuSections.tsx

@@ -2,7 +2,7 @@
 
 import React from 'react';
 
-import { SmartNavLink } from '../../primitives/SmartNavLink';
+import { useLinkComponent } from '../../primitives/LinkComponentContext';
 
 import type { FooterMenuSection } from './types';
 
@@ -17,6 +17,7 @@ export function FooterMenuSections({
   minColumnWidth = 180,
   maxColumns = 5,
 }: FooterMenuSectionsProps) {
+  const Link = useLinkComponent();
   if (menuSections.length === 0) return null;
 
   const effectiveColumns = Math.max(1, Math.min(maxColumns, menuSections.length));
@@ -34,12 +35,12 @@ export function FooterMenuSections({
           <ul className="space-y-2">
             {section.items.map((item) => (
               <li key={item.path}>
-                <SmartNavLink
+                <Link
                   href={item.path}
                   className="text-sm text-foreground/90 hover:text-foreground transition-colors"
                 >
                   {item.label}
-                </SmartNavLink>
+                </Link>
               </li>
             ))}
           </ul>

package/src/layouts/PublicLayout/footers/DefaultFooter/types.ts

@@ -5,8 +5,7 @@
 import type { LucideIcon } from 'lucide-react';
 import type { ReactNode } from 'react';
 
-import type { I18nLayoutConfig } from '../../../AppLayout/AppLayout';
-import type { FooterLink, FooterMenuSection, FooterSocialLinks } from '../../../types';
+import type { FooterLink, FooterMenuSection, FooterSocialLinks, I18nLayoutConfig } from '../../../types';
 
 export type { FooterLink, FooterMenuSection, FooterSocialLinks };
 

package/src/layouts/PublicLayout/index.ts

@@ -33,21 +33,21 @@ export {
   NavBrand,
   NavActions,
   NavActionItem,
+  NavControls,
   NavDesktopItems,
   ThemeBrandMark,
   ThemeBrandMarkImg,
-  ExternalPrefixesProvider,
-  useExternalPrefixes,
-  isExternalPrefixHref,
-  SmartNavLink,
+  LinkComponentProvider,
+  useLinkComponent,
 } from './primitives';
 export type {
   NavAction,
+  NavControlsProps,
   ThemeBrandMarkProps,
   ThemeBrandMarkImgProps,
-  ExternalPrefixes,
-  ExternalPrefixesProviderProps,
-  SmartNavLinkProps,
+  LinkComponent,
+  LinkComponentProps,
+  LinkComponentProviderProps,
 } from './primitives';
 
 // Navbar variants

package/src/layouts/PublicLayout/navbars/FloatingNavbar/FloatingNavbar.tsx

@@ -11,7 +11,6 @@ import React from 'react';
 import { cn } from '@djangocfg/ui-core/lib';
 
 import { publicFloatingChromeClassName } from '../../publicShellShadow';
-import { ExternalPrefixesProvider } from '../../primitives/ExternalPrefixesContext';
 import type { NavAction } from '../../primitives/NavActionItem';
 import { NavbarShell } from '../../shared';
 import type {
@@ -21,7 +20,7 @@ import type {
   PublicNavbarShellConfig,
   PublicNavLayout,
 } from '../../navbarTypes';
-import type { NavigationItem, UserMenuConfig } from '../../../types';
+import type { I18nLayoutConfig, NavigationItem, UserMenuConfig } from '../../../types';
 
 import { FloatingMobileDrawer } from './FloatingMobileDrawer';
 
@@ -53,13 +52,18 @@ export interface FloatingNavbarConfig {
   /** Arbitrary ReactNode after the mobile toggle. */
   actionsTrailingSlot?: React.ReactNode;
   /**
-   * Path prefixes that should be navigated with a plain `<a>` (full page load)
-   * instead of `next/link`. Use this for routes served by a catch-all handler
-   * outside the Next.js App Router (e.g. Nextra at `/docs/*`) — those routes
-   * cannot return an RSC payload, so `next/link` client navigation fails.
-   * @default []
+   * Optional theme + locale controls rendered next to UserMenu on desktop
+   * and as a footer row in the mobile drawer. Locale switcher requires
+   * `i18n`. Mirrors `DefaultFooter.controls`.
    */
-  externalPrefixes?: readonly string[];
+  controls?: {
+    /** Light / system / dark pill. @default false */
+    showThemeSwitcher?: boolean;
+    /** Locale dropdown. Requires `i18n`. @default false */
+    showLocaleSwitcher?: boolean;
+  };
+  /** i18n config (current locale + locales + onLocaleChange). */
+  i18n?: I18nLayoutConfig;
 }
 
 export interface FloatingNavbarProps {
@@ -71,7 +75,6 @@ export function FloatingNavbar({ config }: FloatingNavbarProps) {
   const rounding = config.shell?.rounding;
   const containerClassName = config.shell?.className;
   const position = config.navbarPosition ?? 'sticky';
-  const externalPrefixes = config.externalPrefixes;
 
   const outerClassName = cn(
     position === 'fixed' ? 'fixed' : position === 'static' ? 'static' : 'sticky',
@@ -87,7 +90,7 @@ export function FloatingNavbar({ config }: FloatingNavbarProps) {
   );
 
   return (
-    <ExternalPrefixesProvider value={externalPrefixes}>
+    <>
       <NavbarShell
         variant="floating"
         position={position}
@@ -105,6 +108,8 @@ export function FloatingNavbar({ config }: FloatingNavbarProps) {
         actions={config.actions}
         actionsLeadingSlot={config.actionsLeadingSlot}
         actionsTrailingSlot={config.actionsTrailingSlot}
+        controls={config.controls}
+        i18n={config.i18n}
         outerClassName={outerClassName}
         shapeClassName={shapeClassName}
         shapeForState={({ scrolled, transparent }) =>
@@ -121,7 +126,9 @@ export function FloatingNavbar({ config }: FloatingNavbarProps) {
         userMenu={config.userMenu}
         containerClassName={containerClassName}
         rounding={rounding}
+        controls={config.controls}
+        i18n={config.i18n}
       />
-    </ExternalPrefixesProvider>
+    </>
   );
 }

package/src/layouts/PublicLayout/navbars/FlushNavbar/FlushNavbar.tsx

@@ -10,7 +10,6 @@ import React from 'react';
 
 import { cn } from '@djangocfg/ui-core/lib';
 
-import { ExternalPrefixesProvider } from '../../primitives/ExternalPrefixesContext';
 import type { NavAction } from '../../primitives/NavActionItem';
 import { NavbarShell } from '../../shared';
 import type {
@@ -20,7 +19,7 @@ import type {
   PublicNavbarShellConfig,
   PublicNavLayout,
 } from '../../navbarTypes';
-import type { NavigationItem, UserMenuConfig } from '../../../types';
+import type { I18nLayoutConfig, NavigationItem, UserMenuConfig } from '../../../types';
 
 import { FlushMobileDrawer } from './FlushMobileDrawer';
 
@@ -52,13 +51,18 @@ export interface FlushNavbarConfig {
   /** Arbitrary ReactNode after the mobile toggle. */
   actionsTrailingSlot?: React.ReactNode;
   /**
-   * Path prefixes that should be navigated with a plain `<a>` (full page load)
-   * instead of `next/link`. Use this for routes served by a catch-all handler
-   * outside the Next.js App Router (e.g. Nextra at `/docs/*`) — those routes
-   * cannot return an RSC payload, so `next/link` client navigation fails.
-   * @default []
+   * Optional theme + locale controls rendered next to UserMenu on desktop
+   * and as a footer row in the mobile drawer. Locale switcher requires
+   * `i18n`. Mirrors `DefaultFooter.controls`.
    */
-  externalPrefixes?: readonly string[];
+  controls?: {
+    /** Light / system / dark pill. @default false */
+    showThemeSwitcher?: boolean;
+    /** Locale dropdown. Requires `i18n`. @default false */
+    showLocaleSwitcher?: boolean;
+  };
+  /** i18n config (current locale + locales + onLocaleChange). */
+  i18n?: I18nLayoutConfig;
 }
 
 export interface FlushNavbarProps {
@@ -69,7 +73,6 @@ export function FlushNavbar({ config }: FlushNavbarProps) {
   const navigation = config.navigation ?? [];
   const containerClassName = config.shell?.className;
   const position = config.navbarPosition ?? 'sticky';
-  const externalPrefixes = config.externalPrefixes;
 
   const outerClassName = cn(
     position === 'fixed' ? 'fixed' : position === 'static' ? 'static' : 'sticky',
@@ -83,7 +86,7 @@ export function FlushNavbar({ config }: FlushNavbarProps) {
   );
 
   return (
-    <ExternalPrefixesProvider value={externalPrefixes}>
+    <>
       <NavbarShell
         variant="flush"
         position={position}
@@ -101,6 +104,8 @@ export function FlushNavbar({ config }: FlushNavbarProps) {
         actions={config.actions}
         actionsLeadingSlot={config.actionsLeadingSlot}
         actionsTrailingSlot={config.actionsTrailingSlot}
+        controls={config.controls}
+        i18n={config.i18n}
         outerClassName={outerClassName}
         shapeClassName={shapeClassName}
         shapeForState={({ scrolled, transparent }) =>
@@ -116,7 +121,9 @@ export function FlushNavbar({ config }: FlushNavbarProps) {
         navigation={navigation}
         userMenu={config.userMenu}
         containerClassName={containerClassName}
+        controls={config.controls}
+        i18n={config.i18n}
       />
-    </ExternalPrefixesProvider>
+    </>
   );
 }

package/src/layouts/PublicLayout/navbars/MinimalNavbar/MinimalNavbar.tsx

@@ -17,7 +17,6 @@ import { Button } from '@djangocfg/ui-core/components';
 import { cn } from '@djangocfg/ui-core/lib';
 
 import { UserMenu } from '../../../_components/UserMenu';
-import { ExternalPrefixesProvider } from '../../primitives/ExternalPrefixesContext';
 import { NavActionItem, type NavAction } from '../../primitives/NavActionItem';
 import { NavbarShell, type NavbarActionsContext } from '../../shared';
 import type {
@@ -26,7 +25,7 @@ import type {
   PublicNavbarPosition,
   PublicNavLayout,
 } from '../../navbarTypes';
-import type { NavigationItem, UserMenuConfig } from '../../../types';
+import type { I18nLayoutConfig, NavigationItem, UserMenuConfig } from '../../../types';
 
 import { MinimalMobileDrawer } from './MinimalMobileDrawer';
 
@@ -68,15 +67,19 @@ export interface MinimalNavbarConfig {
    * @default 'mx-auto max-w-[1400px] px-4 sm:px-6 lg:px-10'
    */
   containerClassName?: string;
-
   /**
-   * Path prefixes that should be navigated with a plain `<a>` (full page load)
-   * instead of `next/link`. Use this for routes served by a catch-all handler
-   * outside the Next.js App Router (e.g. Nextra at `/docs/*`) — those routes
-   * cannot return an RSC payload, so `next/link` client navigation fails.
-   * @default []
+   * Optional theme + locale controls rendered next to UserMenu on desktop
+   * and as a footer row in the mobile drawer. Locale switcher requires
+   * `i18n`. Mirrors `DefaultFooter.controls`.
    */
-  externalPrefixes?: readonly string[];
+  controls?: {
+    /** Light / system / dark pill. @default false */
+    showThemeSwitcher?: boolean;
+    /** Locale dropdown. Requires `i18n`. @default false */
+    showLocaleSwitcher?: boolean;
+  };
+  /** i18n config (current locale + locales + onLocaleChange). */
+  i18n?: I18nLayoutConfig;
 }
 
 export interface MinimalNavbarProps {
@@ -100,6 +103,10 @@ function MinimalActions({
         </div>
       )}
 
+      {ctx.controls && (
+        <div className="hidden lg:flex shrink-0 items-center">{ctx.controls}</div>
+      )}
+
       <div className="hidden lg:flex">
         <UserMenu
           variant="desktop"
@@ -131,7 +138,6 @@ export function MinimalNavbar({ config }: MinimalNavbarProps) {
   const position = config.navbarPosition ?? 'sticky';
   const transparent = config.transparent ?? true;
   const containerClassName = config.containerClassName ?? 'mx-auto max-w-[1400px] px-4 sm:px-6 lg:px-10';
-  const externalPrefixes = config.externalPrefixes;
 
   const outerClassName = cn(
     position === 'fixed' ? 'fixed' : position === 'static' ? 'static' : 'sticky',
@@ -142,7 +148,7 @@ export function MinimalNavbar({ config }: MinimalNavbarProps) {
   const shapeClassName = 'w-full rounded-none border-0 shadow-none';
 
   return (
-    <ExternalPrefixesProvider value={externalPrefixes}>
+    <>
       <NavbarShell
         variant="minimal"
         position={position}
@@ -157,6 +163,8 @@ export function MinimalNavbar({ config }: MinimalNavbarProps) {
         hideNavOnScroll={config.hideNavOnScroll}
         transparent={transparent}
         transparentThreshold={config.transparentThreshold}
+        controls={config.controls}
+        i18n={config.i18n}
         outerClassName={outerClassName}
         shapeClassName={shapeClassName}
         innerPadding={containerClassName}
@@ -174,7 +182,9 @@ export function MinimalNavbar({ config }: MinimalNavbarProps) {
         navigation={navigation}
         userMenu={config.userMenu}
         containerClassName={containerClassName}
+        controls={config.controls}
+        i18n={config.i18n}
       />
-    </ExternalPrefixesProvider>
+    </>
   );
 }