@lynxflow/seo-engine 1.5.4 → 1.5.6

package/dist/index.mjs

@@ -3029,6 +3029,62 @@ class ExtendedSchemaGraphBuilder {
       }))
     };
   }
+  static buildAggregateRating(opts) {
+    return {
+      "@type": "AggregateRating",
+      ratingValue: opts.ratingValue ?? 4.9,
+      reviewCount: opts.reviewCount ?? 1280,
+      bestRating: opts.bestRating ?? 5,
+      worstRating: opts.worstRating ?? 1,
+      itemReviewed: {
+        "@type": "Thing",
+        name: opts.itemReviewedName
+      }
+    };
+  }
+  static buildAggregateOffer(opts) {
+    return {
+      "@type": "AggregateOffer",
+      lowPrice: String(opts.lowPrice),
+      highPrice: String(opts.highPrice),
+      priceCurrency: opts.currency,
+      offerCount: String(opts.offerCount ?? 3),
+      description: opts.description || "Transparent pricing with zero lock-in"
+    };
+  }
+  static buildService(opts) {
+    return {
+      "@context": "https://schema.org",
+      "@type": "Service",
+      name: opts.name,
+      description: opts.description,
+      serviceType: opts.serviceType || "SoftwareService",
+      provider: {
+        "@type": "Organization",
+        name: opts.providerName
+      },
+      areaServed: opts.areaServed ? opts.areaServed.map((city) => ({
+        "@type": "City",
+        name: city
+      })) : undefined
+    };
+  }
+  static buildWebSite(opts) {
+    return {
+      "@context": "https://schema.org",
+      "@type": "WebSite",
+      name: opts.name,
+      url: opts.url,
+      potentialAction: opts.searchUrlTemplate ? {
+        "@type": "SearchAction",
+        target: {
+          "@type": "EntryPoint",
+          urlTemplate: opts.searchUrlTemplate
+        },
+        "query-input": "required name=search_term_string"
+      } : undefined
+    };
+  }
 }
 
 // src/matrix-engine.ts
@@ -3537,6 +3593,260 @@ class PseoMatrixEngine {
     return allPages;
   }
 }
