CHANGELOG.md

 # CHANGELOG
 
+## v0.112.1 (2024-09-19)
+
+### Documentation
+
+* docs(dap_combo_box): updated screenshot ([`e3b5e33`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/e3b5e338bfaec276979183fb6d79ab41a7ca21e1))
+
+* docs(device_box): updated screenshot ([`c8e614b`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/c8e614b575b48be788a6389a7aa0cfa033d86ab8))
+
+### Fix
+
+* fix: test e2e dap wait_for_fit ([`b2f7d3c`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/b2f7d3c5f3f4bf00cc628f788e2c278ebb5688ae))
+
+## v0.112.0 (2024-09-17)
+
+### Feature
+
+* feat: console: various improvements, auto-adapt rows to widget size, Qt Designer plugin ([`286ad71`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/286ad7196b0b8562d648fb304eab7d759b6a959b))
+
+## v0.111.0 (2024-09-17)
+
+### Documentation
+
+* docs(position_indicator): updated position indicator documentation and added designer properties ([`60f7d54`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/60f7d54e2b4c3129de6c95729b8b4aea1757174f))
+
+### Feature
+
+* feat(position_indicator): improved design and added more customization options ([`d15b222`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/d15b22250fbceb708d89872c0380693e04acb107))
+
+### Fix
+
+* fix(position_indicator): fixed user access ([`dd932dd`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/dd932dd8f3910ab67ec8403124f4e176d048e542))
+
+* fix(generate_cli): fixed type annotations ([`d3c1a1b`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/d3c1a1b2edcba7afea9d369820fa7974ac29c333))
+
+* fix(positioner_box): visual improvements to the positioner_box and positioner_control_line ([`7ea4a48`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/7ea4a482e7cd9499a7268ac887b345cab01632aa))
+
+* fix(palette viewer): fixed background for tool tip ([`9045323`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/9045323049d2a39c36fc8845f3b2883d6933436b))
+
 ## v0.110.0 (2024-09-12)
 
 ### Feature
@@ -110,54 +148,12 @@
 
 ## v0.103.0 (2024-09-04)
 
-### Ci
-
-* ci: prefill variables for manual pipeline start ([`158c19e`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/158c19eda771562a325fd59405f9fd4cb9a17ed6))
-
 ### Feature
 
 * feat(vscode): open vscode on a free port ([`52da835`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/52da835803f2453096a8b7df23bee5fdf93ae2bb))
 
 * feat(website): added method to wait until the webpage is loaded ([`9be19d4`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/9be19d4abebad08c5fc6bea936dd97475fe8f628))
 
-### Fix
-
-* fix(theme): fixed segfault for webengineview for auto updates ([`9866075`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/9866075100577948755b563dc7b7dc4cdc60d040))
-
 ### Test
 
 * test(webview): fixed tests after refactoring ([`d5eb30c`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/d5eb30cd7df4cb0dc3275dd362768afc211eaf2d))
