@lynxflow/seo-engine 2.3.0 → 2.5.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.3.0-orange.svg)](https://www.npmjs.com/package/@lynxflow/seo-engine)
+[![Version](https://img.shields.io/badge/Version-2.5.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/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

@@ -119,6 +119,12 @@ import { SerpLengthComparator } from "./serp-length-comparator";
 import { PassiveVoiceComplexityAnalyzer } from "./passive-voice-complexity";
 import { AboveFoldCroAuditor } from "./above-fold-cro-auditor";
 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";
 export declare function createLynxSeoEngine(config: EngineConfig): LynxSeoEngine;
 export declare const LynxSeo: {
     createEngine: typeof createLynxSeoEngine;
@@ -135,6 +141,12 @@ export declare const LynxSeo: {
     readabilityComplexity: typeof PassiveVoiceComplexityAnalyzer;
     aboveFoldCro: typeof AboveFoldCroAuditor;
     contextTemplates: typeof ContextTemplatesGenerator;
+    searchIntent: typeof SearchIntentClassifier;
+    opportunityPrioritizer: typeof SeoOpportunityPrioritizer;
+    trustSignals: typeof TrustSignalsExtractor;
+    competitorGap: typeof CompetitorGapBlueprintEngine;
+    engagementHook: typeof EngagementHookAnalyzer;
+    keywordDensity: typeof KeywordDensityGuard;
     inspectMeta: typeof SiteAuditor.inspectMeta;
     crawlDomain: typeof DeepCrawlerAuditor.crawlAndAuditDomain;
     inspectHtmlSnapshot: typeof DeepCrawlerAuditor.inspectHtmlSnapshot;
@@ -176,6 +188,12 @@ export declare const LynxSeo: {
     marketingSkills: typeof MarketingSkillsEngine;
     regenerationTracker: typeof PageRegenerationTracker;
 };
+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";
 export * from "./humanity-ai-scrubber";
 export * from "./serp-length-comparator";
 export * from "./passive-voice-complexity";