lighthouse 12.4.0-dev.20250318 → 12.4.0-dev.20250320

package/core/audits/audit.js

@@ -491,7 +491,9 @@ class Audit {
     const trace = artifacts.traces[Audit.DEFAULT_PASS];
     const devtoolsLog = artifacts.devtoolsLogs[Audit.DEFAULT_PASS];
     const gatherContext = artifacts.GatherContext;
-    return {trace, devtoolsLog, gatherContext, settings: context.settings, URL: artifacts.URL};
+    const {URL, SourceMaps} = artifacts;
+    // eslint-disable-next-line max-len
+    return {trace, devtoolsLog, gatherContext, settings: context.settings, URL, SourceMaps, simulator: null};
   }
 }
 

package/core/audits/bootup-time.js

@@ -49,7 +49,7 @@ class BootupTime extends Audit {
       description: str_(UIStrings.description),
       scoreDisplayMode: Audit.SCORING_MODES.METRIC_SAVINGS,
       guidanceLevel: 1,
-      requiredArtifacts: ['traces', 'devtoolsLogs', 'URL', 'GatherContext'],
+      requiredArtifacts: ['traces', 'devtoolsLogs', 'URL', 'GatherContext', 'SourceMaps'],
     };
   }
 

package/core/audits/byte-efficiency/efficient-animated-content.js

@@ -38,7 +38,7 @@ class EfficientAnimatedContent extends ByteEfficiencyAudit {
       description: str_(UIStrings.description),
       scoreDisplayMode: ByteEfficiencyAudit.SCORING_MODES.METRIC_SAVINGS,
       guidanceLevel: 3,
-      requiredArtifacts: ['devtoolsLogs', 'traces', 'GatherContext', 'URL'],
+      requiredArtifacts: ['devtoolsLogs', 'traces', 'GatherContext', 'URL', 'SourceMaps'],
     };
   }
 

package/core/audits/byte-efficiency/modern-image-formats.js

@@ -37,7 +37,7 @@ class ModernImageFormats extends ByteEfficiencyAudit {
       scoreDisplayMode: ByteEfficiencyAudit.SCORING_MODES.METRIC_SAVINGS,
       guidanceLevel: 3,
       requiredArtifacts: ['OptimizedImages', 'devtoolsLogs', 'traces', 'URL', 'GatherContext',
-        'ImageElements'],
+        'ImageElements', 'SourceMaps'],
     };
   }
 

package/core/audits/byte-efficiency/offscreen-images.js

@@ -52,7 +52,7 @@ class OffscreenImages extends ByteEfficiencyAudit {
       supportedModes: ['navigation'],
       guidanceLevel: 2,
       requiredArtifacts: ['ImageElements', 'ViewportDimensions', 'GatherContext', 'devtoolsLogs',
-        'traces', 'URL'],
+        'traces', 'URL', 'SourceMaps'],
     };
   }
 
