@lynxflow/seo-engine 1.6.1 → 1.6.2

package/dist/index.d.ts

@@ -16,6 +16,8 @@ export * from "./matrix-engine";
 export * from "./built-in-locations";
 export * from "./i18n-detector";
 export * from "./brand-icons";
+export * from "./ui-icons";
+export * from "./og-image-generator";
 export * from "./urlytics-engine";
 export * from "./keyword-permutator";
 export * from "./llm-prompt";

package/dist/index.js

@@ -40,8 +40,10 @@ var __export = (target, all) => {
 var exports_src = {};
 __export(exports_src, {
   validateSeoSlug: () => validateSeoSlug,
+  resolveFeatureIcon: () => resolveFeatureIcon,
   resolveBuiltInLocations: () => resolveBuiltInLocations,
   resolveBrandIcon: () => resolveBrandIcon,
+  renderUiIconSvg: () => renderUiIconSvg,
   renderBrandIconSvg: () => renderBrandIconSvg,
   getSeoAgentPrompt: () => getSeoAgentPrompt,
   default: () => src_default,
@@ -49,6 +51,7 @@ __export(exports_src, {
   cleanSeoSlug: () => cleanSeoSlug,
   YoastParityEngine: () => YoastParityEngine,
   UrlyticsEngine: () => UrlyticsEngine,
+  UI_ICONS: () => UI_ICONS,
   TokenQuotaManager: () => TokenQuotaManager,
   TechnicalRulesAuditor: () => TechnicalRulesAuditor,
   TeamRbacEngine: () => TeamRbacEngine,
@@ -68,6 +71,7 @@ __export(exports_src, {
   RankMathParityEngine: () => RankMathParityEngine,
   PseoMatrixEngine: () => PseoMatrixEngine,
   PSEO_AGENT_SYSTEM_PROMPT: () => PSEO_AGENT_SYSTEM_PROMPT,
+  OgImageGenerator: () => OgImageGenerator,
   NGramDensityAnalyzer: () => NGramDensityAnalyzer,
   McpSeoServerHub: () => McpSeoServerHub,
   MasterMarketingEngine: () => MasterMarketingEngine,
@@ -3338,6 +3342,87 @@ function resolveBuiltInLocations(territories) {
   return results.length > 0 ? results : [...BUILT_IN_LOCATIONS_DATABASE.fr];
 }
 
+// src/og-image-generator.ts
+class OgImageGenerator {
+  static generateOgImageUrl(domain, pageMeta, brandName) {
+    const cleanDomain = domain.replace(/\/+$/, "");
+    const params = new URLSearchParams({
+      title: pageMeta.h1 || pageMeta.title,
+      badge: pageMeta.matrixFamily.toUpperCase(),
+      desc: pageMeta.description ? pageMeta.description.slice(0, 120) : "",
+      brand: brandName
+    });
+    if (pageMeta.location) {
+      params.set("loc", `${pageMeta.location.name}, ${pageMeta.location.country}`);
+    }
+    return `${cleanDomain}/api/og?${params.toString()}`;
+  }
+  static renderDynamicOgSvg(opts) {
+    const brand = opts.brandName || "LynxSEO";
+    const badge = opts.badgeText || "OFFICIAL";
+    const title = opts.title.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+    const loc = opts.locationName ? `\uD83D\uDCCD ${opts.locationName}` : "⚡ Instant Cloud Setup";
+    const rating = opts.ratingValue ?? 4.9;
+    const reviews = opts.reviewCount ?? 1280;
+    const accent = opts.brandColor || "#6366F1";
+    return `<svg width="1200" height="630" viewBox="0 0 1200 630" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#090D16"/>
+      <stop offset="50%" stop-color="#0F172A"/>
+      <stop offset="100%" stop-color="#020617"/>
+    </linearGradient>
+    <linearGradient id="textGrad" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#FFFFFF"/>
+      <stop offset="100%" stop-color="#CBD5E1"/>
+    </linearGradient>
+    <filter id="glow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="80" result="blur" />
+    </filter>
+  </defs>
+
+  <!-- Background -->
+  <rect width="1200" height="630" fill="url(#bgGrad)"/>
+  
+  <!-- Subtle Ambient Glow -->
+  <circle cx="200" cy="150" r="220" fill="${accent}" opacity="0.15" filter="url(#glow)"/>
+  <circle cx="1000" cy="480" r="260" fill="${accent}" opacity="0.12" filter="url(#glow)"/>
+
+  <!-- Top Glassmorphism Badge -->
+  <g transform="translate(80, 80)">
+    <rect width="220" height="42" rx="21" fill="${accent}" fill-opacity="0.15" stroke="${accent}" stroke-opacity="0.4" stroke-width="1.5"/>
+    <text x="110" y="26" fill="#FFFFFF" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="14" font-weight="700" text-anchor="middle" letter-spacing="1.5">${badge}</text>
+  </g>
+
+  <!-- Location / Scope Pill -->
+  <g transform="translate(320, 80)">
+    <rect width="260" height="42" rx="21" fill="#1E293B" fill-opacity="0.6" stroke="#334155" stroke-width="1"/>
+    <text x="130" y="26" fill="#94A3B8" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="14" font-weight="600" text-anchor="middle">${loc}</text>
+  </g>
+
+  <!-- Giant Title -->
+  <text x="80" y="250" fill="url(#textGrad)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="52" font-weight="900" letter-spacing="-1.5">
+    <tspan x="80" dy="0">${title.slice(0, 38)}</tspan>
+    ${title.length > 38 ? `<tspan x="80" dy="68">${title.slice(38, 80)}</tspan>` : ""}
+  </text>
+
+  <!-- Trust Stars & Social Proof -->
+  <g transform="translate(80, 470)">
+    <text x="0" y="32" fill="#FBBF24" font-size="24">★★★★★</text>
+    <text x="140" y="30" fill="#F8FAFC" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="20" font-weight="800">${rating} / 5</text>
+    <text x="210" y="30" fill="#64748B" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="16" font-weight="500">(${reviews.toLocaleString()} verified reviews)</text>
+  </g>
+
+  <!-- Footer Brand -->
+  <g transform="translate(80, 540)">
+    <line x1="0" y1="0" x2="1040" y2="0" stroke="#1E293B" stroke-width="1.5"/>
+    <text x="0" y="42" fill="#FFFFFF" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="20" font-weight="800">${brand}</text>
+    <text x="1040" y="42" fill="#64748B" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="16" font-weight="500" text-anchor="end">Engineered with @lynxflow/seo-engine</text>
+  </g>
+</svg>`;
+  }
+}
+
 // src/matrix-engine.ts
 class PseoMatrixEngine {
   legalEngine;
@@ -3842,6 +3927,11 @@ class PseoMatrixEngine {
     if (data.calculators) {
       allPages.push(...this.generateCalculatorMatrix(domain, data.calculators, options));
     }
+    for (const p of allPages) {
+      if (!p.ogImageUrl) {
+        p.ogImageUrl = OgImageGenerator.generateOgImageUrl(domain, p, options.brandName);
+      }
+    }
     return allPages;
   }
   resolvePage(slugOrPath, domain, data, options) {
@@ -4085,6 +4175,119 @@ function renderBrandIconSvg(input, className = "w-5 h-5 inline-block") {
     return "";
   return `<svg class="${className}" viewBox="${icon.viewBox}" fill="currentColor" aria-hidden="true"><path d="${icon.svgPath}"/></svg>`;
 }
+// src/ui-icons.ts
+var UI_ICONS = {
+  zap: {
+    name: "Zap / Lightning",
+    viewBox: "0 0 24 24",
+    svgPath: '<polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>'
+  },
+  shield: {
+    name: "Shield / Security",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>'
+  },
+  star: {
+    name: "Star / Rating",
+    viewBox: "0 0 24 24",
+    svgPath: '<polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2" fill="currentColor"/>'
+  },
+  chart: {
+    name: "Chart / Analytics",
+    viewBox: "0 0 24 24",
+    svgPath: '<line x1="18" y1="20" x2="18" y2="10" stroke="currentColor" stroke-width="2" stroke-linecap="round"/><line x1="12" y1="20" x2="12" y2="4" stroke="currentColor" stroke-width="2" stroke-linecap="round"/><line x1="6" y1="20" x2="6" y2="14" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>'
+  },
+  calendar: {
+    name: "Calendar / Scheduling",
+    viewBox: "0 0 24 24",
+    svgPath: '<rect x="3" y="4" width="18" height="18" rx="2" ry="2" fill="none" stroke="currentColor" stroke-width="2"/><line x1="16" y1="2" x2="16" y2="6" stroke="currentColor" stroke-width="2"/><line x1="8" y1="2" x2="8" y2="6" stroke="currentColor" stroke-width="2"/><line x1="3" y1="10" x2="21" y2="10" stroke="currentColor" stroke-width="2"/>'
+  },
+  users: {
+    name: "Users / Team",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2" fill="none" stroke="currentColor" stroke-width="2"/><circle cx="9" cy="7" r="4" fill="none" stroke="currentColor" stroke-width="2"/><path d="M23 21v-2a4 4 0 0 0-3-3.87" fill="none" stroke="currentColor" stroke-width="2"/><path d="M16 3.13a4 4 0 0 1 0 7.75" fill="none" stroke="currentColor" stroke-width="2"/>'
+  },
+  rocket: {
+    name: "Rocket / Speed",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M4.5 16.5c-1.5 1.26-2 5-2 5s3.74-.5 5-2c.71-.84.7-2.13-.09-2.91a2.18 2.18 0 0 0-2.91-.09z" fill="none" stroke="currentColor" stroke-width="2"/><path d="m12 15-3-3a22 22 0 0 1 2-3.95A12.88 12.88 0 0 1 22 2c0 2.72-.78 7.5-6 11a22.35 22.35 0 0 1-4 2z" fill="none" stroke="currentColor" stroke-width="2"/>'
+  },
+  sparkles: {
+    name: "Sparkles / AI",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="m12 3-1.9 5.8a2 2 0 0 1-1.3 1.3L3 12l5.8 1.9a2 2 0 0 1 1.3 1.3L12 21l1.9-5.8a2 2 0 0 1 1.3-1.3L21 12l-5.8-1.9a2 2 0 0 1-1.3-1.3L12 3z" fill="none" stroke="currentColor" stroke-width="2" stroke-linejoin="round"/>'
+  },
+  check: {
+    name: "Check / Success",
+    viewBox: "0 0 24 24",
+    svgPath: '<polyline points="20 6 9 17 4 12" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>'
+  },
+  lock: {
+    name: "Lock / Privacy",
+    viewBox: "0 0 24 24",
+    svgPath: '<rect x="3" y="11" width="18" height="11" rx="2" ry="2" fill="none" stroke="currentColor" stroke-width="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4" fill="none" stroke="currentColor" stroke-width="2"/>'
+  },
+  clock: {
+    name: "Clock / 24-7",
+    viewBox: "0 0 24 24",
+    svgPath: '<circle cx="12" cy="12" r="10" fill="none" stroke="currentColor" stroke-width="2"/><polyline points="12 6 12 12 16 14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>'
+  },
+  phone: {
+    name: "Phone / Contact",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M22 16.92v3a2 2 0 0 1-2.18 2 19.79 19.79 0 0 1-8.63-3.07 19.5 19.5 0 0 1-6-6 19.79 19.79 0 0 1-3.07-8.67A2 2 0 0 1 4.11 2h3a2 2 0 0 1 2 1.72 12.84 12.84 0 0 0 .7 2.81 2 2 0 0 1-.45 2.11L8.09 9.91a16 16 0 0 0 6 6l1.27-1.27a2 2 0 0 1 2.11-.45 12.84 12.84 0 0 0 2.81.7A2 2 0 0 1 22 16.92z" fill="none" stroke="currentColor" stroke-width="2"/>'
+  },
+  mapPin: {
+    name: "Map Pin / Local",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0 1 18 0z" fill="none" stroke="currentColor" stroke-width="2"/><circle cx="12" cy="10" r="3" fill="none" stroke="currentColor" stroke-width="2"/>'
+  },
+  euro: {
+    name: "Euro / Pricing",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M4 10h12M4 14h9M19 6a7.7 7.7 0 0 0-5.2-2A7.9 7.9 0 0 0 6 12a7.9 7.9 0 0 0 7.8 8 7.7 7.7 0 0 0 5.2-2" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>'
+  },
+  arrowRight: {
+    name: "Arrow Right",
+    viewBox: "0 0 24 24",
+    svgPath: '<line x1="5" y1="12" x2="19" y2="12" stroke="currentColor" stroke-width="2" stroke-linecap="round"/><polyline points="12 5 19 12 12 19" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>'
+  }
+};
+function renderUiIconSvg(iconName, className = "w-5 h-5 inline-block") {
+  const icon = UI_ICONS[iconName.toLowerCase()] || UI_ICONS.check;
+  return `<svg class="${className}" viewBox="${icon.viewBox}" aria-hidden="true">${icon.svgPath}</svg>`;
+}
+function resolveFeatureIcon(featureText) {
+  const lower = featureText.toLowerCase();
+  if (lower.includes("secur") || lower.includes("rgpd") || lower.includes("gdpr") || lower.includes("protect") || lower.includes("bank")) {
+    return "shield";
+  }
+  if (lower.includes("sync") || lower.includes("speed") || lower.includes("instant") || lower.includes("real-time") || lower.includes("fast") || lower.includes("rapide")) {
+    return "zap";
+  }
+  if (lower.includes("ai") || lower.includes("ia") || lower.includes("auto") || lower.includes("smart") || lower.includes("intel")) {
+    return "sparkles";
+  }
+  if (lower.includes("chart") || lower.includes("analyt") || lower.includes("report") || lower.includes("stat") || lower.includes("roi") || lower.includes("kpi")) {
+    return "chart";
+  }
+  if (lower.includes("schedul") || lower.includes("calen") || lower.includes("plan") || lower.includes("agenda")) {
+    return "calendar";
+  }
+  if (lower.includes("user") || lower.includes("team") || lower.includes("collab") || lower.includes("client") || lower.includes("contact")) {
+    return "users";
+  }
+  if (lower.includes("price") || lower.includes("tarif") || lower.includes("cost") || lower.includes("devis") || lower.includes("factur")) {
+    return "euro";
+  }
+  if (lower.includes("local") || lower.includes("city") || lower.includes("ville") || lower.includes("map") || lower.includes("gps")) {
+    return "mapPin";
+  }
+  if (lower.includes("24/7") || lower.includes("support") || lower.includes("hour") || lower.includes("time") || lower.includes("temps")) {
+    return "clock";
+  }
+  return "zap";
+}
 // src/urlytics-engine.ts
 class UrlyticsEngine {
   static parseUrl(rawUrl) {
@@ -4495,22 +4698,30 @@ The SDK equips applications with 9 enterprise-grade SEO engines:
 4. **\uD83C\uDFA8 Vector Brand & Social Icons (\`renderBrandIconSvg\`):**
    - Zero-dependency official SVG vectors for 30+ brands (Facebook, Instagram, LinkedIn, Shopify, Slack, WhatsApp, Google, GitHub, TikTok, YouTube).
 
-5. **\uD83C\uDFDB️ Google Schema.org Rich Graphs (\`ExtendedSchemaGraphBuilder\`):**
+5. **✨ Standard UI & Feature Icons (\`renderUiIconSvg\`, \`resolveFeatureIcon\`):**
+   - Zero-dependency Lucide-style vector icons (shield, zap, chart, calendar, users, rocket, sparkles, check, lock, clock, phone, mapPin, euro).
+   - Semantic keyword auto-resolver: Automatically maps feature copy to the most relevant icon.
+
+6. **\uD83D\uDDBC️ Dynamic OpenGraph (OG) Image Generator (\`OgImageGenerator\`):**
+   - \`renderDynamicOgSvg(opts)\`: Generates high-converting 1200x630 SVG social cards with glassmorphism badges, star ratings, and gradient backdrops.
+   - \`generateOgImageUrl(domain, pageMeta, brandName)\`: Edge-ready query URL for \`app/api/og/route.ts\`.
+
+7. **\uD83C\uDFDB️ Google Schema.org Rich Graphs (\`ExtendedSchemaGraphBuilder\`):**
    - \`buildAggregateRating\` (Google Gold Stars 4.9★), \`buildAggregateOffer\` (price ranges), \`buildLocalBusiness\` (GPS & opening hours), \`buildSoftwareApplication\`, \`buildHowTo\`, \`buildFAQPage\`, \`buildBreadcrumbs\`.
 
-6. **\uD83D\uDD0D URL Decomposition & Analysis (\`UrlyticsEngine\`):**
+8. **\uD83D\uDD0D URL Decomposition & Analysis (\`UrlyticsEngine\`):**
    - Deep structural directory decomposition, depth tracking, query parameter analysis, and slug tokenization (inspired by advertools).
 
-7. **⚡ SEM Keyword Combinator (\`KeywordPermutatorEngine\`):**
+9. **⚡ SEM Keyword Combinator (\`KeywordPermutatorEngine\`):**
    - Combinatorial matrix generation: Products × Modifiers × Locations with match types (\`[exact]\`, \`"phrase"\`, \`+broad\`) and intent classification.
 
-8. **⚖️ Legal & Editorial Compliance (\`LegalDisclaimerEngine\`):**
+10. **⚖️ Legal & Editorial Compliance (\`LegalDisclaimerEngine\`):**
    - 7 SeedRank-grade disclaimer templates, 90-day staleness verification, and multi-language anti-disparagement guardian.
 
-9. **\uD83D\uDCCA Telemetry & Cloud Metering (\`matrixEngine.getTelemetryPayload\` & \`LynxAnalyticsClient\`):**
+11. **\uD83D\uDCCA Telemetry & Cloud Metering (\`matrixEngine.getTelemetryPayload\` & \`LynxAnalyticsClient\`):**
    - Synchronizes total programmatic pages, indexed hubs, and AI bot crawl hits (GPTBot, ClaudeBot, PerplexityBot) with the LynxSEO Studio dashboard.
 
-10. **\uD83E\uDDF9 URL Slug Engine & Schema.org Graphs:**
+12. **\uD83E\uDDF9 URL Slug Engine & Schema.org Graphs:**
    - \`cleanSeoSlug(text, { language })\`: Strips accents, stop words across 10+ languages, and non-alphanumeric noise.
    - Outputs Google-validated Schema.org JSON-LD graphs with 0 syntax errors.
 `.trim();

package/dist/index.mjs

@@ -3231,6 +3231,87 @@ function resolveBuiltInLocations(territories) {
   return results.length > 0 ? results : [...BUILT_IN_LOCATIONS_DATABASE.fr];
 }
 
+// src/og-image-generator.ts
+class OgImageGenerator {
+  static generateOgImageUrl(domain, pageMeta, brandName) {
+    const cleanDomain = domain.replace(/\/+$/, "");
+    const params = new URLSearchParams({
+      title: pageMeta.h1 || pageMeta.title,
+      badge: pageMeta.matrixFamily.toUpperCase(),
+      desc: pageMeta.description ? pageMeta.description.slice(0, 120) : "",
+      brand: brandName
+    });
+    if (pageMeta.location) {
+      params.set("loc", `${pageMeta.location.name}, ${pageMeta.location.country}`);
+    }
+    return `${cleanDomain}/api/og?${params.toString()}`;
+  }
+  static renderDynamicOgSvg(opts) {
+    const brand = opts.brandName || "LynxSEO";
+    const badge = opts.badgeText || "OFFICIAL";
+    const title = opts.title.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+    const loc = opts.locationName ? `\uD83D\uDCCD ${opts.locationName}` : "⚡ Instant Cloud Setup";
+    const rating = opts.ratingValue ?? 4.9;
+    const reviews = opts.reviewCount ?? 1280;
+    const accent = opts.brandColor || "#6366F1";
+    return `<svg width="1200" height="630" viewBox="0 0 1200 630" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#090D16"/>
+      <stop offset="50%" stop-color="#0F172A"/>
+      <stop offset="100%" stop-color="#020617"/>
+    </linearGradient>
+    <linearGradient id="textGrad" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#FFFFFF"/>
+      <stop offset="100%" stop-color="#CBD5E1"/>
+    </linearGradient>
+    <filter id="glow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="80" result="blur" />
+    </filter>
+  </defs>
+
+  <!-- Background -->
+  <rect width="1200" height="630" fill="url(#bgGrad)"/>
+  
+  <!-- Subtle Ambient Glow -->
+  <circle cx="200" cy="150" r="220" fill="${accent}" opacity="0.15" filter="url(#glow)"/>
+  <circle cx="1000" cy="480" r="260" fill="${accent}" opacity="0.12" filter="url(#glow)"/>
+
+  <!-- Top Glassmorphism Badge -->
+  <g transform="translate(80, 80)">
+    <rect width="220" height="42" rx="21" fill="${accent}" fill-opacity="0.15" stroke="${accent}" stroke-opacity="0.4" stroke-width="1.5"/>
+    <text x="110" y="26" fill="#FFFFFF" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="14" font-weight="700" text-anchor="middle" letter-spacing="1.5">${badge}</text>
+  </g>
+
+  <!-- Location / Scope Pill -->
+  <g transform="translate(320, 80)">
+    <rect width="260" height="42" rx="21" fill="#1E293B" fill-opacity="0.6" stroke="#334155" stroke-width="1"/>
+    <text x="130" y="26" fill="#94A3B8" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="14" font-weight="600" text-anchor="middle">${loc}</text>
+  </g>
+
+  <!-- Giant Title -->
+  <text x="80" y="250" fill="url(#textGrad)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="52" font-weight="900" letter-spacing="-1.5">
+    <tspan x="80" dy="0">${title.slice(0, 38)}</tspan>
+    ${title.length > 38 ? `<tspan x="80" dy="68">${title.slice(38, 80)}</tspan>` : ""}
+  </text>
+
+  <!-- Trust Stars & Social Proof -->
+  <g transform="translate(80, 470)">
+    <text x="0" y="32" fill="#FBBF24" font-size="24">★★★★★</text>
+    <text x="140" y="30" fill="#F8FAFC" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="20" font-weight="800">${rating} / 5</text>
+    <text x="210" y="30" fill="#64748B" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="16" font-weight="500">(${reviews.toLocaleString()} verified reviews)</text>
+  </g>
+
+  <!-- Footer Brand -->
+  <g transform="translate(80, 540)">
+    <line x1="0" y1="0" x2="1040" y2="0" stroke="#1E293B" stroke-width="1.5"/>
+    <text x="0" y="42" fill="#FFFFFF" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="20" font-weight="800">${brand}</text>
+    <text x="1040" y="42" fill="#64748B" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="16" font-weight="500" text-anchor="end">Engineered with @lynxflow/seo-engine</text>
+  </g>
+</svg>`;
+  }
+}
+
 // src/matrix-engine.ts
 class PseoMatrixEngine {
   legalEngine;
@@ -3735,6 +3816,11 @@ class PseoMatrixEngine {
     if (data.calculators) {
       allPages.push(...this.generateCalculatorMatrix(domain, data.calculators, options));
     }
+    for (const p of allPages) {
+      if (!p.ogImageUrl) {
+        p.ogImageUrl = OgImageGenerator.generateOgImageUrl(domain, p, options.brandName);
+      }
+    }
     return allPages;
   }
   resolvePage(slugOrPath, domain, data, options) {
@@ -3978,6 +4064,119 @@ function renderBrandIconSvg(input, className = "w-5 h-5 inline-block") {
     return "";
   return `<svg class="${className}" viewBox="${icon.viewBox}" fill="currentColor" aria-hidden="true"><path d="${icon.svgPath}"/></svg>`;
 }
+// src/ui-icons.ts
+var UI_ICONS = {
+  zap: {
+    name: "Zap / Lightning",
+    viewBox: "0 0 24 24",
+    svgPath: '<polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>'
+  },
+  shield: {
+    name: "Shield / Security",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>'
+  },
+  star: {
+    name: "Star / Rating",
+    viewBox: "0 0 24 24",
+    svgPath: '<polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2" fill="currentColor"/>'
+  },
+  chart: {
+    name: "Chart / Analytics",
+    viewBox: "0 0 24 24",
+    svgPath: '<line x1="18" y1="20" x2="18" y2="10" stroke="currentColor" stroke-width="2" stroke-linecap="round"/><line x1="12" y1="20" x2="12" y2="4" stroke="currentColor" stroke-width="2" stroke-linecap="round"/><line x1="6" y1="20" x2="6" y2="14" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>'
+  },
+  calendar: {
+    name: "Calendar / Scheduling",
+    viewBox: "0 0 24 24",
+    svgPath: '<rect x="3" y="4" width="18" height="18" rx="2" ry="2" fill="none" stroke="currentColor" stroke-width="2"/><line x1="16" y1="2" x2="16" y2="6" stroke="currentColor" stroke-width="2"/><line x1="8" y1="2" x2="8" y2="6" stroke="currentColor" stroke-width="2"/><line x1="3" y1="10" x2="21" y2="10" stroke="currentColor" stroke-width="2"/>'
+  },
+  users: {
+    name: "Users / Team",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2" fill="none" stroke="currentColor" stroke-width="2"/><circle cx="9" cy="7" r="4" fill="none" stroke="currentColor" stroke-width="2"/><path d="M23 21v-2a4 4 0 0 0-3-3.87" fill="none" stroke="currentColor" stroke-width="2"/><path d="M16 3.13a4 4 0 0 1 0 7.75" fill="none" stroke="currentColor" stroke-width="2"/>'
+  },
+  rocket: {
+    name: "Rocket / Speed",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M4.5 16.5c-1.5 1.26-2 5-2 5s3.74-.5 5-2c.71-.84.7-2.13-.09-2.91a2.18 2.18 0 0 0-2.91-.09z" fill="none" stroke="currentColor" stroke-width="2"/><path d="m12 15-3-3a22 22 0 0 1 2-3.95A12.88 12.88 0 0 1 22 2c0 2.72-.78 7.5-6 11a22.35 22.35 0 0 1-4 2z" fill="none" stroke="currentColor" stroke-width="2"/>'
+  },
+  sparkles: {
+    name: "Sparkles / AI",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="m12 3-1.9 5.8a2 2 0 0 1-1.3 1.3L3 12l5.8 1.9a2 2 0 0 1 1.3 1.3L12 21l1.9-5.8a2 2 0 0 1 1.3-1.3L21 12l-5.8-1.9a2 2 0 0 1-1.3-1.3L12 3z" fill="none" stroke="currentColor" stroke-width="2" stroke-linejoin="round"/>'
+  },
+  check: {
+    name: "Check / Success",
+    viewBox: "0 0 24 24",
+    svgPath: '<polyline points="20 6 9 17 4 12" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>'
+  },
+  lock: {
+    name: "Lock / Privacy",
+    viewBox: "0 0 24 24",
+    svgPath: '<rect x="3" y="11" width="18" height="11" rx="2" ry="2" fill="none" stroke="currentColor" stroke-width="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4" fill="none" stroke="currentColor" stroke-width="2"/>'
+  },
+  clock: {
+    name: "Clock / 24-7",
+    viewBox: "0 0 24 24",
+    svgPath: '<circle cx="12" cy="12" r="10" fill="none" stroke="currentColor" stroke-width="2"/><polyline points="12 6 12 12 16 14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>'
+  },
+  phone: {
+    name: "Phone / Contact",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M22 16.92v3a2 2 0 0 1-2.18 2 19.79 19.79 0 0 1-8.63-3.07 19.5 19.5 0 0 1-6-6 19.79 19.79 0 0 1-3.07-8.67A2 2 0 0 1 4.11 2h3a2 2 0 0 1 2 1.72 12.84 12.84 0 0 0 .7 2.81 2 2 0 0 1-.45 2.11L8.09 9.91a16 16 0 0 0 6 6l1.27-1.27a2 2 0 0 1 2.11-.45 12.84 12.84 0 0 0 2.81.7A2 2 0 0 1 22 16.92z" fill="none" stroke="currentColor" stroke-width="2"/>'
+  },
+  mapPin: {
+    name: "Map Pin / Local",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0 1 18 0z" fill="none" stroke="currentColor" stroke-width="2"/><circle cx="12" cy="10" r="3" fill="none" stroke="currentColor" stroke-width="2"/>'
+  },
+  euro: {
+    name: "Euro / Pricing",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M4 10h12M4 14h9M19 6a7.7 7.7 0 0 0-5.2-2A7.9 7.9 0 0 0 6 12a7.9 7.9 0 0 0 7.8 8 7.7 7.7 0 0 0 5.2-2" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>'
+  },
+  arrowRight: {
+    name: "Arrow Right",
+    viewBox: "0 0 24 24",
+    svgPath: '<line x1="5" y1="12" x2="19" y2="12" stroke="currentColor" stroke-width="2" stroke-linecap="round"/><polyline points="12 5 19 12 12 19" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>'
+  }
+};
+function renderUiIconSvg(iconName, className = "w-5 h-5 inline-block") {
+  const icon = UI_ICONS[iconName.toLowerCase()] || UI_ICONS.check;
+  return `<svg class="${className}" viewBox="${icon.viewBox}" aria-hidden="true">${icon.svgPath}</svg>`;
+}
+function resolveFeatureIcon(featureText) {
+  const lower = featureText.toLowerCase();
+  if (lower.includes("secur") || lower.includes("rgpd") || lower.includes("gdpr") || lower.includes("protect") || lower.includes("bank")) {
+    return "shield";
+  }
+  if (lower.includes("sync") || lower.includes("speed") || lower.includes("instant") || lower.includes("real-time") || lower.includes("fast") || lower.includes("rapide")) {
+    return "zap";
+  }
+  if (lower.includes("ai") || lower.includes("ia") || lower.includes("auto") || lower.includes("smart") || lower.includes("intel")) {
+    return "sparkles";
+  }
+  if (lower.includes("chart") || lower.includes("analyt") || lower.includes("report") || lower.includes("stat") || lower.includes("roi") || lower.includes("kpi")) {
+    return "chart";
+  }
+  if (lower.includes("schedul") || lower.includes("calen") || lower.includes("plan") || lower.includes("agenda")) {
+    return "calendar";
+  }
+  if (lower.includes("user") || lower.includes("team") || lower.includes("collab") || lower.includes("client") || lower.includes("contact")) {
+    return "users";
+  }
+  if (lower.includes("price") || lower.includes("tarif") || lower.includes("cost") || lower.includes("devis") || lower.includes("factur")) {
+    return "euro";
+  }
+  if (lower.includes("local") || lower.includes("city") || lower.includes("ville") || lower.includes("map") || lower.includes("gps")) {
+    return "mapPin";
+  }
+  if (lower.includes("24/7") || lower.includes("support") || lower.includes("hour") || lower.includes("time") || lower.includes("temps")) {
+    return "clock";
+  }
+  return "zap";
+}
 // src/urlytics-engine.ts
 class UrlyticsEngine {
   static parseUrl(rawUrl) {
@@ -4388,22 +4587,30 @@ The SDK equips applications with 9 enterprise-grade SEO engines:
 4. **\uD83C\uDFA8 Vector Brand & Social Icons (\`renderBrandIconSvg\`):**
    - Zero-dependency official SVG vectors for 30+ brands (Facebook, Instagram, LinkedIn, Shopify, Slack, WhatsApp, Google, GitHub, TikTok, YouTube).
 
-5. **\uD83C\uDFDB️ Google Schema.org Rich Graphs (\`ExtendedSchemaGraphBuilder\`):**
+5. **✨ Standard UI & Feature Icons (\`renderUiIconSvg\`, \`resolveFeatureIcon\`):**
+   - Zero-dependency Lucide-style vector icons (shield, zap, chart, calendar, users, rocket, sparkles, check, lock, clock, phone, mapPin, euro).
+   - Semantic keyword auto-resolver: Automatically maps feature copy to the most relevant icon.
+
+6. **\uD83D\uDDBC️ Dynamic OpenGraph (OG) Image Generator (\`OgImageGenerator\`):**
+   - \`renderDynamicOgSvg(opts)\`: Generates high-converting 1200x630 SVG social cards with glassmorphism badges, star ratings, and gradient backdrops.
+   - \`generateOgImageUrl(domain, pageMeta, brandName)\`: Edge-ready query URL for \`app/api/og/route.ts\`.
+
+7. **\uD83C\uDFDB️ Google Schema.org Rich Graphs (\`ExtendedSchemaGraphBuilder\`):**
    - \`buildAggregateRating\` (Google Gold Stars 4.9★), \`buildAggregateOffer\` (price ranges), \`buildLocalBusiness\` (GPS & opening hours), \`buildSoftwareApplication\`, \`buildHowTo\`, \`buildFAQPage\`, \`buildBreadcrumbs\`.
 
-6. **\uD83D\uDD0D URL Decomposition & Analysis (\`UrlyticsEngine\`):**
+8. **\uD83D\uDD0D URL Decomposition & Analysis (\`UrlyticsEngine\`):**
    - Deep structural directory decomposition, depth tracking, query parameter analysis, and slug tokenization (inspired by advertools).
 
-7. **⚡ SEM Keyword Combinator (\`KeywordPermutatorEngine\`):**
+9. **⚡ SEM Keyword Combinator (\`KeywordPermutatorEngine\`):**
    - Combinatorial matrix generation: Products × Modifiers × Locations with match types (\`[exact]\`, \`"phrase"\`, \`+broad\`) and intent classification.
 
-8. **⚖️ Legal & Editorial Compliance (\`LegalDisclaimerEngine\`):**
+10. **⚖️ Legal & Editorial Compliance (\`LegalDisclaimerEngine\`):**
    - 7 SeedRank-grade disclaimer templates, 90-day staleness verification, and multi-language anti-disparagement guardian.
 
-9. **\uD83D\uDCCA Telemetry & Cloud Metering (\`matrixEngine.getTelemetryPayload\` & \`LynxAnalyticsClient\`):**
+11. **\uD83D\uDCCA Telemetry & Cloud Metering (\`matrixEngine.getTelemetryPayload\` & \`LynxAnalyticsClient\`):**
    - Synchronizes total programmatic pages, indexed hubs, and AI bot crawl hits (GPTBot, ClaudeBot, PerplexityBot) with the LynxSEO Studio dashboard.
 
-10. **\uD83E\uDDF9 URL Slug Engine & Schema.org Graphs:**
+12. **\uD83E\uDDF9 URL Slug Engine & Schema.org Graphs:**
    - \`cleanSeoSlug(text, { language })\`: Strips accents, stop words across 10+ languages, and non-alphanumeric noise.
    - Outputs Google-validated Schema.org JSON-LD graphs with 0 syntax errors.
 `.trim();
@@ -6552,8 +6759,10 @@ var LynxSeo = {
 var src_default = LynxSeo;
 export {
   validateSeoSlug,
+  resolveFeatureIcon,
   resolveBuiltInLocations,
   resolveBrandIcon,
+  renderUiIconSvg,
   renderBrandIconSvg,
   getSeoAgentPrompt,
   src_default as default,
@@ -6561,6 +6770,7 @@ export {
   cleanSeoSlug,
   YoastParityEngine,
   UrlyticsEngine,
+  UI_ICONS,
   TokenQuotaManager,
   TechnicalRulesAuditor,
   TeamRbacEngine,
@@ -6580,6 +6790,7 @@ export {
   RankMathParityEngine,
   PseoMatrixEngine,
   PSEO_AGENT_SYSTEM_PROMPT,
+  OgImageGenerator,
   NGramDensityAnalyzer,
   McpSeoServerHub,
   MasterMarketingEngine,

package/dist/matrix-engine.d.ts

@@ -110,6 +110,7 @@ export interface GeneratedPageMeta {
     robots: "index, follow" | "noindex, follow";
     schemaGraph: SchemaOrgGraph;
     disclaimerText?: string;
+    ogImageUrl?: string;
     neighboringLinks?: {
         name: string;
         url: string;

package/dist/og-image-generator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 🖼️ Dynamic OpenGraph (OG) & Social Card Image Generator
+ * Generates high-converting 1200x630 SVG social preview cards and URL queries
+ * with zero heavy headless browser dependencies (Puppeteer/Playwright free).
+ */
+import { GeneratedPageMeta } from "./matrix-engine";
+export interface OgImageOptions {
+    brandName: string;
+    title: string;
+    badgeText?: string;
+    subtitle?: string;
+    locationName?: string;
+    ratingValue?: number;
+    reviewCount?: number;
+    brandColor?: string;
+}
+export declare class OgImageGenerator {
+    /**
+     * Generates a fully formatted URL for dynamic Edge / API OG image generation.
+     * e.g. /api/og?title=...&badge=...&city=...
+     */
+    static generateOgImageUrl(domain: string, pageMeta: GeneratedPageMeta, brandName: string): string;
+    /**
+     * Generates an ultra-crisp 1200x630 pure SVG image string for social previews.
+     */
+    static renderDynamicOgSvg(opts: OgImageOptions): string;
+}

package/dist/ui-icons.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 🎨 Universal Zero-Dependency UI & Feature SVG Icons
+ * Provides crisp, modern Lucide-style vector icons for features, trust badges, and UI components.
+ * Includes automatic semantic keyword-to-icon detection for feature descriptions.
+ */
+export interface UiIcon {
+    name: string;
+    viewBox: string;
+    svgPath: string;
+}
+export declare const UI_ICONS: Record<string, UiIcon>;
+/**
+ * Returns raw inline SVG markup for a standard UI icon.
+ */
+export declare function renderUiIconSvg(iconName: string, className?: string): string;
+/**
+ * Semantically resolves the most relevant UI icon based on feature text keywords.
+ */
+export declare function resolveFeatureIcon(featureText: string): string;

package/package.json

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

package/src/engine.test.ts

@@ -8,6 +8,8 @@ import { UrlyticsEngine } from "./urlytics-engine";
 import { KeywordPermutatorEngine } from "./keyword-permutator";
 import { renderBrandIconSvg } from "./brand-icons";
 import { I18nDetector } from "./i18n-detector";
+import { renderUiIconSvg, resolveFeatureIcon } from "./ui-icons";
+import { OgImageGenerator } from "./og-image-generator";
 
 describe("Multilingual SEO Slug Engine (10+ Languages)", () => {
   it("English: Strips stop words and years", () => {
@@ -265,4 +267,43 @@ describe("Audited Reference Engines (Advertools, Santifer, Seonaut)", () => {
     expect(telemetry.brandName).toBe("Acme");
     expect(telemetry.servicesCount).toBe(1);
   });
+
+  it("UI Icons: Renders standard Lucide-style SVG and resolves semantic feature icons", () => {
+    const shieldSvg = renderUiIconSvg("shield");
+    expect(shieldSvg).toContain("<svg");
+    expect(shieldSvg).toContain("viewBox");
+
+    expect(resolveFeatureIcon("Bank-grade RGPD Security")).toBe("shield");
+    expect(resolveFeatureIcon("Real-time automated sync")).toBe("zap");
+    expect(resolveFeatureIcon("Analytics dashboard & KPI tracker")).toBe("chart");
+    expect(resolveFeatureIcon("Smart AI content generator")).toBe("sparkles");
+  });
+
+  it("OgImageGenerator: Generates dynamic 1200x630 SVG and Edge URL query", () => {
+    const ogSvg = OgImageGenerator.renderDynamicOgSvg({
+      brandName: "Acme Cloud",
+      title: "Autopost Facebook & Instagram in Paris",
+      badgeText: "SOCIAL MEDIA",
+      locationName: "Paris, France",
+      ratingValue: 4.9,
+      reviewCount: 1280,
+    });
+    expect(ogSvg).toContain("<svg width=\"1200\" height=\"630\"");
+    expect(ogSvg).toContain("Autopost Facebook");
+    expect(ogSvg).toContain("4.9 / 5");
+    expect(ogSvg).toContain("Paris, France");
+
+    const engine = new PseoMatrixEngine();
+    const page = engine.resolvePage(
+      ["autopost-facebook", "paris"],
+      "https://acme.com",
+      {
+        services: [{ slug: "autopost-facebook", name: "Autopost Facebook", category: "Social" }],
+      },
+      { brandName: "Acme", countries: ["france"] },
+    );
+    expect(page?.ogImageUrl).toBeDefined();
+    expect(page?.ogImageUrl).toContain("/api/og?");
+    expect(page?.ogImageUrl).toContain("brand=Acme");
+  });
 });

package/src/index.ts

@@ -17,6 +17,8 @@ export * from "./matrix-engine";
 export * from "./built-in-locations";
 export * from "./i18n-detector";
 export * from "./brand-icons";
+export * from "./ui-icons";
+export * from "./og-image-generator";
 export * from "./urlytics-engine";
 export * from "./keyword-permutator";
 export * from "./llm-prompt";

package/src/llm-prompt.ts

@@ -275,22 +275,30 @@ The SDK equips applications with 9 enterprise-grade SEO engines:
 4. **🎨 Vector Brand & Social Icons (\`renderBrandIconSvg\`):**
    - Zero-dependency official SVG vectors for 30+ brands (Facebook, Instagram, LinkedIn, Shopify, Slack, WhatsApp, Google, GitHub, TikTok, YouTube).
 
-5. **🏛️ Google Schema.org Rich Graphs (\`ExtendedSchemaGraphBuilder\`):**
+5. **✨ Standard UI & Feature Icons (\`renderUiIconSvg\`, \`resolveFeatureIcon\`):**
+   - Zero-dependency Lucide-style vector icons (shield, zap, chart, calendar, users, rocket, sparkles, check, lock, clock, phone, mapPin, euro).
+   - Semantic keyword auto-resolver: Automatically maps feature copy to the most relevant icon.
+
+6. **🖼️ Dynamic OpenGraph (OG) Image Generator (\`OgImageGenerator\`):**
+   - \`renderDynamicOgSvg(opts)\`: Generates high-converting 1200x630 SVG social cards with glassmorphism badges, star ratings, and gradient backdrops.
+   - \`generateOgImageUrl(domain, pageMeta, brandName)\`: Edge-ready query URL for \`app/api/og/route.ts\`.
+
+7. **🏛️ Google Schema.org Rich Graphs (\`ExtendedSchemaGraphBuilder\`):**
    - \`buildAggregateRating\` (Google Gold Stars 4.9★), \`buildAggregateOffer\` (price ranges), \`buildLocalBusiness\` (GPS & opening hours), \`buildSoftwareApplication\`, \`buildHowTo\`, \`buildFAQPage\`, \`buildBreadcrumbs\`.
 
-6. **🔍 URL Decomposition & Analysis (\`UrlyticsEngine\`):**
+8. **🔍 URL Decomposition & Analysis (\`UrlyticsEngine\`):**
    - Deep structural directory decomposition, depth tracking, query parameter analysis, and slug tokenization (inspired by advertools).
 
-7. **⚡ SEM Keyword Combinator (\`KeywordPermutatorEngine\`):**
+9. **⚡ SEM Keyword Combinator (\`KeywordPermutatorEngine\`):**
    - Combinatorial matrix generation: Products × Modifiers × Locations with match types (\`[exact]\`, \`"phrase"\`, \`+broad\`) and intent classification.
 
-8. **⚖️ Legal & Editorial Compliance (\`LegalDisclaimerEngine\`):**
+10. **⚖️ Legal & Editorial Compliance (\`LegalDisclaimerEngine\`):**
    - 7 SeedRank-grade disclaimer templates, 90-day staleness verification, and multi-language anti-disparagement guardian.
 
-9. **📊 Telemetry & Cloud Metering (\`matrixEngine.getTelemetryPayload\` & \`LynxAnalyticsClient\`):**
+11. **📊 Telemetry & Cloud Metering (\`matrixEngine.getTelemetryPayload\` & \`LynxAnalyticsClient\`):**
    - Synchronizes total programmatic pages, indexed hubs, and AI bot crawl hits (GPTBot, ClaudeBot, PerplexityBot) with the LynxSEO Studio dashboard.
 
-10. **🧹 URL Slug Engine & Schema.org Graphs:**
+12. **🧹 URL Slug Engine & Schema.org Graphs:**
    - \`cleanSeoSlug(text, { language })\`: Strips accents, stop words across 10+ languages, and non-alphanumeric noise.
    - Outputs Google-validated Schema.org JSON-LD graphs with 0 syntax errors.
 `.trim();

package/src/matrix-engine.ts

@@ -14,6 +14,7 @@ import { cleanSeoSlug } from "./slug-engine";
 import { LegalDisclaimerEngine } from "./legal-disclaimers";
 import { ExtendedSchemaGraphBuilder } from "./extended-schemas";
 import { resolveBuiltInLocations } from "./built-in-locations";
+import { OgImageGenerator } from "./og-image-generator";
 
 export type MatrixFamily =
   | "local-geo"
@@ -141,6 +142,7 @@ export interface GeneratedPageMeta {
   robots: "index, follow" | "noindex, follow";
   schemaGraph: SchemaOrgGraph;
   disclaimerText?: string;
+  ogImageUrl?: string;
   neighboringLinks?: { name: string; url: string }[];
   service?: PseoService;
   location?: PseoLocation;
@@ -824,6 +826,12 @@ export class PseoMatrixEngine {
       allPages.push(...this.generateCalculatorMatrix(domain, data.calculators, options));
     }
 
+    for (const p of allPages) {
+      if (!p.ogImageUrl) {
+        p.ogImageUrl = OgImageGenerator.generateOgImageUrl(domain, p, options.brandName);
+      }
+    }
+
     return allPages;
   }
 

package/src/og-image-generator.ts

@@ -0,0 +1,109 @@
+/**
+ * 🖼️ Dynamic OpenGraph (OG) & Social Card Image Generator
+ * Generates high-converting 1200x630 SVG social preview cards and URL queries
+ * with zero heavy headless browser dependencies (Puppeteer/Playwright free).
+ */
+
+import { GeneratedPageMeta } from "./matrix-engine";
+
+export interface OgImageOptions {
+  brandName: string;
+  title: string;
+  badgeText?: string;
+  subtitle?: string;
+  locationName?: string;
+  ratingValue?: number;
+  reviewCount?: number;
+  brandColor?: string;
+}
+
+export class OgImageGenerator {
+  /**
+   * Generates a fully formatted URL for dynamic Edge / API OG image generation.
+   * e.g. /api/og?title=...&badge=...&city=...
+   */
+  static generateOgImageUrl(domain: string, pageMeta: GeneratedPageMeta, brandName: string): string {
+    const cleanDomain = domain.replace(/\/+$/, "");
+    const params = new URLSearchParams({
+      title: pageMeta.h1 || pageMeta.title,
+      badge: pageMeta.matrixFamily.toUpperCase(),
+      desc: pageMeta.description ? pageMeta.description.slice(0, 120) : "",
+      brand: brandName,
+    });
+
+    if (pageMeta.location) {
+      params.set("loc", `${pageMeta.location.name}, ${pageMeta.location.country}`);
+    }
+
+    return `${cleanDomain}/api/og?${params.toString()}`;
+  }
+
+  /**
+   * Generates an ultra-crisp 1200x630 pure SVG image string for social previews.
+   */
+  static renderDynamicOgSvg(opts: OgImageOptions): string {
+    const brand = opts.brandName || "LynxSEO";
+    const badge = opts.badgeText || "OFFICIAL";
+    const title = opts.title.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+    const loc = opts.locationName ? `📍 ${opts.locationName}` : "⚡ Instant Cloud Setup";
+    const rating = opts.ratingValue ?? 4.9;
+    const reviews = opts.reviewCount ?? 1280;
+    const accent = opts.brandColor || "#6366F1";
+
+    return `<svg width="1200" height="630" viewBox="0 0 1200 630" xmlns="http://www.w3.org/2000/svg">
+  <defs>
+    <linearGradient id="bgGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#090D16"/>
+      <stop offset="50%" stop-color="#0F172A"/>
+      <stop offset="100%" stop-color="#020617"/>
+    </linearGradient>
+    <linearGradient id="textGrad" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#FFFFFF"/>
+      <stop offset="100%" stop-color="#CBD5E1"/>
+    </linearGradient>
+    <filter id="glow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="80" result="blur" />
+    </filter>
+  </defs>
+
+  <!-- Background -->
+  <rect width="1200" height="630" fill="url(#bgGrad)"/>
+  
+  <!-- Subtle Ambient Glow -->
+  <circle cx="200" cy="150" r="220" fill="${accent}" opacity="0.15" filter="url(#glow)"/>
+  <circle cx="1000" cy="480" r="260" fill="${accent}" opacity="0.12" filter="url(#glow)"/>
+
+  <!-- Top Glassmorphism Badge -->
+  <g transform="translate(80, 80)">
+    <rect width="220" height="42" rx="21" fill="${accent}" fill-opacity="0.15" stroke="${accent}" stroke-opacity="0.4" stroke-width="1.5"/>
+    <text x="110" y="26" fill="#FFFFFF" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="14" font-weight="700" text-anchor="middle" letter-spacing="1.5">${badge}</text>
+  </g>
+
+  <!-- Location / Scope Pill -->
+  <g transform="translate(320, 80)">
+    <rect width="260" height="42" rx="21" fill="#1E293B" fill-opacity="0.6" stroke="#334155" stroke-width="1"/>
+    <text x="130" y="26" fill="#94A3B8" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="14" font-weight="600" text-anchor="middle">${loc}</text>
+  </g>
+
+  <!-- Giant Title -->
+  <text x="80" y="250" fill="url(#textGrad)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="52" font-weight="900" letter-spacing="-1.5">
+    <tspan x="80" dy="0">${title.slice(0, 38)}</tspan>
+    ${title.length > 38 ? `<tspan x="80" dy="68">${title.slice(38, 80)}</tspan>` : ""}
+  </text>
+
+  <!-- Trust Stars & Social Proof -->
+  <g transform="translate(80, 470)">
+    <text x="0" y="32" fill="#FBBF24" font-size="24">★★★★★</text>
+    <text x="140" y="30" fill="#F8FAFC" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="20" font-weight="800">${rating} / 5</text>
+    <text x="210" y="30" fill="#64748B" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="16" font-weight="500">(${reviews.toLocaleString()} verified reviews)</text>
+  </g>
+
+  <!-- Footer Brand -->
+  <g transform="translate(80, 540)">
+    <line x1="0" y1="0" x2="1040" y2="0" stroke="#1E293B" stroke-width="1.5"/>
+    <text x="0" y="42" fill="#FFFFFF" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="20" font-weight="800">${brand}</text>
+    <text x="1040" y="42" fill="#64748B" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="16" font-weight="500" text-anchor="end">Engineered with @lynxflow/seo-engine</text>
+  </g>
+</svg>`;
+  }
+}

package/src/ui-icons.ts

@@ -0,0 +1,134 @@
+/**
+ * 🎨 Universal Zero-Dependency UI & Feature SVG Icons
+ * Provides crisp, modern Lucide-style vector icons for features, trust badges, and UI components.
+ * Includes automatic semantic keyword-to-icon detection for feature descriptions.
+ */
+
+export interface UiIcon {
+  name: string;
+  viewBox: string;
+  svgPath: string;
+}
+
+export const UI_ICONS: Record<string, UiIcon> = {
+  zap: {
+    name: "Zap / Lightning",
+    viewBox: "0 0 24 24",
+    svgPath: '<polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>',
+  },
+  shield: {
+    name: "Shield / Security",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>',
+  },
+  star: {
+    name: "Star / Rating",
+    viewBox: "0 0 24 24",
+    svgPath: '<polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2" fill="currentColor"/>',
+  },
+  chart: {
+    name: "Chart / Analytics",
+    viewBox: "0 0 24 24",
+    svgPath: '<line x1="18" y1="20" x2="18" y2="10" stroke="currentColor" stroke-width="2" stroke-linecap="round"/><line x1="12" y1="20" x2="12" y2="4" stroke="currentColor" stroke-width="2" stroke-linecap="round"/><line x1="6" y1="20" x2="6" y2="14" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>',
+  },
+  calendar: {
+    name: "Calendar / Scheduling",
+    viewBox: "0 0 24 24",
+    svgPath: '<rect x="3" y="4" width="18" height="18" rx="2" ry="2" fill="none" stroke="currentColor" stroke-width="2"/><line x1="16" y1="2" x2="16" y2="6" stroke="currentColor" stroke-width="2"/><line x1="8" y1="2" x2="8" y2="6" stroke="currentColor" stroke-width="2"/><line x1="3" y1="10" x2="21" y2="10" stroke="currentColor" stroke-width="2"/>',
+  },
+  users: {
+    name: "Users / Team",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2" fill="none" stroke="currentColor" stroke-width="2"/><circle cx="9" cy="7" r="4" fill="none" stroke="currentColor" stroke-width="2"/><path d="M23 21v-2a4 4 0 0 0-3-3.87" fill="none" stroke="currentColor" stroke-width="2"/><path d="M16 3.13a4 4 0 0 1 0 7.75" fill="none" stroke="currentColor" stroke-width="2"/>',
+  },
+  rocket: {
+    name: "Rocket / Speed",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M4.5 16.5c-1.5 1.26-2 5-2 5s3.74-.5 5-2c.71-.84.7-2.13-.09-2.91a2.18 2.18 0 0 0-2.91-.09z" fill="none" stroke="currentColor" stroke-width="2"/><path d="m12 15-3-3a22 22 0 0 1 2-3.95A12.88 12.88 0 0 1 22 2c0 2.72-.78 7.5-6 11a22.35 22.35 0 0 1-4 2z" fill="none" stroke="currentColor" stroke-width="2"/>',
+  },
+  sparkles: {
+    name: "Sparkles / AI",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="m12 3-1.9 5.8a2 2 0 0 1-1.3 1.3L3 12l5.8 1.9a2 2 0 0 1 1.3 1.3L12 21l1.9-5.8a2 2 0 0 1 1.3-1.3L21 12l-5.8-1.9a2 2 0 0 1-1.3-1.3L12 3z" fill="none" stroke="currentColor" stroke-width="2" stroke-linejoin="round"/>',
+  },
+  check: {
+    name: "Check / Success",
+    viewBox: "0 0 24 24",
+    svgPath: '<polyline points="20 6 9 17 4 12" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>',
+  },
+  lock: {
+    name: "Lock / Privacy",
+    viewBox: "0 0 24 24",
+    svgPath: '<rect x="3" y="11" width="18" height="11" rx="2" ry="2" fill="none" stroke="currentColor" stroke-width="2"/><path d="M7 11V7a5 5 0 0 1 10 0v4" fill="none" stroke="currentColor" stroke-width="2"/>',
+  },
+  clock: {
+    name: "Clock / 24-7",
+    viewBox: "0 0 24 24",
+    svgPath: '<circle cx="12" cy="12" r="10" fill="none" stroke="currentColor" stroke-width="2"/><polyline points="12 6 12 12 16 14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>',
+  },
+  phone: {
+    name: "Phone / Contact",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M22 16.92v3a2 2 0 0 1-2.18 2 19.79 19.79 0 0 1-8.63-3.07 19.5 19.5 0 0 1-6-6 19.79 19.79 0 0 1-3.07-8.67A2 2 0 0 1 4.11 2h3a2 2 0 0 1 2 1.72 12.84 12.84 0 0 0 .7 2.81 2 2 0 0 1-.45 2.11L8.09 9.91a16 16 0 0 0 6 6l1.27-1.27a2 2 0 0 1 2.11-.45 12.84 12.84 0 0 0 2.81.7A2 2 0 0 1 22 16.92z" fill="none" stroke="currentColor" stroke-width="2"/>',
+  },
+  mapPin: {
+    name: "Map Pin / Local",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0 1 18 0z" fill="none" stroke="currentColor" stroke-width="2"/><circle cx="12" cy="10" r="3" fill="none" stroke="currentColor" stroke-width="2"/>',
+  },
+  euro: {
+    name: "Euro / Pricing",
+    viewBox: "0 0 24 24",
+    svgPath: '<path d="M4 10h12M4 14h9M19 6a7.7 7.7 0 0 0-5.2-2A7.9 7.9 0 0 0 6 12a7.9 7.9 0 0 0 7.8 8 7.7 7.7 0 0 0 5.2-2" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"/>',
+  },
+  arrowRight: {
+    name: "Arrow Right",
+    viewBox: "0 0 24 24",
+    svgPath: '<line x1="5" y1="12" x2="19" y2="12" stroke="currentColor" stroke-width="2" stroke-linecap="round"/><polyline points="12 5 19 12 12 19" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>',
+  },
+};
+
+/**
+ * Returns raw inline SVG markup for a standard UI icon.
+ */
+export function renderUiIconSvg(iconName: string, className: string = "w-5 h-5 inline-block"): string {
+  const icon = UI_ICONS[iconName.toLowerCase()] || UI_ICONS.check;
+  return `<svg class="${className}" viewBox="${icon.viewBox}" aria-hidden="true">${icon.svgPath}</svg>`;
+}
+
+/**
+ * Semantically resolves the most relevant UI icon based on feature text keywords.
+ */
+export function resolveFeatureIcon(featureText: string): string {
+  const lower = featureText.toLowerCase();
+
+  if (lower.includes("secur") || lower.includes("rgpd") || lower.includes("gdpr") || lower.includes("protect") || lower.includes("bank")) {
+    return "shield";
+  }
+  if (lower.includes("sync") || lower.includes("speed") || lower.includes("instant") || lower.includes("real-time") || lower.includes("fast") || lower.includes("rapide")) {
+    return "zap";
+  }
+  if (lower.includes("ai") || lower.includes("ia") || lower.includes("auto") || lower.includes("smart") || lower.includes("intel")) {
+    return "sparkles";
+  }
+  if (lower.includes("chart") || lower.includes("analyt") || lower.includes("report") || lower.includes("stat") || lower.includes("roi") || lower.includes("kpi")) {
+    return "chart";
+  }
+  if (lower.includes("schedul") || lower.includes("calen") || lower.includes("plan") || lower.includes("agenda")) {
+    return "calendar";
+  }
+  if (lower.includes("user") || lower.includes("team") || lower.includes("collab") || lower.includes("client") || lower.includes("contact")) {
+    return "users";
+  }
+  if (lower.includes("price") || lower.includes("tarif") || lower.includes("cost") || lower.includes("devis") || lower.includes("factur")) {
+    return "euro";
+  }
+  if (lower.includes("local") || lower.includes("city") || lower.includes("ville") || lower.includes("map") || lower.includes("gps")) {
+    return "mapPin";
+  }
+  if (lower.includes("24/7") || lower.includes("support") || lower.includes("hour") || lower.includes("time") || lower.includes("temps")) {
+    return "clock";
+  }
+
+  return "zap";
+}