lighthouse 12.0.0-dev.20240610 → 12.0.0-dev.20240612

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lighthouse",
   "type": "module",
-  "version": "12.0.0-dev.20240610",
+  "version": "12.0.0-dev.20240612",
   "description": "Automated auditing, performance metrics, and best practices for the web.",
   "main": "./core/index.js",
   "bin": {
@@ -184,10 +184,10 @@
     "@paulirish/trace_engine": "^0.0.23",
     "@sentry/node": "^6.17.4",
     "axe-core": "^4.9.1",
-    "chrome-launcher": "^1.1.1",
+    "chrome-launcher": "^1.1.2",
     "configstore": "^5.0.1",
     "csp_evaluator": "1.1.1",
-    "devtools-protocol": "0.0.1299070",
+    "devtools-protocol": "0.0.1312386",
     "enquirer": "^2.3.6",
     "http-link-header": "^1.1.1",
     "intl-messageformat": "^10.5.3",
@@ -211,8 +211,8 @@
     "yargs-parser": "^21.0.0"
   },
   "resolutions": {
-    "puppeteer/**/devtools-protocol": "0.0.1299070",
-    "puppeteer-core/**/devtools-protocol": "0.0.1299070"
+    "puppeteer/**/devtools-protocol": "0.0.1312386",
+    "puppeteer-core/**/devtools-protocol": "0.0.1312386"
   },
   "repository": "GoogleChrome/lighthouse",
   "keywords": [

package/tsconfig.json

@@ -66,13 +66,15 @@
     "core/test/lib/emulation-test.js",
     "core/test/lib/i18n/i18n-test.js",
     "core/test/lib/icons-test.js",
-    "core/test/lib/lantern/base-node-test.js",
-    "core/test/lib/lantern/metrics/*",
-    "core/test/lib/lantern/page-dependency-graph-test.js",
-    "core/test/lib/lantern/simulator/connection-pool-test.js",
-    "core/test/lib/lantern/simulator/dns-cache-test.js",
-    "core/test/lib/lantern/simulator/network-analyzer-test.js",
-    "core/test/lib/lantern/simulator/simulator-test.js",
+    // TODO(15841): remove when importing Lantern from npm
+    "core/lib/lantern/BaseNode.test.js",
+    "core/lib/lantern/metrics/*.test.js",
+    "core/lib/lantern/PageDependencyGraph.test.js",
+    "core/lib/lantern/simulation/ConnectionPool.test.js",
+    "core/lib/lantern/simulation/DNSCache.test.js",
+    "core/lib/lantern/simulation/NetworkAnalyzer.test.js",
+    "core/lib/lantern/simulation/Simulator.test.js",
+    // ------ done TODO
     "core/test/lib/lh-element-test.js",
     "core/test/lib/lighthouse-compatibility-test.js",
     "core/test/lib/manifest-parser-test.js",
@@ -109,6 +111,6 @@
     "core/test/computed/metrics/interactive-test.js",
     "core/test/computed/tbt-impact-tasks-test.js",
     "core/test/fixtures/config-plugins/lighthouse-plugin-simple/plugin-simple.js",
-    "core/test/lib/lantern/metrics/metric-test-utils.js",
+    "core/lib/lantern/metrics/MetricTestUtils.js",
   ],
 }

package/types/artifacts.d.ts

@@ -6,10 +6,10 @@
 
 import {Protocol as Crdp} from 'devtools-protocol/types/protocol.js';
 import * as TraceEngine from '@paulirish/trace_engine';
+import * as Lantern from '../core/lib/lantern/lantern.js';
 import {LayoutShiftRootCausesData} from '@paulirish/trace_engine/models/trace/root-causes/LayoutShift.js';
 
 import {parseManifest} from '../core/lib/manifest-parser.js';
-import {Simulator} from '../core/lib/lantern/simulator/simulator.js';
 import {LighthouseError} from '../core/lib/lh-error.js';
 import {NetworkRequest as _NetworkRequest} from '../core/lib/network-request.js';
 import speedline from 'speedline-core';
