npm - @rankcli/agent-runtime - Versions diffs - 0.0.14 → 0.0.16 - Mend

@rankcli/agent-runtime 0.0.14 → 0.0.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (199) hide show

package/dist/index.d.mts +77 -393
package/dist/index.d.ts +77 -393
package/dist/index.js +417 -6443
package/dist/index.mjs +296 -6313
package/package.json +6 -1
package/scripts/build-deno.ts +0 -134
package/src/analyzers/core-web-vitals-analyzer.test.ts +0 -236
package/src/analyzers/core-web-vitals-analyzer.ts +0 -557
package/src/analyzers/geo-analyzer.test.ts +0 -310
package/src/analyzers/geo-analyzer.ts +0 -814
package/src/analyzers/image-optimization-analyzer.test.ts +0 -145
package/src/analyzers/image-optimization-analyzer.ts +0 -348
package/src/analyzers/index.ts +0 -233
package/src/analyzers/internal-linking-analyzer.test.ts +0 -141
package/src/analyzers/internal-linking-analyzer.ts +0 -419
package/src/analyzers/mobile-seo-analyzer.test.ts +0 -140
package/src/analyzers/mobile-seo-analyzer.ts +0 -455
package/src/analyzers/security-headers-analyzer.test.ts +0 -115
package/src/analyzers/security-headers-analyzer.ts +0 -318
package/src/analyzers/structured-data-analyzer.test.ts +0 -210
package/src/analyzers/structured-data-analyzer.ts +0 -590
package/src/audit/ai/analyzer.ts +0 -347
package/src/audit/ai/index.ts +0 -29
package/src/audit/ai/prompts/content-analysis.ts +0 -271
package/src/audit/ai/types.ts +0 -179
package/src/audit/checks/additional-checks.ts +0 -439
package/src/audit/checks/ai-citation-worthiness.ts +0 -399
package/src/audit/checks/ai-content-structure.ts +0 -325
package/src/audit/checks/ai-readiness.ts +0 -339
package/src/audit/checks/anchor-text.ts +0 -179
package/src/audit/checks/answer-conciseness.ts +0 -322
package/src/audit/checks/asset-minification.ts +0 -270
package/src/audit/checks/bing-optimization.ts +0 -206
package/src/audit/checks/brand-mention-optimization.ts +0 -349
package/src/audit/checks/caching-headers.ts +0 -305
package/src/audit/checks/canonical-advanced.ts +0 -150
package/src/audit/checks/canonical-domain.ts +0 -196
package/src/audit/checks/citation-quality.ts +0 -358
package/src/audit/checks/client-rendering.ts +0 -542
package/src/audit/checks/color-contrast.ts +0 -342
package/src/audit/checks/content-freshness.ts +0 -170
package/src/audit/checks/content-science.ts +0 -589
package/src/audit/checks/conversion-elements.ts +0 -526
package/src/audit/checks/crawlability.ts +0 -220
package/src/audit/checks/directory-listing.ts +0 -172
package/src/audit/checks/dom-analysis.ts +0 -191
package/src/audit/checks/dom-size.ts +0 -246
package/src/audit/checks/duplicate-content.ts +0 -194
package/src/audit/checks/eeat-signals.ts +0 -990
package/src/audit/checks/entity-seo.ts +0 -396
package/src/audit/checks/featured-snippet.ts +0 -473
package/src/audit/checks/freshness-signals.ts +0 -443
package/src/audit/checks/funnel-intent.ts +0 -463
package/src/audit/checks/hreflang.ts +0 -174
package/src/audit/checks/html-compliance.ts +0 -302
package/src/audit/checks/image-dimensions.ts +0 -167
package/src/audit/checks/images.ts +0 -160
package/src/audit/checks/indexnow.ts +0 -275
package/src/audit/checks/interactive-tools.ts +0 -475
package/src/audit/checks/internal-link-graph.ts +0 -436
package/src/audit/checks/keyword-analysis.ts +0 -239
package/src/audit/checks/keyword-cannibalization.ts +0 -385
package/src/audit/checks/keyword-placement.ts +0 -471
package/src/audit/checks/links.ts +0 -273
package/src/audit/checks/llms-txt.ts +0 -224
package/src/audit/checks/local-seo.ts +0 -296
package/src/audit/checks/mobile.ts +0 -167
package/src/audit/checks/modern-images.ts +0 -226
package/src/audit/checks/navboost-signals.ts +0 -395
package/src/audit/checks/on-page.ts +0 -209
package/src/audit/checks/page-resources.ts +0 -285
package/src/audit/checks/pagination.ts +0 -180
package/src/audit/checks/performance.ts +0 -153
package/src/audit/checks/platform-presence.ts +0 -580
package/src/audit/checks/redirect-analysis.ts +0 -153
package/src/audit/checks/redirect-chain.ts +0 -389
package/src/audit/checks/resource-hints.ts +0 -420
package/src/audit/checks/responsive-css.ts +0 -247
package/src/audit/checks/responsive-images.ts +0 -396
package/src/audit/checks/review-ecosystem.ts +0 -415
package/src/audit/checks/robots-validation.ts +0 -373
package/src/audit/checks/security-headers.ts +0 -188
package/src/audit/checks/security.ts +0 -144
package/src/audit/checks/serp-preview.ts +0 -251
package/src/audit/checks/site-maturity.ts +0 -453
package/src/audit/checks/social-meta.test.ts +0 -275
package/src/audit/checks/social-meta.ts +0 -134
package/src/audit/checks/soft-404.ts +0 -151
package/src/audit/checks/structured-data.ts +0 -238
package/src/audit/checks/tech-detection.ts +0 -496
package/src/audit/checks/topical-clusters.ts +0 -435
package/src/audit/checks/tracker-bloat.ts +0 -462
package/src/audit/checks/tracking-verification.test.ts +0 -371
package/src/audit/checks/tracking-verification.ts +0 -636
package/src/audit/checks/url-safety.ts +0 -682
package/src/audit/deno-entry.ts +0 -66
package/src/audit/discovery/index.ts +0 -15
package/src/audit/discovery/link-crawler.ts +0 -233
package/src/audit/discovery/repo-routes.ts +0 -347
package/src/audit/engine.ts +0 -627
package/src/audit/fixes/index.ts +0 -209
package/src/audit/fixes/social-meta-fixes.test.ts +0 -329
package/src/audit/fixes/social-meta-fixes.ts +0 -463
package/src/audit/index.ts +0 -74
package/src/audit/runner.test.ts +0 -299
package/src/audit/runner.ts +0 -130
package/src/audit/types.ts +0 -1963
package/src/content/featured-snippet.ts +0 -367
package/src/content/generator.test.ts +0 -534
package/src/content/generator.ts +0 -501
package/src/content/headline.ts +0 -317
package/src/content/index.ts +0 -62
package/src/content/intent.ts +0 -258
package/src/content/keyword-density.ts +0 -349
package/src/content/readability.ts +0 -262
package/src/executor.ts +0 -336
package/src/fixer/framework-fixes.test.ts +0 -489
package/src/fixer/framework-fixes.ts +0 -5287
package/src/fixer/index.ts +0 -6
package/src/fixer/schemas.ts +0 -971
package/src/fixer.ts +0 -642
package/src/frameworks/detector.test.ts +0 -248
package/src/frameworks/detector.ts +0 -899
package/src/frameworks/index.ts +0 -68
package/src/frameworks/recipes/angular.yaml +0 -171
package/src/frameworks/recipes/astro.yaml +0 -206
package/src/frameworks/recipes/django.yaml +0 -180
package/src/frameworks/recipes/laravel.yaml +0 -137
package/src/frameworks/recipes/nextjs.yaml +0 -268
package/src/frameworks/recipes/nuxt.yaml +0 -175
package/src/frameworks/recipes/rails.yaml +0 -188
package/src/frameworks/recipes/react.yaml +0 -202
package/src/frameworks/recipes/sveltekit.yaml +0 -154
package/src/frameworks/recipes/vue.yaml +0 -137
package/src/frameworks/recipes/wordpress.yaml +0 -209
package/src/frameworks/suggestion-engine.ts +0 -357
package/src/geo/geo-content.test.ts +0 -305
package/src/geo/geo-content.ts +0 -266
package/src/geo/geo-history.test.ts +0 -473
package/src/geo/geo-history.ts +0 -433
package/src/geo/geo-tracker.test.ts +0 -359
package/src/geo/geo-tracker.ts +0 -411
package/src/geo/index.ts +0 -11
package/src/geo/llm-citation-checker.ts +0 -188
package/src/git/commit-helper.test.ts +0 -261
package/src/git/commit-helper.ts +0 -329
package/src/git/index.ts +0 -12
package/src/git/pr-helper.test.ts +0 -284
package/src/git/pr-helper.ts +0 -307
package/src/index.ts +0 -76
package/src/keywords/ai-keyword-engine.ts +0 -1062
package/src/keywords/ai-summarizer.ts +0 -387
package/src/keywords/ci-mode.ts +0 -555
package/src/keywords/engine.ts +0 -359
package/src/keywords/index.ts +0 -151
package/src/keywords/llm-judge.ts +0 -357
package/src/keywords/nlp-analysis.ts +0 -706
package/src/keywords/prioritizer.ts +0 -295
package/src/keywords/site-crawler.ts +0 -342
package/src/keywords/sources/autocomplete.ts +0 -139
package/src/keywords/sources/competitive-search.ts +0 -450
package/src/keywords/sources/competitor-analysis.ts +0 -374
package/src/keywords/sources/dataforseo.ts +0 -206
package/src/keywords/sources/free-sources.ts +0 -294
package/src/keywords/sources/gsc.ts +0 -123
package/src/keywords/topic-grouping.ts +0 -327
package/src/keywords/types.ts +0 -144
package/src/keywords/wizard.ts +0 -457
package/src/loader.ts +0 -40
package/src/ranking/index.ts +0 -5
package/src/ranking/serp-client.ts +0 -348
package/src/ranking/tracker.ts +0 -380
package/src/ranking/types.ts +0 -123
package/src/reports/index.ts +0 -7
package/src/reports/report-generator.test.ts +0 -293
package/src/reports/report-generator.ts +0 -713
package/src/scheduler/alerts.test.ts +0 -458
package/src/scheduler/alerts.ts +0 -328
package/src/scheduler/index.ts +0 -8
package/src/scheduler/scheduled-audit.test.ts +0 -377
package/src/scheduler/scheduled-audit.ts +0 -149
package/src/test/integration-test.ts +0 -325
package/src/tools/analyzer.ts +0 -373
package/src/tools/crawl.ts +0 -293
package/src/tools/files.ts +0 -301
package/src/tools/h1-fixer.ts +0 -249
package/src/tools/index.ts +0 -67
package/src/tracking/github-action.ts +0 -326
package/src/tracking/google-analytics.ts +0 -265
package/src/tracking/index.ts +0 -45
package/src/tracking/report-generator.ts +0 -386
package/src/tracking/search-console.ts +0 -335
package/src/types.ts +0 -148
package/src/utils/http.ts +0 -302
package/src/wasm-adapter.ts +0 -297
package/src/wasm-entry.ts +0 -14
package/tsconfig.json +0 -17
package/tsup.wasm.config.ts +0 -26
package/vitest.config.ts +0 -15

