@gntik-ai/blocks 0.10.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 (248) hide show
  1. package/dist/index.d.ts +1761 -1231
  2. package/dist/index.js +3280 -1088
  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.labels.test.tsx +179 -0
  9. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.test.tsx +6 -0
  10. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.tsx +63 -25
  11. package/src/auth/ForgotPasswordForm/block.meta.ts +22 -1
  12. package/src/auth/ForgotPasswordForm/examples/Labels.tsx +29 -0
  13. package/src/auth/ForgotPasswordForm/examples/LargeFields.tsx +6 -0
  14. package/src/auth/MfaChallenge/MfaChallenge.labels.test.tsx +139 -0
  15. package/src/auth/MfaChallenge/MfaChallenge.test.tsx +9 -0
  16. package/src/auth/MfaChallenge/MfaChallenge.tsx +74 -25
  17. package/src/auth/MfaChallenge/block.meta.ts +29 -1
  18. package/src/auth/MfaChallenge/examples/Labels.tsx +28 -0
  19. package/src/auth/MfaChallenge/examples/LargeFields.tsx +6 -0
  20. package/src/auth/ResetPasswordForm/ResetPasswordForm.labels.test.tsx +104 -0
  21. package/src/auth/ResetPasswordForm/ResetPasswordForm.test.tsx +7 -0
  22. package/src/auth/ResetPasswordForm/ResetPasswordForm.tsx +47 -18
  23. package/src/auth/ResetPasswordForm/block.meta.ts +17 -1
  24. package/src/auth/ResetPasswordForm/examples/Labels.tsx +28 -0
  25. package/src/auth/ResetPasswordForm/examples/LargeFields.tsx +6 -0
  26. package/src/auth/SignInForm/SignInForm.labels.test.tsx +137 -0
  27. package/src/auth/SignInForm/SignInForm.test.tsx +7 -0
  28. package/src/auth/SignInForm/SignInForm.tsx +48 -17
  29. package/src/auth/SignInForm/block.meta.ts +22 -1
  30. package/src/auth/SignInForm/examples/Labels.tsx +29 -0
  31. package/src/auth/SignInForm/examples/LargeFields.tsx +6 -0
  32. package/src/auth/SignUpForm/SignUpForm.labels.test.tsx +217 -0
  33. package/src/auth/SignUpForm/SignUpForm.test.tsx +22 -0
  34. package/src/auth/SignUpForm/SignUpForm.tsx +72 -27
  35. package/src/auth/SignUpForm/block.meta.ts +27 -1
  36. package/src/auth/SignUpForm/examples/Labels.tsx +29 -0
  37. package/src/auth/SignUpForm/examples/LargeFields.tsx +6 -0
  38. package/src/auth/SsoButtons/SsoButtons.labels.test.tsx +30 -0
  39. package/src/auth/SsoButtons/SsoButtons.tsx +10 -2
  40. package/src/auth/SsoButtons/block.meta.ts +8 -1
  41. package/src/auth/SsoButtons/examples/Labels.tsx +24 -0
  42. package/src/auth/__snapshots__/field-size.test.tsx.snap +11 -0
  43. package/src/auth/field-size.test.tsx +21 -0
  44. package/src/auth/large-examples.test.tsx +30 -0
  45. package/src/auth/shared.i18n.test.tsx +71 -0
  46. package/src/auth/shared.tsx +55 -13
  47. package/src/billing/PaymentMethodCard/PaymentMethodCard.tsx +1 -1
  48. package/src/billing/PlanCard/PlanCard.baseline.test.tsx +3 -2
  49. package/src/billing/PlanCard/__snapshots__/PlanCard.baseline.test.tsx.snap +2 -2
  50. package/src/billing/PlanDefinitionCard/examples/Compact.tsx +1 -4
  51. package/src/billing/PlanDefinitionCard/examples/Full.tsx +1 -4
  52. package/src/builders/CodePanel/CodePanel.tsx +2 -2
  53. package/src/builders/FlowBuilder/FlowBuilder.tsx +4 -19
  54. package/src/builders/FlowBuilder/parts.tsx +4 -4
  55. package/src/builders/LogViewer/LogViewer.follow.test.tsx +29 -0
  56. package/src/builders/LogViewer/LogViewer.levels.test.tsx +49 -0
  57. package/src/builders/LogViewer/LogViewer.test.tsx +24 -0
  58. package/src/builders/LogViewer/LogViewer.tsx +96 -28
  59. package/src/builders/LogViewer/LogViewer.wrap.test.tsx +181 -0
  60. package/src/builders/LogViewer/block.meta.ts +7 -1
  61. package/src/builders/LogViewer/examples/Spanish.tsx +2 -1
  62. package/src/builders/LogViewer/examples/Wrap.tsx +62 -0
  63. package/src/builders/LogViewer/use-wrapped-log-rows.ts +42 -0
  64. package/src/data-display/ActivityFeed/ActivityFeed.tsx +1 -1
  65. package/src/data-display/ChartCard/ChartCard.tsx +2 -2
  66. package/src/data-display/ChartCard/examples/ContainerPanel.tsx +16 -0
  67. package/src/data-display/CommentThread/CommentThread.test.tsx +70 -1
  68. package/src/data-display/CommentThread/CommentThread.tsx +22 -6
  69. package/src/data-display/CommentThread/block.meta.ts +1 -1
  70. package/src/data-display/CommentThread/examples/RenderedBody.tsx +20 -0
  71. package/src/data-display/DescriptionListCard/DescriptionListCard.options.test.tsx +64 -0
  72. package/src/data-display/DescriptionListCard/DescriptionListCard.test.tsx +24 -1
  73. package/src/data-display/DescriptionListCard/DescriptionListCard.tsx +52 -37
  74. package/src/data-display/DescriptionListCard/block.meta.ts +2 -1
  75. package/src/data-display/DescriptionListCard/examples/Spanish.tsx +9 -1
  76. package/src/data-display/KpiRow/KpiRow.doc.ts +14 -0
  77. package/src/data-display/KpiRow/KpiRow.test.tsx +11 -0
  78. package/src/data-display/KpiRow/KpiRow.tsx +72 -55
  79. package/src/data-display/KpiRow/examples/ContainerPanel.tsx +47 -0
  80. package/src/data-display/ResourceCardGrid/ResourceCardGrid.doc.ts +19 -0
  81. package/src/data-display/ResourceCardGrid/ResourceCardGrid.test.tsx +13 -0
  82. package/src/data-display/ResourceCardGrid/ResourceCardGrid.tsx +49 -40
  83. package/src/data-display/ResourceCardGrid/examples/ContainerPanel.tsx +18 -0
  84. package/src/data-display/StatusTimeline/StatusTimeline.tsx +1 -1
  85. package/src/feedback/EmptyStates/EmptyStates.test.tsx +42 -0
  86. package/src/feedback/EmptyStates/EmptyStates.tsx +37 -17
  87. package/src/feedback/EmptyStates/NoAccessEmpty.options.test.tsx +38 -0
  88. package/src/feedback/EmptyStates/block.meta.ts +1 -1
  89. package/src/feedback/EmptyStates/examples/HiddenAction.tsx +13 -0
  90. package/src/feedback/EmptyStates/examples/Spanish.tsx +7 -0
  91. package/src/feedback/ErrorPanel/ErrorPanel.tsx +13 -15
  92. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.labels.test.tsx +115 -0
  93. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.lifecycle.test.tsx +123 -0
  94. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.tsx +153 -122
  95. package/src/forms/CreateApiKeyDialog/block.meta.ts +34 -2
  96. package/src/forms/CreateApiKeyDialog/examples/Labels.tsx +29 -0
  97. package/src/forms/CredentialDisclosureDialog/CredentialDisclosureDialog.labels.test.tsx +165 -0
  98. package/src/forms/CredentialDisclosureDialog/CredentialDisclosureDialog.tsx +31 -8
  99. package/src/forms/CredentialDisclosureDialog/SecretCopy.tsx +16 -8
  100. package/src/forms/CredentialDisclosureDialog/block.meta.ts +19 -1
  101. package/src/forms/CredentialDisclosureDialog/examples/Labels.tsx +38 -0
  102. package/src/forms/DangerZone/ConfirmDestructiveDialog.tsx +17 -3
  103. package/src/forms/DangerZone/DangerZone.labels.test.tsx +87 -0
  104. package/src/forms/DangerZone/DangerZone.tsx +20 -5
  105. package/src/forms/DangerZone/block.meta.ts +10 -1
  106. package/src/forms/DangerZone/examples/Labels.tsx +29 -0
  107. package/src/forms/DateRangeFilter/DateRangeFilter.labels.test.tsx +52 -0
  108. package/src/forms/DateRangeFilter/DateRangeFilter.tsx +11 -3
  109. package/src/forms/DateRangeFilter/block.meta.ts +8 -1
  110. package/src/forms/DateRangeFilter/examples/Labels.tsx +28 -0
  111. package/src/forms/DialogWizard/DialogWizard.labels.test.tsx +37 -0
  112. package/src/forms/DialogWizard/DialogWizard.tsx +13 -2
  113. package/src/forms/DialogWizard/block.meta.ts +7 -1
  114. package/src/forms/DialogWizard/examples/Labels.tsx +39 -0
  115. package/src/forms/FileUploadPanel/FileUploadPanel.controlled.test.tsx +482 -0
  116. package/src/forms/FileUploadPanel/FileUploadPanel.drag.test.tsx +60 -0
  117. package/src/forms/FileUploadPanel/FileUploadPanel.labels.test.tsx +126 -0
  118. package/src/forms/FileUploadPanel/FileUploadPanel.lifecycle.test.tsx +165 -0
  119. package/src/forms/FileUploadPanel/FileUploadPanel.tsx +336 -75
  120. package/src/forms/FileUploadPanel/block.meta.ts +26 -1
  121. package/src/forms/FileUploadPanel/examples/AutoCancel.tsx +38 -0
  122. package/src/forms/FileUploadPanel/examples/Labels.tsx +29 -0
  123. package/src/forms/FileUploadPanel/examples/ManualForm.tsx +36 -0
  124. package/src/forms/FileUploadPanel/fixtures.ts +31 -16
  125. package/src/forms/FileUploadPanel/simulate-upload.test.ts +24 -0
  126. package/src/forms/FormSection/FormSection.labels.test.tsx +37 -0
  127. package/src/forms/FormSection/FormSection.test.tsx +11 -0
  128. package/src/forms/FormSection/FormSection.tsx +34 -25
  129. package/src/forms/FormSection/block.meta.ts +7 -1
  130. package/src/forms/FormSection/examples/ContainerPanel.tsx +16 -0
  131. package/src/forms/FormSection/examples/Labels.tsx +27 -0
  132. package/src/forms/InviteMembersDialog/InviteMembersDialog.labels.test.tsx +87 -0
  133. package/src/forms/InviteMembersDialog/InviteMembersDialog.lifecycle.test.tsx +80 -0
  134. package/src/forms/InviteMembersDialog/InviteMembersDialog.tsx +121 -105
  135. package/src/forms/InviteMembersDialog/block.meta.ts +21 -2
  136. package/src/forms/InviteMembersDialog/examples/Labels.tsx +28 -0
  137. package/src/forms/SettingsRow/SettingsRow.labels.test.tsx +33 -0
  138. package/src/forms/SettingsRow/SettingsRow.tsx +14 -3
  139. package/src/forms/SettingsRow/block.meta.ts +7 -1
  140. package/src/forms/SettingsRow/examples/Labels.tsx +27 -0
  141. package/src/forms/ValidationSummary/ValidationSummary.labels.test.tsx +47 -0
  142. package/src/forms/ValidationSummary/ValidationSummary.tsx +10 -7
  143. package/src/forms/ValidationSummary/block.meta.ts +6 -1
  144. package/src/forms/ValidationSummary/examples/Labels.tsx +24 -0
  145. package/src/forms/index.ts +5 -1
  146. package/src/forms/translated-content.tsx +12 -0
  147. package/src/hooks/index.ts +2 -0
  148. package/src/hooks/useTableData.integration.test.tsx +89 -0
  149. package/src/hooks/useTableData.test.tsx +613 -0
  150. package/src/hooks/useTableData.ts +377 -0
  151. package/src/index.ts +1 -0
  152. package/src/marketing/ComparisonTable/ComparisonTable.tsx +2 -2
  153. package/src/marketing/FeatureGrid/FeatureGrid.tsx +1 -1
  154. package/src/marketing/LogoCloud/LogoCloud.doc.ts +13 -0
  155. package/src/marketing/LogoCloud/LogoCloud.test.tsx +155 -0
  156. package/src/marketing/LogoCloud/LogoCloud.tsx +89 -0
  157. package/src/marketing/LogoCloud/block.meta.ts +10 -0
  158. package/src/marketing/LogoCloud/examples/CaptionStart.tsx +6 -0
  159. package/src/marketing/LogoCloud/examples/Custom.tsx +25 -0
  160. package/src/marketing/LogoCloud/examples/Empty.tsx +6 -0
  161. package/src/marketing/LogoCloud/examples/Grid.tsx +13 -0
  162. package/src/marketing/LogoCloud/examples/Row.tsx +6 -0
  163. package/src/marketing/LogoCloud/examples/UnderHero.tsx +13 -0
  164. package/src/marketing/LogoCloud/fixtures.ts +23 -0
  165. package/src/marketing/PricingTable/PricingTable.tsx +1 -1
  166. package/src/marketing/SiteFooter/SiteFooter.doc.ts +18 -0
  167. package/src/marketing/SiteFooter/SiteFooter.test.tsx +236 -0
  168. package/src/marketing/SiteFooter/SiteFooter.tsx +160 -0
  169. package/src/marketing/SiteFooter/block.meta.ts +10 -0
  170. package/src/marketing/SiteFooter/examples/Centered.tsx +15 -0
  171. package/src/marketing/SiteFooter/examples/Columns.tsx +15 -0
  172. package/src/marketing/SiteFooter/examples/Custom.tsx +35 -0
  173. package/src/marketing/SiteFooter/examples/Empty.tsx +6 -0
  174. package/src/marketing/SiteFooter/examples/Simple.tsx +14 -0
  175. package/src/marketing/SiteFooter/fixtures.ts +36 -0
  176. package/src/marketing/index.ts +6 -0
  177. package/src/page-chrome/PageHeader/EditableTitle.test.tsx +26 -0
  178. package/src/page-chrome/PageHeader/PageHeader.options.test.tsx +34 -0
  179. package/src/page-chrome/PageHeader/PageHeader.tsx +11 -5
  180. package/src/page-chrome/PageHeader/block.meta.ts +1 -1
  181. package/src/page-chrome/PageHeader/examples/ContainerPanel.tsx +16 -0
  182. package/src/page-chrome/PageHeader/examples/EditableTitle.tsx +23 -0
  183. package/src/page-chrome/PageHeader/examples/Spanish.tsx +11 -0
  184. package/src/page-chrome/StickyActionBar/StickyActionBar.tsx +1 -1
  185. package/src/scheduling/AgendaList/AgendaList.tsx +39 -15
  186. package/src/scheduling/AgendaList/AgendaListZone.test.tsx +38 -0
  187. package/src/scheduling/AgendaList/block.meta.ts +1 -1
  188. package/src/scheduling/AgendaList/examples/TimeZone.tsx +28 -0
  189. package/src/scheduling/MonthCalendar/MonthCalendar.tsx +51 -40
  190. package/src/scheduling/MonthCalendar/MonthCalendarZone.test.tsx +44 -0
  191. package/src/scheduling/MonthCalendar/block.meta.ts +1 -1
  192. package/src/scheduling/MonthCalendar/examples/TimeZone.tsx +28 -0
  193. package/src/scheduling/WeekCalendar/WeekCalendar.tsx +37 -28
  194. package/src/scheduling/WeekCalendar/WeekCalendarZone.test.tsx +41 -0
  195. package/src/scheduling/WeekCalendar/block.meta.ts +1 -1
  196. package/src/scheduling/WeekCalendar/examples/TimeZone.tsx +28 -0
  197. package/src/scheduling/shared/CalendarHeader.tsx +26 -1
  198. package/src/scheduling/shared/dates.ts +102 -58
  199. package/src/scheduling/shared/events.ts +2 -2
  200. package/src/shell/AppSidebar/AppSidebar.context.test.tsx +175 -0
  201. package/src/shell/AppSidebar/AppSidebar.doc.ts +29 -0
  202. package/src/shell/AppSidebar/AppSidebar.tsx +97 -25
  203. package/src/shell/AppSidebar/block.meta.ts +1 -1
  204. package/src/shell/GlobalSearch/GlobalSearch.test.tsx +1 -0
  205. package/src/shell/GlobalSearch/GlobalSearch.tsx +1 -1
  206. package/src/tables/DataTable/DataTable.cross-page-selection.test.tsx +322 -0
  207. package/src/tables/DataTable/DataTable.cursor-example.test.tsx +67 -0
  208. package/src/tables/DataTable/DataTable.export.test.tsx +511 -0
  209. package/src/tables/DataTable/DataTable.inline-edit-focus.test.tsx +32 -0
  210. package/src/tables/DataTable/DataTable.labels.test.tsx +74 -0
  211. package/src/tables/DataTable/DataTable.layout.test.tsx +6 -5
  212. package/src/tables/DataTable/DataTable.link-actions.test.tsx +18 -0
  213. package/src/tables/DataTable/DataTable.server-pagination.test.tsx +329 -15
  214. package/src/tables/DataTable/DataTable.single-select.test.tsx +47 -7
  215. package/src/tables/DataTable/DataTable.test.tsx +140 -1
  216. package/src/tables/DataTable/DataTable.tsx +241 -80
  217. package/src/tables/DataTable/block.meta.ts +31 -3
  218. package/src/tables/DataTable/column-sizing.ts +2 -2
  219. package/src/tables/DataTable/data-table-props.ts +43 -6
  220. package/src/tables/DataTable/data-table-row.tsx +9 -5
  221. package/src/tables/DataTable/data-table-utils.ts +6 -0
  222. package/src/tables/DataTable/editable-cell.tsx +20 -79
  223. package/src/tables/DataTable/examples/client-selection.tsx +33 -0
  224. package/src/tables/DataTable/examples/csv-export.tsx +74 -0
  225. package/src/tables/DataTable/examples/cursor-load-more.tsx +87 -0
  226. package/src/tables/DataTable/examples/paginated-single-selection.tsx +46 -0
  227. package/src/tables/DataTable/examples/server-pagination.tsx +91 -44
  228. package/src/tables/DataTable/export-menu.tsx +58 -0
  229. package/src/tables/DataTable/header-cell.tsx +1 -1
  230. package/src/tables/DataTable/labels.ts +11 -0
  231. package/src/tables/DataTable/resize-handle.tsx +2 -2
  232. package/src/tables/DataTable/selection-strip.tsx +31 -0
  233. package/src/tables/DataTable/single-selection.tsx +0 -7
  234. package/src/tables/DataTable/use-multiple-selection.ts +86 -0
  235. package/src/tables/DataTable/use-table-export.ts +117 -0
  236. package/src/tables/FilterBar/FilterBar.test.tsx +12 -0
  237. package/src/tables/FilterBar/FilterBar.tsx +5 -7
  238. package/src/team/ProfileHeader/ProfileHeader.picker.test.tsx +34 -0
  239. package/src/team/ProfileHeader/ProfileHeader.test.tsx +2 -2
  240. package/src/team/ProfileHeader/ProfileHeader.tsx +17 -24
  241. package/src/team/ProfileHeader/block.meta.ts +1 -1
  242. package/src/test/OptInDefaults.test.tsx +36 -0
  243. package/src/test/clipboard-fallback.test.tsx +49 -0
  244. package/src/test/copy-examples.test.tsx +29 -0
  245. package/src/test/copy-feedback.test.tsx +166 -0
  246. package/src/test/fixtures/opt-in-defaults.json +10 -0
  247. package/src/test/without-forced-colors.test.ts +44 -0
  248. package/src/test/without-forced-colors.ts +14 -0
