aeorank 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,334 @@
+/**
+ * AEORank type definitions.
+ * Inlined from @aeo/shared to keep the package zero-dependency.
+ */
+type Status = 'MISSING' | 'NEARLY EMPTY' | 'POOR' | 'WEAK' | 'PARTIAL' | 'MODERATE' | 'GOOD' | 'STRONG';
+type Severity = 'WORKING' | 'GOOD' | 'GOOD PATTERN' | 'PARTIAL' | 'MISSING' | 'ADD' | 'FIX' | 'FIX IMMEDIATELY' | 'REWRITE' | 'CONFUSING' | 'INCONSISTENT' | 'SPARSE' | 'PERFORMANCE' | 'CLUTTER' | 'PLATFORM LIMIT' | 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'BIG OPPORTUNITY' | 'AEO GOLDMINE' | 'AEO CORE' | 'CORE AEO' | 'AEO deliverable' | 'QUICK WIN' | 'MEASUREMENT';
+type FindingType = 'Test' | 'Good' | 'Bad' | 'Missing' | 'Critical' | 'Issue' | 'Fix' | 'Exists' | 'Calc' | 'Present' | 'Note' | 'Current' | 'Volume' | 'Bonus' | 'Impact';
+type ImpactLevel = 'QUICK WIN' | 'CRITICAL' | 'HIGH' | 'CORE AEO' | 'MEDIUM' | 'LOW' | 'MEASUREMENT' | 'BIG OPPORTUNITY';
+interface ScoreCardItem {
+    id: number;
+    criterion: string;
+    score: number;
+    status: Status;
+    keyFindings: string;
+}
+interface DetailedFinding {
+    type: FindingType;
+    description: string;
+    severity: Severity;
+}
+interface CriterionDetail {
+    id: number;
+    name: string;
+    findings: DetailedFinding[];
+}
+interface Deliverable {
+    id: number;
+    name: string;
+    description: string;
+    effort: string;
+    impact: ImpactLevel;
+}
+interface PitchMetric {
+    metric: string;
+    value: string;
+    significance: string;
+}
+type PageCategory$1 = 'homepage' | 'blog' | 'about' | 'pricing' | 'services' | 'contact' | 'team' | 'resources' | 'docs' | 'cases' | 'content';
+interface PageIssue$1 {
+    check: string;
+    label: string;
+    severity: 'error' | 'warning' | 'info';
+}
+interface PageReview$1 {
+    url: string;
+    title: string;
+    category: PageCategory$1;
+    wordCount: number;
+    issues: PageIssue$1[];
+    strengths: PageIssue$1[];
+}
+interface AuditData {
+    site: string;
+    auditDate: string;
+    auditor: string;
+    engine?: string;
+    overallScore: number;
+    verdict: string;
+    scorecard: ScoreCardItem[];
+    detailedFindings: CriterionDetail[];
+    opportunities: Deliverable[];
+    pitchNumbers: PitchMetric[];
+    bottomLine: string;
+    pagesReviewed?: PageReview$1[];
+}
+type AuditStatus = 'pass' | 'fail' | 'partial' | 'not_found';
+type Priority = 'P0' | 'P1' | 'P2' | 'P3';
+type FindingSeverity = 'critical' | 'high' | 'medium' | 'low' | 'info';
+interface AuditFinding {
+    severity: FindingSeverity;
+    detail: string;
+    fix?: string;
+}
+
+/**
+ * Programmatic audit API.
+ * Runs the full 7-phase AEO audit pipeline and returns structured results.
+ */
+
+interface AuditOptions {
+    /** Skip Puppeteer SPA rendering (default: false) */
+    noHeadless?: boolean;
+    /** Homepage + blog only, skip extra page discovery (default: false) */
+    noMultiPage?: boolean;
+    /** Fetch timeout in ms (default: 15000) */
+    timeout?: number;
+}
+interface AuditResult extends AuditData {
+    /** True if headless browser was used for SPA rendering */
+    renderedWithHeadless?: boolean;
+    /** Wall-clock seconds */
+    elapsed: number;
+}
+/**
+ * Run a complete AEO audit on a domain.
+ *
+ * @example
+ * ```ts
+ * import { audit } from 'aeorank';
+ * const result = await audit('example.com');
+ * console.log(result.overallScore); // 0-100
+ * ```
+ */
+declare function audit(domain: string, options?: AuditOptions): Promise<AuditResult>;
+
+interface CriterionResult {
+    criterion: string;
+    criterion_label: string;
+    score: number;
+    status: AuditStatus;
+    findings: AuditFinding[];
+    fix_priority: Priority;
+}
+type PageCategory = 'homepage' | 'blog' | 'about' | 'pricing' | 'services' | 'contact' | 'team' | 'resources' | 'docs' | 'cases' | 'content';
+interface FetchResult {
+    text: string;
+    status: number;
+    finalUrl?: string;
+    category?: PageCategory;
+}
+interface SiteData {
+    domain: string;
+    protocol: 'https' | 'http' | null;
+    homepage: FetchResult | null;
+    llmsTxt: FetchResult | null;
+    robotsTxt: FetchResult | null;
+    faqPage: FetchResult | null;
+    sitemapXml: FetchResult | null;
+    rssFeed: FetchResult | null;
+    aiTxt: FetchResult | null;
+    /** Set when homepage redirects to a different (non-brand) domain */
+    redirectedTo: string | null;
+    /** Set when homepage is a parked/for-sale/lost domain */
+    parkedReason: string | null;
+    /** Sampled blog/content pages from sitemap (up to 5) */
+    blogSample?: FetchResult[];
+}
+interface RawDataSummary {
+    domain: string;
+    protocol: 'https' | 'http' | null;
+    homepage_length: number;
+    homepage_text_length: number;
+    has_https: boolean;
+    llms_txt_status: number | null;
+    llms_txt_length: number;
+    robots_txt_status: number | null;
+    robots_txt_snippet: string;
+    robots_txt_ai_crawlers: string[];
+    robots_txt_blocked_crawlers: string[];
+    schema_types_found: string[];
+    schema_block_count: number;
+    faq_page_status: number | null;
+    faq_page_length: number;
+    sitemap_status: number | null;
+    internal_link_count: number;
+    external_link_count: number;
+    question_headings_count: number;
+    h1_count: number;
+    has_meta_description: boolean;
+    has_title: boolean;
+    has_phone: boolean;
+    has_address: boolean;
+    has_org_schema: boolean;
+    has_social_links: boolean;
+    semantic_elements_found: string[];
+    img_count: number;
+    img_with_alt_count: number;
+    has_lang_attr: boolean;
+    has_aria: boolean;
+    has_breadcrumbs: boolean;
+    has_nav: boolean;
+    has_footer: boolean;
+    has_case_studies: boolean;
+    has_statistics: boolean;
+    has_expert_attribution: boolean;
+    has_blog_section: boolean;
+    has_date_modified_schema: boolean;
+    time_element_count: number;
+    sitemap_url_count: number;
+    has_rss_feed: boolean;
+    table_count: number;
+    ordered_list_count: number;
+    unordered_list_count: number;
+    definition_pattern_count: number;
+    has_ai_txt: boolean;
+    has_person_schema: boolean;
+    fact_data_point_count: number;
+    has_canonical: boolean;
+    has_license_schema: boolean;
+    sitemap_recent_lastmod_count: number;
+    rendered_with_headless?: boolean;
+    has_speakable_schema: boolean;
+    speakable_selector_count: number;
+    blog_sample_count: number;
+    blog_sample_urls: string[];
+    blog_sample_schema_types: string[];
+    blog_sample_question_headings: number;
+    blog_sample_faq_schema_found: boolean;
+}
+/**
+ * Fetches all site data in parallel with HTTPS/HTTP fallback.
+ * Single entry point for all HTTP requests - no redundant fetches.
+ */
+declare function prefetchSiteData(domain: string): Promise<SiteData>;
+declare function extractRawDataSummary(data: SiteData): RawDataSummary;
+/**
+ * Run all 23 criteria checks using pre-fetched site data.
+ * All functions are synchronous (no HTTP calls) - data was already fetched.
+ */
+declare function auditSiteFromData(data: SiteData): CriterionResult[];
+
+declare function calculateOverallScore(criteria: CriterionResult[]): number;
+
+/**
+ * Shared scorecard building functions.
+ * Extracted from cli/pre-crawl.ts for reuse in instant-audit and other consumers.
+ */
+
+declare const CRITERION_LABELS: Record<string, string>;
+declare function scoreToStatus(score: number): Status;
+declare function buildScorecard(results: CriterionResult[]): ScoreCardItem[];
+declare function buildDetailedFindings(results: CriterionResult[]): CriterionDetail[];
+
+/**
+ * Deterministic narrative generation from scorecard data.
+ * Produces verdict, opportunities, pitchNumbers, and bottomLine
+ * without any LLM calls - pure template-based generation.
+ */
+
+declare function generateVerdict(score: number, scorecard: ScoreCardItem[], rawData: RawDataSummary, domain: string): string;
+declare function generateOpportunities(scorecard: ScoreCardItem[], criterionResults: CriterionResult[]): Deliverable[];
+declare function generatePitchNumbers(score: number, rawData: RawDataSummary, scorecard: ScoreCardItem[]): PitchMetric[];
+declare function generateBottomLine(score: number, opportunities: Deliverable[], scorecard: ScoreCardItem[], domain: string): string;
+
+/**
+ * Per-page analysis for instant audit.
+ * Runs 12 deterministic checks on each crawled page (no LLM).
+ */
+
+interface PageIssue {
+    check: string;
+    label: string;
+    severity: 'error' | 'warning' | 'info';
+}
+interface PageReview {
+    url: string;
+    title: string;
+    category: PageCategory;
+    wordCount: number;
+    issues: PageIssue[];
+    strengths: PageIssue[];
+}
+declare function analyzePage(html: string, url: string, category: PageCategory): PageReview;
+declare function analyzeAllPages(siteData: SiteData): PageReview[];
+
+/**
+ * Extended page discovery for instant audit.
+ * Fetches additional pages beyond what prefetchSiteData provides,
+ * including nav-linked pages, common paths, and content pages from sitemap.
+ */
+
+/**
+ * Extract internal page paths from <nav> elements in homepage HTML.
+ * Returns deduplicated absolute paths (e.g. ['/about', '/pricing']).
+ */
+declare function extractNavLinks(html: string, domain: string): string[];
+/**
+ * Extract non-blog deep content pages from sitemap XML.
+ * Targets service pages, product pages, etc. (not blog/article posts).
+ */
+declare function extractContentPagesFromSitemap(sitemapText: string, domain: string, limit?: number): string[];
+interface MultiPageOptions {
+    timeoutMs?: number;
+}
+/**
+ * Fetch additional pages beyond what prefetchSiteData provides.
+ * Discovers pages from nav links + common path variants + sitemap content pages.
+ * All fetched pages are appended to siteData.blogSample so existing
+ * getCombinedHtml() and criteria checks pick them up automatically.
+ *
+ * Mutates siteData in place and returns the count of new pages added.
+ */
+declare function fetchMultiPageData(siteData: SiteData, options?: MultiPageOptions): Promise<number>;
+
+/**
+ * SPA detection and headless Chromium rendering for pre-crawl.
+ *
+ * When a site returns a thin JS-only shell (e.g. React CRA, Vite SPA),
+ * the regular fetch() gets almost no text content, causing false low scores.
+ * This module detects those shells and re-renders them with Puppeteer.
+ */
+
+type RenderingMethod = 'server' | 'client-spa';
+interface RenderingClassification {
+    method: RenderingMethod;
+    framework: string | null;
+}
+/**
+ * Detect whether raw HTML is a thin SPA shell that needs client-side rendering.
+ * Both conditions required:
+ * 1. Visible text content < 500 chars (thin page)
+ * 2. At least one SPA framework indicator present
+ */
+declare function isSpaShell(html: string): boolean;
+/**
+ * Classify a page's rendering method from its raw (non-headless) HTML.
+ * Returns the method ('server' | 'client-spa') and detected framework if any.
+ */
+declare function classifyRendering(html: string): RenderingClassification;
+interface HeadlessOptions {
+    timeout?: number;
+}
+/**
+ * Render a URL with headless Chromium and return the fully-rendered HTML.
+ * Returns null if Puppeteer is not installed or any error occurs.
+ * The caller should fall back to the raw HTML in that case.
+ */
+declare function fetchWithHeadless(url: string, options?: HeadlessOptions): Promise<FetchResult | null>;
+
+/**
+ * Parked domain detection.
+ * Vendored from @aeo/queue/redirect-check (pure functions, no network).
+ */
+interface ParkedDomainResult {
+    isParked: boolean;
+    reason?: string;
+}
+/**
+ * Detect if a page is a parked/lost/for-sale domain.
+ * Pure function - no network calls.
+ */
+declare function detectParkedDomain(bodySnippet: string): ParkedDomainResult;
+
+export { type AuditData, type AuditFinding, type AuditOptions, type AuditResult, type AuditStatus, CRITERION_LABELS, type CriterionDetail, type CriterionResult, type Deliverable, type DetailedFinding, type FetchResult, type FindingSeverity, type FindingType, type HeadlessOptions, type ImpactLevel, type PageCategory$1 as PageCategory, type PageIssue$1 as PageIssue, type PageReview$1 as PageReview, type ParkedDomainResult, type PitchMetric, type Priority, type RawDataSummary, type RenderingMethod, type ScoreCardItem, type Severity, type SiteData, type Status, analyzeAllPages, analyzePage, audit, auditSiteFromData, buildDetailedFindings, buildScorecard, calculateOverallScore, classifyRendering, detectParkedDomain, extractContentPagesFromSitemap, extractNavLinks, extractRawDataSummary, fetchMultiPageData, fetchWithHeadless, generateBottomLine, generateOpportunities, generatePitchNumbers, generateVerdict, isSpaShell, prefetchSiteData, scoreToStatus };

