@paulirish/trace_engine 0.0.20 → 0.0.22

package/models/trace/insights/InsightRunners.js.map

@@ -1 +1 @@
-{"version":3,"file":"InsightRunners.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/insights/InsightRunners.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAE7B,OAAO,KAAK,sBAAsB,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,sBAAsB,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC","sourcesContent":["// Copyright 2024 The Chromium Authors. All rights reserved.\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\nexport * as InteractionToNextPaint from './InteractionToNextPaint.js';\nexport * as LargestContentfulPaint from './LargestContentfulPaint.js';\nexport * as RenderBlocking from './RenderBlocking.js';\n"]}
+{"version":3,"file":"InsightRunners.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/insights/InsightRunners.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAE7B,OAAO,KAAK,qBAAqB,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,sBAAsB,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,sBAAsB,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC","sourcesContent":["// Copyright 2024 The Chromium Authors. All rights reserved.\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\nexport * as CumulativeLayoutShift from './CumulativeLayoutShift.js';\nexport * as InteractionToNextPaint from './InteractionToNextPaint.js';\nexport * as LargestContentfulPaint from './LargestContentfulPaint.js';\nexport * as RenderBlocking from './RenderBlocking.js';\nexport * as Viewport from './Viewport.js';\n"]}

package/models/trace/insights/Viewport.d.ts

@@ -0,0 +1,5 @@
+import { type InsightResult, type NavigationInsightContext, type RequiredData } from './types.js';
+export declare function deps(): ['Meta', 'UserInteractions'];
+export declare function generateInsight(traceParsedData: RequiredData<typeof deps>, context: NavigationInsightContext): InsightResult<{
+    mobileOptimized: boolean | null;
+}>;

package/models/trace/insights/Viewport.js

@@ -0,0 +1,39 @@
+// Copyright 2024 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+import * as Helpers from '../helpers/helpers.js';
+import { InsightWarning } from './types.js';
+export function deps() {
+    return ['Meta', 'UserInteractions'];
+}
+export function generateInsight(traceParsedData, context) {
+    const events = traceParsedData.UserInteractions.beginCommitCompositorFrameEvents.filter(event => {
+        if (event.args.frame !== context.frameId) {
+            return false;
+        }
+        const navigation = Helpers.Trace.getNavigationForTraceEvent(event, context.frameId, traceParsedData.Meta.navigationsByFrameId);
+        if (navigation?.args.data?.navigationId !== context.navigationId) {
+            return false;
+        }
+        return true;
+    });
+    if (!events.length) {
+        // Trace doesn't have the data we need.
+        return {
+            mobileOptimized: null,
+            warnings: [InsightWarning.NO_LAYOUT],
+        };
+    }
+    // Returns true only if all events are mobile optimized.
+    for (const event of events) {
+        if (!event.args.is_mobile_optimized) {
+            return {
+                mobileOptimized: false,
+            };
+        }
+    }
+    return {
+        mobileOptimized: true,
+    };
+}
+//# sourceMappingURL=Viewport.js.map

package/models/trace/insights/Viewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Viewport.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/insights/Viewport.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAE7B,OAAO,KAAK,OAAO,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAqB,cAAc,EAAmD,MAAM,YAAY,CAAC;AAEhH,MAAM,UAAU,IAAI;IAClB,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,eAA0C,EAAE,OAAiC;IAE3G,MAAM,MAAM,GAAG,eAAe,CAAC,gBAAgB,CAAC,gCAAgC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;QAC9F,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;YACzC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,UAAU,GACZ,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAChH,IAAI,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC;YACjE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,uCAAuC;QACvC,OAAO;YACL,eAAe,EAAE,IAAI;YACrB,QAAQ,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC;SACrC,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACpC,OAAO;gBACL,eAAe,EAAE,KAAK;aACvB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,eAAe,EAAE,IAAI;KACtB,CAAC;AACJ,CAAC","sourcesContent":["// Copyright 2024 The Chromium Authors. All rights reserved.\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\nimport * as Helpers from '../helpers/helpers.js';\n\nimport {type InsightResult, InsightWarning, type NavigationInsightContext, type RequiredData} from './types.js';\n\nexport function deps(): ['Meta', 'UserInteractions'] {\n  return ['Meta', 'UserInteractions'];\n}\n\nexport function generateInsight(traceParsedData: RequiredData<typeof deps>, context: NavigationInsightContext):\n    InsightResult<{mobileOptimized: boolean | null}> {\n  const events = traceParsedData.UserInteractions.beginCommitCompositorFrameEvents.filter(event => {\n    if (event.args.frame !== context.frameId) {\n      return false;\n    }\n\n    const navigation =\n        Helpers.Trace.getNavigationForTraceEvent(event, context.frameId, traceParsedData.Meta.navigationsByFrameId);\n    if (navigation?.args.data?.navigationId !== context.navigationId) {\n      return false;\n    }\n\n    return true;\n  });\n\n  if (!events.length) {\n    // Trace doesn't have the data we need.\n    return {\n      mobileOptimized: null,\n      warnings: [InsightWarning.NO_LAYOUT],\n    };\n  }\n\n  // Returns true only if all events are mobile optimized.\n  for (const event of events) {\n    if (!event.args.is_mobile_optimized) {\n      return {\n        mobileOptimized: false,\n      };\n    }\n  }\n\n  return {\n    mobileOptimized: true,\n  };\n}\n"]}

