@lynxflow/seo-engine 2.2.0 → 2.4.0

package/dist/passive-voice-complexity.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ✍️ Readability, Passive Voice & Sentence Complexity Analyzer
+ * Analyzes sentence length variance, passive voice frequency, and paragraph density
+ * across English, French, German, and Spanish.
+ */
+export interface SentenceDetail {
+    text: string;
+    wordCount: number;
+    isPassive: boolean;
+    isTooLong: boolean;
+}
+export interface ReadabilityComplexityReport {
+    totalSentences: number;
+    totalWords: number;
+    averageWordsPerSentence: number;
+    passiveVoiceRatio: number;
+    passiveSentencesCount: number;
+    complexSentencesCount: number;
+    gradeLevelEstimate: number;
+    readabilityEaseScore: number;
+    status: "clear_and_punchy" | "acceptable" | "hard_to_read";
+    keyWarnings: string[];
+    sentences: SentenceDetail[];
+}
+export declare class PassiveVoiceComplexityAnalyzer {
+    private static readonly PASSIVE_PATTERNS;
+    /**
+     * Analyzes text for passive voice, sentence complexity, and readability.
+     */
+    static analyze(text: string, language?: string): ReadabilityComplexityReport;
+}

package/dist/search-intent-classifier.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 🎯 Search Intent Classifier & SERP Feature Intent Mapper
+ * Ported & optimized from Python search_intent_analyzer.py.
+ * Classifies queries as: Informational, Navigational, Transactional, or Commercial Investigation.
+ */
+export type QueryIntentClassification = "informational" | "navigational" | "transactional" | "commercial_investigation";
+export interface SearchIntentResult {
+    primaryIntent: QueryIntentClassification;
+    confidenceScore: number;
+    scores: {
+        informational: number;
+        navigational: number;
+        transactional: number;
+        commercial_investigation: number;
+    };
+    detectedSignals: string[];
+    recommendedContentFormat: string;
+}
+export declare class SearchIntentClassifier {
+    private static readonly INFORMATIONAL_SIGNALS;
+    private static readonly NAVIGATIONAL_SIGNALS;
+    private static readonly TRANSACTIONAL_SIGNALS;
+    private static readonly COMMERCIAL_SIGNALS;
+    /**
+     * Classifies query intent in < 0.01ms.
+     */
+    static classify(keyword: string, serpFeatures?: string[]): SearchIntentResult;
+}

package/dist/seo-opportunity-prioritizer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 📈 Multi-Factor SEO Opportunity Prioritizer
+ * Ported & optimized from Python opportunity_scorer.py.
+ * Computes an 8-factor Opportunity Score (0-100) using real CTR curves & GSC ranking proximity.
+ */
+export type OpportunityArchetype = "quick_win" | "top_3_push" | "high_volume_gap" | "underperformer" | "declining";
+export interface OpportunityInput {
+    keyword: string;
+    currentPosition?: number;
+    monthlyImpressions?: number;
+    monthlyClicks?: number;
+    actualCtr?: number;
+    searchVolume?: number;
+    difficulty?: number;
+    intent?: "informational" | "commercial_investigation" | "transactional" | "navigational";
+}
+export interface OpportunityScoreResult {
+    opportunityScore: number;
+    archetype: OpportunityArchetype;
+    estimatedClickGain: number;
+    factors: {
+        volumeScore: number;
+        positionScore: number;
+        intentScore: number;
+        competitionScore: number;
+        ctrImprovementScore: number;
+    };
+    priorityLevel: "critical" | "high" | "medium" | "low";
+    actionPlan: string;
+}
+export declare class SeoOpportunityPrioritizer {
+    private static readonly BENCHMARK_CTR;
+    /**
+     * Calculates comprehensive opportunity score for content prioritization.
+     */
+    static evaluate(input: OpportunityInput): OpportunityScoreResult;
+}

package/dist/serp-length-comparator.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 📏 SERP Content Length Comparator
+ * Analyzes top 10-20 SERP competitor word counts, computes statistical benchmarks
+ * (Median, 75th Percentile, Top 3 Average), and recommends the optimal content length.
+ */
+export interface CompetitorWordCount {
+    url: string;
+    title?: string;
+    rank: number;
+    wordCount: number;
+}
+export interface SerpLengthAnalysis {
+    userWordCount: number;
+    targetQuery: string;
+    competitorCount: number;
+    competitors: CompetitorWordCount[];
+    stats: {
+        min: number;
+        max: number;
+        median: number;
+        p75: number;
+        top3Average: number;
+        recommendedTargetWords: number;
+    };
+    gapToTarget: number;
+    status: "insufficient" | "optimal" | "excessive";
+    actionPlan: string;
+}
+export declare class SerpLengthComparator {
+    /**
+     * Evaluates content length against real or simulated SERP competitor word counts.
+     */
+    static compareLength(userWordCount: number, targetQuery: string, competitors?: CompetitorWordCount[]): SerpLengthAnalysis;
+}

package/dist/trust-signals-extractor.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 🛡️ Trust Signals & Social Proof Extractor
+ * Ported & optimized from Python trust_signal_analyzer.py.
+ * Extracts testimonials, customer numbers, percentage growth stats, risk reversals, and media mentions.
+ */
+export interface ExtractedTrustSignals {
+    totalSignalsCount: number;
+    testimonials: Array<{
+        quote: string;
+        author?: string;
+    }>;
+    socialProofCounts: string[];
+    specificResults: string[];
+    riskReversals: string[];
+    authorityMentions: string[];
+    trustScore: number;
+    isSufficientForConversion: boolean;
+}
+export declare class TrustSignalsExtractor {
+    private static readonly SOCIAL_PROOF_PATTERNS;
+    private static readonly RESULT_PATTERNS;
+    private static readonly RISK_REVERSAL_PATTERNS;
+    private static readonly AUTHORITY_PATTERNS;
+    /**
+     * Scans text or HTML and extracts all verifiable trust signals.
+     */
+    static extract(content: string): ExtractedTrustSignals;
+}

package/package.json

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