npm - @rankcli/agent-runtime - Versions diffs - 0.0.15 → 0.0.17 - Mend

@rankcli/agent-runtime 0.0.15 → 0.0.17

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 (203) hide show

package/README.md +5 -4
package/dist/index.d.mts +44 -393
package/dist/index.d.ts +44 -393
package/dist/index.js +22098 -26131
package/dist/index.mjs +11834 -15857
package/package.json +10 -4
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/agent-experience.ts +0 -108
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 -406
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/rag-chunk-readiness.test.ts +0 -159
package/src/audit/checks/rag-chunk-readiness.ts +0 -163
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 -633
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 -1987
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/analyzers/image-optimization-analyzer.test.ts DELETED Viewed

@@ -1,145 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { analyzeImages, generateResponsiveImage } from './image-optimization-analyzer.js';
-describe('Image Optimization Analyzer', () => {
-  describe('analyzeImages', () => {
-    it('detects images with alt text', () => {
-      const html = `
-<html><body>
-  <img src="/photo1.jpg" alt="A beautiful sunset">
-  <img src="/photo2.jpg" alt="Mountain landscape">
-</body></html>
-`;
-      const result = analyzeImages(html, 'https://example.com');
-      expect(result.totalImages).toBe(2);
-      expect(result.imagesWithAlt).toBe(2);
-    });
-    it('detects images without alt text', () => {
-      const html = `
-<html><body>
-  <img src="/photo1.jpg">
-  <img src="/photo2.jpg" alt="Has alt">
-</body></html>
-`;
-      const result = analyzeImages(html, 'https://example.com');
-      expect(result.missingAlt.length).toBe(1);
-      expect(result.issues.some(i => i.code === 'IMG_MISSING_ALT')).toBe(true);
-    });
-    it('detects images with dimensions', () => {
-      const html = `
-<html><body>
-  <img src="/photo.jpg" alt="Test" width="800" height="600">
-</body></html>
-`;
-      const result = analyzeImages(html, 'https://example.com');
-      expect(result.imagesWithDimensions).toBe(1);
-    });
-    it('detects images without dimensions', () => {
-      const html = `
-<html><body>
-  <img src="/photo1.jpg" alt="Test">
-  <img src="/photo2.jpg" alt="Test">
-</body></html>
-`;
-      const result = analyzeImages(html, 'https://example.com');
-      expect(result.issues.some(i => i.code === 'IMG_MISSING_DIMENSIONS')).toBe(true);
-    });
-    it('detects modern image formats', () => {
-      const html = `
-<html><body>
-  <img src="/photo.webp" alt="Test" width="800" height="600">
-  <img src="/photo.avif" alt="Test" width="800" height="600">
-</body></html>
-`;
-      const result = analyzeImages(html, 'https://example.com');
-      expect(result.modernFormats).toBe(2);
-      expect(result.legacyFormats).toBe(0);
-    });
-    it('detects legacy image formats', () => {
-      const html = `
-<html><body>
-  <img src="/photo.jpg" alt="Test" width="800" height="600">
-  <img src="/photo.png" alt="Test" width="800" height="600">
-</body></html>
-`;
-      const result = analyzeImages(html, 'https://example.com');
-      expect(result.legacyFormats).toBe(2);
-      expect(result.issues.some(i => i.code === 'IMG_NO_MODERN_FORMATS')).toBe(true);
-    });
-    it('detects lazy loading', () => {
-      const html = `
-<html><body>
-  <img src="/photo1.jpg" alt="Test" loading="lazy">
-  <img src="/photo2.jpg" alt="Test">
-</body></html>
-`;
-      const result = analyzeImages(html, 'https://example.com');
-      expect(result.imagesWithLazyLoading).toBe(1);
-    });
-    it('warns about lazy loading hero images', () => {
-      const html = `
-<html><body>
-  <img src="/hero.jpg" alt="Hero" loading="lazy" width="1200" height="600">
-</body></html>
-`;
-      const result = analyzeImages(html, 'https://example.com');
-      expect(result.issues.some(i => i.code === 'IMG_HERO_LAZY')).toBe(true);
-    });
-    it('accepts decorative images with empty alt', () => {
-      const html = `
-<html><body>
-  <img src="/decoration.png" alt="" role="presentation">
-</body></html>
-`;
-      const result = analyzeImages(html, 'https://example.com');
-      expect(result.imagesWithAlt).toBe(1);
-      expect(result.decorativeWithoutRole.length).toBe(0);
-    });
-    it('warns decorative images without role', () => {
-      const html = `
-<html><body>
-  <img src="/decoration.png" alt="">
-</body></html>
-`;
-      const result = analyzeImages(html, 'https://example.com');
-      expect(result.decorativeWithoutRole.length).toBe(1);
-    });
-  });
-  describe('generateResponsiveImage', () => {
-    it('generates responsive image HTML', () => {
-      const html = generateResponsiveImage({
-        src: '/images/hero.jpg',
-        alt: 'Hero image',
-        widths: [400, 800, 1200],
-        sizes: '(max-width: 768px) 100vw, 50vw',
-      });
-      expect(html).toContain('<picture>');
-      expect(html).toContain('srcset=');
-      expect(html).toContain('type="image/webp"');
-      expect(html).toContain('alt="Hero image"');
-      expect(html).toContain('loading="lazy"');
-    });
-    it('respects loading option', () => {
-      const html = generateResponsiveImage({
-        src: '/images/hero.jpg',
-        alt: 'Hero image',
-        widths: [800],
-        loading: 'eager',
-      });
-      expect(html).toContain('loading="eager"');
-    });
-  });
-});

