streamlit-react-components 1.0.0__py3-none-any.whl

streamlit_react_components/common/step_indicator.py

@@ -0,0 +1,51 @@
+"""StepIndicator component - A multi-step wizard progress indicator."""
+
+import streamlit.components.v1 as components
+from pathlib import Path
+from typing import Dict, Any, List, Optional
+
+_FRONTEND_DIR = Path(__file__).parent.parent / "_frontend"
+
+_component = components.declare_component(
+    "streamlit_react_components",
+    path=str(_FRONTEND_DIR),
+)
+
+
+def step_indicator(
+    steps: List[str],
+    current_step: int,
+    style: Optional[Dict[str, Any]] = None,
+    class_name: str = "",
+    key: Optional[str] = None,
+) -> Optional[int]:
+    """
+    Display a multi-step wizard progress indicator.
+
+    Args:
+        steps: List of step labels (e.g., ["Supply Plan", "Levers", "Review"])
+        current_step: Current active step (1-indexed)
+        style: Inline CSS styles as a dictionary
+        class_name: Tailwind CSS classes
+        key: Unique key for the component
+
+    Returns:
+        The step number that was clicked, or None if no click
+
+    Example:
+        step = step_indicator(
+            steps=["Supply Plan", "Levers", "Review"],
+            current_step=2
+        )
+        if step:
+            st.session_state.step = step
+    """
+    return _component(
+        component="step_indicator",
+        steps=steps,
+        currentStep=current_step,
+        style=style,
+        className=class_name,
+        key=key,
+        default=None,
+    )

streamlit_react_components/form/__init__.py

@@ -0,0 +1,11 @@
+"""Form input components."""
+
+from .form_select import form_select
+from .form_slider import form_slider
+from .checkbox_group import checkbox_group
+
+__all__ = [
+    "form_select",
+    "form_slider",
+    "checkbox_group",
+]

streamlit_react_components/form/checkbox_group.py

@@ -0,0 +1,61 @@
+"""CheckboxGroup component - A group of checkboxes."""
+
+import streamlit.components.v1 as components
+from pathlib import Path
+from typing import Dict, Any, List, Optional
+
+_FRONTEND_DIR = Path(__file__).parent.parent / "_frontend"
+
+_component = components.declare_component(
+    "streamlit_react_components",
+    path=str(_FRONTEND_DIR),
+)
+
+
+def checkbox_group(
+    items: List[Dict[str, Any]],
+    label: str = "",
+    style: Optional[Dict[str, Any]] = None,
+    class_name: str = "",
+    key: Optional[str] = None,
+) -> List[str]:
+    """
+    Display a group of checkboxes.
+
+    Args:
+        items: List of checkbox items, each with:
+               - id: Unique identifier
+               - label: Display label
+               - checked: Initial checked state (optional, default False)
+        label: Optional group label
+        style: Inline CSS styles as a dictionary
+        class_name: Tailwind CSS classes
+        key: Unique key for the component
+
+    Returns:
+        List of checked item IDs
+
+    Example:
+        selected = checkbox_group(
+            label="Parameters",
+            items=[
+                {"id": "vphp", "label": "VPHP Hold", "checked": True},
+                {"id": "lot_co", "label": "Lot C/O", "checked": True},
+                {"id": "batch", "label": "Batch Size"}
+            ]
+        )
+        # Returns: ["vphp", "lot_co"] if those are checked
+    """
+    # Get default checked items
+    default_checked = [item["id"] for item in items if item.get("checked", False)]
+
+    result = _component(
+        component="checkbox_group",
+        label=label,
+        items=items,
+        style=style,
+        className=class_name,
+        key=key,
+        default=default_checked,
+    )
+    return result if result is not None else default_checked

streamlit_react_components/form/form_select.py

@@ -0,0 +1,69 @@
+"""FormSelect component - A styled dropdown select input."""
+
+import streamlit.components.v1 as components
+from pathlib import Path
+from typing import Dict, Any, List, Optional, Union
+
+_FRONTEND_DIR = Path(__file__).parent.parent / "_frontend"
+
+_component = components.declare_component(
+    "streamlit_react_components",
+    path=str(_FRONTEND_DIR),
+)
+
+
+def form_select(
+    label: str,
+    options: List[Union[str, Dict[str, str]]],
+    value: str = "",
+    groups: Optional[List[Dict[str, Any]]] = None,
+    style: Optional[Dict[str, Any]] = None,
+    class_name: str = "",
+    key: Optional[str] = None,
+) -> str:
+    """
+    Display a styled dropdown select input.
+
+    Args:
+        label: Label text for the select
+        options: List of options, either strings or dicts with {value, label}
+        value: Currently selected value
+        groups: Optional list of option groups, each with:
+                - label: Group header text
+                - options: List of options in this group
+        style: Inline CSS styles as a dictionary
+        class_name: Tailwind CSS classes
+        key: Unique key for the component
+
+    Returns:
+        The currently selected value
+
+    Example:
+        # Simple string options
+        site = form_select(
+            label="Site",
+            options=["AML_14", "ADL", "Devens"],
+            value="AML_14"
+        )
+
+        # With option groups
+        version = form_select(
+            label="Base On",
+            groups=[
+                {"label": "Baselines", "options": ["Baseline v7"]},
+                {"label": "Scenarios", "options": ["Q2 Demand Surge"]}
+            ]
+        )
+    """
+    result = _component(
+        component="form_select",
+        label=label,
+        options=options,
+        value=value,
+        groups=groups,
+        style=style,
+        className=class_name,
+        key=key,
+        default=value,
+    )
+    return result if result is not None else value

streamlit_react_components/form/form_slider.py

@@ -0,0 +1,80 @@
+"""FormSlider component - A styled range slider input."""
+
+import streamlit.components.v1 as components
+from pathlib import Path
+from typing import Dict, Any, Optional
+
+_FRONTEND_DIR = Path(__file__).parent.parent / "_frontend"
+
+_component = components.declare_component(
+    "streamlit_react_components",
+    path=str(_FRONTEND_DIR),
+)
+
+
+def form_slider(
+    label: str,
+    value: float,
+    min_val: float,
+    max_val: float,
+    step: float = 1,
+    unit: str = "",
+    color: str = "blue",
+    style: Optional[Dict[str, Any]] = None,
+    class_name: str = "",
+    key: Optional[str] = None,
+) -> float:
+    """
+    Display a styled range slider input.
+
+    Args:
+        label: Label text for the slider
+        value: Current value
+        min_val: Minimum value
+        max_val: Maximum value
+        step: Step increment (default 1)
+        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")
+        style: Inline CSS styles as a dictionary
+        class_name: Tailwind CSS classes
+        key: Unique key for the component
+
+    Returns:
+        The current slider value
+
+    Example:
+        # Using preset color
+        threshold = form_slider(
+            label="Upper Threshold",
+            value=90,
+            min_val=75,
+            max_val=100,
+            unit="%",
+            color="red"
+        )
+
+        # Using hex color
+        threshold = form_slider(
+            label="Custom Slider",
+            value=50,
+            min_val=0,
+            max_val=100,
+            color="#ff5733"
+        )
+    """
+    result = _component(
+        component="form_slider",
+        label=label,
+        value=value,
+        minVal=min_val,
+        maxVal=max_val,
+        step=step,
+        unit=unit,
+        color=color,
+        style=style,
+        className=class_name,
+        key=key,
+        default=value,
+    )
+    return float(result) if result is not None else value