streamlit-react-components 1.7.4__py3-none-any.whl → 1.8.0__py3-none-any.whl

streamlit_react_components/form/__init__.py

@@ -2,12 +2,14 @@
 
 from .form_select import form_select
 from .form_slider import form_slider
+from .form_date_slider import form_date_slider
 from .checkbox_group import checkbox_group
 from .radio_group import radio_group
 
 __all__ = [
     "form_select",
     "form_slider",
+    "form_date_slider",
     "checkbox_group",
     "radio_group",
 ]

streamlit_react_components/form/form_date_slider.py

@@ -0,0 +1,147 @@
+"""FormDateSlider component - A date slider with optional range selection."""
+
+import streamlit.components.v1 as components
+from pathlib import Path
+from datetime import date, timedelta
+from typing import Dict, Any, Optional, Union, Tuple
+
+_FRONTEND_DIR = Path(__file__).parent.parent / "_frontend"
+
+_component = components.declare_component(
+    "streamlit_react_components",
+    path=str(_FRONTEND_DIR),
+)
+
+
+def form_date_slider(
+    label: str,
+    min_val: date,
+    max_val: date,
+    value: Union[date, Tuple[date, date]],
+    step_type: Optional[str] = "month",
+    step: Optional[timedelta] = None,
+    format: str = "YYYY-MM",
+    color: str = "blue",
+    style: Optional[Dict[str, Any]] = None,
+    class_name: str = "",
+    theme: Optional[Dict[str, Any]] = None,
+    defer_update: bool = False,
+    key: Optional[str] = None,
+) -> Union[date, Tuple[date, date]]:
+    """
+    Display a date slider with single or range selection.
+
+    Args:
+        label: Label text for the slider
+        min_val: Minimum selectable date
+        max_val: Maximum selectable date
+        value: Current value - single date or tuple of (start, end) for range mode
+        step_type: Step granularity - "month", "quarter", "year", "week", "day", or None
+                   When set to a calendar unit, snaps to boundaries (e.g., 1st of month).
+                   When "day" or None, uses the `step` timedelta parameter.
+        step: Step increment as timedelta (only used when step_type is "day" or None)
+              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
+        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
+
+    Returns:
+        Single date if value was a date, or tuple (start, end) if value was a tuple
+
+    Example:
+        # Monthly range selection
+        start, end = form_date_slider(
+            label="Date Range",
+            min_val=date(2024, 1, 1),
+            max_val=date(2025, 12, 31),
+            value=(date(2024, 3, 1), date(2024, 9, 1)),
+            step_type="month",
+            format="YYYY-MM",
+            key="date_range"
+        )
+
+        # Single month selection
+        selected = form_date_slider(
+            label="Select Month",
+            min_val=date(2024, 1, 1),
+            max_val=date(2025, 12, 31),
+            value=date(2024, 6, 1),
+            step_type="month",
+            format="YYYY-MM",
+            key="single_month"
+        )
+
+        # Daily stepping with custom interval
+        selected = form_date_slider(
+            label="Select Date",
+            min_val=date(2024, 1, 1),
+            max_val=date(2024, 12, 31),
+            value=date(2024, 6, 15),
+            step_type="day",
+            step=timedelta(days=7),  # Weekly steps
+            format="YYYY-MM-DD",
+            key="weekly_date"
+        )
+    """
+    # Determine if range mode based on value type
+    is_range = isinstance(value, (tuple, list))
+
+    # Convert dates to ISO strings
+    min_val_str = min_val.isoformat()
+    max_val_str = max_val.isoformat()
+
+    if is_range:
+        value_data = [value[0].isoformat(), value[1].isoformat()]
+        default_data = value_data
+    else:
+        value_data = value.isoformat()
+        default_data = value_data
+
+    # Convert step timedelta to days if provided
+    step_days = None
+    if step is not None:
+        step_days = step.days
+    elif step_type in ("day", None):
+        step_days = 1  # Default to 1 day
+
+    # Resolve theme (None = use global, False = disable)
+    from ..themes import get_active_theme
+    resolved_theme = None
+    if theme is not False:
+        resolved_theme = theme if theme is not None else get_active_theme()
+
+    result = _component(
+        component="form_date_slider",
+        label=label,
+        minVal=min_val_str,
+        maxVal=max_val_str,
+        value=value_data,
+        stepType=step_type,
+        stepDays=step_days,
+        format=format,
+        color=color,
+        style=style,
+        className=class_name,
+        theme=resolved_theme,
+        deferUpdate=defer_update,
+        componentKey=key,
+        key=key,
+        default=default_data,
+    )
+
+    # Parse result back to date objects
+    if result is None:
+        return value
+
+    if is_range:
+        if isinstance(result, (list, tuple)) and len(result) == 2:
+            return (date.fromisoformat(result[0]), date.fromisoformat(result[1]))
+        return value
+    else:
+        if isinstance(result, str):
+            return date.fromisoformat(result)
+        return value