@@ -565,7 +565,7 @@ declare module Artifacts {
     trace: Trace;
     settings: Audit.Context['settings'];
     gatherContext: Artifacts['GatherContext'];
-    simulator?: InstanceType<typeof Simulator>;
+    simulator?: InstanceType<typeof Lantern.Simulation.Simulator>;
     URL: Artifacts['URL'];
   }
 
@@ -591,14 +591,7 @@ declare module Artifacts {
     throughput: number;
   }
 
-  interface LanternMetric {
-    timing: number;
-    timestamp?: never;
-    optimisticEstimate: Gatherer.Simulation.Result
-    pessimisticEstimate: Gatherer.Simulation.Result;
-    optimisticGraph: Gatherer.Simulation.GraphNode;
-    pessimisticGraph: Gatherer.Simulation.GraphNode;
-  }
+  type LanternMetric = Lantern.Metrics.Result<Artifacts.NetworkRequest>;
 
   type Speedline = speedline.Output<'speedIndex'>;
 

package/types/gatherer.d.ts

@@ -17,7 +17,7 @@ import Config from './config.js';
 import Result from './lhr/lhr.js';
 import Protocol from './protocol.js';
 import Puppeteer from './puppeteer.js';
-import * as Lantern from '../core/lib/lantern/types/lantern.js';
+import * as Lantern from '../core/lib/lantern/lantern.js';
 
 type CrdpEvents = CrdpMappings.Events;
 type CrdpCommands = CrdpMappings.Commands;

package/core/lib/lantern/cpu-node.d.ts

@@ -1,44 +0,0 @@
-/**
- * @template [T=any]
- * @extends {BaseNode<T>}
- */
-export class CPUNode<T = any> extends BaseNode<T> {
-    /**
-     * @param {LH.TraceEvent} parentEvent
-     * @param {LH.TraceEvent[]=} childEvents
-     * @param {number=} correctedEndTs
-     */
-    constructor(parentEvent: LH.TraceEvent, childEvents?: LH.TraceEvent[] | undefined, correctedEndTs?: number | undefined);
-    _event: LH.TraceEvent;
-    _childEvents: LH.TraceEvent[];
-    _correctedEndTs: number | undefined;
-    get type(): "cpu";
-    /**
-     * @return {number}
-     */
-    get duration(): number;
-    /**
-     * @return {LH.TraceEvent}
-     */
-    get event(): LH.TraceEvent;
-    /**
-     * @return {LH.TraceEvent[]}
-     */
-    get childEvents(): LH.TraceEvent[];
-    /**
-     * Returns true if this node contains a Layout task.
-     * @return {boolean}
-     */
-    didPerformLayout(): boolean;
-    /**
-     * Returns the script URLs that had their EvaluateScript events occur in this task.
-     */
-    getEvaluateScriptURLs(): Set<string>;
-    /**
-     * @return {CPUNode}
-     */
-    cloneWithoutRelationships(): CPUNode;
-}
-import { BaseNode } from './base-node.js';
-import * as LH from '../../../types/lh.js';
-//# sourceMappingURL=cpu-node.d.ts.map

package/core/lib/lantern/metrics/interactive.d.ts

@@ -1,26 +0,0 @@
-export type Node = import('../base-node.js').Node;
-export class Interactive extends Metric {
-    /**
-     * @param {Node} dependencyGraph
-     * @return {Node}
-     */
-    static getOptimisticGraph(dependencyGraph: Node): Node;
-    /**
-     * @param {Node} dependencyGraph
-     * @return {Node}
-     */
-    static getPessimisticGraph(dependencyGraph: Node): Node;
-    /**
-     * @param {LH.Gatherer.Simulation.Result} simulationResult
-     * @param {import('../metric.js').Extras} extras
-     * @return {LH.Gatherer.Simulation.Result}
-     */
-    static getEstimateFromSimulation(simulationResult: LH.Gatherer.Simulation.Result, extras: import('../metric.js').Extras): LH.Gatherer.Simulation.Result;
-    /**
-     * @param {LH.Gatherer.Simulation.Result['nodeTimings']} nodeTimings
-     * @return {number}
-     */
-    static getLastLongTaskEndTime(nodeTimings: LH.Gatherer.Simulation.Result['nodeTimings'], duration?: number): number;
-}
-import { Metric } from '../metric.js';
-//# sourceMappingURL=interactive.d.ts.map

