@paulirish/trace_engine 0.0.65 → 0.0.67-beta.0

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 (720) hide show
  1. package/README.md +19 -17
  2. package/analyze-trace.mjs +6 -144
  3. package/core/common/Base64.d.ts +12 -0
  4. package/core/common/CharacterIdMap.d.ts +5 -0
  5. package/core/common/Color.d.ts +357 -0
  6. package/core/common/ColorConverter.d.ts +26 -0
  7. package/core/common/ColorUtils.d.ts +45 -0
  8. package/core/common/Console.d.ts +54 -0
  9. package/core/common/Debouncer.d.ts +8 -0
  10. package/core/common/EventTarget.d.ts +22 -0
  11. package/core/common/Gzip.d.ts +23 -0
  12. package/core/common/JavaScriptMetaData.d.ts +20 -0
  13. package/core/common/Lazy.d.ts +4 -0
  14. package/core/common/MapWithDefault.d.ts +9 -0
  15. package/core/common/Mutex.d.ts +13 -0
  16. package/core/common/Object.d.ts +20 -0
  17. package/core/common/ParsedURL.d.ts +87 -0
  18. package/core/common/Progress.d.ts +47 -0
  19. package/core/common/ResolverBase.d.ts +29 -0
  20. package/core/common/ResourceType.d.ts +52 -0
  21. package/core/common/ReturnToPanel.d.ts +10 -0
  22. package/core/common/Revealer.d.ts +66 -0
  23. package/core/common/Runnable.d.ts +14 -0
  24. package/core/common/SegmentedRange.d.ts +14 -0
  25. package/core/common/SettingRegistration.d.ts +136 -0
  26. package/core/common/Settings.d.ts +226 -0
  27. package/core/common/SimpleHistoryManager.d.ts +20 -0
  28. package/core/common/Srcset.d.ts +16 -0
  29. package/core/common/StringOutputStream.d.ts +10 -0
  30. package/core/common/TextDictionary.d.ts +11 -0
  31. package/core/common/Throttler.d.ts +12 -0
  32. package/core/common/Trie.d.ts +24 -0
  33. package/core/common/VersionController.d.ts +85 -0
  34. package/core/common/common.d.ts +33 -1
  35. package/core/host/AidaClient.d.ts +73 -0
  36. package/core/host/AidaClientTypes.d.ts +355 -0
  37. package/core/host/AidaGcaTranslation.d.ts +10 -0
  38. package/core/host/DispatchHttpRequestClient.d.ts +14 -0
  39. package/core/host/GcaClient.d.ts +14 -0
  40. package/core/host/GcaTypes.d.ts +411 -0
  41. package/core/host/GdpClient.d.ts +84 -0
  42. package/core/host/InspectorFrontendHost.d.ts +29 -0
  43. package/core/host/InspectorFrontendHostAPI.d.ts +425 -0
  44. package/core/host/InspectorFrontendHostStub.d.ts +151 -0
  45. package/core/host/Platform.d.ts +11 -0
  46. package/core/host/ResourceLoader.d.ts +15 -0
  47. package/core/host/UserMetrics.d.ts +116 -0
  48. package/core/host/UserMetricsEnums.d.ts +883 -0
  49. package/core/host/host.d.ts +13 -1
  50. package/core/i18n/ByteUtilities.d.ts +11 -0
  51. package/core/i18n/DevToolsLocale.d.ts +41 -0
  52. package/core/i18n/NumberFormatter.d.ts +11 -0
  53. package/core/i18n/i18n.d.ts +10 -0
  54. package/core/i18n/i18nImpl.d.ts +64 -0
  55. package/core/i18n/i18nTypes.d.ts +5 -0
  56. package/core/i18n/locales.d.ts +15 -0
  57. package/core/i18n/time-utilities.d.ts +16 -0
  58. package/core/platform/ArrayUtilities.d.ts +5 -0
  59. package/core/platform/HostRuntime.d.ts +1 -0
  60. package/core/platform/Size.d.ts +12 -0
  61. package/core/platform/StringUtilities.d.ts +28 -0
  62. package/core/platform/TypescriptUtilities.d.ts +0 -6
  63. package/core/platform/api/HostRuntime.d.ts +25 -0
  64. package/core/platform/platform.d.ts +2 -1
  65. package/core/protocol_client/CDPConnection.d.ts +77 -0
  66. package/core/protocol_client/ConnectionTransport.d.ts +9 -0
  67. package/core/protocol_client/DevToolsCDPConnection.d.ts +16 -0
  68. package/core/protocol_client/InspectorBackend.d.ts +223 -0
  69. package/core/protocol_client/protocol_client.d.ts +5 -0
  70. package/core/root/DevToolsContext.d.ts +34 -0
  71. package/core/root/ExperimentNames.d.ts +8 -0
  72. package/core/root/Runtime.d.ts +351 -0
  73. package/core/root/root.d.ts +4 -1
  74. package/core/sdk/AccessibilityModel.d.ts +76 -0
  75. package/core/sdk/AnimationModel.d.ts +161 -0
  76. package/core/sdk/AutofillModel.d.ts +23 -0
  77. package/core/sdk/CPUProfilerModel.d.ts +46 -0
  78. package/core/sdk/CPUThrottlingManager.d.ts +47 -0
  79. package/core/sdk/CSSContainerQuery.d.ts +42 -0
  80. package/core/sdk/CSSFontFace.d.ts +10 -0
  81. package/core/sdk/CSSLayer.d.ts +9 -0
  82. package/core/sdk/CSSLocation.d.ts +14 -0
  83. package/core/sdk/CSSMatchedStyles.d.ts +138 -0
  84. package/core/sdk/CSSMedia.d.ts +36 -0
  85. package/core/sdk/CSSMetadata.d.ts +87 -0
  86. package/core/sdk/CSSModel.d.ts +180 -0
  87. package/core/sdk/CSSNavigation.d.ts +10 -0
  88. package/core/sdk/CSSProperty.d.ts +53 -0
  89. package/core/sdk/CSSPropertyParser.d.ts +131 -0
  90. package/core/sdk/CSSPropertyParserMatchers.d.ts +442 -0
  91. package/core/sdk/CSSQuery.d.ts +22 -0
  92. package/core/sdk/CSSRule.d.ts +132 -0
  93. package/core/sdk/CSSScope.d.ts +9 -0
  94. package/core/sdk/CSSStartingStyle.d.ts +9 -0
  95. package/core/sdk/CSSStyleDeclaration.d.ts +38 -0
  96. package/core/sdk/CSSStyleSheetHeader.d.ts +53 -0
  97. package/core/sdk/CSSSupports.d.ts +10 -0
  98. package/core/sdk/CategorizedBreakpoint.d.ts +42 -0
  99. package/core/sdk/ChildTargetManager.d.ts +40 -0
  100. package/core/sdk/CompilerSourceMappingContentProvider.d.ts +12 -0
  101. package/core/sdk/Connections.d.ts +36 -0
  102. package/core/sdk/ConsoleModel.d.ts +127 -0
  103. package/core/sdk/ConsoleModelTypes.d.ts +6 -0
  104. package/core/sdk/Cookie.d.ts +68 -0
  105. package/core/sdk/CookieModel.d.ts +31 -0
  106. package/core/sdk/CookieParser.d.ts +14 -0
  107. package/core/sdk/CrashReportContextModel.d.ts +8 -0
  108. package/core/sdk/DOMDebuggerModel.d.ts +127 -0
  109. package/core/sdk/DOMModel.d.ts +436 -0
  110. package/core/sdk/DOMStorageModel.d.ts +79 -0
  111. package/core/sdk/DebuggerModel.d.ts +272 -0
  112. package/core/sdk/EmulationModel.d.ts +95 -0
  113. package/core/sdk/EnhancedTracesParser.d.ts +105 -0
  114. package/core/sdk/EventBreakpointsModel.d.ts +66 -0
  115. package/core/sdk/FrameAssociated.d.ts +6 -0
  116. package/core/sdk/FrameManager.d.ts +68 -0
  117. package/core/sdk/HeapProfilerModel.d.ts +75 -0
  118. package/core/sdk/HttpReasonPhraseStrings.d.ts +5 -0
  119. package/core/sdk/IOModel.d.ts +10 -0
  120. package/core/sdk/IsolateManager.d.ts +53 -0
  121. package/core/sdk/IssuesModel.d.ts +28 -0
  122. package/core/sdk/LayerTreeBase.d.ts +70 -0
  123. package/core/sdk/LogModel.d.ts +20 -0
  124. package/core/sdk/NetworkManager.d.ts +418 -0
  125. package/core/sdk/NetworkRequest.d.ts +469 -0
  126. package/core/sdk/NetworkRequestAccess.d.ts +91 -0
  127. package/core/sdk/OverlayColorGenerator.d.ts +14 -0
  128. package/core/sdk/OverlayModel.d.ts +186 -0
  129. package/core/sdk/OverlayPersistentHighlighter.d.ts +116 -0
  130. package/core/sdk/PageFunctions.d.ts +22 -0
  131. package/core/sdk/PageLoad.d.ts +14 -0
  132. package/core/sdk/PageResourceLoader.d.ts +111 -0
  133. package/core/sdk/PaintProfiler.d.ts +43 -0
  134. package/core/sdk/PerformanceMetricsModel.d.ts +12 -0
  135. package/core/sdk/PreloadingModel.d.ts +146 -0
  136. package/core/sdk/RehydratingConnection.d.ts +73 -0
  137. package/core/sdk/RehydratingObject.d.ts +59 -0
  138. package/core/sdk/RemoteObject.d.ts +210 -0
  139. package/core/sdk/Resource.d.ts +36 -0
  140. package/core/sdk/ResourceTreeModel.d.ts +278 -0
  141. package/core/sdk/RuntimeModel.d.ts +163 -0
  142. package/core/sdk/SDKModel.d.ts +30 -0
  143. package/core/sdk/SDKSettings.d.ts +53 -0
  144. package/core/sdk/ScopeTreeCache.d.ts +21 -0
  145. package/core/sdk/ScreenCaptureModel.d.ts +69 -0
  146. package/core/sdk/Script.d.ts +134 -0
  147. package/core/sdk/SecurityOrigin.d.ts +108 -0
  148. package/core/sdk/SecurityOriginManager.d.ts +23 -0
  149. package/core/sdk/ServerSentEvents.d.ts +18 -0
  150. package/core/sdk/ServerSentEventsProtocol.d.ts +18 -0
  151. package/core/sdk/ServerTiming.d.ts +24 -0
  152. package/core/sdk/ServiceWorkerCacheModel.d.ts +71 -0
  153. package/core/sdk/ServiceWorkerManager.d.ts +125 -0
  154. package/core/sdk/SourceMap.d.ts +197 -0
  155. package/core/sdk/SourceMapCache.d.ts +12 -0
  156. package/core/sdk/SourceMapFunctionRanges.d.ts +26 -0
  157. package/core/sdk/SourceMapManager.d.ts +46 -0
  158. package/core/sdk/SourceMapRangeMappings.d.ts +15 -0
  159. package/core/sdk/SourceMapScopeChainEntry.d.ts +23 -0
  160. package/core/sdk/SourceMapScopesInfo.d.ts +109 -0
  161. package/core/sdk/StorageBucketsModel.d.ts +48 -0
  162. package/core/sdk/StorageKeyManager.d.ts +38 -0
  163. package/core/sdk/Target.d.ts +79 -0
  164. package/core/sdk/TargetManager.d.ts +92 -0
  165. package/core/sdk/TraceObject.d.ts +43 -0
  166. package/core/sdk/WebAuthnModel.d.ts +29 -0
  167. package/core/sdk/sdk.d.ts +97 -1
  168. package/core/text_utils/CodeMirrorUtils.d.ts +3 -0
  169. package/core/text_utils/ContentData.d.ts +94 -0
  170. package/core/text_utils/ContentProvider.d.ts +42 -0
  171. package/core/text_utils/StaticContentProvider.d.ts +13 -0
  172. package/core/text_utils/StreamingContentData.d.ts +49 -0
  173. package/core/text_utils/Text.d.ts +19 -0
  174. package/core/text_utils/TextCursor.d.ts +9 -0
  175. package/core/text_utils/TextRange.d.ts +81 -0
  176. package/core/text_utils/TextUtils.d.ts +97 -0
  177. package/core/text_utils/WasmDisassembly.d.ts +29 -0
  178. package/core/text_utils/text_utils.d.ts +11 -0
  179. package/entrypoints/formatter_actions/formatter_actions.d.ts +48 -0
  180. package/generated/InspectorBackendCommands.d.ts +14 -0
  181. package/generated/SupportedCSSProperties.d.ts +18 -0
  182. package/generated/protocol-mapping.d.ts +5930 -0
  183. package/generated/protocol-proxy-api.d.ts +5396 -0
  184. package/generated/protocol.d.ts +736 -685
  185. package/index.js +6 -0
  186. package/locales/af.json +80 -62
  187. package/locales/am.json +363 -345
  188. package/locales/ar.json +364 -346
  189. package/locales/as.json +362 -344
  190. package/locales/az.json +353 -335
  191. package/locales/be.json +363 -345
  192. package/locales/bg.json +363 -345
  193. package/locales/bn.json +363 -345
  194. package/locales/bs.json +259 -241
  195. package/locales/ca.json +295 -277
  196. package/locales/cs.json +348 -330
  197. package/locales/cy.json +139 -121
  198. package/locales/da.json +222 -204
  199. package/locales/de.json +234 -216
  200. package/locales/el.json +348 -330
  201. package/locales/en-GB.json +36 -18
  202. package/locales/es-419.json +290 -272
  203. package/locales/es.json +292 -274
  204. package/locales/et.json +251 -233
  205. package/locales/eu.json +29 -11
  206. package/locales/fa.json +363 -345
  207. package/locales/fi.json +295 -277
  208. package/locales/fil.json +29 -11
  209. package/locales/fr-CA.json +320 -302
  210. package/locales/fr.json +317 -299
  211. package/locales/gl.json +276 -258
  212. package/locales/gu.json +364 -346
  213. package/locales/he.json +364 -346
  214. package/locales/hi.json +348 -330
  215. package/locales/hr.json +250 -232
  216. package/locales/hu.json +354 -336
  217. package/locales/hy.json +363 -345
  218. package/locales/id.json +27 -9
  219. package/locales/is.json +317 -299
  220. package/locales/it.json +154 -136
  221. package/locales/ja.json +363 -345
  222. package/locales/ka.json +364 -346
  223. package/locales/kk.json +364 -346
  224. package/locales/km.json +363 -345
  225. package/locales/kn.json +364 -346
  226. package/locales/ko.json +363 -345
  227. package/locales/ky.json +362 -344
  228. package/locales/lo.json +364 -346
  229. package/locales/lt.json +331 -313
  230. package/locales/lv.json +331 -313
  231. package/locales/mk.json +364 -346
  232. package/locales/ml.json +363 -345
  233. package/locales/mn.json +363 -345
  234. package/locales/mr.json +363 -345
  235. package/locales/ms.json +27 -9
  236. package/locales/my.json +362 -344
  237. package/locales/ne.json +348 -330
  238. package/locales/nl.json +84 -66
  239. package/locales/no.json +188 -170
  240. package/locales/or.json +363 -345
  241. package/locales/pa.json +363 -345
  242. package/locales/pl.json +322 -304
  243. package/locales/pt-PT.json +284 -266
  244. package/locales/pt.json +283 -265
  245. package/locales/ro.json +318 -300
  246. package/locales/ru.json +363 -345
  247. package/locales/si.json +364 -346
  248. package/locales/sk.json +345 -327
  249. package/locales/sl.json +231 -213
  250. package/locales/sq.json +329 -311
  251. package/locales/sr-Latn.json +267 -249
  252. package/locales/sr.json +364 -346
  253. package/locales/sv.json +296 -278
  254. package/locales/sw.json +35 -17
  255. package/locales/ta.json +364 -346
  256. package/locales/te.json +362 -344
  257. package/locales/th.json +364 -346
  258. package/locales/tr.json +337 -319
  259. package/locales/uk.json +363 -345
  260. package/locales/ur.json +364 -346
  261. package/locales/uz.json +175 -157
  262. package/locales/vi.json +364 -346
  263. package/locales/zh-HK.json +364 -346
  264. package/locales/zh-TW.json +363 -345
  265. package/locales/zh.json +363 -345
  266. package/locales/zu.json +35 -17
  267. package/models/crux-manager/CrUXManager.d.ts +107 -0
  268. package/models/crux-manager/crux-manager.d.ts +1 -0
  269. package/models/emulation/DeviceModeModel.d.ts +156 -0
  270. package/models/emulation/EmulatedDevices.d.ts +148 -0
  271. package/models/emulation/emulation.d.ts +3 -0
  272. package/models/formatter/FormatterWorkerPool.d.ts +58 -0
  273. package/models/formatter/ScriptFormatter.d.ts +11 -0
  274. package/models/formatter/formatter.d.ts +3 -0
  275. package/models/trace/ModelImpl.d.ts +2 -6
  276. package/models/trace/Processor.d.ts +2 -6
  277. package/models/trace/extras/StackTraceForEvent.d.ts +1 -1
  278. package/models/trace/extras/extras.d.ts +2 -7
  279. package/models/trace/handlers/FramesHandler.d.ts +1 -2
  280. package/models/trace/handlers/LayoutShiftsHandler.d.ts +2 -2
  281. package/models/trace/handlers/MetaHandler.d.ts +2 -3
  282. package/models/trace/handlers/ModelHandlers.d.ts +0 -1
  283. package/models/trace/handlers/PageLoadMetricsHandler.d.ts +2 -0
  284. package/models/trace/handlers/ScriptsHandler.d.ts +2 -2
  285. package/models/trace/handlers/Threads.d.ts +1 -3
  286. package/models/trace/handlers/UserTimingsHandler.d.ts +1 -1
  287. package/models/trace/helpers/Network.d.ts +3 -1
  288. package/models/trace/helpers/SyntheticEvents.d.ts +7 -0
  289. package/models/trace/insights/CLSCulprits.d.ts +6 -3
  290. package/models/trace/insights/Cache.d.ts +2 -1
  291. package/models/trace/insights/CharacterSet.d.ts +5 -4
  292. package/models/trace/insights/Common.d.ts +4 -4
  293. package/models/trace/insights/DOMSize.d.ts +4 -3
  294. package/models/trace/insights/DocumentLatency.d.ts +2 -1
  295. package/models/trace/insights/DuplicatedJavaScript.d.ts +9 -4
  296. package/models/trace/insights/FontDisplay.d.ts +11 -5
  297. package/models/trace/insights/ForcedReflow.d.ts +6 -6
  298. package/models/trace/insights/INPBreakdown.d.ts +5 -5
  299. package/models/trace/insights/ImageDelivery.d.ts +7 -7
  300. package/models/trace/insights/LCPBreakdown.d.ts +4 -3
  301. package/models/trace/insights/LCPDiscovery.d.ts +7 -6
  302. package/models/trace/insights/LegacyJavaScript.d.ts +9 -4
  303. package/models/trace/insights/ModernHTTP.d.ts +6 -6
  304. package/models/trace/insights/NetworkDependencyTree.d.ts +18 -96
  305. package/models/trace/insights/RenderBlocking.d.ts +4 -3
  306. package/models/trace/insights/SlowCSSSelector.d.ts +10 -9
  307. package/models/trace/insights/ThirdParties.d.ts +17 -8
  308. package/models/trace/insights/Viewport.d.ts +6 -4
  309. package/models/trace/insights/types.d.ts +10 -7
  310. package/models/trace/lantern/lantern.js +6 -8
  311. package/models/trace/lantern/simulation/Constants.d.ts +29 -28
  312. package/models/trace/trace.js +529 -18
  313. package/models/trace/types/Configuration.d.ts +12 -1
  314. package/models/trace/types/File.d.ts +6 -5
  315. package/models/trace/types/Overlays.d.ts +13 -3
  316. package/models/trace/types/Timing.js +6 -14
  317. package/models/trace/types/TraceEvents.d.ts +48 -18
  318. package/models/trace/types/TraceEvents.js +187 -884
  319. package/models/trace/types/types.js +6 -8
  320. package/package.json +30 -9
  321. package/third_party/codemirror.next/codemirror.next.d.ts +9196 -0
  322. package/third_party/i18n/i18n-impl.d.ts +25 -0
  323. package/third_party/i18n/i18n.d.ts +3 -0
  324. package/third_party/i18n/localized-string-set.d.ts +49 -0
  325. package/third_party/intl-messageformat/intl-messageformat.d.ts +1 -0
  326. package/third_party/legacy-javascript/legacy-javascript.d.ts +2 -1
  327. package/third_party/legacy-javascript/lib/legacy-javascript.d.ts +18 -0
  328. package/third_party/source-map-scopes-codec/package/src/builder/builder.d.ts +67 -0
  329. package/third_party/source-map-scopes-codec/package/src/builder/safe_builder.d.ts +38 -0
  330. package/third_party/source-map-scopes-codec/package/src/codec.d.ts +48 -0
  331. package/third_party/source-map-scopes-codec/package/src/decode/decode.d.ts +31 -0
  332. package/third_party/source-map-scopes-codec/package/src/encode/encode.d.ts +8 -0
  333. package/third_party/source-map-scopes-codec/package/src/encode/encoder.d.ts +6 -0
  334. package/third_party/source-map-scopes-codec/package/src/mod.d.ts +5 -0
  335. package/third_party/source-map-scopes-codec/package/src/scopes.d.ts +168 -0
  336. package/third_party/source-map-scopes-codec/package/src/util.d.ts +5 -0
  337. package/third_party/source-map-scopes-codec/package/src/vlq.d.ts +14 -0
  338. package/third_party/source-map-scopes-codec/source-map-scopes-codec.d.ts +1 -0
  339. package/third_party/third-party-web/lib/nostats-subset.d.ts +2 -0
  340. package/third_party/third-party-web/package/lib/index.d.ts +34 -0
  341. package/third_party/third-party-web/package/lib/subsets/nostats.d.ts +1 -0
  342. package/third_party/third-party-web/third-party-web.d.ts +2 -1
  343. package/.tmp/tsbuildinfo/analyze-inspector-issues.d.mts +0 -13
  344. package/.tmp/tsbuildinfo/analyze-inspector-issues.d.mts.map +0 -1
  345. package/.tmp/tsbuildinfo/analyze-trace.d.mts +0 -17
  346. package/.tmp/tsbuildinfo/analyze-trace.d.mts.map +0 -1
  347. package/.tmp/tsbuildinfo/models/trace/extras/polyfills.d.ts +0 -4
  348. package/.tmp/tsbuildinfo/models/trace/extras/polyfills.d.ts.map +0 -1
  349. package/.tmp/tsbuildinfo/test/test-trace-engine.d.mts +0 -2
  350. package/.tmp/tsbuildinfo/test/test-trace-engine.d.mts.map +0 -1
  351. package/.tmp/tsbuildinfo/third_party/third-party-web/third-party-web.d.ts +0 -3
  352. package/.tmp/tsbuildinfo/third_party/third-party-web/third-party-web.d.ts.map +0 -1
  353. package/.tmp/tsbuildinfo/tsconfig.tsbuildinfo +0 -1
  354. package/analyze-inspector-issues.mjs +0 -60
  355. package/core/common/common.js +0 -1
  356. package/core/host/host.js +0 -1
  357. package/core/platform/ArrayUtilities.js +0 -210
  358. package/core/platform/ArrayUtilities.js.map +0 -1
  359. package/core/platform/Brand.js +0 -5
  360. package/core/platform/Brand.js.map +0 -1
  361. package/core/platform/Constructor.js +0 -5
  362. package/core/platform/Constructor.js.map +0 -1
  363. package/core/platform/DateUtilities.js +0 -14
  364. package/core/platform/DateUtilities.js.map +0 -1
  365. package/core/platform/DevToolsPath.js +0 -28
  366. package/core/platform/DevToolsPath.js.map +0 -1
  367. package/core/platform/HostRuntime.js +0 -31
  368. package/core/platform/HostRuntime.js.map +0 -1
  369. package/core/platform/KeyboardUtilities.js +0 -22
  370. package/core/platform/KeyboardUtilities.js.map +0 -1
  371. package/core/platform/MapUtilities.js +0 -80
  372. package/core/platform/MapUtilities.js.map +0 -1
  373. package/core/platform/MimeType.js +0 -144
  374. package/core/platform/MimeType.js.map +0 -1
  375. package/core/platform/NumberUtilities.js +0 -73
  376. package/core/platform/NumberUtilities.js.map +0 -1
  377. package/core/platform/StringUtilities.js +0 -594
  378. package/core/platform/StringUtilities.js.map +0 -1
  379. package/core/platform/Timing.js +0 -10
  380. package/core/platform/Timing.js.map +0 -1
  381. package/core/platform/TypedArrayUtilities.js +0 -158
  382. package/core/platform/TypedArrayUtilities.js.map +0 -1
  383. package/core/platform/TypescriptUtilities.js +0 -25
  384. package/core/platform/TypescriptUtilities.js.map +0 -1
  385. package/core/platform/UIString.js +0 -5
  386. package/core/platform/UIString.js.map +0 -1
  387. package/core/platform/UserVisibleError.js +0 -23
  388. package/core/platform/UserVisibleError.js.map +0 -1
  389. package/core/platform/api/HostRuntime.js +0 -5
  390. package/core/platform/api/HostRuntime.js.map +0 -1
  391. package/core/platform/api/api-tsconfig.json +0 -43
  392. package/core/platform/api/api.js +0 -6
  393. package/core/platform/api/api.js.map +0 -1
  394. package/core/platform/api/api_node_typecheck-tsconfig.json +0 -48
  395. package/core/platform/api/bundle-tsconfig.json +0 -1
  396. package/core/platform/api/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  397. package/core/platform/browser/HostRuntime.js +0 -75
  398. package/core/platform/browser/HostRuntime.js.map +0 -1
  399. package/core/platform/browser/browser-tsconfig.json +0 -48
  400. package/core/platform/browser/browser.js +0 -6
  401. package/core/platform/browser/browser.js.map +0 -1
  402. package/core/platform/browser/bundle-tsconfig.json +0 -1
  403. package/core/platform/browser/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  404. package/core/platform/bundle-tsconfig.json +0 -1
  405. package/core/platform/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  406. package/core/platform/node/HostRuntime.js +0 -82
  407. package/core/platform/node/HostRuntime.js.map +0 -1
  408. package/core/platform/node/bundle-tsconfig.json +0 -1
  409. package/core/platform/node/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  410. package/core/platform/node/node-tsconfig.json +0 -52
  411. package/core/platform/node/node.js +0 -6
  412. package/core/platform/node/node.js.map +0 -1
  413. package/core/platform/platform-tsconfig.json +0 -69
  414. package/core/platform/platform.js +0 -27
  415. package/core/platform/platform.js.map +0 -1
  416. package/core/platform/platform_node_typecheck-tsconfig.json +0 -74
  417. package/core/root/root.js +0 -1
  418. package/core/sdk/sdk.js +0 -1
  419. package/generated/protocol.js +0 -5
  420. package/locales/en-US.json +0 -1046
  421. package/locales/en-XL.json +0 -1046
  422. package/models/cpu_profile/CPUProfileDataModel.js +0 -517
  423. package/models/cpu_profile/CPUProfileDataModel.js.map +0 -1
  424. package/models/cpu_profile/ProfileTreeModel.js +0 -90
  425. package/models/cpu_profile/ProfileTreeModel.js.map +0 -1
  426. package/models/cpu_profile/bundle-tsconfig.json +0 -1
  427. package/models/cpu_profile/cpu_profile-tsconfig.json +0 -52
  428. package/models/cpu_profile/cpu_profile.js +0 -7
  429. package/models/cpu_profile/cpu_profile.js.map +0 -1
  430. package/models/cpu_profile/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  431. package/models/issues_manager/CheckFormsIssuesTrigger.d.ts +0 -1
  432. package/models/issues_manager/CheckFormsIssuesTrigger.js +0 -1
  433. package/models/issues_manager/ContrastCheckTrigger.d.ts +0 -1
  434. package/models/issues_manager/ContrastCheckTrigger.js +0 -1
  435. package/models/issues_manager/DeprecationIssue.d.ts +0 -1
  436. package/models/issues_manager/DeprecationIssue.js +0 -1
  437. package/models/issues_manager/IssueResolver.d.ts +0 -1
  438. package/models/issues_manager/IssueResolver.js +0 -1
  439. package/models/issues_manager/RelatedIssue.d.ts +0 -1
  440. package/models/issues_manager/RelatedIssue.js +0 -1
  441. package/models/issues_manager/SourceFrameIssuesManager.d.ts +0 -1
  442. package/models/issues_manager/SourceFrameIssuesManager.js +0 -1
  443. package/models/trace/EntityMapper.js +0 -133
  444. package/models/trace/EntityMapper.js.map +0 -1
  445. package/models/trace/EventsSerializer.js +0 -90
  446. package/models/trace/EventsSerializer.js.map +0 -1
  447. package/models/trace/LanternComputationData.js +0 -367
  448. package/models/trace/LanternComputationData.js.map +0 -1
  449. package/models/trace/LegacyTracingModel.d.ts +0 -1
  450. package/models/trace/LegacyTracingModel.js +0 -1
  451. package/models/trace/ModelImpl.js +0 -170
  452. package/models/trace/ModelImpl.js.map +0 -1
  453. package/models/trace/Name.js +0 -115
  454. package/models/trace/Name.js.map +0 -1
  455. package/models/trace/Processor.js +0 -556
  456. package/models/trace/Processor.js.map +0 -1
  457. package/models/trace/Styles.js +0 -824
  458. package/models/trace/Styles.js.map +0 -1
  459. package/models/trace/TracingManager.d.ts +0 -1
  460. package/models/trace/TracingManager.js +0 -1
  461. package/models/trace/bundle-tsconfig.json +0 -1
  462. package/models/trace/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -66
  463. package/models/trace/extras/FilmStrip.js +0 -45
  464. package/models/trace/extras/FilmStrip.js.map +0 -1
  465. package/models/trace/extras/Initiators.js +0 -47
  466. package/models/trace/extras/Initiators.js.map +0 -1
  467. package/models/trace/extras/MainThreadActivity.js +0 -77
  468. package/models/trace/extras/MainThreadActivity.js.map +0 -1
  469. package/models/trace/extras/ScriptDuplication.js +0 -163
  470. package/models/trace/extras/ScriptDuplication.js.map +0 -1
  471. package/models/trace/extras/StackTraceForEvent.js +0 -192
  472. package/models/trace/extras/StackTraceForEvent.js.map +0 -1
  473. package/models/trace/extras/ThirdParties.js +0 -119
  474. package/models/trace/extras/ThirdParties.js.map +0 -1
  475. package/models/trace/extras/TraceFilter.js +0 -51
  476. package/models/trace/extras/TraceFilter.js.map +0 -1
  477. package/models/trace/extras/TraceTree.js +0 -621
  478. package/models/trace/extras/TraceTree.js.map +0 -1
  479. package/models/trace/extras/bundle-tsconfig.json +0 -1
  480. package/models/trace/extras/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  481. package/models/trace/extras/extras-tsconfig.json +0 -70
  482. package/models/trace/extras/extras.js +0 -13
  483. package/models/trace/extras/extras.js.map +0 -1
  484. package/models/trace/handlers/AnimationFramesHandler.js +0 -110
  485. package/models/trace/handlers/AnimationFramesHandler.js.map +0 -1
  486. package/models/trace/handlers/AnimationHandler.js +0 -27
  487. package/models/trace/handlers/AnimationHandler.js.map +0 -1
  488. package/models/trace/handlers/AsyncJSCallsHandler.js +0 -188
  489. package/models/trace/handlers/AsyncJSCallsHandler.js.map +0 -1
  490. package/models/trace/handlers/AuctionWorkletsHandler.d.ts +0 -8
  491. package/models/trace/handlers/AuctionWorkletsHandler.js +0 -163
  492. package/models/trace/handlers/AuctionWorkletsHandler.js.map +0 -1
  493. package/models/trace/handlers/DOMStatsHandler.js +0 -22
  494. package/models/trace/handlers/DOMStatsHandler.js.map +0 -1
  495. package/models/trace/handlers/ExtensionTraceDataHandler.js +0 -264
  496. package/models/trace/handlers/ExtensionTraceDataHandler.js.map +0 -1
  497. package/models/trace/handlers/FlowsHandler.js +0 -149
  498. package/models/trace/handlers/FlowsHandler.js.map +0 -1
  499. package/models/trace/handlers/FramesHandler.js +0 -492
  500. package/models/trace/handlers/FramesHandler.js.map +0 -1
  501. package/models/trace/handlers/GPUHandler.js +0 -36
  502. package/models/trace/handlers/GPUHandler.js.map +0 -1
  503. package/models/trace/handlers/ImagePaintingHandler.js +0 -148
  504. package/models/trace/handlers/ImagePaintingHandler.js.map +0 -1
  505. package/models/trace/handlers/InitiatorsHandler.js +0 -181
  506. package/models/trace/handlers/InitiatorsHandler.js.map +0 -1
  507. package/models/trace/handlers/InvalidationsHandler.js +0 -127
  508. package/models/trace/handlers/InvalidationsHandler.js.map +0 -1
  509. package/models/trace/handlers/LargestImagePaintHandler.js +0 -86
  510. package/models/trace/handlers/LargestImagePaintHandler.js.map +0 -1
  511. package/models/trace/handlers/LargestTextPaintHandler.js +0 -28
  512. package/models/trace/handlers/LargestTextPaintHandler.js.map +0 -1
  513. package/models/trace/handlers/LayerTreeHandler.js +0 -104
  514. package/models/trace/handlers/LayerTreeHandler.js.map +0 -1
  515. package/models/trace/handlers/LayoutShiftsHandler.js +0 -458
  516. package/models/trace/handlers/LayoutShiftsHandler.js.map +0 -1
  517. package/models/trace/handlers/MemoryHandler.js +0 -22
  518. package/models/trace/handlers/MemoryHandler.js.map +0 -1
  519. package/models/trace/handlers/MetaHandler.js +0 -411
  520. package/models/trace/handlers/MetaHandler.js.map +0 -1
  521. package/models/trace/handlers/ModelHandlers.js +0 -34
  522. package/models/trace/handlers/ModelHandlers.js.map +0 -1
  523. package/models/trace/handlers/NetworkRequestsHandler.js +0 -576
  524. package/models/trace/handlers/NetworkRequestsHandler.js.map +0 -1
  525. package/models/trace/handlers/PageFramesHandler.js +0 -43
  526. package/models/trace/handlers/PageFramesHandler.js.map +0 -1
  527. package/models/trace/handlers/PageLoadMetricsHandler.js +0 -423
  528. package/models/trace/handlers/PageLoadMetricsHandler.js.map +0 -1
  529. package/models/trace/handlers/RendererHandler.js +0 -347
  530. package/models/trace/handlers/RendererHandler.js.map +0 -1
  531. package/models/trace/handlers/SamplesHandler.js +0 -261
  532. package/models/trace/handlers/SamplesHandler.js.map +0 -1
  533. package/models/trace/handlers/ScreenshotsHandler.js +0 -98
  534. package/models/trace/handlers/ScreenshotsHandler.js.map +0 -1
  535. package/models/trace/handlers/ScriptsHandler.js +0 -286
  536. package/models/trace/handlers/ScriptsHandler.js.map +0 -1
  537. package/models/trace/handlers/SelectorStatsHandler.js +0 -72
  538. package/models/trace/handlers/SelectorStatsHandler.js.map +0 -1
  539. package/models/trace/handlers/Threads.js +0 -112
  540. package/models/trace/handlers/Threads.js.map +0 -1
  541. package/models/trace/handlers/UserInteractionsHandler.js +0 -319
  542. package/models/trace/handlers/UserInteractionsHandler.js.map +0 -1
  543. package/models/trace/handlers/UserTimingsHandler.js +0 -184
  544. package/models/trace/handlers/UserTimingsHandler.js.map +0 -1
  545. package/models/trace/handlers/WarningsHandler.js +0 -135
  546. package/models/trace/handlers/WarningsHandler.js.map +0 -1
  547. package/models/trace/handlers/WorkersHandler.js +0 -34
  548. package/models/trace/handlers/WorkersHandler.js.map +0 -1
  549. package/models/trace/handlers/bundle-tsconfig.json +0 -1
  550. package/models/trace/handlers/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  551. package/models/trace/handlers/handlers-tsconfig.json +0 -102
  552. package/models/trace/handlers/handlers.js +0 -8
  553. package/models/trace/handlers/handlers.js.map +0 -1
  554. package/models/trace/handlers/helpers.js +0 -164
  555. package/models/trace/handlers/helpers.js.map +0 -1
  556. package/models/trace/handlers/types.js +0 -2
  557. package/models/trace/handlers/types.js.map +0 -1
  558. package/models/trace/helpers/Extensions.js +0 -42
  559. package/models/trace/helpers/Extensions.js.map +0 -1
  560. package/models/trace/helpers/Network.js +0 -103
  561. package/models/trace/helpers/Network.js.map +0 -1
  562. package/models/trace/helpers/SamplesIntegrator.js +0 -496
  563. package/models/trace/helpers/SamplesIntegrator.js.map +0 -1
  564. package/models/trace/helpers/SyntheticEvents.js +0 -75
  565. package/models/trace/helpers/SyntheticEvents.js.map +0 -1
  566. package/models/trace/helpers/Timing.js +0 -194
  567. package/models/trace/helpers/Timing.js.map +0 -1
  568. package/models/trace/helpers/Trace.js +0 -817
  569. package/models/trace/helpers/Trace.js.map +0 -1
  570. package/models/trace/helpers/TreeHelpers.js +0 -255
  571. package/models/trace/helpers/TreeHelpers.js.map +0 -1
  572. package/models/trace/helpers/bundle-tsconfig.json +0 -1
  573. package/models/trace/helpers/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  574. package/models/trace/helpers/helpers-tsconfig.json +0 -69
  575. package/models/trace/helpers/helpers.js +0 -11
  576. package/models/trace/helpers/helpers.js.map +0 -1
  577. package/models/trace/insights/CLSCulprits.js +0 -518
  578. package/models/trace/insights/CLSCulprits.js.map +0 -1
  579. package/models/trace/insights/Cache.js +0 -210
  580. package/models/trace/insights/Cache.js.map +0 -1
  581. package/models/trace/insights/CharacterSet.js +0 -132
  582. package/models/trace/insights/CharacterSet.js.map +0 -1
  583. package/models/trace/insights/Common.js +0 -348
  584. package/models/trace/insights/Common.js.map +0 -1
  585. package/models/trace/insights/DOMSize.js +0 -182
  586. package/models/trace/insights/DOMSize.js.map +0 -1
  587. package/models/trace/insights/DocumentLatency.js +0 -259
  588. package/models/trace/insights/DocumentLatency.js.map +0 -1
  589. package/models/trace/insights/DuplicatedJavaScript.js +0 -95
  590. package/models/trace/insights/DuplicatedJavaScript.js.map +0 -1
  591. package/models/trace/insights/FontDisplay.js +0 -87
  592. package/models/trace/insights/FontDisplay.js.map +0 -1
  593. package/models/trace/insights/ForcedReflow.js +0 -162
  594. package/models/trace/insights/ForcedReflow.js.map +0 -1
  595. package/models/trace/insights/INPBreakdown.js +0 -130
  596. package/models/trace/insights/INPBreakdown.js.map +0 -1
  597. package/models/trace/insights/ImageDelivery.js +0 -264
  598. package/models/trace/insights/ImageDelivery.js.map +0 -1
  599. package/models/trace/insights/LCPBreakdown.js +0 -200
  600. package/models/trace/insights/LCPBreakdown.js.map +0 -1
  601. package/models/trace/insights/LCPDiscovery.js +0 -190
  602. package/models/trace/insights/LCPDiscovery.js.map +0 -1
  603. package/models/trace/insights/LegacyJavaScript.js +0 -95
  604. package/models/trace/insights/LegacyJavaScript.js.map +0 -1
  605. package/models/trace/insights/Models.js +0 -23
  606. package/models/trace/insights/Models.js.map +0 -1
  607. package/models/trace/insights/ModernHTTP.js +0 -201
  608. package/models/trace/insights/ModernHTTP.js.map +0 -1
  609. package/models/trace/insights/NetworkDependencyTree.js +0 -968
  610. package/models/trace/insights/NetworkDependencyTree.js.map +0 -1
  611. package/models/trace/insights/RenderBlocking.js +0 -193
  612. package/models/trace/insights/RenderBlocking.js.map +0 -1
  613. package/models/trace/insights/SlowCSSSelector.js +0 -137
  614. package/models/trace/insights/SlowCSSSelector.js.map +0 -1
  615. package/models/trace/insights/Statistics.js +0 -93
  616. package/models/trace/insights/Statistics.js.map +0 -1
  617. package/models/trace/insights/ThirdParties.js +0 -99
  618. package/models/trace/insights/ThirdParties.js.map +0 -1
  619. package/models/trace/insights/Viewport.js +0 -103
  620. package/models/trace/insights/Viewport.js.map +0 -1
  621. package/models/trace/insights/bundle-tsconfig.json +0 -1
  622. package/models/trace/insights/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  623. package/models/trace/insights/insights-tsconfig.json +0 -103
  624. package/models/trace/insights/insights.js +0 -10
  625. package/models/trace/insights/insights.js.map +0 -1
  626. package/models/trace/insights/types.js +0 -41
  627. package/models/trace/insights/types.js.map +0 -1
  628. package/models/trace/lantern/bundle-tsconfig.json +0 -1
  629. package/models/trace/lantern/core/LanternError.js +0 -7
  630. package/models/trace/lantern/core/LanternError.js.map +0 -1
  631. package/models/trace/lantern/core/NetworkAnalyzer.js +0 -484
  632. package/models/trace/lantern/core/NetworkAnalyzer.js.map +0 -1
  633. package/models/trace/lantern/core/bundle-tsconfig.json +0 -1
  634. package/models/trace/lantern/core/core-tsconfig.json +0 -49
  635. package/models/trace/lantern/core/core.js +0 -6
  636. package/models/trace/lantern/core/core.js.map +0 -1
  637. package/models/trace/lantern/core/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  638. package/models/trace/lantern/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -60
  639. package/models/trace/lantern/graph/BaseNode.js +0 -277
  640. package/models/trace/lantern/graph/BaseNode.js.map +0 -1
  641. package/models/trace/lantern/graph/CPUNode.js +0 -64
  642. package/models/trace/lantern/graph/CPUNode.js.map +0 -1
  643. package/models/trace/lantern/graph/NetworkNode.js +0 -83
  644. package/models/trace/lantern/graph/NetworkNode.js.map +0 -1
  645. package/models/trace/lantern/graph/PageDependencyGraph.js +0 -552
  646. package/models/trace/lantern/graph/PageDependencyGraph.js.map +0 -1
  647. package/models/trace/lantern/graph/bundle-tsconfig.json +0 -1
  648. package/models/trace/lantern/graph/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  649. package/models/trace/lantern/graph/graph-tsconfig.json +0 -54
  650. package/models/trace/lantern/graph/graph.js +0 -8
  651. package/models/trace/lantern/graph/graph.js.map +0 -1
  652. package/models/trace/lantern/lantern.js.map +0 -1
  653. package/models/trace/lantern/metrics/FirstContentfulPaint.js +0 -137
  654. package/models/trace/lantern/metrics/FirstContentfulPaint.js.map +0 -1
  655. package/models/trace/lantern/metrics/Interactive.js +0 -68
  656. package/models/trace/lantern/metrics/Interactive.js.map +0 -1
  657. package/models/trace/lantern/metrics/LargestContentfulPaint.js +0 -69
  658. package/models/trace/lantern/metrics/LargestContentfulPaint.js.map +0 -1
  659. package/models/trace/lantern/metrics/MaxPotentialFID.js +0 -49
  660. package/models/trace/lantern/metrics/MaxPotentialFID.js.map +0 -1
  661. package/models/trace/lantern/metrics/Metric.js +0 -69
  662. package/models/trace/lantern/metrics/Metric.js.map +0 -1
  663. package/models/trace/lantern/metrics/SpeedIndex.js +0 -102
  664. package/models/trace/lantern/metrics/SpeedIndex.js.map +0 -1
  665. package/models/trace/lantern/metrics/TBTUtils.js +0 -65
  666. package/models/trace/lantern/metrics/TBTUtils.js.map +0 -1
  667. package/models/trace/lantern/metrics/TotalBlockingTime.js +0 -79
  668. package/models/trace/lantern/metrics/TotalBlockingTime.js.map +0 -1
  669. package/models/trace/lantern/metrics/bundle-tsconfig.json +0 -1
  670. package/models/trace/lantern/metrics/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  671. package/models/trace/lantern/metrics/metrics-tsconfig.json +0 -64
  672. package/models/trace/lantern/metrics/metrics.js +0 -12
  673. package/models/trace/lantern/metrics/metrics.js.map +0 -1
  674. package/models/trace/lantern/simulation/ConnectionPool.js +0 -116
  675. package/models/trace/lantern/simulation/ConnectionPool.js.map +0 -1
  676. package/models/trace/lantern/simulation/Constants.js +0 -43
  677. package/models/trace/lantern/simulation/Constants.js.map +0 -1
  678. package/models/trace/lantern/simulation/DNSCache.js +0 -48
  679. package/models/trace/lantern/simulation/DNSCache.js.map +0 -1
  680. package/models/trace/lantern/simulation/SimulationTimingMap.js +0 -135
  681. package/models/trace/lantern/simulation/SimulationTimingMap.js.map +0 -1
  682. package/models/trace/lantern/simulation/Simulator.js +0 -451
  683. package/models/trace/lantern/simulation/Simulator.js.map +0 -1
  684. package/models/trace/lantern/simulation/TCPConnection.js +0 -155
  685. package/models/trace/lantern/simulation/TCPConnection.js.map +0 -1
  686. package/models/trace/lantern/simulation/bundle-tsconfig.json +0 -1
  687. package/models/trace/lantern/simulation/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  688. package/models/trace/lantern/simulation/simulation-tsconfig.json +0 -59
  689. package/models/trace/lantern/simulation/simulation.js +0 -10
  690. package/models/trace/lantern/simulation/simulation.js.map +0 -1
  691. package/models/trace/lantern/types/Lantern.js +0 -25
  692. package/models/trace/lantern/types/Lantern.js.map +0 -1
  693. package/models/trace/lantern/types/bundle-tsconfig.json +0 -1
  694. package/models/trace/lantern/types/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  695. package/models/trace/lantern/types/types-tsconfig.json +0 -48
  696. package/models/trace/lantern/types/types.js +0 -5
  697. package/models/trace/lantern/types/types.js.map +0 -1
  698. package/models/trace/trace-tsconfig.json +0 -78
  699. package/models/trace/trace.js.map +0 -1
  700. package/models/trace/types/Configuration.js +0 -18
  701. package/models/trace/types/Configuration.js.map +0 -1
  702. package/models/trace/types/Extensions.js +0 -38
  703. package/models/trace/types/Extensions.js.map +0 -1
  704. package/models/trace/types/File.js +0 -82
  705. package/models/trace/types/File.js.map +0 -1
  706. package/models/trace/types/Overlays.js +0 -5
  707. package/models/trace/types/Overlays.js.map +0 -1
  708. package/models/trace/types/Timing.js.map +0 -1
  709. package/models/trace/types/TraceEvents.js.map +0 -1
  710. package/models/trace/types/bundle-tsconfig.json +0 -1
  711. package/models/trace/types/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
  712. package/models/trace/types/types-tsconfig.json +0 -65
  713. package/models/trace/types/types.js.map +0 -1
  714. package/test/invalid-animation-events.json.gz +0 -0
  715. package/test/test-trace-engine.mjs +0 -191
  716. package/third_party/legacy-javascript/legacy-javascript.js +0 -1
  717. package/third_party/marked/marked.d.ts +0 -1
  718. package/third_party/marked/marked.js +0 -1
  719. package/third_party/third-party-web/third-party-web.js +0 -1
  720. package/tsconfig.json +0 -29
