aeo.js 0.0.7 → 0.0.9

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { F as FrameworkInfo, R as ResolvedAeoConfig, A as AeoConfig, P as PageEntry } from './types-Cn_Qbkmg.mjs';
-export { a as AIIndexEntry, b as AeoManifest, D as DocEntry, c as FrameworkType, M as ManifestEntry, d as MarkdownFile } from './types-Cn_Qbkmg.mjs';
+import { F as FrameworkInfo, R as ResolvedAeoConfig, A as AeoConfig, P as PageEntry } from './types-BlLNcw-X.mjs';
+export { a as AIIndexEntry, b as AeoManifest, D as DocEntry, c as FrameworkType, M as ManifestEntry, d as MarkdownFile } from './types-BlLNcw-X.mjs';
 
 declare function detectFramework(projectRoot?: string): FrameworkInfo;
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FrameworkInfo, R as ResolvedAeoConfig, A as AeoConfig, P as PageEntry } from './types-Cn_Qbkmg.js';
-export { a as AIIndexEntry, b as AeoManifest, D as DocEntry, c as FrameworkType, M as ManifestEntry, d as MarkdownFile } from './types-Cn_Qbkmg.js';
+import { F as FrameworkInfo, R as ResolvedAeoConfig, A as AeoConfig, P as PageEntry } from './types-BlLNcw-X.js';
+export { a as AIIndexEntry, b as AeoManifest, D as DocEntry, c as FrameworkType, M as ManifestEntry, d as MarkdownFile } from './types-BlLNcw-X.js';
 
 declare function detectFramework(projectRoot?: string): FrameworkInfo;
 

package/dist/index.js

@@ -24,7 +24,7 @@ function validateConfig(config) {
   return warnings;
 }
 function resolveConfig(config = {}) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N;
   const frameworkInfo = detectFramework();
   return {
     title: config.title || "My Site",
@@ -68,15 +68,16 @@ function resolveConfig(config = {}) {
     widget: {
       enabled: ((_A = config.widget) == null ? void 0 : _A.enabled) !== false,
       position: ((_B = config.widget) == null ? void 0 : _B.position) || "bottom-right",
+      size: ((_C = config.widget) == null ? void 0 : _C.size) || "default",
       theme: {
-        background: ((_D = (_C = config.widget) == null ? void 0 : _C.theme) == null ? void 0 : _D.background) || "rgba(18, 18, 24, 0.9)",
-        text: ((_F = (_E = config.widget) == null ? void 0 : _E.theme) == null ? void 0 : _F.text) || "#C0C0C5",
-        accent: ((_H = (_G = config.widget) == null ? void 0 : _G.theme) == null ? void 0 : _H.accent) || "#E8E8EA",
-        badge: ((_J = (_I = config.widget) == null ? void 0 : _I.theme) == null ? void 0 : _J.badge) || "#4ADE80"
+        background: ((_E = (_D = config.widget) == null ? void 0 : _D.theme) == null ? void 0 : _E.background) || "rgba(18, 18, 24, 0.9)",
+        text: ((_G = (_F = config.widget) == null ? void 0 : _F.theme) == null ? void 0 : _G.text) || "#C0C0C5",
+        accent: ((_I = (_H = config.widget) == null ? void 0 : _H.theme) == null ? void 0 : _I.accent) || "#E8E8EA",
+        badge: ((_K = (_J = config.widget) == null ? void 0 : _J.theme) == null ? void 0 : _K.badge) || "#4ADE80"
       },
-      humanLabel: ((_K = config.widget) == null ? void 0 : _K.humanLabel) || "Human",
-      aiLabel: ((_L = config.widget) == null ? void 0 : _L.aiLabel) || "AI",
-      showBadge: ((_M = config.widget) == null ? void 0 : _M.showBadge) !== false
+      humanLabel: ((_L = config.widget) == null ? void 0 : _L.humanLabel) || "Human",
+      aiLabel: ((_M = config.widget) == null ? void 0 : _M.aiLabel) || "AI",
+      showBadge: ((_N = config.widget) == null ? void 0 : _N.showBadge) !== false
     }
   };
 }
@@ -269,10 +270,19 @@ function generateRobotsTxt(config) {
   }
   lines.push("# Default for all other bots");
   lines.push("User-agent: *");
