@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,36 @@
1
+ import { Mail, Rss } from 'lucide-react';
2
+ import type { SiteFooterColumn, SiteFooterLink, SiteFooterSocialLink } from './SiteFooter';
3
+
4
+ export const sampleFooterColumns: SiteFooterColumn[] = [
5
+ {
6
+ title: 'Product',
7
+ links: [
8
+ { label: 'Overview', href: '/product' },
9
+ { label: 'Pricing', href: '/pricing' },
10
+ ],
11
+ },
12
+ {
13
+ title: 'Company',
14
+ links: [
15
+ { label: 'About', href: '/about' },
16
+ { label: 'Contact', href: '/contact' },
17
+ ],
18
+ },
19
+ {
20
+ title: 'Resources',
21
+ links: [
22
+ { label: 'Documentation', href: '/docs' },
23
+ { label: 'Status', href: '/status' },
24
+ ],
25
+ },
26
+ ];
27
+
28
+ export const sampleLegalLinks: SiteFooterLink[] = [
29
+ { label: 'Privacy', href: '/privacy' },
30
+ { label: 'Terms', href: '/terms' },
31
+ ];
32
+
33
+ export const sampleSocialLinks: SiteFooterSocialLink[] = [
34
+ { label: 'Email', href: 'mailto:hello@example.com', icon: Mail },
35
+ { label: 'RSS feed', href: '/feed.xml', icon: Rss },
36
+ ];
@@ -13,3 +13,9 @@ export type { MarketingAction } from './actions';
13
13
  export * from './ComparisonTable/ComparisonTable';
14
14
  export { meta as comparisonTableMeta } from './ComparisonTable/block.meta';
15
15
  export { sampleComparisonPlans, sampleComparisonSections } from './ComparisonTable/fixtures';