@@ -163,12 +163,12 @@ class OffscreenImages extends ByteEfficiencyAudit {
    * @return {Promise<import('./byte-efficiency-audit.js').ByteEfficiencyProduct>}
    */
   static async audit_(artifacts, networkRecords, context) {
+    const {URL, SourceMaps} = artifacts;
     const images = artifacts.ImageElements;
     const viewportDimensions = artifacts.ViewportDimensions;
     const gatherContext = artifacts.GatherContext;
     const trace = artifacts.traces[ByteEfficiencyAudit.DEFAULT_PASS];
     const devtoolsLog = artifacts.devtoolsLogs[ByteEfficiencyAudit.DEFAULT_PASS];
-    const URL = artifacts.URL;
 
     /** @type {string[]} */
     const warnings = [];
@@ -199,7 +199,8 @@ class OffscreenImages extends ByteEfficiencyAudit {
     const unfilteredResults = Array.from(resultsMap.values());
     // get the interactive time or fallback to getting the end of trace time
     try {
-      const metricComputationData = {trace, devtoolsLog, gatherContext, settings, URL};
+      const metricComputationData =
+        {trace, devtoolsLog, gatherContext, settings, URL, SourceMaps, simulator: null};
       const interactive = await Interactive.request(metricComputationData, context);
 
       // use interactive to generate items

package/core/audits/byte-efficiency/render-blocking-resources.js

@@ -112,7 +112,8 @@ class RenderBlockingResources extends Audit {
       // TODO: look into adding an `optionalArtifacts` property that captures the non-required nature
       // of CSSUsage
       requiredArtifacts:
-        ['URL', 'traces', 'devtoolsLogs', 'Stylesheets', 'CSSUsage', 'GatherContext', 'Stacks'],
+        // eslint-disable-next-line max-len
+        ['URL', 'traces', 'devtoolsLogs', 'Stylesheets', 'CSSUsage', 'GatherContext', 'Stacks', 'SourceMaps'],
     };
   }
 
@@ -126,10 +127,11 @@ class RenderBlockingResources extends Audit {
     const gatherContext = artifacts.GatherContext;
     const trace = artifacts.traces[Audit.DEFAULT_PASS];
     const devtoolsLog = artifacts.devtoolsLogs[Audit.DEFAULT_PASS];
+    const SourceMaps = artifacts.SourceMaps;
     const simulatorData = {devtoolsLog, settings: context.settings};
     const simulator = await LoadSimulator.request(simulatorData, context);
     const wastedCssBytes = await RenderBlockingResources.computeWastedCSSBytes(artifacts, context);
-    const navInsights = await NavigationInsights.request({trace, settings}, context);
+    const navInsights = await NavigationInsights.request({trace, settings, SourceMaps}, context);
 
     const renderBlocking = navInsights.model.RenderBlocking;
     if (renderBlocking instanceof Error) throw renderBlocking;
@@ -141,7 +143,7 @@ class RenderBlockingResources extends Audit {
     };
 
     const metricComputationData = {trace, devtoolsLog, gatherContext, simulator,
-      settings: metricSettings, URL: artifacts.URL};
+      settings: metricSettings, URL: artifacts.URL, SourceMaps: artifacts.SourceMaps};
 
     // Cast to just `LanternMetric` since we explicitly set `throttlingMethod: 'simulate'`.
     const fcpSimulation = /** @type {LH.Artifacts.LanternMetric} */

package/core/audits/byte-efficiency/unminified-css.js

@@ -37,7 +37,8 @@ class UnminifiedCSS extends ByteEfficiencyAudit {
       description: str_(UIStrings.description),
       scoreDisplayMode: ByteEfficiencyAudit.SCORING_MODES.METRIC_SAVINGS,
       guidanceLevel: 3,
-      requiredArtifacts: ['Stylesheets', 'devtoolsLogs', 'traces', 'URL', 'GatherContext'],
+      requiredArtifacts: ['Stylesheets', 'devtoolsLogs', 'traces', 'URL', 'GatherContext',
+        'SourceMaps'],
     };
   }
 

package/core/audits/byte-efficiency/unminified-javascript.js

@@ -44,7 +44,8 @@ class UnminifiedJavaScript extends ByteEfficiencyAudit {
       description: str_(UIStrings.description),
       scoreDisplayMode: ByteEfficiencyAudit.SCORING_MODES.METRIC_SAVINGS,
       guidanceLevel: 3,
-      requiredArtifacts: ['Scripts', 'devtoolsLogs', 'traces', 'GatherContext', 'URL'],
+      requiredArtifacts: ['Scripts', 'devtoolsLogs', 'traces', 'GatherContext', 'URL',
+        'SourceMaps'],
     };
   }
 

package/core/audits/byte-efficiency/unused-css-rules.js

@@ -35,7 +35,7 @@ class UnusedCSSRules extends ByteEfficiencyAudit {
       scoreDisplayMode: ByteEfficiencyAudit.SCORING_MODES.METRIC_SAVINGS,
       guidanceLevel: 1,
       requiredArtifacts:
-        ['Stylesheets', 'CSSUsage', 'URL', 'devtoolsLogs', 'traces', 'GatherContext'],
+        ['Stylesheets', 'CSSUsage', 'URL', 'devtoolsLogs', 'traces', 'GatherContext', 'SourceMaps'],
     };
   }
 

package/core/audits/byte-efficiency/unused-javascript.js

@@ -69,7 +69,7 @@ class UnusedJavaScript extends ByteEfficiencyAudit {
       scoreDisplayMode: ByteEfficiencyAudit.SCORING_MODES.METRIC_SAVINGS,
       guidanceLevel: 1,
       requiredArtifacts: ['JsUsage', 'Scripts', 'SourceMaps', 'GatherContext',
-        'devtoolsLogs', 'traces', 'URL'],
+        'devtoolsLogs', 'traces', 'URL', 'SourceMaps'],
     };
   }
 
