@gntik-ai/blocks 0.11.0 → 0.13.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 (189) hide show
  1. package/dist/index.d.ts +1501 -1232
  2. package/dist/index.js +1891 -840
  3. package/dist/index.js.map +1 -1
  4. package/package.json +6 -6
  5. package/src/ai/EvaluationScorecard/EvaluationScorecard.test.tsx +10 -0
  6. package/src/ai/EvaluationScorecard/EvaluationScorecard.tsx +2 -1
  7. package/src/ai/PromptEditor/PromptEditor.tsx +2 -2
  8. package/src/ai/PromptEditor/examples/controlled-variables.tsx +1 -1
  9. package/src/ai/TokenCostCard/TokenCostCard.test.tsx +10 -0
  10. package/src/ai/TokenCostCard/TokenCostCard.tsx +2 -1
  11. package/src/ai/TraceWaterfall/TraceWaterfall.tsx +2 -2
  12. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.test.tsx +6 -0
  13. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.tsx +4 -1
  14. package/src/auth/ForgotPasswordForm/block.meta.ts +1 -1
  15. package/src/auth/ForgotPasswordForm/examples/LargeFields.tsx +6 -0
  16. package/src/auth/MfaChallenge/MfaChallenge.test.tsx +9 -0
  17. package/src/auth/MfaChallenge/MfaChallenge.tsx +5 -2
  18. package/src/auth/MfaChallenge/block.meta.ts +1 -1
  19. package/src/auth/MfaChallenge/examples/LargeFields.tsx +6 -0
  20. package/src/auth/ResetPasswordForm/ResetPasswordForm.test.tsx +7 -0
  21. package/src/auth/ResetPasswordForm/ResetPasswordForm.tsx +5 -3
  22. package/src/auth/ResetPasswordForm/block.meta.ts +1 -1
  23. package/src/auth/ResetPasswordForm/examples/LargeFields.tsx +6 -0
  24. package/src/auth/SignInForm/SignInForm.test.tsx +7 -0
  25. package/src/auth/SignInForm/SignInForm.tsx +5 -1
  26. package/src/auth/SignInForm/block.meta.ts +1 -1
  27. package/src/auth/SignInForm/examples/LargeFields.tsx +6 -0
  28. package/src/auth/SignUpForm/SignUpForm.test.tsx +22 -0
  29. package/src/auth/SignUpForm/SignUpForm.tsx +7 -1
  30. package/src/auth/SignUpForm/block.meta.ts +1 -1
  31. package/src/auth/SignUpForm/examples/LargeFields.tsx +6 -0
  32. package/src/auth/__snapshots__/field-size.test.tsx.snap +11 -0
  33. package/src/auth/field-size.test.tsx +21 -0
  34. package/src/auth/large-examples.test.tsx +30 -0
  35. package/src/auth/shared.tsx +7 -2
  36. package/src/billing/PaymentMethodCard/PaymentMethodCard.tsx +1 -1
  37. package/src/billing/PlanCard/PlanCard.baseline.test.tsx +3 -2
  38. package/src/billing/PlanCard/__snapshots__/PlanCard.baseline.test.tsx.snap +2 -2
  39. package/src/billing/PlanDefinitionCard/examples/Compact.tsx +1 -4
  40. package/src/billing/PlanDefinitionCard/examples/Full.tsx +1 -4
  41. package/src/builders/CodePanel/CodePanel.test.tsx +11 -0
  42. package/src/builders/CodePanel/CodePanel.tsx +4 -3
  43. package/src/builders/FlowBuilder/FlowBuilder.tsx +4 -19
  44. package/src/builders/FlowBuilder/parts.tsx +4 -4
  45. package/src/builders/LogViewer/LogViewer.follow.test.tsx +29 -0
  46. package/src/builders/LogViewer/LogViewer.test.tsx +24 -0
  47. package/src/builders/LogViewer/LogViewer.tsx +67 -20
  48. package/src/builders/LogViewer/block.meta.ts +2 -1
  49. package/src/builders/LogViewer/examples/Spanish.tsx +2 -1
  50. package/src/data-display/ActivityFeed/ActivityFeed.tsx +1 -1
  51. package/src/data-display/ChartCard/ChartCard.tsx +2 -2
  52. package/src/data-display/ChartCard/examples/ContainerPanel.tsx +16 -0
  53. package/src/data-display/CommentThread/CommentThread.test.tsx +70 -1
  54. package/src/data-display/CommentThread/CommentThread.tsx +22 -6
  55. package/src/data-display/CommentThread/block.meta.ts +1 -1
  56. package/src/data-display/CommentThread/examples/RenderedBody.tsx +20 -0
  57. package/src/data-display/DescriptionListCard/DescriptionListCard.test.tsx +24 -1
  58. package/src/data-display/DescriptionListCard/DescriptionListCard.tsx +14 -20
  59. package/src/data-display/DescriptionListCard/block.meta.ts +2 -1
  60. package/src/data-display/DescriptionListCard/examples/Spanish.tsx +2 -1
  61. package/src/data-display/KpiRow/KpiRow.doc.ts +14 -0
  62. package/src/data-display/KpiRow/KpiRow.test.tsx +11 -0
  63. package/src/data-display/KpiRow/KpiRow.tsx +72 -55
  64. package/src/data-display/KpiRow/examples/ContainerPanel.tsx +47 -0
  65. package/src/data-display/ResourceCardGrid/ResourceCardGrid.doc.ts +19 -0
  66. package/src/data-display/ResourceCardGrid/ResourceCardGrid.test.tsx +13 -0
  67. package/src/data-display/ResourceCardGrid/ResourceCardGrid.tsx +49 -40
  68. package/src/data-display/ResourceCardGrid/examples/ContainerPanel.tsx +18 -0
  69. package/src/data-display/StatusTimeline/StatusTimeline.tsx +1 -1
  70. package/src/feedback/EmptyStates/EmptyStates.test.tsx +42 -0
  71. package/src/feedback/EmptyStates/EmptyStates.tsx +5 -3
  72. package/src/feedback/EmptyStates/block.meta.ts +1 -1
  73. package/src/feedback/EmptyStates/examples/HiddenAction.tsx +13 -0
  74. package/src/feedback/ErrorPanel/ErrorPanel.tsx +13 -15
  75. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.lifecycle.test.tsx +123 -0
  76. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.tsx +128 -139
  77. package/src/forms/CreateApiKeyDialog/block.meta.ts +12 -1
  78. package/src/forms/FileUploadPanel/FileUploadPanel.controlled.test.tsx +482 -0
  79. package/src/forms/FileUploadPanel/FileUploadPanel.drag.test.tsx +60 -0
  80. package/src/forms/FileUploadPanel/FileUploadPanel.lifecycle.test.tsx +165 -0
  81. package/src/forms/FileUploadPanel/FileUploadPanel.tsx +267 -69
  82. package/src/forms/FileUploadPanel/block.meta.ts +5 -1
  83. package/src/forms/FileUploadPanel/examples/AutoCancel.tsx +38 -0
  84. package/src/forms/FileUploadPanel/examples/Labels.tsx +1 -1
  85. package/src/forms/FileUploadPanel/examples/ManualForm.tsx +36 -0
  86. package/src/forms/FileUploadPanel/fixtures.ts +31 -16
  87. package/src/forms/FileUploadPanel/simulate-upload.test.ts +24 -0
  88. package/src/forms/FormSection/FormSection.test.tsx +11 -0
  89. package/src/forms/FormSection/FormSection.tsx +20 -22
  90. package/src/forms/FormSection/block.meta.ts +1 -1
  91. package/src/forms/FormSection/examples/ContainerPanel.tsx +16 -0
  92. package/src/forms/InviteMembersDialog/InviteMembersDialog.lifecycle.test.tsx +80 -0
  93. package/src/forms/InviteMembersDialog/InviteMembersDialog.tsx +90 -109
  94. package/src/forms/InviteMembersDialog/block.meta.ts +1 -1
  95. package/src/forms/ValidationSummary/ValidationSummary.tsx +1 -4
  96. package/src/hooks/index.ts +2 -0
  97. package/src/hooks/useTableData.integration.test.tsx +89 -0
  98. package/src/hooks/useTableData.test.tsx +613 -0
  99. package/src/hooks/useTableData.ts +377 -0
  100. package/src/index.ts +1 -0
  101. package/src/marketing/ComparisonTable/ComparisonTable.tsx +2 -2
  102. package/src/marketing/FeatureGrid/FeatureGrid.tsx +1 -1
  103. package/src/marketing/LogoCloud/LogoCloud.doc.ts +13 -0
  104. package/src/marketing/LogoCloud/LogoCloud.test.tsx +155 -0
  105. package/src/marketing/LogoCloud/LogoCloud.tsx +89 -0
  106. package/src/marketing/LogoCloud/block.meta.ts +10 -0
  107. package/src/marketing/LogoCloud/examples/CaptionStart.tsx +6 -0
  108. package/src/marketing/LogoCloud/examples/Custom.tsx +25 -0
  109. package/src/marketing/LogoCloud/examples/Empty.tsx +6 -0
  110. package/src/marketing/LogoCloud/examples/Grid.tsx +13 -0
  111. package/src/marketing/LogoCloud/examples/Row.tsx +6 -0
  112. package/src/marketing/LogoCloud/examples/UnderHero.tsx +13 -0
  113. package/src/marketing/LogoCloud/fixtures.ts +23 -0
  114. package/src/marketing/PricingTable/PricingTable.tsx +1 -1
  115. package/src/marketing/SiteFooter/SiteFooter.doc.ts +18 -0
  116. package/src/marketing/SiteFooter/SiteFooter.test.tsx +236 -0
  117. package/src/marketing/SiteFooter/SiteFooter.tsx +160 -0
  118. package/src/marketing/SiteFooter/block.meta.ts +10 -0
  119. package/src/marketing/SiteFooter/examples/Centered.tsx +15 -0
  120. package/src/marketing/SiteFooter/examples/Columns.tsx +15 -0
  121. package/src/marketing/SiteFooter/examples/Custom.tsx +35 -0
  122. package/src/marketing/SiteFooter/examples/Empty.tsx +6 -0
  123. package/src/marketing/SiteFooter/examples/Simple.tsx +14 -0
  124. package/src/marketing/SiteFooter/fixtures.ts +36 -0
  125. package/src/marketing/index.ts +6 -0
  126. package/src/page-chrome/PageHeader/EditableTitle.test.tsx +26 -0
  127. package/src/page-chrome/PageHeader/PageHeader.tsx +4 -4
  128. package/src/page-chrome/PageHeader/block.meta.ts +1 -1
  129. package/src/page-chrome/PageHeader/examples/ContainerPanel.tsx +16 -0
  130. package/src/page-chrome/PageHeader/examples/EditableTitle.tsx +23 -0
  131. package/src/page-chrome/PageToolbar/PageToolbar.test.tsx +3 -1
  132. package/src/page-chrome/PageToolbar/PageToolbar.tsx +2 -2
  133. package/src/page-chrome/StickyActionBar/StickyActionBar.tsx +1 -1
  134. package/src/scheduling/AgendaList/AgendaList.tsx +39 -15
  135. package/src/scheduling/AgendaList/AgendaListZone.test.tsx +38 -0
  136. package/src/scheduling/AgendaList/block.meta.ts +1 -1
  137. package/src/scheduling/AgendaList/examples/TimeZone.tsx +28 -0
  138. package/src/scheduling/MonthCalendar/MonthCalendar.tsx +51 -40
  139. package/src/scheduling/MonthCalendar/MonthCalendarZone.test.tsx +44 -0
  140. package/src/scheduling/MonthCalendar/block.meta.ts +1 -1
  141. package/src/scheduling/MonthCalendar/examples/TimeZone.tsx +28 -0
  142. package/src/scheduling/WeekCalendar/WeekCalendar.tsx +37 -28
  143. package/src/scheduling/WeekCalendar/WeekCalendarZone.test.tsx +41 -0
  144. package/src/scheduling/WeekCalendar/block.meta.ts +1 -1
  145. package/src/scheduling/WeekCalendar/examples/TimeZone.tsx +28 -0
  146. package/src/scheduling/shared/CalendarHeader.tsx +26 -1
  147. package/src/scheduling/shared/dates.ts +102 -58
  148. package/src/scheduling/shared/events.ts +2 -2
  149. package/src/shell/AppSidebar/AppSidebar.context.test.tsx +175 -0
  150. package/src/shell/AppSidebar/AppSidebar.doc.ts +29 -0
  151. package/src/shell/AppSidebar/AppSidebar.tsx +97 -25
  152. package/src/shell/AppSidebar/block.meta.ts +1 -1
  153. package/src/shell/GlobalSearch/GlobalSearch.test.tsx +1 -0
  154. package/src/shell/GlobalSearch/GlobalSearch.tsx +1 -1
  155. package/src/tables/DataTable/DataTable.cursor-example.test.tsx +67 -0
  156. package/src/tables/DataTable/DataTable.export.test.tsx +511 -0
  157. package/src/tables/DataTable/DataTable.inline-edit-focus.test.tsx +32 -0
  158. package/src/tables/DataTable/DataTable.layout.test.tsx +6 -5
  159. package/src/tables/DataTable/DataTable.link-actions.test.tsx +18 -0
  160. package/src/tables/DataTable/DataTable.server-pagination.test.tsx +328 -14
  161. package/src/tables/DataTable/DataTable.test.tsx +85 -1
  162. package/src/tables/DataTable/DataTable.tsx +108 -14
  163. package/src/tables/DataTable/block.meta.ts +11 -1
  164. package/src/tables/DataTable/column-sizing.ts +2 -2
  165. package/src/tables/DataTable/data-table-props.ts +29 -1
  166. package/src/tables/DataTable/data-table-row.tsx +2 -2
  167. package/src/tables/DataTable/data-table-utils.ts +4 -0
  168. package/src/tables/DataTable/editable-cell.tsx +20 -79
  169. package/src/tables/DataTable/examples/csv-export.tsx +74 -0
  170. package/src/tables/DataTable/examples/cursor-load-more.tsx +87 -0
  171. package/src/tables/DataTable/examples/server-pagination.tsx +47 -40
  172. package/src/tables/DataTable/export-menu.tsx +58 -0
  173. package/src/tables/DataTable/header-cell.tsx +1 -1
  174. package/src/tables/DataTable/labels.ts +7 -0
  175. package/src/tables/DataTable/resize-handle.tsx +2 -2
  176. package/src/tables/DataTable/use-table-export.ts +117 -0
  177. package/src/tables/FilterBar/FilterBar.test.tsx +12 -0
  178. package/src/tables/FilterBar/FilterBar.tsx +5 -7
  179. package/src/team/ProfileHeader/ProfileHeader.picker.test.tsx +34 -0
  180. package/src/team/ProfileHeader/ProfileHeader.test.tsx +2 -2
  181. package/src/team/ProfileHeader/ProfileHeader.tsx +17 -24
  182. package/src/team/ProfileHeader/block.meta.ts +1 -1
  183. package/src/test/OptInDefaults.test.tsx +10 -1
  184. package/src/test/clipboard-fallback.test.tsx +49 -0
  185. package/src/test/copy-examples.test.tsx +29 -0
  186. package/src/test/copy-feedback.test.tsx +166 -0
  187. package/src/test/fixtures/opt-in-defaults.json +5 -5
  188. package/src/test/without-forced-colors.test.ts +44 -0
  189. package/src/test/without-forced-colors.ts +14 -0
