Feat: expand column config cell renderer support

Author: mayagbarnes

README.md

@@ -89,7 +89,7 @@ Returns a `PivotTableResult` dict containing the current `config` state and opti
 | `column_alignment` | `dict[str, str] \| None` | `None` | Per-field text alignment: `"left"`, `"center"`, or `"right"`. |
 | `show_values_as` | `dict[str, str] \| None` | `None` | Per-field display mode. See [Show Values As](#show-values-as). |
 | `conditional_formatting` | `list[dict] \| None` | `None` | Visual formatting rules. See [Conditional Formatting](#conditional-formatting). |
-| `column_config` | `dict[str, Any] \| None` | `None` | Optional per-column display configuration, using a subset of the Streamlit [`column_config`](https://docs.streamlit.io/develop/api-reference/data/st.column_config) shape. Supported keys: `format`, `type`, `label`, `help`, `width` (`"small"` / `"medium"` / `"large"` / integer px), `pinned` (locks the field in the config UI; does not create a sticky column), and `alignment` (`"left"` / `"center"` / `"right"`, unions with the `column_alignment` kwarg; explicit kwarg wins). Explicit `number_format` / `dimension_format` / `column_alignment` parameters always win. See [Formats from `Styler` and `column_config`](#formats-from-styler-and-column_config). |
+| `column_config` | `dict[str, Any] \| None` | `None` | Optional per-column display configuration, using a subset of the Streamlit [`column_config`](https://docs.streamlit.io/develop/api-reference/data/st.column_config) shape. Supported keys: `format`, `type`, `label`, `help`, `width` (`"small"` / `"medium"` / `"large"` / integer px), `pinned` (locks the field in the config UI; does not create a sticky column), `alignment` (`"left"` / `"center"` / `"right"`, unions with the `column_alignment` kwarg; explicit kwarg wins), and row-dim cell renderers via `type`: `"link"` (with optional `display_text`), `"image"`, `"checkbox"`, and `"text"` with `max_chars`. Explicit `number_format` / `dimension_format` / `column_alignment` parameters always win. See [Formats from `Styler` and `column_config`](#formats-from-styler-and-column_config). |
 | `empty_cell_value` | `str` | `"-"` | Display string for cells with no data. |
 
 #### Layout
@@ -489,6 +489,11 @@ st_pivot_table(
 - `width` — either a preset (`"small"`=100px, `"medium"`=120px, `"large"`=200px) or an integer pixel value in the range `[20, 2000]`. Applies to row-dimension columns and measure columns (for the `col-single` header in single-value mode, and per-measure value-label cells in multi-value mode). Out-of-range / unparseable widths warn once per field and are skipped. **Interactive resize drags override the configured width at runtime but are not persisted to config**, so the width returns to the configured value after rerun/remount.
 - `pinned` — when `True` or `"left"`, locks the field in the **config UI** (equivalent to adding it to `frozen_columns`): the field cannot be removed from its zone or reordered via drag-and-drop. This does **not** create a visually sticky column. `"right"` is currently warned and ignored.
 - `alignment` — one of `"left"`, `"center"`, `"right"`. Unions with the `column_alignment` kwarg; when both set a value for the same field, the explicit `column_alignment` kwarg wins. Invalid values warn once per field and are skipped (unlike the `column_alignment` kwarg, which still raises on invalid values).
+- `type` — in addition to the date/time / number role it plays for `format` resolution, a small set of `type` values produce **dimension cell renderers** that apply only to row-dimension cells. Measure cells are always numeric aggregates and ignore these types. On Total / Subtotal rows, `link`, `image`, and `checkbox` fall back to plain text because the cell value is a label rather than data; `text` with `max_chars` still truncates:
+  - `"link"` — renders the row-dim value as an anchor (`href = <raw value>`). Accepts a `display_text` option (plain string, or a template containing `{}` which is substituted with the cell value, mirroring Streamlit's `LinkColumn` convention). Empty / null values, and values whose scheme isn't on the allowlist (`http:`, `https:`, `mailto:`, `tel:`, plus schemeless relative / protocol-relative URLs), fall back to plain text — hostile `javascript:` / `data:` / `file:` values never reach the DOM.
+  - `"image"` — renders the row-dim value as an `<img>` (`src = <raw value>`) with `loading="lazy"` and a `max-height` guard so images don't blow out row height. Works in both `row_layout="table"` and `row_layout="hierarchy"` (the hierarchy breadcrumb applies a tighter 1em cap). Only `http:` / `https:` / schemeless URLs and `data:image/<raster-mime>` (png, jpeg, gif, webp, avif, bmp, ico) pass through; everything else — including `data:image/svg+xml` and non-image `data:` MIME types — falls back to plain text.
+  - `"checkbox"` — renders truthy row-dim values as ☑ and falsy values as ☐. Accepts booleans (`True` / `False`), strings (`"true"` / `"false"` / `"yes"` / `"no"` / `"1"` / `"0"`, case-insensitive), and the numbers `0` / `1`. Unrecognized values fall back to plain text.
+  - `"text"` with `max_chars` — truncates row-dim cell text to `max_chars` UTF-16 code units (matches JavaScript's native `String.length` / `slice`, which is also what Streamlit's `TextColumn(max_chars=...)` uses) with a trailing ellipsis. The full text is preserved in the cell's `title` attribute for hover inspection. Truncation applies on every row, including Total / Subtotal rows. Invalid `max_chars` values (non-positive, non-integer, or booleans) warn once per field and are skipped.
 
 Unknown keys in dict literals warn once per `(field, key)` pair. Streamlit's internal defaults from typed `st.column_config.*` objects (`disabled`, `required`, `default`) are silently ignored. Recognized but unsupported column types (e.g. `line_chart`, `selectbox`) warn once per `(field, type)`.
 
@@ -508,6 +513,24 @@ st_pivot_table(
 )
 ```
 
+```python
+st_pivot_table(
+    df,
+    key="column_config_renderers_example",
+    rows=["Homepage", "Poster", "Active", "Description"],
+    values=["Revenue"],
+    column_config={
+        "Homepage": st.column_config.LinkColumn(
+            "Homepage",
+            display_text="Visit {}",
+        ),
+        "Poster": st.column_config.ImageColumn("Poster"),
+        "Active": st.column_config.CheckboxColumn("Active"),
+        "Description": st.column_config.TextColumn("Description", max_chars=40),
+    },
+)
+```
+
 **Precedence.** For format fields: `explicit number_format / dimension_format` > `column_config` > `Styler`. For alignment: `explicit column_alignment` > `column_config.alignment` > default (right-aligned measures, left-aligned dimensions). The lower-priority sources only fill gaps — any field already present in an explicit format or alignment dict keeps the caller-supplied value. `label`, `help`, and `width` are `column_config`-driven only (no legacy kwargs). `pinned` **unions** with `frozen_columns` / `hidden_from_drag_drop`.
 
 ### Conditional Formatting

SKILL.md

@@ -201,7 +201,7 @@ Creates a pivot table component. All parameters except `data` are keyword-only.
 | `column_alignment` | `dict[str, str] \| None` | `None` | `"left"` / `"center"` / `"right"`. |
 | `show_values_as` | `dict[str, str] \| None` | `None` | Per-field display mode. See [Show Values As](#show-values-as). |
 | `conditional_formatting` | `list[dict] \| None` | `None` | Color scales, data bars, thresholds. |
-| `column_config` | `dict[str, Any] \| None` | `None` | Streamlit-style per-column display config. Keys: `format`, `type`, `label`, `help`, `width` (`"small"`/`"medium"`/`"large"`/int px ∈ [20, 2000]), `pinned` (config-UI lock only, not sticky), `alignment` (`"left"`/`"center"`/`"right"`; unions with `column_alignment` kwarg, explicit kwarg wins). Both dict literals and `st.column_config.*` objects are accepted. |
+| `column_config` | `dict[str, Any] \| None` | `None` | Streamlit-style per-column display config. Keys: `format`, `type`, `label`, `help`, `width` (`"small"`/`"medium"`/`"large"`/int px ∈ [20, 2000]), `pinned` (config-UI lock only, not sticky), `alignment` (`"left"`/`"center"`/`"right"`; unions with `column_alignment` kwarg, explicit kwarg wins). Row-dim cell renderers via `type`: `"link"` (+ optional `display_text`), `"image"`, `"checkbox"`, `"text"` with `max_chars`. Both dict literals and `st.column_config.*` objects are accepted. |
 | `empty_cell_value` | `str` | `"-"` | String for empty cells. |
 
 #### Layout
@@ -401,6 +401,28 @@ st_pivot_table(
 - `alignment` accepts `"left"`, `"center"`, or `"right"`. It **unions** with the `column_alignment` kwarg; if both set a value for the same field, the explicit `column_alignment` kwarg wins. Invalid values warn once per field and are skipped (unlike the `column_alignment` kwarg, which still raises on invalid input).
 - Unknown keys in dict literals warn once per `(field, key)`; internal defaults on `st.column_config.*` objects (`disabled`, `required`, `default`) are silently ignored; recognized-but-unsupported column types (e.g. `line_chart`, `selectbox`) warn once per `(field, type)`.
 
+**Row-dim cell renderers (Tier 2).** A small set of `type` values change how row-dim cell values render. These apply only to row-dim cells; measure cells are numeric aggregates and ignore them. On Total / Subtotal rows, `link` / `image` / `checkbox` fall back to plain text (cell value is a label, not data); `text` with `max_chars` still truncates.
+
+```python
+st_pivot_table(
+    df,
+    key="column_config_renderers",
+    rows=["Homepage", "Poster", "Active", "Description"],
+    values=["Revenue"],
+    column_config={
+        "Homepage":    st.column_config.LinkColumn("Homepage", display_text="Visit {}"),
+        "Poster":      st.column_config.ImageColumn("Poster"),
+        "Active":      st.column_config.CheckboxColumn("Active"),
+        "Description": st.column_config.TextColumn("Description", max_chars=40),
+    },
+)
+```
+
+- `type="link"` — `href = <raw value>`. `display_text` can be a plain string or a `{}` template (substituted with the cell value, matching Streamlit's `LinkColumn`). Empty / null values fall back to plain text. **Scheme allowlist:** only `http:`, `https:`, `mailto:`, `tel:`, and schemeless (relative / protocol-relative) URLs render as anchors; `javascript:`, `data:`, `file:`, `vbscript:`, etc. fall back to plain text.
+- `type="image"` — `src = <raw value>`. Uses `loading="lazy"` and a `max-height` guard so images don't blow out row height. In `row_layout="hierarchy"`, the breadcrumb variant applies a tighter 1em cap. **Src allowlist:** `http:` / `https:` / schemeless URLs plus raster `data:image/<mime>` (png, jpeg, gif, webp, avif, bmp, ico); everything else — notably `data:image/svg+xml` and non-image `data:` — falls back to plain text.
+- `type="checkbox"` — truthy → ☑, falsy → ☐. Accepts booleans, `"true"/"false"/"yes"/"no"/"1"/"0"` (case-insensitive), and the numbers `0` / `1`. Unrecognized values fall back to plain text.
+- `type="text"` + `max_chars` — truncates to `max_chars` UTF-16 code units (matches JS `String.length` / Streamlit's `TextColumn`) with an ellipsis; full text is preserved in the cell's `title` attribute. Truncation applies on every row, including Totals. Invalid `max_chars` (non-positive, non-integer, bool) warns once and is skipped.
+
 ### Conditional Formatting
 
 ```python

e2e_playwright/e2e_utils.py

@@ -156,6 +156,11 @@
     "test_pivot_cc_width_px",
     "test_pivot_cc_width_preset",
     "test_pivot_cc_pinned",
+    "test_pivot_cc_link",
+    "test_pivot_cc_image",
+    "test_pivot_cc_checkbox",
+    "test_pivot_cc_text_max",
+    "test_pivot_cc_renderer_totals",
 ]
 
 APP_CONFIGS = {

e2e_playwright/pivot_table_column_config_app.py

@@ -17,13 +17,47 @@
 
 from __future__ import annotations
 
+import pandas as pd  # type: ignore[import-untyped]
 import streamlit as st
 
 from streamlit_pivot import st_pivot_table
 
 from pivot_table_app_support import init_page, load_data, noop
 
 
+def _renderer_fixture() -> pd.DataFrame:
+    """Small fixture exercising Tier 2 cell renderers.
+
+    Each row has a URL-like, image-like, boolean, and long-text dim value,
+    plus a numeric measure so measure cells render through the normal path.
+    """
+    return pd.DataFrame(
+        {
+            "Region": ["North", "North", "South", "South"],
+            "Website": [
+                "https://example.com/n1",
+                "https://example.com/n2",
+                "https://example.com/s1",
+                "https://example.com/s2",
+            ],
+            "Logo": [
+                "https://placehold.co/40x40?text=N1",
+                "https://placehold.co/40x40?text=N2",
+                "https://placehold.co/40x40?text=S1",
+                "https://placehold.co/40x40?text=S2",
+            ],
+            "Active": [True, False, True, False],
+            "Note": [
+                "This is a long note that should be truncated with ellipsis.",
+                "Another long piece of text that exceeds the configured max.",
+                "Short",
+                "Medium length note here.",
+            ],
+            "Revenue": [100.0, 150.0, 200.0, 250.0],
+        }
+    )
+
+
 def render_app(data):
     df = data["df"]
 
@@ -109,6 +143,90 @@ def render_app(data):
         on_config_change=noop,
     )
 
+    # ------------------------------------------------------------------
+    # Tier 2 cell renderers (LinkColumn / ImageColumn / CheckboxColumn /
+    # TextColumn.max_chars). Each pivot uses a dedicated fixture so the
+    # dim field being exercised is a first-class row dimension.
+    # ------------------------------------------------------------------
+    renderer_df = _renderer_fixture()
+
+    st.subheader("column_config.type=link")
+    st_pivot_table(
+        renderer_df,
+        key="test_pivot_cc_link",
+        rows=["Website"],
+        columns=[],
+        values=["Revenue"],
+        aggregation="sum",
+        column_config={
+            "Website": {"type": "link", "display_text": "Visit {}"},
+        },
+        interactive=True,
+        on_config_change=noop,
+    )
+
+    st.subheader("column_config.type=image")
+    st_pivot_table(
+        renderer_df,
+        key="test_pivot_cc_image",
+        rows=["Logo"],
+        columns=[],
+        values=["Revenue"],
+        aggregation="sum",
+        column_config={
+            "Logo": {"type": "image"},
+        },
+        interactive=True,
+        on_config_change=noop,
+    )
+
+    st.subheader("column_config.type=checkbox")
+    st_pivot_table(
+        renderer_df,
+        key="test_pivot_cc_checkbox",
+        rows=["Active"],
+        columns=[],
+        values=["Revenue"],
+        aggregation="sum",
+        column_config={
+            "Active": {"type": "checkbox"},
+        },
+        interactive=True,
+        on_config_change=noop,
+    )
+
+    st.subheader("column_config.type=text max_chars")
+    st_pivot_table(
+        renderer_df,
+        key="test_pivot_cc_text_max",
+        rows=["Note"],
+        columns=[],
+        values=["Revenue"],
+        aggregation="sum",
+        column_config={
+            "Note": {"type": "text", "max_chars": 12},
+        },
+        interactive=True,
+        on_config_change=noop,
+    )
+
+    st.subheader("column_config renderers + Subtotal/Total safety")
+    st_pivot_table(
+        renderer_df,
+        key="test_pivot_cc_renderer_totals",
+        rows=["Region", "Website"],
+        columns=[],
+        values=["Revenue"],
+        aggregation="sum",
+        show_subtotals=True,
+        show_totals=True,
+        column_config={
+            "Website": {"type": "link", "display_text": "Open"},
+        },
+        interactive=True,
+        on_config_change=noop,
+    )
+
 
 def main():
     init_page()

e2e_playwright/pivot_table_column_config_test.py

@@ -99,3 +99,95 @@ def test_column_config_pinned_locks_in_config_ui(page_at_app: Page):
     expect(chip).to_be_visible(timeout=5000)
     remove_btn = container.get_by_test_id("toolbar-rows-remove-Region")
     expect(remove_btn).to_have_count(0)
+
+
+# ---------------------------------------------------------------------------
+# Tier 2 cell renderers: LinkColumn / ImageColumn / CheckboxColumn /
+# TextColumn.max_chars.
+# ---------------------------------------------------------------------------
+
+
+def test_column_config_link_renderer(page_at_app: Page):
+    """column_config={"type": "link"} renders row-dim values as <a> tags
+    with href=<raw value> and text substituted from display_text='Visit {}'."""
+    page = page_at_app
+    container = get_pivot(page, "test_pivot_cc_link")
+    expect(container.get_by_test_id("pivot-table")).to_be_visible(timeout=15000)
+
+    anchors = container.get_by_test_id("pivot-link-cell")
+    expect(anchors.first).to_be_visible(timeout=10000)
+    # One anchor per distinct Website value in the fixture.
+    expect(anchors).to_have_count(4)
+    first = anchors.first
+    expect(first).to_have_attribute("target", "_blank")
+    expect(first).to_contain_text("Visit https://example.com/")
+
+
+def test_column_config_image_renderer(page_at_app: Page):
+    """column_config={"type": "image"} renders row-dim values as <img> tags."""
+    page = page_at_app
+    container = get_pivot(page, "test_pivot_cc_image")
+    expect(container.get_by_test_id("pivot-table")).to_be_visible(timeout=15000)
+
+    imgs = container.get_by_test_id("pivot-image-cell")
+    expect(imgs.first).to_be_visible(timeout=10000)
+    expect(imgs).to_have_count(4)
+    expect(imgs.first).to_have_attribute("loading", "lazy")
+
+
+def test_column_config_checkbox_renderer(page_at_app: Page):
+    """column_config={"type": "checkbox"} renders boolean row-dim values as
+    ☑ / ☐ glyphs with data-checked attributes."""
+    page = page_at_app
+    container = get_pivot(page, "test_pivot_cc_checkbox")
+    expect(container.get_by_test_id("pivot-table")).to_be_visible(timeout=15000)
+
+    boxes = container.get_by_test_id("pivot-checkbox-cell")
+    expect(boxes.first).to_be_visible(timeout=10000)
+    # Two distinct boolean values (True / False) after aggregation.
+    expect(boxes).to_have_count(2)
+    checked = container.locator(
+        '[data-testid="pivot-checkbox-cell"][data-checked="true"]'
+    )
+    unchecked = container.locator(
+        '[data-testid="pivot-checkbox-cell"][data-checked="false"]'
+    )
+    expect(checked).to_have_count(1)
+    expect(unchecked).to_have_count(1)
+
+
+def test_column_config_text_max_chars(page_at_app: Page):
+    """column_config={"type": "text", "max_chars": N} truncates long dim-cell
+    values with an ellipsis; the full text remains available in the title attr."""
+    page = page_at_app
+    container = get_pivot(page, "test_pivot_cc_text_max")
+    expect(container.get_by_test_id("pivot-table")).to_be_visible(timeout=15000)
+
+    truncs = container.get_by_test_id("pivot-text-cell-truncated")
+    expect(truncs.first).to_be_visible(timeout=10000)
+    # Two rows have long values (>12 chars); one is "Short"; one is
+    # "Medium length note here." (24 chars, also long).
+    expect(truncs).to_have_count(3)
+    first = truncs.first
+    text = first.inner_text()
+    assert text.endswith("\u2026"), f"expected ellipsis suffix, got {text!r}"
+    assert len(text) <= 12, f"expected len<=12, got {len(text)} ({text!r})"
+    title = first.get_attribute("title") or ""
+    assert len(title) > 12, f"expected full text in title, got {title!r}"
+
+
+def test_column_config_link_renderer_subtotal_fallback(page_at_app: Page):
+    """Subtotal / Total rows render plain text (no anchor) even when the field
+    has a link renderer configured."""
+    page = page_at_app
+    container = get_pivot(page, "test_pivot_cc_renderer_totals")
+    expect(container.get_by_test_id("pivot-table")).to_be_visible(timeout=15000)
+
+    # Subtotal rows have class containing "subtotalHeaderCell"; no link in those.
+    subtotal_links = container.locator(
+        'tr:has([class*="subtotalHeaderCell"]) [data-testid="pivot-link-cell"]'
+    )
+    expect(subtotal_links).to_have_count(0)
+    # Data rows should still render anchors (one per distinct Website).
+    data_anchors = container.get_by_test_id("pivot-link-cell")
+    expect(data_anchors.first).to_be_visible(timeout=10000)