lighthouse 12.1.0 → 12.2.0

package/core/lib/lantern/simulation/simulation.d.ts

@@ -1,21 +0,0 @@
-export { ConnectionPool } from "./ConnectionPool.js";
-export { Constants } from "./Constants.js";
-export { DNSCache } from "./DNSCache.js";
-export { NetworkAnalyzer } from "./NetworkAnalyzer.js";
-export { Simulator } from "./Simulator.js";
-export { SimulatorTimingMap } from "./SimulationTimingMap.js";
-export { TcpConnection } from "./TcpConnection.js";
-export type GraphNetworkNode<T = any> = Lantern.Simulation.GraphNetworkNode<T>;
-export type GraphNode<T = any> = Lantern.Simulation.GraphNode<T>;
-export type Result<T = any> = Lantern.Simulation.Result<T>;
-export type GraphCPUNode = Lantern.Simulation.GraphCPUNode;
-export type MetricCoefficients = Lantern.Simulation.MetricCoefficients;
-export type MetricComputationDataInput = Lantern.Simulation.MetricComputationDataInput;
-export type NodeTiming = Lantern.Simulation.NodeTiming;
-export type Options = Lantern.Simulation.Options;
-export type PrecomputedLanternData = Lantern.Simulation.PrecomputedLanternData;
-export type ProcessedNavigation = Lantern.Simulation.ProcessedNavigation;
-export type Settings = Lantern.Simulation.Settings;
-export type URL = Lantern.Simulation.URL;
-import * as Lantern from '../types/lantern.js';
-//# sourceMappingURL=simulation.d.ts.map

package/core/lib/lantern/simulation/simulation.js

@@ -1,28 +0,0 @@
-/**
- * @license
- * Copyright 2024 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import * as Lantern from '../types/lantern.js';
-
-export {ConnectionPool} from './ConnectionPool.js';
-export {Constants} from './Constants.js';
-export {DNSCache} from './DNSCache.js';
-export {NetworkAnalyzer} from './NetworkAnalyzer.js';
-export {Simulator} from './Simulator.js';
-export {SimulatorTimingMap} from './SimulationTimingMap.js';
-export {TcpConnection} from './TcpConnection.js';
-
-/** @template [T=any] @typedef {Lantern.Simulation.GraphNetworkNode<T>} GraphNetworkNode */
-/** @template [T=any] @typedef {Lantern.Simulation.GraphNode<T>} GraphNode */
-/** @template [T=any] @typedef {Lantern.Simulation.Result<T>} Result */
-/** @typedef {Lantern.Simulation.GraphCPUNode} GraphCPUNode */
-/** @typedef {Lantern.Simulation.MetricCoefficients} MetricCoefficients */
-/** @typedef {Lantern.Simulation.MetricComputationDataInput} MetricComputationDataInput */
-/** @typedef {Lantern.Simulation.NodeTiming} NodeTiming */
-/** @typedef {Lantern.Simulation.Options} Options */
-/** @typedef {Lantern.Simulation.PrecomputedLanternData} PrecomputedLanternData */
-/** @typedef {Lantern.Simulation.ProcessedNavigation} ProcessedNavigation */
-/** @typedef {Lantern.Simulation.Settings} Settings */
-/** @typedef {Lantern.Simulation.URL} URL */

package/core/lib/lantern/types/lantern.d.ts

