@djangocfg/nextjs 2.1.164 → 2.1.166

package/README.md

@@ -183,12 +183,18 @@ See [PWA.md](./PWA.md) for complete guide.
 
 Full next-intl integration for multilingual Next.js apps.
 
+> **Important:** Use subpath imports to avoid React Context issues in server components:
+> - `@djangocfg/nextjs/i18n` - Types only
+> - `@djangocfg/nextjs/i18n/routing` - `routing`, `createRouting`, `generateLocaleParams`
+> - `@djangocfg/nextjs/i18n/client` - `I18nProvider`, hooks
+> - `@djangocfg/nextjs/i18n/components` - `LocaleSwitcher`
+
 #### 1. Create middleware (proxy.ts)
 
 ```tsx
 // proxy.ts (or middleware.ts)
 import createMiddleware from 'next-intl/middleware';
-import { routing } from '@djangocfg/nextjs/i18n';
+import { routing } from '@djangocfg/nextjs/i18n/routing';
 
 export default createMiddleware(routing);
 
@@ -202,7 +208,8 @@ export const config = {
 ```tsx
 // i18n/request.ts
 import { getRequestConfig } from 'next-intl/server';
-import { en, ru, ko, mergeTranslations } from '@djangocfg/i18n';
+import { en, ru, ko } from '@djangocfg/i18n/locales';
+import { mergeTranslations } from '@djangocfg/i18n/utils';
 
 const locales = {
   en: mergeTranslations(en, { app: appEn }),
@@ -226,8 +233,13 @@ export default getRequestConfig(async ({ requestLocale }) => {
 
 ```tsx
 // app/[locale]/layout.tsx
-import { I18nProvider, routing } from '@djangocfg/nextjs/i18n';
 import { getMessages } from 'next-intl/server';
+import { I18nProvider } from '@djangocfg/nextjs/i18n/client';
+import { routing, generateLocaleParams } from '@djangocfg/nextjs/i18n/routing';
+
+export function generateStaticParams() {
+  return generateLocaleParams();
+}
 
 export default async function LocaleLayout({ children, params }) {
   const { locale } = await params;
@@ -420,10 +432,13 @@ import { RedirectPage } from '@djangocfg/layouts/components/RedirectPage';
 | Path | Description |
 |------|-------------|
 | `@djangocfg/nextjs` | Main exports (all modules) |
-| `@djangocfg/nextjs/i18n` | i18n routing, provider, utilities |
+| `@djangocfg/nextjs/i18n` | **Types only** (safe for server components) |
+| `@djangocfg/nextjs/i18n/routing` | `routing`, `createRouting`, `generateLocaleParams` |
+| `@djangocfg/nextjs/i18n/client` | `I18nProvider`, hooks (`'use client'`) |
 | `@djangocfg/nextjs/i18n/server` | Server-side i18n utilities |
-| `@djangocfg/nextjs/i18n/client` | Client-side i18n hooks |
-| `@djangocfg/nextjs/i18n/components` | LocaleSwitcher and i18n components |
+| `@djangocfg/nextjs/i18n/components` | `LocaleSwitcher` (`'use client'`) |
+| `@djangocfg/nextjs/i18n/proxy` | `createProxy` for middleware |
+| `@djangocfg/nextjs/i18n/navigation` | `Link`, `redirect`, `usePathname`, `useRouter` |
 | `@djangocfg/nextjs/ai` | AI documentation search and MCP config |
 | `@djangocfg/nextjs/config` | Base Next.js configuration factory |
 | `@djangocfg/nextjs/pwa` | PWA client utilities (service worker registration) |
@@ -464,12 +479,14 @@ createBaseNextConfig({
 
 ### i18n
 
+> **Subpath imports required** - see table below for correct import paths.
+
 #### `routing`
 
 Default routing configuration with locales `['en', 'ru', 'ko']` and default locale `'en'`.
 
 ```tsx
-import { routing } from '@djangocfg/nextjs/i18n';
+import { routing } from '@djangocfg/nextjs/i18n/routing';
 
 routing.locales      // ['en', 'ru', 'ko']
 routing.defaultLocale // 'en'
@@ -480,7 +497,7 @@ routing.defaultLocale // 'en'
 Create custom routing configuration.
 
 ```tsx
-import { createRouting } from '@djangocfg/nextjs/i18n';
+import { createRouting } from '@djangocfg/nextjs/i18n/routing';
 
 const routing = createRouting({
   locales: ['en', 'de', 'fr'],
@@ -491,10 +508,10 @@ const routing = createRouting({
 
 #### `I18nProvider`
 
-Provider component for next-intl integration.
+Provider component for next-intl integration (client component).
 
 ```tsx
-import { I18nProvider } from '@djangocfg/nextjs/i18n';
+import { I18nProvider } from '@djangocfg/nextjs/i18n/client';
 
 <I18nProvider locale="en" messages={messages}>
   {children}

package/dist/config/index.mjs

@@ -14,7 +14,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@djangocfg/nextjs",
-      version: "2.1.164",
+      version: "2.1.166",
       description: "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
       keywords: [
         "nextjs",