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

package/core/computed/metrics/lantern-metric.js

@@ -20,7 +20,7 @@ async function getComputationDataParamsFromDevtoolsLog(data, context) {
     throw new Error(`Lantern metrics can only be computed on navigations`);
   }
 
-  const graph = await PageDependencyGraph.request(data, context);
+  const graph = await PageDependencyGraph.request({...data, fromTrace: false}, context);
   const processedNavigation = await ProcessedNavigation.request(data.trace, context);
   const simulator = data.simulator || (await LoadSimulator.request(data, context));
 

package/core/computed/metrics/lantern-speed-index.js

@@ -40,6 +40,6 @@ class LanternSpeedIndex extends Lantern.Metrics.SpeedIndex {
 
 const LanternSpeedIndexComputed = makeComputedArtifact(
   LanternSpeedIndex,
-  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL']
+  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL', 'SourceMaps']
 );
 export {LanternSpeedIndexComputed as LanternSpeedIndex};

package/core/computed/metrics/lantern-total-blocking-time.js

@@ -35,6 +35,6 @@ class LanternTotalBlockingTime extends Lantern.Metrics.TotalBlockingTime {
 
 const LanternTotalBlockingTimeComputed = makeComputedArtifact(
   LanternTotalBlockingTime,
-  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL']
+  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL', 'SourceMaps']
 );
 export {LanternTotalBlockingTimeComputed as LanternTotalBlockingTime};

package/core/computed/metrics/largest-contentful-paint-all-frames.js

@@ -40,6 +40,6 @@ class LargestContentfulPaintAllFrames extends NavigationMetric {
 
 const LargestContentfulPaintAllFramesComputed = makeComputedArtifact(
   LargestContentfulPaintAllFrames,
-  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL']
+  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL', 'SourceMaps']
 );
 export {LargestContentfulPaintAllFramesComputed as LargestContentfulPaintAllFrames};

package/core/computed/metrics/largest-contentful-paint.js

@@ -47,6 +47,6 @@ class LargestContentfulPaint extends NavigationMetric {
 
 const LargestContentfulPaintComputed = makeComputedArtifact(
   LargestContentfulPaint,
-  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL']
+  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL', 'SourceMaps']
 );
 export {LargestContentfulPaintComputed as LargestContentfulPaint};

package/core/computed/metrics/lcp-breakdown.js

@@ -52,7 +52,7 @@ class LCPBreakdown {
 
 const LCPBreakdownComputed = makeComputedArtifact(
   LCPBreakdown,
-  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL']
+  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL', 'SourceMaps']
 );
 export {LCPBreakdownComputed as LCPBreakdown};
 

package/core/computed/metrics/max-potential-fid.js

@@ -40,6 +40,6 @@ class MaxPotentialFID extends NavigationMetric {
 
 const MaxPotentialFIDComputed = makeComputedArtifact(
   MaxPotentialFID,
-  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL']
+  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL', 'SourceMaps']
 );
 export {MaxPotentialFIDComputed as MaxPotentialFID};

package/core/computed/metrics/metric.js

@@ -34,6 +34,8 @@ class Metric {
       gatherContext: data.gatherContext,
       settings: data.settings,
       URL: data.URL,
+      SourceMaps: data.SourceMaps,
+      simulator: null,
     };
   }
 

package/core/computed/metrics/speed-index.js

@@ -35,6 +35,6 @@ class SpeedIndex extends NavigationMetric {
 
 const SpeedIndexComputed = makeComputedArtifact(
   SpeedIndex,
-  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL']
+  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL', 'SourceMaps']
 );
 export {SpeedIndexComputed as SpeedIndex};

package/core/computed/metrics/time-to-first-byte.js

@@ -58,6 +58,6 @@ class TimeToFirstByte extends NavigationMetric {
 
 const TimeToFirstByteComputed = makeComputedArtifact(
   TimeToFirstByte,
-  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL']
+  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL', 'SourceMaps']
 );
 export {TimeToFirstByteComputed as TimeToFirstByte};

package/core/computed/metrics/timing-summary.d.ts

@@ -6,6 +6,7 @@ declare const TimingSummaryComputed: typeof TimingSummary & {
         gatherContext: LH.Artifacts["GatherContext"];
         settings: LH.Util.ImmutableObject<LH.Config.Settings>;
         URL: LH.Artifacts["URL"];
+        SourceMaps: LH.Artifacts["SourceMaps"];
     }, context: LH.Artifacts.ComputedContext) => ReturnType<typeof TimingSummary.compute_>;
 };
 declare class TimingSummary {
@@ -15,15 +16,16 @@ declare class TimingSummary {
        * @param {LH.Artifacts['GatherContext']} gatherContext
        * @param {LH.Util.ImmutableObject<LH.Config.Settings>} settings
        * @param {LH.Artifacts['URL']} URL
+       * @param {LH.Artifacts['SourceMaps']} SourceMaps
        * @param {LH.Artifacts.ComputedContext} context
        * @return {Promise<{metrics: LH.Artifacts.TimingSummary, debugInfo: Record<string,boolean>}>}
        */
-    static summarize(trace: LH.Trace, devtoolsLog: LH.DevtoolsLog, gatherContext: LH.Artifacts["GatherContext"], settings: LH.Util.ImmutableObject<LH.Config.Settings>, URL: LH.Artifacts["URL"], context: LH.Artifacts.ComputedContext): Promise<{
+    static summarize(trace: LH.Trace, devtoolsLog: LH.DevtoolsLog, gatherContext: LH.Artifacts["GatherContext"], settings: LH.Util.ImmutableObject<LH.Config.Settings>, URL: LH.Artifacts["URL"], SourceMaps: LH.Artifacts["SourceMaps"], context: LH.Artifacts.ComputedContext): Promise<{
         metrics: LH.Artifacts.TimingSummary;
         debugInfo: Record<string, boolean>;
     }>;
     /**
-     * @param {{trace: LH.Trace, devtoolsLog: LH.DevtoolsLog, gatherContext: LH.Artifacts['GatherContext']; settings: LH.Util.ImmutableObject<LH.Config.Settings>, URL: LH.Artifacts['URL']}} data
+     * @param {{trace: LH.Trace, devtoolsLog: LH.DevtoolsLog, gatherContext: LH.Artifacts['GatherContext']; settings: LH.Util.ImmutableObject<LH.Config.Settings>, URL: LH.Artifacts['URL'], SourceMaps: LH.Artifacts['SourceMaps']}} data
      * @param {LH.Artifacts.ComputedContext} context
      * @return {Promise<{metrics: LH.Artifacts.TimingSummary, debugInfo: Record<string,boolean>}>}
      */
@@ -33,6 +35,7 @@ declare class TimingSummary {
         gatherContext: LH.Artifacts["GatherContext"];
         settings: LH.Util.ImmutableObject<LH.Config.Settings>;
         URL: LH.Artifacts["URL"];
+        SourceMaps: LH.Artifacts["SourceMaps"];
     }, context: LH.Artifacts.ComputedContext): Promise<{
         metrics: LH.Artifacts.TimingSummary;
         debugInfo: Record<string, boolean>;

package/core/computed/metrics/timing-summary.js

@@ -27,11 +27,14 @@ class TimingSummary {
      * @param {LH.Artifacts['GatherContext']} gatherContext
      * @param {LH.Util.ImmutableObject<LH.Config.Settings>} settings
      * @param {LH.Artifacts['URL']} URL
+     * @param {LH.Artifacts['SourceMaps']} SourceMaps
      * @param {LH.Artifacts.ComputedContext} context
      * @return {Promise<{metrics: LH.Artifacts.TimingSummary, debugInfo: Record<string,boolean>}>}
      */
-  static async summarize(trace, devtoolsLog, gatherContext, settings, URL, context) {
-    const metricComputationData = {trace, devtoolsLog, gatherContext, settings, URL};
+  static async summarize(trace, devtoolsLog, gatherContext, settings, URL, SourceMaps, context) {
+    const metricComputationData =
+      {trace, devtoolsLog, gatherContext, settings, URL, SourceMaps, simulator: null};
+
     /**
      * @template TArtifacts
      * @template TReturn
@@ -135,7 +138,7 @@ class TimingSummary {
     return {metrics, debugInfo};
   }
   /**
-   * @param {{trace: LH.Trace, devtoolsLog: LH.DevtoolsLog, gatherContext: LH.Artifacts['GatherContext']; settings: LH.Util.ImmutableObject<LH.Config.Settings>, URL: LH.Artifacts['URL']}} data
+   * @param {{trace: LH.Trace, devtoolsLog: LH.DevtoolsLog, gatherContext: LH.Artifacts['GatherContext']; settings: LH.Util.ImmutableObject<LH.Config.Settings>, URL: LH.Artifacts['URL'], SourceMaps: LH.Artifacts['SourceMaps']}} data
    * @param {LH.Artifacts.ComputedContext} context
    * @return {Promise<{metrics: LH.Artifacts.TimingSummary, debugInfo: Record<string,boolean>}>}
    */
@@ -146,6 +149,7 @@ class TimingSummary {
       data.gatherContext,
       data.settings,
       data.URL,
+      data.SourceMaps,
       context
     );
   }
@@ -153,6 +157,6 @@ class TimingSummary {
 
 const TimingSummaryComputed = makeComputedArtifact(
   TimingSummary,
-  ['devtoolsLog', 'gatherContext', 'settings', 'trace', 'URL']
+  ['devtoolsLog', 'gatherContext', 'settings', 'trace', 'URL', 'SourceMaps']
 );
 export {TimingSummaryComputed as TimingSummary};

package/core/computed/metrics/total-blocking-time.js

@@ -71,6 +71,6 @@ class TotalBlockingTime extends ComputedMetric {
 
 const TotalBlockingTimeComputed = makeComputedArtifact(
   TotalBlockingTime,
-  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL']
+  ['devtoolsLog', 'gatherContext', 'settings', 'simulator', 'trace', 'URL', 'SourceMaps']
 );
 export {TotalBlockingTimeComputed as TotalBlockingTime};

package/core/computed/navigation-insights.d.ts

@@ -3,6 +3,7 @@ declare const NavigationInsightsComputed: typeof NavigationInsights & {
     request: (dependencies: {
         trace: LH.Trace;
         settings: LH.Audit.Context["settings"];
+        SourceMaps: LH.Artifacts["SourceMaps"];
     }, context: LH.Artifacts.ComputedContext) => ReturnType<typeof NavigationInsights.compute_>;
 };
 /**
@@ -11,12 +12,13 @@ declare const NavigationInsightsComputed: typeof NavigationInsights & {
  */
 declare class NavigationInsights {
     /**
-      * @param {{trace: LH.Trace, settings: LH.Audit.Context['settings']}} data
+      * @param {{trace: LH.Trace, settings: LH.Audit.Context['settings'], SourceMaps: LH.Artifacts['SourceMaps']}} data
       * @param {LH.Artifacts.ComputedContext} context
      */
     static compute_(data: {
         trace: LH.Trace;
         settings: LH.Audit.Context["settings"];
+        SourceMaps: LH.Artifacts["SourceMaps"];
     }, context: LH.Artifacts.ComputedContext): Promise<import("@paulirish/trace_engine/models/trace/insights/types.js").InsightSet>;
 }
 //# sourceMappingURL=navigation-insights.d.ts.map

package/core/computed/navigation-insights.js

@@ -14,13 +14,14 @@ import {TraceEngineResult} from './trace-engine-result.js';
  */
 class NavigationInsights {
   /**
-    * @param {{trace: LH.Trace, settings: LH.Audit.Context['settings']}} data
+    * @param {{trace: LH.Trace, settings: LH.Audit.Context['settings'], SourceMaps: LH.Artifacts['SourceMaps']}} data
     * @param {LH.Artifacts.ComputedContext} context
    */
   static async compute_(data, context) {
-    const {trace, settings} = data;
+    const {trace, settings, SourceMaps} = data;
     const processedTrace = await ProcessedTrace.request(trace, context);
-    const traceEngineResult = await TraceEngineResult.request({trace, settings}, context);
+    const traceEngineResult =
+      await TraceEngineResult.request({trace, settings, SourceMaps}, context);
 
     const navigationId = processedTrace.timeOriginEvt.args.data?.navigationId;
     if (!navigationId) throw new Error('No navigationId found');
@@ -32,5 +33,6 @@ class NavigationInsights {
   }
 }
 
-const NavigationInsightsComputed = makeComputedArtifact(NavigationInsights, ['trace', 'settings']);
+const NavigationInsightsComputed =
+  makeComputedArtifact(NavigationInsights, ['trace', 'settings', 'SourceMaps']);
 export {NavigationInsightsComputed as NavigationInsights};

package/core/computed/page-dependency-graph.d.ts

@@ -5,12 +5,13 @@ declare const PageDependencyGraphComputed: typeof PageDependencyGraph & {
         devtoolsLog: LH.DevtoolsLog;
         settings: LH.Audit.Context["settings"];
         URL: LH.Artifacts["URL"];
-        fromTrace?: boolean;
+        SourceMaps: LH.Artifacts["SourceMaps"];
+        fromTrace: boolean;
     }, context: LH.Artifacts.ComputedContext) => ReturnType<typeof PageDependencyGraph.compute_>;
 };
 declare class PageDependencyGraph {
     /**
-     * @param {{trace: LH.Trace, devtoolsLog: LH.DevtoolsLog, settings: LH.Audit.Context['settings'], URL: LH.Artifacts['URL'], fromTrace?: boolean}} data
+     * @param {{trace: LH.Trace, devtoolsLog: LH.DevtoolsLog, settings: LH.Audit.Context['settings'], URL: LH.Artifacts['URL'], SourceMaps: LH.Artifacts['SourceMaps'], fromTrace: boolean}} data
      * @param {LH.Artifacts.ComputedContext} context
      * @return {Promise<LH.Gatherer.Simulation.GraphNode>}
      */
@@ -19,7 +20,8 @@ declare class PageDependencyGraph {
         devtoolsLog: LH.DevtoolsLog;
         settings: LH.Audit.Context["settings"];
         URL: LH.Artifacts["URL"];
-        fromTrace?: boolean;
+        SourceMaps: LH.Artifacts["SourceMaps"];
+        fromTrace: boolean;
     }, context: LH.Artifacts.ComputedContext): Promise<LH.Gatherer.Simulation.GraphNode>;
 }
 //# sourceMappingURL=page-dependency-graph.d.ts.map

package/core/computed/page-dependency-graph.js

@@ -13,19 +13,20 @@ import {TraceEngineResult} from './trace-engine-result.js';
 
 class PageDependencyGraph {
   /**
-   * @param {{trace: LH.Trace, devtoolsLog: LH.DevtoolsLog, settings: LH.Audit.Context['settings'], URL: LH.Artifacts['URL'], fromTrace?: boolean}} data
+   * @param {{trace: LH.Trace, devtoolsLog: LH.DevtoolsLog, settings: LH.Audit.Context['settings'], URL: LH.Artifacts['URL'], SourceMaps: LH.Artifacts['SourceMaps'], fromTrace: boolean}} data
    * @param {LH.Artifacts.ComputedContext} context
    * @return {Promise<LH.Gatherer.Simulation.GraphNode>}
    */
   static async compute_(data, context) {
-    const {trace, settings, devtoolsLog, URL} = data;
+    const {trace, settings, devtoolsLog, URL, SourceMaps} = data;
     const [{mainThreadEvents}, networkRecords] = await Promise.all([
       ProcessedTrace.request(trace, context),
       NetworkRecords.request(devtoolsLog, context),
     ]);
 
     if (data.fromTrace) {
-      const traceEngineResult = await TraceEngineResult.request({trace, settings}, context);
+      const traceEngineResult =
+        await TraceEngineResult.request({trace, settings, SourceMaps}, context);
       const traceEngineData = traceEngineResult.data;
       const requests =
         Lantern.TraceEngineComputationData.createNetworkRequests(trace, traceEngineData);
@@ -41,5 +42,5 @@ class PageDependencyGraph {
 }
 
 const PageDependencyGraphComputed = makeComputedArtifact(PageDependencyGraph,
-  ['devtoolsLog', 'settings', 'trace', 'URL', 'fromTrace']);
+  ['devtoolsLog', 'settings', 'trace', 'URL', 'SourceMaps', 'fromTrace']);
 export {PageDependencyGraphComputed as PageDependencyGraph};

package/core/computed/tbt-impact-tasks.js

@@ -239,6 +239,6 @@ class TBTImpactTasks {
 
 const TBTImpactTasksComputed = makeComputedArtifact(
   TBTImpactTasks,
-  ['trace', 'devtoolsLog', 'URL', 'gatherContext', 'settings', 'simulator']
+  ['trace', 'devtoolsLog', 'URL', 'SourceMaps', 'gatherContext', 'settings', 'simulator']
 );
 export {TBTImpactTasksComputed as TBTImpactTasks};

package/core/computed/trace-engine-result.d.ts

@@ -3,6 +3,7 @@ declare const TraceEngineResultComputed: typeof TraceEngineResult & {
     request: (dependencies: {
         trace: LH.Trace;
         settings: LH.Audit.Context["settings"];
+        SourceMaps: LH.Artifacts["SourceMaps"];
     }, context: LH.Artifacts.ComputedContext) => ReturnType<typeof TraceEngineResult.compute_>;
 };
 /**
@@ -12,9 +13,10 @@ declare class TraceEngineResult {
     /**
      * @param {LH.TraceEvent[]} traceEvents
      * @param {LH.Audit.Context['settings']} settings
+     * @param {LH.Artifacts['SourceMaps']} SourceMaps
      * @return {Promise<LH.Artifacts.TraceEngineResult>}
      */
-    static runTraceEngine(traceEvents: LH.TraceEvent[], settings: LH.Audit.Context["settings"]): Promise<LH.Artifacts.TraceEngineResult>;
+    static runTraceEngine(traceEvents: LH.TraceEvent[], settings: LH.Audit.Context["settings"], SourceMaps: LH.Artifacts["SourceMaps"]): Promise<LH.Artifacts.TraceEngineResult>;
     /**
      * Adapts the given DevTools function that returns a localized string to one
      * that returns a LH.IcuMessage.
@@ -47,13 +49,14 @@ declare class TraceEngineResult {
      */
     static localizeInsights(insightSets: import("@paulirish/trace_engine/models/trace/insights/types.js").TraceInsightSets): void;
     /**
-     * @param {{trace: LH.Trace, settings: LH.Audit.Context['settings']}} data
+     * @param {{trace: LH.Trace, settings: LH.Audit.Context['settings'], SourceMaps: LH.Artifacts['SourceMaps']}} data
      * @param {LH.Artifacts.ComputedContext} context
      * @return {Promise<LH.Artifacts.TraceEngineResult>}
      */
     static compute_(data: {
         trace: LH.Trace;
         settings: LH.Audit.Context["settings"];
+        SourceMaps: LH.Artifacts["SourceMaps"];
     }, context: LH.Artifacts.ComputedContext): Promise<LH.Artifacts.TraceEngineResult>;
 }
 import * as LH from '../../types/lh.js';

package/core/computed/trace-engine-result.js

@@ -11,6 +11,7 @@ import * as TraceEngine from '../lib/trace-engine.js';
 import {makeComputedArtifact} from './computed-artifact.js';
 import {CumulativeLayoutShift} from './metrics/cumulative-layout-shift.js';
 import {ProcessedTrace} from './processed-trace.js';
+import SDK from '../lib/cdt/SDK.js';
 import * as LH from '../../types/lh.js';
 
 /**
@@ -20,9 +21,10 @@ class TraceEngineResult {
   /**
    * @param {LH.TraceEvent[]} traceEvents
    * @param {LH.Audit.Context['settings']} settings
+   * @param {LH.Artifacts['SourceMaps']} SourceMaps
    * @return {Promise<LH.Artifacts.TraceEngineResult>}
    */
-  static async runTraceEngine(traceEvents, settings) {
+  static async runTraceEngine(traceEvents, settings, SourceMaps) {
     const processor = new TraceEngine.TraceProcessor(TraceEngine.TraceHandlers);
 
     const lanternSettings = {};
@@ -47,6 +49,16 @@ class TraceEngineResult {
         },
       },
       lanternSettings,
+      async resolveSourceMap(params) {
+        const sourceMap = SourceMaps.find(sm => sm.scriptId === params.scriptId);
+        if (!sourceMap) {
+          return null;
+        }
+
+        const compiledUrl = sourceMap.scriptUrl || 'compiled.js';
+        const mapUrl = sourceMap.sourceMapUrl || 'compiled.js.map';
+        return new SDK.SourceMap(compiledUrl, mapUrl, sourceMap.map);
+      },
     });
     if (!processor.parsedTrace) throw new Error('No data');
     if (!processor.insights) throw new Error('No insights');
@@ -199,7 +211,7 @@ class TraceEngineResult {
   }
 
   /**
-   * @param {{trace: LH.Trace, settings: LH.Audit.Context['settings']}} data
+   * @param {{trace: LH.Trace, settings: LH.Audit.Context['settings'], SourceMaps: LH.Artifacts['SourceMaps']}} data
    * @param {LH.Artifacts.ComputedContext} context
    * @return {Promise<LH.Artifacts.TraceEngineResult>}
    */
@@ -229,10 +241,12 @@ class TraceEngineResult {
       }
     }
 
-    const result = await TraceEngineResult.runTraceEngine(traceEvents, data.settings);
+    const result =
+      await TraceEngineResult.runTraceEngine(traceEvents, data.settings, data.SourceMaps);
     return result;
   }
 }
 
-const TraceEngineResultComputed = makeComputedArtifact(TraceEngineResult, ['trace', 'settings']);
+const TraceEngineResultComputed =
+  makeComputedArtifact(TraceEngineResult, ['trace', 'settings', 'SourceMaps']);
 export {TraceEngineResultComputed as TraceEngineResult};

package/core/computed/unused-javascript-summary.d.ts

@@ -7,7 +7,7 @@ export type WasteData = {
 export type ComputeInput = {
     scriptId: string;
     scriptCoverage: Omit<LH.Crdp.Profiler.ScriptCoverage, "url">;
-    bundle?: LH.Artifacts.Bundle | undefined;
+    bundle: LH.Artifacts.Bundle | null;
 };
 export type Summary = {
     scriptId: string;
@@ -32,7 +32,7 @@ declare const UnusedJavascriptSummaryComputed: typeof UnusedJavascriptSummary &
  * @typedef ComputeInput
  * @property {string} scriptId
  * @property {Omit<LH.Crdp.Profiler.ScriptCoverage, 'url'>} scriptCoverage
- * @property {LH.Artifacts.Bundle=} bundle
+ * @property {LH.Artifacts.Bundle|null} bundle
  */
 /**
  * @typedef Summary

package/core/computed/unused-javascript-summary.js

@@ -16,7 +16,7 @@ import {makeComputedArtifact} from './computed-artifact.js';
  * @typedef ComputeInput
  * @property {string} scriptId
  * @property {Omit<LH.Crdp.Profiler.ScriptCoverage, 'url'>} scriptCoverage
- * @property {LH.Artifacts.Bundle=} bundle
+ * @property {LH.Artifacts.Bundle|null} bundle
  */
 
 /**

package/core/config/default-config.js

@@ -312,7 +312,7 @@ const defaultConfig = {
     'insights/cls-culprits-insight',
     'insights/document-latency-insight',
     'insights/dom-size-insight',
-    'insights/duplicate-javascript-insight',
+    'insights/duplicated-javascript-insight',
     'insights/font-display-insight',
     'insights/forced-reflow-insight',
     'insights/image-delivery-insight',
@@ -323,6 +323,7 @@ const defaultConfig = {
     'insights/render-blocking-insight',
     'insights/slow-css-selector-insight',
     'insights/third-parties-insight',
+    'insights/use-cache-insight',
     'insights/viewport-insight',
   ],
   groups: {
@@ -411,7 +412,7 @@ const defaultConfig = {
         {id: 'cls-culprits-insight', weight: 0, group: 'hidden'},
         {id: 'document-latency-insight', weight: 0, group: 'hidden'},
         {id: 'dom-size-insight', weight: 0, group: 'hidden'},
-        {id: 'duplicate-javascript-insight', weight: 0, group: 'hidden'},
+        {id: 'duplicated-javascript-insight', weight: 0, group: 'hidden'},
         {id: 'font-display-insight', weight: 0, group: 'hidden'},
         {id: 'forced-reflow-insight', weight: 0, group: 'hidden'},
         {id: 'image-delivery-insight', weight: 0, group: 'hidden'},
@@ -422,6 +423,7 @@ const defaultConfig = {
         {id: 'render-blocking-insight', weight: 0, group: 'hidden'},
         {id: 'slow-css-selector-insight', weight: 0, group: 'hidden'},
         {id: 'third-parties-insight', weight: 0, group: 'hidden'},
+        {id: 'use-cache-insight', weight: 0, group: 'hidden'},
         {id: 'viewport-insight', weight: 0, group: 'hidden'},
 
         // These are our "invisible" metrics. Not displayed, but still in the LHR.

package/core/config/experimental-config.js

@@ -30,7 +30,7 @@ const config = {
         {id: 'cls-culprits-insight', weight: 0, group: 'insights'},
         {id: 'document-latency-insight', weight: 0, group: 'insights'},
         {id: 'dom-size-insight', weight: 0, group: 'insights'},
-        {id: 'duplicate-javascript-insight', weight: 0, group: 'insights'},
+        {id: 'duplicated-javascript-insight', weight: 0, group: 'insights'},
         {id: 'font-display-insight', weight: 0, group: 'insights'},
         {id: 'forced-reflow-insight', weight: 0, group: 'insights'},
         {id: 'image-delivery-insight', weight: 0, group: 'insights'},
@@ -41,6 +41,7 @@ const config = {
         {id: 'render-blocking-insight', weight: 0, group: 'insights'},
         {id: 'slow-css-selector-insight', weight: 0, group: 'insights'},
         {id: 'third-parties-insight', weight: 0, group: 'insights'},
+        {id: 'use-cache-insight', weight: 0, group: 'insights'},
         {id: 'viewport-insight', weight: 0, group: 'insights'},
       ],
     },

package/core/gather/gatherers/source-maps.d.ts

@@ -3,6 +3,7 @@ export default SourceMaps;
  * @fileoverview Gets JavaScript source maps.
  */
 declare class SourceMaps extends BaseGatherer {
+    static symbol: symbol;
     /** @type {LH.Gatherer.GathererMeta<'Scripts'>} */
     meta: LH.Gatherer.GathererMeta<"Scripts">;
     /**

package/core/gather/gatherers/source-maps.js

@@ -12,8 +12,11 @@ import Scripts from './scripts.js';
  * @fileoverview Gets JavaScript source maps.
  */
 class SourceMaps extends BaseGatherer {
+  static symbol = Symbol('SourceMaps');
+
   /** @type {LH.Gatherer.GathererMeta<'Scripts'>} */
   meta = {
+    symbol: SourceMaps.symbol,
     supportedModes: ['timespan', 'navigation'],
     dependencies: {Scripts: Scripts.symbol},
   };

package/core/gather/gatherers/trace-elements.d.ts

@@ -56,8 +56,8 @@ declare class TraceElements extends BaseGatherer {
         nodeId: number;
         type: string;
     } | undefined>;
-    /** @type {LH.Gatherer.GathererMeta<'Trace'>} */
-    meta: LH.Gatherer.GathererMeta<"Trace">;
+    /** @type {LH.Gatherer.GathererMeta<'Trace'|'SourceMaps'>} */
+    meta: LH.Gatherer.GathererMeta<"Trace" | "SourceMaps">;
     /** @type {Map<string, string>} */
     animationIdToName: Map<string, string>;
     /** @param {LH.Crdp.Animation.AnimationStartedEvent} args */
@@ -82,10 +82,10 @@ declare class TraceElements extends BaseGatherer {
      */
     getNodeDetails(session: LH.Gatherer.ProtocolSession, backendNodeId: number): Promise<import("devtools-protocol").Protocol.Runtime.CallFunctionOnResponse | null>;
     /**
-     * @param {LH.Gatherer.Context<'Trace'|'RootCauses'>} context
+     * @param {LH.Gatherer.Context<'Trace'|'RootCauses'|'SourceMaps'>} context
      * @return {Promise<LH.Artifacts.TraceElement[]>}
      */
-    getArtifact(context: LH.Gatherer.Context<"Trace" | "RootCauses">): Promise<LH.Artifacts.TraceElement[]>;
+    getArtifact(context: LH.Gatherer.Context<"Trace" | "RootCauses" | "SourceMaps">): Promise<LH.Artifacts.TraceElement[]>;
 }
 import BaseGatherer from '../base-gatherer.js';
 //# sourceMappingURL=trace-elements.d.ts.map

package/core/gather/gatherers/trace-elements.js

@@ -24,6 +24,7 @@ import {Responsiveness} from '../../computed/metrics/responsiveness.js';
 import {CumulativeLayoutShift} from '../../computed/metrics/cumulative-layout-shift.js';
 import {ExecutionContext} from '../driver/execution-context.js';
 import {TraceEngineResult} from '../../computed/trace-engine-result.js';
+import SourceMaps from './source-maps.js';
 
 /** @typedef {{nodeId: number, animations?: {name?: string, failureReasonsMask?: number, unsupportedProperties?: string[]}[], type?: string}} TraceElementData */
 
@@ -45,10 +46,10 @@ function getNodeDetailsData() {
 /* c8 ignore stop */
 
 class TraceElements extends BaseGatherer {
-  /** @type {LH.Gatherer.GathererMeta<'Trace'>} */
+  /** @type {LH.Gatherer.GathererMeta<'Trace'|'SourceMaps'>} */
   meta = {
     supportedModes: ['timespan', 'navigation'],
-    dependencies: {Trace: Trace.symbol},
+    dependencies: {Trace: Trace.symbol, SourceMaps: SourceMaps.symbol},
   };
 
   /** @type {Map<string, string>} */
@@ -379,15 +380,17 @@ class TraceElements extends BaseGatherer {
   }
 
   /**
-   * @param {LH.Gatherer.Context<'Trace'|'RootCauses'>} context
+   * @param {LH.Gatherer.Context<'Trace'|'RootCauses'|'SourceMaps'>} context
    * @return {Promise<LH.Artifacts.TraceElement[]>}
    */
   async getArtifact(context) {
     const session = context.driver.defaultSession;
 
     const trace = context.dependencies.Trace;
+    const SourceMaps = context.dependencies.SourceMaps;
     const settings = context.settings;
-    const traceEngineResult = await TraceEngineResult.request({trace, settings}, context);
+    const traceEngineResult =
+      await TraceEngineResult.request({trace, settings, SourceMaps}, context);
     const rootCauses = context.dependencies.RootCauses;
 
     const processedTrace = await ProcessedTrace.request(trace, context);

package/core/gather/gatherers/trace.js

@@ -59,6 +59,11 @@ class Trace extends BaseGatherer {
       // For CLS root causes.
       'disabled-by-default-devtools.timeline.invalidationTracking',
 
+      // Enhanced traces.
+      'disabled-by-default-devtools.target-rundown',
+      'disabled-by-default-devtools.v8-source-rundown-sources',
+      'disabled-by-default-devtools.v8-source-rundown',
+
       // Not used by Lighthouse (yet) but included for users that want JS samples when looking at
       // a trace collected by Lighthouse (e.g. "View Trace" workflow in DevTools)
       // TODO: Re-enable after investigating b/325659693

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lighthouse",
   "type": "module",
-  "version": "12.4.0-dev.20250318",
+  "version": "12.4.0-dev.20250320",
   "description": "Automated auditing, performance metrics, and best practices for the web.",
   "main": "./core/index.js",
   "bin": {
@@ -185,7 +185,7 @@
     "webtreemap-cdt": "^3.2.1"
   },
   "dependencies": {
-    "@paulirish/trace_engine": "0.0.48",
+    "@paulirish/trace_engine": "0.0.50",
     "@sentry/node": "^7.0.0",
     "axe-core": "^4.10.2",
     "chrome-launcher": "^1.1.2",