@lynxflow/seo-engine 1.8.30 → 2.0.1

package/README.md

@@ -1,22 +1,25 @@
 # @lynxflow/seo-engine
 
-High-Performance Programmatic SEO & Structured Data Engine for Modern Web Applications.
+High-Performance Universal Programmatic SEO & Structured Data Engine for Modern Web Applications.
 
 [![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)
+[![Version](https://img.shields.io/badge/Version-2.0.0-orange.svg)](https://www.npmjs.com/package/@lynxflow/seo-engine)
 
 ---
 
 ## Overview
 
-`@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.
+`@lynxflow/seo-engine` is an enterprise developer SDK providing in-memory programmatic SEO matrix generation, Google-compliant Schema.org structured data, infinite geographic location synthesis, strict market boundaries, and real-time GeoIP Edge detection worldwide.
 
 * **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.
+* **Strict Geographic & Linguistic Scoping:** Easily lock your website to a single country (e.g. 100% US or 100% France) or expand globally across multiple languages and territories with `strictCountryBoundary`.
+* **In-Memory Dynamic Execution:** Resolves millions of programmatic routes in RAM with zero database query overhead and zero MySQL/Postgres saturation.
+* **Infinite Geographic Resolution (`createDynamicLocation`):** Dynamically synthesizes any municipality, county, state, or postal code worldwide (e.g. `austin`, `scottsdale`, `75015`, `90210`, `ec1a-1bb`, `shinjuku`) on the fly without 404 errors.
+* **Edge GeoIP Location Detection (`resolveLocationFromHeaders`):** Reads Cloudflare (`cf-ipcity`, `cf-postal-code`), Vercel, AWS CloudFront, and Nginx edge headers to adapt pages to the visitor's real-time location.
+* **Universal Multi-Locale Support:** Works with any ISO-639-1 / BCP-47 locale code (`en`, `de`, `es`, `fr`, `ja`, `pt-BR`, `ar`, `zh-CN`, etc.).
+* **50+ Schema.org Rich Structured Data Types:** Google-compliant JSON-LD generation for `LocalBusiness`, `Product`, `SoftwareApplication`, `HowTo`, `FAQPage`, `BreadcrumbList`, and `Organization`.
+* **Multi-Framework Support:** Seamless operation on Next.js 15/16 (App & Pages Router), TanStack Start, Astro 5, Cloudflare Workers/Pages, Bun, Remix, and Node.js.
 
 ---
 
@@ -32,157 +35,97 @@ bun add @lynxflow/seo-engine
 
 ---
 
-## Core Matrix Architecture
+## Market Scoping: Single Country vs. Global Multi-Country
 
-The SDK structures programmatic content across **10 canonical root pillars** expanding into **50+ specialized sub-matrices**:
+### Option 1: 100% US-Only or Local Single-Country Website
+Prevent crawl waste on out-of-scope foreign locations by enabling `strictCountryBoundary`:
 
+```typescript
+export const SEO_CONFIG = {
+  brandName: "LoneStar HVAC Pro",
+  languages: ["en"],
+  countries: ["united-states"],
+  strictCountryBoundary: true, // 🛡️ Rejects non-US locations
+  defaultCurrency: "USD",
+  defaultCurrencySymbol: "$",
+};
 ```
-┌──────────────────────────────────────┬────────────────────────┬────────────────────────────────────────────────────────┐
-│ 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   │
-└──────────────────────────────────────┴────────────────────────┴────────────────────────────────────────────────────────┘
+
+### Option 2: Worldwide Multi-Country / Multi-Lingual SaaS
+```typescript
+export const SEO_CONFIG = {
+  brandName: "Apex Global Cloud",
+  languages: ["en", "de", "es", "fr", "ja", "pt-BR"],
+  countries: ["united-states", "united-kingdom", "germany", "france", "japan"],
+  strictCountryBoundary: false, // Allows worldwide expansion
+};
 ```
 
 ---
 
-## Quickstart
+## Quickstart & Contrasting Examples
 
-### 1. Initialize Engine & Configure Minimal Inputs
-
-The SDK runs **in-memory inside the client application** (< 0.05ms) and automatically provisions verified cities, populations, GPS coordinates, and currencies from its built-in global demographic database.
+### 1. Initialize Engine & Dataset
 
 ```typescript
 import { PseoMatrixEngine } from "@lynxflow/seo-engine";
 
 export const matrixEngine = new PseoMatrixEngine();
 
-export const SEO_CONFIG = {
-  brandName: "Acme Cloud",
-  languages: ["fr", "en", "es"], // Supported site languages
-  countries: ["france", "espagne", "belgique"], // Or "europe" / "international" — SDK auto-provisions verified cities!
-  cleanDirectRoutes: true, // Eliminates parasite words (/solutions/, etc.) for direct /{service}/{city}
-};
-
 export const PSEO_DATASET = {
   services: [
     { 
-      slug: "autopost-facebook", 
-      name: "Autopost Facebook & Instagram", 
-      category: "Social Media", 
-      keyFeatures: ["AI Scheduling", "Visual Calendar", "Auto-Hashtags"],
-      description: "Automated social media posting engine" 
+      slug: "commercial-hvac", 
+      name: "Commercial HVAC Maintenance", 
+      category: "Facility Management", 
+      keyFeatures: ["24/7 Emergency Dispatch", "Certified Technicians", "Predictive Monitoring"],
+      description: "Enterprise climate control and ventilation services" 
     },
     { 
-      slug: "crm-pipeline", 
-      name: "Visual CRM Pipeline", 
-      category: "Sales", 
-      keyFeatures: ["Kanban", "Lead scoring"],
-      description: "Visual deal tracking software" 
+      slug: "cloud-backup", 
+      name: "Automated Cloud Backup", 
+      category: "Data Security", 
+      keyFeatures: ["End-to-End Encryption", "Instant Recovery", "SOC2 Compliant"],
+      description: "Continuous enterprise backup and disaster recovery" 
     },
   ],
-  targets: [
-    { slug: "agences", name: "Marketing Agencies", type: "industry", painPoints: ["Manual Posting"], benefits: ["10x Output"] }
-  ],
-  integrations: [
-    { slug: "shopify", name: "Shopify", category: "E-Commerce", syncFeatures: ["Catalog sync"] }
-  ],
-  templates: [
-    { slug: "social-calendar-excel", title: "Social Media Calendar", topic: "Social Media", format: "excel", benefits: ["Free download"] }
-  ],
-  glossaryTerms: [
-    { slug: "engagement-rate", term: "Engagement Rate", shortDefinition: "Percentage of audience interacting with content" }
-  ]
 };
 ```
 
-### 2. Next.js Universal Dynamic Catch-All (`app/[...slug]/page.tsx`)
-
-```tsx
-import { notFound } from "next/navigation";
-import { matrixEngine, SEO_CONFIG, PSEO_DATASET } from "@/lib/seo";
-
-export async function generateMetadata({ params }: { params: { slug: string[] } }) {
-  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
-  const page = matrixEngine.resolvePage(params.slug, domain, PSEO_DATASET, SEO_CONFIG);
-  if (!page) return {};
-  return { title: page.title, description: page.description, alternates: { canonical: page.canonicalUrl }, robots: page.robots };
-}
-
-export default async function ProgrammaticPage({ params }: { params: { slug: string[] } }) {
-  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
-  // ⚡ Resolved mathematically in local RAM in < 0.05ms
-  const page = matrixEngine.resolvePage(params.slug, domain, PSEO_DATASET, SEO_CONFIG);
-  if (!page) notFound();
-
-  return (
-    <article className="min-h-screen bg-background text-foreground py-12 px-6 max-w-5xl mx-auto space-y-8">
-      <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(page.schemaGraph) }} />
-      <h1 className="text-4xl font-extrabold">{page.h1}</h1>
-      <p className="text-lg text-muted-foreground">{page.description}</p>
-      {page.neighboringLinks && (
-        <nav className="flex flex-wrap gap-2 pt-6">
-          {page.neighboringLinks.map((l) => (
-            <a key={l.url} href={l.url} className="px-3 py-1 bg-secondary rounded text-xs">{l.name}</a>
-          ))}
-        </nav>
-      )}
-    </article>
-  );
-}
-```
-
-### 3. XML Sitemap & `/llms.txt` Feeds (1 Line of Code)
+### 2. Standard vs. Arbitrary Custom Resolution (Side-by-Side)
 
 ```typescript
-// app/sitemap.ts
-export default function sitemap() {
-  const domain = process.env.NEXT_PUBLIC_SITE_URL || "https://example.com";
-  return matrixEngine.generateAllMatrices(domain, PSEO_DATASET, SEO_CONFIG)
-    .filter(p => p.robots.includes("index"))
-    .map(p => ({ url: p.canonicalUrl, lastModified: new Date() }));
-}
-```
+// Case 1: Standard Pre-Indexed City in English
+const pageStandard = matrixEngine.resolvePage(["commercial-hvac", "new-york"], "https://example.com", PSEO_DATASET, SEO_CONFIG);
 
-const slug = cleanSeoSlug("The best software for managing client invoices in 2026", { language: "en" });
-console.log(slug); // "best-software-managing-client-invoices"
-
-const { isValid, errors } = validateSeoSlug(slug);
-console.log(isValid); // true
+// Case 2: Contrasting Case — Arbitrary Postal Code / Custom District
+const pageCustom = matrixEngine.resolvePage(["commercial-hvac", "90210"], "https://example.com", PSEO_DATASET, SEO_CONFIG);
 ```
 
----
-
-## AI Agents & LLM Prompt Integration
-
-Extract the full internal operational prompt to instruct autonomous AI coding agents (Claude, Cursor, Copilot, ChatGPT, Antigravity) without revealing proprietary logic:
+### 3. Edge GeoIP Resolution Example
 
 ```typescript
-import { getSeoAgentPrompt } from "@lynxflow/seo-engine";
+import { resolveLocationFromHeaders, PseoMatrixEngine } from "@lynxflow/seo-engine";
 
-const prompt = getSeoAgentPrompt({ brandName: "Acme", domain: "https://example.com" });
-// Pass this prompt to your AI coding agent or copilot
+export function handleIncomingRequest(request: Request) {
+  const geo = resolveLocationFromHeaders(request.headers);
+  const userCity = geo.city || "new-york";
+  
+  return matrixEngine.resolvePage(["commercial-hvac", userCity], "https://example.com", PSEO_DATASET, SEO_CONFIG);
+}
 ```
 
 ---
 
 ## TypeScript API Reference
 
-* **`PseoMatrixEngine`**: Core programmatic matrix compiler across all 10 root pillars and 50+ sub-matrices.
+* **`PseoMatrixEngine`**: Core programmatic matrix compiler with geographic boundaries and crawl budget protection.
+* **`createDynamicLocation(slugOrInput, fallbackCountry, options)`**: Dynamic synthesis of any city, postal code or district worldwide.
+* **`resolveLocationFromHeaders(headers)`**: Edge header GeoIP extractor for Cloudflare, Vercel, CloudFront, and Nginx.
 * **`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.
+* **`getSeoAgentPrompt(context)`**: Built-in LLM operational prompt for AI coding agents.
 
 ---
 

package/dist/ai-copilot-client.d.ts

@@ -11,6 +11,8 @@ export interface GenerateArticleParams {
     tone?: "professional" | "persuasive" | "educational";
     wordCount?: number;
     locale?: string;
+    enableRag?: boolean;
+    siteId?: string;
 }
 export interface GeneratedArticleResult {
     title: string;

package/dist/built-in-locations.d.ts

@@ -10,3 +10,25 @@ export declare const BUILT_IN_LOCATIONS_DATABASE: Record<string, PseoLocation[]>
  * Supports: "fr", "france", "es", "spain", "de", "germany", "uk", "us", "be", "ch", "it", "ca", "europe", "international", "all"
  */
 export declare function resolveBuiltInLocations(territories?: string[] | string): PseoLocation[];
+/**
+ * 🚀 Dynamic On-The-Fly Location Synthesizer (Infinite Geo Expansion)
+ * Allows resolving ANY unlisted city, commune, district, or postal code dynamically on demand
+ * without returning 404 or requiring hardcoded databases.
+ */
+export declare function createDynamicLocation(slugOrInput: string, fallbackCountry?: string, options?: {
+    currency?: string;
+    currencySymbol?: string;
+    region?: string;
+}): PseoLocation;
+/**
+ * 📍 GeoIP Edge Headers Resolver (Dynamic User Geolocation)
+ * Extracts the user's real-time city and country from Cloudflare / Vercel / Nginx Edge headers.
+ */
+export declare function resolveLocationFromHeaders(headers: Record<string, string | null | undefined> | Headers | {
+    get(name: string): string | null;
+}): {
+    city?: string;
+    country?: string;
+    region?: string;
+    postalCode?: string;
+};

package/dist/content-ai-arsenal.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 🪄 LynxSEO Content AI Master Arsenal (40+ Tools & Copywriting Formulas)
+ *
+ * Provides complete parity and superiority over Rank Math Content AI, Yoast AI, and AIOSEO:
+ * - 40+ Dedicated AI Generation Tools
+ * - 6 Master Copywriting Formulas (AIDA, PAS, BAB, HERO, SPIN, IDCA)
+ * - 1-Click Long-Form Blog Post Wizard
+ * - AI Link Genius & Internal Link Opportunities
+ * - 1-Click Fix Failed SEO Tests with AI
+ * - AI Brand Visibility & AI Search Tracker
+ * - 125+ Curated SEO Prompt Templates
+ */
+export interface ContentAiToolDefinition {
+    id: string;
+    category: "blogging" | "seo_meta" | "copywriting" | "ecommerce" | "social" | "workflow";
+    name: string;
+    icon: string;
+    description: string;
+    inputs: {
+        name: string;
+        label: string;
+        placeholder: string;
+        type?: "text" | "textarea" | "select";
+        options?: string[];
+    }[];
+    systemPrompt: string;
+}
+export declare const CONTENT_AI_40_TOOLS: ContentAiToolDefinition[];

package/dist/existing-media-harvester.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 📸 Existing Media Harvester & Asset Pool Engine
+ *
+ * Reuses real, pre-existing photos from the client's website & WordPress Media Library:
+ * 1. 0 € GPU Cost & 0s Compute (Zero VRAM Saturation Guarantee)
+ * 2. Maximum Google E-E-A-T Authenticity (Real brand photos > Generic AI images)
+ * 3. Rotates existing photos across the 6 page variations
+ * 4. Dynamically injects localized <img alt="..."> tags across 40+ languages in RAM (< 0.01ms)
+ */
+export interface HarvestedMediaAsset {
+    id?: string | number;
+    url: string;
+    originalAlt?: string;
+    matchedKeywords?: string[];
+    width?: number;
+    height?: number;
+}
+export declare class ExistingMediaHarvester {
+    /**
+     * Extracts all existing image URLs from HTML pages or WordPress Media API
+     */
+    static harvestFromHtml(htmlContent: string, baseUrl?: string): HarvestedMediaAsset[];
+    /**
+     * Matches the best existing photo from the pool for a given service & variation
+     */
+    static selectBestImageForVariant(params: {
+        serviceName: string;
+        variantIndex: number;
+        mediaPool: HarvestedMediaAsset[];
+        fallbackPlaceholderUrl?: string;
+    }): string;
+    private static extractKeywordsFromUrl;
+}

package/dist/extended-schemas.d.ts

@@ -141,4 +141,88 @@ export declare class ExtendedSchemaGraphBuilder {
         url: string;
         searchUrlTemplate?: string;
     }): Record<string, unknown>;
+    /**
+     * 11. Speakable Schema (Google Assistant & Voice Search) - Rank Math Pro Parity
+     */
+    static buildSpeakable(opts: {
+        cssSelectors?: string[];
+        xpaths?: string[];
+    }): Record<string, unknown>;
+    /**
+     * 12. Podcast & PodcastEpisode Schema
+     */
+    static buildPodcastEpisode(opts: {
+        title: string;
+        description: string;
+        audioUrl: string;
+        duration?: string;
+        publishedDate: string;
+        seriesName: string;
+    }): Record<string, unknown>;
+    /**
+     * 13. Restaurant Schema (with Menu & Cuisine)
+     */
+    static buildRestaurant(opts: {
+        name: string;
+        url: string;
+        servesCuisine: string[];
+        menuUrl?: string;
+        priceRange?: string;
+        telephone?: string;
+        address: {
+            street: string;
+            city: string;
+            postalCode: string;
+            country: string;
+        };
+    }): Record<string, unknown>;
+    /**
+     * 14. Book Schema
+     */
+    static buildBook(opts: {
+        name: string;
+        author: string;
+        isbn?: string;
+        bookFormat?: string;
+        url?: string;
+    }): Record<string, unknown>;
+    /**
+     * 15. Dataset Schema (Data Search & Research)
+     */
+    static buildDataset(opts: {
+        name: string;
+        description: string;
+        url: string;
+        keywords: string[];
+        temporalCoverage?: string;
+        distributionUrl?: string;
+    }): Record<string, unknown>;
+    /**
+     * 16. FactCheck Schema (Google ClaimReview)
+     */
+    static buildFactCheck(opts: {
+        claimReviewed: string;
+        ratingValue: string;
+        authorName: string;
+        url: string;
+    }): Record<string, unknown>;
+    /**
+     * 17. Carousel / ItemList Schema
+     */
+    static buildCarousel(items: Array<{
+        name: string;
+        url: string;
+        position: number;
+        image?: string;
+    }>): Record<string, unknown>;
+    /**
+     * 18. QAPage Schema (bbPress / Forums / Community QA)
+     */
+    static buildQAPage(opts: {
+        questionText: string;
+        authorName: string;
+        answerText: string;
+        answerAuthor: string;
+        upvoteCount?: number;
+    }): Record<string, unknown>;
 }

package/dist/features-knowledge-harvester.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 📚 Features & Documentation Knowledge Harvester (Automated Content Extractor)
+ *
+ * Automatically crawls and ingests public documentation, feature pages, and WordPress sitemaps.
+ * Extracts structured knowledge chunks:
+ * - Module Name, Category & H1 Title
+ * - Executive Summaries & Key Paragraphs (up to 15 in-depth paragraphs)
+ * - Workflows & Step-by-Step Guides
+ * - Key Capabilities & Benefit Bullet Points
+ * - Structured FAQs & Objection Handling
+ *
+ * Provides instant in-memory retrieval for programmatic page generation with zero manual writing.
+ */
+export interface ExtractedFeatureKnowledge {
+    slug: string;
+    url: string;
+    title: string;
+    headline?: string;
+    category: string;
+    executiveSummary: string;
+    paragraphs: string[];
+    keyBenefits: string[];
+    workflowSteps: {
+        step: number;
+        title: string;
+        description: string;
+    }[];
+    faqs: {
+        question: string;
+        answer: string;
+    }[];
+    rawTextLength: number;
+}
+export declare class FeaturesKnowledgeHarvester {
+    private static knowledgeStore;
+    /**
+     * Extract knowledge from raw HTML or Markdown content of a public page
+     */
+    static extractFromHtml(url: string, html: string, slug?: string): ExtractedFeatureKnowledge;
+    /**
+     * Batch ingest multiple pages from a sitemap or list of URLs
+     */
+    static ingestPagesFromSitemap(sitemapUrl: string): Promise<number>;
+    /**
+     * Retrieve extracted knowledge for any module by slug
+     */
+    static getKnowledge(slug: string): ExtractedFeatureKnowledge | undefined;
+    /**
+     * Get all registered module knowledge chunks
+     */
+    static getAllKnowledge(): ExtractedFeatureKnowledge[];
+    /**
+     * Generate an ultra-complete, 1000-word programmatic page using harvested knowledge
+     */
+    static buildEnrichedPage(slug: string, locationOrSector: string): string;
+}

package/dist/geo-citation-scorer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 🤖 Generative Engine Optimization (GEO) & AI Citation Scorer
+ *
+ * Analyzes web content and predicts citation probability by Large Language Models
+ * (ChatGPT Search, Perplexity Pro, Claude, Google Gemini / AI Overviews).
+ *
+ * Evaluates:
+ * 1. Direct-Answer Conciseness (Definition / Key Takeaway in first 200 chars)
+ * 2. Fact / Statistical Density (Numbers, %, $, specific dates)
+ * 3. Structured Data & Schema Presence (JSON-LD FAQPage, HowTo, Product)
+ * 4. Entity Salience & Semantic Precision
+ * 5. Citation Marker Friendliness (Bulleted lists, comparison tables, clear definitions)
+ */
+export interface GeoScoreBreakdown {
+    overallScore: number;
+    grade: "S" | "A" | "B" | "C" | "F";
+    aiCitationProbability: "TRÈS FORTE" | "FORTE" | "MOYENNE" | "FAIBLE";
+    metrics: {
+        directAnswerScore: number;
+        factDensityScore: number;
+        structuredDataScore: number;
+        entityClarityScore: number;
+        formatReadabilityScore: number;
+    };
+    keyFindings: {
+        passed: string[];
+        warnings: string[];
+        criticalFixes: string[];
+    };
+    suggestedPromptInjection: string;
+}
+export declare class GeoCitationScorer {
+    static analyzeContent(title: string, content: string, schemaTypes?: string[], hasTables?: boolean): GeoScoreBreakdown;
+}

package/dist/i18n-detector.d.ts

@@ -4,7 +4,7 @@
  * Compatible with next-intl, next-i18next, i18next, Paraglide, and Astro i18n.
  */
 export declare const SUPPORTED_CANONICAL_LOCALES: readonly ["en", "fr", "es", "de", "it", "pt", "nl", "ru", "tr", "zh", "ja", "ko", "hi", "id", "ar", "pl", "sv", "no", "da", "fi", "cs", "el", "ro", "hu", "uk", "vi", "th", "ms", "bg", "hr", "sk", "sl", "et", "lv", "lt", "fa", "bn", "ta", "sw", "af", "tl"];
-export type SupportedLocale = (typeof SUPPORTED_CANONICAL_LOCALES)[number];
+export type SupportedLocale = (typeof SUPPORTED_CANONICAL_LOCALES)[number] | (string & {});
 export declare class I18nDetector {
     /**
      * Resolves a clean 2-letter ISO language code from any locale string (e.g. "fr-FR" -> "fr").

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 /**
  * 🦁 @lynxflow/seo-engine
  *
- * Proprietary Zero-Load Edge SEO Engine & Automated Marketing Suite.
- * - On-Demand Page Generation (< 0.05ms)
+ * Proprietary Zero-SQL-Load Edge SEO Engine & Automated Marketing Suite.
+ * - On-Demand In-Memory Dynamic Page Generation
  * - Product Marketing & CRO Injection (PAS Framework, Friction Reducers)
- * - Google Gold Stars Schema (4.9/5 on 1,280 reviews)
+ * - Verified Real Reviews & Google Rich Snippets Schema (Google Places / Trustpilot API Sync)
  * - Direct-Answer GEO Blocks for AI Search (ChatGPT, Perplexity)
- * - License Key Verification & Rate Limiting
- * - 🦩 Lago Metered Token Billing (`ai_tokens`) & Hyperswitch Payment Switch
+ * - Universal Dynamic Location Synthesis & Real-Time GeoIP Edge Resolution
+ * - Universal Multi-Locale i18n Detection (Any ISO-639-1 / BCP-47 Code)
  */
 export * from "./engine";
 export * from "./slug-engine";
@@ -65,6 +65,8 @@ export * from "./real-reviews-sync";
 export * from "./google-business-profile";
 export * from "./video-youtube-analyzer";
 export * from "./power-words-psychology";
+export * from "./existing-media-harvester";
+export * from "./content-ai-arsenal";
 import { LynxSeoEngine, type EngineConfig } from "./engine";
 import { ApiKeyGuardian } from "./auth-key";
 import { TokenQuotaManager } from "./token-quota-manager";
@@ -98,9 +100,16 @@ import { SocialAdsSocialSeoEngine } from "./social-ads-seo";
 import { AdIntelligenceCroEngine } from "./ad-intelligence-cro";
 import { RankMathParityEngine } from "./rank-math-parity";
 import { YoastParityEngine } from "./yoast-parity";
-import { SocialGrowthSuite } from "./social-growth-suite";
 import { TeamRbacEngine } from "./team-rbac";
 import { RealReviewsSyncEngine } from "./real-reviews-sync";
+import { FeaturesKnowledgeHarvester } from "./features-knowledge-harvester";
+import { PublicRoutesManifestEngine } from "./public-manifest-engine";
+import { KnowledgeBankBuilder } from "./knowledge-bank-builder";
+import { LynxRagKnowledgeEngine } from "./rag-knowledge-engine";
+import { LynxRateLimitedTranslator } from "./rate-limited-translator";
+import { InternalPageRankEngine } from "./internal-pagerank-graph";
+import { GeoCitationScorer } from "./geo-citation-scorer";
+import { MarketingSkillsEngine } from "./marketing-skills-engine";
 export declare function createLynxSeoEngine(config: EngineConfig): LynxSeoEngine;
 export declare const LynxSeo: {
     createEngine: typeof createLynxSeoEngine;
@@ -138,8 +147,24 @@ export declare const LynxSeo: {
     adIntelligence: typeof AdIntelligenceCroEngine;
     rankMathScore: typeof RankMathParityEngine;
     yoastReadability: typeof YoastParityEngine;
-    socialGrowth: typeof SocialGrowthSuite;
     rbac: typeof TeamRbacEngine;
     realReviews: typeof RealReviewsSyncEngine;
+    knowledgeHarvester: typeof FeaturesKnowledgeHarvester;
+    manifest: typeof PublicRoutesManifestEngine;
+    knowledgeBank: typeof KnowledgeBankBuilder;
+    rag: typeof LynxRagKnowledgeEngine;
+    translator: typeof LynxRateLimitedTranslator;
+    pageRankGraph: typeof InternalPageRankEngine;
+    geoCitation: typeof GeoCitationScorer;
+    marketingSkills: typeof MarketingSkillsEngine;
 };
+export * from "./internal-pagerank-graph";
+export * from "./geo-citation-scorer";
+export * from "./marketing-skills-engine";
+export * from "./built-in-locations";
+export { FeaturesKnowledgeHarvester, type ExtractedFeatureKnowledge } from "./features-knowledge-harvester";
+export { PublicRoutesManifestEngine, type PublicRouteItem, type FrameworkManifestConfig } from "./public-manifest-engine";
+export { KnowledgeBankBuilder, type ModuleKnowledgeDocument, type HighEntropySlotVariations } from "./knowledge-bank-builder";
+export { LynxRagKnowledgeEngine, type KnowledgeChunk, type RagRetrievalResult } from "./rag-knowledge-engine";
+export { LynxRateLimitedTranslator, type TranslationClientConfig } from "./rate-limited-translator";
 export default LynxSeo;