package/models/trace/insights/insights-tsconfig.json

@@ -29,10 +29,12 @@
     "useUnknownInCatchVariables": false
   },
   "files": [
+    "../../../../../../../front_end/models/trace/insights/CumulativeLayoutShift.ts",
     "../../../../../../../front_end/models/trace/insights/InsightRunners.ts",
     "../../../../../../../front_end/models/trace/insights/InteractionToNextPaint.ts",
     "../../../../../../../front_end/models/trace/insights/LargestContentfulPaint.ts",
     "../../../../../../../front_end/models/trace/insights/RenderBlocking.ts",
+    "../../../../../../../front_end/models/trace/insights/Viewport.ts",
     "../../../../../../../front_end/models/trace/insights/types.ts",
     "../../../../../../../front_end/legacy/legacy-defs.d.ts",
     "../../../../../../../front_end/global_typings/global_defs.d.ts",

package/models/trace/insights/types.d.ts

@@ -11,7 +11,8 @@ type InsightRunnersType = typeof InsightsRunners;
 export declare enum InsightWarning {
     NO_FP = "NO_FP",
     NO_LCP = "NO_LCP",
-    NO_DOCUMENT_REQUEST = "NO_DOCUMENT_REQUEST"
+    NO_DOCUMENT_REQUEST = "NO_DOCUMENT_REQUEST",
+    NO_LAYOUT = "NO_LAYOUT"
 }
 export type InsightResult<R extends Record<string, unknown>> = R & {
     warnings?: InsightWarning[];

package/models/trace/insights/types.js

@@ -7,5 +7,6 @@ export var InsightWarning;
     InsightWarning["NO_LCP"] = "NO_LCP";
     // No network request could be identified as the primary HTML document.
     InsightWarning["NO_DOCUMENT_REQUEST"] = "NO_DOCUMENT_REQUEST";
+    InsightWarning["NO_LAYOUT"] = "NO_LAYOUT";
 })(InsightWarning || (InsightWarning = {}));
 //# sourceMappingURL=types.js.map

