@paulirish/trace_engine 0.0.18 → 0.0.19

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

@@ -1,16 +1,23 @@
+import { type TraceWindowMicroSeconds } from './Timing.js';
 import { type TraceEventData } from './TraceEvents.js';
 export type TraceFile = {
     traceEvents: readonly TraceEventData[];
     metadata: MetaData;
 };
+export interface Breadcrumb {
+    window: TraceWindowMicroSeconds;
+    child: Breadcrumb | null;
+}
 export declare const enum DataOrigin {
     CPUProfile = "CPUProfile",
     TraceEvents = "TraceEvents"
 }
 export interface Annotations {
-    hiddenRendererEventsHashes: string[];
-    hiddenProfileCallsSampleIndexes: number[];
-    hiddenProfileCallsDepths: number[];
+    entriesFilterAnnotations: {
+        hiddenEntriesIndexes: number[];
+        modifiedEntriesIndexes: number[];
+    };
+    initialBreadcrumb: Breadcrumb;
 }
 /**
  * Trace metadata that we persist to the file. This will allow us to

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

@@ -1 +1 @@
-{"version":3,"file":"File.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/types/File.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B","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\nimport {type TraceEventData} from './TraceEvents.js';\nexport type TraceFile = {\n  traceEvents: readonly TraceEventData[],\n  metadata: MetaData,\n};\n\nexport const enum DataOrigin {\n  CPUProfile = 'CPUProfile',\n  TraceEvents = 'TraceEvents',\n}\nexport interface Annotations {\n  hiddenRendererEventsHashes: string[];\n  hiddenProfileCallsSampleIndexes: number[];\n  hiddenProfileCallsDepths: number[];\n}\n\n/**\n * Trace metadata that we persist to the file. This will allow us to\n * store specifics for the trace, e.g., which tracks should be visible\n * on load.\n */\nexport interface MetaData {\n  source?: 'DevTools';\n  startTime?: string;\n  networkThrottling?: string;\n  cpuThrottling?: number;\n  hardwareConcurrency?: number;\n  dataOrigin?: DataOrigin;\n  annotations?: Annotations;\n}\n\nexport type Contents = TraceFile|TraceEventData[];\n"]}
+{"version":3,"file":"File.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/types/File.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B","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\nimport {type TraceWindowMicroSeconds} from './Timing.js';\nimport {type TraceEventData} from './TraceEvents.js';\n\nexport type TraceFile = {\n  traceEvents: readonly TraceEventData[],\n  metadata: MetaData,\n};\n\nexport interface Breadcrumb {\n  window: TraceWindowMicroSeconds;\n  child: Breadcrumb|null;\n}\n\nexport const enum DataOrigin {\n  CPUProfile = 'CPUProfile',\n  TraceEvents = 'TraceEvents',\n}\nexport interface Annotations {\n  entriesFilterAnnotations: {\n    hiddenEntriesIndexes: number[],\n    modifiedEntriesIndexes: number[],\n  };\n  initialBreadcrumb: Breadcrumb;\n}\n\n/**\n * Trace metadata that we persist to the file. This will allow us to\n * store specifics for the trace, e.g., which tracks should be visible\n * on load.\n */\nexport interface MetaData {\n  source?: 'DevTools';\n  startTime?: string;\n  networkThrottling?: string;\n  cpuThrottling?: number;\n  hardwareConcurrency?: number;\n  dataOrigin?: DataOrigin;\n  annotations?: Annotations;\n}\n\nexport type Contents = TraceFile|TraceEventData[];\n"]}

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

