chore: Implements grouped data support in table (WIP)

[pan-kot]

Description

The Table API was extended with new properties to support expandable tables with data grouping. The new API mirrors the collection result API of the collection hooks (see cloudscape-design/collection-hooks#130). Additionally, the new API includes:

• columnDefinitions[index].counter() - render function for column counters. It takes computed itemsCount and selectedItemsCount as arguments. It exists so that: 1) the decision to render counters is explicitly taken by consumers even when the counters are computed by collection hooks; 2) the counters format is controlled by consumers (recommended format is ({selected}/{total}); 3) custom counters can be rendered for the first or other columns that use shared styles.
• ariaLabels.itemSelectionLabel and ariaLabels.allItemsSelectionLabel now additionally take itemsCount and selectedItemsCount as arguments. It allows to include the counter info to the selection control ARIA labels.
• New ariaLabels.itemLoaderSelectionLabel and ariaLabels.allItemsLoaderSelectionLabel are introduced to determine the ARIA labels of selection checkboxes added to progressive loading rows (only possible for group selection).
• New renderLoaderCounter render function is introduced to define counters for progressive loading rows. It takes selected as argument instead of itemsCount/selectedItemsCount because: 1) progressive loading is not supported by collection hooks, so the respective items count is not computed; 2) partial selection is not possible, so selectedItemsCount can be either 0 or equal to itemsCount.

Doc: [Jzs6Ab9ewrbz]

Related PRs:

• feat: Adds support for table data grouping (2nd attempt, see: #126) collection-hooks#130
• chore: Implements track-by and selection-tree utils component-toolkit#186

How has this been tested?

• New unit tests to cover API additions (the selection logic itself is covered by the selection-tree unit tests in the toolkit)
• Manual testing on the new test page
• Bug bash
• Screenshot tests for the new page to capture row counters

Review checklist

The following items are to be evaluated by the author(s) and the reviewer(s).

Correctness

• Changes include appropriate documentation updates.
• Changes are backward-compatible if not indicated, see CONTRIBUTING.md.
• Changes do not include unsupported browser features, see CONTRIBUTING.md.
• Changes were manually tested for accessibility, see accessibility guidelines.

Security

• If the code handles URLs: all URLs are validated through the checkSafeUrl function.

Testing

• Changes are covered with new/existing unit tests?
• Changes are covered with new/existing integration tests?

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.18%. Comparing base (170fdf8) to head (6123151).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3673      +/-   ##
==========================================
+ Coverage   97.17%   97.18%   +0.01%     
==========================================
  Files         882      883       +1     
  Lines       25824    25924     +100     
  Branches     9332     9386      +54     
==========================================
+ Hits        25095    25195     +100     
+ Misses        723      682      -41     
- Partials        6       47      +41     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.