package/models/trace/insights/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/insights/types.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAgB7B,MAAM,CAAN,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,mCAAiB,CAAA;IACjB,uEAAuE;IACvE,6DAA2C,CAAA;AAC7C,CAAC,EALW,cAAc,KAAd,cAAc,QAKzB","sourcesContent":["// Copyright 2024 The Chromium Authors. All rights reserved.\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\nimport type * as Handlers from '../handlers/handlers.js';\n\nimport type * as InsightsRunners from './InsightRunners.js';\n\n/**\n * Context for which navigation an insight should look at.\n */\nexport interface NavigationInsightContext {\n  frameId: string;\n  navigationId: string;\n}\n\ntype InsightRunnersType = typeof InsightsRunners;\n\nexport enum InsightWarning {\n  NO_FP = 'NO_FP',\n  NO_LCP = 'NO_LCP',\n  // No network request could be identified as the primary HTML document.\n  NO_DOCUMENT_REQUEST = 'NO_DOCUMENT_REQUEST',\n}\n\nexport type InsightResult<R extends Record<string, unknown>> = R&{\n  warnings?: InsightWarning[],\n};\n\n/**\n * Contains insights for a specific navigation.\n */\nexport type NavigationInsightData<H extends {[key: string]: Handlers.Types.TraceEventHandler}> = {\n  [I in keyof EnabledInsightRunners<H>]: ReturnType<EnabledInsightRunners<H>[I]>|Error;\n};\n\n/**\n * Contains insights for the entire trace. Insights are grouped by `navigationId`.\n */\nexport type TraceInsightData<H extends {[key: string]: Handlers.Types.TraceEventHandler}> =\n    Map<string, NavigationInsightData<H>>;\n\n/**\n * Maps each enabled insight name to its generate function. Insights that are disabled (i.e. missing one or more dependencies) will be unset.\n */\nexport type EnabledInsightRunners<H extends {[key: string]: Handlers.Types.TraceEventHandler}> = {\n  [I in keyof InsightRunnersType]:\n      [Handlers.Types.EnabledHandlerDataWithMeta<H>] extends [Parameters<InsightRunnersType[I]['generateInsight']>[0]] ?\n      (traceParsedData: Handlers.Types.EnabledHandlerDataWithMeta<H>, context: NavigationInsightContext) =>\n          ReturnType<InsightRunnersType[I]['generateInsight']>:\n      never;\n};\n\n/**\n * Represents the narrow set of dependencies defined by an insight's `deps()` function. `Meta` is always included regardless of `deps()`.\n */\nexport type RequiredData<D extends() => Array<keyof typeof Handlers.ModelHandlers>> =\n    Handlers.Types.EnabledHandlerDataWithMeta<Pick<typeof Handlers.ModelHandlers, ReturnType<D>[number]>>;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/insights/types.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAgB7B,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACxB,iCAAe,CAAA;IACf,mCAAiB,CAAA;IACjB,uEAAuE;IACvE,6DAA2C,CAAA;IAC3C,yCAAuB,CAAA;AACzB,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB","sourcesContent":["// Copyright 2024 The Chromium Authors. All rights reserved.\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\nimport type * as Handlers from '../handlers/handlers.js';\n\nimport type * as InsightsRunners from './InsightRunners.js';\n\n/**\n * Context for which navigation an insight should look at.\n */\nexport interface NavigationInsightContext {\n  frameId: string;\n  navigationId: string;\n}\n\ntype InsightRunnersType = typeof InsightsRunners;\n\nexport enum InsightWarning {\n  NO_FP = 'NO_FP',\n  NO_LCP = 'NO_LCP',\n  // No network request could be identified as the primary HTML document.\n  NO_DOCUMENT_REQUEST = 'NO_DOCUMENT_REQUEST',\n  NO_LAYOUT = 'NO_LAYOUT',\n}\n\nexport type InsightResult<R extends Record<string, unknown>> = R&{\n  warnings?: InsightWarning[],\n};\n\n/**\n * Contains insights for a specific navigation.\n */\nexport type NavigationInsightData<H extends {[key: string]: Handlers.Types.TraceEventHandler}> = {\n  [I in keyof EnabledInsightRunners<H>]: ReturnType<EnabledInsightRunners<H>[I]>|Error;\n};\n\n/**\n * Contains insights for the entire trace. Insights are grouped by `navigationId`.\n */\nexport type TraceInsightData<H extends {[key: string]: Handlers.Types.TraceEventHandler}> =\n    Map<string, NavigationInsightData<H>>;\n\n/**\n * Maps each enabled insight name to its generate function. Insights that are disabled (i.e. missing one or more dependencies) will be unset.\n */\nexport type EnabledInsightRunners<H extends {[key: string]: Handlers.Types.TraceEventHandler}> = {\n  [I in keyof InsightRunnersType]:\n      [Handlers.Types.EnabledHandlerDataWithMeta<H>] extends [Parameters<InsightRunnersType[I]['generateInsight']>[0]] ?\n      (traceParsedData: Handlers.Types.EnabledHandlerDataWithMeta<H>, context: NavigationInsightContext) =>\n          ReturnType<InsightRunnersType[I]['generateInsight']>:\n      never;\n};\n\n/**\n * Represents the narrow set of dependencies defined by an insight's `deps()` function. `Meta` is always included regardless of `deps()`.\n */\nexport type RequiredData<D extends() => Array<keyof typeof Handlers.ModelHandlers>> =\n    Handlers.Types.EnabledHandlerDataWithMeta<Pick<typeof Handlers.ModelHandlers, ReturnType<D>[number]>>;\n"]}

package/models/trace/types/Configuration.d.ts

@@ -1,33 +1,21 @@
-export type Configuration = Readonly<{
-    settings: {};
-    experiments: {
-        /**
-         * Include V8 RCS in the timeline
-         */
-        timelineV8RuntimeCallStats: boolean;
-        /**
-         * Show all events: disable the default filtering which hides and excludes some events.
-         */
-        timelineShowAllEvents: boolean;
-    };
-    processing: {
-        /**
-         * How long the processor should pause between event chunks.
-         */
-        pauseDuration: number;
-        /**
-         * How many events should be processed before yielding to the main thread for a pause.
-         */
-        eventsPerChunk: number;
-    };
-}>;
-export declare const DEFAULT: Configuration;
+export type Configuration = {
+    /**
+     * Include V8 RCS functions in the JS stacks
+     */
+    includeRuntimeCallStats: boolean;
+    /**
+     * Show all events: disable the default filtering which hides and excludes some events.
+     */
+    showAllEvents: boolean;
+    /**
+     * Extra detail for RPP developers (eg Trace Event json in Summary, and individual JS Sample events)
+     */
+    debugMode: boolean;
+};
+export declare const defaults: () => Configuration;
 /**
  * Generates a key that can be used to represent this config in a cache. This is
  * used mainly in tests, where we want to avoid re-parsing a file if we have
- * already processed it with the same configuration. This cache key purposefully
- * does not include all settings in the configuration; the processing settings
- * do not impact the actual resulting data. Only new flags in the config that
- * alter parsing should be added to this cache key.
+ * already processed it with the same configuration.
  */
 export declare function configToCacheKey(config: Configuration): string;

