chrome-devtools-frontend 1.0.1674545 → 1.0.1675430

package/.agents/skills/devtools-ux-writing-refactor/SKILL.md

@@ -59,14 +59,16 @@ Locate all TypeScript files in the target folder that define `const UIStrings =
    * For panel names that consist of two words, capitalize only the first word (for example, `Developer resources panel`).
    * When you use the panel name in combination with another word, capitalize the panel name but not the other word, unless it is a proper noun (for example, `Console view` or `DevTools Console`).
    * In some cases, ambiguity exists whether a word refers to a UX element in DevTools (such as a panel name) or a concept (such as developer terminology). For example, this occurs with `console`, `issue`, or `network`. Decide based on the surrounding context and code (for example, `Console view`, `Console sidebar`, and `Console prompt` versus `console message`, `console warning`, `console log`, `copy console`, `clear console`, and `console history`; `Show Network` versus `network log` and `network filter`).
+   * **Casing in `@description` comments:** Apply the same capitalization rules to `@description` comments: ONLY panel names use sentence case (for example, `Memory panel`, `Console panel`, `Performance panel`). Feature names, view names, tool names, and sub-components MUST be all lowercase unless they appear at the very start of the description sentence or phrase (for example, `heap profiler`, `heap snapshot view`, `isolate selector`, `allocation sampling`, `command menu`, `summary view`).
 6. **Punctuation and actionability:** Remove trailing periods from single-sentence labels or titles. Ensure that error messages instruct the user how to recover (for example, `Shorten filename to 64 characters or less` instead of `Invalid filename`). Ensure that ARIA labels and multi-sentence tooltips have consistent terminal punctuation.
 7. **Terminology (glossary):** Strictly follow standard DevTools UI terminology and letter casing (`panel`, `tab`, `drawer`, `sidebar`, `datagrid` or `table`, `action bar`, `status bar`, and `live expressions section`). Never use `pane` or call tabs `panes` in UI strings or localization (L10n) comments.
 8. **Localization (L10n) comments:** Ensure that every string in `UIStrings` has a preceding `@description` comment that explains where and when it appears. This information is used for translators who need to understand the context in which the string is used.
+   * **Research usage sites:** Before modifying or writing `@description` comments, always research where the string key (for example, `UIStrings.keyName`) is used in the codebase (`grep_search` or view surrounding code). Determine the exact UI element type (for example, button label, tooltip, table column header, context menu item, checkbox label, aria label, status bar message, or dropdown option) and location (panel, view, sidebar, or dialog).
+   * **Avoid redundancy and repetition:** Do not simply repeat or restate the UI string value in the description (for example, avoid `@description Text for clear all profiles` for `'Clear all profiles'`). Instead, describe the UI role, element type, and location (for example, `@description Tooltip text for the clear button in the profiles sidebar of the Memory panel.`).
+   * **Consistency across similar descriptions:** Ensure consistent phrasing structure across descriptions of similar UI strings in the same module and throughout DevTools (for example, use uniform patterns like `Tooltip text for the <action> button in <location>.` or `Column header in <table_name> datagrid for <purpose>.`).
+   * **Casing in descriptions:** Strictly follow the rule that ONLY panel names use sentence case (for example, `Memory panel`, `Console panel`, `Profiles panel`), while feature names, views, tools, and sub-components are ALL LOWERCASE (for example, `heap profiler`, `heap snapshot view`, `isolate selector`, `allocation sampling`, `summary view`), unless appearing at the start of the description sentence or phrase.
    * **Straight apostrophes in comments:** Always use straight apostrophes (`'`) in code comments (such as `@description` comments and L10n annotations), even if the UI string itself uses curly apostrophes (`’`).