@@ -1,68 +1,115 @@
1
- import { useEffect, useState } from 'react';
2
- import { DataTable } from '../DataTable';
1
+ import { Button, Checkbox } from '@gntik-ai/ui';
2
+ import { useState } from 'react';
3
+ import { DataTable, type DataTableQuery } from '../DataTable';
4
+ import { useTableData } from '../../../hooks/useTableData';
5
+ import { ErrorPanel } from '../../../feedback/ErrorPanel/ErrorPanel';
6
+ import type { DataTableSelectionModel, SortState } from '../data-table-utils';
3
7
 
4
8
  interface Item {
5
9
  id: number;
6
10
  name: string;
11
+ locked: boolean;
7
12
  }
8
13
  interface Envelope {
9
14
  items: Item[];
10
15
  total: number;
11
16
  page: number;
12
17
  pageSize: number;
18
+ sort: SortState | null;
13
19
  }
14
20
  const columns = [
15
- { id: 'id', header: 'Id', accessor: (row: Item) => row.id },
16
- { id: 'name', header: 'Name', accessor: (row: Item) => row.name },
21
+ { id: 'id', header: 'Id', accessor: (row: Item) => row.id, sortable: true },
22
+ { id: 'name', header: 'Name', accessor: (row: Item) => row.name, sortable: true },
17
23
  ];
