lighthouse 12.5.0 → 12.5.1-dev.20250327

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

@@ -20,7 +20,7 @@ export type Summary = {
     sourcesWastedBytes?: Record<string, number> | undefined;
 };
 declare const UnusedJavascriptSummaryComputed: typeof UnusedJavascriptSummary & {
-    request: (dependencies: ComputeInput, context: LH.Artifacts.ComputedContext) => ReturnType<typeof UnusedJavascriptSummary.compute_>;
+    request: (dependencies: ComputeInput, context: LH.Artifacts.ComputedContext) => Promise<Summary>;
 };
 /**
  * @typedef WasteData

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

@@ -14,7 +14,7 @@ export type MeasureEvent = {
     duration: number;
 };
 declare const UserTimingsComputed: typeof UserTimings & {
-    request: (dependencies: import("../index.js").Trace, context: LH.Artifacts.ComputedContext) => ReturnType<typeof UserTimings.compute_>;
+    request: (dependencies: import("../index.js").Trace, context: LH.Artifacts.ComputedContext) => Promise<(MarkEvent | MeasureEvent)[]>;
 };
 /** @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

@@ -25,7 +25,7 @@ declare const ViewportMetaComputed: typeof ViewportMeta & {
         httpEquiv?: string;
         charset?: string;
         node: import("../index.js").Artifacts.NodeDetails;
-    }[], context: LH.Artifacts.ComputedContext) => ReturnType<typeof ViewportMeta.compute_>;
+    }[], context: LH.Artifacts.ComputedContext) => Promise<ViewportMetaResult>;
 };
 declare class ViewportMeta {
     /**

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

@@ -71,7 +71,7 @@ export class NetworkMonitor extends NetworkMonitor_base {
      * @param {(request: NetworkRequest) => boolean} [requestFilter]
      * @return {boolean}
      */
-    _isIdlePeriod(allowedRequests: number, requestFilter?: ((request: NetworkRequest) => boolean) | undefined): boolean;
+    _isIdlePeriod(allowedRequests: number, requestFilter?: (request: NetworkRequest) => boolean): boolean;
     /**
      * Emits the appropriate network status event.
      */

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

@@ -6,5 +6,5 @@
  * @param {number} [timeout]
  * @return {Promise<string>}
  */
-export function fetchResponseBodyFromCache(session: LH.Gatherer.ProtocolSession, requestId: string, timeout?: number | undefined): Promise<string>;
+export function fetchResponseBodyFromCache(session: LH.Gatherer.ProtocolSession, requestId: string, timeout?: number): Promise<string>;
 //# sourceMappingURL=network.d.ts.map

package/core/gather/driver.d.ts

@@ -15,7 +15,7 @@ export class Driver implements LH.Gatherer.Driver {
     _fetcher: Fetcher | undefined;
     defaultSession: import("../../types/gatherer.js").default.ProtocolSession;
     /** @return {LH.Gatherer.Driver['executionContext']} */
-    get executionContext(): ExecutionContext;
+    get executionContext(): LH.Gatherer.Driver["executionContext"];
     get fetcher(): any;
     get targetManager(): any;
     get networkMonitor(): any;

package/core/gather/gatherers/devtools-log.d.ts

@@ -38,7 +38,7 @@ export class DevtoolsMessageLog {
     /**
      * @return {LH.DevtoolsLog}
      */
-    get messages(): import("../../index.js").DevtoolsLog;
+    get messages(): LH.DevtoolsLog;
     reset(): void;
     beginRecording(): void;
     endRecording(): void;

package/core/gather/navigation-runner.d.ts

@@ -16,7 +16,7 @@ export type PhaseState = Omit<Parameters<typeof collectPhaseArtifacts>[0], "phas
 export function navigationGather(page: LH.Puppeteer.Page | undefined, requestor: LH.NavigationRequestor | undefined, options?: {
     config?: LH.Config;
     flags?: LH.Flags;
-} | undefined): Promise<LH.Gatherer.GatherResult>;
+}): Promise<LH.Gatherer.GatherResult>;
 /**
  * @param {{driver: Driver, resolvedConfig: LH.Config.ResolvedConfig, requestor: LH.NavigationRequestor}} args
  * @return {Promise<{baseArtifacts: LH.BaseArtifacts}>}

package/core/gather/snapshot-runner.d.ts

@@ -6,5 +6,5 @@
 export function snapshotGather(page: LH.Puppeteer.Page, options?: {
     config?: LH.Config;
     flags?: LH.Flags;
-} | undefined): Promise<LH.Gatherer.GatherResult>;
+}): Promise<LH.Gatherer.GatherResult>;
 //# sourceMappingURL=snapshot-runner.d.ts.map

package/core/gather/timespan-runner.d.ts

@@ -6,7 +6,7 @@
 export function startTimespanGather(page: LH.Puppeteer.Page, options?: {
     config?: LH.Config;
     flags?: LH.Flags;
-} | undefined): Promise<{
+}): Promise<{
     endTimespanGather(): Promise<LH.Gatherer.GatherResult>;
 }>;
 export namespace UIStrings {

package/core/index.d.ts

@@ -20,7 +20,7 @@ declare function lighthouse(url?: string | undefined, flags?: LH.Flags | undefin
  * @param {LH.Puppeteer.Page} page
  * @param {LH.UserFlow.Options} [options]
  */
