@lynxflow/seo-engine 2.4.0 → 2.6.0

package/README.md

@@ -4,7 +4,7 @@ High-Performance Universal Programmatic SEO & Structured Data Engine for Modern
 
 [![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-2.4.0-orange.svg)](https://www.npmjs.com/package/@lynxflow/seo-engine)
+[![Version](https://img.shields.io/badge/Version-2.6.0-orange.svg)](https://www.npmjs.com/package/@lynxflow/seo-engine)
 
 ---
 

package/dist/competitor-gap-blueprint.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 🥊 Competitor Gap Blueprint & "Beat Them" Content Architect
+ * Ported & optimized from Python competitor_gap_analyzer.py.
+ * Identifies thin sections, unsupported claims, missing perspectives, and outdated information in competitor content.
+ */
+export type ContentGapType = "thin_section" | "unsupported_claim" | "missing_perspective" | "outdated_info" | "structural_gap";
+export interface CompetitorContentGap {
+    gapType: ContentGapType;
+    description: string;
+    locationHeading: string;
+    competitorUrl: string;
+    priority: "high" | "medium" | "low";
+    counterOpportunity: string;
+}
+export interface CompetitorArticleInput {
+    url: string;
+    title: string;
+    wordCount: number;
+    headings: string[];
+    contentSnippet?: string;
+}
+export interface BeatThemBlueprint {
+    mustFillGaps: CompetitorContentGap[];
+    expectedCommonHeadings: string[];
+    differentiationAngles: string[];
+    outdatedToUpdate: string[];
+    winningOutlineRecommendation: string[];
+}
+export declare class CompetitorGapBlueprintEngine {
+    /**
+     * Analyzes competitors and builds an actionable "Beat Them" blueprint.
+     */
+    static buildBlueprint(targetTopic: string, userWordCount: number, competitors: CompetitorArticleInput[]): BeatThemBlueprint;
+}

package/dist/content-quality-scorer.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 💎 Multi-Dimensional Content Quality Scorer
+ * Ported & optimized from Python content_scorer.py (31 KB).
+ * Evaluates 5 dimensions: Humanity/Voice (30%), Specificity (25%), Structure Balance (20%), SEO Compliance (15%), Readability (10%).
+ * Composite quality threshold: >= 70 to pass.
+ */
+export interface DimensionScoreBreakdown {
+    score: number;
+    weight: number;
+    weightedScore: number;
+    strengths: string[];
+    issues: string[];
+}
+export interface ContentQualityReport {
+    compositeScore: number;
+    passesQualityThreshold: boolean;
+    grade: "A+" | "A" | "B" | "C" | "F";
+    dimensions: {
+        humanity: DimensionScoreBreakdown;
+        specificity: DimensionScoreBreakdown;
+        structureBalance: DimensionScoreBreakdown;
+        seoCompliance: DimensionScoreBreakdown;
+        readability: DimensionScoreBreakdown;
+    };
+    proseToListRatio: number;
+    topPriorityFixes: string[];
+}
+export declare class ContentQualityScorer {
+    private static readonly VAGUE_WORDS;
+    private static readonly SPECIFICITY_DATA_PATTERNS;
+    private static readonly CONVERSATIONAL_DEVICES;
+    /**
+     * Scores content across all 5 dimensions.
+     */
+    static scoreContent(content: string, metadata?: {
+        metaTitle?: string;
+        primaryKeyword?: string;
+    }): ContentQualityReport;
+    private static emptyReport;
+}

package/dist/engagement-hook-analyzer.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 🪝 Engagement Hook & Viral Reading Rhythm Analyzer
+ * Ported & optimized from Python engagement_analyzer.py.
+ * Evaluates the 4 viral reading criteria: Hook quality, sentence length variety, contextual CTA distribution, and paragraph breathability.
+ */
+export interface HookEvaluation {
+    openingSentence: string;
+    isStrongHook: boolean;
+    hookType: "question" | "statistic" | "quote" | "thought_experiment" | "concrete_story" | "generic_bad_opener";
+    feedback: string;
+    suggestedHookUpgrade?: string;
+}
+export interface RhythmEvaluation {
+    sentenceCount: number;
+    averageWords: number;
+    standardDeviation: number;
+    hasVariedRhythm: boolean;
+    score: number;
+}
+export interface CtaDistributionEvaluation {
+    totalCtasDetected: number;
+    isDistributedAcrossArticle: boolean;
+    hasAboveTheFoldCta: boolean;
+    hasMidArticleCta: boolean;
+    hasBottomCta: boolean;
+}
+export interface ParagraphDensityEvaluation {
+    totalParagraphs: number;
+    longParagraphsCount: number;
+    isMobileBreathable: boolean;
+}
+export interface ArticleEngagementReport {
+    engagementScore: number;
+    allPassed: boolean;
+    passedCount: number;
+    hook: HookEvaluation;
+    rhythm: RhythmEvaluation;
+    ctas: CtaDistributionEvaluation;
+    paragraphs: ParagraphDensityEvaluation;
+    actionableFixes: string[];
+}
+export declare class EngagementHookAnalyzer {
+    private static readonly GENERIC_BAD_OPENERS;
+    private static readonly GOOD_HOOK_STARTERS;
+    private static readonly CTA_REGEX;
+    /**
+     * Analyzes an article's engagement mechanics.
+     */
+    static analyze(content: string): ArticleEngagementReport;
+}

package/dist/index.d.ts

@@ -122,6 +122,12 @@ import { ContextTemplatesGenerator } from "./context-templates-generator";
 import { SearchIntentClassifier } from "./search-intent-classifier";
 import { SeoOpportunityPrioritizer } from "./seo-opportunity-prioritizer";
 import { TrustSignalsExtractor } from "./trust-signals-extractor";
+import { CompetitorGapBlueprintEngine } from "./competitor-gap-blueprint";
+import { EngagementHookAnalyzer } from "./engagement-hook-analyzer";
+import { KeywordDensityGuard } from "./keyword-density-guard";
+import { ContentQualityScorer } from "./content-quality-scorer";
+import { LandingCroChecker } from "./landing-cro-checker";
+import { SocialCommunityInsightsAggregator } from "./social-community-insights";
 export declare function createLynxSeoEngine(config: EngineConfig): LynxSeoEngine;
 export declare const LynxSeo: {
     createEngine: typeof createLynxSeoEngine;
@@ -141,6 +147,12 @@ export declare const LynxSeo: {
     searchIntent: typeof SearchIntentClassifier;
     opportunityPrioritizer: typeof SeoOpportunityPrioritizer;
     trustSignals: typeof TrustSignalsExtractor;
+    competitorGap: typeof CompetitorGapBlueprintEngine;
+    engagementHook: typeof EngagementHookAnalyzer;
+    keywordDensity: typeof KeywordDensityGuard;
+    contentQuality: typeof ContentQualityScorer;
+    landingCroChecker: typeof LandingCroChecker;
+    socialInsights: typeof SocialCommunityInsightsAggregator;
     inspectMeta: typeof SiteAuditor.inspectMeta;
     crawlDomain: typeof DeepCrawlerAuditor.crawlAndAuditDomain;
     inspectHtmlSnapshot: typeof DeepCrawlerAuditor.inspectHtmlSnapshot;
@@ -182,6 +194,12 @@ export declare const LynxSeo: {
     marketingSkills: typeof MarketingSkillsEngine;
     regenerationTracker: typeof PageRegenerationTracker;
 };
+export * from "./content-quality-scorer";
+export * from "./landing-cro-checker";
+export * from "./social-community-insights";
+export * from "./competitor-gap-blueprint";
+export * from "./engagement-hook-analyzer";
+export * from "./keyword-density-guard";
 export * from "./search-intent-classifier";
 export * from "./seo-opportunity-prioritizer";
 export * from "./trust-signals-extractor";