@paulirish/trace_engine 0.0.67-beta.0 → 0.0.67-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (147) hide show
  1. package/README.md +60 -22
  2. package/core/common/ParsedURL.d.ts +8 -0
  3. package/core/common/Settings.d.ts +2 -0
  4. package/core/host/Platform.d.ts +5 -0
  5. package/core/host/UserMetricsEnums.d.ts +8 -3
  6. package/core/platform/StringUtilities.d.ts +21 -0
  7. package/core/root/ExperimentNames.d.ts +2 -1
  8. package/core/root/Runtime.d.ts +4 -2
  9. package/core/sdk/CSSModel.d.ts +5 -0
  10. package/core/sdk/CSSPropertyParser.d.ts +0 -5
  11. package/core/sdk/DOMModel.d.ts +8 -4
  12. package/core/sdk/DebuggerModel.d.ts +37 -4
  13. package/core/sdk/NetworkRequest.d.ts +30 -2
  14. package/core/sdk/ResourceTreeModel.d.ts +3 -1
  15. package/core/sdk/RuntimeModel.d.ts +1 -0
  16. package/core/sdk/SDKSettings.d.ts +1 -0
  17. package/core/sdk/SourceMap.d.ts +20 -6
  18. package/core/sdk/SourceMapFunctionRanges.d.ts +3 -6
  19. package/core/sdk/SourceMapScopesInfo.d.ts +98 -23
  20. package/core/text_utils/Markdown.d.ts +13 -0
  21. package/core/text_utils/text_utils.d.ts +2 -1
  22. package/entrypoints/formatter_actions/formatter_actions.d.ts +17 -0
  23. package/generated/protocol-mapping.d.ts +64 -9
  24. package/generated/protocol-proxy-api.d.ts +58 -7
  25. package/generated/protocol.d.ts +93 -30
  26. package/index.d.ts +2 -0
  27. package/locales/af.json +129 -126
  28. package/locales/am.json +128 -125
  29. package/locales/ar.json +130 -127
  30. package/locales/as.json +130 -127
  31. package/locales/az.json +130 -127
  32. package/locales/be.json +128 -125
  33. package/locales/bg.json +130 -127
  34. package/locales/bn.json +130 -127
  35. package/locales/bs.json +130 -127
  36. package/locales/ca.json +130 -127
  37. package/locales/cs.json +128 -125
  38. package/locales/cy.json +130 -127
  39. package/locales/da.json +129 -126
  40. package/locales/de.json +130 -127
  41. package/locales/el.json +130 -127
  42. package/locales/en-GB.json +130 -127
  43. package/locales/en-US.json +1058 -0
  44. package/locales/es-419.json +129 -126
  45. package/locales/es.json +130 -127
  46. package/locales/et.json +95 -92
  47. package/locales/eu.json +130 -127
  48. package/locales/fa.json +130 -127
  49. package/locales/fi.json +129 -126
  50. package/locales/fil.json +130 -127
  51. package/locales/fr-CA.json +130 -127
  52. package/locales/fr.json +130 -127
  53. package/locales/gl.json +130 -127
  54. package/locales/gu.json +130 -127
  55. package/locales/he.json +130 -127
  56. package/locales/hi.json +130 -127
  57. package/locales/hr.json +128 -125
  58. package/locales/hu.json +90 -87
  59. package/locales/hy.json +127 -124
  60. package/locales/id.json +130 -127
  61. package/locales/is.json +129 -126
  62. package/locales/it.json +130 -127
  63. package/locales/ja.json +130 -127
  64. package/locales/ka.json +129 -126
  65. package/locales/kk.json +38 -35
  66. package/locales/km.json +130 -127
  67. package/locales/kn.json +130 -127
  68. package/locales/ko.json +22 -19
  69. package/locales/ky.json +130 -127
  70. package/locales/lo.json +130 -127
  71. package/locales/lt.json +130 -127
  72. package/locales/lv.json +66 -63
  73. package/locales/mk.json +130 -127
  74. package/locales/ml.json +129 -126
  75. package/locales/mn.json +129 -126
  76. package/locales/mr.json +130 -127
  77. package/locales/ms.json +130 -127
  78. package/locales/my.json +130 -127
  79. package/locales/ne.json +128 -125
  80. package/locales/nl.json +129 -126
  81. package/locales/no.json +130 -127
  82. package/locales/or.json +130 -127
  83. package/locales/pa.json +130 -127
  84. package/locales/pl.json +130 -127
  85. package/locales/pt-PT.json +129 -126
  86. package/locales/pt.json +130 -127
  87. package/locales/ro.json +129 -126
  88. package/locales/ru.json +50 -47
  89. package/locales/si.json +130 -127
  90. package/locales/sk.json +130 -127
  91. package/locales/sl.json +130 -127
  92. package/locales/sq.json +129 -126
  93. package/locales/sr-Latn.json +130 -127
  94. package/locales/sr.json +130 -127
  95. package/locales/sv.json +130 -127
  96. package/locales/sw.json +130 -127
  97. package/locales/ta.json +129 -126
  98. package/locales/te.json +130 -127
  99. package/locales/th.json +92 -89
  100. package/locales/tr.json +129 -126
  101. package/locales/uk.json +128 -125
  102. package/locales/ur.json +130 -127
  103. package/locales/uz.json +126 -123
  104. package/locales/vi.json +130 -127
  105. package/locales/zh-HK.json +130 -127
  106. package/locales/zh-TW.json +130 -127
  107. package/locales/zh.json +130 -127
  108. package/locales/zu.json +129 -126
  109. package/models/emulation/DeviceModeModel.d.ts +1 -0
  110. package/models/formatter/FormatterWorkerPool.d.ts +2 -2
  111. package/models/formatter/ScriptFormatter.d.ts +2 -2
  112. package/models/trace/extras/StackTraceForEvent.d.ts +1 -1
  113. package/models/trace/handlers/AnimationFramesHandler.d.ts +1 -1
  114. package/models/trace/handlers/AsyncJSCallsHandler.d.ts +2 -2
  115. package/models/trace/handlers/ImagePaintingHandler.d.ts +2 -2
  116. package/models/trace/handlers/InitiatorsHandler.d.ts +2 -2
  117. package/models/trace/handlers/LayerTreeHandler.d.ts +1 -1
  118. package/models/trace/handlers/NetworkRequestsHandler.d.ts +1 -1
  119. package/models/trace/handlers/PageLoadMetricsHandler.d.ts +1 -1
  120. package/models/trace/handlers/ScriptsHandler.d.ts +1 -1
  121. package/models/trace/handlers/WarningsHandler.d.ts +1 -1
  122. package/models/trace/helpers/SamplesIntegrator.d.ts +3 -1
  123. package/models/trace/helpers/Trace.d.ts +2 -0
  124. package/models/trace/insights/CLSCulprits.d.ts +1 -1
  125. package/models/trace/insights/DuplicatedJavaScript.d.ts +1 -1
  126. package/models/trace/insights/ImageDelivery.d.ts +1 -0
  127. package/models/trace/lantern/core/NetworkAnalyzer.d.ts +1 -0
  128. package/models/trace/lantern/graph/CPUNode.d.ts +4 -2
  129. package/models/trace/lantern/simulation/TCPConnection.d.ts +4 -4
  130. package/models/trace/lantern/types/Lantern.d.ts +15 -0
  131. package/models/trace/trace.js +21 -4
  132. package/models/trace/types/Overlays.d.ts +4 -3
  133. package/models/trace/types/TraceEvents.d.ts +184 -124
  134. package/package.json +14 -4
  135. package/third_party/marked/marked.d.ts +2 -0
  136. package/third_party/marked/package/lib/marked.esm.d.ts +760 -0
  137. package/third_party/source-map-scopes-codec/package/src/builder/builder.d.ts +4 -1
  138. package/third_party/source-map-scopes-codec/package/src/builder/safe_builder.d.ts +3 -1
  139. package/third_party/source-map-scopes-codec/package/src/codec.d.ts +6 -5
  140. package/third_party/source-map-scopes-codec/package/src/decode/decode.d.ts +2 -0
  141. package/third_party/source-map-scopes-codec/package/src/encode/encoder.d.ts +4 -1
  142. package/third_party/source-map-scopes-codec/package/src/scopes.d.ts +4 -3
  143. package/third_party/source-map-scopes-codec/package/src/vlq.d.ts +1 -1
  144. package/models/trace/lantern/lantern.js +0 -8
  145. package/models/trace/types/Timing.js +0 -8
  146. package/models/trace/types/TraceEvents.js +0 -189
  147. package/models/trace/types/types.js +0 -8