-export function startFlow(page: LH.Puppeteer.Page, options?: LH.UserFlow.Options | undefined): Promise<UserFlow>;
+export function startFlow(page: LH.Puppeteer.Page, options?: LH.UserFlow.Options): Promise<UserFlow>;
 /**
  * @param {LH.Puppeteer.Page|undefined} page
  * @param {LH.NavigationRequestor|undefined} requestor
@@ -30,7 +30,7 @@ export function startFlow(page: LH.Puppeteer.Page, options?: LH.UserFlow.Options
 export function navigation(page: LH.Puppeteer.Page | undefined, requestor: LH.NavigationRequestor | undefined, options?: {
     config?: LH.Config;
     flags?: LH.Flags;
-} | undefined): Promise<LH.RunnerResult | undefined>;
+}): Promise<LH.RunnerResult | undefined>;
 /**
  * @param {LH.Puppeteer.Page} page
  * @param {{config?: LH.Config, flags?: LH.Flags}} [options]
@@ -39,7 +39,7 @@ export function navigation(page: LH.Puppeteer.Page | undefined, requestor: LH.Na
 export function startTimespan(page: LH.Puppeteer.Page, options?: {
     config?: LH.Config;
     flags?: LH.Flags;
-} | undefined): Promise<{
+}): Promise<{
     endTimespan: () => Promise<LH.RunnerResult | undefined>;
 }>;
 /**
@@ -50,19 +50,19 @@ export function startTimespan(page: LH.Puppeteer.Page, options?: {
 export function snapshot(page: LH.Puppeteer.Page, options?: {
     config?: LH.Config;
     flags?: LH.Flags;
-} | undefined): Promise<LH.RunnerResult | undefined>;
+}): Promise<LH.RunnerResult | undefined>;
 /**
  * @template {LH.Result|LH.FlowResult} R
  * @param {R} result
  * @param {[R] extends [LH.Result] ? LH.OutputMode : Exclude<LH.OutputMode, 'csv'>} [format]
  * @return {string}
  */
-export function generateReport<R extends LH.Result | LH.FlowResult>(result: R, format?: ([R] extends [LH.Result] ? LH.OutputMode : "json" | "html") | undefined): string;
+export function generateReport<R extends LH.Result | LH.FlowResult>(result: R, format?: [R] extends [LH.Result] ? LH.OutputMode : Exclude<LH.OutputMode, "csv">): string;
 /**
  * @param {LH.UserFlow.FlowArtifacts} flowArtifacts
  * @param {LH.Config} [config]
  */
