@gntik-ai/blocks 0.11.0 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (182) hide show
  1. package/dist/index.d.ts +1501 -1232
  2. package/dist/index.js +1884 -836
  3. package/dist/index.js.map +1 -1
  4. package/package.json +6 -6
  5. package/src/ai/PromptEditor/PromptEditor.tsx +2 -2
  6. package/src/ai/PromptEditor/examples/controlled-variables.tsx +1 -1
  7. package/src/ai/TraceWaterfall/TraceWaterfall.tsx +2 -2
  8. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.test.tsx +6 -0
  9. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.tsx +4 -1
  10. package/src/auth/ForgotPasswordForm/block.meta.ts +1 -1
  11. package/src/auth/ForgotPasswordForm/examples/LargeFields.tsx +6 -0
  12. package/src/auth/MfaChallenge/MfaChallenge.test.tsx +9 -0
  13. package/src/auth/MfaChallenge/MfaChallenge.tsx +5 -2
  14. package/src/auth/MfaChallenge/block.meta.ts +1 -1
  15. package/src/auth/MfaChallenge/examples/LargeFields.tsx +6 -0
  16. package/src/auth/ResetPasswordForm/ResetPasswordForm.test.tsx +7 -0
  17. package/src/auth/ResetPasswordForm/ResetPasswordForm.tsx +5 -3
  18. package/src/auth/ResetPasswordForm/block.meta.ts +1 -1
  19. package/src/auth/ResetPasswordForm/examples/LargeFields.tsx +6 -0
  20. package/src/auth/SignInForm/SignInForm.test.tsx +7 -0
  21. package/src/auth/SignInForm/SignInForm.tsx +5 -1
  22. package/src/auth/SignInForm/block.meta.ts +1 -1
  23. package/src/auth/SignInForm/examples/LargeFields.tsx +6 -0
  24. package/src/auth/SignUpForm/SignUpForm.test.tsx +22 -0
  25. package/src/auth/SignUpForm/SignUpForm.tsx +7 -1
  26. package/src/auth/SignUpForm/block.meta.ts +1 -1
  27. package/src/auth/SignUpForm/examples/LargeFields.tsx +6 -0
  28. package/src/auth/__snapshots__/field-size.test.tsx.snap +11 -0
  29. package/src/auth/field-size.test.tsx +21 -0
  30. package/src/auth/large-examples.test.tsx +30 -0
  31. package/src/auth/shared.tsx +7 -2
  32. package/src/billing/PaymentMethodCard/PaymentMethodCard.tsx +1 -1
  33. package/src/billing/PlanCard/PlanCard.baseline.test.tsx +3 -2
  34. package/src/billing/PlanCard/__snapshots__/PlanCard.baseline.test.tsx.snap +2 -2
  35. package/src/billing/PlanDefinitionCard/examples/Compact.tsx +1 -4
  36. package/src/billing/PlanDefinitionCard/examples/Full.tsx +1 -4
  37. package/src/builders/CodePanel/CodePanel.tsx +2 -2
  38. package/src/builders/FlowBuilder/FlowBuilder.tsx +4 -19
  39. package/src/builders/FlowBuilder/parts.tsx +4 -4
  40. package/src/builders/LogViewer/LogViewer.follow.test.tsx +29 -0
  41. package/src/builders/LogViewer/LogViewer.test.tsx +24 -0
  42. package/src/builders/LogViewer/LogViewer.tsx +67 -20
  43. package/src/builders/LogViewer/block.meta.ts +2 -1
  44. package/src/builders/LogViewer/examples/Spanish.tsx +2 -1
  45. package/src/data-display/ActivityFeed/ActivityFeed.tsx +1 -1
  46. package/src/data-display/ChartCard/ChartCard.tsx +2 -2
  47. package/src/data-display/ChartCard/examples/ContainerPanel.tsx +16 -0
  48. package/src/data-display/CommentThread/CommentThread.test.tsx +70 -1
  49. package/src/data-display/CommentThread/CommentThread.tsx +22 -6
  50. package/src/data-display/CommentThread/block.meta.ts +1 -1
  51. package/src/data-display/CommentThread/examples/RenderedBody.tsx +20 -0
  52. package/src/data-display/DescriptionListCard/DescriptionListCard.test.tsx +24 -1
  53. package/src/data-display/DescriptionListCard/DescriptionListCard.tsx +14 -20
  54. package/src/data-display/DescriptionListCard/block.meta.ts +2 -1
  55. package/src/data-display/DescriptionListCard/examples/Spanish.tsx +2 -1
  56. package/src/data-display/KpiRow/KpiRow.doc.ts +14 -0
  57. package/src/data-display/KpiRow/KpiRow.test.tsx +11 -0
  58. package/src/data-display/KpiRow/KpiRow.tsx +72 -55
  59. package/src/data-display/KpiRow/examples/ContainerPanel.tsx +47 -0
  60. package/src/data-display/ResourceCardGrid/ResourceCardGrid.doc.ts +19 -0
  61. package/src/data-display/ResourceCardGrid/ResourceCardGrid.test.tsx +13 -0
  62. package/src/data-display/ResourceCardGrid/ResourceCardGrid.tsx +49 -40
  63. package/src/data-display/ResourceCardGrid/examples/ContainerPanel.tsx +18 -0
  64. package/src/data-display/StatusTimeline/StatusTimeline.tsx +1 -1
  65. package/src/feedback/EmptyStates/EmptyStates.test.tsx +42 -0
  66. package/src/feedback/EmptyStates/EmptyStates.tsx +5 -3
  67. package/src/feedback/EmptyStates/block.meta.ts +1 -1
  68. package/src/feedback/EmptyStates/examples/HiddenAction.tsx +13 -0
  69. package/src/feedback/ErrorPanel/ErrorPanel.tsx +13 -15
  70. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.lifecycle.test.tsx +123 -0
  71. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.tsx +128 -139
  72. package/src/forms/CreateApiKeyDialog/block.meta.ts +12 -1
  73. package/src/forms/FileUploadPanel/FileUploadPanel.controlled.test.tsx +482 -0
  74. package/src/forms/FileUploadPanel/FileUploadPanel.drag.test.tsx +60 -0
  75. package/src/forms/FileUploadPanel/FileUploadPanel.lifecycle.test.tsx +165 -0
  76. package/src/forms/FileUploadPanel/FileUploadPanel.tsx +267 -69
  77. package/src/forms/FileUploadPanel/block.meta.ts +5 -1
  78. package/src/forms/FileUploadPanel/examples/AutoCancel.tsx +38 -0
  79. package/src/forms/FileUploadPanel/examples/Labels.tsx +1 -1
  80. package/src/forms/FileUploadPanel/examples/ManualForm.tsx +36 -0
  81. package/src/forms/FileUploadPanel/fixtures.ts +31 -16
  82. package/src/forms/FileUploadPanel/simulate-upload.test.ts +24 -0
  83. package/src/forms/FormSection/FormSection.test.tsx +11 -0
  84. package/src/forms/FormSection/FormSection.tsx +20 -22
  85. package/src/forms/FormSection/block.meta.ts +1 -1
  86. package/src/forms/FormSection/examples/ContainerPanel.tsx +16 -0
  87. package/src/forms/InviteMembersDialog/InviteMembersDialog.lifecycle.test.tsx +80 -0
  88. package/src/forms/InviteMembersDialog/InviteMembersDialog.tsx +90 -109
  89. package/src/forms/InviteMembersDialog/block.meta.ts +1 -1
  90. package/src/forms/ValidationSummary/ValidationSummary.tsx +1 -4
  91. package/src/hooks/index.ts +2 -0
  92. package/src/hooks/useTableData.integration.test.tsx +89 -0
  93. package/src/hooks/useTableData.test.tsx +613 -0
  94. package/src/hooks/useTableData.ts +377 -0
  95. package/src/index.ts +1 -0
  96. package/src/marketing/ComparisonTable/ComparisonTable.tsx +2 -2
  97. package/src/marketing/FeatureGrid/FeatureGrid.tsx +1 -1
  98. package/src/marketing/LogoCloud/LogoCloud.doc.ts +13 -0
  99. package/src/marketing/LogoCloud/LogoCloud.test.tsx +155 -0
  100. package/src/marketing/LogoCloud/LogoCloud.tsx +89 -0
  101. package/src/marketing/LogoCloud/block.meta.ts +10 -0
  102. package/src/marketing/LogoCloud/examples/CaptionStart.tsx +6 -0
  103. package/src/marketing/LogoCloud/examples/Custom.tsx +25 -0
  104. package/src/marketing/LogoCloud/examples/Empty.tsx +6 -0
  105. package/src/marketing/LogoCloud/examples/Grid.tsx +13 -0
  106. package/src/marketing/LogoCloud/examples/Row.tsx +6 -0
  107. package/src/marketing/LogoCloud/examples/UnderHero.tsx +13 -0
  108. package/src/marketing/LogoCloud/fixtures.ts +23 -0
  109. package/src/marketing/PricingTable/PricingTable.tsx +1 -1
  110. package/src/marketing/SiteFooter/SiteFooter.doc.ts +18 -0
  111. package/src/marketing/SiteFooter/SiteFooter.test.tsx +236 -0
  112. package/src/marketing/SiteFooter/SiteFooter.tsx +160 -0
  113. package/src/marketing/SiteFooter/block.meta.ts +10 -0
  114. package/src/marketing/SiteFooter/examples/Centered.tsx +15 -0
  115. package/src/marketing/SiteFooter/examples/Columns.tsx +15 -0
  116. package/src/marketing/SiteFooter/examples/Custom.tsx +35 -0
  117. package/src/marketing/SiteFooter/examples/Empty.tsx +6 -0
  118. package/src/marketing/SiteFooter/examples/Simple.tsx +14 -0
  119. package/src/marketing/SiteFooter/fixtures.ts +36 -0
  120. package/src/marketing/index.ts +6 -0
  121. package/src/page-chrome/PageHeader/EditableTitle.test.tsx +26 -0
  122. package/src/page-chrome/PageHeader/PageHeader.tsx +4 -4
  123. package/src/page-chrome/PageHeader/block.meta.ts +1 -1
  124. package/src/page-chrome/PageHeader/examples/ContainerPanel.tsx +16 -0
  125. package/src/page-chrome/PageHeader/examples/EditableTitle.tsx +23 -0
  126. package/src/page-chrome/StickyActionBar/StickyActionBar.tsx +1 -1
  127. package/src/scheduling/AgendaList/AgendaList.tsx +39 -15
  128. package/src/scheduling/AgendaList/AgendaListZone.test.tsx +38 -0
  129. package/src/scheduling/AgendaList/block.meta.ts +1 -1
  130. package/src/scheduling/AgendaList/examples/TimeZone.tsx +28 -0
  131. package/src/scheduling/MonthCalendar/MonthCalendar.tsx +51 -40
  132. package/src/scheduling/MonthCalendar/MonthCalendarZone.test.tsx +44 -0
  133. package/src/scheduling/MonthCalendar/block.meta.ts +1 -1
  134. package/src/scheduling/MonthCalendar/examples/TimeZone.tsx +28 -0
  135. package/src/scheduling/WeekCalendar/WeekCalendar.tsx +37 -28
  136. package/src/scheduling/WeekCalendar/WeekCalendarZone.test.tsx +41 -0
  137. package/src/scheduling/WeekCalendar/block.meta.ts +1 -1
  138. package/src/scheduling/WeekCalendar/examples/TimeZone.tsx +28 -0
  139. package/src/scheduling/shared/CalendarHeader.tsx +26 -1
  140. package/src/scheduling/shared/dates.ts +102 -58
  141. package/src/scheduling/shared/events.ts +2 -2
  142. package/src/shell/AppSidebar/AppSidebar.context.test.tsx +175 -0
  143. package/src/shell/AppSidebar/AppSidebar.doc.ts +29 -0
  144. package/src/shell/AppSidebar/AppSidebar.tsx +97 -25
  145. package/src/shell/AppSidebar/block.meta.ts +1 -1
  146. package/src/shell/GlobalSearch/GlobalSearch.test.tsx +1 -0
  147. package/src/shell/GlobalSearch/GlobalSearch.tsx +1 -1
  148. package/src/tables/DataTable/DataTable.cursor-example.test.tsx +67 -0
  149. package/src/tables/DataTable/DataTable.export.test.tsx +511 -0
  150. package/src/tables/DataTable/DataTable.inline-edit-focus.test.tsx +32 -0
  151. package/src/tables/DataTable/DataTable.layout.test.tsx +6 -5
  152. package/src/tables/DataTable/DataTable.link-actions.test.tsx +18 -0
  153. package/src/tables/DataTable/DataTable.server-pagination.test.tsx +328 -14
  154. package/src/tables/DataTable/DataTable.test.tsx +85 -1
  155. package/src/tables/DataTable/DataTable.tsx +108 -14
  156. package/src/tables/DataTable/block.meta.ts +11 -1
  157. package/src/tables/DataTable/column-sizing.ts +2 -2
  158. package/src/tables/DataTable/data-table-props.ts +29 -1
  159. package/src/tables/DataTable/data-table-row.tsx +2 -2
  160. package/src/tables/DataTable/data-table-utils.ts +4 -0
  161. package/src/tables/DataTable/editable-cell.tsx +20 -79
  162. package/src/tables/DataTable/examples/csv-export.tsx +74 -0
  163. package/src/tables/DataTable/examples/cursor-load-more.tsx +87 -0
  164. package/src/tables/DataTable/examples/server-pagination.tsx +47 -40
  165. package/src/tables/DataTable/export-menu.tsx +58 -0
  166. package/src/tables/DataTable/header-cell.tsx +1 -1
  167. package/src/tables/DataTable/labels.ts +7 -0
  168. package/src/tables/DataTable/resize-handle.tsx +2 -2
  169. package/src/tables/DataTable/use-table-export.ts +117 -0
  170. package/src/tables/FilterBar/FilterBar.test.tsx +12 -0
  171. package/src/tables/FilterBar/FilterBar.tsx +5 -7
  172. package/src/team/ProfileHeader/ProfileHeader.picker.test.tsx +34 -0
  173. package/src/team/ProfileHeader/ProfileHeader.test.tsx +2 -2
  174. package/src/team/ProfileHeader/ProfileHeader.tsx +17 -24
  175. package/src/team/ProfileHeader/block.meta.ts +1 -1
  176. package/src/test/OptInDefaults.test.tsx +10 -1
  177. package/src/test/clipboard-fallback.test.tsx +49 -0
  178. package/src/test/copy-examples.test.tsx +29 -0
  179. package/src/test/copy-feedback.test.tsx +166 -0
  180. package/src/test/fixtures/opt-in-defaults.json +5 -5
  181. package/src/test/without-forced-colors.test.ts +44 -0
  182. package/src/test/without-forced-colors.ts +14 -0
