@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
@@ -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
+ );