@@ -94,7 +94,7 @@ class UnusedJavaScript extends ByteEfficiencyAudit {
       const script = artifacts.Scripts.find(s => s.scriptId === scriptId);
       if (!script) continue; // This should never happen.
 
-      const bundle = bundles.find(b => b.script.scriptId === scriptId);
+      const bundle = bundles.find(b => b.script.scriptId === scriptId) ?? null;
       const unusedJsSummary =
         await UnusedJavascriptSummary.request({scriptId, scriptCoverage, bundle}, context);
       if (unusedJsSummary.wastedBytes === 0 || unusedJsSummary.totalBytes === 0) continue;

package/core/audits/byte-efficiency/uses-long-cache-ttl.js

@@ -46,7 +46,7 @@ class CacheHeaders extends Audit {
       description: str_(UIStrings.description),
       scoreDisplayMode: Audit.SCORING_MODES.METRIC_SAVINGS,
       guidanceLevel: 3,
-      requiredArtifacts: ['devtoolsLogs'],
+      requiredArtifacts: ['devtoolsLogs', 'SourceMaps'],
     };
   }
 

package/core/audits/byte-efficiency/uses-optimized-images.js

@@ -37,7 +37,7 @@ class UsesOptimizedImages extends ByteEfficiencyAudit {
       scoreDisplayMode: ByteEfficiencyAudit.SCORING_MODES.METRIC_SAVINGS,
       guidanceLevel: 2,
       requiredArtifacts: ['OptimizedImages', 'ImageElements', 'GatherContext', 'devtoolsLogs',
-        'traces', 'URL'],
+        'traces', 'URL', 'SourceMaps'],
     };
   }
 

package/core/audits/byte-efficiency/uses-responsive-images.js

@@ -48,7 +48,7 @@ class UsesResponsiveImages extends ByteEfficiencyAudit {
       scoreDisplayMode: ByteEfficiencyAudit.SCORING_MODES.METRIC_SAVINGS,
       guidanceLevel: 2,
       requiredArtifacts: ['ImageElements', 'ViewportDimensions', 'GatherContext',
-        'devtoolsLogs', 'traces', 'URL'],
+        'devtoolsLogs', 'traces', 'URL', 'SourceMaps'],
     };
   }
 

package/core/audits/byte-efficiency/uses-text-compression.js

@@ -38,7 +38,8 @@ class ResponsesAreCompressed extends ByteEfficiencyAudit {
       description: str_(UIStrings.description),
       scoreDisplayMode: ByteEfficiencyAudit.SCORING_MODES.METRIC_SAVINGS,
       guidanceLevel: 3,
-      requiredArtifacts: ['ResponseCompression', 'GatherContext', 'devtoolsLogs', 'traces', 'URL'],
+      requiredArtifacts: ['ResponseCompression', 'GatherContext', 'devtoolsLogs', 'traces', 'URL',
+        'SourceMaps'],
     };
   }
 

package/core/audits/critical-request-chains.js

@@ -38,7 +38,7 @@ class CriticalRequestChains extends Audit {
       scoreDisplayMode: Audit.SCORING_MODES.INFORMATIVE,
       supportedModes: ['navigation'],
       guidanceLevel: 1,
-      requiredArtifacts: ['traces', 'devtoolsLogs', 'URL'],
+      requiredArtifacts: ['traces', 'devtoolsLogs', 'URL', 'SourceMaps'],
     };
   }
 
