Update CDP to latest protocol with new domains and security enhancements

Co-authored-by: hyp3ri0n-ng <3106718+hyp3ri0n-ng@users.noreply.github.com>

Author: Copilot

cdp/__init__.py

@@ -8,7 +8,9 @@
 import cdp.accessibility
 import cdp.animation
 import cdp.audits
+import cdp.autofill
 import cdp.background_service
+import cdp.bluetooth_emulation
 import cdp.browser
 import cdp.css
 import cdp.cache_storage
@@ -18,12 +20,15 @@
 import cdp.dom_debugger
 import cdp.dom_snapshot
 import cdp.dom_storage
-import cdp.database
 import cdp.debugger
+import cdp.device_access
 import cdp.device_orientation
 import cdp.emulation
 import cdp.event_breakpoints
+import cdp.extensions
+import cdp.fed_cm
 import cdp.fetch
+import cdp.file_system
 import cdp.headless_experimental
 import cdp.heap_profiler
 import cdp.io
@@ -36,9 +41,11 @@
 import cdp.memory
 import cdp.network
 import cdp.overlay
+import cdp.pwa
 import cdp.page
 import cdp.performance
 import cdp.performance_timeline
+import cdp.preload
 import cdp.profiler
 import cdp.runtime
 import cdp.schema

cdp/accessibility.py

@@ -123,7 +123,7 @@ class AXValueSource:
     #: Whether this source is superseded by a higher priority source.
     superseded: typing.Optional[bool] = None
 
-    #: The native markup source for this value, e.g. a <label> element.
+    #: The native markup source for this value, e.g. a ``<label>`` element.
     native_source: typing.Optional[AXValueNativeSourceType] = None
 
     #: The value, such as a node or node list, of the native source.
@@ -267,8 +267,10 @@ class AXPropertyName(enum.Enum):
     - from 'live' to 'root': attributes which apply to nodes in live regions
     - from 'autocomplete' to 'valuetext': attributes which apply to widgets
     - from 'checked' to 'selected': states which apply to widgets
-    - from 'activedescendant' to 'owns' - relationships between elements other than parent/child/sibling.
+    - from 'activedescendant' to 'owns': relationships between elements other than parent/child/sibling
+    - from 'activeFullscreenElement' to 'uninteresting': reasons why this noode is hidden
     '''
+    ACTIONS = "actions"
     BUSY = "busy"
     DISABLED = "disabled"
     EDITABLE = "editable"
@@ -308,6 +310,24 @@ class AXPropertyName(enum.Enum):
     FLOWTO = "flowto"
     LABELLEDBY = "labelledby"
     OWNS = "owns"
+    URL = "url"
+    ACTIVE_FULLSCREEN_ELEMENT = "activeFullscreenElement"
+    ACTIVE_MODAL_DIALOG = "activeModalDialog"
+    ACTIVE_ARIA_MODAL_DIALOG = "activeAriaModalDialog"
+    ARIA_HIDDEN_ELEMENT = "ariaHiddenElement"
+    ARIA_HIDDEN_SUBTREE = "ariaHiddenSubtree"
+    EMPTY_ALT = "emptyAlt"
+    EMPTY_TEXT = "emptyText"
+    INERT_ELEMENT = "inertElement"
+    INERT_SUBTREE = "inertSubtree"
+    LABEL_CONTAINER = "labelContainer"
+    LABEL_FOR = "labelFor"
+    NOT_RENDERED = "notRendered"
+    NOT_VISIBLE = "notVisible"
+    PRESENTATIONAL_ROLE = "presentationalRole"
+    PROBABLY_PRESENTATIONAL = "probablyPresentational"
+    INACTIVE_CAROUSEL_TAB_CONTENT = "inactiveCarouselTabContent"
+    UNINTERESTING = "uninteresting"
 
     def to_json(self) -> str:
         return self.value
@@ -334,6 +354,9 @@ class AXNode:
     #: This ``Node``'s role, whether explicit or implicit.
     role: typing.Optional[AXValue] = None
 
+    #: This ``Node``'s Chrome raw role.
+    chrome_role: typing.Optional[AXValue] = None
+
     #: The accessible name for this ``Node``.
     name: typing.Optional[AXValue] = None
 
@@ -366,6 +389,8 @@ def to_json(self) -> T_JSON_DICT:
             json['ignoredReasons'] = [i.to_json() for i in self.ignored_reasons]
         if self.role is not None:
             json['role'] = self.role.to_json()
+        if self.chrome_role is not None:
+            json['chromeRole'] = self.chrome_role.to_json()
         if self.name is not None:
             json['name'] = self.name.to_json()
         if self.description is not None:
@@ -391,6 +416,7 @@ def from_json(cls, json: T_JSON_DICT) -> AXNode:
             ignored=bool(json['ignored']),
             ignored_reasons=[AXProperty.from_json(i) for i in json['ignoredReasons']] if 'ignoredReasons' in json else None,
             role=AXValue.from_json(json['role']) if 'role' in json else None,
+            chrome_role=AXValue.from_json(json['chromeRole']) if 'chromeRole' in json else None,
             name=AXValue.from_json(json['name']) if 'name' in json else None,
             description=AXValue.from_json(json['description']) if 'description' in json else None,
             value=AXValue.from_json(json['value']) if 'value' in json else None,
@@ -437,7 +463,7 @@ def get_partial_ax_tree(
     :param node_id: *(Optional)* Identifier of the node to get the partial accessibility tree for.
     :param backend_node_id: *(Optional)* Identifier of the backend node to get the partial accessibility tree for.
     :param object_id: *(Optional)* JavaScript object id of the node wrapper to get the partial accessibility tree for.
-    :param fetch_relatives: *(Optional)* Whether to fetch this nodes ancestors, siblings and children. Defaults to true.
+    :param fetch_relatives: *(Optional)* Whether to fetch this node's ancestors, siblings and children. Defaults to true.
     :returns: The ``Accessibility.AXNode`` for this DOM node, if it exists, plus its ancestors, siblings and children, if requested.
     '''
     params: T_JSON_DICT = dict()