-export function auditFlowArtifacts(flowArtifacts: LH.UserFlow.FlowArtifacts, config?: LH.Config | undefined): Promise<{
+export function auditFlowArtifacts(flowArtifacts: LH.UserFlow.FlowArtifacts, config?: LH.Config): Promise<{
     steps: LH.FlowResult.Step[];
     name: string;
 }>;

package/core/lib/asset-saver.d.ts

@@ -60,7 +60,7 @@ export function saveAssets(artifacts: LH.Artifacts, audits: LH.Result["audits"],
  * @param {LH.Result['audits']} [audits]
  * @return {Promise<Array<PreparedAssets>>}
  */
-export function prepareAssets(artifacts: LH.Artifacts, audits?: Record<string, import("../../types/lhr/audit-result.js").Result> | undefined): Promise<Array<PreparedAssets>>;
+export function prepareAssets(artifacts: LH.Artifacts, audits?: LH.Result["audits"]): Promise<Array<PreparedAssets>>;
 /**
  * Save a trace as JSON by streaming to disk at traceFilename.
  * @param {LH.Trace} traceData

package/core/lib/cdt/generated/SourceMap.d.ts

@@ -1,12 +1,15 @@
 export = SourceMap;
 declare class SourceMap {
     /**
+     * @param {string} compiledURL
+     * @param {string} sourceMappingURL
+     * @param {object} payload
      * Implements Source Map V3 model. See https://github.com/google/closure-compiler/wiki/Source-Maps
      * for format description.
      */
-    constructor(compiledURL: any, sourceMappingURL: any, payload: any);
-    compiledURL(): any;
-    url(): any;
+    constructor(compiledURL: string, sourceMappingURL: string, payload: object);
+    compiledURL(): string;
+    url(): string;
     sourceURLs(): any[];
     embeddedContentByURL(sourceURL: any): any;
     hasScopeInfo(): boolean;

package/core/lib/cdt/generated/SourceMap.js

@@ -104,6 +104,9 @@ class SourceMap {
     #sourceInfoByURL = new Map();
     #scopesInfo = null;
     /**
+     * @param {string} compiledURL
+     * @param {string} sourceMappingURL
+     * @param {object} payload
      * Implements Source Map V3 model. See https://github.com/google/closure-compiler/wiki/Source-Maps
      * for format description.
      */

package/core/lib/i18n/i18n.d.ts

@@ -71,7 +71,7 @@ export function lookupLocale(locales?: (string | string[]) | undefined, possible
  * @param {string} filename
  * @param {Record<string, string>=} fileStrings
  */
-export function createIcuMessageFn(filename: string, fileStrings?: Record<string, string> | undefined): (message: string, values?: Record<string, string | number> | undefined) => LH.IcuMessage;
+export function createIcuMessageFn(filename: string, fileStrings?: Record<string, string> | undefined): (message: string, values?: Record<string, string | number>) => LH.IcuMessage;
 /**
  * Returns true if the given value is a string or an LH.IcuMessage.
  * @param {unknown} value

package/core/lib/page-functions.d.ts

@@ -43,7 +43,7 @@ export type ParseSelector<T extends string> = import("typed-query-selector/parse
  * @param {string|Error} [err] The error to convert
  * @return {{__failedInBrowser: boolean, name: string, message: string, stack: string|undefined}}
  */
-declare function wrapRuntimeEvalErrorInBrowser(err?: string | Error | undefined): {
+declare function wrapRuntimeEvalErrorInBrowser(err?: string | Error): {
     __failedInBrowser: boolean;
     name: string;
     message: string;

package/core/lib/tracehouse/cpu-profile-model.d.ts

@@ -223,6 +223,6 @@ export class CpuProfileModel {
      * @param {Array<LH.Artifacts.TaskNode>} [knownTaskNodes]
      * @return {Array<LH.TraceEvent>}
      */
-    synthesizeTraceEvents(knownTaskNodes?: import("./main-thread-tasks.js").TaskNode[] | undefined): Array<LH.TraceEvent>;
+    synthesizeTraceEvents(knownTaskNodes?: Array<LH.Artifacts.TaskNode>): Array<LH.TraceEvent>;
 }
 //# sourceMappingURL=cpu-profile-model.d.ts.map

package/core/lib/tracehouse/main-thread-tasks.d.ts

@@ -59,7 +59,7 @@ export class MainThreadTasks {
      * @param {LH.TraceEvent} [endEvent]
      * @return {TaskNode}
      */
-    static _createNewTaskNode(event: LH.TraceEvent, endEvent?: LH.TraceEvent | undefined): TaskNode;
+    static _createNewTaskNode(event: LH.TraceEvent, endEvent?: LH.TraceEvent): TaskNode;
     /**
      *
      * @param {TaskNode} currentTask
@@ -132,7 +132,7 @@ export class MainThreadTasks {
      * @param {TaskNode} task
      * @param {TaskGroup} [parentGroup]
      */
-    static _computeRecursiveTaskGroup(task: TaskNode, parentGroup?: import("./task-groups.js").TaskGroup | undefined): void;
+    static _computeRecursiveTaskGroup(task: TaskNode, parentGroup?: TaskGroup): void;
     /**
      * @param {LH.TraceEvent[]} mainThreadEvents
      * @param {Array<{id: string, url: string}>} frames
@@ -143,7 +143,7 @@ export class MainThreadTasks {
     static getMainThreadTasks(mainThreadEvents: LH.TraceEvent[], frames: Array<{
         id: string;
         url: string;
-    }>, traceEndTs: number, traceStartTs?: number | undefined): TaskNode[];
+    }>, traceEndTs: number, traceStartTs?: number): TaskNode[];
     /**
      * Prints an artistic rendering of the task tree for easier debugability.
      *

package/core/lib/tracehouse/trace-processor.d.ts

@@ -220,7 +220,7 @@ export class TraceProcessor {
     */
     static processTrace(trace: LH.Trace, options?: {
         timeOriginDeterminationMethod?: TimeOriginDeterminationMethod;
-    } | undefined): LH.Artifacts.ProcessedTrace;
+    }): LH.Artifacts.ProcessedTrace;
     /**
      * Finds key navigation trace events and computes timings of events in milliseconds since the time
      * origin in addition to the standard microsecond monotonic timestamps.

package/core/lib/traces/metric-trace-events.d.ts

@@ -3,11 +3,11 @@ export class MetricTraceEvents {
      * Returns simplified representation of all metrics
      * @return {Array<{id: string, name: string, tsKey: keyof LH.Artifacts.TimingSummary}>} metrics to consider
      */
-    static get metricsDefinitions(): {
+    static get metricsDefinitions(): Array<{
         id: string;
         name: string;
         tsKey: keyof LH.Artifacts.TimingSummary;
-    }[];
+    }>;
     /**
      * @param {Array<LH.TraceEvent>} traceEvents
      * @param {LH.Result['audits']} auditResults