recker 1.0.43 → 1.0.44

package/dist/browser/seo/rules/types.d.ts

@@ -0,0 +1,498 @@
+import type { SeoStatus } from '../types.js';
+import type { ExtractedLink } from '../../scrape/types.js';
+export type RuleSeverity = 'error' | 'warning' | 'info';
+export type RuleCategory = 'title' | 'meta' | 'og' | 'twitter' | 'headings' | 'images' | 'links' | 'content' | 'technical' | 'security' | 'mobile' | 'structured-data' | 'performance' | 'accessibility' | 'ai-search' | 'resources' | 'crawlability' | 'canonicalization';
+export interface RuleContext {
+    keywordsInTitle?: boolean;
+    keywordsInDescription?: boolean;
+    keywordsInH1?: boolean;
+    keywordsInUrl?: boolean;
+    keywordsInFirstParagraph?: boolean;
+    keywordsInAltText?: boolean;
+    keywordConsistencyScore?: number;
+    keywordConsistencyDetails?: {
+        inTitle: boolean;
+        inDescription: boolean;
+        inH1: boolean;
+        inUrl: boolean;
+        inFirstParagraph: boolean;
+        inAltText: boolean;
+    };
+    topKeywords?: string[];
+    mainKeyword?: string;
+    title?: string;
+    titleLength?: number;
+    metaDescription?: string;
+    metaDescriptionLength?: number;
+    metaKeywords?: string[];
+    metaRobots?: string[];
+    ogTitle?: string;
+    ogDescription?: string;
+    ogImage?: string;
+    ogUrl?: string;
+    ogType?: string;
+    ogSiteName?: string;
+    twitterCard?: string;
+    twitterTitle?: string;
+    twitterDescription?: string;
+    twitterImage?: string;
+    twitterSite?: string;
+    h1Count?: number;
+    h1Text?: string;
+    h1Length?: number;
+    h2Count?: number;
+    headingHierarchyValid?: boolean;
+    headingSkippedLevels?: string[];
+    sectionWordCounts?: number[];
+    totalImages?: number;
+    imagesWithAlt?: number;
+    imagesWithoutAlt?: number;
+    imagesWithLazyLoad?: number;
+    imagesWithDimensions?: number;
+    imagesMissingDimensions?: number;
+    imagesWithEmptyAlt?: number;
+    imagesWithSrcset?: number;
+    largeBase64ImagesCount?: number;
+    imagesDecorativeCount?: number;
+    imagesUsingModernFormats?: number;
+    altTextLengths?: number[];
+    imageAltTexts?: string[];
+    imageFilenames?: string[];
+    imagesWithAsyncDecoding?: number;
+    brokenExternalImages?: number;
+    brokenExternalImageUrls?: string[];
+    buttonsWithoutAriaLabel?: number;
+    linksWithoutAriaLabel?: number;
+    inputsWithoutLabel?: number;
+    formsWithoutAction?: number;
+    tablesWithoutCaption?: number;
+    iframesWithoutTitle?: number;
+    svgsWithoutTitle?: number;
+    interactiveElementsCount?: number;
+    ariaLabelledByMissing?: number;
+    elementsWithHighTabindex?: number;
+    invalidAriaAttributes?: number;
+    invalidAriaValues?: number;
+    invalidAriaRoles?: number;
+    missingRequiredAriaAttrs?: number;
+    hasAriaHiddenBody?: boolean;
+    ariaHiddenFocusableCount?: number;
+    deprecatedAriaRoles?: number;
+    duplicateAriaIds?: number;
+    dialogsWithoutName?: number;
+    hasSkipLink?: boolean;
+    videosWithCaptions?: number;
+    videosWithoutCaptions?: number;
+    invalidListStructure?: number;
+    emptyHeadings?: number;
+    imagesWithRedundantAlt?: number;
+    allLinks?: ExtractedLink[];
+    totalLinks?: number;
+    internalLinks?: number;
+    externalLinks?: number;
+    internalHttpLinks?: number;
+    internalHttpLinkUrls?: string[];
+    linksWithoutText?: number;
+    nofollowLinks?: number;
+    sponsoredLinks?: number;
+    ugcLinks?: number;
+    brokenLinks?: number;
+    linksWithGenericText?: number;
+    externalLinksWithoutNoopener?: number;
+    externalLinksWithoutNoreferrer?: number;
+    linksToResources?: number;
+    resourceLinkUrls?: string[];
+    forbidden403Links?: number;
+    forbidden403LinkUrls?: string[];
+    problematicLinks?: {
+        withoutText?: ExtractedLink[];
+        genericText?: ExtractedLink[];
+        missingNoopener?: ExtractedLink[];
+        missingNoreferrer?: ExtractedLink[];
+    };
+    wordCount?: number;
+    emailsFound?: string[];
+    socialLinksFound?: string[];
+    characterCount?: number;
+    sentenceCount?: number;
+    paragraphCount?: number;
+    avgWordsPerSentence?: number;
+    avgParagraphLength?: number;
+    listCount?: number;
+    strongTagCount?: number;
+    emTagCount?: number;
+    subheadingFrequency?: number;
+    paragraphWordCounts?: number[];
+    avgSentenceLength?: number;
+    faqCount?: number;
+    imagePerWordRatio?: number;
+    keywordDensity?: number;
+    fleschReadingEase?: number;
+    hasQuestionHeadings?: boolean;
+    hasHeader?: boolean;
+    hasNav?: boolean;
+    hasMain?: boolean;
+    hasArticle?: boolean;
+    hasSection?: boolean;
+    hasFooter?: boolean;
+    hasAboutPageLink?: boolean;
+    hasContactPageLink?: boolean;
+    hasPrivacyPolicyLink?: boolean;
+    hasTermsOfServiceLink?: boolean;
+    hasBreadcrumbsHtml?: boolean;
+    hasBreadcrumbsSchema?: boolean;
+    videoCount?: number;
+    audioCount?: number;
+    hasAutoplay?: boolean;
+    hasCanonical?: boolean;
+    canonicalUrl?: string;
+    hasViewport?: boolean;
+    viewportContent?: string;
+    hasCharset?: boolean;
+    charset?: string;
+    hasLang?: boolean;
+    langValue?: string;
+    isHttps?: boolean;
+    hasMixedContent?: boolean;
+    responseHeaders?: Record<string, string | string[]>;
+    textHtmlRatio?: number;
+    hasDeprecatedPlugins?: boolean;
+    deprecatedPluginTypes?: string[];
+    deprecatedTagsCount?: number;
+    deprecatedTagsFound?: string[];
+    hasFrameTags?: boolean;
+    iframeCount?: number;
+    hasFavicon?: boolean;
+    faviconUrl?: string;
+    hasPreconnect?: boolean;
+    preconnectCount?: number;
+    hasDnsPrefetch?: boolean;
+    dnsPrefetchCount?: number;
+    hasPreload?: boolean;
+    preloadCount?: number;
+    renderBlockingResources?: number;
+    inlineScriptsCount?: number;
+    inlineStylesCount?: number;
+    lcpHints?: {
+        hasLargeImages?: boolean;
+        hasLazyLcp?: boolean;
+        hasPriorityHints?: boolean;
+    };
+    clsHints?: {
+        imagesWithoutDimensions?: number;
+        dynamicContent?: number;
+    };
+    jsonLdCount?: number;
+    jsonLdTypes?: string[];
+    url?: string;
+    urlLength?: number;
+    hreflangTags?: Array<{
+        lang: string;
+        href: string;
+    }>;
+    ogLocale?: string;
+    alternateLanguages?: string[];
+    detectedLanguage?: string;
+    titleMatchesH1?: boolean;
+    urlHasUppercase?: boolean;
+    urlHasSpecialChars?: boolean;
+    urlHasAccents?: boolean;
+    bodyTextLength?: number;
+    scriptCount?: number;
+    hasNoscriptContent?: boolean;
+    timings?: {
+        ttfb?: number;
+        dnsLookup?: number;
+        tcpConnect?: number;
+        tlsHandshake?: number;
+        download?: number;
+        total?: number;
+    };
+    responseSize?: number;
+    htmlSize?: number;
+    compressedSize?: number;
+    isCompressed?: boolean;
+    isProductPage?: boolean;
+    productSchema?: {
+        name?: string;
+        image?: string | string[];
+        offers?: {
+            price?: number | string;
+            lowPrice?: number | string;
+            priceCurrency?: string;
+            availability?: string;
+            priceValidUntil?: string;
+            validFrom?: string;
+            validThrough?: string;
+        };
+        aggregateRating?: {
+            ratingValue?: number | string;
+            reviewCount?: number;
+            ratingCount?: number;
+        };
+        review?: unknown;
+        brand?: string | {
+            name?: string;
+        };
+        sku?: string;
+        gtin?: string;
+        gtin13?: string;
+        gtin14?: string;
+        gtin8?: string;
+        mpn?: string;
+    };
+    hasLocalBusinessSignals?: boolean;
+    localBusinessSchema?: {
+        '@type'?: string;
+        name?: string;
+        address?: {
+            streetAddress?: string;
+            addressLocality?: string;
+            addressRegion?: string;
+            postalCode?: string;
+            addressCountry?: string;
+        };
+        telephone?: string;
+        openingHoursSpecification?: unknown;
+        openingHours?: string | string[];
+        geo?: {
+            latitude?: number | string;
+            longitude?: number | string;
+        };
+        areaServed?: unknown;
+        priceRange?: string;
+    };
+    hasPhoneOnPage?: boolean;
+    hasAddressOnPage?: boolean;
+    lcpCandidate?: {
+        element?: string;
+        src?: string;
+        loading?: string;
+        fetchpriority?: string;
+    };
+    hasLcpPreload?: boolean;
+    webFonts?: Array<{
+        family?: string;
+        hasSwap?: boolean;
+        hasOptional?: boolean;
+        hasSizeAdjust?: boolean;
+        hasAscentOverride?: boolean;
+    }>;
+    renderBlockingStylesheets?: number;
+    renderBlockingScripts?: number;
+    hasAspectRatioCss?: boolean;
+    hasResponsiveImages?: boolean;
+    hasAdsWithoutReservedSpace?: boolean;
+    hasBannersWithoutMinHeight?: boolean;
+    hasInfiniteScroll?: boolean;
+    largeInlineScripts?: number;
+    inlineEventHandlers?: number;
+    hasHeavyAnimations?: boolean;
+    externalOrigins?: number;
+    hasCriticalResources?: boolean;
+    hasInlineCriticalCss?: boolean;
+    hasSitemapLink?: boolean;
+    sitemapUrl?: string;
+    robotsHasSitemap?: boolean;
+    robotsTxtExists?: boolean;
+    robotsTxtHasSitemap?: boolean;
+    isPaginatedPage?: boolean;
+    hasRelPrev?: boolean;
+    hasRelNext?: boolean;
+    blockedResources?: number;
+    blockedResourceUrls?: string[];
+    blockedExternalResources?: number;
+    blockedExternalResourceUrls?: string[];
+    xRobotsTag?: string;
+    hasDoctype?: boolean;
+    httpStatusCode?: number;
+    uncrawlableLinksCount?: number;
+    robotsTxtValid?: boolean;
+    robotsTxtError?: string;
+    structuredDataErrors?: number;
+    isIndexable?: boolean;
+    httpRedirectsToHttps?: boolean;
+    sniSupported?: boolean;
+    sitemapHttpUrls?: number;
+    sitemapHttpUrlsList?: string[];
+    hasHsts?: boolean;
+    passiveVoicePercentage?: number;
+    transitionWordPercentage?: number;
+    consecutiveSentenceStarts?: number;
+    complexWordPercentage?: number;
+    hasManifest?: boolean;
+    manifestUrl?: string;
+    themeColor?: string;
+    hasAppleTouchIcon?: boolean;
+    hasAppleMobileWebAppCapable?: boolean;
+    appleStatusBarStyle?: string;
+    hasMaskableIcon?: boolean;
+    manifestStartUrl?: string;
+    manifestDisplay?: string;
+    manifestScope?: string;
+    manifestIconSizes?: number[];
+    manifestShortName?: string;
+    manifestName?: string;
+    manifestBackgroundColor?: string;
+    ogImageDimensions?: {
+        width: number;
+        height: number;
+    };
+    ogLocaleAlternate?: string[];
+    ogArticleTags?: string[];
+    ogArticlePublishedTime?: string;
+    ogArticleAuthor?: string;
+    twitterCreator?: string;
+    twitterImageAlt?: string;
+    linkedinAuthor?: string;
+    pinterestRichPinSupport?: boolean;
+    hasPinterestNopin?: boolean;
+    fbAppId?: string;
+    totalSocialLinks?: number;
+    socialLinksInHeader?: number;
+    socialLinksInFooter?: number;
+    socialLinksWithoutAccessibility?: number;
+    socialLinksWithoutNewTab?: number;
+    socialLinksWithoutNoopener?: number;
+    platformsFound?: string[];
+    socialLinkDetails?: Array<{
+        href: string;
+        platform: string;
+        hasAccessibility: boolean;
+        hasNewTab: boolean;
+        hasNoopener: boolean;
+        location: 'header' | 'footer' | 'body';
+    }>;
+    navLinkCount?: number;
+    footerLinkCount?: number;
+    contextualLinkCount?: number;
+    incomingInternalLinks?: number;
+    selfReferencingLinks?: number;
+    brokenInternalLinks?: string[];
+    brokenExternalLinks?: string[];
+    redirectChainLinks?: Array<{
+        from: string;
+        to: string;
+        hops: number;
+    }>;
+    pageClickDepth?: number;
+    clickDepth?: number;
+    isStartPage?: boolean;
+    nofollowInternalLinks?: number;
+    llmsTxt?: {
+        exists: boolean;
+        valid: boolean;
+        issues?: Array<{
+            message: string;
+        }>;
+        parseResult?: {
+            siteName?: string;
+            siteDescription?: string;
+            sections: Array<{
+                title: string;
+            }>;
+            links: Array<{
+                text: string;
+                url: string;
+            }>;
+        };
+    };
+    robotsTxt?: {
+        parseResult?: {
+            userAgentBlocks: Array<{
+                userAgents: string[];
+                rules: Array<{
+                    type: string;
+                    path: string;
+                }>;
+            }>;
+        };
+    };
+    headings?: {
+        structure: Array<{
+            level: number;
+            text: string;
+        }>;
+        h1Count?: number;
+        hasProperHierarchy?: boolean;
+    };
+    lastModified?: string;
+    semanticHtmlRatio?: number;
+    jsFilesCount?: number;
+    jsTotalSize?: number;
+    renderBlockingJs?: number;
+    cssFilesCount?: number;
+    cssTotalSize?: number;
+    hasCriticalCss?: boolean;
+    largeImages?: string[];
+    imagesTotal?: number;
+    modernFormatImages?: number;
+    fontFilesCount?: number;
+    hasFontDisplaySwap?: boolean;
+    totalRequests?: number;
+    totalPageSize?: number;
+    uncompressedResources?: number;
+    resourcesWithoutCaching?: number;
+    brokenExternalResources?: number;
+    brokenExternalResourceUrls?: string[];
+    unminifiedResources?: number;
+    unminifiedResourceUrls?: string[];
+    sslCertificate?: {
+        valid: boolean;
+        error?: string;
+        expiryDate?: string;
+        nameMismatch?: boolean;
+        commonName?: string;
+        expectedDomain?: string;
+        issuer?: string;
+        selfSigned?: boolean;
+    };
+    tlsVersion?: string;
+    hasPasswordField?: boolean;
+    formsOnHttp?: number;
+    analyticsDetected?: boolean;
+    analyticsProviders?: string[];
+    hasRssFeed?: boolean;
+    rssFeedUrl?: string;
+    hasAtomFeed?: boolean;
+    atomFeedUrl?: string;
+    ctaButtonsCount?: number;
+    formCount?: number;
+    hasWhatsAppLink?: boolean;
+    pageInSitemap?: boolean;
+}
+export interface RuleEvidence {
+    found?: string | number | string[];
+    expected?: string | number | string[];
+    location?: string;
+    issue?: string;
+    impact?: string;
+    example?: string;
+    learnMore?: string;
+}
+export interface RuleResult {
+    id: string;
+    name: string;
+    category: RuleCategory;
+    severity: RuleSeverity;
+    status: SeoStatus;
+    message: string;
+    value?: string | number;
+    recommendation?: string;
+    evidence?: RuleEvidence;
+    details?: Record<string, unknown>;
+}
+export interface SeoRule {
+    id: string;
+    name: string;
+    category: RuleCategory;
+    severity: RuleSeverity;
+    description: string;
+    check: (ctx: RuleContext) => RuleResult | null;
+}
+export declare function createResult(rule: Pick<SeoRule, 'id' | 'name' | 'category' | 'severity'>, status: SeoStatus, message: string, options?: {
+    value?: string | number;
+    recommendation?: string;
+    evidence?: RuleEvidence;
+    details?: Record<string, unknown>;
+}): RuleResult;

