chrome-devtools-frontend 1.0.1726686 → 1.0.1730971

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 (490) hide show
  1. package/.agents/rules/tests/test-strict-assertions-and-literal-expectations.md +1 -1
  2. package/.agents/rules/tests/test-view-and-presenter-isolation.md +1 -1
  3. package/.agents/rules/ui-and-widgets/ui-accessibility-and-semantic-html.md +1 -1
  4. package/.agents/rules/ui-and-widgets/ui-css-scoping-and-flex-layout.md +2 -2
  5. package/.agents/rules/ui-and-widgets/ui-declarative-child-widget-composition.md +5 -5
  6. package/.agents/rules/ui-and-widgets/ui-lit-declarative-templates-and-directives.md +2 -2
  7. package/.agents/rules/ui-and-widgets/ui-localization-and-uistrings-hygiene.md +2 -2
  8. package/.agents/rules/ui-and-widgets/ui-modern-component-and-encapsulation-standards.md +3 -3
  9. package/.agents/rules/ui-and-widgets/ui-pure-view-and-presenter-separation.md +2 -2
  10. package/.agents/rules/ui-and-widgets/ui-reactive-widget-update-lifecycle.md +2 -2
  11. package/.agents/rules/ui-and-widgets/ui-view-output-and-callback-contracts.md +2 -2
  12. package/.agents/rules/ui-and-widgets/ui-widget-dom-and-listener-lifecycle.md +2 -2
  13. package/.agents/skills/code-review/SKILL.md +63 -12
  14. package/.agents/skills/ui-eng-vision-local-lit-renderer/SKILL.md +38 -10
  15. package/.agents/skills/ui-eng-vision-widget-promoter/SKILL.md +1 -0
  16. package/.agents/skills/ui-widgets/SKILL.md +8 -2
  17. package/.agents/skills/write-ai-eval-test/SKILL.md +106 -0
  18. package/AUTHORS +2 -0
  19. package/DIR_METADATA +1 -2
  20. package/README.md +48 -26
  21. package/config/typescript/tsconfig.base.json +1 -0
  22. package/config/typescript/tsconfig.eslint.json +1 -0
  23. package/docs/contributing/changes.md +25 -0
  24. package/docs/ui_engineering.md +13 -4
  25. package/eslint.config.mjs +323 -41
  26. package/front_end/core/common/Color.ts +7 -7
  27. package/front_end/core/common/ParsedURL.ts +3 -3
  28. package/front_end/core/common/ResolverBase.ts +3 -3
  29. package/front_end/core/common/SegmentedRange.ts +3 -3
  30. package/front_end/core/common/SimpleHistoryManager.ts +14 -14
  31. package/front_end/core/common/Trie.ts +3 -3
  32. package/front_end/core/common/VersionController.ts +7 -7
  33. package/front_end/core/host/InspectorFrontendHost.ts +2 -2
  34. package/front_end/core/host/InspectorFrontendHostAPI.ts +9 -1
  35. package/front_end/core/host/InspectorFrontendHostStub.ts +1 -1
  36. package/front_end/core/host/UserMetrics.ts +4 -0
  37. package/front_end/core/host/UserMetricsEnums.ts +2 -1
  38. package/front_end/core/platform/StringUtilities.ts +54 -13
  39. package/front_end/core/platform/node/HostRuntime.ts +13 -7
  40. package/front_end/core/protocol_client/DevToolsCDPConnection.ts +4 -5
  41. package/front_end/core/root/Runtime.ts +5 -0
  42. package/front_end/core/sdk/AccessibilityModel.ts +5 -5
  43. package/front_end/core/sdk/AnimationModel.ts +17 -19
  44. package/front_end/core/sdk/CPUProfilerModel.ts +3 -3
  45. package/front_end/core/sdk/CPUThrottlingManager.ts +7 -0
  46. package/front_end/core/sdk/CSSMatchedStyles.ts +73 -13
  47. package/front_end/core/sdk/CSSMetadata.ts +7 -7
  48. package/front_end/core/sdk/CSSModel.ts +33 -33
  49. package/front_end/core/sdk/CSSProperty.ts +5 -5
  50. package/front_end/core/sdk/CSSRule.ts +6 -6
  51. package/front_end/core/sdk/CSSStyleSheetHeader.ts +4 -4
  52. package/front_end/core/sdk/Connections.ts +16 -16
  53. package/front_end/core/sdk/ConsoleModel.ts +44 -47
  54. package/front_end/core/sdk/CookieParser.ts +11 -11
  55. package/front_end/core/sdk/EmulationModel.ts +35 -36
  56. package/front_end/core/sdk/EventBreakpointsModel.ts +11 -11
  57. package/front_end/core/sdk/FrameManager.ts +16 -16
  58. package/front_end/core/sdk/IsolateManager.ts +2 -2
  59. package/front_end/core/sdk/IssuesModel.ts +2 -2
  60. package/front_end/core/sdk/OverlayModel.ts +19 -19
  61. package/front_end/core/sdk/PageResourceLoader.ts +14 -16
  62. package/front_end/core/sdk/RemoteObject.ts +9 -9
  63. package/front_end/core/sdk/Resource.ts +2 -2
  64. package/front_end/core/sdk/RuntimeModel.ts +7 -7
  65. package/front_end/core/sdk/Script.ts +6 -6
  66. package/front_end/core/sdk/ServiceWorkerManager.ts +36 -10
  67. package/front_end/core/sdk/SourceMap.ts +18 -20
  68. package/front_end/core/sdk/SourceMapManager.ts +2 -2
  69. package/front_end/core/sdk/TargetManager.ts +2 -2
  70. package/front_end/devtools_compatibility.js +7 -3
  71. package/front_end/entrypoints/inspector_main/InspectorMain.ts +2 -2
  72. package/front_end/entrypoints/node_app/app/NodeConnectionsPanel.ts +203 -115
  73. package/front_end/generated/InspectorBackendCommands.ts +1 -1
  74. package/front_end/generated/SupportedCSSProperties.ts +1 -3
  75. package/front_end/generated/protocol.ts +1 -0
  76. package/front_end/models/ai_assistance/AiAgent2.ts +36 -12
  77. package/front_end/models/ai_assistance/AiConversation.ts +8 -2
  78. package/front_end/models/ai_assistance/agents/AiAgent.ts +137 -62
  79. package/front_end/models/ai_assistance/agents/ExecuteJavascript.ts +2 -2
  80. package/front_end/models/ai_assistance/agents/StylingAgent.snapshot.txt +2 -2
  81. package/front_end/models/ai_assistance/data_formatters/LighthouseFormatter.snapshot.txt +149 -2
  82. package/front_end/models/ai_assistance/data_formatters/LighthouseFormatter.ts +269 -42
  83. package/front_end/models/ai_assistance/tools/ExecuteJavaScript.ts +3 -0
  84. package/front_end/models/ai_assistance/tools/GetLighthouseAudits.ts +9 -0
  85. package/front_end/models/ai_assistance/tools/ResolveDevtoolsNodePath.ts +13 -2
  86. package/front_end/models/ai_assistance/tools/RunLighthouse.ts +23 -7
  87. package/front_end/models/ai_assistance/tools/Tool.ts +7 -5
  88. package/front_end/models/bindings/CSSWorkspaceBinding.ts +22 -24
  89. package/front_end/models/bindings/DebuggerLanguagePlugins.ts +60 -60
  90. package/front_end/models/bindings/DebuggerWorkspaceBinding.ts +24 -24
  91. package/front_end/models/bindings/DefaultScriptMapping.ts +8 -8
  92. package/front_end/models/bindings/FileUtils.ts +13 -13
  93. package/front_end/models/bindings/PresentationConsoleMessageHelper.ts +3 -3
  94. package/front_end/models/bindings/ResourceScriptMapping.ts +23 -23
  95. package/front_end/models/comment_manager/CommentManager.ts +3 -3
  96. package/front_end/models/comment_manager/CommentThread.ts +50 -5
  97. package/front_end/models/cpu_profile/CPUProfileDataModel.ts +14 -14
  98. package/front_end/models/cpu_profile/ProfileTreeModel.ts +4 -4
  99. package/front_end/models/elements/StyleChanges.ts +38 -0
  100. package/front_end/models/emulation/EmulatedDevices.ts +12 -12
  101. package/front_end/models/har/HARFormat.ts +4 -4
  102. package/front_end/models/javascript_metadata/NativeFunctions.ts +5 -1
  103. package/front_end/models/lighthouse/LighthouseReporterTypes.ts +57 -3
  104. package/front_end/models/lighthouse/RunTypes.ts +9 -1
  105. package/front_end/models/logs/LogManager.ts +2 -2
  106. package/front_end/models/persistence/AutomaticFileSystemManager.ts +3 -0
  107. package/front_end/models/persistence/FileSystemWorkspaceBinding.ts +24 -24
  108. package/front_end/models/persistence/IsolatedFileSystemManager.ts +6 -0
  109. package/front_end/models/persistence/NetworkPersistenceManager.ts +8 -3
  110. package/front_end/models/trace/LanternComputationData.ts +37 -11
  111. package/front_end/models/trace/Processor.ts +2 -1
  112. package/front_end/models/trace/extras/TraceTree.ts +36 -10
  113. package/front_end/models/trace/handlers/InitiatorsHandler.ts +27 -34
  114. package/front_end/models/trace/handlers/LayoutShiftsHandler.ts +2 -6
  115. package/front_end/models/trace/handlers/SamplesHandler.ts +9 -6
  116. package/front_end/models/workspace/FileManager.ts +6 -0
  117. package/front_end/panels/accessibility/ARIAAttributesView.ts +4 -4
  118. package/front_end/panels/accessibility/AccessibilityAnnouncementRecordingView.ts +8 -1
  119. package/front_end/panels/accessibility/AccessibilityNodeView.ts +15 -17
  120. package/front_end/panels/accessibility/AccessibilitySubPane.ts +1 -1
  121. package/front_end/panels/ai_assistance/AiAssistancePanel.ts +5 -5
  122. package/front_end/panels/ai_assistance/ExternalHandler.ts +10 -1
  123. package/front_end/panels/ai_assistance/components/ChatMessage.ts +27 -22
  124. package/front_end/panels/ai_assistance/components/DisabledWidget.ts +19 -23
  125. package/front_end/panels/ai_assistance/components/ExploreWidget.ts +2 -2
  126. package/front_end/panels/ai_assistance/components/PermissionPrompt.ts +23 -9
  127. package/front_end/panels/ai_assistance/components/chatInput.css +1 -1
  128. package/front_end/panels/animation/AnimationTimeline.ts +37 -17
  129. package/front_end/panels/animation/animationTimeline.css +19 -3
  130. package/front_end/panels/application/AppManifestView.ts +1 -2
  131. package/front_end/panels/application/ApplicationPanelSidebar.ts +143 -128
  132. package/front_end/panels/application/DOMStorageItemsView.ts +14 -14
  133. package/front_end/panels/application/DeviceBoundSessionsView.ts +10 -13
  134. package/front_end/panels/application/ExtensionStorageItemsView.ts +3 -4
  135. package/front_end/panels/application/IndexedDBViews.ts +8 -4
  136. package/front_end/panels/application/KeyValueStorageItemsView.ts +4 -5
  137. package/front_end/panels/application/PrivateVerificationTokensView.ts +53 -0
  138. package/front_end/panels/application/ServiceWorkerCacheViews.ts +12 -8
  139. package/front_end/panels/application/ServiceWorkersView.ts +1 -2
  140. package/front_end/panels/application/StorageItemsToolbar.ts +3 -3
  141. package/front_end/panels/application/StorageView.ts +2 -2
  142. package/front_end/panels/application/WebMCPView.ts +91 -109
  143. package/front_end/panels/application/application.ts +2 -0
  144. package/front_end/panels/application/components/StorageMetadataView.ts +6 -6
  145. package/front_end/panels/application/preloading/PreloadingView.ts +70 -37
  146. package/front_end/panels/application/preloading/components/MismatchedPreloadingGrid.ts +2 -2
  147. package/front_end/panels/application/preloading/components/PreloadingDisabledInfobar.ts +3 -3
  148. package/front_end/panels/application/preloading/components/PreloadingGrid.ts +12 -0
  149. package/front_end/panels/application/preloading/components/RuleSetDetailsView.ts +10 -11
  150. package/front_end/panels/application/privateVerificationTokensView.css +20 -0
  151. package/front_end/panels/application/serviceWorkersView.css +2 -2
  152. package/front_end/panels/browser_debugger/DOMBreakpointsSidebarPane.ts +24 -24
  153. package/front_end/panels/changes/ChangesSidebar.ts +5 -5
  154. package/front_end/panels/changes/ChangesView.ts +10 -11
  155. package/front_end/panels/comments/CommentsPane.ts +292 -102
  156. package/front_end/panels/comments/commentsPane.css +93 -12
  157. package/front_end/panels/common/CommentThreadWidget.ts +69 -0
  158. package/front_end/panels/common/CommentsOverlayWidget.ts +108 -29
  159. package/front_end/panels/common/CommentsStatusBarPill.ts +17 -6
  160. package/front_end/panels/common/DOMLinkifier.ts +37 -12
  161. package/front_end/panels/common/ExtensionPanel.ts +13 -4
  162. package/front_end/panels/common/ExtensionServer.ts +27 -3
  163. package/front_end/panels/common/PersistenceUtils.ts +3 -3
  164. package/front_end/panels/common/commentThreadWidget.css +25 -1
  165. package/front_end/panels/common/common-meta.ts +10 -0
  166. package/front_end/panels/console/ConsolePinPane.ts +13 -15
  167. package/front_end/panels/console/ConsolePrompt.ts +173 -95
  168. package/front_end/panels/console/ConsoleSidebar.ts +2 -2
  169. package/front_end/panels/console/ConsoleView.ts +75 -79
  170. package/front_end/panels/console/ConsoleViewMessage.ts +52 -4
  171. package/front_end/panels/console/SymbolizedErrorWidget.ts +8 -4
  172. package/front_end/panels/console/consolePrompt.css +1 -1
  173. package/front_end/panels/console/consoleView.css +1 -1
  174. package/front_end/panels/console_counters/WarningErrorCounter.ts +3 -4
  175. package/front_end/panels/coverage/CoverageListView.ts +2 -2
  176. package/front_end/panels/coverage/CoverageView.ts +20 -5
  177. package/front_end/panels/css_overview/CSSOverviewCompletedView.ts +4 -3
  178. package/front_end/panels/css_overview/CSSOverviewPanel.ts +2 -2
  179. package/front_end/panels/css_overview/CSSOverviewProcessingView.ts +2 -2
  180. package/front_end/panels/css_overview/CSSOverviewSidebarPanel.ts +2 -2
  181. package/front_end/panels/css_overview/CSSOverviewStartView.ts +2 -2
  182. package/front_end/panels/css_overview/CSSOverviewUnusedDeclarations.ts +8 -8
  183. package/front_end/panels/developer_resources/DeveloperResourcesListView.ts +2 -3
  184. package/front_end/panels/developer_resources/DeveloperResourcesView.ts +4 -5
  185. package/front_end/panels/elements/AccessibilityTreeUtils.ts +6 -7
  186. package/front_end/panels/elements/CSSValueTraceView.ts +3 -3
  187. package/front_end/panels/elements/ClassesPaneWidget.ts +1 -2
  188. package/front_end/panels/elements/ComputedStyleWidget.ts +15 -14
  189. package/front_end/panels/elements/DOMTreeElementWidget.ts +5 -4
  190. package/front_end/panels/elements/DOMTreeWidget.ts +2 -1
  191. package/front_end/panels/elements/ElementStatePaneWidget.ts +2 -2
  192. package/front_end/panels/elements/ElementsPanel.ts +1 -0
  193. package/front_end/panels/elements/EventListenersWidget.ts +2 -2
  194. package/front_end/panels/elements/LayoutPane.ts +2 -2
  195. package/front_end/panels/elements/PlatformFontsWidget.ts +3 -3
  196. package/front_end/panels/elements/PropertiesWidget.ts +9 -10
  197. package/front_end/panels/elements/PropertyRenderer.ts +72 -11
  198. package/front_end/panels/elements/StandaloneStylesContainer.ts +5 -10
  199. package/front_end/panels/elements/StyleEditorWidget.ts +30 -16
  200. package/front_end/panels/elements/StylePropertiesSection.ts +93 -44
  201. package/front_end/panels/elements/StylePropertyTreeElement.ts +230 -302
  202. package/front_end/panels/elements/StylesContainer.ts +2 -3
  203. package/front_end/panels/elements/StylesSidebarPane.ts +4 -13
  204. package/front_end/panels/elements/components/AccessibilityTreeNode.ts +66 -37
  205. package/front_end/panels/elements/components/CSSHintDetailsView.ts +51 -41
  206. package/front_end/panels/elements/components/CSSPropertyDocsView.ts +75 -65
  207. package/front_end/panels/elements/components/CSSQuery.ts +112 -74
  208. package/front_end/panels/elements/components/CSSVariableValueView.ts +109 -68
  209. package/front_end/panels/elements/components/ComputedStyleProperty.ts +64 -45
  210. package/front_end/panels/elements/components/ElementsTreeExpandButton.ts +35 -28
  211. package/front_end/panels/elements/components/QueryContainer.ts +104 -74
  212. package/front_end/panels/elements/components/accessibilityTreeNode.css +22 -20
  213. package/front_end/panels/elements/components/computedStyleProperty.css +2 -0
  214. package/front_end/panels/elements/components/cssHintDetailsView.css +23 -21
  215. package/front_end/panels/elements/components/cssPropertyDocsView.css +38 -36
  216. package/front_end/panels/elements/components/cssVariableValueView.css +42 -40
  217. package/front_end/panels/elements/components/elementsTreeExpandButton.css +5 -2
  218. package/front_end/panels/elements/components/queryContainer.css +23 -21
  219. package/front_end/panels/elements/stylesSidebarPane.css +3 -3
  220. package/front_end/panels/emulation/DeviceModeToolbar.ts +2 -2
  221. package/front_end/panels/emulation/InspectedPagePlaceholder.ts +2 -2
  222. package/front_end/panels/emulation/MediaQueryInspector.ts +9 -10
  223. package/front_end/panels/emulation/mediaQueryInspector.css +1 -1
  224. package/front_end/panels/event_listeners/EventListenersView.ts +2 -2
  225. package/front_end/panels/issues/AffectedCookiesView.ts +144 -101
  226. package/front_end/panels/issues/AffectedDescendantsWithinSelectElementView.ts +83 -31
  227. package/front_end/panels/issues/AffectedDirectivesView.ts +218 -135
  228. package/front_end/panels/issues/AffectedDocumentsInQuirksModeView.ts +84 -34
  229. package/front_end/panels/issues/AffectedElementsView.ts +86 -23
  230. package/front_end/panels/issues/AffectedLazyLoadImagesView.ts +2 -2
  231. package/front_end/panels/issues/AffectedMetadataAllowedSitesView.ts +2 -2
  232. package/front_end/panels/issues/AffectedPartitioningBlobURLView.ts +36 -11
  233. package/front_end/panels/issues/AffectedSharedArrayBufferIssueDetailsView.ts +135 -58
  234. package/front_end/panels/issues/AffectedSourcesView.ts +49 -28
  235. package/front_end/panels/issues/AffectedTrackingSitesView.ts +3 -4
  236. package/front_end/panels/issues/CorsIssueDetailsView.ts +490 -269
  237. package/front_end/panels/issues/GenericIssueDetailsView.ts +2 -2
  238. package/front_end/panels/issues/IssueKindView.ts +63 -48
  239. package/front_end/panels/issues/IssueView.ts +14 -18
  240. package/front_end/panels/issues/components/ElementsPanelLink.ts +70 -34
  241. package/front_end/panels/issues/components/HideIssuesMenu.ts +56 -32
  242. package/front_end/panels/issues/components/elementsPanelLink.css +10 -6
  243. package/front_end/panels/issues/components/hideIssuesMenu.css +16 -14
  244. package/front_end/panels/issues/issues.ts +2 -0
  245. package/front_end/panels/issues/issuesTree.css +4 -4
  246. package/front_end/panels/lighthouse/LighthouseController.ts +6 -6
  247. package/front_end/panels/lighthouse/LighthouseStatusView.ts +12 -13
  248. package/front_end/panels/lighthouse/lighthouseStartView.css +1 -1
  249. package/front_end/panels/linear_memory_inspector/LinearMemoryInspectorPane.ts +159 -161
  250. package/front_end/panels/linear_memory_inspector/LinearMemoryInspectorView.ts +228 -0
  251. package/front_end/panels/linear_memory_inspector/components/LinearMemoryInspector.ts +32 -41
  252. package/front_end/panels/linear_memory_inspector/components/linearMemoryHighlightChipList.css +2 -2
  253. package/front_end/panels/linear_memory_inspector/linear_memory_inspector.ts +2 -0
  254. package/front_end/panels/media/EventDisplayTable.ts +2 -2
  255. package/front_end/panels/media/MainView.ts +132 -66
  256. package/front_end/panels/media/PlayerDetailView.ts +32 -14
  257. package/front_end/panels/media/PlayerListView.ts +83 -23
  258. package/front_end/panels/media/PlayerPropertiesView.ts +2 -2
  259. package/front_end/panels/media/TickingFlameChart.ts +153 -63
  260. package/front_end/panels/mobile_throttling/NetworkThrottlingSelector.ts +2 -2
  261. package/front_end/panels/mobile_throttling/ThrottlingSettingsTab.ts +615 -464
  262. package/front_end/panels/mobile_throttling/throttlingSettingsTab.css +43 -0
  263. package/front_end/panels/network/EventSourceMessagesView.ts +3 -3
  264. package/front_end/panels/network/NetworkConfigView.ts +6 -2
  265. package/front_end/panels/network/NetworkDataGridNode.ts +2 -1
  266. package/front_end/panels/network/NetworkItemView.ts +27 -26
  267. package/front_end/panels/network/NetworkManageCustomHeadersView.ts +236 -97
  268. package/front_end/panels/network/NetworkOverview.ts +8 -10
  269. package/front_end/panels/network/RequestConditionsDrawer.ts +8 -4
  270. package/front_end/panels/network/RequestDeviceBoundSessionsView.ts +2 -4
  271. package/front_end/panels/network/RequestHTMLView.ts +26 -7
  272. package/front_end/panels/network/RequestHeadersView.ts +2 -2
  273. package/front_end/panels/network/RequestInitiatorView.ts +21 -22
  274. package/front_end/panels/network/RequestPayloadView.ts +2 -16
  275. package/front_end/panels/network/RequestPreviewView.ts +5 -5
  276. package/front_end/panels/network/RequestTimingView.ts +6 -6
  277. package/front_end/panels/network/ResourceDirectSocketChunkView.ts +5 -6
  278. package/front_end/panels/network/ResourceWebSocketFrameView.ts +4 -3
  279. package/front_end/panels/network/ShowMoreDetailsWidget.ts +11 -12
  280. package/front_end/panels/network/SignedExchangeInfoView.ts +2 -2
  281. package/front_end/panels/network/networkLogView.css +2 -2
  282. package/front_end/panels/network/networkManageCustomHeadersView.css +27 -6
  283. package/front_end/panels/network/requestConditionsDrawer.css +1 -1
  284. package/front_end/panels/network/requestInitiatorView.css +5 -3
  285. package/front_end/panels/performance_monitor/PerformanceMonitor.ts +2 -2
  286. package/front_end/panels/profiler/HeapDetachedElementsView.ts +1 -2
  287. package/front_end/panels/profiler/HeapTimelineOverview.ts +77 -15
  288. package/front_end/panels/profiler/IsolateSelector.ts +258 -187
  289. package/front_end/panels/profiler/ProfileLauncherView.ts +7 -29
  290. package/front_end/panels/profiler/profileLauncherView.css +6 -1
  291. package/front_end/panels/protocol_monitor/JSONEditor.ts +4 -5
  292. package/front_end/panels/recorder/ControlButton.ts +1 -1
  293. package/front_end/panels/recorder/RecordingListView.ts +2 -4
  294. package/front_end/panels/recorder/RecordingView.ts +1 -2
  295. package/front_end/panels/recorder/SelectorPicker.ts +2 -4
  296. package/front_end/panels/recorder/StepView.ts +24 -10
  297. package/front_end/panels/recorder/TimelineSection.ts +1 -1
  298. package/front_end/panels/recorder/recordingView.css +1 -1
  299. package/front_end/panels/screencast/ScreencastApp.ts +1 -1
  300. package/front_end/panels/search/SearchResultsPane.ts +11 -12
  301. package/front_end/panels/search/SearchView.ts +8 -10
  302. package/front_end/panels/security/SecurityPanel.ts +1 -8
  303. package/front_end/panels/security/SecurityPanelSidebar.ts +2 -2
  304. package/front_end/panels/security/mainView.css +1 -1
  305. package/front_end/panels/sensors/LocationsSettingsTab.ts +1 -2
  306. package/front_end/panels/settings/AISettingsTab.ts +1 -1
  307. package/front_end/panels/settings/BackendLinkingSettingsTab.ts +34 -20
  308. package/front_end/panels/settings/EditFileSystemView.ts +2 -2
  309. package/front_end/panels/settings/FrameworkIgnoreListSettingsTab.ts +375 -197
  310. package/front_end/panels/settings/KeybindsSettingsTab.ts +570 -414
  311. package/front_end/panels/settings/SettingsScreen.ts +312 -114
  312. package/front_end/panels/settings/WorkspaceSettingsTab.ts +2 -2
  313. package/front_end/panels/settings/aiSettingsTab.css +1 -4
  314. package/front_end/panels/settings/emulation/DevicesSettingsTab.ts +924 -578
  315. package/front_end/panels/settings/emulation/components/UserAgentClientHintsForm.ts +9 -2
  316. package/front_end/panels/settings/emulation/devicesSettingsTab.css +39 -0
  317. package/front_end/panels/settings/frameworkIgnoreListSettingsTab.css +37 -8
  318. package/front_end/panels/settings/settingsScreen.css +0 -24
  319. package/front_end/panels/sources/BreakpointEditDialog.ts +9 -6
  320. package/front_end/panels/sources/BreakpointsView.ts +25 -4
  321. package/front_end/panels/sources/CallStackSidebarPane.ts +7 -1
  322. package/front_end/panels/sources/DebuggerPlugin.ts +1 -0
  323. package/front_end/panels/sources/GoToLineQuickOpen.ts +8 -8
  324. package/front_end/panels/sources/NavigatorView.ts +521 -439
  325. package/front_end/panels/sources/PersistenceActions.ts +11 -12
  326. package/front_end/panels/sources/ProfilePlugin.ts +28 -17
  327. package/front_end/panels/sources/ScopeChainSidebarPane.ts +3 -4
  328. package/front_end/panels/sources/SourcesNavigator.ts +9 -9
  329. package/front_end/panels/sources/SourcesPanel.ts +2 -2
  330. package/front_end/panels/sources/SourcesView.ts +3 -3
  331. package/front_end/panels/sources/ThreadsSidebarPane.ts +2 -2
  332. package/front_end/panels/sources/WatchExpressionsSidebarPane.ts +2 -2
  333. package/front_end/panels/sources/components/HeadersView.ts +1 -2
  334. package/front_end/panels/timeline/CompatibilityTracksAppender.ts +5 -6
  335. package/front_end/panels/timeline/EventsTimelineTreeView.ts +73 -34
  336. package/front_end/panels/timeline/IsolateSelector.ts +25 -37
  337. package/front_end/panels/timeline/StatusDialog.ts +5 -7
  338. package/front_end/panels/timeline/ThirdPartyTreeView.ts +10 -13
  339. package/front_end/panels/timeline/TimelineDetailsView.ts +40 -21
  340. package/front_end/panels/timeline/TimelineEventOverview.ts +130 -34
  341. package/front_end/panels/timeline/TimelineFlameChartNetworkDataProvider.ts +1 -1
  342. package/front_end/panels/timeline/TimelineMiniMap.ts +255 -103
  343. package/front_end/panels/timeline/TimelinePaintProfilerView.ts +19 -11
  344. package/front_end/panels/timeline/TimelinePanel.ts +1 -0
  345. package/front_end/panels/timeline/TimelineSelectorStatsView.ts +11 -12
  346. package/front_end/panels/timeline/TimelineTreeView.ts +240 -122
  347. package/front_end/panels/timeline/TimelineUIUtils.ts +12 -0
  348. package/front_end/panels/timeline/components/BreadcrumbsUI.ts +5 -4
  349. package/front_end/panels/timeline/components/DetailsView.ts +97 -65
  350. package/front_end/panels/timeline/components/LayoutShiftDetails.ts +2 -2
  351. package/front_end/panels/timeline/components/MetricCard.ts +2 -2
  352. package/front_end/panels/timeline/components/NetworkRequestDetails.ts +11 -12
  353. package/front_end/panels/timeline/components/NetworkTrackWidget.ts +57 -50
  354. package/front_end/panels/timeline/components/RelatedInsightChips.ts +2 -2
  355. package/front_end/panels/timeline/components/Sidebar.ts +161 -109
  356. package/front_end/panels/timeline/components/SidebarAnnotationsTab.ts +33 -12
  357. package/front_end/panels/timeline/components/SidebarInsightsTab.ts +3 -0
  358. package/front_end/panels/timeline/components/insights/LCPDiscovery.ts +11 -11
  359. package/front_end/panels/timeline/components/insights/SlowCSSSelector.ts +6 -7
  360. package/front_end/panels/timeline/components/networkTrackWidget.css +24 -22
  361. package/front_end/panels/timeline/components/sidebarInsightsTab.css +1 -1
  362. package/front_end/panels/timeline/overlays/components/TimespanBreakdownOverlay.ts +15 -10
  363. package/front_end/panels/timeline/overlays/components/entryLabelOverlay.css +1 -1
  364. package/front_end/panels/timeline/timelinePanel.css +5 -0
  365. package/front_end/panels/timeline/timelineStatusDialog.css +1 -1
  366. package/front_end/panels/web_audio/WebAudioView.ts +2 -2
  367. package/front_end/third_party/chromium/README.chromium +1 -1
  368. package/front_end/third_party/legacy-javascript/README.chromium +2 -2
  369. package/front_end/third_party/legacy-javascript/lib/legacy-javascript.js +2 -2
  370. package/front_end/third_party/legacy-javascript/package.json +1 -1
  371. package/front_end/third_party/lighthouse/README.chromium +2 -2
  372. package/front_end/third_party/lighthouse/lighthouse-dt-bundle.js +1983 -2022
  373. package/front_end/third_party/lighthouse/locales/ar-XB.json +157 -142
  374. package/front_end/third_party/lighthouse/locales/ar.json +157 -142
  375. package/front_end/third_party/lighthouse/locales/bg.json +154 -139
  376. package/front_end/third_party/lighthouse/locales/ca.json +157 -142
  377. package/front_end/third_party/lighthouse/locales/cs.json +148 -133
  378. package/front_end/third_party/lighthouse/locales/da.json +153 -138
  379. package/front_end/third_party/lighthouse/locales/de.json +152 -137
  380. package/front_end/third_party/lighthouse/locales/el.json +153 -138
  381. package/front_end/third_party/lighthouse/locales/en-GB.json +160 -145
  382. package/front_end/third_party/lighthouse/locales/en-US.json +239 -218
  383. package/front_end/third_party/lighthouse/locales/en-XL.json +239 -218
  384. package/front_end/third_party/lighthouse/locales/es-419.json +150 -135
  385. package/front_end/third_party/lighthouse/locales/es.json +149 -134
  386. package/front_end/third_party/lighthouse/locales/fi.json +151 -136
  387. package/front_end/third_party/lighthouse/locales/fil.json +154 -139
  388. package/front_end/third_party/lighthouse/locales/fr.json +150 -135
  389. package/front_end/third_party/lighthouse/locales/he.json +160 -145
  390. package/front_end/third_party/lighthouse/locales/hi.json +156 -141
  391. package/front_end/third_party/lighthouse/locales/hr.json +154 -139
  392. package/front_end/third_party/lighthouse/locales/hu.json +111 -96
  393. package/front_end/third_party/lighthouse/locales/id.json +153 -138
  394. package/front_end/third_party/lighthouse/locales/it.json +153 -138
  395. package/front_end/third_party/lighthouse/locales/ja.json +150 -135
  396. package/front_end/third_party/lighthouse/locales/ko.json +42 -27
  397. package/front_end/third_party/lighthouse/locales/lt.json +152 -137
  398. package/front_end/third_party/lighthouse/locales/lv.json +93 -78
  399. package/front_end/third_party/lighthouse/locales/nl.json +149 -134
  400. package/front_end/third_party/lighthouse/locales/no.json +152 -137
  401. package/front_end/third_party/lighthouse/locales/pl.json +153 -138
  402. package/front_end/third_party/lighthouse/locales/pt-PT.json +152 -137
  403. package/front_end/third_party/lighthouse/locales/pt.json +157 -142
  404. package/front_end/third_party/lighthouse/locales/ro.json +149 -134
  405. package/front_end/third_party/lighthouse/locales/ru.json +76 -61
  406. package/front_end/third_party/lighthouse/locales/sk.json +153 -138
  407. package/front_end/third_party/lighthouse/locales/sl.json +149 -134
  408. package/front_end/third_party/lighthouse/locales/sr-Latn.json +151 -136
  409. package/front_end/third_party/lighthouse/locales/sr.json +151 -136
  410. package/front_end/third_party/lighthouse/locales/sv.json +152 -137
  411. package/front_end/third_party/lighthouse/locales/ta.json +156 -141
  412. package/front_end/third_party/lighthouse/locales/te.json +157 -142
  413. package/front_end/third_party/lighthouse/locales/th.json +111 -96
  414. package/front_end/third_party/lighthouse/locales/tr.json +153 -138
  415. package/front_end/third_party/lighthouse/locales/uk.json +149 -134
  416. package/front_end/third_party/lighthouse/locales/vi.json +162 -147
  417. package/front_end/third_party/lighthouse/locales/zh-HK.json +150 -135
  418. package/front_end/third_party/lighthouse/locales/zh-TW.json +154 -139
  419. package/front_end/third_party/lighthouse/locales/zh.json +152 -137
  420. package/front_end/third_party/lighthouse/report/bundle.d.ts +9 -8
  421. package/front_end/third_party/lighthouse/report/bundle.js +10 -10
  422. package/front_end/third_party/lighthouse/report-assets/report-generator.mjs +2 -7
  423. package/front_end/tsconfig.compatibility.json +1 -0
  424. package/front_end/tsconfig.json +3 -2
  425. package/front_end/ui/components/dialogs/TypeToAllowDialog.ts +0 -2
  426. package/front_end/ui/components/dialogs/typeToAllowDialog.css +0 -4
  427. package/front_end/ui/components/icon_button/fileSourceIcon.css +1 -1
  428. package/front_end/ui/components/input/textInput.css +1 -1
  429. package/front_end/ui/components/lists/List.ts +26 -14
  430. package/front_end/ui/components/menus/menus.ts +0 -2
  431. package/front_end/ui/components/suggestion_input/SuggestionInput.ts +351 -138
  432. package/front_end/ui/components/survey_link/surveyLink.css +3 -3
  433. package/front_end/ui/components/switch/switch.css +6 -6
  434. package/front_end/ui/components/text_editor/AiCodeCompletionTeaser.ts +2 -3
  435. package/front_end/ui/components/text_editor/TextEditor.ts +1 -1
  436. package/front_end/ui/components/tooltips/Tooltip.ts +53 -4
  437. package/front_end/ui/components/tree_outline/treeOutline.css +7 -7
  438. package/front_end/ui/helpers/OpenInNewTab.ts +8 -3
  439. package/front_end/ui/legacy/EmptyWidget.ts +4 -4
  440. package/front_end/ui/legacy/ForwardedInputEventHandler.ts +2 -2
  441. package/front_end/ui/legacy/GlassPane.ts +1 -1
  442. package/front_end/ui/legacy/KeyboardShortcut.ts +7 -7
  443. package/front_end/ui/legacy/RemoteDebuggingTerminatedScreen.ts +2 -2
  444. package/front_end/ui/legacy/TabbedPane.ts +198 -66
  445. package/front_end/ui/legacy/TargetCrashedScreen.ts +2 -2
  446. package/front_end/ui/legacy/UIUtils.ts +71 -68
  447. package/front_end/ui/legacy/View.ts +7 -4
  448. package/front_end/ui/legacy/ViewManager.ts +49 -37
  449. package/front_end/ui/legacy/Widget.ts +32 -12
  450. package/front_end/ui/legacy/components/cookie_table/CookiesTable.ts +2 -3
  451. package/front_end/ui/legacy/components/inline_editor/AnimationTimingUI.ts +8 -8
  452. package/front_end/ui/legacy/components/inline_editor/BezierUI.ts +8 -9
  453. package/front_end/ui/legacy/components/inline_editor/LinkSwatch.ts +2 -2
  454. package/front_end/ui/legacy/components/inline_editor/cssAngleEditor.css +1 -1
  455. package/front_end/ui/legacy/components/inline_editor/cssAngleSwatch.css +1 -1
  456. package/front_end/ui/legacy/components/object_ui/ObjectPropertiesSection.ts +45 -11
  457. package/front_end/ui/legacy/components/object_ui/RemoteObjectPreviewFormatter.ts +10 -12
  458. package/front_end/ui/legacy/components/perf_ui/ChartViewport.ts +102 -29
  459. package/front_end/ui/legacy/components/perf_ui/FlameChart.ts +148 -122
  460. package/front_end/ui/legacy/components/perf_ui/TimelineOverviewPane.ts +20 -14
  461. package/front_end/ui/legacy/components/quick_open/filteredListWidget.css +1 -1
  462. package/front_end/ui/legacy/components/source_frame/FontView.ts +29 -5
  463. package/front_end/ui/legacy/components/source_frame/ImageView.ts +79 -12
  464. package/front_end/ui/legacy/components/source_frame/JSONView.ts +20 -2
  465. package/front_end/ui/legacy/components/source_frame/PreviewFactory.ts +2 -2
  466. package/front_end/ui/legacy/components/source_frame/StreamingContentHexView.ts +6 -10
  467. package/front_end/ui/legacy/components/source_frame/XMLView.ts +11 -11
  468. package/front_end/ui/legacy/components/source_frame/fontView.css +7 -0
  469. package/front_end/ui/legacy/components/source_frame/imageView.css +7 -0
  470. package/front_end/ui/legacy/components/utils/JSPresentationUtils.ts +14 -3
  471. package/front_end/ui/legacy/components/utils/Linkifier.ts +126 -2
  472. package/front_end/ui/legacy/emptyWidget.css +2 -1
  473. package/front_end/ui/legacy/inspectorCommon.css +3 -3
  474. package/front_end/ui/legacy/smallBubble.css +1 -1
  475. package/front_end/ui/legacy/tabbedPane.css +6 -0
  476. package/front_end/ui/lit/Directives.ts +35 -18
  477. package/front_end/ui/lit/lit.ts +0 -2
  478. package/front_end/ui/lit/render.ts +0 -7
  479. package/front_end/ui/visual_logging/KnownContextValues.ts +5 -0
  480. package/package.json +1 -1
  481. package/vpython.toml +8 -0
  482. package/vpython.toml.uv.lock +3 -0
  483. package/.agents/skills/review-models-core/SKILL.md +0 -73
  484. package/.agents/skills/review-tests/SKILL.md +0 -67
  485. package/.agents/skills/review-ui-widgets/SKILL.md +0 -115
  486. package/front_end/generated/ARIAProperties.ts +0 -2686
  487. package/front_end/ui/components/menus/README.md +0 -119
  488. package/front_end/ui/components/menus/SelectMenu.ts +0 -473
  489. package/front_end/ui/components/menus/selectMenu.css +0 -54
  490. package/front_end/ui/components/menus/selectMenuButton.css +0 -108
