@gntik-ai/blocks 0.9.0 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (162) hide show
  1. package/dist/index.d.ts +426 -55
  2. package/dist/index.js +2275 -639
  3. package/dist/index.js.map +1 -1
  4. package/package.json +6 -6
  5. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.labels.test.tsx +179 -0
  6. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.tsx +59 -24
  7. package/src/auth/ForgotPasswordForm/block.meta.ts +22 -1
  8. package/src/auth/ForgotPasswordForm/examples/Labels.tsx +29 -0
  9. package/src/auth/MfaChallenge/MfaChallenge.labels.test.tsx +139 -0
  10. package/src/auth/MfaChallenge/MfaChallenge.tsx +69 -23
  11. package/src/auth/MfaChallenge/block.meta.ts +29 -1
  12. package/src/auth/MfaChallenge/examples/Labels.tsx +28 -0
  13. package/src/auth/ResetPasswordForm/ResetPasswordForm.labels.test.tsx +104 -0
  14. package/src/auth/ResetPasswordForm/ResetPasswordForm.tsx +42 -15
  15. package/src/auth/ResetPasswordForm/block.meta.ts +17 -1
  16. package/src/auth/ResetPasswordForm/examples/Labels.tsx +28 -0
  17. package/src/auth/SignInForm/SignInForm.labels.test.tsx +137 -0
  18. package/src/auth/SignInForm/SignInForm.tsx +43 -16
  19. package/src/auth/SignInForm/block.meta.ts +22 -1
  20. package/src/auth/SignInForm/examples/Labels.tsx +29 -0
  21. package/src/auth/SignUpForm/SignUpForm.labels.test.tsx +217 -0
  22. package/src/auth/SignUpForm/SignUpForm.tsx +65 -26
  23. package/src/auth/SignUpForm/block.meta.ts +27 -1
  24. package/src/auth/SignUpForm/examples/Labels.tsx +29 -0
  25. package/src/auth/SsoButtons/SsoButtons.labels.test.tsx +30 -0
  26. package/src/auth/SsoButtons/SsoButtons.tsx +10 -2
  27. package/src/auth/SsoButtons/block.meta.ts +8 -1
  28. package/src/auth/SsoButtons/examples/Labels.tsx +24 -0
  29. package/src/auth/shared.i18n.test.tsx +71 -0
  30. package/src/auth/shared.tsx +48 -11
  31. package/src/billing/CostBreakdown/CostBreakdown.test.tsx +10 -0
  32. package/src/billing/CostBreakdown/CostBreakdown.tsx +50 -43
  33. package/src/billing/SpendVsBudget/SpendVsBudget.test.tsx +10 -0
  34. package/src/billing/SpendVsBudget/SpendVsBudget.tsx +35 -31
  35. package/src/builders/FlowBuilder/FlowBuilder.test.tsx +237 -2
  36. package/src/builders/FlowBuilder/FlowBuilder.tsx +101 -29
  37. package/src/builders/FlowBuilder/block.meta.ts +1 -1
  38. package/src/builders/FlowBuilder/connections.ts +30 -12
  39. package/src/builders/FlowBuilder/examples/ControlledGraph.tsx +8 -0
  40. package/src/builders/FlowBuilder/graph-state.ts +78 -0
  41. package/src/builders/LogViewer/LogViewer.labels.test.tsx +90 -0
  42. package/src/builders/LogViewer/LogViewer.levels.test.tsx +49 -0
  43. package/src/builders/LogViewer/LogViewer.tsx +72 -18
  44. package/src/builders/LogViewer/LogViewer.wrap.test.tsx +181 -0
  45. package/src/builders/LogViewer/block.meta.ts +19 -1
  46. package/src/builders/LogViewer/examples/Spanish.tsx +30 -0
  47. package/src/builders/LogViewer/examples/Wrap.tsx +62 -0
  48. package/src/builders/LogViewer/use-wrapped-log-rows.ts +42 -0
  49. package/src/data-display/ChartCard/ChartCard.locale.test.tsx +15 -0
  50. package/src/data-display/ChartCard/ChartCard.test.tsx +9 -0
  51. package/src/data-display/ChartCard/ChartCard.tsx +81 -67
  52. package/src/data-display/ChartCard/block.meta.ts +1 -1
  53. package/src/data-display/DescriptionListCard/DescriptionListCard.labels.test.tsx +73 -0
  54. package/src/data-display/DescriptionListCard/DescriptionListCard.options.test.tsx +64 -0
  55. package/src/data-display/DescriptionListCard/DescriptionListCard.tsx +74 -23
  56. package/src/data-display/DescriptionListCard/block.meta.ts +11 -1
  57. package/src/data-display/DescriptionListCard/examples/Spanish.tsx +29 -0
  58. package/src/feedback/EmptyStates/EmptyStates.labels.test.tsx +185 -0
  59. package/src/feedback/EmptyStates/EmptyStates.tsx +101 -30
  60. package/src/feedback/EmptyStates/NoAccessEmpty.options.test.tsx +38 -0
  61. package/src/feedback/EmptyStates/block.meta.ts +73 -1
  62. package/src/feedback/EmptyStates/examples/Spanish.tsx +48 -0
  63. package/src/feedback/ErrorPanel/ErrorPanel.labels.test.tsx +99 -0
  64. package/src/feedback/ErrorPanel/ErrorPanel.tsx +38 -9
  65. package/src/feedback/ErrorPanel/block.meta.ts +19 -1
  66. package/src/feedback/ErrorPanel/examples/Spanish.tsx +30 -0
  67. package/src/feedback/InlineCallout/InlineCallout.labels.test.tsx +62 -0
  68. package/src/feedback/InlineCallout/InlineCallout.tsx +22 -9
  69. package/src/feedback/InlineCallout/block.meta.ts +9 -1
  70. package/src/feedback/InlineCallout/examples/Spanish.tsx +19 -0
  71. package/src/feedback/Skeletons/Skeletons.labels.test.tsx +24 -0
  72. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.labels.test.tsx +115 -0
  73. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.tsx +63 -21
  74. package/src/forms/CreateApiKeyDialog/block.meta.ts +22 -1
  75. package/src/forms/CreateApiKeyDialog/examples/Labels.tsx +29 -0
  76. package/src/forms/CredentialDisclosureDialog/CredentialDisclosureDialog.labels.test.tsx +165 -0
  77. package/src/forms/CredentialDisclosureDialog/CredentialDisclosureDialog.tsx +31 -8
  78. package/src/forms/CredentialDisclosureDialog/SecretCopy.tsx +16 -8
  79. package/src/forms/CredentialDisclosureDialog/block.meta.ts +19 -1
  80. package/src/forms/CredentialDisclosureDialog/examples/Labels.tsx +38 -0
  81. package/src/forms/DangerZone/ConfirmDestructiveDialog.tsx +17 -3
  82. package/src/forms/DangerZone/DangerZone.labels.test.tsx +87 -0
  83. package/src/forms/DangerZone/DangerZone.tsx +20 -5
  84. package/src/forms/DangerZone/block.meta.ts +10 -1
  85. package/src/forms/DangerZone/examples/Labels.tsx +29 -0
  86. package/src/forms/DateRangeFilter/DateRangeFilter.labels.test.tsx +52 -0
  87. package/src/forms/DateRangeFilter/DateRangeFilter.tsx +11 -3
  88. package/src/forms/DateRangeFilter/block.meta.ts +8 -1
  89. package/src/forms/DateRangeFilter/examples/Labels.tsx +28 -0
  90. package/src/forms/DialogWizard/DialogWizard.labels.test.tsx +37 -0
  91. package/src/forms/DialogWizard/DialogWizard.tsx +13 -2
  92. package/src/forms/DialogWizard/block.meta.ts +7 -1
  93. package/src/forms/DialogWizard/examples/Labels.tsx +39 -0
  94. package/src/forms/FileUploadPanel/FileUploadPanel.labels.test.tsx +126 -0
  95. package/src/forms/FileUploadPanel/FileUploadPanel.test.tsx +22 -1
  96. package/src/forms/FileUploadPanel/FileUploadPanel.tsx +85 -22
  97. package/src/forms/FileUploadPanel/block.meta.ts +22 -1
  98. package/src/forms/FileUploadPanel/examples/Labels.tsx +29 -0
  99. package/src/forms/FileUploadPanel/fixtures.ts +0 -12
  100. package/src/forms/FileUploadPanel/format-bytes.test.ts +8 -0
  101. package/src/forms/FormSection/FormSection.labels.test.tsx +37 -0
  102. package/src/forms/FormSection/FormSection.tsx +14 -3
  103. package/src/forms/FormSection/block.meta.ts +7 -1
  104. package/src/forms/FormSection/examples/Labels.tsx +27 -0
  105. package/src/forms/InviteMembersDialog/InviteMembersDialog.labels.test.tsx +87 -0
  106. package/src/forms/InviteMembersDialog/InviteMembersDialog.tsx +51 -16
  107. package/src/forms/InviteMembersDialog/block.meta.ts +20 -1
  108. package/src/forms/InviteMembersDialog/examples/Labels.tsx +28 -0
  109. package/src/forms/SettingsRow/SettingsRow.labels.test.tsx +33 -0
  110. package/src/forms/SettingsRow/SettingsRow.tsx +14 -3
  111. package/src/forms/SettingsRow/block.meta.ts +7 -1
  112. package/src/forms/SettingsRow/examples/Labels.tsx +27 -0
  113. package/src/forms/ValidationSummary/ValidationSummary.labels.test.tsx +47 -0
  114. package/src/forms/ValidationSummary/ValidationSummary.tsx +9 -3
  115. package/src/forms/ValidationSummary/block.meta.ts +6 -1
  116. package/src/forms/ValidationSummary/examples/Labels.tsx +24 -0
  117. package/src/forms/index.ts +5 -1
  118. package/src/forms/translated-content.tsx +12 -0
  119. package/src/page-chrome/PageHeader/PageHeader.labels.test.tsx +56 -0
  120. package/src/page-chrome/PageHeader/PageHeader.options.test.tsx +34 -0
  121. package/src/page-chrome/PageHeader/PageHeader.tsx +26 -5
  122. package/src/page-chrome/PageHeader/block.meta.ts +8 -1
  123. package/src/page-chrome/PageHeader/examples/Labels.tsx +16 -0
  124. package/src/page-chrome/PageHeader/examples/Spanish.tsx +11 -0
  125. package/src/scheduling/AgendaList/AgendaList.test.tsx +25 -0
  126. package/src/scheduling/AgendaList/AgendaList.tsx +7 -2
  127. package/src/scheduling/AgendaList/AgendaListLocale.test.tsx +11 -0
  128. package/src/scheduling/AgendaList/block.meta.ts +1 -1
  129. package/src/scheduling/AgendaList/examples/Locale.tsx +29 -0
  130. package/src/scheduling/MonthCalendar/MonthCalendar.test.tsx +111 -1
  131. package/src/scheduling/MonthCalendar/MonthCalendar.tsx +19 -9
  132. package/src/scheduling/MonthCalendar/block.meta.ts +1 -1
  133. package/src/scheduling/MonthCalendar/examples/Locale.tsx +19 -0
  134. package/src/scheduling/WeekCalendar/WeekCalendar.test.tsx +73 -2
  135. package/src/scheduling/WeekCalendar/WeekCalendar.tsx +26 -12
  136. package/src/scheduling/WeekCalendar/block.meta.ts +1 -1
  137. package/src/scheduling/WeekCalendar/examples/Locale.tsx +19 -0
  138. package/src/scheduling/shared/dates.test.ts +75 -0
  139. package/src/scheduling/shared/dates.ts +46 -22
  140. package/src/scheduling/shared/useSchedulingClock.ts +13 -0
  141. package/src/shell/GlobalSearch/GlobalSearch.test.tsx +12 -0
  142. package/src/shell/GlobalSearch/fixtures.ts +2 -2
  143. package/src/tables/DataTable/DataTable.cross-page-selection.test.tsx +322 -0
  144. package/src/tables/DataTable/DataTable.labels.test.tsx +74 -0
  145. package/src/tables/DataTable/DataTable.server-pagination.test.tsx +1 -1
  146. package/src/tables/DataTable/DataTable.single-select.test.tsx +47 -7
  147. package/src/tables/DataTable/DataTable.test.tsx +55 -0
  148. package/src/tables/DataTable/DataTable.tsx +134 -67
  149. package/src/tables/DataTable/block.meta.ts +21 -3
  150. package/src/tables/DataTable/data-table-props.ts +14 -5
  151. package/src/tables/DataTable/data-table-row.tsx +7 -3
  152. package/src/tables/DataTable/data-table-utils.ts +2 -0
  153. package/src/tables/DataTable/examples/client-selection.tsx +33 -0
  154. package/src/tables/DataTable/examples/paginated-single-selection.tsx +46 -0
  155. package/src/tables/DataTable/examples/server-pagination.tsx +55 -15
  156. package/src/tables/DataTable/labels.ts +4 -0
  157. package/src/tables/DataTable/selection-strip.tsx +31 -0
  158. package/src/tables/DataTable/single-selection.tsx +0 -7
  159. package/src/tables/DataTable/use-multiple-selection.ts +86 -0
  160. package/src/tables/PaginationFooter/PaginationFooter.i18n.test.tsx +26 -0
  161. package/src/test/OptInDefaults.test.tsx +27 -0
  162. package/src/test/fixtures/opt-in-defaults.json +10 -0
