@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,12 +1,38 @@
1
1
  import type { MoreMenuAction, TableDensity } from '@gntik-ai/ui';
2
2
  import type { ReactNode } from 'react';
3
3
  import type { ColumnWidths, PinnedColumns } from './column-sizing';
4
- import type { DataTableColumn, DataTableGroupBy, SortState } from './data-table-utils';
4
+ import type { DataTableColumn, DataTableGroupBy, DataTableSelectionModel, SortState } from './data-table-utils';
5
5
  import type { DataTableCellEditHandler } from './editable-cell';
6
6
  import type { DataTableLabels } from './labels';
7
7
  import type { DataTableView } from './views';
8
8
 
9
+ /** Complete next query, emitted synchronously once per user action in either pagination mode. */
10
+ export interface DataTableQuery {
11
+ page: number;
12
+ pageSize: number;
13
+ sort: SortState | null;
14
+ filters: unknown;
15
+ cause: 'page' | 'pageSize' | 'sort' | 'view';
16
+ }
17
+
18
+ export interface DataTableCsvExportOptions {
19
+ fileName?: string;
20
+ scopes?: Array<'rows' | 'page' | 'selected'>;
21
+ }
22
+
23
+ export interface DataTableExportRequest {
24
+ scope: 'rows' | 'page' | 'selected';
25
+ columns: string[];
26
+ selectedIds: string[];
27
+ sort: SortState | null;
28
+ filters: unknown;
29
+ }
30
+
9
31
  interface DataTableCommonProps<T> {
32
+ /** Opt-in CSV menu. Values are raw, with spreadsheet formula protection. */
33
+ csvExport?: boolean | DataTableCsvExportOptions;
34
+ /** Delegate exports to the consumer; required for server pagination. */
35
+ onExport?: (request: DataTableExportRequest) => void | Promise<void>;
10
36
  /** Per-key overrides; omitted keys keep existing defaults and provider translations. */
11
37
  labels?: Partial<DataTableLabels>;
12
38
  rows?: readonly T[];
@@ -30,8 +56,18 @@ interface DataTableCommonProps<T> {
30
56
  selectedIds?: readonly string[];
31
57
  defaultSelectedIds?: readonly string[];
32
58
  onSelectionChange?: (ids: string[]) => void;
59
+ /** Keep ids absent from rows. Defaults to true for server pagination, false for client pagination. */
60
+ preserveSelection?: boolean;
61
+ /** Offer to extend a selected page to all matching rows (default false). */
62
+ selectAllMatching?: boolean;
63
+ /** Hide the page select-all checkbox, retaining row controls and the column heading. */
64
+ hideSelectAll?: boolean;
65
+ /** Controlled model; takes precedence over selectedIds. */
66
+ selectionModel?: DataTableSelectionModel;
67
+ /** Required to offer select-all-matching with server pagination. */
68
+ onSelectionModelChange?: (model: DataTableSelectionModel) => void;
33
69
  /** Rendered in the toolbar while rows are selected. */
34
- bulkActions?: (selectedIds: string[]) => ReactNode;
70
+ bulkActions?: (selectedIds: string[], selection: DataTableSelectionModel) => ReactNode;
35
71
  /**
36
72
  * Shows the "N selected" text in the toolbar while rows are selected (default true). Turn it
37
73
  * off when the page renders its own count, e.g. a BulkActionBar.
@@ -44,6 +80,8 @@ interface DataTableCommonProps<T> {
44
80
  sort?: SortState | null;
45
81
  defaultSort?: SortState | null;
46
82
  onSortChange?: (sort: SortState) => void;
83
+ /** Use this OR the separate callbacks for fetching, to avoid duplicate requests. Prop changes do not emit queries. */
84
+ onQueryChange?: (query: DataTableQuery) => void;
47
85
  /** Rows arrive sorted (server side): headers still toggle, rows are not re-sorted. */
48
86
  manualSorting?: boolean;
49
87
 
@@ -149,7 +187,7 @@ interface ClientPaginationProps {
149
187
  }
150
188
 
151
189
  interface ServerPaginationProps {
152
- /** Rows arrive as one server page: no client sorting or slicing, and no sortable headers. */
190
+ /** Rows arrive as one server page without client sorting or slicing. Sortable headers require onSortChange or onQueryChange; sorting requests page 1. */
153
191
  paginationMode: 'server';
154
192
  /** Total number of rows across all pages; required even for an empty result. */
155
193
  rowCount: number;
@@ -165,13 +203,12 @@ export type DataTableProps<T> = DataTableCommonProps<T> &
165
203
  (
166
204
  | ({
167
205
  selectionMode: 'single';
168
- paginated?: false;
206
+ paginated?: boolean;
169
207
  /** Consumer-supplied accessible group label; the kit adds no default. */
170
208
  legend?: ReactNode;
171
209
  'aria-label'?: string;
172
210
  'aria-labelledby'?: string;
173
- paginationMode?: never;
174
- } & ClientPaginationProps)
211
+ } & (ClientPaginationProps | ServerPaginationProps))
175
212
  | ({
176
213
  selectionMode?: 'none' | 'multiple';
177
214
  paginated?: boolean;
@@ -34,6 +34,7 @@ export interface DataTableBodyGroup<T> {
34
34
  rows: readonly T[];
35
35
  /** Ids of every row in the group (all pages): the count and the group checkbox use them. */
36
36
  ids: readonly string[];
37
+ selectableIds: readonly string[];
37
38
  }
38
39
 
39
40
  /** Row rendering shared by the plain, grouped and virtualized bodies. */
@@ -43,6 +44,7 @@ export interface RowContext<T> {
43
44
  getRowId: (row: T) => string;
44
45
  getRowLabel: (row: T) => string;
45
46
  selectable: boolean;
47
+ isRowDisabled?: (row: T) => boolean;
46
48
  selected: ReadonlySet<string>;
47
49
  singleSelection?: SingleSelection<T>;
48
50
  onToggleRow: (id: string) => void;
@@ -67,6 +69,7 @@ export function DataTableRow<T>({
67
69
  getRowId,
68
70
  getRowLabel,
69
71
  selectable,
72
+ isRowDisabled,
70
73
  selected,
71
74
  singleSelection,
72
75
  onToggleRow,
@@ -92,13 +95,14 @@ export function DataTableRow<T>({
92
95
  <span {...singleSelection.entryProps(row)} className="inline-flex">
93
96
  <input
94
97
  {...singleSelection.inputProps(row)}
95
- className="size-4 accent-primary focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-ring disabled:cursor-not-allowed"
98
+ className="size-4 accent-primary focus-ring disabled:cursor-not-allowed"
96
99
  />
97
100
  </span>
98
101
  ) : (
99
102
  <Checkbox
100
103
  aria-label={labels?.selectRow?.(label) ?? t('table.selectRow', { label })}
101
104
  checked={isSelected}
105
+ disabled={isRowDisabled?.(row)}
102
106
  onCheckedChange={() => onToggleRow(id)}
103
107
  />
104
108
  )}
@@ -196,7 +200,7 @@ export function GroupHeaderRow<T>({
196
200
  style,
197
201
  }: GroupHeaderRowProps<T>) {
198
202
  const { t } = useI18n();
199
- const state = selectionState(group.ids, selected);
203
+ const state = selectionState(group.selectableIds, selected);
200
204
  const count = group.ids.length;
201
205
  const heading = (
202
206
  <>
@@ -215,8 +219,8 @@ export function GroupHeaderRow<T>({
215
219
  aria-label={labels?.selectGroup?.(group.name) ?? t('table.selectRow', { label: `all in ${group.name}` })}
216
220
  checked={state.checked}
217
221
  indeterminate={state.indeterminate}
218
- disabled={count === 0}
219
- onCheckedChange={() => onToggleRows?.(group.ids)}
222
+ disabled={group.selectableIds.length === 0}
223
+ onCheckedChange={() => onToggleRows?.(group.selectableIds)}
220
224
  />
221
225
  </TableCell>
222
226
  )}
@@ -226,7 +230,7 @@ export function GroupHeaderRow<T>({
226
230
  type="button"
227
231
  aria-expanded={open}
228
232
  onClick={() => onToggle?.(group.key)}
229
- className="inline-flex max-w-full items-center gap-1.5 rounded-sm px-1 py-0.5 hover:bg-secondary focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-ring"
233
+ className="inline-flex max-w-full items-center gap-1.5 rounded-sm px-1 py-0.5 hover:bg-secondary focus-ring"
230
234
  >
231
235
  <ChevronRight
232
236
  size={14}
@@ -1,6 +1,8 @@
1
1
  import type { ReactNode } from 'react';
2
2
 
3
3
  export type SortDirectionValue = 'ascending' | 'descending';
4
+ /** Include lists selected ids; exclude selects every match except the listed ids. */
5
+ export type DataTableSelectionModel = { type: 'include'; ids: string[] } | { type: 'exclude'; ids: string[] };
4
6
  export type CellValue = string | number | boolean | Date | null | undefined;
5
7
 
6
8
  export type DataTableColumnVariant = 'default' | 'mono' | 'muted' | 'numeric';
@@ -26,6 +28,10 @@ export interface DataTableColumn<T> {
26
28
  header: string;
27
29
  /** Raw value: used to sort, and rendered when `cell` is absent. */
28
30
  accessor?: (row: T) => CellValue;
31
+ /** Raw CSV/clipboard value; nullish results fall back to the accessor. */
32
+ exportValue?: (row: T) => CellValue;
33
+ /** Include in CSV/clipboard output (default true). Hidden columns are always omitted. */
34
+ exportable?: boolean;
29
35
  /** Custom cell rendering. */
30
36
  cell?: (row: T) => ReactNode;
31
37
  sortable?: boolean;
@@ -1,14 +1,5 @@
1
- import { cn, Input } from '@gntik-ai/ui';
2
- import {
3
- useCallback,
4
- useEffect,
5
- useId,
6
- useRef,
7
- useState,
8
- type FocusEvent,
9
- type KeyboardEvent,
10
- type ReactNode,
11
- } from 'react';
1
+ import { cn, Input, useInlineEdit } from '@gntik-ai/ui';
2
+ import { useCallback, useId, useRef, type FocusEvent, type KeyboardEvent, type ReactNode } from 'react';
12
3
  import type { DataTableLabels } from './labels';
13
4
  import type { DataTableColumn } from './data-table-utils';
14
5
 
@@ -48,7 +39,6 @@ export interface EditableCellProps<T> {
48
39
  }
49
40
 
50
41
  const GENERIC_ERROR = 'The change could not be saved.';
51
- type Move = 'self' | 'next' | 'prev' | null;
52
42
 
53
43
  /** Starting value of the editor for a row. */
54
44
  function startValue<T>(row: T, column: DataTableColumn<T>): string | number | null {
@@ -86,22 +76,8 @@ export function EditableCell<T>({
86
76
  }: EditableCellProps<T>) {
87
77
  const errorId = useId();
88
78
  const editor = column.editor ?? { type: 'text' as const };
89
- const [editing, setEditing] = useState(false);
90
- const [draft, setDraft] = useState('');
91
- const [error, setError] = useState<string | null>(null);
92
- const [pending, setPending] = useState(false);
93
79
  const trigger = useRef<HTMLButtonElement>(null);
94
80
  const field = useRef<HTMLInputElement | HTMLSelectElement | null>(null);
95
- const move = useRef<Move>(null);
96
- const busy = useRef(false);
97
-
98
- useEffect(() => {
99
- if (editing || !move.current) return;
100
- const dir = move.current;
101
- move.current = null;
102
- if (dir === 'self') trigger.current?.focus();
103
- else focusSibling(trigger.current, dir);
104
- }, [editing]);
105
81
 
106
82
  const focusOnMount = useCallback((el: HTMLInputElement | HTMLSelectElement | null) => {
107
83
  field.current = el;
@@ -110,19 +86,7 @@ export function EditableCell<T>({
110
86
  if (el instanceof HTMLInputElement) el.select();
111
87
  }, []);
112
88
 
113
- const start = () => {
114
- const v = startValue(row, column);
115
- setDraft(v == null ? '' : String(v));
116
- setError(null);
117
- setEditing(true);
118
- };
119
- const cancel = () => {
120
- move.current = 'self';
121
- setError(null);
122
- setEditing(false);
123
- };
124
-
125
- const parse = (): { ok: true; value: string | number | null } | { ok: false; message: string } => {
89
+ const parse = (draft: string): { ok: true; value: string | number | null } | { ok: false; message: string } => {
126
90
  if (editor.type !== 'number') return { ok: true, value: draft };
127
91
  const text = draft.trim();
128
92
  if (text === '') return { ok: true, value: null };
@@ -135,44 +99,21 @@ export function EditableCell<T>({
135
99
  return { ok: true, value: n };
136
100
  };
137
101
 
138
- const commit = async (after: Move) => {
139
- if (busy.current) return;
140
- const parsed = parse();
141
- if (!parsed.ok) {
142
- setError(parsed.message);
143
- field.current?.focus();
144
- return;
145
- }
146
- const previous = startValue(row, column);
147
- if (
148
- parsed.value === previous ||
149
- (previous != null && String(previous) === String(parsed.value) && editor.type !== 'number')
150
- ) {
151
- move.current = after;
152
- setError(null);
153
- setEditing(false);
154
- return;
155
- }
156
- busy.current = true;
157
- setPending(true);
158
- let result: DataTableCellEditResult;
159
- try {
160
- result = await onCellEdit({ row, rowId, columnId: column.id, value: parsed.value, previous });
161
- } catch (err) {
162
- result = err instanceof Error && err.message ? err.message : (labels?.editError ?? GENERIC_ERROR);
163
- }
164
- busy.current = false;
165
- setPending(false);
166
- if (result === false) result = labels?.editError ?? GENERIC_ERROR;
167
- if (typeof result === 'string') {
168
- setError(result);
169
- if (after) field.current?.focus();
170
- return;
171
- }
172
- move.current = after;
173
- setError(null);
174
- setEditing(false);
175
- };
102
+ const { editing, draft, setDraft, error, pending, busy, start, cancel, commit } = useInlineEdit({
103
+ value: startValue(row, column),
104
+ parse,
105
+ genericError: labels?.editError ?? GENERIC_ERROR,
106
+ focusEditor: (after) => {
107
+ if (after !== null) field.current?.focus();
108
+ },
109
+ isEqual: (next, previous) =>
110
+ next === previous || (previous != null && String(previous) === String(next) && editor.type !== 'number'),
111
+ onSave: (value, previous) => onCellEdit({ row, rowId, columnId: column.id, value, previous }),
112
+ onMove: (dir) => {
113
+ if (dir === 'self') trigger.current?.focus();
114
+ else focusSibling(trigger.current, dir);
115
+ },
116
+ });
176
117
 
177
118
  const onEditorKeyDown = (e: KeyboardEvent<HTMLInputElement | HTMLSelectElement>) => {
178
119
  if (e.key === 'Escape') {
@@ -209,7 +150,7 @@ export function EditableCell<T>({
209
150
  }}
210
151
  className={cn(
211
152
  '-mx-1.5 -my-1 block max-w-[calc(100%+0.75rem)] min-w-[calc(100%+0.75rem)] cursor-text truncate rounded-sm px-1.5 py-1 text-inherit',
212
- 'hover:bg-secondary/60 focus-visible:outline-2 focus-visible:outline-offset-0 focus-visible:outline-focus-ring',
153
+ 'hover:bg-secondary/60 focus-ring-inset',
213
154
  column.align === 'right' || column.variant === 'numeric' ? 'text-end' : 'text-start',
214
155
  )}
215
156
  >
@@ -240,7 +181,7 @@ export function EditableCell<T>({
240
181
  }}
241
182
  className={cn(
242
183
  'h-8 w-full rounded-md border border-input bg-background px-2 text-[13px] text-foreground',
243
- 'focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus-ring',
184
+ 'focus-ring',
244
185
  error && 'border-destructive',
245
186
  )}
246
187
  {...common}
@@ -0,0 +1,33 @@
1
+ import { Checkbox } from '@gntik-ai/ui';
2
+ import { useState } from 'react';
3
+ import { DataTable } from '../DataTable';
4
+
5
+ const rows = Array.from({ length: 95 }, (_, index) => ({
6
+ id: String(index + 1),
7
+ name: `Item ${index + 1}`,
8
+ locked: index === 3,
9
+ }));
10
+ const columns = [{ id: 'name', header: 'Name', accessor: (row: (typeof rows)[number]) => row.name }];
11
+
12
+ /** Client preservation retains a selected row even when the consumer removes it from rows. */
13
+ export default function ClientSelectionExample() {
14
+ const [showFirst, setShowFirst] = useState(true);
15
+ const [ids, setIds] = useState<string[]>([]);
16
+ return (
17
+ <div className="space-y-3">
18
+ <Checkbox label="Show first item" checked={showFirst} onCheckedChange={setShowFirst} />
19
+ <DataTable
20
+ caption="Items"
21
+ rows={showFirst ? rows : rows.slice(1)}
22
+ columns={columns}
23
+ preserveSelection
24
+ selectAllMatching
25
+ isRowDisabled={(row) => row.locked}
26
+ onSelectionChange={setIds}
27
+ />
28
+ <p role="status" className="text-sm text-muted-foreground">
29
+ Selected ids: {ids.join(', ') || 'none'}
30
+ </p>
31
+ </div>
32
+ );
33
+ }
@@ -0,0 +1,74 @@
1
+ import { useState } from 'react';
2
+ import { DataTable, type DataTableExportRequest } from '../DataTable';
3
+ import { DEPLOYMENT_COLUMNS, generateDeployments } from '../fixtures';
4
+
5
+ const rows = generateDeployments(95);
6
+ const columns = DEPLOYMENT_COLUMNS.map((column) => ({
7
+ ...column,
8
+ // A custom export value can differ from the displayed cell. Other values stay raw.
9
+ exportValue: column.id === 'name' ? (row: (typeof rows)[number]) => `${row.name} / ${row.region}` : undefined,
10
+ exportable: column.id !== 'status',
11
+ }));
12
+
13
+ /** CSV uses raw values and formula protection. Use onExport for large or server-side results. */
14
+ export default function CsvExportExample() {
15
+ const [request, setRequest] = useState<DataTableExportRequest | null>(null);
16
+ return (
17
+ <div className="space-y-6">
18
+ <section className="space-y-3" aria-label="Client CSV export">
19
+ <p className="text-sm text-muted-foreground">
20
+ Export all rows, the current page, or the selected rows across pages. Copy selected rows from the menu or
21
+ press Ctrl/Cmd+C inside the table without selecting text. Hidden columns and Status are omitted; Name uses
22
+ exportValue. Dates export as ISO strings and numbers remain unformatted.
23
+ </p>
24
+ <DataTable
25
+ caption="Deployments"
26
+ rows={rows}
27
+ columns={columns}
28
+ hiddenColumns={['region']}
29
+ defaultSelectedIds={[rows[1]!.id, rows[14]!.id]}
30
+ defaultSort={{ columnId: 'name', direction: 'ascending' }}
31
+ selectAllMatching
32
+ csvExport={{ fileName: 'deployments.csv', scopes: ['rows', 'page', 'selected'] }}
33
+ />
34
+ </section>
35
+ <section className="space-y-3" aria-label="Delegated server export">
36
+ <p className="text-sm text-muted-foreground">
37
+ For large result sets, onExport handles the request instead of building a file in the browser. The trigger
38
+ stays focusable and busy until it settles. The consumer owns error feedback and fetching all server rows.
39
+ Server tables omit clipboard copying because selected rows may be on unloaded pages.
40
+ </p>
41
+ <DataTable
42
+ caption="Server deployments"
43
+ rows={rows.slice(0, 10)}
44
+ columns={columns}
45
+ paginationMode="server"
46
+ page={1}
47
+ pageSize={10}
48
+ rowCount={95}
49
+ defaultSelectedIds={[rows[1]!.id, rows[14]!.id]}
50
+ csvExport
51
+ onExport={async (next) => {
52
+ await new Promise<void>((resolve) => setTimeout(resolve, 500));
53
+ setRequest(next);
54
+ }}
55
+ labels={{ export: 'Request export' }}
56
+ />
57
+ <p role="status" className="text-sm text-muted-foreground">
58
+ {request ? `Requested ${request.scope}: ${request.columns.join(', ')}` : 'No export requested.'}
59
+ </p>
60
+ </section>
61
+ <section className="space-y-3" aria-label="Single row export">
62
+ <DataTable
63
+ caption="One deployment"
64
+ rows={rows.slice(0, 3)}
65
+ columns={columns}
66
+ selectionMode="single"
67
+ legend="Choose a deployment to export"
68
+ defaultSelectedId={rows[0]!.id}
69
+ csvExport={{ scopes: ['selected'] }}
70
+ />
71
+ </section>
72
+ </div>
73
+ );
74
+ }
@@ -0,0 +1,87 @@
1
+ import { Button, Checkbox, Input } from '@gntik-ai/ui';
2
+ import { useId, useState } from 'react';
3
+ import { useTableData, type TableDataParams, type TableDataResult } from '../../../hooks/useTableData';
4
+ import { ErrorPanel } from '../../../feedback/ErrorPanel/ErrorPanel';
5
+ import { LoadMoreFooter } from '../../LoadMoreFooter/LoadMoreFooter';
6
+ import { DataTable } from '../DataTable';
7
+
8
+ interface Item {
9
+ id: number;
10
+ name: string;
11
+ }
12
+ type Filters = { search: string };
13
+ const columns = [
14
+ { id: 'id', header: 'Id', accessor: (item: Item) => item.id, sortable: true },
15
+ { id: 'name', header: 'Name', accessor: (item: Item) => item.name, sortable: true },
16
+ ];
17
+ async function readCursor({
18
+ cursor,
19
+ pageSize,
20
+ filters,
21
+ sort,
22
+ signal,
23
+ }: TableDataParams<Filters>): Promise<TableDataResult<Item>> {
24
+ signal.throwIfAborted();
25
+ const items = Array.from({ length: 35 }, (_, index) => ({ id: index + 1, name: `Item ${index + 1}` })).filter(
26
+ (item) => item.name.toLowerCase().includes(filters?.search.toLowerCase() ?? ''),
27
+ );
28
+ if (sort?.direction === 'descending') items.reverse();
29
+ const start = Number(cursor ?? 0);
30
+ const end = start + pageSize;
31
+ return { rows: items.slice(start, end), nextCursor: end < items.length ? String(end) : null };
32
+ }
33
+
34
+ /** Cursor requests reuse the table query controls, with a separate load-more footer. */
35
+ export default function CursorLoadMoreExample({ getRows = readCursor }: { getRows?: typeof readCursor }) {
36
+ const searchId = useId();
37
+ const [search, setSearch] = useState('');
38
+ const [failNext, setFailNext] = useState(false);
39
+ const [enabled, setEnabled] = useState(true);
40
+ const [keepPreviousData, setKeepPreviousData] = useState(true);
41
+ const data = useTableData({
42
+ getRows: async (params) => {
43
+ if (failNext) {
44
+ setFailNext(false);
45
+ throw new Error('Request failed. Try again.');
46
+ }
47
+ return getRows(params);
48
+ },
49
+ filters: { search },
50
+ enabled,
51
+ keepPreviousData,
52
+ cacheTime: 30000,
53
+ revalidateInterval: 15000,
54
+ });
55
+ return (
56
+ <div className="space-y-3">
57
+ <label htmlFor={searchId} className="text-sm text-foreground">
58
+ Search items
59
+ </label>
60
+ <Input id={searchId} value={search} onValueChange={setSearch} />
61
+ <div className="flex flex-wrap items-center gap-3">
62
+ <Checkbox label="Enable requests" checked={enabled} onCheckedChange={setEnabled} />
63
+ <Checkbox label="Fail next request" checked={failNext} onCheckedChange={setFailNext} />
64
+ <Checkbox label="Keep previous rows" checked={keepPreviousData} onCheckedChange={setKeepPreviousData} />
65
+ <Button variant="soft" onClick={data.refetch} disabled={!enabled}>
66
+ Refetch
67
+ </Button>
68
+ <Button variant="soft" onClick={data.invalidate} disabled={!enabled}>
69
+ Invalidate cache
70
+ </Button>
71
+ </div>
72
+ <DataTable {...data.tableProps} columns={columns} caption="Cursor items" selectionMode="none" paginated={false} />
73
+ {data.error != null && !data.hasMore && (
74
+ <ErrorPanel
75
+ title={data.loadMoreProps.error}
76
+ code={null}
77
+ requestId=""
78
+ details=""
79
+ secondaryAction={null}
80
+ onRetry={data.loadMoreProps.onRetry}
81
+ retrying={data.isFetching}
82
+ />
83
+ )}
84
+ <LoadMoreFooter {...data.loadMoreProps} error={data.hasMore ? data.loadMoreProps.error : ''} />
85
+ </div>
86
+ );
87
+ }
@@ -0,0 +1,46 @@
1
+ import { useState } from 'react';
2
+ import { DataTable } from '../DataTable';
3
+
4
+ const rows = Array.from({ length: 60 }, (_, i) => ({ id: String(i + 1), name: `Item ${i + 1}` }));
5
+ const columns = [{ id: 'name', header: 'Name', accessor: (row: (typeof rows)[number]) => row.name }];
6
+
7
+ /** Include the current choice in the legend because its checked radio may be on another page. */
8
+ export default function PaginatedSingleSelectionExample() {
9
+ const [selectedId, setSelectedId] = useState('42');
10
+ const [page, setPage] = useState(1);
11
+ const [pageSize, setPageSize] = useState(20);
12
+ return (
13
+ <div className="space-y-4">
14
+ <DataTable
15
+ caption="Client items"
16
+ rows={rows}
17
+ columns={columns}
18
+ selectionMode="single"
19
+ paginated
20
+ defaultPageSize={20}
21
+ defaultSelectedId="42"
22
+ legend="Client items; initial choice Item 42"
23
+ showColumnMenu={false}
24
+ showDensityToggle={false}
25
+ />
26
+ <DataTable
27
+ caption="Server items"
28
+ rows={rows.slice((page - 1) * pageSize, page * pageSize)}
29
+ columns={columns}
30
+ selectionMode="single"
31
+ paginationMode="server"
32
+ page={page}
33
+ pageSize={pageSize}
34
+ rowCount={rows.length}
35
+ onPageChange={setPage}
36
+ onPageSizeChange={setPageSize}
37
+ pageSizeOptions={[10, 20, 50]}
38
+ selectedId={selectedId}
39
+ onSelectedIdChange={setSelectedId}
40
+ legend={`Server items; current choice Item ${selectedId}`}
41
+ showColumnMenu={false}
42
+ showDensityToggle={false}
43
+ />
44
+ </div>
45
+ );
46
+ }