@djangocfg/nextjs 2.1.109 → 2.1.111

package/README.md

@@ -17,16 +17,16 @@
 
 ## Features
 
+- **i18n (Internationalization)** - Full next-intl integration with routing, middleware, and components
 - **Dev Server with Browser Auto-Open** - Cross-platform CLI that works with Turbopack and webpack
 - **Zero-Config PWA** - Progressive Web App out of the box (service worker, offline support, manifest)
 - **Base Next.js Config** - Universal, reusable Next.js configuration factory for monorepos
 - **AI Documentation** - Search DjangoCFG docs via MCP server and CLI
-- **Sitemap Generation** - Dynamic XML sitemap generation for SEO
+- **Sitemap Generation** - Dynamic XML sitemap with i18n hreflang support
 - **Health Checks** - Production-ready health monitoring endpoints
 - **OG Images** - Dynamic Open Graph image generation with templates
 - **Navigation Utilities** - Route definitions, menu generation, and navigation helpers
 - **TypeScript** - Full type safety throughout
-- **Server-Only** - No client-side code, pure server utilities
 
 ## Installation
 
@@ -314,16 +314,104 @@ curl -X POST http://localhost:3000/api/push/send \
 - Ready-to-use route handlers
 - Built-in subscription management
 
+### i18n (Internationalization)
+
+Full next-intl integration for multilingual Next.js apps.
+
+#### 1. Create middleware (proxy.ts)
+
+```tsx
+// proxy.ts (or middleware.ts)
+import createMiddleware from 'next-intl/middleware';
+import { routing } from '@djangocfg/nextjs/i18n';
+
+export default createMiddleware(routing);
+
+export const config = {
+  matcher: ['/((?!api|_next|_vercel|.*\\..*).*)',],
+};
+```
+
+#### 2. Create i18n request config
+
+```tsx
+// i18n/request.ts
+import { getRequestConfig } from 'next-intl/server';
+import { en, ru, ko, mergeTranslations } from '@djangocfg/i18n';
+
+const locales = {
+  en: mergeTranslations(en, { app: appEn }),
+  ru: mergeTranslations(ru, { app: appRu }),
+  ko: mergeTranslations(ko, { app: appKo }),
+};
+
+export default getRequestConfig(async ({ requestLocale }) => {
+  let locale = await requestLocale;
+  if (!locale || !(locale in locales)) locale = 'en';
+
+  return {
+    locale,
+    messages: locales[locale],
+    timeZone: 'UTC',
+  };
+});
+```
+
+#### 3. Use in layout
+
+```tsx
+// app/[locale]/layout.tsx
+import { I18nProvider, routing } from '@djangocfg/nextjs/i18n';
+import { getMessages } from 'next-intl/server';
+
+export default async function LocaleLayout({ children, params }) {
+  const { locale } = await params;
+  const messages = await getMessages();
+
+  return (
+    <I18nProvider locale={locale} messages={messages}>
+      {children}
+    </I18nProvider>
+  );
+}
+```
+
+#### 4. Use translations in components
+
+```tsx
+'use client';
+import { useTranslations } from 'next-intl';
+
+function MyComponent() {
+  const t = useTranslations('app');
+  return <h1>{t('title')}</h1>;
+}
+```
+
+#### Locale Switcher
+
+```tsx
+import { LocaleSwitcher } from '@djangocfg/nextjs/i18n/components';
+
+<LocaleSwitcher variant="outline" size="sm" />
+```
+
 ### Sitemap Generation
 
-Generate dynamic XML sitemaps for SEO:
+Generate dynamic XML sitemaps with i18n hreflang support:
 
 ```tsx
-// app/sitemap.ts
+// app/sitemap.xml/route.ts
 import { createSitemapHandler } from '@djangocfg/nextjs/sitemap';
+import { routing } from '@djangocfg/nextjs/i18n';
 
-export default createSitemapHandler({
+export const GET = createSitemapHandler({
   siteUrl: 'https://example.com',
+  // i18n support with hreflang tags
+  i18n: {
+    locales: routing.locales,
+    defaultLocale: routing.defaultLocale,
+  },
   staticPages: [
     { loc: '/', changefreq: 'daily', priority: 1.0 },
     { loc: '/about', changefreq: 'monthly', priority: 0.8 },
@@ -340,6 +428,20 @@ export default createSitemapHandler({
 });
 ```
 
