@aexol/spectral 0.9.126 → 0.9.128

package/dist/extensions/seo/analyzers/drift.js

@@ -12,6 +12,7 @@ import Database from "better-sqlite3";
 import { parsePage } from "../utils/parser.js";
 import { fetchPage } from "../utils/fetcher.js";
 import { normalizeUrl, urlHash } from "../utils/url-safety.js";
+const SCHEMA_VERSION = 2;
 let dbInstance = null;
 function getDb(config) {
     if (dbInstance)
@@ -19,27 +20,44 @@ function getDb(config) {
     mkdirSync(dirname(config.dbPath), { recursive: true });
     dbInstance = new Database(config.dbPath);
     dbInstance.pragma("journal_mode = WAL");
+    // Create version table and track schema version.
     dbInstance.exec(`
-    CREATE TABLE IF NOT EXISTS baselines (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      url TEXT NOT NULL,
-      url_hash TEXT NOT NULL,
-      timestamp TEXT NOT NULL,
-      title TEXT,
-      meta_description TEXT,
-      canonical TEXT,
-      robots TEXT,
-      h1 TEXT,
-      h2_json TEXT,
-      h3_json TEXT,
-      schema_json TEXT,
-      og_json TEXT,
-      html_hash TEXT,
-      schema_hash TEXT,
-      status_code INTEGER
-    );
-    CREATE INDEX IF NOT EXISTS idx_url_hash ON baselines(url_hash);
+    CREATE TABLE IF NOT EXISTS schema_version (version INTEGER NOT NULL);
   `);
+    const currentVersion = dbInstance.prepare("SELECT version FROM schema_version").get();
+    if (!currentVersion || currentVersion.version < 1) {
+        dbInstance.exec(`
+      CREATE TABLE IF NOT EXISTS baselines (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        url TEXT NOT NULL,
+        url_hash TEXT NOT NULL,
+        timestamp TEXT NOT NULL,
+        title TEXT,
+        meta_description TEXT,
+        canonical TEXT,
+        robots TEXT,
+        h1 TEXT,
+        h2_json TEXT,
+        h3_json TEXT,
+        schema_json TEXT,
+        og_json TEXT,
+        html_hash TEXT,
+        schema_hash TEXT,
+        status_code INTEGER
+      );
+      CREATE INDEX IF NOT EXISTS idx_url_hash ON baselines(url_hash);
+    `);
+        dbInstance.prepare("DELETE FROM schema_version").run();
+        dbInstance.prepare("INSERT INTO schema_version (version) VALUES (1)").run();
+    }
+    if (!currentVersion || currentVersion.version < 2) {
+        dbInstance.exec(`
+      ALTER TABLE baselines ADD COLUMN expires_at TEXT NOT NULL DEFAULT '';
+      ALTER TABLE baselines ADD COLUMN headers_json TEXT NOT NULL DEFAULT '{}';
+    `);
+        dbInstance.prepare("DELETE FROM schema_version").run();
+        dbInstance.prepare("INSERT INTO schema_version (version) VALUES (2)").run();
+    }
     return dbInstance;
 }
 /** Close the database connection (called on session shutdown). */
@@ -69,19 +87,25 @@ export async function captureBaseline(url, config) {
     const ogJson = JSON.stringify(pageData.ogTags);
     const htmlHash = hashContent(fetchResult.content);
     const schemaHash = hashContent(schemaJson);
+    const headersJson = JSON.stringify(fetchResult.headers);
+    // Compute expiration (default: 30 days).
+    const expiresAt = new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString();
     const db = getDb(config);
+    // Prune expired baselines before inserting.
+    db.prepare("DELETE FROM baselines WHERE expires_at < ? AND expires_at != ''").run(new Date().toISOString());
     const stmt = db.prepare(`
     INSERT INTO baselines
-      (url, url_hash, timestamp, title, meta_description, canonical, robots,
-       h1, h2_json, h3_json, schema_json, og_json, html_hash, schema_hash, status_code)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      (url, url_hash, timestamp, expires_at, title, meta_description, canonical, robots,
+       h1, h2_json, h3_json, schema_json, og_json, html_hash, schema_hash, status_code, headers_json)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
   `);
-    const info = stmt.run(normalizeUrl(url), hash, timestamp, pageData.title, pageData.metaDescription, pageData.canonical, pageData.metaRobots, pageData.headings.find((h) => h.level === 1)?.text ?? null, h2Json, h3Json, schemaJson, ogJson, htmlHash, schemaHash, fetchResult.statusCode);
+    const info = stmt.run(normalizeUrl(url), hash, timestamp, expiresAt, pageData.title, pageData.metaDescription, pageData.canonical, pageData.metaRobots, pageData.headings.find((h) => h.level === 1)?.text ?? null, h2Json, h3Json, schemaJson, ogJson, htmlHash, schemaHash, fetchResult.statusCode, headersJson);
     return {
         id: Number(info.lastInsertRowid),
         url: normalizeUrl(url),
         urlHash: hash,
         timestamp,
+        expiresAt,
         title: pageData.title,
         metaDescription: pageData.metaDescription,
         canonical: pageData.canonical,
@@ -94,6 +118,7 @@ export async function captureBaseline(url, config) {
         htmlHash,
         schemaHash,
         statusCode: fetchResult.statusCode,
+        headersJson,
     };
 }
 /** Get a baseline by ID or the latest baseline for a URL. */
@@ -113,6 +138,7 @@ function rowToBaseline(row) {
         url: row.url,
         urlHash: row.url_hash,
         timestamp: row.timestamp,
+        expiresAt: row.expires_at ?? "",
         title: row.title ?? null,
         metaDescription: row.meta_description ?? null,
         canonical: row.canonical ?? null,
@@ -125,6 +151,7 @@ function rowToBaseline(row) {
         htmlHash: row.html_hash ?? "",
         schemaHash: row.schema_hash ?? "",
         statusCode: row.status_code ?? 0,
+        headersJson: row.headers_json ?? "{}",
     };
 }
 /** Compare current page state against a baseline. */
@@ -133,32 +160,52 @@ export async function compareBaseline(url, config, baselineId) {
     if (!baseline) {
         throw new Error(`No baseline found for ${url}${baselineId ? ` (id=${baselineId})` : ""}.`);
     }
+    // Check if baseline has expired.
+    if (baseline.expiresAt && baseline.expiresAt < new Date().toISOString()) {
+        throw new Error(`Baseline has expired (${baseline.expiresAt}). Capture a new baseline.`);
+    }
     const fetchResult = await fetchPage(url, config);
     const pageData = parsePage(fetchResult.content, fetchResult.finalUrl);
     const changedFields = [];
     const details = {};
+    const fieldSeverity = {};
     const comparisons = [
-        { field: "title", before: baseline.title, after: pageData.title },
-        { field: "metaDescription", before: baseline.metaDescription, after: pageData.metaDescription },
-        { field: "canonical", before: baseline.canonical, after: pageData.canonical },
-        { field: "robots", before: baseline.robots, after: pageData.metaRobots },
-        { field: "h1", before: baseline.h1, after: pageData.headings.find((h) => h.level === 1)?.text ?? null },
+        { field: "title", before: baseline.title, after: pageData.title, severityHint: "high" },
+        { field: "metaDescription", before: baseline.metaDescription, after: pageData.metaDescription, severityHint: "medium" },
+        { field: "canonical", before: baseline.canonical, after: pageData.canonical, severityHint: "critical" },
+        { field: "robots", before: baseline.robots, after: pageData.metaRobots, severityHint: "high" },
+        { field: "h1", before: baseline.h1, after: pageData.headings.find((h) => h.level === 1)?.text ?? null, severityHint: "medium" },
         {
             field: "h2",
             before: JSON.parse(baseline.h2Json),
             after: pageData.headings.filter((h) => h.level === 2).map((h) => h.text),
+            severityHint: "low",
         },
         {
             field: "h3",
             before: JSON.parse(baseline.h3Json),
             after: pageData.headings.filter((h) => h.level === 3).map((h) => h.text),
+            severityHint: "low",
         },
         {
             field: "schema",
             before: JSON.parse(baseline.schemaJson),
             after: pageData.schemaBlocks.map((s) => ({ type: s.type, format: s.format })),
+            severityHint: "high",
+        },
+        { field: "statusCode", before: baseline.statusCode, after: fetchResult.statusCode, severityHint: "critical" },
+        {
+            field: "headers",
+            before: JSON.parse(baseline.headersJson || "{}"),
+            after: fetchResult.headers,
+            severityHint: "medium",
+        },
+        {
+            field: "ogTags",
+            before: JSON.parse(baseline.ogJson),
+            after: pageData.ogTags,
+            severityHint: "low",
         },
-        { field: "statusCode", before: baseline.statusCode, after: fetchResult.statusCode },
     ];
     for (const cmp of comparisons) {
         const beforeStr = JSON.stringify(cmp.before);
@@ -166,6 +213,15 @@ export async function compareBaseline(url, config, baselineId) {
         if (beforeStr !== afterStr) {
             changedFields.push(cmp.field);
             details[cmp.field] = { before: cmp.before, after: cmp.after };
+            fieldSeverity[cmp.field] = cmp.severityHint;
+            // Detect removed schema blocks (all blocks removed).
+            if (cmp.field === "schema") {
+                const beforeArr = Array.isArray(cmp.before) ? cmp.before : [];
+                const afterArr = Array.isArray(cmp.after) ? cmp.after : [];
+                if (beforeArr.length > 0 && afterArr.length === 0) {
+                    fieldSeverity[cmp.field] = "critical";
+                }
+            }
         }
     }
     // HTML hash comparison.
@@ -192,6 +248,7 @@ export async function compareBaseline(url, config, baselineId) {
         comparedAt: new Date().toISOString(),
         changedFields,
         details,
+        fieldSeverity,
         severity,
     };
 }

package/dist/extensions/seo/analyzers/images.d.ts

@@ -2,9 +2,15 @@
  * Image SEO analyzer.
  *
  * Extracts image data from parsed HTML and flags common SEO issues:
- * missing alt text, missing dimensions, lazy-loading method, and modern
- * format usage.
+ * missing alt text, missing dimensions, lazy-loading method, modern
+ * format usage, responsive coverage, fetchpriority analysis,
+ * decorative vs missing alt distinction, aspect ratio checks,
+ * and SVG accessibility.
  */
-import type { ImageAuditResult } from "../types.js";
-export declare function auditImages(html: string, url?: string): ImageAuditResult;
+import type { ImageAuditResult, ImageInfo, PageData } from "../types.js";
+import type { SeoConfig } from "../config.js";
+export declare function auditImages(html: string, url?: string, pageData?: PageData): ImageAuditResult;
+export declare function checkImageUrls(images: ImageInfo[], config: SeoConfig): Promise<{
+    brokenUrls: string[];
+}>;
 //# sourceMappingURL=images.d.ts.map

package/dist/extensions/seo/analyzers/images.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../../../src/extensions/seo/analyzers/images.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAuB,MAAM,aAAa,CAAC;AAiBzE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAqCxE"}
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../../../src/extensions/seo/analyzers/images.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAiB9C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,gBAAgB,CAsK7F;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EAAE,EACnB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoCnC"}

package/dist/extensions/seo/analyzers/images.js

@@ -12,32 +12,130 @@ function getExtension(src) {
         return dotIdx >= 0 ? src.slice(dotIdx).toLowerCase() : "";
     }
 }
-export function auditImages(html, url) {
-    const pageData = parsePage(html, url);
-    const images = pageData.images;
+export function auditImages(html, url, pageData) {
+    const pd = pageData ?? parsePage(html, url);
+    const images = pd.images;
     let missingAlt = 0;
+    let decorativeCount = 0;
     let missingDimensions = 0;
     const lazyCounts = { native: 0, dataSrc: 0, dataLazy: 0, none: 0 };
     let modernFormats = 0;
     const oversized = [];
+    let fetchpriorityHighCount = 0;
+    const fetchpriorityIssues = [];
+    const ratioIssues = [];
+    const dimensionHintIssues = [];
+    let decorativeWithAltIssues = 0;
+    let svgImgMissingAlt = 0;
+    let responsiveImages = 0;
     for (const img of images) {
-        if (!img.alt)
+        // Distinguish decorative (alt="" empty) from truly missing alt
+        if (img.isDecorative) {
+            decorativeCount++;
+            if (img.alt)
+                decorativeWithAltIssues++;
+        }
+        else if (!img.alt) {
             missingAlt++;
+        }
         if (!img.width || !img.height)
             missingDimensions++;
         lazyCounts[img.lazyMethod]++;
         const ext = getExtension(img.src);
         if (MODERN_FORMATS.includes(ext))
             modernFormats++;
+        if (img.isSvg && !img.alt)
+            svgImgMissingAlt++;
         // Flag potential oversized images (large numeric dimensions).
         const w = img.width ? Number.parseInt(img.width, 10) : 0;
         const h = img.height ? Number.parseInt(img.height, 10) : 0;
         if (w > 2000 || h > 2000) {
             oversized.push(img.src);
         }
+        if (w > 0 && h > 0 && (w / h > 4 || h / w > 4)) {
+            dimensionHintIssues.push(`Extreme dimension ratio (${w}x${h}): ${img.src}`);
+        }
+        if ((!img.width || !img.height) && !img.srcset && !img.isInPicture) {
+            dimensionHintIssues.push(`Missing dimension hints (no width/height or srcset): ${img.src}`);
+        }
+        // fetchpriority analysis
+        if (img.fetchpriority === "high") {
+            fetchpriorityHighCount++;
+            if (w > 0 && h > 0 && (w < 100 || h < 100)) {
+                fetchpriorityIssues.push(`fetchpriority="high" on small image (${w}x${h}): ${img.src}`);
+            }
+        }
+        // Aspect ratio checks
+        if (w > 0 && h > 0) {
+            const ratio = w / h;
+            if (ratio < 0.3 || ratio > 3.0) {
+                ratioIssues.push(`Extreme aspect ratio (${ratio.toFixed(2)}): ${img.src} (${w}x${h})`);
+            }
+        }
+        // Responsive coverage
+        if (img.srcset || img.sizes || img.isInPicture) {
+            responsiveImages++;
+        }
+    }
+    // Decoding attribute analysis
+    const decodingStats = { async: 0, sync: 0, auto: 0, none: 0 };
+    for (const img of images) {
+        if (img.decoding === "async")
+            decodingStats.async++;
+        else if (img.decoding === "sync")
+            decodingStats.sync++;
+        else if (img.decoding === "auto")
+            decodingStats.auto++;
+        else
+            decodingStats.none++;
+    }
+    // No LCP image prioritized when many images exist
+    if (images.length > 5 && fetchpriorityHighCount === 0) {
+        fetchpriorityIssues.push(`No LCP image prioritized with fetchpriority="high"`);
+    }
+    const responsiveCoverage = images.length > 0
+        ? Math.round((responsiveImages / images.length) * 100)
+        : 100;
+    // Base score (existing formula using only truly missing alt)
+    const baseIssueCount = missingAlt + missingDimensions + oversized.length;
+    const baseScore = images.length === 0
+        ? 100
+        : Math.max(0, Math.round(100 - (baseIssueCount / (images.length * 3)) * 100));
+    // Adjustments
+    let adjustedScore = baseScore;
+    // Penalize extreme aspect ratios
+    if (ratioIssues.length > 0) {
+        adjustedScore = Math.max(0, adjustedScore - Math.min(10, ratioIssues.length * 2));
+    }
+    // Penalize SVG accessibility issues
+    const svgIssues = pd.svgMissingTitle ?? 0;
+    if (svgIssues > 0) {
+        // Cap SVG penalty at 15 — many inline icon SVGs are intentional
+        adjustedScore = Math.max(0, adjustedScore - Math.min(15, svgIssues * 3));
+    }
+    // Bonus for good responsive coverage
+    if (responsiveCoverage > 75) {
+        adjustedScore = Math.min(100, adjustedScore + 5);
+    }
+    // Bonus for proper fetchpriority usage
+    if (fetchpriorityHighCount >= 1) {
+        adjustedScore = Math.min(100, adjustedScore + 3);
+    }
+    // Bonus for decoding='async' adoption
+    const totalWithDecoding = decodingStats.async + decodingStats.sync + decodingStats.auto + decodingStats.none;
+    if (totalWithDecoding > 0 && decodingStats.async / totalWithDecoding > 0.5) {
+        adjustedScore = Math.min(100, adjustedScore + 2);
+    }
+    else if (decodingStats.async > 0) {
+        adjustedScore = Math.min(100, adjustedScore + 1);
+    }
+    // Penalize SVG <img> missing alt
+    if (svgImgMissingAlt > 0) {
+        adjustedScore = Math.max(0, adjustedScore - Math.min(10, svgImgMissingAlt * 2));
     }
     return {
-        url: url ?? pageData.url,
+        url: url ?? pd.url,
+        score: adjustedScore,
         totalImages: images.length,
         missingAlt,
         missingDimensions,
@@ -45,5 +143,55 @@ export function auditImages(html, url) {
         modernFormats,
         oversized,
         images,
+        pictureCount: pd.pictureCount,
+        svgCount: pd.svgCount,
+        svgMissingTitle: pd.svgMissingTitle,
+        responsiveImages,
+        responsiveCoverage,
+        fetchpriorityHighCount,
+        fetchpriorityIssues: fetchpriorityIssues.length > 0 ? fetchpriorityIssues : undefined,
+        decorativeCount,
+        ratioIssues: ratioIssues.length > 0 ? ratioIssues : undefined,
+        decodingStats,
+        svgImgMissingAlt: svgImgMissingAlt > 0 ? svgImgMissingAlt : undefined,
+        dimensionHintIssues: dimensionHintIssues.length > 0 ? dimensionHintIssues : undefined,
+        decorativeWithAltIssues: decorativeWithAltIssues > 0 ? decorativeWithAltIssues : undefined,
     };
 }
+export async function checkImageUrls(images, config) {
+    const MAX_IMAGES = 20;
+    const CONCURRENCY = 5;
+    const TIMEOUT_MS = 5000;
+    const brokenUrls = [];
+    const targetImages = images.slice(0, MAX_IMAGES);
+    for (let i = 0; i < targetImages.length; i += CONCURRENCY) {
+        const batch = targetImages.slice(i, i + CONCURRENCY);
+        const results = await Promise.allSettled(batch.map(async (img) => {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
+            try {
+                const res = await fetch(img.src, {
+                    method: "HEAD",
+                    signal: controller.signal,
+                    headers: { "User-Agent": config.userAgent },
+                });
+                if (res.status < 200 || res.status >= 400) {
+                    return { url: img.src, broken: true };
+                }
+                return { url: img.src, broken: false };
+            }
+            catch {
+                return { url: img.src, broken: true };
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        }));
+        for (const result of results) {
+            if (result.status === "fulfilled" && result.value.broken) {
+                brokenUrls.push(result.value.url);
+            }
+        }
+    }
+    return { brokenUrls };
+}

package/dist/extensions/seo/analyzers/performance.d.ts

@@ -1,6 +1,6 @@
-import type { PerformanceResult, PageWeightResult, RenderBlockingResult, FontAuditResult, FetchResult } from "../types.js";
-export declare function calculatePerformanceFromFetch(fetchResult: FetchResult, url: string): PerformanceResult;
-export declare function analyzePageWeight(fetchResult: FetchResult, url: string): PageWeightResult;
+import type { MeasuredPerformance, PerformanceResult, PageWeightResult, RenderBlockingResult, FontAuditResult, FetchResult } from "../types.js";
+export declare function calculatePerformanceFromFetch(fetchResult: FetchResult, url: string, measuredPerformance?: MeasuredPerformance): PerformanceResult;
+export declare function analyzePageWeight(fetchResult: FetchResult, url: string, measuredPerformance?: MeasuredPerformance): PageWeightResult;
 export declare function analyzeRenderBlocking(fetchResult: FetchResult, url: string): RenderBlockingResult;
 export declare function analyzeFonts(fetchResult: FetchResult, url: string): FontAuditResult;
 //# sourceMappingURL=performance.d.ts.map

package/dist/extensions/seo/analyzers/performance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../../../src/extensions/seo/analyzers/performance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAS3H,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,WAAW,EACxB,GAAG,EAAE,MAAM,GACV,iBAAiB,CA0EnB;AAiCD,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,gBAAgB,CA6CzF;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAgDjG;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAyEnF"}
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../../../src/extensions/seo/analyzers/performance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAShJ,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,WAAW,EACxB,GAAG,EAAE,MAAM,EACX,mBAAmB,CAAC,EAAE,mBAAmB,GACxC,iBAAiB,CA8GnB;AA8CD,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,WAAW,EACxB,GAAG,EAAE,MAAM,EACX,mBAAmB,CAAC,EAAE,mBAAmB,GACxC,gBAAgB,CA4ElB;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAgDjG;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAyEnF"}

package/dist/extensions/seo/analyzers/performance.js

@@ -4,10 +4,39 @@ const CLS_GOOD = 0.1;
 const CLS_POOR = 0.25;
 const TBT_GOOD = 200;
 const TBT_POOR = 600;
-export function calculatePerformanceFromFetch(fetchResult, url) {
+export function calculatePerformanceFromFetch(fetchResult, url, measuredPerformance) {
     const content = fetchResult.content;
     const headers = fetchResult.headers;
-    // Estimate metrics from available data
+    // If real browser measurements are available, use them.
+    if (measuredPerformance) {
+        const lcp = measuredPerformance.lcp ?? { value: 0, rating: "poor" };
+        const cls = measuredPerformance.cls ?? { value: 0, rating: "good" };
+        const tbt = measuredPerformance.tbt ?? { value: 0, rating: "good" };
+        const fcp = measuredPerformance.fcp ?? { value: 0, rating: "poor" };
+        const ttfb = measuredPerformance.ttfb ?? { value: 0, rating: "poor" };
+        const score = calculateCWVScore(lcp.rating, cls.rating, tbt.rating);
+        const result = {
+            url,
+            lcp: { value: lcp.value, rating: lcp.rating, element: lcp.element },
+            cls: { value: cls.value, rating: cls.rating },
+            tbt: { value: tbt.value, rating: tbt.rating },
+            fcp: { value: fcp.value, rating: fcp.rating },
+            ttfb: { value: ttfb.value, rating: ttfb.rating },
+            score,
+            source: "lab",
+            disclaimer: "Lab data measured in a single synthetic page load. This is not real-user (RUM) field data from Chrome UX Report.",
+            navigationTiming: measuredPerformance.navigationTiming,
+            longTasks: measuredPerformance.longTasks,
+            failedRequests: measuredPerformance.failedRequests,
+            layoutShiftCount: measuredPerformance.layoutShiftCount,
+            layoutShiftSources: measuredPerformance.layoutShiftSources,
+        };
+        if (measuredPerformance.navigationTiming) {
+            result.navigationTimingRatings = rateNavTiming(measuredPerformance.navigationTiming);
+        }
+        return result;
+    }
+    // Heuristic fallback: estimate metrics from HTML structure.
     const htmlSize = fetchResult.contentLengthBytes;
     const ttfbEstimate = estimateTTFB(headers);
     // Count resources to estimate complexity
@@ -71,16 +100,31 @@ export function calculatePerformanceFromFetch(fetchResult, url) {
     else
         tbtRating = "poor";
     // FCP estimate
-    const fcp = Math.round(ttfbEstimate + 200 + Math.random() * 300);
+    const fcpValue = Math.round(ttfbEstimate + 200 + Math.random() * 300);
+    const fcpRating = fcpValue < 1800 ? "good" : fcpValue < 3000 ? "needs-improvement" : "poor";
+    const ttfbRating = ttfbEstimate < 800 ? "good" : ttfbEstimate < 1800 ? "needs-improvement" : "poor";
     const score = calculateCWVScore(lcpRating, clsRating, tbtRating);
     return {
         url,
         lcp: { value: lcpEstimate, rating: lcpRating },
         cls: { value: Number(clsEstimate.toFixed(3)), rating: clsRating },
         tbt: { value: tbtEstimate, rating: tbtRating },
-        fcp,
-        ttfb: ttfbEstimate,
+        fcp: { value: fcpValue, rating: fcpRating },
+        ttfb: { value: ttfbEstimate, rating: ttfbRating },
         score,
+        source: "heuristic",
+    };
+}
+function rateNavTiming(nav) {
+    if (!nav)
+        return undefined;
+    const rate = (v, good, poor) => v < good ? "good" : v < poor ? "needs-improvement" : "poor";
+    return {
+        dns: { value: nav.dnsMs, rating: rate(nav.dnsMs, 100, 500) },
+        tcp: { value: nav.tcpMs, rating: rate(nav.tcpMs, 100, 500) },
+        ssl: { value: nav.sslMs, rating: rate(nav.sslMs, 100, 500) },
+        ttfb: { value: nav.ttfbMs, rating: rate(nav.ttfbMs, 800, 1800) },
+        download: { value: nav.downloadMs, rating: rate(nav.downloadMs, 500, 2000) },
     };
 }
 function estimateTTFB(headers) {
@@ -109,7 +153,34 @@ function calculateCWVScore(lcp, cls, tbt) {
         score -= 25;
     return Math.max(0, score);
 }
-export function analyzePageWeight(fetchResult, url) {
+export function analyzePageWeight(fetchResult, url, measuredPerformance) {
+    // If real browser measurements are available, use them for resource data.
+    if (measuredPerformance && (measuredPerformance.totalTransferKb !== undefined || measuredPerformance.topHeavyResources)) {
+        const totalKb = measuredPerformance.totalTransferKb ?? 0;
+        const resourceCount = measuredPerformance.resourceCount ?? 0;
+        const heavyResources = (measuredPerformance.topHeavyResources ?? []).map((r) => ({
+            url: r.url,
+            sizeKb: Math.round(r.transferSize / 1024),
+            type: r.type,
+        }));
+        // HTML size still comes from fetch result.
+        const htmlKb = Math.round(fetchResult.contentLengthBytes / 1024);
+        // Categorize by type from heavy resources list.
+        const byType = (type) => heavyResources.filter((r) => r.type === type).reduce((s, r) => s + r.sizeKb, 0);
+        return {
+            url: fetchResult.finalUrl || url,
+            totalKb,
+            htmlKb,
+            cssKb: byType("link"),
+            jsKb: byType("script"),
+            imageKb: byType("img"),
+            fontKb: byType("font"),
+            otherKb: 0,
+            resourceCount,
+            topHeavyResources: heavyResources,
+        };
+    }
+    // Heuristic fallback.
     const content = fetchResult.content;
     const htmlKb = Math.round(fetchResult.contentLengthBytes / 1024);
     // Estimate CSS size

package/dist/extensions/seo/analyzers/readability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readability.d.ts","sourceRoot":"","sources":["../../../../src/extensions/seo/analyzers/readability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAuCrD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAyEhF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAwBtE"}
+{"version":3,"file":"readability.d.ts","sourceRoot":"","sources":["../../../../src/extensions/seo/analyzers/readability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAgDrD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,iBAAiB,CA0DhF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAqBtE"}

package/dist/extensions/seo/analyzers/readability.js

@@ -1,6 +1,21 @@
+const ABBREVIATIONS = new Set([
+    "mr", "mrs", "ms", "dr", "prof", "sr", "jr", "st", "ave", "blvd",
+    "etc", "vs", "approx", "dept", "est", "eg", "ie", "inc", "ltd",
+    "co", "corp", "jan", "feb", "mar", "apr", "jun", "jul", "aug",
+    "sep", "oct", "nov", "dec",
+]);
 function countSentences(text) {
-    const matches = text.match(/[.!?]+/g);
-    return matches ? matches.length : 1;
+    if (!text)
+        return 1;
+    let processed = text;
+    for (const abbr of ABBREVIATIONS) {
+        const escaped = abbr.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        const re = new RegExp(`\\b${escaped}\\.`, "gi");
+        processed = processed.replace(re, (match) => match.replace(".", "##DOT##"));
+    }
+    const sentences = processed.split(/(?<=[.!?])\s+(?=[A-Z])/);
+    const count = sentences.length;
+    return count > 0 ? count : 1;
 }
 function countSyllables(word) {
     const lower = word.toLowerCase().replace(/[^a-z]/g, "");
@@ -16,10 +31,8 @@ function countSyllables(word) {
         }
         prevWasVowel = isVowel;
     }
-    // Silent e at end
     if (lower.endsWith("e") && count > 1)
         count--;
-    // le at end adds a syllable
     if (lower.endsWith("le") && lower.length > 3)
         count++;
     return Math.max(1, count);
@@ -59,17 +72,12 @@ export function analyzeReadability(text, url) {
         if (isComplexWord(clean))
             complexWordCount++;
     }
-    // Flesch Reading Ease
     const fleschReadingEase = Number((206.835 - 1.015 * (wordCount / sentenceCount) - 84.6 * (totalSyllables / wordCount)).toFixed(1));
-    // Flesch-Kincaid Grade Level
     const fleschKincaid = Number((0.39 * (wordCount / sentenceCount) + 11.8 * (totalSyllables / wordCount) - 15.59).toFixed(1));
-    // SMOG Index
     const smog = complexWordCount > 0
         ? Number((1.043 * Math.sqrt(complexWordCount * (30 / sentenceCount)) + 3.1291).toFixed(1))
         : 0;
-    // Automated Readability Index (ARI)
     const ari = Number((4.71 * (totalLetters / wordCount) + 0.5 * (wordCount / sentenceCount) - 21.43).toFixed(1));
-    // Coleman-Liau Index
     const L = (totalLetters / wordCount) * 100;
     const S = (sentenceCount / wordCount) * 100;
     const colemanLiau = Number((0.0588 * L - 0.296 * S - 15.8).toFixed(1));

package/dist/extensions/seo/analyzers/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/extensions/seo/analyzers/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAe,MAAM,aAAa,CAAC;AA2FlE,qCAAqC;AACrC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,iBAAiB,CA2DzE;AAID,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,cAAc,GAAG,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAC5E,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,wBAAwB,GAClF,aAAa,GAAG,aAAa,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAsMlH"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/extensions/seo/analyzers/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAe,MAAM,aAAa,CAAC;AAgKlE,qCAAqC;AACrC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAmFzE;AAID,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,cAAc,GAAG,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,GAC5E,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,wBAAwB,GAClF,aAAa,GAAG,aAAa,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAsMlH"}