package/README.md CHANGED
@@ -10,40 +10,42 @@ But the breakages should be obvious exceptions or type failures.
10
10
  ```js
11
11
  import * as TraceModel from '@paulirish/trace_engine';
12
12
 
13
- polyfillDOMRect();
14
13
  const engine = TraceModel.Processor.TraceProcessor.createWithAllHandlers();
15
14
 
16
15
  await engine.parse(traceEvents);
17
16
  console.log(engine.data) // TraceParseData
18
17
  ```
19
18
 
20
- **Note:** To run in Node, you'll need to polyfill `window.DOMRect`. 😜
19
+ See the included `analyze-trace.mjs` for a runnable invocation.
21
20
 
22
- See the included `analyze-trace.mjs` a runnable invocation.
21
+ ### Types & Submodule Imports
23
22
 
24
- ### Types
23
+ All `models/trace/**` submodules exported by `trace.ts` (including `models/trace/types/TraceEvents.js`, `models/trace/lantern/lantern.js`, `models/trace/insights/*.js`, and `models/trace/extras/ThirdParties.js`) have both `.d.ts` declarations and runtime `.js` ESM proxies:
25
24
 
26
- You'll probably use something like…
27
-
28
- @type {import('@paulirish/trace_engine').Types.TraceEvents.TraceEventData[]}
29
- @type {import('@paulirish/trace_engine').Handlers.Types.TraceParseData}
25
+ @type {import('@paulirish/trace_engine').Types.Events.Event[]}
26
+ @type {import('@paulirish/trace_engine').Handlers.Types.HandlerData}
30
27
 