-  lines.push("Allow: /");
+  for (const path of config.robots.allow.length > 0 ? config.robots.allow : ["/"]) {
+    lines.push(`Allow: ${path}`);
+  }
+  for (const path of config.robots.disallow) {
+    lines.push(`Disallow: ${path}`);
+  }
+  if (config.robots.crawlDelay > 0) {
+    lines.push(`Crawl-delay: ${config.robots.crawlDelay}`);
+  }
   lines.push("");
-  if (config.url) {
-    lines.push(`Sitemap: ${config.url}/sitemap.xml`);
+  const sitemapUrl = config.robots.sitemap || (config.url ? `${config.url}/sitemap.xml` : "");
+  if (sitemapUrl) {
+    lines.push(`Sitemap: ${sitemapUrl}`);
   }
   lines.push("");
   lines.push("# AEO (Answer Engine Optimization) files");
@@ -290,7 +300,8 @@ function collectMarkdownFiles(dir, base = dir) {
     for (const entry of entries) {
       const fullPath = path.join(dir, entry);
       const stat = fs.statSync(fullPath);
-      if (stat.isDirectory() && !entry.startsWith(".") && entry !== "node_modules") {
+      const SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "public", "dist", ".next", ".nuxt", ".output", ".open-next", "coverage", "__tests__", "__mocks__"]);
+      if (stat.isDirectory() && !entry.startsWith(".") && !SKIP_DIRS.has(entry)) {
         files.push(...collectMarkdownFiles(fullPath, base));
       } else if (stat.isFile() && (path.extname(entry) === ".md" || path.extname(entry) === ".mdx")) {
         const content = fs.readFileSync(fullPath, "utf-8");
@@ -633,7 +644,8 @@ function collectUrls(dir, config, base = dir) {
     for (const entry of entries) {
       const fullPath = path.join(dir, entry);
       const stat = fs.statSync(fullPath);
-      if (stat.isDirectory() && !entry.startsWith(".") && entry !== "node_modules") {
+      const SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "public", "dist", ".next", ".nuxt", ".output", ".open-next", "coverage", "__tests__", "__mocks__"]);
+      if (stat.isDirectory() && !entry.startsWith(".") && !SKIP_DIRS.has(entry)) {
         urls.push(...collectUrls(fullPath, config, base));
       } else if (stat.isFile() && (path.extname(entry) === ".md" || path.extname(entry) === ".mdx" || path.extname(entry) === ".html")) {
         const relativePath = path.relative(base, fullPath);
@@ -861,6 +873,22 @@ function generatePageSchemas(page, config) {
       }))
     });
   }
+  if (faqItems.length === 0) {
+    const howToSteps = detectHowToSteps(page.content || "");
+    if (howToSteps.length > 0) {
+      schemas.push({
+        "@context": "https://schema.org",
+        "@type": "HowTo",
+        name: page.title || config.title,
+        step: howToSteps.map((s, i) => ({
+          "@type": "HowToStep",
+          position: i + 1,
+          name: s.name,
+          text: s.text
+        }))
+      });
+    }
+  }
   const pageType = config.schema.defaultType;
   const pageSchema = {
     "@context": "https://schema.org",
@@ -937,12 +965,43 @@ function detectFaqPatterns(content) {
   }
   return items;
 }