package/dist/index.d.ts

@@ -0,0 +1,334 @@
+/**
+ * AEORank type definitions.
+ * Inlined from @aeo/shared to keep the package zero-dependency.
+ */
+type Status = 'MISSING' | 'NEARLY EMPTY' | 'POOR' | 'WEAK' | 'PARTIAL' | 'MODERATE' | 'GOOD' | 'STRONG';
+type Severity = 'WORKING' | 'GOOD' | 'GOOD PATTERN' | 'PARTIAL' | 'MISSING' | 'ADD' | 'FIX' | 'FIX IMMEDIATELY' | 'REWRITE' | 'CONFUSING' | 'INCONSISTENT' | 'SPARSE' | 'PERFORMANCE' | 'CLUTTER' | 'PLATFORM LIMIT' | 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'BIG OPPORTUNITY' | 'AEO GOLDMINE' | 'AEO CORE' | 'CORE AEO' | 'AEO deliverable' | 'QUICK WIN' | 'MEASUREMENT';
+type FindingType = 'Test' | 'Good' | 'Bad' | 'Missing' | 'Critical' | 'Issue' | 'Fix' | 'Exists' | 'Calc' | 'Present' | 'Note' | 'Current' | 'Volume' | 'Bonus' | 'Impact';
+type ImpactLevel = 'QUICK WIN' | 'CRITICAL' | 'HIGH' | 'CORE AEO' | 'MEDIUM' | 'LOW' | 'MEASUREMENT' | 'BIG OPPORTUNITY';
+interface ScoreCardItem {
+    id: number;
+    criterion: string;
+    score: number;
+    status: Status;
+    keyFindings: string;
+}
+interface DetailedFinding {
+    type: FindingType;
+    description: string;
+    severity: Severity;
+}
+interface CriterionDetail {
+    id: number;
+    name: string;
+    findings: DetailedFinding[];
+}
+interface Deliverable {
+    id: number;
+    name: string;
+    description: string;
+    effort: string;
+    impact: ImpactLevel;
+}
+interface PitchMetric {
+    metric: string;
+    value: string;
+    significance: string;
+}
+type PageCategory$1 = 'homepage' | 'blog' | 'about' | 'pricing' | 'services' | 'contact' | 'team' | 'resources' | 'docs' | 'cases' | 'content';
+interface PageIssue$1 {
+    check: string;
+    label: string;
+    severity: 'error' | 'warning' | 'info';
+}
+interface PageReview$1 {
+    url: string;
+    title: string;
+    category: PageCategory$1;
+    wordCount: number;
+    issues: PageIssue$1[];
+    strengths: PageIssue$1[];
+}
+interface AuditData {
+    site: string;
+    auditDate: string;
+    auditor: string;
+    engine?: string;
+    overallScore: number;
+    verdict: string;
+    scorecard: ScoreCardItem[];
+    detailedFindings: CriterionDetail[];
+    opportunities: Deliverable[];
+    pitchNumbers: PitchMetric[];
+    bottomLine: string;
+    pagesReviewed?: PageReview$1[];
+}
+type AuditStatus = 'pass' | 'fail' | 'partial' | 'not_found';
+type Priority = 'P0' | 'P1' | 'P2' | 'P3';
+type FindingSeverity = 'critical' | 'high' | 'medium' | 'low' | 'info';
+interface AuditFinding {
+    severity: FindingSeverity;
+    detail: string;
+    fix?: string;
+}
+
+/**
+ * Programmatic audit API.
+ * Runs the full 7-phase AEO audit pipeline and returns structured results.
+ */
+
+interface AuditOptions {
+    /** Skip Puppeteer SPA rendering (default: false) */
+    noHeadless?: boolean;
+    /** Homepage + blog only, skip extra page discovery (default: false) */
+    noMultiPage?: boolean;
+    /** Fetch timeout in ms (default: 15000) */
+    timeout?: number;
+}
+interface AuditResult extends AuditData {
+    /** True if headless browser was used for SPA rendering */
+    renderedWithHeadless?: boolean;
+    /** Wall-clock seconds */
+    elapsed: number;
+}
+/**
+ * Run a complete AEO audit on a domain.
+ *
+ * @example
+ * ```ts
+ * import { audit } from 'aeorank';
+ * const result = await audit('example.com');
+ * console.log(result.overallScore); // 0-100
+ * ```
+ */
+declare function audit(domain: string, options?: AuditOptions): Promise<AuditResult>;
+
+interface CriterionResult {
+    criterion: string;
+    criterion_label: string;
+    score: number;
+    status: AuditStatus;
+    findings: AuditFinding[];
+    fix_priority: Priority;
+}
+type PageCategory = 'homepage' | 'blog' | 'about' | 'pricing' | 'services' | 'contact' | 'team' | 'resources' | 'docs' | 'cases' | 'content';
+interface FetchResult {
+    text: string;
+    status: number;
+    finalUrl?: string;
+    category?: PageCategory;
+}
+interface SiteData {
+    domain: string;
+    protocol: 'https' | 'http' | null;
+    homepage: FetchResult | null;
+    llmsTxt: FetchResult | null;
+    robotsTxt: FetchResult | null;
+    faqPage: FetchResult | null;
+    sitemapXml: FetchResult | null;
+    rssFeed: FetchResult | null;
+    aiTxt: FetchResult | null;
+    /** Set when homepage redirects to a different (non-brand) domain */
+    redirectedTo: string | null;
+    /** Set when homepage is a parked/for-sale/lost domain */
+    parkedReason: string | null;
+    /** Sampled blog/content pages from sitemap (up to 5) */
+    blogSample?: FetchResult[];
+}
+interface RawDataSummary {
+    domain: string;
+    protocol: 'https' | 'http' | null;
+    homepage_length: number;
+    homepage_text_length: number;
+    has_https: boolean;
+    llms_txt_status: number | null;
+    llms_txt_length: number;
+    robots_txt_status: number | null;
+    robots_txt_snippet: string;
+    robots_txt_ai_crawlers: string[];
+    robots_txt_blocked_crawlers: string[];
+    schema_types_found: string[];
+    schema_block_count: number;
+    faq_page_status: number | null;
+    faq_page_length: number;
+    sitemap_status: number | null;
+    internal_link_count: number;
+    external_link_count: number;
+    question_headings_count: number;
+    h1_count: number;
+    has_meta_description: boolean;
+    has_title: boolean;
+    has_phone: boolean;
+    has_address: boolean;
+    has_org_schema: boolean;
+    has_social_links: boolean;
+    semantic_elements_found: string[];
+    img_count: number;
+    img_with_alt_count: number;
+    has_lang_attr: boolean;
+    has_aria: boolean;
+    has_breadcrumbs: boolean;
+    has_nav: boolean;
+    has_footer: boolean;
+    has_case_studies: boolean;
+    has_statistics: boolean;
+    has_expert_attribution: boolean;
+    has_blog_section: boolean;
+    has_date_modified_schema: boolean;
+    time_element_count: number;
+    sitemap_url_count: number;
+    has_rss_feed: boolean;
+    table_count: number;
+    ordered_list_count: number;
+    unordered_list_count: number;
+    definition_pattern_count: number;
+    has_ai_txt: boolean;
+    has_person_schema: boolean;
+    fact_data_point_count: number;
+    has_canonical: boolean;
+    has_license_schema: boolean;
+    sitemap_recent_lastmod_count: number;
+    rendered_with_headless?: boolean;
+    has_speakable_schema: boolean;
+    speakable_selector_count: number;
+    blog_sample_count: number;
+    blog_sample_urls: string[];
+    blog_sample_schema_types: string[];
+    blog_sample_question_headings: number;
+    blog_sample_faq_schema_found: boolean;
+}
+/**
+ * Fetches all site data in parallel with HTTPS/HTTP fallback.
+ * Single entry point for all HTTP requests - no redundant fetches.
+ */
+declare function prefetchSiteData(domain: string): Promise<SiteData>;
+declare function extractRawDataSummary(data: SiteData): RawDataSummary;
+/**
+ * Run all 23 criteria checks using pre-fetched site data.
+ * All functions are synchronous (no HTTP calls) - data was already fetched.
+ */
+declare function auditSiteFromData(data: SiteData): CriterionResult[];
+
+declare function calculateOverallScore(criteria: CriterionResult[]): number;
+
+/**
+ * Shared scorecard building functions.
+ * Extracted from cli/pre-crawl.ts for reuse in instant-audit and other consumers.
+ */
+
+declare const CRITERION_LABELS: Record<string, string>;
+declare function scoreToStatus(score: number): Status;
+declare function buildScorecard(results: CriterionResult[]): ScoreCardItem[];
+declare function buildDetailedFindings(results: CriterionResult[]): CriterionDetail[];
+
+/**
+ * Deterministic narrative generation from scorecard data.
+ * Produces verdict, opportunities, pitchNumbers, and bottomLine
+ * without any LLM calls - pure template-based generation.
+ */
+
+declare function generateVerdict(score: number, scorecard: ScoreCardItem[], rawData: RawDataSummary, domain: string): string;
+declare function generateOpportunities(scorecard: ScoreCardItem[], criterionResults: CriterionResult[]): Deliverable[];
+declare function generatePitchNumbers(score: number, rawData: RawDataSummary, scorecard: ScoreCardItem[]): PitchMetric[];
+declare function generateBottomLine(score: number, opportunities: Deliverable[], scorecard: ScoreCardItem[], domain: string): string;
+
+/**
+ * Per-page analysis for instant audit.
+ * Runs 12 deterministic checks on each crawled page (no LLM).
+ */
+
+interface PageIssue {
+    check: string;
+    label: string;
+    severity: 'error' | 'warning' | 'info';
+}
+interface PageReview {
+    url: string;
+    title: string;
+    category: PageCategory;
+    wordCount: number;
+    issues: PageIssue[];
+    strengths: PageIssue[];
+}
+declare function analyzePage(html: string, url: string, category: PageCategory): PageReview;
+declare function analyzeAllPages(siteData: SiteData): PageReview[];
+
+/**
+ * Extended page discovery for instant audit.
+ * Fetches additional pages beyond what prefetchSiteData provides,
+ * including nav-linked pages, common paths, and content pages from sitemap.
+ */
+
+/**
+ * Extract internal page paths from <nav> elements in homepage HTML.
+ * Returns deduplicated absolute paths (e.g. ['/about', '/pricing']).
+ */
+declare function extractNavLinks(html: string, domain: string): string[];
+/**
+ * Extract non-blog deep content pages from sitemap XML.
+ * Targets service pages, product pages, etc. (not blog/article posts).
+ */
+declare function extractContentPagesFromSitemap(sitemapText: string, domain: string, limit?: number): string[];
+interface MultiPageOptions {
+    timeoutMs?: number;
+}
+/**
+ * Fetch additional pages beyond what prefetchSiteData provides.
+ * Discovers pages from nav links + common path variants + sitemap content pages.
+ * All fetched pages are appended to siteData.blogSample so existing
+ * getCombinedHtml() and criteria checks pick them up automatically.
+ *
+ * Mutates siteData in place and returns the count of new pages added.
+ */
+declare function fetchMultiPageData(siteData: SiteData, options?: MultiPageOptions): Promise<number>;
+
+/**
+ * SPA detection and headless Chromium rendering for pre-crawl.
+ *
+ * When a site returns a thin JS-only shell (e.g. React CRA, Vite SPA),
+ * the regular fetch() gets almost no text content, causing false low scores.
+ * This module detects those shells and re-renders them with Puppeteer.
+ */
+
+type RenderingMethod = 'server' | 'client-spa';
+interface RenderingClassification {
+    method: RenderingMethod;
+    framework: string | null;
+}
+/**
+ * Detect whether raw HTML is a thin SPA shell that needs client-side rendering.
+ * Both conditions required:
+ * 1. Visible text content < 500 chars (thin page)
+ * 2. At least one SPA framework indicator present
+ */
+declare function isSpaShell(html: string): boolean;
+/**
+ * Classify a page's rendering method from its raw (non-headless) HTML.
+ * Returns the method ('server' | 'client-spa') and detected framework if any.
+ */
+declare function classifyRendering(html: string): RenderingClassification;
+interface HeadlessOptions {
+    timeout?: number;
+}
+/**
+ * Render a URL with headless Chromium and return the fully-rendered HTML.
+ * Returns null if Puppeteer is not installed or any error occurs.
+ * The caller should fall back to the raw HTML in that case.
+ */
+declare function fetchWithHeadless(url: string, options?: HeadlessOptions): Promise<FetchResult | null>;
+
+/**
+ * Parked domain detection.
+ * Vendored from @aeo/queue/redirect-check (pure functions, no network).
+ */
+interface ParkedDomainResult {
+    isParked: boolean;
+    reason?: string;
+}
+/**
+ * Detect if a page is a parked/lost/for-sale domain.
+ * Pure function - no network calls.
+ */
+declare function detectParkedDomain(bodySnippet: string): ParkedDomainResult;
+
+export { type AuditData, type AuditFinding, type AuditOptions, type AuditResult, type AuditStatus, CRITERION_LABELS, type CriterionDetail, type CriterionResult, type Deliverable, type DetailedFinding, type FetchResult, type FindingSeverity, type FindingType, type HeadlessOptions, type ImpactLevel, type PageCategory$1 as PageCategory, type PageIssue$1 as PageIssue, type PageReview$1 as PageReview, type ParkedDomainResult, type PitchMetric, type Priority, type RawDataSummary, type RenderingMethod, type ScoreCardItem, type Severity, type SiteData, type Status, analyzeAllPages, analyzePage, audit, auditSiteFromData, buildDetailedFindings, buildScorecard, calculateOverallScore, classifyRendering, detectParkedDomain, extractContentPagesFromSitemap, extractNavLinks, extractRawDataSummary, fetchMultiPageData, fetchWithHeadless, generateBottomLine, generateOpportunities, generatePitchNumbers, generateVerdict, isSpaShell, prefetchSiteData, scoreToStatus };