package/src/audit/checks/html-compliance.ts DELETED Viewed

@@ -1,302 +0,0 @@
-/**
- * HTML Compliance Checks
- *
- * Validates basic HTML requirements that all major SEO tools check:
- * - Doctype declaration (HTML5)
- * - Character encoding (UTF-8)
- * - Favicon presence
- * - Language attribute
- * - Viewport meta tag
- */
-import * as cheerio from 'cheerio';
-import { httpGet } from '../../utils/http.js';
-import type { AuditIssue } from '../types.js';
-export interface HtmlComplianceData {
-  doctype: {
-    present: boolean;
-    isHtml5: boolean;
-    value?: string;
-  };
-  charset: {
-    present: boolean;
-    isUtf8: boolean;
-    value?: string;
-    source: 'meta' | 'header' | 'none';
-  };
-  favicon: {
-    present: boolean;
-    locations: string[];
-    hasAppleTouchIcon: boolean;
-    formats: string[];
-  };
-  language: {
-    present: boolean;
-    value?: string;
-  };
-  viewport: {
-    present: boolean;
-    value?: string;
-    isResponsive: boolean;
-  };
-}
-export async function analyzeHtmlCompliance(
-  html: string,
-  url: string,
-  headers?: Record<string, string>
-): Promise<{ issues: AuditIssue[]; data: HtmlComplianceData }> {
-  const issues: AuditIssue[] = [];
-  const $ = cheerio.load(html);
-  const parsedUrl = new URL(url);
-  // === DOCTYPE CHECK ===
-  const doctypeMatch = html.match(/<!DOCTYPE\s+([^>]+)>/i);
-  const hasDoctype = doctypeMatch !== null;
-  const doctypeValue = doctypeMatch ? doctypeMatch[0] : undefined;
-  const isHtml5 = hasDoctype && /<!DOCTYPE\s+html\s*>/i.test(html);
-  if (!hasDoctype) {
-    issues.push({
-      code: 'HTML_NO_DOCTYPE',
-      severity: 'warning',
-      category: 'on-page',
-      title: 'Missing DOCTYPE declaration',
-      description: 'Page is missing a DOCTYPE declaration. This puts browsers in quirks mode and may cause rendering issues.',
-      impact: 'Browsers may render the page inconsistently. Search engines expect valid HTML.',
-      howToFix: 'Add <!DOCTYPE html> as the very first line of your HTML document.',
-      affectedUrls: [url],
-    });
-  } else if (!isHtml5) {
-    issues.push({
-      code: 'HTML_OLD_DOCTYPE',
-      severity: 'notice',
-      category: 'on-page',
-      title: 'Using older DOCTYPE',
-      description: `Page uses "${doctypeValue}" instead of HTML5 DOCTYPE. HTML5 is the current standard.`,
-      impact: 'Older doctypes may limit modern HTML features.',
-      howToFix: 'Change your DOCTYPE to the HTML5 declaration: <!DOCTYPE html>',
-      affectedUrls: [url],
-    });
-  }
-  // === CHARSET CHECK ===
-  let charsetPresent = false;
-  let charsetValue: string | undefined;
-  let charsetSource: 'meta' | 'header' | 'none' = 'none';
-  // Check meta charset
-  const metaCharset = $('meta[charset]').attr('charset');
-  const metaContentType = $('meta[http-equiv="Content-Type"]').attr('content');
-  if (metaCharset) {
-    charsetPresent = true;
-    charsetValue = metaCharset;
-    charsetSource = 'meta';
-  } else if (metaContentType) {
-    const charsetMatch = metaContentType.match(/charset=([^\s;]+)/i);
-    if (charsetMatch) {
-      charsetPresent = true;
-      charsetValue = charsetMatch[1];
-      charsetSource = 'meta';
-    }
-  }
-  // Check Content-Type header
-  if (!charsetPresent && headers) {
-    const contentType = headers['content-type'] || headers['Content-Type'];
-    if (contentType) {
-      const charsetMatch = contentType.match(/charset=([^\s;]+)/i);
-      if (charsetMatch) {
-        charsetPresent = true;
-        charsetValue = charsetMatch[1];
-        charsetSource = 'header';
-      }
-    }
-  }
-  const isUtf8 = charsetValue?.toLowerCase().replace('-', '') === 'utf8';
-  if (!charsetPresent) {
-    issues.push({
-      code: 'HTML_NO_CHARSET',
-      severity: 'warning',
-      category: 'on-page',
-      title: 'Missing character encoding declaration',
-      description: 'Page does not specify character encoding. This can cause text display issues.',
-      impact: 'Characters may display incorrectly. Search engines may misinterpret content.',
-      howToFix: 'Add <meta charset="UTF-8"> in the <head> section, before any other elements.',
-      affectedUrls: [url],
-    });
-  } else if (!isUtf8) {
-    issues.push({
-      code: 'HTML_NOT_UTF8',
-      severity: 'notice',
-      category: 'on-page',
-      title: 'Not using UTF-8 encoding',
-      description: `Page uses "${charsetValue}" encoding. UTF-8 is recommended for universal character support.`,
-      impact: 'Some characters may not display correctly. UTF-8 is the web standard.',
-      howToFix: 'Change your charset to UTF-8: <meta charset="UTF-8">',
-      affectedUrls: [url],
-    });
-  }
-  // === FAVICON CHECK ===
-  const faviconLocations: string[] = [];
-  const faviconFormats: string[] = [];
-  let hasAppleTouchIcon = false;
-  // Check link tags for favicon
-  $('link[rel*="icon"]').each((_, el) => {
-    const href = $(el).attr('href');
-    const rel = $(el).attr('rel') || '';
-    const type = $(el).attr('type') || '';
-    if (href) {
-      faviconLocations.push(href);
-      // Detect format
-      if (href.endsWith('.ico')) faviconFormats.push('ico');
-      else if (href.endsWith('.png')) faviconFormats.push('png');
-      else if (href.endsWith('.svg')) faviconFormats.push('svg');
-      else if (type) faviconFormats.push(type);
-    }
-    if (rel.includes('apple-touch-icon')) {
-      hasAppleTouchIcon = true;
-    }
-  });
-  // Check for Apple Touch Icon separately
-  if ($('link[rel="apple-touch-icon"], link[rel="apple-touch-icon-precomposed"]').length > 0) {
-    hasAppleTouchIcon = true;
-  }
-  const hasFavicon = faviconLocations.length > 0;
-  if (!hasFavicon) {
-    // Check if /favicon.ico exists
-    try {
-      const faviconUrl = new URL('/favicon.ico', parsedUrl.origin).href;
-      const response = await httpGet<string>(faviconUrl, {
-        timeout: 5000,
-        validateStatus: () => true,
-      });
-      if (response.status === 200) {
-        faviconLocations.push('/favicon.ico');
-        faviconFormats.push('ico');
-      }
-    } catch {
-      // Favicon check failed
-    }
-  }
-  if (faviconLocations.length === 0) {
-    issues.push({
-      code: 'HTML_NO_FAVICON',
-      severity: 'notice',
-      category: 'on-page',
-      title: 'No favicon found',
-      description: 'Page does not have a favicon defined. Favicons help with brand recognition and browser tab identification.',
-      impact: 'Missing favicon affects brand visibility in browser tabs, bookmarks, and search results.',
-      howToFix: 'Add a favicon link in <head>: <link rel="icon" href="/favicon.ico"> and consider adding multiple sizes.',
-      affectedUrls: [url],
-      details: {
-        recommendation: 'Include multiple formats: ICO for legacy browsers, PNG for modern browsers, and SVG for scalability.',
-      },
-    });
-  }
-  if (!hasAppleTouchIcon && faviconLocations.length > 0) {
-    issues.push({
-      code: 'HTML_NO_APPLE_TOUCH_ICON',
-      severity: 'notice',
-      category: 'mobile',
-      title: 'No Apple Touch Icon',
-      description: 'Page does not define an Apple Touch Icon. This icon is used when users add your site to their iOS home screen.',
-      impact: 'iOS users who bookmark your site won\'t see a proper app icon.',
-      howToFix: 'Add: <link rel="apple-touch-icon" href="/apple-touch-icon.png"> with a 180x180 PNG image.',
-      affectedUrls: [url],
-    });
-  }
-  // === LANGUAGE CHECK ===
-  const htmlLang = $('html').attr('lang');
-  const langPresent = Boolean(htmlLang);
-  if (!langPresent) {
-    issues.push({
-      code: 'HTML_NO_LANG',
-      severity: 'warning',
-      category: 'on-page',
-      title: 'Missing language attribute',
-      description: 'The <html> element does not have a lang attribute. This helps search engines and screen readers.',
-      impact: 'Search engines may not properly identify the page language. Accessibility is reduced.',
-      howToFix: 'Add lang attribute to <html>: <html lang="en"> (use appropriate language code).',
-      affectedUrls: [url],
-    });
-  }
-  // === VIEWPORT CHECK ===
-  const viewportMeta = $('meta[name="viewport"]').attr('content');
-  const hasViewport = Boolean(viewportMeta);
-  const isResponsive = viewportMeta?.includes('width=device-width') || false;
-  if (!hasViewport) {
-    issues.push({
-      code: 'HTML_NO_VIEWPORT',
-      severity: 'warning',
-      category: 'mobile',
-      title: 'Missing viewport meta tag',
-      description: 'Page does not have a viewport meta tag. This is required for proper mobile rendering.',
-      impact: 'Page will not render correctly on mobile devices. Fails mobile-friendliness test.',
-      howToFix: 'Add: <meta name="viewport" content="width=device-width, initial-scale=1">',
-      affectedUrls: [url],
-    });
-  } else if (!isResponsive) {
-    issues.push({
-      code: 'HTML_FIXED_VIEWPORT',
-      severity: 'notice',
-      category: 'mobile',
-      title: 'Viewport not responsive',
-      description: `Viewport is set to "${viewportMeta}" but doesn't include width=device-width for responsive design.`,
-      impact: 'Page may not scale properly on different screen sizes.',
-      howToFix: 'Update viewport to: <meta name="viewport" content="width=device-width, initial-scale=1">',
-      affectedUrls: [url],
-    });
-  }
-  return {
-    issues,
-    data: {
-      doctype: {
-        present: hasDoctype,
-        isHtml5,
-        value: doctypeValue,
-      },
-      charset: {
-        present: charsetPresent,
-        isUtf8,
-        value: charsetValue,
-        source: charsetSource,
-      },
-      favicon: {
-        present: faviconLocations.length > 0,
-        locations: faviconLocations,
-        hasAppleTouchIcon,
-        formats: [...new Set(faviconFormats)],
-      },
-      language: {
-        present: langPresent,
-        value: htmlLang,
-      },
-      viewport: {
-        present: hasViewport,
-        value: viewportMeta,
-        isResponsive,
-      },
-    },
-  };
-}

