@terreno/ui 57.19.2 → 57.20.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 (295) hide show
  1. package/.ai/guidelines/core.md +1 -1
  2. package/CHANGELOG.md +393 -0
  3. package/dist/Accordion.d.ts.map +1 -1
  4. package/dist/Accordion.js +3 -3
  5. package/dist/Accordion.js.map +1 -1
  6. package/dist/Avatar.d.ts.map +1 -1
  7. package/dist/Avatar.js +3 -1
  8. package/dist/Avatar.js.map +1 -1
  9. package/dist/Box.d.ts.map +1 -1
  10. package/dist/Box.js +38 -2
  11. package/dist/Box.js.map +1 -1
  12. package/dist/Card.js +2 -2
  13. package/dist/Card.js.map +1 -1
  14. package/dist/Common.d.ts +120 -7
  15. package/dist/Common.d.ts.map +1 -1
  16. package/dist/Common.js.map +1 -1
  17. package/dist/ConsentFormScreen.d.ts +1 -1
  18. package/dist/ConsentFormScreen.d.ts.map +1 -1
  19. package/dist/ConsentFormScreen.js +13 -4
  20. package/dist/ConsentFormScreen.js.map +1 -1
  21. package/dist/DateTimeField.d.ts.map +1 -1
  22. package/dist/DateTimeField.js +5 -3
  23. package/dist/DateTimeField.js.map +1 -1
  24. package/dist/Field.d.ts.map +1 -1
  25. package/dist/Field.js +2 -0
  26. package/dist/Field.js.map +1 -1
  27. package/dist/FormContainer.d.ts +68 -0
  28. package/dist/FormContainer.d.ts.map +1 -0
  29. package/dist/FormContainer.js +79 -0
  30. package/dist/FormContainer.js.map +1 -0
  31. package/dist/GPTChat.d.ts.map +1 -1
  32. package/dist/GPTChat.js +2 -1
  33. package/dist/GPTChat.js.map +1 -1
  34. package/dist/Heading.d.ts +1 -1
  35. package/dist/Heading.d.ts.map +1 -1
  36. package/dist/Heading.js +5 -2
  37. package/dist/Heading.js.map +1 -1
  38. package/dist/Icon.d.ts +4 -0
  39. package/dist/Icon.d.ts.map +1 -1
  40. package/dist/Icon.js +43 -2
  41. package/dist/Icon.js.map +1 -1
  42. package/dist/LabeledCheckBox.d.ts +22 -0
  43. package/dist/LabeledCheckBox.d.ts.map +1 -0
  44. package/dist/LabeledCheckBox.js +30 -0
  45. package/dist/LabeledCheckBox.js.map +1 -0
  46. package/dist/ListDetailLayout.d.ts +36 -0
  47. package/dist/ListDetailLayout.d.ts.map +1 -0
  48. package/dist/ListDetailLayout.js +153 -0
  49. package/dist/ListDetailLayout.js.map +1 -0
  50. package/dist/MarkdownEditor.d.ts.map +1 -1
  51. package/dist/MarkdownEditor.js +2 -1
  52. package/dist/MarkdownEditor.js.map +1 -1
  53. package/dist/MediaQuery.d.ts +1 -1
  54. package/dist/MediaQuery.d.ts.map +1 -1
  55. package/dist/MediaQuery.js +1 -1
  56. package/dist/MediaQuery.js.map +1 -1
  57. package/dist/OtpField.d.ts +60 -0
  58. package/dist/OtpField.d.ts.map +1 -0
  59. package/dist/OtpField.js +154 -0
  60. package/dist/OtpField.js.map +1 -0
  61. package/dist/ProvisionalConsentSigner.d.ts +21 -0
  62. package/dist/ProvisionalConsentSigner.d.ts.map +1 -0
  63. package/dist/ProvisionalConsentSigner.js +199 -0
  64. package/dist/ProvisionalConsentSigner.js.map +1 -0
  65. package/dist/ResponsiveBreakpoint.d.ts +5 -0
  66. package/dist/ResponsiveBreakpoint.d.ts.map +1 -1
  67. package/dist/ResponsiveBreakpoint.js +7 -0
  68. package/dist/ResponsiveBreakpoint.js.map +1 -1
  69. package/dist/SocialLoginButton.d.ts +10 -0
  70. package/dist/SocialLoginButton.d.ts.map +1 -1
  71. package/dist/SocialLoginButton.js +26 -8
  72. package/dist/SocialLoginButton.js.map +1 -1
  73. package/dist/SplitPage.d.ts +11 -0
  74. package/dist/SplitPage.d.ts.map +1 -1
  75. package/dist/SplitPage.js +11 -5
  76. package/dist/SplitPage.js.map +1 -1
  77. package/dist/SplitPage.native.d.ts.map +1 -1
  78. package/dist/SplitPage.native.js +3 -1
  79. package/dist/SplitPage.native.js.map +1 -1
  80. package/dist/SyncStatusBanner.d.ts +7 -1
  81. package/dist/SyncStatusBanner.d.ts.map +1 -1
  82. package/dist/SyncStatusBanner.js +20 -4
  83. package/dist/SyncStatusBanner.js.map +1 -1
  84. package/dist/TextField.d.ts.map +1 -1
  85. package/dist/TextField.js +44 -10
  86. package/dist/TextField.js.map +1 -1
  87. package/dist/fieldElements/FieldError.d.ts.map +1 -1
  88. package/dist/fieldElements/FieldError.js +1 -1
  89. package/dist/fieldElements/FieldError.js.map +1 -1
  90. package/dist/index.d.ts +19 -3
  91. package/dist/index.d.ts.map +1 -1
  92. package/dist/index.js +14 -1
  93. package/dist/index.js.map +1 -1
  94. package/dist/lazyBoundaries/heavyOptionalExports.d.ts +3 -0
  95. package/dist/lazyBoundaries/heavyOptionalExports.d.ts.map +1 -1
  96. package/dist/lazyBoundaries/heavyOptionalExports.js +2 -0
  97. package/dist/lazyBoundaries/heavyOptionalExports.js.map +1 -1
  98. package/dist/login/LastUsedBadge.d.ts +14 -0
  99. package/dist/login/LastUsedBadge.d.ts.map +1 -0
  100. package/dist/login/LastUsedBadge.js +23 -0
  101. package/dist/login/LastUsedBadge.js.map +1 -0
  102. package/dist/login/LoginAccountCard.d.ts +38 -0
  103. package/dist/login/LoginAccountCard.d.ts.map +1 -0
  104. package/dist/login/LoginAccountCard.js +72 -0
  105. package/dist/login/LoginAccountCard.js.map +1 -0
  106. package/dist/login/LoginAccountList.d.ts +33 -0
  107. package/dist/login/LoginAccountList.d.ts.map +1 -0
  108. package/dist/login/LoginAccountList.js +30 -0
  109. package/dist/login/LoginAccountList.js.map +1 -0
  110. package/dist/login/LoginScreen.d.ts +4 -4
  111. package/dist/login/LoginScreen.d.ts.map +1 -1
  112. package/dist/login/LoginScreen.js +294 -13
  113. package/dist/login/LoginScreen.js.map +1 -1
  114. package/dist/login/OutlinePill.d.ts +28 -0
  115. package/dist/login/OutlinePill.d.ts.map +1 -0
  116. package/dist/login/OutlinePill.js +48 -0
  117. package/dist/login/OutlinePill.js.map +1 -0
  118. package/dist/login/TwoFactorChallengeScreen.d.ts +26 -0
  119. package/dist/login/TwoFactorChallengeScreen.d.ts.map +1 -0
  120. package/dist/login/TwoFactorChallengeScreen.js +139 -0
  121. package/dist/login/TwoFactorChallengeScreen.js.map +1 -0
  122. package/dist/login/loginMethods.d.ts +27 -0
  123. package/dist/login/loginMethods.d.ts.map +1 -0
  124. package/dist/login/loginMethods.js +37 -0
  125. package/dist/login/loginMethods.js.map +1 -0
  126. package/dist/login/loginTypes.d.ts +202 -5
  127. package/dist/login/loginTypes.d.ts.map +1 -1
  128. package/dist/pdfHtmlTemplate.d.ts +17 -0
  129. package/dist/pdfHtmlTemplate.d.ts.map +1 -1
  130. package/dist/pdfHtmlTemplate.js +78 -0
  131. package/dist/pdfHtmlTemplate.js.map +1 -1
  132. package/dist/security/AccountSecurityScreen.d.ts +10 -0
  133. package/dist/security/AccountSecurityScreen.d.ts.map +1 -0
  134. package/dist/security/AccountSecurityScreen.js +50 -0
  135. package/dist/security/AccountSecurityScreen.js.map +1 -0
  136. package/dist/security/LinkedAccountsCard.d.ts +32 -0
  137. package/dist/security/LinkedAccountsCard.d.ts.map +1 -0
  138. package/dist/security/LinkedAccountsCard.js +145 -0
  139. package/dist/security/LinkedAccountsCard.js.map +1 -0
  140. package/dist/security/PasskeysCard.d.ts +39 -0
  141. package/dist/security/PasskeysCard.d.ts.map +1 -0
  142. package/dist/security/PasskeysCard.js +168 -0
  143. package/dist/security/PasskeysCard.js.map +1 -0
  144. package/dist/security/PasswordCard.d.ts +32 -0
  145. package/dist/security/PasswordCard.d.ts.map +1 -0
  146. package/dist/security/PasswordCard.js +198 -0
  147. package/dist/security/PasswordCard.js.map +1 -0
  148. package/dist/security/SessionsCard.d.ts +39 -0
  149. package/dist/security/SessionsCard.d.ts.map +1 -0
  150. package/dist/security/SessionsCard.js +168 -0
  151. package/dist/security/SessionsCard.js.map +1 -0
  152. package/dist/security/TwoFactorSettingsCard.d.ts +55 -0
  153. package/dist/security/TwoFactorSettingsCard.d.ts.map +1 -0
  154. package/dist/security/TwoFactorSettingsCard.js +458 -0
  155. package/dist/security/TwoFactorSettingsCard.js.map +1 -0
  156. package/dist/security/securityMethods.d.ts +40 -0
  157. package/dist/security/securityMethods.d.ts.map +1 -0
  158. package/dist/security/securityMethods.js +66 -0
  159. package/dist/security/securityMethods.js.map +1 -0
  160. package/dist/security/securityTypes.d.ts +467 -0
  161. package/dist/security/securityTypes.d.ts.map +1 -0
  162. package/dist/security/securityTypes.js +2 -0
  163. package/dist/security/securityTypes.js.map +1 -0
  164. package/dist/security/userAgent.d.ts +26 -0
  165. package/dist/security/userAgent.d.ts.map +1 -0
  166. package/dist/security/userAgent.js +80 -0
  167. package/dist/security/userAgent.js.map +1 -0
  168. package/dist/signUp/OAuthButtons.d.ts +28 -5
  169. package/dist/signUp/OAuthButtons.d.ts.map +1 -1
  170. package/dist/signUp/OAuthButtons.js +44 -5
  171. package/dist/signUp/OAuthButtons.js.map +1 -1
  172. package/dist/signUp/SignUpScreen.d.ts.map +1 -1
  173. package/dist/signUp/SignUpScreen.js +50 -5
  174. package/dist/signUp/SignUpScreen.js.map +1 -1
  175. package/dist/signUp/signUpTypes.d.ts +21 -1
  176. package/dist/signUp/signUpTypes.d.ts.map +1 -1
  177. package/dist/useConsentForms.d.ts +9 -0
  178. package/dist/useConsentForms.d.ts.map +1 -1
  179. package/dist/useConsentForms.js +18 -0
  180. package/dist/useConsentForms.js.map +1 -1
  181. package/dist/useProvisionalConsent.d.ts +124 -0
  182. package/dist/useProvisionalConsent.d.ts.map +1 -0
  183. package/dist/useProvisionalConsent.js +79 -0
  184. package/dist/useProvisionalConsent.js.map +1 -0
  185. package/package.json +3 -2
  186. package/src/Accordion.test.tsx +5 -0
  187. package/src/Accordion.tsx +3 -8
  188. package/src/AreaChart.test.tsx +15 -0
  189. package/src/Avatar.test.tsx +8 -0
  190. package/src/Avatar.tsx +2 -0
  191. package/src/BarChart.test.tsx +15 -0
  192. package/src/Box.test.tsx +61 -1
  193. package/src/Box.tsx +44 -2
  194. package/src/Card.tsx +2 -2
  195. package/src/Common.ts +134 -7
  196. package/src/ConsentFormScreen.test.tsx +84 -0
  197. package/src/ConsentFormScreen.tsx +28 -4
  198. package/src/DateTimeField.tsx +5 -3
  199. package/src/DonutChart.test.tsx +15 -0
  200. package/src/Field.tsx +2 -0
  201. package/src/FilePickerButton.test.tsx +35 -0
  202. package/src/FormContainer.test.tsx +242 -0
  203. package/src/FormContainer.tsx +177 -0
  204. package/src/GPTChat.test.tsx +16 -0
  205. package/src/GPTChat.tsx +8 -2
  206. package/src/Heading.test.tsx +14 -0
  207. package/src/Heading.tsx +6 -1
  208. package/src/Icon.test.tsx +52 -1
  209. package/src/Icon.tsx +92 -3
  210. package/src/IconButton.test.tsx +85 -0
  211. package/src/LabeledCheckBox.test.tsx +45 -0
  212. package/src/LabeledCheckBox.tsx +89 -0
  213. package/src/ListDetailLayout.tsx +247 -0
  214. package/src/MarkdownEditor.tsx +2 -1
  215. package/src/MediaQuery.ts +1 -0
  216. package/src/OtpField.test.tsx +280 -0
  217. package/src/OtpField.tsx +307 -0
  218. package/src/ProvisionalConsentSigner.test.tsx +625 -0
  219. package/src/ProvisionalConsentSigner.tsx +423 -0
  220. package/src/ResponsiveBreakpoint.test.tsx +7 -0
  221. package/src/ResponsiveBreakpoint.tsx +14 -0
  222. package/src/RootImportRegression.test.tsx +3 -0
  223. package/src/SocialLoginButton.test.tsx +14 -0
  224. package/src/SocialLoginButton.tsx +51 -7
  225. package/src/SplitPage.native.tsx +3 -1
  226. package/src/SplitPage.tsx +11 -5
  227. package/src/SyncStatusBanner.test.tsx +61 -4
  228. package/src/SyncStatusBanner.tsx +29 -3
  229. package/src/TextField.test.tsx +150 -0
  230. package/src/TextField.tsx +66 -8
  231. package/src/__snapshots__/AddressField.test.tsx.snap +12 -0
  232. package/src/__snapshots__/AiSuggestionBox.test.tsx.snap +15 -0
  233. package/src/__snapshots__/Avatar.test.tsx.snap +1 -0
  234. package/src/__snapshots__/CustomSelectField.test.tsx.snap +3 -0
  235. package/src/__snapshots__/EmailField.test.tsx.snap +6 -0
  236. package/src/__snapshots__/Field.test.tsx.snap +37 -0
  237. package/src/__snapshots__/HeightField.test.tsx.snap +2 -0
  238. package/src/__snapshots__/MobileAddressAutoComplete.test.tsx.snap +3 -0
  239. package/src/__snapshots__/NumberField.test.tsx.snap +3 -0
  240. package/src/__snapshots__/PhoneNumberField.test.tsx.snap +12 -0
  241. package/src/__snapshots__/Slider.test.tsx.snap +1 -0
  242. package/src/__snapshots__/SocialLoginButton.test.tsx.snap +43 -22
  243. package/src/__snapshots__/TapToEdit.test.tsx.snap +3 -0
  244. package/src/__snapshots__/TextArea.test.tsx.snap +17 -1
  245. package/src/__snapshots__/TextField.test.tsx.snap +19 -2
  246. package/src/__snapshots__/TypedSignatureField.test.tsx.snap +3 -0
  247. package/src/__snapshots__/UnifiedAddressAutoComplete.test.tsx.snap +18 -0
  248. package/src/__snapshots__/WebAddressAutocomplete.test.tsx.snap +12 -0
  249. package/src/bunSetup.ts +13 -1
  250. package/src/fieldElements/FieldError.tsx +1 -0
  251. package/src/fieldElements/__snapshots__/FieldError.test.tsx.snap +2 -0
  252. package/src/index.tsx +42 -1
  253. package/src/isolated/ListDetailLayout.isolated.tsx +634 -0
  254. package/src/lazyBoundaries/heavyOptionalExports.tsx +7 -0
  255. package/src/login/LastUsedBadge.tsx +40 -0
  256. package/src/login/LoginAccountCard.tsx +205 -0
  257. package/src/login/LoginAccountList.tsx +115 -0
  258. package/src/login/LoginScreen.test.tsx +837 -1
  259. package/src/login/LoginScreen.tsx +674 -91
  260. package/src/login/OutlinePill.tsx +110 -0
  261. package/src/login/TwoFactorChallengeScreen.test.tsx +376 -0
  262. package/src/login/TwoFactorChallengeScreen.tsx +307 -0
  263. package/src/login/__snapshots__/LoginScreen.test.tsx.snap +1454 -334
  264. package/src/login/loginMethods.test.ts +53 -0
  265. package/src/login/loginMethods.ts +60 -0
  266. package/src/login/loginTypes.ts +208 -5
  267. package/src/pdfHtmlTemplate.test.ts +243 -4
  268. package/src/pdfHtmlTemplate.ts +93 -0
  269. package/src/security/AccountSecurityScreen.test.tsx +262 -0
  270. package/src/security/AccountSecurityScreen.tsx +156 -0
  271. package/src/security/LinkedAccountsCard.test.tsx +371 -0
  272. package/src/security/LinkedAccountsCard.tsx +297 -0
  273. package/src/security/PasskeysCard.test.tsx +378 -0
  274. package/src/security/PasskeysCard.tsx +371 -0
  275. package/src/security/PasswordCard.test.tsx +445 -0
  276. package/src/security/PasswordCard.tsx +342 -0
  277. package/src/security/SessionsCard.test.tsx +349 -0
  278. package/src/security/SessionsCard.tsx +362 -0
  279. package/src/security/TwoFactorSettingsCard.test.tsx +700 -0
  280. package/src/security/TwoFactorSettingsCard.tsx +872 -0
  281. package/src/security/securityMethods.test.ts +101 -0
  282. package/src/security/securityMethods.ts +104 -0
  283. package/src/security/securityTypes.ts +480 -0
  284. package/src/security/userAgent.test.ts +119 -0
  285. package/src/security/userAgent.ts +102 -0
  286. package/src/signUp/OAuthButtons.test.tsx +27 -0
  287. package/src/signUp/OAuthButtons.tsx +153 -19
  288. package/src/signUp/SignUpScreen.test.tsx +170 -1
  289. package/src/signUp/SignUpScreen.tsx +87 -25
  290. package/src/signUp/__snapshots__/SignUpScreen.test.tsx.snap +22 -11
  291. package/src/signUp/signUpTypes.ts +23 -1
  292. package/src/useConsentForms.test.ts +37 -1
  293. package/src/useConsentForms.ts +25 -0
  294. package/src/useProvisionalConsent.test.ts +256 -0
  295. package/src/useProvisionalConsent.ts +218 -0
