devtools-protocol 0.0.1695952 → 0.0.1697629

package/json/browser_protocol.json

@@ -2405,6 +2405,33 @@
                         }
                     ]
                 },
+                {
+                    "id": "WebInstallIssueReason",
+                    "type": "string",
+                    "enum": [
+                        "ManifestParsingOrNetworkError",
+                        "StartUrlInvalid",
+                        "ManifestMissingNameOrShortName",
+                        "ManifestMissingId",
+                        "NoManifest"
+                    ]
+                },
+                {
+                    "id": "WebInstallIssueDetails",
+                    "description": "This issue reports a failure involving a web app manifest used by a Web\nInstall operation.",
+                    "type": "object",
+                    "properties": [
+                        {
+                            "name": "manifestUrl",
+                            "optional": true,
+                            "type": "string"
+                        },
+                        {
+                            "name": "reason",
+                            "$ref": "WebInstallIssueReason"
+                        }
+                    ]
+                },
                 {
                     "id": "SelectivePermissionsInterventionIssueDetails",
                     "description": "The issue warns about blocked calls to privacy sensitive APIs via the\nSelective Permissions Intervention.",
@@ -2484,7 +2511,8 @@
                         "PerformanceIssue",
                         "SelectivePermissionsInterventionIssue",
                         "EmailVerificationRequestIssue",
-                        "LazyLoadImageIssue"
+                        "LazyLoadImageIssue",
+                        "WebInstallIssue"
                     ]
                 },
                 {
@@ -2642,6 +2670,11 @@
                             "name": "lazyLoadImageIssueDetails",
                             "optional": true,
                             "$ref": "LazyLoadImageIssueDetails"
+                        },
+                        {
+                            "name": "webInstallIssueDetails",
+                            "optional": true,
+                            "$ref": "WebInstallIssueDetails"
                         }
                     ]
                 },
@@ -8973,6 +9006,28 @@
                         }
                     ]
                 },
+                {
+                    "name": "getImplicitAnchorCandidates",
+                    "description": "Returns candidate nodes that are configured as triggers for the given popover.",
+                    "experimental": true,
+                    "parameters": [
+                        {
+                            "name": "nodeId",
+                            "description": "Id of the popover HTMLElement.",
+                            "$ref": "NodeId"
+                        }
+                    ],
+                    "returns": [
+                        {
+                            "name": "backendNodeIds",
+                            "description": "Candidate elements that can invoke this popover.",
+                            "type": "array",
+                            "items": {
+                                "$ref": "BackendNodeId"
+                            }
+                        }
+                    ]
+                },
                 {
                     "name": "forceShowInterest",
                     "description": "When enabling, this API forces an element to gain interest in its target,\nkeeping interest active until disabled.",
@@ -8989,6 +9044,55 @@
                             "type": "boolean"
                         }
                     ]
+                },
+                {
+                    "name": "setTextMarker",
+                    "description": "Sets a spelling or grammar error marker on the given range of text.\nSee https://github.com/Igalia/explainers/blob/main/force-spelling-grammar-markers/README.md\nNote: exactly one between nodeId, backendNodeId and objectId should be passed\nto identify the node.",
+                    "experimental": true,
+                    "parameters": [
+                        {
+                            "name": "nodeId",
+                            "description": "Identifier of the node.",
+                            "optional": true,
+                            "$ref": "NodeId"
+                        },
+                        {
+                            "name": "backendNodeId",
+                            "description": "Identifier of the backend node.",
+                            "optional": true,
+                            "$ref": "BackendNodeId"
+                        },
+                        {
+                            "name": "objectId",
+                            "description": "JavaScript object id of the node wrapper.",
+                            "optional": true,
+                            "$ref": "Runtime.RemoteObjectId"
+                        },
+                        {
+                            "name": "type",
+                            "description": "The type of marker to set on the given range of text.",
+                            "type": "string",
+                            "enum": [
+                                "spelling",
+                                "grammar"
+                            ]
+                        },
+                        {
+                            "name": "start",
+                            "description": "Start offset into the element's rendered text in UTF-16 code units.\nFor a text control, an offset into the control's value.\nOffsets count text in DOM order and do not enter shadow trees.\nTo mark text inside a shadow tree, pass the element inside the shadow tree.",
+                            "type": "integer"
+                        },
+                        {
+                            "name": "end",
+                            "description": "End offset (exclusive) in the same units and space as start.",
+                            "type": "integer"
+                        }
+                    ]
+                },
+                {
+                    "name": "clearTextMarkers",
+                    "description": "Clears the spelling and grammar error text markers overlapping the ranges\nset by setTextMarker in this session. These markers are also removed when\nthe DOM domain is disabled or the session ends.",
+                    "experimental": true
                 }
             ],
             "events": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtools-protocol",
