devtools-tracing 1.2.1 → 1.3.0

package/dist/lib/front_end/core/host/InspectorFrontendHostAPI.d.ts

@@ -0,0 +1,414 @@
+import type * as Platform from '../../core/platform/platform.js';
+import type * as Common from '../common/common.js';
+import type * as Root from '../root/root.js';
+/**
+ * This values should match the one getting called from Chromium
+ */
+export declare enum Events {
+    AppendedToURL = "appendedToURL",
+    CanceledSaveURL = "canceledSaveURL",
+    ColorThemeChanged = "colorThemeChanged",
+    ContextMenuCleared = "contextMenuCleared",
+    ContextMenuItemSelected = "contextMenuItemSelected",
+    DeviceCountUpdated = "deviceCountUpdated",
+    DevicesDiscoveryConfigChanged = "devicesDiscoveryConfigChanged",
+    DevicesPortForwardingStatusChanged = "devicesPortForwardingStatusChanged",
+    DevicesUpdated = "devicesUpdated",
+    DispatchMessage = "dispatchMessage",
+    DispatchMessageChunk = "dispatchMessageChunk",
+    EnterInspectElementMode = "enterInspectElementMode",
+    EyeDropperPickedColor = "eyeDropperPickedColor",
+    FileSystemsLoaded = "fileSystemsLoaded",
+    FileSystemRemoved = "fileSystemRemoved",
+    FileSystemAdded = "fileSystemAdded",
+    FileSystemFilesChangedAddedRemoved = "fileSystemFilesChangedAddedRemoved",
+    IndexingTotalWorkCalculated = "indexingTotalWorkCalculated",
+    IndexingWorked = "indexingWorked",
+    IndexingDone = "indexingDone",
+    KeyEventUnhandled = "keyEventUnhandled",
+    ReloadInspectedPage = "reloadInspectedPage",
+    RevealSourceLine = "revealSourceLine",
+    SavedURL = "savedURL",
+    SearchCompleted = "searchCompleted",
+    SetInspectedTabId = "setInspectedTabId",
+    SetUseSoftMenu = "setUseSoftMenu",
+    ShowPanel = "showPanel"
+}
+export declare const EventDescriptors: readonly [readonly [Events.AppendedToURL, readonly ["url"]], readonly [Events.CanceledSaveURL, readonly ["url"]], readonly [Events.ColorThemeChanged, readonly []], readonly [Events.ContextMenuCleared, readonly []], readonly [Events.ContextMenuItemSelected, readonly ["id"]], readonly [Events.DeviceCountUpdated, readonly ["count"]], readonly [Events.DevicesDiscoveryConfigChanged, readonly ["config"]], readonly [Events.DevicesPortForwardingStatusChanged, readonly ["status"]], readonly [Events.DevicesUpdated, readonly ["devices"]], readonly [Events.DispatchMessage, readonly ["messageObject"]], readonly [Events.DispatchMessageChunk, readonly ["messageChunk", "messageSize"]], readonly [Events.EnterInspectElementMode, readonly []], readonly [Events.EyeDropperPickedColor, readonly ["color"]], readonly [Events.FileSystemsLoaded, readonly ["fileSystems"]], readonly [Events.FileSystemRemoved, readonly ["fileSystemPath"]], readonly [Events.FileSystemAdded, readonly ["errorMessage", "fileSystem"]], readonly [Events.FileSystemFilesChangedAddedRemoved, readonly ["changed", "added", "removed"]], readonly [Events.IndexingTotalWorkCalculated, any, readonly ["requestId", "fileSystemPath", "totalWork"]], readonly [Events.IndexingWorked, readonly ["requestId", "fileSystemPath", "worked"]], readonly [Events.IndexingDone, readonly ["requestId", "fileSystemPath"]], readonly [Events.KeyEventUnhandled, readonly ["event"]], readonly [Events.ReloadInspectedPage, readonly ["hard"]], readonly [Events.RevealSourceLine, readonly ["url", "lineNumber", "columnNumber"]], readonly [Events.SavedURL, readonly ["url", "fileSystemPath"]], readonly [Events.SearchCompleted, readonly ["requestId", "fileSystemPath", "files"]], readonly [Events.SetInspectedTabId, readonly ["tabId"]], readonly [Events.SetUseSoftMenu, readonly ["useSoftMenu"]], readonly [Events.ShowPanel, readonly ["panelName"]]];
+export interface DispatchMessageChunkEvent {
+    messageChunk: string;
+    messageSize: number;
+}
+export interface EyeDropperPickedColorEvent {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+export interface DevToolsFileSystem {
+    type: '' | 'automatic' | 'snippets' | 'overrides';
+    fileSystemName: string;
+    rootURL: string;
+    fileSystemPath: Platform.DevToolsPath.RawPathString;
+}
+export interface FileSystemAddedEvent {
+    errorMessage?: string;
+    fileSystem: DevToolsFileSystem | null;
+}
+export interface FilesChangedEvent {
+    changed: Platform.DevToolsPath.RawPathString[];
+    added: Platform.DevToolsPath.RawPathString[];
+    removed: Platform.DevToolsPath.RawPathString[];
+}
+export interface IndexingEvent {
+    requestId: number;
+    fileSystemPath: string;
+}
+export interface IndexingTotalWorkCalculatedEvent extends IndexingEvent {
+    totalWork: number;
+}
+export interface IndexingWorkedEvent extends IndexingEvent {
+    worked: number;
+}
+export interface KeyEventUnhandledEvent {
+    type: string;
+    key: string;
+    keyCode: number;
+    modifiers: number;
+}
+export interface RevealSourceLineEvent {
+    url: Platform.DevToolsPath.UrlString;
+    lineNumber: number;
+    columnNumber: number;
+}
+export interface SavedURLEvent {
+    url: Platform.DevToolsPath.RawPathString | Platform.DevToolsPath.UrlString;
+    fileSystemPath: Platform.DevToolsPath.RawPathString | Platform.DevToolsPath.UrlString;
+}
+export interface SearchCompletedEvent {
+    requestId: number;
+    files: Platform.DevToolsPath.RawPathString[];
+}
+export interface DoAidaConversationResult {
+    statusCode?: number;
+    headers?: Record<string, string>;
+    netError?: number;
+    netErrorName?: string;
+    error?: string;
+    detail?: string;
+}
+export interface AidaClientResult {
+    response?: string;
+    error?: string;
+    detail?: string;
+}
+export interface AidaCodeCompleteResult {
+    response?: string;
+    error?: string;
+    detail?: string;
+}
+export interface VisualElementImpression {
+    id: number;
+    type: number;
+    parent?: number;
+    context?: number;
+    width?: number;
+    height?: number;
+}
+export interface ImpressionEvent {
+    impressions: VisualElementImpression[];
+}
+export interface ResizeEvent {
+    veid: number;
+    width?: number;
+    height?: number;
+}
+export interface ClickEvent {
+    veid: number;
+    mouseButton?: number;
+    context?: number;
+    doubleClick: boolean;
+}
+export interface HoverEvent {
+    veid: number;
+    time?: number;
+    context?: number;
+}
+export interface DragEvent {
+    veid: number;
+    context?: number;
+}
+export interface ChangeEvent {
+    veid: number;
+    context?: number;
+}
+export interface KeyDownEvent {
+    veid?: number;
+    context?: number;
+}
+export interface SettingAccessEvent {
+    name: number;
+    numeric_value?: number;
+    string_value?: number;
+}
+export interface FunctionCallEvent {
+    name: number;
+    context?: number;
+}
+/**
+ * While `EventDescriptors` are used to dynamically dispatch host binding events,
+ * the `EventTypes` "type map" is used for type-checking said events by TypeScript.
+ * `EventTypes` is not used at runtime.
+ * Please note that the "dispatch" side can't be type-checked as the dispatch is
+ * done dynamically.
+ **/
+export interface EventTypes {
+    [Events.AppendedToURL]: Platform.DevToolsPath.RawPathString | Platform.DevToolsPath.UrlString;
+    [Events.CanceledSaveURL]: Platform.DevToolsPath.UrlString;
+    [Events.ColorThemeChanged]: void;
+    [Events.ContextMenuCleared]: void;
+    [Events.ContextMenuItemSelected]: number;
+    [Events.DeviceCountUpdated]: number;
+    [Events.DevicesDiscoveryConfigChanged]: Adb.Config;
+    [Events.DevicesPortForwardingStatusChanged]: void;
+    [Events.DevicesUpdated]: void;
+    [Events.DispatchMessage]: string;
+    [Events.DispatchMessageChunk]: DispatchMessageChunkEvent;
+    [Events.EnterInspectElementMode]: void;
+    [Events.EyeDropperPickedColor]: EyeDropperPickedColorEvent;
+    [Events.FileSystemsLoaded]: DevToolsFileSystem[];
+    [Events.FileSystemRemoved]: Platform.DevToolsPath.RawPathString;
+    [Events.FileSystemAdded]: FileSystemAddedEvent;
+    [Events.FileSystemFilesChangedAddedRemoved]: FilesChangedEvent;
+    [Events.IndexingTotalWorkCalculated]: IndexingTotalWorkCalculatedEvent;
+    [Events.IndexingWorked]: IndexingWorkedEvent;
+    [Events.IndexingDone]: IndexingEvent;
+    [Events.KeyEventUnhandled]: KeyEventUnhandledEvent;
+    [Events.ReloadInspectedPage]: boolean;
+    [Events.RevealSourceLine]: RevealSourceLineEvent;
+    [Events.SavedURL]: SavedURLEvent;
+    [Events.SearchCompleted]: SearchCompletedEvent;
+    [Events.SetInspectedTabId]: string;
+    [Events.SetUseSoftMenu]: boolean;
+    [Events.ShowPanel]: string;
+}
+export type DispatchHttpRequestRequest = {
+    service: string;
+    path: string;
+    method: 'GET';
+    queryParams?: Record<string, string | string[]>;
+    streamId?: number;
+    body?: never;
+} | {
+    service: string;
+    path: string;
+    method: 'POST';
+    queryParams?: Record<string, string | string[]>;
+    streamId?: number;
+    body?: string;
+};
+interface DispatchHttpRequestSuccessResult {
+    response: string;
+    statusCode: number;
+}
+interface DispatchHttpRequestErrorResult {
+    error: string;
+    detail?: string;
+    netError?: number;
+    netErrorName?: string;
+    statusCode?: number;
+}
+export type DispatchHttpRequestResult = DispatchHttpRequestSuccessResult | DispatchHttpRequestErrorResult;
+export interface InspectorFrontendHostAPI {
+    events: Common.EventTarget.EventTarget<EventTypes>;
+    connectAutomaticFileSystem(fileSystemPath: Platform.DevToolsPath.RawPathString, fileSystemUUID: string, addIfMissing: boolean, callback: (result: {
+        success: boolean;
+    }) => void): void;
+    disconnectAutomaticFileSystem(fileSystemPath: Platform.DevToolsPath.RawPathString): void;
+    addFileSystem(type?: string): void;
+    loadCompleted(): void;
+    indexPath(requestId: number, fileSystemPath: Platform.DevToolsPath.RawPathString, excludedFolders: string): void;
+    /**
+     * Requests inspected page to be placed atop of the inspector frontend with specified bounds.
+     */
+    setInspectedPageBounds(bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }): void;
+    showCertificateViewer(certChain: string[]): void;
+    setWhitelistedShortcuts(shortcuts: string): void;
+    setEyeDropperActive(active: boolean): void;
+    inspectElementCompleted(): void;
+    openInNewTab(url: Platform.DevToolsPath.UrlString): void;
+    openSearchResultsInNewTab(query: string): void;
+    showItemInFolder(fileSystemPath: Platform.DevToolsPath.RawPathString): void;
+    removeFileSystem(fileSystemPath: Platform.DevToolsPath.RawPathString): void;
+    requestFileSystems(): void;
+    save(url: Platform.DevToolsPath.RawPathString | Platform.DevToolsPath.UrlString, content: string, forceSaveAs: boolean, isBase64: boolean): void;
+    append(url: Platform.DevToolsPath.RawPathString | Platform.DevToolsPath.UrlString, content: string): void;
+    close(url: Platform.DevToolsPath.RawPathString | Platform.DevToolsPath.UrlString): void;
+    searchInPath(requestId: number, fileSystemPath: Platform.DevToolsPath.RawPathString, query: string): void;
+    stopIndexing(requestId: number): void;
+    bringToFront(): void;
+    closeWindow(): void;
+    /**
+     * If you need to alert to the user after copying use {@link UIUtils.copyTextToClipboard}.
+     */
+    copyText(text?: string | null): void;
+    inspectedURLChanged(url: Platform.DevToolsPath.UrlString): void;
+    isolatedFileSystem(fileSystemId: string, registeredName: string): FileSystem | null;
+    loadNetworkResource(url: string, headers: string, streamId: number, callback: (arg0: LoadNetworkResourceResult) => void): void;
+    registerPreference(name: string, options: {
+        synced?: boolean;
+    }): void;
+    getPreferences(callback: (arg0: Record<string, string>) => void): void;
+    getPreference(name: string, callback: (arg0: string) => void): void;
+    setPreference(name: string, value: string): void;
+    removePreference(name: string): void;
+    clearPreferences(): void;
+    getSyncInformation(callback: (arg0: SyncInformation) => void): void;
+    getHostConfig(callback: (arg0: Root.Runtime.HostConfig) => void): void;
+    upgradeDraggedFileSystemPermissions(fileSystem: FileSystem): void;
+    platform(): string;
+    recordCountHistogram(histogramName: string, sample: number, min: number, exclusiveMax: number, bucketSize: number): void;
+    recordEnumeratedHistogram(actionName: EnumeratedHistogram, actionCode: number, bucketSize: number): void;
+    recordPerformanceHistogram(histogramName: string, duration: number): void;
+    recordPerformanceHistogramMedium(histogramName: string, duration: number): void;
+    recordUserMetricsAction(umaName: string): void;
+    recordNewBadgeUsage(featureName: string): void;
+    sendMessageToBackend(message: string): void;
+    setDevicesDiscoveryConfig(config: Adb.Config): void;
+    setDevicesUpdatesEnabled(enabled: boolean): void;
+    openRemotePage(browserId: string, url: string): void;
+    openNodeFrontend(): void;
+    setInjectedScriptForOrigin(origin: string, script: string): void;
+    setIsDocked(isDocked: boolean, callback: () => void): void;
+    showSurvey(trigger: string, callback: (arg0: ShowSurveyResult) => void): void;
+    canShowSurvey(trigger: string, callback: (arg0: CanShowSurveyResult) => void): void;
+    zoomFactor(): number;
+    zoomIn(): void;
+    zoomOut(): void;
+    resetZoom(): void;
+    showContextMenuAtPoint(x: number, y: number, items: ContextMenuDescriptor[], document: Document): void;
+    reattach(callback: () => void): void;
+    readyForTest(): void;
+    connectionReady(): void;
+    setOpenNewWindowForPopups(value: boolean): void;
+    isHostedMode(): boolean;
+    setAddExtensionCallback(callback: (arg0: ExtensionDescriptor) => void): void;
+    initialTargetId(): Promise<string | null>;
+    doAidaConversation: (request: string, streamId: number, cb: (result: DoAidaConversationResult) => void) => void;
+    registerAidaClientEvent: (request: string, cb: (result: AidaClientResult) => void) => void;
+    aidaCodeComplete: (request: string, cb: (result: AidaCodeCompleteResult) => void) => void;
+    dispatchHttpRequest: (request: DispatchHttpRequestRequest, cb: (result: DispatchHttpRequestResult) => void) => void;
+    recordImpression(event: ImpressionEvent): void;
+    recordResize(event: ResizeEvent): void;
+    recordClick(event: ClickEvent): void;
+    recordHover(event: HoverEvent): void;
+    recordDrag(event: DragEvent): void;
+    recordChange(event: ChangeEvent): void;
+    recordKeyDown(event: KeyDownEvent): void;
+    recordSettingAccess(event: SettingAccessEvent): void;
+    recordFunctionCall(event: FunctionCallEvent): void;
+    setChromeFlag(flagName: string, value: boolean): void;
+    requestRestart(): void;
+}
+export interface AcceleratorDescriptor {
+    keyCode: number;
+    modifiers: number;
+}
+export interface ContextMenuDescriptor {
+    type: 'checkbox' | 'item' | 'separator' | 'subMenu';
+    id?: number;
+    label?: string;
+    accelerator?: AcceleratorDescriptor;
+    isExperimentalFeature?: boolean;
+    enabled?: boolean;
+    checked?: boolean;
+    isDevToolsPerformanceMenuItem?: boolean;
+    subItems?: ContextMenuDescriptor[];
+    shortcut?: string;
+    jslogContext?: string;
+    /** Setting the featureName requests showing a new badge tied to that feature . */
+    featureName?: string;
+}
+export interface LoadNetworkResourceResult {
+    statusCode: number;
+    headers?: Record<string, string>;
+    netError?: number;
+    netErrorName?: string;
+    urlValid?: boolean;
+    messageOverride?: string;
+}
+export interface ExtensionDescriptor {
+    startPage: string;
+    name: string;
+    exposeExperimentalAPIs: boolean;
+    hostsPolicy?: ExtensionHostsPolicy;
+    allowFileAccess?: boolean;
+}
+export interface ExtensionHostsPolicy {
+    runtimeAllowedHosts: string[];
+    runtimeBlockedHosts: string[];
+}
+export interface ShowSurveyResult {
+    surveyShown: boolean;
+}
+export interface CanShowSurveyResult {
+    canShowSurvey: boolean;
+}
+export interface SyncInformation {
+    /** Whether Chrome Sync is enabled and active */
+    isSyncActive: boolean;
+    /** Whether syncing of Chrome Settings is enabled via Chrome Sync is enabled */
+    arePreferencesSynced?: boolean;
+    /** The email of the account used for syncing */
+    accountEmail?: string;
+    /** The image of the account used for syncing. Its a base64 encoded PNG */
+    accountImage?: string;
+    /** The full name of the account used for syncing */
+    accountFullName?: string;
+    /** The given name of the account used for syncing */
+    accountGivenName?: string;
+    /** Whether Chrome Sync is paused, equivalent to the user being logged out automatically */
+    isSyncPaused?: boolean;
+}
+/**
+ * Enum for recordEnumeratedHistogram
+ * Warning: There is another definition of this enum in the DevTools code
+ * base, keep them in sync:
+ * front_end/devtools_compatibility.js
+ */
+export declare const enum EnumeratedHistogram {
+    ActionTaken = "DevTools.ActionTaken",
+    PanelShown = "DevTools.PanelShown",
+    KeyboardShortcutFired = "DevTools.KeyboardShortcutFired",
+    IssueCreated = "DevTools.IssueCreated",
+    IssuesPanelIssueExpanded = "DevTools.IssuesPanelIssueExpanded",
+    IssuesPanelOpenedFrom = "DevTools.IssuesPanelOpenedFrom",
+    IssuesPanelResourceOpened = "DevTools.IssuesPanelResourceOpened",
+    KeybindSetSettingChanged = "DevTools.KeybindSetSettingChanged",
+    ExperimentEnabledAtLaunch = "DevTools.ExperimentEnabledAtLaunch",
+    ExperimentDisabledAtLaunch = "DevTools.ExperimentDisabledAtLaunch",
+    ExperimentEnabled = "DevTools.ExperimentEnabled",
+    ExperimentDisabled = "DevTools.ExperimentDisabled",
+    DeveloperResourceLoaded = "DevTools.DeveloperResourceLoaded",
+    DeveloperResourceScheme = "DevTools.DeveloperResourceScheme",
+    Language = "DevTools.Language",
+    SyncSetting = "DevTools.SyncSetting",
+    RecordingReplayFinished = "DevTools.RecordingReplayFinished",
+    RecordingReplayStarted = "DevTools.RecordingReplayStarted",
+    RecordingToggled = "DevTools.RecordingToggled",
+    SourcesPanelFileDebugged = "DevTools.SourcesPanelFileDebugged",
+    SourcesPanelFileOpened = "DevTools.SourcesPanelFileOpened",
+    NetworkPanelResponsePreviewOpened = "DevTools.NetworkPanelResponsePreviewOpened",
+    TimelineNavigationSettingState = "DevTools.TimelineNavigationSettingState",
+    LighthouseModeRun = "DevTools.LighthouseModeRun",
+    LighthouseCategoryUsed = "DevTools.LighthouseCategoryUsed",
+    SwatchActivated = "DevTools.SwatchActivated",
+    BuiltInAiAvailability = "DevTools.BuiltInAiAvailability",
+    ExtensionEvalTarget = "DevTools.ExtensionEvalTarget"
+}
+export {};

