streamlit-react-components 1.8.1.2__tar.gz → 1.8.1.4__tar.gz

{streamlit_react_components-1.8.1.2/src/streamlit_react_components.egg-info → streamlit_react_components-1.8.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: streamlit-react-components
-Version: 1.8.1.2
+Version: 1.8.1.4
 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 → streamlit_react_components-1.8.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "streamlit-react-components"
-version = "1.8.1.2"
+version = "1.8.1.4"
 description = "Reusable React-based Streamlit components with Tailwind CSS styling"
 readme = "README.md"
 license = {text = "MIT"}

{streamlit_react_components-1.8.1.2 → streamlit_react_components-1.8.1.4}/src/streamlit_react_components/common/button_group.py

@@ -1,8 +1,9 @@
 """ButtonGroup component - A group of action buttons."""
 
+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"
 
@@ -14,6 +15,9 @@ _component = components.declare_component(
 
 def button_group(
     buttons: List[Dict[str, Any]],
+    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,
@@ -32,11 +36,14 @@ def button_group(
                  - disabled: Whether button is disabled (optional)
                  - style: Inline CSS styles dict for this button (optional)
                  - className: Tailwind CSS classes for this button (optional)
+        on_change: Optional callback function called when a button is clicked
+        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.
                Set to False to disable theming for this component.
-        key: Unique key for the component
+        key: Unique key for the component (required if on_change is used)
 
     Returns:
         The ID of the clicked button, or None if no click
@@ -68,7 +75,7 @@ def button_group(
     if theme is not False:
         resolved_theme = theme if theme is not None else get_active_theme()
 
-    return _component(
+    result = _component(
         component="button_group",
         buttons=buttons,
         style=style,
@@ -77,3 +84,17 @@ def button_group(
         key=key,
         default=None,
     )
+
+    # Execute on_change callback if a button was clicked
+    if on_change and key:
+        prev_key = f"_button_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 result != prev_value:
+            on_change(*(args or ()), **(kwargs or {}))
+
+        # Always update previous value
+        st.session_state[prev_key] = result
+
+    return result

{streamlit_react_components-1.8.1.2 → streamlit_react_components-1.8.1.4}/src/streamlit_react_components/common/data_table.py

@@ -1,8 +1,9 @@
 """DataTable component - A styled data table with click support."""
 
+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 data_table(
     columns: List[Dict[str, Any]],
     rows: List[Dict[str, Any]],
     show_header: bool = True,
+    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,11 +37,14 @@ def data_table(
                  - colorByValue: True to color based on status values (optional)
         rows: List of row data dictionaries
         show_header: Whether to show the header row (default True)
+        on_change: Optional callback function called when a row is clicked
+        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.
                Set to False to disable theming for this component.
-        key: Unique key for the component
+        key: Unique key for the component (required if on_change is used)
 
     Returns:
         Dictionary with rowIndex and rowData when a row is clicked, None otherwise
@@ -62,7 +69,7 @@ def data_table(
     if theme is not False:
         resolved_theme = theme if theme is not None else get_active_theme()
 
-    return _component(
+    result = _component(
         component="data_table",
         columns=columns,
         rows=rows,
@@ -73,3 +80,17 @@ def data_table(
         key=key,
         default=None,
     )
+
+    # Execute on_change callback if a row was clicked
+    if on_change and key:
+        prev_key = f"_data_table_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 result != prev_value:
+            on_change(*(args or ()), **(kwargs or {}))
+
+        # Always update previous value
+        st.session_state[prev_key] = result
+
+    return result

{streamlit_react_components-1.8.1.2 → streamlit_react_components-1.8.1.4}/src/streamlit_react_components/common/step_indicator.py

@@ -1,8 +1,9 @@
 """StepIndicator component - A multi-step wizard progress indicator."""
 
+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"
 
@@ -15,6 +16,9 @@ _component = components.declare_component(
 def step_indicator(
     steps: List[str],
     current_step: int,
+    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,
@@ -26,11 +30,14 @@ def step_indicator(
     Args:
         steps: List of step labels (e.g., ["Supply Plan", "Levers", "Review"])
         current_step: Current active step (1-indexed)
+        on_change: Optional callback function called when a step is clicked
+        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.
                Set to False to disable theming for this component.
-        key: Unique key for the component
+        key: Unique key for the component (required if on_change is used)
 
     Returns:
         The step number that was clicked, or None if no click
@@ -49,7 +56,7 @@ def step_indicator(
     if theme is not False:
         resolved_theme = theme if theme is not None else get_active_theme()
 
-    return _component(
+    result = _component(
         component="step_indicator",
         steps=steps,
         currentStep=current_step,
@@ -59,3 +66,17 @@ def step_indicator(
         key=key,
         default=None,
     )
+
+    # Execute on_change callback if a step was clicked
+    if on_change and key:
+        prev_key = f"_step_indicator_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 result != prev_value:
+            on_change(*(args or ()), **(kwargs or {}))
+
+        # Always update previous value
+        st.session_state[prev_key] = result
+
+    return result

{streamlit_react_components-1.8.1.2 → streamlit_react_components-1.8.1.4}/src/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-1.8.1.2 → streamlit_react_components-1.8.1.4}/src/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-1.8.1.2 → streamlit_react_components-1.8.1.4}/src/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-1.8.1.2 → streamlit_react_components-1.8.1.4}/src/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-1.8.1.2 → streamlit_react_components-1.8.1.4}/src/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 → streamlit_react_components-1.8.1.4/src/streamlit_react_components.egg-info}/PKG-INFO

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