@webnumseoagent/next 0.1.6 → 0.1.8

package/bin/cli.mjs

@@ -68,7 +68,8 @@ async function detectLocales() {
 async function init() {
   log("\n\x1b[1m@webnumseoagent/next — установка\x1b[0m\n");
   // Проверяем чистоту git ДО создания файлов (чтобы весь дифф установки был обозрим).
-  if (args.includes("--wrap") && !isGitClean() && !args.includes("--force")) {
+  const gitCleanStart = isGitClean();
+  if (args.includes("--wrap") && !gitCleanStart && !args.includes("--force")) {
     console.error("  ✗ Рабочее дерево git не чистое. Закоммить/откатись (или добавь --force), чтобы дифф установки был обозрим.");
     process.exit(1);
   }
@@ -96,7 +97,7 @@ async function init() {
     ok("Пакет @webnumseoagent/next установлен — импорт из пакета.");
   } else {
     const vendor = path.join(root, "seoagent");
-    for (const f of ["client.ts", "jsonld.tsx"]) {
+    for (const f of ["client.ts", "jsonld.tsx", "sitemap-xsl.ts", "sitemap-build.ts"]) {
       const dest = path.join(vendor, f);
       if (!(await exists(dest))) {
         await fs.mkdir(vendor, { recursive: true });
@@ -109,6 +110,10 @@ async function init() {
     importJsonld = `${imp}/jsonld`;
   }
 
+  // Импорт клиента/jsonld для файла на нужной глубине (в vendor-режиме путь относительный).
+  const clientFor = (file) => (pkgMode ? "@webnumseoagent/next" : `${importPath(appDir, file)}/client`);
+  const jsonldFor = (file) => (pkgMode ? "@webnumseoagent/next/jsonld" : `${importPath(appDir, file)}/jsonld`);
+
   // Не создаём sitemap/robots, если у сайта они УЖЕ есть (public/, отдельный роут и т.п.) —
   // чтобы не перекрыть существующую карту сайта пустой.
   const anyExists = async (paths) => {
@@ -116,18 +121,90 @@ async function init() {
     return false;
   };
 
-  // 2. sitemap.ts
-  const hasSitemap = await anyExists([
-    "public/sitemap.xml", "public/sitemap_index.xml",
-    `${appDir}/sitemap.ts`, `${appDir}/sitemap.js`, `${appDir}/sitemap.xml`,
-    `${appDir}/sitemap.xml/route.ts`, `${appDir}/sitemap.xml/route.js`,
-  ]);
-  if (hasSitemap) skip("sitemap (у сайта уже есть — не трогаем)");
-  else await ensureFile(
-    path.join(root, appDir, `sitemap.${ext}`),
-    `import { seoSitemap } from "${importClient}";\nexport const revalidate = 300;\nexport default async function sitemap() {\n  return seoSitemap();\n}\n`,
+  // 2. sitemap — стилизованный вид (XSL) + индекс с разбивкой на разделы.
+  // • у сайта нет своей карты → ГЕНЕРИМ (данные с платформы);
+  // • есть стандартный app/sitemap.(ts|js) → ОБОРАЧИВАЕМ (зовём их генератор, добавляем
+  //   стиль/разбивку — свежесть и все URL сохраняются);
+  // • статичная/нестандартная карта → НЕ ТРОГАЕМ (безопасно).
+  const hdr = `{ "content-type": "application/xml; charset=utf-8", "x-seoagent-sitemap": "1" }`;
+  const childSig = ext === "ts" ? "_req: Request, { params }: { params: { name: string } }" : "_req, { params }";
+  const xslRoute = async () => ensureFile(
+    path.join(root, appDir, `sitemap.xsl/route.${ext}`),
+    `import { SITEMAP_XSL } from "${clientFor("sitemap.xsl/route.ts")}";\nexport function GET() {\n  return new Response(SITEMAP_XSL, { headers: { "content-type": "text/xsl; charset=utf-8" } });\n}\n`,
   );
 
+  const META_EXTS = ["ts", "js", "tsx", "jsx"];
+  const firstExisting = async (names) => {
+    for (const n of names) if (await exists(path.join(root, appDir, n))) return n;
+    return null;
+  };
+  const ourRouteExists = await anyExists([`${appDir}/sitemap.xml/route.ts`, `${appDir}/sitemap.xml/route.js`]);
+  const metaFile = await firstExisting(META_EXTS.map((e) => `sitemap.${e}`));
+  const sourceFile = await firstExisting(META_EXTS.map((e) => `sitemap.source.${e}`));
+  const staticSitemap = await anyExists(["public/sitemap.xml", "public/sitemap_index.xml"]);
+
+  // Конфликт: у сайта уже есть app/sitemap/[иной-сегмент] — тогда свой [name] не создаём
+  // (Next не даёт два разных динамических имени на один путь) и отдаём одну плоскую карту.
+  let dynConflict = false;
+  const smDir = path.join(root, appDir, "sitemap");
+  if (await exists(smDir)) {
+    const names = await fs.readdir(smDir).catch(() => []);
+    dynConflict = names.some((n) => /^\[.*\]$/.test(n) && n !== "[name]");
+  }
+
+  // Можно ли безопасно обернуть их карту: стандартный default-export и не generateSitemaps.
+  const wrappable = async (file) => {
+    const code = await fs.readFile(file, "utf8");
+    if (/\bgenerateSitemaps\b/.test(code)) return false;
+    return /export\s+default\s+(async\s+)?function/.test(code) || /export\s+default\s+\w/.test(code);
+  };
+
+  // Роуты оборачивания (index + опц. child + xsl). flat=true — одна карта без под-карт.
+  const genWrapRoutes = async (flat) => {
+    await ensureFile(
+      path.join(root, appDir, `sitemap.xml/route.${ext}`),
+      `import original from "../sitemap.source";\nimport { seoWrapSitemap } from "${clientFor("sitemap.xml/route.ts")}";\nexport const revalidate = 300;\nexport async function GET() {\n  return new Response(await seoWrapSitemap(original, "${flat ? "flat" : "index"}"), { headers: ${hdr} });\n}\n`,
+    );
+    if (!flat)
+      await ensureFile(
+        path.join(root, appDir, `sitemap/[name]/route.${ext}`),
+        `import original from "../../sitemap.source";\nimport { seoWrapSitemap } from "${clientFor("sitemap/[name]/route.ts")}";\nexport const revalidate = 300;\nexport async function GET(${childSig}) {\n  return new Response(await seoWrapSitemap(original, "child", params.name), { headers: ${hdr} });\n}\n`,
+      );
+    await xslRoute();
+  };
+
+  if (ourRouteExists) {
+    skip("sitemap (наши роуты уже есть)");
+  } else if (sourceFile) {
+    // Резюме прерванной установки: их карта уже переименована — просто доделываем роуты.
+    await genWrapRoutes(dynConflict);
+    ok(`sitemap: доустановлены роуты оборачивания (${appDir}/${sourceFile} уже был)`);
+  } else if (metaFile && (await wrappable(path.join(root, appDir, metaFile)))) {
+    if (!gitCleanStart && !args.includes("--force")) {
+      skip("sitemap (оборачивание пропущено: git не чист — закоммить и запусти снова, или --force)");
+    } else {
+      // ОБОРАЧИВАНИЕ: их карту переименовываем в модуль, наш роут её вызывает.
+      const metaExt = metaFile.slice("sitemap.".length);
+      await fs.rename(path.join(root, appDir, metaFile), path.join(root, appDir, `sitemap.source.${metaExt}`));
+      ok(`${appDir}/${metaFile} → ${appDir}/sitemap.source.${metaExt} (оборачиваем существующую карту)`);
+      await genWrapRoutes(dynConflict);
+    }
+  } else if (metaFile || staticSitemap) {
+    skip(`sitemap (${metaFile ? "нестандартная" : "статичная"} карта сайта — не трогаем)`);
+  } else {
+    // ГЕНЕРАЦИЯ: своей карты нет — собираем на платформе.
+    await ensureFile(
+      path.join(root, appDir, `sitemap.xml/route.${ext}`),
+      `import { seoSitemapXml } from "${clientFor("sitemap.xml/route.ts")}";\nexport const revalidate = 300;\nexport async function GET() {\n  return new Response(await seoSitemapXml("/sitemap.xml"), { headers: ${hdr} });\n}\n`,
+    );
+    if (!dynConflict)
+      await ensureFile(
+        path.join(root, appDir, `sitemap/[name]/route.${ext}`),
+        `import { seoSitemapXml } from "${clientFor("sitemap/[name]/route.ts")}";\nexport const revalidate = 300;\nexport async function GET(${childSig}) {\n  return new Response(await seoSitemapXml("/sitemap/" + params.name), { headers: ${hdr} });\n}\n`,
+      );
+    await xslRoute();
+  }
+
   // 3. robots.txt (вариант B — byte-exact: отдаём сырой текст с платформы как есть).
   // Если у сайта уже есть свой robots — НЕ трогаем (его можно передать платформе позже).
   const hasRobots = await anyExists([
@@ -138,7 +215,7 @@ async function init() {
   if (hasRobots) skip("robots (у сайта уже есть — не трогаем)");
   else await ensureFile(
     path.join(root, appDir, `robots.txt/route.${ext}`),
-    `import { seoRobotsTxt } from "${importClient}";\nexport const revalidate = 300;\nexport async function GET() {\n  return new Response(await seoRobotsTxt(), { headers: { "content-type": "text/plain; charset=utf-8", "x-seoagent-robots": "1" } });\n}\n`,
+    `import { seoRobotsTxt } from "${clientFor("robots.txt/route.ts")}";\nexport const revalidate = 300;\nexport async function GET() {\n  return new Response(await seoRobotsTxt(), { headers: { "content-type": "text/plain; charset=utf-8", "x-seoagent-robots": "1" } });\n}\n`,
   );
 
   // 4. revalidate-роут (мгновенное применение правок с платформы)
@@ -174,7 +251,7 @@ async function init() {
       const rel = path.relative(path.join(root, appDir), p);
       const { expr } = routeFromFile(rel);
       const code = await fs.readFile(p, "utf8");
-      const r = await wrapFile(code, expr, importClient);
+      const r = await wrapFile(code, expr, clientFor(rel));
       if (r.ok) { await fs.writeFile(p, r.code); ok(`${path.relative(root, p)} → обёрнут (route: ${expr})`); wrapped++; }
       else { manual.push({ p, expr, reason: r.reason }); skip(`${path.relative(root, p)} → вручную (${r.reason})`); }
     }
@@ -183,7 +260,7 @@ async function init() {
       log("\n  Осталось вручную (замени `return { … }` на):");
       for (const m of manual) {
         log(`    • ${path.relative(root, m.p)}`);
-        log(`      \x1b[36mimport { seoMeta } from "${importClient}";\n      return seoMeta({ route: ${m.expr}, locale, fallback: { /* прежний объект */ } });\x1b[0m`);
+        log(`      \x1b[36mimport { seoMeta } from "${clientFor(path.relative(path.join(root, appDir), m.p))}";\n      return seoMeta({ route: ${m.expr}, locale, fallback: { /* прежний объект */ } });\x1b[0m`);
       }
     }
 
@@ -193,7 +270,7 @@ async function init() {
       const layouts = await findLayouts(path.join(root, appDir));
       for (const lp of layouts) {
         const code = await fs.readFile(lp, "utf8");
-        const r = await mountJsonLd(code, importJsonld);
+        const r = await mountJsonLd(code, jsonldFor(path.relative(path.join(root, appDir), lp)));
         if (r.ok) { await fs.writeFile(lp, r.code); ok(`${path.relative(root, lp)} → смонтирован <SeoJsonLd/>`); jsonLdMounted = true; }
         else if (r.reason === "already" || r.reason === "existing-jsonld") jsonLdMounted = true;
       }

package/client.ts

@@ -92,6 +92,28 @@ export async function seoMeta(opts: {
   return mergeIntoMetadata(fallback, data.fields);
 }
 
+// Стилизованная карта: сырой XML с платформы (индекс/urlset со ссылкой на XSL).
+// app/sitemap.xml/route.ts:  GET() { return new Response(await seoSitemapXml("/sitemap.xml"), {headers:{"content-type":"application/xml"}}) }
+// app/sitemap/[name]/route.ts: GET(_, {params}) { return new Response(await seoSitemapXml("/sitemap/" + params.name), ...) }
+export async function seoSitemapXml(path: string): Promise<string> {
+  const FALLBACK = `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"></urlset>\n`;
+  if (!API || !SITE || !TOKEN) return FALLBACK;
+  try {
+    const r = await fetch(`${API}/api/seo/${SITE}${path}`, {
+      headers: { "x-seo-agent-key": TOKEN },
+      next: { revalidate: 300, tags: [`seo-${SITE}`] },
+      signal: AbortSignal.timeout(5000),
+    });
+    if (!r.ok) return FALLBACK;
+    return await r.text();
+  } catch {
+    return FALLBACK;
+  }
+}
+
+export { SITEMAP_XSL } from "./sitemap-xsl";
+export { seoWrapSitemap } from "./sitemap-build";
+
 // app/sitemap.ts:  export default async function sitemap() { return seoSitemap() }
 export async function seoSitemap(): Promise<MetadataRoute.Sitemap> {
   const data = await fetchJson<{ entries: { url: string; alternates: Record<string, string>; lastModified?: string }[] }>(

package/dist/client.d.ts

@@ -4,6 +4,9 @@ export declare function seoMeta(opts: {
     locale?: string;
     fallback?: Metadata;
 }): Promise<Metadata>;
+export declare function seoSitemapXml(path: string): Promise<string>;
+export { SITEMAP_XSL } from "./sitemap-xsl";
+export { seoWrapSitemap } from "./sitemap-build";
 export declare function seoSitemap(): Promise<MetadataRoute.Sitemap>;
 export declare function seoRobots(): Promise<MetadataRoute.Robots>;
 export declare function seoRobotsTxt(): Promise<string>;

package/dist/client.js

@@ -11,7 +11,9 @@
 // Все хелперы FAIL-SAFE: при ошибке/таймауте возвращают переданный fallback
 // (скомпилированные дефолты сайта) — сборка/рендер НИКОГДА не падает и НЕ уходит в noindex.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.seoWrapSitemap = exports.SITEMAP_XSL = void 0;
 exports.seoMeta = seoMeta;
+exports.seoSitemapXml = seoSitemapXml;
 exports.seoSitemap = seoSitemap;
 exports.seoRobots = seoRobots;
 exports.seoRobotsTxt = seoRobotsTxt;
@@ -83,6 +85,31 @@ async function seoMeta(opts) {
         return fallback;
     return mergeIntoMetadata(fallback, data.fields);
 }
+// Стилизованная карта: сырой XML с платформы (индекс/urlset со ссылкой на XSL).
+// app/sitemap.xml/route.ts:  GET() { return new Response(await seoSitemapXml("/sitemap.xml"), {headers:{"content-type":"application/xml"}}) }
+// app/sitemap/[name]/route.ts: GET(_, {params}) { return new Response(await seoSitemapXml("/sitemap/" + params.name), ...) }
+async function seoSitemapXml(path) {
+    const FALLBACK = `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"></urlset>\n`;
+    if (!API || !SITE || !TOKEN)
+        return FALLBACK;
+    try {
+        const r = await fetch(`${API}/api/seo/${SITE}${path}`, {
+            headers: { "x-seo-agent-key": TOKEN },
+            next: { revalidate: 300, tags: [`seo-${SITE}`] },
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!r.ok)
+            return FALLBACK;
+        return await r.text();
+    }
+    catch {
+        return FALLBACK;
+    }
+}
+var sitemap_xsl_1 = require("./sitemap-xsl");
+Object.defineProperty(exports, "SITEMAP_XSL", { enumerable: true, get: function () { return sitemap_xsl_1.SITEMAP_XSL; } });
+var sitemap_build_1 = require("./sitemap-build");
+Object.defineProperty(exports, "seoWrapSitemap", { enumerable: true, get: function () { return sitemap_build_1.seoWrapSitemap; } });
 // app/sitemap.ts:  export default async function sitemap() { return seoSitemap() }
 async function seoSitemap() {
     const data = await fetchJson("/sitemap");

package/dist/sitemap-build.d.ts

@@ -0,0 +1,2 @@
+import type { MetadataRoute } from "next";
+export declare function seoWrapSitemap(fn: () => MetadataRoute.Sitemap | Promise<MetadataRoute.Sitemap>, kind: "index" | "child" | "flat", group?: string): Promise<string>;

package/dist/sitemap-build.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.seoWrapSitemap = seoWrapSitemap;
+function escapeXml(s) {
+    return s
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+function normalize(entries) {
+    const out = [];
+    for (const e of entries) {
+        if (!e || typeof e.url !== "string")
+            continue;
+        let lastmod;
+        if (e.lastModified)
+            lastmod = e.lastModified instanceof Date ? e.lastModified.toISOString() : String(e.lastModified);
+        out.push({
+            loc: e.url,
+            lastmod,
+            changefreq: typeof e.changeFrequency === "string" ? e.changeFrequency : undefined,
+            priority: typeof e.priority === "number" ? e.priority : undefined,
+        });
+    }
+    return out;
+}
+function originOf(entries) {
+    for (const e of entries) {
+        try {
+            return new URL(e.loc).origin;
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    return "";
+}
+const dec = (s) => {
+    try {
+        return decodeURIComponent(s);
+    }
+    catch {
+        return s;
+    }
+};
+// Раздел URL: корень/одноуровневые → "pages", иначе по первому сегменту пути.
+// Сегмент декодируем (кириллица и пр.), чтобы имя раздела совпадало с тем, что Next
+// отдаёт в params.name (он декодирует динамический сегмент).
+function groupOfUrl(loc) {
+    let path = loc;
+    try {
+        path = new URL(loc).pathname;
+    }
+    catch {
+        /* keep as-is */
+    }
+    const segs = path.split("/").filter(Boolean);
+    return segs.length <= 1 ? "pages" : dec(segs[0]);
+}
+function pi(origin) {
+    return `<?xml version="1.0" encoding="UTF-8"?>\n<?xml-stylesheet type="text/xsl" href="${escapeXml(origin + "/sitemap.xsl")}"?>\n`;
+}
+function urlsetXml(origin, entries) {
+    const body = entries
+        .map((e) => {
+        const parts = [`    <loc>${escapeXml(e.loc)}</loc>`];
+        if (e.lastmod)
+            parts.push(`    <lastmod>${escapeXml(e.lastmod)}</lastmod>`);
+        if (e.changefreq)
+            parts.push(`    <changefreq>${escapeXml(e.changefreq)}</changefreq>`);
+        if (typeof e.priority === "number")
+            parts.push(`    <priority>${e.priority}</priority>`);
+        return `  <url>\n${parts.join("\n")}\n  </url>`;
+    })
+        .join("\n");
+    return pi(origin) + `<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${body}\n</urlset>\n`;
+}
+function indexXml(origin, groups) {
+    const body = groups
+        // g кодируем в URL (кириллица → %..), чтобы адрес под-карты был валидным;
+        // Next декодирует его обратно в params.name, и фильтр по разделу совпадёт.
+        .map((g) => `  <sitemap>\n    <loc>${escapeXml(origin + "/sitemap/" + encodeURIComponent(g) + ".xml")}</loc>\n  </sitemap>`)
+        .join("\n");
+    return pi(origin) + `<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${body}\n</sitemapindex>\n`;
+}
+const EMPTY = `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"></urlset>\n`;
+// Оборачивает существующий генератор карты. kind="index" — индексный файл (или один
+// urlset, если раздел один); kind="child" — под-карта раздела `group`.
+// Fail-safe: если генератор упал — отдаём валидную пустую карту (не 500).
+async function seoWrapSitemap(fn, kind, group) {
+    let entries;
+    try {
+        entries = normalize(await fn());
+    }
+    catch {
+        return EMPTY;
+    }
+    const origin = originOf(entries);
+    if (!origin || entries.length === 0)
+        return EMPTY;
+    // flat — одна карта со всеми URL (без под-карт); используется, когда под-карты недоступны.
+    if (kind === "flat")
+        return urlsetXml(origin, entries);
+    if (kind === "child") {
+        const g = (group ?? "").replace(/\.xml$/i, "");
+        return urlsetXml(origin, entries.filter((e) => groupOfUrl(e.loc) === g));
+    }
+    const groups = [...new Set(entries.map((e) => groupOfUrl(e.loc)))].sort();
+    if (groups.length <= 1)
+        return urlsetXml(origin, entries);
+    return indexXml(origin, groups);
+}

package/dist/sitemap-xsl.d.ts

@@ -0,0 +1 @@
+export declare const SITEMAP_XSL = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<xsl:stylesheet version=\"1.0\"\n  xmlns:xsl=\"http://www.w3.org/1999/XSL/Transform\"\n  xmlns:s=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n<xsl:output method=\"html\" encoding=\"UTF-8\" indent=\"yes\"/>\n<xsl:template match=\"/\">\n<html lang=\"ru\">\n<head>\n<meta charset=\"UTF-8\"/>\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\"/>\n<title>XML-\u043A\u0430\u0440\u0442\u0430 \u0441\u0430\u0439\u0442\u0430</title>\n<style>\n  *{box-sizing:border-box}\n  body{font-family:-apple-system,system-ui,'Segoe UI',Roboto,sans-serif;color:#1e293b;margin:0;background:#f8fafc}\n  .head{background:#2563eb;color:#fff;padding:28px 40px}\n  .head h1{margin:0 0 8px;font-size:26px;font-weight:600}\n  .head p{margin:0;font-size:14px;opacity:.92;max-width:920px;line-height:1.55}\n  .head a{color:#fff}\n  .wrap{padding:24px 40px}\n  .count{color:#475569;font-size:14px;margin:0 0 14px}\n  table{width:100%;border-collapse:collapse;background:#fff;border:1px solid #e2e8f0;border-radius:10px;overflow:hidden}\n  th{background:#eff2f7;color:#334155;text-align:left;font-size:12px;text-transform:uppercase;letter-spacing:.03em;padding:12px 16px}\n  td{padding:11px 16px;font-size:14px;border-top:1px solid #f1f5f9}\n  tr:hover td{background:#f8fafc}\n  td a{color:#2563eb;text-decoration:none;word-break:break-all}\n  td a:hover{text-decoration:underline}\n  .n{width:80px;color:#64748b;text-align:right}\n  .d{width:140px;color:#64748b;white-space:nowrap}\n</style>\n</head>\n<body>\n<div class=\"head\">\n  <h1>XML-\u043A\u0430\u0440\u0442\u0430 \u0441\u0430\u0439\u0442\u0430</h1>\n  <p>\u0421\u043F\u0438\u0441\u043E\u043A \u0441\u0442\u0440\u0430\u043D\u0438\u0446 \u0434\u043B\u044F \u043F\u043E\u0438\u0441\u043A\u043E\u0432\u044B\u0445 \u0441\u0438\u0441\u0442\u0435\u043C. \u0421\u0433\u0435\u043D\u0435\u0440\u0438\u0440\u043E\u0432\u0430\u043D\u043E \u043F\u043B\u0430\u0442\u0444\u043E\u0440\u043C\u043E\u0439 <b>SEO Agent</b>. \u041F\u043E\u0434\u0440\u043E\u0431\u043D\u0435\u0435 \u043E\u0431 <a href=\"https://www.sitemaps.org/\">XML-\u043A\u0430\u0440\u0442\u0430\u0445 \u0441\u0430\u0439\u0442\u0430</a>.</p>\n</div>\n<div class=\"wrap\">\n<xsl:choose>\n  <xsl:when test=\"s:sitemapindex\">\n    <p class=\"count\">\u0418\u043D\u0434\u0435\u043A\u0441\u043D\u044B\u0439 \u0444\u0430\u0439\u043B \u0441\u043E\u0434\u0435\u0440\u0436\u0438\u0442 <b><xsl:value-of select=\"count(s:sitemapindex/s:sitemap)\"/></b> \u043A\u0430\u0440\u0442(\u044B) \u0441\u0430\u0439\u0442\u0430.</p>\n    <table>\n      <tr><th>\u041A\u0430\u0440\u0442\u0430 \u0441\u0430\u0439\u0442\u0430</th></tr>\n      <xsl:for-each select=\"s:sitemapindex/s:sitemap\">\n        <tr><td><a href=\"{s:loc}\"><xsl:value-of select=\"s:loc\"/></a></td></tr>\n      </xsl:for-each>\n    </table>\n  </xsl:when>\n  <xsl:otherwise>\n    <p class=\"count\">\u042D\u0442\u0430 \u043A\u0430\u0440\u0442\u0430 \u0441\u0430\u0439\u0442\u0430 \u0441\u043E\u0434\u0435\u0440\u0436\u0438\u0442 <b><xsl:value-of select=\"count(s:urlset/s:url)\"/></b> URL.</p>\n    <table>\n      <tr><th class=\"n\">#</th><th>URL</th><th class=\"d\">\u041F\u043E\u0441\u043B\u0435\u0434\u043D\u0435\u0435 \u0438\u0437\u043C.</th></tr>\n      <xsl:for-each select=\"s:urlset/s:url\">\n        <tr>\n          <td class=\"n\"><xsl:value-of select=\"position()\"/></td>\n          <td><a href=\"{s:loc}\"><xsl:value-of select=\"s:loc\"/></a></td>\n          <td class=\"d\"><xsl:value-of select=\"substring(s:lastmod,1,10)\"/></td>\n        </tr>\n      </xsl:for-each>\n    </table>\n  </xsl:otherwise>\n</xsl:choose>\n</div>\n</body>\n</html>\n</xsl:template>\n</xsl:stylesheet>\n";

package/dist/sitemap-xsl.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SITEMAP_XSL = void 0;
+// XSL-таблица стилей для человекочитаемого вида XML-карты в браузере (как у RankMath).
+// Отдаётся адаптером на домене сайта по /sitemap.xsl; сам XML на неё ссылается.
+exports.SITEMAP_XSL = `<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet version="1.0"
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  xmlns:s="http://www.sitemaps.org/schemas/sitemap/0.9">
+<xsl:output method="html" encoding="UTF-8" indent="yes"/>
+<xsl:template match="/">
+<html lang="ru">
+<head>
+<meta charset="UTF-8"/>
+<meta name="viewport" content="width=device-width, initial-scale=1"/>
+<title>XML-карта сайта</title>
+<style>
+  *{box-sizing:border-box}
+  body{font-family:-apple-system,system-ui,'Segoe UI',Roboto,sans-serif;color:#1e293b;margin:0;background:#f8fafc}
+  .head{background:#2563eb;color:#fff;padding:28px 40px}
+  .head h1{margin:0 0 8px;font-size:26px;font-weight:600}
+  .head p{margin:0;font-size:14px;opacity:.92;max-width:920px;line-height:1.55}
+  .head a{color:#fff}
+  .wrap{padding:24px 40px}
+  .count{color:#475569;font-size:14px;margin:0 0 14px}
+  table{width:100%;border-collapse:collapse;background:#fff;border:1px solid #e2e8f0;border-radius:10px;overflow:hidden}
+  th{background:#eff2f7;color:#334155;text-align:left;font-size:12px;text-transform:uppercase;letter-spacing:.03em;padding:12px 16px}
+  td{padding:11px 16px;font-size:14px;border-top:1px solid #f1f5f9}
+  tr:hover td{background:#f8fafc}
+  td a{color:#2563eb;text-decoration:none;word-break:break-all}
+  td a:hover{text-decoration:underline}
+  .n{width:80px;color:#64748b;text-align:right}
+  .d{width:140px;color:#64748b;white-space:nowrap}
+</style>
+</head>
+<body>
+<div class="head">
+  <h1>XML-карта сайта</h1>
+  <p>Список страниц для поисковых систем. Сгенерировано платформой <b>SEO Agent</b>. Подробнее об <a href="https://www.sitemaps.org/">XML-картах сайта</a>.</p>
+</div>
+<div class="wrap">
+<xsl:choose>
+  <xsl:when test="s:sitemapindex">
+    <p class="count">Индексный файл содержит <b><xsl:value-of select="count(s:sitemapindex/s:sitemap)"/></b> карт(ы) сайта.</p>
+    <table>
+      <tr><th>Карта сайта</th></tr>
+      <xsl:for-each select="s:sitemapindex/s:sitemap">
+        <tr><td><a href="{s:loc}"><xsl:value-of select="s:loc"/></a></td></tr>
+      </xsl:for-each>
+    </table>
+  </xsl:when>
+  <xsl:otherwise>
+    <p class="count">Эта карта сайта содержит <b><xsl:value-of select="count(s:urlset/s:url)"/></b> URL.</p>
+    <table>
+      <tr><th class="n">#</th><th>URL</th><th class="d">Последнее изм.</th></tr>
+      <xsl:for-each select="s:urlset/s:url">
+        <tr>
+          <td class="n"><xsl:value-of select="position()"/></td>
+          <td><a href="{s:loc}"><xsl:value-of select="s:loc"/></a></td>
+          <td class="d"><xsl:value-of select="substring(s:lastmod,1,10)"/></td>
+        </tr>
+      </xsl:for-each>
+    </table>
+  </xsl:otherwise>
+</xsl:choose>
+</div>
+</body>
+</html>
+</xsl:template>
+</xsl:stylesheet>
+`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webnumseoagent/next",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Runtime SEO adapter + installer for Next.js App Router sites (SEO Agent platform)",
   "main": "dist/client.js",
   "types": "dist/client.d.ts",
@@ -21,6 +21,8 @@
     "dist",
     "client.ts",
     "jsonld.tsx",
+    "sitemap-xsl.ts",
+    "sitemap-build.ts",
     "bin",
     "README.md"
   ],

package/sitemap-build.ts

@@ -0,0 +1,127 @@
+// «Оборачивание» существующей карты сайта: берём данные из ИХ генератора
+// (сохраняя свежесть и все URL), группируем по разделам и отдаём стилизованный
+// индекс + под-карты со ссылкой на XSL. Работает на стороне сайта (без платформы).
+import type { MetadataRoute } from "next";
+
+function escapeXml(s: string): string {
+  return s
+    .replace(/&/g, "&")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&apos;");
+}
+
+interface NEntry {
+  loc: string;
+  lastmod?: string;
+  changefreq?: string;
+  priority?: number;
+}
+
+function normalize(entries: MetadataRoute.Sitemap): NEntry[] {
+  const out: NEntry[] = [];
+  for (const e of entries) {
+    if (!e || typeof e.url !== "string") continue;
+    let lastmod: string | undefined;
+    if (e.lastModified) lastmod = e.lastModified instanceof Date ? e.lastModified.toISOString() : String(e.lastModified);
+    out.push({
+      loc: e.url,
+      lastmod,
+      changefreq: typeof e.changeFrequency === "string" ? e.changeFrequency : undefined,
+      priority: typeof e.priority === "number" ? e.priority : undefined,
+    });
+  }
+  return out;
+}
+
+function originOf(entries: NEntry[]): string {
+  for (const e of entries) {
+    try {
+      return new URL(e.loc).origin;
+    } catch {
+      /* ignore */
+    }
+  }
+  return "";
+}
+
+const dec = (s: string): string => {
+  try {
+    return decodeURIComponent(s);
+  } catch {
+    return s;
+  }
+};
+
+// Раздел URL: корень/одноуровневые → "pages", иначе по первому сегменту пути.
+// Сегмент декодируем (кириллица и пр.), чтобы имя раздела совпадало с тем, что Next
+// отдаёт в params.name (он декодирует динамический сегмент).
+function groupOfUrl(loc: string): string {
+  let path = loc;
+  try {
+    path = new URL(loc).pathname;
+  } catch {
+    /* keep as-is */
+  }
+  const segs = path.split("/").filter(Boolean);
+  return segs.length <= 1 ? "pages" : dec(segs[0]);
+}
+
+function pi(origin: string): string {
+  return `<?xml version="1.0" encoding="UTF-8"?>\n<?xml-stylesheet type="text/xsl" href="${escapeXml(origin + "/sitemap.xsl")}"?>\n`;
+}
+
+function urlsetXml(origin: string, entries: NEntry[]): string {
+  const body = entries
+    .map((e) => {
+      const parts = [`    <loc>${escapeXml(e.loc)}</loc>`];
+      if (e.lastmod) parts.push(`    <lastmod>${escapeXml(e.lastmod)}</lastmod>`);
+      if (e.changefreq) parts.push(`    <changefreq>${escapeXml(e.changefreq)}</changefreq>`);
+      if (typeof e.priority === "number") parts.push(`    <priority>${e.priority}</priority>`);
+      return `  <url>\n${parts.join("\n")}\n  </url>`;
+    })
+    .join("\n");
+  return pi(origin) + `<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${body}\n</urlset>\n`;
+}
+
+function indexXml(origin: string, groups: string[]): string {
+  const body = groups
+    // g кодируем в URL (кириллица → %..), чтобы адрес под-карты был валидным;
+    // Next декодирует его обратно в params.name, и фильтр по разделу совпадёт.
+    .map((g) => `  <sitemap>\n    <loc>${escapeXml(origin + "/sitemap/" + encodeURIComponent(g) + ".xml")}</loc>\n  </sitemap>`)
+    .join("\n");
+  return pi(origin) + `<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${body}\n</sitemapindex>\n`;
+}
+
+const EMPTY = `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"></urlset>\n`;
+
+// Оборачивает существующий генератор карты. kind="index" — индексный файл (или один
+// urlset, если раздел один); kind="child" — под-карта раздела `group`.
+// Fail-safe: если генератор упал — отдаём валидную пустую карту (не 500).
+export async function seoWrapSitemap(
+  fn: () => MetadataRoute.Sitemap | Promise<MetadataRoute.Sitemap>,
+  kind: "index" | "child" | "flat",
+  group?: string,
+): Promise<string> {
+  let entries: NEntry[];
+  try {
+    entries = normalize(await fn());
+  } catch {
+    return EMPTY;
+  }
+  const origin = originOf(entries);
+  if (!origin || entries.length === 0) return EMPTY;
+
+  // flat — одна карта со всеми URL (без под-карт); используется, когда под-карты недоступны.
+  if (kind === "flat") return urlsetXml(origin, entries);
+
+  if (kind === "child") {
+    const g = (group ?? "").replace(/\.xml$/i, "");
+    return urlsetXml(origin, entries.filter((e) => groupOfUrl(e.loc) === g));
+  }
+
+  const groups = [...new Set(entries.map((e) => groupOfUrl(e.loc)))].sort();
+  if (groups.length <= 1) return urlsetXml(origin, entries);
+  return indexXml(origin, groups);
+}

package/sitemap-xsl.ts

@@ -0,0 +1,68 @@
+// XSL-таблица стилей для человекочитаемого вида XML-карты в браузере (как у RankMath).
+// Отдаётся адаптером на домене сайта по /sitemap.xsl; сам XML на неё ссылается.
+export const SITEMAP_XSL = `<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet version="1.0"
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  xmlns:s="http://www.sitemaps.org/schemas/sitemap/0.9">
+<xsl:output method="html" encoding="UTF-8" indent="yes"/>
+<xsl:template match="/">
+<html lang="ru">
+<head>
+<meta charset="UTF-8"/>
+<meta name="viewport" content="width=device-width, initial-scale=1"/>
+<title>XML-карта сайта</title>
+<style>
+  *{box-sizing:border-box}
+  body{font-family:-apple-system,system-ui,'Segoe UI',Roboto,sans-serif;color:#1e293b;margin:0;background:#f8fafc}
+  .head{background:#2563eb;color:#fff;padding:28px 40px}
+  .head h1{margin:0 0 8px;font-size:26px;font-weight:600}
+  .head p{margin:0;font-size:14px;opacity:.92;max-width:920px;line-height:1.55}
+  .head a{color:#fff}
+  .wrap{padding:24px 40px}
+  .count{color:#475569;font-size:14px;margin:0 0 14px}
+  table{width:100%;border-collapse:collapse;background:#fff;border:1px solid #e2e8f0;border-radius:10px;overflow:hidden}
+  th{background:#eff2f7;color:#334155;text-align:left;font-size:12px;text-transform:uppercase;letter-spacing:.03em;padding:12px 16px}
+  td{padding:11px 16px;font-size:14px;border-top:1px solid #f1f5f9}
+  tr:hover td{background:#f8fafc}
+  td a{color:#2563eb;text-decoration:none;word-break:break-all}
+  td a:hover{text-decoration:underline}
+  .n{width:80px;color:#64748b;text-align:right}
+  .d{width:140px;color:#64748b;white-space:nowrap}
+</style>
+</head>
+<body>
+<div class="head">
+  <h1>XML-карта сайта</h1>
+  <p>Список страниц для поисковых систем. Сгенерировано платформой <b>SEO Agent</b>. Подробнее об <a href="https://www.sitemaps.org/">XML-картах сайта</a>.</p>
+</div>
+<div class="wrap">
+<xsl:choose>
+  <xsl:when test="s:sitemapindex">
+    <p class="count">Индексный файл содержит <b><xsl:value-of select="count(s:sitemapindex/s:sitemap)"/></b> карт(ы) сайта.</p>
+    <table>
+      <tr><th>Карта сайта</th></tr>
+      <xsl:for-each select="s:sitemapindex/s:sitemap">
+        <tr><td><a href="{s:loc}"><xsl:value-of select="s:loc"/></a></td></tr>
+      </xsl:for-each>
+    </table>
+  </xsl:when>
+  <xsl:otherwise>
+    <p class="count">Эта карта сайта содержит <b><xsl:value-of select="count(s:urlset/s:url)"/></b> URL.</p>
+    <table>
+      <tr><th class="n">#</th><th>URL</th><th class="d">Последнее изм.</th></tr>
+      <xsl:for-each select="s:urlset/s:url">
+        <tr>
+          <td class="n"><xsl:value-of select="position()"/></td>
+          <td><a href="{s:loc}"><xsl:value-of select="s:loc"/></a></td>
+          <td class="d"><xsl:value-of select="substring(s:lastmod,1,10)"/></td>
+        </tr>
+      </xsl:for-each>
+    </table>
+  </xsl:otherwise>
+</xsl:choose>
+</div>
+</body>
+</html>
+</xsl:template>
+</xsl:stylesheet>
+`;