-  "version": "0.0.1695952",
+  "version": "0.0.1697629",
   "description": "The Chrome DevTools Protocol JSON",
   "repository": "https://github.com/ChromeDevTools/devtools-protocol",
   "author": "The Chromium Authors",

package/pdl/domains/Audits.pdl

@@ -741,6 +741,21 @@ experimental domain Audits
       # Used for messages about activation disabled reason
       optional string disableReason
 
+  type WebInstallIssueReason extends string
+    enum
+      ManifestParsingOrNetworkError
+      StartUrlInvalid
+      ManifestMissingNameOrShortName
+      ManifestMissingId
+      NoManifest
+
+  # This issue reports a failure involving a web app manifest used by a Web
+  # Install operation.
+  type WebInstallIssueDetails extends object
+    properties
+      optional string manifestUrl
+      WebInstallIssueReason reason
+
   # The issue warns about blocked calls to privacy sensitive APIs via the
   # Selective Permissions Intervention.
   type SelectivePermissionsInterventionIssueDetails extends object
@@ -798,6 +813,7 @@ experimental domain Audits
       SelectivePermissionsInterventionIssue
       EmailVerificationRequestIssue
       LazyLoadImageIssue
+      WebInstallIssue
 
   # This struct holds a list of optional fields with additional information
   # specific to the kind of issue. When adding a new issue code, please also
@@ -834,6 +850,7 @@ experimental domain Audits
       optional SelectivePermissionsInterventionIssueDetails selectivePermissionsInterventionIssueDetails
       optional EmailVerificationRequestIssueDetails emailVerificationRequestIssueDetails
       optional LazyLoadImageIssueDetails lazyLoadImageIssueDetails
+      optional WebInstallIssueDetails webInstallIssueDetails
 
   # A unique id for a DevTools inspector issue. Allows other entities (e.g.
   # exceptions, CDP message, console messages, etc.) to reference an issue.

package/pdl/domains/DOM.pdl

@@ -827,6 +827,15 @@ domain DOM
       # List of popovers that were closed in order to respect popover stacking order.
       array of NodeId nodeIds
 
+  # Returns candidate nodes that are configured as triggers for the given popover.
+  experimental command getImplicitAnchorCandidates
+    parameters
+      # Id of the popover HTMLElement.
+      NodeId nodeId
+    returns
+      # Candidate elements that can invoke this popover.
+      array of BackendNodeId backendNodeIds
+
   # When enabling, this API forces an element to gain interest in its target,
   # keeping interest active until disabled.
   experimental command forceShowInterest
@@ -836,6 +845,37 @@ domain DOM
       # If true, opens and holds interest. If false, releases forced interest.
       boolean enable
 