package/src/audit/checks/image-dimensions.ts DELETED Viewed

@@ -1,167 +0,0 @@
-/**
- * Image Dimensions Check
- *
- * Verifies that images have explicit width and height attributes.
- * This prevents Cumulative Layout Shift (CLS) - a Core Web Vital.
- *
- * When images don't have dimensions, the browser doesn't know how much
- * space to reserve, causing content to jump when images load.
- */
-import * as cheerio from 'cheerio';
-import type { AuditIssue } from '../types.js';
-export interface ImageDimensionsData {
-  totalImages: number;
-  withDimensions: number;
-  withoutDimensions: number;
-  missingDimensions: ImageInfo[];
-  aspectRatioSet: number;
-}
-interface ImageInfo {
-  src: string;
-  hasWidth: boolean;
-  hasHeight: boolean;
-  hasAspectRatio: boolean;
-  context: string;
-}
-export function analyzeImageDimensions(
-  html: string,
-  url: string
-): { issues: AuditIssue[]; data: ImageDimensionsData } {
-  const issues: AuditIssue[] = [];
-  const $ = cheerio.load(html);
-  const images = $('img');
-  const totalImages = images.length;
-  let withDimensions = 0;
-  let withoutDimensions = 0;
-  let aspectRatioSet = 0;
-  const missingDimensions: ImageInfo[] = [];
-  images.each((_, img) => {
-    const $img = $(img);
-    const src = $img.attr('src') || $img.attr('data-src') || '';
-    // Check for width attribute (HTML attribute or style)
-    const widthAttr = $img.attr('width');
-    const heightAttr = $img.attr('height');
-    const style = $img.attr('style') || '';
-    const hasWidthAttr = Boolean(widthAttr);
-    const hasHeightAttr = Boolean(heightAttr);
-    const hasStyleWidth = /width\s*:/i.test(style);
-    const hasStyleHeight = /height\s*:/i.test(style);
-    const hasAspectRatio = /aspect-ratio\s*:/i.test(style);
-    // Check CSS classes that might set dimensions
-    const className = $img.attr('class') || '';
-    // Consider dimensions set if either HTML attributes or inline styles are present
-    const hasWidth = hasWidthAttr || hasStyleWidth;
-    const hasHeight = hasHeightAttr || hasStyleHeight;
-    const hasBothDimensions = (hasWidth && hasHeight) || hasAspectRatio;
-    if (hasBothDimensions) {
-      withDimensions++;
-      if (hasAspectRatio) {
-        aspectRatioSet++;
-      }
-    } else {
-      withoutDimensions++;
-      // Only report visible images (not lazy-loaded placeholder images)
-      if (src && !src.includes('data:image/') && !src.includes('placeholder')) {
-        // Get context (parent element for identification)
-        const parent = $img.parent();
-        const parentTag = parent.length > 0 ? (parent[0] as any).name || '' : '';
-        const parentClass = parent.attr('class')?.split(' ')[0] || '';
-        const context = parentClass ? `${parentTag}.${parentClass}` : parentTag;
-        missingDimensions.push({
-          src: truncateSrc(src),
-          hasWidth,
-          hasHeight,
-          hasAspectRatio,
-          context,
-        });
-      }
-    }
-  });
-  // Generate issues
-  if (withoutDimensions > 0) {
-    // Calculate percentage
-    const percentage = Math.round((withoutDimensions / totalImages) * 100);
-    if (percentage > 50) {
-      issues.push({
-        code: 'IMAGES_MANY_MISSING_DIMENSIONS',
-        severity: 'warning',
-        category: 'performance',
-        title: 'Most images missing explicit dimensions',
-        description: `${withoutDimensions} of ${totalImages} images (${percentage}%) don't have width and height attributes. This causes layout shifts.`,
-        impact: 'High Cumulative Layout Shift (CLS). Content jumps around as images load, frustrating users.',
-        howToFix: 'Add width and height attributes to all <img> tags. Use CSS aspect-ratio for responsive images. Example: <img src="..." width="800" height="600">',
-        affectedUrls: [url],
-        details: {
-          totalImages,
-          withDimensions,
-          withoutDimensions,
-          examples: missingDimensions.slice(0, 5),
-        },
-      });
-    } else if (withoutDimensions > 0) {
-      issues.push({
-        code: 'IMAGES_MISSING_DIMENSIONS',
-        severity: 'notice',
-        category: 'performance',
-        title: 'Some images missing explicit dimensions',
-        description: `${withoutDimensions} of ${totalImages} image(s) don't have width and height attributes.`,
-        impact: 'May cause layout shifts when images load, affecting CLS score.',
-        howToFix: 'Add width and height attributes: <img src="..." width="800" height="600">. For responsive images, also use CSS: img { max-width: 100%; height: auto; }',
-        affectedUrls: [url],
-        details: {
-          images: missingDimensions.slice(0, 10),
-        },
-      });
-    }
-  }
-  // Check for aspect-ratio usage (modern approach)
-  if (withDimensions > 0 && aspectRatioSet === 0) {
-    issues.push({
-      code: 'IMAGES_NO_ASPECT_RATIO',
-      severity: 'notice',
-      category: 'performance',
-      title: 'Consider using CSS aspect-ratio for images',
-      description: 'Images have width/height but no CSS aspect-ratio. The aspect-ratio property provides better responsive behavior.',
-      impact: 'Minor - existing dimensions prevent CLS, but aspect-ratio offers better control.',
-      howToFix: 'Add CSS aspect-ratio for responsive images: img { aspect-ratio: 16/9; width: 100%; height: auto; }',
-      affectedUrls: [url],
-    });
-  }
-  return {
-    issues,
-    data: {
-      totalImages,
-      withDimensions,
-      withoutDimensions,
-      missingDimensions: missingDimensions.slice(0, 20),
-      aspectRatioSet,
-    },
-  };
-}
-function truncateSrc(src: string): string {
-  // Remove query strings and truncate long URLs
-  const cleanSrc = src.split('?')[0];
-  if (cleanSrc.length > 60) {
-    return cleanSrc.substring(0, 30) + '...' + cleanSrc.substring(cleanSrc.length - 25);
-  }
-  return cleanSrc;
-}