@@ -6,6 +6,11 @@ import type * as LHModel from '../../lighthouse/lighthouse.js';
6
6
 
7
7
  import {bytes, millis} from './UnitFormatters.js';
8
8
 
9
+ // Mirrors `Util.PASS_THRESHOLD` in `front_end/third_party/lighthouse/report/bundle.js`
10
+ // (defined in Lighthouse's `report/renderer/util.js`). The pre-built report bundle does
11
+ // not export `Util`, so this threshold is defined locally.
12
+ const PASS_THRESHOLD = 0.9;
13
+
9
14
  /**
10
15
  * Category argument for Lighthouse tools, accepting a specific category ID or `'all'`
11
16
  * to target a full report across all standard categories.
@@ -26,15 +31,80 @@ export class LighthouseFormatter {
26
31
  lines.push(`URL: ${report.finalDisplayedUrl}`);
27
32
  lines.push(`Fetch Time: ${report.fetchTime}`);
28
33
  lines.push(`Lighthouse Version: ${report.lighthouseVersion}`);
34
+ if (report.gatherMode) {
35
+ lines.push(`Mode: ${report.gatherMode}`);
36
+ }
29
37
  lines.push('');
30
38
  lines.push('## Category Scores');
31
39
  for (const category of Object.values(report.categories)) {
32
- const score = category.score !== null ? Math.round(category.score * 100) : 'n/a';
33
- lines.push(`- ${category.title}: ${score}`);
40
+ lines.push(`- ${category.title}: ${this.#formatCategoryScore(report, category)}`);
34
41
  }
35
42
  return lines.join('\n');
36
43
  }
37
44
 
45
+ #formatCategoryScore(report: LHModel.ReporterTypes.ReportJSON, category: LHModel.ReporterTypes.CategoryJSON): string
46
+ |number {
47
+ if (this.#shouldDisplayAsFraction(report, category)) {
48
+ const {numPassed, numPassableAudits} = this.#calculateCategoryFraction(report, category);
49
+ return `${numPassed}/${numPassableAudits} audits passed`;
50
+ }
51
+ return category.score !== null ? Math.round(category.score * 100) : 'n/a';
52
+ }
53
+
54
+ /**
55
+ * Mirrors `Util.shouldDisplayAsFraction` in the Lighthouse report renderer (`bundle.js`).
56
+ */
57
+ #shouldDisplayAsFraction(report: LHModel.ReporterTypes.ReportJSON,
58
+ category: LHModel.ReporterTypes.CategoryJSON): boolean {
59
+ return report.gatherMode === 'timespan' || report.gatherMode === 'snapshot' ||
60
+ category.categoryScoreDisplayMode === 'fraction';
61
+ }
62
+
63
+ /**
64
+ * Mirrors `Util.calculateCategoryFraction` in the Lighthouse report renderer (`bundle.js`).
65
+ */
66
+ #calculateCategoryFraction(report: LHModel.ReporterTypes.ReportJSON, category: LHModel.ReporterTypes.CategoryJSON): {
67
+ numPassed: number,
68
+ numPassableAudits: number,
69
+ } {
70
+ let numPassableAudits = 0;
71
+ let numPassed = 0;
72
+ for (const ref of category.auditRefs) {
73
+ const audit = report.audits[ref.id];
74
+ if (!audit) {
75
+ continue;
76
+ }
77
+ const auditPassed = this.#showAsPassed(audit);
78
+ if (ref.group === 'hidden' || audit.scoreDisplayMode === 'manual' || audit.scoreDisplayMode === 'notApplicable' ||
79
+ audit.scoreDisplayMode === 'informative') {
80
+ continue;
81
+ }
82
+ numPassableAudits += 1;
83
+ if (auditPassed) {
84
+ numPassed += 1;
85
+ }
86
+ }
87
+ return {numPassed, numPassableAudits};
88
+ }
89
+
90
+ /**
91
+ * Mirrors `Util.showAsPassed` in the Lighthouse report renderer (`bundle.js`).
92
+ */
93
+ #showAsPassed(audit: LHModel.ReporterTypes.AuditResultJSON): boolean {
94
+ switch (audit.scoreDisplayMode) {
95
+ case 'manual':
96
+ case 'notApplicable':
97
+ return true;
98
+ case 'error':
99
+ case 'informative':
100
+ return false;
101
+ case 'numeric':
102
+ case 'binary':
103
+ default:
104
+ return Number(audit.score) >= PASS_THRESHOLD;
105
+ }
106
+ }
107
+
38
108
  /**
39
109
  * Returns the title and score of every failing audit (score < 90), grouped by category.
40
110
  * Descriptions and details tables are left out to keep the prompt small. Each category
@@ -47,13 +117,18 @@ export class LighthouseFormatter {
47
117
  lines.push('');
48
118
  lines.push(`### ${category.title} (categoryId: "${categoryId}")`);
49
119
  const failingAudits = this.#findFailingAudits(report, category);
50
- if (failingAudits.length === 0) {
120
+ const erroredAudits = this.#findErroredAudits(report, category);
121
+ if (failingAudits.length === 0 && erroredAudits.length === 0) {
51
122
  lines.push('- No failing audits.');
52
123
  continue;
53
124
  }
54
125
  for (const audit of failingAudits) {
55
126
  lines.push(`- ${audit.title}: ${this.#formatScore(audit.score)}`);
56
127
  }
128
+ for (const audit of erroredAudits) {
129
+ const errorSuffix = audit.errorMessage ? ` (${this.#toSingleLine(audit.errorMessage)})` : '';
130
+ lines.push(`- ${audit.title}: Error${errorSuffix}`);
131
+ }
57
132
  }
58
133
  return lines.join('\n');
59
134
  }
@@ -85,47 +160,92 @@ export class LighthouseFormatter {
85
160
  const lines: string[] = [];
86
161
  lines.push(`# Audits for ${category.title}`);
87
162
  if (category.description) {
88
- lines.push(`${category.description.replace(/\n/g, ' ')}`);
163
+ lines.push(this.#toSingleLine(category.description));
89
164
  }
90
165
  lines.push('');
91
166
 
92
167
  const failingAudits = this.#findFailingAudits(report, category);
168
+ const erroredAudits = this.#findErroredAudits(report, category);
93
169
 
94
- if (failingAudits.length === 0) {
170
+ if (failingAudits.length === 0 && erroredAudits.length === 0) {
95
171
  lines.push('All audits in this category passed (score >= 90).');
96
172
  return lines.join('\n');
97
173
  }
98
174
 
99
- lines.push('The following audits in this category have a score below 90 and may need attention:');
100
- for (const audit of failingAudits) {
101
- let line = `- **${audit.title}**: ${this.#formatScore(audit.score)}`;
102
- if (audit.displayValue) {
103
- line += ` (${audit.displayValue})`;
175
+ const sections: string[] = [];
176
+
177
+ if (failingAudits.length > 0) {
178
+ const sectionLines = ['The following audits in this category have a score below 90 and may need attention:'];
179
+ for (const audit of failingAudits) {
180
+ sectionLines.push(...this.#formatAudit(audit, this.#formatScore(audit.score)));
104
181
  }
105
- lines.push(line);
106
- lines.push(` * ${audit.description.replace(/\n/g, ' ')}`);
107
- if (audit.details) {
108
- const formattedDetails = this.#formatDetails(audit.details);
109
- if (formattedDetails) {
110
- lines.push('');
111
- lines.push(formattedDetails.split('\n').map(l => ` ${l}`).join('\n'));
112
- }
182
+ sections.push(sectionLines.join('\n'));
183
+ }
184
+
185
+ if (erroredAudits.length > 0) {
186
+ const sectionLines = ['The following audits in this category errored:'];
187
+ for (const audit of erroredAudits) {
188
+ sectionLines.push(...this.#formatAudit(audit, 'Error'));
113
189
  }
190
+ sections.push(sectionLines.join('\n'));
114
191
  }
115
192
 
193
+ lines.push(sections.join('\n\n'));
116
194
  return lines.join('\n');
117
195
  }
118
196
 
197
+ #formatAudit(audit: LHModel.ReporterTypes.AuditResultJSON, score: string|number): string[] {
198
+ const lines: string[] = [];
199
+ let line = `- **${audit.title}**: ${score}`;
200
+ if (audit.displayValue) {
201
+ line += ` (${audit.displayValue})`;
202
+ }
203
+ lines.push(line);
204
+ lines.push(` * ${this.#toSingleLine(audit.description)}`);
205
+ if (audit.scoreDisplayMode === 'error' && audit.errorMessage) {
206
+ lines.push(` * Error: ${this.#toSingleLine(audit.errorMessage)}`);
207
+ }
208
+ if (audit.explanation) {
209
+ lines.push(` * Explanation: ${this.#joinExplanationLines(audit.explanation)}`);
210
+ }
211
+ if (audit.warnings) {
212
+ for (const warning of audit.warnings) {
213
+ lines.push(` * Warning: ${this.#toSingleLine(warning)}`);
214
+ }
215
+ }
216
+ if (audit.details) {
217
+ const formattedDetails = this.#formatDetails(audit.details);
218
+ if (formattedDetails) {
219
+ lines.push('');
220
+ lines.push(formattedDetails.split('\n').map(l => l ? ` ${l}` : '').join('\n'));
221
+ }
222
+ }
223
+ return lines;
224
+ }
225
+
119
226
  /**
120
- * Returns the audits in a category that scored below 90, in the category's order.
227
+ * Returns the non-hidden audits in a category that scored below 90, in the category's order.
121
228
  * Audits without a score (such as informative or manual audits) cannot fail, so they
122
229
  * are excluded.
123
230
  */
