@paulirish/trace_engine 0.0.41 → 0.0.43

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":"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","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 * as SDK from '../../../core/sdk/sdk.js';\nimport type * as Protocol from '../../../generated/protocol.js';\nimport type * as CrUXManager from '../../../models/crux-manager/crux-manager.js';\n\nimport type {TraceWindowMicroSeconds} from './Timing.js';\nimport type {Event, LegacyTimelineFrame, ProcessID, SampleIndex, ThreadID} from './TraceEvents.js';\n\nexport interface TraceFile {\n  traceEvents: readonly Event[];\n  metadata: MetaData;\n}\n\nexport interface Breadcrumb {\n  window: TraceWindowMicroSeconds;\n  child: Breadcrumb|null;\n}\n\nexport const enum DataOrigin {\n  CPU_PROFILE = 'CPUProfile',\n  TRACE_EVENTS = 'TraceEvents',\n}\n\n/**\n * The Entries link can have 3 stated:\n *  1. The Link creation is not started yet, meaning only the button that needs to be clicked to start creating the link is visible.\n *  2. Pending to event - the creation is started, but the entry that the link points to has not been chosen yet\n *  3. Link connected - final state, both entries present\n */\nexport const enum EntriesLinkState {\n  CREATION_NOT_STARTED = 'creation_not_started',\n  PENDING_TO_EVENT = 'pending_to_event',\n  CONNECTED = 'connected',\n}\n\nexport const enum EventKeyType {\n  RAW_EVENT = 'r',\n  SYNTHETIC_EVENT = 's',\n  PROFILE_CALL = 'p',\n  LEGACY_TIMELINE_FRAME = 'l',\n}\n\n/**\n * Represents an object that is saved in the file when user created annotations in the timeline.\n *\n * Expected to add more annotations.\n */\nexport interface SerializedAnnotations {\n  entryLabels: EntryLabelAnnotationSerialized[];\n  labelledTimeRanges: TimeRangeAnnotationSerialized[];\n  linksBetweenEntries: EntriesLinkAnnotationSerialized[];\n}\n\n/**\n * Represents an object that is used to store the Entry Label annotation that is created when a user creates a label for an entry in the timeline.\n */\nexport interface EntryLabelAnnotation {\n  type: 'ENTRY_LABEL';\n  entry: Event|LegacyTimelineFrame;\n  label: string;\n}\n\n/**\n * Represents an object that is used to store the Labelled Time Range Annotation that is created when a user creates a Time Range Selection in the timeline.\n */\nexport interface TimeRangeAnnotation {\n  type: 'TIME_RANGE';\n  label: string;\n  bounds: TraceWindowMicroSeconds;\n}\n\nexport interface EntriesLinkAnnotation {\n  type: 'ENTRIES_LINK';\n  state: EntriesLinkState;\n  entryFrom: Event;\n  entryTo?: Event;\n}\n\n/**\n * Represents an object that is saved in the file when a user creates a label for an entry in the timeline.\n */\nexport interface EntryLabelAnnotationSerialized {\n  entry: SerializableKey;\n  label: string;\n}\n\n/**\n * Represents an object that is saved in the file when a user creates a time range with a label in the timeline.\n */\nexport interface TimeRangeAnnotationSerialized {\n  bounds: TraceWindowMicroSeconds;\n  label: string;\n}\n\n/**\n * Represents an object that is saved in the file when a user creates a link between entries in the timeline.\n */\nexport interface EntriesLinkAnnotationSerialized {\n  entryFrom: SerializableKey;\n  entryTo: SerializableKey;\n}\n\n/**\n * `Annotation` are the user-created annotations that are saved into the metadata.\n * Those annotations are rendered on the timeline by `Overlays.ts`\n *\n * TODO: Implement other OverlayAnnotations (annotated time ranges, links between entries).\n * TODO: Save/load overlay annotations to/from the trace file.\n */\nexport type Annotation = EntryLabelAnnotation|TimeRangeAnnotation|EntriesLinkAnnotation;\n\nexport function isTimeRangeAnnotation(annotation: Annotation): annotation is TimeRangeAnnotation {\n  return annotation.type === 'TIME_RANGE';\n}\n\nexport function isEntryLabelAnnotation(annotation: Annotation): annotation is EntryLabelAnnotation {\n  return annotation.type === 'ENTRY_LABEL';\n}\n\nexport function isEntriesLinkAnnotation(annotation: Annotation): annotation is EntriesLinkAnnotation {\n  return annotation.type === 'ENTRIES_LINK';\n}\n\n// Serializable keys are created for trace events to be able to save\n// references to timeline events in a trace file. These keys enable\n// user modifications that can be saved. See go/cpq:event-data-json for\n// more details on the key format.\nexport type RawEventKey = `${EventKeyType.RAW_EVENT}-${number}`;\nexport type SyntheticEventKey = `${EventKeyType.SYNTHETIC_EVENT}-${number}`;\nexport type ProfileCallKey = `${EventKeyType.PROFILE_CALL}-${ProcessID}-${ThreadID}-${SampleIndex}-${Protocol.integer}`;\nexport type LegacyTimelineFrameKey = `${EventKeyType.LEGACY_TIMELINE_FRAME}-${number}`;\nexport type SerializableKey = RawEventKey|ProfileCallKey|SyntheticEventKey|LegacyTimelineFrameKey;\n\n// Serializable keys values objects contain data that maps the keys to original Trace Events\nexport interface RawEventKeyValues {\n  type: EventKeyType.RAW_EVENT;\n  rawIndex: number;\n}\n\nexport interface SyntheticEventKeyValues {\n  type: EventKeyType.SYNTHETIC_EVENT;\n  rawIndex: number;\n}\n\nexport interface ProfileCallKeyValues {\n  type: EventKeyType.PROFILE_CALL;\n  processID: ProcessID;\n  threadID: ThreadID;\n  sampleIndex: SampleIndex;\n  protocol: Protocol.integer;\n}\n\nexport interface LegacyTimelineFrameKeyValues {\n  type: EventKeyType.LEGACY_TIMELINE_FRAME;\n  rawIndex: number;\n}\n\nexport type SerializableKeyValues =\n    RawEventKeyValues|ProfileCallKeyValues|SyntheticEventKeyValues|LegacyTimelineFrameKeyValues;\n\nexport interface Modifications {\n  entriesModifications: {\n    // Entries hidden by the user\n    hiddenEntries: SerializableKey[],\n    // Entries that parent a hiddenEntry\n    expandableEntries: SerializableKey[],\n  };\n  initialBreadcrumb: Breadcrumb;\n  annotations: SerializedAnnotations;\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  emulatedDeviceTitle?: string;\n  // Only set if network throttling is active.\n  networkThrottling?: string;\n  // Only set if network throttling is active.\n  networkThrottlingConditions?: Omit<SDK.NetworkManager.Conditions, 'title'>;\n  // Only set if CPU throttling is active.\n  cpuThrottling?: number;\n  hardwareConcurrency?: number;\n  dataOrigin?: DataOrigin;\n  enhancedTraceVersion?: number;\n  modifications?: Modifications;\n  cruxFieldData?: CrUXManager.PageResult[];\n}\n\nexport type Contents = TraceFile|Event[];\n\nexport function traceEventKeyToValues(key: SerializableKey): SerializableKeyValues {\n  const parts = key.split('-');\n  const type = parts[0];\n\n  switch (type) {\n    case EventKeyType.PROFILE_CALL:\n      if (parts.length !== 5 ||\n          !(parts.every((part, i) => i === 0 || typeof part === 'number' || !isNaN(parseInt(part, 10))))) {\n        throw new Error(`Invalid ProfileCallKey: ${key}`);\n      }\n      return {\n        type: parts[0],\n        processID: parseInt(parts[1], 10),\n        threadID: parseInt(parts[2], 10),\n        sampleIndex: parseInt(parts[3], 10),\n        protocol: parseInt(parts[4], 10),\n      } as ProfileCallKeyValues;\n    case EventKeyType.RAW_EVENT:\n      if (parts.length !== 2 || !(typeof parts[1] === 'number' || !isNaN(parseInt(parts[1], 10)))) {\n        throw new Error(`Invalid RawEvent Key: ${key}`);\n      }\n      return {\n        type: parts[0],\n        rawIndex: parseInt(parts[1], 10),\n      } as RawEventKeyValues;\n    case EventKeyType.SYNTHETIC_EVENT:\n      if (parts.length !== 2 || !(typeof parts[1] === 'number' || !isNaN(parseInt(parts[1], 10)))) {\n        throw new Error(`Invalid SyntheticEvent Key: ${key}`);\n      }\n      return {\n        type: parts[0],\n        rawIndex: parseInt(parts[1], 10),\n      } as SyntheticEventKeyValues;\n    case EventKeyType.LEGACY_TIMELINE_FRAME: {\n      if (parts.length !== 2 || Number.isNaN(parseInt(parts[1], 10))) {\n        throw new Error(`Invalid LegacyTimelineFrame Key: ${key}`);\n      }\n      return {\n        type,\n        rawIndex: parseInt(parts[1], 10),\n      };\n    }\n\n    default:\n      throw new Error(`Unknown trace event key: ${key}`);\n  }\n}\n"]}
+{"version":3,"file":"File.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/types/File.ts"],"names":[],"mappings":"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","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 * as SDK from '../../../core/sdk/sdk.js';\nimport type * as Protocol from '../../../generated/protocol.js';\nimport type * as CrUXManager from '../../../models/crux-manager/crux-manager.js';\n\nimport type {TraceWindowMicro} from './Timing.js';\nimport type {Event, LegacyTimelineFrame, ProcessID, SampleIndex, ThreadID} from './TraceEvents.js';\n\nexport interface TraceFile {\n  traceEvents: readonly Event[];\n  metadata: MetaData;\n}\n\nexport interface Breadcrumb {\n  window: TraceWindowMicro;\n  child: Breadcrumb|null;\n}\n\nexport const enum DataOrigin {\n  CPU_PROFILE = 'CPUProfile',\n  TRACE_EVENTS = 'TraceEvents',\n}\n\n/**\n * The Entries link can have 3 stated:\n *  1. The Link creation is not started yet, meaning only the button that needs to be clicked to start creating the link is visible.\n *  2. Pending to event - the creation is started, but the entry that the link points to has not been chosen yet\n *  3. Link connected - final state, both entries present\n */\nexport const enum EntriesLinkState {\n  CREATION_NOT_STARTED = 'creation_not_started',\n  PENDING_TO_EVENT = 'pending_to_event',\n  CONNECTED = 'connected',\n}\n\nexport const enum EventKeyType {\n  RAW_EVENT = 'r',\n  SYNTHETIC_EVENT = 's',\n  PROFILE_CALL = 'p',\n  LEGACY_TIMELINE_FRAME = 'l',\n}\n\n/**\n * Represents an object that is saved in the file when user created annotations in the timeline.\n *\n * Expected to add more annotations.\n */\nexport interface SerializedAnnotations {\n  entryLabels: EntryLabelAnnotationSerialized[];\n  labelledTimeRanges: TimeRangeAnnotationSerialized[];\n  linksBetweenEntries: EntriesLinkAnnotationSerialized[];\n}\n\n/**\n * Represents an object that is used to store the Entry Label annotation that is created when a user creates a label for an entry in the timeline.\n */\nexport interface EntryLabelAnnotation {\n  type: 'ENTRY_LABEL';\n  entry: Event|LegacyTimelineFrame;\n  label: string;\n}\n\n/**\n * Represents an object that is used to store the Labelled Time Range Annotation that is created when a user creates a Time Range Selection in the timeline.\n */\nexport interface TimeRangeAnnotation {\n  type: 'TIME_RANGE';\n  label: string;\n  bounds: TraceWindowMicro;\n}\n\nexport interface EntriesLinkAnnotation {\n  type: 'ENTRIES_LINK';\n  state: EntriesLinkState;\n  entryFrom: Event;\n  entryTo?: Event;\n}\n\n/**\n * Represents an object that is saved in the file when a user creates a label for an entry in the timeline.\n */\nexport interface EntryLabelAnnotationSerialized {\n  entry: SerializableKey;\n  label: string;\n}\n\n/**\n * Represents an object that is saved in the file when a user creates a time range with a label in the timeline.\n */\nexport interface TimeRangeAnnotationSerialized {\n  bounds: TraceWindowMicro;\n  label: string;\n}\n\n/**\n * Represents an object that is saved in the file when a user creates a link between entries in the timeline.\n */\nexport interface EntriesLinkAnnotationSerialized {\n  entryFrom: SerializableKey;\n  entryTo: SerializableKey;\n}\n\n/**\n * `Annotation` are the user-created annotations that are saved into the metadata.\n * Those annotations are rendered on the timeline by `Overlays.ts`\n *\n * TODO: Implement other OverlayAnnotations (annotated time ranges, links between entries).\n * TODO: Save/load overlay annotations to/from the trace file.\n */\nexport type Annotation = EntryLabelAnnotation|TimeRangeAnnotation|EntriesLinkAnnotation;\n\nexport function isTimeRangeAnnotation(annotation: Annotation): annotation is TimeRangeAnnotation {\n  return annotation.type === 'TIME_RANGE';\n}\n\nexport function isEntryLabelAnnotation(annotation: Annotation): annotation is EntryLabelAnnotation {\n  return annotation.type === 'ENTRY_LABEL';\n}\n\nexport function isEntriesLinkAnnotation(annotation: Annotation): annotation is EntriesLinkAnnotation {\n  return annotation.type === 'ENTRIES_LINK';\n}\n\n// Serializable keys are created for trace events to be able to save\n// references to timeline events in a trace file. These keys enable\n// user modifications that can be saved. See go/cpq:event-data-json for\n// more details on the key format.\nexport type RawEventKey = `${EventKeyType.RAW_EVENT}-${number}`;\nexport type SyntheticEventKey = `${EventKeyType.SYNTHETIC_EVENT}-${number}`;\nexport type ProfileCallKey = `${EventKeyType.PROFILE_CALL}-${ProcessID}-${ThreadID}-${SampleIndex}-${Protocol.integer}`;\nexport type LegacyTimelineFrameKey = `${EventKeyType.LEGACY_TIMELINE_FRAME}-${number}`;\nexport type SerializableKey = RawEventKey|ProfileCallKey|SyntheticEventKey|LegacyTimelineFrameKey;\n\n// Serializable keys values objects contain data that maps the keys to original Trace Events\nexport interface RawEventKeyValues {\n  type: EventKeyType.RAW_EVENT;\n  rawIndex: number;\n}\n\nexport interface SyntheticEventKeyValues {\n  type: EventKeyType.SYNTHETIC_EVENT;\n  rawIndex: number;\n}\n\nexport interface ProfileCallKeyValues {\n  type: EventKeyType.PROFILE_CALL;\n  processID: ProcessID;\n  threadID: ThreadID;\n  sampleIndex: SampleIndex;\n  protocol: Protocol.integer;\n}\n\nexport interface LegacyTimelineFrameKeyValues {\n  type: EventKeyType.LEGACY_TIMELINE_FRAME;\n  rawIndex: number;\n}\n\nexport type SerializableKeyValues =\n    RawEventKeyValues|ProfileCallKeyValues|SyntheticEventKeyValues|LegacyTimelineFrameKeyValues;\n\nexport interface Modifications {\n  entriesModifications: {\n    // Entries hidden by the user\n    hiddenEntries: SerializableKey[],\n    // Entries that parent a hiddenEntry\n    expandableEntries: SerializableKey[],\n  };\n  initialBreadcrumb: Breadcrumb;\n  annotations: SerializedAnnotations;\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  emulatedDeviceTitle?: string;\n  // Only set if network throttling is active.\n  networkThrottling?: string;\n  // Only set if network throttling is active.\n  networkThrottlingConditions?: Omit<SDK.NetworkManager.Conditions, 'title'>;\n  // Only set if CPU throttling is active.\n  cpuThrottling?: number;\n  hardwareConcurrency?: number;\n  dataOrigin?: DataOrigin;\n  enhancedTraceVersion?: number;\n  modifications?: Modifications;\n  cruxFieldData?: CrUXManager.PageResult[];\n}\n\nexport type Contents = TraceFile|Event[];\n\nexport function traceEventKeyToValues(key: SerializableKey): SerializableKeyValues {\n  const parts = key.split('-');\n  const type = parts[0];\n\n  switch (type) {\n    case EventKeyType.PROFILE_CALL:\n      if (parts.length !== 5 ||\n          !(parts.every((part, i) => i === 0 || typeof part === 'number' || !isNaN(parseInt(part, 10))))) {\n        throw new Error(`Invalid ProfileCallKey: ${key}`);\n      }\n      return {\n        type: parts[0],\n        processID: parseInt(parts[1], 10),\n        threadID: parseInt(parts[2], 10),\n        sampleIndex: parseInt(parts[3], 10),\n        protocol: parseInt(parts[4], 10),\n      } as ProfileCallKeyValues;\n    case EventKeyType.RAW_EVENT:\n      if (parts.length !== 2 || !(typeof parts[1] === 'number' || !isNaN(parseInt(parts[1], 10)))) {\n        throw new Error(`Invalid RawEvent Key: ${key}`);\n      }\n      return {\n        type: parts[0],\n        rawIndex: parseInt(parts[1], 10),\n      } as RawEventKeyValues;\n    case EventKeyType.SYNTHETIC_EVENT:\n      if (parts.length !== 2 || !(typeof parts[1] === 'number' || !isNaN(parseInt(parts[1], 10)))) {\n        throw new Error(`Invalid SyntheticEvent Key: ${key}`);\n      }\n      return {\n        type: parts[0],\n        rawIndex: parseInt(parts[1], 10),\n      } as SyntheticEventKeyValues;\n    case EventKeyType.LEGACY_TIMELINE_FRAME: {\n      if (parts.length !== 2 || Number.isNaN(parseInt(parts[1], 10))) {\n        throw new Error(`Invalid LegacyTimelineFrame Key: ${key}`);\n      }\n      return {\n        type,\n        rawIndex: parseInt(parts[1], 10),\n      };\n    }\n\n    default:\n      throw new Error(`Unknown trace event key: ${key}`);\n  }\n}\n"]}

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