package/src/audit/checks/images.ts DELETED Viewed

@@ -1,160 +0,0 @@
-import * as cheerio from 'cheerio';
-import { httpHead } from '../../utils/http.js';
-import type { AuditIssue } from '../types.js';
-import { ISSUE_DEFINITIONS } from '../types.js';
-export interface ImageData {
-  total: number;
-  missingAlt: { src: string }[];
-  emptyAlt: { src: string }[];
-  missingDimensions: { src: string }[];
-  largImages: { src: string; size?: number }[];
-  brokenImages: { src: string }[];
-  lazyLoaded: number;
-  withDimensions: number;
-}
-export async function analyzeImages(
-  html: string,
-  baseUrl: string,
-  checkBroken: boolean = false
-): Promise<{ issues: AuditIssue[]; data: ImageData }> {
-  const issues: AuditIssue[] = [];
-  const $ = cheerio.load(html);
-  const missingAlt: ImageData['missingAlt'] = [];
-  const emptyAlt: ImageData['emptyAlt'] = [];
-  const missingDimensions: ImageData['missingDimensions'] = [];
-  const largeImages: ImageData['largImages'] = [];
-  const brokenImages: ImageData['brokenImages'] = [];
-  let lazyLoaded = 0;
-  let withDimensions = 0;
-  let total = 0;
-  const images: { src: string; alt: string | null; width: string | undefined; height: string | undefined; loading: string | undefined }[] = [];
-  $('img').each((_, el) => {
-    const src = $(el).attr('src') || $(el).attr('data-src') || '';
-    const alt = $(el).attr('alt');
-    const width = $(el).attr('width');
-    const height = $(el).attr('height');
-    const loading = $(el).attr('loading');
-    if (!src || src.startsWith('data:')) return; // Skip data URIs
-    total++;
-    images.push({ src, alt: alt === undefined ? null : alt, width, height, loading });
-    // Check alt text
-    if (alt === undefined || alt === null) {
-      missingAlt.push({ src });
-    } else if (alt === '') {
-      emptyAlt.push({ src });
-    }
-    // Check dimensions
-    if (!width || !height) {
-      missingDimensions.push({ src });
-    } else {
-      withDimensions++;
-    }
-    // Check lazy loading
-    if (loading === 'lazy') {
-      lazyLoaded++;
-    }
-  });
-  // Check for broken images and large images (limited)
-  if (checkBroken) {
-    const imagesToCheck = images.slice(0, 10);
-    for (const img of imagesToCheck) {
-      try {
-        const fullUrl = new URL(img.src, baseUrl).href;
-        const response = await httpHead(fullUrl, {
-          timeout: 5000,
-          validateStatus: () => true,
-        });
-        if (response.status >= 400) {
-          brokenImages.push({ src: img.src });
-        } else {
-          // Check file size
-          const contentLength = parseInt(response.headers['content-length'] || '0', 10);
-          if (contentLength > 200 * 1024) { // > 200KB
-            largeImages.push({ src: img.src, size: contentLength });
-          }
-        }
-      } catch {
-        // Don't mark as broken for network errors
-      }
-    }
-  }
-  // Generate issues
-  if (missingAlt.length > 0) {
-    issues.push({
-      ...ISSUE_DEFINITIONS.IMG_ALT_MISSING,
-      affectedUrls: [baseUrl],
-      details: {
-        count: missingAlt.length,
-        images: missingAlt.slice(0, 5).map(i => i.src),
-      },
-    });
-  }
-  if (emptyAlt.length > 0) {
-    issues.push({
-      ...ISSUE_DEFINITIONS.IMG_ALT_EMPTY,
-      affectedUrls: [baseUrl],
-      details: {
-        count: emptyAlt.length,
-        images: emptyAlt.slice(0, 5).map(i => i.src),
-      },
-    });
-  }
-  if (missingDimensions.length > 0) {
-    issues.push({
-      ...ISSUE_DEFINITIONS.IMG_NO_DIMENSIONS,
-      affectedUrls: [baseUrl],
-      details: {
-        count: missingDimensions.length,
-        images: missingDimensions.slice(0, 5).map(i => i.src),
-      },
-    });
-  }
-  for (const img of largeImages) {
-    issues.push({
-      ...ISSUE_DEFINITIONS.IMG_TOO_LARGE,
-      affectedUrls: [baseUrl],
-      details: {
-        src: img.src,
-        size: img.size ? `${(img.size / 1024).toFixed(0)}KB` : 'Unknown',
-      },
-    });
-  }
-  for (const img of brokenImages) {
-    issues.push({
-      ...ISSUE_DEFINITIONS.IMG_BROKEN,
-      affectedUrls: [baseUrl],
-      details: { src: img.src },
-    });
-  }
-  return {
-    issues,
-    data: {
-      total,
-      missingAlt,
-      emptyAlt,
-      missingDimensions,
-      largImages: largeImages,
-      brokenImages,
-      lazyLoaded,
-      withDimensions,
-    }
-  };
-}