UI polish - duplicate expand/collapse

Author: mayagbarnes

README.md

@@ -571,7 +571,7 @@ uv pip install -e '.[with-streamlit]' --force-reinstall
 uv run streamlit run streamlit_app.py
 ```
 
-The example app (`streamlit_app.py`) contains 13 sections demonstrating every feature with interactive examples and inline documentation.
+The example app (`streamlit_app.py`) contains 13 sections covering the major features and usage patterns with interactive examples and inline documentation.
 
 ### Building the frontend
 

SKILL.md

@@ -66,8 +66,8 @@ Returns a `PivotTableResult` dict containing the current `config` state.
 | `columns` | `list[str] \| None` | `None` | Column names to use as column dimensions. |
 | `values` | `list[str] \| None` | `None` | Column names to aggregate as measures. |
 | `synthetic_measures` | `list[dict] \| None` | `None` | Derived measures computed from source-field sums (e.g., ratio of sums). See [Synthetic Measures](#synthetic-measures). |
-| `aggregation` | `str` | `"sum"` | Aggregation function. See [Aggregation Functions](#aggregation-functions). |
-| `interactive` | `bool` | `True` | Enable toolbar controls for reconfiguring the pivot. |
+| `aggregation` | `str \| dict[str, str]` | `"sum"` | Aggregation setting for raw value fields. A single string applies to every raw measure; a dict enables per-measure aggregation. See [Aggregation Functions](#aggregation-functions). |
+| `interactive` | `bool` | `True` | Enable end-user config controls. When `False`, the toolbar is hidden and header-menu sort/filter/show-values-as actions are disabled. |
 
 #### Totals and Subtotals
 
@@ -109,9 +109,9 @@ Returns a `PivotTableResult` dict containing the current `config` state.
 | Parameter | Type | Default | Description |
 |-----------|------|---------|-------------|
 | `on_cell_click` | `Callable[[], None] \| None` | `None` | Called when a user clicks a data cell. Read the payload from `st.session_state[key]`. See [Cell Click Payload](#cell-click-payload). |
-| `on_config_change` | `Callable[[], None] \| None` | `None` | Called when the user changes the pivot config via the toolbar. |
+| `on_config_change` | `Callable[[], None] \| None` | `None` | Called when the user changes the pivot config interactively, including toolbar and header-menu actions. |
 | `enable_drilldown` | `bool` | `True` | Show an inline drill-down panel with source records when a cell is clicked. |
-| `locked` | `bool` | `False` | Viewer mode with exploration enabled. Toolbar config controls are read-only, while data export, group expand/collapse, and header-menu sorting/filtering/show-values-as remain available. |
+| `locked` | `bool` | `False` | Viewer mode with exploration enabled. Toolbar config controls are read-only, viewer-safe actions like data export and group expand/collapse remain available, and header-menu sorting/filtering/`Show Values As` plus drill-down still work. |
 | `export_filename` | `str \| None` | `None` | Base filename (without extension) for exported files. Date and extension are appended automatically. Defaults to `"pivot-table"`. |
 
 #### Data Control
@@ -415,7 +415,7 @@ Hover over a parent column header to reveal the collapse toggle.
 
 ### Data Export
 
-Export the pivot table as CSV, TSV, or copy to clipboard. Available via the toolbar utility menu (download icon) when `interactive=True`.
+Export the pivot table as CSV, TSV, or copy to clipboard. Available via the toolbar utility menu (download icon) whenever the interactive toolbar is shown, including locked viewer mode.
 
 - **Format**: CSV, TSV, or Clipboard (tab-separated for pasting into spreadsheets)
 - **Content**: Formatted (display values with currency, percentages, etc.) or Raw (unformatted numbers)
@@ -445,7 +445,7 @@ result = st_pivot_table(
 
 ### Locked Mode
 
-Freeze toolbar config controls so end-users cannot change rows, columns, values, aggregation, or display settings. The entire utility menu (reset, swap, config import/export, data export, settings) is hidden. Sorting and filtering via header menus remain available.
+Use `locked=True` for a viewer-mode experience with exploration enabled. Toolbar config controls stay locked so end-users cannot change rows, columns, values, per-measure aggregation, or settings toggles. Reset, Swap, and config import/export are hidden, while data export remains available and the Settings gear stays visible for read-only display status plus Expand/Collapse All group controls. Header-menu sorting, filtering, and `Show Values As` remain available, and drill-down still works.
 
 ```python
 st_pivot_table(
@@ -471,7 +471,11 @@ When `interactive=True`, hovering over the top-right of the toolbar reveals util
 | **Export Data** | Open the export popover (CSV / TSV / Clipboard). Use `export_filename` to customize the download filename. |
 | **Settings** (gear icon) | Opens a popover with display toggles: Row Totals, Column Totals, Subtotals, Repeat Labels, Sticky Headers, and Expand/Collapse All group controls |
 
-In **locked mode**, Reset, Swap, and config import/export are hidden while data export remains available. The Settings gear remains visible, its popover shows read-only view status plus group expand/collapse actions, and sorting/filtering/show-values-as remain available via header menus.
+In **locked mode**, Reset, Swap, and config import/export are hidden. `Export Data` remains available as a viewer action. The Settings gear remains visible, its popover shows read-only display status plus group expand/collapse actions, and header-menu sorting, filtering, and `Show Values As` stay enabled.
+
+### Non-Interactive Mode
+
+Set `interactive=False` to render a read-only pivot view. This hides the toolbar and disables header-menu config actions (sorting, filtering, and `Show Values As`). Cell clicks and drill-down remain available.
 
 ---
 
@@ -520,7 +524,7 @@ For total cells, `rowKey` or `colKey` will be `["Total"]` and the corresponding
 
 ### Config State
 
-The returned `config` dict contains the full current configuration including any changes the user made via the toolbar. Use this to persist user customizations or synchronize multiple components.
+The returned `config` dict contains the current supported configuration state, including interactive changes such as rows, columns, values, aggregation, totals, sorting, filtering, and display options. Use this to persist user customizations or synchronize multiple components.
 
 ---
 

e2e_playwright/pivot_table_test.py

@@ -740,7 +740,7 @@ def test_subtotal_group_collapse(page_at_app: Page):
     rows_before = container.get_by_test_id("pivot-data-row").count()
 
     toggle = container.locator(
-        "button[data-testid^='pivot-group-toggle-']"
+        "[data-testid^='pivot-group-toggle-']"
         ":not([data-testid$='-expand-all'])"
         ":not([data-testid$='-collapse-all'])"
     ).first

streamlit_app.py

@@ -52,6 +52,7 @@
 **Try it:**
 - Use the **Rows / Columns / Values** dropdowns in the toolbar to add or remove fields.
 - Change the **Aggregation** (e.g. Sum → Average) in the toolbar.
+- Omit `rows`, `columns`, and `values` entirely to let the component auto-detect dimensions and measures.
 - Click any data cell — the cell coordinates will appear below the table.
 - Hover over the top-right of the toolbar to reveal the **utility menu**:
   - **Reset** (↺) — resets the config to the original Python-supplied values
@@ -96,8 +97,22 @@
         language="python",
     )
 