@@ -0,0 +1,322 @@
1
+ import { act, render, screen } from '@testing-library/react';
2
+ import userEvent from '@testing-library/user-event';
3
+ import { ThemeProvider } from '@gntik-ai/ui';
4
+ import { expectNoAxeViolations } from '../../test/a11y';
5
+ import { DataTable } from './DataTable';
6
+ import ClientSelectionExample from './examples/client-selection';
7
+ import PaginatedSingleSelectionExample from './examples/paginated-single-selection';
8
+ import ServerPaginationExample from './examples/server-pagination';
9
+
10
+ const rows = Array.from({ length: 95 }, (_, index) => ({ id: String(index + 1), name: `Item ${index + 1}` }));
11
+ const columns = [{ id: 'name', header: 'Name', accessor: (row: (typeof rows)[number]) => row.name, sortable: true }];
12
+ const server = { paginationMode: 'server' as const, rowCount: 95, page: 1, pageSize: 20, columns };
13
+
14
+ it.each(['dark', 'light', 'high_contrast'] as const)('has accessible example semantics in %s', async (theme) => {
15
+ const user = userEvent.setup();
16
+ for (const Example of [ServerPaginationExample, ClientSelectionExample, PaginatedSingleSelectionExample]) {
17
+ const { container, unmount } = render(
18
+ <ThemeProvider defaultMode={theme} storageKey={null}>
19
+ <Example />
20
+ </ThemeProvider>,
21
+ );
22
+ await act(async () => {});
23
+ await expectNoAxeViolations(container);
24
+ if (Example !== PaginatedSingleSelectionExample) {
25
+ await user.click(screen.getByRole('checkbox', { name: 'Select all rows on this page' }));
26
+ await user.click(
27
+ screen.getByRole('button', {
28
+ name: Example === ServerPaginationExample ? 'Select all 95 rows' : 'Select all 94 rows',
29
+ }),
30
+ );
31
+ await expectNoAxeViolations(container);
32
+ }
33
+ unmount();
34
+ }
35
+ });
36
+
37
+ it('keeps server selections in reporting and a bulk action on another page', async () => {
38
+ const user = userEvent.setup();
39
+ const onSelectionChange = vi.fn();
40
+ const act = vi.fn();
41
+ const props = {
42
+ ...server,
43
+ onSelectionChange,
44
+ bulkActions: (ids: string[]) => <button onClick={() => act(ids)}>Apply</button>,
45
+ };
46
+ const { rerender } = render(<DataTable {...props} rows={rows.slice(0, 20)} />);
47
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 1' }));
48
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 2' }));
49
+ rerender(<DataTable {...props} rows={rows.slice(20, 40)} page={2} />);
50
+ expect(screen.getByText('2 selected')).toBeInTheDocument();
51
+ await user.click(screen.getByRole('button', { name: 'Apply' }));
52
+ expect(act).toHaveBeenLastCalledWith(['1', '2']);
53
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 21' }));
54
+ expect(onSelectionChange).toHaveBeenLastCalledWith(['1', '2', '21']);
55
+ expect(screen.getByText('3 selected')).toBeInTheDocument();
56
+ await user.click(screen.getByRole('button', { name: 'Apply' }));
57
+ expect(act).toHaveBeenLastCalledWith(['1', '2', '21']);
58
+ });
59
+
60
+ it('opts out of server preservation', async () => {
61
+ const user = userEvent.setup();
62
+ const onSelectionChange = vi.fn();
63
+ const props = { ...server, preserveSelection: false, onSelectionChange };
64
+ const { rerender } = render(<DataTable {...props} rows={rows.slice(0, 20)} />);
65
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 1' }));
66
+ rerender(<DataTable {...props} rows={rows.slice(20, 40)} page={2} />);
67
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 21' }));
68
+ expect(onSelectionChange).toHaveBeenLastCalledWith(['21']);
69
+ expect(screen.getByText('1 selected')).toBeInTheDocument();
70
+ });
71
+
72
+ it.each([false, true])('client preservation=%s reports removed rows only when opted in', async (preserveSelection) => {
73
+ const user = userEvent.setup();
74
+ const onSelectionChange = vi.fn();
75
+ const props = { columns, preserveSelection, onSelectionChange };
76
+ const { rerender } = render(<DataTable {...props} rows={rows.slice(0, 2)} />);
77
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 1' }));
78
+ rerender(<DataTable {...props} rows={rows.slice(1, 3)} />);
79
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 2' }));
80
+ expect(onSelectionChange).toHaveBeenLastCalledWith(preserveSelection ? ['1', '2'] : ['2']);
81
+ });
82
+
83
+ it('keeps the default announcement surface absent until rows are selected', async () => {
84
+ const user = userEvent.setup();
85
+ const { container } = render(<DataTable rows={rows.slice(0, 2)} columns={columns} paginated={false} />);
86
+ expect(container.querySelector('[aria-live]')).not.toBeInTheDocument();
87
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 1' }));
88
+ expect(container.querySelector('[aria-live="polite"]')).toHaveTextContent('1 selected');
89
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 1' }));
90
+ expect(container.querySelector('[aria-live]')).not.toBeInTheDocument();
91
+ });
92
+
93
+ it.each([false, true])(
94
+ 'announces matching selection through one persistent region with summary=%s',
95
+ async (selectionSummary) => {
96
+ const user = userEvent.setup();
97
+ const { container } = render(
98
+ <DataTable
99
+ {...server}
100
+ rows={rows.slice(0, 20)}
101
+ paginated={false}
102
+ selectAllMatching
103
+ onSelectionModelChange={() => {}}
104
+ showColumnMenu={false}
105
+ showDensityToggle={false}
106
+ selectionSummary={selectionSummary}
107
+ />,
108
+ );
109
+ const announcement = container.querySelector('[aria-live="polite"]');
110
+ expect(announcement).toBeInTheDocument();
111
+ expect(announcement).toBeEmptyDOMElement();
112
+ await user.click(screen.getByRole('checkbox', { name: 'Select all rows on this page' }));
113
+ expect(announcement).toHaveTextContent('All 20 rows on this page are selected.');
114
+ expect(container.querySelectorAll('[aria-live="polite"]')).toHaveLength(1);
115
+ if (selectionSummary) expect(screen.getByText('20 selected')).not.toHaveAttribute('aria-hidden', 'true');
116
+ await user.click(screen.getByRole('button', { name: 'Select all 95 rows' }));
117
+ expect(announcement).toHaveTextContent('All 95 rows are selected.');
118
+ await user.click(screen.getByRole('button', { name: 'Clear selection' }));
119
+ expect(announcement).toBeEmptyDOMElement();
120
+ },
121
+ );
122
+
123
+ it('selects every matching client row and retains the strip button and focus when clearing', async () => {
124
+ const user = userEvent.setup();
125
+ const onSelectionChange = vi.fn();
126
+ render(<DataTable rows={rows} columns={columns} selectAllMatching onSelectionChange={onSelectionChange} />);
127
+ await user.click(screen.getByRole('checkbox', { name: 'Select all rows on this page' }));
128
+ expect(
129
+ screen.getByText('All 10 rows on this page are selected.', { selector: '[aria-hidden="true"]' }),
130
+ ).toBeVisible();
131
+ const button = screen.getByRole('button', { name: 'Select all 95 rows' });
132
+ await user.click(button);
133
+ expect(onSelectionChange.mock.lastCall?.[0]).toHaveLength(95);
134
+ expect(onSelectionChange.mock.lastCall?.[0]).toContain('95');
135
+ expect(screen.getByText('All 95 rows are selected.', { selector: '[aria-hidden="true"]' })).toBeVisible();
136
+ expect(screen.getByRole('button', { name: 'Clear selection' })).toBe(button);
137
+ expect(button).toHaveFocus();
138
+ await user.keyboard('{Enter}');
139
+ expect(onSelectionChange).toHaveBeenLastCalledWith([]);
140
+ expect(screen.queryByText('All 95 rows are selected.')).not.toBeInTheDocument();
141
+ expect(screen.getByRole('checkbox', { name: 'Select all rows on this page' })).toHaveFocus();
142
+ });
143
+
144
+ it('returns keyboard focus to the table when clearing with a hidden page checkbox', async () => {
145
+ const user = userEvent.setup();
146
+ render(
147
+ <DataTable
148
+ rows={rows}
149
+ columns={columns}
150
+ selectAllMatching
151
+ hideSelectAll
152
+ defaultSelectedIds={rows.slice(0, 10).map((row) => row.id)}
153
+ />,
154
+ );
155
+ const button = screen.getByRole('button', { name: 'Select all 95 rows' });
156
+ button.focus();
157
+ await user.keyboard('{Enter}');
158
+ expect(screen.getByRole('button', { name: 'Clear selection' })).toHaveFocus();
159
+ await user.keyboard('{Enter}');
160
+ expect(screen.getByRole('table')).toHaveFocus();
161
+ await user.tab();
162
+ expect(screen.getByRole('button', { name: 'Name' })).toHaveFocus();
163
+ await user.tab();
164
+ expect(screen.getByRole('checkbox', { name: 'Select Item 1' })).toHaveFocus();
165
+ });
166
+
167
+ it('does not offer more server matches when all rows are loaded and one is disabled', async () => {
168
+ const user = userEvent.setup();
169
+ const onSelectionChange = vi.fn();
170
+ render(
171
+ <DataTable
172
+ {...server}
173
+ rows={rows.slice(0, 20)}
174
+ rowCount={20}
175
+ selectAllMatching
176
+ isRowDisabled={(row) => row.id === '4'}
177
+ onSelectionChange={onSelectionChange}
178
+ onSelectionModelChange={() => {}}
179
+ />,
180
+ );
181
+ await user.click(screen.getByRole('checkbox', { name: 'Select all rows on this page' }));
182
+ expect(onSelectionChange.mock.lastCall?.[0]).toHaveLength(19);
183
+ expect(screen.getByText('19 selected')).toBeVisible();
184
+ expect(screen.queryByRole('button', { name: 'Select all 20 rows' })).not.toBeInTheDocument();
185
+ });
186
+
187
+ it('excludes loaded disabled server rows from the matching model and preserves that count across pages', async () => {
188
+ const user = userEvent.setup();
189
+ const onSelectionModelChange = vi.fn();
190
+ const props = {
191
+ ...server,
192
+ selectAllMatching: true,
193
+ isRowDisabled: (row: (typeof rows)[number]) => row.id === '4',
194
+ onSelectionModelChange,
195
+ };
196
+ const { rerender } = render(<DataTable {...props} rows={rows.slice(0, 20)} />);
197
+ await user.click(screen.getByRole('checkbox', { name: 'Select all rows on this page' }));
198
+ await user.click(screen.getByRole('button', { name: 'Select all 95 rows' }));
199
+ expect(onSelectionModelChange).toHaveBeenLastCalledWith({ type: 'exclude', ids: ['4'] });
200
+ expect(screen.getByRole('checkbox', { name: 'Select Item 4' })).not.toBeChecked();
201
+ expect(screen.getByRole('checkbox', { name: 'Select Item 4' })).toHaveAttribute('aria-disabled', 'true');
202
+ expect(screen.getByText('94 selected')).toBeVisible();
203
+ onSelectionModelChange.mockClear();
204
+ rerender(<DataTable {...props} rows={rows.slice(20, 40)} page={2} />);
205
+ expect(screen.getByText('94 selected')).toBeVisible();
206
+ expect(onSelectionModelChange).not.toHaveBeenCalled();
207
+ });
208
+
209
+ it('reports an exclude model, keeps it through paging, sizing and sorting, and clears only on changed filters', async () => {
210
+ const user = userEvent.setup();
211
+ const onSelectionChange = vi.fn();
212
+ const onSelectionModelChange = vi.fn();
213
+ const act = vi.fn();
214
+ const props = {
215
+ ...server,
216
+ selectAllMatching: true,
217
+ onSelectionChange,
218
+ onSelectionModelChange,
219
+ filters: { status: 'failed' },
220
+ bulkActions: (ids: string[], model: import('./data-table-utils').DataTableSelectionModel) => (
221
+ <button onClick={() => act(ids, model)}>Apply</button>
222
+ ),
223
+ };
224
+ const { rerender } = render(<DataTable {...props} rows={rows.slice(0, 20)} />);
225
+ await user.click(screen.getByRole('checkbox', { name: 'Select all rows on this page' }));
226
+ await user.click(screen.getByRole('button', { name: 'Select all 95 rows' }));
227
+ expect(onSelectionModelChange).toHaveBeenLastCalledWith({ type: 'exclude', ids: [] });
228
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 3' }));
229
+ expect(onSelectionModelChange).toHaveBeenLastCalledWith({ type: 'exclude', ids: ['3'] });
230
+ expect(screen.getByText('94 selected')).toBeInTheDocument();
231
+ expect(screen.getByText('All 94 rows are selected.', { selector: '[aria-hidden="true"]' })).toBeInTheDocument();
232
+ await user.click(screen.getByRole('button', { name: 'Apply' }));
233
+ expect(act).toHaveBeenLastCalledWith(expect.not.arrayContaining(['3']), { type: 'exclude', ids: ['3'] });
234
+ onSelectionChange.mockClear();
235
+ onSelectionModelChange.mockClear();
236
+ rerender(<DataTable {...props} rows={rows.slice(20, 40)} page={2} filters={{ status: 'failed' }} />);
237
+ rerender(
238
+ <DataTable
239
+ {...props}
240
+ rows={rows.slice(40, 50)}
241
+ page={5}
242
+ pageSize={10}
243
+ sort={{ columnId: 'name', direction: 'descending' }}
244
+ />,
245
+ );
246
+ expect(onSelectionChange).not.toHaveBeenCalled();
247
+ expect(onSelectionModelChange).not.toHaveBeenCalled();
248
+ expect(screen.getByText('94 selected')).toBeInTheDocument();
249
+ expect(screen.getByRole('button', { name: 'Clear selection' })).toBeInTheDocument();
250
+ rerender(<DataTable {...props} rows={rows.slice(40, 50)} filters={{ status: 'paused' }} />);
251
+ expect(onSelectionModelChange).toHaveBeenLastCalledWith({ type: 'include', ids: [] });
252
+ expect(onSelectionChange).toHaveBeenLastCalledWith([]);
253
+ expect(screen.queryByText('94 selected')).not.toBeInTheDocument();
254
+ });
255
+
256
+ it('retains legacy client checkbox state when removed rows return, while reporting only supplied rows', async () => {
257
+ const user = userEvent.setup();
258
+ const onSelectionChange = vi.fn();
259
+ const props = { columns, onSelectionChange };
260
+ const { rerender } = render(<DataTable {...props} rows={rows.slice(0, 2)} />);
261
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 1' }));
262
+ rerender(<DataTable {...props} rows={rows.slice(1, 3)} />);
263
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 2' }));
264
+ expect(onSelectionChange).toHaveBeenLastCalledWith(['2']);
265
+ rerender(<DataTable {...props} rows={rows.slice(0, 3)} />);
266
+ expect(screen.getByRole('checkbox', { name: 'Select Item 1' })).toBeChecked();
267
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 3' }));
268
+ expect(onSelectionChange).toHaveBeenLastCalledWith(['1', '2', '3']);
269
+ });
270
+
271
+ it('requires a model callback for the server strip and warns in development only', async () => {
272
+ vi.stubEnv('NODE_ENV', 'development');
273
+ const warning = vi.spyOn(console, 'warn').mockImplementation(() => {});
274
+ try {
275
+ const user = userEvent.setup();
276
+ const { unmount } = render(<DataTable {...server} rows={rows.slice(0, 20)} selectAllMatching />);
277
+ await user.click(screen.getByRole('checkbox', { name: 'Select all rows on this page' }));
278
+ expect(screen.queryByRole('button', { name: 'Select all 95 rows' })).not.toBeInTheDocument();
279
+ expect(warning).toHaveBeenCalledWith(expect.stringContaining('onSelectionModelChange'));
280
+ warning.mockClear();
281
+ unmount();
282
+ vi.stubEnv('NODE_ENV', 'production');
283
+ render(<DataTable {...server} rows={rows.slice(0, 20)} selectAllMatching />);
284
+ expect(warning).not.toHaveBeenCalled();
285
+ } finally {
286
+ warning.mockRestore();
287
+ vi.unstubAllEnvs();
288
+ }
289
+ });
290
+
291
+ it('gives a controlled model precedence over selectedIds and waits for its consumer', async () => {
292
+ const user = userEvent.setup();
293
+ const onSelectionModelChange = vi.fn();
294
+ const props = { rows: rows.slice(0, 3), columns, selectedIds: ['1'], onSelectionModelChange };
295
+ const { rerender } = render(<DataTable {...props} selectionModel={{ type: 'include', ids: ['2'] }} />);
296
+ expect(screen.getByRole('checkbox', { name: 'Select Item 1' })).not.toBeChecked();
297
+ expect(screen.getByRole('checkbox', { name: 'Select Item 2' })).toBeChecked();
298
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 3' }));
299
+ expect(onSelectionModelChange).toHaveBeenLastCalledWith({ type: 'include', ids: ['2', '3'] });
300
+ expect(screen.getByRole('checkbox', { name: 'Select Item 3' })).not.toBeChecked();
301
+ rerender(<DataTable {...props} selectionModel={{ type: 'include', ids: ['2', '3'] }} />);
302
+ expect(screen.getByRole('checkbox', { name: 'Select Item 3' })).toBeChecked();
303
+ });
304
+
305
+ it('continues to support controlled selectedIds with a one-argument bulk action', async () => {
306
+ const user = userEvent.setup();
307
+ const onSelectionChange = vi.fn();
308
+ const { rerender } = render(
309
+ <DataTable
310
+ rows={rows.slice(0, 3)}
311
+ columns={columns}
312
+ selectedIds={['1']}
313
+ onSelectionChange={onSelectionChange}
314
+ bulkActions={(ids) => <span>Act on {ids.join(',')}</span>}
315
+ />,
316
+ );
317
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 2' }));
318
+ expect(onSelectionChange).toHaveBeenLastCalledWith(['1', '2']);
319
+ expect(screen.getByText('Act on 1')).toBeInTheDocument();
320
+ rerender(<DataTable rows={rows.slice(0, 3)} columns={columns} selectedIds={['1', '2']} />);
321
+ expect(screen.getByText('2 selected')).toBeInTheDocument();
322
+ });
@@ -233,6 +233,10 @@ it('replaces every pin option and the single-selection heading without translati
233
233
  const user = userEvent.setup({ pointerEventsCheck: 0 });
234
234
  const full: DataTableLabels = {
235
235
  ...labels,
236
+ pageSelected: (count) => `Página seleccionada: ${count}`,
237
+ selectAllMatching: (count) => `Seleccionar coincidencias: ${count}`,
238
+ allMatchingSelected: (count) => `Coincidencias seleccionadas: ${count}`,
239
+ clearSelection: 'Borrar selección',
236
240
  booleanTrue: 'Sí',
237
241
  booleanFalse: 'No',
238
242
  selectGroup: (group) => `Grupo ${group}`,
@@ -291,3 +295,73 @@ it('replaces every pin option and the single-selection heading without translati
291
295
  expect(screen.getByRole('radio', { name: 'Alpha' })).toBeVisible();
292
296
  expect(screen.queryByRole('radio', { name: 'Seleccionar Alpha' })).toBeNull();
293
297
  });
298
+
299
+ it.each([
300
+ [
301
+ 'en-US',
302
+ 'All 10 rows on this page are selected.',
303
+ 'Select all 12,345 rows',
304
+ 'All 12,345 rows are selected.',
305
+ 'Clear selection',
306
+ ],
307
+ [
308
+ 'es-MX',
309
+ 'Las 10 filas de esta página están seleccionadas.',
310
+ 'Seleccionar las 12,345 filas',
311
+ 'Las 12,345 filas están seleccionadas.',
312
+ 'Borrar selección',
313
+ ],
314
+ ])(
315
+ 'translates matching selection with provider-formatted counts in %s',
316
+ async (locale, pageText, action, allText, clear) => {
317
+ const user = userEvent.setup();
318
+ const records = Array.from({ length: 10 }, (_, i) => ({ id: String(i), name: `Item ${i}`, region: 'West' }));
319
+ render(
320
+ <I18nProvider locale={locale}>
321
+ <DataTable
322
+ rows={records}
323
+ columns={columns}
324
+ paginationMode="server"
325
+ page={1}
326
+ pageSize={10}
327
+ rowCount={12345}
328
+ selectAllMatching
329
+ onSelectionModelChange={() => {}}
330
+ />
331
+ </I18nProvider>,
332
+ );
333
+ await user.click(
334
+ screen.getByRole('checkbox', {
335
+ name: locale === 'en-US' ? 'Select all rows on this page' : 'Seleccionar todas las filas de esta página',
336
+ }),
337
+ );
338
+ expect(screen.getByText(pageText!, { selector: '[aria-hidden="true"]' })).toBeInTheDocument();
339
+ await user.click(screen.getByRole('button', { name: action }));
340
+ expect(screen.getByText(allText!, { selector: '[aria-hidden="true"]' })).toBeInTheDocument();
341
+ expect(screen.getByRole('button', { name: clear })).toHaveFocus();
342
+ },
343
+ );
344
+
345
+ it('overrides every matching-selection string through labels', async () => {
346
+ const user = userEvent.setup();
347
+ render(
348
+ <DataTable
349
+ rows={rows}
350
+ columns={columns}
351
+ defaultPageSize={1}
352
+ selectAllMatching
353
+ labels={{
354
+ pageSelected: (n) => `Page picked: ${n}`,
355
+ selectAllMatching: (n) => `Pick matches: ${n}`,
356
+ allMatchingSelected: (n) => `Matches picked: ${n}`,
357
+ clearSelection: 'Clear picks',
358
+ }}
359
+ />,
360
+ );
361
+ await user.click(screen.getByRole('checkbox', { name: 'Select all rows on this page' }));
362
+ expect(screen.getByText('Page picked: 1', { selector: '[aria-hidden="true"]' })).toBeInTheDocument();
363
+ await user.click(screen.getByRole('button', { name: 'Pick matches: 2' }));
364
+ expect(screen.getByText('Matches picked: 2', { selector: '[aria-hidden="true"]' })).toBeInTheDocument();
365
+ await user.click(screen.getByRole('button', { name: 'Clear picks' }));
366
+ expect(screen.queryByText('Matches picked: 2')).toBeNull();
367
+ });
@@ -35,7 +35,7 @@ const summary = () => document.querySelector('[aria-live="polite"]');
35
35
 
36
36
  // @ts-expect-error Server pagination needs a known total.
37
37
  const missingTotal: DataTableProps<Row> = { paginationMode: 'server', page: 1, pageSize: 20 };
38
- // @ts-expect-error Server pagination cannot be combined with single selection.
38
+ // Single selection accepts the same controlled server pagination contract.
39
39
  const singleServer: DataTableProps<Row> = { ...server, selectionMode: 'single', paginated: false };
40
40
  void missingTotal;
41
41
  void singleServer;
@@ -172,9 +172,9 @@ describe('DataTable single selection', () => {
172
172
  }
173
173
  });
