@gntik-ai/blocks 0.11.0 → 0.12.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 (182) hide show
  1. package/dist/index.d.ts +1501 -1232
  2. package/dist/index.js +1884 -836
  3. package/dist/index.js.map +1 -1
  4. package/package.json +6 -6
  5. package/src/ai/PromptEditor/PromptEditor.tsx +2 -2
  6. package/src/ai/PromptEditor/examples/controlled-variables.tsx +1 -1
  7. package/src/ai/TraceWaterfall/TraceWaterfall.tsx +2 -2
  8. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.test.tsx +6 -0
  9. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.tsx +4 -1
  10. package/src/auth/ForgotPasswordForm/block.meta.ts +1 -1
  11. package/src/auth/ForgotPasswordForm/examples/LargeFields.tsx +6 -0
  12. package/src/auth/MfaChallenge/MfaChallenge.test.tsx +9 -0
  13. package/src/auth/MfaChallenge/MfaChallenge.tsx +5 -2
  14. package/src/auth/MfaChallenge/block.meta.ts +1 -1
  15. package/src/auth/MfaChallenge/examples/LargeFields.tsx +6 -0
  16. package/src/auth/ResetPasswordForm/ResetPasswordForm.test.tsx +7 -0
  17. package/src/auth/ResetPasswordForm/ResetPasswordForm.tsx +5 -3
  18. package/src/auth/ResetPasswordForm/block.meta.ts +1 -1
  19. package/src/auth/ResetPasswordForm/examples/LargeFields.tsx +6 -0
  20. package/src/auth/SignInForm/SignInForm.test.tsx +7 -0
  21. package/src/auth/SignInForm/SignInForm.tsx +5 -1
  22. package/src/auth/SignInForm/block.meta.ts +1 -1
  23. package/src/auth/SignInForm/examples/LargeFields.tsx +6 -0
  24. package/src/auth/SignUpForm/SignUpForm.test.tsx +22 -0
  25. package/src/auth/SignUpForm/SignUpForm.tsx +7 -1
  26. package/src/auth/SignUpForm/block.meta.ts +1 -1
  27. package/src/auth/SignUpForm/examples/LargeFields.tsx +6 -0
  28. package/src/auth/__snapshots__/field-size.test.tsx.snap +11 -0
  29. package/src/auth/field-size.test.tsx +21 -0
  30. package/src/auth/large-examples.test.tsx +30 -0
  31. package/src/auth/shared.tsx +7 -2
  32. package/src/billing/PaymentMethodCard/PaymentMethodCard.tsx +1 -1
  33. package/src/billing/PlanCard/PlanCard.baseline.test.tsx +3 -2
  34. package/src/billing/PlanCard/__snapshots__/PlanCard.baseline.test.tsx.snap +2 -2
  35. package/src/billing/PlanDefinitionCard/examples/Compact.tsx +1 -4
  36. package/src/billing/PlanDefinitionCard/examples/Full.tsx +1 -4
  37. package/src/builders/CodePanel/CodePanel.tsx +2 -2
  38. package/src/builders/FlowBuilder/FlowBuilder.tsx +4 -19
  39. package/src/builders/FlowBuilder/parts.tsx +4 -4
  40. package/src/builders/LogViewer/LogViewer.follow.test.tsx +29 -0
  41. package/src/builders/LogViewer/LogViewer.test.tsx +24 -0
  42. package/src/builders/LogViewer/LogViewer.tsx +67 -20
  43. package/src/builders/LogViewer/block.meta.ts +2 -1
  44. package/src/builders/LogViewer/examples/Spanish.tsx +2 -1
  45. package/src/data-display/ActivityFeed/ActivityFeed.tsx +1 -1
  46. package/src/data-display/ChartCard/ChartCard.tsx +2 -2
  47. package/src/data-display/ChartCard/examples/ContainerPanel.tsx +16 -0
  48. package/src/data-display/CommentThread/CommentThread.test.tsx +70 -1
  49. package/src/data-display/CommentThread/CommentThread.tsx +22 -6
  50. package/src/data-display/CommentThread/block.meta.ts +1 -1
  51. package/src/data-display/CommentThread/examples/RenderedBody.tsx +20 -0
  52. package/src/data-display/DescriptionListCard/DescriptionListCard.test.tsx +24 -1
  53. package/src/data-display/DescriptionListCard/DescriptionListCard.tsx +14 -20
  54. package/src/data-display/DescriptionListCard/block.meta.ts +2 -1
  55. package/src/data-display/DescriptionListCard/examples/Spanish.tsx +2 -1
  56. package/src/data-display/KpiRow/KpiRow.doc.ts +14 -0
  57. package/src/data-display/KpiRow/KpiRow.test.tsx +11 -0
  58. package/src/data-display/KpiRow/KpiRow.tsx +72 -55
  59. package/src/data-display/KpiRow/examples/ContainerPanel.tsx +47 -0
  60. package/src/data-display/ResourceCardGrid/ResourceCardGrid.doc.ts +19 -0
  61. package/src/data-display/ResourceCardGrid/ResourceCardGrid.test.tsx +13 -0
  62. package/src/data-display/ResourceCardGrid/ResourceCardGrid.tsx +49 -40
  63. package/src/data-display/ResourceCardGrid/examples/ContainerPanel.tsx +18 -0
  64. package/src/data-display/StatusTimeline/StatusTimeline.tsx +1 -1
  65. package/src/feedback/EmptyStates/EmptyStates.test.tsx +42 -0
  66. package/src/feedback/EmptyStates/EmptyStates.tsx +5 -3
  67. package/src/feedback/EmptyStates/block.meta.ts +1 -1
  68. package/src/feedback/EmptyStates/examples/HiddenAction.tsx +13 -0
  69. package/src/feedback/ErrorPanel/ErrorPanel.tsx +13 -15
  70. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.lifecycle.test.tsx +123 -0
  71. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.tsx +128 -139
  72. package/src/forms/CreateApiKeyDialog/block.meta.ts +12 -1
  73. package/src/forms/FileUploadPanel/FileUploadPanel.controlled.test.tsx +482 -0
  74. package/src/forms/FileUploadPanel/FileUploadPanel.drag.test.tsx +60 -0
  75. package/src/forms/FileUploadPanel/FileUploadPanel.lifecycle.test.tsx +165 -0
  76. package/src/forms/FileUploadPanel/FileUploadPanel.tsx +267 -69
  77. package/src/forms/FileUploadPanel/block.meta.ts +5 -1
  78. package/src/forms/FileUploadPanel/examples/AutoCancel.tsx +38 -0
  79. package/src/forms/FileUploadPanel/examples/Labels.tsx +1 -1
  80. package/src/forms/FileUploadPanel/examples/ManualForm.tsx +36 -0
  81. package/src/forms/FileUploadPanel/fixtures.ts +31 -16
  82. package/src/forms/FileUploadPanel/simulate-upload.test.ts +24 -0
  83. package/src/forms/FormSection/FormSection.test.tsx +11 -0
  84. package/src/forms/FormSection/FormSection.tsx +20 -22
  85. package/src/forms/FormSection/block.meta.ts +1 -1
  86. package/src/forms/FormSection/examples/ContainerPanel.tsx +16 -0
  87. package/src/forms/InviteMembersDialog/InviteMembersDialog.lifecycle.test.tsx +80 -0
  88. package/src/forms/InviteMembersDialog/InviteMembersDialog.tsx +90 -109
  89. package/src/forms/InviteMembersDialog/block.meta.ts +1 -1
  90. package/src/forms/ValidationSummary/ValidationSummary.tsx +1 -4
  91. package/src/hooks/index.ts +2 -0
  92. package/src/hooks/useTableData.integration.test.tsx +89 -0
  93. package/src/hooks/useTableData.test.tsx +613 -0
  94. package/src/hooks/useTableData.ts +377 -0
  95. package/src/index.ts +1 -0
  96. package/src/marketing/ComparisonTable/ComparisonTable.tsx +2 -2
  97. package/src/marketing/FeatureGrid/FeatureGrid.tsx +1 -1
  98. package/src/marketing/LogoCloud/LogoCloud.doc.ts +13 -0
  99. package/src/marketing/LogoCloud/LogoCloud.test.tsx +155 -0
  100. package/src/marketing/LogoCloud/LogoCloud.tsx +89 -0
  101. package/src/marketing/LogoCloud/block.meta.ts +10 -0
  102. package/src/marketing/LogoCloud/examples/CaptionStart.tsx +6 -0
  103. package/src/marketing/LogoCloud/examples/Custom.tsx +25 -0
  104. package/src/marketing/LogoCloud/examples/Empty.tsx +6 -0
  105. package/src/marketing/LogoCloud/examples/Grid.tsx +13 -0
  106. package/src/marketing/LogoCloud/examples/Row.tsx +6 -0
  107. package/src/marketing/LogoCloud/examples/UnderHero.tsx +13 -0
  108. package/src/marketing/LogoCloud/fixtures.ts +23 -0
  109. package/src/marketing/PricingTable/PricingTable.tsx +1 -1
  110. package/src/marketing/SiteFooter/SiteFooter.doc.ts +18 -0
  111. package/src/marketing/SiteFooter/SiteFooter.test.tsx +236 -0
  112. package/src/marketing/SiteFooter/SiteFooter.tsx +160 -0
  113. package/src/marketing/SiteFooter/block.meta.ts +10 -0
  114. package/src/marketing/SiteFooter/examples/Centered.tsx +15 -0
  115. package/src/marketing/SiteFooter/examples/Columns.tsx +15 -0
  116. package/src/marketing/SiteFooter/examples/Custom.tsx +35 -0
  117. package/src/marketing/SiteFooter/examples/Empty.tsx +6 -0
  118. package/src/marketing/SiteFooter/examples/Simple.tsx +14 -0
  119. package/src/marketing/SiteFooter/fixtures.ts +36 -0
  120. package/src/marketing/index.ts +6 -0
  121. package/src/page-chrome/PageHeader/EditableTitle.test.tsx +26 -0
  122. package/src/page-chrome/PageHeader/PageHeader.tsx +4 -4
  123. package/src/page-chrome/PageHeader/block.meta.ts +1 -1
  124. package/src/page-chrome/PageHeader/examples/ContainerPanel.tsx +16 -0
  125. package/src/page-chrome/PageHeader/examples/EditableTitle.tsx +23 -0
  126. package/src/page-chrome/StickyActionBar/StickyActionBar.tsx +1 -1
  127. package/src/scheduling/AgendaList/AgendaList.tsx +39 -15
  128. package/src/scheduling/AgendaList/AgendaListZone.test.tsx +38 -0
  129. package/src/scheduling/AgendaList/block.meta.ts +1 -1
  130. package/src/scheduling/AgendaList/examples/TimeZone.tsx +28 -0
  131. package/src/scheduling/MonthCalendar/MonthCalendar.tsx +51 -40
  132. package/src/scheduling/MonthCalendar/MonthCalendarZone.test.tsx +44 -0
  133. package/src/scheduling/MonthCalendar/block.meta.ts +1 -1
  134. package/src/scheduling/MonthCalendar/examples/TimeZone.tsx +28 -0
  135. package/src/scheduling/WeekCalendar/WeekCalendar.tsx +37 -28
  136. package/src/scheduling/WeekCalendar/WeekCalendarZone.test.tsx +41 -0
  137. package/src/scheduling/WeekCalendar/block.meta.ts +1 -1
  138. package/src/scheduling/WeekCalendar/examples/TimeZone.tsx +28 -0
  139. package/src/scheduling/shared/CalendarHeader.tsx +26 -1
  140. package/src/scheduling/shared/dates.ts +102 -58
  141. package/src/scheduling/shared/events.ts +2 -2
  142. package/src/shell/AppSidebar/AppSidebar.context.test.tsx +175 -0
  143. package/src/shell/AppSidebar/AppSidebar.doc.ts +29 -0
  144. package/src/shell/AppSidebar/AppSidebar.tsx +97 -25
  145. package/src/shell/AppSidebar/block.meta.ts +1 -1
  146. package/src/shell/GlobalSearch/GlobalSearch.test.tsx +1 -0
  147. package/src/shell/GlobalSearch/GlobalSearch.tsx +1 -1
  148. package/src/tables/DataTable/DataTable.cursor-example.test.tsx +67 -0
  149. package/src/tables/DataTable/DataTable.export.test.tsx +511 -0
  150. package/src/tables/DataTable/DataTable.inline-edit-focus.test.tsx +32 -0
  151. package/src/tables/DataTable/DataTable.layout.test.tsx +6 -5
  152. package/src/tables/DataTable/DataTable.link-actions.test.tsx +18 -0
  153. package/src/tables/DataTable/DataTable.server-pagination.test.tsx +328 -14
  154. package/src/tables/DataTable/DataTable.test.tsx +85 -1
  155. package/src/tables/DataTable/DataTable.tsx +108 -14
  156. package/src/tables/DataTable/block.meta.ts +11 -1
  157. package/src/tables/DataTable/column-sizing.ts +2 -2
  158. package/src/tables/DataTable/data-table-props.ts +29 -1
  159. package/src/tables/DataTable/data-table-row.tsx +2 -2
  160. package/src/tables/DataTable/data-table-utils.ts +4 -0
  161. package/src/tables/DataTable/editable-cell.tsx +20 -79
  162. package/src/tables/DataTable/examples/csv-export.tsx +74 -0
  163. package/src/tables/DataTable/examples/cursor-load-more.tsx +87 -0
  164. package/src/tables/DataTable/examples/server-pagination.tsx +47 -40
  165. package/src/tables/DataTable/export-menu.tsx +58 -0
  166. package/src/tables/DataTable/header-cell.tsx +1 -1
  167. package/src/tables/DataTable/labels.ts +7 -0
  168. package/src/tables/DataTable/resize-handle.tsx +2 -2
  169. package/src/tables/DataTable/use-table-export.ts +117 -0
  170. package/src/tables/FilterBar/FilterBar.test.tsx +12 -0
  171. package/src/tables/FilterBar/FilterBar.tsx +5 -7
  172. package/src/team/ProfileHeader/ProfileHeader.picker.test.tsx +34 -0
  173. package/src/team/ProfileHeader/ProfileHeader.test.tsx +2 -2
  174. package/src/team/ProfileHeader/ProfileHeader.tsx +17 -24
  175. package/src/team/ProfileHeader/block.meta.ts +1 -1
  176. package/src/test/OptInDefaults.test.tsx +10 -1
  177. package/src/test/clipboard-fallback.test.tsx +49 -0
  178. package/src/test/copy-examples.test.tsx +29 -0
  179. package/src/test/copy-feedback.test.tsx +166 -0
  180. package/src/test/fixtures/opt-in-defaults.json +5 -5
  181. package/src/test/without-forced-colors.test.ts +44 -0
  182. package/src/test/without-forced-colors.ts +14 -0
