@djangocfg/nextjs 2.1.109 → 2.1.111

package/dist/sitemap/index.d.mts

@@ -5,11 +5,19 @@ import { S as SitemapUrl, C as ChangeFreq } from '../types-CwhXnEbK.mjs';
  * Sitemap types
  */
 
+interface SitemapI18nOptions {
+    /** Supported locales (e.g., ['en', 'ru', 'ko']) */
+    locales: string[];
+    /** Default locale for x-default hreflang */
+    defaultLocale: string;
+}
 interface SitemapGeneratorOptions {
     siteUrl: string;
     staticPages?: SitemapUrl[];
     dynamicPages?: (() => Promise<SitemapUrl[]>) | SitemapUrl[];
     cacheControl?: string;
+    /** i18n configuration for hreflang support */
+    i18n?: SitemapI18nOptions;
 }
 interface SitemapRoute {
     path: string;
@@ -33,7 +41,6 @@ interface SitemapRoute {
  *     { loc: '/about', changefreq: 'monthly', priority: 0.8 },
  *   ],
  *   dynamicPages: async () => {
- *     // Fetch dynamic pages from API
  *     const posts = await fetchPosts();
  *     return posts.map(post => ({
  *       loc: `/posts/${post.slug}`,
@@ -42,6 +49,11 @@ interface SitemapRoute {
  *       priority: 0.7,
  *     }));
  *   },
+ *   // i18n support with hreflang
+ *   i18n: {
+ *     locales: ['en', 'ru', 'ko'],
+ *     defaultLocale: 'en',
+ *   },
  * });
  * ```
  */
@@ -52,15 +64,22 @@ declare function createSitemapHandler(options: SitemapGeneratorOptions): () => P
  * Sitemap Generator
  *
  * Generates XML sitemap from configuration
+ * Supports i18n with hreflang tags for multilingual sites
  */
 
+interface GenerateSitemapXmlOptions {
+    urls: SitemapUrl[];
+    i18n?: SitemapI18nOptions;
+    siteUrl: string;
+}
 /**
  * Generate XML sitemap string from URLs
+ * Supports i18n with hreflang alternate links
  */
-declare function generateSitemapXml(urls: SitemapUrl[]): string;
+declare function generateSitemapXml(urlsOrOptions: SitemapUrl[] | GenerateSitemapXmlOptions): string;
 /**
  * Normalize URL (ensure absolute)
  */
 declare function normalizeUrl(url: string, siteUrl: string): string;
 
-export { type SitemapGeneratorOptions, type SitemapRoute, createSitemapHandler, generateSitemapXml, normalizeUrl };
+export { type SitemapGeneratorOptions, type SitemapI18nOptions, type SitemapRoute, createSitemapHandler, generateSitemapXml, normalizeUrl };

package/dist/sitemap/index.mjs

@@ -2,22 +2,58 @@
 import { NextResponse } from "next/server";
 
 // src/sitemap/generator.ts
-function generateSitemapXml(urls) {
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
+function generateSitemapXml(urlsOrOptions) {
+  const isOptionsObject = !Array.isArray(urlsOrOptions);
+  const urls = isOptionsObject ? urlsOrOptions.urls : urlsOrOptions;
+  const i18n = isOptionsObject ? urlsOrOptions.i18n : void 0;
+  const siteUrl = isOptionsObject ? urlsOrOptions.siteUrl : "";
+  const namespaces = i18n ? `xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
+        xmlns:xhtml="http://www.w3.org/1999/xhtml"
+        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9
+        http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd"` : `xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9
-        http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd">
-${urls.map(
-    ({ loc, lastmod, changefreq, priority }) => `  <url>
-    <loc>${escapeXml(loc)}</loc>
+        http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd"`;
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset ${namespaces}>
+${urls.map(({ loc, lastmod, changefreq, priority }) => {
+    const hreflangLinks = i18n ? generateHreflangLinks(loc, i18n, siteUrl) : "";
+    return `  <url>
+    <loc>${escapeXml(loc)}</loc>${hreflangLinks}
     ${lastmod ? `<lastmod>${formatDate(lastmod)}</lastmod>` : ""}
     ${changefreq ? `<changefreq>${changefreq}</changefreq>` : ""}
     ${priority !== void 0 ? `<priority>${priority.toFixed(1)}</priority>` : ""}
-  </url>`
-  ).join("\n")}
+  </url>`;
+  }).join("\n")}
 </urlset>`;
 }
+function generateHreflangLinks(loc, i18n, siteUrl) {
+  const { locales, defaultLocale } = i18n;
+  const baseSiteUrl = siteUrl.endsWith("/") ? siteUrl.slice(0, -1) : siteUrl;
+  let path = loc.replace(baseSiteUrl, "");
+  for (const locale of locales) {
+    const localePrefix = `/${locale}`;
+    if (path === localePrefix || path.startsWith(`${localePrefix}/`)) {
+      path = path.slice(localePrefix.length) || "/";
+      break;
+    }
+  }
+  const links = [];
+  for (const locale of locales) {
+    const localePath = path === "/" ? `/${locale}` : `/${locale}${path}`;
+    const fullUrl = `${baseSiteUrl}${localePath}`;
+    links.push(
+      `    <xhtml:link rel="alternate" hreflang="${locale}" href="${escapeXml(fullUrl)}"/>`
+    );
+  }
+  const defaultPath = path === "/" ? `/${defaultLocale}` : `/${defaultLocale}${path}`;
+  const defaultUrl = `${baseSiteUrl}${defaultPath}`;
+  links.push(
+    `    <xhtml:link rel="alternate" hreflang="x-default" href="${escapeXml(defaultUrl)}"/>`
+  );
+  return "\n" + links.join("\n");
+}
 function formatDate(date) {
   if (typeof date === "string") {
     return date;
@@ -42,7 +78,8 @@ function createSitemapHandler(options) {
     siteUrl,
     staticPages = [],
     dynamicPages = [],
-    cacheControl = "public, s-maxage=86400, stale-while-revalidate"
+    cacheControl = "public, s-maxage=86400, stale-while-revalidate",
+    i18n
   } = options;
   return async function GET() {
     const urls = [...staticPages];
@@ -54,11 +91,20 @@ function createSitemapHandler(options) {
         urls.push(...dynamicPages);
       }
     }
-    const normalizedUrls = urls.map((url) => ({
-      ...url,
-      loc: normalizeUrl(url.loc, siteUrl)
-    }));
-    const sitemap = generateSitemapXml(normalizedUrls);
+    let expandedUrls;
+    if (i18n) {
+      expandedUrls = expandUrlsForLocales(urls, i18n.locales, siteUrl);
+    } else {
+      expandedUrls = urls.map((url) => ({
+        ...url,
+        loc: normalizeUrl(url.loc, siteUrl)
+      }));
+    }
+    const sitemap = generateSitemapXml({
+      urls: expandedUrls,
+      i18n,
+      siteUrl
+    });
     return new NextResponse(sitemap, {
       status: 200,
       headers: {
@@ -68,6 +114,37 @@ function createSitemapHandler(options) {
     });
   };
 }
+function expandUrlsForLocales(urls, locales, siteUrl) {
+  const baseSiteUrl = siteUrl.endsWith("/") ? siteUrl.slice(0, -1) : siteUrl;
+  const expandedUrls = [];
+  for (const url of urls) {
+    let path = url.loc;
+    if (path.startsWith(baseSiteUrl)) {
+      path = path.replace(baseSiteUrl, "");
+    }
+    if (!path.startsWith("/")) {
+      path = "/" + path;
+    }
+    const hasLocalePrefix = locales.some(
+      (locale) => path === `/${locale}` || path.startsWith(`/${locale}/`)
+    );
+    if (hasLocalePrefix) {
+      expandedUrls.push({
+        ...url,
+        loc: normalizeUrl(path, siteUrl)
+      });
+    } else {
+      for (const locale of locales) {
+        const localePath = path === "/" ? `/${locale}` : `/${locale}${path}`;
+        expandedUrls.push({
+          ...url,
+          loc: `${baseSiteUrl}${localePath}`
+        });
+      }
+    }
+  }
+  return expandedUrls;
+}
 export {
   createSitemapHandler,
   generateSitemapXml,

package/dist/sitemap/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/sitemap/route.ts","../../src/sitemap/generator.ts"],"sourcesContent":["/**\n * Sitemap Route Handler for Next.js App Router\n *\n * Usage:\n * ```tsx\n * // app/sitemap.ts\n * import { createSitemapHandler } from '@djangocfg/nextjs/sitemap';\n *\n * export default createSitemapHandler({\n *   siteUrl: 'https://example.com',\n *   staticPages: [\n *     { loc: '/', changefreq: 'daily', priority: 1.0 },\n *     { loc: '/about', changefreq: 'monthly', priority: 0.8 },\n *   ],\n *   dynamicPages: async () => {\n *     // Fetch dynamic pages from API\n *     const posts = await fetchPosts();\n *     return posts.map(post => ({\n *       loc: `/posts/${post.slug}`,\n *       lastmod: post.updatedAt,\n *       changefreq: 'weekly',\n *       priority: 0.7,\n *     }));\n *   },\n * });\n * ```\n */\n\nimport { NextResponse } from 'next/server';\n\nimport { generateSitemapXml, normalizeUrl } from './generator';\n\nimport type { SitemapGeneratorOptions } from './types';\nimport type { SitemapUrl } from '../types';\n\nexport function createSitemapHandler(options: SitemapGeneratorOptions) {\n  const {\n    siteUrl,\n    staticPages = [],\n    dynamicPages = [],\n    cacheControl = 'public, s-maxage=86400, stale-while-revalidate',\n  } = options;\n\n  return async function GET() {\n    const urls: SitemapUrl[] = [...staticPages];\n\n    // Add dynamic pages\n    if (dynamicPages) {\n      if (typeof dynamicPages === 'function') {\n        const dynamicUrls = await dynamicPages();\n        urls.push(...dynamicUrls);\n      } else {\n        urls.push(...dynamicPages);\n      }\n    }\n\n    // Normalize all URLs\n    const normalizedUrls = urls.map((url) => ({\n      ...url,\n      loc: normalizeUrl(url.loc, siteUrl),\n    }));\n\n    // Generate XML\n    const sitemap = generateSitemapXml(normalizedUrls);\n\n    // Return response\n    return new NextResponse(sitemap, {\n      status: 200,\n      headers: {\n        'Content-Type': 'application/xml',\n        'Cache-Control': cacheControl,\n      },\n    });\n  };\n}\n\n","/**\n * Sitemap Generator\n *\n * Generates XML sitemap from configuration\n */\n\nimport type { SitemapUrl } from '../types';\n\n/**\n * Generate XML sitemap string from URLs\n */\nexport function generateSitemapXml(urls: SitemapUrl[]): string {\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\"\n        xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n        xsi:schemaLocation=\"http://www.sitemaps.org/schemas/sitemap/0.9\n        http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd\">\n${urls\n  .map(\n    ({ loc, lastmod, changefreq, priority }) => `  <url>\n    <loc>${escapeXml(loc)}</loc>\n    ${lastmod ? `<lastmod>${formatDate(lastmod)}</lastmod>` : ''}\n    ${changefreq ? `<changefreq>${changefreq}</changefreq>` : ''}\n    ${priority !== undefined ? `<priority>${priority.toFixed(1)}</priority>` : ''}\n  </url>`\n  )\n  .join('\\n')}\n</urlset>`;\n}\n\n/**\n * Format date for sitemap (ISO 8601)\n */\nfunction formatDate(date: string | Date): string {\n  if (typeof date === 'string') {\n    return date;\n  }\n  return date.toISOString().split('T')[0];\n}\n\n/**\n * Escape XML special characters\n */\nfunction escapeXml(unsafe: string): string {\n  return unsafe\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&apos;');\n}\n\n/**\n * Normalize URL (ensure absolute)\n */\nexport function normalizeUrl(url: string, siteUrl: string): string {\n  if (url.startsWith('http://') || url.startsWith('https://')) {\n    return url;\n  }\n  const baseUrl = siteUrl.endsWith('/') ? siteUrl.slice(0, -1) : siteUrl;\n  const path = url.startsWith('/') ? url : `/${url}`;\n  return `${baseUrl}${path}`;\n}\n\n"],"mappings":";AA4BA,SAAS,oBAAoB;;;ACjBtB,SAAS,mBAAmB,MAA4B;AAC7D,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA,EAKP,KACC;AAAA,IACC,CAAC,EAAE,KAAK,SAAS,YAAY,SAAS,MAAM;AAAA,WACrC,UAAU,GAAG,CAAC;AAAA,MACnB,UAAU,YAAY,WAAW,OAAO,CAAC,eAAe,EAAE;AAAA,MAC1D,aAAa,eAAe,UAAU,kBAAkB,EAAE;AAAA,MAC1D,aAAa,SAAY,aAAa,SAAS,QAAQ,CAAC,CAAC,gBAAgB,EAAE;AAAA;AAAA,EAE/E,EACC,KAAK,IAAI,CAAC;AAAA;AAEb;AAKA,SAAS,WAAW,MAA6B;AAC/C,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO;AAAA,EACT;AACA,SAAO,KAAK,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC;AACxC;AAKA,SAAS,UAAU,QAAwB;AACzC,SAAO,OACJ,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,QAAQ,EACtB,QAAQ,MAAM,QAAQ;AAC3B;AAKO,SAAS,aAAa,KAAa,SAAyB;AACjE,MAAI,IAAI,WAAW,SAAS,KAAK,IAAI,WAAW,UAAU,GAAG;AAC3D,WAAO;AAAA,EACT;AACA,QAAM,UAAU,QAAQ,SAAS,GAAG,IAAI,QAAQ,MAAM,GAAG,EAAE,IAAI;AAC/D,QAAM,OAAO,IAAI,WAAW,GAAG,IAAI,MAAM,IAAI,GAAG;AAChD,SAAO,GAAG,OAAO,GAAG,IAAI;AAC1B;;;AD3BO,SAAS,qBAAqB,SAAkC;AACrE,QAAM;AAAA,IACJ;AAAA,IACA,cAAc,CAAC;AAAA,IACf,eAAe,CAAC;AAAA,IAChB,eAAe;AAAA,EACjB,IAAI;AAEJ,SAAO,eAAe,MAAM;AAC1B,UAAM,OAAqB,CAAC,GAAG,WAAW;AAG1C,QAAI,cAAc;AAChB,UAAI,OAAO,iBAAiB,YAAY;AACtC,cAAM,cAAc,MAAM,aAAa;AACvC,aAAK,KAAK,GAAG,WAAW;AAAA,MAC1B,OAAO;AACL,aAAK,KAAK,GAAG,YAAY;AAAA,MAC3B;AAAA,IACF;AAGA,UAAM,iBAAiB,KAAK,IAAI,CAAC,SAAS;AAAA,MACxC,GAAG;AAAA,MACH,KAAK,aAAa,IAAI,KAAK,OAAO;AAAA,IACpC,EAAE;AAGF,UAAM,UAAU,mBAAmB,cAAc;AAGjD,WAAO,IAAI,aAAa,SAAS;AAAA,MAC/B,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,iBAAiB;AAAA,MACnB;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":[]}
+{"version":3,"sources":["../../src/sitemap/route.ts","../../src/sitemap/generator.ts"],"sourcesContent":["/**\n * Sitemap Route Handler for Next.js App Router\n *\n * Usage:\n * ```tsx\n * // app/sitemap.ts\n * import { createSitemapHandler } from '@djangocfg/nextjs/sitemap';\n *\n * export default createSitemapHandler({\n *   siteUrl: 'https://example.com',\n *   staticPages: [\n *     { loc: '/', changefreq: 'daily', priority: 1.0 },\n *     { loc: '/about', changefreq: 'monthly', priority: 0.8 },\n *   ],\n *   dynamicPages: async () => {\n *     const posts = await fetchPosts();\n *     return posts.map(post => ({\n *       loc: `/posts/${post.slug}`,\n *       lastmod: post.updatedAt,\n *       changefreq: 'weekly',\n *       priority: 0.7,\n *     }));\n *   },\n *   // i18n support with hreflang\n *   i18n: {\n *     locales: ['en', 'ru', 'ko'],\n *     defaultLocale: 'en',\n *   },\n * });\n * ```\n */\n\nimport { NextResponse } from 'next/server';\n\nimport { generateSitemapXml, normalizeUrl } from './generator';\n\nimport type { SitemapGeneratorOptions } from './types';\nimport type { SitemapUrl } from '../types';\n\nexport function createSitemapHandler(options: SitemapGeneratorOptions) {\n  const {\n    siteUrl,\n    staticPages = [],\n    dynamicPages = [],\n    cacheControl = 'public, s-maxage=86400, stale-while-revalidate',\n    i18n,\n  } = options;\n\n  return async function GET() {\n    const urls: SitemapUrl[] = [...staticPages];\n\n    // Add dynamic pages\n    if (dynamicPages) {\n      if (typeof dynamicPages === 'function') {\n        const dynamicUrls = await dynamicPages();\n        urls.push(...dynamicUrls);\n      } else {\n        urls.push(...dynamicPages);\n      }\n    }\n\n    // Expand URLs for each locale if i18n is enabled\n    let expandedUrls: SitemapUrl[];\n    if (i18n) {\n      expandedUrls = expandUrlsForLocales(urls, i18n.locales, siteUrl);\n    } else {\n      expandedUrls = urls.map((url) => ({\n        ...url,\n        loc: normalizeUrl(url.loc, siteUrl),\n      }));\n    }\n\n    // Generate XML with i18n support\n    const sitemap = generateSitemapXml({\n      urls: expandedUrls,\n      i18n,\n      siteUrl,\n    });\n\n    // Return response\n    return new NextResponse(sitemap, {\n      status: 200,\n      headers: {\n        'Content-Type': 'application/xml',\n        'Cache-Control': cacheControl,\n      },\n    });\n  };\n}\n\n/**\n * Expand URLs to include all locale variants\n * Input: [{ loc: '/page' }] with locales ['en', 'ru']\n * Output: [{ loc: 'https://example.com/en/page' }, { loc: 'https://example.com/ru/page' }]\n */\nfunction expandUrlsForLocales(\n  urls: SitemapUrl[],\n  locales: string[],\n  siteUrl: string\n): SitemapUrl[] {\n  const baseSiteUrl = siteUrl.endsWith('/') ? siteUrl.slice(0, -1) : siteUrl;\n  const expandedUrls: SitemapUrl[] = [];\n\n  for (const url of urls) {\n    // Normalize the path (remove leading slash if present for consistency)\n    let path = url.loc;\n    if (path.startsWith(baseSiteUrl)) {\n      path = path.replace(baseSiteUrl, '');\n    }\n    if (!path.startsWith('/')) {\n      path = '/' + path;\n    }\n\n    // Check if the path already has a locale prefix\n    const hasLocalePrefix = locales.some(\n      (locale) => path === `/${locale}` || path.startsWith(`/${locale}/`)\n    );\n\n    if (hasLocalePrefix) {\n      // URL already has locale prefix, just normalize it\n      expandedUrls.push({\n        ...url,\n        loc: normalizeUrl(path, siteUrl),\n      });\n    } else {\n      // Create a URL for each locale\n      for (const locale of locales) {\n        const localePath = path === '/' ? `/${locale}` : `/${locale}${path}`;\n        expandedUrls.push({\n          ...url,\n          loc: `${baseSiteUrl}${localePath}`,\n        });\n      }\n    }\n  }\n\n  return expandedUrls;\n}\n\n","/**\n * Sitemap Generator\n *\n * Generates XML sitemap from configuration\n * Supports i18n with hreflang tags for multilingual sites\n */\n\nimport type { SitemapUrl } from '../types';\nimport type { SitemapI18nOptions } from './types';\n\nexport interface GenerateSitemapXmlOptions {\n  urls: SitemapUrl[];\n  i18n?: SitemapI18nOptions;\n  siteUrl: string;\n}\n\n/**\n * Generate XML sitemap string from URLs\n * Supports i18n with hreflang alternate links\n */\nexport function generateSitemapXml(\n  urlsOrOptions: SitemapUrl[] | GenerateSitemapXmlOptions\n): string {\n  // Support both old signature (just urls) and new signature (options object)\n  const isOptionsObject = !Array.isArray(urlsOrOptions);\n  const urls = isOptionsObject ? urlsOrOptions.urls : urlsOrOptions;\n  const i18n = isOptionsObject ? urlsOrOptions.i18n : undefined;\n  const siteUrl = isOptionsObject ? urlsOrOptions.siteUrl : '';\n\n  // Add xhtml namespace if i18n is enabled\n  const namespaces = i18n\n    ? `xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\"\n        xmlns:xhtml=\"http://www.w3.org/1999/xhtml\"\n        xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n        xsi:schemaLocation=\"http://www.sitemaps.org/schemas/sitemap/0.9\n        http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd\"`\n    : `xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\"\n        xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"\n        xsi:schemaLocation=\"http://www.sitemaps.org/schemas/sitemap/0.9\n        http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd\"`;\n\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset ${namespaces}>\n${urls\n  .map(({ loc, lastmod, changefreq, priority }) => {\n    const hreflangLinks = i18n\n      ? generateHreflangLinks(loc, i18n, siteUrl)\n      : '';\n\n    return `  <url>\n    <loc>${escapeXml(loc)}</loc>${hreflangLinks}\n    ${lastmod ? `<lastmod>${formatDate(lastmod)}</lastmod>` : ''}\n    ${changefreq ? `<changefreq>${changefreq}</changefreq>` : ''}\n    ${priority !== undefined ? `<priority>${priority.toFixed(1)}</priority>` : ''}\n  </url>`;\n  })\n  .join('\\n')}\n</urlset>`;\n}\n\n/**\n * Generate hreflang links for a URL\n */\nfunction generateHreflangLinks(\n  loc: string,\n  i18n: SitemapI18nOptions,\n  siteUrl: string\n): string {\n  const { locales, defaultLocale } = i18n;\n\n  // Extract the path without locale prefix from the URL\n  // e.g., https://example.com/en/page -> /page\n  const baseSiteUrl = siteUrl.endsWith('/') ? siteUrl.slice(0, -1) : siteUrl;\n  let path = loc.replace(baseSiteUrl, '');\n\n  // Remove locale prefix if present\n  for (const locale of locales) {\n    const localePrefix = `/${locale}`;\n    if (path === localePrefix || path.startsWith(`${localePrefix}/`)) {\n      path = path.slice(localePrefix.length) || '/';\n      break;\n    }\n  }\n\n  const links: string[] = [];\n\n  // Add hreflang for each locale\n  for (const locale of locales) {\n    const localePath = path === '/' ? `/${locale}` : `/${locale}${path}`;\n    const fullUrl = `${baseSiteUrl}${localePath}`;\n    links.push(\n      `    <xhtml:link rel=\"alternate\" hreflang=\"${locale}\" href=\"${escapeXml(fullUrl)}\"/>`\n    );\n  }\n\n  // Add x-default pointing to default locale\n  const defaultPath = path === '/' ? `/${defaultLocale}` : `/${defaultLocale}${path}`;\n  const defaultUrl = `${baseSiteUrl}${defaultPath}`;\n  links.push(\n    `    <xhtml:link rel=\"alternate\" hreflang=\"x-default\" href=\"${escapeXml(defaultUrl)}\"/>`\n  );\n\n  return '\\n' + links.join('\\n');\n}\n\n/**\n * Format date for sitemap (ISO 8601)\n */\nfunction formatDate(date: string | Date): string {\n  if (typeof date === 'string') {\n    return date;\n  }\n  return date.toISOString().split('T')[0];\n}\n\n/**\n * Escape XML special characters\n */\nfunction escapeXml(unsafe: string): string {\n  return unsafe\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&apos;');\n}\n\n/**\n * Normalize URL (ensure absolute)\n */\nexport function normalizeUrl(url: string, siteUrl: string): string {\n  if (url.startsWith('http://') || url.startsWith('https://')) {\n    return url;\n  }\n  const baseUrl = siteUrl.endsWith('/') ? siteUrl.slice(0, -1) : siteUrl;\n  const path = url.startsWith('/') ? url : `/${url}`;\n  return `${baseUrl}${path}`;\n}\n\n"],"mappings":"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","names":[]}

package/dist/types-Cy349X20.d.mts

@@ -0,0 +1,60 @@
+import { LocaleCode, I18nTranslations } from '@djangocfg/i18n';
+
+/**
+ * i18n Types for Next.js App Router
+ *
+ * Integrates next-intl with @djangocfg/i18n
+ */
+
+interface I18nConfig {
+    /** Supported locales */
+    locales: LocaleCode[];
+    /** Default locale (fallback) */
+    defaultLocale: LocaleCode;
+    /** Locale prefix strategy */
+    localePrefix?: 'always' | 'as-needed' | 'never';
+    /** Cookie name for locale preference */
+    cookieName?: string;
+    /** Paths to exclude from locale routing (e.g., '/api', '/_next') */
+    excludedPaths?: string[];
+}
+interface I18nPluginOptions extends I18nConfig {
+    /** Path to i18n request config file (default: './src/i18n/request.ts' or './i18n/request.ts') */
+    requestConfig?: string;
+}
+/** Messages structure - compatible with next-intl */
+type Messages = I18nTranslations & {
+    [namespace: string]: Record<string, unknown>;
+};
+/** Locale-specific messages loader */
+type MessagesLoader = (locale: LocaleCode) => Promise<Messages> | Messages;
+/** Extension translations that can be merged */
+interface ExtensionMessages {
+    namespace: string;
+    messages: Record<LocaleCode, Record<string, unknown>>;
+}
+interface I18nProviderProps {
+    /** Current locale */
+    locale: LocaleCode;
+    /** Translation messages */
+    messages: Messages;
+    /** Time zone for date/time formatting */
+    timeZone?: string;
+    /** Now value for relative time */
+    now?: Date;
+    /** Children */
+    children: React.ReactNode;
+}
+interface LocaleParams {
+    locale: string;
+}
+interface LocaleLayoutProps {
+    children: React.ReactNode;
+    params: Promise<LocaleParams>;
+}
+interface LocalePageProps {
+    params: Promise<LocaleParams>;
+    searchParams?: Promise<Record<string, string | string[] | undefined>>;
+}
+
+export type { ExtensionMessages as E, I18nConfig as I, LocaleParams as L, Messages as M, I18nPluginOptions as a, I18nProviderProps as b, MessagesLoader as c, LocaleLayoutProps as d, LocalePageProps as e };

package/package.json

@@ -1,6 +1,6 @@
 {
   "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",
@@ -98,6 +98,46 @@
       "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": [
@@ -120,22 +160,32 @@
     "pwa": "tsx src/pwa/cli.ts"
   },
   "peerDependencies": {
+    "@djangocfg/i18n": "^2.1.111",
+    "@djangocfg/ui-core": "^2.1.111",
     "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/imgai": "^2.1.109",
-    "@djangocfg/layouts": "^2.1.109",
-    "@djangocfg/typescript-config": "^2.1.109",
+    "@djangocfg/i18n": "^2.1.111",
+    "@djangocfg/ui-core": "^2.1.111",
+    "@djangocfg/imgai": "^2.1.111",
+    "@djangocfg/layouts": "^2.1.111",
+    "@djangocfg/typescript-config": "^2.1.111",
     "@types/node": "^24.7.2",
     "@types/react": "19.2.2",
     "@types/react-dom": "19.2.1",

package/src/config/constants.ts

@@ -33,6 +33,7 @@ export const DJANGOCFG_PACKAGES = [
 // Default packages to transpile
 // Required for proper RSC (React Server Components) handling
 export const DEFAULT_TRANSPILE_PACKAGES = [
+  '@djangocfg/i18n',
   '@djangocfg/ui-core',
   '@djangocfg/ui-nextjs',
   '@djangocfg/layouts',

package/src/config/createNextConfig.ts

@@ -24,6 +24,7 @@
 import type { NextConfig } from 'next';
 import type { Configuration as WebpackConfig } from 'webpack';
 
+import { type I18nPluginOptions, withI18n } from '../i18n/plugin';
 import { type PWAPluginOptions, withPWA } from '../pwa/plugin';
 import { DEFAULT_OPTIMIZE_PACKAGES, DEFAULT_TRANSPILE_PACKAGES } from './constants';
 import { addCompressionPlugins } from './plugins/compression';
@@ -63,6 +64,19 @@ export 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) */
@@ -282,27 +296,35 @@ export function createBaseNextConfig(
     },
   };
 
-  // Deep merge user options with base config
-  let finalConfig = deepMerge(baseConfig, options);
-
-  // Cleanup: Remove custom options that are not part of NextConfig
-  delete (finalConfig as any).optimizePackageImports;
-  delete (finalConfig as any).isDefaultCfgAdmin;
-  delete (finalConfig as any).checkUpdates;
-  delete (finalConfig as any).autoUpdate;
-  delete (finalConfig as any).forceCheckWorkspace;
-  delete (finalConfig as any).checkPackages;
-  delete (finalConfig as any).autoInstall;
-  delete (finalConfig as any).allowIframeFrom;
-  delete (finalConfig as any).openBrowser;
-  // Note: turbopack is a valid NextConfig option, don't delete it
+  // Extract plugin options before merge (to avoid conflicts with Next.js config)
+  const {
+    i18n: i18nOptions,
+    pwa: pwaOptions,
+    optimizePackageImports,
+    isDefaultCfgAdmin,
+    checkUpdates,
+    autoUpdate,
+    forceCheckWorkspace,
+    checkPackages,
+    autoInstall,
+    allowIframeFrom,
+    ...nextConfigOptions
+  } = options;
+
+  // Deep merge only valid Next.js options with base config
+  let finalConfig = deepMerge(baseConfig, nextConfigOptions);
 
   // Apply PWA wrapper only if explicitly configured (opt-in)
   // PWA requires sw.ts file in the app, so apps must explicitly enable it
-  if (options.pwa) {
-    finalConfig = withPWA(finalConfig, options.pwa);
+  if (pwaOptions) {
+    finalConfig = withPWA(finalConfig, pwaOptions);
+  }
+
+  // Apply i18n wrapper if configured
+  // Enables next-intl for locale routing and translations
+  if (i18nOptions) {
+    finalConfig = withI18n(finalConfig, i18nOptions);
   }
-  delete (finalConfig as any).pwa;
 
   return finalConfig;
 }