@@ -0,0 +1,423 @@
1
+ import {DateTime} from "luxon";
2
+ import type React from "react";
3
+ import {useCallback, useState} from "react";
4
+
5
+ import {Badge} from "./Badge";
6
+ import {Box} from "./Box";
7
+ import {Button} from "./Button";
8
+ import {Card} from "./Card";
9
+ import type {BadgeProps} from "./Common";
10
+ import {Heading} from "./Heading";
11
+ import {MarkdownView} from "./MarkdownView";
12
+ import {Modal} from "./Modal";
13
+ import {buildConsentPdfHtml, printConsentHtml} from "./pdfHtmlTemplate";
14
+ import {Spinner} from "./Spinner";
15
+ import {Text} from "./Text";
16
+ import {TextField} from "./TextField";
17
+ import {applyConsentVariables, detectLocale, resolveConsentLocale} from "./useConsentForms";
18
+ import {
19
+ type ProvisionalConsentResponse,
20
+ type ProvisionalConsentStatusRow,
21
+ provisionalSignerName,
22
+ useProvisionalConsent,
23
+ } from "./useProvisionalConsent";
24
+
25
+ export interface ProvisionalConsentSignerProps {
26
+ /** The consumer's RTK Query api, as passed to `ConsentNavigator`. */
27
+ api: unknown;
28
+ baseUrl?: string;
29
+ /** The user whose consent forms are listed and signed on their behalf. */
30
+ userId: string;
31
+ /** Called with the stored response after a provisional signature succeeds. */
32
+ onSigned?: (response: ProvisionalConsentResponse) => void;
33
+ /** Called with the server error when signing fails. */
34
+ onError?: (error: unknown) => void;
35
+ /** Values for `{{name}}` placeholders in form content. */
36
+ variables?: Record<string, string>;
37
+ }
38
+
39
+ interface SignedSummary {
40
+ formId: string;
41
+ formTitle: string;
42
+ signerName: string;
43
+ signedAt: string;
44
+ /** The just-signed form as a provisional row, for printing before statuses refetch. */
45
+ row: ProvisionalConsentStatusRow;
46
+ }
47
+
48
+ const STATUS_BADGE: Record<ProvisionalConsentStatusRow["status"], BadgeProps["status"]> = {
49
+ declined: "error",
50
+ pending: "warning",
51
+ provisional: "info",
52
+ signed: "success",
53
+ };
54
+
55
+ /** " on <date>", or nothing when the date is missing or unparseable. */
56
+ const onDate = (iso?: string): string => {
57
+ const date = iso ? DateTime.fromISO(iso) : undefined;
58
+ if (!date?.isValid) {
59
+ return "";
60
+ }
61
+ return ` on ${date.toLocaleString(DateTime.DATETIME_MED)}`;
62
+ };
63
+
64
+ /** The status line for a row, e.g. "Signed provisionally by Dana Rivera on Oct 20, 2026, 3:30 PM". */
65
+ const provisionalConsentStatusLabel = (row: ProvisionalConsentStatusRow): string => {
66
+ if (row.status === "provisional") {
67
+ const signerName = provisionalSignerName(row.provisional?.signedBy);
68
+ return `Signed provisionally by ${signerName}${onDate(row.provisional?.signedAt)}`;
69
+ }
70
+ if (row.status === "signed") {
71
+ return `Signed by user${onDate(row.respondedAt)}`;
72
+ }
73
+ if (row.status === "declined") {
74
+ return `Declined by user${onDate(row.respondedAt)}`;
75
+ }
76
+ return "Pending";
77
+ };
78
+
79
+ const errorMessage = (error: unknown, fallback: string): string => {
80
+ const title = (error as {data?: {title?: unknown}} | undefined)?.data?.title;
81
+ if (typeof title === "string" && title.length > 0) {
82
+ return title;
83
+ }
84
+ return fallback;
85
+ };
86
+
87
+ // Only pending forms can be signed on the user's behalf: the user's own answer always decides
88
+ // the status, so a provisional signature on a declined form would change nothing.
89
+ const CAN_SIGN_STATUSES = new Set<ProvisionalConsentStatusRow["status"]>(["pending"]);
90
+
91
+ const contentFor = (
92
+ row: ProvisionalConsentStatusRow,
93
+ variables?: Record<string, string>
94
+ ): string => {
95
+ const locale = resolveConsentLocale(row.form, detectLocale());
96
+ return applyConsentVariables(
97
+ row.form.content[locale] ?? row.form.content[row.form.defaultLocale] ?? "",
98
+ variables
99
+ );
100
+ };
101
+
102
+ /** Printable HTML for a row: the form content, its status, and any provisional signature. */
103
+ const rowPrintHtml = (
104
+ row: ProvisionalConsentStatusRow,
105
+ variables?: Record<string, string>
106
+ ): string => {
107
+ return buildConsentPdfHtml({
108
+ contentSnapshot: contentFor(row, variables),
109
+ fields: [
110
+ {label: "Status:", value: provisionalConsentStatusLabel(row)},
111
+ {label: "Form Version:", value: String(row.form.version)},
112
+ ],
113
+ formTitle: row.form.title,
114
+ provisionalSignature: row.provisional
115
+ ? {
116
+ note: row.provisional.note,
117
+ signedAt: row.provisional.signedAt,
118
+ signedByName: provisionalSignerName(row.provisional.signedBy),
119
+ }
120
+ : undefined,
121
+ responseId: row.provisional?.responseId,
122
+ title: "Consent Record",
123
+ });
124
+ };
125
+
126
+ const printRow = async (
127
+ row: ProvisionalConsentStatusRow,
128
+ variables?: Record<string, string>
129
+ ): Promise<void> => {
130
+ try {
131
+ await printConsentHtml({html: rowPrintHtml(row, variables)});
132
+ } catch (printError) {
133
+ console.warn("[ProvisionalConsentSigner] Printing failed", {printError});
134
+ }
135
+ };
136
+
137
+ const rowFormId = (row: ProvisionalConsentStatusRow): string => row.form.id ?? row.form._id ?? "";
138
+
139
+ /**
140
+ * Lists a user's consent forms with their status so staff can record consent on the user's
141
+ * behalf. Requires `consentResponse:signOnBehalf` (or `user.admin` without RBAC) on the server.
142
+ */
143
+ export const ProvisionalConsentSigner: React.FC<ProvisionalConsentSignerProps> = ({
144
+ api,
145
+ baseUrl,
146
+ userId,
147
+ onSigned,
148
+ onError,
149
+ variables,
150
+ }) => {
151
+ const {error, isLoading, isSigning, isVoiding, refetch, sign, statuses, voidSignature} =
152
+ useProvisionalConsent({
153
+ api,
154
+ baseUrl,
155
+ userId,
156
+ });
157
+ const [openFormId, setOpenFormId] = useState<string | null>(null);
158
+ const [note, setNote] = useState("");
159
+ const [submitError, setSubmitError] = useState<string | null>(null);
160
+ const [signed, setSigned] = useState<SignedSummary | null>(null);
161
+ const [voidRow, setVoidRow] = useState<ProvisionalConsentStatusRow | null>(null);
162
+ const [voidReason, setVoidReason] = useState("");
163
+ const [voidError, setVoidError] = useState<string | null>(null);
164
+
165
+ const openRow = statuses.find((row) => rowFormId(row) === openFormId);
166
+ const locale = openRow ? resolveConsentLocale(openRow.form, detectLocale()) : undefined;
167
+ const isNoteBlank = note.trim().length === 0;
168
+
169
+ const handleOpen = useCallback((formId: string): void => {
170
+ setOpenFormId(formId);
171
+ setNote("");
172
+ setSubmitError(null);
173
+ setSigned(null);
174
+ }, []);
175
+
176
+ const handleCancel = useCallback((): void => {
177
+ setOpenFormId(null);
178
+ setSubmitError(null);
179
+ }, []);
180
+
181
+ const handleSubmit = useCallback(async (): Promise<void> => {
182
+ if (!openRow || isNoteBlank) {
183
+ return;
184
+ }
185
+ setSubmitError(null);
186
+ try {
187
+ const response = await sign({consentFormId: rowFormId(openRow), locale, note: note.trim()});
188
+ const signerName = provisionalSignerName(response.provisionalSignedBy);
189
+ setSigned({
190
+ formId: rowFormId(openRow),
191
+ formTitle: openRow.form.title,
192
+ row: {
193
+ form: openRow.form,
194
+ isConsented: true,
195
+ provisional: {
196
+ note: response.provisionalNote ?? note.trim(),
197
+ responseId: response._id,
198
+ signedAt: response.agreedAt,
199
+ signedBy: {id: "", name: signerName},
200
+ },
201
+ respondedAt: response.agreedAt,
202
+ status: "provisional",
203
+ },
204
+ signedAt: response.agreedAt,
205
+ signerName,
206
+ });
207
+ setOpenFormId(null);
208
+ setNote("");
209
+ onSigned?.(response);
210
+ } catch (signError) {
211
+ console.warn("[ProvisionalConsentSigner] Provisional signature failed", {signError});
212
+ setSubmitError(errorMessage(signError, "Could not sign the form."));
213
+ onError?.(signError);
214
+ }
215
+ }, [isNoteBlank, locale, note, onError, onSigned, openRow, sign]);
216
+
217
+ const handleOpenVoid = useCallback((row: ProvisionalConsentStatusRow): void => {
218
+ setVoidRow(row);
219
+ setVoidReason("");
220
+ setVoidError(null);
221
+ }, []);
222
+
223
+ const handleCloseVoid = useCallback((): void => {
224
+ setVoidRow(null);
225
+ setVoidError(null);
226
+ }, []);
227
+
228
+ const handleVoid = useCallback(async (): Promise<void> => {
229
+ const responseId = voidRow?.provisional?.responseId;
230
+ if (!responseId || voidReason.trim().length === 0) {
231
+ return;
232
+ }
233
+ setVoidError(null);
234
+ try {
235
+ await voidSignature({reason: voidReason.trim(), responseId});
236
+ } catch (voidFailure) {
237
+ console.warn("[ProvisionalConsentSigner] Voiding failed", {voidFailure});
238
+ setVoidError(errorMessage(voidFailure, "Could not void the signature."));
239
+ onError?.(voidFailure);
240
+ return;
241
+ }
242
+ setVoidRow(null);
243
+ setSigned(null);
244
+ await refetch();
245
+ }, [onError, refetch, voidReason, voidRow, voidSignature]);
246
+
247
+ if (isLoading) {
248
+ return (
249
+ <Box alignItems="center" padding={4} testID="provisional-consent-signer">
250
+ <Box testID="provisional-consent-loading">
251
+ <Spinner />
252
+ </Box>
253
+ </Box>
254
+ );
255
+ }
256
+
257
+ if (error) {
258
+ return (
259
+ <Box gap={3} padding={4} testID="provisional-consent-signer">
260
+ <Box testID="provisional-consent-error">
261
+ <Text color="error">{errorMessage(error, "Could not load consent forms.")}</Text>
262
+ </Box>
263
+ <Box width={160}>
264
+ <Button
265
+ onClick={() => refetch()}
266
+ testID="provisional-consent-retry-button"
267
+ text="Retry"
268
+ variant="outline"
269
+ />
270
+ </Box>
271
+ </Box>
272
+ );
273
+ }
274
+
275
+ if (openRow) {
276
+ const content = contentFor(openRow, variables);
277
+ return (
278
+ <Box gap={3} testID="provisional-consent-signer">
279
+ <Heading size="md">{openRow.form.title}</Heading>
280
+ <Card testID="provisional-consent-form-content">
281
+ <MarkdownView>{content}</MarkdownView>
282
+ </Card>
283
+ <TextField
284
+ helperText="Required. How and from whom consent was obtained."
285
+ multiline
286
+ onChange={setNote}
287
+ rows={4}
288
+ testID="provisional-consent-note-input"
289
+ title="Note"
290
+ value={note}
291
+ />
292
+ {Boolean(submitError) && (
293
+ <Text color="error" testID="provisional-consent-submit-error">
294
+ {submitError}
295
+ </Text>
296
+ )}
297
+ <Box direction="row" gap={3}>
298
+ <Button
299
+ disabled={isNoteBlank}
300
+ loading={isSigning}
301
+ onClick={handleSubmit}
302
+ testID="provisional-consent-submit-button"
303
+ text="Sign provisionally"
304
+ />
305
+ <Button
306
+ onClick={handleCancel}
307
+ testID="provisional-consent-cancel-button"
308
+ text="Cancel"
309
+ variant="muted"
310
+ />
311
+ </Box>
312
+ </Box>
313
+ );
314
+ }
315
+
316
+ return (
317
+ <Box gap={3} testID="provisional-consent-signer">
318
+ {signed && (
319
+ <Card testID="provisional-consent-success">
320
+ <Box gap={2}>
321
+ <Text>
322
+ {`${signed.formTitle} signed provisionally by ${signed.signerName}${onDate(
323
+ signed.signedAt
324
+ )}`}
325
+ </Text>
326
+ <Box alignSelf="start">
327
+ <Button
328
+ iconName="print"
329
+ onClick={() => printRow(signed.row, variables)}
330
+ testID="provisional-consent-success-print"
331
+ text="Print"
332
+ variant="outline"
333
+ />
334
+ </Box>
335
+ </Box>
336
+ </Card>
337
+ )}
338
+ {statuses.length === 0 && (
339
+ <Text color="secondaryDark" testID="provisional-consent-empty">
340
+ No consent forms apply to this user.
341
+ </Text>
342
+ )}
343
+ {statuses.map((row) => {
344
+ const formId = rowFormId(row);
345
+ return (
346
+ <Card key={formId} testID={`provisional-consent-row-${formId}`}>
347
+ <Box gap={2}>
348
+ <Heading size="sm">{row.form.title}</Heading>
349
+ <Box alignSelf="start">
350
+ <Badge
351
+ status={STATUS_BADGE[row.status]}
352
+ testID={`provisional-consent-status-${formId}`}
353
+ value={provisionalConsentStatusLabel(row)}
354
+ />
355
+ </Box>
356
+ <Box direction="row" gap={2} wrap>
357
+ {CAN_SIGN_STATUSES.has(row.status) && (
358
+ <Button
359
+ onClick={() => handleOpen(formId)}
360
+ testID={`provisional-consent-open-${formId}`}
361
+ text="Sign on behalf"
362
+ variant="outline"
363
+ />
364
+ )}
365
+ {row.status !== "pending" && (
366
+ <Button
367
+ iconName="print"
368
+ onClick={() => printRow(row, variables)}
369
+ testID={`provisional-consent-print-${formId}`}
370
+ text="Print"
371
+ variant="outline"
372
+ />
373
+ )}
374
+ {row.status === "provisional" && (
375
+ <Button
376
+ onClick={() => handleOpenVoid(row)}
377
+ testID={`provisional-consent-void-${formId}`}
378
+ text="Void"
379
+ variant="destructive"
380
+ />
381
+ )}
382
+ </Box>
383
+ </Box>
384
+ </Card>
385
+ );
386
+ })}
387
+ <Modal
388
+ onDismiss={handleCloseVoid}
389
+ primaryButtonDisabled={voidReason.trim().length === 0 || isVoiding}
390
+ primaryButtonOnClick={handleVoid}
391
+ primaryButtonText="Void signature"
392
+ secondaryButtonOnClick={handleCloseVoid}
393
+ secondaryButtonText="Cancel"
394
+ size="md"
395
+ testID="provisional-consent-void-modal"
396
+ text={
397
+ voidRow
398
+ ? `The provisional signature on ${voidRow.form.title} will no longer count as consent. The record is kept.`
399
+ : undefined
400
+ }
401
+ title="Void provisional signature"
402
+ visible={Boolean(voidRow)}
403
+ >
404
+ <Box gap={2}>
405
+ <TextField
406
+ helperText="Required. Why this signature was made in error."
407
+ multiline
408
+ onChange={setVoidReason}
409
+ rows={3}
410
+ testID="provisional-consent-void-reason-input"
411
+ title="Reason"
412
+ value={voidReason}
413
+ />
414
+ {Boolean(voidError) && (
415
+ <Text color="error" testID="provisional-consent-void-error">
416
+ {voidError}
417
+ </Text>
418
+ )}
419
+ </Box>
420
+ </Modal>
421
+ </Box>
422
+ );
423
+ };
@@ -11,6 +11,7 @@ import {
11
11
  getBreakpointForWidth,
12
12
  isBreakpointAtLeast,
13
13
  isSupportedDesktopViewport,
14
+ isSupportedDesktopWidth,
14
15
  type ResponsiveBreakpointStore,
15
16
  useResponsiveBreakpoint,
16
17
  } from "./ResponsiveBreakpoint";