124
231
  #findFailingAudits(report: LHModel.ReporterTypes.ReportJSON, category: LHModel.ReporterTypes.CategoryJSON):
125
232
  Array<LHModel.ReporterTypes.AuditResultJSON&{score: number}> {
126
- return category.auditRefs.map(ref => report.audits[ref.id])
127
- .filter((audit): audit is LHModel.ReporterTypes.AuditResultJSON&{score: number} =>
128
- Boolean(audit) && audit.score !== null && audit.score < 0.9);
233
+ return category.auditRefs.filter(ref => ref.group !== 'hidden')
234
+ .map(ref => report.audits[ref.id])
235
+ .filter((audit): audit is LHModel.ReporterTypes.AuditResultJSON&{score: number} => Boolean(audit) &&
236
+ audit.scoreDisplayMode !== 'error' && audit.score !== null && audit.score < PASS_THRESHOLD);
237
+ }
238
+
239
+ /**
240
+ * Returns the non-hidden audits in a category that failed with an execution error
241
+ * (`scoreDisplayMode === 'error'`), in the category's order.
242
+ */
243
+ #findErroredAudits(report: LHModel.ReporterTypes.ReportJSON,
244
+ category: LHModel.ReporterTypes.CategoryJSON): LHModel.ReporterTypes.AuditResultJSON[] {
245
+ return category.auditRefs.filter(ref => ref.group !== 'hidden')
246
+ .map(ref => report.audits[ref.id])
247
+ .filter((audit): audit is LHModel.ReporterTypes.AuditResultJSON =>
248
+ Boolean(audit) && audit.scoreDisplayMode === 'error');
129
249
  }