174
174
 
175
- it('rejects pagination in types and warns while rendering all rows if the type check is bypassed', () => {
176
- // @ts-expect-error Single selection cannot be paginated.
177
- const invalid: DataTableProps<(typeof rows)[number]> = {
175
+ it('paginates single selection without warnings and preserves an off-page choice', async () => {
176
+ const user = userEvent.setup();
177
+ const valid: DataTableProps<(typeof rows)[number]> = {
178
178
  ...base,
179
179
  selectionMode: 'single',
180
180
  paginated: true,
@@ -183,10 +183,16 @@ describe('DataTable single selection', () => {
183
183
  vi.stubEnv('NODE_ENV', 'development');
184
184
  const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
185
185
  try {
186
- render(<DataTable {...invalid} defaultPageSize={1} virtualize={true} />);
187
- expect(warn).toHaveBeenCalledWith(expect.stringContaining('paginated'));
188
- expect(screen.getAllByRole('radio')).toHaveLength(3);
189
- expect(screen.queryByRole('navigation')).toBeNull();
186
+ render(<DataTable {...valid} defaultPageSize={1} defaultSelectedId="c" virtualize={true} />);
187
+ expect(warn).not.toHaveBeenCalled();
188
+ expect(screen.getAllByRole('radio')).toHaveLength(1);
189
+ expect(screen.queryByRole('radio', { checked: true })).toBeNull();
190
+ expect(screen.getByRole('radio', { name: 'Alpha' })).toHaveAttribute('tabindex', '0');
191
+ await user.tab();
192
+ expect(screen.getByRole('radio', { name: 'Alpha' })).toHaveFocus();
193
+ await user.click(screen.getByRole('button', { name: 'Page 3' }));
194
+ expect(screen.getByRole('radio', { name: 'Gamma' })).toBeChecked();
195
+ expect(screen.getByRole('radio', { name: 'Gamma' })).toHaveAttribute('tabindex', '0');
190
196
  expect(screen.getByRole('table')).not.toHaveAttribute('data-virtualized');
191
197
  } finally {
192
198
  warn.mockRestore();
@@ -194,6 +200,40 @@ describe('DataTable single selection', () => {
194
200
  }
195
201
  });
196
202
 
203
+ it('keeps the controlled single choice across server pages and enters on the first enabled radio', async () => {
204
+ const user = userEvent.setup();
205
+ const records = Array.from({ length: 60 }, (_, i) => ({ id: String(i + 1), name: `Item ${i + 1}` }));
206
+ const columns = [{ id: 'name', header: 'Name', accessor: (r: (typeof records)[number]) => r.name }];
207
+ const onSelectedIdChange = vi.fn();
208
+ const props = {
209
+ paginationMode: 'server' as const,
210
+ selectionMode: 'single' as const,
211
+ rowCount: 60,
212
+ page: 1,
213
+ pageSize: 20,
214
+ selectedId: '42',
215
+ columns,
216
+ legend: 'Items; current choice Item 42',
217
+ showColumnMenu: false,
218
+ showDensityToggle: false,
219
+ isRowDisabled: (r: (typeof records)[number]) => r.id === '1',
220
+ onSelectedIdChange,
221
+ };
222
+ const { rerender } = render(<DataTable {...props} rows={records.slice(0, 20)} />);
223
+ expect(screen.getAllByRole('radio')).toHaveLength(20);
224
+ expect(screen.getByRole('button', { name: 'Page 3' })).toBeInTheDocument();
225
+ expect(screen.queryByRole('radio', { checked: true })).toBeNull();
226
+ await user.tab();
227
+ expect(screen.getByRole('radio', { name: 'Item 2' })).toHaveFocus();
228
+ expect(onSelectedIdChange).not.toHaveBeenCalled();
229
+ rerender(<DataTable {...props} rows={records.slice(40, 60)} page={3} />);
230
+ expect(screen.getByRole('radio', { name: 'Item 42' })).toBeChecked();
231
+ expect(screen.getByRole('radio', { name: 'Item 42' })).toHaveAttribute('tabindex', '0');
232
+ await user.click(screen.getByRole('radio', { name: 'Item 43' }));
233
+ expect(onSelectedIdChange).toHaveBeenLastCalledWith('43');
234
+ expect(screen.getByRole('radio', { name: 'Item 42' })).toBeChecked();
235
+ });
236
+
197
237
  it('isolates generated radio names between tables', async () => {
198
238
  const user = userEvent.setup();
199
239
  render(
@@ -282,3 +282,58 @@ describe('DataTable groupBy', () => {
282
282
  ]);
283
283
  });
284
284
  });
285
+
286
+ it('skips disabled rows for page, group and all-matching selection and checkbox states', async () => {
287
+ const user = userEvent.setup();
288
+ const rows = Array.from({ length: 20 }, (_, i) => ({
289
+ id: String(i + 1),
290
+ name: `Row ${i + 1}`,
291
+ locked: i === 3,
292
+ group: 'Items',
293
+ }));
294
+ const columns = [{ id: 'name', header: 'Name', accessor: (row: (typeof rows)[number]) => row.name }];
295
+ const onSelectionChange = vi.fn();
296
+ render(
297
+ <DataTable
298
+ rows={rows}
299
+ columns={columns}
300
+ groupBy="group"
301
+ isRowDisabled={(row) => row.locked}
302
+ selectAllMatching
303
+ onSelectionChange={onSelectionChange}
304
+ />,
305
+ );
306
+ const locked = screen.getByRole('checkbox', { name: 'Select Row 4' });
307
+ expect(locked).toHaveAttribute('aria-disabled', 'true');
308
+ const page = screen.getByRole('checkbox', { name: 'Select all rows on this page' });
309
+ await user.click(page);
310
+ expect(onSelectionChange.mock.lastCall?.[0]).toHaveLength(9);
311
+ expect(onSelectionChange.mock.lastCall?.[0]).not.toContain('4');
312
+ expect(page).toHaveAttribute('aria-checked', 'true');
313
+ expect(locked).not.toBeChecked();
314
+ await user.click(screen.getByRole('button', { name: 'Select all 19 rows' }));
315
+ expect(onSelectionChange.mock.lastCall?.[0]).toHaveLength(19);
316
+ expect(onSelectionChange.mock.lastCall?.[0]).not.toContain('4');
317
+ const group = screen.getByRole('checkbox', { name: 'Select all in Items' });
318
+ expect(group).toHaveAttribute('aria-checked', 'true');
319
+ await user.click(group);
320
+ expect(onSelectionChange).toHaveBeenLastCalledWith([]);
321
+ await user.click(group);
322
+ expect(onSelectionChange.mock.lastCall?.[0]).toHaveLength(19);
323
+ expect(locked).not.toBeChecked();
324
+ });
325
+
326
+ it('disables page and group toggles when all rows are disabled', () => {
327
+ render(<DataTable groupBy="region" isRowDisabled={() => true} />);
328
+ for (const checkbox of screen.getAllByRole('checkbox')) expect(checkbox).toHaveAttribute('aria-disabled', 'true');
329
+ });
330
+
331
+ it('hides only the header select-all control, keeping the selection heading and row controls', async () => {
332
+ const user = userEvent.setup();
333
+ const onSelectionChange = vi.fn();
334
+ render(<DataTable hideSelectAll onSelectionChange={onSelectionChange} />);
335
+ expect(screen.queryByRole('checkbox', { name: 'Select all rows on this page' })).not.toBeInTheDocument();
336
+ expect(screen.getByRole('columnheader', { name: 'Selection' }).firstElementChild).toHaveClass('sr-only');
337
+ await user.click(screen.getByRole('checkbox', { name: `Select ${DEPLOYMENT_ROWS[0]!.name}` }));
338
+ expect(onSelectionChange).toHaveBeenLastCalledWith([DEPLOYMENT_ROWS[0]!.id]);
339
+ });