@@ -0,0 +1,511 @@
1
+ import { act, fireEvent, render, screen, waitFor } from '@testing-library/react';
2
+ import userEvent from '@testing-library/user-event';
3
+ import { downloadFile, I18nProvider } from '@gntik-ai/ui';
4
+ import { DataTable } from './DataTable';
5
+ import type { DataTableColumn } from './data-table-utils';
6
+ import { expectNoAxeViolations } from '../../test/a11y';
7
+ import CsvExportExample from './examples/csv-export';
8
+
9
+ vi.mock('@gntik-ai/ui', async (original) => ({
10
+ ...(await original<typeof import('@gntik-ai/ui')>()),
11
+ downloadFile: vi.fn(),
12
+ }));
13
+
14
+ const rows = Array.from({ length: 95 }, (_, index) => ({ id: String(index + 1), name: `Item ${index + 1}` }));
15
+ type Row = (typeof rows)[number];
16
+ const columns: DataTableColumn<Row>[] = [{ id: 'name', header: 'Name', accessor: (row) => row.name, sortable: true }];
17
+ const sort = { columnId: 'name', direction: 'descending' } as const;
18
+ let user: ReturnType<typeof userEvent.setup>;
19
+ let writeText: ReturnType<typeof vi.fn<(text: string) => Promise<void>>>;
20
+
21
+ beforeEach(() => {
22
+ vi.mocked(downloadFile).mockClear();
23
+ user = userEvent.setup();
24
+ writeText = vi.fn().mockResolvedValue(undefined);
25
+ Object.defineProperty(navigator, 'clipboard', { configurable: true, value: { writeText } });
26
+ });
27
+
28
+ async function choose(name: string) {
29
+ await user.click(screen.getByRole('button', { name: 'Export' }));
30
+ await user.click(await screen.findByRole('menuitem', { name }));
31
+ }
32
+
33
+ it('downloads every client row in sort order across pages with a caption filename and BOM', async () => {
34
+ render(<DataTable rows={rows} columns={columns} caption="Deployments" csvExport defaultSort={sort} />);
35
+ await choose('All rows (95)');
36
+ expect(downloadFile).toHaveBeenCalledOnce();
37
+ const expected = '\uFEFFName\r\n' + Array.from({ length: 95 }, (_, index) => `Item ${95 - index}`).join('\r\n');
38
+ expect(downloadFile).toHaveBeenCalledWith(expected, 'deployments.csv', 'text/csv;charset=utf-8');
39
+ });
40
+
41
+ it('exports the current page and selections spanning pages in sort order', async () => {
42
+ render(<DataTable rows={rows} columns={columns} csvExport defaultSort={sort} />);
43
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 95' }));
44
+ await user.click(screen.getByRole('button', { name: 'Next page' }));
45
+ await user.click(screen.getByRole('checkbox', { name: 'Select Item 85' }));
46
+ await choose('Current page');
47
+ expect(downloadFile).toHaveBeenLastCalledWith(
48
+ '\uFEFFName\r\nItem 85\r\nItem 84\r\nItem 83\r\nItem 82\r\nItem 81\r\nItem 80\r\nItem 79\r\nItem 78\r\nItem 77\r\nItem 76',
49
+ 'table.csv',
50
+ 'text/csv;charset=utf-8',
51
+ );
52
+ await choose('Selected rows (2)');
53
+ expect(downloadFile).toHaveBeenLastCalledWith(
54
+ '\uFEFFName\r\nItem 95\r\nItem 85',
55
+ 'table.csv',
56
+ 'text/csv;charset=utf-8',
57
+ );
58
+ });
59
+
60
+ it('resolves an exclude selection and respects allowed scopes and filenames', async () => {
61
+ render(
62
+ <DataTable
63
+ rows={rows.slice(0, 3)}
64
+ columns={columns}
65
+ caption=""
66
+ csvExport={{ scopes: ['selected'] }}
67
+ selectionModel={{ type: 'exclude', ids: ['2'] }}
68
+ />,
69
+ );
70
+ await user.click(screen.getByRole('button', { name: 'Export' }));
71
+ expect(screen.queryByRole('menuitem', { name: /All rows|Current page/ })).not.toBeInTheDocument();
72
+ await user.click(await screen.findByRole('menuitem', { name: 'Selected rows (2)' }));
73
+ expect(downloadFile).toHaveBeenLastCalledWith(
74
+ '\uFEFFName\r\nItem 1\r\nItem 3',
75
+ 'table.csv',
76
+ 'text/csv;charset=utf-8',
77
+ );
78
+ });
79
+
80
+ it('exports the selectedId in single mode', async () => {
81
+ render(
82
+ <DataTable
83
+ rows={rows}
84
+ columns={columns}
85
+ selectionMode="single"
86
+ legend="Choose item"
87
+ defaultSelectedId="15"
88
+ csvExport={{ fileName: 'chosen.csv' }}
89
+ />,
90
+ );
91
+ await choose('Selected rows (1)');
92
+ expect(downloadFile).toHaveBeenLastCalledWith('\uFEFFName\r\nItem 15', 'chosen.csv', 'text/csv;charset=utf-8');
93
+ });
94
+
95
+ it('hides selected actions until there is a selection', async () => {
96
+ render(<DataTable rows={rows} columns={columns} csvExport />);
97
+ await user.click(screen.getByRole('button', { name: 'Export' }));
98
+ expect(screen.queryByRole('menuitem', { name: /Selected rows|Copy selected/ })).not.toBeInTheDocument();
99
+ });
100
+
101
+ it('exports visible eligible columns in display order using raw values and exportValue', async () => {
102
+ const data = [
103
+ { id: '1', name: 'display', date: new Date('2026-10-17T08:30:00Z'), active: true, empty: null, number: 1234.5 },
104
+ ];
105
+ type Values = (typeof data)[number];
106
+ const valueColumns: DataTableColumn<Values>[] = [
107
+ { id: 'name', header: 'Name', accessor: (row) => row.name, exportValue: () => 'raw' },
108
+ { id: 'date', header: 'Date', accessor: (row) => row.date },
109
+ { id: 'active', header: 'Active', accessor: (row) => row.active },
110
+ { id: 'empty', header: 'Empty', accessor: (row) => row.empty },
111
+ { id: 'number', header: 'Number', accessor: (row) => row.number },
112
+ { id: 'computed', header: 'Computed', exportValue: () => 42 },
113
+ { id: 'hidden', header: 'Hidden', defaultHidden: true, accessor: () => 'omit' },
114
+ { id: 'private', header: 'Private', exportable: false, accessor: () => 'omit' },
115
+ { id: 'actions', header: 'Actions', cell: () => 'Open' },
116
+ ];
117
+ render(<DataTable rows={data} columns={valueColumns} pinnedColumns={{ left: ['computed'] }} csvExport />);
118
+ await choose('All rows (1)');
119
+ expect(downloadFile).toHaveBeenLastCalledWith(
120
+ '\uFEFFComputed,Name,Date,Active,Empty,Number\r\n42,raw,2026-10-17T08:30:00.000Z,true,,1234.5',
121
+ 'table.csv',
122
+ 'text/csv;charset=utf-8',
123
+ );
124
+ });
125
+
126
+ it.each(['rows', 'page', 'selected'] as const)(
127
+ 'delegates %s once with visible exported ids, selection, sort and filters',
128
+ async (scope) => {
129
+ const onExport = vi.fn();
130
+ const filters = { status: 'active' };
131
+ render(
132
+ <DataTable
133
+ rows={rows}
134
+ columns={[...columns, { id: 'private', header: 'Private', accessor: () => 'secret', exportable: false }]}
135
+ csvExport
136
+ onExport={onExport}
137
+ defaultSelectedIds={['2', '15']}
138
+ sort={sort}
139
+ filters={filters}
140
+ />,
141
+ );
142
+ await choose({ rows: 'All rows (95)', page: 'Current page', selected: 'Selected rows (2)' }[scope]);
143
+ expect(onExport).toHaveBeenCalledExactlyOnceWith({
144
+ scope,
145
+ columns: ['name'],
146
+ selectedIds: ['2', '15'],
147
+ sort,
148
+ filters,
149
+ });
150
+ expect(downloadFile).not.toHaveBeenCalled();
151
+ },
152
+ );
153
+
154
+ it('preserves keyboard focus while a delegated export is pending and after it settles', async () => {
155
+ let resolve!: () => void;
156
+ const onExport = vi.fn(
157
+ () =>
158
+ new Promise<void>((done) => {
159
+ resolve = done;
160
+ }),
161
+ );
162
+ render(<DataTable rows={rows} columns={columns} csvExport onExport={onExport} />);
163
+ const trigger = screen.getByRole('button', { name: 'Export' });
164
+ trigger.focus();
165
+ await user.keyboard('{Enter}');
166
+ await waitFor(() => expect(screen.getByRole('menuitem', { name: 'All rows (95)' })).toHaveFocus());
167
+ await user.keyboard('{Enter}');
168
+ expect(trigger).toHaveAttribute('aria-busy', 'true');
169
+ await waitFor(() => expect(trigger).toHaveFocus());
170
+ await user.keyboard('{Enter}');
171
+ await user.click(trigger);
172
+ expect(screen.queryByRole('menu')).not.toBeInTheDocument();
173
+ expect(onExport).toHaveBeenCalledOnce();
174
+ await act(async () => resolve());
175
+ expect(trigger).not.toHaveAttribute('aria-busy', 'true');
176
+ expect(trigger).toHaveFocus();
177
+ await choose('Current page');
178
+ expect(onExport).toHaveBeenCalledTimes(2);
179
+ await act(async () => resolve());
180
+ });
181
+
182
+ it('offers server export only with a delegate and reports the total count', async () => {
183
+ const props = {
184
+ rows: rows.slice(10, 20),
185
+ columns,
186
+ paginationMode: 'server' as const,
187
+ page: 2,
188
+ pageSize: 10,
189
+ rowCount: 95,
190
+ csvExport: true,
191
+ };
192
+ const { rerender } = render(<DataTable {...props} />);
193
+ expect(screen.queryByRole('button', { name: 'Export' })).not.toBeInTheDocument();
194
+ const onExport = vi.fn();
195
+ rerender(<DataTable {...props} onExport={onExport} selectedIds={['2', '15']} />);
196
+ await choose('All rows (95)');
197
+ expect(onExport).toHaveBeenCalledExactlyOnceWith({
198
+ scope: 'rows',
199
+ columns: ['name'],
200
+ selectedIds: ['2', '15'],
201
+ sort: null,
202
+ filters: undefined,
203
+ });
204
+ expect(downloadFile).not.toHaveBeenCalled();
205
+ });
206
+
207
+ it.each([
208
+ { type: 'include', ids: ['2', '15'] },
209
+ { type: 'exclude', ids: ['1'] },
210
+ ] as const)('does not offer partial clipboard data for a server selection: %j', async (selectionModel) => {
211
+ render(
212
+ <DataTable
213
+ rows={rows.slice(10, 20)}
214
+ columns={columns}
215
+ paginationMode="server"
216
+ page={2}
217
+ pageSize={10}
218
+ rowCount={95}
219
+ csvExport
220
+ onExport={vi.fn()}
221
+ selectionModel={{ type: selectionModel.type, ids: [...selectionModel.ids] }}
222
+ />,
223
+ );
224
+ const cell = screen.getByRole('cell', { name: 'Item 15' });
225
+ expect(fireEvent.keyDown(cell, { key: 'c', ctrlKey: true })).toBe(true);
226
+ expect(writeText).not.toHaveBeenCalled();
227
+ await user.click(screen.getByRole('button', { name: 'Export' }));
228
+ expect(await screen.findByRole('menuitem', { name: /Selected rows/ })).toBeVisible();
229
+ expect(screen.queryByRole('menuitem', { name: 'Copy selected rows' })).not.toBeInTheDocument();
230
+ });
231
+
232
+ it.each([
233
+ ['=x', "'=x", "'=x"],
234
+ ['+x', "'+x", "'+x"],
235
+ ['-x', "'-x", "'-x"],
236
+ ['@x', "'@x", "'@x"],
237
+ ['\tx', "'\tx", '"\'\tx"'],
238
+ ['\rx', '"\'\rx"', '"\'\rx"'],
239
+ [
240
+ '=HYPERLINK("https://example.test","x")',
241
+ '"\'=HYPERLINK(""https://example.test"",""x"")"',
242
+ '"\'=HYPERLINK(""https://example.test"",""x"")"',
243
+ ],
244
+ ])('protects %j in CSV and copied TSV headers, accessors and exportValue', async (value, csv, tsv) => {
245
+ render(
246
+ <DataTable
247
+ rows={[{ id: '1', name: value }]}
248
+ columns={[
249
+ { id: 'name', header: value, accessor: (row) => row.name },
250
+ { id: 'override', header: 'Override', accessor: () => 'safe', exportValue: () => value },
251
+ ]}
252
+ csvExport
253
+ defaultSelectedIds={['1']}
254
+ />,
255
+ );
256
+ await choose('All rows (1)');
257
+ expect(downloadFile).toHaveBeenCalledWith(
258
+ `\uFEFF${csv},Override\r\n${csv},${csv}`,
259
+ 'table.csv',
260
+ 'text/csv;charset=utf-8',
261
+ );
262
+ await choose('Copy selected rows');
263
+ expect(writeText).toHaveBeenCalledExactlyOnceWith(`${tsv}\tOverride\r\n${tsv}\t${tsv}`);
264
+ expect(await screen.findByRole('status')).toHaveTextContent('Copied to clipboard');
265
+ });
266
+
267
+ it('copies the selected rows across pages with headers in sort order', async () => {
268
+ render(<DataTable rows={rows} columns={columns} defaultSelectedIds={['2', '15']} sort={sort} csvExport />);
269
+ await choose('Copy selected rows');
270
+ expect(writeText).toHaveBeenCalledExactlyOnceWith('Name\r\nItem 15\r\nItem 2');
271
+ });
272
+
273
+ it('announces clipboard rejection', async () => {
274
+ writeText.mockRejectedValue(new Error('denied'));
275
+ render(<DataTable rows={rows} columns={columns} defaultSelectedIds={['2']} csvExport />);
276
+ await choose('Copy selected rows');
277
+ expect(await screen.findByRole('status')).toHaveTextContent('Copy failed');
278
+ });
279
+
280
+ it.each(['ctrlKey', 'metaKey'] as const)(
281
+ 'copies with %s+C from a checkbox, row actions or a cell',
282
+ async (modifier) => {
283
+ render(
284
+ <DataTable
285
+ rows={rows}
286
+ columns={columns}
287
+ csvExport
288
+ defaultSelectedIds={['2', '15']}
289
+ sort={sort}
290
+ rowActions={() => [{ label: 'Inspect' }]}
291
+ />,
292
+ );
293
+ const targets = [
294
+ screen.getByRole('checkbox', { name: 'Select Item 95' }),
295
+ screen.getByRole('button', { name: 'Actions for Item 95' }),
296
+ screen.getByRole('cell', { name: 'Item 95' }),
297
+ ];
298
+ for (const target of targets) {
299
+ target.setAttribute('tabindex', '0');
300
+ target.focus();
301
+ expect(fireEvent.keyDown(target, { key: 'c', [modifier]: true })).toBe(false);
302
+ await waitFor(() => expect(writeText).toHaveBeenLastCalledWith('Name\r\nItem 15\r\nItem 2'));
303
+ }
304
+ expect(writeText).toHaveBeenCalledTimes(3);
305
+ },
306
+ );
307
+
308
+ it.each(['input', 'textarea', 'select', 'contenteditable'] as const)(
309
+ 'leaves copy in %s to the browser',
310
+ async (editor) => {
311
+ render(
312
+ <DataTable
313
+ rows={rows.slice(0, 1)}
314
+ columns={[
315
+ {
316
+ ...columns[0]!,
317
+ cell: () =>
318
+ editor === 'contenteditable' ? (
319
+ <div contentEditable suppressContentEditableWarning>
320
+ <span>Editor text</span>
321
+ </div>
322
+ ) : editor === 'input' ? (
323
+ <input aria-label="Editor" />
324
+ ) : editor === 'textarea' ? (
325
+ <textarea aria-label="Editor" />
326
+ ) : (
327
+ <select aria-label="Editor">
328
+ <option>One</option>
329
+ </select>
330
+ ),
331
+ },
332
+ ]}
333
+ csvExport
334
+ defaultSelectedIds={['1']}
335
+ />,
336
+ );
337
+ const target = editor === 'contenteditable' ? screen.getByText('Editor text') : screen.getByLabelText('Editor');
338
+ expect(fireEvent.keyDown(target, { key: 'c', ctrlKey: true })).toBe(true);
339
+ expect(writeText).not.toHaveBeenCalled();
340
+ },
341
+ );
342
+
343
+ it('leaves copy inside the inline cell editor to the browser', async () => {
344
+ render(
345
+ <DataTable
346
+ rows={rows.slice(0, 2)}
347
+ columns={[{ ...columns[0]!, editable: true }]}
348
+ onCellEdit={() => undefined}
349
+ csvExport
350
+ defaultSelectedIds={['1', '2']}
351
+ />,
352
+ );
353
+ screen.getByRole('button', { name: 'Item 1' }).focus();
354
+ await user.keyboard('{Enter}');
355
+ const editor = screen.getByRole('textbox', { name: 'Name for Item 1' });
356
+ expect(editor).toHaveFocus();
357
+ for (const modifier of ['ctrlKey', 'metaKey']) {
358
+ expect(fireEvent.keyDown(editor, { key: 'c', [modifier]: true })).toBe(true);
359
+ }
360
+ expect(writeText).not.toHaveBeenCalled();
361
+ });
362
+
363
+ it('uses the Spanish catalog for the entire export menu and copy feedback', async () => {
364
+ render(
365
+ <I18nProvider locale="es">
366
+ <DataTable rows={rows} columns={columns} csvExport defaultSelectedIds={['2']} />
367
+ </I18nProvider>,
368
+ );
369
+ await user.click(screen.getByRole('button', { name: 'Exportar' }));
370
+ expect(await screen.findByRole('menuitem', { name: 'Todas las filas (95)' })).toBeVisible();
371
+ expect(screen.getByRole('menuitem', { name: 'Página actual' })).toBeVisible();
372
+ expect(screen.getByRole('menuitem', { name: 'Filas seleccionadas (1)' })).toBeVisible();
373
+ await user.click(screen.getByRole('menuitem', { name: 'Copiar filas seleccionadas' }));
374
+ expect(await screen.findByRole('status')).toHaveTextContent('Copiado al portapapeles');
375
+ });
376
+
377
+ it.each([false, true])('prefers DataTableLabels for every export string (copy rejects=%s)', async (rejects) => {
378
+ if (rejects) writeText.mockRejectedValue(new Error('denied'));
379
+ render(
380
+ <I18nProvider locale="es">
381
+ <DataTable
382
+ rows={rows}
383
+ columns={columns}
384
+ csvExport
385
+ defaultSelectedIds={['2']}
386
+ labels={{
387
+ export: 'Save data',
388
+ exportAll: (count) => `Everything (${count})`,
389
+ exportPage: 'This page',
390
+ exportSelected: (count) => `Chosen (${count})`,
391
+ copySelected: 'Copy chosen',
392
+ copiedToClipboard: 'Copied chosen',
393
+ copyFailed: 'Cannot copy chosen',
394
+ }}
395
+ />
396
+ </I18nProvider>,
397
+ );
398
+ await user.click(screen.getByRole('button', { name: 'Save data' }));
399
+ expect(await screen.findByRole('menuitem', { name: 'Everything (95)' })).toBeVisible();
400
+ expect(screen.getByRole('menuitem', { name: 'This page' })).toBeVisible();
401
+ expect(screen.getByRole('menuitem', { name: 'Chosen (1)' })).toBeVisible();
402
+ await user.click(screen.getByRole('menuitem', { name: 'Copy chosen' }));
403
+ expect(await screen.findByRole('status')).toHaveTextContent(rejects ? 'Cannot copy chosen' : 'Copied chosen');
404
+ });
405
+
406
+ it('preserves document text selection when copying in a cell', () => {
407
+ render(<DataTable rows={rows} columns={columns} csvExport defaultSelectedIds={['2']} />);
408
+ const cell = screen.getByRole('cell', { name: 'Item 1' });
409
+ const selection = window.getSelection()!;
410
+ const range = document.createRange();
411
+ range.selectNodeContents(cell);
412
+ selection.removeAllRanges();
413
+ selection.addRange(range);
414
+ expect(selection.isCollapsed).toBe(false);
415
+ try {
416
+ expect(fireEvent.keyDown(cell, { key: 'c', metaKey: true })).toBe(true);
417
+ expect(writeText).not.toHaveBeenCalled();
418
+ } finally {
419
+ selection.removeAllRanges();
420
+ }
421
+ });
422
+
423
+ it.each([
424
+ { csvExport: false, defaultSelectedIds: ['1'] },
425
+ { csvExport: true, defaultSelectedIds: [] },
426
+ { csvExport: { scopes: ['rows'] as Array<'rows'> }, defaultSelectedIds: ['1'] },
427
+ ])('leaves browser copy alone when selected copying is not enabled: %j', (props) => {
428
+ render(<DataTable rows={rows} columns={columns} {...props} />);
429
+ expect(fireEvent.keyDown(screen.getByRole('cell', { name: 'Item 1' }), { key: 'c', ctrlKey: true })).toBe(true);
430
+ expect(writeText).not.toHaveBeenCalled();
431
+ });
432
+
433
+ it.each([
434
+ [' Deployment history / 2026 ', 'deployment-history-2026.csv'],
435
+ ['Facturación', 'facturacion.csv'],
436
+ ])('slugs the supplied caption %j for the default filename', async (caption, fileName) => {
437
+ render(<DataTable rows={rows.slice(0, 1)} columns={columns} caption={caption} csvExport />);
438
+ await choose('All rows (1)');
439
+ expect(downloadFile).toHaveBeenCalledWith('\uFEFFName\r\nItem 1', fileName, 'text/csv;charset=utf-8');
440
+ });
441
+
442
+ it('preserves the toolbar DOM and hidden-toolbar behaviour without csvExport', () => {
443
+ const { container, rerender } = render(
444
+ <DataTable rows={rows} columns={columns} showColumnMenu={false} showDensityToggle={false} />,
445
+ );
446
+ const toolbar = container.firstElementChild!.firstElementChild!;
447
+ const original = toolbar.outerHTML;
448
+ expect(toolbar).toHaveClass('sr-only');
449
+ expect(screen.queryByRole('status')).not.toBeInTheDocument();
450
+ rerender(
451
+ <DataTable rows={rows} columns={columns} showColumnMenu={false} showDensityToggle={false} csvExport={false} />,
452
+ );
453
+ expect(toolbar.outerHTML).toBe(original);
454
+ rerender(<DataTable rows={rows} columns={columns} showColumnMenu={false} showDensityToggle={false} csvExport />);
455
+ expect(toolbar).not.toHaveClass('sr-only');
456
+ expect(screen.getByRole('button', { name: 'Export' })).toBeVisible();
457
+ rerender(<DataTable rows={rows} columns={columns} showColumnMenu={false} showDensityToggle={false} />);
458
+ expect(toolbar.outerHTML).toBe(original);
459
+ });
460
+
461
+ it.each(['dark', 'light', 'high_contrast'])('has accessible export examples and an open menu in %s', async (theme) => {
462
+ document.documentElement.className = theme;
463
+ render(<CsvExportExample />);
464
+ await expectNoAxeViolations(document.body);
465
+ await user.click(screen.getAllByRole('button', { name: 'Export' })[0]!);
466
+ await screen.findByRole('menuitem', { name: 'Copy selected rows' });
467
+ await expectNoAxeViolations(document.body);
468
+ });
469
+
470
+ it('unlocks exports after a delegated rejection', async () => {
471
+ const onExport = vi.fn().mockRejectedValue(new Error('caller handles feedback'));
472
+ render(<DataTable rows={rows} columns={columns} csvExport onExport={onExport} />);
473
+ await choose('All rows (95)');
474
+ await waitFor(() => expect(screen.getByRole('button', { name: 'Export' })).not.toHaveAttribute('aria-busy', 'true'));
475
+ await choose('Current page');
476
+ expect(onExport).toHaveBeenCalledTimes(2);
477
+ expect(downloadFile).not.toHaveBeenCalled();
478
+ });
479
+
480
+ it('copies an exclude selection and omits grouped header rows', async () => {
481
+ render(
482
+ <DataTable
483
+ rows={rows.slice(0, 3)}
484
+ columns={columns}
485
+ csvExport
486
+ selectionModel={{ type: 'exclude', ids: ['2'] }}
487
+ groupBy={() => 'Group heading'}
488
+ />,
489
+ );
490
+ await choose('Copy selected rows');
491
+ expect(writeText).toHaveBeenCalledExactlyOnceWith('Name\r\nItem 1\r\nItem 3');
492
+ await choose('All rows (3)');
493
+ expect(downloadFile).toHaveBeenCalledWith(
494
+ '\uFEFFName\r\nItem 1\r\nItem 2\r\nItem 3',
495
+ 'table.csv',
496
+ 'text/csv;charset=utf-8',
497
+ );
498
+ });
499
+
500
+ it('counts resolved client selections when an excluded id has left the supplied rows', async () => {
501
+ render(
502
+ <DataTable
503
+ rows={rows.slice(0, 2)}
504
+ columns={columns}
505
+ csvExport
506
+ selectionModel={{ type: 'exclude', ids: ['removed'] }}
507
+ />,
508
+ );
509
+ await choose('Selected rows (2)');
510
+ expect(downloadFile).toHaveBeenCalledWith('\uFEFFName\r\nItem 1\r\nItem 2', 'table.csv', 'text/csv;charset=utf-8');
511
+ });
@@ -0,0 +1,32 @@
1
+ import { act, render, screen } from '@testing-library/react';
2
+ import userEvent from '@testing-library/user-event';
3
+ import { DataTable } from './DataTable';
4
+
5
+ it('does not move focus again when a cancelled pending cell save resolves', async () => {
6
+ const user = userEvent.setup();
7
+ let resolve!: () => void;
8
+ const onCellEdit = vi.fn(
9
+ () =>
10
+ new Promise<void>((done) => {
11
+ resolve = done;
12
+ }),
13
+ );
14
+ render(
15
+ <>
16
+ <DataTable
17
+ rows={[{ id: 'one', name: 'Support agent' }]}
18
+ columns={[{ id: 'name', header: 'Name', accessor: (row) => row.name, editable: true }]}
19
+ paginated={false}
20
+ onCellEdit={onCellEdit}
21
+ />
22
+ <button type="button">After</button>
23
+ </>,
24
+ );
25
+ await user.click(screen.getByRole('button', { name: 'Support agent' }));
26
+ await user.type(screen.getByRole('textbox'), 'x{Enter}{Escape}');
27
+ expect(screen.getByRole('button', { name: 'Support agent' })).toHaveFocus();
28
+ await user.click(screen.getByRole('button', { name: 'After' }));
29
+ await act(async () => resolve());
30
+ expect(onCellEdit).toHaveBeenCalledOnce();
31
+ expect(screen.getByRole('button', { name: 'After' })).toHaveFocus();
32
+ });
@@ -74,15 +74,16 @@ describe('DataTable column pinning', () => {
74
74
  expect(headers[1]).toHaveTextContent('Deployment');
75
75
  expect(headers[headers.length - 2]).toHaveTextContent('Cost');
76
76
  const name = head(/Deployment/);
77
- expect(name).toHaveClass('sticky', 'border-e');
77
+ expect(name).toHaveClass('sticky', 'border-e', 'z-sticky-pinned');
78
+ expect(name).not.toHaveClass('z-raised');
78
79
  expect(name.style.width).toBe('220px');
79
80
  const cost = head(/Cost/);
80
- expect(cost).toHaveClass('sticky', 'border-s');
81
+ expect(cost).toHaveClass('sticky', 'border-s', 'z-sticky-pinned');
81
82
  // The selection and actions columns stick with them.
82
- expect(headers[0]).toHaveClass('sticky');
83
- expect(headers[headers.length - 1]).toHaveClass('sticky');
83
+ expect(headers[0]).toHaveClass('sticky', 'z-sticky-pinned');
84
+ expect(headers[headers.length - 1]).toHaveClass('sticky', 'z-sticky-pinned');
84
85
  const firstRow = within(screen.getAllByRole('rowgroup')[1]!).getAllByRole('row')[0]!;
85
- expect(within(firstRow).getAllByRole('cell')[1]).toHaveClass('sticky', 'bg-card');
86
+ expect(within(firstRow).getAllByRole('cell')[1]).toHaveClass('sticky', 'bg-card', 'z-raised');
86
87
  await expectNoAxeViolations(container);
87
88
  });
88
89
 
@@ -0,0 +1,18 @@
1
+ import { render, screen } from '@testing-library/react';
2
+ import userEvent from '@testing-library/user-event';
3
+ import { DataTable } from './DataTable';
4
+
5
+ it('exposes row-action destinations as anchor menuitems through MoreMenu', async () => {
6
+ const user = userEvent.setup();
7
+ render(
8
+ <DataTable
9
+ defaultPageSize={5}
10
+ labels={{ rowActions: () => 'Run actions' }}
11
+ rowActions={() => [{ label: 'View logs', href: '/logs?run=42' }]}
12
+ />,
13
+ );
14
+ await user.click(screen.getAllByRole('button', { name: 'Run actions' })[0]!);
15
+ const link = await screen.findByRole('menuitem', { name: 'View logs' });
16
+ expect(link.tagName).toBe('A');
17
+ expect(link).toHaveAttribute('href', '/logs?run=42');
18
+ });