+**Generated XML with hreflang:**
+
+```xml
+<url>
+  <loc>https://example.com/en/about</loc>
+  <xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/about"/>
+  <xhtml:link rel="alternate" hreflang="ru" href="https://example.com/ru/about"/>
+  <xhtml:link rel="alternate" hreflang="ko" href="https://example.com/ko/about"/>
+  <xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/en/about"/>
+  <changefreq>monthly</changefreq>
+  <priority>0.8</priority>
+</url>
+```
+
 ### Health Check Endpoint
 
 Create a health monitoring endpoint:
@@ -438,13 +540,17 @@ 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/server` | Server-side i18n utilities |
+| `@djangocfg/nextjs/i18n/client` | Client-side i18n hooks |
+| `@djangocfg/nextjs/i18n/components` | LocaleSwitcher and i18n components |
 | `@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, push subscriptions) |
 | `@djangocfg/nextjs/pwa/worker` | Service worker creation helpers |
 | `@djangocfg/nextjs/pwa/server` | Server-side push notification utilities |
 | `@djangocfg/nextjs/pwa/server/routes` | Ready-to-use API route handlers for push |
-| `@djangocfg/nextjs/sitemap` | Sitemap generation utilities |
+| `@djangocfg/nextjs/sitemap` | Sitemap generation with i18n hreflang support |
 | `@djangocfg/nextjs/health` | Health check handlers |
 | `@djangocfg/nextjs/og-image` | OG image generation |
 | `@djangocfg/nextjs/og-image/utils` | OG image URL and metadata utilities |
