@webnumseoagent/next 0.1.7 → 0.1.10

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", "sitemap-xsl.ts"]) {
+    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 });
@@ -120,29 +121,88 @@ 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`,
-  ]);
-  // Стилизованная карта: индекс + под-карты по разделам + XSL-таблица стилей
-  // (человекочитаемый вид в браузере, как у RankMath). Всё собирает платформа.
-  if (hasSitemap) skip("sitemap (у сайта уже есть — не трогаем)");
-  else {
-    const tt = ext === "ts";
+  // 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 { seoSitemapXml } from "${clientFor("sitemap.xml/route.ts")}";\nexport const revalidate = 300;\nexport async function GET() {\n  return new Response(await seoSitemapXml("/sitemap.xml"), { headers: { "content-type": "application/xml; charset=utf-8", "x-seoagent-sitemap": "1" } });\n}\n`,
-    );
-    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(${tt ? "_req: Request, { params }: { params: { name: string } }" : "_req, { params }"}) {\n  return new Response(await seoSitemapXml("/sitemap/" + params.name), { headers: { "content-type": "application/xml; charset=utf-8", "x-seoagent-sitemap": "1" } });\n}\n`,
+      `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.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`,
+      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: отдаём сырой текст с платформы как есть).

package/client.ts

@@ -112,6 +112,7 @@ export async function seoSitemapXml(path: string): Promise<string> {
 }
 
 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> {

package/dist/client.d.ts

@@ -6,6 +6,7 @@ export declare function seoMeta(opts: {
 }): 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,7 @@
 // Все хелперы FAIL-SAFE: при ошибке/таймауте возвращают переданный fallback
 // (скомпилированные дефолты сайта) — сборка/рендер НИКОГДА не падает и НЕ уходит в noindex.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SITEMAP_XSL = void 0;
+exports.seoWrapSitemap = exports.SITEMAP_XSL = void 0;
 exports.seoMeta = seoMeta;
 exports.seoSitemapXml = seoSitemapXml;
 exports.seoSitemap = seoSitemap;
@@ -108,6 +108,8 @@ async function seoSitemapXml(path) {
 }
 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,124 @@
+"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);
+        const images = Array.isArray(e.images)
+            ? e.images.filter((i) => typeof i === "string" && !!i)
+            : [];
+        out.push({
+            loc: e.url,
+            lastmod,
+            changefreq: typeof e.changeFrequency === "string" ? e.changeFrequency : undefined,
+            priority: typeof e.priority === "number" ? e.priority : undefined,
+            images: images.length ? images : 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 hasImages = entries.some((e) => e.images && e.images.length);
+    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>`);
+        for (const img of e.images ?? [])
+            parts.push(`    <image:image><image:loc>${escapeXml(img)}</image:loc></image:image>`);
+        return `  <url>\n${parts.join("\n")}\n  </url>`;
+    })
+        .join("\n");
+    const ns = hasImages
+        ? `xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:image="http://www.google.com/schemas/sitemap-image/1.1"`
+        : `xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"`;
+    return pi(origin) + `<urlset ${ns}>\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

@@ -1 +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</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></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        </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";
+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  xmlns:image=\"http://www.google.com/schemas/sitemap-image/1.1\">\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  .back{margin:0 0 12px}\n  .back a{color:#2563eb;text-decoration:none;font-size:14px;font-weight:500}\n  .back a:hover{text-decoration:underline}\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  .i{width:120px;color:#64748b;text-align:center}\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=\"back\"><a href=\"/sitemap.xml\">\u2190 \u0418\u043D\u0434\u0435\u043A\u0441 \u043A\u0430\u0440\u0442\u044B \u0441\u0430\u0439\u0442\u0430</a></p>\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=\"i\">\u0418\u0437\u043E\u0431\u0440\u0430\u0436\u0435\u043D\u0438\u044F</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=\"i\"><xsl:value-of select=\"count(image:image)\"/></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

@@ -6,7 +6,8 @@ exports.SITEMAP_XSL = void 0;
 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">
+  xmlns:s="http://www.sitemaps.org/schemas/sitemap/0.9"
+  xmlns:image="http://www.google.com/schemas/sitemap-image/1.1">
 <xsl:output method="html" encoding="UTF-8" indent="yes"/>
 <xsl:template match="/">
 <html lang="ru">
@@ -23,6 +24,9 @@ exports.SITEMAP_XSL = `<?xml version="1.0" encoding="UTF-8"?>
   .head a{color:#fff}
   .wrap{padding:24px 40px}
   .count{color:#475569;font-size:14px;margin:0 0 14px}
+  .back{margin:0 0 12px}
+  .back a{color:#2563eb;text-decoration:none;font-size:14px;font-weight:500}
+  .back a:hover{text-decoration:underline}
   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}
@@ -30,6 +34,8 @@ exports.SITEMAP_XSL = `<?xml version="1.0" encoding="UTF-8"?>
   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}
+  .i{width:120px;color:#64748b;text-align:center}
+  .d{width:140px;color:#64748b;white-space:nowrap}
 </style>
 </head>
 <body>
@@ -49,13 +55,16 @@ exports.SITEMAP_XSL = `<?xml version="1.0" encoding="UTF-8"?>
     </table>
   </xsl:when>
   <xsl:otherwise>
+    <p class="back"><a href="/sitemap.xml">← Индекс карты сайта</a></p>
     <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></tr>
+      <tr><th class="n">#</th><th>URL</th><th class="i">Изображения</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="i"><xsl:value-of select="count(image:image)"/></td>
+          <td class="d"><xsl:value-of select="substring(s:lastmod,1,10)"/></td>
         </tr>
       </xsl:for-each>
     </table>

package/package.json

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

package/sitemap-build.ts

@@ -0,0 +1,146 @@
+// «Оборачивание» существующей карты сайта: берём данные из ИХ генератора
+// (сохраняя свежесть и все 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;
+  images?: string[];
+}
+
+// Запись карты может нести доп. поля (напр. images) сверх типа Next — читаем через каст.
+type RawEntry = {
+  url?: unknown;
+  lastModified?: string | Date;
+  changeFrequency?: string;
+  priority?: number;
+  images?: unknown;
+};
+
+function normalize(entries: MetadataRoute.Sitemap): NEntry[] {
+  const out: NEntry[] = [];
+  for (const e of entries as RawEntry[]) {
+    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);
+    const images = Array.isArray(e.images)
+      ? e.images.filter((i: unknown): i is string => typeof i === "string" && !!i)
+      : [];
+    out.push({
+      loc: e.url,
+      lastmod,
+      changefreq: typeof e.changeFrequency === "string" ? e.changeFrequency : undefined,
+      priority: typeof e.priority === "number" ? e.priority : undefined,
+      images: images.length ? images : 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 hasImages = entries.some((e) => e.images && e.images.length);
+  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>`);
+      for (const img of e.images ?? []) parts.push(`    <image:image><image:loc>${escapeXml(img)}</image:loc></image:image>`);
+      return `  <url>\n${parts.join("\n")}\n  </url>`;
+    })
+    .join("\n");
+  const ns = hasImages
+    ? `xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:image="http://www.google.com/schemas/sitemap-image/1.1"`
+    : `xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"`;
+  return pi(origin) + `<urlset ${ns}>\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

@@ -3,7 +3,8 @@
 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">
+  xmlns:s="http://www.sitemaps.org/schemas/sitemap/0.9"
+  xmlns:image="http://www.google.com/schemas/sitemap-image/1.1">
 <xsl:output method="html" encoding="UTF-8" indent="yes"/>
 <xsl:template match="/">
 <html lang="ru">
@@ -20,6 +21,9 @@ export const SITEMAP_XSL = `<?xml version="1.0" encoding="UTF-8"?>
   .head a{color:#fff}
   .wrap{padding:24px 40px}
   .count{color:#475569;font-size:14px;margin:0 0 14px}
+  .back{margin:0 0 12px}
+  .back a{color:#2563eb;text-decoration:none;font-size:14px;font-weight:500}
+  .back a:hover{text-decoration:underline}
   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}
@@ -27,6 +31,8 @@ export const SITEMAP_XSL = `<?xml version="1.0" encoding="UTF-8"?>
   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}
+  .i{width:120px;color:#64748b;text-align:center}
+  .d{width:140px;color:#64748b;white-space:nowrap}
 </style>
 </head>
 <body>
@@ -46,13 +52,16 @@ export const SITEMAP_XSL = `<?xml version="1.0" encoding="UTF-8"?>
     </table>
   </xsl:when>
   <xsl:otherwise>
+    <p class="back"><a href="/sitemap.xml">← Индекс карты сайта</a></p>
     <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></tr>
+      <tr><th class="n">#</th><th>URL</th><th class="i">Изображения</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="i"><xsl:value-of select="count(image:image)"/></td>
+          <td class="d"><xsl:value-of select="substring(s:lastmod,1,10)"/></td>
         </tr>
       </xsl:for-each>
     </table>