@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
@@ -26,14 +26,20 @@ export interface ResourceCardGridProps {
26
26
  onAction?: (action: ResourceAction, item: ResourceCard) => void;
27
27
  /** Replaces the default menu entirely. Return an empty array to hide the menu. */
28
28
  getActions?: (item: ResourceCard) => Array<MoreMenuAction | 'separator'>;
29
- /** Columns at the widest breakpoint. */
29
+ /** Maximum columns, chosen from this block's container width. */
30
30
  columns?: 2 | 3 | 4;
31
31
  /** Heading level of each card's name, to fit the page outline (default h3). */
32
32
  titleAs?: 'h2' | 'h3' | 'h4';
33
33
  className?: string;
34
+ /** Styles the container wrapper, including placement in a parent grid. */
35
+ containerClassName?: string;
34
36
  }
35
37
 
36
- const COLS = { 2: 'lg:grid-cols-2', 3: 'lg:grid-cols-3', 4: 'lg:grid-cols-3 xl:grid-cols-4' } as const;
38
+ const COLS = {
39
+ 2: '@xl:grid-cols-2',
40
+ 3: '@xl:grid-cols-2 @4xl:grid-cols-3',
41
+ 4: '@xl:grid-cols-2 @3xl:grid-cols-3 @4xl:grid-cols-4',
42
+ } as const;
37
43
 
38
44
  /** Responsive grid of resource cards: icon or avatar, name, status, meta figures and a row-actions MoreMenu. */
