feat(media): add 'controls_hide' option to manage media controls visibility

- Introduced a new boolean property 'controls_hide' to the MediaWidget.
- Updated validation schema and documentation to reflect this new option.
- Adjusted media control rendering logic based on the 'controls_hide' setting.

Author: amnweb

docs/widgets/(Widget)-Media.md

@@ -10,6 +10,7 @@
 | `show_thumbnail`        | boolean | true    | Whether to show the media thumbnail.                                        |
 | `controls_only`         | boolean | false   | Whether to show only the media controls.                                    |
 | `controls_left`         | boolean | true    | Whether to position the controls on the left.                               |
+| `controls_hide`         | boolean | false   | Whether to hide the media controls buttons                                  |
 | `hide_empty`            | boolean | true    | Whether to hide the widget when there is no media information.              |
 | `thumbnail_alpha`       | integer | 50      | The alpha transparency value for the thumbnail.                             |
 | `thumbnail_padding`     | integer | 8       | The padding around the thumbnail.                                           |
@@ -40,6 +41,7 @@ media:
     show_thumbnail: true
     controls_only: false
     controls_left: true
+    controls_hide: false
     thumbnail_alpha: 80
     thumbnail_padding: 8
     thumbnail_corner_radius: 16
@@ -59,6 +61,7 @@ media:
 - **show_thumbnail:** Whether to show the media thumbnail.
 - **controls_only:** Whether to show only the media controls.
 - **controls_left:** Whether to place the media controls on the left.
+- **controls_hide:** Whether to hide the media controls buttons.
 - **thumbnail_alpha:** The alpha (transparency) value for the media thumbnail.
 - **thumbnail_padding:** The padding around the media thumbnail.
 - **thumbnail_corner_radius:** The corner radius for the media thumbnail. Set to 0 for square corners.

src/core/validation/widgets/yasb/media.py

@@ -116,6 +116,10 @@
         'type': 'boolean',
         'default': True
     },
+    'controls_hide': {
+        'type': 'boolean',
+        'default': False
+    },
     'thumbnail_alpha': {
         'type': 'integer',
         'default': 50,

src/core/widgets/yasb/media.py

@@ -32,6 +32,7 @@ def __init__(
             show_thumbnail: bool,
             controls_only: bool,
             controls_left: bool,
+            controls_hide: bool,
             thumbnail_alpha: int,
             thumbnail_padding: int,
             thumbnail_corner_radius: int,
@@ -49,6 +50,7 @@ def __init__(
         self._media_button_icons = icons
         self._controls_only = controls_only
         self._controls_left = controls_left
+        self._controls_hide = controls_hide
         self._thumbnail_padding = thumbnail_padding
         self._thumbnail_corner_radius = thumbnail_corner_radius
         self._hide_empty = hide_empty
@@ -157,17 +159,18 @@ def _on_session_status_changed(self, has_session: bool):
     @QtCore.pyqtSlot(GlobalSystemMediaTransportControlsSessionPlaybackInfo)
     def _on_playback_info_changed(self, playback_info: GlobalSystemMediaTransportControlsSessionPlaybackInfo):
         # Set play-pause state icon
-        self._play_label.setText(self._media_button_icons['pause' if playback_info.playback_status == 4 else 'play'])
+        if not self._controls_hide:
+            self._play_label.setText(self._media_button_icons['pause' if playback_info.playback_status == 4 else 'play'])
 
-        enabled_if = lambda enabled: "disabled" if not enabled else ""
-        self._prev_label.setProperty("class", f"btn prev {enabled_if(playback_info.controls.is_previous_enabled)}")
-        self._play_label.setProperty("class", f"btn play {enabled_if(playback_info.controls.is_play_pause_toggle_enabled)}")
-        self._next_label.setProperty("class", f"btn next {enabled_if(playback_info.controls.is_next_enabled)}")
+            enabled_if = lambda enabled: "disabled" if not enabled else ""
+            self._prev_label.setProperty("class", f"btn prev {enabled_if(playback_info.controls.is_previous_enabled)}")
+            self._play_label.setProperty("class", f"btn play {enabled_if(playback_info.controls.is_play_pause_toggle_enabled)}")
+            self._next_label.setProperty("class", f"btn next {enabled_if(playback_info.controls.is_next_enabled)}")
 
-        # Refresh style sheets
-        self._prev_label.setStyleSheet('')
-        self._play_label.setStyleSheet('')
-        self._next_label.setStyleSheet('')
+            # Refresh style sheets
+            self._prev_label.setStyleSheet('')
+            self._play_label.setStyleSheet('')
+            self._next_label.setStyleSheet('')
 
     @QtCore.pyqtSlot(object) # None or dict
     def _on_media_properties_changed(self, media_info: Optional[dict[str, Any]]):
@@ -236,12 +239,13 @@ def _format_max_field_size(self, text: str):
             return text
 
     def _create_media_button(self, icon, action):
-        label = ClickableLabel(self)
-        label.setProperty("class", "btn")
-        label.setText(icon)
-        label.data = action
-        self._widget_container_layout.addWidget(label)
-        return label
+        if not self._controls_hide:
+            label = ClickableLabel(self)
+            label.setProperty("class", "btn")
+            label.setText(icon)
+            label.data = action
+            self._widget_container_layout.addWidget(label)
+            return label
 
     def _create_media_buttons(self):
         return (self._create_media_button(self._media_button_icons['prev_track'], WindowsMedia.prev),