@gntik-ai/blocks 0.10.0 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (248) hide show
  1. package/dist/index.d.ts +1761 -1231
  2. package/dist/index.js +3280 -1088
  3. package/dist/index.js.map +1 -1
  4. package/package.json +6 -6
  5. package/src/ai/PromptEditor/PromptEditor.tsx +2 -2
  6. package/src/ai/PromptEditor/examples/controlled-variables.tsx +1 -1
  7. package/src/ai/TraceWaterfall/TraceWaterfall.tsx +2 -2
  8. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.labels.test.tsx +179 -0
  9. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.test.tsx +6 -0
  10. package/src/auth/ForgotPasswordForm/ForgotPasswordForm.tsx +63 -25
  11. package/src/auth/ForgotPasswordForm/block.meta.ts +22 -1
  12. package/src/auth/ForgotPasswordForm/examples/Labels.tsx +29 -0
  13. package/src/auth/ForgotPasswordForm/examples/LargeFields.tsx +6 -0
  14. package/src/auth/MfaChallenge/MfaChallenge.labels.test.tsx +139 -0
  15. package/src/auth/MfaChallenge/MfaChallenge.test.tsx +9 -0
  16. package/src/auth/MfaChallenge/MfaChallenge.tsx +74 -25
  17. package/src/auth/MfaChallenge/block.meta.ts +29 -1
  18. package/src/auth/MfaChallenge/examples/Labels.tsx +28 -0
  19. package/src/auth/MfaChallenge/examples/LargeFields.tsx +6 -0
  20. package/src/auth/ResetPasswordForm/ResetPasswordForm.labels.test.tsx +104 -0
  21. package/src/auth/ResetPasswordForm/ResetPasswordForm.test.tsx +7 -0
  22. package/src/auth/ResetPasswordForm/ResetPasswordForm.tsx +47 -18
  23. package/src/auth/ResetPasswordForm/block.meta.ts +17 -1
  24. package/src/auth/ResetPasswordForm/examples/Labels.tsx +28 -0
  25. package/src/auth/ResetPasswordForm/examples/LargeFields.tsx +6 -0
  26. package/src/auth/SignInForm/SignInForm.labels.test.tsx +137 -0
  27. package/src/auth/SignInForm/SignInForm.test.tsx +7 -0
  28. package/src/auth/SignInForm/SignInForm.tsx +48 -17
  29. package/src/auth/SignInForm/block.meta.ts +22 -1
  30. package/src/auth/SignInForm/examples/Labels.tsx +29 -0
  31. package/src/auth/SignInForm/examples/LargeFields.tsx +6 -0
  32. package/src/auth/SignUpForm/SignUpForm.labels.test.tsx +217 -0
  33. package/src/auth/SignUpForm/SignUpForm.test.tsx +22 -0
  34. package/src/auth/SignUpForm/SignUpForm.tsx +72 -27
  35. package/src/auth/SignUpForm/block.meta.ts +27 -1
  36. package/src/auth/SignUpForm/examples/Labels.tsx +29 -0
  37. package/src/auth/SignUpForm/examples/LargeFields.tsx +6 -0
  38. package/src/auth/SsoButtons/SsoButtons.labels.test.tsx +30 -0
  39. package/src/auth/SsoButtons/SsoButtons.tsx +10 -2
  40. package/src/auth/SsoButtons/block.meta.ts +8 -1
  41. package/src/auth/SsoButtons/examples/Labels.tsx +24 -0
  42. package/src/auth/__snapshots__/field-size.test.tsx.snap +11 -0
  43. package/src/auth/field-size.test.tsx +21 -0
  44. package/src/auth/large-examples.test.tsx +30 -0
  45. package/src/auth/shared.i18n.test.tsx +71 -0
  46. package/src/auth/shared.tsx +55 -13
  47. package/src/billing/PaymentMethodCard/PaymentMethodCard.tsx +1 -1
  48. package/src/billing/PlanCard/PlanCard.baseline.test.tsx +3 -2
  49. package/src/billing/PlanCard/__snapshots__/PlanCard.baseline.test.tsx.snap +2 -2
  50. package/src/billing/PlanDefinitionCard/examples/Compact.tsx +1 -4
  51. package/src/billing/PlanDefinitionCard/examples/Full.tsx +1 -4
  52. package/src/builders/CodePanel/CodePanel.tsx +2 -2
  53. package/src/builders/FlowBuilder/FlowBuilder.tsx +4 -19
  54. package/src/builders/FlowBuilder/parts.tsx +4 -4
  55. package/src/builders/LogViewer/LogViewer.follow.test.tsx +29 -0
  56. package/src/builders/LogViewer/LogViewer.levels.test.tsx +49 -0
  57. package/src/builders/LogViewer/LogViewer.test.tsx +24 -0
  58. package/src/builders/LogViewer/LogViewer.tsx +96 -28
  59. package/src/builders/LogViewer/LogViewer.wrap.test.tsx +181 -0
  60. package/src/builders/LogViewer/block.meta.ts +7 -1
  61. package/src/builders/LogViewer/examples/Spanish.tsx +2 -1
  62. package/src/builders/LogViewer/examples/Wrap.tsx +62 -0
  63. package/src/builders/LogViewer/use-wrapped-log-rows.ts +42 -0
  64. package/src/data-display/ActivityFeed/ActivityFeed.tsx +1 -1
  65. package/src/data-display/ChartCard/ChartCard.tsx +2 -2
  66. package/src/data-display/ChartCard/examples/ContainerPanel.tsx +16 -0
  67. package/src/data-display/CommentThread/CommentThread.test.tsx +70 -1
  68. package/src/data-display/CommentThread/CommentThread.tsx +22 -6
  69. package/src/data-display/CommentThread/block.meta.ts +1 -1
  70. package/src/data-display/CommentThread/examples/RenderedBody.tsx +20 -0
  71. package/src/data-display/DescriptionListCard/DescriptionListCard.options.test.tsx +64 -0
  72. package/src/data-display/DescriptionListCard/DescriptionListCard.test.tsx +24 -1
  73. package/src/data-display/DescriptionListCard/DescriptionListCard.tsx +52 -37
  74. package/src/data-display/DescriptionListCard/block.meta.ts +2 -1
  75. package/src/data-display/DescriptionListCard/examples/Spanish.tsx +9 -1
  76. package/src/data-display/KpiRow/KpiRow.doc.ts +14 -0
  77. package/src/data-display/KpiRow/KpiRow.test.tsx +11 -0
  78. package/src/data-display/KpiRow/KpiRow.tsx +72 -55
  79. package/src/data-display/KpiRow/examples/ContainerPanel.tsx +47 -0
  80. package/src/data-display/ResourceCardGrid/ResourceCardGrid.doc.ts +19 -0
  81. package/src/data-display/ResourceCardGrid/ResourceCardGrid.test.tsx +13 -0
  82. package/src/data-display/ResourceCardGrid/ResourceCardGrid.tsx +49 -40
  83. package/src/data-display/ResourceCardGrid/examples/ContainerPanel.tsx +18 -0
  84. package/src/data-display/StatusTimeline/StatusTimeline.tsx +1 -1
  85. package/src/feedback/EmptyStates/EmptyStates.test.tsx +42 -0
  86. package/src/feedback/EmptyStates/EmptyStates.tsx +37 -17
  87. package/src/feedback/EmptyStates/NoAccessEmpty.options.test.tsx +38 -0
  88. package/src/feedback/EmptyStates/block.meta.ts +1 -1
  89. package/src/feedback/EmptyStates/examples/HiddenAction.tsx +13 -0
  90. package/src/feedback/EmptyStates/examples/Spanish.tsx +7 -0
  91. package/src/feedback/ErrorPanel/ErrorPanel.tsx +13 -15
  92. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.labels.test.tsx +115 -0
  93. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.lifecycle.test.tsx +123 -0
  94. package/src/forms/CreateApiKeyDialog/CreateApiKeyDialog.tsx +153 -122
  95. package/src/forms/CreateApiKeyDialog/block.meta.ts +34 -2
  96. package/src/forms/CreateApiKeyDialog/examples/Labels.tsx +29 -0
  97. package/src/forms/CredentialDisclosureDialog/CredentialDisclosureDialog.labels.test.tsx +165 -0
  98. package/src/forms/CredentialDisclosureDialog/CredentialDisclosureDialog.tsx +31 -8
  99. package/src/forms/CredentialDisclosureDialog/SecretCopy.tsx +16 -8
  100. package/src/forms/CredentialDisclosureDialog/block.meta.ts +19 -1
  101. package/src/forms/CredentialDisclosureDialog/examples/Labels.tsx +38 -0
  102. package/src/forms/DangerZone/ConfirmDestructiveDialog.tsx +17 -3
  103. package/src/forms/DangerZone/DangerZone.labels.test.tsx +87 -0
  104. package/src/forms/DangerZone/DangerZone.tsx +20 -5
  105. package/src/forms/DangerZone/block.meta.ts +10 -1
  106. package/src/forms/DangerZone/examples/Labels.tsx +29 -0
  107. package/src/forms/DateRangeFilter/DateRangeFilter.labels.test.tsx +52 -0
  108. package/src/forms/DateRangeFilter/DateRangeFilter.tsx +11 -3
  109. package/src/forms/DateRangeFilter/block.meta.ts +8 -1
  110. package/src/forms/DateRangeFilter/examples/Labels.tsx +28 -0
  111. package/src/forms/DialogWizard/DialogWizard.labels.test.tsx +37 -0
  112. package/src/forms/DialogWizard/DialogWizard.tsx +13 -2
  113. package/src/forms/DialogWizard/block.meta.ts +7 -1
  114. package/src/forms/DialogWizard/examples/Labels.tsx +39 -0
  115. package/src/forms/FileUploadPanel/FileUploadPanel.controlled.test.tsx +482 -0
  116. package/src/forms/FileUploadPanel/FileUploadPanel.drag.test.tsx +60 -0
  117. package/src/forms/FileUploadPanel/FileUploadPanel.labels.test.tsx +126 -0
  118. package/src/forms/FileUploadPanel/FileUploadPanel.lifecycle.test.tsx +165 -0
  119. package/src/forms/FileUploadPanel/FileUploadPanel.tsx +336 -75
  120. package/src/forms/FileUploadPanel/block.meta.ts +26 -1
  121. package/src/forms/FileUploadPanel/examples/AutoCancel.tsx +38 -0
  122. package/src/forms/FileUploadPanel/examples/Labels.tsx +29 -0
  123. package/src/forms/FileUploadPanel/examples/ManualForm.tsx +36 -0
  124. package/src/forms/FileUploadPanel/fixtures.ts +31 -16
  125. package/src/forms/FileUploadPanel/simulate-upload.test.ts +24 -0
  126. package/src/forms/FormSection/FormSection.labels.test.tsx +37 -0
  127. package/src/forms/FormSection/FormSection.test.tsx +11 -0
  128. package/src/forms/FormSection/FormSection.tsx +34 -25
  129. package/src/forms/FormSection/block.meta.ts +7 -1
  130. package/src/forms/FormSection/examples/ContainerPanel.tsx +16 -0
  131. package/src/forms/FormSection/examples/Labels.tsx +27 -0
  132. package/src/forms/InviteMembersDialog/InviteMembersDialog.labels.test.tsx +87 -0
  133. package/src/forms/InviteMembersDialog/InviteMembersDialog.lifecycle.test.tsx +80 -0
  134. package/src/forms/InviteMembersDialog/InviteMembersDialog.tsx +121 -105
  135. package/src/forms/InviteMembersDialog/block.meta.ts +21 -2
  136. package/src/forms/InviteMembersDialog/examples/Labels.tsx +28 -0
  137. package/src/forms/SettingsRow/SettingsRow.labels.test.tsx +33 -0
  138. package/src/forms/SettingsRow/SettingsRow.tsx +14 -3
  139. package/src/forms/SettingsRow/block.meta.ts +7 -1
  140. package/src/forms/SettingsRow/examples/Labels.tsx +27 -0
  141. package/src/forms/ValidationSummary/ValidationSummary.labels.test.tsx +47 -0
  142. package/src/forms/ValidationSummary/ValidationSummary.tsx +10 -7
  143. package/src/forms/ValidationSummary/block.meta.ts +6 -1
  144. package/src/forms/ValidationSummary/examples/Labels.tsx +24 -0
  145. package/src/forms/index.ts +5 -1
  146. package/src/forms/translated-content.tsx +12 -0
  147. package/src/hooks/index.ts +2 -0
  148. package/src/hooks/useTableData.integration.test.tsx +89 -0
  149. package/src/hooks/useTableData.test.tsx +613 -0
  150. package/src/hooks/useTableData.ts +377 -0
  151. package/src/index.ts +1 -0
  152. package/src/marketing/ComparisonTable/ComparisonTable.tsx +2 -2
  153. package/src/marketing/FeatureGrid/FeatureGrid.tsx +1 -1
  154. package/src/marketing/LogoCloud/LogoCloud.doc.ts +13 -0
  155. package/src/marketing/LogoCloud/LogoCloud.test.tsx +155 -0
  156. package/src/marketing/LogoCloud/LogoCloud.tsx +89 -0
  157. package/src/marketing/LogoCloud/block.meta.ts +10 -0
  158. package/src/marketing/LogoCloud/examples/CaptionStart.tsx +6 -0
  159. package/src/marketing/LogoCloud/examples/Custom.tsx +25 -0
  160. package/src/marketing/LogoCloud/examples/Empty.tsx +6 -0
  161. package/src/marketing/LogoCloud/examples/Grid.tsx +13 -0
  162. package/src/marketing/LogoCloud/examples/Row.tsx +6 -0
  163. package/src/marketing/LogoCloud/examples/UnderHero.tsx +13 -0
  164. package/src/marketing/LogoCloud/fixtures.ts +23 -0
  165. package/src/marketing/PricingTable/PricingTable.tsx +1 -1
  166. package/src/marketing/SiteFooter/SiteFooter.doc.ts +18 -0
  167. package/src/marketing/SiteFooter/SiteFooter.test.tsx +236 -0
  168. package/src/marketing/SiteFooter/SiteFooter.tsx +160 -0
  169. package/src/marketing/SiteFooter/block.meta.ts +10 -0
  170. package/src/marketing/SiteFooter/examples/Centered.tsx +15 -0
  171. package/src/marketing/SiteFooter/examples/Columns.tsx +15 -0
  172. package/src/marketing/SiteFooter/examples/Custom.tsx +35 -0
  173. package/src/marketing/SiteFooter/examples/Empty.tsx +6 -0
  174. package/src/marketing/SiteFooter/examples/Simple.tsx +14 -0
  175. package/src/marketing/SiteFooter/fixtures.ts +36 -0
  176. package/src/marketing/index.ts +6 -0
  177. package/src/page-chrome/PageHeader/EditableTitle.test.tsx +26 -0
  178. package/src/page-chrome/PageHeader/PageHeader.options.test.tsx +34 -0
  179. package/src/page-chrome/PageHeader/PageHeader.tsx +11 -5
  180. package/src/page-chrome/PageHeader/block.meta.ts +1 -1
  181. package/src/page-chrome/PageHeader/examples/ContainerPanel.tsx +16 -0
  182. package/src/page-chrome/PageHeader/examples/EditableTitle.tsx +23 -0
  183. package/src/page-chrome/PageHeader/examples/Spanish.tsx +11 -0
  184. package/src/page-chrome/StickyActionBar/StickyActionBar.tsx +1 -1
  185. package/src/scheduling/AgendaList/AgendaList.tsx +39 -15
  186. package/src/scheduling/AgendaList/AgendaListZone.test.tsx +38 -0
  187. package/src/scheduling/AgendaList/block.meta.ts +1 -1
  188. package/src/scheduling/AgendaList/examples/TimeZone.tsx +28 -0
  189. package/src/scheduling/MonthCalendar/MonthCalendar.tsx +51 -40
  190. package/src/scheduling/MonthCalendar/MonthCalendarZone.test.tsx +44 -0
  191. package/src/scheduling/MonthCalendar/block.meta.ts +1 -1
  192. package/src/scheduling/MonthCalendar/examples/TimeZone.tsx +28 -0
  193. package/src/scheduling/WeekCalendar/WeekCalendar.tsx +37 -28
  194. package/src/scheduling/WeekCalendar/WeekCalendarZone.test.tsx +41 -0
  195. package/src/scheduling/WeekCalendar/block.meta.ts +1 -1
  196. package/src/scheduling/WeekCalendar/examples/TimeZone.tsx +28 -0
  197. package/src/scheduling/shared/CalendarHeader.tsx +26 -1
  198. package/src/scheduling/shared/dates.ts +102 -58
  199. package/src/scheduling/shared/events.ts +2 -2
  200. package/src/shell/AppSidebar/AppSidebar.context.test.tsx +175 -0
  201. package/src/shell/AppSidebar/AppSidebar.doc.ts +29 -0
  202. package/src/shell/AppSidebar/AppSidebar.tsx +97 -25
  203. package/src/shell/AppSidebar/block.meta.ts +1 -1
  204. package/src/shell/GlobalSearch/GlobalSearch.test.tsx +1 -0
  205. package/src/shell/GlobalSearch/GlobalSearch.tsx +1 -1
  206. package/src/tables/DataTable/DataTable.cross-page-selection.test.tsx +322 -0
  207. package/src/tables/DataTable/DataTable.cursor-example.test.tsx +67 -0
  208. package/src/tables/DataTable/DataTable.export.test.tsx +511 -0
  209. package/src/tables/DataTable/DataTable.inline-edit-focus.test.tsx +32 -0
  210. package/src/tables/DataTable/DataTable.labels.test.tsx +74 -0
  211. package/src/tables/DataTable/DataTable.layout.test.tsx +6 -5
  212. package/src/tables/DataTable/DataTable.link-actions.test.tsx +18 -0
  213. package/src/tables/DataTable/DataTable.server-pagination.test.tsx +329 -15
  214. package/src/tables/DataTable/DataTable.single-select.test.tsx +47 -7
  215. package/src/tables/DataTable/DataTable.test.tsx +140 -1
  216. package/src/tables/DataTable/DataTable.tsx +241 -80
  217. package/src/tables/DataTable/block.meta.ts +31 -3
  218. package/src/tables/DataTable/column-sizing.ts +2 -2
  219. package/src/tables/DataTable/data-table-props.ts +43 -6
  220. package/src/tables/DataTable/data-table-row.tsx +9 -5
  221. package/src/tables/DataTable/data-table-utils.ts +6 -0
  222. package/src/tables/DataTable/editable-cell.tsx +20 -79
  223. package/src/tables/DataTable/examples/client-selection.tsx +33 -0
  224. package/src/tables/DataTable/examples/csv-export.tsx +74 -0
  225. package/src/tables/DataTable/examples/cursor-load-more.tsx +87 -0
  226. package/src/tables/DataTable/examples/paginated-single-selection.tsx +46 -0
  227. package/src/tables/DataTable/examples/server-pagination.tsx +91 -44
  228. package/src/tables/DataTable/export-menu.tsx +58 -0
  229. package/src/tables/DataTable/header-cell.tsx +1 -1
  230. package/src/tables/DataTable/labels.ts +11 -0
  231. package/src/tables/DataTable/resize-handle.tsx +2 -2
  232. package/src/tables/DataTable/selection-strip.tsx +31 -0
  233. package/src/tables/DataTable/single-selection.tsx +0 -7
  234. package/src/tables/DataTable/use-multiple-selection.ts +86 -0
  235. package/src/tables/DataTable/use-table-export.ts +117 -0
  236. package/src/tables/FilterBar/FilterBar.test.tsx +12 -0
  237. package/src/tables/FilterBar/FilterBar.tsx +5 -7
  238. package/src/team/ProfileHeader/ProfileHeader.picker.test.tsx +34 -0
  239. package/src/team/ProfileHeader/ProfileHeader.test.tsx +2 -2
  240. package/src/team/ProfileHeader/ProfileHeader.tsx +17 -24
  241. package/src/team/ProfileHeader/block.meta.ts +1 -1
  242. package/src/test/OptInDefaults.test.tsx +36 -0
  243. package/src/test/clipboard-fallback.test.tsx +49 -0
  244. package/src/test/copy-examples.test.tsx +29 -0
  245. package/src/test/copy-feedback.test.tsx +166 -0
  246. package/src/test/fixtures/opt-in-defaults.json +10 -0
  247. package/src/test/without-forced-colors.test.ts +44 -0
  248. package/src/test/without-forced-colors.ts +14 -0
