@rankcli/agent-runtime 0.0.9 → 0.0.11

package/dist/index.d.mts

@@ -90,14 +90,14 @@ interface HeadingStructure {
     text: string;
     level: number;
 }
-interface ImageInfo$1 {
+interface ImageInfo$2 {
     src: string;
     alt: string | null;
     width?: string;
     height?: string;
     loading?: string;
 }
-interface LinkInfo {
+interface LinkInfo$1 {
     href: string;
     text: string;
     isInternal: boolean;
@@ -111,7 +111,8 @@ interface FrameworkInfo$1 {
     name: string;
     version?: string;
     router?: 'app' | 'pages' | 'file-based' | 'custom';
-    metaPattern: 'metadata-export' | 'head-component' | 'frontmatter' | 'meta-function' | 'html-head';
+    language?: 'javascript' | 'typescript' | 'ruby' | 'python' | 'php' | 'java' | 'csharp' | 'go' | 'elixir' | 'rust';
+    metaPattern: 'metadata-export' | 'head-component' | 'frontmatter' | 'meta-function' | 'html-head' | 'erb-helpers' | 'blade-components' | 'thymeleaf' | 'razor' | 'heex' | 'go-templates' | 'django-templates' | 'server-rendered';
 }
 interface Fix {
     issue: {
@@ -131,8 +132,8 @@ interface ToolResult {
 }
 type ToolFunction = (params: Record<string, unknown>) => Promise<ToolResult>;
 
-type IssueSeverity = 'error' | 'warning' | 'notice';
-type IssueCategory = 'crawlability' | 'indexability' | 'on-page' | 'content' | 'links' | 'images' | 'structured-data' | 'performance' | 'security' | 'mobile' | 'international' | 'ai-readiness' | 'social' | 'local-seo' | 'accessibility' | 'framework';
+type IssueSeverity = 'critical' | 'error' | 'warning' | 'info' | 'notice';
+type IssueCategory = 'crawlability' | 'indexability' | 'on-page' | 'content' | 'links' | 'images' | 'structured-data' | 'performance' | 'security' | 'mobile' | 'international' | 'ai-readiness' | 'social' | 'local-seo' | 'accessibility' | 'framework' | 'technical';
 interface AuditIssue {
     code: string;
     severity: IssueSeverity;
@@ -319,7 +320,7 @@ interface ImageData {
     lazyLoaded: number;
     withDimensions: number;
 }
-declare function analyzeImages(html: string, baseUrl: string, checkBroken?: boolean): Promise<{
+declare function analyzeImages$1(html: string, baseUrl: string, checkBroken?: boolean): Promise<{
     issues: AuditIssue[];
     data: ImageData;
 }>;
@@ -376,18 +377,18 @@ declare function checkCertificate(url: string): Promise<{
     issues: AuditIssue[];
 }>;
 
-interface SchemaItem {
+interface SchemaItem$1 {
     type: string;
     data: Record<string, unknown>;
     errors: string[];
     warnings: string[];
 }
 interface StructuredDataData {
-    schemas: SchemaItem[];
+    schemas: SchemaItem$1[];
     hasSchema: boolean;
     schemaTypes: string[];
 }
-declare function analyzeStructuredData(html: string, url: string): {
+declare function analyzeStructuredData$1(html: string, url: string): {
     issues: AuditIssue[];
     data: StructuredDataData;
 };
@@ -690,7 +691,7 @@ interface SecurityHeadersData {
 /**
  * Analyze security headers
  */
-declare function analyzeSecurityHeaders(url: string): Promise<{
+declare function analyzeSecurityHeaders$1(url: string): Promise<{
     issues: AuditIssue[];
     data: SecurityHeadersData;
 }>;
@@ -730,7 +731,7 @@ declare function analyzeDOMStructure(html: string, url: string): {
     data: DOMAnalysisData;
 };
 
-interface ImageInfo {
+interface ImageInfo$1 {
     src: string;
     alt: string | null;
     width: number | null;
@@ -746,7 +747,7 @@ interface ModernImagesData {
     modernFormatCount: number;
     legacyFormatCount: number;
     modernFormatPercentage: number;
-    images: ImageInfo[];
+    images: ImageInfo$1[];
     hasSourceSet: boolean;
     hasPictureElements: boolean;
 }
@@ -3186,6 +3187,19 @@ declare function generateSvelteKitSEOHead(options: MetaFixOptions): GeneratedCod
 declare function generateAngularSEOService(options: MetaFixOptions): GeneratedCode;
 declare function getFrameworkSpecificFix(framework: FrameworkInfo$1, options: MetaFixOptions): GeneratedCode;
 declare function generateNextJsPagesRouterHead(options: MetaFixOptions): GeneratedCode;
+declare function generateRailsSEOHelper(options: MetaFixOptions): GeneratedCode;
+declare function generateDjangoSEOHelper(options: MetaFixOptions): GeneratedCode;
+declare function generateLaravelSEOHelper(options: MetaFixOptions): GeneratedCode;
+declare function generateSpringBootSEO(options: MetaFixOptions): GeneratedCode;
+declare function generatePhoenixSEO(options: MetaFixOptions): GeneratedCode;
+declare function generateGoSEO(options: MetaFixOptions): GeneratedCode;
+declare function generateAspNetCoreSEO(options: MetaFixOptions): GeneratedCode;
+declare function generateHTMXSEO(options: MetaFixOptions): GeneratedCode;
+declare function generateHugoSEO(options: MetaFixOptions): GeneratedCode;
+declare function generateJekyllSEO(options: MetaFixOptions): GeneratedCode;
+declare function generateEleventySEO(options: MetaFixOptions): GeneratedCode;
+declare function generateRemixSEO(options: MetaFixOptions): GeneratedCode;
+declare function getFrameworkSpecificFixExtended(framework: FrameworkInfo$1, options: MetaFixOptions): GeneratedCode;
 
 /**
  * World-Class JSON-LD Schema Generators
@@ -4794,20 +4808,591 @@ declare function getAIVisibilitySummary(results: LLMCitationResult[]): {
     overallSentiment: 'positive' | 'neutral' | 'negative' | 'mixed' | null;
 };
 
+/**
+ * Mobile SEO Analyzer
+ *
+ * Analyzes mobile-friendliness and mobile SEO best practices.
+ * Critical for Google's mobile-first indexing.
+ */
+
+interface MobileSEOResult {
+    score: number;
+    viewport: ViewportAnalysis;
+    touchTargets: TouchTargetAnalysis;
+    fontSizes: FontSizeAnalysis;
+    contentWidth: ContentWidthAnalysis;
+    mobileSpecific: MobileSpecificAnalysis;
+    issues: AuditIssue[];
+    recommendations: string[];
+}
+interface ViewportAnalysis {
+    hasViewport: boolean;
+    isResponsive: boolean;
+    viewportContent?: string;
+    issues: string[];
+}
+interface TouchTargetAnalysis {
+    smallTargets: number;
+    properTargets: number;
+    issues: string[];
+}
+interface FontSizeAnalysis {
+    hasResponsiveFonts: boolean;
+    smallFontIndicators: number;
+    issues: string[];
+}
+interface ContentWidthAnalysis {
+    hasHorizontalScroll: boolean;
+    fixedWidthElements: number;
+    issues: string[];
+}
+interface MobileSpecificAnalysis {
+    hasAppleTouchIcon: boolean;
+    hasThemeColor: boolean;
+    hasManifest: boolean;
+    hasMobileOptimizedImages: boolean;
+    avoidsMobilePopups: boolean;
+    issues: string[];
+}
+/**
+ * Main mobile SEO analysis
+ */
+declare function analyzeMobileSEO(html: string, url: string): MobileSEOResult;
+
+/**
+ * Internal Linking Analyzer
+ *
+ * Analyzes internal link structure for SEO optimization.
+ * Checks link distribution, anchor text, orphan pages, and link depth.
+ */
+
+interface InternalLinkingResult {
+    score: number;
+    totalLinks: number;
+    internalLinks: number;
+    externalLinks: number;
+    navigationLinks: number;
+    contentLinks: number;
+    uniqueInternalTargets: number;
+    linksWithKeywords: number;
+    linksWithGenericText: number;
+    orphanRisk: boolean;
+    linkDetails: LinkInfo[];
+    anchorTextAnalysis: AnchorTextStats;
+    issues: AuditIssue[];
+    recommendations: string[];
+}
+interface LinkInfo {
+    href: string;
+    text: string;
+    isInternal: boolean;
+    isNavigation: boolean;
+    rel?: string;
+    title?: string;
+    issues: string[];
+}
+interface AnchorTextStats {
+    total: number;
+    descriptive: number;
+    generic: number;
+    empty: number;
+    tooLong: number;
+    imageLinks: number;
+    patterns: {
+        text: string;
+        count: number;
+    }[];
+}
+/**
+ * Analyze internal linking structure
+ */
+declare function analyzeInternalLinking(html: string, url: string): InternalLinkingResult;
+/**
+ * Suggest internal linking opportunities
+ */
+declare function suggestInternalLinks(content: string, availablePages: {
+    url: string;
+    title: string;
+    keywords: string[];
+}[]): {
+    keyword: string;
+    suggestedUrl: string;
+    suggestedTitle: string;
+    relevance: number;
+}[];
+
+/**
+ * Image Optimization Analyzer
+ *
+ * Analyzes images for SEO and performance optimization.
+ * Checks formats, dimensions, alt text, lazy loading, and compression indicators.
+ */
+
+interface ImageAnalysisResult {
+    score: number;
+    totalImages: number;
+    imagesWithAlt: number;
+    imagesWithDimensions: number;
+    imagesWithLazyLoading: number;
+    modernFormats: number;
+    legacyFormats: number;
+    oversizedImages: ImageInfo[];
+    missingAlt: ImageInfo[];
+    decorativeWithoutRole: ImageInfo[];
+    issues: AuditIssue[];
+    recommendations: string[];
+}
+interface ImageInfo {
+    src: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+    format?: string;
+    loading?: string;
+    issues: string[];
+}
+/**
+ * Analyze all images on a page
+ */
+declare function analyzeImages(html: string, url: string): ImageAnalysisResult;
+/**
+ * Generate responsive image HTML
+ */
+declare function generateResponsiveImage(options: {
+    src: string;
+    alt: string;
+    widths: number[];
+    sizes?: string;
+    loading?: 'lazy' | 'eager';
+    className?: string;
+}): string;
+
+/**
+ * Structured Data / Schema.org Analyzer
+ *
+ * Validates JSON-LD structured data for SEO and AI search optimization.
+ * Checks for common schema types, required properties, and best practices.
+ */
+
+interface StructuredDataResult {
+    score: number;
+    schemas: SchemaItem[];
+    hasOrganization: boolean;
+    hasWebSite: boolean;
+    hasWebPage: boolean;
+    hasBreadcrumb: boolean;
+    hasArticle: boolean;
+    hasProduct: boolean;
+    hasFAQ: boolean;
+    hasHowTo: boolean;
+    hasLocalBusiness: boolean;
+    hasEvent: boolean;
+    hasReview: boolean;
+    issues: AuditIssue[];
+    recommendations: string[];
+}
+interface SchemaItem {
+    type: string;
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+    properties: string[];
+}
+/**
+ * Analyze all structured data on a page
+ */
+declare function analyzeStructuredData(html: string, url: string): StructuredDataResult;
+/**
+ * Generate recommended schema for a page type
+ */
+declare function generateSchemaTemplate(pageType: 'article' | 'product' | 'faq' | 'local-business' | 'website', options: {
+    siteName: string;
+    siteUrl: string;
+    authorName?: string;
+    organizationName?: string;
+}): string;
+
+/**
+ * Security Headers Analyzer
+ *
+ * Analyzes HTTP security headers that impact SEO and trust signals.
+ * Many security headers are now considered ranking factors.
+ */
+
+interface SecurityHeadersResult {
+    score: number;
+    https: {
+        enabled: boolean;
+        hasHSTS: boolean;
+        hstsMaxAge?: number;
+        includesSubdomains: boolean;
+        preload: boolean;
+    };
+    contentSecurity: {
+        hasCSP: boolean;
+        policy?: string;
+        issues: string[];
+    };
+    frameOptions: {
+        hasXFrameOptions: boolean;
+        value?: string;
+    };
+    contentTypeOptions: {
+        hasXContentTypeOptions: boolean;
+    };
+    xssProtection: {
+        hasXXSSProtection: boolean;
+        value?: string;
+    };
+    referrerPolicy: {
+        hasReferrerPolicy: boolean;
+        value?: string;
+    };
+    permissionsPolicy: {
+        hasPermissionsPolicy: boolean;
+        policy?: string;
+    };
+    issues: AuditIssue[];
+    grade: 'A+' | 'A' | 'B' | 'C' | 'D' | 'F';
+}
+/**
+ * Analyze security headers
+ */
+declare function analyzeSecurityHeaders(headers: Record<string, string>, url: string): SecurityHeadersResult;
+/**
+ * Generate recommended security headers
+ */
+declare function generateSecurityHeaders(siteUrl: string): Record<string, string>;
+
+/**
+ * Core Web Vitals Analyzer
+ *
+ * Estimates Core Web Vitals from HTML analysis without actual page load.
+ * Identifies common issues that impact LCP, FID, CLS, INP, and TTFB.
+ */
+
+interface CoreWebVitalsEstimate {
+    lcp: {
+        estimate: 'good' | 'needs-improvement' | 'poor' | 'unknown';
+        issues: string[];
+        recommendations: string[];
+    };
+    fid: {
+        estimate: 'good' | 'needs-improvement' | 'poor' | 'unknown';
+        issues: string[];
+        recommendations: string[];
+    };
+    cls: {
+        estimate: 'good' | 'needs-improvement' | 'poor' | 'unknown';
+        issues: string[];
+        recommendations: string[];
+    };
+    inp: {
+        estimate: 'good' | 'needs-improvement' | 'poor' | 'unknown';
+        issues: string[];
+        recommendations: string[];
+    };
+    ttfb: {
+        estimate: 'good' | 'needs-improvement' | 'poor' | 'unknown';
+        issues: string[];
+        recommendations: string[];
+    };
+    overallScore: number;
+    issues: AuditIssue[];
+}
+/**
+ * Main Core Web Vitals analysis function
+ */
+declare function analyzeCoreWebVitals(html: string, url: string, headers?: Record<string, string>): CoreWebVitalsEstimate;
+
+/**
+ * GEO (Generative Engine Optimization) Analyzer
+ *
+ * Industry-first analyzer for AI search visibility.
+ * Checks if your site is optimized for ChatGPT, Perplexity, Claude, and other AI search engines.
+ *
+ * Features:
+ * - AI crawler accessibility detection
+ * - LLM-friendly content structure analysis
+ * - Citation-optimized formatting
+ * - Entity and fact extraction readiness
+ * - AI search ranking factors
+ */
+
+interface GEOAnalysisResult {
+    score: number;
+    aiCrawlerAccess: AIAccessResult;
+    contentStructure: ContentStructureResult;
+    citationReadiness: CitationResult;
+    entityExtraction: EntityResult;
+    llmSignals: LLMSignalResult;
+    issues: AuditIssue[];
+    recommendations: string[];
+}
+interface AIAccessResult {
+    robotsTxtAllowsAI: boolean;
+    blockedCrawlers: string[];
+    allowedCrawlers: string[];
+    hasPrerendering: boolean;
+    jsRenderingRequired: boolean;
+    serverSideRendered: boolean;
+}
+interface ContentStructureResult {
+    hasStructuredData: boolean;
+    hasFAQSchema: boolean;
+    hasHowToSchema: boolean;
+    hasArticleSchema: boolean;
+    hasProductSchema: boolean;
+    hasBreadcrumbs: boolean;
+    headingHierarchy: 'good' | 'needs-work' | 'poor';
+    contentSections: number;
+    listsAndTables: number;
+}
+interface CitationResult {
+    hasCitations: boolean;
+    hasExternalLinks: boolean;
+    hasStatistics: boolean;
+    hasQuotes: boolean;
+    hasAuthorInfo: boolean;
+    hasPublishDate: boolean;
+    hasLastModified: boolean;
+    trustSignals: string[];
+}
+interface EntityResult {
+    namedEntities: string[];
+    definedTerms: string[];
+    hasDefinitions: boolean;
+    hasComparisons: boolean;
+    questionAnswerPairs: number;
+}
+interface LLMSignalResult {
+    contentClarity: number;
+    factDensity: number;
+    structureQuality: number;
+    citationQuality: number;
+    overallLLMFriendliness: number;
+}
+/**
+ * Analyze robots.txt for AI crawler permissions
+ */
+declare function analyzeRobotsTxtForAI(robotsTxt: string): {
+    allowed: string[];
+    blocked: string[];
+    recommendations: string[];
+};
+/**
+ * Detect if page is server-side rendered or requires JS
+ */
+declare function detectRenderingMode(html: string): {
+    serverSideRendered: boolean;
+    jsRenderingRequired: boolean;
+    hasPrerendering: boolean;
+    contentInHTML: boolean;
+    signals: string[];
+};
+/**
+ * Analyze content structure for LLM consumption
+ */
+declare function analyzeContentStructure(html: string): ContentStructureResult;
+/**
+ * Analyze citation readiness (trust signals for AI)
+ */
+declare function analyzeCitationReadiness(html: string): CitationResult;
+/**
+ * Extract entities and structured information
+ */
+declare function analyzeEntityExtraction(html: string): EntityResult;
+/**
+ * Calculate LLM-friendliness signals
+ */
+declare function calculateLLMSignals(structure: ContentStructureResult, citation: CitationResult, entity: EntityResult, html: string): LLMSignalResult;
+/**
+ * Main GEO analysis function
+ */
+declare function analyzeGEO(html: string, url: string, robotsTxt?: string): Promise<GEOAnalysisResult>;
+/**
+ * Generate AI-optimized robots.txt
+ */
+declare function generateAIFriendlyRobotsTxt(siteUrl: string): string;
+declare const AI_CRAWLERS_INFO: {
+    GPTBot: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+    ChatGPTUser: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+    OAI_SearchBot: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+    ClaudeBot: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+    anthropic_ai: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+    PerplexityBot: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+    GoogleOther: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+    Bingbot: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+    FacebookBot: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+    MetaAI: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+    Applebot: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+    Amazonbot: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+    YouBot: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+    CCBot: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+    cohere_ai: {
+        userAgent: string;
+        company: string;
+        purpose: string;
+    };
+};
+
+/**
+ * Comprehensive SEO Analysis
+ *
+ * Runs all analyzers and produces a unified report.
+ */
+interface ComprehensiveSEOResult {
+    url: string;
+    timestamp: string;
+    overallScore: number;
+    grades: {
+        geo: number;
+        coreWebVitals: number;
+        security: string;
+        structuredData: number;
+        images: number;
+        internalLinking: number;
+        mobile: number;
+    };
+    geo: GEOAnalysisResult;
+    coreWebVitals: CoreWebVitalsEstimate;
+    security: SecurityHeadersResult;
+    structuredData: StructuredDataResult;
+    images: ImageAnalysisResult;
+    internalLinking: InternalLinkingResult;
+    mobile: MobileSEOResult;
+    allIssues: AuditIssue[];
+    prioritizedRecommendations: string[];
+}
+/**
+ * Run comprehensive SEO analysis
+ */
+declare function analyzeComprehensive(html: string, url: string, options?: {
+    robotsTxt?: string;
+    headers?: Record<string, string>;
+}): Promise<ComprehensiveSEOResult>;
+
+type index$1_AIAccessResult = AIAccessResult;
+declare const index$1_AI_CRAWLERS_INFO: typeof AI_CRAWLERS_INFO;
+type index$1_AnchorTextStats = AnchorTextStats;
+type index$1_CitationResult = CitationResult;
+type index$1_ComprehensiveSEOResult = ComprehensiveSEOResult;
+type index$1_ContentStructureResult = ContentStructureResult;
+type index$1_ContentWidthAnalysis = ContentWidthAnalysis;
+type index$1_CoreWebVitalsEstimate = CoreWebVitalsEstimate;
+type index$1_EntityResult = EntityResult;
+type index$1_FontSizeAnalysis = FontSizeAnalysis;
+type index$1_GEOAnalysisResult = GEOAnalysisResult;
+type index$1_ImageAnalysisResult = ImageAnalysisResult;
+type index$1_ImageInfo = ImageInfo;
+type index$1_InternalLinkingResult = InternalLinkingResult;
+type index$1_LLMSignalResult = LLMSignalResult;
+type index$1_LinkInfo = LinkInfo;
+type index$1_MobileSEOResult = MobileSEOResult;
+type index$1_MobileSpecificAnalysis = MobileSpecificAnalysis;
+type index$1_SchemaItem = SchemaItem;
+type index$1_SecurityHeadersResult = SecurityHeadersResult;
+type index$1_StructuredDataResult = StructuredDataResult;
+type index$1_TouchTargetAnalysis = TouchTargetAnalysis;
+type index$1_ViewportAnalysis = ViewportAnalysis;
+declare const index$1_analyzeCitationReadiness: typeof analyzeCitationReadiness;
+declare const index$1_analyzeComprehensive: typeof analyzeComprehensive;
+declare const index$1_analyzeContentStructure: typeof analyzeContentStructure;
+declare const index$1_analyzeCoreWebVitals: typeof analyzeCoreWebVitals;
+declare const index$1_analyzeEntityExtraction: typeof analyzeEntityExtraction;
+declare const index$1_analyzeGEO: typeof analyzeGEO;
+declare const index$1_analyzeImages: typeof analyzeImages;
+declare const index$1_analyzeInternalLinking: typeof analyzeInternalLinking;
+declare const index$1_analyzeMobileSEO: typeof analyzeMobileSEO;
+declare const index$1_analyzeRobotsTxtForAI: typeof analyzeRobotsTxtForAI;
+declare const index$1_analyzeSecurityHeaders: typeof analyzeSecurityHeaders;
+declare const index$1_analyzeStructuredData: typeof analyzeStructuredData;
+declare const index$1_calculateLLMSignals: typeof calculateLLMSignals;
+declare const index$1_detectRenderingMode: typeof detectRenderingMode;
+declare const index$1_generateAIFriendlyRobotsTxt: typeof generateAIFriendlyRobotsTxt;
+declare const index$1_generateResponsiveImage: typeof generateResponsiveImage;
+declare const index$1_generateSchemaTemplate: typeof generateSchemaTemplate;
+declare const index$1_generateSecurityHeaders: typeof generateSecurityHeaders;
+declare const index$1_suggestInternalLinks: typeof suggestInternalLinks;
+declare namespace index$1 {
+  export { type index$1_AIAccessResult as AIAccessResult, index$1_AI_CRAWLERS_INFO as AI_CRAWLERS_INFO, type index$1_AnchorTextStats as AnchorTextStats, type index$1_CitationResult as CitationResult, type index$1_ComprehensiveSEOResult as ComprehensiveSEOResult, type index$1_ContentStructureResult as ContentStructureResult, type index$1_ContentWidthAnalysis as ContentWidthAnalysis, type index$1_CoreWebVitalsEstimate as CoreWebVitalsEstimate, type index$1_EntityResult as EntityResult, type index$1_FontSizeAnalysis as FontSizeAnalysis, type index$1_GEOAnalysisResult as GEOAnalysisResult, type index$1_ImageAnalysisResult as ImageAnalysisResult, type index$1_ImageInfo as ImageInfo, type index$1_InternalLinkingResult as InternalLinkingResult, type index$1_LLMSignalResult as LLMSignalResult, type index$1_LinkInfo as LinkInfo, type index$1_MobileSEOResult as MobileSEOResult, type index$1_MobileSpecificAnalysis as MobileSpecificAnalysis, type index$1_SchemaItem as SchemaItem, type index$1_SecurityHeadersResult as SecurityHeadersResult, type index$1_StructuredDataResult as StructuredDataResult, type index$1_TouchTargetAnalysis as TouchTargetAnalysis, type index$1_ViewportAnalysis as ViewportAnalysis, index$1_analyzeCitationReadiness as analyzeCitationReadiness, index$1_analyzeComprehensive as analyzeComprehensive, index$1_analyzeContentStructure as analyzeContentStructure, index$1_analyzeCoreWebVitals as analyzeCoreWebVitals, index$1_analyzeEntityExtraction as analyzeEntityExtraction, index$1_analyzeGEO as analyzeGEO, index$1_analyzeImages as analyzeImages, index$1_analyzeInternalLinking as analyzeInternalLinking, index$1_analyzeMobileSEO as analyzeMobileSEO, index$1_analyzeRobotsTxtForAI as analyzeRobotsTxtForAI, index$1_analyzeSecurityHeaders as analyzeSecurityHeaders, index$1_analyzeStructuredData as analyzeStructuredData, index$1_calculateLLMSignals as calculateLLMSignals, index$1_detectRenderingMode as detectRenderingMode, index$1_generateAIFriendlyRobotsTxt as generateAIFriendlyRobotsTxt, index$1_generateResponsiveImage as generateResponsiveImage, index$1_generateSchemaTemplate as generateSchemaTemplate, index$1_generateSecurityHeaders as generateSecurityHeaders, index$1_suggestInternalLinks as suggestInternalLinks };
+}
+
 /**
  * Framework Detection
  *
  * Detects web frameworks from:
  * 1. HTML signatures (data attributes, meta tags, scripts)
- * 2. package.json dependencies
+ * 2. package.json / Gemfile / requirements.txt / composer.json / etc.
  * 3. File structure patterns
+ * 4. HTTP response headers
+ *
+ * Supports 25+ frameworks across JavaScript, Ruby, Python, PHP, Java, C#, Go, and Elixir.
  */
-type Framework = 'react' | 'nextjs' | 'vue' | 'nuxt' | 'angular' | 'svelte' | 'sveltekit' | 'astro' | 'remix' | 'gatsby' | 'rails' | 'laravel' | 'django' | 'wordpress' | 'unknown';
+type Framework = 'react' | 'nextjs' | 'vue' | 'nuxt' | 'angular' | 'svelte' | 'sveltekit' | 'astro' | 'remix' | 'gatsby' | 'solidjs' | 'qwik' | 'fresh' | 'rails' | 'django' | 'flask' | 'fastapi' | 'laravel' | 'symfony' | 'wordpress' | 'spring' | 'aspnet' | 'go' | 'phoenix' | 'htmx' | 'hotwire' | 'hugo' | 'jekyll' | 'eleventy' | 'pelican' | 'unknown';
+type Language = 'javascript' | 'typescript' | 'ruby' | 'python' | 'php' | 'java' | 'csharp' | 'go' | 'elixir' | 'rust' | 'unknown';
 interface FrameworkInfo {
     framework: Framework;
     version?: string;
+    language: Language;
     confidence: 'high' | 'medium' | 'low';
-    detected_from: 'html' | 'package.json' | 'files' | 'headers';
+    detected_from: 'html' | 'package.json' | 'files' | 'headers' | 'gemfile' | 'requirements' | 'composer' | 'pom' | 'csproj' | 'go.mod' | 'mix.exs';
     meta_framework?: Framework;
 }
 /**
@@ -4815,7 +5400,7 @@ interface FrameworkInfo {
  */
 declare function detectFromHtml(html: string): FrameworkInfo | null;
 /**
- * Detect framework from package.json content
+ * Detect framework from package.json content (JavaScript/TypeScript)
  */
 declare function detectFromPackageJson(packageJson: {
     dependencies?: Record<string, string>;
@@ -4834,6 +5419,16 @@ declare function detectFramework(options: {
         dependencies?: Record<string, string>;
         devDependencies?: Record<string, string>;
     };
+    composerJson?: {
+        require?: Record<string, string>;
+        'require-dev'?: Record<string, string>;
+    };
+    gemfileContent?: string;
+    requirementsContent?: string;
+    pomXmlContent?: string;
+    csprojContent?: string;
+    goModContent?: string;
+    mixExsContent?: string;
     headers?: Record<string, string>;
     files?: string[];
 }): FrameworkInfo;
@@ -5012,4 +5607,4 @@ interface SyncAuditResult {
  */
 declare function runSyncAudit(url: string, html: string, checksLimit: number): SyncAuditResult;
 
-export { type AIContentConfig, type AIKeywordResearchOptions, type AgentDefinition, type AgentTool, type AlertChannel, type AlertConfig, type AlertMessage, type AlertResult, type AlertSeverity, type AlertType, type AuditAlertPayload, type AuditIssue, type AuditIssueData, type AuditOptions, type AuditPRResult, type AuditReport, type AuditReportData, type AuditRunnerOptions, type AuditRunnerResult, type AuditSchedule, type BlogPostConfig, type BrandConfig, type CIAction, type CIKeywordOptions, type CIKeywordResult, COMMIT_TYPES, type ChangelogConfig, type ChangelogResult, type CitationCheckOptions, type CommitConfig, type ComparisonConfig, type ComparisonRow, type CompetitiveInsight, type CompetitiveSearchOptions, type CompetitiveSearchResult, type CompetitorComparison, type CompetitorKeywordResult, type CompetitorOverlap, type CompetitorTool, type ContentElements, type ContentGeneratorOptions, type ContentRecommendation, type ConventionalCommit, type CrawlResult, type CrawlStats, type CrawledPage, type CreateAuditPROptions, type CreatePROptions, type DataForSEOCredentials, type DiscoveredPage, type EnhancedToolIdea, type ExecOptions, type ExecuteOptions, type ExecutionResult, type FAQItem, type FAQSchemaOptions, type FeaturedSnippetAnalysis, type Fix, type FixFile, type FixGeneratorOptions, type FixResult, type FrameworkInfo$1 as FrameworkInfo, type FreeKeywordResult, type FreeToolIdea, type GA4Config, type GEOAlert, type GEOAlertType, type GEOHistory, type GEOHistoryOptions, type GEOQuery, type GEOReport, type GEOResult, type GEOTrend, type GSCConfig, type GSCCredentials, type GSCPerformanceData, type GSCQueryData, type GSCQueryResult, type GeneratedCode, type GeneratedContent, type GeneratedFix, type HeadingStructure, type HeadlineAnalysis, type HealthScore, ISSUE_DEFINITIONS, type ImageInfo$1 as ImageInfo, type InjectionResult, type IntentAnalysis, type IssueCategory, type IssueDefinition, type IssueSeverity, type KeyFact, type KeyFactsOptions, type KeywordAction, type KeywordCluster, type KeywordData, type KeywordDensityAnalysis, type KeywordOpportunity, type KeywordRecommendation, type KeywordResearchOptions, type KeywordResearchResult, type KeywordStats, type KeywordTopic, type LLMCitationResult, type LLMJudgeOptions, type LLMProvider, LOCATION_CODES, type LSIKeyword, type LinkInfo, type Mention, type MentionType, type MetaData, type MetaFixOptions, type NGram, type NLPAnalysisResult, OG_IMAGE_SPECS, type OptimizeOptions, type PRConfig, type PRDescription, PRIORITY_WEIGHTS, type PRResult, type PageAudit, type PageData, type PageMeta, type PaidKeywordResult, type ParsedResponse, type PlanTier, type ProviderStats, type QuickWin, type ReadabilityResult, type ReadmeConfig, type ReadmeResult, type ReportBranding, type ReportConfig, type ReportData, type ReportPageData, type RouteInfo, type SEOAnalysisResult, type SEOFixCommit, type SEOFixSummary, type SEOIssue, type SEORecommendation, type SEOScore, SEO_SCOPES, SITE_PROFILE_QUESTIONS, type ScheduledAuditConfig, type ScheduledAuditResult, type SchemaData, Schemas, type SearchIntent, type Sentiment, type SiteCrawlResult, type SiteProfile, type SiteSummary, type SnippetRecommendation, type SnippetType, type SocialMetaConfig, type SocialMetaFix, type SummarizerOptions, type TFIDFResult, type ToolFeasibilityScore, type ToolFunction, type ToolResult, type TopicClusterResult, type TopicModel, type TrackingOptions, type TrendDirection, type UncertaintyAssessment, type WizardQuestion, type WizardResponse, type WizardResult, type WizardSession, type WorkflowConfig, addTrackingResult, analyzeAnchorText, analyzeCanonicalAdvanced, analyzeClientRendering, analyzeContentFreshness, analyzeConversionElements, analyzeDOMStructure, analyzeEntitySEO, analyzeFeaturedSnippetPotential, analyzeFreshnessSignals, analyzeFunnelIntent, analyzeHeadings, analyzeHeadline, analyzeHreflang, analyzeImages, analyzeInteractiveTools, analyzeKeywordDensity, analyzeKeywordPlacement, analyzeKeywords, analyzeLinks, analyzeLocalSEO, analyzeMobile, analyzeModernImages, analyzeNavBoostSignals, analyzeOnPage, analyzePagination, analyzePerformance, analyzePlatformPresence, analyzeReadability, analyzeRedirectChain, analyzeRedirects, analyzeResponsiveImages, analyzeSERPPreview, analyzeSecurity, analyzeSecurityHeaders, analyzeSocialMeta, analyzeStructuredData, analyzeTopicalClusters, analyzeTrackerBloat, analyzeUrl, analyzeUrlSafety, applyFixes, buildGSCApiRequest, buildGSCRequest, calculateAIVisibilityScore, calculateBM25, calculateTFIDF$1 as calculateKeywordTFIDF, calculateNextRun, calculateTFIDF, checkAIBotBlocking, checkAMP, checkAdsTxt, checkAppleTouchIcon, checkBalance, checkCertificate, checkDMARC, checkGitHubCLI, checkInternalRedirects, checkJSRenderingRatio, checkLLMCitations, checkLlmsTxt, checkMobileResources, checkPlaintextEmails, checkRedirects, checkRobots, checkRobotsTxt, checkSPF, checkSitemap, classifyIntent, classifyIntents, clusterKeywordsByEmbedding, compareCompetitorVisibility, comparePeriods, completeWizard, crawlSite, crawlUrl, createAuditPR, createFallbackSummary, createGEOHistory, createPullRequest, createSEOCommit, createSEOCommits, detectDuplicates, detectFramework$1 as detectFramework, detectGitHubPages, detectMentions, detectSoft404, detectTechnologies, detectVisibilityChanges, discoverCompetitorKeywords, discoverPagesFromLinks, discoverRoutesFromRepo, enhanceSummaryWithCompetitors, enhanceToolIdea, enrichKeywordsWithEstimates, ensureGitRepo, evaluateAndEnhanceToolIdeas, evaluateToolFeasibility, executeAgent, extractContentHash, extractEntityPhrases, extractImages, extractKeyPhrases, extractLinks, extractMeta, extractNgrams, extractSchema, extractSeedKeywords, extractTopics, fetchCoreWebVitals, findAlmostPage1Keywords, findCTROpportunities, findHtmlEntry, findLSIKeywords, findPageFiles, findTopPerformers, formatAlertMessage, formatCIResult, formatCompetitorReport, formatConventionalCommit, formatFeaturedSnippetReport, formatHeadlineReport, formatIntentReport, formatKeywordDensityReport, formatKeywordReport, formatPRBody, formatPRTitle, formatReadabilityReport, formatReport, formatSEOCommitMessage, formatTopicReport, formatWizardProgress, index as frameworks, generateAICitableContent, generateAllFixes, generateAngularSEOService, generateAstroBaseHead, generateAstroMeta, generateBlogPost, generateBranchName, generateChangelog, generateCommitSummary, generateComparisonTable, generateCompleteSocialMetaSetup, generateDuplicateIssues, generateFAQSchema, generateFixes, generateGA4EnvTemplate, generateGA4ReactComponent, generateGA4Script, generateGA4ViteScript, generateGEOReport, generateGSCVerificationTag, generateGitHubActionSetup, generateHTMLReport, generateHTMLSocialMeta, generateHeadlineVariations, generateJsonReport, generateKeyFacts, generateMarkdownReport, generateNextAppMetadata, generateNextJsAppRouterMetadata, generateNextJsPagesRouterHead, generateNextPagesHead, generateNuxtSEOHead, generatePDFReport, generatePRDescription, generateReactHelmetSocialMeta, generateReactSEOHead, generateRecommendationQueries, generateRemixMeta, generateSecretsDoc, generateSocialMetaFix, generateSvelteKitMeta, generateSvelteKitSEOHead, generateUncertaintyQuestions, generateVueSEOHead, generateWizardQuestions, generateWorkflow, getAIVisibilitySummary, getAutocompleteSuggestions, getDateRange, getExpandedSuggestions, getFrameworkSpecificFix, getGSCSetupInstructions, getGitUser, getKeywordData, getKeywordSuggestions, getMaxKdThreshold, getNextQuestion, getRelatedKeywords, getVisibilityTrend, groupKeywordsByTopic, identifyQuickWins, injectGA4, injectGSCVerification, interpolatePrompt, isGitRepo, listFiles, loadAgent, loadAgentByName, mergePages, optimizeForAI, optimizeReadme, parseGEOResponse, parseGSCResponse, parseSitemap, prioritizeKeywords, processWizardResponse, readFile, routesToUrls, runAIKeywordResearch, runAIReadinessChecks, runAdditionalChecks, runAuditWithFixes, runCIKeywordResearch, runCrawlabilityChecks, runDirectAnalysis, runFullAudit, runKeywordResearch, runNLPAnalysis, runScheduledAudit, runSyncAudit, scoreContentSEO, scoreMention, searchCompetitors, searchFormatConverters, searchHackerNews, sendAlert, sendAlerts, sendDiscordAlert, sendSlackAlert, shouldRunAudit, shouldSendAlert, startWizardSession, suggestSchemaTypes, summarizeSite, tokenize, tools, trackLLMVisibility, transformGSCData, urlSafetyDatabase, wizardResponsesToContext, writeFile, writeGitHubActionFiles };
+export { type AIContentConfig, type AIKeywordResearchOptions, type AgentDefinition, type AgentTool, type AlertChannel, type AlertConfig, type AlertMessage, type AlertResult, type AlertSeverity, type AlertType, type AuditAlertPayload, type AuditIssue, type AuditIssueData, type AuditOptions, type AuditPRResult, type AuditReport, type AuditReportData, type AuditRunnerOptions, type AuditRunnerResult, type AuditSchedule, type BlogPostConfig, type BrandConfig, type CIAction, type CIKeywordOptions, type CIKeywordResult, COMMIT_TYPES, type ChangelogConfig, type ChangelogResult, type CitationCheckOptions, type CommitConfig, type ComparisonConfig, type ComparisonRow, type CompetitiveInsight, type CompetitiveSearchOptions, type CompetitiveSearchResult, type CompetitorComparison, type CompetitorKeywordResult, type CompetitorOverlap, type CompetitorTool, type ContentElements, type ContentGeneratorOptions, type ContentRecommendation, type ConventionalCommit, type CrawlResult, type CrawlStats, type CrawledPage, type CreateAuditPROptions, type CreatePROptions, type DataForSEOCredentials, type DiscoveredPage, type EnhancedToolIdea, type ExecOptions, type ExecuteOptions, type ExecutionResult, type FAQItem, type FAQSchemaOptions, type FeaturedSnippetAnalysis, type Fix, type FixFile, type FixGeneratorOptions, type FixResult, type FrameworkInfo$1 as FrameworkInfo, type FreeKeywordResult, type FreeToolIdea, type GA4Config, type GEOAlert, type GEOAlertType, type GEOHistory, type GEOHistoryOptions, type GEOQuery, type GEOReport, type GEOResult, type GEOTrend, type GSCConfig, type GSCCredentials, type GSCPerformanceData, type GSCQueryData, type GSCQueryResult, type GeneratedCode, type GeneratedContent, type GeneratedFix, type HeadingStructure, type HeadlineAnalysis, type HealthScore, ISSUE_DEFINITIONS, type ImageInfo$2 as ImageInfo, type InjectionResult, type IntentAnalysis, type IssueCategory, type IssueDefinition, type IssueSeverity, type KeyFact, type KeyFactsOptions, type KeywordAction, type KeywordCluster, type KeywordData, type KeywordDensityAnalysis, type KeywordOpportunity, type KeywordRecommendation, type KeywordResearchOptions, type KeywordResearchResult, type KeywordStats, type KeywordTopic, type LLMCitationResult, type LLMJudgeOptions, type LLMProvider, LOCATION_CODES, type LSIKeyword, type LinkInfo$1 as LinkInfo, type Mention, type MentionType, type MetaData, type MetaFixOptions, type NGram, type NLPAnalysisResult, OG_IMAGE_SPECS, type OptimizeOptions, type PRConfig, type PRDescription, PRIORITY_WEIGHTS, type PRResult, type PageAudit, type PageData, type PageMeta, type PaidKeywordResult, type ParsedResponse, type PlanTier, type ProviderStats, type QuickWin, type ReadabilityResult, type ReadmeConfig, type ReadmeResult, type ReportBranding, type ReportConfig, type ReportData, type ReportPageData, type RouteInfo, type SEOAnalysisResult, type SEOFixCommit, type SEOFixSummary, type SEOIssue, type SEORecommendation, type SEOScore, SEO_SCOPES, SITE_PROFILE_QUESTIONS, type ScheduledAuditConfig, type ScheduledAuditResult, type SchemaData, Schemas, type SearchIntent, type Sentiment, type SiteCrawlResult, type SiteProfile, type SiteSummary, type SnippetRecommendation, type SnippetType, type SocialMetaConfig, type SocialMetaFix, type SummarizerOptions, type TFIDFResult, type ToolFeasibilityScore, type ToolFunction, type ToolResult, type TopicClusterResult, type TopicModel, type TrackingOptions, type TrendDirection, type UncertaintyAssessment, type WizardQuestion, type WizardResponse, type WizardResult, type WizardSession, type WorkflowConfig, addTrackingResult, analyzeAnchorText, analyzeCanonicalAdvanced, analyzeClientRendering, analyzeContentFreshness, analyzeConversionElements, analyzeDOMStructure, analyzeEntitySEO, analyzeFeaturedSnippetPotential, analyzeFreshnessSignals, analyzeFunnelIntent, analyzeHeadings, analyzeHeadline, analyzeHreflang, analyzeImages$1 as analyzeImages, analyzeInteractiveTools, analyzeKeywordDensity, analyzeKeywordPlacement, analyzeKeywords, analyzeLinks, analyzeLocalSEO, analyzeMobile, analyzeModernImages, analyzeNavBoostSignals, analyzeOnPage, analyzePagination, analyzePerformance, analyzePlatformPresence, analyzeReadability, analyzeRedirectChain, analyzeRedirects, analyzeResponsiveImages, analyzeSERPPreview, analyzeSecurity, analyzeSecurityHeaders$1 as analyzeSecurityHeaders, analyzeSocialMeta, analyzeStructuredData$1 as analyzeStructuredData, analyzeTopicalClusters, analyzeTrackerBloat, analyzeUrl, analyzeUrlSafety, index$1 as analyzers, applyFixes, buildGSCApiRequest, buildGSCRequest, calculateAIVisibilityScore, calculateBM25, calculateTFIDF$1 as calculateKeywordTFIDF, calculateNextRun, calculateTFIDF, checkAIBotBlocking, checkAMP, checkAdsTxt, checkAppleTouchIcon, checkBalance, checkCertificate, checkDMARC, checkGitHubCLI, checkInternalRedirects, checkJSRenderingRatio, checkLLMCitations, checkLlmsTxt, checkMobileResources, checkPlaintextEmails, checkRedirects, checkRobots, checkRobotsTxt, checkSPF, checkSitemap, classifyIntent, classifyIntents, clusterKeywordsByEmbedding, compareCompetitorVisibility, comparePeriods, completeWizard, crawlSite, crawlUrl, createAuditPR, createFallbackSummary, createGEOHistory, createPullRequest, createSEOCommit, createSEOCommits, detectDuplicates, detectFramework$1 as detectFramework, detectGitHubPages, detectMentions, detectSoft404, detectTechnologies, detectVisibilityChanges, discoverCompetitorKeywords, discoverPagesFromLinks, discoverRoutesFromRepo, enhanceSummaryWithCompetitors, enhanceToolIdea, enrichKeywordsWithEstimates, ensureGitRepo, evaluateAndEnhanceToolIdeas, evaluateToolFeasibility, executeAgent, extractContentHash, extractEntityPhrases, extractImages, extractKeyPhrases, extractLinks, extractMeta, extractNgrams, extractSchema, extractSeedKeywords, extractTopics, fetchCoreWebVitals, findAlmostPage1Keywords, findCTROpportunities, findHtmlEntry, findLSIKeywords, findPageFiles, findTopPerformers, formatAlertMessage, formatCIResult, formatCompetitorReport, formatConventionalCommit, formatFeaturedSnippetReport, formatHeadlineReport, formatIntentReport, formatKeywordDensityReport, formatKeywordReport, formatPRBody, formatPRTitle, formatReadabilityReport, formatReport, formatSEOCommitMessage, formatTopicReport, formatWizardProgress, index as frameworks, generateAICitableContent, generateAllFixes, generateAngularSEOService, generateAspNetCoreSEO, generateAstroBaseHead, generateAstroMeta, generateBlogPost, generateBranchName, generateChangelog, generateCommitSummary, generateComparisonTable, generateCompleteSocialMetaSetup, generateDjangoSEOHelper, generateDuplicateIssues, generateEleventySEO, generateFAQSchema, generateFixes, generateGA4EnvTemplate, generateGA4ReactComponent, generateGA4Script, generateGA4ViteScript, generateGEOReport, generateGSCVerificationTag, generateGitHubActionSetup, generateGoSEO, generateHTMLReport, generateHTMLSocialMeta, generateHTMXSEO, generateHeadlineVariations, generateHugoSEO, generateJekyllSEO, generateJsonReport, generateKeyFacts, generateLaravelSEOHelper, generateMarkdownReport, generateNextAppMetadata, generateNextJsAppRouterMetadata, generateNextJsPagesRouterHead, generateNextPagesHead, generateNuxtSEOHead, generatePDFReport, generatePRDescription, generatePhoenixSEO, generateRailsSEOHelper, generateReactHelmetSocialMeta, generateReactSEOHead, generateRecommendationQueries, generateRemixMeta, generateRemixSEO, generateSecretsDoc, generateSocialMetaFix, generateSpringBootSEO, generateSvelteKitMeta, generateSvelteKitSEOHead, generateUncertaintyQuestions, generateVueSEOHead, generateWizardQuestions, generateWorkflow, getAIVisibilitySummary, getAutocompleteSuggestions, getDateRange, getExpandedSuggestions, getFrameworkSpecificFix, getFrameworkSpecificFixExtended, getGSCSetupInstructions, getGitUser, getKeywordData, getKeywordSuggestions, getMaxKdThreshold, getNextQuestion, getRelatedKeywords, getVisibilityTrend, groupKeywordsByTopic, identifyQuickWins, injectGA4, injectGSCVerification, interpolatePrompt, isGitRepo, listFiles, loadAgent, loadAgentByName, mergePages, optimizeForAI, optimizeReadme, parseGEOResponse, parseGSCResponse, parseSitemap, prioritizeKeywords, processWizardResponse, readFile, routesToUrls, runAIKeywordResearch, runAIReadinessChecks, runAdditionalChecks, runAuditWithFixes, runCIKeywordResearch, runCrawlabilityChecks, runDirectAnalysis, runFullAudit, runKeywordResearch, runNLPAnalysis, runScheduledAudit, runSyncAudit, scoreContentSEO, scoreMention, searchCompetitors, searchFormatConverters, searchHackerNews, sendAlert, sendAlerts, sendDiscordAlert, sendSlackAlert, shouldRunAudit, shouldSendAlert, startWizardSession, suggestSchemaTypes, summarizeSite, tokenize, tools, trackLLMVisibility, transformGSCData, urlSafetyDatabase, wizardResponsesToContext, writeFile, writeGitHubActionFiles };