feat(styling): init_sd as augmentation channel (nested merge + delete_keys + demo)

[paddymul]

Summary

Turns init_sd into a proper augmentation channel for per-column display config — one that plays nice with lowcode ops (Search → highlight) instead of clobbering them like column_config_overrides does. Two style_column changes + a delete-keys escape hatch + a working demo notebook.

Depends on

#744 (jlisp 2-tuple transform contract) and #745 (polars Search → highlight_regex via sd). The test test_init_sd_displayer_args_and_search_highlight_coexist_on_same_column references Search's contribution shape; the notebook demo relies on the styling layer reading highlight_* from merged_sd.

After #744 and #745 merge, this PR will rebase and the duplicate commits drop via patch-id.

Pieces

1. feat(styling): merge column_metadata displayer_args + ag_grid_specs — two shallow merges in DefaultMainStyling.style_column. When column_metadata carries displayer_args (e.g. {'max_length': 5000}) or ag_grid_specs (e.g. {'wrapText': True, 'width': 400}), they merge into the styled bag instead of replacing. Caller wins per-key. Critically, this lets a Search op's highlight_regex and a user's max_length coexist on the same column — column_config_overrides's replace semantics would have clobbered the highlight.

2. feat(styling): init_sd delete_keys — column_metadata.delete_keys: list[str] pops the named top-level keys from the final base_config. Motivating case: drop the auto-attached tooltip_config on a string column the user doesn't want a permanent tooltip on, without subclassing the styling analysis. Operates on top-level only (tooltip_config, ag_grid_specs, displayer_args, col_name) — nested removal isn't needed for the motivating case.

3. Restaurant-Complaints demo notebook — working example combining init_sd (nested displayer_args + ag_grid_specs + delete_keys) with extra_grid_config (rowHeight, pinnedRowHeight) and a viol_status == 'Fail' filter on the polars Enum.

Usage

init_sd = {
    'comments': {
        'displayer_args': {'displayer': 'string', 'max_length': 5000},
        'ag_grid_specs': {'wrapText': True, 'width': 400, 'maxWidth': 800},
        'delete_keys': ['tooltip_config'],
    },
}
PolarsBuckarooInfiniteWidget(df, init_sd=init_sd, ...)

This shape is intentionally the same as column_config_overrides would take — but init_sd augments via merge_sds (each key wins per-call), while column_config_overrides replaces via shallow row.update().

Test plan

• pytest tests/unit/dataflow/ — 118 pass
• pnpm test + pnpm run build:tsc — 212 pass, TS clean
• Manual: Restaurant-Complaints.ipynb renders without tooltip on comments column, wraps long text, max_length: 5000 honored
• CI green (after feat(jlisp): transform may return (df, sd_updates) tuple #744 + feat(polars-search): plumb search term to JS as highlight_regex #745 merge + rebase)

[github-actions]

📦 TestPyPI package published

pip install --index-strategy unsafe-best-match --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ buckaroo==0.13.5.dev25992032577

or with uv:

uv pip install --index-strategy unsafe-best-match --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ buckaroo==0.13.5.dev25992032577

MCP server for Claude Code

claude mcp add buckaroo-table -- uvx --from "buckaroo[mcp]==0.13.5.dev25992032577" --index-strategy unsafe-best-match --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ buckaroo-table

📖 Docs preview

🎨 Storybook preview

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1721611fcf

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[paddymul]

Resume note (2026-05-17): what's left to salvage from this branch after #758 lands.

Main + #758 already cover the first 4 commits here (older parallel impl of the SDResult/highlight plumbing — d9983945, 48458e4a, e7e25d03, cddbf99d are superseded by #755's SDResult class on main plus #758's de38f9c3 + f57289f4). #749 is unrelated (widget remount work).

Net-new content worth keeping:

1. 39ca7046 feat(styling): merge column_metadata displayer_args + ag_grid_specs — style_column shallow-merges column_metadata['displayer_args'] into computed disp, and column_metadata['ag_grid_specs'] over {minWidth}. Caller wins per-key. Makes init_sd an augmentation channel rather than a replacement.
2. 31ac848e feat(styling): init_sd delete_keys — top-level list on column_metadata; each listed key (e.g. tooltip_config) popped from base_config after merge. Lets init_sd drop styling-added defaults.
3. ffa6e088 + b4b17c3a docs: Restaurant-Complaints.ipynb — working demo of init_sd with displayer_args + ag_grid_specs + delete_keys (and Polars Enum case fix 'fail' → 'Fail').
4. Tests for (1) and (2) in autocleaning_pl_test.py: test_style_column_merges_nested_displayer_args_and_ag_grid_specs, test_init_sd_displayer_args_and_search_highlight_coexist_on_same_column.
5. 7e84cbf5 is formatting-only.

Plan for resumption: after #758 merges, rebase this branch and drop the four superseded commits — only the styling.py augmentation features + their tests + the demo notebook should remain.