package/models/trace/types/Configuration.js

@@ -1,37 +1,17 @@
 // Copyright 2023 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
-export const DEFAULT = {
-    settings: {},
-    experiments: {
-        timelineV8RuntimeCallStats: false,
-        timelineShowAllEvents: false,
-    },
-    processing: {
-        /**
-         * We want to yield regularly to maintain responsiveness. If we yield too often, we're wasting idle time.
-         * We could do this by checking `performance.now()` regularly, but it's an expensive call in such a hot loop.
-         * `eventsPerChunk` is an approximated proxy metric.
-         * But how big a chunk? We're aiming for long tasks that are no smaller than 100ms and not bigger than 200ms.
-         * It's CPU dependent, so it should be calibrated on oldish hardware.
-         * Illustration of a previous change to `eventsPerChunk`: https://imgur.com/wzp8BnR
-         */
-        eventsPerChunk: 50_000,
-        pauseDuration: 0,
-    },
-};
+export const defaults = () => ({
+    includeRuntimeCallStats: false,
+    showAllEvents: false,
+    debugMode: false,
+});
 /**
  * Generates a key that can be used to represent this config in a cache. This is
  * used mainly in tests, where we want to avoid re-parsing a file if we have
- * already processed it with the same configuration. This cache key purposefully
- * does not include all settings in the configuration; the processing settings
- * do not impact the actual resulting data. Only new flags in the config that
- * alter parsing should be added to this cache key.
+ * already processed it with the same configuration.
  */
 export function configToCacheKey(config) {
-    return [
-        `experiments.timelineShowAllEvents:${config.experiments.timelineShowAllEvents}`,
-        `experiments.timelineV8RuntimeCallStats:${config.experiments.timelineV8RuntimeCallStats}`,
-    ].join('-');
+    return JSON.stringify(config);
 }
 //# sourceMappingURL=Configuration.js.map

package/models/trace/types/Configuration.js.map

@@ -1 +1 @@
-{"version":3,"file":"Configuration.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/types/Configuration.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AA4B7B,MAAM,CAAC,MAAM,OAAO,GAAkB;IACpC,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE;QACX,0BAA0B,EAAE,KAAK;QACjC,qBAAqB,EAAE,KAAK;KAC7B;IACD,UAAU,EAAE;QAEV;;;;;;;WAOG;QACH,cAAc,EAAE,MAAM;QACtB,aAAa,EAAE,CAAC;KACjB;CACF,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IACpD,OAAO;QACL,qCAAqC,MAAM,CAAC,WAAW,CAAC,qBAAqB,EAAE;QAC/E,0CAA0C,MAAM,CAAC,WAAW,CAAC,0BAA0B,EAAE;KAC1F,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC","sourcesContent":["// Copyright 2023 The Chromium Authors. All rights reserved.\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\nexport type Configuration = Readonly<{\n  settings: {\n      // Currently empty but defining here as we will migrate more settings into this.\n  },\n  experiments: {\n    /**\n     * Include V8 RCS in the timeline\n     */\n    timelineV8RuntimeCallStats: boolean,\n    /**\n     * Show all events: disable the default filtering which hides and excludes some events.\n     */\n    timelineShowAllEvents: boolean,\n  },\n  processing: {\n    /**\n     * How long the processor should pause between event chunks.\n     */\n    pauseDuration: number,\n    /**\n     * How many events should be processed before yielding to the main thread for a pause.\n     */\n    eventsPerChunk: number,\n  },\n}>;\n\nexport const DEFAULT: Configuration = {\n  settings: {},\n  experiments: {\n    timelineV8RuntimeCallStats: false,\n    timelineShowAllEvents: false,\n  },\n  processing: {\n\n    /**\n     * We want to yield regularly to maintain responsiveness. If we yield too often, we're wasting idle time.\n     * We could do this by checking `performance.now()` regularly, but it's an expensive call in such a hot loop.\n     * `eventsPerChunk` is an approximated proxy metric.\n     * But how big a chunk? We're aiming for long tasks that are no smaller than 100ms and not bigger than 200ms.\n     * It's CPU dependent, so it should be calibrated on oldish hardware.\n     * Illustration of a previous change to `eventsPerChunk`: https://imgur.com/wzp8BnR\n     */\n    eventsPerChunk: 50_000,\n    pauseDuration: 0,\n  },\n};\n\n/**\n * Generates a key that can be used to represent this config in a cache. This is\n * used mainly in tests, where we want to avoid re-parsing a file if we have\n * already processed it with the same configuration. This cache key purposefully\n * does not include all settings in the configuration; the processing settings\n * do not impact the actual resulting data. Only new flags in the config that\n * alter parsing should be added to this cache key.\n */\nexport function configToCacheKey(config: Configuration): string {\n  return [\n    `experiments.timelineShowAllEvents:${config.experiments.timelineShowAllEvents}`,\n    `experiments.timelineV8RuntimeCallStats:${config.experiments.timelineV8RuntimeCallStats}`,\n  ].join('-');\n}\n"]}
+{"version":3,"file":"Configuration.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/types/Configuration.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAiB7B,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAkB,EAAE,CAAC,CAAC;IAC5C,uBAAuB,EAAE,KAAK;IAC9B,aAAa,EAAE,KAAK;IACpB,SAAS,EAAE,KAAK;CACjB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IACpD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC","sourcesContent":["// Copyright 2023 The Chromium Authors. All rights reserved.\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\nexport type Configuration = {\n  /**\n   * Include V8 RCS functions in the JS stacks\n   */\n  includeRuntimeCallStats: boolean,\n  /**\n   * Show all events: disable the default filtering which hides and excludes some events.\n   */\n  showAllEvents: boolean,\n  /**\n   * Extra detail for RPP developers (eg Trace Event json in Summary, and individual JS Sample events)\n   */\n  debugMode: boolean,\n};\n\nexport const defaults = (): Configuration => ({\n  includeRuntimeCallStats: false,\n  showAllEvents: false,\n  debugMode: false,\n});\n\n/**\n * Generates a key that can be used to represent this config in a cache. This is\n * used mainly in tests, where we want to avoid re-parsing a file if we have\n * already processed it with the same configuration.\n */\nexport function configToCacheKey(config: Configuration): string {\n  return JSON.stringify(config);\n}\n"]}

