@lynxflow/seo-engine 2.1.1 → 2.3.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/semantic-cannibalization.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 🔍 Semantic Cannibalization & Keyword Overlap Detector
+ * Analyzes large programmatic page hubs (10,000+ pages) to detect semantic collisions,
+ * title duplicates, and keyword cannibalization between neighboring locations or services.
+ */
+export interface PageCrawlNode {
+    urlPath: string;
+    title: string;
+    h1: string;
+    targetKeywords?: string[];
+}
+export interface CannibalizationAlert {
+    primaryUrl: string;
+    conflictingUrl: string;
+    similarityScore: number;
+    conflictType: "exact_title" | "high_semantic_overlap" | "keyword_collision";
+    sharedTokens: string[];
+    recommendation: string;
+}
+export interface CannibalizationAuditSummary {
+    totalPagesAudited: number;
+    totalAlerts: number;
+    criticalCount: number;
+    moderateCount: number;
+    alerts: CannibalizationAlert[];
+}
+export declare class SemanticCannibalizationDetector {
+    /**
+     * Tokenizes text and strips common punctuation for n-gram comparison.
+     */
+    private static tokenize;
+    /**
+     * Computes Jaccard similarity between two token sets (0.0 to 1.0).
+     */
+    private static jaccardSimilarity;
+    /**
+     * Audits a collection of pages and returns cannibalization risks.
+     */
+    static auditPages(pages: PageCrawlNode[], options?: {
+        similarityThreshold?: number;
+        maxAlerts?: number;
+    }): CannibalizationAuditSummary;
+}

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/package.json

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