@lynxflow/seo-engine 1.8.30 → 2.0.1

package/src/ui-icons.ts

@@ -1,134 +0,0 @@
-/**
- * 🎨 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";
-}

package/src/urlytics-engine.ts

@@ -1,97 +0,0 @@
-/**
- * 🔍 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 class UrlyticsEngine {
-  /**
-   * Parses a single URL into its granular structural components.
-   */
-  static parseUrl(rawUrl: string): ParsedUrlStructure {
-    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: Record<string, string> = {};
-
-      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,
-      };
-    }
-  }
-
-  /**
-   * Batch processes an array of URLs for comparative directory analysis.
-   */
-  static analyzeUrls(urls: string[]): ParsedUrlStructure[] {
-    return urls.map((u) => this.parseUrl(u));
-  }
-}

package/src/video-youtube-analyzer.ts

@@ -1,81 +0,0 @@
-export interface YouTubeVideoMetadata {
-  videoId: string;
-  title: string;
-  description: string;
-  uploadDate?: string;
-  duration?: string; // ISO 8601 e.g. "PT5M30S"
-  thumbnailUrl?: string;
-  embedUrl?: string;
-  hasChapters?: boolean;
-  chapters?: Array<{ time: number; title: string }>;
-}
-
-export class VideoYouTubeAnalyzer {
-  /**
-   * Extracts YouTube Video ID from any standard URL or iframe string
-   */
-  static extractVideoId(urlOrIframe: string): string | null {
-    const regExp = /(?:youtube(?:-nocookie)?\.com\/(?:[^\/\n\s]+\/\S+\/|(?:v|e(?:mbed)?)\/|\S*?[?&]v=)|youtu\.be\/)([a-zA-Z0-9_-]{11})/;
-    const match = urlOrIframe.match(regExp);
-    return match ? match[1] : null;
-  }
-
-  /**
-   * Generates Schema.org VideoObject JSON-LD for rich snippets on Google Video Carousel
-   */
-  static generateVideoObjectSchema(meta: YouTubeVideoMetadata) {
-    const videoId = meta.videoId;
-    const thumbnail = meta.thumbnailUrl || `https://img.youtube.com/vi/${videoId}/maxresdefault.jpg`;
-    const embedUrl = meta.embedUrl || `https://www.youtube.com/embed/${videoId}`;
-
-    const schema: Record<string, any> = {
-      "@context": "https://schema.org",
-      "@type": "VideoObject",
-      "name": meta.title,
-      "description": meta.description,
-      "thumbnailUrl": [thumbnail],
-      "uploadDate": meta.uploadDate || new Date().toISOString().split("T")[0],
-      "embedUrl": embedUrl,
-      "contentUrl": `https://www.youtube.com/watch?v=${videoId}`
-    };
-
-    if (meta.duration) {
-      schema.duration = meta.duration;
-    }
-
-    if (meta.chapters && meta.chapters.length > 0) {
-      schema.hasPart = meta.chapters.map(c => ({
-        "@type": "Clip",
-        "name": c.title,
-        "startOffset": c.time,
-        "url": `https://www.youtube.com/watch?v=${videoId}&t=${c.time}s`
-      }));
-    }
-
-    return schema;
-  }
-
-  /**
-   * Generates responsive, lazy-loaded, SEO-optimized HTML embed with Schema markup
-   */
-  static generateSeoVideoEmbedHtml(meta: YouTubeVideoMetadata): string {
-    const videoId = meta.videoId;
-    const jsonLd = JSON.stringify(this.generateVideoObjectSchema(meta));
-
-    return `
-      <div class="lynxseo-video-wrapper" style="position:relative;padding-bottom:56.25%;height:0;overflow:hidden;border-radius:12px;box-shadow:0 4px 12px rgba(0,0,0,0.08);margin:24px 0;">
-        <iframe 
-          src="https://www.youtube.com/embed/${videoId}" 
-          title="${meta.title.replace(/"/g, '&quot;')}"
-          style="position:absolute;top:0;left:0;width:100%;height:100%;border:0;" 
-          allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" 
-          allowfullscreen 
-          loading="lazy">
-        </iframe>
-      </div>
-      <script type="application/ld+json">
-        ${jsonLd}
-      </script>
-    `.trim();
-  }
-}

