@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
@@ -0,0 +1,137 @@
1
+ import { fireEvent, render, screen } from '@testing-library/react';
2
+ import { I18nProvider, es } from '@gntik-ai/ui';
3
+ import { SignInForm, type SignInFormLabels } from './SignInForm';
4
+ import { expectNoAxeViolations } from '../../test/a11y';
5
+ it('preserves every English default and translates the Spanish form and validation', async () => {
6
+ const { rerender } = render(<SignInForm />);
7
+ expect(screen.getByText('Secure access')).toBeVisible();
8
+ expect(screen.getByText('Sign in to your workspace')).toBeVisible();
9
+ expect(screen.getByText('Use your work email to continue.')).toBeVisible();
10
+ expect(screen.getByText('Email')).toBeVisible();
11
+ expect(screen.getByText('Password')).toBeVisible();
12
+ expect(screen.getByText('Forgot password?')).toBeVisible();
13
+ expect(screen.getByText('Keep me signed in')).toBeVisible();
14
+ expect(screen.getByText('Or continue with')).toBeVisible();
15
+ expect(screen.getByText('New here?')).toBeVisible();
16
+ expect(screen.getByText('Create an account')).toBeVisible();
17
+ expect(screen.getByRole('form', { name: 'Sign in' })).toBeVisible();
18
+ expect(screen.getByPlaceholderText('name@company.com')).toBeVisible();
19
+ expect(screen.getByRole('button', { name: 'Sign in' })).toBeVisible();
20
+ rerender(
21
+ <I18nProvider locale="es">
22
+ <SignInForm />
23
+ </I18nProvider>,
24
+ );
25
+ expect(screen.getByText(es['signIn.eyebrow'])).toBeVisible();
26
+ expect(screen.getByText(es['signIn.title'])).toBeVisible();
27
+ expect(screen.getByText(es['signIn.description'])).toBeVisible();
28
+ expect(screen.getByText(es['signIn.identifierLabel'])).toBeVisible();
29
+ expect(screen.getByText(es['signIn.password'])).toBeVisible();
30
+ expect(screen.getByText(es['signIn.forgotPassword'])).toBeVisible();
31
+ expect(screen.getByText(es['signIn.remember'])).toBeVisible();
32
+ expect(screen.getByText(es['signIn.divider'])).toBeVisible();
33
+ expect(screen.getByText(es['signIn.signUpPrompt'])).toBeVisible();
34
+ expect(screen.getByText(es['signIn.signUp'])).toBeVisible();
35
+ expect(screen.getByPlaceholderText(es['signIn.identifierPlaceholder'])).toBeVisible();
36
+ const form = screen.getByRole('form', { name: es['signIn.formLabel'] });
37
+ fireEvent.submit(form);
38
+ expect(screen.getByText('Introduce una dirección de correo válida.')).toBeVisible();
39
+ expect(screen.getByText(es['signIn.passwordRequired'])).toBeVisible();
40
+ await expectNoAxeViolations(form);
41
+ });
42
+ it.each(['en', 'es'])('honours all label overrides and existing explicit props under %s', (locale) => {
43
+ const labels: SignInFormLabels = {
44
+ eyebrow: 'Custom eyebrow',
45
+ title: 'Custom title',
46
+ description: 'Custom description',
47
+ formLabel: 'Custom formLabel',
48
+ identifierLabel: 'Custom identifierLabel',
49
+ identifierPlaceholder: 'Custom identifierPlaceholder',
50
+ password: 'Custom password',
51
+ forgotPassword: 'Custom forgotPassword',
52
+ passwordRequired: 'Custom passwordRequired',
53
+ remember: 'Custom remember',
54
+ submit: 'Custom submit',
55
+ divider: 'Custom divider',
56
+ signUpPrompt: 'Custom signUpPrompt',
57
+ signUp: 'Custom signUp',
58
+ fallbackError: 'Custom fallbackError',
59
+ identifierRequired: 'Custom required',
60
+ identifierInvalid: 'Custom invalid',
61
+ identifierTooShort: 'Custom short',
62
+ };
63
+ const { rerender } = render(
64
+ <I18nProvider locale={locale}>
65
+ <SignInForm labels={labels} />
66
+ </I18nProvider>,
67
+ );
68
+ expect(screen.getByText(labels.eyebrow)).toBeVisible();
69
+ expect(screen.getByText(labels.title)).toBeVisible();
70
+ expect(screen.getByText(labels.description)).toBeVisible();
71
+ expect(screen.getByText(labels.identifierLabel)).toBeVisible();
72
+ expect(screen.getByText(labels.password)).toBeVisible();
73
+ expect(screen.getByText(labels.forgotPassword)).toBeVisible();
74
+ expect(screen.getByText(labels.remember)).toBeVisible();
75
+ expect(screen.getByText(labels.divider)).toBeVisible();
76
+ expect(screen.getByText(labels.signUpPrompt)).toBeVisible();
77
+ expect(screen.getByText(labels.signUp)).toBeVisible();
78
+ expect(screen.getByPlaceholderText(labels.identifierPlaceholder)).toBeVisible();
79
+ fireEvent.submit(screen.getByRole('form', { name: labels.formLabel }));
80
+ expect(screen.getByText(labels.identifierRequired)).toBeVisible();
81
+ expect(screen.getByText(labels.passwordRequired)).toBeVisible();
82
+ rerender(
83
+ <I18nProvider locale={locale}>
84
+ <SignInForm
85
+ labels={labels}
86
+ title="Explicit title"
87
+ description="Explicit description"
88
+ eyebrow="Explicit eyebrow"
89
+ aria-label="Explicit form"
90
+ identifier={{ label: 'Explicit identifier', placeholder: 'Explicit placeholder' }}
91
+ messages={{ identifierRequired: 'Explicit required', passwordRequired: 'Explicit password' }}
92
+ signUpPrompt="Explicit prompt"
93
+ />
94
+ </I18nProvider>,
95
+ );
96
+ for (const text of [
97
+ 'Explicit title',
98
+ 'Explicit description',
99
+ 'Explicit eyebrow',
100
+ 'Explicit identifier',
101
+ 'Explicit prompt',
102
+ ])
103
+ expect(screen.getByText(text)).toBeVisible();
104
+ expect(screen.getByPlaceholderText('Explicit placeholder')).toBeVisible();
105
+ fireEvent.submit(screen.getByRole('form', { name: 'Explicit form' }));
106
+ expect(screen.getByText('Explicit required')).toBeVisible();
107
+ expect(screen.getByText('Explicit password')).toBeVisible();
108
+ });
109
+ it('uses translated fallback on an async rejection and preserves server messages', async () => {
110
+ render(
111
+ <I18nProvider locale="es">
112
+ <SignInForm defaultEmail="a@example.com" onSubmit={() => Promise.reject(null)} />
113
+ </I18nProvider>,
114
+ );
115
+ fireEvent.change(screen.getByLabelText(es['signIn.password']), { target: { value: 'password' } });
116
+ fireEvent.submit(screen.getByRole('form'));
117
+ expect(await screen.findByText(es['signIn.fallbackError'])).toBeVisible();
118
+ });
119
+
120
+ it.each(['en', 'es'])('uses custom invalid and short identifier messages under %s', (locale) => {
121
+ const labels = { identifierInvalid: 'Custom invalid identifier', identifierTooShort: 'Custom short identifier' };
122
+ const { rerender } = render(
123
+ <I18nProvider locale={locale}>
124
+ <SignInForm labels={labels} />
125
+ </I18nProvider>,
126
+ );
127
+ fireEvent.change(screen.getByRole('textbox'), { target: { value: 'invalid' } });
128
+ fireEvent.submit(screen.getByRole('form'));
129
+ expect(screen.getByText('Custom invalid identifier')).toBeVisible();
130
+ rerender(
131
+ <I18nProvider locale={locale}>
132
+ <SignInForm labels={labels} identifier={{ type: 'text', minLength: 10 }} />
133
+ </I18nProvider>,
134
+ );
135
+ fireEvent.submit(screen.getByRole('form'));
136
+ expect(screen.getByText('Custom short identifier')).toBeVisible();
137
+ });
@@ -1,4 +1,5 @@
1
1
  import {
2
+ useI18n,
2
3
  Alert,
3
4
  Button,
4
5
  Checkbox,
@@ -38,7 +39,26 @@ export interface SignInFormRef {
38
39
  focus(field: 'identifier' | 'password'): void;
39
40
  }
40
41
 
42
+ export interface SignInFormLabels extends Required<AuthValidationMessages> {
43
+ eyebrow: string;
44
+ title: string;
45
+ description: string;
46
+ formLabel: string;
47
+ identifierLabel: string;
48
+ identifierPlaceholder: string;
49
+ password: string;
50
+ forgotPassword: string;
51
+ passwordRequired: string;
52
+ remember: string;
53
+ submit: string;
54
+ divider: string;
55
+ signUpPrompt: string;
56
+ signUp: string;
57
+ fallbackError: string;
58
+ }
59
+
41
60
  export interface SignInFormProps extends AuthFormAccessibilityProps {
61
+ labels?: Partial<SignInFormLabels>;
42
62
  /** React 19 ref for focus after a server response. */
43
63
  ref?: Ref<SignInFormRef>;
44
64
  identifier?: AuthIdentifierConfig;
@@ -79,6 +99,7 @@ const linkHandler = (fn?: () => void) =>
79
99
 
80
100
  /** Email + password sign-in with remember me, forgot-password link, SSO slot, error alert and loading. */
81
101
  export function SignInForm({
102
+ labels,
82
103
  identifier,
83
104
  messages,
84
105
  passwordHelp,
@@ -87,7 +108,7 @@ export function SignInForm({
87
108
  fieldInvalid,
88
109
  feedbackId,
89
110
  'aria-describedby': describedBy,
90
- 'aria-label': ariaLabel = 'Sign in',
111
+ 'aria-label': ariaLabelProp,
91
112
  'aria-labelledby': labelledBy,
92
113
  onSubmit,
93
114
  error: errorProp,
@@ -99,17 +120,23 @@ export function SignInForm({
99
120
  onSignUp,
100
121
  signUpPrompt,
101
122
  sso = <SsoButtons />,
102
- eyebrow = 'Secure access',
103
- title = 'Sign in to your workspace',
104
- description = 'Use your work email to continue.',
123
+ eyebrow: eyebrowProp,
124
+ title: titleProp,
125
+ description: descriptionProp,
105
126
  headingLevel,
106
127
  className,
107
128
  }: SignInFormProps) {
129
+ const { t } = useI18n();
130
+ const eyebrow = eyebrowProp === undefined ? (labels?.eyebrow ?? t('signIn.eyebrow')) : eyebrowProp;
131
+ const title = titleProp === undefined ? (labels?.title ?? t('signIn.title')) : titleProp;
132
+ const description =
133
+ descriptionProp === undefined ? (labels?.description ?? t('signIn.description')) : descriptionProp;
134
+ const ariaLabel = ariaLabelProp ?? labels?.formLabel ?? t('signIn.formLabel');
108
135
  const [email, setEmail] = useState(defaultEmail);
109
136
  const [password, setPassword] = useState('');
110
137
  const [remember, setRemember] = useState(true);
111
138
  const [submitted, setSubmitted] = useState(false);
112
- const { loading, error, run } = useAsyncSubmit('Sign-in failed. Try again.');
139
+ const { loading, error, run } = useAsyncSubmit(labels?.fallbackError ?? t('signIn.fallbackError'));
113
140
  const busy = loadingProp ?? loading;
114
141
  const alert = errorProp ?? error;
115
142
  const identifierInput = useRef<HTMLInputElement>(null);
@@ -121,7 +148,7 @@ export function SignInForm({
121
148
  }),
122
149
  [],
123
150
  );
124
- const identifierError = authIdentifierError(email, identifier, messages);
151
+ const identifierError = authIdentifierError(email, identifier, messages, t, labels);
125
152
  const emailInvalid = submitted && identifierError !== null;
126
153
  const passwordInvalid = submitted && password === '';
127
154
 
@@ -157,14 +184,14 @@ export function SignInForm({
157
184
  >
158
185
  {alert && <Alert id={feedbackId} tone="destructive" description={alert} />}
159
186
  <Field invalid={emailInvalid || fieldInvalid?.identifier === true}>
160
- <FieldLabel>{identifier?.label ?? 'Email'}</FieldLabel>
187
+ <FieldLabel>{identifier?.label ?? labels?.identifierLabel ?? t('signIn.identifierLabel')}</FieldLabel>
161
188
  <Input
162
189
  ref={identifierInput}
163
190
  aria-describedby={fieldInvalid?.identifier ? feedbackId : undefined}
164
191
  type={identifier?.type ?? 'email'}
165
192
  leadingIcon={Mail}
166
193
  autoComplete={identifier?.autoComplete ?? 'email'}
167
- placeholder={identifier?.placeholder ?? 'name@company.com'}
194
+ placeholder={identifier?.placeholder ?? labels?.identifierPlaceholder ?? t('signIn.identifierPlaceholder')}
168
195
  minLength={identifier?.minLength}
169
196
  maxLength={identifier?.maxLength}
170
197
  value={email}
@@ -178,9 +205,9 @@ export function SignInForm({
178
205
  </Field>
179
206
  <Field invalid={passwordInvalid || fieldInvalid?.password === true}>
180
207
  <div className="flex items-center justify-between gap-3">
181
- <FieldLabel>Password</FieldLabel>
208
+ <FieldLabel>{labels?.password ?? t('signIn.password')}</FieldLabel>
182
209
  <Link href={forgotPasswordHref} onClick={linkHandler(onForgotPassword)} className="text-[12.5px]">
183
- Forgot password?
210
+ {labels?.forgotPassword ?? t('signIn.forgotPassword')}
184
211
  </Link>
185
212
  </div>
186
213
  <PasswordInput
@@ -193,17 +220,17 @@ export function SignInForm({
193
220
  />
194
221
  {passwordHelp != null && <FieldDescription id={passwordHelpId}>{passwordHelp}</FieldDescription>}
195
222
  <FieldError role="alert" match={passwordInvalid}>
196
- {messages?.passwordRequired ?? 'Enter your password.'}
223
+ {messages?.passwordRequired ?? labels?.passwordRequired ?? t('signIn.passwordRequired')}
197
224
  </FieldError>
198
225
  </Field>
199
- <Checkbox label="Keep me signed in" checked={remember} onCheckedChange={setRemember} />
226
+ <Checkbox label={labels?.remember ?? t('signIn.remember')} checked={remember} onCheckedChange={setRemember} />
200
227
  <Button type="submit" size="lg" loading={busy} className="mt-2 w-full">
201
- Sign in
228
+ {labels?.submit ?? t('signIn.submit')}
202
229
  </Button>
203
230
  </form>
204
231
  {sso != null && (
205
232
  <>
206
- <AuthDivider>Or continue with</AuthDivider>
233
+ <AuthDivider>{labels?.divider ?? t('signIn.divider')}</AuthDivider>
207
234
  {sso}
208
235
  </>
209
236
  )}
@@ -211,9 +238,9 @@ export function SignInForm({
211
238
  <p className="mt-7 text-center text-[13px] text-muted-foreground">
212
239
  {signUpPrompt === undefined ? (
213
240
  <>
214
- New here?{' '}
241
+ {labels?.signUpPrompt ?? t('signIn.signUpPrompt')}{' '}
215
242
  <Link href={signUpHref} onClick={linkHandler(onSignUp)}>
216
- Create an account
243
+ {labels?.signUp ?? t('signIn.signUp')}
217
244
  </Link>
218
245
  </>
219
246
  ) : (
@@ -1,11 +1,32 @@
1
1
  import type { BlockMeta } from '../../meta';
2
+ import type { SignInFormLabels } from './SignInForm';
2
3
 
3
4
  export const meta: BlockMeta = {
4
5
  name: 'Sign-in form',
5
6
  family: 'auth',
6
7
  status: 'stable',
7
8
  description:
8
- 'Email (default) or text identifier and password sign-in. Supports identifier (type, autoComplete, label, help/helpId, placeholder, minLength/maxLength), messages (identifierRequired/identifierInvalid/identifierTooShort/passwordRequired), and React 19 ref.focus. The kit owns inline validation and focuses the first invalid field; consumers supply messages, not a second inline validator. Server errors use error + fieldInvalid + feedbackId; aria-describedby describes the form, while flagged inputs also retain their help and error ids. headingLevel (h1/h2/h3/null) suppresses the heading without losing the form name; aria-label/aria-labelledby override the default name. passwordHelp/passwordHelpId describe the password. Text submissions add values.identifier and retain values.email; email-mode payloads are unchanged. sso and signUpPrompt accept replacements or null. Preview: sign-in-form--username.',
9
+ 'Email (default) or text identifier and password sign-in. Supports identifier (type, autoComplete, label, help/helpId, placeholder, minLength/maxLength), messages (identifierRequired/identifierInvalid/identifierTooShort/passwordRequired), and React 19 ref.focus. The kit owns inline validation and focuses the first invalid field; consumers supply messages, not a second inline validator. Server errors use error + fieldInvalid + feedbackId; aria-describedby describes the form, while flagged inputs also retain their help and error ids. headingLevel (h1/h2/h3/null) suppresses the heading without losing the form name; aria-label/aria-labelledby override the default name. passwordHelp/passwordHelpId describe the password. Text submissions add values.identifier and retain values.email; email-mode payloads are unchanged. sso and signUpPrompt accept replacements or null. Preview: sign-in-form--username. Optional labels?: Partial<SignInFormLabels> overrides built-in copy; explicit props and validation messages win, then labels, then I18nProvider (en/es). No provider preserves English; fixtures and caller content stay unchanged. Interactive preview: /preview.html?kind=block&id=sign-in-form--labels.',
10
+ labels: [
11
+ { key: 'eyebrow', type: 'string', state: 'Default content and accessible names' },
12
+ { key: 'title', type: 'string', state: 'Default content and accessible names' },
13
+ { key: 'description', type: 'string', state: 'Default content and accessible names' },
14
+ { key: 'formLabel', type: 'string', state: 'Default content and accessible names' },
15
+ { key: 'identifierLabel', type: 'string', state: 'Default content and accessible names' },
16
+ { key: 'identifierPlaceholder', type: 'string', state: 'Default content and accessible names' },
17
+ { key: 'password', type: 'string', state: 'Default content and accessible names' },
18
+ { key: 'forgotPassword', type: 'string', state: 'Default content and accessible names' },
19
+ { key: 'passwordRequired', type: 'string', state: 'Validation feedback' },
20
+ { key: 'remember', type: 'string', state: 'Default content and accessible names' },
21
+ { key: 'submit', type: 'string', state: 'Default content and accessible names' },
22
+ { key: 'divider', type: 'string', state: 'Default content and accessible names' },
23
+ { key: 'signUpPrompt', type: 'string', state: 'Default content and accessible names' },
24
+ { key: 'signUp', type: 'string', state: 'Default content and accessible names' },
25
+ { key: 'fallbackError', type: 'string', state: 'Validation feedback' },
26
+ { key: 'identifierRequired', type: 'string', state: 'Validation feedback' },
27
+ { key: 'identifierInvalid', type: 'string', state: 'Validation feedback' },
28
+ { key: 'identifierTooShort', type: 'string', state: 'Validation feedback' },
29
+ ] satisfies Array<{ key: keyof SignInFormLabels; type: string; state: string }>,
9
30
  uses: [
10
31
  'Field',
11
32
  'FieldLabel',
@@ -0,0 +1,29 @@
1
+ import { Button, I18nProvider } from '@gntik-ai/ui';
2
+ import { useState } from 'react';
3
+ import { SignInForm, type SignInFormLabels } from '../SignInForm';
4
+
5
+ export default function Labels() {
6
+ const [spanish, setSpanish] = useState(false);
7
+ const [custom, setCustom] = useState(true);
8
+ const labels: Partial<SignInFormLabels> = {
9
+ title: 'Welcome back',
10
+ submit: 'Continue',
11
+ identifierLabel: 'Account email',
12
+ passwordRequired: 'Provide your password.',
13
+ };
14
+ return (
15
+ <div className="grid gap-4">
16
+ <div className="flex flex-wrap gap-2">
17
+ <Button variant="secondary" aria-pressed={spanish} onClick={() => setSpanish(!spanish)}>
18
+ Spanish catalog
19
+ </Button>
20
+ <Button variant="secondary" aria-pressed={custom} onClick={() => setCustom(!custom)}>
21
+ Custom labels
22
+ </Button>
23
+ </div>
24
+ <I18nProvider locale={spanish ? 'es' : 'en'}>
25
+ <SignInForm labels={custom ? labels : undefined} />
26
+ </I18nProvider>
27
+ </div>
28
+ );
29
+ }
@@ -0,0 +1,217 @@
1
+ import { fireEvent, render, screen } from '@testing-library/react';
2
+ import userEvent from '@testing-library/user-event';
3
+ import { I18nProvider, en, es } from '@gntik-ai/ui';
4
+ import { SignUpForm, type SignUpFormLabels } from './SignUpForm';
5
+ import { expectNoAxeViolations } from '../../test/a11y';
6
+ it('preserves English text and accessible names without a provider', () => {
7
+ render(<SignUpForm />);
8
+ expect(screen.getByText('Get started')).toBeVisible();
9
+ expect(screen.getByText('Create your account')).toBeVisible();
10
+ expect(screen.getByText('Set up a workspace for your team in a couple of minutes.')).toBeVisible();
11
+ expect(screen.getByText('Full name')).toBeVisible();
12
+ expect(screen.getByText('Work email')).toBeVisible();
13
+ expect(screen.getByText('Password')).toBeVisible();
14
+ expect(screen.getByText('Terms')).toBeVisible();
15
+ expect(screen.getByText('Privacy Policy')).toBeVisible();
16
+ expect(screen.getByText('Or sign up with')).toBeVisible();
17
+ expect(screen.getByText('Already have an account?')).toBeVisible();
18
+ expect(screen.getByText('Sign in')).toBeVisible();
19
+ expect(screen.getByRole('form', { name: 'Create account' })).toBeVisible();
20
+ expect(screen.getByRole('button', { name: 'Create account' })).toBeVisible();
21
+ expect(screen.getByRole('checkbox', { name: 'I agree to the Terms and Privacy Policy.' })).toBeVisible();
22
+ expect(screen.getByPlaceholderText('Avery Collins')).toBeVisible();
23
+ expect(screen.getByPlaceholderText('name@company.com')).toBeVisible();
24
+ });
25
+ it('translates every static default, validation, async fallback and policy loading state', async () => {
26
+ const { rerender } = render(
27
+ <I18nProvider locale="es">
28
+ <SignUpForm onSubmit={() => Promise.reject(null)} />
29
+ </I18nProvider>,
30
+ );
31
+ expect(screen.getByText(es['signUp.eyebrow'])).toBeVisible();
32
+ expect(screen.getByText(es['signUp.title'])).toBeVisible();
33
+ expect(screen.getByText(es['signUp.description'])).toBeVisible();
34
+ expect(screen.getByText(es['signUp.name'])).toBeVisible();
35
+ expect(screen.getByText(es['signUp.email'])).toBeVisible();
36
+ expect(screen.getByText(es['signUp.password'])).toBeVisible();
37
+ expect(screen.getByText(es['signUp.terms'])).toBeVisible();
38
+ expect(screen.getByText(es['signUp.privacy'])).toBeVisible();
39
+ expect(screen.getByText(es['signUp.divider'])).toBeVisible();
40
+ expect(screen.getByText(es['signUp.signInPrompt'])).toBeVisible();
41
+ expect(screen.getByText(es['signUp.signIn'])).toBeVisible();
42
+ expect(screen.getByPlaceholderText(es['signUp.namePlaceholder'])).toHaveAccessibleName(es['signUp.name']);
43
+ expect(screen.getByPlaceholderText(es['signUp.emailPlaceholder'])).toHaveAccessibleName(es['signUp.email']);
44
+ expect(screen.getByRole('checkbox', { name: 'Acepto los Términos y la Política de privacidad.' })).toBeVisible();
45
+ fireEvent.submit(screen.getByRole('form', { name: es['signUp.submit'] }));
46
+ expect(screen.getByText(es['signUp.nameRequired'])).toBeVisible();
47
+ expect(screen.getByText('Introduce una dirección de correo válida.')).toBeVisible();
48
+ expect(screen.getByText('Usa al menos 8 caracteres.')).toBeVisible();
49
+ expect(screen.getByText(es['signUp.termsRequired'])).toBeVisible();
50
+ await expectNoAxeViolations(screen.getByRole('form'));
51
+ fireEvent.change(screen.getByLabelText(es['signUp.name']), { target: { value: 'Avery' } });
52
+ fireEvent.change(screen.getByLabelText(es['signUp.email']), { target: { value: 'a@example.com' } });
53
+ fireEvent.change(screen.getByLabelText(es['signUp.password']), { target: { value: 'password123' } });
54
+ await userEvent.click(screen.getByRole('checkbox'));
55
+ await userEvent.click(screen.getByRole('button', { name: es['signUp.submit'] }));
56
+ expect(await screen.findByText(es['signUp.fallbackError'])).toBeVisible();
57
+ rerender(
58
+ <I18nProvider locale="es">
59
+ <SignUpForm policyLoading />
60
+ </I18nProvider>,
61
+ );
62
+ expect(screen.getByRole('status')).toHaveTextContent(es['signUp.policyLoading']);
63
+ });
64
+ it('uses hand-written Spanish parameterised field validation through configured forms', () => {
65
+ render(
66
+ <I18nProvider locale="es">
67
+ <SignUpForm
68
+ fields={[
69
+ { id: 'name', label: 'Nombre', required: true },
70
+ { id: 'email', label: 'Correo', type: 'email', required: true },
71
+ ]}
72
+ minPasswordLength={12}
73
+ />
74
+ </I18nProvider>,
75
+ );
76
+ fireEvent.submit(screen.getByRole('form'));
77
+ expect(screen.getByText('Introduce Nombre.')).toBeVisible();
78
+ expect(screen.getByText('Introduce Correo.')).toBeVisible();
79
+ expect(screen.getByText('Usa al menos 12 caracteres.')).toBeVisible();
80
+ expect(screen.getByRole('link', { name: 'Nombre: Introduce Nombre.' })).toBeVisible();
81
+ expect(screen.getByRole('link', { name: 'Contraseña: Usa al menos 12 caracteres.' })).toBeVisible();
82
+ fireEvent.change(screen.getByLabelText('Correo'), { target: { value: 'invalid' } });
83
+ fireEvent.submit(screen.getByRole('form'));
84
+ expect(screen.getByText('Introduce una dirección de correo válida.')).toBeVisible();
85
+ });
86
+ it.each(['en', 'es'])('honours every label override and explicit validation under %s', async (locale) => {
87
+ const labels: SignUpFormLabels = {
88
+ eyebrow: 'Custom eyebrow',
89
+ title: 'Custom title',
90
+ description: 'Custom description',
91
+ name: 'Custom name',
92
+ namePlaceholder: 'Custom namePlaceholder',
93
+ nameRequired: 'Custom nameRequired',
94
+ email: 'Custom email',
95
+ emailPlaceholder: 'Custom emailPlaceholder',
96
+ password: 'Custom password',
97
+ termsRequired: 'Custom termsRequired',
98
+ terms: 'Custom terms',
99
+ privacy: 'Custom privacy',
100
+ submit: 'Custom submit',
101
+ divider: 'Custom divider',
102
+ signInPrompt: 'Custom signInPrompt',
103
+ signIn: 'Custom signIn',
104
+ policyLoading: 'Custom policyLoading',
105
+ fallbackError: 'Custom fallbackError',
106
+ emailInvalid: 'Custom email error',
107
+ fieldRequired: (label) => `Custom required ${label}`,
108
+ fieldInvalid: 'Custom field invalid',
109
+ passwordTooShort: (minimum) => `Custom minimum ${minimum}`,
110
+ termsConsent: (terms, privacy) => (
111
+ <>
112
+ Custom consent {terms} {privacy}
113
+ </>
114
+ ),
115
+ };
116
+ const { rerender } = render(
117
+ <I18nProvider locale={locale}>
118
+ <SignUpForm labels={labels} />
119
+ </I18nProvider>,
120
+ );
121
+ expect(screen.getByText(labels.eyebrow)).toBeVisible();
122
+ expect(screen.getByText(labels.title)).toBeVisible();
123
+ expect(screen.getByText(labels.description)).toBeVisible();
124
+ expect(screen.getByText(labels.name)).toBeVisible();
125
+ expect(screen.getByText(labels.email)).toBeVisible();
126
+ expect(screen.getByText(labels.password)).toBeVisible();
127
+ expect(screen.getByText(labels.terms)).toBeVisible();
128
+ expect(screen.getByText(labels.privacy)).toBeVisible();
129
+ expect(screen.getByText(labels.divider)).toBeVisible();
130
+ expect(screen.getByText(labels.signInPrompt)).toBeVisible();
131
+ expect(screen.getByText(labels.signIn)).toBeVisible();
132
+ expect(screen.getByRole('checkbox', { name: 'Custom consent Custom terms Custom privacy' })).toBeVisible();
133
+ expect(screen.getByPlaceholderText(labels.namePlaceholder)).toBeVisible();
134
+ expect(screen.getByPlaceholderText(labels.emailPlaceholder)).toBeVisible();
135
+ fireEvent.submit(screen.getByRole('form', { name: labels.submit }));
136
+ for (const text of [labels.nameRequired, labels.emailInvalid, 'Custom minimum 8', labels.termsRequired])
137
+ expect(screen.getByText(text)).toBeVisible();
138
+ fireEvent.change(screen.getByLabelText(labels.name), { target: { value: 'Avery' } });
139
+ fireEvent.change(screen.getByLabelText(labels.email), { target: { value: 'a@example.com' } });
140
+ fireEvent.change(screen.getByLabelText(labels.password), { target: { value: 'password123' } });
141
+ await userEvent.click(screen.getByRole('checkbox'));
142
+ rerender(
143
+ <I18nProvider locale={locale}>
144
+ <SignUpForm labels={labels} onSubmit={() => Promise.reject(null)} />
145
+ </I18nProvider>,
146
+ );
147
+ await userEvent.click(screen.getByRole('button', { name: labels.submit }));
148
+ expect(await screen.findByText(labels.fallbackError)).toBeVisible();
149
+ rerender(
150
+ <I18nProvider locale={locale}>
151
+ <SignUpForm
152
+ key="configured"
153
+ labels={labels}
154
+ fields={[
155
+ { id: 'name', label: 'Consumer field', required: true },
156
+ { id: 'email', label: 'Consumer email', type: 'email' },
157
+ ]}
158
+ />
159
+ </I18nProvider>,
160
+ );
161
+ fireEvent.submit(screen.getByRole('form'));
162
+ expect(screen.getByText('Custom required Consumer field')).toBeVisible();
163
+ fireEvent.change(screen.getByLabelText('Consumer email'), { target: { value: 'invalid' } });
164
+ fireEvent.submit(screen.getByRole('form'));
165
+ expect(screen.getByText('Custom field invalid')).toBeVisible();
166
+ rerender(
167
+ <I18nProvider locale={locale}>
168
+ <SignUpForm
169
+ key="configured"
170
+ labels={labels}
171
+ title="Explicit title"
172
+ description="Explicit description"
173
+ eyebrow="Explicit eyebrow"
174
+ fields={[{ id: 'name', label: 'Consumer field', required: true, messages: { required: 'Explicit field' } }]}
175
+ messages={{ passwordTooShort: (minimum) => `Explicit minimum ${minimum}`, termsRequired: 'Explicit terms' }}
176
+ />
177
+ </I18nProvider>,
178
+ );
179
+ fireEvent.submit(screen.getByRole('form'));
180
+ for (const text of [
181
+ 'Explicit title',
182
+ 'Explicit description',
183
+ 'Explicit eyebrow',
184
+ 'Explicit field',
185
+ 'Explicit minimum 8',
186
+ 'Explicit terms',
187
+ ])
188
+ expect(screen.getByText(text)).toBeVisible();
189
+ rerender(
190
+ <I18nProvider locale={locale}>
191
+ <SignUpForm labels={labels} policyLoading />
192
+ </I18nProvider>,
193
+ );
194
+ expect(screen.getByRole('status')).toHaveTextContent(labels.policyLoading);
195
+ });
196
+ it('freezes every original English message', () => {
197
+ expect(en['signUp.eyebrow']).toBe('Get started');
198
+ expect(en['signUp.title']).toBe('Create your account');
199
+ expect(en['signUp.description']).toBe('Set up a workspace for your team in a couple of minutes.');
200
+ expect(en['signUp.name']).toBe('Full name');
201
+ expect(en['signUp.namePlaceholder']).toBe('Avery Collins');
202
+ expect(en['signUp.nameRequired']).toBe('Enter your name.');
203
+ expect(en['signUp.email']).toBe('Work email');
204
+ expect(en['signUp.emailPlaceholder']).toBe('name@company.com');
205
+ expect(en['signUp.password']).toBe('Password');
206
+ expect(en['signUp.passwordTooShort']).toBe('Use at least {minimum} characters.');
207
+ expect(en['signUp.termsRequired']).toBe('Accept the terms to continue.');
208
+ expect(en['signUp.terms']).toBe('Terms');
209
+ expect(en['signUp.privacy']).toBe('Privacy Policy');
210
+ expect(en['signUp.termsConsent']).toBe('I agree to the {terms} and {privacy}.');
211
+ expect(en['signUp.submit']).toBe('Create account');
212
+ expect(en['signUp.divider']).toBe('Or sign up with');
213
+ expect(en['signUp.signInPrompt']).toBe('Already have an account?');
214
+ expect(en['signUp.signIn']).toBe('Sign in');
215
+ expect(en['signUp.policyLoading']).toBe('Loading sign-up policy\u2026');
216
+ expect(en['signUp.fallbackError']).toBe('The account could not be created.');
217
+ });