webperf-snippets 1.3.0 → 1.5.0

package/snippets/Loading/Compression-Audit.js

@@ -119,18 +119,21 @@
   const issues = [];
   if (uncompressed.length > 0) {
     issues.push({
+      code: "uncompressed",
       severity: "warning",
       message: `${uncompressed.length} text resource(s) served without compression; enabling gzip or brotli could save about ${formatBytes(estimatedSavingsBytes)}`,
     });
   }
   if (corsLimitedAnalysis) {
     issues.push({
+      code: "unknown-size",
       severity: "info",
       message: `${sizeUnknownCount} cross-origin text resource(s) without Timing-Allow-Origin report zero sizes, so their compression is unknown`,
     });
   }
   if (!contentEncodingSupported && candidates.length > 0) {
     issues.push({
+      code: "content-encoding-unavailable",
       severity: "info",
       message: "PerformanceResourceTiming.contentEncoding is not available; compression is inferred from encodedBodySize versus decodedBodySize",
     });

package/snippets/Loading/Content-Visibility.js

@@ -348,9 +348,9 @@ window.analyzeContentVisibilityOpportunities = analyzeContentVisibilityOpportuni
     issues: [
       ...cvResults.autoElements
         .filter(el => el.containIntrinsicSize === "not set" || el.containIntrinsicSize === "none")
-        .map(el => ({ severity: "warning", message: `${el.selector}: missing contain-intrinsic-size (CLS risk)` })),
+        .map(el => ({ code: "missing-intrinsic-size", severity: "warning", message: `${el.selector}: missing contain-intrinsic-size (CLS risk)`, target: el.selector })),
       ...(cvResults.autoElements.length + cvResults.hiddenElements.length === 0
-        ? [{ severity: "info", message: "No content-visibility usage found. Consider content-visibility: auto on below-the-fold sections to reduce the initial render cost." }]
+        ? [{ code: "not-used", severity: "info", message: "No content-visibility usage found. Consider content-visibility: auto on below-the-fold sections to reduce the initial render cost." }]
         : []),
     ],
   };

package/snippets/Loading/Critical-CSS-Detection.js

@@ -221,6 +221,7 @@
 
   if (renderBlockingCSS.length > 0 && inlineStyles.length === 0) {
     issues.push({
+      code: "no-inline-critical-css",
       severity: "high",
       message: "No critical CSS inlined: all CSS loads via render-blocking requests",
       suggestion:
@@ -230,6 +231,7 @@
 
   if (totalRenderBlockingDecoded > criticalBudget) {
     issues.push({
+      code: "render-blocking-over-budget",
       severity: "high",
       message: `Render-blocking CSS (${formatBytes(totalRenderBlockingDecoded)}) exceeds the 14 KB critical budget`,
       suggestion:
@@ -242,6 +244,7 @@
   );
   if (largeUnpreloaded.length > 0) {
     issues.push({
+      code: "large-not-preloaded",
       severity: "medium",
       message: `${largeUnpreloaded.length} large render-blocking stylesheet(s) without preload`,
       details: largeUnpreloaded.map(
@@ -253,6 +256,7 @@
 
   if (totalInlineBytes > criticalBudget) {
     issues.push({
+      code: "inline-over-budget",
       severity: "high",
       message: `Inline CSS (${formatBytes(totalInlineBytes)}) exceeds the 14 KB critical budget`,
       suggestion:
@@ -263,6 +267,7 @@
   const bodyInlineStyles = inlineStyles.filter((s) => !s.inHead);
   if (bodyInlineStyles.length > 0) {
     issues.push({
+      code: "styles-in-body",
       severity: "medium",
       message: `${bodyInlineStyles.length} inline style block(s) found in <body>`,
       suggestion:
@@ -332,6 +337,7 @@
       corsBlocked: s.corsBlocked,
     })),
     issues: issues.map(i => ({
+      code: i.code,
       severity: i.severity === 'high' ? 'error' : 'warning',
       message: i.message,
     })),

package/snippets/Loading/Find-Above-The-Fold-Lazy-Loaded-Images.js

@@ -265,8 +265,8 @@
       isLcpCandidate: image.isLcpCandidate,
     })),
     issues: [
-      ...(results.summary.lcpAffected ? [{ severity: "error", message: 'LCP candidate image has lazy loading: remove loading="lazy" and add fetchpriority="high"' }] : []),
-      ...(results.lazyImages.filter(i => !i.isLcpCandidate).length > 0 ? [{ severity: "warning", message: `${results.lazyImages.filter(i => !i.isLcpCandidate).length} above-fold image(s) have lazy loading: remove loading="lazy"` }] : []),
+      ...(results.summary.lcpAffected ? [{ code: "lcp-lazy", severity: "error", message: 'LCP candidate image has lazy loading: remove loading="lazy" and add fetchpriority="high"' }] : []),
+      ...(results.lazyImages.filter(i => !i.isLcpCandidate).length > 0 ? [{ code: "lazy-above-fold", severity: "warning", message: `${results.lazyImages.filter(i => !i.isLcpCandidate).length} above-fold image(s) have lazy loading: remove loading="lazy"` }] : []),
     ],
   };
 })();

package/snippets/Loading/Find-Images-With-Lazy-and-Fetchpriority.js

@@ -149,7 +149,7 @@
       };
     }),
     issues: conflictingElements.length > 0
-      ? [{ severity: "error", message: `${conflictingElements.length} element(s) have conflicting loading="lazy" and fetchpriority="high"` }]
+      ? [{ code: "lazy-and-high-priority", severity: "error", message: `${conflictingElements.length} element(s) have conflicting loading="lazy" and fetchpriority="high"` }]
       : [],
   };
 })();

