lighthouse 12.1.0 → 12.2.0

package/core/computed/tbt-impact-tasks.d.ts

@@ -1,8 +1,6 @@
 export { TBTImpactTasksComputed as TBTImpactTasks };
 declare const TBTImpactTasksComputed: typeof TBTImpactTasks & {
-    request: (dependencies: import("../index.js").Artifacts.MetricComputationDataInput, context: import("../../types/utility-types.js").default.ImmutableObject<{
-        computedCache: Map<string, import("../lib/arbitrary-equality-map.js").ArbitraryEqualityMap>;
-    }>) => Promise<import("../index.js").Artifacts.TBTImpactTask[]>;
+    request: (dependencies: import("../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => ReturnType<typeof TBTImpactTasks.compute_>;
 };
 declare class TBTImpactTasks {
     /**
@@ -22,8 +20,9 @@ declare class TBTImpactTasks {
     /**
      * @param {LH.Artifacts.TaskNode[]} tasks
      * @param {Map<LH.Artifacts.TaskNode, number>} taskToImpact
+     * @param {Map<LH.Artifacts.TaskNode, number>} taskToBlockingTime
      */
-    static createImpactTasks(tasks: LH.Artifacts.TaskNode[], taskToImpact: Map<LH.Artifacts.TaskNode, number>): import("../index.js").Artifacts.TBTImpactTask[];
+    static createImpactTasks(tasks: LH.Artifacts.TaskNode[], taskToImpact: Map<LH.Artifacts.TaskNode, number>, taskToBlockingTime: Map<LH.Artifacts.TaskNode, number>): import("../index.js").Artifacts.TBTImpactTask[];
     /**
      * @param {LH.Artifacts.TaskNode[]} tasks
      * @param {number} startTimeMs
@@ -38,7 +37,7 @@ declare class TBTImpactTasks {
      * @param {number} endTimeMs
      * @return {LH.Artifacts.TBTImpactTask[]}
      */
-    static computeImpactsFromLantern(tasks: LH.Artifacts.TaskNode[], tbtNodeTimings: LH.Gatherer.Simulation.Result['nodeTimings'], startTimeMs: number, endTimeMs: number): LH.Artifacts.TBTImpactTask[];
+    static computeImpactsFromLantern(tasks: LH.Artifacts.TaskNode[], tbtNodeTimings: LH.Gatherer.Simulation.Result["nodeTimings"], startTimeMs: number, endTimeMs: number): LH.Artifacts.TBTImpactTask[];
     /**
      * @param {LH.Artifacts.MetricComputationDataInput} metricComputationData
      * @param {LH.Artifacts.ComputedContext} context

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

@@ -12,7 +12,7 @@ import {Interactive} from './metrics/interactive.js';
 import {TotalBlockingTime} from './metrics/total-blocking-time.js';
 import {ProcessedTrace} from './processed-trace.js';
 
-const {calculateTbtImpactForEvent} = Lantern.TBTUtils;
+const {calculateTbtImpactForEvent} = Lantern.Metrics.TBTUtils;
 
 class TBTImpactTasks {
   /**
@@ -64,8 +64,9 @@ class TBTImpactTasks {
   /**
    * @param {LH.Artifacts.TaskNode[]} tasks
    * @param {Map<LH.Artifacts.TaskNode, number>} taskToImpact
+   * @param {Map<LH.Artifacts.TaskNode, number>} taskToBlockingTime
    */
-  static createImpactTasks(tasks, taskToImpact) {
+  static createImpactTasks(tasks, taskToImpact, taskToBlockingTime) {
     /** @type {LH.Artifacts.TBTImpactTask[]} */
     const tbtImpactTasks = [];
 
@@ -73,15 +74,25 @@ class TBTImpactTasks {
       const tbtImpact = taskToImpact.get(task) || 0;
       let selfTbtImpact = tbtImpact;
 
+      const blockingTime = taskToBlockingTime.get(task) || 0;
+      let selfBlockingTime = blockingTime;
+
       for (const child of task.children) {
         const childTbtImpact = taskToImpact.get(child) || 0;
         selfTbtImpact -= childTbtImpact;
+
+        const childBlockingTime = taskToBlockingTime.get(child) || 0;
+        selfBlockingTime -= childBlockingTime;
       }
 
       tbtImpactTasks.push({
         ...task,
-        tbtImpact,
-        selfTbtImpact,
+        // Floating point numbers are not perfectly precise, so the subtraction operations above
+        // can sometimes output negative numbers close to 0 here. To prevent potentially confusing
+        // output we should bump those values to 0.
+        tbtImpact: Math.max(tbtImpact, 0),
+        selfTbtImpact: Math.max(selfTbtImpact, 0),
+        selfBlockingTime: Math.max(selfBlockingTime, 0),
       });
     }
 
@@ -98,6 +109,9 @@ class TBTImpactTasks {
     /** @type {Map<LH.Artifacts.TaskNode, number>} */
     const taskToImpact = new Map();
 
+    /** @type {Map<LH.Artifacts.TaskNode, number>} */
+    const taskToBlockingTime = new Map();
+
     for (const task of tasks) {
       const event = {
         start: task.startTime,
@@ -113,11 +127,13 @@ class TBTImpactTasks {
       };
 
       const tbtImpact = calculateTbtImpactForEvent(event, startTimeMs, endTimeMs, topLevelEvent);
+      const blockingTime = calculateTbtImpactForEvent(event, -Infinity, Infinity, topLevelEvent);
 
       taskToImpact.set(task, tbtImpact);
+      taskToBlockingTime.set(task, blockingTime);
     }
 
-    return this.createImpactTasks(tasks, taskToImpact);
+    return this.createImpactTasks(tasks, taskToImpact, taskToBlockingTime);
   }
 
   /**
@@ -131,10 +147,13 @@ class TBTImpactTasks {
     /** @type {Map<LH.Artifacts.TaskNode, number>} */
     const taskToImpact = new Map();
 
+    /** @type {Map<LH.Artifacts.TaskNode, number>} */
+    const taskToBlockingTime = new Map();
+
     /** @type {Map<LH.Artifacts.TaskNode, {start: number, end: number, duration: number}>} */
     const topLevelTaskToEvent = new Map();
 
-    /** @type {Map<Lantern.TraceEvent, LH.Artifacts.TaskNode>} */
+    /** @type {Map<Lantern.Types.TraceEvent, LH.Artifacts.TaskNode>} */
     const traceEventToTask = new Map();
     for (const task of tasks) {
       traceEventToTask.set(task.event, task);
@@ -151,19 +170,21 @@ class TBTImpactTasks {
       };
 
       const tbtImpact = calculateTbtImpactForEvent(event, startTimeMs, endTimeMs);
+      const blockingTime = calculateTbtImpactForEvent(event, -Infinity, Infinity);
 
       const task = traceEventToTask.get(node.event);
       if (!task) continue;
 
       topLevelTaskToEvent.set(task, event);
       taskToImpact.set(task, tbtImpact);
+      taskToBlockingTime.set(task, blockingTime);
     }
 
     // Interpolate the TBT impact of remaining tasks using the top level ancestor tasks.
     // We don't have any lantern estimates for tasks that are not top level, so we need to estimate
     // the lantern timing based on the task's observed timing relative to it's top level task's observed timing.
     for (const task of tasks) {
-      if (taskToImpact.has(task)) continue;
+      if (taskToImpact.has(task) || taskToBlockingTime.has(task)) continue;
 
       const topLevelTask = this.getTopLevelTask(task);
 
@@ -183,11 +204,13 @@ class TBTImpactTasks {
       };
 
       const tbtImpact = calculateTbtImpactForEvent(event, startTimeMs, endTimeMs, topLevelEvent);
+      const blockingTime = calculateTbtImpactForEvent(event, -Infinity, Infinity, topLevelEvent);
 
       taskToImpact.set(task, tbtImpact);
+      taskToBlockingTime.set(task, blockingTime);
     }
 
-    return this.createImpactTasks(tasks, taskToImpact);
+    return this.createImpactTasks(tasks, taskToImpact, taskToBlockingTime);
   }
 
   /**

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

@@ -2,9 +2,7 @@ export { TraceEngineResultComputed as TraceEngineResult };
 declare const TraceEngineResultComputed: typeof TraceEngineResult & {
     request: (dependencies: {
         trace: LH.Trace;
-    }, context: LH.Util.ImmutableObject<{
-        computedCache: Map<string, import("../lib/arbitrary-equality-map.js").ArbitraryEqualityMap>;
-    }>) => Promise<LH.Artifacts.TraceEngineResult>;
+    }, context: LH.Artifacts.ComputedContext) => ReturnType<typeof TraceEngineResult.compute_>;
 };
 /**
  * @fileoverview Processes trace with the shared trace engine.

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

@@ -19,7 +19,16 @@ class TraceEngineResult {
    * @return {Promise<LH.Artifacts.TraceEngineResult>}
    */
   static async runTraceEngine(traceEvents) {
-    const processor = TraceEngine.TraceProcessor.createWithAllHandlers();
+    const traceHandlers = {...TraceEngine.TraceHandlers};
+
+    // @ts-expect-error Temporarily disable this handler
+    // It's not currently used anywhere in trace engine insights or Lighthouse.
+    // TODO: Re-enable this when its memory usage is improved in the trace engine
+    // https://github.com/GoogleChrome/lighthouse/issues/16111
+    delete traceHandlers.Invalidations;
+
+    const processor = new TraceEngine.TraceProcessor(traceHandlers);
+
     // eslint-disable-next-line max-len
     await processor.parse(/** @type {import('@paulirish/trace_engine').Types.TraceEvents.TraceEventData[]} */ (
       traceEvents

package/core/computed/unused-css.d.ts

@@ -5,12 +5,10 @@ export type StyleSheetInfo = LH.Artifacts.CSSStyleSheetInfo & {
 };
 declare const UnusedCSSComputed: typeof UnusedCSS & {
     request: (dependencies: {
-        Stylesheets: LH.Artifacts['Stylesheets'];
-        CSSUsage: LH.Artifacts['CSSUsage'];
-        devtoolsLog: import("../index.js").DevtoolsLog;
-    }, context: import("../../types/utility-types.js").default.ImmutableObject<{
-        computedCache: Map<string, import("../lib/arbitrary-equality-map.js").ArbitraryEqualityMap>;
-    }>) => Promise<import("../../types/audit.js").default.ByteEfficiencyItem[]>;
+        Stylesheets: LH.Artifacts["Stylesheets"];
+        CSSUsage: LH.Artifacts["CSSUsage"];
+        devtoolsLog: LH.DevtoolsLog;
+    }, context: LH.Artifacts.ComputedContext) => ReturnType<typeof UnusedCSS.compute_>;
 };
 /** @typedef {LH.Artifacts.CSSStyleSheetInfo & {networkRecord: LH.Artifacts.NetworkRequest, usedRules: Array<LH.Crdp.CSS.RuleUsage>}} StyleSheetInfo */
 declare class UnusedCSS {
@@ -56,9 +54,9 @@ declare class UnusedCSS {
      * @return {Promise<LH.Audit.ByteEfficiencyItem[]>}
     */
     static compute_(data: {
-        Stylesheets: LH.Artifacts['Stylesheets'];
-        CSSUsage: LH.Artifacts['CSSUsage'];
-        devtoolsLog: import("../index.js").DevtoolsLog;
+        Stylesheets: LH.Artifacts["Stylesheets"];
+        CSSUsage: LH.Artifacts["CSSUsage"];
+        devtoolsLog: LH.DevtoolsLog;
     }, context: LH.Artifacts.ComputedContext): Promise<LH.Audit.ByteEfficiencyItem[]>;
 }
 //# sourceMappingURL=unused-css.d.ts.map

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

@@ -6,7 +6,7 @@ export type WasteData = {
 };
 export type ComputeInput = {
     scriptId: string;
-    scriptCoverage: Omit<LH.Crdp.Profiler.ScriptCoverage, 'url'>;
+    scriptCoverage: Omit<LH.Crdp.Profiler.ScriptCoverage, "url">;
     bundle?: LH.Artifacts.Bundle | undefined;
 };
 export type Summary = {
@@ -20,9 +20,7 @@ export type Summary = {
     sourcesWastedBytes?: Record<string, number> | undefined;
 };
 declare const UnusedJavascriptSummaryComputed: typeof UnusedJavascriptSummary & {
-    request: (dependencies: ComputeInput, context: import("../../types/utility-types.js").default.ImmutableObject<{
-        computedCache: Map<string, import("../lib/arbitrary-equality-map.js").ArbitraryEqualityMap>;
-    }>) => Promise<Summary>;
+    request: (dependencies: ComputeInput, context: LH.Artifacts.ComputedContext) => ReturnType<typeof UnusedJavascriptSummary.compute_>;
 };
 /**
  * @typedef WasteData
@@ -50,7 +48,7 @@ declare class UnusedJavascriptSummary {
      * @param {Omit<LH.Crdp.Profiler.ScriptCoverage, 'url'>} scriptCoverage
      * @return {WasteData}
      */
-    static computeWaste(scriptCoverage: Omit<LH.Crdp.Profiler.ScriptCoverage, 'url'>): WasteData;
+    static computeWaste(scriptCoverage: Omit<LH.Crdp.Profiler.ScriptCoverage, "url">): WasteData;
     /**
      * @param {string} scriptId
      * @param {WasteData} wasteData

package/core/computed/user-timings.d.ts

@@ -2,21 +2,19 @@ export { UserTimingsComputed as UserTimings };
 export type MarkEvent = {
     name: string;
     isMark: true;
-    args: LH.TraceEvent['args'];
+    args: LH.TraceEvent["args"];
     startTime: number;
 };
 export type MeasureEvent = {
     name: string;
     isMark: false;
-    args: LH.TraceEvent['args'];
+    args: LH.TraceEvent["args"];
     startTime: number;
     endTime: number;
     duration: number;
 };
 declare const UserTimingsComputed: typeof UserTimings & {
-    request: (dependencies: import("../index.js").Trace, context: import("../../types/utility-types.js").default.ImmutableObject<{
-        computedCache: Map<string, import("../lib/arbitrary-equality-map.js").ArbitraryEqualityMap>;
-    }>) => Promise<(MarkEvent | MeasureEvent)[]>;
+    request: (dependencies: import("../index.js").Trace, context: LH.Artifacts.ComputedContext) => ReturnType<typeof UserTimings.compute_>;
 };
 /** @typedef {{name: string, isMark: true, args: LH.TraceEvent['args'], startTime: number}} MarkEvent */
 /** @typedef {{name: string, isMark: false, args: LH.TraceEvent['args'], startTime: number, endTime: number, duration: number}} MeasureEvent */

package/core/computed/viewport-meta.d.ts

@@ -19,21 +19,19 @@ export type ViewportMetaResult = {
 };
 declare const ViewportMetaComputed: typeof ViewportMeta & {
     request: (dependencies: {
-        name?: string | undefined;
-        content?: string | undefined;
-        property?: string | undefined;
-        httpEquiv?: string | undefined;
-        charset?: string | undefined;
+        name?: string;
+        content?: string;
+        property?: string;
+        httpEquiv?: string;
+        charset?: string;
         node: import("../index.js").Artifacts.NodeDetails;
-    }[], context: import("../../types/utility-types.js").default.ImmutableObject<{
-        computedCache: Map<string, import("../lib/arbitrary-equality-map.js").ArbitraryEqualityMap>;
-    }>) => Promise<ViewportMetaResult>;
+    }[], context: LH.Artifacts.ComputedContext) => ReturnType<typeof ViewportMeta.compute_>;
 };
 declare class ViewportMeta {
     /**
      * @param {LH.GathererArtifacts['MetaElements']} MetaElements
      * @return {Promise<ViewportMetaResult>}
     */
-    static compute_(MetaElements: LH.GathererArtifacts['MetaElements']): Promise<ViewportMetaResult>;
+    static compute_(MetaElements: LH.GathererArtifacts["MetaElements"]): Promise<ViewportMetaResult>;
 }
 //# sourceMappingURL=viewport-meta.d.ts.map

package/core/config/config-helpers.d.ts

@@ -1,5 +1,5 @@
-export type GathererConstructor = typeof import('../gather/base-gatherer.js').default;
-export type Audit = typeof import('../audits/audit.js')['Audit'];
+export type GathererConstructor = typeof import("../gather/base-gatherer.js").default;
+export type Audit = typeof import("../audits/audit.js")["Audit"];
 export type Gatherer = InstanceType<GathererConstructor>;
 /**
  * // TODO(bckenny): could adopt "jsonified" type to ensure T will survive JSON
@@ -32,7 +32,7 @@ export const mergeConfigFragment: LH.Config.Merge;
  * @param {(item: T) => string} keyFn
  * @return {Array<T>}
  */
-export function mergeConfigFragmentArrayByKey<T extends Record<string, any>>(baseArray: T[] | null | undefined, extensionArray: T[] | null | undefined, keyFn: (item: T) => string): T[];
+export function mergeConfigFragmentArrayByKey<T extends Record<string, any>>(baseArray: Array<T> | null | undefined, extensionArray: Array<T> | null | undefined, keyFn: (item: T) => string): Array<T>;
 /**
  * If any items with identical `path` properties are found in the input array,
  * merge their `options` properties into the first instance and then discard any
@@ -42,7 +42,7 @@ export function mergeConfigFragmentArrayByKey<T extends Record<string, any>>(bas
  * @return T[]
  */
 export function mergeOptionsOfItems<T extends {
-    path?: string | undefined;
+    path?: string;
     options: Record<string, unknown>;
 }>(items: T[]): T[];
 /**
@@ -62,7 +62,7 @@ export function mergePlugins(config: LH.Config, configDir: string | undefined, f
  * @param {string=} configDir
  * @return {Promise<Array<LH.Config.AuditDefn>|null>}
  */
-export function resolveAuditsToDefns(audits: LH.Config['audits'], configDir?: string | undefined): Promise<Array<LH.Config.AuditDefn> | null>;
+export function resolveAuditsToDefns(audits: LH.Config["audits"], configDir?: string | undefined): Promise<Array<LH.Config.AuditDefn> | null>;
 /**
  * Turns a GathererJson into a GathererDefn which involves a few main steps:
  *    - Expanding the JSON shorthand the full definition format.

package/core/config/config.d.ts

@@ -4,11 +4,11 @@
  * @return {{configWorkingCopy: LH.Config, configDir?: string, configPath?: string}}
  */
 export function resolveWorkingCopy(config: LH.Config | undefined, context: {
-    configPath?: string | undefined;
+    configPath?: string;
 }): {
     configWorkingCopy: LH.Config;
-    configDir?: string | undefined;
-    configPath?: string | undefined;
+    configDir?: string;
+    configPath?: string;
 };
 /**
  * @param {LH.Gatherer.GatherMode} gatherMode

package/core/config/constants.d.ts

@@ -37,20 +37,20 @@ export namespace userAgents {
 /** @type {LH.Config.Settings} */
 export const defaultSettings: LH.Config.Settings;
 export namespace nonSimulatedSettingsOverrides {
-    const pauseAfterFcpMs: number;
-    const pauseAfterLoadMs: number;
-    const networkQuietThresholdMs: number;
-    const cpuQuietThresholdMs: number;
+    let pauseAfterFcpMs: number;
+    let pauseAfterLoadMs: number;
+    let networkQuietThresholdMs: number;
+    let cpuQuietThresholdMs: number;
 }
 /**
  * @type {Required<LH.SharedFlagsSettings['screenEmulation']>}
  */
-declare const MOTOGPOWER_EMULATION_METRICS: Required<LH.SharedFlagsSettings['screenEmulation']>;
+declare const MOTOGPOWER_EMULATION_METRICS: Required<LH.SharedFlagsSettings["screenEmulation"]>;
 /**
  * Desktop metrics adapted from emulated_devices/module.json
  * @type {Required<LH.SharedFlagsSettings['screenEmulation']>}
  */
-declare const DESKTOP_EMULATION_METRICS: Required<LH.SharedFlagsSettings['screenEmulation']>;
+declare const DESKTOP_EMULATION_METRICS: Required<LH.SharedFlagsSettings["screenEmulation"]>;
 declare const MOTOG4_USERAGENT: "Mozilla/5.0 (Linux; Android 11; moto g power (2022)) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Mobile Safari/537.36";
 declare const DESKTOP_USERAGENT: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36";
 export {};

package/core/config/filters.d.ts

@@ -14,7 +14,7 @@ export function filterConfigByGatherMode(resolvedConfig: LH.Config.ResolvedConfi
  * @param {Pick<LH.Config.Settings, 'onlyAudits'|'onlyCategories'|'skipAudits'>} filters
  * @return {LH.Config.ResolvedConfig}
  */
-export function filterConfigByExplicitFilters(resolvedConfig: LH.Config.ResolvedConfig, filters: Pick<LH.Config.Settings, 'onlyAudits' | 'onlyCategories' | 'skipAudits'>): LH.Config.ResolvedConfig;
+export function filterConfigByExplicitFilters(resolvedConfig: LH.Config.ResolvedConfig, filters: Pick<LH.Config.Settings, "onlyAudits" | "onlyCategories" | "skipAudits">): LH.Config.ResolvedConfig;
 /**
  * Filters an array of artifacts down to the set that supports the specified gather mode.
  *
@@ -22,7 +22,7 @@ export function filterConfigByExplicitFilters(resolvedConfig: LH.Config.Resolved
  * @param {LH.Gatherer.GatherMode} mode
  * @return {LH.Config.ResolvedConfig['artifacts']}
  */
-export function filterArtifactsByGatherMode(artifacts: LH.Config.ResolvedConfig['artifacts'], mode: LH.Gatherer.GatherMode): LH.Config.ResolvedConfig['artifacts'];
+export function filterArtifactsByGatherMode(artifacts: LH.Config.ResolvedConfig["artifacts"], mode: LH.Gatherer.GatherMode): LH.Config.ResolvedConfig["artifacts"];
 /**
  * Filters an array of artifacts down to the set that's required by the specified audits.
  *
@@ -30,7 +30,7 @@ export function filterArtifactsByGatherMode(artifacts: LH.Config.ResolvedConfig[
  * @param {LH.Config.ResolvedConfig['audits']} audits
  * @return {LH.Config.ResolvedConfig['artifacts']}
  */
-export function filterArtifactsByAvailableAudits(artifacts: LH.Config.ResolvedConfig['artifacts'], audits: LH.Config.ResolvedConfig['audits']): LH.Config.ResolvedConfig['artifacts'];
+export function filterArtifactsByAvailableAudits(artifacts: LH.Config.ResolvedConfig["artifacts"], audits: LH.Config.ResolvedConfig["audits"]): LH.Config.ResolvedConfig["artifacts"];
 /**
  * Filters an array of audits down to the set that can be computed using only the specified artifacts.
  *
@@ -38,7 +38,7 @@ export function filterArtifactsByAvailableAudits(artifacts: LH.Config.ResolvedCo
  * @param {Array<LH.Config.AnyArtifactDefn>} availableArtifacts
  * @return {LH.Config.ResolvedConfig['audits']}
  */
-export function filterAuditsByAvailableArtifacts(audits: LH.Config.ResolvedConfig['audits'], availableArtifacts: Array<LH.Config.AnyArtifactDefn>): LH.Config.ResolvedConfig['audits'];
+export function filterAuditsByAvailableArtifacts(audits: LH.Config.ResolvedConfig["audits"], availableArtifacts: Array<LH.Config.AnyArtifactDefn>): LH.Config.ResolvedConfig["audits"];
 /**
  * Optional `supportedModes` property can explicitly exclude an audit even if all required artifacts are available.
  *
@@ -46,7 +46,7 @@ export function filterAuditsByAvailableArtifacts(audits: LH.Config.ResolvedConfi
  * @param {LH.Gatherer.GatherMode} mode
  * @return {LH.Config.ResolvedConfig['audits']}
  */
-export function filterAuditsByGatherMode(audits: LH.Config.ResolvedConfig['audits'], mode: LH.Gatherer.GatherMode): LH.Config.ResolvedConfig['audits'];
+export function filterAuditsByGatherMode(audits: LH.Config.ResolvedConfig["audits"], mode: LH.Gatherer.GatherMode): LH.Config.ResolvedConfig["audits"];
 /**
  * Filters a categories object and their auditRefs down to the set that can be computed using
  * only the specified audits.
@@ -55,7 +55,7 @@ export function filterAuditsByGatherMode(audits: LH.Config.ResolvedConfig['audit
  * @param {Array<LH.Config.AuditDefn>} availableAudits
  * @return {LH.Config.ResolvedConfig['categories']}
  */
-export function filterCategoriesByAvailableAudits(categories: LH.Config.ResolvedConfig['categories'], availableAudits: Array<LH.Config.AuditDefn>): LH.Config.ResolvedConfig['categories'];
+export function filterCategoriesByAvailableAudits(categories: LH.Config.ResolvedConfig["categories"], availableAudits: Array<LH.Config.AuditDefn>): LH.Config.ResolvedConfig["categories"];
 /**
  * Filters a categories object and their auditRefs down to the specified category ids.
  *
@@ -63,7 +63,7 @@ export function filterCategoriesByAvailableAudits(categories: LH.Config.Resolved
  * @param {string[] | null | undefined} onlyCategories
  * @return {LH.Config.ResolvedConfig['categories']}
  */
-export function filterCategoriesByExplicitFilters(categories: LH.Config.ResolvedConfig['categories'], onlyCategories: string[] | null | undefined): LH.Config.ResolvedConfig['categories'];
+export function filterCategoriesByExplicitFilters(categories: LH.Config.ResolvedConfig["categories"], onlyCategories: string[] | null | undefined): LH.Config.ResolvedConfig["categories"];
 /**
  * Optional `supportedModes` property can explicitly exclude a category even if some audits are available.
  *
@@ -71,5 +71,5 @@ export function filterCategoriesByExplicitFilters(categories: LH.Config.Resolved
  * @param {LH.Gatherer.GatherMode} mode
  * @return {LH.Config.ResolvedConfig['categories']}
  */
-export function filterCategoriesByGatherMode(categories: LH.Config.ResolvedConfig['categories'], mode: LH.Gatherer.GatherMode): LH.Config.ResolvedConfig['categories'];
+export function filterCategoriesByGatherMode(categories: LH.Config.ResolvedConfig["categories"], mode: LH.Gatherer.GatherMode): LH.Config.ResolvedConfig["categories"];
 //# sourceMappingURL=filters.d.ts.map

package/core/config/validation.d.ts

@@ -30,7 +30,7 @@ export function assertValidAudit(auditDefinition: LH.Config.AuditDefn): void;
  * @param {LH.Config.ResolvedConfig['audits']} audits
  * @param {LH.Config.ResolvedConfig['groups']} groups
  */
-export function assertValidCategories(categories: LH.Config.ResolvedConfig['categories'], audits: LH.Config.ResolvedConfig['audits'], groups: LH.Config.ResolvedConfig['groups']): void;
+export function assertValidCategories(categories: LH.Config.ResolvedConfig["categories"], audits: LH.Config.ResolvedConfig["audits"], groups: LH.Config.ResolvedConfig["groups"]): void;
 /**
  * Validate the settings after they've been built.
  * @param {LH.Config.Settings} settings

package/core/gather/driver/environment.d.ts

@@ -1,11 +1,11 @@
 export namespace UIStrings {
-    const warningSlowHostCpu: string;
+    let warningSlowHostCpu: string;
 }
 /**
  * @param {LH.Gatherer.ProtocolSession} session
  * @return {Promise<LH.Crdp.Browser.GetVersionResponse & {milestone: number}>}
  */
-export function getBrowserVersion(session: LH.Gatherer.ProtocolSession): Promise<import("devtools-protocol").Protocol.Browser.GetVersionResponse & {
+export function getBrowserVersion(session: LH.Gatherer.ProtocolSession): Promise<LH.Crdp.Browser.GetVersionResponse & {
     milestone: number;
 }>;
 /**
@@ -13,7 +13,7 @@ export function getBrowserVersion(session: LH.Gatherer.ProtocolSession): Promise
  * @param {LH.Gatherer.Driver['executionContext']} executionContext
  * @return {Promise<number>}
  */
-export function getBenchmarkIndex(executionContext: LH.Gatherer.Driver['executionContext']): Promise<number>;
+export function getBenchmarkIndex(executionContext: LH.Gatherer.Driver["executionContext"]): Promise<number>;
 /**
  * Returns a warning if the host device appeared to be underpowered according to BenchmarkIndex.
  *
@@ -22,7 +22,7 @@ export function getBenchmarkIndex(executionContext: LH.Gatherer.Driver['executio
  */
 export function getSlowHostCpuWarning(context: {
     settings: LH.Config.Settings;
-    baseArtifacts: Pick<LH.Artifacts, 'BenchmarkIndex'>;
+    baseArtifacts: Pick<LH.Artifacts, "BenchmarkIndex">;
 }): LH.IcuMessage | undefined;
 /**
  * @param {{settings: LH.Config.Settings, baseArtifacts: Pick<LH.Artifacts, 'BenchmarkIndex'>}} context
@@ -30,6 +30,6 @@ export function getSlowHostCpuWarning(context: {
  */
 export function getEnvironmentWarnings(context: {
     settings: LH.Config.Settings;
-    baseArtifacts: Pick<LH.Artifacts, 'BenchmarkIndex'>;
+    baseArtifacts: Pick<LH.Artifacts, "BenchmarkIndex">;
 }): Array<LH.IcuMessage>;
 //# sourceMappingURL=environment.d.ts.map

package/core/gather/driver/environment.js

@@ -93,7 +93,7 @@ function getSlowHostCpuWarning(context) {
 function getEnvironmentWarnings(context) {
   return [
     getSlowHostCpuWarning(context),
-  ].filter(/** @return {s is LH.IcuMessage} */ s => !!s);
+  ].filter(s => !!s);
 }
 
 export {

package/core/gather/driver/execution-context.d.ts

@@ -82,10 +82,10 @@ export class ExecutionContext {
      *   defined for `mainFn` to work.
      * @return {Promise<Awaited<R>>}
      */
-    evaluate<T extends unknown[], R>(mainFn: (...args: T) => R, options: {
+    evaluate<T extends unknown[], R>(mainFn: ((...args: T) => R), options: {
         args: T;
-        useIsolation?: boolean | undefined;
-        deps?: (string | Function)[] | undefined;
+        useIsolation?: boolean;
+        deps?: Array<Function | string>;
     }): Promise<Awaited<R>>;
     /**
      * Evaluate a function on every new frame from now on.
@@ -96,9 +96,9 @@ export class ExecutionContext {
      *   defined for `mainFn` to work.
      * @return {Promise<void>}
      */
-    evaluateOnNewDocument<T_1 extends unknown[]>(mainFn: (...args: T_1) => void, options: {
-        args: T_1;
-        deps?: (string | Function)[] | undefined;
+    evaluateOnNewDocument<T extends unknown[]>(mainFn: ((...args: T) => void), options: {
+        args: T;
+        deps?: Array<Function | string>;
     }): Promise<void>;
     /**
      * Cache native functions/objects inside window so we are sure polyfills do not overwrite the

package/core/gather/driver/navigation.d.ts

@@ -1,5 +1,5 @@
 export type NavigationOptions = {
-    waitUntil: Array<'fcp' | 'load' | 'navigated'>;
+    waitUntil: Array<"fcp" | "load" | "navigated">;
 } & Partial<LH.Config.Settings>;
 /**
  * Navigates to the given URL, assuming that the page is not already on this URL.
@@ -27,7 +27,7 @@ export function getNavigationWarnings(navigation: {
     mainDocumentUrl: string;
 }): Array<LH.IcuMessage>;
 export namespace UIStrings {
-    const warningRedirected: string;
-    const warningTimeout: string;
+    let warningRedirected: string;
+    let warningTimeout: string;
 }
 //# sourceMappingURL=navigation.d.ts.map

package/core/gather/driver/network-monitor.d.ts

@@ -1,5 +1,5 @@
-export type NetworkRecorderEventMap = import('../../lib/network-recorder.js').NetworkRecorderEventMap;
-export type NetworkMonitorEvent_ = 'network-2-idle' | 'network-critical-idle' | 'networkidle' | 'networkbusy' | 'network-critical-busy' | 'network-2-busy';
+export type NetworkRecorderEventMap = import("../../lib/network-recorder.js").NetworkRecorderEventMap;
+export type NetworkMonitorEvent_ = "network-2-idle" | "network-critical-idle" | "networkidle" | "networkbusy" | "network-critical-busy" | "network-2-busy";
 export type NetworkMonitorEventMap = Record<NetworkMonitorEvent_, []> & NetworkRecorderEventMap;
 export type NetworkMonitorEvent = keyof NetworkMonitorEventMap;
 export type NetworkMonitorEmitter = LH.Protocol.StrictEventEmitterClass<NetworkMonitorEventMap>;
@@ -19,13 +19,13 @@ export class NetworkMonitor extends NetworkMonitor_base {
         end: number;
     }>;
     /** @param {LH.Gatherer.Driver['targetManager']} targetManager */
-    constructor(targetManager: LH.Gatherer.Driver['targetManager']);
+    constructor(targetManager: LH.Gatherer.Driver["targetManager"]);
     /** @type {NetworkRecorder|undefined} */
     _networkRecorder: NetworkRecorder | undefined;
     /** @type {Array<LH.Crdp.Page.Frame>} */
     _frameNavigations: Array<LH.Crdp.Page.Frame>;
     /** @type {LH.Gatherer.Driver['targetManager']} */
-    _targetManager: LH.Gatherer.Driver['targetManager'];
+    _targetManager: LH.Gatherer.Driver["targetManager"];
     /** @type {LH.Gatherer.ProtocolSession} */
     _session: LH.Gatherer.ProtocolSession;
     /** @param {LH.Crdp.Page.FrameNavigatedEvent} event */
@@ -42,8 +42,8 @@ export class NetworkMonitor extends NetworkMonitor_base {
     disable(): Promise<void>;
     /** @return {Promise<{requestedUrl?: string, mainDocumentUrl?: string}>} */
     getNavigationUrls(): Promise<{
-        requestedUrl?: string | undefined;
-        mainDocumentUrl?: string | undefined;
+        requestedUrl?: string;
+        mainDocumentUrl?: string;
     }>;
     /**
      * @return {Array<NetworkRequest>}

package/core/gather/driver/storage.d.ts

@@ -4,7 +4,7 @@
  * @param {LH.Config.Settings['clearStorageTypes']} clearStorageTypes
  * @return {Promise<LH.IcuMessage[]>}
  */
-export function clearDataForOrigin(session: LH.Gatherer.ProtocolSession, url: string, clearStorageTypes: LH.Config.Settings['clearStorageTypes']): Promise<LH.IcuMessage[]>;
+export function clearDataForOrigin(session: LH.Gatherer.ProtocolSession, url: string, clearStorageTypes: LH.Config.Settings["clearStorageTypes"]): Promise<LH.IcuMessage[]>;
 /**
  * Clear the network cache on disk and in memory.
  * @param {LH.Gatherer.ProtocolSession} session
@@ -18,8 +18,8 @@ export function clearBrowserCaches(session: LH.Gatherer.ProtocolSession): Promis
  */
 export function getImportantStorageWarning(session: LH.Gatherer.ProtocolSession, url: string): Promise<LH.IcuMessage | undefined>;
 export namespace UIStrings {
-    const warningData: string;
-    const warningCacheTimeout: string;
-    const warningOriginDataTimeout: string;
+    let warningData: string;
+    let warningCacheTimeout: string;
+    let warningOriginDataTimeout: string;
 }
 //# sourceMappingURL=storage.d.ts.map