feat: add Table component

[rmartins90]

Related: https://github.com/Doist/frontend-issues/issues/1369
Comms: https://comms.todoist.com/69/ch/AsbcUEc1FA3JTc5Rm36GZ/t/CctatEVHf1VZPEj1FND6Q/

Short description

Adds a Reactist Table based on the Design team's specs.

Note from Frankie:

Pivoting from https://github.com/Doist/frontend-issues/issues/1369, this takes on a compositional API where consumers are responsible for rendering the table's internals. If you need a column header row, you'd include <TableHeader>. That also means you can freely use any modelling layer, including TanStack.

To review in Storybook:

1. Run npm run storybook.
2. Open Data display / Table / Default and inspect whether the implementation matches the design specs, including tabular number spacing in the "Projects" column
3. Open Selected and clickable rows, then activate rows with pointer, Enter, and Space.
4. Open TanStack Table integration and test out sorting and pagination

PR Checklist

• Added tests for bugs / new features
• Updated docs (storybooks, readme)
• Reviewed and approved Chromatic visual regression tests in CI

[doistbot]

Adds a compositional, native-HTML Table component with primitives for header, body, rows, and cells, plus sort-indicator support and TanStack integration stories.

I also included a few optional follow-up notes in the details below.

Optional follow-up notes (4)

• src/table/table.module.css:3: Route these Product Library values through --reactist-table-* variables declared in this file's :root, then consume those component variables throughout. The Table currently has no Reactist-specific token surface, so consumers cannot override its defaults independently and the styles bypass the repository token convention.
• src/table/table.stories.tsx:157: Default and NarrowViewport render byte-identical four-column people tables, and SelectedAndClickableRows repeats the same markup with only the row aria-selected/tabIndex/handlers added. Extract one renderPeopleTable() helper (or a PeopleTable component) and reuse it across all three to cut ~120 duplicated lines without changing what each story demonstrates.
• src/table/table.stories.tsx:442: The sortable and non-sortable branches of this ternary duplicate the <TableColumnHeader> wrapper and its <Text>/flexRender children. Hoist the rendered header content into a variable (const content = <Text variant="body-2">{flexRender(...)}</Text>) and only vary the sortable props between branches.
• src/table/table.test.tsx:76: This test verifies that TableCell is transparent by checking CSS class names on the child Text component (variant-callout-2, lineClamp-1). Those classes belong to Text, not TableCell — if Text changes its CSS module naming, this table test breaks for no table-related reason. The parentElement?.tagName assertion alone already proves the TD wrapping. Drop the className assertions on the child, or replace them with a simpler child (e.g. a plain <span data-testid="child">) and assert it renders directly inside the td.

_{Share Feedback • Review Logs}

[doist-release-bot]

🎉 This PR is included in version 37.1.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