@gntik-ai/blocks 0.9.0 → 0.11.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 (162) hide show
  1. package/dist/index.d.ts +426 -55
  2. package/dist/index.js +2275 -639
  3. package/dist/index.js.map +1 -1
  4. package/package.json +6 -6
  5. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.labels.test.tsx +179 -0
  6. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.tsx +59 -24
  7. package/src/auth/ForgotPasswordForm/block.meta.ts +22 -1
  8. package/src/auth/ForgotPasswordForm/examples/Labels.tsx +29 -0
  9. package/src/auth/MfaChallenge/MfaChallenge.labels.test.tsx +139 -0
  10. package/src/auth/MfaChallenge/MfaChallenge.tsx +69 -23
  11. package/src/auth/MfaChallenge/block.meta.ts +29 -1
  12. package/src/auth/MfaChallenge/examples/Labels.tsx +28 -0
  13. package/src/auth/ResetPasswordForm/ResetPasswordForm.labels.test.tsx +104 -0
  14. package/src/auth/ResetPasswordForm/ResetPasswordForm.tsx +42 -15
  15. package/src/auth/ResetPasswordForm/block.meta.ts +17 -1
  16. package/src/auth/ResetPasswordForm/examples/Labels.tsx +28 -0
  17. package/src/auth/SignInForm/SignInForm.labels.test.tsx +137 -0
  18. package/src/auth/SignInForm/SignInForm.tsx +43 -16
  19. package/src/auth/SignInForm/block.meta.ts +22 -1
  20. package/src/auth/SignInForm/examples/Labels.tsx +29 -0
  21. package/src/auth/SignUpForm/SignUpForm.labels.test.tsx +217 -0
  22. package/src/auth/SignUpForm/SignUpForm.tsx +65 -26
  23. package/src/auth/SignUpForm/block.meta.ts +27 -1
  24. package/src/auth/SignUpForm/examples/Labels.tsx +29 -0
  25. package/src/auth/SsoButtons/SsoButtons.labels.test.tsx +30 -0
  26. package/src/auth/SsoButtons/SsoButtons.tsx +10 -2
  27. package/src/auth/SsoButtons/block.meta.ts +8 -1
  28. package/src/auth/SsoButtons/examples/Labels.tsx +24 -0
  29. package/src/auth/shared.i18n.test.tsx +71 -0
  30. package/src/auth/shared.tsx +48 -11
  31. package/src/billing/CostBreakdown/CostBreakdown.test.tsx +10 -0
  32. package/src/billing/CostBreakdown/CostBreakdown.tsx +50 -43
  33. package/src/billing/SpendVsBudget/SpendVsBudget.test.tsx +10 -0
  34. package/src/billing/SpendVsBudget/SpendVsBudget.tsx +35 -31
  35. package/src/builders/FlowBuilder/FlowBuilder.test.tsx +237 -2
  36. package/src/builders/FlowBuilder/FlowBuilder.tsx +101 -29
  37. package/src/builders/FlowBuilder/block.meta.ts +1 -1
  38. package/src/builders/FlowBuilder/connections.ts +30 -12
  39. package/src/builders/FlowBuilder/examples/ControlledGraph.tsx +8 -0
  40. package/src/builders/FlowBuilder/graph-state.ts +78 -0
  41. package/src/builders/LogViewer/LogViewer.labels.test.tsx +90 -0
  42. package/src/builders/LogViewer/LogViewer.levels.test.tsx +49 -0
  43. package/src/builders/LogViewer/LogViewer.tsx +72 -18
  44. package/src/builders/LogViewer/LogViewer.wrap.test.tsx +181 -0
  45. package/src/builders/LogViewer/block.meta.ts +19 -1
  46. package/src/builders/LogViewer/examples/Spanish.tsx +30 -0
  47. package/src/builders/LogViewer/examples/Wrap.tsx +62 -0
  48. package/src/builders/LogViewer/use-wrapped-log-rows.ts +42 -0
  49. package/src/data-display/ChartCard/ChartCard.locale.test.tsx +15 -0
  50. package/src/data-display/ChartCard/ChartCard.test.tsx +9 -0
  51. package/src/data-display/ChartCard/ChartCard.tsx +81 -67
  52. package/src/data-display/ChartCard/block.meta.ts +1 -1
  53. package/src/data-display/DescriptionListCard/DescriptionListCard.labels.test.tsx +73 -0
  54. package/src/data-display/DescriptionListCard/DescriptionListCard.options.test.tsx +64 -0
  55. package/src/data-display/DescriptionListCard/DescriptionListCard.tsx +74 -23
  56. package/src/data-display/DescriptionListCard/block.meta.ts +11 -1
  57. package/src/data-display/DescriptionListCard/examples/Spanish.tsx +29 -0
  58. package/src/feedback/EmptyStates/EmptyStates.labels.test.tsx +185 -0
  59. package/src/feedback/EmptyStates/EmptyStates.tsx +101 -30
  60. package/src/feedback/EmptyStates/NoAccessEmpty.options.test.tsx +38 -0
  61. package/src/feedback/EmptyStates/block.meta.ts +73 -1
  62. package/src/feedback/EmptyStates/examples/Spanish.tsx +48 -0
  63. package/src/feedback/ErrorPanel/ErrorPanel.labels.test.tsx +99 -0
  64. package/src/feedback/ErrorPanel/ErrorPanel.tsx +38 -9
  65. package/src/feedback/ErrorPanel/block.meta.ts +19 -1
  66. package/src/feedback/ErrorPanel/examples/Spanish.tsx +30 -0
  67. package/src/feedback/InlineCallout/InlineCallout.labels.test.tsx +62 -0
  68. package/src/feedback/InlineCallout/InlineCallout.tsx +22 -9
  69. package/src/feedback/InlineCallout/block.meta.ts +9 -1
  70. package/src/feedback/InlineCallout/examples/Spanish.tsx +19 -0
  71. package/src/feedback/Skeletons/Skeletons.labels.test.tsx +24 -0
  72. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.labels.test.tsx +115 -0
  73. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.tsx +63 -21
  74. package/src/forms/CreateApiKeyDialog/block.meta.ts +22 -1
  75. package/src/forms/CreateApiKeyDialog/examples/Labels.tsx +29 -0
  76. package/src/forms/CredentialDisclosureDialog/CredentialDisclosureDialog.labels.test.tsx +165 -0
  77. package/src/forms/CredentialDisclosureDialog/CredentialDisclosureDialog.tsx +31 -8
  78. package/src/forms/CredentialDisclosureDialog/SecretCopy.tsx +16 -8
  79. package/src/forms/CredentialDisclosureDialog/block.meta.ts +19 -1
  80. package/src/forms/CredentialDisclosureDialog/examples/Labels.tsx +38 -0
  81. package/src/forms/DangerZone/ConfirmDestructiveDialog.tsx +17 -3
  82. package/src/forms/DangerZone/DangerZone.labels.test.tsx +87 -0
  83. package/src/forms/DangerZone/DangerZone.tsx +20 -5
  84. package/src/forms/DangerZone/block.meta.ts +10 -1
  85. package/src/forms/DangerZone/examples/Labels.tsx +29 -0
  86. package/src/forms/DateRangeFilter/DateRangeFilter.labels.test.tsx +52 -0
  87. package/src/forms/DateRangeFilter/DateRangeFilter.tsx +11 -3
  88. package/src/forms/DateRangeFilter/block.meta.ts +8 -1
  89. package/src/forms/DateRangeFilter/examples/Labels.tsx +28 -0
  90. package/src/forms/DialogWizard/DialogWizard.labels.test.tsx +37 -0
  91. package/src/forms/DialogWizard/DialogWizard.tsx +13 -2
  92. package/src/forms/DialogWizard/block.meta.ts +7 -1
  93. package/src/forms/DialogWizard/examples/Labels.tsx +39 -0
  94. package/src/forms/FileUploadPanel/FileUploadPanel.labels.test.tsx +126 -0
  95. package/src/forms/FileUploadPanel/FileUploadPanel.test.tsx +22 -1
  96. package/src/forms/FileUploadPanel/FileUploadPanel.tsx +85 -22
  97. package/src/forms/FileUploadPanel/block.meta.ts +22 -1
  98. package/src/forms/FileUploadPanel/examples/Labels.tsx +29 -0
  99. package/src/forms/FileUploadPanel/fixtures.ts +0 -12
  100. package/src/forms/FileUploadPanel/format-bytes.test.ts +8 -0
  101. package/src/forms/FormSection/FormSection.labels.test.tsx +37 -0
  102. package/src/forms/FormSection/FormSection.tsx +14 -3
  103. package/src/forms/FormSection/block.meta.ts +7 -1
  104. package/src/forms/FormSection/examples/Labels.tsx +27 -0
  105. package/src/forms/InviteMembersDialog/InviteMembersDialog.labels.test.tsx +87 -0
  106. package/src/forms/InviteMembersDialog/InviteMembersDialog.tsx +51 -16
  107. package/src/forms/InviteMembersDialog/block.meta.ts +20 -1
  108. package/src/forms/InviteMembersDialog/examples/Labels.tsx +28 -0
  109. package/src/forms/SettingsRow/SettingsRow.labels.test.tsx +33 -0
  110. package/src/forms/SettingsRow/SettingsRow.tsx +14 -3
  111. package/src/forms/SettingsRow/block.meta.ts +7 -1
  112. package/src/forms/SettingsRow/examples/Labels.tsx +27 -0
  113. package/src/forms/ValidationSummary/ValidationSummary.labels.test.tsx +47 -0
  114. package/src/forms/ValidationSummary/ValidationSummary.tsx +9 -3
  115. package/src/forms/ValidationSummary/block.meta.ts +6 -1
  116. package/src/forms/ValidationSummary/examples/Labels.tsx +24 -0
  117. package/src/forms/index.ts +5 -1
  118. package/src/forms/translated-content.tsx +12 -0
  119. package/src/page-chrome/PageHeader/PageHeader.labels.test.tsx +56 -0
  120. package/src/page-chrome/PageHeader/PageHeader.options.test.tsx +34 -0
  121. package/src/page-chrome/PageHeader/PageHeader.tsx +26 -5
  122. package/src/page-chrome/PageHeader/block.meta.ts +8 -1
  123. package/src/page-chrome/PageHeader/examples/Labels.tsx +16 -0
  124. package/src/page-chrome/PageHeader/examples/Spanish.tsx +11 -0
  125. package/src/scheduling/AgendaList/AgendaList.test.tsx +25 -0
  126. package/src/scheduling/AgendaList/AgendaList.tsx +7 -2
  127. package/src/scheduling/AgendaList/AgendaListLocale.test.tsx +11 -0
  128. package/src/scheduling/AgendaList/block.meta.ts +1 -1
  129. package/src/scheduling/AgendaList/examples/Locale.tsx +29 -0
  130. package/src/scheduling/MonthCalendar/MonthCalendar.test.tsx +111 -1
  131. package/src/scheduling/MonthCalendar/MonthCalendar.tsx +19 -9
  132. package/src/scheduling/MonthCalendar/block.meta.ts +1 -1
  133. package/src/scheduling/MonthCalendar/examples/Locale.tsx +19 -0
  134. package/src/scheduling/WeekCalendar/WeekCalendar.test.tsx +73 -2
  135. package/src/scheduling/WeekCalendar/WeekCalendar.tsx +26 -12
  136. package/src/scheduling/WeekCalendar/block.meta.ts +1 -1
  137. package/src/scheduling/WeekCalendar/examples/Locale.tsx +19 -0
  138. package/src/scheduling/shared/dates.test.ts +75 -0
  139. package/src/scheduling/shared/dates.ts +46 -22
  140. package/src/scheduling/shared/useSchedulingClock.ts +13 -0
  141. package/src/shell/GlobalSearch/GlobalSearch.test.tsx +12 -0
  142. package/src/shell/GlobalSearch/fixtures.ts +2 -2
  143. package/src/tables/DataTable/DataTable.cross-page-selection.test.tsx +322 -0
  144. package/src/tables/DataTable/DataTable.labels.test.tsx +74 -0
  145. package/src/tables/DataTable/DataTable.server-pagination.test.tsx +1 -1
  146. package/src/tables/DataTable/DataTable.single-select.test.tsx +47 -7
  147. package/src/tables/DataTable/DataTable.test.tsx +55 -0
  148. package/src/tables/DataTable/DataTable.tsx +134 -67
  149. package/src/tables/DataTable/block.meta.ts +21 -3
  150. package/src/tables/DataTable/data-table-props.ts +14 -5
  151. package/src/tables/DataTable/data-table-row.tsx +7 -3
  152. package/src/tables/DataTable/data-table-utils.ts +2 -0
  153. package/src/tables/DataTable/examples/client-selection.tsx +33 -0
  154. package/src/tables/DataTable/examples/paginated-single-selection.tsx +46 -0
  155. package/src/tables/DataTable/examples/server-pagination.tsx +55 -15
  156. package/src/tables/DataTable/labels.ts +4 -0
  157. package/src/tables/DataTable/selection-strip.tsx +31 -0
  158. package/src/tables/DataTable/single-selection.tsx +0 -7
  159. package/src/tables/DataTable/use-multiple-selection.ts +86 -0
  160. package/src/tables/PaginationFooter/PaginationFooter.i18n.test.tsx +26 -0
  161. package/src/test/OptInDefaults.test.tsx +27 -0
  162. package/src/test/fixtures/opt-in-defaults.json +10 -0