package/dist/lib/front_end/core/host/InspectorFrontendHostStub.d.ts

@@ -0,0 +1,151 @@
+import * as Common from '../common/common.js';
+import * as Platform from '../platform/platform.js';
+import type * as Root from '../root/root.js';
+import { type AidaClientResult, type AidaCodeCompleteResult, type CanShowSurveyResult, type ChangeEvent, type ClickEvent, type ContextMenuDescriptor, type DispatchHttpRequestRequest, type DispatchHttpRequestResult, type DoAidaConversationResult, type DragEvent, type EnumeratedHistogram, type EventTypes, type ExtensionDescriptor, type FunctionCallEvent, type HoverEvent, type ImpressionEvent, type InspectorFrontendHostAPI, type KeyDownEvent, type LoadNetworkResourceResult, type ResizeEvent, type SettingAccessEvent, type ShowSurveyResult, type SyncInformation } from './InspectorFrontendHostAPI.js';
+/**
+ * The `InspectorFrontendHostStub` is a stub interface used the frontend is loaded like a webpage. Examples:
+ *   - devtools://devtools/bundled/devtools_app.html
+ *   - https://chrome-devtools-frontend.appspot.com/serve_rev/@030cc140435b0152645522b9864b75cac6c0a854/worker_app.html
+ *   - http://localhost:9222/devtools/inspector.html?ws=localhost:9222/devtools/page/xTARGET_IDx
+ *
+ * When the frontend runs within the native embedder, then the InspectorFrontendHostAPI methods are provided
+ * by devtools_compatibility.js. Those leverage `DevToolsAPI.sendMessageToEmbedder()` which match up with
+ * the embedder API defined here: https://source.chromium.org/search?q=f:devtools%20f:dispatcher%20f:cc%20symbol:CreateForDevToolsFrontend&sq=&ss=chromium%2Fchromium%2Fsrc
+ * The native implementations live in devtools_ui_bindings.cc: https://source.chromium.org/chromium/chromium/src/+/main:chrome/browser/devtools/devtools_ui_bindings.cc
+ */
+export declare class InspectorFrontendHostStub implements InspectorFrontendHostAPI {
+    #private;
+    /**
+     * Injected bellow in both stub and normal runs via:
+     * ```ts
+     * InspectorFrontendHostInstance.events = new Common.ObjectWrapper.ObjectWrapper();
+     * ```
+     */
+    events: Common.EventTarget.EventTarget<EventTypes>;
+    recordedCountHistograms: Array<{
+        histogramName: string;
+        sample: number;
+        min: number;
+        exclusiveMax: number;
+        bucketSize: number;
+    }>;
+    recordedEnumeratedHistograms: Array<{
+        actionName: EnumeratedHistogram;
+        actionCode: number;
+    }>;
+    recordedPerformanceHistograms: Array<{
+        histogramName: string;
+        duration: number;
+    }>;
+    constructor();
+    platform(): string;
+    loadCompleted(): void;
+    bringToFront(): void;
+    closeWindow(): void;
+    setIsDocked(_isDocked: boolean, callback: () => void): void;
+    showSurvey(_trigger: string, callback: (arg0: ShowSurveyResult) => void): void;
+    canShowSurvey(_trigger: string, callback: (arg0: CanShowSurveyResult) => void): void;
+    /**
+     * Requests inspected page to be placed atop of the inspector frontend with specified bounds.
+     */
+    setInspectedPageBounds(_bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }): void;
+    inspectElementCompleted(): void;
+    setInjectedScriptForOrigin(_origin: string, _script: string): void;
+    inspectedURLChanged(url: Platform.DevToolsPath.UrlString): void;
+    copyText(text?: string | null): void;
+    openInNewTab(url: Platform.DevToolsPath.UrlString): void;
+    openSearchResultsInNewTab(_query: string): void;
+    showItemInFolder(_fileSystemPath: Platform.DevToolsPath.RawPathString): void;
+    save(url: Platform.DevToolsPath.RawPathString | Platform.DevToolsPath.UrlString, content: string, _forceSaveAs: boolean, isBase64: boolean): void;
+    append(url: Platform.DevToolsPath.RawPathString | Platform.DevToolsPath.UrlString, content: string): void;
+    close(url: Platform.DevToolsPath.RawPathString | Platform.DevToolsPath.UrlString): void;
+    sendMessageToBackend(_message: string): void;
+    recordCountHistogram(histogramName: string, sample: number, min: number, exclusiveMax: number, bucketSize: number): void;
+    recordEnumeratedHistogram(actionName: EnumeratedHistogram, actionCode: number, _bucketSize: number): void;
+    recordPerformanceHistogram(histogramName: string, duration: number): void;
+    recordPerformanceHistogramMedium(histogramName: string, duration: number): void;
+    recordUserMetricsAction(_umaName: string): void;
+    recordNewBadgeUsage(_featureName: string): void;
+    connectAutomaticFileSystem(_fileSystemPath: Platform.DevToolsPath.RawPathString, _fileSystemUUID: string, _addIfMissing: boolean, callback: (result: {
+        success: boolean;
+    }) => void): void;
+    disconnectAutomaticFileSystem(_fileSystemPath: Platform.DevToolsPath.RawPathString): void;
+    requestFileSystems(): void;
+    addFileSystem(_type?: string): void;
+    removeFileSystem(_fileSystemPath: Platform.DevToolsPath.RawPathString): void;
+    isolatedFileSystem(_fileSystemId: string, _registeredName: string): FileSystem | null;
+    loadNetworkResource(url: string, _headers: string, streamId: number, callback: (arg0: LoadNetworkResourceResult) => void): void;
+    registerPreference(_name: string, _options: {
+        synced?: boolean;
+    }): void;
+    getPreferences(callback: (arg0: Record<string, string>) => void): void;
+    getPreference(name: string, callback: (arg0: string) => void): void;
+    setPreference(name: string, value: string): void;
+    removePreference(name: string): void;
+    clearPreferences(): void;
+    getSyncInformation(callback: (arg0: SyncInformation) => void): void;
+    getHostConfig(callback: (hostConfig: Root.Runtime.HostConfig) => void): void;
+    upgradeDraggedFileSystemPermissions(_fileSystem: FileSystem): void;
+    indexPath(_requestId: number, _fileSystemPath: Platform.DevToolsPath.RawPathString, _excludedFolders: string): void;
+    stopIndexing(_requestId: number): void;
+    searchInPath(_requestId: number, _fileSystemPath: Platform.DevToolsPath.RawPathString, _query: string): void;
+    zoomFactor(): number;
+    zoomIn(): void;
+    zoomOut(): void;
+    resetZoom(): void;
+    setWhitelistedShortcuts(_shortcuts: string): void;
+    setEyeDropperActive(_active: boolean): void;
+    showCertificateViewer(_certChain: string[]): void;
+    reattach(_callback: () => void): void;
+    readyForTest(): void;
+    connectionReady(): void;
+    setOpenNewWindowForPopups(_value: boolean): void;
+    setDevicesDiscoveryConfig(_config: Adb.Config): void;
+    setDevicesUpdatesEnabled(_enabled: boolean): void;
+    openRemotePage(_browserId: string, _url: string): void;
+    openNodeFrontend(): void;
+    showContextMenuAtPoint(_x: number, _y: number, _items: ContextMenuDescriptor[], _document: Document): void;
+    /**
+     * Think of **Hosted mode** as "non-embedded" mode; you can see a devtools frontend URL as the tab's URL. It's an atypical way that DevTools is run.
+     * Whereas in **Non-hosted** (aka "embedded"), DevTools is embedded and fully dockable. It's the common way DevTools is run.
+     *
+     * **Hosted mode** == we're using the `InspectorFrontendHostStub`. impl. (@see `InspectorFrontendHostStub` class comment)
+     * Whereas with **non-hosted** mode, native `DevToolsEmbedderMessageDispatcher` is used for CDP and more.  `globalThis.DevToolsAPI` is present.
+     *
+     * Relationships to other signals:
+     * - _Connection_: Hosted-ness does not indicate whether the frontend is _connected to a valid CDP target_.
+     * - _Dockability_: Being _"dockable"_ (aka `canDock`) is typically aligned but technically orthogonal.
+     * - _URL scheme_: If the main frame's URL scheme is `devtools://`, it's non-hosted.
+     *
+     *  | Example case                                | Mode           | Example devtools                                                              |
+     *  | :------------------------------------------ | :------------- | :---------------------------------------------------------------------------- |
+     *  | tab URL: `devtools://…`                     | **NOT Hosted** | `devtools://devtools/bundled/devtools_app.html?targetType=tab&...`            |
+     *  | tab URL: `devtools://…?ws=…`                | **NOT Hosted** | `devtools://devtools/bundled/devtools_app.html?ws=localhost:9228/...`         |
+     *  | tab URL: `devtools://…` but no connection   | **NOT Hosted** | `devtools://devtools/bundled/trace_app.html`                                  |
+     *  | tab URL: `https://…` but no connection      | **Hosted**     | `https://chrome-devtools-frontend.appspot.com/serve_rev/@.../trace_app.html`  |
+     *  | tab URL: `http://…?ws=` (connected)         | **Hosted**     | `http://localhost:9222/devtools/inspector.html?ws=localhost:9222/...`         |
+     */
+    isHostedMode(): boolean;
+    setAddExtensionCallback(_callback: (arg0: ExtensionDescriptor) => void): void;
+    initialTargetId(): Promise<string | null>;
+    doAidaConversation(_request: string, _streamId: number, callback: (result: DoAidaConversationResult) => void): void;
+    registerAidaClientEvent(_request: string, callback: (result: AidaClientResult) => void): void;
+    aidaCodeComplete(_request: string, callback: (result: AidaCodeCompleteResult) => void): void;
+    dispatchHttpRequest(_request: DispatchHttpRequestRequest, callback: (result: DispatchHttpRequestResult) => void): void;
+    recordImpression(_event: ImpressionEvent): void;
+    recordResize(_event: ResizeEvent): void;
+    recordClick(_event: ClickEvent): void;
+    recordHover(_event: HoverEvent): void;
+    recordDrag(_event: DragEvent): void;
+    recordChange(_event: ChangeEvent): void;
+    recordKeyDown(_event: KeyDownEvent): void;
+    recordSettingAccess(_event: SettingAccessEvent): void;
+    recordFunctionCall(_event: FunctionCallEvent): void;
+    setChromeFlag(_flagName: string, _value: boolean): void;
+    requestRestart(): void;
+}