+// src/brand-icons.ts
+var BRAND_ICONS = {
+  facebook: {
+    name: "Facebook",
+    slug: "facebook",
+    category: "social",
+    viewBox: "0 0 24 24",
+    svgPath: "M24 12.073c0-6.627-5.373-12-12-12s-12 5.373-12 12c0 5.99 4.388 10.954 10.125 11.854v-8.385H7.078v-3.47h3.047V9.43c0-3.007 1.792-4.669 4.533-4.669 1.312 0 2.686.235 2.686.235v2.953H15.83c-1.491 0-1.956.925-1.956 1.874v2.25h3.328l-.532 3.47h-2.796v8.385C19.612 23.027 24 18.062 24 12.073z",
+    brandColor: "#1877F2"
+  },
+  instagram: {
+    name: "Instagram",
+    slug: "instagram",
+    category: "social",
+    viewBox: "0 0 24 24",
+    svgPath: "M12 2.163c3.204 0 3.584.012 4.85.07 3.252.148 4.771 1.691 4.919 4.919.058 1.265.069 1.645.069 4.849 0 3.205-.012 3.584-.069 4.849-.149 3.225-1.664 4.771-4.919 4.919-1.266.058-1.644.07-4.85.07-3.204 0-3.584-.012-4.849-.07-3.26-.149-4.771-1.699-4.919-4.92-.058-1.265-.07-1.644-.07-4.849 0-3.204.013-3.583.07-4.849.149-3.227 1.664-4.771 4.919-4.919 1.266-.057 1.645-.069 4.849-.069zm0-2.163c-3.259 0-3.667.014-4.947.072-4.358.2-6.78 2.618-6.98 6.98-.059 1.281-.073 1.689-.073 4.948 0 3.259.014 3.668.072 4.948.2 4.358 2.618 6.78 6.98 6.98 1.281.058 1.689.072 4.948.072 3.259 0 3.668-.014 4.948-.072 4.354-.2 6.782-2.618 6.979-6.98.059-1.28.073-1.689.073-4.948 0-3.259-.014-3.667-.072-4.947-.196-4.354-2.617-6.78-6.979-6.98-1.281-.059-1.69-.073-4.949-.073zm0 5.838c-3.403 0-6.162 2.759-6.162 6.162s2.759 6.163 6.162 6.163 6.162-2.759 6.162-6.163c0-3.403-2.759-6.162-6.162-6.162zm0 10.162c-2.209 0-4-1.79-4-4 0-2.209 1.791-4 4-4s4 1.791 4 4c0 2.21-1.791 4-4 4zm6.406-11.845c-.796 0-1.441.645-1.441 1.44s.645 1.44 1.441 1.44c.795 0 1.439-.645 1.439-1.44s-.644-1.44-1.439-1.44z",
+    brandColor: "#E4405F"
+  },
+  linkedin: {
+    name: "LinkedIn",
+    slug: "linkedin",
+    category: "social",
+    viewBox: "0 0 24 24",
+    svgPath: "M19 0h-14c-2.761 0-5 2.239-5 5v14c0 2.761 2.239 5 5 5h14c2.762 0 5-2.239 5-5v-14c0-2.761-2.238-5-5-5zm-11 19h-3v-11h3v11zm-1.5-12.268c-.966 0-1.75-.79-1.75-1.764s.784-1.764 1.75-1.764 1.75.79 1.75 1.764-.783 1.764-1.75 1.764zm13.5 12.268h-3v-5.604c0-3.368-4-3.113-4 0v5.604h-3v-11h3v1.765c1.396-2.586 7-2.777 7 2.476v6.759z",
+    brandColor: "#0A66C2"
+  },
+  twitter: {
+    name: "X (Twitter)",
+    slug: "twitter",
+    category: "social",
+    viewBox: "0 0 24 24",
+    svgPath: "M18.244 2.25h3.308l-7.227 8.26 8.502 11.24H16.17l-5.214-6.817L4.99 21.75H1.68l7.73-8.835L1.254 2.25H8.08l4.713 6.231zm-1.161 17.52h1.833L7.084 4.126H5.117z",
+    brandColor: "#000000"
+  },
+  youtube: {
+    name: "YouTube",
+    slug: "youtube",
+    category: "social",
+    viewBox: "0 0 24 24",
+    svgPath: "M23.498 6.186a3.016 3.016 0 0 0-2.122-2.136C19.505 3.545 12 3.545 12 3.545s-7.505 0-9.377.505A3.017 3.017 0 0 0 .502 6.186C0 8.07 0 12 0 12s0 3.93.502 5.814a3.016 3.016 0 0 0 2.122 2.136c1.871.505 9.376.505 9.376.505s7.505 0 9.377-.505a3.015 3.015 0 0 0 2.122-2.136C24 15.93 24 12 24 12s0-3.93-.502-5.814zM9.545 15.568V8.432L15.818 12l-6.273 3.568z",
+    brandColor: "#FF0000"
+  },
+  tiktok: {
+    name: "TikTok",
+    slug: "tiktok",
+    category: "social",
+    viewBox: "0 0 24 24",
+    svgPath: "M12.525.02c1.31-.02 2.61-.01 3.91-.02.08 1.53.63 3.09 1.75 4.17 1.12 1.11 2.7 1.62 4.24 1.79v4.03c-1.44-.05-2.89-.35-4.2-.97-.57-.26-1.1-.59-1.62-.93-.01 2.92.01 5.84-.02 8.75-.08 1.4-.54 2.79-1.35 3.94-1.31 1.92-3.58 3.17-5.91 3.21-1.43.08-2.86-.31-4.08-1.03-2.02-1.19-3.44-3.37-3.65-5.71-.02-.5-.03-1-.01-1.49.18-1.9 1.12-3.72 2.58-4.96 1.66-1.44 3.98-2.13 6.15-1.72.02 1.48-.04 2.96-.04 4.44-.99-.32-2.15-.23-3.02.37-.63.41-1.11 1.04-1.36 1.75-.21.51-.24 1.07-.14 1.61.24 1.64 1.82 2.89 3.5 2.76 1.25-.04 2.4-1.02 2.68-2.22.12-.55.13-1.12.13-1.68V.02z",
+    brandColor: "#000000"
+  },
+  shopify: {
+    name: "Shopify",
+    slug: "shopify",
+    category: "ecommerce",
+    viewBox: "0 0 24 24",
+    svgPath: "M18.8 6.5l-1.3-.4c-.1-.3-.4-1.1-.7-1.5-.7-.9-1.7-1.4-2.8-1.4-.1 0-.2 0-.3.1l-.8-2.5c-.1-.4-.6-.6-.9-.4l-6.5 2.1c-.2.1-.3.2-.3.4l-.8 2.5-3.3 1c-.7.2-.9.9-.5 1.5l5.5 14.7c.2.4.6.7 1.1.7h11.1c.5 0 .9-.3 1.1-.7l3.6-14.8c.2-.7-.3-1.3-.9-1.2zm-5.7-1.9c.7 0 1.3.4 1.8 1.1.3.4.5 1 .6 1.3l-3.9 1.2 1.5-3.6zm-3.3 1.1l3.5-1.1-1.4 3.4-3.4-1.1 1.3-1.2z",
+    brandColor: "#96BF48"
+  },
+  slack: {
+    name: "Slack",
+    slug: "slack",
+    category: "tech",
+    viewBox: "0 0 24 24",
+    svgPath: "M5.042 15.165a2.528 2.528 0 0 1-2.52 2.523A2.528 2.528 0 0 1 0 15.165a2.527 2.527 0 0 1 2.522-2.52h2.52v2.52zM6.313 15.165a2.527 2.527 0 0 1 2.521-2.52 2.527 2.527 0 0 1 2.521 2.52v6.313A2.528 2.528 0 0 1 8.834 24a2.528 2.528 0 0 1-2.521-2.522v-6.313zM8.834 5.042a2.528 2.528 0 0 1-2.521-2.52A2.528 2.528 0 0 1 8.834 0a2.528 2.528 0 0 1 2.521 2.522v2.52H8.834zM8.834 6.313a2.528 2.528 0 0 1 2.521 2.521 2.528 2.528 0 0 1-2.521 2.521H2.522A2.528 2.528 0 0 1 0 8.834a2.528 2.528 0 0 1 2.522-2.521h6.312zM18.956 8.834a2.528 2.528 0 0 1 2.522-2.521A2.528 2.528 0 0 1 24 8.834a2.528 2.528 0 0 1-2.522 2.521h-2.522V8.834zM17.688 8.834a2.528 2.528 0 0 1-2.523 2.521 2.527 2.527 0 0 1-2.52-2.521V2.522A2.527 2.527 0 0 1 15.165 0a2.528 2.528 0 0 1 2.523 2.522v6.312zM15.165 18.956a2.528 2.528 0 0 1 2.523 2.522A2.528 2.528 0 0 1 15.165 24a2.527 2.527 0 0 1-2.52-2.522v-2.522h2.52zM15.165 17.688a2.527 2.527 0 0 1-2.52-2.523 2.526 2.526 0 0 1 2.52-2.52h6.313A2.527 2.527 0 0 1 24 15.165a2.528 2.528 0 0 1-2.522 2.523h-6.313z",
+    brandColor: "#4A154B"
+  },
+  whatsapp: {
+    name: "WhatsApp",
+    slug: "whatsapp",
+    category: "social",
+    viewBox: "0 0 24 24",
+    svgPath: "M.057 24l1.687-6.163c-1.041-1.804-1.588-3.849-1.587-5.946.003-6.556 5.338-11.891 11.893-11.891 3.181.001 6.167 1.24 8.413 3.488 2.245 2.248 3.481 5.236 3.48 8.414-.003 6.557-5.338 11.892-11.893 11.892-1.99-.001-3.951-.5-5.688-1.448l-6.305 1.654zm6.597-3.807c1.676.995 3.276 1.591 5.392 1.592 5.448 0 9.886-4.434 9.889-9.885.002-5.462-4.415-9.89-9.881-9.892-5.452 0-9.887 4.434-9.889 9.884-.001 2.225.651 3.891 1.746 5.634l-.999 3.648 3.742-.981z",
+    brandColor: "#25D366"
+  },
+  hubspot: {
+    name: "HubSpot",
+    slug: "hubspot",
+    category: "crm",
+    viewBox: "0 0 24 24",
+    svgPath: "M17.48 7.37V4.92c.73-.37 1.23-1.12 1.23-2 0-1.24-1-2.24-2.24-2.24s-2.24 1-2.24 2.24c0 .88.5 1.63 1.23 2v2.45c-1.39.38-2.48 1.48-2.86 2.87H9.28c-.37-.5-1-.83-1.68-.83-.07 0-.15 0-.22.02V7.15c.61-.35 1.02-.99 1.02-1.74 0-1.1-.9-2-2-2s-2 .9-2 2c0 .75.41 1.39 1.02 1.74v2.28c-.68.22-1.19.8-1.31 1.52H2.24c-.2-.58-.75-1-1.4-1C.38 10 0 10.38 0 10.84s.38.84.84.84c.65 0 1.2-.42 1.4-1h1.87c.12.72.63 1.3 1.31 1.52v5.26c-.61.35-1.02.99-1.02 1.74 0 1.1.9 2 2 2s2-.9 2-2c0-.75-.41-1.39-1.02-1.74v-5.26c.07.02.15.02.22.02.68 0 1.31-.33 1.68-.83h3.32c.38 1.39 1.47 2.49 2.86 2.87v2.45c-.73.37-1.23 1.12-1.23 2 0 1.24 1 2.24 2.24 2.24s2.24-1 2.24-2.24c0-.88-.5-1.63-1.23-2v-2.45c1.84-.5 3.23-2.16 3.23-4.14s-1.39-3.64-3.23-4.14zm-1.01 6.13c-1.1 0-2-.9-2-2s.9-2 2-2 2 .9 2 2-.9 2-2 2z",
+    brandColor: "#FF7A59"
+  },
+  github: {
+    name: "GitHub",
+    slug: "github",
+    category: "tech",
+    viewBox: "0 0 24 24",
+    svgPath: "M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0 0 24 12c0-6.63-5.37-12-12-12z",
+    brandColor: "#181717"
+  },
+  google: {
+    name: "Google",
+    slug: "google",
+    category: "tech",
+    viewBox: "0 0 24 24",
+    svgPath: "M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92c-.26 1.37-1.04 2.53-2.21 3.31v2.77h3.57c2.08-1.92 3.28-4.74 3.28-8.09zM12 23c2.97 0 5.46-.98 7.28-2.66l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84C3.99 20.53 7.7 23 12 23zm-6.16-8.9c-.22-.66-.35-1.36-.35-2.1s.13-1.44.35-2.1V7.06H2.18C1.43 8.55 1 10.22 1 12s.43 3.45 1.18 4.94l2.85-2.22.81-.62zM12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1 7.7 1 3.99 3.47 2.18 7.06l3.66 2.84c.87-2.6 3.3-4.52 6.16-4.52z",
+    brandColor: "#4285F4"
+  }
+};
+function resolveBrandIcon(input) {
+  if (!input || typeof input !== "string")
+    return;
+  const clean = input.toLowerCase().replace(/[^a-z0-9]/g, "");
+  for (const [key, icon] of Object.entries(BRAND_ICONS)) {
+    if (clean.includes(key) || clean.includes(icon.slug)) {
+      return icon;
+    }
+  }
+  return;
+}
+function renderBrandIconSvg(input, className = "w-5 h-5 inline-block") {
+  const icon = resolveBrandIcon(input);
+  if (!icon)
+    return "";
+  return `<svg class="${className}" viewBox="${icon.viewBox}" fill="currentColor" aria-hidden="true"><path d="${icon.svgPath}"/></svg>`;
+}
+// src/urlytics-engine.ts
+class UrlyticsEngine {
+  static parseUrl(rawUrl) {
+    if (!rawUrl || typeof rawUrl !== "string") {
+      return {
+        url: "",
+        scheme: "",
+        domain: "",
+        path: "/",
+        depth: 0,
+        lastDir: "",
+        queryParams: {},
+        slugTokens: [],
+        charCount: 0,
+        hasTrailingSlash: false
+      };
+    }
+    try {
+      const parsed = new URL(rawUrl.startsWith("http") ? rawUrl : `https://${rawUrl}`);
+      const pathClean = parsed.pathname.replace(/\/+$/, "");
+      const segments = pathClean.split("/").filter(Boolean);
+      const queryParams = {};
+      parsed.searchParams.forEach((val, key) => {
+        queryParams[key] = val;
+      });
+      const lastDir = segments.length > 0 ? segments[segments.length - 1] : "";
+      const slugTokens = lastDir.split("-").filter(Boolean);
+      return {
+        url: rawUrl,
+        scheme: parsed.protocol.replace(":", ""),
+        domain: parsed.hostname,
+        path: parsed.pathname,
+        depth: segments.length,
+        dir1: segments[0],
+        dir2: segments[1],
+        dir3: segments[2],
+        lastDir,
+        queryParams,
+        hashFragment: parsed.hash ? parsed.hash.replace("#", "") : undefined,
+        slugTokens,
+        charCount: rawUrl.length,
+        hasTrailingSlash: parsed.pathname.length > 1 && parsed.pathname.endsWith("/")
+      };
+    } catch {
+      return {
+        url: rawUrl,
+        scheme: "unknown",
+        domain: "",
+        path: rawUrl,
+        depth: 0,
+        lastDir: rawUrl,
+        queryParams: {},
+        slugTokens: [rawUrl],
+        charCount: rawUrl.length,
+        hasTrailingSlash: false
+      };
+    }
+  }
+  static analyzeUrls(urls) {
+    return urls.map((u) => this.parseUrl(u));
+  }
+}
+// src/keyword-permutator.ts
+class KeywordPermutatorEngine {
+  static generateKeywordMatrix(options) {
+    const { products, words = [], locations = [], maxCombinations = 5000 } = options;
+    const results = [];
+    const intentKeywords = {
+      transactional: ["buy", "pricing", "cost", "hire", "quote", "tarif", "prix", "devis", "acheter"],
+      commercial: ["best", "top", "review", "vs", "comparison", "alternative", "comparatif", "meilleur"],
+      informational: ["how to", "what is", "guide", "tutorial", "definition", "comment", "quest ce que"],
+      navigational: ["login", "app", "portal", "website", "connexion"]
+    };
+    const detectIntent = (text) => {
+      const lower = text.toLowerCase();
+      for (const [intent, triggers] of Object.entries(intentKeywords)) {
+        if (triggers.some((t) => lower.includes(t))) {
+          return intent;
+        }
+      }
+      return "commercial";
+    };
+    for (const prod of products) {
+      results.push({
+        keyword: prod,
+        exactMatch: `[${prod}]`,
+        phraseMatch: `"${prod}"`,
+        intent: detectIntent(prod),
+        product: prod
+      });
+      for (const word of words) {
+        const kw1 = `${word} ${prod}`;
+        const kw2 = `${prod} ${word}`;
+        results.push({
+          keyword: kw1,
+          exactMatch: `[${kw1}]`,
+          phraseMatch: `"${kw1}"`,
+          intent: detectIntent(word),
+          product: prod,
+          modifier: word
+        });
+        results.push({
+          keyword: kw2,
+          exactMatch: `[${kw2}]`,
+          phraseMatch: `"${kw2}"`,
+          intent: detectIntent(word),
+          product: prod,
+          modifier: word
+        });
+        for (const loc of locations) {
+          const kwLoc1 = `${word} ${prod} ${loc}`;
+          const kwLoc2 = `${prod} ${loc} ${word}`;
+          results.push({
+            keyword: kwLoc1,
+            exactMatch: `[${kwLoc1}]`,
+            phraseMatch: `"${kwLoc1}"`,
+            intent: detectIntent(word),
+            product: prod,
+            modifier: word,
+            location: loc
+          });
+          results.push({
+            keyword: kwLoc2,
+            exactMatch: `[${kwLoc2}]`,
+            phraseMatch: `"${kwLoc2}"`,
+            intent: detectIntent(word),
+            product: prod,
+            modifier: word,
+            location: loc
+          });
+          if (results.length >= maxCombinations)
+            return results;
+        }
+      }
+    }
+    return results;
+  }
+}
 // src/llm-prompt.ts
 var PSEO_AGENT_SYSTEM_PROMPT = `
 You are the Programmatic SEO Implementation Specialist powered by @lynxflow/seo-engine.
@@ -3631,10 +3941,12 @@ export const PSEO_DATASET = {
 };
 \`\`\`
 
-#### File 2: Universal Dynamic Catch-All Route (\`app/[...slug]/page.tsx\`)
+#### File 2: Ultra-Modern Dynamic Catch-All Route (\`app/[...slug]/page.tsx\`)
 \`\`\`tsx
 import { notFound } from "next/navigation";
+import Link from "next/link";
 import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
+import { renderBrandIconSvg } from "@lynxflow/seo-engine";
 
 export async function generateMetadata({ params }: { params: { slug: string[] } }) {
   const path = "/" + params.slug.join("/");
@@ -3652,12 +3964,75 @@ export default async function ProgrammaticPage({ params }: { params: { slug: str
   const page = pages.find((p) => p.urlPath === path);
   if (!page) notFound();
 
+  // Automatic Brand Icon Detection
+  const brandSvg = renderBrandIconSvg(page.integration?.name || page.competitor?.name || page.service?.name || "");
+
   return (
-    <article className="max-w-4xl mx-auto py-12 px-6">
+    <article className="min-h-screen bg-background text-foreground transition-colors duration-200">
+      {/* 1. Official Google Schema.org JSON-LD */}
       <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(page.schemaGraph) }} />
-      <h1 className="text-4xl font-extrabold">{page.h1}</h1>
-      <p className="mt-4 text-xl text-gray-600">{page.description}</p>
-      {page.disclaimerText && <aside className="mt-8 p-4 bg-gray-50 border rounded text-xs text-gray-500">{page.disclaimerText}</aside>}
+
+      <main className="max-w-5xl mx-auto px-4 sm:px-6 lg:px-8 py-12 md:py-16 space-y-12">
+        {/* 2. Hero Section with Glassmorphism Badge */}
+        <header className="space-y-6 text-center md:text-left">
+          <div className="inline-flex items-center gap-2 px-3 py-1 rounded-full text-xs font-semibold bg-primary/10 text-primary border border-primary/20 backdrop-blur-md">
+            {brandSvg && <span dangerouslySetInnerHTML={{ __html: brandSvg }} className="w-4 h-4 flex items-center" />}
+            <span>{page.matrixFamily.toUpperCase()}</span>
+          </div>
+
+          <h1 className="text-4xl sm:text-5xl lg:text-6xl font-black tracking-tight leading-tight">
+            {page.h1}
+          </h1>
+          <p className="text-lg sm:text-xl text-muted-foreground max-w-3xl leading-relaxed">
+            {page.description}
+          </p>
+        </header>
+
+        {/* 3. AEO / GEO Direct-Answer Callout Box (Optimized for ChatGPT & Perplexity Citations) */}
+        <section className="p-6 md:p-8 rounded-2xl bg-card border border-border shadow-sm space-y-3" data-geo-extract="true">
+          <div className="flex items-center gap-2 text-primary font-bold text-sm">
+            <span>⚡</span>
+            <span>Direct Summary & Key Takeaways</span>
+          </div>
+          <p className="text-base text-card-foreground leading-relaxed">
+            {page.description}
+          </p>
+        </section>
+
+        {/* 4. Interactive Value & Feature Grid */}
+        <section className="grid grid-cols-1 md:grid-cols-3 gap-6">
+          {(page.service?.keyFeatures || ["Real-time Sync", "Bank-grade Security", "Zero Lock-in"]).map((feat, idx) => (
+            <div key={idx} className="p-6 rounded-xl bg-card/60 border border-border/80 hover:border-primary/50 transition duration-200 space-y-2">
+              <div className="w-8 h-8 rounded-lg bg-primary/10 text-primary flex items-center justify-center font-bold text-sm">
+                0{idx + 1}
+              </div>
+              <h3 className="font-bold text-lg">{feat}</h3>
+              <p className="text-sm text-muted-foreground">Automated workflows engineered for high-performance scale.</p>
+            </div>
+          ))}
+        </section>
+
+        {/* 5. Geodesic Mesh Linking Footer (Prevents Orphan Pages & Spreads PageRank) */}
+        {page.neighboringLinks && page.neighboringLinks.length > 0 && (
+          <nav className="pt-8 border-t border-border space-y-4">
+            <h3 className="text-sm font-semibold uppercase tracking-wider text-muted-foreground">Nearby & Related Hubs</h3>
+            <div className="flex flex-wrap gap-2">
+              {page.neighboringLinks.map((link, idx) => (
+                <Link key={idx} href={link.url} className="px-3 py-1.5 rounded-lg text-xs font-medium bg-secondary text-secondary-foreground hover:bg-primary hover:text-primary-foreground transition duration-150">
+                  {link.name}
+                </Link>
+              ))}
+            </div>
+          </nav>
+        )}
+
+        {/* 6. SeedRank Legal Compliance Notice */}
+        {page.disclaimerText && (
+          <aside className="p-4 rounded-lg bg-muted/40 border border-border text-xs text-muted-foreground leading-relaxed">
+            {page.disclaimerText}
+          </aside>
+        )}
+      </main>
     </article>
   );
 }
@@ -5876,11 +6251,14 @@ var LynxSeo = {
 var src_default = LynxSeo;
 export {
   validateSeoSlug,
+  resolveBrandIcon,
+  renderBrandIconSvg,
   getSeoAgentPrompt,
   src_default as default,
   createLynxSeoEngine,
   cleanSeoSlug,
   YoastParityEngine,
+  UrlyticsEngine,
   TokenQuotaManager,
   TechnicalRulesAuditor,
   TeamRbacEngine,
@@ -5912,6 +6290,7 @@ export {
   LegalDisclaimerEngine,
   LagoTokenMeter,
   KnowledgeGraphLinker,
+  KeywordPermutatorEngine,
   IsrCacheManager,
   InstantMatrixSearchEngine,
   IndexNowClient,
@@ -5925,6 +6304,7 @@ export {
   CopywritingFrameworksMaster,
   BrandDnaCalendarEngine,
   BacklinksClient,
+  BRAND_ICONS,
   ApiKeyGuardian,
   AiCopilotClient,
   AiBotsLogAnalyzer,

package/dist/keyword-permutator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ⚡ High-Speed Keyword Permutator & SEM Matrix Engine
+ * Inspired by advertools.kw_generate
+ *
+ * Generates all permutations and combinations of Products × Modifiers × Intents × Locations
+ * with match types (Broad, Phrase, Exact) and estimated search intent tagging.
+ */
+export type SearchIntentType = "commercial" | "transactional" | "informational" | "navigational";
+export interface GeneratedKeyword {
+    keyword: string;
+    exactMatch: string;
+    phraseMatch: string;
+    intent: SearchIntentType;
+    product: string;
+    modifier?: string;
+    location?: string;
+}
+export interface PermutatorOptions {
+    products: string[];
+    words?: string[];
+    locations?: string[];
+    maxCombinations?: number;
+}
+export declare class KeywordPermutatorEngine {
+    /**
+     * Generates a combinatorial matrix of keywords.
+     */
+    static generateKeywordMatrix(options: PermutatorOptions): GeneratedKeyword[];
+}

package/dist/urlytics-engine.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 🔍 Universal URL Analytics & Structural Decomposition Engine
+ * Inspired by advertools.urlytics
+ *
+ * Breaks down any URL into structured path segments, query parameters, directory depths,
+ * and slug tokens for crawl validation, audit logs, and programmatic matrix matching.
+ */
+export interface ParsedUrlStructure {
+    url: string;
+    scheme: string;
+    domain: string;
+    path: string;
+    depth: number;
+    dir1?: string;
+    dir2?: string;
+    dir3?: string;
+    lastDir: string;
+    queryParams: Record<string, string>;
+    hashFragment?: string;
+    slugTokens: string[];
+    charCount: number;
+    hasTrailingSlash: boolean;
+}
+export declare class UrlyticsEngine {
+    /**
+     * Parses a single URL into its granular structural components.
+     */
+    static parseUrl(rawUrl: string): ParsedUrlStructure;
+    /**
+     * Batch processes an array of URLs for comparative directory analysis.
+     */
+    static analyzeUrls(urls: string[]): ParsedUrlStructure[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynxflow/seo-engine",
-  "version": "1.5.4",
+  "version": "1.5.6",
   "description": "High-Performance Multilingual Programmatic SEO & AI Search Engine SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/brand-icons.ts

@@ -0,0 +1,138 @@
+/**
+ * 🎨 Zero-Dependency Brand & Social SVG Icons Resolver
+ * Enhances Programmatic SEO pages, OpenGraph banners, and CRO trust elements
+ * by automatically injecting official, crisp vector icons for detected brands.
+ */
+
+export interface BrandIcon {
+  name: string;
+  slug: string;
+  category: "social" | "tech" | "ecommerce" | "crm" | "general";
+  viewBox: string;
+  svgPath: string;
+  brandColor: string;
+}
+
+export const BRAND_ICONS: Record<string, BrandIcon> = {
+  facebook: {
+    name: "Facebook",
+    slug: "facebook",
+    category: "social",
+    viewBox: "0 0 24 24",
+    svgPath: "M24 12.073c0-6.627-5.373-12-12-12s-12 5.373-12 12c0 5.99 4.388 10.954 10.125 11.854v-8.385H7.078v-3.47h3.047V9.43c0-3.007 1.792-4.669 4.533-4.669 1.312 0 2.686.235 2.686.235v2.953H15.83c-1.491 0-1.956.925-1.956 1.874v2.25h3.328l-.532 3.47h-2.796v8.385C19.612 23.027 24 18.062 24 12.073z",
+    brandColor: "#1877F2",
+  },
+  instagram: {
+    name: "Instagram",
+    slug: "instagram",
+    category: "social",
+    viewBox: "0 0 24 24",
+    svgPath: "M12 2.163c3.204 0 3.584.012 4.85.07 3.252.148 4.771 1.691 4.919 4.919.058 1.265.069 1.645.069 4.849 0 3.205-.012 3.584-.069 4.849-.149 3.225-1.664 4.771-4.919 4.919-1.266.058-1.644.07-4.85.07-3.204 0-3.584-.012-4.849-.07-3.26-.149-4.771-1.699-4.919-4.92-.058-1.265-.07-1.644-.07-4.849 0-3.204.013-3.583.07-4.849.149-3.227 1.664-4.771 4.919-4.919 1.266-.057 1.645-.069 4.849-.069zm0-2.163c-3.259 0-3.667.014-4.947.072-4.358.2-6.78 2.618-6.98 6.98-.059 1.281-.073 1.689-.073 4.948 0 3.259.014 3.668.072 4.948.2 4.358 2.618 6.78 6.98 6.98 1.281.058 1.689.072 4.948.072 3.259 0 3.668-.014 4.948-.072 4.354-.2 6.782-2.618 6.979-6.98.059-1.28.073-1.689.073-4.948 0-3.259-.014-3.667-.072-4.947-.196-4.354-2.617-6.78-6.979-6.98-1.281-.059-1.69-.073-4.949-.073zm0 5.838c-3.403 0-6.162 2.759-6.162 6.162s2.759 6.163 6.162 6.163 6.162-2.759 6.162-6.163c0-3.403-2.759-6.162-6.162-6.162zm0 10.162c-2.209 0-4-1.79-4-4 0-2.209 1.791-4 4-4s4 1.791 4 4c0 2.21-1.791 4-4 4zm6.406-11.845c-.796 0-1.441.645-1.441 1.44s.645 1.44 1.441 1.44c.795 0 1.439-.645 1.439-1.44s-.644-1.44-1.439-1.44z",
+    brandColor: "#E4405F",
+  },
+  linkedin: {
+    name: "LinkedIn",
+    slug: "linkedin",
+    category: "social",
+    viewBox: "0 0 24 24",
+    svgPath: "M19 0h-14c-2.761 0-5 2.239-5 5v14c0 2.761 2.239 5 5 5h14c2.762 0 5-2.239 5-5v-14c0-2.761-2.238-5-5-5zm-11 19h-3v-11h3v11zm-1.5-12.268c-.966 0-1.75-.79-1.75-1.764s.784-1.764 1.75-1.764 1.75.79 1.75 1.764-.783 1.764-1.75 1.764zm13.5 12.268h-3v-5.604c0-3.368-4-3.113-4 0v5.604h-3v-11h3v1.765c1.396-2.586 7-2.777 7 2.476v6.759z",
+    brandColor: "#0A66C2",
+  },
+  twitter: {
+    name: "X (Twitter)",
+    slug: "twitter",
+    category: "social",
+    viewBox: "0 0 24 24",
+    svgPath: "M18.244 2.25h3.308l-7.227 8.26 8.502 11.24H16.17l-5.214-6.817L4.99 21.75H1.68l7.73-8.835L1.254 2.25H8.08l4.713 6.231zm-1.161 17.52h1.833L7.084 4.126H5.117z",
+    brandColor: "#000000",
+  },
+  youtube: {
+    name: "YouTube",
+    slug: "youtube",
+    category: "social",
+    viewBox: "0 0 24 24",
+    svgPath: "M23.498 6.186a3.016 3.016 0 0 0-2.122-2.136C19.505 3.545 12 3.545 12 3.545s-7.505 0-9.377.505A3.017 3.017 0 0 0 .502 6.186C0 8.07 0 12 0 12s0 3.93.502 5.814a3.016 3.016 0 0 0 2.122 2.136c1.871.505 9.376.505 9.376.505s7.505 0 9.377-.505a3.015 3.015 0 0 0 2.122-2.136C24 15.93 24 12 24 12s0-3.93-.502-5.814zM9.545 15.568V8.432L15.818 12l-6.273 3.568z",
+    brandColor: "#FF0000",
+  },
+  tiktok: {
+    name: "TikTok",
+    slug: "tiktok",
+    category: "social",
+    viewBox: "0 0 24 24",
+    svgPath: "M12.525.02c1.31-.02 2.61-.01 3.91-.02.08 1.53.63 3.09 1.75 4.17 1.12 1.11 2.7 1.62 4.24 1.79v4.03c-1.44-.05-2.89-.35-4.2-.97-.57-.26-1.1-.59-1.62-.93-.01 2.92.01 5.84-.02 8.75-.08 1.4-.54 2.79-1.35 3.94-1.31 1.92-3.58 3.17-5.91 3.21-1.43.08-2.86-.31-4.08-1.03-2.02-1.19-3.44-3.37-3.65-5.71-.02-.5-.03-1-.01-1.49.18-1.9 1.12-3.72 2.58-4.96 1.66-1.44 3.98-2.13 6.15-1.72.02 1.48-.04 2.96-.04 4.44-.99-.32-2.15-.23-3.02.37-.63.41-1.11 1.04-1.36 1.75-.21.51-.24 1.07-.14 1.61.24 1.64 1.82 2.89 3.5 2.76 1.25-.04 2.4-1.02 2.68-2.22.12-.55.13-1.12.13-1.68V.02z",
+    brandColor: "#000000",
+  },
+  shopify: {
+    name: "Shopify",
+    slug: "shopify",
+    category: "ecommerce",
+    viewBox: "0 0 24 24",
+    svgPath: "M18.8 6.5l-1.3-.4c-.1-.3-.4-1.1-.7-1.5-.7-.9-1.7-1.4-2.8-1.4-.1 0-.2 0-.3.1l-.8-2.5c-.1-.4-.6-.6-.9-.4l-6.5 2.1c-.2.1-.3.2-.3.4l-.8 2.5-3.3 1c-.7.2-.9.9-.5 1.5l5.5 14.7c.2.4.6.7 1.1.7h11.1c.5 0 .9-.3 1.1-.7l3.6-14.8c.2-.7-.3-1.3-.9-1.2zm-5.7-1.9c.7 0 1.3.4 1.8 1.1.3.4.5 1 .6 1.3l-3.9 1.2 1.5-3.6zm-3.3 1.1l3.5-1.1-1.4 3.4-3.4-1.1 1.3-1.2z",
+    brandColor: "#96BF48",
+  },
+  slack: {
+    name: "Slack",
+    slug: "slack",
+    category: "tech",
+    viewBox: "0 0 24 24",
+    svgPath: "M5.042 15.165a2.528 2.528 0 0 1-2.52 2.523A2.528 2.528 0 0 1 0 15.165a2.527 2.527 0 0 1 2.522-2.52h2.52v2.52zM6.313 15.165a2.527 2.527 0 0 1 2.521-2.52 2.527 2.527 0 0 1 2.521 2.52v6.313A2.528 2.528 0 0 1 8.834 24a2.528 2.528 0 0 1-2.521-2.522v-6.313zM8.834 5.042a2.528 2.528 0 0 1-2.521-2.52A2.528 2.528 0 0 1 8.834 0a2.528 2.528 0 0 1 2.521 2.522v2.52H8.834zM8.834 6.313a2.528 2.528 0 0 1 2.521 2.521 2.528 2.528 0 0 1-2.521 2.521H2.522A2.528 2.528 0 0 1 0 8.834a2.528 2.528 0 0 1 2.522-2.521h6.312zM18.956 8.834a2.528 2.528 0 0 1 2.522-2.521A2.528 2.528 0 0 1 24 8.834a2.528 2.528 0 0 1-2.522 2.521h-2.522V8.834zM17.688 8.834a2.528 2.528 0 0 1-2.523 2.521 2.527 2.527 0 0 1-2.52-2.521V2.522A2.527 2.527 0 0 1 15.165 0a2.528 2.528 0 0 1 2.523 2.522v6.312zM15.165 18.956a2.528 2.528 0 0 1 2.523 2.522A2.528 2.528 0 0 1 15.165 24a2.527 2.527 0 0 1-2.52-2.522v-2.522h2.52zM15.165 17.688a2.527 2.527 0 0 1-2.52-2.523 2.526 2.526 0 0 1 2.52-2.52h6.313A2.527 2.527 0 0 1 24 15.165a2.528 2.528 0 0 1-2.522 2.523h-6.313z",
+    brandColor: "#4A154B",
+  },
+  whatsapp: {
+    name: "WhatsApp",
+    slug: "whatsapp",
+    category: "social",
+    viewBox: "0 0 24 24",
+    svgPath: "M.057 24l1.687-6.163c-1.041-1.804-1.588-3.849-1.587-5.946.003-6.556 5.338-11.891 11.893-11.891 3.181.001 6.167 1.24 8.413 3.488 2.245 2.248 3.481 5.236 3.48 8.414-.003 6.557-5.338 11.892-11.893 11.892-1.99-.001-3.951-.5-5.688-1.448l-6.305 1.654zm6.597-3.807c1.676.995 3.276 1.591 5.392 1.592 5.448 0 9.886-4.434 9.889-9.885.002-5.462-4.415-9.89-9.881-9.892-5.452 0-9.887 4.434-9.889 9.884-.001 2.225.651 3.891 1.746 5.634l-.999 3.648 3.742-.981z",
+    brandColor: "#25D366",
+  },
+  hubspot: {
+    name: "HubSpot",
+    slug: "hubspot",
+    category: "crm",
+    viewBox: "0 0 24 24",
+    svgPath: "M17.48 7.37V4.92c.73-.37 1.23-1.12 1.23-2 0-1.24-1-2.24-2.24-2.24s-2.24 1-2.24 2.24c0 .88.5 1.63 1.23 2v2.45c-1.39.38-2.48 1.48-2.86 2.87H9.28c-.37-.5-1-.83-1.68-.83-.07 0-.15 0-.22.02V7.15c.61-.35 1.02-.99 1.02-1.74 0-1.1-.9-2-2-2s-2 .9-2 2c0 .75.41 1.39 1.02 1.74v2.28c-.68.22-1.19.8-1.31 1.52H2.24c-.2-.58-.75-1-1.4-1C.38 10 0 10.38 0 10.84s.38.84.84.84c.65 0 1.2-.42 1.4-1h1.87c.12.72.63 1.3 1.31 1.52v5.26c-.61.35-1.02.99-1.02 1.74 0 1.1.9 2 2 2s2-.9 2-2c0-.75-.41-1.39-1.02-1.74v-5.26c.07.02.15.02.22.02.68 0 1.31-.33 1.68-.83h3.32c.38 1.39 1.47 2.49 2.86 2.87v2.45c-.73.37-1.23 1.12-1.23 2 0 1.24 1 2.24 2.24 2.24s2.24-1 2.24-2.24c0-.88-.5-1.63-1.23-2v-2.45c1.84-.5 3.23-2.16 3.23-4.14s-1.39-3.64-3.23-4.14zm-1.01 6.13c-1.1 0-2-.9-2-2s.9-2 2-2 2 .9 2 2-.9 2-2 2z",
+    brandColor: "#FF7A59",
+  },
+  github: {
+    name: "GitHub",
+    slug: "github",
+    category: "tech",
+    viewBox: "0 0 24 24",
+    svgPath: "M12 0C5.37 0 0 5.37 0 12c0 5.31 3.435 9.795 8.205 11.385.6.105.825-.255.825-.57 0-.285-.015-1.23-.015-2.235-3.015.555-3.795-.735-4.035-1.41-.135-.345-.72-1.41-1.23-1.695-.42-.225-1.02-.78-.015-.795.945-.015 1.62.87 1.845 1.23 1.08 1.815 2.805 1.305 3.495.99.105-.78.42-1.305.765-1.605-2.67-.3-5.46-1.335-5.46-5.925 0-1.305.465-2.385 1.23-3.225-.12-.3-.54-1.53.12-3.18 0 0 1.005-.315 3.3 1.23.96-.27 1.98-.405 3-.405s2.04.135 3 .405c2.295-1.56 3.3-1.23 3.3-1.23.66 1.65.24 2.88.12 3.18.765.84 1.23 1.905 1.23 3.225 0 4.605-2.805 5.625-5.475 5.925.435.375.81 1.095.81 2.22 0 1.605-.015 2.895-.015 3.3 0 .315.225.69.825.57A12.02 12.02 0 0 0 24 12c0-6.63-5.37-12-12-12z",
+    brandColor: "#181717",
+  },
+  google: {
+    name: "Google",
+    slug: "google",
+    category: "tech",
+    viewBox: "0 0 24 24",
+    svgPath: "M22.56 12.25c0-.78-.07-1.53-.2-2.25H12v4.26h5.92c-.26 1.37-1.04 2.53-2.21 3.31v2.77h3.57c2.08-1.92 3.28-4.74 3.28-8.09zM12 23c2.97 0 5.46-.98 7.28-2.66l-3.57-2.77c-.98.66-2.23 1.06-3.71 1.06-2.86 0-5.29-1.93-6.16-4.53H2.18v2.84C3.99 20.53 7.7 23 12 23zm-6.16-8.9c-.22-.66-.35-1.36-.35-2.1s.13-1.44.35-2.1V7.06H2.18C1.43 8.55 1 10.22 1 12s.43 3.45 1.18 4.94l2.85-2.22.81-.62zM12 5.38c1.62 0 3.06.56 4.21 1.64l3.15-3.15C17.45 2.09 14.97 1 12 1 7.7 1 3.99 3.47 2.18 7.06l3.66 2.84c.87-2.6 3.3-4.52 6.16-4.52z",
+    brandColor: "#4285F4",
+  },
+};
+
+/**
+ * Resolves a brand SVG vector from text matching or keywords.
+ */
+export function resolveBrandIcon(input: string): BrandIcon | undefined {
+  if (!input || typeof input !== "string") return undefined;
+  const clean = input.toLowerCase().replace(/[^a-z0-9]/g, "");
+
+  for (const [key, icon] of Object.entries(BRAND_ICONS)) {
+    if (clean.includes(key) || clean.includes(icon.slug)) {
+      return icon;
+    }
+  }
+  return undefined;
+}
+
+/**
+ * Returns raw inline SVG markup for a brand icon.
+ */
+export function renderBrandIconSvg(input: string, className: string = "w-5 h-5 inline-block"): string {
+  const icon = resolveBrandIcon(input);
+  if (!icon) return "";
+
+  return `<svg class="${className}" viewBox="${icon.viewBox}" fill="currentColor" aria-hidden="true"><path d="${icon.svgPath}"/></svg>`;
+}