130
250
 
131
251
  #formatScore(score: number): number {
@@ -168,11 +288,106 @@ export class LighthouseFormatter {
168
288
  lines.push(this.#formatTable(details.headings, details.items));
169
289
  return lines.join('\n');
170
290
  }
291
+ case 'list':
292
+ return this.#formatList(details);
293
+ case 'checklist':
294
+ return Object.values(details.items)
295
+ .map(item => `- ${this.#toSingleLine(item.label)}: ${item.value ? 'Passed' : 'Failed'}`)
296
+ .join('\n');
297
+ case 'network-tree':
298
+ return this.#formatNetworkTree(details);
171
299
  default:
172
300
  return '';
173
301
  }
174
302
  }
175
303
 
304
+ #formatNetworkTree(details: LHModel.ReporterTypes.NetworkTreeDetailsJSON): string {
305
+ if (Object.keys(details.chains).length === 0) {
306
+ return '';
307
+ }
308
+ const lines = [`Maximum critical path latency: ${millis(details.longestChain.duration)}`];
309
+ lines.push(...this.#formatNetworkTreeNodes(details.chains, 0));
310
+ return lines.join('\n');
311
+ }
312
+
313
+ #formatNetworkTreeNodes(nodes: Record<string, LHModel.ReporterTypes.NetworkTreeNodeJSON>, depth: number): string[] {
314
+ const lines: string[] = [];
315
+ const indent = ' '.repeat(depth);
316
+ for (const node of Object.values(nodes)) {
317
+ const longestSuffix = node.isLongest ? ' (longest chain)' : '';
318
+ lines.push(
319
+ `${indent}- ${node.url} (${millis(node.navStartToEndTime)}, ${bytes(node.transferSize)})${longestSuffix}`);
320
+ if (node.children) {
321
+ lines.push(...this.#formatNetworkTreeNodes(node.children, depth + 1));
322
+ }
323
+ }
324
+ return lines;
325
+ }
326
+
327
+ #formatList(details: LHModel.ReporterTypes.ListDetailsJSON): string {
328
+ const itemStrings: string[] = [];
329
+ for (const item of details.items) {
330
+ if (item.type === 'list-section') {
331
+ const sectionLines: string[] = [];
332
+ if (item.title) {
333
+ sectionLines.push(`**${this.#toSingleLine(item.title)}**`);
334
+ }
335
+ if (item.description) {
336
+ sectionLines.push(this.#toSingleLine(item.description));
337
+ }
338
+ const formattedValue = this.#formatListValue(item.value);
339
+ if (formattedValue) {
340
+ sectionLines.push(formattedValue);
341
+ }
342
+ if (sectionLines.length > 0) {
343
+ itemStrings.push(sectionLines.join('\n'));
344
+ }
345
+ } else {
346
+ const formattedItem = this.#formatListValue(item);
347
+ if (formattedItem) {
348
+ itemStrings.push(formattedItem);
349
+ }
350
+ }
351
+ }
352
+ return itemStrings.join('\n\n');
353
+ }
354
+
355
+ #formatListValue(value: LHModel.ReporterTypes.ListItemValueJSON): string {
356
+ switch (value.type) {
357
+ case 'node':
358
+ return this.#formatNodeFields(value)
359
+ .map(({labelSuffix, value: v}) => {
360
+ const label = labelSuffix ? `Element ${labelSuffix}` : 'Element';
361
+ return `- **${label}**: ${this.#toSingleLine(v)}`;
362
+ })
363
+ .join('\n');
364
+ case 'text':
365
+ case 'url':
366
+ return this.#toSingleLine(value.value);
367
+ default:
368
+ return this.#formatDetails(value);
369
+ }
370
+ }
371
+
372
+ #formatNodeFields(value: LHModel.ReporterTypes.NodeDetailsJSON): Array<{
373
+ value: string,
374
+ labelSuffix?: string,
375
+ }> {
376
+ const results = [];
377
+ const label = value.nodeLabel || value.selector || value.snippet || '(node)';
378
+ results.push({value: label});
379
+ if (value.selector && value.selector !== label) {
380
+ results.push({labelSuffix: 'selector', value: value.selector});
381
+ }
382
+ if (value.path) {
383
+ results.push({labelSuffix: 'path', value: value.path});
384
+ }
385
+ if (value.explanation) {
386
+ results.push({labelSuffix: 'explanation', value: this.#joinExplanationLines(value.explanation)});
387
+ }
388
+ return results;
389
+ }
390
+
176
391
  #formatTable(headings: LHModel.ReporterTypes.TableHeadingJSON[], items: LHModel.ReporterTypes.TableItem[]): string {
177
392
  const lines: string[] = [];
178
393
 
@@ -184,7 +399,7 @@ export class LighthouseFormatter {
184
399
  for (const {labelSuffix, value: v} of formattedValues) {
185
400
  const baseLabel = heading.label || heading.key;
186
401
  const label = labelSuffix ? `${baseLabel} ${labelSuffix}` : baseLabel;
187
- itemLines.push(` * **${label}**: ${v}`);
402
+ itemLines.push(` * **${label}**: ${this.#toSingleLine(v)}`);
188
403
  }
189
404
  const subItems = item.subItems;
190
405
  // subItems can technically be a string (TableItemValue), but we
@@ -202,7 +417,7 @@ export class LighthouseFormatter {
202
417
  }
203
418
  const formattedSubValues = this.#formatTableValues(subValue, heading.subItemsHeading.valueType);
204
419
  for (const {value: v} of formattedSubValues) {
205
- itemLines.push(` * ${v}`);
420
+ itemLines.push(` * ${this.#toSingleLine(v)}`);
206
421
  }
207
422
  }
208
423
  }
@@ -227,30 +442,21 @@ export class LighthouseFormatter {
227
442
  }
228
443
  if (typeof value === 'object' && 'type' in value) {
229
444
  switch (value.type) {
230
- case 'node': {
231
- const results = [];
232
- const label = value.nodeLabel || value.selector || value.snippet || '(node)';
233
- results.push({value: label});
234
- if (value.selector && value.selector !== label) {
235
- results.push({labelSuffix: 'selector', value: value.selector});
236
- }
237
- if (value.path) {
238
- results.push({labelSuffix: 'path', value: value.path});
239
- }
240
- if (value.explanation) {
241
- results.push({labelSuffix: 'explanation', value: value.explanation.replace(/\n/g, ' ')});
242
- }
243
- return results;
244
- }
445
+ case 'node':
446
+ return this.#formatNodeFields(value);
447
+ case 'text':
448
+ case 'url':
449
+ return [{value: this.#formatValue(value.value, valueType)}];
245
450
  case 'source-location': {
246
451
  const parts = [];
247
452
  if (value.url) {
248
453
  parts.push(value.url);
249
454
  }
250
- if (value.line) {
251
- parts.push(String(value.line));
455
+ // SourceLocationDetailsJSON.line is 0-based; the Lighthouse report displays 1-based line numbers.
456
+ if (typeof value.line === 'number') {
457
+ parts.push(String(value.line + 1));
252
458
  }
253
- if (value.column) {
459
+ if (typeof value.column === 'number') {
254
460
  parts.push(String(value.column));
255
461
  }
256
462
  return [{value: parts.join(':')}];
@@ -260,6 +466,27 @@ export class LighthouseFormatter {
260
466
  return [];
261
467
  }
262
468
 
469
+ #toSingleLine(text: string): string {
470
+ return text.replace(/[^\S\n]*\n\s*/g, ' ');
471
+ }
472
+
473
+ /**
474
+ * Joins lines of an explanation onto a single line. Lines that follow a
475
+ * non-colon line are separated with "; " so that list items (such as axe's
476
+ * "Fix any of the following:\n Item 1\n Item 2") remain distinct.
477
+ */
478
+ #joinExplanationLines(text: string): string {
479
+ const lines = text.split('\n').map(l => l.trim()).filter(Boolean);
480
+ let result = '';
481
+ for (const line of lines) {
482
+ if (result) {
483
+ result += result.endsWith(':') ? ' ' : '; ';
484
+ }
485
+ result += line;
486
+ }
487
+ return result;
488
+ }
489
+
263
490
  #formatValue(value: string|number, valueType?: string): string {
264
491
  if (typeof value === 'string') {
265
492
  return value;
@@ -142,6 +142,7 @@ export class ExecuteJavaScriptTool implements
142
142
 
143
143
  * To return data, define a top-level \`data\` variable and populate it with data you want to get. Only JSON-serializable objects can be assigned to \`data\`.
144
144
  * $0 refers to the currently selected DOM node (or document body if none selected).
145
+ * **CRITICAL** Do not call \`console\` methods (e.g., \`console.log\`, \`console.warn\`, \`console.error\`) by default when returning data via \`data\`.
145
146
  * **CRITICAL** Never assume a selector for the elements unless you verified your knowledge.
146
147
  * **CRITICAL** Variables from previous function calls are not available in subsequent calls.
147
148
  * **CRITICAL** Keep code concise (max 40 lines, 120 characters per line, and 2,500 characters). Split complex logic into multiple steps.
@@ -174,11 +175,13 @@ const data = {
174
175
  title: string,
175
176
  thought: string,
176
177
  action: string,
178
+ javascriptCode: string,
177
179
  } {
178
180
  return {
179
181
  title: params.title,
180
182
  thought: params.explanation,
181
183
  action: params.code,
184
+ javascriptCode: params.code,
182
185
  };
183
186
  }
184
187
 
@@ -10,6 +10,7 @@ import {
10
10
  type DataHandlerResult,
11
11
  type DataTool,
12
12
  type LighthouseReportCapability,
13
+ MAX_FUNCTION_RESULT_BYTE_LENGTH,
13
14
  PermissionPrompt,
14
15
  type ToolArgs,
15
16
  ToolName,
@@ -55,6 +56,14 @@ export class GetLighthouseAuditsTool implements
55
56
  return {error: 'Error: Active context is not a Lighthouse report.'};
56
57
  }
57
58
  const audits = new LighthouseFormatter().formatReport(report, params.categoryId);
59
+ // Reject oversized "all" requests so the agent narrows its query to a single category.
60
+ // Single-category requests bypass this limit so the agent is not left without a narrower query to make.
61
+ if (params.categoryId === 'all' && audits.length > MAX_FUNCTION_RESULT_BYTE_LENGTH) {
62
+ return {
63
+ error:
64
+ 'The Lighthouse audits output for "all" is too large to fit in the context window. Request a single category instead.',
65
+ };
66
+ }
58
67
  return {
59
68
  result: {audits},
60
69
  };
@@ -28,6 +28,10 @@ export interface ResolveDevtoolsNodePathArgs extends ToolArgs {
28
28
  * representing the path from the root to the target element (e.g., "1,HTML,1,BODY").
29
29
  */
30
30
  path: string;
31
+ /**
32
+ * CSS selector or node label identifying the target element in the report.
33
+ */
34
+ selector?: string;
31
35
  explanation: string;
32
36
  }
33
37
 
@@ -60,8 +64,14 @@ export class ResolveDevtoolsNodePathTool implements DataTool<ResolveDevtoolsNode
60
64
  description: 'DevTools node path string (e.g. "1,HTML,1,BODY,2,DIV").',
61
65
  nullable: false,
62
66
  },
67
+ selector: {
68
+ type: Host.AidaClient.ParametersTypes.STRING,
69
+ description:
70
+ 'CSS selector or node label of the target element from the audit item (e.g. "button.submit", "body > p").',
71
+ nullable: false,
72
+ },
63
73
  },
64
- required: ['explanation', 'path'],
74
+ required: ['explanation', 'path', 'selector'],
65
75
  };
66
76
 
67
77
  displayInfoFromArgs(params: ResolveDevtoolsNodePathArgs): {
@@ -69,8 +79,9 @@ export class ResolveDevtoolsNodePathTool implements DataTool<ResolveDevtoolsNode
69
79
  thought: string,
70
80
  action: string,
71
81
  } {
82
+ const selector = params.selector?.trim().replace(/^body\s*>\s*/i, '');
72
83
  return {
73
- title: 'Resolving element path',
84
+ title: selector ? `Resolving element (${selector})` : 'Resolving element path',
74
85
  thought: params.explanation,
75
86
  action: `resolveDevtoolsNodePath('${params.path}')`,
76
87
  };
@@ -3,7 +3,7 @@
3
3
  // found in the LICENSE file.
4
4
 
5
5
  import * as Host from '../../../core/host/host.js';
6
- import type * as LHModel from '../../lighthouse/lighthouse.js';
6
+ import * as LHModel from '../../lighthouse/lighthouse.js';
7
7
  import {LighthouseContext} from '../contexts/LighthouseContext.js';
8
8
  import type {LighthouseCategoryArg} from '../data_formatters/LighthouseFormatter.js';
9
9
 
@@ -23,6 +23,12 @@ export interface RunLighthouseArgs extends ToolArgs {
23
23
  mode?: LHModel.RunTypes.RunMode;
24
24
  }
25
25
 
26
+ // Runtime fallback in case an LLM call omits the required `mode` argument.
27
+ // "agentic-browsing" defaults to "navigation" because its WebMCP gatherers only run during navigation.
28
+ function resolveMode(params: RunLighthouseArgs): LHModel.RunTypes.RunMode {
29
+ return params.mode ?? (params.categoryId === 'agentic-browsing' ? 'navigation' : 'snapshot');
30
+ }
31
+
26
32
  /**
27
33
  * Runs Lighthouse audits on the inspected page and sets the resulting report as the active conversation context.
28
34
  */
@@ -53,24 +59,34 @@ export class RunLighthouseTool implements
53
59
  mode: {
54
60
  type: Host.AidaClient.ParametersTypes.STRING,
55
61
  description:
56
- 'Lighthouse execution mode: "navigation", "snapshot", "timespan". Use "navigation" for initial full audits unless the user requested otherwise or in-page changes are being evaluated. Defaults to "snapshot".',
57
- nullable: true,
62
+ 'Lighthouse execution mode: "navigation", "snapshot", or "timespan". Use "navigation" to reload the page and run all audits (including page-load metrics and WebMCP gatherers); note that reloading resets unsaved in-page DOM or CSS modifications. Use "snapshot" to audit the current DOM state without reloading (preserving live edits, though navigation-only audits such as WebMCP are skipped). Use "timespan" to audit user interactions (supported only by "performance" and "best-practices").',
63
+ nullable: false,
58
64
  },
59
65
  },
60
- required: ['explanation', 'categoryId'],
66
+ required: ['explanation', 'categoryId', 'mode'],
61
67
  };
62
68
 
63
69
  displayInfoFromArgs(params: RunLighthouseArgs): {title: string, thought: string, action: string} {
70
+ const mode = resolveMode(params);
64
71
  return {
65
- title: `Running Lighthouse audits: ${params.categoryId} (${params.mode ?? 'snapshot'})`,
72
+ title: `Running Lighthouse audits: ${params.categoryId} (${mode})`,
66
73
  thought: params.explanation,
67
- action: `runLighthouse('${params.categoryId}', '${params.mode ?? 'snapshot'}')`,
74
+ action: `runLighthouse('${params.categoryId}', '${mode}')`,
68
75
  };
69
76
  }
70
77
 
71
78
  async handler(params: RunLighthouseArgs, context: BaseToolCapability&LighthouseRecordingCapability):
72
79
  Promise<ContextHandlerResult<LHModel.ReporterTypes.ReportJSON>> {
73
- const mode = params.mode ?? 'snapshot';
80
+ const mode = resolveMode(params);
81
+ if (params.categoryId !== 'all') {
82
+ const supportedModes = LHModel.RunTypes.CATEGORY_SUPPORTED_MODES[params.categoryId];
83
+ if (!supportedModes?.includes(mode)) {
84
+ return {
85
+ error: `Error: Category "${params.categoryId}" does not support "${mode}" mode. Supported modes: ${
86
+ supportedModes ? supportedModes.join(', ') : 'none'}.`,
87
+ };
88
+ }
89
+ }
74
90
  try {
75
91
  // Passing undefined for categoryIds instructs the Lighthouse runner to audit all categories supported by the mode when isAIControlled is true.
76
92
  const result = await context.runLighthouse({
@@ -347,16 +347,18 @@ export interface BaseTool<ArgsType extends ToolArgs = ToolArgs> {
347
347
  * - `title`: the step heading, sent as `TITLE`.
348
348
  * - `thought`: optional explanation shown in the step, sent as `THOUGHT`.
349
349
  * - `action`: the text shown in the step's code box, sent as
350
- * `ACTION.code`. It is real code only for tools that run code, such as
351
- * `executeJavaScript`. For other tools it is a readable form of the call,
352
- * for example `getInsightDetails('NAVIGATION_0', 'LCPBreakdown')`, and is
353
- * never executed.
350
+ * `ACTION.action`. It is a readable form of the call, for example
351
+ * `getInsightDetails('NAVIGATION_0', 'LCPBreakdown')`, and is never
352
+ * executed.
353
+ * - `javascriptCode`: the exact JavaScript the tool runs in the page, sent
354
+ * as `SIDE_EFFECT.javascriptCode` and shown in the permission prompt.
355
+ * Only set by tools that execute JavaScript, such as `executeJavaScript`.
354
356
  * - `suggestions`: `AiAgent` does not use this field.
355
357
  */
356
358
  readonly displayInfoFromArgs?: (
357
359
  args: ArgsType,
358
360
  ) => {
359
- title?: string, thought?: string, action?: string, suggestions?: [string, ...string[]],
361
+ title?: string, thought?: string, action?: string, javascriptCode?: string, suggestions?: [string, ...string[]],
360
362
  };
361
363
  readonly annotations?: ToolAnnotation[];
362
364
  }