@@ -1,25 +1,19 @@
-export type MicroSeconds = number & {
+export type Micro = number & {
     _tag: 'MicroSeconds';
 };
-export declare function MicroSeconds(value: number): MicroSeconds;
-export type MilliSeconds = number & {
+export declare function Micro(value: number): Micro;
+export type Milli = number & {
     _tag: 'MilliSeconds';
 };
-export declare function MilliSeconds(value: number): MilliSeconds;
+export declare function Milli(value: number): Milli;
 export type Seconds = number & {
     _tag: 'Seconds';
 };
 export declare function Seconds(value: number): Seconds;
-export declare const enum TimeUnit {
-    MICROSECONDS = 0,
-    MILLISECONDS = 1,
-    SECONDS = 2,
-    MINUTES = 3
-}
-export interface TraceWindow<TimeFormat extends MicroSeconds | MilliSeconds> {
+export interface TraceWindow<TimeFormat extends Micro | Milli> {
     min: TimeFormat;
     max: TimeFormat;
     range: TimeFormat;
 }
-export type TraceWindowMicroSeconds = TraceWindow<MicroSeconds>;
-export type TraceWindowMilliSeconds = TraceWindow<MilliSeconds>;
+export type TraceWindowMicro = TraceWindow<Micro>;
+export type TraceWindowMilli = TraceWindow<Milli>;

package/models/trace/types/Timing.js

@@ -1,12 +1,15 @@
 // Copyright 2022 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 function MicroSeconds(value) {
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export function Micro(value) {
     return value;
 }
-export function MilliSeconds(value) {
+// eslint-disable-next-line @typescript-eslint/naming-convention
+export function Milli(value) {
     return value;
 }
+// eslint-disable-next-line @typescript-eslint/naming-convention
 export function Seconds(value) {
     return value;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"Timing.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/types/Timing.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAK7B,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAqB,CAAC;AAC/B,CAAC;AAGD,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAgB,CAAC;AAC1B,CAAC","sourcesContent":["// Copyright 2022 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\n/* eslint-disable @typescript-eslint/naming-convention */\n\nexport type MicroSeconds = number&{_tag: 'MicroSeconds'};\nexport function MicroSeconds(value: number): MicroSeconds {\n  return value as MicroSeconds;\n}\n\nexport type MilliSeconds = number&{_tag: 'MilliSeconds'};\nexport function MilliSeconds(value: number): MilliSeconds {\n  return value as MilliSeconds;\n}\nexport type Seconds = number&{_tag: 'Seconds'};\nexport function Seconds(value: number): Seconds {\n  return value as Seconds;\n}\n\nexport const enum TimeUnit {\n  MICROSECONDS = 0,\n  MILLISECONDS = 1,\n  SECONDS = 2,\n  MINUTES = 3,\n}\n\n// Other types.\n\nexport interface TraceWindow<TimeFormat extends MicroSeconds|MilliSeconds> {\n  min: TimeFormat;\n  max: TimeFormat;\n  range: TimeFormat;\n}\n\nexport type TraceWindowMicroSeconds = TraceWindow<MicroSeconds>;\nexport type TraceWindowMilliSeconds = TraceWindow<MilliSeconds>;\n"]}
+{"version":3,"file":"Timing.js","sourceRoot":"","sources":["../../../../../../../front_end/models/trace/types/Timing.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAG7B,gEAAgE;AAChE,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,KAAc,CAAC;AACxB,CAAC;AAGD,gEAAgE;AAChE,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,KAAc,CAAC;AACxB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAgB,CAAC;AAC1B,CAAC","sourcesContent":["// Copyright 2022 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 Micro = number&{_tag: 'MicroSeconds'};\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport function Micro(value: number): Micro {\n  return value as Micro;\n}\n\nexport type Milli = number&{_tag: 'MilliSeconds'};\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport function Milli(value: number): Milli {\n  return value as Milli;\n}\nexport type Seconds = number&{_tag: 'Seconds'};\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport function Seconds(value: number): Seconds {\n  return value as Seconds;\n}\n\nexport interface TraceWindow<TimeFormat extends Micro|Milli> {\n  min: TimeFormat;\n  max: TimeFormat;\n  range: TimeFormat;\n}\n\nexport type TraceWindowMicro = TraceWindow<Micro>;\nexport type TraceWindowMilli = TraceWindow<Milli>;\n"]}

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

@@ -1,5 +1,5 @@
 import type * as Protocol from '../../../generated/protocol.js';
-import type { MicroSeconds, MilliSeconds, Seconds, TraceWindowMicroSeconds } from './Timing.js';
+import type { Micro, Milli, Seconds, TraceWindowMicro } from './Timing.js';
 export declare const enum Phase {
     BEGIN = "B",
     END = "E",
@@ -26,9 +26,6 @@ export declare const enum Phase {
     MARK = "R",
     CLOCK_SYNC = "c"
 }
-export type NonEmptyString = string & {
-    _tag: 'NonEmptyString';
-};
 export declare function isNestableAsyncPhase(phase: Phase): boolean;
 export declare function isPhaseAsync(phase: Phase): boolean;
 export declare function isFlowPhase(phase: Phase): boolean;
@@ -44,10 +41,10 @@ export interface Event {
     ph: Phase;
     pid: ProcessID;
     tid: ThreadID;
-    tts?: MicroSeconds;
-    ts: MicroSeconds;
-    tdur?: MicroSeconds;
-    dur?: MicroSeconds;
+    tts?: Micro;
+    ts: Micro;
+    tdur?: Micro;
+    dur?: Micro;
 }
 export interface Args {
     data?: ArgsData;
@@ -97,7 +94,7 @@ export interface Profile extends Sample {
     id: ProfileID;
     args: Args & {
         data: ArgsData & {
-            startTime: MicroSeconds;
+            startTime: Micro;
         };
     };
 }
@@ -107,14 +104,20 @@ export interface ProfileChunk extends Sample {
     args: Args & {
         data?: ArgsData & {
             cpuProfile?: PartialProfile;
-            timeDeltas?: MicroSeconds[];
-            lines?: MicroSeconds[];
+            timeDeltas?: Micro[];
+            lines?: Micro[];
         };
     };
 }
 export interface PartialProfile {
     nodes?: PartialNode[];
     samples: CallFrameID[];
+    /**
+     * Contains trace ids assigned to samples, if any. Trace ids are
+     * keyed by the sample index in the profile (the keys of the object
+     * are strings containing the numeric index).
+     */
+    trace_ids?: Record<string, number>;
 }
 export interface PartialNode {
     callFrame: CallFrame;
@@ -123,7 +126,7 @@ export interface PartialNode {
 }
 export interface Complete extends Event {
     ph: Phase.COMPLETE;
-    dur: MicroSeconds;
+    dur: Micro;
 }
 export interface RunTask extends Complete {
     name: Name.RUN_TASK;
@@ -133,7 +136,7 @@ export interface FireIdleCallback extends Complete {
     name: Name.FIRE_IDLE_CALLBACK;
     args: Args & {
         data: ArgsData & {
-            allottedMilliseconds: MilliSeconds;
+            allottedMilliseconds: Milli;
             frame: string;
             id: number;
             timedOut: boolean;
@@ -199,17 +202,17 @@ export interface EventTimingBegin extends Event {
     args: Args & {
         data: ArgsData & {
             cancelable: boolean;
-            duration: MilliSeconds;
+            duration: Milli;
             type: string;
             interactionId: number;
             interactionOffset: number;
             nodeId: Protocol.DOM.BackendNodeId;
             frame?: string;
-            processingEnd?: MilliSeconds;
-            processingStart?: MilliSeconds;
-            timeStamp?: MilliSeconds;
-            enqueuedToMainThreadTime?: MilliSeconds;
-            commitFinishTime?: MilliSeconds;
+            processingEnd?: Milli;
+            processingStart?: Milli;
+            timeStamp?: Milli;
+            enqueuedToMainThreadTime?: Milli;
+            commitFinishTime?: Milli;
         };
         frame?: string;
     };
@@ -233,31 +236,31 @@ export interface SyntheticNetworkRedirect {
     url: string;
     priority: string;
     requestMethod?: string;
-    ts: MicroSeconds;
-    dur: MicroSeconds;
+    ts: Micro;
+    dur: Micro;
 }
 interface SyntheticArgsData {
-    dnsLookup: MicroSeconds;
-    download: MicroSeconds;
-    downloadStart: MicroSeconds;
-    finishTime: MicroSeconds;
-    initialConnection: MicroSeconds;
+    dnsLookup: Micro;
+    download: Micro;
+    downloadStart: Micro;
+    finishTime: Micro;
+    initialConnection: Micro;
     isDiskCached: boolean;
     isHttps: boolean;
     isMemoryCached: boolean;
     isPushedResource: boolean;
-    networkDuration: MicroSeconds;
-    processingDuration: MicroSeconds;
-    proxyNegotiation: MicroSeconds;
-    queueing: MicroSeconds;
-    redirectionDuration: MicroSeconds;
-    requestSent: MicroSeconds;
-    sendStartTime: MicroSeconds;
-    ssl: MicroSeconds;
-    stalled: MicroSeconds;
-    totalTime: MicroSeconds;
+    networkDuration: Micro;
+    processingDuration: Micro;
+    proxyNegotiation: Micro;
+    queueing: Micro;
+    redirectionDuration: Micro;
+    requestSent: Micro;
+    sendStartTime: Micro;
+    ssl: Micro;
+    stalled: Micro;
+    totalTime: Micro;
     /** Server response time (receiveHeadersEnd - sendEnd) */
-    waiting: MicroSeconds;
+    waiting: Micro;
 }
 export interface SyntheticNetworkRequest extends Complete, SyntheticBased<Phase.COMPLETE> {
     rawSourceEvent: ResourceSendRequest;
@@ -310,12 +313,12 @@ export interface SyntheticNetworkRequest extends Complete, SyntheticBased<Phase.
         };
     };
     cat: 'loading';
-    name: 'SyntheticNetworkRequest';
+    name: Name.SYNTHETIC_NETWORK_REQUEST;
     ph: Phase.COMPLETE;
-    dur: MicroSeconds;
-    tdur: MicroSeconds;
-    ts: MicroSeconds;
-    tts: MicroSeconds;
+    dur: Micro;
+    tdur: Micro;
+    ts: Micro;
+    tts: Micro;
     pid: ProcessID;
     tid: ThreadID;
 }
@@ -331,8 +334,8 @@ export interface SyntheticWebSocketConnection extends Complete, SyntheticBased<P
     cat: string;
     name: 'SyntheticWebSocketConnection';
     ph: Phase.COMPLETE;
-    dur: MicroSeconds;
-    ts: MicroSeconds;
+    dur: Micro;
+    ts: Micro;
     pid: ProcessID;
     tid: ThreadID;
     s: Scope;
@@ -391,11 +394,26 @@ export interface AuctionWorkletDoneWithProcess extends Event {
 }
 export declare function isAuctionWorkletRunningInProcess(event: Event): event is AuctionWorkletRunningInProcess;
 export declare function isAuctionWorkletDoneWithProcess(event: Event): event is AuctionWorkletDoneWithProcess;
-export interface Screenshot extends Event {
+/**
+ * In January 2025 when crrev.com/c/6197645 landed, it changed the format of screenshot events.
+ * That is why we two screenshot types:
+ * `LegacyScreenshot` and `LegacySyntheticScreenshot`: BEFORE the above CL.
+ * `Screenshot`: AFTER the above CL.
+ * Important things to note:
+ * 1. Both the "old" and "new" events share the name "Screenshot" but their format is very different.
+ * 2. The old events had both a raw event (LegacyScreenshot) and a synthetic
+ *    event (LegacySyntheticScreenshot). The new events only have a raw event, as
+ *    we do not need the additional complexity of a synthetic event.
+ * 3. Because we like to support "old" traces, DevTools will maintain its
+ *    support for both screenshot events for the foreseeable future. If you are
+ *    consuming screenshot events from the ScreenshotHandler, you must make sure
+ *    to have your code deal with the two different formats.
+ */
+export interface LegacyScreenshot extends Event {
     /**
      * @deprecated This value is incorrect. Use ScreenshotHandler.getPresentationTimestamp()
      */
-    ts: MicroSeconds;
+    ts: Micro;
     /** The id is the frame sequence number in hex */
     id: string;
     args: Args & {
@@ -405,11 +423,13 @@ export interface Screenshot extends Event {
     cat: 'disabled-by-default-devtools.screenshot';
     ph: Phase.OBJECT_SNAPSHOT;
 }
+export declare function isLegacyScreenshot(event: Event): event is LegacyScreenshot;
+export declare function isLegacySyntheticScreenshot(event: Event): event is LegacySyntheticScreenshot;
 export declare function isScreenshot(event: Event): event is Screenshot;
-export interface SyntheticScreenshot extends Event, SyntheticBased {
-    rawSourceEvent: Screenshot;
+export interface LegacySyntheticScreenshot extends Event, SyntheticBased {
+    rawSourceEvent: LegacyScreenshot;
     /** This is the correct presentation timestamp. */
-    ts: MicroSeconds;
+    ts: Micro;
     args: Args & {
         dataUri: string;
     };
@@ -417,6 +437,14 @@ export interface SyntheticScreenshot extends Event, SyntheticBased {
     cat: 'disabled-by-default-devtools.screenshot';
     ph: Phase.OBJECT_SNAPSHOT;
 }
+export interface Screenshot extends Instant {
+    args: Args & {
+        snapshot: string;
+        source_id: number;
+        frame_sequence: number;
+        expected_display_time: number;
+    };
+}
 export interface Animation extends Event {
     args: Args & {
         data: ArgsData & {
@@ -455,29 +483,30 @@ export interface ProcessName extends Metadata {
 export interface Mark extends Event {
     ph: Phase.MARK;
 }
-export interface NavigationStartUnreliable extends Mark {
+export interface NavigationStart extends Mark {
     name: 'navigationStart';
     args: Args & {
+        frame: string;
         data?: ArgsData & {
-            /** An empty documentLoaderURL means this navigationStart is unreliable noise and can be ignored. */
-            documentLoaderURL: never;
+            /** Must be non-empty to be valid. An empty documentLoaderURL means the event can be ignored. */
+            documentLoaderURL: string;
             isLoadingMainFrame: boolean;
-            isOutermostMainFrame?: boolean;
             navigationId: string;
+            /**
+             * `isOutermostMainFrame` was introduced in crrev.com/c/3625434 and exists because of Fenced Frames
+             * [github.com/WICG/fenced-frame/tree/master/explainer]. Fenced frames introduce a situation where
+             * `isLoadingMainFrame` could be true for a navigation, but that navigation be within an embedded "main frame", and
+             * therefore it wouldn't be on the top level main frame. In situations where we need to distinguish that, we can
+             * rely on `isOutermostMainFrame`, which will only be true for navigations on the top level main frame.
+             * This flag is optional as it was introduced in May 2022; so users reasonably may import traces from before that
+             * date that do not have this field present.
+             */
+            isOutermostMainFrame?: boolean;
             /**
              * @deprecated use documentLoaderURL for navigation events URLs
              */
             url?: string;
         };
-        frame: string;
-    };
-}
-export interface NavigationStart extends NavigationStartUnreliable {
-    args: NavigationStartUnreliable['args'] & {
-        data: NavigationStartUnreliable['args']['data'] & {
-            /** This navigationStart is valid, as the documentLoaderURL isn't empty. */
-            documentLoaderURL: NonEmptyString;
-        };
     };
 }
 export interface FirstContentfulPaint extends Mark {
@@ -698,10 +727,10 @@ interface LayoutShiftSessionWindowData {
 export interface LayoutShiftParsedData {
     /** screenshot taken before and after this shift. Before *should* always exist, but after might not at the end of a trace. */
     screenshots: {
-        before: SyntheticScreenshot | null;
-        after: SyntheticScreenshot | null;
+        before: LegacySyntheticScreenshot | Screenshot | null;
+        after: LegacySyntheticScreenshot | Screenshot | null;
     };
-    timeFromNavigation?: MicroSeconds;
+    timeFromNavigation?: Micro;
     cumulativeWeightedScoreInWindow: number;
     sessionWindowData: LayoutShiftSessionWindowData;
 }
@@ -729,18 +758,18 @@ export type NavigationId = string | typeof NO_NAVIGATION;
  */
 export interface SyntheticLayoutShiftCluster {
     name: 'SyntheticLayoutShiftCluster';
-    clusterWindow: TraceWindowMicroSeconds;
+    clusterWindow: TraceWindowMicro;
     clusterCumulativeScore: number;
     events: SyntheticLayoutShift[];
     scoreWindows: {
-        good: TraceWindowMicroSeconds;
-        needsImprovement?: TraceWindowMicroSeconds;
-        bad?: TraceWindowMicroSeconds;
+        good: TraceWindowMicro;
+        needsImprovement?: TraceWindowMicro;
+        bad?: TraceWindowMicro;
     };
     navigationId?: NavigationId;
     worstShiftEvent?: Event;
-    ts: MicroSeconds;
-    dur: MicroSeconds;
+    ts: Micro;
+    dur: Micro;
     cat: '';
     ph: Phase.COMPLETE;
     pid: ProcessID;
@@ -816,24 +845,24 @@ export interface ResourceReceivedData extends Instant {
 }
 /** See https://mdn.github.io/shared-assets/images/diagrams/api/performance/timestamp-diagram.svg  */
 interface ResourceReceiveResponseTimingData {
-    connectEnd: MilliSeconds;
-    connectStart: MilliSeconds;
-    dnsEnd: MilliSeconds;
-    dnsStart: MilliSeconds;
-    proxyEnd: MilliSeconds;
-    proxyStart: MilliSeconds;
-    pushEnd: MilliSeconds;
-    pushStart: MilliSeconds;
-    receiveHeadersEnd: MilliSeconds;
-    receiveHeadersStart: MilliSeconds;
+    connectEnd: Milli;
+    connectStart: Milli;
+    dnsEnd: Milli;
+    dnsStart: Milli;
+    proxyEnd: Milli;
+    proxyStart: Milli;
+    pushEnd: Milli;
+    pushStart: Milli;
+    receiveHeadersEnd: Milli;
+    receiveHeadersStart: Milli;
     /** 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. */
     requestTime: Seconds;
-    sendEnd: MilliSeconds;
-    sendStart: MilliSeconds;
-    sslEnd: MilliSeconds;
-    sslStart: MilliSeconds;
-    workerReady: MilliSeconds;
-    workerStart: MilliSeconds;
+    sendEnd: Milli;
+    sendStart: Milli;
+    sslEnd: Milli;
+    sslStart: Milli;
+    workerReady: Milli;
+    workerStart: Milli;
 }
 export interface ResourceReceiveResponse extends Instant {
     name: 'ResourceReceiveResponse';
@@ -853,7 +882,7 @@ export interface ResourceReceiveResponse extends Instant {
             fromServiceWorker: boolean;
             mimeType: string;
             requestId: string;
-            responseTime: MilliSeconds;
+            responseTime: Milli;
             statusCode: number;
             timing?: ResourceReceiveResponseTimingData;
             connectionId: number;
@@ -1067,7 +1096,7 @@ export interface PerformanceMeasureBegin extends PairableUserTiming {
     args: Args & {
         detail?: string;
         stackTrace?: CallFrame[];
-        callTime?: MicroSeconds;
+        callTime?: Micro;
     };
     ph: Phase.ASYNC_NESTABLE_START;
 }
@@ -1078,7 +1107,7 @@ export interface PerformanceMark extends UserTiming {
         data?: ArgsData & {
             detail?: string;
             stackTrace?: CallFrame[];
-            callTime?: MicroSeconds;
+            callTime?: Micro;
         };
     };
     ph: Phase.INSTANT | Phase.MARK | Phase.ASYNC_NESTABLE_INSTANT;
@@ -1095,13 +1124,14 @@ export interface ConsoleTimeStamp extends Event {
     name: Name.CONSOLE_TIME_STAMP;
     ph: Phase.COMPLETE;
     args: Args & {
-        data: ArgsData & {
+        data?: ArgsData & {
             name: string | number;
             start?: string | number;
             end?: string | number;
             track?: string | number;
             trackGroup?: string | number;
             color?: string | number;
+            sampleTraceId?: number;
         };
     };
 }
@@ -1121,7 +1151,7 @@ interface ChromeFrameReporter {
     /**  Identifies a BeginFrameArgs (along with the source_id).
          See comments in components/viz/common/frame_sinks/begin_frame_args.h. */
     frame_sequence: number;
-    /**  If this is a droped frame (i.e. if |state| is set to |STATE_DROPPED| or
+    /**  If this is a dropped frame (i.e. if |state| is set to |STATE_DROPPED| or
          |STATE_PRESENTED_PARTIAL|), then indicates whether this frame impacts smoothness. */
     affects_smoothness: boolean;
     /** The type of active scroll. */
@@ -1212,7 +1242,7 @@ export interface SyntheticEventPair<T extends PairableAsync = PairableAsync> ext
         local?: string;
         global?: string;
     };
-    dur: MicroSeconds;
+    dur: Micro;
     args: Args & {
         data: {
             beginEvent: T & PairableAsyncBegin;
@@ -1229,20 +1259,20 @@ export type SyntheticAnimationPair = SyntheticEventPair<Animation>;
 export interface SyntheticInteractionPair extends SyntheticEventPair<EventTimingBeginOrEnd> {
     interactionId: number;
     type: string;
-    ts: MicroSeconds;
-    dur: MicroSeconds;
-    processingStart: MicroSeconds;
-    processingEnd: MicroSeconds;
-    inputDelay: MicroSeconds;
-    mainThreadHandling: MicroSeconds;
-    presentationDelay: MicroSeconds;
+    ts: Micro;
+    dur: Micro;
+    processingStart: Micro;
+    processingEnd: Micro;
+    inputDelay: Micro;
+    mainThreadHandling: Micro;
+    presentationDelay: Micro;
 }
 /**
  * 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
+ * back a Synthetic Trace Entry to an individual Sample trace event within a
  * Profile.
  *
  * Because a sample contains a set of call frames representing the stack at the
@@ -1281,6 +1311,7 @@ export interface SyntheticJSSample extends Event {
     name: Name.JS_SAMPLE;
     args: Args & {
         data: ArgsData & {
+            traceId?: number;
             stackTrace: Protocol.Runtime.CallFrame[];
         };
     };
@@ -1532,8 +1563,6 @@ export declare function isProcessName(event: Event): event is ProcessName;
 export declare function isTracingStartedInBrowser(event: Event): event is TracingStartedInBrowser;
 export declare function isFrameCommittedInBrowser(event: Event): event is FrameCommittedInBrowser;
 export declare function isCommitLoad(event: Event): event is CommitLoad;
-/** @deprecated You probably want `isNavigationStart` instead. */
-export declare function isNavigationStartUnreliable(event: Event): event is NavigationStartUnreliable;
 export declare function isAnimation(event: Event): event is Animation;
 export declare function isSyntheticAnimation(event: Event): event is SyntheticAnimationPair;
 export declare function isLayoutShift(event: Event): event is LayoutShift;
@@ -1896,7 +1925,7 @@ export interface SchedulePostTaskCallback extends Instant {
         data: {
             taskId: number;
             priority: 'user-blocking' | 'user-visible' | 'background';
-            delay: MilliSeconds;
+            delay: Milli;
             frame?: string;
             stackTrace?: CallFrame;
         };
@@ -1909,7 +1938,7 @@ export interface RunPostTaskCallback extends Complete {
         data: {
             taskId: number;
             priority: 'user-blocking' | 'user-visible' | 'background';
-            delay: MilliSeconds;
+            delay: Milli;
             frame?: string;
         };
     };
@@ -1934,6 +1963,11 @@ export declare function isAbortPostTaskCallback(event: Event): event is RunPostT
  */
 export declare function isJSInvocationEvent(event: Event): boolean;
 export interface ConsoleRunTask extends Event {
+    args: Args & {
+        data: ArgsData & {
+            sampleTraceId?: number;
+        };
+    };
     name: Name.V8_CONSOLE_RUN_TASK;
 }
 export declare function isConsoleRunTask(event: Event): event is ConsoleRunTask;
@@ -2113,7 +2147,8 @@ export declare const enum Name {
     DOM_LOADING = "domLoading",
     BEGIN_REMOTE_FONT_LOAD = "BeginRemoteFontLoad",
     ANIMATION_FRAME = "AnimationFrame",
-    ANIMATION_FRAME_PRESENTATION = "AnimationFrame::Presentation"
+    ANIMATION_FRAME_PRESENTATION = "AnimationFrame::Presentation",
+    SYNTHETIC_NETWORK_REQUEST = "SyntheticNetworkRequest"
 }
 export declare const Categories: {
     readonly Console: "blink.console";
@@ -2135,10 +2170,10 @@ export declare const Categories: {
  * handlers.
  */
 export interface LegacyTimelineFrame extends Event {
-    startTime: MicroSeconds;
-    startTimeOffset: MicroSeconds;
-    endTime: MicroSeconds;
-    duration: MicroSeconds;
+    startTime: Micro;
+    startTimeOffset: Micro;
+    endTime: Micro;
+    duration: Micro;
     idle: boolean;
     dropped: boolean;
     isPartial: boolean;