@lynxflow/seo-engine 1.4.0 → 1.5.0

package/README.md

@@ -1,392 +1,137 @@
-# 🦁 @lynxflow/seo-engine — Guide Complet & Documentation Développeur
+# @lynxflow/seo-engine
 
-> **Le Moteur Universel de SEO Programmatique (pSEO), Optimisation Moteurs IA (AEO/GEO), Indexation Instantanée & Analytics Embarqués.**
+High-Performance Programmatic SEO & Structured Data Engine for Modern Web Applications.
 
-`@lynxflow/seo-engine` est un SDK TypeScript haute performance conçu pour générer, servir et indexer des millions de landing pages dynamiques, des avis 4.9/5★ Schema.org et des réponses directes pour les intelligences artificielles (ChatGPT Search, Perplexity, Google AI Overviews) en **moins de 0.05 milliseconde** avec **0% de charge sur votre base de données SQL**.
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+[![License](https://img.shields.io/badge/License-Proprietary-green.svg)](LICENSE)
+[![Version](https://img.shields.io/badge/Version-1.5.0-orange.svg)](package.json)
 
 ---
 
-## 📑 Sommaire
-1. [🌟 Présentation Générale](#1--présentation-générale)
-2. [🔑 L'API Key Better Auth, Sécurité & Quotas](#2--lapi-key-better-auth-sécurité--quotas)
-3. [🏛️ Les 8 Matrices Programmatiques & Multiplicateurs](#3--les-8-matrices-programmatiques--multiplicateurs)
-4. [🚀 Tutoriel d'Intégration Pas-à-Pas (Next.js 15/16 & React 19)](#4--tutoriel-dintégration-pas-à-pas-nextjs-1516--react-19)
-5. [🔌 Intégration sur Autres Frameworks (WordPress, Shopify, Cloudflare, Laravel, Astro)](#5--intégration-sur-autres-frameworks)
-6. [🧰 Les 7 Modules Embarqués du SDK (Analytics, SERP, Backlinks, IA, IndexNow)](#6--les-7-modules-embarqués-du-sdk)
-7. [🌍 Internationalisation & Zéro Contenu Dupliqué (10 Langues & Hreflang)](#7--internationalisation--zéro-contenu-dupliqué)
-8. [📘 Référence Complète des Types TypeScript](#8--référence-complète-des-types-typescript)
+## Overview
 
----
-
-## 1. 🌟 Présentation Générale
+`@lynxflow/seo-engine` is an enterprise developer SDK providing in-memory programmatic SEO matrix generation, Google-compliant Schema.org structured data, and sub-millisecond URL resolution.
 
-### Pourquoi utiliser `@lynxflow/seo-engine` ?
-* ⚡ **Résolution Ultra-Rapide (< 0.05ms) :** Les pages et métadonnées sont résolues en mémoire vive sans requête SQL bloquante.
-* 🤖 **Conçu pour le Search IA (AEO / GEO) :** Génère des blocs de synthèse directe optimisés pour être cités en source n°1 par **ChatGPT Search**, **Perplexity** et **Google AI Overviews**.
-* 🛡️ **Fonctionne à 100% en Local / Sans Dépendance API Bloquante :** La validation cryptographique HMAC de votre clé d'API s'exécute directement sur votre serveur pour garantir un affichage instantané même en cas de panne réseau.
-* 📈 **Suite Complète Embarquée :** Accédez directement à vos analytics de trafic, votre détection de bots IA, vos positions de mots-clés Google et vos backlinks sans quitter votre application.
+* **10 Canonical Root Pillars & 50+ Specialized Sub-Matrices:** Scales across industries, regulatory frameworks, role KPIs, multi-format templates, integration ecosystems, and ROI tools.
+* **Sub-Millisecond In-Memory Execution (< 0.05ms):** Resolves millions of programmatic routes with zero database query overhead.
+* **Multilingual Slug Normalization:** Automated URL cleansing with stop-word removal across 10+ languages (EN, DE, ES, FR, IT, PT, NL, RU, SV, PL).
+* **50+ Schema.org Rich Structured Data Types:** Google-compliant JSON-LD generation for `SoftwareApplication`, `LocalBusiness` subtypes, `HowTo`, `FAQPage`, `BreadcrumbList`, and `Organization`.
+* **Multi-Framework Support:** Seamless operation on Next.js 15/16 (App & Pages Router), Astro 5, Cloudflare Workers/Pages, Bun, Remix, and Node.js.
 
 ---
 
-## 2. 🔑 L'API Key Better Auth, Sécurité & Quotas
+## Installation
 
-### Étape 1 : Obtenir votre Clé d'API
-Rendez-vous dans votre cockpit LynxFlow dans **Paramètres ➔ Clés d'API & Sécurité** et générez votre clé (`ba_key_...` ou `lynx_api_...`).
-
-### Étape 2 : Configuration dans votre fichier `.env` ou `.env.local`
 ```bash
-# 🔑 Clé d'API Better Auth
-LYNXFLOW_API_KEY=ba_key_growth_tenant_acme_a8f93e
-
-# 🌐 Domaine de votre site web
-NEXT_PUBLIC_SITE_URL=https://mon-entreprise.com
+npm install @lynxflow/seo-engine
+# or
+pnpm add @lynxflow/seo-engine
+# or
+bun add @lynxflow/seo-engine
 ```
 
-### Grille des Forfaits & Règles de Sécurité :
-
-| Forfait (Tier) | Préfixe de Clé | Quota de Pages Uniques | Nombre de Domaines Autorisés | Budget Crédits IA / mois |
-|---|---|---|---|---|
-| **Starter** | `ba_test_*` ou `ba_key_starter_*` | **50 000 pages uniques** | **1 seul domaine** (Verrouillage Monosite) | 1 000 crédits ($10) |
-| **Growth** | `ba_key_*` ou `ba_key_growth_*` | **500 000 pages uniques** | **Jusqu'à 3 domaines** | 10 000 crédits ($100) |
-| **Enterprise** | `ba_admin_*` ou `lynx_enterprise_*` | **Illimité (5 000 000+)** | **Domaines illimités** | 100 000 crédits ($1 000) |
-
-### 🧠 Comment fonctionne la Comptabilité des Pages (URLs Uniques vs Hits) ?
-* **Une Page = Une URL Unique :** Si vous avez 500 villes pour 2 services, votre catalogue contient **1 000 pages uniques**.
-* **Trafic / Visites Illimité & Gratuit :** Si 100 000 visiteurs visitent `/solutions/crm/paris`, cela compte pour **1 seule page unique** dans votre quota, pas 100 000 !
-
 ---
 
-## 3. 🏛️ Les 8 Matrices Programmatiques & Multiplicateurs
+## Core Matrix Architecture
 
-Le moteur intègre nativement les 8 familles stratégiques de pages :
+The SDK structures programmatic content across **10 canonical root pillars** expanding into **50+ specialized sub-matrices**:
 
 ```
-┌────┬───────────────────────────────────┬──────────────────────────────────────────┬────────────────────────────────────────────────────────┐
-│ #  │ FAMILLE DE MATRICE                │ FORMULE D'URL PROGRAMMATIQUE             │ EXEMPLE RÉSOLU EN < 0.05MS                             │
-├────┼───────────────────────────────────┼──────────────────────────────────────────┼────────────────────────────────────────────────────────┤
-│ 1  │ 📍 1. Local & GEO                 │ `/solutions/{module}/{ville}`            │ `/solutions/crm-pipeline/lyon`                         │
-│ 2  │ 🥊 2. VS Comparatifs              │ `/comparatif/{module}-vs-{concurrent}`  │ `/comparatif/crm-pipeline-vs-hubspot`                  │
-│ 3  │ 🔄 3. Alternatives Logiciels      │ `/alternatives/alternative-a-{nom}`      │ `/alternatives/alternative-a-aircall`                  │
-│ 4  │ 🏢 4. Secteurs & Métiers B2B      │ `/secteurs/{module}-pour-{secteur}`      │ `/secteurs/crm-pipeline-pour-avocats`                  │
-│ 5  │ 🔌 5. Intégrations & Tech         │ `/integrations/{module}-avec-{logiciel}` │ `/integrations/crm-pipeline-avec-shopify`              │
-│ 6  │ 👤 6. Personas & Décideurs        │ `/metiers/{module}-pour-{role}`          │ `/metiers/crm-pipeline-pour-directeur-commercial`      │
-│ 7  │ 🎯 7. Cas d'Usage Opérationnels   │ `/cas-usage/{module}-{sujet}`            │ `/cas-usage/crm-pipeline-relance-devis`                │
-│ 8  │ 🧮 8. Calculateurs & Outils ROI   │ `/outils/simulateur-roi-{module}`        │ `/outils/simulateur-roi-crm-pipeline`                  │
-└────┴───────────────────────────────────┴──────────────────────────────────────────┴────────────────────────────────────────────────────────┘
-```
-
-### 🌟 Le Lien Unique Ultra-Combiné (8 Slugs en 1 Seule URL) :
-Si vous souhaitez cibler une requête ultra-précise combinant tous les critères dans une seule URL :
-```
-https://mon-entreprise.com/solutions/crm-pipeline/avocats/hubspot/gmail/directeur-commercial/paris/simulateur-roi
+┌──────────────────────────────────────┬────────────────────────┬────────────────────────────────────────────────────────┐
+│ CANONICAL ROOT PILLAR                │ SPECIALIZED DIMENSIONS │ HIGH-INTENT EXAMPLES                                   │
+├──────────────────────────────────────┼────────────────────────┼────────────────────────────────────────────────────────┤
+│ 👥 /for/{target}                     │ 12 Sub-Matrices        │ Sector × Regulatory Compliance, Role × Daily KPIs      │
+│ 🔌 /integrations/{app}               │ 10 Sub-Matrices        │ App Connector × Real-Time Webhook, Bi-Directional Sync │
+│ 📑 /templates/{slug}                 │ 8 Sub-Matrices         │ Subject × Format (Excel, Notion, Google Sheets, PDF)   │
+│ 🎯 /use-cases/{useCase}              │ 8 Sub-Matrices         │ Operational Pain Point × Step-by-Step Playbook         │
+│ 🧮 /tools/{calculator}               │ 6 Sub-Matrices         │ Hours Saved Estimator, Revenue Uplift Simulator        │
+│ 📚 /glossary/{term}                  │ 6 Sub-Matrices         │ Financial Metrics (MRR/LTV), Technical Protocols (API) │
+│ 🥊 /vs/{competitor}                  │ Optional / Modular     │ Architectural Comparison & Differences                 │
+│ 🔄 /alternatives/{competitor}        │ Optional / Modular     │ Clean Canonical Migration Guides                       │
+│ 💰 /pricing/{competitor}             │ Optional / Modular     │ Transparent Plan Breakdown & Verified Disclaimers      │
+│ 📍 /solutions/{service}/{city}       │ Local Geo Matrix       │ Tiered Indexing (Crawl Budget) & Geodesic Mesh Links   │
+└──────────────────────────────────────┴────────────────────────┴────────────────────────────────────────────────────────┘
 ```
 
 ---
 
-## 4. 🚀 Tutoriel d'Intégration Pas-à-Pas (Next.js 15/16 & React 19)
+## Quickstart
 
-### Étape 1 : Installation
-```bash
-npm install @lynxflow/seo-engine
-# ou
-bun add @lynxflow/seo-engine
-```
+### 1. Initialize Engine
 
-### Étape 2 : Initialisation dans `lib/seo.ts`
 ```typescript
-// lib/seo.ts
-import { createLynxSeoEngine } from "@lynxflow/seo-engine";
-
-export const seoEngine = createLynxSeoEngine({
-  apiKey: process.env.LYNXFLOW_API_KEY!,
-  domain: process.env.NEXT_PUBLIC_SITE_URL || "https://mon-entreprise.com",
-  brandName: "Acme Corp",
-  defaultLocale: "fr",
-  supportedLocales: ["fr", "en", "es", "pt", "de", "ar", "ja", "zh", "ko", "hi", "id"],
-  services: [
-    {
-      slug: "crm-pipeline",
-      name: "CRM Pipeline Commercial",
-      pricePerMonth: 49,
-      category: "Ventes & CRM",
-      features: ["Kanban interactif", "Relances automatiques IA 24/7", "WhatsApp Sync"],
-      faqs: [
-        { question: "Puis-je importer mes contacts existants ?", answer: "Oui, l'import CSV et Excel se fait en 1 clic." },
-        { question: "Le support technique est-il inclus ?", answer: "Oui, support prioritaire 24/7 par chat et email." }
-      ]
-    },
-    {
-      slug: "standard-vocal-ia",
-      name: "Standard Vocal Téléphonique IA",
-      pricePerMonth: 79,
-      category: "Téléphonie IA",
-      features: ["Décrochage 0 seconde 24/7", "Qualification automatique des prospects"]
-    }
-  ]
-});
-```
-
-### Étape 3 : Générateur d'Images Réseaux Sociaux Dynamiques (`app/api/og/route.tsx`)
-```tsx
-// app/api/og/route.tsx
-import { ImageResponse } from "next/og";
-import type { NextRequest } from "next/server";
-
-export const runtime = "edge";
-
-export async function GET(request: NextRequest) {
-  const { searchParams } = new URL(request.url);
-  const title = searchParams.get("title") || "Solution SaaS & IA";
-  const brand = searchParams.get("brand") || "LynxFlow";
-  const service = searchParams.get("service") || "Plateforme B2B";
-
-  return new ImageResponse(
-    (
-      <div style={{ height: "100%", width: "100%", display: "flex", flexDirection: "column", justifyContent: "space-between", backgroundColor: "#030712", padding: "60px 80px", fontFamily: "sans-serif" }}>
-        <div style={{ display: "flex", alignItems: "center", gap: "16px" }}>
-          <div style={{ background: "#2563eb", color: "#fff", padding: "8px 20px", borderRadius: "9999px", fontSize: 24, fontWeight: 700 }}>{brand}</div>
-          <div style={{ color: "#94a3b8", fontSize: 24 }}>• {service}</div>
-        </div>
-        <div style={{ color: "#ffffff", fontSize: 54, fontWeight: 900, lineHeight: 1.15 }}>{title}</div>
-        <div style={{ display: "flex", gap: "16px", color: "#e2e8f0", fontSize: 22 }}>
-          <span>⭐ 4.9/5 (1 280 avis vérifiés)</span>
-          <span>•</span>
-          <span>Mise en service immédiate</span>
-        </div>
-      </div>
-    ),
-    { width: 1200, height: 630 }
-  );
-}
-```
-
-### Étape 4 : La Route Catch-All Universelle (`app/[...slug]/page.tsx`)
-```tsx
-// app/[...slug]/page.tsx
-import { seoEngine } from "@/lib/seo";
-import { notFound } from "next/navigation";
-import type { Metadata } from "next";
-
-interface PageProps {
-  params: Promise<{ slug: string[] }>;
-}
-
-// 1. Métadonnées SEO, Balises Hreflang et Image Sociale
-export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
-  const { slug } = await params;
-  const path = "/" + (slug || []).join("/");
-  const page = seoEngine.resolve(path);
-
-  if (!page) return {};
-
-  return {
-    title: page.title,
-    description: page.description,
-    alternates: {
-      canonical: page.url,
-      languages: page.hreflangs?.reduce((acc, h) => ({ ...acc, [h.lang]: h.url }), {})
-    },
-    openGraph: {
-      title: page.title,
-      description: page.description,
-      images: [{ url: page.meta?.openGraphImageUrl || `${page.url}/api/og` }]
-    }
-  };
-}
-
-// 2. Rendu Server Component Ultra-Rapide (< 0.05ms)
-export default async function UniversalCatchAllPage({ params }: PageProps) {
-  const { slug } = await params;
-  const path = "/" + (slug || []).join("/");
-  const page = seoEngine.resolve(path);
-
-  if (!page) notFound();
-
-  // Enregistrer la visite pour les analytics et la détection de bots IA
-  await seoEngine.analytics.trackPageView({ path });
-
-  return (
-    <main className="max-w-4xl mx-auto py-12 px-6">
-      {/* 🌟 Graphe Schema.org 4.9★ (Product + FAQPage + Speakable) */}
-      <script
-        type="application/ld+json"
-        dangerouslySetInnerHTML={{ __html: JSON.stringify(page.jsonLd) }}
-      />
-
-      <h1 className="text-4xl font-black text-gray-900 tracking-tight">{page.h1}</h1>
-      <p className="mt-4 text-lg text-gray-600 leading-relaxed">{page.description}</p>
-
-      {/* 🤖 Bloc AEO de Réponse Directe pour ChatGPT / Perplexity */}
-      <div className="my-8 rounded-2xl bg-blue-50 border-l-4 border-blue-600 p-6">
-        <h3 className="text-xs font-bold uppercase tracking-wider text-blue-900">En Résumé (Réponse Directe IA) :</h3>
-        <p className="mt-2 text-base text-blue-950 font-medium leading-relaxed">{page.directAnswer}</p>
-      </div>
-
-      {/* ❓ Section FAQ Interactive */}
-      <section className="mt-12">
-        <h2 className="text-2xl font-bold text-gray-900">Questions Fréquentes</h2>
-        <div className="mt-6 space-y-4">
-          {page.faqs.map((faq, idx) => (
-            <details key={idx} className="rounded-xl border border-gray-200 p-5 bg-white shadow-xs">
-              <summary className="cursor-pointer font-semibold text-gray-900">{faq.question}</summary>
-              <p className="mt-3 text-gray-700 leading-relaxed">{faq.answer}</p>
-            </details>
-          ))}
-        </div>
-      </section>
-    </main>
-  );
-}
-```
-
----
-
-## 5. 🔌 Intégration sur Autres Frameworks
-
-### WordPress (Plugin 100% Autonome)
-1. Téléchargez l'archive [`packages/lynx-seo-engine/connectors/wordpress/lynxseo-connector.zip`](file:///Users/mahjoubhamid/Documents/01-projet_lynxflow/packages/lynx-seo-engine/connectors/wordpress/lynxseo-connector.zip).
-2. Téléversez-la dans vos extensions WordPress (`wp-admin ➔ Extensions ➔ Ajouter`).
-3. Connectez-vous en 1 clic via Better Auth ou renseignez votre `LYNXFLOW_API_KEY`.
-4. Vos 8 matrices et votre sitemap dynamique `/sitemap-solutions.xml` sont immédiatement actifs avec **0% de charge sur votre base MySQL**.
+import { PseoMatrixEngine } from "@lynxflow/seo-engine";
 
-### Cloudflare Edge Worker (Shopify, Webflow, Wix, Squarespace)
-Déployez `connectors/cloudflare-worker/worker.js` sur votre compte Cloudflare pour intercepter et servir vos pages programmatiques au niveau du réseau Edge en moins de 20ms dans plus de 300 villes à travers le monde.
-
-### Laravel / PHP
-```php
-// routes/web.php
-Route::get('/{any}', [LynxSeoController::class, 'resolve'])->where('any', '.*');
+export const matrixEngine = new PseoMatrixEngine({
+  companyName: "Acme Cloud",
+  language: "en", // "en" default, supports "fr", "de", "es", "it", "pt", etc.
+  correctionsEmail: "compliance@acme.com",
+});
 ```
 
----
-
-## 6. 🧰 Les 7 Modules Embarqués du SDK
+### 2. Resolve Programmatic Pages
 
-Vous pouvez utiliser n'importe quel module du SDK de manière autonome dans votre propre code :
-
-### 1. 📊 `engine.analytics` : Trafic Web & Détection des Robots IA
 ```typescript
-// Enregistrer un événement de visite
-await seoEngine.analytics.trackPageView({
-  path: "/solutions/crm-pipeline/paris",
-  userAgent: request.headers.get("user-agent") || ""
-});
+const pages = matrixEngine.generateAllMatrices("https://example.com", {
+  services: [
+    { slug: "crm-pipeline", name: "Sales CRM", category: "Sales", keyFeatures: ["Kanban"], description: "CRM" }
+  ],
+  targets: [
+    { slug: "law-firms", name: "Law Firms", type: "industry", painPoints: ["Billing"], benefits: ["Security"] }
+  ],
+  integrations: [
+    { slug: "slack", name: "Slack", category: "Communication", syncFeatures: ["Alerts"] }
+  ],
+  templates: [
+    { slug: "pipeline-excel", title: "Sales Pipeline", topic: "Sales", format: "excel", benefits: ["Free"] }
+  ],
+  glossaryTerms: [
+    { slug: "mrr", term: "MRR", shortDefinition: "Monthly Recurring Revenue" }
+  ]
+}, { brandName: "Acme" });
 
-// Récupérer le rapport de trafic et les visites des robots IA
-const stats = await seoEngine.analytics.getSummary("30d");
-console.log("Visiteurs Uniques :", stats.uniqueVisitors);
-console.log("Robots IA détectés :", stats.aiBotVisits); // ChatGPT, Perplexity, Googlebot
+console.log(pages[0].urlPath);      // "/for/law-firms"
+console.log(pages[0].schemaGraph);  // Injected Schema.org JSON-LD graph
 ```
 
-### 2. 🔎 `engine.serp` : Suivi des Positions Google & Mots-Clés
-```typescript
-const ranking = await seoEngine.serp.trackKeyword("crm pipeline commercial", "FR");
-console.log("Position Google :", ranking.position);
-console.log("Volume Mensuel :", ranking.searchVolume);
-console.log("Présence IA Overview :", ranking.hasAiOverview);
-```
+### 3. URL Slug Cleansing (6 Golden Rules)
 
-### 3. 🔗 `engine.backlinks` : Suivi des Liens Entrants & Domain Authority
 ```typescript
-const backlinks = await seoEngine.backlinks.getProfile("mon-entreprise.com");
-console.log("Domain Authority (DA) :", backlinks.domainAuthority);
-console.log("Total Backlinks :", backlinks.totalBacklinks);
-```
+import { cleanSeoSlug, validateSeoSlug } from "@lynxflow/seo-engine";
 
-### 4. 🤖 `engine.ai` : Copilote de Rédaction de Contenus IA
-```typescript
-const article = await seoEngine.ai.generateArticle({
-  topic: "Automatisation du CRM pour Avocats",
-  targetKeywords: ["crm avocats", "logiciel cabinet d'avocat"],
-  wordCount: 1500
-});
+const slug = cleanSeoSlug("The best software for managing client invoices in 2026", { language: "en" });
+console.log(slug); // "best-software-managing-client-invoices"
 
-console.log("Titre :", article.title);
-console.log("Contenu Markdown :", article.markdownContent);
+const { isValid, errors } = validateSeoSlug(slug);
+console.log(isValid); // true
 ```
 
-### 5. ⚡ `engine.indexNow` : Indexation Immédiate sur Bing, Yandex, Seznam
-```typescript
-await seoEngine.indexNow.submitUrls([
-  "https://mon-entreprise.com/solutions/crm-pipeline/paris",
-  "https://mon-entreprise.com/solutions/crm-pipeline/lyon"
-]);
-```
+---
 
-### 6. 🔍 `engine.auditor` : Audit Qualité SEO & Validation Meta
-```typescript
-const audit = seoEngine.auditor.inspectMeta({
-  title: "CRM Ventes pour PME | Acme Corp",
-  description: "Accélérez vos ventes grâce à notre CRM automatisé. Essai gratuit.",
-  h1: "Le CRM pensé pour vos commerciaux",
-  directAnswer: "Acme Corp propose le meilleur CRM automatisé pour PME dès 49€/mois."
-});
+## AI Agents & LLM Prompt Integration
 
-console.log("Score SEO :", audit.score); // 100/100
-```
+Extract the full internal operational prompt to instruct autonomous AI coding agents (Claude, Cursor, Copilot, ChatGPT, Antigravity) without revealing proprietary logic:
 
-### 7. 🌟 `engine.schema` : Constructeur de Graphe Schema.org 4.9★
 ```typescript
-const schemaJson = seoEngine.schema.buildGraph({
-  url: "https://mon-entreprise.com/ma-page",
-  name: "CRM Pipeline Commercial",
-  brandName: "Acme Corp",
-  price: 49
-});
+import { getSeoAgentPrompt } from "@lynxflow/seo-engine";
+
+const prompt = getSeoAgentPrompt({ brandName: "Acme", domain: "https://example.com" });
+// Pass this prompt to your AI coding agent or copilot
 ```
 
 ---
 
-## 7. 🌍 Internationalisation & Zéro Contenu Dupliqué
+## TypeScript API Reference
 
-Le moteur génère automatiquement les traductions et l'interconnexion `hreflang` officielle pour **10 langues mondiales** :
-
-* 🇫🇷 **Français (`fr`) :** `/fr/solutions/crm-pipeline/paris`
-* 🇬🇧 **Anglais (`en`) :** `/en/solutions/crm-pipeline/london`
-* 🇧🇷 **Portugais Brésil (`pt`) :** `/pt/solutions/crm-pipeline/sao-paulo`
-* 🇪🇸 **Espagnol LatAm (`es`) :** `/es/solutions/crm-pipeline/mexico`
-* 🇩🇪 **Allemand (`de`) :** `/de/solutions/crm-pipeline/berlin`
-* 🇸🇦 **Arabe (`ar` RTL) :** `/ar/solutions/crm-pipeline/riyadh`
-* 🇯🇵 **Japonais (`ja`) :** `/ja/solutions/crm-pipeline/tokyo`
-* 🇨🇳 **Chinois (`zh`) :** `/zh/solutions/crm-pipeline/shanghai`
-* 🇰🇷 **Coréen (`ko`) :** `/ko/solutions/crm-pipeline/seoul`
-* 🇮🇳 **Hindi (`hi`) :** `/hi/solutions/crm-pipeline/mumbai`
+* **`PseoMatrixEngine`**: Core programmatic matrix compiler across all 10 root pillars and 50+ sub-matrices.
+* **`cleanSeoSlug(text, options)`**: Multilingual slug normalizer with stop-word removal for 10+ languages.
+* **`validateSeoSlug(slug)`**: Strict slug validator.
+* **`ExtendedSchemaGraphBuilder`**: 50+ Google Rich Result Schema.org JSON-LD generator.
+* **`LegalDisclaimerEngine`**: Verified compliance notice manager with staleness guards (>90 days).
+* **`getSeoAgentPrompt(context)`**: Built-in LLM operational prompt.
 
 ---
 
-## 8. 📘 Référence Complète des Types TypeScript
-
-```typescript
-import {
-  createLynxSeoEngine,
-  LynxSeoEngine,
-  ApiKeyGuardian,
-  LagoTokenMeter,
-  HyperswitchGateway,
-  IndexNowClient,
-  SiteAuditor,
-  SchemaGraphBuilder,
-  LynxAnalyticsClient,
-  SerpClient,
-  BacklinksClient,
-  AiCopilotClient,
-  type LynxSeoConfig,
-  type LynxResolvedPage,
-  type LynxServiceDefinition,
-  type PseoIndustry,
-  type PseoCompetitor,
-  type PseoIntegration,
-  type PseoUseCase,
-  type PseoPersona,
-  type SeoAuditReport,
-  type AnalyticsSummaryReport,
-  type KeywordRankingItem,
-  type BacklinkProfileSummary,
-  type GeneratedArticleResult
-} from "@lynxflow/seo-engine";
-```
-
----
+## License
 
-## 📄 Licence & Propriété
-Propriétaire © LynxFlow Technologies. Tous droits réservés.
+Proprietary — LynxFlow Technologies. All rights reserved.