@@ -427,6 +427,12 @@ 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 {
+    name: typeof MarkerName[number];
+}
+export declare function isTraceEventMarkerEvent(event: TraceEventData): event is MakerEvent;
+export declare function eventIsPageLoadEvent(event: TraceEventData): event is PageLoadEvent;
 export interface TraceEventLargestContentfulPaintCandidate extends TraceEventMark {
     name: 'largestContentfulPaint::Candidate';
     args: TraceEventArgs & {
@@ -837,7 +843,12 @@ export interface TraceEventPerformanceMeasureBegin extends TraceEventPairableUse
 export type TraceEventPerformanceMeasureEnd = TraceEventPairableUserTiming & TraceEventPairableAsyncEnd;
 export type TraceEventPerformanceMeasure = TraceEventPerformanceMeasureBegin | TraceEventPerformanceMeasureEnd;
 export interface TraceEventPerformanceMark extends TraceEventUserTiming {
-    ph: Phase.INSTANT | Phase.MARK;
+    args: TraceEventArgs & {
+        data?: TraceEventArgsData & {
+            detail?: string;
+        };
+    };
+    ph: Phase.INSTANT | Phase.MARK | Phase.ASYNC_NESTABLE_INSTANT;
 }
 export interface TraceEventConsoleTimeBegin extends TraceEventPairableAsyncBegin {
     cat: 'blink.console';
@@ -858,17 +869,6 @@ export interface TraceEventTimeStamp extends TraceEventData {
         };
     };
 }
-export interface TraceEventExtensionMeasureBegin extends TraceEventPerformanceMeasureBegin {
-    name: `devtools-entry-${string}`;
-}
-export interface TraceEventExtensionMeasureEnd extends TraceEventPerformanceMeasureEnd {
-    name: `devtools-entry-${string}`;
-}
-export interface TraceEventExtensionMark extends TraceEventPerformanceMark {
-    name: `devtools-entry-${string}`;
-    ph: Phase.INSTANT | Phase.MARK;
-}
-export type TraceEventExtensionMeasure = TraceEventExtensionMeasureBegin | TraceEventExtensionMeasureEnd;
 /** ChromeFrameReporter args for PipelineReporter event.
     Matching proto: https://source.chromium.org/chromium/chromium/src/+/main:third_party/perfetto/protos/perfetto/trace/track_event/chrome_frame_reporter.proto
  */
@@ -958,6 +958,7 @@ export interface TraceEventPipelineReporter extends TraceEventData {
 }
 export declare function isTraceEventPipelineReporter(event: TraceEventData): event is TraceEventPipelineReporter;
 export interface SyntheticEventPair<T extends TraceEventPairableAsync = TraceEventPairableAsync> extends TraceEventData {
+    name: T['name'];
     cat: T['cat'];
     id?: string;
     id2?: {
@@ -1117,9 +1118,27 @@ export interface SyntheticInvalidation extends TraceEventInstant {
     stackTrace?: TraceEventCallFrame[];
 }
 export declare function isSyntheticInvalidation(event: TraceEventData): event is SyntheticInvalidation;
+export interface SelectorTiming {
+    'elapsed (us)': number;
+    'fast_reject_count': number;
+    'match_attempts': number;
+    'selector': string;
+    'style_sheet_id': string;
+}
+export interface SelectorStats {
+    selector_timings: SelectorTiming[];
+}
+export interface TraceEventStyleRecalcSelectorStats extends TraceEventComplete {
+    name: KnownEventName.SelectorStats;
+    args: TraceEventArgs & {
+        selector_stats?: SelectorStats;
+    };
+}
+export declare function isStyleRecalcSelectorStats(event: TraceEventData): event is TraceEventStyleRecalcSelectorStats;
 export interface TraceEventUpdateLayoutTree extends TraceEventComplete {
     name: KnownEventName.UpdateLayoutTree;
     args: TraceEventArgs & {
+        selector_stats?: SelectorStats;
         elementCount: number;
         beginData?: {
             frame: string;
@@ -1516,7 +1535,6 @@ export declare const enum KnownEventName {
     V8Execute = "V8.Execute",
     GC = "GCEvent",
     DOMGC = "BlinkGC.AtomicPhase",
-    IncrementalGCMarking = "V8.GCIncrementalMarking",
     MajorGC = "MajorGC",
     MinorGC = "MinorGC",
     GCCollectGarbage = "BlinkGC.AtomicPhase",
@@ -1536,6 +1554,7 @@ export declare const enum KnownEventName {
     ScheduleStyleInvalidationTracking = "ScheduleStyleInvalidationTracking",
     StyleRecalcInvalidationTracking = "StyleRecalcInvalidationTracking",
     StyleInvalidatorInvalidationTracking = "StyleInvalidatorInvalidationTracking",
+    SelectorStats = "SelectorStats",
     ScrollLayer = "ScrollLayer",
     UpdateLayer = "UpdateLayer",
     PaintSetup = "PaintSetup",

package/models/trace/types/TraceEvents.js

@@ -21,6 +21,25 @@ export function isTraceEventAuctionWorkletDoneWithProcess(event) {
 export function isTraceEventScreenshot(event) {
     return event.name === "Screenshot" /* KnownEventName.Screenshot */;
 }
+const markerTypeGuards = [
+    isTraceEventMarkDOMContent,
+    isTraceEventMarkLoad,
+    isTraceEventFirstPaint,
+    isTraceEventFirstContentfulPaint,
+    isTraceEventLargestContentfulPaintCandidate,
+    isTraceEventNavigationStart,
+];
+export const MarkerName = ['MarkDOMContent', 'MarkLoad', 'firstPaint', 'firstContentfulPaint', 'largestContentfulPaint::Candidate'];
+export function isTraceEventMarkerEvent(event) {
+    return markerTypeGuards.some(fn => fn(event));
+}
+const pageLoadEventTypeGuards = [
+    ...markerTypeGuards,
+    isTraceEventInteractiveTime,
+];
+export function eventIsPageLoadEvent(event) {
+    return pageLoadEventTypeGuards.some(fn => fn(event));
+}
 export function isTraceEventTracingSessionIdForWorker(event) {
     return event.name === 'TracingSessionIdForWorker';
 }
@@ -85,6 +104,9 @@ export function isTraceEventActivateLayerTree(event) {
 export function isSyntheticInvalidation(event) {
     return event.name === 'SyntheticInvalidation';
 }
+export function isStyleRecalcSelectorStats(event) {
+    return event.name === "SelectorStats" /* KnownEventName.SelectorStats */;
+}
 export function isTraceEventUpdateLayoutTree(event) {
     return event.name === "UpdateLayoutTree" /* KnownEventName.UpdateLayoutTree */;
 }
@@ -300,16 +322,16 @@ export function isTraceEventTimeStamp(traceEventData) {
 export function isTraceEventParseHTML(traceEventData) {
     return traceEventData.name === 'ParseHTML';
 }
+const asyncPhases = new Set([
+    "b" /* Phase.ASYNC_NESTABLE_START */,
+    "n" /* Phase.ASYNC_NESTABLE_INSTANT */,
+    "e" /* Phase.ASYNC_NESTABLE_END */,
+    "T" /* Phase.ASYNC_STEP_INTO */,
+    "S" /* Phase.ASYNC_BEGIN */,
+    "F" /* Phase.ASYNC_END */,
+    "p" /* Phase.ASYNC_STEP_PAST */,
+]);
 export function isTraceEventAsyncPhase(traceEventData) {
-    const asyncPhases = new Set([
-        "b" /* Phase.ASYNC_NESTABLE_START */,
-        "n" /* Phase.ASYNC_NESTABLE_INSTANT */,
-        "e" /* Phase.ASYNC_NESTABLE_END */,
-        "T" /* Phase.ASYNC_STEP_INTO */,
-        "S" /* Phase.ASYNC_BEGIN */,
-        "F" /* Phase.ASYNC_END */,
-        "p" /* Phase.ASYNC_STEP_PAST */,
-    ]);
     return asyncPhases.has(traceEventData.ph);
 }
 export function isSyntheticLayoutShift(traceEventData) {