@@ -0,0 +1,42 @@
1
+ import { useCallback, useMemo, useState } from 'react';
2
+ import { computeOffsets, useVirtualWindow } from '@gntik-ai/ui';
3
+ import type { LogLine } from './fixtures';
4
+
5
+ /** Measurements belong to line IDs, independent of the current filtered indices. */
6
+ export function useWrappedLogRows(
7
+ enabled: boolean,
8
+ lines: LogLine[],
9
+ rowHeight: number,
10
+ height: number,
11
+ overscan: number,
12
+ scrollTop: number,
13
+ follow: boolean,
14
+ ) {
15
+ const [sizes, setSizes] = useState<ReadonlyMap<string, number>>(new Map());
16
+ const count = enabled ? lines.length : 0;
17
+ const sizeOf = useCallback(
18
+ (index: number) => sizes.get(lines[index]?.id ?? '') ?? rowHeight,
19
+ [lines, sizes, rowHeight],
20
+ );
21
+ const offsets = useMemo(() => computeOffsets(count, sizeOf), [count, sizeOf]);
22
+ const total = offsets[count] ?? 0;
23
+ const maxScroll = Math.max(0, total - height);
24
+ const win = useVirtualWindow(count, sizeOf, follow ? maxScroll : Math.min(scrollTop, maxScroll), height, overscan);
25
+
26
+ const measureRow = useCallback((node: HTMLDivElement | null, id: string) => {
27
+ if (!node) return;
28
+ const measure = () => {
29
+ const measured = node.getBoundingClientRect().height;
30
+ if (measured > 0)
31
+ setSizes((previous) => (previous.get(id) === measured ? previous : new Map(previous).set(id, measured)));
32
+ };
33
+ measure();
34
+ if (typeof ResizeObserver === 'undefined') return;
35
+ // React 19 ref cleanup disconnects on removal, ref replacement and unmount.
36
+ const observer = new ResizeObserver(measure);
37
+ observer.observe(node);
38
+ return () => observer.disconnect();
39
+ }, []);
40
+
41
+ return { ...win, end: win.end + 1, measureRow };
42
+ }
@@ -79,7 +79,7 @@ export function ActivityFeed({
79
79
  <div key={group.key}>
80
80
  <GroupTag
81
81
  id={headingId}
82
- className="mb-3 font-mono text-[10.5px] font-medium tracking-[0.12em] text-muted-foreground uppercase"
82
+ className="mb-3 font-mono text-[10.5px] font-medium tracking-[0.12em] text-muted-foreground label-case"
83
83
  >
84
84
  {group.label}
85
85
  </GroupTag>
@@ -160,7 +160,7 @@ export function ChartCard<T extends object = CostPoint>({
160
160
  const { locale } = useI18n();
161
161
  return (
162
162
  <ChartLocaleProvider locale={locale}>
163
- <Card className={className}>
163
+ <Card className={cn('@container w-full min-w-0', className)}>
164
164
  <CardHeader className="pb-2">
165
165
  <CardTitle as={titleAs}>{title}</CardTitle>
166
166
  {description && <CardDescription>{description}</CardDescription>}
@@ -202,7 +202,7 @@ export function ChartCard<T extends object = CostPoint>({
202
202
  {active.summary.delta && <TrendDelta {...active.summary.delta} />}
203
203
  </p>
204
204
  )}
205
- <div className={cn('px-3 pb-4 pt-3 sm:px-4', !footer && 'pb-5')}>
205
+ <div className={cn('px-3 pb-4 pt-3 @sm:px-4', !footer && 'pb-5')}>
206
206
  {kind === 'heatmap' ? (
207
207
  <Heatmap
208
208
  data={data}
@@ -0,0 +1,16 @@
1
+ import { InspectorLayout } from '@gntik-ai/ui';
2
+ import { ChartCard } from '../ChartCard';
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={<ChartCard />}>
8
+ <div className="grid gap-6 overflow-auto p-4">
9
+ <div data-container-slot="default" className="flex min-w-0">
10
+ <ChartCard />
11
+ </div>
12
+ </div>
13
+ </InspectorLayout>
14
+ </div>
15
+ );
16
+ }
@@ -1,7 +1,15 @@
1
1
  import { render, screen } from '@testing-library/react';
2
2
  import userEvent from '@testing-library/user-event';
3
+ import { I18nProvider } from '@gntik-ai/ui';
3
4
  import { expectNoAxeViolations } from '../../test/a11y';
4
- import { CommentThread } from './CommentThread';
5
+ import { CommentThread, type ThreadComment } from './CommentThread';
6
+
7
+ const comment: ThreadComment = {
8
+ id: 'review',
9
+ author: { name: 'Reviewer' },
10
+ body: '**retry**\n<img src=x onerror=alert(1)>',
11
+ at: '2026-10-01T12:00:00Z',
12
+ };
5
13
 
6
14
  describe('CommentThread', () => {
7
15
  it('renders the comments and an empty composer', async () => {
@@ -26,4 +34,65 @@ describe('CommentThread', () => {
26
34
  expect(onSubmit).toHaveBeenLastCalledWith('Follow-up');
27
35
  expect(screen.getByRole('list', { name: '5 comments' })).toBeInTheDocument();
28
36
  });
37
+
38
+ it('keeps plain bodies as text in a paragraph with line breaks', () => {
39
+ const { container } = render(<CommentThread comments={[comment]} />);
40
+ const body = screen.getByText(/\*\*retry\*\*/);
41
+ expect(body.tagName).toBe('P');
42
+ expect(body).toHaveClass('whitespace-pre-line');
43
+ expect(body.textContent).toBe('**retry**\n<img src=x onerror=alert(1)>');
44
+ expect(container.querySelector('img')).toBeNull();
45
+ });
46
+
47
+ it('renders full supplied and appended comments through a block container', async () => {
48
+ const user = userEvent.setup();
49
+ const currentUser = { name: 'Writer' };
50
+ const renderBody = vi.fn((c: ThreadComment) => <blockquote>{c.body}</blockquote>);
51
+ render(<CommentThread comments={[comment]} currentUser={currentUser} renderBody={renderBody} />);
52
+ expect(renderBody).toHaveBeenCalledExactlyOnceWith(comment);
53
+ const body = screen.getByText(/\*\*retry\*\*/);
54
+ expect(body.parentElement?.tagName).toBe('DIV');
55
+ expect(body.closest('p')).toBeNull();
56
+ await user.type(screen.getByRole('textbox'), 'See **docs**');
57
+ renderBody.mockClear();
58
+ await user.keyboard('{Control>}{Enter}{/Control}');
59
+ expect(renderBody).toHaveBeenCalledTimes(2);
60
+ expect(renderBody).toHaveBeenCalledWith(comment);
61
+ expect(renderBody).toHaveBeenCalledWith({
62
+ id: 'local-1',
63
+ author: currentUser,
64
+ body: 'See **docs**',
65
+ at: expect.any(Number),
66
+ });
67
+ const posted = screen.getByText('See **docs**');
68
+ expect(posted.parentElement?.tagName).toBe('DIV');
69
+ expect(posted.closest('p')).toBeNull();
70
+ });
71
+
72
+ it.each([
73
+ ['en', false, 'Plain text · ⌘/Ctrl + Enter to post'],
74
+ ['en', true, 'Markdown supported · ⌘/Ctrl + Enter to post'],
75
+ ['es', false, 'Texto sin formato · ⌘/Ctrl + Intro para publicar'],
76
+ ['es', true, 'Admite Markdown · ⌘/Ctrl + Intro para publicar'],
77
+ ])('describes the composer in %s with renderBody=%s', (locale, rich, hint) => {
78
+ render(
79
+ <I18nProvider locale={locale}>
80
+ <CommentThread renderBody={rich ? (c) => <blockquote>{c.body}</blockquote> : undefined} />
81
+ </I18nProvider>,
82
+ );
83
+ expect(screen.getByText(hint)).toBeInTheDocument();
84
+ expect(screen.getByRole('textbox')).toHaveAccessibleDescription(hint);
85
+ });
86
+
87
+ it.each([false, true])('uses the custom hint with renderBody=%s', (rich) => {
88
+ render(
89
+ <CommentThread
90
+ renderBody={rich ? (c) => <blockquote>{c.body}</blockquote> : undefined}
91
+ composerHint={<em>Notes are visible to the workspace</em>}
92
+ />,
93
+ );
94
+ expect(screen.getByText('Notes are visible to the workspace').tagName).toBe('EM');
95
+ expect(screen.getByRole('textbox')).toHaveAccessibleDescription('Notes are visible to the workspace');
96
+ expect(screen.queryByText(/⌘\/Ctrl/)).not.toBeInTheDocument();
97
+ });
29
98
  });
@@ -1,5 +1,5 @@
1
1
  import { Avatar, Button, cn, Textarea, Timestamp, type DateInput, useI18n } from '@gntik-ai/ui';
2
- import { useId, useState, type FormEvent, type KeyboardEvent } from 'react';
2
+ import { useId, useState, type FormEvent, type KeyboardEvent, type ReactNode } from 'react';
3
3
  import { COMMENT_AUTHOR, REVIEW_COMMENTS } from './fixtures';
4
4
 
5
5
  export interface CommentAuthor {
@@ -10,13 +10,19 @@ export interface CommentAuthor {
10
10
  export interface ThreadComment {
11
11
  id: string;
12
12
  author: CommentAuthor;
13
- /** Plain text (no markdown); line breaks are kept. */
13
+ /** Plain text by default, with line breaks kept; pass renderBody to render Markdown. */
14
14
  body: string;
15
15
  at: DateInput;
16
16
  }
17
17
 
18
18
  export interface CommentThreadProps {
19
19
  comments?: readonly ThreadComment[];
20
+ /**
21
+ * Render the raw comment in a block container. Bodies are untrusted: use a safe
22
+ * renderer such as Markdown from @gntik-ai/chat (without allowHtml), never raw HTML.
23
+ * Defaults to plain text with line breaks kept.
24
+ */
25
+ renderBody?: (comment: ThreadComment) => ReactNode;
20
26
  /** Author of new comments (the signed-in user). */
21
27
  currentUser?: CommentAuthor;
22
28
  /** Called with the trimmed text when a comment is posted. */
@@ -27,18 +33,22 @@ export interface CommentThreadProps {
27
33
  label?: string;
28
34
  placeholder?: string;
29
35
  submitLabel?: string;
36
+ /** Overrides the plain-text or Markdown hint; stays the composer's accessible description. */
37
+ composerHint?: ReactNode;
30
38
  className?: string;
31
39
  }
32
40
 
33
- /** Comment thread: avatar, author, plain-text body and Timestamp, with a reply composer (⌘/Ctrl+Enter posts). */
41
+ /** Comment thread: avatar, author, plain text (or Markdown via renderBody) and Timestamp, with a reply composer (⌘/Ctrl+Enter posts). */
34
42
  export function CommentThread({
35
43
  comments = REVIEW_COMMENTS,
44
+ renderBody,
36
45
  currentUser = COMMENT_AUTHOR,
37
46
  onSubmit,
38
47
  appendOnSubmit = true,
39
48
  label: labelProp,
40
49
  placeholder: placeholderProp,
41
50
  submitLabel: submitLabelProp,
51
+ composerHint,
42
52
  className,
43
53
  }: CommentThreadProps) {
44
54
  const { t } = useI18n();
@@ -80,13 +90,19 @@ export function CommentThread({
80
90
  {i < all.length - 1 && (
81
91
  <span aria-hidden className="absolute top-9 -bottom-5 start-[15.5px] w-px bg-border" />
82
92
  )}
83
- <Avatar name={comment.author.name} src={comment.author.src} size="sm" className="relative z-10" />
93
+ <Avatar name={comment.author.name} src={comment.author.src} size="sm" className="relative z-raised" />
84
94
  <article className="min-w-0 flex-1 rounded-lg border border-border bg-background/50 p-3">
85
95
  <header className="flex flex-wrap items-baseline justify-between gap-x-3 gap-y-0.5">
86
96
  <span className="text-[12.5px] font-semibold text-foreground">{comment.author.name}</span>
87
97
  <Timestamp value={comment.at} className="font-mono text-[11px]" />
88
98
  </header>
89
- <p className="mt-1 text-[13px] leading-relaxed whitespace-pre-line text-foreground/85">{comment.body}</p>
99
+ {renderBody ? (
100
+ <div className="mt-1 text-[13px] leading-relaxed text-foreground/85">{renderBody(comment)}</div>
101
+ ) : (
102
+ <p className="mt-1 text-[13px] leading-relaxed whitespace-pre-line text-foreground/85">
103
+ {comment.body}
104
+ </p>
105
+ )}
90
106
  </article>
91
107
  </li>
92
108
  ))}
@@ -107,7 +123,7 @@ export function CommentThread({
107
123
  />
108
124
  <div className="flex items-center justify-between gap-2 border-t border-border/60 px-3 py-2">
109
125
  <span id={hintId} className="text-[11.5px] text-muted-foreground">
110
- Plain text · ⌘/Ctrl + Enter to post
126
+ {composerHint ?? t(renderBody ? 'comments.hintMarkdown' : 'comments.hintPlain')}
111
127
  </span>
112
128
  <Button type="submit" size="sm" disabled={!text}>
113
129
  {submitLabel}
@@ -5,6 +5,6 @@ export const meta: BlockMeta = {
5
5
  family: 'data-display',
6
6
  status: 'beta',
7
7
  description:
8
- 'Plain-text comments with avatar, author and Timestamp, plus a reply composer (Textarea + Button, ⌘/Ctrl+Enter posts).',
8
+ 'Plain-text comments by default, with optional renderBody for safe Markdown, avatar, author and Timestamp, plus a reply composer (Textarea + Button, ⌘/Ctrl+Enter posts). renderBody receives the raw comment; use a safe renderer such as @gntik-ai/chat Markdown (without allowHtml). Bodies are untrusted: never inject raw HTML. composerHint overrides the catalog hint and remains the textarea’s accessible description.',
9
9
  uses: ['Avatar', 'Timestamp', 'Textarea', 'Button'],
10
10
  };
@@ -0,0 +1,20 @@
1
+ import { useI18n } from '@gntik-ai/ui';
2
+ import { CommentThread } from '../CommentThread';
3
+
4
+ /**
5
+ * /preview.html?kind=block&id=comment-thread--rendered-body
6
+ * A text-only stub demonstrates renderBody and a ReactNode composerHint override.
7
+ * For safe Markdown, see the scorecard template's @gntik-ai/chat Markdown renderer
8
+ * (without allowHtml). Treat bodies as untrusted; never inject raw HTML.
9
+ */
10
+ export default function RenderedBody() {
11
+ const { t } = useI18n();
12
+ return (
13
+ <CommentThread
14
+ renderBody={(comment) => (
15
+ <blockquote className="border-s-2 border-border ps-3 whitespace-pre-line">{comment.body}</blockquote>
16
+ )}
17
+ composerHint={<span>{t('comments.hintPlain')}</span>}
18
+ />
19
+ );
20
+ }
@@ -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
+ });
@@ -1,9 +1,32 @@
1
- import { render, screen } from '@testing-library/react';
1
+ import { fireEvent, render, screen } from '@testing-library/react';
2
2
  import userEvent from '@testing-library/user-event';
3
3
  import { expectNoAxeViolations } from '../../test/a11y';
4
4
  import { DescriptionListCard } from './DescriptionListCard';
5
5
 
6
6
  describe('DescriptionListCard', () => {
7
+ it.each(['rejected', 'missing'] as const)(
8
+ 'reports a %s clipboard write as failed without calling onCopy',
9
+ async (failure) => {
10
+ userEvent.setup();
11
+ const clipboard = navigator.clipboard;
12
+ if (failure === 'missing')
13
+ Object.defineProperty(navigator, 'clipboard', { configurable: true, value: undefined });
14
+ else vi.spyOn(navigator.clipboard, 'writeText').mockRejectedValue(new DOMException('Denied', 'NotAllowedError'));
15
+ const onCopy = vi.fn();
16
+ try {
17
+ const { container } = render(<DescriptionListCard onCopy={onCopy} />);
18
+ fireEvent.click(screen.getByRole('button', { name: 'Copy Deployment ID' }));
19
+ const button = await screen.findByRole('button', { name: 'Copy failed' });
20
+ expect(container.querySelector('[aria-live="polite"]')).toHaveTextContent('Copy failed');
21
+ expect(screen.queryByRole('button', { name: 'Deployment ID copied' })).toBeNull();
22
+ expect(button.querySelector('.lucide-check')).toBeNull();
23
+ expect(onCopy).not.toHaveBeenCalled();
24
+ } finally {
25
+ Object.defineProperty(navigator, 'clipboard', { configurable: true, value: clipboard });
26
+ vi.restoreAllMocks();
27
+ }
28
+ },
29
+ );
7
30
  it('renders labels and values', async () => {
8
31
  const { container } = render(<DescriptionListCard onEdit={() => {}} />);
9
32
  expect(screen.getByText('Deployment ID')).toBeInTheDocument();
@@ -1,4 +1,4 @@
1
- import { Check, Copy, Pencil } from '@gntik-ai/icons';
1
+ import { Check, Copy, Pencil, X } from '@gntik-ai/icons';
2
2
  import {
3
3
  Button,
4
4
  Card,
@@ -10,8 +10,9 @@ import {
10
10
  IconButton,
11
11
  StatusTag,
12
12
  useI18n,
13
+ useClipboard,
13
14
  } from '@gntik-ai/ui';
14
- import { useEffect, useRef, useState, type ReactNode } from 'react';
15
+ import { type ReactNode } from 'react';
15
16
  import { DEPLOYMENT_DETAILS } from './fixtures';
16
17
 
17
18
  export interface DescriptionItem {
@@ -37,6 +38,7 @@ export interface DescriptionListCardLabels {
37
38
  copy: (label: string) => string;
38
39
  copied: (label: string) => string;
39
40
  copiedToClipboard: string;
41
+ copyFailed?: string;
40
42
  }
41
43
 
42
44
  export interface DescriptionListCardProps {
@@ -45,6 +47,10 @@ export interface DescriptionListCardProps {
45
47
  title?: string;
46
48
  description?: string;
47
49
  items?: readonly DescriptionItem[];
50
+ /** Wrap values, including long unbroken strings, instead of truncating (default false). */
51
+ wrap?: boolean;
52
+ /** Responsive columns; items fill top to bottom in contiguous groups (default 1). */
53
+ columns?: 1 | 2 | 3;
48
54
  /** Shows an Edit button in the header. */
49
55
  onEdit?: () => void;
50
56
  editLabel?: string;
@@ -65,27 +71,19 @@ function CopyButton({
65
71
  labels?: Partial<DescriptionListCardLabels>;
66
72
  }) {
67
73
  const { t } = useI18n();
68
- const [copied, setCopied] = useState(false);
69
- const timer = useRef<number | undefined>(undefined);
70
- useEffect(() => () => window.clearTimeout(timer.current), []);
71
- const copy = async () => {
72
- const text = item.copyValue ?? item.value ?? '';
73
- try {
74
- await navigator.clipboard?.writeText(text);
75
- } catch {}
76
- setCopied(true);
77
- onCopy?.(item);
78
- window.clearTimeout(timer.current);
79
- timer.current = window.setTimeout(() => setCopied(false), 1500);
80
- };
74
+ const { status, copied, copy: copyText } = useClipboard({ timeout: 1500, onCopy: () => onCopy?.(item) });
75
+ const failedText = labels?.copyFailed ?? t('common.copyFailed');
76
+ const copy = () => copyText(item.copyValue ?? item.value ?? '');
81
77
  return (
82
78
  <>
83
79
  <IconButton
84
- icon={copied ? Check : Copy}
80
+ icon={status === 'failed' ? X : copied ? Check : Copy}
85
81
  label={
86
- copied
87
- ? (labels?.copied?.(item.label) ?? t('descriptionList.copied', { label: item.label }))
88
- : (labels?.copy?.(item.label) ?? t('descriptionList.copy', { label: item.label }))
82
+ status === 'failed'
83
+ ? failedText
84
+ : copied
85
+ ? (labels?.copied?.(item.label) ?? t('descriptionList.copied', { label: item.label }))
86
+ : (labels?.copy?.(item.label) ?? t('descriptionList.copy', { label: item.label }))
89
87
  }
90
88
  size="sm"
91
89
  variant="ghost"
@@ -93,7 +91,7 @@ function CopyButton({
93
91
  onClick={copy}
94
92
  />
95
93
  <span className="sr-only" aria-live="polite">
96
- {copied ? (labels?.copiedToClipboard ?? t('common.copiedToClipboard')) : ''}
94
+ {status === 'failed' ? failedText : copied ? (labels?.copiedToClipboard ?? t('common.copiedToClipboard')) : ''}
97
95
  </span>
98
96
  </>
99
97
  );
@@ -105,6 +103,8 @@ export function DescriptionListCard({
105
103
  labels,
106
104
  description: descriptionProp,
107
105
  items = DEPLOYMENT_DETAILS,
106
+ wrap = false,
107
+ columns = 1,
108
108
  onEdit,
109
109
  editLabel: editLabelProp,
110
110
  onCopy,
@@ -115,6 +115,27 @@ export function DescriptionListCard({
115
115
  const title = titleProp ?? labels?.title ?? t('descriptionList.title');
116
116
  const description = descriptionProp ?? labels?.description ?? t('descriptionList.description');
117
117
  const editLabel = editLabelProp ?? labels?.edit ?? t('descriptionList.edit');
118
+ const renderItem = (item: DescriptionItem) => (
119
+ <div
120
+ key={item.id}
121
+ className={cn('grid grid-cols-1 gap-1 py-3.5', columns === 1 && 'sm:grid-cols-[160px_minmax(0,1fr)] sm:gap-4')}
122
+ >
123
+ <dt className="text-[13px] text-muted-foreground">{item.label}</dt>
124
+ <dd className="flex min-w-0 items-center gap-2 text-[13px] text-foreground">
125
+ {item.status ? (
126
+ <StatusTag status={item.status} />
127
+ ) : (
128
+ <span
129
+ className={cn(wrap ? 'min-w-0 wrap-anywhere' : 'min-w-0 truncate', item.mono && 'font-mono text-[12.5px]')}
130
+ >
131
+ {item.render ?? item.value}
132
+ </span>
133
+ )}
134
+ {item.copyable && <CopyButton item={item} onCopy={onCopy} labels={labels} />}
135
+ </dd>
136
+ </div>
137
+ );
138
+ const chunkSize = Math.ceil(items.length / columns);
118
139
  return (
119
140
  <Card className={className}>
120
141
  <CardHeader divided>
@@ -128,23 +149,17 @@ export function DescriptionListCard({
128
149
  </CardAction>
129
150
  )}
130
151
  </CardHeader>
131
- <dl className="divide-y divide-border px-5">
132
- {items.map((item) => (
133
- <div key={item.id} className="grid grid-cols-1 gap-1 py-3.5 sm:grid-cols-[160px_minmax(0,1fr)] sm:gap-4">
134
- <dt className="text-[13px] text-muted-foreground">{item.label}</dt>
135
- <dd className="flex min-w-0 items-center gap-2 text-[13px] text-foreground">
136
- {item.status ? (
137
- <StatusTag status={item.status} />
138
- ) : (
139
- <span className={cn('min-w-0 truncate', item.mono && 'font-mono text-[12.5px]')}>
140
- {item.render ?? item.value}
141
- </span>
142
- )}
143
- {item.copyable && <CopyButton item={item} onCopy={onCopy} labels={labels} />}
144
- </dd>
145
- </div>
146
- ))}
147
- </dl>
152
+ {columns === 1 ? (
153
+ <dl className="divide-y divide-border px-5">{items.map(renderItem)}</dl>
154
+ ) : (
155
+ <div className={cn('grid grid-cols-1 gap-x-6 px-5', columns === 2 ? 'sm:grid-cols-2' : 'sm:grid-cols-3')}>
156
+ {Array.from({ length: columns }, (_, column) => (
157
+ <dl key={column} className="min-w-0 divide-y divide-border">
158
+ {items.slice(column * chunkSize, (column + 1) * chunkSize).map(renderItem)}
159
+ </dl>
160
+ ))}
161
+ </div>
162
+ )}
148
163
  </Card>
149
164
  );
150
165
  }
@@ -6,13 +6,14 @@ export const meta: BlockMeta = {
6
6
  family: 'data-display',
7
7
  status: 'beta',
8
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.',
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. Copy actions await the clipboard write; denied or unavailable access shows common.copyFailed (overridden by labels.copyFailed), and only a successful write calls onCopy. Both results reset after 1500ms. See the Catalog labels live preview.',
10
10
  labels: [
11
11
  { key: 'title', type: 'string', state: 'Card heading; title prop wins' },
12
12
  { key: 'description', type: 'string', state: 'Card description; description prop wins' },
13
13
  { key: 'edit', type: 'string', state: 'Edit button; editLabel prop wins' },
14
14
  { key: 'copy', type: '(label: string) => string', state: 'Copy button name; original item label' },
15
15
  { key: 'copied', type: '(label: string) => string', state: 'Copy button name after copying; original item label' },
16
+ { key: 'copyFailed', type: 'string', state: 'Copy button name and polite announcement after a failed write' },
16
17
  { key: 'copiedToClipboard', type: 'string', state: 'Polite copy announcement' },
17
18
  ] satisfies Array<{ key: keyof DescriptionListCardLabels; type: string; state: string }>,
18
19
  uses: ['Card', 'Button', 'IconButton', 'StatusTag'],
@@ -1,4 +1,4 @@
1
- import { I18nProvider, Stack } from '@gntik-ai/ui';
1
+ import { I18nProvider, Stack, en } from '@gntik-ai/ui';
2
2
  import { DescriptionListCard } from '../DescriptionListCard';
3
3
  export default function Spanish() {
4
4
  return (
@@ -8,6 +8,7 @@ export default function Spanish() {
8
8
  <DescriptionListCard
9
9
  onEdit={() => {}}
10
10
  labels={{
11
+ copyFailed: en['common.copyFailed'],
11
12
  title: 'Resource details',
12
13
  description: 'Current settings',
13
14
  edit: 'Change',
@@ -16,6 +17,13 @@ export default function Spanish() {
16
17
  copiedToClipboard: 'Field copied to clipboard',
17
18
  }}
18
19
  />
20
+ <DescriptionListCard
21
+ title="Full identifiers"
22
+ wrap
23
+ items={[{ id: 'id', label: 'Correlation ID', value: 'a'.repeat(120), mono: true, copyable: true }]}
24
+ />
25
+ <DescriptionListCard title="Two columns" columns={2} />
26
+ <DescriptionListCard title="Three columns" columns={3} />
19
27
  </Stack>
20
28
  </I18nProvider>
21
29
  );
@@ -0,0 +1,14 @@
1
+ import type { ComponentDoc } from '@gntik-ai/ui';
2
+ import { meta } from './block.meta';
3
+
4
+ export const doc: ComponentDoc = {
5
+ name: 'KpiRow',
6
+ group: 'Display',
7
+ status: 'beta',
8
+ description: meta.description,
9
+ primitive: 'Named description list with optional sparklines',
10
+ pattern:
11
+ 'Metrics reflow by container width. className styles the list; containerClassName styles its wrapper for placement and visibility.',
12
+ keyboard: [],
13
+ tokens: ['card', 'border', 'foreground', 'muted-foreground'],
14
+ };
@@ -3,6 +3,17 @@ import { expectNoAxeViolations } from '../../test/a11y';
3
3
  import { KpiRow } from './KpiRow';
4
4
 
5
5
  describe('KpiRow', () => {
6
+ it('keeps the named description list and list styling inside a separately styled wrapper', () => {
7
+ const { container } = render(<KpiRow label="Usage" className="gap-6" containerClassName="col-span-2" />);
8
+ const list = screen.getByLabelText('Usage');
9
+ expect(list.tagName).toBe('DL');
10
+ expect(list).toHaveClass('gap-6');
11
+ expect(list).not.toHaveClass('col-span-2');
12
+ expect(list.parentElement).toBe(container.firstElementChild);
13
+ expect(list.parentElement).toHaveClass('col-span-2');
14
+ expect(list.parentElement).not.toHaveClass('gap-6');
15
+ });
16
+
6
17
  it('renders the default KPIs as a description list with sparklines', async () => {
7
18
  const { container } = render(<KpiRow />);
8
19
  expect(screen.getByText('Active projects')).toBeInTheDocument();