package/dist/browser/seo/rules/types.js

@@ -0,0 +1,11 @@
+export function createResult(rule, status, message, options) {
+    return {
+        id: rule.id,
+        name: rule.name,
+        category: rule.category,
+        severity: rule.severity,
+        status,
+        message,
+        ...options,
+    };
+}

package/dist/browser/seo/types.d.ts

@@ -0,0 +1,211 @@
+import { KeywordCloud } from './keywords.js';
+export type { KeywordCloud, KeywordItem } from './keywords.js';
+export type SeoStatus = 'pass' | 'warn' | 'fail' | 'info';
+export interface SeoCheckEvidence {
+    found?: string | number | string[];
+    expected?: string | number | string[];
+    location?: string;
+    issue?: string;
+    impact?: string;
+    example?: string;
+    learnMore?: string;
+}
+export interface SeoCheckResult {
+    name: string;
+    category: string;
+    status: SeoStatus;
+    message: string;
+    value?: string | number;
+    recommendation?: string;
+    evidence?: SeoCheckEvidence;
+}
+export interface HeadingInfo {
+    level: number;
+    text: string;
+    count: number;
+}
+export interface HeadingAnalysis {
+    structure: HeadingInfo[];
+    h1Count: number;
+    hasProperHierarchy: boolean;
+    issues: string[];
+}
+export interface ContentMetrics {
+    wordCount: number;
+    characterCount: number;
+    sentenceCount: number;
+    paragraphCount: number;
+    readingTimeMinutes: number;
+    avgWordsPerSentence: number;
+    avgParagraphLength: number;
+    listCount: number;
+    strongTagCount: number;
+    emTagCount: number;
+    fleschReadingEase?: number;
+    hasQuestionHeadings?: boolean;
+}
+export interface LinkAnalysis {
+    total: number;
+    internal: number;
+    external: number;
+    nofollow: number;
+    broken: number;
+    withoutText: number;
+    sponsoredLinks: number;
+    ugcLinks: number;
+    internalHttpLinks?: number;
+    internalHttpLinkUrls?: string[];
+}
+export interface ImageAnalysis {
+    total: number;
+    withAlt: number;
+    withoutAlt: number;
+    lazy: number;
+    missingDimensions: number;
+    modernFormats: number;
+    altTextLengths: number[];
+    imageAltTexts: string[];
+    imageFilenames: string[];
+    imagesWithAsyncDecoding: number;
+}
+export interface SocialMetaAnalysis {
+    openGraph: {
+        present: boolean;
+        hasTitle: boolean;
+        hasDescription: boolean;
+        hasImage: boolean;
+        hasUrl: boolean;
+        issues: string[];
+    };
+    twitterCard: {
+        present: boolean;
+        hasCard: boolean;
+        hasTitle: boolean;
+        hasDescription: boolean;
+        hasImage: boolean;
+        issues: string[];
+    };
+}
+export interface TechnicalSeo {
+    hasCanonical: boolean;
+    canonicalUrl?: string;
+    hasRobotsMeta: boolean;
+    robotsContent?: string[];
+    hasViewport: boolean;
+    hasCharset: boolean;
+    hasLang: boolean;
+    langValue?: string;
+}
+export interface SeoTiming {
+    ttfb?: number;
+    total?: number;
+    dns?: number;
+    tcp?: number;
+    tls?: number;
+    download?: number;
+}
+export interface SeoSummary {
+    totalChecks: number;
+    passed: number;
+    warnings: number;
+    errors: number;
+    infos: number;
+    passRate: number;
+    issuesByCategory: Record<string, {
+        passed: number;
+        warnings: number;
+        errors: number;
+    }>;
+    topIssues: Array<{
+        name: string;
+        message: string;
+        category: string;
+        severity: 'error' | 'warning';
+    }>;
+    quickWins: string[];
+    vitals: {
+        htmlSize?: number;
+        domElements?: number;
+        ttfb?: number;
+        totalTime?: number;
+        wordCount: number;
+        readingTime: number;
+        imageCount: number;
+        linkCount: number;
+    };
+    completeness: {
+        meta: number;
+        social: number;
+        technical: number;
+        content: number;
+        images: number;
+        links: number;
+    };
+}
+export interface SeoReport {
+    url: string;
+    timestamp: Date;
+    grade: string;
+    score: number;
+    summary: SeoSummary;
+    timing?: SeoTiming;
+    checks: SeoCheckResult[];
+    title?: {
+        text: string;
+        length: number;
+    };
+    metaDescription?: {
+        text: string;
+        length: number;
+    };
+    openGraph?: {
+        title?: string;
+        description?: string;
+        image?: string;
+        url?: string;
+        type?: string;
+        siteName?: string;
+    };
+    twitterCard?: {
+        card?: string;
+        title?: string;
+        description?: string;
+        image?: string;
+        site?: string;
+    };
+    structuredData: {
+        count: number;
+        types: string[];
+        items: Record<string, unknown>[];
+    };
+    content: ContentMetrics;
+    headings: HeadingAnalysis;
+    keywords: KeywordCloud;
+    links: LinkAnalysis;
+    images: ImageAnalysis;
+    social: SocialMetaAnalysis;
+    technical: TechnicalSeo;
+}
+export interface SeoAnalyzerOptions {
+    baseUrl?: string;
+    analyzeContent?: boolean;
+    checkBrokenLinks?: boolean;
+    responseHeaders?: Record<string, string | string[]>;
+}
+export interface ExtractedLink {
+    href: string;
+    text: string;
+    rel?: string;
+    target?: string;
+    title?: string;
+    type?: 'internal' | 'external' | 'anchor' | 'mailto' | 'tel';
+}
+export interface ExtractedImage {
+    src: string;
+    alt?: string;
+    title?: string;
+    width?: number;
+    height?: number;
+    srcset?: string;
+    loading?: 'lazy' | 'eager';
+}

package/dist/browser/seo/types.js

@@ -0,0 +1 @@
+export {};