31
28
  ## Maintainer cheatsheet
32
29
 
33
- See also http://go/btlax
30
+ `@paulirish/trace_engine` wraps the pre-bundled `DevTools.TraceEngine` shipped in `chrome-devtools-mcp` and emits the exact matching `.d.ts` declarations from `devtools-frontend` (using the commit SHA recorded in `chrome-devtools-mcp/build/src/third_party/bundled-packages.json`).
34
31
 
35
- ```sh
36
- # Build devtools and prep a package, then invoke the copy script to prepare $HOME/code/trace_engine
37
- scripts/trace/prep-trace-engine-package.sh
32
+ - `scripts/build.ts` automatically pins the exact `chrome-devtools-mcp` version in `package.json` so runtime code and `.d.ts` declarations never drift.
33
+ - Exported `const enum`s under `models/trace` (such as `Types.Events.Name`, `Types.Events.Phase`, `Handlers.Threads.ThreadType`, etc.) are materialized as runtime enum objects so plain JS and `--experimental-strip-types` consumers can reference them at runtime. (`const enum`s in other internal DevTools modules remain type-only.)
34
+ - Importing `@paulirish/trace_engine` initializes the `DevToolsLocale` singleton to `'en-US'` if it has not already been initialized in the current process.
38
35
 
39
- # switch to standalone
36
+ ```sh
40
37
  cd $HOME/code/trace_engine