18
24
 
19
25
  // Demo endpoint adapter. Replace with the consumer's API returning this envelope.
20
- function readPage(page: number, pageSize: number): Envelope {
26
+ function readPage({ page, pageSize, sort }: Pick<DataTableQuery, 'page' | 'pageSize' | 'sort'>): Envelope {
21
27
  const total = 95;
22
28
  const from = (page - 1) * pageSize;
23
- return {
24
- items: Array.from({ length: Math.max(0, Math.min(pageSize, total - from)) }, (_, i) => ({
25
- id: from + i + 1,
26
- name: `Item ${from + i + 1}`,
27
- })),
28
- total,
29
- page,
30
- pageSize,
31
- };
29
+ const items = Array.from({ length: total }, (_, i) => ({
30
+ id: i + 1,
31
+ locked: (i + 1) % 10 === 4,
32
+ name: `Item ${i + 1}`,
33
+ }));
34
+ // Sorting and slicing belong to the endpoint adapter, never DataTable's server mode.
35
+ if (sort) {
36
+ items.sort((a, b) => {
37
+ const order = sort.columnId === 'id' ? a.id - b.id : a.name.localeCompare(b.name, 'en', { numeric: true });
38
+ return sort.direction === 'ascending' ? order : -order;
39
+ });
40
+ }
41
+ return { items: items.slice(from, from + pageSize), total, page, pageSize, sort };
32
42
  }
33
- async function requestPage(page: number, pageSize: number): Promise<Envelope> {
34
- return readPage(page, pageSize);
43
+ async function requestPage(query: DataTableQuery & { signal: AbortSignal }): Promise<Envelope> {
44
+ return readPage(query);
35
45
  }
36
46
 
37
- /** Known-total, 1-based pages. The consumer owns requests and keeps the old envelope until they resolve. */
38
- export default function ServerPaginationExample() {
39
- const [envelope, setEnvelope] = useState(() => readPage(2, 20));
40
- const [request, setRequest] = useState({ page: 2, pageSize: 20 });
41
- useEffect(() => {
42
- let active = true;
43
- void requestPage(request.page, request.pageSize).then((next) => {
44
- if (active) setEnvelope(next);
45
- });
46
- return () => {
47
- active = false;
48
- };
49
- }, [request]);
47
+ /** Known-total pages with aborts, per-instance caching, retained rows and retryable errors. */
48
+ export default function ServerPaginationExample({ request = requestPage }: { request?: typeof requestPage }) {
49
+ const [selection, setSelection] = useState<DataTableSelectionModel>({ type: 'include', ids: [] });
50
+ const [preserveSelection, setPreserveSelection] = useState(true);
51
+ const [hideSelectAll, setHideSelectAll] = useState(false);
52
+ const [review, setReview] = useState('');
53
+ const data = useTableData<Item>({
54
+ initialPage: 2,
55
+ getRows: async (params) => {
56
+ // Wrap an existing endpoint and pass signal through to fetch (or another fetcher).
57
+ const response = await request({ ...params, cause: 'page' });
58
+ return { rows: response.items, rowCount: response.total };
59
+ },
60
+ });
50
61
 
51
62
  return (
52
- <DataTable
53
- caption="Items"
54
- selectionMode="none"
55
- columns={columns}
56
- rows={envelope.items}
57
- paginationMode="server"
58
- rowCount={envelope.total}
59
- page={envelope.page}
60
- pageSize={envelope.pageSize}
61
- pageSizeOptions={[10, 20, 50]}
62
- onPageChange={(page) => setRequest((previous) => ({ ...previous, page }))}
63
- // The footer can also call onPageChange to keep the first row visible (20 to 50 at page 2 requests page 1).
64
- // Functional updates batch both callbacks into one request with the new size and page.
65
- onPageSizeChange={(pageSize) => setRequest((previous) => ({ ...previous, pageSize }))}
66
- />
63
+ <div className="space-y-3">
64
+ <Checkbox
65
+ label="Keep selections across pages"
66
+ checked={preserveSelection}
67
+ onCheckedChange={setPreserveSelection}
68
+ />
69
+ <Checkbox label="Hide page select-all" checked={hideSelectAll} onCheckedChange={setHideSelectAll} />
70
+ <DataTable
71
+ caption="Items"
72
+ selectionMode="multiple"
73
+ selectionModel={selection}
74
+ onSelectionModelChange={setSelection}
75
+ preserveSelection={preserveSelection}
76
+ hideSelectAll={hideSelectAll}
77
+ selectAllMatching
78
+ isRowDisabled={(row) => row.locked}
79
+ bulkActions={(ids, model) => (
80
+ <Button
81
+ variant="soft"
82
+ size="sm"
83
+ onClick={() =>
84
+ setReview(
85
+ model.type === 'exclude'
86
+ ? `Review all matching items except: ${model.ids.join(', ') || 'none'}`
87
+ : `Review items: ${ids.join(', ')}`,
88
+ )
89
+ }
90
+ >
91
+ Review selection
92
+ </Button>
93
+ )}
94
+ columns={columns}
95
+ {...data.tableProps}
96
+ pageSizeOptions={[10, 20, 50]}
97
+ />
98
+ {data.error != null && (
99
+ <ErrorPanel
100
+ title="Unable to load items"
101
+ message="Your previous rows are still available."
102
+ code={null}
103
+ requestId=""
104
+ details=""
105
+ secondaryAction={null}
106
+ onRetry={data.refetch}
107
+ retrying={data.isFetching}
108
+ />
109
+ )}
110
+ <p role="status" className="text-sm text-muted-foreground">
111
+ {review}
112
+ </p>
113
+ </div>
67
114
  );
68
115
  }
@@ -0,0 +1,58 @@
1
+ import { Download } from 'lucide-react';
2
+ import { Button, Menu, MenuTrigger, MenuContent, MenuItem, useI18n } from '@gntik-ai/ui';
3
+ import type { DataTableExportRequest } from './data-table-props';
4
+ import type { DataTableLabels } from './labels';
5
+
6
+ export function ExportMenu({
7
+ count,
8
+ selectedCount,
9
+ scopes,
10
+ busy,
11
+ onExport,
12
+ onCopy,
13
+ labels,
14
+ }: {
15
+ count: number;
16
+ selectedCount: number;
17
+ scopes: readonly string[];
18
+ busy: boolean;
19
+ onExport: (scope: DataTableExportRequest['scope']) => void;
20
+ onCopy?: () => void;
21
+ labels?: Partial<DataTableLabels>;
22
+ }) {
23
+ const { t, formatNumber } = useI18n();
24
+ return (
25
+ <Menu>
26
+ <MenuTrigger
27
+ disabled={busy}
28
+ aria-busy={busy || undefined}
29
+ render={<Button variant="secondary" size="sm" icon={Download} loading={busy} />}
30
+ >
31
+ {labels?.export ?? t('table.export')}
32
+ </MenuTrigger>
33
+ <MenuContent align="end">
34
+ {scopes.includes('rows') && (
35
+ <MenuItem disabled={busy} onClick={() => onExport('rows')}>
36
+ {labels?.exportAll?.(count) ?? t('table.exportAll', { count: formatNumber(count) })}
37
+ </MenuItem>
38
+ )}
39
+ {scopes.includes('page') && (
40
+ <MenuItem disabled={busy} onClick={() => onExport('page')}>
41
+ {labels?.exportPage ?? t('table.exportPage')}
42
+ </MenuItem>
43
+ )}
44
+ {scopes.includes('selected') && selectedCount > 0 && (
45
+ <MenuItem disabled={busy} onClick={() => onExport('selected')}>
46
+ {labels?.exportSelected?.(selectedCount) ??
47
+ t('table.exportSelected', { count: formatNumber(selectedCount) })}
48
+ </MenuItem>
49
+ )}
50
+ {scopes.includes('selected') && selectedCount > 0 && onCopy && (
51
+ <MenuItem disabled={busy} onClick={onCopy}>
52
+ {labels?.copySelected ?? t('table.copySelected')}
53
+ </MenuItem>
54
+ )}
55
+ </MenuContent>
56
+ </Menu>
57
+ );
58
+ }
@@ -29,7 +29,7 @@ export function DataTableHeadCell<T>({
29
29
  }: DataTableHeadCellProps<T>) {
30
30
  const align = columnAlign(column);
31
31
  const pinnedClass = layout?.pinned
32
- ? cn(layout.className, 'z-[11]', stickyTint(layout, { head: true }), 'bg-card')
32
+ ? cn(layout.className, 'z-sticky-pinned', stickyTint(layout, { head: true }), 'bg-card')
33
33
  : undefined;
34
34
  if (!resize) {
35
35
  return (
@@ -2,11 +2,22 @@ import type { PaginationFooterLabels } from '../PaginationFooter/PaginationFoote
2
2
 
3
3
  /** Per-instance table chrome, including the composed PaginationFooter. Caller data stays caller-owned. */
4
4
  export interface DataTableLabels extends PaginationFooterLabels {
5
+ export?: string;
6
+ exportAll?: (count: number) => string;
7
+ exportPage?: string;
8
+ exportSelected?: (count: number) => string;
9
+ copySelected?: string;
10
+ copiedToClipboard?: string;
11
+ copyFailed?: string;
5
12
  booleanTrue: string;
6
13
  booleanFalse: string;
7
14
  /** Non-virtual table overflow region; virtualized regions keep the caller caption. */
8
15
  scrollRegion: string;
9
16
  selectionCount: (count: number) => string;
17
+ pageSelected: (count: number) => string;
18
+ selectAllMatching: (count: number) => string;
19
+ allMatchingSelected: (count: number) => string;
20
+ clearSelection: string;
10
21
  columns: string;
11
22
  visibleColumns: string;
12
23
  pinColumns: string;
@@ -78,8 +78,8 @@ export function ColumnResizeHandle({ label, width, min, max, onResize, onResizeE
78
78
  onPointerCancel={onPointerUp}
79
79
  onKeyDown={onKeyDown}
80
80
  className={cn(
81
- 'group/resizer absolute inset-y-0 -end-1.5 z-[2] flex w-3 cursor-col-resize touch-none justify-center',
82
- 'focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-focus-ring',
81
+ 'group/resizer absolute inset-y-0 -end-1.5 z-raised flex w-3 cursor-col-resize touch-none justify-center',
82
+ 'focus-ring-inset',
83
83
  )}
84
84
  >
85
85
  <span
@@ -0,0 +1,31 @@
1
+ import { Button, useI18n } from '@gntik-ai/ui';
2
+ import type { DataTableLabels } from './labels';
3
+
4
+ /** The same button stays mounted as the announcement and action change. */
5
+ export function SelectionStrip({
6
+ all,
7
+ message,
8
+ total,
9
+ onSelectAll,
10
+ onClear,
11
+ labels,
12
+ }: {
13
+ all: boolean;
14
+ message: string;
15
+ total: number;
16
+ onSelectAll: () => void;
17
+ onClear: () => void;
18
+ labels?: Partial<DataTableLabels>;
19
+ }) {
20
+ const { t, formatNumber } = useI18n();
21
+ return (
22
+ <div className="flex flex-wrap items-center gap-2 border-b border-border bg-secondary/30 px-3 py-2 text-sm text-foreground">
23
+ <span aria-hidden="true">{message}</span>
24
+ <Button variant="soft" size="sm" onClick={all ? onClear : onSelectAll}>
25
+ {all
26
+ ? (labels?.clearSelection ?? t('common.clearSelection'))
27
+ : (labels?.selectAllMatching?.(total) ?? t('table.selectAllMatching', { count: formatNumber(total) }))}
28
+ </Button>
29
+ </div>
30
+ );
31
+ }
@@ -94,19 +94,12 @@ export function useSingleSelection<T>(options: {
94
94
  export function useSingleSelectionWarnings({
95
95
  single,
96
96
  selectionName,
97
- paginated,
98
97
  hasLabel,
99
98
  }: {
100
99
  single: boolean;
101
100
  selectionName?: string;
102
- paginated?: boolean;
103
101
  hasLabel: boolean;
104
102
  }) {
105
- useEffect(() => {
106
- if (single && paginated === true && process.env.NODE_ENV === 'development') {
107
- console.warn('DataTable single selection: paginated=true is unsupported; rendering all rows without pagination.');
108
- }
109
- }, [single, paginated]);
110
103
  useEffect(() => {
111
104
  if (!single || process.env.NODE_ENV !== 'development') return;
112
105
  if (!hasLabel) console.warn('DataTable single selection: supply legend, aria-label or aria-labelledby.');
@@ -0,0 +1,86 @@
1
+ import { useEffect, useEffectEvent, useRef, useState } from 'react';
2
+ import type { DataTableSelectionModel } from './data-table-utils';
3
+
4
+ /** Owns include/exclude selection independently of the currently supplied server page. */
5
+ export function useMultipleSelection(options: {
6
+ rowIds: string[];
7
+ enabledIds: string[];
8
+ selectedIds?: readonly string[];
9
+ defaultSelectedIds: readonly string[];
10
+ onSelectionChange?: (ids: string[]) => void;
11
+ preserveSelection: boolean;
12
+ selectionModel?: DataTableSelectionModel;
13
+ onSelectionModelChange?: (model: DataTableSelectionModel) => void;
14
+ serverMode: boolean;
15
+ selectAllMatching: boolean;
16
+ total: number;
17
+ filters?: unknown;
18
+ }) {
19
+ const needsModelCallback = options.serverMode && options.selectAllMatching && !options.onSelectionModelChange;
20
+ useEffect(() => {
21
+ if (needsModelCallback && process.env.NODE_ENV === 'development')
22
+ console.warn('DataTable selectAllMatching with server pagination requires onSelectionModelChange.');
23
+ }, [needsModelCallback]);
24
+ const [inner, setInner] = useState<DataTableSelectionModel>(() => ({
25
+ type: 'include',
26
+ ids: [...options.defaultSelectedIds],
27
+ }));
28
+ const model =
29
+ options.selectionModel ??
30
+ (options.selectedIds ? { type: 'include' as const, ids: [...options.selectedIds] } : inner);
31
+ const modelIds = new Set(model.ids);
32
+ const selected = new Set(model.type === 'exclude' ? options.enabledIds.filter((id) => !modelIds.has(id)) : model.ids);
33
+ const report = (next: DataTableSelectionModel) => {
34
+ const ids = new Set(next.ids);
35
+ if (next.type === 'exclude') return options.enabledIds.filter((id) => !ids.has(id));
36
+ return options.preserveSelection ? [...next.ids] : options.rowIds.filter((id) => ids.has(id));
37
+ };
38
+ const selectedList = report(model);
39
+ const change = (next: DataTableSelectionModel) => {
40
+ setInner(next);
41
+ options.onSelectionChange?.(report(next));
42
+ options.onSelectionModelChange?.(next);
43
+ };
44
+ const filterKey = JSON.stringify(options.filters);
45
+ const previousFilters = useRef(filterKey);
46
+ const resetForFilters = useEffectEvent(() => {
47
+ if (model.type === 'exclude') change({ type: 'include', ids: [] });
48
+ });
49
+ useEffect(() => {
50
+ if (previousFilters.current !== filterKey) {
51
+ previousFilters.current = filterKey;
52
+ resetForFilters();
53
+ }
54
+ }, [filterKey]);
55
+
56
+ return {
57
+ selected,
58
+ selectedList,
59
+ model,
60
+ selectedCount: model.type === 'exclude' ? Math.max(0, options.total - model.ids.length) : selectedList.length,
61
+ allMatchingSelected:
62
+ model.type === 'exclude' || (options.enabledIds.length > 0 && options.enabledIds.every((id) => selected.has(id))),
63
+ selectAllMatching: () =>
64
+ change(
65
+ options.serverMode
66
+ ? { type: 'exclude', ids: options.rowIds.filter((id) => !options.enabledIds.includes(id)) }
67
+ : { type: 'include', ids: options.enabledIds },
68
+ ),
69
+ clear: () => change({ type: 'include', ids: [] }),
70
+ setSelected: (next: Set<string>) => {
71
+ if (model.type === 'include') {
72
+ change({
73
+ type: 'include',
74
+ ids: [...next],
75
+ });
76
+ } else {
77
+ const excluded = new Set(model.ids);
78
+ for (const id of options.enabledIds) {
79
+ if (next.has(id)) excluded.delete(id);
80
+ else excluded.add(id);
81
+ }
82
+ change({ type: 'exclude', ids: [...excluded] });
83
+ }
84
+ },
85
+ };
86
+ }
@@ -0,0 +1,117 @@
1
+ import { copyToClipboard, downloadFile, toCsv, useI18n } from '@gntik-ai/ui';
2
+ import { useRef, useState, type KeyboardEvent } from 'react';
3
+ import type { DataTableCsvExportOptions, DataTableExportRequest } from './data-table-props';
4
+ import type { DataTableColumn, SortState } from './data-table-utils';
5
+ import type { DataTableLabels } from './labels';
6
+
7
+ export function useTableExport<T>(options: {
8
+ csvExport: boolean | DataTableCsvExportOptions;
9
+ onExport?: (request: DataTableExportRequest) => void | Promise<void>;
10
+ serverMode: boolean;
11
+ caption: string;
12
+ columns: ReadonlyArray<DataTableColumn<T>>;
13
+ sortedRows: readonly T[];
14
+ pageRows: readonly T[];
15
+ selectedIds: readonly string[];
16
+ getRowId: (row: T) => string;
17
+ sort: SortState | null;
18
+ filters: unknown;
19
+ labels?: Partial<DataTableLabels>;
20
+ }) {
21
+ const { t } = useI18n();
22
+ const pending = useRef(false);
23
+ const [busy, setBusy] = useState(false);
24
+ const [announcement, setAnnouncement] = useState('');
25
+ const enabled = !!options.csvExport && (!options.serverMode || !!options.onExport);
26
+ const config = typeof options.csvExport === 'object' ? options.csvExport : {};
27
+ const columns = enabled
28
+ ? options.columns.filter((column) => column.exportable !== false && (column.accessor || column.exportValue))
29
+ : [];
30
+ const fileName =
31
+ config.fileName ??
32
+ `${
33
+ options.caption
34
+ .toLowerCase()
35
+ .normalize('NFKD')
36
+ .replace(/\p{M}/gu, '')
37
+ .replace(/[^\p{L}\p{N}]+/gu, '-')
38
+ .replace(/^-|-$/g, '') || 'table'
39
+ }.csv`;
40
+ const selected = new Set(enabled && !options.serverMode ? options.selectedIds : []);
41
+ const selectedRows = selected.size ? options.sortedRows.filter((row) => selected.has(options.getRowId(row))) : [];
42
+ const csvColumns = columns.map((column) => ({
43
+ header: column.header,
44
+ value: (row: T) => column.exportValue?.(row) ?? column.accessor?.(row),
45
+ }));
46
+ const scopes = config.scopes ?? ['rows', 'page', 'selected'];
47
+ const copySelected = async () => {
48
+ if (!enabled || options.serverMode) return;
49
+ setAnnouncement('');
50
+ try {
51
+ await copyToClipboard(toCsv(selectedRows, csvColumns, { delimiter: '\t' }));
52
+ setAnnouncement(options.labels?.copiedToClipboard ?? t('common.copiedToClipboard'));
53
+ } catch {
54
+ setAnnouncement(options.labels?.copyFailed ?? t('common.copyFailed'));
55
+ }
56
+ };
57
+ const onCopyKeyDown = (event: KeyboardEvent<HTMLDivElement>) => {
58
+ if (
59
+ !enabled ||
60
+ options.serverMode ||
61
+ !scopes.includes('selected') ||
62
+ selectedRows.length === 0 ||
63
+ pending.current ||
64
+ event.defaultPrevented ||
65
+ event.altKey ||
66
+ !(event.ctrlKey || event.metaKey) ||
67
+ event.key.toLowerCase() !== 'c'
68
+ )
69
+ return;
70
+ const target = event.target;
71
+ if (
72
+ !(target instanceof HTMLElement) ||
73
+ !target.closest('table') ||
74
+ target.closest('input, textarea, select') ||
75
+ target.isContentEditable
76
+ )
77
+ return;
78
+ const editable = target.closest('[contenteditable]');
79
+ if (editable && editable.getAttribute('contenteditable') !== 'false') return;
80
+ if (window.getSelection()?.isCollapsed === false) return;
81
+ event.preventDefault();
82
+ void copySelected();
83
+ };
84
+ return {
85
+ busy,
86
+ selectedRowCount: selectedRows.length,
87
+ announcement,
88
+ copySelected,
89
+ onCopyKeyDown,
90
+ enabled,
91
+ scopes,
92
+ exportRows: async (scope: DataTableExportRequest['scope']) => {
93
+ if (pending.current) return;
94
+ if (options.onExport) {
95
+ pending.current = true;
96
+ setBusy(true);
97
+ try {
98
+ await options.onExport({
99
+ scope,
100
+ columns: columns.map((column) => column.id),
101
+ selectedIds: [...options.selectedIds],
102
+ sort: options.sort,
103
+ filters: options.filters,
104
+ });
105
+ } catch {
106
+ // Delegated exports own their error feedback; always release the menu for retry.
107
+ } finally {
108
+ pending.current = false;
109
+ setBusy(false);
110
+ }
111
+ return;
112
+ }
113
+ const rows = scope === 'rows' ? options.sortedRows : scope === 'page' ? options.pageRows : selectedRows;
114
+ downloadFile(toCsv(rows, csvColumns, { bom: true }), fileName, 'text/csv;charset=utf-8');
115
+ },
116
+ };
117
+ }
@@ -40,4 +40,16 @@ describe('FilterBar', () => {
40
40
  expect(screen.getByRole('button', { name: 'Remove filter Status: Degraded' })).toBeInTheDocument();
41
41
  expect(screen.queryByRole('button', { name: 'Remove filter Status: Running' })).toBeNull();
42
42
  });
43
+
44
+ it('clears the search with its button and reports the empty query', async () => {
45
+ const user = userEvent.setup();
46
+ const onQueryChange = vi.fn();
47
+ render(<FilterBar onQueryChange={onQueryChange} />);
48
+ const search = screen.getByRole('searchbox', { name: 'Search' });
49
+ await user.type(search, 'api');
50
+ await user.click(screen.getByRole('button', { name: 'Clear Search' }));
51
+ expect(search).toHaveValue('');
52
+ expect(search).toHaveFocus();
53
+ expect(onQueryChange).toHaveBeenLastCalledWith('');
54
+ });
43
55
  });
@@ -1,8 +1,7 @@
1
- import { ListFilter, Plus, Search } from '@gntik-ai/icons';
1
+ import { ListFilter, Plus } from '@gntik-ai/icons';
2
2
  import {
3
3
  Button,
4
4
  cn,
5
- Input,
6
5
  Menu,
7
6
  MenuCheckboxItem,
8
7
  MenuContent,
@@ -10,6 +9,7 @@ import {
10
9
  MenuGroupLabel,
11
10
  MenuSeparator,
12
11
  MenuTrigger,
12
+ SearchField,
13
13
  SimpleSelect,
14
14
  Token,
15
15
  useI18n,
@@ -75,7 +75,7 @@ export interface FilterBarProps {
75
75
  const same = (a: ActiveFilter, b: ActiveFilter) => a.field === b.field && a.value === b.value;
76
76
 
77
77
  /**
78
- * Filter bar: search Input, saved views Select, an "Add filter" Menu (multi-select per field),
78
+ * Filter bar: SearchField, saved views Select, an "Add filter" Menu (multi-select per field),
79
79
  * removable filter chips (Token) and Clear all.
80
80
  */
81
81
  export function FilterBar({
@@ -137,11 +137,9 @@ export function FilterBar({
137
137
  className={cn('flex flex-col gap-3', className)}
138
138
  >
139
139
  <div className="flex flex-col gap-2 sm:flex-row sm:items-center">
140
- <Input
140
+ <SearchField
141
141
  aria-label={searchLabel}
142
- type="search"
143
142
  size="sm"
144
- leadingIcon={Search}
145
143
  placeholder={placeholder}
146
144
  value={query}
147
145
  onValueChange={(v) => setQuery(String(v))}
@@ -202,7 +200,7 @@ export function FilterBar({
202
200
  </div>
203
201
  {hasAny && (
204
202
  <div className="flex flex-wrap items-center gap-2">
205
- <span className="inline-flex items-center gap-1.5 font-mono text-[10px] tracking-[0.14em] text-muted-foreground uppercase">
203
+ <span className="inline-flex items-center gap-1.5 font-mono text-[10px] tracking-[0.14em] text-muted-foreground label-case">
206
204
  <ListFilter size={12} aria-hidden />
207
205
  {labels?.filters ?? 'Filters'}
208
206
  </span>
@@ -0,0 +1,34 @@
1
+ import { fireEvent, render, screen, waitFor } from '@testing-library/react';
2
+ import { Popover, PopoverContent, PopoverTrigger } from '@gntik-ai/ui';
3
+ import { ProfileHeader } from './ProfileHeader';
4
+
5
+ it('attaches the avatar picker outside the block and removes it when the action is hidden', () => {
6
+ const { container, rerender } = render(<ProfileHeader />);
7
+ expect(container.querySelector('input[type=file]')).toBeNull();
8
+ expect(document.querySelector('input[type=file]')).toHaveAttribute('accept', 'image/*');
9
+ rerender(<ProfileHeader onAvatarChange={null} />);
10
+ expect(document.querySelector('input[type=file]')).toBeNull();
11
+ });
12
+
13
+ it('keeps the avatar action mounted inside a Popover until the file is delivered', async () => {
14
+ const onAvatarChange = vi.fn();
15
+ render(
16
+ <Popover defaultOpen>
17
+ <PopoverTrigger>Open profile</PopoverTrigger>
18
+ <PopoverContent aria-label="Profile">
19
+ <section aria-label="Profile header">
20
+ <ProfileHeader onAvatarChange={onAvatarChange} />
21
+ </section>
22
+ </PopoverContent>
23
+ </Popover>,
24
+ );
25
+ const panel = screen.getByRole('dialog', { name: 'Profile' });
26
+ await waitFor(() => expect(panel).toBeVisible());
27
+ const picker = document.querySelector<HTMLInputElement>('input[type=file]')!;
28
+ fireEvent.click(screen.getByRole('button', { name: 'Change avatar' }));
29
+ const file = new File(['avatar'], 'avatar.png', { type: 'image/png' });
30
+ fireEvent.change(picker, { target: { files: [file] } });
31
+ expect(panel).toBeVisible();
32
+ expect(onAvatarChange).toHaveBeenCalledExactlyOnceWith(file);
33
+ expect(screen.getByRole('region', { name: 'Profile header' }).querySelector('input[type=file]')).toBeNull();
34
+ });
@@ -15,10 +15,10 @@ describe('ProfileHeader', () => {
15
15
  it('edits and changes the avatar', async () => {
16
16
  const onEdit = vi.fn();
17
17
  const onAvatarChange = vi.fn();
18
- const { container } = render(<ProfileHeader onEdit={onEdit} onAvatarChange={onAvatarChange} />);
18
+ render(<ProfileHeader onEdit={onEdit} onAvatarChange={onAvatarChange} />);
19
19
  await userEvent.click(screen.getByRole('button', { name: 'Edit profile' }));
20
20
  expect(onEdit).toHaveBeenCalledOnce();
21
- const input = container.querySelector('input[type="file"]') as HTMLInputElement;
21
+ const input = document.querySelector('input[type="file"]') as HTMLInputElement;
22
22
  const click = vi.spyOn(input, 'click');
23
23
  await userEvent.click(screen.getByRole('button', { name: 'Change avatar' }));
24
24
  expect(click).toHaveBeenCalled();