@@ -0,0 +1,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
+ }
@@ -1,7 +1,9 @@
1
1
  import { Button, Checkbox } from '@gntik-ai/ui';
2
- import { useEffect, useState } from 'react';
3
- import { DataTable } from '../DataTable';
4
- import type { DataTableSelectionModel } from '../data-table-utils';
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';
5
7
 
6
8
  interface Item {
7
9
  id: number;
@@ -13,48 +15,49 @@ interface Envelope {
13
15
  total: number;
14
16
  page: number;
15
17
  pageSize: number;
18
+ sort: SortState | null;
16
19
  }
17
20
  const columns = [
18
- { id: 'id', header: 'Id', accessor: (row: Item) => row.id },
19
- { 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 },
20
23
  ];
21
24
 
22
25
  // Demo endpoint adapter. Replace with the consumer's API returning this envelope.
23
- function readPage(page: number, pageSize: number): Envelope {
26
+ function readPage({ page, pageSize, sort }: Pick<DataTableQuery, 'page' | 'pageSize' | 'sort'>): Envelope {
24
27
  const total = 95;
25
28
  const from = (page - 1) * pageSize;
26
- return {
27
- items: Array.from({ length: Math.max(0, Math.min(pageSize, total - from)) }, (_, i) => ({
28
- id: from + i + 1,
29
- locked: (from + i + 1) % 10 === 4,
30
- name: `Item ${from + i + 1}`,
31
- })),
32
- total,
33
- page,
34
- pageSize,
35
- };
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 };
36
42
  }
37
- async function requestPage(page: number, pageSize: number): Promise<Envelope> {
38
- return readPage(page, pageSize);
43
+ async function requestPage(query: DataTableQuery & { signal: AbortSignal }): Promise<Envelope> {
44
+ return readPage(query);
39
45
  }
40
46
 
41
- /** Known-total, 1-based pages. The consumer owns requests and keeps the old envelope until they resolve. */
42
- export default function ServerPaginationExample() {
47
+ /** Known-total pages with aborts, per-instance caching, retained rows and retryable errors. */
48
+ export default function ServerPaginationExample({ request = requestPage }: { request?: typeof requestPage }) {
43
49
  const [selection, setSelection] = useState<DataTableSelectionModel>({ type: 'include', ids: [] });
44
50
  const [preserveSelection, setPreserveSelection] = useState(true);
45
51
  const [hideSelectAll, setHideSelectAll] = useState(false);
46
52
  const [review, setReview] = useState('');
47
- const [envelope, setEnvelope] = useState(() => readPage(2, 20));
48
- const [request, setRequest] = useState({ page: 2, pageSize: 20 });
49
- useEffect(() => {
50
- let active = true;
51
- void requestPage(request.page, request.pageSize).then((next) => {
52
- if (active) setEnvelope(next);
53
- });
54
- return () => {
55
- active = false;
56
- };
57
- }, [request]);
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
+ });
58
61
 
59
62
  return (
60
63
  <div className="space-y-3">
@@ -89,17 +92,21 @@ export default function ServerPaginationExample() {
89
92
  </Button>
90
93
  )}
91
94
  columns={columns}
92
- rows={envelope.items}
93
- paginationMode="server"
94
- rowCount={envelope.total}
95
- page={envelope.page}
96
- pageSize={envelope.pageSize}
95
+ {...data.tableProps}
97
96
  pageSizeOptions={[10, 20, 50]}
98
- onPageChange={(page) => setRequest((previous) => ({ ...previous, page }))}
99
- // The footer can also call onPageChange to keep the first row visible (20 to 50 at page 2 requests page 1).
100
- // Functional updates batch both callbacks into one request with the new size and page.
101
- onPageSizeChange={(pageSize) => setRequest((previous) => ({ ...previous, pageSize }))}
102
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
+ )}
103
110
  <p role="status" className="text-sm text-muted-foreground">