@@ -61,6 +62,12 @@ describe("ResponsiveBreakpoint", () => {
61
62
  assert.isTrue(isSupportedDesktopViewport({breakpoint: "xl", surface: "native"}));
62
63
  assert.isFalse(isSupportedDesktopViewport({breakpoint: "md", surface: "web"}));
63
64
  assert.isTrue(isSupportedDesktopViewport({breakpoint: "lg", surface: "web"}));
65
+ assert.isFalse(isSupportedDesktopWidth({surface: "web", width: 768}));
66
+ assert.isFalse(isSupportedDesktopWidth({surface: "native", width: 768}));
67
+ assert.isFalse(isSupportedDesktopWidth({surface: "web", width: 1023}));
68
+ assert.isTrue(isSupportedDesktopWidth({surface: "web", width: 1024}));
69
+ assert.isFalse(isSupportedDesktopWidth({surface: "native", width: 1023}));
70
+ assert.isTrue(isSupportedDesktopWidth({surface: "native", width: 1024}));
64
71
  });
65
72
 
66
73
  it("compares breakpoints without reading Dimensions", () => {
@@ -116,6 +116,20 @@ export const isSupportedDesktopViewport = ({
116
116
  return isBreakpointAtLeast({breakpoint, minimum: "xl"});
117
117
  };
118
118
 
119
+ /** True when `width` is at or above the desktop floor for `surface` (web `lg`, native `xl`). */
120
+ export const isSupportedDesktopWidth = ({
121
+ surface = getBreakpointSurface(),
122
+ width,
123
+ }: {
124
+ surface?: BreakpointSurface;
125
+ width: number;
126
+ }): boolean => {
127
+ return isSupportedDesktopViewport({
128
+ breakpoint: getBreakpointForWidth(width, surface),
129
+ surface,
130
+ });
131
+ };
132
+
119
133
  const getServerBreakpointSnapshot = (): ResponsiveBreakpoint => {
120
134
  return "xs";
121
135
  };
@@ -11,6 +11,7 @@ import {
11
11
  GPTChat,
12
12
  LineChart,
13
13
  MarkdownEditor,
14
+ ProvisionalConsentSigner,
14
15
  } from "@terreno/ui";
15
16
  import {Box} from "@terreno/ui/Box";
16
17
  import EmojiSelectorSubpath from "@terreno/ui/EmojiSelector";
@@ -58,11 +59,13 @@ describe("root import compatibility", () => {
58
59
  expect(modulePaths.includes("/AreaChart.tsx")).toBe(false);
59
60
  expect(modulePaths.includes("/DonutChart.tsx")).toBe(false);
60
61
  expect(modulePaths.includes("/DashboardGrid.tsx")).toBe(true);
62
+ expect(modulePaths.includes("/ProvisionalConsentSigner.tsx")).toBe(false);
61
63
  });
62
64
 
63
65
  it("exposes lazy root exports for measured heavy optional widgets", () => {
64
66
  expect(AIRequestExplorer).toBeTruthy();
65
67
  expect(ConsentNavigator).toBeTruthy();
68
+ expect(ProvisionalConsentSigner).toBeTruthy();
66
69
  expect(DraggableList).toBeTruthy();
67
70
  expect(EmojiSelector).toBeTruthy();
68
71
  expect(GPTChat).toBeTruthy();
@@ -98,6 +98,20 @@ describe("SocialLoginButton", () => {
98
98
  expect(button.props.disabled).toBe(true);
99
99
  });
100
100
 
101
+ it("follows later changes to the loading prop", () => {
102
+ const onPress = createMockOnPress();
103
+ const {getByTestId, rerender} = renderWithTheme(
104
+ <SocialLoginButton onPress={onPress} provider="google" />
105
+ );
106
+ expect(getByTestId("social-login-google").props.disabled).toBeFalsy();
107
+
108
+ rerender(<SocialLoginButton loading onPress={onPress} provider="google" />);
109
+ expect(getByTestId("social-login-google").props.disabled).toBe(true);
110
+
111
+ rerender(<SocialLoginButton loading={false} onPress={onPress} provider="google" />);
112
+ expect(getByTestId("social-login-google").props.disabled).toBeFalsy();
113
+ });
114
+
101
115
  it("uses correct testID", () => {
102
116
  const onPress = createMockOnPress();
103
117
  const {getByTestId} = renderWithTheme(
@@ -5,6 +5,7 @@ import {ActivityIndicator, Pressable, Text, View} from "react-native";
5
5
 
6
6
  import {Box} from "./Box";
7
7
  import type {SocialLoginButtonProps} from "./Common";
8
+ import {OutlinePill} from "./login/OutlinePill";
8
9
  import {useTheme} from "./Theme";
9
10
  import {Unifier} from "./Unifier";
10
11
 
@@ -39,14 +40,26 @@ const PROVIDER_ICONS: Record<string, string> = {
39
40
  };
40
41
 
41
42
  /**
42
- * Display names for social providers
43
+ * Display names for the branded social providers.
43
44
  */
44
- const PROVIDER_NAMES: Record<string, string> = {
45
+ export const SOCIAL_PROVIDER_NAMES: Record<string, string> = {
45
46
  apple: "Apple",
46
47
  github: "GitHub",
47
48
  google: "Google",
48
49
  };
49
50
 
51
+ /**
52
+ * The display name of a branded provider id, or undefined for any other id. Ids come from the
53
+ * server and from device storage, so an id such as `__proto__` or `constructor` must not read an
54
+ * `Object.prototype` member.
55
+ */
56
+ export const getSocialProviderName = (providerId: string): string | undefined => {
57
+ if (!Object.hasOwn(SOCIAL_PROVIDER_NAMES, providerId)) {
58
+ return undefined;
59
+ }
60
+ return SOCIAL_PROVIDER_NAMES[providerId];
61
+ };
62
+
50
63
  /**
51
64
  * A branded social login button for OAuth authentication.
52
65
  *
@@ -64,6 +77,7 @@ const PROVIDER_NAMES: Record<string, string> = {
64
77
  * ```
65
78
  */
66
79
  export const SocialLoginButton: FC<SocialLoginButtonProps> = ({
80
+ accessibilityLabel,
67
81
  provider,
68
82
  onPress,
69
83
  loading: propsLoading,
@@ -72,8 +86,13 @@ export const SocialLoginButton: FC<SocialLoginButtonProps> = ({
72
86
  fullWidth = true,
73
87
  text,
74
88
  testID,
89
+ lastUsedLabel,
90
+ lastUsedTestID,
75
91
  }) => {
76
- const [loading, setLoading] = useState(propsLoading);
92
+ // Pressing tracks the button's own onPress; the parent's `loading` prop is read on every render
93
+ // so a parent can start or clear the spinner after mount.
94
+ const [isPressing, setIsPressing] = useState(false);
95
+ const loading = isPressing || propsLoading;
77
96
  const {theme} = useTheme();
78
97
  const resolvedTestID = testID ?? `social-login-${provider}`;
79
98
 
@@ -96,7 +115,7 @@ export const SocialLoginButton: FC<SocialLoginButtonProps> = ({
96
115
  }, [provider, variant, theme]);
97
116
 
98
117
  const iconName = PROVIDER_ICONS[provider];
99
- const providerName = PROVIDER_NAMES[provider];
118
+ const providerName = SOCIAL_PROVIDER_NAMES[provider];
100
119
  const buttonText = text ?? `Continue with ${providerName}`;
101
120
 
102
121
  const handlePress = useMemo(
@@ -104,14 +123,14 @@ export const SocialLoginButton: FC<SocialLoginButtonProps> = ({
104
123
  debounce(
105
124
  async () => {
106
125
  await Unifier.utils.haptic();
107
- setLoading(true);
126
+ setIsPressing(true);
108
127
 
109
128
  try {
110
129
  await onPress();
111
130
  } catch (error) {
112
131
  console.error(`Social login error (${provider}):`, error);
113
132
  } finally {
114
- setLoading(false);
133
+ setIsPressing(false);
115
134
  }
116
135
  },
117
136
  500,
@@ -126,10 +145,35 @@ export const SocialLoginButton: FC<SocialLoginButtonProps> = ({
126
145
 
127
146
  const isDisabled = disabled || loading;
128
147
 
148
+ if (variant === "outline") {
149
+ return (
150
+ <OutlinePill
151
+ accessibilityLabel={accessibilityLabel ?? buttonText}
152
+ disabled={disabled}
153
+ icon={
154
+ iconName ? (
155
+ <FontAwesome6
156
+ brand
157
+ color={isDisabled ? theme.text.secondaryLight : theme.text.primary}
158
+ name={iconName}
159
+ size={18}
160
+ />
161
+ ) : undefined
162
+ }
163
+ lastUsedLabel={lastUsedLabel}
164
+ lastUsedTestID={lastUsedTestID}
165
+ loading={loading}
166
+ onPress={handlePress}
167
+ testID={resolvedTestID}
168
+ text={buttonText}
169
+ />
170
+ );
171
+ }
172
+
129
173
  return (
130
174
  <Pressable
131
175
  accessibilityHint={`Sign in with ${providerName}`}
132
- aria-label={buttonText}
176
+ aria-label={accessibilityLabel ?? buttonText}
133
177
  aria-role="button"
134
178
  disabled={isDisabled}
135
179
  onPress={handlePress}
@@ -1,4 +1,6 @@
1
- // TODO: Update SplitPage native to have desktop UX for tablet sized screens
1
+ // Native SplitPage stays a stacked list/detail at every mobile breakpoint, including tablet `lg`.
2
+ // Prefer `ListDetailLayout` for new list/detail screens: it keeps the selected item in the route
3
+ // and splits into two panes when the layout is wide enough.
2
4
  import {useCallback, useEffect, useState} from "react";
3
5
  import flattenChildren from "react-keyed-flatten-children";
4
6
  import {Dimensions, type ListRenderItemInfo, View} from "react-native";
package/src/SplitPage.tsx CHANGED
@@ -77,11 +77,17 @@ const renderDesktopChildColumn = ({
77
77
  );
78
78
  };
79
79
 
80
- // A component for rendering a list on one side and a details view on the right for large screens,
81
- // and a scrollable list where clicking an item takes you the details view.
82
- // On web, opt in to minimum widths for the desktop side-by-side children, or a labeled pager
83
- // on the narrow viewport. `narrowBelowWidth` chooses that viewport from the window width;
84
- // otherwise it follows `isNarrowViewport()`. The native SplitPage ignores those props.
80
+ /**
81
+ * A component for rendering a list on one side and a details view on the right for large screens,
82
+ * and a scrollable list where clicking an item takes you the details view.
83
+ * On web, opt in to minimum widths for the desktop side-by-side children, or a labeled pager
84
+ * on the narrow viewport. `narrowBelowWidth` chooses that viewport from the window width;
85
+ * otherwise it follows `isNarrowViewport()`. The native SplitPage ignores those props.
86
+ *
87
+ * Prefer `ListDetailLayout` for new list/detail screens. It keeps the selected item in the
88
+ * route, so deep links and back navigation work, and splits on native tablets too. SplitPage
89
+ * remains supported for list/detail views that do not have their own routes.
90
+ */
85
91
  export const SplitPage = <TItem extends SplitPageListItem = SplitPageListItem>({
86
92
  children,
87
93
  tabs = [],