chrome-devtools-frontend 1.0.1675430 → 1.0.1678416

package/front_end/models/bindings/ResourceScriptMapping.ts

@@ -3,12 +3,9 @@
 // found in the LICENSE file.
 
 import * as Common from '../../core/common/common.js';
-import * as i18n from '../../core/i18n/i18n.js';
 import * as Platform from '../../core/platform/platform.js';
-import * as Root from '../../core/root/root.js';
 import * as SDK from '../../core/sdk/sdk.js';
 import * as TextUtils from '../../core/text_utils/text_utils.js';
-import * as Protocol from '../../generated/protocol.js';
 import * as Formatter from '../formatter/formatter.js';
 import * as Workspace from '../workspace/workspace.js';
 
@@ -17,21 +14,6 @@ import {type DebuggerSourceMapping, DebuggerWorkspaceBinding} from './DebuggerWo
 import {NetworkProject} from './NetworkProject.js';
 import {metadataForURL} from './ResourceUtils.js';
 
-const UIStrings = {
-  /**
-   * @description Error text displayed in the Console panel when editing a live script fails. LiveEdit is the name of the feature for editing code that is already running.
-   * @example {warning} PH1
-   */
-  liveEditFailed: '`LiveEdit` failed: {PH1}',
-  /**
-   * @description Error text displayed in the Console panel when compiling a live-edited script fails. LiveEdit is the name of the feature for editing code that is already running.
-   * @example {connection lost} PH1
-   */
-  liveEditCompileFailed: '`LiveEdit` compile failed: {PH1}',
-} as const;
-const str_ = i18n.i18n.registerUIStrings('models/bindings/ResourceScriptMapping.ts', UIStrings);
-const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);
-
 export class ResourceScriptMapping implements DebuggerSourceMapping {
   readonly debuggerModel: SDK.DebuggerModel.DebuggerModel;
   #workspace: Workspace.Workspace.WorkspaceImpl;
@@ -96,9 +78,6 @@ export class ResourceScriptMapping implements DebuggerSourceMapping {
     if (!scriptFile) {
       return null;
     }
-    if ((scriptFile.hasDivergedFromVM() && !scriptFile.isMergingToVM()) || scriptFile.isDivergingFromVM()) {
-      return null;
-    }
     if (scriptFile.script !== script) {
       return null;
     }
@@ -205,8 +184,7 @@ export class ResourceScriptMapping implements DebuggerSourceMapping {
   }
 
   private addScript(script: SDK.Script.Script): void {
-    // Ignore live edit scripts here.
-    if (script.isLiveEdit() || script.isBreakpointCondition) {
+    if (script.isBreakpointCondition) {
       return;
     }
 
@@ -272,10 +250,6 @@ export class ResourceScriptMapping implements DebuggerSourceMapping {
       if (!uiSourceCode) {
         continue;
       }
-      const scriptFile = this.#uiSourceCodeToScriptFile.get(uiSourceCode);
-      if (scriptFile) {
-        scriptFile.dispose();
-      }
 
       this.#uiSourceCodeToScriptFile.delete(uiSourceCode);
       this.#scriptToUISourceCode.delete(script);
@@ -325,177 +299,17 @@ export class ResourceScriptMapping implements DebuggerSourceMapping {
   }
 }
 
-export class ResourceScriptFile extends Common.ObjectWrapper.ObjectWrapper<ResourceScriptFile.EventTypes> {
+export class ResourceScriptFile {
   readonly #resourceScriptMapping: ResourceScriptMapping;
   readonly uiSourceCode: Workspace.UISourceCode.UISourceCode;
   readonly script: SDK.Script.Script|null;
-  #scriptSource?: string|null;
-  #isDivergingFromVM?: boolean;
-  #hasDivergedFromVM?: boolean;
-  #isMergingToVM?: boolean;
-  #updateMutex = new Common.Mutex.Mutex();
+
   constructor(
       resourceScriptMapping: ResourceScriptMapping, uiSourceCode: Workspace.UISourceCode.UISourceCode,
       script: SDK.Script.Script) {
-    super();
     this.#resourceScriptMapping = resourceScriptMapping;
     this.uiSourceCode = uiSourceCode;
     this.script = this.uiSourceCode.contentType().isScript() ? script : null;
-
-    this.uiSourceCode.addEventListener(Workspace.UISourceCode.Events.WorkingCopyChanged, this.workingCopyChanged, this);
-    this.uiSourceCode.addEventListener(
-        Workspace.UISourceCode.Events.WorkingCopyCommitted, this.workingCopyCommitted, this);
-  }
-
-  private isDiverged(): boolean {
-    if (this.uiSourceCode.isDirty()) {
-      return true;
-    }
-    if (!this.script) {
-      return false;
-    }
-    if (typeof this.#scriptSource === 'undefined' || this.#scriptSource === null) {
-      return false;
-    }
-    const workingCopy = this.uiSourceCode.workingCopy();
-    if (!workingCopy) {
-      return false;
-    }
-
-    // Match ignoring sourceURL.
-    if (!workingCopy.startsWith(this.#scriptSource.trimEnd())) {
-      return true;
-    }
-    const suffix = this.uiSourceCode.workingCopy().substr(this.#scriptSource.length);
-    return Boolean(suffix.length) && !suffix.match(SDK.Script.sourceURLRegex);
-  }
-
-  private workingCopyChanged(): void {
-    void this.update();
-  }
-
-  private workingCopyCommitted(): void {
-    // This feature flag is for turning down live edit. If it's not present, we keep the feature enabled.
-    if (Root.Runtime.hostConfig.devToolsLiveEdit?.enabled === false) {
-      return;
-    }
-
-    if (this.uiSourceCode.project().canSetFileContent()) {
-      return;
-    }
-    if (!this.script) {
-      return;
-    }
-
-    const source = this.uiSourceCode.workingCopy();
-    void this.script.editSource(source).then(({status, exceptionDetails}) => {
-      void this.scriptSourceWasSet(source, status, exceptionDetails);
-    });
-  }
-
-  async scriptSourceWasSet(
-      source: string, status: Protocol.Debugger.SetScriptSourceResponseStatus,
-      exceptionDetails?: Protocol.Runtime.ExceptionDetails): Promise<void> {
-    if (status === Protocol.Debugger.SetScriptSourceResponseStatus.Ok) {
-      this.#scriptSource = source;
-    }
-    await this.update();
-
-    if (status === Protocol.Debugger.SetScriptSourceResponseStatus.Ok) {
-      return;
-    }
-
-    if (!exceptionDetails) {
-      // TODO(crbug.com/1334484): Instead of to the console, report these errors in an "info bar" at the bottom
-      //                          of the text editor, similar to e.g. source mapping errors.
-      // eslint-disable-next-line @devtools/no-instance-of-migrated-singletons
-      Common.Console.Console.instance().addMessage(
-          i18nString(UIStrings.liveEditFailed, {PH1: getErrorText(status)}), Common.Console.MessageLevel.WARNING);
-      return;
-    }
-    const messageText = i18nString(UIStrings.liveEditCompileFailed, {PH1: exceptionDetails.text});
-    this.uiSourceCode.addLineMessage(
-        Workspace.UISourceCode.Message.Level.ERROR, messageText, exceptionDetails.lineNumber,
-        exceptionDetails.columnNumber);
-
-    function getErrorText(status: Protocol.Debugger.SetScriptSourceResponseStatus): string {
-      switch (status) {
-        case Protocol.Debugger.SetScriptSourceResponseStatus.BlockedByActiveFunction:
-          return 'Functions that are on the stack (currently being executed) can’t be edited';
-        case Protocol.Debugger.SetScriptSourceResponseStatus.BlockedByActiveGenerator:
-          return 'Async functions/generators that are active can’t be edited';
-        case Protocol.Debugger.SetScriptSourceResponseStatus.BlockedByTopLevelEsModuleChange:
-          return 'The top level of JavaScript modules can’t be edited';
-        case Protocol.Debugger.SetScriptSourceResponseStatus.CompileError:
-        case Protocol.Debugger.SetScriptSourceResponseStatus.Ok:
-          throw new Error('Compile errors and Ok status must not be reported on the console');
-      }
-    }
-  }
-
-  private async update(): Promise<void> {
-    // Do not interleave "divergeFromVM" with "mergeToVM" calls.
-    const release = await this.#updateMutex.acquire();
-    const diverged = this.isDiverged();
-    if (diverged && !this.#hasDivergedFromVM) {
-      await this.divergeFromVM();
-    } else if (!diverged && this.#hasDivergedFromVM) {
-      await this.mergeToVM();
-    }
-    release();
-  }
-
-  private async divergeFromVM(): Promise<void> {
-    if (this.script) {
-      this.#isDivergingFromVM = true;
-      await this.#resourceScriptMapping.debuggerWorkspaceBinding.updateLocations(this.script);
-      this.#isDivergingFromVM = undefined;
-      this.#hasDivergedFromVM = true;
-      this.dispatchEventToListeners(ResourceScriptFile.Events.DID_DIVERGE_FROM_VM);
-    }
-  }
-
-  private async mergeToVM(): Promise<void> {
-    if (this.script) {
-      this.#hasDivergedFromVM = undefined;
-      this.#isMergingToVM = true;
-      await this.#resourceScriptMapping.debuggerWorkspaceBinding.updateLocations(this.script);
-      this.#isMergingToVM = undefined;
-      this.dispatchEventToListeners(ResourceScriptFile.Events.DID_MERGE_TO_VM);
-    }
-  }
-
-  hasDivergedFromVM(): boolean {
-    return Boolean(this.#hasDivergedFromVM);
-  }
-
-  isDivergingFromVM(): boolean {
-    return Boolean(this.#isDivergingFromVM);
-  }
-
-  isMergingToVM(): boolean {
-    return Boolean(this.#isMergingToVM);
-  }
-
-  checkMapping(): void {
-    if (!this.script || typeof this.#scriptSource !== 'undefined') {
-      this.mappingCheckedForTest();
-      return;
-    }
-    void this.script.requestContentData().then(content => {
-      this.#scriptSource = TextUtils.ContentData.ContentData.textOr(content, null);
-      void this.update().then(() => this.mappingCheckedForTest());
-    });
-  }
-
-  private mappingCheckedForTest(): void {
-  }
-
-  dispose(): void {
-    this.uiSourceCode.removeEventListener(
-        Workspace.UISourceCode.Events.WorkingCopyChanged, this.workingCopyChanged, this);
-    this.uiSourceCode.removeEventListener(
-        Workspace.UISourceCode.Events.WorkingCopyCommitted, this.workingCopyCommitted, this);
   }
 
   addSourceMapURL(sourceMapURL: Platform.DevToolsPath.UrlString): void {
@@ -527,15 +341,3 @@ export class ResourceScriptFile extends Common.ObjectWrapper.ObjectWrapper<Resou
     return sources && 'missingSymbolFiles' in sources ? sources.missingSymbolFiles : null;
   }
 }
-
-export namespace ResourceScriptFile {
-  export const enum Events {
-    DID_MERGE_TO_VM = 'DidMergeToVM',
-    DID_DIVERGE_FROM_VM = 'DidDivergeFromVM',
-  }
-
-  export interface EventTypes {
-    [Events.DID_MERGE_TO_VM]: void;
-    [Events.DID_DIVERGE_FROM_VM]: void;
-  }
-}

package/front_end/models/bindings/SASSSourceMapping.ts

@@ -140,6 +140,12 @@ export class SASSSourceMapping implements SourceMapping {
     return [];
   }
 
+  static sourceMapURLsForUISourceCode(uiSourceCode: Workspace.UISourceCode.UISourceCode):
+      Platform.DevToolsPath.UrlString[] {
+    const binding = uiSourceCodeToBinding.get(uiSourceCode);
+    return binding?.getReferringSourceMaps().map(sourceMap => sourceMap.url()) ?? [];
+  }
+
   dispose(): void {
     Common.EventTarget.removeEventListeners(this.#eventListeners);
     this.#project.dispose();

package/front_end/models/breakpoints/BreakpointManager.ts

@@ -8,7 +8,7 @@ import {assertNotNullOrUndefined} from '../../core/platform/platform.js';
 import * as Root from '../../core/root/root.js';
 import * as SDK from '../../core/sdk/sdk.js';
 import type * as TextUtils from '../../core/text_utils/text_utils.js';
-import * as Protocol from '../../generated/protocol.js';
+import type * as Protocol from '../../generated/protocol.js';
 import * as Bindings from '../bindings/bindings.js';
 import * as Formatter from '../formatter/formatter.js';
 import * as SourceMapScopes from '../source_map_scopes/source_map_scopes.js';
@@ -608,7 +608,6 @@ export class Breakpoint implements SDK.TargetManager.SDKModelObserver<SDK.Debugg
 
     debuggerModel.addEventListener(SDK.DebuggerModel.Events.DebuggerWasEnabled, this.#onDebuggerEnabled, this);
     debuggerModel.addEventListener(SDK.DebuggerModel.Events.DebuggerWasDisabled, this.#onDebuggerDisabled, this);
-    debuggerModel.addEventListener(SDK.DebuggerModel.Events.ScriptSourceWasEdited, this.#onScriptWasEdited, this);
   }
 
   modelRemoved(debuggerModel: SDK.DebuggerModel.DebuggerModel): void {
@@ -622,7 +621,6 @@ export class Breakpoint implements SDK.TargetManager.SDKModelObserver<SDK.Debugg
   #removeDebuggerModelListeners(debuggerModel: SDK.DebuggerModel.DebuggerModel): void {
     debuggerModel.removeEventListener(SDK.DebuggerModel.Events.DebuggerWasEnabled, this.#onDebuggerEnabled, this);
     debuggerModel.removeEventListener(SDK.DebuggerModel.Events.DebuggerWasDisabled, this.#onDebuggerDisabled, this);
-    debuggerModel.removeEventListener(SDK.DebuggerModel.Events.ScriptSourceWasEdited, this.#onScriptWasEdited, this);
   }
 
   #onDebuggerEnabled(event: Common.EventTarget.EventTargetEvent<SDK.DebuggerModel.DebuggerModel>): void {
@@ -639,29 +637,6 @@ export class Breakpoint implements SDK.TargetManager.SDKModelObserver<SDK.Debugg
     model?.cleanUpAfterDebuggerIsGone();
   }
 
-  async #onScriptWasEdited(
-      event: Common.EventTarget
-          .EventTargetEvent<{script: SDK.Script.Script, status: Protocol.Debugger.SetScriptSourceResponseStatus}>):
-      Promise<void> {
-    const {source: debuggerModel, data: {script, status}} = event;
-    if (status !== Protocol.Debugger.SetScriptSourceResponseStatus.Ok) {
-      return;
-    }
-
-    // V8 throws away breakpoints on all functions in a live edited script. Here we attempt to re-set them again at the
-    // same position. This is because we don't know what was edited and how the breakpoint should move, e.g. if the file
-    // was originally changed on the filesystem (via workspace).
-    // If the live edit originated in DevTools (in CodeMirror), then the `DebuggerPlugin` will remove the breakpoint
-    // wholesale and re-apply based on the diff.
-
-    console.assert(debuggerModel instanceof SDK.DebuggerModel.DebuggerModel);
-    const model = this.#modelBreakpoints.get(debuggerModel as SDK.DebuggerModel.DebuggerModel);
-    if (model?.wasSetIn(script.scriptId)) {
-      await model.resetBreakpoint();
-      void this.#updateModel(model);
-    }
-  }
-
   modelBreakpoint(debuggerModel: SDK.DebuggerModel.DebuggerModel): ModelBreakpoint|undefined {
     return this.#modelBreakpoints.get(debuggerModel);
   }
@@ -966,11 +941,6 @@ export class ModelBreakpoint {
   #cancelCallback = false;
   #currentState: Breakpoint.State|null = null;
   #breakpointIds: Protocol.Debugger.BreakpointId[] = [];
-  /**
-   * We track all the script IDs this ModelBreakpoint was actually set in. This allows us
-   * to properly reset this ModelBreakpoint after a script was live edited.
-   */
-  #resolvedScriptIds = new Set<Protocol.Runtime.ScriptId>();
 
   constructor(
       debuggerModel: SDK.DebuggerModel.DebuggerModel, breakpoint: Breakpoint,
@@ -991,7 +961,6 @@ export class ModelBreakpoint {
 
     this.#uiLocations.clear();
     this.#liveLocations.disposeAll();
-    this.#resolvedScriptIds.clear();
   }
 
   async scheduleUpdateInDebugger(): Promise<ScheduleUpdateResult> {
@@ -1021,16 +990,6 @@ export class ModelBreakpoint {
     return result;
   }
 
-  private scriptDiverged(): boolean {
-    for (const uiSourceCode of this.#breakpoint.getUiSourceCodes()) {
-      const scriptFile = this.#debuggerWorkspaceBinding.scriptFile(uiSourceCode, this.#debuggerModel);
-      if (scriptFile?.hasDivergedFromVM()) {
-        return true;
-      }
-    }
-    return false;
-  }
-
   async #updateInDebugger(): Promise<DebuggerUpdateResult> {
     if (this.#debuggerModel.target().isDisposed()) {
       this.cleanUpAfterDebuggerIsGone();
@@ -1042,7 +1001,7 @@ export class ModelBreakpoint {
 
     // Calculate the new state.
     let newState: Breakpoint.State|null = null;
-    if (!this.#breakpoint.getIsRemoved() && this.#breakpoint.enabled() && !this.scriptDiverged()) {
+    if (!this.#breakpoint.getIsRemoved() && this.#breakpoint.enabled()) {
       let debuggerLocations: SDK.DebuggerModel.Location[] = [];
       for (const uiSourceCode of this.#breakpoint.getUiSourceCodes()) {
         const {lineNumber: uiLineNumber, columnNumber: uiColumnNumber} =
@@ -1226,7 +1185,6 @@ export class ModelBreakpoint {
   }
 
   private async addResolvedLocation(location: SDK.DebuggerModel.Location): Promise<ResolveLocationResult> {
-    this.#resolvedScriptIds.add(location.scriptId);
     const uiLocation = await this.#debuggerWorkspaceBinding.rawLocationToUILocation(location);
     if (!uiLocation) {
       return ResolveLocationResult.OK;
@@ -1249,11 +1207,6 @@ export class ModelBreakpoint {
       this.didRemoveFromDebugger();
     }
   }
-
-  /** @returns true, iff this `ModelBreakpoint` was set (at some point) in `scriptId` */
-  wasSetIn(scriptId: Protocol.Runtime.ScriptId): boolean {
-    return this.#resolvedScriptIds.has(scriptId);
-  }
 }
 
 /**

package/front_end/models/comment_manager/CommentManager.ts

@@ -0,0 +1,141 @@
+// Copyright 2026 The Chromium Authors
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import * as Common from '../../core/common/common.js';
+import * as Root from '../../core/root/root.js';
+
+export interface EditorAnchorSignature {
+  /** 1-based line number for CodeMirror text editor anchors */
+  lineNumber: number;
+  /** File path associated with the editor */
+  filePath?: string;
+}
+
+export interface CommentAnchorSignature {
+  /** Visual logging tree path, e.g. "Panel: elements > Pane: styles > TreeOutline > TreeItem: color" */
+  vePath: string;
+  /** Normalized text content of the target node */
+  textSignature: string;
+  /** Text content of the parent container VE node for sibling disambiguation */
+  parentTextSignature?: string;
+  /** 0-indexed position among siblings sharing the same visual logging path */
+  siblingIndex?: number;
+  /** Optional backend RequestId for Network panel elements (`data-network-request-id`) */
+  networkRequestId?: string;
+  /** Optional backend NodeId for Elements panel DOM nodes (`data-backend-node-id`) */
+  backendNodeId?: number;
+  /** Optional editor anchor coordinates for CodeMirror text editors */
+  editor?: EditorAnchorSignature;
+}
+
+export interface Comment {
+  author: 'DEVELOPER'|'AGENT';
+  text: string;
+  timestamp: number;
+}
+
+export interface CommentThread {
+  id: string;
+  anchor: CommentAnchorSignature;
+  comments: Comment[];
+  status: 'ACTIVE'|'RESOLVED';
+  changes?: Array<Record<string, unknown>>;
+}
+
+export interface CommentManagerCreationOptions {
+  forceNew?: boolean|null;
+}
+
+export const enum Events {
+  COMMENT_THREADS_CHANGED = 'CommentThreadsChanged',
+  COMMENT_MODE_CHANGED = 'CommentModeChanged',
+}
+
+export interface EventTypes {
+  [Events.COMMENT_THREADS_CHANGED]: CommentThread[];
+  [Events.COMMENT_MODE_CHANGED]: boolean;
+}
+
+/**
+ * Headless model managing comment thread data, CRUD operations, and comment mode.
+ */
+export class CommentManager extends Common.ObjectWrapper.ObjectWrapper<EventTypes> {
+  readonly #commentThreads = new Map<string, CommentThread>();
+  #commentMode = false;
+  #nextId = 1;
+
+  /**
+   * IMPORTANT: This method MUST only be called in MainImpl. All other components
+   * should receive CommentManager via dependency injection (INJECT or constructor argument).
+   */
+  static instance(opts: CommentManagerCreationOptions = {forceNew: null}): CommentManager {
+    const {forceNew} = opts;
+    if (!Root.DevToolsContext.globalInstance().has(CommentManager) || forceNew) {
+      Root.DevToolsContext.globalInstance().set(CommentManager, new CommentManager());
+    }
+    return Root.DevToolsContext.globalInstance().get(CommentManager);
+  }
+
+  static removeInstance(): void {
+    Root.DevToolsContext.globalInstance().delete(CommentManager);
+  }
+
+  setCommentMode(active: boolean): void {
+    if (this.#commentMode === active) {
+      return;
+    }
+    this.#commentMode = active;
+    this.dispatchEventToListeners(Events.COMMENT_MODE_CHANGED, active);
+  }
+
+  isCommentMode(): boolean {
+    return this.#commentMode;
+  }
+
+  createCommentThread(
+      anchor: CommentAnchorSignature,
+      text: string,
+      author: 'DEVELOPER'|'AGENT' = 'DEVELOPER',
+      changes?: Array<Record<string, unknown>>,
+      ): CommentThread {
+    const id = `comment-${this.#nextId++}`;
+    const thread: CommentThread = {
+      id,
+      anchor,
+      comments: [{
+        author,
+        text,
+        timestamp: Date.now(),
+      }],
+      status: 'ACTIVE',
+      changes,
+    };
+
+    this.#commentThreads.set(id, thread);
+    this.dispatchEventToListeners(Events.COMMENT_THREADS_CHANGED, this.getCommentThreads());
+    return thread;
+  }
+
+  getCommentThread(id: string): CommentThread|undefined {
+    return this.#commentThreads.get(id);
+  }
+
+  getCommentThreads(): CommentThread[] {
+    return Array.from(this.#commentThreads.values());
+  }
+
+  removeCommentThread(id: string): void {
+    if (!this.#commentThreads.has(id)) {
+      return;
+    }
+    this.#commentThreads.delete(id);
+    this.dispatchEventToListeners(Events.COMMENT_THREADS_CHANGED, this.getCommentThreads());
+  }
+
+  clear(): void {
+    this.setCommentMode(false);
+    this.#commentThreads.clear();
+    this.dispatchEventToListeners(Events.COMMENT_THREADS_CHANGED, []);
+  }
+}

package/front_end/models/comment_manager/comment_manager.ts

@@ -0,0 +1,9 @@
+// Copyright 2026 The Chromium Authors
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import * as CommentManager from './CommentManager.js';
+
+export {
+  CommentManager,
+};

package/front_end/models/heap_snapshot/HeapSnapshotModel.ts

@@ -335,6 +335,15 @@ export interface NativeContextSizes {
   noAttributionSize: number;
 }
 
+export interface RetainedByContextSummary {
+  contextCount: number;
+  retainedByContextSize: number;
+  retainedByContextCount: number;
+  notRetainedByContextSize: number;
+  notRetainedByContextCount: number;
+  totalSize: number;
+}
+
 export const enum DOMLinkState {
   UNKNOWN = 0,
   ATTACHED = 1,
@@ -353,3 +362,21 @@ export interface ObjectInfo {
   edgeCount: number;
   retainerCount: number;
 }
+
+export interface HeapQueryOptions {
+  className?: string;
+  propertyName?: string;
+  nodeType?: string;
+  minRetainedSize?: number;
+  maxRetainedSize?: number;
+  minSelfSize?: number;
+  maxSelfSize?: number;
+  isDetached?: boolean;
+  sortBy?: 'retainedSize'|'selfSize'|'id';
+}
+
+export interface HeapEdgesQueryOptions {
+  sortBy?: 'retainedSize'|'selfSize'|'name';
+  minRetainedSize?: number;
+  excludePrimitives?: boolean;
+}

package/front_end/models/heap_snapshot/HeapSnapshotProxy.ts

@@ -280,6 +280,10 @@ export class HeapSnapshotProxy extends HeapSnapshotProxyObject {
     return this.callMethodPromise('getNativeContextSizes');
   }
 
+  getRetainedByContextSummary(): Promise<HeapSnapshotModel.RetainedByContextSummary> {
+    return this.callMethodPromise('getRetainedByContextSummary');
+  }
+
   aggregatesWithFilter(filter: HeapSnapshotModel.NodeFilter):
       Promise<Record<string, HeapSnapshotModel.AggregatedInfo>> {
     return this.callMethodPromise('aggregatesWithFilter', filter);
@@ -312,8 +316,8 @@ export class HeapSnapshotProxy extends HeapSnapshotProxyObject {
     return this.callMethodPromise('getObjectInfo', nodeIndex);
   }
 
-  createEdgesProvider(nodeIndex: number): HeapSnapshotProviderProxy {
-    return this.callFactoryMethod('createEdgesProvider', HeapSnapshotProviderProxy, nodeIndex);
+  createEdgesProvider(nodeIndex: number, options?: HeapSnapshotModel.HeapEdgesQueryOptions): HeapSnapshotProviderProxy {
+    return this.callFactoryMethod('createEdgesProvider', HeapSnapshotProviderProxy, nodeIndex, options);
   }
 
   createRetainingEdgesProvider(nodeIndex: number): HeapSnapshotProviderProxy {
@@ -336,6 +340,10 @@ export class HeapSnapshotProxy extends HeapSnapshotProxyObject {
     return this.callFactoryMethod('createNodesProviderForClass', HeapSnapshotProviderProxy, classKey, nodeFilter);
   }
 
+  queryObjects(queryOptions: HeapSnapshotModel.HeapQueryOptions): HeapSnapshotProviderProxy {
+    return this.callFactoryMethod('queryObjects', HeapSnapshotProviderProxy, queryOptions);
+  }
+
   allocationTracesTops(): Promise<HeapSnapshotModel.SerializedAllocationNode[]> {
     return this.callMethodPromise('allocationTracesTops');
   }

package/front_end/models/issues_manager/descriptions/connectionAllowlistEmbeddingRequirementNotSatisfied.md

@@ -0,0 +1,26 @@
+# A framed document did not accept its embedder's `Connection-Allowlist`.
+
+An embedder can require a framed document to enforce a `Connection-Allowlist` by
+setting the `connectionallowlist` attribute on the frame. The framed document
+must agree, in one of two ways:
+
+*   by responding with an `Allow-Connection-Allowlist-From` header naming the
+    embedder's origin (or `*` to accept any embedder), which installs the
+    embedder's allowlist on the framed document, or
+*   by responding with a `Connection-Allowlist` header of its own that is at
+    least as strict as the one required, which is then enforced instead.
+
+This response did neither, so it was not displayed.
+
+For example, a document framed by an embedder requiring
+`("https://cdn.example/")` may accept that requirement outright:
+
+```
+Allow-Connection-Allowlist-From: *
+```
+
+or satisfy it with an allowlist that is no more permissive:
+
+```
+Connection-Allowlist: ("https://cdn.example/")
+```

package/front_end/models/issues_manager/descriptions/connectionAllowlistIFrameAttributeLoosensEmbeddingRequirement.md

@@ -0,0 +1,19 @@
+# A frame's `connectionallowlist` attribute was discarded.
+
+An embedder can require a framed document to enforce a `Connection-Allowlist` by
+setting the `connectionallowlist` attribute on the frame. When a requirement is
+already in effect for the embedder itself, a nested frame's attribute may only
+make that requirement stricter, never looser.
+
+This frame's attribute allowed connections that the requirement it inherits from
+an ancestor does not, so the attribute was discarded and the inherited
+requirement applies unchanged.
+
+For example, the nested frame below cannot re-admit `https://example.com/`, so
+it inherits `("https://cdn.example/")` rather than the value it asked for:
+
+```
+<!-- Framed by an ancestor that requires ("https://cdn.example/"): -->
+<iframe connectionallowlist='("https://cdn.example/" "https://example.com/")'
+        src="..."></iframe>
+```

package/front_end/models/issues_manager/descriptions/connectionAllowlistInvalidAllowConnectionAllowlistFrom.md

@@ -0,0 +1,21 @@
+# The `Allow-Connection-Allowlist-From` header is invalid.
+
+A document that is framed by an embedder requiring a `Connection-Allowlist` can
+accept that requirement by responding with an `Allow-Connection-Allowlist-From`
+header. The header's value must be either `*`, or a single serialized origin
+naming the embedder whose requirement it is willing to accept.
+
+This response's header was neither, so it could not be used to accept the
+embedder's requirement.
+
+For example, both of the following are valid:
+
+```
+Allow-Connection-Allowlist-From: *
+Allow-Connection-Allowlist-From: https://example.com
+```
+
+Note that an origin's serialization has no trailing slash, and carries no path,
+query, or userinfo. Values like `https://example.com/` and
+`https://user@example.com/path` are therefore rejected rather than being
+silently reinterpreted as `https://example.com`.