+function serializeJsonForHtml(value) {
+  return JSON.stringify(value).replace(/</g, "\\u003C").replace(/>/g, "\\u003E").replace(/&/g, "\\u0026").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+function detectHowToSteps(content) {
+  const steps = [];
+  const lines = content.split("\n");
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+    const stepMatch = line.match(/^#{1,6}\s+(?:Step\s+\d+[\s:.-]*|(\d+)[.)]\s*)(.+)$/i);
+    if (stepMatch) {
+      const name = (stepMatch[2] || stepMatch[1] || "").trim();
+      const bodyLines = [];
+      for (let j = i + 1; j < lines.length; j++) {
+        const nextLine = lines[j].trim();
+        if (!nextLine) {
+          if (bodyLines.length > 0) break;
+          continue;
+        }
+        if (/^#{1,6}\s/.test(nextLine)) break;
+        bodyLines.push(nextLine);
+      }
+      if (name) {
+        steps.push({
+          name,
+          text: bodyLines.join(" ").slice(0, 500)
+        });
+      }
+    }
+  }
+  return steps.length >= 2 ? steps : [];
+}
 function generateJsonLdScript(schemas) {
   if (schemas.length === 0) return "";
   if (schemas.length === 1) {
-    return `<script type="application/ld+json">${JSON.stringify(schemas[0])}</script>`;
+    return `<script type="application/ld+json">${serializeJsonForHtml(schemas[0])}</script>`;
   }
-  return schemas.map((s) => `<script type="application/ld+json">${JSON.stringify(s)}</script>`).join("\n");
+  return schemas.map((s) => `<script type="application/ld+json">${serializeJsonForHtml(s)}</script>`).join("\n");
 }
 async function generateAEOFiles(configOrRoot, maybeConfig) {
   var _a;
@@ -1275,15 +1334,18 @@ function auditSchemaPresence(config, issues, suggestions) {
   if (!hasLogo) {
     suggestions.push("Add schema.organization.logo for richer search results and AI knowledge");
   }
-  const hasSameAs = config.schema.organization.sameAs.length > 0;
-  checks.push({ label: "Social profiles linked (sameAs)", passed: hasSameAs, points: hasSameAs ? 4 : 0 });
-  if (!hasSameAs) {
-    issues.push({ category: "Schema Presence", severity: "warning", message: "No social profiles (sameAs) \u2014 critical for GEO/E-E-A-T signals", fix: "Add schema.organization.sameAs with social profile URLs" });
+  const hasFaqOrHowTo = config.pages.some((p) => {
+    const content = p.content || "";
+    return /^#{1,6}\s+.+\?\s*$/m.test(content) || /^#{1,6}\s+(?:Step\s+\d+[\s:.-]|How\s+to)/im.test(content);
+  });
+  checks.push({ label: "FAQPage or HowTo schema", passed: hasFaqOrHowTo, points: hasFaqOrHowTo ? 4 : 0 });
+  if (!hasFaqOrHowTo) {
+    suggestions.push("Add FAQ sections (question headings) or step-by-step content to auto-generate FAQPage/HowTo schema");
   }
-  const hasRealUrl = config.url !== "https://example.com" && config.url !== "";
-  checks.push({ label: "Site URL is configured (not default)", passed: hasRealUrl, points: hasRealUrl ? 4 : 0 });
-  if (!hasRealUrl) {
-    issues.push({ category: "Schema Presence", severity: "error", message: "Site URL is still the default (https://example.com)", fix: "Set url to your actual site URL" });
+  const hasArticleOrWebPage = schemaEnabled && (config.schema.defaultType === "Article" || config.schema.defaultType === "WebPage");
+  checks.push({ label: "Article/WebPage schema", passed: hasArticleOrWebPage, points: hasArticleOrWebPage ? 4 : 0 });
+  if (!hasArticleOrWebPage && schemaEnabled) {
+    suggestions.push('Set schema.defaultType to "Article" or "WebPage" for per-page structured data');
   }
   return {
     name: "Schema Presence",
@@ -1322,12 +1384,10 @@ function auditMetaQuality(config, issues, suggestions) {
   if (!goodTitleCoverage && config.pages.length > 0) {
     issues.push({ category: "Meta Quality", severity: "warning", message: `Only ${pagesWithTitles.length}/${config.pages.length} pages have titles`, fix: "Add titles to all pages" });
   }
-  const pagesWithDesc = config.pages.filter((p) => p.description && p.description.length > 0);
-  const descCoverage = config.pages.length > 0 ? pagesWithDesc.length / config.pages.length : 0;
-  const goodDescCoverage = descCoverage >= 0.5;
-  checks.push({ label: "50%+ of pages have descriptions", passed: goodDescCoverage, points: goodDescCoverage ? 4 : 0 });
-  if (!goodDescCoverage && config.pages.length > 0) {
-    suggestions.push(`Only ${pagesWithDesc.length}/${config.pages.length} pages have descriptions \u2014 add per-page descriptions`);
+  const hasOgImage = !!config.og.image;
+  checks.push({ label: "OG image configured", passed: hasOgImage, points: hasOgImage ? 4 : 0 });
+  if (!hasOgImage) {
+    suggestions.push("Set og.image for richer social sharing previews and AI citation cards");
   }
   return {
     name: "Meta Quality",