-
-* test(vscode): popen call does not have to be the only one ([`39f98ec`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/39f98ec223ba8b59e478ac788c08c59ffe886b4e))
-
-## v0.102.0 (2024-09-04)
-
-### Documentation
-
-* docs(buttons): buttons section of docs split to appearance and queue buttons ([`047aa26`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/047aa26a60220c826cc1375cf81daf11d1f3ab5c))
-
-* docs(tests): added tests tutorial for widget ([`18d8561`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/18d8561c965d149a7662085f7dbe2a39a8c4a475))
-
-### Feature
-
-* feat(queue): BECQueue controls extended with Resume, Stop, Abort, Reset buttons ([`0d7c10e`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/0d7c10e670e4937787e1afaa19ca8259ac752486))
-
-### Fix
-
-* fix(queue_reset_button): queue reset has to be confirmed with msgBox ([`9dd43aa`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/9dd43aa1fd3991368002605df4389a7a7271011b))
-
-### Refactor
-
-* refactor(tests): positioner box test changed to use create_widget fixture ([`df5eff3`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/df5eff3147c79ff0278e6a5a09c8f73d5236aed3))
-
-## v0.101.0 (2024-09-02)
-
-### Feature
-
-* feat: add Dap dialog widget ([`9781b77`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/9781b77de27b2810fbb1047a61b1832dd186db01))
-
-### Refactor
-
-* refactor: add docs, cleanup ([`61ecf49`](https://gitlab.psi.ch/bec/bec_widgets/-/commit/61ecf491e52bfbfa0d5a84764a9095310659043d))
-
-## v0.100.0 (2024-09-01)

bec_widgets/cli/client.py

 # This file was automatically generated by generate_cli.py
 
+from __future__ import annotations
+
 import enum
 from typing import Literal, Optional, overload
 
@@ -29,6 +31,7 @@ class Widgets(str, enum.Enum):
     DeviceComboBox = "DeviceComboBox"
     DeviceLineEdit = "DeviceLineEdit"
     LMFitDialog = "LMFitDialog"
+    PositionIndicator = "PositionIndicator"
     PositionerBox = "PositionerBox"
     PositionerControlLine = "PositionerControlLine"
     ResetButton = "ResetButton"
@@ -2539,6 +2542,45 @@ class LMFitDialog(RPCBase):
         """
 
 
+class PositionIndicator(RPCBase):
+    @rpc_call
+    def set_value(self, position: float):
+        """
+        None
+        """
+
+    @rpc_call
+    def set_range(self, min_value: float, max_value: float):
+        """
+        Set the range of the position indicator
+
+        Args:
+            min_value(float): Minimum value of the range
+            max_value(float): Maximum value of the range
+        """
+
+    @property
+    @rpc_call
+    def vertical(self):
+        """
+        Property to determine the orientation of the position indicator
+        """
+
+    @property
+    @rpc_call
+    def indicator_width(self):
+        """
+        Property to get the width of the indicator
+        """
+
+    @property
+    @rpc_call
+    def rounded_corners(self):
+        """
+        Property to get the rounded corners of the position indicator
+        """
+
+
 class PositionerBox(RPCBase):
     @rpc_call
     def set_positioner(self, positioner: "str | Positioner"):

bec_widgets/cli/generate_cli.py

@@ -31,6 +31,7 @@ else:
 class ClientGenerator:
     def __init__(self):
         self.header = """# This file was automatically generated by generate_cli.py\n
+from __future__ import annotations
 import enum
 from typing import Literal, Optional, overload
 

bec_widgets/qt_utils/palette_viewer.py

@@ -167,7 +167,7 @@ class PaletteViewer(BECWidget, QWidget):
             QLabel: The label with the background color.
         """
         button = QLabel()
-        button.setStyleSheet(f"background-color: {color.name()};")
+        button.setStyleSheet(f"QLabel {{ background-color: {color.name()}; }}")
         button.setToolTip("Click to copy color to clipboard")
         button.setCursor(Qt.PointingHandCursor)
         button.mousePressEvent = lambda event: QApplication.clipboard().setText(color.name())

bec_widgets/widgets/console/console.pyproject

+{'files': ['console.py']}

bec_widgets/widgets/console/console_plugin.py

+# Copyright (C) 2022 The Qt Company Ltd.
+# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause
+import os
+
+from qtpy.QtDesigner import QDesignerCustomWidgetInterface
+
+import bec_widgets
+from bec_widgets.utils.bec_designer import designer_material_icon
+from bec_widgets.widgets.console.console import BECConsole
+
+DOM_XML = """
+<ui language='c++'>
+    <widget class='BECConsole' name='bec_console'>
+    </widget>
+</ui>
+"""
+
+MODULE_PATH = os.path.dirname(bec_widgets.__file__)
+
+
+class BECConsolePlugin(QDesignerCustomWidgetInterface):  # pragma: no cover
+    def __init__(self):
+        super().__init__()
+        self._form_editor = None
+
+    def createWidget(self, parent):
+        t = BECConsole(parent)
+        return t
+
+    def domXml(self):
+        return DOM_XML
+
+    def group(self):
+        return "BEC Console"
+
+    def icon(self):
+        return designer_material_icon(BECConsole.ICON_NAME)
+
+    def includeFile(self):
+        return "bec_console"
+
+    def initialize(self, form_editor):
+        self._form_editor = form_editor
+
+    def isContainer(self):
+        return False
+
+    def isInitialized(self):
+        return self._form_editor is not None
+
+    def name(self):
+        return "BECConsole"
+
+    def toolTip(self):
+        return "A terminal-like vt100 widget."
+
+    def whatsThis(self):
+        return self.toolTip()

bec_widgets/widgets/console/register_console.py

+def main():  # pragma: no cover
+    from qtpy import PYSIDE6
+
+    if not PYSIDE6:
+        print("PYSIDE6 is not available in the environment. Cannot patch designer.")
+        return
+    from PySide6.QtDesigner import QPyDesignerCustomWidgetCollection
+
+    from bec_widgets.widgets.console.console_plugin import BECConsolePlugin
+
+    QPyDesignerCustomWidgetCollection.addCustomWidget(BECConsolePlugin())
+
+
+if __name__ == "__main__":  # pragma: no cover
+    main()

bec_widgets/widgets/dap_combo_box/dap_combo_box.py

@@ -165,21 +165,18 @@ class DapComboBox(BECWidget, QWidget):
         return True
 
 
-# pragma: no cover
-def main():
-    """Main function to run the DapComboBox widget."""
-    import sys
-
+if __name__ == "__main__":  # pragma: no cover
+    # pylint: disable=import-outside-toplevel
     from qtpy.QtWidgets import QApplication
 
     from bec_widgets.utils.colors import set_theme
 
-    app = QApplication(sys.argv)
-    set_theme("auto")
-    widget = DapComboBox()
+    app = QApplication([])
+    set_theme("dark")
+    widget = QWidget()
+    widget.setFixedSize(200, 200)
+    layout = QVBoxLayout()
+    widget.setLayout(layout)
+    layout.addWidget(DapComboBox())
     widget.show()
-    sys.exit(app.exec_())
-
-
-if __name__ == "__main__":
-    main()
+    app.exec_()

bec_widgets/widgets/position_indicator/position_indicator.py

-from qtpy.QtCore import Qt, Slot
-from qtpy.QtGui import QPainter, QPen
+import numpy as np
+from qtpy.QtCore import Property, QSize, Qt, Slot
+from qtpy.QtGui import QBrush, QColor, QPainter, QPainterPath, QPen
 from qtpy.QtWidgets import QWidget
 
+from bec_widgets.utils.bec_widget import BECWidget
+from bec_widgets.utils.colors import get_accent_colors, get_theme_palette
 
-class PositionIndicator(QWidget):
+
+class PositionIndicator(BECWidget, QWidget):
+    USER_ACCESS = ["set_value", "set_range", "vertical", "indicator_width", "rounded_corners"]
 
     ICON_NAME = "horizontal_distribute"
 
-    def __init__(self, parent=None):
-        super().__init__(parent)
-        self.position = 0.5
+    def __init__(self, parent=None, client=None, config=None, gui_id=None):
+        super().__init__(client=client, config=config, gui_id=gui_id)
+        QWidget.__init__(self, parent=parent)
+        self.position = 50
         self.min_value = 0
         self.max_value = 100
         self.scaling_factor = 0.5
-        self.setMinimumHeight(10)
+        self.is_vertical = False
+        self._current_indicator_position = 0
+        self._draw_position = 0
+        self._rounded_corners = 10
+        self._indicator_width = 2
+        self._indicator_color = get_accent_colors().success
+        self._background_color = get_theme_palette().mid().color()
+        self._use_color_palette = True
+
+    def set_range(self, min_value: float, max_value: float):
+        """
+        Set the range of the position indicator
+
+        Args:
+            min_value(float): Minimum value of the range
+            max_value(float): Maximum value of the range
+        """
+        self.minimum = min_value
+        self.maximum = max_value
+
+    @Property(float)
+    def minimum(self):
+        """
+        Property to get the minimum value of the position indicator
+        """
+        return self.min_value
 
-    def set_range(self, min_value, max_value):
+    @minimum.setter
+    def minimum(self, min_value: float):
+        """
+        Setter for the minimum property
+
+        Args:
+            min_value: The minimum value of the position indicator
+        """
         self.min_value = min_value
+        self.update()
+
+    @Property(float)
+    def maximum(self):
+        """
+        Property to get the maximum value of the position indicator
+        """
+        return self.max_value
+
+    @maximum.setter
+    def maximum(self, max_value: float):
+        """
+        Setter for the maximum property
+
+        Args:
+            max_value: The maximum value of the position indicator
+        """
         self.max_value = max_value
+        self.update()
+
+    @Property(bool)
+    def vertical(self):
+        """
+        Property to determine the orientation of the position indicator
+        """
+        return self.is_vertical
+
+    @vertical.setter
+    def vertical(self, is_vertical: bool):
+        """
+        Setter for the vertical property
+
+        Args:
+            is_vertical: True if the indicator should be vertical, False if horizontal
+        """
+
+        self.is_vertical = is_vertical
+        self.update()
+
+    @Property(float)
+    def value(self):
+        """
+        Property to get the current value of the position indicator
+        """
+        return self.position
+
+    @value.setter
+    def value(self, position: float):
+        """
+        Setter for the value property
+
+        Args:
+            position: The new position of the indicator
+        """
+        self.set_value(position)
+
+    @Property(int)
+    def indicator_width(self):
+        """
+        Property to get the width of the indicator
+        """
+        return self._indicator_width
+
+    @indicator_width.setter
+    def indicator_width(self, width: int):
+        """
+        Setter for the indicator width property
+
+        Args:
+            width: The new width of the indicator
+        """
+        self._indicator_width = width
+        self.update()
+
+    @Property(int)
+    def rounded_corners(self):
+        """
+        Property to get the rounded corners of the position indicator
+        """
+        return self._rounded_corners
+
+    @rounded_corners.setter
+    def rounded_corners(self, value: int):
+        """
+        Setter for the rounded corners property
+
+        Args:
+            value: The new value for the rounded corners
+        """
+        self._rounded_corners = value
+        self.update()
 
+    @Property(QColor)
+    def indicator_color(self):
+        """
+        Property to get the color of the indicator
+        """
+        return self._indicator_color
+
+    @indicator_color.setter
+    def indicator_color(self, color: QColor):
+        """
+        Setter for the indicator color property
+
+        Args:
+            color: The new color for the indicator
+        """
+        self._indicator_color = color
+        self.update()
+
+    @Property(QColor)
+    def background_color(self):
+        """
+        Property to get the background color of the position indicator
+        """
+        return self._background_color
+
+    @background_color.setter
+    def background_color(self, color: QColor):
+        """
+        Setter for the background color property
+
+        Args:
+            color: The new background color
+        """
+        self._background_color = color
+        self.update()
+
+    @Property(bool)
+    def use_color_palette(self):
+        """
+        Property to determine if the indicator should use the color palette or the custom color.
+        """
+        return self._use_color_palette
+
+    @use_color_palette.setter
+    def use_color_palette(self, use_palette: bool):
+        """
+        Setter for the use color palette property
+
+        Args:
+            use_palette: True if the indicator should use the color palette, False if custom color
+        """
+        self._use_color_palette = use_palette
+        self.update()
+
+    # @Property(float)
+    @Slot(int)
     @Slot(float)
-    def on_position_update(self, position: float):
+    def set_value(self, position: float):
         self.position = position
         self.update()
 
+    def _get_indicator_color(self):
+        if self._use_color_palette:
+            return get_accent_colors().success
+        return self._indicator_color
+
+    def _get_background_brush(self):
+        if self._use_color_palette:
+            return get_theme_palette().mid()
+        return QBrush(self._background_color)
+
     def paintEvent(self, event):
         painter = QPainter(self)
-        painter.setRenderHint(QPainter.Antialiasing)
-
         width = self.width()
         height = self.height()
 
-        # Draw horizontal line
-        painter.setPen(Qt.black)
-        painter.drawLine(0, height // 2, width, height // 2)
-
-        # Draw shorter vertical line at the current position
-        x_pos = int(self.position * width)
-        painter.setPen(QPen(Qt.red, 2))
-        short_line_height = int(height * self.scaling_factor)
-        painter.drawLine(
-            x_pos,
-            (height // 2) - (short_line_height // 2),
-            x_pos,
-            (height // 2) + (short_line_height // 2),
+        # Set up the brush for the background
+        painter.setBrush(self._get_background_brush())
+
+        # Create a QPainterPath with a rounded rectangle for clipping
+        path = QPainterPath()
+        path.addRoundedRect(0, 0, width, height, self._rounded_corners, self._rounded_corners)
+
+        # Set clipping to the rounded rectangle
+        painter.setClipPath(path)
+
+        # Draw the rounded rectangle background first
+        painter.setPen(Qt.NoPen)
+        painter.drawRoundedRect(0, 0, width, height, self._rounded_corners, self._rounded_corners)
+
+        # get the position scaled to the defined min and max values
+        self._current_indicator_position = position = np.interp(
+            self.position, [self.min_value, self.max_value], [0, 100]
         )
 
-        # Draw thicker vertical lines at the ends
-        end_line_pen = QPen(Qt.blue, 5)
-        painter.setPen(end_line_pen)
-        painter.drawLine(0, 0, 0, height)
-        painter.drawLine(width - 1, 0, width - 1, height)
+        if self.is_vertical:
+            # If vertical, rotate the coordinate system by -90 degrees
+            painter.translate(width // 2, height // 2)  # Move origin to center
+            painter.rotate(-90)  # Rotate by -90 degrees for vertical drawing
+            painter.translate(-height // 2, -width // 2)  # Restore the origin for drawing
+
+            # Switch width and height for the vertical orientation
+            width, height = height, width
 
+        # Draw the moving vertical indicator, respecting the clip path
+        self._draw_position = x_pos = round(
+            position * width / 100
+        )  # Position for the vertical line
 
-if __name__ == "__main__":
+        indicator_pen = QPen(self._get_indicator_color(), self._indicator_width)
+        painter.setPen(indicator_pen)
+        painter.drawLine(x_pos, 0, x_pos, height)
+
+        painter.end()
+
+    def minimumSizeHint(self):
+        # Set the smallest possible size
+        return QSize(10, 10)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    from bec_qthemes import setup_theme
     from qtpy.QtWidgets import QApplication, QSlider, QVBoxLayout
 
     app = QApplication([])
-
+    setup_theme("dark")
+    # Create position indicator and slider
     position_indicator = PositionIndicator()
+    # position_indicator.set_range(0, 1)
     slider = QSlider(Qt.Horizontal)
-    slider.valueChanged.connect(lambda value: position_indicator.on_position_update(value / 100))
-
+    slider.valueChanged.connect(lambda value: position_indicator.set_value(value))
+    position_indicator.is_vertical = False
+    # position_indicator.set_value(100)
     layout = QVBoxLayout()
     layout.addWidget(position_indicator)
     layout.addWidget(slider)

bec_widgets/widgets/positioner_box/positioner_box.py

@@ -16,7 +16,7 @@ from qtpy.QtWidgets import QDialog, QDoubleSpinBox, QPushButton, QVBoxLayout, QW
 
 from bec_widgets.utils import UILoader
 from bec_widgets.utils.bec_widget import BECWidget
-from bec_widgets.utils.colors import set_theme
+from bec_widgets.utils.colors import get_accent_colors, set_theme
 from bec_widgets.widgets.device_line_edit.device_line_edit import DeviceLineEdit
 
 logger = bec_logger.logger
@@ -73,6 +73,10 @@ class PositionerBox(BECWidget, QWidget):
 
         self.ui.step_size.setStepType(QDoubleSpinBox.AdaptiveDecimalStepType)
         self.ui.stop.clicked.connect(self.on_stop)
+        self.ui.stop.setToolTip("Stop")
+        self.ui.stop.setStyleSheet(
+            f"QPushButton {{background-color: {get_accent_colors().emergency.name()}; color: white;}}"
+        )
         self.ui.tweak_right.clicked.connect(self.on_tweak_right)
         self.ui.tweak_right.setToolTip("Tweak right")
         self.ui.tweak_left.clicked.connect(self.on_tweak_left)
@@ -249,7 +253,7 @@ class PositionerBox(BECWidget, QWidget):
         self.update_limits(limits)
         if limits is not None and readback_val is not None and limits[0] != limits[1]:
             pos = (readback_val - limits[0]) / (limits[1] - limits[0])
-            self.ui.position_indicator.on_position_update(pos)
+            self.ui.position_indicator.set_value(pos)
 
     def update_limits(self, limits: tuple):
         """Update limits

bec_widgets/widgets/positioner_box/positioner_box.ui

@@ -170,7 +170,20 @@
          </layout>
         </item>
         <item>
-         <widget class="PositionIndicator" name="position_indicator"/>
+         <widget class="PositionIndicator" name="position_indicator">
+          <property name="maximum" stdset="0">
+           <double>1.000000000000000</double>
+          </property>
+          <property name="value" stdset="0">
+           <double>0.500000000000000</double>
+          </property>
+          <property name="indicator_width" stdset="0">
+           <number>4</number>
+          </property>
+          <property name="rounded_corners" stdset="0">
+           <number>4</number>
+          </property>
+         </widget>
         </item>
         <item>
          <widget class="QLabel" name="readback">

bec_widgets/widgets/positioner_box/positioner_control_line.py

@@ -24,11 +24,9 @@ class PositionerControlLine(PositionerBox):
 if __name__ == "__main__":  # pragma: no cover
     import sys
 
-    import qdarktheme
     from qtpy.QtWidgets import QApplication
 
     app = QApplication(sys.argv)
-    qdarktheme.setup_theme("dark")
     widget = PositionerControlLine(device="samy")
 
     widget.show()

bec_widgets/widgets/positioner_box/positioner_control_line.ui

@@ -6,7 +6,7 @@
    <rect>
     <x>0</x>
     <y>0</y>
-    <width>785</width>
+    <width>612</width>
     <height>91</height>
    </rect>
   </property>
@@ -59,16 +59,6 @@
       </item>
       <item>
        <layout class="QHBoxLayout" name="horizontalLayout_2">
-        <item>
-         <widget class="PositionIndicator" name="position_indicator">
-          <property name="minimumSize">
-           <size>
-            <width>80</width>
-            <height>10</height>
-           </size>
-          </property>
-         </widget>
-        </item>
         <item>
          <widget class="SpinnerWidget" name="spinner_widget">
           <property name="minimumSize">
@@ -139,14 +129,14 @@
        <widget class="QToolButton" name="tweak_left">
         <property name="minimumSize">
          <size>
-          <width>30</width>
-          <height>30</height>
+          <width>25</width>
+          <height>25</height>
          </size>
         </property>
         <property name="maximumSize">
          <size>
-          <width>30</width>
-          <height>30</height>
+          <width>25</width>
+          <height>25</height>
          </size>
         </property>
         <property name="text">
@@ -154,8 +144,8 @@
         </property>
         <property name="iconSize">
          <size>
-          <width>30</width>
-          <height>30</height>
+          <width>25</width>
+          <height>25</height>
          </size>
         </property>
         <property name="arrowType">
@@ -170,14 +160,14 @@
        <widget class="QToolButton" name="tweak_right">
         <property name="minimumSize">
          <size>
-          <width>30</width>
-          <height>30</height>
+          <width>25</width>
+          <height>25</height>
          </size>
         </property>
         <property name="maximumSize">
          <size>
-          <width>30</width>
-          <height>30</height>
+          <width>25</width>
+          <height>25</height>
          </size>
         </property>
         <property name="text">
@@ -185,8 +175,8 @@
         </property>
         <property name="iconSize">
          <size>
-          <width>30</width>
-          <height>30</height>
+          <width>25</width>
+          <height>25</height>
          </size>
         </property>
         <property name="arrowType">
@@ -194,6 +184,34 @@
         </property>
        </widget>
       </item>
+      <item>
+       <widget class="PositionIndicator" name="position_indicator">
+        <property name="minimumSize">
+         <size>
+          <width>15</width>
+          <height>10</height>
+         </size>
+        </property>
+        <property name="maximumSize">
+         <size>
+          <width>15</width>
+          <height>16777215</height>
+         </size>
+        </property>
+        <property name="maximum" stdset="0">
+         <double>1.000000000000000</double>
+        </property>
+        <property name="vertical" stdset="0">
+         <bool>true</bool>
+        </property>
+        <property name="value" stdset="0">
+         <double>0.500000000000000</double>
+        </property>
+        <property name="rounded_corners" stdset="0">
+         <number>2</number>
+        </property>
+       </widget>
+      </item>
      </layout>
     </widget>
    </item>

docs/user/widgets/position_indicator/position_indicator.md

@@ -10,8 +10,28 @@ The [`PositionIndicator`](/api_reference/_autosummary/bec_widgets.cli.client.Pos
 - **Position Visualization**: Displays the current position of a motor on a linear scale, showing its location relative to the defined limits.
 - **Customizable Range**: The widget allows you to set the minimum and maximum range, adapting to different motor configurations.
 - **Real-Time Updates**: Responds to real-time updates, allowing the position indicator to move dynamically as the motor's position changes.
+- **Compact Design**: The widget is designed to be compact and visually appealing, making it suitable for various GUI applications.
+- **Customizable Appearance**: The appearance of the position indicator can be customized to match the overall design of your application, including colors, orientation, and size.
 - **QtDesigner Integration**: Can be added directly in code or through `QtDesigner`, making it adaptable to various use cases.
 
+
+## BEC Designer Customization
+Within the BECDesigner's [property editor](https://doc.qt.io/qt-6/designer-widget-mode.html#the-property-editor/), the `PositionIndicator` widget can be customized to suit your application's requirements. The widget provides the following customization options:
+- **minimum**: The minimum value of the position indicator.
+- **maximum**: The maximum value of the position indicator.
+- **value**: The current value of the position indicator.
+- **vertical**: A boolean value indicating whether the position indicator is oriented vertically or horizontally.
+- **indicator_width**: The width of the position indicator.
+- **rounded_corners**: The radius of the rounded corners of the position indicator.
+- **indicator_color**: The color of the position indicator.
+- **background_color**: The color of the background of the position indicator.
+- **use_color_palette**: A boolean value indicating whether to use the color palette for the position indicator or the custom colors. 
+
+**BEC Designer properties:**
+```{figure} ./position_indicator_designer_props.png
+```
+
+
 ````
 
 ````{tab} Examples
@@ -33,7 +53,7 @@ position_indicator = PositionIndicator()
 
 # Create a slider to simulate position changes
 slider = QSlider(Qt.Horizontal)
-slider.valueChanged.connect(lambda value: position_indicator.on_position_update(value / 100))
+slider.valueChanged.connect(lambda value: position_indicator.set_value(value))
 
 # Create a layout and add the widgets
 layout = QVBoxLayout()
@@ -63,7 +83,13 @@ The `PositionIndicator` can be added to your GUI layout using `QtDesigner`. Once
 
 ```python
 # Example: Updating the position in a QtDesigner-based application
-self.position_indicator.on_position_update(new_position_value)
+self.position_indicator.set_value(new_position_value)
 ```
 
+````
+
+````{tab} API
+```{eval-rst} 
+.. include:: /api_reference/_autosummary/bec_widgets.cli.client.PositionIndicator.rst
+```
 ````
\ No newline at end of file

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "bec_widgets"
-version = "0.110.0"
+version = "0.112.1"
 description = "BEC Widgets"
 requires-python = ">=3.10"
 classifiers = [