-   * Use precise terminology and correct letter casing (see rule 7). Ensure that the description is easy to understand and provides enough context for translators. For descriptions that are underspecified or
-   ambiguous, figure out the context by looking at the use site of the
-   string and come up with a better description.
-   * You must explicitly document all standard placeholders (`{PH1}`, `{url}`, `{index}`) with runtime data examples (for example, `@example {https://example.com} url`).
+   * **Placeholders:** You must explicitly document all standard placeholders (`{PH1}`, `{url}`, `{index}`) with runtime data examples (for example, `@example {https://example.com} url`).
    * *ICU plural variables:* The i18n tool automatically parses variables in ICU plural format (such as `n` in `{n, plural, =0 {No issues} ...}`) as numeric counts, so they don’t require an `@example` tag in the `@description` comment.
    * *Terminal punctuation:* Every `@description` comment must end with a period (`.`), even if it is a single phrase or sentence.
 
@@ -74,11 +76,26 @@ Locate all TypeScript files in the target folder that define `const UIStrings =
 
 Also consult the style guides at `google3/experimental/users/rachelandrew/tools/chrome_writing/knowledge/style/` for applicable guidelines.
 
-## 5. Pause for confirmation
+## 5. Subagent critique of proposed changes
+
+Before running tests or pausing for user review, enter an iterative critique loop with a subagent:
+1. **Invoke subagent:** Use `invoke_subagent` with `TypeName: "self"` and `Role: "UX Writing Reviewer"`.
+2. **Prompt instructions:** Provide the subagent with the `git diff` of your changes and instruct it to critique the refactoring against the **8-point UX writing checklist**:
+   - Are `@description` comments specific, informative, and non-redundant (not restating string values)?
+   - Are usage sites researched so the UI element type and location are accurately described?
+   - Do `@description` comments and string values strictly follow the casing rule (ONLY panel names in sentence case, feature/view names in all lowercase unless starting a phrase)?
+   - Are contractions, curly apostrophes, ellipses, and placeholders (`{PH1}`) correctly formatted?
+   - Were all references in sibling code/tests properly updated?
+3. **Address feedback and loop:**
+   - If the subagent raises any feedback, concerns, or suggested fixes, apply the necessary code changes.
+   - Re-invoke the subagent with the updated `git diff` to re-critique the changes.
+   - **Repeat this loop continuously as long as the subagent has feedback, until the subagent explicitly approves the diff with no remaining issues.**
+
+## 6. Pause for confirmation
 
 Ask the user for a preliminary review of the proposed changes before proceeding. If the user has feedback, address feedback and pause again for confirmation.
 
-## 6. Mandatory verification and testing
+## 7. Mandatory verification and testing
 
 Don’t finish an edit without running the linter and test suite. In DevTools, i18n placeholder changes or string edits can easily break tests or linter rules.
 
@@ -89,18 +106,18 @@ Don’t finish an edit without running the linter and test suite. In DevTools, i
    npm run lint -- <folder_path>
    ```
 3. **Run unit tests**
-   Run unit tests for the target folder first for fast feedback. Then, run the full test suite to verify that no cross-module regressions or snapshot failures occurred:
+   You MUST run the full test suite using `npm run test` to verify that no cross-module regressions, e2e test failures, or snapshot regressions occurred. Do not only run a subset of tests:
    ```bash
-   npm run test -- <folder_path>
    npm run test
    ```
+   *(Optionally, you may run `npm run test -- <folder_path>` first for rapid initial feedback during iterative development, but running `npm run test` for full test suite coverage is required before completing the task.)*
 4. **Run presubmit checks**
    Ensure that you commit or stage all changes before you run presubmit checks:
    ```bash
    git cl presubmit -u
    ```
 
-## 7. Summarize changes and upload the CL
+## 8. Summarize changes and upload the CL
 
 When all tests and presubmit checks pass, commit your changes and upload the CL to Gerrit. Don’t use `[uxw]` as a prefix.
 

package/front_end/core/common/ParsedURL.ts

@@ -533,7 +533,11 @@ export class ParsedURL {
       return 'data:' as Platform.DevToolsPath.UrlString;
     }
     const scheme = this.isBlobURL() ? this.blobInnerScheme : this.scheme;
