feat(core): Table tree expand-all header control (#4142)

[humbertovirtudes]

Summary

First step of the tree-plugin convergence tracked in #4142: fold useTableRowExpansion's header expand-all affordance into useTableTreeData / useTableTreeState.

useTableTreeState already owned expandAll / collapseAll but exposed no aggregate state and no header UI, so consumers had to hand-roll external buttons (see the old ExpandAndCollapseAll story). This adds the built-in control.

What changed

• useTableTreeState: returns a new isAllExpanded: boolean | 'indeterminate' (true when every expandable row is expanded, false when none are, 'indeterminate' when some are), and threads isAllExpanded + onExpandAll / onCollapseAll into treeConfig. Only expandable ids count toward the tally, so expanded ids matching a leaf or no row never skew it. Reports false for flat data.
• useTableTreeData: new hasExpandAllControl?: boolean prop. When set (and the data is hierarchical and the state supplies the aggregate + handlers), transformHeaderCell renders an expand-all/collapse-all toggle in the tree column header, reusing the row expander's chevron affordance. The toggle points down (aria-expanded=true) only when everything is expanded, matching the row expander; 'indeterminate' reads as collapsed. A treeKeyRef written in transformColumns (pipeline step 1) tells transformHeaderCell (step 4) which column is the tree column.
• i18n: two new catalog keys, @astryx.tableTree.expandAllRows / collapseAllRows.
• Flat data stays a full no-op: no control, no ARIA, identical render.

Config mapping (vs useTableRowExpansion)

useTableRowExpansion	this PR
isAllExpanded: boolean | 'indeterminate'	isAllExpanded (now computed by useTableTreeState)
onToggleExpandAll(expand)	onExpandAll / onCollapseAll
header toggle on the synthetic __expansion column	header toggle on the in-place tree column via transformHeaderCell

Test plan

TDD, RED verified before implementation:

• useTableTreeState.test.tsx: +7 tests (aggregate state true/false/indeterminate, flat-data false, leaf/ghost ids ignored, treeConfig wiring).
• useTableTreeData.test.tsx: +6 tests (control renders only when enabled + hierarchical, expand/collapse on click, relabel, indeterminate aria-expanded=false, flat-data no control).
• pnpm exec vitest run src/Table (full core Table suite): 447 pass / 0 fail.
• All three tree files: 69 pass.
• tsc --project packages/core/tsconfig.json --noEmit: clean.
• eslint on changed files: clean.
• check:changesets: valid (pre-1.0 patch).

Notes

• Draft: opening for review ahead of the follow-up PRs in Table tree: fold useTableRowExpansion affordances into useTableTreeData, then converge #4142 (whole-row-click, migration doc, deprecation).
• The existing external-button ExpandAndCollapseAll story is left intact; a new HeaderExpandAllControl story demonstrates the built-in control.

Docsite example

Adds TableTreeTable (a file-tree example wired to useTableTreeState with hasExpandAllControl) under packages/cli/templates/blocks/components/Table/, with exampleFor: 'useTableTreeState'. The docsite block registry picks it up automatically, so /components/useTableTreeState now renders a live example, matching the other Table plugin pages (that page previously had none).

This diff was generated with AI assistance (Navi). The implementation and tests were produced by an AI agent following test-driven development. The human author reviewed and approved the changes.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
astryx	Error		Jul 23, 2026 9:33am

[github-actions]

PR Analysis Report

Modified Components

Table

Metric	Before	After	Delta
Bundle Size (ESM)	N/A	N/A	N/A
Lines of Code	N/A	1913	-
Complexity	N/A	Very High (101)	-

Bundle Size Summary

Package	Size (ESM)	Size (CJS)	Gzipped
@astryxdesign/core	N/A	4.7KB	0B

Accessibility Audit

Status: 1 accessibility violation(s) found — 1 serious.

Table - 1 issue(s)

• 🟠 serious: Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds
  • Rule: color-contrast · Affects 4/24 stories · Learn more
  • WCAG: 1.4.3 (Level AA)

---

_{Generated by PR Enrichment workflow | View full report}