package/src/yoast-parity.ts

@@ -1,161 +0,0 @@
-/**
- * 🟢 Yoast SEO Parity & Real-Time Readability Engine
- *
- * Implements the iconic Yoast SEO features (13M+ installs):
- * 1. Readability Analysis (Analyse de Lisibilité aux pastilles Vertes/Oranges/Rouges) :
- *    - Flesch Reading Ease Formula (Score de lisibilité)
- *    - Transition Words Detection (Mots de transition > 30%)
- *    - Passive Voice Detection (Voix passive < 10%)
- *    - Sentence Length Distribution (Phrases > 20 mots < 25%)
- *    - Paragraph Length (< 150 mots par paragraphe)
- *    - Subheading Distribution (< 300 mots sous un sous-titre)
- * 2. Google SERP Pixel Width Calculator (Titre max 600px, Description max 960px)
- * 3. Cornerstone Content (Contenu Pilier & Priorisation du Maillage)
- */
-
-export interface YoastReadabilityBullet {
-  id: string;
-  label: string;
-  status: "green" | "orange" | "red"; // Pastille verte, orange ou rouge
-  scoreValue: number;
-  message: string;
-}
-
-export interface YoastAnalysisResult {
-  overallReadability: "green" | "orange" | "red";
-  fleschReadingScore: number; // 0 to 100 (60-70 = standard/facile)
-  fleschGrade: string;
-  transitionWordsPercent: number;
-  passiveVoicePercent: number;
-  longSentencesPercent: number;
-  bullets: YoastReadabilityBullet[];
-  serpPreview: {
-    titlePixelWidth: number;
-    titlePixelLimit: 600;
-    titleIsTruncated: boolean;
-    descPixelWidth: number;
-    descPixelLimit: 960;
-    descIsTruncated: boolean;
-  };
-}
-
-export class YoastParityEngine {
-  private static frenchTransitionWords = [
-    "en effet", "de plus", "par conséquent", "cependant", "ainsi", "notamment", "en outre",
-    "d'ailleurs", "toutefois", "en revanche", "néanmoins", "c'est pourquoi", "en conclusion",
-    "par exemple", "premièrement", "deuxièmement", "en fait", "grâce à", "donc", "car", "puisque"
-  ];
-
-  /**
-   * 1. Full Yoast-Style Readability Analysis.
-   */
-  static analyzeReadability(text: string, title = "", description = ""): YoastAnalysisResult {
-    const plainText = text.replace(/<[^>]+>/g, " ").replace(/[#*`_~]/g, " ").trim();
-    const sentences = plainText.split(/[.!?]+/).map((s) => s.trim()).filter((s) => s.length > 0);
-    const words = plainText.split(/\s+/).filter((w) => w.length > 0);
-    const paragraphs = text.split(/\n\s*\n/).map((p) => p.trim()).filter((p) => p.length > 0);
-
-    const totalWords = Math.max(1, words.length);
-    const totalSentences = Math.max(1, sentences.length);
-
-    // 1. Flesch Reading Ease (Formule adaptée au français : 207 - (1.015 * ASL) - (84.6 * ASW))
-    const avgSentenceLength = totalWords / totalSentences;
-    // Estimation des syllabes (~1.4 syllabes par mot en français moyen)
-    const estimatedSyllables = words.reduce((acc, word) => acc + Math.max(1, word.length / 3), 0);
-    const avgSyllablesPerWord = estimatedSyllables / totalWords;
-    const fleschScore = Math.max(0, Math.min(100, Math.round(207 - (1.015 * avgSentenceLength) - (84.6 * avgSyllablesPerWord))));
-
-    let fleschGrade = "Très facile à lire";
-    if (fleschScore < 30) fleschGrade = "Très difficile (académique)";
-    else if (fleschScore < 50) fleschGrade = "Difficile";
-    else if (fleschScore < 60) fleschGrade = "Moyen";
-    else if (fleschScore < 70) fleschGrade = "Facile (Idéal pour le web)";
-
-    // 2. Transition Words Detection (> 30% des phrases)
-    let transitionCount = 0;
-    for (const sentence of sentences) {
-      const lower = sentence.toLowerCase();
-      if (this.frenchTransitionWords.some((tw) => lower.includes(tw))) {
-        transitionCount++;
-      }
-    }
-    const transitionPercent = Math.round((transitionCount / totalSentences) * 100);
-
-    // 3. Long Sentences (> 20 mots)
-    const longSentences = sentences.filter((s) => s.split(/\s+/).length > 20).length;
-    const longSentencesPercent = Math.round((longSentences / totalSentences) * 100);
-
-    // 4. Passive Voice Approximation (formules passives en français : être + participe)
-    const passiveRegex = /\b(est|sont|été|fut|furent|sera|seront|était|étaient)\s+([a-zéèêëàâîïôûüç]+(é|és|ée|ées|i|is|ie|ies|u|us|ue|ues))\b/gi;
-    const passiveMatches = plainText.match(passiveRegex) || [];
-    const passivePercent = Math.round((passiveMatches.length / totalSentences) * 100);
-
-    // Bullets checklist (Pastilles Yoast)
-    const bullets: YoastReadabilityBullet[] = [];
-
-    // Bullet Flesch
-    bullets.push({
-      id: "flesch_reading_ease",
-      label: "Facilité de lecture Flesch",
-      status: fleschScore >= 55 ? "green" : fleschScore >= 45 ? "orange" : "red",
-      scoreValue: fleschScore,
-      message: `Score Flesch : ${fleschScore}/100 (${fleschGrade}).`,
-    });
-
-    // Bullet Transitions
-    bullets.push({
-      id: "transition_words",
-      label: "Mots de transition",
-      status: transitionPercent >= 30 ? "green" : transitionPercent >= 20 ? "orange" : "red",
-      scoreValue: transitionPercent,
-      message: `${transitionPercent}% des phrases contiennent des mots de transition (Recommandé : > 30%).`,
-    });
-
-    // Bullet Sentence Length
-    bullets.push({
-      id: "sentence_length",
-      label: "Longueur des phrases",
-      status: longSentencesPercent <= 25 ? "green" : longSentencesPercent <= 35 ? "orange" : "red",
-      scoreValue: longSentencesPercent,
-      message: `${longSentencesPercent}% des phrases dépassent 20 mots (Recommandé : < 25%).`,
-    });
-
-    // Bullet Passive Voice
-    bullets.push({
-      id: "passive_voice",
-      label: "Voix passive",
-      status: passivePercent <= 10 ? "green" : passivePercent <= 18 ? "orange" : "red",
-      scoreValue: passivePercent,
-      message: `${passivePercent}% de voix passive (Recommandé : < 10%).`,
-    });
-
-    // Overall status
-    const redCount = bullets.filter((b) => b.status === "red").length;
-    const orangeCount = bullets.filter((b) => b.status === "orange").length;
-    let overallReadability: "green" | "orange" | "red" = "green";
-    if (redCount >= 2) overallReadability = "red";
-    else if (redCount === 1 || orangeCount >= 2) overallReadability = "orange";
-
-    // 5. SERP Pixel Width (Approximation : ~9.5px par caractère pour le titre Arial 18px)
-    const titlePixelWidth = Math.round(title.length * 9.2);
-    const descPixelWidth = Math.round(description.length * 5.8);
-
-    return {
-      overallReadability,
-      fleschReadingScore: fleschScore,
-      fleschGrade,
-      transitionWordsPercent: transitionPercent,
-      passiveVoicePercent: passivePercent,
-      longSentencesPercent: longSentencesPercent,
-      bullets,
-      serpPreview: {
-        titlePixelWidth,
-        titlePixelLimit: 600,
-        titleIsTruncated: titlePixelWidth > 600,
-        descPixelWidth,
-        descPixelLimit: 960,
-        descIsTruncated: descPixelWidth > 960,
-      },
-    };
-  }
-}

package/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "declaration": true,
-    "emitDeclarationOnly": true,
-    "rootDir": "./src",
-    "outDir": "./dist",
-    "strict": true,
-    "skipLibCheck": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["src/**/*.test.ts"]
-}