@@ -171,8 +171,9 @@ class CriticalRequestChains extends Audit {
     const settings = context.settings;
     const trace = artifacts.traces[Audit.DEFAULT_PASS];
     const devtoolsLog = artifacts.devtoolsLogs[Audit.DEFAULT_PASS];
-    const URL = artifacts.URL;
-    const chains = await ComputedChains.request({settings, devtoolsLog, trace, URL}, context);
+    const {URL, SourceMaps} = artifacts;
+    const chains =
+      await ComputedChains.request({settings, devtoolsLog, trace, URL, SourceMaps}, context);
     let chainCount = 0;
     /**
      * @param {LH.Audit.Details.SimpleCriticalRequestNode} node

package/core/audits/dobetterweb/dom-size.js

@@ -56,7 +56,7 @@ class DOMSize extends Audit {
       scoreDisplayMode: Audit.SCORING_MODES.METRIC_SAVINGS,
       guidanceLevel: 1,
       requiredArtifacts: ['DOMStats', 'URL', 'GatherContext'],
-      __internalOptionalArtifacts: ['traces', 'devtoolsLogs'],
+      __internalOptionalArtifacts: ['traces', 'devtoolsLogs', 'SourceMaps'],
     };
   }
 

package/core/audits/dobetterweb/uses-http2.js

@@ -58,7 +58,7 @@ class UsesHTTP2Audit extends Audit {
       scoreDisplayMode: Audit.SCORING_MODES.METRIC_SAVINGS,
       guidanceLevel: 3,
       supportedModes: ['timespan', 'navigation'],
-      requiredArtifacts: ['URL', 'devtoolsLogs', 'traces', 'GatherContext'],
+      requiredArtifacts: ['URL', 'devtoolsLogs', 'traces', 'GatherContext', 'SourceMaps'],
     };
   }
 

package/core/audits/insights/cls-culprits-insight.js

@@ -39,7 +39,7 @@ class CLSCulpritsInsight extends Audit {
       failureTitle: insightStr_(InsightUIStrings.title),
       description: insightStr_(InsightUIStrings.description),
       guidanceLevel: 3,
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
       replacesAudits: ['layout-shifts', 'non-composited-animations', 'unsized-images'],
     };
   }

package/core/audits/insights/document-latency-insight.js

@@ -24,7 +24,7 @@ class DocumentLatencyInsight extends Audit {
       failureTitle: str_(UIStrings.title),
       description: str_(UIStrings.description),
       guidanceLevel: 3,
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
       replacesAudits: ['redirects', 'server-response-time', 'uses-text-compression'],
     };
   }

package/core/audits/insights/dom-size-insight.js

@@ -24,7 +24,7 @@ class DOMSizeInsight extends Audit {
       failureTitle: str_(UIStrings.title),
       description: str_(UIStrings.description),
       guidanceLevel: 3,
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
       replacesAudits: ['dom-size'],
     };
   }

package/core/audits/insights/duplicated-javascript-insight.d.ts

@@ -0,0 +1,11 @@
+export default DuplicatedJavaScriptInsight;
+declare class DuplicatedJavaScriptInsight extends Audit {
+    /**
+     * @param {LH.Artifacts} artifacts
+     * @param {LH.Audit.Context} context
+     * @return {Promise<LH.Audit.Product>}
+     */
+    static audit(artifacts: LH.Artifacts, context: LH.Audit.Context): Promise<LH.Audit.Product>;
+}
+import { Audit } from '../audit.js';
+//# sourceMappingURL=duplicated-javascript-insight.d.ts.map

package/core/audits/insights/{duplicate-javascript-insight.js → duplicated-javascript-insight.js}

@@ -6,27 +6,27 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import {UIStrings} from '@paulirish/trace_engine/models/trace/insights/DuplicateJavaScript.js';
+import {UIStrings} from '@paulirish/trace_engine/models/trace/insights/DuplicatedJavaScript.js';
 
 import {Audit} from '../audit.js';
 import * as i18n from '../../lib/i18n/i18n.js';
 import {adaptInsightToAuditProduct, makeNodeItemForNodeId} from './insight-audit.js';
 
 // eslint-disable-next-line max-len
-const str_ = i18n.createIcuMessageFn('node_modules/@paulirish/trace_engine/models/trace/insights/DuplicateJavaScript.js', UIStrings);
+const str_ = i18n.createIcuMessageFn('node_modules/@paulirish/trace_engine/models/trace/insights/DuplicatedJavaScript.js', UIStrings);
 