@@ -1,5 +1,6 @@
1
1
  import {
2
2
  AreaChart,
3
+ ChartLocaleProvider,
3
4
  BarChart,
4
5
  Heatmap,
5
6
  LineChart,
@@ -9,7 +10,17 @@ import {
9
10
  type HeatmapProps,
10
11
  type ValueFormatter,
11
12
  } from '@gntik-ai/charts';
12
- import { Card, CardAction, CardDescription, CardHeader, CardTitle, cn, Toggle, ToggleGroup } from '@gntik-ai/ui';
13
+ import {
14
+ Card,
15
+ CardAction,
16
+ CardDescription,
17
+ CardHeader,
18
+ CardTitle,
19
+ useI18n,
20
+ cn,
21
+ Toggle,
22
+ ToggleGroup,
23
+ } from '@gntik-ai/ui';
13
24
  import { useEffect, useRef, useState, type ReactNode } from 'react';
14
25
  import { TrendDelta, type KpiDelta } from '../shared/TrendDelta';
15
26
  import { COST_BY_RANGE, COST_RANGES, type CostPoint } from './fixtures';
@@ -146,73 +157,76 @@ export function ChartCard<T extends object = CostPoint>({
146
157
  'aria-label': chartLabel,
147
158
  ...states,
148
159
  };
160
+ const { locale } = useI18n();
149
161
  return (
150
- <Card className={className}>
151
- <CardHeader className="pb-2">
152
- <CardTitle as={titleAs}>{title}</CardTitle>
153
- {description && <CardDescription>{description}</CardDescription>}
154
- <CardAction className="flex items-center gap-2">
155
- {showRangeToggle && ranges.length > 1 && (
156
- <ToggleGroup
157
- aria-label={`${title} range`}
158
- size="sm"
159
- value={active ? [active.value] : []}
160
- onFocus={(event) => {
161
- // Tab enters at the pressed option; pointer and restored focus stay on their original option.
162
- if (!tabEntry.current) return;
163
- if (event.relatedTarget instanceof Node && event.currentTarget.contains(event.relatedTarget)) return;
164
- const selected = event.currentTarget.querySelector<HTMLButtonElement>('[aria-pressed="true"]');
165
- selected?.focus();
166
- }}
167
- onValueChange={(v) => {
168
- const next = v[0];
169
- if (!next) return;
170
- if (rangeProp === undefined) setInner(next);
171
- onRangeChange?.(next);
172
- }}
173
- >
174
- {ranges.map((r) => (
175
- <Toggle key={r.value} value={r.value} className="font-mono">
176
- {r.label}
177
- </Toggle>
178
- ))}
179
- </ToggleGroup>
180
- )}
181
- {action}
182
- </CardAction>
183
- </CardHeader>
184
- {active?.summary && (
185
- <p className="flex flex-wrap items-baseline gap-x-2 px-5" aria-live="polite">
186
- <span className="text-[24px] font-semibold tracking-tight text-foreground tabular-nums">
187
- {active.summary.value}
188
- </span>
189
- {active.summary.delta && <TrendDelta {...active.summary.delta} />}
190
- </p>
191
- )}
192
- <div className={cn('px-3 pb-4 pt-3 sm:px-4', !footer && 'pb-5')}>
193
- {kind === 'heatmap' ? (
194
- <Heatmap
195
- data={data}
196
- index={index}
197
- categories={categories}
198
- color={colors[0] ?? 'primary'}
199
- valueFormatter={valueFormatter}
200
- showScale={showLegend}
201
- height={height}
202
- aria-label={chartLabel}
203
- {...heatmap}
204
- {...states}
205
- dataTable={dataTable ?? true}
206
- />
207
- ) : kind === 'bar' ? (
208
- <BarChart {...common} stacked={stacked} />
209
- ) : kind === 'line' ? (
210
- <LineChart {...common} />
211
- ) : (
212
- <AreaChart {...common} stacked={stacked} />
162
+ <ChartLocaleProvider locale={locale}>
163
+ <Card className={className}>
164
+ <CardHeader className="pb-2">
165
+ <CardTitle as={titleAs}>{title}</CardTitle>
166
+ {description && <CardDescription>{description}</CardDescription>}
167
+ <CardAction className="flex items-center gap-2">
168
+ {showRangeToggle && ranges.length > 1 && (
169
+ <ToggleGroup
170
+ aria-label={`${title} range`}
171
+ size="sm"
172
+ value={active ? [active.value] : []}
173
+ onFocus={(event) => {
174
+ // Tab enters at the pressed option; pointer and restored focus stay on their original option.
175
+ if (!tabEntry.current) return;
176
+ if (event.relatedTarget instanceof Node && event.currentTarget.contains(event.relatedTarget)) return;
177
+ const selected = event.currentTarget.querySelector<HTMLButtonElement>('[aria-pressed="true"]');
178
+ selected?.focus();
179
+ }}
180
+ onValueChange={(v) => {
181
+ const next = v[0];
182
+ if (!next) return;
183
+ if (rangeProp === undefined) setInner(next);
184
+ onRangeChange?.(next);
185
+ }}
186
+ >
187
+ {ranges.map((r) => (
188
+ <Toggle key={r.value} value={r.value} className="font-mono">
189
+ {r.label}
190
+ </Toggle>
191
+ ))}
192
+ </ToggleGroup>
193
+ )}
194
+ {action}
195
+ </CardAction>
196
+ </CardHeader>
197
+ {active?.summary && (
198
+ <p className="flex flex-wrap items-baseline gap-x-2 px-5" aria-live="polite">
199
+ <span className="text-[24px] font-semibold tracking-tight text-foreground tabular-nums">
200
+ {active.summary.value}
201
+ </span>
202
+ {active.summary.delta && <TrendDelta {...active.summary.delta} />}
203
+ </p>
213
204
  )}
214
- </div>
215
- {footer && <div className="border-t border-border px-5 py-3 text-[12.5px] text-muted-foreground">{footer}</div>}
216
- </Card>
205
+ <div className={cn('px-3 pb-4 pt-3 sm:px-4', !footer && 'pb-5')}>
206
+ {kind === 'heatmap' ? (
207
+ <Heatmap
208
+ data={data}
209
+ index={index}
210
+ categories={categories}
211
+ color={colors[0] ?? 'primary'}
212
+ valueFormatter={valueFormatter}
213
+ showScale={showLegend}
214
+ height={height}
215
+ aria-label={chartLabel}
216
+ {...heatmap}
217
+ {...states}
218
+ dataTable={dataTable ?? true}
219
+ />
220
+ ) : kind === 'bar' ? (
221
+ <BarChart {...common} stacked={stacked} />
222
+ ) : kind === 'line' ? (
223
+ <LineChart {...common} />
224
+ ) : (
225
+ <AreaChart {...common} stacked={stacked} />
226
+ )}
227
+ </div>
228
+ {footer && <div className="border-t border-border px-5 py-3 text-[12.5px] text-muted-foreground">{footer}</div>}
229
+ </Card>
230
+ </ChartLocaleProvider>
217
231
  );
218
232
  }
@@ -5,6 +5,6 @@ export const meta: BlockMeta = {
5
5
  family: 'data-display',
6
6
  status: 'beta',
7
7
  description:
8
- 'A Card with chart and legend: default 7d/30d/90d or custom ranges via ranges, controlled range/onRangeChange, and showRangeToggle={false} when a toolbar owns the range (pass its window as range). Supports title, optional headline and delta, area/line/bar/heatmap charts, and loading, empty and error states. Supply matching dataByRange keys and use defaultRange for initial uncontrolled selection; the toolbar is the only range control when the toggle is hidden. Unknown range/defaultRange keys fall back to the first option for selection, data and label, with a development-only warning.',
8
+ 'A Card with chart and legend: default 7d/30d/90d or custom ranges via ranges, controlled range/onRangeChange, and showRangeToggle={false} when a toolbar owns the range (pass its window as range). Supports title, optional headline and delta, area/line/bar/heatmap charts, and loading, empty and error states. Supply matching dataByRange keys and use defaultRange for initial uncontrolled selection; the toolbar is the only range control when the toggle is hidden. Unknown range/defaultRange keys fall back to the first option for selection, data and label, with a development-only warning. Chart states follow the kit I18nProvider locale automatically through ChartLocaleProvider; standalone charts need their own ChartLocaleProvider (en/es, per-key labels overrides). Number/date formatting stays caller-controlled.',
9
9
  uses: ['Card', 'ToggleGroup', 'AreaChart', 'LineChart', 'BarChart', 'Heatmap', 'ChartLegend'],
10
10
  };
@@ -0,0 +1,73 @@
1
+ import { render, screen } from '@testing-library/react';
2
+ import userEvent from '@testing-library/user-event';
3
+ import { I18nProvider, es } from '@gntik-ai/ui';
4
+ import { DescriptionListCard, type DescriptionListCardLabels } from './DescriptionListCard';
5
+ import { DEPLOYMENT_DETAILS } from './fixtures';
6
+
7
+ it('localizes card defaults, copy names and announcements while retaining fixture fields', async () => {
8
+ const user = userEvent.setup();
9
+ render(
10
+ <I18nProvider locale="es">
11
+ <DescriptionListCard onEdit={() => {}} />
12
+ </I18nProvider>,
13
+ );
14
+ expect(screen.getByRole('heading', { name: es['descriptionList.title'] })).toHaveTextContent('Configuración');
15
+ expect(screen.getByText(es['descriptionList.description'])).toBeVisible();
16
+ expect(screen.getByRole('button', { name: es['descriptionList.edit'] })).toBeVisible();
17
+ for (const item of DEPLOYMENT_DETAILS) {
18
+ expect(screen.getByText(item.label)).toBeVisible();
19
+ if (item.value && !item.status && !item.render) expect(screen.getByText(item.value)).toBeVisible();
20
+ }
21
+ await user.click(screen.getByRole('button', { name: 'Copiar Deployment ID' }));
22
+ expect(screen.getByRole('button', { name: 'Deployment ID copiado' })).toBeVisible();
23
+ expect(screen.getByText(es['common.copiedToClipboard'])).toBeInTheDocument();
24
+ expect(await navigator.clipboard.readText()).toBe('dep_7f3c9a21');
25
+ expect(document.body.textContent).not.toContain('{');
26
+ });
27
+
28
+ it('keeps English defaults and lets explicit props win over every override', async () => {
29
+ const user = userEvent.setup();
30
+ const { rerender } = render(<DescriptionListCard onEdit={() => {}} />);
31
+ expect(screen.getByRole('heading', { name: 'Configuration' })).toBeVisible();
32
+ expect(screen.getByText('Settings of this deployment.')).toBeVisible();
33
+ expect(screen.getByRole('button', { name: 'Edit' })).toBeVisible();
34
+ await user.click(screen.getByRole('button', { name: 'Copy Deployment ID' }));
35
+ expect(screen.getByRole('button', { name: 'Deployment ID copied' })).toBeVisible();
36
+ expect(screen.getByText('Copied to clipboard')).toBeInTheDocument();
37
+ const labels: DescriptionListCardLabels = {
38
+ title: 'Title override',
39
+ description: 'Description override',
40
+ edit: 'Edit override',
41
+ copy: (label) => `Copy override ${label}`,
42
+ copied: (label) => `Copied override ${label}`,
43
+ copiedToClipboard: 'Announce override',
44
+ };
45
+ const view = (overrides: Partial<DescriptionListCardLabels>, explicit = false) => (
46
+ <I18nProvider locale="es">
47
+ <DescriptionListCard
48
+ labels={overrides}
49
+ onEdit={() => {}}
50
+ title={explicit ? 'Explicit title' : undefined}
51
+ description={explicit ? 'Explicit description' : undefined}
52
+ editLabel={explicit ? 'Explicit edit' : undefined}
53
+ />
54
+ </I18nProvider>
55
+ );
56
+ rerender(view(labels));
57
+ expect(screen.getByRole('heading', { name: labels.title })).toBeVisible();
58
+ expect(screen.getByText(labels.description)).toBeVisible();
59
+ expect(screen.getByRole('button', { name: labels.edit })).toBeVisible();
60
+ await user.click(screen.getByRole('button', { name: 'Copy override Deployment ID' }));
61
+ expect(screen.getByRole('button', { name: 'Copied override Deployment ID' })).toBeVisible();
62
+ expect(screen.getByText(labels.copiedToClipboard)).toBeInTheDocument();
63
+ await user.click(screen.getByRole('button', { name: 'Copy override Endpoint' }));
64
+ expect(screen.getByRole('button', { name: 'Copied override Endpoint' })).toBeVisible();
65
+ rerender(view(labels, true));
66
+ expect(screen.getByRole('heading', { name: 'Explicit title' })).toBeVisible();
67
+ expect(screen.getByText('Explicit description')).toBeVisible();
68
+ expect(screen.getByRole('button', { name: 'Explicit edit' })).toBeVisible();
69
+ rerender(view({ edit: 'Only edit' }));
70
+ expect(screen.getByRole('heading', { name: es['descriptionList.title'] })).toBeVisible();
71
+ expect(screen.getByText(es['descriptionList.description'])).toBeVisible();
72
+ expect(screen.getByRole('button', { name: 'Deployment ID copiado' })).toBeVisible();
73
+ });
@@ -0,0 +1,64 @@
1
+ import { render, screen } from '@testing-library/react';
2
+ import { expectNoAxeViolations } from '../../test/a11y';
3
+ import { DescriptionListCard } from './DescriptionListCard';
4
+
5
+ it('wraps a full unbroken value only when requested', () => {
6
+ const value = 'x'.repeat(120);
7
+ const items = [{ id: 'id', label: 'Identifier', value, mono: true, copyable: true }];
8
+ const { rerender } = render(<DescriptionListCard items={items} wrap />);
9
+ const span = screen.getByText(value);
10
+ expect(span.tagName).toBe('SPAN');
11
+ expect(span).not.toHaveClass('truncate');
12
+ expect(span).toHaveClass('min-w-0', 'wrap-anywhere', 'font-mono');
13
+ expect(span.textContent).toBe(value);
14
+ expect(screen.getByRole('button', { name: 'Copy Identifier' })).toBeInTheDocument();
15
+ rerender(<DescriptionListCard items={items} />);
16
+ expect(screen.getByText(value)).toHaveClass('min-w-0', 'truncate');
17
+ });
18
+
19
+ it.each([
20
+ [
21
+ 2,
22
+ [
23
+ ['Field 1', 'Field 2', 'Field 3', 'Field 4'],
24
+ ['Field 5', 'Field 6', 'Field 7'],
25
+ ],
26
+ ],
27
+ [3, [['Field 1', 'Field 2', 'Field 3'], ['Field 4', 'Field 5', 'Field 6'], ['Field 7']]],
28
+ ] as const)('stacks terms and values in %i column-major groups', async (columns, expected) => {
29
+ const items = Array.from({ length: 7 }, (_, index) => ({
30
+ id: String(index),
31
+ label: `Field ${index + 1}`,
32
+ value: `Value ${index + 1}`,
33
+ }));
34
+ const { container } = render(<DescriptionListCard columns={columns} items={items} />);
35
+ const groups = Array.from(container.querySelectorAll('dl'));
36
+ expect(groups).toHaveLength(columns);
37
+ const grid = groups[0]!.parentElement!;
38
+ expect(grid).toHaveClass('grid', 'grid-cols-1', `sm:grid-cols-${columns}`);
39
+ expect(Array.from(grid.classList).filter((name) => /border|divide/.test(name))).toEqual([]);
40
+ expect(groups.map((group) => Array.from(group.querySelectorAll('dt'), (term) => term.textContent))).toEqual(expected);
41
+ expect(Array.from(container.querySelectorAll('dt'), (term) => term.textContent)).toEqual([
42
+ 'Field 1',
43
+ 'Field 2',
44
+ 'Field 3',
45
+ 'Field 4',
46
+ 'Field 5',
47
+ 'Field 6',
48
+ 'Field 7',
49
+ ]);
50
+ for (const group of groups) {
51
+ expect(group).toHaveClass('divide-y', 'divide-border');
52
+ for (const row of Array.from(group.children)) {
53
+ expect(row.tagName).toBe('DIV');
54
+ expect(row).toHaveClass('grid', 'grid-cols-1');
55
+ expect(row).not.toHaveClass('sm:grid-cols-[160px_minmax(0,1fr)]');
56
+ expect(Array.from(row.children, (child) => child.tagName)).toEqual(['DT', 'DD']);
57
+ }
58
+ }
59
+ for (const item of items) {
60
+ expect(screen.getAllByText(item.label)).toHaveLength(1);
61
+ expect(screen.getAllByText(item.value)).toHaveLength(1);
62
+ }
63
+ await expectNoAxeViolations(container);
64
+ });
@@ -9,6 +9,7 @@ import {
9
9
  cn,
10
10
  IconButton,
11
11
  StatusTag,
12
+ useI18n,
12
13
  } from '@gntik-ai/ui';
13
14
  import { useEffect, useRef, useState, type ReactNode } from 'react';
14
15
  import { DEPLOYMENT_DETAILS } from './fixtures';
@@ -29,10 +30,25 @@ export interface DescriptionItem {
29
30
  copyValue?: string;
30
31
  }
31
32
 
33
+ export interface DescriptionListCardLabels {
34
+ title: string;
35
+ description: string;
36
+ edit: string;
37
+ copy: (label: string) => string;
38
+ copied: (label: string) => string;
39
+ copiedToClipboard: string;
40
+ }
41
+
32
42
  export interface DescriptionListCardProps {
43
+ /** Per-key copy overrides; explicit props take precedence, then labels, then the active catalog. */
44
+ labels?: Partial<DescriptionListCardLabels>;
33
45
  title?: string;
34
46
  description?: string;
35
47
  items?: readonly DescriptionItem[];
48
+ /** Wrap values, including long unbroken strings, instead of truncating (default false). */
49
+ wrap?: boolean;
50
+ /** Responsive columns; items fill top to bottom in contiguous groups (default 1). */
51
+ columns?: 1 | 2 | 3;
36
52
  /** Shows an Edit button in the header. */
37
53
  onEdit?: () => void;
38
54
  editLabel?: string;
@@ -43,7 +59,16 @@ export interface DescriptionListCardProps {
43
59
  className?: string;
44
60
  }
45
61
 
46
- function CopyButton({ item, onCopy }: { item: DescriptionItem; onCopy?: (item: DescriptionItem) => void }) {
62
+ function CopyButton({
63
+ item,
64
+ onCopy,
65
+ labels,
66
+ }: {
67
+ item: DescriptionItem;
68
+ onCopy?: (item: DescriptionItem) => void;
69
+ labels?: Partial<DescriptionListCardLabels>;
70
+ }) {
71
+ const { t } = useI18n();
47
72
  const [copied, setCopied] = useState(false);
48
73
  const timer = useRef<number | undefined>(undefined);
49
74
  useEffect(() => () => window.clearTimeout(timer.current), []);
@@ -61,14 +86,18 @@ function CopyButton({ item, onCopy }: { item: DescriptionItem; onCopy?: (item: D
61
86
  <>
62
87
  <IconButton
63
88
  icon={copied ? Check : Copy}
64
- label={copied ? `${item.label} copied` : `Copy ${item.label}`}
89
+ label={
90
+ copied
91
+ ? (labels?.copied?.(item.label) ?? t('descriptionList.copied', { label: item.label }))
92
+ : (labels?.copy?.(item.label) ?? t('descriptionList.copy', { label: item.label }))
93
+ }
65
94
  size="sm"
66
95
  variant="ghost"
67
96
  className={cn('size-7 shrink-0', copied && 'text-success-text')}
68
97
  onClick={copy}
69
98
  />
70
99
  <span className="sr-only" aria-live="polite">
71
- {copied ? 'Copied to clipboard' : ''}
100
+ {copied ? (labels?.copiedToClipboard ?? t('common.copiedToClipboard')) : ''}
72
101
  </span>
73
102
  </>
74
103
  );
@@ -76,15 +105,43 @@ function CopyButton({ item, onCopy }: { item: DescriptionItem; onCopy?: (item: D
76
105
 
77
106
  /** Key–value detail card: label column, values (mono, status or rich), copy buttons and an Edit action. */
78
107
  export function DescriptionListCard({
79
- title = 'Configuration',
80
- description = 'Settings of this deployment.',
108
+ title: titleProp,
109
+ labels,
110
+ description: descriptionProp,
81
111
  items = DEPLOYMENT_DETAILS,
112
+ wrap = false,
113
+ columns = 1,
82
114
  onEdit,
83
- editLabel = 'Edit',
115
+ editLabel: editLabelProp,
84
116
  onCopy,
85
117
  titleAs = 'h3',
86
118
  className,
87
119
  }: DescriptionListCardProps) {
120
+ const { t } = useI18n();
121
+ const title = titleProp ?? labels?.title ?? t('descriptionList.title');
122
+ const description = descriptionProp ?? labels?.description ?? t('descriptionList.description');
123
+ const editLabel = editLabelProp ?? labels?.edit ?? t('descriptionList.edit');
124
+ const renderItem = (item: DescriptionItem) => (
125
+ <div
126
+ key={item.id}
127
+ className={cn('grid grid-cols-1 gap-1 py-3.5', columns === 1 && 'sm:grid-cols-[160px_minmax(0,1fr)] sm:gap-4')}
128
+ >
129
+ <dt className="text-[13px] text-muted-foreground">{item.label}</dt>
130
+ <dd className="flex min-w-0 items-center gap-2 text-[13px] text-foreground">
131
+ {item.status ? (
132
+ <StatusTag status={item.status} />
133
+ ) : (
134
+ <span
135
+ className={cn(wrap ? 'min-w-0 wrap-anywhere' : 'min-w-0 truncate', item.mono && 'font-mono text-[12.5px]')}
136
+ >
137
+ {item.render ?? item.value}
138
+ </span>
139
+ )}
140
+ {item.copyable && <CopyButton item={item} onCopy={onCopy} labels={labels} />}
141
+ </dd>
142
+ </div>
143
+ );
144
+ const chunkSize = Math.ceil(items.length / columns);
88
145
  return (
89
146
  <Card className={className}>
90
147
  <CardHeader divided>
@@ -98,23 +155,17 @@ export function DescriptionListCard({
98
155
  </CardAction>
99
156
  )}
100
157
  </CardHeader>
101
- <dl className="divide-y divide-border px-5">
102
- {items.map((item) => (
103
- <div key={item.id} className="grid grid-cols-1 gap-1 py-3.5 sm:grid-cols-[160px_minmax(0,1fr)] sm:gap-4">
104
- <dt className="text-[13px] text-muted-foreground">{item.label}</dt>
105
- <dd className="flex min-w-0 items-center gap-2 text-[13px] text-foreground">
106
- {item.status ? (
107
- <StatusTag status={item.status} />
108
- ) : (
109
- <span className={cn('min-w-0 truncate', item.mono && 'font-mono text-[12.5px]')}>
110
- {item.render ?? item.value}
111
- </span>
112
- )}
113
- {item.copyable && <CopyButton item={item} onCopy={onCopy} />}
114
- </dd>
115
- </div>
116
- ))}
117
- </dl>
158
+ {columns === 1 ? (
159
+ <dl className="divide-y divide-border px-5">{items.map(renderItem)}</dl>
160
+ ) : (
161
+ <div className={cn('grid grid-cols-1 gap-x-6 px-5', columns === 2 ? 'sm:grid-cols-2' : 'sm:grid-cols-3')}>
162
+ {Array.from({ length: columns }, (_, column) => (
163
+ <dl key={column} className="min-w-0 divide-y divide-border">
164
+ {items.slice(column * chunkSize, (column + 1) * chunkSize).map(renderItem)}
165
+ </dl>
166
+ ))}
167
+ </div>
168
+ )}
118
169
  </Card>
119
170
  );
120
171
  }
@@ -1,9 +1,19 @@
1
1
  import type { BlockMeta } from '../../meta';
2
+ import type { DescriptionListCardLabels } from './DescriptionListCard';
2
3
 
3
4
  export const meta: BlockMeta = {
4
5
  name: 'Description list card',
5
6
  family: 'data-display',
6
7
  status: 'beta',
7
- description: 'Key–value detail card with mono, status and rich values, copy-to-clipboard buttons and an Edit action.',
8
+ description:
9
+ 'Key–value detail card with mono, status and rich values, copy-to-clipboard buttons and an Edit action. Optional labels?: Partial<DescriptionListCardLabels> overrides each built-in label. Explicit content props win over labels, then I18nProvider (en/es); no provider keeps English. Imported fixtures and machine data stay unchanged. See the Catalog labels live preview. wrap?: boolean (default false) shows full values and breaks long unbroken strings. columns?: 1 | 2 | 3 (default 1) stacks terms above values in two or three columns from sm, with one column below sm; items fill contiguous top-to-bottom chunks of ceil(item count / columns), and dividers stay within each column. Defaults preserve the original single-column rows. See the Spanish live preview for wrapping and both column layouts.',
10
+ labels: [
11
+ { key: 'title', type: 'string', state: 'Card heading; title prop wins' },
12
+ { key: 'description', type: 'string', state: 'Card description; description prop wins' },
13
+ { key: 'edit', type: 'string', state: 'Edit button; editLabel prop wins' },
14
+ { key: 'copy', type: '(label: string) => string', state: 'Copy button name; original item label' },
15
+ { key: 'copied', type: '(label: string) => string', state: 'Copy button name after copying; original item label' },
16
+ { key: 'copiedToClipboard', type: 'string', state: 'Polite copy announcement' },
17
+ ] satisfies Array<{ key: keyof DescriptionListCardLabels; type: string; state: string }>,
8
18
  uses: ['Card', 'Button', 'IconButton', 'StatusTag'],
9
19
  };
@@ -0,0 +1,29 @@
1
+ import { I18nProvider, Stack } from '@gntik-ai/ui';
2
+ import { DescriptionListCard } from '../DescriptionListCard';
3
+ export default function Spanish() {
4
+ return (
5
+ <I18nProvider locale="es">
6
+ <Stack gap={6}>
7
+ <DescriptionListCard onEdit={() => {}} />
8
+ <DescriptionListCard
9
+ onEdit={() => {}}
10
+ labels={{
11
+ title: 'Resource details',
12
+ description: 'Current settings',
13
+ edit: 'Change',
14
+ copy: (label) => `Copy field ${label}`,
15
+ copied: (label) => `Copied field ${label}`,
16
+ copiedToClipboard: 'Field copied to clipboard',
17
+ }}
18
+ />
19
+ <DescriptionListCard
20
+ title="Full identifiers"
21
+ wrap
22
+ items={[{ id: 'id', label: 'Correlation ID', value: 'a'.repeat(120), mono: true, copyable: true }]}
23
+ />
24
+ <DescriptionListCard title="Two columns" columns={2} />
25
+ <DescriptionListCard title="Three columns" columns={3} />
26
+ </Stack>
27
+ </I18nProvider>
28
+ );
29
+ }