@@ -1,256 +0,0 @@
-/**
- * @license
- * Copyright 2024 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import * as Protocol from '@paulirish/trace_engine/generated/protocol.js';
-
-declare module Util {
-    /** An object with the keys in the union K mapped to themselves as values. */
-    type SelfMap<K extends string> = {
-        [P in K]: P;
-    };
-}
-
-type TraceEvent = {
-    name: string;
-    cat: string;
-    args: {
-        name?: string;
-        fileName?: string;
-        snapshot?: string;
-        sync_id?: string;
-        beginData?: {
-            frame?: string;
-            startLine?: number;
-            url?: string;
-        };
-        data?: {
-            frame?: string;
-            readyState?: number;
-            stackTrace?: {
-                url: string
-            }[];
-            url?: string;
-        };
-    };
-    pid: number;
-    tid: number;
-    /** Timestamp of the event in microseconds. */
-    ts: number;
-    dur: number;
-}
-type Trace = {traceEvents: TraceEvent[]};
-type ResourcePriority = ('VeryLow' | 'Low' | 'Medium' | 'High' | 'VeryHigh');
-type ResourceType = ('Document' | 'Stylesheet' | 'Image' | 'Media' | 'Font' | 'Script' | 'TextTrack' | 'XHR' | 'Fetch' | 'Prefetch' | 'EventSource' | 'WebSocket' | 'Manifest' | 'SignedExchange' | 'Ping' | 'CSPViolationReport' | 'Preflight' | 'Other');
-type InitiatorType = ('parser' | 'script' | 'preload' | 'SignedExchange' | 'preflight' | 'other');
-type ResourceTiming = Protocol.Network.ResourceTiming;
-type CallStack = {
-    callFrames: Array<{
-        scriptId: string;
-        url: string;
-        lineNumber: number;
-        columnNumber: number;
-        functionName: string;
-    }>;
-    parent?: CallStack;
-}
-
-type ParsedURL = {
-    /**
-     * Equivalent to a `new URL(url).protocol` BUT w/o the trailing colon (:)
-     */
-    scheme: string;
-    /**
-     * Equivalent to a `new URL(url).hostname`
-     */
-    host: string;
-    securityOrigin: string;
-};
-type LightriderStatistics = {
-    /**
-     * The difference in networkEndTime between the observed Lighthouse networkEndTime and Lightrider's derived networkEndTime.
-     */
-    endTimeDeltaMs: number;
-    /**
-     * The time spent making a TCP connection (connect + SSL). Note: this is poorly named.
-     */
-    TCPMs: number;
-    /**
-     * The time spent requesting a resource from a remote server, we use this to approx RTT. Note: this is poorly names, it really should be "server response time".
-     */
-    requestMs: number;
-    /**
-     * Time to receive the entire response payload starting the clock on receiving the first fragment (first non-header byte).
-     */
-    responseMs: number;
-};
-
-export class NetworkRequest<T = any> {
-    /**
-     * Implementation-specifc canoncial data structure that this Lantern NetworkRequest
-     * was derived from.
-     * Users of Lantern create a NetworkRequest matching this interface,
-     * but can store the source-of-truth for their network model in this property.
-     * This is then accessible as a read-only property on NetworkNode.
-     */
-    rawRequest?: T;
-
-    requestId: string;
-    connectionId: number;
-    connectionReused: boolean;
-    url: string;
-    protocol: string;
-    parsedURL: ParsedURL;
-    documentURL: string;
-    /** When the renderer process initially discovers a network request, in milliseconds. */
-    rendererStartTime: number;
-    /**
-     * When the network service is about to handle a request, ie. just before going to the
-     * HTTP cache or going to the network for DNS/connection setup, in milliseconds.
-     */
-    networkRequestTime: number;
-    /**
-     * When the last byte of the response headers is received, in milliseconds.
-     * Equal to networkRequestTime if no data is recieved over the
-     * network (ex: cached requests or data urls).
-     */
-    responseHeadersEndTime: number;
-    /** When the last byte of the response body is received, in milliseconds. */
-    networkEndTime: number;
-    transferSize: number;
-    resourceSize: number;
-    fromDiskCache: boolean;
-    fromMemoryCache: boolean;
-    isLinkPreload: boolean;
-    finished: boolean;
-    failed: boolean;
-    statusCode: number;
-    /** The network request that redirected to this one */
-    redirectSource: NetworkRequest<T> | undefined;
-    /** The network request that this one redirected to */
-    redirectDestination: NetworkRequest<T> | undefined;
-    // TODO: can't use Protocol.Network.Initiator because of type mismatch in Lighthouse initiator.
-    initiator: {
-        type: InitiatorType;
-        url?: string;
-        stack?: CallStack;
-    };
-    initiatorRequest: NetworkRequest<T> | undefined;
-    /** The chain of network requests that redirected to this one */
-    redirects: NetworkRequest[] | undefined;
-    timing: Protocol.Network.ResourceTiming | undefined;
-    /**
-     * Optional value for how long the server took to respond to this request.
-     * When not provided, the server response time is derived from the timing object.
-     */
-    serverResponseTime?: number;
-    resourceType: ResourceType | undefined;
-    mimeType: string;
-    priority: ResourcePriority;
-    frameId: string | undefined;
-    fromWorker: boolean;
-}
-
-interface MetricResult<T = any> {
-    timing: number;
-    timestamp?: never;
-    optimisticEstimate: Simulation.Result<T>;
-    pessimisticEstimate: Simulation.Result<T>;
-    optimisticGraph: Simulation.GraphNode<T>;
-    pessimisticGraph: Simulation.GraphNode<T>;
-}
-
-export namespace Simulation {
-    type URL = {
-        /** URL of the initially requested URL */
-        requestedUrl?: string;
-        /** URL of the last document request */
-        mainDocumentUrl?: string;
-    };
-
-    type GraphNode<T> = import('../BaseNode.js').Node<T>;
-    type GraphNetworkNode<T> = import('../NetworkNode.js').NetworkNode<T>;
-    type GraphCPUNode = import('../CpuNode.js').CPUNode;
-    type Simulator<T> = import('../simulation/Simulator.js').Simulator<T>;
-
-    interface MetricCoefficients {
-        intercept: number;
-        optimistic: number;
-        pessimistic: number;
-    }
-
-    /** Simulation settings that control the amount of network & cpu throttling in the run. */
-    interface ThrottlingSettings {
-        /** The round trip time in milliseconds. */
-        rttMs?: number;
-        /** The network throughput in kilobits per second. */
-        throughputKbps?: number;
-        // devtools settings
-        /** The network request latency in milliseconds. */
-        requestLatencyMs?: number;
-        /** The network download throughput in kilobits per second. */
-        downloadThroughputKbps?: number;
-        /** The network upload throughput in kilobits per second. */
-        uploadThroughputKbps?: number;
-        // used by both
-        /** The amount of slowdown applied to the cpu (1/<cpuSlowdownMultiplier>). */
-        cpuSlowdownMultiplier?: number
-    }
-
-    interface PrecomputedLanternData {
-        additionalRttByOrigin: {[origin: string]: number};
-        serverResponseTimeByOrigin: {[origin: string]: number};
-    }
-
-    interface Settings {
-        networkAnalysis: {
-            rtt: number;
-            additionalRttByOrigin: Map<string, number>;
-            serverResponseTimeByOrigin: Map<string, number>;
-            throughput: number;
-        };
-        /** The method used to throttle the network. */
-        throttlingMethod: 'devtools'|'simulate'|'provided';
-        /** The throttling config settings. */
-        throttling: Required<ThrottlingSettings>;
-        /** Precomputed lantern estimates to use instead of observed analysis. */
-        precomputedLanternData?: PrecomputedLanternData | null;
-    }
-
-    interface Options {
-        rtt?: number;
-        throughput?: number;
-        observedThroughput: number;
-        maximumConcurrentRequests?: number;
-        cpuSlowdownMultiplier?: number;
-        layoutTaskMultiplier?: number;
-        additionalRttByOrigin?: Map<string, number>;
-        serverResponseTimeByOrigin?: Map<string, number>;
-    }
-
-    interface NodeTiming {
-        startTime: number;
-        endTime: number;
-        duration: number;
-    }
-
-    interface Result<T = any> {
-        timeInMs: number;
-        nodeTimings: Map<GraphNode<T>, NodeTiming>;
-    }
-
-    interface ProcessedNavigation {
-        timestamps: {
-            firstContentfulPaint: number;
-            largestContentfulPaint?: number;
-        };
-    }
-
-    interface MetricComputationDataInput {
-        simulator: Simulator<any>;
-        graph: GraphNode<any>;
-        processedNavigation: ProcessedNavigation;
-    }
-}

package/core/lib/lantern/types/lantern.js

@@ -1,7 +0,0 @@
-/**
- * @license
- * Copyright 2024 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export {};