+  # Sets a spelling or grammar error marker on the given range of text.
+  # See https://github.com/Igalia/explainers/blob/main/force-spelling-grammar-markers/README.md
+  # Note: exactly one between nodeId, backendNodeId and objectId should be passed
+  # to identify the node.
+  experimental command setTextMarker
+    parameters
+      # Identifier of the node.
+      optional NodeId nodeId
+      # Identifier of the backend node.
+      optional BackendNodeId backendNodeId
+      # JavaScript object id of the node wrapper.
+      optional Runtime.RemoteObjectId objectId
+      # The type of marker to set on the given range of text.
+      enum type
+        # A spelling error marker, rendered as ::spelling-error
+        spelling
+        # A grammar error marker, rendered as ::grammar-error
+        grammar
+      # Start offset into the element's rendered text in UTF-16 code units.
+      # For a text control, an offset into the control's value.
+      # Offsets count text in DOM order and do not enter shadow trees.
+      # To mark text inside a shadow tree, pass the element inside the shadow tree.
+      integer start
+      # End offset (exclusive) in the same units and space as start.
+      integer end
+
+  # Clears the spelling and grammar error text markers overlapping the ranges
+  # set by setTextMarker in this session. These markers are also removed when
+  # the DOM domain is disabled or the session ends.
+  experimental command clearTextMarkers
+
   # Fired when `Element`'s attribute is modified.
   event attributeModified
     parameters

package/types/protocol-mapping.d.ts

@@ -3045,6 +3045,14 @@ export namespace ProtocolMapping {
             paramsType: [Protocol.DOM.ForceShowPopoverRequest];
             returnType: Protocol.DOM.ForceShowPopoverResponse;
         };
+        /**
+         * Returns candidate nodes that are configured as triggers for the given popover.
+         * @experimental
+         */
+        'DOM.getImplicitAnchorCandidates': {
+            paramsType: [Protocol.DOM.GetImplicitAnchorCandidatesRequest];
+            returnType: Protocol.DOM.GetImplicitAnchorCandidatesResponse;
+        };
         /**
          * When enabling, this API forces an element to gain interest in its target,
          * keeping interest active until disabled.
@@ -3054,6 +3062,27 @@ export namespace ProtocolMapping {
             paramsType: [Protocol.DOM.ForceShowInterestRequest];
             returnType: void;
         };
+        /**
+         * Sets a spelling or grammar error marker on the given range of text.
+         * See https://github.com/Igalia/explainers/blob/main/force-spelling-grammar-markers/README.md
+         * Note: exactly one between nodeId, backendNodeId and objectId should be passed
+         * to identify the node.
+         * @experimental
+         */
+        'DOM.setTextMarker': {
+            paramsType: [Protocol.DOM.SetTextMarkerRequest];
+            returnType: void;
+        };
+        /**
+         * Clears the spelling and grammar error text markers overlapping the ranges
+         * set by setTextMarker in this session. These markers are also removed when
+         * the DOM domain is disabled or the session ends.
+         * @experimental
+         */
+        'DOM.clearTextMarkers': {
+            paramsType: [];
+            returnType: void;
+        };
         /**
          * Returns event listeners of the given object.
          */

package/types/protocol-proxy-api.d.ts