-if result_basic.get("cell_click"):
-    st.info(f"Last cell click: {result_basic['cell_click']}")
+basic_cell_click = st.session_state.get("basic", {}).get("cell_click")
+if basic_cell_click:
+    st.info(f"Last cell click: {basic_cell_click}")
+
+st.markdown("#### Auto-Detect Layout")
+st.markdown(
+    """
+If you omit `rows`, `columns`, and `values`, the component auto-detects dimensions
+and measures from the input data. This is useful for quick exploration when you
+want a sensible starting layout without pre-configuring the pivot.
+"""
+)
+st_pivot_table(
+    df,
+    key="basic_auto_detect",
+)
 
 
 # ---------------------------------------------------------------------------
@@ -156,10 +171,10 @@
 
 
 # ---------------------------------------------------------------------------
-# Section 3: Filtering and Locked Mode
+# Section 3: Filtering, Locked Mode, and Non-Interactive Mode
 # ---------------------------------------------------------------------------
 st.divider()
-st.subheader("3. Filtering and Locked Mode")
+st.subheader("3. Filtering, Locked Mode, and Non-Interactive Mode")
 
 st.markdown(
     """
@@ -169,20 +184,27 @@
 menus still work, **Show Values As** remains available on value headers, and
 export still stays available as a viewer action. **Custom sorters** enforce a specific dimension order.
 
+**Non-interactive mode** (`interactive=False`) is the true read-only mode:
+the toolbar is hidden, header-menu config actions are disabled, but cell clicks
+and drill-down still work.
+
 **Try it (left table):**
 - Click the **⋮** menu icon on the "Region" header → uncheck regions to filter them out.
 - Use the search box to find specific values quickly.
 
-**Right table** is **locked** — authoring actions like reset, swap, and config import/export
+**Middle table** is **locked** — authoring actions like reset, swap, and config import/export
 are hidden, but **Export Data** remains available, the **Settings** gear shows
-read-only view status, and you can still sort, filter, and change **Show Values As**
-from the header menus.
+read-only view status plus **Expand/Collapse All** group controls, and you can
+still sort, filter, and change **Show Values As** from the header menus.
 
-**API parameters used:** `hidden_from_aggregators`, `sorters`, `locked`
+**Right table** is **non-interactive** — there is no toolbar and no header-menu
+config UI, but cell clicks still work and drill-down remains enabled.
+
+**API parameters used:** `hidden_from_aggregators`, `sorters`, `locked`, `interactive`
 """
 )
 
