mm-streamlit-table 0.0.2__tar.gz

mm_streamlit_table-0.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EPEC Group
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mm_streamlit_table-0.0.2/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: mm-streamlit-table
+Version: 0.0.2
+Summary: Themeable Streamlit table component (React + TanStack) with stable in-component state.
+License: MIT
+Keywords: streamlit,table,datagrid,tanstack,react
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: streamlit>=1.30
+Requires-Dist: pandas>=2.0
+Dynamic: license-file
+
+# mm-streamlit-table
+
+An opinionated, themeable Streamlit table component built with React +
+[TanStack Table](https://tanstack.com/table). MIT-licensed and dependency-light.
+
+Why this exists: most Streamlit table components either rerun the entire page
+on every interaction (selection loops, lost filter state) or are styled in a
+way that resists customisation. `mm-streamlit-table` keeps UI state inside
+the component and only emits **semantic events** back to Streamlit.
+
+## Features
+
+- **No rerun loops.** Sort, filter, expand, and resize are local. Streamlit
+  only hears about events you care about (selection, action clicks).
+- **Themeable from Python** via a small set of generic design tokens that
+  map to CSS custom properties. Drop in your own tokens or override the
+  CSS variables directly.
+- **Real React renderers** — bring your own cell components (tags, JSON
+  chips, copy-to-clipboard, badges, anything you write in TSX).
+- **No enterprise license.** Filtering features that AG Grid puts behind a
+  paywall (multi-filter, set filter) are built in.
+
+## Install
+
+```bash
+pip install mm-streamlit-table
+```
+
+## Quick start
+
+```python
+import pandas as pd
+import streamlit as st
+from mm_streamlit_table import mm_table
+
+df = pd.DataFrame(
+    {
+        "id": [1, 2, 3],
+        "name": ["Alpha", "Bravo", "Charlie"],
+        "score": [42, 17, 99],
+    }
+)
+
+result = mm_table(df, selection="single", row_id_column="id", key="demo")
+
+if result and result.get("event") == "select":
+    st.write("You picked:", result["row_ids"])
+```
+
+## Theming
+
+Pass any subset of these tokens via `theme_tokens=`; missing keys fall back
+to neutral defaults:
+
+| Token            | Purpose                       |
+| ---------------- | ----------------------------- |
+| `bg`             | Table background              |
+| `bg_alt`         | Striped row background        |
+| `text`           | Body text colour              |
+| `text_muted`     | Empty-state and hints         |
+| `border`         | Outer border                  |
+| `border_subtle`  | Row dividers                  |
+| `header_bg`      | Header row background         |
+| `header_text`    | Header row text               |
+| `accent`         | Accent / selection ring       |
+| `selected_bg`    | Selected row background       |
+| `row_hover_bg`   | Hover background              |
+| `font`           | Body font stack               |
+| `font_mono`      | Header / mono font stack      |
+
+## Repo layout
+
+```
+mm_streamlit_table/          ← Python package
+  __init__.py                ← declare_component + public API
+  frontend/build/            ← built JS bundle (generated)
+frontend/                    ← React/TS source
+  src/
+  package.json
+  vite.config.ts
+```
+
+## Dev loop
+
+In one terminal:
+
+```bash
+cd frontend
+npm install
+npm run dev               # serves on http://localhost:3001
+```
+
+In another terminal, in your app:
+
+```bash
+pip install -e ../mm-streamlit-table
+export MM_STREAMLIT_TABLE_DEV=1   # or set MM_STREAMLIT_TABLE_DEV=1 on Windows
+streamlit run your_app.py
+```
+
+Edit a `.tsx` file → browser updates. No Streamlit restart needed.
+
+## Release build
+
+```bash
+cd frontend
+npm run build             # writes to ../mm_streamlit_table/frontend/build
+cd ..
+python -m build           # builds the wheel
+```
+
+## License
+
+MIT.

mm_streamlit_table-0.0.2/README.md

@@ -0,0 +1,114 @@
+# mm-streamlit-table
+
+An opinionated, themeable Streamlit table component built with React +
+[TanStack Table](https://tanstack.com/table). MIT-licensed and dependency-light.
+
+Why this exists: most Streamlit table components either rerun the entire page
+on every interaction (selection loops, lost filter state) or are styled in a
+way that resists customisation. `mm-streamlit-table` keeps UI state inside
+the component and only emits **semantic events** back to Streamlit.
+
+## Features
+
+- **No rerun loops.** Sort, filter, expand, and resize are local. Streamlit
+  only hears about events you care about (selection, action clicks).
+- **Themeable from Python** via a small set of generic design tokens that
+  map to CSS custom properties. Drop in your own tokens or override the
+  CSS variables directly.
+- **Real React renderers** — bring your own cell components (tags, JSON
+  chips, copy-to-clipboard, badges, anything you write in TSX).
+- **No enterprise license.** Filtering features that AG Grid puts behind a
+  paywall (multi-filter, set filter) are built in.
+
+## Install
+
+```bash
+pip install mm-streamlit-table
+```
+
+## Quick start
+
+```python
+import pandas as pd
+import streamlit as st
+from mm_streamlit_table import mm_table
+
+df = pd.DataFrame(
+    {
+        "id": [1, 2, 3],
+        "name": ["Alpha", "Bravo", "Charlie"],
+        "score": [42, 17, 99],
+    }
+)
+
+result = mm_table(df, selection="single", row_id_column="id", key="demo")
+
+if result and result.get("event") == "select":
+    st.write("You picked:", result["row_ids"])
+```
+
+## Theming
+
+Pass any subset of these tokens via `theme_tokens=`; missing keys fall back
+to neutral defaults:
+
+| Token            | Purpose                       |
+| ---------------- | ----------------------------- |
+| `bg`             | Table background              |
+| `bg_alt`         | Striped row background        |
+| `text`           | Body text colour              |
+| `text_muted`     | Empty-state and hints         |
+| `border`         | Outer border                  |
+| `border_subtle`  | Row dividers                  |
+| `header_bg`      | Header row background         |
+| `header_text`    | Header row text               |
+| `accent`         | Accent / selection ring       |
+| `selected_bg`    | Selected row background       |
+| `row_hover_bg`   | Hover background              |
+| `font`           | Body font stack               |
+| `font_mono`      | Header / mono font stack      |
+
+## Repo layout
+
+```
+mm_streamlit_table/          ← Python package
+  __init__.py                ← declare_component + public API
+  frontend/build/            ← built JS bundle (generated)
+frontend/                    ← React/TS source
+  src/
+  package.json
+  vite.config.ts
+```
+
+## Dev loop
+
+In one terminal:
+
+```bash
+cd frontend
+npm install
+npm run dev               # serves on http://localhost:3001
+```
+
+In another terminal, in your app:
+
+```bash
+pip install -e ../mm-streamlit-table
+export MM_STREAMLIT_TABLE_DEV=1   # or set MM_STREAMLIT_TABLE_DEV=1 on Windows
+streamlit run your_app.py
+```
+
+Edit a `.tsx` file → browser updates. No Streamlit restart needed.
+
+## Release build
+
+```bash
+cd frontend
+npm run build             # writes to ../mm_streamlit_table/frontend/build
+cd ..
+python -m build           # builds the wheel
+```
+
+## License
+
+MIT.

mm_streamlit_table-0.0.2/mm_streamlit_table/__init__.py

@@ -0,0 +1,144 @@
+"""mm-streamlit-table — public Python API.
+
+Two modes:
+  - Dev: set MM_STREAMLIT_TABLE_DEV=1 and run `npm run dev` in frontend/.
+         The component points at http://localhost:3001 and hot-reloads.
+  - Release: serves the built bundle from mm_streamlit_table/frontend/build/.
+"""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+from typing import Any, Iterable, Literal, Optional
+
+import pandas as pd
+import streamlit.components.v1 as components
+
+from .theme import ThemeTokens
+
+_DEV = os.environ.get("MM_STREAMLIT_TABLE_DEV", "").strip().lower() in {"1", "true", "yes", "on"}
+_DEV_URL = os.environ.get("MM_STREAMLIT_TABLE_DEV_URL", "http://localhost:3001")
+
+if _DEV:
+    _component_func = components.declare_component("mm_streamlit_table", url=_DEV_URL)
+else:
+    _build_dir = Path(__file__).parent / "frontend" / "build"
+    _component_func = components.declare_component("mm_streamlit_table", path=str(_build_dir))
+
+
+SelectionMode = Literal["none", "single", "multi"]
+ColumnType = Literal["text", "number", "date", "set", "multi"]
+
+
+def _infer_column_type(series: pd.Series) -> ColumnType:
+    """Map a pandas dtype to one of the component's filter column types.
+
+    Object columns default to "text" — set filters often produce huge value
+    lists on free-form text, so callers opt in with column_types overrides.
+    """
+    dtype = series.dtype
+    if pd.api.types.is_bool_dtype(dtype):
+        return "set"
+    if pd.api.types.is_numeric_dtype(dtype):
+        return "number"
+    if pd.api.types.is_datetime64_any_dtype(dtype):
+        return "date"
+    return "text"
+
+
+def mm_table(
+    df: pd.DataFrame,
+    *,
+    selection: SelectionMode = "none",
+    row_id_column: Optional[str] = None,
+    default_selected_ids: Optional[Iterable[Any]] = None,
+    column_types: Optional[dict[str, ColumnType]] = None,
+    cell_renderers: Optional[dict[str, str]] = None,
+    theme_tokens: Optional[ThemeTokens] = None,
+    height: int = 400,
+    show_quick_filter: bool = True,
+    quick_filter_placeholder: str = "Filter…",
+    key: Optional[str] = None,
+) -> Optional[dict[str, Any]]:
+    """Render a DataFrame as an interactive table.
+
+    Returns None on most reruns. Returns a dict only when the user produces a
+    semantic event (e.g. selection change):
+
+        {"event": "select", "row_ids": [...], "rows": [...]}
+
+    Args:
+        df: source data.
+        selection: "none", "single", or "multi".
+        row_id_column: column whose values identify rows. Defaults to the
+            DataFrame index.
+        cell_renderers: {column_name: renderer_id}. Built-in ids:
+            "tag_list", "json_object", "copy_link". (Wired in later steps.)
+        theme_tokens: design tokens applied as CSS variables. See README
+            for the supported keys; any subset works, missing keys fall back
+            to neutral defaults.
+        height: pixel height of the table viewport.
+        key: stable Streamlit key.
+    """
+    if df is None:
+        df = pd.DataFrame()
+
+    if row_id_column is not None and row_id_column not in df.columns:
+        raise ValueError(
+            f"row_id_column '{row_id_column}' not in columns: {list(df.columns)}"
+        )
+
+    rows = df.to_dict(orient="records")
+    if row_id_column is None:
+        row_ids: list[Any] = [_jsonable(i) for i in df.index.tolist()]
+    else:
+        row_ids = [_jsonable(r.get(row_id_column)) for r in rows]
+
+    overrides = column_types or {}
+    columns = []
+    for c in df.columns:
+        col_id = str(c)
+        col_type = overrides.get(col_id) or _infer_column_type(df[c])
+        columns.append(
+            {"id": col_id, "header": col_id.replace("_", " ").title(), "type": col_type}
+        )
+
+    return _component_func(
+        rows=[_jsonable_row(r) for r in rows],
+        row_ids=row_ids,
+        columns=columns,
+        selection=selection,
+        default_selected_ids=[_jsonable(x) for x in (default_selected_ids or [])],
+        cell_renderers=cell_renderers or {},
+        theme_tokens=theme_tokens or {},
+        height=int(height),
+        show_quick_filter=bool(show_quick_filter),
+        quick_filter_placeholder=str(quick_filter_placeholder),
+        key=key,
+        default=None,
+    )
+
+
+def _jsonable(v: Any) -> Any:
+    if v is None:
+        return None
+    try:
+        if pd.isna(v):
+            return None
+    except (TypeError, ValueError):
+        pass
+    if isinstance(v, (str, int, float, bool)):
+        return v
+    if isinstance(v, (list, tuple)):
+        return [_jsonable(x) for x in v]
+    if isinstance(v, dict):
+        return {str(k): _jsonable(val) for k, val in v.items()}
+    return str(v)
+
+
+def _jsonable_row(row: dict[str, Any]) -> dict[str, Any]:
+    return {str(k): _jsonable(v) for k, v in row.items()}
+
+
+__all__ = ["mm_table", "SelectionMode", "ColumnType", "ThemeTokens"]