-    return scheme + '://' + this.domain() as Platform.DevToolsPath.UrlString;
+    const domain = this.domain();
+    if (!scheme && !domain) {
+      return '' as Platform.DevToolsPath.UrlString;
+    }
+    return scheme + '://' + domain as Platform.DevToolsPath.UrlString;
   }
 
   urlWithoutScheme(): string {

package/front_end/core/common/SettingRegistration.ts

@@ -82,12 +82,34 @@ const str_ = i18n.i18n.registerUIStrings('core/common/SettingRegistration.ts', U
 const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_);
 let registeredSettings: SettingRegistration[] = [];
 const settingNameSet = new Set<string>();
+const orderValuesBySettingCategory = new Map<SettingCategory, Set<number>>();
+
+export function registerCategoryOrder(category?: SettingCategory, order?: number): void {
+  if (category && typeof order === 'number') {
+    let orderValues = orderValuesBySettingCategory.get(category);
+    if (!orderValues) {
+      orderValues = new Set();
+      orderValuesBySettingCategory.set(category, orderValues);
+    }
+    if (orderValues.has(order)) {
+      throw new Error(`Duplicate order value '${order}' for settings category '${category}'`);
+    }
+    orderValues.add(order);
+  }
+}
+
+export function removeCategoryOrder(category?: SettingCategory, order?: number): void {
+  if (category && typeof order === 'number') {
+    orderValuesBySettingCategory.get(category)?.delete(order);
+  }
+}
 
 export function registerSettingExtension(registration: SettingRegistration): void {
   const settingName = registration.settingName;
   if (settingNameSet.has(settingName)) {
     throw new Error(`Duplicate setting name '${settingName}'`);
   }
+  registerCategoryOrder(registration.category, registration.order);
   settingNameSet.add(settingName);
   registeredSettings.push(registration);
 }
@@ -98,19 +120,17 @@ export function getRegisteredSettings(): SettingRegistration[] {
 
 export function registerSettingsForTest(settings: SettingRegistration[], forceReset = false): void {
   if (registeredSettings.length === 0 || forceReset) {
-    registeredSettings = settings;
-    settingNameSet.clear();
+    resetSettings();
     for (const setting of settings) {
-      const settingName = setting.settingName;
-      if (settingNameSet.has(settingName)) {
-        throw new Error(`Duplicate setting name '${settingName}'`);
-      }
-      settingNameSet.add(settingName);
+      registerSettingExtension(setting);
     }
   }
 }
 
 export function resetSettings(): void {
+  for (const setting of registeredSettings) {
+    removeCategoryOrder(setting.category, setting.order);
+  }
   registeredSettings = [];
   settingNameSet.clear();
 }
@@ -120,7 +140,8 @@ export function maybeRemoveSettingExtension(settingName: string): boolean {
   if (settingIndex < 0 || !settingNameSet.delete(settingName)) {
     return false;
   }
-  registeredSettings.splice(settingIndex, 1);
+  const [removed] = registeredSettings.splice(settingIndex, 1);
+  removeCategoryOrder(removed.category, removed.order);
   return true;
 }
 

package/front_end/core/common/Settings.ts

@@ -112,7 +112,6 @@ export class Settings {
   readonly #settingRegistrations: SettingRegistration[];
   readonly #sessionStorage = new SettingsStorage({});
   settingNameSet = new Set<string>();
-  orderValuesBySettingCategory = new Map<SettingCategory, Set<number>>();
   #eventSupport = new ObjectWrapper<GenericEvents>();
   #registry = new Map<string, Setting<unknown>>();
   readonly moduleSettings = new Map<string, Setting<unknown>>();
@@ -215,19 +214,9 @@ export class Settings {
 
   private registerModuleSetting(setting: Setting<unknown>): void {
     const settingName = setting.name;
-    const category = setting.category();
-    const order = setting.order();
     if (this.settingNameSet.has(settingName)) {
       throw new Error(`Duplicate Setting name '${settingName}'`);
     }
-    if (category && order) {
-      const orderValues = this.orderValuesBySettingCategory.get(category) || new Set();
-      if (orderValues.has(order)) {
-        throw new Error(`Duplicate order value '${order}' for settings category '${category}'`);
-      }
-      orderValues.add(order);
-      this.orderValuesBySettingCategory.set(category, orderValues);
-    }
     this.settingNameSet.add(settingName);
     this.moduleSettings.set(setting.name, setting);
   }

package/front_end/core/root/Runtime.ts

@@ -540,6 +540,9 @@ interface DevToolsPlusButton {
 interface DevToolsInstrumentationBreakpoints {
   enabled: boolean;
 }
+interface HostConfigDevToolsComments {
+  enabled: boolean;
+}
 
 /**
  * The host configuration that we expect from the DevTools back-end.
@@ -599,6 +602,7 @@ export type HostConfig = Platform.TypeScriptUtilities.RecursivePartial<{
   devToolsPlusButton: DevToolsPlusButton,
   devToolsInstrumentationBreakpoints: DevToolsInstrumentationBreakpoints,
   extensionsOnChromeUrls: ExtensionsOnChromeUrls,
+  devToolsComments: HostConfigDevToolsComments,
 }>;
 
 /**

package/front_end/core/sdk/TargetManager.ts

@@ -122,6 +122,24 @@ export class TargetManager extends Common.ObjectWrapper.ObjectWrapper<EventTypes
     Root.DevToolsContext.globalInstance().delete(TargetManager);
   }
 
+  // TODO(crbug.com/542394587): Should be `Symbol.dispose`
+  dispose(): void {
+    for (const target of this.targets()) {
+      target.dispose('TargetManager disposed');
+    }
+    if (this.#browserTarget) {
+      this.#browserTarget.dispose('TargetManager disposed');
+      this.#browserTarget = null;
+    }
+    this.#targets.clear();
+    this.#observers.clear();
+    this.#modelObservers.clear();
+    this.#modelListeners.clear();
+    this.#scopeChangeListeners.clear();
+    this.#scopeTarget = null;
+    this.#scopedObservers = new WeakSet();
+  }
+
   onInspectedURLChange(target: Target): void {
     if (target !== this.#scopeTarget) {
       return;

package/front_end/entrypoints/main/MainImpl.ts

@@ -209,6 +209,7 @@ export class MainImpl {
       hostConfig: Root.Runtime.hostConfig,
       inspectorFrontendHost: Host.InspectorFrontendHost.InspectorFrontendHostInstance,
       supportsEmulation: this.#supportsEmulation,
+      initAutomaticFilesystem: true,
     };
     this.#universe = new Foundation.Universe.Universe(creationOptions);
     Root.DevToolsContext.setGlobalInstance(this.#universe.context as Root.DevToolsContext.WritableDevToolsContext);

package/front_end/foundation/Universe.ts

@@ -28,6 +28,7 @@ export interface CreationOptions {
   hostConfig: Root.Runtime.HostConfig;
   inspectorFrontendHost: Host.InspectorFrontendHostAPI.InspectorFrontendHostAPI;
   supportsEmulation: boolean;
+  initAutomaticFilesystem?: boolean;
 }
 
 export class Universe {
@@ -37,6 +38,7 @@ export class Universe {
   readonly context: Root.DevToolsContext.DevToolsContext;
   readonly autofillManager: AutofillManager.AutofillManager.AutofillManager;
   readonly supportsEmulation: boolean;
+  readonly initAutomaticFilesystem: boolean;
   readonly fileSystemWorkspaceBinding: Persistence.FileSystemWorkspaceBinding.FileSystemWorkspaceBinding;
 
   constructor(options: CreationOptions) {
@@ -78,11 +80,17 @@ export class Universe {
     const multitargetNetworkManager = new SDK.NetworkManager.MultitargetNetworkManager(targetManager);
     context.set(SDK.NetworkManager.MultitargetNetworkManager, multitargetNetworkManager);
 
+    const workspace = new Workspace.Workspace.WorkspaceImpl();
+    context.set(Workspace.Workspace.WorkspaceImpl, workspace);
+
+    const fileManager = new Workspace.FileManager.FileManager();
+    context.set(Workspace.FileManager.FileManager, fileManager);
+
     this.supportsEmulation = options.supportsEmulation;
     let deviceModeModel = null;
     if (options.supportsEmulation) {
-      deviceModeModel =
-          new Emulation.DeviceModeModel.DeviceModeModel(targetManager, settings, multitargetNetworkManager);
+      deviceModeModel = new Emulation.DeviceModeModel.DeviceModeModel(targetManager, settings,
+                                                                      multitargetNetworkManager, fileManager);
       context.set(Emulation.DeviceModeModel.DeviceModeModel, deviceModeModel);
     }
 
@@ -90,15 +98,20 @@ export class Universe {
         new SDK.PageResourceLoader.PageResourceLoader(targetManager, settings, multitargetNetworkManager, null);
     context.set(SDK.PageResourceLoader.PageResourceLoader, pageResourceLoader);
 
-    const projectSettingsModel = new ProjectSettings.ProjectSettingsModel.ProjectSettingsModel(
-        pageResourceLoader,
-        targetManager,
-    );
-    context.set(ProjectSettings.ProjectSettingsModel.ProjectSettingsModel, projectSettingsModel);
-
-    const automaticFileSystemManager = new Persistence.AutomaticFileSystemManager.AutomaticFileSystemManager(
-        options.inspectorFrontendHost, projectSettingsModel);
-    context.set(Persistence.AutomaticFileSystemManager.AutomaticFileSystemManager, automaticFileSystemManager);
+    this.initAutomaticFilesystem = options.initAutomaticFilesystem ?? false;
+    let automaticFileSystemManager = null;
+    let projectSettingsModel = null;
+    if (this.initAutomaticFilesystem) {
+      projectSettingsModel = new ProjectSettings.ProjectSettingsModel.ProjectSettingsModel(
+          pageResourceLoader,
+          targetManager,
+      );
+      context.set(ProjectSettings.ProjectSettingsModel.ProjectSettingsModel, projectSettingsModel);
+
+      automaticFileSystemManager = new Persistence.AutomaticFileSystemManager.AutomaticFileSystemManager(
+          options.inspectorFrontendHost, projectSettingsModel);
+      context.set(Persistence.AutomaticFileSystemManager.AutomaticFileSystemManager, automaticFileSystemManager);
+    }
 
     const cpuThrottlingManager = new SDK.CPUThrottlingManager.CPUThrottlingManager(settings, targetManager);
     context.set(SDK.CPUThrottlingManager.CPUThrottlingManager, cpuThrottlingManager);
@@ -117,22 +130,18 @@ export class Universe {
     const domModelUndoStack = new SDK.DOMModel.DOMModelUndoStack();
     context.set(SDK.DOMModel.DOMModelUndoStack, domModelUndoStack);
 
-    const workspace = new Workspace.Workspace.WorkspaceImpl();
-    context.set(Workspace.Workspace.WorkspaceImpl, workspace);
-
-    const fileManager = new Workspace.FileManager.FileManager();
-    context.set(Workspace.FileManager.FileManager, fileManager);
-
-    const automaticFileSystemWorkspaceBinding =
-        new Persistence.AutomaticFileSystemWorkspaceBinding.AutomaticFileSystemWorkspaceBinding(
-            automaticFileSystemManager,
-            isolatedFileSystemManager,
-            workspace,
-        );
-    context.set(
-        Persistence.AutomaticFileSystemWorkspaceBinding.AutomaticFileSystemWorkspaceBinding,
-        automaticFileSystemWorkspaceBinding,
-    );
+    if (automaticFileSystemManager) {
+      const automaticFileSystemWorkspaceBinding =
+          new Persistence.AutomaticFileSystemWorkspaceBinding.AutomaticFileSystemWorkspaceBinding(
+              automaticFileSystemManager,
+              isolatedFileSystemManager,
+              workspace,
+          );
+      context.set(
+          Persistence.AutomaticFileSystemWorkspaceBinding.AutomaticFileSystemWorkspaceBinding,
+          automaticFileSystemWorkspaceBinding,
+      );
+    }
 
     this.fileSystemWorkspaceBinding =
         new Persistence.FileSystemWorkspaceBinding.FileSystemWorkspaceBinding(isolatedFileSystemManager, workspace);
@@ -226,6 +235,11 @@ export class Universe {
   dispose(): void {
     // TODO(crbug.com/542394587): Track these in a DisposableStack.
     this.context.get(Persistence.IsolatedFileSystemManager.IsolatedFileSystemManager).dispose();
+    if (this.initAutomaticFilesystem) {
+      this.context.get(Persistence.AutomaticFileSystemManager.AutomaticFileSystemManager).dispose();
+    }
+    this.context.get(Workspace.FileManager.FileManager).dispose();
+    this.context.get(SDK.TargetManager.TargetManager).dispose();
   }
 
   get automaticFileSystemManager(): Persistence.AutomaticFileSystemManager.AutomaticFileSystemManager {
@@ -338,8 +352,9 @@ export class Universe {
     return this.context.get(Bindings.PresentationConsoleMessageHelper.PresentationConsoleMessageManager);
   }
 
-  get projectSettingsModel(): ProjectSettings.ProjectSettingsModel.ProjectSettingsModel {
-    return this.context.get(ProjectSettings.ProjectSettingsModel.ProjectSettingsModel);
+  get projectSettingsModel(): ProjectSettings.ProjectSettingsModel.ProjectSettingsModel|null {
+    return this.initAutomaticFilesystem ? this.context.get(ProjectSettings.ProjectSettingsModel.ProjectSettingsModel) :
+                                          null;
   }
 
   get settings(): Common.Settings.Settings {

package/front_end/models/ai_assistance/agents/PerformanceAgent.ts

@@ -204,12 +204,22 @@ const STATIC_LABEL_NAMES: Record<string, string> = {
   NO_NAVIGATION: 'the period before the first navigation',
 };
 
+function getInsightModel(
+    model: Trace.Insights.Types.InsightModels,
+    key: string,
+    ): Trace.Insights.Types.InsightModels[keyof Trace.Insights.Types.InsightModels]|undefined {
+  if (Object.prototype.hasOwnProperty.call(model, key)) {
+    return model[key as keyof Trace.Insights.Types.InsightModels];
+  }
+  return undefined;
+}
+
 /**
  * Converts the label name we use in the code to a human readable one that is
  * shown to the user.
  */
 export function getLabelName(label: MainThreadSectionLabel, focus: AgentFocus): string {
-  if (STATIC_LABEL_NAMES[label]) {
+  if (Object.prototype.hasOwnProperty.call(STATIC_LABEL_NAMES, label)) {
     return STATIC_LABEL_NAMES[label];
   }
 
@@ -222,7 +232,7 @@ export function getLabelName(label: MainThreadSectionLabel, focus: AgentFocus):
   // Go through all the insights we have to find the first one that matches to find the title.
   // TODO(b/505291090): make it easier to look up Insight titles from a key.
   for (const insightSet of parsedTrace.insights?.values() ?? []) {
-    const model = insightSet.model[label as keyof Trace.Insights.Types.InsightModels];
+    const model = getInsightModel(insightSet.model, label);
     if (model) {
       return `${model.title} insight`;
     }
@@ -813,7 +823,7 @@ export class PerformanceAgent extends AiAgent<AgentFocus> {
           return {error: `Invalid insight set id. Valid insight set ids are: ${valid}`};
         }
 
-        const insight = insightSet.model[params.insightName as keyof Trace.Insights.Types.InsightModels];
+        const insight = getInsightModel(insightSet.model, params.insightName);
         if (!insight) {
           const valid = Object.keys(insightSet.model).join(', ');
           return {error: `No insight available. Valid insight names are: ${valid}`};
@@ -1361,14 +1371,14 @@ export class PerformanceAgent extends AiAgent<AgentFocus> {
     }
 
     if (insightSet) {
-      const model = insightSet.model[label as keyof Trace.Insights.Types.InsightModels];
+      const model = getInsightModel(insightSet.model, label);
       if (model) {
         return Trace.Insights.Common.insightBounds(model, insightSet.bounds);
       }
     }
 
     for (const is of parsedTrace.insights?.values() ?? []) {
-      const model = is.model[label as keyof Trace.Insights.Types.InsightModels];
+      const model = getInsightModel(is.model, label);
       if (model) {
         return Trace.Insights.Common.insightBounds(model, is.bounds);
       }