package/dist/lib/front_end/core/host/Platform.d.ts

@@ -0,0 +1,11 @@
+export declare function platform(): string;
+export declare function isMac(): boolean;
+export declare function isWin(): boolean;
+/**
+ * In Chrome Layout tests the imported 'Platform' object is not writable/
+ * configurable, which prevents us from monkey-patching 'Platform''s methods.
+ * We circumvent this by adding 'setPlatformForTests'.
+ **/
+export declare function setPlatformForTests(platform: string): void;
+export declare function isCustomDevtoolsFrontend(): boolean;
+export declare function fontFamily(): string;

package/dist/lib/front_end/core/host/ResourceLoader.d.ts

@@ -0,0 +1,15 @@
+import * as Common from '../common/common.js';
+export declare const ResourceLoader: {};
+export declare const bindOutputStream: (stream: Common.StringOutputStream.OutputStream) => number;
+export declare const discardOutputStream: (id: number) => void;
+export declare const streamWrite: (id: number, chunk: string) => void;
+export interface LoadErrorDescription {
+    statusCode: number;
+    netError?: number;
+    netErrorName?: string;
+    urlValid?: boolean;
+    message?: string;
+}
+export declare const load: (url: string, headers: Record<string, string> | null, callback: (arg0: boolean, arg1: Record<string, string>, arg2: string, arg3: LoadErrorDescription) => void, allowRemoteFilePaths: boolean) => void;
+export declare function netErrorToMessage(netError: number | undefined, httpStatusCode: number | undefined, netErrorName: string | undefined): string | null;
+export declare const loadAsStream: (url: string, headers: Record<string, string> | null, stream: Common.StringOutputStream.OutputStream, callback?: ((arg0: boolean, arg1: Record<string, string>, arg2: LoadErrorDescription) => void), allowRemoteFilePaths?: boolean) => void;