chrome-devtools-frontend 1.0.1651641 → 1.0.1654411

package/front_end/generated/SupportedCSSProperties.js

@@ -20,7 +20,7 @@ export const generatedProperties = [
   ],
   "name": "-alternative-webkit-line-clamp-longhand",
   "runtime_flag": "CSSLineClamp",
-  "runtime_flag_status": "stable"
+  "runtime_flag_status": "experimental"
  },
  {
   "longhands": [
@@ -216,6 +216,10 @@ export const generatedProperties = [
  },
  {
   "inherited": true,
+  "keywords": [
+   "before",
+   "after"
+  ],
   "name": "-webkit-ruby-position"
  },
  {
@@ -249,6 +253,12 @@ export const generatedProperties = [
  },
  {
   "inherited": true,
+  "keywords": [
+   "sideways",
+   "upright",
+   "sideways-right",
+   "vertical-right"
+  ],
   "name": "-webkit-text-orientation"
  },
  {
@@ -2150,8 +2160,7 @@ export const generatedProperties = [
    "layout",
    "style",
    "paint",
-   "inline-size",
-   "block-size"
+   "inline-size"
   ],
   "name": "contain"
  },
@@ -2674,6 +2683,35 @@ export const generatedProperties = [
   "name": "direction"
  },
  {
+  "devtools_keywords": [
+   "inline",
+   "block",
+   "list-item",
+   "inline-block",
+   "table",
+   "inline-table",
+   "table-row-group",
+   "table-header-group",
+   "table-footer-group",
+   "table-row",
+   "table-column-group",
+   "table-column",
+   "table-cell",
+   "table-caption",
+   "-webkit-box",
+   "-webkit-inline-box",
+   "flex",
+   "inline-flex",
+   "grid",
+   "inline-grid",
+   "contents",
+   "flow-root",
+   "none",
+   "flow",
+   "math",
+   "ruby",
+   "ruby-text"
+  ],
   "keywords": [
    "inline",
    "block",
@@ -3427,8 +3465,6 @@ export const generatedProperties = [
   "inherited": true,
   "keywords": [
    "auto",
-   "optimizespeed",
-   "optimizequality",
    "-webkit-optimize-contrast",
    "pixelated",
    "crisp-edges"
@@ -3588,6 +3624,13 @@ export const generatedProperties = [
   "name": "lighting-color"
  },
  {
+  "devtools_keywords": [
+   "auto",
+   "loose",
+   "normal",
+   "strict",
+   "anywhere"
+  ],
   "inherited": true,
   "keywords": [
    "auto",
@@ -3600,6 +3643,12 @@ export const generatedProperties = [
   "name": "line-break"
  },
  {
+  "devtools_keywords": [
+   "none",
+   "auto",
+   "ellipsis",
+   "no-ellipsis"
+  ],
   "keywords": [
    "none",
    "auto",
@@ -3609,7 +3658,7 @@ export const generatedProperties = [
   ],
   "name": "line-clamp",
   "runtime_flag": "CSSLineClamp",
-  "runtime_flag_status": "stable"
+  "runtime_flag_status": "experimental"
  },
  {
   "is_descriptor": true,
@@ -4082,6 +4131,18 @@ export const generatedProperties = [
   "name": "outline-offset"
  },
  {
+  "devtools_keywords": [
+   "none",
+   "auto",
+   "inset",
+   "groove",
+   "outset",
+   "ridge",
+   "dotted",
+   "dashed",
+   "solid",
+   "double"
+  ],
   "keywords": [
    "none",
    "hidden",
@@ -4433,7 +4494,43 @@ export const generatedProperties = [
    "end",
    "self-start",
    "self-end",
-   "all"
+   "span-all",
+   "span-left",
+   "span-right",
+   "span-x-start",
+   "span-x-end",
+   "self-x-start",
+   "self-x-end",
+   "span-self-x-start",
+   "span-self-x-end",
+   "span-top",
+   "span-bottom",
+   "span-y-start",
+   "span-y-end",
+   "self-y-start",
+   "self-y-end",
+   "span-self-y-start",
+   "span-self-y-end",
+   "block-start",
+   "block-end",
+   "span-block-start",
+   "span-block-end",
+   "inline-start",
+   "inline-end",
+   "span-inline-start",
+   "span-inline-end",
+   "self-block-start",
+   "self-block-end",
+   "span-self-block-start",
+   "span-self-block-end",
+   "self-inline-start",
+   "self-inline-end",
+   "span-self-inline-start",
+   "span-self-inline-end",
+   "span-start",
+   "span-end",
+   "span-self-start",
+   "span-self-end"
   ],
   "name": "position-area"
  },
@@ -5275,6 +5372,17 @@ export const generatedProperties = [
   "name": "table-layout"
  },
  {
+  "devtools_keywords": [
+   "left",
+   "right",
+   "center",
+   "justify",
+   "-webkit-left",
+   "-webkit-right",
+   "-webkit-center",
+   "start",
+   "end"
+  ],
   "inherited": true,
   "keywords": [
    "left",
@@ -5291,6 +5399,15 @@ export const generatedProperties = [
   "name": "text-align"
  },
  {
+  "devtools_keywords": [
+   "auto",
+   "start",
+   "end",
+   "left",
+   "right",
+   "center",
+   "justify"
+  ],
   "inherited": true,
   "keywords": [
    "auto",
@@ -5474,7 +5591,8 @@ export const generatedProperties = [
   "keywords": [
    "sideways",
    "mixed",
-   "upright"
+   "upright",
+   "sideways-right"
   ],
   "name": "text-orientation"
  },
@@ -5531,6 +5649,13 @@ export const generatedProperties = [
   "name": "text-spacing-trim"
  },
  {
+  "devtools_keywords": [
+   "none",
+   "capitalize",
+   "uppercase",
+   "lowercase",
+   "math-auto"
+  ],
   "inherited": true,
   "keywords": [
    "none",
@@ -5588,6 +5713,9 @@ export const generatedProperties = [
   "name": "text-wrap-style"
  },
  {
+  "devtools_keywords": [
+   "none"
+  ],
   "keywords": [
    "none",
    "all"
@@ -5799,6 +5927,12 @@ export const generatedProperties = [
   "name": "unicode-range"
  },
  {
+  "devtools_keywords": [
+   "auto",
+   "none",
+   "text",
+   "all"
+  ],
   "inherited": true,
   "keywords": [
    "auto",
@@ -5868,6 +6002,9 @@ export const generatedProperties = [
   "name": "view-transition-group"
  },
  {
+  "devtools_keywords": [
+   "none"
+  ],
   "keywords": [
    "none",
    "auto"
@@ -6083,6 +6220,12 @@ export const generatedPropertyValues = {
    "visual"
   ]
  },
+ "-webkit-ruby-position": {
+  "values": [
+   "before",
+   "after"
+  ]
+ },
  "-webkit-text-combine": {
   "values": [
    "none",
@@ -6100,6 +6243,14 @@ export const generatedPropertyValues = {
    "grammar-error"
   ]
  },
+ "-webkit-text-orientation": {
+  "values": [
+   "sideways",
+   "upright",
+   "sideways-right",
+   "vertical-right"
+  ]
+ },
  "-webkit-text-security": {
   "values": [
    "none",
@@ -6912,8 +7063,7 @@ export const generatedPropertyValues = {
    "layout",
    "style",
    "paint",
-   "inline-size",
-   "block-size"
+   "inline-size"
   ]
  },
  "contain-intrinsic-block-size": {
@@ -7198,9 +7348,7 @@ export const generatedPropertyValues = {
    "flow",
    "math",
    "ruby",
-   "ruby-text",
-   "grid-lanes",
-   "inline-grid-lanes"
+   "ruby-text"
   ]
  },
  "dominant-baseline": {
@@ -7649,8 +7797,6 @@ export const generatedPropertyValues = {
  "image-rendering": {
   "values": [
    "auto",
-   "optimizespeed",
-   "optimizequality",
    "-webkit-optimize-contrast",
    "pixelated",
    "crisp-edges"
@@ -7745,8 +7891,7 @@ export const generatedPropertyValues = {
    "loose",
    "normal",
    "strict",
-   "anywhere",
-   "after-white-space"
+   "anywhere"
   ]
  },
  "line-clamp": {
@@ -7754,8 +7899,7 @@ export const generatedPropertyValues = {
    "none",
    "auto",
    "ellipsis",
-   "no-ellipsis",
-   "-webkit-legacy"
+   "no-ellipsis"
   ]
  },
  "line-height": {
@@ -8050,7 +8194,7 @@ export const generatedPropertyValues = {
  "outline-style": {
   "values": [
    "none",
-   "hidden",
+   "auto",
    "inset",
    "groove",
    "outset",
@@ -8224,7 +8368,43 @@ export const generatedPropertyValues = {
    "end",
    "self-start",
    "self-end",
-   "all"
+   "span-all",
+   "span-left",
+   "span-right",
+   "span-x-start",
+   "span-x-end",
+   "self-x-start",
+   "self-x-end",
+   "span-self-x-start",
+   "span-self-x-end",
+   "span-top",
+   "span-bottom",
+   "span-y-start",
+   "span-y-end",
+   "self-y-start",
+   "self-y-end",
+   "span-self-y-start",
+   "span-self-y-end",
+   "block-start",
+   "block-end",
+   "span-block-start",
+   "span-block-end",
+   "inline-start",
+   "inline-end",
+   "span-inline-start",
+   "span-inline-end",
+   "self-block-start",
+   "self-block-end",
+   "span-self-block-start",
+   "span-self-block-end",
+   "self-inline-start",
+   "self-inline-end",
+   "span-self-inline-start",
+   "span-self-inline-end",
+   "span-start",
+   "span-end",
+   "span-self-start",
+   "span-self-end"
   ]
  },
  "position-try-fallbacks": {
@@ -8601,8 +8781,7 @@ export const generatedPropertyValues = {
    "-webkit-right",
    "-webkit-center",
    "start",
-   "end",
-   "match-parent"
+   "end"
   ]
  },
  "text-align-last": {
@@ -8613,8 +8792,7 @@ export const generatedPropertyValues = {
    "left",
    "right",
    "center",
-   "justify",
-   "match-parent"
+   "justify"
   ]
  },
  "text-anchor": {
@@ -8722,7 +8900,8 @@ export const generatedPropertyValues = {
   "values": [
    "sideways",
    "mixed",
-   "upright"
+   "upright",
+   "sideways-right"
   ]
  },
  "text-overflow": {
@@ -8764,8 +8943,6 @@ export const generatedPropertyValues = {
    "capitalize",
    "uppercase",
    "lowercase",
-   "full-width",
-   "full-size-kana",
    "math-auto"
   ]
  },
@@ -8799,8 +8976,7 @@ export const generatedPropertyValues = {
  },
  "timeline-scope": {
   "values": [
-   "none",
-   "all"
+   "none"
   ]
  },
  "timeline-trigger-active-range-end": {
@@ -8917,8 +9093,7 @@ export const generatedPropertyValues = {
    "auto",
    "none",
    "text",
-   "all",
-   "contain"
+   "all"
   ]
  },
  "vector-effect": {
@@ -8966,8 +9141,7 @@ export const generatedPropertyValues = {
  },
  "view-transition-name": {
   "values": [
-   "none",
-   "auto"
+   "none"
   ]
  },
  "view-transition-scope": {

package/front_end/generated/protocol.ts

@@ -440,6 +440,29 @@ export namespace Accessibility {
  */
 export namespace Ads {
 
+  /**
+   * Ad frame data.
+   */
+  export interface AdFrameData {
+    /**
+     * The DevTools frame token.
+     */
+    frameId: Page.FrameId;
+    /**
+     * The initial origin of the frame. To minimize the payload size, this is
+     * only sent once per frame.
+     */
+    initialOrigin?: string;
+    /**
+     * The network bytes of the frame.
+     */
+    networkBytes: number;
+    /**
+     * The CPU time of the frame, in milliseconds.
+     */
+    cpuTime: number;
+  }
+
   /**
    * Ad metrics for a page.
    */
@@ -471,6 +494,14 @@ export namespace Ads {
      * The total ad network bytes.
      */
     totalAdNetworkBytes: number;
+    /**
+     * The list of ad frames that have been updated since the last event.
+     */
+    updateAdFrames: AdFrameData[];
+    /**
+     * The list of ad frame IDs that have been removed since the last event.
+     */
+    removeAdFrames: Page.FrameId[];
   }
 
   export interface GetAdMetricsResponse extends ProtocolResponseWithError {
@@ -1617,6 +1648,8 @@ export namespace Audits {
     FontSizeTooSmall = 'FontSizeTooSmall',
     FontSizeTooLarge = 'FontSizeTooLarge',
     InvalidSizeValue = 'InvalidSizeValue',
+    NonSecureContext = 'NonSecureContext',
+    MissingTransientUserActivation = 'MissingTransientUserActivation',
   }
 
   /**
@@ -4804,8 +4837,10 @@ export namespace DOM {
     FileSelectorButton = 'file-selector-button',
     DetailsContent = 'details-content',
     Picker = 'picker',
+    SelectListbox = 'select-listbox',
     PermissionIcon = 'permission-icon',
     OverscrollAreaParent = 'overscroll-area-parent',
+    OverscrollBackdrop = 'overscroll-backdrop',
     Skeleton = 'skeleton',
   }
 
@@ -15789,6 +15824,15 @@ export namespace Page {
      * option, use with caution.
      */
     grantUniveralAccess?: boolean;
+    /**
+     * An optional content security policy to set for the isolated world.
+     * If omitted, any existing CSP for the world will be cleared.
+     * Note that clearing or updating the CSP does not immediately affect the active
+     * context in the same document because LocalDOMWindow caches the
+     * ContentSecurityPolicy object. The change takes effect on subsequent
+     * navigations when a new window context is created.
+     */
+    contentSecurityPolicy?: string;
   }
 
   export interface CreateIsolatedWorldResponse extends ProtocolResponseWithError {
@@ -19491,13 +19535,11 @@ export namespace Target {
      */
     hidden?: boolean;
     /**
-     * If specified, the option is used to determine if the new target should
-     * be focused or not. By default, the focus behavior depends on the
-     * value of the background field. For example, background=false and focus=false
-     * will result in the target tab being opened but the browser window remain
-     * unchanged (if it was in the background, it will remain in the background)
-     * and background=false with focus=undefined will result in the window being focused.
-     * Using background: true and focus: true is not supported and will result in an error.
+     * If specified, determines whether the new target should be focused.
+     * By default, the focus behavior depends on the `background` parameter:
+     * - If `background` is false (default) and `focus` is omitted, the new target is focused and the browser window is brought to the foreground.
+     * - If `background` is false and `focus` is false, the target is opened but the browser window's focus remains unchanged (e.g., if the window was in the background, it stays there).
+     * - If `background` is true, setting `focus` to true is not supported and will result in an error.
      */
     focus?: boolean;
   }
@@ -19953,6 +19995,21 @@ export namespace Tracing {
      * Backend type (defaults to `auto`)
      */
     tracingBackend?: TracingBackend;
+    /**
+     * Maximum width and height (in pixels) of each captured screenshot.
+     * Only used when the `disabled-by-default-devtools.screenshot` category is
+     * enabled. Defaults to 500. The combined memory footprint of screenshots
+     * (`screenshotMaxSize` * `screenshotMaxSize` * 4 * `screenshotMaxCount`)
+     * is clamped to the existing per-session budget.
+     */
+    screenshotMaxSize?: integer;
+    /**
+     * Maximum number of screenshots captured during a single tracing session.
+     * Only used when the `disabled-by-default-devtools.screenshot` category is
+     * enabled. Defaults to 450. Clamped together with `screenshotMaxSize` to
+     * stay within the per-session screenshot memory budget.
+     */
+    screenshotMaxCount?: integer;
   }
 
   export interface BufferUsageEvent {

package/front_end/models/ai_assistance/AiAgent2.ts

@@ -22,7 +22,7 @@ import {debugLog} from './debug.js';
 import {ExtensionScope} from './ExtensionScope.js';
 import type {Skill, SkillName} from './skills/Skill.js';
 import {SKILLS} from './skills/SkillRegistry.js';
-import type {AllToolsContext, Tool, ToolArgs} from './tools/Tool.js';
+import type {AllToolsCapabilities, Tool, ToolArgs} from './tools/Tool.js';
 import {ToolRegistry} from './tools/ToolRegistry.js';
 
 const SKILL_DISPLAY_NAMES: Record<SkillName, string> = {
@@ -214,7 +214,7 @@ User query: ${enhancedQuery}`;
    * Declares a tool to be available to the agent model, verifying first that
    * it hasn't already been declared to prevent duplicate declaration errors.
    */
-  #declareTool(tool: Tool<ToolArgs, unknown, AllToolsContext>): void {
+  #declareTool(tool: Tool<ToolArgs, unknown, AllToolsCapabilities>): void {
     if (this.#declaredTools.has(tool.name)) {
       debugLog(`AiAgent2: Tool ${tool.name} is already declared`);
       return;
@@ -225,7 +225,7 @@ User query: ${enhancedQuery}`;
       parameters: tool.parameters,
       displayInfoFromArgs: tool.displayInfoFromArgs,
       handler: (args, options) => {
-        const context: AllToolsContext = {
+        const context: AllToolsCapabilities = {
           conversationContext: this.context ?? null,
           changeManager: this.#changes,
           createExtensionScope: this.#createExtensionScope.bind(this),

package/front_end/models/ai_assistance/AiConversation.ts

@@ -27,7 +27,7 @@ import {
 import {ContextSelectionAgent} from './agents/ContextSelectionAgent.js';
 import {FileAgent} from './agents/FileAgent.js';
 import {NetworkAgent} from './agents/NetworkAgent.js';
-import {PerformanceAgent, PerformanceTraceContext} from './agents/PerformanceAgent.js';
+import {PerformanceAgent} from './agents/PerformanceAgent.js';
 import {StorageAgent, StorageContext} from './agents/StorageAgent.js';
 import {StylingAgent} from './agents/StylingAgent.js';
 import {AiAgent2} from './AiAgent2.js';
@@ -36,6 +36,7 @@ import type {ChangeManager} from './ChangeManager.js';
 import {AccessibilityContext} from './contexts/AccessibilityContext.js';
 import {DOMNodeContext} from './contexts/DOMNodeContext.js';
 import {FileContext} from './contexts/FileContext.js';
+import {PerformanceTraceContext} from './contexts/PerformanceTraceContext.js';
 import {RequestContext} from './contexts/RequestContext.js';
 
 export const NOT_FOUND_IMAGE_DATA = '';

package/front_end/models/ai_assistance/README.md

@@ -8,7 +8,7 @@ When the user interacts with AI via the AI Assistance Panel, they are having a _
 
 Each agent has a _context_ defined, which represents the selected data that forms the context of the conversation the user is having with that agent. For example:
 
-- The `PerformanceAgent` has an individual performance trace and a specific focus (an insight, or a call tree) as its context.
+- The `PerformanceAgent` uses `PerformanceTraceContext` wrapping an individual performance trace and a specific focus (an insight, or a call tree) as its context.
 - The `StylingAgent` has a DOM Node as its context.
 
 Contexts are defined as subclasses extending the `ConversationContext` abstract class, which defines the following key methods:
@@ -46,14 +46,14 @@ To support skills requiring execution of code or fetching page state (like compu
 
 - **BaseTool**: A non-generic base interface capturing tool metadata (`name`, `description`, `parameters`). This acts as the type-erased representation for generic registry storage and fallback string lookups.
 - **Tool**: A generic interface parameterized by `<Args, ReturnType, ContextType>` that binds parameter argument types and handler execution to strict contracts. `ContextType` defaults to `BaseToolCapability`, ensuring that each tool explicitly requests only the dependencies it requires.
-- **Capability Contexts**: Instead of passing a monolithic grab-bag context to all tools, dependencies are broken into narrow capability interfaces (e.g. `PageExecutionCapability`, `StyleMutationCapability`, `TargetCapability`, `OriginLockCapability`). Tools declare their required dependencies by intersecting these interfaces on their generic `ContextType` definition. The caller/Agent fulfills the complete capability context (`AllToolsContext`), guaranteeing 100% compile-time type safety for dependencies without runtime checks.
+- **Capability Contexts**: Instead of passing a monolithic grab-bag context to all tools, dependencies are broken into narrow capability interfaces (e.g. `PageExecutionCapability`, `StyleMutationCapability`, `TargetCapability`, `OriginLockCapability`). Tools declare their required dependencies by intersecting these interfaces on their generic `ContextType` definition. The caller/Agent fulfills the complete capability context (`AllToolsCapabilities`), guaranteeing 100% compile-time type safety for dependencies without runtime checks.
 - **ToolRegistry**: A static registry (`ToolRegistry`) storing instantiated tools. It uses TypeScript function overloading and generic lookups (`static get<K extends keyof typeof TOOLS>(name: K): typeof TOOLS[K]`) to return the precise class type of each tool, preventing type-erasure and escape-hatches (such as `any` or `as unknown` type assertions) at integration points like `AiAgent2.ts`. See the [Tools README](tools/README.md) for authoring instructions.
 
 ## Performance specific documentation
 
-### `TimelineUtils.AIContext.AgentFocus`
+### `PerformanceTraceContext`
 
-The context for `PerformanceAgent` is `AgentFocus`, which supports different behavior for different entry-points of the "Ask AI" feature for a trace. The two entry-points now are "insight" and "call-tree". The agent modifies its capabilities based on this focus.
+The context for `PerformanceAgent` is `PerformanceTraceContext`, which wraps `AgentFocus`. `AgentFocus` supports different behavior for different entry-points of the "Ask AI" feature for a trace (such as a specific performance insight, flame chart call tree, trace event, or the whole parsed trace). `PerformanceTraceContext` implements `ConversationContext<AgentFocus>` to fetch prompt details, user-facing accordion details, and context-specific AI suggestions.
 
 ### Adding "Ask AI" to a new Insight
 
@@ -116,4 +116,5 @@ To prevent prompt injection attacks and cross-origin data leaks, the AI Assistan
 *   **Origin Locking**: Once a conversation session begins, it locks to the origin of the initial data context (e.g. `https://google.com` or a specific file path).
 *   **Opaque Origins**: Any origin classified as opaque (e.g. `data:`, `about:`, `detached` nodes, unparsed `undefined://` or empty origins) is blocked from starting AI assistance (`isOpaqueOrigin()`).
 *   **File Isolation**: Local files (`file://`) do not share a single wildcard origin. Instead, the path is appended (e.g. `file:///path/to/file.js`) to treat each local file as its own unique origin. Swapping local files in the same conversation is blocked.
+*   **Trace Isolation**: Imported performance trace recordings are isolated using the virtual origin `imported-trace://${domain}`. This ensures that loaded local trace files do not share origins with live pages, preventing potential cross-origin prompt injection attacks when switching contexts.
 *   **Equivalence**: `areOriginsEquivalent()` ensures opaque origins are never equivalent to anything (including themselves), forcing a conversation reset on transitions.

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

@@ -17,6 +17,7 @@ import {isOpaqueOrigin} from '../AiOrigins.js';
 import {AccessibilityContext} from '../contexts/AccessibilityContext.js';
 import {DOMNodeContext} from '../contexts/DOMNodeContext.js';
 import {FileContext} from '../contexts/FileContext.js';
+import {PerformanceTraceContext} from '../contexts/PerformanceTraceContext.js';
 import {getRequestContextOrigin, RequestContext} from '../contexts/RequestContext.js';
 import {debugLog} from '../debug.js';
 import {StorageItem} from '../StorageItem.js';
@@ -28,7 +29,6 @@ import {
   type ContextResponse,
   type RequestOptions,
 } from './AiAgent.js';
-import {PerformanceTraceContext} from './PerformanceAgent.js';
 import {StorageContext} from './StorageAgent.js';
 
 const lockedString = i18n.i18n.lockedString;