@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.
- package/README.md +19 -17
- package/analyze-trace.mjs +6 -144
- package/core/common/Base64.d.ts +12 -0
- package/core/common/CharacterIdMap.d.ts +5 -0
- package/core/common/Color.d.ts +357 -0
- package/core/common/ColorConverter.d.ts +26 -0
- package/core/common/ColorUtils.d.ts +45 -0
- package/core/common/Console.d.ts +54 -0
- package/core/common/Debouncer.d.ts +8 -0
- package/core/common/EventTarget.d.ts +22 -0
- package/core/common/Gzip.d.ts +23 -0
- package/core/common/JavaScriptMetaData.d.ts +20 -0
- package/core/common/Lazy.d.ts +4 -0
- package/core/common/MapWithDefault.d.ts +9 -0
- package/core/common/Mutex.d.ts +13 -0
- package/core/common/Object.d.ts +20 -0
- package/core/common/ParsedURL.d.ts +87 -0
- package/core/common/Progress.d.ts +47 -0
- package/core/common/ResolverBase.d.ts +29 -0
- package/core/common/ResourceType.d.ts +52 -0
- package/core/common/ReturnToPanel.d.ts +10 -0
- package/core/common/Revealer.d.ts +66 -0
- package/core/common/Runnable.d.ts +14 -0
- package/core/common/SegmentedRange.d.ts +14 -0
- package/core/common/SettingRegistration.d.ts +136 -0
- package/core/common/Settings.d.ts +226 -0
- package/core/common/SimpleHistoryManager.d.ts +20 -0
- package/core/common/Srcset.d.ts +16 -0
- package/core/common/StringOutputStream.d.ts +10 -0
- package/core/common/TextDictionary.d.ts +11 -0
- package/core/common/Throttler.d.ts +12 -0
- package/core/common/Trie.d.ts +24 -0
- package/core/common/VersionController.d.ts +85 -0
- package/core/common/common.d.ts +33 -1
- package/core/host/AidaClient.d.ts +73 -0
- package/core/host/AidaClientTypes.d.ts +355 -0
- package/core/host/AidaGcaTranslation.d.ts +10 -0
- package/core/host/DispatchHttpRequestClient.d.ts +14 -0
- package/core/host/GcaClient.d.ts +14 -0
- package/core/host/GcaTypes.d.ts +411 -0
- package/core/host/GdpClient.d.ts +84 -0
- package/core/host/InspectorFrontendHost.d.ts +29 -0
- package/core/host/InspectorFrontendHostAPI.d.ts +425 -0
- package/core/host/InspectorFrontendHostStub.d.ts +151 -0
- package/core/host/Platform.d.ts +11 -0
- package/core/host/ResourceLoader.d.ts +15 -0
- package/core/host/UserMetrics.d.ts +116 -0
- package/core/host/UserMetricsEnums.d.ts +883 -0
- package/core/host/host.d.ts +13 -1
- package/core/i18n/ByteUtilities.d.ts +11 -0
- package/core/i18n/DevToolsLocale.d.ts +41 -0
- package/core/i18n/NumberFormatter.d.ts +11 -0
- package/core/i18n/i18n.d.ts +10 -0
- package/core/i18n/i18nImpl.d.ts +64 -0
- package/core/i18n/i18nTypes.d.ts +5 -0
- package/core/i18n/locales.d.ts +15 -0
- package/core/i18n/time-utilities.d.ts +16 -0
- package/core/platform/ArrayUtilities.d.ts +5 -0
- package/core/platform/HostRuntime.d.ts +1 -0
- package/core/platform/Size.d.ts +12 -0
- package/core/platform/StringUtilities.d.ts +28 -0
- package/core/platform/TypescriptUtilities.d.ts +0 -6
- package/core/platform/api/HostRuntime.d.ts +25 -0
- package/core/platform/platform.d.ts +2 -1
- package/core/protocol_client/CDPConnection.d.ts +77 -0
- package/core/protocol_client/ConnectionTransport.d.ts +9 -0
- package/core/protocol_client/DevToolsCDPConnection.d.ts +16 -0
- package/core/protocol_client/InspectorBackend.d.ts +223 -0
- package/core/protocol_client/protocol_client.d.ts +5 -0
- package/core/root/DevToolsContext.d.ts +34 -0
- package/core/root/ExperimentNames.d.ts +8 -0
- package/core/root/Runtime.d.ts +351 -0
- package/core/root/root.d.ts +4 -1
- package/core/sdk/AccessibilityModel.d.ts +76 -0
- package/core/sdk/AnimationModel.d.ts +161 -0
- package/core/sdk/AutofillModel.d.ts +23 -0
- package/core/sdk/CPUProfilerModel.d.ts +46 -0
- package/core/sdk/CPUThrottlingManager.d.ts +47 -0
- package/core/sdk/CSSContainerQuery.d.ts +42 -0
- package/core/sdk/CSSFontFace.d.ts +10 -0
- package/core/sdk/CSSLayer.d.ts +9 -0
- package/core/sdk/CSSLocation.d.ts +14 -0
- package/core/sdk/CSSMatchedStyles.d.ts +138 -0
- package/core/sdk/CSSMedia.d.ts +36 -0
- package/core/sdk/CSSMetadata.d.ts +87 -0
- package/core/sdk/CSSModel.d.ts +180 -0
- package/core/sdk/CSSNavigation.d.ts +10 -0
- package/core/sdk/CSSProperty.d.ts +53 -0
- package/core/sdk/CSSPropertyParser.d.ts +131 -0
- package/core/sdk/CSSPropertyParserMatchers.d.ts +442 -0
- package/core/sdk/CSSQuery.d.ts +22 -0
- package/core/sdk/CSSRule.d.ts +132 -0
- package/core/sdk/CSSScope.d.ts +9 -0
- package/core/sdk/CSSStartingStyle.d.ts +9 -0
- package/core/sdk/CSSStyleDeclaration.d.ts +38 -0
- package/core/sdk/CSSStyleSheetHeader.d.ts +53 -0
- package/core/sdk/CSSSupports.d.ts +10 -0
- package/core/sdk/CategorizedBreakpoint.d.ts +42 -0
- package/core/sdk/ChildTargetManager.d.ts +40 -0
- package/core/sdk/CompilerSourceMappingContentProvider.d.ts +12 -0
- package/core/sdk/Connections.d.ts +36 -0
- package/core/sdk/ConsoleModel.d.ts +127 -0
- package/core/sdk/ConsoleModelTypes.d.ts +6 -0
- package/core/sdk/Cookie.d.ts +68 -0
- package/core/sdk/CookieModel.d.ts +31 -0
- package/core/sdk/CookieParser.d.ts +14 -0
- package/core/sdk/CrashReportContextModel.d.ts +8 -0
- package/core/sdk/DOMDebuggerModel.d.ts +127 -0
- package/core/sdk/DOMModel.d.ts +436 -0
- package/core/sdk/DOMStorageModel.d.ts +79 -0
- package/core/sdk/DebuggerModel.d.ts +272 -0
- package/core/sdk/EmulationModel.d.ts +95 -0
- package/core/sdk/EnhancedTracesParser.d.ts +105 -0
- package/core/sdk/EventBreakpointsModel.d.ts +66 -0
- package/core/sdk/FrameAssociated.d.ts +6 -0
- package/core/sdk/FrameManager.d.ts +68 -0
- package/core/sdk/HeapProfilerModel.d.ts +75 -0
- package/core/sdk/HttpReasonPhraseStrings.d.ts +5 -0
- package/core/sdk/IOModel.d.ts +10 -0
- package/core/sdk/IsolateManager.d.ts +53 -0
- package/core/sdk/IssuesModel.d.ts +28 -0
- package/core/sdk/LayerTreeBase.d.ts +70 -0
- package/core/sdk/LogModel.d.ts +20 -0
- package/core/sdk/NetworkManager.d.ts +418 -0
- package/core/sdk/NetworkRequest.d.ts +469 -0
- package/core/sdk/NetworkRequestAccess.d.ts +91 -0
- package/core/sdk/OverlayColorGenerator.d.ts +14 -0
- package/core/sdk/OverlayModel.d.ts +186 -0
- package/core/sdk/OverlayPersistentHighlighter.d.ts +116 -0
- package/core/sdk/PageFunctions.d.ts +22 -0
- package/core/sdk/PageLoad.d.ts +14 -0
- package/core/sdk/PageResourceLoader.d.ts +111 -0
- package/core/sdk/PaintProfiler.d.ts +43 -0
- package/core/sdk/PerformanceMetricsModel.d.ts +12 -0
- package/core/sdk/PreloadingModel.d.ts +146 -0
- package/core/sdk/RehydratingConnection.d.ts +73 -0
- package/core/sdk/RehydratingObject.d.ts +59 -0
- package/core/sdk/RemoteObject.d.ts +210 -0
- package/core/sdk/Resource.d.ts +36 -0
- package/core/sdk/ResourceTreeModel.d.ts +278 -0
- package/core/sdk/RuntimeModel.d.ts +163 -0
- package/core/sdk/SDKModel.d.ts +30 -0
- package/core/sdk/SDKSettings.d.ts +53 -0
- package/core/sdk/ScopeTreeCache.d.ts +21 -0
- package/core/sdk/ScreenCaptureModel.d.ts +69 -0
- package/core/sdk/Script.d.ts +134 -0
- package/core/sdk/SecurityOrigin.d.ts +108 -0
- package/core/sdk/SecurityOriginManager.d.ts +23 -0
- package/core/sdk/ServerSentEvents.d.ts +18 -0
- package/core/sdk/ServerSentEventsProtocol.d.ts +18 -0
- package/core/sdk/ServerTiming.d.ts +24 -0
- package/core/sdk/ServiceWorkerCacheModel.d.ts +71 -0
- package/core/sdk/ServiceWorkerManager.d.ts +125 -0
- package/core/sdk/SourceMap.d.ts +197 -0
- package/core/sdk/SourceMapCache.d.ts +12 -0
- package/core/sdk/SourceMapFunctionRanges.d.ts +26 -0
- package/core/sdk/SourceMapManager.d.ts +46 -0
- package/core/sdk/SourceMapRangeMappings.d.ts +15 -0
- package/core/sdk/SourceMapScopeChainEntry.d.ts +23 -0
- package/core/sdk/SourceMapScopesInfo.d.ts +109 -0
- package/core/sdk/StorageBucketsModel.d.ts +48 -0
- package/core/sdk/StorageKeyManager.d.ts +38 -0
- package/core/sdk/Target.d.ts +79 -0
- package/core/sdk/TargetManager.d.ts +92 -0
- package/core/sdk/TraceObject.d.ts +43 -0
- package/core/sdk/WebAuthnModel.d.ts +29 -0
- package/core/sdk/sdk.d.ts +97 -1
- package/core/text_utils/CodeMirrorUtils.d.ts +3 -0
- package/core/text_utils/ContentData.d.ts +94 -0
- package/core/text_utils/ContentProvider.d.ts +42 -0
- package/core/text_utils/StaticContentProvider.d.ts +13 -0
- package/core/text_utils/StreamingContentData.d.ts +49 -0
- package/core/text_utils/Text.d.ts +19 -0
- package/core/text_utils/TextCursor.d.ts +9 -0
- package/core/text_utils/TextRange.d.ts +81 -0
- package/core/text_utils/TextUtils.d.ts +97 -0
- package/core/text_utils/WasmDisassembly.d.ts +29 -0
- package/core/text_utils/text_utils.d.ts +11 -0
- package/entrypoints/formatter_actions/formatter_actions.d.ts +48 -0
- package/generated/InspectorBackendCommands.d.ts +14 -0
- package/generated/SupportedCSSProperties.d.ts +18 -0
- package/generated/protocol-mapping.d.ts +5930 -0
- package/generated/protocol-proxy-api.d.ts +5396 -0
- package/generated/protocol.d.ts +736 -685
- package/index.js +6 -0
- package/locales/af.json +80 -62
- package/locales/am.json +363 -345
- package/locales/ar.json +364 -346
- package/locales/as.json +362 -344
- package/locales/az.json +353 -335
- package/locales/be.json +363 -345
- package/locales/bg.json +363 -345
- package/locales/bn.json +363 -345
- package/locales/bs.json +259 -241
- package/locales/ca.json +295 -277
- package/locales/cs.json +348 -330
- package/locales/cy.json +139 -121
- package/locales/da.json +222 -204
- package/locales/de.json +234 -216
- package/locales/el.json +348 -330
- package/locales/en-GB.json +36 -18
- package/locales/es-419.json +290 -272
- package/locales/es.json +292 -274
- package/locales/et.json +251 -233
- package/locales/eu.json +29 -11
- package/locales/fa.json +363 -345
- package/locales/fi.json +295 -277
- package/locales/fil.json +29 -11
- package/locales/fr-CA.json +320 -302
- package/locales/fr.json +317 -299
- package/locales/gl.json +276 -258
- package/locales/gu.json +364 -346
- package/locales/he.json +364 -346
- package/locales/hi.json +348 -330
- package/locales/hr.json +250 -232
- package/locales/hu.json +354 -336
- package/locales/hy.json +363 -345
- package/locales/id.json +27 -9
- package/locales/is.json +317 -299
- package/locales/it.json +154 -136
- package/locales/ja.json +363 -345
- package/locales/ka.json +364 -346
- package/locales/kk.json +364 -346
- package/locales/km.json +363 -345
- package/locales/kn.json +364 -346
- package/locales/ko.json +363 -345
- package/locales/ky.json +362 -344
- package/locales/lo.json +364 -346
- package/locales/lt.json +331 -313
- package/locales/lv.json +331 -313
- package/locales/mk.json +364 -346
- package/locales/ml.json +363 -345
- package/locales/mn.json +363 -345
- package/locales/mr.json +363 -345
- package/locales/ms.json +27 -9
- package/locales/my.json +362 -344
- package/locales/ne.json +348 -330
- package/locales/nl.json +84 -66
- package/locales/no.json +188 -170
- package/locales/or.json +363 -345
- package/locales/pa.json +363 -345
- package/locales/pl.json +322 -304
- package/locales/pt-PT.json +284 -266
- package/locales/pt.json +283 -265
- package/locales/ro.json +318 -300
- package/locales/ru.json +363 -345
- package/locales/si.json +364 -346
- package/locales/sk.json +345 -327
- package/locales/sl.json +231 -213
- package/locales/sq.json +329 -311
- package/locales/sr-Latn.json +267 -249
- package/locales/sr.json +364 -346
- package/locales/sv.json +296 -278
- package/locales/sw.json +35 -17
- package/locales/ta.json +364 -346
- package/locales/te.json +362 -344
- package/locales/th.json +364 -346
- package/locales/tr.json +337 -319
- package/locales/uk.json +363 -345
- package/locales/ur.json +364 -346
- package/locales/uz.json +175 -157
- package/locales/vi.json +364 -346
- package/locales/zh-HK.json +364 -346
- package/locales/zh-TW.json +363 -345
- package/locales/zh.json +363 -345
- package/locales/zu.json +35 -17
- package/models/crux-manager/CrUXManager.d.ts +107 -0
- package/models/crux-manager/crux-manager.d.ts +1 -0
- package/models/emulation/DeviceModeModel.d.ts +156 -0
- package/models/emulation/EmulatedDevices.d.ts +148 -0
- package/models/emulation/emulation.d.ts +3 -0
- package/models/formatter/FormatterWorkerPool.d.ts +58 -0
- package/models/formatter/ScriptFormatter.d.ts +11 -0
- package/models/formatter/formatter.d.ts +3 -0
- package/models/trace/ModelImpl.d.ts +2 -6
- package/models/trace/Processor.d.ts +2 -6
- package/models/trace/extras/StackTraceForEvent.d.ts +1 -1
- package/models/trace/extras/extras.d.ts +2 -7
- package/models/trace/handlers/FramesHandler.d.ts +1 -2
- package/models/trace/handlers/LayoutShiftsHandler.d.ts +2 -2
- package/models/trace/handlers/MetaHandler.d.ts +2 -3
- package/models/trace/handlers/ModelHandlers.d.ts +0 -1
- package/models/trace/handlers/PageLoadMetricsHandler.d.ts +2 -0
- package/models/trace/handlers/ScriptsHandler.d.ts +2 -2
- package/models/trace/handlers/Threads.d.ts +1 -3
- package/models/trace/handlers/UserTimingsHandler.d.ts +1 -1
- package/models/trace/helpers/Network.d.ts +3 -1
- package/models/trace/helpers/SyntheticEvents.d.ts +7 -0
- package/models/trace/insights/CLSCulprits.d.ts +6 -3
- package/models/trace/insights/Cache.d.ts +2 -1
- package/models/trace/insights/CharacterSet.d.ts +5 -4
- package/models/trace/insights/Common.d.ts +4 -4
- package/models/trace/insights/DOMSize.d.ts +4 -3
- package/models/trace/insights/DocumentLatency.d.ts +2 -1
- package/models/trace/insights/DuplicatedJavaScript.d.ts +9 -4
- package/models/trace/insights/FontDisplay.d.ts +11 -5
- package/models/trace/insights/ForcedReflow.d.ts +6 -6
- package/models/trace/insights/INPBreakdown.d.ts +5 -5
- package/models/trace/insights/ImageDelivery.d.ts +7 -7
- package/models/trace/insights/LCPBreakdown.d.ts +4 -3
- package/models/trace/insights/LCPDiscovery.d.ts +7 -6
- package/models/trace/insights/LegacyJavaScript.d.ts +9 -4
- package/models/trace/insights/ModernHTTP.d.ts +6 -6
- package/models/trace/insights/NetworkDependencyTree.d.ts +18 -96
- package/models/trace/insights/RenderBlocking.d.ts +4 -3
- package/models/trace/insights/SlowCSSSelector.d.ts +10 -9
- package/models/trace/insights/ThirdParties.d.ts +17 -8
- package/models/trace/insights/Viewport.d.ts +6 -4
- package/models/trace/insights/types.d.ts +10 -7
- package/models/trace/lantern/lantern.js +6 -8
- package/models/trace/lantern/simulation/Constants.d.ts +29 -28
- package/models/trace/trace.js +529 -18
- package/models/trace/types/Configuration.d.ts +12 -1
- package/models/trace/types/File.d.ts +6 -5
- package/models/trace/types/Overlays.d.ts +13 -3
- package/models/trace/types/Timing.js +6 -14
- package/models/trace/types/TraceEvents.d.ts +48 -18
- package/models/trace/types/TraceEvents.js +187 -884
- package/models/trace/types/types.js +6 -8
- package/package.json +30 -9
- package/third_party/codemirror.next/codemirror.next.d.ts +9196 -0
- package/third_party/i18n/i18n-impl.d.ts +25 -0
- package/third_party/i18n/i18n.d.ts +3 -0
- package/third_party/i18n/localized-string-set.d.ts +49 -0
- package/third_party/intl-messageformat/intl-messageformat.d.ts +1 -0
- package/third_party/legacy-javascript/legacy-javascript.d.ts +2 -1
- package/third_party/legacy-javascript/lib/legacy-javascript.d.ts +18 -0
- package/third_party/source-map-scopes-codec/package/src/builder/builder.d.ts +67 -0
- package/third_party/source-map-scopes-codec/package/src/builder/safe_builder.d.ts +38 -0
- package/third_party/source-map-scopes-codec/package/src/codec.d.ts +48 -0
- package/third_party/source-map-scopes-codec/package/src/decode/decode.d.ts +31 -0
- package/third_party/source-map-scopes-codec/package/src/encode/encode.d.ts +8 -0
- package/third_party/source-map-scopes-codec/package/src/encode/encoder.d.ts +6 -0
- package/third_party/source-map-scopes-codec/package/src/mod.d.ts +5 -0
- package/third_party/source-map-scopes-codec/package/src/scopes.d.ts +168 -0
- package/third_party/source-map-scopes-codec/package/src/util.d.ts +5 -0
- package/third_party/source-map-scopes-codec/package/src/vlq.d.ts +14 -0
- package/third_party/source-map-scopes-codec/source-map-scopes-codec.d.ts +1 -0
- package/third_party/third-party-web/lib/nostats-subset.d.ts +2 -0
- package/third_party/third-party-web/package/lib/index.d.ts +34 -0
- package/third_party/third-party-web/package/lib/subsets/nostats.d.ts +1 -0
- package/third_party/third-party-web/third-party-web.d.ts +2 -1
- package/.tmp/tsbuildinfo/analyze-inspector-issues.d.mts +0 -13
- package/.tmp/tsbuildinfo/analyze-inspector-issues.d.mts.map +0 -1
- package/.tmp/tsbuildinfo/analyze-trace.d.mts +0 -17
- package/.tmp/tsbuildinfo/analyze-trace.d.mts.map +0 -1
- package/.tmp/tsbuildinfo/models/trace/extras/polyfills.d.ts +0 -4
- package/.tmp/tsbuildinfo/models/trace/extras/polyfills.d.ts.map +0 -1
- package/.tmp/tsbuildinfo/test/test-trace-engine.d.mts +0 -2
- package/.tmp/tsbuildinfo/test/test-trace-engine.d.mts.map +0 -1
- package/.tmp/tsbuildinfo/third_party/third-party-web/third-party-web.d.ts +0 -3
- package/.tmp/tsbuildinfo/third_party/third-party-web/third-party-web.d.ts.map +0 -1
- package/.tmp/tsbuildinfo/tsconfig.tsbuildinfo +0 -1
- package/analyze-inspector-issues.mjs +0 -60
- package/core/common/common.js +0 -1
- package/core/host/host.js +0 -1
- package/core/platform/ArrayUtilities.js +0 -210
- package/core/platform/ArrayUtilities.js.map +0 -1
- package/core/platform/Brand.js +0 -5
- package/core/platform/Brand.js.map +0 -1
- package/core/platform/Constructor.js +0 -5
- package/core/platform/Constructor.js.map +0 -1
- package/core/platform/DateUtilities.js +0 -14
- package/core/platform/DateUtilities.js.map +0 -1
- package/core/platform/DevToolsPath.js +0 -28
- package/core/platform/DevToolsPath.js.map +0 -1
- package/core/platform/HostRuntime.js +0 -31
- package/core/platform/HostRuntime.js.map +0 -1
- package/core/platform/KeyboardUtilities.js +0 -22
- package/core/platform/KeyboardUtilities.js.map +0 -1
- package/core/platform/MapUtilities.js +0 -80
- package/core/platform/MapUtilities.js.map +0 -1
- package/core/platform/MimeType.js +0 -144
- package/core/platform/MimeType.js.map +0 -1
- package/core/platform/NumberUtilities.js +0 -73
- package/core/platform/NumberUtilities.js.map +0 -1
- package/core/platform/StringUtilities.js +0 -594
- package/core/platform/StringUtilities.js.map +0 -1
- package/core/platform/Timing.js +0 -10
- package/core/platform/Timing.js.map +0 -1
- package/core/platform/TypedArrayUtilities.js +0 -158
- package/core/platform/TypedArrayUtilities.js.map +0 -1
- package/core/platform/TypescriptUtilities.js +0 -25
- package/core/platform/TypescriptUtilities.js.map +0 -1
- package/core/platform/UIString.js +0 -5
- package/core/platform/UIString.js.map +0 -1
- package/core/platform/UserVisibleError.js +0 -23
- package/core/platform/UserVisibleError.js.map +0 -1
- package/core/platform/api/HostRuntime.js +0 -5
- package/core/platform/api/HostRuntime.js.map +0 -1
- package/core/platform/api/api-tsconfig.json +0 -43
- package/core/platform/api/api.js +0 -6
- package/core/platform/api/api.js.map +0 -1
- package/core/platform/api/api_node_typecheck-tsconfig.json +0 -48
- package/core/platform/api/bundle-tsconfig.json +0 -1
- package/core/platform/api/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/core/platform/browser/HostRuntime.js +0 -75
- package/core/platform/browser/HostRuntime.js.map +0 -1
- package/core/platform/browser/browser-tsconfig.json +0 -48
- package/core/platform/browser/browser.js +0 -6
- package/core/platform/browser/browser.js.map +0 -1
- package/core/platform/browser/bundle-tsconfig.json +0 -1
- package/core/platform/browser/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/core/platform/bundle-tsconfig.json +0 -1
- package/core/platform/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/core/platform/node/HostRuntime.js +0 -82
- package/core/platform/node/HostRuntime.js.map +0 -1
- package/core/platform/node/bundle-tsconfig.json +0 -1
- package/core/platform/node/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/core/platform/node/node-tsconfig.json +0 -52
- package/core/platform/node/node.js +0 -6
- package/core/platform/node/node.js.map +0 -1
- package/core/platform/platform-tsconfig.json +0 -69
- package/core/platform/platform.js +0 -27
- package/core/platform/platform.js.map +0 -1
- package/core/platform/platform_node_typecheck-tsconfig.json +0 -74
- package/core/root/root.js +0 -1
- package/core/sdk/sdk.js +0 -1
- package/generated/protocol.js +0 -5
- package/locales/en-US.json +0 -1046
- package/locales/en-XL.json +0 -1046
- package/models/cpu_profile/CPUProfileDataModel.js +0 -517
- package/models/cpu_profile/CPUProfileDataModel.js.map +0 -1
- package/models/cpu_profile/ProfileTreeModel.js +0 -90
- package/models/cpu_profile/ProfileTreeModel.js.map +0 -1
- package/models/cpu_profile/bundle-tsconfig.json +0 -1
- package/models/cpu_profile/cpu_profile-tsconfig.json +0 -52
- package/models/cpu_profile/cpu_profile.js +0 -7
- package/models/cpu_profile/cpu_profile.js.map +0 -1
- package/models/cpu_profile/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/models/issues_manager/CheckFormsIssuesTrigger.d.ts +0 -1
- package/models/issues_manager/CheckFormsIssuesTrigger.js +0 -1
- package/models/issues_manager/ContrastCheckTrigger.d.ts +0 -1
- package/models/issues_manager/ContrastCheckTrigger.js +0 -1
- package/models/issues_manager/DeprecationIssue.d.ts +0 -1
- package/models/issues_manager/DeprecationIssue.js +0 -1
- package/models/issues_manager/IssueResolver.d.ts +0 -1
- package/models/issues_manager/IssueResolver.js +0 -1
- package/models/issues_manager/RelatedIssue.d.ts +0 -1
- package/models/issues_manager/RelatedIssue.js +0 -1
- package/models/issues_manager/SourceFrameIssuesManager.d.ts +0 -1
- package/models/issues_manager/SourceFrameIssuesManager.js +0 -1
- package/models/trace/EntityMapper.js +0 -133
- package/models/trace/EntityMapper.js.map +0 -1
- package/models/trace/EventsSerializer.js +0 -90
- package/models/trace/EventsSerializer.js.map +0 -1
- package/models/trace/LanternComputationData.js +0 -367
- package/models/trace/LanternComputationData.js.map +0 -1
- package/models/trace/LegacyTracingModel.d.ts +0 -1
- package/models/trace/LegacyTracingModel.js +0 -1
- package/models/trace/ModelImpl.js +0 -170
- package/models/trace/ModelImpl.js.map +0 -1
- package/models/trace/Name.js +0 -115
- package/models/trace/Name.js.map +0 -1
- package/models/trace/Processor.js +0 -556
- package/models/trace/Processor.js.map +0 -1
- package/models/trace/Styles.js +0 -824
- package/models/trace/Styles.js.map +0 -1
- package/models/trace/TracingManager.d.ts +0 -1
- package/models/trace/TracingManager.js +0 -1
- package/models/trace/bundle-tsconfig.json +0 -1
- package/models/trace/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -66
- package/models/trace/extras/FilmStrip.js +0 -45
- package/models/trace/extras/FilmStrip.js.map +0 -1
- package/models/trace/extras/Initiators.js +0 -47
- package/models/trace/extras/Initiators.js.map +0 -1
- package/models/trace/extras/MainThreadActivity.js +0 -77
- package/models/trace/extras/MainThreadActivity.js.map +0 -1
- package/models/trace/extras/ScriptDuplication.js +0 -163
- package/models/trace/extras/ScriptDuplication.js.map +0 -1
- package/models/trace/extras/StackTraceForEvent.js +0 -192
- package/models/trace/extras/StackTraceForEvent.js.map +0 -1
- package/models/trace/extras/ThirdParties.js +0 -119
- package/models/trace/extras/ThirdParties.js.map +0 -1
- package/models/trace/extras/TraceFilter.js +0 -51
- package/models/trace/extras/TraceFilter.js.map +0 -1
- package/models/trace/extras/TraceTree.js +0 -621
- package/models/trace/extras/TraceTree.js.map +0 -1
- package/models/trace/extras/bundle-tsconfig.json +0 -1
- package/models/trace/extras/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/models/trace/extras/extras-tsconfig.json +0 -70
- package/models/trace/extras/extras.js +0 -13
- package/models/trace/extras/extras.js.map +0 -1
- package/models/trace/handlers/AnimationFramesHandler.js +0 -110
- package/models/trace/handlers/AnimationFramesHandler.js.map +0 -1
- package/models/trace/handlers/AnimationHandler.js +0 -27
- package/models/trace/handlers/AnimationHandler.js.map +0 -1
- package/models/trace/handlers/AsyncJSCallsHandler.js +0 -188
- package/models/trace/handlers/AsyncJSCallsHandler.js.map +0 -1
- package/models/trace/handlers/AuctionWorkletsHandler.d.ts +0 -8
- package/models/trace/handlers/AuctionWorkletsHandler.js +0 -163
- package/models/trace/handlers/AuctionWorkletsHandler.js.map +0 -1
- package/models/trace/handlers/DOMStatsHandler.js +0 -22
- package/models/trace/handlers/DOMStatsHandler.js.map +0 -1
- package/models/trace/handlers/ExtensionTraceDataHandler.js +0 -264
- package/models/trace/handlers/ExtensionTraceDataHandler.js.map +0 -1
- package/models/trace/handlers/FlowsHandler.js +0 -149
- package/models/trace/handlers/FlowsHandler.js.map +0 -1
- package/models/trace/handlers/FramesHandler.js +0 -492
- package/models/trace/handlers/FramesHandler.js.map +0 -1
- package/models/trace/handlers/GPUHandler.js +0 -36
- package/models/trace/handlers/GPUHandler.js.map +0 -1
- package/models/trace/handlers/ImagePaintingHandler.js +0 -148
- package/models/trace/handlers/ImagePaintingHandler.js.map +0 -1
- package/models/trace/handlers/InitiatorsHandler.js +0 -181
- package/models/trace/handlers/InitiatorsHandler.js.map +0 -1
- package/models/trace/handlers/InvalidationsHandler.js +0 -127
- package/models/trace/handlers/InvalidationsHandler.js.map +0 -1
- package/models/trace/handlers/LargestImagePaintHandler.js +0 -86
- package/models/trace/handlers/LargestImagePaintHandler.js.map +0 -1
- package/models/trace/handlers/LargestTextPaintHandler.js +0 -28
- package/models/trace/handlers/LargestTextPaintHandler.js.map +0 -1
- package/models/trace/handlers/LayerTreeHandler.js +0 -104
- package/models/trace/handlers/LayerTreeHandler.js.map +0 -1
- package/models/trace/handlers/LayoutShiftsHandler.js +0 -458
- package/models/trace/handlers/LayoutShiftsHandler.js.map +0 -1
- package/models/trace/handlers/MemoryHandler.js +0 -22
- package/models/trace/handlers/MemoryHandler.js.map +0 -1
- package/models/trace/handlers/MetaHandler.js +0 -411
- package/models/trace/handlers/MetaHandler.js.map +0 -1
- package/models/trace/handlers/ModelHandlers.js +0 -34
- package/models/trace/handlers/ModelHandlers.js.map +0 -1
- package/models/trace/handlers/NetworkRequestsHandler.js +0 -576
- package/models/trace/handlers/NetworkRequestsHandler.js.map +0 -1
- package/models/trace/handlers/PageFramesHandler.js +0 -43
- package/models/trace/handlers/PageFramesHandler.js.map +0 -1
- package/models/trace/handlers/PageLoadMetricsHandler.js +0 -423
- package/models/trace/handlers/PageLoadMetricsHandler.js.map +0 -1
- package/models/trace/handlers/RendererHandler.js +0 -347
- package/models/trace/handlers/RendererHandler.js.map +0 -1
- package/models/trace/handlers/SamplesHandler.js +0 -261
- package/models/trace/handlers/SamplesHandler.js.map +0 -1
- package/models/trace/handlers/ScreenshotsHandler.js +0 -98
- package/models/trace/handlers/ScreenshotsHandler.js.map +0 -1
- package/models/trace/handlers/ScriptsHandler.js +0 -286
- package/models/trace/handlers/ScriptsHandler.js.map +0 -1
- package/models/trace/handlers/SelectorStatsHandler.js +0 -72
- package/models/trace/handlers/SelectorStatsHandler.js.map +0 -1
- package/models/trace/handlers/Threads.js +0 -112
- package/models/trace/handlers/Threads.js.map +0 -1
- package/models/trace/handlers/UserInteractionsHandler.js +0 -319
- package/models/trace/handlers/UserInteractionsHandler.js.map +0 -1
- package/models/trace/handlers/UserTimingsHandler.js +0 -184
- package/models/trace/handlers/UserTimingsHandler.js.map +0 -1
- package/models/trace/handlers/WarningsHandler.js +0 -135
- package/models/trace/handlers/WarningsHandler.js.map +0 -1
- package/models/trace/handlers/WorkersHandler.js +0 -34
- package/models/trace/handlers/WorkersHandler.js.map +0 -1
- package/models/trace/handlers/bundle-tsconfig.json +0 -1
- package/models/trace/handlers/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/models/trace/handlers/handlers-tsconfig.json +0 -102
- package/models/trace/handlers/handlers.js +0 -8
- package/models/trace/handlers/handlers.js.map +0 -1
- package/models/trace/handlers/helpers.js +0 -164
- package/models/trace/handlers/helpers.js.map +0 -1
- package/models/trace/handlers/types.js +0 -2
- package/models/trace/handlers/types.js.map +0 -1
- package/models/trace/helpers/Extensions.js +0 -42
- package/models/trace/helpers/Extensions.js.map +0 -1
- package/models/trace/helpers/Network.js +0 -103
- package/models/trace/helpers/Network.js.map +0 -1
- package/models/trace/helpers/SamplesIntegrator.js +0 -496
- package/models/trace/helpers/SamplesIntegrator.js.map +0 -1
- package/models/trace/helpers/SyntheticEvents.js +0 -75
- package/models/trace/helpers/SyntheticEvents.js.map +0 -1
- package/models/trace/helpers/Timing.js +0 -194
- package/models/trace/helpers/Timing.js.map +0 -1
- package/models/trace/helpers/Trace.js +0 -817
- package/models/trace/helpers/Trace.js.map +0 -1
- package/models/trace/helpers/TreeHelpers.js +0 -255
- package/models/trace/helpers/TreeHelpers.js.map +0 -1
- package/models/trace/helpers/bundle-tsconfig.json +0 -1
- package/models/trace/helpers/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/models/trace/helpers/helpers-tsconfig.json +0 -69
- package/models/trace/helpers/helpers.js +0 -11
- package/models/trace/helpers/helpers.js.map +0 -1
- package/models/trace/insights/CLSCulprits.js +0 -518
- package/models/trace/insights/CLSCulprits.js.map +0 -1
- package/models/trace/insights/Cache.js +0 -210
- package/models/trace/insights/Cache.js.map +0 -1
- package/models/trace/insights/CharacterSet.js +0 -132
- package/models/trace/insights/CharacterSet.js.map +0 -1
- package/models/trace/insights/Common.js +0 -348
- package/models/trace/insights/Common.js.map +0 -1
- package/models/trace/insights/DOMSize.js +0 -182
- package/models/trace/insights/DOMSize.js.map +0 -1
- package/models/trace/insights/DocumentLatency.js +0 -259
- package/models/trace/insights/DocumentLatency.js.map +0 -1
- package/models/trace/insights/DuplicatedJavaScript.js +0 -95
- package/models/trace/insights/DuplicatedJavaScript.js.map +0 -1
- package/models/trace/insights/FontDisplay.js +0 -87
- package/models/trace/insights/FontDisplay.js.map +0 -1
- package/models/trace/insights/ForcedReflow.js +0 -162
- package/models/trace/insights/ForcedReflow.js.map +0 -1
- package/models/trace/insights/INPBreakdown.js +0 -130
- package/models/trace/insights/INPBreakdown.js.map +0 -1
- package/models/trace/insights/ImageDelivery.js +0 -264
- package/models/trace/insights/ImageDelivery.js.map +0 -1
- package/models/trace/insights/LCPBreakdown.js +0 -200
- package/models/trace/insights/LCPBreakdown.js.map +0 -1
- package/models/trace/insights/LCPDiscovery.js +0 -190
- package/models/trace/insights/LCPDiscovery.js.map +0 -1
- package/models/trace/insights/LegacyJavaScript.js +0 -95
- package/models/trace/insights/LegacyJavaScript.js.map +0 -1
- package/models/trace/insights/Models.js +0 -23
- package/models/trace/insights/Models.js.map +0 -1
- package/models/trace/insights/ModernHTTP.js +0 -201
- package/models/trace/insights/ModernHTTP.js.map +0 -1
- package/models/trace/insights/NetworkDependencyTree.js +0 -968
- package/models/trace/insights/NetworkDependencyTree.js.map +0 -1
- package/models/trace/insights/RenderBlocking.js +0 -193
- package/models/trace/insights/RenderBlocking.js.map +0 -1
- package/models/trace/insights/SlowCSSSelector.js +0 -137
- package/models/trace/insights/SlowCSSSelector.js.map +0 -1
- package/models/trace/insights/Statistics.js +0 -93
- package/models/trace/insights/Statistics.js.map +0 -1
- package/models/trace/insights/ThirdParties.js +0 -99
- package/models/trace/insights/ThirdParties.js.map +0 -1
- package/models/trace/insights/Viewport.js +0 -103
- package/models/trace/insights/Viewport.js.map +0 -1
- package/models/trace/insights/bundle-tsconfig.json +0 -1
- package/models/trace/insights/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/models/trace/insights/insights-tsconfig.json +0 -103
- package/models/trace/insights/insights.js +0 -10
- package/models/trace/insights/insights.js.map +0 -1
- package/models/trace/insights/types.js +0 -41
- package/models/trace/insights/types.js.map +0 -1
- package/models/trace/lantern/bundle-tsconfig.json +0 -1
- package/models/trace/lantern/core/LanternError.js +0 -7
- package/models/trace/lantern/core/LanternError.js.map +0 -1
- package/models/trace/lantern/core/NetworkAnalyzer.js +0 -484
- package/models/trace/lantern/core/NetworkAnalyzer.js.map +0 -1
- package/models/trace/lantern/core/bundle-tsconfig.json +0 -1
- package/models/trace/lantern/core/core-tsconfig.json +0 -49
- package/models/trace/lantern/core/core.js +0 -6
- package/models/trace/lantern/core/core.js.map +0 -1
- package/models/trace/lantern/core/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/models/trace/lantern/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -60
- package/models/trace/lantern/graph/BaseNode.js +0 -277
- package/models/trace/lantern/graph/BaseNode.js.map +0 -1
- package/models/trace/lantern/graph/CPUNode.js +0 -64
- package/models/trace/lantern/graph/CPUNode.js.map +0 -1
- package/models/trace/lantern/graph/NetworkNode.js +0 -83
- package/models/trace/lantern/graph/NetworkNode.js.map +0 -1
- package/models/trace/lantern/graph/PageDependencyGraph.js +0 -552
- package/models/trace/lantern/graph/PageDependencyGraph.js.map +0 -1
- package/models/trace/lantern/graph/bundle-tsconfig.json +0 -1
- package/models/trace/lantern/graph/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/models/trace/lantern/graph/graph-tsconfig.json +0 -54
- package/models/trace/lantern/graph/graph.js +0 -8
- package/models/trace/lantern/graph/graph.js.map +0 -1
- package/models/trace/lantern/lantern.js.map +0 -1
- package/models/trace/lantern/metrics/FirstContentfulPaint.js +0 -137
- package/models/trace/lantern/metrics/FirstContentfulPaint.js.map +0 -1
- package/models/trace/lantern/metrics/Interactive.js +0 -68
- package/models/trace/lantern/metrics/Interactive.js.map +0 -1
- package/models/trace/lantern/metrics/LargestContentfulPaint.js +0 -69
- package/models/trace/lantern/metrics/LargestContentfulPaint.js.map +0 -1
- package/models/trace/lantern/metrics/MaxPotentialFID.js +0 -49
- package/models/trace/lantern/metrics/MaxPotentialFID.js.map +0 -1
- package/models/trace/lantern/metrics/Metric.js +0 -69
- package/models/trace/lantern/metrics/Metric.js.map +0 -1
- package/models/trace/lantern/metrics/SpeedIndex.js +0 -102
- package/models/trace/lantern/metrics/SpeedIndex.js.map +0 -1
- package/models/trace/lantern/metrics/TBTUtils.js +0 -65
- package/models/trace/lantern/metrics/TBTUtils.js.map +0 -1
- package/models/trace/lantern/metrics/TotalBlockingTime.js +0 -79
- package/models/trace/lantern/metrics/TotalBlockingTime.js.map +0 -1
- package/models/trace/lantern/metrics/bundle-tsconfig.json +0 -1
- package/models/trace/lantern/metrics/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/models/trace/lantern/metrics/metrics-tsconfig.json +0 -64
- package/models/trace/lantern/metrics/metrics.js +0 -12
- package/models/trace/lantern/metrics/metrics.js.map +0 -1
- package/models/trace/lantern/simulation/ConnectionPool.js +0 -116
- package/models/trace/lantern/simulation/ConnectionPool.js.map +0 -1
- package/models/trace/lantern/simulation/Constants.js +0 -43
- package/models/trace/lantern/simulation/Constants.js.map +0 -1
- package/models/trace/lantern/simulation/DNSCache.js +0 -48
- package/models/trace/lantern/simulation/DNSCache.js.map +0 -1
- package/models/trace/lantern/simulation/SimulationTimingMap.js +0 -135
- package/models/trace/lantern/simulation/SimulationTimingMap.js.map +0 -1
- package/models/trace/lantern/simulation/Simulator.js +0 -451
- package/models/trace/lantern/simulation/Simulator.js.map +0 -1
- package/models/trace/lantern/simulation/TCPConnection.js +0 -155
- package/models/trace/lantern/simulation/TCPConnection.js.map +0 -1
- package/models/trace/lantern/simulation/bundle-tsconfig.json +0 -1
- package/models/trace/lantern/simulation/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/models/trace/lantern/simulation/simulation-tsconfig.json +0 -59
- package/models/trace/lantern/simulation/simulation.js +0 -10
- package/models/trace/lantern/simulation/simulation.js.map +0 -1
- package/models/trace/lantern/types/Lantern.js +0 -25
- package/models/trace/lantern/types/Lantern.js.map +0 -1
- package/models/trace/lantern/types/bundle-tsconfig.json +0 -1
- package/models/trace/lantern/types/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/models/trace/lantern/types/types-tsconfig.json +0 -48
- package/models/trace/lantern/types/types.js +0 -5
- package/models/trace/lantern/types/types.js.map +0 -1
- package/models/trace/trace-tsconfig.json +0 -78
- package/models/trace/trace.js.map +0 -1
- package/models/trace/types/Configuration.js +0 -18
- package/models/trace/types/Configuration.js.map +0 -1
- package/models/trace/types/Extensions.js +0 -38
- package/models/trace/types/Extensions.js.map +0 -1
- package/models/trace/types/File.js +0 -82
- package/models/trace/types/File.js.map +0 -1
- package/models/trace/types/Overlays.js +0 -5
- package/models/trace/types/Overlays.js.map +0 -1
- package/models/trace/types/Timing.js.map +0 -1
- package/models/trace/types/TraceEvents.js.map +0 -1
- package/models/trace/types/bundle-tsconfig.json +0 -1
- package/models/trace/types/devtools_entrypoint-bundle-typescript-tsconfig.json +0 -48
- package/models/trace/types/types-tsconfig.json +0 -65
- package/models/trace/types/types.js.map +0 -1
- package/test/invalid-animation-events.json.gz +0 -0
- package/test/test-trace-engine.mjs +0 -191
- package/third_party/legacy-javascript/legacy-javascript.js +0 -1
- package/third_party/marked/marked.d.ts +0 -1
- package/third_party/marked/marked.js +0 -1
- package/third_party/third-party-web/third-party-web.js +0 -1
- 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
|
-
|
|
19
|
+
See the included `analyze-trace.mjs` for a runnable invocation.
|
|
21
20
|
|
|
22
|
-
|
|
21
|
+
### Types & Submodule Imports
|
|
23
22
|
|
|
24
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
36
|
-
|
|
37
|
-
|
|
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
|
-
|
|
36
|
+
```sh
|
|
40
37
|
cd $HOME/code/trace_engine
|
|
41
38
|
|
|
42
|
-
#
|
|
43
|
-
npm
|
|
44
|
-
npm
|
|
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
|
-
#
|
|
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
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
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,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
|
+
};
|