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

package/dist/article-strategic-planner.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 📝 Strategic Section-by-Section Article Planner
+ * Ported & optimized from Python article_planner.py (15.5 KB).
+ * Builds a blueprint with word count targets per section, direct answer snippet cards, CTA intensities, and internal linking map.
+ */
+export type SectionType = "intro" | "how_to" | "comparison" | "explanation" | "faq" | "conclusion";
+export type CtaIntensity = "soft" | "medium" | "strong";
+export interface ArticleSectionPlan {
+    sectionNumber: number;
+    type: SectionType;
+    heading: string;
+    targetWordCount: number;
+    strategicObjective: string;
+    hasFeaturedSnippetTarget: boolean;
+    ctaIntensity?: CtaIntensity;
+    internalLinkAnchors: string[];
+}
+export interface ComprehensiveArticlePlan {
+    topic: string;
+    targetTotalWords: number;
+    estimatedReadingTimeMinutes: number;
+    meta: {
+        titleOptions: string[];
+        metaDescription: string;
+        targetKeywords: string[];
+    };
+    sections: ArticleSectionPlan[];
+    ctaMap: Record<string, number>;
+}
+export declare class ArticleStrategicPlanner {
+    /**
+     * Generates a complete strategic article plan tailored to a target keyword and desired depth.
+     */
+    static planArticle(topic: string, primaryKeyword: string, depth?: "standard" | "exhaustive_pillar"): ComprehensiveArticlePlan;
+}

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/index.d.ts

@@ -125,6 +125,12 @@ 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";
+import { LandingChannelScorer } from "./landing-channel-scorer";
+import { ArticleStrategicPlanner } from "./article-strategic-planner";
+import { TopicClusterArchitect } from "./topic-cluster-architect";
 export declare function createLynxSeoEngine(config: EngineConfig): LynxSeoEngine;
 export declare const LynxSeo: {
     createEngine: typeof createLynxSeoEngine;
@@ -147,6 +153,12 @@ export declare const LynxSeo: {
     competitorGap: typeof CompetitorGapBlueprintEngine;
     engagementHook: typeof EngagementHookAnalyzer;
     keywordDensity: typeof KeywordDensityGuard;
+    contentQuality: typeof ContentQualityScorer;
+    landingCroChecker: typeof LandingCroChecker;
+    socialInsights: typeof SocialCommunityInsightsAggregator;
+    channelScorer: typeof LandingChannelScorer;
+    articlePlanner: typeof ArticleStrategicPlanner;
+    topicClusters: typeof TopicClusterArchitect;
     inspectMeta: typeof SiteAuditor.inspectMeta;
     crawlDomain: typeof DeepCrawlerAuditor.crawlAndAuditDomain;
     inspectHtmlSnapshot: typeof DeepCrawlerAuditor.inspectHtmlSnapshot;
@@ -188,6 +200,12 @@ export declare const LynxSeo: {
     marketingSkills: typeof MarketingSkillsEngine;
     regenerationTracker: typeof PageRegenerationTracker;
 };
+export * from "./landing-channel-scorer";
+export * from "./article-strategic-planner";
+export * from "./topic-cluster-architect";
+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";