package/core/lib/lantern/metrics/largest-contentful-paint.d.ts

@@ -1,19 +0,0 @@
-export type Node = import('../base-node.js').Node;
-/** @typedef {import('../base-node.js').Node} Node */
-export class LargestContentfulPaint extends Metric {
-    /**
-     * Low priority image nodes are usually offscreen and very unlikely to be the
-     * resource that is required for LCP. Our LCP graphs include everything except for these images.
-     *
-     * @param {Node} node
-     * @return {boolean}
-     */
-    static isNotLowPriorityImageNode(node: Node): boolean;
-    /**
-     * @param {LH.Gatherer.Simulation.Result} simulationResult
-     * @return {LH.Gatherer.Simulation.Result}
-     */
-    static getEstimateFromSimulation(simulationResult: LH.Gatherer.Simulation.Result): LH.Gatherer.Simulation.Result;
-}
-import { Metric } from '../metric.js';
-//# sourceMappingURL=largest-contentful-paint.d.ts.map

package/core/lib/lantern/metrics/max-potential-fid.d.ts

@@ -1,30 +0,0 @@
-export type Node = import('../base-node.js').Node;
-/** @typedef {import('../base-node.js').Node} Node */
-export class MaxPotentialFID extends Metric {
-    /**
-     * @param {Node} dependencyGraph
-     * @return {Node}
-     */
-    static getOptimisticGraph(dependencyGraph: Node): Node;
-    /**
-     * @param {Node} dependencyGraph
-     * @return {Node}
-     */
-    static getPessimisticGraph(dependencyGraph: Node): Node;
-    /**
-     * @param {LH.Gatherer.Simulation.Result} simulation
-     * @param {import('../metric.js').Extras} extras
-     * @return {LH.Gatherer.Simulation.Result}
-     */
-    static getEstimateFromSimulation(simulation: LH.Gatherer.Simulation.Result, extras: import('../metric.js').Extras): LH.Gatherer.Simulation.Result;
-    /**
-     * @param {LH.Gatherer.Simulation.Result['nodeTimings']} nodeTimings
-     * @param {number} fcpTimeInMs
-     * @return {Array<{duration: number}>}
-     */
-    static getTimingsAfterFCP(nodeTimings: LH.Gatherer.Simulation.Result['nodeTimings'], fcpTimeInMs: number): Array<{
-        duration: number;
-    }>;
-}
-import { Metric } from '../metric.js';
-//# sourceMappingURL=max-potential-fid.d.ts.map

package/core/lib/lantern/metrics/total-blocking-time.d.ts

@@ -1,31 +0,0 @@
-export type Node = import('../base-node.js').Node;
-/** @typedef {import('../base-node.js').Node} Node */
-export class TotalBlockingTime extends Metric {
-    /**
-     * @param {Node} dependencyGraph
-     * @return {Node}
-     */
-    static getOptimisticGraph(dependencyGraph: Node): Node;
-    /**
-     * @param {Node} dependencyGraph
-     * @return {Node}
-     */
-    static getPessimisticGraph(dependencyGraph: Node): Node;
-    /**
-     * @param {LH.Gatherer.Simulation.Result} simulation
-     * @param {import('../metric.js').Extras} extras
-     * @return {LH.Gatherer.Simulation.Result}
-     */
-    static getEstimateFromSimulation(simulation: LH.Gatherer.Simulation.Result, extras: import('../metric.js').Extras): LH.Gatherer.Simulation.Result;
-    /**
-     * @param {LH.Gatherer.Simulation.Result['nodeTimings']} nodeTimings
-     * @param {number} minDurationMs
-     */
-    static getTopLevelEvents(nodeTimings: LH.Gatherer.Simulation.Result['nodeTimings'], minDurationMs: number): {
-        start: number;
-        end: number;
-        duration: number;
-    }[];
-}
-import { Metric } from '../metric.js';
-//# sourceMappingURL=total-blocking-time.d.ts.map