@@ -1,7 +1,10 @@
1
- import { fireEvent, render, screen, within } from '@testing-library/react';
1
+ import { act, fireEvent, render, screen, within } from '@testing-library/react';
2
2
  import userEvent from '@testing-library/user-event';
3
+ import { flushSync } from 'react-dom';
3
4
  import { describe, expect, it, vi } from 'vitest';
4
- import { DataTable, type DataTableProps } from './DataTable';
5
+ import { DataTable, type DataTableProps, type DataTableQuery } from './DataTable';
6
+ import ServerPaginationExample from './examples/server-pagination';
7
+ import { expectNoAxeViolations } from '../../test/a11y';
5
8
  import type { DataTableColumn } from './data-table-utils';
6
9
 
7
10
  type Row = { id: number; name: string; region: string };
@@ -42,7 +45,7 @@ void singleServer;
42
45
 
43
46
  describe('DataTable controlled server pagination', () => {
44
47
  it('renders the supplied page in order and counts the full result set', () => {
45
- render(<DataTable {...server} />);
48
+ render(<DataTable {...server} sort={{ columnId: 'id', direction: 'ascending' }} />);
46
49
  expect(renderedIds()).toEqual([
47
50
  '40',
48
51
  '39',
@@ -91,6 +94,115 @@ describe('DataTable controlled server pagination', () => {
91
94
  expect(onPageChange.mock.calls).toEqual([[3], [1]]);
92
95
  });
93
96
 
97
+ it('reports controlled page requests synchronously without reacting to prop updates', () => {
98
+ const onQueryChange = vi.fn();
99
+ const onPageChange = vi.fn();
100
+ const { rerender } = render(
101
+ <DataTable
102
+ {...server}
103
+ page={1}
104
+ pageSize={50}
105
+ filters={{ status: 'failed' }}
106
+ onPageChange={onPageChange}
107
+ onQueryChange={onQueryChange}
108
+ />,
109
+ );
110
+ fireEvent.click(screen.getByRole('button', { name: 'Next page' }));
111
+ expect(onPageChange.mock.calls).toEqual([[2]]);
112
+ expect(onQueryChange.mock.calls).toEqual([
113
+ [{ page: 2, pageSize: 50, sort: null, filters: { status: 'failed' }, cause: 'page' }],
114
+ ]);
115
+ rerender(
116
+ <DataTable
117
+ {...server}
118
+ page={2}
119
+ pageSize={50}
120
+ filters={{ status: 'active' }}
121
+ onPageChange={onPageChange}
122
+ onQueryChange={onQueryChange}
123
+ />,
124
+ );
125
+ expect(onQueryChange).toHaveBeenCalledTimes(1);
126
+ });
127
+
128
+ it.each([
129
+ [2, 1],
130
+ [1, 1],
131
+ [5, 2],
132
+ [99, 2],
133
+ ])('reports one complete resize query from supplied page %s', async (page, nextPage) => {
134
+ const user = userEvent.setup();
135
+ const calls: string[] = [];
136
+ const onPageChange = vi.fn(() => calls.push('page'));
137
+ const onPageSizeChange = vi.fn(() => calls.push('size'));
138
+ const onQueryChange = vi.fn();
139
+ render(
140
+ <DataTable
141
+ {...server}
142
+ page={page}
143
+ defaultSort={{ columnId: 'name', direction: 'ascending' }}
144
+ filters={{ status: 'failed' }}
145
+ onPageChange={onPageChange}
146
+ onPageSizeChange={onPageSizeChange}
147
+ onQueryChange={onQueryChange}
148
+ />,
149
+ );
150
+ await user.click(screen.getByRole('combobox', { name: 'Rows per page' }));
151
+ await user.click(await screen.findByRole('option', { name: '50' }));
152
+ expect(onPageSizeChange.mock.calls).toEqual([[50]]);
153
+ expect(onPageChange.mock.calls).toEqual(page === 1 ? [] : [[nextPage]]);
154
+ expect(calls).toEqual(page === 1 ? ['size'] : ['size', 'page']);
155
+ expect(onQueryChange.mock.calls).toEqual([
156
+ [
157
+ {
158
+ page: nextPage,
159
+ pageSize: 50,
160
+ sort: { columnId: 'name', direction: 'ascending' },
161
+ filters: { status: 'failed' },
162
+ cause: 'pageSize',
163
+ },
164
+ ],
165
+ ]);
166
+ expect(renderedIds()).toHaveLength(20);
167
+ });
168
+
169
+ it('reports one complete resize query for an empty server result', async () => {
170
+ const user = userEvent.setup();
171
+ const calls: string[] = [];
172
+ const onPageSizeChange = vi.fn(() => calls.push('size'));
173
+ const onPageChange = vi.fn(() => calls.push('page'));
174
+ const onQueryChange = vi.fn(() => calls.push('query'));
175
+ render(
176
+ <DataTable
177
+ {...server}
178
+ rows={[]}
179
+ rowCount={0}
180
+ page={1}
181
+ sort={{ columnId: 'name', direction: 'ascending' }}
182
+ filters={{ status: 'failed' }}
183
+ onPageSizeChange={onPageSizeChange}
184
+ onPageChange={onPageChange}
185
+ onQueryChange={onQueryChange}
186
+ />,
187
+ );
188
+ await user.click(screen.getByRole('combobox', { name: 'Rows per page' }));
189
+ await user.click(await screen.findByRole('option', { name: '50' }));
190
+ expect(onQueryChange.mock.calls).toEqual([
191
+ [
192
+ {
193
+ page: 1,
194
+ pageSize: 50,
195
+ sort: { columnId: 'name', direction: 'ascending' },
196
+ filters: { status: 'failed' },
197
+ cause: 'pageSize',
198
+ },
199
+ ],
200
+ ]);
201
+ expect(onPageSizeChange.mock.calls).toEqual([[50]]);
202
+ expect(onPageChange.mock.calls).toEqual([[1]]);
203
+ expect(calls).toEqual(['size', 'page', 'query']);
204
+ });
205
+
94
206
  it('requests a new size and only the footer keep-first-row page, without slicing', async () => {
95
207
  const user = userEvent.setup();
96
208
  const onPageChange = vi.fn();
@@ -104,17 +216,85 @@ describe('DataTable controlled server pagination', () => {
104
216
  expect(summary()).toHaveTextContent('21–40 of 95');
105
217
  });
106
218
 
107
- it.each([false, true])('has inert headers even with controlled sort and resizable=%s', async (resizable) => {
219
+ it.each([false, true])('requests server sorting without reordering rows, resizable=%s', async (resizable) => {
108
220
  const user = userEvent.setup();
109
221
  const onSortChange = vi.fn();
222
+ const onPageChange = vi.fn();
110
223
  render(
224
+ <DataTable {...server} page={1} resizable={resizable} onSortChange={onSortChange} onPageChange={onPageChange} />,
225
+ );
226
+ const before = renderedIds();
227
+ await user.click(screen.getByRole('button', { name: 'Name' }));
228
+ expect(onSortChange.mock.calls).toEqual([[{ columnId: 'name', direction: 'ascending' }]]);
229
+ expect(screen.getByRole('columnheader', { name: /^Name/ })).toHaveAttribute('aria-sort', 'ascending');
230
+ await user.click(screen.getByRole('button', { name: 'Name' }));
231
+ expect(onSortChange.mock.calls).toEqual([
232
+ [{ columnId: 'name', direction: 'ascending' }],
233
+ [{ columnId: 'name', direction: 'descending' }],
234
+ ]);
235
+ expect(screen.getByRole('columnheader', { name: /^Name/ })).toHaveAttribute('aria-sort', 'descending');
236
+ expect(renderedIds()).toEqual(before);
237
+ expect(onPageChange).not.toHaveBeenCalled();
238
+ });
239
+
240
+ it.each([false, true])('reports the next sort and first page with query-only=%s', (queryOnly) => {
241
+ const calls: string[] = [];
242
+ const onSortChange = vi.fn(() => calls.push('sort'));
243
+ const onPageChange = vi.fn(() => calls.push('page'));
244
+ const onQueryChange = vi.fn(() => calls.push('query'));
245
+ const filters = { status: 'failed' };
246
+ render(
247
+ <DataTable
248
+ {...server}
249
+ page={3}
250
+ filters={filters}
251
+ onSortChange={queryOnly ? undefined : onSortChange}
252
+ onPageChange={onPageChange}
253
+ onQueryChange={onQueryChange}
254
+ />,
255
+ );
256
+ fireEvent.click(screen.getByRole('button', { name: 'Name' }));
257
+ expect(onPageChange.mock.calls).toEqual([[1]]);
258
+ expect(onQueryChange.mock.calls).toEqual([
259
+ [
260
+ {
261
+ page: 1,
262
+ pageSize: 20,
263
+ sort: { columnId: 'name', direction: 'ascending' },
264
+ filters: { status: 'failed' },
265
+ cause: 'sort',
266
+ },
267
+ ],
268
+ ]);
269
+ expect(calls).toEqual(queryOnly ? ['page', 'query'] : ['sort', 'page', 'query']);
270
+ expect(screen.getByRole('columnheader', { name: /^Name/ })).toHaveAttribute('aria-sort', 'ascending');
271
+ });
272
+
273
+ it('keeps controlled sort until the consumer updates it', () => {
274
+ const onSortChange = vi.fn();
275
+ const onQueryChange = vi.fn();
276
+ const { rerender } = render(
277
+ <DataTable {...server} page={1} sort={null} onSortChange={onSortChange} onQueryChange={onQueryChange} />,
278
+ );
279
+ fireEvent.click(screen.getByRole('button', { name: 'Name' }));
280
+ expect(onSortChange.mock.calls).toEqual([[{ columnId: 'name', direction: 'ascending' }]]);
281
+ expect(screen.getByRole('columnheader', { name: /^Name/ })).toHaveAttribute('aria-sort', 'none');
282
+ rerender(
111
283
  <DataTable
112
284
  {...server}
113
- resizable={resizable}
114
- sort={{ columnId: 'id', direction: 'ascending' }}
285
+ page={1}
286
+ sort={{ columnId: 'name', direction: 'ascending' }}
115
287
  onSortChange={onSortChange}
288
+ onQueryChange={onQueryChange}
116
289
  />,
117
290
  );
291
+ expect(screen.getByRole('columnheader', { name: /^Name/ })).toHaveAttribute('aria-sort', 'ascending');
292
+ expect(onQueryChange).toHaveBeenCalledTimes(1);
293
+ });
294
+
295
+ it.each([false, true])('has plain headers without sort handlers and resizable=%s', async (resizable) => {
296
+ const user = userEvent.setup();
297
+ render(<DataTable {...server} resizable={resizable} sort={{ columnId: 'id', direction: 'ascending' }} />);
118
298
  const before = renderedIds();
119
299
  for (const header of screen.getAllByRole('columnheader')) {
120
300
  expect(header).not.toHaveAttribute('aria-sort');
@@ -124,30 +304,70 @@ describe('DataTable controlled server pagination', () => {
124
304
  fireEvent.keyDown(header, { key: 'Enter' });
125
305
  }
126
306
  expect(renderedIds()).toEqual(before);
127
- expect(onSortChange).not.toHaveBeenCalled();
128
307
  });
129
308
 
130
- it('applying a sorted saved view does not request a sort or page', async () => {
309
+ it('keeps the server page when a saved view changes an unhandled sort', async () => {
131
310
  const user = userEvent.setup();
132
- const onSortChange = vi.fn();
133
311
  const onPageChange = vi.fn();
134
312
  render(
135
313
  <DataTable
136
314
  {...server}
137
315
  defaultViews={[{ id: 'saved', name: 'Saved', state: { sort: { columnId: 'id', direction: 'ascending' } } }]}
138
- onSortChange={onSortChange}
139
316
  onPageChange={onPageChange}
140
317
  />,
141
318
  );
142
- const before = renderedIds();
143
319
  await user.click(screen.getByRole('button', { name: 'Default view' }));
144
320
  await user.click(await screen.findByRole('menuitemradio', { name: 'Saved' }));
145
- expect(renderedIds()).toEqual(before);
146
321
  expect(onPageChange).not.toHaveBeenCalled();
147
- expect(onSortChange).not.toHaveBeenCalled();
148
- expect(summary()).toHaveTextContent('21–40 of 95');
322
+ expect(screen.getByRole('button', { name: 'Page 2', current: 'page' })).toBeInTheDocument();
149
323
  });
150
324
 
325
+ it.each([
326
+ { savedSort: { columnId: 'id', direction: 'ascending' as const }, page: 2, expectedPage: 1, changed: true },
327
+ { savedSort: { columnId: 'name', direction: 'ascending' as const }, page: 2, expectedPage: 2, changed: false },
328
+ { savedSort: null, page: 2, expectedPage: 1, changed: true },
329
+ { savedSort: { columnId: 'id', direction: 'ascending' as const }, page: 1, expectedPage: 1, changed: true },
330
+ ])(
331
+ 'applies saved sort $savedSort at page $page with the view filters',
332
+ async ({ savedSort, page, expectedPage, changed }) => {
333
+ const user = userEvent.setup();
334
+ const calls: string[] = [];
335
+ const onSortChange = vi.fn(() => calls.push('sort'));
336
+ const onPageChange = vi.fn(() => calls.push('page'));
337
+ const onFiltersChange = vi.fn(() => calls.push('filters'));
338
+ const onQueryChange = vi.fn(() => calls.push('query'));
339
+ render(
340
+ <DataTable
341
+ {...server}
342
+ page={page}
343
+ defaultSort={{ columnId: 'name', direction: 'ascending' }}
344
+ filters={{ status: 'active' }}
345
+ defaultViews={[{ id: 'saved', name: 'Saved', state: { sort: savedSort, filters: { status: 'failed' } } }]}
346
+ onSortChange={onSortChange}
347
+ onPageChange={onPageChange}
348
+ onFiltersChange={onFiltersChange}
349
+ onQueryChange={onQueryChange}
350
+ />,
351
+ );
352
+ const before = renderedIds();
353
+ await user.click(screen.getByRole('button', { name: 'Default view' }));
354
+ await user.click(await screen.findByRole('menuitemradio', { name: 'Saved' }));
355
+ expect(renderedIds()).toEqual(before);
356
+ expect(onSortChange.mock.calls).toEqual(changed && savedSort ? [[savedSort]] : []);
357
+ expect(onPageChange.mock.calls).toEqual(changed && page !== 1 ? [[1]] : []);
358
+ expect(onFiltersChange.mock.calls).toEqual([[{ status: 'failed' }]]);
359
+ expect(onQueryChange.mock.calls).toEqual([
360
+ [{ page: expectedPage, pageSize: 20, sort: savedSort, filters: { status: 'failed' }, cause: 'view' }],
361
+ ]);
362
+ expect(calls).toEqual([
363
+ ...(changed && savedSort ? ['sort'] : []),
364
+ 'filters',
365
+ ...(changed && page !== 1 ? ['page'] : []),
366
+ 'query',
367
+ ]);
368
+ },
369
+ );
370
+
151
371
  it.each([1, 3])('keeps an empty server footer at page 1 without callbacks for supplied page %s', (page) => {
152
372
  const onPageChange = vi.fn();
153
373
  const onPageSizeChange = vi.fn();
@@ -171,3 +391,97 @@ describe('DataTable controlled server pagination', () => {
171
391
  expect(onPageSizeChange).not.toHaveBeenCalled();
172
392
  });
173
393
  });
394
+
395
+ it('server pagination example sorts through its query handler and stays accessible', async () => {
396
+ const user = userEvent.setup();
397
+ const { container } = render(<ServerPaginationExample />);
398
+ await user.click(screen.getByRole('button', { name: 'Name' }));
399
+ expect(screen.getByRole('columnheader', { name: 'Name' })).toHaveAttribute('aria-sort', 'ascending');
400
+ await user.click(screen.getByRole('button', { name: 'Name' }));
401
+ expect(screen.getByRole('columnheader', { name: 'Name' })).toHaveAttribute('aria-sort', 'descending');
402
+ expect(await screen.findByRole('checkbox', { name: 'Select 95' })).toBeInTheDocument();
403
+ expect(screen.getByRole('button', { name: 'Page 1', current: 'page' })).toBeInTheDocument();
404
+ await expectNoAxeViolations(container);
405
+ });
406
+
407
+ it.each(['success', 'failure'])(
408
+ 'server pagination example ignores an older %s after a newer query completes',
409
+ async (outcome) => {
410
+ type Response = {
411
+ items: Array<{ id: number; name: string; locked: boolean }>;
412
+ total: number;
413
+ page: number;
414
+ pageSize: number;
415
+ sort: DataTableQuery['sort'];
416
+ };
417
+ const pending: Array<{ resolve: () => void; reject: () => void }> = [];
418
+ const request = (query: DataTableQuery) =>
419
+ new Promise<Response>((resolve, reject) => {
420
+ pending.push({
421
+ resolve: () =>
422
+ resolve({
423
+ items: [{ id: query.sort?.direction === 'descending' ? 95 : 1, name: 'Result', locked: false }],
424
+ total: 95,
425
+ page: query.page,
426
+ pageSize: query.pageSize,
427
+ sort: query.sort,
428
+ }),
429
+ reject: () => reject(new Error('Request failed')),
430
+ });
431
+ });
432
+ render(<ServerPaginationExample request={request} />);
433
+ await act(async () => pending[0]!.resolve());
434
+ fireEvent.click(screen.getByRole('button', { name: 'Name' }));
435
+ fireEvent.click(screen.getByRole('button', { name: 'Name' }));
436
+ await act(async () => pending[2]!.resolve());
437
+ expect(screen.getByRole('checkbox', { name: 'Select 95' })).toBeInTheDocument();
438
+ await act(async () => {
439
+ if (outcome === 'success') pending[1]!.resolve();
440
+ else pending[1]!.reject();
441
+ });
442
+ expect(screen.getByRole('checkbox', { name: 'Select 95' })).toBeInTheDocument();
443
+ expect(screen.queryByRole('checkbox', { name: 'Select 1' })).not.toBeInTheDocument();
444
+ expect(screen.getByRole('columnheader', { name: 'Name' })).toHaveAttribute('aria-sort', 'descending');
445
+ },
446
+ );
447
+
448
+ it('server pagination example restores the latest confirmed sort when a request fails before rerender', async () => {
449
+ const confirmed = {
450
+ items: [{ id: 1, name: 'Item 1', locked: false }],
451
+ total: 95,
452
+ page: 1,
453
+ pageSize: 20,
454
+ sort: { columnId: 'name', direction: 'ascending' as const },
455
+ };
456
+ let confirm!: () => void;
457
+ let fail!: () => void;
458
+ const request = vi
459
+ .fn<() => Promise<Omit<typeof confirmed, 'sort'> & { sort: DataTableQuery['sort'] }>>()
460
+ .mockResolvedValueOnce({ ...confirmed, items: [{ id: 21, name: 'Item 21', locked: false }], page: 2, sort: null })
461
+ .mockImplementationOnce(
462
+ () =>
463
+ new Promise((resolve) => {
464
+ confirm = () => resolve(confirmed);
465
+ }),
466
+ )
467
+ .mockImplementationOnce(
468
+ () =>
469
+ new Promise((_, reject) => {
470
+ fail = () => reject(new Error('Request failed'));
471
+ }),
472
+ );
473
+ render(<ServerPaginationExample request={request} />);
474
+ await screen.findByRole('checkbox', { name: 'Select 21' });
475
+ fireEvent.click(screen.getByRole('button', { name: 'Name' }));
476
+ await act(async () => {
477
+ confirm();
478
+ // The adapter maps the envelope before the hook settles it.
479
+ await Promise.resolve();
480
+ await Promise.resolve();
481
+ // Requests start only after commit; reject immediately after committing this query.
482
+ flushSync(() => fireEvent.click(screen.getByRole('button', { name: 'Name' })));
483
+ fail();
484
+ });
485
+ expect(screen.getByRole('columnheader', { name: 'Name' })).toHaveAttribute('aria-sort', 'ascending');
486
+ expect(screen.getByRole('checkbox', { name: 'Select 1' })).toBeInTheDocument();
487
+ });
@@ -1,4 +1,4 @@
1
- import { render, screen, within } from '@testing-library/react';
1
+ import { fireEvent, render, screen, within } from '@testing-library/react';
2
2
  import userEvent from '@testing-library/user-event';
3
3
  import { DensityProvider } from '@gntik-ai/ui';
4
4
  import { expectNoAxeViolations } from '../../test/a11y';
@@ -41,6 +41,90 @@ describe('DataTable', () => {
41
41
  expect(head).toHaveAttribute('aria-sort', 'descending');
42
42
  });
43
43
 
44
+ it('reports a client sort synchronously with the internal first page', () => {
45
+ const onQueryChange = vi.fn();
46
+ render(<DataTable defaultPageSize={5} filters={{ status: 'failed' }} onQueryChange={onQueryChange} />);
47
+ fireEvent.click(screen.getByRole('button', { name: 'Next page' }));
48
+ onQueryChange.mockClear();
49
+ fireEvent.click(screen.getByRole('button', { name: /Cost/ }));
50
+ expect(onQueryChange.mock.calls).toEqual([
51
+ [
52
+ {
53
+ page: 1,
54
+ pageSize: 5,
55
+ sort: { columnId: 'cost', direction: 'ascending' },
56
+ filters: { status: 'failed' },
57
+ cause: 'sort',
58
+ },
59
+ ],
60
+ ]);
61
+ expect(screen.getByRole('button', { name: 'Page 1', current: 'page' })).toBeInTheDocument();
62
+ });
63
+
64
+ it('reports each client page with its internal page size', () => {
65
+ const onQueryChange = vi.fn();
66
+ render(<DataTable defaultPageSize={5} onQueryChange={onQueryChange} />);
67
+ fireEvent.click(screen.getByRole('button', { name: 'Next page' }));
68
+ fireEvent.click(screen.getByRole('button', { name: 'Next page' }));
69
+ expect(onQueryChange.mock.calls).toEqual([
70
+ [{ page: 2, pageSize: 5, sort: null, filters: undefined, cause: 'page' }],
71
+ [{ page: 3, pageSize: 5, sort: null, filters: undefined, cause: 'page' }],
72
+ ]);
73
+ });
74
+
75
+ it('reports one client resize query with the keep-first-row page, then uses the new size', async () => {
76
+ const user = userEvent.setup();
77
+ const onQueryChange = vi.fn();
78
+ render(<DataTable defaultPageSize={5} pageSizeOptions={[5, 10, 20]} onQueryChange={onQueryChange} />);
79
+ fireEvent.click(screen.getByRole('button', { name: 'Page 3' }));
80
+ onQueryChange.mockClear();
81
+ await user.click(screen.getByRole('combobox', { name: 'Rows per page' }));
82
+ await user.click(await screen.findByRole('option', { name: '10' }));
83
+ expect(onQueryChange.mock.calls).toEqual([
84
+ [{ page: 2, pageSize: 10, sort: null, filters: undefined, cause: 'pageSize' }],
85
+ ]);
86
+ expect(screen.getByRole('button', { name: 'Page 2', current: 'page' })).toBeInTheDocument();
87
+ fireEvent.click(screen.getByRole('button', { name: 'Next page' }));
88
+ expect(onQueryChange.mock.calls[1]).toEqual([
89
+ { page: 3, pageSize: 10, sort: null, filters: undefined, cause: 'page' },
90
+ ]);
91
+ expect(onQueryChange).toHaveBeenCalledTimes(2);
92
+ });
93
+
94
+ it('reports a client saved view with restored filters and page 1', async () => {
95
+ const user = userEvent.setup();
96
+ const onQueryChange = vi.fn();
97
+ render(
98
+ <DataTable
99
+ filters={{ status: 'active' }}
100
+ defaultViews={[
101
+ {
102
+ id: 'saved',
103
+ name: 'Saved',
104
+ state: { sort: { columnId: 'cost', direction: 'descending' }, filters: { status: 'failed' } },
105
+ },
106
+ ]}
107
+ onQueryChange={onQueryChange}
108
+ />,
109
+ );
110
+ fireEvent.click(screen.getByRole('button', { name: 'Next page' }));
111
+ onQueryChange.mockClear();
112
+ await user.click(screen.getByRole('button', { name: 'Default view' }));
113
+ await user.click(await screen.findByRole('menuitemradio', { name: 'Saved' }));
114
+ expect(onQueryChange.mock.calls).toEqual([
115
+ [
116
+ {
117
+ page: 1,
118
+ pageSize: 10,
119
+ sort: { columnId: 'cost', direction: 'descending' },
120
+ filters: { status: 'failed' },
121
+ cause: 'view',
122
+ },
123
+ ],
124
+ ]);
125
+ expect(screen.getByRole('button', { name: 'Page 1', current: 'page' })).toBeInTheDocument();
126
+ });
127
+
44
128
  it('selects rows, with select-all and indeterminate', async () => {
45
129
  const user = userEvent.setup();
46
130
  const onSelectionChange = vi.fn();