@@ -2,11 +2,13 @@ import * as Formatter from '../../models/formatter/formatter.js';
2
2
  import type * as ScopesCodec from '../../third_party/source-map-scopes-codec/source-map-scopes-codec.js';
3
3
  import type * as Platform from '../platform/platform.js';
4
4
  import type * as TextUtils from '../text_utils/text_utils.js';
5
- import type { CallFrame, ScopeChainEntry } from './DebuggerModel.js';
5
+ import type { CallFrame, Location, ScopeChainEntry } from './DebuggerModel.js';
6
6
  import type { SourceMap } from './SourceMap.js';
7
7
  export declare class SourceMapScopesInfo {
8
8
  #private;
9
- constructor(sourceMap: SourceMap, scopeInfo: ScopesCodec.ScopeInfo);
9
+ constructor(sourceMap: SourceMap, scopeInfo: ScopesCodec.ScopeInfo, { isFromAst }?: {
10
+ isFromAst?: boolean;
11
+ });
10
12
  /**
11
13
  * If the source map does not contain any scopes information, this factory function attempts to create scope information
12
14
  * via the script's AST combined with the mappings.
@@ -14,20 +16,12 @@ export declare class SourceMapScopesInfo {
14
16
  * We create the generated ranges from the scope tree and for each range we create an original scope that matches the bounds 1:1.
15
17
  */
16
18
  static createFromAst(sourceMap: SourceMap, scopeTree: Formatter.FormatterWorkerPool.ScopeTreeNode, text: TextUtils.Text.Text): SourceMapScopesInfo;
17
- addOriginalScopes(scopes: Array<ScopesCodec.OriginalScope | null>): void;
19
+ addOriginalScopes(scopes: Array<ScopesCodec.OriginalScope[] | null>): void;
18
20
  addGeneratedRanges(ranges: ScopesCodec.GeneratedRange[]): void;
19
21
  hasOriginalScopes(sourceIdx: number): boolean;
20
22
  isEmpty(): boolean;
21
- addOriginalScopesAtIndex(sourceIdx: number, scope: ScopesCodec.OriginalScope): void;
22
- /**
23
- * @returns true, iff the function surrounding the provided position is marked as "hidden".
24
- */
25
- isOutlinedFrame(generatedLine: number, generatedColumn: number): boolean;
26
- /**
27
- * @returns true, iff the range surrounding the provided position contains multiple
28
- * inlined original functions.
29
- */
30
- hasInlinedFrames(generatedLine: number, generatedColumn: number): boolean;
23
+ hasGeneratedRanges(): boolean;
24
+ addOriginalScopesAtIndex(sourceIdx: number, scopes: ScopesCodec.OriginalScope[]): void;
31
25
  /**
32
26
  * @returns true if we have enough info (i.e. variable and binding expressions) to build
33
27
  * a scope view.
@@ -57,6 +51,7 @@ export declare class SourceMapScopesInfo {
57
51
  * values.
58
52
  */
59
53
  resolveMappedScopeChain(callFrame: CallFrame): ScopeChainEntry[] | null;
54
+ resolveMappedVariablesAtPosition(line: number, column: number, ignoreInnerBlockScopes?: boolean, inlineFrameIndex?: number): Array<Map<string, string | null>> | null;
60
55
  /**
61
56
  * Returns the authored function name of the function containing the provided generated position.
62
57
  */
@@ -64,34 +59,114 @@ export declare class SourceMapScopesInfo {
64
59
  /**
65
60
  * Returns the authored function scope of the function containing the provided generated position.
66
61
  */
67
- findOriginalFunctionScope({ line, column }: ScopesCodec.Position): {
62
+ findOriginalFunctionScope(position: ScopesCodec.Position): {
68
63
  scope: ScopesCodec.OriginalScope;
69
64
  url?: Platform.DevToolsPath.UrlString;
70
65
  } | null;
71
66
  /**
72
- * Returns one or more original stack frames for this single "raw frame" or call-site.
67
+ * Translates a single "raw frame" or call-site, including outlined functions. It's the caller's responsibility to
68
+ * merge outlined frames with their caller(s) (see {@link GeneratedFrameKind}).
69
+ */
70
+ translateRawFrame(generatedLine: number, generatedColumn: number): RawFrameTranslation;
71
+ /**
72
+ * @returns the body of the innermost inlined function at the position (the innermost range with a `callSite`
73
+ * within the generated function), or null if the position is not inside an inlined function.
74
+ *
75
+ * The innermost inlined function is the logical frame the position belongs to, i.e. the analogue of the top frame
76
+ * of a real call stack. Stepping over its body therefore goes up exactly one logical frame: into the caller, which
77
+ * may itself be inlined. An outer range would leave several logical frames at once.
78
+ */
79
+ inlinedFunctionRange(generatedLine: number, generatedColumn: number): PositionRange | null;
80
+ /**
81
+ * @returns the bodies of all functions that were inlined directly into the logical function at the position
82
+ * (the innermost inlined function, or else the generated function). Doesn't descend into inlined
83
+ * functions or nested generated functions.
84
+ */
85
+ inlinedCalleeRanges(generatedLine: number, generatedColumn: number): PositionRange[];
86
+ /**
87
+ * @returns the outlined parts of the authored function at the position: the hidden generated functions whose
88
+ * original scope lies within that function's original scope (see {@link GeneratedFrameKind.OUTLINED}),
89
+ * but not within a nested authored function. Includes the outlined part the position itself is in, if
90
+ * any. Sorted by start position.
91
+ */
92
+ outlinedFunctionRanges(generatedLine: number, generatedColumn: number): PositionRange[];
93
+ /**
94
+ * @returns the "artificial" generated functions (in the DWARF sense): functions that contain no authored code at all
95
+ * (no original scope anywhere in their subtree), e.g. compiler helpers. Sorted by start position,
96
+ * non-overlapping.
97
+ */
98
+ artificialFunctionRanges(): PositionRange[];
99
+ }
100
+ /** A range of generated positions, relative to the start of the script. `end` is exclusive. */
101
+ export interface PositionRange {
102
+ readonly start: ScopesCodec.Position;
103
+ readonly end: ScopesCodec.Position;
104
+ }
105
+ /**
106
+ * Describes how the generated function surrounding a generated position shows up in stack traces.
107
+ *
108
+ * Compilers tend to introduce functions (and calls to them) that don't exist in the authored code. The scopes
109
+ * proposal distinguishes two cases:
110
+ *
111
+ * 1) The generated function contains authored code, e.g. a block scope that was turned into a function. The
112
+ * generated range is marked "hidden", but links to the original scope via its definition. We can pause
113
+ * in such a function, but the frame is merged with its caller(s) in stack traces: The outlined code
114
+ * logically belongs to the (authored) function that transitively calls it.
115
+ *
116
+ * 2) The generated function doesn't represent any authored code, e.g. a compiler helper. The generated range
117
+ * has no definition. The scopes spec is being updated to say that such a range can be ignored in stack
118
+ * traces, so we drop these frames.
119
+ */
120
+ export declare const enum GeneratedFrameKind {
121
+ /** A regular (possibly with inlined functions) generated function, or top-level code. */
122
+ VISIBLE = "VISIBLE",
123
+ /** A generated function marked as "hidden" that has a definition (case 1). */
124
+ OUTLINED = "OUTLINED",
125
+ /** A generated function without a definition (case 2). */
126
+ HIDDEN = "HIDDEN"
127
+ }
128
+ /** See {@link SourceMapScopesInfo.translateRawFrame}. */
129
+ export interface RawFrameTranslation {
130
+ kind: GeneratedFrameKind;
131
+ /**
132
+ * [top, ...inlinedCallers] in top-to-bottom order. Empty for {@link GeneratedFrameKind.HIDDEN} frames, or if
133
+ * neither the mappings nor the generated ranges know anything about the generated position.
73
134
  *
74
- * @returns An empty array if no mapping at the call-site was found, or the resulting frames
75
- * in top-to-bottom order in case of inlining.
76
- * @throws If this range is marked "hidden". Outlining needs to be handled externally as
77
- * outlined function segments in stack traces can span across bundles.
135
+ * For {@link GeneratedFrameKind.OUTLINED} frames, the top frame is named after the authored function the outlined
136
+ * code belongs to.
78
137
  */
79
- translateCallSite(generatedLine: number, generatedColumn: number): TranslatedFrame[];
138
+ frames: TranslatedFrame[];
80
139
  }
81
140
  /**
82
141
  * Represents a stack frame in original terms. It closely aligns with StackTrace.StackTrace.Frame,
83
142
  * but since we can't import that type here we mirror it here somewhat.
84
143
  *
85
- * Equivalent to Pick<StackTrace.StackTrace.Frame, 'line'|'column'|'name'|'url'>.
144
+ * Equivalent to Pick<StackTrace.StackTrace.Frame, 'line'|'column'|'name'|'url'>, except that the position is
145
+ * optional.
86
146
  */
87
147
  export interface TranslatedFrame {
88
- line: number;
89
- column: number;
148
+ /**
149
+ * `line` and `column` are undefined iff the generated position has no mapping. The frame then only identifies
150
+ * the authored function: `name`, `functionStart` and the `url` of the function's source.
151
+ */
152
+ line?: number;
153
+ column?: number;
90
154
  name?: string;
91
155
  url?: Platform.DevToolsPath.UrlString;
156
+ /** Start of the original function scope containing this frame's position. Undefined for top-level code. */
157
+ functionStart?: ScopesCodec.Position;
92
158
  }
159
+ export declare function findExpression(range: ScopesCodec.GeneratedRange | undefined, index: number, line?: number, column?: number): string | null;
93
160
  export declare function contains(range: Pick<ScopesCodec.GeneratedRange, 'start' | 'end'>, line: number, column: number): boolean;
94
161
  export declare function comparePositions(a: ScopesCodec.Position, b: ScopesCodec.Position): number;
162
+ /**
163
+ * Converts a raw V8 {@link location} into a generated position relative to the start of its script.
164
+ *
165
+ * Positions in source maps (mappings and generated ranges) are relative to the start of the script,
166
+ * while V8 reports locations in inline `<script>`s (without `//# sourceURL`) relative to the start of
167
+ * the surrounding document.
168
+ */
169
+ export declare function scriptRelativePosition(location: Location): ScopesCodec.Position;
95
170
  /**
96
171
  * Finds the V8 scope that corresponds to the source map's generated `range`.
97
172
  *
@@ -0,0 +1,13 @@
1
+ import * as Marked from '../../third_party/marked/marked.js';
2
+ export interface PlaceholderToken extends Marked.Marked.Tokens.Generic {
3
+ type: 'placeholder';
4
+ raw: string;
5
+ key: string;
6
+ }
7
+ export declare const VALID_PLACEHOLDER_MATCH_PATTERN: RegExp;
8
+ export declare function validateSubstitutions(rawMarkdown: string, substitutions?: Map<string, string>): void;
9
+ /**
10
+ * Tokenizes markdown into a Marked AST while preserving `{PLACEHOLDER_*}` tokens
11
+ * as `PlaceholderToken` AST nodes instead of substituting strings before lexing.
12
+ */
13
+ export declare function tokenizeWithPlaceholders(markdown: string | Marked.Marked.Token[], substitutions?: Map<string, string>): Marked.Marked.Token[];
@@ -1,6 +1,7 @@
1
1
  import * as CodeMirrorUtils from './CodeMirrorUtils.js';
2
2
  import * as ContentData from './ContentData.js';
3
3
  import * as ContentProvider from './ContentProvider.js';
4
+ import * as Markdown from './Markdown.js';
4
5
  import * as StaticContentProvider from './StaticContentProvider.js';
5
6
  import * as StreamingContentData from './StreamingContentData.js';
6
7
  import * as Text from './Text.js';
@@ -8,4 +9,4 @@ import * as TextCursor from './TextCursor.js';
8
9
  import * as TextRange from './TextRange.js';
9
10
  import * as TextUtils from './TextUtils.js';
10
11
  import * as WasmDisassembly from './WasmDisassembly.js';
11
- export { CodeMirrorUtils, ContentData, ContentProvider, StaticContentProvider, StreamingContentData, Text, TextCursor, TextRange, TextUtils, WasmDisassembly, };
12
+ export { CodeMirrorUtils, ContentData, ContentProvider, Markdown, StaticContentProvider, StreamingContentData, Text, TextCursor, TextRange, TextUtils, WasmDisassembly, };
@@ -33,6 +33,23 @@ export declare const enum ScopeKind {
33
33
  GLOBAL = 3,
34
34
  ARROW_FUNCTION = 4
35
35
  }
36
+ /**
37
+ * Describes a single scope for `javaScriptSubstitute`.
38
+ */
39
+ export interface ScopeVariableMapping {
40
+ /**
41
+ * Authored variable name -> generated binding expression, or `null` if the variable is unavailable.
42
+ */
43
+ bindings: Map<string, string | null>;
44
+ /**
45
+ * Generated identifiers declared by this scope. Together with the free identifiers of `bindings`, these
46
+ * shadow bindings of outer scopes that refer to the same generated identifiers.
47
+ *
48
+ * This is needed when a generated identifier doesn't show up in any binding expression, e.g. because
49
+ * multiple generated identifiers map to the same authored name, or the authored name is unknown.
50
+ */
51
+ generatedNames: string[];
52
+ }
36
53
  export interface ScopeTreeNode {
37
54
  variables: Array<{
38
55
  name: string;
@@ -4,7 +4,7 @@
4
4
 
5
5
  /**
6
6
  * This file is auto-generated, do not edit manually. *
7
- * Re-generate with: npm run generate-protocol-resources.
7
+ * Re-generate with: scripts/tools/dt.py generate-protocol-resources.
8
8
  */
9
9
 
10
10
 
@@ -1567,6 +1567,13 @@ export namespace ProtocolMapping {
1567
1567
  paramsType: [Protocol.CSS.ForceStartingStyleRequest];
1568
1568
  returnType: void;
1569
1569
  };
1570
+ /**
1571
+ * Forces a position-try option for the given node.
1572
+ */
1573
+ 'CSS.forcePositionTryOption': {
1574
+ paramsType: [Protocol.CSS.ForcePositionTryOptionRequest];
1575
+ returnType: void;
1576
+ };
1570
1577
  'CSS.getBackgroundColors': {
1571
1578
  paramsType: [Protocol.CSS.GetBackgroundColorsRequest];
1572
1579
  returnType: Protocol.CSS.GetBackgroundColorsResponse;
@@ -3082,6 +3089,37 @@ export namespace ProtocolMapping {
3082
3089
  paramsType: [Protocol.FileSystem.GetDirectoryRequest];
3083
3090
  returnType: Protocol.FileSystem.GetDirectoryResponse;
3084
3091
  };
3092
+ /**
3093
+ * Forwards `query` to the find-in-page facility, starting a new find session.
3094
+ * Where exactly the search starts from is implementation-specific.
3095
+ */
3096
+ 'FindInPage.findFirst': {
3097
+ paramsType: [Protocol.FindInPage.FindFirstRequest];
3098
+ returnType: void;
3099
+ };
3100
+ /**
3101
+ * Moves to the next match for the query passed to the most recent
3102
+ * findFirst() call.
3103
+ */
3104
+ 'FindInPage.findNext': {
3105
+ paramsType: [];
3106
+ returnType: void;
3107
+ };
3108
+ /**
3109
+ * Moves to the previous match for the query passed to the most recent
3110
+ * findFirst() call.
3111
+ */
3112
+ 'FindInPage.findPrev': {
3113
+ paramsType: [];
3114
+ returnType: void;
3115
+ };
3116
+ /**
3117
+ * Ends the current find session, if any, and clears its highlighting.
3118
+ */
3119
+ 'FindInPage.stop': {
3120
+ paramsType: [];
3121
+ returnType: void;
3122
+ };
3085
3123
  /**
3086
3124
  * Sends a BeginFrame to the target and returns when the frame was completed. Optionally captures a
3087
3125
  * screenshot from the resulting frame. Requires that the target was created with enabled
@@ -4190,6 +4228,16 @@ export namespace ProtocolMapping {
4190
4228
  paramsType: [Protocol.Page.GetAdScriptAncestryRequest];
4191
4229
  returnType: Protocol.Page.GetAdScriptAncestryResponse;
4192
4230
  };
4231
+ /**
4232
+ * Returns the words that the frame's document added to its spell check custom
4233
+ * dictionary with `document.spellCheckCustomDictionary.addWords()`, sorted.
4234
+ * Page script cannot read the dictionary back; this lets developers inspect
4235
+ * it.
4236
+ */
4237
+ 'Page.getSpellCheckCustomDictionary': {
4238
+ paramsType: [Protocol.Page.GetSpellCheckCustomDictionaryRequest];
4239
+ returnType: Protocol.Page.GetSpellCheckCustomDictionaryResponse;
4240
+ };
4193
4241
  /**
4194
4242
  * Returns present frame tree structure.
4195
4243
  */
@@ -4534,6 +4582,13 @@ export namespace ProtocolMapping {
4534
4582
  paramsType: [Protocol.Page.GetAnnotatedPageContentRequest?];
4535
4583
  returnType: Protocol.Page.GetAnnotatedPageContentResponse;
4536
4584
  };
4585
+ /**
4586
+ * Configures input visualization on the page.
4587
+ */
4588
+ 'Page.setInputVisualization': {
4589
+ paramsType: [Protocol.Page.SetInputVisualizationRequest?];
4590
+ returnType: void;
4591
+ };
4537
4592
  /**
4538
4593
  * Disable collecting and reporting metrics.
4539
4594
  */
@@ -4954,6 +5009,14 @@ export namespace ProtocolMapping {
4954
5009
  paramsType: [];
4955
5010
  returnType: Protocol.Storage.GetPrivateVerificationTokensResponse;
4956
5011
  };
5012
+ /**
5013
+ * Returns the configured Private Verification Tokens issuers and their redeemer
5014
+ * origins.
5015
+ */
5016
+ 'Storage.getPrivateVerificationTokensIssuerConfigs': {
5017
+ paramsType: [];
5018
+ returnType: Protocol.Storage.GetPrivateVerificationTokensIssuerConfigsResponse;
5019
+ };
4957
5020
  /**
4958
5021
  * Removes all Private Verification Tokens issued by the provided issuerOrigin.
4959
5022
  */
@@ -4996,14 +5059,6 @@ export namespace ProtocolMapping {
4996
5059
  paramsType: [];
4997
5060
  returnType: Protocol.Storage.RunBounceTrackingMitigationsResponse;
4998
5061
  };
4999
- /**
5000
- * Returns the effective Related Website Sets in use by this profile for the browser
5001
- * session. The effective Related Website Sets will not change during a browser session.
5002
- */
5003
- 'Storage.getRelatedWebsiteSets': {
5004
- paramsType: [];
5005
- returnType: Protocol.Storage.GetRelatedWebsiteSetsResponse;
5006
- };
5007
5062
  /**
5008
5063
  * Returns information about the system.
5009
5064
  */
@@ -4,7 +4,7 @@
4
4
 
5
5
  /**
6
6
  * This file is auto-generated, do not edit manually. *
7
- * Re-generate with: npm run generate-protocol-resources.
7
+ * Re-generate with: scripts/tools/dt.py generate-protocol-resources.
8
8
  */
9
9
 
10
10
 
@@ -67,6 +67,8 @@ import type * as Protocol from './protocol.js'
67
67
 
68
68
  FileSystem: FileSystemApi;
69
69
 
70
+ FindInPage: FindInPageApi;
71
+
70
72
  HeadlessExperimental: HeadlessExperimentalApi;
71
73
 
72
74
  IO: IOApi;
@@ -184,6 +186,8 @@ import type * as Protocol from './protocol.js'
184
186
 
185
187
  FileSystem: FileSystemDispatcher;
186
188
 
189
+ FindInPage: FindInPageDispatcher;
190
+
187
191
  HeadlessExperimental: HeadlessExperimentalDispatcher;
188
192
 
189
193
  IO: IODispatcher;
@@ -791,6 +795,11 @@ import type * as Protocol from './protocol.js'
791
795
  */
792
796
  invoke_forceStartingStyle(params: Protocol.CSS.ForceStartingStyleRequest): Promise<Protocol.ProtocolResponseWithError>;
793
797
 
798
+ /**
799
+ * Forces a position-try option for the given node.
800
+ */
801
+ invoke_forcePositionTryOption(params: Protocol.CSS.ForcePositionTryOptionRequest): Promise<Protocol.ProtocolResponseWithError>;
802
+
794
803
  invoke_getBackgroundColors(params: Protocol.CSS.GetBackgroundColorsRequest): Promise<Protocol.CSS.GetBackgroundColorsResponse>;
795
804
 
796
805
  /**
@@ -2180,6 +2189,34 @@ import type * as Protocol from './protocol.js'
2180
2189
  export interface FileSystemDispatcher {
2181
2190
  }
2182
2191
 
2192
+ export interface FindInPageApi {
2193
+ /**
2194
+ * Forwards `query` to the find-in-page facility, starting a new find session.
2195
+ * Where exactly the search starts from is implementation-specific.
2196
+ */
2197
+ invoke_findFirst(params: Protocol.FindInPage.FindFirstRequest): Promise<Protocol.ProtocolResponseWithError>;
2198
+
2199
+ /**
2200
+ * Moves to the next match for the query passed to the most recent
2201
+ * findFirst() call.
2202
+ */
2203
+ invoke_findNext(): Promise<Protocol.ProtocolResponseWithError>;
2204
+
2205
+ /**
2206
+ * Moves to the previous match for the query passed to the most recent
2207
+ * findFirst() call.
2208
+ */
2209
+ invoke_findPrev(): Promise<Protocol.ProtocolResponseWithError>;
2210
+
2211
+ /**
2212
+ * Ends the current find session, if any, and clears its highlighting.
2213
+ */
2214
+ invoke_stop(): Promise<Protocol.ProtocolResponseWithError>;
2215
+
2216
+ }
2217
+ export interface FindInPageDispatcher {
2218
+ }
2219
+
2183
2220
  export interface HeadlessExperimentalApi {
2184
2221
  /**
2185
2222
  * Sends a BeginFrame to the target and returns when the frame was completed. Optionally captures a
@@ -2220,6 +2257,7 @@ import type * as Protocol from './protocol.js'
2220
2257
 
2221
2258
  /**
2222
2259
  * Return UUID of Blob object specified by a remote object id.
2260
+ * @deprecated
2223
2261
  */
2224
2262
  invoke_resolveBlob(params: Protocol.IO.ResolveBlobRequest): Promise<Protocol.IO.ResolveBlobResponse>;
2225
2263
 
@@ -3384,6 +3422,14 @@ import type * as Protocol from './protocol.js'
3384
3422
 
3385
3423
  invoke_getAdScriptAncestry(params: Protocol.Page.GetAdScriptAncestryRequest): Promise<Protocol.Page.GetAdScriptAncestryResponse>;
3386
3424
 
3425
+ /**
3426
+ * Returns the words that the frame's document added to its spell check custom
3427
+ * dictionary with `document.spellCheckCustomDictionary.addWords()`, sorted.
3428
+ * Page script cannot read the dictionary back; this lets developers inspect
3429
+ * it.
3430
+ */
3431
+ invoke_getSpellCheckCustomDictionary(params: Protocol.Page.GetSpellCheckCustomDictionaryRequest): Promise<Protocol.Page.GetSpellCheckCustomDictionaryResponse>;
3432
+
3387
3433
  /**
3388
3434
  * Returns present frame tree structure.
3389
3435
  */
@@ -3642,6 +3688,11 @@ import type * as Protocol from './protocol.js'
3642
3688
  */
3643
3689
  invoke_getAnnotatedPageContent(params: Protocol.Page.GetAnnotatedPageContentRequest): Promise<Protocol.Page.GetAnnotatedPageContentResponse>;
3644
3690
 
3691
+ /**
3692
+ * Configures input visualization on the page.
3693
+ */
3694
+ invoke_setInputVisualization(params: Protocol.Page.SetInputVisualizationRequest): Promise<Protocol.ProtocolResponseWithError>;
3695
+
3645
3696
  }
3646
3697
  export interface PageDispatcher {
3647
3698
  domContentEventFired(params: Protocol.Page.DomContentEventFiredEvent): void;
@@ -4330,6 +4381,12 @@ import type * as Protocol from './protocol.js'
4330
4381
  */
4331
4382
  invoke_getPrivateVerificationTokens(): Promise<Protocol.Storage.GetPrivateVerificationTokensResponse>;
4332
4383
 
4384
+ /**
4385
+ * Returns the configured Private Verification Tokens issuers and their redeemer
4386
+ * origins.
4387
+ */
4388
+ invoke_getPrivateVerificationTokensIssuerConfigs(): Promise<Protocol.Storage.GetPrivateVerificationTokensIssuerConfigsResponse>;
4389
+
4333
4390
  /**
4334
4391
  * Removes all Private Verification Tokens issued by the provided issuerOrigin.
4335
4392
  */
@@ -4360,12 +4417,6 @@ import type * as Protocol from './protocol.js'
4360
4417
  */
4361
4418
  invoke_runBounceTrackingMitigations(): Promise<Protocol.Storage.RunBounceTrackingMitigationsResponse>;
4362
4419
 
4363
- /**
4364
- * Returns the effective Related Website Sets in use by this profile for the browser
4365
- * session. The effective Related Website Sets will not change during a browser session.
4366
- */
4367
- invoke_getRelatedWebsiteSets(): Promise<Protocol.Storage.GetRelatedWebsiteSetsResponse>;
4368
-
4369
4420
  }
4370
4421
  export interface StorageDispatcher {
4371
4422
  /**