39
45
  export function ResourceCardGrid({
@@ -44,6 +50,7 @@ export function ResourceCardGrid({
44
50
  columns = 3,
45
51
  titleAs: TitleTag = 'h3',
46
52
  className,
53
+ containerClassName,
47
54
  }: ResourceCardGridProps) {
48
55
  const defaults = (item: ResourceCard): Array<MoreMenuAction | 'separator'> => [
49
56
  { label: 'Open', icon: ExternalLink, onSelect: () => onAction?.('open', item) },
@@ -53,46 +60,48 @@ export function ResourceCardGrid({
53
60
  { label: 'Delete', icon: Trash2, destructive: true, onSelect: () => onAction?.('delete', item) },
54
61
  ];
55
62
  return (
56
- <ul aria-label={label} className={cn('grid grid-cols-1 gap-4 sm:grid-cols-2', COLS[columns], className)}>
57
- {items.map((item) => {
58
- const actions = getActions ? getActions(item) : defaults(item);
59
- const IconCmp = item.icon;
60
- return (
61
- <li key={item.id} className="flex min-w-0 flex-col rounded-xl border border-border bg-card p-5 shadow-sm">
62
- <div className="flex items-start justify-between gap-3">
63
- {item.avatar ? (
64
- <Avatar name={item.avatar.name} src={item.avatar.src} size="md" shape="rounded" />
65
- ) : (
66
- <span className="inline-flex size-10 shrink-0 items-center justify-center rounded-lg bg-secondary text-muted-foreground">
67
- {IconCmp && <IconCmp size={20} aria-hidden />}
68
- </span>
69
- )}
70
- <div className="flex items-center gap-2">
71
- {item.status && <StatusTag status={item.status} />}
72
- {actions.length > 0 && (
73
- <MoreMenu items={actions} label={`Actions for ${item.name}`} variant="ghost" size="sm" />
63
+ <div className={cn('@container w-full min-w-0', containerClassName)}>
64
+ <ul aria-label={label} className={cn('grid grid-cols-1 gap-4', COLS[columns], className)}>
65
+ {items.map((item) => {
66
+ const actions = getActions ? getActions(item) : defaults(item);
67
+ const IconCmp = item.icon;
68
+ return (
69
+ <li key={item.id} className="flex min-w-0 flex-col rounded-xl border border-border bg-card p-5 shadow-sm">
70
+ <div className="flex items-start justify-between gap-3">
71
+ {item.avatar ? (
72
+ <Avatar name={item.avatar.name} src={item.avatar.src} size="md" shape="rounded" />
73
+ ) : (
74
+ <span className="inline-flex size-10 shrink-0 items-center justify-center rounded-lg bg-secondary text-muted-foreground">
75
+ {IconCmp && <IconCmp size={20} aria-hidden />}
76
+ </span>
77
+ )}
78
+ <div className="flex items-center gap-2">
79
+ {item.status && <StatusTag status={item.status} />}
80
+ {actions.length > 0 && (
81
+ <MoreMenu items={actions} label={`Actions for ${item.name}`} variant="ghost" size="sm" />
82
+ )}
83
+ </div>
84
+ </div>
85
+ <div className="mt-4 min-w-0">
86
+ <TitleTag className="truncate text-[14px] font-semibold text-foreground">{item.name}</TitleTag>
87
+ {item.description && (
88
+ <p className="mt-0.5 truncate text-[12.5px] text-muted-foreground">{item.description}</p>
74
89
  )}
75
90
  </div>
76
- </div>
77
- <div className="mt-4 min-w-0">
78
- <TitleTag className="truncate text-[14px] font-semibold text-foreground">{item.name}</TitleTag>
79
- {item.description && (
80
- <p className="mt-0.5 truncate text-[12.5px] text-muted-foreground">{item.description}</p>
91
+ {item.meta && item.meta.length > 0 && (
92
+ <dl className="mt-4 grid grid-cols-2 gap-3 border-t border-border pt-4">
93
+ {item.meta.map((m) => (
94
+ <div key={m.label} className="flex min-w-0 flex-col-reverse">
95
+ <dt className="truncate text-[11px] text-muted-foreground">{m.label}</dt>
96
+ <dd className="truncate font-mono text-[14px] text-foreground tabular-nums">{m.value}</dd>
97
+ </div>
98
+ ))}
99
+ </dl>
81
100
  )}
82
- </div>
83
- {item.meta && item.meta.length > 0 && (
84
- <dl className="mt-4 grid grid-cols-2 gap-3 border-t border-border pt-4">
85
- {item.meta.map((m) => (
86
- <div key={m.label} className="flex min-w-0 flex-col-reverse">
87
- <dt className="truncate text-[11px] text-muted-foreground">{m.label}</dt>
88
- <dd className="truncate font-mono text-[14px] text-foreground tabular-nums">{m.value}</dd>
89
- </div>
90
- ))}
91
- </dl>
92
- )}
93
- </li>
94
- );
95
- })}
96
- </ul>
101
+ </li>
102
+ );
103
+ })}
104
+ </ul>
105
+ </div>
97
106
  );
98
107
  }
@@ -0,0 +1,18 @@
1
+ import { InspectorLayout } from '@gntik-ai/ui';
2
+ import { ResourceCardGrid } from '../ResourceCardGrid';
3
+
4
+ export default function ContainerPanel() {
5
+ return (
6
+ <div data-container-example className="h-[640px] overflow-hidden rounded-lg border border-border">
7
+ <InspectorLayout panelTitle="Properties" dockedQuery="(min-width: 0px)" panel={<ResourceCardGrid />}>
8
+ <div className="grid gap-6 overflow-auto p-4">
9
+ {([3, 2, 4] as const).map((columns) => (
10
+ <div key={columns} data-container-slot={String(columns)} className="flex min-w-0">
11
+ <ResourceCardGrid columns={columns} className="gap-6" containerClassName="col-span-2" />
12
+ </div>
13
+ ))}
14
+ </div>
15
+ </InspectorLayout>
16
+ </div>
17
+ );
18
+ }
@@ -69,7 +69,7 @@ export function StatusTimeline({
69
69
  return (
70
70
  <li key={event.id} className="relative flex gap-3 pb-6 last:pb-0">
71
71
  {!last && <span aria-hidden className="absolute top-5 bottom-0 start-[9px] w-px bg-border" />}
72
- <span className="relative z-10 mt-1 flex size-5 shrink-0 items-center justify-center rounded-full bg-card">
72
+ <span className="relative z-raised mt-1 flex size-5 shrink-0 items-center justify-center rounded-full bg-card">
73
73
  <StatusDot tone={event.tone} pulse={event.live} size="lg" />
74
74
  </span>
75
75
  <div className="min-w-0 flex-1">
@@ -4,6 +4,48 @@ import { expectNoAxeViolations } from '../../test/a11y';
4
4
  import { FirstRunEmpty, NoAccessEmpty, NoResultsEmpty, NotFoundEmpty } from './EmptyStates';
5
5
 
6
6
  describe('EmptyStates', () => {
7
+ it.each([undefined, { action: 'Create project' }])(
8
+ 'allows an accessible action-free first-run state with labels=%j',
9
+ async (labels) => {
10
+ const { container } = render(
11
+ <FirstRunEmpty
12
+ title="No projects yet"
13
+ actionLabel={null}
14
+ labels={labels}
15
+ secondary={null}
16
+ steps={[]}
17
+ onAction={vi.fn()}
18
+ />,
19
+ );
20
+ expect(screen.getByRole('heading', { name: 'No projects yet' })).toBeVisible();
21
+ expect(screen.queryByRole('button')).toBeNull();
22
+ expect(screen.queryByRole('link')).toBeNull();
23
+ expect(screen.queryByRole('list')).toBeNull();
24
+ await expectNoAxeViolations(container);
25
+ },
26
+ );
27
+
28
+ it('hides an empty first-run action while retaining the default guide and checklist', () => {
29
+ render(<FirstRunEmpty actionLabel="" />);
30
+ expect(screen.queryByRole('button')).toBeNull();
31
+ expect(screen.getByRole('link', { name: 'Read the guide' })).toBeVisible();
32
+ expect(screen.getByRole('list')).toBeVisible();
33
+ });
34
+
35
+ it('hides the first-run action when its label override is empty', () => {
36
+ render(<FirstRunEmpty labels={{ action: '' }} />);
37
+ expect(screen.queryByRole('button')).toBeNull();
38
+ expect(screen.getByRole('link', { name: 'Read the guide' })).toBeVisible();
39
+ expect(screen.getByRole('list')).toBeVisible();
40
+ });
41
+
42
+ it('calls the first-run action once with an explicit label', async () => {
43
+ const onAction = vi.fn();
44
+ render(<FirstRunEmpty actionLabel="Create" onAction={onAction} />);
45
+ await userEvent.setup().click(screen.getByRole('button', { name: 'Create' }));
46
+ expect(onAction).toHaveBeenCalledTimes(1);
47
+ });
48
+
7
49
  it('renders not found copy without actions or live regions, and accepts an action', async () => {
8
50
  const { container, rerender } = render(<NotFoundEmpty title="Resource missing" description="It was deleted." />);
9
51
  expect(screen.getByRole('heading', { name: 'Resource missing' })).toBeVisible();
@@ -55,7 +55,8 @@ export interface FirstRunEmptyProps extends SharedEmptyProps {
55
55
  icon?: LucideIcon;
56
56
  title?: ReactNode;
57
57
  description?: ReactNode;
58
- actionLabel?: string;
58
+ /** Omit to use labels.action or the localized default. `null` or "" hides the action; onAction is ignored. */
59
+ actionLabel?: string | null;
59
60
  onAction?: () => void;
60
61
  /** Secondary link (docs, guide). `null` hides it. */
61
62
  secondary?: { label: string; href: string } | null;
@@ -81,7 +82,8 @@ export function FirstRunEmpty({
81
82
  const title = titleProp === undefined ? (labels?.title ?? t('emptyState.firstRun.title')) : titleProp;
82
83
  const description =
83
84
  descriptionProp === undefined ? (labels?.description ?? t('emptyState.firstRun.description')) : descriptionProp;
84
- const actionLabel = actionLabelProp ?? labels?.action ?? t('emptyState.firstRun.action');
85
+ const actionLabel =
86
+ actionLabelProp === undefined ? (labels?.action ?? t('emptyState.firstRun.action')) : actionLabelProp;
85
87
  const secondary =
86
88
  secondaryProp === undefined
87
89
  ? { label: labels?.guide ?? t('emptyState.firstRun.guide'), href: '#guide' }
@@ -94,7 +96,7 @@ export function FirstRunEmpty({
94
96
  description={description}
95
97
  bordered={bordered}
96
98
  className={cn('mx-auto', className)}
97
- primaryAction={<Button onClick={onAction}>{actionLabel}</Button>}
99
+ primaryAction={actionLabel ? <Button onClick={onAction}>{actionLabel}</Button> : undefined}
98
100
  secondaryAction={
99
101
  secondary ? (
100
102
  <Link
@@ -5,7 +5,7 @@ export const meta: BlockMeta = {
5
5
  family: 'feedback',
6
6
  status: 'beta',
7
7
  description:
8
- 'Four canonical empty states: first run (with checklist), no results (clear filters/search), no access (request access) and not found (optional action). FirstRunEmpty, NoResultsEmpty and NoAccessEmpty accept labels?: Partial<FirstRunEmptyLabels>, Partial<NoResultsEmptyLabels> and Partial<NoAccessEmptyLabels> respectively. Each type has its own keys below; explicit title, description, actionLabel and secondary props win. Defaults follow I18nProvider (en/es). NoResultsEmpty keeps the query in a mono span unless queryTitle replaces the heading. NotFoundEmpty and all imported fixtures stay English. See the Catalog labels live preview. NoAccessEmpty accepts showRequestAccess?: boolean (default true): false hides both the request button and its status announcement, so defaultRequested has no visible effect. action?: { label: string; href: string } renders one kit Link, styled like FirstRunEmpty’s secondary link; it is secondaryAction after the request button, or primaryAction when showRequestAccess is false. With showRequestAccess=false and no action, it renders no actions. Omitting onRequestAccess still shows the button by default. See the Spanish live preview for no actions, a link alone, and a link with the request button.',
8
+ 'Four canonical empty states: first run (with checklist), no results (clear filters/search), no access (request access) and not found (optional action). FirstRunEmpty, NoResultsEmpty and NoAccessEmpty accept labels?: Partial<FirstRunEmptyLabels>, Partial<NoResultsEmptyLabels> and Partial<NoAccessEmptyLabels> respectively. Each type has its own keys below; explicit title, description, actionLabel and secondary props win. FirstRunEmpty accepts actionLabel?: string | null: omitting it uses labels.action or the localized default; actionLabel={null} or actionLabel="" hides the primary action and ignores onAction. An empty labels.action also hides it. Combine actionLabel={null}, secondary={null} and steps={[]} for a state with no actions or checklist. See the Hidden action live preview. Defaults follow I18nProvider (en/es). NoResultsEmpty keeps the query in a mono span unless queryTitle replaces the heading. NotFoundEmpty and all imported fixtures stay English. See the Catalog labels live preview. NoAccessEmpty accepts showRequestAccess?: boolean (default true): false hides both the request button and its status announcement, so defaultRequested has no visible effect. action?: { label: string; href: string } renders one kit Link, styled like FirstRunEmpty’s secondary link; it is secondaryAction after the request button, or primaryAction when showRequestAccess is false. With showRequestAccess=false and no action, it renders no actions. Omitting onRequestAccess still shows the button by default. See the Spanish live preview for no actions, a link alone, and a link with the request button.',
9
9
  labels: [
10
10
  {
11
11
  key: 'FirstRunEmpty.labels.title',
@@ -0,0 +1,13 @@
1
+ import { FirstRunEmpty } from '../EmptyStates';
2
+
3
+ export default function HiddenAction() {
4
+ return (
5
+ <FirstRunEmpty
6
+ title="No projects yet"
7
+ description="Projects will appear here when they are available."
8
+ actionLabel={null}
9
+ secondary={null}
10
+ steps={[]}
11
+ />
12
+ );
13
+ }
@@ -1,7 +1,16 @@
1
1
  import { Check, Copy, RotateCw, ServerCrash } from '@gntik-ai/icons';
2
2
  import type { LucideIcon } from '@gntik-ai/icons';
3
- import { Button, Collapsible, CollapsiblePanel, CollapsibleTrigger, IconButton, cn, useI18n } from '@gntik-ai/ui';
4
- import { useId, useRef, useState, type ReactNode } from 'react';
3
+ import {
4
+ Button,
5
+ Collapsible,
6
+ CollapsiblePanel,
7
+ CollapsibleTrigger,
8
+ IconButton,
9
+ cn,
10
+ useClipboard,
11
+ useI18n,
12
+ } from '@gntik-ai/ui';
13
+ import { useId, useState, type ReactNode } from 'react';
5
14
  import type { FeedbackAction } from '../types';
6
15
 
7
16
  export interface ErrorPanelLabels {
@@ -71,8 +80,7 @@ export function ErrorPanel({
71
80
  const retryLabel = retryLabelProp ?? labels?.retry ?? t('error.retry');
72
81
  const id = useId();
73
82
  const [innerRetrying, setInnerRetrying] = useState(false);
74
- const [copied, setCopied] = useState(false);
75
- const copyTimer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);
83
+ const { copied, copy: copyText } = useClipboard();
76
84
  const busy = retrying ?? innerRetrying;
77
85
 
78
86
  const retry = async () => {
@@ -85,17 +93,7 @@ export function ErrorPanel({
85
93
  }
86
94
  };
87
95
 
88
- const copy = async () => {
89
- if (!requestId) return;
90
- try {
91
- await navigator.clipboard.writeText(requestId);
92
- setCopied(true);
93
- clearTimeout(copyTimer.current);
94
- copyTimer.current = setTimeout(() => setCopied(false), 2000);
95
- } catch {
96
- setCopied(false);
97
- }
98
- };
96
+ const copy = () => requestId && copyText(requestId);
99
97
 
100
98
  return (
101
99
  <section
@@ -0,0 +1,123 @@
1
+ import { act, fireEvent, render, screen, waitFor } from '@testing-library/react';
2
+ import userEvent from '@testing-library/user-event';
3
+ import { useState } from 'react';
4
+ import { CreateApiKeyDialog } from './CreateApiKeyDialog';
5
+
6
+ async function fillAndSubmit(user: ReturnType<typeof userEvent.setup>) {
7
+ await user.type(await screen.findByLabelText(/Name/), 'ci');
8
+ await user.click(screen.getByRole('checkbox', { name: 'projects:read' }));
9
+ await user.click(screen.getByRole('button', { name: 'Create key' }));
10
+ }
11
+
12
+ describe('CreateApiKeyDialog lifecycle', () => {
13
+ it('never creates a second key from the secret step', async () => {
14
+ const user = userEvent.setup();
15
+ const onCreate = vi.fn().mockResolvedValue('sk_test_123');
16
+ render(<CreateApiKeyDialog onCreate={onCreate} />);
17
+ await user.click(screen.getByRole('button', { name: 'Create API key' }));
18
+ await fillAndSubmit(user);
19
+ const dialog = await screen.findByRole('dialog', { name: 'API key created' });
20
+ fireEvent.submit(dialog.querySelector('form')!);
21
+ await user.keyboard('{Enter}');
22
+ expect(onCreate).toHaveBeenCalledTimes(1);
23
+ });
24
+
25
+ it('ignores Escape and a second submit while the key is being created', async () => {
26
+ const user = userEvent.setup();
27
+ let release!: (secret: string) => void;
28
+ const onCreate = vi.fn(() => new Promise<string>((resolve) => (release = resolve)));
29
+ const onOpenChange = vi.fn();
30
+ render(<CreateApiKeyDialog onCreate={onCreate} onOpenChange={onOpenChange} />);
31
+ await user.click(screen.getByRole('button', { name: 'Create API key' }));
32
+ await fillAndSubmit(user);
33
+ onOpenChange.mockClear();
34
+ expect(screen.getByRole('button', { name: 'Create key' })).toHaveAttribute('aria-busy', 'true');
35
+ await user.keyboard('{Escape}');
36
+ fireEvent.submit(screen.getByRole('dialog').querySelector('form')!);
37
+ expect(screen.getByRole('dialog', { name: 'Create API key' })).toBeInTheDocument();
38
+ expect(onOpenChange).not.toHaveBeenCalled();
39
+ expect(onCreate).toHaveBeenCalledTimes(1);
40
+ await act(async () => release('sk_test_123'));
41
+ expect(await screen.findByRole('dialog', { name: 'API key created' })).toBeInTheDocument();
42
+ });
43
+
44
+ it('shows the titled error at the top of the body and clears it on the next submit', async () => {
45
+ const user = userEvent.setup();
46
+ const onCreate = vi.fn().mockRejectedValueOnce(new Error('Quota exceeded')).mockResolvedValue('sk_test_123');
47
+ render(<CreateApiKeyDialog onCreate={onCreate} />);
48
+ await user.click(screen.getByRole('button', { name: 'Create API key' }));
49
+ await fillAndSubmit(user);
50
+ const alert = await screen.findByRole('alert');
51
+ expect(alert).toHaveTextContent('Key not created');
52
+ expect(alert).toHaveTextContent('Quota exceeded');
53
+ expect(alert.parentElement?.firstElementChild).toBe(alert);
54
+ await user.click(screen.getByRole('button', { name: 'Create key' }));
55
+ expect(await screen.findByRole('dialog', { name: 'API key created' })).toBeInTheDocument();
56
+ expect(screen.queryByText('Quota exceeded')).not.toBeInTheDocument();
57
+ });
58
+
59
+ it('resets the fields after a parent-driven close', async () => {
60
+ const user = userEvent.setup();
61
+ const api: { setOpen: (open: boolean) => void } = { setOpen: () => undefined };
62
+ function Parent() {
63
+ const [open, setOpen] = useState(true);
64
+ api.setOpen = setOpen;
65
+ return <CreateApiKeyDialog open={open} onOpenChange={setOpen} trigger={null} />;
66
+ }
67
+ render(<Parent />);
68
+ await user.type(await screen.findByLabelText(/Name/), 'ci');
69
+ act(() => api.setOpen(false));
70
+ await waitFor(() => expect(screen.queryByRole('dialog')).not.toBeInTheDocument());
71
+ act(() => api.setOpen(true));
72
+ expect(await screen.findByLabelText(/Name/)).toHaveValue('');
73
+ });
74
+
75
+ it('keeps the trigger labelled with the form title while the secret step is shown', async () => {
76
+ const user = userEvent.setup();
77
+ render(<CreateApiKeyDialog onCreate={() => 'sk_test_123'} />);
78
+ await user.click(screen.getByRole('button', { name: 'Create API key' }));
79
+ await fillAndSubmit(user);
80
+ await screen.findByRole('dialog', { name: 'API key created' });
81
+ expect(screen.getByRole('button', { name: 'Create API key', hidden: true })).toBeInTheDocument();
82
+ });
83
+
84
+ it('discards a secret that arrives after a parent-driven close', async () => {
85
+ const user = userEvent.setup();
86
+ let release!: (secret: string) => void;
87
+ const onCreate = vi.fn(() => new Promise<string>((resolve) => (release = resolve)));
88
+ const api: { setOpen: (open: boolean) => void } = { setOpen: () => undefined };
89
+ function Parent() {
90
+ const [open, setOpen] = useState(true);
91
+ api.setOpen = setOpen;
92
+ return <CreateApiKeyDialog open={open} onOpenChange={setOpen} onCreate={onCreate} trigger={null} />;
93
+ }
94
+ render(<Parent />);
95
+ await fillAndSubmit(user);
96
+ act(() => api.setOpen(false));
97
+ await waitFor(() => expect(screen.queryByRole('dialog')).not.toBeInTheDocument());
98
+ await act(async () => release('sk_stale_secret'));
99
+ act(() => api.setOpen(true));
100
+ expect(await screen.findByRole('dialog', { name: 'Create API key' })).toBeInTheDocument();
101
+ expect(screen.queryByText('sk_stale_secret')).not.toBeInTheDocument();
102
+ });
103
+
104
+ it('drops a rejection that arrives after a parent-driven close', async () => {
105
+ const user = userEvent.setup();
106
+ let fail!: (reason: Error) => void;
107
+ const onCreate = vi.fn(() => new Promise<string>((_resolve, reject) => (fail = reject)));
108
+ const api: { setOpen: (open: boolean) => void } = { setOpen: () => undefined };
109
+ function Parent() {
110
+ const [open, setOpen] = useState(true);
111
+ api.setOpen = setOpen;
112
+ return <CreateApiKeyDialog open={open} onOpenChange={setOpen} onCreate={onCreate} trigger={null} />;
113
+ }
114
+ render(<Parent />);
115
+ await fillAndSubmit(user);
116
+ act(() => api.setOpen(false));
117
+ await waitFor(() => expect(screen.queryByRole('dialog')).not.toBeInTheDocument());
118
+ await act(async () => fail(new Error('Stale failure')));
119
+ act(() => api.setOpen(true));
120
+ await screen.findByRole('dialog', { name: 'Create API key' });
121
+ expect(screen.queryByText('Stale failure')).not.toBeInTheDocument();
122
+ });
123
+ });