16
+ export * from './SiteFooter/SiteFooter';
17
+ export { meta as siteFooterMeta } from './SiteFooter/block.meta';
18
+ export { sampleFooterColumns, sampleLegalLinks, sampleSocialLinks } from './SiteFooter/fixtures';
19
+ export * from './LogoCloud/LogoCloud';
20
+ export { meta as logoCloudMeta } from './LogoCloud/block.meta';
21
+ export { sampleLogos } from './LogoCloud/fixtures';
@@ -0,0 +1,26 @@
1
+ import { render, screen } from '@testing-library/react';
2
+ import userEvent from '@testing-library/user-event';
3
+ import { expectNoAxeViolations } from '../../test/a11y';
4
+ import EditableTitle from './examples/EditableTitle';
5
+
6
+ it.each(['dark', 'light', 'high_contrast'])(
7
+ 'the editable PageHeader title keeps its name and is axe clean in %s',
8
+ async (theme) => {
9
+ const user = userEvent.setup();
10
+ const { container } = render(
11
+ <div data-theme={theme}>
12
+ <EditableTitle />
13
+ </div>,
14
+ );
15
+ expect(screen.getByRole('heading', { level: 1, name: 'Support agent' })).toBeInTheDocument();
16
+ await expectNoAxeViolations(container);
17
+ await user.click(screen.getByRole('button', { name: 'Support agent' }));
18
+ const input = screen.getByRole('textbox', { name: 'Agent name' });
19
+ expect(input).toHaveFocus();
20
+ await expectNoAxeViolations(container);
21
+ await user.clear(input);
22
+ await user.type(input, 'Billing agent{Enter}');
23
+ expect(screen.getByRole('heading', { level: 1, name: 'Billing agent' })).toBeInTheDocument();
24
+ expect(screen.getByRole('button', { name: 'Billing agent' })).toHaveFocus();
25
+ },
26
+ );
@@ -0,0 +1,34 @@
1
+ import { render, screen } from '@testing-library/react';
2
+ import userEvent from '@testing-library/user-event';
3
+ import { createRef } from 'react';
4
+ import { expectNoAxeViolations } from '../../test/a11y';
5
+ import { PageHeader } from './PageHeader';
6
+
7
+ it('wraps long titles while preserving titleRef focus and the default class string', async () => {
8
+ const title = 'x'.repeat(120);
9
+ const titleRef = createRef<HTMLHeadingElement>();
10
+ const props = { title, titleRef, breadcrumbs: null, tabs: null, meta: [], actions: [] };
11
+ const { container, rerender } = render(
12
+ <>
13
+ <PageHeader {...props} wrapTitle />
14
+ <button>Continue</button>
15
+ </>,
16
+ );
17
+ const heading = screen.getByRole('heading', { level: 1 });
18
+ expect(heading).not.toHaveClass('truncate');
19
+ expect(heading).toHaveClass('min-w-0', 'wrap-anywhere');
20
+ expect(heading.textContent).toBe(title);
21
+ expect(titleRef.current).toBe(heading);
22
+ expect(heading).toHaveAttribute('tabindex', '-1');
23
+ await userEvent.setup().tab();
24
+ expect(screen.getByRole('button', { name: 'Continue' })).toHaveFocus();
25
+ titleRef.current?.focus();
26
+ expect(heading).toHaveFocus();
27
+ await expectNoAxeViolations(container);
28
+ rerender(<PageHeader {...props} />);
29
+ expect(screen.getByRole('heading', { level: 1 }).className).toBe(
30
+ 'min-w-0 truncate text-2xl font-bold tracking-tight text-foreground',
31
+ );
32
+ rerender(<PageHeader {...props} titleRef={undefined} wrapTitle />);
33
+ expect(screen.getByRole('heading', { level: 1 })).not.toHaveAttribute('tabindex');
34
+ });
@@ -46,6 +46,8 @@ export interface PageHeaderProps {
46
46
  /** Location trail above the title; `null` hides it. */
47
47
  breadcrumbs?: BreadcrumbItem[] | null;
48
48
  title?: ReactNode;
49
+ /** Wrap the title, including long unbroken words, instead of truncating (default false). */
50
+ wrapTitle?: boolean;
49
51
  /** h1 focus target: adds tabIndex=-1 for titleRef.current.focus(), outside the Tab order. */
50
52
  titleRef?: Ref<HTMLHeadingElement>;
51
53
  description?: ReactNode;
@@ -56,7 +58,7 @@ export interface PageHeaderProps {
56
58
  meta?: PageHeaderMetaItem[];
57
59
  /**
58
60
  * Header actions in visual order. The primary one (first with `variant: 'primary'`, else the
59
- * last) stays visible on small screens; the rest fold into a MoreMenu.
61
+ * last) stays visible in narrow containers; the rest fold into a MoreMenu.
60
62
  */
61
63
  actions?: PageChromeAction[];
62
64
  /** Resource-level navigation tabs under the header; `null` hides them. */
@@ -72,6 +74,7 @@ export function PageHeader({
72
74
  as: Root = 'header',
73
75
  breadcrumbs = pageHeaderBreadcrumbs,
74
76
  title: titleProp,
77
+ wrapTitle = false,
75
78
  labels,
76
79
  titleRef,
77
80
  description: descriptionProp,
@@ -107,7 +110,7 @@ export function PageHeader({
107
110
  );
108
111
 
109
112
  return (
110
- <Root className={cn('min-w-0', className)}>
113
+ <Root className={cn('@container w-full min-w-0', className)}>
111
114
  {breadcrumbs && breadcrumbs.length > 0 && <Breadcrumbs items={breadcrumbs} maxItems={4} className="mb-2.5" />}
112
115
  <div className="flex flex-wrap items-end justify-between gap-4">
113
116
  <div className="min-w-0 flex-1">
@@ -115,7 +118,10 @@ export function PageHeader({
115
118
  <h1
116
119
  ref={titleRef}
117
120
  tabIndex={titleRef != null ? -1 : undefined}
118
- className="min-w-0 truncate text-2xl font-bold tracking-tight text-foreground"
121
+ className={cn(
122
+ wrapTitle ? 'min-w-0 wrap-anywhere' : 'min-w-0 truncate',
123
+ 'text-2xl font-bold tracking-tight text-foreground',
124
+ )}
119
125
  >
120
126
  {title}
121
127
  </h1>
@@ -138,8 +144,8 @@ export function PageHeader({
138
144
  </div>
139
145
  {actions.length > 0 && (
140
146
  <>
141
- <div className="hidden shrink-0 items-center gap-2.5 sm:flex">{actions.map(renderAction)}</div>
142
- <div className="flex shrink-0 items-center gap-2 sm:hidden">
147
+ <div className="hidden shrink-0 items-center gap-2.5 @xl:flex">{actions.map(renderAction)}</div>
148
+ <div className="flex shrink-0 items-center gap-2 @xl:hidden">
143
149
  {folded.length > 0 && (
144
150
  <MoreMenu items={folded.map(toMenuAction)} label={labels?.moreActions ?? t('pageHeader.moreActions')} />
145
151
  )}
@@ -6,7 +6,7 @@ export const meta: BlockMeta = {
6
6
  family: 'page-chrome',
7
7
  status: 'beta',
8
8
  description:
9
- 'Screen header with breadcrumb, title and status, description, meta row, actions that fold into a MoreMenu on small screens, and optional navigation tabs. titleRef targets the h1 for titleRef.current.focus(), adding tabIndex=-1 only when supplied so the title stays outside the Tab order. In a StatusLayout heading slot use as="div" and disable breadcrumb, meta, tabs, actions, status and description fixtures; the slot supplies the page’s only h1. The tablist name follows I18nProvider (en/es); the Spanish preview keeps caller content unchanged. Optional labels?: Partial<PageHeaderLabels> 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
+ 'Screen header with breadcrumb, title and status, description, meta row, actions that fold into a MoreMenu in narrow containers, and optional navigation tabs. titleRef targets the h1 for titleRef.current.focus(), adding tabIndex=-1 only when supplied so the title stays outside the Tab order. In a StatusLayout heading slot use as="div" and disable breadcrumb, meta, tabs, actions, status and description fixtures; the slot supplies the page’s only h1. The tablist name follows I18nProvider (en/es); the Spanish preview keeps caller content unchanged. Optional labels?: Partial<PageHeaderLabels> 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. wrapTitle?: boolean (default false) wraps the full title, including long words, while preserving titleRef focus behavior. The default title remains truncated. See the Spanish live preview for a wrapping title.',
10
10
  labels: [
11
11
  { key: 'title', type: 'string', state: 'Heading; explicit title prop wins, including null' },
12
12
  { key: 'description', type: 'string', state: 'Description; explicit description prop wins, including null' },
@@ -0,0 +1,16 @@
1
+ import { InspectorLayout } from '@gntik-ai/ui';
2
+ import { PageHeader } from '../PageHeader';
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={<PageHeader as="div" />}>
8
+ <div className="grid gap-6 overflow-auto p-4">
9
+ <div data-container-slot="default" className="flex min-w-0">
10
+ <PageHeader as="div" />
11
+ </div>
12
+ </div>
13
+ </InspectorLayout>
14
+ </div>
15
+ );
16
+ }
@@ -0,0 +1,23 @@
1
+ import { EditableText, useI18n } from '@gntik-ai/ui';
2
+ import { PageHeader } from '../PageHeader';
3
+
4
+ export default function EditableTitle() {
5
+ const { t } = useI18n();
6
+ return (
7
+ <PageHeader
8
+ title={
9
+ <EditableText
10
+ defaultValue={t('editableText.example.supportAgent')}
11
+ label={t('editableText.example.agentName')}
12
+ onSave={() => {}}
13
+ />
14
+ }
15
+ breadcrumbs={null}
16
+ description={null}
17
+ status=""
18
+ meta={[]}
19
+ actions={[]}
20
+ tabs={null}
21
+ />
22
+ );
23
+ }
@@ -6,6 +6,17 @@ export default function Spanish() {
6
6
  return (
7
7
  <I18nProvider locale="es">
8
8
  <PageHeader />
9
+ <PageHeader
10
+ as="div"
11
+ wrapTitle
12
+ title={`Resource details and correlation identifier ${'a'.repeat(120)}`}
13
+ breadcrumbs={null}
14
+ description={null}
15
+ status=""
16
+ meta={[]}
17
+ actions={[]}
18
+ tabs={null}
19
+ />
9
20
  </I18nProvider>
10
21
  );
11
22
  }
@@ -45,7 +45,7 @@ export function StickyActionBar({
45
45
  return (
46
46
  <section
47
47
  aria-label={ariaLabel}
48
- className={cn('sticky bottom-0 z-20 border-t border-border bg-card px-4 py-3 shadow-sm sm:px-6', className)}
48
+ className={cn('sticky bottom-0 z-docked border-t border-border bg-card px-4 py-3 shadow-sm sm:px-6', className)}
49
49
  >
50
50
  <div className="mx-auto flex max-w-5xl flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
51
51
  <p role="status" className="flex items-center gap-2 text-[13px] text-foreground">
@@ -2,6 +2,7 @@ import { useId, useMemo } from 'react';
2
2
  import { Badge, EmptyState, cn, useI18n } from '@gntik-ai/ui';
3
3
  import { CalendarDays, ChevronRight, Clock } from '@gntik-ai/icons';
4
4
  import { useSchedulingClock } from '../shared/useSchedulingClock';
5
+ import { TimeZoneLabel } from '../shared/CalendarHeader';
5
6
  import { EventTile } from '../shared/EventTile';
6
7
  import { addDays, dayKey, formatDay, formatRange, sameDay, type HourCycle } from '../shared/dates';
7
8
  import { defaultEventKinds, groupByDay, kindOf, TONE, type EventKind, type ScheduleEvent } from '../shared/events';
@@ -9,6 +10,8 @@ import { sampleEvents, sampleToday } from '../shared/fixtures';
9
10
 
10
11
  export interface AgendaListProps {
11
12
  events?: ScheduleEvent[];
13
+ /** Display time zone; defaults to the I18nProvider zone (system outside a provider). */
14
+ timeZone?: string;
12
15
  /** Clock used for event ranges; defaults to the provider or runtime locale. */
13
16
  hourCycle?: HourCycle;
14
17
  /** The app's "today": labels the Today/Tomorrow groups. */
@@ -33,6 +36,7 @@ export interface AgendaListProps {
33
36
  /** Upcoming scheduled work grouped by day, each row with a kind tile, time range and location. */
34
37
  export function AgendaList({
35
38
  events = sampleEvents,
39
+ timeZone: timeZoneProp,
36
40
  hourCycle: hourCycleProp,
37
41
  today = sampleToday,
38
42
  from,
@@ -46,7 +50,8 @@ export function AgendaList({
46
50
  titleAs: TitleTag = 'h3',
47
51
  className,
48
52
  }: AgendaListProps) {
49
- const { t, locale } = useI18n();
53
+ const { t, locale, timeZone: providerZone } = useI18n();
54
+ const timeZone = timeZoneProp ?? providerZone;
50
55
  const clock = useSchedulingClock(hourCycleProp);
51
56
  const title = titleProp ?? t('calendar.agenda');
52
57
  const emptyTitle = emptyTitleProp ?? t('calendar.emptyTitle');
@@ -55,23 +60,42 @@ export function AgendaList({
55
60
  const uid = useId();
56
61
  const start = from === undefined ? today : from;
57
62
  const groups = useMemo(() => {
58
- const first = start ? dayKey(start) : null;
59
- const last = start && days != null ? dayKey(addDays(start, days - 1)) : null;
60
- return [...groupByDay(events).entries()]
63
+ const first = start ? dayKey(start, timeZone) : null;
64
+ const last = start && days != null ? dayKey(addDays(start, days - 1, timeZone), timeZone) : null;
65
+ return [...groupByDay(events, timeZone).entries()]
61
66
  .filter(([key]) => (first == null || key >= first) && (last == null || key <= last))
62
67
  .sort(([a], [b]) => a.localeCompare(b));
63
- }, [events, start, days]);
68
+ }, [events, start, days, timeZone]);
64
69
 
65
70
  const dayLabel = (d: Date) => {
66
- if (sameDay(d, today)) return `${t('calendar.today')} · ${formatDay(d, locale)}`;
67
- if (sameDay(d, addDays(today, 1))) return `${t('calendar.tomorrow')} · ${formatDay(d, locale)}`;
68
- return formatDay(d, locale);
71
+ if (sameDay(d, today, timeZone)) return `${t('calendar.today')} · ${formatDay(d, locale, timeZone)}`;
72
+ if (sameDay(d, addDays(today, 1, timeZone), timeZone))
73
+ return `${t('calendar.tomorrow')} · ${formatDay(d, locale, timeZone)}`;
74
+ return formatDay(d, locale, timeZone);
69
75
  };
70
76
 
71
77
  return (
72
- <section aria-label={title} className={cn('overflow-hidden rounded-xl border border-border bg-card', className)}>
73
- <div className="flex items-center justify-between gap-3 border-b border-border px-4 py-3 sm:px-5">
74
- <TitleTag className="text-[15px] font-semibold tracking-tight text-foreground">{title}</TitleTag>
78
+ <section
79
+ aria-label={timeZone === 'system' ? title : undefined}
80
+ aria-labelledby={timeZone === 'system' ? undefined : `${uid}-title ${uid}-zone`}
81
+ className={cn('overflow-hidden rounded-xl border border-border bg-card', className)}
82
+ >
83
+ <div
84
+ className={cn(
85
+ 'flex items-center justify-between gap-3 border-b border-border px-4 py-3 sm:px-5',
86
+ timeZone !== 'system' && 'flex-wrap',
87
+ )}
88
+ >
89
+ {timeZone === 'system' ? (
90
+ <TitleTag className="text-[15px] font-semibold tracking-tight text-foreground">{title}</TitleTag>
91
+ ) : (
92
+ <div className="min-w-0">
93
+ <TitleTag id={`${uid}-title`} className="text-[15px] font-semibold tracking-tight text-foreground">
94
+ {title}
95
+ </TitleTag>
96
+ <TimeZoneLabel id={`${uid}-zone`} timeZone={timeZone} referenceDate={start ?? today} />
97
+ </div>
98
+ )}
75
99
  <span className="font-mono text-[11px] text-muted-foreground">
76
100
  {groups.reduce((n, [, list]) => n + list.length, 0)} scheduled
77
101
  </span>
@@ -90,7 +114,7 @@ export function AgendaList({
90
114
  tabIndex={maxHeight ? 0 : undefined}
91
115
  role={maxHeight ? 'region' : undefined}
92
116
  aria-label={maxHeight ? `${title} list` : undefined}
93
- className="overflow-y-auto focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-focus-ring"
117
+ className="overflow-y-auto focus-ring-inset"
94
118
  >
95
119
  {groups.map(([key, list]) => {
96
120
  const first = list[0];
@@ -100,7 +124,7 @@ export function AgendaList({
100
124
  <div key={key}>
101
125
  <SubTag
102
126
  id={headingId}
103
- className="border-b border-border bg-secondary/30 px-4 py-2 font-mono text-[11px] tracking-wide text-muted-foreground uppercase sm:px-5"
127
+ className="border-b border-border bg-secondary/30 px-4 py-2 font-mono text-[11px] tracking-wide text-muted-foreground label-case sm:px-5"
104
128
  >
105
129
  {dayLabel(first.start)}
106
130
  </SubTag>
@@ -110,7 +134,7 @@ export function AgendaList({
110
134
  >
111
135
  {list.map((event) => {
112
136
  const kind = kindOf(event, kinds);
113
- const range = formatRange(event.start, event.end, clock.locale, clock.hourCycle);
137
+ const range = formatRange(event.start, event.end, clock.locale, clock.hourCycle, timeZone);
114
138
  const content = (
115
139
  <>
116
140
  <EventTile kind={kind} />
@@ -143,7 +167,7 @@ export function AgendaList({
143
167
  onClick={() => onEventClick(event)}
144
168
  className={cn(
145
169
  row,
146
- 'group transition-colors hover:bg-accent/30 focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-focus-ring motion-reduce:transition-none',
170
+ 'group transition-colors hover:bg-accent/30 focus-ring-inset motion-reduce:transition-none',
147
171
  )}
148
172
  >
149
173
  {content}
@@ -0,0 +1,38 @@
1
+ import TimeZoneExample from './examples/TimeZone';
2
+ import { expectNoAxeViolations } from '../../test/a11y';
3
+ import { I18nProvider } from '@gntik-ai/ui';
4
+ import { render, screen, within } from '@testing-library/react';
5
+ import { AgendaList } from './AgendaList';
6
+
7
+ it('groups, filters and formats on the provider clock instead of the Madrid runtime', () => {
8
+ vi.stubEnv('TZ', 'Europe/Madrid');
9
+ try {
10
+ render(
11
+ <I18nProvider locale="en-US" timeZone="America/New_York">
12
+ <AgendaList
13
+ days={1}
14
+ today={new Date('2026-04-16T01:00:00Z')}
15
+ events={[
16
+ {
17
+ id: 'late',
18
+ title: 'Late run',
19
+ start: new Date('2026-04-16T01:00:00Z'),
20
+ end: new Date('2026-04-16T02:00:00Z'),
21
+ },
22
+ ]}
23
+ />
24
+ </I18nProvider>,
25
+ );
26
+ const group = screen.getByRole('list', { name: 'Today · Wednesday, April 15' });
27
+ expect(within(group).getByText('9:00 PM–10:00 PM')).toBeInTheDocument();
28
+ expect(within(group).getByText('Late run')).toBeInTheDocument();
29
+ expect(screen.getByText('Times in America/New_York (EDT)')).toBeInTheDocument();
30
+ } finally {
31
+ vi.unstubAllEnvs();
32
+ }
33
+ });
34
+
35
+ it('has no axe violations in the display-zone example', async () => {
36
+ const { container } = render(<TimeZoneExample />);
37
+ await expectNoAxeViolations(container);
38
+ });
@@ -5,6 +5,6 @@ export const meta: BlockMeta = {
5
5
  family: 'scheduling',
6
6
  status: 'beta',
7
7
  description:
8
- 'Upcoming scheduled work grouped by day (Today/Tomorrow labels), each row with a kind tile, locale-formatted time range, location and kind badge; empty state included. hourCycle overrides the provider/runtime clock. Locale examples show en-US, es-ES, then en-US with the 24-hour override.',
8
+ 'Upcoming scheduled work grouped by day (Today/Tomorrow labels), each row with a kind tile, locale-formatted time range, location and kind badge; empty state included. hourCycle overrides the provider/runtime clock. timeZone defaults to I18nProvider (system when unset); TimeZone examples demonstrate UTC, an explicit New York override and a Spanish Madrid provider. Use the same zone on server and client. Locale examples show en-US, es-ES, then en-US with the 24-hour override.',
9
9
  uses: ['Badge', 'EmptyState'],
10
10
  };
@@ -0,0 +1,28 @@
1
+ import { I18nProvider } from '@gntik-ai/ui';
2
+ import { AgendaList } from '../AgendaList';
3
+
4
+ const today = new Date('2026-04-15T13:00:00Z');
5
+ const events = [
6
+ {
7
+ id: 'morning',
8
+ title: 'Morning run',
9
+ start: new Date('2026-04-15T13:00:00Z'),
10
+ end: new Date('2026-04-15T14:00:00Z'),
11
+ },
12
+ { id: 'late', title: 'Late run', start: new Date('2026-04-15T23:30:00Z'), end: new Date('2026-04-16T00:30:00Z') },
13
+ ];
14
+
15
+ /** UTC provider default, New York prop override, then a Spanish Madrid provider. */
16
+ export default function TimeZone() {
17
+ return (
18
+ <div className="space-y-6">
19
+ <I18nProvider locale="en-US" timeZone="UTC">
20
+ <AgendaList today={today} events={events} />
21
+ <AgendaList today={today} events={events} timeZone="America/New_York" />
22
+ </I18nProvider>
23
+ <I18nProvider locale="es-ES" timeZone="Europe/Madrid">
24
+ <AgendaList today={today} events={events} />
25
+ </I18nProvider>
26
+ </div>
27
+ );
28
+ }