package/snippets/Loading/Find-non-Lazy-Loaded-Images-outside-of-the-viewport.js

@@ -304,7 +304,7 @@
       })),
     ],
     issues: totalImages > 0
-      ? [{ severity: "warning", message: `${totalImages} image(s) outside the viewport are missing loading="lazy"` }]
+      ? [{ code: "eager-off-viewport", severity: "warning", message: `${totalImages} image(s) outside the viewport are missing loading="lazy"` }]
       : [],
   };
 })();

package/snippets/Loading/Find-render-blocking-resources.js

@@ -161,7 +161,7 @@
       sizeBytes: r.size,
     })),
     issues: blockingResources.length > 0
-      ? [{ severity: "error", message: `${blockingResources.length} render-blocking resource(s) delay rendering until ${Math.round(lastBlockingEnd)}ms` }]
+      ? [{ code: "render-blocking", severity: "error", message: `${blockingResources.length} render-blocking resource(s) delay rendering until ${Math.round(lastBlockingEnd)}ms` }]
       : [],
   };
 })();

package/snippets/Loading/First-And-Third-Party-Script-Info.js

@@ -321,14 +321,15 @@
     })),
     issues: [
       ...(scripts.some((s) => !s.sizeKnown)
-        ? [{ severity: "info", message: `${scripts.filter((s) => !s.sizeKnown).length} script(s) have an unknown size (missing Timing-Allow-Origin); size totals are a lower bound` }]
+        ? [{ code: "unknown-size", severity: "info", message: `${scripts.filter((s) => !s.sizeKnown).length} script(s) have an unknown size (missing Timing-Allow-Origin); size totals are a lower bound` }]
         : []),
       ...(!renderBlockingSupported && totalScripts > 0
-        ? [{ severity: "info", message: "renderBlockingStatus is not supported in this browser (Chrome 107+), so which scripts block rendering is unknown; run the snippet in Chrome or Edge to check" }]
+        ? [{ code: "render-blocking-unsupported", severity: "info", message: "renderBlockingStatus is not supported in this browser (Chrome 107+), so which scripts block rendering is unknown; run the snippet in Chrome or Edge to check" }]
         : []),
       ...(thirdMetrics.blocking > 0
         ? [
             {
+              code: "third-party-blocking",
               severity: "error",
               message: `${thirdMetrics.blocking} render-blocking third-party script(s)`,
             },
@@ -337,6 +338,7 @@
       ...(thirdMetrics.hosts.length > 3
         ? [
             {
+              code: "many-third-party-hosts",
               severity: "warning",
               message: `${thirdMetrics.hosts.length} different third-party hosts require separate DNS lookups`,
             },
@@ -345,6 +347,7 @@
       ...(thirdMetrics.totalSize > 100 * 1024
         ? [
             {
+              code: "large-third-party",
               severity: "warning",
               message: `Third-party scripts total ${Math.round(thirdMetrics.totalSize / 1024)} KB`,
             },

package/snippets/Loading/First-And-Third-Party-Script-Timings.js

@@ -328,10 +328,10 @@
     },
     items: slowestScripts.slice(0, MAX_ITEMS).map(s => ({ shortName: s.shortName, host: s.host, firstParty: s.firstParty, totalMs: Math.round(s.total), dnsMs: roundOrNull(s.dns), tcpMs: roundOrNull(s.tcp), requestMs: roundOrNull(s.request), responseMs: roundOrNull(s.response), hasTiming: s.hasTiming })),
     issues: [
-      ...(slowScripts.length > 0 ? [{ severity: "warning", message: `${slowScripts.length} script(s) take over ${slowThreshold}ms to load` }] : []),
-      ...(hasSlowDns ? [{ severity: "warning", message: "Slow DNS lookups detected (>100ms). Add dns-prefetch or preconnect." }] : []),
-      ...(hasSlowTcp ? [{ severity: "warning", message: "Slow TCP connections detected (>100ms). Add preconnect for critical origins." }] : []),
-      ...(hasSlowRequest ? [{ severity: "warning", message: "Slow server response times detected (>200ms). Consider CDN or self-hosting." }] : []),
+      ...(slowScripts.length > 0 ? [{ code: "slow-scripts", severity: "warning", message: `${slowScripts.length} script(s) take over ${slowThreshold}ms to load` }] : []),
+      ...(hasSlowDns ? [{ code: "slow-dns", severity: "warning", message: "Slow DNS lookups detected (>100ms). Add dns-prefetch or preconnect." }] : []),
+      ...(hasSlowTcp ? [{ code: "slow-connection", severity: "warning", message: "Slow TCP connections detected (>100ms). Add preconnect for critical origins." }] : []),
+      ...(hasSlowRequest ? [{ code: "slow-server", severity: "warning", message: "Slow server response times detected (>200ms). Consider CDN or self-hosting." }] : []),
     ],
   };
 })();

package/snippets/Loading/Fonts-Preloaded-Loaded-and-used-above-the-fold.js

@@ -359,9 +359,9 @@
     items: uniqueLoadedFonts.slice(0, 50).map(f => ({ family: f.family, weight: f.weight, style: f.style, display: f.display })),
     usedFonts: usedFonts.slice(0, 50).map(f => ({ family: f.family, weight: f.weight, style: f.style, elements: f.elements })),
     issues: [
-      ...preloadedNotUsed.map(f => ({ severity: "warning", message: `Preloaded but not used above fold: ${f.name}` })),
-      ...usedNotPreloaded.map(f => ({ severity: "warning", message: `Used above fold but not preloaded: ${f.family} (${f.weight})` })),
-      ...preloadedFonts.filter(f => !f.crossorigin).map(f => ({ severity: "error", message: `Font preloaded without crossorigin (double fetch): ${f.name}` })),
+      ...preloadedNotUsed.map(f => ({ code: "preloaded-unused", severity: "warning", message: `Preloaded but not used above fold: ${f.name}`, target: f.name })),
+      ...usedNotPreloaded.map(f => ({ code: "used-not-preloaded", severity: "warning", message: `Used above fold but not preloaded: ${f.family} (${f.weight})`, target: `${f.family} (${f.weight})` })),
+      ...preloadedFonts.filter(f => !f.crossorigin).map(f => ({ code: "preload-no-crossorigin", severity: "error", message: `Font preloaded without crossorigin (double fetch): ${f.name}`, target: f.name })),
     ],
   };
 })();

