nicegui 3.2.0__tar.gz → 3.3.1__tar.gz

{nicegui-3.2.0 → nicegui-3.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nicegui
-Version: 3.2.0
+Version: 3.3.1
 Summary: Create web-based user interfaces with Python. The nice way.
 License: MIT
 License-File: LICENSE
@@ -44,7 +44,7 @@ Requires-Dist: python-multipart (>=0.0.18)
 Requires-Dist: python-socketio[asyncio-client] (>=5.14.0)
 Requires-Dist: pywebview (>=5.0.1,<6.0.0) ; extra == "native"
 Requires-Dist: redis (>=4.0.0) ; extra == "redis"
-Requires-Dist: starlette (>=0.45.3)
+Requires-Dist: starlette (>=0.49.1)
 Requires-Dist: typing-extensions (>=4.0.0)
 Requires-Dist: uvicorn[standard] (>=0.22.0)
 Requires-Dist: watchfiles (>=0.18.1)

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/client.py

@@ -383,8 +383,7 @@ class Client:
         self._deleted_event.set()
         self.remove_all_elements()
         self.outbox.stop()
-        if self.id in Client.instances:
-            del Client.instances[self.id]
+        del Client.instances[self.id]
         self._deleted = True
 
     def check_existence(self) -> None:
@@ -402,7 +401,11 @@ class Client:
             stale_clients = [
                 client
                 for client in cls.instances.values()
-                if not client.has_socket_connection and client.created <= time.time() - client_age_threshold
+                if (
+                    not client.has_socket_connection and
+                    not client._delete_tasks and  # pylint: disable=protected-access
+                    client.created <= time.time() - client_age_threshold
+                )
             ]
             for client in stale_clients:
                 log.debug(f'Pruning stale client {client.id}')

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/dependencies.py

@@ -6,6 +6,7 @@ from dataclasses import dataclass
 from pathlib import Path
 from typing import TYPE_CHECKING, Callable
 
+from . import core
 from .dataclasses import KWONLY_SLOTS
 from .helpers import hash_file_path
 from .vbuild import VBuild
@@ -165,7 +166,9 @@ def generate_resources(prefix: str, elements: Iterable[Element]) -> tuple[list[s
     vue_scripts: list[str] = []
     vue_html: list[str] = []
     vue_styles: list[str] = []
-    imports: dict[str, str] = {}
+    imports: dict[str, str] = {
+        'vue': f'{prefix}/_nicegui/{__version__}/static/vue.esm-browser{".prod" if core.app.config.prod_js else ""}.js',
+    }
     js_imports: list[str] = []
     js_imports_urls: list[str] = []
 
@@ -184,8 +187,10 @@ def generate_resources(prefix: str, elements: Iterable[Element]) -> tuple[list[s
     for key, vue_component in vue_components.items():
         if key not in done_components:
             vue_html.append(vue_component.html)
-            vue_scripts.append(vue_component.script.replace(f"Vue.component('{vue_component.name}',",
-                                                            f"app.component('{vue_component.tag}',", 1))
+            url = f'{prefix}/_nicegui/{__version__}/components/{vue_component.key}'
+            js_imports.append(f'import {{ default as {vue_component.name} }} from "{url}";')
+            js_imports.append(f"{vue_component.name}.template = '#tpl-{vue_component.name}';")
+            js_imports.append(f'app.component("{vue_component.tag}", {vue_component.name});')
             vue_styles.append(vue_component.style)
             done_components.add(key)
 

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/aggrid/aggrid.py

@@ -29,6 +29,7 @@ class AgGrid(Element, component='aggrid.js', esm={'nicegui-aggrid': 'dist'}, def
         """AG Grid
 
         An element to create a grid using `AG Grid <https://www.ag-grid.com/>`_.
+        Updates can be pushed to the grid by updating the ``options`` property.
 
         The methods ``run_grid_method`` and ``run_row_method`` can be used to interact with the AG Grid instance on the client.
 

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/color_input.py

@@ -34,6 +34,7 @@ class ColorInput(LabelElement, ValueElement, DisableableElement):
         :param preview: change button background to selected color (default: False)
         """
         super().__init__(tag='q-input', label=label, value=value, on_value_change=on_change)
+        self._props['for'] = self.html_id
         if placeholder is not None:
             self._props['placeholder'] = placeholder
 

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/date.py

@@ -14,7 +14,7 @@ class Date(ValueElement, DisableableElement):
                  *,
                  mask: str = 'YYYY-MM-DD',
                  on_change: Optional[Handler[ValueChangeEventArguments]] = None) -> None:
-        """Date Input
+        """Date Picker
 
         This element is based on Quasar's `QDate <https://quasar.dev/vue-components/date>`_ component.
         The date is a string in the format defined by the `mask` parameter.

nicegui-3.3.1/nicegui/elements/date_input.py

@@ -0,0 +1,60 @@
+from __future__ import annotations
+
+from ..events import Handler, ValueChangeEventArguments
+from .button import Button as button
+from .date import Date as date
+from .menu import Menu as menu
+from .mixins.disableable_element import DisableableElement
+from .mixins.label_element import LabelElement
+from .mixins.value_element import ValueElement
+
+
+class DateInput(LabelElement, ValueElement, DisableableElement):
+    LOOPBACK = False
+
+    def __init__(self,
+                 label: str | None = None, *,
+                 range_input: bool = False,
+                 placeholder: str | None = None,
+                 value: str = '',
+                 on_change: Handler[ValueChangeEventArguments] | None = None,
+                 ) -> None:
+        """Date Input
+
+        This element extends Quasar's `QInput <https://quasar.dev/vue-components/input>`_ component with a date picker.
+
+        *Added in version 3.3.0*
+
+        :param label: displayed label for the date input
+        :param range_input: if True, allows selecting a range of dates (value will be a dictionary with "from" and "to" keys)
+        :param placeholder: text to show if no date is selected
+        :param value: the current date value
+        :param on_change: callback to execute when the value changes
+        """
+        self._range_input = range_input
+        super().__init__(tag='q-input', label=label, value=value, on_value_change=on_change)
+        self._props['for'] = self.html_id
+        if placeholder is not None:
+            self._props['placeholder'] = placeholder
+
+        with self.add_slot('append'):
+            with button(icon='edit_calendar', color=None).props('flat round').classes('cursor-pointer') as self.button:
+                with menu() as self.menu:
+                    self.picker = date().props('no-parent-event').props('range' if range_input else '')
+
+        self.picker.bind_value(self,
+                               forward=lambda v: self._picker_to_input_value(v) if self._range_input else v,
+                               backward=lambda v: self._input_to_picker_value(v) if self._range_input else v)
+
+    def _picker_to_input_value(self, value: dict | str) -> str | None:
+        if isinstance(value, dict):
+            return f'{value["from"]} - {value["to"]}' if 'from' in value and 'to' in value else None
+        else:
+            return value
+
+    def _input_to_picker_value(self, value: str | None) -> dict | str | None:
+        if value and ' - ' in value:
+            from_date, to_date = value.split(' - ', 1)
+            return {'from': from_date, 'to': to_date}
+        else:
+            return value

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/echart/echart.js

@@ -69,7 +69,7 @@ export default {
     let initialResizeTriggered = false;
     const initialWidth = this.$el.offsetWidth;
     const initialHeight = this.$el.offsetHeight;
-    new ResizeObserver(() => {
+    this.resizeObserver = new ResizeObserver(() => {
       if (!initialResizeTriggered) {
         initialResizeTriggered = true;
         if (this.$el.offsetWidth === initialWidth && this.$el.offsetHeight === initialHeight) {
@@ -81,12 +81,12 @@ export default {
 
     this.update_chart();
   },
-  beforeDestroy() {
-    this.chart.dispose();
-  },
   beforeUnmount() {
     this.chart.dispose();
   },
+  unmounted() {
+    this.resizeObserver?.disconnect();
+  },
   methods: {
     update_chart() {
       if (!this.chart) {

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/header.js

@@ -2,11 +2,14 @@ export default {
   template: `<q-header ref="qRef"><slot></slot></q-header>`,
   mounted() {
     if (this.add_scroll_padding) {
-      new ResizeObserver(() => {
+      this.resizeObserver = new ResizeObserver(() => {
         document.documentElement.style.scrollPaddingTop = `${this.$el.offsetHeight}px`;
       }).observe(this.$el);
     }
   },
+  unmounted() {
+    this.resizeObserver?.disconnect();
+  },
   props: {
     add_scroll_padding: Boolean,
   },

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/input.js

@@ -7,7 +7,6 @@ export default {
       :shadow-text="shadowText"
       @keydown.tab="perform_autocomplete"
       :list="id + '-datalist'"
-      :for="id"
     >
       <template v-for="(_, slot) in $slots" v-slot:[slot]="slotProps">
         <slot :name="slot" v-bind="slotProps || {}" />
@@ -18,7 +17,6 @@ export default {
     </datalist>
   `,
   props: {
-    id: String,
     _autocomplete: Array,
     value: String,
   },

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/input.py

@@ -51,6 +51,7 @@ class Input(LabelElement, ValidationElement, DisableableElement, component='inpu
         :param validation: dictionary of validation rules or a callable that returns an optional error message (default: None for no validation)
         """
         super().__init__(label=label, value=value, on_value_change=on_change, validation=validation)
+        self._props['for'] = self.html_id
         if placeholder is not None:
             self._props['placeholder'] = placeholder
         self._props['type'] = 'password' if password else 'text'

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/input_chips.py

@@ -43,6 +43,7 @@ class InputChips(LabelElement, ValidationElement, DisableableElement):
         """
         super().__init__(tag='q-select', label=label, value=value or [], on_value_change=on_change, validation=validation)
 
+        self._props['for'] = self.html_id
         self._props['new-value-mode'] = new_value_mode
         self._props['use-input'] = True
         self._props['use-chips'] = True

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/json_editor/json_editor.js

@@ -16,9 +16,6 @@ export default {
       props: this.properties,
     });
   },
-  beforeDestroy() {
-    this.destroyEditor();
-  },
   beforeUnmount() {
     this.destroyEditor();
   },

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/leaflet/leaflet.py

@@ -49,18 +49,26 @@ class Leaflet(Element, component='leaflet.js', esm={'nicegui-leaflet': 'dist'},
         self.layers: list[Layer] = []
         self.is_initialized = False
 
+        # read-write public API
         self.center = center
         self.zoom = zoom
+
+        # internal state, mutates client state via _to_dict
         self._props['center'] = center
         self._props['zoom'] = zoom
+
+        # client state
+        self._client_center = center
+        self._client_zoom = zoom
+
         self._props['options'] = {**options}
         self._props['draw_control'] = draw_control
         self._props['hide_drawn_items'] = hide_drawn_items
         self._props['additional_resources'] = additional_resources or []
 
         self.on('init', self._handle_init)
-        self.on('map-moveend', self._handle_moveend)
-        self.on('map-zoomend', self._handle_zoomend)
+        self.on('map-moveend', self._handle_move_or_zoom_end)
+        self.on('map-zoomend', self._handle_move_or_zoom_end)
 
         self.tile_layer(
             url_template=r'https://{s}.tile.osm.org/{z}/{x}/{y}.png',
@@ -91,14 +99,10 @@ class Leaflet(Element, component='leaflet.js', esm={'nicegui-leaflet': 'dist'},
         await self.client.connected()
         await event.wait()
 
-    def _handle_moveend(self, e: GenericEventArguments) -> None:
+    def _handle_move_or_zoom_end(self, e: GenericEventArguments) -> None:
         self._send_update_on_value_change = False
-        self.center = e.args['center']
-        self._send_update_on_value_change = True
-
-    def _handle_zoomend(self, e: GenericEventArguments) -> None:
-        self._send_update_on_value_change = False
-        self.zoom = e.args['zoom']
+        self.center = self._client_center = e.args['center']
+        self.zoom = self._client_zoom = e.args['zoom']
         self._send_update_on_value_change = True
 
     def run_method(self, name: str, *args: Any, timeout: float = 1) -> AwaitableResponse:
@@ -111,16 +115,12 @@ class Leaflet(Element, component='leaflet.js', esm={'nicegui-leaflet': 'dist'},
         if self._props['center'] == center:
             return
         self._props['center'] = center
-        if self._send_update_on_value_change:
-            self.run_map_method('setView', center, self.zoom)
 
     def set_zoom(self, zoom: int) -> None:
         """Set the zoom level of the map."""
         if self._props['zoom'] == zoom:
             return
         self._props['zoom'] = zoom
-        if self._send_update_on_value_change:
-            self.run_map_method('setView', self.center, zoom)
 
     def remove_layer(self, layer: Layer) -> None:
         """Remove a layer from the map."""
@@ -166,3 +166,11 @@ class Leaflet(Element, component='leaflet.js', esm={'nicegui-leaflet': 'dist'},
     def _handle_delete(self) -> None:
         binding.remove(self.layers)
         super()._handle_delete()
+
+    def _to_dict(self):
+        if self._send_update_on_value_change and (
+            self._props['center'] != self._client_center or
+            self._props['zoom'] != self._client_zoom
+        ):
+            self.run_map_method('setView', self._props['center'], self._props['zoom'])
+        return super()._to_dict()

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/markdown.js

@@ -22,6 +22,7 @@ export default {
   },
   methods: {
     renderMermaid() {
+      if (!this.use_mermaid || !this.mermaid) return;
       // render new diagrams
       const usedKeys = new Set();
       this.$el.querySelectorAll(".mermaid-pre").forEach(async (pre, i) => {

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/mermaid/mermaid.js

@@ -24,15 +24,21 @@ export default {
     async update(content) {
       if (this.last_content === content) return;
       this.last_content = content;
-      queue.push({ element: this.$el, content: content });
+      queue.push({ element: this.$el, content: content, clickable: this.clickable });
       if (is_running) return;
       is_running = true;
       while (queue.length) {
-        const { element, content } = queue.shift();
+        const { element, content, clickable } = queue.shift();
         try {
           const { svg, bindFunctions } = await mermaid.render(element.id + "_mermaid", content);
           element.innerHTML = svg;
           bindFunctions?.(element);
+          if (clickable) {
+            element.querySelectorAll("g.node").forEach((node) => {
+              node.style.cursor = "pointer";
+              node.addEventListener("click", () => getElement(element).$emit("node_click", node.id));
+            });
+          }
         } catch (error) {
           const { svg, bindFunctions } = await mermaid.render(element.id + "_mermaid", "error");
           element.innerHTML = svg;
@@ -48,5 +54,6 @@ export default {
   props: {
     config: Object,
     content: String,
+    clickable: Boolean,
   },
 };

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/mermaid/mermaid.py

@@ -1,12 +1,20 @@
 from typing import Optional
 
+from typing_extensions import Self
+
+from ...events import Handler, MermaidNodeClickEventArguments, handle_event
 from ..mixins.content_element import ContentElement
 
 
 class Mermaid(ContentElement, component='mermaid.js', esm={'nicegui-mermaid': 'dist'}):
     CONTENT_PROP = 'content'
 
-    def __init__(self, content: str, config: Optional[dict] = None) -> None:
+    def __init__(self,
+                 content: str,
+                 config: Optional[dict] = None,
+                 *,
+                 on_node_click: Optional[Handler[MermaidNodeClickEventArguments]] = None,
+                 ) -> None:
         """Mermaid Diagrams
 
         Renders diagrams and charts written in the Markdown-inspired `Mermaid <https://mermaid.js.org/>`_ language.
@@ -25,10 +33,24 @@ class Mermaid(ContentElement, component='mermaid.js', esm={'nicegui-mermaid': 'd
 
         :param content: the Mermaid content to be displayed
         :param config: configuration dictionary to be passed to ``mermaid.initialize()``
+        :param on_node_click: callback that is invoked when a node is clicked (*added in version 3.3.0*)
         """
         super().__init__(content=content)
         self._props['config'] = config
 
+        if on_node_click is not None:
+            self.on_node_click(on_node_click)
+
+    def on_node_click(self, callback: Handler[MermaidNodeClickEventArguments]) -> Self:
+        """Add a callback to be invoked when a node is clicked."""
+        self.on('node_click', lambda e: handle_event(callback, MermaidNodeClickEventArguments(
+            sender=self,
+            client=self.client,
+            node_id='-'.join(e.args.split('-')[1:-1])  # extract Node ID from HTML ID (<type>-<node_id>-<index>)
+        )))
+        self._props['clickable'] = True
+        return self
+
     def _handle_content_change(self, content: str) -> None:
         self._props[self.CONTENT_PROP] = content.strip()
         self.run_method('update', content.strip())

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/number.py

@@ -48,6 +48,7 @@ class Number(LabelElement, ValidationElement, DisableableElement):
         """
         self.format = format
         super().__init__(tag='q-input', label=label, value=value, on_value_change=on_change, validation=validation)
+        self._props['for'] = self.html_id
         self._props['type'] = 'number'
         if placeholder is not None:
             self._props['placeholder'] = placeholder

nicegui-3.3.1/nicegui/elements/page_scroller.py

@@ -0,0 +1,45 @@
+from ..element import Element
+from .page_sticky import PageStickyPositions
+
+
+class PageScroller(Element):
+
+    def __init__(self,
+                 position: PageStickyPositions = 'bottom-right',
+                 x_offset: float = 0,
+                 y_offset: float = 0,
+                 *,
+                 expand: bool = False,
+                 scroll_offset: float = 1000,
+                 duration: float = 0.3,
+                 reverse: bool = False,
+                 ) -> None:
+        """Page scroller
+
+        This element is based on Quasar's `QPageScroller <https://quasar.dev/layout/page-scroller>`_ component.
+
+        It is very similar to ``ui.page_sticky``, sharing ``position``, ``x_offset``, ``y_offset``, and ``expand`` parameters.
+
+        However, ``ui.page_sticky`` is always visible, and ``ui.page_scroller`` only appears after the ``scroll-offset`` is reached.
+
+        Once visible, the user can click on it to quickly get back to the top of the page in ``duration`` seconds.
+
+        *Added in version 3.3.0*
+
+        :param position: position on the screen (default: "bottom-right")
+        :param x_offset: horizontal offset (default: 0)
+        :param y_offset: vertical offset (default: 0)
+        :param expand: whether to fully expand instead of shrinking to fit the content (default: ``False``)
+        :param scroll_offset: the vertical offset in pixels at which the scroller becomes visible (default: 1000)
+        :param duration: the duration in seconds for the scroll animation (default: 0.3)
+        :param reverse: if True, the scroller will work in reverse, showing when at the top of the page, and scrolls to bottom when triggered (default: ``False``)
+        """
+        super().__init__('q-page-scroller')
+        self._props['position'] = position
+        self._props['offset'] = [x_offset, y_offset]
+        self._props['scroll-offset'] = scroll_offset
+        self._props['duration'] = duration * 1000
+        if expand:
+            self._props['expand'] = True
+        if reverse:
+            self._props['reverse'] = True

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/plotly/plotly.vue

@@ -8,6 +8,16 @@ export default {
     const { Plotly } = await import("nicegui-plotly");
     this.Plotly = Plotly;
     this.update();
+    this.$nextTick(() => {
+      this.resizeObserver = new ResizeObserver(() => {
+        if (this.options.config?.responsive === false) return;
+        this.Plotly.Plots.resize(this.$el);
+      });
+      this.resizeObserver.observe(this.$el);
+    });
+  },
+  unmounted() {
+    this.resizeObserver?.disconnect();
   },
   methods: {
     update() {
@@ -19,11 +29,10 @@ export default {
 
       // default responsive to true
       const options = this.options;
-      if (options.config === undefined) options.config = { responsive: true };
-      if (options.config.responsive === undefined) options.config.responsive = true;
+      if (options.config?.responsive === true) options.config.responsive = undefined;
 
       // re-use plotly instance if config is the same
-      if (JSON.stringify(options.config) == JSON.stringify(this.last_options.config)) {
+      if (this.last_options && JSON.stringify(options.config) === JSON.stringify(this.last_options.config)) {
         this.Plotly.react(this.$el, this.options, options.config);
       } else {
         this.Plotly.newPlot(this.$el, this.options, options.config);
@@ -73,7 +82,7 @@ export default {
   },
   data() {
     return {
-      last_options: {},
+      last_options: null,
     };
   },
   props: {

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/scene/scene.js

@@ -235,7 +235,7 @@ export default {
     }, 100);
   },
 
-  beforeDestroy() {
+  beforeUnmount() {
     window.removeEventListener("resize", this.resize);
     window.removeEventListener("DOMContentLoaded", this.resize);
   },

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/scene/scene_view.js

@@ -101,7 +101,7 @@ export default {
     }, 100);
   },
 
-  beforeDestroy() {
+  beforeUnmount() {
     window.removeEventListener("resize", this.resize);
     window.removeEventListener("DOMContentLoaded", this.resize);
   },

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/table.py

@@ -43,6 +43,7 @@ class Table(FilterElement, component='table.js'):
         """Table
 
         A table based on Quasar's `QTable <https://quasar.dev/vue-components/table>`_ component.
+        Updates can be pushed to the table by updating the ``rows`` or ``columns`` properties.
 
         If ``selection`` is "single" or "multiple", then a ``selected`` property is accessible containing the selected rows.
 
@@ -104,18 +105,19 @@ class Table(FilterElement, component='table.js'):
     def _to_dict(self) -> dict[str, Any]:
         # scan rows for lists and add slot templates if needed
         for column in self._props['columns']:
-            key = column.get('field')
-            if not key or f'body-cell-{key}' in self.slots:
+            field = column.get('field')
+            name = column.get('name')
+            if not field or not name or f'body-cell-{name}' in self.slots:
                 continue
             for row in self._props['rows']:
-                value = row.get(key)
+                value = row.get(field)
                 if isinstance(value, (list, set, tuple)):
                     log.warning(
-                        f'Found list in column "{key}": {value}.\n'
+                        f'Found list in column "{name}": {value}.\n'
                         'Unless there is slot template, table rows must not contain lists or the browser will crash.\n'
                         'NiceGUI is intervening by adding a slot template to display the list as comma-separated values.'
                     )
-                    self.add_slot(f'body-cell-{key}', '''
+                    self.add_slot(f'body-cell-{name}', '''
                         <td class="text-right" :props="props">
                             {{ Array.isArray(props.value) ? props.value.join(', ') : props.value }}
                         </td>

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/time.py

@@ -12,7 +12,7 @@ class Time(ValueElement, DisableableElement):
                  mask: str = 'HH:mm',
                  on_change: Optional[Handler[ValueChangeEventArguments]] = None,
                  ) -> None:
-        """Time Input
+        """Time Picker
 
         This element is based on Quasar's `QTime <https://quasar.dev/vue-components/time>`_ component.
         The time is a string in the format defined by the `mask` parameter.

nicegui-3.3.1/nicegui/elements/time_input.py

@@ -0,0 +1,42 @@
+from typing import Optional
+
+from ..events import Handler, ValueChangeEventArguments
+from .button import Button as button
+from .menu import Menu as menu
+from .mixins.disableable_element import DisableableElement
+from .mixins.label_element import LabelElement
+from .mixins.value_element import ValueElement
+from .time import Time as time
+
+
+class TimeInput(LabelElement, ValueElement, DisableableElement):
+    LOOPBACK = False
+
+    def __init__(self,
+                 label: Optional[str] = None, *,
+                 placeholder: Optional[str] = None,
+                 value: str = '',
+                 on_change: Optional[Handler[ValueChangeEventArguments]] = None,
+                 ) -> None:
+        """Time Input
+
+        This element extends Quasar's `QInput <https://quasar.dev/vue-components/input>`_ component with a time picker.
+
+        *Added in version 3.3.0*
+
+        :param label: displayed label for the time input
+        :param placeholder: text to show if no time is selected
+        :param value: the current time value
+        :param on_change: callback to execute when the value changes
+        """
+        super().__init__(tag='q-input', label=label, value=value, on_value_change=on_change)
+        self._props['for'] = self.html_id
+        if placeholder is not None:
+            self._props['placeholder'] = placeholder
+
+        with self.add_slot('append'):
+            with button(icon='schedule', color=None).props('flat round').classes('cursor-pointer') as self.button:
+                with menu() as self.menu:
+                    self.picker = time()
+
+        self.picker.bind_value(self)

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/elements/tree.py

@@ -22,6 +22,7 @@ class Tree(FilterElement):
         """Tree
 
         Display hierarchical data using Quasar's `QTree <https://quasar.dev/vue-components/tree>`_ component.
+        Updates can be pushed to the tree by updating ``.props['nodes']``.
 
         If using IDs, make sure they are unique within the whole tree.
 

{nicegui-3.2.0 → nicegui-3.3.1}/nicegui/events.py

@@ -63,6 +63,11 @@ class EChartPointClickEventArguments(UiEventArguments):
     value: float | int | list
 
 
+@dataclass(**KWONLY_SLOTS)
+class MermaidNodeClickEventArguments(UiEventArguments):
+    node_id: str
+
+
 @dataclass(**KWONLY_SLOTS)
 class SceneClickHit:
     object_id: str