@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,613 @@
1
+ import { StrictMode } from 'react';
2
+ import { renderToString } from 'react-dom/server';
3
+ import { act, renderHook } from '@testing-library/react';
4
+ import { useTableData, type TableDataParams, type TableDataResult } from './useTableData';
5
+
6
+ interface Row {
7
+ id: number;
8
+ name: string;
9
+ }
10
+ function endpoint() {
11
+ const calls: Array<{
12
+ params: TableDataParams<unknown>;
13
+ resolve: (result: TableDataResult<Row>) => void;
14
+ reject: (error: unknown) => void;
15
+ }> = [];
16
+ const getRows = vi.fn(
17
+ (params: TableDataParams<unknown>) =>
18
+ new Promise<TableDataResult<Row>>((resolve, reject) => calls.push({ params, resolve, reject })),
19
+ );
20
+ return { calls, getRows };
21
+ }
22
+ const row = (id: number): Row => ({ id, name: `Item ${id}` });
23
+ async function settle(call: ReturnType<typeof endpoint>['calls'][number], id: number) {
24
+ await act(async () => call.resolve({ rows: [row(id)], rowCount: 95 }));
25
+ }
26
+
27
+ it('keeps the resolved page envelope while requesting the next page, and ignores superseded results', async () => {
28
+ const { calls, getRows } = endpoint();
29
+ const { result } = renderHook(() => useTableData({ getRows, initialPage: 2 }));
30
+ expect(calls[0]!.params).toMatchObject({ page: 2, pageSize: 20, sort: null, cursor: null });
31
+ await settle(calls[0]!, 21);
32
+ act(() => result.current.tableProps.onPageChange(3));
33
+ expect(calls[1]!.params).toMatchObject({ page: 3, pageSize: 20, sort: null });
34
+ expect(calls[1]!.params.signal).not.toBe(calls[0]!.params.signal);
35
+ expect(result.current.tableProps).toMatchObject({
36
+ rows: [row(21)],
37
+ page: 2,
38
+ pageSize: 20,
39
+ rowCount: 95,
40
+ loading: false,
41
+ });
42
+ expect(result.current.isFetching).toBe(true);
43
+ expect(result.current.params.page).toBe(3);
44
+ act(() => result.current.tableProps.onPageChange(4));
45
+ expect(calls[1]!.params.signal.aborted).toBe(true);
46
+ await settle(calls[2]!, 61);
47
+ await settle(calls[1]!, 41);
48
+ expect(result.current.rows).toEqual([row(61)]);
49
+ expect(result.current.error).toBeNull();
50
+ });
51
+
52
+ it('can show an uncached requested page without previous rows, retaining the known count', async () => {
53
+ const { calls, getRows } = endpoint();
54
+ const { result } = renderHook(() => useTableData({ getRows, initialPage: 2, keepPreviousData: false }));
55
+ await settle(calls[0]!, 21);
56
+ act(() => result.current.tableProps.onPageChange(3));
57
+ expect(result.current.tableProps).toMatchObject({ rows: [], page: 3, pageSize: 20, rowCount: 95, loading: true });
58
+ await settle(calls[1]!, 41);
59
+ expect(result.current.rows).toEqual([row(41)]);
60
+ });
61
+
62
+ it('reports failures once, rolls sort back, and retries failed params even through a repeated page callback', async () => {
63
+ const { calls, getRows } = endpoint();
64
+ const onError = vi.fn();
65
+ const { result, rerender } = renderHook(({ onError }) => useTableData({ getRows, onError, initialPage: 2 }), {
66
+ initialProps: { onError },
67
+ });
68
+ await settle(calls[0]!, 21);
69
+ const sort = { columnId: 'name', direction: 'ascending' as const };
70
+ act(() => result.current.tableProps.onSortChange(sort));
71
+ expect(result.current.tableProps.sort).toEqual(sort);
72
+ const latestOnError = vi.fn();
73
+ rerender({ onError: latestOnError });
74
+ const failure = new Error('Unavailable');
75
+ await act(async () => calls[1]!.reject(failure));
76
+ expect(result.current).toMatchObject({ rows: [row(21)], error: failure, isFetching: false });
77
+ expect(result.current.tableProps.sort).toBeNull();
78
+ expect(onError).not.toHaveBeenCalled();
79
+ expect(latestOnError).toHaveBeenCalledExactlyOnceWith(failure);
80
+ expect(result.current.loadMoreProps.error).toBe('Unavailable');
81
+ act(() => result.current.refetch());
82
+ expect(calls[2]!.params).toMatchObject({ page: 1, sort });
83
+ await act(async () => calls[2]!.reject(new Error('')));
84
+ expect(result.current.loadMoreProps.error).toBe('Unable to load rows.');
85
+ act(() => result.current.tableProps.onPageChange(1));
86
+ expect(getRows).toHaveBeenCalledTimes(4);
87
+ await settle(calls[3]!, 1);
88
+ expect(result.current.error).toBeNull();
89
+ });
90
+
91
+ it('handles synchronous throws and abort rejections without reporting an abort as an error', async () => {
92
+ const onError = vi.fn();
93
+ const getRows = vi
94
+ .fn<ReturnType<typeof endpoint>['getRows']>()
95
+ .mockImplementationOnce(() => {
96
+ throw new Error('Sync failure');
97
+ })
98
+ .mockRejectedValueOnce(new DOMException('Cancelled', 'AbortError'));
99
+ const { result } = renderHook(() => useTableData({ getRows, onError }));
100
+ expect(result.current.error).toEqual(new Error('Sync failure'));
101
+ act(() => result.current.refetch());
102
+ await act(async () => {});
103
+ expect(result.current.error).toBeNull();
104
+ expect(result.current.isFetching).toBe(false);
105
+ expect(onError).toHaveBeenCalledTimes(1);
106
+ });
107
+
108
+ it.each([undefined, null])('exposes a nullish rejection (%s) as a failure with a footer message', async (reason) => {
109
+ const { calls, getRows } = endpoint();
110
+ const onError = vi.fn();
111
+ const { result } = renderHook(() => useTableData({ getRows, onError }));
112
+ await settle(calls[0]!, 1);
113
+ act(() => result.current.tableProps.onPageChange(2));
114
+ await act(async () => calls[1]!.reject(reason));
115
+ expect(result.current).toMatchObject({ rows: [row(1)], isFetching: false, isLoading: false });
116
+ expect(result.current.error).toEqual(new Error('Unable to load rows.'));
117
+ expect(result.current.loadMoreProps.error).toBe('Unable to load rows.');
118
+ expect(onError).toHaveBeenCalledExactlyOnceWith(result.current.error);
119
+ act(() => result.current.refetch());
120
+ await settle(calls[2]!, 21);
121
+ expect(result.current.error).toBeNull();
122
+ expect(result.current.loadMoreProps.error).toBe('');
123
+ });
124
+
125
+ it('uses fresh cached pages, aborts outstanding work, and refreshes expired pages without loading placeholders', async () => {
126
+ vi.useFakeTimers();
127
+ try {
128
+ const { calls, getRows } = endpoint();
129
+ const { result } = renderHook(() =>
130
+ useTableData({ getRows, initialPage: 2, cacheTime: 1000, keepPreviousData: false }),
131
+ );
132
+ await settle(calls[0]!, 21);
133
+ act(() => result.current.tableProps.onPageChange(3));
134
+ act(() => result.current.tableProps.onPageChange(2));
135
+ expect(calls[1]!.params.signal.aborted).toBe(true);
136
+ expect(getRows).toHaveBeenCalledTimes(2);
137
+ expect(result.current).toMatchObject({ rows: [row(21)], isLoading: false, isFetching: false });
138
+ await act(async () => calls[1]!.reject(new Error('Late failure')));
139
+ expect(result.current.error).toBeNull();
140
+ act(() => result.current.tableProps.onPageChange(4));
141
+ await settle(calls[2]!, 61);
142
+ act(() => vi.advanceTimersByTime(1001));
143
+ act(() => result.current.tableProps.onPageChange(2));
144
+ expect(getRows).toHaveBeenCalledTimes(4);
145
+ expect(result.current).toMatchObject({ rows: [row(21)], isLoading: false, isFetching: true });
146
+ await settle(calls[3]!, 22);
147
+ expect(result.current.rows).toEqual([row(22)]);
148
+ act(() => result.current.refetch());
149
+ expect(getRows).toHaveBeenCalledTimes(5);
150
+ await settle(calls[4]!, 23);
151
+ act(() => result.current.invalidate());
152
+ expect(getRows).toHaveBeenCalledTimes(6);
153
+ await settle(calls[5]!, 24);
154
+ act(() => result.current.tableProps.onPageChange(4));
155
+ expect(getRows).toHaveBeenCalledTimes(7);
156
+ } finally {
157
+ vi.useRealTimers();
158
+ }
159
+ });
160
+
161
+ it('disables caching with cacheTime zero and clears errors on a fresh cache hit', async () => {
162
+ const { calls, getRows } = endpoint();
163
+ const { result, rerender } = renderHook(({ cacheTime }) => useTableData({ getRows, cacheTime }), {
164
+ initialProps: { cacheTime: 1000 },
165
+ });
166
+ await settle(calls[0]!, 1);
167
+ act(() => result.current.tableProps.onPageChange(2));
168
+ await act(async () => calls[1]!.reject(new Error('Failed')));
169
+ act(() => result.current.tableProps.onPageChange(1));
170
+ expect(getRows).toHaveBeenCalledTimes(2);
171
+ expect(result.current.error).toBeNull();
172
+ rerender({ cacheTime: 0 });
173
+ act(() => result.current.tableProps.onPageChange(2));
174
+ await settle(calls[2]!, 21);
175
+ act(() => result.current.tableProps.onPageChange(1));
176
+ expect(getRows).toHaveBeenCalledTimes(4);
177
+ });
178
+
179
+ it('compares filters by JSON value, resets the page and reads callback identities without refetching', async () => {
180
+ const original = endpoint();
181
+ const replacement = endpoint();
182
+ const { result, rerender } = renderHook(
183
+ ({ filters, getRows }) => useTableData({ getRows, filters, initialPage: 2 }),
184
+ { initialProps: { filters: { status: 'failed' }, getRows: original.getRows } },
185
+ );
186
+ await settle(original.calls[0]!, 21);
187
+ rerender({ filters: { status: 'failed' }, getRows: replacement.getRows });
188
+ expect(replacement.getRows).not.toHaveBeenCalled();
189
+ rerender({ filters: { status: 'running' }, getRows: replacement.getRows });
190
+ expect(replacement.calls[0]!.params).toMatchObject({ page: 1, filters: { status: 'running' } });
191
+ await settle(replacement.calls[0]!, 1);
192
+ act(() => result.current.tableProps.onPageChange(2));
193
+ expect(replacement.calls[1]!.params).toMatchObject({ page: 2, filters: { status: 'running' } });
194
+ });
195
+
196
+ it('resets saved-view filters to page one and handles a cleared sort through onQueryChange', async () => {
197
+ const { calls, getRows } = endpoint();
198
+ const { result } = renderHook(() =>
199
+ useTableData({ getRows, initialPage: 2, initialSort: { columnId: 'name', direction: 'ascending' } }),
200
+ );
201
+ await settle(calls[0]!, 21);
202
+ act(() =>
203
+ result.current.tableProps.onQueryChange({
204
+ page: 2,
205
+ pageSize: 20,
206
+ sort: null,
207
+ filters: { status: 'running' },
208
+ cause: 'view',
209
+ }),
210
+ );
211
+ expect(calls[1]!.params).toMatchObject({ page: 1, sort: null, filters: { status: 'running' } });
212
+ });
213
+
214
+ it('revalidates in the foreground only, skipping an in-flight request', async () => {
215
+ vi.useFakeTimers();
216
+ try {
217
+ const { calls, getRows } = endpoint();
218
+ const { result } = renderHook(() => useTableData({ getRows, revalidateInterval: 1000 }));
219
+ act(() => vi.advanceTimersByTime(2000));
220
+ expect(getRows).toHaveBeenCalledTimes(1);
221
+ await settle(calls[0]!, 1);
222
+ Object.defineProperty(document, 'hidden', { configurable: true, value: true });
223
+ act(() => vi.advanceTimersByTime(2000));
224
+ expect(getRows).toHaveBeenCalledTimes(1);
225
+ Object.defineProperty(document, 'hidden', { configurable: true, value: false });
226
+ act(() => vi.advanceTimersByTime(1000));
227
+ expect(getRows).toHaveBeenCalledTimes(2);
228
+ expect(result.current.isLoading).toBe(false);
229
+ act(() => vi.advanceTimersByTime(2000));
230
+ expect(getRows).toHaveBeenCalledTimes(2);
231
+ } finally {
232
+ Reflect.deleteProperty(document, 'hidden');
233
+ vi.useRealTimers();
234
+ }
235
+ });
236
+
237
+ it('appends cursor pages atomically, retries the failed cursor, and reloads from the beginning on refetch', async () => {
238
+ const { calls, getRows } = endpoint();
239
+ const { result } = renderHook(() => useTableData({ getRows }));
240
+ await act(async () => calls[0]!.resolve({ rows: [row(1)], nextCursor: 'c2' }));
241
+ expect(result.current.hasMore).toBe(true);
242
+ act(() => {
243
+ result.current.loadMore();
244
+ result.current.loadMore();
245
+ });
246
+ expect(getRows).toHaveBeenCalledTimes(2);
247
+ expect(calls[1]!.params.cursor).toBe('c2');
248
+ await act(async () => calls[1]!.reject(new Error('Try again')));
249
+ expect(result.current.rows).toEqual([row(1)]);
250
+ expect(result.current.lastAppend.seq).toBe(0);
251
+ expect(result.current.loadMoreProps).toMatchObject({ loading: false, error: 'Try again', nextCursor: 'c2' });
252
+ act(() => result.current.loadMoreProps.onRetry?.());
253
+ expect(calls[2]!.params.cursor).toBe('c2');
254
+ await act(async () => calls[2]!.resolve({ rows: [row(2)], nextCursor: null }));
255
+ expect(result.current.rows).toEqual([row(1), row(2)]);
256
+ expect(result.current.loadMoreProps).toMatchObject({
257
+ loading: false,
258
+ error: '',
259
+ loadedCount: 2,
260
+ lastAppend: { seq: 1, count: 1 },
261
+ });
262
+ expect(result.current.hasMore).toBe(false);
263
+ act(() => result.current.loadMore());
264
+ expect(getRows).toHaveBeenCalledTimes(3);
265
+ act(() => result.current.refetch());
266
+ expect(calls[3]!.params).toMatchObject({ page: 1, cursor: null });
267
+ await act(async () => calls[3]!.resolve({ rows: [row(3)], nextCursor: '' }));
268
+ expect(result.current.rows).toEqual([row(3)]);
269
+ expect(result.current.hasMore).toBe(false);
270
+ expect(result.current.lastAppend.seq).toBe(1);
271
+ });
272
+
273
+ it.each(['loadMore', 'footer'] as const)('can %s after an upstream abort of a cursor append', async (control) => {
274
+ const { calls, getRows } = endpoint();
275
+ const onError = vi.fn();
276
+ const { result } = renderHook(() => useTableData({ getRows, onError }));
277
+ await act(async () => calls[0]!.resolve({ rows: [row(1)], nextCursor: 'c2' }));
278
+ act(() => result.current.loadMore());
279
+ await act(async () => calls[1]!.resolve({ rows: [row(2)], nextCursor: 'c3' }));
280
+ act(() => result.current.loadMore());
281
+ await act(async () => calls[2]!.reject(new DOMException('Upstream cancelled', 'AbortError')));
282
+ expect(calls[2]!.params.signal.aborted).toBe(false);
283
+ expect(result.current).toMatchObject({ rows: [row(1), row(2)], error: null, hasMore: true, isFetching: false });
284
+ expect(result.current.loadMoreProps).toMatchObject({ loading: false, error: '', nextCursor: 'c3' });
285
+ expect(onError).not.toHaveBeenCalled();
286
+ act(() => {
287
+ if (control === 'footer') result.current.loadMoreProps.onLoadMore?.('c3');
288
+ else result.current.loadMore();
289
+ });
290
+ expect(getRows).toHaveBeenCalledTimes(4);
291
+ expect(calls[3]!.params).toMatchObject({ page: 3, cursor: 'c3' });
292
+ expect(calls[3]!.params.signal).not.toBe(calls[2]!.params.signal);
293
+ await act(async () => calls[3]!.resolve({ rows: [row(3)], nextCursor: null }));
294
+ expect(result.current.rows).toEqual([row(1), row(2), row(3)]);
295
+ expect(result.current.loadMoreProps.lastAppend).toEqual({ seq: 2, count: 1 });
296
+ });
297
+
298
+ it.each(['sort', 'filters'] as const)(
299
+ 'refuses loadMore after a failed %s change until the query is retried',
300
+ async (change) => {
301
+ const { calls, getRows } = endpoint();
302
+ const { result, rerender } = renderHook(({ status }) => useTableData({ getRows, filters: { status } }), {
303
+ initialProps: { status: 'all' },
304
+ });
305
+ await act(async () => calls[0]!.resolve({ rows: [row(1)], nextCursor: 'old-cursor' }));
306
+ const sort = { columnId: 'name', direction: 'ascending' as const };
307
+ if (change === 'sort') act(() => result.current.tableProps.onSortChange(sort));
308
+ else rerender({ status: 'running' });
309
+ await act(async () => calls[1]!.reject(new Error('Query failed')));
310
+ expect(result.current.tableProps.sort).toBeNull();
311
+ act(() => result.current.loadMore());
312
+ expect(getRows).toHaveBeenCalledTimes(2);
313
+ expect(result.current.rows).toEqual([row(1)]);
314
+ act(() => result.current.loadMoreProps.onRetry?.());
315
+ expect(calls[2]!.params).toMatchObject({
316
+ page: 1,
317
+ cursor: null,
318
+ sort: change === 'sort' ? sort : null,
319
+ filters: { status: change === 'filters' ? 'running' : 'all' },
320
+ });
321
+ await act(async () => calls[2]!.resolve({ rows: [row(2)], nextCursor: 'new-cursor' }));
322
+ act(() => result.current.loadMore());
323
+ expect(calls[3]!.params.cursor).toBe('new-cursor');
324
+ await act(async () => calls[3]!.resolve({ rows: [row(3)], nextCursor: null }));
325
+ expect(result.current.rows).toEqual([row(2), row(3)]);
326
+ },
327
+ );
328
+
329
+ it('revalidates an appended cursor segment without duplicating or dropping the prefix', async () => {
330
+ vi.useFakeTimers();
331
+ Object.defineProperty(document, 'hidden', { configurable: true, value: false });
332
+ try {
333
+ const { calls, getRows } = endpoint();
334
+ const { result } = renderHook(() => useTableData({ getRows, cacheTime: 1000, revalidateInterval: 2000 }));
335
+ await act(async () => calls[0]!.resolve({ rows: [row(1)], nextCursor: 'c2' }));
336
+ act(() => result.current.loadMore());
337
+ await act(async () => calls[1]!.resolve({ rows: [row(2)], nextCursor: 'c3' }));
338
+ act(() => vi.advanceTimersByTime(2000));
339
+ expect(calls[2]!.params.cursor).toBe('c2');
340
+ expect(result.current.isFetching).toBe(true);
341
+ expect(result.current.loadMoreProps.loading).toBe(false);
342
+ act(() => result.current.loadMore());
343
+ expect(getRows).toHaveBeenCalledTimes(3);
344
+ await act(async () => calls[2]!.resolve({ rows: [row(3)], nextCursor: 'c3' }));
345
+ expect(result.current.rows).toEqual([row(1), row(3)]);
346
+ expect(result.current.lastAppend).toEqual({ seq: 1, count: 1 });
347
+ act(() => result.current.loadMore());
348
+ await act(async () => calls[3]!.resolve({ rows: [row(4)], nextCursor: null }));
349
+ expect(result.current.rows).toEqual([row(1), row(3), row(4)]);
350
+ } finally {
351
+ Reflect.deleteProperty(document, 'hidden');
352
+ vi.useRealTimers();
353
+ }
354
+ });
355
+
356
+ it('leaves a failed cursor append for an explicit retry instead of appending silently on a poll', async () => {
357
+ vi.useFakeTimers();
358
+ Object.defineProperty(document, 'hidden', { configurable: true, value: false });
359
+ try {
360
+ const { calls, getRows } = endpoint();
361
+ const { result } = renderHook(() => useTableData({ getRows, revalidateInterval: 1000 }));
362
+ await act(async () => calls[0]!.resolve({ rows: [row(1)], nextCursor: 'c2' }));
363
+ act(() => result.current.loadMore());
364
+ await act(async () => calls[1]!.reject(new Error('Append failed')));
365
+ act(() => vi.advanceTimersByTime(2000));
366
+ expect(getRows).toHaveBeenCalledTimes(2);
367
+ expect(result.current.loadMoreProps).toMatchObject({
368
+ loading: false,
369
+ error: 'Append failed',
370
+ lastAppend: { seq: 0, count: 0 },
371
+ });
372
+ act(() => result.current.loadMoreProps.onRetry?.());
373
+ await act(async () => calls[2]!.resolve({ rows: [row(2)], nextCursor: null }));
374
+ expect(result.current.rows).toEqual([row(1), row(2)]);
375
+ expect(result.current.lastAppend).toEqual({ seq: 1, count: 1 });
376
+ act(() => vi.advanceTimersByTime(1000));
377
+ expect(calls[3]!.params.cursor).toBe('c2');
378
+ await act(async () => calls[3]!.resolve({ rows: [row(3)], nextCursor: null }));
379
+ expect(result.current.rows).toEqual([row(1), row(3)]);
380
+ expect(result.current.lastAppend).toEqual({ seq: 1, count: 1 });
381
+ } finally {
382
+ Reflect.deleteProperty(document, 'hidden');
383
+ vi.useRealTimers();
384
+ }
385
+ });
386
+
387
+ it.each(['resolve', 'reject'] as const)(
388
+ 'aborts on unmount and ignores a late %s without an error callback',
389
+ async (outcome) => {
390
+ const { calls, getRows } = endpoint();
391
+ const onError = vi.fn();
392
+ const render = vi.fn();
393
+ const { unmount } = renderHook(() => {
394
+ render();
395
+ return useTableData({ getRows, onError });
396
+ });
397
+ unmount();
398
+ const renders = render.mock.calls.length;
399
+ expect(calls[0]!.params.signal.aborted).toBe(true);
400
+ await act(async () =>
401
+ outcome === 'resolve' ? calls[0]!.resolve({ rows: [row(1)] }) : calls[0]!.reject(new Error('Late error')),
402
+ );
403
+ expect(render).toHaveBeenCalledTimes(renders);
404
+ expect(onError).not.toHaveBeenCalled();
405
+ },
406
+ );
407
+
408
+ it('survives StrictMode effect replay and disabling aborts work without leaving a loading state', async () => {
409
+ const { calls, getRows } = endpoint();
410
+ const { result, rerender } = renderHook(({ enabled }) => useTableData({ getRows, enabled }), {
411
+ initialProps: { enabled: false },
412
+ wrapper: StrictMode,
413
+ });
414
+ expect(getRows).not.toHaveBeenCalled();
415
+ expect(result.current.isLoading).toBe(false);
416
+ rerender({ enabled: true });
417
+ expect(getRows).toHaveBeenCalledTimes(1);
418
+ rerender({ enabled: false });
419
+ expect(calls[0]!.params.signal.aborted).toBe(true);
420
+ expect(result.current).toMatchObject({ isLoading: false, isFetching: false });
421
+ await settle(calls[0]!, 1);
422
+ expect(result.current.rows).toEqual([]);
423
+ rerender({ enabled: true });
424
+ await settle(calls[1]!, 2);
425
+ expect(result.current.rows).toEqual([row(2)]);
426
+ });
427
+
428
+ it.each([false, true])(
429
+ 'restores confirmed data and sort when disabled (keepPreviousData=%s)',
430
+ async (keepPreviousData) => {
431
+ const { calls, getRows } = endpoint();
432
+ const confirmedSort = { columnId: 'name', direction: 'descending' as const };
433
+ const { result, rerender } = renderHook(
434
+ ({ enabled }) => useTableData({ getRows, enabled, initialPage: 2, initialSort: confirmedSort, keepPreviousData }),
435
+ { initialProps: { enabled: true } },
436
+ );
437
+ await settle(calls[0]!, 21);
438
+ act(() => result.current.tableProps.onSortChange({ columnId: 'name', direction: 'ascending' }));
439
+ rerender({ enabled: false });
440
+ expect(calls[1]!.params.signal.aborted).toBe(true);
441
+ expect(result.current.tableProps).toMatchObject({
442
+ rows: [row(21)],
443
+ page: 2,
444
+ pageSize: 20,
445
+ rowCount: 95,
446
+ sort: confirmedSort,
447
+ loading: false,
448
+ });
449
+ expect(result.current.isFetching).toBe(false);
450
+ },
451
+ );
452
+
453
+ it('applies only the surviving StrictMode mount request', async () => {
454
+ const { calls, getRows } = endpoint();
455
+ const { result } = renderHook(() => useTableData({ getRows }), { wrapper: StrictMode });
456
+ expect(getRows).toHaveBeenCalledTimes(2);
457
+ expect(calls[0]!.params.signal.aborted).toBe(true);
458
+ await settle(calls[1]!, 2);
459
+ await settle(calls[0]!, 1);
460
+ expect(result.current.rows).toEqual([row(2)]);
461
+ });
462
+
463
+ it('uses the fresh cache when re-enabled after an explicit refetch has settled', async () => {
464
+ const { calls, getRows } = endpoint();
465
+ const { result, rerender } = renderHook(({ enabled }) => useTableData({ getRows, enabled }), {
466
+ initialProps: { enabled: true },
467
+ });
468
+ await settle(calls[0]!, 1);
469
+ act(() => result.current.refetch());
470
+ await settle(calls[1]!, 2);
471
+ rerender({ enabled: false });
472
+ rerender({ enabled: true });
473
+ expect(getRows).toHaveBeenCalledTimes(2);
474
+ expect(result.current).toMatchObject({ rows: [row(2)], isFetching: false, isLoading: false });
475
+ });
476
+
477
+ it.each([0, 30000])(
478
+ 'does not announce an append when re-enabling an existing segment (cacheTime=%s)',
479
+ async (cacheTime) => {
480
+ const { calls, getRows } = endpoint();
481
+ const { result, rerender } = renderHook(({ enabled }) => useTableData({ getRows, enabled, cacheTime }), {
482
+ initialProps: { enabled: true },
483
+ });
484
+ await act(async () => calls[0]!.resolve({ rows: [row(1)], nextCursor: 'c2' }));
485
+ act(() => result.current.loadMore());
486
+ await act(async () => calls[1]!.resolve({ rows: [row(2)], nextCursor: 'c3' }));
487
+ expect(result.current.lastAppend).toEqual({ seq: 1, count: 1 });
488
+ rerender({ enabled: false });
489
+ rerender({ enabled: true });
490
+ if (cacheTime === 0) {
491
+ expect(calls[2]!.params.cursor).toBe('c2');
492
+ await act(async () => calls[2]!.resolve({ rows: [row(2)], nextCursor: 'c3' }));
493
+ } else {
494
+ expect(getRows).toHaveBeenCalledTimes(2);
495
+ }
496
+ expect(result.current.rows).toEqual([row(1), row(2)]);
497
+ expect(result.current.loadMoreProps.lastAppend).toEqual({ seq: 1, count: 1 });
498
+ act(() => result.current.loadMore());
499
+ await act(async () => calls.at(-1)!.resolve({ rows: [row(3)], nextCursor: null }));
500
+ expect(result.current.rows).toEqual([row(1), row(2), row(3)]);
501
+ expect(result.current.loadMoreProps.lastAppend).toEqual({ seq: 2, count: 1 });
502
+ },
503
+ );
504
+
505
+ it('never calls the endpoint or reads document while server rendering', () => {
506
+ const { getRows } = endpoint();
507
+ function ServerTable() {
508
+ useTableData({ getRows, revalidateInterval: 1000 });
509
+ return null;
510
+ }
511
+ const documentGetter = vi.spyOn(globalThis, 'document', 'get').mockImplementation(() => {
512
+ throw new Error('No document in SSR');
513
+ });
514
+ try {
515
+ expect(() => renderToString(<ServerTable />)).not.toThrow();
516
+ } finally {
517
+ documentGetter.mockRestore();
518
+ }
519
+ expect(getRows).not.toHaveBeenCalled();
520
+ });
521
+
522
+ it('resets to page one on every filter change, including a return to the original filters', async () => {
523
+ const { calls, getRows } = endpoint();
524
+ const { rerender } = renderHook(({ status }) => useTableData({ getRows, initialPage: 2, filters: { status } }), {
525
+ initialProps: { status: 'failed' },
526
+ });
527
+ await settle(calls[0]!, 21);
528
+ rerender({ status: 'running' });
529
+ await settle(calls[1]!, 1);
530
+ rerender({ status: 'failed' });
531
+ expect(calls[2]!.params).toMatchObject({ page: 1, filters: { status: 'failed' } });
532
+ });
533
+
534
+ it('combines an expired cursor cache entry with the current prefix and revalidates without a second append', async () => {
535
+ vi.useFakeTimers();
536
+ try {
537
+ const { calls, getRows } = endpoint();
538
+ const { result } = renderHook(() => useTableData({ getRows, cacheTime: 1000 }));
539
+ await act(async () => calls[0]!.resolve({ rows: [row(1)], nextCursor: 'c2' }));
540
+ act(() => result.current.loadMore());
541
+ await act(async () => calls[1]!.resolve({ rows: [row(2)], nextCursor: null }));
542
+ act(() => result.current.refetch());
543
+ await act(async () => calls[2]!.resolve({ rows: [row(9)], nextCursor: 'c2' }));
544
+ act(() => vi.advanceTimersByTime(1001));
545
+ act(() => result.current.loadMore());
546
+ expect(result.current).toMatchObject({ rows: [row(9), row(2)], isLoading: false, isFetching: true });
547
+ const seq = result.current.lastAppend.seq;
548
+ await act(async () => calls[3]!.resolve({ rows: [row(3)], nextCursor: null }));
549
+ expect(result.current.rows).toEqual([row(9), row(3)]);
550
+ expect(result.current.lastAppend.seq).toBe(seq);
551
+ } finally {
552
+ vi.useRealTimers();
553
+ }
554
+ });
555
+
556
+ it('invalidates all fresh pages and deduplicates only while a matching request is in flight', async () => {
557
+ const { calls, getRows } = endpoint();
558
+ const { result } = renderHook(() => useTableData({ getRows }));
559
+ await settle(calls[0]!, 1);
560
+ act(() => result.current.tableProps.onPageChange(2));
561
+ act(() => result.current.tableProps.onPageChange(2));
562
+ expect(getRows).toHaveBeenCalledTimes(2);
563
+ await settle(calls[1]!, 21);
564
+ act(() => result.current.invalidate());
565
+ expect(getRows).toHaveBeenCalledTimes(3);
566
+ await settle(calls[2]!, 22);
567
+ act(() => result.current.tableProps.onPageChange(1));
568
+ expect(getRows).toHaveBeenCalledTimes(4);
569
+ });
570
+
571
+ it.each(['invalidate', 'refetch'] as const)(
572
+ '%s aborts and replaces an active request, ignoring its late result and cache write',
573
+ async (reload) => {
574
+ const { calls, getRows } = endpoint();
575
+ const { result } = renderHook(() => useTableData({ getRows, initialPage: 2 }));
576
+ await settle(calls[0]!, 21);
577
+ act(() => result.current.tableProps.onPageChange(3));
578
+ act(() => result.current[reload]());
579
+ expect(getRows).toHaveBeenCalledTimes(3);
580
+ expect(calls[1]!.params.signal.aborted).toBe(true);
581
+ expect(calls[2]!.params).toMatchObject({ page: 3, pageSize: 20, sort: null });
582
+ expect(calls[2]!.params.signal).not.toBe(calls[1]!.params.signal);
583
+ await settle(calls[2]!, 42);
584
+ await settle(calls[1]!, 41);
585
+ expect(result.current.rows).toEqual([row(42)]);
586
+ act(() => result.current.tableProps.onPageChange(4));
587
+ await settle(calls[3]!, 61);
588
+ act(() => result.current.tableProps.onPageChange(3));
589
+ expect(getRows).toHaveBeenCalledTimes(4);
590
+ expect(result.current.rows).toEqual([row(42)]);
591
+ },
592
+ );
593
+
594
+ it.each(['resolve', 'reject'] as const)(
595
+ 'a late superseded %s cannot clear or replace the current failure',
596
+ async (outcome) => {
597
+ const { calls, getRows } = endpoint();
598
+ const onError = vi.fn();
599
+ const { result } = renderHook(() => useTableData({ getRows, onError, initialPage: 2 }));
600
+ await settle(calls[0]!, 21);
601
+ act(() => result.current.tableProps.onPageChange(3));
602
+ act(() => result.current.tableProps.onPageChange(4));
603
+ const failure = new Error('Current request failed');
604
+ await act(async () => calls[2]!.reject(failure));
605
+ await act(async () =>
606
+ outcome === 'resolve'
607
+ ? calls[1]!.resolve({ rows: [row(41)], rowCount: 95 })
608
+ : calls[1]!.reject(new Error('Superseded')),
609
+ );
610
+ expect(result.current).toMatchObject({ rows: [row(21)], error: failure, isFetching: false });
611
+ expect(onError).toHaveBeenCalledExactlyOnceWith(failure);
612
+ },
613
+ );