package/snippets/Loading/Inline-CSS-Info-and-Size.js

@@ -146,6 +146,7 @@
 
   if (totalSize > criticalBudget) {
     issues.push({
+      code: "over-budget",
       type: "size",
       message: `Total inline CSS (${formatBytes(totalSize)}) exceeds 14 KB critical budget`,
       suggestion: "Move non-critical styles to external stylesheet",
@@ -154,6 +155,7 @@
 
   if (duplicates.length > 0) {
     issues.push({
+      code: "duplicate-blocks",
       type: "duplicate",
       message: `Found ${duplicates.length} duplicated style block(s)`,
       details: duplicates.map((d) => `Tags #${d.join(", #")} have identical content`),
@@ -164,6 +166,7 @@
   const largeBlocks = styles.filter((s) => s.size > 5 * 1024);
   if (largeBlocks.length > 0) {
     issues.push({
+      code: "large-blocks",
       type: "large",
       message: `${largeBlocks.length} style block(s) over 5 KB`,
       details: largeBlocks.map((s) => `Tag #${s.index}: ${formatBytes(s.size)}`),
@@ -174,6 +177,7 @@
   const bodyStyles = styles.filter((s) => !s.inHead);
   if (bodyStyles.length > 0) {
     issues.push({
+      code: "styles-in-body",
       type: "location",
       message: `${bodyStyles.length} style block(s) in <body>`,
       details: bodyStyles.map((s) => `Tag #${s.index}`),
@@ -231,6 +235,6 @@
       bodyStyleBlocks: styles.filter(s => !s.inHead).length,
     },
     items: styles.map(s => ({ index: s.index, sizeBytes: s.size, parent: s.parent, inHead: s.inHead, ruleCount: s.ruleCount, hasMediaQueries: s.hasMediaQueries, hasKeyframes: s.hasKeyframes })),
-    issues: issues.map(i => ({ severity: "warning", message: i.message })),
+    issues: issues.map(i => ({ code: i.code, severity: "warning", message: i.message })),
   };
 })();

package/snippets/Loading/Inline-Script-Info-and-Size.js

@@ -239,6 +239,7 @@
 
   if (parserBlockingInHead.length > 0) {
     issues.push({
+      code: "parser-blocking-in-head",
       type: "blocking",
       message: `${parserBlockingInHead.length} parser-blocking script(s) in <head>`,
       details: parserBlockingInHead.map(
@@ -251,6 +252,7 @@
   const largeScripts = executableScripts.filter((s) => s.size > 2 * 1024);
   if (largeScripts.length > 0) {
     issues.push({
+      code: "large-inline",
       type: "large",
       message: `${largeScripts.length} script(s) over 2 KB`,
       details: largeScripts.map((s) => `Script #${s.index}: ${formatBytes(s.size)}`),
@@ -260,6 +262,7 @@
 
   if (duplicates.length > 0) {
     issues.push({
+      code: "duplicate-scripts",
       type: "duplicate",
       message: `${duplicates.length} duplicated script(s) detected`,
       details: duplicates.map((d) => `Scripts #${d.join(", #")} have identical content`),
@@ -272,6 +275,7 @@
   );
   if (analyticsInHead.length > 0) {
     issues.push({
+      code: "analytics-in-head",
       type: "analytics",
       message: `${analyticsInHead.length} analytics script(s) blocking in <head>`,
       details: analyticsInHead.map((s) => `Script #${s.index}`),
@@ -345,6 +349,6 @@
       dataPayloadCount: scripts.filter((s) => s.isDataPayload).length,
     },
     items: rankedScripts.slice(0, MAX_ITEMS).map(s => ({ index: s.index, sizeBytes: s.size, category: s.category, inHead: s.inHead, isParserBlocking: s.isParserBlocking, isAnalytics: s.isAnalytics, isConfig: s.isConfig, isDataPayload: s.isDataPayload })),
-    issues: issues.map(i => ({ severity: i.type === "blocking" ? "error" : "warning", message: i.message })),
+    issues: issues.map(i => ({ code: i.code, severity: i.type === "blocking" ? "error" : "warning", message: i.message })),
   };
 })();

package/snippets/Loading/JS-Execution-Time-Breakdown.js

@@ -348,10 +348,10 @@
     },
     items: scripts.slice(0, 50).map(s => ({ shortName: s.shortName, isBlocking: s.isBlocking, downloadMs: Math.round(s.downloadDuration), estimatedParseMobileMs: s.estimatedParseMobile, transferBytes: s.transferSize, decodedBytes: s.decodedSize, corsRestricted: s.corsRestricted })),
     issues: [
-      ...(blocking.length > 0 ? [{ severity: "error", message: `${blocking.length} render-blocking script(s) delay HTML parsing` }] : []),
-      ...(hasHighParseTime ? [{ severity: "warning", message: `High estimated parse cost (~${Math.round(totalEstParse)}ms on mobile)` }] : []),
-      ...(splitCandidates.length > 0 ? [{ severity: "warning", message: `${splitCandidates.length} script(s) over 50KB decoded. Consider code splitting.` }] : []),
-      ...(poorCompression ? [{ severity: "warning", message: `Low compression ratio (${compressionRatio.toFixed(1)}x). Enable Brotli or gzip.` }] : []),
+      ...(blocking.length > 0 ? [{ code: "render-blocking", severity: "error", message: `${blocking.length} render-blocking script(s) delay HTML parsing` }] : []),
+      ...(hasHighParseTime ? [{ code: "high-parse-cost", severity: "warning", message: `High estimated parse cost (~${Math.round(totalEstParse)}ms on mobile)` }] : []),
+      ...(splitCandidates.length > 0 ? [{ code: "split-candidates", severity: "warning", message: `${splitCandidates.length} script(s) over 50KB decoded. Consider code splitting.` }] : []),
+      ...(poorCompression ? [{ code: "low-compression", severity: "warning", message: `Low compression ratio (${compressionRatio.toFixed(1)}x). Enable Brotli or gzip.` }] : []),
     ],
   };
 })();

package/snippets/Loading/Prefetch-Resource-Validation.js

@@ -28,7 +28,7 @@
       status: "ok",
       count: 0,
       items: [],
-      issues: [{ severity: "info", message: 'No prefetch hints on this page (rel="prefetch"), so there was nothing to validate.' }],
+      issues: [{ code: "no-prefetch", severity: "info", message: 'No prefetch hints on this page (rel="prefetch"), so there was nothing to validate.' }],
     };
   }
 
@@ -116,12 +116,14 @@
     // Check for missing or invalid 'as' attribute
     if (as === "unknown") {
       analysis.warnings.push({
+        code: "missing-as",
         type: "missing-as",
         severity: "warning",
         message: "Missing 'as' attribute - browser cannot apply correct MIME type matching",
       });
     } else if (!validAsValues.has(as)) {
       analysis.warnings.push({
+        code: "invalid-as",
         type: "invalid-as",
         severity: "warning",
         message: `Invalid 'as' value: "${as}" - should be one of: ${Array.from(validAsValues).join(", ")}`,
@@ -131,6 +133,7 @@
     // Check for duplicate prefetch
     if (seenUrls.has(normalizedUrl)) {
       analysis.warnings.push({
+        code: "duplicate-prefetch",
         type: "duplicate-prefetch",
         severity: "warning",
         message: "Duplicate prefetch - this URL is prefetched multiple times",
@@ -169,6 +172,7 @@
       if (isCurrentPageResource) {
         analysis.isCurrentPage = true;
         analysis.warnings.push({
+          code: "used-on-current-page",
           type: "wrong-hint",
           severity: "error",
           message: "Resource used on current page - should use preload instead",
@@ -179,6 +183,7 @@
       if (analysis.size > THRESHOLDS.largeFileSize) {
         const sizeMB = (analysis.size / (1024 * 1024)).toFixed(2);
         analysis.warnings.push({
+          code: "large-file",
           type: "large-file",
           severity: "warning",
           message: `Large file (${sizeMB}MB) - consider if prefetch is appropriate`,
@@ -203,6 +208,7 @@
 
       if (isInappropriate) {
         analysis.warnings.push({
+          code: "inappropriate-type",
           type: "inappropriate-type",
           severity: "warning",
           message: `Type "${as}" may not be suitable for prefetch: ${inappropriateReason}`,
@@ -229,6 +235,7 @@
   const countIssues = [];
   if (prefetchLinks.length > THRESHOLDS.maxCount) {
     countIssues.push({
+      code: "too-many-prefetches",
       type: "excessive-count",
       severity: "warning",
       message: `${prefetchLinks.length} prefetch hints found (recommended: <${THRESHOLDS.maxCount})`,
@@ -242,6 +249,7 @@
 
   if (totalSize > THRESHOLDS.totalSizeCritical) {
     countIssues.push({
+      code: "large-total-size",
       type: "excessive-size",
       severity: "error",
       message: `Total prefetch size: ${totalSizeMB}MB (critical threshold exceeded)`,
@@ -249,6 +257,7 @@
     });
   } else if (totalSize > THRESHOLDS.totalSizeWarning) {
     countIssues.push({
+      code: "large-total-size",
       type: "high-size",
       severity: "warning",
       message: `Total prefetch size: ${totalSizeMB}MB (warning threshold exceeded)`,
@@ -463,8 +472,8 @@
     },
     items: [...validPrefetch, ...issues].map(item => ({ href: item.shortUrl, as: item.as, sizeBytes: item.size, loaded: item.loaded, isCurrentPage: item.isCurrentPage || false })),
     issues: [
-      ...countIssues.map(i => ({ severity: i.severity === "error" ? "error" : "warning", message: i.message })),
-      ...issues.flatMap(item => item.warnings.filter(w => w.severity !== "info").map(w => ({ severity: w.severity, message: `${item.shortUrl}: ${w.message}` }))),
+      ...countIssues.map(i => ({ code: i.code, severity: i.severity === "error" ? "error" : "warning", message: i.message })),
+      ...issues.flatMap(item => item.warnings.filter(w => w.severity !== "info").map(w => ({ code: w.code, severity: w.severity, message: `${item.shortUrl}: ${w.message}`, target: item.href }))),
     ],
   };
 })();

package/snippets/Loading/Priority-Hints-Audit.js

@@ -77,8 +77,10 @@
     .filter((link) => link.getAttribute("fetchpriority") === "low")
     .forEach((link) => {
       issues.push({
+        code: "preload-low-priority",
         severity: "error",
         element: link,
+        url: link.href,
         resource: shortUrl(link),
         message: 'preload + fetchpriority="low" is contradictory',
         detail:
@@ -94,8 +96,10 @@
       const entry = getEntry(el);
       if (entry && entry.startTime < 500) {
         issues.push({
+          code: "low-priority-loaded-early",
           severity: "warning",
           element: el,
+          url: el.src || el.href,
           resource: shortUrl(el),
           message: `fetchpriority="low" but loaded at ${entry.startTime.toFixed(0)}ms`,
           detail:
@@ -112,8 +116,10 @@
       const entry = getEntry(el);
       if (entry && entry.startTime > 3000) {
         issues.push({
+          code: "high-priority-loaded-late",
           severity: "warning",
           element: el,
+          url: el.src || el.href,
           resource: shortUrl(el),
           message: `fetchpriority="high" but loaded at ${entry.startTime.toFixed(0)}ms`,
           detail:
@@ -127,8 +133,10 @@
   if (lcpCandidate && lcpCandidate.getAttribute("fetchpriority") !== "high") {
     const fp = lcpCandidate.getAttribute("fetchpriority");
     issues.push({
+      code: "lcp-no-fetchpriority",
       severity: "warning",
       element: lcpCandidate,
+      url: lcpCandidate.currentSrc || lcpCandidate.src,
       resource:
         (lcpCandidate.currentSrc || lcpCandidate.src).split("/").pop()?.split("?")[0] ||
         "LCP image",
@@ -340,8 +348,10 @@
       resource: (el.src || el.href || el.getAttribute("href") || "").split("/").pop()?.split("?")[0] || "",
     })),
     issues: issues.map(i => ({
+      code: i.code,
       severity: i.severity,
       message: i.fix ? `${i.message.replace(/\.$/, "")}. Fix: ${i.fix}` : i.message,
+      ...(i.url ? { target: i.url } : {}),
     })),
   };
 })();

package/snippets/Loading/Resource-Hints-Validation.js

@@ -538,9 +538,9 @@
       })),
     ].slice(0, 50),
     issues: [
-      ...(totalIssues > 0 ? [{ severity: "warning", message: `${totalIssues} unused hint(s) waste bandwidth` }] : []),
-      ...(missingHints.length > 0 ? [{ severity: "info", message: `${missingHints.length} domain(s) could benefit from connection hints` }] : []),
-      ...(redundantDomains.length > 0 ? [{ severity: "warning", message: `${redundantDomains.length} domain(s) have both preconnect and dns-prefetch (redundant)` }] : []),
+      ...(totalIssues > 0 ? [{ code: "unused-hints", severity: "warning", message: `${totalIssues} unused hint(s) waste bandwidth` }] : []),
+      ...(missingHints.length > 0 ? [{ code: "missing-connection-hints", severity: "info", message: `${missingHints.length} domain(s) could benefit from connection hints` }] : []),
+      ...(redundantDomains.length > 0 ? [{ code: "redundant-hints", severity: "warning", message: `${redundantDomains.length} domain(s) have both preconnect and dns-prefetch (redundant)` }] : []),
     ],
   };
 })();

package/snippets/Loading/Resource-Hints.js

@@ -93,6 +93,7 @@
       if (type.requiresAs && !hint.as) {
         issues.push({
           hint,
+          code: "preload-missing-as",
           issue: "Missing 'as' attribute (required for preload)",
           severity: "error",
           fix: `Add as="script|style|font|image|fetch"`,
@@ -102,6 +103,7 @@
       if (hint.as === "font" && !hint.crossorigin) {
         issues.push({
           hint,
+          code: "font-preload-no-crossorigin",
           issue: "Font preload without crossorigin (causes double fetch)",
           severity: "error",
           fix: 'Add crossorigin="anonymous"',
@@ -122,6 +124,7 @@
         if (corsResources.length > 0) {
           issues.push({
             hint,
+            code: "preconnect-no-crossorigin",
             issue: "Preconnect may need crossorigin for CORS resources",
             severity: "warning",
             fix: 'Consider adding crossorigin="anonymous"',
@@ -140,6 +143,7 @@
     if (!wasUsed) {
       issues.push({
         hint: preload,
+        code: "unused-preload",
         issue: "Preloaded resource not used within page load",
         severity: "warning",
         fix: "Remove unused preload or verify it's needed",
@@ -162,6 +166,7 @@
     if (!hasResources && pc.hostname) {
       issues.push({
         hint: pc,
+        code: "unused-preconnect",
         issue: `No resources loaded from ${pc.hostname}`,
         severity: "warning",
         fix: "Remove unused preconnect or verify it's needed for future resources",
@@ -173,6 +178,7 @@
   if (preloads.length > 6) {
     issues.push({
       hint: { rel: "preload", href: `${preloads.length} preloads` },
+      code: "too-many-preloads",
       issue: `Too many preloads (${preloads.length}) - they compete for bandwidth`,
       severity: "warning",
       fix: "Limit to 5-6 most critical resources",
@@ -424,6 +430,6 @@
       })),
     },
     items: rankedHints.slice(0, MAX_ITEMS).map(h => ({ rel: h.rel, href: h.shortHref, as: h.as, crossorigin: h.crossorigin, fetchpriority: h.fetchpriority })),
-    issues: issues.map(i => ({ severity: i.severity, message: `${i.hint.rel}: ${i.issue}. Fix: ${i.fix}` })),
+    issues: issues.map(i => ({ code: i.code, severity: i.severity, message: `${i.hint.rel}: ${i.issue}. Fix: ${i.fix}`, ...(i.hint.element ? { target: i.hint.href } : {}) })),
   };
 })();

package/snippets/Loading/SSR-Hydration-Data-Analysis.js

@@ -178,8 +178,10 @@
   detected.forEach((fw) => {
     if (fw.exceedsThreshold) {
       issuesData.push({
+        code: "large-hydration-data",
         severity: "warning",
         message: `${fw.name} hydration data (${Math.round(fw.size / 1024)} KB) exceeds ${Math.round(fw.threshold / 1024)} KB threshold`,
+        target: fw.name,
       });
     }
     console.log("");
@@ -296,13 +298,14 @@
             });
           });
           if (largeArrays.length > 0) {
-            issuesData.push({ severity: "warning", message: `pageProps has large arrays (${largeArrays.join(", ")}). Consider pagination.` });
+            issuesData.push({ code: "large-arrays", severity: "warning", message: `pageProps has large arrays (${largeArrays.join(", ")}). Consider pagination.` });
           }
           if (checkDepth(pageProps)) {
-            issuesData.push({ severity: "warning", message: "pageProps contains deeply nested data (more than 5 levels)." });
+            issuesData.push({ code: "deep-nesting", severity: "warning", message: "pageProps contains deeply nested data (more than 5 levels)." });
           }
           if (sensitiveKeys.length > 0) {
             issuesData.push({
+              code: "sensitive-keys",
               severity: "warning",
               message: `pageProps has keys that look sensitive (${sensitiveKeys.slice(0, 5).join(", ")}). Everything in pageProps is sent to every visitor.`,
             });

package/snippets/Loading/Script-Loading.js

@@ -226,6 +226,7 @@
 
   if (blockingInHead.length > 0) {
     issues.push({
+      code: "blocking-in-head",
       severity: "error",
       message: `${blockingInHead.length} blocking script(s) in <head>`,
       scripts: blockingInHead,
@@ -235,6 +236,7 @@
 
   if (thirdPartyBlocking.length > 0) {
     issues.push({
+      code: "third-party-blocking",
       severity: "error",
       message: `${thirdPartyBlocking.length} third-party blocking script(s)`,
       scripts: thirdPartyBlocking,
@@ -245,6 +247,7 @@
   const largeBlocking = blocking.filter((s) => s.size > 50 * 1024);
   if (largeBlocking.length > 0) {
     issues.push({
+      code: "large-blocking",
       severity: "warning",
       message: `${largeBlocking.length} large blocking script(s) (> 50 KB)`,
       scripts: largeBlocking,
@@ -262,6 +265,7 @@
 
   if (couldDefer.length > 0 && blocking.length > couldDefer.length) {
     issues.push({
+      code: "could-defer",
       severity: "info",
       message: `${blocking.length - couldDefer.length} blocking script(s) could potentially use defer`,
       fix: "Test with defer attribute to improve parsing performance",
@@ -391,9 +395,9 @@
       durationMs: Math.round(s.duration),
     })),
     issues: [
-      ...issues.map((i) => ({ severity: i.severity, message: i.message })),
+      ...issues.map((i) => ({ code: i.code, severity: i.severity, message: i.message })),
       ...(scripts.some((s) => !s.sizeKnown)
-        ? [{ severity: "info", message: `${scripts.filter((s) => !s.sizeKnown).length} script(s) have an unknown size (missing Timing-Allow-Origin); total size is a lower bound` }]
+        ? [{ code: "unknown-size", severity: "info", message: `${scripts.filter((s) => !s.sizeKnown).length} script(s) have an unknown size (missing Timing-Allow-Origin); total size is a lower bound` }]
         : []),
     ],
   };

package/snippets/Loading/Server-Timing-Early-Hints.js

@@ -83,6 +83,7 @@
   const issues = [];
   if (nav.serverTiming.length === 0) {
     issues.push({
+      code: "no-server-timing",
       severity: "info",
       message:
         "The document response sends no Server-Timing header. Add one, for example Server-Timing: db;dur=53, to expose backend timings in DevTools and in the Performance API.",
@@ -90,12 +91,14 @@
   }
   if (corsRestrictedCount > 0) {
     issues.push({
+      code: "timing-hidden",
       severity: "info",
       message: `${corsRestrictedCount} cross-origin resource(s) hide their timing because they lack Timing-Allow-Origin, so their Server-Timing cannot be read. Add Timing-Allow-Origin to expose it.`,
     });
   }
   if (!earlyHintsReceived) {
     issues.push({
+      code: "no-early-hints",
       severity: "info",
       message:
         "No 103 Early Hints response was observed for the document. If the server can send Link preload or preconnect headers before the final response, Early Hints lets the browser start those fetches earlier.",