@@ -459,7 +485,6 @@ def get_partial_ax_tree(
 
 def get_full_ax_tree(
         depth: typing.Optional[int] = None,
-        max_depth: typing.Optional[int] = None,
         frame_id: typing.Optional[page.FrameId] = None
     ) -> typing.Generator[T_JSON_DICT,T_JSON_DICT,typing.List[AXNode]]:
     r'''
@@ -468,15 +493,12 @@ def get_full_ax_tree(
     **EXPERIMENTAL**
 
     :param depth: *(Optional)* The maximum depth at which descendants of the root node should be retrieved. If omitted, the full tree is returned.
-    :param max_depth: **(DEPRECATED)** *(Optional)* Deprecated. This parameter has been renamed to ```depth```. If depth is not provided, max_depth will be used.
-    :param frame_id: *(Optional)* The frame for whose document the AX tree should be retrieved. If omited, the root frame is used.
+    :param frame_id: *(Optional)* The frame for whose document the AX tree should be retrieved. If omitted, the root frame is used.
     :returns: 
     '''
     params: T_JSON_DICT = dict()
     if depth is not None:
         params['depth'] = depth
-    if max_depth is not None:
-        params['max_depth'] = max_depth
     if frame_id is not None:
         params['frameId'] = frame_id.to_json()
     cmd_dict: T_JSON_DICT = {
@@ -577,7 +599,7 @@ def query_ax_tree(
     r'''
     Query a DOM node's accessibility subtree for accessible name and role.
     This command computes the name and role for all nodes in the subtree, including those that are
-    ignored for accessibility, and returns those that mactch the specified name and role. If no DOM
+    ignored for accessibility, and returns those that match the specified name and role. If no DOM
     node is specified, or the DOM node does not exist, the command returns an error. If neither
     ``accessibleName`` or ``role`` is specified, it returns all the accessibility nodes in the subtree.
 

cdp/animation.py

@@ -36,6 +36,9 @@ class Animation:
     playback_rate: float
 
     #: ``Animation``'s start time.
+    #: Milliseconds for time based animations and
+    #: percentage [0 - 100] for scroll driven animations
+    #: (i.e. when viewOrScrollTimeline exists).
     start_time: float
 
     #: ``Animation``'s current time.
@@ -51,6 +54,9 @@ class Animation:
     #: animation/transition.
     css_id: typing.Optional[str] = None
 
+    #: View or scroll timeline
+    view_or_scroll_timeline: typing.Optional[ViewOrScrollTimeline] = None
+
     def to_json(self) -> T_JSON_DICT:
         json: T_JSON_DICT = dict()
         json['id'] = self.id_
@@ -65,6 +71,8 @@ def to_json(self) -> T_JSON_DICT:
             json['source'] = self.source.to_json()
         if self.css_id is not None:
             json['cssId'] = self.css_id
+        if self.view_or_scroll_timeline is not None:
+            json['viewOrScrollTimeline'] = self.view_or_scroll_timeline.to_json()
         return json
 
     @classmethod
@@ -80,6 +88,55 @@ def from_json(cls, json: T_JSON_DICT) -> Animation:
             type_=str(json['type']),
             source=AnimationEffect.from_json(json['source']) if 'source' in json else None,
             css_id=str(json['cssId']) if 'cssId' in json else None,
+            view_or_scroll_timeline=ViewOrScrollTimeline.from_json(json['viewOrScrollTimeline']) if 'viewOrScrollTimeline' in json else None,
+        )
+
+
+@dataclass
+class ViewOrScrollTimeline:
+    r'''
+    Timeline instance
+    '''
+    #: Orientation of the scroll
+    axis: dom.ScrollOrientation
+
+    #: Scroll container node
+    source_node_id: typing.Optional[dom.BackendNodeId] = None
+
+    #: Represents the starting scroll position of the timeline
+    #: as a length offset in pixels from scroll origin.
+    start_offset: typing.Optional[float] = None
+
+    #: Represents the ending scroll position of the timeline
+    #: as a length offset in pixels from scroll origin.
+    end_offset: typing.Optional[float] = None
+
+    #: The element whose principal box's visibility in the
+    #: scrollport defined the progress of the timeline.
+    #: Does not exist for animations with ScrollTimeline
+    subject_node_id: typing.Optional[dom.BackendNodeId] = None
+
+    def to_json(self) -> T_JSON_DICT:
+        json: T_JSON_DICT = dict()
+        json['axis'] = self.axis.to_json()
+        if self.source_node_id is not None:
+            json['sourceNodeId'] = self.source_node_id.to_json()
+        if self.start_offset is not None:
+            json['startOffset'] = self.start_offset
+        if self.end_offset is not None:
+            json['endOffset'] = self.end_offset
+        if self.subject_node_id is not None:
+            json['subjectNodeId'] = self.subject_node_id.to_json()
+        return json
+
+    @classmethod
+    def from_json(cls, json: T_JSON_DICT) -> ViewOrScrollTimeline:
+        return cls(
+            axis=dom.ScrollOrientation.from_json(json['axis']),
+            source_node_id=dom.BackendNodeId.from_json(json['sourceNodeId']) if 'sourceNodeId' in json else None,
+            start_offset=float(json['startOffset']) if 'startOffset' in json else None,
+            end_offset=float(json['endOffset']) if 'endOffset' in json else None,
+            subject_node_id=dom.BackendNodeId.from_json(json['subjectNodeId']) if 'subjectNodeId' in json else None,
         )
 
 
@@ -97,10 +154,10 @@ class AnimationEffect:
     #: ``AnimationEffect``'s iteration start.
     iteration_start: float
 
-    #: ``AnimationEffect``'s iterations.
-    iterations: float
-
     #: ``AnimationEffect``'s iteration duration.
+    #: Milliseconds for time based animations and
+    #: percentage [0 - 100] for scroll driven animations
+    #: (i.e. when viewOrScrollTimeline exists).
     duration: float
 
     #: ``AnimationEffect``'s playback direction.
@@ -112,6 +169,9 @@ class AnimationEffect:
     #: ``AnimationEffect``'s timing function.
     easing: str
 
+    #: ``AnimationEffect``'s iterations. Omitted if the value is infinite.
+    iterations: typing.Optional[float] = None
+
     #: ``AnimationEffect``'s target node.
     backend_node_id: typing.Optional[dom.BackendNodeId] = None
 
@@ -123,11 +183,12 @@ def to_json(self) -> T_JSON_DICT:
         json['delay'] = self.delay
         json['endDelay'] = self.end_delay
         json['iterationStart'] = self.iteration_start
-        json['iterations'] = self.iterations
         json['duration'] = self.duration
         json['direction'] = self.direction
         json['fill'] = self.fill
         json['easing'] = self.easing
+        if self.iterations is not None:
+            json['iterations'] = self.iterations
         if self.backend_node_id is not None:
             json['backendNodeId'] = self.backend_node_id.to_json()
         if self.keyframes_rule is not None:
@@ -140,11 +201,11 @@ def from_json(cls, json: T_JSON_DICT) -> AnimationEffect:
             delay=float(json['delay']),
             end_delay=float(json['endDelay']),
             iteration_start=float(json['iterationStart']),
-            iterations=float(json['iterations']),
             duration=float(json['duration']),
             direction=str(json['direction']),
             fill=str(json['fill']),
             easing=str(json['easing']),
+            iterations=float(json['iterations']) if 'iterations' in json else None,
             backend_node_id=dom.BackendNodeId.from_json(json['backendNodeId']) if 'backendNodeId' in json else None,
             keyframes_rule=KeyframesRule.from_json(json['keyframesRule']) if 'keyframesRule' in json else None,
         )
@@ -415,3 +476,19 @@ def from_json(cls, json: T_JSON_DICT) -> AnimationStarted:
         return cls(
             animation=Animation.from_json(json['animation'])
         )
+
+
+@event_class('Animation.animationUpdated')
+@dataclass
+class AnimationUpdated:
+    r'''
+    Event for animation that has been updated.
+    '''
+    #: Animation that was updated.
+    animation: Animation
+
+    @classmethod
+    def from_json(cls, json: T_JSON_DICT) -> AnimationUpdated:
+        return cls(
+            animation=Animation.from_json(json['animation'])
+        )