-col_left, col_right = st.columns(2)
+col_left, col_middle, col_right = st.columns(3)
 
 with col_left:
     st.caption("Interactive (with custom sorters)")
@@ -196,16 +218,29 @@
         null_handling="zero",
     )
 
-with col_right:
+with col_middle:
     st.caption("Locked mode")
     st_pivot_table(
         df,
         key="locked",
-        rows=["Region"],
+        rows=["Region", "Category"],
         columns=["Year"],
-        values=["Revenue"],
+        values=["Revenue", "Profit"],
         locked=True,
         hidden_from_aggregators=["Year", "Region"],
+        show_subtotals=True,
+    )
+
+with col_right:
+    st.caption("Non-interactive mode")
+    result_noninteractive = st_pivot_table(
+        df,
+        key="noninteractive",
+        rows=["Region"],
+        columns=["Year"],
+        values=["Revenue"],
+        interactive=False,
+        on_cell_click=lambda: None,
     )
 
 with st.expander("View Code"):
@@ -226,16 +261,32 @@
 st_pivot_table(
     df,
     key="locked",
-    rows=["Region"],
+    rows=["Region", "Category"],
     columns=["Year"],
-    values=["Revenue"],
+    values=["Revenue", "Profit"],
     locked=True,
     hidden_from_aggregators=["Year", "Region"],
+    show_subtotals=True,
+)
+
+# Non-interactive — no toolbar or header-menu config actions
+st_pivot_table(
+    df,
+    key="noninteractive",
+    rows=["Region"],
+    columns=["Year"],
+    values=["Revenue"],
+    interactive=False,
+    on_cell_click=lambda: None,
 )
 """,
         language="python",
     )
 
+noninteractive_cell_click = st.session_state.get("noninteractive", {}).get("cell_click")
+if noninteractive_cell_click:
+    st.info(f"Non-interactive cell click: {noninteractive_cell_click}")
+
 
 # ---------------------------------------------------------------------------
 # Section 4: Subtotals and Grouping
@@ -778,6 +829,8 @@
 - Use ``export_filename`` to customize the downloaded file name. The date
   (``YYYY-MM-DD``) and file extension are appended automatically.
   Defaults to ``"pivot-table"`` (e.g. ``pivot-table_2026-03-09.csv``).
+- This demo sets `export_filename="sales-export-demo"` so you can see the custom
+  filename behavior in the downloaded file.
 """
 )
 
@@ -791,6 +844,7 @@
     number_format={"Revenue": "$,.0f", "Profit": "$,.0f"},
     show_totals=True,
     interactive=True,
+    export_filename="sales-export-demo",
 )
 
 with st.expander("View Code"):
@@ -804,6 +858,7 @@
     values=["Revenue", "Profit"],
     number_format={"Revenue": "$,.0f", "Profit": "$,.0f"},
     show_totals=True,
+    export_filename="sales-export-demo",
 )
 # Then use the Download icon in the toolbar utility menu.
 """,