package/src/analyzers/image-optimization-analyzer.ts DELETED Viewed

@@ -1,348 +0,0 @@
-/**
- * Image Optimization Analyzer
- *
- * Analyzes images for SEO and performance optimization.
- * Checks formats, dimensions, alt text, lazy loading, and compression indicators.
- */
-import * as cheerio from 'cheerio';
-import type { AuditIssue } from '../audit/types.js';
-export 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[];
-}
-export interface ImageInfo {
-  src: string;
-  alt?: string;
-  width?: number;
-  height?: number;
-  format?: string;
-  loading?: string;
-  issues: string[];
-}
-const MODERN_FORMATS = ['webp', 'avif'];
-const LEGACY_FORMATS = ['jpg', 'jpeg', 'png', 'gif', 'bmp'];
-const MAX_RECOMMENDED_DIMENSION = 2000;
-/**
- * Extract format from image URL
- */
-function getImageFormat(src: string): string | undefined {
-  // Handle data URLs
-  if (src.startsWith('data:image/')) {
-    const match = src.match(/data:image\/(\w+)/);
-    return match ? match[1] : undefined;
-  }
-  // Handle regular URLs
-  try {
-    const url = new URL(src, 'https://example.com');
-    const pathname = url.pathname.toLowerCase();
-    const ext = pathname.split('.').pop();
-    return ext && ext.length <= 5 ? ext : undefined;
-  } catch {
-    const ext = src.split('.').pop()?.toLowerCase();
-    return ext && ext.length <= 5 ? ext : undefined;
-  }
-}
-/**
- * Analyze all images on a page
- */
-export function analyzeImages(html: string, url: string): ImageAnalysisResult {
-  const $ = cheerio.load(html);
-  const issues: AuditIssue[] = [];
-  const recommendations: string[] = [];
-  let score = 100;
-  const allImages: ImageInfo[] = [];
-  const missingAlt: ImageInfo[] = [];
-  const oversizedImages: ImageInfo[] = [];
-  const decorativeWithoutRole: ImageInfo[] = [];
-  let imagesWithAlt = 0;
-  let imagesWithDimensions = 0;
-  let imagesWithLazyLoading = 0;
-  let modernFormats = 0;
-  let legacyFormats = 0;
-  // Analyze each image
-  $('img').each((_, el) => {
-    const $img = $(el);
-    const src = $img.attr('src') || $img.attr('data-src') || '';
-    const alt = $img.attr('alt');
-    const width = parseInt($img.attr('width') || '0');
-    const height = parseInt($img.attr('height') || '0');
-    const loading = $img.attr('loading');
-    const role = $img.attr('role');
-    const format = getImageFormat(src);
-    const imageIssues: string[] = [];
-    const imgInfo: ImageInfo = {
-      src: src.substring(0, 200), // Truncate long data URLs
-      alt,
-      width: width || undefined,
-      height: height || undefined,
-      format,
-      loading,
-      issues: imageIssues,
-    };
-    // Check alt attribute
-    if (alt === undefined) {
-      imageIssues.push('Missing alt attribute');
-      missingAlt.push(imgInfo);
-    } else if (alt === '') {
-      // Empty alt is valid for decorative images, but should have role="presentation"
-      if (role !== 'presentation' && role !== 'none') {
-        imageIssues.push('Empty alt without role="presentation"');
-        decorativeWithoutRole.push(imgInfo);
-      }
-      imagesWithAlt++; // Empty alt still counts as having alt
-    } else {
-      imagesWithAlt++;
-      // Check for poor alt text patterns
-      if (alt.toLowerCase().includes('image') ||
-          alt.toLowerCase().includes('picture') ||
-          alt.toLowerCase().includes('photo')) {
-        imageIssues.push('Alt text contains generic terms');
-      }
-      if (alt.length > 125) {
-        imageIssues.push('Alt text too long (>125 chars)');
-      }
-      // Check for filename-like alt
-      if (/\.(jpg|jpeg|png|gif|webp|svg)$/i.test(alt)) {
-        imageIssues.push('Alt text appears to be a filename');
-      }
-    }
-    // Check dimensions
-    if (width > 0 && height > 0) {
-      imagesWithDimensions++;
-      // Check for oversized images
-      if (width > MAX_RECOMMENDED_DIMENSION || height > MAX_RECOMMENDED_DIMENSION) {
-        imageIssues.push(`Dimensions too large (${width}x${height})`);
-        oversizedImages.push(imgInfo);
-      }
-    } else {
-      imageIssues.push('Missing width/height attributes');
-    }
-    // Check lazy loading
-    if (loading === 'lazy') {
-      imagesWithLazyLoading++;
-    }
-    // Check format
-    if (format) {
-      if (MODERN_FORMATS.includes(format)) {
-        modernFormats++;
-      } else if (LEGACY_FORMATS.includes(format)) {
-        legacyFormats++;
-      }
-    }
-    allImages.push(imgInfo);
-  });
-  const totalImages = allImages.length;
-  // Generate issues
-  if (missingAlt.length > 0) {
-    const percentage = Math.round((missingAlt.length / totalImages) * 100);
-    const severity = percentage > 50 ? 'critical' : percentage > 20 ? 'warning' : 'info';
-    issues.push({
-      code: 'IMG_MISSING_ALT',
-      severity,
-      category: 'content',
-      title: `${missingAlt.length} images missing alt attribute`,
-      description: `${percentage}% of images lack alt text, hurting accessibility and SEO.`,
-      impact: 'Screen readers cannot describe images; search engines lose context',
-      howToFix: 'Add descriptive alt text to all images. Use alt="" for decorative images.',
-      affectedUrls: [url],
-    });
-    score -= Math.min(missingAlt.length * 3, 25);
-  }
-  const missingDimensions = totalImages - imagesWithDimensions;
-  if (missingDimensions > 0) {
-    issues.push({
-      code: 'IMG_MISSING_DIMENSIONS',
-      severity: 'warning',
-      category: 'performance',
-      title: `${missingDimensions} images missing width/height`,
-      description: 'Images without explicit dimensions cause layout shifts (CLS).',
-      impact: 'Poor Core Web Vitals, degraded user experience',
-      howToFix: 'Add width and height attributes to all images.',
-      affectedUrls: [url],
-    });
-    score -= Math.min(missingDimensions * 2, 20);
-  }
-  if (legacyFormats > 0 && modernFormats === 0) {
-    issues.push({
-      code: 'IMG_NO_MODERN_FORMATS',
-      severity: 'warning',
-      category: 'performance',
-      title: 'No modern image formats (WebP/AVIF)',
-      description: `All ${legacyFormats} images use legacy formats (JPEG/PNG).`,
-      impact: 'Larger file sizes, slower page load',
-      howToFix: 'Convert images to WebP or AVIF format. Use <picture> element for fallbacks.',
-      affectedUrls: [url],
-    });
-    score -= 10;
-    recommendations.push('Convert images to WebP/AVIF for 30-50% smaller file sizes');
-  }
-  if (oversizedImages.length > 0) {
-    issues.push({
-      code: 'IMG_OVERSIZED',
-      severity: 'warning',
-      category: 'performance',
-      title: `${oversizedImages.length} images have excessive dimensions`,
-      description: `Images larger than ${MAX_RECOMMENDED_DIMENSION}px may be wasteful on most screens.`,
-      impact: 'Unnecessary bandwidth usage, slower loading',
-      howToFix: 'Resize images to match their display size. Use srcset for responsive images.',
-      affectedUrls: [url],
-    });
-    score -= Math.min(oversizedImages.length * 3, 15);
-  }
-  // Check hero/above-fold images with lazy loading
-  const firstImage = allImages[0];
-  if (firstImage?.loading === 'lazy') {
-    issues.push({
-      code: 'IMG_HERO_LAZY',
-      severity: 'warning',
-      category: 'performance',
-      title: 'First image has loading="lazy"',
-      description: 'Above-the-fold images should not be lazy-loaded as it delays LCP.',
-      impact: 'Slower Largest Contentful Paint',
-      howToFix: 'Remove loading="lazy" from hero/above-fold images. Keep it for below-fold images.',
-      affectedUrls: [url],
-    });
-    score -= 10;
-  }
-  // Check for images without lazy loading (below potential fold)
-  const belowFoldWithoutLazy = allImages.slice(3).filter(img => img.loading !== 'lazy');
-  if (belowFoldWithoutLazy.length > 5) {
-    recommendations.push(`Consider adding loading="lazy" to ${belowFoldWithoutLazy.length} below-fold images`);
-  }
-  // Check for decorative images without proper role
-  if (decorativeWithoutRole.length > 0) {
-    issues.push({
-      code: 'IMG_DECORATIVE_NO_ROLE',
-      severity: 'info',
-      category: 'content',
-      title: `${decorativeWithoutRole.length} decorative images without role`,
-      description: 'Images with empty alt should have role="presentation" for accessibility.',
-      impact: 'Minor accessibility issue',
-      howToFix: 'Add role="presentation" to decorative images with empty alt.',
-      affectedUrls: [url],
-    });
-  }
-  // Check for background images (informational)
-  const elementsWithBgImage = $('[style*="background-image"], [style*="background:"]').length;
-  if (elementsWithBgImage > 3) {
-    recommendations.push(`${elementsWithBgImage} CSS background images detected - ensure they're not content images`);
-  }
-  // Check for SVG images (good for icons)
-  const svgImages = $('svg, img[src$=".svg"]').length;
-  if (svgImages > 0) {
-    // This is positive, no action needed
-  }
-  // Positive recommendations
-  if (totalImages > 0 && imagesWithAlt === totalImages) {
-    recommendations.push('✓ All images have alt attributes');
-  }
-  if (modernFormats > legacyFormats) {
-    recommendations.push('✓ Majority of images use modern formats');
-  }
-  return {
-    score: Math.max(0, Math.min(100, score)),
-    totalImages,
-    imagesWithAlt,
-    imagesWithDimensions,
-    imagesWithLazyLoading,
-    modernFormats,
-    legacyFormats,
-    oversizedImages,
-    missingAlt,
-    decorativeWithoutRole,
-    issues,
-    recommendations,
-  };
-}
-/**
- * Generate responsive image HTML
- */
-export function generateResponsiveImage(options: {
-  src: string;
-  alt: string;
-  widths: number[];
-  sizes?: string;
-  loading?: 'lazy' | 'eager';
-  className?: string;
-}): string {
-  const { src, alt, widths, sizes = '100vw', loading = 'lazy', className } = options;
-  // Assume src is the largest size
-  const basename = src.replace(/\.[^.]+$/, '');
-  const ext = src.split('.').pop() || 'jpg';
-  const srcset = widths
-    .map(w => `${basename}-${w}w.webp ${w}w`)
-    .join(', ');
-  const fallbackSrcset = widths
-    .map(w => `${basename}-${w}w.${ext} ${w}w`)
-    .join(', ');
-  return `<picture>
-  <source
-    type="image/webp"
-    srcset="${srcset}"
-    sizes="${sizes}"
-  />
-  <source
-    type="image/${ext === 'jpg' ? 'jpeg' : ext}"
-    srcset="${fallbackSrcset}"
-    sizes="${sizes}"
-  />
-  <img
-    src="${src}"
-    alt="${alt}"
-    width="${widths[widths.length - 1]}"
-    height="auto"
-    loading="${loading}"${className ? `\n    class="${className}"` : ''}
-    decoding="async"
-  />
-</picture>`;
-}