streamlit-react-components 1.8.1.2__py3-none-any.whl → 1.8.1.3__py3-none-any.whl

streamlit_react_components/form/checkbox_group.py

@@ -1,8 +1,9 @@
 """CheckboxGroup component - A group of checkboxes."""
 
+import streamlit as st
 import streamlit.components.v1 as components
 from pathlib import Path
-from typing import Dict, Any, List, Optional
+from typing import Dict, Any, List, Optional, Callable
 
 _FRONTEND_DIR = Path(__file__).parent.parent / "_frontend"
 
@@ -16,6 +17,9 @@ def checkbox_group(
     items: List[Dict[str, Any]],
     label: str = "",
     layout: str = "vertical",
+    on_change: Optional[Callable] = None,
+    args: Optional[tuple] = None,
+    kwargs: Optional[Dict[str, Any]] = None,
     style: Optional[Dict[str, Any]] = None,
     class_name: str = "",
     theme: Optional[Dict[str, Any]] = None,
@@ -33,6 +37,9 @@ def checkbox_group(
                - disabled: Whether checkbox is disabled (optional, default False)
         label: Optional group label
         layout: Layout direction - "vertical" (default) or "horizontal"
+        on_change: Optional callback function called when selection changes
+        args: Optional tuple of args to pass to on_change callback
+        kwargs: Optional dict of kwargs to pass to on_change callback
         style: Inline CSS styles as a dictionary
         class_name: Tailwind CSS classes
         theme: Optional theme dictionary. If None, uses active global theme.
@@ -40,7 +47,7 @@ def checkbox_group(
         defer_update: If True, don't trigger Streamlit rerun on change.
                       Value is stored locally and sent on next rerun (e.g., Apply button).
                       Requires 'key' to be set.
-        key: Unique key for the component (required if defer_update=True)
+        key: Unique key for the component (required if on_change or defer_update is used)
 
     Returns:
         List of checked item IDs
@@ -97,4 +104,19 @@ def checkbox_group(
         key=key,
         default=default_checked,
     )
-    return result if result is not None else default_checked
+
+    final_result = result if result is not None else default_checked
+
+    # Execute on_change callback if value changed
+    if on_change and key:
+        prev_key = f"_checkbox_group_prev_{key}"
+        prev_value = st.session_state.get(prev_key)
+
+        # Only fire callback if value actually changed (not on first render)
+        if prev_value is not None and set(final_result) != set(prev_value):
+            on_change(*(args or ()), **(kwargs or {}))
+
+        # Always update previous value
+        st.session_state[prev_key] = final_result
+
+    return final_result

streamlit_react_components/form/form_date_slider.py

@@ -1,9 +1,10 @@
 """FormDateSlider component - A date slider with optional range selection."""
 
+import streamlit as st
 import streamlit.components.v1 as components
 from pathlib import Path
 from datetime import date, timedelta
-from typing import Dict, Any, Optional, Union, Tuple
+from typing import Dict, Any, Optional, Union, Tuple, Callable
 
 _FRONTEND_DIR = Path(__file__).parent.parent / "_frontend"
 
@@ -22,6 +23,9 @@ def form_date_slider(
     step: Optional[timedelta] = None,
     format: str = "YYYY-MM",
     color: str = "blue",
+    on_change: Optional[Callable] = None,
+    args: Optional[tuple] = None,
+    kwargs: Optional[Dict[str, Any]] = None,
     style: Optional[Dict[str, Any]] = None,
     class_name: str = "",
     theme: Optional[Dict[str, Any]] = None,
@@ -43,11 +47,14 @@ def form_date_slider(
               Defaults to timedelta(days=1)
         format: Display format string - "YYYY-MM", "YYYY-MM-DD", "MMM YYYY", etc.
         color: Accent color - preset name or hex value
+        on_change: Optional callback function called when value changes
+        args: Optional tuple of args to pass to on_change callback
+        kwargs: Optional dict of kwargs to pass to on_change callback
         style: Inline CSS styles as a dictionary
         class_name: Tailwind CSS classes
         theme: Optional theme dictionary. If None, uses active global theme.
         defer_update: If True, don't trigger Streamlit rerun on change.
-        key: Unique key for the component
+        key: Unique key for the component (required if on_change or defer_update is used)
 
     Returns:
         Single date if value was a date, or tuple (start, end) if value was a tuple
@@ -135,13 +142,28 @@ def form_date_slider(
 
     # Parse result back to date objects
     if result is None:
-        return value
-
-    if is_range:
+        final_result = value
+    elif is_range:
         if isinstance(result, (list, tuple)) and len(result) == 2:
-            return (date.fromisoformat(result[0]), date.fromisoformat(result[1]))
-        return value
+            final_result = (date.fromisoformat(result[0]), date.fromisoformat(result[1]))
+        else:
+            final_result = value
     else:
         if isinstance(result, str):
-            return date.fromisoformat(result)
-        return value
+            final_result = date.fromisoformat(result)
+        else:
+            final_result = value
+
+    # Execute on_change callback if value changed
+    if on_change and key:
+        prev_key = f"_form_date_slider_prev_{key}"
+        prev_value = st.session_state.get(prev_key)
+
+        # Only fire callback if value actually changed (not on first render)
+        if prev_value is not None and final_result != prev_value:
+            on_change(*(args or ()), **(kwargs or {}))
+
+        # Always update previous value
+        st.session_state[prev_key] = final_result
+
+    return final_result

streamlit_react_components/form/form_select.py

@@ -1,8 +1,9 @@
 """FormSelect component - A styled dropdown select input."""
 
+import streamlit as st
 import streamlit.components.v1 as components
 from pathlib import Path
-from typing import Dict, Any, List, Optional, Union
+from typing import Dict, Any, List, Optional, Union, Callable
 
 _FRONTEND_DIR = Path(__file__).parent.parent / "_frontend"
 
@@ -17,6 +18,9 @@ def form_select(
     options: List[Union[str, Dict[str, str]]],
     value: str = "",
     groups: Optional[List[Dict[str, Any]]] = None,
+    on_change: Optional[Callable] = None,
+    args: Optional[tuple] = None,
+    kwargs: Optional[Dict[str, Any]] = None,
     style: Optional[Dict[str, Any]] = None,
     class_name: str = "",
     theme: Optional[Dict[str, Any]] = None,
@@ -33,6 +37,9 @@ def form_select(
         groups: Optional list of option groups, each with:
                 - label: Group header text
                 - options: List of options in this group
+        on_change: Optional callback function called when value changes
+        args: Optional tuple of args to pass to on_change callback
+        kwargs: Optional dict of kwargs to pass to on_change callback
         style: Inline CSS styles as a dictionary
         class_name: Tailwind CSS classes
         theme: Optional theme dictionary. If None, uses active global theme.
@@ -40,7 +47,7 @@ def form_select(
         defer_update: If True, don't trigger Streamlit rerun on change.
                       Value is stored locally and sent on next rerun (e.g., Apply button).
                       Requires 'key' to be set.
-        key: Unique key for the component (required if defer_update=True)
+        key: Unique key for the component (required if on_change or defer_update is used)
 
     Returns:
         The currently selected value
@@ -53,24 +60,28 @@ def form_select(
             value="AML_14"
         )
 
-        # With option groups
-        version = form_select(
-            label="Base On",
-            groups=[
-                {"label": "Baselines", "options": ["Baseline v7"]},
-                {"label": "Scenarios", "options": ["Q2 Demand Surge"]}
-            ]
+        # With on_change callback
+        def handle_change():
+            st.write("Selection changed!")
+
+        site = form_select(
+            label="Site",
+            options=["AML_14", "ADL", "Devens"],
+            on_change=handle_change,
+            key="site_select"
         )
 
-        # Deferred update (no rerun until Apply button clicked)
+        # With on_change and args
+        def handle_change(component_name):
+            st.write(f"{component_name} changed!")
+
         site = form_select(
             label="Site",
             options=["AML_14", "ADL", "Devens"],
-            defer_update=True,
+            on_change=handle_change,
+            args=("site_select",),
             key="site_select"
         )
-        if st.button("Apply"):
-            st.rerun()
     """
     # Resolve theme (None = use global, False = disable)
     from ..themes import get_active_theme
@@ -92,4 +103,19 @@ def form_select(
         key=key,
         default=value,
     )
-    return result if result is not None else value
+
+    final_result = result if result is not None else value
+
+    # Execute on_change callback if value changed
+    if on_change and key:
+        prev_key = f"_form_select_prev_{key}"
+        prev_value = st.session_state.get(prev_key)
+
+        # Only fire callback if value actually changed (not on first render)
+        if prev_value is not None and final_result != prev_value:
+            on_change(*(args or ()), **(kwargs or {}))
+
+        # Always update previous value
+        st.session_state[prev_key] = final_result
+
+    return final_result

streamlit_react_components/form/form_slider.py

@@ -1,8 +1,9 @@
 """FormSlider component - A styled range slider input."""
 
+import streamlit as st
 import streamlit.components.v1 as components
 from pathlib import Path
-from typing import Dict, Any, Optional
+from typing import Dict, Any, Optional, Callable
 
 _FRONTEND_DIR = Path(__file__).parent.parent / "_frontend"
 
@@ -20,6 +21,9 @@ def form_slider(
     step: float = 1,
     unit: str = "",
     color: str = "blue",
+    on_change: Optional[Callable] = None,
+    args: Optional[tuple] = None,
+    kwargs: Optional[Dict[str, Any]] = None,
     style: Optional[Dict[str, Any]] = None,
     class_name: str = "",
     theme: Optional[Dict[str, Any]] = None,
@@ -38,6 +42,9 @@ def form_slider(
         unit: Unit suffix to display (e.g., "%", "hrs")
         color: Accent color - preset name ("blue", "green", "red", "yellow",
                "purple", "slate") or hex value (e.g., "#94a3b8")
+        on_change: Optional callback function called when value changes
+        args: Optional tuple of args to pass to on_change callback
+        kwargs: Optional dict of kwargs to pass to on_change callback
         style: Inline CSS styles as a dictionary
         class_name: Tailwind CSS classes
         theme: Optional theme dictionary. If None, uses active global theme.
@@ -45,7 +52,7 @@ def form_slider(
         defer_update: If True, don't trigger Streamlit rerun on change.
                       Value is stored locally and sent on next rerun (e.g., Apply button).
                       Requires 'key' to be set.
-        key: Unique key for the component (required if defer_update=True)
+        key: Unique key for the component (required if on_change or defer_update is used)
 
     Returns:
         The current slider value
@@ -105,4 +112,19 @@ def form_slider(
         key=key,
         default=value,
     )
-    return float(result) if result is not None else value
+
+    final_result = float(result) if result is not None else value
+
+    # Execute on_change callback if value changed
+    if on_change and key:
+        prev_key = f"_form_slider_prev_{key}"
+        prev_value = st.session_state.get(prev_key)
+
+        # Only fire callback if value actually changed (not on first render)
+        if prev_value is not None and final_result != prev_value:
+            on_change(*(args or ()), **(kwargs or {}))
+
+        # Always update previous value
+        st.session_state[prev_key] = final_result
+
+    return final_result

streamlit_react_components/form/radio_group.py

@@ -1,8 +1,9 @@
 """RadioGroup component - A group of radio buttons for single selection."""
 
+import streamlit as st
 import streamlit.components.v1 as components
 from pathlib import Path
-from typing import Dict, Any, List, Optional
+from typing import Dict, Any, List, Optional, Callable
 
 _FRONTEND_DIR = Path(__file__).parent.parent / "_frontend"
 
@@ -16,6 +17,9 @@ def radio_group(
     items: List[Dict[str, Any]],
     label: str = "",
     layout: str = "vertical",
+    on_change: Optional[Callable] = None,
+    args: Optional[tuple] = None,
+    kwargs: Optional[Dict[str, Any]] = None,
     style: Optional[Dict[str, Any]] = None,
     class_name: str = "",
     theme: Optional[Dict[str, Any]] = None,
@@ -33,6 +37,9 @@ def radio_group(
                - disabled: Whether item is disabled (optional, default False)
         label: Optional group label
         layout: Layout direction - "vertical" (default) or "horizontal"
+        on_change: Optional callback function called when selection changes
+        args: Optional tuple of args to pass to on_change callback
+        kwargs: Optional dict of kwargs to pass to on_change callback
         style: Inline CSS styles as a dictionary
         class_name: Tailwind CSS classes
         theme: Optional theme dictionary. If None, uses active global theme.
@@ -40,7 +47,7 @@ def radio_group(
         defer_update: If True, don't trigger Streamlit rerun on change.
                       Value is stored locally and sent on next rerun (e.g., Apply button).
                       Requires 'key' to be set.
-        key: Unique key for the component (required if defer_update=True)
+        key: Unique key for the component (required if on_change or defer_update is used)
 
     Returns:
         ID of the selected item (string), or None if nothing selected
@@ -92,4 +99,19 @@ def radio_group(
         key=key,
         default=default_selected,
     )
-    return result if result is not None else default_selected
+
+    final_result = result if result is not None else default_selected
+
+    # Execute on_change callback if value changed
+    if on_change and key:
+        prev_key = f"_radio_group_prev_{key}"
+        prev_value = st.session_state.get(prev_key)
+
+        # Only fire callback if value actually changed (not on first render)
+        if prev_value is not None and final_result != prev_value:
+            on_change(*(args or ()), **(kwargs or {}))
+
+        # Always update previous value
+        st.session_state[prev_key] = final_result
+
+    return final_result

{streamlit_react_components-1.8.1.2.dist-info → streamlit_react_components-1.8.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: streamlit-react-components
-Version: 1.8.1.2
+Version: 1.8.1.3
 Summary: Reusable React-based Streamlit components with Tailwind CSS styling
 License: MIT
 Project-URL: Homepage, https://github.com/your-org/streamlit-react-components

{streamlit_react_components-1.8.1.2.dist-info → streamlit_react_components-1.8.1.3.dist-info}/RECORD

@@ -17,12 +17,12 @@ streamlit_react_components/common/smart_chart.py,sha256=kYzdPTpgdJLfX6CUXuT8fUMR
 streamlit_react_components/common/stat_card.py,sha256=-C-73nglpPFbtliK7JfZLQExc9N1wYsyTjDsTXHVjKQ,4758
 streamlit_react_components/common/step_indicator.py,sha256=RjoBdgWrhrUc2Rs5lTxs_4ocBuMJDI8ELNIQE_0Y7js,1817
 streamlit_react_components/form/__init__.py,sha256=urk_QJxnOrlMoHBTbCUGfjwxCbNs5lTFIoexUYB4AsA,349
-streamlit_react_components/form/checkbox_group.py,sha256=yF2g991jPwOIk28ugyJ8T7-K2kQnCUXdymmIxzuV74g,3325
-streamlit_react_components/form/form_date_slider.py,sha256=YB--bP0M_qgfcCyZ5A7AAYhgMIEXVtntC4vEmoTZh6U,4819
-streamlit_react_components/form/form_select.py,sha256=bzrfFtE8gtMszqL77hUa4TBa5LvUI88RxcNhwt1ojx0,3021
-streamlit_react_components/form/form_slider.py,sha256=vK8iqlWNnly0UiSdI71fxkjNZK0ZJlUC8DCkjBcULmI,3143
-streamlit_react_components/form/radio_group.py,sha256=1mL6FOhBfiPQSV6owUl7rcl0AgR5xIE-RmfiKPb-fVk,3217
-streamlit_react_components-1.8.1.2.dist-info/METADATA,sha256=_1ukQctQERr4UBLunENmwTlcwHJ06-qmSwRLCMeCWy4,21679
-streamlit_react_components-1.8.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-streamlit_react_components-1.8.1.2.dist-info/top_level.txt,sha256=3JFrl15-Uewx3BFMSzqrBufF9GmTS1LDKfShmg0R9VE,27
-streamlit_react_components-1.8.1.2.dist-info/RECORD,,
+streamlit_react_components/form/checkbox_group.py,sha256=P3UJ0JrPpkx_yMDy0bzEt7VyIEmG1iB847a9-TKfPbA,4219
+streamlit_react_components/form/form_date_slider.py,sha256=FpKvY7uV5uTsLcjOQwPX_IQL97I4Jg7t-e-RVf1329Y,5801
+streamlit_react_components/form/form_select.py,sha256=bJFyN9at6nTyDcev_7l7pYDW_KhXHG2D7lSfNxPIPTQ,3964
+streamlit_react_components/form/form_slider.py,sha256=ZL1fCLCfanolmxOzuEQo28D1WYFy17uH0EuwbFwD7f8,4020
+streamlit_react_components/form/radio_group.py,sha256=ktmB37APMLiaUJGmP38hlA6I_diPyexkcNGXCvDXjw8,4098
+streamlit_react_components-1.8.1.3.dist-info/METADATA,sha256=88SfH9dY_2E48T-9gAsJMOFqLcY99NNB_rh5aZfWTdE,21679
+streamlit_react_components-1.8.1.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+streamlit_react_components-1.8.1.3.dist-info/top_level.txt,sha256=3JFrl15-Uewx3BFMSzqrBufF9GmTS1LDKfShmg0R9VE,27
+streamlit_react_components-1.8.1.3.dist-info/RECORD,,