{streamlit_react_components-1.7.4.dist-info → streamlit_react_components-1.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: streamlit-react-components
-Version: 1.7.4
+Version: 1.8.0
 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.7.4.dist-info → streamlit_react_components-1.8.0.dist-info}/RECORD

@@ -1,10 +1,10 @@
-streamlit_react_components/__init__.py,sha256=dt1w6R5UewV25eLjdcIhFBzZGKxowJFrZEpWgjshj3o,1077
+streamlit_react_components/__init__.py,sha256=JXkDquePuBCkfzO7zA97cteHK3TiPlL84n1Fs6S1DJc,1123
 streamlit_react_components/styled_container.py,sha256=wtCiEC-cc1lUredDquG8jcccZYW86eKNrUZtWD6mw84,6063
 streamlit_react_components/tailwind.py,sha256=2UDnKnHWmY3CWyfyEc-jHbznepjPi9Zy5Ugi0UsIDBQ,47953
 streamlit_react_components/themes.py,sha256=zAp314i-WZMP5WZjOKrFoKmTd84tLyuyICKOJAz4rB0,35225
-streamlit_react_components/_frontend/index.css,sha256=RaHZDlv7w2l_JlpyaVjuFIqaVBDXdpVfXE-Ugry8sPw,28362
+streamlit_react_components/_frontend/index.css,sha256=-7DpJfCcUcRr37z2HCkXDjxc73WR1S037T1MBEZEWBg,30134
 streamlit_react_components/_frontend/index.html,sha256=CjBEtVYlgT_q06BE16EHFrUrJZ6z0MCprrTg7qgAWzw,381
-streamlit_react_components/_frontend/index.js,sha256=RwEfDji6viehTvvl6YIB0lLBoXZY9P75ivYA2hMogxc,5226927
+streamlit_react_components/_frontend/index.js,sha256=s6O4xlg5I_P0GkZASyz3iNwX2eW5Cj1otJ9DsKzNmdc,5232620
 streamlit_react_components/common/__init__.py,sha256=l5BfFZdqjrdLG3sJnJrgahEiTgoBX92_aE0wp2tn_w0,606
 streamlit_react_components/common/button_group.py,sha256=TlOmJRCPEb4MWMmKKiTe2a8ENElC_YB83mHp_WCFDas,2672
 streamlit_react_components/common/chart_legend.py,sha256=ylul6Os5A89S8fIJs7XpBdIk6uWijg_zwR1eB7u9wSw,1824
@@ -16,12 +16,13 @@ streamlit_react_components/common/section_header.py,sha256=zgEW9Jlj48kiRB3_mYLk3
 streamlit_react_components/common/smart_chart.py,sha256=kYzdPTpgdJLfX6CUXuT8fUMRubN1DRZ9Zej-XFFgje4,20068
 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=jtK9U5HXCKo4KX7Sk5Yw1o0vis2nvh3pF1BM9oi7es8,278
+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.7.4.dist-info/METADATA,sha256=mQK7Ah4sCuMAYMt3rnhd5ZwqrpEQtiqEBcO23sw2730,21677
-streamlit_react_components-1.7.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-streamlit_react_components-1.7.4.dist-info/top_level.txt,sha256=3JFrl15-Uewx3BFMSzqrBufF9GmTS1LDKfShmg0R9VE,27
-streamlit_react_components-1.7.4.dist-info/RECORD,,
+streamlit_react_components-1.8.0.dist-info/METADATA,sha256=BPwpzbSogu48p6DVIrLndWFhnSGie22N27os_xb3YUY,21677
+streamlit_react_components-1.8.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+streamlit_react_components-1.8.0.dist-info/top_level.txt,sha256=3JFrl15-Uewx3BFMSzqrBufF9GmTS1LDKfShmg0R9VE,27
+streamlit_react_components-1.8.0.dist-info/RECORD,,