41
38
 
42
- # bump
43
- npm version v0.0.XXX # Manually determine next version. `npm info @paulirish/trace_engine --registry https://registry.npmjs.org | grep latest` + 1
44
- npm publish --access public --dry-run # everything look good?
39
+ # Update chrome-devtools-mcp to latest, regenerate .d.ts & wrapper, and run tests + type-check
40
+ npm i chrome-devtools-mcp@latest
41
+ npm run build
42
+ npm test
43
+
44
+ # Bump version and dry-run publish
45
+ npm version patch
46
+ npm publish --access public --dry-run
45
47
 
46
- # do auth and publish
48
+ # Auth and publish
47
49
  npm whoami --registry https://registry.npmjs.org/ || npm login --registry https://registry.npmjs.org/
48
50
  npm publish --access public --registry https://registry.npmjs.org/
49
51
  ```
package/analyze-trace.mjs CHANGED
@@ -5,18 +5,8 @@
5
5
  import fs from 'node:fs';
6
6
  import zlib from 'node:zlib';
7
7
 
8
- /** @typedef {import('./models/trace/trace.ts')} Trace */
9
-
10
- // For types... see Connor's manual hack here:
11
- // https://github.com/GoogleChrome/lighthouse/pull/15703/files#diff-ec7e073cf0e6135d4f2af9bc04fe6100ec0df80ad1686bee2da53871be5f1a7b
12
- // and https://github.com/GoogleChrome/lighthouse/pull/15703/files#diff-6dab4507247217209f5ab0f6c343ca2b00af1300878abba81fb74d51cdfbedf9
13
- // But maybe all this kinda works, too?
14
-
15
- /** @type {Trace} */
16
8
  import * as Trace from './models/trace/trace.js';
17
9
 
18
- polyfillDOMRect();
19
-
20
10
  /**
21
11
  * @param {Trace.Types.Events.Event[]} traceEvents
22
12
  * @returns {Promise<{parsedTrace: Trace.TraceModel.ParsedTrace, model: Trace.TraceModel.Model}>}
@@ -81,7 +71,7 @@ function loadTraceEventsFromFile(filename) {
81
71
  /**
82
72
  * Read the first 3 bytes looking for the gzip signature in the file header
83
73
  * https://www.rfc-editor.org/rfc/rfc1952#page-6
84
- * @param {ArrayBuffer} ab
74
+ * @param {ArrayBuffer|Uint8Array} ab
85
75
  * @returns boolean
86
76
  */
87
77
  function isGzip(ab) {
@@ -92,137 +82,9 @@ function isGzip(ab) {
92
82
  return buf[0] === 0x1F && buf[1] === 0x8B && buf[2] === 0x08;
93
83
  }
94
84
 
95
- export function polyfillDOMRect() {
96
- // devtools assumes clientside :(
97
-
98
- // Everything else in here is the DOMRect polyfill
99
- // https://raw.githubusercontent.com/JakeChampion/polyfill-library/master/polyfills/DOMRect/polyfill.js
100
-
101
- (function(global) {
102
- /** @param {number=} v */
103
- function number(v) {
104
- return v === undefined ? 0 : Number(v);
105
- }
106
- /**
107
- * @param {number} u
108
- * @param {number} v
109
- */
110
- function different(u, v) {
111
- return u !== v && !(isNaN(u) && isNaN(v));
112
- }
113
-
114
- /**
115
- * @param {number} xArg
116
- * @param {number} yArg
117
- * @param {number} wArg
118
- * @param {number} hArg
119
- * @this {DOMRect}
120
- */
121
- function DOMRect(xArg, yArg, wArg, hArg) {
122
- let /** @type {number} */ x;
123
- let /** @type {number} */ y;
124
- let /** @type {number} */ width;
125
- let /** @type {number} */ height;
126
- let /** @type {number=} */ left;
127
- let /** @type {number=} */ right;
128
- let /** @type {number=} */ top;
129
- let /** @type {number=} */ bottom;
130
-
131
- x = number(xArg);
132
- y = number(yArg);
133
- width = number(wArg);
134
- height = number(hArg);
135
-
136
- Object.defineProperties(this, {
137
- x: {
138
- get: function() {
139
- return x;
140
- },
141
- /** @param {number} newX */
142
- set: function(newX) {
143
- if (different(x, newX)) {
144
- x = newX;
145
- left = right = undefined;
146
- }
147
- },
148
- enumerable: true
149
- },
150
- y: {
151
- get: function() {
152
- return y;
153
- },
154
- set: function(newY) {
155
- if (different(y, newY)) {
156
- y = newY;
157
- top = bottom = undefined;
158
- }
159
- },
160
- enumerable: true
161
- },
162
- width: {
163
- get: function() {
164
- return width;
165
- },
166
- set: function(newWidth) {
167
- if (different(width, newWidth)) {
168
- width = newWidth;
169
- left = right = undefined;
170
- }
171
- },
172
- enumerable: true
173
- },
174
- height: {
175
- get: function() {
176
- return height;
177
- },
178
- set: function(newHeight) {
179
- if (different(height, newHeight)) {
180
- height = newHeight;
181
- top = bottom = undefined;
182
- }
183
- },
184
- enumerable: true
185
- },
186
- left: {
187
- get: function() {
188
- if (left === undefined) {
189
- left = x + Math.min(0, width);
190
- }
191
- return left;
192
- },
193
- enumerable: true
194
- },
195
- right: {
196
- get: function() {
197
- if (right === undefined) {
198
- right = x + Math.max(0, width);
199
- }
200
- return right;
201
- },
202
- enumerable: true
203
- },
204
- top: {
205
- get: function() {
206
- if (top === undefined) {
207
- top = y + Math.min(0, height);
208
- }
209
- return top;
210
- },
211
- enumerable: true
212
- },
213
- bottom: {
214
- get: function() {
215
- if (bottom === undefined) {
216
- bottom = y + Math.max(0, height);
217
- }
218
- return bottom;
219
- },
220
- enumerable: true
221
- }
222
- });
223
- }
85
+ /**
86
+ * Obsolete: DevTools Trace Engine no longer references browser DOMRect.
87
+ * Retained as a no-op for backward compatibility.
88
+ */
89
+ export function polyfillDOMRect() {}
224
90
 
225
- // @ts-expect-error It's not identical.
226
- globalThis.DOMRect = DOMRect;
227
- })(globalThis);
228
- }
@@ -0,0 +1,12 @@
1
+ export declare const BASE64_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
2
+ export declare const BASE64_CODES: Uint8Array;
3
+ /**
4
+ * Decodes Base64-encoded data from a string without performing any kind of checking.
5
+ */
6
+ export declare function decode(input: string): Uint8Array<ArrayBuffer>;
7
+ export type BlobPart = ArrayBufferLike | Uint8Array | Blob | string;
8
+ /**
9
+ * Note: if input can be very large (larger than the max string size), callers should
10
+ * expect this to throw an error.
11
+ */
12
+ export declare function encode(input: BlobPart): Promise<string>;
@@ -0,0 +1,5 @@
1
+ export declare class CharacterIdMap<T> {
2
+ #private;
3
+ toChar(object: T): string;
4
+ fromChar(character: string): T | null;
5
+ }
@@ -0,0 +1,357 @@
1
+ import { type Color3D, type Color4D, type Color4DOr3D } from './ColorUtils.js';
2
+ /** Returns the `Format` equivalent from the format text **/
3
+ export declare function getFormat(formatText: string): Format | null;
4
+ type ColorSpace = Format.SRGB | Format.SRGB_LINEAR | Format.DISPLAY_P3 | Format.DISPLAY_P3_LINEAR | Format.A98_RGB | Format.PROPHOTO_RGB | Format.REC_2020 | Format.XYZ | Format.XYZ_D50 | Format.XYZ_D65;
5
+ export declare const enum ColorChannel {
6
+ A = "a",
7
+ ALPHA = "alpha",
8
+ B = "b",
9
+ C = "c",
10
+ G = "g",
11
+ H = "h",
12
+ L = "l",
13
+ R = "r",
14
+ S = "s",
15
+ W = "w",
16
+ X = "x",
17
+ Y = "y",
18
+ Z = "z"
19
+ }
20
+ export declare function parse(text: string): Color | null;
21
+ export declare function parseHueNumeric(value: string): number | null;
22
+ export declare function hsl2rgb(hsl: Color4D): Color4D;
23
+ export declare function hsva2rgba(hsva: Color4D): Color4D;
24
+ export declare function rgb2hsv(rgba: Color3D): Color3D;
25
+ /**
26
+ * Compute a desired luminance given a given luminance and a desired contrast
27
+ * ratio.
28
+ */
29
+ export declare function desiredLuminance(luminance: number, contrast: number, lighter: boolean): number;
30
+ /**
31
+ * Approach a value of the given component of `candidateHSVA` such that the
32
+ * calculated luminance of `candidateHSVA` approximates `desiredLuminance`.
33
+ */
34
+ export declare function approachColorValue(candidateHSVA: Color4D, index: number, desiredLuminance: number, candidateLuminance: (arg0: Color4D) => number): number | null;
35
+ export declare function findFgColorForContrast(fgColor: Legacy, bgColor: Legacy, requiredContrast: number): Legacy | null;
36
+ export declare function findFgColorForContrastAPCA(fgColor: Legacy, bgColor: Legacy, requiredContrast: number): Legacy | null;
37
+ type ColorParameterSpec = [string, string, string, string | undefined];
38
+ interface ColorConversions<T = void> {
39
+ [Format.HEX](self: T): Legacy;
40
+ [Format.HEXA](self: T): Legacy;
41
+ [Format.RGB](self: T): Legacy;
42
+ [Format.RGBA](self: T): Legacy;
43
+ [Format.HSL](self: T): HSL;
44
+ [Format.HSLA](self: T): HSL;
45
+ [Format.HWB](self: T): HWB;
46
+ [Format.HWBA](self: T): HWB;
47
+ [Format.LCH](self: T): LCH;
48
+ [Format.OKLCH](self: T): Oklch;
49
+ [Format.LAB](self: T): Lab;
50
+ [Format.OKLAB](self: T): Oklab;
51
+ [Format.SRGB](self: T): ColorFunction;
52
+ [Format.SRGB_LINEAR](self: T): ColorFunction;
53
+ [Format.DISPLAY_P3](self: T): ColorFunction;
54
+ [Format.DISPLAY_P3_LINEAR](self: T): ColorFunction;
55
+ [Format.A98_RGB](self: T): ColorFunction;
56
+ [Format.PROPHOTO_RGB](self: T): ColorFunction;
57
+ [Format.REC_2020](self: T): ColorFunction;
58
+ [Format.XYZ](self: T): ColorFunction;
59
+ [Format.XYZ_D50](self: T): ColorFunction;
60
+ [Format.XYZ_D65](self: T): ColorFunction;
61
+ }
62
+ export interface Color {
63
+ readonly alpha: number | null;
64
+ readonly channels: [ColorChannel, ColorChannel, ColorChannel, ColorChannel];
65
+ equal(color: Color): boolean;
66
+ asString(format?: Format): string;
67
+ setAlpha(alpha: number): Color;
68
+ format(): Format;
69
+ as<T extends Format>(format: T): ReturnType<ColorConversions[T]>;
70
+ is<T extends Format>(format: T): this is ReturnType<ColorConversions[T]>;
71
+ asLegacyColor(): Legacy;
72
+ getAuthoredText(): string | null;
73
+ getRawParameters(): Color3D;
74
+ getAsRawString(format?: Format): string;
75
+ isGamutClipped(): boolean;
76
+ }
77
+ export declare const enum Format {
78
+ HEX = "hex",
79
+ HEXA = "hexa",
80
+ RGB = "rgb",
81
+ RGBA = "rgba",
82
+ HSL = "hsl",
83
+ HSLA = "hsla",
84
+ HWB = "hwb",
85
+ HWBA = "hwba",
86
+ LCH = "lch",
87
+ OKLCH = "oklch",
88
+ LAB = "lab",
89
+ OKLAB = "oklab",
90
+ SRGB = "srgb",
91
+ SRGB_LINEAR = "srgb-linear",
92
+ DISPLAY_P3 = "display-p3",
93
+ DISPLAY_P3_LINEAR = "display-p3-linear",
94
+ A98_RGB = "a98-rgb",
95
+ PROPHOTO_RGB = "prophoto-rgb",
96
+ REC_2020 = "rec2020",
97
+ XYZ = "xyz",
98
+ XYZ_D50 = "xyz-d50",
99
+ XYZ_D65 = "xyz-d65"
100
+ }
101
+ export declare class Lab implements Color {
102
+ #private;
103
+ readonly l: number;
104
+ readonly a: number;
105
+ readonly b: number;
106
+ readonly alpha: number | null;
107
+ readonly channels: [ColorChannel, ColorChannel, ColorChannel, ColorChannel];
108
+ constructor(l: number, a: number, b: number, alpha: number | null, authoredText?: string);
109
+ is<T extends Format>(format: T): this is ReturnType<ColorConversions[T]>;
110
+ as<T extends Format>(format: T): ReturnType<ColorConversions[T]>;
111
+ asLegacyColor(): Legacy;
112
+ equal(color: Color): boolean;
113
+ format(): Format;
114
+ setAlpha(alpha: number): Lab;
115
+ asString(format?: Format): string;
116
+ getAuthoredText(): string | null;
117
+ getRawParameters(): Color3D;
118
+ getAsRawString(format?: Format): string;
119
+ isGamutClipped(): boolean;
120
+ static fromSpec(spec: ColorParameterSpec, text: string): Lab | null;
121
+ }
122
+ export declare class LCH implements Color {
123
+ #private;
124
+ readonly l: number;
125
+ readonly c: number;
126
+ readonly h: number;
127
+ readonly alpha: number | null;
128
+ readonly channels: [ColorChannel, ColorChannel, ColorChannel, ColorChannel];
129
+ constructor(l: number, c: number, h: number, alpha: number | null, authoredText?: string);
130
+ asLegacyColor(): Legacy;
131
+ is<T extends Format>(format: T): this is ReturnType<ColorConversions[T]>;
132
+ as<T extends Format>(format: T): ReturnType<ColorConversions[T]>;
133
+ equal(color: Color): boolean;
134
+ format(): Format;
135
+ setAlpha(alpha: number): Color;
136
+ asString(format?: Format): string;
137
+ getAuthoredText(): string | null;
138
+ getRawParameters(): Color3D;
139
+ getAsRawString(format?: Format): string;
140
+ isGamutClipped(): boolean;
141
+ isHuePowerless(): boolean;
142
+ static fromSpec(spec: ColorParameterSpec, text: string): LCH | null;
143
+ }
144
+ export declare class Oklab implements Color {
145
+ #private;
146
+ readonly l: number;
147
+ readonly a: number;
148
+ readonly b: number;
149
+ readonly alpha: number | null;
150
+ readonly channels: [ColorChannel, ColorChannel, ColorChannel, ColorChannel];
151
+ constructor(l: number, a: number, b: number, alpha: number | null, authoredText?: string);
152
+ asLegacyColor(): Legacy;
153
+ is<T extends Format>(format: T): this is ReturnType<ColorConversions[T]>;
154
+ as<T extends Format>(format: T): ReturnType<ColorConversions[T]>;
155
+ equal(color: Color): boolean;
156
+ format(): Format;
157
+ setAlpha(alpha: number): Color;
158
+ asString(format?: Format): string;
159
+ getAuthoredText(): string | null;
160
+ getRawParameters(): Color3D;
161
+ getAsRawString(format?: Format): string;
162
+ isGamutClipped(): boolean;
163
+ static fromSpec(spec: ColorParameterSpec, text: string): Oklab | null;
164
+ }
165
+ export declare class Oklch implements Color {
166
+ #private;
167
+ readonly l: number;
168
+ readonly c: number;
169
+ readonly h: number;
170
+ readonly alpha: number | null;
171
+ readonly channels: [ColorChannel, ColorChannel, ColorChannel, ColorChannel];
172
+ constructor(l: number, c: number, h: number, alpha: number | null, authoredText?: string);
173
+ asLegacyColor(): Legacy;
174
+ is<T extends Format>(format: T): this is ReturnType<ColorConversions[T]>;
175
+ as<T extends Format>(format: T): ReturnType<ColorConversions[T]>;
176
+ equal(color: Color): boolean;
177
+ format(): Format;
178
+ setAlpha(alpha: number): Color;
179
+ asString(format?: Format): string;
180
+ getAuthoredText(): string | null;
181
+ getRawParameters(): Color3D;
182
+ getAsRawString(format?: Format): string;
183
+ isGamutClipped(): boolean;
184
+ static fromSpec(spec: ColorParameterSpec, text: string): Oklch | null;
185
+ }
186
+ export declare class ColorFunction implements Color {
187
+ #private;
188
+ readonly p0: number;
189
+ readonly p1: number;
190
+ readonly p2: number;
191
+ readonly alpha: number | null;
192
+ readonly colorSpace: ColorSpace;
193
+ get channels(): [ColorChannel, ColorChannel, ColorChannel, ColorChannel];
194
+ constructor(colorSpace: ColorSpace, p0: number, p1: number, p2: number, alpha: number | null, authoredText?: string);
195
+ asLegacyColor(): Legacy;
196
+ is<T extends Format>(format: T): this is ReturnType<ColorConversions[T]>;
197
+ as<T extends Format>(format: T): ReturnType<ColorConversions[T]>;
198
+ equal(color: Color): boolean;
199
+ format(): Format;
200
+ setAlpha(alpha: number): Color;
201
+ asString(format?: Format): string;
202
+ getAuthoredText(): string | null;
203
+ getRawParameters(): Color3D;
204
+ getAsRawString(format?: Format): string;
205
+ isGamutClipped(): boolean;
206
+ isXYZ(): boolean;
207
+ /**
208
+ * Parses given `color()` function definition and returns the `Color` object.
209
+ * We want to special case its parsing here because it's a bit different
210
+ * than other color functions: rgb, lch etc. accepts 3 arguments with
211
+ * optional alpha. This accepts 4 arguments with optional alpha.
212
+ *
213
+ * Instead of making `splitColorFunctionParameters` work for this case too
214
+ * I've decided to implement it specifically.
215
+ * @param authoredText Original definition of the color with `color`
216
+ * @param parametersText Inside of the `color()` function. ex, `display-p3 0.1 0.2 0.3 / 0%`
217
+ * @returns `Color` object
218
+ */
219
+ static fromSpec(authoredText: string, parametersWithAlphaText: string): ColorFunction | null;
220
+ }
221
+ export declare class HSL implements Color {
222
+ #private;
223
+ readonly h: number;
224
+ readonly s: number;
225
+ readonly l: number;
226
+ readonly alpha: number | null;
227
+ readonly channels: [ColorChannel, ColorChannel, ColorChannel, ColorChannel];
228
+ constructor(h: number, s: number, l: number, alpha?: number | null, authoredText?: string);
229
+ equal(color: Color): boolean;
230
+ asString(format?: Format): string;
231
+ setAlpha(alpha: number): HSL;
232
+ format(): Format;
233
+ is<T extends Format>(format: T): this is ReturnType<ColorConversions[T]>;
234
+ as<T extends Format>(format: T): ReturnType<ColorConversions[T]>;
235
+ asLegacyColor(): Legacy;
236
+ getAuthoredText(): string | null;
237
+ getRawParameters(): Color3D;
238
+ getAsRawString(format?: Format): string;
239
+ isGamutClipped(): boolean;
240
+ static fromSpec(spec: ColorParameterSpec, text: string): HSL | null;
241
+ hsva(): Color4D;
242
+ canonicalHSLA(): number[];
243
+ }
244
+ export declare class HWB implements Color {
245
+ #private;
246
+ readonly h: number;
247
+ readonly w: number;
248
+ readonly b: number;
249
+ readonly alpha: number | null;
250
+ readonly channels: [ColorChannel, ColorChannel, ColorChannel, ColorChannel];
251
+ constructor(h: number, w: number, b: number, alpha: number | null, authoredText?: string);
252
+ equal(color: Color): boolean;
253
+ asString(format?: Format): string;
254
+ setAlpha(alpha: number): HWB;
255
+ format(): Format;
256
+ is<T extends Format>(format: T): this is ReturnType<ColorConversions[T]>;
257
+ as<T extends Format>(format: T): ReturnType<ColorConversions[T]>;
258
+ asLegacyColor(): Legacy;
259
+ getAuthoredText(): string | null;
260
+ canonicalHWBA(): number[];
261
+ getRawParameters(): Color3D;
262
+ getAsRawString(format?: Format): string;
263
+ isGamutClipped(): boolean;
264
+ static fromSpec(spec: ColorParameterSpec, text: string): HWB | null;
265
+ }
266
+ type LegacyColor = Format.HEX | Format.HEXA | Format.RGB | Format.RGBA;
267
+ declare abstract class ShortFormatColorBase implements Color {
268
+ protected readonly color: Legacy;
269
+ readonly channels: [ColorChannel, ColorChannel, ColorChannel, ColorChannel];
270
+ constructor(color: Legacy);
271
+ get alpha(): number | null;
272
+ rgba(): Color4D;
273
+ equal(color: Color): boolean;
274
+ setAlpha(alpha: number): Color;
275
+ format(): Format;
276
+ as<T extends Format>(format: T): ReturnType<ColorConversions<void>[T]>;
277
+ is<T extends Format>(format: T): this is ReturnType<ColorConversions<void>[T]>;
278
+ asLegacyColor(): Legacy;
279
+ getAuthoredText(): string | null;
280
+ getRawParameters(): Color3D;
281
+ isGamutClipped(): boolean;
282
+ asString(format?: Format): string;
283
+ getAsRawString(format?: Format): string;
284
+ protected abstract stringify(r: number, g: number, b: number): string;
285
+ }
286
+ export declare class ShortHex extends ShortFormatColorBase {
287
+ setAlpha(alpha: number): Color;
288
+ asString(format?: Format): string;
289
+ protected stringify(r: number, g: number, b: number): string;
290
+ }
291
+ export declare class Nickname extends ShortFormatColorBase {
292
+ readonly nickname: string;
293
+ constructor(nickname: string, color: Legacy);
294
+ static fromName(name: string, text: string): Nickname | null;
295
+ protected stringify(): string;
296
+ getAsRawString(format?: Format): string;
297
+ }
298
+ export declare class Legacy implements Color {
299
+ #private;
300
+ readonly channels: [ColorChannel, ColorChannel, ColorChannel, ColorChannel];
301
+ get alpha(): number | null;
302
+ asLegacyColor(): Legacy;
303
+ nickname(): Nickname | null;
304
+ shortHex(): ShortHex | null;
305
+ constructor(rgba: Color3D | Color4DOr3D, format: LegacyColor, authoredText?: string);
306
+ static fromHex(hex: string, text: string): Legacy | ShortHex;
307
+ static fromRGBAFunction(r: string, g: string, b: string, alpha: string, text: string): Legacy | null;
308
+ static fromRGBA(rgba: number[], authoredText?: string): Legacy;
309
+ static fromHSVA(hsva: Color4D): Legacy;
310
+ is<T extends Format>(format: T): this is ReturnType<ColorConversions[T]>;
311
+ as<T extends Format>(format: T): ReturnType<ColorConversions[T]>;
312
+ format(): LegacyColor;
313
+ hasAlpha(): boolean;
314
+ detectHEXFormat(): Format;
315
+ asString(format?: Format): string;
316
+ getAuthoredText(): string | null;
317
+ getRawParameters(): Color3D;
318
+ getAsRawString(format?: Format): string;
319
+ isGamutClipped(): boolean;
320
+ rgba(): Color4D;
321
+ canonicalRGBA(): Color4D;
322
+ toProtocolRGBA(): {
323
+ r: number;
324
+ g: number;
325
+ b: number;
326
+ a?: number;
327
+ };
328
+ invert(): Legacy;
329
+ /**
330
+ * Returns a new color using the NTSC formula for making a RGB color grayscale.
331
+ * Note: We override with an alpha of 50% to enhance the dimming effect.
332
+ */
333
+ grayscale(): Legacy;
334
+ setAlpha(alpha: number): Legacy;
335
+ blendWith(fgColor: Legacy): Legacy;
336
+ blendWithAlpha(alpha: number): Legacy;
337
+ setFormat(format: LegacyColor): void;
338
+ equal(other: Color): boolean;
339
+ }
340
+ export declare const Nicknames: Map<string, number[]>;
341
+ export declare const PageHighlight: Record<string, Legacy>;
342
+ export declare const SourceOrderHighlight: Record<string, Legacy>;
343
+ export declare const IsolationModeHighlight: Record<string, Legacy>;
344
+ type Space = number | {
345
+ min: number;
346
+ max: number;
347
+ count?: number;
348
+ };
349
+ export declare class Generator {
350
+ #private;
351
+ constructor(hueSpace?: Space, satSpace?: Space, lightnessSpace?: Space, alphaSpace?: Space);
352
+ setColorForID(id: string, color: string): void;
353
+ colorForID(id: string): string;
354
+ private generateColorForID;
355
+ private indexToValueInSpace;
356
+ }
357
+ export {};
@@ -0,0 +1,26 @@
1
+ export declare class ColorConverter {
2
+ static labToXyzd50(l: number, a: number, b: number): [number, number, number];
3
+ static xyzd50ToLab(x: number, y: number, z: number): [number, number, number];
4
+ static oklabToXyzd65(l: number, a: number, b: number): [number, number, number];
5
+ static xyzd65ToOklab(x: number, y: number, z: number): [number, number, number];
6
+ static lchToLab(l: number, c: number, h: number | undefined): [number, number, number];
7
+ static labToLch(l: number, a: number, b: number): [number, number, number];
8
+ static displayP3ToXyzd50(r: number, g: number, b: number): [number, number, number];
9
+ static xyzd50ToDisplayP3(x: number, y: number, z: number): [number, number, number];
10
+ static displayP3LinearToXyzd50(r: number, g: number, b: number): [number, number, number];
11
+ static xyzd50ToDisplayP3Linear(x: number, y: number, z: number): [number, number, number];
12
+ static proPhotoToXyzd50(r: number, g: number, b: number): [number, number, number];
13
+ static xyzd50ToProPhoto(x: number, y: number, z: number): [number, number, number];
14
+ static adobeRGBToXyzd50(r: number, g: number, b: number): [number, number, number];
15
+ static xyzd50ToAdobeRGB(x: number, y: number, z: number): [number, number, number];
16
+ static rec2020ToXyzd50(r: number, g: number, b: number): [number, number, number];
17
+ static xyzd50ToRec2020(x: number, y: number, z: number): [number, number, number];
18
+ static xyzd50ToD65(x: number, y: number, z: number): [number, number, number];
19
+ static xyzd65ToD50(x: number, y: number, z: number): [number, number, number];
20
+ static xyzd50TosRGBLinear(x: number, y: number, z: number): [number, number, number];
21
+ static srgbLinearToXyzd50(r: number, g: number, b: number): [number, number, number];
22
+ static srgbToXyzd50(r: number, g: number, b: number): [number, number, number];
23
+ static xyzd50ToSrgb(x: number, y: number, z: number): [number, number, number];
24
+ static oklchToXyzd50(lInput: number, c: number, h: number): [number, number, number];
25
+ static xyzd50ToOklch(x: number, y: number, z: number): [number, number, number];
26
+ }
@@ -0,0 +1,45 @@
1
+ /**
2
+ * Combine the two given colors according to alpha blending.
3
+ */
4
+ export type Color4D = [number, number, number, number];
5
+ export type Color3D = [number, number, number];
6
+ export type Color4DOr3D = [number, number, number, number | undefined];
7
+ export declare function blendColors(fgRGBA: Color4D, bgRGBA: Color4D): Color4D;
8
+ export declare function rgbToHsl(rgb: Color3D): Color3D;
9
+ export declare function rgbaToHsla([r, g, b, a]: Color4DOr3D): Color4DOr3D;
10
+ export declare function rgbToHwb(rgb: Color3D): Color3D;
11
+ export declare function rgbaToHwba([r, g, b, a]: Color4DOr3D): Color4DOr3D;
12
+ /**
13
+ * Calculate the luminance of this color using the WCAG algorithm.
14
+ * See https://www.w3.org/TR/WCAG21/#dfn-relative-luminance.
15
+ */
16
+ export declare function luminance([rSRGB, gSRGB, bSRGB]: number[]): number;
17
+ /**
18
+ * Calculate the contrast ratio between a foreground and a background color.
19
+ * Returns the ratio to 1, for example for two two colors with a contrast ratio of 21:1, this function will return 21.
20
+ * See http://www.w3.org/TR/2008/REC-WCAG20-20081211/#contrast-ratiodef
21
+ */
22
+ export declare function contrastRatio(fgRGBA: Color4D, bgRGBA: Color4D): number;
23
+ /**
24
+ * Calculate relative luminance of a color.
25
+ * See https://github.com/Myndex/SAPC-APCA
26
+ */
27
+ export declare function luminanceAPCA([rSRGB, gSRGB, bSRGB]: number[]): number;
28
+ /**
29
+ * Calculate the contrast ratio between a foreground and a background color.
30
+ * Returns the percentage of the predicted visual contrast.
31
+ * See https://github.com/Myndex/SAPC-APCA
32
+ */
33
+ export declare function contrastRatioAPCA(fgRGBA: Color4D, bgRGBA: Color4D): number;
34
+ export declare function contrastRatioByLuminanceAPCA(fgLuminance: number, bgLuminance: number): number;
35
+ /**
36
+ * Compute a desired luminance given a given luminance and a desired contrast
37
+ * percentage according to APCA.
38
+ */
39
+ export declare function desiredLuminanceAPCA(luminance: number, contrast: number, lighter: boolean): number;
40
+ export declare function getAPCAThreshold(fontSize: string, fontWeight: string): number | null;
41
+ export declare function isLargeFont(fontSize: string, fontWeight: string): boolean;
42
+ export declare function getContrastThreshold(fontSize: string, fontWeight: string): {
43
+ aa: number;
44
+ aaa: number;
45
+ };