-class DuplicateJavaScriptInsight extends Audit {
+class DuplicatedJavaScriptInsight extends Audit {
   /**
    * @return {LH.Audit.Meta}
    */
   static get meta() {
     return {
-      id: 'duplicate-javascript-insight',
+      id: 'duplicated-javascript-insight',
       title: str_(UIStrings.title),
       failureTitle: str_(UIStrings.title),
       description: str_(UIStrings.description),
       guidanceLevel: 3, // TODO: confirm/change.
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
     };
   }
 
@@ -37,7 +37,7 @@ class DuplicateJavaScriptInsight extends Audit {
    */
   static async audit(artifacts, context) {
     // TODO: implement.
-    return adaptInsightToAuditProduct(artifacts, context, 'DuplicateJavaScript', (insight) => {
+    return adaptInsightToAuditProduct(artifacts, context, 'DuplicatedJavaScript', (insight) => {
       /** @type {LH.Audit.Details.Table['headings']} */
       const headings = [
         /* eslint-disable max-len */
@@ -51,4 +51,4 @@ class DuplicateJavaScriptInsight extends Audit {
   }
 }
 
-export default DuplicateJavaScriptInsight;
+export default DuplicatedJavaScriptInsight;

package/core/audits/insights/font-display-insight.js

@@ -24,7 +24,7 @@ class FontDisplayInsight extends Audit {
       failureTitle: str_(UIStrings.title),
       description: str_(UIStrings.description),
       guidanceLevel: 3,
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
       replacesAudits: ['font-display'],
     };
   }

package/core/audits/insights/forced-reflow-insight.d.ts

@@ -1,5 +1,15 @@
 export default ForcedReflowInsight;
 declare class ForcedReflowInsight extends Audit {
+    /**
+     * @param {import('@paulirish/trace_engine/models/trace/insights/ForcedReflow.js').ForcedReflowAggregatedData} topLevelFunctionCallData
+     * @returns {LH.Audit.Details.Table}
+     */
+    static makeTopFunctionTable(topLevelFunctionCallData: import("@paulirish/trace_engine/models/trace/insights/ForcedReflow.js").ForcedReflowAggregatedData): LH.Audit.Details.Table;
+    /**
+     * @param {import('@paulirish/trace_engine/models/trace/insights/ForcedReflow.js').ForcedReflowInsightModel} insight
+     * @returns {LH.Audit.Details.Table}
+     */
+    static makeBottomUpTable(insight: import("@paulirish/trace_engine/models/trace/insights/ForcedReflow.js").ForcedReflowInsightModel): LH.Audit.Details.Table;
     /**
      * @param {LH.Artifacts} artifacts
      * @param {LH.Audit.Context} context

package/core/audits/insights/forced-reflow-insight.js

@@ -1,5 +1,3 @@
-/* eslint-disable no-unused-vars */ // TODO: remove once implemented.
-
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -10,7 +8,7 @@ import {UIStrings} from '@paulirish/trace_engine/models/trace/insights/ForcedRef
 
 import {Audit} from '../audit.js';
 import * as i18n from '../../lib/i18n/i18n.js';
-import {adaptInsightToAuditProduct, makeNodeItemForNodeId} from './insight-audit.js';
+import {adaptInsightToAuditProduct} from './insight-audit.js';
 
 // eslint-disable-next-line max-len
 const str_ = i18n.createIcuMessageFn('node_modules/@paulirish/trace_engine/models/trace/insights/ForcedReflow.js', UIStrings);
@@ -26,25 +24,79 @@ class ForcedReflowInsight extends Audit {
       failureTitle: str_(UIStrings.title),
       description: str_(UIStrings.description),
       guidanceLevel: 3,
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
     };
   }
 
+  /**
+   * @param {import('@paulirish/trace_engine/models/trace/insights/ForcedReflow.js').ForcedReflowAggregatedData} topLevelFunctionCallData
+   * @returns {LH.Audit.Details.Table}
+   */
+  static makeTopFunctionTable(topLevelFunctionCallData) {
+    const {topLevelFunctionCall} = topLevelFunctionCallData;
+    /** @type {LH.Audit.Details.Table['headings']} */
+    const headings = [
+      // eslint-disable-next-line max-len
+      {key: 'source', valueType: 'source-location', label: str_(UIStrings.topTimeConsumingFunctionCall)},
+      {key: 'reflowTime', valueType: 'ms', granularity: 1, label: str_(UIStrings.totalReflowTime)},
+    ];
+    /** @type {LH.Audit.Details.Table['items']} */
+    const items = [
+      {
+        source: Audit.makeSourceLocation(
+          topLevelFunctionCall.url,
+          topLevelFunctionCall.lineNumber,
+          topLevelFunctionCall.columnNumber
+        ),
+        reflowTime: topLevelFunctionCallData.totalReflowTime / 1000,
+      },
+    ];
+    return Audit.makeTableDetails(headings, items);
+  }
+
+  /**
+   * @param {import('@paulirish/trace_engine/models/trace/insights/ForcedReflow.js').ForcedReflowInsightModel} insight
+   * @returns {LH.Audit.Details.Table}
+   */
+  static makeBottomUpTable(insight) {
+    /** @type {LH.Audit.Details.Table['headings']} */
+    const headings = [
+      {key: 'source', valueType: 'source-location', label: str_(i18n.UIStrings.columnSource)},
+      {key: 'reflowTime', valueType: 'ms', granularity: 1, label: str_(UIStrings.totalReflowTime)},
+    ];
+    /** @type {LH.Audit.Details.Table['items']} */
+    const items = insight.aggregatedBottomUpData.map((data) => {
+      const {bottomUpData, totalTime} = data;
+
+      const source = bottomUpData ? Audit.makeSourceLocation(
+        bottomUpData.url,
+        bottomUpData.lineNumber,
+        bottomUpData.columnNumber
+      ) : {
+        type: /** @type {const} */ ('text'),
+        value: str_(UIStrings.unattributed),
+      };
+
+      return {
+        source,
+        reflowTime: totalTime / 1000,
+      };
+    });
+    return Audit.makeTableDetails(headings, items);
+  }
+
   /**
    * @param {LH.Artifacts} artifacts
    * @param {LH.Audit.Context} context
    * @return {Promise<LH.Audit.Product>}
    */
   static async audit(artifacts, context) {
-    // TODO: implement.
     return adaptInsightToAuditProduct(artifacts, context, 'ForcedReflow', (insight) => {
-      /** @type {LH.Audit.Details.Table['headings']} */
-      const headings = [
-      ];
-      /** @type {LH.Audit.Details.Table['items']} */
-      const items = [
-      ];
-      return Audit.makeTableDetails(headings, items);
+      const list = [this.makeBottomUpTable(insight)];
+      if (insight.topLevelFunctionCallData) {
+        list.unshift(this.makeTopFunctionTable(insight.topLevelFunctionCallData));
+      }
+      return Audit.makeListDetails(list);
     });
   }
 }

package/core/audits/insights/image-delivery-insight.js

@@ -29,7 +29,7 @@ class ImageDeliveryInsight extends Audit {
       failureTitle: str_(UIStrings.title),
       description: str_(UIStrings.description),
       guidanceLevel: 3,
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
       replacesAudits: [
         'modern-image-formats',
         'uses-optimized-images',

package/core/audits/insights/insight-audit.js

@@ -19,7 +19,8 @@ async function getInsightSet(artifacts, context) {
   const settings = context.settings;
   const trace = artifacts.traces[Audit.DEFAULT_PASS];
   const processedTrace = await ProcessedTrace.request(trace, context);
-  const traceEngineResult = await TraceEngineResult.request({trace, settings}, context);
+  const SourceMaps = artifacts.SourceMaps;
+  const traceEngineResult = await TraceEngineResult.request({trace, settings, SourceMaps}, context);
 
   const navigationId = processedTrace.timeOriginEvt.args.data?.navigationId;
   const key = navigationId ?? NO_NAVIGATION;

package/core/audits/insights/interaction-to-next-paint-insight.js

@@ -24,7 +24,7 @@ class InteractionToNextPaintInsight extends Audit {
       failureTitle: str_(UIStrings.title),
       description: str_(UIStrings.description),
       guidanceLevel: 3,
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
       replacesAudits: ['work-during-interaction'],
     };
   }

package/core/audits/insights/lcp-discovery-insight.js

@@ -24,7 +24,7 @@ class LCPDiscoveryInsight extends Audit {
       failureTitle: str_(UIStrings.title),
       description: str_(UIStrings.description),
       guidanceLevel: 3,
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
       replacesAudits: ['prioritize-lcp-image', 'lcp-lazy-loaded'],
     };
   }

package/core/audits/insights/lcp-phases-insight.js

@@ -24,7 +24,7 @@ class LCPPhasesInsight extends Audit {
       failureTitle: str_(UIStrings.title),
       description: str_(UIStrings.description),
       guidanceLevel: 3,
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
       replacesAudits: ['largest-contentful-paint-element'],
     };
   }

package/core/audits/insights/network-dependency-tree-insight.js

@@ -26,7 +26,7 @@ class NetworkDependencyTreeInsight extends Audit {
       failureTitle: str_(UIStrings.title),
       description: str_(UIStrings.description),
       guidanceLevel: 3,
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
       replacesAudits: ['critical-request-chains'],
     };
   }

package/core/audits/insights/render-blocking-insight.js

@@ -24,7 +24,7 @@ class RenderBlockingInsight extends Audit {
       failureTitle: str_(UIStrings.title),
       description: str_(UIStrings.description),
       guidanceLevel: 3,
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
       replacesAudits: ['render-blocking-resources'],
     };
   }

package/core/audits/insights/slow-css-selector-insight.js

@@ -26,7 +26,7 @@ class SlowCSSSelectorInsight extends Audit {
       failureTitle: str_(UIStrings.title),
       description: str_(UIStrings.description),
       guidanceLevel: 3,
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
     };
   }
 

package/core/audits/insights/third-parties-insight.js

@@ -31,7 +31,7 @@ class ThirdPartiesInsight extends Audit {
       failureTitle: str_(UIStrings.title),
       description: str_(UIStrings.description),
       guidanceLevel: 3,
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
       replacesAudits: ['third-party-summary'],
     };
   }

package/core/audits/insights/{duplicate-javascript-insight.d.ts → use-cache-insight.d.ts}

@@ -1,5 +1,5 @@
-export default DuplicateJavaScriptInsight;
-declare class DuplicateJavaScriptInsight extends Audit {
+export default UseCacheInsight;
+declare class UseCacheInsight extends Audit {
     /**
      * @param {LH.Artifacts} artifacts
      * @param {LH.Audit.Context} context
@@ -8,4 +8,4 @@ declare class DuplicateJavaScriptInsight extends Audit {
     static audit(artifacts: LH.Artifacts, context: LH.Audit.Context): Promise<LH.Audit.Product>;
 }
 import { Audit } from '../audit.js';
-//# sourceMappingURL=duplicate-javascript-insight.d.ts.map
+//# sourceMappingURL=use-cache-insight.d.ts.map

package/core/audits/insights/use-cache-insight.js

@@ -0,0 +1,54 @@
+/* eslint-disable no-unused-vars */ // TODO: remove once implemented.
+
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {UIStrings} from '@paulirish/trace_engine/models/trace/insights/UseCache.js';
+
+import {Audit} from '../audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+import {adaptInsightToAuditProduct, makeNodeItemForNodeId} from './insight-audit.js';
+
+// eslint-disable-next-line max-len
+const str_ = i18n.createIcuMessageFn('node_modules/@paulirish/trace_engine/models/trace/insights/UseCache.js', UIStrings);
+
+class UseCacheInsight extends Audit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'use-cache-insight',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.title),
+      description: str_(UIStrings.description),
+      guidanceLevel: 3, // TODO: confirm/change.
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
+    };
+  }
+
+  /**
+   * @param {LH.Artifacts} artifacts
+   * @param {LH.Audit.Context} context
+   * @return {Promise<LH.Audit.Product>}
+   */
+  static async audit(artifacts, context) {
+    // TODO: implement.
+    return adaptInsightToAuditProduct(artifacts, context, 'UseCache', (insight) => {
+      /** @type {LH.Audit.Details.Table['headings']} */
+      const headings = [
+        /* eslint-disable max-len */
+        /* eslint-enable max-len */
+      ];
+      /** @type {LH.Audit.Details.Table['items']} */
+      const items = [
+      ];
+      return Audit.makeTableDetails(headings, items);
+    });
+  }
+}
+
+export default UseCacheInsight;

package/core/audits/insights/viewport-insight.js

@@ -24,7 +24,7 @@ class ViewportInsight extends Audit {
       failureTitle: str_(UIStrings.title),
       description: str_(UIStrings.description),
       guidanceLevel: 3,
-      requiredArtifacts: ['traces', 'TraceElements'],
+      requiredArtifacts: ['traces', 'TraceElements', 'SourceMaps'],
       replacesAudits: ['viewport'],
     };
   }