package/models/trace/types/TraceEvents.d.ts

@@ -51,6 +51,7 @@ export interface TraceEventArgs {
 }
 export interface TraceEventArgsData {
     stackTrace?: TraceEventCallFrame[];
+    url?: string;
     navigationId?: string;
     frame?: string;
 }
@@ -68,6 +69,7 @@ export interface TraceFrame {
     processId: ProcessID;
     url: string;
     parent?: string;
+    isOutermostMainFrame?: boolean;
 }
 export interface TraceEventSample extends TraceEventData {
     ph: Phase.SAMPLE;
@@ -249,12 +251,16 @@ export interface SyntheticNetworkRequest extends TraceEventComplete {
             frame: string;
             fromServiceWorker: boolean;
             isLinkPreload: boolean;
-            host: string;
             mimeType: string;
-            pathname: string;
-            search: string;
-            priority: Priority;
-            initialPriority: Priority;
+            priority: Protocol.Network.ResourcePriority;
+            initialPriority: Protocol.Network.ResourcePriority;
+            /**
+             * This is the protocol used to resolve the request.
+             *
+             * Note, this is not the same as URL.protocol.
+             *
+             * Example values (not exhaustive): http/0.9, http/1.0, http/1.1, http, h2, h3-Q050, data, blob
+             */
             protocol: string;
             redirects: SyntheticNetworkRedirect[];
             renderBlocking: RenderBlocking;
@@ -268,6 +274,12 @@ export interface SyntheticNetworkRequest extends TraceEventComplete {
             }>;
             fetchPriorityHint: FetchPriorityHint;
             url: string;
+            /** True only if got a 'resourceFinish' event indicating a failure. */
+            failed: boolean;
+            /** True only if got a 'resourceFinish' event. */
+            finished: boolean;
+            connectionId: number;
+            connectionReused: boolean;
             initiator?: Initiator;
             requestMethod?: string;
             timing?: TraceEventResourceReceiveResponseTimingData;
@@ -363,19 +375,22 @@ export interface SyntheticScreenshot extends TraceEventData {
 }
 export interface TraceEventAnimation extends TraceEventData {
     args: TraceEventArgs & {
-        id?: string;
-        name?: string;
-        nodeId?: number;
-        nodeName?: string;
-        state?: string;
-        compositeFailed?: number;
-        unsupportedProperties?: string[];
+        data: TraceEventArgsData & {
+            nodeName?: string;
+            nodeId?: number;
+            displayName?: string;
+            id?: string;
+            name?: string;
+            state?: string;
+            compositeFailed?: number;
+            unsupportedProperties?: string[];
+        };
     };
     name: 'Animation';
     id2?: {
         local?: string;
     };
-    ph: Phase.ASYNC_NESTABLE_START | Phase.ASYNC_NESTABLE_END;
+    ph: Phase.ASYNC_NESTABLE_START | Phase.ASYNC_NESTABLE_END | Phase.ASYNC_NESTABLE_INSTANT;
 }
 export interface TraceEventMetadata extends TraceEventData {
     ph: Phase.METADATA;
@@ -409,7 +424,7 @@ export interface TraceEventNavigationStart extends TraceEventMark {
     };
 }
 export interface TraceEventFirstContentfulPaint extends TraceEventMark {
-    name: 'firstContentfulPaint';
+    name: KnownEventName.MarkFCP;
     args: TraceEventArgs & {
         frame: string;
         data?: TraceEventArgsData & {
@@ -428,13 +443,13 @@ export interface TraceEventFirstPaint extends TraceEventMark {
 }
 export type PageLoadEvent = TraceEventFirstContentfulPaint | TraceEventMarkDOMContent | TraceEventInteractiveTime | TraceEventLargestContentfulPaintCandidate | TraceEventLayoutShift | TraceEventFirstPaint | TraceEventMarkLoad | TraceEventNavigationStart;
 export declare const MarkerName: readonly ["MarkDOMContent", "MarkLoad", "firstPaint", "firstContentfulPaint", "largestContentfulPaint::Candidate"];
-interface MakerEvent extends TraceEventData {
+export interface MarkerEvent extends TraceEventData {
     name: typeof MarkerName[number];
 }
-export declare function isTraceEventMarkerEvent(event: TraceEventData): event is MakerEvent;
+export declare function isTraceEventMarkerEvent(event: TraceEventData): event is MarkerEvent;
 export declare function eventIsPageLoadEvent(event: TraceEventData): event is PageLoadEvent;
 export interface TraceEventLargestContentfulPaintCandidate extends TraceEventMark {
-    name: 'largestContentfulPaint::Candidate';
+    name: KnownEventName.MarkLCPCandidate;
     args: TraceEventArgs & {
         frame: string;
         data?: TraceEventArgsData & {
@@ -614,7 +629,6 @@ export interface SyntheticLayoutShift extends TraceEventLayoutShift {
     };
     parsedData: LayoutShiftParsedData;
 }
-export type Priority = 'Low' | 'High' | 'Medium' | 'VeryHigh' | 'Highest';
 export type FetchPriorityHint = 'low' | 'high' | 'auto';
 export type RenderBlocking = 'blocking' | 'non_blocking' | 'in_body_parser_blocking' | 'potentially_blocking';
 export interface Initiator {
@@ -631,7 +645,7 @@ export interface TraceEventResourceSendRequest extends TraceEventInstant {
             frame: string;
             requestId: string;
             url: string;
-            priority: Priority;
+            priority: Protocol.Network.ResourcePriority;
             resourceType: Protocol.Network.ResourceType;
             fetchPriorityHint: FetchPriorityHint;
             requestMethod?: string;
@@ -645,7 +659,7 @@ export interface TraceEventResourceChangePriority extends TraceEventInstant {
     args: TraceEventArgs & {
         data: TraceEventArgsData & {
             requestId: string;
-            priority: Priority;
+            priority: Protocol.Network.ResourcePriority;
         };
     };
 }
@@ -702,6 +716,14 @@ export interface TraceEventResourceReceiveResponse extends TraceEventInstant {
     name: 'ResourceReceiveResponse';
     args: TraceEventArgs & {
         data: TraceEventArgsData & {
+            /**
+             * This is the protocol used to resolve the request.
+             *
+             * Note, this is not the same as URL.protocol.
+             *
+             * Example values (not exhaustive): http/0.9, http/1.0, http/1.1, http, h2, h3-Q050, data, blob
+             */
+            protocol: string;
             encodedDataLength: number;
             frame: string;
             fromCache: boolean;
@@ -712,6 +734,8 @@ export interface TraceEventResourceReceiveResponse extends TraceEventInstant {
             statusCode: number;
             timing: TraceEventResourceReceiveResponseTimingData;
             isLinkPreload?: boolean;
+            connectionId: number;
+            connectionReused: boolean;
             headers?: Array<{
                 name: string;
                 value: string;
@@ -801,6 +825,14 @@ export interface TraceEventStyleInvalidatorInvalidationTracking extends TraceEve
     };
 }
 export declare function isTraceEventStyleInvalidatorInvalidationTracking(event: TraceEventData): event is TraceEventStyleInvalidatorInvalidationTracking;
+export interface TraceEventBeginCommitCompositorFrame extends TraceEventInstant {
+    name: KnownEventName.BeginCommitCompositorFrame;
+    args: TraceEventArgs & {
+        frame: string;
+        is_mobile_optimized: boolean;
+    };
+}
+export declare function isTraceEventBeginCommitCompositorFrame(event: TraceEventData): event is TraceEventBeginCommitCompositorFrame;
 export interface TraceEventScheduleStyleRecalculation extends TraceEventInstant {
     name: KnownEventName.ScheduleStyleRecalculation;
     args: TraceEventArgs & {
@@ -814,7 +846,7 @@ export interface TraceEventPrePaint extends TraceEventComplete {
     name: 'PrePaint';
 }
 export interface TraceEventPairableAsync extends TraceEventData {
-    ph: Phase.ASYNC_NESTABLE_START | Phase.ASYNC_NESTABLE_END;
+    ph: Phase.ASYNC_NESTABLE_START | Phase.ASYNC_NESTABLE_END | Phase.ASYNC_NESTABLE_INSTANT;
     id2?: {
         local?: string;
         global?: string;
@@ -824,6 +856,9 @@ export interface TraceEventPairableAsync extends TraceEventData {
 export interface TraceEventPairableAsyncBegin extends TraceEventPairableAsync {
     ph: Phase.ASYNC_NESTABLE_START;
 }
+export interface TraceEventPairableAsyncInstant extends TraceEventPairableAsync {
+    ph: Phase.ASYNC_NESTABLE_INSTANT;
+}
 export interface TraceEventPairableAsyncEnd extends TraceEventPairableAsync {
     ph: Phase.ASYNC_NESTABLE_END;
 }
@@ -972,6 +1007,7 @@ export interface SyntheticEventPair<T extends TraceEventPairableAsync = TraceEve
         data: {
             beginEvent: T & TraceEventPairableAsyncBegin;
             endEvent: T & TraceEventPairableAsyncEnd;
+            instantEvents?: Array<T & TraceEventPairableAsyncInstant>;
         };
     };
 }
@@ -1000,10 +1036,32 @@ export interface SyntheticTraceEntry extends TraceEventData {
 /**
  * A profile call created in the frontend from samples disguised as a
  * trace event.
+ *
+ * We store the sampleIndex, profileId and nodeId so that we can easily link
+ * back a Synthetic Trace Entry to an indivdual Sample trace event within a
+ * Profile.
+ *
+ * Because a sample contains a set of call frames representing the stack at the
+ * point in time that the sample was created, we also have to store the ID of
+ * the Node that points to the function call that this profile call represents.
  */
 export interface SyntheticProfileCall extends SyntheticTraceEntry {
     callFrame: Protocol.Runtime.CallFrame;
     nodeId: Protocol.integer;
+    sampleIndex: number;
+    profileId: ProfileID;
+}
+/**
+ * A JS Sample reflects a single sample from the V8 CPU Profile
+ */
+export interface SyntheticJSSample extends SyntheticTraceEntry {
+    name: KnownEventName.JSSample;
+    args: TraceEventArgs & {
+        data: TraceEventArgsData & {
+            stackTrace: Protocol.Runtime.CallFrame[];
+        };
+    };
+    ph: Phase.INSTANT;
 }
 /**
  * A trace event augmented synthetically in the frontend to contain
@@ -1147,21 +1205,21 @@ export interface SelectorTiming {
     'match_attempts': number;
     'selector': string;
     'style_sheet_id': string;
+    'match_count': number;
 }
 export interface SelectorStats {
     selector_timings: SelectorTiming[];
 }
-export interface TraceEventStyleRecalcSelectorStats extends TraceEventComplete {
+export interface TraceEventSelectorStats extends TraceEventComplete {
     name: KnownEventName.SelectorStats;
     args: TraceEventArgs & {
         selector_stats?: SelectorStats;
     };
 }
-export declare function isStyleRecalcSelectorStats(event: TraceEventData): event is TraceEventStyleRecalcSelectorStats;
+export declare function isTraceEventSelectorStats(event: TraceEventData): event is TraceEventSelectorStats;
 export interface TraceEventUpdateLayoutTree extends TraceEventComplete {
     name: KnownEventName.UpdateLayoutTree;
     args: TraceEventArgs & {
-        selector_stats?: SelectorStats;
         elementCount: number;
         beginData?: {
             frame: string;
@@ -1511,6 +1569,9 @@ export interface TraceEventV8Compile extends TraceEventComplete {
         data?: {
             url?: string;
             columnNumber?: number;
+            consumedCacheSize?: number;
+            cacheRejected?: boolean;
+            cacheKind?: 'full' | 'normal';
             lineNumber?: number;
             notStreamedReason?: string;
             streamed?: boolean;
@@ -1520,6 +1581,20 @@ export interface TraceEventV8Compile extends TraceEventComplete {
     };
 }
 export declare function isTraceEventV8Compile(event: TraceEventData): event is TraceEventV8Compile;
+export interface TraceEventFunctionCall extends TraceEventComplete {
+    name: KnownEventName.FunctionCall;
+    args: TraceEventArgs & {
+        data?: {
+            frame?: string;
+            columnNumber?: number;
+            lineNumber?: number;
+            functionName?: string;
+            scriptId?: number;
+            url?: string;
+        };
+    };
+}
+export declare function isTraceEventFunctionCall(event: TraceEventData): event is TraceEventFunctionCall;
 /**
  * Generally, before JS is executed, a trace event is dispatched that
  * parents the JS calls. These we call "invocation" events. This
@@ -1589,7 +1664,6 @@ export declare const enum KnownEventName {
     GCCollectGarbage = "BlinkGC.AtomicPhase",
     CPPGCSweep = "CppGC.IncrementalSweep",
     ScheduleStyleRecalculation = "ScheduleStyleRecalculation",
-    RecalculateStyles = "RecalculateStyles",
     Layout = "Layout",
     UpdateLayoutTree = "UpdateLayoutTree",
     InvalidateLayout = "InvalidateLayout",
@@ -1604,6 +1678,7 @@ export declare const enum KnownEventName {
     StyleRecalcInvalidationTracking = "StyleRecalcInvalidationTracking",
     StyleInvalidatorInvalidationTracking = "StyleInvalidatorInvalidationTracking",
     SelectorStats = "SelectorStats",
+    BeginCommitCompositorFrame = "BeginCommitCompositorFrame",
     ScrollLayer = "ScrollLayer",
     UpdateLayer = "UpdateLayer",
     PaintSetup = "PaintSetup",
@@ -1615,7 +1690,6 @@ export declare const enum KnownEventName {
     ImageDecodeTask = "ImageDecodeTask",
     ImageUploadTask = "ImageUploadTask",
     DecodeImage = "Decode Image",
-    ResizeImage = "Resize Image",
     DrawLazyPixelRef = "Draw LazyPixelRef",
     DecodeLazyPixelRef = "Decode LazyPixelRef",
     GPUTask = "GPUTask",
@@ -1665,6 +1739,7 @@ export declare const enum KnownEventName {
     StartProfiling = "CpuProfiler::StartProfiling",
     ProfileChunk = "ProfileChunk",
     UpdateCounters = "UpdateCounters",
+    JSSample = "JSSample",
     Animation = "Animation",
     ParseAuthorStyleSheet = "ParseAuthorStyleSheet",
     EmbedderCallback = "EmbedderCallback",

package/models/trace/types/TraceEvents.js

@@ -52,6 +52,9 @@ export function isTraceEventStyleRecalcInvalidationTracking(event) {
 export function isTraceEventStyleInvalidatorInvalidationTracking(event) {
     return event.name === "StyleInvalidatorInvalidationTracking" /* KnownEventName.StyleInvalidatorInvalidationTracking */;
 }
+export function isTraceEventBeginCommitCompositorFrame(event) {
+    return event.name === "BeginCommitCompositorFrame" /* KnownEventName.BeginCommitCompositorFrame */;
+}
 export function isTraceEventScheduleStyleRecalculation(event) {
     return event.name === "ScheduleStyleRecalculation" /* KnownEventName.ScheduleStyleRecalculation */;
 }
@@ -113,7 +116,7 @@ export function isTraceEventDecodeLazyPixelRef(event) {
 export function isTraceEventDecodeImage(event) {
     return event.name === "Decode Image" /* KnownEventName.DecodeImage */;
 }
-export function isStyleRecalcSelectorStats(event) {
+export function isTraceEventSelectorStats(event) {
     return event.name === "SelectorStats" /* KnownEventName.SelectorStats */;
 }
 export function isTraceEventUpdateLayoutTree(event) {
@@ -209,7 +212,8 @@ export function isTraceEventNavigationStart(traceEventData) {
     return traceEventData.name === 'navigationStart';
 }
 export function isTraceEventAnimation(traceEventData) {
-    return traceEventData.name === 'Animation';
+    // We've found some rare traces with an Animtation trace event from a different category: https://crbug.com/1472375#comment7
+    return traceEventData.name === 'Animation' && traceEventData.cat.includes('devtools.timeline');
 }
 export function isTraceEventLayoutShift(traceEventData) {
     return traceEventData.name === 'LayoutShift';
@@ -221,7 +225,7 @@ export function isTraceEventFirstContentfulPaint(traceEventData) {
     return traceEventData.name === 'firstContentfulPaint';
 }
 export function isTraceEventLargestContentfulPaintCandidate(traceEventData) {
-    return traceEventData.name === 'largestContentfulPaint::Candidate';
+    return traceEventData.name === "largestContentfulPaint::Candidate" /* KnownEventName.MarkLCPCandidate */;
 }
 export function isTraceEventLargestImagePaintCandidate(traceEventData) {
     return traceEventData.name === 'LargestImagePaint::Candidate';
@@ -407,6 +411,9 @@ export function isWebSocketTraceEvent(event) {
 export function isTraceEventV8Compile(event) {
     return event.name === "v8.compile" /* KnownEventName.Compile */;
 }
+export function isTraceEventFunctionCall(event) {
+    return event.name === "FunctionCall" /* KnownEventName.FunctionCall */;
+}
 /**
  * Generally, before JS is executed, a trace event is dispatched that
  * parents the JS calls. These we call "invocation" events. This