@@ -1879,6 +1879,12 @@ export namespace ProtocolProxyApi {
          */
         forceShowPopover(params: Protocol.DOM.ForceShowPopoverRequest): Promise<Protocol.DOM.ForceShowPopoverResponse>;
 
+        /**
+         * Returns candidate nodes that are configured as triggers for the given popover.
+         * @experimental
+         */
+        getImplicitAnchorCandidates(params: Protocol.DOM.GetImplicitAnchorCandidatesRequest): Promise<Protocol.DOM.GetImplicitAnchorCandidatesResponse>;
+
         /**
          * When enabling, this API forces an element to gain interest in its target,
          * keeping interest active until disabled.
@@ -1886,6 +1892,23 @@ export namespace ProtocolProxyApi {
          */
         forceShowInterest(params: Protocol.DOM.ForceShowInterestRequest): Promise<void>;
 
+        /**
+         * Sets a spelling or grammar error marker on the given range of text.
+         * See https://github.com/Igalia/explainers/blob/main/force-spelling-grammar-markers/README.md
+         * Note: exactly one between nodeId, backendNodeId and objectId should be passed
+         * to identify the node.
+         * @experimental
+         */
+        setTextMarker(params: Protocol.DOM.SetTextMarkerRequest): Promise<void>;
+
+        /**
+         * Clears the spelling and grammar error text markers overlapping the ranges
+         * set by setTextMarker in this session. These markers are also removed when
+         * the DOM domain is disabled or the session ends.
+         * @experimental
+         */
+        clearTextMarkers(): Promise<void>;
+
         /**
          * Fired when `Element`'s attribute is modified.
          */

package/types/protocol-tests-proxy-api.d.ts

@@ -1969,6 +1969,12 @@ export namespace ProtocolTestsProxyApi {
          */
         forceShowPopover(params: Protocol.DOM.ForceShowPopoverRequest): Promise<{id: number, result: Protocol.DOM.ForceShowPopoverResponse, sessionId: string}>;
 
+        /**
+         * Returns candidate nodes that are configured as triggers for the given popover.
+         * @experimental
+         */
+        getImplicitAnchorCandidates(params: Protocol.DOM.GetImplicitAnchorCandidatesRequest): Promise<{id: number, result: Protocol.DOM.GetImplicitAnchorCandidatesResponse, sessionId: string}>;
+
         /**
          * When enabling, this API forces an element to gain interest in its target,
          * keeping interest active until disabled.
@@ -1976,6 +1982,23 @@ export namespace ProtocolTestsProxyApi {
          */
         forceShowInterest(params: Protocol.DOM.ForceShowInterestRequest): Promise<{id: number, result: void, sessionId: string}>;
 
+        /**
+         * Sets a spelling or grammar error marker on the given range of text.
+         * See https://github.com/Igalia/explainers/blob/main/force-spelling-grammar-markers/README.md
+         * Note: exactly one between nodeId, backendNodeId and objectId should be passed
+         * to identify the node.
+         * @experimental
+         */
+        setTextMarker(params: Protocol.DOM.SetTextMarkerRequest): Promise<{id: number, result: void, sessionId: string}>;
+
+        /**
+         * Clears the spelling and grammar error text markers overlapping the ranges
+         * set by setTextMarker in this session. These markers are also removed when
+         * the DOM domain is disabled or the session ends.
+         * @experimental
+         */
+        clearTextMarkers(): Promise<{id: number, result: void, sessionId: string}>;
+
         /**
          * Fired when `Element`'s attribute is modified.
          */

package/types/protocol.d.ts

@@ -4039,6 +4039,17 @@ export namespace Protocol {
             disableReason?: string;
         }
 
+        export type WebInstallIssueReason = ('ManifestParsingOrNetworkError' | 'StartUrlInvalid' | 'ManifestMissingNameOrShortName' | 'ManifestMissingId' | 'NoManifest');
+
+        /**
+         * This issue reports a failure involving a web app manifest used by a Web
+         * Install operation.
+         */
+        export interface WebInstallIssueDetails {
+            manifestUrl?: string;
+            reason: WebInstallIssueReason;
+        }
+
         /**
          * The issue warns about blocked calls to privacy sensitive APIs via the
          * Selective Permissions Intervention.
@@ -4081,7 +4092,7 @@ export namespace Protocol {
          * optional fields in InspectorIssueDetails to convey more specific
          * information about the kind of issue.
          */
-        export type InspectorIssueCode = ('CookieIssue' | 'MixedContentIssue' | 'BlockedByResponseIssue' | 'HeavyAdIssue' | 'ContentSecurityPolicyIssue' | 'SharedArrayBufferIssue' | 'CorsIssue' | 'QuirksModeIssue' | 'PartitioningBlobURLIssue' | 'NavigatorUserAgentIssue' | 'GenericIssue' | 'DeprecationIssue' | 'ClientHintIssue' | 'FederatedAuthRequestIssue' | 'BounceTrackingIssue' | 'CookieDeprecationMetadataIssue' | 'StylesheetLoadingIssue' | 'FederatedAuthUserInfoRequestIssue' | 'PropertyRuleIssue' | 'SharedDictionaryIssue' | 'ElementAccessibilityIssue' | 'SRIMessageSignatureIssue' | 'UnencodedDigestIssue' | 'ConnectionAllowlistIssue' | 'UserReidentificationIssue' | 'PermissionElementIssue' | 'PerformanceIssue' | 'SelectivePermissionsInterventionIssue' | 'EmailVerificationRequestIssue' | 'LazyLoadImageIssue');
+        export type InspectorIssueCode = ('CookieIssue' | 'MixedContentIssue' | 'BlockedByResponseIssue' | 'HeavyAdIssue' | 'ContentSecurityPolicyIssue' | 'SharedArrayBufferIssue' | 'CorsIssue' | 'QuirksModeIssue' | 'PartitioningBlobURLIssue' | 'NavigatorUserAgentIssue' | 'GenericIssue' | 'DeprecationIssue' | 'ClientHintIssue' | 'FederatedAuthRequestIssue' | 'BounceTrackingIssue' | 'CookieDeprecationMetadataIssue' | 'StylesheetLoadingIssue' | 'FederatedAuthUserInfoRequestIssue' | 'PropertyRuleIssue' | 'SharedDictionaryIssue' | 'ElementAccessibilityIssue' | 'SRIMessageSignatureIssue' | 'UnencodedDigestIssue' | 'ConnectionAllowlistIssue' | 'UserReidentificationIssue' | 'PermissionElementIssue' | 'PerformanceIssue' | 'SelectivePermissionsInterventionIssue' | 'EmailVerificationRequestIssue' | 'LazyLoadImageIssue' | 'WebInstallIssue');
 
         /**
          * This struct holds a list of optional fields with additional information
@@ -4122,6 +4133,7 @@ export namespace Protocol {
             selectivePermissionsInterventionIssueDetails?: SelectivePermissionsInterventionIssueDetails;
             emailVerificationRequestIssueDetails?: EmailVerificationRequestIssueDetails;
             lazyLoadImageIssueDetails?: LazyLoadImageIssueDetails;
+            webInstallIssueDetails?: WebInstallIssueDetails;
         }
 
         /**
@@ -8181,6 +8193,20 @@ export namespace Protocol {
             nodeIds: NodeId[];
         }
 
+        export interface GetImplicitAnchorCandidatesRequest {
+            /**
+             * Id of the popover HTMLElement.
+             */
+            nodeId: NodeId;
+        }
+
+        export interface GetImplicitAnchorCandidatesResponse {
+            /**
+             * Candidate elements that can invoke this popover.
+             */
+            backendNodeIds: BackendNodeId[];
+        }
+
         export interface ForceShowInterestRequest {
             /**
              * Id of the interest invoker HTMLElement.
@@ -8192,6 +8218,41 @@ export namespace Protocol {
             enable: boolean;
         }
 
+        export const enum SetTextMarkerRequestType {
+            Spelling = 'spelling',
+            Grammar = 'grammar',
+        }
+
+        export interface SetTextMarkerRequest {
+            /**
+             * Identifier of the node.
+             */
+            nodeId?: NodeId;
+            /**
+             * Identifier of the backend node.
+             */
+            backendNodeId?: BackendNodeId;
+            /**
+             * JavaScript object id of the node wrapper.
+             */
+            objectId?: Runtime.RemoteObjectId;
+            /**
+             * The type of marker to set on the given range of text.
+             */
+            type: ('spelling' | 'grammar');
+            /**
+             * Start offset into the element's rendered text in UTF-16 code units.
+             * For a text control, an offset into the control's value.
+             * Offsets count text in DOM order and do not enter shadow trees.
+             * To mark text inside a shadow tree, pass the element inside the shadow tree.
+             */
+            start: integer;
+            /**
+             * End offset (exclusive) in the same units and space as start.
+             */
+            end: integer;
+        }
+
         /**
          * Fired when `Element`'s attribute is modified.
          */