@@ -478,11 +584,64 @@ createBaseNextConfig({
 - Standard transpile packages for monorepo
 - Type-safe configuration merging
 
+### i18n
+
+#### `routing`
+
+Default routing configuration with locales `['en', 'ru', 'ko']` and default locale `'en'`.
+
+```tsx
+import { routing } from '@djangocfg/nextjs/i18n';
+
+routing.locales      // ['en', 'ru', 'ko']
+routing.defaultLocale // 'en'
+```
+
+#### `createRouting(config?)`
+
+Create custom routing configuration.
+
+```tsx
+import { createRouting } from '@djangocfg/nextjs/i18n';
+
+const routing = createRouting({
+  locales: ['en', 'de', 'fr'],
+  defaultLocale: 'en',
+  localePrefix: 'always', // 'always' | 'as-needed' | 'never'
+});
+```
+
+#### `I18nProvider`
+
+Provider component for next-intl integration.
+
+```tsx
+import { I18nProvider } from '@djangocfg/nextjs/i18n';
+
+<I18nProvider locale="en" messages={messages}>
+  {children}
+</I18nProvider>
+```
+
+#### `LocaleSwitcher`
+
+Ready-to-use locale switcher component.
+
+```tsx
+import { LocaleSwitcher } from '@djangocfg/nextjs/i18n/components';
+
+<LocaleSwitcher
+  variant="outline"
+  size="sm"
+  className="w-full"
+/>
+```
+
 ### Sitemap
 
 #### `createSitemapHandler(options)`
 
-Creates a Next.js route handler for sitemap generation.
+Creates a Next.js route handler for sitemap generation with optional i18n support.
 
 ```tsx
 createSitemapHandler({
@@ -490,9 +649,19 @@ createSitemapHandler({
   staticPages?: SitemapUrl[];
   dynamicPages?: SitemapUrl[] | (() => Promise<SitemapUrl[]>);
   cacheControl?: string;
+  // i18n support
+  i18n?: {
+    locales: string[];      // e.g., ['en', 'ru', 'ko']
+    defaultLocale: string;  // e.g., 'en'
+  };
 })
 ```
 
+When `i18n` is provided:
+- URLs are expanded for each locale (e.g., `/about` → `/en/about`, `/ru/about`, `/ko/about`)
+- `xhtml:link` elements with `hreflang` are added for SEO
+- `x-default` points to the default locale
+
 ### Health
 
 #### `createHealthHandler(config)`

package/dist/config/index.d.mts

@@ -1,7 +1,9 @@
 import { NextConfig } from 'next';
 import { Configuration, Compiler } from 'webpack';
+import { a as I18nPluginOptions } from '../types-Cy349X20.mjs';
 import { P as PWAPluginOptions } from '../plugin-DuRJ_Jq6.mjs';
 export { A as AI_DOCS_HINT, b as MCP_API_URL, M as MCP_BASE_URL, a as MCP_SERVER_URL } from '../constants-HezbftFb.mjs';
+import '@djangocfg/i18n';
 
 /**
  * Base Next.js Configuration Factory
@@ -54,6 +56,19 @@ interface BaseNextConfigOptions {
      * @default { enabled: true (in production), disable: true (in development) }
      */
     pwa?: PWAPluginOptions | false;
+    /**
+     * i18n configuration options for internationalization
+     * Enables URL-based locale routing (e.g., /en/about, /ru/about)
+     *
+     * @example
+     * ```ts
+     * i18n: {
+     *   locales: ['en', 'ru', 'ko'],
+     *   defaultLocale: 'en',
+     * }
+     * ```
+     */
+    i18n?: I18nPluginOptions;
     /** Turbopack configuration (Next.js 16+ default bundler) */
     turbopack?: NextConfig['turbopack'];
     /** Custom webpack configuration function (called after base webpack logic) */
@@ -89,7 +104,7 @@ declare function createBaseNextConfig(options?: BaseNextConfigOptions): NextConf
 declare const PACKAGE_NAME = "@djangocfg/nextjs";
 declare const DJANGO_CFG_BANNER = "\n\u2588\u2588\u2588\u2588\u2588\u2588\u2557      \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2557   \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557      \u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557\n\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557     \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D \u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557    \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\n\u2588\u2588\u2551  \u2588\u2588\u2551     \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551    \u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551  \u2588\u2588\u2588\u2557\n\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551    \u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551   \u2588\u2588\u2551\n\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u255A\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D    \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551     \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\n\u255A\u2550\u2550\u2550\u2550\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D  \u255A\u2550\u2550\u2550\u2550\u2550\u255D      \u255A\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D      \u255A\u2550\u2550\u2550\u2550\u2550\u255D\n";
 declare const DJANGOCFG_PACKAGES: readonly ["@djangocfg/ui-core", "@djangocfg/ui-nextjs", "@djangocfg/layouts", "@djangocfg/nextjs", "@djangocfg/api", "@djangocfg/centrifugo", "@djangocfg/eslint-config", "@djangocfg/typescript-config"];
-declare const DEFAULT_TRANSPILE_PACKAGES: readonly ["@djangocfg/ui-core", "@djangocfg/ui-nextjs", "@djangocfg/layouts", "@djangocfg/ui-tools", "@djangocfg/api", "@djangocfg/centrifugo"];
+declare const DEFAULT_TRANSPILE_PACKAGES: readonly ["@djangocfg/i18n", "@djangocfg/ui-core", "@djangocfg/ui-nextjs", "@djangocfg/layouts", "@djangocfg/ui-tools", "@djangocfg/api", "@djangocfg/centrifugo"];
 declare const DEFAULT_OPTIMIZE_PACKAGES: readonly ["@djangocfg/ui-core", "@djangocfg/ui-nextjs", "@djangocfg/layouts", "lucide-react", "recharts"];
 
 /**

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.109",
+      version: "2.1.111",
       description: "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
       keywords: [
         "nextjs",
@@ -112,6 +112,46 @@ var require_package = __commonJS({
           types: "./dist/pwa/server/routes.d.mts",
           import: "./dist/pwa/server/routes.mjs",
           default: "./dist/pwa/server/routes.mjs"
+        },
+        "./i18n": {
+          types: "./dist/i18n/index.d.mts",
+          import: "./dist/i18n/index.mjs",
+          default: "./dist/i18n/index.mjs"
+        },
+        "./i18n/server": {
+          types: "./dist/i18n/server.d.mts",
+          import: "./dist/i18n/server.mjs",
+          default: "./dist/i18n/server.mjs"
+        },
+        "./i18n/client": {
+          types: "./dist/i18n/client.d.mts",
+          import: "./dist/i18n/client.mjs",
+          default: "./dist/i18n/client.mjs"
+        },
+        "./i18n/proxy": {
+          types: "./dist/i18n/proxy.d.mts",
+          import: "./dist/i18n/proxy.mjs",
+          default: "./dist/i18n/proxy.mjs"
+        },
+        "./i18n/navigation": {
+          types: "./dist/i18n/navigation.d.mts",
+          import: "./dist/i18n/navigation.mjs",
+          default: "./dist/i18n/navigation.mjs"
+        },
+        "./i18n/routing": {
+          types: "./dist/i18n/routing.d.mts",
+          import: "./dist/i18n/routing.mjs",
+          default: "./dist/i18n/routing.mjs"
+        },
+        "./i18n/request": {
+          types: "./dist/i18n/request.d.mts",
+          import: "./dist/i18n/request.mjs",
+          default: "./dist/i18n/request.mjs"
+        },
+        "./i18n/components": {
+          types: "./dist/i18n/components.d.mts",
+          import: "./dist/i18n/components.mjs",
+          default: "./dist/i18n/components.mjs"
         }
       },
       files: [
@@ -134,19 +174,29 @@ var require_package = __commonJS({
         pwa: "tsx src/pwa/cli.ts"
       },
       peerDependencies: {
+        "@djangocfg/i18n": "workspace:*",
+        "@djangocfg/ui-core": "workspace:*",
         next: "^16.0.10"
       },
+      peerDependenciesMeta: {
+        "@djangocfg/ui-core": {
+          optional: true
+        }
+      },
       dependencies: {
         "@serwist/next": "^9.2.3",
         "@serwist/sw": "^9.2.3",
         chalk: "^5.3.0",
         conf: "^15.0.2",
         consola: "^3.4.2",
+        "next-intl": "^4.1.0",
         semver: "^7.7.3",
         serwist: "^9.2.3",
         "web-push": "^3.6.7"
       },
       devDependencies: {
+        "@djangocfg/i18n": "workspace:*",
+        "@djangocfg/ui-core": "workspace:*",
         "@djangocfg/imgai": "workspace:*",
         "@djangocfg/layouts": "workspace:*",
         "@djangocfg/typescript-config": "workspace:*",
@@ -170,6 +220,18 @@ var require_package = __commonJS({
   }
 });
 
+// src/i18n/plugin.ts
+import createNextIntlPlugin from "next-intl/plugin";
+function createI18nPlugin(options) {
+  const requestConfigPath = options?.requestConfig ?? "./i18n/request.ts";
+  const withNextIntl = createNextIntlPlugin(requestConfigPath);
+  return withNextIntl;
+}
+function withI18n(config, options) {
+  const plugin = createI18nPlugin(options);
+  return plugin(config);
+}
+
 // src/pwa/plugin.ts
 import { consola } from "consola";
 function withPWA(nextConfig, options = {}) {
@@ -226,6 +288,7 @@ var DJANGOCFG_PACKAGES = [
   "@djangocfg/typescript-config"
 ];
 var DEFAULT_TRANSPILE_PACKAGES = [
+  "@djangocfg/i18n",
   "@djangocfg/ui-core",
   "@djangocfg/ui-nextjs",
   "@djangocfg/layouts",
@@ -1379,20 +1442,26 @@ function createBaseNextConfig(options = {}) {
       return config;
     }
   };
-  let finalConfig = deepMerge(baseConfig, options);
-  delete finalConfig.optimizePackageImports;
-  delete finalConfig.isDefaultCfgAdmin;
-  delete finalConfig.checkUpdates;
-  delete finalConfig.autoUpdate;
-  delete finalConfig.forceCheckWorkspace;
-  delete finalConfig.checkPackages;
-  delete finalConfig.autoInstall;
-  delete finalConfig.allowIframeFrom;
-  delete finalConfig.openBrowser;
-  if (options.pwa) {
-    finalConfig = withPWA(finalConfig, options.pwa);
+  const {
+    i18n: i18nOptions,
+    pwa: pwaOptions,
+    optimizePackageImports,
+    isDefaultCfgAdmin,
+    checkUpdates,
+    autoUpdate,
+    forceCheckWorkspace,
+    checkPackages: checkPackages2,
+    autoInstall,
+    allowIframeFrom,
+    ...nextConfigOptions
+  } = options;
+  let finalConfig = deepMerge(baseConfig, nextConfigOptions);
+  if (pwaOptions) {
+    finalConfig = withPWA(finalConfig, pwaOptions);
+  }
+  if (i18nOptions) {
+    finalConfig = withI18n(finalConfig, i18nOptions);
   }
-  delete finalConfig.pwa;
   return finalConfig;
 }
 export {