104
111
  {review}
105
112
  </p>
@@ -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,6 +2,13 @@ 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. */
@@ -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,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();
@@ -1,6 +1,6 @@
1
- import { Avatar, Badge, Button, IconButton, cn } from '@gntik-ai/ui';
1
+ import { Avatar, Badge, Button, IconButton, FileTrigger, cn } from '@gntik-ai/ui';
2
2
  import { Camera, Pencil } from '@gntik-ai/icons';
3
- import { useRef, useState, type ReactNode } from 'react';
3
+ import { useState, type ReactNode } from 'react';
4
4
  import { profile as defaultProfile, type Profile } from './fixtures';
5
5
 
6
6
  export type { Profile, ProfileMetaItem } from './fixtures';
@@ -26,7 +26,6 @@ export function ProfileHeader({
26
26
  headingLevel: Heading = 'h1',
27
27
  className,
28
28
  }: ProfileHeaderProps) {
29
- const fileRef = useRef<HTMLInputElement | null>(null);
30
29
  const [preview, setPreview] = useState<string | null>(null);
31
30
 
32
31
  const pick = (file: File) => {
@@ -45,27 +44,21 @@ export function ProfileHeader({
45
44
  <div className="relative w-fit shrink-0">
46
45
  <Avatar size="xl" name={profile.name} src={preview ?? profile.avatarUrl} />
47
46
  {onAvatarChange && (
48
- <>
49
- <IconButton
50
- icon={Camera}
51
- label="Change avatar"
52
- size="sm"
53
- variant="secondary"
54
- className="absolute -end-1 -bottom-1 rounded-full"
55
- onClick={() => fileRef.current?.click()}
56
- />
57
- <input
58
- ref={fileRef}
59
- type="file"
60
- accept="image/*"
61
- hidden
62
- onChange={(e) => {
63
- const file = e.target.files?.[0];
64
- if (file) pick(file);
65
- e.target.value = '';
66
- }}
67
- />
68
- </>
47
+ <FileTrigger
48
+ accept="image/*"
49
+ onSelect={(files) => {
50
+ if (files[0]) pick(files[0]);
51
+ }}
52
+ render={
53
+ <IconButton
54
+ icon={Camera}
55
+ label="Change avatar"
56
+ size="sm"
57
+ variant="secondary"
58
+ className="absolute -end-1 -bottom-1 rounded-full"
59
+ />
60
+ }
61
+ />
69
62
  )}
70
63
  </div>
71
64
  <div className="min-w-0 flex-1">
@@ -6,5 +6,5 @@ export const meta: BlockMeta = {
6
6
  status: 'stable',
7
7
  description:
8
8
  'Profile header with a large avatar and change action, name, role badge, headline, meta row and edit button.',
9
- uses: ['Avatar', 'Badge', 'IconButton', 'Button'],
9
+ uses: ['Avatar', 'Badge', 'IconButton', 'Button', 'FileTrigger'],
10
10
  };
@@ -4,6 +4,7 @@ import { renderToStaticMarkup } from 'react-dom/server';
4
4
  import { DescriptionListCard } from '../data-display/DescriptionListCard/DescriptionListCard';
5
5
  import { NoAccessEmpty } from '../feedback/EmptyStates/EmptyStates';
6
6
  import { PageHeader } from '../page-chrome/PageHeader/PageHeader';
7
+ import { withoutForcedColors } from './without-forced-colors';
7
8
 
8
9
  // Static rendering keeps React's generated IDs deterministic without masking any HTML differences.
9
10
  // Captured before source edits at 6ec08de25c3311386f7ee97fc11605f2a7c307fe; never update from changed source.
@@ -23,5 +24,13 @@ it.each(cases)('preserves the pinned %s innerHTML', (name, component) => {
23
24
  };
24
25
  const container = document.createElement('div');
25
26
  container.innerHTML = renderToStaticMarkup(component);
26
- expect(container.innerHTML).toBe(baseline.html[name]);
27
+ // Keep the captured fixture immutable. This change deliberately replaces only the header's
28
+ // viewport classes with its own container; all other default markup must still match.
29
+ const expected = name.startsWith('page-header')
30
+ ? baseline.html[name]
31
+ ?.replace('<header class="min-w-0">', '<header class="@container w-full min-w-0">')
32
+ .replace('hidden shrink-0 items-center gap-2.5 sm:flex', 'hidden shrink-0 items-center gap-2.5 @xl:flex')
33
+ .replace('flex shrink-0 items-center gap-2 sm:hidden', 'flex shrink-0 items-center gap-2 @xl:hidden')
34
+ : baseline.html[name];
35
+ expect(withoutForcedColors(container).innerHTML).toBe(expected);
27
36
  });